diff --git a/.gitattributes b/.gitattributes
index 1e37d4b45bff8ede805ee81098714823320b012a..45722fd5fddf0aa96a7a50fcdf4497cc362cac65 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -34,3 +34,21 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
 data/Processed[[:space:]]Data.pdf filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/channels.cpython-311.pyc filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/core.cpython-311.pyc filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/cassandra/cluster.cp311-win_amd64.pyd filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/ctransformers/lib/avx/ctransformers.dll filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/ctransformers/lib/avx/libctransformers.dylib filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/ctransformers/lib/avx/libctransformers.so filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/ctransformers/lib/avx2/ctransformers.dll filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/ctransformers/lib/avx2/libctransformers.dylib filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/ctransformers/lib/avx2/libctransformers.so filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/ctransformers/lib/basic/ctransformers.dll filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/ctransformers/lib/basic/libctransformers.dylib filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/ctransformers/lib/basic/libctransformers.so filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/ctransformers/lib/cuda/ctransformers.dll filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/ctransformers/lib/cuda/libctransformers.so filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/faiss_cpu.libs/flang-d38962844214aa9b06fc3989f9adae5b.dll filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/faiss_cpu.libs/openblas-1ba25ee8d70fa3c45ede15bdc95fbee3.dll filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/faiss/_swigfaiss_avx2.cp311-win_amd64.pyd filter=lfs diff=lfs merge=lfs -text
+llm/Lib/site-packages/faiss/_swigfaiss.cp311-win_amd64.pyd filter=lfs diff=lfs merge=lfs -text
diff --git a/llm/Include/site/python3.11/greenlet/greenlet.h b/llm/Include/site/python3.11/greenlet/greenlet.h
new file mode 100644
index 0000000000000000000000000000000000000000..d02a16e43426fb1c1bb286f1cda463cb9b1185ad
--- /dev/null
+++ b/llm/Include/site/python3.11/greenlet/greenlet.h
@@ -0,0 +1,164 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */
+
+/* Greenlet object interface */
+
+#ifndef Py_GREENLETOBJECT_H
+#define Py_GREENLETOBJECT_H
+
+
+#include <Python.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* This is deprecated and undocumented. It does not change. */
+#define GREENLET_VERSION "1.0.0"
+
+#ifndef GREENLET_MODULE
+#define implementation_ptr_t void*
+#endif
+
+typedef struct _greenlet {
+    PyObject_HEAD
+    PyObject* weakreflist;
+    PyObject* dict;
+    implementation_ptr_t pimpl;
+} PyGreenlet;
+
+#define PyGreenlet_Check(op) (op && PyObject_TypeCheck(op, &PyGreenlet_Type))
+
+
+/* C API functions */
+
+/* Total number of symbols that are exported */
+#define PyGreenlet_API_pointers 12
+
+#define PyGreenlet_Type_NUM 0
+#define PyExc_GreenletError_NUM 1
+#define PyExc_GreenletExit_NUM 2
+
+#define PyGreenlet_New_NUM 3
+#define PyGreenlet_GetCurrent_NUM 4
+#define PyGreenlet_Throw_NUM 5
+#define PyGreenlet_Switch_NUM 6
+#define PyGreenlet_SetParent_NUM 7
+
+#define PyGreenlet_MAIN_NUM 8
+#define PyGreenlet_STARTED_NUM 9
+#define PyGreenlet_ACTIVE_NUM 10
+#define PyGreenlet_GET_PARENT_NUM 11
+
+#ifndef GREENLET_MODULE
+/* This section is used by modules that uses the greenlet C API */
+static void** _PyGreenlet_API = NULL;
+
+#    define PyGreenlet_Type \
+        (*(PyTypeObject*)_PyGreenlet_API[PyGreenlet_Type_NUM])
+
+#    define PyExc_GreenletError \
+        ((PyObject*)_PyGreenlet_API[PyExc_GreenletError_NUM])
+
+#    define PyExc_GreenletExit \
+        ((PyObject*)_PyGreenlet_API[PyExc_GreenletExit_NUM])
+
+/*
+ * PyGreenlet_New(PyObject *args)
+ *
+ * greenlet.greenlet(run, parent=None)
+ */
+#    define PyGreenlet_New                                        \
+        (*(PyGreenlet * (*)(PyObject * run, PyGreenlet * parent)) \
+             _PyGreenlet_API[PyGreenlet_New_NUM])
+
+/*
+ * PyGreenlet_GetCurrent(void)
+ *
+ * greenlet.getcurrent()
+ */
+#    define PyGreenlet_GetCurrent \
+        (*(PyGreenlet * (*)(void)) _PyGreenlet_API[PyGreenlet_GetCurrent_NUM])
+
+/*
+ * PyGreenlet_Throw(
+ *         PyGreenlet *greenlet,
+ *         PyObject *typ,
+ *         PyObject *val,
+ *         PyObject *tb)
+ *
+ * g.throw(...)
+ */
+#    define PyGreenlet_Throw                 \
+        (*(PyObject * (*)(PyGreenlet * self, \
+                          PyObject * typ,    \
+                          PyObject * val,    \
+                          PyObject * tb))    \
+             _PyGreenlet_API[PyGreenlet_Throw_NUM])
+
+/*
+ * PyGreenlet_Switch(PyGreenlet *greenlet, PyObject *args)
+ *
+ * g.switch(*args, **kwargs)
+ */
+#    define PyGreenlet_Switch                                              \
+        (*(PyObject *                                                      \
+           (*)(PyGreenlet * greenlet, PyObject * args, PyObject * kwargs)) \
+             _PyGreenlet_API[PyGreenlet_Switch_NUM])
+
+/*
+ * PyGreenlet_SetParent(PyObject *greenlet, PyObject *new_parent)
+ *
+ * g.parent = new_parent
+ */
+#    define PyGreenlet_SetParent                                 \
+        (*(int (*)(PyGreenlet * greenlet, PyGreenlet * nparent)) \
+             _PyGreenlet_API[PyGreenlet_SetParent_NUM])
+
+/*
+ * PyGreenlet_GetParent(PyObject* greenlet)
+ *
+ * return greenlet.parent;
+ *
+ * This could return NULL even if there is no exception active.
+ * If it does not return NULL, you are responsible for decrementing the
+ * reference count.
+ */
+#     define PyGreenlet_GetParent                                    \
+    (*(PyGreenlet* (*)(PyGreenlet*))                                 \
+     _PyGreenlet_API[PyGreenlet_GET_PARENT_NUM])
+
+/*
+ * deprecated, undocumented alias.
+ */
+#     define PyGreenlet_GET_PARENT PyGreenlet_GetParent
+
+#     define PyGreenlet_MAIN                                         \
+    (*(int (*)(PyGreenlet*))                                         \
+     _PyGreenlet_API[PyGreenlet_MAIN_NUM])
+
+#     define PyGreenlet_STARTED                                      \
+    (*(int (*)(PyGreenlet*))                                         \
+     _PyGreenlet_API[PyGreenlet_STARTED_NUM])
+
+#     define PyGreenlet_ACTIVE                                       \
+    (*(int (*)(PyGreenlet*))                                         \
+     _PyGreenlet_API[PyGreenlet_ACTIVE_NUM])
+
+
+
+
+/* Macro that imports greenlet and initializes C API */
+/* NOTE: This has actually moved to ``greenlet._greenlet._C_API``, but we
+   keep the older definition to be sure older code that might have a copy of
+   the header still works. */
+#    define PyGreenlet_Import()                                               \
+        {                                                                     \
+            _PyGreenlet_API = (void**)PyCapsule_Import("greenlet._C_API", 0); \
+        }
+
+#endif /* GREENLET_MODULE */
+
+#ifdef __cplusplus
+}
+#endif
+#endif /* !Py_GREENLETOBJECT_H */
diff --git a/llm/Lib/site-packages/GitPython-3.1.43.dist-info/AUTHORS b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/AUTHORS
new file mode 100644
index 0000000000000000000000000000000000000000..9311b39626f9cab901128b2442841a7218774cc0
--- /dev/null
+++ b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/AUTHORS
@@ -0,0 +1,58 @@
+GitPython was originally written by Michael Trier.
+GitPython 0.2 was partially (re)written by Sebastian Thiel, based on 0.1.6 and git-dulwich.
+
+Contributors are:
+
+-Michael Trier <mtrier _at_ gmail.com>
+-Alan Briolat
+-Florian Apolloner <florian _at_ apolloner.eu>
+-David Aguilar <davvid _at_ gmail.com>
+-Jelmer Vernooij <jelmer _at_ samba.org>
+-Steve Frécinaux <code _at_ istique.net>
+-Kai Lautaportti <kai _at_ lautaportti.fi>
+-Paul Sowden <paul _at_ idontsmoke.co.uk>
+-Sebastian Thiel <byronimo _at_ gmail.com>
+-Jonathan Chu <jonathan.chu _at_ me.com>
+-Vincent Driessen <me _at_ nvie.com>
+-Phil Elson <pelson _dot_ pub _at_ gmail.com>
+-Bernard `Guyzmo` Pratz <guyzmo+gitpython+pub@m0g.net>
+-Timothy B. Hartman <tbhartman _at_ gmail.com>
+-Konstantin Popov <konstantin.popov.89 _at_ yandex.ru>
+-Peter Jones <pjones _at_ redhat.com>
+-Anson Mansfield <anson.mansfield _at_ gmail.com>
+-Ken Odegard <ken.odegard _at_ gmail.com>
+-Alexis Horgix Chotard
+-Piotr Babij <piotr.babij _at_ gmail.com>
+-Mikuláš Poul <mikulaspoul _at_ gmail.com>
+-Charles Bouchard-Légaré <cblegare.atl _at_ ntis.ca>
+-Yaroslav Halchenko <debian _at_ onerussian.com>
+-Tim Swast <swast _at_ google.com>
+-William Luc Ritchie
+-David Host <hostdm _at_ outlook.com>
+-A. Jesse Jiryu Davis <jesse _at_ emptysquare.net>
+-Steven Whitman <ninloot _at_ gmail.com>
+-Stefan Stancu <stefan.stancu _at_ gmail.com>
+-César Izurieta <cesar _at_ caih.org>
+-Arthur Milchior <arthur _at_ milchior.fr>
+-Anil Khatri <anil.soccer.khatri _at_ gmail.com>
+-JJ Graham <thetwoj _at_ gmail.com>
+-Ben Thayer <ben _at_ benthayer.com>
+-Dries Kennes <admin _at_ dries007.net>
+-Pratik Anurag <panurag247365 _at_ gmail.com>
+-Harmon <harmon.public _at_ gmail.com>
+-Liam Beguin <liambeguin _at_ gmail.com>
+-Ram Rachum <ram _at_ rachum.com>
+-Alba Mendez <me _at_ alba.sh>
+-Robert Westman <robert _at_ byteflux.io>
+-Hugo van Kemenade
+-Hiroki Tokunaga <tokusan441 _at_ gmail.com>
+-Julien Mauroy <pro.julien.mauroy _at_ gmail.com>
+-Patrick Gerard
+-Luke Twist <itsluketwist@gmail.com>
+-Joseph Hale <me _at_ jhale.dev>
+-Santos Gallegos <stsewd _at_ proton.me>
+-Wenhan Zhu <wzhu.cosmos _at_ gmail.com>
+-Eliah Kagan <eliah.kagan _at_ gmail.com>
+-Ethan Lin <et.repositories _at_ gmail.com>
+
+Portions derived from other open source works and are clearly marked.
diff --git a/llm/Lib/site-packages/GitPython-3.1.43.dist-info/INSTALLER b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/GitPython-3.1.43.dist-info/LICENSE b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..ba8a219fe1f27c10b50df8cd4f26c0ab833bbbc8
--- /dev/null
+++ b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/LICENSE
@@ -0,0 +1,29 @@
+Copyright (C) 2008, 2009 Michael Trier and contributors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+* Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+* Neither the name of the GitPython project nor the names of
+its contributors may be used to endorse or promote products derived
+from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/llm/Lib/site-packages/GitPython-3.1.43.dist-info/METADATA b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..be628100532a16d615656573f53d4d69b67e4c5a
--- /dev/null
+++ b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/METADATA
@@ -0,0 +1,297 @@
+Metadata-Version: 2.1
+Name: GitPython
+Version: 3.1.43
+Summary: GitPython is a Python library used to interact with Git repositories
+Home-page: https://github.com/gitpython-developers/GitPython
+Author: Sebastian Thiel, Michael Trier
+Author-email: byronimo@gmail.com, mtrier@gmail.com
+License: BSD-3-Clause
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Typing :: Typed
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS
+Requires-Dist: gitdb <5,>=4.0.1
+Requires-Dist: typing-extensions >=3.7.4.3 ; python_version < "3.8"
+Provides-Extra: doc
+Requires-Dist: sphinx ==4.3.2 ; extra == 'doc'
+Requires-Dist: sphinx-rtd-theme ; extra == 'doc'
+Requires-Dist: sphinxcontrib-applehelp <=1.0.4,>=1.0.2 ; extra == 'doc'
+Requires-Dist: sphinxcontrib-devhelp ==1.0.2 ; extra == 'doc'
+Requires-Dist: sphinxcontrib-htmlhelp <=2.0.1,>=2.0.0 ; extra == 'doc'
+Requires-Dist: sphinxcontrib-qthelp ==1.0.3 ; extra == 'doc'
+Requires-Dist: sphinxcontrib-serializinghtml ==1.1.5 ; extra == 'doc'
+Requires-Dist: sphinx-autodoc-typehints ; extra == 'doc'
+Provides-Extra: test
+Requires-Dist: coverage[toml] ; extra == 'test'
+Requires-Dist: ddt !=1.4.3,>=1.1.1 ; extra == 'test'
+Requires-Dist: mypy ; extra == 'test'
+Requires-Dist: pre-commit ; extra == 'test'
+Requires-Dist: pytest >=7.3.1 ; extra == 'test'
+Requires-Dist: pytest-cov ; extra == 'test'
+Requires-Dist: pytest-instafail ; extra == 'test'
+Requires-Dist: pytest-mock ; extra == 'test'
+Requires-Dist: pytest-sugar ; extra == 'test'
+Requires-Dist: typing-extensions ; (python_version < "3.11") and extra == 'test'
+Requires-Dist: mock ; (python_version < "3.8") and extra == 'test'
+
+![Python package](https://github.com/gitpython-developers/GitPython/workflows/Python%20package/badge.svg)
+[![Documentation Status](https://readthedocs.org/projects/gitpython/badge/?version=stable)](https://readthedocs.org/projects/gitpython/?badge=stable)
+[![Packaging status](https://repology.org/badge/tiny-repos/python:gitpython.svg)](https://repology.org/metapackage/python:gitpython/versions)
+
+## [Gitoxide](https://github.com/Byron/gitoxide): A peek into the future…
+
+I started working on GitPython in 2009, back in the days when Python was 'my thing' and I had great plans with it.
+Of course, back in the days, I didn't really know what I was doing and this shows in many places. Somewhat similar to
+Python this happens to be 'good enough', but at the same time is deeply flawed and broken beyond repair.
+
+By now, GitPython is widely used and I am sure there is a good reason for that, it's something to be proud of and happy about.
+The community is maintaining the software and is keeping it relevant for which I am absolutely grateful. For the time to come I am happy to continue maintaining GitPython, remaining hopeful that one day it won't be needed anymore.
+
+More than 15 years after my first meeting with 'git' I am still in excited about it, and am happy to finally have the tools and
+probably the skills to scratch that itch of mine: implement `git` in a way that makes tool creation a piece of cake for most.
+
+If you like the idea and want to learn more, please head over to [gitoxide](https://github.com/Byron/gitoxide), an
+implementation of 'git' in [Rust](https://www.rust-lang.org).
+
+*(Please note that `gitoxide` is not currently available for use in Python, and that Rust is required.)*
+
+## GitPython
+
+GitPython is a python library used to interact with git repositories, high-level like git-porcelain,
+or low-level like git-plumbing.
+
+It provides abstractions of git objects for easy access of repository data often backed by calling the `git`
+command-line program.
+
+### DEVELOPMENT STATUS
+
+This project is in **maintenance mode**, which means that
+
+- …there will be no feature development, unless these are contributed
+- …there will be no bug fixes, unless they are relevant to the safety of users, or contributed
+- …issues will be responded to with waiting times of up to a month
+
+The project is open to contributions of all kinds, as well as new maintainers.
+
+### REQUIREMENTS
+
+GitPython needs the `git` executable to be installed on the system and available in your
+`PATH` for most operations. If it is not in your `PATH`, you can help GitPython find it
+by setting the `GIT_PYTHON_GIT_EXECUTABLE=<path/to/git>` environment variable.
+
+- Git (1.7.x or newer)
+- Python >= 3.7
+
+The list of dependencies are listed in `./requirements.txt` and `./test-requirements.txt`.
+The installer takes care of installing them for you.
+
+### INSTALL
+
+GitPython and its required package dependencies can be installed in any of the following ways, all of which should typically be done in a [virtual environment](https://docs.python.org/3/tutorial/venv.html).
+
+#### From PyPI
+
+To obtain and install a copy [from PyPI](https://pypi.org/project/GitPython/), run:
+
+```sh
+pip install GitPython
+```
+
+(A distribution package can also be downloaded for manual installation at [the PyPI page](https://pypi.org/project/GitPython/).)
+
+#### From downloaded source code
+
+If you have downloaded the source code, run this from inside the unpacked `GitPython` directory:
+
+```sh
+pip install .
+```
+
+#### By cloning the source code repository
+
+To clone the [the GitHub repository](https://github.com/gitpython-developers/GitPython) from source to work on the code, you can do it like so:
+
+```sh
+git clone https://github.com/gitpython-developers/GitPython
+cd GitPython
+./init-tests-after-clone.sh
+```
+
+On Windows, `./init-tests-after-clone.sh` can be run in a Git Bash shell.
+
+If you are cloning [your own fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks), then replace the above `git clone` command with one that gives the URL of your fork. Or use this [`gh`](https://cli.github.com/) command (assuming you have `gh` and your fork is called `GitPython`):
+
+```sh
+gh repo clone GitPython
+```
+
+Having cloned the repo, create and activate your [virtual environment](https://docs.python.org/3/tutorial/venv.html).
+
+Then make an [editable install](https://pip.pypa.io/en/stable/topics/local-project-installs/#editable-installs):
+
+```sh
+pip install -e ".[test]"
+```
+
+In the less common case that you do not want to install test dependencies, `pip install -e .` can be used instead.
+
+#### With editable *dependencies* (not preferred, and rarely needed)
+
+In rare cases, you may want to work on GitPython and one or both of its [gitdb](https://github.com/gitpython-developers/gitdb) and [smmap](https://github.com/gitpython-developers/smmap) dependencies at the same time, with changes in your local working copy of gitdb or smmap immediatley reflected in the behavior of your local working copy of GitPython. This can be done by making editable installations of those dependencies in the same virtual environment where you install GitPython.
+
+If you want to do that *and* you want the versions in GitPython's git submodules to be used, then pass `-e git/ext/gitdb` and/or `-e git/ext/gitdb/gitdb/ext/smmap` to `pip install`. This can be done in any order, and in separate `pip install` commands or the same one, so long as `-e` appears before *each* path. For example, you can install GitPython, gitdb, and smmap editably in the currently active virtual environment this way:
+
+```sh
+pip install -e ".[test]" -e git/ext/gitdb -e git/ext/gitdb/gitdb/ext/smmap
+```
+
+The submodules must have been cloned for that to work, but that will already be the case if you have run `./init-tests-after-clone.sh`. You can use `pip list` to check which packages are installed editably and which are installed normally.
+
+To reiterate, this approach should only rarely be used. For most development it is preferable to allow the gitdb and smmap dependencices to be retrieved automatically from PyPI in their latest stable packaged versions.
+
+### Limitations
+
+#### Leakage of System Resources
+
+GitPython is not suited for long-running processes (like daemons) as it tends to
+leak system resources. It was written in a time where destructors (as implemented
+in the `__del__` method) still ran deterministically.
+
+In case you still want to use it in such a context, you will want to search the
+codebase for `__del__` implementations and call these yourself when you see fit.
+
+Another way assure proper cleanup of resources is to factor out GitPython into a
+separate process which can be dropped periodically.
+
+#### Windows support
+
+See [Issue #525](https://github.com/gitpython-developers/GitPython/issues/525).
+
+### RUNNING TESTS
+
+_Important_: Right after cloning this repository, please be sure to have executed
+the `./init-tests-after-clone.sh` script in the repository root. Otherwise
+you will encounter test failures.
+
+#### Install test dependencies
+
+Ensure testing libraries are installed. This is taken care of already if you installed with:
+
+```sh
+pip install -e ".[test]"
+```
+
+If you had installed with a command like `pip install -e .` instead, you can still run
+the above command to add the testing dependencies.
+
+#### Test commands
+
+To test, run:
+
+```sh
+pytest
+```
+
+To lint, and apply some linting fixes as well as automatic code formatting, run:
+
+```sh
+pre-commit run --all-files
+```
+
+This includes the linting and autoformatting done by Ruff, as well as some other checks.
+
+To typecheck, run:
+
+```sh
+mypy
+```
+
+#### CI (and tox)
+
+Style and formatting checks, and running tests on all the different supported Python versions, will be performed:
+
+- Upon submitting a pull request.
+- On each push, *if* you have a fork with GitHub Actions enabled.
+- Locally, if you run [`tox`](https://tox.wiki/) (this skips any Python versions you don't have installed).
+
+#### Configuration files
+
+Specific tools are all configured in the `./pyproject.toml` file:
+
+- `pytest` (test runner)
+- `coverage.py` (code coverage)
+- `ruff` (linter and formatter)
+- `mypy` (type checker)
+
+Orchestration tools:
+
+- Configuration for `pre-commit` is in the `./.pre-commit-config.yaml` file.
+- Configuration for `tox` is in `./tox.ini`.
+- Configuration for GitHub Actions (CI) is in files inside `./.github/workflows/`.
+
+### Contributions
+
+Please have a look at the [contributions file][contributing].
+
+### INFRASTRUCTURE
+
+- [User Documentation](http://gitpython.readthedocs.org)
+- [Questions and Answers](http://stackexchange.com/filters/167317/gitpython)
+- Please post on Stack Overflow and use the `gitpython` tag
+- [Issue Tracker](https://github.com/gitpython-developers/GitPython/issues)
+  - Post reproducible bugs and feature requests as a new issue.
+    Please be sure to provide the following information if posting bugs:
+    - GitPython version (e.g. `import git; git.__version__`)
+    - Python version (e.g. `python --version`)
+    - The encountered stack-trace, if applicable
+    - Enough information to allow reproducing the issue
+
+### How to make a new release
+
+1. Update/verify the **version** in the `VERSION` file.
+2. Update/verify that the `doc/source/changes.rst` changelog file was updated. It should include a link to the forthcoming release page: `https://github.com/gitpython-developers/GitPython/releases/tag/<version>`
+3. Commit everything.
+4. Run `git tag -s <version>` to tag the version in Git.
+5. _Optionally_ create and activate a [virtual environment](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/#creating-a-virtual-environment). (Then the next step can install `build` and `twine`.)
+6. Run `make release`.
+7. Go to [GitHub Releases](https://github.com/gitpython-developers/GitPython/releases) and publish a new one with the recently pushed tag. Generate the changelog.
+
+### Projects using GitPython
+
+- [PyDriller](https://github.com/ishepard/pydriller)
+- [Kivy Designer](https://github.com/kivy/kivy-designer)
+- [Prowl](https://github.com/nettitude/Prowl)
+- [Python Taint](https://github.com/python-security/pyt)
+- [Buster](https://github.com/axitkhurana/buster)
+- [git-ftp](https://github.com/ezyang/git-ftp)
+- [Git-Pandas](https://github.com/wdm0006/git-pandas)
+- [PyGitUp](https://github.com/msiemens/PyGitUp)
+- [PyJFuzz](https://github.com/mseclab/PyJFuzz)
+- [Loki](https://github.com/Neo23x0/Loki)
+- [Omniwallet](https://github.com/OmniLayer/omniwallet)
+- [GitViper](https://github.com/BeayemX/GitViper)
+- [Git Gud](https://github.com/bthayer2365/git-gud)
+
+### LICENSE
+
+[3-Clause BSD License](https://opensource.org/license/bsd-3-clause/), also known as the New BSD License. See the [LICENSE file][license].
+
+[contributing]: https://github.com/gitpython-developers/GitPython/blob/main/CONTRIBUTING.md
+[license]: https://github.com/gitpython-developers/GitPython/blob/main/LICENSE
diff --git a/llm/Lib/site-packages/GitPython-3.1.43.dist-info/RECORD b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..8aee05f3847254112d30113a97df6626fbf1c78c
--- /dev/null
+++ b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/RECORD
@@ -0,0 +1,82 @@
+GitPython-3.1.43.dist-info/AUTHORS,sha256=h1TlPKfp05GA1eKQ15Yl4biR0C0FgivuGSeRA6Q1dz0,2286
+GitPython-3.1.43.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+GitPython-3.1.43.dist-info/LICENSE,sha256=hvyUwyGpr7wRUUcTURuv3tIl8lEA3MD3NQ6CvCMbi-s,1503
+GitPython-3.1.43.dist-info/METADATA,sha256=sAh3r1BMVw5_olGgDmpMS69zBpVr7UEOeRivNHKznfU,13376
+GitPython-3.1.43.dist-info/RECORD,,
+GitPython-3.1.43.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+GitPython-3.1.43.dist-info/top_level.txt,sha256=0hzDuIp8obv624V3GmbqsagBWkk8ohtGU-Bc1PmTT0o,4
+git/__init__.py,sha256=w6fnS0QmwTfEFUSL6rfnpP0lUId2goSguZFOvVX3N3U,8899
+git/__pycache__/__init__.cpython-311.pyc,,
+git/__pycache__/cmd.cpython-311.pyc,,
+git/__pycache__/compat.cpython-311.pyc,,
+git/__pycache__/config.cpython-311.pyc,,
+git/__pycache__/db.cpython-311.pyc,,
+git/__pycache__/diff.cpython-311.pyc,,
+git/__pycache__/exc.cpython-311.pyc,,
+git/__pycache__/remote.cpython-311.pyc,,
+git/__pycache__/types.cpython-311.pyc,,
+git/__pycache__/util.cpython-311.pyc,,
+git/cmd.py,sha256=qd-gIHSk4mfsYjd9YA08cPyO8TMxaibTXAbFnHK71uc,67659
+git/compat.py,sha256=y1E6y6O2q5r8clSlr8ZNmuIWG9nmHuehQEsVsmBffs8,4526
+git/config.py,sha256=Ald8Xc-G9Shcgx3QCISyXTkL4a6nbc3qll-xUw4YdyY,34924
+git/db.py,sha256=vIW9uWSbqu99zbuU2ZDmOhVOv1UPTmxrnqiCtRHCfjE,2368
+git/diff.py,sha256=IE5aeHL7aP9yxBluYj06IX8nZjoJ_TOM3gG31-Evf_8,27058
+git/exc.py,sha256=Gc7g1pHpn8OmTse30NHmJVsBJ2CYH8LxaR8y8UA3lIM,7119
+git/index/__init__.py,sha256=i-Nqb8Lufp9aFbmxpQBORmmQnjEVVM1Pn58fsQkyGgQ,406
+git/index/__pycache__/__init__.cpython-311.pyc,,
+git/index/__pycache__/base.cpython-311.pyc,,
+git/index/__pycache__/fun.cpython-311.pyc,,
+git/index/__pycache__/typ.cpython-311.pyc,,
+git/index/__pycache__/util.cpython-311.pyc,,
+git/index/base.py,sha256=A4q4cN_Ifxi8CsAR-7h4KsQ2d3JazBNFZ1ltbAKttgs,60734
+git/index/fun.py,sha256=37cA3DBC9vpAnSVu5TGA072SnoF5XZOkOukExwlejHs,16736
+git/index/typ.py,sha256=uuKNwitUw83FhVaLSwo4pY7PHDQudtZTLJrLGym4jcI,6570
+git/index/util.py,sha256=fULi7GPG-MvprKrRCD5c15GNdzku_1E38We0d97WB3A,3659
+git/objects/__init__.py,sha256=O6ZL_olX7e5-8iIbKviRPkVSJxN37WA-EC0q9d48U5Y,637
+git/objects/__pycache__/__init__.cpython-311.pyc,,
+git/objects/__pycache__/base.cpython-311.pyc,,
+git/objects/__pycache__/blob.cpython-311.pyc,,
+git/objects/__pycache__/commit.cpython-311.pyc,,
+git/objects/__pycache__/fun.cpython-311.pyc,,
+git/objects/__pycache__/tag.cpython-311.pyc,,
+git/objects/__pycache__/tree.cpython-311.pyc,,
+git/objects/__pycache__/util.cpython-311.pyc,,
+git/objects/base.py,sha256=0dqNkSRVH0mk0-7ZKIkGBK7iNYrzLTVxwQFUd6CagsE,10277
+git/objects/blob.py,sha256=zwwq0KfOMYeP5J2tW5CQatoLyeqFRlfkxP1Vwx1h07s,1215
+git/objects/commit.py,sha256=vLZNl1I9zp17Rpge7J66CvsryirEs90jyPTQzoP0JJs,30208
+git/objects/fun.py,sha256=B4jCqhAjm6Hl79GK58FPzW1H9K6Wc7Tx0rssyWmAcEE,8935
+git/objects/submodule/__init__.py,sha256=6xySp767LVz3UylWgUalntS_nGXRuVzXxDuFAv_Wc2c,303
+git/objects/submodule/__pycache__/__init__.cpython-311.pyc,,
+git/objects/submodule/__pycache__/base.cpython-311.pyc,,
+git/objects/submodule/__pycache__/root.cpython-311.pyc,,
+git/objects/submodule/__pycache__/util.cpython-311.pyc,,
+git/objects/submodule/base.py,sha256=MQ-2xV8JznGwy2hLQv1aeQNgAkhBhgc5tdtClFL3DmE,63901
+git/objects/submodule/root.py,sha256=5eTtYNHasqdPq6q0oDCPr7IaO6uAHL3b4DxMoiO2LhE,20246
+git/objects/submodule/util.py,sha256=sQqAYaiSJdFkZa9NlAuK_wTsMNiS-kkQnQjvIoJtc_o,3509
+git/objects/tag.py,sha256=gAx8i-DEwy_Z3R2zLkvetYRV8A56BCcTr3iLuTUTfEM,4467
+git/objects/tree.py,sha256=jJH888SHiP4dGzE-ra1yenQOyya_0C_MkHr06c1gHpM,13849
+git/objects/util.py,sha256=Ml2eqZPKO4y9Hc2vWbXJgpsK3nkN3KGMzbn8AlzLyYQ,23834
+git/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+git/refs/__init__.py,sha256=DWlJNnsx-4jM_E-VycbP-FZUdn6iWhjnH_uZ_pZXBro,509
+git/refs/__pycache__/__init__.cpython-311.pyc,,
+git/refs/__pycache__/head.cpython-311.pyc,,
+git/refs/__pycache__/log.cpython-311.pyc,,
+git/refs/__pycache__/reference.cpython-311.pyc,,
+git/refs/__pycache__/remote.cpython-311.pyc,,
+git/refs/__pycache__/symbolic.cpython-311.pyc,,
+git/refs/__pycache__/tag.cpython-311.pyc,,
+git/refs/head.py,sha256=GAZpD5EfqSciDXPtgjHY8ZbBixKExJRhojUB-HrrJPg,10491
+git/refs/log.py,sha256=kXiuAgTo1DIuM_BfbDUk9gQ0YO-mutIMVdHv1_ES90o,12493
+git/refs/reference.py,sha256=l6mhF4YLSEwtjz6b9PpOQH-fkng7EYWMaJhkjn-2jXA,5630
+git/refs/remote.py,sha256=WwqV9T7BbYf3F_WZNUQivu9xktIIKGklCjDpwQrhD-A,2806
+git/refs/symbolic.py,sha256=c8zOwaqzcg-J-rGrpuWdvh8zwMvSUqAHghd4vJoYG_s,34552
+git/refs/tag.py,sha256=kgzV2vhpL4FD2TqHb0BJuMRAHgAvJF-TcoyWlaB-djQ,5010
+git/remote.py,sha256=IHQ3BvXgoIN1EvHlyH3vrSaQoDkLOE6nooSC0w183sU,46561
+git/repo/__init__.py,sha256=CILSVH36fX_WxVFSjD9o1WF5LgsNedPiJvSngKZqfVU,210
+git/repo/__pycache__/__init__.cpython-311.pyc,,
+git/repo/__pycache__/base.cpython-311.pyc,,
+git/repo/__pycache__/fun.cpython-311.pyc,,
+git/repo/base.py,sha256=mitfJ8u99CsMpDd7_VRyx-SF8omu2tpf3lqzSaQkKoQ,59353
+git/repo/fun.py,sha256=tEsClpmbOrKMSNIdncOB_6JdikrL1-AfkOFd7xMpD8k,13582
+git/types.py,sha256=xCwpp2Y01lhS0MapHhj04m0P_x34kwSD1Gsou_ZPWj8,10251
+git/util.py,sha256=1E883mnPAFLyFk7ivwnEremsp-uJOTc3ks_QypyLung,43651
diff --git a/llm/Lib/site-packages/GitPython-3.1.43.dist-info/WHEEL b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..bab98d675883cc7567a79df485cd7b4f015e376f
--- /dev/null
+++ b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/GitPython-3.1.43.dist-info/top_level.txt b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..5664e303b5dc2e9ef8e14a0845d9486ec1920afd
--- /dev/null
+++ b/llm/Lib/site-packages/GitPython-3.1.43.dist-info/top_level.txt
@@ -0,0 +1 @@
+git
diff --git a/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/INSTALLER b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/LICENSE.rst b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/LICENSE.rst
new file mode 100644
index 0000000000000000000000000000000000000000..c37cae49ec77ad6ebb25568c1605f1fee5313cfb
--- /dev/null
+++ b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/LICENSE.rst
@@ -0,0 +1,28 @@
+Copyright 2007 Pallets
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1.  Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+2.  Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+
+3.  Neither the name of the copyright holder nor the names of its
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/METADATA b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..56e942902a96e7f012479a582c5cf89511219f9a
--- /dev/null
+++ b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/METADATA
@@ -0,0 +1,105 @@
+Metadata-Version: 2.1
+Name: Jinja2
+Version: 3.1.3
+Summary: A very fast and expressive template engine.
+Home-page: https://palletsprojects.com/p/jinja/
+Maintainer: Pallets
+Maintainer-email: contact@palletsprojects.com
+License: BSD-3-Clause
+Project-URL: Donate, https://palletsprojects.com/donate
+Project-URL: Documentation, https://jinja.palletsprojects.com/
+Project-URL: Changes, https://jinja.palletsprojects.com/changes/
+Project-URL: Source Code, https://github.com/pallets/jinja/
+Project-URL: Issue Tracker, https://github.com/pallets/jinja/issues/
+Project-URL: Chat, https://discord.gg/pallets
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Requires-Python: >=3.7
+Description-Content-Type: text/x-rst
+License-File: LICENSE.rst
+Requires-Dist: MarkupSafe >=2.0
+Provides-Extra: i18n
+Requires-Dist: Babel >=2.7 ; extra == 'i18n'
+
+Jinja
+=====
+
+Jinja is a fast, expressive, extensible templating engine. Special
+placeholders in the template allow writing code similar to Python
+syntax. Then the template is passed data to render the final document.
+
+It includes:
+
+-   Template inheritance and inclusion.
+-   Define and import macros within templates.
+-   HTML templates can use autoescaping to prevent XSS from untrusted
+    user input.
+-   A sandboxed environment can safely render untrusted templates.
+-   AsyncIO support for generating templates and calling async
+    functions.
+-   I18N support with Babel.
+-   Templates are compiled to optimized Python code just-in-time and
+    cached, or can be compiled ahead-of-time.
+-   Exceptions point to the correct line in templates to make debugging
+    easier.
+-   Extensible filters, tests, functions, and even syntax.
+
+Jinja's philosophy is that while application logic belongs in Python if
+possible, it shouldn't make the template designer's job difficult by
+restricting functionality too much.
+
+
+Installing
+----------
+
+Install and update using `pip`_:
+
+.. code-block:: text
+
+    $ pip install -U Jinja2
+
+.. _pip: https://pip.pypa.io/en/stable/getting-started/
+
+
+In A Nutshell
+-------------
+
+.. code-block:: jinja
+
+    {% extends "base.html" %}
+    {% block title %}Members{% endblock %}
+    {% block content %}
+      <ul>
+      {% for user in users %}
+        <li><a href="{{ user.url }}">{{ user.username }}</a></li>
+      {% endfor %}
+      </ul>
+    {% endblock %}
+
+
+Donate
+------
+
+The Pallets organization develops and supports Jinja and other popular
+packages. In order to grow the community of contributors and users, and
+allow the maintainers to devote more time to the projects, `please
+donate today`_.
+
+.. _please donate today: https://palletsprojects.com/donate
+
+
+Links
+-----
+
+-   Documentation: https://jinja.palletsprojects.com/
+-   Changes: https://jinja.palletsprojects.com/changes/
+-   PyPI Releases: https://pypi.org/project/Jinja2/
+-   Source Code: https://github.com/pallets/jinja/
+-   Issue Tracker: https://github.com/pallets/jinja/issues/
+-   Chat: https://discord.gg/pallets
diff --git a/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/RECORD b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..c2a7387852f4e22b43477a32fd7884c8f655a392
--- /dev/null
+++ b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/RECORD
@@ -0,0 +1,58 @@
+Jinja2-3.1.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+Jinja2-3.1.3.dist-info/LICENSE.rst,sha256=O0nc7kEF6ze6wQ-vG-JgQI_oXSUrjp3y4JefweCUQ3s,1475
+Jinja2-3.1.3.dist-info/METADATA,sha256=0cLNbRCI91jytc7Bzv3XAQfZzFDF2gxkJuH46eF5vew,3301
+Jinja2-3.1.3.dist-info/RECORD,,
+Jinja2-3.1.3.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+Jinja2-3.1.3.dist-info/entry_points.txt,sha256=zRd62fbqIyfUpsRtU7EVIFyiu1tPwfgO7EvPErnxgTE,59
+Jinja2-3.1.3.dist-info/top_level.txt,sha256=PkeVWtLb3-CqjWi1fO29OCbj55EhX_chhKrCdrVe_zs,7
+jinja2/__init__.py,sha256=NTBwMwsECrdHmxeXF7seusHLzrh6Ldn1A9qhS5cDuf0,1927
+jinja2/__pycache__/__init__.cpython-311.pyc,,
+jinja2/__pycache__/_identifier.cpython-311.pyc,,
+jinja2/__pycache__/async_utils.cpython-311.pyc,,
+jinja2/__pycache__/bccache.cpython-311.pyc,,
+jinja2/__pycache__/compiler.cpython-311.pyc,,
+jinja2/__pycache__/constants.cpython-311.pyc,,
+jinja2/__pycache__/debug.cpython-311.pyc,,
+jinja2/__pycache__/defaults.cpython-311.pyc,,
+jinja2/__pycache__/environment.cpython-311.pyc,,
+jinja2/__pycache__/exceptions.cpython-311.pyc,,
+jinja2/__pycache__/ext.cpython-311.pyc,,
+jinja2/__pycache__/filters.cpython-311.pyc,,
+jinja2/__pycache__/idtracking.cpython-311.pyc,,
+jinja2/__pycache__/lexer.cpython-311.pyc,,
+jinja2/__pycache__/loaders.cpython-311.pyc,,
+jinja2/__pycache__/meta.cpython-311.pyc,,
+jinja2/__pycache__/nativetypes.cpython-311.pyc,,
+jinja2/__pycache__/nodes.cpython-311.pyc,,
+jinja2/__pycache__/optimizer.cpython-311.pyc,,
+jinja2/__pycache__/parser.cpython-311.pyc,,
+jinja2/__pycache__/runtime.cpython-311.pyc,,
+jinja2/__pycache__/sandbox.cpython-311.pyc,,
+jinja2/__pycache__/tests.cpython-311.pyc,,
+jinja2/__pycache__/utils.cpython-311.pyc,,
+jinja2/__pycache__/visitor.cpython-311.pyc,,
+jinja2/_identifier.py,sha256=_zYctNKzRqlk_murTNlzrju1FFJL7Va_Ijqqd7ii2lU,1958
+jinja2/async_utils.py,sha256=dFcmh6lMNfbh7eLKrBio8JqAKLHdZbpCuurFN4OERtY,2447
+jinja2/bccache.py,sha256=mhz5xtLxCcHRAa56azOhphIAe19u1we0ojifNMClDio,14061
+jinja2/compiler.py,sha256=PJzYdRLStlEOqmnQs1YxlizPrJoj3jTZuUleREn6AIQ,72199
+jinja2/constants.py,sha256=GMoFydBF_kdpaRKPoM5cl5MviquVRLVyZtfp5-16jg0,1433
+jinja2/debug.py,sha256=iWJ432RadxJNnaMOPrjIDInz50UEgni3_HKuFXi2vuQ,6299
+jinja2/defaults.py,sha256=boBcSw78h-lp20YbaXSJsqkAI2uN_mD_TtCydpeq5wU,1267
+jinja2/environment.py,sha256=0qldX3VQKZcm6lgn7zHz94oRFow7YPYERiqkquomNjU,61253
+jinja2/exceptions.py,sha256=ioHeHrWwCWNaXX1inHmHVblvc4haO7AXsjCp3GfWvx0,5071
+jinja2/ext.py,sha256=5fnMpllaXkfm2P_93RIvi-OnK7Tk8mCW8Du-GcD12Hc,31844
+jinja2/filters.py,sha256=vYjKb2zaPShvYtn_LpSmqfS8SScbrA_KOanNibsMDIE,53862
+jinja2/idtracking.py,sha256=GfNmadir4oDALVxzn3DL9YInhJDr69ebXeA2ygfuCGA,10704
+jinja2/lexer.py,sha256=DW2nX9zk-6MWp65YR2bqqj0xqCvLtD-u9NWT8AnFRxQ,29726
+jinja2/loaders.py,sha256=ayAwxfrA1SAffQta0nwSDm3TDT4KYiIGN_D9Z45B310,23085
+jinja2/meta.py,sha256=GNPEvifmSaU3CMxlbheBOZjeZ277HThOPUTf1RkppKQ,4396
+jinja2/nativetypes.py,sha256=7GIGALVJgdyL80oZJdQUaUfwSt5q2lSSZbXt0dNf_M4,4210
+jinja2/nodes.py,sha256=i34GPRAZexXMT6bwuf5SEyvdmS-bRCy9KMjwN5O6pjk,34550
+jinja2/optimizer.py,sha256=tHkMwXxfZkbfA1KmLcqmBMSaz7RLIvvItrJcPoXTyD8,1650
+jinja2/parser.py,sha256=Y199wPL-G67gJoi5G_5sHuu9uEP1PJkjjLEW_xTH8-k,39736
+jinja2/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+jinja2/runtime.py,sha256=_6LkKIWFJjQdqlrgA3K39zBFQ-7Orm3wGDm96RwxQoE,33406
+jinja2/sandbox.py,sha256=Y0xZeXQnH6EX5VjaV2YixESxoepnRbW_3UeQosaBU3M,14584
+jinja2/tests.py,sha256=Am5Z6Lmfr2XaH_npIfJJ8MdXtWsbLjMULZJulTAj30E,5905
+jinja2/utils.py,sha256=IMwRIcN1SsTw2-jdQtlH2KzNABsXZBW_-tnFXafQBvY,23933
+jinja2/visitor.py,sha256=MH14C6yq24G_KVtWzjwaI7Wg14PCJIYlWW1kpkxYak0,3568
diff --git a/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/WHEEL b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..98c0d20b7a64f4f998d7913e1d38a05dba20916c
--- /dev/null
+++ b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.42.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/entry_points.txt b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..7b9666c8ea311ea0f0cfe7bed861aaa5469f92bb
--- /dev/null
+++ b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/entry_points.txt
@@ -0,0 +1,2 @@
+[babel.extractors]
+jinja2 = jinja2.ext:babel_extract[i18n]
diff --git a/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/top_level.txt b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..7f7afbf3bf54b346092be6a72070fcbd305ead1e
--- /dev/null
+++ b/llm/Lib/site-packages/Jinja2-3.1.3.dist-info/top_level.txt
@@ -0,0 +1 @@
+jinja2
diff --git a/llm/Lib/site-packages/accelerate-0.29.3.dist-info/INSTALLER b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/accelerate-0.29.3.dist-info/LICENSE b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..261eeb9e9f8b2b4b0d119366dda99c6fd7d35c64
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/LICENSE
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/llm/Lib/site-packages/accelerate-0.29.3.dist-info/METADATA b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..3fc723bb7bb61d73562595210ddb57c130cefb53
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/METADATA
@@ -0,0 +1,378 @@
+Metadata-Version: 2.1
+Name: accelerate
+Version: 0.29.3
+Summary: Accelerate
+Home-page: https://github.com/huggingface/accelerate
+Author: The HuggingFace team
+Author-email: zach.mueller@huggingface.co
+License: Apache
+Keywords: deep learning
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy (>=1.17)
+Requires-Dist: packaging (>=20.0)
+Requires-Dist: psutil
+Requires-Dist: pyyaml
+Requires-Dist: torch (>=1.10.0)
+Requires-Dist: huggingface-hub
+Requires-Dist: safetensors (>=0.3.1)
+Provides-Extra: dev
+Requires-Dist: black (~=23.1) ; extra == 'dev'
+Requires-Dist: hf-doc-builder (>=0.3.0) ; extra == 'dev'
+Requires-Dist: ruff (~=0.2.1) ; extra == 'dev'
+Requires-Dist: pytest (<=8.0.0,>=7.2.0) ; extra == 'dev'
+Requires-Dist: pytest-xdist ; extra == 'dev'
+Requires-Dist: pytest-subtests ; extra == 'dev'
+Requires-Dist: parameterized ; extra == 'dev'
+Requires-Dist: datasets ; extra == 'dev'
+Requires-Dist: evaluate ; extra == 'dev'
+Requires-Dist: torchpippy (>=0.2.0) ; extra == 'dev'
+Requires-Dist: transformers ; extra == 'dev'
+Requires-Dist: scipy ; extra == 'dev'
+Requires-Dist: scikit-learn ; extra == 'dev'
+Requires-Dist: deepspeed ; extra == 'dev'
+Requires-Dist: tqdm ; extra == 'dev'
+Requires-Dist: bitsandbytes ; extra == 'dev'
+Requires-Dist: timm ; extra == 'dev'
+Requires-Dist: rich ; extra == 'dev'
+Provides-Extra: docs
+Provides-Extra: quality
+Requires-Dist: black (~=23.1) ; extra == 'quality'
+Requires-Dist: hf-doc-builder (>=0.3.0) ; extra == 'quality'
+Requires-Dist: ruff (~=0.2.1) ; extra == 'quality'
+Provides-Extra: rich
+Requires-Dist: rich ; extra == 'rich'
+Provides-Extra: sagemaker
+Requires-Dist: sagemaker ; extra == 'sagemaker'
+Provides-Extra: test_dev
+Requires-Dist: datasets ; extra == 'test_dev'
+Requires-Dist: evaluate ; extra == 'test_dev'
+Requires-Dist: torchpippy (>=0.2.0) ; extra == 'test_dev'
+Requires-Dist: transformers ; extra == 'test_dev'
+Requires-Dist: scipy ; extra == 'test_dev'
+Requires-Dist: scikit-learn ; extra == 'test_dev'
+Requires-Dist: deepspeed ; extra == 'test_dev'
+Requires-Dist: tqdm ; extra == 'test_dev'
+Requires-Dist: bitsandbytes ; extra == 'test_dev'
+Requires-Dist: timm ; extra == 'test_dev'
+Provides-Extra: test_prod
+Requires-Dist: pytest (<=8.0.0,>=7.2.0) ; extra == 'test_prod'
+Requires-Dist: pytest-xdist ; extra == 'test_prod'
+Requires-Dist: pytest-subtests ; extra == 'test_prod'
+Requires-Dist: parameterized ; extra == 'test_prod'
+Provides-Extra: test_trackers
+Requires-Dist: wandb ; extra == 'test_trackers'
+Requires-Dist: comet-ml ; extra == 'test_trackers'
+Requires-Dist: tensorboard ; extra == 'test_trackers'
+Requires-Dist: dvclive ; extra == 'test_trackers'
+Provides-Extra: testing
+Requires-Dist: pytest (<=8.0.0,>=7.2.0) ; extra == 'testing'
+Requires-Dist: pytest-xdist ; extra == 'testing'
+Requires-Dist: pytest-subtests ; extra == 'testing'
+Requires-Dist: parameterized ; extra == 'testing'
+Requires-Dist: datasets ; extra == 'testing'
+Requires-Dist: evaluate ; extra == 'testing'
+Requires-Dist: torchpippy (>=0.2.0) ; extra == 'testing'
+Requires-Dist: transformers ; extra == 'testing'
+Requires-Dist: scipy ; extra == 'testing'
+Requires-Dist: scikit-learn ; extra == 'testing'
+Requires-Dist: deepspeed ; extra == 'testing'
+Requires-Dist: tqdm ; extra == 'testing'
+Requires-Dist: bitsandbytes ; extra == 'testing'
+Requires-Dist: timm ; extra == 'testing'
+
+<!---
+Copyright 2021 The HuggingFace Team. All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<p align="center">
+    <br>
+    <img src="https://raw.githubusercontent.com/huggingface/accelerate/main/docs/source/imgs/accelerate_logo.png" width="400"/>
+    <br>
+<p>
+
+<p align="center">
+    <!-- Uncomment when CircleCI is set up
+    <a href="https://circleci.com/gh/huggingface/accelerate">
+        <img alt="Build" src="https://img.shields.io/circleci/build/github/huggingface/transformers/master">
+    </a>
+    -->
+    <a href="https://github.com/huggingface/accelerate/blob/main/LICENSE">
+        <img alt="License" src="https://img.shields.io/github/license/huggingface/accelerate.svg?color=blue">
+    </a>
+    <a href="https://huggingface.co/docs/accelerate/index.html">
+        <img alt="Documentation" src="https://img.shields.io/website/http/huggingface.co/docs/accelerate/index.html.svg?down_color=red&down_message=offline&up_message=online">
+    </a>
+    <a href="https://github.com/huggingface/accelerate/releases">
+        <img alt="GitHub release" src="https://img.shields.io/github/release/huggingface/accelerate.svg">
+    </a>
+    <a href="https://github.com/huggingface/accelerate/blob/main/CODE_OF_CONDUCT.md">
+        <img alt="Contributor Covenant" src="https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg">
+    </a>
+</p>
+
+<h3 align="center">
+<p>Run your *raw* PyTorch training script on any kind of device
+</h3>
+
+<h3 align="center">
+    <a href="https://hf.co/course"><img src="https://raw.githubusercontent.com/huggingface/accelerate/main/docs/source/imgs/course_banner.png"></a>
+</h3>
+
+## Easy to integrate
+
+🤗 Accelerate was created for PyTorch users who like to write the training loop of PyTorch models but are reluctant to write and maintain the boilerplate code needed to use multi-GPUs/TPU/fp16.
+
+🤗 Accelerate abstracts exactly and only the boilerplate code related to multi-GPUs/TPU/fp16 and leaves the rest of your code unchanged.
+
+Here is an example:
+
+```diff
+  import torch
+  import torch.nn.functional as F
+  from datasets import load_dataset
++ from accelerate import Accelerator
+
++ accelerator = Accelerator()
+- device = 'cpu'
++ device = accelerator.device
+
+  model = torch.nn.Transformer().to(device)
+  optimizer = torch.optim.Adam(model.parameters())
+
+  dataset = load_dataset('my_dataset')
+  data = torch.utils.data.DataLoader(dataset, shuffle=True)
+
++ model, optimizer, data = accelerator.prepare(model, optimizer, data)
+
+  model.train()
+  for epoch in range(10):
+      for source, targets in data:
+          source = source.to(device)
+          targets = targets.to(device)
+
+          optimizer.zero_grad()
+
+          output = model(source)
+          loss = F.cross_entropy(output, targets)
+
+-         loss.backward()
++         accelerator.backward(loss)
+
+          optimizer.step()
+```
+
+As you can see in this example, by adding 5-lines to any standard PyTorch training script you can now run on any kind of single or distributed node setting (single CPU, single GPU, multi-GPUs and TPUs) as well as with or without mixed precision (fp8, fp16, bf16).
+
+In particular, the same code can then be run without modification on your local machine for debugging or your training environment.
+
+🤗 Accelerate even handles the device placement for you (which requires a few more changes to your code, but is safer in general), so you can even simplify your training loop further:
+
+```diff
+  import torch
+  import torch.nn.functional as F
+  from datasets import load_dataset
++ from accelerate import Accelerator
+
+- device = 'cpu'
++ accelerator = Accelerator()
+
+- model = torch.nn.Transformer().to(device)
++ model = torch.nn.Transformer()
+  optimizer = torch.optim.Adam(model.parameters())
+
+  dataset = load_dataset('my_dataset')
+  data = torch.utils.data.DataLoader(dataset, shuffle=True)
+
++ model, optimizer, data = accelerator.prepare(model, optimizer, data)
+
+  model.train()
+  for epoch in range(10):
+      for source, targets in data:
+-         source = source.to(device)
+-         targets = targets.to(device)
+
+          optimizer.zero_grad()
+
+          output = model(source)
+          loss = F.cross_entropy(output, targets)
+
+-         loss.backward()
++         accelerator.backward(loss)
+
+          optimizer.step()
+```
+
+Want to learn more? Check out the [documentation](https://huggingface.co/docs/accelerate) or have a look at our [examples](https://github.com/huggingface/accelerate/tree/main/examples).
+
+## Launching script
+
+🤗 Accelerate also provides an optional CLI tool that allows you to quickly configure and test your training environment before launching the scripts. No need to remember how to use `torch.distributed.run` or to write a specific launcher for TPU training!
+On your machine(s) just run:
+
+```bash
+accelerate config
+```
+
+and answer the questions asked. This will generate a config file that will be used automatically to properly set the default options when doing
+
+```bash
+accelerate launch my_script.py --args_to_my_script
+``` 
+
+For instance, here is how you would run the GLUE example on the MRPC task (from the root of the repo):
+
+```bash
+accelerate launch examples/nlp_example.py
+```
+
+This CLI tool is **optional**, and you can still use `python my_script.py` or `python -m torchrun my_script.py` at your convenience.
+
+You can also directly pass in the arguments you would to `torchrun` as arguments to `accelerate launch` if you wish to not run` accelerate config`.
+
+For example, here is how to launch on two GPUs:
+
+```bash
+accelerate launch --multi_gpu --num_processes 2 examples/nlp_example.py
+```
+
+To learn more, check the CLI documentation available [here](https://huggingface.co/docs/accelerate/package_reference/cli).
+
+## Launching multi-CPU run using MPI
+
+🤗 Here is another way to launch multi-CPU run using MPI. You can learn how to install Open MPI on [this page](https://www.open-mpi.org/faq/?category=building#easy-build). You can use Intel MPI or MVAPICH as well.
+Once you have MPI setup on your cluster, just run:
+```bash
+accelerate config
+```
+Answer the questions that are asked, selecting to run using multi-CPU, and answer "yes" when asked if you want accelerate to launch mpirun.
+Then, use `accelerate launch` with your script like:
+```bash
+accelerate launch examples/nlp_example.py
+```
+Alternatively, you can use mpirun directly, without using the CLI like:
+```bash
+mpirun -np 2 python examples/nlp_example.py
+```
+
+## Launching training using DeepSpeed
+
+🤗 Accelerate supports training on single/multiple GPUs using DeepSpeed. To use it, you don't need to change anything in your training code; you can set everything using just `accelerate config`. However, if you desire to tweak your DeepSpeed related args from your Python script, we provide you the `DeepSpeedPlugin`.
+
+```python
+from accelerate import Accelerator, DeepSpeedPlugin
+
+# deepspeed needs to know your gradient accumulation steps beforehand, so don't forget to pass it
+# Remember you still need to do gradient accumulation by yourself, just like you would have done without deepspeed
+deepspeed_plugin = DeepSpeedPlugin(zero_stage=2, gradient_accumulation_steps=2)
+accelerator = Accelerator(mixed_precision='fp16', deepspeed_plugin=deepspeed_plugin)
+
+# How to save your 🤗 Transformer?
+accelerator.wait_for_everyone()
+unwrapped_model = accelerator.unwrap_model(model)
+unwrapped_model.save_pretrained(save_dir, save_function=accelerator.save, state_dict=accelerator.get_state_dict(model))
+```
+
+Note: DeepSpeed support is experimental for now. In case you get into some problem, please open an issue.
+
+## Launching your training from a notebook
+
+🤗 Accelerate also provides a `notebook_launcher` function you can use in a notebook to launch a distributed training. This is especially useful for Colab or Kaggle notebooks with a TPU backend. Just define your training loop in a `training_function` then in your last cell, add:
+
+```python
+from accelerate import notebook_launcher
+
+notebook_launcher(training_function)
+```
+
+An example can be found in [this notebook](https://github.com/huggingface/notebooks/blob/main/examples/accelerate_examples/simple_nlp_example.ipynb). [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/huggingface/notebooks/blob/main/examples/accelerate_examples/simple_nlp_example.ipynb)
+
+## Why should I use 🤗 Accelerate?
+
+You should use 🤗 Accelerate when you want to easily run your training scripts in a distributed environment without having to renounce full control over your training loop. This is not a high-level framework above PyTorch, just a thin wrapper so you don't have to learn a new library. In fact, the whole API of 🤗 Accelerate is in one class, the `Accelerator` object.
+
+## Why shouldn't I use 🤗 Accelerate?
+
+You shouldn't use 🤗 Accelerate if you don't want to write a training loop yourself. There are plenty of high-level libraries above PyTorch that will offer you that, 🤗 Accelerate is not one of them.
+
+## Frameworks using 🤗 Accelerate
+
+If you like the simplicity of 🤗 Accelerate but would prefer a higher-level abstraction around its capabilities, some frameworks and libraries that are built on top of 🤗 Accelerate are listed below:
+
+* [Amphion](https://github.com/open-mmlab/Amphion) is a toolkit for Audio, Music, and Speech Generation. Its purpose is to support reproducible research and help junior researchers and engineers get started in the field of audio, music, and speech generation research and development.
+* [Animus](https://github.com/Scitator/animus) is a minimalistic framework to run machine learning experiments. Animus highlights common "breakpoints" in ML experiments and provides a unified interface for them within [IExperiment](https://github.com/Scitator/animus/blob/main/animus/core.py#L76).
+* [Catalyst](https://github.com/catalyst-team/catalyst#getting-started) is a PyTorch framework for Deep Learning Research and Development. It focuses on reproducibility, rapid experimentation, and codebase reuse so you can create something new rather than write yet another train loop. Catalyst provides a [Runner](https://catalyst-team.github.io/catalyst/api/core.html#runner) to connect all parts of the experiment: hardware backend, data transformations, model training, and inference logic.
+* [fastai](https://github.com/fastai/fastai#installing) is a PyTorch framework for Deep Learning that simplifies training fast and accurate neural nets using modern best practices. fastai provides a [Learner](https://docs.fast.ai/learner.html#Learner) to handle the training, fine-tuning, and inference of deep learning algorithms.
+* [Finetuner](https://github.com/jina-ai/finetuner) is a service that enables models to create higher-quality embeddings for semantic search, visual similarity search, cross-modal text<->image search, recommendation systems, clustering, duplication detection, anomaly detection, or other uses.
+* [InvokeAI](https://github.com/invoke-ai/InvokeAI) is a creative engine for Stable Diffusion models, offering industry-leading WebUI, terminal usage support, and serves as the foundation for many commercial products.
+* [Kornia](https://kornia.readthedocs.io/en/latest/get-started/introduction.html) is a differentiable library that allows classical computer vision to be integrated into deep learning models. Kornia provides a [Trainer](https://kornia.readthedocs.io/en/latest/x.html#kornia.x.Trainer) with the specific purpose to train and fine-tune the supported deep learning algorithms within the library.
+* [Open Assistant](https://projects.laion.ai/Open-Assistant/) is a chat-based assistant that understands tasks, can interact with their party systems, and retrieve information dynamically to do so. 
+* [pytorch-accelerated](https://github.com/Chris-hughes10/pytorch-accelerated) is a lightweight training library, with a streamlined feature set centered around a general-purpose [Trainer](https://pytorch-accelerated.readthedocs.io/en/latest/trainer.html), that places a huge emphasis on simplicity and transparency; enabling users to understand exactly what is going on under the hood, but without having to write and maintain the boilerplate themselves!
+* [Stable Diffusion web UI](https://github.com/AUTOMATIC1111/stable-diffusion-webui) is an open-source browser-based easy-to-use interface based on the Gradio library for Stable Diffusion.
+* [torchkeras](https://github.com/lyhue1991/torchkeras) is a simple tool for training pytorch model just in a keras style, a dynamic and beautiful plot is provided in notebook to monitor your loss or metric.
+* [transformers](https://github.com/huggingface/transformers) as a tool for helping train state-of-the-art machine learning models in PyTorch, Tensorflow, and JAX. (Accelerate is the backend for the PyTorch side).
+
+
+## Installation
+
+This repository is tested on Python 3.8+ and PyTorch 1.10.0+
+
+You should install 🤗 Accelerate in a [virtual environment](https://docs.python.org/3/library/venv.html). If you're unfamiliar with Python virtual environments, check out the [user guide](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/).
+
+First, create a virtual environment with the version of Python you're going to use and activate it.
+
+Then, you will need to install PyTorch: refer to the [official installation page](https://pytorch.org/get-started/locally/#start-locally) regarding the specific install command for your platform. Then 🤗 Accelerate can be installed using pip as follows:
+
+```bash
+pip install accelerate
+```
+
+## Supported integrations
+
+- CPU only
+- multi-CPU on one node (machine)
+- multi-CPU on several nodes (machines)
+- single GPU
+- multi-GPU on one node (machine)
+- multi-GPU on several nodes (machines)
+- TPU
+- FP16/BFloat16 mixed precision
+- FP8 mixed precision with [Transformer Engine](https://github.com/NVIDIA/TransformerEngine)
+- DeepSpeed support (Experimental)
+- PyTorch Fully Sharded Data Parallel (FSDP) support (Experimental)
+- Megatron-LM support (Experimental)
+
+## Citing 🤗 Accelerate
+
+If you use 🤗 Accelerate in your publication, please cite it by using the following BibTeX entry.
+
+```bibtex
+@Misc{accelerate,
+  title =        {Accelerate: Training and inference at scale made simple, efficient and adaptable.},
+  author =       {Sylvain Gugger and Lysandre Debut and Thomas Wolf and Philipp Schmid and Zachary Mueller and Sourab Mangrulkar and Marc Sun and Benjamin Bossan},
+  howpublished = {\url{https://github.com/huggingface/accelerate}},
+  year =         {2022}
+}
+```
diff --git a/llm/Lib/site-packages/accelerate-0.29.3.dist-info/RECORD b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..a4e7cd37a814c31d600a1dddc487dbd22b97d6f9
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/RECORD
@@ -0,0 +1,164 @@
+../../Scripts/accelerate-config.exe,sha256=Vc33m1EHdtjr3Go97mmzD40pHC0udwU7e2YlKu-NM6Q,108393
+../../Scripts/accelerate-estimate-memory.exe,sha256=X-r55bc3vnkw-IVoXywYuIOAVJgqbUiCHJcbDW2hPXA,108395
+../../Scripts/accelerate-launch.exe,sha256=t4JMeZ4RvYQdn-ldK88qgDsWQx1l12rMbomdlG5IFHU,108393
+../../Scripts/accelerate.exe,sha256=pReYe3Amm_rR1mdNNM1ghovR9bfE0U1BvtFmpT8cEHM,108401
+accelerate-0.29.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+accelerate-0.29.3.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+accelerate-0.29.3.dist-info/METADATA,sha256=DNiQffLlP8RQMZZvHtnR0loDVK60yC3FhB8UQKkthgo,18942
+accelerate-0.29.3.dist-info/RECORD,,
+accelerate-0.29.3.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+accelerate-0.29.3.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
+accelerate-0.29.3.dist-info/entry_points.txt,sha256=Z_KV59tIt4oZtUDEQ0w8JThJ6_1dd8vR8heH24DeAXI,238
+accelerate-0.29.3.dist-info/top_level.txt,sha256=esVfdxTidsjQ90zsN_rPpjLFJ4ijRlx4mnLrG09hlt4,11
+accelerate/__init__.py,sha256=UUqSsQQDFMm6aAZGCgNyrbTFPtwkguZA2KnoPb0XbWo,1456
+accelerate/__pycache__/__init__.cpython-311.pyc,,
+accelerate/__pycache__/accelerator.cpython-311.pyc,,
+accelerate/__pycache__/big_modeling.cpython-311.pyc,,
+accelerate/__pycache__/checkpointing.cpython-311.pyc,,
+accelerate/__pycache__/data_loader.cpython-311.pyc,,
+accelerate/__pycache__/hooks.cpython-311.pyc,,
+accelerate/__pycache__/inference.cpython-311.pyc,,
+accelerate/__pycache__/launchers.cpython-311.pyc,,
+accelerate/__pycache__/local_sgd.cpython-311.pyc,,
+accelerate/__pycache__/logging.cpython-311.pyc,,
+accelerate/__pycache__/memory_utils.cpython-311.pyc,,
+accelerate/__pycache__/optimizer.cpython-311.pyc,,
+accelerate/__pycache__/scheduler.cpython-311.pyc,,
+accelerate/__pycache__/state.cpython-311.pyc,,
+accelerate/__pycache__/tracking.cpython-311.pyc,,
+accelerate/accelerator.py,sha256=rh4-KBMCkCGLldjKo1CRtBIbsXG76fJqYWdgOugaw7w,143024
+accelerate/big_modeling.py,sha256=pmtLTKTf8mJK1E2o51E3H5TBAuw_zLX_7pWtogtbP1w,29278
+accelerate/checkpointing.py,sha256=vFyLNg9-8qsPBYhAkcm-WwKEeK5Lrq9qLrQWNGFKoPk,11378
+accelerate/commands/__init__.py,sha256=m1PPTDT4ziIAvM0-FDSgIMIZ69Konn126s6LwuzH6v8,606
+accelerate/commands/__pycache__/__init__.cpython-311.pyc,,
+accelerate/commands/__pycache__/accelerate_cli.cpython-311.pyc,,
+accelerate/commands/__pycache__/env.cpython-311.pyc,,
+accelerate/commands/__pycache__/estimate.cpython-311.pyc,,
+accelerate/commands/__pycache__/launch.cpython-311.pyc,,
+accelerate/commands/__pycache__/test.cpython-311.pyc,,
+accelerate/commands/__pycache__/tpu.cpython-311.pyc,,
+accelerate/commands/__pycache__/utils.cpython-311.pyc,,
+accelerate/commands/accelerate_cli.py,sha256=i3nge5Wj8i4zkV0CVIk9P8veleRZbTZY0AU4fJOrKF8,1749
+accelerate/commands/config/__init__.py,sha256=iJK8dgj3pc5Vdr1E7UuGoFu-BlybyXLxYDoTg9gXngE,1645
+accelerate/commands/config/__pycache__/__init__.cpython-311.pyc,,
+accelerate/commands/config/__pycache__/cluster.cpython-311.pyc,,
+accelerate/commands/config/__pycache__/config.cpython-311.pyc,,
+accelerate/commands/config/__pycache__/config_args.cpython-311.pyc,,
+accelerate/commands/config/__pycache__/config_utils.cpython-311.pyc,,
+accelerate/commands/config/__pycache__/default.cpython-311.pyc,,
+accelerate/commands/config/__pycache__/sagemaker.cpython-311.pyc,,
+accelerate/commands/config/__pycache__/update.cpython-311.pyc,,
+accelerate/commands/config/cluster.py,sha256=lA55beGeo0fAowfffKhf8nGcy6lBjaOxTtV-Yg_Rz6s,29926
+accelerate/commands/config/config.py,sha256=FuRlQvOjgATEtyqOSsGD-KEtOCvACOHjs2C-krrtldk,3035
+accelerate/commands/config/config_args.py,sha256=hE42coVnn0UU-ysqp2ZH-jlqaXoPaHt5E_3qxT42GIM,10024
+accelerate/commands/config/config_utils.py,sha256=DcjIV1mDInFmct2_XQ-9KYAkREINs6YuHRbZe5HFjT8,2926
+accelerate/commands/config/default.py,sha256=3-SdEhl_zXM9S3f-FxkSVtiBQ5VY-QNsC4O26u60bss,5350
+accelerate/commands/config/sagemaker.py,sha256=GjHE2-h4tRr1P_PFtMF3miiAtJlzkbHbMb6kFXqn8eo,10341
+accelerate/commands/config/update.py,sha256=NXW1J7GkUHpg71QlIXsmMB_0z8S8IZo2FWax5POwrhc,2395
+accelerate/commands/env.py,sha256=HXXUozMFlxs0b-bU2a3nEcXwYz-5EBkfCvE9svqeN2U,3595
+accelerate/commands/estimate.py,sha256=shEn2nXyHmz94zpAzV2R8__lcNYW9f9djl7bOHoo04k,12398
+accelerate/commands/launch.py,sha256=rYmkdc0Kbcux4TOqBG_sJN-NNc4nmV90vuwHqhGNfWw,41439
+accelerate/commands/menu/__init__.py,sha256=uqSlBM0TFHBwzdv3p3SXfpAk1lZFp4h1a7mbBdscPHs,645
+accelerate/commands/menu/__pycache__/__init__.cpython-311.pyc,,
+accelerate/commands/menu/__pycache__/cursor.cpython-311.pyc,,
+accelerate/commands/menu/__pycache__/helpers.cpython-311.pyc,,
+accelerate/commands/menu/__pycache__/input.cpython-311.pyc,,
+accelerate/commands/menu/__pycache__/keymap.cpython-311.pyc,,
+accelerate/commands/menu/__pycache__/selection_menu.cpython-311.pyc,,
+accelerate/commands/menu/cursor.py,sha256=-lmpJVAzvNc0c3EOtSuLoKB59zqylVCbYyWLPnrOmvQ,2028
+accelerate/commands/menu/helpers.py,sha256=KrSB5fJjH4MUEUAQJ6bYaN16AYcnl9UalDrPD3DYeeg,1483
+accelerate/commands/menu/input.py,sha256=Uj9eDp8-Mb0Fe49nuogqo9W_RCfYd6udfjiPKx7Wjmg,2537
+accelerate/commands/menu/keymap.py,sha256=eXj-suyYs1m5dEHoUKN4mKAMLc8DWHnwhP6G6JSU0jQ,4086
+accelerate/commands/menu/selection_menu.py,sha256=bxy-DHaKKC6SCToOlMBv5_z0MdUzylEg6Sio9OuV3GM,4921
+accelerate/commands/test.py,sha256=YrPYEaAACOGZ6btn2MV6NbMSEdBUcMWADLbQWaZSHtk,2149
+accelerate/commands/tpu.py,sha256=KyxDP7IuveidZrbW4rx2s8Ku3o_ptI6tzwr_R7ck0os,5548
+accelerate/commands/utils.py,sha256=ilcfE32oHh28EToM00nc_SR6upfZiuxUI0AjjZu8KYY,3995
+accelerate/data_loader.py,sha256=qQojnHAW0cjTL7jLQN_g-oHlRZBkKzti3ifk84Izuw4,48307
+accelerate/hooks.py,sha256=x0FBwwoy6PKSwulavYTpc4gERIoB7RHGPF0Qe6qjXNA,31244
+accelerate/inference.py,sha256=Ci7kkw2cocNpuvmbo1ytW2QgcI_HKWoXkIdonFOr0tg,7977
+accelerate/launchers.py,sha256=iFDZ7seDdRwHAHy1BbVPmPccAONiPdV2aBOHNuT2ZD8,11375
+accelerate/local_sgd.py,sha256=v0-AxldUSCYCI-rqjLiEHsVtSqyEIWTC5ppn7CW7qfY,4002
+accelerate/logging.py,sha256=kvUvk33r_7T2BNzIwqRZBOhuC-50Ju4rm4HbsM6h2G8,4897
+accelerate/memory_utils.py,sha256=3R5LoeHl6GgTZ-IMPrDZMdaEehWarGdPqODushb-6pg,862
+accelerate/optimizer.py,sha256=H7e1XwEysZ_GFR8V_3bHjFAY7zzrzO8samCyW_r7dZo,7453
+accelerate/scheduler.py,sha256=des_4M_Tt1W8gCYZZbLla0GHBEgJY3Wx2EGBQPTzeiY,4238
+accelerate/state.py,sha256=yOpKq0xf-yY7qPeQMKWqG05PiU_uUsIkyGqyAlOIJNQ,50409
+accelerate/test_utils/__init__.py,sha256=amEDYw-ztgIvHkYT3mv3ixk1QJirUnf6jfPJzqUUYkQ,1459
+accelerate/test_utils/__pycache__/__init__.cpython-311.pyc,,
+accelerate/test_utils/__pycache__/examples.cpython-311.pyc,,
+accelerate/test_utils/__pycache__/testing.cpython-311.pyc,,
+accelerate/test_utils/__pycache__/training.cpython-311.pyc,,
+accelerate/test_utils/examples.py,sha256=jRm1S9TkmeoLaqprBvtVFN4LesiaDZtKMNIoLNY2euw,7281
+accelerate/test_utils/scripts/__init__.py,sha256=m1PPTDT4ziIAvM0-FDSgIMIZ69Konn126s6LwuzH6v8,606
+accelerate/test_utils/scripts/__pycache__/__init__.cpython-311.pyc,,
+accelerate/test_utils/scripts/__pycache__/test_cli.cpython-311.pyc,,
+accelerate/test_utils/scripts/__pycache__/test_distributed_data_loop.cpython-311.pyc,,
+accelerate/test_utils/scripts/__pycache__/test_notebook.cpython-311.pyc,,
+accelerate/test_utils/scripts/__pycache__/test_ops.cpython-311.pyc,,
+accelerate/test_utils/scripts/__pycache__/test_script.cpython-311.pyc,,
+accelerate/test_utils/scripts/__pycache__/test_sync.cpython-311.pyc,,
+accelerate/test_utils/scripts/external_deps/__init__.py,sha256=m1PPTDT4ziIAvM0-FDSgIMIZ69Konn126s6LwuzH6v8,606
+accelerate/test_utils/scripts/external_deps/__pycache__/__init__.cpython-311.pyc,,
+accelerate/test_utils/scripts/external_deps/__pycache__/test_checkpointing.cpython-311.pyc,,
+accelerate/test_utils/scripts/external_deps/__pycache__/test_metrics.cpython-311.pyc,,
+accelerate/test_utils/scripts/external_deps/__pycache__/test_peak_memory_usage.cpython-311.pyc,,
+accelerate/test_utils/scripts/external_deps/__pycache__/test_performance.cpython-311.pyc,,
+accelerate/test_utils/scripts/external_deps/__pycache__/test_pippy.cpython-311.pyc,,
+accelerate/test_utils/scripts/external_deps/__pycache__/test_zero3_integration.cpython-311.pyc,,
+accelerate/test_utils/scripts/external_deps/test_checkpointing.py,sha256=zILzHevzqxB1NPPDrJ1furaitI8MTvhBeG9QzzL0bmE,10668
+accelerate/test_utils/scripts/external_deps/test_metrics.py,sha256=67-S1qeCpCL9ceaH22RsIsBJscMS7VQWaO4Krcszzbw,12133
+accelerate/test_utils/scripts/external_deps/test_peak_memory_usage.py,sha256=D0YnKCxkI4ZwDOmZ5Ev6hL9jPyP7SU4WffpVFiK14bs,11072
+accelerate/test_utils/scripts/external_deps/test_performance.py,sha256=8fV3wCM1H9HVRRyC5C4EGWt-9aHILX_y3-E7LfSiv7M,9803
+accelerate/test_utils/scripts/external_deps/test_pippy.py,sha256=RdMoD1rlLKMyjyl0soSqR3iDbGidS6-z5GHo3bJUOw8,4647
+accelerate/test_utils/scripts/external_deps/test_zero3_integration.py,sha256=bJ0Jio-6OCyS2FIgFmZi3duqG1gbkOoTEcHsrORYIL4,1503
+accelerate/test_utils/scripts/test_cli.py,sha256=qfk1aYFtdvYFCYPkl05602SNGvk08QTv0xZVVcFVtzM,833
+accelerate/test_utils/scripts/test_distributed_data_loop.py,sha256=VqFPKNRu8yx2MoZ4nHy5wRocEthSymcIA2mg1knqDq8,8315
+accelerate/test_utils/scripts/test_notebook.py,sha256=Q4OOWHa_GMmzwfiq71BTpKYmhCHLC02J42OO94ut9xk,1629
+accelerate/test_utils/scripts/test_ops.py,sha256=BcGn3xJT2wUJ0Yk_6VLNkneSv9z24JeAoQjsgdIIRr4,6170
+accelerate/test_utils/scripts/test_script.py,sha256=QyHRWvHQm1XWkAH7YilQ0gZe3zwvEkyqD6JXmneWqak,32059
+accelerate/test_utils/scripts/test_sync.py,sha256=3kltq-GuUjOVuo6_FOuWiPyc5f3pGiqiwEAbex5x_-o,18263
+accelerate/test_utils/testing.py,sha256=HIp7n6qPMh8KPbwEzNWu5mzfxnQRcU15EQ1AQKehpo0,20571
+accelerate/test_utils/training.py,sha256=8k_YAQ21MzUdb2aFWq1t2fihW1b-iBGh1OJSL3whY68,4019
+accelerate/tracking.py,sha256=WLY-H1DTsxrz4BVzle7QZMp0Irg84yFMbA1e6JaY3pM,39789
+accelerate/utils/__init__.py,sha256=SEP34Od2TbTZt7AbhPJoWWDxFoNMeNEyAuVfaPgVu7k,6065
+accelerate/utils/__pycache__/__init__.cpython-311.pyc,,
+accelerate/utils/__pycache__/bnb.cpython-311.pyc,,
+accelerate/utils/__pycache__/constants.cpython-311.pyc,,
+accelerate/utils/__pycache__/dataclasses.cpython-311.pyc,,
+accelerate/utils/__pycache__/deepspeed.cpython-311.pyc,,
+accelerate/utils/__pycache__/environment.cpython-311.pyc,,
+accelerate/utils/__pycache__/fsdp_utils.cpython-311.pyc,,
+accelerate/utils/__pycache__/imports.cpython-311.pyc,,
+accelerate/utils/__pycache__/launch.cpython-311.pyc,,
+accelerate/utils/__pycache__/megatron_lm.cpython-311.pyc,,
+accelerate/utils/__pycache__/memory.cpython-311.pyc,,
+accelerate/utils/__pycache__/modeling.cpython-311.pyc,,
+accelerate/utils/__pycache__/offload.cpython-311.pyc,,
+accelerate/utils/__pycache__/operations.cpython-311.pyc,,
+accelerate/utils/__pycache__/other.cpython-311.pyc,,
+accelerate/utils/__pycache__/random.cpython-311.pyc,,
+accelerate/utils/__pycache__/rich.cpython-311.pyc,,
+accelerate/utils/__pycache__/torch_xla.cpython-311.pyc,,
+accelerate/utils/__pycache__/tqdm.cpython-311.pyc,,
+accelerate/utils/__pycache__/transformer_engine.cpython-311.pyc,,
+accelerate/utils/__pycache__/versions.cpython-311.pyc,,
+accelerate/utils/bnb.py,sha256=3i59dy8EcBYJEnT2alJ5_M-zeIpFsrceQ4bImiJJKOk,20570
+accelerate/utils/constants.py,sha256=e6Bpf7gSZLFkvfr-1B1841b6lVoKJ5uyyf5kefe0aT4,2566
+accelerate/utils/dataclasses.py,sha256=QSP-gYjXz68s0PAseKwLHRBQUnzcBQwPk80otV4X20k,74253
+accelerate/utils/deepspeed.py,sha256=1JFnz-dY6xP9yHywnX8bzZNq-d-8Cpg5CvVNLZ74b_0,10276
+accelerate/utils/environment.py,sha256=8eVGMCu7xT1y0Hxochnxz_RghDePtWo2TghDlOm5Gf0,10409
+accelerate/utils/fsdp_utils.py,sha256=QURWBtK8D00zppqJko0yeznEovXvnkRLI0NpPPkog1Q,10667
+accelerate/utils/imports.py,sha256=gYj_W3E5V83dYlSqqYE89OAK6JonzwhlcEjsJcOpB3E,12232
+accelerate/utils/launch.py,sha256=hHpcnR0NrSmqaT7AIaeIeXOAJVIhWnWdq3kA1XSnOYs,27459
+accelerate/utils/megatron_lm.py,sha256=IfHrtMiPSwuzh5ri96rTTIcEluuMNuIj3O8Y4jW6Fzk,57124
+accelerate/utils/memory.py,sha256=VxJCU-tMX8uE34GbJnxtDXYPHh4D9p2Y-d6rkGxqSa0,5200
+accelerate/utils/modeling.py,sha256=OfTHPg7oM9-jzYotLZjJKj6TrhCTFV3qOtQAOhKXmzQ,80246
+accelerate/utils/offload.py,sha256=qjaVai81wbkA0YH2WkmOXvZT0BRphygfRV_4Ua4j4U4,7837
+accelerate/utils/operations.py,sha256=zsmRx8mP2eoImPc42pOmBIqaHX7RDugw8AZ_HF3onpg,30610
+accelerate/utils/other.py,sha256=kgON65EhzQN3oQZqzgAOmmNC2vsQkeO77qEuzN7Zv7c,12283
+accelerate/utils/random.py,sha256=t-HsLQRm8etSiLSyONCU9wNhj-0VjDUyDme9p6RxDNU,4881
+accelerate/utils/rich.py,sha256=8JZX_uGMQX-BufdXxJpdne7BWd1KyLHSgbiGxrDMYr8,847
+accelerate/utils/torch_xla.py,sha256=Pq1tuqN0X_pWDVza6YgjfO45uoJdoRVRForLeLQzFus,1908
+accelerate/utils/tqdm.py,sha256=9Ovx4GL8AvjSaBd_OysoUGPW9ZJ3ZBOde6776HMEMOA,1344
+accelerate/utils/transformer_engine.py,sha256=gNPkOv_D1SDLm6nVZtxWIjyA6snxWtAQeBWUZLIErJE,3582
+accelerate/utils/versions.py,sha256=UgmcbjBm--6CIx1ZamSAMjAK_B_2l48LbeaNygqej8M,2149
diff --git a/llm/Lib/site-packages/accelerate-0.29.3.dist-info/REQUESTED b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/REQUESTED
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/accelerate-0.29.3.dist-info/WHEEL b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..becc9a66ea739ba941d48a749e248761cc6e658a
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.37.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/accelerate-0.29.3.dist-info/entry_points.txt b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..db491c83cf468945b19a098b171fcbfa7d7db1d1
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/entry_points.txt
@@ -0,0 +1,5 @@
+[console_scripts]
+accelerate = accelerate.commands.accelerate_cli:main
+accelerate-config = accelerate.commands.config:main
+accelerate-estimate-memory = accelerate.commands.estimate:main
+accelerate-launch = accelerate.commands.launch:main
diff --git a/llm/Lib/site-packages/accelerate-0.29.3.dist-info/top_level.txt b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..a9368375be0e0e13fdad0eea4b92541bd9e1f594
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate-0.29.3.dist-info/top_level.txt
@@ -0,0 +1 @@
+accelerate
diff --git a/llm/Lib/site-packages/accelerate/__init__.py b/llm/Lib/site-packages/accelerate/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d596762c554a4f07598401d2b1b22c46250dcb55
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/__init__.py
@@ -0,0 +1,48 @@
+# Copyright 2020 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+__version__ = "0.29.3"
+
+from .accelerator import Accelerator
+from .big_modeling import (
+    cpu_offload,
+    cpu_offload_with_hook,
+    disk_offload,
+    dispatch_model,
+    init_empty_weights,
+    init_on_device,
+    load_checkpoint_and_dispatch,
+)
+from .data_loader import skip_first_batches
+from .inference import prepare_pippy
+from .launchers import debug_launcher, notebook_launcher
+from .state import PartialState
+from .utils import (
+    AutocastKwargs,
+    DataLoaderConfiguration,
+    DeepSpeedPlugin,
+    DistributedDataParallelKwargs,
+    DistributedType,
+    FullyShardedDataParallelPlugin,
+    GradScalerKwargs,
+    InitProcessGroupKwargs,
+    find_executable_batch_size,
+    infer_auto_device_map,
+    is_rich_available,
+    load_checkpoint_in_model,
+    synchronize_rng_states,
+)
+
+
+if is_rich_available():
+    from .utils import rich
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a6d6edd9914b7e1f9cba4d32fbb5423e52fe77f2
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/accelerator.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/accelerator.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..406505080b964ee4ababb9d223cf495a34740506
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/accelerator.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/big_modeling.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/big_modeling.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f08849909f0b722898b7db12bf9b2abd75594b71
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/big_modeling.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/checkpointing.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/checkpointing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8919c57d3a4fc44b3ec89656a5fec504654360b5
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/checkpointing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/data_loader.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/data_loader.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f8fb3eddc41c540a1fb6449b0e37e10e457a8bba
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/data_loader.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/hooks.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/hooks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..81a0009a08f8a8dad26d0ae8f9ea9947f2013f56
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/hooks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/inference.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/inference.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..713c9ae11f342a4adcc38fe4b6e6df0390eb1771
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/inference.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/launchers.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/launchers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4c18ea73257b782b47a5ed1d831787418134ed43
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/launchers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/local_sgd.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/local_sgd.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..93d48a3d1c232e3d8a84b726577139d251715054
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/local_sgd.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/logging.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/logging.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1d728be1122a2090219cb78c3916030ab790bba6
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/logging.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/memory_utils.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/memory_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d96a3f67f69930a8d49908f1bc305c2291711c94
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/memory_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/optimizer.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/optimizer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..78daf90c49b5045cfc152916c4a848e07e9acd4a
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/optimizer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/scheduler.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/scheduler.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..398bfc6fac8a572b092a5f8f3b0e12bcffa7ba51
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/scheduler.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/state.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/state.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3d8c67d25c6aaa9b8cd8cdec64b73b40d2cb24b6
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/state.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/__pycache__/tracking.cpython-311.pyc b/llm/Lib/site-packages/accelerate/__pycache__/tracking.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d39b552c2ce546e85b4907a1ac648414e8b522a5
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/__pycache__/tracking.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/accelerator.py b/llm/Lib/site-packages/accelerate/accelerator.py
new file mode 100644
index 0000000000000000000000000000000000000000..4786946c6da68e12a29b5f3cd799d40e6af49c4a
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/accelerator.py
@@ -0,0 +1,3259 @@
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import contextlib
+import functools
+import json
+import math
+import os
+import re
+import shutil
+import sys
+import warnings
+from collections import OrderedDict
+from contextlib import contextmanager
+from functools import partial
+from types import MethodType
+from typing import Any, Callable, Union
+
+import torch
+import torch.utils.hooks as hooks
+
+from .checkpointing import load_accelerator_state, load_custom_state, save_accelerator_state, save_custom_state
+from .data_loader import DataLoaderDispatcher, prepare_data_loader, skip_first_batches
+from .hooks import AlignDevicesHook
+from .logging import get_logger
+from .optimizer import AcceleratedOptimizer
+from .scheduler import AcceleratedScheduler
+from .state import AcceleratorState, GradientState, PartialState
+from .tracking import LOGGER_TYPE_TO_CLASS, GeneralTracker, filter_trackers
+from .utils import (
+    MODEL_NAME,
+    SAFE_WEIGHTS_INDEX_NAME,
+    SAFE_WEIGHTS_NAME,
+    WEIGHTS_INDEX_NAME,
+    WEIGHTS_NAME,
+    AutocastKwargs,
+    DataLoaderConfiguration,
+    DeepSpeedPlugin,
+    DistributedDataParallelKwargs,
+    DistributedType,
+    DynamoBackend,
+    FP8RecipeKwargs,
+    FullyShardedDataParallelPlugin,
+    GradientAccumulationPlugin,
+    GradScalerKwargs,
+    InitProcessGroupKwargs,
+    KwargsHandler,
+    LoggerType,
+    MegatronLMPlugin,
+    PrecisionType,
+    ProjectConfiguration,
+    RNGType,
+    TorchDynamoPlugin,
+    check_os_kernel,
+    clean_state_dict_for_safetensors,
+    compare_versions,
+    convert_model,
+    convert_outputs_to_fp32,
+    extract_model_from_parallel,
+    gather,
+    gather_object,
+    get_mixed_precision_context_manager,
+    get_pretty_name,
+    has_transformer_engine_layers,
+    is_bf16_available,
+    is_deepspeed_available,
+    is_fp8_available,
+    is_ipex_available,
+    is_megatron_lm_available,
+    is_mlu_available,
+    is_msamp_available,
+    is_npu_available,
+    is_torch_version,
+    is_torch_xla_available,
+    is_xpu_available,
+    load_fsdp_model,
+    load_fsdp_optimizer,
+    pad_across_processes,
+    parse_choice_from_env,
+    recursively_apply,
+    reduce,
+    release_memory,
+    save,
+    save_fsdp_model,
+    save_fsdp_optimizer,
+    shard_checkpoint,
+    wait_for_everyone,
+)
+from .utils.constants import FSDP_PYTORCH_VERSION
+from .utils.modeling import get_state_dict_offloaded_model
+from .utils.other import is_compiled_module
+
+
+if is_deepspeed_available():
+    from .utils import (
+        DeepSpeedEngineWrapper,
+        DeepSpeedOptimizerWrapper,
+        DeepSpeedSchedulerWrapper,
+        DummyOptim,
+        DummyScheduler,
+    )
+
+if is_fp8_available():
+    import transformer_engine.common.recipe as te_recipe
+    from transformer_engine.pytorch import fp8_autocast
+
+
+if is_megatron_lm_available():
+    from .utils import (
+        MegatronEngine,
+        MegatronLMDummyDataLoader,
+        MegatronLMDummyScheduler,
+        MegatronLMOptimizerWrapper,
+        MegatronLMSchedulerWrapper,
+        megatron_lm_initialize,
+        megatron_lm_prepare_data_loader,
+        megatron_lm_prepare_model,
+        megatron_lm_prepare_optimizer,
+        megatron_lm_prepare_scheduler,
+    )
+
+from torch.distributed.algorithms.join import Join
+
+
+if is_torch_xla_available():
+    import torch_xla.amp as xamp
+    import torch_xla.core.xla_model as xm
+    import torch_xla.distributed.xla_multiprocessing as xmp
+
+
+if is_npu_available(check_device=False):
+    import torch_npu  # noqa: F401
+
+
+try:
+    from torch.optim.lr_scheduler import LRScheduler
+except ImportError:
+    from torch.optim.lr_scheduler import _LRScheduler as LRScheduler
+
+logger = get_logger(__name__)
+
+# Sentinel values for defaults
+_split_batches = object()
+_dispatch_batches = object()
+_even_batches = object()
+_use_seedable_sampler = object()
+
+
+class Accelerator:
+    """
+    Creates an instance of an accelerator for distributed training (on multi-GPU, TPU) or mixed precision training.
+
+    Args:
+        device_placement (`bool`, *optional*, defaults to `True`):
+            Whether or not the accelerator should put objects on device (tensors yielded by the dataloader, model,
+            etc...).
+        mixed_precision (`str`, *optional*):
+            Whether or not to use mixed precision training. Choose from 'no','fp16','bf16 or 'fp8'. Will default to the
+            value in the environment variable `ACCELERATE_MIXED_PRECISION`, which will use the default value in the
+            accelerate config of the current system or the flag passed with the `accelerate.launch` command. 'fp8'
+            requires the installation of transformers-engine.
+        gradient_accumulation_steps (`int`, *optional*, default to 1):
+            The number of steps that should pass before gradients are accumulated. A number > 1 should be combined with
+            `Accelerator.accumulate`. If not passed, will default to the value in the environment variable
+            `ACCELERATE_GRADIENT_ACCUMULATION_STEPS`. Can also be configured through a `GradientAccumulationPlugin`.
+        cpu (`bool`, *optional*):
+            Whether or not to force the script to execute on CPU. Will ignore GPU available if set to `True` and force
+            the execution on one process only.
+        dataloader_config (`DataLoaderConfiguration`, *optional*):
+            A configuration for how the dataloaders should be handled in distributed scenarios.
+        deepspeed_plugin ([`~utils.DeepSpeedPlugin`], *optional*):
+            Tweak your DeepSpeed related args using this argument. This argument is optional and can be configured
+            directly using *accelerate config*
+        fsdp_plugin ([`~utils.FullyShardedDataParallelPlugin`], *optional*):
+            Tweak your FSDP related args using this argument. This argument is optional and can be configured directly
+            using *accelerate config*
+        megatron_lm_plugin ([`~utils.MegatronLMPlugin`], *optional*):
+            Tweak your MegatronLM related args using this argument. This argument is optional and can be configured
+            directly using *accelerate config*
+        rng_types (list of `str` or [`~utils.RNGType`]):
+            The list of random number generators to synchronize at the beginning of each iteration in your prepared
+            dataloaders. Should be one or several of:
+
+            - `"torch"`: the base torch random number generator
+            - `"cuda"`: the CUDA random number generator (GPU only)
+            - `"xla"`: the XLA random number generator (TPU only)
+            - `"generator"`: the `torch.Generator` of the sampler (or batch sampler if there is no sampler in your
+              dataloader) or of the iterable dataset (if it exists) if the underlying dataset is of that type.
+
+            Will default to `["torch"]` for PyTorch versions <=1.5.1 and `["generator"]` for PyTorch versions >= 1.6.
+        log_with (list of `str`, [`~utils.LoggerType`] or [`~tracking.GeneralTracker`], *optional*):
+            A list of loggers to be setup for experiment tracking. Should be one or several of:
+
+            - `"all"`
+            - `"tensorboard"`
+            - `"wandb"`
+            - `"comet_ml"`
+            If `"all"` is selected, will pick up all available trackers in the environment and initialize them. Can
+            also accept implementations of `GeneralTracker` for custom trackers, and can be combined with `"all"`.
+        project_config ([`~utils.ProjectConfiguration`], *optional*):
+            A configuration for how saving the state can be handled.
+        project_dir (`str`, `os.PathLike`, *optional*):
+            A path to a directory for storing data such as logs of locally-compatible loggers and potentially saved
+            checkpoints.
+        step_scheduler_with_optimizer (`bool`, *optional`, defaults to `True`):
+            Set `True` if the learning rate scheduler is stepped at the same time as the optimizer, `False` if only
+            done under certain circumstances (at the end of each epoch, for instance).
+        kwargs_handlers (list of [`~utils.KwargsHandler`], *optional*)
+            A list of [`~utils.KwargsHandler`] to customize how the objects related to distributed training or mixed
+            precision are created. See [kwargs](kwargs) for more information.
+        dynamo_backend (`str` or [`~utils.DynamoBackend`], *optional*, defaults to `"no"`):
+            Set to one of the possible dynamo backends to optimize your training with torch dynamo.
+        gradient_accumulation_plugin ([`~utils.GradientAccumulationPlugin`], *optional*):
+            A configuration for how gradient accumulation should be handled, if more tweaking than just the
+            `gradient_accumulation_steps` is needed.
+
+    **Available attributes:**
+
+        - **device** (`torch.device`) -- The device to use.
+        - **distributed_type** ([`~utils.DistributedType`]) -- The distributed training configuration.
+        - **local_process_index** (`int`) -- The process index on the current machine.
+        - **mixed_precision** (`str`) -- The configured mixed precision mode.
+        - **num_processes** (`int`) -- The total number of processes used for training.
+        - **optimizer_step_was_skipped** (`bool`) -- Whether or not the optimizer update was skipped (because of
+          gradient overflow in mixed precision), in which
+        case the learning rate should not be changed.
+        - **process_index** (`int`) -- The overall index of the current process among all processes.
+        - **state** ([`~state.AcceleratorState`]) -- The distributed setup state.
+        - **sync_gradients** (`bool`) -- Whether the gradients are currently being synced across all processes.
+        - **use_distributed** (`bool`) -- Whether the current configuration is for distributed training.
+    """
+
+    def __init__(
+        self,
+        device_placement: bool = True,
+        split_batches: bool = _split_batches,
+        mixed_precision: PrecisionType | str | None = None,
+        gradient_accumulation_steps: int = 1,
+        cpu: bool = False,
+        dataloader_config: DataLoaderConfiguration | None = None,
+        deepspeed_plugin: DeepSpeedPlugin | None = None,
+        fsdp_plugin: FullyShardedDataParallelPlugin | None = None,
+        megatron_lm_plugin: MegatronLMPlugin | None = None,
+        rng_types: list[str | RNGType] | None = None,
+        log_with: str | LoggerType | GeneralTracker | list[str | LoggerType | GeneralTracker] | None = None,
+        project_dir: str | os.PathLike | None = None,
+        project_config: ProjectConfiguration | None = None,
+        gradient_accumulation_plugin: GradientAccumulationPlugin | None = None,
+        dispatch_batches: bool | None = _dispatch_batches,
+        even_batches: bool = _even_batches,
+        use_seedable_sampler: bool = _use_seedable_sampler,
+        step_scheduler_with_optimizer: bool = True,
+        kwargs_handlers: list[KwargsHandler] | None = None,
+        dynamo_backend: DynamoBackend | str | None = None,
+    ):
+        self.trackers = []
+        if project_config is not None:
+            self.project_configuration = project_config
+        else:
+            self.project_configuration = ProjectConfiguration(project_dir=project_dir)
+        if project_dir is not None and self.project_dir is None:
+            self.project_configuration.set_directories(project_dir)
+        if mixed_precision is not None:
+            mixed_precision = str(mixed_precision)
+            if mixed_precision not in PrecisionType:
+                raise ValueError(
+                    f"Unknown mixed_precision mode: {mixed_precision}. Choose between {PrecisionType.list()}"
+                )
+
+        dynamo_plugin = TorchDynamoPlugin() if dynamo_backend is None else TorchDynamoPlugin(backend=dynamo_backend)
+
+        if deepspeed_plugin is None:  # init from env variables
+            deepspeed_plugin = (
+                DeepSpeedPlugin() if os.environ.get("ACCELERATE_USE_DEEPSPEED", "false") == "true" else None
+            )
+        else:
+            assert isinstance(
+                deepspeed_plugin, DeepSpeedPlugin
+            ), "`deepspeed_plugin` must be an `accelerate.utils.DeepSpeedPlugin` object."
+            os.environ["ACCELERATE_USE_DEEPSPEED"] = "true"  # use DeepSpeed if plugin is provided
+        if deepspeed_plugin:
+            if not is_deepspeed_available():
+                raise ImportError("DeepSpeed is not installed => run `pip install deepspeed` or build it from source.")
+            if is_mlu_available():
+                if compare_versions("deepspeed-mlu", "<", "0.10.1"):
+                    raise ImportError("DeepSpeed MLU version must be >= 0.10.1. Please update DeepSpeed MLU.")
+            elif compare_versions("deepspeed", "<", "0.9.3"):
+                raise ImportError("DeepSpeed version must be >= 0.9.3. Please update DeepSpeed.")
+
+            mixed_precision = (
+                os.environ.get("ACCELERATE_MIXED_PRECISION", "no") if mixed_precision is None else mixed_precision
+            )
+            deepspeed_plugin.set_mixed_precision(mixed_precision)
+            deepspeed_plugin.set_deepspeed_weakref()
+
+        if os.environ.get("ACCELERATE_USE_FSDP", "false") == "true" or isinstance(
+            fsdp_plugin, FullyShardedDataParallelPlugin
+        ):
+            if is_torch_version("<", FSDP_PYTORCH_VERSION):
+                raise ValueError(f"FSDP requires PyTorch >= {FSDP_PYTORCH_VERSION}")
+
+        if fsdp_plugin is None:  # init from env variables
+            fsdp_plugin = (
+                FullyShardedDataParallelPlugin() if os.environ.get("ACCELERATE_USE_FSDP", "false") == "true" else None
+            )
+        else:
+            if not isinstance(fsdp_plugin, FullyShardedDataParallelPlugin):
+                raise TypeError("`fsdp_plugin` must be a FullyShardedDataParallelPlugin object.")
+            os.environ["ACCELERATE_USE_FSDP"] = "true"  # use FSDP if plugin is provided
+
+        if megatron_lm_plugin is None:  # init from env variables
+            megatron_lm_plugin = (
+                MegatronLMPlugin() if os.environ.get("ACCELERATE_USE_MEGATRON_LM", "false") == "true" else None
+            )
+        else:
+            if not isinstance(megatron_lm_plugin, MegatronLMPlugin):
+                raise TypeError("`megatron_lm_plugin` must be a MegatronLMPlugin object.")
+            os.environ["ACCELERATE_USE_MEGATRON_LM"] = "true"  # use MegatronLM if plugin is provided
+
+        if megatron_lm_plugin:
+            if not is_megatron_lm_available():
+                raise ImportError("Megatron is not installed. please build it from source.")
+
+        # Kwargs handlers
+        self.ddp_handler = None
+        self.scaler_handler = None
+        self.init_handler = None
+        self.fp8_recipe_handler = None
+        self.autocast_handler = None
+        if kwargs_handlers is not None:
+            for handler in kwargs_handlers:
+                assert isinstance(
+                    handler, KwargsHandler
+                ), f"Unsupported kwargs handler passed: {handler}, must be one that inherits `accelerate.utils.KwargsHandler`."
+                if isinstance(handler, DistributedDataParallelKwargs):
+                    if self.ddp_handler is not None:
+                        raise ValueError("You can only pass one `DistributedDataParallelKwargs` in `kwargs_handler`.")
+                    else:
+                        self.ddp_handler = handler
+                elif isinstance(handler, GradScalerKwargs):
+                    if self.scaler_handler is not None:
+                        raise ValueError("You can only pass one `GradScalerKwargs` in `kwargs_handler`.")
+                    else:
+                        self.scaler_handler = handler
+                elif isinstance(handler, InitProcessGroupKwargs):
+                    if self.init_handler is not None:
+                        raise ValueError("You can only pass one `InitProcessGroupKwargs` in `kwargs_handler`.")
+                    else:
+                        self.init_handler = handler
+                elif isinstance(handler, FP8RecipeKwargs):
+                    if self.fp8_recipe_handler is not None:
+                        raise ValueError("You can only pass one `FP8RecipeKwargs` in `kwargs_handler`.")
+                    else:
+                        self.fp8_recipe_handler = handler
+                elif isinstance(handler, AutocastKwargs):
+                    if self.autocast_handler is not None:
+                        raise ValueError("You can only pass one `AutocastKwargs` in `kwargs_handler`.")
+                    else:
+                        self.autocast_handler = handler
+
+        kwargs = self.init_handler.to_kwargs() if self.init_handler is not None else {}
+        self.state = AcceleratorState(
+            mixed_precision=mixed_precision,
+            cpu=cpu,
+            dynamo_plugin=dynamo_plugin,
+            deepspeed_plugin=deepspeed_plugin,
+            fsdp_plugin=fsdp_plugin,
+            megatron_lm_plugin=megatron_lm_plugin,
+            _from_accelerator=True,
+            **kwargs,
+        )
+
+        if self.fp8_recipe_handler is None and self.state.mixed_precision == "fp8":
+            self.fp8_recipe_handler = FP8RecipeKwargs(backend="MSAMP" if is_msamp_available() else "TE")
+
+        trackers = filter_trackers(log_with, self.logging_dir)
+        if len(trackers) < 1 and log_with is not None:
+            warnings.warn(f"`log_with={log_with}` was passed but no supported trackers are currently installed.")
+        self.log_with = trackers
+
+        if (
+            (mixed_precision != "bf16")
+            and getattr(self.state, "downcast_bfloat", False)
+            and (self.state.distributedType != DistributedType.XLA)
+        ):
+            raise ValueError("Can only use `downcast_bf16` when using `mixed_precision='bf16'` and on a TPU")
+
+        if gradient_accumulation_plugin is not None:
+            if gradient_accumulation_steps != 1:
+                raise ValueError(
+                    "You can only pass one of `gradient_accumulation_steps` and `gradient_accumulation_plugin`. Please only pass in the created `GradientAccumulationPlugin` object."
+                )
+        else:
+            gradient_accumulation_steps = int(
+                parse_choice_from_env("ACCELERATE_GRADIENT_ACCUMULATION_STEPS", gradient_accumulation_steps)
+            )
+            gradient_accumulation_plugin = GradientAccumulationPlugin(num_steps=gradient_accumulation_steps)
+        self.gradient_state = GradientState(
+            gradient_accumulation_plugin=gradient_accumulation_plugin,
+        )
+
+        self.device_placement = device_placement
+        if dataloader_config is None:
+            dataloader_config = DataLoaderConfiguration()
+        self.dataloader_config = dataloader_config
+        # Deal with deprecated args
+        # TODO: Remove in v1.0.0
+        deprecated_dl_args = {}
+        if dispatch_batches is not _dispatch_batches:
+            deprecated_dl_args["dispatch_batches"] = dispatch_batches
+            self.dataloader_config.dispatch_batches = dispatch_batches
+        if split_batches is not _split_batches:
+            deprecated_dl_args["split_batches"] = split_batches
+            self.dataloader_config.split_batches = split_batches
+        if even_batches is not _even_batches:
+            deprecated_dl_args["even_batches"] = even_batches
+            self.dataloader_config.even_batches = even_batches
+        if use_seedable_sampler is not _use_seedable_sampler:
+            deprecated_dl_args["use_seedable_sampler"] = use_seedable_sampler
+            self.dataloader_config.use_seedable_sampler = use_seedable_sampler
+        if len(deprecated_dl_args) > 0:
+            values = ", ".join([f"{k}={v}" for k, v in deprecated_dl_args.items()])
+            warnings.warn(
+                f"Passing the following arguments to `Accelerator` is deprecated and will be removed in version 1.0 of Accelerate: {deprecated_dl_args.keys()}. "
+                "Please pass an `accelerate.DataLoaderConfiguration` instead: \n"
+                f"dataloader_config = DataLoaderConfiguration({values})",
+                FutureWarning,
+            )
+        self.step_scheduler_with_optimizer = step_scheduler_with_optimizer
+
+        # Mixed precision attributes
+        self.scaler = None
+        self.native_amp = False
+        if (
+            self.state.mixed_precision == "fp16"
+            and self.device.type != "cpu"
+            and self.distributed_type not in (DistributedType.DEEPSPEED, DistributedType.MEGATRON_LM)
+        ):
+            self.native_amp = True
+            if self.device.type not in ("xpu", "cuda", "mps", "npu", "xla", "mlu") or is_torch_xla_available(
+                check_is_tpu=True
+            ):
+                raise ValueError(f"fp16 mixed precision requires a GPU (not {self.device.type!r}).")
+            kwargs = self.scaler_handler.to_kwargs() if self.scaler_handler is not None else {}
+            if self.distributed_type == DistributedType.FSDP:
+                from torch.distributed.fsdp.sharded_grad_scaler import ShardedGradScaler
+
+                self.scaler = ShardedGradScaler(**kwargs)
+            elif is_torch_xla_available(check_is_gpu=True):
+                self.scaler = xamp.GradScaler(**kwargs)
+            elif is_mlu_available():
+                self.scaler = torch.mlu.amp.GradScaler(**kwargs)
+            elif is_npu_available():
+                self.scaler = torch.npu.amp.GradScaler(**kwargs)
+            else:
+                self.scaler = torch.cuda.amp.GradScaler(**kwargs)
+
+        elif self.state.mixed_precision == "bf16" and self.distributed_type not in (
+            DistributedType.DEEPSPEED,
+            DistributedType.MEGATRON_LM,
+        ):
+            if self.device.type in ["cpu", "xpu"]:
+                self.native_amp = True
+            else:
+                self.native_amp = is_bf16_available(True)
+            if mixed_precision == "bf16" and not self.native_amp and not is_torch_xla_available():
+                raise ValueError("bf16 mixed precision requires PyTorch >= 1.10 and a supported device.")
+
+        # Start of internal step tracking
+        self.step = 0
+
+        # Internal references to the training objects
+        self._optimizers = []
+        self._models = []
+        self._schedulers = []
+        self._dataloaders = []
+        self._custom_objects = []
+
+        # Hooks
+        self._load_model_state_pre_hook = OrderedDict()
+        self._save_model_state_pre_hook = OrderedDict()
+
+        # RNG Types
+        self.rng_types = rng_types
+        if self.rng_types is None:
+            self.rng_types = ["generator"]
+
+        # Set a flag tensor for early stopping and other breakpoints
+        self.flag_tensor = None
+
+        check_os_kernel()
+
+    @property
+    def use_distributed(self):
+        """
+        Whether the Accelerator is configured for distributed training
+        """
+        return self.state.use_distributed
+
+    @property
+    def distributed_type(self):
+        return self.state.distributed_type
+
+    @property
+    def num_processes(self):
+        return self.state.num_processes
+
+    @property
+    def process_index(self):
+        return self.state.process_index
+
+    @property
+    def local_process_index(self):
+        return self.state.local_process_index
+
+    @property
+    def device(self):
+        return self.state.device
+
+    @property
+    def split_batches(self):
+        return self.dataloader_config.split_batches
+
+    @property
+    def dispatch_batches(self):
+        return self.dataloader_config.dispatch_batches
+
+    @property
+    def even_batches(self):
+        return self.dataloader_config.even_batches
+
+    @even_batches.setter
+    def even_batches(self, value: bool):
+        self.dataloader_config.even_batches = value
+
+    @property
+    def use_seedable_sampler(self):
+        return self.dataloader_config.use_seedable_sampler
+
+    @property
+    def project_dir(self):
+        return self.project_configuration.project_dir
+
+    @property
+    def logging_dir(self):
+        return self.project_configuration.logging_dir
+
+    @property
+    def save_iteration(self):
+        return self.project_configuration.iteration
+
+    @property
+    def is_main_process(self):
+        """True for one process only."""
+        return self.state.is_main_process
+
+    @property
+    def is_local_main_process(self):
+        """True for one process per server."""
+        return self.state.is_local_main_process
+
+    @property
+    def use_fp16(self):
+        warnings.warn(
+            "The `use_fp16` property is deprecated and will be removed in version 1.0 of Accelerate use "
+            "`Accelerator.mixed_precision == 'fp16'` instead.",
+            FutureWarning,
+        )
+        return self.mixed_precision != "no"
+
+    @property
+    def is_last_process(self):
+        return self.process_index == self.num_processes - 1
+
+    @property
+    def mixed_precision(self):
+        return self.state.mixed_precision
+
+    @contextmanager
+    def split_between_processes(self, inputs: list | tuple | dict | torch.Tensor, apply_padding: bool = False):
+        """
+        Splits `input` between `self.num_processes` quickly and can be then used on that process. Useful when doing
+        distributed inference, such as with different prompts.
+
+        Note that when using a `dict`, all keys need to have the same number of elements.
+
+        Args:
+            inputs (`list`, `tuple`, `torch.Tensor`, or `dict` of `list`/`tuple`/`torch.Tensor`):
+                The input to split between processes.
+            apply_padding (`bool`, `optional`, defaults to `False`):
+                Whether to apply padding by repeating the last element of the input so that all processes have the same
+                number of elements. Useful when trying to perform actions such as `Accelerator.gather()` on the outputs
+                or passing in less inputs than there are processes. If so, just remember to drop the padded elements
+                afterwards.
+
+        Example:
+
+        ```python
+        # Assume there are two processes
+        from accelerate import Accelerator
+
+        accelerator = Accelerator()
+        with accelerator.split_between_processes(["A", "B", "C"]) as inputs:
+            print(inputs)
+        # Process 0
+        ["A", "B"]
+        # Process 1
+        ["C"]
+
+        with accelerator.split_between_processes(["A", "B", "C"], apply_padding=True) as inputs:
+            print(inputs)
+        # Process 0
+        ["A", "B"]
+        # Process 1
+        ["C", "C"]
+        ```
+        """
+        with PartialState().split_between_processes(inputs, apply_padding=apply_padding) as inputs:
+            yield inputs
+
+    def on_main_process(self, function: Callable[..., Any] = None):
+        """
+        A decorator that will run the decorated function on the main process only. Can also be called using the
+        `PartialState` class.
+
+        Args:
+            function (`Callable`): The function to decorate.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+
+
+        >>> @accelerator.on_main_process
+        ... def print_something():
+        ...     print("This will be printed by process 0 only.")
+
+
+        >>> print_something()
+        "This will be printed by process 0 only"
+        ```
+        """
+        # For times when the `Accelerator` object itself utilizes this decorator.
+        if function is None:
+            if "Accelerator." in self.__qualname__:
+                function = self
+            else:
+                raise ValueError(
+                    "The `on_main_process` decorator must be called with a function on an instantiated `Accelerator` object."
+                )
+
+        def _inner(*args, **kwargs):
+            return PartialState().on_main_process(function)(*args, **kwargs)
+
+        return _inner
+
+    def on_local_main_process(self, function: Callable[..., Any] = None):
+        """
+        A decorator that will run the decorated function on the local main process only. Can also be called using the
+        `PartialState` class.
+
+        Args:
+            function (`Callable`): The function to decorate.
+
+        Example:
+        ```python
+        # Assume we have 2 servers with 4 processes each.
+        from accelerate import Accelerator
+
+        accelerator = Accelerator()
+
+
+        @accelerator.on_local_main_process
+        def print_something():
+            print("This will be printed by process 0 only on each server.")
+
+
+        print_something()
+        # On server 1:
+        "This will be printed by process 0 only"
+        # On server 2:
+        "This will be printed by process 0 only"
+        ```
+        """
+        # For times when the `Accelerator` object itself utilizes this decorator.
+        if function is None:
+            if "Accelerator." in self.__qualname__:
+                function = self
+            else:
+                raise ValueError(
+                    "The `on_local_main_process` decorator must be called with a function on an instantiated `Accelerator` object."
+                )
+
+        def _inner(*args, **kwargs):
+            return PartialState().on_local_main_process(function)(*args, **kwargs)
+
+        return _inner
+
+    def on_last_process(self, function: Callable[..., Any]):
+        """
+        A decorator that will run the decorated function on the last process only. Can also be called using the
+        `PartialState` class.
+
+        Args:
+            function (`Callable`): The function to decorate.
+
+        Example:
+        ```python
+        # Assume we have 4 processes.
+        from accelerate import Accelerator
+
+        accelerator = Accelerator()
+
+
+        @accelerator.on_last_process
+        def print_something():
+            print(f"Printed on process {accelerator.process_index}")
+
+
+        print_something()
+        "Printed on process 3"
+        ```
+        """
+        # For times when the `Accelerator` object itself utilizes this decorator.
+        if function is None:
+            if "Accelerator." in self.__qualname__:
+                function = self
+            else:
+                raise ValueError(
+                    "The `on_last_process` decorator must be called with a function on an instantiated `Accelerator` object."
+                )
+
+        def _inner(*args, **kwargs):
+            return PartialState().on_last_process(function)(*args, **kwargs)
+
+        return _inner
+
+    def on_process(self, function: Callable[..., Any] = None, process_index: int = None):
+        """
+        A decorator that will run the decorated function on a given process index only. Can also be called using the
+        `PartialState` class.
+
+        Args:
+            function (`Callable`, `optional`):
+                The function to decorate.
+            process_index (`int`, `optional`):
+                The index of the process on which to run the function.
+
+        Example:
+        ```python
+        # Assume we have 4 processes.
+        from accelerate import Accelerator
+
+        accelerator = Accelerator()
+
+
+        @accelerator.on_process(process_index=2)
+        def print_something():
+            print(f"Printed on process {accelerator.process_index}")
+
+
+        print_something()
+        "Printed on process 2"
+        ```
+        """
+        # Initial construction of the decorator.
+        if (self is not None) and (process_index is not None) and (function is None):
+            return partial(self.on_process, process_index=process_index)
+        # For times when the `Accelerator` object itself utilizes this decorator.
+        if function is None:
+            if "Accelerator." in self.__qualname__:
+                function = self
+            else:
+                raise ValueError(
+                    "The `on_main_process` decorator must be called with a function on an instantiated `Accelerator` object."
+                )
+
+        def _inner(*args, **kwargs):
+            return PartialState().on_process(function, process_index)(*args, **kwargs)
+
+        return _inner
+
+    def on_local_process(self, function: Callable[..., Any] = None, local_process_index: int = None):
+        """
+        A decorator that will run the decorated function on a given local process index only. Can also be called using
+        the `PartialState` class.
+
+        Args:
+            function (`Callable`, *optional*):
+                The function to decorate.
+            local_process_index (`int`, *optional*):
+                The index of the local process on which to run the function.
+
+        Example:
+        ```python
+        # Assume we have 2 servers with 4 processes each.
+        from accelerate import Accelerator
+
+        accelerator = Accelerator()
+
+
+        @accelerator.on_local_process(local_process_index=2)
+        def print_something():
+            print(f"Printed on process {accelerator.local_process_index}")
+
+
+        print_something()
+        # On server 1:
+        "Printed on process 2"
+        # On server 2:
+        "Printed on process 2"
+        ```
+        """
+        # Initial construction of the decorator.
+        if (self is not None) and (local_process_index is not None) and (function is None):
+            return partial(self.on_local_process, local_process_index=local_process_index)
+        # For times when the `Accelerator` object itself utilizes this decorator.
+        if function is None:
+            if "Accelerator." in self.__qualname__:
+                function = self
+            else:
+                raise ValueError(
+                    "The `on_main_process` decorator must be called with a function on an instantiated `Accelerator` object."
+                )
+
+        def _inner(*args, **kwargs):
+            return PartialState().on_local_process(function, local_process_index)(*args, **kwargs)
+
+        return _inner
+
+    @contextmanager
+    def main_process_first(self):
+        """
+        Lets the main process go first inside a with block.
+
+        The other processes will enter the with block after the main process exits.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> with accelerator.main_process_first():
+        ...     # This will be printed first by process 0 then in a seemingly
+        ...     # random order by the other processes.
+        ...     print(f"This will be printed by process {accelerator.process_index}")
+        ```
+        """
+        with self.state.main_process_first():
+            yield
+
+    @contextmanager
+    def local_main_process_first(self):
+        """
+        Lets the local main process go inside a with block.
+
+        The other processes will enter the with block after the main process exits.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> with accelerator.local_main_process_first():
+        ...     # This will be printed first by local process 0 then in a seemingly
+        ...     # random order by the other processes.
+        ...     print(f"This will be printed by process {accelerator.local_process_index}")
+        ```
+        """
+        with self.state.local_main_process_first():
+            yield
+
+    @contextmanager
+    def no_sync(self, model):
+        """
+        A context manager to disable gradient synchronizations across DDP processes by calling
+        `torch.nn.parallel.DistributedDataParallel.no_sync`.
+
+        If `model` is not in DDP, this context manager does nothing
+
+        Args:
+            model (`torch.nn.Module`):
+                PyTorch Module that was prepared with `Accelerator.prepare`
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> dataloader, model, optimizer = accelerator.prepare(dataloader, model, optimizer)
+        >>> input_a = next(iter(dataloader))
+        >>> input_b = next(iter(dataloader))
+
+        >>> with accelerator.no_sync():
+        ...     outputs = model(input_a)
+        ...     loss = loss_func(outputs)
+        ...     accelerator.backward(loss)
+        ...     # No synchronization across processes, only accumulate gradients
+        >>> outputs = model(input_b)
+        >>> accelerator.backward(loss)
+        >>> # Synchronization across all processes
+        >>> optimizer.step()
+        >>> optimizer.zero_grad()
+        ```
+        """
+        context = contextlib.nullcontext
+        if self.use_distributed:
+            context = getattr(model, "no_sync", context)
+
+        with context():
+            yield
+
+    @staticmethod
+    @contextmanager
+    def trigger_sync_in_backward(model):
+        """Trigger the sync of the gradients in the next backward pass of the model after multiple forward passes under
+        `Accelerator.no_sync` (only applicable in multi-GPU scenarios).
+
+                If the script is not launched in distributed mode, this context manager does nothing.
+
+                Args:
+                    model (`torch.nn.Module`):
+                        The model for which to trigger the gradient synchronization.
+
+                Example:
+
+                ```python
+                >>> from accelerate import Accelerator
+
+                >>> accelerator = Accelerator()
+                >>> dataloader, model, optimizer = accelerator.prepare(dataloader, model, optimizer)
+
+                >>> with accelerator.no_sync():
+                ...     loss_a = loss_func(model(input_a))  # first forward pass
+                ...     loss_b = loss_func(model(input_b))  # second forward pass
+                >>> accelerator.backward(loss_a)  # No synchronization across processes, only accumulate gradients
+                >>> with accelerator.trigger_sync_in_backward(model):
+                ...     accelerator.backward(loss_b)  # Synchronization across all processes
+                >>> optimizer.step()
+                >>> optimizer.zero_grad()
+                ```
+        """
+        if not isinstance(model, torch.nn.parallel.DistributedDataParallel):
+            yield
+            return
+
+        old_require_backward_grad_sync = model.require_backward_grad_sync
+        old_require_forward_param_sync = model.require_forward_param_sync
+
+        # EXPERIMENTAL: This will force grad sync during `backward()`, but it is unknown if it breaks other DDP features.
+        # https://github.com/pytorch/pytorch/blob/e1502c0cdbfd17548c612f25d5a65b1e4b86224d/torch/nn/parallel/distributed.py#L1453-L1466
+        model.require_backward_grad_sync = True
+        model.require_forward_param_sync = True
+        # https://github.com/pytorch/pytorch/blob/e1502c0cdbfd17548c612f25d5a65b1e4b86224d/torch/csrc/distributed/c10d/reducer.cpp#L1371-L1402
+        model.reducer.prepare_for_backward([])
+        try:
+            yield
+        finally:
+            model.require_backward_grad_sync = old_require_backward_grad_sync
+            model.require_forward_param_sync = old_require_forward_param_sync
+
+    def _do_sync(self, force: bool = False):
+        "Sets the right `sync_gradients` context and either resets or increases `self.step`"
+        if self.gradient_state.sync_with_dataloader and self.gradient_state.end_of_dataloader:
+            self.step = 0
+            self.gradient_state._set_sync_gradients(True)
+        else:
+            self.step += 1
+            self.gradient_state._set_sync_gradients(force or ((self.step % self.gradient_state.num_steps) == 0))
+
+    @property
+    def sync_gradients(self):
+        return self.gradient_state.sync_gradients
+
+    @sync_gradients.setter
+    def sync_gradients(self, sync_gradients):
+        self.gradient_state.sync_gradients = sync_gradients
+
+    @property
+    def gradient_accumulation_steps(self):
+        return self.gradient_state.num_steps
+
+    @gradient_accumulation_steps.setter
+    def gradient_accumulation_steps(self, gradient_accumulation_steps):
+        self.gradient_state.plugin_kwargs.update({"num_steps": gradient_accumulation_steps})
+
+    @contextmanager
+    def accumulate(self, *models):
+        """
+        A context manager that will lightly wrap around and perform gradient accumulation automatically
+
+        Args:
+            *models (list of `torch.nn.Module`):
+                PyTorch Modules that were prepared with `Accelerator.prepare`. Models passed to `accumulate()` will
+                skip gradient syncing during backward pass in distributed training
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator(gradient_accumulation_steps=1)
+        >>> dataloader, model, optimizer, scheduler = accelerator.prepare(dataloader, model, optimizer, scheduler)
+
+        >>> for input, output in dataloader:
+        ...     with accelerator.accumulate(model):
+        ...         outputs = model(input)
+        ...         loss = loss_func(outputs)
+        ...         loss.backward()
+        ...         optimizer.step()
+        ...         scheduler.step()
+        ...         optimizer.zero_grad()
+        ```
+        """
+        # sync_each_batch=True will guarantee below that self.sync_gradients=True, therefore
+        # resulting in the nullcontext always being selected.
+        self._do_sync(force=self.gradient_state.plugin_kwargs.get("sync_each_batch", False))
+        with contextlib.ExitStack() as cm_stack:
+            for m in models:
+                cm_stack.enter_context(contextlib.nullcontext() if self.sync_gradients else self.no_sync(m))
+            yield
+
+    @contextmanager
+    def join_uneven_inputs(self, joinables, even_batches=None):
+        """
+        A context manager that facilitates distributed training or evaluation on uneven inputs, which acts as a wrapper
+        around `torch.distributed.algorithms.join`. This is useful when the total batch size does not evenly divide the
+        length of the dataset.
+
+        Args:
+            joinables (`list[torch.distributed.algorithms.Joinable]`):
+                A list of models or optimizers that subclass `torch.distributed.algorithms.Joinable`. Most commonly, a
+                PyTorch Module that was prepared with `Accelerator.prepare` for DistributedDataParallel training.
+            even_batches (`bool`, *optional*)
+                If set, this will override the value of `even_batches` set in the `Accelerator`. If it is not provided,
+                the default `Accelerator` value wil be used.
+
+        <Tip warning={true}>
+
+        `join_uneven_inputs` is only supported for Distributed Data Parallel training on multiple GPUs. For any other
+        configuration, this method will have no effect.
+
+        </Tip>
+
+        <Tip warning={true}>
+
+        Overidding `even_batches` will not affect iterable-style data loaders.
+
+        </Tip>
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator(even_batches=True)
+        >>> ddp_model, optimizer, dataloader = accelerator.prepare(model, optimizer, dataloader)
+
+        >>> with accelerator.join_uneven_inputs([ddp_model], even_batches=False):
+        ...     for input, output in dataloader:
+        ...         outputs = model(input)
+        ...         loss = loss_func(outputs)
+        ...         loss.backward()
+        ...         optimizer.step()
+        ...         optimizer.zero_grad()
+        ```
+        """
+        if self.distributed_type in (
+            DistributedType.MULTI_GPU,
+            DistributedType.MULTI_NPU,
+            DistributedType.MULTI_MLU,
+            DistributedType.MULTI_XPU,
+        ):
+            dl_even_batches_values = []
+
+            if even_batches is not None:
+                iterable_dl_seen = False
+                # override value in batch sampler for map-style datasets
+                for dl_idx, dl in enumerate(self._dataloaders):
+                    if isinstance(dl, DataLoaderDispatcher):
+                        iterable_dl_seen = True
+                        continue
+                    dl_even_batches_values.append((dl_idx, dl.batch_sampler.even_batches))
+                    dl.batch_sampler.even_batches = even_batches
+
+                if iterable_dl_seen:
+                    warnings.warn(
+                        "Overridding even_batches is only supported for map-style datasets, yet some dataloaders given were iterable"
+                    )
+            else:
+                even_batches = self.even_batches
+
+            enable_join = False if even_batches else True
+            try:
+                with Join(joinables, enable=enable_join, throw_on_early_termination=False):
+                    yield
+            finally:
+                # reset any batch samplers that have been modified
+                for dl_idx, even_batches_value in dl_even_batches_values:
+                    self._dataloaders[dl_idx].batch_sampler.even_batches = even_batches_value
+        else:
+            # Even when disabled, Join expects models to subclass Joinable, so skip entirely for single process runs
+            if self.distributed_type != DistributedType.NO:
+                warnings.warn(
+                    "Joining uneven inputs is only supported for multi-GPU training, as a result `join_uneven_inputs` will have no effect."
+                )
+
+            with contextlib.nullcontext(joinables):
+                yield
+
+    def print(self, *args, **kwargs):
+        """
+        Drop in replacement of `print()` to only print once per server.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> accelerator.print("Hello world!")
+        ```
+        """
+        self.state.print(*args, **kwargs)
+
+    def _prepare_one(self, obj, first_pass=False, device_placement=None):
+        # First pass of preparation: DataLoader, model, optimizer
+        if first_pass:
+            if isinstance(obj, torch.utils.data.DataLoader):
+                return self.prepare_data_loader(obj, device_placement=device_placement)
+            elif isinstance(obj, torch.nn.Module):
+                return self.prepare_model(obj, device_placement=device_placement)
+            elif isinstance(obj, torch.optim.Optimizer):
+                optimizer = self.prepare_optimizer(obj, device_placement=device_placement)
+                return optimizer
+        # Second pass of preparation: LR scheduler (which need the full list of optimizers)
+        elif isinstance(obj, LRScheduler):
+            scheduler = self.prepare_scheduler(obj)
+            return scheduler
+        # Return the unprocessed object if previous criteria was not met
+        return obj
+
+    def prepare(self, *args, device_placement=None):
+        """
+        Prepare all objects passed in `args` for distributed training and mixed precision, then return them in the same
+        order.
+
+        Args:
+            *args (list of objects):
+                Any of the following type of objects:
+
+                - `torch.utils.data.DataLoader`: PyTorch Dataloader
+                - `torch.nn.Module`: PyTorch Module
+                - `torch.optim.Optimizer`: PyTorch Optimizer
+                - `torch.optim.lr_scheduler.LRScheduler`: PyTorch LR Scheduler
+
+            device_placement (`list[bool]`, *optional*):
+                Used to customize whether automatic device placement should be performed for each object passed. Needs
+                to be a list of the same length as `args`. Not compatible with DeepSpeed or FSDP.
+
+        <Tip>
+
+          You don't need to prepare a model if you only use it for inference without any kind of mixed precision
+
+        </Tip>
+
+        Examples:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> # Assume a model, optimizer, data_loader and scheduler are defined
+        >>> model, optimizer, data_loader, scheduler = accelerator.prepare(model, optimizer, data_loader, scheduler)
+        ```
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> # Assume a model, optimizer, data_loader and scheduler are defined
+        >>> device_placement = [True, True, False, False]
+        >>> # Will place the first to items passed in automatically to the right device but not the last two.
+        >>> model, optimizer, data_loader, scheduler = accelerator.prepare(
+        ...     model, optimizer, data_loader, scheduler, device_placement=device_placement
+        ... )
+        ```
+        """
+        if device_placement is None:
+            device_placement = [None for _ in args]
+        elif self.distributed_type in (DistributedType.DEEPSPEED, DistributedType.MEGATRON_LM):
+            raise ValueError("You can't customize device placements with DeepSpeed or Megatron-LM.")
+        elif len(device_placement) != len(args):
+            raise ValueError(
+                f"`device_placement` should be a list with {len(args)} elements (the number of objects passed)."
+            )
+
+        for obj in args:
+            # TODO: Look at enabling native TP training directly with a proper config
+            if (
+                isinstance(obj, torch.nn.Module)
+                and self.verify_device_map(obj)
+                and self.distributed_type != DistributedType.NO
+                and os.environ.get("ACCELERATE_BYPASS_DEVICE_MAP", "false") != "true"
+            ):
+                raise ValueError(
+                    "You can't train a model that has been loaded with `device_map='auto'` in any distributed mode."
+                    " Please rerun your script specifying `--num_processes=1` or by launching with `python {{myscript.py}}`."
+                )
+
+        if self.distributed_type == DistributedType.DEEPSPEED:
+            model_count = 0
+            for obj in args:
+                if isinstance(obj, torch.nn.Module):
+                    model_count += 1
+            if model_count > 1:
+                raise AssertionError(
+                    "You can't use same `Accelerator()` instance with multiple models when using DeepSpeed"
+                )
+
+        # On TPUs, putting the model on the XLA device will create new parameters, so the corresponding optimizer will
+        # have parameters disconnected from the model (so no training :-( ).
+        # If the model and optimizer have parameters on different devices we raise an error.
+        if self.distributed_type == DistributedType.XLA:
+            model_device, optimizer_device = self._get_devices()
+            if model_device is not None and optimizer_device is not None and model_device != optimizer_device:
+                raise ValueError(
+                    "The model and the optimizer parameters are not on the same device, which probably means you "
+                    "created an optimizer around your model **before** putting on the device. Make sure the line "
+                    "model.to(device) is before the optimizer creation in your script or remove it entirely and use "
+                    "the flag default value for `device_placement` in your `Accelerator` to let it handle that "
+                    "part for you."
+                )
+
+        # If we're dealing with device placement, this deals with that by...
+        tpu_should_fix_optimizer = self.device_placement and self.distributed_type == DistributedType.XLA
+        if tpu_should_fix_optimizer or (self.mixed_precision == "fp8" and self.fp8_recipe_handler.backend == "TE"):
+            # 1. grabbing old model parameters
+            old_named_params = self._get_named_parameters(*args)
+
+        if self.distributed_type in [DistributedType.MULTI_CPU, DistributedType.MULTI_XPU, DistributedType.NO]:
+            if self.device.type == "cpu" and self.state.use_ipex:
+                args = self._prepare_ipex(*args)
+            elif self.device.type == "xpu" and is_xpu_available():
+                args = self._prepare_ipex(*args)
+        if self.distributed_type == DistributedType.DEEPSPEED:
+            result = self._prepare_deepspeed(*args)
+        elif self.distributed_type == DistributedType.MEGATRON_LM:
+            result = self._prepare_megatron_lm(*args)
+        else:
+            if self.mixed_precision == "fp8" and self.fp8_recipe_handler.backend == "MSAMP":
+                args = self._prepare_msamp(*args)
+                # MS-AMP will handle the device placement
+                device_placement = [False for _ in args]
+            result = tuple(
+                self._prepare_one(obj, first_pass=True, device_placement=d) for obj, d in zip(args, device_placement)
+            )
+            result = tuple(self._prepare_one(obj, device_placement=d) for obj, d in zip(result, device_placement))
+
+        if tpu_should_fix_optimizer or (self.mixed_precision == "fp8" and self.fp8_recipe_handler.backend == "TE"):
+            # 2. grabbing new model parameters
+            new_named_params = self._get_named_parameters(*result)
+            # 3. building a map from the first to the second
+            mapping = {p: new_named_params[n] for n, p in old_named_params.items()}
+            # 4. using that map to update the parameters of the optimizer
+            for obj in result:
+                if isinstance(obj, torch.optim.Optimizer):
+                    obj._switch_parameters(mapping)
+
+        for item in result:
+            if any(
+                item in container
+                for container in (self._dataloaders, self._models, self._optimizers, self._schedulers)
+            ):
+                item._is_accelerate_prepared = True
+
+        return result if len(result) > 1 else result[0]
+
+    def prepare_model(self, model: torch.nn.Module, device_placement: bool = None, evaluation_mode: bool = False):
+        """
+        Prepares a PyTorch model for training in any distributed setup. It is recommended to use
+        [`Accelerator.prepare`] instead.
+
+        Args:
+            model (`torch.nn.Module`):
+                A PyTorch model to prepare. You don't need to prepare a model if it is used only for inference without
+                any kind of mixed precision
+            device_placement (`bool`, *optional*):
+                Whether or not to place the model on the proper device. Will default to `self.device_placement`.
+            evaluation_mode (`bool`, *optional*, defaults to `False`):
+                Whether or not to set the model for evaluation only, by just applying mixed precision and
+                `torch.compile` (if configured in the `Accelerator` object).
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> # Assume a model is defined
+        >>> model = accelerator.prepare_model(model)
+        ```
+        """
+        if device_placement is None:
+            device_placement = self.device_placement and self.distributed_type != DistributedType.FSDP
+        self._models.append(model)
+
+        # TODO: Look at enabling native TP training directly with a proper config
+        if (
+            self.verify_device_map(model)
+            and self.distributed_type != DistributedType.NO
+            and os.environ.get("ACCELERATE_BYPASS_DEVICE_MAP", "false") != "true"
+        ):
+            raise ValueError(
+                "You can't train a model that has been loaded with `device_map='auto'` in any distributed mode."
+                " Please rerun your script specifying `--num_processes=1` or by launching with `python {{myscript.py}}`."
+            )
+
+        if self.native_amp:
+            model._original_forward = model.forward
+            model_forward_func = model.forward.__func__ if hasattr(model.forward, "__func__") else model.forward
+            autocast_context = get_mixed_precision_context_manager(self.native_amp, self.autocast_handler)
+            new_forward = autocast_context(model_forward_func)
+            if hasattr(model.forward, "__func__"):
+                model.forward = MethodType(new_forward, model)
+                model.forward = MethodType(convert_outputs_to_fp32(model.forward.__func__), model)
+            else:
+                model.forward = convert_outputs_to_fp32(new_forward)
+        elif self.mixed_precision == "fp8" and self.fp8_recipe_handler.backend == "TE":
+            if not has_transformer_engine_layers(model):
+                with torch.no_grad():
+                    convert_model(model)
+                model._converted_to_transformer_engine = True
+            model._original_forward = model.forward
+
+            kwargs = self.fp8_recipe_handler.to_kwargs() if self.fp8_recipe_handler is not None else {}
+            if "fp8_format" in kwargs:
+                kwargs["fp8_format"] = getattr(te_recipe.Format, kwargs["fp8_format"])
+            fp8_recipe = te_recipe.DelayedScaling(**kwargs)
+            model.forward = fp8_autocast(enabled=True, fp8_recipe=fp8_recipe)(model.forward)
+
+        if (getattr(model, "is_loaded_in_8bit", False) or getattr(model, "is_loaded_in_4bit", False)) and getattr(
+            model, "hf_device_map", False
+        ):
+            model_devices = set(model.hf_device_map.values())
+            if len(model_devices) > 1 and self.distributed_type != DistributedType.NO:
+                raise ValueError(
+                    "You can't train a model that has been loaded in 8-bit precision on multiple devices in any distributed mode."
+                    " In order to use 8-bit models that have been loaded across multiple GPUs the solution is to use Naive Pipeline Parallelism."
+                    " Therefore you should not specify that you are under any distributed regime in your accelerate config."
+                )
+            current_device = list(model_devices)[0]
+            current_device_index = current_device.index if isinstance(current_device, torch.device) else current_device
+
+            if torch.device(current_device_index) != self.device:
+                # if on the first device (GPU 0) we don't care
+                if (self.device.index is not None) or (current_device_index != 0):
+                    raise ValueError(
+                        "You can't train a model that has been loaded in 8-bit precision on a different device than the one "
+                        "you're training on. Make sure you loaded the model on the correct device using for example `device_map={'':torch.cuda.current_device() or device_map={'':torch.xpu.current_device()}"
+                    )
+
+            if "cpu" in model_devices or "disk" in model_devices:
+                raise ValueError(
+                    "You can't train a model that has been loaded in 8-bit precision with CPU or disk offload."
+                )
+        elif device_placement and not self.verify_device_map(model):
+            model = model.to(self.device)
+        if not evaluation_mode:
+            if self.distributed_type in (
+                DistributedType.MULTI_GPU,
+                DistributedType.MULTI_MLU,
+                DistributedType.MULTI_NPU,
+                DistributedType.MULTI_XPU,
+            ):
+                if any(p.requires_grad for p in model.parameters()):
+                    kwargs = self.ddp_handler.to_kwargs() if self.ddp_handler is not None else {}
+                    # TODO: Look at enabling native TP training directly with a proper config
+                    if os.environ.get("ACCELERATE_BYPASS_DEVICE_MAP", "false") != "true":
+                        device_ids, output_device = [self.local_process_index], self.local_process_index
+                    else:
+                        device_ids, output_device = None, None
+
+                    model = torch.nn.parallel.DistributedDataParallel(
+                        model, device_ids=device_ids, output_device=output_device, **kwargs
+                    )
+            elif self.distributed_type == DistributedType.FSDP:
+                from torch.distributed.fsdp.fully_sharded_data_parallel import FullyShardedDataParallel as FSDP
+
+                # Check if the model is already a FSDP model due to `Manual Wrapping` and if so,
+                # don't wrap it again
+                # In case the model is already compiled using PyTorch 2.0 and the wrapped model in it
+                # is a FSDP model, don't wrap it again
+                is_type_fsdp = isinstance(model, FSDP) or (
+                    is_compiled_module(model) and isinstance(model._orig_mod, FSDP)
+                )
+
+                if not is_type_fsdp:
+                    self.state.fsdp_plugin.set_auto_wrap_policy(model)
+                    fsdp_plugin = self.state.fsdp_plugin
+                    kwargs = {
+                        "sharding_strategy": fsdp_plugin.sharding_strategy,
+                        "cpu_offload": fsdp_plugin.cpu_offload,
+                        "auto_wrap_policy": fsdp_plugin.auto_wrap_policy,
+                        "mixed_precision": fsdp_plugin.mixed_precision_policy,
+                        "sync_module_states": fsdp_plugin.sync_module_states,
+                        "backward_prefetch": fsdp_plugin.backward_prefetch,
+                        "forward_prefetch": fsdp_plugin.forward_prefetch,
+                        "use_orig_params": fsdp_plugin.use_orig_params,
+                        "param_init_fn": fsdp_plugin.param_init_fn,
+                        "ignored_modules": fsdp_plugin.ignored_modules,
+                        "limit_all_gathers": fsdp_plugin.limit_all_gathers,
+                        "device_id": self.device,
+                    }
+                    model = FSDP(model, **kwargs)
+                    if fsdp_plugin.activation_checkpointing:
+                        from torch.distributed.algorithms._checkpoint.checkpoint_wrapper import (
+                            CheckpointImpl,
+                            apply_activation_checkpointing,
+                            checkpoint_wrapper,
+                        )
+
+                        apply_activation_checkpointing(
+                            model,
+                            checkpoint_wrapper_fn=functools.partial(
+                                checkpoint_wrapper,
+                                checkpoint_impl=CheckpointImpl.NO_REENTRANT,
+                            ),
+                            auto_wrap_policy=fsdp_plugin.auto_wrap_policy,
+                        )
+                # if the previous and current models are same, delete the previous one
+                if len(self._models) > 1 and (self._models[-2] is self._models[-1]):
+                    del self._models[-2]
+                self._models[-1] = model
+            elif self.distributed_type == DistributedType.MULTI_CPU:
+                kwargs = self.ddp_handler.to_kwargs() if self.ddp_handler is not None else {}
+                model = torch.nn.parallel.DistributedDataParallel(model, **kwargs)
+            elif self.distributed_type == DistributedType.XLA and self.state.fork_launched:
+                model = xmp.MpModelWrapper(model).to(self.device)
+        # torch.compile should be called last and only if the model isn't already compiled.
+        if self.state.dynamo_plugin.backend != DynamoBackend.NO and not is_compiled_module(model):
+            if not is_torch_version(">=", "2.0"):
+                raise ValueError("Using `torch.compile` requires PyTorch 2.0 or higher.")
+            model = torch.compile(model, **self.state.dynamo_plugin.to_kwargs())
+        return model
+
+    def _prepare_deepspeed(self, *args):
+        import deepspeed
+
+        deepspeed_plugin = self.state.deepspeed_plugin
+
+        is_dataloader_present = any(isinstance(obj, torch.utils.data.DataLoader) for obj in args)
+        result = [
+            self._prepare_one(obj, first_pass=True) if isinstance(obj, torch.utils.data.DataLoader) else obj
+            for obj in args
+        ]
+
+        if deepspeed_plugin.is_auto("train_micro_batch_size_per_gpu"):
+            if is_dataloader_present:
+                batch_sizes = [obj.batch_size for obj in args if hasattr(obj, "batch_size")]
+                if any(bs is None for bs in batch_sizes):
+                    raise ValueError(
+                        "At least one of the dataloaders passed to `accelerate.prepare()` has `None` as batch size. "
+                        "Please set an integer value in `train_micro_batch_size_per_gpu` in the deepspeed config file "
+                        "or assign integer value to `AcceleratorState().deepspeed_plugin.deepspeed_config['train_micro_batch_size_per_gpu']`."
+                    )
+                if self.split_batches:
+                    batch_sizes = [batch_size // self.num_processes for batch_size in batch_sizes]
+
+                batch_size_per_device = min(batch_sizes) if deepspeed_plugin.is_train_batch_min else max(batch_sizes)
+                if len(batch_sizes) > 1:
+                    logger.info(
+                        "Since you passed both train and evaluation dataloader, `is_train_batch_min` (here "
+                        f"{deepspeed_plugin.is_train_batch_min} will decide the `train_batch_size` ({batch_size_per_device})."
+                    )
+            else:
+                raise ValueError(
+                    "When using DeepSpeed, `accelerate.prepare()` requires you to pass at least one of training or evaluation dataloaders "
+                    "with `batch_size` attribute returning an integer value "
+                    "or alternatively set an integer value in `train_micro_batch_size_per_gpu` in the deepspeed config file "
+                    "or assign integer value to `AcceleratorState().deepspeed_plugin.deepspeed_config['train_micro_batch_size_per_gpu']`."
+                )
+        else:
+            batch_size_per_device = deepspeed_plugin.get_value("train_micro_batch_size_per_gpu")
+
+        # handle `gradient_accumulation_steps` when the value is `auto`
+        deepspeed_plugin.fill_match(
+            "gradient_accumulation_steps",
+            must_match=False,
+            gradient_accumulation_steps=self.gradient_accumulation_steps,
+        )
+
+        config_kwargs = {
+            "train_micro_batch_size_per_gpu": batch_size_per_device,
+            "train_batch_size": batch_size_per_device
+            * deepspeed_plugin.get_value("gradient_accumulation_steps")
+            * self.num_processes,
+            "gradient_clipping": 1.0,
+            "zero_optimization.stage3_gather_16bit_weights_on_model_save": False,
+        }
+
+        model = None
+        optimizer = None
+        scheduler = None
+        for obj in result:
+            if isinstance(obj, torch.nn.Module):
+                model = obj
+            elif isinstance(obj, (torch.optim.Optimizer, DummyOptim)):
+                optimizer = obj
+            elif (isinstance(obj, (LRScheduler, DummyScheduler))) or (
+                type(obj).__name__ in deepspeed.runtime.lr_schedules.VALID_LR_SCHEDULES
+            ):
+                scheduler = obj
+
+        if optimizer is not None:
+            if "optimizer" in deepspeed_plugin.deepspeed_config and not isinstance(optimizer, (DummyOptim)):
+                raise ValueError(
+                    "You cannot specify an optimizer in the config file and in the code at the same time. "
+                    "Please remove the optimizer from the config file or "
+                    "create `accelerate.utils.DummyOptim` in the code."
+                )
+            elif "optimizer" not in deepspeed_plugin.deepspeed_config and isinstance(optimizer, (DummyOptim)):
+                raise ValueError(
+                    "You cannot create a `DummyOptim` without specifying an optimizer in the config file."
+                )
+
+            if isinstance(optimizer, (torch.optim.Optimizer)):
+                deepspeed_plugin.deepspeed_config["zero_allow_untested_optimizer"] = True
+
+        if scheduler is not None:
+            if "scheduler" in deepspeed_plugin.deepspeed_config and not isinstance(scheduler, (DummyScheduler)):
+                raise ValueError(
+                    "You cannot specify a scheduler in the config file and in the code at the same time. "
+                    "Please remove the scheduler from the config file or "
+                    "create `accelerate.utils.DummyScheduler` in the code."
+                )
+            elif (
+                "scheduler" not in deepspeed_plugin.deepspeed_config
+                and isinstance(scheduler, (DummyScheduler))
+                and scheduler.lr_scheduler_callable is None
+            ):
+                raise ValueError(
+                    "Either specify a scheduler in the config file or "
+                    "pass in the `lr_scheduler_callable` parameter when using `accelerate.utils.DummyScheduler`."
+                )
+
+        if optimizer is not None and scheduler is not None:
+            if isinstance(optimizer, (DummyOptim)) and not isinstance(scheduler, (DummyScheduler)):
+                raise ValueError(
+                    "You can only specify `accelerate.utils.DummyScheduler` in the code when using "
+                    "`accelerate.utils.DummyOptim`."
+                )
+
+        if model is not None:
+            # deal with config keys that use `auto` value and rely on model's hidden_size
+            hidden_size_based_keys = [
+                "zero_optimization.reduce_bucket_size",
+                "zero_optimization.stage3_prefetch_bucket_size",
+                "zero_optimization.stage3_param_persistence_threshold",
+            ]
+            hidden_size_auto_keys = [x for x in hidden_size_based_keys if deepspeed_plugin.is_auto(x)]
+            if len(hidden_size_auto_keys) > 0:
+                reasoning = (
+                    "therefore it's not possible to automatically fill out the following `auto` entries "
+                    + f"in the DeepSpeed config file: {hidden_size_auto_keys}. You can fix that by replacing "
+                    + "`auto` values for these keys with an integer value of your choice."
+                )
+                if not hasattr(model, "config"):
+                    raise ValueError("Can't find `model.config` entry, " + reasoning)
+
+                if hasattr(model.config, "hidden_size"):
+                    hidden_size = model.config.hidden_size
+                elif hasattr(model.config, "hidden_sizes"):
+                    # if there are many hidden sizes pick the largest one
+                    hidden_size = max(model.config.hidden_sizes)
+                else:
+                    raise ValueError(
+                        "Can find neither `model.config.hidden_size` nor `model.config.hidden_sizes`, " + reasoning
+                    )
+
+                config_kwargs.update(
+                    {
+                        "zero_optimization.reduce_bucket_size": hidden_size * hidden_size,
+                        "zero_optimization.stage3_prefetch_bucket_size": 0.9 * hidden_size * hidden_size,
+                        "zero_optimization.stage3_param_persistence_threshold": 10 * hidden_size,
+                    }
+                )
+
+            if isinstance(optimizer, (DummyOptim)):
+                config_kwargs.update(
+                    {"optimizer.params.lr": optimizer.lr, "optimizer.params.weight_decay": optimizer.weight_decay}
+                )
+            if isinstance(scheduler, (DummyScheduler)) and scheduler.lr_scheduler_callable is None:
+                max_lr = (
+                    getattr(scheduler.optimizer, "lr", None)
+                    if getattr(scheduler.optimizer, "defaults", None) is None
+                    else scheduler.optimizer.defaults["lr"]
+                )
+                config_kwargs.update(
+                    {
+                        "scheduler.params.warmup_min_lr": 0,
+                        "scheduler.params.warmup_max_lr": max_lr,
+                        "scheduler.params.warmup_num_steps": scheduler.warmup_num_steps,
+                    }
+                )
+                if scheduler.total_num_steps is not None:
+                    config_kwargs["scheduler.params.total_num_steps"] = (
+                        math.ceil(scheduler.total_num_steps / self.num_processes)
+                        if not self.split_batches
+                        else scheduler.total_num_steps
+                    )
+            deepspeed_plugin.deepspeed_config_process(must_match=False, **config_kwargs)
+            self.deepspeed_config = deepspeed_plugin.deepspeed_config
+            kwargs = dict(model=model, config_params=self.deepspeed_config)
+            if optimizer is not None:
+                if isinstance(optimizer, (DummyOptim)):
+                    kwargs["model_parameters"] = optimizer.params
+                    if isinstance(scheduler, (DummyScheduler)) and scheduler.lr_scheduler_callable is not None:
+                        kwargs["lr_scheduler"] = scheduler.lr_scheduler_callable
+                else:
+                    if self.deepspeed_config["zero_optimization"].get("offload_optimizer", {}).get(
+                        "device", "none"
+                    ) != "none" and self.deepspeed_config.get("zero_force_ds_cpu_optimizer", True):
+                        from deepspeed.ops.adam import DeepSpeedCPUAdam
+
+                        defaults = {k: v for k, v in optimizer.defaults.items() if k in ["lr", "weight_decay"]}
+                        optimizer = DeepSpeedCPUAdam(optimizer.param_groups, **defaults)
+                    kwargs["optimizer"] = optimizer
+                    if scheduler is not None:
+                        if type(scheduler).__name__ in deepspeed.runtime.lr_schedules.VALID_LR_SCHEDULES:
+                            kwargs["lr_scheduler"] = scheduler
+
+            engine, optimizer, _, lr_scheduler = deepspeed.initialize(**kwargs)
+            if optimizer is not None:
+                optimizer = DeepSpeedOptimizerWrapper(optimizer)
+            if scheduler is not None:
+                if lr_scheduler is None:
+                    scheduler = AcceleratedScheduler(
+                        scheduler,
+                        optimizer,
+                        step_with_optimizer=self.step_scheduler_with_optimizer,
+                        split_batches=self.split_batches,
+                    )
+                else:
+                    scheduler = DeepSpeedSchedulerWrapper(lr_scheduler, optimizer)
+
+            for i in range(len(result)):
+                if isinstance(result[i], torch.nn.Module):
+                    result[i] = engine
+                elif isinstance(result[i], (torch.optim.Optimizer, DummyOptim)):
+                    result[i] = optimizer
+                elif (isinstance(result[i], (LRScheduler, DummyScheduler))) or (
+                    type(result[i]).__name__ in deepspeed.runtime.lr_schedules.VALID_LR_SCHEDULES
+                ):
+                    result[i] = scheduler
+            # pointing for deepspeed_engine_wrapped.backward()
+            self.deepspeed_engine_wrapped = DeepSpeedEngineWrapper(engine)
+            self._models.append(engine)
+            if optimizer is not None:
+                self._optimizers.append(optimizer)
+            if scheduler is not None:
+                self._schedulers.append(scheduler)
+            if len(self._models) > 1:
+                raise AssertionError(
+                    "You can't use same `Accelerator()` instance with multiple models when using DeepSpeed"
+                )
+        return tuple(result)
+
+    def _prepare_megatron_lm(self, *args):
+        megatron_lm_plugin = self.state.megatron_lm_plugin
+        if not megatron_lm_plugin.megatron_dataset_flag:
+            batch_sizes = [obj.batch_size for obj in args if hasattr(obj, "batch_size")]
+            if len(batch_sizes) == 0:
+                raise ValueError(
+                    "You must specify a training or evaluation dataloader in `accelerate.prepare()` when using Megatron-LM."
+                )
+
+            micro_batch_size = min(batch_sizes) if megatron_lm_plugin.is_train_batch_min else max(batch_sizes)
+            if len(batch_sizes) > 1:
+                logger.info(
+                    "Since you passed both train and evaluation dataloader, `is_train_batch_min` (here "
+                    f"{megatron_lm_plugin.is_train_batch_min} will decide the `train_batch_size` ({micro_batch_size})."
+                )
+        else:
+            for obj in args:
+                if isinstance(obj, MegatronLMDummyDataLoader):
+                    micro_batch_size = obj.dataset_args["micro_batch_size"]
+                    break
+
+        dp_degree = self.num_processes // (megatron_lm_plugin.tp_degree * megatron_lm_plugin.pp_degree)
+        megatron_lm_plugin.set_training_args(micro_batch_size, dp_degree)
+
+        model = None
+        optimizer = None
+        scheduler = None
+        is_dummy_scheduler = False
+        batch_data = None
+        for obj in args:
+            if isinstance(obj, torch.utils.data.DataLoader) and batch_data is None:
+                batch_data = next(iter(obj))
+            if isinstance(obj, torch.nn.Module):
+                model = obj
+            elif isinstance(obj, (torch.optim.Optimizer)):
+                optimizer = obj
+            elif isinstance(obj, (LRScheduler, MegatronLMDummyScheduler)):
+                scheduler = obj
+
+        if model is not None:
+            megatron_lm_plugin.set_network_size_args(model, batch_data)
+        if optimizer is not None:
+            megatron_lm_plugin.set_optimizer_type(optimizer)
+        if scheduler is not None:
+            is_dummy_scheduler = isinstance(scheduler, MegatronLMDummyScheduler)
+            if not is_dummy_scheduler:
+                raise ValueError(
+                    "You can't use a custom scheduler with Megatron-LM. Please use the `accelerate.utils.MegatronLMDummyScheduler` instead."
+                )
+            megatron_lm_plugin.set_scheduler_args(scheduler)
+
+        # initialize megatron-lm
+        megatron_lm_initialize(self, args_defaults=megatron_lm_plugin.megatron_lm_default_args)
+        counter = 0
+        result = []
+        for obj in args:
+            if isinstance(obj, torch.utils.data.DataLoader):
+                result.append(megatron_lm_prepare_data_loader(self, obj))
+                counter += 1
+            elif isinstance(obj, MegatronLMDummyDataLoader):
+                if counter == 0:
+                    obj.set_megatron_data_args()
+                    dataloaders = megatron_lm_prepare_data_loader(self, obj)
+                result.append(dataloaders[counter])
+                counter += 1
+            else:
+                result.append(obj)
+
+        if model is not None:
+            model = megatron_lm_prepare_model(self)
+        if optimizer is not None:
+            optimizer = megatron_lm_prepare_optimizer(self, model)
+        if scheduler is not None:
+            scheduler = megatron_lm_prepare_scheduler(self, optimizer, scheduler)
+
+        if model is not None:
+            model = MegatronEngine(self, model, optimizer, scheduler)
+        if optimizer is not None:
+            optimizer = MegatronLMOptimizerWrapper(optimizer)
+        if scheduler is not None:
+            scheduler = MegatronLMSchedulerWrapper(scheduler, optimizer)
+
+        for i in range(len(result)):
+            if isinstance(result[i], torch.nn.Module):
+                result[i] = model
+            elif isinstance(result[i], torch.optim.Optimizer):
+                result[i] = optimizer
+            elif isinstance(result[i], MegatronLMDummyScheduler):
+                result[i] = scheduler
+        if model is not None:
+            self._models.append(model)
+        if optimizer is not None:
+            self._optimizers.append(optimizer)
+        if scheduler is not None:
+            self._schedulers.append(scheduler)
+        if len(self._models) > 1:
+            raise AssertionError(
+                "You can't use same `Accelerator()` instance with multiple models when using Megatron-LM"
+            )
+        return tuple(result)
+
+    def _prepare_ipex(self, *args):
+        if not is_ipex_available():
+            raise ImportError(
+                "IPEX is not installed or IPEX's version does not match current PyTorch version. Please refer"
+                " to https://github.com/intel/intel-extension-for-pytorch."
+            )
+        else:
+            import intel_extension_for_pytorch as ipex
+
+        model = None
+        optimizer = None
+        result = [obj for obj in args]
+        for obj in result:
+            if isinstance(obj, torch.nn.Module):
+                model = obj
+                model.train()
+            elif isinstance(obj, (torch.optim.Optimizer)):
+                optimizer = obj
+        if optimizer is not None and model is not None:
+            dtype = torch.bfloat16 if self.state.mixed_precision == "bf16" else None
+            if self.device.type == "xpu" and is_xpu_available():
+                model = model.to(self.device)
+                model, optimizer = torch.xpu.optimize(
+                    model, optimizer=optimizer, dtype=dtype, inplace=True, level="O1"
+                )
+            else:
+                model, optimizer = ipex.optimize(model, optimizer=optimizer, dtype=dtype, inplace=True, level="O1")
+        for i in range(len(result)):
+            if isinstance(result[i], torch.nn.Module):
+                result[i] = model
+            elif isinstance(result[i], (torch.optim.Optimizer)):
+                result[i] = optimizer
+        return tuple(result)
+
+    def _prepare_msamp(self, *args):
+        if not is_msamp_available():
+            raise ImportError(
+                "MS-AMP was not found on your system. Please ensure that MS-AMP is available "
+                " or choose `'te'` as the backend for FP8 mixed precision training."
+            )
+        else:
+            import msamp
+
+        model, optimizer = None, None
+        num_models, num_optimizers = 0, 0
+        result = [obj for obj in args]
+        for obj in result:
+            if isinstance(obj, torch.nn.Module):
+                model = obj
+                num_models += 1
+            elif isinstance(obj, (torch.optim.Optimizer)):
+                optimizer = obj
+                num_optimizers += 1
+        if optimizer is None or model is None:
+            raise ValueError(
+                "You must pass a model and an optimizer together to `accelerate.prepare()` when using MS-AMP."
+            )
+        elif num_models > 1 or num_optimizers > 1:
+            raise ValueError(
+                f"You can't use multiple models ({num_models}) or optimizers {num_optimizers} with MS-AMP."
+            )
+        else:
+            model, optimizer = msamp.initialize(model, optimizer, opt_level=self.fp8_recipe_handler.opt_level)
+        for i in range(len(result)):
+            if isinstance(result[i], torch.nn.Module):
+                result[i] = model
+            elif isinstance(result[i], (torch.optim.Optimizer)):
+                result[i] = optimizer
+        return tuple(result)
+
+    def prepare_data_loader(
+        self, data_loader: torch.utils.data.DataLoader, device_placement=None, slice_fn_for_dispatch=None
+    ):
+        """
+        Prepares a PyTorch DataLoader for training in any distributed setup. It is recommended to use
+        [`Accelerator.prepare`] instead.
+
+        Args:
+            data_loader (`torch.utils.data.DataLoader`):
+                A vanilla PyTorch DataLoader to prepare
+            device_placement (`bool`, *optional*):
+                Whether or not to place the batches on the proper device in the prepared dataloader. Will default to
+                `self.device_placement`.
+            slice_fn_for_dispatch (`Callable`, *optional*`):
+                If passed, this function will be used to slice tensors across `num_processes`. Will default to
+                [`~utils.slice_tensors`]. This argument is used only when `dispatch_batches` is set to `True` and will
+                be ignored otherwise.
+
+        Example:
+
+        ```python
+        >>> import torch
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> data_loader = torch.utils.data.DataLoader(...)
+        >>> data_loader = accelerator.prepare_data_loader(data_loader, device_placement=True)
+        ```
+        """
+        # Ensure we can't double wrap a DataLoader due to `find_batch_size`
+        if getattr(data_loader, "_is_accelerate_prepared", False):
+            if data_loader not in self._dataloaders:
+                self._dataloaders.append(data_loader)
+            return data_loader
+        if device_placement is None:
+            device_placement = self.device_placement if self.distributed_type != DistributedType.XLA else False
+        prepared_data_loader = prepare_data_loader(
+            data_loader,
+            self.device,
+            num_processes=self.num_processes,
+            process_index=self.process_index,
+            split_batches=self.split_batches,
+            put_on_device=device_placement,
+            rng_types=self.rng_types.copy(),
+            dispatch_batches=self.dispatch_batches,
+            even_batches=self.even_batches,
+            slice_fn_for_dispatch=slice_fn_for_dispatch,
+            use_seedable_sampler=self.use_seedable_sampler,
+        )
+        self._dataloaders.append(prepared_data_loader)
+        return prepared_data_loader
+
+    def prepare_optimizer(self, optimizer: torch.optim.Optimizer, device_placement=None):
+        """
+        Prepares a PyTorch Optimizer for training in any distributed setup. It is recommended to use
+        [`Accelerator.prepare`] instead.
+
+        Args:
+            optimizer (`torch.optim.Optimizer`):
+                A vanilla PyTorch optimizer to prepare
+            device_placement (`bool`, *optional*):
+                Whether or not to place the optimizer on the proper device. Will default to `self.device_placement`.
+
+        Example:
+
+        ```python
+        >>> import torch
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> optimizer = torch.optim.Adam(...)
+        >>> optimizer = accelerator.prepare_optimizer(optimizer, device_placement=True)
+        ```
+        """
+        # Ensure we can't double wrap an optimizer due to `find_batch_size`
+        if getattr(optimizer, "_is_accelerate_prepared", False):
+            if optimizer not in self._optimizers:
+                self._optimizers.append(optimizer)
+            return optimizer
+        if device_placement is None:
+            device_placement = self.device_placement
+        optimizer = AcceleratedOptimizer(optimizer, device_placement=device_placement, scaler=self.scaler)
+        self._optimizers.append(optimizer)
+        return optimizer
+
+    def prepare_scheduler(self, scheduler: LRScheduler):
+        """
+        Prepares a PyTorch Scheduler for training in any distributed setup. It is recommended to use
+        [`Accelerator.prepare`] instead.
+
+        Args:
+            scheduler (`torch.optim.lr_scheduler.LRScheduler`):
+                A vanilla PyTorch scheduler to prepare
+
+        Example:
+
+        ```python
+        >>> import torch
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> optimizer = torch.optim.Adam(...)
+        >>> scheduler = torch.optim.lr_scheduler.LambdaLR(optimizer, ...)
+        >>> scheduler = accelerator.prepare_scheduler(scheduler)
+        ```
+        """
+        # Ensure we can't double wrap a scheduler due to `find_batch_size`
+        if getattr(scheduler, "_is_accelerate_prepared", False):
+            if scheduler not in self._schedulers:
+                self._schedulers.append(scheduler)
+            return scheduler
+        # We try to find the optimizer associated with `scheduler`, the default is the full list.
+        optimizer = self._optimizers
+        for opt in self._optimizers:
+            if getattr(scheduler, "optimizer", None) == opt.optimizer:
+                optimizer = opt
+                break
+        scheduler = AcceleratedScheduler(
+            scheduler,
+            optimizer,
+            step_with_optimizer=self.step_scheduler_with_optimizer,
+            split_batches=self.split_batches,
+        )
+        self._schedulers.append(scheduler)
+        return scheduler
+
+    def backward(self, loss, **kwargs):
+        """
+        Scales the gradients in accordance to the `GradientAccumulationPlugin` and calls the correct `backward()` based
+        on the configuration.
+
+        Should be used in lieu of `loss.backward()`.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator(gradient_accumulation_steps=2)
+        >>> outputs = model(inputs)
+        >>> loss = loss_fn(outputs, labels)
+        >>> accelerator.backward(loss)
+        ```
+        """
+        if self.distributed_type != DistributedType.DEEPSPEED:
+            # deepspeed handles loss scaling by gradient_accumulation_steps in its `backward`
+            loss = loss / self.gradient_accumulation_steps
+        if self.distributed_type == DistributedType.DEEPSPEED:
+            self.deepspeed_engine_wrapped.backward(loss, **kwargs)
+        elif self.distributed_type == DistributedType.MEGATRON_LM:
+            return
+        elif self.scaler is not None:
+            self.scaler.scale(loss).backward(**kwargs)
+        else:
+            loss.backward(**kwargs)
+
+    def set_trigger(self):
+        """
+        Sets the internal trigger tensor to 1 on the current process. A latter check should follow using this which
+        will check across all processes.
+
+        Note:
+            Does not require `wait_for_everyone()`
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> # Assume later in the training script
+        >>> # `should_do_breakpoint` is a custom function to monitor when to break,
+        >>> # e.g. when the loss is NaN
+        >>> if should_do_breakpoint(loss):
+        ...     accelerator.set_trigger()
+        >>> # Assume later in the training script
+        >>> if accelerator.check_breakpoint():
+        ...     break
+        ```
+        """
+        self.flag_tensor = torch.tensor(1, device=self.device)
+
+    def check_trigger(self):
+        """
+        Checks if the internal trigger tensor has been set to 1 in any of the processes. If so, will return `True` and
+        reset the trigger tensor to 0.
+
+        Note:
+            Does not require `wait_for_everyone()`
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> # Assume later in the training script
+        >>> # `should_do_breakpoint` is a custom function to monitor when to break,
+        >>> # e.g. when the loss is NaN
+        >>> if should_do_breakpoint(loss):
+        ...     accelerator.set_trigger()
+        >>> # Assume later in the training script
+        >>> if accelerator.check_trigger():
+        ...     break
+        ```
+        """
+        # Now that we are outside `__init__`, we can initialize it if it is `None` on device
+        if self.flag_tensor is None:
+            self.flag_tensor = torch.tensor(0, device=self.device)
+        flag_tensor = self.reduce(self.flag_tensor)
+        if flag_tensor.item() >= 1:
+            self.flag_tensor = torch.tensor(0, device=self.device)
+            return True
+        return False
+
+    def unscale_gradients(self, optimizer=None):
+        """
+        Unscale the gradients in mixed precision training with AMP. This is a noop in all other settings.
+
+        Likely should be called through [`Accelerator.clip_grad_norm_`] or [`Accelerator.clip_grad_value_`]
+
+        Args:
+            optimizer (`torch.optim.Optimizer` or `list[torch.optim.Optimizer]`, *optional*):
+                The optimizer(s) for which to unscale gradients. If not set, will unscale gradients on all optimizers
+                that were passed to [`~Accelerator.prepare`].
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> model, optimizer = accelerator.prepare(model, optimizer)
+        >>> outputs = model(inputs)
+        >>> loss = loss_fn(outputs, labels)
+        >>> accelerator.backward(loss)
+        >>> accelerator.unscale_gradients(optimizer=optimizer)
+        ```
+        """
+        if self.native_amp and self.mixed_precision == "fp16":
+            if optimizer is None:
+                # TODO: this unscales all optimizers where we should only unscale the one where parameters are.
+                optimizer = self._optimizers
+            elif not isinstance(optimizer, (tuple, list)):
+                optimizer = [optimizer]
+            for opt in optimizer:
+                while isinstance(opt, AcceleratedOptimizer):
+                    opt = opt.optimizer
+                self.scaler.unscale_(opt)
+
+    def clip_grad_norm_(self, parameters, max_norm, norm_type=2):
+        """
+        Should be used in place of `torch.nn.utils.clip_grad_norm_`.
+
+        Returns:
+            `torch.Tensor`: Total norm of the parameter gradients (viewed as a single vector).
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator(gradient_accumulation_steps=2)
+        >>> dataloader, model, optimizer, scheduler = accelerator.prepare(dataloader, model, optimizer, scheduler)
+
+        >>> for input, target in dataloader:
+        ...     optimizer.zero_grad()
+        ...     output = model(input)
+        ...     loss = loss_func(output, target)
+        ...     accelerator.backward(loss)
+        ...     if accelerator.sync_gradients:
+        ...         accelerator.clip_grad_norm_(model.parameters(), max_grad_norm)
+        ...     optimizer.step()
+        ```
+        """
+        if self.distributed_type == DistributedType.FSDP:
+            self.unscale_gradients()
+            parameters = [p for p in parameters]
+            for model in self._models:
+                if parameters == [p for p in model.parameters()]:
+                    return model.clip_grad_norm_(max_norm, norm_type)
+        elif self.distributed_type == DistributedType.DEEPSPEED:
+            # `accelerator.backward(loss)` is doing that automatically. Therefore, its implementation is not needed
+            # We cannot return the gradient norm because DeepSpeed does it.
+            return None
+        elif self.distributed_type == DistributedType.XLA:
+            # Reduce gradients first for XLA
+            for acc_opt in self._optimizers:
+                if not acc_opt.gradient_state.is_xla_gradients_synced:
+                    opt = acc_opt
+                    while isinstance(opt, AcceleratedOptimizer):
+                        opt = opt.optimizer
+                    gradients = xm._fetch_gradients(opt)
+                    # Use xm.all_reduce to perform an in-place all-reduce. Recusrsive all-reduce each tensor
+                    # one by one in self.reduce is non-inplace.
+                    xm.all_reduce("sum", gradients, scale=1.0 / self.num_processes)
+                    # Set is_xla_gradients_synced to True to avoid all-reduce twice in the AcceleratedOptimizer step.
+                    acc_opt.gradient_state.is_xla_gradients_synced = True
+        self.unscale_gradients()
+        return torch.nn.utils.clip_grad_norm_(parameters, max_norm, norm_type=norm_type)
+
+    def clip_grad_value_(self, parameters, clip_value):
+        """
+        Should be used in place of `torch.nn.utils.clip_grad_value_`.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator(gradient_accumulation_steps=2)
+        >>> dataloader, model, optimizer, scheduler = accelerator.prepare(dataloader, model, optimizer, scheduler)
+
+        >>> for input, target in dataloader:
+        ...     optimizer.zero_grad()
+        ...     output = model(input)
+        ...     loss = loss_func(output, target)
+        ...     accelerator.backward(loss)
+        ...     if accelerator.sync_gradients:
+        ...         accelerator.clip_grad_value_(model.parameters(), clip_value)
+        ...     optimizer.step()
+        ```
+        """
+        if self.distributed_type in [DistributedType.DEEPSPEED, DistributedType.FSDP]:
+            raise Exception("DeepSpeed and FSDP  do not support `clip_grad_value_`. Use `clip_grad_norm_` instead.")
+        self.unscale_gradients()
+        torch.nn.utils.clip_grad_value_(parameters, clip_value)
+
+    def gather(self, tensor):
+        """
+        Gather the values in *tensor* across all processes and concatenate them on the first dimension. Useful to
+        regroup the predictions from all processes when doing evaluation.
+
+        Note:
+            This gather happens in all processes.
+
+        Args:
+            tensor (`torch.Tensor`, or a nested tuple/list/dictionary of `torch.Tensor`):
+                The tensors to gather across all processes.
+
+        Returns:
+            `torch.Tensor`, or a nested tuple/list/dictionary of `torch.Tensor`: The gathered tensor(s). Note that the
+            first dimension of the result is *num_processes* multiplied by the first dimension of the input tensors.
+
+        Example:
+
+        ```python
+        >>> # Assuming four processes
+        >>> import torch
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> process_tensor = torch.tensor([accelerator.process_index])
+        >>> gathered_tensor = accelerator.gather(process_tensor)
+        >>> gathered_tensor
+        tensor([0, 1, 2, 3])
+        ```
+        """
+        return gather(tensor)
+
+    def gather_for_metrics(self, input_data):
+        """
+        Gathers `input_data` and potentially drops duplicates in the last batch if on a distributed system. Should be
+        used for gathering the inputs and targets for metric calculation.
+
+        Args:
+            input (`torch.Tensor`, `object`, a nested tuple/list/dictionary of `torch.Tensor`, or a nested tuple/list/dictionary of `object`):
+                The tensors or objects for calculating metrics across all processes
+
+        Example:
+
+        ```python
+        >>> # Assuming two processes, with a batch size of 5 on a dataset with 9 samples
+        >>> import torch
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> dataloader = torch.utils.data.DataLoader(range(9), batch_size=5)
+        >>> dataloader = accelerator.prepare(dataloader)
+        >>> batch = next(iter(dataloader))
+        >>> gathered_items = accelerator.gather_for_metrics(batch)
+        >>> len(gathered_items)
+        9
+        ```
+        """
+
+        try:
+            recursively_apply(lambda x: x, input_data, error_on_other_type=True)
+            all_tensors = True
+        except TypeError:
+            all_tensors = False
+
+        if not all_tensors:
+            data = gather_object(input_data)
+        else:
+            data = self.gather(input_data)
+
+        try:
+            if self.gradient_state.end_of_dataloader:
+                # at the end of a dataloader, `gather_for_metrics` regresses to
+                # `gather` unless the dataset has a remainder so log.
+                if self.gradient_state.remainder == -1:
+                    logger.info(
+                        "The used dataset had no length, returning gathered tensors. You should drop the remainder yourself."
+                    )
+                    return data
+                elif self.gradient_state.remainder > 0:
+                    # Last batch needs to be truncated on distributed systems as it contains additional samples
+                    def _adjust_samples(tensor):
+                        return tensor[: self.gradient_state.remainder]
+
+                    return recursively_apply(_adjust_samples, data)
+                else:  # remainder is 0
+                    # no remainder even though at end of dataloader, so nothing to do.
+                    return data
+            else:
+                # Not at the end of the dataloader, no need to adjust the tensors
+                return data
+        except Exception:
+            # Dataset had no length or raised an error
+            return data
+
+    def reduce(self, tensor, reduction="sum", scale=1.0):
+        """
+        Reduce the values in *tensor* across all processes based on *reduction*.
+
+        Note:
+            All processes get the reduced value.
+
+        Args:
+            tensor (`torch.Tensor`, or a nested tuple/list/dictionary of `torch.Tensor`):
+                The tensors to reduce across all processes.
+            reduction (`str`, *optional*, defaults to "sum"):
+                A reduction type, can be one of 'sum', 'mean', or 'none'. If 'none', will not perform any operation.
+            scale (`float`, *optional*, defaults to 1.0):
+                A default scaling value to be applied after the reduce, only valied on XLA.
+
+        Returns:
+            `torch.Tensor`, or a nested tuple/list/dictionary of `torch.Tensor`:
+                The reduced tensor(s).
+
+        Example:
+
+        ```python
+        >>> # Assuming two processes
+        >>> import torch
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> process_tensor = torch.arange(accelerator.num_processes) + 1 + (2 * accelerator.process_index)
+        >>> process_tensor = process_tensor.to(accelerator.device)
+        >>> reduced_tensor = accelerator.reduce(process_tensor, reduction="sum")
+        >>> reduced_tensor
+        tensor([4, 6])
+        ```
+        """
+        return reduce(tensor, reduction, scale)
+
+    def pad_across_processes(self, tensor, dim=0, pad_index=0, pad_first=False):
+        """
+        Recursively pad the tensors in a nested list/tuple/dictionary of tensors from all devices to the same size so
+        they can safely be gathered.
+
+        Args:
+            tensor (nested list/tuple/dictionary of `torch.Tensor`):
+                The data to gather.
+            dim (`int`, *optional*, defaults to 0):
+                The dimension on which to pad.
+            pad_index (`int`, *optional*, defaults to 0):
+                The value with which to pad.
+            pad_first (`bool`, *optional*, defaults to `False`):
+                Whether to pad at the beginning or the end.
+
+        Returns:
+            `torch.Tensor`, or a nested tuple/list/dictionary of `torch.Tensor`:
+                The padded tensor(s).
+
+        Example:
+
+        ```python
+        >>> # Assuming two processes, with the first processes having a tensor of size 1 and the second of size 2
+        >>> import torch
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> process_tensor = torch.arange(accelerator.process_index + 1).to(accelerator.device)
+        >>> padded_tensor = accelerator.pad_across_processes(process_tensor)
+        >>> padded_tensor.shape
+        torch.Size([2])
+        ```
+        """
+        return pad_across_processes(tensor, dim=dim, pad_index=pad_index, pad_first=pad_first)
+
+    def unwrap_model(self, model, keep_fp32_wrapper: bool = True):
+        """
+        Unwraps the `model` from the additional layer possible added by [`~Accelerator.prepare`]. Useful before saving
+        the model.
+
+        Args:
+            model (`torch.nn.Module`):
+                The model to unwrap.
+            keep_fp32_wrapper (`bool`, *optional*, defaults to `True`):
+                Whether to not remove the mixed precision hook if it was added.
+
+        Returns:
+            `torch.nn.Module`: The unwrapped model.
+
+        Example:
+
+        ```python
+        >>> # Assuming two GPU processes
+        >>> from torch.nn.parallel import DistributedDataParallel
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> model = accelerator.prepare(MyModel())
+        >>> print(model.__class__.__name__)
+        DistributedDataParallel
+
+        >>> model = accelerator.unwrap_model(model)
+        >>> print(model.__class__.__name__)
+        MyModel
+        ```
+        """
+        return extract_model_from_parallel(model, keep_fp32_wrapper)
+
+    def wait_for_everyone(self):
+        """
+        Will stop the execution of the current process until every other process has reached that point (so this does
+        nothing when the script is only run in one process). Useful to do before saving a model.
+
+        Example:
+
+        ```python
+        >>> # Assuming two GPU processes
+        >>> import time
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> if accelerator.is_main_process:
+        ...     time.sleep(2)
+        >>> else:
+        ...     print("I'm waiting for the main process to finish its sleep...")
+        >>> accelerator.wait_for_everyone()
+        >>> # Should print on every process at the same time
+        >>> print("Everyone is here")
+        ```
+        """
+        wait_for_everyone()
+
+    @on_main_process
+    def init_trackers(self, project_name: str, config: dict | None = None, init_kwargs: dict | None = {}):
+        """
+        Initializes a run for all trackers stored in `self.log_with`, potentially with starting configurations
+
+        Args:
+            project_name (`str`):
+                The name of the project. All trackers will save their data based on this
+            config (`dict`, *optional*):
+                Optional starting configuration to be logged.
+            init_kwargs (`dict`, *optional*):
+                A nested dictionary of kwargs to be passed to a specific tracker's `__init__` function. Should be
+                formatted like so:
+                ```python
+                {"wandb": {"tags": ["tag_a", "tag_b"]}}
+                ```
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator(log_with="tensorboard")
+        >>> accelerator.init_trackers(
+        ...     project_name="my_project",
+        ...     config={"learning_rate": 0.001, "batch_size": 32},
+        ...     init_kwargs={"tensorboard": {"flush_secs": 60}},
+        ... )
+        ```
+        """
+        for tracker in self.log_with:
+            if issubclass(type(tracker), GeneralTracker):
+                # Custom trackers are already initialized
+                self.trackers.append(tracker)
+            else:
+                tracker_init = LOGGER_TYPE_TO_CLASS[str(tracker)]
+                if tracker_init.requires_logging_directory:
+                    # We can skip this check since it was done in `__init__`
+                    self.trackers.append(
+                        tracker_init(project_name, self.logging_dir, **init_kwargs.get(str(tracker), {}))
+                    )
+                else:
+                    self.trackers.append(tracker_init(project_name, **init_kwargs.get(str(tracker), {})))
+        if config is not None:
+            for tracker in self.trackers:
+                tracker.store_init_configuration(config)
+
+    def get_tracker(self, name: str, unwrap: bool = False):
+        """
+        Returns a `tracker` from `self.trackers` based on `name` on the main process only.
+
+        Args:
+            name (`str`):
+                The name of a tracker, corresponding to the `.name` property.
+            unwrap (`bool`):
+                Whether to return the internal tracking mechanism or to return the wrapped tracker instead
+                (recommended).
+
+        Returns:
+            `GeneralTracker`: The tracker corresponding to `name` if it exists.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator(log_with="tensorboard")
+        >>> accelerator.init_trackers("my_project")
+        >>> tensorboard_tracker = accelerator.get_tracker("tensorboard")
+        ```
+        """
+        if len(self.trackers) > 0:
+            for tracker in self.trackers:
+                if tracker.name == name:
+                    return tracker.tracker if unwrap else tracker
+            raise ValueError(f"{name} is not an available tracker stored inside the `Accelerator`.")
+        # Handle tracker only made on main process
+        return GeneralTracker(_blank=True)
+
+    @on_main_process
+    def log(self, values: dict, step: int | None = None, log_kwargs: dict | None = {}):
+        """
+        Logs `values` to all stored trackers in `self.trackers` on the main process only.
+
+        Args:
+            values (`dict`):
+                Values should be a dictionary-like object containing only types `int`, `float`, or `str`.
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+            log_kwargs (`dict`, *optional*):
+                A nested dictionary of kwargs to be passed to a specific tracker's `log` function. Should be formatted
+                like so:
+                ```python
+                {"wandb": {"tags": ["tag_a", "tag_b"]}}
+                ```
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator(log_with="tensorboard")
+        >>> accelerator.init_trackers("my_project")
+        >>> accelerator.log({"loss": 0.5, "accuracy": 0.9})
+        ```
+        """
+        for tracker in self.trackers:
+            tracker.log(values, step=step, **log_kwargs.get(tracker.name, {}))
+
+    @on_main_process
+    def end_training(self):
+        """
+        Runs any special end training behaviors, such as stopping trackers on the main process only. Should always be
+        called at the end of your script if using experiment tracking.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator(log_with="tensorboard")
+        >>> accelerator.init_trackers("my_project")
+        >>> # Do training
+        >>> accelerator.end_training()
+        ```
+        """
+        for tracker in self.trackers:
+            tracker.finish()
+
+    def save(self, obj, f, safe_serialization=False):
+        """
+        Save the object passed to disk once per machine. Use in place of `torch.save`.
+
+        Args:
+            obj (`object`): The object to save.
+            f (`str` or `os.PathLike`): Where to save the content of `obj`.
+            safe_serialization (`bool`, *optional*, defaults to `False`): Whether to save `obj` using `safetensors`
+
+        Note:
+            If `save_on_each_node` was passed in as a `ProjectConfiguration`, will save the object once per node,
+            rather than only once on the main node.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> arr = [0, 1, 2, 3]
+        >>> accelerator.save(arr, "array.pkl")
+        ```
+        """
+        save(
+            obj,
+            f,
+            save_on_each_node=self.project_configuration.save_on_each_node,
+            safe_serialization=safe_serialization,
+        )
+
+    def save_model(
+        self,
+        model: torch.nn.Module,
+        save_directory: Union[str, os.PathLike],
+        max_shard_size: Union[int, str] = "10GB",
+        safe_serialization: bool = True,
+    ):
+        """
+        Save a model so that it can be re-loaded using load_checkpoint_in_model
+
+        Arguments:
+            model: (`torch.nn.Module`):
+                Model to be saved. The model can be wrapped or unwraped.
+            save_directory (`str` or `os.PathLike`):
+                Directory to which to save. Will be created if it doesn't exist.
+            max_shard_size (`int` or `str`, *optional*, defaults to `"10GB"`):
+                The maximum size for a checkpoint before being sharded. Checkpoints shard will then be each of size
+                lower than this size. If expressed as a string, needs to be digits followed by a unit (like `"5MB"`).
+
+                <Tip warning={true}>
+
+                If a single weight of the model is bigger than `max_shard_size`, it will be in its own checkpoint shard
+                which will be bigger than `max_shard_size`.
+
+                </Tip>
+
+            safe_serialization (`bool`, *optional*, defaults to `True`):
+                Whether to save the model using `safetensors` or the traditional PyTorch way (that uses `pickle`).
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> model = ...
+        >>> accelerator.save_model(model, save_directory)
+        ```
+        """
+
+        if os.path.isfile(save_directory):
+            logger.error(f"Provided path ({save_directory}) should be a directory, not a file")
+            return
+
+        os.makedirs(save_directory, exist_ok=True)
+
+        # get the state_dict of the model
+        if any(
+            [
+                module._hf_hook.offload
+                for module in model.modules()
+                if hasattr(module, "_hf_hook") and isinstance(module._hf_hook, AlignDevicesHook)
+            ]
+        ):
+            state_dict = get_state_dict_offloaded_model(model)
+        else:
+            if any(param.device == torch.device("meta") for param in model.parameters()):
+                raise RuntimeError("You can't save the model since some parameters are on the meta device.")
+            state_dict = self.get_state_dict(model)
+
+        if safe_serialization:
+            state_dict = clean_state_dict_for_safetensors(state_dict)
+        weights_name = SAFE_WEIGHTS_NAME if safe_serialization else WEIGHTS_NAME
+
+        # Shard the model if it is too big.
+        shards, index = shard_checkpoint(state_dict, max_shard_size=max_shard_size, weights_name=weights_name)
+
+        # Clean the folder from a previous save
+        for filename in os.listdir(save_directory):
+            full_filename = os.path.join(save_directory, filename)
+            # If we have a shard file that is not going to be replaced, we delete it, but only from the main process
+            # in distributed settings to avoid race conditions.
+            weights_no_suffix = weights_name.replace(".bin", "")
+
+            # make sure that file to be deleted matches format of sharded file, e.g. pytorch_model-00001-of-00005
+            filename_no_suffix = filename.replace(".bin", "")
+            reg = re.compile(r"(.*?)-\d{5}-of-\d{5}")
+
+            if (
+                filename.startswith(weights_no_suffix)
+                and os.path.isfile(full_filename)
+                and filename not in shards.keys()
+                and reg.fullmatch(filename_no_suffix) is not None
+                and PartialState().is_main_process
+            ):
+                os.remove(full_filename)
+
+        # Save the model
+        for shard_file, shard in shards.items():
+            self.save(shard, os.path.join(save_directory, shard_file), safe_serialization=safe_serialization)
+
+        if index is None:
+            path_to_weights = os.path.join(save_directory, WEIGHTS_NAME)
+            logger.info(f"Model weights saved in {path_to_weights}")
+        else:
+            save_index_file = SAFE_WEIGHTS_INDEX_NAME if safe_serialization else WEIGHTS_INDEX_NAME
+            save_index_file = os.path.join(save_directory, save_index_file)
+            # Save the index as well
+            with open(save_index_file, "w", encoding="utf-8") as f:
+                content = json.dumps(index, indent=2, sort_keys=True) + "\n"
+                f.write(content)
+            logger.info(
+                f"The model is bigger than the maximum size per checkpoint ({max_shard_size}) and is going to be "
+                f"split in {len(shards)} checkpoint shards. You can find where each parameters has been saved in the "
+                f"index located at {save_index_file}."
+            )
+
+    def register_save_state_pre_hook(self, hook: Callable[..., None]) -> hooks.RemovableHandle:
+        """
+        Registers a pre hook to be run before `save_checkpoint` is called in [`Accelerator.save_state`].
+
+        Args:
+            hook (`Callable`):
+                A function to be called in [`Accelerator.save_state`] before `save_checkpoint`.
+
+        The hook should have the following signature:
+
+        `hook(models: list[torch.nn.Module], weights: list[dict[str, torch.Tensor]], input_dir: str) -> None`
+
+        The `models` argument are the models as saved in the accelerator state under `accelerator._models`, `weigths`
+        argument are the state dicts of the `models`, and the `input_dir` argument is the `input_dir` argument passed
+        to [`Accelerator.load_state`].
+
+        <Tip>
+
+        Should only be used in conjunction with [`Accelerator.register_load_state_pre_hook`]. Can be useful to save
+        configurations in addition to model weights. Can also be used to overwrite model saving with a customized
+        method. In this case, make sure to remove already loaded weights from the weights list.
+
+        </Tip>
+
+        Returns:
+            `torch.utils.hooks.RemovableHandle`: a handle that can be used to remove the added hook by calling
+            `handle.remove()`
+        """
+        handle = hooks.RemovableHandle(self._save_model_state_pre_hook)
+        self._save_model_state_pre_hook[handle.id] = hook
+        return handle
+
+    def save_state(self, output_dir: str = None, safe_serialization: bool = True, **save_model_func_kwargs):
+        """
+        Saves the current states of the model, optimizer, scaler, RNG generators, and registered objects to a folder.
+
+        If a `ProjectConfiguration` was passed to the `Accelerator` object with `automatic_checkpoint_naming` enabled
+        then checkpoints will be saved to `self.project_dir/checkpoints`. If the number of current saves is greater
+        than `total_limit` then the oldest save is deleted. Each checkpoint is saved in seperate folders named
+        `checkpoint_<iteration>`.
+
+        Otherwise they are just saved to `output_dir`.
+
+        <Tip>
+
+        Should only be used when wanting to save a checkpoint during training and restoring the state in the same
+        environment.
+
+        </Tip>
+
+        Args:
+            output_dir (`str` or `os.PathLike`):
+                The name of the folder to save all relevant weights and states.
+            safe_serialization (`bool`, *optional*, defaults to `True`):
+                Whether to save the model using `safetensors` or the traditional PyTorch way (that uses `pickle`).
+            save_model_func_kwargs (`dict`, *optional*):
+                Additional keyword arguments for saving model which can be passed to the underlying save function, such
+                as optional arguments for DeepSpeed's `save_checkpoint` function.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> model, optimizer, lr_scheduler = ...
+        >>> model, optimizer, lr_scheduler = accelerator.prepare(model, optimizer, lr_scheduler)
+        >>> accelerator.save_state(output_dir="my_checkpoint")
+        ```
+        """
+        if self.project_configuration.automatic_checkpoint_naming:
+            output_dir = os.path.join(self.project_dir, "checkpoints")
+        os.makedirs(output_dir, exist_ok=True)
+        if self.project_configuration.automatic_checkpoint_naming:
+            folders = [os.path.join(output_dir, folder) for folder in os.listdir(output_dir)]
+            if (
+                self.project_configuration.total_limit is not None
+                and (len(folders) + 1 > self.project_configuration.total_limit)
+                and self.is_main_process
+            ):
+
+                def _inner(folder):
+                    return list(map(int, re.findall(r"[\/]?([0-9]+)(?=[^\/]*$)", folder)))[0]
+
+                folders.sort(key=_inner)
+                logger.warning(
+                    f"Deleting {len(folders) + 1 - self.project_configuration.total_limit} checkpoints to make room for new checkpoint."
+                )
+                for folder in folders[: len(folders) + 1 - self.project_configuration.total_limit]:
+                    shutil.rmtree(folder)
+            output_dir = os.path.join(output_dir, f"checkpoint_{self.save_iteration}")
+            if os.path.exists(output_dir):
+                raise ValueError(
+                    f"Checkpoint directory {output_dir} ({self.save_iteration}) already exists. Please manually override `self.save_iteration` with what iteration to start with."
+                )
+            self.wait_for_everyone()
+        os.makedirs(output_dir, exist_ok=True)
+        logger.info(f"Saving current state to {output_dir}")
+
+        if self.distributed_type == DistributedType.XLA:
+            # Finish running the previous step before checkpointing
+            xm.mark_step()
+
+        # Save the models taking care of FSDP and DeepSpeed nuances
+        weights = []
+        for i, model in enumerate(self._models):
+            if self.distributed_type == DistributedType.FSDP:
+                logger.info("Saving FSDP model")
+                save_fsdp_model(self.state.fsdp_plugin, self, model, output_dir, i)
+                logger.info(f"FSDP Model saved to output dir {output_dir}")
+            elif self.distributed_type == DistributedType.DEEPSPEED:
+                logger.info("Saving DeepSpeed Model and Optimizer")
+                ckpt_id = f"{MODEL_NAME}" if i == 0 else f"{MODEL_NAME}_{i}"
+                model.save_checkpoint(output_dir, ckpt_id, **save_model_func_kwargs)
+                logger.info(f"DeepSpeed Model and Optimizer saved to output dir {os.path.join(output_dir, ckpt_id)}")
+            elif self.distributed_type == DistributedType.MEGATRON_LM:
+                logger.info("Saving Megatron-LM Model, Optimizer and Scheduler")
+                model.save_checkpoint(output_dir)
+                logger.info(f"Megatron-LM Model , Optimizer and Scheduler saved to output dir {output_dir}")
+            else:
+                weights.append(self.get_state_dict(model, unwrap=False))
+
+        # Save the optimizers taking care of FSDP and DeepSpeed nuances
+        optimizers = []
+        if self.distributed_type == DistributedType.FSDP:
+            for i, opt in enumerate(self._optimizers):
+                logger.info("Saving FSDP Optimizer")
+                save_fsdp_optimizer(self.state.fsdp_plugin, self, opt, self._models[i], output_dir, i)
+                logger.info(f"FSDP Optimizer saved to output dir {output_dir}")
+        elif self.distributed_type not in [DistributedType.DEEPSPEED, DistributedType.MEGATRON_LM]:
+            optimizers = self._optimizers
+
+        # Save the lr schedulers taking care of DeepSpeed nuances
+        schedulers = []
+        if self.distributed_type == DistributedType.DEEPSPEED:
+            for i, scheduler in enumerate(self._schedulers):
+                if isinstance(scheduler, DeepSpeedSchedulerWrapper):
+                    continue
+                schedulers.append(scheduler)
+        elif self.distributed_type not in [DistributedType.MEGATRON_LM]:
+            schedulers = self._schedulers
+
+        # Save the samplers of the dataloaders
+        dataloaders = self._dataloaders
+
+        # Call model loading hooks that might have been registered with
+        # accelerator.register_model_state_hook
+        for hook in self._save_model_state_pre_hook.values():
+            hook(self._models, weights, output_dir)
+
+        save_location = save_accelerator_state(
+            output_dir,
+            weights,
+            optimizers,
+            schedulers,
+            dataloaders,
+            self.state.process_index,
+            self.scaler,
+            save_on_each_node=self.project_configuration.save_on_each_node,
+            safe_serialization=safe_serialization,
+        )
+        for i, obj in enumerate(self._custom_objects):
+            save_custom_state(obj, output_dir, i, save_on_each_node=self.project_configuration.save_on_each_node)
+        self.project_configuration.iteration += 1
+        return save_location
+
+    def register_load_state_pre_hook(self, hook: Callable[..., None]) -> hooks.RemovableHandle:
+        """
+        Registers a pre hook to be run before [`load_checkpoint`] is called in [`Accelerator.load_state`].
+
+        Args:
+            hook (`Callable`):
+                A function to be called in [`Accelerator.load_state`] before `load_checkpoint`.
+
+        The hook should have the following signature:
+
+        `hook(models: list[torch.nn.Module], input_dir: str) -> None`
+
+        The `models` argument are the models as saved in the accelerator state under `accelerator._models`, and the
+        `input_dir` argument is the `input_dir` argument passed to [`Accelerator.load_state`].
+
+        <Tip>
+
+        Should only be used in conjunction with [`Accelerator.register_save_state_pre_hook`]. Can be useful to load
+        configurations in addition to model weights. Can also be used to overwrite model loading with a customized
+        method. In this case, make sure to remove already loaded models from the models list.
+
+        </Tip>
+
+        Returns:
+            `torch.utils.hooks.RemovableHandle`: a handle that can be used to remove the added hook by calling
+            `handle.remove()`
+        """
+        handle = hooks.RemovableHandle(self._load_model_state_pre_hook)
+        self._load_model_state_pre_hook[handle.id] = hook
+        return handle
+
+    def load_state(self, input_dir: str = None, **load_model_func_kwargs):
+        """
+        Loads the current states of the model, optimizer, scaler, RNG generators, and registered objects.
+
+        <Tip>
+
+        Should only be used in conjunction with [`Accelerator.save_state`]. If a file is not registered for
+        checkpointing, it will not be loaded if stored in the directory.
+
+        </Tip>
+
+        Args:
+            input_dir (`str` or `os.PathLike`):
+                The name of the folder all relevant weights and states were saved in. Can be `None` if
+                `automatic_checkpoint_naming` is used, and will pick up from the latest checkpoint.
+            load_model_func_kwargs (`dict`, *optional*):
+                Additional keyword arguments for loading model which can be passed to the underlying load function,
+                such as optional arguments for DeepSpeed's `load_checkpoint` function or a `map_location` to load the
+                model and optimizer on.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> model, optimizer, lr_scheduler = ...
+        >>> model, optimizer, lr_scheduler = accelerator.prepare(model, optimizer, lr_scheduler)
+        >>> accelerator.load_state("my_checkpoint")
+        ```
+        """
+        if input_dir is not None:
+            # Check if folder exists
+            input_dir = os.path.expanduser(input_dir)
+            if not os.path.isdir(input_dir):
+                raise ValueError(f"Tried to find {input_dir} but folder does not exist")
+        elif self.project_configuration.automatic_checkpoint_naming:
+            # Pick up from automatic checkpoint naming
+            input_dir = os.path.join(self.project_dir, "checkpoints")
+            folders = [os.path.join(input_dir, folder) for folder in os.listdir(input_dir)]
+
+            def _inner(folder):
+                return list(map(int, re.findall(r"[\/]?([0-9]+)(?=[^\/]*$)", folder)))[0]
+
+            folders.sort(key=_inner)
+            input_dir = folders[-1]
+        else:
+            raise ValueError("No input_dir provided and automatic checkpoint naming is disabled.")
+        logger.info(f"Loading states from {input_dir}")
+
+        # Load the models taking care of FSDP and DeepSpeed nuances
+        models = []
+        for i, model in enumerate(self._models):
+            if self.distributed_type == DistributedType.FSDP:
+                logger.info("Loading FSDP model")
+                load_fsdp_model(self.state.fsdp_plugin, self, model, input_dir, i)
+                logger.info(f"FSDP Model loaded from input dir {input_dir}")
+            elif self.distributed_type == DistributedType.DEEPSPEED:
+                logger.info("Loading DeepSpeed Model and Optimizer")
+                ckpt_id = f"{MODEL_NAME}" if i == 0 else f"{MODEL_NAME}_{i}"
+                model.load_checkpoint(input_dir, ckpt_id, **load_model_func_kwargs)
+                logger.info(f"DeepSpeed Model and Optimizer loaded from input dir {os.path.join(input_dir, ckpt_id)}")
+            elif self.distributed_type == DistributedType.MEGATRON_LM:
+                logger.info("Loading Megatron-LM Model, Optimizer and Scheduler")
+                model.load_checkpoint(input_dir)
+                logger.info(f"Megatron-LM Model , Optimizer and Scheduler loaded from input dir {input_dir}")
+            else:
+                models.append(model)
+
+        # Load the optimizers taking care of FSDP and DeepSpeed nuances
+        optimizers = []
+        if self.distributed_type == DistributedType.FSDP:
+            for i, opt in enumerate(self._optimizers):
+                logger.info("Loading FSDP Optimizer")
+                load_fsdp_optimizer(self.state.fsdp_plugin, self, opt, self._models[i], input_dir, i)
+                logger.info(f"FSDP Optimizer loaded from input dir {input_dir}")
+        elif self.distributed_type not in [DistributedType.DEEPSPEED, DistributedType.MEGATRON_LM]:
+            optimizers = self._optimizers
+
+        # Load the lr schedulers taking care of DeepSpeed nuances
+        schedulers = []
+        if self.distributed_type == DistributedType.DEEPSPEED:
+            for i, scheduler in enumerate(self._schedulers):
+                if isinstance(scheduler, DeepSpeedSchedulerWrapper):
+                    continue
+                schedulers.append(scheduler)
+        elif self.distributed_type not in [DistributedType.MEGATRON_LM]:
+            schedulers = self._schedulers
+
+        dataloaders = self._dataloaders
+
+        # Call model loading hooks that might have been registered with
+        # accelerator.register_model_state_hook
+        for hook in self._load_model_state_pre_hook.values():
+            hook(models, input_dir)
+
+        map_location = load_model_func_kwargs.pop("map_location", None)
+        if map_location is None:
+            if self.num_processes > 1 and self.distributed_type in (
+                DistributedType.MULTI_GPU,
+                DistributedType.MULTI_MLU,
+                DistributedType.MULTI_NPU,
+            ):
+                map_location = "on_device"
+            else:
+                map_location = "cpu"
+
+        load_accelerator_state(
+            input_dir,
+            models,
+            optimizers,
+            schedulers,
+            dataloaders,
+            self.state.process_index,
+            self.scaler,
+            map_location,
+            **load_model_func_kwargs,
+        )
+        custom_checkpoints = [
+            f for f in os.listdir(input_dir) if re.search(r"^custom_checkpoint_\d+\.pkl$", f) is not None
+        ]
+        if len(custom_checkpoints) != len(self._custom_objects):
+            err = "Number of custom checkpoints in folder {input_dir} does not match the number of registered objects:"
+            err += f"\n\tFound checkpoints: {len(custom_checkpoints)}"
+            err += f"\n\tRegistered objects: {len(self._custom_objects)}\n"
+            err += "Please make sure to only load checkpoints from folders that were created with the same set of registered objects,"
+            err += "or avoid using `custom_checkpoint` in the filename for files in that same directory and load them in manually."
+            raise RuntimeError(err)
+        else:
+            logger.info(f"Loading in {len(custom_checkpoints)} custom states")
+            for index, obj in enumerate(self._custom_objects):
+                load_custom_state(obj, input_dir, index)
+
+    def free_memory(self):
+        """
+        Will release all references to the internal objects stored and call the garbage collector. You should call this
+        method between two trainings with different models/optimizers. Also will reset `Accelerator.step` to 0.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> model, optimizer, scheduler = ...
+        >>> model, optimizer, scheduler = accelerator.prepare(model, optimizer, scheduler)
+        >>> accelerator.free_memory()
+        >>> del model, optimizer, scheduler
+        ```
+        """
+        self._schedulers = []
+        self._optimizers = []
+        self._models = []
+        self._dataloaders = []
+        self.deepspeed_engine_wrapped = None
+        self.step = 0
+        release_memory()
+
+    def clear(self):
+        """
+        Alias for [`Accelerate.free_memory`], releases all references to the internal objects stored and call the
+        garbage collector. You should call this method between two trainings with different models/optimizers.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> model, optimizer, scheduler = ...
+        >>> model, optimizer, scheduler = accelerator.prepare(model, optimizer, scheduler)
+        >>> accelerator.free_memory()
+        >>> del model, optimizer, scheduler
+        ```
+        """
+        self.free_memory()
+
+    def _get_named_parameters(self, *args):
+        named_parameters = {}
+        for obj in args:
+            if isinstance(obj, torch.nn.Module):
+                obj = extract_model_from_parallel(obj)
+                named_parameters.update({n: p for n, p in obj.named_parameters()})
+        return named_parameters
+
+    def _get_devices(self, *args):
+        model_device = None
+        optimizer_device = None
+        for obj in args:
+            # Loop through model parameters and stop at the first once we have its device.
+            if isinstance(obj, torch.nn.Module):
+                for param in obj.parameters():
+                    model_device = param.device
+                    break
+            # Loop through optimizer parameters groups and stop at the first once we have its device.
+            if isinstance(obj, torch.optim.Optimizer):
+                for param_group in obj.param_groups:
+                    if len(param_group["params"]) > 0:
+                        optimizer_device = param_group["params"][0].device
+                        break
+        return (model_device, optimizer_device)
+
+    def get_state_dict(self, model, unwrap=True):
+        """
+        Returns the state dictionary of a model sent through [`Accelerator.prepare`] potentially without full
+        precision.
+
+        Args:
+            model (`torch.nn.Module`):
+                A PyTorch model sent through [`Accelerator.prepare`]
+            unwrap (`bool`, *optional*, defaults to `True`):
+                Whether to return the original underlying state_dict of `model` or to return the wrapped state_dict
+
+        Returns:
+            `dict`: The state dictionary of the model potentially without full precision.
+
+        Example:
+
+        ```python
+        >>> import torch
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> net = torch.nn.Linear(2, 2)
+        >>> net = accelerator.prepare(net)
+        >>> state_dict = accelerator.get_state_dict(net)
+        ```
+        """
+
+        if self.distributed_type == DistributedType.DEEPSPEED:
+            if self.deepspeed_config["zero_optimization"]["stage"] == 3:
+                if model.zero_gather_16bit_weights_on_model_save():
+                    state_dict = model._zero3_consolidated_16bit_state_dict()
+                else:
+                    raise ValueError(
+                        "Cannot get 16bit model weights because `stage3_gather_16bit_weights_on_model_save` in DeepSpeed config is False. "
+                        "To save the model weights in 16bit, set `stage3_gather_16bit_weights_on_model_save` to True in DeepSpeed config file or "
+                        "set `zero3_save_16bit_model` to True when using `accelerate config`. "
+                        "To save the full checkpoint, run `model.save_checkpoint(save_dir)` and use `zero_to_fp32.py` to recover weights."
+                    )
+            else:
+                from deepspeed.checkpoint.utils import clone_tensors_for_torch_save
+
+                state_dict = clone_tensors_for_torch_save(self.unwrap_model(model).state_dict())
+        elif self.distributed_type == DistributedType.FSDP:
+            from torch.distributed.fsdp import FullStateDictConfig, StateDictType
+            from torch.distributed.fsdp import FullyShardedDataParallel as FSDP
+
+            full_state_dict_config = FullStateDictConfig(offload_to_cpu=True, rank0_only=True)
+            with FSDP.state_dict_type(model, StateDictType.FULL_STATE_DICT, full_state_dict_config):
+                state_dict = model.state_dict()
+        else:
+            if unwrap:
+                model = self.unwrap_model(model)
+            state_dict = model.state_dict()
+
+        return state_dict
+
+    def register_for_checkpointing(self, *objects):
+        """
+        Makes note of `objects` and will save or load them in during `save_state` or `load_state`.
+
+        These should be utilized when the state is being loaded or saved in the same script. It is not designed to be
+        used in different scripts.
+
+        <Tip>
+
+        Every `object` must have a `load_state_dict` and `state_dict` function to be stored.
+
+        </Tip>
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> # Assume `CustomObject` has a `state_dict` and `load_state_dict` function.
+        >>> obj = CustomObject()
+        >>> accelerator.register_for_checkpointing(obj)
+        >>> accelerator.save_state("checkpoint.pt")
+        ```
+        """
+        invalid_objects = []
+        for obj in objects:
+            if not hasattr(obj, "state_dict") or not hasattr(obj, "load_state_dict"):
+                invalid_objects.append(obj)
+        if len(invalid_objects) > 0:
+            err = "All `objects` must include a `state_dict` and `load_state_dict` function to be stored. The following inputs are invalid:"
+            for index, obj in enumerate(invalid_objects):
+                err += f"\n\t- Item at index {index}, `{get_pretty_name(obj)}`"
+            raise ValueError(err)
+        self._custom_objects.extend(objects)
+
+    @contextmanager
+    def autocast(self, cache_enabled: bool = False, autocast_handler: AutocastKwargs = None):
+        """
+        Will apply automatic mixed-precision inside the block inside this context manager, if it is enabled. Nothing
+        different will happen otherwise.
+
+        A different `autocast_handler` can be passed in to override the one set in the `Accelerator` object. This is
+        useful in blocks under `autocast` where you want to revert to fp32.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator(mixed_precision="fp16")
+        >>> with accelerator.autocast():
+        ...     train()
+        ```
+        """
+        if cache_enabled:
+            warnings.warn(
+                "Passing `cache_enabled=True` to `accelerator.autocast` is deprecated and will be removed in v0.23.0. "
+                "Please use the `AutocastKwargs` class instead and pass it to the `Accelerator` as a `kwarg_handler`.",
+                FutureWarning,
+            )
+            if self.autocast_handler is not None:
+                self.autocast_handler.cache_enabled = True
+            else:
+                self.autocast_handler = AutocastKwargs(cache_enabled=True)
+        if autocast_handler is None:
+            autocast_handler = self.autocast_handler
+        autocast_context = get_mixed_precision_context_manager(self.native_amp, autocast_handler)
+        autocast_context.__enter__()
+        # TODO: should the `yield` be in a try/finally block?
+        yield
+        autocast_context.__exit__(*sys.exc_info())
+
+    @property
+    def optimizer_step_was_skipped(self):
+        """
+        Whether or not the optimizer update was skipped (because of gradient overflow in mixed precision), in which
+        case the learning rate should not be changed.
+        """
+        for optimizer in self._optimizers:
+            if optimizer.step_was_skipped:
+                return True
+        return False
+
+    def skip_first_batches(self, dataloader, num_batches: int = 0):
+        """
+        Creates a new `torch.utils.data.DataLoader` that will efficiently skip the first `num_batches`.
+
+        Args:
+            dataloader (`torch.utils.data.DataLoader`): The data loader in which to skip batches.
+            num_batches (`int`, *optional*, defaults to 0): The number of batches to skip
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> dataloader, model, optimizer, scheduler = accelerator.prepare(dataloader, model, optimizer, scheduler)
+        >>> skipped_dataloader = accelerator.skip_first_batches(dataloader, num_batches=2)
+        >>> # for the first epoch only
+        >>> for input, target in skipped_dataloader:
+        ...     optimizer.zero_grad()
+        ...     output = model(input)
+        ...     loss = loss_func(output, target)
+        ...     accelerator.backward(loss)
+        ...     optimizer.step()
+
+        >>> # subsequent epochs
+        >>> for input, target in dataloader:
+        ...     optimizer.zero_grad()
+        ...     ...
+        ```
+        """
+        return skip_first_batches(dataloader, num_batches=num_batches)
+
+    def __deepcopy__(self, memo):
+        logger.info("Deep copying the `Accelerator` object, note that this will point to the same original object.")
+        return self
+
+    def verify_device_map(self, model: torch.nn.Module) -> bool:
+        """
+        Verifies that `model` has not been prepared with big model inference with a device-map resembling `auto`.
+        """
+        # Checks if any of the child modules has the attribute `hf_device_map` and this map has more than one entry.
+        for m in model.modules():
+            if hasattr(m, "hf_device_map") and len(m.hf_device_map) > 1:
+                return True
+
+        return False
diff --git a/llm/Lib/site-packages/accelerate/big_modeling.py b/llm/Lib/site-packages/accelerate/big_modeling.py
new file mode 100644
index 0000000000000000000000000000000000000000..94febb5d3dde35689d99ebbf26c1c78346f0ab17
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/big_modeling.py
@@ -0,0 +1,627 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import os
+from contextlib import contextmanager
+from functools import wraps
+from typing import Dict, List, Optional, Union
+
+import torch
+import torch.nn as nn
+
+from .hooks import (
+    AlignDevicesHook,
+    CpuOffload,
+    UserCpuOffloadHook,
+    add_hook_to_module,
+    attach_align_device_hook,
+    attach_align_device_hook_on_blocks,
+)
+from .utils import (
+    OffloadedWeightsLoader,
+    check_cuda_p2p_ib_support,
+    check_device_map,
+    extract_submodules_state_dict,
+    find_tied_parameters,
+    get_balanced_memory,
+    infer_auto_device_map,
+    is_mlu_available,
+    is_npu_available,
+    is_torch_version,
+    is_xpu_available,
+    load_checkpoint_in_model,
+    offload_state_dict,
+    parse_flag_from_env,
+    retie_parameters,
+)
+from .utils.other import recursive_getattr
+
+
+logger = logging.getLogger(__name__)
+
+
+@contextmanager
+def init_empty_weights(include_buffers: bool = None):
+    """
+    A context manager under which models are initialized with all parameters on the meta device, therefore creating an
+    empty model. Useful when just initializing the model would blow the available RAM.
+
+    Args:
+        include_buffers (`bool`, *optional*):
+            Whether or not to also put all buffers on the meta device while initializing.
+
+    Example:
+
+    ```python
+    import torch.nn as nn
+    from accelerate import init_empty_weights
+
+    # Initialize a model with 100 billions parameters in no time and without using any RAM.
+    with init_empty_weights():
+        tst = nn.Sequential(*[nn.Linear(10000, 10000) for _ in range(1000)])
+    ```
+
+    <Tip warning={true}>
+
+    Any model created under this context manager has no weights. As such you can't do something like
+    `model.to(some_device)` with it. To load weights inside your empty model, see [`load_checkpoint_and_dispatch`].
+    Make sure to overwrite the default device_map param for [`load_checkpoint_and_dispatch`], otherwise dispatch is not
+    called.
+
+    </Tip>
+    """
+    if include_buffers is None:
+        include_buffers = parse_flag_from_env("ACCELERATE_INIT_INCLUDE_BUFFERS", False)
+    with init_on_device(torch.device("meta"), include_buffers=include_buffers) as f:
+        yield f
+
+
+@contextmanager
+def init_on_device(device: torch.device, include_buffers: bool = None):
+    """
+    A context manager under which models are initialized with all parameters on the specified device.
+
+    Args:
+        device (`torch.device`):
+            Device to initialize all parameters on.
+        include_buffers (`bool`, *optional*):
+            Whether or not to also put all buffers on the meta device while initializing.
+
+    Example:
+
+    ```python
+    import torch.nn as nn
+    from accelerate import init_on_device
+
+    with init_on_device(device=torch.device("cuda")):
+        tst = nn.Liner(100, 100)  # on `cuda` device
+    ```
+    """
+    if include_buffers is None:
+        include_buffers = parse_flag_from_env("ACCELERATE_INIT_INCLUDE_BUFFERS", False)
+
+    # TODO(shingjan): remove the torch version check once older versions are deprecated
+    if is_torch_version(">=", "2.0") and include_buffers:
+        with device:
+            yield
+        return
+
+    old_register_parameter = nn.Module.register_parameter
+    if include_buffers:
+        old_register_buffer = nn.Module.register_buffer
+
+    def register_empty_parameter(module, name, param):
+        old_register_parameter(module, name, param)
+        if param is not None:
+            param_cls = type(module._parameters[name])
+            kwargs = module._parameters[name].__dict__
+            kwargs["requires_grad"] = param.requires_grad
+            module._parameters[name] = param_cls(module._parameters[name].to(device), **kwargs)
+
+    def register_empty_buffer(module, name, buffer, persistent=True):
+        old_register_buffer(module, name, buffer, persistent=persistent)
+        if buffer is not None:
+            module._buffers[name] = module._buffers[name].to(device)
+
+    # Patch tensor creation
+    if include_buffers:
+        tensor_constructors_to_patch = {
+            torch_function_name: getattr(torch, torch_function_name)
+            for torch_function_name in ["empty", "zeros", "ones", "full"]
+        }
+    else:
+        tensor_constructors_to_patch = {}
+
+    def patch_tensor_constructor(fn):
+        def wrapper(*args, **kwargs):
+            kwargs["device"] = device
+            return fn(*args, **kwargs)
+
+        return wrapper
+
+    try:
+        nn.Module.register_parameter = register_empty_parameter
+        if include_buffers:
+            nn.Module.register_buffer = register_empty_buffer
+        for torch_function_name in tensor_constructors_to_patch.keys():
+            setattr(torch, torch_function_name, patch_tensor_constructor(getattr(torch, torch_function_name)))
+        yield
+    finally:
+        nn.Module.register_parameter = old_register_parameter
+        if include_buffers:
+            nn.Module.register_buffer = old_register_buffer
+        for torch_function_name, old_torch_function in tensor_constructors_to_patch.items():
+            setattr(torch, torch_function_name, old_torch_function)
+
+
+def cpu_offload(
+    model: nn.Module,
+    execution_device: Optional[torch.device] = None,
+    offload_buffers: bool = False,
+    state_dict: Optional[Dict[str, torch.Tensor]] = None,
+    preload_module_classes: Optional[List[str]] = None,
+):
+    """
+    Activates full CPU offload for a model. As a result, all parameters of the model will be offloaded and only one
+    copy of the state dict of the model will be kept. During the forward pass, parameters will be extracted from that
+    state dict and put on the execution device passed as they are needed, then offloaded again.
+
+    Args:
+        model (`torch.nn.Module`):
+            The model to offload.
+        execution_device (`torch.device`, *optional*):
+            The device on which the forward pass of the model will be executed (should be a GPU). Will default to the
+            model first parameter device.
+        offload_buffers (`bool`, *optional*, defaults to `False`):
+            Whether or not to offload the buffers with the model parameters.
+        state_dict (`Dict[str, torch.Tensor]`, *optional*):
+            The state dict of the model that will be kept on CPU.
+        preload_module_classes (`List[str]`, *optional*):
+            A list of classes whose instances should load all their weights (even in the submodules) at the beginning
+            of the forward. This should only be used for classes that have submodules which are registered but not
+            called directly during the forward, for instance if a `dense` linear layer is registered, but at forward,
+            `dense.weight` and `dense.bias` are used in some operations instead of calling `dense` directly.
+    """
+    if execution_device is None:
+        execution_device = next(iter(model.parameters())).device
+    if state_dict is None:
+        state_dict = {n: p.to("cpu") for n, p in model.state_dict().items()}
+
+    add_hook_to_module(model, AlignDevicesHook(io_same_device=True), append=True)
+    attach_align_device_hook(
+        model,
+        execution_device=execution_device,
+        offload=True,
+        offload_buffers=offload_buffers,
+        weights_map=state_dict,
+        preload_module_classes=preload_module_classes,
+    )
+
+    return model
+
+
+def cpu_offload_with_hook(
+    model: torch.nn.Module,
+    execution_device: Optional[Union[int, str, torch.device]] = None,
+    prev_module_hook: Optional[UserCpuOffloadHook] = None,
+):
+    """
+    Offloads a model on the CPU and puts it back to an execution device when executed. The difference with
+    [`cpu_offload`] is that the model stays on the execution device after the forward and is only offloaded again when
+    the `offload` method of the returned `hook` is called. Useful for pipelines running a model in a loop.
+
+    Args:
+        model (`torch.nn.Module`):
+            The model to offload.
+        execution_device(`str`, `int` or `torch.device`, *optional*):
+            The device on which the model should be executed. Will default to the MPS device if it's available, then
+            GPU 0 if there is a GPU, and finally to the CPU.
+        prev_module_hook (`UserCpuOffloadHook`, *optional*):
+            The hook sent back by this function for a previous model in the pipeline you are running. If passed, its
+            offload method will be called just before the forward of the model to which this hook is attached.
+
+    Example:
+
+    ```py
+    model_1, hook_1 = cpu_offload_with_hook(model_1, cuda_device)
+    model_2, hook_2 = cpu_offload_with_hook(model_2, cuda_device, prev_module_hook=hook_1)
+    model_3, hook_3 = cpu_offload_with_hook(model_3, cuda_device, prev_module_hook=hook_2)
+
+    hid_1 = model_1(input)
+    for i in range(50):
+        # model1 is offloaded on the CPU at the first iteration, model 2 stays on the GPU for this whole loop.
+        hid_2 = model_2(hid_1)
+    # model2 is offloaded to the CPU just before this forward.
+    hid_3 = model_3(hid_3)
+
+    # For model3, you need to manually call the hook offload method.
+    hook_3.offload()
+    ```
+    """
+    hook = CpuOffload(execution_device=execution_device, prev_module_hook=prev_module_hook)
+    add_hook_to_module(model, hook, append=True)
+    user_hook = UserCpuOffloadHook(model, hook)
+    return model, user_hook
+
+
+def disk_offload(
+    model: nn.Module,
+    offload_dir: Union[str, os.PathLike],
+    execution_device: Optional[torch.device] = None,
+    offload_buffers: bool = False,
+    preload_module_classes: Optional[List[str]] = None,
+):
+    """
+    Activates full disk offload for a model. As a result, all parameters of the model will be offloaded as
+    memory-mapped array in a given folder. During the forward pass, parameters will be accessed from that folder and
+    put on the execution device passed as they are needed, then offloaded again.
+
+    Args:
+        model (`torch.nn.Module`): The model to offload.
+        offload_dir (`str` or `os.PathLike`):
+            The folder in which to offload the model weights (or where the model weights are already offloaded).
+        execution_device (`torch.device`, *optional*):
+            The device on which the forward pass of the model will be executed (should be a GPU). Will default to the
+            model's first parameter device.
+        offload_buffers (`bool`, *optional*, defaults to `False`):
+            Whether or not to offload the buffers with the model parameters.
+        preload_module_classes (`List[str]`, *optional*):
+            A list of classes whose instances should load all their weights (even in the submodules) at the beginning
+            of the forward. This should only be used for classes that have submodules which are registered but not
+            called directly during the forward, for instance if a `dense` linear layer is registered, but at forward,
+            `dense.weight` and `dense.bias` are used in some operations instead of calling `dense` directly.
+    """
+    if not os.path.isdir(offload_dir) or not os.path.isfile(os.path.join(offload_dir, "index.json")):
+        offload_state_dict(offload_dir, model.state_dict())
+    if execution_device is None:
+        execution_device = next(iter(model.parameters())).device
+    weights_map = OffloadedWeightsLoader(save_folder=offload_dir)
+
+    add_hook_to_module(model, AlignDevicesHook(io_same_device=True), append=True)
+    attach_align_device_hook(
+        model,
+        execution_device=execution_device,
+        offload=True,
+        offload_buffers=offload_buffers,
+        weights_map=weights_map,
+        preload_module_classes=preload_module_classes,
+    )
+
+    return model
+
+
+def dispatch_model(
+    model: nn.Module,
+    device_map: Dict[str, Union[str, int, torch.device]],
+    main_device: Optional[torch.device] = None,
+    state_dict: Optional[Dict[str, torch.Tensor]] = None,
+    offload_dir: Optional[Union[str, os.PathLike]] = None,
+    offload_index: Optional[Dict[str, str]] = None,
+    offload_buffers: bool = False,
+    skip_keys: Optional[Union[str, List[str]]] = None,
+    preload_module_classes: Optional[List[str]] = None,
+    force_hooks: bool = False,
+):
+    """
+    Dispatches a model according to a given device map. Layers of the model might be spread across GPUs, offloaded on
+    the CPU or even the disk.
+
+    Args:
+        model (`torch.nn.Module`):
+            The model to dispatch.
+        device_map (`Dict[str, Union[str, int, torch.device]]`):
+            A dictionary mapping module names in the models `state_dict` to the device they should go to. Note that
+            `"disk"` is accepted even if it's not a proper value for `torch.device`.
+        main_device (`str`, `int` or `torch.device`, *optional*):
+            The main execution device. Will default to the first device in the `device_map` different from `"cpu"` or
+            `"disk"`.
+        state_dict (`Dict[str, torch.Tensor]`, *optional*):
+            The state dict of the part of the model that will be kept on CPU.
+        offload_dir (`str` or `os.PathLike`):
+            The folder in which to offload the model weights (or where the model weights are already offloaded).
+        offload_index (`Dict`, *optional*):
+            A dictionary from weight name to their information (`dtype`/ `shape` or safetensors filename). Will default
+            to the index saved in `save_folder`.
+        offload_buffers (`bool`, *optional*, defaults to `False`):
+            Whether or not to offload the buffers with the model parameters.
+        skip_keys (`str` or `List[str]`, *optional*):
+            A list of keys to ignore when moving inputs or outputs between devices.
+        preload_module_classes (`List[str]`, *optional*):
+            A list of classes whose instances should load all their weights (even in the submodules) at the beginning
+            of the forward. This should only be used for classes that have submodules which are registered but not
+            called directly during the forward, for instance if a `dense` linear layer is registered, but at forward,
+            `dense.weight` and `dense.bias` are used in some operations instead of calling `dense` directly.
+        force_hooks (`bool`, *optional*, defaults to `False`):
+            Whether or not to force device hooks to be attached to the model even if all layers are dispatched to a
+            single device.
+    """
+    # Error early if the device map is incomplete.
+    check_device_map(model, device_map)
+
+    # for backward compatibility
+    is_bnb_quantized = (
+        getattr(model, "is_quantized", False) or getattr(model, "is_loaded_in_8bit", False)
+    ) and getattr(model, "quantization_method", "bitsandbytes") == "bitsandbytes"
+
+    # We attach hooks if the device_map has at least 2 different devices or if
+    # force_hooks is set to `True`. Otherwise, the model in already loaded
+    # in the unique device and the user can decide where to dispatch the model.
+    # If the model is quantized, we always force-dispatch the model
+    if (len(set(device_map.values())) > 1) or is_bnb_quantized or force_hooks:
+        if main_device is None:
+            if set(device_map.values()) == {"cpu"} or set(device_map.values()) == {"cpu", "disk"}:
+                main_device = "cpu"
+            else:
+                main_device = [d for d in device_map.values() if d not in ["cpu", "disk"]][0]
+
+        if main_device != "cpu":
+            cpu_modules = [name for name, device in device_map.items() if device == "cpu"]
+            if state_dict is None and len(cpu_modules) > 0:
+                state_dict = extract_submodules_state_dict(model.state_dict(), cpu_modules)
+
+        disk_modules = [name for name, device in device_map.items() if device == "disk"]
+        if offload_dir is None and offload_index is None and len(disk_modules) > 0:
+            raise ValueError(
+                "We need an `offload_dir` to dispatch this model according to this `device_map`, the following submodules "
+                f"need to be offloaded: {', '.join(disk_modules)}."
+            )
+        if (
+            len(disk_modules) > 0
+            and offload_index is None
+            and (not os.path.isdir(offload_dir) or not os.path.isfile(os.path.join(offload_dir, "index.json")))
+        ):
+            disk_state_dict = extract_submodules_state_dict(model.state_dict(), disk_modules)
+            offload_state_dict(offload_dir, disk_state_dict)
+
+        execution_device = {
+            name: main_device if device in ["cpu", "disk"] else device for name, device in device_map.items()
+        }
+        execution_device[""] = main_device
+        offloaded_devices = ["disk"] if main_device == "cpu" or main_device == "mps" else ["cpu", "disk"]
+        offload = {name: device in offloaded_devices for name, device in device_map.items()}
+        save_folder = offload_dir if len(disk_modules) > 0 else None
+        if state_dict is not None or save_folder is not None or offload_index is not None:
+            device = main_device if offload_index is not None else None
+            weights_map = OffloadedWeightsLoader(
+                state_dict=state_dict, save_folder=save_folder, index=offload_index, device=device
+            )
+        else:
+            weights_map = None
+
+        # When dispatching the model's parameters to the devices specified in device_map, we want to avoid allocating memory several times for the
+        # tied parameters. The dictionary tied_params_map keeps track of the already allocated data for a given tied parameter (represented by its
+        # original pointer) on each devices.
+        tied_params = find_tied_parameters(model)
+
+        tied_params_map = {}
+        for group in tied_params:
+            for param_name in group:
+                # data_ptr() is enough here, as `find_tied_parameters` finds tied params simply by comparing `param1 is param2`, so we don't need
+                # to care about views of tensors through storage_offset.
+                data_ptr = recursive_getattr(model, param_name).data_ptr()
+                tied_params_map[data_ptr] = {}
+
+                # Note: To handle the disk offloading case, we can not simply use weights_map[param_name].data_ptr() as the reference pointer,
+                # as we have no guarantee that safetensors' `file.get_tensor()` will always give the same pointer.
+
+        attach_align_device_hook_on_blocks(
+            model,
+            execution_device=execution_device,
+            offload=offload,
+            offload_buffers=offload_buffers,
+            weights_map=weights_map,
+            skip_keys=skip_keys,
+            preload_module_classes=preload_module_classes,
+            tied_params_map=tied_params_map,
+        )
+
+        # warn if there is any params on the meta device
+        offloaded_devices_str = " and ".join(
+            [device for device in set(device_map.values()) if device in ("cpu", "disk")]
+        )
+        if len(offloaded_devices_str) > 0:
+            logging.warning(
+                f"Some parameters are on the meta device device because they were offloaded to the {offloaded_devices_str}."
+            )
+
+        # Attaching the hook may break tied weights, so we retie them
+        retie_parameters(model, tied_params)
+
+        # add warning to cuda and to method
+        def add_warning(fn, model):
+            @wraps(fn)
+            def wrapper(*args, **kwargs):
+                warning_msg = "You shouldn't move a model that is dispatched using accelerate hooks."
+                if str(fn.__name__) == "to":
+                    to_device = torch._C._nn._parse_to(*args, **kwargs)[0]
+                    if to_device is not None:
+                        logger.warning(warning_msg)
+                else:
+                    logger.warning(warning_msg)
+                for param in model.parameters():
+                    if param.device == torch.device("meta"):
+                        raise RuntimeError("You can't move a model that has some modules offloaded to cpu or disk.")
+                return fn(*args, **kwargs)
+
+            return wrapper
+
+        model.to = add_warning(model.to, model)
+        if is_npu_available():
+            model.npu = add_warning(model.npu, model)
+        elif is_mlu_available():
+            model.mlu = add_warning(model.mlu, model)
+        elif is_xpu_available():
+            model.xpu = add_warning(model.xpu, model)
+        else:
+            model.cuda = add_warning(model.cuda, model)
+
+        # Check if we are using multi-gpus with RTX 4000 series
+        use_multi_gpu = len([device for device in set(device_map.values()) if device not in ("cpu", "disk")]) > 1
+        if use_multi_gpu and not check_cuda_p2p_ib_support():
+            logger.warning(
+                "We've detected an older driver with an RTX 4000 series GPU. These drivers have issues with P2P. "
+                "This can affect the multi-gpu inference when using accelerate device_map."
+                "Please make sure to update your driver to the latest version which resolves this."
+            )
+    else:
+        device = list(device_map.values())[0]
+        # `torch.Tensor.to(<int num>)` is not supported by `torch_npu` (see this [issue](https://github.com/Ascend/pytorch/issues/16)).
+        if is_npu_available() and isinstance(device, int):
+            device = f"npu:{device}"
+        elif is_mlu_available() and isinstance(device, int):
+            device = f"mlu:{device}"
+        elif is_xpu_available() and isinstance(device, int):
+            device = f"xpu:{device}"
+        if device != "disk":
+            model.to(device)
+        else:
+            raise ValueError(
+                "You are trying to offload the whole model to the disk. Please use the `disk_offload` function instead."
+            )
+    # Convert OrderedDict back to dict for easier usage
+    model.hf_device_map = dict(device_map)
+    return model
+
+
+def load_checkpoint_and_dispatch(
+    model: nn.Module,
+    checkpoint: Union[str, os.PathLike],
+    device_map: Optional[Union[str, Dict[str, Union[int, str, torch.device]]]] = None,
+    max_memory: Optional[Dict[Union[int, str], Union[int, str]]] = None,
+    no_split_module_classes: Optional[List[str]] = None,
+    offload_folder: Optional[Union[str, os.PathLike]] = None,
+    offload_buffers: bool = False,
+    dtype: Optional[Union[str, torch.dtype]] = None,
+    offload_state_dict: Optional[bool] = None,
+    skip_keys: Optional[Union[str, List[str]]] = None,
+    preload_module_classes: Optional[List[str]] = None,
+    force_hooks: bool = False,
+    strict: bool = False,
+):
+    """
+    Loads a (potentially sharded) checkpoint inside a model, potentially sending weights to a given device as they are
+    loaded and adds the various hooks that will make this model run properly (even if split across devices).
+
+    Args:
+        model (`torch.nn.Module`): The model in which we want to load a checkpoint.
+        checkpoint (`str` or `os.PathLike`):
+            The folder checkpoint to load. It can be:
+            - a path to a file containing a whole model state dict
+            - a path to a `.json` file containing the index to a sharded checkpoint
+            - a path to a folder containing a unique `.index.json` file and the shards of a checkpoint.
+        device_map (`Dict[str, Union[int, str, torch.device]]`, *optional*):
+            A map that specifies where each submodule should go. It doesn't need to be refined to each parameter/buffer
+            name, once a given module name is inside, every submodule of it will be sent to the same device.
+
+            To have Accelerate compute the most optimized `device_map` automatically, set `device_map="auto"`. For more
+            information about each option see [here](../concept_guides/big_model_inference#designing-a-device-map).
+            Defaults to None, which means [`dispatch_model`] will not be called.
+        max_memory (`Dict`, *optional*):
+            A dictionary device identifier to maximum memory. Will default to the maximum memory available for each GPU
+            and the available CPU RAM if unset.
+        no_split_module_classes (`List[str]`, *optional*):
+            A list of layer class names that should never be split across device (for instance any layer that has a
+            residual connection).
+        offload_folder (`str` or `os.PathLike`, *optional*):
+            If the `device_map` contains any value `"disk"`, the folder where we will offload weights.
+        offload_buffers (`bool`, *optional*, defaults to `False`):
+            In the layers that are offloaded on the CPU or the hard drive, whether or not to offload the buffers as
+            well as the parameters.
+        dtype (`str` or `torch.dtype`, *optional*):
+            If provided, the weights will be converted to that type when loaded.
+        offload_state_dict (`bool`, *optional*):
+            If `True`, will temporarily offload the CPU state dict on the hard drive to avoid getting out of CPU RAM if
+            the weight of the CPU state dict + the biggest shard does not fit. Will default to `True` if the device map
+            picked contains `"disk"` values.
+        skip_keys (`str` or `List[str]`, *optional*):
+            A list of keys to ignore when moving inputs or outputs between devices.
+        preload_module_classes (`List[str]`, *optional*):
+            A list of classes whose instances should load all their weights (even in the submodules) at the beginning
+            of the forward. This should only be used for classes that have submodules which are registered but not
+            called directly during the forward, for instance if a `dense` linear layer is registered, but at forward,
+            `dense.weight` and `dense.bias` are used in some operations instead of calling `dense` directly.
+        force_hooks (`bool`, *optional*, defaults to `False`):
+            Whether or not to force device hooks to be attached to the model even if all layers are dispatched to a
+            single device.
+        strict (`bool`, *optional*, defaults to `False`):
+            Whether to strictly enforce that the keys in the checkpoint state_dict match the keys of the model's
+            state_dict.
+
+    Example:
+
+    ```python
+    >>> from accelerate import init_empty_weights, load_checkpoint_and_dispatch
+    >>> from huggingface_hub import hf_hub_download
+    >>> from transformers import AutoConfig, AutoModelForCausalLM
+
+    >>> # Download the Weights
+    >>> checkpoint = "EleutherAI/gpt-j-6B"
+    >>> weights_location = hf_hub_download(checkpoint, "pytorch_model.bin")
+
+    >>> # Create a model and initialize it with empty weights
+    >>> config = AutoConfig.from_pretrained(checkpoint)
+    >>> with init_empty_weights():
+    ...     model = AutoModelForCausalLM.from_config(config)
+
+    >>> # Load the checkpoint and dispatch it to the right devices
+    >>> model = load_checkpoint_and_dispatch(
+    ...     model, weights_location, device_map="auto", no_split_module_classes=["GPTJBlock"]
+    ... )
+    ```
+    """
+    if isinstance(device_map, str) and device_map not in ["auto", "balanced", "balanced_low_0", "sequential"]:
+        raise ValueError(
+            "If passing a string for `device_map`, please choose 'auto', 'balanced', 'balanced_low_0' or "
+            "'sequential'."
+        )
+    if isinstance(device_map, str):
+        if device_map != "sequential":
+            max_memory = get_balanced_memory(
+                model,
+                max_memory=max_memory,
+                no_split_module_classes=no_split_module_classes,
+                dtype=dtype,
+                low_zero=(device_map == "balanced_low_0"),
+            )
+        device_map = infer_auto_device_map(
+            model,
+            max_memory=max_memory,
+            no_split_module_classes=no_split_module_classes,
+            dtype=dtype,
+            offload_buffers=offload_buffers,
+        )
+    if offload_state_dict is None and device_map is not None and "disk" in device_map.values():
+        offload_state_dict = True
+    load_checkpoint_in_model(
+        model,
+        checkpoint,
+        device_map=device_map,
+        offload_folder=offload_folder,
+        dtype=dtype,
+        offload_state_dict=offload_state_dict,
+        offload_buffers=offload_buffers,
+        strict=strict,
+    )
+    if device_map is None:
+        return model
+    return dispatch_model(
+        model,
+        device_map=device_map,
+        offload_dir=offload_folder,
+        offload_buffers=offload_buffers,
+        skip_keys=skip_keys,
+        preload_module_classes=preload_module_classes,
+        force_hooks=force_hooks,
+    )
diff --git a/llm/Lib/site-packages/accelerate/checkpointing.py b/llm/Lib/site-packages/accelerate/checkpointing.py
new file mode 100644
index 0000000000000000000000000000000000000000..307eca49d7c93dcbf450c3de5f5f356e11db1d51
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/checkpointing.py
@@ -0,0 +1,275 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import random
+from pathlib import Path
+from typing import List
+
+import numpy as np
+import torch
+from safetensors.torch import load_file
+from torch.cuda.amp import GradScaler
+
+from .utils import (
+    MODEL_NAME,
+    OPTIMIZER_NAME,
+    RNG_STATE_NAME,
+    SAFE_MODEL_NAME,
+    SAFE_WEIGHTS_NAME,
+    SAMPLER_NAME,
+    SCALER_NAME,
+    SCHEDULER_NAME,
+    WEIGHTS_NAME,
+    get_pretty_name,
+    is_torch_xla_available,
+    is_xpu_available,
+    save,
+)
+
+
+if is_torch_xla_available():
+    import torch_xla.core.xla_model as xm
+
+from .logging import get_logger
+from .state import PartialState
+
+
+logger = get_logger(__name__)
+
+
+def save_accelerator_state(
+    output_dir: str,
+    model_states: List[dict],
+    optimizers: list,
+    schedulers: list,
+    dataloaders: list,
+    process_index: int,
+    scaler: GradScaler = None,
+    save_on_each_node: bool = False,
+    safe_serialization: bool = True,
+):
+    """
+    Saves the current states of the models, optimizers, scaler, and RNG generators to a given directory.
+
+    <Tip>
+
+    If `safe_serialization` is `True`, models will be saved with `safetensors` while the rest are saved using native
+    `pickle`.
+
+    </Tip>
+
+    Args:
+        output_dir (`str` or `os.PathLike`):
+            The name of the folder to save all relevant weights and states.
+        model_states (`List[torch.nn.Module]`):
+            A list of model states
+        optimizers (`List[torch.optim.Optimizer]`):
+            A list of optimizer instances
+        schedulers (`List[torch.optim.lr_scheduler._LRScheduler]`):
+            A list of learning rate schedulers
+        dataloaders (`List[torch.utils.data.DataLoader]`):
+            A list of dataloader instances to save their sampler states
+        process_index (`int`):
+            The current process index in the Accelerator state
+        scaler (`torch.cuda.amp.GradScaler`, *optional*):
+            An optional gradient scaler instance to save
+        save_on_each_node (`bool`, *optional*):
+            Whether to save on every node, or only the main node.
+        safe_serialization (`bool`, *optional*, defaults to `True`):
+            Whether to save the model using `safetensors` or the traditional PyTorch way (that uses `pickle`).
+    """
+    output_dir = Path(output_dir)
+    # Model states
+    for i, state in enumerate(model_states):
+        weights_name = WEIGHTS_NAME if not safe_serialization else SAFE_WEIGHTS_NAME
+        if i > 0:
+            weights_name = weights_name.replace(".", f"_{i}.")
+        output_model_file = output_dir.joinpath(weights_name)
+        save(state, output_model_file, save_on_each_node=save_on_each_node, safe_serialization=safe_serialization)
+        logger.info(f"Model weights saved in {output_model_file}")
+    # Optimizer states
+    for i, opt in enumerate(optimizers):
+        state = opt.state_dict()
+        optimizer_name = f"{OPTIMIZER_NAME}.bin" if i == 0 else f"{OPTIMIZER_NAME}_{i}.bin"
+        output_optimizer_file = output_dir.joinpath(optimizer_name)
+        save(state, output_optimizer_file, save_on_each_node=save_on_each_node, safe_serialization=False)
+        logger.info(f"Optimizer state saved in {output_optimizer_file}")
+    # Scheduler states
+    for i, scheduler in enumerate(schedulers):
+        state = scheduler.state_dict()
+        scheduler_name = f"{SCHEDULER_NAME}.bin" if i == 0 else f"{SCHEDULER_NAME}_{i}.bin"
+        output_scheduler_file = output_dir.joinpath(scheduler_name)
+        save(state, output_scheduler_file, save_on_each_node=save_on_each_node, safe_serialization=False)
+        logger.info(f"Scheduler state saved in {output_scheduler_file}")
+    # DataLoader states
+    for i, dataloader in enumerate(dataloaders):
+        sampler_name = f"{SAMPLER_NAME}.bin" if i == 0 else f"{SAMPLER_NAME}_{i}.bin"
+        output_sampler_file = output_dir.joinpath(sampler_name)
+        # Only save if we have our custom sampler
+        from .data_loader import IterableDatasetShard, SeedableRandomSampler
+
+        if isinstance(dataloader.dataset, IterableDatasetShard):
+            sampler = dataloader.sampler.sampler
+
+            if isinstance(sampler, SeedableRandomSampler):
+                save(sampler, output_sampler_file, save_on_each_node=save_on_each_node, safe_serialization=False)
+        logger.info(f"Sampler state for dataloader {i} saved in {output_sampler_file}")
+
+    # GradScaler state
+    if scaler is not None:
+        state = scaler.state_dict()
+        output_scaler_file = output_dir.joinpath(SCALER_NAME)
+        torch.save(state, output_scaler_file)
+        logger.info(f"Gradient scaler state saved in {output_scaler_file}")
+    # Random number generator states
+    states = {}
+    states_name = f"{RNG_STATE_NAME}_{process_index}.pkl"
+    states["random_state"] = random.getstate()
+    states["numpy_random_seed"] = np.random.get_state()
+    states["torch_manual_seed"] = torch.get_rng_state()
+    if is_xpu_available():
+        states["torch_xpu_manual_seed"] = torch.xpu.get_rng_state_all()
+    else:
+        states["torch_cuda_manual_seed"] = torch.cuda.get_rng_state_all()
+    if is_torch_xla_available():
+        states["xm_seed"] = xm.get_rng_state()
+    output_states_file = output_dir.joinpath(states_name)
+    torch.save(states, output_states_file)
+    logger.info(f"Random states saved in {output_states_file}")
+    return output_dir
+
+
+def load_accelerator_state(
+    input_dir,
+    models,
+    optimizers,
+    schedulers,
+    dataloaders,
+    process_index,
+    scaler=None,
+    map_location=None,
+    **load_model_func_kwargs,
+):
+    """
+    Loads states of the models, optimizers, scaler, and RNG generators from a given directory.
+
+    Args:
+        input_dir (`str` or `os.PathLike`):
+            The name of the folder to load all relevant weights and states.
+        models (`List[torch.nn.Module]`):
+            A list of model instances
+        optimizers (`List[torch.optim.Optimizer]`):
+            A list of optimizer instances
+        schedulers (`List[torch.optim.lr_scheduler._LRScheduler]`):
+            A list of learning rate schedulers
+        process_index (`int`):
+            The current process index in the Accelerator state
+        scaler (`torch.cuda.amp.GradScaler`, *optional*):
+            An optional *GradScaler* instance to load
+        map_location (`str`, *optional*):
+            What device to load the optimizer state onto. Should be one of either "cpu" or "on_device".
+        load_model_func_kwargs (`dict`, *optional*):
+            Additional arguments that can be passed to the model's `load_state_dict` method.
+    """
+    if map_location not in [None, "cpu", "on_device"]:
+        raise TypeError(
+            "Unsupported optimizer map location passed, please choose one of `None`, `'cpu'`, or `'on_device'`"
+        )
+    if map_location is None:
+        map_location = "cpu"
+    elif map_location == "on_device":
+        map_location = PartialState().device
+
+    input_dir = Path(input_dir)
+    # Model states
+    for i, model in enumerate(models):
+        ending = f"_{i}" if i > 0 else ""
+        input_model_file = input_dir.joinpath(f"{SAFE_MODEL_NAME}{ending}.safetensors")
+        if input_model_file.exists():
+            state_dict = load_file(input_model_file, device=str(map_location))
+        else:
+            # Load with torch
+            input_model_file = input_dir.joinpath(f"{MODEL_NAME}{ending}.bin")
+            state_dict = torch.load(input_model_file, map_location=map_location)
+        models[i].load_state_dict(state_dict, **load_model_func_kwargs)
+    logger.info("All model weights loaded successfully")
+
+    # Optimizer states
+    for i, opt in enumerate(optimizers):
+        optimizer_name = f"{OPTIMIZER_NAME}.bin" if i == 0 else f"{OPTIMIZER_NAME}_{i}.bin"
+        input_optimizer_file = input_dir.joinpath(optimizer_name)
+        optimizer_state = torch.load(input_optimizer_file, map_location=map_location)
+        optimizers[i].load_state_dict(optimizer_state)
+    logger.info("All optimizer states loaded successfully")
+
+    # Scheduler states
+    for i, scheduler in enumerate(schedulers):
+        scheduler_name = f"{SCHEDULER_NAME}.bin" if i == 0 else f"{SCHEDULER_NAME}_{i}.bin"
+        input_scheduler_file = input_dir.joinpath(scheduler_name)
+        scheduler.load_state_dict(torch.load(input_scheduler_file))
+    logger.info("All scheduler states loaded successfully")
+
+    for i, dataloader in enumerate(dataloaders):
+        sampler_name = f"{SAMPLER_NAME}.bin" if i == 0 else f"{SAMPLER_NAME}_{i}.bin"
+        input_sampler_file = input_dir.joinpath(sampler_name)
+        # Only load if we have our custom sampler
+        from .data_loader import IterableDatasetShard, SeedableRandomSampler
+
+        if isinstance(dataloader.dataset, IterableDatasetShard):
+            sampler = dataloader.sampler.sampler
+
+            if isinstance(sampler, SeedableRandomSampler):
+                dataloader.sampler.sampler = torch.load(input_sampler_file)
+    logger.info("All dataloader sampler states loaded successfully")
+
+    # GradScaler state
+    if scaler is not None:
+        input_scaler_file = input_dir.joinpath(SCALER_NAME)
+        scaler.load_state_dict(torch.load(input_scaler_file))
+        logger.info("GradScaler state loaded successfully")
+
+    # Random states
+    try:
+        states = torch.load(input_dir.joinpath(f"{RNG_STATE_NAME}_{process_index}.pkl"))
+        random.setstate(states["random_state"])
+        np.random.set_state(states["numpy_random_seed"])
+        torch.set_rng_state(states["torch_manual_seed"])
+        if is_xpu_available():
+            torch.xpu.set_rng_state_all(states["torch_xpu_manual_seed"])
+        else:
+            torch.cuda.set_rng_state_all(states["torch_cuda_manual_seed"])
+        if is_torch_xla_available():
+            xm.set_rng_state(states["xm_seed"])
+        logger.info("All random states loaded successfully")
+    except Exception:
+        logger.info("Could not load random states")
+
+
+def save_custom_state(obj, path, index: int = 0, save_on_each_node: bool = False):
+    """
+    Saves the state of `obj` to `{path}/custom_checkpoint_{index}.pkl`
+    """
+    # Should this be the right way to get a qual_name type value from `obj`?
+    save_location = Path(path) / f"custom_checkpoint_{index}.pkl"
+    logger.info(f"Saving the state of {get_pretty_name(obj)} to {save_location}")
+    save(obj.state_dict(), save_location, save_on_each_node=save_on_each_node)
+
+
+def load_custom_state(obj, path, index: int = 0):
+    """
+    Loads the state of `obj` at `{path}/custom_checkpoint_{index}.pkl`
+    """
+    load_location = f"{path}/custom_checkpoint_{index}.pkl"
+    logger.info(f"Loading the state of {get_pretty_name(obj)} from {load_location}")
+    obj.load_state_dict(torch.load(load_location, map_location="cpu"))
diff --git a/llm/Lib/site-packages/accelerate/commands/__init__.py b/llm/Lib/site-packages/accelerate/commands/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c9cbe26c257b515f657c05e1996d517e69613972
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2020 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/llm/Lib/site-packages/accelerate/commands/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..16f1dd37ea9ae45a807168ac50f9b5a99628e94d
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/__pycache__/accelerate_cli.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/__pycache__/accelerate_cli.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..20e2f0736df3a79789a6de262213ceb64389273a
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/__pycache__/accelerate_cli.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/__pycache__/env.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/__pycache__/env.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6a17b281bee53bb5a87195cb2c6b81a1e11d6b86
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/__pycache__/env.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/__pycache__/estimate.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/__pycache__/estimate.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..63bb96c4f3df3012ca168b6f2450df84cd6bcd35
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/__pycache__/estimate.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/__pycache__/launch.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/__pycache__/launch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ad3e6d6061a8d0ced0cef3629fe33a44b4dcf76e
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/__pycache__/launch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/__pycache__/test.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/__pycache__/test.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..186ea10d6a3fe569bb52d21fbfa66ae628c57cc8
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/__pycache__/test.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/__pycache__/tpu.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/__pycache__/tpu.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cddd39cb881c428353b457d4861b78905b8d0817
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/__pycache__/tpu.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..369d72714263c32eca965e9c0b28a1bfcaa57777
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/accelerate_cli.py b/llm/Lib/site-packages/accelerate/commands/accelerate_cli.py
new file mode 100644
index 0000000000000000000000000000000000000000..ea5a08abf51a83ca048524ea0b8758f9d52b7edc
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/accelerate_cli.py
@@ -0,0 +1,50 @@
+#!/usr/bin/env python
+
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from accelerate.commands.config import get_config_parser
+from accelerate.commands.env import env_command_parser
+from accelerate.commands.estimate import estimate_command_parser
+from accelerate.commands.launch import launch_command_parser
+from accelerate.commands.test import test_command_parser
+from accelerate.commands.tpu import tpu_command_parser
+from accelerate.commands.utils import CustomArgumentParser
+
+
+def main():
+    parser = CustomArgumentParser("Accelerate CLI tool", usage="accelerate <command> [<args>]", allow_abbrev=False)
+    subparsers = parser.add_subparsers(help="accelerate command helpers")
+
+    # Register commands
+    get_config_parser(subparsers=subparsers)
+    estimate_command_parser(subparsers=subparsers)
+    env_command_parser(subparsers=subparsers)
+    launch_command_parser(subparsers=subparsers)
+    tpu_command_parser(subparsers=subparsers)
+    test_command_parser(subparsers=subparsers)
+
+    # Let's go
+    args = parser.parse_args()
+
+    if not hasattr(args, "func"):
+        parser.print_help()
+        exit(1)
+
+    # Run
+    args.func(args)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/commands/config/__init__.py b/llm/Lib/site-packages/accelerate/commands/config/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..649a15888cccd070b3d4ca9a600457c6ad59d4d3
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/config/__init__.py
@@ -0,0 +1,52 @@
+#!/usr/bin/env python
+
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import argparse
+
+from .config import config_command_parser
+from .config_args import default_config_file, load_config_from_file  # noqa: F401
+from .default import default_command_parser
+from .update import update_command_parser
+
+
+def get_config_parser(subparsers=None):
+    parent_parser = argparse.ArgumentParser(add_help=False, allow_abbrev=False)
+    # The main config parser
+    config_parser = config_command_parser(subparsers)
+    # The subparser to add commands to
+    subcommands = config_parser.add_subparsers(title="subcommands", dest="subcommand")
+
+    # Then add other parsers with the parent parser
+    default_command_parser(subcommands, parents=[parent_parser])
+    update_command_parser(subcommands, parents=[parent_parser])
+
+    return config_parser
+
+
+def main():
+    config_parser = get_config_parser()
+    args = config_parser.parse_args()
+
+    if not hasattr(args, "func"):
+        config_parser.print_help()
+        exit(1)
+
+    # Run
+    args.func(args)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/commands/config/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1c6fabb342858461f732a5716456b16dec63fc2f
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/config/__pycache__/cluster.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/cluster.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2472fe6a8424da9421a523772889851c677723e0
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/cluster.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/config/__pycache__/config.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/config.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..950488de2ef705da91a1f6cd562338dc3ff66c6b
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/config.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/config/__pycache__/config_args.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/config_args.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..688a26c2f6b1e5ed494de2f03f67a0cc2acdb4a7
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/config_args.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/config/__pycache__/config_utils.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/config_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f1972ef2332460ee2ee3197fcb6941c5cc54c6f3
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/config_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/config/__pycache__/default.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/default.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..da3ab55a3e2e9a5f4b866194ae171c7b6d81d22e
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/default.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/config/__pycache__/sagemaker.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/sagemaker.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f5c166519103ce1b7c178152205eec4363da8025
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/sagemaker.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/config/__pycache__/update.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/update.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b6ff6a2d7287a92c9a7b0eb014f2fc4606339c94
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/config/__pycache__/update.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/config/cluster.py b/llm/Lib/site-packages/accelerate/commands/config/cluster.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d8821b0660932a946dc238151b2c6599de625d1
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/config/cluster.py
@@ -0,0 +1,705 @@
+#!/usr/bin/env python
+
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+from ...utils import (
+    ComputeEnvironment,
+    DistributedType,
+    is_deepspeed_available,
+    is_mlu_available,
+    is_mps_available,
+    is_npu_available,
+    is_transformers_available,
+    is_xpu_available,
+)
+from ...utils.constants import (
+    DEEPSPEED_MULTINODE_LAUNCHERS,
+    FSDP_AUTO_WRAP_POLICY,
+    FSDP_BACKWARD_PREFETCH,
+    FSDP_SHARDING_STRATEGY,
+    FSDP_STATE_DICT_TYPE,
+    TORCH_DYNAMO_MODES,
+)
+from .config_args import ClusterConfig
+from .config_utils import (
+    DYNAMO_BACKENDS,
+    _ask_field,
+    _ask_options,
+    _convert_distributed_mode,
+    _convert_dynamo_backend,
+    _convert_mixed_precision,
+    _convert_yes_no_to_bool,
+)
+
+
+def get_cluster_input():
+    distributed_type = _ask_options(
+        "Which type of machine are you using?",
+        ["No distributed training", "multi-CPU", "multi-XPU", "multi-GPU", "multi-NPU", "multi-MLU", "TPU"],
+        _convert_distributed_mode,
+    )
+
+    machine_rank = 0
+    num_machines = 1
+    num_processes = 1
+    gpu_ids = None
+    main_process_ip = None
+    main_process_port = None
+    rdzv_backend = "static"
+    same_network = True
+    debug = False
+
+    if distributed_type in [
+        DistributedType.MULTI_GPU,
+        DistributedType.MULTI_MLU,
+        DistributedType.MULTI_NPU,
+        DistributedType.MULTI_XPU,
+        DistributedType.MULTI_CPU,
+    ]:
+        num_machines = _ask_field(
+            "How many different machines will you use (use more than 1 for multi-node training)? [1]: ",
+            int,
+            default=1,
+        )
+        if num_machines > 1:
+            machine_rank = _ask_options(
+                "What is the rank of this machine?",
+                list(range(num_machines)),
+                int,
+            )
+            main_process_ip = _ask_field(
+                "What is the IP address of the machine that will host the main process? ",
+            )
+            main_process_port = _ask_field(
+                "What is the port you will use to communicate with the main process? ",
+                int,
+            )
+            same_network = _ask_field(
+                "Are all the machines on the same local network? Answer `no` if nodes are on the cloud and/or on different network hosts [YES/no]: ",
+                _convert_yes_no_to_bool,
+                default=True,
+                error_message="Please enter yes or no.",
+            )
+            if not same_network:
+                rdzv_backend = _ask_field(
+                    "What rendezvous backend will you use? ('static', 'c10d', ...): ", default="static"
+                )
+        debug = _ask_field(
+            "Should distributed operations be checked while running for errors? This can avoid timeout issues but will be slower. [yes/NO]: ",
+            _convert_yes_no_to_bool,
+            default=False,
+            error_message="Please enter yes or no.",
+        )
+
+    if distributed_type == DistributedType.NO:
+        use_cpu = _ask_field(
+            "Do you want to run your training on CPU only (even if a GPU / Apple Silicon / Ascend NPU device is available)? [yes/NO]:",
+            _convert_yes_no_to_bool,
+            default=False,
+            error_message="Please enter yes or no.",
+        )
+    elif distributed_type == DistributedType.MULTI_CPU:
+        use_cpu = True
+    else:
+        use_cpu = False
+
+    ipex_config = {}
+    mpirun_config = {}
+    if use_cpu:
+        ipex_config["ipex"] = _ask_field(
+            "Do you want to use Intel PyTorch Extension (IPEX) to speed up training on CPU? [yes/NO]:",
+            _convert_yes_no_to_bool,
+            default=False,
+            error_message="Please enter yes or no.",
+        )
+        if distributed_type == DistributedType.MULTI_CPU:
+            use_mpirun = _ask_field(
+                "Do you want accelerate to launch mpirun? [yes/NO]: ",
+                _convert_yes_no_to_bool,
+                default=False,
+                error_message="Please enter yes or no.",
+            )
+            if use_mpirun:
+                mpirun_hostfile = _ask_field(
+                    "Please enter the path to the hostfile to use with mpirun [~/hostfile]: ",
+                    str,
+                    default="~/hostfile",
+                )
+                mpirun_config["mpirun_hostfile"] = os.path.expanduser(mpirun_hostfile.strip())
+                mpirun_config["mpirun_ccl"] = _ask_field("Enter the number of oneCCL worker threads [1]: ", default=1)
+    if (
+        not use_cpu
+        and is_xpu_available()
+        and distributed_type
+        not in [DistributedType.MULTI_GPU, DistributedType.MULTI_NPU, DistributedType.MULTI_MLU, DistributedType.XLA]
+    ):
+        ipex_config["use_xpu"] = _ask_field(
+            "Do you want to use XPU plugin to speed up training on XPU? [yes/NO]:",
+            _convert_yes_no_to_bool,
+            default=False,
+            error_message="Please enter yes or no.",
+        )
+
+    dynamo_config = {}
+    use_dynamo = _ask_field(
+        "Do you wish to optimize your script with torch dynamo?[yes/NO]:",
+        _convert_yes_no_to_bool,
+        default=False,
+        error_message="Please enter yes or no.",
+    )
+    if use_dynamo:
+        prefix = "dynamo_"
+        dynamo_config[prefix + "backend"] = _ask_options(
+            "Which dynamo backend would you like to use?",
+            [x.lower() for x in DYNAMO_BACKENDS],
+            _convert_dynamo_backend,
+            default=2,
+        )
+        use_custom_options = _ask_field(
+            "Do you want to customize the defaults sent to torch.compile? [yes/NO]: ",
+            _convert_yes_no_to_bool,
+            default=False,
+            error_message="Please enter yes or no.",
+        )
+
+        if use_custom_options:
+            dynamo_config[prefix + "mode"] = _ask_options(
+                "Which mode do you want to use?",
+                TORCH_DYNAMO_MODES,
+                lambda x: TORCH_DYNAMO_MODES[int(x)],
+                default=0,
+            )
+            dynamo_config[prefix + "use_fullgraph"] = _ask_field(
+                "Do you want the fullgraph mode or it is ok to break model into several subgraphs? [yes/NO]: ",
+                _convert_yes_no_to_bool,
+                default=False,
+                error_message="Please enter yes or no.",
+            )
+            dynamo_config[prefix + "use_dynamic"] = _ask_field(
+                "Do you want to enable dynamic shape tracing? [yes/NO]: ",
+                _convert_yes_no_to_bool,
+                default=False,
+                error_message="Please enter yes or no.",
+            )
+
+    use_mps = not use_cpu and is_mps_available()
+    deepspeed_config = {}
+    if (
+        distributed_type
+        in [
+            DistributedType.MULTI_GPU,
+            DistributedType.MULTI_XPU,
+            DistributedType.MULTI_NPU,
+            DistributedType.MULTI_MLU,
+            DistributedType.NO,
+        ]
+        and not use_mps
+    ):
+        use_deepspeed = _ask_field(
+            "Do you want to use DeepSpeed? [yes/NO]: ",
+            _convert_yes_no_to_bool,
+            default=False,
+            error_message="Please enter yes or no.",
+        )
+        if use_deepspeed:
+            distributed_type = DistributedType.DEEPSPEED
+            assert (
+                is_deepspeed_available()
+            ), "DeepSpeed is not installed => run `pip3 install deepspeed` or build it from source"
+
+        if distributed_type == DistributedType.DEEPSPEED:
+            use_deepspeed_config = _ask_field(
+                "Do you want to specify a json file to a DeepSpeed config? [yes/NO]: ",
+                _convert_yes_no_to_bool,
+                default=False,
+                error_message="Please enter yes or no.",
+            )
+            if use_deepspeed_config:
+                deepspeed_config["deepspeed_config_file"] = _ask_field(
+                    "Please enter the path to the json DeepSpeed config file: ",
+                    str,
+                    default="none",
+                )
+            else:
+                deepspeed_config["zero_stage"] = _ask_options(
+                    "What should be your DeepSpeed's ZeRO optimization stage?",
+                    [0, 1, 2, 3],
+                    int,
+                    default=2,
+                )
+
+                deepspeed_devices = ["none", "cpu", "nvme"]
+                if deepspeed_config["zero_stage"] >= 2:
+                    deepspeed_config["offload_optimizer_device"] = _ask_options(
+                        "Where to offload optimizer states?", deepspeed_devices, lambda x: deepspeed_devices[int(x)]
+                    )
+                    deepspeed_config["offload_param_device"] = _ask_options(
+                        "Where to offload parameters?", deepspeed_devices, lambda x: deepspeed_devices[int(x)]
+                    )
+                    if deepspeed_config["offload_param_device"] == "nvme":
+                        deepspeed_config["offload_param_nvme_path"] = _ask_field(
+                            "Nvme Path to offload parameters?",
+                            str,
+                            default="/nvme",
+                        )
+                    if deepspeed_config["offload_optimizer_device"] == "nvme":
+                        deepspeed_config["offload_optimizer_nvme_path"] = _ask_field(
+                            "Nvme Path to offload optimizer states?",
+                            str,
+                            default="/nvme",
+                        )
+                deepspeed_config["gradient_accumulation_steps"] = _ask_field(
+                    "How many gradient accumulation steps you're passing in your script? [1]: ",
+                    int,
+                    default=1,
+                )
+                use_gradient_clipping = _ask_field(
+                    "Do you want to use gradient clipping? [yes/NO]: ",
+                    _convert_yes_no_to_bool,
+                    default=False,
+                    error_message="Please enter yes or no.",
+                )
+                if use_gradient_clipping:
+                    deepspeed_config["gradient_clipping"] = _ask_field(
+                        "What is the gradient clipping value? [1.0]: ",
+                        float,
+                        default=1.0,
+                    )
+                if deepspeed_config["zero_stage"] == 3:
+                    deepspeed_config["zero3_save_16bit_model"] = _ask_field(
+                        "Do you want to save 16-bit model weights when using ZeRO Stage-3? [yes/NO]: ",
+                        _convert_yes_no_to_bool,
+                        default=False,
+                        error_message="Please enter yes or no.",
+                    )
+            deepspeed_config["zero3_init_flag"] = _ask_field(
+                "Do you want to enable `deepspeed.zero.Init` when using ZeRO Stage-3 for constructing massive models? [yes/NO]: ",
+                _convert_yes_no_to_bool,
+                default=False,
+                error_message="Please enter yes or no.",
+            )
+            if deepspeed_config["zero3_init_flag"]:
+                if not is_transformers_available():
+                    raise Exception(
+                        "When `zero3_init_flag` is set, it requires Transformers to be installed. "
+                        "Please run `pip3 install transformers`."
+                    )
+
+            if num_machines > 1:
+                launcher_query = "Which Type of launcher do you want to use?"
+                deepspeed_config["deepspeed_multinode_launcher"] = _ask_options(
+                    launcher_query,
+                    DEEPSPEED_MULTINODE_LAUNCHERS,
+                    lambda x: DEEPSPEED_MULTINODE_LAUNCHERS[int(x)],
+                )
+
+                if deepspeed_config["deepspeed_multinode_launcher"] != DEEPSPEED_MULTINODE_LAUNCHERS[1]:
+                    deepspeed_config["deepspeed_hostfile"] = _ask_field(
+                        "DeepSpeed configures multi-node compute resources with hostfile. "
+                        "Each row is of the format `hostname slots=[num_gpus]`, e.g., `localhost slots=2`; "
+                        "for more information please refer official [documentation]"
+                        "(https://www.deepspeed.ai/getting-started/#resource-configuration-multi-node). "
+                        "Please specify the location of hostfile: ",
+                        str,
+                    )
+
+                    is_exclusion_filter = _ask_field(
+                        "Do you want to specify exclusion filter string? [yes/NO]: ",
+                        _convert_yes_no_to_bool,
+                        default=False,
+                        error_message="Please enter yes or no.",
+                    )
+                    if is_exclusion_filter:
+                        deepspeed_config["deepspeed_exclusion_filter"] = _ask_field(
+                            "DeepSpeed exclusion filter string: ",
+                            str,
+                        )
+
+                    is_inclusion_filter = _ask_field(
+                        "Do you want to specify inclusion filter string? [yes/NO]: ",
+                        _convert_yes_no_to_bool,
+                        default=False,
+                        error_message="Please enter yes or no.",
+                    )
+                    if is_inclusion_filter:
+                        deepspeed_config["deepspeed_inclusion_filter"] = _ask_field(
+                            "DeepSpeed inclusion filter string: ",
+                            str,
+                        )
+
+    fsdp_config = {}
+    if distributed_type in [
+        DistributedType.MULTI_GPU,
+        DistributedType.MULTI_NPU,
+        DistributedType.MULTI_MLU,
+        DistributedType.MULTI_XPU,
+    ]:
+        use_fsdp = _ask_field(
+            "Do you want to use FullyShardedDataParallel? [yes/NO]: ",
+            _convert_yes_no_to_bool,
+            default=False,
+            error_message="Please enter yes or no.",
+        )
+        if use_fsdp:
+            distributed_type = DistributedType.FSDP
+        if distributed_type == DistributedType.FSDP:
+            sharding_strategy_query = "What should be your sharding strategy?"
+            fsdp_config["fsdp_sharding_strategy"] = _ask_options(
+                sharding_strategy_query,
+                FSDP_SHARDING_STRATEGY,
+                lambda x: FSDP_SHARDING_STRATEGY[int(x)],
+            )
+            fsdp_config["fsdp_offload_params"] = _ask_field(
+                "Do you want to offload parameters and gradients to CPU? [yes/NO]: ",
+                _convert_yes_no_to_bool,
+                default=False,
+                error_message="Please enter yes or no.",
+            )
+            fsdp_wrap_query = "What should be your auto wrap policy?"
+            fsdp_config["fsdp_auto_wrap_policy"] = _ask_options(
+                fsdp_wrap_query,
+                FSDP_AUTO_WRAP_POLICY,
+                lambda x: FSDP_AUTO_WRAP_POLICY[int(x)],
+            )
+            if fsdp_config["fsdp_auto_wrap_policy"] == FSDP_AUTO_WRAP_POLICY[0]:
+                use_no_split_modules = _ask_field(
+                    "Do you want to use the model's `_no_split_modules` to wrap. Only applicable for 🤗 Transformers [yes/NO]: ",
+                    _convert_yes_no_to_bool,
+                    default=False,
+                    error_message="Please enter yes or no.",
+                )
+                if not use_no_split_modules:
+                    fsdp_config["fsdp_transformer_layer_cls_to_wrap"] = _ask_field(
+                        "Specify the comma-separated list of transformer layer class names (case-sensitive) to wrap ,e.g, :"
+                        "`BertLayer`, `GPTJBlock`, `T5Block`, `BertLayer,BertEmbeddings,BertSelfOutput` ...? : ",
+                        str,
+                    )
+            elif fsdp_config["fsdp_auto_wrap_policy"] == FSDP_AUTO_WRAP_POLICY[1]:
+                fsdp_config["fsdp_min_num_params"] = _ask_field(
+                    "What should be your FSDP's minimum number of parameters for Default Auto Wrapping Policy? [1e8]: ",
+                    int,
+                    default=100000000,
+                )
+            fsdp_backward_prefetch_query = "What should be your FSDP's backward prefetch policy?"
+            fsdp_config["fsdp_backward_prefetch"] = _ask_options(
+                fsdp_backward_prefetch_query,
+                FSDP_BACKWARD_PREFETCH,
+                lambda x: FSDP_BACKWARD_PREFETCH[int(x)],
+            )
+            fsdp_state_dict_type_query = "What should be your FSDP's state dict type?"
+            fsdp_config["fsdp_state_dict_type"] = _ask_options(
+                fsdp_state_dict_type_query,
+                FSDP_STATE_DICT_TYPE,
+                lambda x: FSDP_STATE_DICT_TYPE[int(x)],
+                default=2,
+            )
+            fsdp_config["fsdp_forward_prefetch"] = _ask_field(
+                "Do you want to enable FSDP's forward prefetch policy? [yes/NO]: ",
+                _convert_yes_no_to_bool,
+                default=False,
+                error_message="Please enter yes or no.",
+            )
+            fsdp_config["fsdp_use_orig_params"] = _ask_field(
+                "Do you want to enable FSDP's `use_orig_params` feature? [YES/no]: ",
+                _convert_yes_no_to_bool,
+                default=True,
+                error_message="Please enter yes or no.",
+            )
+            fsdp_config["fsdp_cpu_ram_efficient_loading"] = _ask_field(
+                "Do you want to enable CPU RAM efficient model loading? Only applicable for 🤗 Transformers models. [YES/no]: ",
+                _convert_yes_no_to_bool,
+                default=True,
+                error_message="Please enter yes or no.",
+            )
+            if fsdp_config["fsdp_cpu_ram_efficient_loading"]:
+                fsdp_config["fsdp_sync_module_states"] = True
+            else:
+                fsdp_config["fsdp_sync_module_states"] = _ask_field(
+                    "Do you want each individually wrapped FSDP unit to broadcast module parameters from rank 0 at the start? [YES/no]: ",
+                    _convert_yes_no_to_bool,
+                    default=True,
+                    error_message="Please enter yes or no.",
+                )
+
+    megatron_lm_config = {}
+    if distributed_type in [DistributedType.MULTI_GPU]:
+        use_megatron_lm = _ask_field(
+            "Do you want to use Megatron-LM ? [yes/NO]: ",
+            _convert_yes_no_to_bool,
+            default=False,
+            error_message="Please enter yes or no.",
+        )
+        if use_megatron_lm:
+            distributed_type = DistributedType.MEGATRON_LM
+        if distributed_type == DistributedType.MEGATRON_LM:
+            prefix = "megatron_lm_"
+            megatron_lm_config[prefix + "tp_degree"] = _ask_field(
+                "What is the Tensor Parallelism degree/size? [1]:",
+                int,
+                default=1,
+                error_message="Please enter an integer.",
+            )
+            if megatron_lm_config[prefix + "tp_degree"] > 1:
+                megatron_lm_config[prefix + "sequence_parallelism"] = _ask_field(
+                    "Do you want to enable Sequence Parallelism? [YES/no]: ",
+                    _convert_yes_no_to_bool,
+                    default=True,
+                    error_message="Please enter yes or no.",
+                )
+
+            megatron_lm_config[prefix + "pp_degree"] = _ask_field(
+                "What is the Pipeline Parallelism degree/size? [1]:",
+                int,
+                default=1,
+                error_message="Please enter an integer.",
+            )
+            if megatron_lm_config[prefix + "pp_degree"] > 1:
+                megatron_lm_config[prefix + "num_micro_batches"] = _ask_field(
+                    "What is the number of micro-batches? [1]:",
+                    int,
+                    default=1,
+                    error_message="Please enter an integer.",
+                )
+
+            megatron_lm_config[prefix + "recompute_activations"] = _ask_field(
+                "Do you want to enable selective activation recomputation? [YES/no]: ",
+                _convert_yes_no_to_bool,
+                default=True,
+                error_message="Please enter yes or no.",
+            )
+
+            megatron_lm_config[prefix + "use_distributed_optimizer"] = _ask_field(
+                "Do you want to use distributed optimizer "
+                "which shards optimizer state and gradients across data parallel ranks? [YES/no]: ",
+                _convert_yes_no_to_bool,
+                default=True,
+                error_message="Please enter yes or no.",
+            )
+
+            megatron_lm_config[prefix + "gradient_clipping"] = _ask_field(
+                "What is the gradient clipping value based on global L2 Norm (0 to disable)? [1.0]: ",
+                float,
+                default=1.0,
+            )
+    # TPU specific defaults
+    tpu_commands = None
+    tpu_command_file = None
+    tpu_downcast_bf16 = "no"
+    tpu_env = []
+    tpu_name = None
+    tpu_vm = None
+    tpu_zone = None
+    tpu_use_sudo = False
+    tpu_use_cluster = False
+
+    if distributed_type in [
+        DistributedType.MULTI_CPU,
+        DistributedType.MULTI_XPU,
+        DistributedType.MULTI_GPU,
+        DistributedType.MULTI_MLU,
+        DistributedType.MULTI_NPU,
+        DistributedType.XLA,
+    ]:
+        machine_type = str(distributed_type).split(".")[1].replace("MULTI_", "")
+        if machine_type == "TPU":
+            machine_type += " cores"
+        elif machine_type == "CPU":
+            machine_type = "processes"
+        else:
+            machine_type += "(s)"
+        num_processes = _ask_field(
+            f"How many {machine_type} should be used for distributed training? [1]:",
+            int,
+            default=1,
+            error_message="Please enter an integer.",
+        )
+    elif distributed_type in [DistributedType.FSDP, DistributedType.DEEPSPEED, DistributedType.MEGATRON_LM]:
+        num_processes = _ask_field(
+            "How many GPU(s) should be used for distributed training? [1]:",
+            int,
+            default=1,
+            error_message="Please enter an integer.",
+        )
+    else:
+        num_processes = 1
+
+    if (distributed_type == DistributedType.MULTI_GPU) and (num_machines == 1) and (num_processes == 1):
+        raise ValueError(
+            f"Specified distributed type {distributed_type} but only using 1 GPU on a single machine. Please select `No distributed training` for the type of machine you are using."
+        )
+
+    if (
+        distributed_type
+        in [
+            DistributedType.MULTI_GPU,
+            DistributedType.MULTI_MLU,
+            DistributedType.MULTI_NPU,
+            DistributedType.MULTI_XPU,
+            DistributedType.NO,
+        ]
+        and not use_cpu
+        and not use_mps
+    ):
+        if is_npu_available():
+            machine_type = "NPU(s)"
+        elif is_mlu_available():
+            machine_type = "MLU(s)"
+        else:
+            machine_type = "GPU(s)"
+        gpu_ids = _ask_field(
+            f"What {machine_type} (by id) should be used for training on this machine as a comma-seperated list? [all]:",
+            default="all",
+        )
+
+    # CPU affinity is only supported on NVIDIA hardware for now
+    enable_cpu_affinity = False
+    if distributed_type == (DistributedType.NO, DistributedType.MULTI_GPU) and not use_cpu and not use_mps:
+        enable_cpu_affinity = _ask_field(
+            "Would you like to enable numa efficiency? (Currently only supported on NVIDIA hardware). [yes/NO]: ",
+            _convert_yes_no_to_bool,
+            default=False,
+            error_message="Please enter yes or no.",
+        )
+
+    if distributed_type == DistributedType.XLA:
+        mixed_precision = "no"
+        main_training_function = _ask_field(
+            "What is the name of the function in your script that should be launched in all parallel scripts? [main]: ",
+            default="main",
+        )
+        tpu_use_cluster = _ask_field(
+            "Are you using a TPU cluster? [yes/NO]: ",
+            _convert_yes_no_to_bool,
+            default=False,
+            error_message="Please enter yes or no.",
+        )
+        if tpu_use_cluster:
+            tpu_name = _ask_field(
+                "What is the name of your TPU cluster? ",
+                default=None,
+                error_message="Please enter the name of your TPU cluster.",
+            )
+            tpu_zone = _ask_field(
+                "What is the zone of your TPU cluster? ",
+                default=None,
+                error_message="Please enter the zone of your TPU cluster.",
+            )
+            tpu_use_sudo = _ask_field(
+                "To run a python script in a TPU pod, should `sudo` be used? [yes/NO]: ",
+                default=False,
+                error_message="Please enter yes or no.",
+            )
+            run_commands = _ask_field(
+                "Do you have code you wish to run on startup in each pod? [yes/NO]: ",
+                _convert_yes_no_to_bool,
+                default=False,
+                error_message="Please enter yes or no.",
+            )
+            if run_commands:
+                use_command_file = _ask_field(
+                    "Is this code located in a bash script? [yes/NO]: ",
+                    _convert_yes_no_to_bool,
+                    default=False,
+                    error_message="Please enter yes or no.",
+                )
+                if use_command_file:
+                    tpu_command_file = _ask_field(
+                        "What is the path to your bash script? ",
+                        default=None,
+                        error_message="Please enter the path to your bash script.",
+                    )
+                    tpu_command_file = os.path.abspath(tpu_command_file)
+                else:
+                    print("Please enter each command seperately you wish to run on startup in each pod.")
+                    tpu_commands = []
+                    another_command = True
+                    while another_command:
+                        tpu_commands.append(
+                            _ask_field(
+                                "Please enter a single command to be ran ",
+                                default=None,
+                                error_message="Please enter the commands you wish to run on startup in each pod as a single string.",
+                            )
+                        )
+                        another_command = _ask_field(
+                            "Do you wish to add another command? [yes/NO]: ",
+                            _convert_yes_no_to_bool,
+                            default=False,
+                            error_message="Please enter yes or no.",
+                        )
+            tpu_vm = _ask_field(
+                "If not using an instance group, what are the names of the Compute VM instances to be used, seperated by a comma: ",
+                default="",
+            ).split(",")
+            tpu_env = _ask_field(
+                "What environment variables do you wish to set in each pod, seperated by a comma: ",
+                default="",
+            ).split(",")
+
+    else:
+        main_training_function = "main"
+        if distributed_type == DistributedType.DEEPSPEED and use_deepspeed_config:
+            mixed_precision = None
+        else:
+            mixed_precision = _ask_options(
+                "Do you wish to use FP16 or BF16 (mixed precision)?",
+                ["no", "fp16", "bf16", "fp8"],
+                _convert_mixed_precision,
+            )
+
+    if use_dynamo and mixed_precision == "no" and not use_cpu:
+        print(
+            "Torch dynamo used without mixed precision requires TF32 to be efficient. Accelerate will enable it by default when launching your scripts."
+        )
+
+    if distributed_type == DistributedType.XLA and mixed_precision == "bf16":
+        tpu_downcast_bf16 = _ask_field(
+            "Should `torch.float` be cast as `bfloat16` and `torch.double` remain `float32` on TPUs?", default="no"
+        )
+
+    return ClusterConfig(
+        compute_environment=ComputeEnvironment.LOCAL_MACHINE,
+        distributed_type=distributed_type,
+        num_processes=num_processes,
+        gpu_ids=gpu_ids,
+        mixed_precision=mixed_precision,
+        downcast_bf16=tpu_downcast_bf16,
+        machine_rank=machine_rank,
+        num_machines=num_machines,
+        main_process_ip=main_process_ip,
+        main_process_port=main_process_port,
+        main_training_function=main_training_function,
+        deepspeed_config=deepspeed_config,
+        fsdp_config=fsdp_config,
+        megatron_lm_config=megatron_lm_config,
+        ipex_config=ipex_config,
+        mpirun_config=mpirun_config,
+        use_cpu=use_cpu,
+        rdzv_backend=rdzv_backend,
+        same_network=same_network,
+        commands=tpu_commands,
+        command_file=tpu_command_file,
+        tpu_env=tpu_env,
+        tpu_name=tpu_name,
+        tpu_vm=tpu_vm,
+        tpu_zone=tpu_zone,
+        tpu_use_sudo=tpu_use_sudo,
+        tpu_use_cluster=tpu_use_cluster,
+        dynamo_config=dynamo_config,
+        debug=debug,
+        enable_cpu_affinity=enable_cpu_affinity,
+    )
diff --git a/llm/Lib/site-packages/accelerate/commands/config/config.py b/llm/Lib/site-packages/accelerate/commands/config/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..72414f2abe62d76bd5133f4b0ed99bf34133f6f6
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/config/config.py
@@ -0,0 +1,89 @@
+#!/usr/bin/env python
+
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import argparse
+import os
+
+from accelerate.utils import ComputeEnvironment
+
+from .cluster import get_cluster_input
+from .config_args import cache_dir, default_config_file, default_yaml_config_file, load_config_from_file  # noqa: F401
+from .config_utils import _ask_field, _ask_options, _convert_compute_environment  # noqa: F401
+from .sagemaker import get_sagemaker_input
+
+
+description = "Launches a series of prompts to create and save a `default_config.yaml` configuration file for your training system. Should always be ran first on your machine"
+
+
+def get_user_input():
+    compute_environment = _ask_options(
+        "In which compute environment are you running?",
+        ["This machine", "AWS (Amazon SageMaker)"],
+        _convert_compute_environment,
+    )
+    if compute_environment == ComputeEnvironment.AMAZON_SAGEMAKER:
+        config = get_sagemaker_input()
+    else:
+        config = get_cluster_input()
+    return config
+
+
+def config_command_parser(subparsers=None):
+    if subparsers is not None:
+        parser = subparsers.add_parser("config", description=description)
+    else:
+        parser = argparse.ArgumentParser("Accelerate config command", description=description)
+
+    parser.add_argument(
+        "--config_file",
+        default=None,
+        help=(
+            "The path to use to store the config file. Will default to a file named default_config.yaml in the cache "
+            "location, which is the content of the environment `HF_HOME` suffixed with 'accelerate', or if you don't have "
+            "such an environment variable, your cache directory ('~/.cache' or the content of `XDG_CACHE_HOME`) suffixed "
+            "with 'huggingface'."
+        ),
+    )
+
+    if subparsers is not None:
+        parser.set_defaults(func=config_command)
+    return parser
+
+
+def config_command(args):
+    config = get_user_input()
+    if args.config_file is not None:
+        config_file = args.config_file
+    else:
+        if not os.path.isdir(cache_dir):
+            os.makedirs(cache_dir)
+        config_file = default_yaml_config_file
+
+    if config_file.endswith(".json"):
+        config.to_json_file(config_file)
+    else:
+        config.to_yaml_file(config_file)
+    print(f"accelerate configuration saved at {config_file}")
+
+
+def main():
+    parser = config_command_parser()
+    args = parser.parse_args()
+    config_command(args)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/commands/config/config_args.py b/llm/Lib/site-packages/accelerate/commands/config/config_args.py
new file mode 100644
index 0000000000000000000000000000000000000000..c50f1c34a42d354903a80b506290958807a7b7c0
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/config/config_args.py
@@ -0,0 +1,243 @@
+#!/usr/bin/env python
+
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import os
+from dataclasses import dataclass
+from enum import Enum
+from typing import List, Optional, Union
+
+import yaml
+
+from ...utils import ComputeEnvironment, DistributedType, SageMakerDistributedType
+from ...utils.constants import SAGEMAKER_PYTHON_VERSION, SAGEMAKER_PYTORCH_VERSION, SAGEMAKER_TRANSFORMERS_VERSION
+
+
+hf_cache_home = os.path.expanduser(
+    os.environ.get("HF_HOME", os.path.join(os.environ.get("XDG_CACHE_HOME", "~/.cache"), "huggingface"))
+)
+cache_dir = os.path.join(hf_cache_home, "accelerate")
+default_json_config_file = os.path.join(cache_dir, "default_config.yaml")
+default_yaml_config_file = os.path.join(cache_dir, "default_config.yaml")
+
+# For backward compatibility: the default config is the json one if it's the only existing file.
+if os.path.isfile(default_yaml_config_file) or not os.path.isfile(default_json_config_file):
+    default_config_file = default_yaml_config_file
+else:
+    default_config_file = default_json_config_file
+
+
+def load_config_from_file(config_file):
+    if config_file is not None:
+        if not os.path.isfile(config_file):
+            raise FileNotFoundError(
+                f"The passed configuration file `{config_file}` does not exist. "
+                "Please pass an existing file to `accelerate launch`, or use the default one "
+                "created through `accelerate config` and run `accelerate launch` "
+                "without the `--config_file` argument."
+            )
+    else:
+        config_file = default_config_file
+    with open(config_file, encoding="utf-8") as f:
+        if config_file.endswith(".json"):
+            if (
+                json.load(f).get("compute_environment", ComputeEnvironment.LOCAL_MACHINE)
+                == ComputeEnvironment.LOCAL_MACHINE
+            ):
+                config_class = ClusterConfig
+            else:
+                config_class = SageMakerConfig
+            return config_class.from_json_file(json_file=config_file)
+        else:
+            if (
+                yaml.safe_load(f).get("compute_environment", ComputeEnvironment.LOCAL_MACHINE)
+                == ComputeEnvironment.LOCAL_MACHINE
+            ):
+                config_class = ClusterConfig
+            else:
+                config_class = SageMakerConfig
+            return config_class.from_yaml_file(yaml_file=config_file)
+
+
+@dataclass
+class BaseConfig:
+    compute_environment: ComputeEnvironment
+    distributed_type: Union[DistributedType, SageMakerDistributedType]
+    mixed_precision: str
+    use_cpu: bool
+    debug: bool
+
+    def to_dict(self):
+        result = self.__dict__
+        # For serialization, it's best to convert Enums to strings (or their underlying value type).
+        for key, value in result.items():
+            if isinstance(value, Enum):
+                result[key] = value.value
+            if isinstance(value, dict) and not bool(value):
+                result[key] = None
+        result = {k: v for k, v in result.items() if v is not None}
+        return result
+
+    @classmethod
+    def from_json_file(cls, json_file=None):
+        json_file = default_json_config_file if json_file is None else json_file
+        with open(json_file, encoding="utf-8") as f:
+            config_dict = json.load(f)
+        if "compute_environment" not in config_dict:
+            config_dict["compute_environment"] = ComputeEnvironment.LOCAL_MACHINE
+        if "mixed_precision" not in config_dict:
+            config_dict["mixed_precision"] = "fp16" if ("fp16" in config_dict and config_dict["fp16"]) else None
+        if "fp16" in config_dict:  # Convert the config to the new format.
+            del config_dict["fp16"]
+        if "dynamo_backend" in config_dict:  # Convert the config to the new format.
+            dynamo_backend = config_dict.pop("dynamo_backend")
+            config_dict["dynamo_config"] = {} if dynamo_backend == "NO" else {"dynamo_backend": dynamo_backend}
+        if "use_cpu" not in config_dict:
+            config_dict["use_cpu"] = False
+        if "debug" not in config_dict:
+            config_dict["debug"] = False
+        if "enable_cpu_affinity" not in config_dict:
+            config_dict["enable_cpu_affinity"] = False
+        extra_keys = sorted(set(config_dict.keys()) - set(cls.__dataclass_fields__.keys()))
+        if len(extra_keys) > 0:
+            raise ValueError(
+                f"The config file at {json_file} had unknown keys ({extra_keys}), please try upgrading your `accelerate`"
+                " version or fix (and potentially remove) these keys from your config file."
+            )
+
+        return cls(**config_dict)
+
+    def to_json_file(self, json_file):
+        with open(json_file, "w", encoding="utf-8") as f:
+            content = json.dumps(self.to_dict(), indent=2, sort_keys=True) + "\n"
+            f.write(content)
+
+    @classmethod
+    def from_yaml_file(cls, yaml_file=None):
+        yaml_file = default_yaml_config_file if yaml_file is None else yaml_file
+        with open(yaml_file, encoding="utf-8") as f:
+            config_dict = yaml.safe_load(f)
+        if "compute_environment" not in config_dict:
+            config_dict["compute_environment"] = ComputeEnvironment.LOCAL_MACHINE
+        if "mixed_precision" not in config_dict:
+            config_dict["mixed_precision"] = "fp16" if ("fp16" in config_dict and config_dict["fp16"]) else None
+        if isinstance(config_dict["mixed_precision"], bool) and not config_dict["mixed_precision"]:
+            config_dict["mixed_precision"] = "no"
+        if "fp16" in config_dict:  # Convert the config to the new format.
+            del config_dict["fp16"]
+        if "dynamo_backend" in config_dict:  # Convert the config to the new format.
+            dynamo_backend = config_dict.pop("dynamo_backend")
+            config_dict["dynamo_config"] = {} if dynamo_backend == "NO" else {"dynamo_backend": dynamo_backend}
+        if "use_cpu" not in config_dict:
+            config_dict["use_cpu"] = False
+        if "debug" not in config_dict:
+            config_dict["debug"] = False
+        if "enable_cpu_affinity" not in config_dict:
+            config_dict["enable_cpu_affinity"] = False
+        extra_keys = sorted(set(config_dict.keys()) - set(cls.__dataclass_fields__.keys()))
+        if len(extra_keys) > 0:
+            raise ValueError(
+                f"The config file at {yaml_file} had unknown keys ({extra_keys}), please try upgrading your `accelerate`"
+                " version or fix (and potentially remove) these keys from your config file."
+            )
+        return cls(**config_dict)
+
+    def to_yaml_file(self, yaml_file):
+        with open(yaml_file, "w", encoding="utf-8") as f:
+            yaml.safe_dump(self.to_dict(), f)
+
+    def __post_init__(self):
+        if isinstance(self.compute_environment, str):
+            self.compute_environment = ComputeEnvironment(self.compute_environment)
+        if isinstance(self.distributed_type, str):
+            if self.compute_environment == ComputeEnvironment.AMAZON_SAGEMAKER:
+                self.distributed_type = SageMakerDistributedType(self.distributed_type)
+            else:
+                self.distributed_type = DistributedType(self.distributed_type)
+        if getattr(self, "dynamo_config", None) is None:
+            self.dynamo_config = {}
+
+
+@dataclass
+class ClusterConfig(BaseConfig):
+    num_processes: int
+    machine_rank: int = 0
+    num_machines: int = 1
+    gpu_ids: Optional[str] = None
+    main_process_ip: Optional[str] = None
+    main_process_port: Optional[int] = None
+    rdzv_backend: Optional[str] = "static"
+    same_network: Optional[bool] = False
+    main_training_function: str = "main"
+    enable_cpu_affinity: bool = False
+
+    # args for deepspeed_plugin
+    deepspeed_config: dict = None
+    # args for fsdp
+    fsdp_config: dict = None
+    # args for megatron_lm
+    megatron_lm_config: dict = None
+    # args for ipex
+    ipex_config: dict = None
+    # args for mpirun
+    mpirun_config: dict = None
+    # args for TPU
+    downcast_bf16: bool = False
+
+    # args for TPU pods
+    tpu_name: str = None
+    tpu_zone: str = None
+    tpu_use_cluster: bool = False
+    tpu_use_sudo: bool = False
+    command_file: str = None
+    commands: List[str] = None
+    tpu_vm: List[str] = None
+    tpu_env: List[str] = None
+
+    # args for dynamo
+    dynamo_config: dict = None
+
+    def __post_init__(self):
+        if self.deepspeed_config is None:
+            self.deepspeed_config = {}
+        if self.fsdp_config is None:
+            self.fsdp_config = {}
+        if self.megatron_lm_config is None:
+            self.megatron_lm_config = {}
+        if self.ipex_config is None:
+            self.ipex_config = {}
+        if self.mpirun_config is None:
+            self.mpirun_config = {}
+        return super().__post_init__()
+
+
+@dataclass
+class SageMakerConfig(BaseConfig):
+    ec2_instance_type: str
+    iam_role_name: str
+    image_uri: Optional[str] = None
+    profile: Optional[str] = None
+    region: str = "us-east-1"
+    num_machines: int = 1
+    gpu_ids: str = "all"
+    base_job_name: str = f"accelerate-sagemaker-{num_machines}"
+    pytorch_version: str = SAGEMAKER_PYTORCH_VERSION
+    transformers_version: str = SAGEMAKER_TRANSFORMERS_VERSION
+    py_version: str = SAGEMAKER_PYTHON_VERSION
+    sagemaker_inputs_file: str = None
+    sagemaker_metrics_file: str = None
+    additional_args: dict = None
+    dynamo_config: dict = None
diff --git a/llm/Lib/site-packages/accelerate/commands/config/config_utils.py b/llm/Lib/site-packages/accelerate/commands/config/config_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..091da5b03c771bccefc2cd21b047536fbc07bcbf
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/config/config_utils.py
@@ -0,0 +1,101 @@
+#!/usr/bin/env python
+
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import argparse
+
+from ...utils.dataclasses import (
+    ComputeEnvironment,
+    DistributedType,
+    DynamoBackend,
+    PrecisionType,
+    SageMakerDistributedType,
+)
+from ..menu import BulletMenu
+
+
+DYNAMO_BACKENDS = [
+    "EAGER",
+    "AOT_EAGER",
+    "INDUCTOR",
+    "AOT_TS_NVFUSER",
+    "NVPRIMS_NVFUSER",
+    "CUDAGRAPHS",
+    "OFI",
+    "FX2TRT",
+    "ONNXRT",
+    "TENSORRT",
+    "IPEX",
+    "TVM",
+]
+
+
+def _ask_field(input_text, convert_value=None, default=None, error_message=None):
+    ask_again = True
+    while ask_again:
+        result = input(input_text)
+        try:
+            if default is not None and len(result) == 0:
+                return default
+            return convert_value(result) if convert_value is not None else result
+        except Exception:
+            if error_message is not None:
+                print(error_message)
+
+
+def _ask_options(input_text, options=[], convert_value=None, default=0):
+    menu = BulletMenu(input_text, options)
+    result = menu.run(default_choice=default)
+    return convert_value(result) if convert_value is not None else result
+
+
+def _convert_compute_environment(value):
+    value = int(value)
+    return ComputeEnvironment(["LOCAL_MACHINE", "AMAZON_SAGEMAKER"][value])
+
+
+def _convert_distributed_mode(value):
+    value = int(value)
+    return DistributedType(["NO", "MULTI_CPU", "MULTI_XPU", "MULTI_GPU", "MULTI_NPU", "MULTI_MLU", "XLA"][value])
+
+
+def _convert_dynamo_backend(value):
+    value = int(value)
+    return DynamoBackend(DYNAMO_BACKENDS[value]).value
+
+
+def _convert_mixed_precision(value):
+    value = int(value)
+    return PrecisionType(["no", "fp16", "bf16", "fp8"][value])
+
+
+def _convert_sagemaker_distributed_mode(value):
+    value = int(value)
+    return SageMakerDistributedType(["NO", "DATA_PARALLEL", "MODEL_PARALLEL"][value])
+
+
+def _convert_yes_no_to_bool(value):
+    return {"yes": True, "no": False}[value.lower()]
+
+
+class SubcommandHelpFormatter(argparse.RawDescriptionHelpFormatter):
+    """
+    A custom formatter that will remove the usage line from the help message for subcommands.
+    """
+
+    def _format_usage(self, usage, actions, groups, prefix):
+        usage = super()._format_usage(usage, actions, groups, prefix)
+        usage = usage.replace("<command> [<args>] ", "")
+        return usage
diff --git a/llm/Lib/site-packages/accelerate/commands/config/default.py b/llm/Lib/site-packages/accelerate/commands/config/default.py
new file mode 100644
index 0000000000000000000000000000000000000000..e33331b98e6c8eacbaf8e9710b40e2ca6fc88b3d
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/config/default.py
@@ -0,0 +1,133 @@
+#!/usr/bin/env python
+
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from pathlib import Path
+
+import torch
+
+from ...utils import is_mlu_available, is_npu_available, is_xpu_available
+from .config_args import ClusterConfig, default_json_config_file
+from .config_utils import SubcommandHelpFormatter
+
+
+description = "Create a default config file for Accelerate with only a few flags set."
+
+
+def write_basic_config(mixed_precision="no", save_location: str = default_json_config_file, use_xpu: bool = False):
+    """
+    Creates and saves a basic cluster config to be used on a local machine with potentially multiple GPUs. Will also
+    set CPU if it is a CPU-only machine.
+
+    Args:
+        mixed_precision (`str`, *optional*, defaults to "no"):
+            Mixed Precision to use. Should be one of "no", "fp16", or "bf16"
+        save_location (`str`, *optional*, defaults to `default_json_config_file`):
+            Optional custom save location. Should be passed to `--config_file` when using `accelerate launch`. Default
+            location is inside the huggingface cache folder (`~/.cache/huggingface`) but can be overriden by setting
+            the `HF_HOME` environmental variable, followed by `accelerate/default_config.yaml`.
+        use_xpu (`bool`, *optional*, defaults to `False`):
+            Whether to use XPU if available.
+    """
+    path = Path(save_location)
+    path.parent.mkdir(parents=True, exist_ok=True)
+    if path.exists():
+        print(
+            f"Configuration already exists at {save_location}, will not override. Run `accelerate config` manually or pass a different `save_location`."
+        )
+        return False
+    mixed_precision = mixed_precision.lower()
+    if mixed_precision not in ["no", "fp16", "bf16", "fp8"]:
+        raise ValueError(
+            f"`mixed_precision` should be one of 'no', 'fp16', 'bf16', or 'fp8'. Received {mixed_precision}"
+        )
+    config = {
+        "compute_environment": "LOCAL_MACHINE",
+        "mixed_precision": mixed_precision,
+    }
+    if is_mlu_available():
+        num_mlus = torch.mlu.device_count()
+        config["num_processes"] = num_mlus
+        config["use_cpu"] = False
+        if num_mlus > 1:
+            config["distributed_type"] = "MULTI_MLU"
+        else:
+            config["distributed_type"] = "NO"
+    elif torch.cuda.is_available():
+        num_gpus = torch.cuda.device_count()
+        config["num_processes"] = num_gpus
+        config["use_cpu"] = False
+        if num_gpus > 1:
+            config["distributed_type"] = "MULTI_GPU"
+        else:
+            config["distributed_type"] = "NO"
+    elif is_xpu_available() and use_xpu:
+        num_xpus = torch.xpu.device_count()
+        config["num_processes"] = num_xpus
+        config["use_cpu"] = False
+        if num_xpus > 1:
+            config["distributed_type"] = "MULTI_XPU"
+        else:
+            config["distributed_type"] = "NO"
+    elif is_npu_available():
+        num_npus = torch.npu.device_count()
+        config["num_processes"] = num_npus
+        config["use_cpu"] = False
+        if num_npus > 1:
+            config["distributed_type"] = "MULTI_NPU"
+        else:
+            config["distributed_type"] = "NO"
+    else:
+        num_xpus = 0
+        config["use_cpu"] = True
+        config["num_processes"] = 1
+        config["distributed_type"] = "NO"
+    config["debug"] = False
+    config = ClusterConfig(**config)
+    config.to_json_file(path)
+    return path
+
+
+def default_command_parser(parser, parents):
+    parser = parser.add_parser("default", parents=parents, help=description, formatter_class=SubcommandHelpFormatter)
+    parser.add_argument(
+        "--config_file",
+        default=default_json_config_file,
+        help=(
+            "The path to use to store the config file. Will default to a file named default_config.yaml in the cache "
+            "location, which is the content of the environment `HF_HOME` suffixed with 'accelerate', or if you don't have "
+            "such an environment variable, your cache directory ('~/.cache' or the content of `XDG_CACHE_HOME`) suffixed "
+            "with 'huggingface'."
+        ),
+        dest="save_location",
+    )
+
+    parser.add_argument(
+        "--mixed_precision",
+        choices=["no", "fp16", "bf16"],
+        type=str,
+        help="Whether or not to use mixed precision training. "
+        "Choose between FP16 and BF16 (bfloat16) training. "
+        "BF16 training is only supported on Nvidia Ampere GPUs and PyTorch 1.10 or later.",
+        default="no",
+    )
+    parser.set_defaults(func=default_config_command)
+    return parser
+
+
+def default_config_command(args):
+    config_file = write_basic_config(args.mixed_precision, args.save_location)
+    if config_file:
+        print(f"accelerate configuration saved at {config_file}")
diff --git a/llm/Lib/site-packages/accelerate/commands/config/sagemaker.py b/llm/Lib/site-packages/accelerate/commands/config/sagemaker.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e3491fee0ad28df82683a89d128bbc097053c2f
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/config/sagemaker.py
@@ -0,0 +1,267 @@
+#!/usr/bin/env python
+
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import json
+import os
+
+from ...utils.constants import SAGEMAKER_PARALLEL_EC2_INSTANCES, TORCH_DYNAMO_MODES
+from ...utils.dataclasses import ComputeEnvironment, SageMakerDistributedType
+from ...utils.imports import is_boto3_available
+from .config_args import SageMakerConfig
+from .config_utils import (
+    DYNAMO_BACKENDS,
+    _ask_field,
+    _ask_options,
+    _convert_dynamo_backend,
+    _convert_mixed_precision,
+    _convert_sagemaker_distributed_mode,
+    _convert_yes_no_to_bool,
+)
+
+
+if is_boto3_available():
+    import boto3  # noqa: F401
+
+
+def _create_iam_role_for_sagemaker(role_name):
+    iam_client = boto3.client("iam")
+
+    sagemaker_trust_policy = {
+        "Version": "2012-10-17",
+        "Statement": [
+            {"Effect": "Allow", "Principal": {"Service": "sagemaker.amazonaws.com"}, "Action": "sts:AssumeRole"}
+        ],
+    }
+    try:
+        # create the role, associated with the chosen trust policy
+        iam_client.create_role(
+            RoleName=role_name, AssumeRolePolicyDocument=json.dumps(sagemaker_trust_policy, indent=2)
+        )
+        policy_document = {
+            "Version": "2012-10-17",
+            "Statement": [
+                {
+                    "Effect": "Allow",
+                    "Action": [
+                        "sagemaker:*",
+                        "ecr:GetDownloadUrlForLayer",
+                        "ecr:BatchGetImage",
+                        "ecr:BatchCheckLayerAvailability",
+                        "ecr:GetAuthorizationToken",
+                        "cloudwatch:PutMetricData",
+                        "cloudwatch:GetMetricData",
+                        "cloudwatch:GetMetricStatistics",
+                        "cloudwatch:ListMetrics",
+                        "logs:CreateLogGroup",
+                        "logs:CreateLogStream",
+                        "logs:DescribeLogStreams",
+                        "logs:PutLogEvents",
+                        "logs:GetLogEvents",
+                        "s3:CreateBucket",
+                        "s3:ListBucket",
+                        "s3:GetBucketLocation",
+                        "s3:GetObject",
+                        "s3:PutObject",
+                    ],
+                    "Resource": "*",
+                }
+            ],
+        }
+        # attach policy to role
+        iam_client.put_role_policy(
+            RoleName=role_name,
+            PolicyName=f"{role_name}_policy_permission",
+            PolicyDocument=json.dumps(policy_document, indent=2),
+        )
+    except iam_client.exceptions.EntityAlreadyExistsException:
+        print(f"role {role_name} already exists. Using existing one")
+
+
+def _get_iam_role_arn(role_name):
+    iam_client = boto3.client("iam")
+    return iam_client.get_role(RoleName=role_name)["Role"]["Arn"]
+
+
+def get_sagemaker_input():
+    credentials_configuration = _ask_options(
+        "How do you want to authorize?",
+        ["AWS Profile", "Credentials (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY) "],
+        int,
+    )
+    aws_profile = None
+    if credentials_configuration == 0:
+        aws_profile = _ask_field("Enter your AWS Profile name: [default] ", default="default")
+        os.environ["AWS_PROFILE"] = aws_profile
+    else:
+        print(
+            "Note you will need to provide AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY when you launch you training script with,"
+            "`accelerate launch --aws_access_key_id XXX --aws_secret_access_key YYY`"
+        )
+        aws_access_key_id = _ask_field("AWS Access Key ID: ")
+        os.environ["AWS_ACCESS_KEY_ID"] = aws_access_key_id
+
+        aws_secret_access_key = _ask_field("AWS Secret Access Key: ")
+        os.environ["AWS_SECRET_ACCESS_KEY"] = aws_secret_access_key
+
+    aws_region = _ask_field("Enter your AWS Region: [us-east-1]", default="us-east-1")
+    os.environ["AWS_DEFAULT_REGION"] = aws_region
+
+    role_management = _ask_options(
+        "Do you already have an IAM Role for executing Amazon SageMaker Training Jobs?",
+        ["Provide IAM Role name", "Create new IAM role using credentials"],
+        int,
+    )
+    if role_management == 0:
+        iam_role_name = _ask_field("Enter your IAM role name: ")
+    else:
+        iam_role_name = "accelerate_sagemaker_execution_role"
+        print(f'Accelerate will create an iam role "{iam_role_name}" using the provided credentials')
+        _create_iam_role_for_sagemaker(iam_role_name)
+
+    is_custom_docker_image = _ask_field(
+        "Do you want to use custom Docker image? [yes/NO]: ",
+        _convert_yes_no_to_bool,
+        default=False,
+        error_message="Please enter yes or no.",
+    )
+    docker_image = None
+    if is_custom_docker_image:
+        docker_image = _ask_field("Enter your Docker image: ", lambda x: str(x).lower())
+
+    is_sagemaker_inputs_enabled = _ask_field(
+        "Do you want to provide SageMaker input channels with data locations? [yes/NO]: ",
+        _convert_yes_no_to_bool,
+        default=False,
+        error_message="Please enter yes or no.",
+    )
+    sagemaker_inputs_file = None
+    if is_sagemaker_inputs_enabled:
+        sagemaker_inputs_file = _ask_field(
+            "Enter the path to the SageMaker inputs TSV file with columns (channel_name, data_location): ",
+            lambda x: str(x).lower(),
+        )
+
+    is_sagemaker_metrics_enabled = _ask_field(
+        "Do you want to enable SageMaker metrics? [yes/NO]: ",
+        _convert_yes_no_to_bool,
+        default=False,
+        error_message="Please enter yes or no.",
+    )
+    sagemaker_metrics_file = None
+    if is_sagemaker_metrics_enabled:
+        sagemaker_metrics_file = _ask_field(
+            "Enter the path to the SageMaker metrics TSV file with columns (metric_name, metric_regex): ",
+            lambda x: str(x).lower(),
+        )
+
+    distributed_type = _ask_options(
+        "What is the distributed mode?",
+        ["No distributed training", "Data parallelism"],
+        _convert_sagemaker_distributed_mode,
+    )
+    dynamo_config = {}
+    use_dynamo = _ask_field(
+        "Do you wish to optimize your script with torch dynamo?[yes/NO]:",
+        _convert_yes_no_to_bool,
+        default=False,
+        error_message="Please enter yes or no.",
+    )
+    if use_dynamo:
+        prefix = "dynamo_"
+        dynamo_config[prefix + "backend"] = _ask_options(
+            "Which dynamo backend would you like to use?",
+            [x.lower() for x in DYNAMO_BACKENDS],
+            _convert_dynamo_backend,
+            default=2,
+        )
+        use_custom_options = _ask_field(
+            "Do you want to customize the defaults sent to torch.compile? [yes/NO]: ",
+            _convert_yes_no_to_bool,
+            default=False,
+            error_message="Please enter yes or no.",
+        )
+
+        if use_custom_options:
+            dynamo_config[prefix + "mode"] = _ask_options(
+                "Which mode do you want to use?",
+                TORCH_DYNAMO_MODES,
+                lambda x: TORCH_DYNAMO_MODES[int(x)],
+                default="default",
+            )
+            dynamo_config[prefix + "use_fullgraph"] = _ask_field(
+                "Do you want the fullgraph mode or it is ok to break model into several subgraphs? [yes/NO]: ",
+                _convert_yes_no_to_bool,
+                default=False,
+                error_message="Please enter yes or no.",
+            )
+            dynamo_config[prefix + "use_dynamic"] = _ask_field(
+                "Do you want to enable dynamic shape tracing? [yes/NO]: ",
+                _convert_yes_no_to_bool,
+                default=False,
+                error_message="Please enter yes or no.",
+            )
+    ec2_instance_query = "Which EC2 instance type you want to use for your training?"
+    if distributed_type != SageMakerDistributedType.NO:
+        ec2_instance_type = _ask_options(
+            ec2_instance_query, SAGEMAKER_PARALLEL_EC2_INSTANCES, lambda x: SAGEMAKER_PARALLEL_EC2_INSTANCES[int(x)]
+        )
+    else:
+        ec2_instance_query += "? [ml.p3.2xlarge]:"
+        ec2_instance_type = _ask_field(ec2_instance_query, lambda x: str(x).lower(), default="ml.p3.2xlarge")
+
+    debug = False
+    if distributed_type != SageMakerDistributedType.NO:
+        debug = _ask_field(
+            "Should distributed operations be checked while running for errors? This can avoid timeout issues but will be slower. [yes/NO]: ",
+            _convert_yes_no_to_bool,
+            default=False,
+            error_message="Please enter yes or no.",
+        )
+
+    num_machines = 1
+    if distributed_type in (SageMakerDistributedType.DATA_PARALLEL, SageMakerDistributedType.MODEL_PARALLEL):
+        num_machines = _ask_field(
+            "How many machines do you want use? [1]: ",
+            int,
+            default=1,
+        )
+
+    mixed_precision = _ask_options(
+        "Do you wish to use FP16 or BF16 (mixed precision)?",
+        ["no", "fp16", "bf16", "fp8"],
+        _convert_mixed_precision,
+    )
+
+    if use_dynamo and mixed_precision == "no":
+        print(
+            "Torch dynamo used without mixed precision requires TF32 to be efficient. Accelerate will enable it by default when launching your scripts."
+        )
+
+    return SageMakerConfig(
+        image_uri=docker_image,
+        compute_environment=ComputeEnvironment.AMAZON_SAGEMAKER,
+        distributed_type=distributed_type,
+        use_cpu=False,
+        dynamo_config=dynamo_config,
+        ec2_instance_type=ec2_instance_type,
+        profile=aws_profile,
+        region=aws_region,
+        iam_role_name=iam_role_name,
+        mixed_precision=mixed_precision,
+        num_machines=num_machines,
+        sagemaker_inputs_file=sagemaker_inputs_file,
+        sagemaker_metrics_file=sagemaker_metrics_file,
+        debug=debug,
+    )
diff --git a/llm/Lib/site-packages/accelerate/commands/config/update.py b/llm/Lib/site-packages/accelerate/commands/config/update.py
new file mode 100644
index 0000000000000000000000000000000000000000..5f025594b04ada3e3a78687befc5c1bc1d236adf
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/config/update.py
@@ -0,0 +1,63 @@
+#!/usr/bin/env python
+
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from pathlib import Path
+
+from .config_args import default_config_file, load_config_from_file
+from .config_utils import SubcommandHelpFormatter
+
+
+description = "Update an existing config file with the latest defaults while maintaining the old configuration."
+
+
+def update_config(args):
+    """
+    Update an existing config file with the latest defaults while maintaining the old configuration.
+    """
+    config_file = args.config_file
+    if config_file is None and Path(default_config_file).exists():
+        config_file = default_config_file
+    elif not Path(config_file).exists():
+        raise ValueError(f"The passed config file located at {config_file} doesn't exist.")
+    config = load_config_from_file(config_file)
+
+    if config_file.endswith(".json"):
+        config.to_json_file(config_file)
+    else:
+        config.to_yaml_file(config_file)
+    return config_file
+
+
+def update_command_parser(parser, parents):
+    parser = parser.add_parser("update", parents=parents, help=description, formatter_class=SubcommandHelpFormatter)
+    parser.add_argument(
+        "--config_file",
+        default=None,
+        help=(
+            "The path to the config file to update. Will default to a file named default_config.yaml in the cache "
+            "location, which is the content of the environment `HF_HOME` suffixed with 'accelerate', or if you don't have "
+            "such an environment variable, your cache directory ('~/.cache' or the content of `XDG_CACHE_HOME`) suffixed "
+            "with 'huggingface'."
+        ),
+    )
+
+    parser.set_defaults(func=update_config_command)
+    return parser
+
+
+def update_config_command(args):
+    config_file = update_config(args)
+    print(f"Sucessfully updated the configuration file at {config_file}.")
diff --git a/llm/Lib/site-packages/accelerate/commands/env.py b/llm/Lib/site-packages/accelerate/commands/env.py
new file mode 100644
index 0000000000000000000000000000000000000000..fb2f60f787a9eba3f75b6ac9171aefd0ffc61647
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/env.py
@@ -0,0 +1,107 @@
+#!/usr/bin/env python
+
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import argparse
+import os
+import platform
+import subprocess
+
+import numpy as np
+import psutil
+import torch
+
+from accelerate import __version__ as version
+from accelerate.commands.config import default_config_file, load_config_from_file
+
+from ..utils import is_mlu_available, is_npu_available, is_xpu_available
+
+
+def env_command_parser(subparsers=None):
+    if subparsers is not None:
+        parser = subparsers.add_parser("env")
+    else:
+        parser = argparse.ArgumentParser("Accelerate env command")
+
+    parser.add_argument(
+        "--config_file", default=None, help="The config file to use for the default values in the launching script."
+    )
+
+    if subparsers is not None:
+        parser.set_defaults(func=env_command)
+    return parser
+
+
+def env_command(args):
+    pt_version = torch.__version__
+    pt_cuda_available = torch.cuda.is_available()
+    pt_xpu_available = is_xpu_available()
+    pt_mlu_available = is_mlu_available()
+    pt_npu_available = is_npu_available()
+
+    accelerate_config = "Not found"
+    # Get the default from the config file.
+    if args.config_file is not None or os.path.isfile(default_config_file):
+        accelerate_config = load_config_from_file(args.config_file).to_dict()
+
+    # if we can run which, get it
+    command = None
+    bash_location = "Not found"
+    if os.name == "nt":
+        command = ["where", "accelerate"]
+    elif os.name == "posix":
+        command = ["which", "accelerate"]
+    if command is not None:
+        bash_location = subprocess.check_output(command, text=True, stderr=subprocess.STDOUT).strip()
+    info = {
+        "`Accelerate` version": version,
+        "Platform": platform.platform(),
+        "`accelerate` bash location": bash_location,
+        "Python version": platform.python_version(),
+        "Numpy version": np.__version__,
+        "PyTorch version (GPU?)": f"{pt_version} ({pt_cuda_available})",
+        "PyTorch XPU available": str(pt_xpu_available),
+        "PyTorch NPU available": str(pt_npu_available),
+        "PyTorch MLU available": str(pt_mlu_available),
+        "System RAM": f"{psutil.virtual_memory().total / 1024 ** 3:.2f} GB",
+    }
+    if pt_cuda_available:
+        info["GPU type"] = torch.cuda.get_device_name()
+
+    print("\nCopy-and-paste the text below in your GitHub issue\n")
+    print("\n".join([f"- {prop}: {val}" for prop, val in info.items()]))
+
+    print("- `Accelerate` default config:" if args.config_file is None else "- `Accelerate` config passed:")
+    accelerate_config_str = (
+        "\n".join([f"\t- {prop}: {val}" for prop, val in accelerate_config.items()])
+        if isinstance(accelerate_config, dict)
+        else f"\t{accelerate_config}"
+    )
+    print(accelerate_config_str)
+
+    info["`Accelerate` configs"] = accelerate_config
+
+    return info
+
+
+def main() -> int:
+    parser = env_command_parser()
+    args = parser.parse_args()
+    env_command(args)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())
diff --git a/llm/Lib/site-packages/accelerate/commands/estimate.py b/llm/Lib/site-packages/accelerate/commands/estimate.py
new file mode 100644
index 0000000000000000000000000000000000000000..56da3c5ad9e953687fab71dfc1fb0a878309d1d6
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/estimate.py
@@ -0,0 +1,309 @@
+#!/usr/bin/env python
+
+# Copyright 2023 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from huggingface_hub import model_info
+from huggingface_hub.utils import GatedRepoError, RepositoryNotFoundError
+
+from accelerate import init_empty_weights
+from accelerate.commands.utils import CustomArgumentParser
+from accelerate.utils import (
+    calculate_maximum_sizes,
+    convert_bytes,
+    is_timm_available,
+    is_transformers_available,
+)
+
+
+if is_transformers_available():
+    import transformers
+    from transformers import AutoConfig, AutoModel
+
+if is_timm_available():
+    import timm
+
+
+def verify_on_hub(repo: str, token: str = None):
+    "Verifies that the model is on the hub and returns the model info."
+    try:
+        return model_info(repo, token=token)
+    except GatedRepoError:
+        return "gated"
+    except RepositoryNotFoundError:
+        return "repo"
+
+
+def check_has_model(error):
+    """
+    Checks what library spawned `error` when a model is not found
+    """
+    if is_timm_available() and isinstance(error, RuntimeError) and "Unknown model" in error.args[0]:
+        return "timm"
+    elif (
+        is_transformers_available()
+        and isinstance(error, OSError)
+        and "does not appear to have a file named" in error.args[0]
+    ):
+        return "transformers"
+    else:
+        return "unknown"
+
+
+def create_empty_model(model_name: str, library_name: str, trust_remote_code: bool = False, access_token: str = None):
+    """
+    Creates an empty model from its parent library on the `Hub` to calculate the overall memory consumption.
+
+    Args:
+        model_name (`str`):
+            The model name on the Hub
+        library_name (`str`):
+            The library the model has an integration with, such as `transformers`. Will be used if `model_name` has no
+            metadata on the Hub to determine the library.
+        trust_remote_code (`bool`, `optional`, defaults to `False`):
+            Whether or not to allow for custom models defined on the Hub in their own modeling files. This option
+            should only be set to `True` for repositories you trust and in which you have read the code, as it will
+            execute code present on the Hub on your local machine.
+        access_token (`str`, `optional`, defaults to `None`):
+            The access token to use to access private or gated models on the Hub. (for use on the Gradio app)
+
+    Returns:
+        `torch.nn.Module`: The torch model that has been initialized on the `meta` device.
+
+    """
+    model_info = verify_on_hub(model_name, access_token)
+    # Simplified errors
+    if model_info == "gated":
+        raise GatedRepoError(
+            f"Repo for model `{model_name}` is gated. You must be authenticated to access it. Please run `huggingface-cli login`."
+        )
+    elif model_info == "repo":
+        raise RepositoryNotFoundError(
+            f"Repo for model `{model_name}` does not exist on the Hub. If you are trying to access a private repo,"
+            " make sure you are authenticated via `huggingface-cli login` and have access."
+        )
+    if library_name is None:
+        library_name = getattr(model_info, "library_name", False)
+        if not library_name:
+            raise ValueError(
+                f"Model `{model_name}` does not have any library metadata on the Hub, please manually pass in a `--library_name` to use (such as `transformers`)"
+            )
+    if library_name == "transformers":
+        if not is_transformers_available():
+            raise ImportError(
+                f"To check `{model_name}`, `transformers` must be installed. Please install it via `pip install transformers`"
+            )
+        print(f"Loading pretrained config for `{model_name}` from `transformers`...")
+        if model_info.config is None:
+            raise RuntimeError(f"Tried to load `{model_name}` with `transformers` but it does not have any metadata.")
+
+        auto_map = model_info.config.get("auto_map", False)
+        config = AutoConfig.from_pretrained(model_name, trust_remote_code=trust_remote_code, token=access_token)
+        with init_empty_weights():
+            # remote code could specify a specific `AutoModel` class in the `auto_map`
+            constructor = AutoModel
+            if isinstance(auto_map, dict):
+                value = None
+                for key in auto_map.keys():
+                    if key.startswith("AutoModelFor"):
+                        value = key
+                        break
+                if value is not None:
+                    constructor = getattr(transformers, value)
+            model = constructor.from_config(config, trust_remote_code=trust_remote_code)
+    elif library_name == "timm":
+        if not is_timm_available():
+            raise ImportError(
+                f"To check `{model_name}`, `timm` must be installed. Please install it via `pip install timm`"
+            )
+        print(f"Loading pretrained config for `{model_name}` from `timm`...")
+        with init_empty_weights():
+            model = timm.create_model(model_name, pretrained=False)
+    else:
+        raise ValueError(
+            f"Library `{library_name}` is not supported yet, please open an issue on GitHub for us to add support."
+        )
+    return model
+
+
+def create_ascii_table(headers: list, rows: list, title: str):
+    "Creates a pretty table from a list of rows, minimal version of `tabulate`."
+    sep_char, in_between = "│", "─"
+    column_widths = []
+    for i in range(len(headers)):
+        column_values = [row[i] for row in rows] + [headers[i]]
+        max_column_width = max(len(value) for value in column_values)
+        column_widths.append(max_column_width)
+
+    formats = [f"%{column_widths[i]}s" for i in range(len(rows[0]))]
+
+    pattern = f"{sep_char}{sep_char.join(formats)}{sep_char}"
+    diff = 0
+
+    def make_row(left_char, middle_char, right_char):
+        return f"{left_char}{middle_char.join([in_between * n for n in column_widths])}{in_between * diff}{right_char}"
+
+    separator = make_row("├", "┼", "┤")
+    if len(title) > sum(column_widths):
+        diff = abs(len(title) - len(separator))
+        column_widths[-1] += diff
+
+    # Update with diff
+    separator = make_row("├", "┼", "┤")
+    initial_rows = [
+        make_row("┌", in_between, "┐"),
+        f"{sep_char}{title.center(len(separator) - 2)}{sep_char}",
+        make_row("├", "┬", "┤"),
+    ]
+    table = "\n".join(initial_rows) + "\n"
+    column_widths[-1] += diff
+    centered_line = [text.center(column_widths[i]) for i, text in enumerate(headers)]
+    table += f"{pattern % tuple(centered_line)}\n{separator}\n"
+    for i, line in enumerate(rows):
+        centered_line = [t.center(column_widths[i]) for i, t in enumerate(line)]
+        table += f"{pattern % tuple(centered_line)}\n"
+    table += f'└{"┴".join([in_between * n for n in column_widths])}┘'
+
+    return table
+
+
+def estimate_command_parser(subparsers=None):
+    if subparsers is not None:
+        parser = subparsers.add_parser("estimate-memory")
+    else:
+        parser = CustomArgumentParser(description="Model size estimator for fitting a model onto CUDA memory.")
+
+    parser.add_argument("model_name", type=str, help="The model name on the Hugging Face Hub.")
+    parser.add_argument(
+        "--library_name",
+        type=str,
+        help="The library the model has an integration with, such as `transformers`, needed only if this information is not stored on the Hub.",
+        choices=["timm", "transformers"],
+    )
+    parser.add_argument(
+        "--dtypes",
+        type=str,
+        nargs="+",
+        default=["float32", "float16", "int8", "int4"],
+        help="The dtypes to use for the model, must be one (or many) of `float32`, `float16`, `int8`, and `int4`",
+        choices=["float32", "float16", "int8", "int4"],
+    )
+    parser.add_argument(
+        "--trust_remote_code",
+        action="store_true",
+        help="""Whether or not to allow for custom models defined on the Hub in their own modeling files. This flag
+                should only be used for repositories you trust and in which you have read the code, as it will execute
+                code present on the Hub on your local machine.""",
+        default=False,
+    )
+
+    if subparsers is not None:
+        parser.set_defaults(func=estimate_command)
+    return parser
+
+
+def estimate_training_usage(bytes: int, mixed_precision: str, msamp_config: str = None) -> dict:
+    """
+    Given an amount of `bytes` and `mixed_precision`, calculates how much training memory is needed for a batch size of
+    1.
+
+    Args:
+        bytes (`int`):
+            The size of the model being trained.
+        mixed_precision (`str`):
+            The mixed precision that would be ran.
+        msamp_config (`str`):
+            The msamp config to estimate the training memory for if `mixed_precision` is set to `"fp8"`.
+    """
+    memory_sizes = {"model": -1, "optimizer": -1, "gradients": -1, "step": -1}
+    fp32_size = bytes
+    fp16_size = bytes // 2
+
+    if mixed_precision == "float32":
+        memory_sizes["model"] = fp32_size
+        memory_sizes["gradients"] = fp32_size
+        memory_sizes["optimizer"] = fp32_size * 2
+        memory_sizes["step"] = fp32_size * 4
+    elif mixed_precision in ("float16", "bfloat16") or (mixed_precision == "fp8" and msamp_config is None):
+        # With native `TransformersEngine`, there is no memory savings with FP8
+        # With mixed precision training, the model has weights stored
+        # in FP16 and FP32
+        memory_sizes["model"] = fp32_size
+        # 1.5 from weight gradient + computation (GEMM)
+        memory_sizes["gradients"] = fp32_size + fp16_size
+        # 2x from optimizer states
+        memory_sizes["optimizer"] = fp32_size * 2  # Optimizer states
+        memory_sizes["step"] = memory_sizes["optimizer"]
+    return memory_sizes
+
+
+def gather_data(args):
+    "Creates an empty model and gathers the data for the sizes"
+    try:
+        model = create_empty_model(
+            args.model_name, library_name=args.library_name, trust_remote_code=args.trust_remote_code
+        )
+    except (RuntimeError, OSError) as e:
+        library = check_has_model(e)
+        if library != "unknown":
+            raise RuntimeError(
+                f"Tried to load `{args.model_name}` with `{library}` but a possible model to load was not found inside the repo."
+            )
+        raise e
+
+    total_size, largest_layer = calculate_maximum_sizes(model)
+
+    data = []
+
+    for dtype in args.dtypes:
+        dtype_total_size = total_size
+        dtype_largest_layer = largest_layer[0]
+        dtype_training_size = estimate_training_usage(dtype_total_size, dtype)
+        if dtype == "float16":
+            dtype_total_size /= 2
+            dtype_largest_layer /= 2
+        elif dtype == "int8":
+            dtype_total_size /= 4
+            dtype_largest_layer /= 4
+        elif dtype == "int4":
+            dtype_total_size /= 8
+            dtype_largest_layer /= 8
+        data.append([dtype, dtype_largest_layer, dtype_total_size, dtype_training_size])
+    return data
+
+
+def estimate_command(args):
+    data = gather_data(args)
+    for row in data:
+        for i, item in enumerate(row):
+            if isinstance(item, (int, float)):
+                row[i] = convert_bytes(item)
+            elif isinstance(item, dict):
+                training_usage = max(item.values())
+                row[i] = convert_bytes(training_usage) if training_usage != -1 else "N/A"
+
+    headers = ["dtype", "Largest Layer", "Total Size", "Training using Adam"]
+
+    title = f"Memory Usage for loading `{args.model_name}`"
+    table = create_ascii_table(headers, data, title)
+    print(table)
+
+
+def main():
+    parser = estimate_command_parser()
+    args = parser.parse_args()
+    estimate_command(args)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/commands/launch.py b/llm/Lib/site-packages/accelerate/commands/launch.py
new file mode 100644
index 0000000000000000000000000000000000000000..f6b91654bc63c3cd0db9cca5f72be511458a20fb
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/launch.py
@@ -0,0 +1,1085 @@
+#!/usr/bin/env python
+
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import argparse
+import importlib
+import logging
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+import psutil
+import torch
+
+from accelerate.commands.config import default_config_file, load_config_from_file
+from accelerate.commands.config.config_args import SageMakerConfig
+from accelerate.commands.config.config_utils import DYNAMO_BACKENDS
+from accelerate.commands.utils import CustomArgumentParser
+from accelerate.state import get_int_from_env
+from accelerate.utils import (
+    ComputeEnvironment,
+    DistributedType,
+    PrepareForLaunch,
+    _filter_args,
+    check_cuda_p2p_ib_support,
+    convert_dict_to_env_variables,
+    is_bf16_available,
+    is_deepspeed_available,
+    is_mlu_available,
+    is_npu_available,
+    is_rich_available,
+    is_sagemaker_available,
+    is_torch_version,
+    is_torch_xla_available,
+    is_xpu_available,
+    patch_environment,
+    prepare_deepspeed_cmd_env,
+    prepare_multi_gpu_env,
+    prepare_sagemager_args_inputs,
+    prepare_simple_launcher_cmd_env,
+    prepare_tpu,
+)
+from accelerate.utils.constants import DEEPSPEED_MULTINODE_LAUNCHERS, TORCH_DYNAMO_MODES
+
+
+if is_rich_available():
+    from rich import get_console
+    from rich.logging import RichHandler
+
+    FORMAT = "%(message)s"
+    logging.basicConfig(format=FORMAT, datefmt="[%X]", handlers=[RichHandler()])
+
+
+logger = logging.getLogger(__name__)
+
+
+options_to_group = {
+    "multi_gpu": "Distributed GPUs",
+    "tpu": "TPU",
+    "use_deepspeed": "DeepSpeed Arguments",
+    "use_fsdp": "FSDP Arguments",
+    "use_megatron_lm": "Megatron-LM Arguments",
+}
+
+
+def clean_option(option):
+    "Finds all cases of - after the first two characters and changes them to _"
+    if option.startswith("--"):
+        return option[2:].replace("-", "_")
+
+
+class CustomHelpFormatter(argparse.HelpFormatter):
+    """
+    This is a custom help formatter that will hide all arguments that are not used in the command line when the help is
+    called. This is useful for the case where the user is using a specific platform and only wants to see the arguments
+    for that platform.
+    """
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.titles = [
+            "Hardware Selection Arguments",
+            "Resource Selection Arguments",
+            "Training Paradigm Arguments",
+            "positional arguments",
+            "optional arguments",
+        ]
+
+    def add_argument(self, action: argparse.Action):
+        if "accelerate" in sys.argv[0] and "launch" in sys.argv[1:]:
+            args = sys.argv[2:]
+        else:
+            args = sys.argv[1:]
+
+        if len(args) > 1:
+            args = list(map(clean_option, args))
+            used_platforms = [arg for arg in args if arg in options_to_group.keys()]
+            used_titles = [options_to_group[o] for o in used_platforms]
+            if action.container.title not in self.titles + used_titles:
+                action.help = argparse.SUPPRESS
+            elif action.container.title == "Hardware Selection Arguments":
+                if set(action.option_strings).isdisjoint(set(args)):
+                    action.help = argparse.SUPPRESS
+                else:
+                    action.help = action.help + " (currently selected)"
+            elif action.container.title == "Training Paradigm Arguments":
+                if set(action.option_strings).isdisjoint(set(args)):
+                    action.help = argparse.SUPPRESS
+                else:
+                    action.help = action.help + " (currently selected)"
+
+        action.option_strings = [s for s in action.option_strings if "-" not in s[2:]]
+        super().add_argument(action)
+
+    def end_section(self):
+        if len(self._current_section.items) < 2:
+            self._current_section.items = []
+            self._current_section.heading = ""
+        super().end_section()
+
+
+def launch_command_parser(subparsers=None):
+    description = "Launch a python script in a distributed scenario. Arguments can be passed in with either hyphens (`--num-processes=2`) or underscores (`--num_processes=2`)"
+    if subparsers is not None:
+        parser = subparsers.add_parser(
+            "launch", description=description, add_help=False, allow_abbrev=False, formatter_class=CustomHelpFormatter
+        )
+    else:
+        parser = CustomArgumentParser(
+            "Accelerate launch command",
+            description=description,
+            add_help=False,
+            allow_abbrev=False,
+            formatter_class=CustomHelpFormatter,
+        )
+
+    parser.add_argument("-h", "--help", action="help", help="Show this help message and exit.")
+
+    parser.add_argument(
+        "--config_file",
+        default=None,
+        help="The config file to use for the default values in the launching script.",
+    )
+    parser.add_argument(
+        "--quiet",
+        "-q",
+        action="store_true",
+        help="Silence subprocess errors from the launch stack trace and only show the relevant tracebacks. (Only applicable to DeepSpeed and single-process configurations)",
+    )
+    # Hardware selection arguments
+    hardware_args = parser.add_argument_group(
+        "Hardware Selection Arguments", "Arguments for selecting the hardware to be used."
+    )
+    hardware_args.add_argument(
+        "--cpu", default=False, action="store_true", help="Whether or not to force the training on the CPU."
+    )
+    hardware_args.add_argument(
+        "--multi_gpu",
+        default=False,
+        action="store_true",
+        help="Whether or not this should launch a distributed GPU training.",
+    )
+    hardware_args.add_argument(
+        "--tpu", default=False, action="store_true", help="Whether or not this should launch a TPU training."
+    )
+    hardware_args.add_argument(
+        "--ipex",
+        default=False,
+        action="store_true",
+        help="Whether or not this should launch a Intel PyTorch Extension (IPEX) training.",
+    )
+
+    # Resource selection arguments
+    resource_args = parser.add_argument_group(
+        "Resource Selection Arguments", "Arguments for fine-tuning how available hardware should be used."
+    )
+    resource_args.add_argument(
+        "--mixed_precision",
+        type=str,
+        choices=["no", "fp16", "bf16", "fp8"],
+        help="Whether or not to use mixed precision training. "
+        "Choose between FP16 and BF16 (bfloat16) training. "
+        "BF16 training is only supported on Nvidia Ampere GPUs and PyTorch 1.10 or later.",
+    )
+    resource_args.add_argument(
+        "--num_processes", type=int, default=None, help="The total number of processes to be launched in parallel."
+    )
+    resource_args.add_argument(
+        "--num_machines", type=int, default=None, help="The total number of machines used in this training."
+    )
+    resource_args.add_argument(
+        "--num_cpu_threads_per_process",
+        type=int,
+        default=None,
+        help="The number of CPU threads per process. Can be tuned for optimal performance.",
+    )
+    resource_args.add_argument(
+        "--enable_cpu_affinity",
+        default=False,
+        action="store_true",
+        help="Whether or not CPU affinity and balancing should be enabled. Currently only supported on NVIDIA hardware.",
+    )
+
+    # Dynamo arguments
+    resource_args.add_argument(
+        "--dynamo_backend",
+        type=str,
+        choices=["no"] + [b.lower() for b in DYNAMO_BACKENDS],
+        help="Choose a backend to optimize your training with dynamo, see more at "
+        "https://github.com/pytorch/torchdynamo.",
+    )
+    resource_args.add_argument(
+        "--dynamo_mode",
+        type=str,
+        default="default",
+        choices=TORCH_DYNAMO_MODES,
+        help="Choose a mode to optimize your training with dynamo.",
+    )
+    resource_args.add_argument(
+        "--dynamo_use_fullgraph",
+        default=False,
+        action="store_true",
+        help="Whether to use full graph mode for dynamo or it is ok to break model into several subgraphs",
+    )
+    resource_args.add_argument(
+        "--dynamo_use_dynamic",
+        default=False,
+        action="store_true",
+        help="Whether to enable dynamic shape tracing.",
+    )
+
+    # Training Paradigm arguments
+    paradigm_args = parser.add_argument_group(
+        "Training Paradigm Arguments", "Arguments for selecting which training paradigm to be used."
+    )
+    paradigm_args.add_argument(
+        "--use_deepspeed",
+        default=False,
+        action="store_true",
+        help="Whether to use deepspeed.",
+    )
+    paradigm_args.add_argument(
+        "--use_fsdp",
+        default=False,
+        action="store_true",
+        help="Whether to use fsdp.",
+    )
+    paradigm_args.add_argument(
+        "--use_megatron_lm",
+        default=False,
+        action="store_true",
+        help="Whether to use Megatron-LM.",
+    )
+    paradigm_args.add_argument(
+        "--use_xpu",
+        default=False,
+        action="store_true",
+        help="Whether to use IPEX plugin to speed up training on XPU specifically.",
+    )
+
+    # distributed GPU training arguments
+    distributed_args = parser.add_argument_group("Distributed GPUs", "Arguments related to distributed GPU training.")
+    distributed_args.add_argument(
+        "--gpu_ids",
+        default=None,
+        help="What GPUs (by id) should be used for training on this machine as a comma-seperated list",
+    )
+    distributed_args.add_argument(
+        "--same_network",
+        default=False,
+        action="store_true",
+        help="Whether all machines used for multinode training exist on the same local network.",
+    )
+    distributed_args.add_argument(
+        "--machine_rank", type=int, default=None, help="The rank of the machine on which this script is launched."
+    )
+    distributed_args.add_argument(
+        "--main_process_ip", type=str, default=None, help="The IP address of the machine of rank 0."
+    )
+    distributed_args.add_argument(
+        "--main_process_port",
+        type=int,
+        default=None,
+        help="The port to use to communicate with the machine of rank 0.",
+    )
+    distributed_args.add_argument(
+        "-t",
+        "--tee",
+        default="0",
+        type=str,
+        help="Tee std streams into a log file and also to console.",
+    )
+    distributed_args.add_argument(
+        "--role",
+        type=str,
+        default="default",
+        help="User-defined role for the workers.",
+    )
+    # Rendezvous related arguments
+    distributed_args.add_argument(
+        "--rdzv_backend",
+        type=str,
+        default="static",
+        help="The rendezvous method to use, such as 'static' (the default) or 'c10d'",
+    )
+    distributed_args.add_argument(
+        "--rdzv_conf",
+        type=str,
+        default="",
+        help="Additional rendezvous configuration (<key1>=<value1>,<key2>=<value2>,...).",
+    )
+    distributed_args.add_argument(
+        "--max_restarts",
+        type=int,
+        default=0,
+        help="Maximum number of worker group restarts before failing.",
+    )
+    distributed_args.add_argument(
+        "--monitor_interval",
+        type=float,
+        default=5,
+        help="Interval, in seconds, to monitor the state of workers.",
+    )
+    parser.add_argument(
+        "-m",
+        "--module",
+        action="store_true",
+        help="Change each process to interpret the launch script as a Python module, executing with the same behavior as 'python -m'.",
+    )
+    parser.add_argument(
+        "--no_python",
+        action="store_true",
+        help="Skip prepending the training script with 'python' - just execute it directly. Useful when the script is not a Python script.",
+    )
+
+    # TPU arguments
+    tpu_args = parser.add_argument_group("TPU", "Arguments related to TPU.")
+    tpu_args.add_argument(
+        "--tpu_cluster",
+        action="store_true",
+        dest="tpu_use_cluster",
+        help="Whether to use a GCP TPU pod for training.",
+    )
+    tpu_args.add_argument(
+        "--no_tpu_cluster",
+        action="store_false",
+        dest="tpu_use_cluster",
+        help="Should not be passed explicitly, this is for internal use only.",
+    )
+    tpu_args.add_argument(
+        "--tpu_use_sudo",
+        action="store_true",
+        help="Whether to use `sudo` when running the TPU training script in each pod.",
+    )
+    tpu_args.add_argument(
+        "--vm",
+        type=str,
+        action="append",
+        help=(
+            "List of single Compute VM instance names. "
+            "If not provided we assume usage of instance groups. For TPU pods."
+        ),
+    )
+    tpu_args.add_argument(
+        "--env",
+        type=str,
+        action="append",
+        help="List of environment variables to set on the Compute VM instances. For TPU pods.",
+    )
+    tpu_args.add_argument(
+        "--main_training_function",
+        type=str,
+        default=None,
+        help="The name of the main function to be executed in your script (only for TPU training).",
+    )
+    tpu_args.add_argument(
+        "--downcast_bf16",
+        action="store_true",
+        help="Whether when using bf16 precision on TPUs if both float and double tensors are cast to bfloat16 or if double tensors remain as float32.",
+    )
+
+    # DeepSpeed arguments
+    deepspeed_args = parser.add_argument_group("DeepSpeed Arguments", "Arguments related to DeepSpeed.")
+    deepspeed_args.add_argument(
+        "--deepspeed_config_file",
+        default=None,
+        type=str,
+        help="DeepSpeed config file.",
+    )
+    deepspeed_args.add_argument(
+        "--zero_stage",
+        default=None,
+        type=int,
+        help="DeepSpeed's ZeRO optimization stage (useful only when `use_deepspeed` flag is passed). "
+        "If unspecified, will default to `2`.",
+    )
+    deepspeed_args.add_argument(
+        "--offload_optimizer_device",
+        default=None,
+        type=str,
+        help="Decides where (none|cpu|nvme) to offload optimizer states (useful only when `use_deepspeed` flag is passed). "
+        "If unspecified, will default to 'none'.",
+    )
+    deepspeed_args.add_argument(
+        "--offload_param_device",
+        default=None,
+        type=str,
+        help="Decides where (none|cpu|nvme) to offload parameters (useful only when `use_deepspeed` flag is passed). "
+        "If unspecified, will default to 'none'.",
+    )
+    deepspeed_args.add_argument(
+        "--offload_optimizer_nvme_path",
+        default=None,
+        type=str,
+        help="Decides Nvme Path to offload optimizer states (useful only when `use_deepspeed` flag is passed). "
+        "If unspecified, will default to 'none'.",
+    )
+    deepspeed_args.add_argument(
+        "--offload_param_nvme_path",
+        default=None,
+        type=str,
+        help="Decides Nvme Path to offload parameters (useful only when `use_deepspeed` flag is passed). "
+        "If unspecified, will default to 'none'.",
+    )
+    deepspeed_args.add_argument(
+        "--gradient_accumulation_steps",
+        default=None,
+        type=int,
+        help="No of gradient_accumulation_steps used in your training script (useful only when `use_deepspeed` flag is passed). "
+        "If unspecified, will default to `1`.",
+    )
+    deepspeed_args.add_argument(
+        "--gradient_clipping",
+        default=None,
+        type=float,
+        help="gradient clipping value used in your training script (useful only when `use_deepspeed` flag is passed). "
+        "If unspecified, will default to `1.0`.",
+    )
+    deepspeed_args.add_argument(
+        "--zero3_init_flag",
+        default=None,
+        type=str,
+        help="Decides Whether (true|false) to enable `deepspeed.zero.Init` for constructing massive models. "
+        "Only applicable with DeepSpeed ZeRO Stage-3. If unspecified, will default to `true`.",
+    )
+    deepspeed_args.add_argument(
+        "--zero3_save_16bit_model",
+        default=None,
+        type=str,
+        help="Decides Whether (true|false) to save 16-bit model weights when using ZeRO Stage-3. "
+        "Only applicable with DeepSpeed ZeRO Stage-3. If unspecified, will default to `false`.",
+    )
+    deepspeed_args.add_argument(
+        "--deepspeed_hostfile",
+        default=None,
+        type=str,
+        help="DeepSpeed hostfile for configuring multi-node compute resources.",
+    )
+    deepspeed_args.add_argument(
+        "--deepspeed_exclusion_filter",
+        default=None,
+        type=str,
+        help="DeepSpeed exclusion filter string when using mutli-node setup.",
+    )
+    deepspeed_args.add_argument(
+        "--deepspeed_inclusion_filter",
+        default=None,
+        type=str,
+        help="DeepSpeed inclusion filter string when using mutli-node setup.",
+    )
+    deepspeed_args.add_argument(
+        "--deepspeed_multinode_launcher",
+        default=None,
+        type=str,
+        help="DeepSpeed multi-node launcher to use. If unspecified, will default to `pdsh`.",
+    )
+
+    # fsdp arguments
+    fsdp_args = parser.add_argument_group("FSDP Arguments", "Arguments related to Fully Shared Data Parallelism.")
+    fsdp_args.add_argument(
+        "--fsdp_offload_params",
+        default="false",
+        type=str,
+        help="Decides Whether (true|false) to offload parameters and gradients to CPU. (useful only when `use_fsdp` flag is passed).",
+    )
+    fsdp_args.add_argument(
+        "--fsdp_min_num_params",
+        type=int,
+        default=1e8,
+        help="FSDP's minimum number of parameters for Default Auto Wrapping. (useful only when `use_fsdp` flag is passed).",
+    )
+    fsdp_args.add_argument(
+        "--fsdp_sharding_strategy",
+        type=str,
+        default="FULL_SHARD",
+        help="FSDP's Sharding Strategy. (useful only when `use_fsdp` flag is passed).",
+    )
+    fsdp_args.add_argument(
+        "--fsdp_auto_wrap_policy",
+        type=str,
+        default=None,
+        help="FSDP's auto wrap policy. (useful only when `use_fsdp` flag is passed).",
+    )
+    fsdp_args.add_argument(
+        "--fsdp_transformer_layer_cls_to_wrap",
+        default=None,
+        type=str,
+        help="Transformer layer class name (case-sensitive) to wrap ,e.g, `BertLayer`, `GPTJBlock`, `T5Block` .... "
+        "(useful only when `use_fsdp` flag is passed).",
+    )
+    fsdp_args.add_argument(
+        "--fsdp_backward_prefetch_policy",
+        default=None,
+        type=str,
+        help="This argument is deprecated and will be removed in version 0.27.0 of 🤗 Accelerate. Use `fsdp_backward_prefetch` instead.",
+    )
+    fsdp_args.add_argument(
+        "--fsdp_backward_prefetch",
+        default=None,
+        type=str,
+        help="FSDP's backward prefetch policy. (useful only when `use_fsdp` flag is passed).",
+    )
+    fsdp_args.add_argument(
+        "--fsdp_state_dict_type",
+        default=None,
+        type=str,
+        help="FSDP's state dict type. (useful only when `use_fsdp` flag is passed).",
+    )
+    fsdp_args.add_argument(
+        "--fsdp_forward_prefetch",
+        default="false",
+        type=str,
+        help="If True, then FSDP explicitly prefetches the next upcoming "
+        "all-gather while executing in the forward pass (useful only when `use_fsdp` flag is passed).",
+    )
+    fsdp_args.add_argument(
+        "--fsdp_use_orig_params",
+        default="true",
+        type=str,
+        help="If True, allows non-uniform `requires_grad` during init, which means support for interspersed frozen and trainable paramteres."
+        " (useful only when `use_fsdp` flag is passed).",
+    )
+    fsdp_args.add_argument(
+        "--fsdp_cpu_ram_efficient_loading",
+        default="true",
+        type=str,
+        help="If True, only the first process loads the pretrained model checkoint while all other processes have empty weights. "
+        "Only applicable for 🤗 Transformers. When using this, `--fsdp_sync_module_states` needs to True. "
+        "(useful only when `use_fsdp` flag is passed).",
+    )
+    fsdp_args.add_argument(
+        "--fsdp_sync_module_states",
+        default="true",
+        type=str,
+        help="If True, each individually wrapped FSDP unit will broadcast module parameters from rank 0."
+        " (useful only when `use_fsdp` flag is passed).",
+    )
+
+    # megatron_lm args
+    megatron_lm_args = parser.add_argument_group("Megatron-LM Arguments", "Arguments related to Megatron-LM.")
+    megatron_lm_args.add_argument(
+        "--megatron_lm_tp_degree",
+        type=int,
+        default=1,
+        help="Megatron-LM's Tensor Parallelism (TP) degree. (useful only when `use_megatron_lm` flag is passed).",
+    )
+    megatron_lm_args.add_argument(
+        "--megatron_lm_pp_degree",
+        type=int,
+        default=1,
+        help="Megatron-LM's Pipeline Parallelism (PP) degree. (useful only when `use_megatron_lm` flag is passed).",
+    )
+    megatron_lm_args.add_argument(
+        "--megatron_lm_num_micro_batches",
+        type=int,
+        default=None,
+        help="Megatron-LM's number of micro batches when PP degree > 1. (useful only when `use_megatron_lm` flag is passed).",
+    )
+    megatron_lm_args.add_argument(
+        "--megatron_lm_sequence_parallelism",
+        default=None,
+        type=str,
+        help="Decides Whether (true|false) to enable Sequence Parallelism when TP degree > 1. "
+        "(useful only when `use_megatron_lm` flag is passed).",
+    )
+    megatron_lm_args.add_argument(
+        "--megatron_lm_recompute_activations",
+        default=None,
+        type=str,
+        help="Decides Whether (true|false) to enable Selective Activation Recomputation. "
+        "(useful only when `use_megatron_lm` flag is passed).",
+    )
+    megatron_lm_args.add_argument(
+        "--megatron_lm_use_distributed_optimizer",
+        default=None,
+        type=str,
+        help="Decides Whether (true|false) to use distributed optimizer "
+        "which shards optimizer state and gradients across Data Pralellel (DP) ranks. "
+        "(useful only when `use_megatron_lm` flag is passed).",
+    )
+    megatron_lm_args.add_argument(
+        "--megatron_lm_gradient_clipping",
+        default=1.0,
+        type=float,
+        help="Megatron-LM's gradient clipping value based on global L2 Norm (0 to disable). "
+        "(useful only when `use_megatron_lm` flag is passed).",
+    )
+
+    # AWS arguments
+    aws_args = parser.add_argument_group("AWS Arguments", "Arguments related to AWS.")
+    aws_args.add_argument(
+        "--aws_access_key_id",
+        type=str,
+        default=None,
+        help="The AWS_ACCESS_KEY_ID used to launch the Amazon SageMaker training job",
+    )
+    aws_args.add_argument(
+        "--aws_secret_access_key",
+        type=str,
+        default=None,
+        help="The AWS_SECRET_ACCESS_KEY used to launch the Amazon SageMaker training job.",
+    )
+    parser.add_argument(
+        "--debug",
+        action="store_true",
+        help="Whether to print out the torch.distributed stack trace when something fails.",
+    )
+    parser.add_argument(
+        "training_script",
+        type=str,
+        help=(
+            "The full path to the script to be launched in parallel, followed by all the arguments for the training "
+            "script."
+        ),
+    )
+
+    # MPI arguments
+    mpirun_args = parser.add_argument_group("MPI Arguments", "Arguments related to mpirun for Multi-CPU")
+    mpirun_args.add_argument(
+        "--mpirun_hostfile",
+        type=str,
+        default=None,
+        help="Location for a hostfile for using Accelerate to launch a multi-CPU training job with mpirun. This will "
+        "get passed to the MPI --hostfile or -f parameter, depending on which MPI program is installed.",
+    )
+    mpirun_args.add_argument(
+        "--mpirun_ccl",
+        type=int,
+        default=1,
+        help="The number of oneCCL worker threads when using Accelerate to launch multi-CPU training with mpirun.",
+    )
+
+    # Other arguments of the training scripts
+    parser.add_argument("training_script_args", nargs=argparse.REMAINDER, help="Arguments of the training script.")
+
+    if subparsers is not None:
+        parser.set_defaults(func=launch_command)
+    return parser
+
+
+def simple_launcher(args):
+    cmd, current_env = prepare_simple_launcher_cmd_env(args)
+
+    process = subprocess.Popen(cmd, env=current_env)
+    process.wait()
+    if process.returncode != 0:
+        if not args.quiet:
+            raise subprocess.CalledProcessError(returncode=process.returncode, cmd=cmd)
+        else:
+            sys.exit(1)
+
+
+def multi_gpu_launcher(args):
+    import torch.distributed.run as distrib_run
+
+    current_env = prepare_multi_gpu_env(args)
+    if not check_cuda_p2p_ib_support():
+        message = "Using RTX 4000 series which doesn't support faster communication speedups. Ensuring P2P and IB communications are disabled."
+        warn = False
+        if "NCCL_P2P_DISABLE" not in current_env:
+            current_env["NCCL_P2P_DISABLE"] = "1"
+            warn = True
+        if "NCCL_IB_DISABLE" not in current_env:
+            current_env["NCCL_IB_DISABLE"] = "1"
+            warn = True
+        if warn:
+            logger.warning(message)
+
+    debug = getattr(args, "debug", False)
+    args = _filter_args(
+        args,
+        distrib_run.get_args_parser(),
+        ["--training_script", args.training_script, "--training_script_args", args.training_script_args],
+    )
+
+    with patch_environment(**current_env):
+        try:
+            distrib_run.run(args)
+        except Exception:
+            if is_rich_available() and debug:
+                console = get_console()
+                console.print("\n[bold red]Using --debug, `torch.distributed` Stack Trace:[/bold red]")
+                console.print_exception(suppress=[__file__], show_locals=False)
+            else:
+                raise
+
+
+def deepspeed_launcher(args):
+    import torch.distributed.run as distrib_run
+
+    if not is_deepspeed_available():
+        raise ImportError("DeepSpeed is not installed => run `pip3 install deepspeed` or build it from source.")
+    else:
+        from deepspeed.launcher.runner import DEEPSPEED_ENVIRONMENT_NAME
+
+    cmd, current_env = prepare_deepspeed_cmd_env(args)
+    if not check_cuda_p2p_ib_support():
+        message = "Using RTX 4000 series which doesn't support faster communication speedups. Ensuring P2P and IB communications are disabled."
+        warn = False
+        if "NCCL_P2P_DISABLE" not in current_env:
+            current_env["NCCL_P2P_DISABLE"] = "1"
+            warn = True
+        if "NCCL_IB_DISABLE" not in current_env:
+            current_env["NCCL_IB_DISABLE"] = "1"
+            warn = True
+        if warn:
+            logger.warning(message)
+
+    if args.num_machines > 1 and args.deepspeed_multinode_launcher != DEEPSPEED_MULTINODE_LAUNCHERS[1]:
+        with open(DEEPSPEED_ENVIRONMENT_NAME, "a") as f:
+            valid_env_items = convert_dict_to_env_variables(current_env)
+            if len(valid_env_items) > 1:
+                f.writelines(valid_env_items)
+
+        process = subprocess.Popen(cmd, env=current_env)
+        process.wait()
+        if process.returncode != 0:
+            if not args.quiet:
+                raise subprocess.CalledProcessError(returncode=process.returncode, cmd=cmd)
+            else:
+                sys.exit(1)
+    else:
+        debug = getattr(args, "debug", False)
+        args = _filter_args(
+            args,
+            distrib_run.get_args_parser(),
+            ["--training_script", args.training_script, "--training_script_args", args.training_script_args],
+        )
+        with patch_environment(**current_env):
+            try:
+                distrib_run.run(args)
+            except Exception:
+                if is_rich_available() and debug:
+                    console = get_console()
+                    console.print("\n[bold red]Using --debug, `torch.distributed` Stack Trace:[/bold red]")
+                    console.print_exception(suppress=[__file__], show_locals=False)
+                else:
+                    raise
+
+
+def tpu_launcher(args):
+    import torch_xla.distributed.xla_multiprocessing as xmp
+
+    if args.no_python:
+        raise ValueError("--no_python cannot be used with TPU launcher")
+
+    args, current_env = prepare_tpu(args, {})
+
+    if args.module:
+        mod_name = args.training_script
+    else:
+        # Import training_script as a module
+        script_path = Path(args.training_script)
+        sys.path.append(str(script_path.parent.resolve()))
+        mod_name = script_path.stem
+
+    mod = importlib.import_module(mod_name)
+    if not hasattr(mod, args.main_training_function):
+        raise ValueError(
+            f"Your training script should have a function named {args.main_training_function}, or you should pass a "
+            "different value to `--main_training_function`."
+        )
+
+    # Patch sys.argv
+    sys.argv = [mod.__file__] + args.training_script_args
+
+    main_function = getattr(mod, args.main_training_function)
+    with patch_environment(**current_env):
+        xmp.spawn(PrepareForLaunch(main_function), args=(), nprocs=args.num_processes)
+
+
+def tpu_pod_launcher(args):
+    from torch_xla.distributed import xla_dist
+
+    current_env = {}
+    args, current_env = prepare_tpu(args, current_env, True)
+    debug = getattr(args, "debug", False)
+
+    training_script = args.training_script
+    training_script_args = args.training_script_args
+    new_args = _filter_args(
+        args, xla_dist.get_args_parser(), ["--tpu", args.tpu_name, "--positional", "", "--restart-tpuvm-pod-server"]
+    )
+
+    if args.tpu_use_sudo:
+        new_cmd = ["sudo"]
+    else:
+        new_cmd = []
+
+    new_cmd += [
+        "accelerate-launch",
+        "--tpu",
+        "--no_tpu_cluster",
+        "--num_machines",
+        "1",
+        "--mixed_precision",
+        "no",
+        "--dynamo_backend",
+        "no",
+        "--num_processes",
+        str(args.num_processes),
+        "--main_training_function",
+        str(args.main_training_function),
+        training_script,
+    ] + training_script_args
+
+    new_args.positional = new_cmd
+    bad_flags = ""
+    for arg in vars(new_args):
+        if arg.startswith("docker_"):
+            value = getattr(new_args, arg)
+            if value != "" and value is not None:
+                bad_flags += f'{arg}="{value}"\n'
+    if bad_flags != "":
+        raise ValueError(
+            f"Docker containers are not supported for TPU pod launcher currently, please remove the following flags:\n{bad_flags}"
+        )
+    new_args.env = [f"{k}={v}" for k, v in current_env.items()]
+    new_args.env.append("ACCELERATE_IN_TPU_POD=1")
+    try:
+        xla_dist.resolve_and_execute(new_args)
+    except Exception:
+        if is_rich_available() and debug:
+            console = get_console()
+            console.print("\n[bold red]Using --debug, `torch_xla.xla_dist` Stack Trace:[/bold red]")
+            console.print_exception(suppress=[__file__], show_locals=False)
+        else:
+            raise
+
+
+def sagemaker_launcher(sagemaker_config: SageMakerConfig, args):
+    if not is_sagemaker_available():
+        raise ImportError(
+            "Please install sagemaker to be able to launch training on Amazon SageMaker with `pip install accelerate[sagemaker]`"
+        )
+    if args.module or args.no_python:
+        raise ValueError(
+            "SageMaker requires a python training script file and cannot be used with --module or --no_python"
+        )
+
+    from sagemaker.huggingface import HuggingFace
+
+    args, sagemaker_inputs = prepare_sagemager_args_inputs(sagemaker_config, args)
+
+    huggingface_estimator = HuggingFace(**args)
+
+    huggingface_estimator.fit(inputs=sagemaker_inputs)
+    print(f"You can find your model data at: {huggingface_estimator.model_data}")
+
+
+def _validate_launch_command(args):
+    # Sanity checks
+    if sum([args.multi_gpu, args.cpu, args.tpu, args.use_deepspeed, args.use_fsdp]) > 1:
+        raise ValueError(
+            "You can only use one of `--cpu`, `--multi_gpu`, `--tpu`, `--use_deepspeed`, `--use_fsdp` at a time."
+        )
+    if args.multi_gpu and (args.num_processes is not None) and (args.num_processes < 2):
+        raise ValueError("You need to use at least 2 processes to use `--multi_gpu`.")
+
+    defaults = None
+    warned = []
+    mp_from_config_flag = False
+    # Get the default from the config file.
+    if args.config_file is not None or os.path.isfile(default_config_file) and not args.cpu:
+        defaults = load_config_from_file(args.config_file)
+        if (
+            not args.multi_gpu
+            and not args.tpu
+            and not args.tpu_use_cluster
+            and not args.use_deepspeed
+            and not args.use_fsdp
+            and not args.use_megatron_lm
+        ):
+            args.use_deepspeed = defaults.distributed_type == DistributedType.DEEPSPEED
+            args.multi_gpu = (
+                True
+                if defaults.distributed_type
+                in (
+                    DistributedType.MULTI_GPU,
+                    DistributedType.MULTI_NPU,
+                    DistributedType.MULTI_MLU,
+                    DistributedType.MULTI_XPU,
+                )
+                else False
+            )
+            args.tpu = defaults.distributed_type == DistributedType.XLA
+            args.use_fsdp = defaults.distributed_type == DistributedType.FSDP
+            args.use_megatron_lm = defaults.distributed_type == DistributedType.MEGATRON_LM
+            args.tpu_use_cluster = defaults.tpu_use_cluster if args.tpu else False
+        if args.gpu_ids is None:
+            if defaults.gpu_ids is not None:
+                args.gpu_ids = defaults.gpu_ids
+            else:
+                args.gpu_ids = "all"
+
+        if args.multi_gpu and args.num_machines is None:
+            args.num_machines = defaults.num_machines
+
+        if len(args.gpu_ids.split(",")) < 2 and (args.gpu_ids != "all") and args.multi_gpu and args.num_machines <= 1:
+            raise ValueError(
+                "Less than two GPU ids were configured and tried to run on on multiple GPUs. "
+                "Please ensure at least two are specified for `--gpu_ids`, or use `--gpu_ids='all'`."
+            )
+        if defaults.compute_environment == ComputeEnvironment.LOCAL_MACHINE:
+            # Update args with the defaults
+            for name, attr in defaults.__dict__.items():
+                if isinstance(attr, dict):
+                    for k in defaults.deepspeed_config:
+                        setattr(args, k, defaults.deepspeed_config[k])
+                    for k in defaults.fsdp_config:
+                        arg_to_set = k
+                        if "fsdp" not in arg_to_set:
+                            arg_to_set = "fsdp_" + arg_to_set
+                        setattr(args, arg_to_set, defaults.fsdp_config[k])
+                    for k in defaults.megatron_lm_config:
+                        setattr(args, k, defaults.megatron_lm_config[k])
+                    for k in defaults.dynamo_config:
+                        setattr(args, k, defaults.dynamo_config[k])
+                    for k in defaults.ipex_config:
+                        setattr(args, k, defaults.ipex_config[k])
+                    for k in defaults.mpirun_config:
+                        setattr(args, k, defaults.mpirun_config[k])
+                    continue
+
+                # Those args are handled separately
+                if (
+                    name not in ["compute_environment", "mixed_precision", "distributed_type"]
+                    and getattr(args, name, None) is None
+                ):
+                    setattr(args, name, attr)
+        if not args.debug:
+            args.debug = defaults.debug
+
+        if not args.mixed_precision:
+            if defaults.mixed_precision is None:
+                args.mixed_precision = "no"
+            else:
+                args.mixed_precision = defaults.mixed_precision
+                mp_from_config_flag = True
+        else:
+            if args.use_cpu or (args.use_xpu and torch.xpu.is_available()):
+                native_amp = is_torch_version(">=", "1.10")
+            else:
+                native_amp = is_bf16_available(True)
+            if (
+                args.mixed_precision == "bf16"
+                and not native_amp
+                and not (args.tpu and is_torch_xla_available(check_is_tpu=True))
+            ):
+                raise ValueError("bf16 mixed precision requires PyTorch >= 1.10 and a supported device.")
+
+        # Silently set the default here
+        if args.dynamo_backend is None:
+            args.dynamo_backend = "no"
+    else:
+        if args.num_processes is None:
+            if args.use_xpu and is_xpu_available():
+                args.num_processes = torch.xpu.device_count()
+            elif is_mlu_available():
+                args.num_processes = torch.mlu.device_count()
+            elif is_npu_available():
+                args.num_processes = torch.npu.device_count()
+            else:
+                args.num_processes = torch.cuda.device_count()
+            warned.append(f"\t`--num_processes` was set to a value of `{args.num_processes}`")
+        if args.debug is None:
+            args.debug = False
+        if not args.multi_gpu and (
+            (args.use_xpu and is_xpu_available() and torch.xpu.device_count() > 1)
+            or (is_mlu_available() and torch.mlu.device_count() > 1)
+            or (is_npu_available() and torch.npu.device_count() > 1)
+            or (torch.cuda.device_count() > 1)
+        ):
+            warned.append(
+                "\t\tMore than one GPU was found, enabling multi-GPU training.\n"
+                "\t\tIf this was unintended please pass in `--num_processes=1`."
+            )
+            args.multi_gpu = True
+        if args.num_machines is None:
+            warned.append("\t`--num_machines` was set to a value of `1`")
+            args.num_machines = 1
+        if args.mixed_precision is None:
+            warned.append("\t`--mixed_precision` was set to a value of `'no'`")
+            args.mixed_precision = "no"
+        if not hasattr(args, "use_cpu"):
+            args.use_cpu = args.cpu
+        if args.dynamo_backend is None:
+            warned.append("\t`--dynamo_backend` was set to a value of `'no'`")
+            args.dynamo_backend = "no"
+    if args.debug:
+        logger.debug("Running script in debug mode, expect distributed operations to be slightly slower.")
+
+    is_aws_env_disabled = defaults is None or (
+        defaults is not None and defaults.compute_environment != ComputeEnvironment.AMAZON_SAGEMAKER
+    )
+    if is_aws_env_disabled and args.num_cpu_threads_per_process is None:
+        args.num_cpu_threads_per_process = 1
+        if args.use_cpu and args.num_processes >= 1:
+            local_size = get_int_from_env(
+                ["MPI_LOCALNRANKS", "OMPI_COMM_WORLD_LOCAL_SIZE", "MV2_COMM_WORLD_LOCAL_SIZE"], 1
+            )
+            threads_per_process = int(psutil.cpu_count(logical=False) / local_size)
+            if threads_per_process > 1:
+                args.num_cpu_threads_per_process = threads_per_process
+                warned.append(
+                    f"\t`--num_cpu_threads_per_process` was set to `{args.num_cpu_threads_per_process}` to improve out-of-box performance when training on CPUs"
+                )
+
+    if any(warned):
+        message = "The following values were not passed to `accelerate launch` and had defaults used instead:\n"
+        message += "\n".join(warned)
+        message += (
+            "\nTo avoid this warning pass in values for each of the problematic parameters or run `accelerate config`."
+        )
+        logger.warning(message)
+    return args, defaults, mp_from_config_flag
+
+
+def launch_command(args):
+    args, defaults, mp_from_config_flag = _validate_launch_command(args)
+    # Use the proper launcher
+    if args.use_deepspeed and not args.cpu:
+        args.deepspeed_fields_from_accelerate_config = list(defaults.deepspeed_config.keys()) if defaults else []
+        if mp_from_config_flag:
+            args.deepspeed_fields_from_accelerate_config.append("mixed_precision")
+        args.deepspeed_fields_from_accelerate_config = ",".join(args.deepspeed_fields_from_accelerate_config)
+        deepspeed_launcher(args)
+    elif args.use_fsdp and not args.cpu:
+        multi_gpu_launcher(args)
+    elif args.use_megatron_lm and not args.cpu:
+        multi_gpu_launcher(args)
+    elif args.multi_gpu and not args.cpu:
+        multi_gpu_launcher(args)
+    elif args.tpu and not args.cpu:
+        if args.tpu_use_cluster:
+            tpu_pod_launcher(args)
+        else:
+            tpu_launcher(args)
+    elif defaults is not None and defaults.compute_environment == ComputeEnvironment.AMAZON_SAGEMAKER:
+        sagemaker_launcher(defaults, args)
+    else:
+        simple_launcher(args)
+
+
+def main():
+    parser = launch_command_parser()
+    args = parser.parse_args()
+    launch_command(args)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/commands/menu/__init__.py b/llm/Lib/site-packages/accelerate/commands/menu/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2c851cc0b192ab8207d3fa68d7409868c84354c
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/menu/__init__.py
@@ -0,0 +1,14 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from .selection_menu import BulletMenu
diff --git a/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..273ad63861ed1efbb4a998150c260c56d38f9b4f
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/cursor.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/cursor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a21d7849431c39b763e20907f6db08582fc69ade
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/cursor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/helpers.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/helpers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4e7e60e2c4ba4919ac90cbc167300d5557e96872
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/helpers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/input.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/input.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d5ae84461c2e47070b2d361d2e61dd5b0d35cd06
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/input.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/keymap.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/keymap.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..79f312ba62324160b3ae54085d7c1ababf70c5f7
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/keymap.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/selection_menu.cpython-311.pyc b/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/selection_menu.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8a9715d0ede7bdb017d381c2d9ea2b45a0f47a29
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/commands/menu/__pycache__/selection_menu.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/commands/menu/cursor.py b/llm/Lib/site-packages/accelerate/commands/menu/cursor.py
new file mode 100644
index 0000000000000000000000000000000000000000..c1f0bb7b68025ae4fe0c2c76c095eb36b4e64f2c
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/menu/cursor.py
@@ -0,0 +1,65 @@
+# Copyright 2022 The HuggingFace Team and Brian Chao. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+A utility for showing and hiding the terminal cursor on Windows and Linux, based on https://github.com/bchao1/bullet
+"""
+
+import os
+import sys
+from contextlib import contextmanager
+
+
+# Windows only
+if os.name == "nt":
+    import ctypes
+    import msvcrt  # noqa
+
+    class CursorInfo(ctypes.Structure):
+        # _fields is a specific attr expected by ctypes
+        _fields_ = [("size", ctypes.c_int), ("visible", ctypes.c_byte)]
+
+
+def hide_cursor():
+    if os.name == "nt":
+        ci = CursorInfo()
+        handle = ctypes.windll.kernel32.GetStdHandle(-11)
+        ctypes.windll.kernel32.GetConsoleCursorInfo(handle, ctypes.byref(ci))
+        ci.visible = False
+        ctypes.windll.kernel32.SetConsoleCursorInfo(handle, ctypes.byref(ci))
+    elif os.name == "posix":
+        sys.stdout.write("\033[?25l")
+        sys.stdout.flush()
+
+
+def show_cursor():
+    if os.name == "nt":
+        ci = CursorInfo()
+        handle = ctypes.windll.kernel32.GetStdHandle(-11)
+        ctypes.windll.kernel32.GetConsoleCursorInfo(handle, ctypes.byref(ci))
+        ci.visible = True
+        ctypes.windll.kernel32.SetConsoleCursorInfo(handle, ctypes.byref(ci))
+    elif os.name == "posix":
+        sys.stdout.write("\033[?25h")
+        sys.stdout.flush()
+
+
+@contextmanager
+def hide():
+    "Context manager to hide the terminal cursor"
+    try:
+        hide_cursor()
+        yield
+    finally:
+        show_cursor()
diff --git a/llm/Lib/site-packages/accelerate/commands/menu/helpers.py b/llm/Lib/site-packages/accelerate/commands/menu/helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..de46f37ddcf4591167e3e01791391e4b1729034f
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/menu/helpers.py
@@ -0,0 +1,59 @@
+# Copyright 2022 The HuggingFace Team and Brian Chao. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+A variety of helper functions and constants when dealing with terminal menu choices, based on
+https://github.com/bchao1/bullet
+"""
+
+import enum
+import shutil
+import sys
+
+
+TERMINAL_WIDTH, _ = shutil.get_terminal_size()
+
+CURSOR_TO_CHAR = {"UP": "A", "DOWN": "B", "RIGHT": "C", "LEFT": "D"}
+
+
+class Direction(enum.Enum):
+    UP = 0
+    DOWN = 1
+
+
+def forceWrite(content, end=""):
+    sys.stdout.write(str(content) + end)
+    sys.stdout.flush()
+
+
+def writeColor(content, color, end=""):
+    forceWrite(f"\u001b[{color}m{content}\u001b[0m", end)
+
+
+def reset_cursor():
+    forceWrite("\r")
+
+
+def move_cursor(num_lines: int, direction: str):
+    forceWrite(f"\033[{num_lines}{CURSOR_TO_CHAR[direction.upper()]}")
+
+
+def clear_line():
+    forceWrite(" " * TERMINAL_WIDTH)
+    reset_cursor()
+
+
+def linebreak():
+    reset_cursor()
+    forceWrite("-" * TERMINAL_WIDTH)
diff --git a/llm/Lib/site-packages/accelerate/commands/menu/input.py b/llm/Lib/site-packages/accelerate/commands/menu/input.py
new file mode 100644
index 0000000000000000000000000000000000000000..2690f86aa61f7ac648f4a9c2040a34ee35147201
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/menu/input.py
@@ -0,0 +1,86 @@
+# Copyright 2022 The HuggingFace Team and Brian Chao. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+This file contains utilities for handling input from the user and registering specific keys to specific functions,
+based on https://github.com/bchao1/bullet
+"""
+
+from typing import List
+
+from .keymap import KEYMAP, get_character
+
+
+def mark(key: str):
+    """
+    Mark the function with the key code so it can be handled in the register
+    """
+
+    def decorator(func):
+        handle = getattr(func, "handle_key", [])
+        handle += [key]
+        func.handle_key = handle
+        return func
+
+    return decorator
+
+
+def mark_multiple(*keys: List[str]):
+    """
+    Mark the function with the key codes so it can be handled in the register
+    """
+
+    def decorator(func):
+        handle = getattr(func, "handle_key", [])
+        handle += keys
+        func.handle_key = handle
+        return func
+
+    return decorator
+
+
+class KeyHandler(type):
+    """
+    Metaclass that adds the key handlers to the class
+    """
+
+    def __new__(cls, name, bases, attrs):
+        new_cls = super().__new__(cls, name, bases, attrs)
+        if not hasattr(new_cls, "key_handler"):
+            new_cls.key_handler = {}
+        new_cls.handle_input = KeyHandler.handle_input
+
+        for value in attrs.values():
+            handled_keys = getattr(value, "handle_key", [])
+            for key in handled_keys:
+                new_cls.key_handler[key] = value
+        return new_cls
+
+    @staticmethod
+    def handle_input(cls):
+        "Finds and returns the selected character if it exists in the handler"
+        char = get_character()
+        if char != KEYMAP["undefined"]:
+            char = ord(char)
+        handler = cls.key_handler.get(char)
+        if handler:
+            cls.current_selection = char
+            return handler(cls)
+        else:
+            return None
+
+
+def register(cls):
+    """Adds KeyHandler metaclass to the class"""
+    return KeyHandler(cls.__name__, cls.__bases__, cls.__dict__.copy())
diff --git a/llm/Lib/site-packages/accelerate/commands/menu/keymap.py b/llm/Lib/site-packages/accelerate/commands/menu/keymap.py
new file mode 100644
index 0000000000000000000000000000000000000000..787db12860fe21c6786dda69c34fcccab114f2f8
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/menu/keymap.py
@@ -0,0 +1,133 @@
+# Copyright 2022 The HuggingFace Team and Brian Chao. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Utilities relating to parsing raw characters from the keyboard, based on https://github.com/bchao1/bullet
+"""
+
+import os
+import string
+import sys
+
+
+ARROW_KEY_FLAG = 1 << 8
+
+KEYMAP = {
+    "tab": ord("\t"),
+    "newline": ord("\r"),
+    "esc": 27,
+    "up": 65 + ARROW_KEY_FLAG,
+    "down": 66 + ARROW_KEY_FLAG,
+    "right": 67 + ARROW_KEY_FLAG,
+    "left": 68 + ARROW_KEY_FLAG,
+    "mod_int": 91,
+    "undefined": sys.maxsize,
+    "interrupt": 3,
+    "insert": 50,
+    "delete": 51,
+    "pg_up": 53,
+    "pg_down": 54,
+}
+
+KEYMAP["arrow_begin"] = KEYMAP["up"]
+KEYMAP["arrow_end"] = KEYMAP["left"]
+
+if sys.platform == "win32":
+    WIN_CH_BUFFER = []
+    WIN_KEYMAP = {
+        b"\xe0H": KEYMAP["up"] - ARROW_KEY_FLAG,
+        b"\x00H": KEYMAP["up"] - ARROW_KEY_FLAG,
+        b"\xe0P": KEYMAP["down"] - ARROW_KEY_FLAG,
+        b"\x00P": KEYMAP["down"] - ARROW_KEY_FLAG,
+        b"\xe0M": KEYMAP["right"] - ARROW_KEY_FLAG,
+        b"\x00M": KEYMAP["right"] - ARROW_KEY_FLAG,
+        b"\xe0K": KEYMAP["left"] - ARROW_KEY_FLAG,
+        b"\x00K": KEYMAP["left"] - ARROW_KEY_FLAG,
+    }
+
+for i in range(10):
+    KEYMAP[str(i)] = ord(str(i))
+
+
+def get_raw_chars():
+    "Gets raw characters from inputs"
+    if os.name == "nt":
+        import msvcrt
+
+        encoding = "mbcs"
+        # Flush the keyboard buffer
+        while msvcrt.kbhit():
+            msvcrt.getch()
+        if len(WIN_CH_BUFFER) == 0:
+            # Read the keystroke
+            ch = msvcrt.getch()
+
+            # If it is a prefix char, get second part
+            if ch in (b"\x00", b"\xe0"):
+                ch2 = ch + msvcrt.getch()
+                # Translate actual Win chars to bullet char types
+                try:
+                    chx = chr(WIN_KEYMAP[ch2])
+                    WIN_CH_BUFFER.append(chr(KEYMAP["mod_int"]))
+                    WIN_CH_BUFFER.append(chx)
+                    if ord(chx) in (
+                        KEYMAP["insert"] - 1 << 9,
+                        KEYMAP["delete"] - 1 << 9,
+                        KEYMAP["pg_up"] - 1 << 9,
+                        KEYMAP["pg_down"] - 1 << 9,
+                    ):
+                        WIN_CH_BUFFER.append(chr(126))
+                    ch = chr(KEYMAP["esc"])
+                except KeyError:
+                    ch = ch2[1]
+            else:
+                ch = ch.decode(encoding)
+        else:
+            ch = WIN_CH_BUFFER.pop(0)
+    elif os.name == "posix":
+        import termios
+        import tty
+
+        fd = sys.stdin.fileno()
+        old_settings = termios.tcgetattr(fd)
+        try:
+            tty.setraw(fd)
+            ch = sys.stdin.read(1)
+        finally:
+            termios.tcsetattr(fd, termios.TCSADRAIN, old_settings)
+    return ch
+
+
+def get_character():
+    "Gets a character from the keyboard and returns the key code"
+    char = get_raw_chars()
+    if ord(char) in [KEYMAP["interrupt"], KEYMAP["newline"]]:
+        return char
+
+    elif ord(char) == KEYMAP["esc"]:
+        combo = get_raw_chars()
+        if ord(combo) == KEYMAP["mod_int"]:
+            key = get_raw_chars()
+            if ord(key) >= KEYMAP["arrow_begin"] - ARROW_KEY_FLAG and ord(key) <= KEYMAP["arrow_end"] - ARROW_KEY_FLAG:
+                return chr(ord(key) + ARROW_KEY_FLAG)
+            else:
+                return KEYMAP["undefined"]
+        else:
+            return get_raw_chars()
+
+    else:
+        if char in string.printable:
+            return char
+        else:
+            return KEYMAP["undefined"]
diff --git a/llm/Lib/site-packages/accelerate/commands/menu/selection_menu.py b/llm/Lib/site-packages/accelerate/commands/menu/selection_menu.py
new file mode 100644
index 0000000000000000000000000000000000000000..ee9a771a54ef666ee46b67ae6c75fb957d49efdd
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/menu/selection_menu.py
@@ -0,0 +1,144 @@
+# Copyright 2022 The HuggingFace Team and Brian Chao. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Main driver for the selection menu, based on https://github.com/bchao1/bullet
+"""
+
+import builtins
+import sys
+
+from ...utils.imports import _is_package_available
+from . import cursor, input
+from .helpers import Direction, clear_line, forceWrite, linebreak, move_cursor, reset_cursor, writeColor
+from .keymap import KEYMAP
+
+
+in_colab = False
+try:
+    in_colab = _is_package_available("google.colab")
+except ModuleNotFoundError:
+    pass
+
+
+@input.register
+class BulletMenu:
+    """
+    A CLI menu to select a choice from a list of choices using the keyboard.
+    """
+
+    def __init__(self, prompt: str = None, choices: list = []):
+        self.position = 0
+        self.choices = choices
+        self.prompt = prompt
+        if sys.platform == "win32":
+            self.arrow_char = "*"
+        else:
+            self.arrow_char = "➔ "
+
+    def write_choice(self, index, end: str = ""):
+        if sys.platform != "win32":
+            writeColor(self.choices[index], 32, end)
+        else:
+            forceWrite(self.choices[index], end)
+
+    def print_choice(self, index: int):
+        "Prints the choice at the given index"
+        if index == self.position:
+            forceWrite(f" {self.arrow_char} ")
+            self.write_choice(index)
+        else:
+            forceWrite(f"    {self.choices[index]}")
+        reset_cursor()
+
+    def move_direction(self, direction: Direction, num_spaces: int = 1):
+        "Should not be directly called, used to move a direction of either up or down"
+        old_position = self.position
+        if direction == Direction.DOWN:
+            if self.position + 1 >= len(self.choices):
+                return
+            self.position += num_spaces
+        else:
+            if self.position - 1 < 0:
+                return
+            self.position -= num_spaces
+        clear_line()
+        self.print_choice(old_position)
+        move_cursor(num_spaces, direction.name)
+        self.print_choice(self.position)
+
+    @input.mark(KEYMAP["up"])
+    def move_up(self):
+        self.move_direction(Direction.UP)
+
+    @input.mark(KEYMAP["down"])
+    def move_down(self):
+        self.move_direction(Direction.DOWN)
+
+    @input.mark(KEYMAP["newline"])
+    def select(self):
+        move_cursor(len(self.choices) - self.position, "DOWN")
+        return self.position
+
+    @input.mark(KEYMAP["interrupt"])
+    def interrupt(self):
+        move_cursor(len(self.choices) - self.position, "DOWN")
+        raise KeyboardInterrupt
+
+    @input.mark_multiple(*[KEYMAP[str(number)] for number in range(10)])
+    def select_row(self):
+        index = int(chr(self.current_selection))
+        movement = index - self.position
+        if index == self.position:
+            return
+        if index < len(self.choices):
+            if self.position > index:
+                self.move_direction(Direction.UP, -movement)
+            elif self.position < index:
+                self.move_direction(Direction.DOWN, movement)
+            else:
+                return
+        else:
+            return
+
+    def run(self, default_choice: int = 0):
+        "Start the menu and return the selected choice"
+        if self.prompt:
+            linebreak()
+            forceWrite(self.prompt, "\n")
+            if in_colab:
+                forceWrite("Please input a choice index (starting from 0), and press enter", "\n")
+            else:
+                forceWrite("Please select a choice using the arrow or number keys, and selecting with enter", "\n")
+        self.position = default_choice
+        for i in range(len(self.choices)):
+            self.print_choice(i)
+            forceWrite("\n")
+        move_cursor(len(self.choices) - self.position, "UP")
+        with cursor.hide():
+            while True:
+                if in_colab:
+                    try:
+                        choice = int(builtins.input())
+                    except ValueError:
+                        choice = default_choice
+                else:
+                    choice = self.handle_input()
+                if choice is not None:
+                    reset_cursor()
+                    for _ in range(len(self.choices) + 1):
+                        move_cursor(1, "UP")
+                        clear_line()
+                    self.write_choice(choice, "\n")
+                    return choice
diff --git a/llm/Lib/site-packages/accelerate/commands/test.py b/llm/Lib/site-packages/accelerate/commands/test.py
new file mode 100644
index 0000000000000000000000000000000000000000..a0d2f7bcf14727aa13e3438f4cd6e6f140f5bb2f
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/test.py
@@ -0,0 +1,65 @@
+#!/usr/bin/env python
+
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import argparse
+
+from accelerate.test_utils import execute_subprocess_async, path_in_accelerate_package
+
+
+def test_command_parser(subparsers=None):
+    if subparsers is not None:
+        parser = subparsers.add_parser("test")
+    else:
+        parser = argparse.ArgumentParser("Accelerate test command")
+
+    parser.add_argument(
+        "--config_file",
+        default=None,
+        help=(
+            "The path to use to store the config file. Will default to a file named default_config.yaml in the cache "
+            "location, which is the content of the environment `HF_HOME` suffixed with 'accelerate', or if you don't have "
+            "such an environment variable, your cache directory ('~/.cache' or the content of `XDG_CACHE_HOME`) suffixed "
+            "with 'huggingface'."
+        ),
+    )
+
+    if subparsers is not None:
+        parser.set_defaults(func=test_command)
+    return parser
+
+
+def test_command(args):
+    script_name = path_in_accelerate_package("test_utils", "scripts", "test_script.py")
+
+    if args.config_file is None:
+        test_args = [script_name]
+    else:
+        test_args = f"--config_file={args.config_file} {script_name}".split()
+
+    cmd = ["accelerate-launch"] + test_args
+    result = execute_subprocess_async(cmd)
+    if result.returncode == 0:
+        print("Test is a success! You are ready for your distributed training!")
+
+
+def main():
+    parser = test_command_parser()
+    args = parser.parse_args()
+    test_command(args)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/commands/tpu.py b/llm/Lib/site-packages/accelerate/commands/tpu.py
new file mode 100644
index 0000000000000000000000000000000000000000..fc0f07bf8697bfdb6484d3bf817f2e18b1313b00
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/tpu.py
@@ -0,0 +1,157 @@
+#!/usr/bin/env python
+
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import argparse
+import os
+import subprocess
+
+from packaging.version import Version, parse
+
+from accelerate.commands.config.config_args import default_config_file, load_config_from_file
+
+
+_description = "Run commands across TPU VMs for initial setup before running `accelerate launch`."
+
+
+def tpu_command_parser(subparsers=None):
+    if subparsers is not None:
+        parser = subparsers.add_parser("tpu-config", description=_description)
+    else:
+        parser = argparse.ArgumentParser("Accelerate tpu-config command", description=_description)
+    # Core arguments
+    config_args = parser.add_argument_group(
+        "Config Arguments", "Arguments that can be configured through `accelerate config`."
+    )
+    config_args.add_argument(
+        "--config_file",
+        type=str,
+        default=None,
+        help="Path to the config file to use for accelerate.",
+    )
+    config_args.add_argument(
+        "--tpu_name",
+        default=None,
+        help="The name of the TPU to use. If not specified, will use the TPU specified in the config file.",
+    )
+    config_args.add_argument(
+        "--tpu_zone",
+        default=None,
+        help="The zone of the TPU to use. If not specified, will use the zone specified in the config file.",
+    )
+    pod_args = parser.add_argument_group("TPU Arguments", "Arguments for options ran inside the TPU.")
+    pod_args.add_argument(
+        "--use_alpha",
+        action="store_true",
+        help="Whether to use `gcloud alpha` when running the TPU training script instead of `gcloud`.",
+    )
+    pod_args.add_argument(
+        "--command_file",
+        default=None,
+        help="The path to the file containing the commands to run on the pod on startup.",
+    )
+    pod_args.add_argument(
+        "--command",
+        action="append",
+        nargs="+",
+        help="A command to run on the pod. Can be passed multiple times.",
+    )
+    pod_args.add_argument(
+        "--install_accelerate",
+        action="store_true",
+        help="Whether to install accelerate on the pod. Defaults to False.",
+    )
+    pod_args.add_argument(
+        "--accelerate_version",
+        default="latest",
+        help="The version of accelerate to install on the pod. If not specified, will use the latest pypi version. Specify 'dev' to install from GitHub.",
+    )
+    pod_args.add_argument(
+        "--debug", action="store_true", help="If set, will print the command that would be run instead of running it."
+    )
+
+    if subparsers is not None:
+        parser.set_defaults(func=tpu_command_launcher)
+    return parser
+
+
+def tpu_command_launcher(args):
+    defaults = None
+
+    # Get the default from the config file if it exists.
+    if args.config_file is not None or os.path.isfile(default_config_file):
+        defaults = load_config_from_file(args.config_file)
+        if not args.command_file and defaults.command_file is not None and not args.command:
+            args.command_file = defaults.command_file
+        if not args.command and defaults.commands is not None:
+            args.command = defaults.commands
+        if not args.tpu_name:
+            args.tpu_name = defaults.tpu_name
+        if not args.tpu_zone:
+            args.tpu_zone = defaults.tpu_zone
+    if args.accelerate_version == "dev":
+        args.accelerate_version = "git+https://github.com/huggingface/accelerate.git"
+    elif args.accelerate_version == "latest":
+        args.accelerate_version = "accelerate -U"
+    elif isinstance(parse(args.accelerate_version), Version):
+        args.accelerate_version = f"accelerate=={args.accelerate_version}"
+
+    if not args.command_file and not args.command:
+        raise ValueError("You must specify either a command file or a command to run on the pod.")
+
+    if args.command_file:
+        with open(args.command_file) as f:
+            args.command = [f.read().splitlines()]
+
+    # To turn list of lists into list of strings
+    if isinstance(args.command[0], list):
+        args.command = [line for cmd in args.command for line in cmd]
+    # Default to the shared folder and install accelerate
+    new_cmd = ["cd /usr/share"]
+    if args.install_accelerate:
+        new_cmd += [f"pip install {args.accelerate_version}"]
+    new_cmd += args.command
+    args.command = "; ".join(new_cmd)
+
+    # Then send it to gcloud
+    # Eventually try to use google-api-core to do this instead of subprocess
+    cmd = ["gcloud"]
+    if args.use_alpha:
+        cmd += ["alpha"]
+    cmd += [
+        "compute",
+        "tpus",
+        "tpu-vm",
+        "ssh",
+        args.tpu_name,
+        "--zone",
+        args.tpu_zone,
+        "--command",
+        args.command,
+        "--worker",
+        "all",
+    ]
+    if args.debug:
+        print(f"Running {' '.join(cmd)}")
+        return
+    subprocess.run(cmd)
+    print("Successfully setup pod.")
+
+
+def main():
+    parser = tpu_command_parser()
+    args = parser.parse_args()
+
+    tpu_command_launcher(args)
diff --git a/llm/Lib/site-packages/accelerate/commands/utils.py b/llm/Lib/site-packages/accelerate/commands/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..b65215fac7666b475af98b17e264ef6701239bc1
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/commands/utils.py
@@ -0,0 +1,120 @@
+# Copyright 2024 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import argparse
+
+
+class _StoreAction(argparse.Action):
+    """
+    Custom action that allows for `-` or `_` to be passed in for an argument.
+    """
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        new_option_strings = []
+        for option_string in self.option_strings:
+            new_option_strings.append(option_string)
+            if "_" in option_string[2:]:
+                # Add `-` version to the option string
+                new_option_strings.append(option_string.replace("_", "-"))
+        self.option_strings = new_option_strings
+
+    def __call__(self, parser, namespace, values, option_string=None):
+        setattr(namespace, self.dest, values)
+
+
+class _StoreConstAction(_StoreAction):
+    """
+    Same as `argparse._StoreConstAction` but uses the custom `_StoreAction`.
+    """
+
+    def __init__(self, option_strings, dest, const, default=None, required=False, help=None):
+        super().__init__(
+            option_strings=option_strings,
+            dest=dest,
+            nargs=0,
+            const=const,
+            default=default,
+            required=required,
+            help=help,
+        )
+
+    def __call__(self, parser, namespace, values, option_string=None):
+        setattr(namespace, self.dest, self.const)
+
+
+class _StoreTrueAction(_StoreConstAction):
+    """
+    Same as `argparse._StoreTrueAction` but uses the custom `_StoreConstAction`.
+    """
+
+    def __init__(
+        self,
+        option_strings,
+        dest,
+        default=None,
+        required=False,
+        help=None,
+    ):
+        super().__init__(
+            option_strings=option_strings, dest=dest, const=True, default=default, required=required, help=help
+        )
+
+
+class CustomArgumentGroup(argparse._ArgumentGroup):
+    """
+    Custom argument group that allows for the use of `-` or `_` in arguments passed and overrides the help for each
+    when applicable.
+    """
+
+    def _add_action(self, action):
+        args = vars(action)
+        if isinstance(action, argparse._StoreTrueAction):
+            action = _StoreTrueAction(
+                args["option_strings"], args["dest"], args["default"], args["required"], args["help"]
+            )
+        elif isinstance(action, argparse._StoreConstAction):
+            action = _StoreConstAction(
+                args["option_strings"],
+                args["dest"],
+                args["const"],
+                args["default"],
+                args["required"],
+                args["help"],
+            )
+        elif isinstance(action, argparse._StoreAction):
+            action = _StoreAction(**args)
+        action = super()._add_action(action)
+        return action
+
+
+class CustomArgumentParser(argparse.ArgumentParser):
+    """
+    Custom argument parser that allows for the use of `-` or `_` in arguments passed and overrides the help for each
+    when applicable.
+    """
+
+    def add_argument(self, *args, **kwargs):
+        if "action" in kwargs:
+            # Translate action -> class
+            if kwargs["action"] == "store_true":
+                kwargs["action"] = _StoreTrueAction
+        else:
+            kwargs["action"] = _StoreAction
+        super().add_argument(*args, **kwargs)
+
+    def add_argument_group(self, *args, **kwargs):
+        group = CustomArgumentGroup(self, *args, **kwargs)
+        self._action_groups.append(group)
+        return group
diff --git a/llm/Lib/site-packages/accelerate/data_loader.py b/llm/Lib/site-packages/accelerate/data_loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..0764e0971a3845d04dc1c7fc500d0c06f67d2c0e
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/data_loader.py
@@ -0,0 +1,1093 @@
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import math
+from contextlib import suppress
+from typing import Callable, List, Optional, Union
+
+import torch
+from torch.utils.data import BatchSampler, DataLoader, IterableDataset, RandomSampler
+
+from .logging import get_logger
+from .state import AcceleratorState, DistributedType, GradientState, is_torch_xla_available
+from .utils import (
+    RNGType,
+    broadcast,
+    broadcast_object_list,
+    concatenate,
+    find_batch_size,
+    get_data_structure,
+    initialize_tensors,
+    is_torch_version,
+    send_to_device,
+    slice_tensors,
+    synchronize_rng_states,
+)
+
+
+logger = get_logger(__name__)
+
+# kwargs of the DataLoader in min version 1.4.0.
+_PYTORCH_DATALOADER_KWARGS = {
+    "batch_size": 1,
+    "shuffle": False,
+    "sampler": None,
+    "batch_sampler": None,
+    "num_workers": 0,
+    "collate_fn": None,
+    "pin_memory": False,
+    "drop_last": False,
+    "timeout": 0,
+    "worker_init_fn": None,
+    "multiprocessing_context": None,
+    "generator": None,
+    "prefetch_factor": 2,
+    "persistent_workers": False,
+}
+
+# kwargs added after by version
+_PYTORCH_DATALOADER_ADDITIONAL_KWARGS = {}
+
+for v, additional_kwargs in _PYTORCH_DATALOADER_ADDITIONAL_KWARGS.items():
+    if is_torch_version(">=", v):
+        _PYTORCH_DATALOADER_KWARGS.update(additional_kwargs)
+
+
+class SeedableRandomSampler(RandomSampler):
+    """
+    Same as a random sampler, except that in `__iter__` a seed can be used.
+
+    Needed specifically in distributed cases, when the random generator for each GPU needs to start from the same seed
+    and be fully reproducable on multiple iterations.
+
+    If a custom `generator` is passed, it will rely on its initial seed as well as the current iteration it is on
+    (stored in `self.epoch`).
+    """
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.epoch = 0
+        self.initial_seed = torch.random.initial_seed()
+
+    def __iter__(self):
+        if self.generator is None:
+            self.generator = torch.Generator()
+            self.generator.manual_seed(self.initial_seed)
+
+        # Allow `self.epoch` to modify the seed of the generator
+        seed = self.epoch + self.initial_seed
+        # print("Setting seed at epoch", self.epoch, seed)
+        self.generator.manual_seed(seed)
+        yield from super().__iter__()
+        self.set_epoch(self.epoch + 1)
+
+    def set_epoch(self, epoch: int):
+        "Sets the current iteration of the sampler."
+        self.epoch = epoch
+
+
+class BatchSamplerShard(BatchSampler):
+    """
+    Wraps a PyTorch `BatchSampler` to generate batches for one of the processes only. Instances of this class will
+    always yield a number of batches that is a round multiple of `num_processes` and that all have the same size.
+    Depending on the value of the `drop_last` attribute of the batch sampler passed, it will either stop the iteration
+    at the first batch that would be too small / not present on all processes or loop with indices from the beginning.
+
+    Args:
+        batch_sampler (`torch.utils.data.sampler.BatchSampler`):
+            The batch sampler to split in several shards.
+        num_processes (`int`, *optional*, defaults to 1):
+            The number of processes running concurrently.
+        process_index (`int`, *optional*, defaults to 0):
+            The index of the current process.
+        split_batches (`bool`, *optional*, defaults to `False`):
+            Whether the shards should be created by splitting a batch to give a piece of it on each process, or by
+            yielding different full batches on each process.
+
+            On two processes with a sampler of `[[0, 1, 2, 3], [4, 5, 6, 7]]`, this will result in:
+
+            - the sampler on process 0 to yield `[0, 1, 2, 3]` and the sampler on process 1 to yield `[4, 5, 6, 7]` if
+              this argument is set to `False`.
+            - the sampler on process 0 to yield `[0, 1]` then `[4, 5]` and the sampler on process 1 to yield `[2, 3]`
+              then `[6, 7]` if this argument is set to `True`.
+        even_batches (`bool`, *optional*, defaults to `True`):
+            Whether or not to loop back at the beginning of the sampler when the number of samples is not a round
+            multiple of (original batch size / number of processes).
+
+    <Tip warning={true}>
+
+    `BatchSampler`s with varying batch sizes are not enabled by default. To enable this behaviour, set `even_batches`
+    equal to `False`
+
+    </Tip>"""
+
+    def __init__(
+        self,
+        batch_sampler: BatchSampler,
+        num_processes: int = 1,
+        process_index: int = 0,
+        split_batches: bool = False,
+        even_batches: bool = True,
+    ):
+        if split_batches and batch_sampler.batch_size % num_processes != 0:
+            raise ValueError(
+                f"To use `BatchSamplerShard` in `split_batches` mode, the batch size ({batch_sampler.batch_size}) "
+                f"needs to be a round multiple of the number of processes ({num_processes})."
+            )
+        self.batch_sampler = batch_sampler
+        self.num_processes = num_processes
+        self.process_index = process_index
+        self.split_batches = split_batches
+        self.even_batches = even_batches
+        self.batch_size = getattr(batch_sampler, "batch_size", None)
+        self.drop_last = getattr(batch_sampler, "drop_last", False)
+        if self.batch_size is None and self.even_batches:
+            raise ValueError(
+                "You need to use `even_batches=False` when the batch sampler has no batch size. If you "
+                "are not calling this method directly, set `accelerator.even_batches=False` instead."
+            )
+
+    @property
+    def total_length(self):
+        return len(self.batch_sampler)
+
+    def __len__(self):
+        if self.split_batches:
+            # Split batches does not change the length of the batch sampler
+            return len(self.batch_sampler)
+        if len(self.batch_sampler) % self.num_processes == 0:
+            # If the length is a round multiple of the number of processes, it's easy.
+            return len(self.batch_sampler) // self.num_processes
+        length = len(self.batch_sampler) // self.num_processes
+        if self.drop_last:
+            # Same if we drop the remainder.
+            return length
+        elif self.even_batches:
+            # When we even batches we always get +1
+            return length + 1
+        else:
+            # Otherwise it depends on the process index.
+            return length + 1 if self.process_index < len(self.batch_sampler) % self.num_processes else length
+
+    def __iter__(self):
+        return self._iter_with_split() if self.split_batches else self._iter_with_no_split()
+
+    def _iter_with_split(self):
+        initial_data = []
+        batch_length = self.batch_sampler.batch_size // self.num_processes
+        for idx, batch in enumerate(self.batch_sampler):
+            if idx == 0:
+                initial_data = batch
+            if len(batch) == self.batch_size:
+                # If the batch is full, we yield the part of it this process is responsible of.
+                yield batch[batch_length * self.process_index : batch_length * (self.process_index + 1)]
+
+        # If drop_last is True of the last batch was full, iteration is over, otherwise...
+        if not self.drop_last and len(initial_data) > 0 and len(batch) < self.batch_size:
+            if not self.even_batches:
+                if len(batch) > batch_length * self.process_index:
+                    yield batch[batch_length * self.process_index : batch_length * (self.process_index + 1)]
+            else:
+                # For degenerate cases where the dataset has less than num_process * batch_size samples
+                while len(initial_data) < self.batch_size:
+                    initial_data += initial_data
+                batch = batch + initial_data
+                yield batch[batch_length * self.process_index : batch_length * (self.process_index + 1)]
+
+    def _iter_with_no_split(self):
+        initial_data = []
+        batch_to_yield = []
+        for idx, batch in enumerate(self.batch_sampler):
+            # We gather the initial indices in case we need to circle back at the end.
+            if not self.drop_last and idx < self.num_processes:
+                initial_data += batch
+            # We identify the batch to yield but wait until we ar sure every process gets a full batch before actually
+            # yielding it.
+            if idx % self.num_processes == self.process_index:
+                batch_to_yield = batch
+            if idx % self.num_processes == self.num_processes - 1 and (
+                self.batch_size is None or len(batch) == self.batch_size
+            ):
+                yield batch_to_yield
+                batch_to_yield = []
+
+        # If drop_last is True, iteration is over, otherwise...
+        if not self.drop_last and len(initial_data) > 0:
+            if not self.even_batches:
+                if len(batch_to_yield) > 0:
+                    yield batch_to_yield
+            else:
+                # ... we yield the complete batch we had saved before if it has the proper length
+                if len(batch_to_yield) == self.batch_size:
+                    yield batch_to_yield
+
+                # For degenerate cases where the dataset has less than num_process * batch_size samples
+                while len(initial_data) < self.num_processes * self.batch_size:
+                    initial_data += initial_data
+
+                # If the last batch seen was of the proper size, it has been yielded by its process so we move to the next
+                if len(batch) == self.batch_size:
+                    batch = []
+                    idx += 1
+
+                # Make sure we yield a multiple of self.num_processes batches
+                cycle_index = 0
+                while idx % self.num_processes != 0 or len(batch) > 0:
+                    end_index = cycle_index + self.batch_size - len(batch)
+                    batch += initial_data[cycle_index:end_index]
+                    if idx % self.num_processes == self.process_index:
+                        yield batch
+                    cycle_index = end_index
+                    batch = []
+                    idx += 1
+
+
+class IterableDatasetShard(IterableDataset):
+    """
+    Wraps a PyTorch `IterableDataset` to generate samples for one of the processes only. Instances of this class will
+    always yield a number of samples that is a round multiple of the actual batch size (depending of the value of
+    `split_batches`, this is either `batch_size` or `batch_size x num_processes`). Depending on the value of the
+    `drop_last` attribute of the batch sampler passed, it will either stop the iteration at the first batch that would
+    be too small or loop with indices from the beginning.
+
+    Args:
+        dataset (`torch.utils.data.dataset.IterableDataset`):
+            The batch sampler to split in several shards.
+        batch_size (`int`, *optional*, defaults to 1):
+            The size of the batches per shard (if `split_batches=False`) or the size of the batches (if
+            `split_batches=True`).
+        drop_last (`bool`, *optional*, defaults to `False`):
+            Whether or not to drop the last incomplete batch or complete the last batches by using the samples from the
+            beginning.
+        num_processes (`int`, *optional*, defaults to 1):
+            The number of processes running concurrently.
+        process_index (`int`, *optional*, defaults to 0):
+            The index of the current process.
+        split_batches (`bool`, *optional*, defaults to `False`):
+            Whether the shards should be created by splitting a batch to give a piece of it on each process, or by
+            yielding different full batches on each process.
+
+            On two processes with an iterable dataset yielding of `[0, 1, 2, 3, 4, 5, 6, 7]`, this will result in:
+
+            - the shard on process 0 to yield `[0, 1, 2, 3]` and the shard on process 1 to yield `[4, 5, 6, 7]` if this
+              argument is set to `False`.
+            - the shard on process 0 to yield `[0, 1, 4, 5]` and the sampler on process 1 to yield `[2, 3, 6, 7]` if
+              this argument is set to `True`.
+    """
+
+    def __init__(
+        self,
+        dataset: IterableDataset,
+        batch_size: int = 1,
+        drop_last: bool = False,
+        num_processes: int = 1,
+        process_index: int = 0,
+        split_batches: bool = False,
+    ):
+        if split_batches and batch_size > 1 and batch_size % num_processes != 0:
+            raise ValueError(
+                f"To use `IterableDatasetShard` in `split_batches` mode, the batch size ({batch_size}) "
+                f"needs to be a round multiple of the number of processes ({num_processes})."
+            )
+        self.dataset = dataset
+        self.batch_size = batch_size
+        self.drop_last = drop_last
+        self.num_processes = num_processes
+        self.process_index = process_index
+        self.split_batches = split_batches
+
+    def set_epoch(self, epoch):
+        self.epoch = epoch
+        if hasattr(self.dataset, "set_epoch"):
+            self.dataset.set_epoch(epoch)
+
+    def __len__(self):
+        # We will just raise the downstream error if the underlying dataset is not sized
+        if self.drop_last:
+            return (len(self.dataset) // (self.batch_size * self.num_processes)) * self.batch_size
+        else:
+            return math.ceil(len(self.dataset) / (self.batch_size * self.num_processes)) * self.batch_size
+
+    def __iter__(self):
+        if (
+            not hasattr(self.dataset, "set_epoch")
+            and hasattr(self.dataset, "generator")
+            and isinstance(self.dataset.generator, torch.Generator)
+        ):
+            self.dataset.generator.manual_seed(self.epoch)
+        real_batch_size = self.batch_size if self.split_batches else (self.batch_size * self.num_processes)
+        process_batch_size = (self.batch_size // self.num_processes) if self.split_batches else self.batch_size
+        process_slice = range(self.process_index * process_batch_size, (self.process_index + 1) * process_batch_size)
+
+        first_batch = None
+        current_batch = []
+        for element in self.dataset:
+            current_batch.append(element)
+            # Wait to have a full batch before yielding elements.
+            if len(current_batch) == real_batch_size:
+                for i in process_slice:
+                    yield current_batch[i]
+                if first_batch is None:
+                    first_batch = current_batch.copy()
+                current_batch = []
+
+        # Finished if drop_last is True, otherwise complete the last batch with elements from the beginning.
+        if not self.drop_last and len(current_batch) > 0:
+            if first_batch is None:
+                first_batch = current_batch.copy()
+            while len(current_batch) < real_batch_size:
+                current_batch += first_batch
+            for i in process_slice:
+                yield current_batch[i]
+
+
+class DataLoaderStateMixin:
+    """
+    Mixin class that adds a state to a `DataLoader` to keep track of the status inside the dataloader such as at the
+    end of the iteration, the number of items in the dataset in the last batch relative to the batch size, and other
+    useful information that might be needed.
+
+    **Available attributes:**
+
+        - **end_of_dataloader** (`bool`) -- Whether at the last iteration or batch
+        - **remainder** (`int`) -- The number of items that are remaining in the last batch, relative to the total
+          batch size
+
+    """
+
+    def __init_subclass__(cls, **kwargs):
+        cls.end_of_dataloader = False
+        cls.remainder = -1
+
+    def reset(self):
+        self.end_of_dataloader = False
+        self.remainder = -1
+
+    def begin(self):
+        "Prepares the gradient state for the current dataloader"
+        self.reset()
+        with suppress(Exception):
+            if not self._drop_last:
+                length = getattr(self.dataset, "total_dataset_length", len(self.dataset))
+                self.remainder = length % self.total_batch_size
+        self.gradient_state._add_dataloader(self)
+
+    def end(self):
+        "Cleans up the gradient state after exiting the dataloader"
+        self.gradient_state._remove_dataloader(self)
+
+
+class DataLoaderShard(DataLoader, DataLoaderStateMixin):
+    """
+    Subclass of a PyTorch `DataLoader` that will deal with device placement and current distributed setup.
+
+    Args:
+        dataset (`torch.utils.data.dataset.Dataset`):
+            The dataset to use to build this datalaoder.
+        device (`torch.device`, *optional*):
+            If passed, the device to put all batches on.
+        rng_types (list of `str` or [`~utils.RNGType`]):
+            The list of random number generators to synchronize at the beginning of each iteration. Should be one or
+            several of:
+
+            - `"torch"`: the base torch random number generator
+            - `"cuda"`: the CUDA random number generator (GPU only)
+            - `"xla"`: the XLA random number generator (TPU only)
+            - `"generator"`: an optional `torch.Generator`
+        synchronized_generator (`torch.Generator`, *optional*):
+            A random number generator to keep synchronized across processes.
+        skip_batches (`int`, *optional*, defaults to 0):
+            The number of batches to skip at the beginning.
+        **kwargs (additional keyword arguments, *optional*):
+            All other keyword arguments to pass to the regular `DataLoader` initialization.
+
+    **Available attributes:**
+
+        - **total_batch_size** (`int`) -- Total batch size of the dataloader across all processes.
+            Equal to the original batch size when `split_batches=True`; otherwise the original batch size * the total
+            number of processes
+
+        - **total_dataset_length** (`int`) -- Total length of the inner dataset across all processes.
+    """
+
+    def __init__(
+        self,
+        dataset,
+        device=None,
+        rng_types=None,
+        synchronized_generator=None,
+        skip_batches=0,
+        _drop_last: bool = False,
+        **kwargs,
+    ):
+        super().__init__(dataset, **kwargs)
+        self.device = device
+        self.rng_types = rng_types
+        self.synchronized_generator = synchronized_generator
+        self.skip_batches = skip_batches
+        self.gradient_state = GradientState()
+        self._drop_last = _drop_last
+        self.iteration = 0
+
+    def __iter__(self):
+        if self.rng_types is not None:
+            synchronize_rng_states(self.rng_types, self.synchronized_generator)
+        self.begin()
+
+        self.set_epoch(self.iteration)
+        dataloader_iter = super().__iter__()
+        # We iterate one batch ahead to check when we are at the end
+        try:
+            current_batch = next(dataloader_iter)
+        except StopIteration:
+            yield
+
+        batch_index = 0
+        while True:
+            try:
+                # But we still move it to the device so it is done before `StopIteration` is reached
+                if self.device is not None:
+                    current_batch = send_to_device(current_batch, self.device)
+                next_batch = next(dataloader_iter)
+                if batch_index >= self.skip_batches:
+                    yield current_batch
+                batch_index += 1
+                current_batch = next_batch
+            except StopIteration:
+                self.end_of_dataloader = True
+                if batch_index >= self.skip_batches:
+                    yield current_batch
+                break
+
+        self.iteration += 1
+        self.end()
+
+    def set_epoch(self, epoch: int):
+        # In case it is manually passed in, the user can set it to what they like
+        if self.iteration != epoch:
+            self.iteration = epoch
+        if hasattr(self.batch_sampler, "sampler") and hasattr(self.batch_sampler.sampler, "set_epoch"):
+            self.batch_sampler.sampler.set_epoch(epoch)
+        # We support if a custom `Dataset` implementation has `set_epoch`
+        # or in general HF datasets `Datasets`
+        elif hasattr(self.dataset, "set_epoch"):
+            self.dataset.set_epoch(epoch)
+
+    @property
+    def total_batch_size(self):
+        batch_sampler = self.sampler if isinstance(self.sampler, BatchSampler) else self.batch_sampler
+        return (
+            batch_sampler.batch_size
+            if getattr(batch_sampler, "split_batches", False)
+            else (batch_sampler.batch_size * getattr(batch_sampler, "num_processes", 1))
+        )
+
+    @property
+    def total_dataset_length(self):
+        if hasattr(self.dataset, "total_length"):
+            return self.dataset.total_length
+        else:
+            return len(self.dataset)
+
+
+if is_torch_xla_available():
+    import torch_xla.distributed.parallel_loader as xpl
+
+    class MpDeviceLoaderWrapper(xpl.MpDeviceLoader):
+        """
+        Wrapper for the xpl.MpDeviceLoader class that knows the total batch size.
+
+        XLA preloading threads will all call DataLoaderShard's __iter__(). Remove rng_types from DataLoaderShard to
+        prevent it from using the XLA device in the preloading threads, and synchronize the RNG once from the main
+        thread only.
+
+        **Available attributes:**
+
+        - **total_batch_size** (`int`) -- Total batch size of the dataloader across all processes.
+            Equal to the original batch size when `split_batches=True`; otherwise the original batch size * the total
+            number of processes
+
+        - **total_dataset_length** (`int`) -- Total length of the inner dataset across all processes.
+        """
+
+        def __init__(self, dataloader: DataLoaderShard, device: torch.device):
+            super().__init__(dataloader, device)
+            self._rng_types = self._loader.rng_types
+            self._loader.rng_types = None
+
+        def __iter__(self):
+            if self._rng_types is not None:
+                synchronize_rng_states(self._rng_types, self._loader.synchronized_generator)
+
+            return super().__iter__()
+
+        @property
+        def total_batch_size(self):
+            return self._loader.total_batch_size
+
+        @property
+        def total_dataset_length(self):
+            return self._loader.total_dataset_length
+
+        @property
+        def batch_sampler(self):
+            return self._loader.batch_sampler
+
+
+class DataLoaderDispatcher(DataLoader, DataLoaderStateMixin):
+    """
+    Subclass of a PyTorch `DataLoader` that will iterate and preprocess on process 0 only, then dispatch on each
+    process their part of the batch.
+
+    Args:
+        split_batches (`bool`, *optional*, defaults to `False`):
+            Whether the resulting `DataLoader` should split the batches of the original data loader across devices or
+            yield full batches (in which case it will yield batches starting at the `process_index`-th and advancing of
+            `num_processes` batches at each iteration). Another way to see this is that the observed batch size will be
+            the same as the initial `dataloader` if this option is set to `True`, the batch size of the initial
+            `dataloader` multiplied by `num_processes` otherwise. Setting this option to `True` requires that the batch
+            size of the `dataloader` is a round multiple of `batch_size`.
+        skip_batches (`int`, *optional*, defaults to 0):
+            The number of batches to skip at the beginning of an iteration.
+
+    **Available attributes:**
+
+        - **total_batch_size** (`int`) -- Total batch size of the dataloader across all processes.
+            Equal to the original batch size when `split_batches=True`; otherwise the original batch size * the total
+            number of processes
+
+        - **total_dataset_length** (`int`) -- Total length of the inner dataset across all processes.
+    """
+
+    def __init__(
+        self, dataset, split_batches: bool = False, skip_batches=0, _drop_last: bool = False, slice_fn=None, **kwargs
+    ):
+        shuffle = False
+        if is_torch_version(">=", "1.11.0"):
+            from torch.utils.data.datapipes.iter.combinatorics import ShufflerIterDataPipe
+
+            # We need to save the shuffling state of the DataPipe
+            if isinstance(dataset, ShufflerIterDataPipe):
+                shuffle = dataset._shuffle_enabled
+        super().__init__(dataset, **kwargs)
+        self.split_batches = split_batches
+        if shuffle:
+            torch.utils.data.graph_settings.apply_shuffle_settings(dataset, shuffle=shuffle)
+
+        self.gradient_state = GradientState()
+        self.state = AcceleratorState()
+        self._drop_last = _drop_last
+        self.skip_batches = skip_batches
+
+        self.slice_fn = slice_tensors if slice_fn is None else slice_fn
+        self.iteration = 0
+
+    def _fetch_batches(self, iterator):
+        batches, batch = None, None
+        # On process 0, we gather the batch to dispatch.
+        if self.state.process_index == 0:
+            try:
+                if self.split_batches:
+                    # One batch of the main iterator is dispatched and split.
+                    batch = next(iterator)
+                else:
+                    # num_processes batches of the main iterator are concatenated then dispatched and split.
+                    # We add the batches one by one so we have the remainder available when drop_last=False.
+                    batches = []
+                    for _ in range(self.state.num_processes):
+                        batches.append(next(iterator))
+                    try:
+                        batch = concatenate(batches, dim=0)
+                    except RuntimeError as e:
+                        raise RuntimeError(
+                            "You can't use batches of different size with `dispatch_batches=True` or when using an `IterableDataset`."
+                            "either pass `dispatch_batches=False` and have each process fetch its own batch "
+                            " or pass `split_batches=True`. By doing so, the main process will fetch a full batch and "
+                            "slice it into `num_processes` batches for each process."
+                        ) from e
+                # In both cases, we need to get the structure of the batch that we will broadcast on other
+                # processes to initialize the tensors with the right shape.
+                # data_structure, stop_iteration
+                batch_info = [get_data_structure(batch), False]
+            except StopIteration:
+                batch_info = [None, True]
+        else:
+            batch_info = [None, self._stop_iteration]
+        # This is inplace, so after this instruction, every process has the same `batch_info` as process 0.
+        broadcast_object_list(batch_info)
+        self._stop_iteration = batch_info[1]
+        if self._stop_iteration:
+            # If drop_last is False and split_batches is False, we may have a remainder to take care of.
+            if not self.split_batches and not self._drop_last:
+                if self.state.process_index == 0 and len(batches) > 0:
+                    batch = concatenate(batches, dim=0)
+                    batch_info = [get_data_structure(batch), False]
+                else:
+                    batch_info = [None, True]
+                broadcast_object_list(batch_info)
+        return batch, batch_info
+
+    def __iter__(self):
+        self.begin()
+        self.set_epoch(self.iteration)
+        main_iterator = None
+        if is_torch_version(">=", "2.0.1"):
+            # NOTE PyTorch DataLoader adds forward compatibilities for DataPipes, which broadcasts
+            # shared seed to all dist processes. Thus, we need to create iterator for all dist processes.
+            # But, we only iterate through the DataLoader on process 0.
+            main_iterator = super().__iter__()
+        elif self.state.process_index == 0:
+            main_iterator = super().__iter__()
+        stop_iteration = False
+        self._stop_iteration = False
+        first_batch = None
+        next_batch, next_batch_info = self._fetch_batches(main_iterator)
+        batch_index = 0
+        while not stop_iteration:
+            batch, batch_info = next_batch, next_batch_info
+
+            if self.state.process_index != 0:
+                # Initialize tensors on other processes than process 0.
+                batch = initialize_tensors(batch_info[0])
+            batch = send_to_device(batch, self.state.device)
+            # Broadcast the batch before splitting it.
+            batch = broadcast(batch, from_process=0)
+
+            if not self._drop_last and first_batch is None:
+                # We keep at least num processes elements of the first batch to be able to complete the last batch
+                first_batch = self.slice_fn(
+                    batch,
+                    slice(0, self.state.num_processes),
+                    process_index=self.state.process_index,
+                    num_processes=self.state.num_processes,
+                )
+
+            if batch is None:
+                raise ValueError(
+                    f"Batch does not contain any data (`{batch}`). At the end of all iterable data available before expected stop iteration."
+                )
+
+            observed_batch_size = find_batch_size(batch)
+            batch_size = observed_batch_size // self.state.num_processes
+
+            stop_iteration = self._stop_iteration
+            if not stop_iteration:
+                # We may still be at the end of the dataloader without knowing it yet: if there is nothing left in
+                # the dataloader since the number of batches is a round multiple of the number of processes.
+                next_batch, next_batch_info = self._fetch_batches(main_iterator)
+                # next_batch_info[0] is None when there are no more batches, otherwise we still need to process them.
+                if self._stop_iteration and next_batch_info[0] is None:
+                    stop_iteration = True
+
+            if not self._drop_last and stop_iteration and observed_batch_size % self.state.num_processes != 0:
+                # If the last batch is not complete, let's add the first batch to it.
+                batch = concatenate([batch, first_batch], dim=0)
+                # Batch size computation above is wrong, it's off by 1 so we fix it.
+                batch_size += 1
+
+            data_slice = slice(self.state.process_index * batch_size, (self.state.process_index + 1) * batch_size)
+            batch = self.slice_fn(
+                batch,
+                data_slice,
+                process_index=self.state.process_index,
+                num_processes=self.state.num_processes,
+            )
+
+            if stop_iteration:
+                self.end_of_dataloader = True
+                self.remainder = observed_batch_size
+            if batch_index >= self.skip_batches:
+                yield batch
+            batch_index += 1
+        self.iteration += 1
+        self.end()
+
+    def set_epoch(self, epoch: int):
+        # In case it is manually passed in, the user can set it to what they like
+        if self.iteration != epoch:
+            self.iteration = epoch
+        if hasattr(self.batch_sampler.sampler, "set_epoch"):
+            self.batch_sampler.sampler.set_epoch(epoch)
+        elif hasattr(self.dataset, "set_epoch"):
+            self.dataset.set_epoch(epoch)
+
+    def __len__(self):
+        whole_length = super().__len__()
+        if self.split_batches:
+            return whole_length
+        elif self._drop_last:
+            return whole_length // self.state.num_processes
+        else:
+            return math.ceil(whole_length / self.state.num_processes)
+
+    @property
+    def total_batch_size(self):
+        return (
+            self.dataset.batch_size if self.split_batches else (self.dataset.batch_size * self.dataset.num_processes)
+        )
+
+    @property
+    def total_dataset_length(self):
+        return len(self.dataset)
+
+
+def prepare_data_loader(
+    dataloader: DataLoader,
+    device: Optional[torch.device] = None,
+    num_processes: Optional[int] = None,
+    process_index: Optional[int] = None,
+    split_batches: bool = False,
+    put_on_device: bool = False,
+    rng_types: Optional[List[Union[str, RNGType]]] = None,
+    dispatch_batches: Optional[bool] = None,
+    even_batches: bool = True,
+    slice_fn_for_dispatch: Optional[Callable] = None,
+    use_seedable_sampler: bool = False,
+) -> DataLoader:
+    """
+    Wraps a PyTorch `DataLoader` to generate batches for one of the processes only.
+
+    Depending on the value of the `drop_last` attribute of the `dataloader` passed, it will either stop the iteration
+    at the first batch that would be too small / not present on all processes or loop with indices from the beginning.
+
+    Args:
+        dataloader (`torch.utils.data.dataloader.DataLoader`):
+            The data loader to split across several devices.
+        device (`torch.device`):
+            The target device for the returned `DataLoader`.
+        num_processes (`int`, *optional*):
+            The number of processes running concurrently. Will default to the value given by
+            [`~state.AcceleratorState`].
+        process_index (`int`, *optional*):
+            The index of the current process. Will default to the value given by [`~state.AcceleratorState`].
+        split_batches (`bool`, *optional*, defaults to `False`):
+            Whether the resulting `DataLoader` should split the batches of the original data loader across devices or
+            yield full batches (in which case it will yield batches starting at the `process_index`-th and advancing of
+            `num_processes` batches at each iteration).
+
+            Another way to see this is that the observed batch size will be the same as the initial `dataloader` if
+            this option is set to `True`, the batch size of the initial `dataloader` multiplied by `num_processes`
+            otherwise.
+
+            Setting this option to `True` requires that the batch size of the `dataloader` is a round multiple of
+            `batch_size`.
+        put_on_device (`bool`, *optional*, defaults to `False`):
+            Whether or not to put the batches on `device` (only works if the batches are nested list, tuples or
+            dictionaries of tensors).
+        rng_types (list of `str` or [`~utils.RNGType`]):
+            The list of random number generators to synchronize at the beginning of each iteration. Should be one or
+            several of:
+
+            - `"torch"`: the base torch random number generator
+            - `"cuda"`: the CUDA random number generator (GPU only)
+            - `"xla"`: the XLA random number generator (TPU only)
+            - `"generator"`: the `torch.Generator` of the sampler (or batch sampler if there is no sampler in your
+              dataloader) or of the iterable dataset (if it exists) if the underlying dataset is of that type.
+
+        dispatch_batches (`bool`, *optional*):
+            If set to `True`, the datalaoder prepared is only iterated through on the main process and then the batches
+            are split and broadcast to each process. Will default to `True` when the underlying dataset is an
+            `IterableDataset`, `False` otherwise.
+        even_batches (`bool`, *optional*, defaults to `True`):
+            If set to `True`, in cases where the total batch size across all processes does not exactly divide the
+            dataset, samples at the start of the dataset will be duplicated so the batch can be divided equally among
+            all workers.
+        slice_fn_for_dispatch (`Callable`, *optional*`):
+            If passed, this function will be used to slice tensors across `num_processes`. Will default to
+            [`~utils.slice_tensors`]. This argument is used only when `dispatch_batches` is set to `True` and will be
+            ignored otherwise.
+        use_seedable_sampler (`bool`, *optional*, defaults to `False`):
+            Whether to use the [`~data_loader.SeedableRandomSampler`] instead of a `RandomSampler` for better
+            reproducability. Comes at a cost of potentially different performances due to different shuffling
+            algorithms but ensures results will be the *exact* same. Should be paired with `set_seed()` at every
+            `self.set_epoch`
+
+    Returns:
+        `torch.utils.data.dataloader.DataLoader`: A new data loader that will yield the portion of the batches
+
+    <Tip warning={true}>
+
+    `BatchSampler`s with varying batch sizes are not enabled by default. To enable this behaviour, set `even_batches`
+    equal to `False`
+
+    </Tip>
+    """
+    if dispatch_batches is None:
+        if not put_on_device:
+            dispatch_batches = False
+        else:
+            dispatch_batches = isinstance(dataloader.dataset, IterableDataset)
+
+    if dispatch_batches and not put_on_device:
+        raise ValueError("Using `dispatch_batches=True` requires `put_on_device=True`.")
+    # Grab defaults from AcceleratorState
+    state = AcceleratorState()
+    if num_processes is None:
+        num_processes = state.num_processes
+    if process_index is None:
+        process_index = state.process_index
+
+    # Sanity check
+    if split_batches:
+        if dataloader.batch_size is not None:
+            batch_size_for_check = dataloader.batch_size
+        else:
+            # For custom batch_sampler
+            if hasattr(dataloader.batch_sampler, "batch_size"):
+                batch_size_for_check = dataloader.batch_sampler.batch_size
+            else:
+                raise ValueError(
+                    "In order to use `split_batches==True` you must have a `batch_size` attribute either in the passed "
+                    "`dataloader` or `dataloader.batch_sampler` objects, and it has to return a natural number. "
+                    "Your `dataloader.batch_size` is None and `dataloader.batch_sampler` "
+                    f"(`{type(dataloader.batch_sampler)}`) does not have the `batch_size` attribute set."
+                )
+
+        if batch_size_for_check > 1 and batch_size_for_check % num_processes != 0:
+            raise ValueError(
+                f"To use a `DataLoader` in `split_batches` mode, the batch size ({dataloader.batch_size}) "
+                f"needs to be a round multiple of the number of processes ({num_processes})."
+            )
+
+    new_dataset = dataloader.dataset
+    # Iterable dataset doesn't like batch_sampler, but data_loader creates a default one for it
+    new_batch_sampler = dataloader.batch_sampler if not isinstance(new_dataset, IterableDataset) else None
+    sampler_is_batch_sampler = False
+    synchronized_generator = None
+    sampler_is_batch_sampler = isinstance(dataloader.sampler, BatchSampler)
+    if sampler_is_batch_sampler:
+        sampler = getattr(dataloader.sampler, "sampler", None)
+    else:
+        sampler = getattr(dataloader.batch_sampler, "sampler", None)
+    if isinstance(sampler, RandomSampler) and use_seedable_sampler:
+        # When iterating through the dataloader during distributed processes
+        # we want to ensure that on each process we are iterating through the same
+        # samples in the same order if a seed is set. This requires a tweak
+        # to the `torch.utils.data.RandomSampler` class (if used).
+        sampler = SeedableRandomSampler(
+            data_source=sampler.data_source,
+            replacement=sampler.replacement,
+            num_samples=sampler._num_samples,
+            generator=getattr(sampler, "generator", torch.Generator()),
+        )
+
+    if isinstance(dataloader.sampler, RandomSampler) and state.distributed_type == DistributedType.XLA:
+        # isinstance(dataloader.sampler, RandomSampler) indicates the original dataloader has `shuffle` enabled.
+        generator = torch.Generator().manual_seed(42)
+        dataloader.generator = generator
+        dataloader.sampler.generator = generator
+    # No change if no multiprocess
+    if (num_processes != 1 or state.distributed_type == DistributedType.MEGATRON_LM) and not dispatch_batches:
+        if isinstance(new_dataset, IterableDataset):
+            if getattr(dataloader.dataset, "generator", None) is not None:
+                synchronized_generator = dataloader.dataset.generator
+            new_dataset = IterableDatasetShard(
+                new_dataset,
+                batch_size=dataloader.batch_size,
+                drop_last=dataloader.drop_last,
+                num_processes=num_processes,
+                process_index=process_index,
+                split_batches=split_batches,
+            )
+        else:
+            batch_sampler = dataloader.sampler if sampler_is_batch_sampler else dataloader.batch_sampler
+            new_batch_sampler = BatchSamplerShard(
+                batch_sampler,
+                num_processes=num_processes,
+                process_index=process_index,
+                split_batches=split_batches,
+                even_batches=even_batches,
+            )
+
+    # We ignore all of those since they are all dealt with by our new_batch_sampler
+    ignore_kwargs = [
+        "batch_size",
+        "shuffle",
+        "sampler",
+        "batch_sampler",
+        "drop_last",
+    ]
+
+    if rng_types is not None and synchronized_generator is None and "generator" in rng_types:
+        rng_types.remove("generator")
+
+    kwargs = {
+        k: getattr(dataloader, k, _PYTORCH_DATALOADER_KWARGS[k])
+        for k in _PYTORCH_DATALOADER_KWARGS
+        if k not in ignore_kwargs
+    }
+
+    # Need to provide batch_size as batch_sampler is None for Iterable dataset
+    if new_batch_sampler is None:
+        kwargs["drop_last"] = dataloader.drop_last
+        kwargs["batch_size"] = (
+            dataloader.batch_size // num_processes if split_batches and not dispatch_batches else dataloader.batch_size
+        )
+    if dispatch_batches:
+        kwargs.pop("generator")
+        dataloader = DataLoaderDispatcher(
+            new_dataset,
+            split_batches=split_batches,
+            batch_sampler=new_batch_sampler,
+            _drop_last=dataloader.drop_last,
+            slice_fn=slice_fn_for_dispatch,
+            **kwargs,
+        )
+    elif sampler_is_batch_sampler:
+        dataloader = DataLoaderShard(
+            new_dataset,
+            device=device if put_on_device and state.distributed_type != DistributedType.XLA else None,
+            sampler=new_batch_sampler,
+            batch_size=dataloader.batch_size,
+            rng_types=rng_types,
+            _drop_last=dataloader.drop_last,
+            synchronized_generator=synchronized_generator,
+            **kwargs,
+        )
+    else:
+        dataloader = DataLoaderShard(
+            new_dataset,
+            device=device if put_on_device and state.distributed_type != DistributedType.XLA else None,
+            batch_sampler=new_batch_sampler,
+            rng_types=rng_types,
+            synchronized_generator=synchronized_generator,
+            _drop_last=dataloader.drop_last,
+            **kwargs,
+        )
+
+    if isinstance(sampler, SeedableRandomSampler) and use_seedable_sampler:
+        if sampler_is_batch_sampler:
+            dataloader.sampler.sampler = sampler
+        else:
+            dataloader.batch_sampler.sampler = sampler
+            if hasattr(dataloader.batch_sampler, "batch_sampler"):
+                dataloader.batch_sampler.batch_sampler.sampler = sampler
+    if state.distributed_type == DistributedType.XLA:
+        return MpDeviceLoaderWrapper(dataloader, device)
+    return dataloader
+
+
+class SkipBatchSampler(BatchSampler):
+    """
+    A `torch.utils.data.BatchSampler` that skips the first `n` batches of another `torch.utils.data.BatchSampler`.
+    """
+
+    def __init__(self, batch_sampler, skip_batches=0):
+        self.batch_sampler = batch_sampler
+        self.skip_batches = skip_batches
+
+    def __iter__(self):
+        for index, samples in enumerate(self.batch_sampler):
+            if index >= self.skip_batches:
+                yield samples
+
+    @property
+    def total_length(self):
+        return len(self.batch_sampler)
+
+    def __len__(self):
+        return len(self.batch_sampler) - self.skip_batches
+
+
+class SkipDataLoader(DataLoader):
+    """
+    Subclass of a PyTorch `DataLoader` that will skip the first batches.
+
+    Args:
+        dataset (`torch.utils.data.dataset.Dataset`):
+            The dataset to use to build this datalaoder.
+        skip_batches (`int`, *optional*, defaults to 0):
+            The number of batches to skip at the beginning.
+        kwargs:
+            All other keyword arguments to pass to the regular `DataLoader` initialization.
+    """
+
+    def __init__(self, dataset, skip_batches=0, **kwargs):
+        super().__init__(dataset, **kwargs)
+        self.skip_batches = skip_batches
+
+    def __iter__(self):
+        for index, batch in enumerate(super().__iter__()):
+            if index >= self.skip_batches:
+                yield batch
+
+
+def skip_first_batches(dataloader, num_batches=0):
+    """
+    Creates a `torch.utils.data.DataLoader` that will efficiently skip the first `num_batches`.
+    """
+    dataset = dataloader.dataset
+    sampler_is_batch_sampler = False
+    if isinstance(dataset, IterableDataset):
+        new_batch_sampler = None
+    else:
+        sampler_is_batch_sampler = isinstance(dataloader.sampler, BatchSampler)
+        batch_sampler = dataloader.sampler if sampler_is_batch_sampler else dataloader.batch_sampler
+        new_batch_sampler = SkipBatchSampler(batch_sampler, skip_batches=num_batches)
+
+    # We ignore all of those since they are all dealt with by our new_batch_sampler
+    ignore_kwargs = [
+        "batch_size",
+        "shuffle",
+        "sampler",
+        "batch_sampler",
+        "drop_last",
+    ]
+
+    kwargs = {
+        k: getattr(dataloader, k, _PYTORCH_DATALOADER_KWARGS[k])
+        for k in _PYTORCH_DATALOADER_KWARGS
+        if k not in ignore_kwargs
+    }
+
+    # Need to provide batch_size as batch_sampler is None for Iterable dataset
+    if new_batch_sampler is None:
+        kwargs["drop_last"] = dataloader.drop_last
+        kwargs["batch_size"] = dataloader.batch_size
+
+    if isinstance(dataloader, DataLoaderDispatcher):
+        if new_batch_sampler is None:
+            # Need to manually skip batches in the dataloader
+            kwargs["skip_batches"] = num_batches
+        dataloader = DataLoaderDispatcher(
+            dataset,
+            split_batches=dataloader.split_batches,
+            batch_sampler=new_batch_sampler,
+            _drop_last=dataloader._drop_last,
+            **kwargs,
+        )
+    elif isinstance(dataloader, DataLoaderShard):
+        if new_batch_sampler is None:
+            # Need to manually skip batches in the dataloader
+            kwargs["skip_batches"] = num_batches
+        elif sampler_is_batch_sampler:
+            kwargs["sampler"] = new_batch_sampler
+            kwargs["batch_size"] = dataloader.batch_size
+        else:
+            kwargs["batch_sampler"] = new_batch_sampler
+        dataloader = DataLoaderShard(
+            dataset,
+            device=dataloader.device,
+            rng_types=dataloader.rng_types,
+            synchronized_generator=dataloader.synchronized_generator,
+            **kwargs,
+        )
+    else:
+        if new_batch_sampler is None:
+            # Need to manually skip batches in the dataloader
+            dataloader = SkipDataLoader(dataset, skip_batches=num_batches, **kwargs)
+        else:
+            dataloader = DataLoader(dataset, batch_sampler=new_batch_sampler, **kwargs)
+
+    return dataloader
diff --git a/llm/Lib/site-packages/accelerate/hooks.py b/llm/Lib/site-packages/accelerate/hooks.py
new file mode 100644
index 0000000000000000000000000000000000000000..e9a4b384f3cac39e7bedabb1f5e7c0320aae6a7f
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/hooks.py
@@ -0,0 +1,709 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import functools
+from typing import Dict, List, Mapping, Optional, Union
+
+import torch
+import torch.nn as nn
+
+from .state import PartialState
+from .utils import (
+    PrefixedDataset,
+    find_device,
+    named_module_tensors,
+    send_to_device,
+    set_module_tensor_to_device,
+)
+from .utils.modeling import get_non_persistent_buffers
+from .utils.other import recursive_getattr
+
+
+class ModelHook:
+    """
+    A hook that contains callbacks to be executed just before and after the forward method of a model. The difference
+    with PyTorch existing hooks is that they get passed along the kwargs.
+
+    Class attribute:
+    - **no_grad** (`bool`, *optional*, defaults to `False`) -- Whether or not to execute the actual forward pass under
+      the `torch.no_grad()` context manager.
+    """
+
+    no_grad = False
+
+    def init_hook(self, module):
+        """
+        To be executed when the hook is attached to the module.
+
+        Args:
+            module (`torch.nn.Module`): The module attached to this hook.
+        """
+        return module
+
+    def pre_forward(self, module, *args, **kwargs):
+        """
+        To be executed just before the forward method of the model.
+
+        Args:
+            module (`torch.nn.Module`): The module whose forward pass will be executed just after this event.
+            args (`Tuple[Any]`): The positional arguments passed to the module.
+            kwargs (`Dict[Str, Any]`): The keyword arguments passed to the module.
+
+        Returns:
+            `Tuple[Tuple[Any], Dict[Str, Any]]`: A tuple with the treated `args` and `kwargs`.
+        """
+        return args, kwargs
+
+    def post_forward(self, module, output):
+        """
+        To be executed just after the forward method of the model.
+
+        Args:
+            module (`torch.nn.Module`): The module whose forward pass been executed just before this event.
+            output (`Any`): The output of the module.
+
+        Returns:
+            `Any`: The processed `output`.
+        """
+        return output
+
+    def detach_hook(self, module):
+        """
+        To be executed when the hook is detached from a module.
+
+        Args:
+            module (`torch.nn.Module`): The module detached from this hook.
+        """
+        return module
+
+
+class SequentialHook(ModelHook):
+    """
+    A hook that can contain several hooks and iterates through them at each event.
+    """
+
+    def __init__(self, *hooks):
+        self.hooks = hooks
+
+    def init_hook(self, module):
+        for hook in self.hooks:
+            module = hook.init_hook(module)
+        return module
+
+    def pre_forward(self, module, *args, **kwargs):
+        for hook in self.hooks:
+            args, kwargs = hook.pre_forward(module, *args, **kwargs)
+        return args, kwargs
+
+    def post_forward(self, module, output):
+        for hook in self.hooks:
+            output = hook.post_forward(module, output)
+        return output
+
+    def detach_hook(self, module):
+        for hook in self.hooks:
+            module = hook.detach_hook(module)
+        return module
+
+
+def add_hook_to_module(module: nn.Module, hook: ModelHook, append: bool = False):
+    """
+    Adds a hook to a given module. This will rewrite the `forward` method of the module to include the hook, to remove
+    this behavior and restore the original `forward` method, use `remove_hook_from_module`.
+
+    <Tip warning={true}>
+
+    If the module already contains a hook, this will replace it with the new hook passed by default. To chain two hooks
+    together, pass `append=True`, so it chains the current and new hook into an instance of the `SequentialHook` class.
+
+    </Tip>
+
+    Args:
+        module (`torch.nn.Module`):
+            The module to attach a hook to.
+        hook (`ModelHook`):
+            The hook to attach.
+        append (`bool`, *optional*, defaults to `False`):
+            Whether the hook should be chained with an existing one (if module already contains a hook) or not.
+
+    Returns:
+        `torch.nn.Module`: The same module, with the hook attached (the module is modified in place, so the result can
+        be discarded).
+    """
+
+    if append and (getattr(module, "_hf_hook", None) is not None):
+        old_hook = module._hf_hook
+        remove_hook_from_module(module)
+        hook = SequentialHook(old_hook, hook)
+
+    if hasattr(module, "_hf_hook") and hasattr(module, "_old_forward"):
+        # If we already put some hook on this module, we replace it with the new one.
+        old_forward = module._old_forward
+    else:
+        old_forward = module.forward
+        module._old_forward = old_forward
+
+    module = hook.init_hook(module)
+    module._hf_hook = hook
+
+    def new_forward(module, *args, **kwargs):
+        args, kwargs = module._hf_hook.pre_forward(module, *args, **kwargs)
+        if module._hf_hook.no_grad:
+            with torch.no_grad():
+                output = module._old_forward(*args, **kwargs)
+        else:
+            output = module._old_forward(*args, **kwargs)
+        return module._hf_hook.post_forward(module, output)
+
+    # Overriding a GraphModuleImpl forward freezes the forward call and later modifications on the graph will fail.
+    # Reference: https://pytorch.slack.com/archives/C3PDTEV8E/p1705929610405409
+    if "GraphModuleImpl" in str(type(module)):
+        module.__class__.forward = functools.update_wrapper(functools.partial(new_forward, module), old_forward)
+    else:
+        module.forward = functools.update_wrapper(functools.partial(new_forward, module), old_forward)
+
+    return module
+
+
+def remove_hook_from_module(module: nn.Module, recurse=False):
+    """
+    Removes any hook attached to a module via `add_hook_to_module`.
+
+    Args:
+        module (`torch.nn.Module`): The module to attach a hook to.
+        recurse (`bool`, **optional**): Whether to remove the hooks recursively
+
+    Returns:
+        `torch.nn.Module`: The same module, with the hook detached (the module is modified in place, so the result can
+        be discarded).
+    """
+
+    if hasattr(module, "_hf_hook"):
+        module._hf_hook.detach_hook(module)
+        delattr(module, "_hf_hook")
+
+    if hasattr(module, "_old_forward"):
+        # Overriding a GraphModuleImpl forward freezes the forward call and later modifications on the graph will fail.
+        # Reference: https://pytorch.slack.com/archives/C3PDTEV8E/p1705929610405409
+        if "GraphModuleImpl" in str(type(module)):
+            module.__class__.forward = module._old_forward
+        else:
+            module.forward = module._old_forward
+        delattr(module, "_old_forward")
+
+    if recurse:
+        for child in module.children():
+            remove_hook_from_module(child, recurse)
+
+    return module
+
+
+class AlignDevicesHook(ModelHook):
+    """
+    A generic `ModelHook` that ensures inputs and model weights are on the same device for the forward pass of the
+    associated module, potentially offloading the weights after the forward pass.
+
+    Args:
+        execution_device (`torch.device`, *optional*):
+            The device on which inputs and model weights should be placed before the forward pass.
+        offload (`bool`, *optional*, defaults to `False`):
+            Whether or not the weights should be offloaded after the forward pass.
+        io_same_device (`bool`, *optional*, defaults to `False`):
+            Whether or not the output should be placed on the same device as the input was.
+        weights_map (`Mapping[str, torch.Tensor]`, *optional*):
+            When the model weights are offloaded, a (potentially lazy) map from param names to the tensor values.
+        offload_buffers (`bool`, *optional*, defaults to `False`):
+            Whether or not to include the associated module's buffers when offloading.
+        place_submodules (`bool`, *optional*, defaults to `False`):
+            Whether to place the submodules on `execution_device` during the `init_hook` event.
+    """
+
+    def __init__(
+        self,
+        execution_device: Optional[Union[int, str, torch.device]] = None,
+        offload: bool = False,
+        io_same_device: bool = False,
+        weights_map: Optional[Mapping] = None,
+        offload_buffers: bool = False,
+        place_submodules: bool = False,
+        skip_keys: Optional[Union[str, List[str]]] = None,
+        tied_params_map: Optional[Dict[int, Dict[torch.device, torch.Tensor]]] = None,
+    ):
+        self.execution_device = execution_device
+        self.offload = offload
+        self.io_same_device = io_same_device
+        self.weights_map = weights_map
+        self.offload_buffers = offload_buffers
+        self.place_submodules = place_submodules
+        self.skip_keys = skip_keys
+
+        # Will contain the input device when `io_same_device=True`.
+        self.input_device = None
+        self.param_original_devices = {}
+        self.buffer_original_devices = {}
+        self.tied_params_names = set()
+
+        # The hook pre_forward/post_forward need to have knowledge of this dictionary, as with offloading we want to avoid duplicating memory
+        # for tied weights already loaded on the target execution device.
+        self.tied_params_map = tied_params_map
+
+    def __repr__(self):
+        return (
+            f"AlignDevicesHook(execution_device={self.execution_device}, offload={self.offload}, "
+            f"io_same_device={self.io_same_device}, offload_buffers={self.offload_buffers}, "
+            f"place_submodules={self.place_submodules}, skip_keys={repr(self.skip_keys)})"
+        )
+
+    def init_hook(self, module):
+        # In case the AlignDevicesHook is on meta device, ignore tied weights as data_ptr() is then always zero.
+        if self.execution_device == "meta" or self.execution_device == torch.device("meta"):
+            self.tied_params_map = None
+
+        if not self.offload and self.execution_device is not None:
+            for name, _ in named_module_tensors(module, recurse=self.place_submodules):
+                set_module_tensor_to_device(module, name, self.execution_device, tied_params_map=self.tied_params_map)
+        elif self.offload:
+            self.original_devices = {
+                name: param.device for name, param in named_module_tensors(module, recurse=self.place_submodules)
+            }
+            if self.weights_map is None:
+                self.weights_map = {
+                    name: param.to("cpu")
+                    for name, param in named_module_tensors(
+                        module, include_buffers=self.offload_buffers, recurse=self.place_submodules
+                    )
+                }
+            for name, _ in named_module_tensors(
+                module, include_buffers=self.offload_buffers, recurse=self.place_submodules, remove_non_persistent=True
+            ):
+                # When using disk offloading, we can not rely on `weights_map[name].data_ptr()` as the reference pointer,
+                # as we have no guarantee that safetensors' `file.get_tensor()` will always give the same pointer.
+                # As we have no reliable way to track the shared data pointer of tied weights in this case, we use tied_params_names: List[str]
+                # to add on the fly pointers to `tied_params_map` in the pre_forward call.
+                if (
+                    self.tied_params_map is not None
+                    and recursive_getattr(module, name).data_ptr() in self.tied_params_map
+                ):
+                    self.tied_params_names.add(name)
+
+                set_module_tensor_to_device(module, name, "meta")
+
+            if not self.offload_buffers and self.execution_device is not None:
+                for name, _ in module.named_buffers(recurse=self.place_submodules):
+                    set_module_tensor_to_device(
+                        module, name, self.execution_device, tied_params_map=self.tied_params_map
+                    )
+            elif self.offload_buffers and self.execution_device is not None:
+                for name in get_non_persistent_buffers(module, recurse=self.place_submodules):
+                    set_module_tensor_to_device(
+                        module, name, self.execution_device, tied_params_map=self.tied_params_map
+                    )
+
+        return module
+
+    def pre_forward(self, module, *args, **kwargs):
+        if self.io_same_device:
+            self.input_device = find_device([args, kwargs])
+        if self.offload:
+            self.tied_pointers_to_remove = set()
+
+            for name, _ in named_module_tensors(
+                module,
+                include_buffers=self.offload_buffers,
+                recurse=self.place_submodules,
+                remove_non_persistent=True,
+            ):
+                fp16_statistics = None
+                value = self.weights_map[name]
+                if "weight" in name and name.replace("weight", "SCB") in self.weights_map.keys():
+                    if value.dtype == torch.int8:
+                        fp16_statistics = self.weights_map[name.replace("weight", "SCB")]
+
+                # In case we are using offloading with tied weights, we need to keep track of the offloaded weights
+                # that are loaded on device at this point, as we will need to remove them as well from the dictionary
+                # self.tied_params_map in order to allow to free memory.
+                if name in self.tied_params_names and value.data_ptr() not in self.tied_params_map:
+                    self.tied_params_map[value.data_ptr()] = {}
+
+                if (
+                    value is not None
+                    and self.tied_params_map is not None
+                    and value.data_ptr() in self.tied_params_map
+                    and self.execution_device not in self.tied_params_map[value.data_ptr()]
+                ):
+                    self.tied_pointers_to_remove.add((value.data_ptr(), self.execution_device))
+
+                set_module_tensor_to_device(
+                    module,
+                    name,
+                    self.execution_device,
+                    value=value,
+                    fp16_statistics=fp16_statistics,
+                    tied_params_map=self.tied_params_map,
+                )
+
+        return send_to_device(args, self.execution_device), send_to_device(
+            kwargs, self.execution_device, skip_keys=self.skip_keys
+        )
+
+    def post_forward(self, module, output):
+        if self.offload:
+            for name, _ in named_module_tensors(
+                module,
+                include_buffers=self.offload_buffers,
+                recurse=self.place_submodules,
+                remove_non_persistent=True,
+            ):
+                set_module_tensor_to_device(module, name, "meta")
+                if type(module).__name__ == "Linear8bitLt":
+                    module.state.SCB = None
+                    module.state.CxB = None
+
+            # We may have loaded tied weights into self.tied_params_map (avoiding to load them several times in e.g. submodules): remove them from
+            # this dictionary to allow the garbage collector to do its job.
+            for value_pointer, device in self.tied_pointers_to_remove:
+                del self.tied_params_map[value_pointer][device]
+            self.tied_pointers_to_remove = set()
+
+        if self.io_same_device and self.input_device is not None:
+            output = send_to_device(output, self.input_device, skip_keys=self.skip_keys)
+
+        return output
+
+    def detach_hook(self, module):
+        if self.offload:
+            for name, device in self.original_devices.items():
+                if device != torch.device("meta"):
+                    set_module_tensor_to_device(module, name, device, value=self.weights_map.get(name, None))
+        return module
+
+
+def attach_execution_device_hook(
+    module: torch.nn.Module,
+    execution_device: Union[int, str, torch.device],
+    skip_keys: Optional[Union[str, List[str]]] = None,
+    preload_module_classes: Optional[List[str]] = None,
+    tied_params_map: Optional[Dict[int, Dict[torch.device, torch.Tensor]]] = None,
+):
+    """
+    Recursively attaches `AlignDevicesHook` to all submodules of a given model to make sure they have the right
+    execution device
+
+    Args:
+        module (`torch.nn.Module`):
+            The module where we want to attach the hooks.
+        execution_device (`int`, `str` or `torch.device`):
+            The device on which inputs and model weights should be placed before the forward pass.
+        skip_keys (`str` or `List[str]`, *optional*):
+            A list of keys to ignore when moving inputs or outputs between devices.
+        preload_module_classes (`List[str]`, *optional*):
+            A list of classes whose instances should load all their weights (even in the submodules) at the beginning
+            of the forward. This should only be used for classes that have submodules which are registered but not
+            called directly during the forward, for instance if a `dense` linear layer is registered, but at forward,
+            `dense.weight` and `dense.bias` are used in some operations instead of calling `dense` directly.
+        tied_params_map (Optional[Dict[int, Dict[torch.device, torch.Tensor]]], *optional*, defaults to `None`):
+            A map of data pointers to dictionaries of devices to already dispatched tied weights. For a given execution
+            device, this parameter is useful to reuse the first available pointer of a shared weight for all others,
+            instead of duplicating memory.
+    """
+    if not hasattr(module, "_hf_hook") and len(module.state_dict()) > 0:
+        add_hook_to_module(
+            module,
+            AlignDevicesHook(execution_device, skip_keys=skip_keys, tied_params_map=tied_params_map),
+        )
+
+    # Break the recursion if we get to a preload module.
+    if preload_module_classes is not None and module.__class__.__name__ in preload_module_classes:
+        return
+
+    for child in module.children():
+        attach_execution_device_hook(child, execution_device, tied_params_map=tied_params_map)
+
+
+def attach_align_device_hook(
+    module: torch.nn.Module,
+    execution_device: Optional[torch.device] = None,
+    offload: bool = False,
+    weights_map: Optional[Mapping] = None,
+    offload_buffers: bool = False,
+    module_name: str = "",
+    skip_keys: Optional[Union[str, List[str]]] = None,
+    preload_module_classes: Optional[List[str]] = None,
+    tied_params_map: Optional[Dict[int, Dict[torch.device, torch.Tensor]]] = None,
+):
+    """
+    Recursively attaches `AlignDevicesHook` to all submodules of a given model that have direct parameters and/or
+    buffers.
+
+    Args:
+        module (`torch.nn.Module`):
+            The module where we want to attach the hooks.
+        execution_device (`torch.device`, *optional*):
+            The device on which inputs and model weights should be placed before the forward pass.
+        offload (`bool`, *optional*, defaults to `False`):
+            Whether or not the weights should be offloaded after the forward pass.
+        weights_map (`Mapping[str, torch.Tensor]`, *optional*):
+            When the model weights are offloaded, a (potentially lazy) map from param names to the tensor values.
+        offload_buffers (`bool`, *optional*, defaults to `False`):
+            Whether or not to include the associated module's buffers when offloading.
+        module_name (`str`, *optional*, defaults to `""`):
+            The name of the module.
+        skip_keys (`str` or `List[str]`, *optional*):
+            A list of keys to ignore when moving inputs or outputs between devices.
+        preload_module_classes (`List[str]`, *optional*):
+            A list of classes whose instances should load all their weights (even in the submodules) at the beginning
+            of the forward. This should only be used for classes that have submodules which are registered but not
+            called directly during the forward, for instance if a `dense` linear layer is registered, but at forward,
+            `dense.weight` and `dense.bias` are used in some operations instead of calling `dense` directly.
+        tied_params_map (Optional[Dict[int, Dict[torch.device, torch.Tensor]]], *optional*, defaults to `None`):
+            A map of data pointers to dictionaries of devices to already dispatched tied weights. For a given execution
+            device, this parameter is useful to reuse the first available pointer of a shared weight for all others,
+            instead of duplicating memory.
+    """
+    # Attach the hook on this module if it has any direct tensor.
+    directs = named_module_tensors(module)
+    full_offload = (
+        offload and preload_module_classes is not None and module.__class__.__name__ in preload_module_classes
+    )
+
+    if len(list(directs)) > 0 or full_offload:
+        if weights_map is not None:
+            prefix = f"{module_name}." if len(module_name) > 0 else ""
+            prefixed_weights_map = PrefixedDataset(weights_map, prefix)
+        else:
+            prefixed_weights_map = None
+        hook = AlignDevicesHook(
+            execution_device=execution_device,
+            offload=offload,
+            weights_map=prefixed_weights_map,
+            offload_buffers=offload_buffers,
+            place_submodules=full_offload,
+            skip_keys=skip_keys,
+            tied_params_map=tied_params_map,
+        )
+        add_hook_to_module(module, hook, append=True)
+
+    # We stop the recursion in case we hit the full offload.
+    if full_offload:
+        return
+
+    # Recurse on all children of the module.
+    for child_name, child in module.named_children():
+        child_name = f"{module_name}.{child_name}" if len(module_name) > 0 else child_name
+        attach_align_device_hook(
+            child,
+            execution_device=execution_device,
+            offload=offload,
+            weights_map=weights_map,
+            offload_buffers=offload_buffers,
+            module_name=child_name,
+            preload_module_classes=preload_module_classes,
+            skip_keys=skip_keys,
+            tied_params_map=tied_params_map,
+        )
+
+
+def remove_hook_from_submodules(module: nn.Module):
+    """
+    Recursively removes all hooks attached on the submodules of a given model.
+
+    Args:
+        module (`torch.nn.Module`): The module on which to remove all hooks.
+    """
+    remove_hook_from_module(module)
+    for child in module.children():
+        remove_hook_from_submodules(child)
+
+
+def attach_align_device_hook_on_blocks(
+    module: nn.Module,
+    execution_device: Optional[Union[torch.device, Dict[str, torch.device]]] = None,
+    offload: Union[bool, Dict[str, bool]] = False,
+    weights_map: Mapping = None,
+    offload_buffers: bool = False,
+    module_name: str = "",
+    skip_keys: Optional[Union[str, List[str]]] = None,
+    preload_module_classes: Optional[List[str]] = None,
+    tied_params_map: Optional[Dict[int, Dict[torch.device, torch.Tensor]]] = None,
+):
+    """
+    Attaches `AlignDevicesHook` to all blocks of a given model as needed.
+
+    Args:
+        module (`torch.nn.Module`):
+            The module where we want to attach the hooks.
+        execution_device (`torch.device` or `Dict[str, torch.device]`, *optional*):
+            The device on which inputs and model weights should be placed before the forward pass. It can be one device
+            for the whole module, or a dictionary mapping module name to device.
+        offload (`bool`, *optional*, defaults to `False`):
+            Whether or not the weights should be offloaded after the forward pass. It can be one boolean for the whole
+            module, or a dictionary mapping module name to boolean.
+        weights_map (`Mapping[str, torch.Tensor]`, *optional*):
+            When the model weights are offloaded, a (potentially lazy) map from param names to the tensor values.
+        offload_buffers (`bool`, *optional*, defaults to `False`):
+            Whether or not to include the associated module's buffers when offloading.
+        module_name (`str`, *optional*, defaults to `""`):
+            The name of the module.
+        skip_keys (`str` or `List[str]`, *optional*):
+            A list of keys to ignore when moving inputs or outputs between devices.
+        preload_module_classes (`List[str]`, *optional*):
+            A list of classes whose instances should load all their weights (even in the submodules) at the beginning
+            of the forward. This should only be used for classes that have submodules which are registered but not
+            called directly during the forward, for instance if a `dense` linear layer is registered, but at forward,
+            `dense.weight` and `dense.bias` are used in some operations instead of calling `dense` directly.
+        tied_params_map (Optional[Dict[int, Dict[torch.device, torch.Tensor]]], *optional*, defaults to `None`):
+            A map of data pointers to dictionaries of devices to already dispatched tied weights. For a given execution
+            device, this parameter is useful to reuse the first available pointer of a shared weight for all others,
+            instead of duplicating memory.
+    """
+    # If one device and one offload, we've got one hook.
+    if not isinstance(execution_device, Mapping) and not isinstance(offload, dict):
+        if not offload:
+            hook = AlignDevicesHook(
+                execution_device=execution_device,
+                io_same_device=True,
+                skip_keys=skip_keys,
+                place_submodules=True,
+                tied_params_map=tied_params_map,
+            )
+            add_hook_to_module(module, hook)
+        else:
+            attach_align_device_hook(
+                module,
+                execution_device=execution_device,
+                offload=True,
+                weights_map=weights_map,
+                offload_buffers=offload_buffers,
+                module_name=module_name,
+                skip_keys=skip_keys,
+                tied_params_map=tied_params_map,
+            )
+        return
+
+    if not isinstance(execution_device, Mapping):
+        execution_device = {key: execution_device for key in offload.keys()}
+    if not isinstance(offload, Mapping):
+        offload = {key: offload for key in execution_device.keys()}
+
+    if module_name in execution_device and module_name in offload and not offload[module_name]:
+        hook = AlignDevicesHook(
+            execution_device=execution_device[module_name],
+            offload_buffers=offload_buffers,
+            io_same_device=(module_name == ""),
+            place_submodules=True,
+            skip_keys=skip_keys,
+            tied_params_map=tied_params_map,
+        )
+        add_hook_to_module(module, hook)
+        attach_execution_device_hook(module, execution_device[module_name], tied_params_map=tied_params_map)
+    elif module_name in execution_device and module_name in offload:
+        attach_align_device_hook(
+            module,
+            execution_device=execution_device[module_name],
+            offload=True,
+            weights_map=weights_map,
+            offload_buffers=offload_buffers,
+            module_name=module_name,
+            skip_keys=skip_keys,
+            preload_module_classes=preload_module_classes,
+            tied_params_map=tied_params_map,
+        )
+        if not hasattr(module, "_hf_hook"):
+            hook = AlignDevicesHook(
+                execution_device=execution_device[module_name],
+                io_same_device=(module_name == ""),
+                skip_keys=skip_keys,
+                tied_params_map=tied_params_map,
+            )
+            add_hook_to_module(module, hook)
+        attach_execution_device_hook(
+            module,
+            execution_device[module_name],
+            preload_module_classes=preload_module_classes,
+            skip_keys=skip_keys,
+            tied_params_map=tied_params_map,
+        )
+    elif module_name == "":
+        hook = AlignDevicesHook(
+            execution_device=execution_device.get(""),
+            io_same_device=True,
+            skip_keys=skip_keys,
+            tied_params_map=tied_params_map,
+        )
+        add_hook_to_module(module, hook)
+
+    for child_name, child in module.named_children():
+        child_name = f"{module_name}.{child_name}" if len(module_name) > 0 else child_name
+        attach_align_device_hook_on_blocks(
+            child,
+            execution_device=execution_device,
+            offload=offload,
+            weights_map=weights_map,
+            offload_buffers=offload_buffers,
+            module_name=child_name,
+            preload_module_classes=preload_module_classes,
+            skip_keys=skip_keys,
+            tied_params_map=tied_params_map,
+        )
+
+
+class CpuOffload(ModelHook):
+    """
+    Offloads a model on the CPU until its forward pass is called. The model will not be offloaded back to the CPU after
+    the forward, the user needs to call the `init_hook` method again for this.
+
+    Args:
+        execution_device(`str`, `int` or `torch.device`, *optional*):
+            The device on which the model should be executed. Will default to the MPS device if it's available, then
+            GPU 0 if there is a GPU, and finally to the CPU.
+        prev_module_hook (`UserCpuOffloadHook`, *optional*):
+            The hook sent back by [`cpu_offload_with_hook`] for a previous model in the pipeline you are running. If
+            passed, its offload method will be called just before the forward of the model to which this hook is
+            attached.
+    """
+
+    def __init__(
+        self,
+        execution_device: Optional[Union[str, int, torch.device]] = None,
+        prev_module_hook: Optional["UserCpuOffloadHook"] = None,
+    ):
+        self.prev_module_hook = prev_module_hook
+
+        self.execution_device = execution_device if execution_device is not None else PartialState().default_device
+
+    def init_hook(self, module):
+        return module.to("cpu")
+
+    def pre_forward(self, module, *args, **kwargs):
+        if self.prev_module_hook is not None:
+            self.prev_module_hook.offload()
+        module.to(self.execution_device)
+        return send_to_device(args, self.execution_device), send_to_device(kwargs, self.execution_device)
+
+
+class UserCpuOffloadHook:
+    """
+    A simple hook grouping a model and a `ModelHook`, which provides easy APIs for to call the init method of the hook
+    or remove it entirely.
+    """
+
+    def __init__(self, model, hook):
+        self.model = model
+        self.hook = hook
+
+    def offload(self):
+        self.hook.init_hook(self.model)
+
+    def remove(self):
+        remove_hook_from_module(self.model)
diff --git a/llm/Lib/site-packages/accelerate/inference.py b/llm/Lib/site-packages/accelerate/inference.py
new file mode 100644
index 0000000000000000000000000000000000000000..cf4cf15017938e34867d4eeaad120745051ab385
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/inference.py
@@ -0,0 +1,188 @@
+# Copyright 2024 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import math
+from types import MethodType
+from typing import Any, Dict, List, Optional, Tuple, Union
+
+from .state import PartialState
+from .utils import (
+    calculate_maximum_sizes,
+    convert_bytes,
+    copy_tensor_to_devices,
+    ignorant_find_batch_size,
+    infer_auto_device_map,
+    is_pippy_available,
+    pad_input_tensors,
+    send_to_device,
+)
+
+
+if is_pippy_available():
+    from pippy.IR import Pipe, PipeSplitWrapper, annotate_split_points
+    from pippy.PipelineStage import PipelineStage
+
+
+def generate_device_map(model, num_processes: int = 1, no_split_module_classes=None, max_memory: dict = None):
+    """
+    Calculates the device map for `model` with an offset for PiPPy
+    """
+    if num_processes == 1:
+        return infer_auto_device_map(model, no_split_module_classes=no_split_module_classes, clean_result=False)
+    if max_memory is None:
+        model_size, shared = calculate_maximum_sizes(model)
+
+        # Split into `n` chunks for each GPU
+        memory = (model_size + shared[0]) / num_processes
+        memory = convert_bytes(memory)
+        value, ending = memory.split(" ")
+
+        # Add a chunk to deal with potential extra shared memory instances
+        memory = math.ceil(float(value)) * 1.1
+        memory = f"{memory} {ending}"
+        max_memory = {i: memory for i in range(num_processes)}
+    device_map = infer_auto_device_map(
+        model,
+        max_memory=max_memory,
+        no_split_module_classes=no_split_module_classes,
+        clean_result=False,
+    )
+    return device_map
+
+
+def find_pippy_batch_size(args, kwargs):
+    found_batch_size = None
+    if args is not None:
+        for arg in args:
+            found_batch_size = ignorant_find_batch_size(arg)
+            if found_batch_size is not None:
+                break
+    if kwargs is not None and found_batch_size is None:
+        for kwarg in kwargs.values():
+            found_batch_size = ignorant_find_batch_size(kwarg)
+            if found_batch_size is not None:
+                break
+    return found_batch_size
+
+
+def build_pipeline(model, split_points, args, kwargs, num_chunks):
+    """
+    Attaches the split points to the model based on `self.device_map` and generates a `PipelineStage`. Requires passing
+    in needed `args` and `kwargs` as the model needs on the CPU.
+
+    Users can pass in custom `num_chunks` as an optional hyper-parameter. By default will use
+    `AcceleratorState.num_processes`
+    """
+    # We need to annotate the split points in the model for PiPPy
+    state = PartialState()
+    annotate_split_points(model, {split_point: PipeSplitWrapper.SplitPoint.BEGINNING for split_point in split_points})
+    found_batch_size = find_pippy_batch_size(args, kwargs)
+    if found_batch_size != num_chunks:
+        if args is not None:
+            args = pad_input_tensors(args, found_batch_size, num_chunks)
+        if kwargs is not None:
+            kwargs = pad_input_tensors(kwargs, found_batch_size, num_chunks)
+    pipe = Pipe.from_tracing(model, num_chunks=num_chunks, example_args=args, example_kwargs=kwargs)
+    stage = PipelineStage(pipe, state.local_process_index, device=state.device)
+
+    return stage
+
+
+def pippy_forward(forward, num_chunks, gather_output, *args, **kwargs):
+    state = PartialState()
+    output = None
+
+    if state.num_processes == 1:
+        output = forward(*args, **kwargs)
+    elif state.is_local_main_process:
+        found_batch_size = find_pippy_batch_size(args, kwargs)
+        if found_batch_size is None:
+            raise ValueError("Could not find batch size from args or kwargs")
+        else:
+            if found_batch_size != num_chunks:
+                args = pad_input_tensors(args, found_batch_size, num_chunks)
+                kwargs = pad_input_tensors(kwargs, found_batch_size, num_chunks)
+        forward(*args, **kwargs)
+    elif state.is_last_process:
+        output = forward()
+    else:
+        forward()
+    if gather_output:
+        # Each node will get a copy of the full output which is only on the last GPU
+        output = copy_tensor_to_devices(output)
+    return output
+
+
+def prepare_pippy(
+    model,
+    split_points: Optional[Union[str, List[str]]] = "auto",
+    no_split_module_classes: Optional[List[str]] = None,
+    example_args: Optional[Tuple[Any]] = (),
+    example_kwargs: Optional[Dict[str, Any]] = None,
+    num_chunks: Optional[int] = None,
+    gather_output: Optional[bool] = False,
+):
+    """
+    Wraps `model` for pipeline parallel inference.
+
+    Args:
+        model (`torch.nn.Module`):
+            A model we want to split for pipeline-parallel inference
+        split_points (`str` or `List[str]`, defaults to 'auto'):
+            How to generate the split points and chunk the model across each GPU. 'auto' will find the best balanced
+            split given any model. Should be a list of layer names in the model to split by otherwise.
+        no_split_module_classes (`List[str]`):
+            A list of class names for layers we don't want to be split.
+        example_args (tuple of model inputs):
+            The expected inputs for the model that uses order-based inputs. Recommended to use this method if possible.
+        example_kwargs (dict of model inputs)
+            The expected inputs for the model that uses dictionary-based inputs. This is a *highly* limiting structure
+            that requires the same keys be present at *all* inference calls. Not recommended unless the prior condition
+            is true for all cases.
+        num_chunks (`int`, defaults to the number of available GPUs):
+            The number of different stages the Pipeline will have. By default it will assign one chunk per GPU, but
+            this can be tuned and played with. In general one should have num_chunks >= num_gpus.
+        gather_output (`bool`, defaults to `False`):
+            If `True`, the output from the last GPU (which holds the true outputs) is sent across to all GPUs.
+    """
+    if not is_pippy_available():
+        raise ImportError(
+            "`pippy` was not found to be installed on your system. Please "
+            "install using `pip install torchpippy` or ensure you have at least version 0.2.0"
+        )
+    state = PartialState()
+    example_args = send_to_device(example_args, "cpu")
+    example_kwargs = send_to_device(example_kwargs, "cpu")
+    if num_chunks is None:
+        num_chunks = state.num_processes
+    if split_points == "auto":
+        device_map = generate_device_map(model, num_chunks, no_split_module_classes=no_split_module_classes)
+        split_points = []
+        for i in range(1, num_chunks):
+            split_points.append(next(k for k, v in device_map.items() if v == i))
+    model.hf_split_points = split_points
+    stage = build_pipeline(model, split_points, example_args, example_kwargs, num_chunks)
+    model._original_forward = model.forward
+    model._original_call = model.__call__
+    model.pippy_stage = stage
+    model.hf_split_points = split_points
+
+    def forward(*args, **kwargs):
+        return pippy_forward(stage.forward, num_chunks, gather_output, *args, **kwargs)
+
+    # To act like a decorator so that it can be popped when doing `extract_model_from_parallel`
+    # Note: creates an infinite recursion loop with `generate`
+    model_forward = MethodType(forward, model)
+    forward.__wrapped__ = model_forward
+    model.forward = forward
+    return model
diff --git a/llm/Lib/site-packages/accelerate/launchers.py b/llm/Lib/site-packages/accelerate/launchers.py
new file mode 100644
index 0000000000000000000000000000000000000000..0265b25187f813356cfb49768097d6cf2599b0d3
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/launchers.py
@@ -0,0 +1,258 @@
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import sys
+import tempfile
+
+import torch
+
+from .state import AcceleratorState, PartialState
+from .utils import (
+    PrecisionType,
+    PrepareForLaunch,
+    are_libraries_initialized,
+    check_cuda_p2p_ib_support,
+    get_gpu_info,
+    is_mps_available,
+    patch_environment,
+)
+
+
+def test_launch():
+    "Verify a `PartialState` can be initialized."
+    _ = PartialState()
+
+
+def notebook_launcher(
+    function,
+    args=(),
+    num_processes=None,
+    mixed_precision="no",
+    use_port="29500",
+    master_addr="127.0.0.1",
+    node_rank=0,
+    num_nodes=1,
+):
+    """
+    Launches a training function, using several processes or multiple nodes if it's possible in the current environment
+    (TPU with multiple cores for instance).
+
+    <Tip warning={true}>
+
+    To use this function absolutely zero calls to a CUDA device must be made in the notebook session before calling. If
+    any have been made, you will need to restart the notebook and make sure no cells use any CUDA capability.
+
+    Setting `ACCELERATE_DEBUG_MODE="1"` in your environment will run a test before truly launching to ensure that none
+    of those calls have been made.
+
+    </Tip>
+
+    Args:
+        function (`Callable`):
+            The training function to execute. If it accepts arguments, the first argument should be the index of the
+            process run.
+        args (`Tuple`):
+            Tuple of arguments to pass to the function (it will receive `*args`).
+        num_processes (`int`, *optional*):
+            The number of processes to use for training. Will default to 8 in Colab/Kaggle if a TPU is available, to
+            the number of GPUs available otherwise.
+        mixed_precision (`str`, *optional*, defaults to `"no"`):
+            If `fp16` or `bf16`, will use mixed precision training on multi-GPU.
+        use_port (`str`, *optional*, defaults to `"29500"`):
+            The port to use to communicate between processes when launching a multi-GPU training.
+        master_addr (`str`, *optional*, defaults to `"127.0.0.1"`):
+            The address to use for communication between processes.
+        node_rank (`int`, *optional*, defaults to 0):
+            The rank of the current node.
+        num_nodes (`int`, *optional*, defaults to 1):
+            The number of nodes to use for training.
+
+    Example:
+
+    ```python
+    # Assume this is defined in a Jupyter Notebook on an instance with two GPUs
+    from accelerate import notebook_launcher
+
+
+    def train(*args):
+        # Your training function here
+        ...
+
+
+    notebook_launcher(train, args=(arg1, arg2), num_processes=2, mixed_precision="fp16")
+    ```
+    """
+    # Are we in a google colab or a Kaggle Kernel?
+    in_colab = False
+    in_kaggle = False
+    if any(key.startswith("KAGGLE") for key in os.environ.keys()):
+        in_kaggle = True
+    elif "IPython" in sys.modules:
+        in_colab = "google.colab" in str(sys.modules["IPython"].get_ipython())
+
+    try:
+        mixed_precision = PrecisionType(mixed_precision.lower())
+    except ValueError:
+        raise ValueError(
+            f"Unknown mixed_precision mode: {args.mixed_precision.lower()}. Choose between {PrecisionType.list()}."
+        )
+
+    if (in_colab or in_kaggle) and (os.environ.get("TPU_NAME", None) is not None):
+        # TPU launch
+        import torch_xla.distributed.xla_multiprocessing as xmp
+
+        if len(AcceleratorState._shared_state) > 0:
+            raise ValueError(
+                "To train on TPU in Colab or Kaggle Kernel, the `Accelerator` should only be initialized inside "
+                "your training function. Restart your notebook and make sure no cells initializes an "
+                "`Accelerator`."
+            )
+        if num_processes is None:
+            num_processes = 8
+
+        launcher = PrepareForLaunch(function, distributed_type="TPU")
+        print(f"Launching a training on {num_processes} TPU cores.")
+        xmp.spawn(launcher, args=args, nprocs=num_processes, start_method="fork")
+    elif in_colab and get_gpu_info()[1] < 2:
+        # No need for a distributed launch otherwise as it's either CPU or one GPU.
+        if torch.cuda.is_available():
+            print("Launching training on one GPU.")
+        else:
+            print("Launching training on one CPU.")
+        function(*args)
+    else:
+        if num_processes is None:
+            raise ValueError(
+                "You have to specify the number of GPUs you would like to use, add `num_processes=...` to your call."
+            )
+        if node_rank >= num_nodes:
+            raise ValueError("The node_rank must be less than the number of nodes.")
+        if num_processes > 1:
+            # Multi-GPU launch
+            from torch.multiprocessing import start_processes
+            from torch.multiprocessing.spawn import ProcessRaisedException
+
+            if len(AcceleratorState._shared_state) > 0:
+                raise ValueError(
+                    "To launch a multi-GPU training from your notebook, the `Accelerator` should only be initialized "
+                    "inside your training function. Restart your notebook and make sure no cells initializes an "
+                    "`Accelerator`."
+                )
+            # Check for specific libraries known to initialize CUDA that users constantly use
+            problematic_imports = are_libraries_initialized("bitsandbytes")
+            if len(problematic_imports) > 0:
+                err = (
+                    "Could not start distributed process. Libraries known to initialize CUDA upon import have been "
+                    "imported already. Please keep these imports inside your training function to try and help with this:"
+                )
+                for lib_name in problematic_imports:
+                    err += f"\n\t* `{lib_name}`"
+                raise RuntimeError(err)
+
+            patched_env = dict(
+                nproc=num_processes,
+                node_rank=node_rank,
+                world_size=num_nodes * num_processes,
+                master_addr=master_addr,
+                master_port=use_port,
+                mixed_precision=mixed_precision,
+            )
+
+            # Check for CUDA P2P and IB issues
+            if not check_cuda_p2p_ib_support():
+                patched_env["nccl_p2p_disable"] = "1"
+                patched_env["nccl_ib_disable"] = "1"
+
+            # torch.distributed will expect a few environment variable to be here. We set the ones common to each
+            # process here (the other ones will be set be the launcher).
+            with patch_environment(**patched_env):
+                # First dummy launch
+                if os.environ.get("ACCELERATE_DEBUG_MODE", "false").lower() == "true":
+                    launcher = PrepareForLaunch(test_launch, distributed_type="MULTI_GPU")
+                    try:
+                        start_processes(launcher, args=(), nprocs=num_processes, start_method="fork")
+                    except ProcessRaisedException as e:
+                        err = "An issue was found when verifying a stable environment for the notebook launcher."
+                        if "Cannot re-initialize CUDA in forked subprocess" in e.args[0]:
+                            raise RuntimeError(
+                                f"{err}"
+                                "This likely stems from an outside import causing issues once the `notebook_launcher()` is called. "
+                                "Please review your imports and test them when running the `notebook_launcher()` to identify "
+                                "which one is problematic and causing CUDA to be initialized."
+                            ) from e
+                        else:
+                            raise RuntimeError(f"{err} The following error was raised: {e}") from e
+                # Now the actual launch
+                launcher = PrepareForLaunch(function, distributed_type="MULTI_GPU")
+                print(f"Launching training on {num_processes} GPUs.")
+                try:
+                    start_processes(launcher, args=args, nprocs=num_processes, start_method="fork")
+                except ProcessRaisedException as e:
+                    if "Cannot re-initialize CUDA in forked subprocess" in e.args[0]:
+                        raise RuntimeError(
+                            "CUDA has been initialized before the `notebook_launcher` could create a forked subprocess. "
+                            "This likely stems from an outside import causing issues once the `notebook_launcher()` is called. "
+                            "Please review your imports and test them when running the `notebook_launcher()` to identify "
+                            "which one is problematic and causing CUDA to be initialized."
+                        ) from e
+                    else:
+                        raise RuntimeError(f"An issue was found when launching the training: {e}") from e
+
+        else:
+            # No need for a distributed launch otherwise as it's either CPU, GPU or MPS.
+            if is_mps_available():
+                os.environ["PYTORCH_ENABLE_MPS_FALLBACK"] = "1"
+                print("Launching training on MPS.")
+            elif torch.cuda.is_available():
+                print("Launching training on one GPU.")
+            else:
+                print("Launching training on CPU.")
+            function(*args)
+
+
+def debug_launcher(function, args=(), num_processes=2):
+    """
+    Launches a training function using several processes on CPU for debugging purposes.
+
+    <Tip warning={true}>
+
+    This function is provided for internal testing and debugging, but it's not intended for real trainings. It will
+    only use the CPU.
+
+    </Tip>
+
+    Args:
+        function (`Callable`):
+            The training function to execute.
+        args (`Tuple`):
+            Tuple of arguments to pass to the function (it will receive `*args`).
+        num_processes (`int`, *optional*, defaults to 2):
+            The number of processes to use for training.
+    """
+    from torch.multiprocessing import start_processes
+
+    with tempfile.NamedTemporaryFile() as tmp_file:
+        # torch.distributed will expect a few environment variable to be here. We set the ones common to each
+        # process here (the other ones will be set be the launcher).
+        with patch_environment(
+            world_size=num_processes,
+            master_addr="127.0.0.1",
+            master_port="29500",
+            accelerate_mixed_precision="no",
+            accelerate_debug_rdv_file=tmp_file.name,
+            accelerate_use_cpu="yes",
+        ):
+            launcher = PrepareForLaunch(function, debug=True)
+            start_processes(launcher, args=args, nprocs=num_processes, start_method="fork")
diff --git a/llm/Lib/site-packages/accelerate/local_sgd.py b/llm/Lib/site-packages/accelerate/local_sgd.py
new file mode 100644
index 0000000000000000000000000000000000000000..7f2657fcc8b057b4396cf299e6cf681fa7b83aa8
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/local_sgd.py
@@ -0,0 +1,102 @@
+# Copyright 2023 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import torch
+
+from accelerate import Accelerator, DistributedType
+
+
+class LocalSGD:
+    """
+    A helper class to support local SGD on top of Accelerator. It simply runs a given number of updates independently
+    on each device, and averages model weights every K synchronization step.
+
+    It should be used only in the multi-GPU (or multi-CPU) setup without extensions such as DeepSpeed. In particular,
+    this is a simple implementation that cannot support scenarios such as model parallelism.
+
+
+    Although we are not aware of the true origins of this simple approach, the idea of local SGD is quite old and goes
+    back to at least:
+
+    Zhang, J., De Sa, C., Mitliagkas, I., & Ré, C. (2016). [Parallel SGD: When does averaging help?. arXiv preprint
+    arXiv:1606.07365.](https://arxiv.org/abs/1606.07365)
+
+    We credit the term Local SGD to the following paper (but there might be earlier references we are not aware of).
+
+    Stich, Sebastian Urban. ["Local SGD Converges Fast and Communicates Little." ICLR 2019-International Conference on
+    Learning Representations. No. CONF. 2019.](https://arxiv.org/abs/1805.09767)
+
+    """
+
+    def __enter__(self):
+        if self.enabled:
+            self.model_sync_obj = self.model.no_sync()
+            self.model_sync_obj.__enter__()
+
+        return self
+
+    def __exit__(self, type, value, tb):
+        if self.enabled:
+            # Average all models on exit
+            self._sync_and_avg_model_params()
+            self.model_sync_obj.__exit__(type, value, tb)
+
+    def __init__(self, accelerator: Accelerator, model: torch.nn.Module, local_sgd_steps: int, enabled: bool = True):
+        """
+        Constructor.
+
+        Args:
+            model (`torch.nn.Module):
+                The model whose parameters we need to average.
+            accelerator (`Accelerator`):
+                Accelerator object.
+            local_sgd_steps (`int`):
+                A number of local SGD steps (before model parameters are synchronized).
+            enabled (`bool):
+                Local SGD is disabled if this parameter set to `False`.
+        """
+        if accelerator.distributed_type not in [
+            DistributedType.NO,
+            DistributedType.MULTI_CPU,
+            DistributedType.MULTI_GPU,
+            DistributedType.MULTI_MLU,
+            DistributedType.MULTI_NPU,
+        ]:
+            raise NotImplementedError("LocalSGD is supported only for CPUs and GPUs (no DeepSpeed or MegatronLM)")
+        self.enabled = enabled and accelerator.distributed_type != DistributedType.NO
+        self.num_steps = 0
+        if self.enabled:
+            self.accelerator = accelerator
+            self.model = model
+            self.local_sgd_steps = local_sgd_steps
+
+    def step(self):
+        """
+        This function makes a "step" and synchronizes model parameters if necessary.
+        """
+        self.num_steps += 1
+        if not self.enabled:
+            return
+
+        if self.num_steps % self.local_sgd_steps == 0:
+            self._sync_and_avg_model_params()
+
+    def _sync_and_avg_model_params(self):
+        """
+        Synchronize + Average model parameters across all GPUs
+        """
+
+        self.accelerator.wait_for_everyone()
+        with self.accelerator.autocast():
+            for param in self.model.parameters():
+                param.data = self.accelerator.reduce(param.data, reduction="mean")
diff --git a/llm/Lib/site-packages/accelerate/logging.py b/llm/Lib/site-packages/accelerate/logging.py
new file mode 100644
index 0000000000000000000000000000000000000000..ebb8c1eb830e54e3f2870cb3a84afd33b7631ea6
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/logging.py
@@ -0,0 +1,123 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import functools
+import logging
+import os
+
+from .state import PartialState
+
+
+class MultiProcessAdapter(logging.LoggerAdapter):
+    """
+    An adapter to assist with logging in multiprocess.
+
+    `log` takes in an additional `main_process_only` kwarg, which dictates whether it should be called on all processes
+    or only the main executed one. Default is `main_process_only=True`.
+
+    Does not require an `Accelerator` object to be created first.
+    """
+
+    @staticmethod
+    def _should_log(main_process_only):
+        "Check if log should be performed"
+        state = PartialState()
+        return not main_process_only or (main_process_only and state.is_main_process)
+
+    def log(self, level, msg, *args, **kwargs):
+        """
+        Delegates logger call after checking if we should log.
+
+        Accepts a new kwarg of `main_process_only`, which will dictate whether it will be logged across all processes
+        or only the main executed one. Default is `True` if not passed
+
+        Also accepts "in_order", which if `True` makes the processes log one by one, in order. This is much easier to
+        read, but comes at the cost of sometimes needing to wait for the other processes. Default is `False` to not
+        break with the previous behavior.
+
+        `in_order` is ignored if `main_process_only` is passed.
+        """
+        if PartialState._shared_state == {}:
+            raise RuntimeError(
+                "You must initialize the accelerate state by calling either `PartialState()` or `Accelerator()` before using the logging utility."
+            )
+        main_process_only = kwargs.pop("main_process_only", True)
+        in_order = kwargs.pop("in_order", False)
+
+        if self.isEnabledFor(level):
+            if self._should_log(main_process_only):
+                msg, kwargs = self.process(msg, kwargs)
+                self.logger.log(level, msg, *args, **kwargs)
+
+            elif in_order:
+                state = PartialState()
+                for i in range(state.num_processes):
+                    if i == state.process_index:
+                        msg, kwargs = self.process(msg, kwargs)
+                        self.logger.log(level, msg, *args, **kwargs)
+                    state.wait_for_everyone()
+
+    @functools.lru_cache(None)
+    def warning_once(self, *args, **kwargs):
+        """
+        This method is identical to `logger.warning()`, but will emit the warning with the same message only once
+
+        Note: The cache is for the function arguments, so 2 different callers using the same arguments will hit the
+        cache. The assumption here is that all warning messages are unique across the code. If they aren't then need to
+        switch to another type of cache that includes the caller frame information in the hashing function.
+        """
+        self.warning(*args, **kwargs)
+
+
+def get_logger(name: str, log_level: str = None):
+    """
+    Returns a `logging.Logger` for `name` that can handle multiprocessing.
+
+    If a log should be called on all processes, pass `main_process_only=False` If a log should be called on all
+    processes and in order, also pass `in_order=True`
+
+    Args:
+        name (`str`):
+            The name for the logger, such as `__file__`
+        log_level (`str`, *optional*):
+            The log level to use. If not passed, will default to the `LOG_LEVEL` environment variable, or `INFO` if not
+
+    Example:
+
+    ```python
+    >>> from accelerate.logging import get_logger
+    >>> from accelerate import Accelerator
+
+    >>> logger = get_logger(__name__)
+
+    >>> accelerator = Accelerator()
+    >>> logger.info("My log", main_process_only=False)
+    >>> logger.debug("My log", main_process_only=True)
+
+    >>> logger = get_logger(__name__, log_level="DEBUG")
+    >>> logger.info("My log")
+    >>> logger.debug("My second log")
+
+    >>> array = ["a", "b", "c", "d"]
+    >>> letter_at_rank = array[accelerator.process_index]
+    >>> logger.info(letter_at_rank, in_order=True)
+    ```
+    """
+    if log_level is None:
+        log_level = os.environ.get("ACCELERATE_LOG_LEVEL", None)
+    logger = logging.getLogger(name)
+    if log_level is not None:
+        logger.setLevel(log_level.upper())
+        logger.root.setLevel(log_level.upper())
+    return MultiProcessAdapter(logger, {})
diff --git a/llm/Lib/site-packages/accelerate/memory_utils.py b/llm/Lib/site-packages/accelerate/memory_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..fa2e2c8b9d7d0064c3e5e282737a7ad6919bde29
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/memory_utils.py
@@ -0,0 +1,22 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import warnings
+
+
+warnings.warn(
+    "memory_utils has been reorganized to utils.memory. Import `find_executable_batchsize` from the main `__init__`: "
+    "`from accelerate import find_executable_batch_size` to avoid this warning.",
+    FutureWarning,
+)
diff --git a/llm/Lib/site-packages/accelerate/optimizer.py b/llm/Lib/site-packages/accelerate/optimizer.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2fc3e9f1b7592b29ed18ce1ce78a0859286f438
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/optimizer.py
@@ -0,0 +1,193 @@
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import warnings
+
+import torch
+
+from .state import AcceleratorState, GradientState
+from .utils import DistributedType, honor_type, is_torch_xla_available
+
+
+if is_torch_xla_available():
+    import torch_xla.core.xla_model as xm
+
+
+def move_to_device(state, device):
+    if isinstance(state, (list, tuple)):
+        return honor_type(state, (move_to_device(t, device) for t in state))
+    elif isinstance(state, dict):
+        return type(state)({k: move_to_device(v, device) for k, v in state.items()})
+    elif isinstance(state, torch.Tensor):
+        return state.to(device)
+    return state
+
+
+class AcceleratedOptimizer(torch.optim.Optimizer):
+    """
+    Internal wrapper around a torch optimizer.
+
+    Conditionally will perform `step` and `zero_grad` if gradients should be synchronized when performing gradient
+    accumulation.
+
+    Args:
+        optimizer (`torch.optim.optimizer.Optimizer`):
+            The optimizer to wrap.
+        device_placement (`bool`, *optional*, defaults to `True`):
+            Whether or not the optimizer should handle device placement. If so, it will place the state dictionary of
+            `optimizer` on the right device.
+        scaler (`torch.cuda.amp.grad_scaler.GradScaler`, *optional*):
+            The scaler to use in the step function if training with mixed precision.
+    """
+
+    def __init__(self, optimizer, device_placement=True, scaler=None):
+        self.optimizer = optimizer
+        self.scaler = scaler
+        self.accelerator_state = AcceleratorState()
+        self.gradient_state = GradientState()
+        self.device_placement = device_placement
+        self._is_overflow = False
+
+        if self.scaler is not None:
+            self._accelerate_step_called = False
+            self._optimizer_original_step_method = self.optimizer.step
+            self._optimizer_patched_step_method = patch_optimizer_step(self, self.optimizer.step)
+
+        # Handle device placement
+        if device_placement:
+            state_dict = self.optimizer.state_dict()
+            if self.accelerator_state.distributed_type == DistributedType.XLA:
+                xm.send_cpu_data_to_device(state_dict, self.accelerator_state.device)
+            else:
+                state_dict = move_to_device(state_dict, self.accelerator_state.device)
+            self.optimizer.load_state_dict(state_dict)
+
+    @property
+    def state(self):
+        return self.optimizer.state
+
+    @state.setter
+    def state(self, state):
+        self.optimizer.state = state
+
+    @property
+    def param_groups(self):
+        return self.optimizer.param_groups
+
+    @param_groups.setter
+    def param_groups(self, param_groups):
+        self.optimizer.param_groups = param_groups
+
+    @property
+    def defaults(self):
+        return self.optimizer.defaults
+
+    @defaults.setter
+    def defaults(self, defaults):
+        self.optimizer.defaults = defaults
+
+    def add_param_group(self, param_group):
+        self.optimizer.add_param_group(param_group)
+
+    def load_state_dict(self, state_dict):
+        if self.accelerator_state.distributed_type == DistributedType.XLA and self.device_placement:
+            xm.send_cpu_data_to_device(state_dict, self.accelerator_state.device)
+        self.optimizer.load_state_dict(state_dict)
+
+    def state_dict(self):
+        return self.optimizer.state_dict()
+
+    def zero_grad(self, set_to_none=None):
+        if self.gradient_state.sync_gradients:
+            accept_arg = "set_to_none" in inspect.signature(self.optimizer.zero_grad).parameters
+            if accept_arg:
+                if set_to_none is None:
+                    set_to_none = True
+                self.optimizer.zero_grad(set_to_none=set_to_none)
+            else:
+                if set_to_none is not None:
+                    raise ValueError("`set_to_none` for Optimizer.zero_grad` is not supported by this optimizer.")
+                self.optimizer.zero_grad()
+
+    def step(self, closure=None):
+        if (
+            not self.gradient_state.is_xla_gradients_synced
+            and self.accelerator_state.distributed_type == DistributedType.XLA
+        ):
+            gradients = xm._fetch_gradients(self.optimizer)
+            xm.all_reduce("sum", gradients, scale=1.0 / xm.xrt_world_size())
+            self.gradient_state.is_xla_gradients_synced = True
+        if self.gradient_state.sync_gradients:
+            if self.scaler is not None:
+                self.optimizer.step = self._optimizer_patched_step_method
+
+                self.scaler.step(self.optimizer, closure)
+                self.scaler.update()
+
+                if not self._accelerate_step_called:
+                    # If the optimizer step was skipped, gradient overflow was detected.
+                    self._is_overflow = True
+                else:
+                    self._is_overflow = False
+                # Reset the step method to the original one
+                self.optimizer.step = self._optimizer_original_step_method
+                # Reset the indicator
+                self._accelerate_step_called = False
+            else:
+                self.optimizer.step(closure)
+        if self.accelerator_state.distributed_type == DistributedType.XLA:
+            self.gradient_state.is_xla_gradients_synced = False
+
+    def _switch_parameters(self, parameters_map):
+        for param_group in self.optimizer.param_groups:
+            param_group["params"] = [parameters_map.get(p, p) for p in param_group["params"]]
+
+    @property
+    def is_overflow(self):
+        """Whether or not the optimizer step was done, or skipped because of gradient overflow."""
+        warnings.warn(
+            "The `is_overflow` property is deprecated and will be removed in version 1.0 of Accelerate use "
+            "`optimizer.step_was_skipped` instead.",
+            FutureWarning,
+        )
+        return self._is_overflow
+
+    @property
+    def step_was_skipped(self):
+        """Whether or not the optimizer step was skipped."""
+        return self._is_overflow
+
+    def __getstate__(self):
+        _ignored_keys = [
+            "_accelerate_step_called",
+            "_optimizer_original_step_method",
+            "_optimizer_patched_step_method",
+        ]
+        return {k: v for k, v in self.__dict__.items() if k not in _ignored_keys}
+
+    def __setstate__(self, state):
+        self.__dict__.update(state)
+        if self.scaler is not None:
+            self._accelerate_step_called = False
+            self._optimizer_original_step_method = self.optimizer.step
+            self._optimizer_patched_step_method = patch_optimizer_step(self, self.optimizer.step)
+
+
+def patch_optimizer_step(accelerated_optimizer: AcceleratedOptimizer, method):
+    def patched_step(*args, **kwargs):
+        accelerated_optimizer._accelerate_step_called = True
+        return method(*args, **kwargs)
+
+    return patched_step
diff --git a/llm/Lib/site-packages/accelerate/scheduler.py b/llm/Lib/site-packages/accelerate/scheduler.py
new file mode 100644
index 0000000000000000000000000000000000000000..1fa8a13f238afd7b908ee8e8cb8e0620f48d4ff8
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/scheduler.py
@@ -0,0 +1,98 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# We ignore warnings about stepping the scheduler since we step it ourselves during gradient accumulation
+
+import warnings
+
+from .state import AcceleratorState, GradientState
+
+
+warnings.filterwarnings("ignore", category=UserWarning, module="torch.optim.lr_scheduler")
+
+
+class AcceleratedScheduler:
+    """
+    A wrapper around a learning rate scheduler that will only step when the optimizer(s) have a training step. Useful
+    to avoid making a scheduler step too fast when gradients went overflow and there was no training step (in mixed
+    precision training)
+
+    When performing gradient accumulation scheduler lengths should not be changed accordingly, Accelerate will always
+    step the scheduler to account for it.
+
+    Args:
+        scheduler (`torch.optim.lr_scheduler._LRScheduler`):
+            The scheduler to wrap.
+        optimizers (one or a list of `torch.optim.Optimizer`):
+            The optimizers used.
+        step_with_optimizer (`bool`, *optional*, defaults to `True`):
+            Whether or not the scheduler should be stepped at each optimizer step.
+        split_batches (`bool`, *optional*, defaults to `False`):
+            Whether or not the dataloaders split one batch across the different processes (so batch size is the same
+            regardless of the number of processes) or create batches on each process (so batch size is the original
+            batch size multiplied by the number of processes).
+    """
+
+    def __init__(self, scheduler, optimizers, step_with_optimizer: bool = True, split_batches: bool = False):
+        self.scheduler = scheduler
+        self.optimizers = optimizers if isinstance(optimizers, (list, tuple)) else [optimizers]
+        self.split_batches = split_batches
+        self.step_with_optimizer = step_with_optimizer
+        self.gradient_state = GradientState()
+
+    def step(self, *args, **kwargs):
+        if not self.step_with_optimizer:
+            # No link between scheduler and optimizer -> just step
+            self.scheduler.step(*args, **kwargs)
+            return
+
+        # Otherwise, first make sure the optimizer was stepped.
+        if not self.gradient_state.sync_gradients:
+            if self.gradient_state.adjust_scheduler:
+                self.scheduler._step_count += 1
+            return
+
+        for opt in self.optimizers:
+            if opt.step_was_skipped:
+                return
+        if self.split_batches:
+            # Split batches -> the training dataloader batch size is not changed so one step per training step
+            self.scheduler.step(*args, **kwargs)
+        else:
+            # Otherwise the training dataloader batch size was multiplied by `num_processes`, so we need to do
+            # num_processes steps per training step
+            num_processes = AcceleratorState().num_processes
+            for _ in range(num_processes):
+                # Special case when using OneCycle and `drop_last` was not used
+                if hasattr(self.scheduler, "total_steps"):
+                    if self.scheduler._step_count <= self.scheduler.total_steps:
+                        self.scheduler.step(*args, **kwargs)
+                else:
+                    self.scheduler.step(*args, **kwargs)
+
+    # Passthroughs
+    def get_last_lr(self):
+        return self.scheduler.get_last_lr()
+
+    def state_dict(self):
+        return self.scheduler.state_dict()
+
+    def load_state_dict(self, state_dict):
+        self.scheduler.load_state_dict(state_dict)
+
+    def get_lr(self):
+        return self.scheduler.get_lr()
+
+    def print_lr(self, *args, **kwargs):
+        return self.scheduler.print_lr(*args, **kwargs)
diff --git a/llm/Lib/site-packages/accelerate/state.py b/llm/Lib/site-packages/accelerate/state.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d65c5a1314bd9cdb8013808f1540184ba08b12b
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/state.py
@@ -0,0 +1,1209 @@
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import logging
+import math
+import os
+import threading
+import warnings
+from contextlib import contextmanager
+from functools import partial
+from typing import Any, Callable, Optional
+
+import torch
+
+from .utils import (
+    DistributedType,
+    DynamoBackend,
+    GradientAccumulationPlugin,
+    check_cuda_p2p_ib_support,
+    check_fp8_capability,
+    get_ccl_version,
+    get_cpu_distributed_information,
+    get_int_from_env,
+    is_ccl_available,
+    is_datasets_available,
+    is_deepspeed_available,
+    is_fp8_available,
+    is_ipex_available,
+    is_mlu_available,
+    is_mps_available,
+    is_npu_available,
+    is_torch_xla_available,
+    is_xpu_available,
+    parse_choice_from_env,
+    parse_flag_from_env,
+    set_numa_affinity,
+)
+from .utils.dataclasses import SageMakerDistributedType
+
+
+if is_torch_xla_available():
+    import torch_xla.core.xla_model as xm
+
+if is_mlu_available(check_device=False):
+    import torch_mlu  # noqa: F401
+
+if is_npu_available(check_device=False):
+    import torch_npu  # noqa: F401
+
+logger = logging.getLogger(__name__)
+
+
+def is_initialized() -> bool:
+    """
+    Checks if the `AcceleratorState` has been initialized from `Accelerator`. Same as `AcceleratorState.initialized`,
+    but works as a module method.
+    """
+    return AcceleratorState._shared_state != {}
+
+
+# Lambda function that does nothing
+def do_nothing(*args, **kwargs):
+    return None
+
+
+class ThreadLocalSharedDict(threading.local):
+    """
+    Descriptor that holds a dict shared between instances of a class in the same thread.
+
+    Note: Descriptors have slightly different semantics than just a dict field on its own.
+    `PartialState(...)._shared_state` and `PartialState._shared_state` (instance vs class) give the same value: the
+    underlying _storage dict. Likewise, `PartialState(...)._shared_state = {...}` overrides the _storage dict inside
+    the descriptor as you would expect. However, `PartialState._shared_state = {}` actually replaces the descriptor
+    object with a dict instead Thus, you should modify the _storage dict in-place (e.g. `_shared_state.clear()`).
+
+    See Python documentation for an explanation of descriptors: https://docs.python.org/3/howto/descriptor.html
+
+    This is required for using PyTorch/XLA with PJRT in multithreaded mode (required for TPU v2 and v3).
+
+    See https://github.com/pytorch/xla/blob/r2.0/docs/pjrt.md#multithreading-on-tpu-v2v3
+    """
+
+    def __init__(self, thread_local: bool = False):
+        self._storage = {}
+
+    def __get__(self, obj, objtype=None):
+        return self._storage
+
+    def __set__(self, obj, value):
+        self._storage = value
+
+
+# Prefer global shared dictionary, except when using TPU.
+SharedDict = dict if not is_torch_xla_available() else ThreadLocalSharedDict
+
+
+# Inspired by Alex Martelli's 'Borg'.
+class PartialState:
+    """
+    Singleton class that has information about the current training environment and functions to help with process
+    control. Designed to be used when only process control and device execution states are needed. Does *not* need to
+    be initialized from `Accelerator`.
+
+    Args:
+        cpu (`bool`, *optional*):
+            Whether or not to force the script to execute on CPU. Will ignore any accelerators available if set to
+            `True` and force the execution on the CPU.
+        kwargs (additional keyword arguments, *optional*):
+            Additional keyword arguments to pass to the relevent `init_process_group` function. Valid `kwargs` can be
+            found in [`utils.InitProcessGroupKwargs`]. See the example section for detailed usage.
+
+    **Available attributes:**
+
+        - **device** (`torch.device`) -- The device to use.
+        - **distributed_type** ([`~accelerate.state.DistributedType`]) -- The type of distributed environment currently
+          in use.
+        - **local_process_index** (`int`) -- The index of the current process on the current server.
+        - **mixed_precision** (`str`) -- Whether or not the current script will use mixed precision, and if so the type
+          of mixed precision being performed. (Choose from 'no','fp16','bf16 or 'fp8').
+        - **num_processes** (`int`) -- The number of processes currently launched in parallel.
+        - **process_index** (`int`) -- The index of the current process.
+        - **is_last_process** (`bool`) -- Whether or not the current process is the last one.
+        - **is_main_process** (`bool`) -- Whether or not the current process is the main one.
+        - **is_local_main_process** (`bool`) -- Whether or not the current process is the main one on the local node.
+        - **debug** (`bool`) -- Whether or not the current script is being run in debug mode.
+
+    Example:
+    ```python
+    from accelerate.utils import InitProcessGroupKwargs
+
+    # To include `InitProcessGroupKwargs`, init then call `.to_kwargs()`
+    kwargs = InitProcessGroupKwargs(...).to_kwargs()
+    state = PartialState(**kwargs)
+    ```
+    """
+
+    _shared_state = SharedDict()
+    _known_attrs = [
+        "_cpu",
+        "_mixed_precision",
+        "_shared_state",
+        "backend",
+        "debug",
+        "device",
+        "distributed_type",
+        "fork_launched",
+        "local_process_index",
+        "num_processes",
+        "process_index",
+    ]
+
+    def __init__(self, cpu: bool = False, **kwargs):
+        self.__dict__ = self._shared_state
+        if not self.initialized:
+            self._cpu = cpu
+            self.backend = None
+            env_device = os.environ.get("ACCELERATE_TORCH_DEVICE", None)
+            self.device = torch.device(env_device) if env_device is not None else None
+            self.debug = parse_flag_from_env("ACCELERATE_DEBUG_MODE")
+            use_sagemaker_dp = kwargs.pop("_use_sagemaker_dp", None)
+            dist_information = None
+            if use_sagemaker_dp is None:
+                use_sagemaker_dp = (
+                    os.environ.get("ACCELERATE_USE_SAGEMAKER", "false") == "true"
+                    and os.environ.get("ACCELERATE_SAGEMAKER_DISTRIBUTED_TYPE") != SageMakerDistributedType.NO
+                )
+
+            # Sets up self.backend + imports
+            original_backend = kwargs.pop("backend", None)
+            backend, distributed_type = self._prepare_backend(cpu, use_sagemaker_dp, original_backend)
+            if original_backend is not None and backend != original_backend:
+                raise ValueError("Your assigned backend {original_backend} is not avaliable, please use {backend}")
+            self.backend = backend
+            self.distributed_type = distributed_type
+            use_deepspeed = False
+            if not cpu and self.backend != "xla":
+                if int(os.environ.get("LOCAL_RANK", -1)) != -1:
+                    # Deal with spawning deepspeed
+                    if os.environ.get("ACCELERATE_USE_DEEPSPEED", "false") == "true":
+                        if not is_deepspeed_available():
+                            raise ImportError(
+                                "DeepSpeed is not available => install it using `pip3 install deepspeed` or build it from source"
+                            )
+                        from deepspeed import comm as dist
+
+                        if is_xpu_available() and is_ccl_available():
+                            os.environ["CCL_PROCESS_LAUNCHER"] = "none"
+                            os.environ["CCL_LOCAL_SIZE"] = os.environ.get("LOCAL_WORLD_SIZE", "1")
+                            os.environ["CCL_LOCAL_RANK"] = os.environ.get("LOCAL_RANK", "0")
+
+                        if not dist.is_initialized():
+                            dist.init_distributed(dist_backend=self.backend, auto_mpi_discovery=False, **kwargs)
+                        # We need to flag to `use_deepspeed` to be True to override `distributed_type` later
+                        use_deepspeed = True
+                    # Deal with all other backends but XPU and CPU, that gets handled special later
+                    elif (
+                        self.distributed_type not in (DistributedType.MULTI_XPU, DistributedType.MULTI_CPU)
+                        and not torch.distributed.is_initialized()
+                    ):
+                        torch.distributed.init_process_group(backend=self.backend, **kwargs)
+            # XPU and CPU require special env configs to be set
+            if self.distributed_type in (DistributedType.MULTI_XPU, DistributedType.MULTI_CPU):
+                dist_information = get_cpu_distributed_information()
+                os.environ["RANK"] = str(dist_information.rank)
+                os.environ["WORLD_SIZE"] = str(dist_information.world_size)
+                os.environ["LOCAL_RANK"] = str(dist_information.local_rank)
+                os.environ["LOCAL_WORLD_SIZE"] = str(dist_information.local_world_size)
+                if self.backend == "ccl" and self.distributed_type == DistributedType.MULTI_XPU:
+                    os.environ["CCL_PROCESS_LAUNCHER"] = "none"
+                    os.environ["CCL_LOCAL_SIZE"] = os.environ["LOCAL_WORLD_SIZE"]
+                    os.environ["CCL_LOCAL_RANK"] = os.environ["LOCAL_RANK"]
+                if not os.environ.get("MASTER_PORT", None):
+                    os.environ["MASTER_PORT"] = "29500"
+                if (
+                    not os.environ.get("MASTER_ADDR", None)
+                    and dist_information.local_world_size != dist_information.world_size
+                    and self.backend != "mpi"
+                ):
+                    raise ValueError(
+                        "Tried to launch on distributed with multinode, but `MASTER_ADDR` env was not set, "
+                        "please try exporting rank 0's hostname as `MASTER_ADDR`"
+                    )
+                kwargs["rank"] = dist_information.rank
+                kwargs["world_size"] = dist_information.world_size
+
+                if (
+                    self.distributed_type == DistributedType.MULTI_CPU
+                    and get_int_from_env(["OMP_NUM_THREADS", "OMP_NUM_THREADS"], 0) > 0
+                ):
+                    import psutil
+
+                    num_cpu_threads_per_process = int(
+                        psutil.cpu_count(logical=False) / dist_information.local_world_size
+                    )
+                    if num_cpu_threads_per_process == 0:
+                        num_cpu_threads_per_process = 1
+                    torch.set_num_threads(num_cpu_threads_per_process)
+                    warnings.warn(
+                        f"OMP_NUM_THREADS/MKL_NUM_THREADS unset, we set it at {num_cpu_threads_per_process} to improve oob"
+                        " performance."
+                    )
+
+                if not torch.distributed.is_initialized():
+                    torch.distributed.init_process_group(backend=self.backend, **kwargs)
+
+            # No backend == no distributed training
+            if self.backend is None:
+                self.distributed_type = DistributedType.NO
+                self.num_processes = 1
+                self.process_index = 0
+                self.local_process_index = 0
+            elif self.backend == "xla":
+                # XLA needs device setting first for `set_replication`
+                self.set_device()
+                xm.set_replication(self.device, xm.get_xla_supported_devices())
+                self.num_processes = xm.xrt_world_size()
+                self.process_index = xm.get_ordinal()
+                if is_torch_xla_available(check_is_tpu=True):
+                    self.local_process_index = xm.get_local_ordinal()
+                else:
+                    self.local_process_index = int(os.environ.get("LOCAL_RANK", -1))
+            else:
+                self.num_processes = torch.distributed.get_world_size()
+                self.process_index = torch.distributed.get_rank()
+                self.local_process_index = (
+                    int(os.environ.get("LOCAL_RANK", -1)) if dist_information is None else dist_information.local_rank
+                )
+            self.set_device()
+            # Now we can change to deepseed
+            if use_deepspeed:
+                self.distributed_type = DistributedType.DEEPSPEED
+
+            # Set CPU affinity if enabled
+            if parse_flag_from_env("ACCELERATE_CPU_AFFINITY", False):
+                set_numa_affinity(self.local_process_index)
+
+            # Check for old RTX 4000's that can't use P2P or IB and are on old drivers
+            if self.device.type == "cuda" and not check_cuda_p2p_ib_support():
+                if "NCCL_P2P_DISABLE" not in os.environ or "NCCL_IB_DISABLE" not in os.environ:
+                    raise NotImplementedError(
+                        "Using RTX 4000 series doesn't support faster communication broadband via P2P or IB. "
+                        'Please set `NCCL_P2P_DISABLE="1"` and `NCCL_IB_DISABLE="1" or use `accelerate launch` which '
+                        "will do this automatically."
+                    )
+        # Important: This should be the *only* code outside of `self.initialized!`
+        self.fork_launched = parse_flag_from_env("FORK_LAUNCHED", 0)
+
+    def __repr__(self) -> str:
+        return (
+            f"Distributed environment: {self.distributed_type}{('  Backend: ' + self.backend) if self.backend else ''}\n"
+            f"Num processes: {self.num_processes}\n"
+            f"Process index: {self.process_index}\n"
+            f"Local process index: {self.local_process_index}\n"
+            f"Device: {self.device}\n"
+        )
+
+    @staticmethod
+    def _reset_state():
+        "Resets `_shared_state`, is used internally and should not be called"
+        PartialState._shared_state.clear()
+
+    @property
+    def initialized(self) -> bool:
+        "Returns whether the `PartialState` has been initialized"
+        return self._shared_state != {}
+
+    @property
+    def use_distributed(self):
+        """
+        Whether the Accelerator is configured for distributed training
+        """
+        return self.distributed_type != DistributedType.NO and self.num_processes > 1
+
+    @property
+    def is_last_process(self) -> bool:
+        "Returns whether the current process is the last one"
+        return self.process_index == self.num_processes - 1
+
+    @property
+    def is_main_process(self) -> bool:
+        "Returns whether the current process is the main process"
+        return (
+            self.process_index == 0 if self.distributed_type != DistributedType.MEGATRON_LM else self.is_last_process
+        )
+
+    @property
+    def is_local_main_process(self) -> bool:
+        "Returns whether the current process is the main process on the local node"
+        return (
+            self.local_process_index == 0
+            if self.distributed_type != DistributedType.MEGATRON_LM
+            else self.is_last_process
+        )
+
+    def wait_for_everyone(self):
+        """
+        Will stop the execution of the current process until every other process has reached that point (so this does
+        nothing when the script is only run in one process). Useful to do before saving a model.
+
+        Example:
+
+        ```python
+        >>> # Assuming two GPU processes
+        >>> import time
+        >>> from accelerate.state import PartialState
+
+        >>> state = PartialState()
+        >>> if state.is_main_process:
+        ...     time.sleep(2)
+        >>> else:
+        ...     print("I'm waiting for the main process to finish its sleep...")
+        >>> state.wait_for_everyone()
+        >>> # Should print on every process at the same time
+        >>> print("Everyone is here")
+        ```
+        """
+        if self.distributed_type in (
+            DistributedType.MULTI_GPU,
+            DistributedType.MULTI_MLU,
+            DistributedType.MULTI_NPU,
+            DistributedType.MULTI_XPU,
+            DistributedType.MULTI_CPU,
+            DistributedType.DEEPSPEED,
+            DistributedType.FSDP,
+        ):
+            torch.distributed.barrier()
+        elif self.distributed_type == DistributedType.XLA:
+            xm.rendezvous("accelerate.utils.wait_for_everyone")
+
+    def _goes_first(self, is_main: bool):
+        if not is_main:
+            self.wait_for_everyone()
+
+        yield
+
+        if is_main:
+            self.wait_for_everyone()
+
+    @contextmanager
+    def split_between_processes(self, inputs: list | tuple | dict | torch.Tensor, apply_padding: bool = False):
+        """
+        Splits `input` between `self.num_processes` quickly and can be then used on that process. Useful when doing
+        distributed inference, such as with different prompts.
+
+        Note that when using a `dict`, all keys need to have the same number of elements.
+
+        Args:
+            inputs (`list`, `tuple`, `torch.Tensor`, `dict` of `list`/`tuple`/`torch.Tensor`, or `datasets.Dataset`):
+                The input to split between processes.
+            apply_padding (`bool`, `optional`, defaults to `False`):
+                Whether to apply padding by repeating the last element of the input so that all processes have the same
+                number of elements. Useful when trying to perform actions such as `gather()` on the outputs or passing
+                in less inputs than there are processes. If so, just remember to drop the padded elements afterwards.
+
+
+        Example:
+
+        ```python
+        # Assume there are two processes
+        from accelerate import PartialState
+
+        state = PartialState()
+        with state.split_between_processes(["A", "B", "C"]) as inputs:
+            print(inputs)
+        # Process 0
+        ["A", "B"]
+        # Process 1
+        ["C"]
+
+        with state.split_between_processes(["A", "B", "C"], apply_padding=True) as inputs:
+            print(inputs)
+        # Process 0
+        ["A", "B"]
+        # Process 1
+        ["C", "C"]
+        ```
+        """
+        if self.num_processes == 1:
+            yield inputs
+            return
+        length = len(inputs)
+        # Nested dictionary of any types
+        if isinstance(inputs, dict):
+            length = len(inputs[list(inputs.keys())[0]])
+            if not all(len(v) == length for v in inputs.values()):
+                raise ValueError("All values in the dictionary must have the same length")
+        num_samples_per_process = math.ceil(length / self.num_processes)
+        start_index = self.process_index * num_samples_per_process
+        end_index = start_index + num_samples_per_process
+        if (len(inputs) % self.num_processes != 0) and (self.process_index == self.num_processes - 1):
+            end_index = length
+
+        def _split_values(inputs, start_index, end_index):
+            if isinstance(inputs, (list, tuple, torch.Tensor)):
+                if start_index >= len(inputs):
+                    result = inputs[-1:]
+                else:
+                    result = inputs[start_index:end_index]
+                if apply_padding:
+                    if isinstance(result, torch.Tensor):
+                        from accelerate.utils import pad_across_processes, send_to_device
+
+                        # The tensor needs to be on the device before we can pad it
+                        tensorized_result = send_to_device(result, self.device)
+                        result = pad_across_processes(tensorized_result, pad_index=inputs[-1])
+                    else:
+                        result += [result[-1]] * (num_samples_per_process - len(result))
+                return result
+            elif isinstance(inputs, dict):
+                for key in inputs.keys():
+                    inputs[key] = _split_values(inputs[key], start_index, end_index)
+                return inputs
+            else:
+                if is_datasets_available():
+                    from datasets import Dataset
+
+                    if isinstance(inputs, Dataset):
+                        if start_index >= len(inputs):
+                            start_index = len(inputs) - 1
+                        if end_index > len(inputs):
+                            end_index = len(inputs)
+                        result_idcs = list(range(start_index, end_index))
+                        if apply_padding:
+                            result_idcs += [end_index - 1] * (num_samples_per_process - len(result_idcs))
+                        return inputs.select(result_idcs)
+                return inputs
+
+        yield _split_values(inputs, start_index, end_index)
+
+    @contextmanager
+    def main_process_first(self):
+        """
+        Lets the main process go first inside a with block.
+
+        The other processes will enter the with block after the main process exits.
+
+        Example:
+
+        ```python
+        >>> from accelerate import Accelerator
+
+        >>> accelerator = Accelerator()
+        >>> with accelerator.main_process_first():
+        ...     # This will be printed first by process 0 then in a seemingly
+        ...     # random order by the other processes.
+        ...     print(f"This will be printed by process {accelerator.process_index}")
+        ```
+        """
+        yield from self._goes_first(self.is_main_process)
+
+    @contextmanager
+    def local_main_process_first(self):
+        """
+        Lets the local main process go inside a with block.
+
+        The other processes will enter the with block after the main process exits.
+
+        Example:
+
+        ```python
+        >>> from accelerate.state import PartialState
+
+        >>> state = PartialState()
+        >>> with state.local_main_process_first():
+        ...     # This will be printed first by local process 0 then in a seemingly
+        ...     # random order by the other processes.
+        ...     print(f"This will be printed by process {state.local_process_index}")
+        ```
+        """
+        yield from self._goes_first(self.is_local_main_process)
+
+    def on_main_process(self, function: Callable[..., Any] = None):
+        """
+        Decorator that only runs the decorated function on the main process.
+
+        Args:
+            function (`Callable`): The function to decorate.
+
+        Example:
+
+        ```python
+        >>> from accelerate.state import PartialState
+
+        >>> state = PartialState()
+
+
+        >>> @state.on_main_process
+        ... def print_something():
+        ...     print("This will be printed by process 0 only.")
+
+
+        >>> print_something()
+        "This will be printed by process 0 only"
+        ```
+        """
+        if not self.initialized:
+            raise ValueError("The `PartialState` or `Accelerator` must be initialized before calling this function.")
+        if self.is_main_process or not self.use_distributed:
+            return function
+        return do_nothing
+
+    def on_local_main_process(self, function: Callable[..., Any] = None):
+        """
+        Decorator that only runs the decorated function on the local main process.
+
+        Args:
+            function (`Callable`): The function to decorate.
+
+        Example:
+        ```python
+        # Assume we have 2 servers with 4 processes each.
+        from accelerate.state import PartialState
+
+        state = PartialState()
+
+
+        @state.on_local_main_process
+        def print_something():
+            print("This will be printed by process 0 only on each server.")
+
+
+        print_something()
+        # On server 1:
+        "This will be printed by process 0 only"
+        # On server 2:
+        "This will be printed by process 0 only"
+        ```
+        """
+        if self.is_local_main_process or not self.use_distributed:
+            return function
+        return do_nothing
+
+    def on_last_process(self, function: Callable[..., Any]):
+        """
+        Decorator that only runs the decorated function on the last process.
+
+        Args:
+            function (`Callable`): The function to decorate.
+
+        Example:
+        ```python
+        # Assume we have 4 processes.
+        from accelerate.state import PartialState
+
+        state = PartialState()
+
+
+        @state.on_last_process
+        def print_something():
+            print(f"Printed on process {state.process_index}")
+
+
+        print_something()
+        "Printed on process 3"
+        ```
+        """
+        if self.is_last_process or not self.use_distributed:
+            return function
+        return do_nothing
+
+    def on_process(self, function: Callable[..., Any] = None, process_index: int = None):
+        """
+        Decorator that only runs the decorated function on the process with the given index.
+
+        Args:
+            function (`Callable`, `optional`):
+                The function to decorate.
+            process_index (`int`, `optional`):
+                The index of the process on which to run the function.
+
+        Example:
+        ```python
+        # Assume we have 4 processes.
+        from accelerate.state import PartialState
+
+        state = PartialState()
+
+
+        @state.on_process(process_index=2)
+        def print_something():
+            print(f"Printed on process {state.process_index}")
+
+
+        print_something()
+        "Printed on process 2"
+        ```
+        """
+        if function is None:
+            return partial(self.on_process, process_index=process_index)
+        if (self.process_index == process_index) or (not self.use_distributed):
+            return function
+        return do_nothing
+
+    def on_local_process(self, function: Callable[..., Any] = None, local_process_index: int = None):
+        """
+        Decorator that only runs the decorated function on the process with the given index on the current node.
+
+        Args:
+            function (`Callable`, *optional*):
+                The function to decorate.
+            local_process_index (`int`, *optional*):
+                The index of the local process on which to run the function.
+
+        Example:
+        ```python
+        # Assume we have 2 servers with 4 processes each.
+        from accelerate import Accelerator
+
+        accelerator = Accelerator()
+
+
+        @accelerator.on_local_process(local_process_index=2)
+        def print_something():
+            print(f"Printed on process {accelerator.local_process_index}")
+
+
+        print_something()
+        # On server 1:
+        "Printed on process 2"
+        # On server 2:
+        "Printed on process 2"
+        ```
+        """
+        if function is None:
+            return partial(self.on_local_process, local_process_index=local_process_index)
+        if (self.local_process_index == local_process_index) or (not self.use_distributed):
+            return function
+        return do_nothing
+
+    def print(self, *args, **kwargs):
+        if self.is_local_main_process:
+            print(*args, **kwargs)
+
+    @property
+    def default_device(self) -> torch.device:
+        """
+        Returns the default device which is:
+        - MPS if `torch.backends.mps.is_available()` and `torch.backends.mps.is_built()` both return True.
+        - CUDA if `torch.cuda.is_available()`
+        - MLU if `is_mlu_available()`
+        - NPU if `is_npu_available()`
+        - CPU otherwise
+        """
+        if is_mps_available():
+            os.environ["PYTORCH_ENABLE_MPS_FALLBACK"] = "1"
+            return torch.device("mps")
+        elif is_mlu_available():
+            return torch.device("mlu")
+        elif torch.cuda.is_available():
+            return torch.device("cuda")
+        elif is_xpu_available():
+            return torch.device("xpu:0")
+        elif is_npu_available():
+            return torch.device("npu")
+        else:
+            return torch.device("cpu")
+
+    def _prepare_backend(
+        self, cpu: bool = False, sagemaker_dp=False, backend: str = None
+    ) -> tuple[str, DistributedType]:
+        "Prepares any imports needed before initializing the distributed backend and sets `self.backend` properly"
+        distributed_type = None
+        if sagemaker_dp:
+            import smdistributed.dataparallel.torch.torch_smddp  # noqa
+
+            backend = "smddp"
+            distributed_type = DistributedType.MULTI_GPU
+        elif is_torch_xla_available():
+            backend = "xla"
+            distributed_type = DistributedType.XLA
+        elif int(os.environ.get("LOCAL_RANK", -1)) != -1 and not cpu:
+            if is_mlu_available():
+                backend = "cncl"
+                distributed_type = DistributedType.MULTI_MLU
+            elif torch.cuda.is_available():
+                if backend is None:
+                    backend = "nccl"
+                distributed_type = DistributedType.MULTI_GPU
+            elif is_npu_available():
+                backend = "hccl"
+                distributed_type = DistributedType.MULTI_NPU
+
+        if distributed_type is None and (
+            int(os.environ.get("LOCAL_RANK", -1)) != -1
+            or get_int_from_env(["PMI_SIZE", "OMPI_COMM_WORLD_SIZE", "MV2_COMM_WORLD_SIZE", "WORLD_SIZE"], 1) > 1
+        ):
+            if not cpu and is_xpu_available():
+                distributed_type = DistributedType.MULTI_XPU
+            else:
+                distributed_type = DistributedType.MULTI_CPU
+
+            if (
+                backend in (None, "ccl")
+                and is_ccl_available()
+                and (get_int_from_env(["CCL_WORKER_COUNT"], 0) > 0 or distributed_type == DistributedType.MULTI_XPU)
+            ):
+                if get_ccl_version() >= "1.12":
+                    import oneccl_bindings_for_pytorch  # noqa: F401
+                else:
+                    import torch_ccl  # noqa: F401
+
+                backend = "ccl"
+            elif backend in (None, "mpi") and torch.distributed.is_mpi_available():
+                backend = "mpi"
+            else:
+                backend = "gloo"
+        if distributed_type is None:
+            distributed_type = DistributedType.NO
+
+        return backend, distributed_type
+
+    def set_device(self):
+        """
+        Sets the device in `self.device` to the current distributed environment.
+        """
+        if self.device is not None:
+            return
+        if self.distributed_type == DistributedType.NO:
+            self.device = torch.device("cpu") if self._cpu else self.default_device
+            return
+        device = str(self.distributed_type).split(".")[-1].replace("MULTI_", "").lower()
+        if device not in ("cpu", "gpu", "mlu", "npu", "xpu", "xla"):
+            raise ValueError(
+                f"Can't set device for {self.distributed_type} ({device}), verify we should be calling `_set_device()` for it!"
+            )
+        if device == "xla":
+            self.device = xm.xla_device()
+        else:
+            if device == "gpu":
+                device = "cuda"
+            self.device = torch.device(device, self.local_process_index)
+        if self.device is not None:
+            if device == "xpu":
+                torch.xpu.set_device(self.device)
+            elif device == "mlu":
+                torch.mlu.set_device(self.device)
+            elif device == "npu":
+                torch.npu.set_device(self.device)
+            elif device == "cuda":
+                torch.cuda.set_device(self.device)
+
+    def __getattr__(self, name: str):
+        # By this point we know that no attributes of `self` contain `name`,
+        # so we just modify the error message
+        if name in self._known_attrs:
+            raise AttributeError(
+                f"`PartialState` object has no attribute `{name}`. "
+                "This happens if `PartialState._reset_state()` was called and "
+                "an `Accelerator` or `PartialState` was not reinitialized."
+            )
+        # Raise a typical AttributeError
+        raise AttributeError(f"'PartialState' object has no attribute '{name}'")
+
+
+class AcceleratorState:
+    """
+    Singleton class that has information about the current training environment.
+
+    **Available attributes:**
+
+        - **device** (`torch.device`) -- The device to use.
+        - **distributed_type** ([`~accelerate.state.DistributedType`]) -- The type of distributed environment currently
+          in use.
+        - **initialized** (`bool`) -- Whether or not the `AcceleratorState` has been initialized from `Accelerator`.
+        - **local_process_index** (`int`) -- The index of the current process on the current server.
+        - **mixed_precision** (`str`) -- Whether or not the current script will use mixed precision, and if so the type
+          of mixed precision being performed. (Choose from 'no','fp16','bf16 or 'fp8').
+        - **num_processes** (`int`) -- The number of processes currently launched in parallel.
+        - **process_index** (`int`) -- The index of the current process.
+        - **is_last_process** (`bool`) -- Whether or not the current process is the last one.
+        - **is_main_process** (`bool`) -- Whether or not the current process is the main one.
+        - **is_local_main_process** (`bool`) -- Whether or not the current process is the main one on the local node.
+        - **debug** (`bool`) -- Whether or not the current script is being run in debug mode.
+    """
+
+    _shared_state = SharedDict()
+    _known_attrs = PartialState._known_attrs + [
+        "deepspeed_plugin",
+        "use_ipex",
+        "fsdp_plugin",
+        "megatron_lm_plugin",
+        "dynamo_plugin",
+    ]
+
+    def __init__(
+        self,
+        mixed_precision: str = None,
+        cpu: bool = False,
+        dynamo_plugin=None,
+        deepspeed_plugin=None,
+        fsdp_plugin=None,
+        megatron_lm_plugin=None,
+        _from_accelerator: bool = False,
+        **kwargs,
+    ):
+        self.__dict__ = self._shared_state
+        if parse_flag_from_env("ACCELERATE_USE_CPU"):
+            cpu = True
+        if PartialState._shared_state == {}:
+            PartialState(cpu, **kwargs)
+        self.__dict__.update(PartialState._shared_state)
+        self._check_initialized(mixed_precision, cpu)
+        if not self.initialized:
+            self.deepspeed_plugin = None
+            self.use_ipex = None
+            mixed_precision = (
+                parse_choice_from_env("ACCELERATE_MIXED_PRECISION", "no")
+                if mixed_precision is None
+                else mixed_precision.lower()
+            )
+            if mixed_precision == "fp8":
+                if not is_fp8_available():
+                    raise ValueError(
+                        "Using `fp8` precision requires `transformer_engine` or `MS-AMP` to be installed."
+                    )
+                elif not check_fp8_capability():
+                    logger.warning(
+                        f"The current device has compute capability of {torch.cuda.get_device_capability()} which is "
+                        "insufficient for FP8 mixed precision training (requires a GPU Hopper/Ada Lovelace "
+                        "or higher, compute capability of 8.9 or higher). Will use FP16 instead."
+                    )
+                    mixed_precision = "fp16"
+
+            self.dynamo_plugin = dynamo_plugin
+            if not _from_accelerator:
+                raise ValueError(
+                    "Please make sure to properly initialize your accelerator via `accelerator = Accelerator()` "
+                    "before using any functionality from the `accelerate` library."
+                )
+            # deepspeed handles mixed_precision using deepspeed_config
+            self._mixed_precision = "no" if self.distributed_type == DistributedType.DEEPSPEED else mixed_precision
+            if self.distributed_type == DistributedType.XLA and is_torch_xla_available(check_is_tpu=True):
+                if mixed_precision == "bf16":
+                    if os.environ.get("ACCELERATE_DOWNCAST_BF16"):
+                        os.environ["XLA_USE_BF16"] = str(0)
+                        os.environ["XLA_DOWNCAST_BF16"] = str(1)
+                        self.downcast_bfloat = True
+                    else:
+                        os.environ["XLA_USE_BF16"] = str(1)
+                        os.environ["XLA_DOWNCAST_BF16"] = str(0)
+                        self.downcast_bfloat = False
+            elif os.environ.get("ACCELERATE_USE_DEEPSPEED", "false") == "true" and not cpu:
+                self.deepspeed_plugin = deepspeed_plugin
+            elif self.distributed_type in [
+                DistributedType.MULTI_GPU,
+                DistributedType.MULTI_MLU,
+                DistributedType.MULTI_NPU,
+                DistributedType.MULTI_XPU,
+            ]:
+                if os.environ.get("ACCELERATE_USE_FSDP", "false") == "true":
+                    self.distributed_type = DistributedType.FSDP
+                    if self._mixed_precision != "no":
+                        fsdp_plugin.set_mixed_precision(self._mixed_precision)
+                    self.fsdp_plugin = fsdp_plugin
+                if os.environ.get("ACCELERATE_USE_MEGATRON_LM", "false") == "true" and self.distributed_type not in [
+                    DistributedType.MULTI_NPU,
+                    DistributedType.MULTI_XPU,
+                ]:
+                    self.distributed_type = DistributedType.MEGATRON_LM
+                    megatron_lm_plugin.set_mixed_precision(self._mixed_precision)
+                    self.megatron_lm_plugin = megatron_lm_plugin
+            elif self.distributed_type in [DistributedType.MULTI_CPU, DistributedType.MULTI_XPU, DistributedType.NO]:
+                if is_ipex_available():
+                    # check if user disables it explicitly
+                    self.use_ipex = parse_flag_from_env("ACCELERATE_USE_IPEX", default=True)
+                else:
+                    self.use_ipex = False
+            if (
+                self.dynamo_plugin.backend != DynamoBackend.NO
+                and self._mixed_precision == "no"
+                and self.device.type == "cuda"
+            ):
+                torch.backends.cuda.matmul.allow_tf32 = True
+            PartialState._shared_state["distributed_type"] = self.distributed_type
+
+    @property
+    def initialized(self) -> bool:
+        return self._shared_state != PartialState._shared_state
+
+    def __repr__(self):
+        repr = PartialState().__repr__() + f"\nMixed precision type: {self.mixed_precision}\n"
+        if self.distributed_type == DistributedType.DEEPSPEED:
+            repr += f"ds_config: {self.deepspeed_plugin.deepspeed_config}\n"
+        return repr
+
+    def _check_initialized(self, mixed_precision=None, cpu=None):
+        "Checks if a modification is trying to be made and the `AcceleratorState` has already been initialized"
+        if self.initialized:
+            err = "AcceleratorState has already been initialized and cannot be changed, restart your runtime completely and pass `{flag}` to `Accelerator()`."
+            if cpu and self.device.type != "cpu":
+                raise ValueError(err.format(flag="cpu=True"))
+            if (
+                mixed_precision is not None
+                and mixed_precision != self._mixed_precision
+                and self.distributed_type != DistributedType.DEEPSPEED
+            ):
+                raise ValueError(err.format(flag=f"mixed_precision='{mixed_precision}'"))
+
+    # For backward compatibility
+    @property
+    def use_fp16(self):
+        warnings.warn(
+            "The `use_fp16` property is deprecated and will be removed in version 1.0 of Accelerate use "
+            "`AcceleratorState.mixed_precision == 'fp16'` instead.",
+            FutureWarning,
+        )
+        return self._mixed_precision != "no"
+
+    @property
+    def mixed_precision(self):
+        if self.distributed_type == DistributedType.DEEPSPEED:
+            config = self.deepspeed_plugin.deepspeed_config
+            if config.get("fp16", {}).get("enabled", False):
+                mixed_precision = "fp16"
+            elif config.get("bf16", {}).get("enabled", False):
+                mixed_precision = "bf16"
+            else:
+                mixed_precision = "no"
+        else:
+            mixed_precision = self._mixed_precision
+        return mixed_precision
+
+    @staticmethod
+    def _reset_state(reset_partial_state: bool = False):
+        "Resets `_shared_state`, is used internally and should not be called"
+        AcceleratorState._shared_state.clear()
+        if reset_partial_state:
+            PartialState._reset_state()
+
+    @property
+    def use_distributed(self):
+        """
+        Whether the Accelerator is configured for distributed training
+        """
+        return PartialState().use_distributed
+
+    @property
+    def is_last_process(self) -> bool:
+        "Returns whether the current process is the last one"
+        return PartialState().is_last_process
+
+    @property
+    def is_main_process(self) -> bool:
+        "Returns whether the current process is the main process"
+        return PartialState().is_main_process
+
+    @property
+    def is_local_main_process(self) -> bool:
+        "Returns whether the current process is the main process on the local node"
+        return PartialState().is_local_main_process
+
+    def wait_for_everyone(self):
+        PartialState().wait_for_everyone()
+
+    @contextmanager
+    def split_between_processes(self, inputs: list | tuple | dict | torch.Tensor, apply_padding: bool = False):
+        """
+        Splits `input` between `self.num_processes` quickly and can be then used on that process. Useful when doing
+        distributed inference, such as with different prompts.
+
+        Note that when using a `dict`, all keys need to have the same number of elements.
+
+        Args:
+            inputs (`list`, `tuple`, `torch.Tensor`, or `dict` of `list`/`tuple`/`torch.Tensor`):
+                The input to split between processes.
+            apply_padding (`bool`, `optional`, defaults to `False`):
+                Whether to apply padding by repeating the last element of the input so that all processes have the same
+                number of elements. Useful when trying to perform actions such as `gather()` on the outputs or passing
+                in less inputs than there are processes. If so, just remember to drop the padded elements afterwards.
+
+
+        Example:
+
+        ```python
+        # Assume there are two processes
+        from accelerate.state import AcceleratorState
+
+        state = AcceleratorState()
+        with state.split_between_processes(["A", "B", "C"]) as inputs:
+            print(inputs)
+        # Process 0
+        ["A", "B"]
+        # Process 1
+        ["C"]
+
+        with state.split_between_processes(["A", "B", "C"], apply_padding=True) as inputs:
+            print(inputs)
+        # Process 0
+        ["A", "B"]
+        # Process 1
+        ["C", "C"]
+        ```
+        """
+        with PartialState().split_between_processes(inputs, apply_padding=apply_padding) as inputs:
+            yield inputs
+
+    @contextmanager
+    def main_process_first(self):
+        """
+        Lets the main process go first inside a with block.
+
+        The other processes will enter the with block after the main process exits.
+        """
+        with PartialState().main_process_first():
+            yield
+
+    @contextmanager
+    def local_main_process_first(self):
+        """
+        Lets the local main process go inside a with block.
+
+        The other processes will enter the with block after the main process exits.
+        """
+        with PartialState().local_main_process_first():
+            yield
+
+    def print(self, *args, **kwargs):
+        PartialState().print(*args, **kwargs)
+
+    def __getattr__(self, name: str):
+        # By this point we know that no attributes of `self` contain `name`,
+        # so we just modify the error message
+        if name in self._known_attrs:
+            raise AttributeError(
+                f"`AcceleratorState` object has no attribute `{name}`. "
+                "This happens if `AcceleratorState._reset_state()` was called and "
+                "an `Accelerator` or `PartialState` was not reinitialized."
+            )
+        # Raise a typical AttributeError
+        raise AttributeError(f"'AcceleratorState' object has no attribute '{name}'")
+
+
+class GradientState:
+    """
+    Singleton class that has information related to gradient synchronization for gradient accumulation
+
+    **Available attributes:**
+
+        - **end_of_dataloader** (`bool`) -- Whether we have reached the end the current dataloader
+        - **remainder** (`int`) -- The number of extra samples that were added from padding the dataloader
+        - **sync_gradients** (`bool`) -- Whether the gradients should be synced across all devices
+        - **active_dataloader** (`Optional[DataLoader]`) -- The dataloader that is currently being iterated over
+        - **dataloader_references** (`List[Optional[DataLoader]]`) -- A list of references to the dataloaders that are
+            being iterated over
+        - **num_steps** (`int`) -- The number of steps to accumulate over
+        - **adjust_scheduler** (`bool`) -- Whether the scheduler should be adjusted to account for the gradient
+            accumulation
+        - **sync_with_dataloader** (`bool`) -- Whether the gradients should be synced at the end of the dataloader
+            iteration and the number of total steps reset
+        - **is_xla_gradients_synced** (`bool`) -- Whether the XLA gradients have been synchronized. It is initialized
+          as false. Once gradients have been reduced before the optimizer step, this flag is set to true. Subsequently,
+            after each step, the flag is reset to false. FSDP will always synchronize the gradients, hence
+            is_xla_gradients_synced is always true.
+    """
+
+    _shared_state = SharedDict()
+
+    def __init__(self, gradient_accumulation_plugin: Optional[GradientAccumulationPlugin] = None):
+        self.__dict__ = self._shared_state
+        if not self.initialized:
+            self.sync_gradients = True
+            self.active_dataloader = None
+            self.dataloader_references = [None]
+            self.plugin_kwargs = (
+                gradient_accumulation_plugin.to_kwargs() if gradient_accumulation_plugin is not None else {}
+            )
+            self._is_xla_gradients_synced = False
+
+        # Plugin args are different and can be updated
+        if gradient_accumulation_plugin is not None and self.plugin_kwargs != gradient_accumulation_plugin.to_kwargs():
+            self.plugin_kwargs = gradient_accumulation_plugin.to_kwargs()
+
+    @property
+    def num_steps(self) -> int:
+        "Returns the number of steps to accumulate over"
+        return self.plugin_kwargs.get("num_steps", 1)
+
+    @property
+    def adjust_scheduler(self) -> bool:
+        "Returns whether the scheduler should be adjusted"
+        return self.plugin_kwargs.get("adjust_scheduler", False)
+
+    @property
+    def sync_with_dataloader(self) -> bool:
+        "Returns whether the gradients should be synced at the end of the dataloader iteration and the number of total steps reset"
+        return self.plugin_kwargs.get("sync_with_dataloader", True)
+
+    @property
+    def initialized(self) -> bool:
+        "Returns whether the `GradientState` has been initialized"
+        return GradientState._shared_state != {}
+
+    @property
+    def end_of_dataloader(self) -> bool:
+        "Returns whether we have reached the end of the current dataloader"
+        if not self.in_dataloader:
+            return False
+        return self.active_dataloader.end_of_dataloader
+
+    @property
+    def remainder(self) -> int:
+        "Returns the number of extra samples that were added from padding the dataloader"
+        if not self.in_dataloader:
+            return -1
+        return self.active_dataloader.remainder
+
+    def __repr__(self):
+        return (
+            f"Sync Gradients: {self.sync_gradients}\n"
+            f"At end of current dataloader: {self.end_of_dataloader}\n"
+            f"Extra samples added: {self.remainder}\n"
+            f"Gradient accumulation plugin: {self.plugin_kwargs}\n"
+        )
+
+    @property
+    def is_xla_gradients_synced(self):
+        "Returns the value of is_xla_gradients_synced. FSDP will always synchronize the gradients, hence is_xla_gradients_synced is always true."
+        if parse_flag_from_env("ACCELERATE_USE_FSDP", default=False):
+            return True
+        return self._is_xla_gradients_synced
+
+    @is_xla_gradients_synced.setter
+    def is_xla_gradients_synced(self, is_synced):
+        "Set the _is_xla_gradients_synced attribute."
+        self._is_xla_gradients_synced = is_synced
+
+    def _set_sync_gradients(self, sync_gradients):
+        "Private function that sets whether gradients should be synchronized. Users should not have to call this."
+        self.sync_gradients = sync_gradients
+        # Allow grad-sync to automatically work on TPUs
+        if (
+            self.sync_gradients
+            and is_torch_xla_available(check_is_tpu=True)
+            and PartialState().distributed_type == DistributedType.XLA
+        ):
+            xm.mark_step()
+
+    def _add_dataloader(self, dataloader):
+        "Private function that adds a dataloader to `self.dataloader_references` and sets `in_dataloader` to `True`. Users should not have to call this."
+        self.active_dataloader = dataloader
+        self.dataloader_references.append(self.active_dataloader)
+
+    def _remove_dataloader(self, dataloader):
+        "Private function that removes a dataloader from `self.dataloader_references` and sets `in_dataloader` to `False` if there are no more dataloaders. Users should not have to call this."
+        self.dataloader_references.remove(dataloader)
+        self.active_dataloader = self.dataloader_references[-1]
+
+    @property
+    def in_dataloader(self) -> bool:
+        "Returns whether the current process is in a dataloader"
+        return self.active_dataloader is not None
+
+    @staticmethod
+    def _reset_state():
+        "Resets `_shared_state`, is used internally and should not be called"
+        GradientState._shared_state.clear()
diff --git a/llm/Lib/site-packages/accelerate/test_utils/__init__.py b/llm/Lib/site-packages/accelerate/test_utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd5f6f15da98737459dcf7ab05b68e87be9a384d
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/__init__.py
@@ -0,0 +1,50 @@
+# Copyright 2020 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from .testing import (
+    DEFAULT_LAUNCH_COMMAND,
+    are_the_same_tensors,
+    assert_exception,
+    device_count,
+    execute_subprocess_async,
+    get_launch_command,
+    memory_allocated_func,
+    path_in_accelerate_package,
+    require_bnb,
+    require_cpu,
+    require_cuda,
+    require_huggingface_suite,
+    require_mlu,
+    require_mps,
+    require_multi_device,
+    require_multi_gpu,
+    require_multi_xpu,
+    require_non_cpu,
+    require_non_torch_xla,
+    require_non_xpu,
+    require_npu,
+    require_pippy,
+    require_single_device,
+    require_single_gpu,
+    require_single_xpu,
+    require_torch_min_version,
+    require_tpu,
+    require_xpu,
+    skip,
+    slow,
+    torch_device,
+)
+from .training import RegressionDataset, RegressionModel, RegressionModel4XPU
+
+
+from .scripts import test_script, test_sync, test_ops  # isort: skip
diff --git a/llm/Lib/site-packages/accelerate/test_utils/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a0e1e14943b988a4819407f6ef4947768741f941
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/__pycache__/examples.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/__pycache__/examples.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9983a43a90a39d61df78f8dd7a22bea880a3c95e
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/__pycache__/examples.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/__pycache__/testing.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/__pycache__/testing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..84480f78f294000c7132cee947d6b8dd895b138e
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/__pycache__/testing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/__pycache__/training.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/__pycache__/training.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c3137e8ac599bc210c1c19a32d7de1c6460c9904
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/__pycache__/training.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/examples.py b/llm/Lib/site-packages/accelerate/test_utils/examples.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed41d38c9092385ba9730472aa10b5208f48c67b
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/examples.py
@@ -0,0 +1,146 @@
+#!/usr/bin/env python
+
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""
+A collection of utilities for comparing `examples/complete_*_example.py` scripts with the capabilities inside of each
+`examples/by_feature` example. `compare_against_test` is the main function that should be used when testing, while the
+others are used to either get the code that matters, or to preprocess them (such as stripping comments)
+"""
+
+import os
+from typing import List
+
+
+def get_function_contents_by_name(lines: List[str], name: str):
+    """
+    Extracts a function from `lines` of segmented source code with the name `name`.
+
+    Args:
+        lines (`List[str]`):
+            Source code of a script seperated by line.
+        name (`str`):
+            The name of the function to extract. Should be either `training_function` or `main`
+    """
+    if name != "training_function" and name != "main":
+        raise ValueError(f"Incorrect function name passed: {name}, choose either 'main' or 'training_function'")
+    good_lines, found_start = [], False
+    for line in lines:
+        if not found_start and f"def {name}" in line:
+            found_start = True
+            good_lines.append(line)
+            continue
+        if found_start:
+            if name == "training_function" and "def main" in line:
+                return good_lines
+            if name == "main" and "if __name__" in line:
+                return good_lines
+            good_lines.append(line)
+
+
+def clean_lines(lines: List[str]):
+    """
+    Filters `lines` and removes any entries that start with a comment ('#') or is just a newline ('\n')
+
+    Args:
+        lines (`List[str]`):
+            Source code of a script seperated by line.
+    """
+    return [line for line in lines if not line.lstrip().startswith("#") and line != "\n"]
+
+
+def compare_against_test(base_filename: str, feature_filename: str, parser_only: bool, secondary_filename: str = None):
+    """
+    Tests whether the additional code inside of `feature_filename` was implemented in `base_filename`. This should be
+    used when testing to see if `complete_*_.py` examples have all of the implementations from each of the
+    `examples/by_feature/*` scripts.
+
+    It utilizes `nlp_example.py` to extract out all of the repeated training code, so that only the new additional code
+    is examined and checked. If something *other* than `nlp_example.py` should be used, such as `cv_example.py` for the
+    `complete_cv_example.py` script, it should be passed in for the `secondary_filename` parameter.
+
+    Args:
+        base_filename (`str` or `os.PathLike`):
+            The filepath of a single "complete" example script to test, such as `examples/complete_cv_example.py`
+        feature_filename (`str` or `os.PathLike`):
+            The filepath of a single feature example script. The contents of this script are checked to see if they
+            exist in `base_filename`
+        parser_only (`bool`):
+            Whether to compare only the `main()` sections in both files, or to compare the contents of
+            `training_loop()`
+        secondary_filename (`str`, *optional*):
+            A potential secondary filepath that should be included in the check. This function extracts the base
+            functionalities off of "examples/nlp_example.py", so if `base_filename` is a script other than
+            `complete_nlp_example.py`, the template script should be included here. Such as `examples/cv_example.py`
+    """
+    with open(base_filename) as f:
+        base_file_contents = f.readlines()
+    with open(os.path.abspath(os.path.join("examples", "nlp_example.py"))) as f:
+        full_file_contents = f.readlines()
+    with open(feature_filename) as f:
+        feature_file_contents = f.readlines()
+    if secondary_filename is not None:
+        with open(secondary_filename) as f:
+            secondary_file_contents = f.readlines()
+
+    # This is our base, we remove all the code from here in our `full_filename` and `feature_filename` to find the new content
+    if parser_only:
+        base_file_func = clean_lines(get_function_contents_by_name(base_file_contents, "main"))
+        full_file_func = clean_lines(get_function_contents_by_name(full_file_contents, "main"))
+        feature_file_func = clean_lines(get_function_contents_by_name(feature_file_contents, "main"))
+        if secondary_filename is not None:
+            secondary_file_func = clean_lines(get_function_contents_by_name(secondary_file_contents, "main"))
+    else:
+        base_file_func = clean_lines(get_function_contents_by_name(base_file_contents, "training_function"))
+        full_file_func = clean_lines(get_function_contents_by_name(full_file_contents, "training_function"))
+        feature_file_func = clean_lines(get_function_contents_by_name(feature_file_contents, "training_function"))
+        if secondary_filename is not None:
+            secondary_file_func = clean_lines(
+                get_function_contents_by_name(secondary_file_contents, "training_function")
+            )
+
+    _dl_line = "train_dataloader, eval_dataloader = get_dataloaders(accelerator, batch_size)\n"
+
+    # Specific code in our script that differs from the full version, aka what is new
+    new_feature_code = []
+    passed_idxs = []  # We keep track of the idxs just in case it's a repeated statement
+    it = iter(feature_file_func)
+    for i in range(len(feature_file_func) - 1):
+        if i not in passed_idxs:
+            line = next(it)
+            if (line not in full_file_func) and (line.lstrip() != _dl_line):
+                if "TESTING_MOCKED_DATALOADERS" not in line:
+                    new_feature_code.append(line)
+                    passed_idxs.append(i)
+                else:
+                    # Skip over the `config['num_epochs'] = 2` statement
+                    _ = next(it)
+
+    # Extract out just the new parts from the full_file_training_func
+    new_full_example_parts = []
+    passed_idxs = []  # We keep track of the idxs just in case it's a repeated statement
+    for i, line in enumerate(base_file_func):
+        if i not in passed_idxs:
+            if (line not in full_file_func) and (line.lstrip() != _dl_line):
+                if "TESTING_MOCKED_DATALOADERS" not in line:
+                    new_full_example_parts.append(line)
+                    passed_idxs.append(i)
+
+    # Finally, get the overall diff
+    diff_from_example = [line for line in new_feature_code if line not in new_full_example_parts]
+    if secondary_filename is not None:
+        diff_from_two = [line for line in full_file_contents if line not in secondary_file_func]
+        diff_from_example = [line for line in diff_from_example if line not in diff_from_two]
+
+    return diff_from_example
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/__init__.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c9cbe26c257b515f657c05e1996d517e69613972
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2020 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b61705e7d38d33b6cc3fee11e3c9fe14e3c8ff89
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_cli.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_cli.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a02ca8f675bd710aada57f4adab157b92228be30
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_cli.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_distributed_data_loop.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_distributed_data_loop.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..88d885f1635f58316d1f74dad4e9abd2b524e8f1
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_distributed_data_loop.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_notebook.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_notebook.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..33c817fb715be1f5f730467ac829b191ae6eebf3
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_notebook.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_ops.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_ops.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..990ebb9bad41480954d302c4aab98fd6f6354497
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_ops.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_script.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_script.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c63382264579021430bb6cba4b5326b6cc8ec403
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_script.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_sync.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_sync.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..09e2e317c500aea3f4fc0d288eecbd3a062ff53d
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/__pycache__/test_sync.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__init__.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c9cbe26c257b515f657c05e1996d517e69613972
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2020 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2b21d5e7635e07ce514e940382363fc86b7b8e94
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_checkpointing.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_checkpointing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d924cc4dd933a4cb069ae49c535b3fb7d832b5d7
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_checkpointing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_metrics.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_metrics.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2d860e38e7eef6552506acf57f0228cb2fd9e062
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_metrics.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_peak_memory_usage.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_peak_memory_usage.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..28e83f19b1cca2db813acf9b30d7acaa4bab4c4a
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_peak_memory_usage.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_performance.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_performance.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4e7c701c0fb318f23db970c4c45df4fecaea53e3
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_performance.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_pippy.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_pippy.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2e97efad21eb8e892553f32b182df6f5ec00f708
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_pippy.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_zero3_integration.cpython-311.pyc b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_zero3_integration.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f6c1eb163c1f5a615169eac5285f809a2e2f31a7
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/__pycache__/test_zero3_integration.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_checkpointing.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_checkpointing.py
new file mode 100644
index 0000000000000000000000000000000000000000..41c77c7ec5e6e2475a795efdb54702600eac0282
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_checkpointing.py
@@ -0,0 +1,268 @@
+# Copyright 2022 The HuggingFace Inc. team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import argparse
+import json
+import os
+
+import evaluate
+import torch
+from datasets import load_dataset
+from torch.optim import AdamW
+from torch.utils.data import DataLoader
+from transformers import AutoModelForSequenceClassification, AutoTokenizer, get_linear_schedule_with_warmup, set_seed
+
+from accelerate import Accelerator, DistributedType
+from accelerate.utils.deepspeed import DummyOptim, DummyScheduler
+
+
+MAX_GPU_BATCH_SIZE = 16
+EVAL_BATCH_SIZE = 32
+
+
+def get_dataloaders(accelerator: Accelerator, batch_size: int = 16, model_name: str = "bert-base-cased"):
+    """
+    Creates a set of `DataLoader`s for the `glue` dataset.
+
+    Args:
+        accelerator (`Accelerator`):
+            An `Accelerator` object
+        batch_size (`int`, *optional*):
+            The batch size for the train and validation DataLoaders.
+        model_name (`str`, *optional*):
+    """
+    tokenizer = AutoTokenizer.from_pretrained(model_name)
+    datasets = load_dataset("glue", "mrpc")
+
+    def tokenize_function(examples):
+        # max_length=None => use the model max length (it's actually the default)
+        outputs = tokenizer(examples["sentence1"], examples["sentence2"], truncation=True, max_length=None)
+        return outputs
+
+    # Apply the method we just defined to all the examples in all the splits of the dataset
+    tokenized_datasets = datasets.map(
+        tokenize_function, batched=True, remove_columns=["idx", "sentence1", "sentence2"], load_from_cache_file=False
+    )
+
+    # We also rename the 'label' column to 'labels' which is the expected name for labels by the models of the
+    # transformers library
+    tokenized_datasets = tokenized_datasets.rename_column("label", "labels")
+
+    def collate_fn(examples):
+        # On TPU it's best to pad everything to the same length or training will be very slow.
+        if accelerator.distributed_type == DistributedType.XLA:
+            return tokenizer.pad(examples, padding="max_length", max_length=128, return_tensors="pt")
+        return tokenizer.pad(examples, padding="longest", return_tensors="pt")
+
+    # Instantiate dataloaders.
+    train_dataloader = DataLoader(
+        tokenized_datasets["train"], shuffle=True, collate_fn=collate_fn, batch_size=batch_size
+    )
+    eval_dataloader = DataLoader(
+        tokenized_datasets["validation"], shuffle=False, collate_fn=collate_fn, batch_size=EVAL_BATCH_SIZE
+    )
+
+    return train_dataloader, eval_dataloader
+
+
+def evaluation_loop(accelerator, model, eval_dataloader, metric):
+    model.eval()
+    samples_seen = 0
+    for step, batch in enumerate(eval_dataloader):
+        # We could avoid this line since we set the accelerator with `device_placement=True`.
+        batch.to(accelerator.device)
+        with torch.no_grad():
+            outputs = model(**batch)
+        predictions = outputs.logits.argmax(dim=-1)
+        # It is slightly faster to call this once, than multiple times
+        predictions, references = accelerator.gather(
+            (predictions, batch["labels"])
+        )  # If we are in a multiprocess environment, the last batch has duplicates
+        if accelerator.use_distributed:
+            if step == len(eval_dataloader) - 1:
+                predictions = predictions[: len(eval_dataloader.dataset) - samples_seen]
+                references = references[: len(eval_dataloader.dataset) - samples_seen]
+            else:
+                samples_seen += references.shape[0]
+        metric.add_batch(
+            predictions=predictions,
+            references=references,
+        )
+
+    eval_metric = metric.compute()
+    return eval_metric["accuracy"]
+
+
+def training_function(config, args):
+    # Initialize accelerator
+    accelerator = Accelerator()
+
+    # Sample hyper-parameters for learning rate, batch size, seed and a few other HPs
+    lr = config["lr"]
+    num_epochs = int(config["num_epochs"])
+    seed = int(config["seed"])
+    batch_size = int(config["batch_size"])
+    model_name = args.model_name_or_path
+
+    set_seed(seed)
+    train_dataloader, eval_dataloader = get_dataloaders(accelerator, batch_size, model_name)
+
+    # Instantiate the model (we build the model here so that the seed also control new weights initialization)
+    model = AutoModelForSequenceClassification.from_pretrained(model_name, return_dict=True)
+
+    # Instantiate optimizer
+    optimizer_cls = (
+        AdamW
+        if accelerator.state.deepspeed_plugin is None
+        or "optimizer" not in accelerator.state.deepspeed_plugin.deepspeed_config
+        else DummyOptim
+    )
+    optimizer = optimizer_cls(params=model.parameters(), lr=lr)
+
+    if accelerator.state.deepspeed_plugin is not None:
+        gradient_accumulation_steps = accelerator.state.deepspeed_plugin.deepspeed_config[
+            "gradient_accumulation_steps"
+        ]
+    else:
+        gradient_accumulation_steps = 1
+    max_training_steps = (len(train_dataloader) * num_epochs) // gradient_accumulation_steps
+
+    # Instantiate scheduler
+    if (
+        accelerator.state.deepspeed_plugin is None
+        or "scheduler" not in accelerator.state.deepspeed_plugin.deepspeed_config
+    ):
+        lr_scheduler = get_linear_schedule_with_warmup(
+            optimizer=optimizer,
+            num_warmup_steps=0,
+            num_training_steps=max_training_steps,
+        )
+    else:
+        lr_scheduler = DummyScheduler(optimizer, total_num_steps=max_training_steps, warmup_num_steps=0)
+
+    # Prepare everything
+    # There is no specific order to remember, we just need to unpack the objects in the same order we gave them to the
+    # prepare method.
+    model, optimizer, train_dataloader, eval_dataloader, lr_scheduler = accelerator.prepare(
+        model, optimizer, train_dataloader, eval_dataloader, lr_scheduler
+    )
+
+    # We need to keep track of how many total steps we have iterated over
+    overall_step = 0
+    # We also need to keep track of the stating epoch so files are named properly
+    starting_epoch = 0
+    metric = evaluate.load("glue", "mrpc")
+    ending_epoch = num_epochs
+
+    if args.partial_train_epoch is not None:
+        ending_epoch = args.partial_train_epoch
+
+    if args.resume_from_checkpoint:
+        accelerator.load_state(args.resume_from_checkpoint)
+        epoch_string = args.resume_from_checkpoint.split("epoch_")[1]
+        state_epoch_num = ""
+        for char in epoch_string:
+            if char.isdigit():
+                state_epoch_num += char
+            else:
+                break
+        starting_epoch = int(state_epoch_num) + 1
+        accuracy = evaluation_loop(accelerator, model, eval_dataloader, metric)
+        accelerator.print("resumed checkpoint performance:", accuracy)
+        accelerator.print("resumed checkpoint's scheduler's lr:", lr_scheduler.get_lr()[0])
+        accelerator.print("resumed optimizers's lr:", optimizer.param_groups[0]["lr"])
+        with open(os.path.join(args.output_dir, f"state_{starting_epoch - 1}.json")) as f:
+            resumed_state = json.load(f)
+            assert resumed_state["accuracy"] == accuracy, "Accuracy mismatch, loading from checkpoint failed"
+            assert (
+                resumed_state["lr"] == lr_scheduler.get_lr()[0]
+            ), "Scheduler learning rate mismatch, loading from checkpoint failed"
+            assert (
+                resumed_state["optimizer_lr"] == optimizer.param_groups[0]["lr"]
+            ), "Optimizer learning rate mismatch, loading from checkpoint failed"
+            assert resumed_state["epoch"] == starting_epoch - 1, "Epoch mismatch, loading from checkpoint failed"
+            return
+
+    # Now we train the model
+    state = {}
+    for epoch in range(starting_epoch, ending_epoch):
+        model.train()
+        for step, batch in enumerate(train_dataloader):
+            outputs = model(**batch)
+            loss = outputs.loss
+            loss = loss / gradient_accumulation_steps
+            accelerator.backward(loss)
+            if step % gradient_accumulation_steps == 0:
+                optimizer.step()
+                lr_scheduler.step()
+                optimizer.zero_grad()
+
+            overall_step += 1
+        output_dir = f"epoch_{epoch}"
+        output_dir = os.path.join(args.output_dir, output_dir)
+        accelerator.save_state(output_dir)
+        accuracy = evaluation_loop(accelerator, model, eval_dataloader, metric)
+        state["accuracy"] = accuracy
+        state["lr"] = lr_scheduler.get_lr()[0]
+        state["optimizer_lr"] = optimizer.param_groups[0]["lr"]
+        state["epoch"] = epoch
+        state["step"] = overall_step
+        accelerator.print(f"epoch {epoch}:", state)
+
+        accelerator.wait_for_everyone()
+        if accelerator.is_main_process:
+            with open(os.path.join(args.output_dir, f"state_{epoch}.json"), "w") as f:
+                json.dump(state, f)
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Simple example of training script tracking peak GPU memory usage.")
+    parser.add_argument(
+        "--model_name_or_path",
+        type=str,
+        default="bert-base-cased",
+        help="Path to pretrained model or model identifier from huggingface.co/models.",
+        required=False,
+    )
+    parser.add_argument(
+        "--output_dir",
+        type=str,
+        default=".",
+        help="Optional save directory where all checkpoint folders will be stored. Default is the current working directory.",
+    )
+    parser.add_argument(
+        "--resume_from_checkpoint",
+        type=str,
+        default=None,
+        help="If the training should continue from a checkpoint folder.",
+    )
+    parser.add_argument(
+        "--partial_train_epoch",
+        type=int,
+        default=None,
+        help="If passed, the training will stop after this number of epochs.",
+    )
+    parser.add_argument(
+        "--num_epochs",
+        type=int,
+        default=2,
+        help="Number of train epochs.",
+    )
+    args = parser.parse_args()
+    config = {"lr": 2e-5, "num_epochs": args.num_epochs, "seed": 42, "batch_size": 16}
+
+    training_function(config, args)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_metrics.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_metrics.py
new file mode 100644
index 0000000000000000000000000000000000000000..9ac13aba6266f31f1e0f9eb41b961fc2933d00ab
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_metrics.py
@@ -0,0 +1,306 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import math
+import os
+from copy import deepcopy
+
+import datasets
+import evaluate
+import torch
+import transformers
+from datasets import load_dataset
+from torch.utils.data import DataLoader, IterableDataset
+from transformers import AutoModelForSequenceClassification, AutoTokenizer
+
+from accelerate import Accelerator, DataLoaderConfiguration, DistributedType
+from accelerate.data_loader import DataLoaderDispatcher
+from accelerate.test_utils import RegressionDataset, RegressionModel, torch_device
+from accelerate.utils import is_torch_xla_available, set_seed
+
+
+os.environ["TRANSFORMERS_NO_ADVISORY_WARNINGS"] = "true"
+
+
+class ListHandler(logging.Handler):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.logs = []
+
+    def emit(self, record):
+        self.logs.append(record)
+
+
+def get_basic_setup(accelerator, num_samples=82, batch_size=16):
+    "Returns everything needed to perform basic training"
+    set_seed(42)
+    model = RegressionModel()
+    ddp_model = deepcopy(model)
+    dset = RegressionDataset(length=num_samples)
+    dataloader = DataLoader(dset, batch_size=batch_size)
+    model.to(accelerator.device)
+    ddp_model, dataloader = accelerator.prepare(ddp_model, dataloader)
+    return model, ddp_model, dataloader
+
+
+def get_dataloader(accelerator: Accelerator, use_longest=False):
+    tokenizer = AutoTokenizer.from_pretrained("hf-internal-testing/mrpc-bert-base-cased")
+    dataset = load_dataset("glue", "mrpc", split="validation")
+
+    def tokenize_function(examples):
+        outputs = tokenizer(examples["sentence1"], examples["sentence2"], truncation=True, max_length=None)
+        return outputs
+
+    with accelerator.main_process_first():
+        tokenized_datasets = dataset.map(
+            tokenize_function,
+            batched=True,
+            remove_columns=["idx", "sentence1", "sentence2"],
+        )
+
+    tokenized_datasets = tokenized_datasets.rename_column("label", "labels")
+
+    def collate_fn(examples):
+        if use_longest:
+            return tokenizer.pad(examples, padding="longest", return_tensors="pt")
+        return tokenizer.pad(examples, padding="max_length", max_length=128, return_tensors="pt")
+
+    return DataLoader(tokenized_datasets, shuffle=False, collate_fn=collate_fn, batch_size=16)
+
+
+def get_mrpc_setup(dispatch_batches, split_batches):
+    dataloader_config = DataLoaderConfiguration(dispatch_batches=dispatch_batches, split_batches=split_batches)
+    accelerator = Accelerator(dataloader_config=dataloader_config)
+    dataloader = get_dataloader(accelerator, not dispatch_batches)
+    model = AutoModelForSequenceClassification.from_pretrained(
+        "hf-internal-testing/mrpc-bert-base-cased", return_dict=True
+    )
+    ddp_model, ddp_dataloader = accelerator.prepare(model, dataloader)
+    return {
+        "ddp": [ddp_model, ddp_dataloader, torch_device],
+        "no": [model, dataloader, accelerator.device],
+    }, accelerator
+
+
+def generate_predictions(model, dataloader, accelerator):
+    logits_and_targets = []
+    for batch in dataloader:
+        input, target = batch.values()
+        with torch.no_grad():
+            logit = model(input)
+            logit, target = accelerator.gather_for_metrics((logit, target))
+            logits_and_targets.append((logit, target))
+    logits, targs = [], []
+    for logit, targ in logits_and_targets:
+        logits.append(logit)
+        targs.append(targ)
+    logits, targs = torch.cat(logits), torch.cat(targs)
+    return logits, targs
+
+
+def test_torch_metrics(
+    accelerator: Accelerator, num_samples=82, dispatch_batches=False, split_batches=False, batch_size=16
+):
+    _, ddp_model, dataloader = get_basic_setup(accelerator, num_samples, batch_size)
+    logits, _ = generate_predictions(ddp_model, dataloader, accelerator)
+    assert (
+        len(logits) == num_samples
+    ), f"Unexpected number of inputs:\n    Expected: {num_samples}\n    Actual: {len(logits)}"
+
+
+def test_mrpc(dispatch_batches: bool = False, split_batches: bool = False):
+    metric = evaluate.load("glue", "mrpc")
+    setup, accelerator = get_mrpc_setup(dispatch_batches, split_batches)
+    # First do baseline
+    model, dataloader, device = setup["no"]
+    model.to(device)
+    model.eval()
+    for batch in dataloader:
+        batch.to(device)
+        with torch.inference_mode():
+            outputs = model(**batch)
+        preds = outputs.logits.argmax(dim=-1)
+        metric.add_batch(predictions=preds, references=batch["labels"])
+    baseline = metric.compute()
+
+    # Then do distributed
+    model, dataloader, device = setup["ddp"]
+    model.eval()
+    for batch in dataloader:
+        with torch.inference_mode():
+            outputs = model(**batch)
+        preds = outputs.logits.argmax(dim=-1)
+        references = batch["labels"]
+        preds, references = accelerator.gather_for_metrics((preds, references))
+        metric.add_batch(predictions=preds, references=references)
+    distributed = metric.compute()
+
+    for key in "accuracy f1".split():
+        assert math.isclose(
+            baseline[key], distributed[key]
+        ), f"Baseline and Distributed are not the same for key {key}:\n\tBaseline: {baseline[key]}\n\tDistributed: {distributed[key]}\n"
+
+
+def test_gather_for_metrics_with_non_tensor_objects_iterable_dataset():
+    class DummyIterableDataset(IterableDataset):
+        def __init__(self, data):
+            self.data = data
+
+        def __len__(self):
+            return len(self.data)
+
+        def __iter__(self):
+            yield from self.data
+
+    iterable_dataset = DummyIterableDataset([n for n in range(30)])
+    dataloader = DataLoader(iterable_dataset, batch_size=4)
+    accelerator = Accelerator()
+    prepared_dataloader = accelerator.prepare(dataloader)
+
+    if accelerator.is_main_process:
+        logger = logging.root.manager.loggerDict["accelerate.accelerator"]
+        list_handler = ListHandler()
+        logger.addHandler(list_handler)
+
+    batches_for_metrics = []
+    for batch in prepared_dataloader:
+        batches_for_metrics.append(accelerator.gather_for_metrics(batch))
+
+    assert torch.cat(batches_for_metrics).size(0) == 30
+
+    if accelerator.is_main_process:
+        assert len(list_handler.logs) == 0
+        logger.removeHandler(list_handler)
+
+
+def test_gather_for_metrics_with_iterable_dataset():
+    class DummyIterableDataset(IterableDataset):
+        def __init__(self, data):
+            self.data = data
+
+        def __len__(self):
+            return len(self.data)
+
+        def __iter__(self):
+            yield from self.data
+
+    iterable_dataset = DummyIterableDataset(torch.as_tensor(range(30)))
+    dataloader = DataLoader(iterable_dataset, batch_size=4)
+
+    accelerator = Accelerator()
+    prepared_dataloader = accelerator.prepare(dataloader)
+
+    assert isinstance(prepared_dataloader, DataLoaderDispatcher)
+
+    if accelerator.is_main_process:
+        logger = logging.root.manager.loggerDict["accelerate.accelerator"]
+        list_handler = ListHandler()
+        logger.addHandler(list_handler)
+
+    batches_for_metrics = []
+    for batch in prepared_dataloader:
+        batches_for_metrics.append(accelerator.gather_for_metrics(batch))
+
+    assert torch.cat(batches_for_metrics).size(0) == 30
+
+    if accelerator.is_main_process:
+        assert len(list_handler.logs) == 0
+
+        logger.removeHandler(list_handler)
+
+
+def test_gather_for_metrics_drop_last():
+    accelerator = Accelerator()
+    per_device_batch_size = 5
+    num_items = (10 * accelerator.num_processes) + 1
+    dataloader = DataLoader(range(num_items), batch_size=per_device_batch_size, drop_last=True)
+    dataloader = accelerator.prepare(dataloader)
+
+    iterator = iter(dataloader)
+    next(iterator)  # Skip first batch tensor([0, 1, 2, 3, 4], device='cuda:0')
+    batch = next(iterator)
+    gathered_items = accelerator.gather_for_metrics(batch)
+
+    # Should return a full set of complete batches from each GPU
+    num_expected_items = per_device_batch_size * accelerator.num_processes
+    assert gathered_items.size(0) == (
+        num_expected_items
+    ), f"Expected number of items: {num_expected_items}, Actual: {gathered_items.size(0)}"
+
+
+def main():
+    dataloader_config = DataLoaderConfiguration(split_batches=False, dispatch_batches=False)
+    accelerator = Accelerator(dataloader_config=dataloader_config)
+    if accelerator.is_local_main_process:
+        datasets.utils.logging.set_verbosity_warning()
+        transformers.utils.logging.set_verbosity_warning()
+    else:
+        datasets.utils.logging.set_verbosity_error()
+        transformers.utils.logging.set_verbosity_error()
+    # TorchXLA does not support batch dispatching. 'put_on_device' is always False for
+    # TorchXLA, which can cause a value error in 'prepare_data_loader' function.
+    dispatch_batches_options = [False] if accelerator.state.distributed_type == DistributedType.XLA else [True, False]
+
+    # Temporarily close this test for TorchXLA due to the 'Cannot set version_counter for
+    # inference tensor' error in inference mode. Reopen it after TorchXLA fixes this bug.
+    # These are a bit slower so they should only be ran on the GPU or TPU
+    if accelerator.device.type != "cpu" and not is_torch_xla_available():
+        if accelerator.is_local_main_process:
+            print("**Testing gather_for_metrics**")
+        for split_batches in [True, False]:
+            for dispatch_batches in dispatch_batches_options:
+                if accelerator.is_local_main_process:
+                    print(f"With: `split_batches={split_batches}`, `dispatch_batches={dispatch_batches}`")
+                test_mrpc(dispatch_batches, split_batches)
+                accelerator.state._reset_state()
+        print("test_gather_for_metrics_with_iterable_dataset")
+        test_gather_for_metrics_with_iterable_dataset()
+        print("test gather_for_metrics_with_non_tensor_objects_iterable_dataset")
+        test_gather_for_metrics_with_non_tensor_objects_iterable_dataset()
+
+    # MpDeviceLoader in TorchXLA is an asynchronous loader that preloads several batches into cache.
+    # This can cause the 'end_of_dataloader' of DataLoaderStateMixin to be set earlier than intended.
+    # Skip this test when TorchXLA is enabled.
+    if accelerator.state.distributed_type != DistributedType.XLA:
+        if accelerator.is_local_main_process:
+            print("**Test torch metrics**")
+        for split_batches in [True, False]:
+            for dispatch_batches in dispatch_batches_options:
+                dataloader_config = DataLoaderConfiguration(
+                    split_batches=split_batches, dispatch_batches=dispatch_batches
+                )
+                accelerator = Accelerator(dataloader_config=dataloader_config)
+                if accelerator.is_local_main_process:
+                    print(f"With: `split_batches={split_batches}`, `dispatch_batches={dispatch_batches}`, length=99")
+                test_torch_metrics(accelerator, 99)
+                accelerator.state._reset_state()
+    if accelerator.is_local_main_process:
+        print("**Test last batch is not dropped when perfectly divisible**")
+    accelerator = Accelerator()
+    test_torch_metrics(accelerator, 512)
+    accelerator.state._reset_state()
+    if accelerator.is_local_main_process:
+        print("**Test that `drop_last` is taken into account**")
+    test_gather_for_metrics_drop_last()
+    accelerator.state._reset_state()
+
+
+def _mp_fn(index):
+    # For xla_spawn (TPUs)
+    main()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_peak_memory_usage.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_peak_memory_usage.py
new file mode 100644
index 0000000000000000000000000000000000000000..aeb55f6c87d7831ed5d7f370a4b9d7810777bd3e
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_peak_memory_usage.py
@@ -0,0 +1,282 @@
+# Copyright 2022 The HuggingFace Inc. team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import argparse
+import gc
+import json
+import os
+
+import torch
+from datasets import load_dataset
+from torch.optim import AdamW
+from torch.utils.data import DataLoader
+from transformers import AutoModelForSequenceClassification, AutoTokenizer, get_linear_schedule_with_warmup, set_seed
+
+from accelerate import Accelerator, DistributedType
+from accelerate.utils import is_mlu_available, is_npu_available, is_xpu_available
+from accelerate.utils.deepspeed import DummyOptim, DummyScheduler
+
+
+MAX_GPU_BATCH_SIZE = 16
+EVAL_BATCH_SIZE = 32
+
+
+# Converting Bytes to Megabytes
+def b2mb(x):
+    return int(x / 2**20)
+
+
+# This context manager is used to track the peak memory usage of the process
+class TorchTracemalloc:
+    def __enter__(self):
+        gc.collect()
+        if torch.cuda.is_available():
+            torch.cuda.empty_cache()
+            torch.cuda.reset_max_memory_allocated()  # reset the peak gauge to zero
+            self.begin = torch.cuda.memory_allocated()
+        elif is_mlu_available():
+            torch.mlu.empty_cache()
+            torch.mlu.reset_max_memory_allocated()  # reset the peak gauge to zero
+            self.begin = torch.mlu.memory_allocated()
+        elif is_npu_available():
+            torch.npu.empty_cache()
+            torch.npu.reset_max_memory_allocated()  # reset the peak gauge to zero
+            self.begin = torch.npu.memory_allocated()
+        elif is_xpu_available():
+            torch.xpu.empty_cache()
+            torch.xpu.reset_max_memory_allocated()  # reset the peak gauge to zero
+            self.begin = torch.xpu.memory_allocated()
+        return self
+
+    def __exit__(self, *exc):
+        gc.collect()
+        if torch.cuda.is_available():
+            torch.cuda.empty_cache()
+            self.end = torch.cuda.memory_allocated()
+            self.peak = torch.cuda.max_memory_allocated()
+        elif is_mlu_available():
+            torch.mlu.empty_cache()
+            torch.mlu.memory_allocated()  # reset the peak gauge to zero
+            self.begin = torch.mlu.max_memory_allocated()
+        elif is_npu_available():
+            torch.npu.empty_cache()
+            self.end = torch.npu.memory_allocated()
+            self.peak = torch.npu.max_memory_allocated()
+        elif is_xpu_available():
+            torch.xpu.empty_cache()
+            self.end = torch.xpu.memory_allocated()
+            self.peak = torch.xpu.max_memory_allocated()
+        self.used = b2mb(self.end - self.begin)
+        self.peaked = b2mb(self.peak - self.begin)
+        # print(f"delta used/peak {self.used:4d}/{self.peaked:4d}")
+
+
+def get_dataloaders(
+    accelerator: Accelerator,
+    batch_size: int = 16,
+    model_name: str = "bert-base-cased",
+    n_train: int = 320,
+    n_val: int = 160,
+):
+    """
+    Creates a set of `DataLoader`s for the `glue` dataset.
+
+    Args:
+        accelerator (`Accelerator`):
+            An `Accelerator` object
+        batch_size (`int`, *optional*):
+            The batch size for the train and validation DataLoaders.
+        model_name (`str`, *optional*):
+            The name of the model to use.
+        n_train (`int`, *optional*):
+            The number of training examples to use.
+        n_val (`int`, *optional*):
+            The number of validation examples to use.
+    """
+    tokenizer = AutoTokenizer.from_pretrained(model_name)
+    datasets = load_dataset(
+        "glue", "mrpc", split={"train": f"train[:{n_train}]", "validation": f"validation[:{n_val}]"}
+    )
+
+    def tokenize_function(examples):
+        # max_length=None => use the model max length (it's actually the default)
+        outputs = tokenizer(examples["sentence1"], examples["sentence2"], truncation=True, max_length=None)
+        return outputs
+
+    # Apply the method we just defined to all the examples in all the splits of the dataset
+    tokenized_datasets = datasets.map(
+        tokenize_function, batched=True, remove_columns=["idx", "sentence1", "sentence2"], load_from_cache_file=False
+    )
+
+    # We also rename the 'label' column to 'labels' which is the expected name for labels by the models of the
+    # transformers library
+    tokenized_datasets = tokenized_datasets.rename_column("label", "labels")
+
+    def collate_fn(examples):
+        # On TPU it's best to pad everything to the same length or training will be very slow.
+        if accelerator.distributed_type == DistributedType.XLA:
+            return tokenizer.pad(examples, padding="max_length", max_length=128, return_tensors="pt")
+        return tokenizer.pad(examples, padding="longest", return_tensors="pt")
+
+    # Instantiate dataloaders.
+    train_dataloader = DataLoader(
+        tokenized_datasets["train"], shuffle=True, collate_fn=collate_fn, batch_size=batch_size
+    )
+    eval_dataloader = DataLoader(
+        tokenized_datasets["validation"], shuffle=False, collate_fn=collate_fn, batch_size=EVAL_BATCH_SIZE
+    )
+
+    return train_dataloader, eval_dataloader
+
+
+def training_function(config, args):
+    # Initialize accelerator
+    accelerator = Accelerator()
+
+    # Sample hyper-parameters for learning rate, batch size, seed and a few other HPs
+    lr = config["lr"]
+    num_epochs = int(config["num_epochs"])
+    seed = int(config["seed"])
+    batch_size = int(config["batch_size"])
+    model_name = args.model_name_or_path
+
+    set_seed(seed)
+    train_dataloader, eval_dataloader = get_dataloaders(accelerator, batch_size, model_name, args.n_train, args.n_val)
+
+    # Instantiate the model (we build the model here so that the seed also control new weights initialization)
+    model = AutoModelForSequenceClassification.from_pretrained(model_name, return_dict=True)
+
+    # Instantiate optimizer
+    optimizer_cls = (
+        AdamW
+        if accelerator.state.deepspeed_plugin is None
+        or "optimizer" not in accelerator.state.deepspeed_plugin.deepspeed_config
+        else DummyOptim
+    )
+    optimizer = optimizer_cls(params=model.parameters(), lr=lr)
+
+    if accelerator.state.deepspeed_plugin is not None:
+        gradient_accumulation_steps = accelerator.state.deepspeed_plugin.deepspeed_config[
+            "gradient_accumulation_steps"
+        ]
+    else:
+        gradient_accumulation_steps = 1
+    max_training_steps = (len(train_dataloader) * num_epochs) // gradient_accumulation_steps
+
+    # Instantiate scheduler
+    if (
+        accelerator.state.deepspeed_plugin is None
+        or "scheduler" not in accelerator.state.deepspeed_plugin.deepspeed_config
+    ):
+        lr_scheduler = get_linear_schedule_with_warmup(
+            optimizer=optimizer,
+            num_warmup_steps=0,
+            num_training_steps=max_training_steps,
+        )
+    else:
+        lr_scheduler = DummyScheduler(optimizer, total_num_steps=max_training_steps, warmup_num_steps=0)
+
+    # Prepare everything
+    # There is no specific order to remember, we just need to unpack the objects in the same order we gave them to the
+    # prepare method.
+    model, optimizer, train_dataloader, eval_dataloader, lr_scheduler = accelerator.prepare(
+        model, optimizer, train_dataloader, eval_dataloader, lr_scheduler
+    )
+
+    # We need to keep track of how many total steps we have iterated over
+    overall_step = 0
+    # We also need to keep track of the stating epoch so files are named properly
+    starting_epoch = 0
+
+    # Now we train the model
+    train_total_peak_memory = {}
+    for epoch in range(starting_epoch, num_epochs):
+        with TorchTracemalloc() as tracemalloc:
+            model.train()
+            for step, batch in enumerate(train_dataloader):
+                outputs = model(**batch)
+                loss = outputs.loss
+                loss = loss / gradient_accumulation_steps
+                accelerator.backward(loss)
+                if step % gradient_accumulation_steps == 0:
+                    optimizer.step()
+                    lr_scheduler.step()
+                    optimizer.zero_grad()
+
+                overall_step += 1
+
+        # Printing the GPU memory usage details such as allocated memory, peak memory, and total memory usage
+        accelerator.print(f"Memory before entering the train : {b2mb(tracemalloc.begin)}")
+        accelerator.print(f"Memory consumed at the end of the train (end-begin): {tracemalloc.used}")
+        accelerator.print(f"Peak Memory consumed during the train (max-begin): {tracemalloc.peaked}")
+        accelerator.print(
+            f"Total Peak Memory consumed during the train (max): {tracemalloc.peaked + b2mb(tracemalloc.begin)}"
+        )
+        train_total_peak_memory[f"epoch-{epoch}"] = tracemalloc.peaked + b2mb(tracemalloc.begin)
+        if args.peak_memory_upper_bound is not None:
+            assert (
+                train_total_peak_memory[f"epoch-{epoch}"] <= args.peak_memory_upper_bound
+            ), "Peak memory usage exceeded the upper bound"
+
+    accelerator.wait_for_everyone()
+    if accelerator.is_main_process:
+        with open(os.path.join(args.output_dir, "peak_memory_utilization.json"), "w") as f:
+            json.dump(train_total_peak_memory, f)
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Simple example of training script tracking peak GPU memory usage.")
+    parser.add_argument(
+        "--model_name_or_path",
+        type=str,
+        default="bert-base-cased",
+        help="Path to pretrained model or model identifier from huggingface.co/models.",
+        required=False,
+    )
+    parser.add_argument(
+        "--output_dir",
+        type=str,
+        default=".",
+        help="Optional save directory where all checkpoint folders will be stored. Default is the current working directory.",
+    )
+    parser.add_argument(
+        "--peak_memory_upper_bound",
+        type=float,
+        default=None,
+        help="The upper bound of peak memory usage in MB. If set, the training will throw an error if the peak memory usage exceeds this value.",
+    )
+    parser.add_argument(
+        "--n_train",
+        type=int,
+        default=320,
+        help="Number of training examples to use.",
+    )
+    parser.add_argument(
+        "--n_val",
+        type=int,
+        default=160,
+        help="Number of validation examples to use.",
+    )
+    parser.add_argument(
+        "--num_epochs",
+        type=int,
+        default=1,
+        help="Number of train epochs.",
+    )
+    args = parser.parse_args()
+    config = {"lr": 2e-5, "num_epochs": args.num_epochs, "seed": 42, "batch_size": 16}
+    training_function(config, args)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_performance.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_performance.py
new file mode 100644
index 0000000000000000000000000000000000000000..7051859aa74bbac5b15e4465395b8177e3dd1d27
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_performance.py
@@ -0,0 +1,243 @@
+# Copyright 2022 The HuggingFace Inc. team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import argparse
+import json
+import os
+
+import evaluate
+import torch
+from datasets import load_dataset
+from torch.optim import AdamW
+from torch.utils.data import DataLoader
+from transformers import AutoModelForSequenceClassification, AutoTokenizer, get_linear_schedule_with_warmup, set_seed
+
+from accelerate import Accelerator, DistributedType
+from accelerate.utils.deepspeed import DummyOptim, DummyScheduler
+
+
+MAX_GPU_BATCH_SIZE = 16
+EVAL_BATCH_SIZE = 32
+
+
+def get_dataloaders(accelerator: Accelerator, batch_size: int = 16, model_name: str = "bert-base-cased"):
+    """
+    Creates a set of `DataLoader`s for the `glue` dataset.
+
+    Args:
+        accelerator (`Accelerator`):
+            An `Accelerator` object
+        batch_size (`int`, *optional*):
+            The batch size for the train and validation DataLoaders.
+        model_name (`str`, *optional*):
+    """
+    tokenizer = AutoTokenizer.from_pretrained(model_name)
+    datasets = load_dataset("glue", "mrpc")
+
+    def tokenize_function(examples):
+        # max_length=None => use the model max length (it's actually the default)
+        outputs = tokenizer(examples["sentence1"], examples["sentence2"], truncation=True, max_length=None)
+        return outputs
+
+    # Apply the method we just defined to all the examples in all the splits of the dataset
+    tokenized_datasets = datasets.map(
+        tokenize_function, batched=True, remove_columns=["idx", "sentence1", "sentence2"], load_from_cache_file=False
+    )
+
+    # We also rename the 'label' column to 'labels' which is the expected name for labels by the models of the
+    # transformers library
+    tokenized_datasets = tokenized_datasets.rename_column("label", "labels")
+
+    def collate_fn(examples):
+        # On TPU it's best to pad everything to the same length or training will be very slow.
+        if accelerator.distributed_type == DistributedType.XLA:
+            return tokenizer.pad(examples, padding="max_length", max_length=128, return_tensors="pt")
+        return tokenizer.pad(examples, padding="longest", return_tensors="pt")
+
+    # Instantiate dataloaders.
+    train_dataloader = DataLoader(
+        tokenized_datasets["train"], shuffle=True, collate_fn=collate_fn, batch_size=batch_size
+    )
+    eval_dataloader = DataLoader(
+        tokenized_datasets["validation"], shuffle=False, collate_fn=collate_fn, batch_size=EVAL_BATCH_SIZE
+    )
+
+    return train_dataloader, eval_dataloader
+
+
+def training_function(config, args):
+    # Initialize accelerator
+    accelerator = Accelerator()
+
+    # Sample hyper-parameters for learning rate, batch size, seed and a few other HPs
+    lr = config["lr"]
+    num_epochs = int(config["num_epochs"])
+    seed = int(config["seed"])
+    batch_size = int(config["batch_size"])
+    model_name = args.model_name_or_path
+
+    set_seed(seed)
+    train_dataloader, eval_dataloader = get_dataloaders(accelerator, batch_size, model_name)
+
+    # Instantiate the model (we build the model here so that the seed also control new weights initialization)
+    model = AutoModelForSequenceClassification.from_pretrained(model_name, return_dict=True)
+
+    # Instantiate optimizer
+    optimizer_cls = (
+        AdamW
+        if accelerator.state.deepspeed_plugin is None
+        or "optimizer" not in accelerator.state.deepspeed_plugin.deepspeed_config
+        else DummyOptim
+    )
+    optimizer = optimizer_cls(params=model.parameters(), lr=lr)
+
+    max_training_steps = len(train_dataloader) * num_epochs
+
+    # Instantiate scheduler
+    linear_decay_scheduler = False
+    if (
+        accelerator.state.deepspeed_plugin is None
+        or "scheduler" not in accelerator.state.deepspeed_plugin.deepspeed_config
+    ):
+        lr_scheduler = get_linear_schedule_with_warmup(
+            optimizer=optimizer,
+            num_warmup_steps=0,
+            num_training_steps=max_training_steps,
+        )
+        linear_decay_scheduler = True
+    else:
+        lr_scheduler = DummyScheduler(optimizer, total_num_steps=max_training_steps, warmup_num_steps=0)
+
+    # Prepare everything
+    # There is no specific order to remember, we just need to unpack the objects in the same order we gave them to the
+    # prepare method.
+    model, optimizer, train_dataloader, eval_dataloader, lr_scheduler = accelerator.prepare(
+        model, optimizer, train_dataloader, eval_dataloader, lr_scheduler
+    )
+
+    # We also need to keep track of the stating epoch so files are named properly
+    starting_epoch = 0
+
+    # Now we train the model
+    metric = evaluate.load("glue", "mrpc")
+    best_performance = 0
+    performance_metric = {}
+    expected_lr_after_first_optim_step = lr * (
+        1 - 1 / (max_training_steps / accelerator.num_processes / accelerator.gradient_accumulation_steps)
+    )
+    lr_scheduler_check_completed = False
+    for epoch in range(starting_epoch, num_epochs):
+        model.train()
+        for step, batch in enumerate(train_dataloader):
+            with accelerator.accumulate(model):
+                outputs = model(**batch)
+                loss = outputs.loss
+                accelerator.backward(loss)
+                optimizer.step()
+                lr_scheduler.step()
+                optimizer.zero_grad()
+
+                # assert the learning rate after first optimizer step
+                if (
+                    accelerator.sync_gradients
+                    and not lr_scheduler_check_completed
+                    and linear_decay_scheduler
+                    and accelerator.state.mixed_precision == "no"
+                ):
+                    assert (
+                        lr_scheduler.get_last_lr()[0] == expected_lr_after_first_optim_step
+                    ), f"Wrong lr found at second step, expected {expected_lr_after_first_optim_step}, got {lr_scheduler.get_last_lr()[0]}"
+                    lr_scheduler_check_completed = True
+
+        model.eval()
+        samples_seen = 0
+        for step, batch in enumerate(eval_dataloader):
+            # We could avoid this line since we set the accelerator with `device_placement=True`.
+            batch.to(accelerator.device)
+            with torch.no_grad():
+                outputs = model(**batch)
+            predictions = outputs.logits.argmax(dim=-1)
+            # It is slightly faster to call this once, than multiple times
+            predictions, references = accelerator.gather(
+                (predictions, batch["labels"])
+            )  # If we are in a multiprocess environment, the last batch has duplicates
+            if accelerator.use_distributed:
+                if step == len(eval_dataloader) - 1:
+                    predictions = predictions[: len(eval_dataloader.dataset) - samples_seen]
+                    references = references[: len(eval_dataloader.dataset) - samples_seen]
+                else:
+                    samples_seen += references.shape[0]
+            metric.add_batch(
+                predictions=predictions,
+                references=references,
+            )
+
+        eval_metric = metric.compute()
+        # Use accelerator.print to print only on the main process.
+        accelerator.print(f"epoch {epoch}:", eval_metric)
+        performance_metric[f"epoch-{epoch}"] = eval_metric["accuracy"]
+
+        if best_performance < eval_metric["accuracy"]:
+            best_performance = eval_metric["accuracy"]
+
+    # check that the LR is 0
+    if linear_decay_scheduler and accelerator.state.mixed_precision == "no":
+        assert (
+            lr_scheduler.get_last_lr()[0] == 0
+        ), f"Wrong lr found at last step, expected 0, got {lr_scheduler.get_last_lr()[0]}"
+
+    if args.performance_lower_bound is not None:
+        assert (
+            args.performance_lower_bound <= best_performance
+        ), f"Best performance metric {best_performance} is lower than the lower bound {args.performance_lower_bound}"
+
+    accelerator.wait_for_everyone()
+    if accelerator.is_main_process:
+        with open(os.path.join(args.output_dir, "all_results.json"), "w") as f:
+            json.dump(performance_metric, f)
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Simple example of training script tracking peak GPU memory usage.")
+    parser.add_argument(
+        "--model_name_or_path",
+        type=str,
+        default="bert-base-cased",
+        help="Path to pretrained model or model identifier from huggingface.co/models.",
+        required=False,
+    )
+    parser.add_argument(
+        "--output_dir",
+        type=str,
+        default=".",
+        help="Optional save directory where all checkpoint folders will be stored. Default is the current working directory.",
+    )
+    parser.add_argument(
+        "--performance_lower_bound",
+        type=float,
+        default=None,
+        help="Optional lower bound for the performance metric. If set, the training will throw error when the performance metric drops below this value.",
+    )
+    parser.add_argument(
+        "--num_epochs",
+        type=int,
+        default=3,
+        help="Number of train epochs.",
+    )
+    args = parser.parse_args()
+    config = {"lr": 2e-5, "num_epochs": args.num_epochs, "seed": 42, "batch_size": 16}
+    training_function(config, args)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_pippy.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_pippy.py
new file mode 100644
index 0000000000000000000000000000000000000000..f589365649d56fd690b4f4104a8838f885183527
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_pippy.py
@@ -0,0 +1,129 @@
+# Copyright 2024 The HuggingFace Inc. team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import torch
+from torchvision.models import resnet34
+from transformers import (
+    BertConfig,
+    BertForMaskedLM,
+    GPT2Config,
+    GPT2ForSequenceClassification,
+    T5Config,
+    T5ForConditionalGeneration,
+)
+
+from accelerate import PartialState
+from accelerate.inference import prepare_pippy
+from accelerate.utils import DistributedType, send_to_device, set_seed
+
+
+model_to_config = {
+    "t5": (T5ForConditionalGeneration, T5Config, 1024),
+    "bert": (BertForMaskedLM, BertConfig, 512),
+    "gpt2": (GPT2ForSequenceClassification, GPT2Config, 1024),
+}
+
+
+def get_model_and_data_for_text(model_name, device, num_processes: int = 2):
+    initializer, config, seq_len = model_to_config[model_name]
+    config_args = {}
+    # Eventually needed for batch inference tests on gpt-2 when bs != 1
+    # if model_name == "gpt2":
+    #     config_args["pad_token_id"] = 0
+    model_config = config(**config_args)
+    model = initializer(model_config)
+    return model, torch.randint(
+        low=0,
+        high=model_config.vocab_size,
+        size=(num_processes, seq_len),
+        device=device,
+        dtype=torch.int64,
+        requires_grad=False,
+    )
+
+
+def test_gpt2(batch_size: int = 2):
+    set_seed(42)
+    state = PartialState()
+    model, inputs = get_model_and_data_for_text("gpt2", "cpu", batch_size)
+    model = prepare_pippy(model, example_args=(inputs,), no_split_module_classes=model._no_split_modules)
+    # For inference args need to be a tuple
+    inputs = inputs.to("cuda")
+    with torch.no_grad():
+        output = model(inputs)
+    # Zach: Check that we just grab the real outputs we need at the end
+    if not state.is_last_process:
+        assert output is None, "Output was not generated on just the last process!"
+    else:
+        assert output is not None, "Output was not generated in the last process!"
+
+
+def test_t5(batch_size: int = 2):
+    set_seed(42)
+    state = PartialState()
+    model, inputs = get_model_and_data_for_text("t5", "cpu", batch_size)
+    example_inputs = {"input_ids": inputs, "decoder_input_ids": inputs}
+    model = prepare_pippy(
+        model,
+        no_split_module_classes=model._no_split_modules,
+        example_kwargs=example_inputs,
+    )
+    # For inference args need to be a tuple
+    inputs = send_to_device(example_inputs, "cuda:0")
+    with torch.no_grad():
+        output = model(*inputs.values())
+    # Zach: Check that we just grab the real outputs we need at the end
+    if not state.is_last_process:
+        assert output is None, "Output was not generated on just the last process!"
+    else:
+        assert output is not None, "Output was not generated in the last process!"
+
+
+def test_resnet(batch_size: int = 2):
+    set_seed(42)
+    state = PartialState()
+    model = resnet34()
+    input_tensor = torch.rand(batch_size, 3, 224, 224)
+    model = prepare_pippy(
+        model,
+        example_args=(input_tensor,),
+    )
+    inputs = send_to_device(input_tensor, "cuda:0")
+    with torch.no_grad():
+        output = model(inputs)
+    # Zach: Check that we just grab the real outputs we need at the end
+    if not state.is_last_process:
+        assert output is None, "Output was not generated on just the last process!"
+    else:
+        assert output is not None, "Output was not generated in the last process!"
+
+
+if __name__ == "__main__":
+    state = PartialState()
+    state.print("Testing pippy integration...")
+    if state.distributed_type == DistributedType.MULTI_GPU:
+        state.print("Testing GPT2...")
+        test_gpt2()
+        # Issue: When modifying the tokenizer for batch GPT2 inference, there's an issue
+        # due to references
+        # NameError: cannot access free variable 'chunk_args_list' where it is not associated with a value in enclosing scope
+        # test_gpt2(3)
+        state.print("Testing T5...")
+        test_t5()
+        test_t5(1)
+        test_t5(3)
+        state.print("Testing CV model...")
+        test_resnet()
+        test_resnet(3)
+    else:
+        print("Less than two GPUs found, not running tests!")
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_zero3_integration.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_zero3_integration.py
new file mode 100644
index 0000000000000000000000000000000000000000..67e78a7d37c0b82113e1cdbb3e76987b24c8494f
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/external_deps/test_zero3_integration.py
@@ -0,0 +1,52 @@
+# Copyright 2024 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import torch.distributed
+
+from accelerate.test_utils import require_huggingface_suite
+from accelerate.utils import is_transformers_available
+
+
+if is_transformers_available():
+    from transformers import AutoModel, TrainingArguments
+
+
+GPT2_TINY = "sshleifer/tiny-gpt2"
+
+
+@require_huggingface_suite
+def init_torch_dist_then_launch_deepspeed():
+    torch.distributed.init_process_group(backend="nccl")
+    deepspeed_config = {
+        "zero_optimization": {
+            "stage": 3,
+        },
+        "train_batch_size": "auto",
+        "train_micro_batch_size_per_gpu": "auto",
+    }
+    train_args = TrainingArguments(
+        output_dir="./",
+        deepspeed=deepspeed_config,
+    )
+    model = AutoModel.from_pretrained(GPT2_TINY)
+    assert train_args is not None
+    assert model is not None
+
+
+def main():
+    init_torch_dist_then_launch_deepspeed()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/test_cli.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/test_cli.py
new file mode 100644
index 0000000000000000000000000000000000000000..c85828cd49624372ae1866082e5580c60f8c9293
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/test_cli.py
@@ -0,0 +1,26 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import torch
+
+
+def main():
+    if torch.cuda.is_available():
+        num_gpus = torch.cuda.device_count()
+    else:
+        num_gpus = 0
+    print(f"Successfully ran on {num_gpus} GPUs")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/test_distributed_data_loop.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/test_distributed_data_loop.py
new file mode 100644
index 0000000000000000000000000000000000000000..17d577c58ac2e0bea6e63c54b464eef483de12a8
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/test_distributed_data_loop.py
@@ -0,0 +1,238 @@
+#!/usr/bin/env python
+
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import warnings
+from typing import List
+from unittest.mock import Mock
+
+import torch
+from torch.utils.data import DataLoader, IterableDataset, TensorDataset
+
+from accelerate.accelerator import Accelerator, DataLoaderConfiguration
+from accelerate.utils.dataclasses import DistributedType
+
+
+class DummyIterableDataset(IterableDataset):
+    def __init__(self, data):
+        self.data = data
+
+    def __iter__(self):
+        yield from self.data
+
+
+def create_accelerator(even_batches=True):
+    dataloader_config = DataLoaderConfiguration(even_batches=even_batches)
+    accelerator = Accelerator(dataloader_config=dataloader_config)
+    assert accelerator.num_processes == 2, "this script expects that two GPUs are available"
+    return accelerator
+
+
+def create_dataloader(accelerator: Accelerator, dataset_size: int, batch_size: int, iterable: bool = False):
+    """
+    Create a simple DataLoader to use during the test cases
+    """
+    if iterable:
+        dataset = DummyIterableDataset(torch.as_tensor(range(dataset_size)))
+    else:
+        dataset = TensorDataset(torch.as_tensor(range(dataset_size)))
+
+    dl = DataLoader(dataset, batch_size=batch_size)
+    dl = accelerator.prepare(dl)
+
+    return dl
+
+
+def verify_dataloader_batch_sizes(
+    accelerator: Accelerator,
+    dataset_size: int,
+    batch_size: int,
+    process_0_expected_batch_sizes: List[int],
+    process_1_expected_batch_sizes: List[int],
+):
+    """
+    A helper function for verifying the batch sizes coming from a prepared dataloader in each process
+    """
+    dl = create_dataloader(accelerator=accelerator, dataset_size=dataset_size, batch_size=batch_size)
+
+    batch_sizes = [len(batch[0]) for batch in dl]
+
+    if accelerator.process_index == 0:
+        assert batch_sizes == process_0_expected_batch_sizes
+    elif accelerator.process_index == 1:
+        assert batch_sizes == process_1_expected_batch_sizes
+
+
+def test_default_ensures_even_batch_sizes():
+    accelerator = create_accelerator()
+
+    # without padding, we would expect a different number of batches
+    verify_dataloader_batch_sizes(
+        accelerator,
+        dataset_size=3,
+        batch_size=1,
+        process_0_expected_batch_sizes=[1, 1],
+        process_1_expected_batch_sizes=[1, 1],
+    )
+
+    # without padding, we would expect the same number of batches, but different sizes
+    verify_dataloader_batch_sizes(
+        accelerator,
+        dataset_size=7,
+        batch_size=2,
+        process_0_expected_batch_sizes=[2, 2],
+        process_1_expected_batch_sizes=[2, 2],
+    )
+
+
+def test_can_disable_even_batches():
+    accelerator = create_accelerator(even_batches=False)
+
+    verify_dataloader_batch_sizes(
+        accelerator,
+        dataset_size=3,
+        batch_size=1,
+        process_0_expected_batch_sizes=[1, 1],
+        process_1_expected_batch_sizes=[1],
+    )
+
+    verify_dataloader_batch_sizes(
+        accelerator,
+        dataset_size=7,
+        batch_size=2,
+        process_0_expected_batch_sizes=[2, 2],
+        process_1_expected_batch_sizes=[2, 1],
+    )
+
+
+def test_can_join_uneven_inputs():
+    accelerator = create_accelerator(even_batches=False)
+
+    model = torch.nn.Linear(1, 1)
+    ddp_model = accelerator.prepare(model)
+
+    dl = create_dataloader(accelerator, dataset_size=3, batch_size=1)
+
+    batch_idxs = []
+    with accelerator.join_uneven_inputs([ddp_model]):
+        for batch_idx, batch in enumerate(dl):
+            output = ddp_model(batch[0].float())
+            loss = output.sum()
+            loss.backward()
+            batch_idxs.append(batch_idx)
+
+    accelerator.wait_for_everyone()
+
+    if accelerator.process_index == 0:
+        assert batch_idxs == [0, 1]
+    elif accelerator.process_index == 1:
+        assert batch_idxs == [0]
+
+
+def test_join_raises_warning_for_non_ddp_distributed(accelerator):
+    with warnings.catch_warnings(record=True) as w:
+        with accelerator.join_uneven_inputs([Mock()]):
+            pass
+
+        assert issubclass(w[-1].category, UserWarning)
+        assert "only supported for multi-GPU" in str(w[-1].message)
+
+
+def test_join_can_override_even_batches():
+    default_even_batches = True
+    overridden_even_batches = False
+    accelerator = create_accelerator(even_batches=default_even_batches)
+    model = torch.nn.Linear(1, 1)
+    ddp_model = accelerator.prepare(model)
+    train_dl = create_dataloader(accelerator, dataset_size=3, batch_size=1)
+    valid_dl = create_dataloader(accelerator, dataset_size=3, batch_size=1)
+
+    with accelerator.join_uneven_inputs([ddp_model], even_batches=overridden_even_batches):
+        train_dl_overridden_value = train_dl.batch_sampler.even_batches
+        valid_dl_overridden_value = valid_dl.batch_sampler.even_batches
+
+    assert train_dl_overridden_value == overridden_even_batches
+    assert valid_dl_overridden_value == overridden_even_batches
+    assert train_dl.batch_sampler.even_batches == default_even_batches
+    assert valid_dl.batch_sampler.even_batches == default_even_batches
+
+
+def test_join_can_override_for_mixed_type_dataloaders():
+    default_even_batches = True
+    overridden_even_batches = False
+    accelerator = create_accelerator(even_batches=default_even_batches)
+    model = torch.nn.Linear(1, 1)
+    ddp_model = accelerator.prepare(model)
+    create_dataloader(accelerator, dataset_size=3, batch_size=1, iterable=True)
+    batch_dl = create_dataloader(accelerator, dataset_size=3, batch_size=1)
+
+    with warnings.catch_warnings():
+        warnings.filterwarnings("ignore")
+        try:
+            with accelerator.join_uneven_inputs([ddp_model], even_batches=overridden_even_batches):
+                batch_dl_overridden_value = batch_dl.batch_sampler.even_batches
+        except AttributeError:
+            # ensure attribute error is not raised when processing iterable dl
+            raise AssertionError
+
+    assert batch_dl_overridden_value == overridden_even_batches
+    assert batch_dl.batch_sampler.even_batches == default_even_batches
+
+
+def test_join_raises_warning_for_iterable_when_overriding_even_batches():
+    accelerator = create_accelerator()
+    model = torch.nn.Linear(1, 1)
+    ddp_model = accelerator.prepare(model)
+    create_dataloader(accelerator, dataset_size=3, batch_size=1, iterable=True)
+
+    with warnings.catch_warnings(record=True) as w:
+        with accelerator.join_uneven_inputs([ddp_model], even_batches=False):
+            pass
+
+        assert issubclass(w[-1].category, UserWarning)
+        assert "only supported for map-style datasets" in str(w[-1].message)
+
+
+def main():
+    accelerator = create_accelerator()
+
+    accelerator.print("Test that even_batches variable ensures uniform batches across processes")
+    test_default_ensures_even_batch_sizes()
+
+    accelerator.print("Run tests with even_batches disabled")
+    test_can_disable_even_batches()
+
+    accelerator.print("Test joining uneven inputs")
+    test_can_join_uneven_inputs()
+
+    accelerator.print("Test overriding even_batches when joining uneven inputs")
+    test_join_can_override_even_batches()
+
+    accelerator.print("Test overriding even_batches for mixed dataloader types")
+    test_join_can_override_for_mixed_type_dataloaders()
+
+    accelerator.print("Test overriding even_batches raises a warning for iterable dataloaders")
+    test_join_raises_warning_for_iterable_when_overriding_even_batches()
+
+    accelerator.print("Test join with non DDP distributed raises warning")
+    original_state = accelerator.state.distributed_type
+    accelerator.state.distributed_type = DistributedType.FSDP
+    test_join_raises_warning_for_non_ddp_distributed(accelerator)
+    accelerator.state.distributed_type = original_state
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/test_notebook.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/test_notebook.py
new file mode 100644
index 0000000000000000000000000000000000000000..f0c073ac3eae5a86c351a5f8232b84bcdfb920a8
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/test_notebook.py
@@ -0,0 +1,56 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""
+Test file to ensure that in general certain situational setups for notebooks work.
+"""
+
+import os
+
+from pytest import raises
+
+from accelerate import PartialState, notebook_launcher
+from accelerate.test_utils import require_bnb
+from accelerate.utils import is_bnb_available
+
+
+def basic_function():
+    # Just prints the PartialState
+    print(f"PartialState:\n{PartialState()}")
+
+
+NUM_PROCESSES = int(os.environ.get("ACCELERATE_NUM_PROCESSES", 1))
+
+
+def test_can_initialize():
+    notebook_launcher(basic_function, (), num_processes=NUM_PROCESSES)
+
+
+@require_bnb
+def test_problematic_imports():
+    with raises(RuntimeError, match="Please keep these imports"):
+        import bitsandbytes as bnb  # noqa: F401
+
+        notebook_launcher(basic_function, (), num_processes=NUM_PROCESSES)
+
+
+def main():
+    print("Test basic notebook can be ran")
+    test_can_initialize()
+    if is_bnb_available():
+        print("Test problematic imports (bnb)")
+        test_problematic_imports()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/test_ops.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/test_ops.py
new file mode 100644
index 0000000000000000000000000000000000000000..1b18780fa70fdc2b8f579f07910c8682437459d5
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/test_ops.py
@@ -0,0 +1,179 @@
+#!/usr/bin/env python
+
+# Copyright 2023 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import torch
+
+from accelerate import PartialState
+from accelerate.test_utils.testing import assert_exception
+from accelerate.utils.dataclasses import DistributedType
+from accelerate.utils.operations import (
+    DistributedOperationException,
+    broadcast,
+    copy_tensor_to_devices,
+    gather,
+    gather_object,
+    pad_across_processes,
+    reduce,
+)
+
+
+def create_tensor(state):
+    return (torch.arange(state.num_processes) + 1.0 + (state.num_processes * state.process_index)).to(state.device)
+
+
+def test_gather(state):
+    tensor = create_tensor(state)
+    gathered_tensor = gather(tensor)
+    assert gathered_tensor.tolist() == list(range(1, state.num_processes**2 + 1))
+
+
+def test_gather_object(state):
+    # Gather objects in TorchXLA is not supported.
+    if state.distributed_type == DistributedType.XLA:
+        return
+    obj = [state.process_index]
+    gathered_obj = gather_object(obj)
+    assert len(gathered_obj) == state.num_processes, f"{gathered_obj}, {len(gathered_obj)} != {state.num_processes}"
+    assert gathered_obj == list(range(state.num_processes)), f"{gathered_obj} != {list(range(state.num_processes))}"
+
+
+def test_gather_non_contigous(state):
+    # Skip this test because the 'is_contiguous' function of XLA tensor always returns True.
+    if state.distributed_type == DistributedType.XLA:
+        return
+    # Create a non-contiguous tensor
+    tensor = torch.arange(12).view(4, 3).t().to(state.device)
+    assert not tensor.is_contiguous()
+    # Shouldn't error out
+    _ = gather(tensor)
+
+
+def test_broadcast(state):
+    tensor = create_tensor(state)
+    broadcasted_tensor = broadcast(tensor)
+    assert broadcasted_tensor.shape == torch.Size([state.num_processes])
+    assert broadcasted_tensor.tolist() == list(range(1, state.num_processes + 1))
+
+
+def test_pad_across_processes(state):
+    # We need to pad the tensor with one more element if we are the main process
+    # to ensure that we can pad
+    if state.is_main_process:
+        tensor = torch.arange(state.num_processes + 1).to(state.device)
+    else:
+        tensor = torch.arange(state.num_processes).to(state.device)
+    padded_tensor = pad_across_processes(tensor)
+    assert padded_tensor.shape == torch.Size([state.num_processes + 1])
+    if not state.is_main_process:
+        assert padded_tensor.tolist() == list(range(0, state.num_processes)) + [0]
+
+
+def test_reduce_sum(state):
+    # For now runs on only two processes
+    if state.num_processes != 2:
+        return
+    tensor = create_tensor(state)
+    reduced_tensor = reduce(tensor, "sum")
+    truth_tensor = torch.tensor([4.0, 6]).to(state.device)
+    assert torch.allclose(reduced_tensor, truth_tensor), f"{reduced_tensor} != {truth_tensor}"
+
+
+def test_reduce_mean(state):
+    # For now runs on only two processes
+    if state.num_processes != 2:
+        return
+    tensor = create_tensor(state)
+    reduced_tensor = reduce(tensor, "mean")
+    truth_tensor = torch.tensor([2.0, 3]).to(state.device)
+    assert torch.allclose(reduced_tensor, truth_tensor), f"{reduced_tensor} != {truth_tensor}"
+
+
+def test_op_checker(state):
+    # Must be in a distributed state, and gathering is currently not supported in TorchXLA.
+    if state.distributed_type in [DistributedType.NO, DistributedType.XLA]:
+        return
+    state.debug = True
+    # `pad_across_processes`
+    if state.process_index == 0:
+        data = {"tensor": torch.tensor([[0.0, 1, 2, 3, 4]]).to(state.device)}
+    else:
+        data = {"tensor": torch.tensor([[[0.0, 1, 2, 3, 4, 5]]]).to(state.device)}
+
+    with assert_exception(DistributedOperationException):
+        pad_across_processes(data, dim=0)
+
+    # `reduce`
+    if state.process_index == 0:
+        data = {"tensor": torch.tensor([[0.0, 1, 2, 3, 4]]).to(state.device)}
+    else:
+        data = {"tensor": torch.tensor([[[0.0, 1, 2, 3, 4], [5, 6, 7, 8, 9]]]).to(state.device)}
+
+    with assert_exception(DistributedOperationException):
+        reduce(data)
+
+    # `broadcast`
+    if state.process_index == 0:
+        data = {"tensor": torch.tensor([[0.0, 1, 2, 3, 4]]).to(state.device)}
+    else:
+        data = {"tensor": torch.tensor([[[0.0, 1, 2, 3, 4], [5, 6, 7, 8, 9]]]).to(state.device)}
+
+    with assert_exception(DistributedOperationException):
+        broadcast(data)
+
+    state.debug = False
+
+
+def test_copy_tensor_to_devices(state):
+    if state.distributed_type not in [DistributedType.MULTI_GPU, DistributedType.XLA]:
+        return
+    if state.is_main_process:
+        tensor = torch.tensor([1, 2, 3], dtype=torch.int).to(state.device)
+    else:
+        tensor = None
+    tensor = copy_tensor_to_devices(tensor)
+    assert torch.allclose(tensor, torch.tensor([1, 2, 3], dtype=torch.int, device=state.device))
+
+
+def _mp_fn(index):
+    # For xla_spawn (TPUs)
+    main()
+
+
+def main():
+    state = PartialState()
+    state.print(f"State: {state}")
+    state.print("testing gather")
+    test_gather(state)
+    state.print("testing gather_object")
+    test_gather_object(state)
+    state.print("testing gather non-contigous")
+    test_gather_non_contigous(state)
+    state.print("testing broadcast")
+    test_broadcast(state)
+    state.print("testing pad_across_processes")
+    test_pad_across_processes(state)
+    state.print("testing reduce_sum")
+    test_reduce_sum(state)
+    state.print("testing reduce_mean")
+    test_reduce_mean(state)
+    state.print("testing op_checker")
+    test_op_checker(state)
+    state.print("testing sending tensors across devices")
+    test_copy_tensor_to_devices(state)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/test_script.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/test_script.py
new file mode 100644
index 0000000000000000000000000000000000000000..a982612e4463eb807f272b7a65093ac23008861a
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/test_script.py
@@ -0,0 +1,802 @@
+#!/usr/bin/env python
+
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import contextlib
+import io
+import math
+import time
+from copy import deepcopy
+from pathlib import Path
+
+import numpy as np
+import torch
+from torch.utils.data import DataLoader, Dataset
+
+from accelerate import Accelerator
+from accelerate.data_loader import SeedableRandomSampler, prepare_data_loader
+from accelerate.state import AcceleratorState
+from accelerate.test_utils import RegressionDataset, are_the_same_tensors
+from accelerate.utils import (
+    DataLoaderConfiguration,
+    DistributedType,
+    gather,
+    is_bf16_available,
+    is_datasets_available,
+    is_ipex_available,
+    is_mlu_available,
+    is_npu_available,
+    is_xpu_available,
+    set_seed,
+    synchronize_rng_states,
+)
+
+
+# TODO: remove RegressionModel4XPU once ccl support empty buffer in broadcasting.
+if is_xpu_available():
+    from accelerate.test_utils import RegressionModel4XPU as RegressionModel
+else:
+    from accelerate.test_utils import RegressionModel
+
+
+def generate_baseline_dataloader(train_set, generator, batch_size, use_seedable_sampler=False):
+    "Creates a dataloader that can also use the `SeedableRandomSampler`"
+    if use_seedable_sampler:
+        # The SeedableRandomSampler is needed during distributed setups
+        # for full reproducability across processes with the `DataLoader`
+        sampler = SeedableRandomSampler(
+            generator=generator,
+            data_source=train_set,
+            num_samples=len(train_set),
+        )
+        return DataLoader(train_set, batch_size=batch_size, sampler=sampler)
+    else:
+        return DataLoader(train_set, batch_size=batch_size, shuffle=True, generator=generator)
+
+
+def print_main(state):
+    print(f"Printing from the main process {state.process_index}")
+
+
+def print_local_main(state):
+    print(f"Printing from the local main process {state.local_process_index}")
+
+
+def print_last(state):
+    print(f"Printing from the last process {state.process_index}")
+
+
+def print_on(state, process_idx):
+    print(f"Printing from process {process_idx}: {state.process_index}")
+
+
+def process_execution_check():
+    accelerator = Accelerator()
+    num_processes = accelerator.num_processes
+    # Test main_process_first context manager
+    path = Path("check_main_process_first.txt")
+    with accelerator.main_process_first():
+        if accelerator.is_main_process:
+            time.sleep(0.1)  # ensure main process takes longest
+            with open(path, "a+") as f:
+                f.write("Currently in the main process\n")
+        else:
+            with open(path, "a+") as f:
+                f.write("Now on another process\n")
+    accelerator.wait_for_everyone()
+
+    if accelerator.is_main_process:
+        with open(path) as f:
+            text = "".join(f.readlines())
+        try:
+            assert text.startswith("Currently in the main process\n"), "Main process was not first"
+            if num_processes > 1:
+                assert text.endswith("Now on another process\n"), "Main process was not first"
+            assert (
+                text.count("Now on another process\n") == accelerator.num_processes - 1
+            ), f"Only wrote to file {text.count('Now on another process') + 1} times, not {accelerator.num_processes}"
+        except AssertionError:
+            path.unlink()
+            raise
+
+    if accelerator.is_main_process and path.exists():
+        path.unlink()
+    accelerator.wait_for_everyone()
+    # Test the decorators
+    f = io.StringIO()
+    with contextlib.redirect_stdout(f):
+        accelerator.on_main_process(print_main)(accelerator.state)
+    result = f.getvalue().rstrip()
+    if accelerator.is_main_process:
+        assert result == "Printing from the main process 0", f"{result} != Printing from the main process 0"
+    else:
+        assert f.getvalue().rstrip() == "", f'{result} != ""'
+    f.truncate(0)
+    f.seek(0)
+
+    with contextlib.redirect_stdout(f):
+        accelerator.on_local_main_process(print_local_main)(accelerator.state)
+    if accelerator.is_local_main_process:
+        assert f.getvalue().rstrip() == "Printing from the local main process 0"
+    else:
+        assert f.getvalue().rstrip() == ""
+    f.truncate(0)
+    f.seek(0)
+
+    with contextlib.redirect_stdout(f):
+        accelerator.on_last_process(print_last)(accelerator.state)
+    if accelerator.is_last_process:
+        assert f.getvalue().rstrip() == f"Printing from the last process {accelerator.state.num_processes - 1}"
+    else:
+        assert f.getvalue().rstrip() == ""
+    f.truncate(0)
+    f.seek(0)
+
+    for process_idx in range(num_processes):
+        with contextlib.redirect_stdout(f):
+            accelerator.on_process(print_on, process_index=process_idx)(accelerator.state, process_idx)
+        if accelerator.process_index == process_idx:
+            assert f.getvalue().rstrip() == f"Printing from process {process_idx}: {accelerator.process_index}"
+        else:
+            assert f.getvalue().rstrip() == ""
+        f.truncate(0)
+        f.seek(0)
+
+
+def init_state_check():
+    # Test we can instantiate this twice in a row.
+    state = AcceleratorState()
+    if state.local_process_index == 0:
+        print("Testing, testing. 1, 2, 3.")
+    print(state)
+
+
+def rng_sync_check():
+    state = AcceleratorState()
+    synchronize_rng_states(["torch"])
+    assert are_the_same_tensors(torch.get_rng_state()), "RNG states improperly synchronized on CPU."
+    if state.distributed_type == DistributedType.MULTI_GPU:
+        synchronize_rng_states(["cuda"])
+        assert are_the_same_tensors(torch.cuda.get_rng_state()), "RNG states improperly synchronized on GPU."
+    elif state.distributed_type == DistributedType.MULTI_XPU:
+        synchronize_rng_states(["xpu"])
+        assert are_the_same_tensors(torch.xpu.get_rng_state()), "RNG states improperly synchronized on XPU."
+    generator = torch.Generator()
+    synchronize_rng_states(["generator"], generator=generator)
+    assert are_the_same_tensors(generator.get_state()), "RNG states improperly synchronized in generator."
+
+    if state.local_process_index == 0:
+        print("All rng are properly synched.")
+
+
+def dl_preparation_check():
+    state = AcceleratorState()
+    length = 32 * state.num_processes
+
+    dl = DataLoader(range(length), batch_size=8)
+    dl = prepare_data_loader(dl, state.device, state.num_processes, state.process_index, put_on_device=True)
+    result = []
+    for batch in dl:
+        result.append(gather(batch))
+    result = torch.cat(result)
+
+    print(state.process_index, result, type(dl))
+    assert torch.equal(result.cpu(), torch.arange(0, length).long()), "Wrong non-shuffled dataloader result."
+
+    dl = DataLoader(range(length), batch_size=8)
+    dl = prepare_data_loader(
+        dl,
+        state.device,
+        state.num_processes,
+        state.process_index,
+        put_on_device=True,
+        split_batches=True,
+    )
+    result = []
+    for batch in dl:
+        result.append(gather(batch))
+    result = torch.cat(result)
+    assert torch.equal(result.cpu(), torch.arange(0, length).long()), "Wrong non-shuffled dataloader result."
+
+    if state.process_index == 0:
+        print("Non-shuffled dataloader passing.")
+
+    dl = DataLoader(range(length), batch_size=8, shuffle=True)
+    dl = prepare_data_loader(dl, state.device, state.num_processes, state.process_index, put_on_device=True)
+    result = []
+    for batch in dl:
+        result.append(gather(batch))
+    result = torch.cat(result).tolist()
+    result.sort()
+    assert result == list(range(length)), "Wrong shuffled dataloader result."
+
+    dl = DataLoader(range(length), batch_size=8, shuffle=True)
+    dl = prepare_data_loader(
+        dl,
+        state.device,
+        state.num_processes,
+        state.process_index,
+        put_on_device=True,
+        split_batches=True,
+    )
+    result = []
+    for batch in dl:
+        result.append(gather(batch))
+    result = torch.cat(result).tolist()
+    result.sort()
+    assert result == list(range(length)), "Wrong shuffled dataloader result."
+
+    if state.local_process_index == 0:
+        print("Shuffled dataloader passing.")
+
+
+def central_dl_preparation_check():
+    state = AcceleratorState()
+    length = 32 * state.num_processes
+
+    dl = DataLoader(range(length), batch_size=8)
+    dl = prepare_data_loader(
+        dl, state.device, state.num_processes, state.process_index, put_on_device=True, dispatch_batches=True
+    )
+    result = []
+    for batch in dl:
+        result.append(gather(batch))
+    result = torch.cat(result)
+    assert torch.equal(result.cpu(), torch.arange(0, length).long()), "Wrong non-shuffled dataloader result."
+
+    dl = DataLoader(range(length), batch_size=8)
+    dl = prepare_data_loader(
+        dl,
+        state.device,
+        state.num_processes,
+        state.process_index,
+        put_on_device=True,
+        split_batches=True,
+        dispatch_batches=True,
+    )
+    result = []
+    for batch in dl:
+        result.append(gather(batch))
+    result = torch.cat(result)
+    assert torch.equal(result.cpu(), torch.arange(0, length).long()), "Wrong non-shuffled dataloader result."
+
+    if state.process_index == 0:
+        print("Non-shuffled central dataloader passing.")
+
+    dl = DataLoader(range(length), batch_size=8, shuffle=True)
+    dl = prepare_data_loader(
+        dl, state.device, state.num_processes, state.process_index, put_on_device=True, dispatch_batches=True
+    )
+    result = []
+    for batch in dl:
+        result.append(gather(batch))
+    result = torch.cat(result).tolist()
+    result.sort()
+    assert result == list(range(length)), "Wrong shuffled dataloader result."
+
+    dl = DataLoader(range(length), batch_size=8, shuffle=True)
+    dl = prepare_data_loader(
+        dl,
+        state.device,
+        state.num_processes,
+        state.process_index,
+        put_on_device=True,
+        split_batches=True,
+        dispatch_batches=True,
+    )
+    result = []
+    for batch in dl:
+        result.append(gather(batch))
+    result = torch.cat(result).tolist()
+    result.sort()
+    assert result == list(range(length)), "Wrong shuffled dataloader result."
+
+    if state.local_process_index == 0:
+        print("Shuffled central dataloader passing.")
+
+
+def custom_sampler_check():
+    state = AcceleratorState()
+
+    class CustomDataset(Dataset):
+        def __init__(self, data):
+            self.data = data
+
+        def __len__(self):
+            return len(self.data)
+
+        def __getitem__(self, index):
+            return self.data[index]
+
+    class CustomBatchSampler:
+        def __init__(self, dataset_length: int, batch_size: int, shuffle: bool = True):
+            self.batch_size = batch_size
+            self.data_index = np.arange(dataset_length)
+            self.shuffle = shuffle
+
+        def __iter__(self):
+            num_batches = len(self)
+            if self.shuffle:
+                index = np.random.permutation(self.data_index)
+            else:
+                index = self.data_index
+            output = np.array_split(index, num_batches)
+            yield from output
+
+        def __len__(self):
+            return math.ceil(len(self.data_index) / self.batch_size)
+
+    dataset = CustomDataset(range(32 * state.num_processes))
+    sampler = CustomBatchSampler(len(dataset), batch_size=8)
+    dl = DataLoader(dataset, batch_sampler=sampler)
+    dl = prepare_data_loader(dl, state.device, state.num_processes, state.process_index)
+    # We need just ensure that `dl.batch_sampler` (or `dl.batch_sampler.batch_sampler` is indeed the old batch sampler
+    if hasattr(dl.batch_sampler, "batch_sampler"):
+        assert isinstance(
+            dl.batch_sampler.batch_sampler, CustomBatchSampler
+        ), "Custom sampler was changed after calling `prepare_data_loader`"
+    else:
+        assert isinstance(
+            dl.batch_sampler, CustomBatchSampler
+        ), "Custom sampler was changed after calling `prepare_data_loader`"
+
+
+def check_seedable_sampler():
+    # Set seed
+    set_seed(42)
+    train_set = RegressionDataset(length=10, seed=42)
+    train_dl = DataLoader(train_set, batch_size=2, shuffle=True)
+
+    config = DataLoaderConfiguration(use_seedable_sampler=True)
+    accelerator = Accelerator(dataloader_config=config)
+    train_dl = accelerator.prepare(train_dl)
+    original_items = []
+    for _ in range(3):
+        for batch in train_dl:
+            original_items.append(batch["x"])
+    original_items = torch.cat(original_items)
+
+    # Set seed again and the epoch
+    set_seed(42)
+    train_dl.set_epoch(0)
+    new_items = []
+    for _ in range(3):
+        for batch in train_dl:
+            new_items.append(batch["x"])
+    new_items = torch.cat(new_items)
+    assert torch.allclose(original_items, new_items), "Did not obtain the same items with the same seed and epoch."
+
+
+def check_seedable_sampler_in_batch_sampler_shard():
+    set_seed(42)
+
+    config = DataLoaderConfiguration(use_seedable_sampler=True)
+    accelerator = Accelerator(dataloader_config=config)
+    assert accelerator.num_processes > 1, "This test requires more than one process."
+
+    dataloader = DataLoader(list(range(10)), batch_size=1, shuffle=True)
+    prepared_data_loader = prepare_data_loader(
+        dataloader=dataloader,
+        use_seedable_sampler=True,
+    )
+
+    target_sampler = prepared_data_loader.batch_sampler.batch_sampler.sampler
+    assert isinstance(
+        target_sampler, SeedableRandomSampler
+    ), "Sampler in BatchSamplerShard is not SeedableRandomSampler."
+
+
+def mock_training(length, batch_size, generator, use_seedable_sampler=False):
+    set_seed(42)
+    generator.manual_seed(42)
+    train_set = RegressionDataset(length=length, seed=42)
+
+    train_dl = generate_baseline_dataloader(train_set, generator, batch_size, use_seedable_sampler)
+    model = RegressionModel()
+    optimizer = torch.optim.SGD(model.parameters(), lr=0.1)
+    for epoch in range(3):
+        for batch in train_dl:
+            model.zero_grad()
+            output = model(batch["x"])
+            loss = torch.nn.functional.mse_loss(output, batch["y"])
+            loss.backward()
+            optimizer.step()
+    return train_set, model
+
+
+def training_check(use_seedable_sampler=False):
+    state = AcceleratorState()
+    generator = torch.Generator()
+    batch_size = 8
+    length = batch_size * 4 * state.num_processes
+
+    train_set, old_model = mock_training(length, batch_size * state.num_processes, generator, use_seedable_sampler)
+    assert are_the_same_tensors(old_model.a), "Did not obtain the same model on both processes."
+    assert are_the_same_tensors(old_model.b), "Did not obtain the same model on both processes."
+
+    accelerator = Accelerator()
+    train_dl = generate_baseline_dataloader(train_set, generator, batch_size, use_seedable_sampler)
+    model = RegressionModel()
+    optimizer = torch.optim.SGD(model.parameters(), lr=0.1)
+
+    train_dl, model, optimizer = accelerator.prepare(train_dl, model, optimizer)
+    set_seed(42)
+    generator.manual_seed(42)
+    for _ in range(3):
+        for batch in train_dl:
+            model.zero_grad()
+            output = model(batch["x"])
+            loss = torch.nn.functional.mse_loss(output, batch["y"])
+            accelerator.backward(loss)
+            optimizer.step()
+
+    model = accelerator.unwrap_model(model).cpu()
+    assert torch.allclose(old_model.a, model.a), "Did not obtain the same model on CPU or distributed training."
+    assert torch.allclose(old_model.b, model.b), "Did not obtain the same model on CPU or distributed training."
+
+    accelerator.print("Training yielded the same results on one CPU or distributed setup with no batch split.")
+
+    dataloader_config = DataLoaderConfiguration(split_batches=True, use_seedable_sampler=use_seedable_sampler)
+    accelerator = Accelerator(dataloader_config=dataloader_config)
+    train_dl = generate_baseline_dataloader(
+        train_set, generator, batch_size * state.num_processes, use_seedable_sampler
+    )
+    model = RegressionModel()
+    optimizer = torch.optim.SGD(model.parameters(), lr=0.1)
+
+    train_dl, model, optimizer = accelerator.prepare(train_dl, model, optimizer)
+    set_seed(42)
+    generator.manual_seed(42)
+    for _ in range(3):
+        for batch in train_dl:
+            model.zero_grad()
+            output = model(batch["x"])
+            loss = torch.nn.functional.mse_loss(output, batch["y"])
+            accelerator.backward(loss)
+            optimizer.step()
+
+    model = accelerator.unwrap_model(model).cpu()
+    assert torch.allclose(old_model.a, model.a), "Did not obtain the same model on CPU or distributed training."
+    assert torch.allclose(old_model.b, model.b), "Did not obtain the same model on CPU or distributed training."
+
+    accelerator.print("Training yielded the same results on one CPU or distributes setup with batch split.")
+
+    if torch.cuda.is_available() or is_npu_available() or is_mlu_available():
+        # Mostly a test that FP16 doesn't crash as the operation inside the model is not converted to FP16
+        print("FP16 training check.")
+        AcceleratorState._reset_state()
+        dataloader_config = DataLoaderConfiguration(use_seedable_sampler=use_seedable_sampler)
+        accelerator = Accelerator(mixed_precision="fp16", dataloader_config=dataloader_config)
+        train_dl = generate_baseline_dataloader(train_set, generator, batch_size, use_seedable_sampler)
+        model = RegressionModel()
+        optimizer = torch.optim.SGD(model.parameters(), lr=0.1)
+
+        train_dl, model, optimizer = accelerator.prepare(train_dl, model, optimizer)
+        set_seed(42)
+        generator.manual_seed(42)
+        for _ in range(3):
+            for batch in train_dl:
+                model.zero_grad()
+                output = model(batch["x"])
+                loss = torch.nn.functional.mse_loss(output, batch["y"])
+                accelerator.backward(loss)
+                optimizer.step()
+
+        model = accelerator.unwrap_model(model).cpu()
+        assert torch.allclose(old_model.a, model.a), "Did not obtain the same model on CPU or distributed training."
+        assert torch.allclose(old_model.b, model.b), "Did not obtain the same model on CPU or distributed training."
+
+    if torch.cuda.is_available():
+        # Mostly a test that model.forward will have autocast when running unwrap_model(model, keep_fp32_wrapper=True)
+        print("Keep fp32 wrapper check.")
+        AcceleratorState._reset_state()
+        accelerator = Accelerator(mixed_precision="fp16")
+
+        model = torch.nn.Linear(2, 4)
+        model = accelerator.prepare(model)
+        model_with_fp32_wrapper = accelerator.unwrap_model(model, keep_fp32_wrapper=True)
+
+        # Run forward with fp16 as input.
+        # When the model is with mixed precision wrapper, no error will be raised.
+        input_tensor = torch.Tensor([1, 2]).to(dtype=torch.float16, device=accelerator.device)
+        output = model_with_fp32_wrapper(input_tensor)
+
+    # BF16 support is only for CPU + TPU, and some GPU
+    if is_bf16_available():
+        # Mostly a test that BF16 doesn't crash as the operation inside the model is not converted to BF16
+        print("BF16 training check.")
+        AcceleratorState._reset_state()
+        dataloader_config = DataLoaderConfiguration(use_seedable_sampler=use_seedable_sampler)
+        accelerator = Accelerator(mixed_precision="bf16", dataloader_config=dataloader_config)
+        train_dl = generate_baseline_dataloader(train_set, generator, batch_size, use_seedable_sampler)
+        model = RegressionModel()
+        optimizer = torch.optim.SGD(model.parameters(), lr=0.1)
+
+        train_dl, model, optimizer = accelerator.prepare(train_dl, model, optimizer)
+        set_seed(42)
+        generator.manual_seed(42)
+        for _ in range(3):
+            for batch in train_dl:
+                model.zero_grad()
+                output = model(batch["x"])
+                loss = torch.nn.functional.mse_loss(output, batch["y"])
+                accelerator.backward(loss)
+                optimizer.step()
+
+        model = accelerator.unwrap_model(model).cpu()
+        assert torch.allclose(old_model.a, model.a), "Did not obtain the same model on CPU or distributed training."
+        assert torch.allclose(old_model.b, model.b), "Did not obtain the same model on CPU or distributed training."
+
+    # IPEX support is only for CPU
+    if is_ipex_available():
+        print("ipex BF16 training check.")
+        AcceleratorState._reset_state()
+        dataloader_config = DataLoaderConfiguration(use_seedable_sampler=use_seedable_sampler)
+        accelerator = Accelerator(mixed_precision="bf16", cpu=True, dataloader_config=dataloader_config)
+        train_dl = generate_baseline_dataloader(train_set, generator, batch_size, use_seedable_sampler)
+        model = RegressionModel()
+        optimizer = torch.optim.SGD(model.parameters(), lr=0.1)
+
+        train_dl, model, optimizer = accelerator.prepare(train_dl, model, optimizer)
+        set_seed(42)
+        generator.manual_seed(42)
+        for _ in range(3):
+            for batch in train_dl:
+                model.zero_grad()
+                output = model(batch["x"])
+                loss = torch.nn.functional.mse_loss(output, batch["y"])
+                accelerator.backward(loss)
+                optimizer.step()
+
+        model = accelerator.unwrap_model(model).cpu()
+        assert torch.allclose(old_model.a, model.a), "Did not obtain the same model on CPU or distributed training."
+        assert torch.allclose(old_model.b, model.b), "Did not obtain the same model on CPU or distributed training."
+
+    # XPU support is only for XPU
+    if is_xpu_available():
+        print("xpu BF16 training check.")
+        AcceleratorState._reset_state()
+        dataloader_config = DataLoaderConfiguration(use_seedable_sampler=use_seedable_sampler)
+        accelerator = Accelerator(mixed_precision="bf16", cpu=False, dataloader_config=dataloader_config)
+        train_dl = generate_baseline_dataloader(train_set, generator, batch_size, use_seedable_sampler)
+        model = RegressionModel()
+        optimizer = torch.optim.SGD(model.parameters(), lr=0.1)
+
+        train_dl, model, optimizer = accelerator.prepare(train_dl, model, optimizer)
+        set_seed(42)
+        generator.manual_seed(42)
+        for _ in range(3):
+            for batch in train_dl:
+                model.zero_grad()
+                output = model(batch["x"])
+                loss = torch.nn.functional.mse_loss(output, batch["y"])
+                accelerator.backward(loss)
+                optimizer.step()
+
+        model = accelerator.unwrap_model(model).cpu()
+        assert torch.allclose(old_model.a, model.a), "Did not obtain the same model on XPU or distributed training."
+        assert torch.allclose(old_model.b, model.b), "Did not obtain the same model on XPU or distributed training."
+
+
+def test_split_between_processes_dataset(datasets_Dataset):
+    state = AcceleratorState()
+    data = datasets_Dataset.from_list([dict(k=v) for v in range(2 * state.num_processes)])
+    with state.split_between_processes(data, apply_padding=False) as results:
+        assert (
+            len(results) == 2
+        ), f"Each process did not have two items. Process index: {state.process_index}; Length: {len(results)}"
+
+    data = datasets_Dataset.from_list([dict(k=v) for v in range(2 * state.num_processes - 1)])
+    with state.split_between_processes(data, apply_padding=False) as results:
+        if state.is_last_process:
+            assert (
+                len(results) == 1
+            ), f"Last process did not receive a single item. Process index: {state.process_index}; Length: {len(results)}"
+        else:
+            assert (
+                len(results) == 2
+            ), f"One of the intermediate processes did not receive two items. Process index: {state.process_index}; Length: {len(results)}"
+
+    data = datasets_Dataset.from_list([dict(k=v) for v in range(2 * state.num_processes - 1)])
+    with state.split_between_processes(data, apply_padding=True) as results:
+        if state.num_processes == 1:
+            assert (
+                len(results) == 1
+            ), f"Single process did not receive a single item. Process index: {state.process_index}; Length: {len(results)}"
+        else:
+            assert (
+                len(results) == 2
+            ), f"Each process did not have two items. Process index: {state.process_index}; Length: {len(results)}"
+
+    state.wait_for_everyone()
+
+
+def test_split_between_processes_list():
+    state = AcceleratorState()
+    data = list(range(0, 2 * state.num_processes))
+    with state.split_between_processes(data) as results:
+        assert (
+            len(results) == 2
+        ), f"Each process did not have two items. Process index: {state.process_index}; Length: {len(results)}"
+
+    data = list(range(0, (3 * state.num_processes) - 1))
+    with state.split_between_processes(data, apply_padding=True) as results:
+        if state.is_last_process:
+            # Test that the last process gets the extra item(s)
+            num_samples_per_device = math.ceil(len(data) / state.num_processes)
+            assert (
+                len(results) == num_samples_per_device
+            ), f"Last process did not get the extra item(s). Process index: {state.process_index}; Length: {len(results)}"
+    state.wait_for_everyone()
+
+
+def test_split_between_processes_nested_dict():
+    state = AcceleratorState()
+    a = [1, 2, 3, 4, 5, 6, 7, 8]
+    b = ["a", "b", "c", "d", "e", "f", "g", "h"]
+    c = torch.tensor([1, 2, 3, 4, 5, 6, 7, 8])
+    if state.num_processes in (1, 2, 4):
+        data = {"a": a, "b": b, "c": c}
+        data_copy = deepcopy(data)
+        with state.split_between_processes(data) as results:
+            if state.process_index == 0:
+                assert results["a"] == data_copy["a"][: 8 // state.num_processes]
+            elif state.num_processes == 2:
+                assert results["a"] == data_copy["a"][4:]
+            elif state.process_index == 3:
+                # We return a list each time
+                assert results["a"] == data_copy["a"][-2:], f'Expected: {data_copy["a"][-2]}, Actual: {results["a"]}'
+            if state.process_index == 0:
+                assert results["b"] == data_copy["b"][: 8 // state.num_processes]
+            elif state.num_processes == 2:
+                assert results["b"] == data_copy["b"][4:]
+            elif state.process_index == 3:
+                assert results["b"] == data_copy["b"][-2:]
+            if state.process_index == 0:
+                assert torch.allclose(
+                    results["c"], data_copy["c"][: 8 // state.num_processes]
+                ), f"Did not obtain expected values on process 0, expected `{data['c'][:8 // state.num_processes]}`, received: {results['c']}"
+            elif state.num_processes == 2:
+                assert torch.allclose(
+                    results["c"], data_copy["c"][4:]
+                ), f"Did not obtain expected values on process 2, expected `{data['c'][4:]}`, received: {results['c']}"
+            elif state.process_index == 3:
+                assert torch.allclose(
+                    results["c"], data_copy["c"][-2:]
+                ), f"Did not obtain expected values on process 4, expected `{data['c'][-2:]}`, received: {results['c']}"
+
+    state.wait_for_everyone()
+
+
+def test_split_between_processes_tensor():
+    state = AcceleratorState()
+    if state.num_processes > 1:
+        data = torch.tensor([[0, 1, 2, 3], [4, 5, 6, 7]]).to(state.device)
+        with state.split_between_processes(data) as results:
+            if state.process_index == 0:
+                assert torch.allclose(results, torch.tensor([0, 1, 2, 3]).to(state.device))
+            else:
+                assert torch.allclose(results, torch.tensor([4, 5, 6, 7]).to(state.device))
+    state.wait_for_everyone()
+
+
+def test_trigger():
+    accelerator = Accelerator()
+    # should start with being false
+    assert accelerator.check_trigger() is False
+
+    # set a breakpoint on the main process
+    if accelerator.is_main_process:
+        accelerator.set_trigger()
+
+    # check it's been activated across all processes
+    # calls `all_reduce` and triggers a sync
+    assert accelerator.check_trigger() is True
+
+    # check it's been reset after the sync
+    assert accelerator.check_trigger() is False
+
+
+def test_reinstantiated_state():
+    import pytest
+
+    AcceleratorState._reset_state()
+    simple_model = torch.nn.Linear(1, 1)
+    # First define an accelerator
+    accelerator = Accelerator()
+    # Then call `reset_state`, breaking the state existing in the accelerator
+    AcceleratorState._reset_state()
+    # Now try and prepare a simple model, should raise the custom error early
+    with pytest.raises(AttributeError) as cm:
+        accelerator.prepare(simple_model)
+    assert "`AcceleratorState` object has no attribute" in str(cm.value.args[0])
+    assert "This happens if `AcceleratorState._reset_state()`" in str(cm.value.args[0])
+
+
+def main():
+    accelerator = Accelerator()
+    state = accelerator.state
+    if state.local_process_index == 0:
+        print("**Initialization**")
+    init_state_check()
+    state.wait_for_everyone()
+
+    if state.distributed_type == DistributedType.MULTI_GPU:
+        num_processes_per_node = torch.cuda.device_count()
+    else:
+        num_processes_per_node = state.num_processes
+
+    # We only run this test on non-multinode
+    if num_processes_per_node == state.num_processes:
+        if state.process_index == 0:
+            print("\n**Test process execution**")
+        process_execution_check()
+
+        if state.process_index == 0:
+            print("\n**Test split between processes as a list**")
+        test_split_between_processes_list()
+
+        if state.process_index == 0:
+            print("\n**Test split between processes as a dict**")
+        test_split_between_processes_nested_dict()
+
+        if state.process_index == 0:
+            print("\n**Test split between processes as a tensor**")
+        test_split_between_processes_tensor()
+
+        if state.process_index == 0:
+            print("\n**Test split between processes as a datasets.Dataset**")
+        if is_datasets_available():
+            from datasets import Dataset as datasets_Dataset
+
+            test_split_between_processes_dataset(datasets_Dataset)
+        else:
+            print("Skipped because Hugging Face datasets is not available")
+
+    if state.local_process_index == 0:
+        print("\n**Test random number generator synchronization**")
+    rng_sync_check()
+
+    if state.local_process_index == 0:
+        print("\n**DataLoader integration test**")
+    dl_preparation_check()
+    if state.distributed_type != DistributedType.XLA:
+        central_dl_preparation_check()
+        custom_sampler_check()
+        check_seedable_sampler()
+
+    if state.num_processes > 1:
+        check_seedable_sampler_in_batch_sampler_shard()
+
+    # Trainings are not exactly the same in DeepSpeed and CPU mode
+    if state.distributed_type == DistributedType.DEEPSPEED:
+        return
+
+    if state.local_process_index == 0:
+        print("\n**Training integration test**")
+    training_check(use_seedable_sampler=False)
+    training_check(use_seedable_sampler=True)
+
+    if state.local_process_index == 0:
+        print("\n**Breakpoint trigger test**")
+    test_trigger()
+
+    if state.local_process_index == 0:
+        print("\n**Test reinstantiated state**")
+    test_reinstantiated_state()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/test_utils/scripts/test_sync.py b/llm/Lib/site-packages/accelerate/test_utils/scripts/test_sync.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd458bcab8aaa42409a7c1234a4afffb087e8a7c
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/scripts/test_sync.py
@@ -0,0 +1,392 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from copy import deepcopy
+
+import torch
+import torch.nn.functional as F
+from torch.optim import AdamW
+from torch.optim.lr_scheduler import LambdaLR
+from torch.utils.data import DataLoader
+
+from accelerate.accelerator import Accelerator, GradientAccumulationPlugin
+from accelerate.state import GradientState
+from accelerate.test_utils import RegressionDataset, RegressionModel
+from accelerate.utils import DistributedType, set_seed
+
+
+def check_model_parameters(model_a, model_b, did_step, iteration, **kwargs):
+    for param, grad_param in zip(model_a.parameters(), model_b.parameters()):
+        if not param.requires_grad:
+            continue
+        if not did_step:
+            # Grads should not be in sync
+            assert (
+                torch.allclose(param.grad, grad_param.grad, **kwargs) is False
+            ), f"Gradients in sync when they should not be at iteration {iteration}:\nmodel_a grad ({param.grad}) == model_b grad ({grad_param.grad})"
+        else:
+            # Grads should be in sync
+            assert (
+                torch.allclose(param.grad, grad_param.grad, **kwargs) is True
+            ), f"Gradients not in sync when they should be at iteration {iteration}:\nmodel_a grad ({param.grad}) != model_b grad ({grad_param.grad})"
+
+
+def step_model(model, input, target, accelerator, do_backward=True):
+    model.train()
+    output = model(input)
+    loss = F.mse_loss(output, target.to(output.device))
+    if not do_backward:
+        loss /= accelerator.gradient_accumulation_steps
+        loss.backward()
+    else:
+        accelerator.backward(loss)
+
+
+def get_training_setup(accelerator, sched=False):
+    "Returns everything needed to perform basic training"
+    set_seed(42)
+    model = RegressionModel()
+    ddp_model = deepcopy(model)
+    dset = RegressionDataset(length=80)
+    dataloader = DataLoader(dset, batch_size=16)
+    model.to(accelerator.device)
+    if sched:
+        opt = AdamW(params=model.parameters(), lr=1e-3)
+        ddp_opt = AdamW(params=ddp_model.parameters(), lr=1e-3)
+        sched = LambdaLR(opt, lr_lambda=lambda epoch: epoch**0.65)
+        ddp_sched = LambdaLR(ddp_opt, lr_lambda=lambda epoch: epoch**0.65)
+    # Make a copy of `model`
+    if sched:
+        ddp_model, ddp_opt, ddp_sched, dataloader = accelerator.prepare(ddp_model, ddp_opt, ddp_sched, dataloader)
+    else:
+        ddp_model, dataloader = accelerator.prepare(ddp_model, dataloader)
+    if sched:
+        return (model, opt, sched, dataloader, ddp_model, ddp_opt, ddp_sched)
+    return model, ddp_model, dataloader
+
+
+def test_noop_sync(accelerator):
+    # Test when on a single CPU or GPU that the context manager does nothing
+    model, ddp_model, dataloader = get_training_setup(accelerator)
+    # Use a single batch
+    ddp_input, ddp_target = next(iter(dataloader)).values()
+    for iteration in range(3):
+        # Gather the distributed inputs and targs for the base model
+        input, target = accelerator.gather((ddp_input, ddp_target))
+        input, target = input.to(accelerator.device), target.to(accelerator.device)
+        # Perform our initial ground truth step in non "DDP"
+        step_model(model, input, target, accelerator)
+        # Do "gradient accumulation" (noop)
+        if iteration % 2 == 0:
+            # Accumulate grads locally
+            with accelerator.no_sync(ddp_model):
+                step_model(ddp_model, ddp_input, ddp_target, accelerator)
+        else:
+            # Sync grads
+            step_model(ddp_model, ddp_input, ddp_target, accelerator)
+
+        # Since `no_sync` is a noop, `ddp_model` and `model` grads should always be in sync
+        check_model_parameters(model, ddp_model, True, iteration)
+        for param, ddp_param in zip(model.parameters(), ddp_model.parameters()):
+            if not param.requires_grad:
+                continue
+            assert torch.allclose(
+                param.grad, ddp_param.grad
+            ), f"Gradients not in sync when they should be:\nModel grad ({param.grad}) != DDP grad ({ddp_param.grad})"
+
+        # Shuffle ddp_input on each iteration
+        torch.manual_seed(1337 + iteration)
+        ddp_input = ddp_input[torch.randperm(len(ddp_input))]
+
+
+def test_distributed_sync(accelerator):
+    # Test on distributed setup that context manager behaves properly
+    model, ddp_model, dataloader = get_training_setup(accelerator)
+    # Use a single batch
+    ddp_input, ddp_target = next(iter(dataloader)).values()
+    for iteration in range(3):
+        # Gather the distributed inputs and targs for the base model
+        input, target = accelerator.gather((ddp_input, ddp_target))
+        input, target = input.to(accelerator.device), target.to(accelerator.device)
+        # Perform our initial ground truth step in non "DDP"
+        step_model(model, input, target, accelerator)
+        # Do "gradient accumulation" (noop)
+        if iteration % 2 == 0:
+            # Accumulate grads locally
+            with accelerator.no_sync(ddp_model):
+                step_model(ddp_model, ddp_input, ddp_target, accelerator)
+        else:
+            # Sync grads
+            step_model(ddp_model, ddp_input, ddp_target, accelerator)
+
+        # DDP model and model should only be in sync when not (iteration % 2 == 0)
+        for param, ddp_param in zip(model.parameters(), ddp_model.parameters()):
+            if not param.requires_grad:
+                continue
+            if iteration % 2 == 0:
+                # Grads should not be in sync
+                assert (
+                    torch.allclose(param.grad, ddp_param.grad) is False
+                ), f"Gradients in sync when they should not be:\nModel grad ({param.grad}) == DDP grad ({ddp_param.grad})"
+            else:
+                # Grads should be in sync
+                assert (
+                    torch.allclose(param.grad, ddp_param.grad) is True
+                ), f"Gradients not in sync when they should be:\nModel grad ({param.grad}) != DDP grad ({ddp_param.grad})"
+
+        # Shuffle ddp_input on each iteration
+        torch.manual_seed(1337 + iteration)
+        ddp_input = ddp_input[torch.randperm(len(ddp_input))]
+
+
+def test_distributed_sync_multiple_fwd(accelerator):
+    # Test on distributed setup that context manager behaves properly when used with multiple forwards followed by multiple backwards
+    model, ddp_model, dataloader = get_training_setup(accelerator)
+    # Do multiple forwards
+    losses = []
+    num_iterations = 3
+    for iteration in range(num_iterations):
+        ddp_input, ddp_target = next(iter(dataloader)).values()
+
+        # Gather the distributed inputs and targs for the base model
+        input, target = accelerator.gather((ddp_input, ddp_target))
+        input, target = input.to(accelerator.device), target.to(accelerator.device)
+
+        # Perform our initial ground truth step in non "DDP"
+        step_model(model, input, target, accelerator)
+
+        # Accumulate grads locally
+        with accelerator.no_sync(ddp_model):
+            ddp_output = ddp_model(ddp_input)
+            loss = F.mse_loss(ddp_output, ddp_target.to(ddp_output.device))
+            losses.append(loss)
+
+    # Do multiple backwards and sync only at the last backward
+    for iteration in range(num_iterations):
+        loss = losses[iteration]
+
+        if iteration < num_iterations - 1:
+            # Accumulate grads locally
+            accelerator.backward(loss)
+
+            # DDP model and model should only be in sync after last backward
+            for param, ddp_param in zip(model.parameters(), ddp_model.parameters()):
+                if not param.requires_grad:
+                    continue
+                # Grads should not be in sync
+                assert (
+                    torch.allclose(param.grad, ddp_param.grad) is False
+                ), f"Gradients in sync when they should not be:\nModel grad ({param.grad}) == DDP grad ({ddp_param.grad})"
+
+        else:
+            # Sync grads if last backward
+            with accelerator.trigger_sync_in_backward(ddp_model):
+                accelerator.backward(loss)
+
+            # DDP model and model should only be in sync after last backward
+            for param, ddp_param in zip(model.parameters(), ddp_model.parameters()):
+                if not param.requires_grad:
+                    continue
+                # Grads should be in sync
+                assert (
+                    torch.allclose(param.grad, ddp_param.grad) is True
+                ), f"Gradients not in sync when they should be:\nModel grad ({param.grad}) != DDP grad ({ddp_param.grad})"
+
+
+def test_gradient_accumulation(split_batches=False, dispatch_batches=False, sync_each_batch=False):
+    gradient_accumulation_plugin = GradientAccumulationPlugin(num_steps=2, sync_each_batch=sync_each_batch)
+    accelerator = Accelerator(
+        split_batches=split_batches,
+        dispatch_batches=dispatch_batches,
+        gradient_accumulation_plugin=gradient_accumulation_plugin,
+    )
+    # Test that context manager behaves properly
+    model, ddp_model, dataloader = get_training_setup(accelerator)
+    for iteration, batch in enumerate(dataloader):
+        ddp_input, ddp_target = batch.values()
+        # Gather the distributed inputs and targs for the base model
+        input, target = accelerator.gather((ddp_input, ddp_target))
+        input, target = input.to(accelerator.device), target.to(accelerator.device)
+        # Perform our initial ground truth step in non "DDP"
+        step_model(model, input, target, accelerator, False)
+        # Do "gradient accumulation" (noop)
+        with accelerator.accumulate(ddp_model):
+            step_model(ddp_model, ddp_input, ddp_target, accelerator)
+
+        # DDP model and model should only be in sync when not (iteration % 2 == 0)
+        for param, ddp_param in zip(model.parameters(), ddp_model.parameters()):
+            if not param.requires_grad:
+                continue
+            if ((iteration + 1) % 2 == 0) or (iteration == len(dataloader) - 1) or sync_each_batch:
+                # Grads should be in sync
+                assert (
+                    torch.allclose(param.grad, ddp_param.grad) is True
+                ), f"Gradients not in sync when they should be at iteration {iteration}:\nModel grad ({param.grad}) != DDP grad ({ddp_param.grad})"
+            else:
+                # Grads should not be in sync
+                assert (
+                    torch.allclose(param.grad, ddp_param.grad) is False
+                ), f"Gradients in sync when they should not be at iteration {iteration}:\nModel grad ({param.grad}) == DDP grad ({ddp_param.grad})"
+
+        # Shuffle ddp_input on each iteration
+        torch.manual_seed(1337 + iteration)
+        ddp_input = ddp_input[torch.randperm(len(ddp_input))]
+    GradientState._reset_state()
+
+
+def test_gradient_accumulation_with_opt_and_scheduler(
+    split_batches=False, dispatch_batches=False, sync_each_batch=False
+):
+    gradient_accumulation_plugin = GradientAccumulationPlugin(num_steps=2, sync_each_batch=sync_each_batch)
+    accelerator = Accelerator(
+        split_batches=split_batches,
+        dispatch_batches=dispatch_batches,
+        gradient_accumulation_plugin=gradient_accumulation_plugin,
+    )
+    # Test that context manager behaves properly
+    model, opt, sched, dataloader, ddp_model, ddp_opt, ddp_sched = get_training_setup(accelerator, True)
+    for iteration, batch in enumerate(dataloader):
+        ddp_input, ddp_target = batch.values()
+        # Gather the distributed inputs and targs for the base model
+        input, target = accelerator.gather((ddp_input, ddp_target))
+        input, target = input.to(accelerator.device), target.to(accelerator.device)
+        # Perform our initial ground truth step in non "DDP"
+        model.train()
+        ddp_model.train()
+        step_model(model, input, target, accelerator, False)
+        opt.step()
+
+        if ((iteration + 1) % 2 == 0) or ((iteration + 1) == len(dataloader)) or sync_each_batch:
+            if split_batches:
+                sched.step()
+            else:
+                for _ in range(accelerator.num_processes):
+                    sched.step()
+
+        # Perform gradient accumulation under wrapper
+        with accelerator.accumulate(ddp_model):
+            step_model(ddp_model, ddp_input, ddp_target, accelerator)
+            ddp_opt.step()
+            ddp_sched.step()
+
+        # Learning rates should be the same
+        assert (
+            opt.param_groups[0]["lr"] == ddp_opt.param_groups[0]["lr"]
+        ), f'Learning rates found in each optimizer did not align\nopt: {opt.param_groups[0]["lr"]}\nDDP opt: {ddp_opt.param_groups[0]["lr"]}\n'
+        did_step = (((iteration + 1) % 2) == 0) or ((iteration + 1) == len(dataloader)) or sync_each_batch
+        if accelerator.num_processes > 1:
+            check_model_parameters(
+                model,
+                ddp_model,
+                did_step,
+                iteration,
+                rtol=1e-3,  # somehow needs a relative tolerance
+            )
+
+        if ((iteration + 1) % 2 == 0) or ((iteration + 1) == len(dataloader)) or sync_each_batch:
+            opt.zero_grad()  # needs to be guarded by logic as to when we should zero grads
+        ddp_opt.zero_grad()
+
+        # Shuffle ddp_input on each iteration
+        torch.manual_seed(1337 + iteration)
+    GradientState._reset_state()
+
+
+def test_dataloader_break():
+    accelerator = Accelerator()
+
+    first_dset = RegressionDataset(length=80)
+    first_dataloader = DataLoader(first_dset, batch_size=16)
+    second_dset = RegressionDataset(length=96)
+    second_dataloader = DataLoader(second_dset, batch_size=16)
+    first_dataloader, second_dataloader = accelerator.prepare(first_dataloader, second_dataloader)
+    assert accelerator.gradient_state.active_dataloader is None
+    for iteration, _ in enumerate(first_dataloader):
+        assert id(accelerator.gradient_state.active_dataloader) == id(first_dataloader)
+        if iteration < len(first_dataloader) - 1:
+            assert not accelerator.gradient_state.end_of_dataloader
+            if iteration == 1:
+                for batch_num, _ in enumerate(second_dataloader):
+                    assert id(accelerator.gradient_state.active_dataloader) == id(second_dataloader)
+                    if batch_num < len(second_dataloader) - 1:
+                        assert not accelerator.gradient_state.end_of_dataloader
+                    else:
+                        assert accelerator.gradient_state.end_of_dataloader
+        else:
+            assert accelerator.gradient_state.end_of_dataloader
+    assert accelerator.gradient_state.active_dataloader is None
+
+
+def main():
+    accelerator = Accelerator()
+    state = accelerator.state
+    if state.local_process_index == 0:
+        print("**Test `accumulate` gradient accumulation with dataloader break**")
+    if state.distributed_type != DistributedType.XLA:
+        test_dataloader_break()
+    if state.distributed_type == DistributedType.NO:
+        if state.local_process_index == 0:
+            print("**Test NOOP `no_sync` context manager**")
+        test_noop_sync(accelerator)
+    if state.distributed_type in (
+        DistributedType.MULTI_GPU,
+        DistributedType.MULTI_NPU,
+        DistributedType.MULTI_MLU,
+        DistributedType.MULTI_CPU,
+    ):
+        if state.local_process_index == 0:
+            print("**Test Distributed `no_sync` context manager**")
+        test_distributed_sync(accelerator)
+        if state.local_process_index == 0:
+            print("**Test Distributed `no_sync` context manager with multiple forwards**")
+        test_distributed_sync_multiple_fwd(accelerator)
+    if state.distributed_type in (DistributedType.MULTI_GPU, DistributedType.MULTI_NPU, DistributedType.MULTI_MLU):
+        for split_batch in [True, False]:
+            for dispatch_batches in [True, False]:
+                for sync_each_batch in [True, False]:
+                    if state.local_process_index == 0:
+                        print(
+                            "**Test `accumulate` gradient accumulation, ",
+                            f"`split_batches={split_batch}` and `dispatch_batches={dispatch_batches}` and `sync_each_batch={sync_each_batch}`**",
+                        )
+                    test_gradient_accumulation(split_batch, dispatch_batches, sync_each_batch)
+
+    # Currently will break on torch 2.0 +, need to investigate why
+    if state.local_process_index == 0:
+        print(
+            "**Test `accumulate` gradient accumulation with optimizer and scheduler, ",
+            "`split_batches=False`, `dispatch_batches=False`, `sync_each_batch=False`**",
+        )
+    test_gradient_accumulation_with_opt_and_scheduler()
+    if state.distributed_type in (DistributedType.MULTI_GPU, DistributedType.MULTI_NPU, DistributedType.MULTI_MLU):
+        for split_batch in [True, False]:
+            for dispatch_batches in [True, False]:
+                for sync_each_batch in [True, False]:
+                    if not split_batch and not dispatch_batches and not sync_each_batch:
+                        continue
+                    if state.local_process_index == 0:
+                        print(
+                            "**Test `accumulate` gradient accumulation with optimizer and scheduler, ",
+                            f"`split_batches={split_batch}` and `dispatch_batches={dispatch_batches}` and `sync_each_batch={sync_each_batch}`**",
+                        )
+                    test_gradient_accumulation_with_opt_and_scheduler(split_batch, dispatch_batches, sync_each_batch)
+
+
+def _mp_fn(index):
+    # For xla_spawn (TPUs)
+    main()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/accelerate/test_utils/testing.py b/llm/Lib/site-packages/accelerate/test_utils/testing.py
new file mode 100644
index 0000000000000000000000000000000000000000..179fff4808a1c36fcdc8026a617a4cad549bd796
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/testing.py
@@ -0,0 +1,605 @@
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import asyncio
+import inspect
+import os
+import shutil
+import subprocess
+import sys
+import tempfile
+import unittest
+from contextlib import contextmanager
+from functools import partial
+from pathlib import Path
+from typing import List, Union
+from unittest import mock
+
+import torch
+
+import accelerate
+
+from ..state import AcceleratorState, PartialState
+from ..utils import (
+    gather,
+    is_bnb_available,
+    is_clearml_available,
+    is_comet_ml_available,
+    is_cuda_available,
+    is_datasets_available,
+    is_deepspeed_available,
+    is_dvclive_available,
+    is_mlu_available,
+    is_mps_available,
+    is_npu_available,
+    is_pandas_available,
+    is_pippy_available,
+    is_tensorboard_available,
+    is_timm_available,
+    is_torch_version,
+    is_torch_xla_available,
+    is_transformers_available,
+    is_wandb_available,
+    is_xpu_available,
+    str_to_bool,
+)
+
+
+def get_backend():
+    if is_torch_xla_available():
+        return "xla", torch.cuda.device_count(), torch.cuda.memory_allocated
+    elif is_cuda_available():
+        return "cuda", torch.cuda.device_count(), torch.cuda.memory_allocated
+    elif is_mps_available():
+        return "mps", 1, torch.mps.current_allocated_memory()
+    elif is_mlu_available():
+        return "mlu", torch.mlu.device_count(), torch.mlu.memory_allocated
+    elif is_npu_available():
+        return "npu", torch.npu.device_count(), torch.npu.memory_allocated
+    elif is_xpu_available():
+        return "xpu", torch.xpu.device_count(), torch.xpu.memory_allocated
+    else:
+        return "cpu", 1, 0
+
+
+torch_device, device_count, memory_allocated_func = get_backend()
+
+
+def get_launch_command(**kwargs) -> list:
+    """
+    Wraps around `kwargs` to help simplify launching from `subprocess`.
+
+    Example:
+    ```python
+    # returns ['accelerate', 'launch', '--num_processes=2', '--device_count=2']
+    get_launch_command(num_processes=2, device_count=2)
+    ```
+    """
+    command = ["accelerate", "launch"]
+    for k, v in kwargs.items():
+        if isinstance(v, bool) and v:
+            command.append(f"--{k}")
+        elif v is not None:
+            command.append(f"--{k}={v}")
+    return command
+
+
+DEFAULT_LAUNCH_COMMAND = get_launch_command(num_processes=device_count)
+
+
+def parse_flag_from_env(key, default=False):
+    try:
+        value = os.environ[key]
+    except KeyError:
+        # KEY isn't set, default to `default`.
+        _value = default
+    else:
+        # KEY is set, convert it to True or False.
+        try:
+            _value = str_to_bool(value)
+        except ValueError:
+            # More values are supported, but let's keep the message simple.
+            raise ValueError(f"If set, {key} must be yes or no.")
+    return _value
+
+
+_run_slow_tests = parse_flag_from_env("RUN_SLOW", default=False)
+
+
+def skip(test_case):
+    "Decorator that skips a test unconditionally"
+    return unittest.skip("Test was skipped")(test_case)
+
+
+def slow(test_case):
+    """
+    Decorator marking a test as slow. Slow tests are skipped by default. Set the RUN_SLOW environment variable to a
+    truthy value to run them.
+    """
+    return unittest.skipUnless(_run_slow_tests, "test is slow")(test_case)
+
+
+def require_cpu(test_case):
+    """
+    Decorator marking a test that must be only ran on the CPU. These tests are skipped when a GPU is available.
+    """
+    return unittest.skipUnless(torch_device == "cpu", "test requires only a CPU")(test_case)
+
+
+def require_non_cpu(test_case):
+    """
+    Decorator marking a test that requires a hardware accelerator backend. These tests are skipped when there are no
+    hardware accelerator available.
+    """
+    return unittest.skipUnless(torch_device != "cpu", "test requires a GPU")(test_case)
+
+
+def require_cuda(test_case):
+    """
+    Decorator marking a test that requires CUDA. These tests are skipped when there are no GPU available or when
+    TorchXLA is available.
+    """
+    return unittest.skipUnless(is_cuda_available() and not is_torch_xla_available(), "test requires a GPU")(test_case)
+
+
+def require_xpu(test_case):
+    """
+    Decorator marking a test that requires XPU. These tests are skipped when there are no XPU available.
+    """
+    return unittest.skipUnless(is_xpu_available(), "test requires a XPU")(test_case)
+
+
+def require_non_xpu(test_case):
+    """
+    Decorator marking a test that should be skipped for XPU.
+    """
+    return unittest.skipUnless(torch_device != "xpu", "test requires a non-XPU")(test_case)
+
+
+def require_mlu(test_case):
+    """
+    Decorator marking a test that requires MLU. These tests are skipped when there are no MLU available.
+    """
+    return unittest.skipUnless(is_mlu_available(), "test require a MLU")(test_case)
+
+
+def require_npu(test_case):
+    """
+    Decorator marking a test that requires NPU. These tests are skipped when there are no NPU available.
+    """
+    return unittest.skipUnless(is_npu_available(), "test require a NPU")(test_case)
+
+
+def require_mps(test_case):
+    """
+    Decorator marking a test that requires MPS backend. These tests are skipped when torch doesn't support `mps`
+    backend.
+    """
+    return unittest.skipUnless(is_mps_available(), "test requires a `mps` backend support in `torch`")(test_case)
+
+
+def require_huggingface_suite(test_case):
+    """
+    Decorator marking a test that requires transformers and datasets. These tests are skipped when they are not.
+    """
+    return unittest.skipUnless(
+        is_transformers_available() and is_datasets_available(),
+        "test requires the Hugging Face suite",
+    )(test_case)
+
+
+def require_transformers(test_case):
+    """
+    Decorator marking a test that requires transformers. These tests are skipped when they are not.
+    """
+    return unittest.skipUnless(is_transformers_available(), "test requires the transformers library")(test_case)
+
+
+def require_timm(test_case):
+    """
+    Decorator marking a test that requires transformers. These tests are skipped when they are not.
+    """
+    return unittest.skipUnless(is_timm_available(), "test requires the timm library")(test_case)
+
+
+def require_bnb(test_case):
+    """
+    Decorator marking a test that requires bitsandbytes. These tests are skipped when they are not.
+    """
+    return unittest.skipUnless(is_bnb_available(), "test requires the bitsandbytes library")(test_case)
+
+
+def require_tpu(test_case):
+    """
+    Decorator marking a test that requires TPUs. These tests are skipped when there are no TPUs available.
+    """
+    return unittest.skipUnless(is_torch_xla_available(check_is_tpu=True), "test requires TPU")(test_case)
+
+
+def require_non_torch_xla(test_case):
+    """
+    Decorator marking a test as requiring an environment without TorchXLA. These tests are skipped when TorchXLA is
+    available.
+    """
+    return unittest.skipUnless(not is_torch_xla_available(), "test requires an env without TorchXLA")(test_case)
+
+
+def require_single_device(test_case):
+    """
+    Decorator marking a test that requires a single device. These tests are skipped when there is no hardware
+    accelerator available or number of devices is more than one.
+    """
+    return unittest.skipUnless(torch_device != "cpu" and device_count == 1, "test requires a hardware accelerator")(
+        test_case
+    )
+
+
+def require_single_gpu(test_case):
+    """
+    Decorator marking a test that requires CUDA on a single GPU. These tests are skipped when there are no GPU
+    available or number of GPUs is more than one.
+    """
+    return unittest.skipUnless(torch.cuda.device_count() == 1, "test requires a GPU")(test_case)
+
+
+def require_single_xpu(test_case):
+    """
+    Decorator marking a test that requires CUDA on a single XPU. These tests are skipped when there are no XPU
+    available or number of xPUs is more than one.
+    """
+    return unittest.skipUnless(torch.xpu.device_count() == 1, "test requires a XPU")(test_case)
+
+
+def require_multi_device(test_case):
+    """
+    Decorator marking a test that requires a multi-device setup. These tests are skipped on a machine without multiple
+    devices.
+    """
+    return unittest.skipUnless(device_count > 1, "test requires multiple hardware accelerators")(test_case)
+
+
+def require_multi_gpu(test_case):
+    """
+    Decorator marking a test that requires a multi-GPU setup. These tests are skipped on a machine without multiple
+    GPUs.
+    """
+    return unittest.skipUnless(torch.cuda.device_count() > 1, "test requires multiple GPUs")(test_case)
+
+
+def require_multi_xpu(test_case):
+    """
+    Decorator marking a test that requires a multi-XPU setup. These tests are skipped on a machine without multiple
+    XPUs.
+    """
+    return unittest.skipUnless(torch.xpu.device_count() > 1, "test requires multiple XPUs")(test_case)
+
+
+def require_deepspeed(test_case):
+    """
+    Decorator marking a test that requires DeepSpeed installed. These tests are skipped when DeepSpeed isn't installed
+    """
+    return unittest.skipUnless(is_deepspeed_available(), "test requires DeepSpeed")(test_case)
+
+
+def require_fsdp(test_case):
+    """
+    Decorator marking a test that requires FSDP installed. These tests are skipped when FSDP isn't installed
+    """
+    return unittest.skipUnless(is_torch_version(">=", "1.12.0"), "test requires torch version >= 1.12.0")(test_case)
+
+
+def require_torch_min_version(test_case=None, version=None):
+    """
+    Decorator marking that a test requires a particular torch version to be tested. These tests are skipped when an
+    installed torch version is less than the required one.
+    """
+    if test_case is None:
+        return partial(require_torch_min_version, version=version)
+    return unittest.skipUnless(is_torch_version(">=", version), f"test requires torch version >= {version}")(test_case)
+
+
+def require_tensorboard(test_case):
+    """
+    Decorator marking a test that requires tensorboard installed. These tests are skipped when tensorboard isn't
+    installed
+    """
+    return unittest.skipUnless(is_tensorboard_available(), "test requires Tensorboard")(test_case)
+
+
+def require_wandb(test_case):
+    """
+    Decorator marking a test that requires wandb installed. These tests are skipped when wandb isn't installed
+    """
+    return unittest.skipUnless(is_wandb_available(), "test requires wandb")(test_case)
+
+
+def require_comet_ml(test_case):
+    """
+    Decorator marking a test that requires comet_ml installed. These tests are skipped when comet_ml isn't installed
+    """
+    return unittest.skipUnless(is_comet_ml_available(), "test requires comet_ml")(test_case)
+
+
+def require_clearml(test_case):
+    """
+    Decorator marking a test that requires clearml installed. These tests are skipped when clearml isn't installed
+    """
+    return unittest.skipUnless(is_clearml_available(), "test requires clearml")(test_case)
+
+
+def require_dvclive(test_case):
+    """
+    Decorator marking a test that requires dvclive installed. These tests are skipped when dvclive isn't installed
+    """
+    return unittest.skipUnless(is_dvclive_available(), "test requires dvclive")(test_case)
+
+
+def require_pandas(test_case):
+    """
+    Decorator marking a test that requires pandas installed. These tests are skipped when pandas isn't installed
+    """
+    return unittest.skipUnless(is_pandas_available(), "test requires pandas")(test_case)
+
+
+def require_pippy(test_case):
+    """
+    Decorator marking a test that requires pippy installed. These tests are skipped when pippy isn't installed
+    """
+    return unittest.skipUnless(is_pippy_available(), "test requires pippy")(test_case)
+
+
+_atleast_one_tracker_available = (
+    any([is_wandb_available(), is_tensorboard_available()]) and not is_comet_ml_available()
+)
+
+
+def require_trackers(test_case):
+    """
+    Decorator marking that a test requires at least one tracking library installed. These tests are skipped when none
+    are installed
+    """
+    return unittest.skipUnless(
+        _atleast_one_tracker_available,
+        "test requires at least one tracker to be available and for `comet_ml` to not be installed",
+    )(test_case)
+
+
+class TempDirTestCase(unittest.TestCase):
+    """
+    A TestCase class that keeps a single `tempfile.TemporaryDirectory` open for the duration of the class, wipes its
+    data at the start of a test, and then destroyes it at the end of the TestCase.
+
+    Useful for when a class or API requires a single constant folder throughout it's use, such as Weights and Biases
+
+    The temporary directory location will be stored in `self.tmpdir`
+    """
+
+    clear_on_setup = True
+
+    @classmethod
+    def setUpClass(cls):
+        "Creates a `tempfile.TemporaryDirectory` and stores it in `cls.tmpdir`"
+        cls.tmpdir = Path(tempfile.mkdtemp())
+
+    @classmethod
+    def tearDownClass(cls):
+        "Remove `cls.tmpdir` after test suite has finished"
+        if os.path.exists(cls.tmpdir):
+            shutil.rmtree(cls.tmpdir)
+
+    def setUp(self):
+        "Destroy all contents in `self.tmpdir`, but not `self.tmpdir`"
+        if self.clear_on_setup:
+            for path in self.tmpdir.glob("**/*"):
+                if path.is_file():
+                    path.unlink()
+                elif path.is_dir():
+                    shutil.rmtree(path)
+
+
+class AccelerateTestCase(unittest.TestCase):
+    """
+    A TestCase class that will reset the accelerator state at the end of every test. Every test that checks or utilizes
+    the `AcceleratorState` class should inherit from this to avoid silent failures due to state being shared between
+    tests.
+    """
+
+    def tearDown(self):
+        super().tearDown()
+        # Reset the state of the AcceleratorState singleton.
+        AcceleratorState._reset_state()
+        PartialState._reset_state()
+
+
+class MockingTestCase(unittest.TestCase):
+    """
+    A TestCase class designed to dynamically add various mockers that should be used in every test, mimicking the
+    behavior of a class-wide mock when defining one normally will not do.
+
+    Useful when a mock requires specific information available only initialized after `TestCase.setUpClass`, such as
+    setting an environment variable with that information.
+
+    The `add_mocks` function should be ran at the end of a `TestCase`'s `setUp` function, after a call to
+    `super().setUp()` such as:
+    ```python
+    def setUp(self):
+        super().setUp()
+        mocks = mock.patch.dict(os.environ, {"SOME_ENV_VAR", "SOME_VALUE"})
+        self.add_mocks(mocks)
+    ```
+    """
+
+    def add_mocks(self, mocks: Union[mock.Mock, List[mock.Mock]]):
+        """
+        Add custom mocks for tests that should be repeated on each test. Should be called during
+        `MockingTestCase.setUp`, after `super().setUp()`.
+
+        Args:
+            mocks (`mock.Mock` or list of `mock.Mock`):
+                Mocks that should be added to the `TestCase` after `TestCase.setUpClass` has been run
+        """
+        self.mocks = mocks if isinstance(mocks, (tuple, list)) else [mocks]
+        for m in self.mocks:
+            m.start()
+            self.addCleanup(m.stop)
+
+
+def are_the_same_tensors(tensor):
+    state = AcceleratorState()
+    tensor = tensor[None].clone().to(state.device)
+    tensors = gather(tensor).cpu()
+    tensor = tensor[0].cpu()
+    for i in range(tensors.shape[0]):
+        if not torch.equal(tensors[i], tensor):
+            return False
+    return True
+
+
+class _RunOutput:
+    def __init__(self, returncode, stdout, stderr):
+        self.returncode = returncode
+        self.stdout = stdout
+        self.stderr = stderr
+
+
+async def _read_stream(stream, callback):
+    while True:
+        line = await stream.readline()
+        if line:
+            callback(line)
+        else:
+            break
+
+
+async def _stream_subprocess(cmd, env=None, stdin=None, timeout=None, quiet=False, echo=False) -> _RunOutput:
+    if echo:
+        print("\nRunning: ", " ".join(cmd))
+
+    p = await asyncio.create_subprocess_exec(
+        cmd[0],
+        *cmd[1:],
+        stdin=stdin,
+        stdout=asyncio.subprocess.PIPE,
+        stderr=asyncio.subprocess.PIPE,
+        env=env,
+    )
+
+    # note: there is a warning for a possible deadlock when using `wait` with huge amounts of data in the pipe
+    # https://docs.python.org/3/library/asyncio-subprocess.html#asyncio.asyncio.subprocess.Process.wait
+    #
+    # If it starts hanging, will need to switch to the following code. The problem is that no data
+    # will be seen until it's done and if it hangs for example there will be no debug info.
+    # out, err = await p.communicate()
+    # return _RunOutput(p.returncode, out, err)
+
+    out = []
+    err = []
+
+    def tee(line, sink, pipe, label=""):
+        line = line.decode("utf-8").rstrip()
+        sink.append(line)
+        if not quiet:
+            print(label, line, file=pipe)
+
+    # XXX: the timeout doesn't seem to make any difference here
+    await asyncio.wait(
+        [
+            asyncio.create_task(_read_stream(p.stdout, lambda l: tee(l, out, sys.stdout, label="stdout:"))),
+            asyncio.create_task(_read_stream(p.stderr, lambda l: tee(l, err, sys.stderr, label="stderr:"))),
+        ],
+        timeout=timeout,
+    )
+    return _RunOutput(await p.wait(), out, err)
+
+
+def execute_subprocess_async(cmd: list, env=None, stdin=None, timeout=180, quiet=False, echo=True) -> _RunOutput:
+    # Cast every path in `cmd` to a string
+    for i, c in enumerate(cmd):
+        if isinstance(c, Path):
+            cmd[i] = str(c)
+    loop = asyncio.get_event_loop()
+    result = loop.run_until_complete(
+        _stream_subprocess(cmd, env=env, stdin=stdin, timeout=timeout, quiet=quiet, echo=echo)
+    )
+
+    cmd_str = " ".join(cmd)
+    if result.returncode > 0:
+        stderr = "\n".join(result.stderr)
+        raise RuntimeError(
+            f"'{cmd_str}' failed with returncode {result.returncode}\n\n"
+            f"The combined stderr from workers follows:\n{stderr}"
+        )
+
+    return result
+
+
+class SubprocessCallException(Exception):
+    pass
+
+
+def run_command(command: List[str], return_stdout=False, env=None):
+    """
+    Runs `command` with `subprocess.check_output` and will potentially return the `stdout`. Will also properly capture
+    if an error occured while running `command`
+    """
+    # Cast every path in `command` to a string
+    for i, c in enumerate(command):
+        if isinstance(c, Path):
+            command[i] = str(c)
+    if env is None:
+        env = os.environ.copy()
+    try:
+        output = subprocess.check_output(command, stderr=subprocess.STDOUT, env=env)
+        if return_stdout:
+            if hasattr(output, "decode"):
+                output = output.decode("utf-8")
+            return output
+    except subprocess.CalledProcessError as e:
+        raise SubprocessCallException(
+            f"Command `{' '.join(command)}` failed with the following error:\n\n{e.output.decode()}"
+        ) from e
+
+
+def path_in_accelerate_package(*components: str) -> Path:
+    """
+    Get a path within the `accelerate` package's directory.
+
+    Args:
+        *components: Components of the path to join after the package directory.
+
+    Returns:
+        `Path`: The path to the requested file or directory.
+    """
+
+    accelerate_package_dir = Path(inspect.getfile(accelerate)).parent
+    return accelerate_package_dir.joinpath(*components)
+
+
+@contextmanager
+def assert_exception(exception_class: Exception, msg: str = None) -> bool:
+    """
+    Context manager to assert that the right `Exception` class was raised.
+
+    If `msg` is provided, will check that the message is contained in the raised exception.
+    """
+    was_ran = False
+    try:
+        yield
+        was_ran = True
+    except Exception as e:
+        assert isinstance(e, exception_class), f"Expected exception of type {exception_class} but got {type(e)}"
+        if msg is not None:
+            assert msg in str(e), f"Expected message '{msg}' to be in exception but got '{str(e)}'"
+    if was_ran:
+        raise AssertionError(f"Expected exception of type {exception_class} but ran without issue.")
diff --git a/llm/Lib/site-packages/accelerate/test_utils/training.py b/llm/Lib/site-packages/accelerate/test_utils/training.py
new file mode 100644
index 0000000000000000000000000000000000000000..d89cfd3c71546871d00cb9c2a5cd07494c46cbfe
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/test_utils/training.py
@@ -0,0 +1,101 @@
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import numpy as np
+import torch
+from torch.utils.data import DataLoader
+
+from accelerate.utils.dataclasses import DistributedType
+
+
+class RegressionDataset:
+    def __init__(self, a=2, b=3, length=64, seed=None):
+        rng = np.random.default_rng(seed)
+        self.length = length
+        self.x = rng.normal(size=(length,)).astype(np.float32)
+        self.y = a * self.x + b + rng.normal(scale=0.1, size=(length,)).astype(np.float32)
+
+    def __len__(self):
+        return self.length
+
+    def __getitem__(self, i):
+        return {"x": self.x[i], "y": self.y[i]}
+
+
+class RegressionModel4XPU(torch.nn.Module):
+    def __init__(self, a=0, b=0, double_output=False):
+        super().__init__()
+        self.a = torch.nn.Parameter(torch.tensor([2, 3]).float())
+        self.b = torch.nn.Parameter(torch.tensor([2, 3]).float())
+        self.first_batch = True
+
+    def forward(self, x=None):
+        if self.first_batch:
+            print(f"Model dtype: {self.a.dtype}, {self.b.dtype}. Input dtype: {x.dtype}")
+            self.first_batch = False
+        return x * self.a[0] + self.b[0]
+
+
+class RegressionModel(torch.nn.Module):
+    def __init__(self, a=0, b=0, double_output=False):
+        super().__init__()
+        self.a = torch.nn.Parameter(torch.tensor(a).float())
+        self.b = torch.nn.Parameter(torch.tensor(b).float())
+        self.first_batch = True
+
+    def forward(self, x=None):
+        if self.first_batch:
+            print(f"Model dtype: {self.a.dtype}, {self.b.dtype}. Input dtype: {x.dtype}")
+            self.first_batch = False
+        return x * self.a + self.b
+
+
+def mocked_dataloaders(accelerator, batch_size: int = 16):
+    from datasets import load_dataset
+    from transformers import AutoTokenizer
+
+    tokenizer = AutoTokenizer.from_pretrained("bert-base-cased")
+    data_files = {"train": "tests/test_samples/MRPC/train.csv", "validation": "tests/test_samples/MRPC/dev.csv"}
+    datasets = load_dataset("csv", data_files=data_files)
+    label_list = datasets["train"].unique("label")
+
+    label_to_id = {v: i for i, v in enumerate(label_list)}
+
+    def tokenize_function(examples):
+        # max_length=None => use the model max length (it's actually the default)
+        outputs = tokenizer(
+            examples["sentence1"], examples["sentence2"], truncation=True, max_length=None, padding="max_length"
+        )
+        if "label" in examples:
+            outputs["labels"] = [label_to_id[l] for l in examples["label"]]
+        return outputs
+
+    # Apply the method we just defined to all the examples in all the splits of the dataset
+    tokenized_datasets = datasets.map(
+        tokenize_function,
+        batched=True,
+        remove_columns=["sentence1", "sentence2", "label"],
+    )
+
+    def collate_fn(examples):
+        # On TPU it's best to pad everything to the same length or training will be very slow.
+        if accelerator.distributed_type == DistributedType.XLA:
+            return tokenizer.pad(examples, padding="max_length", max_length=128, return_tensors="pt")
+        return tokenizer.pad(examples, padding="longest", return_tensors="pt")
+
+    # Instantiate dataloaders.
+    train_dataloader = DataLoader(tokenized_datasets["train"], shuffle=True, collate_fn=collate_fn, batch_size=2)
+    eval_dataloader = DataLoader(tokenized_datasets["validation"], shuffle=False, collate_fn=collate_fn, batch_size=1)
+
+    return train_dataloader, eval_dataloader
diff --git a/llm/Lib/site-packages/accelerate/tracking.py b/llm/Lib/site-packages/accelerate/tracking.py
new file mode 100644
index 0000000000000000000000000000000000000000..5efba19bc6769d9c70ea8b17b8da784b908f529f
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/tracking.py
@@ -0,0 +1,1023 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Expectation:
+# Provide a project dir name, then each type of logger gets stored in project/{`logging_dir`}
+
+import json
+import os
+import time
+from functools import wraps
+from typing import Any, Dict, List, Optional, Union
+
+import yaml
+
+from .logging import get_logger
+from .state import PartialState
+from .utils import (
+    LoggerType,
+    is_aim_available,
+    is_clearml_available,
+    is_comet_ml_available,
+    is_dvclive_available,
+    is_mlflow_available,
+    is_tensorboard_available,
+    is_wandb_available,
+    listify,
+)
+
+
+_available_trackers = []
+
+if is_tensorboard_available():
+    _available_trackers.append(LoggerType.TENSORBOARD)
+
+if is_wandb_available():
+    _available_trackers.append(LoggerType.WANDB)
+
+if is_comet_ml_available():
+    _available_trackers.append(LoggerType.COMETML)
+
+if is_aim_available():
+    _available_trackers.append(LoggerType.AIM)
+
+if is_mlflow_available():
+    _available_trackers.append(LoggerType.MLFLOW)
+
+if is_clearml_available():
+    _available_trackers.append(LoggerType.CLEARML)
+
+if is_dvclive_available():
+    _available_trackers.append(LoggerType.DVCLIVE)
+
+logger = get_logger(__name__)
+
+
+def on_main_process(function):
+    """
+    Decorator to selectively run the decorated function on the main process only based on the `main_process_only`
+    attribute in a class.
+
+    Checks at function execution rather than initialization time, not triggering the initialization of the
+    `PartialState`.
+    """
+
+    @wraps(function)
+    def execute_on_main_process(self, *args, **kwargs):
+        if getattr(self, "main_process_only", False):
+            return PartialState().on_main_process(function)(self, *args, **kwargs)
+        else:
+            return function(self, *args, **kwargs)
+
+    return execute_on_main_process
+
+
+def get_available_trackers():
+    "Returns a list of all supported available trackers in the system"
+    return _available_trackers
+
+
+class GeneralTracker:
+    """
+    A base Tracker class to be used for all logging integration implementations.
+
+    Each function should take in `**kwargs` that will automatically be passed in from a base dictionary provided to
+    [`Accelerator`].
+
+    Should implement `name`, `requires_logging_directory`, and `tracker` properties such that:
+
+    `name` (`str`): String representation of the tracker class name, such as "TensorBoard" `requires_logging_directory`
+    (`bool`): Whether the logger requires a directory to store their logs. `tracker` (`object`): Should return internal
+    tracking mechanism used by a tracker class (such as the `run` for wandb)
+
+    Implementations can also include a `main_process_only` (`bool`) attribute to toggle if relevent logging, init, and
+    other functions should occur on the main process or across all processes (by default will use `True`)
+    """
+
+    main_process_only = True
+
+    def __init__(self, _blank=False):
+        if not _blank:
+            err = ""
+            if not hasattr(self, "name"):
+                err += "`name`"
+            if not hasattr(self, "requires_logging_directory"):
+                if len(err) > 0:
+                    err += ", "
+                err += "`requires_logging_directory`"
+
+            # as tracker is a @property that relies on post-init
+            if "tracker" not in dir(self):
+                if len(err) > 0:
+                    err += ", "
+                err += "`tracker`"
+            if len(err) > 0:
+                raise NotImplementedError(
+                    f"The implementation for this tracker class is missing the following "
+                    f"required attributes. Please define them in the class definition: "
+                    f"{err}"
+                )
+
+    def store_init_configuration(self, values: dict):
+        """
+        Logs `values` as hyperparameters for the run. Implementations should use the experiment configuration
+        functionality of a tracking API.
+
+        Args:
+            values (Dictionary `str` to `bool`, `str`, `float` or `int`):
+                Values to be stored as initial hyperparameters as key-value pairs. The values need to have type `bool`,
+                `str`, `float`, `int`, or `None`.
+        """
+        pass
+
+    def log(self, values: dict, step: Optional[int], **kwargs):
+        """
+        Logs `values` to the current run. Base `log` implementations of a tracking API should go in here, along with
+        special behavior for the `step parameter.
+
+        Args:
+            values (Dictionary `str` to `str`, `float`, or `int`):
+                Values to be logged as key-value pairs. The values need to have type `str`, `float`, or `int`.
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+        """
+        pass
+
+    def finish(self):
+        """
+        Should run any finalizing functions within the tracking API. If the API should not have one, just don't
+        overwrite that method.
+        """
+        pass
+
+
+class TensorBoardTracker(GeneralTracker):
+    """
+    A `Tracker` class that supports `tensorboard`. Should be initialized at the start of your script.
+
+    Args:
+        run_name (`str`):
+            The name of the experiment run
+        logging_dir (`str`, `os.PathLike`):
+            Location for TensorBoard logs to be stored.
+        **kwargs (additional keyword arguments, *optional*):
+            Additional key word arguments passed along to the `tensorboard.SummaryWriter.__init__` method.
+    """
+
+    name = "tensorboard"
+    requires_logging_directory = True
+
+    @on_main_process
+    def __init__(self, run_name: str, logging_dir: Union[str, os.PathLike], **kwargs):
+        try:
+            from torch.utils import tensorboard
+        except ModuleNotFoundError:
+            import tensorboardX as tensorboard
+        super().__init__()
+        self.run_name = run_name
+        self.logging_dir = os.path.join(logging_dir, run_name)
+        self.writer = tensorboard.SummaryWriter(self.logging_dir, **kwargs)
+        logger.debug(f"Initialized TensorBoard project {self.run_name} logging to {self.logging_dir}")
+        logger.debug(
+            "Make sure to log any initial configurations with `self.store_init_configuration` before training!"
+        )
+
+    @property
+    def tracker(self):
+        return self.writer
+
+    @on_main_process
+    def store_init_configuration(self, values: dict):
+        """
+        Logs `values` as hyperparameters for the run. Should be run at the beginning of your experiment. Stores the
+        hyperparameters in a yaml file for future use.
+
+        Args:
+            values (Dictionary `str` to `bool`, `str`, `float` or `int`):
+                Values to be stored as initial hyperparameters as key-value pairs. The values need to have type `bool`,
+                `str`, `float`, `int`, or `None`.
+        """
+        self.writer.add_hparams(values, metric_dict={})
+        self.writer.flush()
+        project_run_name = time.time()
+        dir_name = os.path.join(self.logging_dir, str(project_run_name))
+        os.makedirs(dir_name, exist_ok=True)
+        with open(os.path.join(dir_name, "hparams.yml"), "w") as outfile:
+            try:
+                yaml.dump(values, outfile)
+            except yaml.representer.RepresenterError:
+                logger.error("Serialization to store hyperparameters failed")
+                raise
+        logger.debug("Stored initial configuration hyperparameters to TensorBoard and hparams yaml file")
+
+    @on_main_process
+    def log(self, values: dict, step: Optional[int] = None, **kwargs):
+        """
+        Logs `values` to the current run.
+
+        Args:
+            values (Dictionary `str` to `str`, `float`, `int` or `dict` of `str` to `float`/`int`):
+                Values to be logged as key-value pairs. The values need to have type `str`, `float`, `int` or `dict` of
+                `str` to `float`/`int`.
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+            kwargs:
+                Additional key word arguments passed along to either `SummaryWriter.add_scaler`,
+                `SummaryWriter.add_text`, or `SummaryWriter.add_scalers` method based on the contents of `values`.
+        """
+        values = listify(values)
+        for k, v in values.items():
+            if isinstance(v, (int, float)):
+                self.writer.add_scalar(k, v, global_step=step, **kwargs)
+            elif isinstance(v, str):
+                self.writer.add_text(k, v, global_step=step, **kwargs)
+            elif isinstance(v, dict):
+                self.writer.add_scalars(k, v, global_step=step, **kwargs)
+        self.writer.flush()
+        logger.debug("Successfully logged to TensorBoard")
+
+    @on_main_process
+    def log_images(self, values: dict, step: Optional[int], **kwargs):
+        """
+        Logs `images` to the current run.
+
+        Args:
+            values (Dictionary `str` to `List` of `np.ndarray` or `PIL.Image`):
+                Values to be logged as key-value pairs. The values need to have type `List` of `np.ndarray` or
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+            kwargs:
+                Additional key word arguments passed along to the `SummaryWriter.add_image` method.
+        """
+        for k, v in values.items():
+            self.writer.add_images(k, v, global_step=step, **kwargs)
+        logger.debug("Successfully logged images to TensorBoard")
+
+    @on_main_process
+    def finish(self):
+        """
+        Closes `TensorBoard` writer
+        """
+        self.writer.close()
+        logger.debug("TensorBoard writer closed")
+
+
+class WandBTracker(GeneralTracker):
+    """
+    A `Tracker` class that supports `wandb`. Should be initialized at the start of your script.
+
+    Args:
+        run_name (`str`):
+            The name of the experiment run.
+        **kwargs (additional keyword arguments, *optional*):
+            Additional key word arguments passed along to the `wandb.init` method.
+    """
+
+    name = "wandb"
+    requires_logging_directory = False
+    main_process_only = False
+
+    @on_main_process
+    def __init__(self, run_name: str, **kwargs):
+        super().__init__()
+        self.run_name = run_name
+
+        import wandb
+
+        self.run = wandb.init(project=self.run_name, **kwargs)
+        logger.debug(f"Initialized WandB project {self.run_name}")
+        logger.debug(
+            "Make sure to log any initial configurations with `self.store_init_configuration` before training!"
+        )
+
+    @property
+    def tracker(self):
+        return self.run
+
+    @on_main_process
+    def store_init_configuration(self, values: dict):
+        """
+        Logs `values` as hyperparameters for the run. Should be run at the beginning of your experiment.
+
+        Args:
+            values (Dictionary `str` to `bool`, `str`, `float` or `int`):
+                Values to be stored as initial hyperparameters as key-value pairs. The values need to have type `bool`,
+                `str`, `float`, `int`, or `None`.
+        """
+        import wandb
+
+        wandb.config.update(values, allow_val_change=True)
+        logger.debug("Stored initial configuration hyperparameters to WandB")
+
+    @on_main_process
+    def log(self, values: dict, step: Optional[int] = None, **kwargs):
+        """
+        Logs `values` to the current run.
+
+        Args:
+            values (Dictionary `str` to `str`, `float`, `int` or `dict` of `str` to `float`/`int`):
+                Values to be logged as key-value pairs. The values need to have type `str`, `float`, `int` or `dict` of
+                `str` to `float`/`int`.
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+            kwargs:
+                Additional key word arguments passed along to the `wandb.log` method.
+        """
+        self.run.log(values, step=step, **kwargs)
+        logger.debug("Successfully logged to WandB")
+
+    @on_main_process
+    def log_images(self, values: dict, step: Optional[int] = None, **kwargs):
+        """
+        Logs `images` to the current run.
+
+        Args:
+            values (Dictionary `str` to `List` of `np.ndarray` or `PIL.Image`):
+                Values to be logged as key-value pairs. The values need to have type `List` of `np.ndarray` or
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+            kwargs:
+                Additional key word arguments passed along to the `wandb.log` method.
+        """
+        import wandb
+
+        for k, v in values.items():
+            self.log({k: [wandb.Image(image) for image in v]}, step=step, **kwargs)
+        logger.debug("Successfully logged images to WandB")
+
+    @on_main_process
+    def log_table(
+        self,
+        table_name: str,
+        columns: List[str] = None,
+        data: List[List[Any]] = None,
+        dataframe: Any = None,
+        step: Optional[int] = None,
+        **kwargs,
+    ):
+        """
+        Log a Table containing any object type (text, image, audio, video, molecule, html, etc). Can be defined either
+        with `columns` and `data` or with `dataframe`.
+
+        Args:
+            table_name (`str`):
+                The name to give to the logged table on the wandb workspace
+            columns (list of `str`, *optional*):
+                The name of the columns on the table
+            data (List of List of Any data type, *optional*):
+                The data to be logged in the table
+            dataframe (Any data type, *optional*):
+                The data to be logged in the table
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+        """
+        import wandb
+
+        values = {table_name: wandb.Table(columns=columns, data=data, dataframe=dataframe)}
+        self.log(values, step=step, **kwargs)
+
+    @on_main_process
+    def finish(self):
+        """
+        Closes `wandb` writer
+        """
+        self.run.finish()
+        logger.debug("WandB run closed")
+
+
+class CometMLTracker(GeneralTracker):
+    """
+    A `Tracker` class that supports `comet_ml`. Should be initialized at the start of your script.
+
+    API keys must be stored in a Comet config file.
+
+    Args:
+        run_name (`str`):
+            The name of the experiment run.
+        **kwargs (additional keyword arguments, *optional*):
+            Additional key word arguments passed along to the `Experiment.__init__` method.
+    """
+
+    name = "comet_ml"
+    requires_logging_directory = False
+
+    @on_main_process
+    def __init__(self, run_name: str, **kwargs):
+        super().__init__()
+        self.run_name = run_name
+
+        from comet_ml import Experiment
+
+        self.writer = Experiment(project_name=run_name, **kwargs)
+        logger.debug(f"Initialized CometML project {self.run_name}")
+        logger.debug(
+            "Make sure to log any initial configurations with `self.store_init_configuration` before training!"
+        )
+
+    @property
+    def tracker(self):
+        return self.writer
+
+    @on_main_process
+    def store_init_configuration(self, values: dict):
+        """
+        Logs `values` as hyperparameters for the run. Should be run at the beginning of your experiment.
+
+        Args:
+            values (Dictionary `str` to `bool`, `str`, `float` or `int`):
+                Values to be stored as initial hyperparameters as key-value pairs. The values need to have type `bool`,
+                `str`, `float`, `int`, or `None`.
+        """
+        self.writer.log_parameters(values)
+        logger.debug("Stored initial configuration hyperparameters to CometML")
+
+    @on_main_process
+    def log(self, values: dict, step: Optional[int] = None, **kwargs):
+        """
+        Logs `values` to the current run.
+
+        Args:
+            values (Dictionary `str` to `str`, `float`, `int` or `dict` of `str` to `float`/`int`):
+                Values to be logged as key-value pairs. The values need to have type `str`, `float`, `int` or `dict` of
+                `str` to `float`/`int`.
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+            kwargs:
+                Additional key word arguments passed along to either `Experiment.log_metric`, `Experiment.log_other`,
+                or `Experiment.log_metrics` method based on the contents of `values`.
+        """
+        if step is not None:
+            self.writer.set_step(step)
+        for k, v in values.items():
+            if isinstance(v, (int, float)):
+                self.writer.log_metric(k, v, step=step, **kwargs)
+            elif isinstance(v, str):
+                self.writer.log_other(k, v, **kwargs)
+            elif isinstance(v, dict):
+                self.writer.log_metrics(v, step=step, **kwargs)
+        logger.debug("Successfully logged to CometML")
+
+    @on_main_process
+    def finish(self):
+        """
+        Closes `comet-ml` writer
+        """
+        self.writer.end()
+        logger.debug("CometML run closed")
+
+
+class AimTracker(GeneralTracker):
+    """
+    A `Tracker` class that supports `aim`. Should be initialized at the start of your script.
+
+    Args:
+        run_name (`str`):
+            The name of the experiment run.
+        **kwargs (additional keyword arguments, *optional*):
+            Additional key word arguments passed along to the `Run.__init__` method.
+    """
+
+    name = "aim"
+    requires_logging_directory = True
+
+    @on_main_process
+    def __init__(self, run_name: str, logging_dir: Optional[Union[str, os.PathLike]] = ".", **kwargs):
+        self.run_name = run_name
+
+        from aim import Run
+
+        self.writer = Run(repo=logging_dir, **kwargs)
+        self.writer.name = self.run_name
+        logger.debug(f"Initialized Aim project {self.run_name}")
+        logger.debug(
+            "Make sure to log any initial configurations with `self.store_init_configuration` before training!"
+        )
+
+    @property
+    def tracker(self):
+        return self.writer
+
+    @on_main_process
+    def store_init_configuration(self, values: dict):
+        """
+        Logs `values` as hyperparameters for the run. Should be run at the beginning of your experiment.
+
+        Args:
+            values (`dict`):
+                Values to be stored as initial hyperparameters as key-value pairs.
+        """
+        self.writer["hparams"] = values
+
+    @on_main_process
+    def log(self, values: dict, step: Optional[int], **kwargs):
+        """
+        Logs `values` to the current run.
+
+        Args:
+            values (`dict`):
+                Values to be logged as key-value pairs.
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+            kwargs:
+                Additional key word arguments passed along to the `Run.track` method.
+        """
+        # Note: replace this with the dictionary support when merged
+        for key, value in values.items():
+            self.writer.track(value, name=key, step=step, **kwargs)
+
+    @on_main_process
+    def log_images(self, values: dict, step: Optional[int] = None, kwargs: Optional[Dict[str, dict]] = None):
+        """
+        Logs `images` to the current run.
+
+        Args:
+            values (`Dict[str, Union[np.ndarray, PIL.Image, Tuple[np.ndarray, str], Tuple[PIL.Image, str]]]`):
+                Values to be logged as key-value pairs. The values need to have type `np.ndarray` or PIL.Image. If a
+                tuple is provided, the first element should be the image and the second element should be the caption.
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+            kwargs (`Dict[str, dict]`):
+                Additional key word arguments passed along to the `Run.Image` and `Run.track` method specified by the
+                keys `aim_image` and `track`, respectively.
+        """
+        import aim
+
+        aim_image_kw = {}
+        track_kw = {}
+
+        if kwargs is not None:
+            aim_image_kw = kwargs.get("aim_image", {})
+            track_kw = kwargs.get("track", {})
+
+        for key, value in values.items():
+            if isinstance(value, tuple):
+                img, caption = value
+            else:
+                img, caption = value, ""
+            aim_image = aim.Image(img, caption=caption, **aim_image_kw)
+            self.writer.track(aim_image, name=key, step=step, **track_kw)
+
+    @on_main_process
+    def finish(self):
+        """
+        Closes `aim` writer
+        """
+        self.writer.close()
+
+
+class MLflowTracker(GeneralTracker):
+    """
+    A `Tracker` class that supports `mlflow`. Should be initialized at the start of your script.
+
+    Args:
+        experiment_name (`str`, *optional*):
+            Name of the experiment. Environment variable MLFLOW_EXPERIMENT_NAME has priority over this argument.
+        logging_dir (`str` or `os.PathLike`, defaults to `"."`):
+            Location for mlflow logs to be stored.
+        run_id (`str`, *optional*):
+            If specified, get the run with the specified UUID and log parameters and metrics under that run. The run’s
+            end time is unset and its status is set to running, but the run’s other attributes (source_version,
+            source_type, etc.) are not changed. Environment variable MLFLOW_RUN_ID has priority over this argument.
+        tags (`Dict[str, str]`, *optional*):
+            An optional `dict` of `str` keys and values, or a `str` dump from a `dict`, to set as tags on the run. If a
+            run is being resumed, these tags are set on the resumed run. If a new run is being created, these tags are
+            set on the new run. Environment variable MLFLOW_TAGS has priority over this argument.
+        nested_run (`bool`, *optional*, defaults to `False`):
+            Controls whether run is nested in parent run. True creates a nested run. Environment variable
+            MLFLOW_NESTED_RUN has priority over this argument.
+        run_name (`str`, *optional*):
+            Name of new run (stored as a mlflow.runName tag). Used only when `run_id` is unspecified.
+        description (`str`, *optional*):
+            An optional string that populates the description box of the run. If a run is being resumed, the
+            description is set on the resumed run. If a new run is being created, the description is set on the new
+            run.
+    """
+
+    name = "mlflow"
+    requires_logging_directory = False
+
+    @on_main_process
+    def __init__(
+        self,
+        experiment_name: str = None,
+        logging_dir: Optional[Union[str, os.PathLike]] = None,
+        run_id: Optional[str] = None,
+        tags: Optional[Union[Dict[str, Any], str]] = None,
+        nested_run: Optional[bool] = False,
+        run_name: Optional[str] = None,
+        description: Optional[str] = None,
+    ):
+        experiment_name = os.environ.get("MLFLOW_EXPERIMENT_NAME", experiment_name)
+        run_id = os.environ.get("MLFLOW_RUN_ID", run_id)
+        tags = os.environ.get("MLFLOW_TAGS", tags)
+        if isinstance(tags, str):
+            tags = json.loads(tags)
+
+        nested_run = os.environ.get("MLFLOW_NESTED_RUN", nested_run)
+
+        import mlflow
+
+        exps = mlflow.search_experiments(filter_string=f"name = '{experiment_name}'")
+        if len(exps) > 0:
+            if len(exps) > 1:
+                logger.warning("Multiple experiments with the same name found. Using first one.")
+            experiment_id = exps[0].experiment_id
+        else:
+            experiment_id = mlflow.create_experiment(
+                name=experiment_name,
+                artifact_location=logging_dir,
+                tags=tags,
+            )
+
+        self.active_run = mlflow.start_run(
+            run_id=run_id,
+            experiment_id=experiment_id,
+            run_name=run_name,
+            nested=nested_run,
+            tags=tags,
+            description=description,
+        )
+
+        logger.debug(f"Initialized mlflow experiment {experiment_name}")
+        logger.debug(
+            "Make sure to log any initial configurations with `self.store_init_configuration` before training!"
+        )
+
+    @property
+    def tracker(self):
+        return self.active_run
+
+    @on_main_process
+    def store_init_configuration(self, values: dict):
+        """
+        Logs `values` as hyperparameters for the run. Should be run at the beginning of your experiment.
+
+        Args:
+            values (`dict`):
+                Values to be stored as initial hyperparameters as key-value pairs.
+        """
+        import mlflow
+
+        for name, value in list(values.items()):
+            # internally, all values are converted to str in MLflow
+            if len(str(value)) > mlflow.utils.validation.MAX_PARAM_VAL_LENGTH:
+                logger.warning_once(
+                    f'Accelerate is attempting to log a value of "{value}" for key "{name}" as a parameter. MLflow\'s'
+                    f" log_param() only accepts values no longer than {mlflow.utils.validation.MAX_PARAM_VAL_LENGTH} characters so we dropped this attribute."
+                )
+                del values[name]
+
+        values_list = list(values.items())
+
+        # MLflow cannot log more than 100 values in one go, so we have to split it
+        for i in range(0, len(values_list), mlflow.utils.validation.MAX_PARAMS_TAGS_PER_BATCH):
+            mlflow.log_params(dict(values_list[i : i + mlflow.utils.validation.MAX_PARAMS_TAGS_PER_BATCH]))
+
+        logger.debug("Stored initial configuration hyperparameters to MLflow")
+
+    @on_main_process
+    def log(self, values: dict, step: Optional[int]):
+        """
+        Logs `values` to the current run.
+
+        Args:
+            values (`dict`):
+                Values to be logged as key-value pairs.
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+        """
+        metrics = {}
+        for k, v in values.items():
+            if isinstance(v, (int, float)):
+                metrics[k] = v
+            else:
+                logger.warning_once(
+                    f'MLflowTracker is attempting to log a value of "{v}" of type {type(v)} for key "{k}" as a metric. '
+                    "MLflow's log_metric() only accepts float and int types so we dropped this attribute."
+                )
+        import mlflow
+
+        mlflow.log_metrics(metrics, step=step)
+        logger.debug("Successfully logged to mlflow")
+
+    @on_main_process
+    def finish(self):
+        """
+        End the active MLflow run.
+        """
+        import mlflow
+
+        mlflow.end_run()
+
+
+class ClearMLTracker(GeneralTracker):
+    """
+    A `Tracker` class that supports `clearml`. Should be initialized at the start of your script.
+
+    Args:
+        run_name (`str`, *optional*):
+            Name of the experiment. Environment variables `CLEARML_PROJECT` and `CLEARML_TASK` have priority over this
+            argument.
+        **kwargs (additional keyword arguments, *optional*):
+            Kwargs passed along to the `Task.__init__` method.
+    """
+
+    name = "clearml"
+    requires_logging_directory = False
+
+    @on_main_process
+    def __init__(self, run_name: str = None, **kwargs):
+        from clearml import Task
+
+        current_task = Task.current_task()
+        self._initialized_externally = False
+        if current_task:
+            self._initialized_externally = True
+            self.task = current_task
+            return
+
+        kwargs.setdefault("project_name", os.environ.get("CLEARML_PROJECT", run_name))
+        kwargs.setdefault("task_name", os.environ.get("CLEARML_TASK", run_name))
+        self.task = Task.init(**kwargs)
+
+    @property
+    def tracker(self):
+        return self.task
+
+    @on_main_process
+    def store_init_configuration(self, values: dict):
+        """
+        Connect configuration dictionary to the Task object. Should be run at the beginning of your experiment.
+
+        Args:
+            values (`dict`):
+                Values to be stored as initial hyperparameters as key-value pairs.
+        """
+        return self.task.connect_configuration(values)
+
+    @on_main_process
+    def log(self, values: Dict[str, Union[int, float]], step: Optional[int] = None, **kwargs):
+        """
+        Logs `values` dictionary to the current run. The dictionary keys must be strings. The dictionary values must be
+        ints or floats
+
+        Args:
+            values (`Dict[str, Union[int, float]]`):
+                Values to be logged as key-value pairs. If the key starts with 'eval_'/'test_'/'train_', the value will
+                be reported under the 'eval'/'test'/'train' series and the respective prefix will be removed.
+                Otherwise, the value will be reported under the 'train' series, and no prefix will be removed.
+            step (`int`, *optional*):
+                If specified, the values will be reported as scalars, with the iteration number equal to `step`.
+                Otherwise they will be reported as single values.
+            kwargs:
+                Additional key word arguments passed along to the `clearml.Logger.report_single_value` or
+                `clearml.Logger.report_scalar` methods.
+        """
+        clearml_logger = self.task.get_logger()
+        for k, v in values.items():
+            if not isinstance(v, (int, float)):
+                logger.warning_once(
+                    "Accelerator is attempting to log a value of "
+                    f'"{v}" of type {type(v)} for key "{k}" as a scalar. '
+                    "This invocation of ClearML logger's  report_scalar() "
+                    "is incorrect so we dropped this attribute."
+                )
+                continue
+            if step is None:
+                clearml_logger.report_single_value(name=k, value=v, **kwargs)
+                continue
+            title, series = ClearMLTracker._get_title_series(k)
+            clearml_logger.report_scalar(title=title, series=series, value=v, iteration=step, **kwargs)
+
+    @on_main_process
+    def log_images(self, values: dict, step: Optional[int] = None, **kwargs):
+        """
+        Logs `images` to the current run.
+
+        Args:
+            values (`Dict[str, List[Union[np.ndarray, PIL.Image]]`):
+                Values to be logged as key-value pairs. The values need to have type `List` of `np.ndarray` or
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+            kwargs:
+                Additional key word arguments passed along to the `clearml.Logger.report_image` method.
+        """
+        clearml_logger = self.task.get_logger()
+        for k, v in values.items():
+            title, series = ClearMLTracker._get_title_series(k)
+            clearml_logger.report_image(title=title, series=series, iteration=step, image=v, **kwargs)
+
+    @on_main_process
+    def log_table(
+        self,
+        table_name: str,
+        columns: List[str] = None,
+        data: List[List[Any]] = None,
+        dataframe: Any = None,
+        step: Optional[int] = None,
+        **kwargs,
+    ):
+        """
+        Log a Table to the task. Can be defined eitherwith `columns` and `data` or with `dataframe`.
+
+        Args:
+            table_name (`str`):
+                The name of the table
+            columns (list of `str`, *optional*):
+                The name of the columns on the table
+            data (List of List of Any data type, *optional*):
+                The data to be logged in the table. If `columns` is not specified, then the first entry in data will be
+                the name of the columns of the table
+            dataframe (Any data type, *optional*):
+                The data to be logged in the table
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+            kwargs:
+                Additional key word arguments passed along to the `clearml.Logger.report_table` method.
+        """
+        to_report = dataframe
+        if dataframe is None:
+            if data is None:
+                raise ValueError(
+                    "`ClearMLTracker.log_table` requires that `data` to be supplied if `dataframe` is `None`"
+                )
+            to_report = [columns] + data if columns else data
+        title, series = ClearMLTracker._get_title_series(table_name)
+        self.task.get_logger().report_table(title=title, series=series, table_plot=to_report, iteration=step, **kwargs)
+
+    @on_main_process
+    def finish(self):
+        """
+        Close the ClearML task. If the task was initialized externally (e.g. by manually calling `Task.init`), this
+        function is a noop
+        """
+        if self.task and not self._initialized_externally:
+            self.task.close()
+
+    @staticmethod
+    def _get_title_series(name):
+        for prefix in ["eval", "test", "train"]:
+            if name.startswith(prefix + "_"):
+                return name[len(prefix) + 1 :], prefix
+        return name, "train"
+
+
+class DVCLiveTracker(GeneralTracker):
+    """
+    A `Tracker` class that supports `dvclive`. Should be initialized at the start of your script.
+
+    Args:
+        run_name (`str`, *optional*):
+            Ignored for dvclive. See `kwargs` instead.
+        kwargs:
+            Additional key word arguments passed along to [`dvclive.Live()`](https://dvc.org/doc/dvclive/live).
+
+    Example:
+
+    ```py
+    from accelerate import Accelerator
+
+    accelerator = Accelerator(log_with="dvclive")
+    accelerator.init_trackers(project_name="my_project", init_kwargs={"dvclive": {"dir": "my_directory"}})
+    ```
+    """
+
+    name = "dvclive"
+    requires_logging_directory = False
+
+    @on_main_process
+    def __init__(self, run_name: Optional[str] = None, live: Optional[Any] = None, **kwargs):
+        from dvclive import Live
+
+        super().__init__()
+        self.live = live if live is not None else Live(**kwargs)
+
+    @property
+    def tracker(self):
+        return self.live
+
+    @on_main_process
+    def store_init_configuration(self, values: dict):
+        """
+        Logs `values` as hyperparameters for the run. Should be run at the beginning of your experiment. Stores the
+        hyperparameters in a yaml file for future use.
+
+        Args:
+            values (Dictionary `str` to `bool`, `str`, `float`, `int`, or a List or Dict of those types):
+                Values to be stored as initial hyperparameters as key-value pairs. The values need to have type `bool`,
+                `str`, `float`, or `int`.
+        """
+        self.live.log_params(values)
+
+    @on_main_process
+    def log(self, values: dict, step: Optional[int] = None, **kwargs):
+        """
+        Logs `values` to the current run.
+
+        Args:
+            values (Dictionary `str` to `str`, `float`, or `int`):
+                Values to be logged as key-value pairs. The values need to have type `str`, `float`, or `int`.
+            step (`int`, *optional*):
+                The run step. If included, the log will be affiliated with this step.
+            kwargs:
+                Additional key word arguments passed along to `dvclive.Live.log_metric()`.
+        """
+        from dvclive.plots import Metric
+
+        if step is not None:
+            self.live.step = step
+        for k, v in values.items():
+            if Metric.could_log(v):
+                self.live.log_metric(k, v, **kwargs)
+            else:
+                logger.warning_once(
+                    "Accelerator attempted to log a value of "
+                    f'"{v}" of type {type(v)} for key "{k}" as a scalar. '
+                    "This invocation of DVCLive's Live.log_metric() "
+                    "is incorrect so we dropped this attribute."
+                )
+        self.live.next_step()
+
+    @on_main_process
+    def finish(self):
+        """
+        Closes `dvclive.Live()`.
+        """
+        self.live.end()
+
+
+LOGGER_TYPE_TO_CLASS = {
+    "aim": AimTracker,
+    "comet_ml": CometMLTracker,
+    "mlflow": MLflowTracker,
+    "tensorboard": TensorBoardTracker,
+    "wandb": WandBTracker,
+    "clearml": ClearMLTracker,
+    "dvclive": DVCLiveTracker,
+}
+
+
+def filter_trackers(
+    log_with: List[Union[str, LoggerType, GeneralTracker]],
+    logging_dir: Union[str, os.PathLike] = None,
+):
+    """
+    Takes in a list of potential tracker types and checks that:
+        - The tracker wanted is available in that environment
+        - Filters out repeats of tracker types
+        - If `all` is in `log_with`, will return all trackers in the environment
+        - If a tracker requires a `logging_dir`, ensures that `logging_dir` is not `None`
+
+    Args:
+        log_with (list of `str`, [`~utils.LoggerType`] or [`~tracking.GeneralTracker`], *optional*):
+            A list of loggers to be setup for experiment tracking. Should be one or several of:
+
+            - `"all"`
+            - `"tensorboard"`
+            - `"wandb"`
+            - `"comet_ml"`
+            - `"mlflow"`
+            - `"dvclive"`
+            If `"all"` is selected, will pick up all available trackers in the environment and initialize them. Can
+            also accept implementations of `GeneralTracker` for custom trackers, and can be combined with `"all"`.
+        logging_dir (`str`, `os.PathLike`, *optional*):
+            A path to a directory for storing logs of locally-compatible loggers.
+    """
+    loggers = []
+    if log_with is not None:
+        if not isinstance(log_with, (list, tuple)):
+            log_with = [log_with]
+        if "all" in log_with or LoggerType.ALL in log_with:
+            loggers = [o for o in log_with if issubclass(type(o), GeneralTracker)] + get_available_trackers()
+        else:
+            for log_type in log_with:
+                if log_type not in LoggerType and not issubclass(type(log_type), GeneralTracker):
+                    raise ValueError(f"Unsupported logging capability: {log_type}. Choose between {LoggerType.list()}")
+                if issubclass(type(log_type), GeneralTracker):
+                    loggers.append(log_type)
+                else:
+                    log_type = LoggerType(log_type)
+                    if log_type not in loggers:
+                        if log_type in get_available_trackers():
+                            tracker_init = LOGGER_TYPE_TO_CLASS[str(log_type)]
+                            if tracker_init.requires_logging_directory:
+                                if logging_dir is None:
+                                    raise ValueError(
+                                        f"Logging with `{log_type}` requires a `logging_dir` to be passed in."
+                                    )
+                            loggers.append(log_type)
+                        else:
+                            logger.debug(f"Tried adding logger {log_type}, but package is unavailable in the system.")
+
+    return loggers
diff --git a/llm/Lib/site-packages/accelerate/utils/__init__.py b/llm/Lib/site-packages/accelerate/utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..50baa32fdbca940857055445c1988c16b9f01b6a
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/__init__.py
@@ -0,0 +1,225 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from .constants import (
+    MODEL_NAME,
+    OPTIMIZER_NAME,
+    RNG_STATE_NAME,
+    SAFE_MODEL_NAME,
+    SAFE_WEIGHTS_INDEX_NAME,
+    SAFE_WEIGHTS_NAME,
+    SAMPLER_NAME,
+    SCALER_NAME,
+    SCHEDULER_NAME,
+    TORCH_DISTRIBUTED_OPERATION_TYPES,
+    TORCH_LAUNCH_PARAMS,
+    WEIGHTS_INDEX_NAME,
+    WEIGHTS_NAME,
+)
+from .dataclasses import (
+    AutocastKwargs,
+    BnbQuantizationConfig,
+    ComputeEnvironment,
+    CustomDtype,
+    DataLoaderConfiguration,
+    DeepSpeedPlugin,
+    DistributedDataParallelKwargs,
+    DistributedType,
+    DynamoBackend,
+    FP8RecipeKwargs,
+    FullyShardedDataParallelPlugin,
+    GradientAccumulationPlugin,
+    GradScalerKwargs,
+    InitProcessGroupKwargs,
+    KwargsHandler,
+    LoggerType,
+    MegatronLMPlugin,
+    PrecisionType,
+    ProjectConfiguration,
+    RNGType,
+    SageMakerDistributedType,
+    TensorInformation,
+    TorchDynamoPlugin,
+)
+from .environment import (
+    are_libraries_initialized,
+    check_cuda_p2p_ib_support,
+    check_fp8_capability,
+    convert_dict_to_env_variables,
+    get_cpu_distributed_information,
+    get_gpu_info,
+    get_int_from_env,
+    parse_choice_from_env,
+    parse_flag_from_env,
+    set_numa_affinity,
+    str_to_bool,
+)
+from .imports import (
+    get_ccl_version,
+    is_4bit_bnb_available,
+    is_8bit_bnb_available,
+    is_aim_available,
+    is_bf16_available,
+    is_bnb_available,
+    is_boto3_available,
+    is_ccl_available,
+    is_clearml_available,
+    is_comet_ml_available,
+    is_cuda_available,
+    is_datasets_available,
+    is_deepspeed_available,
+    is_dvclive_available,
+    is_fp8_available,
+    is_ipex_available,
+    is_megatron_lm_available,
+    is_mlflow_available,
+    is_mlu_available,
+    is_mps_available,
+    is_msamp_available,
+    is_npu_available,
+    is_pandas_available,
+    is_peft_available,
+    is_pippy_available,
+    is_pynvml_available,
+    is_rich_available,
+    is_sagemaker_available,
+    is_tensorboard_available,
+    is_timm_available,
+    is_torch_xla_available,
+    is_transformer_engine_available,
+    is_transformers_available,
+    is_wandb_available,
+    is_xpu_available,
+)
+from .modeling import (
+    calculate_maximum_sizes,
+    check_device_map,
+    check_tied_parameters_in_config,
+    check_tied_parameters_on_same_device,
+    compute_module_sizes,
+    convert_file_size_to_int,
+    dtype_byte_size,
+    find_tied_parameters,
+    get_balanced_memory,
+    get_max_layer_size,
+    get_max_memory,
+    get_mixed_precision_context_manager,
+    id_tensor_storage,
+    infer_auto_device_map,
+    is_peft_model,
+    load_checkpoint_in_model,
+    load_offloaded_weights,
+    load_state_dict,
+    named_module_tensors,
+    retie_parameters,
+    set_module_tensor_to_device,
+    shard_checkpoint,
+)
+from .offload import (
+    OffloadedWeightsLoader,
+    PrefixedDataset,
+    extract_submodules_state_dict,
+    load_offloaded_weight,
+    offload_state_dict,
+    offload_weight,
+    save_offload_index,
+)
+from .operations import (
+    CannotPadNestedTensorWarning,
+    broadcast,
+    broadcast_object_list,
+    concatenate,
+    convert_outputs_to_fp32,
+    convert_to_fp32,
+    copy_tensor_to_devices,
+    find_batch_size,
+    find_device,
+    gather,
+    gather_object,
+    get_data_structure,
+    honor_type,
+    ignorant_find_batch_size,
+    initialize_tensors,
+    is_namedtuple,
+    is_tensor_information,
+    is_torch_tensor,
+    listify,
+    pad_across_processes,
+    pad_input_tensors,
+    recursively_apply,
+    reduce,
+    send_to_device,
+    slice_tensors,
+)
+from .versions import compare_versions, is_torch_version
+
+
+if is_deepspeed_available():
+    from .deepspeed import (
+        DeepSpeedEngineWrapper,
+        DeepSpeedOptimizerWrapper,
+        DeepSpeedSchedulerWrapper,
+        DummyOptim,
+        DummyScheduler,
+        HfDeepSpeedConfig,
+    )
+
+from .bnb import has_4bit_bnb_layers, load_and_quantize_model
+from .fsdp_utils import load_fsdp_model, load_fsdp_optimizer, save_fsdp_model, save_fsdp_optimizer
+from .launch import (
+    PrepareForLaunch,
+    _filter_args,
+    prepare_deepspeed_cmd_env,
+    prepare_multi_gpu_env,
+    prepare_sagemager_args_inputs,
+    prepare_simple_launcher_cmd_env,
+    prepare_tpu,
+)
+from .megatron_lm import (
+    AbstractTrainStep,
+    BertTrainStep,
+    GPTTrainStep,
+    MegatronEngine,
+    MegatronLMDummyDataLoader,
+    MegatronLMDummyScheduler,
+    MegatronLMOptimizerWrapper,
+    MegatronLMSchedulerWrapper,
+    T5TrainStep,
+    avg_losses_across_data_parallel_group,
+    gather_across_data_parallel_groups,
+)
+from .megatron_lm import initialize as megatron_lm_initialize
+from .megatron_lm import prepare_data_loader as megatron_lm_prepare_data_loader
+from .megatron_lm import prepare_model as megatron_lm_prepare_model
+from .megatron_lm import prepare_optimizer as megatron_lm_prepare_optimizer
+from .megatron_lm import prepare_scheduler as megatron_lm_prepare_scheduler
+from .memory import find_executable_batch_size, release_memory
+from .other import (
+    check_os_kernel,
+    clean_state_dict_for_safetensors,
+    clear_environment,
+    convert_bytes,
+    extract_model_from_parallel,
+    get_pretty_name,
+    is_port_in_use,
+    merge_dicts,
+    patch_environment,
+    recursive_getattr,
+    save,
+    wait_for_everyone,
+    write_basic_config,
+)
+from .random import set_seed, synchronize_rng_state, synchronize_rng_states
+from .torch_xla import install_xla
+from .tqdm import tqdm
+from .transformer_engine import convert_model, has_transformer_engine_layers
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fe45b51e203b4b1bac0913b35f661576b69545e5
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/bnb.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/bnb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b79e913fa6e1ead4eeb7811c7666b73785e0b567
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/bnb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/constants.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/constants.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fdd1bad85f63527a2d7d1bd21afa765e190faf55
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/constants.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/dataclasses.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/dataclasses.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..633a2b1fba13ca0fb73bbfb07bd0d08fbed333ae
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/dataclasses.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/deepspeed.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/deepspeed.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6eb41526c539cfd38b4f23388e6072b0bdf95868
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/deepspeed.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/environment.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/environment.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d996518830608453e8c558b10277784a0293d393
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/environment.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/fsdp_utils.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/fsdp_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5703998184e8074285478d2614b6202480f094a9
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/fsdp_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/imports.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/imports.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8589dc317bcc8cfd10403b91b07b6c0a37a0ff20
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/imports.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/launch.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/launch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..917c79a2bbb9887b6a40ff2b07a8dc6f3f3ec4ce
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/launch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/megatron_lm.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/megatron_lm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..15fa4a429a80b9b9080ccce5bf831ce73e2a6525
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/megatron_lm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/memory.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..217822a49ee9428187abb708a4d6d671d6bdff95
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/modeling.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/modeling.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..08bec29668e14109684c76f01556ef84e0514791
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/modeling.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/offload.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/offload.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d218d5f2b55cd260217f1883debaecd9d2c3ab08
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/offload.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/operations.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/operations.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..91ad6ad87ddf4fe74b8d13fa882b211393b6ee31
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/operations.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/other.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/other.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..913dd64c06aafc3e7f60f14ba43540a61bebd12c
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/other.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/random.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/random.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e9e8fbdf8940fef5371ba818e51dd057ec29a259
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/random.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/rich.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/rich.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..28aa3f953df9f1286a6ad16fad3c001b213f58ae
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/rich.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/torch_xla.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/torch_xla.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a041c5ae536102e5d61760a2a51ab7ab922ba846
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/torch_xla.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/tqdm.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/tqdm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b81150ae0c6de3dfbc2df9846230f59bbc30336d
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/tqdm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/transformer_engine.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/transformer_engine.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7df0bd0cf5884f9adc5fe8be73958f4942e3357f
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/transformer_engine.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/__pycache__/versions.cpython-311.pyc b/llm/Lib/site-packages/accelerate/utils/__pycache__/versions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c54a09c1362fc794b82f1c56e9f963e39d87f41e
Binary files /dev/null and b/llm/Lib/site-packages/accelerate/utils/__pycache__/versions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/accelerate/utils/bnb.py b/llm/Lib/site-packages/accelerate/utils/bnb.py
new file mode 100644
index 0000000000000000000000000000000000000000..284ee5df6e89171948745255dd33a3b2b91123a2
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/bnb.py
@@ -0,0 +1,467 @@
+# Copyright 2023 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import logging
+import os
+from copy import deepcopy
+from typing import Dict, List, Optional, Union
+
+import torch
+import torch.nn as nn
+
+from accelerate.utils.imports import (
+    is_4bit_bnb_available,
+    is_8bit_bnb_available,
+)
+
+from ..big_modeling import dispatch_model, init_empty_weights
+from .dataclasses import BnbQuantizationConfig
+from .modeling import (
+    find_tied_parameters,
+    get_balanced_memory,
+    infer_auto_device_map,
+    load_checkpoint_in_model,
+    offload_weight,
+    set_module_tensor_to_device,
+)
+
+
+logger = logging.getLogger(__name__)
+
+
+def load_and_quantize_model(
+    model: torch.nn.Module,
+    bnb_quantization_config: BnbQuantizationConfig,
+    weights_location: Union[str, os.PathLike] = None,
+    device_map: Optional[Dict[str, Union[int, str, torch.device]]] = None,
+    no_split_module_classes: Optional[List[str]] = None,
+    max_memory: Optional[Dict[Union[int, str], Union[int, str]]] = None,
+    offload_folder: Optional[Union[str, os.PathLike]] = None,
+    offload_state_dict: bool = False,
+):
+    """
+    This function will quantize the input model with the associated config passed in `bnb_quantization_config`. If the
+    model is in the meta device, we will load and dispatch the weights according to the `device_map` passed. If the
+    model is already loaded, we will quantize the model and put the model on the GPU,
+
+    Args:
+        model (`torch.nn.Module`):
+            Input model. The model can be already loaded or on the meta device
+        bnb_quantization_config (`BnbQuantizationConfig`):
+            The bitsandbytes quantization parameters
+        weights_location (`str` or `os.PathLike`):
+            The folder weights_location to load. It can be:
+            - a path to a file containing a whole model state dict
+            - a path to a `.json` file containing the index to a sharded checkpoint
+            - a path to a folder containing a unique `.index.json` file and the shards of a checkpoint.
+            - a path to a folder containing a unique pytorch_model.bin file.
+        device_map (`Dict[str, Union[int, str, torch.device]]`, *optional*):
+            A map that specifies where each submodule should go. It doesn't need to be refined to each parameter/buffer
+            name, once a given module name is inside, every submodule of it will be sent to the same device.
+        no_split_module_classes (`List[str]`, *optional*):
+            A list of layer class names that should never be split across device (for instance any layer that has a
+            residual connection).
+        max_memory (`Dict`, *optional*):
+            A dictionary device identifier to maximum memory. Will default to the maximum memory available if unset.
+        offload_folder (`str` or `os.PathLike`, *optional*):
+            If the `device_map` contains any value `"disk"`, the folder where we will offload weights.
+        offload_state_dict (`bool`, *optional*, defaults to `False`):
+            If `True`, will temporarily offload the CPU state dict on the hard drive to avoid getting out of CPU RAM if
+            the weight of the CPU state dict + the biggest shard does not fit.
+
+    Returns:
+        `torch.nn.Module`: The quantized model
+    """
+
+    load_in_4bit = bnb_quantization_config.load_in_4bit
+    load_in_8bit = bnb_quantization_config.load_in_8bit
+
+    if load_in_8bit and not is_8bit_bnb_available():
+        raise ImportError(
+            "You have a version of `bitsandbytes` that is not compatible with 8bit quantization,"
+            " make sure you have the latest version of `bitsandbytes` installed."
+        )
+    if load_in_4bit and not is_4bit_bnb_available():
+        raise ValueError(
+            "You have a version of `bitsandbytes` that is not compatible with 4bit quantization,"
+            "make sure you have the latest version of `bitsandbytes` installed."
+        )
+
+    modules_on_cpu = []
+    # custom device map
+    if isinstance(device_map, dict) and len(device_map.keys()) > 1:
+        modules_on_cpu = [key for key, value in device_map.items() if value in ["disk", "cpu"]]
+
+    # We keep some modules such as the lm_head in their original dtype for numerical stability reasons
+    if bnb_quantization_config.skip_modules is None:
+        bnb_quantization_config.skip_modules = get_keys_to_not_convert(model)
+
+    # add cpu modules to skip modules only for 4-bit modules
+    if load_in_4bit:
+        bnb_quantization_config.skip_modules.extend(modules_on_cpu)
+    modules_to_not_convert = bnb_quantization_config.skip_modules
+
+    # We add the modules we want to keep in full precision
+    if bnb_quantization_config.keep_in_fp32_modules is None:
+        bnb_quantization_config.keep_in_fp32_modules = []
+    keep_in_fp32_modules = bnb_quantization_config.keep_in_fp32_modules
+    modules_to_not_convert.extend(keep_in_fp32_modules)
+
+    # compatibility with peft
+    model.is_loaded_in_4bit = load_in_4bit
+    model.is_loaded_in_8bit = load_in_8bit
+
+    model_device = get_parameter_device(model)
+    if model_device.type != "meta":
+        # quantization of an already loaded model
+        logger.warning(
+            "It is not recommended to quantize a loaded model. "
+            "The model should be instantiated under the `init_empty_weights` context manager."
+        )
+        model = replace_with_bnb_layers(model, bnb_quantization_config, modules_to_not_convert=modules_to_not_convert)
+        # convert param to the right dtype
+        dtype = bnb_quantization_config.torch_dtype
+        for name, param in model.state_dict().items():
+            if any(module_to_keep_in_fp32 in name for module_to_keep_in_fp32 in keep_in_fp32_modules):
+                param.to(torch.float32)
+                if param.dtype != torch.float32:
+                    name = name.replace(".weight", "").replace(".bias", "")
+                    param = getattr(model, name, None)
+                    if param is not None:
+                        param.to(torch.float32)
+            elif torch.is_floating_point(param):
+                param.to(dtype)
+        if model_device.type == "cuda":
+            # move everything to cpu in the first place because we can't do quantization if the weights are already on cuda
+            model.cuda(torch.cuda.current_device())
+            torch.cuda.empty_cache()
+        elif torch.cuda.is_available():
+            model.to(torch.cuda.current_device())
+        else:
+            raise RuntimeError("No GPU found. A GPU is needed for quantization.")
+        logger.info(
+            f"The model device type is {model_device.type}. However, cuda is needed for quantization."
+            "We move the model to cuda."
+        )
+        return model
+
+    elif weights_location is None:
+        raise RuntimeError(
+            f"`weights_location` needs to be the folder path containing the weights of the model, but we found {weights_location} "
+        )
+
+    else:
+        with init_empty_weights():
+            model = replace_with_bnb_layers(
+                model, bnb_quantization_config, modules_to_not_convert=modules_to_not_convert
+            )
+
+        device_map = get_quantized_model_device_map(
+            model,
+            bnb_quantization_config,
+            device_map,
+            max_memory=max_memory,
+            no_split_module_classes=no_split_module_classes,
+        )
+        if offload_state_dict is None and device_map is not None and "disk" in device_map.values():
+            offload_state_dict = True
+
+        offload = any(x in list(device_map.values()) for x in ["cpu", "disk"])
+
+        load_checkpoint_in_model(
+            model,
+            weights_location,
+            device_map,
+            dtype=bnb_quantization_config.torch_dtype,
+            offload_folder=offload_folder,
+            offload_state_dict=offload_state_dict,
+            keep_in_fp32_modules=bnb_quantization_config.keep_in_fp32_modules,
+            offload_8bit_bnb=load_in_8bit and offload,
+        )
+        return dispatch_model(model, device_map=device_map, offload_dir=offload_folder)
+
+
+def get_quantized_model_device_map(
+    model, bnb_quantization_config, device_map=None, max_memory=None, no_split_module_classes=None
+):
+    if device_map is None:
+        if torch.cuda.is_available():
+            device_map = {"": torch.cuda.current_device()}
+        else:
+            raise RuntimeError("No GPU found. A GPU is needed for quantization.")
+        logger.info("The device_map was not initialized." "Setting device_map to `{'':torch.cuda.current_device()}`.")
+
+    if isinstance(device_map, str):
+        if device_map not in ["auto", "balanced", "balanced_low_0", "sequential"]:
+            raise ValueError(
+                "If passing a string for `device_map`, please choose 'auto', 'balanced', 'balanced_low_0' or "
+                "'sequential'."
+            )
+
+        special_dtypes = {}
+        special_dtypes.update(
+            {
+                name: bnb_quantization_config.torch_dtype
+                for name, _ in model.named_parameters()
+                if any(m in name for m in bnb_quantization_config.skip_modules)
+            }
+        )
+        special_dtypes.update(
+            {
+                name: torch.float32
+                for name, _ in model.named_parameters()
+                if any(m in name for m in bnb_quantization_config.keep_in_fp32_modules)
+            }
+        )
+
+        kwargs = {}
+        kwargs["special_dtypes"] = special_dtypes
+        kwargs["no_split_module_classes"] = no_split_module_classes
+        kwargs["dtype"] = bnb_quantization_config.target_dtype
+
+        # get max_memory for each device.
+        if device_map != "sequential":
+            max_memory = get_balanced_memory(
+                model,
+                low_zero=(device_map == "balanced_low_0"),
+                max_memory=max_memory,
+                **kwargs,
+            )
+
+        kwargs["max_memory"] = max_memory
+        device_map = infer_auto_device_map(model, **kwargs)
+
+    if isinstance(device_map, dict):
+        # check if don't have any quantized module on the cpu
+        modules_not_to_convert = bnb_quantization_config.skip_modules + bnb_quantization_config.keep_in_fp32_modules
+
+        device_map_without_some_modules = {
+            key: device_map[key] for key in device_map.keys() if key not in modules_not_to_convert
+        }
+        for device in ["cpu", "disk"]:
+            if device in device_map_without_some_modules.values():
+                if bnb_quantization_config.load_in_4bit:
+                    raise ValueError(
+                        """
+                        Some modules are dispatched on the CPU or the disk. Make sure you have enough GPU RAM to fit
+                        the quantized model. If you want to dispatch the model on the CPU or the disk while keeping
+                        these modules in `torch_dtype`, you need to pass a custom `device_map` to
+                        `load_and_quantize_model`. Check
+                        https://huggingface.co/docs/accelerate/main/en/usage_guides/quantization#offload-modules-to-cpu-and-disk
+                        for more details.
+                        """
+                    )
+                else:
+                    logger.info(
+                        "Some modules are are offloaded to the CPU or the disk. Note that these modules will be converted to 8-bit"
+                    )
+        del device_map_without_some_modules
+    return device_map
+
+
+def replace_with_bnb_layers(model, bnb_quantization_config, modules_to_not_convert=None, current_key_name=None):
+    """
+    A helper function to replace all `torch.nn.Linear` modules by `bnb.nn.Linear8bit` modules or by `bnb.nn.Linear4bit`
+    modules from the `bitsandbytes`library. The function will be run recursively and replace `torch.nn.Linear` modules.
+
+    Parameters:
+        model (`torch.nn.Module`):
+            Input model or `torch.nn.Module` as the function is run recursively.
+        modules_to_not_convert (`List[str]`):
+            Names of the modules to not quantize convert. In practice we keep the `lm_head` in full precision for
+            numerical stability reasons.
+        current_key_name (`List[str]`, *optional*):
+            An array to track the current key of the recursion. This is used to check whether the current key (part of
+            it) is not in the list of modules to not convert.
+    """
+
+    if modules_to_not_convert is None:
+        modules_to_not_convert = []
+
+    model, has_been_replaced = _replace_with_bnb_layers(
+        model, bnb_quantization_config, modules_to_not_convert, current_key_name
+    )
+    if not has_been_replaced:
+        logger.warning(
+            "You are loading your model in 8bit or 4bit but no linear modules were found in your model."
+            " this can happen for some architectures such as gpt2 that uses Conv1D instead of Linear layers."
+            " Please double check your model architecture, or submit an issue on github if you think this is"
+            " a bug."
+        )
+    return model
+
+
+def _replace_with_bnb_layers(
+    model,
+    bnb_quantization_config,
+    modules_to_not_convert=None,
+    current_key_name=None,
+):
+    """
+    Private method that wraps the recursion for module replacement.
+
+    Returns the converted model and a boolean that indicates if the conversion has been successfull or not.
+    """
+    # bitsandbytes will initialize CUDA on import, so it needs to be imported lazily
+    import bitsandbytes as bnb
+
+    has_been_replaced = False
+    for name, module in model.named_children():
+        if current_key_name is None:
+            current_key_name = []
+        current_key_name.append(name)
+        if isinstance(module, nn.Linear) and name not in modules_to_not_convert:
+            # Check if the current key is not in the `modules_to_not_convert`
+            current_key_name_str = ".".join(current_key_name)
+            proceed = True
+            for key in modules_to_not_convert:
+                if (
+                    (key in current_key_name_str) and (key + "." in current_key_name_str)
+                ) or key == current_key_name_str:
+                    proceed = False
+                    break
+            if proceed:
+                # Load bnb module with empty weight and replace ``nn.Linear` module
+                if bnb_quantization_config.load_in_8bit:
+                    bnb_module = bnb.nn.Linear8bitLt(
+                        module.in_features,
+                        module.out_features,
+                        module.bias is not None,
+                        has_fp16_weights=False,
+                        threshold=bnb_quantization_config.llm_int8_threshold,
+                    )
+                elif bnb_quantization_config.load_in_4bit:
+                    bnb_module = bnb.nn.Linear4bit(
+                        module.in_features,
+                        module.out_features,
+                        module.bias is not None,
+                        bnb_quantization_config.bnb_4bit_compute_dtype,
+                        compress_statistics=bnb_quantization_config.bnb_4bit_use_double_quant,
+                        quant_type=bnb_quantization_config.bnb_4bit_quant_type,
+                    )
+                else:
+                    raise ValueError("load_in_8bit and load_in_4bit can't be both False")
+                bnb_module.weight.data = module.weight.data
+                if module.bias is not None:
+                    bnb_module.bias.data = module.bias.data
+                bnb_module.requires_grad_(False)
+                setattr(model, name, bnb_module)
+                has_been_replaced = True
+        if len(list(module.children())) > 0:
+            _, _has_been_replaced = _replace_with_bnb_layers(
+                module, bnb_quantization_config, modules_to_not_convert, current_key_name
+            )
+            has_been_replaced = has_been_replaced | _has_been_replaced
+        # Remove the last key for recursion
+        current_key_name.pop(-1)
+    return model, has_been_replaced
+
+
+def get_keys_to_not_convert(model):
+    r"""
+    An utility function to get the key of the module to keep in full precision if any For example for CausalLM modules
+    we may want to keep the lm_head in full precision for numerical stability reasons. For other architectures, we want
+    to keep the tied weights of the model. The function will return a list of the keys of the modules to not convert in
+    int8.
+
+    Parameters:
+    model (`torch.nn.Module`):
+        Input model
+    """
+    # Create a copy of the model
+    with init_empty_weights():
+        tied_model = deepcopy(model)  # this has 0 cost since it is done inside `init_empty_weights` context manager`
+
+    tied_params = find_tied_parameters(tied_model)
+    # For compatibility with Accelerate < 0.18
+    if isinstance(tied_params, dict):
+        tied_keys = sum(list(tied_params.values()), []) + list(tied_params.keys())
+    else:
+        tied_keys = sum(tied_params, [])
+    has_tied_params = len(tied_keys) > 0
+
+    # Check if it is a base model
+    is_base_model = False
+    if hasattr(model, "base_model_prefix"):
+        is_base_model = not hasattr(model, model.base_model_prefix)
+
+    # Ignore this for base models (BertModel, GPT2Model, etc.)
+    if (not has_tied_params) and is_base_model:
+        return []
+
+    # otherwise they have an attached head
+    list_modules = list(model.named_children())
+    list_last_module = [list_modules[-1][0]]
+
+    # add last module together with tied weights
+    intersection = set(list_last_module) - set(tied_keys)
+    list_untouched = list(set(tied_keys)) + list(intersection)
+
+    # remove ".weight" from the keys
+    names_to_remove = [".weight", ".bias"]
+    filtered_module_names = []
+    for name in list_untouched:
+        for name_to_remove in names_to_remove:
+            if name_to_remove in name:
+                name = name.replace(name_to_remove, "")
+        filtered_module_names.append(name)
+
+    return filtered_module_names
+
+
+def has_4bit_bnb_layers(model):
+    """Check if we have `bnb.nn.Linear4bit` or `bnb.nn.Linear8bitLt` layers inside our model"""
+    # bitsandbytes will initialize CUDA on import, so it needs to be imported lazily
+    import bitsandbytes as bnb
+
+    for m in model.modules():
+        if isinstance(m, bnb.nn.Linear4bit):
+            return True
+    return False
+
+
+def get_parameter_device(parameter: nn.Module):
+    return next(parameter.parameters()).device
+
+
+def quantize_and_offload_8bit(model, param, param_name, new_dtype, offload_folder, offload_index, fp16_statistics):
+    # if it is not quantized, we quantize and offload the quantized weights and the SCB stats
+    if fp16_statistics is None:
+        set_module_tensor_to_device(model, param_name, 0, dtype=new_dtype, value=param)
+        tensor_name = param_name
+        module = model
+        if "." in tensor_name:
+            splits = tensor_name.split(".")
+            for split in splits[:-1]:
+                new_module = getattr(module, split)
+                if new_module is None:
+                    raise ValueError(f"{module} has no attribute {split}.")
+                module = new_module
+            tensor_name = splits[-1]
+        # offload weights
+        module._parameters[tensor_name].requires_grad = False
+        offload_weight(module._parameters[tensor_name], param_name, offload_folder, index=offload_index)
+        if hasattr(module._parameters[tensor_name], "SCB"):
+            offload_weight(
+                module._parameters[tensor_name].SCB,
+                param_name.replace("weight", "SCB"),
+                offload_folder,
+                index=offload_index,
+            )
+    else:
+        offload_weight(param, param_name, offload_folder, index=offload_index)
+        offload_weight(fp16_statistics, param_name.replace("weight", "SCB"), offload_folder, index=offload_index)
+
+    set_module_tensor_to_device(model, param_name, "meta", dtype=new_dtype, value=torch.empty(*param.size()))
diff --git a/llm/Lib/site-packages/accelerate/utils/constants.py b/llm/Lib/site-packages/accelerate/utils/constants.py
new file mode 100644
index 0000000000000000000000000000000000000000..8c299570757cb6a5df93f4794e403d1581dd7c2e
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/constants.py
@@ -0,0 +1,72 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import operator as op
+
+
+SCALER_NAME = "scaler.pt"
+MODEL_NAME = "pytorch_model"
+SAFE_MODEL_NAME = "model"
+RNG_STATE_NAME = "random_states"
+OPTIMIZER_NAME = "optimizer"
+SCHEDULER_NAME = "scheduler"
+SAMPLER_NAME = "sampler"
+WEIGHTS_NAME = f"{MODEL_NAME}.bin"
+WEIGHTS_INDEX_NAME = f"{WEIGHTS_NAME}.index.json"
+SAFE_WEIGHTS_NAME = f"{SAFE_MODEL_NAME}.safetensors"
+SAFE_WEIGHTS_INDEX_NAME = f"{SAFE_WEIGHTS_NAME}.index.json"
+SAGEMAKER_PYTORCH_VERSION = "1.10.2"
+SAGEMAKER_PYTHON_VERSION = "py38"
+SAGEMAKER_TRANSFORMERS_VERSION = "4.17.0"
+SAGEMAKER_PARALLEL_EC2_INSTANCES = ["ml.p3.16xlarge", "ml.p3dn.24xlarge", "ml.p4dn.24xlarge"]
+FSDP_SHARDING_STRATEGY = ["FULL_SHARD", "SHARD_GRAD_OP", "NO_SHARD", "HYBRID_SHARD", "HYBRID_SHARD_ZERO2"]
+FSDP_AUTO_WRAP_POLICY = ["TRANSFORMER_BASED_WRAP", "SIZE_BASED_WRAP", "NO_WRAP"]
+FSDP_BACKWARD_PREFETCH = ["BACKWARD_PRE", "BACKWARD_POST", "NO_PREFETCH"]
+FSDP_STATE_DICT_TYPE = ["FULL_STATE_DICT", "LOCAL_STATE_DICT", "SHARDED_STATE_DICT"]
+FSDP_PYTORCH_VERSION = "2.1.0"
+FSDP_MODEL_NAME = "pytorch_model_fsdp"
+DEEPSPEED_MULTINODE_LAUNCHERS = ["pdsh", "standard", "openmpi", "mvapich", "mpich"]
+TORCH_DYNAMO_MODES = ["default", "reduce-overhead", "max-autotune"]
+
+STR_OPERATION_TO_FUNC = {">": op.gt, ">=": op.ge, "==": op.eq, "!=": op.ne, "<=": op.le, "<": op.lt}
+
+# These are the args for `torch.distributed.launch` for pytorch < 1.9
+TORCH_LAUNCH_PARAMS = [
+    "nnodes",
+    "nproc_per_node",
+    "rdzv_backend",
+    "rdzv_endpoint",
+    "rdzv_id",
+    "rdzv_conf",
+    "standalone",
+    "max_restarts",
+    "monitor_interval",
+    "start_method",
+    "role",
+    "module",
+    "m",
+    "no_python",
+    "run_path",
+    "log_dir",
+    "r",
+    "redirects",
+    "t",
+    "tee",
+    "node_rank",
+    "master_addr",
+    "master_port",
+]
+
+CUDA_DISTRIBUTED_TYPES = ["DEEPSPEED", "MULTI_GPU", "FSDP", "MEGATRON_LM"]
+TORCH_DISTRIBUTED_OPERATION_TYPES = CUDA_DISTRIBUTED_TYPES + ["MULTI_NPU", "MULTI_MLU", "MULTI_XPU", "MULTI_CPU"]
diff --git a/llm/Lib/site-packages/accelerate/utils/dataclasses.py b/llm/Lib/site-packages/accelerate/utils/dataclasses.py
new file mode 100644
index 0000000000000000000000000000000000000000..63e8a3a49f7c765214d53c30a279097671c8838e
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/dataclasses.py
@@ -0,0 +1,1717 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+General namespace and dataclass related classes
+"""
+
+import argparse
+import copy
+import enum
+import functools
+import os
+import typing
+import warnings
+from contextlib import contextmanager
+from dataclasses import dataclass, field
+from datetime import timedelta
+from typing import Any, Callable, Dict, Iterable, List, Literal, Optional, Tuple, get_args
+
+import torch
+
+from .constants import FSDP_AUTO_WRAP_POLICY, FSDP_BACKWARD_PREFETCH, FSDP_SHARDING_STRATEGY, FSDP_STATE_DICT_TYPE
+from .environment import str_to_bool
+from .imports import is_cuda_available, is_npu_available, is_xpu_available
+from .versions import compare_versions
+
+
+class KwargsHandler:
+    """
+    Internal mixin that implements a `to_kwargs()` method for a dataclass.
+    """
+
+    def to_dict(self):
+        return copy.deepcopy(self.__dict__)
+
+    def to_kwargs(self):
+        """
+        Returns a dictionary containing the attributes with values different from the default of this class.
+        """
+        # import clear_environment here to avoid circular import problem
+        from .other import clear_environment
+
+        with clear_environment():
+            default_dict = self.__class__().to_dict()
+        this_dict = self.to_dict()
+        return {k: v for k, v in this_dict.items() if default_dict[k] != v}
+
+
+@dataclass
+class AutocastKwargs(KwargsHandler):
+    """
+    Use this object in your [`Accelerator`] to customize how `torch.autocast` behaves. Please refer to the
+    documentation of this [context manager](https://pytorch.org/docs/stable/amp.html#torch.autocast) for more
+    information on each argument.
+
+    Example:
+
+    ```python
+    from accelerate import Accelerator
+    from accelerate.utils import AutocastKwargs
+
+    kwargs = AutocastKwargs(cache_enabled=True)
+    accelerator = Accelerator(kwargs_handlers=[kwargs])
+    ```
+    """
+
+    enabled: bool = True
+    cache_enabled: bool = None
+
+
+@dataclass
+class DistributedDataParallelKwargs(KwargsHandler):
+    """
+    Use this object in your [`Accelerator`] to customize how your model is wrapped in a
+    `torch.nn.parallel.DistributedDataParallel`. Please refer to the documentation of this
+    [wrapper](https://pytorch.org/docs/stable/generated/torch.nn.parallel.DistributedDataParallel.html) for more
+    information on each argument.
+
+    <Tip warning={true}>
+
+    `gradient_as_bucket_view` is only available in PyTorch 1.7.0 and later versions.
+
+    `static_graph` is only available in PyTorch 1.11.0 and later versions.
+
+    </Tip>
+
+    Example:
+
+    ```python
+    from accelerate import Accelerator
+    from accelerate.utils import DistributedDataParallelKwargs
+
+    kwargs = DistributedDataParallelKwargs(find_unused_parameters=True)
+    accelerator = Accelerator(kwargs_handlers=[kwargs])
+    ```
+    """
+
+    dim: int = 0
+    broadcast_buffers: bool = True
+    bucket_cap_mb: int = 25
+    find_unused_parameters: bool = False
+    check_reduction: bool = False
+    gradient_as_bucket_view: bool = False
+    static_graph: bool = False
+
+
+@dataclass
+class GradScalerKwargs(KwargsHandler):
+    """
+    Use this object in your [`Accelerator`] to customize the behavior of mixed precision, specifically how the
+    `torch.cuda.amp.GradScaler` used is created. Please refer to the documentation of this
+    [scaler](https://pytorch.org/docs/stable/amp.html?highlight=gradscaler) for more information on each argument.
+
+    <Tip warning={true}>
+
+    `GradScaler` is only available in PyTorch 1.5.0 and later versions.
+
+    </Tip>
+
+    Example:
+
+    ```python
+    from accelerate import Accelerator
+    from accelerate.utils import GradScalerKwargs
+
+    kwargs = GradScalerKwargs(backoff_filter=0.25)
+    accelerator = Accelerator(kwargs_handlers=[kwargs])
+    ```
+    """
+
+    init_scale: float = 65536.0
+    growth_factor: float = 2.0
+    backoff_factor: float = 0.5
+    growth_interval: int = 2000
+    enabled: bool = True
+
+
+@dataclass
+class InitProcessGroupKwargs(KwargsHandler):
+    """
+    Use this object in your [`Accelerator`] to customize the initialization of the distributed processes. Please refer
+    to the documentation of this
+    [method](https://pytorch.org/docs/stable/distributed.html#torch.distributed.init_process_group) for more
+    information on each argument.
+
+    ```python
+    from datetime import timedelta
+    from accelerate import Accelerator
+    from accelerate.utils import InitProcessGroupKwargs
+
+    kwargs = InitProcessGroupKwargs(timeout=timedelta(seconds=800))
+    accelerator = Accelerator(kwargs_handlers=[kwargs])
+    ```
+    """
+
+    backend: Optional[str] = "nccl"
+    init_method: Optional[str] = None
+    timeout: timedelta = timedelta(seconds=1800)
+
+
+# Literals
+Backend = Literal["MSAMP", "TE"]
+OptLevel = Literal["O1", "O2"]
+FP8Format = Literal["E4M3", "HYBRID"]
+AmaxComputeAlgorithm = Literal["max", "most_recent"]
+
+
+@dataclass
+class FP8RecipeKwargs(KwargsHandler):
+    """
+    Use this object in your [`Accelerator`] to customize the initialization of the recipe for FP8 mixed precision
+    training with `transformer-engine` or `ms-amp`.
+
+    <Tip>
+
+        For more information on `transformer-engine` args, please refer to the API
+        [documentation](https://docs.nvidia.com/deeplearning/transformer-engine/user-guide/api/common.html).
+
+        For more information on the `ms-amp` args, please refer to the Optimization Level
+        [documentation](https://azure.github.io/MS-AMP/docs/user-tutorial/optimization-level).
+
+    </Tip>
+
+    ```python
+    from accelerate import Accelerator
+    from accelerate.utils import FP8RecipeKwargs
+
+    kwargs = FP8RecipeKwargs(backend="te", fp8_format="HYBRID")
+    accelerator = Accelerator(mixed_precision="fp8", kwargs_handlers=[kwargs])
+    ```
+
+    To use MS-AMP as an engine, pass `backend="msamp"` and the `optimization_level`:
+
+    ```python
+    kwargs = FP8RecipeKwargs(backend="msamp", optimization_level="02")
+    ```
+
+    Args:
+        backend (`str`, *optional*, defaults to "msamp"):
+            Which FP8 engine to use. Must be one of `"msamp"` (MS-AMP) or `"te"` (TransformerEngine).
+        margin (`int`, *optional*, default to 0):
+            The margin to use for the gradient scaling.
+        interval (`int`, *optional*, default to 1):
+            The interval to use for how often the scaling factor is recomputed.
+        fp8_format (`str`, *optional*, default to "E4M3"):
+            The format to use for the FP8 recipe. Must be one of `E4M3` or `HYBRID`.
+        amax_history_len (`int`, *optional*, default to 1024):
+            The length of the history to use for the scaling factor computation
+        amax_compute_algo (`str`, *optional*, default to "most_recent"):
+            The algorithm to use for the scaling factor computation. Must be one of `max` or `most_recent`.
+        override_linear_precision (`tuple` of three `bool`, *optional*, default to `(False, False, False)`):
+            Whether or not to execute `fprop`, `dgrad`, and `wgrad` GEMMS in higher precision.
+        optimization_level (`str`), one of `O1`, `O2`. (default is `O2`):
+            What level of 8-bit collective communication should be used with MS-AMP. In general:
+                * O1: Weight gradients and `all_reduce` communications are done in fp8, reducing GPU
+                    memory usage and communication bandwidth
+                * O2: First-order optimizer states are in 8-bit, and second order states are in FP16.
+                    Only available when using Adam or AdamW. This maintains accuracy and can potentially save the
+                    highest memory.
+                * 03: Specifically for DeepSpeed, implements capabilities so weights and master weights of models
+                    are stored in FP8. If `fp8` is selected and deepspeed is enabled, will be used by default. (Not
+                    available currently).
+    """
+
+    backend: Backend = "MSAMP"
+    opt_level: OptLevel = "O2"
+    margin: int = 0
+    interval: int = 1
+    fp8_format: FP8Format = "E4M3"
+    amax_history_len: int = 1
+    amax_compute_algo: AmaxComputeAlgorithm = "most_recent"
+    override_linear_precision: Tuple[bool, bool, bool] = (False, False, False)
+
+    def __post_init__(self):
+        if self.backend.upper() not in get_args(Backend):
+            raise ValueError("`backend` must be 'MSAMP' or 'TE' (TransformerEngine).")
+
+        self.backend = self.backend.upper()
+        # Check TE args
+        if self.backend == "TE":
+            self.fp8_format = self.fp8_format.upper()
+            if self.fp8_format not in get_args(FP8Format):
+                raise ValueError(f"`fp8_format` must be one of {' or '.join(get_args(FP8Format))}.")
+            if self.amax_compute_algo not in get_args(AmaxComputeAlgorithm):
+                raise ValueError(f"`amax_compute_algo` must be one of {' or '.join(get_args(AmaxComputeAlgorithm))}")
+        elif self.backend == "MSAMP":
+            if self.opt_level not in get_args(OptLevel):
+                raise ValueError(f"`optimization_level` must be one of {' or '.join(get_args(OptLevel))}")
+
+
+class EnumWithContains(enum.EnumMeta):
+    "A metaclass that adds the ability to check if `self` contains an item with the `in` operator"
+
+    def __contains__(cls, item):
+        try:
+            cls(item)
+        except ValueError:
+            return False
+        return True
+
+
+class BaseEnum(enum.Enum, metaclass=EnumWithContains):
+    "An enum class that can get the value of an item with `str(Enum.key)`"
+
+    def __str__(self):
+        return self.value
+
+    @classmethod
+    def list(cls):
+        "Method to list all the possible items in `cls`"
+        return list(map(str, cls))
+
+
+class DeprecatedFieldDescriptor:
+    """
+    Descriptor for deprecated fields in an enum class.
+
+    Args:
+        field_name (`str`):
+            The name of the deprecated field.
+        replaced_with (`str`):
+            The name of the field that replaces the deprecated one.
+    """
+
+    def __init__(self, field_name, replaced_with):
+        self.field_name = field_name
+        self.replaced_with = replaced_with
+
+    def __get__(self, instance, owner):
+        warnings.warn(
+            f"The `{self.field_name}` of `{owner}` is deprecated and will be removed in v1.0.0. "
+            f"Please use the `{self.replaced_with}` instead.",
+            FutureWarning,
+        )
+        return getattr(owner, self.replaced_with)
+
+
+class DistributedType(str, enum.Enum):
+    """
+    Represents a type of distributed environment.
+
+    Values:
+
+        - **NO** -- Not a distributed environment, just a single process.
+        - **MULTI_CPU** -- Distributed on multiple CPU nodes.
+        - **MULTI_GPU** -- Distributed on multiple GPUs.
+        - **MULTI_MLU** -- Distributed on multiple MLUs.
+        - **MULTI_NPU** -- Distributed on multiple NPUs.
+        - **MULTI_XPU** -- Distributed on multiple XPUs.
+        - **DEEPSPEED** -- Using DeepSpeed.
+        - **XLA** -- Using TorchXLA.
+        - **TPU** -- This field will be deprecated in v0.27.0. Use XLA instead.
+    """
+
+    # Subclassing str as well as Enum allows the `DistributedType` to be JSON-serializable out of the box.
+    NO = "NO"
+    MULTI_CPU = "MULTI_CPU"
+    MULTI_GPU = "MULTI_GPU"
+    MULTI_NPU = "MULTI_NPU"
+    MULTI_MLU = "MULTI_MLU"
+    MULTI_XPU = "MULTI_XPU"
+    DEEPSPEED = "DEEPSPEED"
+    FSDP = "FSDP"
+    XLA = "XLA"
+    MEGATRON_LM = "MEGATRON_LM"
+    TPU = DeprecatedFieldDescriptor("TPU", "XLA")
+
+
+class SageMakerDistributedType(str, enum.Enum):
+    """
+    Represents a type of distributed environment.
+
+    Values:
+
+        - **NO** -- Not a distributed environment, just a single process.
+        - **DATA_PARALLEL** -- using sagemaker distributed data parallelism.
+        - **MODEL_PARALLEL** -- using sagemaker distributed model parallelism.
+    """
+
+    # Subclassing str as well as Enum allows the `SageMakerDistributedType` to be JSON-serializable out of the box.
+    NO = "NO"
+    DATA_PARALLEL = "DATA_PARALLEL"
+    MODEL_PARALLEL = "MODEL_PARALLEL"
+
+
+class ComputeEnvironment(str, enum.Enum):
+    """
+    Represents a type of the compute environment.
+
+    Values:
+
+        - **LOCAL_MACHINE** -- private/custom cluster hardware.
+        - **AMAZON_SAGEMAKER** -- Amazon SageMaker as compute environment.
+    """
+
+    # Subclassing str as well as Enum allows the `ComputeEnvironment` to be JSON-serializable out of the box.
+    LOCAL_MACHINE = "LOCAL_MACHINE"
+    AMAZON_SAGEMAKER = "AMAZON_SAGEMAKER"
+
+
+class DynamoBackend(str, BaseEnum):
+    """
+    Represents a dynamo backend (see https://pytorch.org/docs/stable/torch.compiler.html).
+
+    Values:
+
+        - **NO** -- Do not use torch dynamo.
+        - **EAGER** -- Uses PyTorch to run the extracted GraphModule. This is quite useful in debugging TorchDynamo
+          issues.
+        - **AOT_EAGER** -- Uses AotAutograd with no compiler, i.e, just using PyTorch eager for the AotAutograd's
+          extracted forward and backward graphs. This is useful for debugging, and unlikely to give speedups.
+        - **INDUCTOR** -- Uses TorchInductor backend with AotAutograd and cudagraphs by leveraging codegened Triton
+          kernels. [Read
+          more](https://dev-discuss.pytorch.org/t/torchinductor-a-pytorch-native-compiler-with-define-by-run-ir-and-symbolic-shapes/747)
+        - **AOT_TS_NVFUSER** -- nvFuser with AotAutograd/TorchScript. [Read
+          more](https://dev-discuss.pytorch.org/t/tracing-with-primitives-update-1-nvfuser-and-its-primitives/593)
+        - **NVPRIMS_NVFUSER** -- nvFuser with PrimTorch. [Read
+          more](https://dev-discuss.pytorch.org/t/tracing-with-primitives-update-1-nvfuser-and-its-primitives/593)
+        - **CUDAGRAPHS** -- cudagraphs with AotAutograd. [Read more](https://github.com/pytorch/torchdynamo/pull/757)
+        - **OFI** -- Uses Torchscript optimize_for_inference. Inference only. [Read
+          more](https://pytorch.org/docs/stable/generated/torch.jit.optimize_for_inference.html)
+        - **FX2TRT** -- Uses Nvidia TensorRT for inference optimizations. Inference only. [Read
+          more](https://github.com/pytorch/TensorRT/blob/master/docsrc/tutorials/getting_started_with_fx_path.rst)
+        - **ONNXRT** -- Uses ONNXRT for inference on CPU/GPU. Inference only. [Read more](https://onnxruntime.ai/)
+        - **TENSORRT** -- Uses ONNXRT to run TensorRT for inference optimizations. [Read
+          more](https://github.com/onnx/onnx-tensorrt)
+        - **IPEX** -- Uses IPEX for inference on CPU. Inference only. [Read
+          more](https://github.com/intel/intel-extension-for-pytorch).
+        - **TVM** -- Uses Apach TVM for inference optimizations. [Read more](https://tvm.apache.org/)
+
+    """
+
+    # Subclassing str as well as Enum allows the `SageMakerDistributedType` to be JSON-serializable out of the box.
+    NO = "NO"
+    EAGER = "EAGER"
+    AOT_EAGER = "AOT_EAGER"
+    INDUCTOR = "INDUCTOR"
+    AOT_TS_NVFUSER = "AOT_TS_NVFUSER"
+    NVPRIMS_NVFUSER = "NVPRIMS_NVFUSER"
+    CUDAGRAPHS = "CUDAGRAPHS"
+    OFI = "OFI"
+    FX2TRT = "FX2TRT"
+    ONNXRT = "ONNXRT"
+    TENSORRT = "TENSORRT"
+    IPEX = "IPEX"
+    TVM = "TVM"
+
+
+class LoggerType(BaseEnum):
+    """Represents a type of supported experiment tracker
+
+    Values:
+
+        - **ALL** -- all available trackers in the environment that are supported
+        - **TENSORBOARD** -- TensorBoard as an experiment tracker
+        - **WANDB** -- wandb as an experiment tracker
+        - **COMETML** -- comet_ml as an experiment tracker
+        - **DVCLIVE** -- dvclive as an experiment tracker
+    """
+
+    ALL = "all"
+    AIM = "aim"
+    TENSORBOARD = "tensorboard"
+    WANDB = "wandb"
+    COMETML = "comet_ml"
+    MLFLOW = "mlflow"
+    CLEARML = "clearml"
+    DVCLIVE = "dvclive"
+
+
+class PrecisionType(BaseEnum):
+    """Represents a type of precision used on floating point values
+
+    Values:
+
+        - **NO** -- using full precision (FP32)
+        - **FP16** -- using half precision
+        - **BF16** -- using brain floating point precision
+    """
+
+    NO = "no"
+    FP8 = "fp8"
+    FP16 = "fp16"
+    BF16 = "bf16"
+
+
+class RNGType(BaseEnum):
+    TORCH = "torch"
+    CUDA = "cuda"
+    MLU = "mlu"
+    NPU = "npu"
+    XLA = "xla"
+    XPU = "xpu"
+    GENERATOR = "generator"
+
+
+class CustomDtype(enum.Enum):
+    r"""
+    An enum that contains multiple custom dtypes that can be used for `infer_auto_device_map`.
+    """
+
+    FP8 = "fp8"
+    INT4 = "int4"
+    INT2 = "int2"
+
+
+# data classes
+
+
+@dataclass
+class TensorInformation:
+    shape: torch.Size
+    dtype: torch.dtype
+
+
+@dataclass
+class DataLoaderConfiguration:
+    """
+    Configuration for dataloader-related items when calling `accelerator.prepare`.
+    """
+
+    split_batches: bool = field(
+        default=False,
+        metadata={
+            "help": "Whether or not the accelerator should split the batches yielded by the dataloaders across the devices. If"
+            " `True` the actual batch size used will be the same on any kind of distributed processes, but it must be a"
+            " round multiple of the `num_processes` you are using. If `False`, actual batch size used will be the one set"
+            " in your script multiplied by the number of processes."
+        },
+    )
+    dispatch_batches: bool = field(
+        default=None,
+        metadata={
+            "help": "If set to `True`, the dataloader prepared by the Accelerator is only iterated through on the main process"
+            " and then the batches are split and broadcast to each process. Will default to `True` for `DataLoader` whose"
+            " underlying dataset is an `IterableDataslet`, `False` otherwise."
+        },
+    )
+    even_batches: bool = field(
+        default=True,
+        metadata={
+            "help": "If set to `True`, in cases where the total batch size across all processes does not exactly divide the"
+            " dataset, samples at the start of the dataset will be duplicated so the batch can be divided equally among"
+            " all workers."
+        },
+    )
+    use_seedable_sampler: bool = field(
+        default=False,
+        metadata={
+            "help": "Whether or not use a fully seedable random sampler ([`data_loader.SeedableRandomSampler`])."
+            "Ensures training results are fully reproducable using a different sampling technique. "
+            "While seed-to-seed results may differ, on average the differences are neglible when using"
+            "multiple different seeds to compare. Should also be ran with [`~utils.set_seed`] for the best results."
+        },
+    )
+
+
+@dataclass
+class ProjectConfiguration:
+    """
+    Configuration for the Accelerator object based on inner-project needs.
+    """
+
+    project_dir: str = field(default=None, metadata={"help": "A path to a directory for storing data."})
+    logging_dir: str = field(
+        default=None,
+        metadata={
+            "help": "A path to a directory for storing logs of locally-compatible loggers. If None, defaults to `project_dir`."
+        },
+    )
+    automatic_checkpoint_naming: bool = field(
+        default=False,
+        metadata={"help": "Whether saved states should be automatically iteratively named."},
+    )
+
+    total_limit: int = field(
+        default=None,
+        metadata={"help": "The maximum number of total saved states to keep."},
+    )
+
+    iteration: int = field(
+        default=0,
+        metadata={"help": "The current save iteration."},
+    )
+
+    save_on_each_node: bool = field(
+        default=False,
+        metadata={
+            "help": (
+                "When doing multi-node distributed training, whether to save models and checkpoints on each node, or"
+                " only on the main one"
+            )
+        },
+    )
+
+    def set_directories(self, project_dir: str = None):
+        "Sets `self.project_dir` and `self.logging_dir` to the appropriate values."
+        self.project_dir = project_dir
+        if self.logging_dir is None:
+            self.logging_dir = project_dir
+
+    def __post_init__(self):
+        self.set_directories(self.project_dir)
+
+
+@dataclass
+class GradientAccumulationPlugin(KwargsHandler):
+    """
+    A plugin to configure gradient accumulation behavior. You can only pass one of `gradient_accumulation_plugin` or
+    `gradient_accumulation_steps` to [`Accelerator`]. Passing both raises an error.
+
+    Parameters:
+        num_steps (`int`):
+            The number of steps to accumulate gradients for.
+        adjust_scheduler (`bool`, *optional*, defaults to `True`):
+            Whether to adjust the scheduler steps to account for the number of steps being accumulated. Should be
+            `True` if the used scheduler was not adjusted for gradient accumulation.
+        sync_with_dataloader (`bool`, *optional*, defaults to `True`):
+            Whether to synchronize setting the gradients when at the end of the dataloader.
+        sync_each_batch (`bool`, *optional*):
+                Whether to synchronize setting the gradients at each data batch. Seting to `True` may reduce memory
+                requirements when using gradient accumulation with distributed training, at expense of speed.
+
+    Example:
+
+    ```python
+    from accelerate.utils import GradientAccumulationPlugin
+
+    gradient_accumulation_plugin = GradientAccumulationPlugin(num_steps=2)
+    accelerator = Accelerator(gradient_accumulation_plugin=gradient_accumulation_plugin)
+    ```
+    """
+
+    num_steps: int = field(default=None, metadata={"help": "The number of steps to accumulate gradients for."})
+    adjust_scheduler: bool = field(
+        default=True,
+        metadata={
+            "help": "Whether to adjust the scheduler steps to account for the number of steps being accumulated. Should be `True` if the used scheduler was not adjusted for gradient accumulation."
+        },
+    )
+    sync_with_dataloader: bool = field(
+        default=True,
+        metadata={
+            "help": "Whether to synchronize setting the gradients when at the end of the dataloader. Should only be set to `False` if you know what you're doing."
+        },
+    )
+    sync_each_batch: bool = field(
+        default=False,
+        metadata={
+            "help": "Whether to synchronize setting the gradients at each data batch. Setting to `True` may reduce memory requirements when using gradient accumulation with distributed training, at expense of speed."
+        },
+    )
+
+
+@dataclass
+class TorchDynamoPlugin(KwargsHandler):
+    """
+    This plugin is used to compile a model with PyTorch 2.0
+    """
+
+    backend: DynamoBackend = field(
+        default=None,
+        metadata={"help": f"Possible options are {[b.value.lower() for b in DynamoBackend]}"},
+    )
+    mode: str = field(
+        default=None, metadata={"help": "Possible options are 'default', 'reduce-overhead' or 'max-autotune'"}
+    )
+    fullgraph: bool = field(default=None, metadata={"help": "Whether it is ok to break model into several subgraphs"})
+    dynamic: bool = field(default=None, metadata={"help": "Whether to use dynamic shape for tracing"})
+    options: Any = field(default=None, metadata={"help": "A dictionary of options to pass to the backend."})
+    disable: bool = field(default=False, metadata={"help": "Turn torch.compile() into a no-op for testing"})
+
+    def __post_init__(self):
+        prefix = "ACCELERATE_DYNAMO_"
+        if self.backend is None:
+            self.backend = os.environ.get(prefix + "BACKEND", "no")
+        self.backend = DynamoBackend(self.backend.upper())
+        if self.mode is None:
+            self.mode = os.environ.get(prefix + "MODE", "default")
+        if self.fullgraph is None:
+            self.fullgraph = str_to_bool(os.environ.get(prefix + "USE_FULLGRAPH", "False")) == 1
+        if self.dynamic is None:
+            self.dynamic = str_to_bool(os.environ.get(prefix + "USE_DYNAMIC", "False")) == 1
+
+    def to_dict(self):
+        dynamo_config = copy.deepcopy(self.__dict__)
+        dynamo_config["backend"] = dynamo_config["backend"].value.lower()
+        return dynamo_config
+
+
+@dataclass
+class DeepSpeedPlugin:
+    """
+    This plugin is used to integrate DeepSpeed.
+    """
+
+    hf_ds_config: Any = field(
+        default=None,
+        metadata={
+            "help": "path to DeepSpeed config file or dict or an object of class `accelerate.utils.deepspeed.HfDeepSpeedConfig`."
+        },
+    )
+    gradient_accumulation_steps: int = field(
+        default=None,
+        metadata={
+            "help": "Number of steps to accumulate gradients before updating optimizer states. If not set, will use the value from the `Accelerator` directly."
+        },
+    )
+    gradient_clipping: float = field(default=None, metadata={"help": "Enable gradient clipping with value"})
+    zero_stage: int = field(
+        default=None,
+        metadata={"help": "Possible options are 0,1,2,3; Default will be taken from environment variable"},
+    )
+    is_train_batch_min: str = field(
+        default=True,
+        metadata={"help": "If both train & eval dataloaders are specified, this will decide the train_batch_size"},
+    )
+    offload_optimizer_device: bool = field(
+        default=None,
+        metadata={"help": "Possible options are none|cpu|nvme. Only applicable with ZeRO Stages 2 and 3."},
+    )
+    offload_param_device: bool = field(
+        default=None,
+        metadata={"help": "Possible options are none|cpu|nvme. Only applicable with ZeRO Stage 3."},
+    )
+    offload_optimizer_nvme_path: str = field(
+        default=None,
+        metadata={"help": "Possible options are /nvme|/local_nvme. Only applicable with ZeRO Stage 3."},
+    )
+    offload_param_nvme_path: str = field(
+        default=None,
+        metadata={"help": "Possible options are /nvme|/local_nvme. Only applicable with ZeRO Stage 3."},
+    )
+    zero3_init_flag: bool = field(
+        default=None,
+        metadata={
+            "help": "Flag to indicate whether to enable `deepspeed.zero.Init` for constructing massive models."
+            "Only applicable with ZeRO Stage-3."
+        },
+    )
+    zero3_save_16bit_model: bool = field(
+        default=None,
+        metadata={"help": "Flag to indicate whether to save 16-bit model. Only applicable with ZeRO Stage-3."},
+    )
+
+    def __post_init__(self):
+        from .deepspeed import HfDeepSpeedConfig
+
+        if self.gradient_accumulation_steps is None:
+            gas = os.environ.get("ACCELERATE_GRADIENT_ACCUMULATION_STEPS", "auto")
+            self.gradient_accumulation_steps = int(gas) if gas.isdigit() else gas
+
+        if self.gradient_clipping is None:
+            gradient_clipping = os.environ.get("ACCELERATE_GRADIENT_CLIPPING", "none")
+            if gradient_clipping != "none":
+                self.gradient_clipping = float(gradient_clipping)
+
+        if self.zero_stage is None:
+            self.zero_stage = int(os.environ.get("ACCELERATE_DEEPSPEED_ZERO_STAGE", 2))
+
+        if self.offload_optimizer_device is None:
+            self.offload_optimizer_device = os.environ.get("ACCELERATE_DEEPSPEED_OFFLOAD_OPTIMIZER_DEVICE", "none")
+
+        if self.offload_param_device is None:
+            self.offload_param_device = os.environ.get("ACCELERATE_DEEPSPEED_OFFLOAD_PARAM_DEVICE", "none")
+
+        if self.offload_optimizer_nvme_path is None:
+            self.offload_optimizer_nvme_path = os.environ.get(
+                "ACCELERATE_DEEPSPEED_OFFLOAD_OPTIMIZER_NVME_PATH", "none"
+            )
+
+        if self.offload_param_nvme_path is None:
+            self.offload_param_nvme_path = os.environ.get("ACCELERATE_DEEPSPEED_OFFLOAD_PARAM_NVME_PATH", "none")
+
+        if self.zero3_save_16bit_model is None:
+            self.zero3_save_16bit_model = (
+                os.environ.get("ACCELERATE_DEEPSPEED_ZERO3_SAVE_16BIT_MODEL", "false") == "true"
+            )
+
+        if self.hf_ds_config is None:
+            self.hf_ds_config = os.environ.get("ACCELERATE_DEEPSPEED_CONFIG_FILE", "none")
+        if (
+            isinstance(self.hf_ds_config, dict)
+            or (isinstance(self.hf_ds_config, str) and self.hf_ds_config != "none")
+            or isinstance(self.hf_ds_config, HfDeepSpeedConfig)
+        ):
+            if not isinstance(self.hf_ds_config, HfDeepSpeedConfig):
+                self.hf_ds_config = HfDeepSpeedConfig(self.hf_ds_config)
+            if "gradient_accumulation_steps" not in self.hf_ds_config.config:
+                self.hf_ds_config.config["gradient_accumulation_steps"] = 1
+            if "zero_optimization" not in self.hf_ds_config.config:
+                raise ValueError("Please specify the ZeRO optimization config in the DeepSpeed config.")
+
+            self._deepspeed_config_checks()
+            plugin_to_config_mapping = {
+                "gradient_accumulation_steps": "gradient_accumulation_steps",
+                "gradient_clipping": "gradient_clipping",
+                "zero_stage": "zero_optimization.stage",
+                "offload_optimizer_device": "zero_optimization.offload_optimizer.device",
+                "offload_param_device": "zero_optimization.offload_param.device",
+                "offload_param_nvme_path": "zero_optimization.offload_param.nvme_path",
+                "offload_optimizer_nvme_path": "zero_optimization.offload_optimizer.nvme_path",
+                "zero3_save_16bit_model": "zero_optimization.stage3_gather_16bit_weights_on_model_save",
+            }
+            kwargs = {v: getattr(self, k) for k, v in plugin_to_config_mapping.items() if getattr(self, k) is not None}
+            for key in kwargs.keys():
+                self.fill_match(key, **kwargs, must_match=False)
+            self.hf_ds_config.set_stage_and_offload()
+
+            # filling the missing values in the class attributes from the DeepSpeed config
+            # when using the DeepSpeed config file.
+            for key, value in plugin_to_config_mapping.items():
+                config_value = self.hf_ds_config.get_value(value)
+                if config_value is not None and config_value != "auto":
+                    setattr(self, key, config_value)
+        else:
+            config = {
+                "train_batch_size": "auto",
+                "train_micro_batch_size_per_gpu": "auto",
+                "gradient_accumulation_steps": self.gradient_accumulation_steps,
+                "zero_optimization": {
+                    "stage": self.zero_stage,
+                    "offload_optimizer": {
+                        "device": self.offload_optimizer_device,
+                        "nvme_path": self.offload_optimizer_nvme_path
+                        if self.offload_optimizer_device == "nvme"
+                        else None,
+                    },
+                    "offload_param": {
+                        "device": self.offload_param_device,
+                        "nvme_path": self.offload_param_nvme_path if self.offload_param_device == "nvme" else None,
+                    },
+                    "stage3_gather_16bit_weights_on_model_save": self.zero3_save_16bit_model,
+                },
+            }
+            if self.gradient_clipping:
+                config["gradient_clipping"] = self.gradient_clipping
+            self.hf_ds_config = HfDeepSpeedConfig(config)
+
+        self.deepspeed_config = self.hf_ds_config.config
+        self.deepspeed_config["steps_per_print"] = float("inf")  # this will stop deepspeed from logging @ stdout
+        if self.zero3_init_flag is None:
+            self.zero3_init_flag = (
+                str_to_bool(os.environ.get("ACCELERATE_DEEPSPEED_ZERO3_INIT", str(self.hf_ds_config.is_zero3()))) == 1
+            )
+        if self.zero3_init_flag and not self.hf_ds_config.is_zero3():
+            warnings.warn("DeepSpeed Zero3 Init flag is only applicable for ZeRO Stage 3. Setting it to False.")
+            self.zero3_init_flag = False
+
+    def fill_match(self, ds_key_long, mismatches=None, must_match=True, **kwargs):
+        mismatches = [] if mismatches is None else mismatches
+        config, ds_key = self.hf_ds_config.find_config_node(ds_key_long)
+        if config is None:
+            return
+
+        if config.get(ds_key) == "auto":
+            if ds_key_long in kwargs:
+                config[ds_key] = kwargs[ds_key_long]
+                return
+            else:
+                raise ValueError(
+                    f"`{ds_key_long}` not found in kwargs. "
+                    f"Please specify `{ds_key_long}` without `auto` (set to correct value) in the DeepSpeed config file or "
+                    "pass it in kwargs."
+                )
+
+        if not must_match:
+            return
+
+        ds_val = config.get(ds_key)
+        if ds_val is not None and ds_key_long in kwargs:
+            if ds_val != kwargs[ds_key_long]:
+                mismatches.append(f"- ds {ds_key_long}={ds_val} vs arg {ds_key_long}={kwargs[ds_key_long]}")
+
+    def is_auto(self, ds_key_long):
+        val = self.hf_ds_config.get_value(ds_key_long)
+        if val is None:
+            return False
+        else:
+            return val == "auto"
+
+    def get_value(self, ds_key_long, default=None):
+        return self.hf_ds_config.get_value(ds_key_long, default)
+
+    def deepspeed_config_process(self, prefix="", mismatches=None, config=None, must_match=True, **kwargs):
+        """Process the DeepSpeed config with the values from the kwargs."""
+        mismatches = [] if mismatches is None else mismatches
+        if config is None:
+            config = self.deepspeed_config
+        for key, value in config.items():
+            if isinstance(value, dict):
+                self.deepspeed_config_process(
+                    prefix=prefix + key + ".", mismatches=mismatches, config=value, must_match=must_match, **kwargs
+                )
+            else:
+                self.fill_match(prefix + key, mismatches, must_match=must_match, **kwargs)
+        if len(mismatches) > 0 and prefix == "":
+            mismatches_msg = "\n".join(mismatches)
+            raise ValueError(
+                "Please correct the following DeepSpeed config values that mismatch kwargs "
+                f" values:\n{mismatches_msg}\nThe easiest method is to set these DeepSpeed config values to 'auto'."
+            )
+
+    def set_mixed_precision(self, mixed_precision):
+        ds_config = self.deepspeed_config
+        kwargs = {
+            "fp16.enabled": mixed_precision == "fp16",
+            "bf16.enabled": mixed_precision == "bf16",
+        }
+        if mixed_precision == "fp16":
+            if "fp16" not in ds_config:
+                ds_config["fp16"] = {"enabled": True, "auto_cast": True}
+        elif mixed_precision == "bf16":
+            if "bf16" not in ds_config:
+                ds_config["bf16"] = {"enabled": True}
+
+        if mixed_precision != "no":
+            diff_dtype = "bf16" if mixed_precision == "fp16" else "fp16"
+            if str(ds_config.get(diff_dtype, {}).get("enabled", "False")).lower() == "true":
+                raise ValueError(
+                    f"`--mixed_precision` arg cannot be set to `{mixed_precision}` when `{diff_dtype}` is set in the DeepSpeed config file."
+                )
+        for dtype in ["fp16", "bf16"]:
+            if dtype not in ds_config:
+                ds_config[dtype] = {"enabled": False}
+        self.fill_match("fp16.enabled", must_match=False, **kwargs)
+        self.fill_match("bf16.enabled", must_match=False, **kwargs)
+
+    def set_deepspeed_weakref(self):
+        from .imports import is_transformers_available
+
+        if self.zero3_init_flag:
+            if not is_transformers_available():
+                raise Exception(
+                    "When `zero3_init_flag` is set, it requires Transformers to be installed. "
+                    "Please run `pip install transformers`."
+                )
+            ds_config = copy.deepcopy(self.deepspeed_config)
+            if "gradient_accumulation_steps" not in ds_config or ds_config["gradient_accumulation_steps"] == "auto":
+                ds_config["gradient_accumulation_steps"] = 1
+            if (
+                "train_micro_batch_size_per_gpu" not in ds_config
+                or ds_config["train_micro_batch_size_per_gpu"] == "auto"
+            ):
+                ds_config["train_micro_batch_size_per_gpu"] = 1
+            if ds_config.get("train_batch_size", None) == "auto":
+                del ds_config["train_batch_size"]
+
+            if compare_versions("transformers", "<", "4.33"):
+                from transformers.deepspeed import HfDeepSpeedConfig
+            else:
+                from transformers.integrations import HfDeepSpeedConfig
+
+            self.dschf = HfDeepSpeedConfig(ds_config)  # keep this object alive # noqa
+
+    def is_zero3_init_enabled(self):
+        return self.zero3_init_flag
+
+    @contextmanager
+    def zero3_init_context_manager(self, enable=False):
+        old = self.zero3_init_flag
+        if old == enable:
+            yield
+        else:
+            self.zero3_init_flag = enable
+            self.dschf = None
+            self.set_deepspeed_weakref()
+            yield
+            self.zero3_init_flag = old
+            self.dschf = None
+            self.set_deepspeed_weakref()
+
+    def _deepspeed_config_checks(self):
+        env_variable_names_to_ignore = [
+            "ACCELERATE_GRADIENT_ACCUMULATION_STEPS",
+            "ACCELERATE_GRADIENT_CLIPPING",
+            "ACCELERATE_DEEPSPEED_ZERO_STAGE",
+            "ACCELERATE_DEEPSPEED_OFFLOAD_OPTIMIZER_DEVICE",
+            "ACCELERATE_DEEPSPEED_OFFLOAD_PARAM_DEVICE",
+            "ACCELERATE_DEEPSPEED_OFFLOAD_PARAM_NVME_PATH",
+            "ACCELERATE_DEEPSPEED_OFFLOAD_OPTIMIZER_NVME_PATH",
+            "ACCELERATE_DEEPSPEED_ZERO3_SAVE_16BIT_MODEL",
+            "ACCELERATE_MIXED_PRECISION",
+        ]
+        env_variable_names_to_ignore = [
+            name.replace("ACCELERATE_", "").replace("DEEPSPEED_", "").lower() for name in env_variable_names_to_ignore
+        ]
+
+        deepspeed_fields_from_accelerate_config = os.environ.get("ACCELERATE_CONFIG_DS_FIELDS", "").split(",")
+
+        if any(name in env_variable_names_to_ignore for name in deepspeed_fields_from_accelerate_config):
+            raise ValueError(
+                f"When using `deepspeed_config_file`, the following accelerate config variables will be ignored: {env_variable_names_to_ignore}.\n"
+                "Please specify them appropriately in the DeepSpeed config file.\n"
+                "If you are using an accelerate config file, remove others config variables mentioned in the above specified list.\n"
+                "The easiest method is to create a new config following the questionnaire via `accelerate config`.\n"
+                "It will only ask for the necessary config variables when using `deepspeed_config_file`."
+            )
+
+
+@dataclass
+class FullyShardedDataParallelPlugin:
+    """
+    This plugin is used to enable fully sharded data parallelism.
+    """
+
+    sharding_strategy: "typing.Any" = field(
+        default=None,
+        metadata={
+            "help": "FSDP Sharding Strategy of type `torch.distributed.fsdp.fully_sharded_data_parallel.ShardingStrategy`"
+        },
+    )
+    backward_prefetch: "typing.Any" = field(
+        default=None,
+        metadata={
+            "help": "FSDP Backward Prefetch of type `torch.distributed.fsdp.fully_sharded_data_parallel.BackwardPrefetch`"
+        },
+    )
+    mixed_precision_policy: "typing.Any" = field(
+        default=None,
+        metadata={
+            "help": "A config to enable mixed precision training with FullyShardedDataParallel. "
+            "The 3 flags that are set are `param_dtype`, `reduce_dtype`, `buffer_dtype`. "
+            "Each flag expects `torch.dtype` as the value. "
+            "It is of type `torch.distributed.fsdp.fully_sharded_data_parallel.MixedPrecision`."
+        },
+    )
+    auto_wrap_policy: Optional[Callable] = field(
+        default=None,
+        metadata={"help": "A callable specifying a policy to recursively wrap layers with FSDP"},
+    )
+    cpu_offload: "typing.Any" = field(
+        default=None,
+        metadata={
+            "help": "Decides Whether to offload parameters and gradients to CPU. "
+            "It is of type `torch.distributed.fsdp.fully_sharded_data_parallel.CPUOffload`."
+        },
+    )
+    ignored_modules: Optional[Iterable[torch.nn.Module]] = field(
+        default=None,
+        metadata={"help": "A list of modules to ignore for FSDP."},
+    )
+    state_dict_type: "typing.Any" = field(
+        default=None,
+        metadata={
+            "help": "FSDP State Dict Type of type `torch.distributed.fsdp.fully_sharded_data_parallel.StateDictType`"
+        },
+    )
+    state_dict_config: "typing.Any" = field(
+        default=None,
+        metadata={
+            "help": "FSDP State Dict Config of type `torch.distributed.fsdp.fully_sharded_data_parallel.StateDictConfig`"
+        },
+    )
+    optim_state_dict_config: "typing.Any" = field(
+        default=None,
+        metadata={
+            "help": "FSDP Optimizer State Dict Config of type `torch.distributed.fsdp.fully_sharded_data_parallel.OptimStateDictConfig`"
+        },
+    )
+    limit_all_gathers: bool = field(
+        default=True,
+        metadata={
+            "help": "If False, then FSDP allows the CPU thread to schedule all-gathers "
+            "without any extra synchronization. If True, then FSDP explicitly synchronizes the CPU thread to prevent "
+            "too many in-flight all-gathers. This bool only affects the sharded strategies that schedule all-gathers. "
+            "Enabling this can help lower the number of CUDA malloc retries."
+        },
+    )
+    use_orig_params: bool = field(
+        default=True,
+        metadata={
+            "help": "If `True`, allows non-uniform `requires_grad` during init, which means support for interspersed frozen and trainable parameters. "
+            "Useful in cases such as parameter-efficient fine-tuning. "
+            "Please refer this [blog](https://dev-discuss.pytorch.org/t/rethinking-pytorch-fully-sharded-data-parallel-fsdp-from-first-principles/1019). "
+            "This also enables multiple optimizer param groups. This should be `True` when creating an optimizer object before preparing/wrapping the model with FSDP."
+        },
+    )
+    param_init_fn: Optional[Callable[[torch.nn.Module], None]] = field(
+        default=None,
+        metadata={
+            "help": "A Callable[torch.nn.Module] -> None that specifies how modules "
+            "that are currently on the meta device should be initialized onto an actual device."
+        },
+    )
+    sync_module_states: bool = field(
+        default=True,
+        metadata={
+            "help": "If True, each individually wrapped FSDP unit will broadcast module parameters from rank 0 "
+            "to ensure they are the same across all ranks after initialization"
+        },
+    )
+    forward_prefetch: bool = field(
+        default=False,
+        metadata={
+            "help": "If True, then FSDP explicitly prefetches the next upcoming "
+            "all-gather while executing in the forward pass. only use with Static graphs."
+        },
+    )
+    activation_checkpointing: bool = field(
+        default=False,
+        metadata={
+            "help": "If True, activation checkpointing is a technique to reduce memory usage by clearing activations of "
+            "certain layers and recomputing them during a backward pass. Effectively, this trades extra computation time "
+            "for reduced memory usage."
+        },
+    )
+
+    def __post_init__(self):
+        from torch.distributed.fsdp.fully_sharded_data_parallel import BackwardPrefetch, CPUOffload, ShardingStrategy
+
+        prefix = "FSDP_"
+        if self.sharding_strategy is None:
+            sharding_strategy = os.environ.get(prefix + "SHARDING_STRATEGY", "FULL_SHARD")
+            sharding_strategy = (
+                FSDP_SHARDING_STRATEGY.index(sharding_strategy) + 1
+                if not sharding_strategy.isdigit()
+                else int(sharding_strategy)
+            )
+            self.sharding_strategy = ShardingStrategy(sharding_strategy)
+
+        if self.cpu_offload is None:
+            if str_to_bool(os.environ.get(prefix + "OFFLOAD_PARAMS", "False")) == 1:
+                self.cpu_offload = CPUOffload(offload_params=True)
+            else:
+                self.cpu_offload = CPUOffload(offload_params=False)
+
+        if self.backward_prefetch is None:
+            prefetch_policy = os.environ.get(prefix + "BACKWARD_PREFETCH", "NO_PREFETCH")
+            if prefetch_policy != FSDP_BACKWARD_PREFETCH[-1]:
+                self.backward_prefetch = BackwardPrefetch(FSDP_BACKWARD_PREFETCH.index(prefetch_policy) + 1)
+
+        if self.state_dict_type is None:
+            state_dict_type_policy = os.environ.get(prefix + "STATE_DICT_TYPE", "FULL_STATE_DICT")
+            self.set_state_dict_type(state_dict_type_policy)
+        self.use_orig_params = str_to_bool(os.environ.get(prefix + "USE_ORIG_PARAMS", "False")) == 1
+        self.sync_module_states = str_to_bool(os.environ.get(prefix + "SYNC_MODULE_STATES", "True")) == 1
+        self.forward_prefetch = str_to_bool(os.environ.get(prefix + "FORWARD_PREFETCH", "False")) == 1
+        self.activation_checkpointing = str_to_bool(os.environ.get(prefix + "ACTIVATION_CHECKPOINTING", "False")) == 1
+
+        if self.sync_module_states:
+            if is_npu_available():
+                device = torch.npu.current_device()
+            elif is_cuda_available():
+                device = torch.cuda.current_device()
+            elif is_xpu_available():
+                device = torch.xpu.current_device()
+            else:
+                raise RuntimeError(
+                    "There are currently no available devices found, must be one of 'XPU', 'CUDA', or 'NPU'."
+                )
+            self.param_init_fn = lambda x: x.to_empty(device=device, recurse=False)
+
+    @staticmethod
+    def get_module_class_from_name(module, name):
+        """
+        Gets a class from a module by its name.
+
+        Args:
+            module (`torch.nn.Module`): The module to get the class from.
+            name (`str`): The name of the class.
+        """
+        modules_children = list(module.children())
+        if module.__class__.__name__ == name:
+            return module.__class__
+        elif len(modules_children) == 0:
+            return
+        else:
+            for child_module in modules_children:
+                module_class = FullyShardedDataParallelPlugin.get_module_class_from_name(child_module, name)
+                if module_class is not None:
+                    return module_class
+
+    def set_auto_wrap_policy(self, model):
+        from torch.distributed.fsdp.wrap import size_based_auto_wrap_policy, transformer_auto_wrap_policy
+
+        default_transformer_cls_names_to_wrap = (
+            ",".join(model._no_split_modules) if getattr(model, "_no_split_modules", None) is not None else ""
+        )
+        if self.auto_wrap_policy is None:
+            auto_wrap_policy = os.environ.get("FSDP_AUTO_WRAP_POLICY", "NO_WRAP")
+            if auto_wrap_policy == FSDP_AUTO_WRAP_POLICY[0]:
+                transformer_cls_names_to_wrap = os.environ.get(
+                    "FSDP_TRANSFORMER_CLS_TO_WRAP", default_transformer_cls_names_to_wrap
+                ).split(",")
+                transformer_cls_to_wrap = set()
+                for layer_class in transformer_cls_names_to_wrap:
+                    transformer_cls = FullyShardedDataParallelPlugin.get_module_class_from_name(model, layer_class)
+                    if transformer_cls is None:
+                        raise Exception("Could not find the transformer layer class to wrap in the model.")
+                    else:
+                        transformer_cls_to_wrap.add(transformer_cls)
+
+                self.auto_wrap_policy = functools.partial(
+                    transformer_auto_wrap_policy,
+                    # Transformer layer class to wrap
+                    transformer_layer_cls=transformer_cls_to_wrap,
+                )
+            elif auto_wrap_policy == FSDP_AUTO_WRAP_POLICY[1]:
+                min_num_params = int(os.environ.get("FSDP_MIN_NUM_PARAMS", 0))
+                if min_num_params > 0:
+                    self.auto_wrap_policy = functools.partial(
+                        size_based_auto_wrap_policy, min_num_params=min_num_params
+                    )
+
+    def set_mixed_precision(self, mixed_precision, buffer_autocast=False, override=False):
+        if isinstance(mixed_precision, str):
+            if mixed_precision == "fp16":
+                dtype = torch.float16
+            elif mixed_precision == "bf16":
+                dtype = torch.bfloat16
+            elif mixed_precision == "fp32":
+                dtype = torch.float32
+            else:
+                raise ValueError(f"Unknown mixed precision value: {mixed_precision}")
+        else:
+            dtype = mixed_precision
+
+        buffer_dtype = torch.float32 if buffer_autocast else dtype
+        from torch.distributed.fsdp.fully_sharded_data_parallel import MixedPrecision
+
+        if self.mixed_precision_policy is None or override:
+            self.mixed_precision_policy = MixedPrecision(
+                param_dtype=dtype, reduce_dtype=dtype, buffer_dtype=buffer_dtype
+            )
+
+    def set_state_dict_type(self, state_dict_type_policy):
+        from torch.distributed.fsdp.fully_sharded_data_parallel import (
+            FullOptimStateDictConfig,
+            FullStateDictConfig,
+            StateDictType,
+        )
+
+        self.state_dict_type = StateDictType(FSDP_STATE_DICT_TYPE.index(state_dict_type_policy) + 1)
+
+        if self.state_dict_type == StateDictType.FULL_STATE_DICT:
+            if self.state_dict_config is None:
+                self.state_dict_config = FullStateDictConfig(offload_to_cpu=True, rank0_only=True)
+            if self.optim_state_dict_config is None:
+                self.optim_state_dict_config = FullOptimStateDictConfig(offload_to_cpu=True, rank0_only=True)
+
+
+@dataclass
+class MegatronLMPlugin:
+    """
+    Plugin for Megatron-LM to enable tensor, pipeline, sequence and data parallelism. Also to enable selective
+    activation recomputation and optimized fused kernels.
+    """
+
+    tp_degree: int = field(default=None, metadata={"help": "tensor parallelism degree."})
+    pp_degree: int = field(default=None, metadata={"help": "pipeline parallelism degree."})
+    num_micro_batches: int = field(default=None, metadata={"help": "number of micro-batches."})
+    gradient_clipping: float = field(
+        default=None, metadata={"help": "gradient clipping value based on global L2 Norm (0 to disable)"}
+    )
+    sequence_parallelism: bool = field(
+        default=None,
+        metadata={"help": "enable sequence parallelism"},
+    )
+    recompute_activations: bool = field(
+        default=None,
+        metadata={"help": "enable selective activation recomputation"},
+    )
+    use_distributed_optimizer: bool = field(
+        default=None,
+        metadata={"help": "enable distributed optimizer"},
+    )
+    pipeline_model_parallel_split_rank: int = field(
+        default=None, metadata={"help": "Rank where encoder and decoder should be split."}
+    )
+    num_layers_per_virtual_pipeline_stage: int = field(
+        default=None, metadata={"help": "Number of layers per virtual pipeline stage."}
+    )
+    is_train_batch_min: str = field(
+        default=True,
+        metadata={"help": "If both train & eval dataloaders are specified, this will decide the micro_batch_size"},
+    )
+    train_iters: int = field(
+        default=None,
+        metadata={
+            "help": "Total number of iterations to train over all training runs. "
+            "Note that either train-iters or train-samples should be provided when using `MegatronLMDummyScheduler`"
+        },
+    )
+    train_samples: int = field(
+        default=None,
+        metadata={
+            "help": "Total number of samples to train over all training runs. "
+            "Note that either train-iters or train-samples should be provided when using `MegatronLMDummyScheduler`"
+        },
+    )
+    weight_decay_incr_style: str = field(
+        default="constant",
+        metadata={"help": 'Weight decay increment function. choices=["constant", "linear", "cosine"]. '},
+    )
+    start_weight_decay: float = field(
+        default=None,
+        metadata={"help": "Initial weight decay coefficient for L2 regularization."},
+    )
+    end_weight_decay: float = field(
+        default=None,
+        metadata={"help": "End of run weight decay coefficient for L2 regularization."},
+    )
+    lr_decay_style: str = field(
+        default="linear",
+        metadata={"help": "Learning rate decay function. choices=['constant', 'linear', 'cosine']."},
+    )
+    lr_decay_iters: int = field(
+        default=None,
+        metadata={"help": "Number of iterations for learning rate decay. If None defaults to `train_iters`."},
+    )
+    lr_decay_samples: int = field(
+        default=None,
+        metadata={"help": "Number of samples for learning rate decay. If None defaults to `train_samples`."},
+    )
+    lr_warmup_iters: int = field(
+        default=None,
+        metadata={"help": "number of iterations to linearly warmup learning rate over."},
+    )
+    lr_warmup_samples: int = field(
+        default=None,
+        metadata={"help": "number of samples to linearly warmup learning rate over."},
+    )
+    lr_warmup_fraction: float = field(
+        default=None,
+        metadata={"help": "fraction of lr-warmup-(iters/samples) to linearly warmup learning rate over."},
+    )
+    min_lr: float = field(
+        default=0,
+        metadata={"help": "Minumum value for learning rate. The scheduler clip values below this threshold."},
+    )
+    consumed_samples: List[int] = field(
+        default=None,
+        metadata={
+            "help": "Number of samples consumed in the same order as the dataloaders to `accelerator.prepare` call."
+        },
+    )
+    no_wd_decay_cond: Optional[Callable] = field(default=None, metadata={"help": "Condition to disable weight decay."})
+    scale_lr_cond: Optional[Callable] = field(default=None, metadata={"help": "Condition to scale learning rate."})
+    lr_mult: float = field(default=1.0, metadata={"help": "Learning rate multiplier."})
+    megatron_dataset_flag: bool = field(
+        default=False,
+        metadata={"help": "Whether the format of dataset follows Megatron-LM Indexed/Cached/MemoryMapped format."},
+    )
+    seq_length: int = field(
+        default=None,
+        metadata={"help": "Maximum sequence length to process."},
+    )
+    encoder_seq_length: int = field(
+        default=None,
+        metadata={"help": "Maximum sequence length to process for the encoder."},
+    )
+    decoder_seq_length: int = field(
+        default=None,
+        metadata={"help": "Maximum sequence length to process for the decoder."},
+    )
+    tensorboard_dir: str = field(
+        default=None,
+        metadata={"help": "Path to save tensorboard logs."},
+    )
+    set_all_logging_options: bool = field(
+        default=False,
+        metadata={"help": "Whether to set all logging options."},
+    )
+    eval_iters: int = field(
+        default=100, metadata={"help": "Number of iterations to run for evaluation validation/test for."}
+    )
+    eval_interval: int = field(
+        default=1000, metadata={"help": "Interval between running evaluation on validation set."}
+    )
+    return_logits: bool = field(
+        default=False,
+        metadata={"help": "Whether to return logits from the model."},
+    )
+
+    # custom train step args
+    custom_train_step_class: Optional[Any] = field(
+        default=None,
+        metadata={"help": "Custom train step class."},
+    )
+    custom_train_step_kwargs: Optional[Dict[str, Any]] = field(
+        default=None,
+        metadata={"help": "Custom train step kwargs."},
+    )
+
+    # custom model args
+    custom_model_provider_function: Optional[Callable] = field(
+        default=None,
+        metadata={"help": "Custom model provider function."},
+    )
+    custom_prepare_model_function: Optional[Callable] = field(
+        default=None,
+        metadata={"help": "Custom prepare model function."},
+    )
+
+    # remaining args such as enabling Alibi/ROPE positional embeddings,
+    # wandb logging, Multi-Query Attention, etc.
+    other_megatron_args: Optional[Dict[str, Any]] = field(
+        default=None,
+        metadata={"help": "Other Megatron-LM arguments. Please refer Megatron-LM"},
+    )
+
+    def __post_init__(self):
+        prefix = "MEGATRON_LM_"
+        if self.tp_degree is None:
+            self.tp_degree = int(os.environ.get(prefix + "TP_DEGREE", 1))
+        if self.pp_degree is None:
+            self.pp_degree = int(os.environ.get(prefix + "PP_DEGREE", 1))
+        if self.num_micro_batches is None:
+            self.num_micro_batches = int(os.environ.get(prefix + "NUM_MICRO_BATCHES", 1))
+        if self.gradient_clipping is None:
+            self.gradient_clipping = float(os.environ.get(prefix + "GRADIENT_CLIPPING", 1.0))
+        if self.recompute_activations is None:
+            self.recompute_activations = str_to_bool(os.environ.get(prefix + "RECOMPUTE_ACTIVATIONS", "False")) == 1
+        if self.use_distributed_optimizer is None:
+            self.use_distributed_optimizer = (
+                str_to_bool(os.environ.get(prefix + "USE_DISTRIBUTED_OPTIMIZER", "False")) == 1
+            )
+        if self.sequence_parallelism is None:
+            self.sequence_parallelism = str_to_bool(os.environ.get(prefix + "SEQUENCE_PARALLELISM", "False")) == 1
+
+        if self.pp_degree > 1 or self.use_distributed_optimizer:
+            self.DDP_impl = "local"
+        else:
+            self.DDP_impl = "torch"
+
+        if self.consumed_samples is not None:
+            if len(self.consumed_samples) == 1:
+                self.consumed_samples.extend([0, 0])
+            elif len(self.consumed_samples) == 2:
+                self.consumed_samples.append(0)
+
+        self.megatron_lm_default_args = {
+            "tensor_model_parallel_size": self.tp_degree,
+            "pipeline_model_parallel_size": self.pp_degree,
+            "pipeline_model_parallel_split_rank": self.pipeline_model_parallel_split_rank,
+            "num_layers_per_virtual_pipeline_stage": self.num_layers_per_virtual_pipeline_stage,
+            "DDP_impl": self.DDP_impl,
+            "use_distributed_optimizer": self.use_distributed_optimizer,
+            "sequence_parallel": self.sequence_parallelism,
+            "clip_grad": self.gradient_clipping,
+            "num_micro_batches": self.num_micro_batches,
+            "consumed_samples": self.consumed_samples,
+            "no_wd_decay_cond": self.no_wd_decay_cond,
+            "scale_lr_cond": self.scale_lr_cond,
+            "lr_mult": self.lr_mult,
+            "megatron_dataset_flag": self.megatron_dataset_flag,
+            "eval_iters": self.eval_iters,
+            "eval_interval": self.eval_interval,
+        }
+        if self.recompute_activations:
+            self.megatron_lm_default_args["recompute_granularity"] = "selective"
+        if self.tensorboard_dir is not None:
+            self.megatron_lm_default_args["tensorboard_dir"] = self.tensorboard_dir
+            if self.set_all_logging_options:
+                self.set_tensorboard_logging_options()
+        if self.other_megatron_args is not None:
+            self.megatron_lm_default_args.update(self.other_megatron_args)
+
+    def set_network_size_args(self, model, batch_data=None):
+        # Check if the model is either BERT, GPT or T5 else raise error
+        # set 'num_layers', 'hidden_size', 'num_attention_heads', 'max_position_embeddings'
+        if "megatron-bert" in model.config.model_type.lower():
+            model_type_name = "bert"
+            num_layers = model.config.num_hidden_layers
+            hidden_size = model.config.hidden_size
+            num_attention_heads = model.config.num_attention_heads
+            max_position_embeddings = model.config.max_position_embeddings
+            num_labels = model.config.num_labels
+            orig_vocab_size = model.config.vocab_size
+            if "maskedlm" in model.__class__.__name__.lower():
+                pretraining_flag = True
+            if self.seq_length is not None:
+                if self.encoder_seq_length is not None:
+                    warnings.warn("Both `seq_length` and `encoder_seq_length` are set. Using `encoder_seq_length`.")
+                self.seq_length = self.encoder_seq_length
+            elif self.encoder_seq_length is not None:
+                self.seq_length = self.encoder_seq_length
+            elif batch_data is not None:
+                self.seq_length = batch_data["input_ids"].shape[1]
+            else:
+                self.seq_length = max_position_embeddings
+            self.megatron_lm_default_args["seq_length"] = self.seq_length
+        elif "gpt2" in model.config.model_type.lower():
+            model_type_name = "gpt"
+            num_layers = model.config.n_layer
+            hidden_size = model.config.n_embd
+            num_attention_heads = model.config.n_head
+            max_position_embeddings = model.config.n_positions
+            orig_vocab_size = model.config.vocab_size
+            pretraining_flag = True
+            if self.seq_length is not None:
+                if self.decoder_seq_length is not None:
+                    warnings.warn("Both `seq_length` and `decoder_seq_length` are set. Using `decoder_seq_length`.")
+                self.seq_length = self.decoder_seq_length
+            elif self.decoder_seq_length is not None:
+                self.seq_length = self.decoder_seq_length
+            elif batch_data is not None:
+                self.seq_length = batch_data["input_ids"].shape[1]
+            else:
+                self.seq_length = max_position_embeddings
+            self.megatron_lm_default_args["seq_length"] = self.seq_length
+            self.megatron_lm_default_args["return_logits"] = self.return_logits
+            self.megatron_lm_default_args["tokenizer_type"] = "GPT2BPETokenizer"
+        elif "t5" in model.config.model_type.lower():
+            model_type_name = "t5"
+            num_layers = model.config.num_layers
+            hidden_size = model.config.d_model
+            num_attention_heads = model.config.num_heads
+            max_position_embeddings = model.config.n_positions if hasattr(model.config, "n_positions") else 1024
+            orig_vocab_size = model.config.vocab_size
+            pretraining_flag = True
+            if self.encoder_seq_length is None:
+                if batch_data is not None:
+                    self.encoder_seq_length = batch_data["input_ids"].shape[1]
+                else:
+                    self.encoder_seq_length = max_position_embeddings
+            if self.decoder_seq_length is None:
+                if batch_data is not None:
+                    self.decoder_seq_length = batch_data["labels"].shape[1]
+                else:
+                    self.decoder_seq_length = max_position_embeddings
+
+            self.megatron_lm_default_args["encoder_seq_length"] = self.encoder_seq_length
+            self.megatron_lm_default_args["decoder_seq_length"] = self.decoder_seq_length
+        else:
+            raise ValueError(
+                "🤗 Accelerate Megatron-LM integration supports only BERT, GPT and T5 model. "
+                "Please check the model you are using is one of those."
+            )
+
+        self.megatron_lm_default_args["model_type_name"] = model_type_name
+        self.megatron_lm_default_args["num_layers"] = num_layers
+        self.megatron_lm_default_args["hidden_size"] = hidden_size
+        self.megatron_lm_default_args["num_attention_heads"] = num_attention_heads
+        self.megatron_lm_default_args["max_position_embeddings"] = max_position_embeddings
+        self.megatron_lm_default_args["pretraining_flag"] = pretraining_flag
+        self.megatron_lm_default_args["orig_vocab_size"] = orig_vocab_size
+        self.megatron_lm_default_args["model_return_dict"] = model.config.return_dict
+        if model_type_name == "bert":
+            self.megatron_lm_default_args["num_labels"] = num_labels
+
+    def set_mixed_precision(self, mixed_precision):
+        if mixed_precision == "fp16":
+            self.megatron_lm_default_args["fp16"] = True
+        elif mixed_precision == "bf16":
+            self.megatron_lm_default_args["bf16"] = True
+            self.DDP_impl = "local"
+            self.megatron_lm_default_args["DDP_impl"] = self.DDP_impl
+
+    def set_training_args(self, micro_batch_size, dp_degree):
+        self.data_parallel_size = dp_degree
+        self.micro_batch_size = micro_batch_size
+        self.global_batch_size = dp_degree * micro_batch_size * self.num_micro_batches
+        self.megatron_lm_default_args["data_parallel_size"] = self.data_parallel_size
+        self.megatron_lm_default_args["micro_batch_size"] = self.micro_batch_size
+        self.megatron_lm_default_args["global_batch_size"] = self.global_batch_size
+
+    def set_optimizer_type(self, optimizer):
+        optimizer_name = optimizer.__class__.__name__.lower()
+        if "adam" in optimizer_name:
+            self.megatron_lm_default_args["optimizer"] = "adam"
+            self.megatron_lm_default_args["adam_beta1"] = optimizer.defaults["betas"][0]
+            self.megatron_lm_default_args["adam_beta2"] = optimizer.defaults["betas"][1]
+            self.megatron_lm_default_args["adam_eps"] = optimizer.defaults["eps"]
+        elif "sgd" in optimizer_name:
+            self.megatron_lm_default_args["optimizer"] = "sgd"
+            self.megatron_lm_default_args["sgd_momentum"] = optimizer.defaults["momentum"]
+        else:
+            raise ValueError(f"Optimizer {optimizer_name} is not supported by Megatron-LM")
+
+        self.megatron_lm_default_args["lr"] = optimizer.defaults["lr"]
+        self.megatron_lm_default_args["weight_decay"] = optimizer.defaults["weight_decay"]
+
+    def set_scheduler_args(self, scheduler):
+        if self.train_iters is None:
+            self.train_iters = scheduler.total_num_steps // self.megatron_lm_default_args["data_parallel_size"]
+            if self.train_samples is not None:
+                self.train_samples = None
+                warnings.warn(
+                    "Ignoring `train_samples` as `train_iters` based on scheduler is being used for training."
+                )
+        if self.lr_warmup_iters is None:
+            self.lr_warmup_iters = scheduler.warmup_num_steps // self.megatron_lm_default_args["data_parallel_size"]
+            if self.lr_warmup_samples is not None:
+                warnings.warn(
+                    "Ignoring `lr_warmup_samples` as `lr_warmup_iters` based on scheduler is being used for training."
+                )
+            self.lr_warmup_samples = 0
+
+        self.megatron_lm_default_args["train_iters"] = self.train_iters
+        self.megatron_lm_default_args["lr_warmup_iters"] = self.lr_warmup_iters
+        self.megatron_lm_default_args["train_samples"] = self.train_samples
+        self.megatron_lm_default_args["lr_warmup_samples"] = self.lr_warmup_samples
+        self.megatron_lm_default_args["lr_decay_iters"] = self.lr_decay_iters
+        self.megatron_lm_default_args["lr_decay_samples"] = self.lr_decay_samples
+        self.megatron_lm_default_args["lr_warmup_fraction"] = self.lr_warmup_fraction
+        self.megatron_lm_default_args["lr_decay_style"] = self.lr_decay_style
+        self.megatron_lm_default_args["weight_decay_incr_style"] = self.weight_decay_incr_style
+        self.megatron_lm_default_args["start_weight_decay"] = self.start_weight_decay
+        self.megatron_lm_default_args["end_weight_decay"] = self.end_weight_decay
+        self.megatron_lm_default_args["min_lr"] = self.min_lr
+
+    def set_tensorboard_logging_options(self):
+        from megatron.arguments import _add_logging_args
+
+        parser = argparse.ArgumentParser()
+        parser = _add_logging_args(parser)
+        logging_args = parser.parse_known_args()
+        self.dataset_args = vars(logging_args[0])
+        for key, value in self.dataset_args.items():
+            if key.startswith("log_"):
+                self.megatron_lm_default_args[key] = True
+            elif key.startswith("no_log_"):
+                self.megatron_lm_default_args[key.replace("no_", "")] = True
+
+
+@dataclass
+class BnbQuantizationConfig:
+    """
+    A plugin to enable BitsAndBytes 4bit and 8bit quantization
+    """
+
+    load_in_8bit: bool = field(default=False, metadata={"help": "enable 8bit quantization."})
+
+    llm_int8_threshold: float = field(
+        default=6.0, metadata={"help": "value of the outliner threshold. only relevant when load_in_8bit=True"}
+    )
+
+    load_in_4bit: bool = field(default=False, metadata={"help": "enable 4bit quantization."})
+
+    bnb_4bit_quant_type: str = field(
+        default="fp4",
+        metadata={
+            "help": "set the quantization data type in the `bnb.nn.Linear4Bit` layers. Options are {'fp4','np4'}."
+        },
+    )
+
+    bnb_4bit_use_double_quant: bool = field(
+        default=False,
+        metadata={
+            "help": "enable nested quantization where the quantization constants from the first quantization are quantized again."
+        },
+    )
+
+    bnb_4bit_compute_dtype: bool = field(
+        default="fp16",
+        metadata={
+            "help": "This sets the computational type which might be different than the input time. For example, inputs might be "
+            "fp32, but computation can be set to bf16 for speedups. Options are {'fp32','fp16','bf16'}."
+        },
+    )
+
+    torch_dtype: torch.dtype = field(
+        default=None,
+        metadata={
+            "help": "this sets the dtype of the remaining non quantized layers. `bitsandbytes` library suggests to set the value"
+            "to `torch.float16` for 8 bit model and use the same dtype as the compute dtype for 4 bit model "
+        },
+    )
+
+    skip_modules: List[str] = field(
+        default=None,
+        metadata={
+            "help": "an explicit list of the modules that we don't quantize. The dtype of these modules will be `torch_dtype`."
+        },
+    )
+
+    keep_in_fp32_modules: List[str] = field(
+        default=None,
+        metadata={"help": "an explicit list of the modules that we don't quantize. We keep them in `torch.float32`."},
+    )
+
+    def __post_init__(self):
+        """
+        Safety checker that arguments are correct - also replaces some NoneType arguments with their default values.
+        """
+        if not isinstance(self.load_in_8bit, bool):
+            raise ValueError("load_in_8bit must be a boolean")
+
+        if not isinstance(self.load_in_4bit, bool):
+            raise ValueError("load_in_4bit must be a boolean")
+
+        if self.load_in_4bit and self.load_in_8bit:
+            raise ValueError("load_in_4bit and load_in_8 can't be both True")
+
+        if not self.load_in_4bit and not self.load_in_8bit:
+            raise ValueError("load_in_4bit and load_in_8 can't be both False")
+
+        if not isinstance(self.llm_int8_threshold, (int, float)):
+            raise ValueError("llm_int8_threshold must be a float or an int")
+
+        if not isinstance(self.bnb_4bit_quant_type, str):
+            raise ValueError("bnb_4bit_quant_type must be a string")
+        elif self.bnb_4bit_quant_type not in ["fp4", "nf4"]:
+            raise ValueError(f"bnb_4bit_quant_type must be in ['fp4','nf4'] but found {self.bnb_4bit_quant_type}")
+
+        if not isinstance(self.bnb_4bit_use_double_quant, bool):
+            raise ValueError("bnb_4bit_use_double_quant must be a boolean")
+
+        if isinstance(self.bnb_4bit_compute_dtype, str):
+            if self.bnb_4bit_compute_dtype == "fp32":
+                self.bnb_4bit_compute_dtype = torch.float32
+            elif self.bnb_4bit_compute_dtype == "fp16":
+                self.bnb_4bit_compute_dtype = torch.float16
+            elif self.bnb_4bit_compute_dtype == "bf16":
+                self.bnb_4bit_compute_dtype = torch.bfloat16
+            else:
+                raise ValueError(
+                    f"bnb_4bit_compute_dtype must be in ['fp32','fp16','bf16'] but found {self.bnb_4bit_compute_dtype}"
+                )
+        elif not isinstance(self.bnb_4bit_compute_dtype, torch.dtype):
+            raise ValueError("bnb_4bit_compute_dtype must be a string or a torch.dtype")
+
+        if self.skip_modules is not None and not isinstance(self.skip_modules, list):
+            raise ValueError("skip_modules must be a list of strings")
+
+        if self.keep_in_fp32_modules is not None and not isinstance(self.keep_in_fp32_modules, list):
+            raise ValueError("keep_in_fp_32_modules must be a list of strings")
+
+        if self.load_in_4bit:
+            self.target_dtype = CustomDtype.INT4
+
+        if self.load_in_8bit:
+            self.target_dtype = torch.int8
+
+        if self.load_in_4bit and self.llm_int8_threshold != 6.0:
+            warnings.warn("llm_int8_threshold can only be used for model loaded in 8bit")
+
+        if isinstance(self.torch_dtype, str):
+            if self.torch_dtype == "fp32":
+                self.torch_dtype = torch.float32
+            elif self.torch_dtype == "fp16":
+                self.torch_dtype = torch.float16
+            elif self.torch_dtype == "bf16":
+                self.torch_dtype = torch.bfloat16
+            else:
+                raise ValueError(f"torch_dtype must be in ['fp32','fp16','bf16'] but found {self.torch_dtype}")
+        if self.load_in_8bit and self.torch_dtype is None:
+            self.torch_dtype = torch.float16
+
+        if self.load_in_4bit and self.torch_dtype is None:
+            self.torch_dtype = self.bnb_4bit_compute_dtype
+
+        if not isinstance(self.torch_dtype, torch.dtype):
+            raise ValueError("torch_dtype must be a torch.dtype")
diff --git a/llm/Lib/site-packages/accelerate/utils/deepspeed.py b/llm/Lib/site-packages/accelerate/utils/deepspeed.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe5a63fc7314d42f68baae41cf56f9abc94237a0
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/deepspeed.py
@@ -0,0 +1,271 @@
+# Copyright 2021 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import base64
+import json
+import os
+from copy import deepcopy
+
+from ..optimizer import AcceleratedOptimizer
+from ..scheduler import AcceleratedScheduler
+
+
+class HfDeepSpeedConfig:
+    """
+    This object contains a DeepSpeed configuration dictionary and can be quickly queried for things like zero stage.
+
+    A `weakref` of this object is stored in the module's globals to be able to access the config from areas where
+    things like the Trainer object is not available (e.g. `from_pretrained` and `_get_resized_embeddings`). Therefore
+    it's important that this object remains alive while the program is still running.
+
+    [`Trainer`] uses the `HfTrainerDeepSpeedConfig` subclass instead. That subclass has logic to sync the configuration
+    with values of [`TrainingArguments`] by replacing special placeholder values: `"auto"`. Without this special logic
+    the DeepSpeed configuration is not modified in any way.
+
+    Args:
+        config_file_or_dict (`Union[str, Dict]`): path to DeepSpeed config file or dict.
+
+    """
+
+    def __init__(self, config_file_or_dict):
+        if isinstance(config_file_or_dict, dict):
+            # Don't modify user's data should they want to reuse it (e.g. in tests), because once we
+            # modified it, it will not be accepted here again, since `auto` values would have been overridden
+            config = deepcopy(config_file_or_dict)
+        elif os.path.exists(config_file_or_dict):
+            with open(config_file_or_dict, encoding="utf-8") as f:
+                config = json.load(f)
+        else:
+            try:
+                config_decoded = base64.urlsafe_b64decode(config_file_or_dict).decode("utf-8")
+                config = json.loads(config_decoded)
+            except (UnicodeDecodeError, AttributeError, ValueError):
+                raise ValueError(
+                    f"Expected a string path to an existing deepspeed config, or a dictionary, or a base64 encoded string. Received: {config_file_or_dict}"
+                )
+
+        self.config = config
+
+        self.set_stage_and_offload()
+
+    def set_stage_and_offload(self):
+        # zero stage - this is done as early as possible, before model is created, to allow
+        # ``is_deepspeed_zero3_enabled`` query and getting to the early deepspeed config object
+        # during ``zero.Init()`` which needs to know the dtype, and some other hparams.
+        self._stage = self.get_value("zero_optimization.stage", -1)
+
+        # offload
+        self._offload = False
+        if self.is_zero2() or self.is_zero3():
+            offload_devices_valid = set(["cpu", "nvme"])
+            offload_devices = set(
+                [
+                    self.get_value("zero_optimization.offload_optimizer.device"),
+                    self.get_value("zero_optimization.offload_param.device"),
+                ]
+            )
+            if len(offload_devices & offload_devices_valid) > 0:
+                self._offload = True
+
+    def find_config_node(self, ds_key_long):
+        config = self.config
+
+        # find the config node of interest if it exists
+        nodes = ds_key_long.split(".")
+        ds_key = nodes.pop()
+        for node in nodes:
+            config = config.get(node)
+            if config is None:
+                return None, ds_key
+
+        return config, ds_key
+
+    def get_value(self, ds_key_long, default=None):
+        """
+        Returns the set value or `default` if no value is set
+        """
+        config, ds_key = self.find_config_node(ds_key_long)
+        if config is None:
+            return default
+        return config.get(ds_key, default)
+
+    def del_config_sub_tree(self, ds_key_long, must_exist=False):
+        """
+        Deletes a sub-section of the config file if it's found.
+
+        Unless `must_exist` is `True` the section doesn't have to exist.
+        """
+        config = self.config
+
+        # find the config node of interest if it exists
+        nodes = ds_key_long.split(".")
+        for node in nodes:
+            parent_config = config
+            config = config.get(node)
+            if config is None:
+                if must_exist:
+                    raise ValueError(f"Can't find {ds_key_long} entry in the config: {self.config}")
+                else:
+                    return
+
+        # if found remove it
+        if parent_config is not None:
+            parent_config.pop(node)
+
+    def is_true(self, ds_key_long):
+        """
+        Returns `True`/``False` only if the value is set, always `False` otherwise. So use this method to ask the very
+        specific question of whether the value is set to `True` (and it's not set to `False`` or isn't set).
+
+        """
+        value = self.get_value(ds_key_long)
+        return False if value is None else bool(value)
+
+    def is_false(self, ds_key_long):
+        """
+        Returns `True`/``False` only if the value is set, always `False` otherwise. So use this method to ask the very
+        specific question of whether the value is set to `False` (and it's not set to `True`` or isn't set).
+        """
+        value = self.get_value(ds_key_long)
+        return False if value is None else not bool(value)
+
+    def is_zero2(self):
+        return self._stage == 2
+
+    def is_zero3(self):
+        return self._stage == 3
+
+    def is_offload(self):
+        return self._offload
+
+
+class DeepSpeedEngineWrapper:
+    """
+    Internal wrapper for deepspeed.runtime.engine.DeepSpeedEngine. This is used to follow conventional training loop.
+
+    Args:
+        engine (deepspeed.runtime.engine.DeepSpeedEngine): deepspeed engine to wrap
+    """
+
+    def __init__(self, engine):
+        self.engine = engine
+
+    def backward(self, loss, **kwargs):
+        # runs backpropagation and handles mixed precision
+        self.engine.backward(loss, **kwargs)
+
+        # Deepspeed's `engine.step` performs the following operations:
+        # - gradient accumulation check
+        # - gradient clipping
+        # - optimizer step
+        # - zero grad
+        # - checking overflow
+        # - lr_scheduler step (only if engine.lr_scheduler is not None)
+        self.engine.step()
+        # and this plugin overrides the above calls with no-ops when Accelerate runs under
+        # Deepspeed, but allows normal functionality for non-Deepspeed cases thus enabling a simple
+        # training loop that works transparently under many training regimes.
+
+
+class DeepSpeedOptimizerWrapper(AcceleratedOptimizer):
+    """
+    Internal wrapper around a deepspeed optimizer.
+
+    Args:
+        optimizer (`torch.optim.optimizer.Optimizer`):
+            The optimizer to wrap.
+    """
+
+    def __init__(self, optimizer):
+        super().__init__(optimizer, device_placement=False, scaler=None)
+        self.__has_overflow__ = hasattr(self.optimizer, "overflow")
+
+    def zero_grad(self, set_to_none=None):
+        pass  # `accelerator.backward(loss)` is doing that automatically. Therefore, its implementation is not needed
+
+    def step(self):
+        pass  # `accelerator.backward(loss)` is doing that automatically. Therefore, its implementation is not needed
+
+    @property
+    def step_was_skipped(self):
+        """Whether or not the optimizer step was done, or skipped because of gradient overflow."""
+        if self.__has_overflow__:
+            return self.optimizer.overflow
+        return False
+
+
+class DeepSpeedSchedulerWrapper(AcceleratedScheduler):
+    """
+    Internal wrapper around a deepspeed scheduler.
+
+    Args:
+        scheduler (`torch.optim.lr_scheduler.LambdaLR`):
+            The scheduler to wrap.
+        optimizers (one or a list of `torch.optim.Optimizer`):
+    """
+
+    def __init__(self, scheduler, optimizers):
+        super().__init__(scheduler, optimizers)
+
+    def step(self):
+        pass  # `accelerator.backward(loss)` is doing that automatically. Therefore, its implementation is not needed
+
+
+class DummyOptim:
+    """
+    Dummy optimizer presents model parameters or param groups, this is primarily used to follow conventional training
+    loop when optimizer config is specified in the deepspeed config file.
+
+    Args:
+        lr (float):
+            Learning rate.
+        params (iterable): iterable of parameters to optimize or dicts defining
+            parameter groups
+        weight_decay (float):
+            Weight decay.
+        **kwargs (additional keyword arguments, *optional*):
+            Other arguments.
+    """
+
+    def __init__(self, params, lr=0.001, weight_decay=0, **kwargs):
+        self.params = params
+        self.lr = lr
+        self.weight_decay = weight_decay
+        self.kwargs = kwargs
+
+
+class DummyScheduler:
+    """
+    Dummy scheduler presents model parameters or param groups, this is primarily used to follow conventional training
+    loop when scheduler config is specified in the deepspeed config file.
+
+    Args:
+        optimizer (`torch.optim.optimizer.Optimizer`):
+            The optimizer to wrap.
+        total_num_steps (int, *optional*):
+            Total number of steps.
+        warmup_num_steps (int, *optional*):
+            Number of steps for warmup.
+        lr_scheduler_callable (callable, *optional*):
+            A callable function that creates an LR Scheduler. It accepts only one argument `optimizer`.
+        **kwargs (additional keyword arguments, *optional*):
+            Other arguments.
+    """
+
+    def __init__(self, optimizer, total_num_steps=None, warmup_num_steps=0, lr_scheduler_callable=None, **kwargs):
+        self.optimizer = optimizer
+        self.total_num_steps = total_num_steps
+        self.warmup_num_steps = warmup_num_steps
+        self.lr_scheduler_callable = lr_scheduler_callable
+        self.kwargs = kwargs
diff --git a/llm/Lib/site-packages/accelerate/utils/environment.py b/llm/Lib/site-packages/accelerate/utils/environment.py
new file mode 100644
index 0000000000000000000000000000000000000000..9fdbd323632769146188cac1e91d08ab1e2ba617
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/environment.py
@@ -0,0 +1,274 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import math
+import os
+import platform
+import subprocess
+import sys
+from dataclasses import dataclass, field
+from functools import lru_cache
+from shutil import which
+from typing import List, Optional
+
+import torch
+from packaging.version import parse
+
+
+logger = logging.getLogger(__name__)
+
+
+def convert_dict_to_env_variables(current_env: dict):
+    """
+    Verifies that all keys and values in `current_env` do not contain illegal keys or values, and returns a list of
+    strings as the result.
+
+    Example:
+    ```python
+    >>> from accelerate.utils.environment import verify_env
+
+    >>> env = {"ACCELERATE_DEBUG_MODE": "1", "BAD_ENV_NAME": "<mything", "OTHER_ENV": "2"}
+    >>> valid_env_items = verify_env(env)
+    >>> print(valid_env_items)
+    ["ACCELERATE_DEBUG_MODE=1\n", "OTHER_ENV=2\n"]
+    ```
+    """
+    forbidden_chars = [";", "\n", "<", ">", " "]
+    valid_env_items = []
+    for key, value in current_env.items():
+        if all(char not in (key + value) for char in forbidden_chars) and len(key) >= 1 and len(value) >= 1:
+            valid_env_items.append(f"{key}={value}\n")
+        else:
+            logger.warning(f"WARNING: Skipping {key}={value} as it contains forbidden characters or missing values.")
+    return valid_env_items
+
+
+def str_to_bool(value) -> int:
+    """
+    Converts a string representation of truth to `True` (1) or `False` (0).
+
+    True values are `y`, `yes`, `t`, `true`, `on`, and `1`; False value are `n`, `no`, `f`, `false`, `off`, and `0`;
+    """
+    value = value.lower()
+    if value in ("y", "yes", "t", "true", "on", "1"):
+        return 1
+    elif value in ("n", "no", "f", "false", "off", "0"):
+        return 0
+    else:
+        raise ValueError(f"invalid truth value {value}")
+
+
+def get_int_from_env(env_keys, default):
+    """Returns the first positive env value found in the `env_keys` list or the default."""
+    for e in env_keys:
+        val = int(os.environ.get(e, -1))
+        if val >= 0:
+            return val
+    return default
+
+
+def parse_flag_from_env(key, default=False):
+    """Returns truthy value for `key` from the env if available else the default."""
+    value = os.environ.get(key, str(default))
+    return str_to_bool(value) == 1  # As its name indicates `str_to_bool` actually returns an int...
+
+
+def parse_choice_from_env(key, default="no"):
+    value = os.environ.get(key, str(default))
+    return value
+
+
+def are_libraries_initialized(*library_names: str) -> List[str]:
+    """
+    Checks if any of `library_names` are imported in the environment. Will return any names that are.
+    """
+    return [lib_name for lib_name in library_names if lib_name in sys.modules.keys()]
+
+
+def _nvidia_smi():
+    """
+    Returns the right nvidia-smi command based on the system.
+    """
+    if platform.system() == "Windows":
+        # If platform is Windows and nvidia-smi can't be found in path
+        # try from systemd drive with default installation path
+        command = which("nvidia-smi")
+        if command is None:
+            command = "%s\\Program Files\\NVIDIA Corporation\\NVSMI\\nvidia-smi.exe" % os.environ["systemdrive"]
+    else:
+        command = "nvidia-smi"
+    return command
+
+
+def get_gpu_info():
+    """
+    Gets GPU count and names using `nvidia-smi` instead of torch to not initialize CUDA.
+
+    Largely based on the `gputil` library.
+    """
+    # Returns as list of `n` GPUs and their names
+    output = subprocess.check_output(
+        [_nvidia_smi(), "--query-gpu=count,name", "--format=csv,noheader"], universal_newlines=True
+    )
+    output = output.strip()
+    gpus = output.split(os.linesep)
+    # Get names from output
+    gpu_count = len(gpus)
+    gpu_names = [gpu.split(",")[1].strip() for gpu in gpus]
+    return gpu_names, gpu_count
+
+
+def get_driver_version():
+    """
+    Returns the driver version
+
+    In the case of multiple GPUs, will return the first.
+    """
+    output = subprocess.check_output(
+        [_nvidia_smi(), "--query-gpu=driver_version", "--format=csv,noheader"], universal_newlines=True
+    )
+    output = output.strip()
+    return output.split(os.linesep)[0]
+
+
+def check_cuda_p2p_ib_support():
+    """
+    Checks if the devices being used have issues with P2P and IB communications, namely any consumer GPU hardware after
+    the 3090.
+
+    Noteably uses `nvidia-smi` instead of torch to not initialize CUDA.
+    """
+    try:
+        device_names, device_count = get_gpu_info()
+        # As new consumer GPUs get released, add them to `unsupported_devices``
+        unsupported_devices = {"RTX 40"}
+        if device_count > 1:
+            if any(
+                unsupported_device in device_name
+                for device_name in device_names
+                for unsupported_device in unsupported_devices
+            ):
+                # Check if they have the right driver version
+                acceptable_driver_version = "550.40.07"
+                current_driver_version = get_driver_version()
+                if parse(current_driver_version) < parse(acceptable_driver_version):
+                    return False
+                return True
+    except Exception:
+        pass
+    return True
+
+
+def check_fp8_capability():
+    """
+    Checks if all the current GPUs available support FP8.
+
+    Notably must initialize `torch.cuda` to check.
+    """
+    cuda_device_capacity = torch.cuda.get_device_capability()
+    return cuda_device_capacity >= (8, 9)
+
+
+@dataclass
+class CPUInformation:
+    """
+    Stores information about the CPU in a distributed environment. It contains the following attributes:
+    - rank: The rank of the current process.
+    - world_size: The total number of processes in the world.
+    - local_rank: The rank of the current process on the local node.
+    - local_world_size: The total number of processes on the local node.
+    """
+
+    rank: int = field(default=0, metadata={"help": "The rank of the current process."})
+    world_size: int = field(default=1, metadata={"help": "The total number of processes in the world."})
+    local_rank: int = field(default=0, metadata={"help": "The rank of the current process on the local node."})
+    local_world_size: int = field(default=1, metadata={"help": "The total number of processes on the local node."})
+
+
+def get_cpu_distributed_information() -> CPUInformation:
+    """
+    Returns various information about the environment in relation to CPU distributed training as a `CPUInformation`
+    dataclass.
+    """
+    information = {}
+    information["rank"] = get_int_from_env(["RANK", "PMI_RANK", "OMPI_COMM_WORLD_RANK", "MV2_COMM_WORLD_RANK"], 0)
+    information["world_size"] = get_int_from_env(
+        ["WORLD_SIZE", "PMI_SIZE", "OMPI_COMM_WORLD_SIZE", "MV2_COMM_WORLD_SIZE"], 1
+    )
+    information["local_rank"] = get_int_from_env(
+        ["LOCAL_RANK", "MPI_LOCALRANKID", "OMPI_COMM_WORLD_LOCAL_RANK", "MV2_COMM_WORLD_LOCAL_RANK"], 0
+    )
+    information["local_world_size"] = get_int_from_env(
+        ["LOCAL_WORLD_SIZE", "MPI_LOCALNRANKS", "OMPI_COMM_WORLD_LOCAL_SIZE", "MV2_COMM_WORLD_LOCAL_SIZE"],
+        1,
+    )
+    return CPUInformation(**information)
+
+
+def override_numa_affinity(local_process_index: int, verbose: Optional[bool] = None) -> None:
+    """
+    Overrides whatever NUMA affinity is set for the current process. This is very taxing and requires recalculating the
+    affinity to set, ideally you should use `utils.environment.set_numa_affinity` instead.
+
+    Args:
+        local_process_index (int):
+            The index of the current process on the current server.
+        verbose (bool, *optional*):
+            Whether to log out the assignment of each CPU. If `ACCELERATE_DEBUG_MODE` is enabled, will default to True.
+    """
+    if verbose is None:
+        verbose = parse_flag_from_env("ACCELERATE_DEBUG_MODE", False)
+    if torch.cuda.is_available():
+        from accelerate.utils import is_pynvml_available
+
+        if not is_pynvml_available():
+            raise ImportError(
+                "To set CPU affinity on CUDA GPUs the `pynvml` package must be available. (`pip install pynvml`)"
+            )
+        import pynvml as nvml
+
+        # The below code is based on https://github.com/NVIDIA/DeepLearningExamples/blob/master/TensorFlow2/LanguageModeling/BERT/gpu_affinity.py
+        nvml.nvmlInit()
+        num_elements = math.ceil(os.cpu_count() / 64)
+        handle = nvml.nvmlDeviceGetHandleByIndex(local_process_index)
+        affinity_string = ""
+        for j in nvml.nvmlDeviceGetCpuAffinity(handle, num_elements):
+            # assume nvml returns list of 64 bit ints
+            affinity_string = f"{j:064b}{affinity_string}"
+        affinity_list = [int(x) for x in affinity_string]
+        affinity_list.reverse()  # so core 0 is the 0th element
+        affinity_to_set = [i for i, e in enumerate(affinity_list) if e != 0]
+        os.sched_setaffinity(0, affinity_to_set)
+        if verbose:
+            cpu_cores = os.sched_getaffinity(0)
+            logger.info(f"Assigning {len(cpu_cores)} cpu cores to process {local_process_index}: {cpu_cores}")
+
+
+@lru_cache
+def set_numa_affinity(local_process_index: int, verbose: Optional[bool] = None) -> None:
+    """
+    Assigns the current process to a specific NUMA node. Ideally most efficient when having at least 2 cpus per node.
+
+    This result is cached between calls. If you want to override it, please use
+    `accelerate.utils.environment.override_numa_afifnity`.
+
+    Args:
+        local_process_index (int):
+            The index of the current process on the current server.
+        verbose (bool, *optional*):
+            Whether to print the new cpu cores assignment for each process. If `ACCELERATE_DEBUG_MODE` is enabled, will
+            default to True.
+    """
+    override_numa_affinity(local_process_index=local_process_index, verbose=verbose)
diff --git a/llm/Lib/site-packages/accelerate/utils/fsdp_utils.py b/llm/Lib/site-packages/accelerate/utils/fsdp_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..01bb54b262b7f00b4bfb0933fc5fe94b24146097
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/fsdp_utils.py
@@ -0,0 +1,209 @@
+# Copyright 2023 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import os
+
+import torch
+
+from ..logging import get_logger
+from .constants import FSDP_MODEL_NAME, FSDP_PYTORCH_VERSION, OPTIMIZER_NAME
+from .imports import is_torch_distributed_available
+from .modeling import is_peft_model
+from .versions import is_torch_version
+
+
+if is_torch_version(">=", FSDP_PYTORCH_VERSION) and is_torch_distributed_available():
+    import torch.distributed.checkpoint as dist_cp
+    from torch.distributed.checkpoint.default_planner import DefaultLoadPlanner, DefaultSavePlanner
+    from torch.distributed.checkpoint.optimizer import load_sharded_optimizer_state_dict
+    from torch.distributed.fsdp.fully_sharded_data_parallel import FullyShardedDataParallel as FSDP
+    from torch.distributed.fsdp.fully_sharded_data_parallel import StateDictType
+
+
+logger = get_logger(__name__)
+
+
+def _get_model_state_dict(model, adapter_only=False):
+    if adapter_only and is_peft_model(model):
+        from peft import get_peft_model_state_dict
+
+        return get_peft_model_state_dict(model, adapter_name=model.active_adapter)
+    else:
+        return model.state_dict()
+
+
+def _set_model_state_dict(model, state_dict, adapter_only=False):
+    if adapter_only and is_peft_model(model):
+        from peft import set_peft_model_state_dict
+
+        return set_peft_model_state_dict(model, state_dict, adapter_name=model.active_adapter)
+    else:
+        return model.load_state_dict(state_dict)
+
+
+def save_fsdp_model(fsdp_plugin, accelerator, model, output_dir, model_index=0, adapter_only=False):
+    os.makedirs(output_dir, exist_ok=True)
+
+    if fsdp_plugin.state_dict_type == StateDictType.FULL_STATE_DICT:
+        # FSDP raises error when single GPU is used with `offload_to_cpu=True` for FULL_STATE_DICT
+        # so, only enable it when num_processes>1
+        is_multi_process = accelerator.num_processes > 1
+        fsdp_plugin.state_dict_config.offload_to_cpu = is_multi_process
+        fsdp_plugin.state_dict_config.rank0_only = is_multi_process
+
+    with FSDP.state_dict_type(
+        model, fsdp_plugin.state_dict_type, fsdp_plugin.state_dict_config, fsdp_plugin.optim_state_dict_config
+    ):
+        state_dict = _get_model_state_dict(model, adapter_only=adapter_only)
+        if fsdp_plugin.state_dict_type == StateDictType.FULL_STATE_DICT:
+            weights_name = f"{FSDP_MODEL_NAME}.bin" if model_index == 0 else f"{FSDP_MODEL_NAME}_{model_index}.bin"
+            output_model_file = os.path.join(output_dir, weights_name)
+            if accelerator.process_index == 0:
+                logger.info(f"Saving model to {output_model_file}")
+                torch.save(state_dict, output_model_file)
+                logger.info(f"Model saved to {output_model_file}")
+        elif fsdp_plugin.state_dict_type == StateDictType.LOCAL_STATE_DICT:
+            weights_name = (
+                f"{FSDP_MODEL_NAME}_rank{accelerator.process_index}.bin"
+                if model_index == 0
+                else f"{FSDP_MODEL_NAME}_{model_index}_rank{accelerator.process_index}.bin"
+            )
+            output_model_file = os.path.join(output_dir, weights_name)
+            logger.info(f"Saving model to {output_model_file}")
+            torch.save(state_dict, output_model_file)
+            logger.info(f"Model saved to {output_model_file}")
+        elif fsdp_plugin.state_dict_type == StateDictType.SHARDED_STATE_DICT:
+            ckpt_dir = os.path.join(output_dir, f"{FSDP_MODEL_NAME}_{model_index}")
+            os.makedirs(ckpt_dir, exist_ok=True)
+            logger.info(f"Saving model to {ckpt_dir}")
+            state_dict = {"model": state_dict}
+
+            dist_cp.save_state_dict(
+                state_dict=state_dict,
+                storage_writer=dist_cp.FileSystemWriter(ckpt_dir),
+                planner=DefaultSavePlanner(),
+            )
+            logger.info(f"Model saved to {ckpt_dir}")
+
+
+def load_fsdp_model(fsdp_plugin, accelerator, model, input_dir, model_index=0, adapter_only=False):
+    accelerator.wait_for_everyone()
+    if fsdp_plugin.state_dict_type == StateDictType.FULL_STATE_DICT:
+        # FSDP raises error when single GPU is used with `offload_to_cpu=True` for FULL_STATE_DICT
+        # so, only enable it when num_processes>1
+        is_multi_process = accelerator.num_processes > 1
+        fsdp_plugin.state_dict_config.offload_to_cpu = is_multi_process
+        fsdp_plugin.state_dict_config.rank0_only = is_multi_process
+    with FSDP.state_dict_type(
+        model, fsdp_plugin.state_dict_type, fsdp_plugin.state_dict_config, fsdp_plugin.optim_state_dict_config
+    ):
+        if fsdp_plugin.state_dict_type == StateDictType.FULL_STATE_DICT:
+            if type(model) != FSDP and accelerator.process_index != 0:
+                if not fsdp_plugin.sync_module_states:
+                    raise ValueError(
+                        "Set the `sync_module_states` flag to `True` so that model states are synced across processes when "
+                        "initializing FSDP object"
+                    )
+                return
+            weights_name = f"{FSDP_MODEL_NAME}.bin" if model_index == 0 else f"{FSDP_MODEL_NAME}_{model_index}.bin"
+            input_model_file = os.path.join(input_dir, weights_name)
+            logger.info(f"Loading model from {input_model_file}")
+            state_dict = torch.load(input_model_file)
+            logger.info(f"Model loaded from {input_model_file}")
+        elif fsdp_plugin.state_dict_type == StateDictType.LOCAL_STATE_DICT:
+            weights_name = (
+                f"{FSDP_MODEL_NAME}_rank{accelerator.process_index}.bin"
+                if model_index == 0
+                else f"{FSDP_MODEL_NAME}_{model_index}_rank{accelerator.process_index}.bin"
+            )
+            input_model_file = os.path.join(input_dir, weights_name)
+            logger.info(f"Loading model from {input_model_file}")
+            state_dict = torch.load(input_model_file)
+            logger.info(f"Model loaded from {input_model_file}")
+        elif fsdp_plugin.state_dict_type == StateDictType.SHARDED_STATE_DICT:
+            ckpt_dir = (
+                os.path.join(input_dir, f"{FSDP_MODEL_NAME}_{model_index}")
+                if f"{FSDP_MODEL_NAME}" not in input_dir
+                else input_dir
+            )
+            logger.info(f"Loading model from {ckpt_dir}")
+            state_dict = {"model": _get_model_state_dict(model, adapter_only=adapter_only)}
+            dist_cp.load_state_dict(
+                state_dict=state_dict,
+                storage_reader=dist_cp.FileSystemReader(ckpt_dir),
+                planner=DefaultLoadPlanner(),
+            )
+            state_dict = state_dict["model"]
+            logger.info(f"Model loaded from {ckpt_dir}")
+        load_result = _set_model_state_dict(model, state_dict, adapter_only=adapter_only)
+    return load_result
+
+
+def save_fsdp_optimizer(fsdp_plugin, accelerator, optimizer, model, output_dir, optimizer_index=0):
+    os.makedirs(output_dir, exist_ok=True)
+    with FSDP.state_dict_type(
+        model, fsdp_plugin.state_dict_type, fsdp_plugin.state_dict_config, fsdp_plugin.optim_state_dict_config
+    ):
+        optim_state = FSDP.optim_state_dict(model, optimizer)
+        if fsdp_plugin.state_dict_type == StateDictType.FULL_STATE_DICT:
+            if accelerator.process_index == 0:
+                optim_state_name = (
+                    f"{OPTIMIZER_NAME}.bin" if optimizer_index == 0 else f"{OPTIMIZER_NAME}_{optimizer_index}.bin"
+                )
+                output_optimizer_file = os.path.join(output_dir, optim_state_name)
+                logger.info(f"Saving Optimizer state to {output_optimizer_file}")
+                torch.save(optim_state, output_optimizer_file)
+                logger.info(f"Optimizer state saved in {output_optimizer_file}")
+        else:
+            ckpt_dir = os.path.join(output_dir, f"{OPTIMIZER_NAME}_{optimizer_index}")
+            os.makedirs(ckpt_dir, exist_ok=True)
+            logger.info(f"Saving Optimizer state to {ckpt_dir}")
+            dist_cp.save_state_dict(
+                state_dict={"optimizer": optim_state},
+                storage_writer=dist_cp.FileSystemWriter(ckpt_dir),
+                planner=DefaultSavePlanner(),
+            )
+            logger.info(f"Optimizer state saved in {ckpt_dir}")
+
+
+def load_fsdp_optimizer(fsdp_plugin, accelerator, optimizer, model, input_dir, optimizer_index=0, adapter_only=False):
+    accelerator.wait_for_everyone()
+    with FSDP.state_dict_type(
+        model, fsdp_plugin.state_dict_type, fsdp_plugin.state_dict_config, fsdp_plugin.optim_state_dict_config
+    ):
+        if fsdp_plugin.state_dict_type == StateDictType.FULL_STATE_DICT:
+            optim_state = None
+            if accelerator.process_index == 0 or not fsdp_plugin.optim_state_dict_config.rank0_only:
+                optimizer_name = (
+                    f"{OPTIMIZER_NAME}.bin" if optimizer_index == 0 else f"{OPTIMIZER_NAME}_{optimizer_index}.bin"
+                )
+                input_optimizer_file = os.path.join(input_dir, optimizer_name)
+                logger.info(f"Loading Optimizer state from {input_optimizer_file}")
+                optim_state = torch.load(input_optimizer_file)
+                logger.info(f"Optimizer state loaded from {input_optimizer_file}")
+        else:
+            ckpt_dir = (
+                os.path.join(input_dir, f"{OPTIMIZER_NAME}_{optimizer_index}")
+                if f"{OPTIMIZER_NAME}" not in input_dir
+                else input_dir
+            )
+            logger.info(f"Loading Optimizer from {ckpt_dir}")
+            optim_state = load_sharded_optimizer_state_dict(
+                model_state_dict=_get_model_state_dict(model, adapter_only=adapter_only),
+                optimizer_key="optimizer",
+                storage_reader=dist_cp.FileSystemReader(ckpt_dir),
+            )
+            optim_state = optim_state["optimizer"]
+            logger.info(f"Optimizer loaded from {ckpt_dir}")
+        flattened_osd = FSDP.optim_state_dict_to_load(model=model, optim=optimizer, optim_state_dict=optim_state)
+        optimizer.load_state_dict(flattened_osd)
diff --git a/llm/Lib/site-packages/accelerate/utils/imports.py b/llm/Lib/site-packages/accelerate/utils/imports.py
new file mode 100644
index 0000000000000000000000000000000000000000..1ef57c05d46cd2db4a21854f477c47048f71c2e0
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/imports.py
@@ -0,0 +1,385 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import importlib
+import importlib.metadata
+import os
+import warnings
+from functools import lru_cache
+
+import torch
+from packaging import version
+from packaging.version import parse
+
+from .environment import parse_flag_from_env, str_to_bool
+from .versions import compare_versions, is_torch_version
+
+
+# Try to run Torch native job in an environment with TorchXLA installed by setting this value to 0.
+USE_TORCH_XLA = parse_flag_from_env("USE_TORCH_XLA", default=True)
+
+_torch_xla_available = False
+if USE_TORCH_XLA:
+    try:
+        import torch_xla.core.xla_model as xm  # noqa: F401
+        import torch_xla.runtime
+
+        _torch_xla_available = True
+    except ImportError:
+        pass
+
+# Keep it for is_tpu_available. It will be removed along with is_tpu_available.
+_tpu_available = _torch_xla_available
+
+# Cache this result has it's a C FFI call which can be pretty time-consuming
+_torch_distributed_available = torch.distributed.is_available()
+
+
+def _is_package_available(pkg_name, metadata_name=None):
+    # Check we're not importing a "pkg_name" directory somewhere but the actual library by trying to grab the version
+    package_exists = importlib.util.find_spec(pkg_name) is not None
+    if package_exists:
+        try:
+            # Some libraries have different names in the metadata
+            _ = importlib.metadata.metadata(pkg_name if metadata_name is None else metadata_name)
+            return True
+        except importlib.metadata.PackageNotFoundError:
+            return False
+
+
+def is_torch_distributed_available() -> bool:
+    return _torch_distributed_available
+
+
+def is_ccl_available():
+    try:
+        pass
+    except ImportError:
+        print(
+            "Intel(R) oneCCL Bindings for PyTorch* is required to run DDP on Intel(R) GPUs, but it is not"
+            " detected. If you see \"ValueError: Invalid backend: 'ccl'\" error, please install Intel(R) oneCCL"
+            " Bindings for PyTorch*."
+        )
+    return (
+        importlib.util.find_spec("torch_ccl") is not None
+        or importlib.util.find_spec("oneccl_bindings_for_pytorch") is not None
+    )
+
+
+def get_ccl_version():
+    return importlib.metadata.version("oneccl_bind_pt")
+
+
+def is_pynvml_available():
+    return _is_package_available("pynvml")
+
+
+def is_msamp_available():
+    return _is_package_available("msamp", "ms-amp")
+
+
+def is_transformer_engine_available():
+    return _is_package_available("transformer_engine")
+
+
+def is_fp8_available():
+    return is_msamp_available() or is_transformer_engine_available()
+
+
+def is_cuda_available():
+    """
+    Checks if `cuda` is available via an `nvml-based` check which won't trigger the drivers and leave cuda
+    uninitialized.
+    """
+    pytorch_nvml_based_cuda_check_previous_value = os.environ.get("PYTORCH_NVML_BASED_CUDA_CHECK")
+    try:
+        os.environ["PYTORCH_NVML_BASED_CUDA_CHECK"] = str(1)
+        available = torch.cuda.is_available()
+    finally:
+        if pytorch_nvml_based_cuda_check_previous_value:
+            os.environ["PYTORCH_NVML_BASED_CUDA_CHECK"] = pytorch_nvml_based_cuda_check_previous_value
+        else:
+            os.environ.pop("PYTORCH_NVML_BASED_CUDA_CHECK", None)
+
+    return available
+
+
+@lru_cache
+def is_tpu_available(check_device=True):
+    "Checks if `torch_xla` is installed and potentially if a TPU is in the environment"
+    warnings.warn(
+        "`is_tpu_available` is deprecated and will be removed in v0.27.0. "
+        "Please use the `is_torch_xla_available` instead.",
+        FutureWarning,
+    )
+    # Due to bugs on the amp series GPUs, we disable torch-xla on them
+    if is_cuda_available():
+        return False
+    if check_device:
+        if _tpu_available:
+            try:
+                # Will raise a RuntimeError if no XLA configuration is found
+                _ = xm.xla_device()
+                return True
+            except RuntimeError:
+                return False
+    return _tpu_available
+
+
+@lru_cache
+def is_torch_xla_available(check_is_tpu=False, check_is_gpu=False):
+    """
+    Check if `torch_xla` is available. To train a native pytorch job in an environment with torch xla installed, set
+    the USE_TORCH_XLA to false.
+    """
+    assert not (check_is_tpu and check_is_gpu), "The check_is_tpu and check_is_gpu cannot both be true."
+
+    if not _torch_xla_available:
+        return False
+    elif check_is_gpu:
+        return torch_xla.runtime.device_type() in ["GPU", "CUDA"]
+    elif check_is_tpu:
+        return torch_xla.runtime.device_type() == "TPU"
+
+    return True
+
+
+def is_deepspeed_available():
+    if is_mlu_available():
+        return _is_package_available("deepspeed", metadata_name="deepspeed-mlu")
+    return _is_package_available("deepspeed")
+
+
+def is_pippy_available():
+    package_exists = _is_package_available("pippy", "torchpippy")
+    if package_exists:
+        pippy_version = version.parse(importlib.metadata.version("torchpippy"))
+        return compare_versions(pippy_version, ">", "0.1.1")
+    return False
+
+
+def is_bf16_available(ignore_tpu=False):
+    "Checks if bf16 is supported, optionally ignoring the TPU"
+    if is_torch_xla_available(check_is_tpu=True):
+        return not ignore_tpu
+    if is_cuda_available():
+        return torch.cuda.is_bf16_supported()
+    return True
+
+
+def is_4bit_bnb_available():
+    package_exists = _is_package_available("bitsandbytes")
+    if package_exists:
+        bnb_version = version.parse(importlib.metadata.version("bitsandbytes"))
+        return compare_versions(bnb_version, ">=", "0.39.0")
+    return False
+
+
+def is_8bit_bnb_available():
+    package_exists = _is_package_available("bitsandbytes")
+    if package_exists:
+        bnb_version = version.parse(importlib.metadata.version("bitsandbytes"))
+        return compare_versions(bnb_version, ">=", "0.37.2")
+    return False
+
+
+def is_bnb_available():
+    return _is_package_available("bitsandbytes")
+
+
+def is_megatron_lm_available():
+    if str_to_bool(os.environ.get("ACCELERATE_USE_MEGATRON_LM", "False")) == 1:
+        package_exists = importlib.util.find_spec("megatron") is not None
+        if package_exists:
+            try:
+                megatron_version = parse(importlib.metadata.version("megatron-lm"))
+                return compare_versions(megatron_version, ">=", "2.2.0")
+            except Exception as e:
+                warnings.warn(f"Parse Megatron version failed. Exception:{e}")
+                return False
+
+
+def is_transformers_available():
+    return _is_package_available("transformers")
+
+
+def is_datasets_available():
+    return _is_package_available("datasets")
+
+
+def is_peft_available():
+    return _is_package_available("peft")
+
+
+def is_timm_available():
+    return _is_package_available("timm")
+
+
+def is_aim_available():
+    package_exists = _is_package_available("aim")
+    if package_exists:
+        aim_version = version.parse(importlib.metadata.version("aim"))
+        return compare_versions(aim_version, "<", "4.0.0")
+    return False
+
+
+def is_tensorboard_available():
+    return _is_package_available("tensorboard") or _is_package_available("tensorboardX")
+
+
+def is_wandb_available():
+    return _is_package_available("wandb")
+
+
+def is_comet_ml_available():
+    return _is_package_available("comet_ml")
+
+
+def is_boto3_available():
+    return _is_package_available("boto3")
+
+
+def is_rich_available():
+    if _is_package_available("rich"):
+        if "ACCELERATE_DISABLE_RICH" in os.environ:
+            warnings.warn(
+                "`ACCELERATE_DISABLE_RICH` is deprecated and will be removed in v0.22.0 and deactivated by default. Please use `ACCELERATE_ENABLE_RICH` if you wish to use `rich`."
+            )
+            return not parse_flag_from_env("ACCELERATE_DISABLE_RICH", False)
+        return parse_flag_from_env("ACCELERATE_ENABLE_RICH", False)
+    return False
+
+
+def is_sagemaker_available():
+    return _is_package_available("sagemaker")
+
+
+def is_tqdm_available():
+    return _is_package_available("tqdm")
+
+
+def is_clearml_available():
+    return _is_package_available("clearml")
+
+
+def is_pandas_available():
+    return _is_package_available("pandas")
+
+
+def is_mlflow_available():
+    if _is_package_available("mlflow"):
+        return True
+
+    if importlib.util.find_spec("mlflow") is not None:
+        try:
+            _ = importlib.metadata.metadata("mlflow-skinny")
+            return True
+        except importlib.metadata.PackageNotFoundError:
+            return False
+    return False
+
+
+def is_mps_available():
+    return is_torch_version(">=", "1.12") and torch.backends.mps.is_available() and torch.backends.mps.is_built()
+
+
+def is_ipex_available():
+    def get_major_and_minor_from_version(full_version):
+        return str(version.parse(full_version).major) + "." + str(version.parse(full_version).minor)
+
+    _torch_version = importlib.metadata.version("torch")
+    if importlib.util.find_spec("intel_extension_for_pytorch") is None:
+        return False
+    _ipex_version = "N/A"
+    try:
+        _ipex_version = importlib.metadata.version("intel_extension_for_pytorch")
+    except importlib.metadata.PackageNotFoundError:
+        return False
+    torch_major_and_minor = get_major_and_minor_from_version(_torch_version)
+    ipex_major_and_minor = get_major_and_minor_from_version(_ipex_version)
+    if torch_major_and_minor != ipex_major_and_minor:
+        warnings.warn(
+            f"Intel Extension for PyTorch {ipex_major_and_minor} needs to work with PyTorch {ipex_major_and_minor}.*,"
+            f" but PyTorch {_torch_version} is found. Please switch to the matching version and run again."
+        )
+        return False
+    return True
+
+
+@lru_cache
+def is_mlu_available(check_device=False):
+    "Checks if `torch_mlu` is installed and potentially if a MLU is in the environment"
+    if importlib.util.find_spec("torch_mlu") is None:
+        return False
+
+    import torch
+    import torch_mlu  # noqa: F401
+
+    if check_device:
+        try:
+            # Will raise a RuntimeError if no MLU is found
+            _ = torch.mlu.device_count()
+            return torch.mlu.is_available()
+        except RuntimeError:
+            return False
+    return hasattr(torch, "mlu") and torch.mlu.is_available()
+
+
+@lru_cache
+def is_npu_available(check_device=False):
+    "Checks if `torch_npu` is installed and potentially if a NPU is in the environment"
+    if importlib.util.find_spec("torch") is None or importlib.util.find_spec("torch_npu") is None:
+        return False
+
+    import torch
+    import torch_npu  # noqa: F401
+
+    if check_device:
+        try:
+            # Will raise a RuntimeError if no NPU is found
+            _ = torch.npu.device_count()
+            return torch.npu.is_available()
+        except RuntimeError:
+            return False
+    return hasattr(torch, "npu") and torch.npu.is_available()
+
+
+@lru_cache
+def is_xpu_available(check_device=False):
+    "check if user disables it explicitly"
+    if not parse_flag_from_env("ACCELERATE_USE_XPU", default=True):
+        return False
+    "Checks if `intel_extension_for_pytorch` is installed and potentially if a XPU is in the environment"
+    if is_ipex_available():
+        import torch
+
+        if is_torch_version("<=", "1.12"):
+            return False
+    else:
+        return False
+
+    import intel_extension_for_pytorch  # noqa: F401
+
+    if check_device:
+        try:
+            # Will raise a RuntimeError if no XPU  is found
+            _ = torch.xpu.device_count()
+            return torch.xpu.is_available()
+        except RuntimeError:
+            return False
+    return hasattr(torch, "xpu") and torch.xpu.is_available()
+
+
+def is_dvclive_available():
+    return _is_package_available("dvclive")
diff --git a/llm/Lib/site-packages/accelerate/utils/launch.py b/llm/Lib/site-packages/accelerate/utils/launch.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc074270bf8f8f66f9a963c6990de0dd05e766ce
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/launch.py
@@ -0,0 +1,624 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import argparse
+import os
+import subprocess
+import sys
+import warnings
+from ast import literal_eval
+from shutil import which
+from typing import Any, Dict, List, Tuple
+
+import torch
+
+from ..commands.config.config_args import SageMakerConfig
+from ..utils import (
+    DynamoBackend,
+    PrecisionType,
+    is_ipex_available,
+    is_mlu_available,
+    is_npu_available,
+    is_torch_xla_available,
+    is_xpu_available,
+)
+from ..utils.constants import DEEPSPEED_MULTINODE_LAUNCHERS
+from ..utils.other import is_port_in_use, merge_dicts
+from .dataclasses import DistributedType, SageMakerDistributedType
+
+
+def _filter_args(args, parser, default_args=[]):
+    """
+    Filters out all `accelerate` specific args
+    """
+    new_args, _ = parser.parse_known_args(default_args)
+    for key, value in vars(args).items():
+        if key in vars(new_args).keys():
+            setattr(new_args, key, value)
+    return new_args
+
+
+def _get_mpirun_args():
+    """
+    Determines the executable and argument names for mpirun, based on the type of install. The supported MPI programs
+    are: OpenMPI, Intel MPI, or MVAPICH.
+
+    Returns: Program name and arg names for hostfile, num processes, and processes per node
+    """
+    # Find the MPI program name
+    mpi_apps = [x for x in ["mpirun", "mpiexec"] if which(x)]
+
+    if len(mpi_apps) == 0:
+        raise OSError("mpirun or mpiexec were not found. Ensure that Intel MPI, Open MPI, or MVAPICH are installed.")
+
+    # Call the app with the --version flag to determine which MPI app is installed
+    mpi_app = mpi_apps[0]
+    mpirun_version = subprocess.check_output([mpi_app, "--version"])
+
+    if b"Open MPI" in mpirun_version:
+        return mpi_app, "--hostfile", "-n", "--npernode"
+    else:
+        # Intel MPI and MVAPICH both use the same arg names
+        return mpi_app, "-f", "-n", "-ppn"
+
+
+def prepare_simple_launcher_cmd_env(args: argparse.Namespace) -> Tuple[List[str], Dict[str, str]]:
+    """
+    Prepares and returns the command list and an environment with the correct simple launcher environment variables.
+    """
+    cmd = []
+    if args.no_python and args.module:
+        raise ValueError("--module and --no_python cannot be used together")
+
+    if args.mpirun_hostfile is not None:
+        mpi_app_name, hostfile_arg, num_proc_arg, proc_per_node_arg = _get_mpirun_args()
+        mpirun_ccl = getattr(args, "mpirun_ccl", None)
+        num_machines = args.num_machines
+        num_processes = getattr(args, "num_processes", None)
+        nproc_per_node = str(num_processes // num_machines) if num_processes and num_machines else "1"
+        cmd += [mpi_app_name, hostfile_arg, args.mpirun_hostfile, proc_per_node_arg, nproc_per_node]
+        if num_processes:
+            cmd += [num_proc_arg, str(num_processes)]
+    if not args.no_python:
+        cmd.append(sys.executable)
+        if args.module:
+            cmd.append("-m")
+    cmd.append(args.training_script)
+    cmd.extend(args.training_script_args)
+
+    current_env = os.environ.copy()
+    current_env["ACCELERATE_USE_CPU"] = str(args.cpu or args.use_cpu)
+    if args.debug:
+        current_env["ACCELERATE_DEBUG_MODE"] = "true"
+    if args.gpu_ids != "all" and args.gpu_ids is not None:
+        if is_xpu_available():
+            current_env["ZE_AFFINITY_MASK"] = args.gpu_ids
+        elif is_mlu_available():
+            current_env["MLU_VISIBLE_DEVICES"] = args.gpu_ids
+        elif is_npu_available():
+            current_env["ASCEND_RT_VISIBLE_DEVICES"] = args.gpu_ids
+        else:
+            current_env["CUDA_VISIBLE_DEVICES"] = args.gpu_ids
+    if args.num_machines > 1:
+        current_env["MASTER_ADDR"] = args.main_process_ip
+        current_env["MASTER_PORT"] = str(args.main_process_port)
+
+        if args.mpirun_hostfile is not None:
+            current_env["CCL_WORKER_COUNT"] = mpirun_ccl
+    elif args.num_processes > 1:
+        current_env["MASTER_ADDR"] = args.main_process_ip if args.main_process_ip is not None else "127.0.0.1"
+        current_env["MASTER_PORT"] = str(args.main_process_port) if args.main_process_port is not None else "29500"
+
+    try:
+        mixed_precision = PrecisionType(args.mixed_precision.lower())
+    except ValueError:
+        raise ValueError(
+            f"Unknown mixed_precision mode: {args.mixed_precision.lower()}. Choose between {PrecisionType.list()}."
+        )
+
+    current_env["ACCELERATE_MIXED_PRECISION"] = str(mixed_precision)
+
+    try:
+        dynamo_backend = DynamoBackend(args.dynamo_backend.upper())
+    except ValueError:
+        raise ValueError(
+            f"Unknown dynamo backend: {args.dynamo_backend.upper()}. Choose between {DynamoBackend.list()}."
+        )
+    current_env["ACCELERATE_DYNAMO_BACKEND"] = dynamo_backend.value
+    current_env["ACCELERATE_DYNAMO_MODE"] = args.dynamo_mode
+    current_env["ACCELERATE_DYNAMO_USE_FULLGRAPH"] = str(args.dynamo_use_fullgraph)
+    current_env["ACCELERATE_DYNAMO_USE_DYNAMIC"] = str(args.dynamo_use_dynamic)
+
+    current_env["OMP_NUM_THREADS"] = str(args.num_cpu_threads_per_process)
+    if is_ipex_available():
+        current_env["ACCELERATE_USE_IPEX"] = str(args.ipex).lower()
+        current_env["ACCELERATE_USE_XPU"] = str(args.use_xpu).lower()
+    if args.enable_cpu_affinity:
+        current_env["ACCELERATE_CPU_AFFINITY"] = "1"
+    return cmd, current_env
+
+
+def prepare_multi_gpu_env(args: argparse.Namespace) -> Dict[str, str]:
+    """
+    Prepares and returns an environment with the correct multi-GPU environment variables.
+    """
+    num_processes = args.num_processes
+    num_machines = args.num_machines
+    main_process_ip = args.main_process_ip
+    main_process_port = args.main_process_port
+    if num_machines > 1:
+        args.nproc_per_node = str(num_processes // num_machines)
+        args.nnodes = str(num_machines)
+        args.node_rank = int(args.machine_rank)
+        if getattr(args, "same_network", False):
+            args.master_addr = str(main_process_ip)
+            args.master_port = str(main_process_port)
+        else:
+            args.rdzv_endpoint = f"{main_process_ip}:{main_process_port}"
+    else:
+        args.nproc_per_node = str(num_processes)
+        if main_process_port is not None:
+            args.master_port = str(main_process_port)
+
+    if main_process_port is None:
+        main_process_port = 29500
+
+    # only need to check port availability in main process, in case we have to start multiple launchers on the same machine
+    # for some reasons like splitting log files.
+    need_port_check = num_machines <= 1 or int(args.machine_rank) == 0
+    if need_port_check and is_port_in_use(main_process_port):
+        raise ConnectionError(
+            f"Tried to launch distributed communication on port `{main_process_port}`, but another process is utilizing it. "
+            "Please specify a different port (such as using the `--main_process_port` flag or specifying a different `main_process_port` in your config file)"
+            " and rerun your script. To automatically use the next open port (on a single node), you can set this to `0`."
+        )
+
+    if args.module and args.no_python:
+        raise ValueError("--module and --no_python cannot be used together")
+    elif args.module:
+        args.module = True
+    elif args.no_python:
+        args.no_python = True
+
+    current_env = os.environ.copy()
+    if args.debug:
+        current_env["ACCELERATE_DEBUG_MODE"] = "true"
+    gpu_ids = getattr(args, "gpu_ids", "all")
+    if gpu_ids != "all" and args.gpu_ids is not None:
+        if is_xpu_available():
+            current_env["ZE_AFFINITY_MASK"] = gpu_ids
+        elif is_mlu_available():
+            current_env["MLU_VISIBLE_DEVICES"] = gpu_ids
+        elif is_npu_available():
+            current_env["ASCEND_RT_VISIBLE_DEVICES"] = gpu_ids
+        else:
+            current_env["CUDA_VISIBLE_DEVICES"] = gpu_ids
+    mixed_precision = args.mixed_precision.lower()
+    try:
+        mixed_precision = PrecisionType(mixed_precision)
+    except ValueError:
+        raise ValueError(f"Unknown mixed_precision mode: {mixed_precision}. Choose between {PrecisionType.list()}.")
+
+    current_env["ACCELERATE_MIXED_PRECISION"] = str(mixed_precision)
+
+    try:
+        dynamo_backend = DynamoBackend(args.dynamo_backend.upper())
+    except ValueError:
+        raise ValueError(
+            f"Unknown dynamo backend: {args.dynamo_backend.upper()}. Choose between {DynamoBackend.list()}."
+        )
+    current_env["ACCELERATE_DYNAMO_BACKEND"] = dynamo_backend.value
+    current_env["ACCELERATE_DYNAMO_MODE"] = args.dynamo_mode
+    current_env["ACCELERATE_DYNAMO_USE_FULLGRAPH"] = str(args.dynamo_use_fullgraph)
+    current_env["ACCELERATE_DYNAMO_USE_DYNAMIC"] = str(args.dynamo_use_dynamic)
+
+    if args.use_fsdp:
+        current_env["ACCELERATE_USE_FSDP"] = "true"
+        if args.fsdp_cpu_ram_efficient_loading and not args.fsdp_sync_module_states:
+            raise ValueError("When using `--fsdp_cpu_ram_efficient_loading` set `--fsdp_sync_module_states` to `True`")
+
+        current_env["FSDP_SHARDING_STRATEGY"] = str(args.fsdp_sharding_strategy)
+        current_env["FSDP_OFFLOAD_PARAMS"] = str(args.fsdp_offload_params).lower()
+        current_env["FSDP_MIN_NUM_PARAMS"] = str(args.fsdp_min_num_params)
+        if args.fsdp_auto_wrap_policy is not None:
+            current_env["FSDP_AUTO_WRAP_POLICY"] = str(args.fsdp_auto_wrap_policy)
+        if args.fsdp_transformer_layer_cls_to_wrap is not None:
+            current_env["FSDP_TRANSFORMER_CLS_TO_WRAP"] = str(args.fsdp_transformer_layer_cls_to_wrap)
+        if args.fsdp_backward_prefetch_policy is not None:
+            warnings.warn(
+                "`fsdp_backward_prefetch_policy` is deprecated and will be removed in version 0.27.0 of 🤗 Accelerate. Use"
+                " `fsdp_backward_prefetch` instead",
+                FutureWarning,
+            )
+            args.fsdp_backward_prefetch = args.fsdp_backward_prefetch_policy
+        if args.fsdp_backward_prefetch is not None:
+            current_env["FSDP_BACKWARD_PREFETCH"] = str(args.fsdp_backward_prefetch)
+        if args.fsdp_state_dict_type is not None:
+            current_env["FSDP_STATE_DICT_TYPE"] = str(args.fsdp_state_dict_type)
+        current_env["FSDP_FORWARD_PREFETCH"] = str(args.fsdp_forward_prefetch).lower()
+        current_env["FSDP_USE_ORIG_PARAMS"] = str(args.fsdp_use_orig_params).lower()
+        current_env["FSDP_CPU_RAM_EFFICIENT_LOADING"] = str(args.fsdp_cpu_ram_efficient_loading).lower()
+        current_env["FSDP_SYNC_MODULE_STATES"] = str(args.fsdp_sync_module_states).lower()
+
+    if args.use_megatron_lm:
+        prefix = "MEGATRON_LM_"
+        current_env["ACCELERATE_USE_MEGATRON_LM"] = "true"
+        current_env[prefix + "TP_DEGREE"] = str(args.megatron_lm_tp_degree)
+        current_env[prefix + "PP_DEGREE"] = str(args.megatron_lm_pp_degree)
+        current_env[prefix + "GRADIENT_CLIPPING"] = str(args.megatron_lm_gradient_clipping)
+        if args.megatron_lm_num_micro_batches is not None:
+            current_env[prefix + "NUM_MICRO_BATCHES"] = str(args.megatron_lm_num_micro_batches)
+        if args.megatron_lm_sequence_parallelism is not None:
+            current_env[prefix + "SEQUENCE_PARALLELISM"] = str(args.megatron_lm_sequence_parallelism)
+        if args.megatron_lm_recompute_activations is not None:
+            current_env[prefix + "RECOMPUTE_ACTIVATIONS"] = str(args.megatron_lm_recompute_activations)
+        if args.megatron_lm_use_distributed_optimizer is not None:
+            current_env[prefix + "USE_DISTRIBUTED_OPTIMIZER"] = str(args.megatron_lm_use_distributed_optimizer)
+
+    current_env["OMP_NUM_THREADS"] = str(args.num_cpu_threads_per_process)
+    if args.enable_cpu_affinity:
+        current_env["ACCELERATE_CPU_AFFINITY"] = "1"
+    return current_env
+
+
+def prepare_deepspeed_cmd_env(args: argparse.Namespace) -> Tuple[List[str], Dict[str, str]]:
+    """
+    Prepares and returns the command list and an environment with the correct DeepSpeed environment variables.
+    """
+    num_processes = args.num_processes
+    num_machines = args.num_machines
+    main_process_ip = args.main_process_ip
+    main_process_port = args.main_process_port
+    cmd = None
+
+    # make sure launcher is not None
+    if args.deepspeed_multinode_launcher is None:
+        # set to default pdsh
+        args.deepspeed_multinode_launcher = DEEPSPEED_MULTINODE_LAUNCHERS[0]
+
+    if num_machines > 1 and args.deepspeed_multinode_launcher != DEEPSPEED_MULTINODE_LAUNCHERS[1]:
+        cmd = ["deepspeed", "--no_local_rank"]
+        cmd.extend(["--hostfile", str(args.deepspeed_hostfile), "--launcher", str(args.deepspeed_multinode_launcher)])
+        if args.deepspeed_exclusion_filter is not None:
+            cmd.extend(
+                [
+                    "--exclude",
+                    str(args.deepspeed_exclusion_filter),
+                ]
+            )
+        elif args.deepspeed_inclusion_filter is not None:
+            cmd.extend(
+                [
+                    "--include",
+                    str(args.deepspeed_inclusion_filter),
+                ]
+            )
+        else:
+            cmd.extend(["--num_gpus", str(args.num_processes // args.num_machines)])
+        if main_process_ip:
+            cmd.extend(["--master_addr", str(main_process_ip)])
+        cmd.extend(["--master_port", str(main_process_port)])
+        if args.module and args.no_python:
+            raise ValueError("--module and --no_python cannot be used together")
+        elif args.module:
+            cmd.append("--module")
+        elif args.no_python:
+            cmd.append("--no_python")
+        cmd.append(args.training_script)
+        cmd.extend(args.training_script_args)
+    elif num_machines > 1 and args.deepspeed_multinode_launcher == DEEPSPEED_MULTINODE_LAUNCHERS[1]:
+        args.nproc_per_node = str(num_processes // num_machines)
+        args.nnodes = str(num_machines)
+        args.node_rank = int(args.machine_rank)
+        if getattr(args, "same_network", False):
+            args.master_addr = str(main_process_ip)
+            args.master_port = str(main_process_port)
+        else:
+            args.rdzv_endpoint = f"{main_process_ip}:{main_process_port}"
+    else:
+        args.nproc_per_node = str(num_processes)
+        if main_process_port is not None:
+            args.master_port = str(main_process_port)
+
+    if main_process_port is None:
+        main_process_port = 29500
+
+    # only need to check port availability in main process, in case we have to start multiple launchers on the same machine
+    # for some reasons like splitting log files.
+    need_port_check = num_machines <= 1 or int(args.machine_rank) == 0
+    if need_port_check and is_port_in_use(main_process_port):
+        raise ConnectionError(
+            f"Tried to launch distributed communication on port `{main_process_port}`, but another process is utilizing it. "
+            "Please specify a different port (such as using the `--main_process_port` flag or specifying a different `main_process_port` in your config file)"
+            " and rerun your script. To automatically use the next open port (on a single node), you can set this to `0`."
+        )
+
+    if args.module and args.no_python:
+        raise ValueError("--module and --no_python cannot be used together")
+    elif args.module:
+        args.module = True
+    elif args.no_python:
+        args.no_python = True
+
+    current_env = os.environ.copy()
+    if args.debug:
+        current_env["ACCELERATE_DEBUG_MODE"] = "true"
+    gpu_ids = getattr(args, "gpu_ids", "all")
+    if gpu_ids != "all" and args.gpu_ids is not None:
+        if is_xpu_available():
+            current_env["ZE_AFFINITY_MASK"] = gpu_ids
+        elif is_mlu_available():
+            current_env["MLU_VISIBLE_DEVICES"] = gpu_ids
+        elif is_npu_available():
+            current_env["ASCEND_RT_VISIBLE_DEVICES"] = gpu_ids
+        else:
+            current_env["CUDA_VISIBLE_DEVICES"] = gpu_ids
+    try:
+        mixed_precision = PrecisionType(args.mixed_precision.lower())
+    except ValueError:
+        raise ValueError(
+            f"Unknown mixed_precision mode: {args.mixed_precision.lower()}. Choose between {PrecisionType.list()}."
+        )
+
+    current_env["PYTHONPATH"] = env_var_path_add("PYTHONPATH", os.path.abspath("."))
+    current_env["ACCELERATE_MIXED_PRECISION"] = str(mixed_precision)
+    current_env["ACCELERATE_CONFIG_DS_FIELDS"] = str(args.deepspeed_fields_from_accelerate_config).lower()
+    current_env["ACCELERATE_USE_DEEPSPEED"] = "true"
+    if args.zero_stage is not None:
+        current_env["ACCELERATE_DEEPSPEED_ZERO_STAGE"] = str(args.zero_stage)
+    if args.gradient_accumulation_steps is not None:
+        current_env["ACCELERATE_GRADIENT_ACCUMULATION_STEPS"] = str(args.gradient_accumulation_steps)
+    if args.gradient_clipping is not None:
+        current_env["ACCELERATE_GRADIENT_CLIPPING"] = str(args.gradient_clipping).lower()
+    if args.offload_optimizer_device is not None:
+        current_env["ACCELERATE_DEEPSPEED_OFFLOAD_OPTIMIZER_DEVICE"] = str(args.offload_optimizer_device).lower()
+    if args.offload_param_device is not None:
+        current_env["ACCELERATE_DEEPSPEED_OFFLOAD_PARAM_DEVICE"] = str(args.offload_param_device).lower()
+    if args.zero3_init_flag is not None:
+        current_env["ACCELERATE_DEEPSPEED_ZERO3_INIT"] = str(args.zero3_init_flag).lower()
+    if args.zero3_save_16bit_model is not None:
+        current_env["ACCELERATE_DEEPSPEED_ZERO3_SAVE_16BIT_MODEL"] = str(args.zero3_save_16bit_model).lower()
+    if args.deepspeed_config_file is not None:
+        current_env["ACCELERATE_DEEPSPEED_CONFIG_FILE"] = str(args.deepspeed_config_file)
+    if args.enable_cpu_affinity:
+        current_env["ACCELERATE_CPU_AFFINITY"] = "1"
+    return cmd, current_env
+
+
+def prepare_tpu(
+    args: argparse.Namespace, current_env: Dict[str, str], pod: bool = False
+) -> Tuple[argparse.Namespace, Dict[str, str]]:
+    """
+    Prepares and returns an environment with the correct TPU environment variables.
+    """
+    if args.mixed_precision == "bf16" and is_torch_xla_available(check_is_tpu=True):
+        if args.downcast_bf16:
+            current_env["XLA_DOWNCAST_BF16"] = "1"
+        else:
+            current_env["XLA_USE_BF16"] = "1"
+    if args.debug:
+        current_env["ACCELERATE_DEBUG_MODE"] = "true"
+    if pod:
+        # Take explicit args and set them up for XLA
+        args.vm = args.tpu_vm
+        args.tpu = args.tpu_name
+    return args, current_env
+
+
+def _convert_nargs_to_dict(nargs: List[str]) -> Dict[str, str]:
+    if len(nargs) < 0:
+        return {}
+    # helper function to infer type for argsparser
+
+    def _infer_type(s):
+        try:
+            s = float(s)
+
+            if s // 1 == s:
+                return int(s)
+            return s
+        except ValueError:
+            return s
+
+    parser = argparse.ArgumentParser()
+    _, unknown = parser.parse_known_args(nargs)
+    for index, argument in enumerate(unknown):
+        if argument.startswith(("-", "--")):
+            action = None
+            if index + 1 < len(unknown):  # checks if next index would be in list
+                if unknown[index + 1].startswith(("-", "--")):  # checks if next element is an key
+                    # raise an error if element is store_true or store_false
+                    raise ValueError(
+                        "SageMaker doesn’t support argparse actions for `store_true` or `store_false`. Please define explicit types"
+                    )
+            else:  # raise an error if last element is store_true or store_false
+                raise ValueError(
+                    "SageMaker doesn’t support argparse actions for `store_true` or `store_false`. Please define explicit types"
+                )
+            # adds argument to parser based on action_store true
+            if action is None:
+                parser.add_argument(argument, type=_infer_type)
+            else:
+                parser.add_argument(argument, action=action)
+
+    return {
+        key: (literal_eval(value) if value in ("True", "False") else value)
+        for key, value in parser.parse_args(nargs).__dict__.items()
+    }
+
+
+def prepare_sagemager_args_inputs(
+    sagemaker_config: SageMakerConfig, args: argparse.Namespace
+) -> Tuple[argparse.Namespace, Dict[str, Any]]:
+    # configure environment
+    print("Configuring Amazon SageMaker environment")
+    os.environ["AWS_DEFAULT_REGION"] = sagemaker_config.region
+
+    # configure credentials
+    if sagemaker_config.profile is not None:
+        os.environ["AWS_PROFILE"] = sagemaker_config.profile
+    elif args.aws_access_key_id is not None and args.aws_secret_access_key is not None:
+        os.environ["AWS_ACCESS_KEY_ID"] = args.aws_access_key_id
+        os.environ["AWS_SECRET_ACCESS_KEY"] = args.aws_secret_access_key
+    else:
+        raise OSError("You need to provide an aws_access_key_id and aws_secret_access_key when not using aws_profile")
+
+    # extract needed arguments
+    source_dir = os.path.dirname(args.training_script)
+    if not source_dir:  # checks if string is empty
+        source_dir = "."
+    entry_point = os.path.basename(args.training_script)
+    if not entry_point.endswith(".py"):
+        raise ValueError(f'Your training script should be a python script and not "{entry_point}"')
+
+    print("Converting Arguments to Hyperparameters")
+    hyperparameters = _convert_nargs_to_dict(args.training_script_args)
+
+    try:
+        mixed_precision = PrecisionType(args.mixed_precision.lower())
+    except ValueError:
+        raise ValueError(
+            f"Unknown mixed_precision mode: {args.mixed_precision.lower()}. Choose between {PrecisionType.list()}."
+        )
+
+    try:
+        dynamo_backend = DynamoBackend(args.dynamo_backend.upper())
+    except ValueError:
+        raise ValueError(
+            f"Unknown dynamo backend: {args.dynamo_backend.upper()}. Choose between {DynamoBackend.list()}."
+        )
+
+    # Environment variables to be set for use during training job
+    environment = {
+        "ACCELERATE_USE_SAGEMAKER": "true",
+        "ACCELERATE_MIXED_PRECISION": str(mixed_precision),
+        "ACCELERATE_DYNAMO_BACKEND": dynamo_backend.value,
+        "ACCELERATE_DYNAMO_MODE": args.dynamo_mode,
+        "ACCELERATE_DYNAMO_USE_FULLGRAPH": str(args.dynamo_use_fullgraph),
+        "ACCELERATE_DYNAMO_USE_DYNAMIC": str(args.dynamo_use_dynamic),
+        "ACCELERATE_SAGEMAKER_DISTRIBUTED_TYPE": sagemaker_config.distributed_type.value,
+    }
+    # configure distribution set up
+    distribution = None
+    if sagemaker_config.distributed_type == SageMakerDistributedType.DATA_PARALLEL:
+        distribution = {"smdistributed": {"dataparallel": {"enabled": True}}}
+
+    # configure sagemaker inputs
+    sagemaker_inputs = None
+    if sagemaker_config.sagemaker_inputs_file is not None:
+        print(f"Loading SageMaker Inputs from {sagemaker_config.sagemaker_inputs_file} file")
+        sagemaker_inputs = {}
+        with open(sagemaker_config.sagemaker_inputs_file) as file:
+            for i, line in enumerate(file):
+                if i == 0:
+                    continue
+                l = line.split("\t")
+                sagemaker_inputs[l[0]] = l[1].strip()
+        print(f"Loaded SageMaker Inputs: {sagemaker_inputs}")
+
+    # configure sagemaker metrics
+    sagemaker_metrics = None
+    if sagemaker_config.sagemaker_metrics_file is not None:
+        print(f"Loading SageMaker Metrics from {sagemaker_config.sagemaker_metrics_file} file")
+        sagemaker_metrics = []
+        with open(sagemaker_config.sagemaker_metrics_file) as file:
+            for i, line in enumerate(file):
+                if i == 0:
+                    continue
+                l = line.split("\t")
+                metric_dict = {
+                    "Name": l[0],
+                    "Regex": l[1].strip(),
+                }
+                sagemaker_metrics.append(metric_dict)
+        print(f"Loaded SageMaker Metrics: {sagemaker_metrics}")
+
+    # configure session
+    print("Creating Estimator")
+    args = {
+        "image_uri": sagemaker_config.image_uri,
+        "entry_point": entry_point,
+        "source_dir": source_dir,
+        "role": sagemaker_config.iam_role_name,
+        "transformers_version": sagemaker_config.transformers_version,
+        "pytorch_version": sagemaker_config.pytorch_version,
+        "py_version": sagemaker_config.py_version,
+        "base_job_name": sagemaker_config.base_job_name,
+        "instance_count": sagemaker_config.num_machines,
+        "instance_type": sagemaker_config.ec2_instance_type,
+        "debugger_hook_config": False,
+        "distribution": distribution,
+        "hyperparameters": hyperparameters,
+        "environment": environment,
+        "metric_definitions": sagemaker_metrics,
+    }
+
+    if sagemaker_config.additional_args is not None:
+        args = merge_dicts(sagemaker_config.additional_args, args)
+    return args, sagemaker_inputs
+
+
+def env_var_path_add(env_var_name, path_to_add):
+    """
+    Extends a path-based environment variable's value with a new path and returns the updated value. It's up to the
+    caller to set it in os.environ.
+    """
+    paths = [p for p in os.environ.get(env_var_name, "").split(":") if len(p) > 0]
+    paths.append(str(path_to_add))
+    return ":".join(paths)
+
+
+class PrepareForLaunch:
+    """
+    Prepare a function that will launched in a distributed setup.
+
+    Args:
+        launcher (`Callable`):
+            The function to launch.
+        distributed_type ([`~state.DistributedType`]):
+            The distributed type to prepare for.
+        debug (`bool`, *optional*, defaults to `False`):
+            Whether or not this is a debug launch.
+    """
+
+    def __init__(self, launcher, distributed_type="NO", debug=False):
+        self.launcher = launcher
+        self.distributed_type = DistributedType(distributed_type)
+        self.debug = debug
+
+    def __call__(self, index, *args):
+        if self.debug:
+            world_size = int(os.environ.get("WORLD_SIZE"))
+            rdv_file = os.environ.get("ACCELERATE_DEBUG_RDV_FILE")
+            torch.distributed.init_process_group(
+                "gloo",
+                rank=index,
+                store=torch.distributed.FileStore(rdv_file, world_size),
+                world_size=world_size,
+            )
+        elif self.distributed_type in (
+            DistributedType.MULTI_GPU,
+            DistributedType.MULTI_MLU,
+            DistributedType.MULTI_NPU,
+            DistributedType.MULTI_XPU,
+            DistributedType.MULTI_CPU,
+        ):
+            # Prepare the environment for torch.distributed
+            os.environ["LOCAL_RANK"] = str(index)
+            nproc = int(os.environ.get("NPROC", 1))
+            node_rank = int(os.environ.get("NODE_RANK", 0))
+            os.environ["RANK"] = str(nproc * node_rank + index)
+
+        os.environ["FORK_LAUNCHED"] = str(1)
+        self.launcher(*args)
diff --git a/llm/Lib/site-packages/accelerate/utils/megatron_lm.py b/llm/Lib/site-packages/accelerate/utils/megatron_lm.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff1eb199307fd44cb815644e8bb34d08e2d6adb6
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/megatron_lm.py
@@ -0,0 +1,1435 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import argparse
+import math
+from abc import ABC
+from functools import partial
+
+import torch
+import torch.nn.functional as F
+from torch.nn import BCEWithLogitsLoss, CrossEntropyLoss, MSELoss
+from torch.nn.parallel.distributed import DistributedDataParallel as torchDDP
+
+from ..optimizer import AcceleratedOptimizer
+from ..scheduler import AcceleratedScheduler
+from .imports import is_megatron_lm_available, is_transformers_available
+from .operations import recursively_apply, send_to_device
+
+
+if is_transformers_available():
+    from transformers.modeling_outputs import (
+        CausalLMOutputWithCrossAttentions,
+        Seq2SeqLMOutput,
+        SequenceClassifierOutput,
+    )
+
+
+if is_megatron_lm_available():
+    from megatron import (
+        get_args,
+        get_num_microbatches,
+        get_tensorboard_writer,
+        get_timers,
+        get_tokenizer,
+        mpu,
+        print_rank_0,
+        print_rank_last,
+    )
+    from megatron.arguments import _add_data_args, _add_validation_args, parse_args, validate_args
+    from megatron.checkpointing import load_args_from_checkpoint, load_checkpoint, save_checkpoint
+    from megatron.data.data_samplers import MegatronPretrainingRandomSampler, MegatronPretrainingSampler
+    from megatron.global_vars import set_global_variables
+    from megatron.initialize import (
+        _compile_dependencies,
+        _init_autoresume,
+        _set_random_seed,
+        set_jit_fusion_options,
+        write_args_to_tensorboard,
+    )
+    from megatron.model import BertModel, Float16Module, GPTModel, ModelType, T5Model
+    from megatron.model import DistributedDataParallel as LocalDDP
+    from megatron.model.classification import Classification
+    from megatron.optimizer import get_megatron_optimizer
+    from megatron.schedules import get_forward_backward_func
+    from megatron.text_generation.communication import broadcast_int_list, broadcast_tensor
+    from megatron.text_generation.generation import (
+        beam_search_and_return_on_first_stage,
+        generate_tokens_probs_and_return_on_first_stage,
+    )
+    from megatron.tokenizer.tokenizer import _vocab_size_with_padding
+    from megatron.training import get_model, get_optimizer_param_scheduler, training_log
+    from megatron.utils import (
+        average_losses_across_data_parallel_group,
+        calc_params_l2_norm,
+        get_ltor_masks_and_position_ids,
+        unwrap_model,
+    )
+
+
+# model utilities
+def model_provider_func(pre_process=True, post_process=True, add_encoder=True, add_decoder=True):
+    """Build the model."""
+    args = get_args()
+    mode = "pre-training" if args.pretraining_flag else "fine-tuning"
+    if args.rank == 0:
+        print(f"Building {args.model_type_name} model in the {mode} mode.")
+        print(
+            "The Megatron LM model weights are initialized at random in `accelerator.prepare`. "
+            "Please use `accelerator.load_checkpoint` to load a pre-trained checkpoint matching the distributed setup."
+        )
+    if args.model_type_name == "bert":
+        if args.pretraining_flag:
+            num_tokentypes = 2 if args.bert_binary_head else 0
+            model = BertModel(
+                num_tokentypes=num_tokentypes,
+                add_binary_head=args.bert_binary_head,
+                parallel_output=True,
+                pre_process=pre_process,
+                post_process=post_process,
+            )
+        else:
+            model = Classification(
+                num_classes=args.num_labels, num_tokentypes=2, pre_process=pre_process, post_process=post_process
+            )
+    elif args.model_type_name == "gpt":
+        model = GPTModel(num_tokentypes=0, parallel_output=True, pre_process=pre_process, post_process=post_process)
+    elif args.model_type_name == "t5":
+        model = T5Model(
+            num_tokentypes=0,
+            parallel_output=True,
+            pre_process=pre_process,
+            post_process=post_process,
+            add_encoder=add_encoder,
+            add_decoder=add_decoder,
+        )
+    else:
+        raise ValueError(f"Unsupported model type: {args.model_type_name}")
+    return model
+
+
+def prepare_model(accelerator):
+    accelerator.print("Preparing model")
+    args = get_args()
+    if accelerator.state.megatron_lm_plugin.custom_prepare_model_function is not None:
+        if accelerator.state.megatron_lm_plugin.custom_model_provider_function is None:
+            raise ValueError(
+                "You must provide a `custom_model_provider_function` when using a `custom_prepare_model_function`."
+            )
+        custom_model_provider_func = accelerator.state.megatron_lm_plugin.custom_model_provider_function
+        model = accelerator.state.megatron_lm_plugin.custom_prepare_model_function(custom_model_provider_func)
+    else:
+        if args.model_type_name in ("bert", "gpt"):
+            model_type = ModelType.encoder_or_decoder
+        elif args.model_type_name == "t5":
+            model_type = ModelType.encoder_and_decoder
+            if args.pipeline_model_parallel_split_rank is None and args.pipeline_model_parallel_size > 1:
+                args.pipeline_model_parallel_split_rank = args.pipeline_model_parallel_size // 2
+        model = get_model(model_provider_func, model_type)
+    return model
+
+
+# dataloader utilities
+class MegatronLMDummyDataLoader:
+    """
+    Dummy dataloader presents model parameters or param groups, this is primarily used to follow conventional training
+
+    Args:
+        **dataset_kwargs: Megatron data arguments.
+    """
+
+    def __init__(self, **dataset_kwargs):
+        parser = argparse.ArgumentParser()
+        parser = _add_data_args(parser)
+        parser = _add_validation_args(parser)
+        data_args = parser.parse_known_args()
+        self.dataset_args = vars(data_args[0])
+        self.dataset_args.update(dataset_kwargs)
+        self.dataset_args["megatron_dataset_flag"] = True
+
+    def set_megatron_data_args(self):
+        args = get_args()
+        for key, value in self.dataset_args.items():
+            setattr(args, key, value)
+
+    def get_train_valid_test_datasets_provider(self):
+        def train_valid_test_datasets_provider(train_val_test_num_samples):
+            """Build train, valid, and test datasets."""
+            args = get_args()
+            dataset_args = {
+                "data_prefix": args.data_path,
+                "data_impl": args.data_impl,
+                "splits_string": args.split,
+                "train_valid_test_num_samples": train_val_test_num_samples,
+                "skip_warmup": (not args.mmap_warmup),
+                "seed": args.seed,
+            }
+            if args.model_type_name == "bert":
+                dataset_args.update(
+                    {
+                        "max_seq_length": args.seq_length,
+                        "masked_lm_prob": args.mask_prob,
+                        "short_seq_prob": args.short_seq_prob,
+                        "binary_head": args.bert_binary_head,
+                    }
+                )
+            elif args.model_type_name == "gpt":
+                dataset_args.update(
+                    {
+                        "seq_length": args.seq_length,
+                    }
+                )
+            elif args.model_type_name == "t5":
+                dataset_args.update(
+                    {
+                        "max_seq_length": args.encoder_seq_length,
+                        "max_seq_length_dec": args.decoder_seq_length,
+                        "masked_lm_prob": args.mask_prob,
+                        "short_seq_prob": args.short_seq_prob,
+                        "dataset_type": "t5",
+                    }
+                )
+            else:
+                raise ValueError(f"Unsupported model type: {args.model_type_name}")
+            if args.model_type_name == "gpt":
+                from megatron.data.gpt_dataset import build_train_valid_test_datasets
+            else:
+                from megatron.data.dataset_utils import build_train_valid_test_datasets
+            train_ds, valid_ds, test_ds = build_train_valid_test_datasets(**dataset_args)
+            return train_ds, valid_ds, test_ds
+
+        return train_valid_test_datasets_provider
+
+    def build_pretraining_data_loader(self, dataset, consumed_samples):
+        if dataset is None:
+            return None
+        args = get_args()
+        micro_batch_size = args.micro_batch_size * args.num_micro_batches
+
+        # Megatron sampler
+        if args.dataloader_type == "single":
+            batch_sampler = MegatronPretrainingSampler(
+                total_samples=len(dataset),
+                consumed_samples=consumed_samples,
+                micro_batch_size=micro_batch_size,
+                data_parallel_rank=mpu.get_data_parallel_rank(),
+                data_parallel_size=mpu.get_data_parallel_world_size(),
+            )
+        elif args.dataloader_type == "cyclic":
+            batch_sampler = MegatronPretrainingRandomSampler(
+                dataset,
+                total_samples=len(dataset),
+                consumed_samples=consumed_samples,
+                micro_batch_size=micro_batch_size,
+                data_parallel_rank=mpu.get_data_parallel_rank(),
+                data_parallel_size=mpu.get_data_parallel_world_size(),
+                data_sharding=args.data_sharding,
+            )
+        else:
+            raise Exception(f"{args.dataloader_type} dataloader type is not supported.")
+
+        # Torch dataloader.
+        return torch.utils.data.DataLoader(
+            dataset, batch_sampler=batch_sampler, num_workers=args.num_workers, pin_memory=True
+        )
+
+    def build_train_valid_test_data_iterators(self):
+        def cyclic_iter(iter):
+            while True:
+                yield from iter
+
+        args = get_args()
+
+        (train_dataloader, valid_dataloader, test_dataloader) = (None, None, None)
+
+        print_rank_0("> building train, validation, and test datasets ...")
+
+        # Backward compatibility, assume fixed batch size.
+        if args.iteration > 0 and args.consumed_train_samples == 0:
+            assert args.train_samples is None, "only backward compatiblity support for iteration-based training"
+            args.consumed_train_samples = args.iteration * args.global_batch_size
+        if args.iteration > 0 and args.consumed_valid_samples == 0:
+            if args.train_samples is None:
+                args.consumed_valid_samples = (
+                    (args.iteration // args.eval_interval) * args.eval_iters * args.global_batch_size
+                )
+
+        # Data loader only on rank 0 of each model parallel group.
+        if mpu.get_tensor_model_parallel_rank() == 0:
+            # Number of train/valid/test samples.
+            if args.train_samples:
+                train_samples = args.train_samples
+            else:
+                train_samples = args.train_iters * args.global_batch_size
+            eval_iters = (args.train_iters // args.eval_interval + 1) * args.eval_iters
+            test_iters = args.eval_iters
+            train_val_test_num_samples = [
+                train_samples,
+                eval_iters * args.global_batch_size,
+                test_iters * args.global_batch_size,
+            ]
+            print_rank_0(" > datasets target sizes (minimum size):")
+            print_rank_0(f"    train:      {train_val_test_num_samples[0]}")
+            print_rank_0(f"    validation: {train_val_test_num_samples[1]}")
+            print_rank_0(f"    test:       {train_val_test_num_samples[2]}")
+
+            # Build the datasets.
+            train_valid_test_datasets_provider = self.get_train_valid_test_datasets_provider()
+            train_ds, valid_ds, test_ds = train_valid_test_datasets_provider(train_val_test_num_samples)
+
+            # Build dataloders.
+            train_dataloader = self.build_pretraining_data_loader(train_ds, args.consumed_train_samples)
+            valid_dataloader = self.build_pretraining_data_loader(valid_ds, args.consumed_valid_samples)
+            test_dataloader = self.build_pretraining_data_loader(test_ds, 0)
+
+            # Flags to know if we need to do training/validation/testing.
+            do_train = train_dataloader is not None and args.train_iters > 0
+            do_valid = valid_dataloader is not None and args.eval_iters > 0
+            do_test = test_dataloader is not None and args.eval_iters > 0
+            # Need to broadcast num_tokens and num_type_tokens.
+            flags = torch.cuda.LongTensor([int(do_train), int(do_valid), int(do_test)])
+        else:
+            flags = torch.cuda.LongTensor([0, 0, 0])
+
+        # Broadcast num tokens.
+        torch.distributed.broadcast(
+            flags, mpu.get_tensor_model_parallel_src_rank(), group=mpu.get_tensor_model_parallel_group()
+        )
+        args.do_train = flags[0].item()
+        args.do_valid = flags[1].item()
+        args.do_test = flags[2].item()
+
+        # Build iterators.
+        dl_type = args.dataloader_type
+        assert dl_type in ["single", "cyclic"]
+
+        if train_dataloader is not None:
+            train_data_iterator = (
+                iter(train_dataloader) if dl_type == "single" else iter(cyclic_iter(train_dataloader))
+            )
+        else:
+            train_data_iterator = None
+
+        if valid_dataloader is not None:
+            valid_data_iterator = (
+                iter(valid_dataloader) if dl_type == "single" else iter(cyclic_iter(valid_dataloader))
+            )
+        else:
+            valid_data_iterator = None
+
+        if test_dataloader is not None:
+            test_data_iterator = iter(test_dataloader) if dl_type == "single" else iter(cyclic_iter(test_dataloader))
+        else:
+            test_data_iterator = None
+
+        return train_data_iterator, valid_data_iterator, test_data_iterator
+
+
+def prepare_data_loader(accelerator, dataloader):
+    accelerator.print("Preparing dataloader")
+    args = get_args()
+    if not args.megatron_dataset_flag:
+        from ..data_loader import _PYTORCH_DATALOADER_KWARGS, prepare_data_loader
+
+        args = get_args()
+        micro_batch_size = args.micro_batch_size * args.num_micro_batches
+        kwargs = {k: getattr(dataloader, k, _PYTORCH_DATALOADER_KWARGS[k]) for k in _PYTORCH_DATALOADER_KWARGS}
+        if kwargs["batch_size"] is None:
+            if isinstance(kwargs["sampler"], torch.utils.data.BatchSampler):
+                kwargs["sampler"].batch_size = micro_batch_size
+            else:
+                del kwargs["sampler"]
+                del kwargs["shuffle"]
+                del kwargs["batch_size"]
+                kwargs["batch_sampler"].batch_size = micro_batch_size
+        else:
+            del kwargs["batch_sampler"]
+            kwargs["batch_size"] = micro_batch_size
+
+        dataloader = torch.utils.data.DataLoader(dataloader.dataset, **kwargs)
+        return prepare_data_loader(
+            dataloader,
+            accelerator.device,
+            num_processes=mpu.get_data_parallel_world_size(),
+            process_index=mpu.get_data_parallel_rank(),
+            split_batches=accelerator.split_batches,
+            put_on_device=True,
+            rng_types=accelerator.rng_types.copy(),
+            dispatch_batches=accelerator.dispatch_batches,
+        )
+    else:
+        if args.consumed_samples is not None:
+            (
+                args.consumed_train_samples,
+                args.consumed_valid_samples,
+                args.consumed_test_samples,
+            ) = args.consumed_samples
+        else:
+            args.consumed_train_samples, args.consumed_valid_samples, args.consumed_test_samples = 0, 0, 0
+        (
+            train_data_iterator,
+            valid_data_iterator,
+            test_data_iterator,
+        ) = dataloader.build_train_valid_test_data_iterators()
+        return train_data_iterator, valid_data_iterator, test_data_iterator
+
+
+# optimizer utilities
+class MegatronLMOptimizerWrapper(AcceleratedOptimizer):
+    def __init__(self, optimizer):
+        super().__init__(optimizer, device_placement=False, scaler=None)
+
+    def zero_grad(self, set_to_none=None):
+        pass  # `model(**batch)` is doing that automatically. Therefore, it's implementation is not needed
+
+    def step(self):
+        pass  # `model(**batch)` is doing that automatically. Therefore, it's implementation is not needed
+
+    @property
+    def step_was_skipped(self):
+        """Whether or not the optimizer step was done, or skipped because of gradient overflow."""
+        return self.optimizer.skipped_iter
+
+
+def prepare_optimizer(accelerator, model):
+    accelerator.print("Preparing optimizer")
+    args = get_args()
+    optimizer = get_megatron_optimizer(model, args.no_wd_decay_cond, args.scale_lr_cond, args.lr_mult)
+    return optimizer
+
+
+# scheduler utilities
+class MegatronLMDummyScheduler:
+    """
+    Dummy scheduler presents model parameters or param groups, this is primarily used to follow conventional training
+    loop when scheduler config is specified in the deepspeed config file.
+
+    Args:
+        optimizer (`torch.optim.optimizer.Optimizer`):
+            The optimizer to wrap.
+        total_num_steps (int):
+            Total number of steps.
+        warmup_num_steps (int):
+            Number of steps for warmup.
+        **kwargs (additional keyword arguments, *optional*):
+            Other arguments.
+    """
+
+    def __init__(self, optimizer, total_num_steps=None, warmup_num_steps=0, **kwargs):
+        self.optimizer = optimizer
+        self.total_num_steps = total_num_steps
+        self.warmup_num_steps = warmup_num_steps
+        self.kwargs = kwargs
+
+
+class MegatronLMSchedulerWrapper(AcceleratedScheduler):
+    def __init__(self, scheduler, optimizers):
+        super().__init__(scheduler, optimizers)
+
+    def step(self, *args, **kwargs):
+        return  # `model(**batch)` is doing that automatically. Therefore, it's implementation is not needed
+
+
+def prepare_scheduler(accelerator, optimizer, scheduler):
+    accelerator.print("Preparing scheduler")
+    scheduler = get_optimizer_param_scheduler(optimizer)
+    return scheduler
+
+
+class AbstractTrainStep(ABC):
+    """Abstract class for batching, forward pass and loss handler."""
+
+    def __init__(self, name):
+        super().__init__()
+        self.name = name
+
+    def get_batch_func(self):
+        pass
+
+    def get_forward_step_func(self):
+        pass
+
+    def get_loss_func(self):
+        pass
+
+
+class BertTrainStep(AbstractTrainStep):
+    """
+    Bert train step class.
+
+    Args:
+        args (`argparse.Namespace`): Megatron-LM arguments.
+    """
+
+    def __init__(self, args):
+        super().__init__("BertTrainStep")
+        self.get_batch = self.get_batch_func(args.megatron_dataset_flag)
+        self.loss_func = self.get_loss_func(args.pretraining_flag, args.num_labels)
+        self.forward_step = self.get_forward_step_func(args.pretraining_flag, args.bert_binary_head)
+        if not args.model_return_dict:
+            self.model_output_class = None
+        else:
+            self.model_output_class = SequenceClassifierOutput
+
+    def get_batch_func(self, megatron_dataset_flag):
+        def get_batch_megatron(data_iterator):
+            """Build the batch."""
+
+            # Items and their type.
+            keys = ["text", "types", "labels", "is_random", "loss_mask", "padding_mask"]
+            datatype = torch.int64
+
+            # Broadcast data.
+            if data_iterator is not None:
+                data = next(data_iterator)
+            else:
+                data = None
+            data_b = mpu.broadcast_data(keys, data, datatype)
+
+            # Unpack.
+            tokens = data_b["text"].long()
+            types = data_b["types"].long()
+            sentence_order = data_b["is_random"].long()
+            loss_mask = data_b["loss_mask"].float()
+            lm_labels = data_b["labels"].long()
+            padding_mask = data_b["padding_mask"].long()
+
+            return tokens, types, sentence_order, loss_mask, lm_labels, padding_mask
+
+        def get_batch_transformer(data_iterator):
+            """Build the batch."""
+            data = next(data_iterator)
+            data = send_to_device(data, torch.cuda.current_device())
+
+            # Unpack.
+            tokens = data["input_ids"].long()
+            padding_mask = data["attention_mask"].long()
+            if "token_type_ids" in data:
+                types = data["token_type_ids"].long()
+            else:
+                types = None
+            if "labels" in data:
+                lm_labels = data["labels"].long()
+                loss_mask = (data["labels"] != -100).to(torch.float)
+            else:
+                lm_labels = None
+                loss_mask = None
+            if "next_sentence_label" in data:
+                sentence_order = data["next_sentence_label"].long()
+            else:
+                sentence_order = None
+
+            return tokens, types, sentence_order, loss_mask, lm_labels, padding_mask
+
+        if megatron_dataset_flag:
+            return get_batch_megatron
+        else:
+            return get_batch_transformer
+
+    def get_loss_func(self, pretraining_flag, num_labels):
+        def loss_func_pretrain(loss_mask, sentence_order, output_tensor):
+            lm_loss_, sop_logits = output_tensor
+
+            lm_loss_ = lm_loss_.float()
+            loss_mask = loss_mask.float()
+            lm_loss = torch.sum(lm_loss_.view(-1) * loss_mask.reshape(-1)) / loss_mask.sum()
+
+            if sop_logits is not None:
+                sop_loss = F.cross_entropy(sop_logits.view(-1, 2).float(), sentence_order.view(-1), ignore_index=-1)
+                sop_loss = sop_loss.float()
+                loss = lm_loss + sop_loss
+                averaged_losses = average_losses_across_data_parallel_group([lm_loss, sop_loss])
+                return loss, {"lm loss": averaged_losses[0], "sop loss": averaged_losses[1]}
+
+            else:
+                loss = lm_loss
+                averaged_losses = average_losses_across_data_parallel_group([lm_loss])
+                return loss, {"lm loss": averaged_losses[0]}
+
+        def loss_func_finetune(labels, logits):
+            if num_labels == 1:
+                #  We are doing regression
+                loss_fct = MSELoss()
+                loss = loss_fct(logits.view(-1), labels.view(-1))
+            elif self.num_labels > 1 and (labels.dtype in (torch.long, torch.int)):
+                loss_fct = CrossEntropyLoss()
+                loss = loss_fct(logits.view(-1, num_labels), labels.view(-1))
+            else:
+                loss_fct = BCEWithLogitsLoss()
+                loss = loss_fct(logits, labels)
+            averaged_losses = average_losses_across_data_parallel_group([loss])
+            return loss, {"loss": averaged_losses[0]}
+
+        if pretraining_flag:
+            return loss_func_pretrain
+        else:
+            return loss_func_finetune
+
+    def get_forward_step_func(self, pretraining_flag, bert_binary_head):
+        def forward_step(data_iterator, model):
+            """Forward step."""
+            tokens, types, sentence_order, loss_mask, labels, padding_mask = self.get_batch(data_iterator)
+            if not bert_binary_head:
+                types = None
+            # Forward pass through the model.
+            if pretraining_flag:
+                output_tensor = model(tokens, padding_mask, tokentype_ids=types, lm_labels=labels)
+                return output_tensor, partial(self.loss_func, loss_mask, sentence_order)
+            else:
+                logits = model(tokens, padding_mask, tokentype_ids=types)
+                return logits, partial(self.loss_func, labels)
+
+        return forward_step
+
+
+class GPTTrainStep(AbstractTrainStep):
+    """
+    GPT train step class.
+
+    Args:
+        args (`argparse.Namespace`): Megatron-LM arguments.
+    """
+
+    def __init__(self, args):
+        super().__init__("GPTTrainStep")
+        self.get_batch = self.get_batch_func(args.megatron_dataset_flag)
+        self.loss_func = self.get_loss_func()
+        self.forward_step = self.get_forward_step_func()
+        self.eod_token = args.padded_vocab_size - 1
+        if args.vocab_file is not None:
+            tokenizer = get_tokenizer()
+            self.eod_token = tokenizer.eod
+        self.reset_position_ids = args.reset_position_ids
+        self.reset_attention_mask = args.reset_attention_mask
+        self.eod_mask_loss = args.eod_mask_loss
+        if not args.model_return_dict:
+            self.model_output_class = None
+        else:
+            self.model_output_class = CausalLMOutputWithCrossAttentions
+
+    def get_batch_func(self, megatron_dataset_flag):
+        def get_batch_megatron(data_iterator):
+            """Generate a batch"""
+            # Items and their type.
+            keys = ["text"]
+            datatype = torch.int64
+
+            # Broadcast data.
+            if data_iterator is not None:
+                data = next(data_iterator)
+            else:
+                data = None
+            data_b = mpu.broadcast_data(keys, data, datatype)
+
+            # Unpack.
+            tokens_ = data_b["text"].long()
+            labels = tokens_[:, 1:].contiguous()
+            tokens = tokens_[:, :-1].contiguous()
+
+            # Get the masks and postition ids.
+            attention_mask, loss_mask, position_ids = get_ltor_masks_and_position_ids(
+                tokens, self.eod_token, self.reset_position_ids, self.reset_attention_mask, self.eod_mask_loss
+            )
+
+            return tokens, labels, loss_mask, attention_mask, position_ids
+
+        def get_batch_transformer(data_iterator):
+            data = next(data_iterator)
+            data = {"input_ids": data["input_ids"]}
+            data = send_to_device(data, torch.cuda.current_device())
+
+            tokens_ = data["input_ids"].long()
+            padding = torch.zeros((tokens_.shape[0], 1), dtype=tokens_.dtype, device=tokens_.device) + self.eod_token
+            tokens_ = torch.concat([tokens_, padding], dim=1)
+            labels = tokens_[:, 1:].contiguous()
+            tokens = tokens_[:, :-1].contiguous()
+            # Get the masks and postition ids.
+            attention_mask, loss_mask, position_ids = get_ltor_masks_and_position_ids(
+                tokens, self.eod_token, self.reset_position_ids, self.reset_attention_mask, True
+            )
+            return tokens, labels, loss_mask, attention_mask, position_ids
+
+        if megatron_dataset_flag:
+            return get_batch_megatron
+        else:
+            return get_batch_transformer
+
+    def get_loss_func(self):
+        args = get_args()
+
+        def loss_func(loss_mask, output_tensor):
+            if args.return_logits:
+                losses, logits = output_tensor
+            else:
+                losses = output_tensor
+            losses = losses.float()
+            loss_mask = loss_mask.view(-1).float()
+            loss = torch.sum(losses.view(-1) * loss_mask) / loss_mask.sum()
+
+            # Reduce loss for logging.
+            averaged_loss = average_losses_across_data_parallel_group([loss])
+
+            output_dict = {"lm loss": averaged_loss[0]}
+            if args.return_logits:
+                output_dict.update({"logits": logits})
+            return loss, output_dict
+
+        return loss_func
+
+    def get_forward_step_func(self):
+        def forward_step(data_iterator, model):
+            """Forward step."""
+            # Get the batch.
+            tokens, labels, loss_mask, attention_mask, position_ids = self.get_batch(data_iterator)
+            output_tensor = model(tokens, position_ids, attention_mask, labels=labels)
+
+            return output_tensor, partial(self.loss_func, loss_mask)
+
+        return forward_step
+
+
+class T5TrainStep(AbstractTrainStep):
+    """
+    T5 train step class.
+
+    Args:
+        args (`argparse.Namespace`): Megatron-LM arguments.
+    """
+
+    def __init__(self, args):
+        super().__init__("T5TrainStep")
+        self.get_batch = self.get_batch_func(args.megatron_dataset_flag)
+        self.loss_func = self.get_loss_func()
+        self.forward_step = self.get_forward_step_func()
+        if not args.model_return_dict:
+            self.model_output_class = None
+        else:
+            self.model_output_class = Seq2SeqLMOutput
+
+    @staticmethod
+    def attn_mask_postprocess(attention_mask):
+        # We create a 3D attention mask from a 2D tensor mask.
+        # [b, 1, s]
+        attention_mask_b1s = attention_mask.unsqueeze(1)
+        # [b, s, 1]
+        attention_mask_bs1 = attention_mask.unsqueeze(2)
+        # [b, s, s]
+        attention_mask_bss = attention_mask_b1s * attention_mask_bs1
+        # Convert attention mask to binary:
+        extended_attention_mask = attention_mask_bss < 0.5
+        return extended_attention_mask
+
+    @staticmethod
+    def get_decoder_mask(seq_length, device):
+        attention_mask = torch.tril(torch.ones((1, seq_length, seq_length), device=device))
+        attention_mask = attention_mask < 0.5
+        return attention_mask
+
+    @staticmethod
+    def get_enc_dec_mask(attention_mask, dec_seq_length, device):
+        batch_size, _ = attention_mask.shape
+        # We create a 3D attention mask from a 2D tensor mask.
+        # [b, 1, s]
+        attention_mask_b1s = attention_mask.unsqueeze(1)
+        # [b, s, 1]
+        attention_mask_bs1 = torch.ones((batch_size, dec_seq_length, 1), device=device)
+        attention_mask_bss = attention_mask_bs1 * attention_mask_b1s
+        extended_attention_mask = attention_mask_bss < 0.5
+        return extended_attention_mask
+
+    def get_batch_func(self, megatron_dataset_flag):
+        def get_batch_megatron(data_iterator):
+            """Build the batch."""
+
+            keys = ["text_enc", "text_dec", "labels", "loss_mask", "enc_mask", "dec_mask", "enc_dec_mask"]
+            datatype = torch.int64
+
+            # Broadcast data.
+            if data_iterator is not None:
+                data = next(data_iterator)
+            else:
+                data = None
+            data_b = mpu.broadcast_data(keys, data, datatype)
+
+            # Unpack.
+            tokens_enc = data_b["text_enc"].long()
+            tokens_dec = data_b["text_dec"].long()
+            labels = data_b["labels"].long()
+            loss_mask = data_b["loss_mask"].float()
+
+            enc_mask = data_b["enc_mask"] < 0.5
+            dec_mask = data_b["dec_mask"] < 0.5
+            enc_dec_mask = data_b["enc_dec_mask"] < 0.5
+
+            return tokens_enc, tokens_dec, loss_mask, labels, enc_mask, dec_mask, enc_dec_mask
+
+        def get_batch_transformer(data_iterator):
+            """Build the batch."""
+            data = next(data_iterator)
+            data = send_to_device(data, torch.cuda.current_device())
+
+            tokens_enc = data["input_ids"].long()
+            labels = data["labels"].long()
+            loss_mask = (labels != -100).to(torch.float)
+            if "decoder_input_ids" in data:
+                tokens_dec = data["decoder_input_ids"].long()
+            else:
+                tokens_dec = labels.new_zeros(labels.shape, device=labels.device, dtype=torch.long)
+                tokens_dec[..., 1:] = labels[..., :-1].clone()
+                tokens_dec[..., 0] = 0
+                tokens_dec.masked_fill_(tokens_dec == -100, 0)
+            enc_mask = T5TrainStep.attn_mask_postprocess(data["attention_mask"].long())
+            dec_mask = T5TrainStep.get_decoder_mask(tokens_dec.shape[1], tokens_dec.device)
+            enc_dec_mask = T5TrainStep.get_enc_dec_mask(
+                data["attention_mask"].long(), tokens_dec.shape[1], tokens_dec.device
+            )
+
+            return tokens_enc, tokens_dec, loss_mask, labels, enc_mask, dec_mask, enc_dec_mask
+
+        if megatron_dataset_flag:
+            return get_batch_megatron
+        else:
+            return get_batch_transformer
+
+    def get_loss_func(self):
+        def loss_func(loss_mask, output_tensor):
+            lm_loss_ = output_tensor.float()
+            lm_loss = torch.sum(lm_loss_.view(-1) * loss_mask.reshape(-1)) / loss_mask.sum()
+
+            loss = lm_loss
+            averaged_losses = average_losses_across_data_parallel_group([lm_loss])
+
+            return loss, {"lm loss": averaged_losses[0]}
+
+        return loss_func
+
+    def get_forward_step_func(self):
+        def forward_step(data_iterator, model):
+            """Forward step."""
+            # Get the batch.
+            tokens_enc, tokens_dec, loss_mask, lm_labels, enc_mask, dec_mask, enc_dec_mask = self.get_batch(
+                data_iterator
+            )
+            # Forward model lm_labels
+            output_tensor = model(
+                tokens_enc, tokens_dec, enc_mask, dec_mask, enc_dec_mask, tokentype_ids=None, lm_labels=lm_labels
+            )
+
+            return output_tensor, partial(self.loss_func, loss_mask)
+
+        return forward_step
+
+
+# intialize megatron setup
+def initialize(accelerator, extra_args_provider=None, args_defaults={}):
+    accelerator.print("Initializing Megatron-LM")
+    assert torch.cuda.is_available(), "Megatron requires CUDA."
+
+    # Parse arguments
+    args = parse_args(extra_args_provider, ignore_unknown_args=True)
+
+    # Set defaults
+    for key, value in args_defaults.items():
+        if getattr(args, key, None) is not None:
+            if args.rank == 0:
+                print(
+                    f"WARNING: overriding default arguments for " f"{key}:{getattr(args, key)} with {key}:{value}",
+                    flush=True,
+                )
+        setattr(args, key, value)
+
+    if args.use_checkpoint_args or args_defaults.get("use_checkpoint_args", False):
+        assert args.load is not None, "--use-checkpoints-args requires --load argument"
+        load_args_from_checkpoint(args)
+
+    validate_args(args)
+
+    # set global args, build tokenizer, and set adlr-autoresume,
+    # tensorboard-writer, and timers.
+    set_global_variables(args)
+
+    # torch.distributed initialization
+    def finish_mpu_init():
+        args = get_args()
+        # Pytorch distributed.
+        device_count = torch.cuda.device_count()
+        args.rank = torch.distributed.get_rank()
+        args.world_size = torch.distributed.get_world_size()
+        if device_count > 0:
+            device = args.rank % device_count
+            if args.local_rank is not None:
+                assert args.local_rank == device, "expected local-rank to be the same as rank % device-count."
+            else:
+                args.local_rank = device
+
+            # Set the tensor model-parallel, pipeline model-parallel, and
+            # data-parallel communicators.
+            if mpu.model_parallel_is_initialized():
+                print("model parallel is already initialized")
+            else:
+                mpu.initialize_model_parallel(
+                    args.tensor_model_parallel_size,
+                    args.pipeline_model_parallel_size,
+                    args.virtual_pipeline_model_parallel_size,
+                    args.pipeline_model_parallel_split_rank,
+                )
+
+        # Random seeds for reproducibility.
+        if args.rank == 0:
+            print(f"> setting random seeds to {args.seed} ...")
+        _set_random_seed(args.seed, args.data_parallel_random_init)
+
+    args = get_args()
+
+    # Megatron's MPU is the master. Complete initialization right away.
+    finish_mpu_init()
+
+    # Autoresume.
+    _init_autoresume()
+
+    # Compile dependencies.
+    _compile_dependencies()
+
+    # Set pytorch JIT layer fusion options and warmup JIT functions.
+    set_jit_fusion_options()
+    args = get_args()
+    args.padded_vocab_size = _vocab_size_with_padding(args.orig_vocab_size, args)
+    if args.model_type_name == "bert" and args.pretraining_flag and args.num_labels == 2:
+        args.bert_binary_head = True
+    else:
+        args.bert_binary_head = False
+    args.iteration = 0
+
+
+class MegatronEngine(torch.nn.Module):
+    """
+    Megatron-LM model wrapper
+
+    Args:
+        accelerator (:class:`~accelerate.Accelerator`): The accelerator object to use.
+        model: Megatron-LM model
+        optimizer: Megatron-LM optimizer
+        lr_scheduler: Megatron-LM lr scheduler
+    """
+
+    def __init__(self, accelerator, model, optimizer, scheduler):
+        super().__init__()
+        self.module = model
+        self.base_model = model[0]
+        self.optimizer = optimizer
+        self.scheduler = scheduler
+        args = get_args()
+        if accelerator.state.megatron_lm_plugin.custom_train_step_class is not None:
+            self.train_step_handler = accelerator.state.megatron_lm_plugin.custom_train_step_class(
+                args, **accelerator.state.megatron_lm_plugin.custom_train_step_kwargs
+            )
+        elif args.model_type_name == "bert":
+            self.train_step_handler = BertTrainStep(args)
+        elif args.model_type_name == "gpt":
+            self.train_step_handler = GPTTrainStep(args)
+        elif args.model_type_name == "t5":
+            self.train_step_handler = T5TrainStep(args)
+        else:
+            raise ValueError(f"Unsupported model type: {args.model_type_name}")
+        self.optimizer.skipped_iter = False
+
+        # Tracking loss.
+        self.total_loss_dict = {}
+        self.eval_total_loss_dict = {}
+        self.iteration = 0
+        self.report_memory_flag = True
+        if args.tensorboard_dir is not None:
+            write_args_to_tensorboard()
+
+    def train(self):
+        for model_module in self.module:
+            model_module.train()
+        self.log_eval_results()
+
+    def eval(self):
+        for model_module in self.module:
+            model_module.eval()
+
+    def train_step(self, **batch_data):
+        """
+        Training step for Megatron-LM
+
+        Args:
+            batch_data (:obj:`dict`): The batch data to train on.
+        """
+
+        args = get_args()
+        timers = get_timers()
+
+        if len(batch_data) > 0:
+            data_chunks = []
+            if args.num_micro_batches > 1:
+                for i in range(0, args.num_micro_batches):
+                    data_chunks.append(
+                        {
+                            k: v[i * args.micro_batch_size : (i + 1) * args.micro_batch_size]
+                            for k, v in batch_data.items()
+                        }
+                    )
+            else:
+                data_chunks = [batch_data]
+
+        if len(self.module) > 1:
+            batch_data_iterator = (
+                [iter(data_chunks) for _ in range(len(self.module))]
+                if len(batch_data) > 0
+                else [None] * len(self.module)
+            )
+        else:
+            batch_data_iterator = iter(data_chunks) if len(batch_data) > 0 else None
+
+        # Set grad to zero.
+        if args.DDP_impl == "local" and args.use_contiguous_buffers_in_local_ddp:
+            for partition in self.module:
+                partition.zero_grad_buffer()
+        self.optimizer.zero_grad()
+
+        # Forward pass.
+        forward_backward_func = get_forward_backward_func()
+        losses_reduced = forward_backward_func(
+            self.train_step_handler.forward_step,
+            batch_data_iterator,
+            self.module,
+            self.optimizer,
+            None,
+            forward_only=False,
+        )
+
+        # Empty unused memory.
+        if args.empty_unused_memory_level >= 1:
+            torch.cuda.empty_cache()
+
+        # Reduce gradients.
+        timers("backward-reduce-model-grads").start()
+        self.optimizer.reduce_model_grads(args, timers)
+        timers("backward-reduce-model-grads").stop()
+
+        # Update parameters.
+        timers("optimizer").start()
+        update_successful, grad_norm, num_zeros_in_grad = self.optimizer.step(args, timers)
+        timers("optimizer").stop()
+
+        # Gather params.
+        if update_successful:
+            timers("backward-gather-model-params").start()
+            self.optimizer.gather_model_params(args, timers)
+            timers("backward-gather-model-params").stop()
+
+        # Update learning rate.
+        if update_successful:
+            if self.scheduler is not None:
+                increment = get_num_microbatches() * args.micro_batch_size * args.data_parallel_size
+                self.scheduler.step(increment=increment)
+            skipped_iter = 0
+        else:
+            skipped_iter = 1
+
+        self.optimizer.skipped_iter = not update_successful
+
+        # Empty unused memory.
+        if args.empty_unused_memory_level >= 2:
+            torch.cuda.empty_cache()
+
+        args.consumed_train_samples += (
+            mpu.get_data_parallel_world_size() * args.micro_batch_size * get_num_microbatches()
+        )
+
+        if mpu.is_pipeline_last_stage(ignore_virtual=True):
+            # Average loss across microbatches.
+            loss_reduced = {}
+            for key in losses_reduced[0]:
+                losses_reduced_for_key = [x[key] for x in losses_reduced]
+                if len(losses_reduced_for_key[0].shape) == 0:
+                    loss_reduced[key] = sum(losses_reduced_for_key) / len(losses_reduced_for_key)
+                else:
+                    loss_reduced[key] = torch.concat(losses_reduced_for_key)
+            return loss_reduced, skipped_iter, grad_norm, num_zeros_in_grad
+        return {}, skipped_iter, grad_norm, num_zeros_in_grad
+
+    def eval_step(self, **batch_data):
+        """
+        Evaluation step for Megatron-LM
+
+        Args:
+            batch_data (:obj:`dict`): The batch data to evaluate on.
+        """
+
+        args = get_args()
+        data_chunks = []
+        if args.num_micro_batches > 1:
+            for i in range(0, args.num_micro_batches):
+                data_chunks.append(
+                    {k: v[i * args.micro_batch_size : (i + 1) * args.micro_batch_size] for k, v in batch_data.items()}
+                )
+        else:
+            data_chunks = [batch_data]
+
+        if len(self.module) > 1:
+            batch_data_iterator = [iter(data_chunks) for _ in range(len(self.module))]
+        else:
+            batch_data_iterator = iter(data_chunks)
+        forward_backward_func = get_forward_backward_func()
+        loss_dicts = forward_backward_func(
+            self.train_step_handler.forward_step,
+            batch_data_iterator,
+            self.module,
+            optimizer=None,
+            timers=None,
+            forward_only=True,
+        )
+        # Empty unused memory
+        if args.empty_unused_memory_level >= 1:
+            torch.cuda.empty_cache()
+
+        args.consumed_valid_samples += (
+            mpu.get_data_parallel_world_size() * args.micro_batch_size * get_num_microbatches()
+        )
+
+        if mpu.is_pipeline_last_stage(ignore_virtual=True):
+            # Average loss across microbatches.
+            loss_reduced = {}
+            for key in loss_dicts[0]:
+                losses_reduced_for_key = [x[key] for x in loss_dicts]
+                if len(losses_reduced_for_key[0].shape) == 0:
+                    loss_reduced[key] = sum(losses_reduced_for_key) / len(losses_reduced_for_key)
+                else:
+                    loss_reduced[key] = torch.concat(losses_reduced_for_key)
+            return loss_reduced
+        else:
+            return {}
+
+    def forward(self, **batch_data):
+        # During training, we use train_step()
+        # model(**batch_data) performs following operations by delegating it to `self.train_step`:
+        # 1. Prepare **batch_data for Tendor, Pipeline and Model Parallelism
+        # 2. Set grad to zero.
+        # 3. forward pass and backward pass using Pipeline Parallelism
+        # 4. Empty unused memory.
+        # 5. Reduce gradients.
+        # 6. Update parameters.
+        # 7. Gather params when using Distributed Optimizer (Data Parallelism).
+        # 8. Update learning rate if scheduler is specified.
+        # 9. Empty unused memory.
+        # 10. Average loss across microbatches and across DP ranks.
+        #
+        # During evaluation, we use eval_step()
+        args = get_args()
+        if self.module[0].training:
+            loss_dict, skipped_iter, grad_norm, num_zeros_in_grad = self.train_step(**batch_data)
+            self.iteration += 1
+            if args.tensorboard_dir is not None:
+                # Logging.
+                loss_scale = self.optimizer.get_loss_scale().item()
+                params_norm = None
+                if args.log_params_norm:
+                    params_norm = calc_params_l2_norm(self.model)
+                self.report_memory_flag = training_log(
+                    loss_dict,
+                    self.total_loss_dict,
+                    self.optimizer.param_groups[0]["lr"],
+                    self.iteration,
+                    loss_scale,
+                    self.report_memory_flag,
+                    skipped_iter,
+                    grad_norm,
+                    params_norm,
+                    num_zeros_in_grad,
+                )
+        else:
+            loss_dict = self.eval_step(**batch_data)
+            if args.tensorboard_dir is not None:
+                for key in loss_dict:
+                    self.eval_total_loss_dict[key] = (
+                        self.eval_total_loss_dict.get(key, torch.cuda.FloatTensor([0.0])) + loss_dict[key]
+                    )
+                    self.eval_total_loss_dict[key + "_num_iters"] = self.eval_total_loss_dict.get(
+                        key + "_num_iters", torch.cuda.FloatTensor([0.0])
+                    ) + torch.cuda.FloatTensor([1.0])
+
+        loss = torch.tensor(0.0, device=args.local_rank)
+        for key in loss_dict:
+            if len(loss_dict[key].shape) == 0:
+                loss += loss_dict[key]
+
+        logits = None
+        if "logits" in loss_dict:
+            logits = loss_dict["logits"]
+        # loss = reduce(loss)
+        if self.train_step_handler.model_output_class is not None:
+            return self.train_step_handler.model_output_class(loss=loss, logits=logits)
+        return loss
+
+    def log_eval_results(self):
+        args = get_args()
+        if args.tensorboard_dir is None or self.iteration == 0:
+            return
+        args = get_args()
+        writer = get_tensorboard_writer()
+        string = f"validation loss at iteration {self.iteration} | "
+        for key in self.eval_total_loss_dict:
+            if key.endswith("_num_iters"):
+                continue
+            value = self.eval_total_loss_dict[key] / self.eval_total_loss_dict[key + "_num_iters"]
+            string += f"{key} value: {value} | "
+            ppl = math.exp(min(20, value.item()))
+            if args.pretraining_flag:
+                string += f"{key} PPL: {ppl} | "
+            if writer:
+                writer.add_scalar(f"{key} validation", value.item(), self.iteration)
+                if args.pretraining_flag:
+                    writer.add_scalar(f"{key} validation ppl", ppl, self.iteration)
+
+        length = len(string) + 1
+        print_rank_last("-" * length)
+        print_rank_last(string)
+        print_rank_last("-" * length)
+        self.eval_total_loss_dict = {}
+
+    def save_checkpoint(self, output_dir):
+        self.log_eval_results()
+        args = get_args()
+        args.save = output_dir
+        torch.distributed.barrier()
+        save_checkpoint(self.iteration, self.module, self.optimizer, self.scheduler)
+        torch.distributed.barrier()
+
+    def load_checkpoint(self, input_dir):
+        args = get_args()
+        args.load = input_dir
+        args.consumed_train_samples = 0
+        args.consumed_valid_samples = 0
+        torch.distributed.barrier()
+        iteration = load_checkpoint(self.module, self.optimizer, self.scheduler)
+        torch.distributed.barrier()
+        self.iteration = iteration
+        if args.fp16 and self.iteration == 0:
+            self.optimizer.reload_model_params()
+
+    def megatron_generate(
+        self,
+        inputs,
+        attention_mask=None,
+        max_length=None,
+        max_new_tokens=None,
+        num_beams=None,
+        temperature=None,
+        top_k=None,
+        top_p=None,
+        length_penalty=None,
+        **kwargs,
+    ):
+        """
+        Generate method for GPT2 model. This method is used for inference. Supports both greedy and beam search along
+        with sampling. Refer the Megatron-LM repo for more details
+
+        Args:
+            inputs (torch.Tensor): input ids
+            attention_mask (torch.Tensor, optional): attention mask. Defaults to None.
+            max_length (int, optional): max length of the generated sequence. Defaults to None.
+            Either this or max_new_tokens should be provided.
+            max_new_tokens (int, optional): max number of tokens to be generated. Defaults to None.
+            Either this or max_length should be provided.
+            num_beams (int, optional): number of beams to use for beam search. Defaults to None.
+            temperature (float, optional): temperature for sampling. Defaults to 1.0.
+            top_k (int, optional): top k tokens to consider for sampling. Defaults to 0.0.
+            top_p (float, optional): tokens in top p probability are considered for sampling. Defaults to 0.0.
+            length_penalty (float, optional): length penalty for beam search. Defaults to None.
+            kwargs: additional key-value arguments
+        """
+
+        # checking if required arguments are passed
+        args = get_args()
+        if args.model_type_name != "gpt":
+            raise NotImplementedError("Generate method is not implemented for this model")
+
+        if args.data_parallel_size > 1:
+            raise ValueError("Generate method requires data parallelism to be 1")
+
+        if args.sequence_parallel:
+            raise ValueError("Generate method requires sequence parallelism to be False")
+
+        if args.recompute_granularity is not None:
+            raise ValueError("Checkpoint activations cannot be set for inference")
+
+        if args.vocab_file is None:
+            raise ValueError("Vocab file is required for inference")
+
+        # Prepare inputs
+        if max_length is None and max_new_tokens is None:
+            raise ValueError("`max_length` or `max_new_tokens` are required for inference")
+
+        if temperature is None:
+            temperature = 1.0
+        elif not (0.0 < temperature <= 100.0):
+            raise ValueError("temperature must be a positive number less than or equal to 100.0")
+
+        if top_k is None:
+            top_k = 0
+        elif not (0 <= top_k <= 1000):
+            raise ValueError("top_k must be a positive number less than or equal to 1000")
+
+        if top_p is None:
+            top_p = 0.0
+        elif top_p > 0.0 and top_k > 0.0:
+            raise ValueError("top_p and top_k sampling cannot be set together")
+        else:
+            if not (0.0 <= top_p <= 1.0):
+                raise ValueError("top_p must be less than or equal to 1.0")
+
+        top_p_decay = kwargs.get("top_p_decay", 0.0)
+        if not (0.0 <= top_p_decay <= 1.0):
+            raise ValueError("top_p_decay must be less than or equal to 1.0")
+
+        top_p_bound = kwargs.get("top_p_bound", 0.0)
+        if not (0.0 <= top_p_bound <= 1.0):
+            raise ValueError("top_p_bound must be less than or equal to 1.0")
+
+        add_BOS = kwargs.get("add_BOS", False)
+        if not (isinstance(add_BOS, bool)):
+            raise ValueError("add_BOS must be a boolean")
+
+        beam_width = num_beams
+        if beam_width is not None:
+            if not isinstance(beam_width, int):
+                raise ValueError("beam_width must be an integer")
+            if beam_width < 1:
+                raise ValueError("beam_width must be greater than 0")
+            if inputs.shape[0] > 1:
+                return "When doing beam_search, batch size must be 1"
+
+        tokenizer = get_tokenizer()
+
+        stop_token = kwargs.get("stop_token", tokenizer.eod)
+        if stop_token is not None:
+            if not isinstance(stop_token, int):
+                raise ValueError("stop_token must be an integer")
+
+        if length_penalty is None:
+            length_penalty = 1.0
+
+        sizes_list = None
+        prompts_tokens_tensor = None
+        prompts_length_tensor = None
+        if torch.distributed.get_rank() == 0:
+            # Get the prompts length.
+            if attention_mask is None:
+                prompts_length_tensor = torch.cuda.LongTensor([inputs.shape[1]] * inputs.shape[0])
+            else:
+                prompts_length_tensor = attention_mask.sum(axis=-1).cuda()
+
+            if max_new_tokens is None:
+                max_new_tokens = max_length - inputs.shape[1]
+            if max_new_tokens <= 0:
+                raise ValueError("max_new_tokens must be greater than 0")
+
+            if add_BOS:
+                max_length = max_new_tokens + inputs.shape[1] + 1
+                # making sure that `max_length` is a multiple of 4 to leverage fused kernels
+                max_length = 4 * math.ceil(max_length / 4)
+                max_new_tokens = max_length - (inputs.shape[1] + 1)
+                padding = torch.cuda.LongTensor([[tokenizer.eod] * max_new_tokens] * inputs.shape[0])
+                prompts_tokens_tensor = torch.concat(
+                    [torch.unsqueeze(padding[:, 0], axis=-1), inputs.cuda(), padding], axis=-1
+                )
+            else:
+                # making sure that `max_length` is a multiple of 4 to leverage fused kernels
+                max_length = max_new_tokens + inputs.shape[1]
+                max_length = 4 * math.ceil(max_length / 4)
+                max_new_tokens = max_length - inputs.shape[1]
+                padding = torch.cuda.LongTensor([[tokenizer.eod] * max_new_tokens] * inputs.shape[0])
+                prompts_tokens_tensor = torch.concat([inputs.cuda(), padding], axis=-1)
+
+            # We need the sizes of these tensors for the boradcast
+            sizes_list = [
+                prompts_tokens_tensor.size(0),  # Batch size
+                prompts_tokens_tensor.size(1),
+            ]  # Sequence lenght
+
+        # First, broadcast the sizes.
+        sizes_tensor = broadcast_int_list(2, int_list=sizes_list, rank=0)
+
+        # Now that we have the sizes, we can boradcast the tokens
+        # and length tensors.
+        sizes = sizes_tensor.tolist()
+        context_tokens_tensor = broadcast_tensor(sizes, torch.int64, tensor=prompts_tokens_tensor, rank=0)
+        context_length_tensor = broadcast_tensor(sizes[0], torch.int64, tensor=prompts_length_tensor, rank=0)
+
+        # Run the inference
+        random_seed = kwargs.get("random_seed", 0)
+        torch.random.manual_seed(random_seed)
+        unwrapped_model = unwrap_model(self.base_model, (torchDDP, LocalDDP, Float16Module))
+        if beam_width is not None:
+            tokens, _ = beam_search_and_return_on_first_stage(
+                unwrapped_model,
+                context_tokens_tensor,
+                context_length_tensor,
+                beam_width,
+                stop_token=stop_token,
+                num_return_gen=1,
+                length_penalty=length_penalty,
+            )
+        else:
+            tokens, _, _ = generate_tokens_probs_and_return_on_first_stage(
+                unwrapped_model,
+                context_tokens_tensor,
+                context_length_tensor,
+                return_output_log_probs=False,
+                top_k=top_k,
+                top_p=top_p,
+                top_p_decay=top_p_decay,
+                top_p_bound=top_p_bound,
+                temperature=temperature,
+                use_eod_token_for_early_termination=True,
+            )
+        return tokens
+
+
+# other utilities
+def avg_losses_across_data_parallel_group(losses):
+    """
+    Average losses across data parallel group.
+
+    Args:
+        losses (List[Tensor]): List of losses to average across data parallel group.
+    """
+
+    return average_losses_across_data_parallel_group(losses)
+
+
+def gather_across_data_parallel_groups(tensor):
+    """
+    Recursively gather tensor in a nested list/tuple/dictionary of tensors from data parallel ranks.
+
+    Args:
+        tensor (nested list/tuple/dictionary of `torch.Tensor`):
+            The data to gather across data parallel ranks.
+
+    """
+
+    def _gpu_gather_one(tensor):
+        if tensor.ndim == 0:
+            tensor = tensor.clone()[None]
+        output_tensors = [
+            torch.empty_like(tensor)
+            for _ in range(torch.distributed.get_world_size(group=mpu.get_data_parallel_group()))
+        ]
+        torch.distributed.all_gather(output_tensors, tensor, group=mpu.get_data_parallel_group())
+        return torch.cat(output_tensors, dim=0)
+
+    return recursively_apply(_gpu_gather_one, tensor, error_on_other_type=True)
diff --git a/llm/Lib/site-packages/accelerate/utils/memory.py b/llm/Lib/site-packages/accelerate/utils/memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..0141bf5f60430fa521de6cf196ac511a50790bb3
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/memory.py
@@ -0,0 +1,158 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+A collection of utilities for ensuring that training can always occur. Heavily influenced by the
+[toma](https://github.com/BlackHC/toma) library.
+"""
+
+import functools
+import gc
+import inspect
+
+import torch
+
+from .imports import is_mlu_available, is_mps_available, is_npu_available, is_xpu_available
+
+
+def release_memory(*objects):
+    """
+    Releases memory from `objects` by setting them to `None` and calls `gc.collect()` and `torch.cuda.empty_cache()`.
+    Returned objects should be reassigned to the same variables.
+
+    Args:
+        objects (`Iterable`):
+            An iterable of objects
+    Returns:
+        A list of `None` objects to replace `objects`
+
+    Example:
+
+        ```python
+        >>> import torch
+        >>> from accelerate.utils import release_memory
+
+        >>> a = torch.ones(1000, 1000).cuda()
+        >>> b = torch.ones(1000, 1000).cuda()
+        >>> a, b = release_memory(a, b)
+        ```
+    """
+    if not isinstance(objects, list):
+        objects = list(objects)
+    for i in range(len(objects)):
+        objects[i] = None
+    gc.collect()
+    if is_xpu_available():
+        torch.xpu.empty_cache()
+    elif is_mlu_available():
+        torch.mlu.empty_cache()
+    elif is_npu_available():
+        torch.npu.empty_cache()
+    elif is_mps_available():
+        torch.mps.empty_cache()
+    else:
+        torch.cuda.empty_cache()
+    return objects
+
+
+def should_reduce_batch_size(exception: Exception) -> bool:
+    """
+    Checks if `exception` relates to CUDA out-of-memory, CUDNN not supported, or CPU out-of-memory
+
+    Args:
+        exception (`Exception`):
+            An exception
+    """
+    _statements = [
+        "CUDA out of memory.",  # CUDA OOM
+        "cuDNN error: CUDNN_STATUS_NOT_SUPPORTED.",  # CUDNN SNAFU
+        "DefaultCPUAllocator: can't allocate memory",  # CPU OOM
+    ]
+    if isinstance(exception, RuntimeError) and len(exception.args) == 1:
+        return any(err in exception.args[0] for err in _statements)
+    return False
+
+
+def find_executable_batch_size(function: callable = None, starting_batch_size: int = 128):
+    """
+    A basic decorator that will try to execute `function`. If it fails from exceptions related to out-of-memory or
+    CUDNN, the batch size is cut in half and passed to `function`
+
+    `function` must take in a `batch_size` parameter as its first argument.
+
+    Args:
+        function (`callable`, *optional*):
+            A function to wrap
+        starting_batch_size (`int`, *optional*):
+            The batch size to try and fit into memory
+
+    Example:
+
+    ```python
+    >>> from accelerate.utils import find_executable_batch_size
+
+
+    >>> @find_executable_batch_size(starting_batch_size=128)
+    ... def train(batch_size, model, optimizer):
+    ...     ...
+
+
+    >>> train(model, optimizer)
+    ```
+    """
+    if function is None:
+        return functools.partial(find_executable_batch_size, starting_batch_size=starting_batch_size)
+
+    batch_size = starting_batch_size
+
+    def decorator(*args, **kwargs):
+        nonlocal batch_size
+        gc.collect()
+        if is_xpu_available():
+            torch.xpu.empty_cache()
+        elif is_mlu_available():
+            torch.mlu.empty_cache()
+        elif is_npu_available():
+            torch.npu.empty_cache()
+        else:
+            torch.cuda.empty_cache()
+        params = list(inspect.signature(function).parameters.keys())
+        # Guard against user error
+        if len(params) < (len(args) + 1):
+            arg_str = ", ".join([f"{arg}={value}" for arg, value in zip(params[1:], args[1:])])
+            raise TypeError(
+                f"Batch size was passed into `{function.__name__}` as the first argument when called."
+                f"Remove this as the decorator already does so: `{function.__name__}({arg_str})`"
+            )
+        while True:
+            if batch_size == 0:
+                raise RuntimeError("No executable batch size found, reached zero.")
+            try:
+                return function(batch_size, *args, **kwargs)
+            except Exception as e:
+                if should_reduce_batch_size(e):
+                    gc.collect()
+                    if is_xpu_available():
+                        torch.xpu.empty_cache()
+                    elif is_mlu_available():
+                        torch.mlu.empty_cache()
+                    elif is_npu_available():
+                        torch.npu.empty_cache()
+                    else:
+                        torch.cuda.empty_cache()
+                    batch_size //= 2
+                else:
+                    raise
+
+    return decorator
diff --git a/llm/Lib/site-packages/accelerate/utils/modeling.py b/llm/Lib/site-packages/accelerate/utils/modeling.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1d7f2bdf9984fd4fcfc098eddf1efe265d05464
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/modeling.py
@@ -0,0 +1,1800 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import contextlib
+import gc
+import importlib
+import inspect
+import json
+import logging
+import os
+import re
+import shutil
+import tempfile
+import warnings
+from collections import OrderedDict, defaultdict
+from typing import Dict, List, Optional, Tuple, Union
+
+import packaging
+import torch
+import torch.nn as nn
+
+from ..state import AcceleratorState
+from .constants import SAFE_WEIGHTS_NAME, WEIGHTS_NAME
+from .dataclasses import AutocastKwargs, CustomDtype, DistributedType
+from .imports import (
+    is_mlu_available,
+    is_mps_available,
+    is_npu_available,
+    is_peft_available,
+    is_torch_xla_available,
+    is_xpu_available,
+)
+from .offload import load_offloaded_weight, offload_weight, save_offload_index
+from .tqdm import is_tqdm_available, tqdm
+from .versions import compare_versions
+
+
+if is_npu_available(check_device=False):
+    import torch_npu  # noqa: F401
+
+if is_mlu_available(check_device=False):
+    import torch_mlu  # noqa: F401
+
+from safetensors import safe_open
+from safetensors.torch import load_file as safe_load_file
+
+
+WEIGHTS_INDEX_NAME = "pytorch_model.bin.index.json"
+
+logger = logging.getLogger(__name__)
+
+
+def is_peft_model(model):
+    from .other import extract_model_from_parallel
+
+    if is_peft_available():
+        from peft import PeftModel
+
+    return is_peft_available() and isinstance(extract_model_from_parallel(model), PeftModel)
+
+
+def check_device_same(first_device, second_device):
+    """
+    Utility method to check if two `torch` devices are similar. When dealing with CUDA devices, torch throws `False`
+    for `torch.device("cuda") == torch.device("cuda:0")` whereas they should be the same
+
+    Args:
+        first_device (`torch.device`):
+            First device to check
+        second_device (`torch.device`):
+            Second device to check
+    """
+    if first_device.type != second_device.type:
+        return False
+
+    if first_device.type == "cuda" and first_device.index is None:
+        # In case the first_device is a cuda device and have
+        # the index attribute set to `None`, default it to `0`
+        first_device = torch.device("cuda", index=0)
+
+    if second_device.type == "cuda" and second_device.index is None:
+        # In case the second_device is a cuda device and have
+        # the index attribute set to `None`, default it to `0`
+        second_device = torch.device("cuda", index=0)
+
+    return first_device == second_device
+
+
+def convert_file_size_to_int(size: Union[int, str]):
+    """
+    Converts a size expressed as a string with digits an unit (like `"5MB"`) to an integer (in bytes).
+
+    Args:
+        size (`int` or `str`): The size to convert. Will be directly returned if an `int`.
+
+    Example:
+
+    ```py
+    >>> convert_file_size_to_int("1MiB")
+    1048576
+    ```
+    """
+    mem_size = -1
+    err_msg = (
+        f"`size` {size} is not in a valid format. Use an integer for bytes, or a string with an unit (like '5.0GB')."
+    )
+    try:
+        if isinstance(size, int):
+            mem_size = size
+        elif size.upper().endswith("GIB"):
+            mem_size = int(float(size[:-3]) * (2**30))
+        elif size.upper().endswith("MIB"):
+            mem_size = int(float(size[:-3]) * (2**20))
+        elif size.upper().endswith("KIB"):
+            mem_size = int(float(size[:-3]) * (2**10))
+        elif size.upper().endswith("GB"):
+            int_size = int(float(size[:-2]) * (10**9))
+            mem_size = int_size // 8 if size.endswith("b") else int_size
+        elif size.upper().endswith("MB"):
+            int_size = int(float(size[:-2]) * (10**6))
+            mem_size = int_size // 8 if size.endswith("b") else int_size
+        elif size.upper().endswith("KB"):
+            int_size = int(float(size[:-2]) * (10**3))
+            mem_size = int_size // 8 if size.endswith("b") else int_size
+    except ValueError:
+        raise ValueError(err_msg)
+
+    if mem_size < 0:
+        raise ValueError(err_msg)
+    return mem_size
+
+
+def dtype_byte_size(dtype: torch.dtype):
+    """
+    Returns the size (in bytes) occupied by one parameter of type `dtype`.
+
+    Example:
+
+    ```py
+    >>> dtype_byte_size(torch.float32)
+    4
+    ```
+    """
+    if dtype == torch.bool:
+        return 1 / 8
+    elif dtype == CustomDtype.INT2:
+        return 1 / 4
+    elif dtype == CustomDtype.INT4:
+        return 1 / 2
+    elif dtype == CustomDtype.FP8:
+        return 1
+    bit_search = re.search(r"[^\d](\d+)$", str(dtype))
+    if bit_search is None:
+        raise ValueError(f"`dtype` is not a valid dtype: {dtype}.")
+    bit_size = int(bit_search.groups()[0])
+    return bit_size // 8
+
+
+def id_tensor_storage(tensor: torch.Tensor) -> Tuple[torch.device, int, int]:
+    """
+    Unique identifier to a tensor storage. Multiple different tensors can share the same underlying storage. For
+    example, "meta" tensors all share the same storage, and thus their identifier will all be equal. This identifier is
+    guaranteed to be unique and constant for this tensor's storage during its lifetime. Two tensor storages with
+    non-overlapping lifetimes may have the same id.
+    """
+    _SIZE = {
+        torch.int64: 8,
+        torch.float32: 4,
+        torch.int32: 4,
+        torch.bfloat16: 2,
+        torch.float16: 2,
+        torch.int16: 2,
+        torch.uint8: 1,
+        torch.int8: 1,
+        torch.bool: 1,
+        torch.float64: 8,
+    }
+    try:
+        storage_ptr = tensor.untyped_storage().data_ptr()
+        storage_size = tensor.untyped_storage().nbytes()
+    except Exception:
+        # Fallback for torch==1.10
+        try:
+            storage_ptr = tensor.storage().data_ptr()
+            storage_size = tensor.storage().size() * _SIZE[tensor.dtype]
+        except NotImplementedError:
+            # Fallback for meta storage
+            storage_ptr = 0
+            # On torch >=2.0 this is the tensor size
+            storage_size = tensor.nelement() * _SIZE[tensor.dtype]
+
+    return tensor.device, storage_ptr, storage_size
+
+
+def shard_checkpoint(
+    state_dict: Dict[str, torch.Tensor], max_shard_size: Union[int, str] = "10GB", weights_name: str = WEIGHTS_NAME
+):
+    """
+    Splits a model state dictionary in sub-checkpoints so that the final size of each sub-checkpoint does not exceed a
+    given size.
+
+    The sub-checkpoints are determined by iterating through the `state_dict` in the order of its keys, so there is no
+    optimization made to make each sub-checkpoint as close as possible to the maximum size passed. For example, if the
+    limit is 10GB and we have weights of sizes [6GB, 6GB, 2GB, 6GB, 2GB, 2GB] they will get sharded as [6GB], [6+2GB],
+    [6+2+2GB] and not [6+2+2GB], [6+2GB], [6GB].
+
+    <Tip warning={true}>
+
+    If one of the model's weight is bigger that `max_sahrd_size`, it will end up in its own sub-checkpoint which will
+    have a size greater than `max_shard_size`.
+
+    </Tip>
+
+    Args:
+        state_dict (`Dict[str, torch.Tensor]`): The state dictionary of a model to save.
+        max_shard_size (`int` or `str`, *optional*, defaults to `"10GB"`):
+            The maximum size of each sub-checkpoint. If expressed as a string, needs to be digits followed by a unit
+            (like `"5MB"`).
+        weights_name (`str`, *optional*, defaults to `"pytorch_model.bin"`):
+            The name of the model save file.
+    """
+    max_shard_size = convert_file_size_to_int(max_shard_size)
+
+    sharded_state_dicts = [{}]
+    last_block_size = 0
+    total_size = 0
+    storage_id_to_block = {}
+
+    for key, weight in state_dict.items():
+        # when bnb serialization is used the weights in the state dict can be strings
+        # check: https://github.com/huggingface/transformers/pull/24416 for more details
+        if isinstance(weight, str):
+            continue
+        else:
+            storage_id = id_tensor_storage(weight)
+
+        # If a `weight` shares the same underlying storage as another tensor, we put `weight` in the same `block`
+        if storage_id in storage_id_to_block:
+            block_id = storage_id_to_block[storage_id]
+            sharded_state_dicts[block_id][key] = weight
+            continue
+
+        weight_size = weight.numel() * dtype_byte_size(weight.dtype)
+
+        # If this weight is going to tip up over the maximal size, we split.
+        if last_block_size + weight_size > max_shard_size:
+            sharded_state_dicts.append({})
+            last_block_size = 0
+
+        sharded_state_dicts[-1][key] = weight
+        last_block_size += weight_size
+        total_size += weight_size
+        storage_id_to_block[storage_id] = len(sharded_state_dicts) - 1
+
+    # If we only have one shard, we return it
+    if len(sharded_state_dicts) == 1:
+        return {weights_name: sharded_state_dicts[0]}, None
+
+    # Otherwise, let's build the index
+    weight_map = {}
+    shards = {}
+    for idx, shard in enumerate(sharded_state_dicts):
+        shard_file = weights_name.replace(".bin", f"-{idx + 1:05d}-of-{len(sharded_state_dicts):05d}.bin")
+        shard_file = shard_file.replace(
+            ".safetensors", f"-{idx + 1:05d}-of-{len(sharded_state_dicts):05d}.safetensors"
+        )
+        shards[shard_file] = shard
+        for key in shard.keys():
+            weight_map[key] = shard_file
+
+    # Add the metadata
+    metadata = {"total_size": total_size}
+    index = {"metadata": metadata, "weight_map": weight_map}
+    return shards, index
+
+
+def set_module_tensor_to_device(
+    module: nn.Module,
+    tensor_name: str,
+    device: Union[int, str, torch.device],
+    value: Optional[torch.Tensor] = None,
+    dtype: Optional[Union[str, torch.dtype]] = None,
+    fp16_statistics: Optional[torch.HalfTensor] = None,
+    tied_params_map: Optional[Dict[int, Dict[torch.device, torch.Tensor]]] = None,
+):
+    """
+    A helper function to set a given tensor (parameter of buffer) of a module on a specific device (note that doing
+    `param.to(device)` creates a new tensor not linked to the parameter, which is why we need this function).
+
+    Args:
+        module (`torch.nn.Module`):
+            The module in which the tensor we want to move lives.
+        tensor_name (`str`):
+            The full name of the parameter/buffer.
+        device (`int`, `str` or `torch.device`):
+            The device on which to set the tensor.
+        value (`torch.Tensor`, *optional*):
+            The value of the tensor (useful when going from the meta device to any other device).
+        dtype (`torch.dtype`, *optional*):
+            If passed along the value of the parameter will be cast to this `dtype`. Otherwise, `value` will be cast to
+            the dtype of the existing parameter in the model.
+        fp16_statistics (`torch.HalfTensor`, *optional*):
+            The list of fp16 statistics to set on the module, used for 8 bit model serialization.
+        tied_params_map (Dict[int, Dict[torch.device, torch.Tensor]], *optional*, defaults to `None`):
+            A map of current data pointers to dictionaries of devices to already dispatched tied weights. For a given
+            execution device, this parameter is useful to reuse the first available pointer of a shared weight on the
+            device for all others, instead of duplicating memory.
+    """
+    # Recurse if needed
+    if "." in tensor_name:
+        splits = tensor_name.split(".")
+        for split in splits[:-1]:
+            new_module = getattr(module, split)
+            if new_module is None:
+                raise ValueError(f"{module} has no attribute {split}.")
+            module = new_module
+        tensor_name = splits[-1]
+
+    if tensor_name not in module._parameters and tensor_name not in module._buffers:
+        raise ValueError(f"{module} does not have a parameter or a buffer named {tensor_name}.")
+    is_buffer = tensor_name in module._buffers
+    old_value = getattr(module, tensor_name)
+
+    # Treat the case where old_value (or a custom `value`, typically offloaded to RAM/disk) belongs to a tied group, and one of the weight
+    # in the tied group has already been dispatched to the device, by avoiding reallocating memory on the device and just copying the pointer.
+    if (
+        value is not None
+        and tied_params_map is not None
+        and value.data_ptr() in tied_params_map
+        and device in tied_params_map[value.data_ptr()]
+    ):
+        module._parameters[tensor_name] = tied_params_map[value.data_ptr()][device]
+        return
+    elif (
+        tied_params_map is not None
+        and old_value.data_ptr() in tied_params_map
+        and device in tied_params_map[old_value.data_ptr()]
+    ):
+        module._parameters[tensor_name] = tied_params_map[old_value.data_ptr()][device]
+        return
+
+    if old_value.device == torch.device("meta") and device not in ["meta", torch.device("meta")] and value is None:
+        raise ValueError(f"{tensor_name} is on the meta device, we need a `value` to put in on {device}.")
+
+    if value is not None:
+        if old_value.shape != value.shape:
+            raise ValueError(
+                f'Trying to set a tensor of shape {value.shape} in "{tensor_name}" (which has shape {old_value.shape}), this look incorrect.'
+            )
+
+        if dtype is None:
+            # For compatibility with PyTorch load_state_dict which converts state dict dtype to existing dtype in model
+            value = value.to(old_value.dtype)
+        elif not str(value.dtype).startswith(("torch.uint", "torch.int", "torch.bool")):
+            value = value.to(dtype)
+
+    param = module._parameters[tensor_name] if tensor_name in module._parameters else None
+    param_cls = type(param)
+
+    device_quantization = None
+    with torch.no_grad():
+        # leave it on cpu first before moving them to cuda
+        # # fix the case where the device is meta, we don't want to put it on cpu because there is no data =0
+        if (
+            param is not None
+            and param.device.type != "cuda"
+            and torch.device(device).type == "cuda"
+            and param_cls.__name__ in ["Int8Params", "FP4Params", "Params4bit"]
+        ):
+            device_quantization = device
+            device = "cpu"
+        # `torch.Tensor.to(<int num>)` is not supported by `torch_npu` (see this [issue](https://github.com/Ascend/pytorch/issues/16)).
+        if is_npu_available() and isinstance(device, int):
+            device = f"npu:{device}"
+        elif is_mlu_available() and isinstance(device, int):
+            device = f"mlu:{device}"
+        if is_xpu_available() and isinstance(device, int):
+            device = f"xpu:{device}"
+        if value is None:
+            new_value = old_value.to(device)
+            if dtype is not None and device in ["meta", torch.device("meta")]:
+                if not str(old_value.dtype).startswith(("torch.uint", "torch.int", "torch.bool")):
+                    new_value = new_value.to(dtype)
+
+                if not is_buffer:
+                    module._parameters[tensor_name] = param_cls(new_value, requires_grad=old_value.requires_grad)
+        elif isinstance(value, torch.Tensor):
+            new_value = value.to(device)
+        else:
+            new_value = torch.tensor(value, device=device)
+        if device_quantization is not None:
+            device = device_quantization
+        if is_buffer:
+            module._buffers[tensor_name] = new_value
+        elif value is not None or not check_device_same(torch.device(device), module._parameters[tensor_name].device):
+            param_cls = type(module._parameters[tensor_name])
+            kwargs = module._parameters[tensor_name].__dict__
+            if param_cls.__name__ in ["Int8Params", "FP4Params"]:
+                if param_cls.__name__ == "Int8Params" and new_value.dtype == torch.float32:
+                    # downcast to fp16 if any - needed for 8bit serialization
+                    new_value = new_value.to(torch.float16)
+                # quantize module that are going to stay on the cpu so that we offload quantized weights
+                if device == "cpu" and param_cls.__name__ == "Int8Params":
+                    new_value = param_cls(new_value, requires_grad=old_value.requires_grad, **kwargs).to(0).to("cpu")
+                    new_value.CB = new_value.CB.to("cpu")
+                    new_value.SCB = new_value.SCB.to("cpu")
+                else:
+                    new_value = param_cls(new_value, requires_grad=old_value.requires_grad, **kwargs).to(device)
+            elif param_cls.__name__ in ["QTensor", "QBitsTensor"]:
+                new_value = torch.nn.Parameter(new_value, requires_grad=old_value.requires_grad).to(device)
+            else:
+                new_value = param_cls(new_value, requires_grad=old_value.requires_grad).to(device)
+
+            module._parameters[tensor_name] = new_value
+            if fp16_statistics is not None:
+                module._parameters[tensor_name].SCB = fp16_statistics.to(device)
+                del fp16_statistics
+            # as we put the weight to meta, it doesn't have SCB attr anymore. make sure that it is not a meta weight
+            if (
+                module.__class__.__name__ == "Linear8bitLt"
+                and getattr(module.weight, "SCB", None) is None
+                and str(module.weight.device) != "meta"
+            ):
+                # quantize only if necessary
+                device_index = torch.device(device).index if torch.device(device).type == "cuda" else None
+                if not getattr(module.weight, "SCB", None) and device_index is not None:
+                    if module.bias is not None and module.bias.device.type != "meta":
+                        # if a bias exists, we need to wait until the bias is set on the correct device
+                        module = module.cuda(device_index)
+                    elif module.bias is None:
+                        # if no bias exists, we can quantize right away
+                        module = module.cuda(device_index)
+            elif module.__class__.__name__ == "Linear4bit" and getattr(module.weight, "quant_state", None) is None:
+                # quantize only if necessary
+                device_index = torch.device(device).index if torch.device(device).type == "cuda" else None
+                if not getattr(module.weight, "quant_state", None) and device_index is not None:
+                    module.weight = module.weight.cuda(device_index)
+    # clean pre and post foward hook
+    if is_npu_available():
+        torch.npu.empty_cache()
+    elif is_mlu_available():
+        torch.mlu.empty_cache()
+    elif is_xpu_available():
+        torch.xpu.empty_cache()
+    else:
+        torch.cuda.empty_cache()
+
+    # When handling tied weights, we update tied_params_map to keep track of the tied weights that have already been allocated on the device in
+    # order to avoid duplicating memory, see above.
+    if (
+        tied_params_map is not None
+        and old_value.data_ptr() in tied_params_map
+        and device not in tied_params_map[old_value.data_ptr()]
+    ):
+        tied_params_map[old_value.data_ptr()][device] = new_value
+    elif (
+        value is not None
+        and tied_params_map is not None
+        and value.data_ptr() in tied_params_map
+        and device not in tied_params_map[value.data_ptr()]
+    ):
+        tied_params_map[value.data_ptr()][device] = new_value
+
+
+def named_module_tensors(
+    module: nn.Module, include_buffers: bool = True, recurse: bool = False, remove_non_persistent: bool = False
+):
+    """
+    A helper function that gathers all the tensors (parameters + buffers) of a given module. If `include_buffers=True`
+    it's the same as doing `module.named_parameters(recurse=recurse) + module.named_buffers(recurse=recurse)`.
+
+    Args:
+        module (`torch.nn.Module`):
+            The module we want the tensors on.
+        include_buffer (`bool`, *optional*, defaults to `True`):
+            Whether or not to include the buffers in the result.
+        recurse (`bool`, *optional`, defaults to `False`):
+            Whether or not to go look in every submodule or just return the direct parameters and buffers.
+        remove_non_persistent (`bool`, *optional*, defaults to `False`):
+            Whether or not to remove the non persistent buffer from the buffers. Useful only when include_buffers =
+            True
+    """
+    yield from module.named_parameters(recurse=recurse)
+
+    if include_buffers:
+        non_persistent_buffers = set()
+        if remove_non_persistent:
+            non_persistent_buffers = get_non_persistent_buffers(module, recurse=recurse)
+        for named_buffer in module.named_buffers(recurse=recurse):
+            name, _ = named_buffer
+            if name not in non_persistent_buffers:
+                yield named_buffer
+
+
+def get_non_persistent_buffers(module: nn.Module, recurse: bool = False):
+    """
+    Gather all non persistent buffers of a given modules into a set
+
+    Args:
+        module (`nn.Module`):
+            The module we want the non persistent buffers on.
+        recurse (`bool`, *optional*, defaults to `False`):
+            Whether or not to go look in every submodule or just return the direct non persistent buffers.
+    """
+
+    non_persistent_buffers_set = module._non_persistent_buffers_set
+    if recurse:
+        for _, m in module.named_modules():
+            non_persistent_buffers_set |= m._non_persistent_buffers_set
+
+    return non_persistent_buffers_set
+
+
+class FindTiedParametersResult(list):
+    """
+    This is a subclass of a list to handle backward compatibility for Transformers. Do not rely on the fact this is not
+    a list or on the `values` method as in the future this will be removed.
+    """
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+    def values(self):
+        # TODO: at the next Transformers release (4.28.0) issue a deprecation warning here.
+        return sum([x[1:] for x in self], [])
+
+
+def check_tied_parameters_in_config(model: nn.Module):
+    """
+    Check if there is any indication in the given model that some weights should be tied.
+
+    Args:
+        model (`torch.nn.Module`): The model to inspect
+
+    Returns:
+        bool: True if the model needs to have tied weights
+    """
+
+    # based on model.tie_weights() method
+    has_tied_word_embedding = False
+    has_tied_encoder_decoder = False
+    has_tied_module = False
+
+    if "PreTrainedModel" in [c.__name__ for c in inspect.getmro(model.__class__)]:
+        has_tied_word_embedding = (
+            hasattr(model, "config")
+            and getattr(model.config, "tie_word_embeddings", False)
+            and model.get_output_embeddings()
+        )
+        has_tied_encoder_decoder = (
+            hasattr(model, "config")
+            and getattr(model.config, "is_encoder_decoder", False)
+            and getattr(model.config, "tie_encoder_decoder", False)
+        )
+        has_tied_module = any(hasattr(module, "_tie_weights") for module in model.modules())
+
+    return any([has_tied_word_embedding, has_tied_encoder_decoder, has_tied_module])
+
+
+def _get_param_device(param, device_map):
+    if param in device_map:
+        return device_map[param]
+    parent_param = ".".join(param.split(".")[:-1])
+    if parent_param == param:
+        raise ValueError(f"The `device_map` does not contain the module {param}.")
+    else:
+        return _get_param_device(parent_param, device_map)
+
+
+def check_tied_parameters_on_same_device(tied_params, device_map):
+    """
+    Check if tied parameters are on the same device
+
+    Args:
+        tied_params (`List[List[str]]`):
+            A list of lists of parameter names being all tied together.
+
+        device_map (`Dict[str, Union[int, str, torch.device]]`):
+            A map that specifies where each submodule should go.
+
+    """
+    for tie_param in tied_params:
+        tie_param_devices = {}
+        for param in tie_param:
+            tie_param_devices[param] = _get_param_device(param, device_map)
+        if len(set(tie_param_devices.values())) > 1:
+            logger.warn(
+                f"Tied parameters are on different devices: {tie_param_devices}. "
+                "Please modify your custom device map or set `device_map='auto'`. "
+            )
+
+
+def find_tied_parameters(model: nn.Module, **kwargs):
+    """
+    Find the tied parameters in a given model.
+
+    <Tip warning={true}>
+
+    The signature accepts keyword arguments, but they are for the recursive part of this function and you should ignore
+    them.
+
+    </Tip>
+
+    Args:
+        model (`torch.nn.Module`): The model to inspect.
+
+    Returns:
+        List[List[str]]: A list of lists of parameter names being all tied together.
+
+    Example:
+
+    ```py
+    >>> from collections import OrderedDict
+    >>> import torch.nn as nn
+
+    >>> model = nn.Sequential(OrderedDict([("linear1", nn.Linear(4, 4)), ("linear2", nn.Linear(4, 4))]))
+    >>> model.linear2.weight = model.linear1.weight
+    >>> find_tied_parameters(model)
+    [['linear1.weight', 'linear2.weight']]
+    ```
+    """
+    # Initialize result and named_parameters before recursing.
+    named_parameters = kwargs.get("named_parameters", None)
+    prefix = kwargs.get("prefix", "")
+    result = kwargs.get("result", {})
+
+    if named_parameters is None:
+        named_parameters = {n: p for n, p in model.named_parameters()}
+    else:
+        # A tied parameter will not be in the full `named_parameters` seen above but will be in the `named_parameters`
+        # of the submodule it belongs to. So while recursing we track the names that are not in the initial
+        # `named_parameters`.
+        for name, parameter in model.named_parameters():
+            full_name = name if prefix == "" else f"{prefix}.{name}"
+            if full_name not in named_parameters:
+                # When we find one, it has to be one of the existing parameters.
+                for new_name, new_param in named_parameters.items():
+                    if new_param is parameter:
+                        if new_name not in result:
+                            result[new_name] = []
+                        result[new_name].append(full_name)
+
+    # Once we have treated direct parameters, we move to the child modules.
+    for name, child in model.named_children():
+        child_name = name if prefix == "" else f"{prefix}.{name}"
+        find_tied_parameters(child, named_parameters=named_parameters, prefix=child_name, result=result)
+
+    return FindTiedParametersResult([sorted([weight] + list(set(tied))) for weight, tied in result.items()])
+
+
+def retie_parameters(model, tied_params):
+    """
+    Reties tied parameters in a given model if the link was broken (for instance when adding hooks).
+
+    Args:
+        model (`torch.nn.Module`):
+            The model in which to retie parameters.
+        tied_params (`List[List[str]]`):
+            A mapping parameter name to tied parameter name as obtained by `find_tied_parameters`.
+    """
+    for tied_group in tied_params:
+        param_to_tie = None
+        # two loops : the first one to set param_to_tie , the second one to change the values of tied_group
+        for param_name in tied_group:
+            module = model
+            splits = param_name.split(".")
+            for split in splits[:-1]:
+                module = getattr(module, split)
+            param = getattr(module, splits[-1])
+            if param_to_tie is None and param.device != torch.device("meta"):
+                param_to_tie = param
+                break
+        if param_to_tie is not None:
+            for param_name in tied_group:
+                module = model
+                splits = param_name.split(".")
+                for split in splits[:-1]:
+                    module = getattr(module, split)
+                setattr(module, splits[-1], param_to_tie)
+
+
+def _get_proper_dtype(dtype: Union[str, torch.device]) -> torch.dtype:
+    """
+    Just does torch.dtype(dtype) if necessary.
+    """
+    if isinstance(dtype, str):
+        # We accept "torch.float16" or just "float16"
+        dtype = dtype.replace("torch.", "")
+        dtype = getattr(torch, dtype)
+    return dtype
+
+
+def compute_module_sizes(
+    model: nn.Module,
+    dtype: Optional[Union[str, torch.device]] = None,
+    special_dtypes: Optional[Dict[str, Union[str, torch.device]]] = None,
+    buffers_only: bool = False,
+):
+    """
+    Compute the size of each submodule of a given model.
+    """
+    if dtype is not None:
+        dtype = _get_proper_dtype(dtype)
+        dtype_size = dtype_byte_size(dtype)
+    if special_dtypes is not None:
+        special_dtypes = {key: _get_proper_dtype(dtyp) for key, dtyp in special_dtypes.items()}
+        special_dtypes_size = {key: dtype_byte_size(dtyp) for key, dtyp in special_dtypes.items()}
+    module_sizes = defaultdict(int)
+
+    module_list = []
+
+    if not buffers_only:
+        module_list = named_module_tensors(model, recurse=True)
+    else:
+        module_list = model.named_buffers(recurse=True)
+
+    for name, tensor in module_list:
+        if special_dtypes is not None and name in special_dtypes:
+            size = tensor.numel() * special_dtypes_size[name]
+        elif dtype is None:
+            size = tensor.numel() * dtype_byte_size(tensor.dtype)
+        elif str(tensor.dtype).startswith(("torch.uint", "torch.int", "torch.bool")):
+            # According to the code in set_module_tensor_to_device, these types won't be converted
+            # so use their original size here
+            size = tensor.numel() * dtype_byte_size(tensor.dtype)
+        else:
+            size = tensor.numel() * min(dtype_size, dtype_byte_size(tensor.dtype))
+        name_parts = name.split(".")
+        for idx in range(len(name_parts) + 1):
+            module_sizes[".".join(name_parts[:idx])] += size
+
+    return module_sizes
+
+
+def compute_module_total_buffer_size(
+    model: nn.Module,
+    dtype: Optional[Union[str, torch.device]] = None,
+    special_dtypes: Optional[Dict[str, Union[str, torch.device]]] = None,
+):
+    """
+    Compute the total size of buffers in each submodule of a given model.
+    """
+    module_sizes = compute_module_sizes(model, dtype=dtype, special_dtypes=special_dtypes, buffers_only=True)
+    return module_sizes.get("", 0)
+
+
+def get_max_layer_size(
+    modules: List[Tuple[str, torch.nn.Module]], module_sizes: Dict[str, int], no_split_module_classes: List[str]
+):
+    """
+    Utility function that will scan a list of named modules and return the maximum size used by one full layer. The
+    definition of a layer being:
+    - a module with no direct children (just parameters and buffers)
+    - a module whose class name is in the list `no_split_module_classes`
+
+    Args:
+        modules (`List[Tuple[str, torch.nn.Module]]`):
+            The list of named modules where we want to determine the maximum layer size.
+        module_sizes (`Dict[str, int]`):
+            A dictionary mapping each layer name to its size (as generated by `compute_module_sizes`).
+        no_split_module_classes (`List[str]`):
+            A list of class names for layers we don't want to be split.
+
+    Returns:
+        `Tuple[int, List[str]]`: The maximum size of a layer with the list of layer names realizing that maximum size.
+    """
+    max_size = 0
+    layer_names = []
+    modules_to_treat = modules.copy()
+    while len(modules_to_treat) > 0:
+        module_name, module = modules_to_treat.pop(0)
+        modules_children = list(module.named_children()) if isinstance(module, torch.nn.Module) else []
+        if len(modules_children) == 0 or module.__class__.__name__ in no_split_module_classes:
+            # No splitting this one so we compare to the max_size
+            size = module_sizes[module_name]
+            if size > max_size:
+                max_size = size
+                layer_names = [module_name]
+            elif size == max_size:
+                layer_names.append(module_name)
+        else:
+            modules_to_treat = [(f"{module_name}.{n}", v) for n, v in modules_children] + modules_to_treat
+    return max_size, layer_names
+
+
+def get_max_memory(max_memory: Optional[Dict[Union[int, str], Union[int, str]]] = None):
+    """
+    Get the maximum memory available if nothing is passed, converts string to int otherwise.
+    """
+    import psutil
+
+    if max_memory is None:
+        if not (torch.cuda.is_available() or is_npu_available() or is_mlu_available() or is_xpu_available()):
+            max_memory = {}
+
+        else:
+            # Make sure CUDA is initialized on each GPU to have the right memory info.
+            if is_npu_available():
+                for i in range(torch.npu.device_count()):
+                    _ = torch.tensor(0, device=torch.device("npu", i))
+                max_memory = {i: torch.npu.mem_get_info(i)[0] for i in range(torch.npu.device_count())}
+            elif is_mlu_available():
+                for i in range(torch.mlu.device_count()):
+                    _ = torch.tensor(0, device=torch.device("mlu", i))
+                max_memory = {i: torch.mlu.mem_get_info(i)[0] for i in range(torch.mlu.device_count())}
+            elif is_xpu_available():
+                for i in range(torch.xpu.device_count()):
+                    _ = torch.tensor(0, device=torch.device("xpu", i))
+                max_memory = {i: torch.xpu.max_memory_allocated(i) for i in range(torch.xpu.device_count())}
+            else:
+                for i in range(torch.cuda.device_count()):
+                    _ = torch.tensor([0], device=i)
+                max_memory = {i: torch.cuda.mem_get_info(i)[0] for i in range(torch.cuda.device_count())}
+        # allocate everything in the mps device as the RAM is shared
+        if is_mps_available():
+            max_memory["mps"] = psutil.virtual_memory().available
+        else:
+            max_memory["cpu"] = psutil.virtual_memory().available
+        return max_memory
+
+    for key in max_memory:
+        if isinstance(max_memory[key], str):
+            max_memory[key] = convert_file_size_to_int(max_memory[key])
+
+    # Need to sort the device by type to make sure that we allocate the gpu first.
+    # As gpu/npu/xpu are represented by int, we need to sort them first.
+    gpu_devices = [k for k in max_memory.keys() if isinstance(k, int)]
+    gpu_devices.sort()
+    # check if gpu/npu/xpu devices are available and if not, throw a warning
+    if is_npu_available():
+        num_devices = torch.npu.device_count()
+    elif is_mlu_available():
+        num_devices = torch.mlu.device_count()
+    elif is_xpu_available():
+        num_devices = torch.xpu.device_count()
+    else:
+        num_devices = torch.cuda.device_count()
+    for device in gpu_devices:
+        if device >= num_devices or device < 0:
+            logger.warning(f"Device {device} is not available, available devices are {list(range(num_devices))}")
+    # Add the other devices in the preset order if they are available
+    all_devices = gpu_devices + [k for k in ["mps", "cpu", "disk"] if k in max_memory.keys()]
+    # Raise an error if a device is not recognized
+    for k in max_memory.keys():
+        if k not in all_devices:
+            raise ValueError(
+                f"Device {k} is not recognized, available devices are integers(for GPU/XPU), 'mps', 'cpu' and 'disk'"
+            )
+    max_memory = {k: max_memory[k] for k in all_devices}
+
+    return max_memory
+
+
+def clean_device_map(device_map: Dict[str, Union[int, str, torch.device]], module_name: str = ""):
+    """
+    Cleans a device_map by grouping all submodules that go on the same device together.
+    """
+    # Get the value of the current module and if there is only one split across several keys, regroup it.
+    prefix = "" if module_name == "" else f"{module_name}."
+    values = [v for k, v in device_map.items() if k.startswith(prefix)]
+    if len(set(values)) == 1 and len(values) > 1:
+        for k in [k for k in device_map if k.startswith(prefix)]:
+            del device_map[k]
+        device_map[module_name] = values[0]
+
+    # Recurse over the children
+    children_modules = [k for k in device_map.keys() if k.startswith(prefix) and len(k) > len(module_name)]
+    idx = len(module_name.split(".")) + 1 if len(module_name) > 0 else 1
+    children_modules = set(".".join(k.split(".")[:idx]) for k in children_modules)
+    for child in children_modules:
+        clean_device_map(device_map, module_name=child)
+
+    return device_map
+
+
+def load_offloaded_weights(model, index, offload_folder):
+    """
+    Loads the weights from the offload folder into the model.
+
+    Args:
+        model (`torch.nn.Module`):
+            The model to load the weights into.
+        index (`dict`):
+            A dictionary containing the parameter name and its metadata for each parameter that was offloaded from the
+            model.
+        offload_folder (`str`):
+            The folder where the offloaded weights are stored.
+    """
+    if index is None or len(index) == 0:
+        # Nothing to do
+        return
+    for param_name, metadata in index.items():
+        if "SCB" in param_name:
+            continue
+        fp16_statistics = None
+        if "weight" in param_name and param_name.replace("weight", "SCB") in index.keys():
+            weight_name = param_name.replace("weight", "SCB")
+            fp16_statistics = load_offloaded_weight(
+                os.path.join(offload_folder, f"{weight_name}.dat"), index[weight_name]
+            )
+        tensor_file = os.path.join(offload_folder, f"{param_name}.dat")
+        weight = load_offloaded_weight(tensor_file, metadata)
+        set_module_tensor_to_device(model, param_name, "cpu", value=weight, fp16_statistics=fp16_statistics)
+
+
+def get_balanced_memory(
+    model: nn.Module,
+    max_memory: Optional[Dict[Union[int, str], Union[int, str]]] = None,
+    no_split_module_classes: Optional[List[str]] = None,
+    dtype: Optional[Union[str, torch.dtype]] = None,
+    special_dtypes: Optional[Dict[str, Union[str, torch.device]]] = None,
+    low_zero: bool = False,
+):
+    """
+    Compute a `max_memory` dictionary for [`infer_auto_device_map`] that will balance the use of each available GPU.
+
+    <Tip>
+
+    All computation is done analyzing sizes and dtypes of the model parameters. As a result, the model can be on the
+    meta device (as it would if initialized within the `init_empty_weights` context manager).
+
+    </Tip>
+
+    Args:
+        model (`torch.nn.Module`):
+            The model to analyze.
+        max_memory (`Dict`, *optional*):
+            A dictionary device identifier to maximum memory. Will default to the maximum memory available if unset.
+            Example: `max_memory={0: "1GB"}`.
+        no_split_module_classes (`List[str]`, *optional*):
+            A list of layer class names that should never be split across device (for instance any layer that has a
+            residual connection).
+        dtype (`str` or `torch.dtype`, *optional*):
+            If provided, the weights will be converted to that type when loaded.
+        special_dtypes (`Dict[str, Union[str, torch.device]]`, *optional*):
+            If provided, special dtypes to consider for some specific weights (will override dtype used as default for
+            all weights).
+        low_zero (`bool`, *optional*):
+            Minimizes the number of weights on GPU 0, which is convenient when it's used for other operations (like the
+            Transformers generate function).
+    """
+    # Get default / clean up max_memory
+    user_not_set_max_memory = max_memory is None
+    max_memory = get_max_memory(max_memory)
+
+    if is_npu_available():
+        num_devices = len([d for d in max_memory if torch.device(d).type == "npu" and max_memory[d] > 0])
+    elif is_mlu_available():
+        num_devices = len([d for d in max_memory if torch.device(d).type == "mlu" and max_memory[d] > 0])
+    elif is_xpu_available():
+        num_devices = len(
+            [
+                d
+                for d in max_memory
+                if (
+                    d != "cpu"
+                    and (torch.device(d).type == "xpu" or torch.xpu.get_device_properties(d).dev_type == "gpu")
+                )
+                and max_memory[d] > 0
+            ]
+        )
+    else:
+        num_devices = len([d for d in max_memory if torch.device(d).type == "cuda" and max_memory[d] > 0])
+
+    if num_devices == 0:
+        return max_memory
+
+    if num_devices == 1:
+        # We cannot do low_zero on just one GPU, but we will still reserve some memory for the buffer
+        low_zero = False
+        # If user just asked us to handle memory usage, we should avoid OOM
+        if user_not_set_max_memory:
+            for key in max_memory.keys():
+                if isinstance(key, int):
+                    max_memory[key] *= 0.9  # 90% is a good compromise
+                    logger.info(
+                        f"We will use 90% of the memory on device {key} for storing the model, and 10% for the buffer to avoid OOM. "
+                        "You can set `max_memory` in to a higher value to use more memory (at your own risk)."
+                    )
+                    break  # only one device
+
+    module_sizes = compute_module_sizes(model, dtype=dtype, special_dtypes=special_dtypes)
+    per_gpu = module_sizes[""] // (num_devices - 1 if low_zero else num_devices)
+
+    # We can't just set the memory to model_size // num_devices as it will end being too small: each GPU will get
+    # slightly less layers and some layers will end up offload at the end. So this function computes a buffer size to
+    # add which is the biggest of:
+    # - the size of no split block (if applicable)
+    # - the mean of the layer sizes
+    if no_split_module_classes is None:
+        no_split_module_classes = []
+    elif not isinstance(no_split_module_classes, (list, tuple)):
+        no_split_module_classes = [no_split_module_classes]
+
+    # Identify the size of the no_split_block modules
+    if len(no_split_module_classes) > 0:
+        no_split_children = {}
+        for name, size in module_sizes.items():
+            if name == "":
+                continue
+            submodule = model
+            for submodule_name in name.split("."):
+                submodule = getattr(submodule, submodule_name)
+            class_name = submodule.__class__.__name__
+            if class_name in no_split_module_classes and class_name not in no_split_children:
+                no_split_children[class_name] = size
+
+            if set(no_split_children.keys()) == set(no_split_module_classes):
+                break
+        buffer = max(no_split_children.values()) if len(no_split_children) > 0 else 0
+    else:
+        buffer = 0
+
+    # Compute mean of final modules. In the first dict of module sizes, leaves are the parameters
+    leaves = [n for n in module_sizes if len([p for p in module_sizes if n == "" or p.startswith(n + ".")]) == 0]
+    module_sizes = {n: v for n, v in module_sizes.items() if n not in leaves}
+    # Once removed, leaves are the final modules.
+    leaves = [n for n in module_sizes if len([p for p in module_sizes if n == "" or p.startswith(n + ".")]) == 0]
+    mean_leaves = int(sum([module_sizes[n] for n in leaves]) / max(len(leaves), 1))
+    buffer = int(1.25 * max(buffer, mean_leaves))
+    per_gpu += buffer
+
+    # Sorted list of GPUs id (we may have some gpu ids not included in the our max_memory list - let's ignore them)
+    gpus_idx_list = list(
+        sorted(
+            device_id for device_id, device_mem in max_memory.items() if isinstance(device_id, int) and device_mem > 0
+        )
+    )
+    # The last device is left with max_memory just in case the buffer is not enough.
+    for idx in gpus_idx_list[:-1]:
+        max_memory[idx] = min(max_memory[0] if low_zero and idx == 0 else per_gpu, max_memory[idx])
+
+    if low_zero:
+        min_zero = max(0, module_sizes[""] - sum([max_memory[i] for i in range(1, num_devices)]))
+        max_memory[0] = min(min_zero, max_memory[0])
+
+    return max_memory
+
+
+def calculate_maximum_sizes(model: torch.nn.Module):
+    "Computes the total size of the model and its largest layer"
+    sizes = compute_module_sizes(model)
+    # `transformers` models store this information for us
+    no_split_modules = getattr(model, "_no_split_modules", None)
+    if no_split_modules is None:
+        no_split_modules = []
+
+    modules_to_treat = (
+        list(model.named_parameters(recurse=False))
+        + list(model.named_children())
+        + list(model.named_buffers(recurse=False))
+    )
+    largest_layer = get_max_layer_size(modules_to_treat, sizes, no_split_modules)
+    total_size = sizes[""]
+    return total_size, largest_layer
+
+
+def infer_auto_device_map(
+    model: nn.Module,
+    max_memory: Optional[Dict[Union[int, str], Union[int, str]]] = None,
+    no_split_module_classes: Optional[List[str]] = None,
+    dtype: Optional[Union[str, torch.dtype]] = None,
+    special_dtypes: Optional[Dict[str, Union[str, torch.dtype]]] = None,
+    verbose: bool = False,
+    clean_result: bool = True,
+    offload_buffers: bool = False,
+):
+    """
+    Compute a device map for a given model giving priority to GPUs, then offload on CPU and finally offload to disk,
+    such that:
+    - we don't exceed the memory available of any of the GPU.
+    - if offload to the CPU is needed, there is always room left on GPU 0 to put back the layer offloaded on CPU that
+      has the largest size.
+    - if offload to the CPU is needed,we don't exceed the RAM available on the CPU.
+    - if offload to the disk is needed, there is always room left on the CPU to put back the layer offloaded on disk
+      that has the largest size.
+
+    <Tip>
+
+    All computation is done analyzing sizes and dtypes of the model parameters. As a result, the model can be on the
+    meta device (as it would if initialized within the `init_empty_weights` context manager).
+
+    </Tip>
+
+    Args:
+        model (`torch.nn.Module`):
+            The model to analyze.
+        max_memory (`Dict`, *optional*):
+            A dictionary device identifier to maximum memory. Will default to the maximum memory available if unset.
+            Example: `max_memory={0: "1GB"}`.
+        no_split_module_classes (`List[str]`, *optional*):
+            A list of layer class names that should never be split across device (for instance any layer that has a
+            residual connection).
+        dtype (`str` or `torch.dtype`, *optional*):
+            If provided, the weights will be converted to that type when loaded.
+        special_dtypes (`Dict[str, Union[str, torch.device]]`, *optional*):
+            If provided, special dtypes to consider for some specific weights (will override dtype used as default for
+            all weights).
+        verbose (`bool`, *optional*, defaults to `False`):
+            Whether or not to provide debugging statements as the function builds the device_map.
+        clean_result (`bool`, *optional*, defaults to `True`):
+            Clean the resulting device_map by grouping all submodules that go on the same device together.
+        offload_buffers (`bool`, *optional*, defaults to `False`):
+            In the layers that are offloaded on the CPU or the hard drive, whether or not to offload the buffers as
+            well as the parameters.
+    """
+    # Get default / clean up max_memory
+    max_memory = get_max_memory(max_memory)
+    if no_split_module_classes is None:
+        no_split_module_classes = []
+    elif not isinstance(no_split_module_classes, (list, tuple)):
+        no_split_module_classes = [no_split_module_classes]
+
+    devices = list(max_memory.keys())
+    if "disk" not in devices:
+        devices.append("disk")
+    gpus = [device for device in devices if device not in ["cpu", "disk"]]
+
+    # Devices that need to keep space for a potential offloaded layer.
+    if "mps" in gpus:
+        main_devices = ["mps"]
+    elif len(gpus) > 0:
+        main_devices = [gpus[0], "cpu"]
+    else:
+        main_devices = ["cpu"]
+
+    module_sizes = compute_module_sizes(model, dtype=dtype, special_dtypes=special_dtypes)
+    tied_parameters = find_tied_parameters(model)
+
+    if check_tied_parameters_in_config(model) and len(tied_parameters) == 0:
+        logger.warn(
+            "The model weights are not tied. Please use the `tie_weights` method before using the `infer_auto_device` function."
+        )
+
+    device_map = OrderedDict()
+    current_device = 0
+    current_memory_used = 0
+    device_memory_used = {}
+    device_buffer_sizes = {}
+
+    # Direct submodules and parameters
+    modules_to_treat = (
+        list(model.named_parameters(recurse=False))
+        + list(model.named_children())
+        + list(model.named_buffers(recurse=False))
+    )
+    # Initialize maximum largest layer, to know which space to keep in memory
+    max_layer_size, max_layer_names = get_max_layer_size(modules_to_treat, module_sizes, no_split_module_classes)
+
+    # Ready ? This is going to be a bit messy.
+    while len(modules_to_treat) > 0:
+        name, module = modules_to_treat.pop(0)
+        if verbose:
+            print(f"\nTreating module {name}.")
+        # Max size in the remaining layers may have changed since we took one, so we maybe update it.
+        max_layer_names = [n for n in max_layer_names if n != name and not n.startswith(name + ".")]
+        if len(max_layer_names) == 0:
+            max_layer_size, max_layer_names = get_max_layer_size(
+                [(n, m) for n, m in modules_to_treat if isinstance(m, torch.nn.Module)],
+                module_sizes,
+                no_split_module_classes,
+            )
+        # Assess size needed
+        module_size = module_sizes[name]
+
+        # We keep relevant tied parameters only: one of the tied parameters in the group is inside the current module
+        # and the other is not.
+        # Note: If we are currently processing the name `compute.weight`, an other parameter named e.g. `compute.weight_submodule.parameter`
+        # needs to be considered outside the current module, hence the check with additional dots.
+        tied_param_goups = [
+            tied_group
+            for tied_group in tied_parameters
+            if any(name + "." in k + "." for k in tied_group) and not all(name + "." in k + "." for k in tied_group)
+        ]
+
+        if verbose and len(tied_param_goups) > 0:
+            print(f"  Found the relevant tied param groups {tied_param_goups}")
+
+        # Then we keep track of all the parameters that are tied to the current module, but not in the current module
+        tied_params = sum(
+            [[p for p in tied_group if name + "." not in p + "."] for tied_group in tied_param_goups], []
+        )
+
+        if verbose and len(tied_params) > 0:
+            print(f"  So those parameters need to be taken into account {tied_params}")
+
+        device = devices[current_device]
+        current_max_size = max_memory[device] if device != "disk" else None
+        current_memory_reserved = 0
+        # Reduce max size available by the largest layer.
+        if devices[current_device] in main_devices:
+            current_max_size = current_max_size - max_layer_size
+            current_memory_reserved = max_layer_size
+        # Case 1 -> We're too big!
+        if current_max_size is not None and current_memory_used + module_size > current_max_size:
+            # Split or not split?
+            modules_children = (
+                []
+                if isinstance(module, nn.Parameter) or isinstance(module, torch.Tensor)
+                else list(module.named_children())
+            )
+            if verbose:
+                print(
+                    f"Not enough space on {devices[current_device]} to put {name} (space available "
+                    f"{current_max_size - current_memory_used}, module size {module_size})."
+                )
+            if len(modules_children) == 0 or module.__class__.__name__ in no_split_module_classes:
+                # -> no split, we go to the next device
+                if verbose:
+                    print("This module cannot be split, going to the next device.")
+
+                device_memory_used[device] = current_memory_used + current_memory_reserved
+                current_device += 1
+                modules_to_treat = [(name, module)] + modules_to_treat
+                current_memory_used = 0
+            else:
+                # -> split, we replace the module studied by its children + parameters
+                if verbose:
+                    print(f"Splitting {name}.")
+                modules_children = list(module.named_parameters(recurse=False)) + modules_children
+                modules_to_treat = [(f"{name}.{n}", v) for n, v in modules_children] + modules_to_treat
+                # Update the max layer size.
+                max_layer_size, max_layer_names = get_max_layer_size(
+                    [(n, m) for n, m in modules_to_treat if isinstance(m, torch.nn.Module)],
+                    module_sizes,
+                    no_split_module_classes,
+                )
+
+        # Case 2, it fits! We're not entirely out of the wood though, because we may have some tied parameters.
+        elif len(tied_params) > 0:
+            # First locate all tied modules
+            tied_module_names = []
+            tied_modules = []
+            for tied_param in tied_params:
+                tied_module_index = [i for i, (n, _) in enumerate(modules_to_treat) if n in tied_param][0]
+                tied_module_names.append(modules_to_treat[tied_module_index][0])
+                tied_modules.append(modules_to_treat[tied_module_index][1])
+            if verbose:
+                print(
+                    f"  It looks like {name} is going to fit on {devices[current_device]} but we have tied "
+                    f"parameters to account for.\n  - Names {tied_params}\n  - Module names {tied_module_names}"
+                )
+
+            # Let's see if it all fits first
+            module_size_with_ties = module_size
+            for tied_param, tied_module_name in zip(tied_params, tied_module_names):
+                module_size_with_ties += module_sizes[tied_module_name] - module_sizes[tied_param]
+
+            if current_max_size is None or current_memory_used + module_size_with_ties <= current_max_size:
+                # We really really fit!
+                if verbose:
+                    print(f"Putting {name} and {tied_module_names} on {devices[current_device]}.")
+                current_memory_used += module_size_with_ties
+                device_map[name] = devices[current_device]
+                for tied_module_name in tied_module_names:
+                    if tied_module_name in [m[0] for m in modules_to_treat]:
+                        # The module may have been removed by a previous iteration of this loop.
+                        tied_module_index = [i for i, (n, _) in enumerate(modules_to_treat) if n == tied_module_name][
+                            0
+                        ]
+                        modules_to_treat.pop(tied_module_index)
+                    device_map[tied_module_name] = devices[current_device]
+
+                if not offload_buffers and isinstance(module, nn.Module):
+                    current_buffer_size = compute_module_total_buffer_size(
+                        module, dtype=dtype, special_dtypes=special_dtypes
+                    )
+                    device_buffer_sizes[device] = device_buffer_sizes.get(device, 0) + current_buffer_size
+
+            else:
+                # We don't fit with the tied modules. Next question is: can we split one of the tied modules to make it
+                # smaller or do we need to go on the next device?
+                if verbose:
+                    print(
+                        f"Not enough space on {devices[current_device]} to put {name} and {tied_module_names} (space "
+                        f"available {current_max_size - current_memory_used}, needed size {module_size_with_ties})."
+                    )
+                split_happened = False
+                for tied_module_name, tied_module in zip(tied_module_names, tied_modules):
+                    tied_module_children = list(tied_module.named_children())
+                    if len(tied_module_children) == 0 or tied_module.__class__.__name__ in no_split_module_classes:
+                        # can't break this one.
+                        continue
+
+                    if verbose:
+                        print(f"Splitting {tied_module_name}.")
+                    tied_module_children = list(tied_module.named_parameters(recurse=False)) + tied_module_children
+                    tied_module_children = [(f"{tied_module_name}.{n}", v) for n, v in tied_module_children]
+                    tied_module_index = [i for i, (n, _) in enumerate(modules_to_treat) if n == tied_module_name][0]
+
+                    modules_to_treat = (
+                        [(name, module)]
+                        + modules_to_treat[:tied_module_index]
+                        + tied_module_children
+                        + modules_to_treat[tied_module_index + 1 :]
+                    )
+                    # Update the max layer size.
+                    max_layer_size, max_layer_names = get_max_layer_size(
+                        [(n, m) for n, m in modules_to_treat if isinstance(m, torch.nn.Module)],
+                        module_sizes,
+                        no_split_module_classes,
+                    )
+                    split_happened = True
+                    break
+
+                if not split_happened:
+                    # If the tied module is not split, we go to the next device
+                    if verbose:
+                        print("None of the tied module can be split, going to the next device.")
+
+                    device_memory_used[device] = current_memory_used + current_memory_reserved
+                    current_device += 1
+                    modules_to_treat = [(name, module)] + modules_to_treat
+                    current_memory_used = 0
+
+        else:
+            if verbose:
+                if current_max_size is None:
+                    print(f"Putting {name} (size={module_size}) on {devices[current_device]}.")
+                else:
+                    print(
+                        f"Putting {name} (size={module_size}) on {devices[current_device]} "
+                        f"(available={current_max_size - current_memory_used})."
+                    )
+            current_memory_used += module_size
+            device_memory_used[device] = current_memory_used + current_memory_reserved
+            device_map[name] = devices[current_device]
+
+            if not offload_buffers and isinstance(module, nn.Module):
+                current_buffer_size = compute_module_total_buffer_size(
+                    module, dtype=dtype, special_dtypes=special_dtypes
+                )
+                device_buffer_sizes[device] = device_buffer_sizes.get(device, 0) + current_buffer_size
+
+    if clean_result:
+        device_map = clean_device_map(device_map)
+
+    non_gpu_buffer_size = device_buffer_sizes.get("cpu", 0) + device_buffer_sizes.get("disk", 0)
+    if non_gpu_buffer_size > 0 and not offload_buffers:
+        is_buffer_fit_any_gpu = False
+        for gpu_device, gpu_max_memory in max_memory.items():
+            if gpu_device == "cpu" or gpu_device == "disk":
+                continue
+
+            if not is_buffer_fit_any_gpu:
+                gpu_memory_used = device_memory_used.get(gpu_device, 0)
+
+                if gpu_max_memory >= non_gpu_buffer_size + gpu_memory_used:
+                    is_buffer_fit_any_gpu = True
+
+        if len(gpus) > 0 and not is_buffer_fit_any_gpu:
+            warnings.warn(
+                f"Current model requires {non_gpu_buffer_size} bytes of buffer for offloaded layers, which seems does "
+                f"not fit any GPU's remaining memory. If you are experiencing a OOM later, please consider using "
+                f"offload_buffers=True."
+            )
+
+    return device_map
+
+
+def check_device_map(model: nn.Module, device_map: Dict[str, Union[int, str, torch.device]]):
+    """
+    Checks a device map covers everything in a given model.
+
+    Args:
+        model (`torch.nn.Module`): The model to check the device map against.
+        device_map (`Dict[str, Union[int, str, torch.device]]`): The device map to check.
+    """
+    all_model_tensors = [name for name, _ in model.state_dict().items()]
+    for module_name in device_map.keys():
+        if module_name == "":
+            all_model_tensors.clear()
+            break
+        else:
+            all_model_tensors = [
+                name
+                for name in all_model_tensors
+                if not name == module_name and not name.startswith(module_name + ".")
+            ]
+    if len(all_model_tensors) > 0:
+        non_covered_params = ", ".join(all_model_tensors)
+        raise ValueError(
+            f"The device_map provided does not give any device for the following parameters: {non_covered_params}"
+        )
+
+
+def load_state_dict(checkpoint_file, device_map=None):
+    """
+    Load a checkpoint from a given file. If the checkpoint is in the safetensors format and a device map is passed, the
+    weights can be fast-loaded directly on the GPU.
+
+    Args:
+        checkpoint_file (`str`): The path to the checkpoint to load.
+        device_map (`Dict[str, Union[int, str, torch.device]]`, *optional*):
+            A map that specifies where each submodule should go. It doesn't need to be refined to each parameter/buffer
+            name, once a given module name is inside, every submodule of it will be sent to the same device.
+    """
+    if checkpoint_file.endswith(".safetensors"):
+        with safe_open(checkpoint_file, framework="pt") as f:
+            metadata = f.metadata()
+            weight_names = f.keys()
+
+        if metadata is None:
+            logger.warn(
+                f"The safetensors archive passed at {checkpoint_file} does not contain metadata. "
+                "Make sure to save your model with the `save_pretrained` method. Defaulting to 'pt' metadata."
+            )
+            metadata = {"format": "pt"}
+
+        if metadata.get("format") not in ["pt", "tf", "flax"]:
+            raise OSError(
+                f"The safetensors archive passed at {checkpoint_file} does not contain the valid metadata. Make sure "
+                "you save your model with the `save_pretrained` method."
+            )
+        elif metadata["format"] != "pt":
+            raise ValueError(f"The checkpoint passed was saved with {metadata['format']}, we need a the pt format.")
+        if device_map is None:
+            return safe_load_file(checkpoint_file)
+        else:
+            # if we only have one device we can load everything directly
+            if len(set(device_map.values())) == 1:
+                return safe_load_file(checkpoint_file, device=list(device_map.values())[0])
+
+            devices = list(set(device_map.values()) - {"disk"})
+            # cpu device should always exist as fallback option
+            if "cpu" not in devices:
+                devices.append("cpu")
+
+            # For each device, get the weights that go there
+            device_weights = {device: [] for device in devices}
+            for module_name, device in device_map.items():
+                if device in devices:
+                    device_weights[device].extend(
+                        [k for k in weight_names if k == module_name or k.startswith(module_name + ".")]
+                    )
+
+            # all weights that haven't defined a device should be loaded on CPU
+            device_weights["cpu"].extend([k for k in weight_names if k not in sum(device_weights.values(), [])])
+            tensors = {}
+            if is_tqdm_available():
+                progress_bar = tqdm(
+                    main_process_only=False,
+                    total=sum([len(device_weights[device]) for device in devices]),
+                    unit="w",
+                    smoothing=0,
+                    leave=False,
+                )
+            else:
+                progress_bar = None
+            for device in devices:
+                target_device = device
+
+                if is_xpu_available():
+                    current_safetensors_version = packaging.version.parse(importlib.metadata.version("safetensors"))
+
+                    if compare_versions(current_safetensors_version, "<", "0.4.2"):
+                        raise ModuleNotFoundError(
+                            f"You need at least safetensors 0.4.2 for Intel GPU, while you have {current_safetensors_version}"
+                        )
+
+                    if isinstance(device, int):
+                        target_device = f"xpu:{device}"
+
+                with safe_open(checkpoint_file, framework="pt", device=target_device) as f:
+                    for key in device_weights[device]:
+                        if progress_bar is not None:
+                            progress_bar.set_postfix(dev=device, refresh=False)
+                            progress_bar.set_description(key)
+                        tensors[key] = f.get_tensor(key)
+                        if progress_bar is not None:
+                            progress_bar.update()
+            if progress_bar is not None:
+                progress_bar.close()
+
+            return tensors
+    else:
+        return torch.load(checkpoint_file, map_location=torch.device("cpu"))
+
+
+def get_state_dict_offloaded_model(model: nn.Module):
+    """
+    Returns the state dictionary for an offloaded model via iterative onloading
+
+    Args:
+        model (`torch.nn.Module`):
+            The offloaded model we want to save
+    """
+    from ..hooks import AlignDevicesHook
+
+    state_dict = {}
+    placeholders = set()
+    for name, module in model.named_modules():
+        if name == "":
+            continue
+        if hasattr(module, "_hf_hook") and isinstance(module._hf_hook, AlignDevicesHook) and module._hf_hook.offload:
+            original_device = module._hf_hook.execution_device
+            # assign hook execution device to cpu
+            module._hf_hook.execution_device = "cpu"
+            # onload meta tensors to execution device
+            try:
+                module._hf_hook.pre_forward(module)
+            except MemoryError:
+                raise MemoryError("Offloaded module must fit in CPU memory to call save_model!") from None
+            module_state_dict = module.state_dict()
+            # offload meta tensors from cpu
+            module._hf_hook.post_forward(module, torch.tensor([]))
+            # re-assign hook to original execution device
+            module._hf_hook.execution_device = original_device
+        else:
+            module_state_dict = module.state_dict()
+
+        for key in module_state_dict:
+            # ignore placeholder parameters that are still on the meta device
+            if module_state_dict[key].device == torch.device("meta"):
+                placeholders.add(name + f".{key}")
+                continue
+            params = module_state_dict[key]
+            state_dict[name + f".{key}"] = params
+    for key in placeholders.copy():
+        if key in state_dict:
+            placeholders.remove(key)
+    if placeholders:
+        logger.warning(f"The following tensors were not saved because they were still on meta device: {placeholders}")
+
+    return state_dict
+
+
+def load_checkpoint_in_model(
+    model: nn.Module,
+    checkpoint: Union[str, os.PathLike],
+    device_map: Optional[Dict[str, Union[int, str, torch.device]]] = None,
+    offload_folder: Optional[Union[str, os.PathLike]] = None,
+    dtype: Optional[Union[str, torch.dtype]] = None,
+    offload_state_dict: bool = False,
+    offload_buffers: bool = False,
+    keep_in_fp32_modules: List[str] = None,
+    offload_8bit_bnb: bool = False,
+    strict: bool = False,
+):
+    """
+    Loads a (potentially sharded) checkpoint inside a model, potentially sending weights to a given device as they are
+    loaded.
+
+    <Tip warning={true}>
+
+    Once loaded across devices, you still need to call [`dispatch_model`] on your model to make it able to run. To
+    group the checkpoint loading and dispatch in one single call, use [`load_checkpoint_and_dispatch`].
+
+    </Tip>
+
+    Args:
+        model (`torch.nn.Module`):
+            The model in which we want to load a checkpoint.
+        checkpoint (`str` or `os.PathLike`):
+            The folder checkpoint to load. It can be:
+            - a path to a file containing a whole model state dict
+            - a path to a `.json` file containing the index to a sharded checkpoint
+            - a path to a folder containing a unique `.index.json` file and the shards of a checkpoint.
+            - a path to a folder containing a unique pytorch_model.bin or a model.safetensors file.
+        device_map (`Dict[str, Union[int, str, torch.device]]`, *optional*):
+            A map that specifies where each submodule should go. It doesn't need to be refined to each parameter/buffer
+            name, once a given module name is inside, every submodule of it will be sent to the same device.
+        offload_folder (`str` or `os.PathLike`, *optional*):
+            If the `device_map` contains any value `"disk"`, the folder where we will offload weights.
+        dtype (`str` or `torch.dtype`, *optional*):
+            If provided, the weights will be converted to that type when loaded.
+        offload_state_dict (`bool`, *optional*, defaults to `False`):
+            If `True`, will temporarily offload the CPU state dict on the hard drive to avoid getting out of CPU RAM if
+            the weight of the CPU state dict + the biggest shard does not fit.
+        offload_buffers (`bool`, *optional*, defaults to `False`):
+            Whether or not to include the buffers in the weights offloaded to disk.
+        keep_in_fp32_modules(`List[str]`, *optional*):
+            A list of the modules that we keep in `torch.float32` dtype.
+        offload_8bit_bnb (`bool`, *optional*):
+            Whether or not to enable offload of 8-bit modules on cpu/disk.
+        strict (`bool`, *optional*, defaults to `False`):
+            Whether to strictly enforce that the keys in the checkpoint state_dict match the keys of the model's
+            state_dict.
+
+    """
+    if offload_8bit_bnb:
+        from .bnb import quantize_and_offload_8bit
+
+    tied_params = find_tied_parameters(model)
+
+    if check_tied_parameters_in_config(model) and len(tied_params) == 0:
+        logger.warn(
+            "The model weights are not tied. Please use the `tie_weights` method before using the `infer_auto_device` function."
+        )
+    if device_map is not None:
+        check_tied_parameters_on_same_device(tied_params, device_map)
+
+    if offload_folder is None and device_map is not None and "disk" in device_map.values():
+        raise ValueError(
+            "At least one of the model submodule will be offloaded to disk, please pass along an `offload_folder`."
+        )
+    elif offload_folder is not None and device_map is not None and "disk" in device_map.values():
+        os.makedirs(offload_folder, exist_ok=True)
+
+    if isinstance(dtype, str):
+        # We accept "torch.float16" or just "float16"
+        dtype = dtype.replace("torch.", "")
+        dtype = getattr(torch, dtype)
+
+    checkpoint_files = None
+    index_filename = None
+    if os.path.isfile(checkpoint):
+        if str(checkpoint).endswith(".json"):
+            index_filename = checkpoint
+        else:
+            checkpoint_files = [checkpoint]
+    elif os.path.isdir(checkpoint):
+        # check if the whole state dict is present
+        potential_state_bin = [f for f in os.listdir(checkpoint) if f == WEIGHTS_NAME]
+        potential_state_safetensor = [f for f in os.listdir(checkpoint) if f == SAFE_WEIGHTS_NAME]
+        if len(potential_state_bin) == 1:
+            checkpoint_files = [os.path.join(checkpoint, potential_state_bin[0])]
+        elif len(potential_state_safetensor) == 1:
+            checkpoint_files = [os.path.join(checkpoint, potential_state_safetensor[0])]
+        else:
+            # otherwise check for sharded checkpoints
+            potential_index = [f for f in os.listdir(checkpoint) if f.endswith(".index.json")]
+            if len(potential_index) == 0:
+                raise ValueError(
+                    f"{checkpoint} is not a folder containing a `.index.json` file or a {WEIGHTS_NAME} or a {SAFE_WEIGHTS_NAME} file"
+                )
+            elif len(potential_index) == 1:
+                index_filename = os.path.join(checkpoint, potential_index[0])
+            else:
+                raise ValueError(
+                    f"{checkpoint} containing more than one `.index.json` file, delete the irrelevant ones."
+                )
+    else:
+        raise ValueError(
+            "`checkpoint` should be the path to a file containing a whole state dict, or the index of a sharded "
+            f"checkpoint, or a folder containing a sharded checkpoint or the whole state dict, but got {checkpoint}."
+        )
+
+    if index_filename is not None:
+        checkpoint_folder = os.path.split(index_filename)[0]
+        with open(index_filename) as f:
+            index = json.loads(f.read())
+
+        if "weight_map" in index:
+            index = index["weight_map"]
+        checkpoint_files = sorted(list(set(index.values())))
+        checkpoint_files = [os.path.join(checkpoint_folder, f) for f in checkpoint_files]
+
+    # Logic for missing/unexepected keys goes here.
+
+    offload_index = {}
+    if offload_state_dict:
+        state_dict_folder = tempfile.mkdtemp()
+        state_dict_index = {}
+
+    unexpected_keys = set()
+    model_keys = set(model.state_dict().keys())
+    buffer_names = [name for name, _ in model.named_buffers()]
+    for checkpoint_file in checkpoint_files:
+        loaded_checkpoint = load_state_dict(checkpoint_file, device_map=device_map)
+        if device_map is None:
+            model.load_state_dict(loaded_checkpoint, strict=strict)
+            unexpected_keys.update(set(loaded_checkpoint.keys()) - model_keys)
+        else:
+            for param_name, param in loaded_checkpoint.items():
+                # skip SCB parameter (for 8-bit serialization)
+                if "SCB" in param_name:
+                    continue
+
+                if param_name not in model_keys:
+                    unexpected_keys.add(param_name)
+                    if not strict:
+                        continue  # Skip loading this parameter.
+
+                module_name = param_name
+
+                while len(module_name) > 0 and module_name not in device_map:
+                    module_name = ".".join(module_name.split(".")[:-1])
+                if module_name == "" and "" not in device_map:
+                    # TODO: group all errors and raise at the end.
+                    raise ValueError(f"{param_name} doesn't have any device set.")
+                param_device = device_map[module_name]
+                new_dtype = dtype
+                if dtype is not None and torch.is_floating_point(param):
+                    if keep_in_fp32_modules is not None and dtype == torch.float16:
+                        proceed = False
+                        for key in keep_in_fp32_modules:
+                            if ((key in param_name) and (key + "." in param_name)) or key == param_name:
+                                proceed = True
+                                break
+                        if proceed:
+                            new_dtype = torch.float32
+
+                if "weight" in param_name and param_name.replace("weight", "SCB") in loaded_checkpoint.keys():
+                    if param.dtype == torch.int8:
+                        fp16_statistics = loaded_checkpoint[param_name.replace("weight", "SCB")]
+                else:
+                    fp16_statistics = None
+
+                if param_device == "disk":
+                    if offload_buffers or param_name not in buffer_names:
+                        if new_dtype is None:
+                            new_dtype = param.dtype
+                        if offload_8bit_bnb:
+                            quantize_and_offload_8bit(
+                                model, param, param_name, new_dtype, offload_folder, offload_index, fp16_statistics
+                            )
+                            continue
+                        else:
+                            set_module_tensor_to_device(model, param_name, "meta", dtype=new_dtype)
+                        offload_weight(param, param_name, offload_folder, index=offload_index)
+                elif param_device == "cpu" and offload_state_dict:
+                    if new_dtype is None:
+                        new_dtype = param.dtype
+                    if offload_8bit_bnb:
+                        quantize_and_offload_8bit(
+                            model, param, param_name, new_dtype, state_dict_folder, state_dict_index, fp16_statistics
+                        )
+                    else:
+                        set_module_tensor_to_device(model, param_name, "meta", dtype=new_dtype)
+                        offload_weight(param, param_name, state_dict_folder, index=state_dict_index)
+                else:
+                    set_module_tensor_to_device(
+                        model,
+                        param_name,
+                        param_device,
+                        value=param,
+                        dtype=new_dtype,
+                        fp16_statistics=fp16_statistics,
+                    )
+
+        # Force Python to clean up.
+        del loaded_checkpoint
+        gc.collect()
+
+    if not strict and len(unexpected_keys) > 0:
+        logger.warning(
+            f"Some weights of the model checkpoint at {checkpoint} were not used when"
+            f" initializing {model.__class__.__name__}: {unexpected_keys}. This may or may not be an issue - make sure that the checkpoint does not have unnecessary parameters, or that the model definition correctly corresponds to the checkpoint."
+        )
+
+    save_offload_index(offload_index, offload_folder)
+
+    # Load back offloaded state dict on CPU
+    if offload_state_dict:
+        load_offloaded_weights(model, state_dict_index, state_dict_folder)
+        shutil.rmtree(state_dict_folder)
+
+    retie_parameters(model, tied_params)
+
+
+def get_mixed_precision_context_manager(native_amp: bool = False, autocast_kwargs: AutocastKwargs = None):
+    """
+    Return a context manager for autocasting mixed precision
+
+    Args:
+        native_amp (`bool`, *optional*, defaults to False):
+            Whether mixed precision is actually enabled.
+        cache_enabled (`bool`, *optional*, defaults to True):
+            Whether the weight cache inside autocast should be enabled.
+    """
+    state = AcceleratorState()
+    if autocast_kwargs is None:
+        autocast_kwargs = {}
+    else:
+        autocast_kwargs = autocast_kwargs.to_kwargs()
+    if native_amp:
+        device_type = (
+            "cuda"
+            if (state.distributed_type == DistributedType.XLA and is_torch_xla_available(check_is_gpu=True))
+            else state.device.type
+        )
+        if state.mixed_precision == "fp16":
+            return torch.autocast(device_type=device_type, dtype=torch.float16, **autocast_kwargs)
+        elif state.mixed_precision == "bf16" and state.distributed_type in [
+            DistributedType.NO,
+            DistributedType.MULTI_CPU,
+            DistributedType.MULTI_GPU,
+            DistributedType.MULTI_MLU,
+            DistributedType.MULTI_NPU,
+            DistributedType.MULTI_XPU,
+            DistributedType.FSDP,
+            DistributedType.XLA,
+        ]:
+            return torch.autocast(device_type=device_type, dtype=torch.bfloat16, **autocast_kwargs)
+        else:
+            return torch.autocast(device_type=device_type, **autocast_kwargs)
+    else:
+        return contextlib.nullcontext()
diff --git a/llm/Lib/site-packages/accelerate/utils/offload.py b/llm/Lib/site-packages/accelerate/utils/offload.py
new file mode 100644
index 0000000000000000000000000000000000000000..d064847ca21bde644b443de315b239414aa2fd51
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/offload.py
@@ -0,0 +1,213 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import os
+from collections.abc import Mapping
+from typing import Dict, List, Optional, Union
+
+import numpy as np
+import torch
+from safetensors import safe_open
+
+
+def offload_weight(weight, weight_name, offload_folder, index=None):
+    dtype = None
+    # Check the string instead of the dtype to be compatible with versions of PyTorch that don't have bfloat16.
+    if str(weight.dtype) == "torch.bfloat16":
+        # Need to reinterpret the underlined data as int16 since NumPy does not handle bfloat16s.
+        weight = weight.view(torch.int16)
+        dtype = "bfloat16"
+    array = weight.cpu().numpy()
+    tensor_file = os.path.join(offload_folder, f"{weight_name}.dat")
+    if index is not None:
+        if dtype is None:
+            dtype = str(array.dtype)
+        index[weight_name] = {"dtype": dtype, "shape": list(array.shape)}
+    if array.ndim == 0:
+        array = array[None]
+    file_array = np.memmap(tensor_file, dtype=array.dtype, mode="w+", shape=array.shape)
+    file_array[:] = array[:]
+    file_array.flush()
+    return index
+
+
+def load_offloaded_weight(weight_file, weight_info):
+    shape = tuple(weight_info["shape"])
+    if shape == ():
+        # NumPy memory-mapped arrays can't have 0 dims so it was saved as 1d tensor
+        shape = (1,)
+
+    dtype = weight_info["dtype"]
+    if dtype == "bfloat16":
+        # NumPy does not support bfloat16 so this was saved as a int16
+        dtype = "int16"
+
+    weight = np.memmap(weight_file, dtype=dtype, shape=shape, mode="r")
+
+    if len(weight_info["shape"]) == 0:
+        weight = weight[0]
+    weight = torch.tensor(weight)
+    if weight_info["dtype"] == "bfloat16":
+        weight = weight.view(torch.bfloat16)
+
+    return weight
+
+
+def save_offload_index(index, offload_folder):
+    if index is None or len(index) == 0:
+        # Nothing to save
+        return
+
+    offload_index_file = os.path.join(offload_folder, "index.json")
+    if os.path.isfile(offload_index_file):
+        with open(offload_index_file, encoding="utf-8") as f:
+            current_index = json.load(f)
+    else:
+        current_index = {}
+    current_index.update(index)
+
+    with open(offload_index_file, "w", encoding="utf-8") as f:
+        json.dump(current_index, f, indent=2)
+
+
+def offload_state_dict(save_dir: Union[str, os.PathLike], state_dict: Dict[str, torch.Tensor]):
+    """
+    Offload a state dict in a given folder.
+
+    Args:
+        save_dir (`str` or `os.PathLike`):
+            The directory in which to offload the state dict.
+        state_dict (`Dict[str, torch.Tensor]`):
+            The dictionary of tensors to offload.
+    """
+    os.makedirs(save_dir, exist_ok=True)
+    index = {}
+    for name, parameter in state_dict.items():
+        index = offload_weight(parameter, name, save_dir, index=index)
+
+    # Update index
+    save_offload_index(index, save_dir)
+
+
+class PrefixedDataset(Mapping):
+    """
+    Will access keys in a given dataset by adding a prefix.
+
+    Args:
+        dataset (`Mapping`): Any map with string keys.
+        prefix (`str`): A prefix to add when trying to access any element in the underlying dataset.
+    """
+
+    def __init__(self, dataset: Mapping, prefix: str):
+        self.dataset = dataset
+        self.prefix = prefix
+
+    def __getitem__(self, key):
+        return self.dataset[f"{self.prefix}{key}"]
+
+    def __iter__(self):
+        return iter([key for key in self.dataset if key.startswith(self.prefix)])
+
+    def __len__(self):
+        return len(self.dataset)
+
+
+class OffloadedWeightsLoader(Mapping):
+    """
+    A collection that loads weights stored in a given state dict or memory-mapped on disk.
+
+    Args:
+        state_dict (`Dict[str, torch.Tensor]`, *optional*):
+            A dictionary parameter name to tensor.
+        save_folder (`str` or `os.PathLike`, *optional*):
+            The directory in which the weights are stored (by `offload_state_dict` for instance).
+        index (`Dict`, *optional*):
+            A dictionary from weight name to their information (`dtype`/ `shape` or safetensors filename). Will default
+            to the index saved in `save_folder`.
+    """
+
+    def __init__(
+        self,
+        state_dict: Dict[str, torch.Tensor] = None,
+        save_folder: Optional[Union[str, os.PathLike]] = None,
+        index: Mapping = None,
+        device=None,
+    ):
+        if state_dict is None and save_folder is None and index is None:
+            raise ValueError("Need either a `state_dict`, a `save_folder` or an `index` containing offloaded weights.")
+
+        self.state_dict = {} if state_dict is None else state_dict
+        self.save_folder = save_folder
+        if index is None and save_folder is not None:
+            with open(os.path.join(save_folder, "index.json")) as f:
+                index = json.load(f)
+        self.index = {} if index is None else index
+        self.all_keys = list(self.state_dict.keys())
+        self.all_keys.extend([key for key in self.index if key not in self.all_keys])
+        self.device = device
+
+    def __getitem__(self, key: str):
+        # State dict gets priority
+        if key in self.state_dict:
+            return self.state_dict[key]
+        weight_info = self.index[key]
+        if weight_info.get("safetensors_file") is not None:
+            device = "cpu" if self.device is None else self.device
+            tensor = None
+            try:
+                with safe_open(weight_info["safetensors_file"], framework="pt", device=device) as f:
+                    tensor = f.get_tensor(weight_info.get("weight_name", key))
+            except TypeError:
+                # if failed to get_tensor on the device, such as bf16 on mps, try to load it on CPU first
+                with safe_open(weight_info["safetensors_file"], framework="pt", device="cpu") as f:
+                    tensor = f.get_tensor(weight_info.get("weight_name", key))
+
+            if "dtype" in weight_info:
+                tensor = tensor.to(getattr(torch, weight_info["dtype"]))
+
+            if tensor.device != torch.device(device):
+                tensor = tensor.to(device)
+            return tensor
+
+        weight_file = os.path.join(self.save_folder, f"{key}.dat")
+        return load_offloaded_weight(weight_file, weight_info)
+
+    def __iter__(self):
+        return iter(self.all_keys)
+
+    def __len__(self):
+        return len(self.all_keys)
+
+
+def extract_submodules_state_dict(state_dict: Dict[str, torch.Tensor], submodule_names: List[str]):
+    """
+    Extract the sub state-dict corresponding to a list of given submodules.
+
+    Args:
+        state_dict (`Dict[str, torch.Tensor]`): The state dict to extract from.
+        submodule_names (`List[str]`): The list of submodule names we want to extract.
+    """
+    result = {}
+    for module_name in submodule_names:
+        # We want to catch module_name parameter (module_name.xxx) or potentially module_name, but not any of the
+        # submodules that could being like module_name (transformers.h.1 and transformers.h.10 for instance)
+        result.update(
+            {
+                key: param
+                for key, param in state_dict.items()
+                if key == module_name or key.startswith(module_name + ".")
+            }
+        )
+    return result
diff --git a/llm/Lib/site-packages/accelerate/utils/operations.py b/llm/Lib/site-packages/accelerate/utils/operations.py
new file mode 100644
index 0000000000000000000000000000000000000000..e2456a10710c9c0707245a00cf3630297d6d579f
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/operations.py
@@ -0,0 +1,851 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""
+A set of basic tensor ops compatible with tpu, gpu, and multigpu
+"""
+
+import pickle
+import warnings
+from functools import update_wrapper, wraps
+from typing import Any, Mapping
+
+import torch
+
+from ..state import PartialState
+from .constants import TORCH_DISTRIBUTED_OPERATION_TYPES
+from .dataclasses import DistributedType, TensorInformation
+from .imports import (
+    is_npu_available,
+    is_torch_distributed_available,
+    is_torch_version,
+    is_torch_xla_available,
+    is_xpu_available,
+)
+
+
+if is_torch_xla_available():
+    import torch_xla.core.xla_model as xm
+
+if is_torch_distributed_available():
+    from torch.distributed import ReduceOp
+
+
+def is_torch_tensor(tensor):
+    return isinstance(tensor, torch.Tensor)
+
+
+def is_torch_xpu_tensor(tensor):
+    return isinstance(
+        tensor,
+        torch.xpu.FloatTensor,
+        torch.xpu.ByteTensor,
+        torch.xpu.IntTensor,
+        torch.xpu.LongTensor,
+        torch.xpu.HalfTensor,
+        torch.xpu.DoubleTensor,
+        torch.xpu.BFloat16Tensor,
+    )
+
+
+def is_tensor_information(tensor_info):
+    return isinstance(tensor_info, TensorInformation)
+
+
+def is_namedtuple(data):
+    """
+    Checks if `data` is a `namedtuple` or not. Can have false positives, but only if a user is trying to mimic a
+    `namedtuple` perfectly.
+    """
+    return isinstance(data, tuple) and hasattr(data, "_asdict") and hasattr(data, "_fields")
+
+
+def honor_type(obj, generator):
+    """
+    Cast a generator to the same type as obj (list, tuple, or namedtuple)
+    """
+    # Some objects may not be able to instantiate from a generator directly
+    if is_namedtuple(obj):
+        return type(obj)(*list(generator))
+    else:
+        return type(obj)(generator)
+
+
+def recursively_apply(func, data, *args, test_type=is_torch_tensor, error_on_other_type=False, **kwargs):
+    """
+    Recursively apply a function on a data structure that is a nested list/tuple/dictionary of a given base type.
+
+    Args:
+        func (`callable`):
+            The function to recursively apply.
+        data (nested list/tuple/dictionary of `main_type`):
+            The data on which to apply `func`
+        *args:
+            Positional arguments that will be passed to `func` when applied on the unpacked data.
+        main_type (`type`, *optional*, defaults to `torch.Tensor`):
+            The base type of the objects to which apply `func`.
+        error_on_other_type (`bool`, *optional*, defaults to `False`):
+            Whether to return an error or not if after unpacking `data`, we get on an object that is not of type
+            `main_type`. If `False`, the function will leave objects of types different than `main_type` unchanged.
+        **kwargs (additional keyword arguments, *optional*):
+            Keyword arguments that will be passed to `func` when applied on the unpacked data.
+
+    Returns:
+        The same data structure as `data` with `func` applied to every object of type `main_type`.
+    """
+    if isinstance(data, (tuple, list)):
+        return honor_type(
+            data,
+            (
+                recursively_apply(
+                    func, o, *args, test_type=test_type, error_on_other_type=error_on_other_type, **kwargs
+                )
+                for o in data
+            ),
+        )
+    elif isinstance(data, Mapping):
+        return type(data)(
+            {
+                k: recursively_apply(
+                    func, v, *args, test_type=test_type, error_on_other_type=error_on_other_type, **kwargs
+                )
+                for k, v in data.items()
+            }
+        )
+    elif test_type(data):
+        return func(data, *args, **kwargs)
+    elif error_on_other_type:
+        raise TypeError(
+            f"Unsupported types ({type(data)}) passed to `{func.__name__}`. Only nested list/tuple/dicts of "
+            f"objects that are valid for `{test_type.__name__}` should be passed."
+        )
+    return data
+
+
+def send_to_device(tensor, device, non_blocking=False, skip_keys=None):
+    """
+    Recursively sends the elements in a nested list/tuple/dictionary of tensors to a given device.
+
+    Args:
+        tensor (nested list/tuple/dictionary of `torch.Tensor`):
+            The data to send to a given device.
+        device (`torch.device`):
+            The device to send the data to.
+
+    Returns:
+        The same data structure as `tensor` with all tensors sent to the proper device.
+    """
+    if is_torch_tensor(tensor) or hasattr(tensor, "to"):
+        # `torch.Tensor.to("npu")` could not find context when called for the first time (see this [issue](https://gitee.com/ascend/pytorch/issues/I8KECW?from=project-issue)).
+        if device == "npu":
+            device = "npu:0"
+        if device == "xpu":
+            device = "xpu:0"
+        # TODO: torch_mlu LongTensor.to(<int num>) has bugs, we will fix this later.
+        if is_torch_tensor(tensor) and tensor.device.type in ["mlu"] and tensor.dtype in [torch.int64]:
+            tensor = tensor.cpu()
+        try:
+            return tensor.to(device, non_blocking=non_blocking)
+        except TypeError:  # .to() doesn't accept non_blocking as kwarg
+            return tensor.to(device)
+        except AssertionError as error:
+            # `torch.Tensor.to(<int num>)` is not supported by `torch_npu` (see this [issue](https://github.com/Ascend/pytorch/issues/16)).
+            # This call is inside the try-block since is_npu_available is not supported by torch.compile.
+            if is_npu_available():
+                if isinstance(device, int):
+                    device = f"npu:{device}"
+            else:
+                raise error
+        except Exception as error:
+            if is_xpu_available():
+                if isinstance(device, int):
+                    device = f"xpu:{device}"
+            else:
+                raise error
+        try:
+            return tensor.to(device, non_blocking=non_blocking)
+        except TypeError:  # .to() doesn't accept non_blocking as kwarg
+            return tensor.to(device)
+    elif isinstance(tensor, (tuple, list)):
+        return honor_type(
+            tensor, (send_to_device(t, device, non_blocking=non_blocking, skip_keys=skip_keys) for t in tensor)
+        )
+    elif isinstance(tensor, Mapping):
+        if isinstance(skip_keys, str):
+            skip_keys = [skip_keys]
+        elif skip_keys is None:
+            skip_keys = []
+        return type(tensor)(
+            {
+                k: t if k in skip_keys else send_to_device(t, device, non_blocking=non_blocking, skip_keys=skip_keys)
+                for k, t in tensor.items()
+            }
+        )
+    else:
+        return tensor
+
+
+def get_data_structure(data):
+    """
+    Recursively gathers the information needed to rebuild a nested list/tuple/dictionary of tensors.
+
+    Args:
+        data (nested list/tuple/dictionary of `torch.Tensor`):
+            The data to send to analyze.
+
+    Returns:
+        The same data structure as `data` with [`~utils.TensorInformation`] instead of tensors.
+    """
+
+    def _get_data_structure(tensor):
+        return TensorInformation(shape=tensor.shape, dtype=tensor.dtype)
+
+    return recursively_apply(_get_data_structure, data)
+
+
+def get_shape(data):
+    """
+    Recursively gathers the shape of a nested list/tuple/dictionary of tensors as a list.
+
+    Args:
+        data (nested list/tuple/dictionary of `torch.Tensor`):
+            The data to send to analyze.
+
+    Returns:
+        The same data structure as `data` with lists of tensor shapes instead of tensors.
+    """
+
+    def _get_shape(tensor):
+        return list(tensor.shape)
+
+    return recursively_apply(_get_shape, data)
+
+
+def initialize_tensors(data_structure):
+    """
+    Recursively initializes tensors from a nested list/tuple/dictionary of [`~utils.TensorInformation`].
+
+    Returns:
+        The same data structure as `data` with tensors instead of [`~utils.TensorInformation`].
+    """
+
+    def _initialize_tensor(tensor_info):
+        return torch.empty(*tensor_info.shape, dtype=tensor_info.dtype)
+
+    return recursively_apply(_initialize_tensor, data_structure, test_type=is_tensor_information)
+
+
+def find_batch_size(data):
+    """
+    Recursively finds the batch size in a nested list/tuple/dictionary of lists of tensors.
+
+    Args:
+        data (nested list/tuple/dictionary of `torch.Tensor`): The data from which to find the batch size.
+
+    Returns:
+        `int`: The batch size.
+    """
+    if isinstance(data, (tuple, list, Mapping)) and (len(data) == 0):
+        raise ValueError(f"Cannot find the batch size from empty {type(data)}.")
+
+    if isinstance(data, (tuple, list)):
+        return find_batch_size(data[0])
+    elif isinstance(data, Mapping):
+        for k in data.keys():
+            return find_batch_size(data[k])
+    elif not isinstance(data, torch.Tensor):
+        raise TypeError(f"Can only find the batch size of tensors but got {type(data)}.")
+    return data.shape[0]
+
+
+def ignorant_find_batch_size(data):
+    """
+    Same as [`utils.operations.find_batch_size`] except will ignore if `ValueError` and `TypeErrors` are raised
+
+    Args:
+        data (nested list/tuple/dictionary of `torch.Tensor`): The data from which to find the batch size.
+
+    Returns:
+        `int`: The batch size.
+    """
+    try:
+        return find_batch_size(data)
+    except (ValueError, TypeError):
+        pass
+    return None
+
+
+def listify(data):
+    """
+    Recursively finds tensors in a nested list/tuple/dictionary and converts them to a list of numbers.
+
+    Args:
+        data (nested list/tuple/dictionary of `torch.Tensor`): The data from which to convert to regular numbers.
+
+    Returns:
+        The same data structure as `data` with lists of numbers instead of `torch.Tensor`.
+    """
+
+    def _convert_to_list(tensor):
+        tensor = tensor.detach().cpu()
+        if tensor.dtype == torch.bfloat16:
+            # As of Numpy 1.21.4, NumPy does not support bfloat16 (see
+            # https://github.com/numpy/numpy/blob/a47ecdea856986cd60eabbd53265c2ca5916ad5d/doc/source/user/basics.types.rst ).
+            # Until Numpy adds bfloat16, we must convert float32.
+            tensor = tensor.to(torch.float32)
+        return tensor.tolist()
+
+    return recursively_apply(_convert_to_list, data)
+
+
+def _tpu_gather(tensor):
+    def _tpu_gather_one(tensor):
+        if tensor.ndim == 0:
+            tensor = tensor.clone()[None]
+
+        # Can only gather contiguous tensors
+        if not tensor.is_contiguous():
+            tensor = tensor.contiguous()
+        return xm.all_gather(tensor)
+
+    res = recursively_apply(_tpu_gather_one, tensor, error_on_other_type=True)
+    xm.mark_step()
+    return res
+
+
+def _gpu_gather(tensor):
+    state = PartialState()
+    if is_torch_version(">=", "1.13"):
+        gather_op = torch.distributed.all_gather_into_tensor
+    else:
+        gather_op = torch.distributed._all_gather_base
+
+    def _gpu_gather_one(tensor):
+        if tensor.ndim == 0:
+            tensor = tensor.clone()[None]
+
+        # Can only gather contiguous tensors
+        if not tensor.is_contiguous():
+            tensor = tensor.contiguous()
+
+        if state.backend is not None and state.backend != "gloo":
+            # We use `empty` as `all_gather_into_tensor` slightly
+            # differs from `all_gather` for better efficiency,
+            # and we rely on the number of items in the tensor
+            # rather than its direct shape
+            output_tensors = torch.empty(
+                state.num_processes * tensor.numel(),
+                dtype=tensor.dtype,
+                device=state.device,
+            )
+            gather_op(output_tensors, tensor)
+            return output_tensors.view(-1, *tensor.size()[1:])
+        else:
+            # a backend of `None` is always CPU
+            # also gloo does not support `all_gather_into_tensor`,
+            # which will result in a larger memory overhead for the op
+            output_tensors = [torch.empty_like(tensor) for _ in range(state.num_processes)]
+            torch.distributed.all_gather(output_tensors, tensor)
+            return torch.cat(output_tensors, dim=0)
+
+    return recursively_apply(_gpu_gather_one, tensor, error_on_other_type=True)
+
+
+class DistributedOperationException(Exception):
+    """
+    An exception class for distributed operations. Raised if the operation cannot be performed due to the shape of the
+    tensors.
+    """
+
+    pass
+
+
+def verify_operation(function):
+    """
+    Verifies that `tensor` is the same shape across all processes. Only ran if `PartialState().debug` is `True`.
+    """
+
+    @wraps(function)
+    def wrapper(*args, **kwargs):
+        if PartialState().distributed_type == DistributedType.NO or not PartialState().debug:
+            return function(*args, **kwargs)
+        operation = f"{function.__module__}.{function.__name__}"
+        if "tensor" in kwargs:
+            tensor = kwargs["tensor"]
+        else:
+            tensor = args[0]
+        if PartialState().device.type != find_device(tensor).type:
+            raise DistributedOperationException(
+                f"One or more of the tensors passed to {operation} were not on the {tensor.device.type} while the `Accelerator` is configured for {PartialState().device.type}. "
+                f"Please move it to the {PartialState().device.type} before calling {operation}."
+            )
+        shapes = get_shape(tensor)
+        output = gather_object([shapes])
+        if output[0] is not None:
+            are_same = output.count(output[0]) == len(output)
+            if not are_same:
+                process_shape_str = "\n  - ".join([f"Process {i}: {shape}" for i, shape in enumerate(output)])
+                raise DistributedOperationException(
+                    f"Cannot apply desired operation due to shape mismatches. "
+                    "All shapes across devices must be valid."
+                    f"\n\nOperation: `{operation}`\nInput shapes:\n  - {process_shape_str}"
+                )
+        return function(*args, **kwargs)
+
+    return wrapper
+
+
+def chained_operation(function):
+    """
+    Checks that `verify_operation` failed and if so reports a more helpful error chaining the existing
+    `DistributedOperationException`.
+    """
+
+    @wraps(function)
+    def wrapper(*args, **kwargs):
+        try:
+            return function(*args, **kwargs)
+        except DistributedOperationException as e:
+            operation = f"{function.__module__}.{function.__name__}"
+            raise DistributedOperationException(
+                f"Error found while calling `{operation}`. Please see the earlier error for more details."
+            ) from e
+
+    return wrapper
+
+
+@verify_operation
+def gather(tensor):
+    """
+    Recursively gather tensor in a nested list/tuple/dictionary of tensors from all devices.
+
+    Args:
+        tensor (nested list/tuple/dictionary of `torch.Tensor`):
+            The data to gather.
+
+    Returns:
+        The same data structure as `tensor` with all tensors sent to the proper device.
+    """
+    if PartialState().distributed_type == DistributedType.XLA:
+        return _tpu_gather(tensor)
+    elif PartialState().distributed_type in TORCH_DISTRIBUTED_OPERATION_TYPES:
+        return _gpu_gather(tensor)
+    else:
+        return tensor
+
+
+def _gpu_gather_object(object: Any):
+    output_objects = [None for _ in range(PartialState().num_processes)]
+    torch.distributed.all_gather_object(output_objects, object)
+    # all_gather_object returns a list of lists, so we need to flatten it
+    return [x for y in output_objects for x in y]
+
+
+def gather_object(object: Any):
+    """
+    Recursively gather object in a nested list/tuple/dictionary of objects from all devices.
+
+    Args:
+        object (nested list/tuple/dictionary of picklable object):
+            The data to gather.
+
+    Returns:
+        The same data structure as `object` with all the objects sent to every device.
+    """
+    if PartialState().distributed_type == DistributedType.XLA:
+        raise NotImplementedError("gather objects in TPU is not supported")
+    elif PartialState().distributed_type in TORCH_DISTRIBUTED_OPERATION_TYPES:
+        return _gpu_gather_object(object)
+    else:
+        return object
+
+
+def _gpu_broadcast(data, src=0):
+    def _gpu_broadcast_one(tensor, src=0):
+        torch.distributed.broadcast(tensor, src=src)
+        return tensor
+
+    return recursively_apply(_gpu_broadcast_one, data, error_on_other_type=True, src=src)
+
+
+def _tpu_broadcast(tensor, src=0, name="broadcast tensor"):
+    if isinstance(tensor, (list, tuple)):
+        return honor_type(tensor, (_tpu_broadcast(t, name=f"{name}_{i}") for i, t in enumerate(tensor)))
+    elif isinstance(tensor, Mapping):
+        return type(tensor)({k: _tpu_broadcast(v, name=f"{name}_{k}") for k, v in tensor.items()})
+    return xm.mesh_reduce(name, tensor, lambda x: x[src])
+
+
+TENSOR_TYPE_TO_INT = {
+    torch.float: 1,
+    torch.double: 2,
+    torch.half: 3,
+    torch.bfloat16: 4,
+    torch.uint8: 5,
+    torch.int8: 6,
+    torch.int16: 7,
+    torch.int32: 8,
+    torch.int64: 9,
+    torch.bool: 10,
+}
+
+TENSOR_INT_TO_DTYPE = {v: k for k, v in TENSOR_TYPE_TO_INT.items()}
+
+
+def gather_tensor_shape(tensor):
+    """
+    Grabs the shape of `tensor` only available on one process and returns a tensor of its shape
+    """
+    # Allocate 80 bytes to store the shape
+    max_tensor_dimension = 2**20
+    state = PartialState()
+    base_tensor = torch.empty(max_tensor_dimension, dtype=torch.int, device=state.device)
+
+    # Since PyTorch can't just send a tensor to another GPU without
+    # knowing its size, we store the size of the tensor with data
+    # in an allocation
+    if tensor is not None:
+        shape = tensor.shape
+        tensor_dtype = TENSOR_TYPE_TO_INT[tensor.dtype]
+        base_tensor[: len(shape) + 1] = torch.tensor(list(shape) + [tensor_dtype], dtype=int)
+    # Perform a reduction to copy the size data onto all GPUs
+    base_tensor = reduce(base_tensor, reduction="sum")
+    base_tensor = base_tensor[base_tensor.nonzero()]
+    # The last non-zero data contains the coded dtype the source tensor is
+    dtype = int(base_tensor[-1:][0])
+    base_tensor = base_tensor[:-1]
+    return base_tensor, dtype
+
+
+def copy_tensor_to_devices(tensor=None) -> torch.Tensor:
+    """
+    Copys a tensor that only exists on a single device and broadcasts it to other devices. Differs from `broadcast` as
+    each worker doesn't need to know its shape when used (and tensor can be `None`)
+
+    Args:
+        tensor (`torch.tensor`):
+            The tensor that should be sent to all devices. Must only have it be defined on a single device, the rest
+            should be `None`.
+    """
+    state = PartialState()
+    shape, dtype = gather_tensor_shape(tensor)
+    if tensor is None:
+        tensor = torch.zeros(shape, dtype=TENSOR_INT_TO_DTYPE[dtype]).to(state.device)
+    return reduce(tensor, reduction="sum")
+
+
+@verify_operation
+def broadcast(tensor, from_process: int = 0):
+    """
+    Recursively broadcast tensor in a nested list/tuple/dictionary of tensors to all devices.
+
+    Args:
+        tensor (nested list/tuple/dictionary of `torch.Tensor`):
+            The data to gather.
+        from_process (`int`, *optional*, defaults to 0):
+            The process from which to send the data
+
+    Returns:
+        The same data structure as `tensor` with all tensors broadcasted to the proper device.
+    """
+    if PartialState().distributed_type == DistributedType.XLA:
+        return _tpu_broadcast(tensor, src=from_process, name="accelerate.utils.broadcast")
+    elif PartialState().distributed_type in TORCH_DISTRIBUTED_OPERATION_TYPES:
+        return _gpu_broadcast(tensor, src=from_process)
+    else:
+        return tensor
+
+
+def broadcast_object_list(object_list, from_process: int = 0):
+    """
+    Broadcast a list of picklable objects form one process to the others.
+
+    Args:
+        object_list (list of picklable objects):
+            The list of objects to broadcast. This list will be modified inplace.
+        from_process (`int`, *optional*, defaults to 0):
+            The process from which to send the data.
+
+    Returns:
+        The same list containing the objects from process 0.
+    """
+    if PartialState().distributed_type == DistributedType.XLA:
+        for i, obj in enumerate(object_list):
+            object_list[i] = xm.mesh_reduce("accelerate.utils.broadcast_object_list", obj, lambda x: x[from_process])
+    elif PartialState().distributed_type in TORCH_DISTRIBUTED_OPERATION_TYPES:
+        torch.distributed.broadcast_object_list(object_list, src=from_process)
+    return object_list
+
+
+def slice_tensors(data, tensor_slice, process_index=None, num_processes=None):
+    """
+    Recursively takes a slice in a nested list/tuple/dictionary of tensors.
+
+    Args:
+        data (nested list/tuple/dictionary of `torch.Tensor`):
+            The data to slice.
+        tensor_slice (`slice`):
+            The slice to take.
+
+    Returns:
+        The same data structure as `data` with all the tensors slices.
+    """
+
+    def _slice_tensor(tensor, tensor_slice):
+        return tensor[tensor_slice]
+
+    return recursively_apply(_slice_tensor, data, tensor_slice)
+
+
+def concatenate(data, dim=0):
+    """
+    Recursively concatenate the tensors in a nested list/tuple/dictionary of lists of tensors with the same shape.
+
+    Args:
+        data (nested list/tuple/dictionary of lists of tensors `torch.Tensor`):
+            The data to concatenate.
+        dim (`int`, *optional*, defaults to 0):
+            The dimension on which to concatenate.
+
+    Returns:
+        The same data structure as `data` with all the tensors concatenated.
+    """
+    if isinstance(data[0], (tuple, list)):
+        return honor_type(data[0], (concatenate([d[i] for d in data], dim=dim) for i in range(len(data[0]))))
+    elif isinstance(data[0], Mapping):
+        return type(data[0])({k: concatenate([d[k] for d in data], dim=dim) for k in data[0].keys()})
+    elif not isinstance(data[0], torch.Tensor):
+        raise TypeError(f"Can only concatenate tensors but got {type(data[0])}")
+    return torch.cat(data, dim=dim)
+
+
+class CannotPadNestedTensorWarning(UserWarning):
+    pass
+
+
+@chained_operation
+def pad_across_processes(tensor, dim=0, pad_index=0, pad_first=False):
+    """
+    Recursively pad the tensors in a nested list/tuple/dictionary of tensors from all devices to the same size so they
+    can safely be gathered.
+
+    Args:
+        tensor (nested list/tuple/dictionary of `torch.Tensor`):
+            The data to gather.
+        dim (`int`, *optional*, defaults to 0):
+            The dimension on which to pad.
+        pad_index (`int`, *optional*, defaults to 0):
+            The value with which to pad.
+        pad_first (`bool`, *optional*, defaults to `False`):
+            Whether to pad at the beginning or the end.
+    """
+
+    def _pad_across_processes(tensor, dim=0, pad_index=0, pad_first=False):
+        if getattr(tensor, "is_nested", False):
+            warnings.warn(
+                "Cannot pad nested tensors without more information. Leaving unprocessed.",
+                CannotPadNestedTensorWarning,
+            )
+            return tensor
+        if dim >= len(tensor.shape):
+            return tensor
+
+        # Gather all sizes
+        size = torch.tensor(tensor.shape, device=tensor.device)[None]
+        sizes = gather(size).cpu()
+        # Then pad to the maximum size
+        max_size = max(s[dim] for s in sizes)
+        if max_size == tensor.shape[dim]:
+            return tensor
+
+        old_size = tensor.shape
+        new_size = list(old_size)
+        new_size[dim] = max_size
+        new_tensor = tensor.new_zeros(tuple(new_size)) + pad_index
+        if pad_first:
+            indices = tuple(
+                slice(max_size - old_size[dim], max_size) if i == dim else slice(None) for i in range(len(new_size))
+            )
+        else:
+            indices = tuple(slice(0, old_size[dim]) if i == dim else slice(None) for i in range(len(new_size)))
+        new_tensor[indices] = tensor
+        return new_tensor
+
+    return recursively_apply(
+        _pad_across_processes, tensor, error_on_other_type=True, dim=dim, pad_index=pad_index, pad_first=pad_first
+    )
+
+
+def pad_input_tensors(tensor, batch_size, num_processes, dim=0):
+    """
+    Takes a `tensor` of arbitrary size and pads it so that it can work given `num_processes` needed dimensions.
+
+    New tensors are just the last input repeated.
+
+    E.g.:
+      Tensor: ([3,4,4]) Num processes: 4 Expected result shape: ([4,4,4])
+
+    """
+
+    def _pad_input_tensors(tensor, batch_size, num_processes, dim=0):
+        remainder = batch_size // num_processes
+        last_inputs = batch_size - (remainder * num_processes)
+        if batch_size // num_processes == 0:
+            to_pad = num_processes - batch_size
+        else:
+            to_pad = num_processes - (batch_size // num_processes)
+        # In the rare case that `to_pad` is negative,
+        # we need to pad the last inputs - the found `to_pad`
+        if last_inputs > to_pad & to_pad < 1:
+            to_pad = last_inputs - to_pad
+        old_size = tensor.shape
+        new_size = list(old_size)
+        new_size[0] = batch_size + to_pad
+        new_tensor = tensor.new_zeros(tuple(new_size))
+        indices = tuple(slice(0, old_size[dim]) if i == dim else slice(None) for i in range(len(new_size)))
+        new_tensor[indices] = tensor
+        return new_tensor
+
+    return recursively_apply(
+        _pad_input_tensors,
+        tensor,
+        error_on_other_type=True,
+        batch_size=batch_size,
+        num_processes=num_processes,
+        dim=dim,
+    )
+
+
+@verify_operation
+def reduce(tensor, reduction="mean", scale=1.0):
+    """
+    Recursively reduce the tensors in a nested list/tuple/dictionary of lists of tensors across all processes by the
+    mean of a given operation.
+
+    Args:
+        tensor (nested list/tuple/dictionary of `torch.Tensor`):
+            The data to reduce.
+        reduction (`str`, *optional*, defaults to `"mean"`):
+            A reduction method. Can be of "mean", "sum", or "none"
+        scale (`float`, *optional*):
+            A default scaling value to be applied after the reduce, only valied on XLA.
+
+    Returns:
+        The same data structure as `data` with all the tensors reduced.
+    """
+
+    def _reduce_across_processes(tensor, reduction="mean", scale=1.0):
+        state = PartialState()
+        cloned_tensor = tensor.clone()
+        if state.distributed_type == DistributedType.NO:
+            return cloned_tensor
+        if state.distributed_type == DistributedType.XLA:
+            # Some processes may have different HLO graphs than other
+            # processes, for example in the breakpoint API
+            # accelerator.set_trigger(). Use mark_step to make HLOs
+            # the same on all processes.
+            xm.mark_step()
+            xm.all_reduce(xm.REDUCE_SUM, [cloned_tensor], scale)
+            xm.mark_step()
+        elif state.distributed_type.value in TORCH_DISTRIBUTED_OPERATION_TYPES:
+            torch.distributed.all_reduce(cloned_tensor, ReduceOp.SUM)
+        if reduction == "mean":
+            cloned_tensor /= state.num_processes
+        return cloned_tensor
+
+    return recursively_apply(
+        _reduce_across_processes, tensor, error_on_other_type=True, reduction=reduction, scale=scale
+    )
+
+
+def convert_to_fp32(tensor):
+    """
+    Recursively converts the elements nested list/tuple/dictionary of tensors in FP16/BF16 precision to FP32.
+
+    Args:
+        tensor (nested list/tuple/dictionary of `torch.Tensor`):
+            The data to convert from FP16/BF16 to FP32.
+
+    Returns:
+        The same data structure as `tensor` with all tensors that were in FP16/BF16 precision converted to FP32.
+    """
+
+    def _convert_to_fp32(tensor):
+        return tensor.float()
+
+    def _is_fp16_bf16_tensor(tensor):
+        return (is_torch_tensor(tensor) or hasattr(tensor, "dtype")) and tensor.dtype in (
+            torch.float16,
+            torch.bfloat16,
+        )
+
+    return recursively_apply(_convert_to_fp32, tensor, test_type=_is_fp16_bf16_tensor)
+
+
+class ConvertOutputsToFp32:
+    """
+    Decorator to apply to a function outputing tensors (like a model forward pass) that ensures the outputs in FP16
+    precision will be convert back to FP32.
+
+    Args:
+        model_forward (`Callable`):
+            The function which outputs we want to treat.
+
+    Returns:
+        The same function as `model_forward` but with converted outputs.
+    """
+
+    def __init__(self, model_forward):
+        self.model_forward = model_forward
+        update_wrapper(self, model_forward)
+
+    def __call__(self, *args, **kwargs):
+        return convert_to_fp32(self.model_forward(*args, **kwargs))
+
+    def __getstate__(self):
+        raise pickle.PicklingError(
+            "Cannot pickle a prepared model with automatic mixed precision, please unwrap the model with `Accelerator.unwrap_model(model)` before pickling it."
+        )
+
+
+def convert_outputs_to_fp32(model_forward):
+    model_forward = ConvertOutputsToFp32(model_forward)
+
+    def forward(*args, **kwargs):
+        return model_forward(*args, **kwargs)
+
+    # To act like a decorator so that it can be popped when doing `extract_model_from_parallel`
+    forward.__wrapped__ = model_forward
+
+    return forward
+
+
+def find_device(data):
+    """
+    Finds the device on which a nested dict/list/tuple of tensors lies (assuming they are all on the same device).
+
+    Args:
+        (nested list/tuple/dictionary of `torch.Tensor`): The data we want to know the device of.
+    """
+    if isinstance(data, Mapping):
+        for obj in data.values():
+            device = find_device(obj)
+            if device is not None:
+                return device
+    elif isinstance(data, (tuple, list)):
+        for obj in data:
+            device = find_device(obj)
+            if device is not None:
+                return device
+    elif isinstance(data, torch.Tensor):
+        return data.device
diff --git a/llm/Lib/site-packages/accelerate/utils/other.py b/llm/Lib/site-packages/accelerate/utils/other.py
new file mode 100644
index 0000000000000000000000000000000000000000..a313d08685be25707109c4973b346cdb0a4af90b
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/other.py
@@ -0,0 +1,366 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import os
+import platform
+import re
+import socket
+from contextlib import contextmanager
+from functools import partial, reduce
+from types import MethodType
+from typing import OrderedDict
+
+import torch
+from packaging.version import Version
+from safetensors.torch import save_file as safe_save_file
+
+from ..commands.config.default import write_basic_config  # noqa: F401
+from ..logging import get_logger
+from ..state import PartialState
+from .constants import FSDP_PYTORCH_VERSION
+from .dataclasses import DistributedType
+from .imports import is_deepspeed_available, is_torch_distributed_available, is_torch_xla_available
+from .modeling import id_tensor_storage
+from .transformer_engine import convert_model
+from .versions import is_torch_version
+
+
+logger = get_logger(__name__)
+
+
+if is_torch_xla_available():
+    import torch_xla.core.xla_model as xm
+
+
+def is_compiled_module(module):
+    """
+    Check whether the module was compiled with torch.compile()
+    """
+    if is_torch_version("<", "2.0.0") or not hasattr(torch, "_dynamo"):
+        return False
+    return isinstance(module, torch._dynamo.eval_frame.OptimizedModule)
+
+
+def extract_model_from_parallel(model, keep_fp32_wrapper: bool = True, recursive: bool = False):
+    """
+    Extract a model from its distributed containers.
+
+    Args:
+        model (`torch.nn.Module`):
+            The model to extract.
+        keep_fp32_wrapper (`bool`, *optional*):
+            Whether to remove mixed precision hooks from the model.
+        recursive (`bool`, *optional*, defaults to `False`):
+            Whether to recursively extract all cases of `module.module` from `model` as well as unwrap child sublayers
+            recursively, not just the top-level distributed containers.
+
+    Returns:
+        `torch.nn.Module`: The extracted model.
+    """
+    options = (torch.nn.parallel.DistributedDataParallel, torch.nn.DataParallel)
+
+    is_compiled = is_compiled_module(model)
+    if is_compiled:
+        compiled_model = model
+        model = model._orig_mod
+
+    if is_deepspeed_available():
+        from deepspeed import DeepSpeedEngine
+
+        options += (DeepSpeedEngine,)
+
+    if is_torch_version(">=", FSDP_PYTORCH_VERSION) and is_torch_distributed_available():
+        from torch.distributed.fsdp.fully_sharded_data_parallel import FullyShardedDataParallel as FSDP
+
+        options += (FSDP,)
+
+    while isinstance(model, options):
+        model = model.module
+
+    if recursive:
+        # This is needed in cases such as using FSDPv2 on XLA
+        def _recursive_unwrap(module):
+            # Wrapped modules are standardly wrapped as `module`, similar to the cases earlier
+            # with DDP, DataParallel, DeepSpeed, and FSDP
+            if hasattr(module, "module"):
+                unwrapped_module = _recursive_unwrap(module.module)
+            else:
+                unwrapped_module = module
+            # Next unwrap child sublayers recursively
+            for name, child in unwrapped_module.named_children():
+                setattr(unwrapped_module, name, _recursive_unwrap(child))
+            return unwrapped_module
+
+        # Start with top-level
+        model = _recursive_unwrap(model)
+
+    if not keep_fp32_wrapper:
+        forward = model.forward
+        original_forward = model.__dict__.pop("_original_forward", None)
+        if original_forward is not None:
+            while hasattr(forward, "__wrapped__"):
+                forward = forward.__wrapped__
+                if forward == original_forward:
+                    break
+            model.forward = MethodType(forward, model)
+        if getattr(model, "_converted_to_transformer_engine", False):
+            convert_model(model, to_transformer_engine=False)
+
+    if is_compiled:
+        compiled_model._orig_mod = model
+        model = compiled_model
+
+    return model
+
+
+def wait_for_everyone():
+    """
+    Introduces a blocking point in the script, making sure all processes have reached this point before continuing.
+
+    <Tip warning={true}>
+
+    Make sure all processes will reach this instruction otherwise one of your processes will hang forever.
+
+    </Tip>
+    """
+    PartialState().wait_for_everyone()
+
+
+def clean_state_dict_for_safetensors(state_dict: dict):
+    """
+    Cleans the state dictionary from a model and removes tensor aliasing if present.
+
+    Args:
+        state_dict (`dict`):
+            The state dictionary from a model
+    """
+    ptrs = collections.defaultdict(list)
+    # When bnb serialization is used, weights in state dict can be strings
+    for name, tensor in state_dict.items():
+        if not isinstance(tensor, str):
+            ptrs[id_tensor_storage(tensor)].append(name)
+
+    # These are all pointers of tensors with shared memory
+    shared_ptrs = {ptr: names for ptr, names in ptrs.items() if len(names) > 1}
+    warn_names = set()
+    for names in shared_ptrs.values():
+        # When not all duplicates have been cleaned, we still remove those keys but put a clear warning.
+        # If the link between tensors was done at runtime then `from_pretrained` will not get
+        # the key back leading to random tensor. A proper warning will be shown
+        # during reload (if applicable), but since the file is not necessarily compatible with
+        # the config, better show a proper warning.
+        found_names = [name for name in names if name in state_dict]
+        warn_names.update(found_names[1:])
+        for name in found_names[1:]:
+            del state_dict[name]
+    if len(warn_names) > 0:
+        logger.warning(
+            f"Removed shared tensor {warn_names} while saving. This should be OK, but check by verifying that you don't receive any warning while reloading",
+        )
+    state_dict = {k: v.contiguous() if isinstance(v, torch.Tensor) else v for k, v in state_dict.items()}
+    return state_dict
+
+
+def save(obj, f, save_on_each_node: bool = False, safe_serialization: bool = False):
+    """
+    Save the data to disk. Use in place of `torch.save()`.
+
+    Args:
+        obj:
+            The data to save
+        f:
+            The file (or file-like object) to use to save the data
+        save_on_each_node (`bool`, *optional*, defaults to `False`):
+            Whether to only save on the global main process
+        safe_serialization (`bool`, *optional*, defaults to `False`):
+            Whether to save `obj` using `safetensors` or the traditional PyTorch way (that uses `pickle`).
+    """
+    # When TorchXLA is enabled, it's necessary to transfer all data to the CPU before saving.
+    # Another issue arises with `id_tensor_storage`, which treats all XLA tensors as identical.
+    # If tensors remain on XLA, calling `clean_state_dict_for_safetensors` will result in only
+    # one XLA tensor remaining.
+    if PartialState().distributed_type == DistributedType.XLA:
+        obj = xm._maybe_convert_to_cpu(obj)
+    # Check if it's a model and remove duplicates
+    if safe_serialization:
+        save_func = partial(safe_save_file, metadata={"format": "pt"})
+        if isinstance(obj, OrderedDict):
+            obj = clean_state_dict_for_safetensors(obj)
+    else:
+        save_func = torch.save
+
+    if PartialState().is_main_process and not save_on_each_node:
+        save_func(obj, f)
+    elif PartialState().is_local_main_process and save_on_each_node:
+        save_func(obj, f)
+
+
+@contextmanager
+def clear_environment():
+    """
+    A context manager that will temporarily clear environment variables.
+
+    When this context exits, the previous environment variables will be back.
+
+    Example:
+
+    ```python
+    >>> import os
+    >>> from accelerate.utils import clear_environment
+
+    >>> os.environ["FOO"] = "bar"
+    >>> with clear_environment():
+    ...     print(os.environ)
+    ...     os.environ["FOO"] = "new_bar"
+    ...     print(os.environ["FOO"])
+    {}
+    new_bar
+
+    >>> print(os.environ["FOO"])
+    bar
+    ```
+    """
+    _old_os_environ = os.environ.copy()
+    os.environ.clear()
+
+    try:
+        yield
+    finally:
+        os.environ.clear()  # clear any added keys,
+        os.environ.update(_old_os_environ)  # then restore previous environment
+
+
+@contextmanager
+def patch_environment(**kwargs):
+    """
+    A context manager that will add each keyword argument passed to `os.environ` and remove them when exiting.
+
+    Will convert the values in `kwargs` to strings and upper-case all the keys.
+
+    Example:
+
+    ```python
+    >>> import os
+    >>> from accelerate.utils import patch_environment
+
+    >>> with patch_environment(FOO="bar"):
+    ...     print(os.environ["FOO"])  # prints "bar"
+    >>> print(os.environ["FOO"])  # raises KeyError
+    ```
+    """
+    existing_vars = {}
+    for key, value in kwargs.items():
+        key = key.upper()
+        if key in os.environ:
+            existing_vars[key] = os.environ[key]
+        os.environ[key] = str(value)
+
+    try:
+        yield
+    finally:
+        for key in kwargs:
+            key = key.upper()
+            if key in existing_vars:
+                # restore previous value
+                os.environ[key] = existing_vars[key]
+            else:
+                os.environ.pop(key, None)
+
+
+def get_pretty_name(obj):
+    """
+    Gets a pretty name from `obj`.
+    """
+    if not hasattr(obj, "__qualname__") and not hasattr(obj, "__name__"):
+        obj = getattr(obj, "__class__", obj)
+    if hasattr(obj, "__qualname__"):
+        return obj.__qualname__
+    if hasattr(obj, "__name__"):
+        return obj.__name__
+    return str(obj)
+
+
+def merge_dicts(source, destination):
+    """
+    Recursively merges two dictionaries.
+
+    Args:
+        source (`dict`): The dictionary to merge into `destination`.
+        destination (`dict`): The dictionary to merge `source` into.
+    """
+    for key, value in source.items():
+        if isinstance(value, dict):
+            node = destination.setdefault(key, {})
+            merge_dicts(value, node)
+        else:
+            destination[key] = value
+
+    return destination
+
+
+def is_port_in_use(port: int = None) -> bool:
+    """
+    Checks if a port is in use on `localhost`. Useful for checking if multiple `accelerate launch` commands have been
+    run and need to see if the port is already in use.
+    """
+    if port is None:
+        port = 29500
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        return s.connect_ex(("localhost", port)) == 0
+
+
+def convert_bytes(size):
+    "Converts `size` from bytes to the largest possible unit"
+    for x in ["bytes", "KB", "MB", "GB", "TB"]:
+        if size < 1024.0:
+            return f"{round(size, 2)} {x}"
+        size /= 1024.0
+
+    return f"{round(size, 2)} PB"
+
+
+def check_os_kernel():
+    """Warns if the kernel version is below the recommended minimum on Linux."""
+    # see issue #1929
+    info = platform.uname()
+    system = info.system
+    if system != "Linux":
+        return
+
+    _, version, *_ = re.split(r"(\d+\.\d+\.\d+)", info.release)
+    min_version = "5.5.0"
+    if Version(version) < Version(min_version):
+        msg = (
+            f"Detected kernel version {version}, which is below the recommended minimum of {min_version}; this can "
+            "cause the process to hang. It is recommended to upgrade the kernel to the minimum version or higher."
+        )
+        logger.warning(msg, main_process_only=True)
+
+
+def recursive_getattr(obj, attr: str):
+    """
+    Recursive `getattr`.
+
+    Args:
+        obj:
+            A class instance holding the attribute.
+        attr (`str`):
+            The attribute that is to be retrieved, e.g. 'attribute1.attribute2'.
+    """
+
+    def _getattr(obj, attr):
+        return getattr(obj, attr)
+
+    return reduce(_getattr, [obj] + attr.split("."))
diff --git a/llm/Lib/site-packages/accelerate/utils/random.py b/llm/Lib/site-packages/accelerate/utils/random.py
new file mode 100644
index 0000000000000000000000000000000000000000..f21312289a77bce9143c985292a14185f35f5938
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/random.py
@@ -0,0 +1,122 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import random
+from typing import List, Optional, Union
+
+import numpy as np
+import torch
+
+from ..state import AcceleratorState
+from .constants import CUDA_DISTRIBUTED_TYPES
+from .dataclasses import DistributedType, RNGType
+from .imports import is_mlu_available, is_npu_available, is_torch_xla_available, is_xpu_available
+
+
+if is_torch_xla_available():
+    import torch_xla.core.xla_model as xm
+
+
+def set_seed(seed: int, device_specific: bool = False, deterministic: bool = False):
+    """
+    Helper function for reproducible behavior to set the seed in `random`, `numpy`, `torch`.
+
+    Args:
+        seed (`int`):
+            The seed to set.
+        device_specific (`bool`, *optional*, defaults to `False`):
+            Whether to differ the seed on each device slightly with `self.process_index`.
+        deterministic (`bool`, *optional*, defaults to `False`):
+            Whether to use deterministic algorithms where available. Can slow down training.
+    """
+    if device_specific:
+        seed += AcceleratorState().process_index
+    random.seed(seed)
+    np.random.seed(seed)
+    torch.manual_seed(seed)
+    if is_xpu_available():
+        torch.xpu.manual_seed_all(seed)
+    elif is_npu_available():
+        torch.npu.manual_seed_all(seed)
+    elif is_mlu_available():
+        torch.mlu.manual_seed_all(seed)
+    else:
+        torch.cuda.manual_seed_all(seed)
+    # ^^ safe to call this function even if cuda is not available
+    if is_torch_xla_available():
+        xm.set_rng_state(seed)
+
+    if deterministic:
+        torch.use_deterministic_algorithms(True)
+
+
+def synchronize_rng_state(rng_type: Optional[RNGType] = None, generator: Optional[torch.Generator] = None):
+    # Get the proper rng state
+    if rng_type == RNGType.TORCH:
+        rng_state = torch.get_rng_state()
+    elif rng_type == RNGType.CUDA:
+        rng_state = torch.cuda.get_rng_state()
+    elif rng_type == RNGType.XLA:
+        assert is_torch_xla_available(), "Can't synchronize XLA seeds as torch_xla is unavailable."
+        rng_state = torch.tensor(xm.get_rng_state())
+    elif rng_type == RNGType.NPU:
+        assert is_npu_available(), "Can't synchronize NPU seeds on an environment without NPUs."
+        rng_state = torch.npu.get_rng_state()
+    elif rng_type == RNGType.MLU:
+        assert is_mlu_available(), "Can't synchronize MLU seeds on an environment without MLUs."
+        rng_state = torch.mlu.get_rng_state()
+    elif rng_type == RNGType.XPU:
+        assert is_xpu_available(), "Can't synchronize XPU seeds on an environment without XPUs."
+        rng_state = torch.xpu.get_rng_state()
+    elif rng_type == RNGType.GENERATOR:
+        assert generator is not None, "Need a generator to synchronize its seed."
+        rng_state = generator.get_state()
+
+    # Broadcast the rng state from device 0 to other devices
+    state = AcceleratorState()
+    if state.distributed_type == DistributedType.XLA:
+        rng_state = rng_state.to(xm.xla_device())
+        xm.collective_broadcast([rng_state])
+        xm.mark_step()
+        rng_state = rng_state.cpu()
+    elif (
+        state.distributed_type in CUDA_DISTRIBUTED_TYPES
+        or state.distributed_type == DistributedType.MULTI_MLU
+        or state.distributed_type == DistributedType.MULTI_NPU
+        or state.distributed_type == DistributedType.MULTI_XPU
+    ):
+        rng_state = rng_state.to(state.device)
+        torch.distributed.broadcast(rng_state, 0)
+        rng_state = rng_state.cpu()
+    elif state.distributed_type == DistributedType.MULTI_CPU:
+        torch.distributed.broadcast(rng_state, 0)
+
+    # Set the broadcast rng state
+    if rng_type == RNGType.TORCH:
+        torch.set_rng_state(rng_state)
+    elif rng_type == RNGType.CUDA:
+        torch.cuda.set_rng_state(rng_state)
+    elif rng_type == RNGType.NPU:
+        torch.npu.set_rng_state(rng_state)
+    elif rng_type == RNGType.XPU:
+        torch.xpu.set_rng_state(rng_state)
+    elif rng_type == RNGType.XLA:
+        xm.set_rng_state(rng_state.item())
+    elif rng_type == RNGType.GENERATOR:
+        generator.set_state(rng_state)
+
+
+def synchronize_rng_states(rng_types: List[Union[str, RNGType]], generator: Optional[torch.Generator] = None):
+    for rng_type in rng_types:
+        synchronize_rng_state(RNGType(rng_type), generator=generator)
diff --git a/llm/Lib/site-packages/accelerate/utils/rich.py b/llm/Lib/site-packages/accelerate/utils/rich.py
new file mode 100644
index 0000000000000000000000000000000000000000..2d48661b7fcef92ef1168b74cc275c6d3ccc67a1
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/rich.py
@@ -0,0 +1,24 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .imports import is_rich_available
+
+
+if is_rich_available():
+    from rich.traceback import install
+
+    install(show_locals=False)
+
+else:
+    raise ModuleNotFoundError("To use the rich extension, install rich with `pip install rich`")
diff --git a/llm/Lib/site-packages/accelerate/utils/torch_xla.py b/llm/Lib/site-packages/accelerate/utils/torch_xla.py
new file mode 100644
index 0000000000000000000000000000000000000000..140133926c2f88d39c70f5a9f46a08f88bed36da
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/torch_xla.py
@@ -0,0 +1,51 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import importlib.metadata
+import subprocess
+import sys
+
+
+def install_xla(upgrade: bool = False):
+    """
+    Helper function to install appropriate xla wheels based on the `torch` version in Google Colaboratory.
+
+    Args:
+        upgrade (`bool`, *optional*, defaults to `False`):
+            Whether to upgrade `torch` and install the latest `torch_xla` wheels.
+
+    Example:
+
+    ```python
+    >>> from accelerate.utils import install_xla
+
+    >>> install_xla(upgrade=True)
+    ```
+    """
+    in_colab = False
+    if "IPython" in sys.modules:
+        in_colab = "google.colab" in str(sys.modules["IPython"].get_ipython())
+
+    if in_colab:
+        if upgrade:
+            torch_install_cmd = ["pip", "install", "-U", "torch"]
+            subprocess.run(torch_install_cmd, check=True)
+        # get the current version of torch
+        torch_version = importlib.metadata.version("torch")
+        torch_version_trunc = torch_version[: torch_version.rindex(".")]
+        xla_wheel = f"https://storage.googleapis.com/tpu-pytorch/wheels/colab/torch_xla-{torch_version_trunc}-cp37-cp37m-linux_x86_64.whl"
+        xla_install_cmd = ["pip", "install", xla_wheel]
+        subprocess.run(xla_install_cmd, check=True)
+    else:
+        raise RuntimeError("`install_xla` utility works only on google colab.")
diff --git a/llm/Lib/site-packages/accelerate/utils/tqdm.py b/llm/Lib/site-packages/accelerate/utils/tqdm.py
new file mode 100644
index 0000000000000000000000000000000000000000..940a8bb04aced0c898ba1926bacc4b60b72d6f54
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/tqdm.py
@@ -0,0 +1,37 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .imports import is_tqdm_available
+
+
+if is_tqdm_available():
+    from tqdm.auto import tqdm as _tqdm
+
+from ..state import PartialState
+
+
+def tqdm(main_process_only: bool = True, *args, **kwargs):
+    """
+    Wrapper around `tqdm.tqdm` that optionally displays only on the main process.
+
+    Args:
+        main_process_only (`bool`, *optional*):
+            Whether to display the progress bar only on the main process
+    """
+    if not is_tqdm_available():
+        raise ImportError("Accelerate's `tqdm` module requires `tqdm` to be installed. Please run `pip install tqdm`.")
+    disable = False
+    if main_process_only:
+        disable = PartialState().local_process_index != 0
+    return _tqdm(*args, **kwargs, disable=disable)
diff --git a/llm/Lib/site-packages/accelerate/utils/transformer_engine.py b/llm/Lib/site-packages/accelerate/utils/transformer_engine.py
new file mode 100644
index 0000000000000000000000000000000000000000..211a9f553ca22ac4938969416d07a9b139918b60
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/transformer_engine.py
@@ -0,0 +1,84 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import torch.nn as nn
+
+from .imports import is_fp8_available
+
+
+if is_fp8_available():
+    import transformer_engine.pytorch as te
+
+
+def convert_model(model, to_transformer_engine=True, _convert_linear=True, _convert_ln=True):
+    """
+    Recursively converts the linear and layernorm layers of a model to their `transformers_engine` counterpart.
+    """
+    if not is_fp8_available():
+        raise ImportError("Using `convert_model` requires transformer_engine to be installed.")
+    for name, module in model.named_children():
+        if isinstance(module, nn.Linear) and to_transformer_engine and _convert_linear:
+            # Return early if the linear layer weights are not multiples of 16
+            if any(p % 16 != 0 for p in module.weight.shape):
+                return
+            has_bias = module.bias is not None
+            te_module = te.Linear(
+                module.in_features, module.out_features, bias=has_bias, params_dtype=module.weight.dtype
+            )
+            te_module.weight.copy_(module.weight)
+            if has_bias:
+                te_module.bias.copy_(module.bias)
+
+            setattr(model, name, te_module)
+        elif isinstance(module, nn.LayerNorm) and to_transformer_engine and _convert_ln:
+            te_module = te.LayerNorm(module.normalized_shape[0], eps=module.eps, params_dtype=module.weight.dtype)
+            te_module.weight.copy_(module.weight)
+            te_module.bias.copy_(module.bias)
+
+            setattr(model, name, te_module)
+        elif isinstance(module, te.Linear) and not to_transformer_engine and _convert_linear:
+            has_bias = module.bias is not None
+            new_module = nn.Linear(
+                module.in_features, module.out_features, bias=has_bias, params_dtype=module.weight.dtype
+            )
+            new_module.weight.copy_(module.weight)
+            if has_bias:
+                new_module.bias.copy_(module.bias)
+
+            setattr(model, name, new_module)
+        elif isinstance(module, te.LayerNorm) and not to_transformer_engine and _convert_ln:
+            new_module = nn.LayerNorm(module.normalized_shape[0], eps=module.eps, params_dtype=module.weight.dtype)
+            new_module.weight.copy_(module.weight)
+            new_module.bias.copy_(module.bias)
+
+            setattr(model, name, new_module)
+        else:
+            convert_model(
+                module,
+                to_transformer_engine=to_transformer_engine,
+                _convert_linear=_convert_linear,
+                _convert_ln=_convert_ln,
+            )
+
+
+def has_transformer_engine_layers(model):
+    """
+    Returns whether a given model has some `transformer_engine` layer or not.
+    """
+    if not is_fp8_available():
+        raise ImportError("Using `has_transformer_engine_layers` requires transformer_engine to be installed.")
+    for m in model.modules():
+        if isinstance(m, (te.LayerNorm, te.Linear, te.TransformerLayer)):
+            return True
+    return False
diff --git a/llm/Lib/site-packages/accelerate/utils/versions.py b/llm/Lib/site-packages/accelerate/utils/versions.py
new file mode 100644
index 0000000000000000000000000000000000000000..985c918f0e057bacc70c372f6906071bb73db577
--- /dev/null
+++ b/llm/Lib/site-packages/accelerate/utils/versions.py
@@ -0,0 +1,56 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import importlib.metadata
+from typing import Union
+
+from packaging.version import Version, parse
+
+from .constants import STR_OPERATION_TO_FUNC
+
+
+torch_version = parse(importlib.metadata.version("torch"))
+
+
+def compare_versions(library_or_version: Union[str, Version], operation: str, requirement_version: str):
+    """
+    Compares a library version to some requirement using a given operation.
+
+    Args:
+        library_or_version (`str` or `packaging.version.Version`):
+            A library name or a version to check.
+        operation (`str`):
+            A string representation of an operator, such as `">"` or `"<="`.
+        requirement_version (`str`):
+            The version to compare the library version against
+    """
+    if operation not in STR_OPERATION_TO_FUNC.keys():
+        raise ValueError(f"`operation` must be one of {list(STR_OPERATION_TO_FUNC.keys())}, received {operation}")
+    operation = STR_OPERATION_TO_FUNC[operation]
+    if isinstance(library_or_version, str):
+        library_or_version = parse(importlib.metadata.version(library_or_version))
+    return operation(library_or_version, parse(requirement_version))
+
+
+def is_torch_version(operation: str, version: str):
+    """
+    Compares the current PyTorch version to a given reference with an operation.
+
+    Args:
+        operation (`str`):
+            A string representation of an operator, such as `">"` or `"<="`
+        version (`str`):
+            A string version of PyTorch
+    """
+    return compare_versions(torch_version, operation, version)
diff --git a/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/INSTALLER b/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/LICENSE.txt b/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..aa2bc24043c1dddac90e74eba3ff92b848515898
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/LICENSE.txt
@@ -0,0 +1,13 @@
+   Copyright aio-libs contributors.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/METADATA b/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..b120f8f97d986a42c0ff7422c57b4fdd47451573
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/METADATA
@@ -0,0 +1,245 @@
+Metadata-Version: 2.1
+Name: aiohttp
+Version: 3.9.5
+Summary: Async http client/server framework (asyncio)
+Home-page: https://github.com/aio-libs/aiohttp
+Maintainer: aiohttp team <team@aiohttp.org>
+Maintainer-email: team@aiohttp.org
+License: Apache 2
+Project-URL: Chat: Matrix, https://matrix.to/#/#aio-libs:matrix.org
+Project-URL: Chat: Matrix Space, https://matrix.to/#/#aio-libs-space:matrix.org
+Project-URL: CI: GitHub Actions, https://github.com/aio-libs/aiohttp/actions?query=workflow%3ACI
+Project-URL: Coverage: codecov, https://codecov.io/github/aio-libs/aiohttp
+Project-URL: Docs: Changelog, https://docs.aiohttp.org/en/stable/changes.html
+Project-URL: Docs: RTD, https://docs.aiohttp.org
+Project-URL: GitHub: issues, https://github.com/aio-libs/aiohttp/issues
+Project-URL: GitHub: repo, https://github.com/aio-libs/aiohttp
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+License-File: LICENSE.txt
+Requires-Dist: aiosignal >=1.1.2
+Requires-Dist: attrs >=17.3.0
+Requires-Dist: frozenlist >=1.1.1
+Requires-Dist: multidict <7.0,>=4.5
+Requires-Dist: yarl <2.0,>=1.0
+Requires-Dist: async-timeout <5.0,>=4.0 ; python_version < "3.11"
+Provides-Extra: speedups
+Requires-Dist: brotlicffi ; (platform_python_implementation != "CPython") and extra == 'speedups'
+Requires-Dist: Brotli ; (platform_python_implementation == "CPython") and extra == 'speedups'
+Requires-Dist: aiodns ; (sys_platform == "linux" or sys_platform == "darwin") and extra == 'speedups'
+
+==================================
+Async http client/server framework
+==================================
+
+.. image:: https://raw.githubusercontent.com/aio-libs/aiohttp/master/docs/aiohttp-plain.svg
+   :height: 64px
+   :width: 64px
+   :alt: aiohttp logo
+
+|
+
+.. image:: https://github.com/aio-libs/aiohttp/workflows/CI/badge.svg
+   :target: https://github.com/aio-libs/aiohttp/actions?query=workflow%3ACI
+   :alt: GitHub Actions status for master branch
+
+.. image:: https://codecov.io/gh/aio-libs/aiohttp/branch/master/graph/badge.svg
+   :target: https://codecov.io/gh/aio-libs/aiohttp
+   :alt: codecov.io status for master branch
+
+.. image:: https://badge.fury.io/py/aiohttp.svg
+   :target: https://pypi.org/project/aiohttp
+   :alt: Latest PyPI package version
+
+.. image:: https://readthedocs.org/projects/aiohttp/badge/?version=latest
+   :target: https://docs.aiohttp.org/
+   :alt: Latest Read The Docs
+
+.. image:: https://img.shields.io/matrix/aio-libs:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat
+   :target: https://matrix.to/#/%23aio-libs:matrix.org
+   :alt: Matrix Room — #aio-libs:matrix.org
+
+.. image:: https://img.shields.io/matrix/aio-libs-space:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs-space%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat
+   :target: https://matrix.to/#/%23aio-libs-space:matrix.org
+   :alt: Matrix Space — #aio-libs-space:matrix.org
+
+
+Key Features
+============
+
+- Supports both client and server side of HTTP protocol.
+- Supports both client and server Web-Sockets out-of-the-box and avoids
+  Callback Hell.
+- Provides Web-server with middleware and pluggable routing.
+
+
+Getting started
+===============
+
+Client
+------
+
+To get something from the web:
+
+.. code-block:: python
+
+  import aiohttp
+  import asyncio
+
+  async def main():
+
+      async with aiohttp.ClientSession() as session:
+          async with session.get('http://python.org') as response:
+
+              print("Status:", response.status)
+              print("Content-type:", response.headers['content-type'])
+
+              html = await response.text()
+              print("Body:", html[:15], "...")
+
+  asyncio.run(main())
+
+This prints:
+
+.. code-block::
+
+    Status: 200
+    Content-type: text/html; charset=utf-8
+    Body: <!doctype html> ...
+
+Coming from `requests <https://requests.readthedocs.io/>`_ ? Read `why we need so many lines <https://aiohttp.readthedocs.io/en/latest/http_request_lifecycle.html>`_.
+
+Server
+------
+
+An example using a simple server:
+
+.. code-block:: python
+
+    # examples/server_simple.py
+    from aiohttp import web
+
+    async def handle(request):
+        name = request.match_info.get('name', "Anonymous")
+        text = "Hello, " + name
+        return web.Response(text=text)
+
+    async def wshandle(request):
+        ws = web.WebSocketResponse()
+        await ws.prepare(request)
+
+        async for msg in ws:
+            if msg.type == web.WSMsgType.text:
+                await ws.send_str("Hello, {}".format(msg.data))
+            elif msg.type == web.WSMsgType.binary:
+                await ws.send_bytes(msg.data)
+            elif msg.type == web.WSMsgType.close:
+                break
+
+        return ws
+
+
+    app = web.Application()
+    app.add_routes([web.get('/', handle),
+                    web.get('/echo', wshandle),
+                    web.get('/{name}', handle)])
+
+    if __name__ == '__main__':
+        web.run_app(app)
+
+
+Documentation
+=============
+
+https://aiohttp.readthedocs.io/
+
+
+Demos
+=====
+
+https://github.com/aio-libs/aiohttp-demos
+
+
+External links
+==============
+
+* `Third party libraries
+  <http://aiohttp.readthedocs.io/en/latest/third_party.html>`_
+* `Built with aiohttp
+  <http://aiohttp.readthedocs.io/en/latest/built_with.html>`_
+* `Powered by aiohttp
+  <http://aiohttp.readthedocs.io/en/latest/powered_by.html>`_
+
+Feel free to make a Pull Request for adding your link to these pages!
+
+
+Communication channels
+======================
+
+*aio-libs Discussions*: https://github.com/aio-libs/aiohttp/discussions
+
+*gitter chat* https://gitter.im/aio-libs/Lobby
+
+We support `Stack Overflow
+<https://stackoverflow.com/questions/tagged/aiohttp>`_.
+Please add *aiohttp* tag to your question there.
+
+Requirements
+============
+
+- async-timeout_
+- attrs_
+- multidict_
+- yarl_
+- frozenlist_
+
+Optionally you may install the aiodns_ library (highly recommended for sake of speed).
+
+.. _aiodns: https://pypi.python.org/pypi/aiodns
+.. _attrs: https://github.com/python-attrs/attrs
+.. _multidict: https://pypi.python.org/pypi/multidict
+.. _frozenlist: https://pypi.org/project/frozenlist/
+.. _yarl: https://pypi.python.org/pypi/yarl
+.. _async-timeout: https://pypi.python.org/pypi/async_timeout
+
+License
+=======
+
+``aiohttp`` is offered under the Apache 2 license.
+
+
+Keepsafe
+========
+
+The aiohttp community would like to thank Keepsafe
+(https://www.getkeepsafe.com) for its support in the early days of
+the project.
+
+
+Source code
+===========
+
+The latest developer version is available in a GitHub repository:
+https://github.com/aio-libs/aiohttp
+
+Benchmarks
+==========
+
+If you are interested in efficiency, the AsyncIO community maintains a
+list of benchmarks on the official wiki:
+https://github.com/python/asyncio/wiki/Benchmarks
diff --git a/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/RECORD b/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..54c1f40b4208f0f7a6ddd80da22ebabe8e1fe075
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/RECORD
@@ -0,0 +1,119 @@
+aiohttp-3.9.5.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+aiohttp-3.9.5.dist-info/LICENSE.txt,sha256=wUk-nxDVnR-6n53ygAjhVX4zz5-6yM4SY6ozk5goA94,601
+aiohttp-3.9.5.dist-info/METADATA,sha256=kKiQL2qSh9OPRTR0p18PDA_eIr3RVDY5GCUc6EwN9Ig,7704
+aiohttp-3.9.5.dist-info/RECORD,,
+aiohttp-3.9.5.dist-info/WHEEL,sha256=nSybvzWlmdJnHiUQSY-d7V1ycwEVUTqXiTvr2eshg44,102
+aiohttp-3.9.5.dist-info/top_level.txt,sha256=iv-JIaacmTl-hSho3QmphcKnbRRYx1st47yjz_178Ro,8
+aiohttp/.hash/_cparser.pxd.hash,sha256=dVGMrCmyJM_owqoRLPezK095md0X5R319koTuhUN6DQ,64
+aiohttp/.hash/_find_header.pxd.hash,sha256=W5qRPWDc55gArGZkriI5tztmQHkrdwR6NdQfRQfTxIg,64
+aiohttp/.hash/_helpers.pyi.hash,sha256=bAsxbXsjcZ5gbj1c561GYcRtQ5REXxrCihR-HN0XKPk,64
+aiohttp/.hash/_helpers.pyx.hash,sha256=-DfrN0XUqBhyb8bp2fJQVb1Lo9S1S-psob-7MJBM18c,64
+aiohttp/.hash/_http_parser.pyx.hash,sha256=oAd3pEXdaK_NpQ_aHW-X0zqg5DXUxWP0cWVBGdFu814,64
+aiohttp/.hash/_http_writer.pyx.hash,sha256=z39c0hUcdud-ZCon2d9bWpxrFMVdW1dvjtCgxW4RDnI,64
+aiohttp/.hash/_websocket.pyx.hash,sha256=90x5ulhWiFtw2wAri2_82Zas5i3iEkJ-flYJK9Xx-SY,64
+aiohttp/.hash/hdrs.py.hash,sha256=QBHPUkJcp8iPZv3ENUbevgpJzljxoP2qwkBeX3nQ82o,64
+aiohttp/__init__.py,sha256=iyyddK6RtQIJpHQL71YaQ9-ti3S5HUeeaTpIaLlfKVs,8002
+aiohttp/__pycache__/__init__.cpython-311.pyc,,
+aiohttp/__pycache__/abc.cpython-311.pyc,,
+aiohttp/__pycache__/base_protocol.cpython-311.pyc,,
+aiohttp/__pycache__/client.cpython-311.pyc,,
+aiohttp/__pycache__/client_exceptions.cpython-311.pyc,,
+aiohttp/__pycache__/client_proto.cpython-311.pyc,,
+aiohttp/__pycache__/client_reqrep.cpython-311.pyc,,
+aiohttp/__pycache__/client_ws.cpython-311.pyc,,
+aiohttp/__pycache__/compression_utils.cpython-311.pyc,,
+aiohttp/__pycache__/connector.cpython-311.pyc,,
+aiohttp/__pycache__/cookiejar.cpython-311.pyc,,
+aiohttp/__pycache__/formdata.cpython-311.pyc,,
+aiohttp/__pycache__/hdrs.cpython-311.pyc,,
+aiohttp/__pycache__/helpers.cpython-311.pyc,,
+aiohttp/__pycache__/http.cpython-311.pyc,,
+aiohttp/__pycache__/http_exceptions.cpython-311.pyc,,
+aiohttp/__pycache__/http_parser.cpython-311.pyc,,
+aiohttp/__pycache__/http_websocket.cpython-311.pyc,,
+aiohttp/__pycache__/http_writer.cpython-311.pyc,,
+aiohttp/__pycache__/locks.cpython-311.pyc,,
+aiohttp/__pycache__/log.cpython-311.pyc,,
+aiohttp/__pycache__/multipart.cpython-311.pyc,,
+aiohttp/__pycache__/payload.cpython-311.pyc,,
+aiohttp/__pycache__/payload_streamer.cpython-311.pyc,,
+aiohttp/__pycache__/pytest_plugin.cpython-311.pyc,,
+aiohttp/__pycache__/resolver.cpython-311.pyc,,
+aiohttp/__pycache__/streams.cpython-311.pyc,,
+aiohttp/__pycache__/tcp_helpers.cpython-311.pyc,,
+aiohttp/__pycache__/test_utils.cpython-311.pyc,,
+aiohttp/__pycache__/tracing.cpython-311.pyc,,
+aiohttp/__pycache__/typedefs.cpython-311.pyc,,
+aiohttp/__pycache__/web.cpython-311.pyc,,
+aiohttp/__pycache__/web_app.cpython-311.pyc,,
+aiohttp/__pycache__/web_exceptions.cpython-311.pyc,,
+aiohttp/__pycache__/web_fileresponse.cpython-311.pyc,,
+aiohttp/__pycache__/web_log.cpython-311.pyc,,
+aiohttp/__pycache__/web_middlewares.cpython-311.pyc,,
+aiohttp/__pycache__/web_protocol.cpython-311.pyc,,
+aiohttp/__pycache__/web_request.cpython-311.pyc,,
+aiohttp/__pycache__/web_response.cpython-311.pyc,,
+aiohttp/__pycache__/web_routedef.cpython-311.pyc,,
+aiohttp/__pycache__/web_runner.cpython-311.pyc,,
+aiohttp/__pycache__/web_server.cpython-311.pyc,,
+aiohttp/__pycache__/web_urldispatcher.cpython-311.pyc,,
+aiohttp/__pycache__/web_ws.cpython-311.pyc,,
+aiohttp/__pycache__/worker.cpython-311.pyc,,
+aiohttp/_cparser.pxd,sha256=W6-cu0SyHhOEPeb475NvxagQ1Jz9pWqyZJvwEqTLNs0,4476
+aiohttp/_find_header.pxd,sha256=BFUSmxhemBtblqxzjzH3x03FfxaWlTyuAIOz8YZ5_nM,70
+aiohttp/_headers.pxi,sha256=1MhCe6Un_KI1tpO85HnDfzVO94BhcirLanAOys5FIHA,2090
+aiohttp/_helpers.cp311-win_amd64.pyd,sha256=3R9fX40_j4Qp6P0DGVp3708xDQp6TnupZVP1NO8d-30,54272
+aiohttp/_helpers.pyi,sha256=2Hd5IC0Zf4YTEJ412suyyhsh1kVyVDv5g4stgyo2Ksc,208
+aiohttp/_helpers.pyx,sha256=tgl7fZh0QMT6cjf4jSJ8iaO6DdQD3GON2-SH4N5_ETg,1084
+aiohttp/_http_parser.cp311-win_amd64.pyd,sha256=CkSfUFHRcy_rS4wjSOdQR7vDjOmeb1sacMsk_M5Q7Uc,263168
+aiohttp/_http_parser.pyx,sha256=SAenRA9RzY5AaVWWns_s9DMbZlVHgKlEyLgPQvUcTb0,28963
+aiohttp/_http_writer.cp311-win_amd64.pyd,sha256=FkrGrf2qzPJRUm3Ir2ra6_zwR0bJxSRjTlmv71Oh-Cs,49152
+aiohttp/_http_writer.pyx,sha256=8CBLytO2rx1kdpWe9HYSznhLXdeZWyE-3xI7jaGasag,4738
+aiohttp/_websocket.cp311-win_amd64.pyd,sha256=uF98m_IwYr6Ne553zVRBb9t2jOr7EUwc2xn4s0mpN3w,36352
+aiohttp/_websocket.pyx,sha256=o9J7yi9c2-jTBjE3dUkXxhDWKvRWJz5GZfyLsgJQa38,1617
+aiohttp/abc.py,sha256=wpbkcMsLWB_r_sD35PesqbWFY3tZOvilOjqSqHDUaMQ,5709
+aiohttp/base_protocol.py,sha256=N4IzuMQLGHG7AJji9um-2gqQxKGo41P3aCZwrvegumc,2971
+aiohttp/client.py,sha256=VSQeFcR4eLEgXNRug-bWozUDC6bJNvTbz6DR39o0tQc,48865
+aiohttp/client_exceptions.py,sha256=BiReSs5jdjdmhB99vYNBcypsuRfyQU2UQXG0cVRAD2A,9757
+aiohttp/client_proto.py,sha256=9tmgb3DbBUQC8D9Vv-uElsKH28XsE_C8C6SD30rGBb0,10206
+aiohttp/client_reqrep.py,sha256=DMwNd2p84R9kHadxiEppU9PvefSSqhu9eEOScRPjlL4,41282
+aiohttp/client_ws.py,sha256=mi8iVYQR25Hi20AQing6T1BZBcO24NsQIKubhsR8izM,11325
+aiohttp/compression_utils.py,sha256=OIQOhFq_YssPx-SNCn9UkQTqntHhZKZakhwUQfaJSyA,5172
+aiohttp/connector.py,sha256=bwu10B9Bdgm59-Aghyjy4LRC4aHzL03F1K6dZy-BLuU,55307
+aiohttp/cookiejar.py,sha256=vgjrRISdZ5jwGfJC6T9QLuW-f56KfpGrtnrcbsUHkU0,14434
+aiohttp/formdata.py,sha256=XRu5kZi8MqEMoct2KGBrVetaHVthIRI__0o3UQfctzc,6703
+aiohttp/hdrs.py,sha256=_JN4MBE-UoBXGWGoSCKhIviTRc2IXS4fyk5nnuox0Ak,4721
+aiohttp/helpers.py,sha256=Zx9sbxHNJGVOyTzjBEcZ6kOZwn_6g8hD5cej4Jb9Yx0,32017
+aiohttp/http.py,sha256=DGKcwDbgIMpasv7s2jeKCRuixyj7W-RIrihRFjj0xcY,1914
+aiohttp/http_exceptions.py,sha256=GJYn38j4sI4KdUh993VnZlbgVHOUNI_Z9-ASDTjl5aU,2822
+aiohttp/http_parser.py,sha256=V-CWgfz6PI1QRM_7TjT8O3SNHTBi3lGzDCiQHLl7n74,37548
+aiohttp/http_websocket.py,sha256=eM8wkn12fCF2vV-Zm7ITxQsG7hOdRHeD8PF6NPmJpsQ,27472
+aiohttp/http_writer.py,sha256=p8H39HhtilQEE90njvtJHc94Am95zjHNoS8T1JcNXJc,6131
+aiohttp/locks.py,sha256=vp1Z4zx0SvooSffw88dkZ-7qpk2CqRf5vWh2dpKagTA,1177
+aiohttp/log.py,sha256=zYUTvXsMQ9Sz1yNN8kXwd5Qxu49a1FzjZ_wQqriEc8M,333
+aiohttp/multipart.py,sha256=N3WiFX-46QvCijk3KtpHCJnuJRGWiHYnLJDiQ6Mf4QA,35952
+aiohttp/payload.py,sha256=Ap0E4_p1d9E2UTTIYmBe5HXz05Tt7TN5nZ2zfYDtkr0,14005
+aiohttp/payload_streamer.py,sha256=rBb3jAFcwAK1QOgbhya2y4zGjhT11oQrepdcffA1_jM,2162
+aiohttp/py.typed,sha256=3VVwXUAWVEVX7sDwyYDnW5ZdBC9_Z9AJAFfLCleUW0k,8
+aiohttp/pytest_plugin.py,sha256=fJxoTu3NI1wDjFIV1FDmx0oGdRU7r6baovTwJneR6J4,11986
+aiohttp/resolver.py,sha256=k5cVNWiiCHqKDGko7UZNu2y-j6SrU7vQBx-omwHPhso,5230
+aiohttp/streams.py,sha256=v9GkCFn9mynR1yGB1Xl6mwxEJXsOC4T-DzoL4IC0XOU,21812
+aiohttp/tcp_helpers.py,sha256=K-hhGh3jd6qCEnHJo8LvFyfJwBjh99UKI7A0aSRVhj4,998
+aiohttp/test_utils.py,sha256=q3NaqC9-lC-9smmXloLwfpB5tC_e20thC3LarO5lddk,21157
+aiohttp/tracing.py,sha256=0EccU7PYykvNwd75SNFcuQ1I57RdSu2jDYIvNK2BW6c,15603
+aiohttp/typedefs.py,sha256=x7HBHDU2IlRZZb7ketOdc2Js0MLx53agxk0UnLxNFw4,1525
+aiohttp/web.py,sha256=8rghTkpERz14vRQA4oyXfGZLWMIBMrrHXxcvtZZ_fAU,19879
+aiohttp/web_app.py,sha256=0bajIxV0xb5AB9TChRsoVP8ytTLiY_TU7zrQ66GHNus,18907
+aiohttp/web_exceptions.py,sha256=itNRhCMDJFhnMWftr5SyTsoqh-i0n9rzTj0sjcAEUjo,10812
+aiohttp/web_fileresponse.py,sha256=4ddU695Y4w1reMFqqpuxbJQ9vF0XEG7HsCDl930qsRs,11874
+aiohttp/web_log.py,sha256=w81HIudhfSxfodo2Fjkok7jWT56XXIrVMJN6ihYnLo0,8014
+aiohttp/web_middlewares.py,sha256=rYWtxDZ2AM3C2FvNuNyffpfmMfcHrxkSZMaTcsG1T_Q,4148
+aiohttp/web_protocol.py,sha256=6YU4IsJldwoi8SZQ3dp-fHi3TdljwW2uRRj4BgTdfSU,23758
+aiohttp/web_request.py,sha256=b67jMnKemnPjCX2MloT_U4IP5ILM6nWABItbK5gWR30,29887
+aiohttp/web_response.py,sha256=HNzl7eOOI1TR6Kfd30sQIinJXWWhVHM19YUdZvEbmFs,28677
+aiohttp/web_routedef.py,sha256=7ZribqwusXb1s0T2vLj1roFne1fdz_ZsudBwRyiwQxM,6348
+aiohttp/web_runner.py,sha256=Oled_t6ma3qQ6f9xOWv_8jgt0tl-dvhvEG09ms83rQk,12360
+aiohttp/web_server.py,sha256=kOlImrScEbvkGHG7i-N-7eqf55f2zC_J2BZcJanGGmU,2664
+aiohttp/web_urldispatcher.py,sha256=4URDODVtRTsEbjjJb-wX0FhoJ7T5nhrJFz8NpEP9gb4,41366
+aiohttp/web_ws.py,sha256=77sl9-DZGXZ01BaU0nJfTn9gQ9B8Ps0XY7kK8n3u_SU,19499
+aiohttp/worker.py,sha256=vDMxlk-Mo3rzN4yubw2-c8T6yg7PRY8Mv0NLuRm8lWw,8212
diff --git a/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/WHEEL b/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..d111766f66e4cd0e45f15c92ed470f34c8f3434c
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: false
+Tag: cp311-cp311-win_amd64
+
diff --git a/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/top_level.txt b/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..ee4ba4f3d739e094878215c84eb41ba85c80e4a8
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp-3.9.5.dist-info/top_level.txt
@@ -0,0 +1 @@
+aiohttp
diff --git a/llm/Lib/site-packages/aiohttp/.hash/_cparser.pxd.hash b/llm/Lib/site-packages/aiohttp/.hash/_cparser.pxd.hash
new file mode 100644
index 0000000000000000000000000000000000000000..1dc9b9a49e79ff6252bfcef9d1a923925533f5b6
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/.hash/_cparser.pxd.hash
@@ -0,0 +1 @@
+5baf9cbb44b21e13843de6f8ef936fc5a810d49cfda56ab2649bf012a4cb36cd
\ No newline at end of file
diff --git a/llm/Lib/site-packages/aiohttp/.hash/_find_header.pxd.hash b/llm/Lib/site-packages/aiohttp/.hash/_find_header.pxd.hash
new file mode 100644
index 0000000000000000000000000000000000000000..ab9d476577b82ff8744b6acaf7b9b315d9057296
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/.hash/_find_header.pxd.hash
@@ -0,0 +1 @@
+0455129b185e981b5b96ac738f31f7c74dc57f1696953cae0083b3f18679fe73
\ No newline at end of file
diff --git a/llm/Lib/site-packages/aiohttp/.hash/_helpers.pyi.hash b/llm/Lib/site-packages/aiohttp/.hash/_helpers.pyi.hash
new file mode 100644
index 0000000000000000000000000000000000000000..c304d37499171f02314aa886217d9973902af22f
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/.hash/_helpers.pyi.hash
@@ -0,0 +1 @@
+d87779202d197f8613109e35dacbb2ca1b21d64572543bf9838b2d832a362ac7
\ No newline at end of file
diff --git a/llm/Lib/site-packages/aiohttp/.hash/_helpers.pyx.hash b/llm/Lib/site-packages/aiohttp/.hash/_helpers.pyx.hash
new file mode 100644
index 0000000000000000000000000000000000000000..8164dbb55e2cc59eb36e46334419e7501be1a10b
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/.hash/_helpers.pyx.hash
@@ -0,0 +1 @@
+b6097b7d987440c4fa7237f88d227c89a3ba0dd403dc638ddbe487e0de7f1138
\ No newline at end of file
diff --git a/llm/Lib/site-packages/aiohttp/.hash/_http_parser.pyx.hash b/llm/Lib/site-packages/aiohttp/.hash/_http_parser.pyx.hash
new file mode 100644
index 0000000000000000000000000000000000000000..169d66d01b52acd26f1285dc0bb97f7d581946b7
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/.hash/_http_parser.pyx.hash
@@ -0,0 +1 @@
+4807a7440f51cd8e406955969ecfecf4331b66554780a944c8b80f42f51c4dbd
\ No newline at end of file
diff --git a/llm/Lib/site-packages/aiohttp/.hash/_http_writer.pyx.hash b/llm/Lib/site-packages/aiohttp/.hash/_http_writer.pyx.hash
new file mode 100644
index 0000000000000000000000000000000000000000..10d83475cc21f7ad1fe1340720add4ac47e00f3e
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/.hash/_http_writer.pyx.hash
@@ -0,0 +1 @@
+f0204bcad3b6af1d6476959ef47612ce784b5dd7995b213edf123b8da19ab1a8
\ No newline at end of file
diff --git a/llm/Lib/site-packages/aiohttp/.hash/_websocket.pyx.hash b/llm/Lib/site-packages/aiohttp/.hash/_websocket.pyx.hash
new file mode 100644
index 0000000000000000000000000000000000000000..511f26f901f0e33c38202e3d5d11666d2e09b5cd
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/.hash/_websocket.pyx.hash
@@ -0,0 +1 @@
+a3d27bca2f5cdbe8d3063137754917c610d62af456273e4665fc8bb202506b7f
\ No newline at end of file
diff --git a/llm/Lib/site-packages/aiohttp/.hash/hdrs.py.hash b/llm/Lib/site-packages/aiohttp/.hash/hdrs.py.hash
new file mode 100644
index 0000000000000000000000000000000000000000..b032e6e9a8e9a22c93a3ea8cf81526c811c2391a
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/.hash/hdrs.py.hash
@@ -0,0 +1 @@
+fc937830113e5280571961a84822a122f89345cd885d2e1fca4e679eea31d009
\ No newline at end of file
diff --git a/llm/Lib/site-packages/aiohttp/__init__.py b/llm/Lib/site-packages/aiohttp/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..07a0b25a8d8b602d6d2ad646e6149510f1ba0082
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/__init__.py
@@ -0,0 +1,240 @@
+__version__ = "3.9.5"
+
+from typing import TYPE_CHECKING, Tuple
+
+from . import hdrs as hdrs
+from .client import (
+    BaseConnector as BaseConnector,
+    ClientConnectionError as ClientConnectionError,
+    ClientConnectorCertificateError as ClientConnectorCertificateError,
+    ClientConnectorError as ClientConnectorError,
+    ClientConnectorSSLError as ClientConnectorSSLError,
+    ClientError as ClientError,
+    ClientHttpProxyError as ClientHttpProxyError,
+    ClientOSError as ClientOSError,
+    ClientPayloadError as ClientPayloadError,
+    ClientProxyConnectionError as ClientProxyConnectionError,
+    ClientRequest as ClientRequest,
+    ClientResponse as ClientResponse,
+    ClientResponseError as ClientResponseError,
+    ClientSession as ClientSession,
+    ClientSSLError as ClientSSLError,
+    ClientTimeout as ClientTimeout,
+    ClientWebSocketResponse as ClientWebSocketResponse,
+    ContentTypeError as ContentTypeError,
+    Fingerprint as Fingerprint,
+    InvalidURL as InvalidURL,
+    NamedPipeConnector as NamedPipeConnector,
+    RequestInfo as RequestInfo,
+    ServerConnectionError as ServerConnectionError,
+    ServerDisconnectedError as ServerDisconnectedError,
+    ServerFingerprintMismatch as ServerFingerprintMismatch,
+    ServerTimeoutError as ServerTimeoutError,
+    TCPConnector as TCPConnector,
+    TooManyRedirects as TooManyRedirects,
+    UnixConnector as UnixConnector,
+    WSServerHandshakeError as WSServerHandshakeError,
+    request as request,
+)
+from .cookiejar import CookieJar as CookieJar, DummyCookieJar as DummyCookieJar
+from .formdata import FormData as FormData
+from .helpers import BasicAuth, ChainMapProxy, ETag
+from .http import (
+    HttpVersion as HttpVersion,
+    HttpVersion10 as HttpVersion10,
+    HttpVersion11 as HttpVersion11,
+    WebSocketError as WebSocketError,
+    WSCloseCode as WSCloseCode,
+    WSMessage as WSMessage,
+    WSMsgType as WSMsgType,
+)
+from .multipart import (
+    BadContentDispositionHeader as BadContentDispositionHeader,
+    BadContentDispositionParam as BadContentDispositionParam,
+    BodyPartReader as BodyPartReader,
+    MultipartReader as MultipartReader,
+    MultipartWriter as MultipartWriter,
+    content_disposition_filename as content_disposition_filename,
+    parse_content_disposition as parse_content_disposition,
+)
+from .payload import (
+    PAYLOAD_REGISTRY as PAYLOAD_REGISTRY,
+    AsyncIterablePayload as AsyncIterablePayload,
+    BufferedReaderPayload as BufferedReaderPayload,
+    BytesIOPayload as BytesIOPayload,
+    BytesPayload as BytesPayload,
+    IOBasePayload as IOBasePayload,
+    JsonPayload as JsonPayload,
+    Payload as Payload,
+    StringIOPayload as StringIOPayload,
+    StringPayload as StringPayload,
+    TextIOPayload as TextIOPayload,
+    get_payload as get_payload,
+    payload_type as payload_type,
+)
+from .payload_streamer import streamer as streamer
+from .resolver import (
+    AsyncResolver as AsyncResolver,
+    DefaultResolver as DefaultResolver,
+    ThreadedResolver as ThreadedResolver,
+)
+from .streams import (
+    EMPTY_PAYLOAD as EMPTY_PAYLOAD,
+    DataQueue as DataQueue,
+    EofStream as EofStream,
+    FlowControlDataQueue as FlowControlDataQueue,
+    StreamReader as StreamReader,
+)
+from .tracing import (
+    TraceConfig as TraceConfig,
+    TraceConnectionCreateEndParams as TraceConnectionCreateEndParams,
+    TraceConnectionCreateStartParams as TraceConnectionCreateStartParams,
+    TraceConnectionQueuedEndParams as TraceConnectionQueuedEndParams,
+    TraceConnectionQueuedStartParams as TraceConnectionQueuedStartParams,
+    TraceConnectionReuseconnParams as TraceConnectionReuseconnParams,
+    TraceDnsCacheHitParams as TraceDnsCacheHitParams,
+    TraceDnsCacheMissParams as TraceDnsCacheMissParams,
+    TraceDnsResolveHostEndParams as TraceDnsResolveHostEndParams,
+    TraceDnsResolveHostStartParams as TraceDnsResolveHostStartParams,
+    TraceRequestChunkSentParams as TraceRequestChunkSentParams,
+    TraceRequestEndParams as TraceRequestEndParams,
+    TraceRequestExceptionParams as TraceRequestExceptionParams,
+    TraceRequestRedirectParams as TraceRequestRedirectParams,
+    TraceRequestStartParams as TraceRequestStartParams,
+    TraceResponseChunkReceivedParams as TraceResponseChunkReceivedParams,
+)
+
+if TYPE_CHECKING:
+    # At runtime these are lazy-loaded at the bottom of the file.
+    from .worker import (
+        GunicornUVLoopWebWorker as GunicornUVLoopWebWorker,
+        GunicornWebWorker as GunicornWebWorker,
+    )
+
+__all__: Tuple[str, ...] = (
+    "hdrs",
+    # client
+    "BaseConnector",
+    "ClientConnectionError",
+    "ClientConnectorCertificateError",
+    "ClientConnectorError",
+    "ClientConnectorSSLError",
+    "ClientError",
+    "ClientHttpProxyError",
+    "ClientOSError",
+    "ClientPayloadError",
+    "ClientProxyConnectionError",
+    "ClientResponse",
+    "ClientRequest",
+    "ClientResponseError",
+    "ClientSSLError",
+    "ClientSession",
+    "ClientTimeout",
+    "ClientWebSocketResponse",
+    "ContentTypeError",
+    "Fingerprint",
+    "InvalidURL",
+    "RequestInfo",
+    "ServerConnectionError",
+    "ServerDisconnectedError",
+    "ServerFingerprintMismatch",
+    "ServerTimeoutError",
+    "TCPConnector",
+    "TooManyRedirects",
+    "UnixConnector",
+    "NamedPipeConnector",
+    "WSServerHandshakeError",
+    "request",
+    # cookiejar
+    "CookieJar",
+    "DummyCookieJar",
+    # formdata
+    "FormData",
+    # helpers
+    "BasicAuth",
+    "ChainMapProxy",
+    "ETag",
+    # http
+    "HttpVersion",
+    "HttpVersion10",
+    "HttpVersion11",
+    "WSMsgType",
+    "WSCloseCode",
+    "WSMessage",
+    "WebSocketError",
+    # multipart
+    "BadContentDispositionHeader",
+    "BadContentDispositionParam",
+    "BodyPartReader",
+    "MultipartReader",
+    "MultipartWriter",
+    "content_disposition_filename",
+    "parse_content_disposition",
+    # payload
+    "AsyncIterablePayload",
+    "BufferedReaderPayload",
+    "BytesIOPayload",
+    "BytesPayload",
+    "IOBasePayload",
+    "JsonPayload",
+    "PAYLOAD_REGISTRY",
+    "Payload",
+    "StringIOPayload",
+    "StringPayload",
+    "TextIOPayload",
+    "get_payload",
+    "payload_type",
+    # payload_streamer
+    "streamer",
+    # resolver
+    "AsyncResolver",
+    "DefaultResolver",
+    "ThreadedResolver",
+    # streams
+    "DataQueue",
+    "EMPTY_PAYLOAD",
+    "EofStream",
+    "FlowControlDataQueue",
+    "StreamReader",
+    # tracing
+    "TraceConfig",
+    "TraceConnectionCreateEndParams",
+    "TraceConnectionCreateStartParams",
+    "TraceConnectionQueuedEndParams",
+    "TraceConnectionQueuedStartParams",
+    "TraceConnectionReuseconnParams",
+    "TraceDnsCacheHitParams",
+    "TraceDnsCacheMissParams",
+    "TraceDnsResolveHostEndParams",
+    "TraceDnsResolveHostStartParams",
+    "TraceRequestChunkSentParams",
+    "TraceRequestEndParams",
+    "TraceRequestExceptionParams",
+    "TraceRequestRedirectParams",
+    "TraceRequestStartParams",
+    "TraceResponseChunkReceivedParams",
+    # workers (imported lazily with __getattr__)
+    "GunicornUVLoopWebWorker",
+    "GunicornWebWorker",
+)
+
+
+def __dir__() -> Tuple[str, ...]:
+    return __all__ + ("__author__", "__doc__")
+
+
+def __getattr__(name: str) -> object:
+    global GunicornUVLoopWebWorker, GunicornWebWorker
+
+    # Importing gunicorn takes a long time (>100ms), so only import if actually needed.
+    if name in ("GunicornUVLoopWebWorker", "GunicornWebWorker"):
+        try:
+            from .worker import GunicornUVLoopWebWorker as guv, GunicornWebWorker as gw
+        except ImportError:
+            return None
+
+        GunicornUVLoopWebWorker = guv  # type: ignore[misc]
+        GunicornWebWorker = gw  # type: ignore[misc]
+        return guv if name == "GunicornUVLoopWebWorker" else gw
+
+    raise AttributeError(f"module {__name__} has no attribute {name}")
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3dbf5fc2608102ed065ae01f466f5d664a593262
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/abc.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/abc.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f074f8f8db437bbf93058d287c60ebe89f423332
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/abc.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/base_protocol.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/base_protocol.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9199dd055b29ed96b1763b96da179e37824906e3
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/base_protocol.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/client.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/client.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ec1aec15e293783438554af7ccecddc0e45e657b
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/client.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/client_exceptions.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/client_exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ce8003bb1d152afe802f61298b1435b50a67ffac
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/client_exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/client_proto.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/client_proto.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..20fb5337d315ac89197d6db52171bed891b02a24
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/client_proto.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/client_reqrep.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/client_reqrep.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0a39e7496d8b89bf72d21c7dff02e66e32e5133a
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/client_reqrep.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/client_ws.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/client_ws.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..687dd4f0910d19d21ab5e5a0cbcec695489203ab
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/client_ws.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/compression_utils.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/compression_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..191384c946a2f0b28518d65772619fe97d2a117f
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/compression_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/connector.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/connector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..03028c1cd173ffba56aef37cededd87a11fcc501
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/connector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/cookiejar.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/cookiejar.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..70eaca988f63bee5828b94efbf147a01b01cc23f
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/cookiejar.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/formdata.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/formdata.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c34141e8f70ece297cbd6970129f68a3dacd5d6f
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/formdata.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/hdrs.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/hdrs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a935795177de1ba395a5d11f23ba3de65042054a
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/hdrs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/helpers.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/helpers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7a16a5f4dae942cab772d5efb3e9c49758e074f8
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/helpers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/http.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/http.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ab6fe41a81b632a303a6e1633328b4ea770d0646
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/http.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/http_exceptions.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/http_exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..169367442a78aba631d6fba6d285dde2ac49d940
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/http_exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/http_parser.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/http_parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..96b515f1670973212a1541e53b6a8d3c6dd94bf4
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/http_parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/http_websocket.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/http_websocket.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e0b020eb60de82e5c186e2ca69ac5865eab225fd
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/http_websocket.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/http_writer.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/http_writer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0cb29ef827b51c54b12072c05984a3ef3c763c8f
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/http_writer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/locks.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/locks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6f98679d0fa245784b1ad73ebfa4c9e17a0b65cf
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/locks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/log.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/log.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4d8703f5f46d5d41cff4129a3808f9c36da63db9
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/log.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/multipart.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/multipart.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..14c953c790081b953dcedb02db324647e8669f33
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/multipart.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/payload.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/payload.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..af9373ff543f3a08c3f1e6ab207f3f644771d63a
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/payload.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/payload_streamer.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/payload_streamer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7c56594407980bff6ddaa69ba112a5639cc8428b
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/payload_streamer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/pytest_plugin.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/pytest_plugin.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..331143df54a2eeb79f5cb4ccb4ccb465e2fbfdb2
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/pytest_plugin.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/resolver.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/resolver.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6ee50ca157811e7de8d9ca80e755c2c4f2ec2dd2
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/resolver.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/streams.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/streams.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3d26edb932839889f0cf3c5c3e0fed5b1e0cc4b1
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/streams.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/tcp_helpers.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/tcp_helpers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6dbdb81d7683c2219562bb2e35debe554dc6cc64
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/tcp_helpers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/test_utils.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/test_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..831a900818c2b5472e0269e1a7af2059124de6b5
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/test_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/tracing.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/tracing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3dd1a8015be4534a16a982a5c41bdea59374c2aa
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/tracing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/typedefs.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/typedefs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6feaa9400d884792dd67d54eb5ad508e22ff9c6c
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/typedefs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..988ff714747358a9b17fb256a8741bb9ba37672a
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web_app.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web_app.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..071ea467073a999b78c9c7faa7e28e456f941aa0
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web_app.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web_exceptions.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web_exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1287d812d166801d9d3f49a80945f4905643a76b
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web_exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web_fileresponse.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web_fileresponse.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cd431017cfbcb05963e499e2369d38de5465c303
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web_fileresponse.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web_log.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web_log.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f3dc224770dc11d76be32b20f988d4cba818e188
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web_log.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web_middlewares.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web_middlewares.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cb7a1b4aeece52354926fe5847653e82655d80c7
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web_middlewares.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web_protocol.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web_protocol.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f029074b79eb19fbb8c9050a60e402ec6ab4d760
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web_protocol.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web_request.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web_request.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b9d7e144b9df6cabf64baf2a47b64416bef95968
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web_request.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web_response.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web_response.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6dbc0d0b88fc8eb3b8c1d34bd87580e32b0d6082
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web_response.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web_routedef.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web_routedef.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f695aa7bb7c32942d190be4375ff871f2bd3519b
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web_routedef.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web_runner.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web_runner.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0bdb0811ff7b8c13345f4fdc9662b333c101f26b
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web_runner.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web_server.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web_server.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0509266ab91a14ee7d515447f6db96d6398c5bb3
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web_server.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web_urldispatcher.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web_urldispatcher.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0347ae582b952e3556fcc19bbca7bc70542bd07f
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web_urldispatcher.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/web_ws.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/web_ws.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..970329a54477986f24f59f27506b96e437a0a6fc
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/web_ws.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/__pycache__/worker.cpython-311.pyc b/llm/Lib/site-packages/aiohttp/__pycache__/worker.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fb64d7b48301dbdba4a3aa2e9ff52e7ee4588a17
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/__pycache__/worker.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiohttp/_cparser.pxd b/llm/Lib/site-packages/aiohttp/_cparser.pxd
new file mode 100644
index 0000000000000000000000000000000000000000..a4783837fc157e784d41e0c9093bfb40df488aa7
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/_cparser.pxd
@@ -0,0 +1,158 @@
+from libc.stdint cimport int32_t, uint8_t, uint16_t, uint64_t
+
+
+cdef extern from "../vendor/llhttp/build/llhttp.h":
+
+    struct llhttp__internal_s:
+        int32_t _index
+        void* _span_pos0
+        void* _span_cb0
+        int32_t error
+        const char* reason
+        const char* error_pos
+        void* data
+        void* _current
+        uint64_t content_length
+        uint8_t type
+        uint8_t method
+        uint8_t http_major
+        uint8_t http_minor
+        uint8_t header_state
+        uint8_t lenient_flags
+        uint8_t upgrade
+        uint8_t finish
+        uint16_t flags
+        uint16_t status_code
+        void* settings
+
+    ctypedef llhttp__internal_s llhttp__internal_t
+    ctypedef llhttp__internal_t llhttp_t
+
+    ctypedef int (*llhttp_data_cb)(llhttp_t*, const char *at, size_t length) except -1
+    ctypedef int (*llhttp_cb)(llhttp_t*) except -1
+
+    struct llhttp_settings_s:
+        llhttp_cb      on_message_begin
+        llhttp_data_cb on_url
+        llhttp_data_cb on_status
+        llhttp_data_cb on_header_field
+        llhttp_data_cb on_header_value
+        llhttp_cb      on_headers_complete
+        llhttp_data_cb on_body
+        llhttp_cb      on_message_complete
+        llhttp_cb      on_chunk_header
+        llhttp_cb      on_chunk_complete
+
+        llhttp_cb      on_url_complete
+        llhttp_cb      on_status_complete
+        llhttp_cb      on_header_field_complete
+        llhttp_cb      on_header_value_complete
+
+    ctypedef llhttp_settings_s llhttp_settings_t
+
+    enum llhttp_errno:
+        HPE_OK,
+        HPE_INTERNAL,
+        HPE_STRICT,
+        HPE_LF_EXPECTED,
+        HPE_UNEXPECTED_CONTENT_LENGTH,
+        HPE_CLOSED_CONNECTION,
+        HPE_INVALID_METHOD,
+        HPE_INVALID_URL,
+        HPE_INVALID_CONSTANT,
+        HPE_INVALID_VERSION,
+        HPE_INVALID_HEADER_TOKEN,
+        HPE_INVALID_CONTENT_LENGTH,
+        HPE_INVALID_CHUNK_SIZE,
+        HPE_INVALID_STATUS,
+        HPE_INVALID_EOF_STATE,
+        HPE_INVALID_TRANSFER_ENCODING,
+        HPE_CB_MESSAGE_BEGIN,
+        HPE_CB_HEADERS_COMPLETE,
+        HPE_CB_MESSAGE_COMPLETE,
+        HPE_CB_CHUNK_HEADER,
+        HPE_CB_CHUNK_COMPLETE,
+        HPE_PAUSED,
+        HPE_PAUSED_UPGRADE,
+        HPE_USER
+
+    ctypedef llhttp_errno llhttp_errno_t
+
+    enum llhttp_flags:
+        F_CHUNKED,
+        F_CONTENT_LENGTH
+
+    enum llhttp_type:
+        HTTP_REQUEST,
+        HTTP_RESPONSE,
+        HTTP_BOTH
+
+    enum llhttp_method:
+        HTTP_DELETE,
+        HTTP_GET,
+        HTTP_HEAD,
+        HTTP_POST,
+        HTTP_PUT,
+        HTTP_CONNECT,
+        HTTP_OPTIONS,
+        HTTP_TRACE,
+        HTTP_COPY,
+        HTTP_LOCK,
+        HTTP_MKCOL,
+        HTTP_MOVE,
+        HTTP_PROPFIND,
+        HTTP_PROPPATCH,
+        HTTP_SEARCH,
+        HTTP_UNLOCK,
+        HTTP_BIND,
+        HTTP_REBIND,
+        HTTP_UNBIND,
+        HTTP_ACL,
+        HTTP_REPORT,
+        HTTP_MKACTIVITY,
+        HTTP_CHECKOUT,
+        HTTP_MERGE,
+        HTTP_MSEARCH,
+        HTTP_NOTIFY,
+        HTTP_SUBSCRIBE,
+        HTTP_UNSUBSCRIBE,
+        HTTP_PATCH,
+        HTTP_PURGE,
+        HTTP_MKCALENDAR,
+        HTTP_LINK,
+        HTTP_UNLINK,
+        HTTP_SOURCE,
+        HTTP_PRI,
+        HTTP_DESCRIBE,
+        HTTP_ANNOUNCE,
+        HTTP_SETUP,
+        HTTP_PLAY,
+        HTTP_PAUSE,
+        HTTP_TEARDOWN,
+        HTTP_GET_PARAMETER,
+        HTTP_SET_PARAMETER,
+        HTTP_REDIRECT,
+        HTTP_RECORD,
+        HTTP_FLUSH
+
+    ctypedef llhttp_method llhttp_method_t;
+
+    void llhttp_settings_init(llhttp_settings_t* settings)
+    void llhttp_init(llhttp_t* parser, llhttp_type type,
+                 const llhttp_settings_t* settings)
+
+    llhttp_errno_t llhttp_execute(llhttp_t* parser, const char* data, size_t len)
+
+    int llhttp_should_keep_alive(const llhttp_t* parser)
+
+    void llhttp_resume_after_upgrade(llhttp_t* parser)
+
+    llhttp_errno_t llhttp_get_errno(const llhttp_t* parser)
+    const char* llhttp_get_error_reason(const llhttp_t* parser)
+    const char* llhttp_get_error_pos(const llhttp_t* parser)
+
+    const char* llhttp_method_name(llhttp_method_t method)
+
+    void llhttp_set_lenient_headers(llhttp_t* parser, int enabled)
+    void llhttp_set_lenient_optional_cr_before_lf(llhttp_t* parser, int enabled)
+    void llhttp_set_lenient_spaces_after_chunk_size(llhttp_t* parser, int enabled)
diff --git a/llm/Lib/site-packages/aiohttp/_find_header.pxd b/llm/Lib/site-packages/aiohttp/_find_header.pxd
new file mode 100644
index 0000000000000000000000000000000000000000..9305cb61da27a827c280b3c7ea3ca65e96c8793b
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/_find_header.pxd
@@ -0,0 +1,2 @@
+cdef extern from "_find_header.h":
+    int find_header(char *, int)
diff --git a/llm/Lib/site-packages/aiohttp/_headers.pxi b/llm/Lib/site-packages/aiohttp/_headers.pxi
new file mode 100644
index 0000000000000000000000000000000000000000..45c50f15e8c5e77996bf29315c13027b7b8f66ef
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/_headers.pxi
@@ -0,0 +1,83 @@
+# The file is autogenerated from aiohttp/hdrs.py
+# Run ./tools/gen.py to update it after the origin changing.
+
+from . import hdrs
+cdef tuple headers = (
+    hdrs.ACCEPT,
+    hdrs.ACCEPT_CHARSET,
+    hdrs.ACCEPT_ENCODING,
+    hdrs.ACCEPT_LANGUAGE,
+    hdrs.ACCEPT_RANGES,
+    hdrs.ACCESS_CONTROL_ALLOW_CREDENTIALS,
+    hdrs.ACCESS_CONTROL_ALLOW_HEADERS,
+    hdrs.ACCESS_CONTROL_ALLOW_METHODS,
+    hdrs.ACCESS_CONTROL_ALLOW_ORIGIN,
+    hdrs.ACCESS_CONTROL_EXPOSE_HEADERS,
+    hdrs.ACCESS_CONTROL_MAX_AGE,
+    hdrs.ACCESS_CONTROL_REQUEST_HEADERS,
+    hdrs.ACCESS_CONTROL_REQUEST_METHOD,
+    hdrs.AGE,
+    hdrs.ALLOW,
+    hdrs.AUTHORIZATION,
+    hdrs.CACHE_CONTROL,
+    hdrs.CONNECTION,
+    hdrs.CONTENT_DISPOSITION,
+    hdrs.CONTENT_ENCODING,
+    hdrs.CONTENT_LANGUAGE,
+    hdrs.CONTENT_LENGTH,
+    hdrs.CONTENT_LOCATION,
+    hdrs.CONTENT_MD5,
+    hdrs.CONTENT_RANGE,
+    hdrs.CONTENT_TRANSFER_ENCODING,
+    hdrs.CONTENT_TYPE,
+    hdrs.COOKIE,
+    hdrs.DATE,
+    hdrs.DESTINATION,
+    hdrs.DIGEST,
+    hdrs.ETAG,
+    hdrs.EXPECT,
+    hdrs.EXPIRES,
+    hdrs.FORWARDED,
+    hdrs.FROM,
+    hdrs.HOST,
+    hdrs.IF_MATCH,
+    hdrs.IF_MODIFIED_SINCE,
+    hdrs.IF_NONE_MATCH,
+    hdrs.IF_RANGE,
+    hdrs.IF_UNMODIFIED_SINCE,
+    hdrs.KEEP_ALIVE,
+    hdrs.LAST_EVENT_ID,
+    hdrs.LAST_MODIFIED,
+    hdrs.LINK,
+    hdrs.LOCATION,
+    hdrs.MAX_FORWARDS,
+    hdrs.ORIGIN,
+    hdrs.PRAGMA,
+    hdrs.PROXY_AUTHENTICATE,
+    hdrs.PROXY_AUTHORIZATION,
+    hdrs.RANGE,
+    hdrs.REFERER,
+    hdrs.RETRY_AFTER,
+    hdrs.SEC_WEBSOCKET_ACCEPT,
+    hdrs.SEC_WEBSOCKET_EXTENSIONS,
+    hdrs.SEC_WEBSOCKET_KEY,
+    hdrs.SEC_WEBSOCKET_KEY1,
+    hdrs.SEC_WEBSOCKET_PROTOCOL,
+    hdrs.SEC_WEBSOCKET_VERSION,
+    hdrs.SERVER,
+    hdrs.SET_COOKIE,
+    hdrs.TE,
+    hdrs.TRAILER,
+    hdrs.TRANSFER_ENCODING,
+    hdrs.URI,
+    hdrs.UPGRADE,
+    hdrs.USER_AGENT,
+    hdrs.VARY,
+    hdrs.VIA,
+    hdrs.WWW_AUTHENTICATE,
+    hdrs.WANT_DIGEST,
+    hdrs.WARNING,
+    hdrs.X_FORWARDED_FOR,
+    hdrs.X_FORWARDED_HOST,
+    hdrs.X_FORWARDED_PROTO,
+)
diff --git a/llm/Lib/site-packages/aiohttp/_helpers.cp311-win_amd64.pyd b/llm/Lib/site-packages/aiohttp/_helpers.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..983e43c027c946ca7f9990aa0ea5e9977cf77d29
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/_helpers.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/aiohttp/_helpers.pyi b/llm/Lib/site-packages/aiohttp/_helpers.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..6dda40d032ab4c1f6b85c9d6d52b79c020875e67
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/_helpers.pyi
@@ -0,0 +1,6 @@
+from typing import Any
+
+class reify:
+    def __init__(self, wrapped: Any) -> None: ...
+    def __get__(self, inst: Any, owner: Any) -> Any: ...
+    def __set__(self, inst: Any, value: Any) -> None: ...
diff --git a/llm/Lib/site-packages/aiohttp/_helpers.pyx b/llm/Lib/site-packages/aiohttp/_helpers.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..cccb332cea6ed9eeab585a0c632e7a67f700973a
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/_helpers.pyx
@@ -0,0 +1,35 @@
+cdef class reify:
+    """Use as a class method decorator.  It operates almost exactly like
+    the Python `@property` decorator, but it puts the result of the
+    method it decorates into the instance dict after the first call,
+    effectively replacing the function it decorates with an instance
+    variable.  It is, in Python parlance, a data descriptor.
+
+    """
+
+    cdef object wrapped
+    cdef object name
+
+    def __init__(self, wrapped):
+        self.wrapped = wrapped
+        self.name = wrapped.__name__
+
+    @property
+    def __doc__(self):
+        return self.wrapped.__doc__
+
+    def __get__(self, inst, owner):
+        try:
+            try:
+                return inst._cache[self.name]
+            except KeyError:
+                val = self.wrapped(inst)
+                inst._cache[self.name] = val
+                return val
+        except AttributeError:
+            if inst is None:
+                return self
+            raise
+
+    def __set__(self, inst, value):
+        raise AttributeError("reified property is read-only")
diff --git a/llm/Lib/site-packages/aiohttp/_http_parser.cp311-win_amd64.pyd b/llm/Lib/site-packages/aiohttp/_http_parser.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..f30bacadde3c4d4ab5314329ff375a9b73cd8a74
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/_http_parser.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/aiohttp/_http_parser.pyx b/llm/Lib/site-packages/aiohttp/_http_parser.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..17c6fcdcf92269a02d600b61042fff905c935d68
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/_http_parser.pyx
@@ -0,0 +1,838 @@
+#cython: language_level=3
+#
+# Based on https://github.com/MagicStack/httptools
+#
+
+from cpython cimport (
+    Py_buffer,
+    PyBUF_SIMPLE,
+    PyBuffer_Release,
+    PyBytes_AsString,
+    PyBytes_AsStringAndSize,
+    PyObject_GetBuffer,
+)
+from cpython.mem cimport PyMem_Free, PyMem_Malloc
+from libc.limits cimport ULLONG_MAX
+from libc.string cimport memcpy
+
+from multidict import CIMultiDict as _CIMultiDict, CIMultiDictProxy as _CIMultiDictProxy
+from yarl import URL as _URL
+
+from aiohttp import hdrs
+from aiohttp.helpers import DEBUG, set_exception
+
+from .http_exceptions import (
+    BadHttpMessage,
+    BadStatusLine,
+    ContentLengthError,
+    InvalidHeader,
+    InvalidURLError,
+    LineTooLong,
+    PayloadEncodingError,
+    TransferEncodingError,
+)
+from .http_parser import DeflateBuffer as _DeflateBuffer
+from .http_writer import (
+    HttpVersion as _HttpVersion,
+    HttpVersion10 as _HttpVersion10,
+    HttpVersion11 as _HttpVersion11,
+)
+from .streams import EMPTY_PAYLOAD as _EMPTY_PAYLOAD, StreamReader as _StreamReader
+
+cimport cython
+
+from aiohttp cimport _cparser as cparser
+
+include "_headers.pxi"
+
+from aiohttp cimport _find_header
+
+DEF DEFAULT_FREELIST_SIZE = 250
+
+cdef extern from "Python.h":
+    int PyByteArray_Resize(object, Py_ssize_t) except -1
+    Py_ssize_t PyByteArray_Size(object) except -1
+    char* PyByteArray_AsString(object)
+
+__all__ = ('HttpRequestParser', 'HttpResponseParser',
+           'RawRequestMessage', 'RawResponseMessage')
+
+cdef object URL = _URL
+cdef object URL_build = URL.build
+cdef object CIMultiDict = _CIMultiDict
+cdef object CIMultiDictProxy = _CIMultiDictProxy
+cdef object HttpVersion = _HttpVersion
+cdef object HttpVersion10 = _HttpVersion10
+cdef object HttpVersion11 = _HttpVersion11
+cdef object SEC_WEBSOCKET_KEY1 = hdrs.SEC_WEBSOCKET_KEY1
+cdef object CONTENT_ENCODING = hdrs.CONTENT_ENCODING
+cdef object EMPTY_PAYLOAD = _EMPTY_PAYLOAD
+cdef object StreamReader = _StreamReader
+cdef object DeflateBuffer = _DeflateBuffer
+
+
+cdef inline object extend(object buf, const char* at, size_t length):
+    cdef Py_ssize_t s
+    cdef char* ptr
+    s = PyByteArray_Size(buf)
+    PyByteArray_Resize(buf, s + length)
+    ptr = PyByteArray_AsString(buf)
+    memcpy(ptr + s, at, length)
+
+
+DEF METHODS_COUNT = 46;
+
+cdef list _http_method = []
+
+for i in range(METHODS_COUNT):
+    _http_method.append(
+        cparser.llhttp_method_name(<cparser.llhttp_method_t> i).decode('ascii'))
+
+
+cdef inline str http_method_str(int i):
+    if i < METHODS_COUNT:
+        return <str>_http_method[i]
+    else:
+        return "<unknown>"
+
+cdef inline object find_header(bytes raw_header):
+    cdef Py_ssize_t size
+    cdef char *buf
+    cdef int idx
+    PyBytes_AsStringAndSize(raw_header, &buf, &size)
+    idx = _find_header.find_header(buf, size)
+    if idx == -1:
+        return raw_header.decode('utf-8', 'surrogateescape')
+    return headers[idx]
+
+
+@cython.freelist(DEFAULT_FREELIST_SIZE)
+cdef class RawRequestMessage:
+    cdef readonly str method
+    cdef readonly str path
+    cdef readonly object version  # HttpVersion
+    cdef readonly object headers  # CIMultiDict
+    cdef readonly object raw_headers  # tuple
+    cdef readonly object should_close
+    cdef readonly object compression
+    cdef readonly object upgrade
+    cdef readonly object chunked
+    cdef readonly object url  # yarl.URL
+
+    def __init__(self, method, path, version, headers, raw_headers,
+                 should_close, compression, upgrade, chunked, url):
+        self.method = method
+        self.path = path
+        self.version = version
+        self.headers = headers
+        self.raw_headers = raw_headers
+        self.should_close = should_close
+        self.compression = compression
+        self.upgrade = upgrade
+        self.chunked = chunked
+        self.url = url
+
+    def __repr__(self):
+        info = []
+        info.append(("method", self.method))
+        info.append(("path", self.path))
+        info.append(("version", self.version))
+        info.append(("headers", self.headers))
+        info.append(("raw_headers", self.raw_headers))
+        info.append(("should_close", self.should_close))
+        info.append(("compression", self.compression))
+        info.append(("upgrade", self.upgrade))
+        info.append(("chunked", self.chunked))
+        info.append(("url", self.url))
+        sinfo = ', '.join(name + '=' + repr(val) for name, val in info)
+        return '<RawRequestMessage(' + sinfo + ')>'
+
+    def _replace(self, **dct):
+        cdef RawRequestMessage ret
+        ret = _new_request_message(self.method,
+                                   self.path,
+                                   self.version,
+                                   self.headers,
+                                   self.raw_headers,
+                                   self.should_close,
+                                   self.compression,
+                                   self.upgrade,
+                                   self.chunked,
+                                   self.url)
+        if "method" in dct:
+            ret.method = dct["method"]
+        if "path" in dct:
+            ret.path = dct["path"]
+        if "version" in dct:
+            ret.version = dct["version"]
+        if "headers" in dct:
+            ret.headers = dct["headers"]
+        if "raw_headers" in dct:
+            ret.raw_headers = dct["raw_headers"]
+        if "should_close" in dct:
+            ret.should_close = dct["should_close"]
+        if "compression" in dct:
+            ret.compression = dct["compression"]
+        if "upgrade" in dct:
+            ret.upgrade = dct["upgrade"]
+        if "chunked" in dct:
+            ret.chunked = dct["chunked"]
+        if "url" in dct:
+            ret.url = dct["url"]
+        return ret
+
+cdef _new_request_message(str method,
+                           str path,
+                           object version,
+                           object headers,
+                           object raw_headers,
+                           bint should_close,
+                           object compression,
+                           bint upgrade,
+                           bint chunked,
+                           object url):
+    cdef RawRequestMessage ret
+    ret = RawRequestMessage.__new__(RawRequestMessage)
+    ret.method = method
+    ret.path = path
+    ret.version = version
+    ret.headers = headers
+    ret.raw_headers = raw_headers
+    ret.should_close = should_close
+    ret.compression = compression
+    ret.upgrade = upgrade
+    ret.chunked = chunked
+    ret.url = url
+    return ret
+
+
+@cython.freelist(DEFAULT_FREELIST_SIZE)
+cdef class RawResponseMessage:
+    cdef readonly object version  # HttpVersion
+    cdef readonly int code
+    cdef readonly str reason
+    cdef readonly object headers  # CIMultiDict
+    cdef readonly object raw_headers  # tuple
+    cdef readonly object should_close
+    cdef readonly object compression
+    cdef readonly object upgrade
+    cdef readonly object chunked
+
+    def __init__(self, version, code, reason, headers, raw_headers,
+                 should_close, compression, upgrade, chunked):
+        self.version = version
+        self.code = code
+        self.reason = reason
+        self.headers = headers
+        self.raw_headers = raw_headers
+        self.should_close = should_close
+        self.compression = compression
+        self.upgrade = upgrade
+        self.chunked = chunked
+
+    def __repr__(self):
+        info = []
+        info.append(("version", self.version))
+        info.append(("code", self.code))
+        info.append(("reason", self.reason))
+        info.append(("headers", self.headers))
+        info.append(("raw_headers", self.raw_headers))
+        info.append(("should_close", self.should_close))
+        info.append(("compression", self.compression))
+        info.append(("upgrade", self.upgrade))
+        info.append(("chunked", self.chunked))
+        sinfo = ', '.join(name + '=' + repr(val) for name, val in info)
+        return '<RawResponseMessage(' + sinfo + ')>'
+
+
+cdef _new_response_message(object version,
+                           int code,
+                           str reason,
+                           object headers,
+                           object raw_headers,
+                           bint should_close,
+                           object compression,
+                           bint upgrade,
+                           bint chunked):
+    cdef RawResponseMessage ret
+    ret = RawResponseMessage.__new__(RawResponseMessage)
+    ret.version = version
+    ret.code = code
+    ret.reason = reason
+    ret.headers = headers
+    ret.raw_headers = raw_headers
+    ret.should_close = should_close
+    ret.compression = compression
+    ret.upgrade = upgrade
+    ret.chunked = chunked
+    return ret
+
+
+@cython.internal
+cdef class HttpParser:
+
+    cdef:
+        cparser.llhttp_t* _cparser
+        cparser.llhttp_settings_t* _csettings
+
+        bytearray _raw_name
+        bytearray _raw_value
+        bint      _has_value
+
+        object _protocol
+        object _loop
+        object _timer
+
+        size_t _max_line_size
+        size_t _max_field_size
+        size_t _max_headers
+        bint _response_with_body
+        bint _read_until_eof
+
+        bint    _started
+        object  _url
+        bytearray   _buf
+        str     _path
+        str     _reason
+        object  _headers
+        list    _raw_headers
+        bint    _upgraded
+        list    _messages
+        object  _payload
+        bint    _payload_error
+        object  _payload_exception
+        object  _last_error
+        bint    _auto_decompress
+        int     _limit
+
+        str     _content_encoding
+
+        Py_buffer py_buf
+
+    def __cinit__(self):
+        self._cparser = <cparser.llhttp_t*> \
+                                PyMem_Malloc(sizeof(cparser.llhttp_t))
+        if self._cparser is NULL:
+            raise MemoryError()
+
+        self._csettings = <cparser.llhttp_settings_t*> \
+                                PyMem_Malloc(sizeof(cparser.llhttp_settings_t))
+        if self._csettings is NULL:
+            raise MemoryError()
+
+    def __dealloc__(self):
+        PyMem_Free(self._cparser)
+        PyMem_Free(self._csettings)
+
+    cdef _init(
+        self, cparser.llhttp_type mode,
+        object protocol, object loop, int limit,
+        object timer=None,
+        size_t max_line_size=8190, size_t max_headers=32768,
+        size_t max_field_size=8190, payload_exception=None,
+        bint response_with_body=True, bint read_until_eof=False,
+        bint auto_decompress=True,
+    ):
+        cparser.llhttp_settings_init(self._csettings)
+        cparser.llhttp_init(self._cparser, mode, self._csettings)
+        self._cparser.data = <void*>self
+        self._cparser.content_length = 0
+
+        self._protocol = protocol
+        self._loop = loop
+        self._timer = timer
+
+        self._buf = bytearray()
+        self._payload = None
+        self._payload_error = 0
+        self._payload_exception = payload_exception
+        self._messages = []
+
+        self._raw_name = bytearray()
+        self._raw_value = bytearray()
+        self._has_value = False
+
+        self._max_line_size = max_line_size
+        self._max_headers = max_headers
+        self._max_field_size = max_field_size
+        self._response_with_body = response_with_body
+        self._read_until_eof = read_until_eof
+        self._upgraded = False
+        self._auto_decompress = auto_decompress
+        self._content_encoding = None
+
+        self._csettings.on_url = cb_on_url
+        self._csettings.on_status = cb_on_status
+        self._csettings.on_header_field = cb_on_header_field
+        self._csettings.on_header_value = cb_on_header_value
+        self._csettings.on_headers_complete = cb_on_headers_complete
+        self._csettings.on_body = cb_on_body
+        self._csettings.on_message_begin = cb_on_message_begin
+        self._csettings.on_message_complete = cb_on_message_complete
+        self._csettings.on_chunk_header = cb_on_chunk_header
+        self._csettings.on_chunk_complete = cb_on_chunk_complete
+
+        self._last_error = None
+        self._limit = limit
+
+    cdef _process_header(self):
+        if self._raw_name:
+            raw_name = bytes(self._raw_name)
+            raw_value = bytes(self._raw_value)
+
+            name = find_header(raw_name)
+            value = raw_value.decode('utf-8', 'surrogateescape')
+
+            self._headers.add(name, value)
+
+            if name is CONTENT_ENCODING:
+                self._content_encoding = value
+
+            PyByteArray_Resize(self._raw_name, 0)
+            PyByteArray_Resize(self._raw_value, 0)
+            self._has_value = False
+            self._raw_headers.append((raw_name, raw_value))
+
+    cdef _on_header_field(self, char* at, size_t length):
+        cdef Py_ssize_t size
+        cdef char *buf
+        if self._has_value:
+            self._process_header()
+
+        size = PyByteArray_Size(self._raw_name)
+        PyByteArray_Resize(self._raw_name, size + length)
+        buf = PyByteArray_AsString(self._raw_name)
+        memcpy(buf + size, at, length)
+
+    cdef _on_header_value(self, char* at, size_t length):
+        cdef Py_ssize_t size
+        cdef char *buf
+
+        size = PyByteArray_Size(self._raw_value)
+        PyByteArray_Resize(self._raw_value, size + length)
+        buf = PyByteArray_AsString(self._raw_value)
+        memcpy(buf + size, at, length)
+        self._has_value = True
+
+    cdef _on_headers_complete(self):
+        self._process_header()
+
+        method = http_method_str(self._cparser.method)
+        should_close = not cparser.llhttp_should_keep_alive(self._cparser)
+        upgrade = self._cparser.upgrade
+        chunked = self._cparser.flags & cparser.F_CHUNKED
+
+        raw_headers = tuple(self._raw_headers)
+        headers = CIMultiDictProxy(self._headers)
+
+        if upgrade or self._cparser.method == cparser.HTTP_CONNECT:
+            self._upgraded = True
+
+        # do not support old websocket spec
+        if SEC_WEBSOCKET_KEY1 in headers:
+            raise InvalidHeader(SEC_WEBSOCKET_KEY1)
+
+        encoding = None
+        enc = self._content_encoding
+        if enc is not None:
+            self._content_encoding = None
+            enc = enc.lower()
+            if enc in ('gzip', 'deflate', 'br'):
+                encoding = enc
+
+        if self._cparser.type == cparser.HTTP_REQUEST:
+            msg = _new_request_message(
+                method, self._path,
+                self.http_version(), headers, raw_headers,
+                should_close, encoding, upgrade, chunked, self._url)
+        else:
+            msg = _new_response_message(
+                self.http_version(), self._cparser.status_code, self._reason,
+                headers, raw_headers, should_close, encoding,
+                upgrade, chunked)
+
+        if (
+            ULLONG_MAX > self._cparser.content_length > 0 or chunked or
+            self._cparser.method == cparser.HTTP_CONNECT or
+            (self._cparser.status_code >= 199 and
+             self._cparser.content_length == 0 and
+             self._read_until_eof)
+        ):
+            payload = StreamReader(
+                self._protocol, timer=self._timer, loop=self._loop,
+                limit=self._limit)
+        else:
+            payload = EMPTY_PAYLOAD
+
+        self._payload = payload
+        if encoding is not None and self._auto_decompress:
+            self._payload = DeflateBuffer(payload, encoding)
+
+        if not self._response_with_body:
+            payload = EMPTY_PAYLOAD
+
+        self._messages.append((msg, payload))
+
+    cdef _on_message_complete(self):
+        self._payload.feed_eof()
+        self._payload = None
+
+    cdef _on_chunk_header(self):
+        self._payload.begin_http_chunk_receiving()
+
+    cdef _on_chunk_complete(self):
+        self._payload.end_http_chunk_receiving()
+
+    cdef object _on_status_complete(self):
+        pass
+
+    cdef inline http_version(self):
+        cdef cparser.llhttp_t* parser = self._cparser
+
+        if parser.http_major == 1:
+            if parser.http_minor == 0:
+                return HttpVersion10
+            elif parser.http_minor == 1:
+                return HttpVersion11
+
+        return HttpVersion(parser.http_major, parser.http_minor)
+
+    ### Public API ###
+
+    def feed_eof(self):
+        cdef bytes desc
+
+        if self._payload is not None:
+            if self._cparser.flags & cparser.F_CHUNKED:
+                raise TransferEncodingError(
+                    "Not enough data for satisfy transfer length header.")
+            elif self._cparser.flags & cparser.F_CONTENT_LENGTH:
+                raise ContentLengthError(
+                    "Not enough data for satisfy content length header.")
+            elif cparser.llhttp_get_errno(self._cparser) != cparser.HPE_OK:
+                desc = cparser.llhttp_get_error_reason(self._cparser)
+                raise PayloadEncodingError(desc.decode('latin-1'))
+            else:
+                self._payload.feed_eof()
+        elif self._started:
+            self._on_headers_complete()
+            if self._messages:
+                return self._messages[-1][0]
+
+    def feed_data(self, data):
+        cdef:
+            size_t data_len
+            size_t nb
+            cdef cparser.llhttp_errno_t errno
+
+        PyObject_GetBuffer(data, &self.py_buf, PyBUF_SIMPLE)
+        data_len = <size_t>self.py_buf.len
+
+        errno = cparser.llhttp_execute(
+            self._cparser,
+            <char*>self.py_buf.buf,
+            data_len)
+
+        if errno is cparser.HPE_PAUSED_UPGRADE:
+            cparser.llhttp_resume_after_upgrade(self._cparser)
+
+            nb = cparser.llhttp_get_error_pos(self._cparser) - <char*>self.py_buf.buf
+
+        PyBuffer_Release(&self.py_buf)
+
+        if errno not in (cparser.HPE_OK, cparser.HPE_PAUSED_UPGRADE):
+            if self._payload_error == 0:
+                if self._last_error is not None:
+                    ex = self._last_error
+                    self._last_error = None
+                else:
+                    after = cparser.llhttp_get_error_pos(self._cparser)
+                    before = data[:after - <char*>self.py_buf.buf]
+                    after_b = after.split(b"\r\n", 1)[0]
+                    before = before.rsplit(b"\r\n", 1)[-1]
+                    data = before + after_b
+                    pointer = " " * (len(repr(before))-1) + "^"
+                    ex = parser_error_from_errno(self._cparser, data, pointer)
+                self._payload = None
+                raise ex
+
+        if self._messages:
+            messages = self._messages
+            self._messages = []
+        else:
+            messages = ()
+
+        if self._upgraded:
+            return messages, True, data[nb:]
+        else:
+            return messages, False, b''
+
+    def set_upgraded(self, val):
+        self._upgraded = val
+
+
+cdef class HttpRequestParser(HttpParser):
+
+    def __init__(
+        self, protocol, loop, int limit, timer=None,
+        size_t max_line_size=8190, size_t max_headers=32768,
+        size_t max_field_size=8190, payload_exception=None,
+        bint response_with_body=True, bint read_until_eof=False,
+        bint auto_decompress=True,
+    ):
+        self._init(cparser.HTTP_REQUEST, protocol, loop, limit, timer,
+                   max_line_size, max_headers, max_field_size,
+                   payload_exception, response_with_body, read_until_eof,
+                   auto_decompress)
+
+    cdef object _on_status_complete(self):
+        cdef int idx1, idx2
+        if not self._buf:
+            return
+        self._path = self._buf.decode('utf-8', 'surrogateescape')
+        try:
+            idx3 = len(self._path)
+            if self._cparser.method == cparser.HTTP_CONNECT:
+                # authority-form,
+                # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.3
+                self._url = URL.build(authority=self._path, encoded=True)
+            elif idx3 > 1 and self._path[0] == '/':
+                # origin-form,
+                # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.1
+                idx1 = self._path.find("?")
+                if idx1 == -1:
+                    query = ""
+                    idx2 = self._path.find("#")
+                    if idx2 == -1:
+                        path = self._path
+                        fragment = ""
+                    else:
+                        path = self._path[0: idx2]
+                        fragment = self._path[idx2+1:]
+
+                else:
+                    path = self._path[0:idx1]
+                    idx1 += 1
+                    idx2 = self._path.find("#", idx1+1)
+                    if idx2 == -1:
+                        query = self._path[idx1:]
+                        fragment = ""
+                    else:
+                        query = self._path[idx1: idx2]
+                        fragment = self._path[idx2+1:]
+
+                self._url = URL.build(
+                    path=path,
+                    query_string=query,
+                    fragment=fragment,
+                    encoded=True,
+                )
+            else:
+                # absolute-form for proxy maybe,
+                # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.2
+                self._url = URL(self._path, encoded=True)
+        finally:
+            PyByteArray_Resize(self._buf, 0)
+
+
+cdef class HttpResponseParser(HttpParser):
+
+    def __init__(
+        self, protocol, loop, int limit, timer=None,
+            size_t max_line_size=8190, size_t max_headers=32768,
+            size_t max_field_size=8190, payload_exception=None,
+            bint response_with_body=True, bint read_until_eof=False,
+            bint auto_decompress=True
+    ):
+        self._init(cparser.HTTP_RESPONSE, protocol, loop, limit, timer,
+                   max_line_size, max_headers, max_field_size,
+                   payload_exception, response_with_body, read_until_eof,
+                   auto_decompress)
+        # Use strict parsing on dev mode, so users are warned about broken servers.
+        if not DEBUG:
+            cparser.llhttp_set_lenient_headers(self._cparser, 1)
+            cparser.llhttp_set_lenient_optional_cr_before_lf(self._cparser, 1)
+            cparser.llhttp_set_lenient_spaces_after_chunk_size(self._cparser, 1)
+
+    cdef object _on_status_complete(self):
+        if self._buf:
+            self._reason = self._buf.decode('utf-8', 'surrogateescape')
+            PyByteArray_Resize(self._buf, 0)
+        else:
+            self._reason = self._reason or ''
+
+cdef int cb_on_message_begin(cparser.llhttp_t* parser) except -1:
+    cdef HttpParser pyparser = <HttpParser>parser.data
+
+    pyparser._started = True
+    pyparser._headers = CIMultiDict()
+    pyparser._raw_headers = []
+    PyByteArray_Resize(pyparser._buf, 0)
+    pyparser._path = None
+    pyparser._reason = None
+    return 0
+
+
+cdef int cb_on_url(cparser.llhttp_t* parser,
+                   const char *at, size_t length) except -1:
+    cdef HttpParser pyparser = <HttpParser>parser.data
+    try:
+        if length > pyparser._max_line_size:
+            raise LineTooLong(
+                'Status line is too long', pyparser._max_line_size, length)
+        extend(pyparser._buf, at, length)
+    except BaseException as ex:
+        pyparser._last_error = ex
+        return -1
+    else:
+        return 0
+
+
+cdef int cb_on_status(cparser.llhttp_t* parser,
+                      const char *at, size_t length) except -1:
+    cdef HttpParser pyparser = <HttpParser>parser.data
+    cdef str reason
+    try:
+        if length > pyparser._max_line_size:
+            raise LineTooLong(
+                'Status line is too long', pyparser._max_line_size, length)
+        extend(pyparser._buf, at, length)
+    except BaseException as ex:
+        pyparser._last_error = ex
+        return -1
+    else:
+        return 0
+
+
+cdef int cb_on_header_field(cparser.llhttp_t* parser,
+                            const char *at, size_t length) except -1:
+    cdef HttpParser pyparser = <HttpParser>parser.data
+    cdef Py_ssize_t size
+    try:
+        pyparser._on_status_complete()
+        size = len(pyparser._raw_name) + length
+        if size > pyparser._max_field_size:
+            raise LineTooLong(
+                'Header name is too long', pyparser._max_field_size, size)
+        pyparser._on_header_field(at, length)
+    except BaseException as ex:
+        pyparser._last_error = ex
+        return -1
+    else:
+        return 0
+
+
+cdef int cb_on_header_value(cparser.llhttp_t* parser,
+                            const char *at, size_t length) except -1:
+    cdef HttpParser pyparser = <HttpParser>parser.data
+    cdef Py_ssize_t size
+    try:
+        size = len(pyparser._raw_value) + length
+        if size > pyparser._max_field_size:
+            raise LineTooLong(
+                'Header value is too long', pyparser._max_field_size, size)
+        pyparser._on_header_value(at, length)
+    except BaseException as ex:
+        pyparser._last_error = ex
+        return -1
+    else:
+        return 0
+
+
+cdef int cb_on_headers_complete(cparser.llhttp_t* parser) except -1:
+    cdef HttpParser pyparser = <HttpParser>parser.data
+    try:
+        pyparser._on_status_complete()
+        pyparser._on_headers_complete()
+    except BaseException as exc:
+        pyparser._last_error = exc
+        return -1
+    else:
+        if (
+            pyparser._cparser.upgrade or
+            pyparser._cparser.method == cparser.HTTP_CONNECT
+        ):
+            return 2
+        else:
+            return 0
+
+
+cdef int cb_on_body(cparser.llhttp_t* parser,
+                    const char *at, size_t length) except -1:
+    cdef HttpParser pyparser = <HttpParser>parser.data
+    cdef bytes body = at[:length]
+    try:
+        pyparser._payload.feed_data(body, length)
+    except BaseException as underlying_exc:
+        reraised_exc = underlying_exc
+        if pyparser._payload_exception is not None:
+            reraised_exc = pyparser._payload_exception(str(underlying_exc))
+
+        set_exception(pyparser._payload, reraised_exc, underlying_exc)
+
+        pyparser._payload_error = 1
+        return -1
+    else:
+        return 0
+
+
+cdef int cb_on_message_complete(cparser.llhttp_t* parser) except -1:
+    cdef HttpParser pyparser = <HttpParser>parser.data
+    try:
+        pyparser._started = False
+        pyparser._on_message_complete()
+    except BaseException as exc:
+        pyparser._last_error = exc
+        return -1
+    else:
+        return 0
+
+
+cdef int cb_on_chunk_header(cparser.llhttp_t* parser) except -1:
+    cdef HttpParser pyparser = <HttpParser>parser.data
+    try:
+        pyparser._on_chunk_header()
+    except BaseException as exc:
+        pyparser._last_error = exc
+        return -1
+    else:
+        return 0
+
+
+cdef int cb_on_chunk_complete(cparser.llhttp_t* parser) except -1:
+    cdef HttpParser pyparser = <HttpParser>parser.data
+    try:
+        pyparser._on_chunk_complete()
+    except BaseException as exc:
+        pyparser._last_error = exc
+        return -1
+    else:
+        return 0
+
+
+cdef parser_error_from_errno(cparser.llhttp_t* parser, data, pointer):
+    cdef cparser.llhttp_errno_t errno = cparser.llhttp_get_errno(parser)
+    cdef bytes desc = cparser.llhttp_get_error_reason(parser)
+
+    err_msg = "{}:\n\n  {!r}\n  {}".format(desc.decode("latin-1"), data, pointer)
+
+    if errno in {cparser.HPE_CB_MESSAGE_BEGIN,
+                 cparser.HPE_CB_HEADERS_COMPLETE,
+                 cparser.HPE_CB_MESSAGE_COMPLETE,
+                 cparser.HPE_CB_CHUNK_HEADER,
+                 cparser.HPE_CB_CHUNK_COMPLETE,
+                 cparser.HPE_INVALID_CONSTANT,
+                 cparser.HPE_INVALID_HEADER_TOKEN,
+                 cparser.HPE_INVALID_CONTENT_LENGTH,
+                 cparser.HPE_INVALID_CHUNK_SIZE,
+                 cparser.HPE_INVALID_EOF_STATE,
+                 cparser.HPE_INVALID_TRANSFER_ENCODING}:
+        return BadHttpMessage(err_msg)
+    elif errno in {cparser.HPE_INVALID_STATUS,
+                   cparser.HPE_INVALID_METHOD,
+                   cparser.HPE_INVALID_VERSION}:
+        return BadStatusLine(error=err_msg)
+    elif errno == cparser.HPE_INVALID_URL:
+        return InvalidURLError(err_msg)
+
+    return BadHttpMessage(err_msg)
diff --git a/llm/Lib/site-packages/aiohttp/_http_writer.cp311-win_amd64.pyd b/llm/Lib/site-packages/aiohttp/_http_writer.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..d6281942b1580120cddceddc0a01a422f7f60bcd
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/_http_writer.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/aiohttp/_http_writer.pyx b/llm/Lib/site-packages/aiohttp/_http_writer.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..2f9e9f91a5179188467bc3d1c28f6e43e78060a5
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/_http_writer.pyx
@@ -0,0 +1,163 @@
+from cpython.bytes cimport PyBytes_FromStringAndSize
+from cpython.exc cimport PyErr_NoMemory
+from cpython.mem cimport PyMem_Free, PyMem_Malloc, PyMem_Realloc
+from cpython.object cimport PyObject_Str
+from libc.stdint cimport uint8_t, uint64_t
+from libc.string cimport memcpy
+
+from multidict import istr
+
+DEF BUF_SIZE = 16 * 1024  # 16KiB
+cdef char BUFFER[BUF_SIZE]
+
+cdef object _istr = istr
+
+
+# ----------------- writer ---------------------------
+
+cdef struct Writer:
+    char *buf
+    Py_ssize_t size
+    Py_ssize_t pos
+
+
+cdef inline void _init_writer(Writer* writer):
+    writer.buf = &BUFFER[0]
+    writer.size = BUF_SIZE
+    writer.pos = 0
+
+
+cdef inline void _release_writer(Writer* writer):
+    if writer.buf != BUFFER:
+        PyMem_Free(writer.buf)
+
+
+cdef inline int _write_byte(Writer* writer, uint8_t ch):
+    cdef char * buf
+    cdef Py_ssize_t size
+
+    if writer.pos == writer.size:
+        # reallocate
+        size = writer.size + BUF_SIZE
+        if writer.buf == BUFFER:
+            buf = <char*>PyMem_Malloc(size)
+            if buf == NULL:
+                PyErr_NoMemory()
+                return -1
+            memcpy(buf, writer.buf, writer.size)
+        else:
+            buf = <char*>PyMem_Realloc(writer.buf, size)
+            if buf == NULL:
+                PyErr_NoMemory()
+                return -1
+        writer.buf = buf
+        writer.size = size
+    writer.buf[writer.pos] = <char>ch
+    writer.pos += 1
+    return 0
+
+
+cdef inline int _write_utf8(Writer* writer, Py_UCS4 symbol):
+    cdef uint64_t utf = <uint64_t> symbol
+
+    if utf < 0x80:
+        return _write_byte(writer, <uint8_t>utf)
+    elif utf < 0x800:
+        if _write_byte(writer, <uint8_t>(0xc0 | (utf >> 6))) < 0:
+            return -1
+        return _write_byte(writer,  <uint8_t>(0x80 | (utf & 0x3f)))
+    elif 0xD800 <= utf <= 0xDFFF:
+        # surogate pair, ignored
+        return 0
+    elif utf < 0x10000:
+        if _write_byte(writer, <uint8_t>(0xe0 | (utf >> 12))) < 0:
+            return -1
+        if _write_byte(writer, <uint8_t>(0x80 | ((utf >> 6) & 0x3f))) < 0:
+            return -1
+        return _write_byte(writer, <uint8_t>(0x80 | (utf & 0x3f)))
+    elif utf > 0x10FFFF:
+        # symbol is too large
+        return 0
+    else:
+        if _write_byte(writer,  <uint8_t>(0xf0 | (utf >> 18))) < 0:
+            return -1
+        if _write_byte(writer,
+                       <uint8_t>(0x80 | ((utf >> 12) & 0x3f))) < 0:
+           return -1
+        if _write_byte(writer,
+                       <uint8_t>(0x80 | ((utf >> 6) & 0x3f))) < 0:
+            return -1
+        return _write_byte(writer, <uint8_t>(0x80 | (utf & 0x3f)))
+
+
+cdef inline int _write_str(Writer* writer, str s):
+    cdef Py_UCS4 ch
+    for ch in s:
+        if _write_utf8(writer, ch) < 0:
+            return -1
+
+
+# --------------- _serialize_headers ----------------------
+
+cdef str to_str(object s):
+    typ = type(s)
+    if typ is str:
+        return <str>s
+    elif typ is _istr:
+        return PyObject_Str(s)
+    elif not isinstance(s, str):
+        raise TypeError("Cannot serialize non-str key {!r}".format(s))
+    else:
+        return str(s)
+
+
+cdef void _safe_header(str string) except *:
+    if "\r" in string or "\n" in string:
+        raise ValueError(
+            "Newline or carriage return character detected in HTTP status message or "
+            "header. This is a potential security issue."
+        )
+
+
+def _serialize_headers(str status_line, headers):
+    cdef Writer writer
+    cdef object key
+    cdef object val
+    cdef bytes ret
+
+    _init_writer(&writer)
+
+    for key, val in headers.items():
+        _safe_header(to_str(key))
+        _safe_header(to_str(val))
+
+    try:
+        if _write_str(&writer, status_line) < 0:
+            raise
+        if _write_byte(&writer, b'\r') < 0:
+            raise
+        if _write_byte(&writer, b'\n') < 0:
+            raise
+
+        for key, val in headers.items():
+            if _write_str(&writer, to_str(key)) < 0:
+                raise
+            if _write_byte(&writer, b':') < 0:
+                raise
+            if _write_byte(&writer, b' ') < 0:
+                raise
+            if _write_str(&writer, to_str(val)) < 0:
+                raise
+            if _write_byte(&writer, b'\r') < 0:
+                raise
+            if _write_byte(&writer, b'\n') < 0:
+                raise
+
+        if _write_byte(&writer, b'\r') < 0:
+            raise
+        if _write_byte(&writer, b'\n') < 0:
+            raise
+
+        return PyBytes_FromStringAndSize(writer.buf, writer.pos)
+    finally:
+        _release_writer(&writer)
diff --git a/llm/Lib/site-packages/aiohttp/_websocket.cp311-win_amd64.pyd b/llm/Lib/site-packages/aiohttp/_websocket.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..2f3afa485af44292e1966a566effc43dd84e2a0c
Binary files /dev/null and b/llm/Lib/site-packages/aiohttp/_websocket.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/aiohttp/_websocket.pyx b/llm/Lib/site-packages/aiohttp/_websocket.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..6f036b24fc171e771d084aa2049f1b73964e3e9f
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/_websocket.pyx
@@ -0,0 +1,56 @@
+from cpython cimport PyBytes_AsString
+
+
+#from cpython cimport PyByteArray_AsString # cython still not exports that
+cdef extern from "Python.h":
+    char* PyByteArray_AsString(bytearray ba) except NULL
+
+from libc.stdint cimport uint32_t, uint64_t, uintmax_t
+
+
+def _websocket_mask_cython(object mask, object data):
+    """Note, this function mutates its `data` argument
+    """
+    cdef:
+        Py_ssize_t data_len, i
+        # bit operations on signed integers are implementation-specific
+        unsigned char * in_buf
+        const unsigned char * mask_buf
+        uint32_t uint32_msk
+        uint64_t uint64_msk
+
+    assert len(mask) == 4
+
+    if not isinstance(mask, bytes):
+        mask = bytes(mask)
+
+    if isinstance(data, bytearray):
+        data = <bytearray>data
+    else:
+        data = bytearray(data)
+
+    data_len = len(data)
+    in_buf = <unsigned char*>PyByteArray_AsString(data)
+    mask_buf = <const unsigned char*>PyBytes_AsString(mask)
+    uint32_msk = (<uint32_t*>mask_buf)[0]
+
+    # TODO: align in_data ptr to achieve even faster speeds
+    # does it need in python ?! malloc() always aligns to sizeof(long) bytes
+
+    if sizeof(size_t) >= 8:
+        uint64_msk = uint32_msk
+        uint64_msk = (uint64_msk << 32) | uint32_msk
+
+        while data_len >= 8:
+            (<uint64_t*>in_buf)[0] ^= uint64_msk
+            in_buf += 8
+            data_len -= 8
+
+
+    while data_len >= 4:
+        (<uint32_t*>in_buf)[0] ^= uint32_msk
+        in_buf += 4
+        data_len -= 4
+
+    for i in range(0, data_len):
+        in_buf[i] ^= mask_buf[i]
diff --git a/llm/Lib/site-packages/aiohttp/abc.py b/llm/Lib/site-packages/aiohttp/abc.py
new file mode 100644
index 0000000000000000000000000000000000000000..e539bc3bbc9d670fa9e546339783d8fa46d7c55f
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/abc.py
@@ -0,0 +1,209 @@
+import asyncio
+import logging
+from abc import ABC, abstractmethod
+from collections.abc import Sized
+from http.cookies import BaseCookie, Morsel
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Awaitable,
+    Callable,
+    Dict,
+    Generator,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+)
+
+from multidict import CIMultiDict
+from yarl import URL
+
+from .helpers import get_running_loop
+from .typedefs import LooseCookies
+
+if TYPE_CHECKING:
+    from .web_app import Application
+    from .web_exceptions import HTTPException
+    from .web_request import BaseRequest, Request
+    from .web_response import StreamResponse
+else:
+    BaseRequest = Request = Application = StreamResponse = None
+    HTTPException = None
+
+
+class AbstractRouter(ABC):
+    def __init__(self) -> None:
+        self._frozen = False
+
+    def post_init(self, app: Application) -> None:
+        """Post init stage.
+
+        Not an abstract method for sake of backward compatibility,
+        but if the router wants to be aware of the application
+        it can override this.
+        """
+
+    @property
+    def frozen(self) -> bool:
+        return self._frozen
+
+    def freeze(self) -> None:
+        """Freeze router."""
+        self._frozen = True
+
+    @abstractmethod
+    async def resolve(self, request: Request) -> "AbstractMatchInfo":
+        """Return MATCH_INFO for given request"""
+
+
+class AbstractMatchInfo(ABC):
+    @property  # pragma: no branch
+    @abstractmethod
+    def handler(self) -> Callable[[Request], Awaitable[StreamResponse]]:
+        """Execute matched request handler"""
+
+    @property
+    @abstractmethod
+    def expect_handler(
+        self,
+    ) -> Callable[[Request], Awaitable[Optional[StreamResponse]]]:
+        """Expect handler for 100-continue processing"""
+
+    @property  # pragma: no branch
+    @abstractmethod
+    def http_exception(self) -> Optional[HTTPException]:
+        """HTTPException instance raised on router's resolving, or None"""
+
+    @abstractmethod  # pragma: no branch
+    def get_info(self) -> Dict[str, Any]:
+        """Return a dict with additional info useful for introspection"""
+
+    @property  # pragma: no branch
+    @abstractmethod
+    def apps(self) -> Tuple[Application, ...]:
+        """Stack of nested applications.
+
+        Top level application is left-most element.
+
+        """
+
+    @abstractmethod
+    def add_app(self, app: Application) -> None:
+        """Add application to the nested apps stack."""
+
+    @abstractmethod
+    def freeze(self) -> None:
+        """Freeze the match info.
+
+        The method is called after route resolution.
+
+        After the call .add_app() is forbidden.
+
+        """
+
+
+class AbstractView(ABC):
+    """Abstract class based view."""
+
+    def __init__(self, request: Request) -> None:
+        self._request = request
+
+    @property
+    def request(self) -> Request:
+        """Request instance."""
+        return self._request
+
+    @abstractmethod
+    def __await__(self) -> Generator[Any, None, StreamResponse]:
+        """Execute the view handler."""
+
+
+class AbstractResolver(ABC):
+    """Abstract DNS resolver."""
+
+    @abstractmethod
+    async def resolve(self, host: str, port: int, family: int) -> List[Dict[str, Any]]:
+        """Return IP address for given hostname"""
+
+    @abstractmethod
+    async def close(self) -> None:
+        """Release resolver"""
+
+
+if TYPE_CHECKING:
+    IterableBase = Iterable[Morsel[str]]
+else:
+    IterableBase = Iterable
+
+
+ClearCookiePredicate = Callable[["Morsel[str]"], bool]
+
+
+class AbstractCookieJar(Sized, IterableBase):
+    """Abstract Cookie Jar."""
+
+    def __init__(self, *, loop: Optional[asyncio.AbstractEventLoop] = None) -> None:
+        self._loop = get_running_loop(loop)
+
+    @abstractmethod
+    def clear(self, predicate: Optional[ClearCookiePredicate] = None) -> None:
+        """Clear all cookies if no predicate is passed."""
+
+    @abstractmethod
+    def clear_domain(self, domain: str) -> None:
+        """Clear all cookies for domain and all subdomains."""
+
+    @abstractmethod
+    def update_cookies(self, cookies: LooseCookies, response_url: URL = URL()) -> None:
+        """Update cookies."""
+
+    @abstractmethod
+    def filter_cookies(self, request_url: URL) -> "BaseCookie[str]":
+        """Return the jar's cookies filtered by their attributes."""
+
+
+class AbstractStreamWriter(ABC):
+    """Abstract stream writer."""
+
+    buffer_size = 0
+    output_size = 0
+    length: Optional[int] = 0
+
+    @abstractmethod
+    async def write(self, chunk: bytes) -> None:
+        """Write chunk into stream."""
+
+    @abstractmethod
+    async def write_eof(self, chunk: bytes = b"") -> None:
+        """Write last chunk."""
+
+    @abstractmethod
+    async def drain(self) -> None:
+        """Flush the write buffer."""
+
+    @abstractmethod
+    def enable_compression(self, encoding: str = "deflate") -> None:
+        """Enable HTTP body compression"""
+
+    @abstractmethod
+    def enable_chunking(self) -> None:
+        """Enable HTTP chunked mode"""
+
+    @abstractmethod
+    async def write_headers(
+        self, status_line: str, headers: "CIMultiDict[str]"
+    ) -> None:
+        """Write HTTP headers"""
+
+
+class AbstractAccessLogger(ABC):
+    """Abstract writer to access log."""
+
+    def __init__(self, logger: logging.Logger, log_format: str) -> None:
+        self.logger = logger
+        self.log_format = log_format
+
+    @abstractmethod
+    def log(self, request: BaseRequest, response: StreamResponse, time: float) -> None:
+        """Emit log to logger."""
diff --git a/llm/Lib/site-packages/aiohttp/base_protocol.py b/llm/Lib/site-packages/aiohttp/base_protocol.py
new file mode 100644
index 0000000000000000000000000000000000000000..889203322c88ac14af8e58bc39de7199dd190525
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/base_protocol.py
@@ -0,0 +1,95 @@
+import asyncio
+from typing import Optional, cast
+
+from .helpers import set_exception
+from .tcp_helpers import tcp_nodelay
+
+
+class BaseProtocol(asyncio.Protocol):
+    __slots__ = (
+        "_loop",
+        "_paused",
+        "_drain_waiter",
+        "_connection_lost",
+        "_reading_paused",
+        "transport",
+    )
+
+    def __init__(self, loop: asyncio.AbstractEventLoop) -> None:
+        self._loop: asyncio.AbstractEventLoop = loop
+        self._paused = False
+        self._drain_waiter: Optional[asyncio.Future[None]] = None
+        self._reading_paused = False
+
+        self.transport: Optional[asyncio.Transport] = None
+
+    @property
+    def connected(self) -> bool:
+        """Return True if the connection is open."""
+        return self.transport is not None
+
+    def pause_writing(self) -> None:
+        assert not self._paused
+        self._paused = True
+
+    def resume_writing(self) -> None:
+        assert self._paused
+        self._paused = False
+
+        waiter = self._drain_waiter
+        if waiter is not None:
+            self._drain_waiter = None
+            if not waiter.done():
+                waiter.set_result(None)
+
+    def pause_reading(self) -> None:
+        if not self._reading_paused and self.transport is not None:
+            try:
+                self.transport.pause_reading()
+            except (AttributeError, NotImplementedError, RuntimeError):
+                pass
+            self._reading_paused = True
+
+    def resume_reading(self) -> None:
+        if self._reading_paused and self.transport is not None:
+            try:
+                self.transport.resume_reading()
+            except (AttributeError, NotImplementedError, RuntimeError):
+                pass
+            self._reading_paused = False
+
+    def connection_made(self, transport: asyncio.BaseTransport) -> None:
+        tr = cast(asyncio.Transport, transport)
+        tcp_nodelay(tr, True)
+        self.transport = tr
+
+    def connection_lost(self, exc: Optional[BaseException]) -> None:
+        # Wake up the writer if currently paused.
+        self.transport = None
+        if not self._paused:
+            return
+        waiter = self._drain_waiter
+        if waiter is None:
+            return
+        self._drain_waiter = None
+        if waiter.done():
+            return
+        if exc is None:
+            waiter.set_result(None)
+        else:
+            set_exception(
+                waiter,
+                ConnectionError("Connection lost"),
+                exc,
+            )
+
+    async def _drain_helper(self) -> None:
+        if not self.connected:
+            raise ConnectionResetError("Connection lost")
+        if not self._paused:
+            return
+        waiter = self._drain_waiter
+        if waiter is None:
+            waiter = self._loop.create_future()
+            self._drain_waiter = waiter
+        await asyncio.shield(waiter)
diff --git a/llm/Lib/site-packages/aiohttp/client.py b/llm/Lib/site-packages/aiohttp/client.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4923c8d78af9cccca333cb2ddde9408a5a1c2b5
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/client.py
@@ -0,0 +1,1366 @@
+"""HTTP Client for asyncio."""
+
+import asyncio
+import base64
+import hashlib
+import json
+import os
+import sys
+import traceback
+import warnings
+from contextlib import suppress
+from types import SimpleNamespace, TracebackType
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Awaitable,
+    Callable,
+    Coroutine,
+    Final,
+    FrozenSet,
+    Generator,
+    Generic,
+    Iterable,
+    List,
+    Mapping,
+    Optional,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+
+import attr
+from multidict import CIMultiDict, MultiDict, MultiDictProxy, istr
+from yarl import URL
+
+from . import hdrs, http, payload
+from .abc import AbstractCookieJar
+from .client_exceptions import (
+    ClientConnectionError as ClientConnectionError,
+    ClientConnectorCertificateError as ClientConnectorCertificateError,
+    ClientConnectorError as ClientConnectorError,
+    ClientConnectorSSLError as ClientConnectorSSLError,
+    ClientError as ClientError,
+    ClientHttpProxyError as ClientHttpProxyError,
+    ClientOSError as ClientOSError,
+    ClientPayloadError as ClientPayloadError,
+    ClientProxyConnectionError as ClientProxyConnectionError,
+    ClientResponseError as ClientResponseError,
+    ClientSSLError as ClientSSLError,
+    ContentTypeError as ContentTypeError,
+    InvalidURL as InvalidURL,
+    ServerConnectionError as ServerConnectionError,
+    ServerDisconnectedError as ServerDisconnectedError,
+    ServerFingerprintMismatch as ServerFingerprintMismatch,
+    ServerTimeoutError as ServerTimeoutError,
+    TooManyRedirects as TooManyRedirects,
+    WSServerHandshakeError as WSServerHandshakeError,
+)
+from .client_reqrep import (
+    ClientRequest as ClientRequest,
+    ClientResponse as ClientResponse,
+    Fingerprint as Fingerprint,
+    RequestInfo as RequestInfo,
+    _merge_ssl_params,
+)
+from .client_ws import ClientWebSocketResponse as ClientWebSocketResponse
+from .connector import (
+    BaseConnector as BaseConnector,
+    NamedPipeConnector as NamedPipeConnector,
+    TCPConnector as TCPConnector,
+    UnixConnector as UnixConnector,
+)
+from .cookiejar import CookieJar
+from .helpers import (
+    _SENTINEL,
+    DEBUG,
+    BasicAuth,
+    TimeoutHandle,
+    ceil_timeout,
+    get_env_proxy_for_url,
+    get_running_loop,
+    method_must_be_empty_body,
+    sentinel,
+    strip_auth_from_url,
+)
+from .http import WS_KEY, HttpVersion, WebSocketReader, WebSocketWriter
+from .http_websocket import WSHandshakeError, WSMessage, ws_ext_gen, ws_ext_parse
+from .streams import FlowControlDataQueue
+from .tracing import Trace, TraceConfig
+from .typedefs import JSONEncoder, LooseCookies, LooseHeaders, StrOrURL
+
+__all__ = (
+    # client_exceptions
+    "ClientConnectionError",
+    "ClientConnectorCertificateError",
+    "ClientConnectorError",
+    "ClientConnectorSSLError",
+    "ClientError",
+    "ClientHttpProxyError",
+    "ClientOSError",
+    "ClientPayloadError",
+    "ClientProxyConnectionError",
+    "ClientResponseError",
+    "ClientSSLError",
+    "ContentTypeError",
+    "InvalidURL",
+    "ServerConnectionError",
+    "ServerDisconnectedError",
+    "ServerFingerprintMismatch",
+    "ServerTimeoutError",
+    "TooManyRedirects",
+    "WSServerHandshakeError",
+    # client_reqrep
+    "ClientRequest",
+    "ClientResponse",
+    "Fingerprint",
+    "RequestInfo",
+    # connector
+    "BaseConnector",
+    "TCPConnector",
+    "UnixConnector",
+    "NamedPipeConnector",
+    # client_ws
+    "ClientWebSocketResponse",
+    # client
+    "ClientSession",
+    "ClientTimeout",
+    "request",
+)
+
+
+if TYPE_CHECKING:
+    from ssl import SSLContext
+else:
+    SSLContext = None
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class ClientTimeout:
+    total: Optional[float] = None
+    connect: Optional[float] = None
+    sock_read: Optional[float] = None
+    sock_connect: Optional[float] = None
+    ceil_threshold: float = 5
+
+    # pool_queue_timeout: Optional[float] = None
+    # dns_resolution_timeout: Optional[float] = None
+    # socket_connect_timeout: Optional[float] = None
+    # connection_acquiring_timeout: Optional[float] = None
+    # new_connection_timeout: Optional[float] = None
+    # http_header_timeout: Optional[float] = None
+    # response_body_timeout: Optional[float] = None
+
+    # to create a timeout specific for a single request, either
+    # - create a completely new one to overwrite the default
+    # - or use http://www.attrs.org/en/stable/api.html#attr.evolve
+    # to overwrite the defaults
+
+
+# 5 Minute default read timeout
+DEFAULT_TIMEOUT: Final[ClientTimeout] = ClientTimeout(total=5 * 60)
+
+_RetType = TypeVar("_RetType")
+_CharsetResolver = Callable[[ClientResponse, bytes], str]
+
+
+class ClientSession:
+    """First-class interface for making HTTP requests."""
+
+    ATTRS = frozenset(
+        [
+            "_base_url",
+            "_source_traceback",
+            "_connector",
+            "requote_redirect_url",
+            "_loop",
+            "_cookie_jar",
+            "_connector_owner",
+            "_default_auth",
+            "_version",
+            "_json_serialize",
+            "_requote_redirect_url",
+            "_timeout",
+            "_raise_for_status",
+            "_auto_decompress",
+            "_trust_env",
+            "_default_headers",
+            "_skip_auto_headers",
+            "_request_class",
+            "_response_class",
+            "_ws_response_class",
+            "_trace_configs",
+            "_read_bufsize",
+            "_max_line_size",
+            "_max_field_size",
+            "_resolve_charset",
+        ]
+    )
+
+    _source_traceback: Optional[traceback.StackSummary] = None
+    _connector: Optional[BaseConnector] = None
+
+    def __init__(
+        self,
+        base_url: Optional[StrOrURL] = None,
+        *,
+        connector: Optional[BaseConnector] = None,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        cookies: Optional[LooseCookies] = None,
+        headers: Optional[LooseHeaders] = None,
+        skip_auto_headers: Optional[Iterable[str]] = None,
+        auth: Optional[BasicAuth] = None,
+        json_serialize: JSONEncoder = json.dumps,
+        request_class: Type[ClientRequest] = ClientRequest,
+        response_class: Type[ClientResponse] = ClientResponse,
+        ws_response_class: Type[ClientWebSocketResponse] = ClientWebSocketResponse,
+        version: HttpVersion = http.HttpVersion11,
+        cookie_jar: Optional[AbstractCookieJar] = None,
+        connector_owner: bool = True,
+        raise_for_status: Union[
+            bool, Callable[[ClientResponse], Awaitable[None]]
+        ] = False,
+        read_timeout: Union[float, _SENTINEL] = sentinel,
+        conn_timeout: Optional[float] = None,
+        timeout: Union[object, ClientTimeout] = sentinel,
+        auto_decompress: bool = True,
+        trust_env: bool = False,
+        requote_redirect_url: bool = True,
+        trace_configs: Optional[List[TraceConfig]] = None,
+        read_bufsize: int = 2**16,
+        max_line_size: int = 8190,
+        max_field_size: int = 8190,
+        fallback_charset_resolver: _CharsetResolver = lambda r, b: "utf-8",
+    ) -> None:
+        # We initialise _connector to None immediately, as it's referenced in __del__()
+        # and could cause issues if an exception occurs during initialisation.
+        self._connector: Optional[BaseConnector] = None
+        if timeout is sentinel or timeout is None:
+            self._timeout = DEFAULT_TIMEOUT
+            if read_timeout is not sentinel:
+                warnings.warn(
+                    "read_timeout is deprecated, " "use timeout argument instead",
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+                self._timeout = attr.evolve(self._timeout, total=read_timeout)
+            if conn_timeout is not None:
+                self._timeout = attr.evolve(self._timeout, connect=conn_timeout)
+                warnings.warn(
+                    "conn_timeout is deprecated, " "use timeout argument instead",
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+        else:
+            if not isinstance(timeout, ClientTimeout):
+                raise ValueError(
+                    f"timeout parameter cannot be of {type(timeout)} type, "
+                    "please use 'timeout=ClientTimeout(...)'",
+                )
+            self._timeout = timeout
+            if read_timeout is not sentinel:
+                raise ValueError(
+                    "read_timeout and timeout parameters "
+                    "conflict, please setup "
+                    "timeout.read"
+                )
+            if conn_timeout is not None:
+                raise ValueError(
+                    "conn_timeout and timeout parameters "
+                    "conflict, please setup "
+                    "timeout.connect"
+                )
+        if loop is None:
+            if connector is not None:
+                loop = connector._loop
+
+        loop = get_running_loop(loop)
+
+        if base_url is None or isinstance(base_url, URL):
+            self._base_url: Optional[URL] = base_url
+        else:
+            self._base_url = URL(base_url)
+            assert (
+                self._base_url.origin() == self._base_url
+            ), "Only absolute URLs without path part are supported"
+
+        if connector is None:
+            connector = TCPConnector(loop=loop)
+
+        if connector._loop is not loop:
+            raise RuntimeError("Session and connector has to use same event loop")
+
+        self._loop = loop
+
+        if loop.get_debug():
+            self._source_traceback = traceback.extract_stack(sys._getframe(1))
+
+        if cookie_jar is None:
+            cookie_jar = CookieJar(loop=loop)
+        self._cookie_jar = cookie_jar
+
+        if cookies is not None:
+            self._cookie_jar.update_cookies(cookies)
+
+        self._connector = connector
+        self._connector_owner = connector_owner
+        self._default_auth = auth
+        self._version = version
+        self._json_serialize = json_serialize
+        self._raise_for_status = raise_for_status
+        self._auto_decompress = auto_decompress
+        self._trust_env = trust_env
+        self._requote_redirect_url = requote_redirect_url
+        self._read_bufsize = read_bufsize
+        self._max_line_size = max_line_size
+        self._max_field_size = max_field_size
+
+        # Convert to list of tuples
+        if headers:
+            real_headers: CIMultiDict[str] = CIMultiDict(headers)
+        else:
+            real_headers = CIMultiDict()
+        self._default_headers: CIMultiDict[str] = real_headers
+        if skip_auto_headers is not None:
+            self._skip_auto_headers = frozenset(istr(i) for i in skip_auto_headers)
+        else:
+            self._skip_auto_headers = frozenset()
+
+        self._request_class = request_class
+        self._response_class = response_class
+        self._ws_response_class = ws_response_class
+
+        self._trace_configs = trace_configs or []
+        for trace_config in self._trace_configs:
+            trace_config.freeze()
+
+        self._resolve_charset = fallback_charset_resolver
+
+    def __init_subclass__(cls: Type["ClientSession"]) -> None:
+        warnings.warn(
+            "Inheritance class {} from ClientSession "
+            "is discouraged".format(cls.__name__),
+            DeprecationWarning,
+            stacklevel=2,
+        )
+
+    if DEBUG:
+
+        def __setattr__(self, name: str, val: Any) -> None:
+            if name not in self.ATTRS:
+                warnings.warn(
+                    "Setting custom ClientSession.{} attribute "
+                    "is discouraged".format(name),
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+            super().__setattr__(name, val)
+
+    def __del__(self, _warnings: Any = warnings) -> None:
+        if not self.closed:
+            kwargs = {"source": self}
+            _warnings.warn(
+                f"Unclosed client session {self!r}", ResourceWarning, **kwargs
+            )
+            context = {"client_session": self, "message": "Unclosed client session"}
+            if self._source_traceback is not None:
+                context["source_traceback"] = self._source_traceback
+            self._loop.call_exception_handler(context)
+
+    def request(
+        self, method: str, url: StrOrURL, **kwargs: Any
+    ) -> "_RequestContextManager":
+        """Perform HTTP request."""
+        return _RequestContextManager(self._request(method, url, **kwargs))
+
+    def _build_url(self, str_or_url: StrOrURL) -> URL:
+        url = URL(str_or_url)
+        if self._base_url is None:
+            return url
+        else:
+            assert not url.is_absolute() and url.path.startswith("/")
+            return self._base_url.join(url)
+
+    async def _request(
+        self,
+        method: str,
+        str_or_url: StrOrURL,
+        *,
+        params: Optional[Mapping[str, str]] = None,
+        data: Any = None,
+        json: Any = None,
+        cookies: Optional[LooseCookies] = None,
+        headers: Optional[LooseHeaders] = None,
+        skip_auto_headers: Optional[Iterable[str]] = None,
+        auth: Optional[BasicAuth] = None,
+        allow_redirects: bool = True,
+        max_redirects: int = 10,
+        compress: Optional[str] = None,
+        chunked: Optional[bool] = None,
+        expect100: bool = False,
+        raise_for_status: Union[
+            None, bool, Callable[[ClientResponse], Awaitable[None]]
+        ] = None,
+        read_until_eof: bool = True,
+        proxy: Optional[StrOrURL] = None,
+        proxy_auth: Optional[BasicAuth] = None,
+        timeout: Union[ClientTimeout, _SENTINEL] = sentinel,
+        verify_ssl: Optional[bool] = None,
+        fingerprint: Optional[bytes] = None,
+        ssl_context: Optional[SSLContext] = None,
+        ssl: Union[SSLContext, bool, Fingerprint] = True,
+        server_hostname: Optional[str] = None,
+        proxy_headers: Optional[LooseHeaders] = None,
+        trace_request_ctx: Optional[SimpleNamespace] = None,
+        read_bufsize: Optional[int] = None,
+        auto_decompress: Optional[bool] = None,
+        max_line_size: Optional[int] = None,
+        max_field_size: Optional[int] = None,
+    ) -> ClientResponse:
+
+        # NOTE: timeout clamps existing connect and read timeouts.  We cannot
+        # set the default to None because we need to detect if the user wants
+        # to use the existing timeouts by setting timeout to None.
+
+        if self.closed:
+            raise RuntimeError("Session is closed")
+
+        ssl = _merge_ssl_params(ssl, verify_ssl, ssl_context, fingerprint)
+
+        if data is not None and json is not None:
+            raise ValueError(
+                "data and json parameters can not be used at the same time"
+            )
+        elif json is not None:
+            data = payload.JsonPayload(json, dumps=self._json_serialize)
+
+        if not isinstance(chunked, bool) and chunked is not None:
+            warnings.warn("Chunk size is deprecated #1615", DeprecationWarning)
+
+        redirects = 0
+        history = []
+        version = self._version
+        params = params or {}
+
+        # Merge with default headers and transform to CIMultiDict
+        headers = self._prepare_headers(headers)
+        proxy_headers = self._prepare_headers(proxy_headers)
+
+        try:
+            url = self._build_url(str_or_url)
+        except ValueError as e:
+            raise InvalidURL(str_or_url) from e
+
+        skip_headers = set(self._skip_auto_headers)
+        if skip_auto_headers is not None:
+            for i in skip_auto_headers:
+                skip_headers.add(istr(i))
+
+        if proxy is not None:
+            try:
+                proxy = URL(proxy)
+            except ValueError as e:
+                raise InvalidURL(proxy) from e
+
+        if timeout is sentinel:
+            real_timeout: ClientTimeout = self._timeout
+        else:
+            if not isinstance(timeout, ClientTimeout):
+                real_timeout = ClientTimeout(total=timeout)
+            else:
+                real_timeout = timeout
+        # timeout is cumulative for all request operations
+        # (request, redirects, responses, data consuming)
+        tm = TimeoutHandle(
+            self._loop, real_timeout.total, ceil_threshold=real_timeout.ceil_threshold
+        )
+        handle = tm.start()
+
+        if read_bufsize is None:
+            read_bufsize = self._read_bufsize
+
+        if auto_decompress is None:
+            auto_decompress = self._auto_decompress
+
+        if max_line_size is None:
+            max_line_size = self._max_line_size
+
+        if max_field_size is None:
+            max_field_size = self._max_field_size
+
+        traces = [
+            Trace(
+                self,
+                trace_config,
+                trace_config.trace_config_ctx(trace_request_ctx=trace_request_ctx),
+            )
+            for trace_config in self._trace_configs
+        ]
+
+        for trace in traces:
+            await trace.send_request_start(method, url.update_query(params), headers)
+
+        timer = tm.timer()
+        try:
+            with timer:
+                while True:
+                    url, auth_from_url = strip_auth_from_url(url)
+                    if auth and auth_from_url:
+                        raise ValueError(
+                            "Cannot combine AUTH argument with "
+                            "credentials encoded in URL"
+                        )
+
+                    if auth is None:
+                        auth = auth_from_url
+                    if auth is None:
+                        auth = self._default_auth
+                    # It would be confusing if we support explicit
+                    # Authorization header with auth argument
+                    if (
+                        headers is not None
+                        and auth is not None
+                        and hdrs.AUTHORIZATION in headers
+                    ):
+                        raise ValueError(
+                            "Cannot combine AUTHORIZATION header "
+                            "with AUTH argument or credentials "
+                            "encoded in URL"
+                        )
+
+                    all_cookies = self._cookie_jar.filter_cookies(url)
+
+                    if cookies is not None:
+                        tmp_cookie_jar = CookieJar()
+                        tmp_cookie_jar.update_cookies(cookies)
+                        req_cookies = tmp_cookie_jar.filter_cookies(url)
+                        if req_cookies:
+                            all_cookies.load(req_cookies)
+
+                    if proxy is not None:
+                        proxy = URL(proxy)
+                    elif self._trust_env:
+                        with suppress(LookupError):
+                            proxy, proxy_auth = get_env_proxy_for_url(url)
+
+                    req = self._request_class(
+                        method,
+                        url,
+                        params=params,
+                        headers=headers,
+                        skip_auto_headers=skip_headers,
+                        data=data,
+                        cookies=all_cookies,
+                        auth=auth,
+                        version=version,
+                        compress=compress,
+                        chunked=chunked,
+                        expect100=expect100,
+                        loop=self._loop,
+                        response_class=self._response_class,
+                        proxy=proxy,
+                        proxy_auth=proxy_auth,
+                        timer=timer,
+                        session=self,
+                        ssl=ssl if ssl is not None else True,
+                        server_hostname=server_hostname,
+                        proxy_headers=proxy_headers,
+                        traces=traces,
+                        trust_env=self.trust_env,
+                    )
+
+                    # connection timeout
+                    try:
+                        async with ceil_timeout(
+                            real_timeout.connect,
+                            ceil_threshold=real_timeout.ceil_threshold,
+                        ):
+                            assert self._connector is not None
+                            conn = await self._connector.connect(
+                                req, traces=traces, timeout=real_timeout
+                            )
+                    except asyncio.TimeoutError as exc:
+                        raise ServerTimeoutError(
+                            "Connection timeout " "to host {}".format(url)
+                        ) from exc
+
+                    assert conn.transport is not None
+
+                    assert conn.protocol is not None
+                    conn.protocol.set_response_params(
+                        timer=timer,
+                        skip_payload=method_must_be_empty_body(method),
+                        read_until_eof=read_until_eof,
+                        auto_decompress=auto_decompress,
+                        read_timeout=real_timeout.sock_read,
+                        read_bufsize=read_bufsize,
+                        timeout_ceil_threshold=self._connector._timeout_ceil_threshold,
+                        max_line_size=max_line_size,
+                        max_field_size=max_field_size,
+                    )
+
+                    try:
+                        try:
+                            resp = await req.send(conn)
+                            try:
+                                await resp.start(conn)
+                            except BaseException:
+                                resp.close()
+                                raise
+                        except BaseException:
+                            conn.close()
+                            raise
+                    except ClientError:
+                        raise
+                    except OSError as exc:
+                        if exc.errno is None and isinstance(exc, asyncio.TimeoutError):
+                            raise
+                        raise ClientOSError(*exc.args) from exc
+
+                    self._cookie_jar.update_cookies(resp.cookies, resp.url)
+
+                    # redirects
+                    if resp.status in (301, 302, 303, 307, 308) and allow_redirects:
+
+                        for trace in traces:
+                            await trace.send_request_redirect(
+                                method, url.update_query(params), headers, resp
+                            )
+
+                        redirects += 1
+                        history.append(resp)
+                        if max_redirects and redirects >= max_redirects:
+                            resp.close()
+                            raise TooManyRedirects(
+                                history[0].request_info, tuple(history)
+                            )
+
+                        # For 301 and 302, mimic IE, now changed in RFC
+                        # https://github.com/kennethreitz/requests/pull/269
+                        if (resp.status == 303 and resp.method != hdrs.METH_HEAD) or (
+                            resp.status in (301, 302) and resp.method == hdrs.METH_POST
+                        ):
+                            method = hdrs.METH_GET
+                            data = None
+                            if headers.get(hdrs.CONTENT_LENGTH):
+                                headers.pop(hdrs.CONTENT_LENGTH)
+
+                        r_url = resp.headers.get(hdrs.LOCATION) or resp.headers.get(
+                            hdrs.URI
+                        )
+                        if r_url is None:
+                            # see github.com/aio-libs/aiohttp/issues/2022
+                            break
+                        else:
+                            # reading from correct redirection
+                            # response is forbidden
+                            resp.release()
+
+                        try:
+                            parsed_url = URL(
+                                r_url, encoded=not self._requote_redirect_url
+                            )
+
+                        except ValueError as e:
+                            raise InvalidURL(r_url) from e
+
+                        scheme = parsed_url.scheme
+                        if scheme not in ("http", "https", ""):
+                            resp.close()
+                            raise ValueError("Can redirect only to http or https")
+                        elif not scheme:
+                            parsed_url = url.join(parsed_url)
+
+                        if url.origin() != parsed_url.origin():
+                            auth = None
+                            headers.pop(hdrs.AUTHORIZATION, None)
+
+                        url = parsed_url
+                        params = {}
+                        resp.release()
+                        continue
+
+                    break
+
+            # check response status
+            if raise_for_status is None:
+                raise_for_status = self._raise_for_status
+
+            if raise_for_status is None:
+                pass
+            elif callable(raise_for_status):
+                await raise_for_status(resp)
+            elif raise_for_status:
+                resp.raise_for_status()
+
+            # register connection
+            if handle is not None:
+                if resp.connection is not None:
+                    resp.connection.add_callback(handle.cancel)
+                else:
+                    handle.cancel()
+
+            resp._history = tuple(history)
+
+            for trace in traces:
+                await trace.send_request_end(
+                    method, url.update_query(params), headers, resp
+                )
+            return resp
+
+        except BaseException as e:
+            # cleanup timer
+            tm.close()
+            if handle:
+                handle.cancel()
+                handle = None
+
+            for trace in traces:
+                await trace.send_request_exception(
+                    method, url.update_query(params), headers, e
+                )
+            raise
+
+    def ws_connect(
+        self,
+        url: StrOrURL,
+        *,
+        method: str = hdrs.METH_GET,
+        protocols: Iterable[str] = (),
+        timeout: float = 10.0,
+        receive_timeout: Optional[float] = None,
+        autoclose: bool = True,
+        autoping: bool = True,
+        heartbeat: Optional[float] = None,
+        auth: Optional[BasicAuth] = None,
+        origin: Optional[str] = None,
+        params: Optional[Mapping[str, str]] = None,
+        headers: Optional[LooseHeaders] = None,
+        proxy: Optional[StrOrURL] = None,
+        proxy_auth: Optional[BasicAuth] = None,
+        ssl: Union[SSLContext, bool, None, Fingerprint] = True,
+        verify_ssl: Optional[bool] = None,
+        fingerprint: Optional[bytes] = None,
+        ssl_context: Optional[SSLContext] = None,
+        proxy_headers: Optional[LooseHeaders] = None,
+        compress: int = 0,
+        max_msg_size: int = 4 * 1024 * 1024,
+    ) -> "_WSRequestContextManager":
+        """Initiate websocket connection."""
+        return _WSRequestContextManager(
+            self._ws_connect(
+                url,
+                method=method,
+                protocols=protocols,
+                timeout=timeout,
+                receive_timeout=receive_timeout,
+                autoclose=autoclose,
+                autoping=autoping,
+                heartbeat=heartbeat,
+                auth=auth,
+                origin=origin,
+                params=params,
+                headers=headers,
+                proxy=proxy,
+                proxy_auth=proxy_auth,
+                ssl=ssl,
+                verify_ssl=verify_ssl,
+                fingerprint=fingerprint,
+                ssl_context=ssl_context,
+                proxy_headers=proxy_headers,
+                compress=compress,
+                max_msg_size=max_msg_size,
+            )
+        )
+
+    async def _ws_connect(
+        self,
+        url: StrOrURL,
+        *,
+        method: str = hdrs.METH_GET,
+        protocols: Iterable[str] = (),
+        timeout: float = 10.0,
+        receive_timeout: Optional[float] = None,
+        autoclose: bool = True,
+        autoping: bool = True,
+        heartbeat: Optional[float] = None,
+        auth: Optional[BasicAuth] = None,
+        origin: Optional[str] = None,
+        params: Optional[Mapping[str, str]] = None,
+        headers: Optional[LooseHeaders] = None,
+        proxy: Optional[StrOrURL] = None,
+        proxy_auth: Optional[BasicAuth] = None,
+        ssl: Optional[Union[SSLContext, bool, Fingerprint]] = True,
+        verify_ssl: Optional[bool] = None,
+        fingerprint: Optional[bytes] = None,
+        ssl_context: Optional[SSLContext] = None,
+        proxy_headers: Optional[LooseHeaders] = None,
+        compress: int = 0,
+        max_msg_size: int = 4 * 1024 * 1024,
+    ) -> ClientWebSocketResponse:
+
+        if headers is None:
+            real_headers: CIMultiDict[str] = CIMultiDict()
+        else:
+            real_headers = CIMultiDict(headers)
+
+        default_headers = {
+            hdrs.UPGRADE: "websocket",
+            hdrs.CONNECTION: "Upgrade",
+            hdrs.SEC_WEBSOCKET_VERSION: "13",
+        }
+
+        for key, value in default_headers.items():
+            real_headers.setdefault(key, value)
+
+        sec_key = base64.b64encode(os.urandom(16))
+        real_headers[hdrs.SEC_WEBSOCKET_KEY] = sec_key.decode()
+
+        if protocols:
+            real_headers[hdrs.SEC_WEBSOCKET_PROTOCOL] = ",".join(protocols)
+        if origin is not None:
+            real_headers[hdrs.ORIGIN] = origin
+        if compress:
+            extstr = ws_ext_gen(compress=compress)
+            real_headers[hdrs.SEC_WEBSOCKET_EXTENSIONS] = extstr
+
+        # For the sake of backward compatibility, if user passes in None, convert it to True
+        if ssl is None:
+            ssl = True
+        ssl = _merge_ssl_params(ssl, verify_ssl, ssl_context, fingerprint)
+
+        # send request
+        resp = await self.request(
+            method,
+            url,
+            params=params,
+            headers=real_headers,
+            read_until_eof=False,
+            auth=auth,
+            proxy=proxy,
+            proxy_auth=proxy_auth,
+            ssl=ssl,
+            proxy_headers=proxy_headers,
+        )
+
+        try:
+            # check handshake
+            if resp.status != 101:
+                raise WSServerHandshakeError(
+                    resp.request_info,
+                    resp.history,
+                    message="Invalid response status",
+                    status=resp.status,
+                    headers=resp.headers,
+                )
+
+            if resp.headers.get(hdrs.UPGRADE, "").lower() != "websocket":
+                raise WSServerHandshakeError(
+                    resp.request_info,
+                    resp.history,
+                    message="Invalid upgrade header",
+                    status=resp.status,
+                    headers=resp.headers,
+                )
+
+            if resp.headers.get(hdrs.CONNECTION, "").lower() != "upgrade":
+                raise WSServerHandshakeError(
+                    resp.request_info,
+                    resp.history,
+                    message="Invalid connection header",
+                    status=resp.status,
+                    headers=resp.headers,
+                )
+
+            # key calculation
+            r_key = resp.headers.get(hdrs.SEC_WEBSOCKET_ACCEPT, "")
+            match = base64.b64encode(hashlib.sha1(sec_key + WS_KEY).digest()).decode()
+            if r_key != match:
+                raise WSServerHandshakeError(
+                    resp.request_info,
+                    resp.history,
+                    message="Invalid challenge response",
+                    status=resp.status,
+                    headers=resp.headers,
+                )
+
+            # websocket protocol
+            protocol = None
+            if protocols and hdrs.SEC_WEBSOCKET_PROTOCOL in resp.headers:
+                resp_protocols = [
+                    proto.strip()
+                    for proto in resp.headers[hdrs.SEC_WEBSOCKET_PROTOCOL].split(",")
+                ]
+
+                for proto in resp_protocols:
+                    if proto in protocols:
+                        protocol = proto
+                        break
+
+            # websocket compress
+            notakeover = False
+            if compress:
+                compress_hdrs = resp.headers.get(hdrs.SEC_WEBSOCKET_EXTENSIONS)
+                if compress_hdrs:
+                    try:
+                        compress, notakeover = ws_ext_parse(compress_hdrs)
+                    except WSHandshakeError as exc:
+                        raise WSServerHandshakeError(
+                            resp.request_info,
+                            resp.history,
+                            message=exc.args[0],
+                            status=resp.status,
+                            headers=resp.headers,
+                        ) from exc
+                else:
+                    compress = 0
+                    notakeover = False
+
+            conn = resp.connection
+            assert conn is not None
+            conn_proto = conn.protocol
+            assert conn_proto is not None
+            transport = conn.transport
+            assert transport is not None
+            reader: FlowControlDataQueue[WSMessage] = FlowControlDataQueue(
+                conn_proto, 2**16, loop=self._loop
+            )
+            conn_proto.set_parser(WebSocketReader(reader, max_msg_size), reader)
+            writer = WebSocketWriter(
+                conn_proto,
+                transport,
+                use_mask=True,
+                compress=compress,
+                notakeover=notakeover,
+            )
+        except BaseException:
+            resp.close()
+            raise
+        else:
+            return self._ws_response_class(
+                reader,
+                writer,
+                protocol,
+                resp,
+                timeout,
+                autoclose,
+                autoping,
+                self._loop,
+                receive_timeout=receive_timeout,
+                heartbeat=heartbeat,
+                compress=compress,
+                client_notakeover=notakeover,
+            )
+
+    def _prepare_headers(self, headers: Optional[LooseHeaders]) -> "CIMultiDict[str]":
+        """Add default headers and transform it to CIMultiDict"""
+        # Convert headers to MultiDict
+        result = CIMultiDict(self._default_headers)
+        if headers:
+            if not isinstance(headers, (MultiDictProxy, MultiDict)):
+                headers = CIMultiDict(headers)
+            added_names: Set[str] = set()
+            for key, value in headers.items():
+                if key in added_names:
+                    result.add(key, value)
+                else:
+                    result[key] = value
+                    added_names.add(key)
+        return result
+
+    def get(
+        self, url: StrOrURL, *, allow_redirects: bool = True, **kwargs: Any
+    ) -> "_RequestContextManager":
+        """Perform HTTP GET request."""
+        return _RequestContextManager(
+            self._request(hdrs.METH_GET, url, allow_redirects=allow_redirects, **kwargs)
+        )
+
+    def options(
+        self, url: StrOrURL, *, allow_redirects: bool = True, **kwargs: Any
+    ) -> "_RequestContextManager":
+        """Perform HTTP OPTIONS request."""
+        return _RequestContextManager(
+            self._request(
+                hdrs.METH_OPTIONS, url, allow_redirects=allow_redirects, **kwargs
+            )
+        )
+
+    def head(
+        self, url: StrOrURL, *, allow_redirects: bool = False, **kwargs: Any
+    ) -> "_RequestContextManager":
+        """Perform HTTP HEAD request."""
+        return _RequestContextManager(
+            self._request(
+                hdrs.METH_HEAD, url, allow_redirects=allow_redirects, **kwargs
+            )
+        )
+
+    def post(
+        self, url: StrOrURL, *, data: Any = None, **kwargs: Any
+    ) -> "_RequestContextManager":
+        """Perform HTTP POST request."""
+        return _RequestContextManager(
+            self._request(hdrs.METH_POST, url, data=data, **kwargs)
+        )
+
+    def put(
+        self, url: StrOrURL, *, data: Any = None, **kwargs: Any
+    ) -> "_RequestContextManager":
+        """Perform HTTP PUT request."""
+        return _RequestContextManager(
+            self._request(hdrs.METH_PUT, url, data=data, **kwargs)
+        )
+
+    def patch(
+        self, url: StrOrURL, *, data: Any = None, **kwargs: Any
+    ) -> "_RequestContextManager":
+        """Perform HTTP PATCH request."""
+        return _RequestContextManager(
+            self._request(hdrs.METH_PATCH, url, data=data, **kwargs)
+        )
+
+    def delete(self, url: StrOrURL, **kwargs: Any) -> "_RequestContextManager":
+        """Perform HTTP DELETE request."""
+        return _RequestContextManager(self._request(hdrs.METH_DELETE, url, **kwargs))
+
+    async def close(self) -> None:
+        """Close underlying connector.
+
+        Release all acquired resources.
+        """
+        if not self.closed:
+            if self._connector is not None and self._connector_owner:
+                await self._connector.close()
+            self._connector = None
+
+    @property
+    def closed(self) -> bool:
+        """Is client session closed.
+
+        A readonly property.
+        """
+        return self._connector is None or self._connector.closed
+
+    @property
+    def connector(self) -> Optional[BaseConnector]:
+        """Connector instance used for the session."""
+        return self._connector
+
+    @property
+    def cookie_jar(self) -> AbstractCookieJar:
+        """The session cookies."""
+        return self._cookie_jar
+
+    @property
+    def version(self) -> Tuple[int, int]:
+        """The session HTTP protocol version."""
+        return self._version
+
+    @property
+    def requote_redirect_url(self) -> bool:
+        """Do URL requoting on redirection handling."""
+        return self._requote_redirect_url
+
+    @requote_redirect_url.setter
+    def requote_redirect_url(self, val: bool) -> None:
+        """Do URL requoting on redirection handling."""
+        warnings.warn(
+            "session.requote_redirect_url modification " "is deprecated #2778",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        self._requote_redirect_url = val
+
+    @property
+    def loop(self) -> asyncio.AbstractEventLoop:
+        """Session's loop."""
+        warnings.warn(
+            "client.loop property is deprecated", DeprecationWarning, stacklevel=2
+        )
+        return self._loop
+
+    @property
+    def timeout(self) -> ClientTimeout:
+        """Timeout for the session."""
+        return self._timeout
+
+    @property
+    def headers(self) -> "CIMultiDict[str]":
+        """The default headers of the client session."""
+        return self._default_headers
+
+    @property
+    def skip_auto_headers(self) -> FrozenSet[istr]:
+        """Headers for which autogeneration should be skipped"""
+        return self._skip_auto_headers
+
+    @property
+    def auth(self) -> Optional[BasicAuth]:
+        """An object that represents HTTP Basic Authorization"""
+        return self._default_auth
+
+    @property
+    def json_serialize(self) -> JSONEncoder:
+        """Json serializer callable"""
+        return self._json_serialize
+
+    @property
+    def connector_owner(self) -> bool:
+        """Should connector be closed on session closing"""
+        return self._connector_owner
+
+    @property
+    def raise_for_status(
+        self,
+    ) -> Union[bool, Callable[[ClientResponse], Awaitable[None]]]:
+        """Should `ClientResponse.raise_for_status()` be called for each response."""
+        return self._raise_for_status
+
+    @property
+    def auto_decompress(self) -> bool:
+        """Should the body response be automatically decompressed."""
+        return self._auto_decompress
+
+    @property
+    def trust_env(self) -> bool:
+        """
+        Should proxies information from environment or netrc be trusted.
+
+        Information is from HTTP_PROXY / HTTPS_PROXY environment variables
+        or ~/.netrc file if present.
+        """
+        return self._trust_env
+
+    @property
+    def trace_configs(self) -> List[TraceConfig]:
+        """A list of TraceConfig instances used for client tracing"""
+        return self._trace_configs
+
+    def detach(self) -> None:
+        """Detach connector from session without closing the former.
+
+        Session is switched to closed state anyway.
+        """
+        self._connector = None
+
+    def __enter__(self) -> None:
+        raise TypeError("Use async with instead")
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        # __exit__ should exist in pair with __enter__ but never executed
+        pass  # pragma: no cover
+
+    async def __aenter__(self) -> "ClientSession":
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        await self.close()
+
+
+class _BaseRequestContextManager(Coroutine[Any, Any, _RetType], Generic[_RetType]):
+
+    __slots__ = ("_coro", "_resp")
+
+    def __init__(self, coro: Coroutine["asyncio.Future[Any]", None, _RetType]) -> None:
+        self._coro = coro
+
+    def send(self, arg: None) -> "asyncio.Future[Any]":
+        return self._coro.send(arg)
+
+    def throw(self, *args: Any, **kwargs: Any) -> "asyncio.Future[Any]":
+        return self._coro.throw(*args, **kwargs)
+
+    def close(self) -> None:
+        return self._coro.close()
+
+    def __await__(self) -> Generator[Any, None, _RetType]:
+        ret = self._coro.__await__()
+        return ret
+
+    def __iter__(self) -> Generator[Any, None, _RetType]:
+        return self.__await__()
+
+    async def __aenter__(self) -> _RetType:
+        self._resp = await self._coro
+        return self._resp
+
+
+class _RequestContextManager(_BaseRequestContextManager[ClientResponse]):
+    __slots__ = ()
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc: Optional[BaseException],
+        tb: Optional[TracebackType],
+    ) -> None:
+        # We're basing behavior on the exception as it can be caused by
+        # user code unrelated to the status of the connection.  If you
+        # would like to close a connection you must do that
+        # explicitly.  Otherwise connection error handling should kick in
+        # and close/recycle the connection as required.
+        self._resp.release()
+        await self._resp.wait_for_close()
+
+
+class _WSRequestContextManager(_BaseRequestContextManager[ClientWebSocketResponse]):
+    __slots__ = ()
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc: Optional[BaseException],
+        tb: Optional[TracebackType],
+    ) -> None:
+        await self._resp.close()
+
+
+class _SessionRequestContextManager:
+
+    __slots__ = ("_coro", "_resp", "_session")
+
+    def __init__(
+        self,
+        coro: Coroutine["asyncio.Future[Any]", None, ClientResponse],
+        session: ClientSession,
+    ) -> None:
+        self._coro = coro
+        self._resp: Optional[ClientResponse] = None
+        self._session = session
+
+    async def __aenter__(self) -> ClientResponse:
+        try:
+            self._resp = await self._coro
+        except BaseException:
+            await self._session.close()
+            raise
+        else:
+            return self._resp
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc: Optional[BaseException],
+        tb: Optional[TracebackType],
+    ) -> None:
+        assert self._resp is not None
+        self._resp.close()
+        await self._session.close()
+
+
+def request(
+    method: str,
+    url: StrOrURL,
+    *,
+    params: Optional[Mapping[str, str]] = None,
+    data: Any = None,
+    json: Any = None,
+    headers: Optional[LooseHeaders] = None,
+    skip_auto_headers: Optional[Iterable[str]] = None,
+    auth: Optional[BasicAuth] = None,
+    allow_redirects: bool = True,
+    max_redirects: int = 10,
+    compress: Optional[str] = None,
+    chunked: Optional[bool] = None,
+    expect100: bool = False,
+    raise_for_status: Optional[bool] = None,
+    read_until_eof: bool = True,
+    proxy: Optional[StrOrURL] = None,
+    proxy_auth: Optional[BasicAuth] = None,
+    timeout: Union[ClientTimeout, object] = sentinel,
+    cookies: Optional[LooseCookies] = None,
+    version: HttpVersion = http.HttpVersion11,
+    connector: Optional[BaseConnector] = None,
+    read_bufsize: Optional[int] = None,
+    loop: Optional[asyncio.AbstractEventLoop] = None,
+    max_line_size: int = 8190,
+    max_field_size: int = 8190,
+) -> _SessionRequestContextManager:
+    """Constructs and sends a request.
+
+    Returns response object.
+    method - HTTP method
+    url - request url
+    params - (optional) Dictionary or bytes to be sent in the query
+      string of the new request
+    data - (optional) Dictionary, bytes, or file-like object to
+      send in the body of the request
+    json - (optional) Any json compatible python object
+    headers - (optional) Dictionary of HTTP Headers to send with
+      the request
+    cookies - (optional) Dict object to send with the request
+    auth - (optional) BasicAuth named tuple represent HTTP Basic Auth
+    auth - aiohttp.helpers.BasicAuth
+    allow_redirects - (optional) If set to False, do not follow
+      redirects
+    version - Request HTTP version.
+    compress - Set to True if request has to be compressed
+       with deflate encoding.
+    chunked - Set to chunk size for chunked transfer encoding.
+    expect100 - Expect 100-continue response from server.
+    connector - BaseConnector sub-class instance to support
+       connection pooling.
+    read_until_eof - Read response until eof if response
+       does not have Content-Length header.
+    loop - Optional event loop.
+    timeout - Optional ClientTimeout settings structure, 5min
+       total timeout by default.
+    Usage::
+      >>> import aiohttp
+      >>> resp = await aiohttp.request('GET', 'http://python.org/')
+      >>> resp
+      <ClientResponse(python.org/) [200]>
+      >>> data = await resp.read()
+    """
+    connector_owner = False
+    if connector is None:
+        connector_owner = True
+        connector = TCPConnector(loop=loop, force_close=True)
+
+    session = ClientSession(
+        loop=loop,
+        cookies=cookies,
+        version=version,
+        timeout=timeout,
+        connector=connector,
+        connector_owner=connector_owner,
+    )
+
+    return _SessionRequestContextManager(
+        session._request(
+            method,
+            url,
+            params=params,
+            data=data,
+            json=json,
+            headers=headers,
+            skip_auto_headers=skip_auto_headers,
+            auth=auth,
+            allow_redirects=allow_redirects,
+            max_redirects=max_redirects,
+            compress=compress,
+            chunked=chunked,
+            expect100=expect100,
+            raise_for_status=raise_for_status,
+            read_until_eof=read_until_eof,
+            proxy=proxy,
+            proxy_auth=proxy_auth,
+            read_bufsize=read_bufsize,
+            max_line_size=max_line_size,
+            max_field_size=max_field_size,
+        ),
+        session,
+    )
diff --git a/llm/Lib/site-packages/aiohttp/client_exceptions.py b/llm/Lib/site-packages/aiohttp/client_exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..8af265b59a63e7c7ac03849ceabdc04b1e2b03cb
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/client_exceptions.py
@@ -0,0 +1,346 @@
+"""HTTP related errors."""
+
+import asyncio
+import warnings
+from typing import TYPE_CHECKING, Any, Optional, Tuple, Union
+
+from .http_parser import RawResponseMessage
+from .typedefs import LooseHeaders
+
+try:
+    import ssl
+
+    SSLContext = ssl.SSLContext
+except ImportError:  # pragma: no cover
+    ssl = SSLContext = None  # type: ignore[assignment]
+
+
+if TYPE_CHECKING:
+    from .client_reqrep import ClientResponse, ConnectionKey, Fingerprint, RequestInfo
+else:
+    RequestInfo = ClientResponse = ConnectionKey = None
+
+__all__ = (
+    "ClientError",
+    "ClientConnectionError",
+    "ClientOSError",
+    "ClientConnectorError",
+    "ClientProxyConnectionError",
+    "ClientSSLError",
+    "ClientConnectorSSLError",
+    "ClientConnectorCertificateError",
+    "ServerConnectionError",
+    "ServerTimeoutError",
+    "ServerDisconnectedError",
+    "ServerFingerprintMismatch",
+    "ClientResponseError",
+    "ClientHttpProxyError",
+    "WSServerHandshakeError",
+    "ContentTypeError",
+    "ClientPayloadError",
+    "InvalidURL",
+)
+
+
+class ClientError(Exception):
+    """Base class for client connection errors."""
+
+
+class ClientResponseError(ClientError):
+    """Base class for exceptions that occur after getting a response.
+
+    request_info: An instance of RequestInfo.
+    history: A sequence of responses, if redirects occurred.
+    status: HTTP status code.
+    message: Error message.
+    headers: Response headers.
+    """
+
+    def __init__(
+        self,
+        request_info: RequestInfo,
+        history: Tuple[ClientResponse, ...],
+        *,
+        code: Optional[int] = None,
+        status: Optional[int] = None,
+        message: str = "",
+        headers: Optional[LooseHeaders] = None,
+    ) -> None:
+        self.request_info = request_info
+        if code is not None:
+            if status is not None:
+                raise ValueError(
+                    "Both code and status arguments are provided; "
+                    "code is deprecated, use status instead"
+                )
+            warnings.warn(
+                "code argument is deprecated, use status instead",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+        if status is not None:
+            self.status = status
+        elif code is not None:
+            self.status = code
+        else:
+            self.status = 0
+        self.message = message
+        self.headers = headers
+        self.history = history
+        self.args = (request_info, history)
+
+    def __str__(self) -> str:
+        return "{}, message={!r}, url={!r}".format(
+            self.status,
+            self.message,
+            self.request_info.real_url,
+        )
+
+    def __repr__(self) -> str:
+        args = f"{self.request_info!r}, {self.history!r}"
+        if self.status != 0:
+            args += f", status={self.status!r}"
+        if self.message != "":
+            args += f", message={self.message!r}"
+        if self.headers is not None:
+            args += f", headers={self.headers!r}"
+        return f"{type(self).__name__}({args})"
+
+    @property
+    def code(self) -> int:
+        warnings.warn(
+            "code property is deprecated, use status instead",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.status
+
+    @code.setter
+    def code(self, value: int) -> None:
+        warnings.warn(
+            "code property is deprecated, use status instead",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        self.status = value
+
+
+class ContentTypeError(ClientResponseError):
+    """ContentType found is not valid."""
+
+
+class WSServerHandshakeError(ClientResponseError):
+    """websocket server handshake error."""
+
+
+class ClientHttpProxyError(ClientResponseError):
+    """HTTP proxy error.
+
+    Raised in :class:`aiohttp.connector.TCPConnector` if
+    proxy responds with status other than ``200 OK``
+    on ``CONNECT`` request.
+    """
+
+
+class TooManyRedirects(ClientResponseError):
+    """Client was redirected too many times."""
+
+
+class ClientConnectionError(ClientError):
+    """Base class for client socket errors."""
+
+
+class ClientOSError(ClientConnectionError, OSError):
+    """OSError error."""
+
+
+class ClientConnectorError(ClientOSError):
+    """Client connector error.
+
+    Raised in :class:`aiohttp.connector.TCPConnector` if
+        a connection can not be established.
+    """
+
+    def __init__(self, connection_key: ConnectionKey, os_error: OSError) -> None:
+        self._conn_key = connection_key
+        self._os_error = os_error
+        super().__init__(os_error.errno, os_error.strerror)
+        self.args = (connection_key, os_error)
+
+    @property
+    def os_error(self) -> OSError:
+        return self._os_error
+
+    @property
+    def host(self) -> str:
+        return self._conn_key.host
+
+    @property
+    def port(self) -> Optional[int]:
+        return self._conn_key.port
+
+    @property
+    def ssl(self) -> Union[SSLContext, bool, "Fingerprint"]:
+        return self._conn_key.ssl
+
+    def __str__(self) -> str:
+        return "Cannot connect to host {0.host}:{0.port} ssl:{1} [{2}]".format(
+            self, "default" if self.ssl is True else self.ssl, self.strerror
+        )
+
+    # OSError.__reduce__ does too much black magick
+    __reduce__ = BaseException.__reduce__
+
+
+class ClientProxyConnectionError(ClientConnectorError):
+    """Proxy connection error.
+
+    Raised in :class:`aiohttp.connector.TCPConnector` if
+        connection to proxy can not be established.
+    """
+
+
+class UnixClientConnectorError(ClientConnectorError):
+    """Unix connector error.
+
+    Raised in :py:class:`aiohttp.connector.UnixConnector`
+    if connection to unix socket can not be established.
+    """
+
+    def __init__(
+        self, path: str, connection_key: ConnectionKey, os_error: OSError
+    ) -> None:
+        self._path = path
+        super().__init__(connection_key, os_error)
+
+    @property
+    def path(self) -> str:
+        return self._path
+
+    def __str__(self) -> str:
+        return "Cannot connect to unix socket {0.path} ssl:{1} [{2}]".format(
+            self, "default" if self.ssl is True else self.ssl, self.strerror
+        )
+
+
+class ServerConnectionError(ClientConnectionError):
+    """Server connection errors."""
+
+
+class ServerDisconnectedError(ServerConnectionError):
+    """Server disconnected."""
+
+    def __init__(self, message: Union[RawResponseMessage, str, None] = None) -> None:
+        if message is None:
+            message = "Server disconnected"
+
+        self.args = (message,)
+        self.message = message
+
+
+class ServerTimeoutError(ServerConnectionError, asyncio.TimeoutError):
+    """Server timeout error."""
+
+
+class ServerFingerprintMismatch(ServerConnectionError):
+    """SSL certificate does not match expected fingerprint."""
+
+    def __init__(self, expected: bytes, got: bytes, host: str, port: int) -> None:
+        self.expected = expected
+        self.got = got
+        self.host = host
+        self.port = port
+        self.args = (expected, got, host, port)
+
+    def __repr__(self) -> str:
+        return "<{} expected={!r} got={!r} host={!r} port={!r}>".format(
+            self.__class__.__name__, self.expected, self.got, self.host, self.port
+        )
+
+
+class ClientPayloadError(ClientError):
+    """Response payload error."""
+
+
+class InvalidURL(ClientError, ValueError):
+    """Invalid URL.
+
+    URL used for fetching is malformed, e.g. it doesn't contains host
+    part.
+    """
+
+    # Derive from ValueError for backward compatibility
+
+    def __init__(self, url: Any) -> None:
+        # The type of url is not yarl.URL because the exception can be raised
+        # on URL(url) call
+        super().__init__(url)
+
+    @property
+    def url(self) -> Any:
+        return self.args[0]
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} {self.url}>"
+
+
+class ClientSSLError(ClientConnectorError):
+    """Base error for ssl.*Errors."""
+
+
+if ssl is not None:
+    cert_errors = (ssl.CertificateError,)
+    cert_errors_bases = (
+        ClientSSLError,
+        ssl.CertificateError,
+    )
+
+    ssl_errors = (ssl.SSLError,)
+    ssl_error_bases = (ClientSSLError, ssl.SSLError)
+else:  # pragma: no cover
+    cert_errors = tuple()
+    cert_errors_bases = (
+        ClientSSLError,
+        ValueError,
+    )
+
+    ssl_errors = tuple()
+    ssl_error_bases = (ClientSSLError,)
+
+
+class ClientConnectorSSLError(*ssl_error_bases):  # type: ignore[misc]
+    """Response ssl error."""
+
+
+class ClientConnectorCertificateError(*cert_errors_bases):  # type: ignore[misc]
+    """Response certificate error."""
+
+    def __init__(
+        self, connection_key: ConnectionKey, certificate_error: Exception
+    ) -> None:
+        self._conn_key = connection_key
+        self._certificate_error = certificate_error
+        self.args = (connection_key, certificate_error)
+
+    @property
+    def certificate_error(self) -> Exception:
+        return self._certificate_error
+
+    @property
+    def host(self) -> str:
+        return self._conn_key.host
+
+    @property
+    def port(self) -> Optional[int]:
+        return self._conn_key.port
+
+    @property
+    def ssl(self) -> bool:
+        return self._conn_key.is_ssl
+
+    def __str__(self) -> str:
+        return (
+            "Cannot connect to host {0.host}:{0.port} ssl:{0.ssl} "
+            "[{0.certificate_error.__class__.__name__}: "
+            "{0.certificate_error.args}]".format(self)
+        )
diff --git a/llm/Lib/site-packages/aiohttp/client_proto.py b/llm/Lib/site-packages/aiohttp/client_proto.py
new file mode 100644
index 0000000000000000000000000000000000000000..59cf155ccba4b65dcaeff3eacc47b1888b835ce2
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/client_proto.py
@@ -0,0 +1,296 @@
+import asyncio
+from contextlib import suppress
+from typing import Any, Optional, Tuple
+
+from .base_protocol import BaseProtocol
+from .client_exceptions import (
+    ClientOSError,
+    ClientPayloadError,
+    ServerDisconnectedError,
+    ServerTimeoutError,
+)
+from .helpers import (
+    _EXC_SENTINEL,
+    BaseTimerContext,
+    set_exception,
+    status_code_must_be_empty_body,
+)
+from .http import HttpResponseParser, RawResponseMessage
+from .http_exceptions import HttpProcessingError
+from .streams import EMPTY_PAYLOAD, DataQueue, StreamReader
+
+
+class ResponseHandler(BaseProtocol, DataQueue[Tuple[RawResponseMessage, StreamReader]]):
+    """Helper class to adapt between Protocol and StreamReader."""
+
+    def __init__(self, loop: asyncio.AbstractEventLoop) -> None:
+        BaseProtocol.__init__(self, loop=loop)
+        DataQueue.__init__(self, loop)
+
+        self._should_close = False
+
+        self._payload: Optional[StreamReader] = None
+        self._skip_payload = False
+        self._payload_parser = None
+
+        self._timer = None
+
+        self._tail = b""
+        self._upgraded = False
+        self._parser: Optional[HttpResponseParser] = None
+
+        self._read_timeout: Optional[float] = None
+        self._read_timeout_handle: Optional[asyncio.TimerHandle] = None
+
+        self._timeout_ceil_threshold: Optional[float] = 5
+
+    @property
+    def upgraded(self) -> bool:
+        return self._upgraded
+
+    @property
+    def should_close(self) -> bool:
+        if self._payload is not None and not self._payload.is_eof() or self._upgraded:
+            return True
+
+        return (
+            self._should_close
+            or self._upgraded
+            or self.exception() is not None
+            or self._payload_parser is not None
+            or len(self) > 0
+            or bool(self._tail)
+        )
+
+    def force_close(self) -> None:
+        self._should_close = True
+
+    def close(self) -> None:
+        transport = self.transport
+        if transport is not None:
+            transport.close()
+            self.transport = None
+            self._payload = None
+            self._drop_timeout()
+
+    def is_connected(self) -> bool:
+        return self.transport is not None and not self.transport.is_closing()
+
+    def connection_lost(self, exc: Optional[BaseException]) -> None:
+        self._drop_timeout()
+
+        original_connection_error = exc
+        reraised_exc = original_connection_error
+
+        connection_closed_cleanly = original_connection_error is None
+
+        if self._payload_parser is not None:
+            with suppress(Exception):  # FIXME: log this somehow?
+                self._payload_parser.feed_eof()
+
+        uncompleted = None
+        if self._parser is not None:
+            try:
+                uncompleted = self._parser.feed_eof()
+            except Exception as underlying_exc:
+                if self._payload is not None:
+                    client_payload_exc_msg = (
+                        f"Response payload is not completed: {underlying_exc !r}"
+                    )
+                    if not connection_closed_cleanly:
+                        client_payload_exc_msg = (
+                            f"{client_payload_exc_msg !s}. "
+                            f"{original_connection_error !r}"
+                        )
+                    set_exception(
+                        self._payload,
+                        ClientPayloadError(client_payload_exc_msg),
+                        underlying_exc,
+                    )
+
+        if not self.is_eof():
+            if isinstance(original_connection_error, OSError):
+                reraised_exc = ClientOSError(*original_connection_error.args)
+            if connection_closed_cleanly:
+                reraised_exc = ServerDisconnectedError(uncompleted)
+            # assigns self._should_close to True as side effect,
+            # we do it anyway below
+            underlying_non_eof_exc = (
+                _EXC_SENTINEL
+                if connection_closed_cleanly
+                else original_connection_error
+            )
+            assert underlying_non_eof_exc is not None
+            assert reraised_exc is not None
+            self.set_exception(reraised_exc, underlying_non_eof_exc)
+
+        self._should_close = True
+        self._parser = None
+        self._payload = None
+        self._payload_parser = None
+        self._reading_paused = False
+
+        super().connection_lost(reraised_exc)
+
+    def eof_received(self) -> None:
+        # should call parser.feed_eof() most likely
+        self._drop_timeout()
+
+    def pause_reading(self) -> None:
+        super().pause_reading()
+        self._drop_timeout()
+
+    def resume_reading(self) -> None:
+        super().resume_reading()
+        self._reschedule_timeout()
+
+    def set_exception(
+        self,
+        exc: BaseException,
+        exc_cause: BaseException = _EXC_SENTINEL,
+    ) -> None:
+        self._should_close = True
+        self._drop_timeout()
+        super().set_exception(exc, exc_cause)
+
+    def set_parser(self, parser: Any, payload: Any) -> None:
+        # TODO: actual types are:
+        #   parser: WebSocketReader
+        #   payload: FlowControlDataQueue
+        # but they are not generi enough
+        # Need an ABC for both types
+        self._payload = payload
+        self._payload_parser = parser
+
+        self._drop_timeout()
+
+        if self._tail:
+            data, self._tail = self._tail, b""
+            self.data_received(data)
+
+    def set_response_params(
+        self,
+        *,
+        timer: Optional[BaseTimerContext] = None,
+        skip_payload: bool = False,
+        read_until_eof: bool = False,
+        auto_decompress: bool = True,
+        read_timeout: Optional[float] = None,
+        read_bufsize: int = 2**16,
+        timeout_ceil_threshold: float = 5,
+        max_line_size: int = 8190,
+        max_field_size: int = 8190,
+    ) -> None:
+        self._skip_payload = skip_payload
+
+        self._read_timeout = read_timeout
+
+        self._timeout_ceil_threshold = timeout_ceil_threshold
+
+        self._parser = HttpResponseParser(
+            self,
+            self._loop,
+            read_bufsize,
+            timer=timer,
+            payload_exception=ClientPayloadError,
+            response_with_body=not skip_payload,
+            read_until_eof=read_until_eof,
+            auto_decompress=auto_decompress,
+            max_line_size=max_line_size,
+            max_field_size=max_field_size,
+        )
+
+        if self._tail:
+            data, self._tail = self._tail, b""
+            self.data_received(data)
+
+    def _drop_timeout(self) -> None:
+        if self._read_timeout_handle is not None:
+            self._read_timeout_handle.cancel()
+            self._read_timeout_handle = None
+
+    def _reschedule_timeout(self) -> None:
+        timeout = self._read_timeout
+        if self._read_timeout_handle is not None:
+            self._read_timeout_handle.cancel()
+
+        if timeout:
+            self._read_timeout_handle = self._loop.call_later(
+                timeout, self._on_read_timeout
+            )
+        else:
+            self._read_timeout_handle = None
+
+    def start_timeout(self) -> None:
+        self._reschedule_timeout()
+
+    def _on_read_timeout(self) -> None:
+        exc = ServerTimeoutError("Timeout on reading data from socket")
+        self.set_exception(exc)
+        if self._payload is not None:
+            set_exception(self._payload, exc)
+
+    def data_received(self, data: bytes) -> None:
+        self._reschedule_timeout()
+
+        if not data:
+            return
+
+        # custom payload parser
+        if self._payload_parser is not None:
+            eof, tail = self._payload_parser.feed_data(data)
+            if eof:
+                self._payload = None
+                self._payload_parser = None
+
+                if tail:
+                    self.data_received(tail)
+            return
+        else:
+            if self._upgraded or self._parser is None:
+                # i.e. websocket connection, websocket parser is not set yet
+                self._tail += data
+            else:
+                # parse http messages
+                try:
+                    messages, upgraded, tail = self._parser.feed_data(data)
+                except BaseException as underlying_exc:
+                    if self.transport is not None:
+                        # connection.release() could be called BEFORE
+                        # data_received(), the transport is already
+                        # closed in this case
+                        self.transport.close()
+                    # should_close is True after the call
+                    self.set_exception(HttpProcessingError(), underlying_exc)
+                    return
+
+                self._upgraded = upgraded
+
+                payload: Optional[StreamReader] = None
+                for message, payload in messages:
+                    if message.should_close:
+                        self._should_close = True
+
+                    self._payload = payload
+
+                    if self._skip_payload or status_code_must_be_empty_body(
+                        message.code
+                    ):
+                        self.feed_data((message, EMPTY_PAYLOAD), 0)
+                    else:
+                        self.feed_data((message, payload), 0)
+                if payload is not None:
+                    # new message(s) was processed
+                    # register timeout handler unsubscribing
+                    # either on end-of-stream or immediately for
+                    # EMPTY_PAYLOAD
+                    if payload is not EMPTY_PAYLOAD:
+                        payload.on_eof(self._drop_timeout)
+                    else:
+                        self._drop_timeout()
+
+                if tail:
+                    if upgraded:
+                        self.data_received(tail)
+                    else:
+                        self._tail = tail
diff --git a/llm/Lib/site-packages/aiohttp/client_reqrep.py b/llm/Lib/site-packages/aiohttp/client_reqrep.py
new file mode 100644
index 0000000000000000000000000000000000000000..9bb7e51b7a886c5435e79ed8cd5ad777b91aebad
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/client_reqrep.py
@@ -0,0 +1,1207 @@
+import asyncio
+import codecs
+import contextlib
+import functools
+import io
+import re
+import sys
+import traceback
+import warnings
+from hashlib import md5, sha1, sha256
+from http.cookies import CookieError, Morsel, SimpleCookie
+from types import MappingProxyType, TracebackType
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+
+import attr
+from multidict import CIMultiDict, CIMultiDictProxy, MultiDict, MultiDictProxy
+from yarl import URL
+
+from . import hdrs, helpers, http, multipart, payload
+from .abc import AbstractStreamWriter
+from .client_exceptions import (
+    ClientConnectionError,
+    ClientOSError,
+    ClientResponseError,
+    ContentTypeError,
+    InvalidURL,
+    ServerFingerprintMismatch,
+)
+from .compression_utils import HAS_BROTLI
+from .formdata import FormData
+from .helpers import (
+    BaseTimerContext,
+    BasicAuth,
+    HeadersMixin,
+    TimerNoop,
+    basicauth_from_netrc,
+    netrc_from_env,
+    noop,
+    reify,
+    set_exception,
+    set_result,
+)
+from .http import (
+    SERVER_SOFTWARE,
+    HttpVersion,
+    HttpVersion10,
+    HttpVersion11,
+    StreamWriter,
+)
+from .log import client_logger
+from .streams import StreamReader
+from .typedefs import (
+    DEFAULT_JSON_DECODER,
+    JSONDecoder,
+    LooseCookies,
+    LooseHeaders,
+    RawHeaders,
+)
+
+try:
+    import ssl
+    from ssl import SSLContext
+except ImportError:  # pragma: no cover
+    ssl = None  # type: ignore[assignment]
+    SSLContext = object  # type: ignore[misc,assignment]
+
+
+__all__ = ("ClientRequest", "ClientResponse", "RequestInfo", "Fingerprint")
+
+
+if TYPE_CHECKING:
+    from .client import ClientSession
+    from .connector import Connection
+    from .tracing import Trace
+
+
+_CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]")
+json_re = re.compile(r"^application/(?:[\w.+-]+?\+)?json")
+
+
+def _gen_default_accept_encoding() -> str:
+    return "gzip, deflate, br" if HAS_BROTLI else "gzip, deflate"
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class ContentDisposition:
+    type: Optional[str]
+    parameters: "MappingProxyType[str, str]"
+    filename: Optional[str]
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class RequestInfo:
+    url: URL
+    method: str
+    headers: "CIMultiDictProxy[str]"
+    real_url: URL = attr.ib()
+
+    @real_url.default
+    def real_url_default(self) -> URL:
+        return self.url
+
+
+class Fingerprint:
+    HASHFUNC_BY_DIGESTLEN = {
+        16: md5,
+        20: sha1,
+        32: sha256,
+    }
+
+    def __init__(self, fingerprint: bytes) -> None:
+        digestlen = len(fingerprint)
+        hashfunc = self.HASHFUNC_BY_DIGESTLEN.get(digestlen)
+        if not hashfunc:
+            raise ValueError("fingerprint has invalid length")
+        elif hashfunc is md5 or hashfunc is sha1:
+            raise ValueError(
+                "md5 and sha1 are insecure and " "not supported. Use sha256."
+            )
+        self._hashfunc = hashfunc
+        self._fingerprint = fingerprint
+
+    @property
+    def fingerprint(self) -> bytes:
+        return self._fingerprint
+
+    def check(self, transport: asyncio.Transport) -> None:
+        if not transport.get_extra_info("sslcontext"):
+            return
+        sslobj = transport.get_extra_info("ssl_object")
+        cert = sslobj.getpeercert(binary_form=True)
+        got = self._hashfunc(cert).digest()
+        if got != self._fingerprint:
+            host, port, *_ = transport.get_extra_info("peername")
+            raise ServerFingerprintMismatch(self._fingerprint, got, host, port)
+
+
+if ssl is not None:
+    SSL_ALLOWED_TYPES = (ssl.SSLContext, bool, Fingerprint, type(None))
+else:  # pragma: no cover
+    SSL_ALLOWED_TYPES = (bool, type(None))
+
+
+def _merge_ssl_params(
+    ssl: Union["SSLContext", bool, Fingerprint],
+    verify_ssl: Optional[bool],
+    ssl_context: Optional["SSLContext"],
+    fingerprint: Optional[bytes],
+) -> Union["SSLContext", bool, Fingerprint]:
+    if ssl is None:
+        ssl = True  # Double check for backwards compatibility
+    if verify_ssl is not None and not verify_ssl:
+        warnings.warn(
+            "verify_ssl is deprecated, use ssl=False instead",
+            DeprecationWarning,
+            stacklevel=3,
+        )
+        if ssl is not True:
+            raise ValueError(
+                "verify_ssl, ssl_context, fingerprint and ssl "
+                "parameters are mutually exclusive"
+            )
+        else:
+            ssl = False
+    if ssl_context is not None:
+        warnings.warn(
+            "ssl_context is deprecated, use ssl=context instead",
+            DeprecationWarning,
+            stacklevel=3,
+        )
+        if ssl is not True:
+            raise ValueError(
+                "verify_ssl, ssl_context, fingerprint and ssl "
+                "parameters are mutually exclusive"
+            )
+        else:
+            ssl = ssl_context
+    if fingerprint is not None:
+        warnings.warn(
+            "fingerprint is deprecated, " "use ssl=Fingerprint(fingerprint) instead",
+            DeprecationWarning,
+            stacklevel=3,
+        )
+        if ssl is not True:
+            raise ValueError(
+                "verify_ssl, ssl_context, fingerprint and ssl "
+                "parameters are mutually exclusive"
+            )
+        else:
+            ssl = Fingerprint(fingerprint)
+    if not isinstance(ssl, SSL_ALLOWED_TYPES):
+        raise TypeError(
+            "ssl should be SSLContext, bool, Fingerprint or None, "
+            "got {!r} instead.".format(ssl)
+        )
+    return ssl
+
+
+@attr.s(auto_attribs=True, slots=True, frozen=True)
+class ConnectionKey:
+    # the key should contain an information about used proxy / TLS
+    # to prevent reusing wrong connections from a pool
+    host: str
+    port: Optional[int]
+    is_ssl: bool
+    ssl: Union[SSLContext, bool, Fingerprint]
+    proxy: Optional[URL]
+    proxy_auth: Optional[BasicAuth]
+    proxy_headers_hash: Optional[int]  # hash(CIMultiDict)
+
+
+def _is_expected_content_type(
+    response_content_type: str, expected_content_type: str
+) -> bool:
+    if expected_content_type == "application/json":
+        return json_re.match(response_content_type) is not None
+    return expected_content_type in response_content_type
+
+
+class ClientRequest:
+    GET_METHODS = {
+        hdrs.METH_GET,
+        hdrs.METH_HEAD,
+        hdrs.METH_OPTIONS,
+        hdrs.METH_TRACE,
+    }
+    POST_METHODS = {hdrs.METH_PATCH, hdrs.METH_POST, hdrs.METH_PUT}
+    ALL_METHODS = GET_METHODS.union(POST_METHODS).union({hdrs.METH_DELETE})
+
+    DEFAULT_HEADERS = {
+        hdrs.ACCEPT: "*/*",
+        hdrs.ACCEPT_ENCODING: _gen_default_accept_encoding(),
+    }
+
+    body = b""
+    auth = None
+    response = None
+
+    __writer = None  # async task for streaming data
+    _continue = None  # waiter future for '100 Continue' response
+
+    # N.B.
+    # Adding __del__ method with self._writer closing doesn't make sense
+    # because _writer is instance method, thus it keeps a reference to self.
+    # Until writer has finished finalizer will not be called.
+
+    def __init__(
+        self,
+        method: str,
+        url: URL,
+        *,
+        params: Optional[Mapping[str, str]] = None,
+        headers: Optional[LooseHeaders] = None,
+        skip_auto_headers: Iterable[str] = frozenset(),
+        data: Any = None,
+        cookies: Optional[LooseCookies] = None,
+        auth: Optional[BasicAuth] = None,
+        version: http.HttpVersion = http.HttpVersion11,
+        compress: Optional[str] = None,
+        chunked: Optional[bool] = None,
+        expect100: bool = False,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        response_class: Optional[Type["ClientResponse"]] = None,
+        proxy: Optional[URL] = None,
+        proxy_auth: Optional[BasicAuth] = None,
+        timer: Optional[BaseTimerContext] = None,
+        session: Optional["ClientSession"] = None,
+        ssl: Union[SSLContext, bool, Fingerprint] = True,
+        proxy_headers: Optional[LooseHeaders] = None,
+        traces: Optional[List["Trace"]] = None,
+        trust_env: bool = False,
+        server_hostname: Optional[str] = None,
+    ):
+        if loop is None:
+            loop = asyncio.get_event_loop()
+
+        match = _CONTAINS_CONTROL_CHAR_RE.search(method)
+        if match:
+            raise ValueError(
+                f"Method cannot contain non-token characters {method!r} "
+                "(found at least {match.group()!r})"
+            )
+
+        assert isinstance(url, URL), url
+        assert isinstance(proxy, (URL, type(None))), proxy
+        # FIXME: session is None in tests only, need to fix tests
+        # assert session is not None
+        self._session = cast("ClientSession", session)
+        if params:
+            q = MultiDict(url.query)
+            url2 = url.with_query(params)
+            q.extend(url2.query)
+            url = url.with_query(q)
+        self.original_url = url
+        self.url = url.with_fragment(None)
+        self.method = method.upper()
+        self.chunked = chunked
+        self.compress = compress
+        self.loop = loop
+        self.length = None
+        if response_class is None:
+            real_response_class = ClientResponse
+        else:
+            real_response_class = response_class
+        self.response_class: Type[ClientResponse] = real_response_class
+        self._timer = timer if timer is not None else TimerNoop()
+        self._ssl = ssl if ssl is not None else True
+        self.server_hostname = server_hostname
+
+        if loop.get_debug():
+            self._source_traceback = traceback.extract_stack(sys._getframe(1))
+
+        self.update_version(version)
+        self.update_host(url)
+        self.update_headers(headers)
+        self.update_auto_headers(skip_auto_headers)
+        self.update_cookies(cookies)
+        self.update_content_encoding(data)
+        self.update_auth(auth, trust_env)
+        self.update_proxy(proxy, proxy_auth, proxy_headers)
+
+        self.update_body_from_data(data)
+        if data is not None or self.method not in self.GET_METHODS:
+            self.update_transfer_encoding()
+        self.update_expect_continue(expect100)
+        if traces is None:
+            traces = []
+        self._traces = traces
+
+    def __reset_writer(self, _: object = None) -> None:
+        self.__writer = None
+
+    @property
+    def _writer(self) -> Optional["asyncio.Task[None]"]:
+        return self.__writer
+
+    @_writer.setter
+    def _writer(self, writer: Optional["asyncio.Task[None]"]) -> None:
+        if self.__writer is not None:
+            self.__writer.remove_done_callback(self.__reset_writer)
+        self.__writer = writer
+        if writer is not None:
+            writer.add_done_callback(self.__reset_writer)
+
+    def is_ssl(self) -> bool:
+        return self.url.scheme in ("https", "wss")
+
+    @property
+    def ssl(self) -> Union["SSLContext", bool, Fingerprint]:
+        return self._ssl
+
+    @property
+    def connection_key(self) -> ConnectionKey:
+        proxy_headers = self.proxy_headers
+        if proxy_headers:
+            h: Optional[int] = hash(tuple((k, v) for k, v in proxy_headers.items()))
+        else:
+            h = None
+        return ConnectionKey(
+            self.host,
+            self.port,
+            self.is_ssl(),
+            self.ssl,
+            self.proxy,
+            self.proxy_auth,
+            h,
+        )
+
+    @property
+    def host(self) -> str:
+        ret = self.url.raw_host
+        assert ret is not None
+        return ret
+
+    @property
+    def port(self) -> Optional[int]:
+        return self.url.port
+
+    @property
+    def request_info(self) -> RequestInfo:
+        headers: CIMultiDictProxy[str] = CIMultiDictProxy(self.headers)
+        return RequestInfo(self.url, self.method, headers, self.original_url)
+
+    def update_host(self, url: URL) -> None:
+        """Update destination host, port and connection type (ssl)."""
+        # get host/port
+        if not url.raw_host:
+            raise InvalidURL(url)
+
+        # basic auth info
+        username, password = url.user, url.password
+        if username:
+            self.auth = helpers.BasicAuth(username, password or "")
+
+    def update_version(self, version: Union[http.HttpVersion, str]) -> None:
+        """Convert request version to two elements tuple.
+
+        parser HTTP version '1.1' => (1, 1)
+        """
+        if isinstance(version, str):
+            v = [part.strip() for part in version.split(".", 1)]
+            try:
+                version = http.HttpVersion(int(v[0]), int(v[1]))
+            except ValueError:
+                raise ValueError(
+                    f"Can not parse http version number: {version}"
+                ) from None
+        self.version = version
+
+    def update_headers(self, headers: Optional[LooseHeaders]) -> None:
+        """Update request headers."""
+        self.headers: CIMultiDict[str] = CIMultiDict()
+
+        # add host
+        netloc = cast(str, self.url.raw_host)
+        if helpers.is_ipv6_address(netloc):
+            netloc = f"[{netloc}]"
+        # See https://github.com/aio-libs/aiohttp/issues/3636.
+        netloc = netloc.rstrip(".")
+        if self.url.port is not None and not self.url.is_default_port():
+            netloc += ":" + str(self.url.port)
+        self.headers[hdrs.HOST] = netloc
+
+        if headers:
+            if isinstance(headers, (dict, MultiDictProxy, MultiDict)):
+                headers = headers.items()  # type: ignore[assignment]
+
+            for key, value in headers:  # type: ignore[misc]
+                # A special case for Host header
+                if key.lower() == "host":
+                    self.headers[key] = value
+                else:
+                    self.headers.add(key, value)
+
+    def update_auto_headers(self, skip_auto_headers: Iterable[str]) -> None:
+        self.skip_auto_headers = CIMultiDict(
+            (hdr, None) for hdr in sorted(skip_auto_headers)
+        )
+        used_headers = self.headers.copy()
+        used_headers.extend(self.skip_auto_headers)  # type: ignore[arg-type]
+
+        for hdr, val in self.DEFAULT_HEADERS.items():
+            if hdr not in used_headers:
+                self.headers.add(hdr, val)
+
+        if hdrs.USER_AGENT not in used_headers:
+            self.headers[hdrs.USER_AGENT] = SERVER_SOFTWARE
+
+    def update_cookies(self, cookies: Optional[LooseCookies]) -> None:
+        """Update request cookies header."""
+        if not cookies:
+            return
+
+        c = SimpleCookie()
+        if hdrs.COOKIE in self.headers:
+            c.load(self.headers.get(hdrs.COOKIE, ""))
+            del self.headers[hdrs.COOKIE]
+
+        if isinstance(cookies, Mapping):
+            iter_cookies = cookies.items()
+        else:
+            iter_cookies = cookies  # type: ignore[assignment]
+        for name, value in iter_cookies:
+            if isinstance(value, Morsel):
+                # Preserve coded_value
+                mrsl_val = value.get(value.key, Morsel())
+                mrsl_val.set(value.key, value.value, value.coded_value)
+                c[name] = mrsl_val
+            else:
+                c[name] = value  # type: ignore[assignment]
+
+        self.headers[hdrs.COOKIE] = c.output(header="", sep=";").strip()
+
+    def update_content_encoding(self, data: Any) -> None:
+        """Set request content encoding."""
+        if data is None:
+            return
+
+        enc = self.headers.get(hdrs.CONTENT_ENCODING, "").lower()
+        if enc:
+            if self.compress:
+                raise ValueError(
+                    "compress can not be set " "if Content-Encoding header is set"
+                )
+        elif self.compress:
+            if not isinstance(self.compress, str):
+                self.compress = "deflate"
+            self.headers[hdrs.CONTENT_ENCODING] = self.compress
+            self.chunked = True  # enable chunked, no need to deal with length
+
+    def update_transfer_encoding(self) -> None:
+        """Analyze transfer-encoding header."""
+        te = self.headers.get(hdrs.TRANSFER_ENCODING, "").lower()
+
+        if "chunked" in te:
+            if self.chunked:
+                raise ValueError(
+                    "chunked can not be set "
+                    'if "Transfer-Encoding: chunked" header is set'
+                )
+
+        elif self.chunked:
+            if hdrs.CONTENT_LENGTH in self.headers:
+                raise ValueError(
+                    "chunked can not be set " "if Content-Length header is set"
+                )
+
+            self.headers[hdrs.TRANSFER_ENCODING] = "chunked"
+        else:
+            if hdrs.CONTENT_LENGTH not in self.headers:
+                self.headers[hdrs.CONTENT_LENGTH] = str(len(self.body))
+
+    def update_auth(self, auth: Optional[BasicAuth], trust_env: bool = False) -> None:
+        """Set basic auth."""
+        if auth is None:
+            auth = self.auth
+        if auth is None and trust_env and self.url.host is not None:
+            netrc_obj = netrc_from_env()
+            with contextlib.suppress(LookupError):
+                auth = basicauth_from_netrc(netrc_obj, self.url.host)
+        if auth is None:
+            return
+
+        if not isinstance(auth, helpers.BasicAuth):
+            raise TypeError("BasicAuth() tuple is required instead")
+
+        self.headers[hdrs.AUTHORIZATION] = auth.encode()
+
+    def update_body_from_data(self, body: Any) -> None:
+        if body is None:
+            return
+
+        # FormData
+        if isinstance(body, FormData):
+            body = body()
+
+        try:
+            body = payload.PAYLOAD_REGISTRY.get(body, disposition=None)
+        except payload.LookupError:
+            body = FormData(body)()
+
+        self.body = body
+
+        # enable chunked encoding if needed
+        if not self.chunked:
+            if hdrs.CONTENT_LENGTH not in self.headers:
+                size = body.size
+                if size is None:
+                    self.chunked = True
+                else:
+                    if hdrs.CONTENT_LENGTH not in self.headers:
+                        self.headers[hdrs.CONTENT_LENGTH] = str(size)
+
+        # copy payload headers
+        assert body.headers
+        for (key, value) in body.headers.items():
+            if key in self.headers:
+                continue
+            if key in self.skip_auto_headers:
+                continue
+            self.headers[key] = value
+
+    def update_expect_continue(self, expect: bool = False) -> None:
+        if expect:
+            self.headers[hdrs.EXPECT] = "100-continue"
+        elif self.headers.get(hdrs.EXPECT, "").lower() == "100-continue":
+            expect = True
+
+        if expect:
+            self._continue = self.loop.create_future()
+
+    def update_proxy(
+        self,
+        proxy: Optional[URL],
+        proxy_auth: Optional[BasicAuth],
+        proxy_headers: Optional[LooseHeaders],
+    ) -> None:
+        if proxy_auth and not isinstance(proxy_auth, helpers.BasicAuth):
+            raise ValueError("proxy_auth must be None or BasicAuth() tuple")
+        self.proxy = proxy
+        self.proxy_auth = proxy_auth
+        self.proxy_headers = proxy_headers
+
+    def keep_alive(self) -> bool:
+        if self.version < HttpVersion10:
+            # keep alive not supported at all
+            return False
+        if self.version == HttpVersion10:
+            if self.headers.get(hdrs.CONNECTION) == "keep-alive":
+                return True
+            else:  # no headers means we close for Http 1.0
+                return False
+        elif self.headers.get(hdrs.CONNECTION) == "close":
+            return False
+
+        return True
+
+    async def write_bytes(
+        self, writer: AbstractStreamWriter, conn: "Connection"
+    ) -> None:
+        """Support coroutines that yields bytes objects."""
+        # 100 response
+        if self._continue is not None:
+            try:
+                await writer.drain()
+                await self._continue
+            except asyncio.CancelledError:
+                return
+
+        protocol = conn.protocol
+        assert protocol is not None
+        try:
+            if isinstance(self.body, payload.Payload):
+                await self.body.write(writer)
+            else:
+                if isinstance(self.body, (bytes, bytearray)):
+                    self.body = (self.body,)  # type: ignore[assignment]
+
+                for chunk in self.body:
+                    await writer.write(chunk)  # type: ignore[arg-type]
+        except OSError as underlying_exc:
+            reraised_exc = underlying_exc
+
+            exc_is_not_timeout = underlying_exc.errno is not None or not isinstance(
+                underlying_exc, asyncio.TimeoutError
+            )
+            if exc_is_not_timeout:
+                reraised_exc = ClientOSError(
+                    underlying_exc.errno,
+                    f"Can not write request body for {self.url !s}",
+                )
+
+            set_exception(protocol, reraised_exc, underlying_exc)
+        except asyncio.CancelledError:
+            await writer.write_eof()
+        except Exception as underlying_exc:
+            set_exception(
+                protocol,
+                ClientConnectionError(
+                    f"Failed to send bytes into the underlying connection {conn !s}",
+                ),
+                underlying_exc,
+            )
+        else:
+            await writer.write_eof()
+            protocol.start_timeout()
+
+    async def send(self, conn: "Connection") -> "ClientResponse":
+        # Specify request target:
+        # - CONNECT request must send authority form URI
+        # - not CONNECT proxy must send absolute form URI
+        # - most common is origin form URI
+        if self.method == hdrs.METH_CONNECT:
+            connect_host = self.url.raw_host
+            assert connect_host is not None
+            if helpers.is_ipv6_address(connect_host):
+                connect_host = f"[{connect_host}]"
+            path = f"{connect_host}:{self.url.port}"
+        elif self.proxy and not self.is_ssl():
+            path = str(self.url)
+        else:
+            path = self.url.raw_path
+            if self.url.raw_query_string:
+                path += "?" + self.url.raw_query_string
+
+        protocol = conn.protocol
+        assert protocol is not None
+        writer = StreamWriter(
+            protocol,
+            self.loop,
+            on_chunk_sent=functools.partial(
+                self._on_chunk_request_sent, self.method, self.url
+            ),
+            on_headers_sent=functools.partial(
+                self._on_headers_request_sent, self.method, self.url
+            ),
+        )
+
+        if self.compress:
+            writer.enable_compression(self.compress)
+
+        if self.chunked is not None:
+            writer.enable_chunking()
+
+        # set default content-type
+        if (
+            self.method in self.POST_METHODS
+            and hdrs.CONTENT_TYPE not in self.skip_auto_headers
+            and hdrs.CONTENT_TYPE not in self.headers
+        ):
+            self.headers[hdrs.CONTENT_TYPE] = "application/octet-stream"
+
+        # set the connection header
+        connection = self.headers.get(hdrs.CONNECTION)
+        if not connection:
+            if self.keep_alive():
+                if self.version == HttpVersion10:
+                    connection = "keep-alive"
+            else:
+                if self.version == HttpVersion11:
+                    connection = "close"
+
+        if connection is not None:
+            self.headers[hdrs.CONNECTION] = connection
+
+        # status + headers
+        status_line = "{0} {1} HTTP/{v.major}.{v.minor}".format(
+            self.method, path, v=self.version
+        )
+        await writer.write_headers(status_line, self.headers)
+
+        self._writer = self.loop.create_task(self.write_bytes(writer, conn))
+
+        response_class = self.response_class
+        assert response_class is not None
+        self.response = response_class(
+            self.method,
+            self.original_url,
+            writer=self._writer,
+            continue100=self._continue,
+            timer=self._timer,
+            request_info=self.request_info,
+            traces=self._traces,
+            loop=self.loop,
+            session=self._session,
+        )
+        return self.response
+
+    async def close(self) -> None:
+        if self._writer is not None:
+            with contextlib.suppress(asyncio.CancelledError):
+                await self._writer
+
+    def terminate(self) -> None:
+        if self._writer is not None:
+            if not self.loop.is_closed():
+                self._writer.cancel()
+            self._writer.remove_done_callback(self.__reset_writer)
+            self._writer = None
+
+    async def _on_chunk_request_sent(self, method: str, url: URL, chunk: bytes) -> None:
+        for trace in self._traces:
+            await trace.send_request_chunk_sent(method, url, chunk)
+
+    async def _on_headers_request_sent(
+        self, method: str, url: URL, headers: "CIMultiDict[str]"
+    ) -> None:
+        for trace in self._traces:
+            await trace.send_request_headers(method, url, headers)
+
+
+class ClientResponse(HeadersMixin):
+
+    # Some of these attributes are None when created,
+    # but will be set by the start() method.
+    # As the end user will likely never see the None values, we cheat the types below.
+    # from the Status-Line of the response
+    version: Optional[HttpVersion] = None  # HTTP-Version
+    status: int = None  # type: ignore[assignment] # Status-Code
+    reason: Optional[str] = None  # Reason-Phrase
+
+    content: StreamReader = None  # type: ignore[assignment]  # Payload stream
+    _headers: CIMultiDictProxy[str] = None  # type: ignore[assignment]
+    _raw_headers: RawHeaders = None  # type: ignore[assignment]
+
+    _connection = None  # current connection
+    _source_traceback: Optional[traceback.StackSummary] = None
+    # set up by ClientRequest after ClientResponse object creation
+    # post-init stage allows to not change ctor signature
+    _closed = True  # to allow __del__ for non-initialized properly response
+    _released = False
+    __writer = None
+
+    def __init__(
+        self,
+        method: str,
+        url: URL,
+        *,
+        writer: "asyncio.Task[None]",
+        continue100: Optional["asyncio.Future[bool]"],
+        timer: BaseTimerContext,
+        request_info: RequestInfo,
+        traces: List["Trace"],
+        loop: asyncio.AbstractEventLoop,
+        session: "ClientSession",
+    ) -> None:
+        assert isinstance(url, URL)
+
+        self.method = method
+        self.cookies = SimpleCookie()
+
+        self._real_url = url
+        self._url = url.with_fragment(None)
+        self._body: Any = None
+        self._writer: Optional[asyncio.Task[None]] = writer
+        self._continue = continue100  # None by default
+        self._closed = True
+        self._history: Tuple[ClientResponse, ...] = ()
+        self._request_info = request_info
+        self._timer = timer if timer is not None else TimerNoop()
+        self._cache: Dict[str, Any] = {}
+        self._traces = traces
+        self._loop = loop
+        # store a reference to session #1985
+        self._session: Optional[ClientSession] = session
+        # Save reference to _resolve_charset, so that get_encoding() will still
+        # work after the response has finished reading the body.
+        if session is None:
+            # TODO: Fix session=None in tests (see ClientRequest.__init__).
+            self._resolve_charset: Callable[
+                ["ClientResponse", bytes], str
+            ] = lambda *_: "utf-8"
+        else:
+            self._resolve_charset = session._resolve_charset
+        if loop.get_debug():
+            self._source_traceback = traceback.extract_stack(sys._getframe(1))
+
+    def __reset_writer(self, _: object = None) -> None:
+        self.__writer = None
+
+    @property
+    def _writer(self) -> Optional["asyncio.Task[None]"]:
+        return self.__writer
+
+    @_writer.setter
+    def _writer(self, writer: Optional["asyncio.Task[None]"]) -> None:
+        if self.__writer is not None:
+            self.__writer.remove_done_callback(self.__reset_writer)
+        self.__writer = writer
+        if writer is not None:
+            writer.add_done_callback(self.__reset_writer)
+
+    @reify
+    def url(self) -> URL:
+        return self._url
+
+    @reify
+    def url_obj(self) -> URL:
+        warnings.warn("Deprecated, use .url #1654", DeprecationWarning, stacklevel=2)
+        return self._url
+
+    @reify
+    def real_url(self) -> URL:
+        return self._real_url
+
+    @reify
+    def host(self) -> str:
+        assert self._url.host is not None
+        return self._url.host
+
+    @reify
+    def headers(self) -> "CIMultiDictProxy[str]":
+        return self._headers
+
+    @reify
+    def raw_headers(self) -> RawHeaders:
+        return self._raw_headers
+
+    @reify
+    def request_info(self) -> RequestInfo:
+        return self._request_info
+
+    @reify
+    def content_disposition(self) -> Optional[ContentDisposition]:
+        raw = self._headers.get(hdrs.CONTENT_DISPOSITION)
+        if raw is None:
+            return None
+        disposition_type, params_dct = multipart.parse_content_disposition(raw)
+        params = MappingProxyType(params_dct)
+        filename = multipart.content_disposition_filename(params)
+        return ContentDisposition(disposition_type, params, filename)
+
+    def __del__(self, _warnings: Any = warnings) -> None:
+        if self._closed:
+            return
+
+        if self._connection is not None:
+            self._connection.release()
+            self._cleanup_writer()
+
+            if self._loop.get_debug():
+                kwargs = {"source": self}
+                _warnings.warn(f"Unclosed response {self!r}", ResourceWarning, **kwargs)
+                context = {"client_response": self, "message": "Unclosed response"}
+                if self._source_traceback:
+                    context["source_traceback"] = self._source_traceback
+                self._loop.call_exception_handler(context)
+
+    def __repr__(self) -> str:
+        out = io.StringIO()
+        ascii_encodable_url = str(self.url)
+        if self.reason:
+            ascii_encodable_reason = self.reason.encode(
+                "ascii", "backslashreplace"
+            ).decode("ascii")
+        else:
+            ascii_encodable_reason = "None"
+        print(
+            "<ClientResponse({}) [{} {}]>".format(
+                ascii_encodable_url, self.status, ascii_encodable_reason
+            ),
+            file=out,
+        )
+        print(self.headers, file=out)
+        return out.getvalue()
+
+    @property
+    def connection(self) -> Optional["Connection"]:
+        return self._connection
+
+    @reify
+    def history(self) -> Tuple["ClientResponse", ...]:
+        """A sequence of of responses, if redirects occurred."""
+        return self._history
+
+    @reify
+    def links(self) -> "MultiDictProxy[MultiDictProxy[Union[str, URL]]]":
+        links_str = ", ".join(self.headers.getall("link", []))
+
+        if not links_str:
+            return MultiDictProxy(MultiDict())
+
+        links: MultiDict[MultiDictProxy[Union[str, URL]]] = MultiDict()
+
+        for val in re.split(r",(?=\s*<)", links_str):
+            match = re.match(r"\s*<(.*)>(.*)", val)
+            if match is None:  # pragma: no cover
+                # the check exists to suppress mypy error
+                continue
+            url, params_str = match.groups()
+            params = params_str.split(";")[1:]
+
+            link: MultiDict[Union[str, URL]] = MultiDict()
+
+            for param in params:
+                match = re.match(r"^\s*(\S*)\s*=\s*(['\"]?)(.*?)(\2)\s*$", param, re.M)
+                if match is None:  # pragma: no cover
+                    # the check exists to suppress mypy error
+                    continue
+                key, _, value, _ = match.groups()
+
+                link.add(key, value)
+
+            key = link.get("rel", url)
+
+            link.add("url", self.url.join(URL(url)))
+
+            links.add(str(key), MultiDictProxy(link))
+
+        return MultiDictProxy(links)
+
+    async def start(self, connection: "Connection") -> "ClientResponse":
+        """Start response processing."""
+        self._closed = False
+        self._protocol = connection.protocol
+        self._connection = connection
+
+        with self._timer:
+            while True:
+                # read response
+                try:
+                    protocol = self._protocol
+                    message, payload = await protocol.read()  # type: ignore[union-attr]
+                except http.HttpProcessingError as exc:
+                    raise ClientResponseError(
+                        self.request_info,
+                        self.history,
+                        status=exc.code,
+                        message=exc.message,
+                        headers=exc.headers,
+                    ) from exc
+
+                if message.code < 100 or message.code > 199 or message.code == 101:
+                    break
+
+                if self._continue is not None:
+                    set_result(self._continue, True)
+                    self._continue = None
+
+        # payload eof handler
+        payload.on_eof(self._response_eof)
+
+        # response status
+        self.version = message.version
+        self.status = message.code
+        self.reason = message.reason
+
+        # headers
+        self._headers = message.headers  # type is CIMultiDictProxy
+        self._raw_headers = message.raw_headers  # type is Tuple[bytes, bytes]
+
+        # payload
+        self.content = payload
+
+        # cookies
+        for hdr in self.headers.getall(hdrs.SET_COOKIE, ()):
+            try:
+                self.cookies.load(hdr)
+            except CookieError as exc:
+                client_logger.warning("Can not load response cookies: %s", exc)
+        return self
+
+    def _response_eof(self) -> None:
+        if self._closed:
+            return
+
+        # protocol could be None because connection could be detached
+        protocol = self._connection and self._connection.protocol
+        if protocol is not None and protocol.upgraded:
+            return
+
+        self._closed = True
+        self._cleanup_writer()
+        self._release_connection()
+
+    @property
+    def closed(self) -> bool:
+        return self._closed
+
+    def close(self) -> None:
+        if not self._released:
+            self._notify_content()
+
+        self._closed = True
+        if self._loop is None or self._loop.is_closed():
+            return
+
+        self._cleanup_writer()
+        if self._connection is not None:
+            self._connection.close()
+            self._connection = None
+
+    def release(self) -> Any:
+        if not self._released:
+            self._notify_content()
+
+        self._closed = True
+
+        self._cleanup_writer()
+        self._release_connection()
+        return noop()
+
+    @property
+    def ok(self) -> bool:
+        """Returns ``True`` if ``status`` is less than ``400``, ``False`` if not.
+
+        This is **not** a check for ``200 OK`` but a check that the response
+        status is under 400.
+        """
+        return 400 > self.status
+
+    def raise_for_status(self) -> None:
+        if not self.ok:
+            # reason should always be not None for a started response
+            assert self.reason is not None
+            self.release()
+            raise ClientResponseError(
+                self.request_info,
+                self.history,
+                status=self.status,
+                message=self.reason,
+                headers=self.headers,
+            )
+
+    def _release_connection(self) -> None:
+        if self._connection is not None:
+            if self._writer is None:
+                self._connection.release()
+                self._connection = None
+            else:
+                self._writer.add_done_callback(lambda f: self._release_connection())
+
+    async def _wait_released(self) -> None:
+        if self._writer is not None:
+            await self._writer
+        self._release_connection()
+
+    def _cleanup_writer(self) -> None:
+        if self._writer is not None:
+            self._writer.cancel()
+        self._session = None
+
+    def _notify_content(self) -> None:
+        content = self.content
+        if content and content.exception() is None:
+            set_exception(content, ClientConnectionError("Connection closed"))
+        self._released = True
+
+    async def wait_for_close(self) -> None:
+        if self._writer is not None:
+            await self._writer
+        self.release()
+
+    async def read(self) -> bytes:
+        """Read response payload."""
+        if self._body is None:
+            try:
+                self._body = await self.content.read()
+                for trace in self._traces:
+                    await trace.send_response_chunk_received(
+                        self.method, self.url, self._body
+                    )
+            except BaseException:
+                self.close()
+                raise
+        elif self._released:  # Response explicitly released
+            raise ClientConnectionError("Connection closed")
+
+        protocol = self._connection and self._connection.protocol
+        if protocol is None or not protocol.upgraded:
+            await self._wait_released()  # Underlying connection released
+        return self._body  # type: ignore[no-any-return]
+
+    def get_encoding(self) -> str:
+        ctype = self.headers.get(hdrs.CONTENT_TYPE, "").lower()
+        mimetype = helpers.parse_mimetype(ctype)
+
+        encoding = mimetype.parameters.get("charset")
+        if encoding:
+            with contextlib.suppress(LookupError):
+                return codecs.lookup(encoding).name
+
+        if mimetype.type == "application" and (
+            mimetype.subtype == "json" or mimetype.subtype == "rdap"
+        ):
+            # RFC 7159 states that the default encoding is UTF-8.
+            # RFC 7483 defines application/rdap+json
+            return "utf-8"
+
+        if self._body is None:
+            raise RuntimeError(
+                "Cannot compute fallback encoding of a not yet read body"
+            )
+
+        return self._resolve_charset(self, self._body)
+
+    async def text(self, encoding: Optional[str] = None, errors: str = "strict") -> str:
+        """Read response payload and decode."""
+        if self._body is None:
+            await self.read()
+
+        if encoding is None:
+            encoding = self.get_encoding()
+
+        return self._body.decode(  # type: ignore[no-any-return,union-attr]
+            encoding, errors=errors
+        )
+
+    async def json(
+        self,
+        *,
+        encoding: Optional[str] = None,
+        loads: JSONDecoder = DEFAULT_JSON_DECODER,
+        content_type: Optional[str] = "application/json",
+    ) -> Any:
+        """Read and decodes JSON response."""
+        if self._body is None:
+            await self.read()
+
+        if content_type:
+            ctype = self.headers.get(hdrs.CONTENT_TYPE, "").lower()
+            if not _is_expected_content_type(ctype, content_type):
+                raise ContentTypeError(
+                    self.request_info,
+                    self.history,
+                    message=(
+                        "Attempt to decode JSON with " "unexpected mimetype: %s" % ctype
+                    ),
+                    headers=self.headers,
+                )
+
+        stripped = self._body.strip()  # type: ignore[union-attr]
+        if not stripped:
+            return None
+
+        if encoding is None:
+            encoding = self.get_encoding()
+
+        return loads(stripped.decode(encoding))
+
+    async def __aenter__(self) -> "ClientResponse":
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        # similar to _RequestContextManager, we do not need to check
+        # for exceptions, response object can close connection
+        # if state is broken
+        self.release()
+        await self.wait_for_close()
diff --git a/llm/Lib/site-packages/aiohttp/client_ws.py b/llm/Lib/site-packages/aiohttp/client_ws.py
new file mode 100644
index 0000000000000000000000000000000000000000..d213aa37519372f110ff3784feac2af526ff3b1f
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/client_ws.py
@@ -0,0 +1,315 @@
+"""WebSocket client for asyncio."""
+
+import asyncio
+import sys
+from typing import Any, Optional, cast
+
+from .client_exceptions import ClientError
+from .client_reqrep import ClientResponse
+from .helpers import call_later, set_result
+from .http import (
+    WS_CLOSED_MESSAGE,
+    WS_CLOSING_MESSAGE,
+    WebSocketError,
+    WSCloseCode,
+    WSMessage,
+    WSMsgType,
+)
+from .http_websocket import WebSocketWriter  # WSMessage
+from .streams import EofStream, FlowControlDataQueue
+from .typedefs import (
+    DEFAULT_JSON_DECODER,
+    DEFAULT_JSON_ENCODER,
+    JSONDecoder,
+    JSONEncoder,
+)
+
+if sys.version_info >= (3, 11):
+    import asyncio as async_timeout
+else:
+    import async_timeout
+
+
+class ClientWebSocketResponse:
+    def __init__(
+        self,
+        reader: "FlowControlDataQueue[WSMessage]",
+        writer: WebSocketWriter,
+        protocol: Optional[str],
+        response: ClientResponse,
+        timeout: float,
+        autoclose: bool,
+        autoping: bool,
+        loop: asyncio.AbstractEventLoop,
+        *,
+        receive_timeout: Optional[float] = None,
+        heartbeat: Optional[float] = None,
+        compress: int = 0,
+        client_notakeover: bool = False,
+    ) -> None:
+        self._response = response
+        self._conn = response.connection
+
+        self._writer = writer
+        self._reader = reader
+        self._protocol = protocol
+        self._closed = False
+        self._closing = False
+        self._close_code: Optional[int] = None
+        self._timeout = timeout
+        self._receive_timeout = receive_timeout
+        self._autoclose = autoclose
+        self._autoping = autoping
+        self._heartbeat = heartbeat
+        self._heartbeat_cb: Optional[asyncio.TimerHandle] = None
+        if heartbeat is not None:
+            self._pong_heartbeat = heartbeat / 2.0
+        self._pong_response_cb: Optional[asyncio.TimerHandle] = None
+        self._loop = loop
+        self._waiting: Optional[asyncio.Future[bool]] = None
+        self._exception: Optional[BaseException] = None
+        self._compress = compress
+        self._client_notakeover = client_notakeover
+
+        self._reset_heartbeat()
+
+    def _cancel_heartbeat(self) -> None:
+        if self._pong_response_cb is not None:
+            self._pong_response_cb.cancel()
+            self._pong_response_cb = None
+
+        if self._heartbeat_cb is not None:
+            self._heartbeat_cb.cancel()
+            self._heartbeat_cb = None
+
+    def _reset_heartbeat(self) -> None:
+        self._cancel_heartbeat()
+
+        if self._heartbeat is not None:
+            self._heartbeat_cb = call_later(
+                self._send_heartbeat,
+                self._heartbeat,
+                self._loop,
+                timeout_ceil_threshold=self._conn._connector._timeout_ceil_threshold
+                if self._conn is not None
+                else 5,
+            )
+
+    def _send_heartbeat(self) -> None:
+        if self._heartbeat is not None and not self._closed:
+            # fire-and-forget a task is not perfect but maybe ok for
+            # sending ping. Otherwise we need a long-living heartbeat
+            # task in the class.
+            self._loop.create_task(self._writer.ping())
+
+            if self._pong_response_cb is not None:
+                self._pong_response_cb.cancel()
+            self._pong_response_cb = call_later(
+                self._pong_not_received,
+                self._pong_heartbeat,
+                self._loop,
+                timeout_ceil_threshold=self._conn._connector._timeout_ceil_threshold
+                if self._conn is not None
+                else 5,
+            )
+
+    def _pong_not_received(self) -> None:
+        if not self._closed:
+            self._closed = True
+            self._close_code = WSCloseCode.ABNORMAL_CLOSURE
+            self._exception = asyncio.TimeoutError()
+            self._response.close()
+
+    @property
+    def closed(self) -> bool:
+        return self._closed
+
+    @property
+    def close_code(self) -> Optional[int]:
+        return self._close_code
+
+    @property
+    def protocol(self) -> Optional[str]:
+        return self._protocol
+
+    @property
+    def compress(self) -> int:
+        return self._compress
+
+    @property
+    def client_notakeover(self) -> bool:
+        return self._client_notakeover
+
+    def get_extra_info(self, name: str, default: Any = None) -> Any:
+        """extra info from connection transport"""
+        conn = self._response.connection
+        if conn is None:
+            return default
+        transport = conn.transport
+        if transport is None:
+            return default
+        return transport.get_extra_info(name, default)
+
+    def exception(self) -> Optional[BaseException]:
+        return self._exception
+
+    async def ping(self, message: bytes = b"") -> None:
+        await self._writer.ping(message)
+
+    async def pong(self, message: bytes = b"") -> None:
+        await self._writer.pong(message)
+
+    async def send_str(self, data: str, compress: Optional[int] = None) -> None:
+        if not isinstance(data, str):
+            raise TypeError("data argument must be str (%r)" % type(data))
+        await self._writer.send(data, binary=False, compress=compress)
+
+    async def send_bytes(self, data: bytes, compress: Optional[int] = None) -> None:
+        if not isinstance(data, (bytes, bytearray, memoryview)):
+            raise TypeError("data argument must be byte-ish (%r)" % type(data))
+        await self._writer.send(data, binary=True, compress=compress)
+
+    async def send_json(
+        self,
+        data: Any,
+        compress: Optional[int] = None,
+        *,
+        dumps: JSONEncoder = DEFAULT_JSON_ENCODER,
+    ) -> None:
+        await self.send_str(dumps(data), compress=compress)
+
+    async def close(self, *, code: int = WSCloseCode.OK, message: bytes = b"") -> bool:
+        # we need to break `receive()` cycle first,
+        # `close()` may be called from different task
+        if self._waiting is not None and not self._closing:
+            self._closing = True
+            self._reader.feed_data(WS_CLOSING_MESSAGE, 0)
+            await self._waiting
+
+        if not self._closed:
+            self._cancel_heartbeat()
+            self._closed = True
+            try:
+                await self._writer.close(code, message)
+            except asyncio.CancelledError:
+                self._close_code = WSCloseCode.ABNORMAL_CLOSURE
+                self._response.close()
+                raise
+            except Exception as exc:
+                self._close_code = WSCloseCode.ABNORMAL_CLOSURE
+                self._exception = exc
+                self._response.close()
+                return True
+
+            if self._close_code:
+                self._response.close()
+                return True
+
+            while True:
+                try:
+                    async with async_timeout.timeout(self._timeout):
+                        msg = await self._reader.read()
+                except asyncio.CancelledError:
+                    self._close_code = WSCloseCode.ABNORMAL_CLOSURE
+                    self._response.close()
+                    raise
+                except Exception as exc:
+                    self._close_code = WSCloseCode.ABNORMAL_CLOSURE
+                    self._exception = exc
+                    self._response.close()
+                    return True
+
+                if msg.type == WSMsgType.CLOSE:
+                    self._close_code = msg.data
+                    self._response.close()
+                    return True
+        else:
+            return False
+
+    async def receive(self, timeout: Optional[float] = None) -> WSMessage:
+        while True:
+            if self._waiting is not None:
+                raise RuntimeError("Concurrent call to receive() is not allowed")
+
+            if self._closed:
+                return WS_CLOSED_MESSAGE
+            elif self._closing:
+                await self.close()
+                return WS_CLOSED_MESSAGE
+
+            try:
+                self._waiting = self._loop.create_future()
+                try:
+                    async with async_timeout.timeout(timeout or self._receive_timeout):
+                        msg = await self._reader.read()
+                    self._reset_heartbeat()
+                finally:
+                    waiter = self._waiting
+                    self._waiting = None
+                    set_result(waiter, True)
+            except (asyncio.CancelledError, asyncio.TimeoutError):
+                self._close_code = WSCloseCode.ABNORMAL_CLOSURE
+                raise
+            except EofStream:
+                self._close_code = WSCloseCode.OK
+                await self.close()
+                return WSMessage(WSMsgType.CLOSED, None, None)
+            except ClientError:
+                self._closed = True
+                self._close_code = WSCloseCode.ABNORMAL_CLOSURE
+                return WS_CLOSED_MESSAGE
+            except WebSocketError as exc:
+                self._close_code = exc.code
+                await self.close(code=exc.code)
+                return WSMessage(WSMsgType.ERROR, exc, None)
+            except Exception as exc:
+                self._exception = exc
+                self._closing = True
+                self._close_code = WSCloseCode.ABNORMAL_CLOSURE
+                await self.close()
+                return WSMessage(WSMsgType.ERROR, exc, None)
+
+            if msg.type == WSMsgType.CLOSE:
+                self._closing = True
+                self._close_code = msg.data
+                if not self._closed and self._autoclose:
+                    await self.close()
+            elif msg.type == WSMsgType.CLOSING:
+                self._closing = True
+            elif msg.type == WSMsgType.PING and self._autoping:
+                await self.pong(msg.data)
+                continue
+            elif msg.type == WSMsgType.PONG and self._autoping:
+                continue
+
+            return msg
+
+    async def receive_str(self, *, timeout: Optional[float] = None) -> str:
+        msg = await self.receive(timeout)
+        if msg.type != WSMsgType.TEXT:
+            raise TypeError(f"Received message {msg.type}:{msg.data!r} is not str")
+        return cast(str, msg.data)
+
+    async def receive_bytes(self, *, timeout: Optional[float] = None) -> bytes:
+        msg = await self.receive(timeout)
+        if msg.type != WSMsgType.BINARY:
+            raise TypeError(f"Received message {msg.type}:{msg.data!r} is not bytes")
+        return cast(bytes, msg.data)
+
+    async def receive_json(
+        self,
+        *,
+        loads: JSONDecoder = DEFAULT_JSON_DECODER,
+        timeout: Optional[float] = None,
+    ) -> Any:
+        data = await self.receive_str(timeout=timeout)
+        return loads(data)
+
+    def __aiter__(self) -> "ClientWebSocketResponse":
+        return self
+
+    async def __anext__(self) -> WSMessage:
+        msg = await self.receive()
+        if msg.type in (WSMsgType.CLOSE, WSMsgType.CLOSING, WSMsgType.CLOSED):
+            raise StopAsyncIteration
+        return msg
diff --git a/llm/Lib/site-packages/aiohttp/compression_utils.py b/llm/Lib/site-packages/aiohttp/compression_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..cc2a13e3aae8df7619e84efc1ec2044255121fb3
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/compression_utils.py
@@ -0,0 +1,157 @@
+import asyncio
+import zlib
+from concurrent.futures import Executor
+from typing import Optional, cast
+
+try:
+    try:
+        import brotlicffi as brotli
+    except ImportError:
+        import brotli
+
+    HAS_BROTLI = True
+except ImportError:  # pragma: no cover
+    HAS_BROTLI = False
+
+MAX_SYNC_CHUNK_SIZE = 1024
+
+
+def encoding_to_mode(
+    encoding: Optional[str] = None,
+    suppress_deflate_header: bool = False,
+) -> int:
+    if encoding == "gzip":
+        return 16 + zlib.MAX_WBITS
+
+    return -zlib.MAX_WBITS if suppress_deflate_header else zlib.MAX_WBITS
+
+
+class ZlibBaseHandler:
+    def __init__(
+        self,
+        mode: int,
+        executor: Optional[Executor] = None,
+        max_sync_chunk_size: Optional[int] = MAX_SYNC_CHUNK_SIZE,
+    ):
+        self._mode = mode
+        self._executor = executor
+        self._max_sync_chunk_size = max_sync_chunk_size
+
+
+class ZLibCompressor(ZlibBaseHandler):
+    def __init__(
+        self,
+        encoding: Optional[str] = None,
+        suppress_deflate_header: bool = False,
+        level: Optional[int] = None,
+        wbits: Optional[int] = None,
+        strategy: int = zlib.Z_DEFAULT_STRATEGY,
+        executor: Optional[Executor] = None,
+        max_sync_chunk_size: Optional[int] = MAX_SYNC_CHUNK_SIZE,
+    ):
+        super().__init__(
+            mode=encoding_to_mode(encoding, suppress_deflate_header)
+            if wbits is None
+            else wbits,
+            executor=executor,
+            max_sync_chunk_size=max_sync_chunk_size,
+        )
+        if level is None:
+            self._compressor = zlib.compressobj(wbits=self._mode, strategy=strategy)
+        else:
+            self._compressor = zlib.compressobj(
+                wbits=self._mode, strategy=strategy, level=level
+            )
+        self._compress_lock = asyncio.Lock()
+
+    def compress_sync(self, data: bytes) -> bytes:
+        return self._compressor.compress(data)
+
+    async def compress(self, data: bytes) -> bytes:
+        async with self._compress_lock:
+            # To ensure the stream is consistent in the event
+            # there are multiple writers, we need to lock
+            # the compressor so that only one writer can
+            # compress at a time.
+            if (
+                self._max_sync_chunk_size is not None
+                and len(data) > self._max_sync_chunk_size
+            ):
+                return await asyncio.get_event_loop().run_in_executor(
+                    self._executor, self.compress_sync, data
+                )
+            return self.compress_sync(data)
+
+    def flush(self, mode: int = zlib.Z_FINISH) -> bytes:
+        return self._compressor.flush(mode)
+
+
+class ZLibDecompressor(ZlibBaseHandler):
+    def __init__(
+        self,
+        encoding: Optional[str] = None,
+        suppress_deflate_header: bool = False,
+        executor: Optional[Executor] = None,
+        max_sync_chunk_size: Optional[int] = MAX_SYNC_CHUNK_SIZE,
+    ):
+        super().__init__(
+            mode=encoding_to_mode(encoding, suppress_deflate_header),
+            executor=executor,
+            max_sync_chunk_size=max_sync_chunk_size,
+        )
+        self._decompressor = zlib.decompressobj(wbits=self._mode)
+
+    def decompress_sync(self, data: bytes, max_length: int = 0) -> bytes:
+        return self._decompressor.decompress(data, max_length)
+
+    async def decompress(self, data: bytes, max_length: int = 0) -> bytes:
+        if (
+            self._max_sync_chunk_size is not None
+            and len(data) > self._max_sync_chunk_size
+        ):
+            return await asyncio.get_event_loop().run_in_executor(
+                self._executor, self.decompress_sync, data, max_length
+            )
+        return self.decompress_sync(data, max_length)
+
+    def flush(self, length: int = 0) -> bytes:
+        return (
+            self._decompressor.flush(length)
+            if length > 0
+            else self._decompressor.flush()
+        )
+
+    @property
+    def eof(self) -> bool:
+        return self._decompressor.eof
+
+    @property
+    def unconsumed_tail(self) -> bytes:
+        return self._decompressor.unconsumed_tail
+
+    @property
+    def unused_data(self) -> bytes:
+        return self._decompressor.unused_data
+
+
+class BrotliDecompressor:
+    # Supports both 'brotlipy' and 'Brotli' packages
+    # since they share an import name. The top branches
+    # are for 'brotlipy' and bottom branches for 'Brotli'
+    def __init__(self) -> None:
+        if not HAS_BROTLI:
+            raise RuntimeError(
+                "The brotli decompression is not available. "
+                "Please install `Brotli` module"
+            )
+        self._obj = brotli.Decompressor()
+
+    def decompress_sync(self, data: bytes) -> bytes:
+        if hasattr(self._obj, "decompress"):
+            return cast(bytes, self._obj.decompress(data))
+        return cast(bytes, self._obj.process(data))
+
+    def flush(self) -> bytes:
+        if hasattr(self._obj, "flush"):
+            return cast(bytes, self._obj.flush())
+        return b""
diff --git a/llm/Lib/site-packages/aiohttp/connector.py b/llm/Lib/site-packages/aiohttp/connector.py
new file mode 100644
index 0000000000000000000000000000000000000000..b2ce0ef5b4d14642d9f9c08783d35ddbbccb556a
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/connector.py
@@ -0,0 +1,1511 @@
+import asyncio
+import functools
+import random
+import sys
+import traceback
+import warnings
+from collections import defaultdict, deque
+from contextlib import suppress
+from http import HTTPStatus
+from http.cookies import SimpleCookie
+from itertools import cycle, islice
+from time import monotonic
+from types import TracebackType
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Awaitable,
+    Callable,
+    DefaultDict,
+    Dict,
+    Iterator,
+    List,
+    Literal,
+    Optional,
+    Set,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+
+import attr
+
+from . import hdrs, helpers
+from .abc import AbstractResolver
+from .client_exceptions import (
+    ClientConnectionError,
+    ClientConnectorCertificateError,
+    ClientConnectorError,
+    ClientConnectorSSLError,
+    ClientHttpProxyError,
+    ClientProxyConnectionError,
+    ServerFingerprintMismatch,
+    UnixClientConnectorError,
+    cert_errors,
+    ssl_errors,
+)
+from .client_proto import ResponseHandler
+from .client_reqrep import ClientRequest, Fingerprint, _merge_ssl_params
+from .helpers import ceil_timeout, get_running_loop, is_ip_address, noop, sentinel
+from .locks import EventResultOrError
+from .resolver import DefaultResolver
+
+try:
+    import ssl
+
+    SSLContext = ssl.SSLContext
+except ImportError:  # pragma: no cover
+    ssl = None  # type: ignore[assignment]
+    SSLContext = object  # type: ignore[misc,assignment]
+
+
+__all__ = ("BaseConnector", "TCPConnector", "UnixConnector", "NamedPipeConnector")
+
+
+if TYPE_CHECKING:
+    from .client import ClientTimeout
+    from .client_reqrep import ConnectionKey
+    from .tracing import Trace
+
+
+class _DeprecationWaiter:
+    __slots__ = ("_awaitable", "_awaited")
+
+    def __init__(self, awaitable: Awaitable[Any]) -> None:
+        self._awaitable = awaitable
+        self._awaited = False
+
+    def __await__(self) -> Any:
+        self._awaited = True
+        return self._awaitable.__await__()
+
+    def __del__(self) -> None:
+        if not self._awaited:
+            warnings.warn(
+                "Connector.close() is a coroutine, "
+                "please use await connector.close()",
+                DeprecationWarning,
+            )
+
+
+class Connection:
+
+    _source_traceback = None
+    _transport = None
+
+    def __init__(
+        self,
+        connector: "BaseConnector",
+        key: "ConnectionKey",
+        protocol: ResponseHandler,
+        loop: asyncio.AbstractEventLoop,
+    ) -> None:
+        self._key = key
+        self._connector = connector
+        self._loop = loop
+        self._protocol: Optional[ResponseHandler] = protocol
+        self._callbacks: List[Callable[[], None]] = []
+
+        if loop.get_debug():
+            self._source_traceback = traceback.extract_stack(sys._getframe(1))
+
+    def __repr__(self) -> str:
+        return f"Connection<{self._key}>"
+
+    def __del__(self, _warnings: Any = warnings) -> None:
+        if self._protocol is not None:
+            kwargs = {"source": self}
+            _warnings.warn(f"Unclosed connection {self!r}", ResourceWarning, **kwargs)
+            if self._loop.is_closed():
+                return
+
+            self._connector._release(self._key, self._protocol, should_close=True)
+
+            context = {"client_connection": self, "message": "Unclosed connection"}
+            if self._source_traceback is not None:
+                context["source_traceback"] = self._source_traceback
+            self._loop.call_exception_handler(context)
+
+    def __bool__(self) -> Literal[True]:
+        """Force subclasses to not be falsy, to make checks simpler."""
+        return True
+
+    @property
+    def loop(self) -> asyncio.AbstractEventLoop:
+        warnings.warn(
+            "connector.loop property is deprecated", DeprecationWarning, stacklevel=2
+        )
+        return self._loop
+
+    @property
+    def transport(self) -> Optional[asyncio.Transport]:
+        if self._protocol is None:
+            return None
+        return self._protocol.transport
+
+    @property
+    def protocol(self) -> Optional[ResponseHandler]:
+        return self._protocol
+
+    def add_callback(self, callback: Callable[[], None]) -> None:
+        if callback is not None:
+            self._callbacks.append(callback)
+
+    def _notify_release(self) -> None:
+        callbacks, self._callbacks = self._callbacks[:], []
+
+        for cb in callbacks:
+            with suppress(Exception):
+                cb()
+
+    def close(self) -> None:
+        self._notify_release()
+
+        if self._protocol is not None:
+            self._connector._release(self._key, self._protocol, should_close=True)
+            self._protocol = None
+
+    def release(self) -> None:
+        self._notify_release()
+
+        if self._protocol is not None:
+            self._connector._release(
+                self._key, self._protocol, should_close=self._protocol.should_close
+            )
+            self._protocol = None
+
+    @property
+    def closed(self) -> bool:
+        return self._protocol is None or not self._protocol.is_connected()
+
+
+class _TransportPlaceholder:
+    """placeholder for BaseConnector.connect function"""
+
+    def close(self) -> None:
+        pass
+
+
+class BaseConnector:
+    """Base connector class.
+
+    keepalive_timeout - (optional) Keep-alive timeout.
+    force_close - Set to True to force close and do reconnect
+        after each request (and between redirects).
+    limit - The total number of simultaneous connections.
+    limit_per_host - Number of simultaneous connections to one host.
+    enable_cleanup_closed - Enables clean-up closed ssl transports.
+                            Disabled by default.
+    timeout_ceil_threshold - Trigger ceiling of timeout values when
+                             it's above timeout_ceil_threshold.
+    loop - Optional event loop.
+    """
+
+    _closed = True  # prevent AttributeError in __del__ if ctor was failed
+    _source_traceback = None
+
+    # abort transport after 2 seconds (cleanup broken connections)
+    _cleanup_closed_period = 2.0
+
+    def __init__(
+        self,
+        *,
+        keepalive_timeout: Union[object, None, float] = sentinel,
+        force_close: bool = False,
+        limit: int = 100,
+        limit_per_host: int = 0,
+        enable_cleanup_closed: bool = False,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        timeout_ceil_threshold: float = 5,
+    ) -> None:
+
+        if force_close:
+            if keepalive_timeout is not None and keepalive_timeout is not sentinel:
+                raise ValueError(
+                    "keepalive_timeout cannot " "be set if force_close is True"
+                )
+        else:
+            if keepalive_timeout is sentinel:
+                keepalive_timeout = 15.0
+
+        loop = get_running_loop(loop)
+        self._timeout_ceil_threshold = timeout_ceil_threshold
+
+        self._closed = False
+        if loop.get_debug():
+            self._source_traceback = traceback.extract_stack(sys._getframe(1))
+
+        self._conns: Dict[ConnectionKey, List[Tuple[ResponseHandler, float]]] = {}
+        self._limit = limit
+        self._limit_per_host = limit_per_host
+        self._acquired: Set[ResponseHandler] = set()
+        self._acquired_per_host: DefaultDict[
+            ConnectionKey, Set[ResponseHandler]
+        ] = defaultdict(set)
+        self._keepalive_timeout = cast(float, keepalive_timeout)
+        self._force_close = force_close
+
+        # {host_key: FIFO list of waiters}
+        self._waiters = defaultdict(deque)  # type: ignore[var-annotated]
+
+        self._loop = loop
+        self._factory = functools.partial(ResponseHandler, loop=loop)
+
+        self.cookies = SimpleCookie()
+
+        # start keep-alive connection cleanup task
+        self._cleanup_handle: Optional[asyncio.TimerHandle] = None
+
+        # start cleanup closed transports task
+        self._cleanup_closed_handle: Optional[asyncio.TimerHandle] = None
+        self._cleanup_closed_disabled = not enable_cleanup_closed
+        self._cleanup_closed_transports: List[Optional[asyncio.Transport]] = []
+        self._cleanup_closed()
+
+    def __del__(self, _warnings: Any = warnings) -> None:
+        if self._closed:
+            return
+        if not self._conns:
+            return
+
+        conns = [repr(c) for c in self._conns.values()]
+
+        self._close()
+
+        kwargs = {"source": self}
+        _warnings.warn(f"Unclosed connector {self!r}", ResourceWarning, **kwargs)
+        context = {
+            "connector": self,
+            "connections": conns,
+            "message": "Unclosed connector",
+        }
+        if self._source_traceback is not None:
+            context["source_traceback"] = self._source_traceback
+        self._loop.call_exception_handler(context)
+
+    def __enter__(self) -> "BaseConnector":
+        warnings.warn(
+            '"with Connector():" is deprecated, '
+            'use "async with Connector():" instead',
+            DeprecationWarning,
+        )
+        return self
+
+    def __exit__(self, *exc: Any) -> None:
+        self._close()
+
+    async def __aenter__(self) -> "BaseConnector":
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        exc_traceback: Optional[TracebackType] = None,
+    ) -> None:
+        await self.close()
+
+    @property
+    def force_close(self) -> bool:
+        """Ultimately close connection on releasing if True."""
+        return self._force_close
+
+    @property
+    def limit(self) -> int:
+        """The total number for simultaneous connections.
+
+        If limit is 0 the connector has no limit.
+        The default limit size is 100.
+        """
+        return self._limit
+
+    @property
+    def limit_per_host(self) -> int:
+        """The limit for simultaneous connections to the same endpoint.
+
+        Endpoints are the same if they are have equal
+        (host, port, is_ssl) triple.
+        """
+        return self._limit_per_host
+
+    def _cleanup(self) -> None:
+        """Cleanup unused transports."""
+        if self._cleanup_handle:
+            self._cleanup_handle.cancel()
+            # _cleanup_handle should be unset, otherwise _release() will not
+            # recreate it ever!
+            self._cleanup_handle = None
+
+        now = self._loop.time()
+        timeout = self._keepalive_timeout
+
+        if self._conns:
+            connections = {}
+            deadline = now - timeout
+            for key, conns in self._conns.items():
+                alive = []
+                for proto, use_time in conns:
+                    if proto.is_connected():
+                        if use_time - deadline < 0:
+                            transport = proto.transport
+                            proto.close()
+                            if key.is_ssl and not self._cleanup_closed_disabled:
+                                self._cleanup_closed_transports.append(transport)
+                        else:
+                            alive.append((proto, use_time))
+                    else:
+                        transport = proto.transport
+                        proto.close()
+                        if key.is_ssl and not self._cleanup_closed_disabled:
+                            self._cleanup_closed_transports.append(transport)
+
+                if alive:
+                    connections[key] = alive
+
+            self._conns = connections
+
+        if self._conns:
+            self._cleanup_handle = helpers.weakref_handle(
+                self,
+                "_cleanup",
+                timeout,
+                self._loop,
+                timeout_ceil_threshold=self._timeout_ceil_threshold,
+            )
+
+    def _drop_acquired_per_host(
+        self, key: "ConnectionKey", val: ResponseHandler
+    ) -> None:
+        acquired_per_host = self._acquired_per_host
+        if key not in acquired_per_host:
+            return
+        conns = acquired_per_host[key]
+        conns.remove(val)
+        if not conns:
+            del self._acquired_per_host[key]
+
+    def _cleanup_closed(self) -> None:
+        """Double confirmation for transport close.
+
+        Some broken ssl servers may leave socket open without proper close.
+        """
+        if self._cleanup_closed_handle:
+            self._cleanup_closed_handle.cancel()
+
+        for transport in self._cleanup_closed_transports:
+            if transport is not None:
+                transport.abort()
+
+        self._cleanup_closed_transports = []
+
+        if not self._cleanup_closed_disabled:
+            self._cleanup_closed_handle = helpers.weakref_handle(
+                self,
+                "_cleanup_closed",
+                self._cleanup_closed_period,
+                self._loop,
+                timeout_ceil_threshold=self._timeout_ceil_threshold,
+            )
+
+    def close(self) -> Awaitable[None]:
+        """Close all opened transports."""
+        self._close()
+        return _DeprecationWaiter(noop())
+
+    def _close(self) -> None:
+        if self._closed:
+            return
+
+        self._closed = True
+
+        try:
+            if self._loop.is_closed():
+                return
+
+            # cancel cleanup task
+            if self._cleanup_handle:
+                self._cleanup_handle.cancel()
+
+            # cancel cleanup close task
+            if self._cleanup_closed_handle:
+                self._cleanup_closed_handle.cancel()
+
+            for data in self._conns.values():
+                for proto, t0 in data:
+                    proto.close()
+
+            for proto in self._acquired:
+                proto.close()
+
+            for transport in self._cleanup_closed_transports:
+                if transport is not None:
+                    transport.abort()
+
+        finally:
+            self._conns.clear()
+            self._acquired.clear()
+            self._waiters.clear()
+            self._cleanup_handle = None
+            self._cleanup_closed_transports.clear()
+            self._cleanup_closed_handle = None
+
+    @property
+    def closed(self) -> bool:
+        """Is connector closed.
+
+        A readonly property.
+        """
+        return self._closed
+
+    def _available_connections(self, key: "ConnectionKey") -> int:
+        """
+        Return number of available connections.
+
+        The limit, limit_per_host and the connection key are taken into account.
+
+        If it returns less than 1 means that there are no connections
+        available.
+        """
+        if self._limit:
+            # total calc available connections
+            available = self._limit - len(self._acquired)
+
+            # check limit per host
+            if (
+                self._limit_per_host
+                and available > 0
+                and key in self._acquired_per_host
+            ):
+                acquired = self._acquired_per_host.get(key)
+                assert acquired is not None
+                available = self._limit_per_host - len(acquired)
+
+        elif self._limit_per_host and key in self._acquired_per_host:
+            # check limit per host
+            acquired = self._acquired_per_host.get(key)
+            assert acquired is not None
+            available = self._limit_per_host - len(acquired)
+        else:
+            available = 1
+
+        return available
+
+    async def connect(
+        self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout"
+    ) -> Connection:
+        """Get from pool or create new connection."""
+        key = req.connection_key
+        available = self._available_connections(key)
+
+        # Wait if there are no available connections or if there are/were
+        # waiters (i.e. don't steal connection from a waiter about to wake up)
+        if available <= 0 or key in self._waiters:
+            fut = self._loop.create_future()
+
+            # This connection will now count towards the limit.
+            self._waiters[key].append(fut)
+
+            if traces:
+                for trace in traces:
+                    await trace.send_connection_queued_start()
+
+            try:
+                await fut
+            except BaseException as e:
+                if key in self._waiters:
+                    # remove a waiter even if it was cancelled, normally it's
+                    #  removed when it's notified
+                    try:
+                        self._waiters[key].remove(fut)
+                    except ValueError:  # fut may no longer be in list
+                        pass
+
+                raise e
+            finally:
+                if key in self._waiters and not self._waiters[key]:
+                    del self._waiters[key]
+
+            if traces:
+                for trace in traces:
+                    await trace.send_connection_queued_end()
+
+        proto = self._get(key)
+        if proto is None:
+            placeholder = cast(ResponseHandler, _TransportPlaceholder())
+            self._acquired.add(placeholder)
+            self._acquired_per_host[key].add(placeholder)
+
+            if traces:
+                for trace in traces:
+                    await trace.send_connection_create_start()
+
+            try:
+                proto = await self._create_connection(req, traces, timeout)
+                if self._closed:
+                    proto.close()
+                    raise ClientConnectionError("Connector is closed.")
+            except BaseException:
+                if not self._closed:
+                    self._acquired.remove(placeholder)
+                    self._drop_acquired_per_host(key, placeholder)
+                    self._release_waiter()
+                raise
+            else:
+                if not self._closed:
+                    self._acquired.remove(placeholder)
+                    self._drop_acquired_per_host(key, placeholder)
+
+            if traces:
+                for trace in traces:
+                    await trace.send_connection_create_end()
+        else:
+            if traces:
+                # Acquire the connection to prevent race conditions with limits
+                placeholder = cast(ResponseHandler, _TransportPlaceholder())
+                self._acquired.add(placeholder)
+                self._acquired_per_host[key].add(placeholder)
+                for trace in traces:
+                    await trace.send_connection_reuseconn()
+                self._acquired.remove(placeholder)
+                self._drop_acquired_per_host(key, placeholder)
+
+        self._acquired.add(proto)
+        self._acquired_per_host[key].add(proto)
+        return Connection(self, key, proto, self._loop)
+
+    def _get(self, key: "ConnectionKey") -> Optional[ResponseHandler]:
+        try:
+            conns = self._conns[key]
+        except KeyError:
+            return None
+
+        t1 = self._loop.time()
+        while conns:
+            proto, t0 = conns.pop()
+            if proto.is_connected():
+                if t1 - t0 > self._keepalive_timeout:
+                    transport = proto.transport
+                    proto.close()
+                    # only for SSL transports
+                    if key.is_ssl and not self._cleanup_closed_disabled:
+                        self._cleanup_closed_transports.append(transport)
+                else:
+                    if not conns:
+                        # The very last connection was reclaimed: drop the key
+                        del self._conns[key]
+                    return proto
+            else:
+                transport = proto.transport
+                proto.close()
+                if key.is_ssl and not self._cleanup_closed_disabled:
+                    self._cleanup_closed_transports.append(transport)
+
+        # No more connections: drop the key
+        del self._conns[key]
+        return None
+
+    def _release_waiter(self) -> None:
+        """
+        Iterates over all waiters until one to be released is found.
+
+        The one to be released is not finished and
+        belongs to a host that has available connections.
+        """
+        if not self._waiters:
+            return
+
+        # Having the dict keys ordered this avoids to iterate
+        # at the same order at each call.
+        queues = list(self._waiters.keys())
+        random.shuffle(queues)
+
+        for key in queues:
+            if self._available_connections(key) < 1:
+                continue
+
+            waiters = self._waiters[key]
+            while waiters:
+                waiter = waiters.popleft()
+                if not waiter.done():
+                    waiter.set_result(None)
+                    return
+
+    def _release_acquired(self, key: "ConnectionKey", proto: ResponseHandler) -> None:
+        if self._closed:
+            # acquired connection is already released on connector closing
+            return
+
+        try:
+            self._acquired.remove(proto)
+            self._drop_acquired_per_host(key, proto)
+        except KeyError:  # pragma: no cover
+            # this may be result of undetermenistic order of objects
+            # finalization due garbage collection.
+            pass
+        else:
+            self._release_waiter()
+
+    def _release(
+        self,
+        key: "ConnectionKey",
+        protocol: ResponseHandler,
+        *,
+        should_close: bool = False,
+    ) -> None:
+        if self._closed:
+            # acquired connection is already released on connector closing
+            return
+
+        self._release_acquired(key, protocol)
+
+        if self._force_close:
+            should_close = True
+
+        if should_close or protocol.should_close:
+            transport = protocol.transport
+            protocol.close()
+
+            if key.is_ssl and not self._cleanup_closed_disabled:
+                self._cleanup_closed_transports.append(transport)
+        else:
+            conns = self._conns.get(key)
+            if conns is None:
+                conns = self._conns[key] = []
+            conns.append((protocol, self._loop.time()))
+
+            if self._cleanup_handle is None:
+                self._cleanup_handle = helpers.weakref_handle(
+                    self,
+                    "_cleanup",
+                    self._keepalive_timeout,
+                    self._loop,
+                    timeout_ceil_threshold=self._timeout_ceil_threshold,
+                )
+
+    async def _create_connection(
+        self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout"
+    ) -> ResponseHandler:
+        raise NotImplementedError()
+
+
+class _DNSCacheTable:
+    def __init__(self, ttl: Optional[float] = None) -> None:
+        self._addrs_rr: Dict[Tuple[str, int], Tuple[Iterator[Dict[str, Any]], int]] = {}
+        self._timestamps: Dict[Tuple[str, int], float] = {}
+        self._ttl = ttl
+
+    def __contains__(self, host: object) -> bool:
+        return host in self._addrs_rr
+
+    def add(self, key: Tuple[str, int], addrs: List[Dict[str, Any]]) -> None:
+        self._addrs_rr[key] = (cycle(addrs), len(addrs))
+
+        if self._ttl is not None:
+            self._timestamps[key] = monotonic()
+
+    def remove(self, key: Tuple[str, int]) -> None:
+        self._addrs_rr.pop(key, None)
+
+        if self._ttl is not None:
+            self._timestamps.pop(key, None)
+
+    def clear(self) -> None:
+        self._addrs_rr.clear()
+        self._timestamps.clear()
+
+    def next_addrs(self, key: Tuple[str, int]) -> List[Dict[str, Any]]:
+        loop, length = self._addrs_rr[key]
+        addrs = list(islice(loop, length))
+        # Consume one more element to shift internal state of `cycle`
+        next(loop)
+        return addrs
+
+    def expired(self, key: Tuple[str, int]) -> bool:
+        if self._ttl is None:
+            return False
+
+        return self._timestamps[key] + self._ttl < monotonic()
+
+
+class TCPConnector(BaseConnector):
+    """TCP connector.
+
+    verify_ssl - Set to True to check ssl certifications.
+    fingerprint - Pass the binary sha256
+        digest of the expected certificate in DER format to verify
+        that the certificate the server presents matches. See also
+        https://en.wikipedia.org/wiki/Transport_Layer_Security#Certificate_pinning
+    resolver - Enable DNS lookups and use this
+        resolver
+    use_dns_cache - Use memory cache for DNS lookups.
+    ttl_dns_cache - Max seconds having cached a DNS entry, None forever.
+    family - socket address family
+    local_addr - local tuple of (host, port) to bind socket to
+
+    keepalive_timeout - (optional) Keep-alive timeout.
+    force_close - Set to True to force close and do reconnect
+        after each request (and between redirects).
+    limit - The total number of simultaneous connections.
+    limit_per_host - Number of simultaneous connections to one host.
+    enable_cleanup_closed - Enables clean-up closed ssl transports.
+                            Disabled by default.
+    loop - Optional event loop.
+    """
+
+    def __init__(
+        self,
+        *,
+        verify_ssl: bool = True,
+        fingerprint: Optional[bytes] = None,
+        use_dns_cache: bool = True,
+        ttl_dns_cache: Optional[int] = 10,
+        family: int = 0,
+        ssl_context: Optional[SSLContext] = None,
+        ssl: Union[bool, Fingerprint, SSLContext] = True,
+        local_addr: Optional[Tuple[str, int]] = None,
+        resolver: Optional[AbstractResolver] = None,
+        keepalive_timeout: Union[None, float, object] = sentinel,
+        force_close: bool = False,
+        limit: int = 100,
+        limit_per_host: int = 0,
+        enable_cleanup_closed: bool = False,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        timeout_ceil_threshold: float = 5,
+    ):
+        super().__init__(
+            keepalive_timeout=keepalive_timeout,
+            force_close=force_close,
+            limit=limit,
+            limit_per_host=limit_per_host,
+            enable_cleanup_closed=enable_cleanup_closed,
+            loop=loop,
+            timeout_ceil_threshold=timeout_ceil_threshold,
+        )
+
+        self._ssl = _merge_ssl_params(ssl, verify_ssl, ssl_context, fingerprint)
+        if resolver is None:
+            resolver = DefaultResolver(loop=self._loop)
+        self._resolver = resolver
+
+        self._use_dns_cache = use_dns_cache
+        self._cached_hosts = _DNSCacheTable(ttl=ttl_dns_cache)
+        self._throttle_dns_events: Dict[Tuple[str, int], EventResultOrError] = {}
+        self._family = family
+        self._local_addr = local_addr
+
+    def close(self) -> Awaitable[None]:
+        """Close all ongoing DNS calls."""
+        for ev in self._throttle_dns_events.values():
+            ev.cancel()
+
+        return super().close()
+
+    @property
+    def family(self) -> int:
+        """Socket family like AF_INET."""
+        return self._family
+
+    @property
+    def use_dns_cache(self) -> bool:
+        """True if local DNS caching is enabled."""
+        return self._use_dns_cache
+
+    def clear_dns_cache(
+        self, host: Optional[str] = None, port: Optional[int] = None
+    ) -> None:
+        """Remove specified host/port or clear all dns local cache."""
+        if host is not None and port is not None:
+            self._cached_hosts.remove((host, port))
+        elif host is not None or port is not None:
+            raise ValueError("either both host and port " "or none of them are allowed")
+        else:
+            self._cached_hosts.clear()
+
+    async def _resolve_host(
+        self, host: str, port: int, traces: Optional[List["Trace"]] = None
+    ) -> List[Dict[str, Any]]:
+        """Resolve host and return list of addresses."""
+        if is_ip_address(host):
+            return [
+                {
+                    "hostname": host,
+                    "host": host,
+                    "port": port,
+                    "family": self._family,
+                    "proto": 0,
+                    "flags": 0,
+                }
+            ]
+
+        if not self._use_dns_cache:
+
+            if traces:
+                for trace in traces:
+                    await trace.send_dns_resolvehost_start(host)
+
+            res = await self._resolver.resolve(host, port, family=self._family)
+
+            if traces:
+                for trace in traces:
+                    await trace.send_dns_resolvehost_end(host)
+
+            return res
+
+        key = (host, port)
+        if key in self._cached_hosts and not self._cached_hosts.expired(key):
+            # get result early, before any await (#4014)
+            result = self._cached_hosts.next_addrs(key)
+
+            if traces:
+                for trace in traces:
+                    await trace.send_dns_cache_hit(host)
+            return result
+
+        #
+        # If multiple connectors are resolving the same host, we wait
+        # for the first one to resolve and then use the result for all of them.
+        # We use a throttle event to ensure that we only resolve the host once
+        # and then use the result for all the waiters.
+        #
+        # In this case we need to create a task to ensure that we can shield
+        # the task from cancellation as cancelling this lookup should not cancel
+        # the underlying lookup or else the cancel event will get broadcast to
+        # all the waiters across all connections.
+        #
+        resolved_host_task = asyncio.create_task(
+            self._resolve_host_with_throttle(key, host, port, traces)
+        )
+        try:
+            return await asyncio.shield(resolved_host_task)
+        except asyncio.CancelledError:
+
+            def drop_exception(fut: "asyncio.Future[List[Dict[str, Any]]]") -> None:
+                with suppress(Exception, asyncio.CancelledError):
+                    fut.result()
+
+            resolved_host_task.add_done_callback(drop_exception)
+            raise
+
+    async def _resolve_host_with_throttle(
+        self,
+        key: Tuple[str, int],
+        host: str,
+        port: int,
+        traces: Optional[List["Trace"]],
+    ) -> List[Dict[str, Any]]:
+        """Resolve host with a dns events throttle."""
+        if key in self._throttle_dns_events:
+            # get event early, before any await (#4014)
+            event = self._throttle_dns_events[key]
+            if traces:
+                for trace in traces:
+                    await trace.send_dns_cache_hit(host)
+            await event.wait()
+        else:
+            # update dict early, before any await (#4014)
+            self._throttle_dns_events[key] = EventResultOrError(self._loop)
+            if traces:
+                for trace in traces:
+                    await trace.send_dns_cache_miss(host)
+            try:
+
+                if traces:
+                    for trace in traces:
+                        await trace.send_dns_resolvehost_start(host)
+
+                addrs = await self._resolver.resolve(host, port, family=self._family)
+                if traces:
+                    for trace in traces:
+                        await trace.send_dns_resolvehost_end(host)
+
+                self._cached_hosts.add(key, addrs)
+                self._throttle_dns_events[key].set()
+            except BaseException as e:
+                # any DNS exception, independently of the implementation
+                # is set for the waiters to raise the same exception.
+                self._throttle_dns_events[key].set(exc=e)
+                raise
+            finally:
+                self._throttle_dns_events.pop(key)
+
+        return self._cached_hosts.next_addrs(key)
+
+    async def _create_connection(
+        self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout"
+    ) -> ResponseHandler:
+        """Create connection.
+
+        Has same keyword arguments as BaseEventLoop.create_connection.
+        """
+        if req.proxy:
+            _, proto = await self._create_proxy_connection(req, traces, timeout)
+        else:
+            _, proto = await self._create_direct_connection(req, traces, timeout)
+
+        return proto
+
+    @staticmethod
+    @functools.lru_cache(None)
+    def _make_ssl_context(verified: bool) -> SSLContext:
+        if verified:
+            return ssl.create_default_context()
+        else:
+            sslcontext = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
+            sslcontext.options |= ssl.OP_NO_SSLv2
+            sslcontext.options |= ssl.OP_NO_SSLv3
+            sslcontext.check_hostname = False
+            sslcontext.verify_mode = ssl.CERT_NONE
+            try:
+                sslcontext.options |= ssl.OP_NO_COMPRESSION
+            except AttributeError as attr_err:
+                warnings.warn(
+                    "{!s}: The Python interpreter is compiled "
+                    "against OpenSSL < 1.0.0. Ref: "
+                    "https://docs.python.org/3/library/ssl.html"
+                    "#ssl.OP_NO_COMPRESSION".format(attr_err),
+                )
+            sslcontext.set_default_verify_paths()
+            return sslcontext
+
+    def _get_ssl_context(self, req: ClientRequest) -> Optional[SSLContext]:
+        """Logic to get the correct SSL context
+
+        0. if req.ssl is false, return None
+
+        1. if ssl_context is specified in req, use it
+        2. if _ssl_context is specified in self, use it
+        3. otherwise:
+            1. if verify_ssl is not specified in req, use self.ssl_context
+               (will generate a default context according to self.verify_ssl)
+            2. if verify_ssl is True in req, generate a default SSL context
+            3. if verify_ssl is False in req, generate a SSL context that
+               won't verify
+        """
+        if req.is_ssl():
+            if ssl is None:  # pragma: no cover
+                raise RuntimeError("SSL is not supported.")
+            sslcontext = req.ssl
+            if isinstance(sslcontext, ssl.SSLContext):
+                return sslcontext
+            if sslcontext is not True:
+                # not verified or fingerprinted
+                return self._make_ssl_context(False)
+            sslcontext = self._ssl
+            if isinstance(sslcontext, ssl.SSLContext):
+                return sslcontext
+            if sslcontext is not True:
+                # not verified or fingerprinted
+                return self._make_ssl_context(False)
+            return self._make_ssl_context(True)
+        else:
+            return None
+
+    def _get_fingerprint(self, req: ClientRequest) -> Optional["Fingerprint"]:
+        ret = req.ssl
+        if isinstance(ret, Fingerprint):
+            return ret
+        ret = self._ssl
+        if isinstance(ret, Fingerprint):
+            return ret
+        return None
+
+    async def _wrap_create_connection(
+        self,
+        *args: Any,
+        req: ClientRequest,
+        timeout: "ClientTimeout",
+        client_error: Type[Exception] = ClientConnectorError,
+        **kwargs: Any,
+    ) -> Tuple[asyncio.Transport, ResponseHandler]:
+        try:
+            async with ceil_timeout(
+                timeout.sock_connect, ceil_threshold=timeout.ceil_threshold
+            ):
+                return await self._loop.create_connection(*args, **kwargs)
+        except cert_errors as exc:
+            raise ClientConnectorCertificateError(req.connection_key, exc) from exc
+        except ssl_errors as exc:
+            raise ClientConnectorSSLError(req.connection_key, exc) from exc
+        except OSError as exc:
+            if exc.errno is None and isinstance(exc, asyncio.TimeoutError):
+                raise
+            raise client_error(req.connection_key, exc) from exc
+
+    def _fail_on_no_start_tls(self, req: "ClientRequest") -> None:
+        """Raise a :py:exc:`RuntimeError` on missing ``start_tls()``.
+
+        It is necessary for TLS-in-TLS so that it is possible to
+        send HTTPS queries through HTTPS proxies.
+
+        This doesn't affect regular HTTP requests, though.
+        """
+        if not req.is_ssl():
+            return
+
+        proxy_url = req.proxy
+        assert proxy_url is not None
+        if proxy_url.scheme != "https":
+            return
+
+        self._check_loop_for_start_tls()
+
+    def _check_loop_for_start_tls(self) -> None:
+        try:
+            self._loop.start_tls
+        except AttributeError as attr_exc:
+            raise RuntimeError(
+                "An HTTPS request is being sent through an HTTPS proxy. "
+                "This needs support for TLS in TLS but it is not implemented "
+                "in your runtime for the stdlib asyncio.\n\n"
+                "Please upgrade to Python 3.11 or higher. For more details, "
+                "please see:\n"
+                "* https://bugs.python.org/issue37179\n"
+                "* https://github.com/python/cpython/pull/28073\n"
+                "* https://docs.aiohttp.org/en/stable/"
+                "client_advanced.html#proxy-support\n"
+                "* https://github.com/aio-libs/aiohttp/discussions/6044\n",
+            ) from attr_exc
+
+    def _loop_supports_start_tls(self) -> bool:
+        try:
+            self._check_loop_for_start_tls()
+        except RuntimeError:
+            return False
+        else:
+            return True
+
+    def _warn_about_tls_in_tls(
+        self,
+        underlying_transport: asyncio.Transport,
+        req: ClientRequest,
+    ) -> None:
+        """Issue a warning if the requested URL has HTTPS scheme."""
+        if req.request_info.url.scheme != "https":
+            return
+
+        asyncio_supports_tls_in_tls = getattr(
+            underlying_transport,
+            "_start_tls_compatible",
+            False,
+        )
+
+        if asyncio_supports_tls_in_tls:
+            return
+
+        warnings.warn(
+            "An HTTPS request is being sent through an HTTPS proxy. "
+            "This support for TLS in TLS is known to be disabled "
+            "in the stdlib asyncio (Python <3.11). This is why you'll probably see "
+            "an error in the log below.\n\n"
+            "It is possible to enable it via monkeypatching. "
+            "For more details, see:\n"
+            "* https://bugs.python.org/issue37179\n"
+            "* https://github.com/python/cpython/pull/28073\n\n"
+            "You can temporarily patch this as follows:\n"
+            "* https://docs.aiohttp.org/en/stable/client_advanced.html#proxy-support\n"
+            "* https://github.com/aio-libs/aiohttp/discussions/6044\n",
+            RuntimeWarning,
+            source=self,
+            # Why `4`? At least 3 of the calls in the stack originate
+            # from the methods in this class.
+            stacklevel=3,
+        )
+
+    async def _start_tls_connection(
+        self,
+        underlying_transport: asyncio.Transport,
+        req: ClientRequest,
+        timeout: "ClientTimeout",
+        client_error: Type[Exception] = ClientConnectorError,
+    ) -> Tuple[asyncio.BaseTransport, ResponseHandler]:
+        """Wrap the raw TCP transport with TLS."""
+        tls_proto = self._factory()  # Create a brand new proto for TLS
+
+        # Safety of the `cast()` call here is based on the fact that
+        # internally `_get_ssl_context()` only returns `None` when
+        # `req.is_ssl()` evaluates to `False` which is never gonna happen
+        # in this code path. Of course, it's rather fragile
+        # maintainability-wise but this is to be solved separately.
+        sslcontext = cast(ssl.SSLContext, self._get_ssl_context(req))
+
+        try:
+            async with ceil_timeout(
+                timeout.sock_connect, ceil_threshold=timeout.ceil_threshold
+            ):
+                try:
+                    tls_transport = await self._loop.start_tls(
+                        underlying_transport,
+                        tls_proto,
+                        sslcontext,
+                        server_hostname=req.server_hostname or req.host,
+                        ssl_handshake_timeout=timeout.total,
+                    )
+                except BaseException:
+                    # We need to close the underlying transport since
+                    # `start_tls()` probably failed before it had a
+                    # chance to do this:
+                    underlying_transport.close()
+                    raise
+        except cert_errors as exc:
+            raise ClientConnectorCertificateError(req.connection_key, exc) from exc
+        except ssl_errors as exc:
+            raise ClientConnectorSSLError(req.connection_key, exc) from exc
+        except OSError as exc:
+            if exc.errno is None and isinstance(exc, asyncio.TimeoutError):
+                raise
+            raise client_error(req.connection_key, exc) from exc
+        except TypeError as type_err:
+            # Example cause looks like this:
+            # TypeError: transport <asyncio.sslproto._SSLProtocolTransport
+            # object at 0x7f760615e460> is not supported by start_tls()
+
+            raise ClientConnectionError(
+                "Cannot initialize a TLS-in-TLS connection to host "
+                f"{req.host!s}:{req.port:d} through an underlying connection "
+                f"to an HTTPS proxy {req.proxy!s} ssl:{req.ssl or 'default'} "
+                f"[{type_err!s}]"
+            ) from type_err
+        else:
+            if tls_transport is None:
+                msg = "Failed to start TLS (possibly caused by closing transport)"
+                raise client_error(req.connection_key, OSError(msg))
+            tls_proto.connection_made(
+                tls_transport
+            )  # Kick the state machine of the new TLS protocol
+
+        return tls_transport, tls_proto
+
+    async def _create_direct_connection(
+        self,
+        req: ClientRequest,
+        traces: List["Trace"],
+        timeout: "ClientTimeout",
+        *,
+        client_error: Type[Exception] = ClientConnectorError,
+    ) -> Tuple[asyncio.Transport, ResponseHandler]:
+        sslcontext = self._get_ssl_context(req)
+        fingerprint = self._get_fingerprint(req)
+
+        host = req.url.raw_host
+        assert host is not None
+        # Replace multiple trailing dots with a single one.
+        # A trailing dot is only present for fully-qualified domain names.
+        # See https://github.com/aio-libs/aiohttp/pull/7364.
+        if host.endswith(".."):
+            host = host.rstrip(".") + "."
+        port = req.port
+        assert port is not None
+        try:
+            # Cancelling this lookup should not cancel the underlying lookup
+            #  or else the cancel event will get broadcast to all the waiters
+            #  across all connections.
+            hosts = await self._resolve_host(host, port, traces=traces)
+        except OSError as exc:
+            if exc.errno is None and isinstance(exc, asyncio.TimeoutError):
+                raise
+            # in case of proxy it is not ClientProxyConnectionError
+            # it is problem of resolving proxy ip itself
+            raise ClientConnectorError(req.connection_key, exc) from exc
+
+        last_exc: Optional[Exception] = None
+
+        for hinfo in hosts:
+            host = hinfo["host"]
+            port = hinfo["port"]
+
+            # Strip trailing dots, certificates contain FQDN without dots.
+            # See https://github.com/aio-libs/aiohttp/issues/3636
+            server_hostname = (
+                (req.server_hostname or hinfo["hostname"]).rstrip(".")
+                if sslcontext
+                else None
+            )
+
+            try:
+                transp, proto = await self._wrap_create_connection(
+                    self._factory,
+                    host,
+                    port,
+                    timeout=timeout,
+                    ssl=sslcontext,
+                    family=hinfo["family"],
+                    proto=hinfo["proto"],
+                    flags=hinfo["flags"],
+                    server_hostname=server_hostname,
+                    local_addr=self._local_addr,
+                    req=req,
+                    client_error=client_error,
+                )
+            except ClientConnectorError as exc:
+                last_exc = exc
+                continue
+
+            if req.is_ssl() and fingerprint:
+                try:
+                    fingerprint.check(transp)
+                except ServerFingerprintMismatch as exc:
+                    transp.close()
+                    if not self._cleanup_closed_disabled:
+                        self._cleanup_closed_transports.append(transp)
+                    last_exc = exc
+                    continue
+
+            return transp, proto
+        else:
+            assert last_exc is not None
+            raise last_exc
+
+    async def _create_proxy_connection(
+        self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout"
+    ) -> Tuple[asyncio.BaseTransport, ResponseHandler]:
+        self._fail_on_no_start_tls(req)
+        runtime_has_start_tls = self._loop_supports_start_tls()
+
+        headers: Dict[str, str] = {}
+        if req.proxy_headers is not None:
+            headers = req.proxy_headers  # type: ignore[assignment]
+        headers[hdrs.HOST] = req.headers[hdrs.HOST]
+
+        url = req.proxy
+        assert url is not None
+        proxy_req = ClientRequest(
+            hdrs.METH_GET,
+            url,
+            headers=headers,
+            auth=req.proxy_auth,
+            loop=self._loop,
+            ssl=req.ssl,
+        )
+
+        # create connection to proxy server
+        transport, proto = await self._create_direct_connection(
+            proxy_req, [], timeout, client_error=ClientProxyConnectionError
+        )
+
+        # Many HTTP proxies has buggy keepalive support.  Let's not
+        # reuse connection but close it after processing every
+        # response.
+        proto.force_close()
+
+        auth = proxy_req.headers.pop(hdrs.AUTHORIZATION, None)
+        if auth is not None:
+            if not req.is_ssl():
+                req.headers[hdrs.PROXY_AUTHORIZATION] = auth
+            else:
+                proxy_req.headers[hdrs.PROXY_AUTHORIZATION] = auth
+
+        if req.is_ssl():
+            if runtime_has_start_tls:
+                self._warn_about_tls_in_tls(transport, req)
+
+            # For HTTPS requests over HTTP proxy
+            # we must notify proxy to tunnel connection
+            # so we send CONNECT command:
+            #   CONNECT www.python.org:443 HTTP/1.1
+            #   Host: www.python.org
+            #
+            # next we must do TLS handshake and so on
+            # to do this we must wrap raw socket into secure one
+            # asyncio handles this perfectly
+            proxy_req.method = hdrs.METH_CONNECT
+            proxy_req.url = req.url
+            key = attr.evolve(
+                req.connection_key, proxy=None, proxy_auth=None, proxy_headers_hash=None
+            )
+            conn = Connection(self, key, proto, self._loop)
+            proxy_resp = await proxy_req.send(conn)
+            try:
+                protocol = conn._protocol
+                assert protocol is not None
+
+                # read_until_eof=True will ensure the connection isn't closed
+                # once the response is received and processed allowing
+                # START_TLS to work on the connection below.
+                protocol.set_response_params(
+                    read_until_eof=runtime_has_start_tls,
+                    timeout_ceil_threshold=self._timeout_ceil_threshold,
+                )
+                resp = await proxy_resp.start(conn)
+            except BaseException:
+                proxy_resp.close()
+                conn.close()
+                raise
+            else:
+                conn._protocol = None
+                conn._transport = None
+                try:
+                    if resp.status != 200:
+                        message = resp.reason
+                        if message is None:
+                            message = HTTPStatus(resp.status).phrase
+                        raise ClientHttpProxyError(
+                            proxy_resp.request_info,
+                            resp.history,
+                            status=resp.status,
+                            message=message,
+                            headers=resp.headers,
+                        )
+                    if not runtime_has_start_tls:
+                        rawsock = transport.get_extra_info("socket", default=None)
+                        if rawsock is None:
+                            raise RuntimeError(
+                                "Transport does not expose socket instance"
+                            )
+                        # Duplicate the socket, so now we can close proxy transport
+                        rawsock = rawsock.dup()
+                except BaseException:
+                    # It shouldn't be closed in `finally` because it's fed to
+                    # `loop.start_tls()` and the docs say not to touch it after
+                    # passing there.
+                    transport.close()
+                    raise
+                finally:
+                    if not runtime_has_start_tls:
+                        transport.close()
+
+                if not runtime_has_start_tls:
+                    # HTTP proxy with support for upgrade to HTTPS
+                    sslcontext = self._get_ssl_context(req)
+                    return await self._wrap_create_connection(
+                        self._factory,
+                        timeout=timeout,
+                        ssl=sslcontext,
+                        sock=rawsock,
+                        server_hostname=req.host,
+                        req=req,
+                    )
+
+                return await self._start_tls_connection(
+                    # Access the old transport for the last time before it's
+                    # closed and forgotten forever:
+                    transport,
+                    req=req,
+                    timeout=timeout,
+                )
+            finally:
+                proxy_resp.close()
+
+        return transport, proto
+
+
+class UnixConnector(BaseConnector):
+    """Unix socket connector.
+
+    path - Unix socket path.
+    keepalive_timeout - (optional) Keep-alive timeout.
+    force_close - Set to True to force close and do reconnect
+        after each request (and between redirects).
+    limit - The total number of simultaneous connections.
+    limit_per_host - Number of simultaneous connections to one host.
+    loop - Optional event loop.
+    """
+
+    def __init__(
+        self,
+        path: str,
+        force_close: bool = False,
+        keepalive_timeout: Union[object, float, None] = sentinel,
+        limit: int = 100,
+        limit_per_host: int = 0,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+    ) -> None:
+        super().__init__(
+            force_close=force_close,
+            keepalive_timeout=keepalive_timeout,
+            limit=limit,
+            limit_per_host=limit_per_host,
+            loop=loop,
+        )
+        self._path = path
+
+    @property
+    def path(self) -> str:
+        """Path to unix socket."""
+        return self._path
+
+    async def _create_connection(
+        self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout"
+    ) -> ResponseHandler:
+        try:
+            async with ceil_timeout(
+                timeout.sock_connect, ceil_threshold=timeout.ceil_threshold
+            ):
+                _, proto = await self._loop.create_unix_connection(
+                    self._factory, self._path
+                )
+        except OSError as exc:
+            if exc.errno is None and isinstance(exc, asyncio.TimeoutError):
+                raise
+            raise UnixClientConnectorError(self.path, req.connection_key, exc) from exc
+
+        return proto
+
+
+class NamedPipeConnector(BaseConnector):
+    """Named pipe connector.
+
+    Only supported by the proactor event loop.
+    See also: https://docs.python.org/3/library/asyncio-eventloop.html
+
+    path - Windows named pipe path.
+    keepalive_timeout - (optional) Keep-alive timeout.
+    force_close - Set to True to force close and do reconnect
+        after each request (and between redirects).
+    limit - The total number of simultaneous connections.
+    limit_per_host - Number of simultaneous connections to one host.
+    loop - Optional event loop.
+    """
+
+    def __init__(
+        self,
+        path: str,
+        force_close: bool = False,
+        keepalive_timeout: Union[object, float, None] = sentinel,
+        limit: int = 100,
+        limit_per_host: int = 0,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+    ) -> None:
+        super().__init__(
+            force_close=force_close,
+            keepalive_timeout=keepalive_timeout,
+            limit=limit,
+            limit_per_host=limit_per_host,
+            loop=loop,
+        )
+        if not isinstance(
+            self._loop, asyncio.ProactorEventLoop  # type: ignore[attr-defined]
+        ):
+            raise RuntimeError(
+                "Named Pipes only available in proactor " "loop under windows"
+            )
+        self._path = path
+
+    @property
+    def path(self) -> str:
+        """Path to the named pipe."""
+        return self._path
+
+    async def _create_connection(
+        self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout"
+    ) -> ResponseHandler:
+        try:
+            async with ceil_timeout(
+                timeout.sock_connect, ceil_threshold=timeout.ceil_threshold
+            ):
+                _, proto = await self._loop.create_pipe_connection(  # type: ignore[attr-defined]
+                    self._factory, self._path
+                )
+                # the drain is required so that the connection_made is called
+                # and transport is set otherwise it is not set before the
+                # `assert conn.transport is not None`
+                # in client.py's _request method
+                await asyncio.sleep(0)
+                # other option is to manually set transport like
+                # `proto.transport = trans`
+        except OSError as exc:
+            if exc.errno is None and isinstance(exc, asyncio.TimeoutError):
+                raise
+            raise ClientConnectorError(req.connection_key, exc) from exc
+
+        return cast(ResponseHandler, proto)
diff --git a/llm/Lib/site-packages/aiohttp/cookiejar.py b/llm/Lib/site-packages/aiohttp/cookiejar.py
new file mode 100644
index 0000000000000000000000000000000000000000..5d59717335e9760b252df2b5551d532723d8dcc3
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/cookiejar.py
@@ -0,0 +1,419 @@
+import asyncio
+import calendar
+import contextlib
+import datetime
+import os  # noqa
+import pathlib
+import pickle
+import re
+import time
+from collections import defaultdict
+from http.cookies import BaseCookie, Morsel, SimpleCookie
+from math import ceil
+from typing import (  # noqa
+    DefaultDict,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Set,
+    Tuple,
+    Union,
+    cast,
+)
+
+from yarl import URL
+
+from .abc import AbstractCookieJar, ClearCookiePredicate
+from .helpers import is_ip_address
+from .typedefs import LooseCookies, PathLike, StrOrURL
+
+__all__ = ("CookieJar", "DummyCookieJar")
+
+
+CookieItem = Union[str, "Morsel[str]"]
+
+
+class CookieJar(AbstractCookieJar):
+    """Implements cookie storage adhering to RFC 6265."""
+
+    DATE_TOKENS_RE = re.compile(
+        r"[\x09\x20-\x2F\x3B-\x40\x5B-\x60\x7B-\x7E]*"
+        r"(?P<token>[\x00-\x08\x0A-\x1F\d:a-zA-Z\x7F-\xFF]+)"
+    )
+
+    DATE_HMS_TIME_RE = re.compile(r"(\d{1,2}):(\d{1,2}):(\d{1,2})")
+
+    DATE_DAY_OF_MONTH_RE = re.compile(r"(\d{1,2})")
+
+    DATE_MONTH_RE = re.compile(
+        "(jan)|(feb)|(mar)|(apr)|(may)|(jun)|(jul)|" "(aug)|(sep)|(oct)|(nov)|(dec)",
+        re.I,
+    )
+
+    DATE_YEAR_RE = re.compile(r"(\d{2,4})")
+
+    # calendar.timegm() fails for timestamps after datetime.datetime.max
+    # Minus one as a loss of precision occurs when timestamp() is called.
+    MAX_TIME = (
+        int(datetime.datetime.max.replace(tzinfo=datetime.timezone.utc).timestamp()) - 1
+    )
+    try:
+        calendar.timegm(time.gmtime(MAX_TIME))
+    except (OSError, ValueError):
+        # Hit the maximum representable time on Windows
+        # https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/localtime-localtime32-localtime64
+        # Throws ValueError on PyPy 3.8 and 3.9, OSError elsewhere
+        MAX_TIME = calendar.timegm((3000, 12, 31, 23, 59, 59, -1, -1, -1))
+    except OverflowError:
+        # #4515: datetime.max may not be representable on 32-bit platforms
+        MAX_TIME = 2**31 - 1
+    # Avoid minuses in the future, 3x faster
+    SUB_MAX_TIME = MAX_TIME - 1
+
+    def __init__(
+        self,
+        *,
+        unsafe: bool = False,
+        quote_cookie: bool = True,
+        treat_as_secure_origin: Union[StrOrURL, List[StrOrURL], None] = None,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+    ) -> None:
+        super().__init__(loop=loop)
+        self._cookies: DefaultDict[Tuple[str, str], SimpleCookie] = defaultdict(
+            SimpleCookie
+        )
+        self._host_only_cookies: Set[Tuple[str, str]] = set()
+        self._unsafe = unsafe
+        self._quote_cookie = quote_cookie
+        if treat_as_secure_origin is None:
+            treat_as_secure_origin = []
+        elif isinstance(treat_as_secure_origin, URL):
+            treat_as_secure_origin = [treat_as_secure_origin.origin()]
+        elif isinstance(treat_as_secure_origin, str):
+            treat_as_secure_origin = [URL(treat_as_secure_origin).origin()]
+        else:
+            treat_as_secure_origin = [
+                URL(url).origin() if isinstance(url, str) else url.origin()
+                for url in treat_as_secure_origin
+            ]
+        self._treat_as_secure_origin = treat_as_secure_origin
+        self._next_expiration: float = ceil(time.time())
+        self._expirations: Dict[Tuple[str, str, str], float] = {}
+
+    def save(self, file_path: PathLike) -> None:
+        file_path = pathlib.Path(file_path)
+        with file_path.open(mode="wb") as f:
+            pickle.dump(self._cookies, f, pickle.HIGHEST_PROTOCOL)
+
+    def load(self, file_path: PathLike) -> None:
+        file_path = pathlib.Path(file_path)
+        with file_path.open(mode="rb") as f:
+            self._cookies = pickle.load(f)
+
+    def clear(self, predicate: Optional[ClearCookiePredicate] = None) -> None:
+        if predicate is None:
+            self._next_expiration = ceil(time.time())
+            self._cookies.clear()
+            self._host_only_cookies.clear()
+            self._expirations.clear()
+            return
+
+        to_del = []
+        now = time.time()
+        for (domain, path), cookie in self._cookies.items():
+            for name, morsel in cookie.items():
+                key = (domain, path, name)
+                if (
+                    key in self._expirations and self._expirations[key] <= now
+                ) or predicate(morsel):
+                    to_del.append(key)
+
+        for domain, path, name in to_del:
+            self._host_only_cookies.discard((domain, name))
+            key = (domain, path, name)
+            if key in self._expirations:
+                del self._expirations[(domain, path, name)]
+            self._cookies[(domain, path)].pop(name, None)
+
+        self._next_expiration = (
+            min(*self._expirations.values(), self.SUB_MAX_TIME) + 1
+            if self._expirations
+            else self.MAX_TIME
+        )
+
+    def clear_domain(self, domain: str) -> None:
+        self.clear(lambda x: self._is_domain_match(domain, x["domain"]))
+
+    def __iter__(self) -> "Iterator[Morsel[str]]":
+        self._do_expiration()
+        for val in self._cookies.values():
+            yield from val.values()
+
+    def __len__(self) -> int:
+        return sum(1 for i in self)
+
+    def _do_expiration(self) -> None:
+        self.clear(lambda x: False)
+
+    def _expire_cookie(self, when: float, domain: str, path: str, name: str) -> None:
+        self._next_expiration = min(self._next_expiration, when)
+        self._expirations[(domain, path, name)] = when
+
+    def update_cookies(self, cookies: LooseCookies, response_url: URL = URL()) -> None:
+        """Update cookies."""
+        hostname = response_url.raw_host
+
+        if not self._unsafe and is_ip_address(hostname):
+            # Don't accept cookies from IPs
+            return
+
+        if isinstance(cookies, Mapping):
+            cookies = cookies.items()
+
+        for name, cookie in cookies:
+            if not isinstance(cookie, Morsel):
+                tmp = SimpleCookie()
+                tmp[name] = cookie  # type: ignore[assignment]
+                cookie = tmp[name]
+
+            domain = cookie["domain"]
+
+            # ignore domains with trailing dots
+            if domain.endswith("."):
+                domain = ""
+                del cookie["domain"]
+
+            if not domain and hostname is not None:
+                # Set the cookie's domain to the response hostname
+                # and set its host-only-flag
+                self._host_only_cookies.add((hostname, name))
+                domain = cookie["domain"] = hostname
+
+            if domain.startswith("."):
+                # Remove leading dot
+                domain = domain[1:]
+                cookie["domain"] = domain
+
+            if hostname and not self._is_domain_match(domain, hostname):
+                # Setting cookies for different domains is not allowed
+                continue
+
+            path = cookie["path"]
+            if not path or not path.startswith("/"):
+                # Set the cookie's path to the response path
+                path = response_url.path
+                if not path.startswith("/"):
+                    path = "/"
+                else:
+                    # Cut everything from the last slash to the end
+                    path = "/" + path[1 : path.rfind("/")]
+                cookie["path"] = path
+
+            max_age = cookie["max-age"]
+            if max_age:
+                try:
+                    delta_seconds = int(max_age)
+                    max_age_expiration = min(time.time() + delta_seconds, self.MAX_TIME)
+                    self._expire_cookie(max_age_expiration, domain, path, name)
+                except ValueError:
+                    cookie["max-age"] = ""
+
+            else:
+                expires = cookie["expires"]
+                if expires:
+                    expire_time = self._parse_date(expires)
+                    if expire_time:
+                        self._expire_cookie(expire_time, domain, path, name)
+                    else:
+                        cookie["expires"] = ""
+
+            self._cookies[(domain, path)][name] = cookie
+
+        self._do_expiration()
+
+    def filter_cookies(self, request_url: URL = URL()) -> "BaseCookie[str]":
+        """Returns this jar's cookies filtered by their attributes."""
+        filtered: Union[SimpleCookie, "BaseCookie[str]"] = (
+            SimpleCookie() if self._quote_cookie else BaseCookie()
+        )
+        if not self._cookies:
+            # Skip do_expiration() if there are no cookies.
+            return filtered
+        self._do_expiration()
+        if not self._cookies:
+            # Skip rest of function if no non-expired cookies.
+            return filtered
+        request_url = URL(request_url)
+        hostname = request_url.raw_host or ""
+
+        is_not_secure = request_url.scheme not in ("https", "wss")
+        if is_not_secure and self._treat_as_secure_origin:
+            request_origin = URL()
+            with contextlib.suppress(ValueError):
+                request_origin = request_url.origin()
+            is_not_secure = request_origin not in self._treat_as_secure_origin
+
+        # Point 2: https://www.rfc-editor.org/rfc/rfc6265.html#section-5.4
+        for cookie in sorted(self, key=lambda c: len(c["path"])):
+            name = cookie.key
+            domain = cookie["domain"]
+
+            # Send shared cookies
+            if not domain:
+                filtered[name] = cookie.value
+                continue
+
+            if not self._unsafe and is_ip_address(hostname):
+                continue
+
+            if (domain, name) in self._host_only_cookies:
+                if domain != hostname:
+                    continue
+            elif not self._is_domain_match(domain, hostname):
+                continue
+
+            if not self._is_path_match(request_url.path, cookie["path"]):
+                continue
+
+            if is_not_secure and cookie["secure"]:
+                continue
+
+            # It's critical we use the Morsel so the coded_value
+            # (based on cookie version) is preserved
+            mrsl_val = cast("Morsel[str]", cookie.get(cookie.key, Morsel()))
+            mrsl_val.set(cookie.key, cookie.value, cookie.coded_value)
+            filtered[name] = mrsl_val
+
+        return filtered
+
+    @staticmethod
+    def _is_domain_match(domain: str, hostname: str) -> bool:
+        """Implements domain matching adhering to RFC 6265."""
+        if hostname == domain:
+            return True
+
+        if not hostname.endswith(domain):
+            return False
+
+        non_matching = hostname[: -len(domain)]
+
+        if not non_matching.endswith("."):
+            return False
+
+        return not is_ip_address(hostname)
+
+    @staticmethod
+    def _is_path_match(req_path: str, cookie_path: str) -> bool:
+        """Implements path matching adhering to RFC 6265."""
+        if not req_path.startswith("/"):
+            req_path = "/"
+
+        if req_path == cookie_path:
+            return True
+
+        if not req_path.startswith(cookie_path):
+            return False
+
+        if cookie_path.endswith("/"):
+            return True
+
+        non_matching = req_path[len(cookie_path) :]
+
+        return non_matching.startswith("/")
+
+    @classmethod
+    def _parse_date(cls, date_str: str) -> Optional[int]:
+        """Implements date string parsing adhering to RFC 6265."""
+        if not date_str:
+            return None
+
+        found_time = False
+        found_day = False
+        found_month = False
+        found_year = False
+
+        hour = minute = second = 0
+        day = 0
+        month = 0
+        year = 0
+
+        for token_match in cls.DATE_TOKENS_RE.finditer(date_str):
+
+            token = token_match.group("token")
+
+            if not found_time:
+                time_match = cls.DATE_HMS_TIME_RE.match(token)
+                if time_match:
+                    found_time = True
+                    hour, minute, second = (int(s) for s in time_match.groups())
+                    continue
+
+            if not found_day:
+                day_match = cls.DATE_DAY_OF_MONTH_RE.match(token)
+                if day_match:
+                    found_day = True
+                    day = int(day_match.group())
+                    continue
+
+            if not found_month:
+                month_match = cls.DATE_MONTH_RE.match(token)
+                if month_match:
+                    found_month = True
+                    assert month_match.lastindex is not None
+                    month = month_match.lastindex
+                    continue
+
+            if not found_year:
+                year_match = cls.DATE_YEAR_RE.match(token)
+                if year_match:
+                    found_year = True
+                    year = int(year_match.group())
+
+        if 70 <= year <= 99:
+            year += 1900
+        elif 0 <= year <= 69:
+            year += 2000
+
+        if False in (found_day, found_month, found_year, found_time):
+            return None
+
+        if not 1 <= day <= 31:
+            return None
+
+        if year < 1601 or hour > 23 or minute > 59 or second > 59:
+            return None
+
+        return calendar.timegm((year, month, day, hour, minute, second, -1, -1, -1))
+
+
+class DummyCookieJar(AbstractCookieJar):
+    """Implements a dummy cookie storage.
+
+    It can be used with the ClientSession when no cookie processing is needed.
+
+    """
+
+    def __init__(self, *, loop: Optional[asyncio.AbstractEventLoop] = None) -> None:
+        super().__init__(loop=loop)
+
+    def __iter__(self) -> "Iterator[Morsel[str]]":
+        while False:
+            yield None
+
+    def __len__(self) -> int:
+        return 0
+
+    def clear(self, predicate: Optional[ClearCookiePredicate] = None) -> None:
+        pass
+
+    def clear_domain(self, domain: str) -> None:
+        pass
+
+    def update_cookies(self, cookies: LooseCookies, response_url: URL = URL()) -> None:
+        pass
+
+    def filter_cookies(self, request_url: URL) -> "BaseCookie[str]":
+        return SimpleCookie()
diff --git a/llm/Lib/site-packages/aiohttp/formdata.py b/llm/Lib/site-packages/aiohttp/formdata.py
new file mode 100644
index 0000000000000000000000000000000000000000..bbf78a82d124548d26915969f5b9c75398cf29a9
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/formdata.py
@@ -0,0 +1,182 @@
+import io
+import warnings
+from typing import Any, Iterable, List, Optional
+from urllib.parse import urlencode
+
+from multidict import MultiDict, MultiDictProxy
+
+from . import hdrs, multipart, payload
+from .helpers import guess_filename
+from .payload import Payload
+
+__all__ = ("FormData",)
+
+
+class FormData:
+    """Helper class for form body generation.
+
+    Supports multipart/form-data and application/x-www-form-urlencoded.
+    """
+
+    def __init__(
+        self,
+        fields: Iterable[Any] = (),
+        quote_fields: bool = True,
+        charset: Optional[str] = None,
+    ) -> None:
+        self._writer = multipart.MultipartWriter("form-data")
+        self._fields: List[Any] = []
+        self._is_multipart = False
+        self._is_processed = False
+        self._quote_fields = quote_fields
+        self._charset = charset
+
+        if isinstance(fields, dict):
+            fields = list(fields.items())
+        elif not isinstance(fields, (list, tuple)):
+            fields = (fields,)
+        self.add_fields(*fields)
+
+    @property
+    def is_multipart(self) -> bool:
+        return self._is_multipart
+
+    def add_field(
+        self,
+        name: str,
+        value: Any,
+        *,
+        content_type: Optional[str] = None,
+        filename: Optional[str] = None,
+        content_transfer_encoding: Optional[str] = None,
+    ) -> None:
+
+        if isinstance(value, io.IOBase):
+            self._is_multipart = True
+        elif isinstance(value, (bytes, bytearray, memoryview)):
+            msg = (
+                "In v4, passing bytes will no longer create a file field. "
+                "Please explicitly use the filename parameter or pass a BytesIO object."
+            )
+            if filename is None and content_transfer_encoding is None:
+                warnings.warn(msg, DeprecationWarning)
+                filename = name
+
+        type_options: MultiDict[str] = MultiDict({"name": name})
+        if filename is not None and not isinstance(filename, str):
+            raise TypeError(
+                "filename must be an instance of str. " "Got: %s" % filename
+            )
+        if filename is None and isinstance(value, io.IOBase):
+            filename = guess_filename(value, name)
+        if filename is not None:
+            type_options["filename"] = filename
+            self._is_multipart = True
+
+        headers = {}
+        if content_type is not None:
+            if not isinstance(content_type, str):
+                raise TypeError(
+                    "content_type must be an instance of str. " "Got: %s" % content_type
+                )
+            headers[hdrs.CONTENT_TYPE] = content_type
+            self._is_multipart = True
+        if content_transfer_encoding is not None:
+            if not isinstance(content_transfer_encoding, str):
+                raise TypeError(
+                    "content_transfer_encoding must be an instance"
+                    " of str. Got: %s" % content_transfer_encoding
+                )
+            msg = (
+                "content_transfer_encoding is deprecated. "
+                "To maintain compatibility with v4 please pass a BytesPayload."
+            )
+            warnings.warn(msg, DeprecationWarning)
+            self._is_multipart = True
+
+        self._fields.append((type_options, headers, value))
+
+    def add_fields(self, *fields: Any) -> None:
+        to_add = list(fields)
+
+        while to_add:
+            rec = to_add.pop(0)
+
+            if isinstance(rec, io.IOBase):
+                k = guess_filename(rec, "unknown")
+                self.add_field(k, rec)  # type: ignore[arg-type]
+
+            elif isinstance(rec, (MultiDictProxy, MultiDict)):
+                to_add.extend(rec.items())
+
+            elif isinstance(rec, (list, tuple)) and len(rec) == 2:
+                k, fp = rec
+                self.add_field(k, fp)  # type: ignore[arg-type]
+
+            else:
+                raise TypeError(
+                    "Only io.IOBase, multidict and (name, file) "
+                    "pairs allowed, use .add_field() for passing "
+                    "more complex parameters, got {!r}".format(rec)
+                )
+
+    def _gen_form_urlencoded(self) -> payload.BytesPayload:
+        # form data (x-www-form-urlencoded)
+        data = []
+        for type_options, _, value in self._fields:
+            data.append((type_options["name"], value))
+
+        charset = self._charset if self._charset is not None else "utf-8"
+
+        if charset == "utf-8":
+            content_type = "application/x-www-form-urlencoded"
+        else:
+            content_type = "application/x-www-form-urlencoded; " "charset=%s" % charset
+
+        return payload.BytesPayload(
+            urlencode(data, doseq=True, encoding=charset).encode(),
+            content_type=content_type,
+        )
+
+    def _gen_form_data(self) -> multipart.MultipartWriter:
+        """Encode a list of fields using the multipart/form-data MIME format"""
+        if self._is_processed:
+            raise RuntimeError("Form data has been processed already")
+        for dispparams, headers, value in self._fields:
+            try:
+                if hdrs.CONTENT_TYPE in headers:
+                    part = payload.get_payload(
+                        value,
+                        content_type=headers[hdrs.CONTENT_TYPE],
+                        headers=headers,
+                        encoding=self._charset,
+                    )
+                else:
+                    part = payload.get_payload(
+                        value, headers=headers, encoding=self._charset
+                    )
+            except Exception as exc:
+                raise TypeError(
+                    "Can not serialize value type: %r\n "
+                    "headers: %r\n value: %r" % (type(value), headers, value)
+                ) from exc
+
+            if dispparams:
+                part.set_content_disposition(
+                    "form-data", quote_fields=self._quote_fields, **dispparams
+                )
+                # FIXME cgi.FieldStorage doesn't likes body parts with
+                # Content-Length which were sent via chunked transfer encoding
+                assert part.headers is not None
+                part.headers.popall(hdrs.CONTENT_LENGTH, None)
+
+            self._writer.append_payload(part)
+
+        self._is_processed = True
+        return self._writer
+
+    def __call__(self) -> Payload:
+        if self._is_multipart:
+            return self._gen_form_data()
+        else:
+            return self._gen_form_urlencoded()
diff --git a/llm/Lib/site-packages/aiohttp/hdrs.py b/llm/Lib/site-packages/aiohttp/hdrs.py
new file mode 100644
index 0000000000000000000000000000000000000000..078abfff86be97186724b5bdf0e03613c34d9bbc
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/hdrs.py
@@ -0,0 +1,108 @@
+"""HTTP Headers constants."""
+
+# After changing the file content call ./tools/gen.py
+# to regenerate the headers parser
+from typing import Final, Set
+
+from multidict import istr
+
+METH_ANY: Final[str] = "*"
+METH_CONNECT: Final[str] = "CONNECT"
+METH_HEAD: Final[str] = "HEAD"
+METH_GET: Final[str] = "GET"
+METH_DELETE: Final[str] = "DELETE"
+METH_OPTIONS: Final[str] = "OPTIONS"
+METH_PATCH: Final[str] = "PATCH"
+METH_POST: Final[str] = "POST"
+METH_PUT: Final[str] = "PUT"
+METH_TRACE: Final[str] = "TRACE"
+
+METH_ALL: Final[Set[str]] = {
+    METH_CONNECT,
+    METH_HEAD,
+    METH_GET,
+    METH_DELETE,
+    METH_OPTIONS,
+    METH_PATCH,
+    METH_POST,
+    METH_PUT,
+    METH_TRACE,
+}
+
+ACCEPT: Final[istr] = istr("Accept")
+ACCEPT_CHARSET: Final[istr] = istr("Accept-Charset")
+ACCEPT_ENCODING: Final[istr] = istr("Accept-Encoding")
+ACCEPT_LANGUAGE: Final[istr] = istr("Accept-Language")
+ACCEPT_RANGES: Final[istr] = istr("Accept-Ranges")
+ACCESS_CONTROL_MAX_AGE: Final[istr] = istr("Access-Control-Max-Age")
+ACCESS_CONTROL_ALLOW_CREDENTIALS: Final[istr] = istr("Access-Control-Allow-Credentials")
+ACCESS_CONTROL_ALLOW_HEADERS: Final[istr] = istr("Access-Control-Allow-Headers")
+ACCESS_CONTROL_ALLOW_METHODS: Final[istr] = istr("Access-Control-Allow-Methods")
+ACCESS_CONTROL_ALLOW_ORIGIN: Final[istr] = istr("Access-Control-Allow-Origin")
+ACCESS_CONTROL_EXPOSE_HEADERS: Final[istr] = istr("Access-Control-Expose-Headers")
+ACCESS_CONTROL_REQUEST_HEADERS: Final[istr] = istr("Access-Control-Request-Headers")
+ACCESS_CONTROL_REQUEST_METHOD: Final[istr] = istr("Access-Control-Request-Method")
+AGE: Final[istr] = istr("Age")
+ALLOW: Final[istr] = istr("Allow")
+AUTHORIZATION: Final[istr] = istr("Authorization")
+CACHE_CONTROL: Final[istr] = istr("Cache-Control")
+CONNECTION: Final[istr] = istr("Connection")
+CONTENT_DISPOSITION: Final[istr] = istr("Content-Disposition")
+CONTENT_ENCODING: Final[istr] = istr("Content-Encoding")
+CONTENT_LANGUAGE: Final[istr] = istr("Content-Language")
+CONTENT_LENGTH: Final[istr] = istr("Content-Length")
+CONTENT_LOCATION: Final[istr] = istr("Content-Location")
+CONTENT_MD5: Final[istr] = istr("Content-MD5")
+CONTENT_RANGE: Final[istr] = istr("Content-Range")
+CONTENT_TRANSFER_ENCODING: Final[istr] = istr("Content-Transfer-Encoding")
+CONTENT_TYPE: Final[istr] = istr("Content-Type")
+COOKIE: Final[istr] = istr("Cookie")
+DATE: Final[istr] = istr("Date")
+DESTINATION: Final[istr] = istr("Destination")
+DIGEST: Final[istr] = istr("Digest")
+ETAG: Final[istr] = istr("Etag")
+EXPECT: Final[istr] = istr("Expect")
+EXPIRES: Final[istr] = istr("Expires")
+FORWARDED: Final[istr] = istr("Forwarded")
+FROM: Final[istr] = istr("From")
+HOST: Final[istr] = istr("Host")
+IF_MATCH: Final[istr] = istr("If-Match")
+IF_MODIFIED_SINCE: Final[istr] = istr("If-Modified-Since")
+IF_NONE_MATCH: Final[istr] = istr("If-None-Match")
+IF_RANGE: Final[istr] = istr("If-Range")
+IF_UNMODIFIED_SINCE: Final[istr] = istr("If-Unmodified-Since")
+KEEP_ALIVE: Final[istr] = istr("Keep-Alive")
+LAST_EVENT_ID: Final[istr] = istr("Last-Event-ID")
+LAST_MODIFIED: Final[istr] = istr("Last-Modified")
+LINK: Final[istr] = istr("Link")
+LOCATION: Final[istr] = istr("Location")
+MAX_FORWARDS: Final[istr] = istr("Max-Forwards")
+ORIGIN: Final[istr] = istr("Origin")
+PRAGMA: Final[istr] = istr("Pragma")
+PROXY_AUTHENTICATE: Final[istr] = istr("Proxy-Authenticate")
+PROXY_AUTHORIZATION: Final[istr] = istr("Proxy-Authorization")
+RANGE: Final[istr] = istr("Range")
+REFERER: Final[istr] = istr("Referer")
+RETRY_AFTER: Final[istr] = istr("Retry-After")
+SEC_WEBSOCKET_ACCEPT: Final[istr] = istr("Sec-WebSocket-Accept")
+SEC_WEBSOCKET_VERSION: Final[istr] = istr("Sec-WebSocket-Version")
+SEC_WEBSOCKET_PROTOCOL: Final[istr] = istr("Sec-WebSocket-Protocol")
+SEC_WEBSOCKET_EXTENSIONS: Final[istr] = istr("Sec-WebSocket-Extensions")
+SEC_WEBSOCKET_KEY: Final[istr] = istr("Sec-WebSocket-Key")
+SEC_WEBSOCKET_KEY1: Final[istr] = istr("Sec-WebSocket-Key1")
+SERVER: Final[istr] = istr("Server")
+SET_COOKIE: Final[istr] = istr("Set-Cookie")
+TE: Final[istr] = istr("TE")
+TRAILER: Final[istr] = istr("Trailer")
+TRANSFER_ENCODING: Final[istr] = istr("Transfer-Encoding")
+UPGRADE: Final[istr] = istr("Upgrade")
+URI: Final[istr] = istr("URI")
+USER_AGENT: Final[istr] = istr("User-Agent")
+VARY: Final[istr] = istr("Vary")
+VIA: Final[istr] = istr("Via")
+WANT_DIGEST: Final[istr] = istr("Want-Digest")
+WARNING: Final[istr] = istr("Warning")
+WWW_AUTHENTICATE: Final[istr] = istr("WWW-Authenticate")
+X_FORWARDED_FOR: Final[istr] = istr("X-Forwarded-For")
+X_FORWARDED_HOST: Final[istr] = istr("X-Forwarded-Host")
+X_FORWARDED_PROTO: Final[istr] = istr("X-Forwarded-Proto")
diff --git a/llm/Lib/site-packages/aiohttp/helpers.py b/llm/Lib/site-packages/aiohttp/helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..f2d729f1bcecaeec317b715141303f99e53046cc
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/helpers.py
@@ -0,0 +1,1029 @@
+"""Various helper functions"""
+
+import asyncio
+import base64
+import binascii
+import contextlib
+import datetime
+import enum
+import functools
+import inspect
+import netrc
+import os
+import platform
+import re
+import sys
+import time
+import warnings
+import weakref
+from collections import namedtuple
+from contextlib import suppress
+from email.parser import HeaderParser
+from email.utils import parsedate
+from math import ceil
+from pathlib import Path
+from types import TracebackType
+from typing import (
+    Any,
+    Callable,
+    ContextManager,
+    Dict,
+    Generator,
+    Generic,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Pattern,
+    Protocol,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    get_args,
+    overload,
+)
+from urllib.parse import quote
+from urllib.request import getproxies, proxy_bypass
+
+import attr
+from multidict import MultiDict, MultiDictProxy, MultiMapping
+from yarl import URL
+
+from . import hdrs
+from .log import client_logger, internal_logger
+
+if sys.version_info >= (3, 11):
+    import asyncio as async_timeout
+else:
+    import async_timeout
+
+__all__ = ("BasicAuth", "ChainMapProxy", "ETag")
+
+IS_MACOS = platform.system() == "Darwin"
+IS_WINDOWS = platform.system() == "Windows"
+
+PY_310 = sys.version_info >= (3, 10)
+PY_311 = sys.version_info >= (3, 11)
+
+
+_T = TypeVar("_T")
+_S = TypeVar("_S")
+
+_SENTINEL = enum.Enum("_SENTINEL", "sentinel")
+sentinel = _SENTINEL.sentinel
+
+NO_EXTENSIONS = bool(os.environ.get("AIOHTTP_NO_EXTENSIONS"))
+
+DEBUG = sys.flags.dev_mode or (
+    not sys.flags.ignore_environment and bool(os.environ.get("PYTHONASYNCIODEBUG"))
+)
+
+
+CHAR = {chr(i) for i in range(0, 128)}
+CTL = {chr(i) for i in range(0, 32)} | {
+    chr(127),
+}
+SEPARATORS = {
+    "(",
+    ")",
+    "<",
+    ">",
+    "@",
+    ",",
+    ";",
+    ":",
+    "\\",
+    '"',
+    "/",
+    "[",
+    "]",
+    "?",
+    "=",
+    "{",
+    "}",
+    " ",
+    chr(9),
+}
+TOKEN = CHAR ^ CTL ^ SEPARATORS
+
+
+class noop:
+    def __await__(self) -> Generator[None, None, None]:
+        yield
+
+
+class BasicAuth(namedtuple("BasicAuth", ["login", "password", "encoding"])):
+    """Http basic authentication helper."""
+
+    def __new__(
+        cls, login: str, password: str = "", encoding: str = "latin1"
+    ) -> "BasicAuth":
+        if login is None:
+            raise ValueError("None is not allowed as login value")
+
+        if password is None:
+            raise ValueError("None is not allowed as password value")
+
+        if ":" in login:
+            raise ValueError('A ":" is not allowed in login (RFC 1945#section-11.1)')
+
+        return super().__new__(cls, login, password, encoding)
+
+    @classmethod
+    def decode(cls, auth_header: str, encoding: str = "latin1") -> "BasicAuth":
+        """Create a BasicAuth object from an Authorization HTTP header."""
+        try:
+            auth_type, encoded_credentials = auth_header.split(" ", 1)
+        except ValueError:
+            raise ValueError("Could not parse authorization header.")
+
+        if auth_type.lower() != "basic":
+            raise ValueError("Unknown authorization method %s" % auth_type)
+
+        try:
+            decoded = base64.b64decode(
+                encoded_credentials.encode("ascii"), validate=True
+            ).decode(encoding)
+        except binascii.Error:
+            raise ValueError("Invalid base64 encoding.")
+
+        try:
+            # RFC 2617 HTTP Authentication
+            # https://www.ietf.org/rfc/rfc2617.txt
+            # the colon must be present, but the username and password may be
+            # otherwise blank.
+            username, password = decoded.split(":", 1)
+        except ValueError:
+            raise ValueError("Invalid credentials.")
+
+        return cls(username, password, encoding=encoding)
+
+    @classmethod
+    def from_url(cls, url: URL, *, encoding: str = "latin1") -> Optional["BasicAuth"]:
+        """Create BasicAuth from url."""
+        if not isinstance(url, URL):
+            raise TypeError("url should be yarl.URL instance")
+        if url.user is None:
+            return None
+        return cls(url.user, url.password or "", encoding=encoding)
+
+    def encode(self) -> str:
+        """Encode credentials."""
+        creds = (f"{self.login}:{self.password}").encode(self.encoding)
+        return "Basic %s" % base64.b64encode(creds).decode(self.encoding)
+
+
+def strip_auth_from_url(url: URL) -> Tuple[URL, Optional[BasicAuth]]:
+    auth = BasicAuth.from_url(url)
+    if auth is None:
+        return url, None
+    else:
+        return url.with_user(None), auth
+
+
+def netrc_from_env() -> Optional[netrc.netrc]:
+    """Load netrc from file.
+
+    Attempt to load it from the path specified by the env-var
+    NETRC or in the default location in the user's home directory.
+
+    Returns None if it couldn't be found or fails to parse.
+    """
+    netrc_env = os.environ.get("NETRC")
+
+    if netrc_env is not None:
+        netrc_path = Path(netrc_env)
+    else:
+        try:
+            home_dir = Path.home()
+        except RuntimeError as e:  # pragma: no cover
+            # if pathlib can't resolve home, it may raise a RuntimeError
+            client_logger.debug(
+                "Could not resolve home directory when "
+                "trying to look for .netrc file: %s",
+                e,
+            )
+            return None
+
+        netrc_path = home_dir / ("_netrc" if IS_WINDOWS else ".netrc")
+
+    try:
+        return netrc.netrc(str(netrc_path))
+    except netrc.NetrcParseError as e:
+        client_logger.warning("Could not parse .netrc file: %s", e)
+    except OSError as e:
+        netrc_exists = False
+        with contextlib.suppress(OSError):
+            netrc_exists = netrc_path.is_file()
+        # we couldn't read the file (doesn't exist, permissions, etc.)
+        if netrc_env or netrc_exists:
+            # only warn if the environment wanted us to load it,
+            # or it appears like the default file does actually exist
+            client_logger.warning("Could not read .netrc file: %s", e)
+
+    return None
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class ProxyInfo:
+    proxy: URL
+    proxy_auth: Optional[BasicAuth]
+
+
+def basicauth_from_netrc(netrc_obj: Optional[netrc.netrc], host: str) -> BasicAuth:
+    """
+    Return :py:class:`~aiohttp.BasicAuth` credentials for ``host`` from ``netrc_obj``.
+
+    :raises LookupError: if ``netrc_obj`` is :py:data:`None` or if no
+            entry is found for the ``host``.
+    """
+    if netrc_obj is None:
+        raise LookupError("No .netrc file found")
+    auth_from_netrc = netrc_obj.authenticators(host)
+
+    if auth_from_netrc is None:
+        raise LookupError(f"No entry for {host!s} found in the `.netrc` file.")
+    login, account, password = auth_from_netrc
+
+    # TODO(PY311): username = login or account
+    # Up to python 3.10, account could be None if not specified,
+    # and login will be empty string if not specified. From 3.11,
+    # login and account will be empty string if not specified.
+    username = login if (login or account is None) else account
+
+    # TODO(PY311): Remove this, as password will be empty string
+    # if not specified
+    if password is None:
+        password = ""
+
+    return BasicAuth(username, password)
+
+
+def proxies_from_env() -> Dict[str, ProxyInfo]:
+    proxy_urls = {
+        k: URL(v)
+        for k, v in getproxies().items()
+        if k in ("http", "https", "ws", "wss")
+    }
+    netrc_obj = netrc_from_env()
+    stripped = {k: strip_auth_from_url(v) for k, v in proxy_urls.items()}
+    ret = {}
+    for proto, val in stripped.items():
+        proxy, auth = val
+        if proxy.scheme in ("https", "wss"):
+            client_logger.warning(
+                "%s proxies %s are not supported, ignoring", proxy.scheme.upper(), proxy
+            )
+            continue
+        if netrc_obj and auth is None:
+            if proxy.host is not None:
+                try:
+                    auth = basicauth_from_netrc(netrc_obj, proxy.host)
+                except LookupError:
+                    auth = None
+        ret[proto] = ProxyInfo(proxy, auth)
+    return ret
+
+
+def current_task(
+    loop: Optional[asyncio.AbstractEventLoop] = None,
+) -> "Optional[asyncio.Task[Any]]":
+    return asyncio.current_task(loop=loop)
+
+
+def get_running_loop(
+    loop: Optional[asyncio.AbstractEventLoop] = None,
+) -> asyncio.AbstractEventLoop:
+    if loop is None:
+        loop = asyncio.get_event_loop()
+    if not loop.is_running():
+        warnings.warn(
+            "The object should be created within an async function",
+            DeprecationWarning,
+            stacklevel=3,
+        )
+        if loop.get_debug():
+            internal_logger.warning(
+                "The object should be created within an async function", stack_info=True
+            )
+    return loop
+
+
+def isasyncgenfunction(obj: Any) -> bool:
+    func = getattr(inspect, "isasyncgenfunction", None)
+    if func is not None:
+        return func(obj)  # type: ignore[no-any-return]
+    else:
+        return False
+
+
+def get_env_proxy_for_url(url: URL) -> Tuple[URL, Optional[BasicAuth]]:
+    """Get a permitted proxy for the given URL from the env."""
+    if url.host is not None and proxy_bypass(url.host):
+        raise LookupError(f"Proxying is disallowed for `{url.host!r}`")
+
+    proxies_in_env = proxies_from_env()
+    try:
+        proxy_info = proxies_in_env[url.scheme]
+    except KeyError:
+        raise LookupError(f"No proxies found for `{url!s}` in the env")
+    else:
+        return proxy_info.proxy, proxy_info.proxy_auth
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class MimeType:
+    type: str
+    subtype: str
+    suffix: str
+    parameters: "MultiDictProxy[str]"
+
+
+@functools.lru_cache(maxsize=56)
+def parse_mimetype(mimetype: str) -> MimeType:
+    """Parses a MIME type into its components.
+
+    mimetype is a MIME type string.
+
+    Returns a MimeType object.
+
+    Example:
+
+    >>> parse_mimetype('text/html; charset=utf-8')
+    MimeType(type='text', subtype='html', suffix='',
+             parameters={'charset': 'utf-8'})
+
+    """
+    if not mimetype:
+        return MimeType(
+            type="", subtype="", suffix="", parameters=MultiDictProxy(MultiDict())
+        )
+
+    parts = mimetype.split(";")
+    params: MultiDict[str] = MultiDict()
+    for item in parts[1:]:
+        if not item:
+            continue
+        key, _, value = item.partition("=")
+        params.add(key.lower().strip(), value.strip(' "'))
+
+    fulltype = parts[0].strip().lower()
+    if fulltype == "*":
+        fulltype = "*/*"
+
+    mtype, _, stype = fulltype.partition("/")
+    stype, _, suffix = stype.partition("+")
+
+    return MimeType(
+        type=mtype, subtype=stype, suffix=suffix, parameters=MultiDictProxy(params)
+    )
+
+
+def guess_filename(obj: Any, default: Optional[str] = None) -> Optional[str]:
+    name = getattr(obj, "name", None)
+    if name and isinstance(name, str) and name[0] != "<" and name[-1] != ">":
+        return Path(name).name
+    return default
+
+
+not_qtext_re = re.compile(r"[^\041\043-\133\135-\176]")
+QCONTENT = {chr(i) for i in range(0x20, 0x7F)} | {"\t"}
+
+
+def quoted_string(content: str) -> str:
+    """Return 7-bit content as quoted-string.
+
+    Format content into a quoted-string as defined in RFC5322 for
+    Internet Message Format. Notice that this is not the 8-bit HTTP
+    format, but the 7-bit email format. Content must be in usascii or
+    a ValueError is raised.
+    """
+    if not (QCONTENT > set(content)):
+        raise ValueError(f"bad content for quoted-string {content!r}")
+    return not_qtext_re.sub(lambda x: "\\" + x.group(0), content)
+
+
+def content_disposition_header(
+    disptype: str, quote_fields: bool = True, _charset: str = "utf-8", **params: str
+) -> str:
+    """Sets ``Content-Disposition`` header for MIME.
+
+    This is the MIME payload Content-Disposition header from RFC 2183
+    and RFC 7579 section 4.2, not the HTTP Content-Disposition from
+    RFC 6266.
+
+    disptype is a disposition type: inline, attachment, form-data.
+    Should be valid extension token (see RFC 2183)
+
+    quote_fields performs value quoting to 7-bit MIME headers
+    according to RFC 7578. Set to quote_fields to False if recipient
+    can take 8-bit file names and field values.
+
+    _charset specifies the charset to use when quote_fields is True.
+
+    params is a dict with disposition params.
+    """
+    if not disptype or not (TOKEN > set(disptype)):
+        raise ValueError("bad content disposition type {!r}" "".format(disptype))
+
+    value = disptype
+    if params:
+        lparams = []
+        for key, val in params.items():
+            if not key or not (TOKEN > set(key)):
+                raise ValueError(
+                    "bad content disposition parameter" " {!r}={!r}".format(key, val)
+                )
+            if quote_fields:
+                if key.lower() == "filename":
+                    qval = quote(val, "", encoding=_charset)
+                    lparams.append((key, '"%s"' % qval))
+                else:
+                    try:
+                        qval = quoted_string(val)
+                    except ValueError:
+                        qval = "".join(
+                            (_charset, "''", quote(val, "", encoding=_charset))
+                        )
+                        lparams.append((key + "*", qval))
+                    else:
+                        lparams.append((key, '"%s"' % qval))
+            else:
+                qval = val.replace("\\", "\\\\").replace('"', '\\"')
+                lparams.append((key, '"%s"' % qval))
+        sparams = "; ".join("=".join(pair) for pair in lparams)
+        value = "; ".join((value, sparams))
+    return value
+
+
+class _TSelf(Protocol, Generic[_T]):
+    _cache: Dict[str, _T]
+
+
+class reify(Generic[_T]):
+    """Use as a class method decorator.
+
+    It operates almost exactly like
+    the Python `@property` decorator, but it puts the result of the
+    method it decorates into the instance dict after the first call,
+    effectively replacing the function it decorates with an instance
+    variable.  It is, in Python parlance, a data descriptor.
+    """
+
+    def __init__(self, wrapped: Callable[..., _T]) -> None:
+        self.wrapped = wrapped
+        self.__doc__ = wrapped.__doc__
+        self.name = wrapped.__name__
+
+    def __get__(self, inst: _TSelf[_T], owner: Optional[Type[Any]] = None) -> _T:
+        try:
+            try:
+                return inst._cache[self.name]
+            except KeyError:
+                val = self.wrapped(inst)
+                inst._cache[self.name] = val
+                return val
+        except AttributeError:
+            if inst is None:
+                return self
+            raise
+
+    def __set__(self, inst: _TSelf[_T], value: _T) -> None:
+        raise AttributeError("reified property is read-only")
+
+
+reify_py = reify
+
+try:
+    from ._helpers import reify as reify_c
+
+    if not NO_EXTENSIONS:
+        reify = reify_c  # type: ignore[misc,assignment]
+except ImportError:
+    pass
+
+_ipv4_pattern = (
+    r"^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}"
+    r"(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
+)
+_ipv6_pattern = (
+    r"^(?:(?:(?:[A-F0-9]{1,4}:){6}|(?=(?:[A-F0-9]{0,4}:){0,6}"
+    r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}$)(([0-9A-F]{1,4}:){0,5}|:)"
+    r"((:[0-9A-F]{1,4}){1,5}:|:)|::(?:[A-F0-9]{1,4}:){5})"
+    r"(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])\.){3}"
+    r"(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])|(?:[A-F0-9]{1,4}:){7}"
+    r"[A-F0-9]{1,4}|(?=(?:[A-F0-9]{0,4}:){0,7}[A-F0-9]{0,4}$)"
+    r"(([0-9A-F]{1,4}:){1,7}|:)((:[0-9A-F]{1,4}){1,7}|:)|(?:[A-F0-9]{1,4}:){7}"
+    r":|:(:[A-F0-9]{1,4}){7})$"
+)
+_ipv4_regex = re.compile(_ipv4_pattern)
+_ipv6_regex = re.compile(_ipv6_pattern, flags=re.IGNORECASE)
+_ipv4_regexb = re.compile(_ipv4_pattern.encode("ascii"))
+_ipv6_regexb = re.compile(_ipv6_pattern.encode("ascii"), flags=re.IGNORECASE)
+
+
+def _is_ip_address(
+    regex: Pattern[str], regexb: Pattern[bytes], host: Optional[Union[str, bytes]]
+) -> bool:
+    if host is None:
+        return False
+    if isinstance(host, str):
+        return bool(regex.match(host))
+    elif isinstance(host, (bytes, bytearray, memoryview)):
+        return bool(regexb.match(host))
+    else:
+        raise TypeError(f"{host} [{type(host)}] is not a str or bytes")
+
+
+is_ipv4_address = functools.partial(_is_ip_address, _ipv4_regex, _ipv4_regexb)
+is_ipv6_address = functools.partial(_is_ip_address, _ipv6_regex, _ipv6_regexb)
+
+
+def is_ip_address(host: Optional[Union[str, bytes, bytearray, memoryview]]) -> bool:
+    return is_ipv4_address(host) or is_ipv6_address(host)
+
+
+_cached_current_datetime: Optional[int] = None
+_cached_formatted_datetime = ""
+
+
+def rfc822_formatted_time() -> str:
+    global _cached_current_datetime
+    global _cached_formatted_datetime
+
+    now = int(time.time())
+    if now != _cached_current_datetime:
+        # Weekday and month names for HTTP date/time formatting;
+        # always English!
+        # Tuples are constants stored in codeobject!
+        _weekdayname = ("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun")
+        _monthname = (
+            "",  # Dummy so we can use 1-based month numbers
+            "Jan",
+            "Feb",
+            "Mar",
+            "Apr",
+            "May",
+            "Jun",
+            "Jul",
+            "Aug",
+            "Sep",
+            "Oct",
+            "Nov",
+            "Dec",
+        )
+
+        year, month, day, hh, mm, ss, wd, *tail = time.gmtime(now)
+        _cached_formatted_datetime = "%s, %02d %3s %4d %02d:%02d:%02d GMT" % (
+            _weekdayname[wd],
+            day,
+            _monthname[month],
+            year,
+            hh,
+            mm,
+            ss,
+        )
+        _cached_current_datetime = now
+    return _cached_formatted_datetime
+
+
+def _weakref_handle(info: "Tuple[weakref.ref[object], str]") -> None:
+    ref, name = info
+    ob = ref()
+    if ob is not None:
+        with suppress(Exception):
+            getattr(ob, name)()
+
+
+def weakref_handle(
+    ob: object,
+    name: str,
+    timeout: float,
+    loop: asyncio.AbstractEventLoop,
+    timeout_ceil_threshold: float = 5,
+) -> Optional[asyncio.TimerHandle]:
+    if timeout is not None and timeout > 0:
+        when = loop.time() + timeout
+        if timeout >= timeout_ceil_threshold:
+            when = ceil(when)
+
+        return loop.call_at(when, _weakref_handle, (weakref.ref(ob), name))
+    return None
+
+
+def call_later(
+    cb: Callable[[], Any],
+    timeout: float,
+    loop: asyncio.AbstractEventLoop,
+    timeout_ceil_threshold: float = 5,
+) -> Optional[asyncio.TimerHandle]:
+    if timeout is not None and timeout > 0:
+        when = loop.time() + timeout
+        if timeout > timeout_ceil_threshold:
+            when = ceil(when)
+        return loop.call_at(when, cb)
+    return None
+
+
+class TimeoutHandle:
+    """Timeout handle"""
+
+    def __init__(
+        self,
+        loop: asyncio.AbstractEventLoop,
+        timeout: Optional[float],
+        ceil_threshold: float = 5,
+    ) -> None:
+        self._timeout = timeout
+        self._loop = loop
+        self._ceil_threshold = ceil_threshold
+        self._callbacks: List[
+            Tuple[Callable[..., None], Tuple[Any, ...], Dict[str, Any]]
+        ] = []
+
+    def register(
+        self, callback: Callable[..., None], *args: Any, **kwargs: Any
+    ) -> None:
+        self._callbacks.append((callback, args, kwargs))
+
+    def close(self) -> None:
+        self._callbacks.clear()
+
+    def start(self) -> Optional[asyncio.Handle]:
+        timeout = self._timeout
+        if timeout is not None and timeout > 0:
+            when = self._loop.time() + timeout
+            if timeout >= self._ceil_threshold:
+                when = ceil(when)
+            return self._loop.call_at(when, self.__call__)
+        else:
+            return None
+
+    def timer(self) -> "BaseTimerContext":
+        if self._timeout is not None and self._timeout > 0:
+            timer = TimerContext(self._loop)
+            self.register(timer.timeout)
+            return timer
+        else:
+            return TimerNoop()
+
+    def __call__(self) -> None:
+        for cb, args, kwargs in self._callbacks:
+            with suppress(Exception):
+                cb(*args, **kwargs)
+
+        self._callbacks.clear()
+
+
+class BaseTimerContext(ContextManager["BaseTimerContext"]):
+    def assert_timeout(self) -> None:
+        """Raise TimeoutError if timeout has been exceeded."""
+
+
+class TimerNoop(BaseTimerContext):
+    def __enter__(self) -> BaseTimerContext:
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        return
+
+
+class TimerContext(BaseTimerContext):
+    """Low resolution timeout context manager"""
+
+    def __init__(self, loop: asyncio.AbstractEventLoop) -> None:
+        self._loop = loop
+        self._tasks: List[asyncio.Task[Any]] = []
+        self._cancelled = False
+
+    def assert_timeout(self) -> None:
+        """Raise TimeoutError if timer has already been cancelled."""
+        if self._cancelled:
+            raise asyncio.TimeoutError from None
+
+    def __enter__(self) -> BaseTimerContext:
+        task = current_task(loop=self._loop)
+
+        if task is None:
+            raise RuntimeError(
+                "Timeout context manager should be used " "inside a task"
+            )
+
+        if self._cancelled:
+            raise asyncio.TimeoutError from None
+
+        self._tasks.append(task)
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> Optional[bool]:
+        if self._tasks:
+            self._tasks.pop()
+
+        if exc_type is asyncio.CancelledError and self._cancelled:
+            raise asyncio.TimeoutError from None
+        return None
+
+    def timeout(self) -> None:
+        if not self._cancelled:
+            for task in set(self._tasks):
+                task.cancel()
+
+            self._cancelled = True
+
+
+def ceil_timeout(
+    delay: Optional[float], ceil_threshold: float = 5
+) -> async_timeout.Timeout:
+    if delay is None or delay <= 0:
+        return async_timeout.timeout(None)
+
+    loop = get_running_loop()
+    now = loop.time()
+    when = now + delay
+    if delay > ceil_threshold:
+        when = ceil(when)
+    return async_timeout.timeout_at(when)
+
+
+class HeadersMixin:
+    ATTRS = frozenset(["_content_type", "_content_dict", "_stored_content_type"])
+
+    _headers: MultiMapping[str]
+
+    _content_type: Optional[str] = None
+    _content_dict: Optional[Dict[str, str]] = None
+    _stored_content_type: Union[str, None, _SENTINEL] = sentinel
+
+    def _parse_content_type(self, raw: Optional[str]) -> None:
+        self._stored_content_type = raw
+        if raw is None:
+            # default value according to RFC 2616
+            self._content_type = "application/octet-stream"
+            self._content_dict = {}
+        else:
+            msg = HeaderParser().parsestr("Content-Type: " + raw)
+            self._content_type = msg.get_content_type()
+            params = msg.get_params(())
+            self._content_dict = dict(params[1:])  # First element is content type again
+
+    @property
+    def content_type(self) -> str:
+        """The value of content part for Content-Type HTTP header."""
+        raw = self._headers.get(hdrs.CONTENT_TYPE)
+        if self._stored_content_type != raw:
+            self._parse_content_type(raw)
+        return self._content_type  # type: ignore[return-value]
+
+    @property
+    def charset(self) -> Optional[str]:
+        """The value of charset part for Content-Type HTTP header."""
+        raw = self._headers.get(hdrs.CONTENT_TYPE)
+        if self._stored_content_type != raw:
+            self._parse_content_type(raw)
+        return self._content_dict.get("charset")  # type: ignore[union-attr]
+
+    @property
+    def content_length(self) -> Optional[int]:
+        """The value of Content-Length HTTP header."""
+        content_length = self._headers.get(hdrs.CONTENT_LENGTH)
+
+        if content_length is not None:
+            return int(content_length)
+        else:
+            return None
+
+
+def set_result(fut: "asyncio.Future[_T]", result: _T) -> None:
+    if not fut.done():
+        fut.set_result(result)
+
+
+_EXC_SENTINEL = BaseException()
+
+
+class ErrorableProtocol(Protocol):
+    def set_exception(
+        self,
+        exc: BaseException,
+        exc_cause: BaseException = ...,
+    ) -> None:
+        ...  # pragma: no cover
+
+
+def set_exception(
+    fut: "asyncio.Future[_T] | ErrorableProtocol",
+    exc: BaseException,
+    exc_cause: BaseException = _EXC_SENTINEL,
+) -> None:
+    """Set future exception.
+
+    If the future is marked as complete, this function is a no-op.
+
+    :param exc_cause: An exception that is a direct cause of ``exc``.
+                      Only set if provided.
+    """
+    if asyncio.isfuture(fut) and fut.done():
+        return
+
+    exc_is_sentinel = exc_cause is _EXC_SENTINEL
+    exc_causes_itself = exc is exc_cause
+    if not exc_is_sentinel and not exc_causes_itself:
+        exc.__cause__ = exc_cause
+
+    fut.set_exception(exc)
+
+
+@functools.total_ordering
+class AppKey(Generic[_T]):
+    """Keys for static typing support in Application."""
+
+    __slots__ = ("_name", "_t", "__orig_class__")
+
+    # This may be set by Python when instantiating with a generic type. We need to
+    # support this, in order to support types that are not concrete classes,
+    # like Iterable, which can't be passed as the second parameter to __init__.
+    __orig_class__: Type[object]
+
+    def __init__(self, name: str, t: Optional[Type[_T]] = None):
+        # Prefix with module name to help deduplicate key names.
+        frame = inspect.currentframe()
+        while frame:
+            if frame.f_code.co_name == "<module>":
+                module: str = frame.f_globals["__name__"]
+                break
+            frame = frame.f_back
+
+        self._name = module + "." + name
+        self._t = t
+
+    def __lt__(self, other: object) -> bool:
+        if isinstance(other, AppKey):
+            return self._name < other._name
+        return True  # Order AppKey above other types.
+
+    def __repr__(self) -> str:
+        t = self._t
+        if t is None:
+            with suppress(AttributeError):
+                # Set to type arg.
+                t = get_args(self.__orig_class__)[0]
+
+        if t is None:
+            t_repr = "<<Unknown>>"
+        elif isinstance(t, type):
+            if t.__module__ == "builtins":
+                t_repr = t.__qualname__
+            else:
+                t_repr = f"{t.__module__}.{t.__qualname__}"
+        else:
+            t_repr = repr(t)
+        return f"<AppKey({self._name}, type={t_repr})>"
+
+
+class ChainMapProxy(Mapping[Union[str, AppKey[Any]], Any]):
+    __slots__ = ("_maps",)
+
+    def __init__(self, maps: Iterable[Mapping[Union[str, AppKey[Any]], Any]]) -> None:
+        self._maps = tuple(maps)
+
+    def __init_subclass__(cls) -> None:
+        raise TypeError(
+            "Inheritance class {} from ChainMapProxy "
+            "is forbidden".format(cls.__name__)
+        )
+
+    @overload  # type: ignore[override]
+    def __getitem__(self, key: AppKey[_T]) -> _T:
+        ...
+
+    @overload
+    def __getitem__(self, key: str) -> Any:
+        ...
+
+    def __getitem__(self, key: Union[str, AppKey[_T]]) -> Any:
+        for mapping in self._maps:
+            try:
+                return mapping[key]
+            except KeyError:
+                pass
+        raise KeyError(key)
+
+    @overload  # type: ignore[override]
+    def get(self, key: AppKey[_T], default: _S) -> Union[_T, _S]:
+        ...
+
+    @overload
+    def get(self, key: AppKey[_T], default: None = ...) -> Optional[_T]:
+        ...
+
+    @overload
+    def get(self, key: str, default: Any = ...) -> Any:
+        ...
+
+    def get(self, key: Union[str, AppKey[_T]], default: Any = None) -> Any:
+        try:
+            return self[key]
+        except KeyError:
+            return default
+
+    def __len__(self) -> int:
+        # reuses stored hash values if possible
+        return len(set().union(*self._maps))
+
+    def __iter__(self) -> Iterator[Union[str, AppKey[Any]]]:
+        d: Dict[Union[str, AppKey[Any]], Any] = {}
+        for mapping in reversed(self._maps):
+            # reuses stored hash values if possible
+            d.update(mapping)
+        return iter(d)
+
+    def __contains__(self, key: object) -> bool:
+        return any(key in m for m in self._maps)
+
+    def __bool__(self) -> bool:
+        return any(self._maps)
+
+    def __repr__(self) -> str:
+        content = ", ".join(map(repr, self._maps))
+        return f"ChainMapProxy({content})"
+
+
+# https://tools.ietf.org/html/rfc7232#section-2.3
+_ETAGC = r"[!\x23-\x7E\x80-\xff]+"
+_ETAGC_RE = re.compile(_ETAGC)
+_QUOTED_ETAG = rf'(W/)?"({_ETAGC})"'
+QUOTED_ETAG_RE = re.compile(_QUOTED_ETAG)
+LIST_QUOTED_ETAG_RE = re.compile(rf"({_QUOTED_ETAG})(?:\s*,\s*|$)|(.)")
+
+ETAG_ANY = "*"
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class ETag:
+    value: str
+    is_weak: bool = False
+
+
+def validate_etag_value(value: str) -> None:
+    if value != ETAG_ANY and not _ETAGC_RE.fullmatch(value):
+        raise ValueError(
+            f"Value {value!r} is not a valid etag. Maybe it contains '\"'?"
+        )
+
+
+def parse_http_date(date_str: Optional[str]) -> Optional[datetime.datetime]:
+    """Process a date string, return a datetime object"""
+    if date_str is not None:
+        timetuple = parsedate(date_str)
+        if timetuple is not None:
+            with suppress(ValueError):
+                return datetime.datetime(*timetuple[:6], tzinfo=datetime.timezone.utc)
+    return None
+
+
+def must_be_empty_body(method: str, code: int) -> bool:
+    """Check if a request must return an empty body."""
+    return (
+        status_code_must_be_empty_body(code)
+        or method_must_be_empty_body(method)
+        or (200 <= code < 300 and method.upper() == hdrs.METH_CONNECT)
+    )
+
+
+def method_must_be_empty_body(method: str) -> bool:
+    """Check if a method must return an empty body."""
+    # https://datatracker.ietf.org/doc/html/rfc9112#section-6.3-2.1
+    # https://datatracker.ietf.org/doc/html/rfc9112#section-6.3-2.2
+    return method.upper() == hdrs.METH_HEAD
+
+
+def status_code_must_be_empty_body(code: int) -> bool:
+    """Check if a status code must return an empty body."""
+    # https://datatracker.ietf.org/doc/html/rfc9112#section-6.3-2.1
+    return code in {204, 304} or 100 <= code < 200
+
+
+def should_remove_content_length(method: str, code: int) -> bool:
+    """Check if a Content-Length header should be removed.
+
+    This should always be a subset of must_be_empty_body
+    """
+    # https://www.rfc-editor.org/rfc/rfc9110.html#section-8.6-8
+    # https://www.rfc-editor.org/rfc/rfc9110.html#section-15.4.5-4
+    return (
+        code in {204, 304}
+        or 100 <= code < 200
+        or (200 <= code < 300 and method.upper() == hdrs.METH_CONNECT)
+    )
diff --git a/llm/Lib/site-packages/aiohttp/http.py b/llm/Lib/site-packages/aiohttp/http.py
new file mode 100644
index 0000000000000000000000000000000000000000..ccc95f568c4ae4f56ffc965f36aa625a98f7ef9c
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/http.py
@@ -0,0 +1,72 @@
+import sys
+from http import HTTPStatus
+from typing import Mapping, Tuple
+
+from . import __version__
+from .http_exceptions import HttpProcessingError as HttpProcessingError
+from .http_parser import (
+    HeadersParser as HeadersParser,
+    HttpParser as HttpParser,
+    HttpRequestParser as HttpRequestParser,
+    HttpResponseParser as HttpResponseParser,
+    RawRequestMessage as RawRequestMessage,
+    RawResponseMessage as RawResponseMessage,
+)
+from .http_websocket import (
+    WS_CLOSED_MESSAGE as WS_CLOSED_MESSAGE,
+    WS_CLOSING_MESSAGE as WS_CLOSING_MESSAGE,
+    WS_KEY as WS_KEY,
+    WebSocketError as WebSocketError,
+    WebSocketReader as WebSocketReader,
+    WebSocketWriter as WebSocketWriter,
+    WSCloseCode as WSCloseCode,
+    WSMessage as WSMessage,
+    WSMsgType as WSMsgType,
+    ws_ext_gen as ws_ext_gen,
+    ws_ext_parse as ws_ext_parse,
+)
+from .http_writer import (
+    HttpVersion as HttpVersion,
+    HttpVersion10 as HttpVersion10,
+    HttpVersion11 as HttpVersion11,
+    StreamWriter as StreamWriter,
+)
+
+__all__ = (
+    "HttpProcessingError",
+    "RESPONSES",
+    "SERVER_SOFTWARE",
+    # .http_writer
+    "StreamWriter",
+    "HttpVersion",
+    "HttpVersion10",
+    "HttpVersion11",
+    # .http_parser
+    "HeadersParser",
+    "HttpParser",
+    "HttpRequestParser",
+    "HttpResponseParser",
+    "RawRequestMessage",
+    "RawResponseMessage",
+    # .http_websocket
+    "WS_CLOSED_MESSAGE",
+    "WS_CLOSING_MESSAGE",
+    "WS_KEY",
+    "WebSocketReader",
+    "WebSocketWriter",
+    "ws_ext_gen",
+    "ws_ext_parse",
+    "WSMessage",
+    "WebSocketError",
+    "WSMsgType",
+    "WSCloseCode",
+)
+
+
+SERVER_SOFTWARE: str = "Python/{0[0]}.{0[1]} aiohttp/{1}".format(
+    sys.version_info, __version__
+)
+
+RESPONSES: Mapping[int, Tuple[str, str]] = {
+    v: (v.phrase, v.description) for v in HTTPStatus.__members__.values()
+}
diff --git a/llm/Lib/site-packages/aiohttp/http_exceptions.py b/llm/Lib/site-packages/aiohttp/http_exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..e8abca29fc22220e30eba52900a44fee9b220b6e
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/http_exceptions.py
@@ -0,0 +1,106 @@
+"""Low-level http related exceptions."""
+
+
+from textwrap import indent
+from typing import Optional, Union
+
+from .typedefs import _CIMultiDict
+
+__all__ = ("HttpProcessingError",)
+
+
+class HttpProcessingError(Exception):
+    """HTTP error.
+
+    Shortcut for raising HTTP errors with custom code, message and headers.
+
+    code: HTTP Error code.
+    message: (optional) Error message.
+    headers: (optional) Headers to be sent in response, a list of pairs
+    """
+
+    code = 0
+    message = ""
+    headers = None
+
+    def __init__(
+        self,
+        *,
+        code: Optional[int] = None,
+        message: str = "",
+        headers: Optional[_CIMultiDict] = None,
+    ) -> None:
+        if code is not None:
+            self.code = code
+        self.headers = headers
+        self.message = message
+
+    def __str__(self) -> str:
+        msg = indent(self.message, "  ")
+        return f"{self.code}, message:\n{msg}"
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__}: {self.code}, message={self.message!r}>"
+
+
+class BadHttpMessage(HttpProcessingError):
+
+    code = 400
+    message = "Bad Request"
+
+    def __init__(self, message: str, *, headers: Optional[_CIMultiDict] = None) -> None:
+        super().__init__(message=message, headers=headers)
+        self.args = (message,)
+
+
+class HttpBadRequest(BadHttpMessage):
+
+    code = 400
+    message = "Bad Request"
+
+
+class PayloadEncodingError(BadHttpMessage):
+    """Base class for payload errors"""
+
+
+class ContentEncodingError(PayloadEncodingError):
+    """Content encoding error."""
+
+
+class TransferEncodingError(PayloadEncodingError):
+    """transfer encoding error."""
+
+
+class ContentLengthError(PayloadEncodingError):
+    """Not enough data for satisfy content length header."""
+
+
+class LineTooLong(BadHttpMessage):
+    def __init__(
+        self, line: str, limit: str = "Unknown", actual_size: str = "Unknown"
+    ) -> None:
+        super().__init__(
+            f"Got more than {limit} bytes ({actual_size}) when reading {line}."
+        )
+        self.args = (line, limit, actual_size)
+
+
+class InvalidHeader(BadHttpMessage):
+    def __init__(self, hdr: Union[bytes, str]) -> None:
+        hdr_s = hdr.decode(errors="backslashreplace") if isinstance(hdr, bytes) else hdr
+        super().__init__(f"Invalid HTTP header: {hdr!r}")
+        self.hdr = hdr_s
+        self.args = (hdr,)
+
+
+class BadStatusLine(BadHttpMessage):
+    def __init__(self, line: str = "", error: Optional[str] = None) -> None:
+        if not isinstance(line, str):
+            line = repr(line)
+        super().__init__(error or f"Bad status line {line!r}")
+        self.args = (line,)
+        self.line = line
+
+
+class InvalidURLError(BadHttpMessage):
+    pass
diff --git a/llm/Lib/site-packages/aiohttp/http_parser.py b/llm/Lib/site-packages/aiohttp/http_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ea7fc3e5447936fb88a202e709cb3c0640ed300
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/http_parser.py
@@ -0,0 +1,1041 @@
+import abc
+import asyncio
+import re
+import string
+from contextlib import suppress
+from enum import IntEnum
+from typing import (
+    Any,
+    ClassVar,
+    Final,
+    Generic,
+    List,
+    Literal,
+    NamedTuple,
+    Optional,
+    Pattern,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+
+from multidict import CIMultiDict, CIMultiDictProxy, istr
+from yarl import URL
+
+from . import hdrs
+from .base_protocol import BaseProtocol
+from .compression_utils import HAS_BROTLI, BrotliDecompressor, ZLibDecompressor
+from .helpers import (
+    _EXC_SENTINEL,
+    DEBUG,
+    NO_EXTENSIONS,
+    BaseTimerContext,
+    method_must_be_empty_body,
+    set_exception,
+    status_code_must_be_empty_body,
+)
+from .http_exceptions import (
+    BadHttpMessage,
+    BadStatusLine,
+    ContentEncodingError,
+    ContentLengthError,
+    InvalidHeader,
+    InvalidURLError,
+    LineTooLong,
+    TransferEncodingError,
+)
+from .http_writer import HttpVersion, HttpVersion10
+from .log import internal_logger
+from .streams import EMPTY_PAYLOAD, StreamReader
+from .typedefs import RawHeaders
+
+__all__ = (
+    "HeadersParser",
+    "HttpParser",
+    "HttpRequestParser",
+    "HttpResponseParser",
+    "RawRequestMessage",
+    "RawResponseMessage",
+)
+
+_SEP = Literal[b"\r\n", b"\n"]
+
+ASCIISET: Final[Set[str]] = set(string.printable)
+
+# See https://www.rfc-editor.org/rfc/rfc9110.html#name-overview
+# and https://www.rfc-editor.org/rfc/rfc9110.html#name-tokens
+#
+#     method = token
+#     tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
+#             "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
+#     token = 1*tchar
+_TCHAR_SPECIALS: Final[str] = re.escape("!#$%&'*+-.^_`|~")
+TOKENRE: Final[Pattern[str]] = re.compile(f"[0-9A-Za-z{_TCHAR_SPECIALS}]+")
+VERSRE: Final[Pattern[str]] = re.compile(r"HTTP/(\d)\.(\d)", re.ASCII)
+DIGITS: Final[Pattern[str]] = re.compile(r"\d+", re.ASCII)
+HEXDIGITS: Final[Pattern[bytes]] = re.compile(rb"[0-9a-fA-F]+")
+
+
+class RawRequestMessage(NamedTuple):
+    method: str
+    path: str
+    version: HttpVersion
+    headers: "CIMultiDictProxy[str]"
+    raw_headers: RawHeaders
+    should_close: bool
+    compression: Optional[str]
+    upgrade: bool
+    chunked: bool
+    url: URL
+
+
+class RawResponseMessage(NamedTuple):
+    version: HttpVersion
+    code: int
+    reason: str
+    headers: CIMultiDictProxy[str]
+    raw_headers: RawHeaders
+    should_close: bool
+    compression: Optional[str]
+    upgrade: bool
+    chunked: bool
+
+
+_MsgT = TypeVar("_MsgT", RawRequestMessage, RawResponseMessage)
+
+
+class ParseState(IntEnum):
+
+    PARSE_NONE = 0
+    PARSE_LENGTH = 1
+    PARSE_CHUNKED = 2
+    PARSE_UNTIL_EOF = 3
+
+
+class ChunkState(IntEnum):
+    PARSE_CHUNKED_SIZE = 0
+    PARSE_CHUNKED_CHUNK = 1
+    PARSE_CHUNKED_CHUNK_EOF = 2
+    PARSE_MAYBE_TRAILERS = 3
+    PARSE_TRAILERS = 4
+
+
+class HeadersParser:
+    def __init__(
+        self,
+        max_line_size: int = 8190,
+        max_headers: int = 32768,
+        max_field_size: int = 8190,
+        lax: bool = False,
+    ) -> None:
+        self.max_line_size = max_line_size
+        self.max_headers = max_headers
+        self.max_field_size = max_field_size
+        self._lax = lax
+
+    def parse_headers(
+        self, lines: List[bytes]
+    ) -> Tuple["CIMultiDictProxy[str]", RawHeaders]:
+        headers: CIMultiDict[str] = CIMultiDict()
+        # note: "raw" does not mean inclusion of OWS before/after the field value
+        raw_headers = []
+
+        lines_idx = 1
+        line = lines[1]
+        line_count = len(lines)
+
+        while line:
+            # Parse initial header name : value pair.
+            try:
+                bname, bvalue = line.split(b":", 1)
+            except ValueError:
+                raise InvalidHeader(line) from None
+
+            if len(bname) == 0:
+                raise InvalidHeader(bname)
+
+            # https://www.rfc-editor.org/rfc/rfc9112.html#section-5.1-2
+            if {bname[0], bname[-1]} & {32, 9}:  # {" ", "\t"}
+                raise InvalidHeader(line)
+
+            bvalue = bvalue.lstrip(b" \t")
+            if len(bname) > self.max_field_size:
+                raise LineTooLong(
+                    "request header name {}".format(
+                        bname.decode("utf8", "backslashreplace")
+                    ),
+                    str(self.max_field_size),
+                    str(len(bname)),
+                )
+            name = bname.decode("utf-8", "surrogateescape")
+            if not TOKENRE.fullmatch(name):
+                raise InvalidHeader(bname)
+
+            header_length = len(bvalue)
+
+            # next line
+            lines_idx += 1
+            line = lines[lines_idx]
+
+            # consume continuation lines
+            continuation = self._lax and line and line[0] in (32, 9)  # (' ', '\t')
+
+            # Deprecated: https://www.rfc-editor.org/rfc/rfc9112.html#name-obsolete-line-folding
+            if continuation:
+                bvalue_lst = [bvalue]
+                while continuation:
+                    header_length += len(line)
+                    if header_length > self.max_field_size:
+                        raise LineTooLong(
+                            "request header field {}".format(
+                                bname.decode("utf8", "backslashreplace")
+                            ),
+                            str(self.max_field_size),
+                            str(header_length),
+                        )
+                    bvalue_lst.append(line)
+
+                    # next line
+                    lines_idx += 1
+                    if lines_idx < line_count:
+                        line = lines[lines_idx]
+                        if line:
+                            continuation = line[0] in (32, 9)  # (' ', '\t')
+                    else:
+                        line = b""
+                        break
+                bvalue = b"".join(bvalue_lst)
+            else:
+                if header_length > self.max_field_size:
+                    raise LineTooLong(
+                        "request header field {}".format(
+                            bname.decode("utf8", "backslashreplace")
+                        ),
+                        str(self.max_field_size),
+                        str(header_length),
+                    )
+
+            bvalue = bvalue.strip(b" \t")
+            value = bvalue.decode("utf-8", "surrogateescape")
+
+            # https://www.rfc-editor.org/rfc/rfc9110.html#section-5.5-5
+            if "\n" in value or "\r" in value or "\x00" in value:
+                raise InvalidHeader(bvalue)
+
+            headers.add(name, value)
+            raw_headers.append((bname, bvalue))
+
+        return (CIMultiDictProxy(headers), tuple(raw_headers))
+
+
+def _is_supported_upgrade(headers: CIMultiDictProxy[str]) -> bool:
+    """Check if the upgrade header is supported."""
+    return headers.get(hdrs.UPGRADE, "").lower() in {"tcp", "websocket"}
+
+
+class HttpParser(abc.ABC, Generic[_MsgT]):
+    lax: ClassVar[bool] = False
+
+    def __init__(
+        self,
+        protocol: Optional[BaseProtocol] = None,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        limit: int = 2**16,
+        max_line_size: int = 8190,
+        max_headers: int = 32768,
+        max_field_size: int = 8190,
+        timer: Optional[BaseTimerContext] = None,
+        code: Optional[int] = None,
+        method: Optional[str] = None,
+        readall: bool = False,
+        payload_exception: Optional[Type[BaseException]] = None,
+        response_with_body: bool = True,
+        read_until_eof: bool = False,
+        auto_decompress: bool = True,
+    ) -> None:
+        self.protocol = protocol
+        self.loop = loop
+        self.max_line_size = max_line_size
+        self.max_headers = max_headers
+        self.max_field_size = max_field_size
+        self.timer = timer
+        self.code = code
+        self.method = method
+        self.readall = readall
+        self.payload_exception = payload_exception
+        self.response_with_body = response_with_body
+        self.read_until_eof = read_until_eof
+
+        self._lines: List[bytes] = []
+        self._tail = b""
+        self._upgraded = False
+        self._payload = None
+        self._payload_parser: Optional[HttpPayloadParser] = None
+        self._auto_decompress = auto_decompress
+        self._limit = limit
+        self._headers_parser = HeadersParser(
+            max_line_size, max_headers, max_field_size, self.lax
+        )
+
+    @abc.abstractmethod
+    def parse_message(self, lines: List[bytes]) -> _MsgT:
+        pass
+
+    def feed_eof(self) -> Optional[_MsgT]:
+        if self._payload_parser is not None:
+            self._payload_parser.feed_eof()
+            self._payload_parser = None
+        else:
+            # try to extract partial message
+            if self._tail:
+                self._lines.append(self._tail)
+
+            if self._lines:
+                if self._lines[-1] != "\r\n":
+                    self._lines.append(b"")
+                with suppress(Exception):
+                    return self.parse_message(self._lines)
+        return None
+
+    def feed_data(
+        self,
+        data: bytes,
+        SEP: _SEP = b"\r\n",
+        EMPTY: bytes = b"",
+        CONTENT_LENGTH: istr = hdrs.CONTENT_LENGTH,
+        METH_CONNECT: str = hdrs.METH_CONNECT,
+        SEC_WEBSOCKET_KEY1: istr = hdrs.SEC_WEBSOCKET_KEY1,
+    ) -> Tuple[List[Tuple[_MsgT, StreamReader]], bool, bytes]:
+
+        messages = []
+
+        if self._tail:
+            data, self._tail = self._tail + data, b""
+
+        data_len = len(data)
+        start_pos = 0
+        loop = self.loop
+
+        while start_pos < data_len:
+
+            # read HTTP message (request/response line + headers), \r\n\r\n
+            # and split by lines
+            if self._payload_parser is None and not self._upgraded:
+                pos = data.find(SEP, start_pos)
+                # consume \r\n
+                if pos == start_pos and not self._lines:
+                    start_pos = pos + len(SEP)
+                    continue
+
+                if pos >= start_pos:
+                    # line found
+                    line = data[start_pos:pos]
+                    if SEP == b"\n":  # For lax response parsing
+                        line = line.rstrip(b"\r")
+                    self._lines.append(line)
+                    start_pos = pos + len(SEP)
+
+                    # \r\n\r\n found
+                    if self._lines[-1] == EMPTY:
+                        try:
+                            msg: _MsgT = self.parse_message(self._lines)
+                        finally:
+                            self._lines.clear()
+
+                        def get_content_length() -> Optional[int]:
+                            # payload length
+                            length_hdr = msg.headers.get(CONTENT_LENGTH)
+                            if length_hdr is None:
+                                return None
+
+                            # Shouldn't allow +/- or other number formats.
+                            # https://www.rfc-editor.org/rfc/rfc9110#section-8.6-2
+                            # msg.headers is already stripped of leading/trailing wsp
+                            if not DIGITS.fullmatch(length_hdr):
+                                raise InvalidHeader(CONTENT_LENGTH)
+
+                            return int(length_hdr)
+
+                        length = get_content_length()
+                        # do not support old websocket spec
+                        if SEC_WEBSOCKET_KEY1 in msg.headers:
+                            raise InvalidHeader(SEC_WEBSOCKET_KEY1)
+
+                        self._upgraded = msg.upgrade and _is_supported_upgrade(
+                            msg.headers
+                        )
+
+                        method = getattr(msg, "method", self.method)
+                        # code is only present on responses
+                        code = getattr(msg, "code", 0)
+
+                        assert self.protocol is not None
+                        # calculate payload
+                        empty_body = status_code_must_be_empty_body(code) or bool(
+                            method and method_must_be_empty_body(method)
+                        )
+                        if not empty_body and (
+                            ((length is not None and length > 0) or msg.chunked)
+                            and not self._upgraded
+                        ):
+                            payload = StreamReader(
+                                self.protocol,
+                                timer=self.timer,
+                                loop=loop,
+                                limit=self._limit,
+                            )
+                            payload_parser = HttpPayloadParser(
+                                payload,
+                                length=length,
+                                chunked=msg.chunked,
+                                method=method,
+                                compression=msg.compression,
+                                code=self.code,
+                                readall=self.readall,
+                                response_with_body=self.response_with_body,
+                                auto_decompress=self._auto_decompress,
+                                lax=self.lax,
+                            )
+                            if not payload_parser.done:
+                                self._payload_parser = payload_parser
+                        elif method == METH_CONNECT:
+                            assert isinstance(msg, RawRequestMessage)
+                            payload = StreamReader(
+                                self.protocol,
+                                timer=self.timer,
+                                loop=loop,
+                                limit=self._limit,
+                            )
+                            self._upgraded = True
+                            self._payload_parser = HttpPayloadParser(
+                                payload,
+                                method=msg.method,
+                                compression=msg.compression,
+                                readall=True,
+                                auto_decompress=self._auto_decompress,
+                                lax=self.lax,
+                            )
+                        elif not empty_body and length is None and self.read_until_eof:
+                            payload = StreamReader(
+                                self.protocol,
+                                timer=self.timer,
+                                loop=loop,
+                                limit=self._limit,
+                            )
+                            payload_parser = HttpPayloadParser(
+                                payload,
+                                length=length,
+                                chunked=msg.chunked,
+                                method=method,
+                                compression=msg.compression,
+                                code=self.code,
+                                readall=True,
+                                response_with_body=self.response_with_body,
+                                auto_decompress=self._auto_decompress,
+                                lax=self.lax,
+                            )
+                            if not payload_parser.done:
+                                self._payload_parser = payload_parser
+                        else:
+                            payload = EMPTY_PAYLOAD
+
+                        messages.append((msg, payload))
+                else:
+                    self._tail = data[start_pos:]
+                    data = EMPTY
+                    break
+
+            # no parser, just store
+            elif self._payload_parser is None and self._upgraded:
+                assert not self._lines
+                break
+
+            # feed payload
+            elif data and start_pos < data_len:
+                assert not self._lines
+                assert self._payload_parser is not None
+                try:
+                    eof, data = self._payload_parser.feed_data(data[start_pos:], SEP)
+                except BaseException as underlying_exc:
+                    reraised_exc = underlying_exc
+                    if self.payload_exception is not None:
+                        reraised_exc = self.payload_exception(str(underlying_exc))
+
+                    set_exception(
+                        self._payload_parser.payload,
+                        reraised_exc,
+                        underlying_exc,
+                    )
+
+                    eof = True
+                    data = b""
+
+                if eof:
+                    start_pos = 0
+                    data_len = len(data)
+                    self._payload_parser = None
+                    continue
+            else:
+                break
+
+        if data and start_pos < data_len:
+            data = data[start_pos:]
+        else:
+            data = EMPTY
+
+        return messages, self._upgraded, data
+
+    def parse_headers(
+        self, lines: List[bytes]
+    ) -> Tuple[
+        "CIMultiDictProxy[str]", RawHeaders, Optional[bool], Optional[str], bool, bool
+    ]:
+        """Parses RFC 5322 headers from a stream.
+
+        Line continuations are supported. Returns list of header name
+        and value pairs. Header name is in upper case.
+        """
+        headers, raw_headers = self._headers_parser.parse_headers(lines)
+        close_conn = None
+        encoding = None
+        upgrade = False
+        chunked = False
+
+        # https://www.rfc-editor.org/rfc/rfc9110.html#section-5.5-6
+        # https://www.rfc-editor.org/rfc/rfc9110.html#name-collected-abnf
+        singletons = (
+            hdrs.CONTENT_LENGTH,
+            hdrs.CONTENT_LOCATION,
+            hdrs.CONTENT_RANGE,
+            hdrs.CONTENT_TYPE,
+            hdrs.ETAG,
+            hdrs.HOST,
+            hdrs.MAX_FORWARDS,
+            hdrs.SERVER,
+            hdrs.TRANSFER_ENCODING,
+            hdrs.USER_AGENT,
+        )
+        bad_hdr = next((h for h in singletons if len(headers.getall(h, ())) > 1), None)
+        if bad_hdr is not None:
+            raise BadHttpMessage(f"Duplicate '{bad_hdr}' header found.")
+
+        # keep-alive
+        conn = headers.get(hdrs.CONNECTION)
+        if conn:
+            v = conn.lower()
+            if v == "close":
+                close_conn = True
+            elif v == "keep-alive":
+                close_conn = False
+            # https://www.rfc-editor.org/rfc/rfc9110.html#name-101-switching-protocols
+            elif v == "upgrade" and headers.get(hdrs.UPGRADE):
+                upgrade = True
+
+        # encoding
+        enc = headers.get(hdrs.CONTENT_ENCODING)
+        if enc:
+            enc = enc.lower()
+            if enc in ("gzip", "deflate", "br"):
+                encoding = enc
+
+        # chunking
+        te = headers.get(hdrs.TRANSFER_ENCODING)
+        if te is not None:
+            if "chunked" == te.lower():
+                chunked = True
+            else:
+                raise BadHttpMessage("Request has invalid `Transfer-Encoding`")
+
+            if hdrs.CONTENT_LENGTH in headers:
+                raise BadHttpMessage(
+                    "Transfer-Encoding can't be present with Content-Length",
+                )
+
+        return (headers, raw_headers, close_conn, encoding, upgrade, chunked)
+
+    def set_upgraded(self, val: bool) -> None:
+        """Set connection upgraded (to websocket) mode.
+
+        :param bool val: new state.
+        """
+        self._upgraded = val
+
+
+class HttpRequestParser(HttpParser[RawRequestMessage]):
+    """Read request status line.
+
+    Exception .http_exceptions.BadStatusLine
+    could be raised in case of any errors in status line.
+    Returns RawRequestMessage.
+    """
+
+    def parse_message(self, lines: List[bytes]) -> RawRequestMessage:
+        # request line
+        line = lines[0].decode("utf-8", "surrogateescape")
+        try:
+            method, path, version = line.split(" ", maxsplit=2)
+        except ValueError:
+            raise BadStatusLine(line) from None
+
+        if len(path) > self.max_line_size:
+            raise LineTooLong(
+                "Status line is too long", str(self.max_line_size), str(len(path))
+            )
+
+        # method
+        if not TOKENRE.fullmatch(method):
+            raise BadStatusLine(method)
+
+        # version
+        match = VERSRE.fullmatch(version)
+        if match is None:
+            raise BadStatusLine(line)
+        version_o = HttpVersion(int(match.group(1)), int(match.group(2)))
+
+        if method == "CONNECT":
+            # authority-form,
+            # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.3
+            url = URL.build(authority=path, encoded=True)
+        elif path.startswith("/"):
+            # origin-form,
+            # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.1
+            path_part, _hash_separator, url_fragment = path.partition("#")
+            path_part, _question_mark_separator, qs_part = path_part.partition("?")
+
+            # NOTE: `yarl.URL.build()` is used to mimic what the Cython-based
+            # NOTE: parser does, otherwise it results into the same
+            # NOTE: HTTP Request-Line input producing different
+            # NOTE: `yarl.URL()` objects
+            url = URL.build(
+                path=path_part,
+                query_string=qs_part,
+                fragment=url_fragment,
+                encoded=True,
+            )
+        elif path == "*" and method == "OPTIONS":
+            # asterisk-form,
+            url = URL(path, encoded=True)
+        else:
+            # absolute-form for proxy maybe,
+            # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.2
+            url = URL(path, encoded=True)
+            if url.scheme == "":
+                # not absolute-form
+                raise InvalidURLError(
+                    path.encode(errors="surrogateescape").decode("latin1")
+                )
+
+        # read headers
+        (
+            headers,
+            raw_headers,
+            close,
+            compression,
+            upgrade,
+            chunked,
+        ) = self.parse_headers(lines)
+
+        if close is None:  # then the headers weren't set in the request
+            if version_o <= HttpVersion10:  # HTTP 1.0 must asks to not close
+                close = True
+            else:  # HTTP 1.1 must ask to close.
+                close = False
+
+        return RawRequestMessage(
+            method,
+            path,
+            version_o,
+            headers,
+            raw_headers,
+            close,
+            compression,
+            upgrade,
+            chunked,
+            url,
+        )
+
+
+class HttpResponseParser(HttpParser[RawResponseMessage]):
+    """Read response status line and headers.
+
+    BadStatusLine could be raised in case of any errors in status line.
+    Returns RawResponseMessage.
+    """
+
+    # Lax mode should only be enabled on response parser.
+    lax = not DEBUG
+
+    def feed_data(
+        self,
+        data: bytes,
+        SEP: Optional[_SEP] = None,
+        *args: Any,
+        **kwargs: Any,
+    ) -> Tuple[List[Tuple[RawResponseMessage, StreamReader]], bool, bytes]:
+        if SEP is None:
+            SEP = b"\r\n" if DEBUG else b"\n"
+        return super().feed_data(data, SEP, *args, **kwargs)
+
+    def parse_message(self, lines: List[bytes]) -> RawResponseMessage:
+        line = lines[0].decode("utf-8", "surrogateescape")
+        try:
+            version, status = line.split(maxsplit=1)
+        except ValueError:
+            raise BadStatusLine(line) from None
+
+        try:
+            status, reason = status.split(maxsplit=1)
+        except ValueError:
+            status = status.strip()
+            reason = ""
+
+        if len(reason) > self.max_line_size:
+            raise LineTooLong(
+                "Status line is too long", str(self.max_line_size), str(len(reason))
+            )
+
+        # version
+        match = VERSRE.fullmatch(version)
+        if match is None:
+            raise BadStatusLine(line)
+        version_o = HttpVersion(int(match.group(1)), int(match.group(2)))
+
+        # The status code is a three-digit ASCII number, no padding
+        if len(status) != 3 or not DIGITS.fullmatch(status):
+            raise BadStatusLine(line)
+        status_i = int(status)
+
+        # read headers
+        (
+            headers,
+            raw_headers,
+            close,
+            compression,
+            upgrade,
+            chunked,
+        ) = self.parse_headers(lines)
+
+        if close is None:
+            if version_o <= HttpVersion10:
+                close = True
+            # https://www.rfc-editor.org/rfc/rfc9112.html#name-message-body-length
+            elif 100 <= status_i < 200 or status_i in {204, 304}:
+                close = False
+            elif hdrs.CONTENT_LENGTH in headers or hdrs.TRANSFER_ENCODING in headers:
+                close = False
+            else:
+                # https://www.rfc-editor.org/rfc/rfc9112.html#section-6.3-2.8
+                close = True
+
+        return RawResponseMessage(
+            version_o,
+            status_i,
+            reason.strip(),
+            headers,
+            raw_headers,
+            close,
+            compression,
+            upgrade,
+            chunked,
+        )
+
+
+class HttpPayloadParser:
+    def __init__(
+        self,
+        payload: StreamReader,
+        length: Optional[int] = None,
+        chunked: bool = False,
+        compression: Optional[str] = None,
+        code: Optional[int] = None,
+        method: Optional[str] = None,
+        readall: bool = False,
+        response_with_body: bool = True,
+        auto_decompress: bool = True,
+        lax: bool = False,
+    ) -> None:
+        self._length = 0
+        self._type = ParseState.PARSE_NONE
+        self._chunk = ChunkState.PARSE_CHUNKED_SIZE
+        self._chunk_size = 0
+        self._chunk_tail = b""
+        self._auto_decompress = auto_decompress
+        self._lax = lax
+        self.done = False
+
+        # payload decompression wrapper
+        if response_with_body and compression and self._auto_decompress:
+            real_payload: Union[StreamReader, DeflateBuffer] = DeflateBuffer(
+                payload, compression
+            )
+        else:
+            real_payload = payload
+
+        # payload parser
+        if not response_with_body:
+            # don't parse payload if it's not expected to be received
+            self._type = ParseState.PARSE_NONE
+            real_payload.feed_eof()
+            self.done = True
+
+        elif chunked:
+            self._type = ParseState.PARSE_CHUNKED
+        elif length is not None:
+            self._type = ParseState.PARSE_LENGTH
+            self._length = length
+            if self._length == 0:
+                real_payload.feed_eof()
+                self.done = True
+        else:
+            if readall and code != 204:
+                self._type = ParseState.PARSE_UNTIL_EOF
+            elif method in ("PUT", "POST"):
+                internal_logger.warning(  # pragma: no cover
+                    "Content-Length or Transfer-Encoding header is required"
+                )
+                self._type = ParseState.PARSE_NONE
+                real_payload.feed_eof()
+                self.done = True
+
+        self.payload = real_payload
+
+    def feed_eof(self) -> None:
+        if self._type == ParseState.PARSE_UNTIL_EOF:
+            self.payload.feed_eof()
+        elif self._type == ParseState.PARSE_LENGTH:
+            raise ContentLengthError(
+                "Not enough data for satisfy content length header."
+            )
+        elif self._type == ParseState.PARSE_CHUNKED:
+            raise TransferEncodingError(
+                "Not enough data for satisfy transfer length header."
+            )
+
+    def feed_data(
+        self, chunk: bytes, SEP: _SEP = b"\r\n", CHUNK_EXT: bytes = b";"
+    ) -> Tuple[bool, bytes]:
+        # Read specified amount of bytes
+        if self._type == ParseState.PARSE_LENGTH:
+            required = self._length
+            chunk_len = len(chunk)
+
+            if required >= chunk_len:
+                self._length = required - chunk_len
+                self.payload.feed_data(chunk, chunk_len)
+                if self._length == 0:
+                    self.payload.feed_eof()
+                    return True, b""
+            else:
+                self._length = 0
+                self.payload.feed_data(chunk[:required], required)
+                self.payload.feed_eof()
+                return True, chunk[required:]
+
+        # Chunked transfer encoding parser
+        elif self._type == ParseState.PARSE_CHUNKED:
+            if self._chunk_tail:
+                chunk = self._chunk_tail + chunk
+                self._chunk_tail = b""
+
+            while chunk:
+
+                # read next chunk size
+                if self._chunk == ChunkState.PARSE_CHUNKED_SIZE:
+                    pos = chunk.find(SEP)
+                    if pos >= 0:
+                        i = chunk.find(CHUNK_EXT, 0, pos)
+                        if i >= 0:
+                            size_b = chunk[:i]  # strip chunk-extensions
+                        else:
+                            size_b = chunk[:pos]
+
+                        if self._lax:  # Allow whitespace in lax mode.
+                            size_b = size_b.strip()
+
+                        if not re.fullmatch(HEXDIGITS, size_b):
+                            exc = TransferEncodingError(
+                                chunk[:pos].decode("ascii", "surrogateescape")
+                            )
+                            set_exception(self.payload, exc)
+                            raise exc
+                        size = int(bytes(size_b), 16)
+
+                        chunk = chunk[pos + len(SEP) :]
+                        if size == 0:  # eof marker
+                            self._chunk = ChunkState.PARSE_MAYBE_TRAILERS
+                            if self._lax and chunk.startswith(b"\r"):
+                                chunk = chunk[1:]
+                        else:
+                            self._chunk = ChunkState.PARSE_CHUNKED_CHUNK
+                            self._chunk_size = size
+                            self.payload.begin_http_chunk_receiving()
+                    else:
+                        self._chunk_tail = chunk
+                        return False, b""
+
+                # read chunk and feed buffer
+                if self._chunk == ChunkState.PARSE_CHUNKED_CHUNK:
+                    required = self._chunk_size
+                    chunk_len = len(chunk)
+
+                    if required > chunk_len:
+                        self._chunk_size = required - chunk_len
+                        self.payload.feed_data(chunk, chunk_len)
+                        return False, b""
+                    else:
+                        self._chunk_size = 0
+                        self.payload.feed_data(chunk[:required], required)
+                        chunk = chunk[required:]
+                        if self._lax and chunk.startswith(b"\r"):
+                            chunk = chunk[1:]
+                        self._chunk = ChunkState.PARSE_CHUNKED_CHUNK_EOF
+                        self.payload.end_http_chunk_receiving()
+
+                # toss the CRLF at the end of the chunk
+                if self._chunk == ChunkState.PARSE_CHUNKED_CHUNK_EOF:
+                    if chunk[: len(SEP)] == SEP:
+                        chunk = chunk[len(SEP) :]
+                        self._chunk = ChunkState.PARSE_CHUNKED_SIZE
+                    else:
+                        self._chunk_tail = chunk
+                        return False, b""
+
+                # if stream does not contain trailer, after 0\r\n
+                # we should get another \r\n otherwise
+                # trailers needs to be skipped until \r\n\r\n
+                if self._chunk == ChunkState.PARSE_MAYBE_TRAILERS:
+                    head = chunk[: len(SEP)]
+                    if head == SEP:
+                        # end of stream
+                        self.payload.feed_eof()
+                        return True, chunk[len(SEP) :]
+                    # Both CR and LF, or only LF may not be received yet. It is
+                    # expected that CRLF or LF will be shown at the very first
+                    # byte next time, otherwise trailers should come. The last
+                    # CRLF which marks the end of response might not be
+                    # contained in the same TCP segment which delivered the
+                    # size indicator.
+                    if not head:
+                        return False, b""
+                    if head == SEP[:1]:
+                        self._chunk_tail = head
+                        return False, b""
+                    self._chunk = ChunkState.PARSE_TRAILERS
+
+                # read and discard trailer up to the CRLF terminator
+                if self._chunk == ChunkState.PARSE_TRAILERS:
+                    pos = chunk.find(SEP)
+                    if pos >= 0:
+                        chunk = chunk[pos + len(SEP) :]
+                        self._chunk = ChunkState.PARSE_MAYBE_TRAILERS
+                    else:
+                        self._chunk_tail = chunk
+                        return False, b""
+
+        # Read all bytes until eof
+        elif self._type == ParseState.PARSE_UNTIL_EOF:
+            self.payload.feed_data(chunk, len(chunk))
+
+        return False, b""
+
+
+class DeflateBuffer:
+    """DeflateStream decompress stream and feed data into specified stream."""
+
+    decompressor: Any
+
+    def __init__(self, out: StreamReader, encoding: Optional[str]) -> None:
+        self.out = out
+        self.size = 0
+        self.encoding = encoding
+        self._started_decoding = False
+
+        self.decompressor: Union[BrotliDecompressor, ZLibDecompressor]
+        if encoding == "br":
+            if not HAS_BROTLI:  # pragma: no cover
+                raise ContentEncodingError(
+                    "Can not decode content-encoding: brotli (br). "
+                    "Please install `Brotli`"
+                )
+            self.decompressor = BrotliDecompressor()
+        else:
+            self.decompressor = ZLibDecompressor(encoding=encoding)
+
+    def set_exception(
+        self,
+        exc: BaseException,
+        exc_cause: BaseException = _EXC_SENTINEL,
+    ) -> None:
+        set_exception(self.out, exc, exc_cause)
+
+    def feed_data(self, chunk: bytes, size: int) -> None:
+        if not size:
+            return
+
+        self.size += size
+
+        # RFC1950
+        # bits 0..3 = CM = 0b1000 = 8 = "deflate"
+        # bits 4..7 = CINFO = 1..7 = windows size.
+        if (
+            not self._started_decoding
+            and self.encoding == "deflate"
+            and chunk[0] & 0xF != 8
+        ):
+            # Change the decoder to decompress incorrectly compressed data
+            # Actually we should issue a warning about non-RFC-compliant data.
+            self.decompressor = ZLibDecompressor(
+                encoding=self.encoding, suppress_deflate_header=True
+            )
+
+        try:
+            chunk = self.decompressor.decompress_sync(chunk)
+        except Exception:
+            raise ContentEncodingError(
+                "Can not decode content-encoding: %s" % self.encoding
+            )
+
+        self._started_decoding = True
+
+        if chunk:
+            self.out.feed_data(chunk, len(chunk))
+
+    def feed_eof(self) -> None:
+        chunk = self.decompressor.flush()
+
+        if chunk or self.size > 0:
+            self.out.feed_data(chunk, len(chunk))
+            if self.encoding == "deflate" and not self.decompressor.eof:
+                raise ContentEncodingError("deflate")
+
+        self.out.feed_eof()
+
+    def begin_http_chunk_receiving(self) -> None:
+        self.out.begin_http_chunk_receiving()
+
+    def end_http_chunk_receiving(self) -> None:
+        self.out.end_http_chunk_receiving()
+
+
+HttpRequestParserPy = HttpRequestParser
+HttpResponseParserPy = HttpResponseParser
+RawRequestMessagePy = RawRequestMessage
+RawResponseMessagePy = RawResponseMessage
+
+try:
+    if not NO_EXTENSIONS:
+        from ._http_parser import (  # type: ignore[import-not-found,no-redef]
+            HttpRequestParser,
+            HttpResponseParser,
+            RawRequestMessage,
+            RawResponseMessage,
+        )
+
+        HttpRequestParserC = HttpRequestParser
+        HttpResponseParserC = HttpResponseParser
+        RawRequestMessageC = RawRequestMessage
+        RawResponseMessageC = RawResponseMessage
+except ImportError:  # pragma: no cover
+    pass
diff --git a/llm/Lib/site-packages/aiohttp/http_websocket.py b/llm/Lib/site-packages/aiohttp/http_websocket.py
new file mode 100644
index 0000000000000000000000000000000000000000..b4524c0f1fef8ff62e43051e85e6060237b57030
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/http_websocket.py
@@ -0,0 +1,740 @@
+"""WebSocket protocol versions 13 and 8."""
+
+import asyncio
+import functools
+import json
+import random
+import re
+import sys
+import zlib
+from enum import IntEnum
+from struct import Struct
+from typing import (
+    Any,
+    Callable,
+    Final,
+    List,
+    NamedTuple,
+    Optional,
+    Pattern,
+    Set,
+    Tuple,
+    Union,
+    cast,
+)
+
+from .base_protocol import BaseProtocol
+from .compression_utils import ZLibCompressor, ZLibDecompressor
+from .helpers import NO_EXTENSIONS, set_exception
+from .streams import DataQueue
+
+__all__ = (
+    "WS_CLOSED_MESSAGE",
+    "WS_CLOSING_MESSAGE",
+    "WS_KEY",
+    "WebSocketReader",
+    "WebSocketWriter",
+    "WSMessage",
+    "WebSocketError",
+    "WSMsgType",
+    "WSCloseCode",
+)
+
+
+class WSCloseCode(IntEnum):
+    OK = 1000
+    GOING_AWAY = 1001
+    PROTOCOL_ERROR = 1002
+    UNSUPPORTED_DATA = 1003
+    ABNORMAL_CLOSURE = 1006
+    INVALID_TEXT = 1007
+    POLICY_VIOLATION = 1008
+    MESSAGE_TOO_BIG = 1009
+    MANDATORY_EXTENSION = 1010
+    INTERNAL_ERROR = 1011
+    SERVICE_RESTART = 1012
+    TRY_AGAIN_LATER = 1013
+    BAD_GATEWAY = 1014
+
+
+ALLOWED_CLOSE_CODES: Final[Set[int]] = {int(i) for i in WSCloseCode}
+
+# For websockets, keeping latency low is extremely important as implementations
+# generally expect to be able to send and receive messages quickly.  We use a
+# larger chunk size than the default to reduce the number of executor calls
+# since the executor is a significant source of latency and overhead when
+# the chunks are small. A size of 5KiB was chosen because it is also the
+# same value python-zlib-ng choose to use as the threshold to release the GIL.
+
+WEBSOCKET_MAX_SYNC_CHUNK_SIZE = 5 * 1024
+
+
+class WSMsgType(IntEnum):
+    # websocket spec types
+    CONTINUATION = 0x0
+    TEXT = 0x1
+    BINARY = 0x2
+    PING = 0x9
+    PONG = 0xA
+    CLOSE = 0x8
+
+    # aiohttp specific types
+    CLOSING = 0x100
+    CLOSED = 0x101
+    ERROR = 0x102
+
+    text = TEXT
+    binary = BINARY
+    ping = PING
+    pong = PONG
+    close = CLOSE
+    closing = CLOSING
+    closed = CLOSED
+    error = ERROR
+
+
+WS_KEY: Final[bytes] = b"258EAFA5-E914-47DA-95CA-C5AB0DC85B11"
+
+
+UNPACK_LEN2 = Struct("!H").unpack_from
+UNPACK_LEN3 = Struct("!Q").unpack_from
+UNPACK_CLOSE_CODE = Struct("!H").unpack
+PACK_LEN1 = Struct("!BB").pack
+PACK_LEN2 = Struct("!BBH").pack
+PACK_LEN3 = Struct("!BBQ").pack
+PACK_CLOSE_CODE = Struct("!H").pack
+MSG_SIZE: Final[int] = 2**14
+DEFAULT_LIMIT: Final[int] = 2**16
+
+
+class WSMessage(NamedTuple):
+    type: WSMsgType
+    # To type correctly, this would need some kind of tagged union for each type.
+    data: Any
+    extra: Optional[str]
+
+    def json(self, *, loads: Callable[[Any], Any] = json.loads) -> Any:
+        """Return parsed JSON data.
+
+        .. versionadded:: 0.22
+        """
+        return loads(self.data)
+
+
+WS_CLOSED_MESSAGE = WSMessage(WSMsgType.CLOSED, None, None)
+WS_CLOSING_MESSAGE = WSMessage(WSMsgType.CLOSING, None, None)
+
+
+class WebSocketError(Exception):
+    """WebSocket protocol parser error."""
+
+    def __init__(self, code: int, message: str) -> None:
+        self.code = code
+        super().__init__(code, message)
+
+    def __str__(self) -> str:
+        return cast(str, self.args[1])
+
+
+class WSHandshakeError(Exception):
+    """WebSocket protocol handshake error."""
+
+
+native_byteorder: Final[str] = sys.byteorder
+
+
+# Used by _websocket_mask_python
+@functools.lru_cache
+def _xor_table() -> List[bytes]:
+    return [bytes(a ^ b for a in range(256)) for b in range(256)]
+
+
+def _websocket_mask_python(mask: bytes, data: bytearray) -> None:
+    """Websocket masking function.
+
+    `mask` is a `bytes` object of length 4; `data` is a `bytearray`
+    object of any length. The contents of `data` are masked with `mask`,
+    as specified in section 5.3 of RFC 6455.
+
+    Note that this function mutates the `data` argument.
+
+    This pure-python implementation may be replaced by an optimized
+    version when available.
+
+    """
+    assert isinstance(data, bytearray), data
+    assert len(mask) == 4, mask
+
+    if data:
+        _XOR_TABLE = _xor_table()
+        a, b, c, d = (_XOR_TABLE[n] for n in mask)
+        data[::4] = data[::4].translate(a)
+        data[1::4] = data[1::4].translate(b)
+        data[2::4] = data[2::4].translate(c)
+        data[3::4] = data[3::4].translate(d)
+
+
+if NO_EXTENSIONS:  # pragma: no cover
+    _websocket_mask = _websocket_mask_python
+else:
+    try:
+        from ._websocket import _websocket_mask_cython  # type: ignore[import-not-found]
+
+        _websocket_mask = _websocket_mask_cython
+    except ImportError:  # pragma: no cover
+        _websocket_mask = _websocket_mask_python
+
+_WS_DEFLATE_TRAILING: Final[bytes] = bytes([0x00, 0x00, 0xFF, 0xFF])
+
+
+_WS_EXT_RE: Final[Pattern[str]] = re.compile(
+    r"^(?:;\s*(?:"
+    r"(server_no_context_takeover)|"
+    r"(client_no_context_takeover)|"
+    r"(server_max_window_bits(?:=(\d+))?)|"
+    r"(client_max_window_bits(?:=(\d+))?)))*$"
+)
+
+_WS_EXT_RE_SPLIT: Final[Pattern[str]] = re.compile(r"permessage-deflate([^,]+)?")
+
+
+def ws_ext_parse(extstr: Optional[str], isserver: bool = False) -> Tuple[int, bool]:
+    if not extstr:
+        return 0, False
+
+    compress = 0
+    notakeover = False
+    for ext in _WS_EXT_RE_SPLIT.finditer(extstr):
+        defext = ext.group(1)
+        # Return compress = 15 when get `permessage-deflate`
+        if not defext:
+            compress = 15
+            break
+        match = _WS_EXT_RE.match(defext)
+        if match:
+            compress = 15
+            if isserver:
+                # Server never fail to detect compress handshake.
+                # Server does not need to send max wbit to client
+                if match.group(4):
+                    compress = int(match.group(4))
+                    # Group3 must match if group4 matches
+                    # Compress wbit 8 does not support in zlib
+                    # If compress level not support,
+                    # CONTINUE to next extension
+                    if compress > 15 or compress < 9:
+                        compress = 0
+                        continue
+                if match.group(1):
+                    notakeover = True
+                # Ignore regex group 5 & 6 for client_max_window_bits
+                break
+            else:
+                if match.group(6):
+                    compress = int(match.group(6))
+                    # Group5 must match if group6 matches
+                    # Compress wbit 8 does not support in zlib
+                    # If compress level not support,
+                    # FAIL the parse progress
+                    if compress > 15 or compress < 9:
+                        raise WSHandshakeError("Invalid window size")
+                if match.group(2):
+                    notakeover = True
+                # Ignore regex group 5 & 6 for client_max_window_bits
+                break
+        # Return Fail if client side and not match
+        elif not isserver:
+            raise WSHandshakeError("Extension for deflate not supported" + ext.group(1))
+
+    return compress, notakeover
+
+
+def ws_ext_gen(
+    compress: int = 15, isserver: bool = False, server_notakeover: bool = False
+) -> str:
+    # client_notakeover=False not used for server
+    # compress wbit 8 does not support in zlib
+    if compress < 9 or compress > 15:
+        raise ValueError(
+            "Compress wbits must between 9 and 15, " "zlib does not support wbits=8"
+        )
+    enabledext = ["permessage-deflate"]
+    if not isserver:
+        enabledext.append("client_max_window_bits")
+
+    if compress < 15:
+        enabledext.append("server_max_window_bits=" + str(compress))
+    if server_notakeover:
+        enabledext.append("server_no_context_takeover")
+    # if client_notakeover:
+    #     enabledext.append('client_no_context_takeover')
+    return "; ".join(enabledext)
+
+
+class WSParserState(IntEnum):
+    READ_HEADER = 1
+    READ_PAYLOAD_LENGTH = 2
+    READ_PAYLOAD_MASK = 3
+    READ_PAYLOAD = 4
+
+
+class WebSocketReader:
+    def __init__(
+        self, queue: DataQueue[WSMessage], max_msg_size: int, compress: bool = True
+    ) -> None:
+        self.queue = queue
+        self._max_msg_size = max_msg_size
+
+        self._exc: Optional[BaseException] = None
+        self._partial = bytearray()
+        self._state = WSParserState.READ_HEADER
+
+        self._opcode: Optional[int] = None
+        self._frame_fin = False
+        self._frame_opcode: Optional[int] = None
+        self._frame_payload = bytearray()
+
+        self._tail = b""
+        self._has_mask = False
+        self._frame_mask: Optional[bytes] = None
+        self._payload_length = 0
+        self._payload_length_flag = 0
+        self._compressed: Optional[bool] = None
+        self._decompressobj: Optional[ZLibDecompressor] = None
+        self._compress = compress
+
+    def feed_eof(self) -> None:
+        self.queue.feed_eof()
+
+    def feed_data(self, data: bytes) -> Tuple[bool, bytes]:
+        if self._exc:
+            return True, data
+
+        try:
+            return self._feed_data(data)
+        except Exception as exc:
+            self._exc = exc
+            set_exception(self.queue, exc)
+            return True, b""
+
+    def _feed_data(self, data: bytes) -> Tuple[bool, bytes]:
+        for fin, opcode, payload, compressed in self.parse_frame(data):
+            if compressed and not self._decompressobj:
+                self._decompressobj = ZLibDecompressor(suppress_deflate_header=True)
+            if opcode == WSMsgType.CLOSE:
+                if len(payload) >= 2:
+                    close_code = UNPACK_CLOSE_CODE(payload[:2])[0]
+                    if close_code < 3000 and close_code not in ALLOWED_CLOSE_CODES:
+                        raise WebSocketError(
+                            WSCloseCode.PROTOCOL_ERROR,
+                            f"Invalid close code: {close_code}",
+                        )
+                    try:
+                        close_message = payload[2:].decode("utf-8")
+                    except UnicodeDecodeError as exc:
+                        raise WebSocketError(
+                            WSCloseCode.INVALID_TEXT, "Invalid UTF-8 text message"
+                        ) from exc
+                    msg = WSMessage(WSMsgType.CLOSE, close_code, close_message)
+                elif payload:
+                    raise WebSocketError(
+                        WSCloseCode.PROTOCOL_ERROR,
+                        f"Invalid close frame: {fin} {opcode} {payload!r}",
+                    )
+                else:
+                    msg = WSMessage(WSMsgType.CLOSE, 0, "")
+
+                self.queue.feed_data(msg, 0)
+
+            elif opcode == WSMsgType.PING:
+                self.queue.feed_data(
+                    WSMessage(WSMsgType.PING, payload, ""), len(payload)
+                )
+
+            elif opcode == WSMsgType.PONG:
+                self.queue.feed_data(
+                    WSMessage(WSMsgType.PONG, payload, ""), len(payload)
+                )
+
+            elif (
+                opcode not in (WSMsgType.TEXT, WSMsgType.BINARY)
+                and self._opcode is None
+            ):
+                raise WebSocketError(
+                    WSCloseCode.PROTOCOL_ERROR, f"Unexpected opcode={opcode!r}"
+                )
+            else:
+                # load text/binary
+                if not fin:
+                    # got partial frame payload
+                    if opcode != WSMsgType.CONTINUATION:
+                        self._opcode = opcode
+                    self._partial.extend(payload)
+                    if self._max_msg_size and len(self._partial) >= self._max_msg_size:
+                        raise WebSocketError(
+                            WSCloseCode.MESSAGE_TOO_BIG,
+                            "Message size {} exceeds limit {}".format(
+                                len(self._partial), self._max_msg_size
+                            ),
+                        )
+                else:
+                    # previous frame was non finished
+                    # we should get continuation opcode
+                    if self._partial:
+                        if opcode != WSMsgType.CONTINUATION:
+                            raise WebSocketError(
+                                WSCloseCode.PROTOCOL_ERROR,
+                                "The opcode in non-fin frame is expected "
+                                "to be zero, got {!r}".format(opcode),
+                            )
+
+                    if opcode == WSMsgType.CONTINUATION:
+                        assert self._opcode is not None
+                        opcode = self._opcode
+                        self._opcode = None
+
+                    self._partial.extend(payload)
+                    if self._max_msg_size and len(self._partial) >= self._max_msg_size:
+                        raise WebSocketError(
+                            WSCloseCode.MESSAGE_TOO_BIG,
+                            "Message size {} exceeds limit {}".format(
+                                len(self._partial), self._max_msg_size
+                            ),
+                        )
+
+                    # Decompress process must to be done after all packets
+                    # received.
+                    if compressed:
+                        assert self._decompressobj is not None
+                        self._partial.extend(_WS_DEFLATE_TRAILING)
+                        payload_merged = self._decompressobj.decompress_sync(
+                            self._partial, self._max_msg_size
+                        )
+                        if self._decompressobj.unconsumed_tail:
+                            left = len(self._decompressobj.unconsumed_tail)
+                            raise WebSocketError(
+                                WSCloseCode.MESSAGE_TOO_BIG,
+                                "Decompressed message size {} exceeds limit {}".format(
+                                    self._max_msg_size + left, self._max_msg_size
+                                ),
+                            )
+                    else:
+                        payload_merged = bytes(self._partial)
+
+                    self._partial.clear()
+
+                    if opcode == WSMsgType.TEXT:
+                        try:
+                            text = payload_merged.decode("utf-8")
+                            self.queue.feed_data(
+                                WSMessage(WSMsgType.TEXT, text, ""), len(text)
+                            )
+                        except UnicodeDecodeError as exc:
+                            raise WebSocketError(
+                                WSCloseCode.INVALID_TEXT, "Invalid UTF-8 text message"
+                            ) from exc
+                    else:
+                        self.queue.feed_data(
+                            WSMessage(WSMsgType.BINARY, payload_merged, ""),
+                            len(payload_merged),
+                        )
+
+        return False, b""
+
+    def parse_frame(
+        self, buf: bytes
+    ) -> List[Tuple[bool, Optional[int], bytearray, Optional[bool]]]:
+        """Return the next frame from the socket."""
+        frames = []
+        if self._tail:
+            buf, self._tail = self._tail + buf, b""
+
+        start_pos = 0
+        buf_length = len(buf)
+
+        while True:
+            # read header
+            if self._state == WSParserState.READ_HEADER:
+                if buf_length - start_pos >= 2:
+                    data = buf[start_pos : start_pos + 2]
+                    start_pos += 2
+                    first_byte, second_byte = data
+
+                    fin = (first_byte >> 7) & 1
+                    rsv1 = (first_byte >> 6) & 1
+                    rsv2 = (first_byte >> 5) & 1
+                    rsv3 = (first_byte >> 4) & 1
+                    opcode = first_byte & 0xF
+
+                    # frame-fin = %x0 ; more frames of this message follow
+                    #           / %x1 ; final frame of this message
+                    # frame-rsv1 = %x0 ;
+                    #    1 bit, MUST be 0 unless negotiated otherwise
+                    # frame-rsv2 = %x0 ;
+                    #    1 bit, MUST be 0 unless negotiated otherwise
+                    # frame-rsv3 = %x0 ;
+                    #    1 bit, MUST be 0 unless negotiated otherwise
+                    #
+                    # Remove rsv1 from this test for deflate development
+                    if rsv2 or rsv3 or (rsv1 and not self._compress):
+                        raise WebSocketError(
+                            WSCloseCode.PROTOCOL_ERROR,
+                            "Received frame with non-zero reserved bits",
+                        )
+
+                    if opcode > 0x7 and fin == 0:
+                        raise WebSocketError(
+                            WSCloseCode.PROTOCOL_ERROR,
+                            "Received fragmented control frame",
+                        )
+
+                    has_mask = (second_byte >> 7) & 1
+                    length = second_byte & 0x7F
+
+                    # Control frames MUST have a payload
+                    # length of 125 bytes or less
+                    if opcode > 0x7 and length > 125:
+                        raise WebSocketError(
+                            WSCloseCode.PROTOCOL_ERROR,
+                            "Control frame payload cannot be " "larger than 125 bytes",
+                        )
+
+                    # Set compress status if last package is FIN
+                    # OR set compress status if this is first fragment
+                    # Raise error if not first fragment with rsv1 = 0x1
+                    if self._frame_fin or self._compressed is None:
+                        self._compressed = True if rsv1 else False
+                    elif rsv1:
+                        raise WebSocketError(
+                            WSCloseCode.PROTOCOL_ERROR,
+                            "Received frame with non-zero reserved bits",
+                        )
+
+                    self._frame_fin = bool(fin)
+                    self._frame_opcode = opcode
+                    self._has_mask = bool(has_mask)
+                    self._payload_length_flag = length
+                    self._state = WSParserState.READ_PAYLOAD_LENGTH
+                else:
+                    break
+
+            # read payload length
+            if self._state == WSParserState.READ_PAYLOAD_LENGTH:
+                length = self._payload_length_flag
+                if length == 126:
+                    if buf_length - start_pos >= 2:
+                        data = buf[start_pos : start_pos + 2]
+                        start_pos += 2
+                        length = UNPACK_LEN2(data)[0]
+                        self._payload_length = length
+                        self._state = (
+                            WSParserState.READ_PAYLOAD_MASK
+                            if self._has_mask
+                            else WSParserState.READ_PAYLOAD
+                        )
+                    else:
+                        break
+                elif length > 126:
+                    if buf_length - start_pos >= 8:
+                        data = buf[start_pos : start_pos + 8]
+                        start_pos += 8
+                        length = UNPACK_LEN3(data)[0]
+                        self._payload_length = length
+                        self._state = (
+                            WSParserState.READ_PAYLOAD_MASK
+                            if self._has_mask
+                            else WSParserState.READ_PAYLOAD
+                        )
+                    else:
+                        break
+                else:
+                    self._payload_length = length
+                    self._state = (
+                        WSParserState.READ_PAYLOAD_MASK
+                        if self._has_mask
+                        else WSParserState.READ_PAYLOAD
+                    )
+
+            # read payload mask
+            if self._state == WSParserState.READ_PAYLOAD_MASK:
+                if buf_length - start_pos >= 4:
+                    self._frame_mask = buf[start_pos : start_pos + 4]
+                    start_pos += 4
+                    self._state = WSParserState.READ_PAYLOAD
+                else:
+                    break
+
+            if self._state == WSParserState.READ_PAYLOAD:
+                length = self._payload_length
+                payload = self._frame_payload
+
+                chunk_len = buf_length - start_pos
+                if length >= chunk_len:
+                    self._payload_length = length - chunk_len
+                    payload.extend(buf[start_pos:])
+                    start_pos = buf_length
+                else:
+                    self._payload_length = 0
+                    payload.extend(buf[start_pos : start_pos + length])
+                    start_pos = start_pos + length
+
+                if self._payload_length == 0:
+                    if self._has_mask:
+                        assert self._frame_mask is not None
+                        _websocket_mask(self._frame_mask, payload)
+
+                    frames.append(
+                        (self._frame_fin, self._frame_opcode, payload, self._compressed)
+                    )
+
+                    self._frame_payload = bytearray()
+                    self._state = WSParserState.READ_HEADER
+                else:
+                    break
+
+        self._tail = buf[start_pos:]
+
+        return frames
+
+
+class WebSocketWriter:
+    def __init__(
+        self,
+        protocol: BaseProtocol,
+        transport: asyncio.Transport,
+        *,
+        use_mask: bool = False,
+        limit: int = DEFAULT_LIMIT,
+        random: random.Random = random.Random(),
+        compress: int = 0,
+        notakeover: bool = False,
+    ) -> None:
+        self.protocol = protocol
+        self.transport = transport
+        self.use_mask = use_mask
+        self.randrange = random.randrange
+        self.compress = compress
+        self.notakeover = notakeover
+        self._closing = False
+        self._limit = limit
+        self._output_size = 0
+        self._compressobj: Any = None  # actually compressobj
+
+    async def _send_frame(
+        self, message: bytes, opcode: int, compress: Optional[int] = None
+    ) -> None:
+        """Send a frame over the websocket with message as its payload."""
+        if self._closing and not (opcode & WSMsgType.CLOSE):
+            raise ConnectionResetError("Cannot write to closing transport")
+
+        rsv = 0
+
+        # Only compress larger packets (disabled)
+        # Does small packet needs to be compressed?
+        # if self.compress and opcode < 8 and len(message) > 124:
+        if (compress or self.compress) and opcode < 8:
+            if compress:
+                # Do not set self._compress if compressing is for this frame
+                compressobj = self._make_compress_obj(compress)
+            else:  # self.compress
+                if not self._compressobj:
+                    self._compressobj = self._make_compress_obj(self.compress)
+                compressobj = self._compressobj
+
+            message = await compressobj.compress(message)
+            # Its critical that we do not return control to the event
+            # loop until we have finished sending all the compressed
+            # data. Otherwise we could end up mixing compressed frames
+            # if there are multiple coroutines compressing data.
+            message += compressobj.flush(
+                zlib.Z_FULL_FLUSH if self.notakeover else zlib.Z_SYNC_FLUSH
+            )
+            if message.endswith(_WS_DEFLATE_TRAILING):
+                message = message[:-4]
+            rsv = rsv | 0x40
+
+        msg_length = len(message)
+
+        use_mask = self.use_mask
+        if use_mask:
+            mask_bit = 0x80
+        else:
+            mask_bit = 0
+
+        if msg_length < 126:
+            header = PACK_LEN1(0x80 | rsv | opcode, msg_length | mask_bit)
+        elif msg_length < (1 << 16):
+            header = PACK_LEN2(0x80 | rsv | opcode, 126 | mask_bit, msg_length)
+        else:
+            header = PACK_LEN3(0x80 | rsv | opcode, 127 | mask_bit, msg_length)
+        if use_mask:
+            mask_int = self.randrange(0, 0xFFFFFFFF)
+            mask = mask_int.to_bytes(4, "big")
+            message = bytearray(message)
+            _websocket_mask(mask, message)
+            self._write(header + mask + message)
+            self._output_size += len(header) + len(mask) + msg_length
+        else:
+            if msg_length > MSG_SIZE:
+                self._write(header)
+                self._write(message)
+            else:
+                self._write(header + message)
+
+            self._output_size += len(header) + msg_length
+
+        # It is safe to return control to the event loop when using compression
+        # after this point as we have already sent or buffered all the data.
+
+        if self._output_size > self._limit:
+            self._output_size = 0
+            await self.protocol._drain_helper()
+
+    def _make_compress_obj(self, compress: int) -> ZLibCompressor:
+        return ZLibCompressor(
+            level=zlib.Z_BEST_SPEED,
+            wbits=-compress,
+            max_sync_chunk_size=WEBSOCKET_MAX_SYNC_CHUNK_SIZE,
+        )
+
+    def _write(self, data: bytes) -> None:
+        if self.transport is None or self.transport.is_closing():
+            raise ConnectionResetError("Cannot write to closing transport")
+        self.transport.write(data)
+
+    async def pong(self, message: Union[bytes, str] = b"") -> None:
+        """Send pong message."""
+        if isinstance(message, str):
+            message = message.encode("utf-8")
+        await self._send_frame(message, WSMsgType.PONG)
+
+    async def ping(self, message: Union[bytes, str] = b"") -> None:
+        """Send ping message."""
+        if isinstance(message, str):
+            message = message.encode("utf-8")
+        await self._send_frame(message, WSMsgType.PING)
+
+    async def send(
+        self,
+        message: Union[str, bytes],
+        binary: bool = False,
+        compress: Optional[int] = None,
+    ) -> None:
+        """Send a frame over the websocket with message as its payload."""
+        if isinstance(message, str):
+            message = message.encode("utf-8")
+        if binary:
+            await self._send_frame(message, WSMsgType.BINARY, compress)
+        else:
+            await self._send_frame(message, WSMsgType.TEXT, compress)
+
+    async def close(self, code: int = 1000, message: Union[bytes, str] = b"") -> None:
+        """Close the websocket, sending the specified code and message."""
+        if isinstance(message, str):
+            message = message.encode("utf-8")
+        try:
+            await self._send_frame(
+                PACK_CLOSE_CODE(code) + message, opcode=WSMsgType.CLOSE
+            )
+        finally:
+            self._closing = True
diff --git a/llm/Lib/site-packages/aiohttp/http_writer.py b/llm/Lib/site-packages/aiohttp/http_writer.py
new file mode 100644
index 0000000000000000000000000000000000000000..84e9b49589517dd8468e375e2cb1c7fd575a75b9
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/http_writer.py
@@ -0,0 +1,198 @@
+"""Http related parsers and protocol."""
+
+import asyncio
+import zlib
+from typing import Any, Awaitable, Callable, NamedTuple, Optional, Union  # noqa
+
+from multidict import CIMultiDict
+
+from .abc import AbstractStreamWriter
+from .base_protocol import BaseProtocol
+from .compression_utils import ZLibCompressor
+from .helpers import NO_EXTENSIONS
+
+__all__ = ("StreamWriter", "HttpVersion", "HttpVersion10", "HttpVersion11")
+
+
+class HttpVersion(NamedTuple):
+    major: int
+    minor: int
+
+
+HttpVersion10 = HttpVersion(1, 0)
+HttpVersion11 = HttpVersion(1, 1)
+
+
+_T_OnChunkSent = Optional[Callable[[bytes], Awaitable[None]]]
+_T_OnHeadersSent = Optional[Callable[["CIMultiDict[str]"], Awaitable[None]]]
+
+
+class StreamWriter(AbstractStreamWriter):
+    def __init__(
+        self,
+        protocol: BaseProtocol,
+        loop: asyncio.AbstractEventLoop,
+        on_chunk_sent: _T_OnChunkSent = None,
+        on_headers_sent: _T_OnHeadersSent = None,
+    ) -> None:
+        self._protocol = protocol
+
+        self.loop = loop
+        self.length = None
+        self.chunked = False
+        self.buffer_size = 0
+        self.output_size = 0
+
+        self._eof = False
+        self._compress: Optional[ZLibCompressor] = None
+        self._drain_waiter = None
+
+        self._on_chunk_sent: _T_OnChunkSent = on_chunk_sent
+        self._on_headers_sent: _T_OnHeadersSent = on_headers_sent
+
+    @property
+    def transport(self) -> Optional[asyncio.Transport]:
+        return self._protocol.transport
+
+    @property
+    def protocol(self) -> BaseProtocol:
+        return self._protocol
+
+    def enable_chunking(self) -> None:
+        self.chunked = True
+
+    def enable_compression(
+        self, encoding: str = "deflate", strategy: int = zlib.Z_DEFAULT_STRATEGY
+    ) -> None:
+        self._compress = ZLibCompressor(encoding=encoding, strategy=strategy)
+
+    def _write(self, chunk: bytes) -> None:
+        size = len(chunk)
+        self.buffer_size += size
+        self.output_size += size
+        transport = self.transport
+        if not self._protocol.connected or transport is None or transport.is_closing():
+            raise ConnectionResetError("Cannot write to closing transport")
+        transport.write(chunk)
+
+    async def write(
+        self, chunk: bytes, *, drain: bool = True, LIMIT: int = 0x10000
+    ) -> None:
+        """Writes chunk of data to a stream.
+
+        write_eof() indicates end of stream.
+        writer can't be used after write_eof() method being called.
+        write() return drain future.
+        """
+        if self._on_chunk_sent is not None:
+            await self._on_chunk_sent(chunk)
+
+        if isinstance(chunk, memoryview):
+            if chunk.nbytes != len(chunk):
+                # just reshape it
+                chunk = chunk.cast("c")
+
+        if self._compress is not None:
+            chunk = await self._compress.compress(chunk)
+            if not chunk:
+                return
+
+        if self.length is not None:
+            chunk_len = len(chunk)
+            if self.length >= chunk_len:
+                self.length = self.length - chunk_len
+            else:
+                chunk = chunk[: self.length]
+                self.length = 0
+                if not chunk:
+                    return
+
+        if chunk:
+            if self.chunked:
+                chunk_len_pre = ("%x\r\n" % len(chunk)).encode("ascii")
+                chunk = chunk_len_pre + chunk + b"\r\n"
+
+            self._write(chunk)
+
+            if self.buffer_size > LIMIT and drain:
+                self.buffer_size = 0
+                await self.drain()
+
+    async def write_headers(
+        self, status_line: str, headers: "CIMultiDict[str]"
+    ) -> None:
+        """Write request/response status and headers."""
+        if self._on_headers_sent is not None:
+            await self._on_headers_sent(headers)
+
+        # status + headers
+        buf = _serialize_headers(status_line, headers)
+        self._write(buf)
+
+    async def write_eof(self, chunk: bytes = b"") -> None:
+        if self._eof:
+            return
+
+        if chunk and self._on_chunk_sent is not None:
+            await self._on_chunk_sent(chunk)
+
+        if self._compress:
+            if chunk:
+                chunk = await self._compress.compress(chunk)
+
+            chunk += self._compress.flush()
+            if chunk and self.chunked:
+                chunk_len = ("%x\r\n" % len(chunk)).encode("ascii")
+                chunk = chunk_len + chunk + b"\r\n0\r\n\r\n"
+        else:
+            if self.chunked:
+                if chunk:
+                    chunk_len = ("%x\r\n" % len(chunk)).encode("ascii")
+                    chunk = chunk_len + chunk + b"\r\n0\r\n\r\n"
+                else:
+                    chunk = b"0\r\n\r\n"
+
+        if chunk:
+            self._write(chunk)
+
+        await self.drain()
+
+        self._eof = True
+
+    async def drain(self) -> None:
+        """Flush the write buffer.
+
+        The intended use is to write
+
+          await w.write(data)
+          await w.drain()
+        """
+        if self._protocol.transport is not None:
+            await self._protocol._drain_helper()
+
+
+def _safe_header(string: str) -> str:
+    if "\r" in string or "\n" in string:
+        raise ValueError(
+            "Newline or carriage return detected in headers. "
+            "Potential header injection attack."
+        )
+    return string
+
+
+def _py_serialize_headers(status_line: str, headers: "CIMultiDict[str]") -> bytes:
+    headers_gen = (_safe_header(k) + ": " + _safe_header(v) for k, v in headers.items())
+    line = status_line + "\r\n" + "\r\n".join(headers_gen) + "\r\n\r\n"
+    return line.encode("utf-8")
+
+
+_serialize_headers = _py_serialize_headers
+
+try:
+    import aiohttp._http_writer as _http_writer  # type: ignore[import-not-found]
+
+    _c_serialize_headers = _http_writer._serialize_headers
+    if not NO_EXTENSIONS:
+        _serialize_headers = _c_serialize_headers
+except ImportError:
+    pass
diff --git a/llm/Lib/site-packages/aiohttp/locks.py b/llm/Lib/site-packages/aiohttp/locks.py
new file mode 100644
index 0000000000000000000000000000000000000000..fbfff2fa42cc29d377e29552092744899c10d640
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/locks.py
@@ -0,0 +1,41 @@
+import asyncio
+import collections
+from typing import Any, Deque, Optional
+
+
+class EventResultOrError:
+    """Event asyncio lock helper class.
+
+    Wraps the Event asyncio lock allowing either to awake the
+    locked Tasks without any error or raising an exception.
+
+    thanks to @vorpalsmith for the simple design.
+    """
+
+    def __init__(self, loop: asyncio.AbstractEventLoop) -> None:
+        self._loop = loop
+        self._exc: Optional[BaseException] = None
+        self._event = asyncio.Event()
+        self._waiters: Deque[asyncio.Future[Any]] = collections.deque()
+
+    def set(self, exc: Optional[BaseException] = None) -> None:
+        self._exc = exc
+        self._event.set()
+
+    async def wait(self) -> Any:
+        waiter = self._loop.create_task(self._event.wait())
+        self._waiters.append(waiter)
+        try:
+            val = await waiter
+        finally:
+            self._waiters.remove(waiter)
+
+        if self._exc is not None:
+            raise self._exc
+
+        return val
+
+    def cancel(self) -> None:
+        """Cancel all waiters"""
+        for waiter in self._waiters:
+            waiter.cancel()
diff --git a/llm/Lib/site-packages/aiohttp/log.py b/llm/Lib/site-packages/aiohttp/log.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1314145b262658992db308631a13bac6948f7f8
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/log.py
@@ -0,0 +1,8 @@
+import logging
+
+access_logger = logging.getLogger("aiohttp.access")
+client_logger = logging.getLogger("aiohttp.client")
+internal_logger = logging.getLogger("aiohttp.internal")
+server_logger = logging.getLogger("aiohttp.server")
+web_logger = logging.getLogger("aiohttp.web")
+ws_logger = logging.getLogger("aiohttp.websocket")
diff --git a/llm/Lib/site-packages/aiohttp/multipart.py b/llm/Lib/site-packages/aiohttp/multipart.py
new file mode 100644
index 0000000000000000000000000000000000000000..660cdf136b941d981a76a61d0174e3c2939b1569
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/multipart.py
@@ -0,0 +1,1015 @@
+import base64
+import binascii
+import json
+import re
+import uuid
+import warnings
+import zlib
+from collections import deque
+from types import TracebackType
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Deque,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+from urllib.parse import parse_qsl, unquote, urlencode
+
+from multidict import CIMultiDict, CIMultiDictProxy
+
+from .compression_utils import ZLibCompressor, ZLibDecompressor
+from .hdrs import (
+    CONTENT_DISPOSITION,
+    CONTENT_ENCODING,
+    CONTENT_LENGTH,
+    CONTENT_TRANSFER_ENCODING,
+    CONTENT_TYPE,
+)
+from .helpers import CHAR, TOKEN, parse_mimetype, reify
+from .http import HeadersParser
+from .payload import (
+    JsonPayload,
+    LookupError,
+    Order,
+    Payload,
+    StringPayload,
+    get_payload,
+    payload_type,
+)
+from .streams import StreamReader
+
+__all__ = (
+    "MultipartReader",
+    "MultipartWriter",
+    "BodyPartReader",
+    "BadContentDispositionHeader",
+    "BadContentDispositionParam",
+    "parse_content_disposition",
+    "content_disposition_filename",
+)
+
+
+if TYPE_CHECKING:
+    from .client_reqrep import ClientResponse
+
+
+class BadContentDispositionHeader(RuntimeWarning):
+    pass
+
+
+class BadContentDispositionParam(RuntimeWarning):
+    pass
+
+
+def parse_content_disposition(
+    header: Optional[str],
+) -> Tuple[Optional[str], Dict[str, str]]:
+    def is_token(string: str) -> bool:
+        return bool(string) and TOKEN >= set(string)
+
+    def is_quoted(string: str) -> bool:
+        return string[0] == string[-1] == '"'
+
+    def is_rfc5987(string: str) -> bool:
+        return is_token(string) and string.count("'") == 2
+
+    def is_extended_param(string: str) -> bool:
+        return string.endswith("*")
+
+    def is_continuous_param(string: str) -> bool:
+        pos = string.find("*") + 1
+        if not pos:
+            return False
+        substring = string[pos:-1] if string.endswith("*") else string[pos:]
+        return substring.isdigit()
+
+    def unescape(text: str, *, chars: str = "".join(map(re.escape, CHAR))) -> str:
+        return re.sub(f"\\\\([{chars}])", "\\1", text)
+
+    if not header:
+        return None, {}
+
+    disptype, *parts = header.split(";")
+    if not is_token(disptype):
+        warnings.warn(BadContentDispositionHeader(header))
+        return None, {}
+
+    params: Dict[str, str] = {}
+    while parts:
+        item = parts.pop(0)
+
+        if "=" not in item:
+            warnings.warn(BadContentDispositionHeader(header))
+            return None, {}
+
+        key, value = item.split("=", 1)
+        key = key.lower().strip()
+        value = value.lstrip()
+
+        if key in params:
+            warnings.warn(BadContentDispositionHeader(header))
+            return None, {}
+
+        if not is_token(key):
+            warnings.warn(BadContentDispositionParam(item))
+            continue
+
+        elif is_continuous_param(key):
+            if is_quoted(value):
+                value = unescape(value[1:-1])
+            elif not is_token(value):
+                warnings.warn(BadContentDispositionParam(item))
+                continue
+
+        elif is_extended_param(key):
+            if is_rfc5987(value):
+                encoding, _, value = value.split("'", 2)
+                encoding = encoding or "utf-8"
+            else:
+                warnings.warn(BadContentDispositionParam(item))
+                continue
+
+            try:
+                value = unquote(value, encoding, "strict")
+            except UnicodeDecodeError:  # pragma: nocover
+                warnings.warn(BadContentDispositionParam(item))
+                continue
+
+        else:
+            failed = True
+            if is_quoted(value):
+                failed = False
+                value = unescape(value[1:-1].lstrip("\\/"))
+            elif is_token(value):
+                failed = False
+            elif parts:
+                # maybe just ; in filename, in any case this is just
+                # one case fix, for proper fix we need to redesign parser
+                _value = f"{value};{parts[0]}"
+                if is_quoted(_value):
+                    parts.pop(0)
+                    value = unescape(_value[1:-1].lstrip("\\/"))
+                    failed = False
+
+            if failed:
+                warnings.warn(BadContentDispositionHeader(header))
+                return None, {}
+
+        params[key] = value
+
+    return disptype.lower(), params
+
+
+def content_disposition_filename(
+    params: Mapping[str, str], name: str = "filename"
+) -> Optional[str]:
+    name_suf = "%s*" % name
+    if not params:
+        return None
+    elif name_suf in params:
+        return params[name_suf]
+    elif name in params:
+        return params[name]
+    else:
+        parts = []
+        fnparams = sorted(
+            (key, value) for key, value in params.items() if key.startswith(name_suf)
+        )
+        for num, (key, value) in enumerate(fnparams):
+            _, tail = key.split("*", 1)
+            if tail.endswith("*"):
+                tail = tail[:-1]
+            if tail == str(num):
+                parts.append(value)
+            else:
+                break
+        if not parts:
+            return None
+        value = "".join(parts)
+        if "'" in value:
+            encoding, _, value = value.split("'", 2)
+            encoding = encoding or "utf-8"
+            return unquote(value, encoding, "strict")
+        return value
+
+
+class MultipartResponseWrapper:
+    """Wrapper around the MultipartReader.
+
+    It takes care about
+    underlying connection and close it when it needs in.
+    """
+
+    def __init__(
+        self,
+        resp: "ClientResponse",
+        stream: "MultipartReader",
+    ) -> None:
+        self.resp = resp
+        self.stream = stream
+
+    def __aiter__(self) -> "MultipartResponseWrapper":
+        return self
+
+    async def __anext__(
+        self,
+    ) -> Union["MultipartReader", "BodyPartReader"]:
+        part = await self.next()
+        if part is None:
+            raise StopAsyncIteration
+        return part
+
+    def at_eof(self) -> bool:
+        """Returns True when all response data had been read."""
+        return self.resp.content.at_eof()
+
+    async def next(
+        self,
+    ) -> Optional[Union["MultipartReader", "BodyPartReader"]]:
+        """Emits next multipart reader object."""
+        item = await self.stream.next()
+        if self.stream.at_eof():
+            await self.release()
+        return item
+
+    async def release(self) -> None:
+        """Release the connection gracefully.
+
+        All remaining content is read to the void.
+        """
+        await self.resp.release()
+
+
+class BodyPartReader:
+    """Multipart reader for single body part."""
+
+    chunk_size = 8192
+
+    def __init__(
+        self,
+        boundary: bytes,
+        headers: "CIMultiDictProxy[str]",
+        content: StreamReader,
+        *,
+        subtype: str = "mixed",
+        default_charset: Optional[str] = None,
+    ) -> None:
+        self.headers = headers
+        self._boundary = boundary
+        self._content = content
+        self._default_charset = default_charset
+        self._at_eof = False
+        self._is_form_data = subtype == "form-data"
+        # https://datatracker.ietf.org/doc/html/rfc7578#section-4.8
+        length = None if self._is_form_data else self.headers.get(CONTENT_LENGTH, None)
+        self._length = int(length) if length is not None else None
+        self._read_bytes = 0
+        self._unread: Deque[bytes] = deque()
+        self._prev_chunk: Optional[bytes] = None
+        self._content_eof = 0
+        self._cache: Dict[str, Any] = {}
+
+    def __aiter__(self) -> AsyncIterator["BodyPartReader"]:
+        return self  # type: ignore[return-value]
+
+    async def __anext__(self) -> bytes:
+        part = await self.next()
+        if part is None:
+            raise StopAsyncIteration
+        return part
+
+    async def next(self) -> Optional[bytes]:
+        item = await self.read()
+        if not item:
+            return None
+        return item
+
+    async def read(self, *, decode: bool = False) -> bytes:
+        """Reads body part data.
+
+        decode: Decodes data following by encoding
+                method from Content-Encoding header. If it missed
+                data remains untouched
+        """
+        if self._at_eof:
+            return b""
+        data = bytearray()
+        while not self._at_eof:
+            data.extend(await self.read_chunk(self.chunk_size))
+        if decode:
+            return self.decode(data)
+        return data
+
+    async def read_chunk(self, size: int = chunk_size) -> bytes:
+        """Reads body part content chunk of the specified size.
+
+        size: chunk size
+        """
+        if self._at_eof:
+            return b""
+        if self._length:
+            chunk = await self._read_chunk_from_length(size)
+        else:
+            chunk = await self._read_chunk_from_stream(size)
+
+        self._read_bytes += len(chunk)
+        if self._read_bytes == self._length:
+            self._at_eof = True
+        if self._at_eof:
+            clrf = await self._content.readline()
+            assert (
+                b"\r\n" == clrf
+            ), "reader did not read all the data or it is malformed"
+        return chunk
+
+    async def _read_chunk_from_length(self, size: int) -> bytes:
+        # Reads body part content chunk of the specified size.
+        # The body part must has Content-Length header with proper value.
+        assert self._length is not None, "Content-Length required for chunked read"
+        chunk_size = min(size, self._length - self._read_bytes)
+        chunk = await self._content.read(chunk_size)
+        if self._content.at_eof():
+            self._at_eof = True
+        return chunk
+
+    async def _read_chunk_from_stream(self, size: int) -> bytes:
+        # Reads content chunk of body part with unknown length.
+        # The Content-Length header for body part is not necessary.
+        assert (
+            size >= len(self._boundary) + 2
+        ), "Chunk size must be greater or equal than boundary length + 2"
+        first_chunk = self._prev_chunk is None
+        if first_chunk:
+            self._prev_chunk = await self._content.read(size)
+
+        chunk = await self._content.read(size)
+        self._content_eof += int(self._content.at_eof())
+        assert self._content_eof < 3, "Reading after EOF"
+        assert self._prev_chunk is not None
+        window = self._prev_chunk + chunk
+        sub = b"\r\n" + self._boundary
+        if first_chunk:
+            idx = window.find(sub)
+        else:
+            idx = window.find(sub, max(0, len(self._prev_chunk) - len(sub)))
+        if idx >= 0:
+            # pushing boundary back to content
+            with warnings.catch_warnings():
+                warnings.filterwarnings("ignore", category=DeprecationWarning)
+                self._content.unread_data(window[idx:])
+            if size > idx:
+                self._prev_chunk = self._prev_chunk[:idx]
+            chunk = window[len(self._prev_chunk) : idx]
+            if not chunk:
+                self._at_eof = True
+        result = self._prev_chunk
+        self._prev_chunk = chunk
+        return result
+
+    async def readline(self) -> bytes:
+        """Reads body part by line by line."""
+        if self._at_eof:
+            return b""
+
+        if self._unread:
+            line = self._unread.popleft()
+        else:
+            line = await self._content.readline()
+
+        if line.startswith(self._boundary):
+            # the very last boundary may not come with \r\n,
+            # so set single rules for everyone
+            sline = line.rstrip(b"\r\n")
+            boundary = self._boundary
+            last_boundary = self._boundary + b"--"
+            # ensure that we read exactly the boundary, not something alike
+            if sline == boundary or sline == last_boundary:
+                self._at_eof = True
+                self._unread.append(line)
+                return b""
+        else:
+            next_line = await self._content.readline()
+            if next_line.startswith(self._boundary):
+                line = line[:-2]  # strip CRLF but only once
+            self._unread.append(next_line)
+
+        return line
+
+    async def release(self) -> None:
+        """Like read(), but reads all the data to the void."""
+        if self._at_eof:
+            return
+        while not self._at_eof:
+            await self.read_chunk(self.chunk_size)
+
+    async def text(self, *, encoding: Optional[str] = None) -> str:
+        """Like read(), but assumes that body part contains text data."""
+        data = await self.read(decode=True)
+        # see https://www.w3.org/TR/html5/forms.html#multipart/form-data-encoding-algorithm
+        # and https://dvcs.w3.org/hg/xhr/raw-file/tip/Overview.html#dom-xmlhttprequest-send
+        encoding = encoding or self.get_charset(default="utf-8")
+        return data.decode(encoding)
+
+    async def json(self, *, encoding: Optional[str] = None) -> Optional[Dict[str, Any]]:
+        """Like read(), but assumes that body parts contains JSON data."""
+        data = await self.read(decode=True)
+        if not data:
+            return None
+        encoding = encoding or self.get_charset(default="utf-8")
+        return cast(Dict[str, Any], json.loads(data.decode(encoding)))
+
+    async def form(self, *, encoding: Optional[str] = None) -> List[Tuple[str, str]]:
+        """Like read(), but assumes that body parts contain form urlencoded data."""
+        data = await self.read(decode=True)
+        if not data:
+            return []
+        if encoding is not None:
+            real_encoding = encoding
+        else:
+            real_encoding = self.get_charset(default="utf-8")
+        try:
+            decoded_data = data.rstrip().decode(real_encoding)
+        except UnicodeDecodeError:
+            raise ValueError("data cannot be decoded with %s encoding" % real_encoding)
+
+        return parse_qsl(
+            decoded_data,
+            keep_blank_values=True,
+            encoding=real_encoding,
+        )
+
+    def at_eof(self) -> bool:
+        """Returns True if the boundary was reached or False otherwise."""
+        return self._at_eof
+
+    def decode(self, data: bytes) -> bytes:
+        """Decodes data.
+
+        Decoding is done according the specified Content-Encoding
+        or Content-Transfer-Encoding headers value.
+        """
+        if CONTENT_TRANSFER_ENCODING in self.headers:
+            data = self._decode_content_transfer(data)
+        # https://datatracker.ietf.org/doc/html/rfc7578#section-4.8
+        if not self._is_form_data and CONTENT_ENCODING in self.headers:
+            return self._decode_content(data)
+        return data
+
+    def _decode_content(self, data: bytes) -> bytes:
+        encoding = self.headers.get(CONTENT_ENCODING, "").lower()
+        if encoding == "identity":
+            return data
+        if encoding in {"deflate", "gzip"}:
+            return ZLibDecompressor(
+                encoding=encoding,
+                suppress_deflate_header=True,
+            ).decompress_sync(data)
+
+        raise RuntimeError(f"unknown content encoding: {encoding}")
+
+    def _decode_content_transfer(self, data: bytes) -> bytes:
+        encoding = self.headers.get(CONTENT_TRANSFER_ENCODING, "").lower()
+
+        if encoding == "base64":
+            return base64.b64decode(data)
+        elif encoding == "quoted-printable":
+            return binascii.a2b_qp(data)
+        elif encoding in ("binary", "8bit", "7bit"):
+            return data
+        else:
+            raise RuntimeError(
+                "unknown content transfer encoding: {}" "".format(encoding)
+            )
+
+    def get_charset(self, default: str) -> str:
+        """Returns charset parameter from Content-Type header or default."""
+        ctype = self.headers.get(CONTENT_TYPE, "")
+        mimetype = parse_mimetype(ctype)
+        return mimetype.parameters.get("charset", self._default_charset or default)
+
+    @reify
+    def name(self) -> Optional[str]:
+        """Returns name specified in Content-Disposition header.
+
+        If the header is missing or malformed, returns None.
+        """
+        _, params = parse_content_disposition(self.headers.get(CONTENT_DISPOSITION))
+        return content_disposition_filename(params, "name")
+
+    @reify
+    def filename(self) -> Optional[str]:
+        """Returns filename specified in Content-Disposition header.
+
+        Returns None if the header is missing or malformed.
+        """
+        _, params = parse_content_disposition(self.headers.get(CONTENT_DISPOSITION))
+        return content_disposition_filename(params, "filename")
+
+
+@payload_type(BodyPartReader, order=Order.try_first)
+class BodyPartReaderPayload(Payload):
+    def __init__(self, value: BodyPartReader, *args: Any, **kwargs: Any) -> None:
+        super().__init__(value, *args, **kwargs)
+
+        params: Dict[str, str] = {}
+        if value.name is not None:
+            params["name"] = value.name
+        if value.filename is not None:
+            params["filename"] = value.filename
+
+        if params:
+            self.set_content_disposition("attachment", True, **params)
+
+    async def write(self, writer: Any) -> None:
+        field = self._value
+        chunk = await field.read_chunk(size=2**16)
+        while chunk:
+            await writer.write(field.decode(chunk))
+            chunk = await field.read_chunk(size=2**16)
+
+
+class MultipartReader:
+    """Multipart body reader."""
+
+    #: Response wrapper, used when multipart readers constructs from response.
+    response_wrapper_cls = MultipartResponseWrapper
+    #: Multipart reader class, used to handle multipart/* body parts.
+    #: None points to type(self)
+    multipart_reader_cls = None
+    #: Body part reader class for non multipart/* content types.
+    part_reader_cls = BodyPartReader
+
+    def __init__(self, headers: Mapping[str, str], content: StreamReader) -> None:
+        self._mimetype = parse_mimetype(headers[CONTENT_TYPE])
+        assert self._mimetype.type == "multipart", "multipart/* content type expected"
+        if "boundary" not in self._mimetype.parameters:
+            raise ValueError(
+                "boundary missed for Content-Type: %s" % headers[CONTENT_TYPE]
+            )
+
+        self.headers = headers
+        self._boundary = ("--" + self._get_boundary()).encode()
+        self._content = content
+        self._default_charset: Optional[str] = None
+        self._last_part: Optional[Union["MultipartReader", BodyPartReader]] = None
+        self._at_eof = False
+        self._at_bof = True
+        self._unread: List[bytes] = []
+
+    def __aiter__(
+        self,
+    ) -> AsyncIterator["BodyPartReader"]:
+        return self  # type: ignore[return-value]
+
+    async def __anext__(
+        self,
+    ) -> Optional[Union["MultipartReader", BodyPartReader]]:
+        part = await self.next()
+        if part is None:
+            raise StopAsyncIteration
+        return part
+
+    @classmethod
+    def from_response(
+        cls,
+        response: "ClientResponse",
+    ) -> MultipartResponseWrapper:
+        """Constructs reader instance from HTTP response.
+
+        :param response: :class:`~aiohttp.client.ClientResponse` instance
+        """
+        obj = cls.response_wrapper_cls(
+            response, cls(response.headers, response.content)
+        )
+        return obj
+
+    def at_eof(self) -> bool:
+        """Returns True if the final boundary was reached, false otherwise."""
+        return self._at_eof
+
+    async def next(
+        self,
+    ) -> Optional[Union["MultipartReader", BodyPartReader]]:
+        """Emits the next multipart body part."""
+        # So, if we're at BOF, we need to skip till the boundary.
+        if self._at_eof:
+            return None
+        await self._maybe_release_last_part()
+        if self._at_bof:
+            await self._read_until_first_boundary()
+            self._at_bof = False
+        else:
+            await self._read_boundary()
+        if self._at_eof:  # we just read the last boundary, nothing to do there
+            return None
+
+        part = await self.fetch_next_part()
+        # https://datatracker.ietf.org/doc/html/rfc7578#section-4.6
+        if (
+            self._last_part is None
+            and self._mimetype.subtype == "form-data"
+            and isinstance(part, BodyPartReader)
+        ):
+            _, params = parse_content_disposition(part.headers.get(CONTENT_DISPOSITION))
+            if params.get("name") == "_charset_":
+                # Longest encoding in https://encoding.spec.whatwg.org/encodings.json
+                # is 19 characters, so 32 should be more than enough for any valid encoding.
+                charset = await part.read_chunk(32)
+                if len(charset) > 31:
+                    raise RuntimeError("Invalid default charset")
+                self._default_charset = charset.strip().decode()
+                part = await self.fetch_next_part()
+        self._last_part = part
+        return self._last_part
+
+    async def release(self) -> None:
+        """Reads all the body parts to the void till the final boundary."""
+        while not self._at_eof:
+            item = await self.next()
+            if item is None:
+                break
+            await item.release()
+
+    async def fetch_next_part(
+        self,
+    ) -> Union["MultipartReader", BodyPartReader]:
+        """Returns the next body part reader."""
+        headers = await self._read_headers()
+        return self._get_part_reader(headers)
+
+    def _get_part_reader(
+        self,
+        headers: "CIMultiDictProxy[str]",
+    ) -> Union["MultipartReader", BodyPartReader]:
+        """Dispatches the response by the `Content-Type` header.
+
+        Returns a suitable reader instance.
+
+        :param dict headers: Response headers
+        """
+        ctype = headers.get(CONTENT_TYPE, "")
+        mimetype = parse_mimetype(ctype)
+
+        if mimetype.type == "multipart":
+            if self.multipart_reader_cls is None:
+                return type(self)(headers, self._content)
+            return self.multipart_reader_cls(headers, self._content)
+        else:
+            return self.part_reader_cls(
+                self._boundary,
+                headers,
+                self._content,
+                subtype=self._mimetype.subtype,
+                default_charset=self._default_charset,
+            )
+
+    def _get_boundary(self) -> str:
+        boundary = self._mimetype.parameters["boundary"]
+        if len(boundary) > 70:
+            raise ValueError("boundary %r is too long (70 chars max)" % boundary)
+
+        return boundary
+
+    async def _readline(self) -> bytes:
+        if self._unread:
+            return self._unread.pop()
+        return await self._content.readline()
+
+    async def _read_until_first_boundary(self) -> None:
+        while True:
+            chunk = await self._readline()
+            if chunk == b"":
+                raise ValueError(
+                    "Could not find starting boundary %r" % (self._boundary)
+                )
+            chunk = chunk.rstrip()
+            if chunk == self._boundary:
+                return
+            elif chunk == self._boundary + b"--":
+                self._at_eof = True
+                return
+
+    async def _read_boundary(self) -> None:
+        chunk = (await self._readline()).rstrip()
+        if chunk == self._boundary:
+            pass
+        elif chunk == self._boundary + b"--":
+            self._at_eof = True
+            epilogue = await self._readline()
+            next_line = await self._readline()
+
+            # the epilogue is expected and then either the end of input or the
+            # parent multipart boundary, if the parent boundary is found then
+            # it should be marked as unread and handed to the parent for
+            # processing
+            if next_line[:2] == b"--":
+                self._unread.append(next_line)
+            # otherwise the request is likely missing an epilogue and both
+            # lines should be passed to the parent for processing
+            # (this handles the old behavior gracefully)
+            else:
+                self._unread.extend([next_line, epilogue])
+        else:
+            raise ValueError(f"Invalid boundary {chunk!r}, expected {self._boundary!r}")
+
+    async def _read_headers(self) -> "CIMultiDictProxy[str]":
+        lines = [b""]
+        while True:
+            chunk = await self._content.readline()
+            chunk = chunk.strip()
+            lines.append(chunk)
+            if not chunk:
+                break
+        parser = HeadersParser()
+        headers, raw_headers = parser.parse_headers(lines)
+        return headers
+
+    async def _maybe_release_last_part(self) -> None:
+        """Ensures that the last read body part is read completely."""
+        if self._last_part is not None:
+            if not self._last_part.at_eof():
+                await self._last_part.release()
+            self._unread.extend(self._last_part._unread)
+            self._last_part = None
+
+
+_Part = Tuple[Payload, str, str]
+
+
+class MultipartWriter(Payload):
+    """Multipart body writer."""
+
+    def __init__(self, subtype: str = "mixed", boundary: Optional[str] = None) -> None:
+        boundary = boundary if boundary is not None else uuid.uuid4().hex
+        # The underlying Payload API demands a str (utf-8), not bytes,
+        # so we need to ensure we don't lose anything during conversion.
+        # As a result, require the boundary to be ASCII only.
+        # In both situations.
+
+        try:
+            self._boundary = boundary.encode("ascii")
+        except UnicodeEncodeError:
+            raise ValueError("boundary should contain ASCII only chars") from None
+        ctype = f"multipart/{subtype}; boundary={self._boundary_value}"
+
+        super().__init__(None, content_type=ctype)
+
+        self._parts: List[_Part] = []
+        self._is_form_data = subtype == "form-data"
+
+    def __enter__(self) -> "MultipartWriter":
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> None:
+        pass
+
+    def __iter__(self) -> Iterator[_Part]:
+        return iter(self._parts)
+
+    def __len__(self) -> int:
+        return len(self._parts)
+
+    def __bool__(self) -> bool:
+        return True
+
+    _valid_tchar_regex = re.compile(rb"\A[!#$%&'*+\-.^_`|~\w]+\Z")
+    _invalid_qdtext_char_regex = re.compile(rb"[\x00-\x08\x0A-\x1F\x7F]")
+
+    @property
+    def _boundary_value(self) -> str:
+        """Wrap boundary parameter value in quotes, if necessary.
+
+        Reads self.boundary and returns a unicode string.
+        """
+        # Refer to RFCs 7231, 7230, 5234.
+        #
+        # parameter      = token "=" ( token / quoted-string )
+        # token          = 1*tchar
+        # quoted-string  = DQUOTE *( qdtext / quoted-pair ) DQUOTE
+        # qdtext         = HTAB / SP / %x21 / %x23-5B / %x5D-7E / obs-text
+        # obs-text       = %x80-FF
+        # quoted-pair    = "\" ( HTAB / SP / VCHAR / obs-text )
+        # tchar          = "!" / "#" / "$" / "%" / "&" / "'" / "*"
+        #                  / "+" / "-" / "." / "^" / "_" / "`" / "|" / "~"
+        #                  / DIGIT / ALPHA
+        #                  ; any VCHAR, except delimiters
+        # VCHAR           = %x21-7E
+        value = self._boundary
+        if re.match(self._valid_tchar_regex, value):
+            return value.decode("ascii")  # cannot fail
+
+        if re.search(self._invalid_qdtext_char_regex, value):
+            raise ValueError("boundary value contains invalid characters")
+
+        # escape %x5C and %x22
+        quoted_value_content = value.replace(b"\\", b"\\\\")
+        quoted_value_content = quoted_value_content.replace(b'"', b'\\"')
+
+        return '"' + quoted_value_content.decode("ascii") + '"'
+
+    @property
+    def boundary(self) -> str:
+        return self._boundary.decode("ascii")
+
+    def append(self, obj: Any, headers: Optional[Mapping[str, str]] = None) -> Payload:
+        if headers is None:
+            headers = CIMultiDict()
+
+        if isinstance(obj, Payload):
+            obj.headers.update(headers)
+            return self.append_payload(obj)
+        else:
+            try:
+                payload = get_payload(obj, headers=headers)
+            except LookupError:
+                raise TypeError("Cannot create payload from %r" % obj)
+            else:
+                return self.append_payload(payload)
+
+    def append_payload(self, payload: Payload) -> Payload:
+        """Adds a new body part to multipart writer."""
+        encoding: Optional[str] = None
+        te_encoding: Optional[str] = None
+        if self._is_form_data:
+            # https://datatracker.ietf.org/doc/html/rfc7578#section-4.7
+            # https://datatracker.ietf.org/doc/html/rfc7578#section-4.8
+            assert (
+                not {CONTENT_ENCODING, CONTENT_LENGTH, CONTENT_TRANSFER_ENCODING}
+                & payload.headers.keys()
+            )
+            # Set default Content-Disposition in case user doesn't create one
+            if CONTENT_DISPOSITION not in payload.headers:
+                name = f"section-{len(self._parts)}"
+                payload.set_content_disposition("form-data", name=name)
+        else:
+            # compression
+            encoding = payload.headers.get(CONTENT_ENCODING, "").lower()
+            if encoding and encoding not in ("deflate", "gzip", "identity"):
+                raise RuntimeError(f"unknown content encoding: {encoding}")
+            if encoding == "identity":
+                encoding = None
+
+            # te encoding
+            te_encoding = payload.headers.get(CONTENT_TRANSFER_ENCODING, "").lower()
+            if te_encoding not in ("", "base64", "quoted-printable", "binary"):
+                raise RuntimeError(f"unknown content transfer encoding: {te_encoding}")
+            if te_encoding == "binary":
+                te_encoding = None
+
+            # size
+            size = payload.size
+            if size is not None and not (encoding or te_encoding):
+                payload.headers[CONTENT_LENGTH] = str(size)
+
+        self._parts.append((payload, encoding, te_encoding))  # type: ignore[arg-type]
+        return payload
+
+    def append_json(
+        self, obj: Any, headers: Optional[Mapping[str, str]] = None
+    ) -> Payload:
+        """Helper to append JSON part."""
+        if headers is None:
+            headers = CIMultiDict()
+
+        return self.append_payload(JsonPayload(obj, headers=headers))
+
+    def append_form(
+        self,
+        obj: Union[Sequence[Tuple[str, str]], Mapping[str, str]],
+        headers: Optional[Mapping[str, str]] = None,
+    ) -> Payload:
+        """Helper to append form urlencoded part."""
+        assert isinstance(obj, (Sequence, Mapping))
+
+        if headers is None:
+            headers = CIMultiDict()
+
+        if isinstance(obj, Mapping):
+            obj = list(obj.items())
+        data = urlencode(obj, doseq=True)
+
+        return self.append_payload(
+            StringPayload(
+                data, headers=headers, content_type="application/x-www-form-urlencoded"
+            )
+        )
+
+    @property
+    def size(self) -> Optional[int]:
+        """Size of the payload."""
+        total = 0
+        for part, encoding, te_encoding in self._parts:
+            if encoding or te_encoding or part.size is None:
+                return None
+
+            total += int(
+                2
+                + len(self._boundary)
+                + 2
+                + part.size  # b'--'+self._boundary+b'\r\n'
+                + len(part._binary_headers)
+                + 2  # b'\r\n'
+            )
+
+        total += 2 + len(self._boundary) + 4  # b'--'+self._boundary+b'--\r\n'
+        return total
+
+    async def write(self, writer: Any, close_boundary: bool = True) -> None:
+        """Write body."""
+        for part, encoding, te_encoding in self._parts:
+            if self._is_form_data:
+                # https://datatracker.ietf.org/doc/html/rfc7578#section-4.2
+                assert CONTENT_DISPOSITION in part.headers
+                assert "name=" in part.headers[CONTENT_DISPOSITION]
+
+            await writer.write(b"--" + self._boundary + b"\r\n")
+            await writer.write(part._binary_headers)
+
+            if encoding or te_encoding:
+                w = MultipartPayloadWriter(writer)
+                if encoding:
+                    w.enable_compression(encoding)
+                if te_encoding:
+                    w.enable_encoding(te_encoding)
+                await part.write(w)  # type: ignore[arg-type]
+                await w.write_eof()
+            else:
+                await part.write(writer)
+
+            await writer.write(b"\r\n")
+
+        if close_boundary:
+            await writer.write(b"--" + self._boundary + b"--\r\n")
+
+
+class MultipartPayloadWriter:
+    def __init__(self, writer: Any) -> None:
+        self._writer = writer
+        self._encoding: Optional[str] = None
+        self._compress: Optional[ZLibCompressor] = None
+        self._encoding_buffer: Optional[bytearray] = None
+
+    def enable_encoding(self, encoding: str) -> None:
+        if encoding == "base64":
+            self._encoding = encoding
+            self._encoding_buffer = bytearray()
+        elif encoding == "quoted-printable":
+            self._encoding = "quoted-printable"
+
+    def enable_compression(
+        self, encoding: str = "deflate", strategy: int = zlib.Z_DEFAULT_STRATEGY
+    ) -> None:
+        self._compress = ZLibCompressor(
+            encoding=encoding,
+            suppress_deflate_header=True,
+            strategy=strategy,
+        )
+
+    async def write_eof(self) -> None:
+        if self._compress is not None:
+            chunk = self._compress.flush()
+            if chunk:
+                self._compress = None
+                await self.write(chunk)
+
+        if self._encoding == "base64":
+            if self._encoding_buffer:
+                await self._writer.write(base64.b64encode(self._encoding_buffer))
+
+    async def write(self, chunk: bytes) -> None:
+        if self._compress is not None:
+            if chunk:
+                chunk = await self._compress.compress(chunk)
+                if not chunk:
+                    return
+
+        if self._encoding == "base64":
+            buf = self._encoding_buffer
+            assert buf is not None
+            buf.extend(chunk)
+
+            if buf:
+                div, mod = divmod(len(buf), 3)
+                enc_chunk, self._encoding_buffer = (buf[: div * 3], buf[div * 3 :])
+                if enc_chunk:
+                    b64chunk = base64.b64encode(enc_chunk)
+                    await self._writer.write(b64chunk)
+        elif self._encoding == "quoted-printable":
+            await self._writer.write(binascii.b2a_qp(chunk))
+        else:
+            await self._writer.write(chunk)
diff --git a/llm/Lib/site-packages/aiohttp/payload.py b/llm/Lib/site-packages/aiohttp/payload.py
new file mode 100644
index 0000000000000000000000000000000000000000..7d6668728805651ce61f25051cb8feb872fbe86d
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/payload.py
@@ -0,0 +1,463 @@
+import asyncio
+import enum
+import io
+import json
+import mimetypes
+import os
+import warnings
+from abc import ABC, abstractmethod
+from itertools import chain
+from typing import (
+    IO,
+    TYPE_CHECKING,
+    Any,
+    ByteString,
+    Dict,
+    Final,
+    Iterable,
+    Optional,
+    TextIO,
+    Tuple,
+    Type,
+    Union,
+)
+
+from multidict import CIMultiDict
+
+from . import hdrs
+from .abc import AbstractStreamWriter
+from .helpers import (
+    _SENTINEL,
+    content_disposition_header,
+    guess_filename,
+    parse_mimetype,
+    sentinel,
+)
+from .streams import StreamReader
+from .typedefs import JSONEncoder, _CIMultiDict
+
+__all__ = (
+    "PAYLOAD_REGISTRY",
+    "get_payload",
+    "payload_type",
+    "Payload",
+    "BytesPayload",
+    "StringPayload",
+    "IOBasePayload",
+    "BytesIOPayload",
+    "BufferedReaderPayload",
+    "TextIOPayload",
+    "StringIOPayload",
+    "JsonPayload",
+    "AsyncIterablePayload",
+)
+
+TOO_LARGE_BYTES_BODY: Final[int] = 2**20  # 1 MB
+
+if TYPE_CHECKING:
+    from typing import List
+
+
+class LookupError(Exception):
+    pass
+
+
+class Order(str, enum.Enum):
+    normal = "normal"
+    try_first = "try_first"
+    try_last = "try_last"
+
+
+def get_payload(data: Any, *args: Any, **kwargs: Any) -> "Payload":
+    return PAYLOAD_REGISTRY.get(data, *args, **kwargs)
+
+
+def register_payload(
+    factory: Type["Payload"], type: Any, *, order: Order = Order.normal
+) -> None:
+    PAYLOAD_REGISTRY.register(factory, type, order=order)
+
+
+class payload_type:
+    def __init__(self, type: Any, *, order: Order = Order.normal) -> None:
+        self.type = type
+        self.order = order
+
+    def __call__(self, factory: Type["Payload"]) -> Type["Payload"]:
+        register_payload(factory, self.type, order=self.order)
+        return factory
+
+
+PayloadType = Type["Payload"]
+_PayloadRegistryItem = Tuple[PayloadType, Any]
+
+
+class PayloadRegistry:
+    """Payload registry.
+
+    note: we need zope.interface for more efficient adapter search
+    """
+
+    def __init__(self) -> None:
+        self._first: List[_PayloadRegistryItem] = []
+        self._normal: List[_PayloadRegistryItem] = []
+        self._last: List[_PayloadRegistryItem] = []
+
+    def get(
+        self,
+        data: Any,
+        *args: Any,
+        _CHAIN: "Type[chain[_PayloadRegistryItem]]" = chain,
+        **kwargs: Any,
+    ) -> "Payload":
+        if isinstance(data, Payload):
+            return data
+        for factory, type in _CHAIN(self._first, self._normal, self._last):
+            if isinstance(data, type):
+                return factory(data, *args, **kwargs)
+
+        raise LookupError()
+
+    def register(
+        self, factory: PayloadType, type: Any, *, order: Order = Order.normal
+    ) -> None:
+        if order is Order.try_first:
+            self._first.append((factory, type))
+        elif order is Order.normal:
+            self._normal.append((factory, type))
+        elif order is Order.try_last:
+            self._last.append((factory, type))
+        else:
+            raise ValueError(f"Unsupported order {order!r}")
+
+
+class Payload(ABC):
+
+    _default_content_type: str = "application/octet-stream"
+    _size: Optional[int] = None
+
+    def __init__(
+        self,
+        value: Any,
+        headers: Optional[
+            Union[_CIMultiDict, Dict[str, str], Iterable[Tuple[str, str]]]
+        ] = None,
+        content_type: Union[str, None, _SENTINEL] = sentinel,
+        filename: Optional[str] = None,
+        encoding: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        self._encoding = encoding
+        self._filename = filename
+        self._headers: _CIMultiDict = CIMultiDict()
+        self._value = value
+        if content_type is not sentinel and content_type is not None:
+            self._headers[hdrs.CONTENT_TYPE] = content_type
+        elif self._filename is not None:
+            content_type = mimetypes.guess_type(self._filename)[0]
+            if content_type is None:
+                content_type = self._default_content_type
+            self._headers[hdrs.CONTENT_TYPE] = content_type
+        else:
+            self._headers[hdrs.CONTENT_TYPE] = self._default_content_type
+        self._headers.update(headers or {})
+
+    @property
+    def size(self) -> Optional[int]:
+        """Size of the payload."""
+        return self._size
+
+    @property
+    def filename(self) -> Optional[str]:
+        """Filename of the payload."""
+        return self._filename
+
+    @property
+    def headers(self) -> _CIMultiDict:
+        """Custom item headers"""
+        return self._headers
+
+    @property
+    def _binary_headers(self) -> bytes:
+        return (
+            "".join([k + ": " + v + "\r\n" for k, v in self.headers.items()]).encode(
+                "utf-8"
+            )
+            + b"\r\n"
+        )
+
+    @property
+    def encoding(self) -> Optional[str]:
+        """Payload encoding"""
+        return self._encoding
+
+    @property
+    def content_type(self) -> str:
+        """Content type"""
+        return self._headers[hdrs.CONTENT_TYPE]
+
+    def set_content_disposition(
+        self,
+        disptype: str,
+        quote_fields: bool = True,
+        _charset: str = "utf-8",
+        **params: Any,
+    ) -> None:
+        """Sets ``Content-Disposition`` header."""
+        self._headers[hdrs.CONTENT_DISPOSITION] = content_disposition_header(
+            disptype, quote_fields=quote_fields, _charset=_charset, **params
+        )
+
+    @abstractmethod
+    async def write(self, writer: AbstractStreamWriter) -> None:
+        """Write payload.
+
+        writer is an AbstractStreamWriter instance:
+        """
+
+
+class BytesPayload(Payload):
+    def __init__(self, value: ByteString, *args: Any, **kwargs: Any) -> None:
+        if not isinstance(value, (bytes, bytearray, memoryview)):
+            raise TypeError(f"value argument must be byte-ish, not {type(value)!r}")
+
+        if "content_type" not in kwargs:
+            kwargs["content_type"] = "application/octet-stream"
+
+        super().__init__(value, *args, **kwargs)
+
+        if isinstance(value, memoryview):
+            self._size = value.nbytes
+        else:
+            self._size = len(value)
+
+        if self._size > TOO_LARGE_BYTES_BODY:
+            kwargs = {"source": self}
+            warnings.warn(
+                "Sending a large body directly with raw bytes might"
+                " lock the event loop. You should probably pass an "
+                "io.BytesIO object instead",
+                ResourceWarning,
+                **kwargs,
+            )
+
+    async def write(self, writer: AbstractStreamWriter) -> None:
+        await writer.write(self._value)
+
+
+class StringPayload(BytesPayload):
+    def __init__(
+        self,
+        value: str,
+        *args: Any,
+        encoding: Optional[str] = None,
+        content_type: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+
+        if encoding is None:
+            if content_type is None:
+                real_encoding = "utf-8"
+                content_type = "text/plain; charset=utf-8"
+            else:
+                mimetype = parse_mimetype(content_type)
+                real_encoding = mimetype.parameters.get("charset", "utf-8")
+        else:
+            if content_type is None:
+                content_type = "text/plain; charset=%s" % encoding
+            real_encoding = encoding
+
+        super().__init__(
+            value.encode(real_encoding),
+            encoding=real_encoding,
+            content_type=content_type,
+            *args,
+            **kwargs,
+        )
+
+
+class StringIOPayload(StringPayload):
+    def __init__(self, value: IO[str], *args: Any, **kwargs: Any) -> None:
+        super().__init__(value.read(), *args, **kwargs)
+
+
+class IOBasePayload(Payload):
+    _value: IO[Any]
+
+    def __init__(
+        self, value: IO[Any], disposition: str = "attachment", *args: Any, **kwargs: Any
+    ) -> None:
+        if "filename" not in kwargs:
+            kwargs["filename"] = guess_filename(value)
+
+        super().__init__(value, *args, **kwargs)
+
+        if self._filename is not None and disposition is not None:
+            if hdrs.CONTENT_DISPOSITION not in self.headers:
+                self.set_content_disposition(disposition, filename=self._filename)
+
+    async def write(self, writer: AbstractStreamWriter) -> None:
+        loop = asyncio.get_event_loop()
+        try:
+            chunk = await loop.run_in_executor(None, self._value.read, 2**16)
+            while chunk:
+                await writer.write(chunk)
+                chunk = await loop.run_in_executor(None, self._value.read, 2**16)
+        finally:
+            await loop.run_in_executor(None, self._value.close)
+
+
+class TextIOPayload(IOBasePayload):
+    _value: TextIO
+
+    def __init__(
+        self,
+        value: TextIO,
+        *args: Any,
+        encoding: Optional[str] = None,
+        content_type: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+
+        if encoding is None:
+            if content_type is None:
+                encoding = "utf-8"
+                content_type = "text/plain; charset=utf-8"
+            else:
+                mimetype = parse_mimetype(content_type)
+                encoding = mimetype.parameters.get("charset", "utf-8")
+        else:
+            if content_type is None:
+                content_type = "text/plain; charset=%s" % encoding
+
+        super().__init__(
+            value,
+            content_type=content_type,
+            encoding=encoding,
+            *args,
+            **kwargs,
+        )
+
+    @property
+    def size(self) -> Optional[int]:
+        try:
+            return os.fstat(self._value.fileno()).st_size - self._value.tell()
+        except OSError:
+            return None
+
+    async def write(self, writer: AbstractStreamWriter) -> None:
+        loop = asyncio.get_event_loop()
+        try:
+            chunk = await loop.run_in_executor(None, self._value.read, 2**16)
+            while chunk:
+                data = (
+                    chunk.encode(encoding=self._encoding)
+                    if self._encoding
+                    else chunk.encode()
+                )
+                await writer.write(data)
+                chunk = await loop.run_in_executor(None, self._value.read, 2**16)
+        finally:
+            await loop.run_in_executor(None, self._value.close)
+
+
+class BytesIOPayload(IOBasePayload):
+    @property
+    def size(self) -> int:
+        position = self._value.tell()
+        end = self._value.seek(0, os.SEEK_END)
+        self._value.seek(position)
+        return end - position
+
+
+class BufferedReaderPayload(IOBasePayload):
+    @property
+    def size(self) -> Optional[int]:
+        try:
+            return os.fstat(self._value.fileno()).st_size - self._value.tell()
+        except OSError:
+            # data.fileno() is not supported, e.g.
+            # io.BufferedReader(io.BytesIO(b'data'))
+            return None
+
+
+class JsonPayload(BytesPayload):
+    def __init__(
+        self,
+        value: Any,
+        encoding: str = "utf-8",
+        content_type: str = "application/json",
+        dumps: JSONEncoder = json.dumps,
+        *args: Any,
+        **kwargs: Any,
+    ) -> None:
+
+        super().__init__(
+            dumps(value).encode(encoding),
+            content_type=content_type,
+            encoding=encoding,
+            *args,
+            **kwargs,
+        )
+
+
+if TYPE_CHECKING:
+    from typing import AsyncIterable, AsyncIterator
+
+    _AsyncIterator = AsyncIterator[bytes]
+    _AsyncIterable = AsyncIterable[bytes]
+else:
+    from collections.abc import AsyncIterable, AsyncIterator
+
+    _AsyncIterator = AsyncIterator
+    _AsyncIterable = AsyncIterable
+
+
+class AsyncIterablePayload(Payload):
+
+    _iter: Optional[_AsyncIterator] = None
+
+    def __init__(self, value: _AsyncIterable, *args: Any, **kwargs: Any) -> None:
+        if not isinstance(value, AsyncIterable):
+            raise TypeError(
+                "value argument must support "
+                "collections.abc.AsyncIterable interface, "
+                "got {!r}".format(type(value))
+            )
+
+        if "content_type" not in kwargs:
+            kwargs["content_type"] = "application/octet-stream"
+
+        super().__init__(value, *args, **kwargs)
+
+        self._iter = value.__aiter__()
+
+    async def write(self, writer: AbstractStreamWriter) -> None:
+        if self._iter:
+            try:
+                # iter is not None check prevents rare cases
+                # when the case iterable is used twice
+                while True:
+                    chunk = await self._iter.__anext__()
+                    await writer.write(chunk)
+            except StopAsyncIteration:
+                self._iter = None
+
+
+class StreamReaderPayload(AsyncIterablePayload):
+    def __init__(self, value: StreamReader, *args: Any, **kwargs: Any) -> None:
+        super().__init__(value.iter_any(), *args, **kwargs)
+
+
+PAYLOAD_REGISTRY = PayloadRegistry()
+PAYLOAD_REGISTRY.register(BytesPayload, (bytes, bytearray, memoryview))
+PAYLOAD_REGISTRY.register(StringPayload, str)
+PAYLOAD_REGISTRY.register(StringIOPayload, io.StringIO)
+PAYLOAD_REGISTRY.register(TextIOPayload, io.TextIOBase)
+PAYLOAD_REGISTRY.register(BytesIOPayload, io.BytesIO)
+PAYLOAD_REGISTRY.register(BufferedReaderPayload, (io.BufferedReader, io.BufferedRandom))
+PAYLOAD_REGISTRY.register(IOBasePayload, io.IOBase)
+PAYLOAD_REGISTRY.register(StreamReaderPayload, StreamReader)
+# try_last for giving a chance to more specialized async interables like
+# multidict.BodyPartReaderPayload override the default
+PAYLOAD_REGISTRY.register(AsyncIterablePayload, AsyncIterable, order=Order.try_last)
diff --git a/llm/Lib/site-packages/aiohttp/payload_streamer.py b/llm/Lib/site-packages/aiohttp/payload_streamer.py
new file mode 100644
index 0000000000000000000000000000000000000000..534cda39f60aff26159df82f5d593c249d92e4f0
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/payload_streamer.py
@@ -0,0 +1,75 @@
+"""
+Payload implementation for coroutines as data provider.
+
+As a simple case, you can upload data from file::
+
+   @aiohttp.streamer
+   async def file_sender(writer, file_name=None):
+      with open(file_name, 'rb') as f:
+          chunk = f.read(2**16)
+          while chunk:
+              await writer.write(chunk)
+
+              chunk = f.read(2**16)
+
+Then you can use `file_sender` like this:
+
+    async with session.post('http://httpbin.org/post',
+                            data=file_sender(file_name='huge_file')) as resp:
+        print(await resp.text())
+
+..note:: Coroutine must accept `writer` as first argument
+
+"""
+
+import types
+import warnings
+from typing import Any, Awaitable, Callable, Dict, Tuple
+
+from .abc import AbstractStreamWriter
+from .payload import Payload, payload_type
+
+__all__ = ("streamer",)
+
+
+class _stream_wrapper:
+    def __init__(
+        self,
+        coro: Callable[..., Awaitable[None]],
+        args: Tuple[Any, ...],
+        kwargs: Dict[str, Any],
+    ) -> None:
+        self.coro = types.coroutine(coro)
+        self.args = args
+        self.kwargs = kwargs
+
+    async def __call__(self, writer: AbstractStreamWriter) -> None:
+        await self.coro(writer, *self.args, **self.kwargs)
+
+
+class streamer:
+    def __init__(self, coro: Callable[..., Awaitable[None]]) -> None:
+        warnings.warn(
+            "@streamer is deprecated, use async generators instead",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        self.coro = coro
+
+    def __call__(self, *args: Any, **kwargs: Any) -> _stream_wrapper:
+        return _stream_wrapper(self.coro, args, kwargs)
+
+
+@payload_type(_stream_wrapper)
+class StreamWrapperPayload(Payload):
+    async def write(self, writer: AbstractStreamWriter) -> None:
+        await self._value(writer)
+
+
+@payload_type(streamer)
+class StreamPayload(StreamWrapperPayload):
+    def __init__(self, value: Any, *args: Any, **kwargs: Any) -> None:
+        super().__init__(value(), *args, **kwargs)
+
+    async def write(self, writer: AbstractStreamWriter) -> None:
+        await self._value(writer)
diff --git a/llm/Lib/site-packages/aiohttp/py.typed b/llm/Lib/site-packages/aiohttp/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..1d9f9a52a2f18944337009f77ba0d3cee2752144
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/py.typed
@@ -0,0 +1 @@
+Marker
diff --git a/llm/Lib/site-packages/aiohttp/pytest_plugin.py b/llm/Lib/site-packages/aiohttp/pytest_plugin.py
new file mode 100644
index 0000000000000000000000000000000000000000..cf83f832532a782bf6b010c0a75668fac5154c89
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/pytest_plugin.py
@@ -0,0 +1,381 @@
+import asyncio
+import contextlib
+import warnings
+from typing import Any, Awaitable, Callable, Dict, Iterator, Optional, Type, Union
+
+import pytest
+
+from aiohttp.helpers import isasyncgenfunction
+from aiohttp.web import Application
+
+from .test_utils import (
+    BaseTestServer,
+    RawTestServer,
+    TestClient,
+    TestServer,
+    loop_context,
+    setup_test_loop,
+    teardown_test_loop,
+    unused_port as _unused_port,
+)
+
+try:
+    import uvloop
+except ImportError:  # pragma: no cover
+    uvloop = None  # type: ignore[assignment]
+
+AiohttpClient = Callable[[Union[Application, BaseTestServer]], Awaitable[TestClient]]
+AiohttpRawServer = Callable[[Application], Awaitable[RawTestServer]]
+AiohttpServer = Callable[[Application], Awaitable[TestServer]]
+
+
+def pytest_addoption(parser):  # type: ignore[no-untyped-def]
+    parser.addoption(
+        "--aiohttp-fast",
+        action="store_true",
+        default=False,
+        help="run tests faster by disabling extra checks",
+    )
+    parser.addoption(
+        "--aiohttp-loop",
+        action="store",
+        default="pyloop",
+        help="run tests with specific loop: pyloop, uvloop or all",
+    )
+    parser.addoption(
+        "--aiohttp-enable-loop-debug",
+        action="store_true",
+        default=False,
+        help="enable event loop debug mode",
+    )
+
+
+def pytest_fixture_setup(fixturedef):  # type: ignore[no-untyped-def]
+    """Set up pytest fixture.
+
+    Allow fixtures to be coroutines. Run coroutine fixtures in an event loop.
+    """
+    func = fixturedef.func
+
+    if isasyncgenfunction(func):
+        # async generator fixture
+        is_async_gen = True
+    elif asyncio.iscoroutinefunction(func):
+        # regular async fixture
+        is_async_gen = False
+    else:
+        # not an async fixture, nothing to do
+        return
+
+    strip_request = False
+    if "request" not in fixturedef.argnames:
+        fixturedef.argnames += ("request",)
+        strip_request = True
+
+    def wrapper(*args, **kwargs):  # type: ignore[no-untyped-def]
+        request = kwargs["request"]
+        if strip_request:
+            del kwargs["request"]
+
+        # if neither the fixture nor the test use the 'loop' fixture,
+        # 'getfixturevalue' will fail because the test is not parameterized
+        # (this can be removed someday if 'loop' is no longer parameterized)
+        if "loop" not in request.fixturenames:
+            raise Exception(
+                "Asynchronous fixtures must depend on the 'loop' fixture or "
+                "be used in tests depending from it."
+            )
+
+        _loop = request.getfixturevalue("loop")
+
+        if is_async_gen:
+            # for async generators, we need to advance the generator once,
+            # then advance it again in a finalizer
+            gen = func(*args, **kwargs)
+
+            def finalizer():  # type: ignore[no-untyped-def]
+                try:
+                    return _loop.run_until_complete(gen.__anext__())
+                except StopAsyncIteration:
+                    pass
+
+            request.addfinalizer(finalizer)
+            return _loop.run_until_complete(gen.__anext__())
+        else:
+            return _loop.run_until_complete(func(*args, **kwargs))
+
+    fixturedef.func = wrapper
+
+
+@pytest.fixture
+def fast(request):  # type: ignore[no-untyped-def]
+    """--fast config option"""
+    return request.config.getoption("--aiohttp-fast")
+
+
+@pytest.fixture
+def loop_debug(request):  # type: ignore[no-untyped-def]
+    """--enable-loop-debug config option"""
+    return request.config.getoption("--aiohttp-enable-loop-debug")
+
+
+@contextlib.contextmanager
+def _runtime_warning_context():  # type: ignore[no-untyped-def]
+    """Context manager which checks for RuntimeWarnings.
+
+    This exists specifically to
+    avoid "coroutine 'X' was never awaited" warnings being missed.
+
+    If RuntimeWarnings occur in the context a RuntimeError is raised.
+    """
+    with warnings.catch_warnings(record=True) as _warnings:
+        yield
+        rw = [
+            "{w.filename}:{w.lineno}:{w.message}".format(w=w)
+            for w in _warnings
+            if w.category == RuntimeWarning
+        ]
+        if rw:
+            raise RuntimeError(
+                "{} Runtime Warning{},\n{}".format(
+                    len(rw), "" if len(rw) == 1 else "s", "\n".join(rw)
+                )
+            )
+
+
+@contextlib.contextmanager
+def _passthrough_loop_context(loop, fast=False):  # type: ignore[no-untyped-def]
+    """Passthrough loop context.
+
+    Sets up and tears down a loop unless one is passed in via the loop
+    argument when it's passed straight through.
+    """
+    if loop:
+        # loop already exists, pass it straight through
+        yield loop
+    else:
+        # this shadows loop_context's standard behavior
+        loop = setup_test_loop()
+        yield loop
+        teardown_test_loop(loop, fast=fast)
+
+
+def pytest_pycollect_makeitem(collector, name, obj):  # type: ignore[no-untyped-def]
+    """Fix pytest collecting for coroutines."""
+    if collector.funcnamefilter(name) and asyncio.iscoroutinefunction(obj):
+        return list(collector._genfunctions(name, obj))
+
+
+def pytest_pyfunc_call(pyfuncitem):  # type: ignore[no-untyped-def]
+    """Run coroutines in an event loop instead of a normal function call."""
+    fast = pyfuncitem.config.getoption("--aiohttp-fast")
+    if asyncio.iscoroutinefunction(pyfuncitem.function):
+        existing_loop = pyfuncitem.funcargs.get(
+            "proactor_loop"
+        ) or pyfuncitem.funcargs.get("loop", None)
+        with _runtime_warning_context():
+            with _passthrough_loop_context(existing_loop, fast=fast) as _loop:
+                testargs = {
+                    arg: pyfuncitem.funcargs[arg]
+                    for arg in pyfuncitem._fixtureinfo.argnames
+                }
+                _loop.run_until_complete(pyfuncitem.obj(**testargs))
+
+        return True
+
+
+def pytest_generate_tests(metafunc):  # type: ignore[no-untyped-def]
+    if "loop_factory" not in metafunc.fixturenames:
+        return
+
+    loops = metafunc.config.option.aiohttp_loop
+    avail_factories: Dict[str, Type[asyncio.AbstractEventLoopPolicy]]
+    avail_factories = {"pyloop": asyncio.DefaultEventLoopPolicy}
+
+    if uvloop is not None:  # pragma: no cover
+        avail_factories["uvloop"] = uvloop.EventLoopPolicy
+
+    if loops == "all":
+        loops = "pyloop,uvloop?"
+
+    factories = {}  # type: ignore[var-annotated]
+    for name in loops.split(","):
+        required = not name.endswith("?")
+        name = name.strip(" ?")
+        if name not in avail_factories:  # pragma: no cover
+            if required:
+                raise ValueError(
+                    "Unknown loop '%s', available loops: %s"
+                    % (name, list(factories.keys()))
+                )
+            else:
+                continue
+        factories[name] = avail_factories[name]
+    metafunc.parametrize(
+        "loop_factory", list(factories.values()), ids=list(factories.keys())
+    )
+
+
+@pytest.fixture
+def loop(loop_factory, fast, loop_debug):  # type: ignore[no-untyped-def]
+    """Return an instance of the event loop."""
+    policy = loop_factory()
+    asyncio.set_event_loop_policy(policy)
+    with loop_context(fast=fast) as _loop:
+        if loop_debug:
+            _loop.set_debug(True)  # pragma: no cover
+        asyncio.set_event_loop(_loop)
+        yield _loop
+
+
+@pytest.fixture
+def proactor_loop():  # type: ignore[no-untyped-def]
+    policy = asyncio.WindowsProactorEventLoopPolicy()  # type: ignore[attr-defined]
+    asyncio.set_event_loop_policy(policy)
+
+    with loop_context(policy.new_event_loop) as _loop:
+        asyncio.set_event_loop(_loop)
+        yield _loop
+
+
+@pytest.fixture
+def unused_port(aiohttp_unused_port: Callable[[], int]) -> Callable[[], int]:
+    warnings.warn(
+        "Deprecated, use aiohttp_unused_port fixture instead",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return aiohttp_unused_port
+
+
+@pytest.fixture
+def aiohttp_unused_port() -> Callable[[], int]:
+    """Return a port that is unused on the current host."""
+    return _unused_port
+
+
+@pytest.fixture
+def aiohttp_server(loop: asyncio.AbstractEventLoop) -> Iterator[AiohttpServer]:
+    """Factory to create a TestServer instance, given an app.
+
+    aiohttp_server(app, **kwargs)
+    """
+    servers = []
+
+    async def go(app, *, port=None, **kwargs):  # type: ignore[no-untyped-def]
+        server = TestServer(app, port=port)
+        await server.start_server(loop=loop, **kwargs)
+        servers.append(server)
+        return server
+
+    yield go
+
+    async def finalize() -> None:
+        while servers:
+            await servers.pop().close()
+
+    loop.run_until_complete(finalize())
+
+
+@pytest.fixture
+def test_server(aiohttp_server):  # type: ignore[no-untyped-def]  # pragma: no cover
+    warnings.warn(
+        "Deprecated, use aiohttp_server fixture instead",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return aiohttp_server
+
+
+@pytest.fixture
+def aiohttp_raw_server(loop: asyncio.AbstractEventLoop) -> Iterator[AiohttpRawServer]:
+    """Factory to create a RawTestServer instance, given a web handler.
+
+    aiohttp_raw_server(handler, **kwargs)
+    """
+    servers = []
+
+    async def go(handler, *, port=None, **kwargs):  # type: ignore[no-untyped-def]
+        server = RawTestServer(handler, port=port)
+        await server.start_server(loop=loop, **kwargs)
+        servers.append(server)
+        return server
+
+    yield go
+
+    async def finalize() -> None:
+        while servers:
+            await servers.pop().close()
+
+    loop.run_until_complete(finalize())
+
+
+@pytest.fixture
+def raw_test_server(  # type: ignore[no-untyped-def]  # pragma: no cover
+    aiohttp_raw_server,
+):
+    warnings.warn(
+        "Deprecated, use aiohttp_raw_server fixture instead",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return aiohttp_raw_server
+
+
+@pytest.fixture
+def aiohttp_client(
+    loop: asyncio.AbstractEventLoop,
+) -> Iterator[AiohttpClient]:
+    """Factory to create a TestClient instance.
+
+    aiohttp_client(app, **kwargs)
+    aiohttp_client(server, **kwargs)
+    aiohttp_client(raw_server, **kwargs)
+    """
+    clients = []
+
+    async def go(
+        __param: Union[Application, BaseTestServer],
+        *args: Any,
+        server_kwargs: Optional[Dict[str, Any]] = None,
+        **kwargs: Any
+    ) -> TestClient:
+
+        if isinstance(__param, Callable) and not isinstance(  # type: ignore[arg-type]
+            __param, (Application, BaseTestServer)
+        ):
+            __param = __param(loop, *args, **kwargs)
+            kwargs = {}
+        else:
+            assert not args, "args should be empty"
+
+        if isinstance(__param, Application):
+            server_kwargs = server_kwargs or {}
+            server = TestServer(__param, loop=loop, **server_kwargs)
+            client = TestClient(server, loop=loop, **kwargs)
+        elif isinstance(__param, BaseTestServer):
+            client = TestClient(__param, loop=loop, **kwargs)
+        else:
+            raise ValueError("Unknown argument type: %r" % type(__param))
+
+        await client.start_server()
+        clients.append(client)
+        return client
+
+    yield go
+
+    async def finalize() -> None:
+        while clients:
+            await clients.pop().close()
+
+    loop.run_until_complete(finalize())
+
+
+@pytest.fixture
+def test_client(aiohttp_client):  # type: ignore[no-untyped-def]  # pragma: no cover
+    warnings.warn(
+        "Deprecated, use aiohttp_client fixture instead",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return aiohttp_client
diff --git a/llm/Lib/site-packages/aiohttp/resolver.py b/llm/Lib/site-packages/aiohttp/resolver.py
new file mode 100644
index 0000000000000000000000000000000000000000..a1e166134c7985c590df592f90bbd4a56171376b
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/resolver.py
@@ -0,0 +1,160 @@
+import asyncio
+import socket
+from typing import Any, Dict, List, Optional, Type, Union
+
+from .abc import AbstractResolver
+from .helpers import get_running_loop
+
+__all__ = ("ThreadedResolver", "AsyncResolver", "DefaultResolver")
+
+try:
+    import aiodns
+
+    # aiodns_default = hasattr(aiodns.DNSResolver, 'gethostbyname')
+except ImportError:  # pragma: no cover
+    aiodns = None
+
+aiodns_default = False
+
+
+class ThreadedResolver(AbstractResolver):
+    """Threaded resolver.
+
+    Uses an Executor for synchronous getaddrinfo() calls.
+    concurrent.futures.ThreadPoolExecutor is used by default.
+    """
+
+    def __init__(self, loop: Optional[asyncio.AbstractEventLoop] = None) -> None:
+        self._loop = get_running_loop(loop)
+
+    async def resolve(
+        self, hostname: str, port: int = 0, family: int = socket.AF_INET
+    ) -> List[Dict[str, Any]]:
+        infos = await self._loop.getaddrinfo(
+            hostname,
+            port,
+            type=socket.SOCK_STREAM,
+            family=family,
+            flags=socket.AI_ADDRCONFIG,
+        )
+
+        hosts = []
+        for family, _, proto, _, address in infos:
+            if family == socket.AF_INET6:
+                if len(address) < 3:
+                    # IPv6 is not supported by Python build,
+                    # or IPv6 is not enabled in the host
+                    continue
+                if address[3]:
+                    # This is essential for link-local IPv6 addresses.
+                    # LL IPv6 is a VERY rare case. Strictly speaking, we should use
+                    # getnameinfo() unconditionally, but performance makes sense.
+                    host, _port = socket.getnameinfo(
+                        address, socket.NI_NUMERICHOST | socket.NI_NUMERICSERV
+                    )
+                    port = int(_port)
+                else:
+                    host, port = address[:2]
+            else:  # IPv4
+                assert family == socket.AF_INET
+                host, port = address  # type: ignore[misc]
+            hosts.append(
+                {
+                    "hostname": hostname,
+                    "host": host,
+                    "port": port,
+                    "family": family,
+                    "proto": proto,
+                    "flags": socket.AI_NUMERICHOST | socket.AI_NUMERICSERV,
+                }
+            )
+
+        return hosts
+
+    async def close(self) -> None:
+        pass
+
+
+class AsyncResolver(AbstractResolver):
+    """Use the `aiodns` package to make asynchronous DNS lookups"""
+
+    def __init__(
+        self,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        *args: Any,
+        **kwargs: Any
+    ) -> None:
+        if aiodns is None:
+            raise RuntimeError("Resolver requires aiodns library")
+
+        self._loop = get_running_loop(loop)
+        self._resolver = aiodns.DNSResolver(*args, loop=loop, **kwargs)
+
+        if not hasattr(self._resolver, "gethostbyname"):
+            # aiodns 1.1 is not available, fallback to DNSResolver.query
+            self.resolve = self._resolve_with_query  # type: ignore
+
+    async def resolve(
+        self, host: str, port: int = 0, family: int = socket.AF_INET
+    ) -> List[Dict[str, Any]]:
+        try:
+            resp = await self._resolver.gethostbyname(host, family)
+        except aiodns.error.DNSError as exc:
+            msg = exc.args[1] if len(exc.args) >= 1 else "DNS lookup failed"
+            raise OSError(msg) from exc
+        hosts = []
+        for address in resp.addresses:
+            hosts.append(
+                {
+                    "hostname": host,
+                    "host": address,
+                    "port": port,
+                    "family": family,
+                    "proto": 0,
+                    "flags": socket.AI_NUMERICHOST | socket.AI_NUMERICSERV,
+                }
+            )
+
+        if not hosts:
+            raise OSError("DNS lookup failed")
+
+        return hosts
+
+    async def _resolve_with_query(
+        self, host: str, port: int = 0, family: int = socket.AF_INET
+    ) -> List[Dict[str, Any]]:
+        if family == socket.AF_INET6:
+            qtype = "AAAA"
+        else:
+            qtype = "A"
+
+        try:
+            resp = await self._resolver.query(host, qtype)
+        except aiodns.error.DNSError as exc:
+            msg = exc.args[1] if len(exc.args) >= 1 else "DNS lookup failed"
+            raise OSError(msg) from exc
+
+        hosts = []
+        for rr in resp:
+            hosts.append(
+                {
+                    "hostname": host,
+                    "host": rr.host,
+                    "port": port,
+                    "family": family,
+                    "proto": 0,
+                    "flags": socket.AI_NUMERICHOST,
+                }
+            )
+
+        if not hosts:
+            raise OSError("DNS lookup failed")
+
+        return hosts
+
+    async def close(self) -> None:
+        self._resolver.cancel()
+
+
+_DefaultType = Type[Union[AsyncResolver, ThreadedResolver]]
+DefaultResolver: _DefaultType = AsyncResolver if aiodns_default else ThreadedResolver
diff --git a/llm/Lib/site-packages/aiohttp/streams.py b/llm/Lib/site-packages/aiohttp/streams.py
new file mode 100644
index 0000000000000000000000000000000000000000..df9e94405f37af31f67e822d6a11f35b23464568
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/streams.py
@@ -0,0 +1,684 @@
+import asyncio
+import collections
+import warnings
+from typing import (
+    Awaitable,
+    Callable,
+    Deque,
+    Final,
+    Generic,
+    List,
+    Optional,
+    Tuple,
+    TypeVar,
+)
+
+from .base_protocol import BaseProtocol
+from .helpers import (
+    _EXC_SENTINEL,
+    BaseTimerContext,
+    TimerNoop,
+    set_exception,
+    set_result,
+)
+from .log import internal_logger
+
+__all__ = (
+    "EMPTY_PAYLOAD",
+    "EofStream",
+    "StreamReader",
+    "DataQueue",
+    "FlowControlDataQueue",
+)
+
+_T = TypeVar("_T")
+
+
+class EofStream(Exception):
+    """eof stream indication."""
+
+
+class AsyncStreamIterator(Generic[_T]):
+    def __init__(self, read_func: Callable[[], Awaitable[_T]]) -> None:
+        self.read_func = read_func
+
+    def __aiter__(self) -> "AsyncStreamIterator[_T]":
+        return self
+
+    async def __anext__(self) -> _T:
+        try:
+            rv = await self.read_func()
+        except EofStream:
+            raise StopAsyncIteration
+        if rv == b"":
+            raise StopAsyncIteration
+        return rv
+
+
+class ChunkTupleAsyncStreamIterator:
+    def __init__(self, stream: "StreamReader") -> None:
+        self._stream = stream
+
+    def __aiter__(self) -> "ChunkTupleAsyncStreamIterator":
+        return self
+
+    async def __anext__(self) -> Tuple[bytes, bool]:
+        rv = await self._stream.readchunk()
+        if rv == (b"", False):
+            raise StopAsyncIteration
+        return rv
+
+
+class AsyncStreamReaderMixin:
+    def __aiter__(self) -> AsyncStreamIterator[bytes]:
+        return AsyncStreamIterator(self.readline)  # type: ignore[attr-defined]
+
+    def iter_chunked(self, n: int) -> AsyncStreamIterator[bytes]:
+        """Returns an asynchronous iterator that yields chunks of size n."""
+        return AsyncStreamIterator(lambda: self.read(n))  # type: ignore[attr-defined]
+
+    def iter_any(self) -> AsyncStreamIterator[bytes]:
+        """Yield all available data as soon as it is received."""
+        return AsyncStreamIterator(self.readany)  # type: ignore[attr-defined]
+
+    def iter_chunks(self) -> ChunkTupleAsyncStreamIterator:
+        """Yield chunks of data as they are received by the server.
+
+        The yielded objects are tuples
+        of (bytes, bool) as returned by the StreamReader.readchunk method.
+        """
+        return ChunkTupleAsyncStreamIterator(self)  # type: ignore[arg-type]
+
+
+class StreamReader(AsyncStreamReaderMixin):
+    """An enhancement of asyncio.StreamReader.
+
+    Supports asynchronous iteration by line, chunk or as available::
+
+        async for line in reader:
+            ...
+        async for chunk in reader.iter_chunked(1024):
+            ...
+        async for slice in reader.iter_any():
+            ...
+
+    """
+
+    total_bytes = 0
+
+    def __init__(
+        self,
+        protocol: BaseProtocol,
+        limit: int,
+        *,
+        timer: Optional[BaseTimerContext] = None,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+    ) -> None:
+        self._protocol = protocol
+        self._low_water = limit
+        self._high_water = limit * 2
+        if loop is None:
+            loop = asyncio.get_event_loop()
+        self._loop = loop
+        self._size = 0
+        self._cursor = 0
+        self._http_chunk_splits: Optional[List[int]] = None
+        self._buffer: Deque[bytes] = collections.deque()
+        self._buffer_offset = 0
+        self._eof = False
+        self._waiter: Optional[asyncio.Future[None]] = None
+        self._eof_waiter: Optional[asyncio.Future[None]] = None
+        self._exception: Optional[BaseException] = None
+        self._timer = TimerNoop() if timer is None else timer
+        self._eof_callbacks: List[Callable[[], None]] = []
+
+    def __repr__(self) -> str:
+        info = [self.__class__.__name__]
+        if self._size:
+            info.append("%d bytes" % self._size)
+        if self._eof:
+            info.append("eof")
+        if self._low_water != 2**16:  # default limit
+            info.append("low=%d high=%d" % (self._low_water, self._high_water))
+        if self._waiter:
+            info.append("w=%r" % self._waiter)
+        if self._exception:
+            info.append("e=%r" % self._exception)
+        return "<%s>" % " ".join(info)
+
+    def get_read_buffer_limits(self) -> Tuple[int, int]:
+        return (self._low_water, self._high_water)
+
+    def exception(self) -> Optional[BaseException]:
+        return self._exception
+
+    def set_exception(
+        self,
+        exc: BaseException,
+        exc_cause: BaseException = _EXC_SENTINEL,
+    ) -> None:
+        self._exception = exc
+        self._eof_callbacks.clear()
+
+        waiter = self._waiter
+        if waiter is not None:
+            self._waiter = None
+            set_exception(waiter, exc, exc_cause)
+
+        waiter = self._eof_waiter
+        if waiter is not None:
+            self._eof_waiter = None
+            set_exception(waiter, exc, exc_cause)
+
+    def on_eof(self, callback: Callable[[], None]) -> None:
+        if self._eof:
+            try:
+                callback()
+            except Exception:
+                internal_logger.exception("Exception in eof callback")
+        else:
+            self._eof_callbacks.append(callback)
+
+    def feed_eof(self) -> None:
+        self._eof = True
+
+        waiter = self._waiter
+        if waiter is not None:
+            self._waiter = None
+            set_result(waiter, None)
+
+        waiter = self._eof_waiter
+        if waiter is not None:
+            self._eof_waiter = None
+            set_result(waiter, None)
+
+        for cb in self._eof_callbacks:
+            try:
+                cb()
+            except Exception:
+                internal_logger.exception("Exception in eof callback")
+
+        self._eof_callbacks.clear()
+
+    def is_eof(self) -> bool:
+        """Return True if  'feed_eof' was called."""
+        return self._eof
+
+    def at_eof(self) -> bool:
+        """Return True if the buffer is empty and 'feed_eof' was called."""
+        return self._eof and not self._buffer
+
+    async def wait_eof(self) -> None:
+        if self._eof:
+            return
+
+        assert self._eof_waiter is None
+        self._eof_waiter = self._loop.create_future()
+        try:
+            await self._eof_waiter
+        finally:
+            self._eof_waiter = None
+
+    def unread_data(self, data: bytes) -> None:
+        """rollback reading some data from stream, inserting it to buffer head."""
+        warnings.warn(
+            "unread_data() is deprecated "
+            "and will be removed in future releases (#3260)",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        if not data:
+            return
+
+        if self._buffer_offset:
+            self._buffer[0] = self._buffer[0][self._buffer_offset :]
+            self._buffer_offset = 0
+        self._size += len(data)
+        self._cursor -= len(data)
+        self._buffer.appendleft(data)
+        self._eof_counter = 0
+
+    # TODO: size is ignored, remove the param later
+    def feed_data(self, data: bytes, size: int = 0) -> None:
+        assert not self._eof, "feed_data after feed_eof"
+
+        if not data:
+            return
+
+        self._size += len(data)
+        self._buffer.append(data)
+        self.total_bytes += len(data)
+
+        waiter = self._waiter
+        if waiter is not None:
+            self._waiter = None
+            set_result(waiter, None)
+
+        if self._size > self._high_water and not self._protocol._reading_paused:
+            self._protocol.pause_reading()
+
+    def begin_http_chunk_receiving(self) -> None:
+        if self._http_chunk_splits is None:
+            if self.total_bytes:
+                raise RuntimeError(
+                    "Called begin_http_chunk_receiving when" "some data was already fed"
+                )
+            self._http_chunk_splits = []
+
+    def end_http_chunk_receiving(self) -> None:
+        if self._http_chunk_splits is None:
+            raise RuntimeError(
+                "Called end_chunk_receiving without calling "
+                "begin_chunk_receiving first"
+            )
+
+        # self._http_chunk_splits contains logical byte offsets from start of
+        # the body transfer. Each offset is the offset of the end of a chunk.
+        # "Logical" means bytes, accessible for a user.
+        # If no chunks containing logical data were received, current position
+        # is difinitely zero.
+        pos = self._http_chunk_splits[-1] if self._http_chunk_splits else 0
+
+        if self.total_bytes == pos:
+            # We should not add empty chunks here. So we check for that.
+            # Note, when chunked + gzip is used, we can receive a chunk
+            # of compressed data, but that data may not be enough for gzip FSM
+            # to yield any uncompressed data. That's why current position may
+            # not change after receiving a chunk.
+            return
+
+        self._http_chunk_splits.append(self.total_bytes)
+
+        # wake up readchunk when end of http chunk received
+        waiter = self._waiter
+        if waiter is not None:
+            self._waiter = None
+            set_result(waiter, None)
+
+    async def _wait(self, func_name: str) -> None:
+        # StreamReader uses a future to link the protocol feed_data() method
+        # to a read coroutine. Running two read coroutines at the same time
+        # would have an unexpected behaviour. It would not possible to know
+        # which coroutine would get the next data.
+        if self._waiter is not None:
+            raise RuntimeError(
+                "%s() called while another coroutine is "
+                "already waiting for incoming data" % func_name
+            )
+
+        waiter = self._waiter = self._loop.create_future()
+        try:
+            with self._timer:
+                await waiter
+        finally:
+            self._waiter = None
+
+    async def readline(self) -> bytes:
+        return await self.readuntil()
+
+    async def readuntil(self, separator: bytes = b"\n") -> bytes:
+        seplen = len(separator)
+        if seplen == 0:
+            raise ValueError("Separator should be at least one-byte string")
+
+        if self._exception is not None:
+            raise self._exception
+
+        chunk = b""
+        chunk_size = 0
+        not_enough = True
+
+        while not_enough:
+            while self._buffer and not_enough:
+                offset = self._buffer_offset
+                ichar = self._buffer[0].find(separator, offset) + 1
+                # Read from current offset to found separator or to the end.
+                data = self._read_nowait_chunk(
+                    ichar - offset + seplen - 1 if ichar else -1
+                )
+                chunk += data
+                chunk_size += len(data)
+                if ichar:
+                    not_enough = False
+
+                if chunk_size > self._high_water:
+                    raise ValueError("Chunk too big")
+
+            if self._eof:
+                break
+
+            if not_enough:
+                await self._wait("readuntil")
+
+        return chunk
+
+    async def read(self, n: int = -1) -> bytes:
+        if self._exception is not None:
+            raise self._exception
+
+        # migration problem; with DataQueue you have to catch
+        # EofStream exception, so common way is to run payload.read() inside
+        # infinite loop. what can cause real infinite loop with StreamReader
+        # lets keep this code one major release.
+        if __debug__:
+            if self._eof and not self._buffer:
+                self._eof_counter = getattr(self, "_eof_counter", 0) + 1
+                if self._eof_counter > 5:
+                    internal_logger.warning(
+                        "Multiple access to StreamReader in eof state, "
+                        "might be infinite loop.",
+                        stack_info=True,
+                    )
+
+        if not n:
+            return b""
+
+        if n < 0:
+            # This used to just loop creating a new waiter hoping to
+            # collect everything in self._buffer, but that would
+            # deadlock if the subprocess sends more than self.limit
+            # bytes.  So just call self.readany() until EOF.
+            blocks = []
+            while True:
+                block = await self.readany()
+                if not block:
+                    break
+                blocks.append(block)
+            return b"".join(blocks)
+
+        # TODO: should be `if` instead of `while`
+        # because waiter maybe triggered on chunk end,
+        # without feeding any data
+        while not self._buffer and not self._eof:
+            await self._wait("read")
+
+        return self._read_nowait(n)
+
+    async def readany(self) -> bytes:
+        if self._exception is not None:
+            raise self._exception
+
+        # TODO: should be `if` instead of `while`
+        # because waiter maybe triggered on chunk end,
+        # without feeding any data
+        while not self._buffer and not self._eof:
+            await self._wait("readany")
+
+        return self._read_nowait(-1)
+
+    async def readchunk(self) -> Tuple[bytes, bool]:
+        """Returns a tuple of (data, end_of_http_chunk).
+
+        When chunked transfer
+        encoding is used, end_of_http_chunk is a boolean indicating if the end
+        of the data corresponds to the end of a HTTP chunk , otherwise it is
+        always False.
+        """
+        while True:
+            if self._exception is not None:
+                raise self._exception
+
+            while self._http_chunk_splits:
+                pos = self._http_chunk_splits.pop(0)
+                if pos == self._cursor:
+                    return (b"", True)
+                if pos > self._cursor:
+                    return (self._read_nowait(pos - self._cursor), True)
+                internal_logger.warning(
+                    "Skipping HTTP chunk end due to data "
+                    "consumption beyond chunk boundary"
+                )
+
+            if self._buffer:
+                return (self._read_nowait_chunk(-1), False)
+                # return (self._read_nowait(-1), False)
+
+            if self._eof:
+                # Special case for signifying EOF.
+                # (b'', True) is not a final return value actually.
+                return (b"", False)
+
+            await self._wait("readchunk")
+
+    async def readexactly(self, n: int) -> bytes:
+        if self._exception is not None:
+            raise self._exception
+
+        blocks: List[bytes] = []
+        while n > 0:
+            block = await self.read(n)
+            if not block:
+                partial = b"".join(blocks)
+                raise asyncio.IncompleteReadError(partial, len(partial) + n)
+            blocks.append(block)
+            n -= len(block)
+
+        return b"".join(blocks)
+
+    def read_nowait(self, n: int = -1) -> bytes:
+        # default was changed to be consistent with .read(-1)
+        #
+        # I believe the most users don't know about the method and
+        # they are not affected.
+        if self._exception is not None:
+            raise self._exception
+
+        if self._waiter and not self._waiter.done():
+            raise RuntimeError(
+                "Called while some coroutine is waiting for incoming data."
+            )
+
+        return self._read_nowait(n)
+
+    def _read_nowait_chunk(self, n: int) -> bytes:
+        first_buffer = self._buffer[0]
+        offset = self._buffer_offset
+        if n != -1 and len(first_buffer) - offset > n:
+            data = first_buffer[offset : offset + n]
+            self._buffer_offset += n
+
+        elif offset:
+            self._buffer.popleft()
+            data = first_buffer[offset:]
+            self._buffer_offset = 0
+
+        else:
+            data = self._buffer.popleft()
+
+        self._size -= len(data)
+        self._cursor += len(data)
+
+        chunk_splits = self._http_chunk_splits
+        # Prevent memory leak: drop useless chunk splits
+        while chunk_splits and chunk_splits[0] < self._cursor:
+            chunk_splits.pop(0)
+
+        if self._size < self._low_water and self._protocol._reading_paused:
+            self._protocol.resume_reading()
+        return data
+
+    def _read_nowait(self, n: int) -> bytes:
+        """Read not more than n bytes, or whole buffer if n == -1"""
+        self._timer.assert_timeout()
+
+        chunks = []
+        while self._buffer:
+            chunk = self._read_nowait_chunk(n)
+            chunks.append(chunk)
+            if n != -1:
+                n -= len(chunk)
+                if n == 0:
+                    break
+
+        return b"".join(chunks) if chunks else b""
+
+
+class EmptyStreamReader(StreamReader):  # lgtm [py/missing-call-to-init]
+    def __init__(self) -> None:
+        self._read_eof_chunk = False
+
+    def __repr__(self) -> str:
+        return "<%s>" % self.__class__.__name__
+
+    def exception(self) -> Optional[BaseException]:
+        return None
+
+    def set_exception(
+        self,
+        exc: BaseException,
+        exc_cause: BaseException = _EXC_SENTINEL,
+    ) -> None:
+        pass
+
+    def on_eof(self, callback: Callable[[], None]) -> None:
+        try:
+            callback()
+        except Exception:
+            internal_logger.exception("Exception in eof callback")
+
+    def feed_eof(self) -> None:
+        pass
+
+    def is_eof(self) -> bool:
+        return True
+
+    def at_eof(self) -> bool:
+        return True
+
+    async def wait_eof(self) -> None:
+        return
+
+    def feed_data(self, data: bytes, n: int = 0) -> None:
+        pass
+
+    async def readline(self) -> bytes:
+        return b""
+
+    async def read(self, n: int = -1) -> bytes:
+        return b""
+
+    # TODO add async def readuntil
+
+    async def readany(self) -> bytes:
+        return b""
+
+    async def readchunk(self) -> Tuple[bytes, bool]:
+        if not self._read_eof_chunk:
+            self._read_eof_chunk = True
+            return (b"", False)
+
+        return (b"", True)
+
+    async def readexactly(self, n: int) -> bytes:
+        raise asyncio.IncompleteReadError(b"", n)
+
+    def read_nowait(self, n: int = -1) -> bytes:
+        return b""
+
+
+EMPTY_PAYLOAD: Final[StreamReader] = EmptyStreamReader()
+
+
+class DataQueue(Generic[_T]):
+    """DataQueue is a general-purpose blocking queue with one reader."""
+
+    def __init__(self, loop: asyncio.AbstractEventLoop) -> None:
+        self._loop = loop
+        self._eof = False
+        self._waiter: Optional[asyncio.Future[None]] = None
+        self._exception: Optional[BaseException] = None
+        self._size = 0
+        self._buffer: Deque[Tuple[_T, int]] = collections.deque()
+
+    def __len__(self) -> int:
+        return len(self._buffer)
+
+    def is_eof(self) -> bool:
+        return self._eof
+
+    def at_eof(self) -> bool:
+        return self._eof and not self._buffer
+
+    def exception(self) -> Optional[BaseException]:
+        return self._exception
+
+    def set_exception(
+        self,
+        exc: BaseException,
+        exc_cause: BaseException = _EXC_SENTINEL,
+    ) -> None:
+        self._eof = True
+        self._exception = exc
+
+        waiter = self._waiter
+        if waiter is not None:
+            self._waiter = None
+            set_exception(waiter, exc, exc_cause)
+
+    def feed_data(self, data: _T, size: int = 0) -> None:
+        self._size += size
+        self._buffer.append((data, size))
+
+        waiter = self._waiter
+        if waiter is not None:
+            self._waiter = None
+            set_result(waiter, None)
+
+    def feed_eof(self) -> None:
+        self._eof = True
+
+        waiter = self._waiter
+        if waiter is not None:
+            self._waiter = None
+            set_result(waiter, None)
+
+    async def read(self) -> _T:
+        if not self._buffer and not self._eof:
+            assert not self._waiter
+            self._waiter = self._loop.create_future()
+            try:
+                await self._waiter
+            except (asyncio.CancelledError, asyncio.TimeoutError):
+                self._waiter = None
+                raise
+
+        if self._buffer:
+            data, size = self._buffer.popleft()
+            self._size -= size
+            return data
+        else:
+            if self._exception is not None:
+                raise self._exception
+            else:
+                raise EofStream
+
+    def __aiter__(self) -> AsyncStreamIterator[_T]:
+        return AsyncStreamIterator(self.read)
+
+
+class FlowControlDataQueue(DataQueue[_T]):
+    """FlowControlDataQueue resumes and pauses an underlying stream.
+
+    It is a destination for parsed data.
+    """
+
+    def __init__(
+        self, protocol: BaseProtocol, limit: int, *, loop: asyncio.AbstractEventLoop
+    ) -> None:
+        super().__init__(loop=loop)
+
+        self._protocol = protocol
+        self._limit = limit * 2
+
+    def feed_data(self, data: _T, size: int = 0) -> None:
+        super().feed_data(data, size)
+
+        if self._size > self._limit and not self._protocol._reading_paused:
+            self._protocol.pause_reading()
+
+    async def read(self) -> _T:
+        try:
+            return await super().read()
+        finally:
+            if self._size < self._limit and self._protocol._reading_paused:
+                self._protocol.resume_reading()
diff --git a/llm/Lib/site-packages/aiohttp/tcp_helpers.py b/llm/Lib/site-packages/aiohttp/tcp_helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..8d39ba9e3c818281d45f8525d0cdf112871e2017
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/tcp_helpers.py
@@ -0,0 +1,37 @@
+"""Helper methods to tune a TCP connection"""
+
+import asyncio
+import socket
+from contextlib import suppress
+from typing import Optional  # noqa
+
+__all__ = ("tcp_keepalive", "tcp_nodelay")
+
+
+if hasattr(socket, "SO_KEEPALIVE"):
+
+    def tcp_keepalive(transport: asyncio.Transport) -> None:
+        sock = transport.get_extra_info("socket")
+        if sock is not None:
+            sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1)
+
+else:
+
+    def tcp_keepalive(transport: asyncio.Transport) -> None:  # pragma: no cover
+        pass
+
+
+def tcp_nodelay(transport: asyncio.Transport, value: bool) -> None:
+    sock = transport.get_extra_info("socket")
+
+    if sock is None:
+        return
+
+    if sock.family not in (socket.AF_INET, socket.AF_INET6):
+        return
+
+    value = bool(value)
+
+    # socket may be closed already, on windows OSError get raised
+    with suppress(OSError):
+        sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, value)
diff --git a/llm/Lib/site-packages/aiohttp/test_utils.py b/llm/Lib/site-packages/aiohttp/test_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..1992253a6a233d4d87971527bceaae593484a3b5
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/test_utils.py
@@ -0,0 +1,682 @@
+"""Utilities shared by tests."""
+
+import asyncio
+import contextlib
+import gc
+import inspect
+import ipaddress
+import os
+import socket
+import sys
+import warnings
+from abc import ABC, abstractmethod
+from types import TracebackType
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Iterator,
+    List,
+    Optional,
+    Type,
+    Union,
+    cast,
+)
+from unittest import IsolatedAsyncioTestCase, mock
+
+from aiosignal import Signal
+from multidict import CIMultiDict, CIMultiDictProxy
+from yarl import URL
+
+import aiohttp
+from aiohttp.client import _RequestContextManager, _WSRequestContextManager
+
+from . import ClientSession, hdrs
+from .abc import AbstractCookieJar
+from .client_reqrep import ClientResponse
+from .client_ws import ClientWebSocketResponse
+from .helpers import sentinel
+from .http import HttpVersion, RawRequestMessage
+from .typedefs import StrOrURL
+from .web import (
+    Application,
+    AppRunner,
+    BaseRunner,
+    Request,
+    Server,
+    ServerRunner,
+    SockSite,
+    UrlMappingMatchInfo,
+)
+from .web_protocol import _RequestHandler
+
+if TYPE_CHECKING:
+    from ssl import SSLContext
+else:
+    SSLContext = None
+
+REUSE_ADDRESS = os.name == "posix" and sys.platform != "cygwin"
+
+
+def get_unused_port_socket(
+    host: str, family: socket.AddressFamily = socket.AF_INET
+) -> socket.socket:
+    return get_port_socket(host, 0, family)
+
+
+def get_port_socket(
+    host: str, port: int, family: socket.AddressFamily
+) -> socket.socket:
+    s = socket.socket(family, socket.SOCK_STREAM)
+    if REUSE_ADDRESS:
+        # Windows has different semantics for SO_REUSEADDR,
+        # so don't set it. Ref:
+        # https://docs.microsoft.com/en-us/windows/win32/winsock/using-so-reuseaddr-and-so-exclusiveaddruse
+        s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+    s.bind((host, port))
+    return s
+
+
+def unused_port() -> int:
+    """Return a port that is unused on the current host."""
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        s.bind(("127.0.0.1", 0))
+        return cast(int, s.getsockname()[1])
+
+
+class BaseTestServer(ABC):
+    __test__ = False
+
+    def __init__(
+        self,
+        *,
+        scheme: Union[str, object] = sentinel,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        host: str = "127.0.0.1",
+        port: Optional[int] = None,
+        skip_url_asserts: bool = False,
+        socket_factory: Callable[
+            [str, int, socket.AddressFamily], socket.socket
+        ] = get_port_socket,
+        **kwargs: Any,
+    ) -> None:
+        self._loop = loop
+        self.runner: Optional[BaseRunner] = None
+        self._root: Optional[URL] = None
+        self.host = host
+        self.port = port
+        self._closed = False
+        self.scheme = scheme
+        self.skip_url_asserts = skip_url_asserts
+        self.socket_factory = socket_factory
+
+    async def start_server(
+        self, loop: Optional[asyncio.AbstractEventLoop] = None, **kwargs: Any
+    ) -> None:
+        if self.runner:
+            return
+        self._loop = loop
+        self._ssl = kwargs.pop("ssl", None)
+        self.runner = await self._make_runner(handler_cancellation=True, **kwargs)
+        await self.runner.setup()
+        if not self.port:
+            self.port = 0
+        try:
+            version = ipaddress.ip_address(self.host).version
+        except ValueError:
+            version = 4
+        family = socket.AF_INET6 if version == 6 else socket.AF_INET
+        _sock = self.socket_factory(self.host, self.port, family)
+        self.host, self.port = _sock.getsockname()[:2]
+        site = SockSite(self.runner, sock=_sock, ssl_context=self._ssl)
+        await site.start()
+        server = site._server
+        assert server is not None
+        sockets = server.sockets  # type: ignore[attr-defined]
+        assert sockets is not None
+        self.port = sockets[0].getsockname()[1]
+        if self.scheme is sentinel:
+            if self._ssl:
+                scheme = "https"
+            else:
+                scheme = "http"
+            self.scheme = scheme
+        self._root = URL(f"{self.scheme}://{self.host}:{self.port}")
+
+    @abstractmethod  # pragma: no cover
+    async def _make_runner(self, **kwargs: Any) -> BaseRunner:
+        pass
+
+    def make_url(self, path: StrOrURL) -> URL:
+        assert self._root is not None
+        url = URL(path)
+        if not self.skip_url_asserts:
+            assert not url.is_absolute()
+            return self._root.join(url)
+        else:
+            return URL(str(self._root) + str(path))
+
+    @property
+    def started(self) -> bool:
+        return self.runner is not None
+
+    @property
+    def closed(self) -> bool:
+        return self._closed
+
+    @property
+    def handler(self) -> Server:
+        # for backward compatibility
+        # web.Server instance
+        runner = self.runner
+        assert runner is not None
+        assert runner.server is not None
+        return runner.server
+
+    async def close(self) -> None:
+        """Close all fixtures created by the test client.
+
+        After that point, the TestClient is no longer usable.
+
+        This is an idempotent function: running close multiple times
+        will not have any additional effects.
+
+        close is also run when the object is garbage collected, and on
+        exit when used as a context manager.
+
+        """
+        if self.started and not self.closed:
+            assert self.runner is not None
+            await self.runner.cleanup()
+            self._root = None
+            self.port = None
+            self._closed = True
+
+    def __enter__(self) -> None:
+        raise TypeError("Use async with instead")
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_value: Optional[BaseException],
+        traceback: Optional[TracebackType],
+    ) -> None:
+        # __exit__ should exist in pair with __enter__ but never executed
+        pass  # pragma: no cover
+
+    async def __aenter__(self) -> "BaseTestServer":
+        await self.start_server(loop=self._loop)
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_value: Optional[BaseException],
+        traceback: Optional[TracebackType],
+    ) -> None:
+        await self.close()
+
+
+class TestServer(BaseTestServer):
+    def __init__(
+        self,
+        app: Application,
+        *,
+        scheme: Union[str, object] = sentinel,
+        host: str = "127.0.0.1",
+        port: Optional[int] = None,
+        **kwargs: Any,
+    ):
+        self.app = app
+        super().__init__(scheme=scheme, host=host, port=port, **kwargs)
+
+    async def _make_runner(self, **kwargs: Any) -> BaseRunner:
+        return AppRunner(self.app, **kwargs)
+
+
+class RawTestServer(BaseTestServer):
+    def __init__(
+        self,
+        handler: _RequestHandler,
+        *,
+        scheme: Union[str, object] = sentinel,
+        host: str = "127.0.0.1",
+        port: Optional[int] = None,
+        **kwargs: Any,
+    ) -> None:
+        self._handler = handler
+        super().__init__(scheme=scheme, host=host, port=port, **kwargs)
+
+    async def _make_runner(self, debug: bool = True, **kwargs: Any) -> ServerRunner:
+        srv = Server(self._handler, loop=self._loop, debug=debug, **kwargs)
+        return ServerRunner(srv, debug=debug, **kwargs)
+
+
+class TestClient:
+    """
+    A test client implementation.
+
+    To write functional tests for aiohttp based servers.
+
+    """
+
+    __test__ = False
+
+    def __init__(
+        self,
+        server: BaseTestServer,
+        *,
+        cookie_jar: Optional[AbstractCookieJar] = None,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        **kwargs: Any,
+    ) -> None:
+        if not isinstance(server, BaseTestServer):
+            raise TypeError(
+                "server must be TestServer " "instance, found type: %r" % type(server)
+            )
+        self._server = server
+        self._loop = loop
+        if cookie_jar is None:
+            cookie_jar = aiohttp.CookieJar(unsafe=True, loop=loop)
+        self._session = ClientSession(loop=loop, cookie_jar=cookie_jar, **kwargs)
+        self._closed = False
+        self._responses: List[ClientResponse] = []
+        self._websockets: List[ClientWebSocketResponse] = []
+
+    async def start_server(self) -> None:
+        await self._server.start_server(loop=self._loop)
+
+    @property
+    def host(self) -> str:
+        return self._server.host
+
+    @property
+    def port(self) -> Optional[int]:
+        return self._server.port
+
+    @property
+    def server(self) -> BaseTestServer:
+        return self._server
+
+    @property
+    def app(self) -> Optional[Application]:
+        return cast(Optional[Application], getattr(self._server, "app", None))
+
+    @property
+    def session(self) -> ClientSession:
+        """An internal aiohttp.ClientSession.
+
+        Unlike the methods on the TestClient, client session requests
+        do not automatically include the host in the url queried, and
+        will require an absolute path to the resource.
+
+        """
+        return self._session
+
+    def make_url(self, path: StrOrURL) -> URL:
+        return self._server.make_url(path)
+
+    async def _request(
+        self, method: str, path: StrOrURL, **kwargs: Any
+    ) -> ClientResponse:
+        resp = await self._session.request(method, self.make_url(path), **kwargs)
+        # save it to close later
+        self._responses.append(resp)
+        return resp
+
+    def request(
+        self, method: str, path: StrOrURL, **kwargs: Any
+    ) -> _RequestContextManager:
+        """Routes a request to tested http server.
+
+        The interface is identical to aiohttp.ClientSession.request,
+        except the loop kwarg is overridden by the instance used by the
+        test server.
+
+        """
+        return _RequestContextManager(self._request(method, path, **kwargs))
+
+    def get(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager:
+        """Perform an HTTP GET request."""
+        return _RequestContextManager(self._request(hdrs.METH_GET, path, **kwargs))
+
+    def post(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager:
+        """Perform an HTTP POST request."""
+        return _RequestContextManager(self._request(hdrs.METH_POST, path, **kwargs))
+
+    def options(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager:
+        """Perform an HTTP OPTIONS request."""
+        return _RequestContextManager(self._request(hdrs.METH_OPTIONS, path, **kwargs))
+
+    def head(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager:
+        """Perform an HTTP HEAD request."""
+        return _RequestContextManager(self._request(hdrs.METH_HEAD, path, **kwargs))
+
+    def put(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager:
+        """Perform an HTTP PUT request."""
+        return _RequestContextManager(self._request(hdrs.METH_PUT, path, **kwargs))
+
+    def patch(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager:
+        """Perform an HTTP PATCH request."""
+        return _RequestContextManager(self._request(hdrs.METH_PATCH, path, **kwargs))
+
+    def delete(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager:
+        """Perform an HTTP PATCH request."""
+        return _RequestContextManager(self._request(hdrs.METH_DELETE, path, **kwargs))
+
+    def ws_connect(self, path: StrOrURL, **kwargs: Any) -> _WSRequestContextManager:
+        """Initiate websocket connection.
+
+        The api corresponds to aiohttp.ClientSession.ws_connect.
+
+        """
+        return _WSRequestContextManager(self._ws_connect(path, **kwargs))
+
+    async def _ws_connect(
+        self, path: StrOrURL, **kwargs: Any
+    ) -> ClientWebSocketResponse:
+        ws = await self._session.ws_connect(self.make_url(path), **kwargs)
+        self._websockets.append(ws)
+        return ws
+
+    async def close(self) -> None:
+        """Close all fixtures created by the test client.
+
+        After that point, the TestClient is no longer usable.
+
+        This is an idempotent function: running close multiple times
+        will not have any additional effects.
+
+        close is also run on exit when used as a(n) (asynchronous)
+        context manager.
+
+        """
+        if not self._closed:
+            for resp in self._responses:
+                resp.close()
+            for ws in self._websockets:
+                await ws.close()
+            await self._session.close()
+            await self._server.close()
+            self._closed = True
+
+    def __enter__(self) -> None:
+        raise TypeError("Use async with instead")
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc: Optional[BaseException],
+        tb: Optional[TracebackType],
+    ) -> None:
+        # __exit__ should exist in pair with __enter__ but never executed
+        pass  # pragma: no cover
+
+    async def __aenter__(self) -> "TestClient":
+        await self.start_server()
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc: Optional[BaseException],
+        tb: Optional[TracebackType],
+    ) -> None:
+        await self.close()
+
+
+class AioHTTPTestCase(IsolatedAsyncioTestCase):
+    """A base class to allow for unittest web applications using aiohttp.
+
+    Provides the following:
+
+    * self.client (aiohttp.test_utils.TestClient): an aiohttp test client.
+    * self.loop (asyncio.BaseEventLoop): the event loop in which the
+        application and server are running.
+    * self.app (aiohttp.web.Application): the application returned by
+        self.get_application()
+
+    Note that the TestClient's methods are asynchronous: you have to
+    execute function on the test client using asynchronous methods.
+    """
+
+    async def get_application(self) -> Application:
+        """Get application.
+
+        This method should be overridden
+        to return the aiohttp.web.Application
+        object to test.
+        """
+        return self.get_app()
+
+    def get_app(self) -> Application:
+        """Obsolete method used to constructing web application.
+
+        Use .get_application() coroutine instead.
+        """
+        raise RuntimeError("Did you forget to define get_application()?")
+
+    async def asyncSetUp(self) -> None:
+        self.loop = asyncio.get_running_loop()
+        return await self.setUpAsync()
+
+    async def setUpAsync(self) -> None:
+        self.app = await self.get_application()
+        self.server = await self.get_server(self.app)
+        self.client = await self.get_client(self.server)
+
+        await self.client.start_server()
+
+    async def asyncTearDown(self) -> None:
+        return await self.tearDownAsync()
+
+    async def tearDownAsync(self) -> None:
+        await self.client.close()
+
+    async def get_server(self, app: Application) -> TestServer:
+        """Return a TestServer instance."""
+        return TestServer(app, loop=self.loop)
+
+    async def get_client(self, server: TestServer) -> TestClient:
+        """Return a TestClient instance."""
+        return TestClient(server, loop=self.loop)
+
+
+def unittest_run_loop(func: Any, *args: Any, **kwargs: Any) -> Any:
+    """
+    A decorator dedicated to use with asynchronous AioHTTPTestCase test methods.
+
+    In 3.8+, this does nothing.
+    """
+    warnings.warn(
+        "Decorator `@unittest_run_loop` is no longer needed in aiohttp 3.8+",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return func
+
+
+_LOOP_FACTORY = Callable[[], asyncio.AbstractEventLoop]
+
+
+@contextlib.contextmanager
+def loop_context(
+    loop_factory: _LOOP_FACTORY = asyncio.new_event_loop, fast: bool = False
+) -> Iterator[asyncio.AbstractEventLoop]:
+    """A contextmanager that creates an event_loop, for test purposes.
+
+    Handles the creation and cleanup of a test loop.
+    """
+    loop = setup_test_loop(loop_factory)
+    yield loop
+    teardown_test_loop(loop, fast=fast)
+
+
+def setup_test_loop(
+    loop_factory: _LOOP_FACTORY = asyncio.new_event_loop,
+) -> asyncio.AbstractEventLoop:
+    """Create and return an asyncio.BaseEventLoop instance.
+
+    The caller should also call teardown_test_loop,
+    once they are done with the loop.
+    """
+    loop = loop_factory()
+    asyncio.set_event_loop(loop)
+    return loop
+
+
+def teardown_test_loop(loop: asyncio.AbstractEventLoop, fast: bool = False) -> None:
+    """Teardown and cleanup an event_loop created by setup_test_loop."""
+    closed = loop.is_closed()
+    if not closed:
+        loop.call_soon(loop.stop)
+        loop.run_forever()
+        loop.close()
+
+    if not fast:
+        gc.collect()
+
+    asyncio.set_event_loop(None)
+
+
+def _create_app_mock() -> mock.MagicMock:
+    def get_dict(app: Any, key: str) -> Any:
+        return app.__app_dict[key]
+
+    def set_dict(app: Any, key: str, value: Any) -> None:
+        app.__app_dict[key] = value
+
+    app = mock.MagicMock(spec=Application)
+    app.__app_dict = {}
+    app.__getitem__ = get_dict
+    app.__setitem__ = set_dict
+
+    app._debug = False
+    app.on_response_prepare = Signal(app)
+    app.on_response_prepare.freeze()
+    return app
+
+
+def _create_transport(sslcontext: Optional[SSLContext] = None) -> mock.Mock:
+    transport = mock.Mock()
+
+    def get_extra_info(key: str) -> Optional[SSLContext]:
+        if key == "sslcontext":
+            return sslcontext
+        else:
+            return None
+
+    transport.get_extra_info.side_effect = get_extra_info
+    return transport
+
+
+def make_mocked_request(
+    method: str,
+    path: str,
+    headers: Any = None,
+    *,
+    match_info: Any = sentinel,
+    version: HttpVersion = HttpVersion(1, 1),
+    closing: bool = False,
+    app: Any = None,
+    writer: Any = sentinel,
+    protocol: Any = sentinel,
+    transport: Any = sentinel,
+    payload: Any = sentinel,
+    sslcontext: Optional[SSLContext] = None,
+    client_max_size: int = 1024**2,
+    loop: Any = ...,
+) -> Request:
+    """Creates mocked web.Request testing purposes.
+
+    Useful in unit tests, when spinning full web server is overkill or
+    specific conditions and errors are hard to trigger.
+    """
+    task = mock.Mock()
+    if loop is ...:
+        # no loop passed, try to get the current one if
+        # its is running as we need a real loop to create
+        # executor jobs to be able to do testing
+        # with a real executor
+        try:
+            loop = asyncio.get_running_loop()
+        except RuntimeError:
+            loop = mock.Mock()
+            loop.create_future.return_value = ()
+
+    if version < HttpVersion(1, 1):
+        closing = True
+
+    if headers:
+        headers = CIMultiDictProxy(CIMultiDict(headers))
+        raw_hdrs = tuple(
+            (k.encode("utf-8"), v.encode("utf-8")) for k, v in headers.items()
+        )
+    else:
+        headers = CIMultiDictProxy(CIMultiDict())
+        raw_hdrs = ()
+
+    chunked = "chunked" in headers.get(hdrs.TRANSFER_ENCODING, "").lower()
+
+    message = RawRequestMessage(
+        method,
+        path,
+        version,
+        headers,
+        raw_hdrs,
+        closing,
+        None,
+        False,
+        chunked,
+        URL(path),
+    )
+    if app is None:
+        app = _create_app_mock()
+
+    if transport is sentinel:
+        transport = _create_transport(sslcontext)
+
+    if protocol is sentinel:
+        protocol = mock.Mock()
+        protocol.transport = transport
+
+    if writer is sentinel:
+        writer = mock.Mock()
+        writer.write_headers = make_mocked_coro(None)
+        writer.write = make_mocked_coro(None)
+        writer.write_eof = make_mocked_coro(None)
+        writer.drain = make_mocked_coro(None)
+        writer.transport = transport
+
+    protocol.transport = transport
+    protocol.writer = writer
+
+    if payload is sentinel:
+        payload = mock.Mock()
+
+    req = Request(
+        message, payload, protocol, writer, task, loop, client_max_size=client_max_size
+    )
+
+    match_info = UrlMappingMatchInfo(
+        {} if match_info is sentinel else match_info, mock.Mock()
+    )
+    match_info.add_app(app)
+    req._match_info = match_info
+
+    return req
+
+
+def make_mocked_coro(
+    return_value: Any = sentinel, raise_exception: Any = sentinel
+) -> Any:
+    """Creates a coroutine mock."""
+
+    async def mock_coro(*args: Any, **kwargs: Any) -> Any:
+        if raise_exception is not sentinel:
+            raise raise_exception
+        if not inspect.isawaitable(return_value):
+            return return_value
+        await return_value
+
+    return mock.Mock(wraps=mock_coro)
diff --git a/llm/Lib/site-packages/aiohttp/tracing.py b/llm/Lib/site-packages/aiohttp/tracing.py
new file mode 100644
index 0000000000000000000000000000000000000000..6770a0dc361007846c123a1472f21e688cddd233
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/tracing.py
@@ -0,0 +1,471 @@
+from types import SimpleNamespace
+from typing import TYPE_CHECKING, Awaitable, Optional, Protocol, Type, TypeVar
+
+import attr
+from aiosignal import Signal
+from multidict import CIMultiDict
+from yarl import URL
+
+from .client_reqrep import ClientResponse
+
+if TYPE_CHECKING:
+    from .client import ClientSession
+
+    _ParamT_contra = TypeVar("_ParamT_contra", contravariant=True)
+
+    class _SignalCallback(Protocol[_ParamT_contra]):
+        def __call__(
+            self,
+            __client_session: ClientSession,
+            __trace_config_ctx: SimpleNamespace,
+            __params: _ParamT_contra,
+        ) -> Awaitable[None]:
+            ...
+
+
+__all__ = (
+    "TraceConfig",
+    "TraceRequestStartParams",
+    "TraceRequestEndParams",
+    "TraceRequestExceptionParams",
+    "TraceConnectionQueuedStartParams",
+    "TraceConnectionQueuedEndParams",
+    "TraceConnectionCreateStartParams",
+    "TraceConnectionCreateEndParams",
+    "TraceConnectionReuseconnParams",
+    "TraceDnsResolveHostStartParams",
+    "TraceDnsResolveHostEndParams",
+    "TraceDnsCacheHitParams",
+    "TraceDnsCacheMissParams",
+    "TraceRequestRedirectParams",
+    "TraceRequestChunkSentParams",
+    "TraceResponseChunkReceivedParams",
+    "TraceRequestHeadersSentParams",
+)
+
+
+class TraceConfig:
+    """First-class used to trace requests launched via ClientSession objects."""
+
+    def __init__(
+        self, trace_config_ctx_factory: Type[SimpleNamespace] = SimpleNamespace
+    ) -> None:
+        self._on_request_start: Signal[
+            _SignalCallback[TraceRequestStartParams]
+        ] = Signal(self)
+        self._on_request_chunk_sent: Signal[
+            _SignalCallback[TraceRequestChunkSentParams]
+        ] = Signal(self)
+        self._on_response_chunk_received: Signal[
+            _SignalCallback[TraceResponseChunkReceivedParams]
+        ] = Signal(self)
+        self._on_request_end: Signal[_SignalCallback[TraceRequestEndParams]] = Signal(
+            self
+        )
+        self._on_request_exception: Signal[
+            _SignalCallback[TraceRequestExceptionParams]
+        ] = Signal(self)
+        self._on_request_redirect: Signal[
+            _SignalCallback[TraceRequestRedirectParams]
+        ] = Signal(self)
+        self._on_connection_queued_start: Signal[
+            _SignalCallback[TraceConnectionQueuedStartParams]
+        ] = Signal(self)
+        self._on_connection_queued_end: Signal[
+            _SignalCallback[TraceConnectionQueuedEndParams]
+        ] = Signal(self)
+        self._on_connection_create_start: Signal[
+            _SignalCallback[TraceConnectionCreateStartParams]
+        ] = Signal(self)
+        self._on_connection_create_end: Signal[
+            _SignalCallback[TraceConnectionCreateEndParams]
+        ] = Signal(self)
+        self._on_connection_reuseconn: Signal[
+            _SignalCallback[TraceConnectionReuseconnParams]
+        ] = Signal(self)
+        self._on_dns_resolvehost_start: Signal[
+            _SignalCallback[TraceDnsResolveHostStartParams]
+        ] = Signal(self)
+        self._on_dns_resolvehost_end: Signal[
+            _SignalCallback[TraceDnsResolveHostEndParams]
+        ] = Signal(self)
+        self._on_dns_cache_hit: Signal[
+            _SignalCallback[TraceDnsCacheHitParams]
+        ] = Signal(self)
+        self._on_dns_cache_miss: Signal[
+            _SignalCallback[TraceDnsCacheMissParams]
+        ] = Signal(self)
+        self._on_request_headers_sent: Signal[
+            _SignalCallback[TraceRequestHeadersSentParams]
+        ] = Signal(self)
+
+        self._trace_config_ctx_factory = trace_config_ctx_factory
+
+    def trace_config_ctx(
+        self, trace_request_ctx: Optional[SimpleNamespace] = None
+    ) -> SimpleNamespace:
+        """Return a new trace_config_ctx instance"""
+        return self._trace_config_ctx_factory(trace_request_ctx=trace_request_ctx)
+
+    def freeze(self) -> None:
+        self._on_request_start.freeze()
+        self._on_request_chunk_sent.freeze()
+        self._on_response_chunk_received.freeze()
+        self._on_request_end.freeze()
+        self._on_request_exception.freeze()
+        self._on_request_redirect.freeze()
+        self._on_connection_queued_start.freeze()
+        self._on_connection_queued_end.freeze()
+        self._on_connection_create_start.freeze()
+        self._on_connection_create_end.freeze()
+        self._on_connection_reuseconn.freeze()
+        self._on_dns_resolvehost_start.freeze()
+        self._on_dns_resolvehost_end.freeze()
+        self._on_dns_cache_hit.freeze()
+        self._on_dns_cache_miss.freeze()
+        self._on_request_headers_sent.freeze()
+
+    @property
+    def on_request_start(self) -> "Signal[_SignalCallback[TraceRequestStartParams]]":
+        return self._on_request_start
+
+    @property
+    def on_request_chunk_sent(
+        self,
+    ) -> "Signal[_SignalCallback[TraceRequestChunkSentParams]]":
+        return self._on_request_chunk_sent
+
+    @property
+    def on_response_chunk_received(
+        self,
+    ) -> "Signal[_SignalCallback[TraceResponseChunkReceivedParams]]":
+        return self._on_response_chunk_received
+
+    @property
+    def on_request_end(self) -> "Signal[_SignalCallback[TraceRequestEndParams]]":
+        return self._on_request_end
+
+    @property
+    def on_request_exception(
+        self,
+    ) -> "Signal[_SignalCallback[TraceRequestExceptionParams]]":
+        return self._on_request_exception
+
+    @property
+    def on_request_redirect(
+        self,
+    ) -> "Signal[_SignalCallback[TraceRequestRedirectParams]]":
+        return self._on_request_redirect
+
+    @property
+    def on_connection_queued_start(
+        self,
+    ) -> "Signal[_SignalCallback[TraceConnectionQueuedStartParams]]":
+        return self._on_connection_queued_start
+
+    @property
+    def on_connection_queued_end(
+        self,
+    ) -> "Signal[_SignalCallback[TraceConnectionQueuedEndParams]]":
+        return self._on_connection_queued_end
+
+    @property
+    def on_connection_create_start(
+        self,
+    ) -> "Signal[_SignalCallback[TraceConnectionCreateStartParams]]":
+        return self._on_connection_create_start
+
+    @property
+    def on_connection_create_end(
+        self,
+    ) -> "Signal[_SignalCallback[TraceConnectionCreateEndParams]]":
+        return self._on_connection_create_end
+
+    @property
+    def on_connection_reuseconn(
+        self,
+    ) -> "Signal[_SignalCallback[TraceConnectionReuseconnParams]]":
+        return self._on_connection_reuseconn
+
+    @property
+    def on_dns_resolvehost_start(
+        self,
+    ) -> "Signal[_SignalCallback[TraceDnsResolveHostStartParams]]":
+        return self._on_dns_resolvehost_start
+
+    @property
+    def on_dns_resolvehost_end(
+        self,
+    ) -> "Signal[_SignalCallback[TraceDnsResolveHostEndParams]]":
+        return self._on_dns_resolvehost_end
+
+    @property
+    def on_dns_cache_hit(self) -> "Signal[_SignalCallback[TraceDnsCacheHitParams]]":
+        return self._on_dns_cache_hit
+
+    @property
+    def on_dns_cache_miss(self) -> "Signal[_SignalCallback[TraceDnsCacheMissParams]]":
+        return self._on_dns_cache_miss
+
+    @property
+    def on_request_headers_sent(
+        self,
+    ) -> "Signal[_SignalCallback[TraceRequestHeadersSentParams]]":
+        return self._on_request_headers_sent
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceRequestStartParams:
+    """Parameters sent by the `on_request_start` signal"""
+
+    method: str
+    url: URL
+    headers: "CIMultiDict[str]"
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceRequestChunkSentParams:
+    """Parameters sent by the `on_request_chunk_sent` signal"""
+
+    method: str
+    url: URL
+    chunk: bytes
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceResponseChunkReceivedParams:
+    """Parameters sent by the `on_response_chunk_received` signal"""
+
+    method: str
+    url: URL
+    chunk: bytes
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceRequestEndParams:
+    """Parameters sent by the `on_request_end` signal"""
+
+    method: str
+    url: URL
+    headers: "CIMultiDict[str]"
+    response: ClientResponse
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceRequestExceptionParams:
+    """Parameters sent by the `on_request_exception` signal"""
+
+    method: str
+    url: URL
+    headers: "CIMultiDict[str]"
+    exception: BaseException
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceRequestRedirectParams:
+    """Parameters sent by the `on_request_redirect` signal"""
+
+    method: str
+    url: URL
+    headers: "CIMultiDict[str]"
+    response: ClientResponse
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceConnectionQueuedStartParams:
+    """Parameters sent by the `on_connection_queued_start` signal"""
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceConnectionQueuedEndParams:
+    """Parameters sent by the `on_connection_queued_end` signal"""
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceConnectionCreateStartParams:
+    """Parameters sent by the `on_connection_create_start` signal"""
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceConnectionCreateEndParams:
+    """Parameters sent by the `on_connection_create_end` signal"""
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceConnectionReuseconnParams:
+    """Parameters sent by the `on_connection_reuseconn` signal"""
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceDnsResolveHostStartParams:
+    """Parameters sent by the `on_dns_resolvehost_start` signal"""
+
+    host: str
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceDnsResolveHostEndParams:
+    """Parameters sent by the `on_dns_resolvehost_end` signal"""
+
+    host: str
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceDnsCacheHitParams:
+    """Parameters sent by the `on_dns_cache_hit` signal"""
+
+    host: str
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceDnsCacheMissParams:
+    """Parameters sent by the `on_dns_cache_miss` signal"""
+
+    host: str
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class TraceRequestHeadersSentParams:
+    """Parameters sent by the `on_request_headers_sent` signal"""
+
+    method: str
+    url: URL
+    headers: "CIMultiDict[str]"
+
+
+class Trace:
+    """Internal dependency holder class.
+
+    Used to keep together the main dependencies used
+    at the moment of send a signal.
+    """
+
+    def __init__(
+        self,
+        session: "ClientSession",
+        trace_config: TraceConfig,
+        trace_config_ctx: SimpleNamespace,
+    ) -> None:
+        self._trace_config = trace_config
+        self._trace_config_ctx = trace_config_ctx
+        self._session = session
+
+    async def send_request_start(
+        self, method: str, url: URL, headers: "CIMultiDict[str]"
+    ) -> None:
+        return await self._trace_config.on_request_start.send(
+            self._session,
+            self._trace_config_ctx,
+            TraceRequestStartParams(method, url, headers),
+        )
+
+    async def send_request_chunk_sent(
+        self, method: str, url: URL, chunk: bytes
+    ) -> None:
+        return await self._trace_config.on_request_chunk_sent.send(
+            self._session,
+            self._trace_config_ctx,
+            TraceRequestChunkSentParams(method, url, chunk),
+        )
+
+    async def send_response_chunk_received(
+        self, method: str, url: URL, chunk: bytes
+    ) -> None:
+        return await self._trace_config.on_response_chunk_received.send(
+            self._session,
+            self._trace_config_ctx,
+            TraceResponseChunkReceivedParams(method, url, chunk),
+        )
+
+    async def send_request_end(
+        self,
+        method: str,
+        url: URL,
+        headers: "CIMultiDict[str]",
+        response: ClientResponse,
+    ) -> None:
+        return await self._trace_config.on_request_end.send(
+            self._session,
+            self._trace_config_ctx,
+            TraceRequestEndParams(method, url, headers, response),
+        )
+
+    async def send_request_exception(
+        self,
+        method: str,
+        url: URL,
+        headers: "CIMultiDict[str]",
+        exception: BaseException,
+    ) -> None:
+        return await self._trace_config.on_request_exception.send(
+            self._session,
+            self._trace_config_ctx,
+            TraceRequestExceptionParams(method, url, headers, exception),
+        )
+
+    async def send_request_redirect(
+        self,
+        method: str,
+        url: URL,
+        headers: "CIMultiDict[str]",
+        response: ClientResponse,
+    ) -> None:
+        return await self._trace_config._on_request_redirect.send(
+            self._session,
+            self._trace_config_ctx,
+            TraceRequestRedirectParams(method, url, headers, response),
+        )
+
+    async def send_connection_queued_start(self) -> None:
+        return await self._trace_config.on_connection_queued_start.send(
+            self._session, self._trace_config_ctx, TraceConnectionQueuedStartParams()
+        )
+
+    async def send_connection_queued_end(self) -> None:
+        return await self._trace_config.on_connection_queued_end.send(
+            self._session, self._trace_config_ctx, TraceConnectionQueuedEndParams()
+        )
+
+    async def send_connection_create_start(self) -> None:
+        return await self._trace_config.on_connection_create_start.send(
+            self._session, self._trace_config_ctx, TraceConnectionCreateStartParams()
+        )
+
+    async def send_connection_create_end(self) -> None:
+        return await self._trace_config.on_connection_create_end.send(
+            self._session, self._trace_config_ctx, TraceConnectionCreateEndParams()
+        )
+
+    async def send_connection_reuseconn(self) -> None:
+        return await self._trace_config.on_connection_reuseconn.send(
+            self._session, self._trace_config_ctx, TraceConnectionReuseconnParams()
+        )
+
+    async def send_dns_resolvehost_start(self, host: str) -> None:
+        return await self._trace_config.on_dns_resolvehost_start.send(
+            self._session, self._trace_config_ctx, TraceDnsResolveHostStartParams(host)
+        )
+
+    async def send_dns_resolvehost_end(self, host: str) -> None:
+        return await self._trace_config.on_dns_resolvehost_end.send(
+            self._session, self._trace_config_ctx, TraceDnsResolveHostEndParams(host)
+        )
+
+    async def send_dns_cache_hit(self, host: str) -> None:
+        return await self._trace_config.on_dns_cache_hit.send(
+            self._session, self._trace_config_ctx, TraceDnsCacheHitParams(host)
+        )
+
+    async def send_dns_cache_miss(self, host: str) -> None:
+        return await self._trace_config.on_dns_cache_miss.send(
+            self._session, self._trace_config_ctx, TraceDnsCacheMissParams(host)
+        )
+
+    async def send_request_headers(
+        self, method: str, url: URL, headers: "CIMultiDict[str]"
+    ) -> None:
+        return await self._trace_config._on_request_headers_sent.send(
+            self._session,
+            self._trace_config_ctx,
+            TraceRequestHeadersSentParams(method, url, headers),
+        )
diff --git a/llm/Lib/site-packages/aiohttp/typedefs.py b/llm/Lib/site-packages/aiohttp/typedefs.py
new file mode 100644
index 0000000000000000000000000000000000000000..b80976a25053ae612bddfff523b66b1b248501ba
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/typedefs.py
@@ -0,0 +1,54 @@
+import json
+import os
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Awaitable,
+    Callable,
+    Iterable,
+    Mapping,
+    Tuple,
+    Union,
+)
+
+from multidict import CIMultiDict, CIMultiDictProxy, MultiDict, MultiDictProxy, istr
+from yarl import URL
+
+DEFAULT_JSON_ENCODER = json.dumps
+DEFAULT_JSON_DECODER = json.loads
+
+if TYPE_CHECKING:
+    _CIMultiDict = CIMultiDict[str]
+    _CIMultiDictProxy = CIMultiDictProxy[str]
+    _MultiDict = MultiDict[str]
+    _MultiDictProxy = MultiDictProxy[str]
+    from http.cookies import BaseCookie, Morsel
+
+    from .web import Request, StreamResponse
+else:
+    _CIMultiDict = CIMultiDict
+    _CIMultiDictProxy = CIMultiDictProxy
+    _MultiDict = MultiDict
+    _MultiDictProxy = MultiDictProxy
+
+Byteish = Union[bytes, bytearray, memoryview]
+JSONEncoder = Callable[[Any], str]
+JSONDecoder = Callable[[str], Any]
+LooseHeaders = Union[Mapping[Union[str, istr], str], _CIMultiDict, _CIMultiDictProxy]
+RawHeaders = Tuple[Tuple[bytes, bytes], ...]
+StrOrURL = Union[str, URL]
+
+LooseCookiesMappings = Mapping[str, Union[str, "BaseCookie[str]", "Morsel[Any]"]]
+LooseCookiesIterables = Iterable[
+    Tuple[str, Union[str, "BaseCookie[str]", "Morsel[Any]"]]
+]
+LooseCookies = Union[
+    LooseCookiesMappings,
+    LooseCookiesIterables,
+    "BaseCookie[str]",
+]
+
+Handler = Callable[["Request"], Awaitable["StreamResponse"]]
+Middleware = Callable[["Request", Handler], Awaitable["StreamResponse"]]
+
+PathLike = Union[str, "os.PathLike[str]"]
diff --git a/llm/Lib/site-packages/aiohttp/web.py b/llm/Lib/site-packages/aiohttp/web.py
new file mode 100644
index 0000000000000000000000000000000000000000..95efc5a81b87d2a1324a110a4e73cad3c1226287
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web.py
@@ -0,0 +1,616 @@
+import asyncio
+import logging
+import os
+import socket
+import sys
+import warnings
+from argparse import ArgumentParser
+from collections.abc import Iterable
+from contextlib import suppress
+from functools import partial
+from importlib import import_module
+from typing import (
+    Any,
+    Awaitable,
+    Callable,
+    Iterable as TypingIterable,
+    List,
+    Optional,
+    Set,
+    Type,
+    Union,
+    cast,
+)
+from weakref import WeakSet
+
+from .abc import AbstractAccessLogger
+from .helpers import AppKey as AppKey
+from .log import access_logger
+from .typedefs import PathLike
+from .web_app import Application as Application, CleanupError as CleanupError
+from .web_exceptions import (
+    HTTPAccepted as HTTPAccepted,
+    HTTPBadGateway as HTTPBadGateway,
+    HTTPBadRequest as HTTPBadRequest,
+    HTTPClientError as HTTPClientError,
+    HTTPConflict as HTTPConflict,
+    HTTPCreated as HTTPCreated,
+    HTTPError as HTTPError,
+    HTTPException as HTTPException,
+    HTTPExpectationFailed as HTTPExpectationFailed,
+    HTTPFailedDependency as HTTPFailedDependency,
+    HTTPForbidden as HTTPForbidden,
+    HTTPFound as HTTPFound,
+    HTTPGatewayTimeout as HTTPGatewayTimeout,
+    HTTPGone as HTTPGone,
+    HTTPInsufficientStorage as HTTPInsufficientStorage,
+    HTTPInternalServerError as HTTPInternalServerError,
+    HTTPLengthRequired as HTTPLengthRequired,
+    HTTPMethodNotAllowed as HTTPMethodNotAllowed,
+    HTTPMisdirectedRequest as HTTPMisdirectedRequest,
+    HTTPMove as HTTPMove,
+    HTTPMovedPermanently as HTTPMovedPermanently,
+    HTTPMultipleChoices as HTTPMultipleChoices,
+    HTTPNetworkAuthenticationRequired as HTTPNetworkAuthenticationRequired,
+    HTTPNoContent as HTTPNoContent,
+    HTTPNonAuthoritativeInformation as HTTPNonAuthoritativeInformation,
+    HTTPNotAcceptable as HTTPNotAcceptable,
+    HTTPNotExtended as HTTPNotExtended,
+    HTTPNotFound as HTTPNotFound,
+    HTTPNotImplemented as HTTPNotImplemented,
+    HTTPNotModified as HTTPNotModified,
+    HTTPOk as HTTPOk,
+    HTTPPartialContent as HTTPPartialContent,
+    HTTPPaymentRequired as HTTPPaymentRequired,
+    HTTPPermanentRedirect as HTTPPermanentRedirect,
+    HTTPPreconditionFailed as HTTPPreconditionFailed,
+    HTTPPreconditionRequired as HTTPPreconditionRequired,
+    HTTPProxyAuthenticationRequired as HTTPProxyAuthenticationRequired,
+    HTTPRedirection as HTTPRedirection,
+    HTTPRequestEntityTooLarge as HTTPRequestEntityTooLarge,
+    HTTPRequestHeaderFieldsTooLarge as HTTPRequestHeaderFieldsTooLarge,
+    HTTPRequestRangeNotSatisfiable as HTTPRequestRangeNotSatisfiable,
+    HTTPRequestTimeout as HTTPRequestTimeout,
+    HTTPRequestURITooLong as HTTPRequestURITooLong,
+    HTTPResetContent as HTTPResetContent,
+    HTTPSeeOther as HTTPSeeOther,
+    HTTPServerError as HTTPServerError,
+    HTTPServiceUnavailable as HTTPServiceUnavailable,
+    HTTPSuccessful as HTTPSuccessful,
+    HTTPTemporaryRedirect as HTTPTemporaryRedirect,
+    HTTPTooManyRequests as HTTPTooManyRequests,
+    HTTPUnauthorized as HTTPUnauthorized,
+    HTTPUnavailableForLegalReasons as HTTPUnavailableForLegalReasons,
+    HTTPUnprocessableEntity as HTTPUnprocessableEntity,
+    HTTPUnsupportedMediaType as HTTPUnsupportedMediaType,
+    HTTPUpgradeRequired as HTTPUpgradeRequired,
+    HTTPUseProxy as HTTPUseProxy,
+    HTTPVariantAlsoNegotiates as HTTPVariantAlsoNegotiates,
+    HTTPVersionNotSupported as HTTPVersionNotSupported,
+    NotAppKeyWarning as NotAppKeyWarning,
+)
+from .web_fileresponse import FileResponse as FileResponse
+from .web_log import AccessLogger
+from .web_middlewares import (
+    middleware as middleware,
+    normalize_path_middleware as normalize_path_middleware,
+)
+from .web_protocol import (
+    PayloadAccessError as PayloadAccessError,
+    RequestHandler as RequestHandler,
+    RequestPayloadError as RequestPayloadError,
+)
+from .web_request import (
+    BaseRequest as BaseRequest,
+    FileField as FileField,
+    Request as Request,
+)
+from .web_response import (
+    ContentCoding as ContentCoding,
+    Response as Response,
+    StreamResponse as StreamResponse,
+    json_response as json_response,
+)
+from .web_routedef import (
+    AbstractRouteDef as AbstractRouteDef,
+    RouteDef as RouteDef,
+    RouteTableDef as RouteTableDef,
+    StaticDef as StaticDef,
+    delete as delete,
+    get as get,
+    head as head,
+    options as options,
+    patch as patch,
+    post as post,
+    put as put,
+    route as route,
+    static as static,
+    view as view,
+)
+from .web_runner import (
+    AppRunner as AppRunner,
+    BaseRunner as BaseRunner,
+    BaseSite as BaseSite,
+    GracefulExit as GracefulExit,
+    NamedPipeSite as NamedPipeSite,
+    ServerRunner as ServerRunner,
+    SockSite as SockSite,
+    TCPSite as TCPSite,
+    UnixSite as UnixSite,
+)
+from .web_server import Server as Server
+from .web_urldispatcher import (
+    AbstractResource as AbstractResource,
+    AbstractRoute as AbstractRoute,
+    DynamicResource as DynamicResource,
+    PlainResource as PlainResource,
+    PrefixedSubAppResource as PrefixedSubAppResource,
+    Resource as Resource,
+    ResourceRoute as ResourceRoute,
+    StaticResource as StaticResource,
+    UrlDispatcher as UrlDispatcher,
+    UrlMappingMatchInfo as UrlMappingMatchInfo,
+    View as View,
+)
+from .web_ws import (
+    WebSocketReady as WebSocketReady,
+    WebSocketResponse as WebSocketResponse,
+    WSMsgType as WSMsgType,
+)
+
+__all__ = (
+    # web_app
+    "AppKey",
+    "Application",
+    "CleanupError",
+    # web_exceptions
+    "NotAppKeyWarning",
+    "HTTPAccepted",
+    "HTTPBadGateway",
+    "HTTPBadRequest",
+    "HTTPClientError",
+    "HTTPConflict",
+    "HTTPCreated",
+    "HTTPError",
+    "HTTPException",
+    "HTTPExpectationFailed",
+    "HTTPFailedDependency",
+    "HTTPForbidden",
+    "HTTPFound",
+    "HTTPGatewayTimeout",
+    "HTTPGone",
+    "HTTPInsufficientStorage",
+    "HTTPInternalServerError",
+    "HTTPLengthRequired",
+    "HTTPMethodNotAllowed",
+    "HTTPMisdirectedRequest",
+    "HTTPMove",
+    "HTTPMovedPermanently",
+    "HTTPMultipleChoices",
+    "HTTPNetworkAuthenticationRequired",
+    "HTTPNoContent",
+    "HTTPNonAuthoritativeInformation",
+    "HTTPNotAcceptable",
+    "HTTPNotExtended",
+    "HTTPNotFound",
+    "HTTPNotImplemented",
+    "HTTPNotModified",
+    "HTTPOk",
+    "HTTPPartialContent",
+    "HTTPPaymentRequired",
+    "HTTPPermanentRedirect",
+    "HTTPPreconditionFailed",
+    "HTTPPreconditionRequired",
+    "HTTPProxyAuthenticationRequired",
+    "HTTPRedirection",
+    "HTTPRequestEntityTooLarge",
+    "HTTPRequestHeaderFieldsTooLarge",
+    "HTTPRequestRangeNotSatisfiable",
+    "HTTPRequestTimeout",
+    "HTTPRequestURITooLong",
+    "HTTPResetContent",
+    "HTTPSeeOther",
+    "HTTPServerError",
+    "HTTPServiceUnavailable",
+    "HTTPSuccessful",
+    "HTTPTemporaryRedirect",
+    "HTTPTooManyRequests",
+    "HTTPUnauthorized",
+    "HTTPUnavailableForLegalReasons",
+    "HTTPUnprocessableEntity",
+    "HTTPUnsupportedMediaType",
+    "HTTPUpgradeRequired",
+    "HTTPUseProxy",
+    "HTTPVariantAlsoNegotiates",
+    "HTTPVersionNotSupported",
+    # web_fileresponse
+    "FileResponse",
+    # web_middlewares
+    "middleware",
+    "normalize_path_middleware",
+    # web_protocol
+    "PayloadAccessError",
+    "RequestHandler",
+    "RequestPayloadError",
+    # web_request
+    "BaseRequest",
+    "FileField",
+    "Request",
+    # web_response
+    "ContentCoding",
+    "Response",
+    "StreamResponse",
+    "json_response",
+    # web_routedef
+    "AbstractRouteDef",
+    "RouteDef",
+    "RouteTableDef",
+    "StaticDef",
+    "delete",
+    "get",
+    "head",
+    "options",
+    "patch",
+    "post",
+    "put",
+    "route",
+    "static",
+    "view",
+    # web_runner
+    "AppRunner",
+    "BaseRunner",
+    "BaseSite",
+    "GracefulExit",
+    "ServerRunner",
+    "SockSite",
+    "TCPSite",
+    "UnixSite",
+    "NamedPipeSite",
+    # web_server
+    "Server",
+    # web_urldispatcher
+    "AbstractResource",
+    "AbstractRoute",
+    "DynamicResource",
+    "PlainResource",
+    "PrefixedSubAppResource",
+    "Resource",
+    "ResourceRoute",
+    "StaticResource",
+    "UrlDispatcher",
+    "UrlMappingMatchInfo",
+    "View",
+    # web_ws
+    "WebSocketReady",
+    "WebSocketResponse",
+    "WSMsgType",
+    # web
+    "run_app",
+)
+
+
+try:
+    from ssl import SSLContext
+except ImportError:  # pragma: no cover
+    SSLContext = Any  # type: ignore[misc,assignment]
+
+# Only display warning when using -Wdefault, -We, -X dev or similar.
+warnings.filterwarnings("ignore", category=NotAppKeyWarning, append=True)
+
+HostSequence = TypingIterable[str]
+
+
+async def _run_app(
+    app: Union[Application, Awaitable[Application]],
+    *,
+    host: Optional[Union[str, HostSequence]] = None,
+    port: Optional[int] = None,
+    path: Union[PathLike, TypingIterable[PathLike], None] = None,
+    sock: Optional[Union[socket.socket, TypingIterable[socket.socket]]] = None,
+    shutdown_timeout: float = 60.0,
+    keepalive_timeout: float = 75.0,
+    ssl_context: Optional[SSLContext] = None,
+    print: Optional[Callable[..., None]] = print,
+    backlog: int = 128,
+    access_log_class: Type[AbstractAccessLogger] = AccessLogger,
+    access_log_format: str = AccessLogger.LOG_FORMAT,
+    access_log: Optional[logging.Logger] = access_logger,
+    handle_signals: bool = True,
+    reuse_address: Optional[bool] = None,
+    reuse_port: Optional[bool] = None,
+    handler_cancellation: bool = False,
+) -> None:
+    async def wait(
+        starting_tasks: "WeakSet[asyncio.Task[object]]", shutdown_timeout: float
+    ) -> None:
+        # Wait for pending tasks for a given time limit.
+        t = asyncio.current_task()
+        assert t is not None
+        starting_tasks.add(t)
+        with suppress(asyncio.TimeoutError):
+            await asyncio.wait_for(_wait(starting_tasks), timeout=shutdown_timeout)
+
+    async def _wait(exclude: "WeakSet[asyncio.Task[object]]") -> None:
+        t = asyncio.current_task()
+        assert t is not None
+        exclude.add(t)
+        while tasks := asyncio.all_tasks().difference(exclude):
+            await asyncio.wait(tasks)
+
+    # An internal function to actually do all dirty job for application running
+    if asyncio.iscoroutine(app):
+        app = await app
+
+    app = cast(Application, app)
+
+    runner = AppRunner(
+        app,
+        handle_signals=handle_signals,
+        access_log_class=access_log_class,
+        access_log_format=access_log_format,
+        access_log=access_log,
+        keepalive_timeout=keepalive_timeout,
+        shutdown_timeout=shutdown_timeout,
+        handler_cancellation=handler_cancellation,
+    )
+
+    await runner.setup()
+    # On shutdown we want to avoid waiting on tasks which run forever.
+    # It's very likely that all tasks which run forever will have been created by
+    # the time we have completed the application startup (in runner.setup()),
+    # so we just record all running tasks here and exclude them later.
+    starting_tasks: "WeakSet[asyncio.Task[object]]" = WeakSet(asyncio.all_tasks())
+    runner.shutdown_callback = partial(wait, starting_tasks, shutdown_timeout)
+
+    sites: List[BaseSite] = []
+
+    try:
+        if host is not None:
+            if isinstance(host, (str, bytes, bytearray, memoryview)):
+                sites.append(
+                    TCPSite(
+                        runner,
+                        host,
+                        port,
+                        ssl_context=ssl_context,
+                        backlog=backlog,
+                        reuse_address=reuse_address,
+                        reuse_port=reuse_port,
+                    )
+                )
+            else:
+                for h in host:
+                    sites.append(
+                        TCPSite(
+                            runner,
+                            h,
+                            port,
+                            ssl_context=ssl_context,
+                            backlog=backlog,
+                            reuse_address=reuse_address,
+                            reuse_port=reuse_port,
+                        )
+                    )
+        elif path is None and sock is None or port is not None:
+            sites.append(
+                TCPSite(
+                    runner,
+                    port=port,
+                    ssl_context=ssl_context,
+                    backlog=backlog,
+                    reuse_address=reuse_address,
+                    reuse_port=reuse_port,
+                )
+            )
+
+        if path is not None:
+            if isinstance(path, (str, os.PathLike)):
+                sites.append(
+                    UnixSite(
+                        runner,
+                        path,
+                        ssl_context=ssl_context,
+                        backlog=backlog,
+                    )
+                )
+            else:
+                for p in path:
+                    sites.append(
+                        UnixSite(
+                            runner,
+                            p,
+                            ssl_context=ssl_context,
+                            backlog=backlog,
+                        )
+                    )
+
+        if sock is not None:
+            if not isinstance(sock, Iterable):
+                sites.append(
+                    SockSite(
+                        runner,
+                        sock,
+                        ssl_context=ssl_context,
+                        backlog=backlog,
+                    )
+                )
+            else:
+                for s in sock:
+                    sites.append(
+                        SockSite(
+                            runner,
+                            s,
+                            ssl_context=ssl_context,
+                            backlog=backlog,
+                        )
+                    )
+        for site in sites:
+            await site.start()
+
+        if print:  # pragma: no branch
+            names = sorted(str(s.name) for s in runner.sites)
+            print(
+                "======== Running on {} ========\n"
+                "(Press CTRL+C to quit)".format(", ".join(names))
+            )
+
+        # sleep forever by 1 hour intervals,
+        while True:
+            await asyncio.sleep(3600)
+    finally:
+        await runner.cleanup()
+
+
+def _cancel_tasks(
+    to_cancel: Set["asyncio.Task[Any]"], loop: asyncio.AbstractEventLoop
+) -> None:
+    if not to_cancel:
+        return
+
+    for task in to_cancel:
+        task.cancel()
+
+    loop.run_until_complete(asyncio.gather(*to_cancel, return_exceptions=True))
+
+    for task in to_cancel:
+        if task.cancelled():
+            continue
+        if task.exception() is not None:
+            loop.call_exception_handler(
+                {
+                    "message": "unhandled exception during asyncio.run() shutdown",
+                    "exception": task.exception(),
+                    "task": task,
+                }
+            )
+
+
+def run_app(
+    app: Union[Application, Awaitable[Application]],
+    *,
+    host: Optional[Union[str, HostSequence]] = None,
+    port: Optional[int] = None,
+    path: Union[PathLike, TypingIterable[PathLike], None] = None,
+    sock: Optional[Union[socket.socket, TypingIterable[socket.socket]]] = None,
+    shutdown_timeout: float = 60.0,
+    keepalive_timeout: float = 75.0,
+    ssl_context: Optional[SSLContext] = None,
+    print: Optional[Callable[..., None]] = print,
+    backlog: int = 128,
+    access_log_class: Type[AbstractAccessLogger] = AccessLogger,
+    access_log_format: str = AccessLogger.LOG_FORMAT,
+    access_log: Optional[logging.Logger] = access_logger,
+    handle_signals: bool = True,
+    reuse_address: Optional[bool] = None,
+    reuse_port: Optional[bool] = None,
+    handler_cancellation: bool = False,
+    loop: Optional[asyncio.AbstractEventLoop] = None,
+) -> None:
+    """Run an app locally"""
+    if loop is None:
+        loop = asyncio.new_event_loop()
+
+    # Configure if and only if in debugging mode and using the default logger
+    if loop.get_debug() and access_log and access_log.name == "aiohttp.access":
+        if access_log.level == logging.NOTSET:
+            access_log.setLevel(logging.DEBUG)
+        if not access_log.hasHandlers():
+            access_log.addHandler(logging.StreamHandler())
+
+    main_task = loop.create_task(
+        _run_app(
+            app,
+            host=host,
+            port=port,
+            path=path,
+            sock=sock,
+            shutdown_timeout=shutdown_timeout,
+            keepalive_timeout=keepalive_timeout,
+            ssl_context=ssl_context,
+            print=print,
+            backlog=backlog,
+            access_log_class=access_log_class,
+            access_log_format=access_log_format,
+            access_log=access_log,
+            handle_signals=handle_signals,
+            reuse_address=reuse_address,
+            reuse_port=reuse_port,
+            handler_cancellation=handler_cancellation,
+        )
+    )
+
+    try:
+        asyncio.set_event_loop(loop)
+        loop.run_until_complete(main_task)
+    except (GracefulExit, KeyboardInterrupt):  # pragma: no cover
+        pass
+    finally:
+        _cancel_tasks({main_task}, loop)
+        _cancel_tasks(asyncio.all_tasks(loop), loop)
+        loop.run_until_complete(loop.shutdown_asyncgens())
+        loop.close()
+
+
+def main(argv: List[str]) -> None:
+    arg_parser = ArgumentParser(
+        description="aiohttp.web Application server", prog="aiohttp.web"
+    )
+    arg_parser.add_argument(
+        "entry_func",
+        help=(
+            "Callable returning the `aiohttp.web.Application` instance to "
+            "run. Should be specified in the 'module:function' syntax."
+        ),
+        metavar="entry-func",
+    )
+    arg_parser.add_argument(
+        "-H",
+        "--hostname",
+        help="TCP/IP hostname to serve on (default: %(default)r)",
+        default="localhost",
+    )
+    arg_parser.add_argument(
+        "-P",
+        "--port",
+        help="TCP/IP port to serve on (default: %(default)r)",
+        type=int,
+        default="8080",
+    )
+    arg_parser.add_argument(
+        "-U",
+        "--path",
+        help="Unix file system path to serve on. Specifying a path will cause "
+        "hostname and port arguments to be ignored.",
+    )
+    args, extra_argv = arg_parser.parse_known_args(argv)
+
+    # Import logic
+    mod_str, _, func_str = args.entry_func.partition(":")
+    if not func_str or not mod_str:
+        arg_parser.error("'entry-func' not in 'module:function' syntax")
+    if mod_str.startswith("."):
+        arg_parser.error("relative module names not supported")
+    try:
+        module = import_module(mod_str)
+    except ImportError as ex:
+        arg_parser.error(f"unable to import {mod_str}: {ex}")
+    try:
+        func = getattr(module, func_str)
+    except AttributeError:
+        arg_parser.error(f"module {mod_str!r} has no attribute {func_str!r}")
+
+    # Compatibility logic
+    if args.path is not None and not hasattr(socket, "AF_UNIX"):
+        arg_parser.error(
+            "file system paths not supported by your operating" " environment"
+        )
+
+    logging.basicConfig(level=logging.DEBUG)
+
+    app = func(extra_argv)
+    run_app(app, host=args.hostname, port=args.port, path=args.path)
+    arg_parser.exit(message="Stopped\n")
+
+
+if __name__ == "__main__":  # pragma: no branch
+    main(sys.argv[1:])  # pragma: no cover
diff --git a/llm/Lib/site-packages/aiohttp/web_app.py b/llm/Lib/site-packages/aiohttp/web_app.py
new file mode 100644
index 0000000000000000000000000000000000000000..0da4021d38a67f79f4f725b7f7e4dc964d6766ec
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web_app.py
@@ -0,0 +1,596 @@
+import asyncio
+import logging
+import warnings
+from functools import partial, update_wrapper
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Awaitable,
+    Callable,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    MutableMapping,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+    overload,
+)
+
+from aiosignal import Signal
+from frozenlist import FrozenList
+
+from . import hdrs
+from .abc import (
+    AbstractAccessLogger,
+    AbstractMatchInfo,
+    AbstractRouter,
+    AbstractStreamWriter,
+)
+from .helpers import DEBUG, AppKey
+from .http_parser import RawRequestMessage
+from .log import web_logger
+from .streams import StreamReader
+from .typedefs import Middleware
+from .web_exceptions import NotAppKeyWarning
+from .web_log import AccessLogger
+from .web_middlewares import _fix_request_current_app
+from .web_protocol import RequestHandler
+from .web_request import Request
+from .web_response import StreamResponse
+from .web_routedef import AbstractRouteDef
+from .web_server import Server
+from .web_urldispatcher import (
+    AbstractResource,
+    AbstractRoute,
+    Domain,
+    MaskDomain,
+    MatchedSubAppResource,
+    PrefixedSubAppResource,
+    UrlDispatcher,
+)
+
+__all__ = ("Application", "CleanupError")
+
+
+if TYPE_CHECKING:
+    _AppSignal = Signal[Callable[["Application"], Awaitable[None]]]
+    _RespPrepareSignal = Signal[Callable[[Request, StreamResponse], Awaitable[None]]]
+    _Middlewares = FrozenList[Middleware]
+    _MiddlewaresHandlers = Optional[Sequence[Tuple[Middleware, bool]]]
+    _Subapps = List["Application"]
+else:
+    # No type checker mode, skip types
+    _AppSignal = Signal
+    _RespPrepareSignal = Signal
+    _Middlewares = FrozenList
+    _MiddlewaresHandlers = Optional[Sequence]
+    _Subapps = List
+
+_T = TypeVar("_T")
+_U = TypeVar("_U")
+
+
+class Application(MutableMapping[Union[str, AppKey[Any]], Any]):
+    ATTRS = frozenset(
+        [
+            "logger",
+            "_debug",
+            "_router",
+            "_loop",
+            "_handler_args",
+            "_middlewares",
+            "_middlewares_handlers",
+            "_run_middlewares",
+            "_state",
+            "_frozen",
+            "_pre_frozen",
+            "_subapps",
+            "_on_response_prepare",
+            "_on_startup",
+            "_on_shutdown",
+            "_on_cleanup",
+            "_client_max_size",
+            "_cleanup_ctx",
+        ]
+    )
+
+    def __init__(
+        self,
+        *,
+        logger: logging.Logger = web_logger,
+        router: Optional[UrlDispatcher] = None,
+        middlewares: Iterable[Middleware] = (),
+        handler_args: Optional[Mapping[str, Any]] = None,
+        client_max_size: int = 1024**2,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        debug: Any = ...,  # mypy doesn't support ellipsis
+    ) -> None:
+        if router is None:
+            router = UrlDispatcher()
+        else:
+            warnings.warn(
+                "router argument is deprecated", DeprecationWarning, stacklevel=2
+            )
+        assert isinstance(router, AbstractRouter), router
+
+        if loop is not None:
+            warnings.warn(
+                "loop argument is deprecated", DeprecationWarning, stacklevel=2
+            )
+
+        if debug is not ...:
+            warnings.warn(
+                "debug argument is deprecated", DeprecationWarning, stacklevel=2
+            )
+        self._debug = debug
+        self._router: UrlDispatcher = router
+        self._loop = loop
+        self._handler_args = handler_args
+        self.logger = logger
+
+        self._middlewares: _Middlewares = FrozenList(middlewares)
+
+        # initialized on freezing
+        self._middlewares_handlers: _MiddlewaresHandlers = None
+        # initialized on freezing
+        self._run_middlewares: Optional[bool] = None
+
+        self._state: Dict[Union[AppKey[Any], str], object] = {}
+        self._frozen = False
+        self._pre_frozen = False
+        self._subapps: _Subapps = []
+
+        self._on_response_prepare: _RespPrepareSignal = Signal(self)
+        self._on_startup: _AppSignal = Signal(self)
+        self._on_shutdown: _AppSignal = Signal(self)
+        self._on_cleanup: _AppSignal = Signal(self)
+        self._cleanup_ctx = CleanupContext()
+        self._on_startup.append(self._cleanup_ctx._on_startup)
+        self._on_cleanup.append(self._cleanup_ctx._on_cleanup)
+        self._client_max_size = client_max_size
+
+    def __init_subclass__(cls: Type["Application"]) -> None:
+        warnings.warn(
+            "Inheritance class {} from web.Application "
+            "is discouraged".format(cls.__name__),
+            DeprecationWarning,
+            stacklevel=3,
+        )
+
+    if DEBUG:  # pragma: no cover
+
+        def __setattr__(self, name: str, val: Any) -> None:
+            if name not in self.ATTRS:
+                warnings.warn(
+                    "Setting custom web.Application.{} attribute "
+                    "is discouraged".format(name),
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+            super().__setattr__(name, val)
+
+    # MutableMapping API
+
+    def __eq__(self, other: object) -> bool:
+        return self is other
+
+    @overload  # type: ignore[override]
+    def __getitem__(self, key: AppKey[_T]) -> _T:
+        ...
+
+    @overload
+    def __getitem__(self, key: str) -> Any:
+        ...
+
+    def __getitem__(self, key: Union[str, AppKey[_T]]) -> Any:
+        return self._state[key]
+
+    def _check_frozen(self) -> None:
+        if self._frozen:
+            warnings.warn(
+                "Changing state of started or joined " "application is deprecated",
+                DeprecationWarning,
+                stacklevel=3,
+            )
+
+    @overload  # type: ignore[override]
+    def __setitem__(self, key: AppKey[_T], value: _T) -> None:
+        ...
+
+    @overload
+    def __setitem__(self, key: str, value: Any) -> None:
+        ...
+
+    def __setitem__(self, key: Union[str, AppKey[_T]], value: Any) -> None:
+        self._check_frozen()
+        if not isinstance(key, AppKey):
+            warnings.warn(
+                "It is recommended to use web.AppKey instances for keys.\n"
+                + "https://docs.aiohttp.org/en/stable/web_advanced.html"
+                + "#application-s-config",
+                category=NotAppKeyWarning,
+                stacklevel=2,
+            )
+        self._state[key] = value
+
+    def __delitem__(self, key: Union[str, AppKey[_T]]) -> None:
+        self._check_frozen()
+        del self._state[key]
+
+    def __len__(self) -> int:
+        return len(self._state)
+
+    def __iter__(self) -> Iterator[Union[str, AppKey[Any]]]:
+        return iter(self._state)
+
+    @overload  # type: ignore[override]
+    def get(self, key: AppKey[_T], default: None = ...) -> Optional[_T]:
+        ...
+
+    @overload
+    def get(self, key: AppKey[_T], default: _U) -> Union[_T, _U]:
+        ...
+
+    @overload
+    def get(self, key: str, default: Any = ...) -> Any:
+        ...
+
+    def get(self, key: Union[str, AppKey[_T]], default: Any = None) -> Any:
+        return self._state.get(key, default)
+
+    ########
+    @property
+    def loop(self) -> asyncio.AbstractEventLoop:
+        # Technically the loop can be None
+        # but we mask it by explicit type cast
+        # to provide more convenient type annotation
+        warnings.warn("loop property is deprecated", DeprecationWarning, stacklevel=2)
+        return cast(asyncio.AbstractEventLoop, self._loop)
+
+    def _set_loop(self, loop: Optional[asyncio.AbstractEventLoop]) -> None:
+        if loop is None:
+            loop = asyncio.get_event_loop()
+        if self._loop is not None and self._loop is not loop:
+            raise RuntimeError(
+                "web.Application instance initialized with different loop"
+            )
+
+        self._loop = loop
+
+        # set loop debug
+        if self._debug is ...:
+            self._debug = loop.get_debug()
+
+        # set loop to sub applications
+        for subapp in self._subapps:
+            subapp._set_loop(loop)
+
+    @property
+    def pre_frozen(self) -> bool:
+        return self._pre_frozen
+
+    def pre_freeze(self) -> None:
+        if self._pre_frozen:
+            return
+
+        self._pre_frozen = True
+        self._middlewares.freeze()
+        self._router.freeze()
+        self._on_response_prepare.freeze()
+        self._cleanup_ctx.freeze()
+        self._on_startup.freeze()
+        self._on_shutdown.freeze()
+        self._on_cleanup.freeze()
+        self._middlewares_handlers = tuple(self._prepare_middleware())
+
+        # If current app and any subapp do not have middlewares avoid run all
+        # of the code footprint that it implies, which have a middleware
+        # hardcoded per app that sets up the current_app attribute. If no
+        # middlewares are configured the handler will receive the proper
+        # current_app without needing all of this code.
+        self._run_middlewares = True if self.middlewares else False
+
+        for subapp in self._subapps:
+            subapp.pre_freeze()
+            self._run_middlewares = self._run_middlewares or subapp._run_middlewares
+
+    @property
+    def frozen(self) -> bool:
+        return self._frozen
+
+    def freeze(self) -> None:
+        if self._frozen:
+            return
+
+        self.pre_freeze()
+        self._frozen = True
+        for subapp in self._subapps:
+            subapp.freeze()
+
+    @property
+    def debug(self) -> bool:
+        warnings.warn("debug property is deprecated", DeprecationWarning, stacklevel=2)
+        return self._debug  # type: ignore[no-any-return]
+
+    def _reg_subapp_signals(self, subapp: "Application") -> None:
+        def reg_handler(signame: str) -> None:
+            subsig = getattr(subapp, signame)
+
+            async def handler(app: "Application") -> None:
+                await subsig.send(subapp)
+
+            appsig = getattr(self, signame)
+            appsig.append(handler)
+
+        reg_handler("on_startup")
+        reg_handler("on_shutdown")
+        reg_handler("on_cleanup")
+
+    def add_subapp(self, prefix: str, subapp: "Application") -> AbstractResource:
+        if not isinstance(prefix, str):
+            raise TypeError("Prefix must be str")
+        prefix = prefix.rstrip("/")
+        if not prefix:
+            raise ValueError("Prefix cannot be empty")
+        factory = partial(PrefixedSubAppResource, prefix, subapp)
+        return self._add_subapp(factory, subapp)
+
+    def _add_subapp(
+        self, resource_factory: Callable[[], AbstractResource], subapp: "Application"
+    ) -> AbstractResource:
+        if self.frozen:
+            raise RuntimeError("Cannot add sub application to frozen application")
+        if subapp.frozen:
+            raise RuntimeError("Cannot add frozen application")
+        resource = resource_factory()
+        self.router.register_resource(resource)
+        self._reg_subapp_signals(subapp)
+        self._subapps.append(subapp)
+        subapp.pre_freeze()
+        if self._loop is not None:
+            subapp._set_loop(self._loop)
+        return resource
+
+    def add_domain(self, domain: str, subapp: "Application") -> AbstractResource:
+        if not isinstance(domain, str):
+            raise TypeError("Domain must be str")
+        elif "*" in domain:
+            rule: Domain = MaskDomain(domain)
+        else:
+            rule = Domain(domain)
+        factory = partial(MatchedSubAppResource, rule, subapp)
+        return self._add_subapp(factory, subapp)
+
+    def add_routes(self, routes: Iterable[AbstractRouteDef]) -> List[AbstractRoute]:
+        return self.router.add_routes(routes)
+
+    @property
+    def on_response_prepare(self) -> _RespPrepareSignal:
+        return self._on_response_prepare
+
+    @property
+    def on_startup(self) -> _AppSignal:
+        return self._on_startup
+
+    @property
+    def on_shutdown(self) -> _AppSignal:
+        return self._on_shutdown
+
+    @property
+    def on_cleanup(self) -> _AppSignal:
+        return self._on_cleanup
+
+    @property
+    def cleanup_ctx(self) -> "CleanupContext":
+        return self._cleanup_ctx
+
+    @property
+    def router(self) -> UrlDispatcher:
+        return self._router
+
+    @property
+    def middlewares(self) -> _Middlewares:
+        return self._middlewares
+
+    def _make_handler(
+        self,
+        *,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        access_log_class: Type[AbstractAccessLogger] = AccessLogger,
+        **kwargs: Any,
+    ) -> Server:
+
+        if not issubclass(access_log_class, AbstractAccessLogger):
+            raise TypeError(
+                "access_log_class must be subclass of "
+                "aiohttp.abc.AbstractAccessLogger, got {}".format(access_log_class)
+            )
+
+        self._set_loop(loop)
+        self.freeze()
+
+        kwargs["debug"] = self._debug
+        kwargs["access_log_class"] = access_log_class
+        if self._handler_args:
+            for k, v in self._handler_args.items():
+                kwargs[k] = v
+
+        return Server(
+            self._handle,  # type: ignore[arg-type]
+            request_factory=self._make_request,
+            loop=self._loop,
+            **kwargs,
+        )
+
+    def make_handler(
+        self,
+        *,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        access_log_class: Type[AbstractAccessLogger] = AccessLogger,
+        **kwargs: Any,
+    ) -> Server:
+
+        warnings.warn(
+            "Application.make_handler(...) is deprecated, " "use AppRunner API instead",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+
+        return self._make_handler(
+            loop=loop, access_log_class=access_log_class, **kwargs
+        )
+
+    async def startup(self) -> None:
+        """Causes on_startup signal
+
+        Should be called in the event loop along with the request handler.
+        """
+        await self.on_startup.send(self)
+
+    async def shutdown(self) -> None:
+        """Causes on_shutdown signal
+
+        Should be called before cleanup()
+        """
+        await self.on_shutdown.send(self)
+
+    async def cleanup(self) -> None:
+        """Causes on_cleanup signal
+
+        Should be called after shutdown()
+        """
+        if self.on_cleanup.frozen:
+            await self.on_cleanup.send(self)
+        else:
+            # If an exception occurs in startup, ensure cleanup contexts are completed.
+            await self._cleanup_ctx._on_cleanup(self)
+
+    def _make_request(
+        self,
+        message: RawRequestMessage,
+        payload: StreamReader,
+        protocol: RequestHandler,
+        writer: AbstractStreamWriter,
+        task: "asyncio.Task[None]",
+        _cls: Type[Request] = Request,
+    ) -> Request:
+        return _cls(
+            message,
+            payload,
+            protocol,
+            writer,
+            task,
+            self._loop,
+            client_max_size=self._client_max_size,
+        )
+
+    def _prepare_middleware(self) -> Iterator[Tuple[Middleware, bool]]:
+        for m in reversed(self._middlewares):
+            if getattr(m, "__middleware_version__", None) == 1:
+                yield m, True
+            else:
+                warnings.warn(
+                    'old-style middleware "{!r}" deprecated, ' "see #2252".format(m),
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+                yield m, False
+
+        yield _fix_request_current_app(self), True
+
+    async def _handle(self, request: Request) -> StreamResponse:
+        loop = asyncio.get_event_loop()
+        debug = loop.get_debug()
+        match_info = await self._router.resolve(request)
+        if debug:  # pragma: no cover
+            if not isinstance(match_info, AbstractMatchInfo):
+                raise TypeError(
+                    "match_info should be AbstractMatchInfo "
+                    "instance, not {!r}".format(match_info)
+                )
+        match_info.add_app(self)
+
+        match_info.freeze()
+
+        resp = None
+        request._match_info = match_info
+        expect = request.headers.get(hdrs.EXPECT)
+        if expect:
+            resp = await match_info.expect_handler(request)
+            await request.writer.drain()
+
+        if resp is None:
+            handler = match_info.handler
+
+            if self._run_middlewares:
+                for app in match_info.apps[::-1]:
+                    for m, new_style in app._middlewares_handlers:  # type: ignore[union-attr]
+                        if new_style:
+                            handler = update_wrapper(
+                                partial(m, handler=handler), handler
+                            )
+                        else:
+                            handler = await m(app, handler)  # type: ignore[arg-type,assignment]
+
+            resp = await handler(request)
+
+        return resp
+
+    def __call__(self) -> "Application":
+        """gunicorn compatibility"""
+        return self
+
+    def __repr__(self) -> str:
+        return f"<Application 0x{id(self):x}>"
+
+    def __bool__(self) -> bool:
+        return True
+
+
+class CleanupError(RuntimeError):
+    @property
+    def exceptions(self) -> List[BaseException]:
+        return cast(List[BaseException], self.args[1])
+
+
+if TYPE_CHECKING:
+    _CleanupContextBase = FrozenList[Callable[[Application], AsyncIterator[None]]]
+else:
+    _CleanupContextBase = FrozenList
+
+
+class CleanupContext(_CleanupContextBase):
+    def __init__(self) -> None:
+        super().__init__()
+        self._exits: List[AsyncIterator[None]] = []
+
+    async def _on_startup(self, app: Application) -> None:
+        for cb in self:
+            it = cb(app).__aiter__()
+            await it.__anext__()
+            self._exits.append(it)
+
+    async def _on_cleanup(self, app: Application) -> None:
+        errors = []
+        for it in reversed(self._exits):
+            try:
+                await it.__anext__()
+            except StopAsyncIteration:
+                pass
+            except Exception as exc:
+                errors.append(exc)
+            else:
+                errors.append(RuntimeError(f"{it!r} has more than one 'yield'"))
+        if errors:
+            if len(errors) == 1:
+                raise errors[0]
+            else:
+                raise CleanupError("Multiple errors on cleanup stage", errors)
diff --git a/llm/Lib/site-packages/aiohttp/web_exceptions.py b/llm/Lib/site-packages/aiohttp/web_exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..49184109378542202a441366d324c50c0190705e
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web_exceptions.py
@@ -0,0 +1,452 @@
+import warnings
+from typing import Any, Dict, Iterable, List, Optional, Set  # noqa
+
+from yarl import URL
+
+from .typedefs import LooseHeaders, StrOrURL
+from .web_response import Response
+
+__all__ = (
+    "HTTPException",
+    "HTTPError",
+    "HTTPRedirection",
+    "HTTPSuccessful",
+    "HTTPOk",
+    "HTTPCreated",
+    "HTTPAccepted",
+    "HTTPNonAuthoritativeInformation",
+    "HTTPNoContent",
+    "HTTPResetContent",
+    "HTTPPartialContent",
+    "HTTPMove",
+    "HTTPMultipleChoices",
+    "HTTPMovedPermanently",
+    "HTTPFound",
+    "HTTPSeeOther",
+    "HTTPNotModified",
+    "HTTPUseProxy",
+    "HTTPTemporaryRedirect",
+    "HTTPPermanentRedirect",
+    "HTTPClientError",
+    "HTTPBadRequest",
+    "HTTPUnauthorized",
+    "HTTPPaymentRequired",
+    "HTTPForbidden",
+    "HTTPNotFound",
+    "HTTPMethodNotAllowed",
+    "HTTPNotAcceptable",
+    "HTTPProxyAuthenticationRequired",
+    "HTTPRequestTimeout",
+    "HTTPConflict",
+    "HTTPGone",
+    "HTTPLengthRequired",
+    "HTTPPreconditionFailed",
+    "HTTPRequestEntityTooLarge",
+    "HTTPRequestURITooLong",
+    "HTTPUnsupportedMediaType",
+    "HTTPRequestRangeNotSatisfiable",
+    "HTTPExpectationFailed",
+    "HTTPMisdirectedRequest",
+    "HTTPUnprocessableEntity",
+    "HTTPFailedDependency",
+    "HTTPUpgradeRequired",
+    "HTTPPreconditionRequired",
+    "HTTPTooManyRequests",
+    "HTTPRequestHeaderFieldsTooLarge",
+    "HTTPUnavailableForLegalReasons",
+    "HTTPServerError",
+    "HTTPInternalServerError",
+    "HTTPNotImplemented",
+    "HTTPBadGateway",
+    "HTTPServiceUnavailable",
+    "HTTPGatewayTimeout",
+    "HTTPVersionNotSupported",
+    "HTTPVariantAlsoNegotiates",
+    "HTTPInsufficientStorage",
+    "HTTPNotExtended",
+    "HTTPNetworkAuthenticationRequired",
+)
+
+
+class NotAppKeyWarning(UserWarning):
+    """Warning when not using AppKey in Application."""
+
+
+############################################################
+# HTTP Exceptions
+############################################################
+
+
+class HTTPException(Response, Exception):
+
+    # You should set in subclasses:
+    # status = 200
+
+    status_code = -1
+    empty_body = False
+
+    __http_exception__ = True
+
+    def __init__(
+        self,
+        *,
+        headers: Optional[LooseHeaders] = None,
+        reason: Optional[str] = None,
+        body: Any = None,
+        text: Optional[str] = None,
+        content_type: Optional[str] = None,
+    ) -> None:
+        if body is not None:
+            warnings.warn(
+                "body argument is deprecated for http web exceptions",
+                DeprecationWarning,
+            )
+        Response.__init__(
+            self,
+            status=self.status_code,
+            headers=headers,
+            reason=reason,
+            body=body,
+            text=text,
+            content_type=content_type,
+        )
+        Exception.__init__(self, self.reason)
+        if self.body is None and not self.empty_body:
+            self.text = f"{self.status}: {self.reason}"
+
+    def __bool__(self) -> bool:
+        return True
+
+
+class HTTPError(HTTPException):
+    """Base class for exceptions with status codes in the 400s and 500s."""
+
+
+class HTTPRedirection(HTTPException):
+    """Base class for exceptions with status codes in the 300s."""
+
+
+class HTTPSuccessful(HTTPException):
+    """Base class for exceptions with status codes in the 200s."""
+
+
+class HTTPOk(HTTPSuccessful):
+    status_code = 200
+
+
+class HTTPCreated(HTTPSuccessful):
+    status_code = 201
+
+
+class HTTPAccepted(HTTPSuccessful):
+    status_code = 202
+
+
+class HTTPNonAuthoritativeInformation(HTTPSuccessful):
+    status_code = 203
+
+
+class HTTPNoContent(HTTPSuccessful):
+    status_code = 204
+    empty_body = True
+
+
+class HTTPResetContent(HTTPSuccessful):
+    status_code = 205
+    empty_body = True
+
+
+class HTTPPartialContent(HTTPSuccessful):
+    status_code = 206
+
+
+############################################################
+# 3xx redirection
+############################################################
+
+
+class HTTPMove(HTTPRedirection):
+    def __init__(
+        self,
+        location: StrOrURL,
+        *,
+        headers: Optional[LooseHeaders] = None,
+        reason: Optional[str] = None,
+        body: Any = None,
+        text: Optional[str] = None,
+        content_type: Optional[str] = None,
+    ) -> None:
+        if not location:
+            raise ValueError("HTTP redirects need a location to redirect to.")
+        super().__init__(
+            headers=headers,
+            reason=reason,
+            body=body,
+            text=text,
+            content_type=content_type,
+        )
+        self.headers["Location"] = str(URL(location))
+        self.location = location
+
+
+class HTTPMultipleChoices(HTTPMove):
+    status_code = 300
+
+
+class HTTPMovedPermanently(HTTPMove):
+    status_code = 301
+
+
+class HTTPFound(HTTPMove):
+    status_code = 302
+
+
+# This one is safe after a POST (the redirected location will be
+# retrieved with GET):
+class HTTPSeeOther(HTTPMove):
+    status_code = 303
+
+
+class HTTPNotModified(HTTPRedirection):
+    # FIXME: this should include a date or etag header
+    status_code = 304
+    empty_body = True
+
+
+class HTTPUseProxy(HTTPMove):
+    # Not a move, but looks a little like one
+    status_code = 305
+
+
+class HTTPTemporaryRedirect(HTTPMove):
+    status_code = 307
+
+
+class HTTPPermanentRedirect(HTTPMove):
+    status_code = 308
+
+
+############################################################
+# 4xx client error
+############################################################
+
+
+class HTTPClientError(HTTPError):
+    pass
+
+
+class HTTPBadRequest(HTTPClientError):
+    status_code = 400
+
+
+class HTTPUnauthorized(HTTPClientError):
+    status_code = 401
+
+
+class HTTPPaymentRequired(HTTPClientError):
+    status_code = 402
+
+
+class HTTPForbidden(HTTPClientError):
+    status_code = 403
+
+
+class HTTPNotFound(HTTPClientError):
+    status_code = 404
+
+
+class HTTPMethodNotAllowed(HTTPClientError):
+    status_code = 405
+
+    def __init__(
+        self,
+        method: str,
+        allowed_methods: Iterable[str],
+        *,
+        headers: Optional[LooseHeaders] = None,
+        reason: Optional[str] = None,
+        body: Any = None,
+        text: Optional[str] = None,
+        content_type: Optional[str] = None,
+    ) -> None:
+        allow = ",".join(sorted(allowed_methods))
+        super().__init__(
+            headers=headers,
+            reason=reason,
+            body=body,
+            text=text,
+            content_type=content_type,
+        )
+        self.headers["Allow"] = allow
+        self.allowed_methods: Set[str] = set(allowed_methods)
+        self.method = method.upper()
+
+
+class HTTPNotAcceptable(HTTPClientError):
+    status_code = 406
+
+
+class HTTPProxyAuthenticationRequired(HTTPClientError):
+    status_code = 407
+
+
+class HTTPRequestTimeout(HTTPClientError):
+    status_code = 408
+
+
+class HTTPConflict(HTTPClientError):
+    status_code = 409
+
+
+class HTTPGone(HTTPClientError):
+    status_code = 410
+
+
+class HTTPLengthRequired(HTTPClientError):
+    status_code = 411
+
+
+class HTTPPreconditionFailed(HTTPClientError):
+    status_code = 412
+
+
+class HTTPRequestEntityTooLarge(HTTPClientError):
+    status_code = 413
+
+    def __init__(self, max_size: float, actual_size: float, **kwargs: Any) -> None:
+        kwargs.setdefault(
+            "text",
+            "Maximum request body size {} exceeded, "
+            "actual body size {}".format(max_size, actual_size),
+        )
+        super().__init__(**kwargs)
+
+
+class HTTPRequestURITooLong(HTTPClientError):
+    status_code = 414
+
+
+class HTTPUnsupportedMediaType(HTTPClientError):
+    status_code = 415
+
+
+class HTTPRequestRangeNotSatisfiable(HTTPClientError):
+    status_code = 416
+
+
+class HTTPExpectationFailed(HTTPClientError):
+    status_code = 417
+
+
+class HTTPMisdirectedRequest(HTTPClientError):
+    status_code = 421
+
+
+class HTTPUnprocessableEntity(HTTPClientError):
+    status_code = 422
+
+
+class HTTPFailedDependency(HTTPClientError):
+    status_code = 424
+
+
+class HTTPUpgradeRequired(HTTPClientError):
+    status_code = 426
+
+
+class HTTPPreconditionRequired(HTTPClientError):
+    status_code = 428
+
+
+class HTTPTooManyRequests(HTTPClientError):
+    status_code = 429
+
+
+class HTTPRequestHeaderFieldsTooLarge(HTTPClientError):
+    status_code = 431
+
+
+class HTTPUnavailableForLegalReasons(HTTPClientError):
+    status_code = 451
+
+    def __init__(
+        self,
+        link: Optional[StrOrURL],
+        *,
+        headers: Optional[LooseHeaders] = None,
+        reason: Optional[str] = None,
+        body: Any = None,
+        text: Optional[str] = None,
+        content_type: Optional[str] = None,
+    ) -> None:
+        super().__init__(
+            headers=headers,
+            reason=reason,
+            body=body,
+            text=text,
+            content_type=content_type,
+        )
+        self._link = None
+        if link:
+            self._link = URL(link)
+            self.headers["Link"] = f'<{str(self._link)}>; rel="blocked-by"'
+
+    @property
+    def link(self) -> Optional[URL]:
+        return self._link
+
+
+############################################################
+# 5xx Server Error
+############################################################
+#  Response status codes beginning with the digit "5" indicate cases in
+#  which the server is aware that it has erred or is incapable of
+#  performing the request. Except when responding to a HEAD request, the
+#  server SHOULD include an entity containing an explanation of the error
+#  situation, and whether it is a temporary or permanent condition. User
+#  agents SHOULD display any included entity to the user. These response
+#  codes are applicable to any request method.
+
+
+class HTTPServerError(HTTPError):
+    pass
+
+
+class HTTPInternalServerError(HTTPServerError):
+    status_code = 500
+
+
+class HTTPNotImplemented(HTTPServerError):
+    status_code = 501
+
+
+class HTTPBadGateway(HTTPServerError):
+    status_code = 502
+
+
+class HTTPServiceUnavailable(HTTPServerError):
+    status_code = 503
+
+
+class HTTPGatewayTimeout(HTTPServerError):
+    status_code = 504
+
+
+class HTTPVersionNotSupported(HTTPServerError):
+    status_code = 505
+
+
+class HTTPVariantAlsoNegotiates(HTTPServerError):
+    status_code = 506
+
+
+class HTTPInsufficientStorage(HTTPServerError):
+    status_code = 507
+
+
+class HTTPNotExtended(HTTPServerError):
+    status_code = 510
+
+
+class HTTPNetworkAuthenticationRequired(HTTPServerError):
+    status_code = 511
diff --git a/llm/Lib/site-packages/aiohttp/web_fileresponse.py b/llm/Lib/site-packages/aiohttp/web_fileresponse.py
new file mode 100644
index 0000000000000000000000000000000000000000..b167eedbc4966a7087b2e2e374ee72189e59abb5
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web_fileresponse.py
@@ -0,0 +1,305 @@
+import asyncio
+import mimetypes
+import os
+import pathlib
+from typing import (  # noqa
+    IO,
+    TYPE_CHECKING,
+    Any,
+    Awaitable,
+    Callable,
+    Final,
+    Iterator,
+    List,
+    Optional,
+    Tuple,
+    Union,
+    cast,
+)
+
+from . import hdrs
+from .abc import AbstractStreamWriter
+from .helpers import ETAG_ANY, ETag, must_be_empty_body
+from .typedefs import LooseHeaders, PathLike
+from .web_exceptions import (
+    HTTPNotModified,
+    HTTPPartialContent,
+    HTTPPreconditionFailed,
+    HTTPRequestRangeNotSatisfiable,
+)
+from .web_response import StreamResponse
+
+__all__ = ("FileResponse",)
+
+if TYPE_CHECKING:
+    from .web_request import BaseRequest
+
+
+_T_OnChunkSent = Optional[Callable[[bytes], Awaitable[None]]]
+
+
+NOSENDFILE: Final[bool] = bool(os.environ.get("AIOHTTP_NOSENDFILE"))
+
+
+class FileResponse(StreamResponse):
+    """A response object can be used to send files."""
+
+    def __init__(
+        self,
+        path: PathLike,
+        chunk_size: int = 256 * 1024,
+        status: int = 200,
+        reason: Optional[str] = None,
+        headers: Optional[LooseHeaders] = None,
+    ) -> None:
+        super().__init__(status=status, reason=reason, headers=headers)
+
+        self._path = pathlib.Path(path)
+        self._chunk_size = chunk_size
+
+    async def _sendfile_fallback(
+        self, writer: AbstractStreamWriter, fobj: IO[Any], offset: int, count: int
+    ) -> AbstractStreamWriter:
+        # To keep memory usage low,fobj is transferred in chunks
+        # controlled by the constructor's chunk_size argument.
+
+        chunk_size = self._chunk_size
+        loop = asyncio.get_event_loop()
+
+        await loop.run_in_executor(None, fobj.seek, offset)
+
+        chunk = await loop.run_in_executor(None, fobj.read, chunk_size)
+        while chunk:
+            await writer.write(chunk)
+            count = count - chunk_size
+            if count <= 0:
+                break
+            chunk = await loop.run_in_executor(None, fobj.read, min(chunk_size, count))
+
+        await writer.drain()
+        return writer
+
+    async def _sendfile(
+        self, request: "BaseRequest", fobj: IO[Any], offset: int, count: int
+    ) -> AbstractStreamWriter:
+        writer = await super().prepare(request)
+        assert writer is not None
+
+        if NOSENDFILE or self.compression:
+            return await self._sendfile_fallback(writer, fobj, offset, count)
+
+        loop = request._loop
+        transport = request.transport
+        assert transport is not None
+
+        try:
+            await loop.sendfile(transport, fobj, offset, count)
+        except NotImplementedError:
+            return await self._sendfile_fallback(writer, fobj, offset, count)
+
+        await super().write_eof()
+        return writer
+
+    @staticmethod
+    def _strong_etag_match(etag_value: str, etags: Tuple[ETag, ...]) -> bool:
+        if len(etags) == 1 and etags[0].value == ETAG_ANY:
+            return True
+        return any(etag.value == etag_value for etag in etags if not etag.is_weak)
+
+    async def _not_modified(
+        self, request: "BaseRequest", etag_value: str, last_modified: float
+    ) -> Optional[AbstractStreamWriter]:
+        self.set_status(HTTPNotModified.status_code)
+        self._length_check = False
+        self.etag = etag_value  # type: ignore[assignment]
+        self.last_modified = last_modified  # type: ignore[assignment]
+        # Delete any Content-Length headers provided by user. HTTP 304
+        # should always have empty response body
+        return await super().prepare(request)
+
+    async def _precondition_failed(
+        self, request: "BaseRequest"
+    ) -> Optional[AbstractStreamWriter]:
+        self.set_status(HTTPPreconditionFailed.status_code)
+        self.content_length = 0
+        return await super().prepare(request)
+
+    def _get_file_path_stat_and_gzip(
+        self, check_for_gzipped_file: bool
+    ) -> Tuple[pathlib.Path, os.stat_result, bool]:
+        """Return the file path, stat result, and gzip status.
+
+        This method should be called from a thread executor
+        since it calls os.stat which may block.
+        """
+        filepath = self._path
+        if check_for_gzipped_file:
+            gzip_path = filepath.with_name(filepath.name + ".gz")
+            try:
+                return gzip_path, gzip_path.stat(), True
+            except OSError:
+                # Fall through and try the non-gzipped file
+                pass
+
+        return filepath, filepath.stat(), False
+
+    async def prepare(self, request: "BaseRequest") -> Optional[AbstractStreamWriter]:
+        loop = asyncio.get_event_loop()
+        # Encoding comparisons should be case-insensitive
+        # https://www.rfc-editor.org/rfc/rfc9110#section-8.4.1
+        check_for_gzipped_file = (
+            "gzip" in request.headers.get(hdrs.ACCEPT_ENCODING, "").lower()
+        )
+        filepath, st, gzip = await loop.run_in_executor(
+            None, self._get_file_path_stat_and_gzip, check_for_gzipped_file
+        )
+
+        etag_value = f"{st.st_mtime_ns:x}-{st.st_size:x}"
+        last_modified = st.st_mtime
+
+        # https://tools.ietf.org/html/rfc7232#section-6
+        ifmatch = request.if_match
+        if ifmatch is not None and not self._strong_etag_match(etag_value, ifmatch):
+            return await self._precondition_failed(request)
+
+        unmodsince = request.if_unmodified_since
+        if (
+            unmodsince is not None
+            and ifmatch is None
+            and st.st_mtime > unmodsince.timestamp()
+        ):
+            return await self._precondition_failed(request)
+
+        ifnonematch = request.if_none_match
+        if ifnonematch is not None and self._strong_etag_match(etag_value, ifnonematch):
+            return await self._not_modified(request, etag_value, last_modified)
+
+        modsince = request.if_modified_since
+        if (
+            modsince is not None
+            and ifnonematch is None
+            and st.st_mtime <= modsince.timestamp()
+        ):
+            return await self._not_modified(request, etag_value, last_modified)
+
+        if hdrs.CONTENT_TYPE not in self.headers:
+            ct, encoding = mimetypes.guess_type(str(filepath))
+            if not ct:
+                ct = "application/octet-stream"
+            should_set_ct = True
+        else:
+            encoding = "gzip" if gzip else None
+            should_set_ct = False
+
+        status = self._status
+        file_size = st.st_size
+        count = file_size
+
+        start = None
+
+        ifrange = request.if_range
+        if ifrange is None or st.st_mtime <= ifrange.timestamp():
+            # If-Range header check:
+            # condition = cached date >= last modification date
+            # return 206 if True else 200.
+            # if False:
+            #   Range header would not be processed, return 200
+            # if True but Range header missing
+            #   return 200
+            try:
+                rng = request.http_range
+                start = rng.start
+                end = rng.stop
+            except ValueError:
+                # https://tools.ietf.org/html/rfc7233:
+                # A server generating a 416 (Range Not Satisfiable) response to
+                # a byte-range request SHOULD send a Content-Range header field
+                # with an unsatisfied-range value.
+                # The complete-length in a 416 response indicates the current
+                # length of the selected representation.
+                #
+                # Will do the same below. Many servers ignore this and do not
+                # send a Content-Range header with HTTP 416
+                self.headers[hdrs.CONTENT_RANGE] = f"bytes */{file_size}"
+                self.set_status(HTTPRequestRangeNotSatisfiable.status_code)
+                return await super().prepare(request)
+
+            # If a range request has been made, convert start, end slice
+            # notation into file pointer offset and count
+            if start is not None or end is not None:
+                if start < 0 and end is None:  # return tail of file
+                    start += file_size
+                    if start < 0:
+                        # if Range:bytes=-1000 in request header but file size
+                        # is only 200, there would be trouble without this
+                        start = 0
+                    count = file_size - start
+                else:
+                    # rfc7233:If the last-byte-pos value is
+                    # absent, or if the value is greater than or equal to
+                    # the current length of the representation data,
+                    # the byte range is interpreted as the remainder
+                    # of the representation (i.e., the server replaces the
+                    # value of last-byte-pos with a value that is one less than
+                    # the current length of the selected representation).
+                    count = (
+                        min(end if end is not None else file_size, file_size) - start
+                    )
+
+                if start >= file_size:
+                    # HTTP 416 should be returned in this case.
+                    #
+                    # According to https://tools.ietf.org/html/rfc7233:
+                    # If a valid byte-range-set includes at least one
+                    # byte-range-spec with a first-byte-pos that is less than
+                    # the current length of the representation, or at least one
+                    # suffix-byte-range-spec with a non-zero suffix-length,
+                    # then the byte-range-set is satisfiable. Otherwise, the
+                    # byte-range-set is unsatisfiable.
+                    self.headers[hdrs.CONTENT_RANGE] = f"bytes */{file_size}"
+                    self.set_status(HTTPRequestRangeNotSatisfiable.status_code)
+                    return await super().prepare(request)
+
+                status = HTTPPartialContent.status_code
+                # Even though you are sending the whole file, you should still
+                # return a HTTP 206 for a Range request.
+                self.set_status(status)
+
+        if should_set_ct:
+            self.content_type = ct  # type: ignore[assignment]
+        if encoding:
+            self.headers[hdrs.CONTENT_ENCODING] = encoding
+        if gzip:
+            self.headers[hdrs.VARY] = hdrs.ACCEPT_ENCODING
+            # Disable compression if we are already sending
+            # a compressed file since we don't want to double
+            # compress.
+            self._compression = False
+
+        self.etag = etag_value  # type: ignore[assignment]
+        self.last_modified = st.st_mtime  # type: ignore[assignment]
+        self.content_length = count
+
+        self.headers[hdrs.ACCEPT_RANGES] = "bytes"
+
+        real_start = cast(int, start)
+
+        if status == HTTPPartialContent.status_code:
+            self.headers[hdrs.CONTENT_RANGE] = "bytes {}-{}/{}".format(
+                real_start, real_start + count - 1, file_size
+            )
+
+        # If we are sending 0 bytes calling sendfile() will throw a ValueError
+        if count == 0 or must_be_empty_body(request.method, self.status):
+            return await super().prepare(request)
+
+        fobj = await loop.run_in_executor(None, filepath.open, "rb")
+        if start:  # be aware that start could be None or int=0 here.
+            offset = start
+        else:
+            offset = 0
+
+        try:
+            return await self._sendfile(request, fobj, offset, count)
+        finally:
+            await asyncio.shield(loop.run_in_executor(None, fobj.close))
diff --git a/llm/Lib/site-packages/aiohttp/web_log.py b/llm/Lib/site-packages/aiohttp/web_log.py
new file mode 100644
index 0000000000000000000000000000000000000000..ced0276955e511d69b26814a98f53ca2612f6795
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web_log.py
@@ -0,0 +1,213 @@
+import datetime
+import functools
+import logging
+import os
+import re
+import time as time_mod
+from collections import namedtuple
+from typing import Any, Callable, Dict, Iterable, List, Tuple  # noqa
+
+from .abc import AbstractAccessLogger
+from .web_request import BaseRequest
+from .web_response import StreamResponse
+
+KeyMethod = namedtuple("KeyMethod", "key method")
+
+
+class AccessLogger(AbstractAccessLogger):
+    """Helper object to log access.
+
+    Usage:
+        log = logging.getLogger("spam")
+        log_format = "%a %{User-Agent}i"
+        access_logger = AccessLogger(log, log_format)
+        access_logger.log(request, response, time)
+
+    Format:
+        %%  The percent sign
+        %a  Remote IP-address (IP-address of proxy if using reverse proxy)
+        %t  Time when the request was started to process
+        %P  The process ID of the child that serviced the request
+        %r  First line of request
+        %s  Response status code
+        %b  Size of response in bytes, including HTTP headers
+        %T  Time taken to serve the request, in seconds
+        %Tf Time taken to serve the request, in seconds with floating fraction
+            in .06f format
+        %D  Time taken to serve the request, in microseconds
+        %{FOO}i  request.headers['FOO']
+        %{FOO}o  response.headers['FOO']
+        %{FOO}e  os.environ['FOO']
+
+    """
+
+    LOG_FORMAT_MAP = {
+        "a": "remote_address",
+        "t": "request_start_time",
+        "P": "process_id",
+        "r": "first_request_line",
+        "s": "response_status",
+        "b": "response_size",
+        "T": "request_time",
+        "Tf": "request_time_frac",
+        "D": "request_time_micro",
+        "i": "request_header",
+        "o": "response_header",
+    }
+
+    LOG_FORMAT = '%a %t "%r" %s %b "%{Referer}i" "%{User-Agent}i"'
+    FORMAT_RE = re.compile(r"%(\{([A-Za-z0-9\-_]+)\}([ioe])|[atPrsbOD]|Tf?)")
+    CLEANUP_RE = re.compile(r"(%[^s])")
+    _FORMAT_CACHE: Dict[str, Tuple[str, List[KeyMethod]]] = {}
+
+    def __init__(self, logger: logging.Logger, log_format: str = LOG_FORMAT) -> None:
+        """Initialise the logger.
+
+        logger is a logger object to be used for logging.
+        log_format is a string with apache compatible log format description.
+
+        """
+        super().__init__(logger, log_format=log_format)
+
+        _compiled_format = AccessLogger._FORMAT_CACHE.get(log_format)
+        if not _compiled_format:
+            _compiled_format = self.compile_format(log_format)
+            AccessLogger._FORMAT_CACHE[log_format] = _compiled_format
+
+        self._log_format, self._methods = _compiled_format
+
+    def compile_format(self, log_format: str) -> Tuple[str, List[KeyMethod]]:
+        """Translate log_format into form usable by modulo formatting
+
+        All known atoms will be replaced with %s
+        Also methods for formatting of those atoms will be added to
+        _methods in appropriate order
+
+        For example we have log_format = "%a %t"
+        This format will be translated to "%s %s"
+        Also contents of _methods will be
+        [self._format_a, self._format_t]
+        These method will be called and results will be passed
+        to translated string format.
+
+        Each _format_* method receive 'args' which is list of arguments
+        given to self.log
+
+        Exceptions are _format_e, _format_i and _format_o methods which
+        also receive key name (by functools.partial)
+
+        """
+        # list of (key, method) tuples, we don't use an OrderedDict as users
+        # can repeat the same key more than once
+        methods = list()
+
+        for atom in self.FORMAT_RE.findall(log_format):
+            if atom[1] == "":
+                format_key1 = self.LOG_FORMAT_MAP[atom[0]]
+                m = getattr(AccessLogger, "_format_%s" % atom[0])
+                key_method = KeyMethod(format_key1, m)
+            else:
+                format_key2 = (self.LOG_FORMAT_MAP[atom[2]], atom[1])
+                m = getattr(AccessLogger, "_format_%s" % atom[2])
+                key_method = KeyMethod(format_key2, functools.partial(m, atom[1]))
+
+            methods.append(key_method)
+
+        log_format = self.FORMAT_RE.sub(r"%s", log_format)
+        log_format = self.CLEANUP_RE.sub(r"%\1", log_format)
+        return log_format, methods
+
+    @staticmethod
+    def _format_i(
+        key: str, request: BaseRequest, response: StreamResponse, time: float
+    ) -> str:
+        if request is None:
+            return "(no headers)"
+
+        # suboptimal, make istr(key) once
+        return request.headers.get(key, "-")
+
+    @staticmethod
+    def _format_o(
+        key: str, request: BaseRequest, response: StreamResponse, time: float
+    ) -> str:
+        # suboptimal, make istr(key) once
+        return response.headers.get(key, "-")
+
+    @staticmethod
+    def _format_a(request: BaseRequest, response: StreamResponse, time: float) -> str:
+        if request is None:
+            return "-"
+        ip = request.remote
+        return ip if ip is not None else "-"
+
+    @staticmethod
+    def _format_t(request: BaseRequest, response: StreamResponse, time: float) -> str:
+        tz = datetime.timezone(datetime.timedelta(seconds=-time_mod.timezone))
+        now = datetime.datetime.now(tz)
+        start_time = now - datetime.timedelta(seconds=time)
+        return start_time.strftime("[%d/%b/%Y:%H:%M:%S %z]")
+
+    @staticmethod
+    def _format_P(request: BaseRequest, response: StreamResponse, time: float) -> str:
+        return "<%s>" % os.getpid()
+
+    @staticmethod
+    def _format_r(request: BaseRequest, response: StreamResponse, time: float) -> str:
+        if request is None:
+            return "-"
+        return "{} {} HTTP/{}.{}".format(
+            request.method,
+            request.path_qs,
+            request.version.major,
+            request.version.minor,
+        )
+
+    @staticmethod
+    def _format_s(request: BaseRequest, response: StreamResponse, time: float) -> int:
+        return response.status
+
+    @staticmethod
+    def _format_b(request: BaseRequest, response: StreamResponse, time: float) -> int:
+        return response.body_length
+
+    @staticmethod
+    def _format_T(request: BaseRequest, response: StreamResponse, time: float) -> str:
+        return str(round(time))
+
+    @staticmethod
+    def _format_Tf(request: BaseRequest, response: StreamResponse, time: float) -> str:
+        return "%06f" % time
+
+    @staticmethod
+    def _format_D(request: BaseRequest, response: StreamResponse, time: float) -> str:
+        return str(round(time * 1000000))
+
+    def _format_line(
+        self, request: BaseRequest, response: StreamResponse, time: float
+    ) -> Iterable[Tuple[str, Callable[[BaseRequest, StreamResponse, float], str]]]:
+        return [(key, method(request, response, time)) for key, method in self._methods]
+
+    def log(self, request: BaseRequest, response: StreamResponse, time: float) -> None:
+        if not self.logger.isEnabledFor(logging.INFO):
+            # Avoid formatting the log line if it will not be emitted.
+            return
+        try:
+            fmt_info = self._format_line(request, response, time)
+
+            values = list()
+            extra = dict()
+            for key, value in fmt_info:
+                values.append(value)
+
+                if key.__class__ is str:
+                    extra[key] = value
+                else:
+                    k1, k2 = key  # type: ignore[misc]
+                    dct = extra.get(k1, {})  # type: ignore[var-annotated,has-type]
+                    dct[k2] = value  # type: ignore[index,has-type]
+                    extra[k1] = dct  # type: ignore[has-type,assignment]
+
+            self.logger.info(self._log_format % tuple(values), extra=extra)
+        except Exception:
+            self.logger.exception("Error in logging")
diff --git a/llm/Lib/site-packages/aiohttp/web_middlewares.py b/llm/Lib/site-packages/aiohttp/web_middlewares.py
new file mode 100644
index 0000000000000000000000000000000000000000..b2ab1e3f309c6b2f5e6abafdbb8cc654422dad33
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web_middlewares.py
@@ -0,0 +1,116 @@
+import re
+from typing import TYPE_CHECKING, Tuple, Type, TypeVar
+
+from .typedefs import Handler, Middleware
+from .web_exceptions import HTTPMove, HTTPPermanentRedirect
+from .web_request import Request
+from .web_response import StreamResponse
+from .web_urldispatcher import SystemRoute
+
+__all__ = (
+    "middleware",
+    "normalize_path_middleware",
+)
+
+if TYPE_CHECKING:
+    from .web_app import Application
+
+_Func = TypeVar("_Func")
+
+
+async def _check_request_resolves(request: Request, path: str) -> Tuple[bool, Request]:
+    alt_request = request.clone(rel_url=path)
+
+    match_info = await request.app.router.resolve(alt_request)
+    alt_request._match_info = match_info
+
+    if match_info.http_exception is None:
+        return True, alt_request
+
+    return False, request
+
+
+def middleware(f: _Func) -> _Func:
+    f.__middleware_version__ = 1  # type: ignore[attr-defined]
+    return f
+
+
+def normalize_path_middleware(
+    *,
+    append_slash: bool = True,
+    remove_slash: bool = False,
+    merge_slashes: bool = True,
+    redirect_class: Type[HTTPMove] = HTTPPermanentRedirect,
+) -> Middleware:
+    """Factory for producing a middleware that normalizes the path of a request.
+
+    Normalizing means:
+        - Add or remove a trailing slash to the path.
+        - Double slashes are replaced by one.
+
+    The middleware returns as soon as it finds a path that resolves
+    correctly. The order if both merge and append/remove are enabled is
+        1) merge slashes
+        2) append/remove slash
+        3) both merge slashes and append/remove slash.
+    If the path resolves with at least one of those conditions, it will
+    redirect to the new path.
+
+    Only one of `append_slash` and `remove_slash` can be enabled. If both
+    are `True` the factory will raise an assertion error
+
+    If `append_slash` is `True` the middleware will append a slash when
+    needed. If a resource is defined with trailing slash and the request
+    comes without it, it will append it automatically.
+
+    If `remove_slash` is `True`, `append_slash` must be `False`. When enabled
+    the middleware will remove trailing slashes and redirect if the resource
+    is defined
+
+    If merge_slashes is True, merge multiple consecutive slashes in the
+    path into one.
+    """
+    correct_configuration = not (append_slash and remove_slash)
+    assert correct_configuration, "Cannot both remove and append slash"
+
+    @middleware
+    async def impl(request: Request, handler: Handler) -> StreamResponse:
+        if isinstance(request.match_info.route, SystemRoute):
+            paths_to_check = []
+            if "?" in request.raw_path:
+                path, query = request.raw_path.split("?", 1)
+                query = "?" + query
+            else:
+                query = ""
+                path = request.raw_path
+
+            if merge_slashes:
+                paths_to_check.append(re.sub("//+", "/", path))
+            if append_slash and not request.path.endswith("/"):
+                paths_to_check.append(path + "/")
+            if remove_slash and request.path.endswith("/"):
+                paths_to_check.append(path[:-1])
+            if merge_slashes and append_slash:
+                paths_to_check.append(re.sub("//+", "/", path + "/"))
+            if merge_slashes and remove_slash:
+                merged_slashes = re.sub("//+", "/", path)
+                paths_to_check.append(merged_slashes[:-1])
+
+            for path in paths_to_check:
+                path = re.sub("^//+", "/", path)  # SECURITY: GHSA-v6wp-4m6f-gcjg
+                resolves, request = await _check_request_resolves(request, path)
+                if resolves:
+                    raise redirect_class(request.raw_path + query)
+
+        return await handler(request)
+
+    return impl
+
+
+def _fix_request_current_app(app: "Application") -> Middleware:
+    @middleware
+    async def impl(request: Request, handler: Handler) -> StreamResponse:
+        with request.match_info.set_current_app(app):
+            return await handler(request)
+
+    return impl
diff --git a/llm/Lib/site-packages/aiohttp/web_protocol.py b/llm/Lib/site-packages/aiohttp/web_protocol.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b6213ce6c6cc7eb984eadd8791c42cb004cdf8d
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web_protocol.py
@@ -0,0 +1,698 @@
+import asyncio
+import asyncio.streams
+import traceback
+import warnings
+from collections import deque
+from contextlib import suppress
+from html import escape as html_escape
+from http import HTTPStatus
+from logging import Logger
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Awaitable,
+    Callable,
+    Deque,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+
+import attr
+import yarl
+
+from .abc import AbstractAccessLogger, AbstractStreamWriter
+from .base_protocol import BaseProtocol
+from .helpers import ceil_timeout, set_exception
+from .http import (
+    HttpProcessingError,
+    HttpRequestParser,
+    HttpVersion10,
+    RawRequestMessage,
+    StreamWriter,
+)
+from .log import access_logger, server_logger
+from .streams import EMPTY_PAYLOAD, StreamReader
+from .tcp_helpers import tcp_keepalive
+from .web_exceptions import HTTPException
+from .web_log import AccessLogger
+from .web_request import BaseRequest
+from .web_response import Response, StreamResponse
+
+__all__ = ("RequestHandler", "RequestPayloadError", "PayloadAccessError")
+
+if TYPE_CHECKING:
+    from .web_server import Server
+
+
+_RequestFactory = Callable[
+    [
+        RawRequestMessage,
+        StreamReader,
+        "RequestHandler",
+        AbstractStreamWriter,
+        "asyncio.Task[None]",
+    ],
+    BaseRequest,
+]
+
+_RequestHandler = Callable[[BaseRequest], Awaitable[StreamResponse]]
+
+ERROR = RawRequestMessage(
+    "UNKNOWN",
+    "/",
+    HttpVersion10,
+    {},  # type: ignore[arg-type]
+    {},  # type: ignore[arg-type]
+    True,
+    None,
+    False,
+    False,
+    yarl.URL("/"),
+)
+
+
+class RequestPayloadError(Exception):
+    """Payload parsing error."""
+
+
+class PayloadAccessError(Exception):
+    """Payload was accessed after response was sent."""
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class _ErrInfo:
+    status: int
+    exc: BaseException
+    message: str
+
+
+_MsgType = Tuple[Union[RawRequestMessage, _ErrInfo], StreamReader]
+
+
+class RequestHandler(BaseProtocol):
+    """HTTP protocol implementation.
+
+    RequestHandler handles incoming HTTP request. It reads request line,
+    request headers and request payload and calls handle_request() method.
+    By default it always returns with 404 response.
+
+    RequestHandler handles errors in incoming request, like bad
+    status line, bad headers or incomplete payload. If any error occurs,
+    connection gets closed.
+
+    keepalive_timeout -- number of seconds before closing
+                         keep-alive connection
+
+    tcp_keepalive -- TCP keep-alive is on, default is on
+
+    debug -- enable debug mode
+
+    logger -- custom logger object
+
+    access_log_class -- custom class for access_logger
+
+    access_log -- custom logging object
+
+    access_log_format -- access log format string
+
+    loop -- Optional event loop
+
+    max_line_size -- Optional maximum header line size
+
+    max_field_size -- Optional maximum header field size
+
+    max_headers -- Optional maximum header size
+
+    timeout_ceil_threshold -- Optional value to specify
+                              threshold to ceil() timeout
+                              values
+
+    """
+
+    KEEPALIVE_RESCHEDULE_DELAY = 1
+
+    __slots__ = (
+        "_request_count",
+        "_keepalive",
+        "_manager",
+        "_request_handler",
+        "_request_factory",
+        "_tcp_keepalive",
+        "_keepalive_time",
+        "_keepalive_handle",
+        "_keepalive_timeout",
+        "_lingering_time",
+        "_messages",
+        "_message_tail",
+        "_waiter",
+        "_task_handler",
+        "_upgrade",
+        "_payload_parser",
+        "_request_parser",
+        "_reading_paused",
+        "logger",
+        "debug",
+        "access_log",
+        "access_logger",
+        "_close",
+        "_force_close",
+        "_current_request",
+        "_timeout_ceil_threshold",
+    )
+
+    def __init__(
+        self,
+        manager: "Server",
+        *,
+        loop: asyncio.AbstractEventLoop,
+        keepalive_timeout: float = 75.0,  # NGINX default is 75 secs
+        tcp_keepalive: bool = True,
+        logger: Logger = server_logger,
+        access_log_class: Type[AbstractAccessLogger] = AccessLogger,
+        access_log: Logger = access_logger,
+        access_log_format: str = AccessLogger.LOG_FORMAT,
+        debug: bool = False,
+        max_line_size: int = 8190,
+        max_headers: int = 32768,
+        max_field_size: int = 8190,
+        lingering_time: float = 10.0,
+        read_bufsize: int = 2**16,
+        auto_decompress: bool = True,
+        timeout_ceil_threshold: float = 5,
+    ):
+        super().__init__(loop)
+
+        self._request_count = 0
+        self._keepalive = False
+        self._current_request: Optional[BaseRequest] = None
+        self._manager: Optional[Server] = manager
+        self._request_handler: Optional[_RequestHandler] = manager.request_handler
+        self._request_factory: Optional[_RequestFactory] = manager.request_factory
+
+        self._tcp_keepalive = tcp_keepalive
+        # placeholder to be replaced on keepalive timeout setup
+        self._keepalive_time = 0.0
+        self._keepalive_handle: Optional[asyncio.Handle] = None
+        self._keepalive_timeout = keepalive_timeout
+        self._lingering_time = float(lingering_time)
+
+        self._messages: Deque[_MsgType] = deque()
+        self._message_tail = b""
+
+        self._waiter: Optional[asyncio.Future[None]] = None
+        self._task_handler: Optional[asyncio.Task[None]] = None
+
+        self._upgrade = False
+        self._payload_parser: Any = None
+        self._request_parser: Optional[HttpRequestParser] = HttpRequestParser(
+            self,
+            loop,
+            read_bufsize,
+            max_line_size=max_line_size,
+            max_field_size=max_field_size,
+            max_headers=max_headers,
+            payload_exception=RequestPayloadError,
+            auto_decompress=auto_decompress,
+        )
+
+        self._timeout_ceil_threshold: float = 5
+        try:
+            self._timeout_ceil_threshold = float(timeout_ceil_threshold)
+        except (TypeError, ValueError):
+            pass
+
+        self.logger = logger
+        self.debug = debug
+        self.access_log = access_log
+        if access_log:
+            self.access_logger: Optional[AbstractAccessLogger] = access_log_class(
+                access_log, access_log_format
+            )
+        else:
+            self.access_logger = None
+
+        self._close = False
+        self._force_close = False
+
+    def __repr__(self) -> str:
+        return "<{} {}>".format(
+            self.__class__.__name__,
+            "connected" if self.transport is not None else "disconnected",
+        )
+
+    @property
+    def keepalive_timeout(self) -> float:
+        return self._keepalive_timeout
+
+    async def shutdown(self, timeout: Optional[float] = 15.0) -> None:
+        """Do worker process exit preparations.
+
+        We need to clean up everything and stop accepting requests.
+        It is especially important for keep-alive connections.
+        """
+        self._force_close = True
+
+        if self._keepalive_handle is not None:
+            self._keepalive_handle.cancel()
+
+        if self._waiter:
+            self._waiter.cancel()
+
+        # wait for handlers
+        with suppress(asyncio.CancelledError, asyncio.TimeoutError):
+            async with ceil_timeout(timeout):
+                if self._current_request is not None:
+                    self._current_request._cancel(asyncio.CancelledError())
+
+                if self._task_handler is not None and not self._task_handler.done():
+                    await self._task_handler
+
+        # force-close non-idle handler
+        if self._task_handler is not None:
+            self._task_handler.cancel()
+
+        if self.transport is not None:
+            self.transport.close()
+            self.transport = None
+
+    def connection_made(self, transport: asyncio.BaseTransport) -> None:
+        super().connection_made(transport)
+
+        real_transport = cast(asyncio.Transport, transport)
+        if self._tcp_keepalive:
+            tcp_keepalive(real_transport)
+
+        self._task_handler = self._loop.create_task(self.start())
+        assert self._manager is not None
+        self._manager.connection_made(self, real_transport)
+
+    def connection_lost(self, exc: Optional[BaseException]) -> None:
+        if self._manager is None:
+            return
+        self._manager.connection_lost(self, exc)
+
+        super().connection_lost(exc)
+
+        # Grab value before setting _manager to None.
+        handler_cancellation = self._manager.handler_cancellation
+
+        self._manager = None
+        self._force_close = True
+        self._request_factory = None
+        self._request_handler = None
+        self._request_parser = None
+
+        if self._keepalive_handle is not None:
+            self._keepalive_handle.cancel()
+
+        if self._current_request is not None:
+            if exc is None:
+                exc = ConnectionResetError("Connection lost")
+            self._current_request._cancel(exc)
+
+        if self._waiter is not None:
+            self._waiter.cancel()
+
+        if handler_cancellation and self._task_handler is not None:
+            self._task_handler.cancel()
+
+        self._task_handler = None
+
+        if self._payload_parser is not None:
+            self._payload_parser.feed_eof()
+            self._payload_parser = None
+
+    def set_parser(self, parser: Any) -> None:
+        # Actual type is WebReader
+        assert self._payload_parser is None
+
+        self._payload_parser = parser
+
+        if self._message_tail:
+            self._payload_parser.feed_data(self._message_tail)
+            self._message_tail = b""
+
+    def eof_received(self) -> None:
+        pass
+
+    def data_received(self, data: bytes) -> None:
+        if self._force_close or self._close:
+            return
+        # parse http messages
+        messages: Sequence[_MsgType]
+        if self._payload_parser is None and not self._upgrade:
+            assert self._request_parser is not None
+            try:
+                messages, upgraded, tail = self._request_parser.feed_data(data)
+            except HttpProcessingError as exc:
+                messages = [
+                    (_ErrInfo(status=400, exc=exc, message=exc.message), EMPTY_PAYLOAD)
+                ]
+                upgraded = False
+                tail = b""
+
+            for msg, payload in messages or ():
+                self._request_count += 1
+                self._messages.append((msg, payload))
+
+            waiter = self._waiter
+            if messages and waiter is not None and not waiter.done():
+                # don't set result twice
+                waiter.set_result(None)
+
+            self._upgrade = upgraded
+            if upgraded and tail:
+                self._message_tail = tail
+
+        # no parser, just store
+        elif self._payload_parser is None and self._upgrade and data:
+            self._message_tail += data
+
+        # feed payload
+        elif data:
+            eof, tail = self._payload_parser.feed_data(data)
+            if eof:
+                self.close()
+
+    def keep_alive(self, val: bool) -> None:
+        """Set keep-alive connection mode.
+
+        :param bool val: new state.
+        """
+        self._keepalive = val
+        if self._keepalive_handle:
+            self._keepalive_handle.cancel()
+            self._keepalive_handle = None
+
+    def close(self) -> None:
+        """Close connection.
+
+        Stop accepting new pipelining messages and close
+        connection when handlers done processing messages.
+        """
+        self._close = True
+        if self._waiter:
+            self._waiter.cancel()
+
+    def force_close(self) -> None:
+        """Forcefully close connection."""
+        self._force_close = True
+        if self._waiter:
+            self._waiter.cancel()
+        if self.transport is not None:
+            self.transport.close()
+            self.transport = None
+
+    def log_access(
+        self, request: BaseRequest, response: StreamResponse, time: float
+    ) -> None:
+        if self.access_logger is not None:
+            self.access_logger.log(request, response, self._loop.time() - time)
+
+    def log_debug(self, *args: Any, **kw: Any) -> None:
+        if self.debug:
+            self.logger.debug(*args, **kw)
+
+    def log_exception(self, *args: Any, **kw: Any) -> None:
+        self.logger.exception(*args, **kw)
+
+    def _process_keepalive(self) -> None:
+        if self._force_close or not self._keepalive:
+            return
+
+        next = self._keepalive_time + self._keepalive_timeout
+
+        # handler in idle state
+        if self._waiter:
+            if self._loop.time() > next:
+                self.force_close()
+                return
+
+        # not all request handlers are done,
+        # reschedule itself to next second
+        self._keepalive_handle = self._loop.call_later(
+            self.KEEPALIVE_RESCHEDULE_DELAY,
+            self._process_keepalive,
+        )
+
+    async def _handle_request(
+        self,
+        request: BaseRequest,
+        start_time: float,
+        request_handler: Callable[[BaseRequest], Awaitable[StreamResponse]],
+    ) -> Tuple[StreamResponse, bool]:
+        assert self._request_handler is not None
+        try:
+            try:
+                self._current_request = request
+                resp = await request_handler(request)
+            finally:
+                self._current_request = None
+        except HTTPException as exc:
+            resp = exc
+            reset = await self.finish_response(request, resp, start_time)
+        except asyncio.CancelledError:
+            raise
+        except asyncio.TimeoutError as exc:
+            self.log_debug("Request handler timed out.", exc_info=exc)
+            resp = self.handle_error(request, 504)
+            reset = await self.finish_response(request, resp, start_time)
+        except Exception as exc:
+            resp = self.handle_error(request, 500, exc)
+            reset = await self.finish_response(request, resp, start_time)
+        else:
+            # Deprecation warning (See #2415)
+            if getattr(resp, "__http_exception__", False):
+                warnings.warn(
+                    "returning HTTPException object is deprecated "
+                    "(#2415) and will be removed, "
+                    "please raise the exception instead",
+                    DeprecationWarning,
+                )
+
+            reset = await self.finish_response(request, resp, start_time)
+
+        return resp, reset
+
+    async def start(self) -> None:
+        """Process incoming request.
+
+        It reads request line, request headers and request payload, then
+        calls handle_request() method. Subclass has to override
+        handle_request(). start() handles various exceptions in request
+        or response handling. Connection is being closed always unless
+        keep_alive(True) specified.
+        """
+        loop = self._loop
+        handler = self._task_handler
+        assert handler is not None
+        manager = self._manager
+        assert manager is not None
+        keepalive_timeout = self._keepalive_timeout
+        resp = None
+        assert self._request_factory is not None
+        assert self._request_handler is not None
+
+        while not self._force_close:
+            if not self._messages:
+                try:
+                    # wait for next request
+                    self._waiter = loop.create_future()
+                    await self._waiter
+                except asyncio.CancelledError:
+                    break
+                finally:
+                    self._waiter = None
+
+            message, payload = self._messages.popleft()
+
+            start = loop.time()
+
+            manager.requests_count += 1
+            writer = StreamWriter(self, loop)
+            if isinstance(message, _ErrInfo):
+                # make request_factory work
+                request_handler = self._make_error_handler(message)
+                message = ERROR
+            else:
+                request_handler = self._request_handler
+
+            request = self._request_factory(message, payload, self, writer, handler)
+            try:
+                # a new task is used for copy context vars (#3406)
+                task = self._loop.create_task(
+                    self._handle_request(request, start, request_handler)
+                )
+                try:
+                    resp, reset = await task
+                except (asyncio.CancelledError, ConnectionError):
+                    self.log_debug("Ignored premature client disconnection")
+                    break
+
+                # Drop the processed task from asyncio.Task.all_tasks() early
+                del task
+                if reset:
+                    self.log_debug("Ignored premature client disconnection 2")
+                    break
+
+                # notify server about keep-alive
+                self._keepalive = bool(resp.keep_alive)
+
+                # check payload
+                if not payload.is_eof():
+                    lingering_time = self._lingering_time
+                    if not self._force_close and lingering_time:
+                        self.log_debug(
+                            "Start lingering close timer for %s sec.", lingering_time
+                        )
+
+                        now = loop.time()
+                        end_t = now + lingering_time
+
+                        with suppress(asyncio.TimeoutError, asyncio.CancelledError):
+                            while not payload.is_eof() and now < end_t:
+                                async with ceil_timeout(end_t - now):
+                                    # read and ignore
+                                    await payload.readany()
+                                now = loop.time()
+
+                    # if payload still uncompleted
+                    if not payload.is_eof() and not self._force_close:
+                        self.log_debug("Uncompleted request.")
+                        self.close()
+
+                set_exception(payload, PayloadAccessError())
+
+            except asyncio.CancelledError:
+                self.log_debug("Ignored premature client disconnection ")
+                break
+            except RuntimeError as exc:
+                if self.debug:
+                    self.log_exception("Unhandled runtime exception", exc_info=exc)
+                self.force_close()
+            except Exception as exc:
+                self.log_exception("Unhandled exception", exc_info=exc)
+                self.force_close()
+            finally:
+                if self.transport is None and resp is not None:
+                    self.log_debug("Ignored premature client disconnection.")
+                elif not self._force_close:
+                    if self._keepalive and not self._close:
+                        # start keep-alive timer
+                        if keepalive_timeout is not None:
+                            now = self._loop.time()
+                            self._keepalive_time = now
+                            if self._keepalive_handle is None:
+                                self._keepalive_handle = loop.call_at(
+                                    now + keepalive_timeout, self._process_keepalive
+                                )
+                    else:
+                        break
+
+        # remove handler, close transport if no handlers left
+        if not self._force_close:
+            self._task_handler = None
+            if self.transport is not None:
+                self.transport.close()
+
+    async def finish_response(
+        self, request: BaseRequest, resp: StreamResponse, start_time: float
+    ) -> bool:
+        """Prepare the response and write_eof, then log access.
+
+        This has to
+        be called within the context of any exception so the access logger
+        can get exception information. Returns True if the client disconnects
+        prematurely.
+        """
+        if self._request_parser is not None:
+            self._request_parser.set_upgraded(False)
+            self._upgrade = False
+            if self._message_tail:
+                self._request_parser.feed_data(self._message_tail)
+                self._message_tail = b""
+        try:
+            prepare_meth = resp.prepare
+        except AttributeError:
+            if resp is None:
+                raise RuntimeError("Missing return " "statement on request handler")
+            else:
+                raise RuntimeError(
+                    "Web-handler should return "
+                    "a response instance, "
+                    "got {!r}".format(resp)
+                )
+        try:
+            await prepare_meth(request)
+            await resp.write_eof()
+        except ConnectionError:
+            self.log_access(request, resp, start_time)
+            return True
+        else:
+            self.log_access(request, resp, start_time)
+            return False
+
+    def handle_error(
+        self,
+        request: BaseRequest,
+        status: int = 500,
+        exc: Optional[BaseException] = None,
+        message: Optional[str] = None,
+    ) -> StreamResponse:
+        """Handle errors.
+
+        Returns HTTP response with specific status code. Logs additional
+        information. It always closes current connection.
+        """
+        self.log_exception("Error handling request", exc_info=exc)
+
+        # some data already got sent, connection is broken
+        if request.writer.output_size > 0:
+            raise ConnectionError(
+                "Response is sent already, cannot send another response "
+                "with the error message"
+            )
+
+        ct = "text/plain"
+        if status == HTTPStatus.INTERNAL_SERVER_ERROR:
+            title = "{0.value} {0.phrase}".format(HTTPStatus.INTERNAL_SERVER_ERROR)
+            msg = HTTPStatus.INTERNAL_SERVER_ERROR.description
+            tb = None
+            if self.debug:
+                with suppress(Exception):
+                    tb = traceback.format_exc()
+
+            if "text/html" in request.headers.get("Accept", ""):
+                if tb:
+                    tb = html_escape(tb)
+                    msg = f"<h2>Traceback:</h2>\n<pre>{tb}</pre>"
+                message = (
+                    "<html><head>"
+                    "<title>{title}</title>"
+                    "</head><body>\n<h1>{title}</h1>"
+                    "\n{msg}\n</body></html>\n"
+                ).format(title=title, msg=msg)
+                ct = "text/html"
+            else:
+                if tb:
+                    msg = tb
+                message = title + "\n\n" + msg
+
+        resp = Response(status=status, text=message, content_type=ct)
+        resp.force_close()
+
+        return resp
+
+    def _make_error_handler(
+        self, err_info: _ErrInfo
+    ) -> Callable[[BaseRequest], Awaitable[StreamResponse]]:
+        async def handler(request: BaseRequest) -> StreamResponse:
+            return self.handle_error(
+                request, err_info.status, err_info.exc, err_info.message
+            )
+
+        return handler
diff --git a/llm/Lib/site-packages/aiohttp/web_request.py b/llm/Lib/site-packages/aiohttp/web_request.py
new file mode 100644
index 0000000000000000000000000000000000000000..68c46b03d27c838bc8ca7596e0088d7b2238ea47
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web_request.py
@@ -0,0 +1,901 @@
+import asyncio
+import datetime
+import io
+import re
+import socket
+import string
+import tempfile
+import types
+import warnings
+from http.cookies import SimpleCookie
+from types import MappingProxyType
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    Final,
+    Iterator,
+    Mapping,
+    MutableMapping,
+    Optional,
+    Pattern,
+    Tuple,
+    Union,
+    cast,
+)
+from urllib.parse import parse_qsl
+
+import attr
+from multidict import (
+    CIMultiDict,
+    CIMultiDictProxy,
+    MultiDict,
+    MultiDictProxy,
+    MultiMapping,
+)
+from yarl import URL
+
+from . import hdrs
+from .abc import AbstractStreamWriter
+from .helpers import (
+    _SENTINEL,
+    DEBUG,
+    ETAG_ANY,
+    LIST_QUOTED_ETAG_RE,
+    ChainMapProxy,
+    ETag,
+    HeadersMixin,
+    parse_http_date,
+    reify,
+    sentinel,
+    set_exception,
+)
+from .http_parser import RawRequestMessage
+from .http_writer import HttpVersion
+from .multipart import BodyPartReader, MultipartReader
+from .streams import EmptyStreamReader, StreamReader
+from .typedefs import (
+    DEFAULT_JSON_DECODER,
+    JSONDecoder,
+    LooseHeaders,
+    RawHeaders,
+    StrOrURL,
+)
+from .web_exceptions import HTTPRequestEntityTooLarge
+from .web_response import StreamResponse
+
+__all__ = ("BaseRequest", "FileField", "Request")
+
+
+if TYPE_CHECKING:
+    from .web_app import Application
+    from .web_protocol import RequestHandler
+    from .web_urldispatcher import UrlMappingMatchInfo
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class FileField:
+    name: str
+    filename: str
+    file: io.BufferedReader
+    content_type: str
+    headers: "CIMultiDictProxy[str]"
+
+
+_TCHAR: Final[str] = string.digits + string.ascii_letters + r"!#$%&'*+.^_`|~-"
+# '-' at the end to prevent interpretation as range in a char class
+
+_TOKEN: Final[str] = rf"[{_TCHAR}]+"
+
+_QDTEXT: Final[str] = r"[{}]".format(
+    r"".join(chr(c) for c in (0x09, 0x20, 0x21) + tuple(range(0x23, 0x7F)))
+)
+# qdtext includes 0x5C to escape 0x5D ('\]')
+# qdtext excludes obs-text (because obsoleted, and encoding not specified)
+
+_QUOTED_PAIR: Final[str] = r"\\[\t !-~]"
+
+_QUOTED_STRING: Final[str] = r'"(?:{quoted_pair}|{qdtext})*"'.format(
+    qdtext=_QDTEXT, quoted_pair=_QUOTED_PAIR
+)
+
+_FORWARDED_PAIR: Final[
+    str
+] = r"({token})=({token}|{quoted_string})(:\d{{1,4}})?".format(
+    token=_TOKEN, quoted_string=_QUOTED_STRING
+)
+
+_QUOTED_PAIR_REPLACE_RE: Final[Pattern[str]] = re.compile(r"\\([\t !-~])")
+# same pattern as _QUOTED_PAIR but contains a capture group
+
+_FORWARDED_PAIR_RE: Final[Pattern[str]] = re.compile(_FORWARDED_PAIR)
+
+############################################################
+# HTTP Request
+############################################################
+
+
+class BaseRequest(MutableMapping[str, Any], HeadersMixin):
+
+    POST_METHODS = {
+        hdrs.METH_PATCH,
+        hdrs.METH_POST,
+        hdrs.METH_PUT,
+        hdrs.METH_TRACE,
+        hdrs.METH_DELETE,
+    }
+
+    ATTRS = HeadersMixin.ATTRS | frozenset(
+        [
+            "_message",
+            "_protocol",
+            "_payload_writer",
+            "_payload",
+            "_headers",
+            "_method",
+            "_version",
+            "_rel_url",
+            "_post",
+            "_read_bytes",
+            "_state",
+            "_cache",
+            "_task",
+            "_client_max_size",
+            "_loop",
+            "_transport_sslcontext",
+            "_transport_peername",
+        ]
+    )
+
+    def __init__(
+        self,
+        message: RawRequestMessage,
+        payload: StreamReader,
+        protocol: "RequestHandler",
+        payload_writer: AbstractStreamWriter,
+        task: "asyncio.Task[None]",
+        loop: asyncio.AbstractEventLoop,
+        *,
+        client_max_size: int = 1024**2,
+        state: Optional[Dict[str, Any]] = None,
+        scheme: Optional[str] = None,
+        host: Optional[str] = None,
+        remote: Optional[str] = None,
+    ) -> None:
+        if state is None:
+            state = {}
+        self._message = message
+        self._protocol = protocol
+        self._payload_writer = payload_writer
+
+        self._payload = payload
+        self._headers = message.headers
+        self._method = message.method
+        self._version = message.version
+        self._cache: Dict[str, Any] = {}
+        url = message.url
+        if url.is_absolute():
+            # absolute URL is given,
+            # override auto-calculating url, host, and scheme
+            # all other properties should be good
+            self._cache["url"] = url
+            self._cache["host"] = url.host
+            self._cache["scheme"] = url.scheme
+            self._rel_url = url.relative()
+        else:
+            self._rel_url = message.url
+        self._post: Optional[MultiDictProxy[Union[str, bytes, FileField]]] = None
+        self._read_bytes: Optional[bytes] = None
+
+        self._state = state
+        self._task = task
+        self._client_max_size = client_max_size
+        self._loop = loop
+
+        transport = self._protocol.transport
+        assert transport is not None
+        self._transport_sslcontext = transport.get_extra_info("sslcontext")
+        self._transport_peername = transport.get_extra_info("peername")
+
+        if scheme is not None:
+            self._cache["scheme"] = scheme
+        if host is not None:
+            self._cache["host"] = host
+        if remote is not None:
+            self._cache["remote"] = remote
+
+    def clone(
+        self,
+        *,
+        method: Union[str, _SENTINEL] = sentinel,
+        rel_url: Union[StrOrURL, _SENTINEL] = sentinel,
+        headers: Union[LooseHeaders, _SENTINEL] = sentinel,
+        scheme: Union[str, _SENTINEL] = sentinel,
+        host: Union[str, _SENTINEL] = sentinel,
+        remote: Union[str, _SENTINEL] = sentinel,
+        client_max_size: Union[int, _SENTINEL] = sentinel,
+    ) -> "BaseRequest":
+        """Clone itself with replacement some attributes.
+
+        Creates and returns a new instance of Request object. If no parameters
+        are given, an exact copy is returned. If a parameter is not passed, it
+        will reuse the one from the current request object.
+        """
+        if self._read_bytes:
+            raise RuntimeError("Cannot clone request " "after reading its content")
+
+        dct: Dict[str, Any] = {}
+        if method is not sentinel:
+            dct["method"] = method
+        if rel_url is not sentinel:
+            new_url: URL = URL(rel_url)
+            dct["url"] = new_url
+            dct["path"] = str(new_url)
+        if headers is not sentinel:
+            # a copy semantic
+            dct["headers"] = CIMultiDictProxy(CIMultiDict(headers))
+            dct["raw_headers"] = tuple(
+                (k.encode("utf-8"), v.encode("utf-8")) for k, v in headers.items()
+            )
+
+        message = self._message._replace(**dct)
+
+        kwargs = {}
+        if scheme is not sentinel:
+            kwargs["scheme"] = scheme
+        if host is not sentinel:
+            kwargs["host"] = host
+        if remote is not sentinel:
+            kwargs["remote"] = remote
+        if client_max_size is sentinel:
+            client_max_size = self._client_max_size
+
+        return self.__class__(
+            message,
+            self._payload,
+            self._protocol,
+            self._payload_writer,
+            self._task,
+            self._loop,
+            client_max_size=client_max_size,
+            state=self._state.copy(),
+            **kwargs,
+        )
+
+    @property
+    def task(self) -> "asyncio.Task[None]":
+        return self._task
+
+    @property
+    def protocol(self) -> "RequestHandler":
+        return self._protocol
+
+    @property
+    def transport(self) -> Optional[asyncio.Transport]:
+        if self._protocol is None:
+            return None
+        return self._protocol.transport
+
+    @property
+    def writer(self) -> AbstractStreamWriter:
+        return self._payload_writer
+
+    @property
+    def client_max_size(self) -> int:
+        return self._client_max_size
+
+    @reify
+    def message(self) -> RawRequestMessage:
+        warnings.warn("Request.message is deprecated", DeprecationWarning, stacklevel=3)
+        return self._message
+
+    @reify
+    def rel_url(self) -> URL:
+        return self._rel_url
+
+    @reify
+    def loop(self) -> asyncio.AbstractEventLoop:
+        warnings.warn(
+            "request.loop property is deprecated", DeprecationWarning, stacklevel=2
+        )
+        return self._loop
+
+    # MutableMapping API
+
+    def __getitem__(self, key: str) -> Any:
+        return self._state[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self._state[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self._state[key]
+
+    def __len__(self) -> int:
+        return len(self._state)
+
+    def __iter__(self) -> Iterator[str]:
+        return iter(self._state)
+
+    ########
+
+    @reify
+    def secure(self) -> bool:
+        """A bool indicating if the request is handled with SSL."""
+        return self.scheme == "https"
+
+    @reify
+    def forwarded(self) -> Tuple[Mapping[str, str], ...]:
+        """A tuple containing all parsed Forwarded header(s).
+
+        Makes an effort to parse Forwarded headers as specified by RFC 7239:
+
+        - It adds one (immutable) dictionary per Forwarded 'field-value', ie
+          per proxy. The element corresponds to the data in the Forwarded
+          field-value added by the first proxy encountered by the client. Each
+          subsequent item corresponds to those added by later proxies.
+        - It checks that every value has valid syntax in general as specified
+          in section 4: either a 'token' or a 'quoted-string'.
+        - It un-escapes found escape sequences.
+        - It does NOT validate 'by' and 'for' contents as specified in section
+          6.
+        - It does NOT validate 'host' contents (Host ABNF).
+        - It does NOT validate 'proto' contents for valid URI scheme names.
+
+        Returns a tuple containing one or more immutable dicts
+        """
+        elems = []
+        for field_value in self._message.headers.getall(hdrs.FORWARDED, ()):
+            length = len(field_value)
+            pos = 0
+            need_separator = False
+            elem: Dict[str, str] = {}
+            elems.append(types.MappingProxyType(elem))
+            while 0 <= pos < length:
+                match = _FORWARDED_PAIR_RE.match(field_value, pos)
+                if match is not None:  # got a valid forwarded-pair
+                    if need_separator:
+                        # bad syntax here, skip to next comma
+                        pos = field_value.find(",", pos)
+                    else:
+                        name, value, port = match.groups()
+                        if value[0] == '"':
+                            # quoted string: remove quotes and unescape
+                            value = _QUOTED_PAIR_REPLACE_RE.sub(r"\1", value[1:-1])
+                        if port:
+                            value += port
+                        elem[name.lower()] = value
+                        pos += len(match.group(0))
+                        need_separator = True
+                elif field_value[pos] == ",":  # next forwarded-element
+                    need_separator = False
+                    elem = {}
+                    elems.append(types.MappingProxyType(elem))
+                    pos += 1
+                elif field_value[pos] == ";":  # next forwarded-pair
+                    need_separator = False
+                    pos += 1
+                elif field_value[pos] in " \t":
+                    # Allow whitespace even between forwarded-pairs, though
+                    # RFC 7239 doesn't. This simplifies code and is in line
+                    # with Postel's law.
+                    pos += 1
+                else:
+                    # bad syntax here, skip to next comma
+                    pos = field_value.find(",", pos)
+        return tuple(elems)
+
+    @reify
+    def scheme(self) -> str:
+        """A string representing the scheme of the request.
+
+        Hostname is resolved in this order:
+
+        - overridden value by .clone(scheme=new_scheme) call.
+        - type of connection to peer: HTTPS if socket is SSL, HTTP otherwise.
+
+        'http' or 'https'.
+        """
+        if self._transport_sslcontext:
+            return "https"
+        else:
+            return "http"
+
+    @reify
+    def method(self) -> str:
+        """Read only property for getting HTTP method.
+
+        The value is upper-cased str like 'GET', 'POST', 'PUT' etc.
+        """
+        return self._method
+
+    @reify
+    def version(self) -> HttpVersion:
+        """Read only property for getting HTTP version of request.
+
+        Returns aiohttp.protocol.HttpVersion instance.
+        """
+        return self._version
+
+    @reify
+    def host(self) -> str:
+        """Hostname of the request.
+
+        Hostname is resolved in this order:
+
+        - overridden value by .clone(host=new_host) call.
+        - HOST HTTP header
+        - socket.getfqdn() value
+        """
+        host = self._message.headers.get(hdrs.HOST)
+        if host is not None:
+            return host
+        return socket.getfqdn()
+
+    @reify
+    def remote(self) -> Optional[str]:
+        """Remote IP of client initiated HTTP request.
+
+        The IP is resolved in this order:
+
+        - overridden value by .clone(remote=new_remote) call.
+        - peername of opened socket
+        """
+        if self._transport_peername is None:
+            return None
+        if isinstance(self._transport_peername, (list, tuple)):
+            return str(self._transport_peername[0])
+        return str(self._transport_peername)
+
+    @reify
+    def url(self) -> URL:
+        url = URL.build(scheme=self.scheme, host=self.host)
+        return url.join(self._rel_url)
+
+    @reify
+    def path(self) -> str:
+        """The URL including *PATH INFO* without the host or scheme.
+
+        E.g., ``/app/blog``
+        """
+        return self._rel_url.path
+
+    @reify
+    def path_qs(self) -> str:
+        """The URL including PATH_INFO and the query string.
+
+        E.g, /app/blog?id=10
+        """
+        return str(self._rel_url)
+
+    @reify
+    def raw_path(self) -> str:
+        """The URL including raw *PATH INFO* without the host or scheme.
+
+        Warning, the path is unquoted and may contains non valid URL characters
+
+        E.g., ``/my%2Fpath%7Cwith%21some%25strange%24characters``
+        """
+        return self._message.path
+
+    @reify
+    def query(self) -> "MultiMapping[str]":
+        """A multidict with all the variables in the query string."""
+        return MultiDictProxy(self._rel_url.query)
+
+    @reify
+    def query_string(self) -> str:
+        """The query string in the URL.
+
+        E.g., id=10
+        """
+        return self._rel_url.query_string
+
+    @reify
+    def headers(self) -> "MultiMapping[str]":
+        """A case-insensitive multidict proxy with all headers."""
+        return self._headers
+
+    @reify
+    def raw_headers(self) -> RawHeaders:
+        """A sequence of pairs for all headers."""
+        return self._message.raw_headers
+
+    @reify
+    def if_modified_since(self) -> Optional[datetime.datetime]:
+        """The value of If-Modified-Since HTTP header, or None.
+
+        This header is represented as a `datetime` object.
+        """
+        return parse_http_date(self.headers.get(hdrs.IF_MODIFIED_SINCE))
+
+    @reify
+    def if_unmodified_since(self) -> Optional[datetime.datetime]:
+        """The value of If-Unmodified-Since HTTP header, or None.
+
+        This header is represented as a `datetime` object.
+        """
+        return parse_http_date(self.headers.get(hdrs.IF_UNMODIFIED_SINCE))
+
+    @staticmethod
+    def _etag_values(etag_header: str) -> Iterator[ETag]:
+        """Extract `ETag` objects from raw header."""
+        if etag_header == ETAG_ANY:
+            yield ETag(
+                is_weak=False,
+                value=ETAG_ANY,
+            )
+        else:
+            for match in LIST_QUOTED_ETAG_RE.finditer(etag_header):
+                is_weak, value, garbage = match.group(2, 3, 4)
+                # Any symbol captured by 4th group means
+                # that the following sequence is invalid.
+                if garbage:
+                    break
+
+                yield ETag(
+                    is_weak=bool(is_weak),
+                    value=value,
+                )
+
+    @classmethod
+    def _if_match_or_none_impl(
+        cls, header_value: Optional[str]
+    ) -> Optional[Tuple[ETag, ...]]:
+        if not header_value:
+            return None
+
+        return tuple(cls._etag_values(header_value))
+
+    @reify
+    def if_match(self) -> Optional[Tuple[ETag, ...]]:
+        """The value of If-Match HTTP header, or None.
+
+        This header is represented as a `tuple` of `ETag` objects.
+        """
+        return self._if_match_or_none_impl(self.headers.get(hdrs.IF_MATCH))
+
+    @reify
+    def if_none_match(self) -> Optional[Tuple[ETag, ...]]:
+        """The value of If-None-Match HTTP header, or None.
+
+        This header is represented as a `tuple` of `ETag` objects.
+        """
+        return self._if_match_or_none_impl(self.headers.get(hdrs.IF_NONE_MATCH))
+
+    @reify
+    def if_range(self) -> Optional[datetime.datetime]:
+        """The value of If-Range HTTP header, or None.
+
+        This header is represented as a `datetime` object.
+        """
+        return parse_http_date(self.headers.get(hdrs.IF_RANGE))
+
+    @reify
+    def keep_alive(self) -> bool:
+        """Is keepalive enabled by client?"""
+        return not self._message.should_close
+
+    @reify
+    def cookies(self) -> Mapping[str, str]:
+        """Return request cookies.
+
+        A read-only dictionary-like object.
+        """
+        raw = self.headers.get(hdrs.COOKIE, "")
+        parsed = SimpleCookie(raw)
+        return MappingProxyType({key: val.value for key, val in parsed.items()})
+
+    @reify
+    def http_range(self) -> slice:
+        """The content of Range HTTP header.
+
+        Return a slice instance.
+
+        """
+        rng = self._headers.get(hdrs.RANGE)
+        start, end = None, None
+        if rng is not None:
+            try:
+                pattern = r"^bytes=(\d*)-(\d*)$"
+                start, end = re.findall(pattern, rng)[0]
+            except IndexError:  # pattern was not found in header
+                raise ValueError("range not in acceptable format")
+
+            end = int(end) if end else None
+            start = int(start) if start else None
+
+            if start is None and end is not None:
+                # end with no start is to return tail of content
+                start = -end
+                end = None
+
+            if start is not None and end is not None:
+                # end is inclusive in range header, exclusive for slice
+                end += 1
+
+                if start >= end:
+                    raise ValueError("start cannot be after end")
+
+            if start is end is None:  # No valid range supplied
+                raise ValueError("No start or end of range specified")
+
+        return slice(start, end, 1)
+
+    @reify
+    def content(self) -> StreamReader:
+        """Return raw payload stream."""
+        return self._payload
+
+    @property
+    def has_body(self) -> bool:
+        """Return True if request's HTTP BODY can be read, False otherwise."""
+        warnings.warn(
+            "Deprecated, use .can_read_body #2005", DeprecationWarning, stacklevel=2
+        )
+        return not self._payload.at_eof()
+
+    @property
+    def can_read_body(self) -> bool:
+        """Return True if request's HTTP BODY can be read, False otherwise."""
+        return not self._payload.at_eof()
+
+    @reify
+    def body_exists(self) -> bool:
+        """Return True if request has HTTP BODY, False otherwise."""
+        return type(self._payload) is not EmptyStreamReader
+
+    async def release(self) -> None:
+        """Release request.
+
+        Eat unread part of HTTP BODY if present.
+        """
+        while not self._payload.at_eof():
+            await self._payload.readany()
+
+    async def read(self) -> bytes:
+        """Read request body if present.
+
+        Returns bytes object with full request content.
+        """
+        if self._read_bytes is None:
+            body = bytearray()
+            while True:
+                chunk = await self._payload.readany()
+                body.extend(chunk)
+                if self._client_max_size:
+                    body_size = len(body)
+                    if body_size >= self._client_max_size:
+                        raise HTTPRequestEntityTooLarge(
+                            max_size=self._client_max_size, actual_size=body_size
+                        )
+                if not chunk:
+                    break
+            self._read_bytes = bytes(body)
+        return self._read_bytes
+
+    async def text(self) -> str:
+        """Return BODY as text using encoding from .charset."""
+        bytes_body = await self.read()
+        encoding = self.charset or "utf-8"
+        return bytes_body.decode(encoding)
+
+    async def json(self, *, loads: JSONDecoder = DEFAULT_JSON_DECODER) -> Any:
+        """Return BODY as JSON."""
+        body = await self.text()
+        return loads(body)
+
+    async def multipart(self) -> MultipartReader:
+        """Return async iterator to process BODY as multipart."""
+        return MultipartReader(self._headers, self._payload)
+
+    async def post(self) -> "MultiDictProxy[Union[str, bytes, FileField]]":
+        """Return POST parameters."""
+        if self._post is not None:
+            return self._post
+        if self._method not in self.POST_METHODS:
+            self._post = MultiDictProxy(MultiDict())
+            return self._post
+
+        content_type = self.content_type
+        if content_type not in (
+            "",
+            "application/x-www-form-urlencoded",
+            "multipart/form-data",
+        ):
+            self._post = MultiDictProxy(MultiDict())
+            return self._post
+
+        out: MultiDict[Union[str, bytes, FileField]] = MultiDict()
+
+        if content_type == "multipart/form-data":
+            multipart = await self.multipart()
+            max_size = self._client_max_size
+
+            field = await multipart.next()
+            while field is not None:
+                size = 0
+                field_ct = field.headers.get(hdrs.CONTENT_TYPE)
+
+                if isinstance(field, BodyPartReader):
+                    assert field.name is not None
+
+                    # Note that according to RFC 7578, the Content-Type header
+                    # is optional, even for files, so we can't assume it's
+                    # present.
+                    # https://tools.ietf.org/html/rfc7578#section-4.4
+                    if field.filename:
+                        # store file in temp file
+                        tmp = await self._loop.run_in_executor(
+                            None, tempfile.TemporaryFile
+                        )
+                        chunk = await field.read_chunk(size=2**16)
+                        while chunk:
+                            chunk = field.decode(chunk)
+                            await self._loop.run_in_executor(None, tmp.write, chunk)
+                            size += len(chunk)
+                            if 0 < max_size < size:
+                                await self._loop.run_in_executor(None, tmp.close)
+                                raise HTTPRequestEntityTooLarge(
+                                    max_size=max_size, actual_size=size
+                                )
+                            chunk = await field.read_chunk(size=2**16)
+                        await self._loop.run_in_executor(None, tmp.seek, 0)
+
+                        if field_ct is None:
+                            field_ct = "application/octet-stream"
+
+                        ff = FileField(
+                            field.name,
+                            field.filename,
+                            cast(io.BufferedReader, tmp),
+                            field_ct,
+                            field.headers,
+                        )
+                        out.add(field.name, ff)
+                    else:
+                        # deal with ordinary data
+                        value = await field.read(decode=True)
+                        if field_ct is None or field_ct.startswith("text/"):
+                            charset = field.get_charset(default="utf-8")
+                            out.add(field.name, value.decode(charset))
+                        else:
+                            out.add(field.name, value)
+                        size += len(value)
+                        if 0 < max_size < size:
+                            raise HTTPRequestEntityTooLarge(
+                                max_size=max_size, actual_size=size
+                            )
+                else:
+                    raise ValueError(
+                        "To decode nested multipart you need " "to use custom reader",
+                    )
+
+                field = await multipart.next()
+        else:
+            data = await self.read()
+            if data:
+                charset = self.charset or "utf-8"
+                out.extend(
+                    parse_qsl(
+                        data.rstrip().decode(charset),
+                        keep_blank_values=True,
+                        encoding=charset,
+                    )
+                )
+
+        self._post = MultiDictProxy(out)
+        return self._post
+
+    def get_extra_info(self, name: str, default: Any = None) -> Any:
+        """Extra info from protocol transport"""
+        protocol = self._protocol
+        if protocol is None:
+            return default
+
+        transport = protocol.transport
+        if transport is None:
+            return default
+
+        return transport.get_extra_info(name, default)
+
+    def __repr__(self) -> str:
+        ascii_encodable_path = self.path.encode("ascii", "backslashreplace").decode(
+            "ascii"
+        )
+        return "<{} {} {} >".format(
+            self.__class__.__name__, self._method, ascii_encodable_path
+        )
+
+    def __eq__(self, other: object) -> bool:
+        return id(self) == id(other)
+
+    def __bool__(self) -> bool:
+        return True
+
+    async def _prepare_hook(self, response: StreamResponse) -> None:
+        return
+
+    def _cancel(self, exc: BaseException) -> None:
+        set_exception(self._payload, exc)
+
+
+class Request(BaseRequest):
+
+    ATTRS = BaseRequest.ATTRS | frozenset(["_match_info"])
+
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        super().__init__(*args, **kwargs)
+
+        # matchdict, route_name, handler
+        # or information about traversal lookup
+
+        # initialized after route resolving
+        self._match_info: Optional[UrlMappingMatchInfo] = None
+
+    if DEBUG:
+
+        def __setattr__(self, name: str, val: Any) -> None:
+            if name not in self.ATTRS:
+                warnings.warn(
+                    "Setting custom {}.{} attribute "
+                    "is discouraged".format(self.__class__.__name__, name),
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+            super().__setattr__(name, val)
+
+    def clone(
+        self,
+        *,
+        method: Union[str, _SENTINEL] = sentinel,
+        rel_url: Union[StrOrURL, _SENTINEL] = sentinel,
+        headers: Union[LooseHeaders, _SENTINEL] = sentinel,
+        scheme: Union[str, _SENTINEL] = sentinel,
+        host: Union[str, _SENTINEL] = sentinel,
+        remote: Union[str, _SENTINEL] = sentinel,
+        client_max_size: Union[int, _SENTINEL] = sentinel,
+    ) -> "Request":
+        ret = super().clone(
+            method=method,
+            rel_url=rel_url,
+            headers=headers,
+            scheme=scheme,
+            host=host,
+            remote=remote,
+            client_max_size=client_max_size,
+        )
+        new_ret = cast(Request, ret)
+        new_ret._match_info = self._match_info
+        return new_ret
+
+    @reify
+    def match_info(self) -> "UrlMappingMatchInfo":
+        """Result of route resolving."""
+        match_info = self._match_info
+        assert match_info is not None
+        return match_info
+
+    @property
+    def app(self) -> "Application":
+        """Application instance."""
+        match_info = self._match_info
+        assert match_info is not None
+        return match_info.current_app
+
+    @property
+    def config_dict(self) -> ChainMapProxy:
+        match_info = self._match_info
+        assert match_info is not None
+        lst = match_info.apps
+        app = self.app
+        idx = lst.index(app)
+        sublist = list(reversed(lst[: idx + 1]))
+        return ChainMapProxy(sublist)
+
+    async def _prepare_hook(self, response: StreamResponse) -> None:
+        match_info = self._match_info
+        if match_info is None:
+            return
+        for app in match_info._apps:
+            await app.on_response_prepare.send(self, response)
diff --git a/llm/Lib/site-packages/aiohttp/web_response.py b/llm/Lib/site-packages/aiohttp/web_response.py
new file mode 100644
index 0000000000000000000000000000000000000000..5f61f60b2cf227dce9df1ba32ff34fdd2d3aafce
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web_response.py
@@ -0,0 +1,819 @@
+import asyncio
+import collections.abc
+import datetime
+import enum
+import json
+import math
+import time
+import warnings
+from concurrent.futures import Executor
+from http import HTTPStatus
+from http.cookies import SimpleCookie
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    Iterator,
+    MutableMapping,
+    Optional,
+    Union,
+    cast,
+)
+
+from multidict import CIMultiDict, istr
+
+from . import hdrs, payload
+from .abc import AbstractStreamWriter
+from .compression_utils import ZLibCompressor
+from .helpers import (
+    ETAG_ANY,
+    QUOTED_ETAG_RE,
+    ETag,
+    HeadersMixin,
+    must_be_empty_body,
+    parse_http_date,
+    rfc822_formatted_time,
+    sentinel,
+    should_remove_content_length,
+    validate_etag_value,
+)
+from .http import SERVER_SOFTWARE, HttpVersion10, HttpVersion11
+from .payload import Payload
+from .typedefs import JSONEncoder, LooseHeaders
+
+__all__ = ("ContentCoding", "StreamResponse", "Response", "json_response")
+
+
+if TYPE_CHECKING:
+    from .web_request import BaseRequest
+
+    BaseClass = MutableMapping[str, Any]
+else:
+    BaseClass = collections.abc.MutableMapping
+
+
+class ContentCoding(enum.Enum):
+    # The content codings that we have support for.
+    #
+    # Additional registered codings are listed at:
+    # https://www.iana.org/assignments/http-parameters/http-parameters.xhtml#content-coding
+    deflate = "deflate"
+    gzip = "gzip"
+    identity = "identity"
+
+
+############################################################
+# HTTP Response classes
+############################################################
+
+
+class StreamResponse(BaseClass, HeadersMixin):
+
+    _length_check = True
+
+    def __init__(
+        self,
+        *,
+        status: int = 200,
+        reason: Optional[str] = None,
+        headers: Optional[LooseHeaders] = None,
+    ) -> None:
+        self._body = None
+        self._keep_alive: Optional[bool] = None
+        self._chunked = False
+        self._compression = False
+        self._compression_force: Optional[ContentCoding] = None
+        self._cookies = SimpleCookie()
+
+        self._req: Optional[BaseRequest] = None
+        self._payload_writer: Optional[AbstractStreamWriter] = None
+        self._eof_sent = False
+        self._must_be_empty_body: Optional[bool] = None
+        self._body_length = 0
+        self._state: Dict[str, Any] = {}
+
+        if headers is not None:
+            self._headers: CIMultiDict[str] = CIMultiDict(headers)
+        else:
+            self._headers = CIMultiDict()
+
+        self.set_status(status, reason)
+
+    @property
+    def prepared(self) -> bool:
+        return self._payload_writer is not None
+
+    @property
+    def task(self) -> "Optional[asyncio.Task[None]]":
+        if self._req:
+            return self._req.task
+        else:
+            return None
+
+    @property
+    def status(self) -> int:
+        return self._status
+
+    @property
+    def chunked(self) -> bool:
+        return self._chunked
+
+    @property
+    def compression(self) -> bool:
+        return self._compression
+
+    @property
+    def reason(self) -> str:
+        return self._reason
+
+    def set_status(
+        self,
+        status: int,
+        reason: Optional[str] = None,
+    ) -> None:
+        assert not self.prepared, (
+            "Cannot change the response status code after " "the headers have been sent"
+        )
+        self._status = int(status)
+        if reason is None:
+            try:
+                reason = HTTPStatus(self._status).phrase
+            except ValueError:
+                reason = ""
+        self._reason = reason
+
+    @property
+    def keep_alive(self) -> Optional[bool]:
+        return self._keep_alive
+
+    def force_close(self) -> None:
+        self._keep_alive = False
+
+    @property
+    def body_length(self) -> int:
+        return self._body_length
+
+    @property
+    def output_length(self) -> int:
+        warnings.warn("output_length is deprecated", DeprecationWarning)
+        assert self._payload_writer
+        return self._payload_writer.buffer_size
+
+    def enable_chunked_encoding(self, chunk_size: Optional[int] = None) -> None:
+        """Enables automatic chunked transfer encoding."""
+        self._chunked = True
+
+        if hdrs.CONTENT_LENGTH in self._headers:
+            raise RuntimeError(
+                "You can't enable chunked encoding when " "a content length is set"
+            )
+        if chunk_size is not None:
+            warnings.warn("Chunk size is deprecated #1615", DeprecationWarning)
+
+    def enable_compression(
+        self, force: Optional[Union[bool, ContentCoding]] = None
+    ) -> None:
+        """Enables response compression encoding."""
+        # Backwards compatibility for when force was a bool <0.17.
+        if type(force) == bool:
+            force = ContentCoding.deflate if force else ContentCoding.identity
+            warnings.warn(
+                "Using boolean for force is deprecated #3318", DeprecationWarning
+            )
+        elif force is not None:
+            assert isinstance(force, ContentCoding), (
+                "force should one of " "None, bool or " "ContentEncoding"
+            )
+
+        self._compression = True
+        self._compression_force = force
+
+    @property
+    def headers(self) -> "CIMultiDict[str]":
+        return self._headers
+
+    @property
+    def cookies(self) -> SimpleCookie:
+        return self._cookies
+
+    def set_cookie(
+        self,
+        name: str,
+        value: str,
+        *,
+        expires: Optional[str] = None,
+        domain: Optional[str] = None,
+        max_age: Optional[Union[int, str]] = None,
+        path: str = "/",
+        secure: Optional[bool] = None,
+        httponly: Optional[bool] = None,
+        version: Optional[str] = None,
+        samesite: Optional[str] = None,
+    ) -> None:
+        """Set or update response cookie.
+
+        Sets new cookie or updates existent with new value.
+        Also updates only those params which are not None.
+        """
+        old = self._cookies.get(name)
+        if old is not None and old.coded_value == "":
+            # deleted cookie
+            self._cookies.pop(name, None)
+
+        self._cookies[name] = value
+        c = self._cookies[name]
+
+        if expires is not None:
+            c["expires"] = expires
+        elif c.get("expires") == "Thu, 01 Jan 1970 00:00:00 GMT":
+            del c["expires"]
+
+        if domain is not None:
+            c["domain"] = domain
+
+        if max_age is not None:
+            c["max-age"] = str(max_age)
+        elif "max-age" in c:
+            del c["max-age"]
+
+        c["path"] = path
+
+        if secure is not None:
+            c["secure"] = secure
+        if httponly is not None:
+            c["httponly"] = httponly
+        if version is not None:
+            c["version"] = version
+        if samesite is not None:
+            c["samesite"] = samesite
+
+    def del_cookie(
+        self, name: str, *, domain: Optional[str] = None, path: str = "/"
+    ) -> None:
+        """Delete cookie.
+
+        Creates new empty expired cookie.
+        """
+        # TODO: do we need domain/path here?
+        self._cookies.pop(name, None)
+        self.set_cookie(
+            name,
+            "",
+            max_age=0,
+            expires="Thu, 01 Jan 1970 00:00:00 GMT",
+            domain=domain,
+            path=path,
+        )
+
+    @property
+    def content_length(self) -> Optional[int]:
+        # Just a placeholder for adding setter
+        return super().content_length
+
+    @content_length.setter
+    def content_length(self, value: Optional[int]) -> None:
+        if value is not None:
+            value = int(value)
+            if self._chunked:
+                raise RuntimeError(
+                    "You can't set content length when " "chunked encoding is enable"
+                )
+            self._headers[hdrs.CONTENT_LENGTH] = str(value)
+        else:
+            self._headers.pop(hdrs.CONTENT_LENGTH, None)
+
+    @property
+    def content_type(self) -> str:
+        # Just a placeholder for adding setter
+        return super().content_type
+
+    @content_type.setter
+    def content_type(self, value: str) -> None:
+        self.content_type  # read header values if needed
+        self._content_type = str(value)
+        self._generate_content_type_header()
+
+    @property
+    def charset(self) -> Optional[str]:
+        # Just a placeholder for adding setter
+        return super().charset
+
+    @charset.setter
+    def charset(self, value: Optional[str]) -> None:
+        ctype = self.content_type  # read header values if needed
+        if ctype == "application/octet-stream":
+            raise RuntimeError(
+                "Setting charset for application/octet-stream "
+                "doesn't make sense, setup content_type first"
+            )
+        assert self._content_dict is not None
+        if value is None:
+            self._content_dict.pop("charset", None)
+        else:
+            self._content_dict["charset"] = str(value).lower()
+        self._generate_content_type_header()
+
+    @property
+    def last_modified(self) -> Optional[datetime.datetime]:
+        """The value of Last-Modified HTTP header, or None.
+
+        This header is represented as a `datetime` object.
+        """
+        return parse_http_date(self._headers.get(hdrs.LAST_MODIFIED))
+
+    @last_modified.setter
+    def last_modified(
+        self, value: Optional[Union[int, float, datetime.datetime, str]]
+    ) -> None:
+        if value is None:
+            self._headers.pop(hdrs.LAST_MODIFIED, None)
+        elif isinstance(value, (int, float)):
+            self._headers[hdrs.LAST_MODIFIED] = time.strftime(
+                "%a, %d %b %Y %H:%M:%S GMT", time.gmtime(math.ceil(value))
+            )
+        elif isinstance(value, datetime.datetime):
+            self._headers[hdrs.LAST_MODIFIED] = time.strftime(
+                "%a, %d %b %Y %H:%M:%S GMT", value.utctimetuple()
+            )
+        elif isinstance(value, str):
+            self._headers[hdrs.LAST_MODIFIED] = value
+
+    @property
+    def etag(self) -> Optional[ETag]:
+        quoted_value = self._headers.get(hdrs.ETAG)
+        if not quoted_value:
+            return None
+        elif quoted_value == ETAG_ANY:
+            return ETag(value=ETAG_ANY)
+        match = QUOTED_ETAG_RE.fullmatch(quoted_value)
+        if not match:
+            return None
+        is_weak, value = match.group(1, 2)
+        return ETag(
+            is_weak=bool(is_weak),
+            value=value,
+        )
+
+    @etag.setter
+    def etag(self, value: Optional[Union[ETag, str]]) -> None:
+        if value is None:
+            self._headers.pop(hdrs.ETAG, None)
+        elif (isinstance(value, str) and value == ETAG_ANY) or (
+            isinstance(value, ETag) and value.value == ETAG_ANY
+        ):
+            self._headers[hdrs.ETAG] = ETAG_ANY
+        elif isinstance(value, str):
+            validate_etag_value(value)
+            self._headers[hdrs.ETAG] = f'"{value}"'
+        elif isinstance(value, ETag) and isinstance(value.value, str):
+            validate_etag_value(value.value)
+            hdr_value = f'W/"{value.value}"' if value.is_weak else f'"{value.value}"'
+            self._headers[hdrs.ETAG] = hdr_value
+        else:
+            raise ValueError(
+                f"Unsupported etag type: {type(value)}. "
+                f"etag must be str, ETag or None"
+            )
+
+    def _generate_content_type_header(
+        self, CONTENT_TYPE: istr = hdrs.CONTENT_TYPE
+    ) -> None:
+        assert self._content_dict is not None
+        assert self._content_type is not None
+        params = "; ".join(f"{k}={v}" for k, v in self._content_dict.items())
+        if params:
+            ctype = self._content_type + "; " + params
+        else:
+            ctype = self._content_type
+        self._headers[CONTENT_TYPE] = ctype
+
+    async def _do_start_compression(self, coding: ContentCoding) -> None:
+        if coding != ContentCoding.identity:
+            assert self._payload_writer is not None
+            self._headers[hdrs.CONTENT_ENCODING] = coding.value
+            self._payload_writer.enable_compression(coding.value)
+            # Compressed payload may have different content length,
+            # remove the header
+            self._headers.popall(hdrs.CONTENT_LENGTH, None)
+
+    async def _start_compression(self, request: "BaseRequest") -> None:
+        if self._compression_force:
+            await self._do_start_compression(self._compression_force)
+        else:
+            # Encoding comparisons should be case-insensitive
+            # https://www.rfc-editor.org/rfc/rfc9110#section-8.4.1
+            accept_encoding = request.headers.get(hdrs.ACCEPT_ENCODING, "").lower()
+            for coding in ContentCoding:
+                if coding.value in accept_encoding:
+                    await self._do_start_compression(coding)
+                    return
+
+    async def prepare(self, request: "BaseRequest") -> Optional[AbstractStreamWriter]:
+        if self._eof_sent:
+            return None
+        if self._payload_writer is not None:
+            return self._payload_writer
+        self._must_be_empty_body = must_be_empty_body(request.method, self.status)
+        return await self._start(request)
+
+    async def _start(self, request: "BaseRequest") -> AbstractStreamWriter:
+        self._req = request
+        writer = self._payload_writer = request._payload_writer
+
+        await self._prepare_headers()
+        await request._prepare_hook(self)
+        await self._write_headers()
+
+        return writer
+
+    async def _prepare_headers(self) -> None:
+        request = self._req
+        assert request is not None
+        writer = self._payload_writer
+        assert writer is not None
+        keep_alive = self._keep_alive
+        if keep_alive is None:
+            keep_alive = request.keep_alive
+        self._keep_alive = keep_alive
+
+        version = request.version
+
+        headers = self._headers
+        for cookie in self._cookies.values():
+            value = cookie.output(header="")[1:]
+            headers.add(hdrs.SET_COOKIE, value)
+
+        if self._compression:
+            await self._start_compression(request)
+
+        if self._chunked:
+            if version != HttpVersion11:
+                raise RuntimeError(
+                    "Using chunked encoding is forbidden "
+                    "for HTTP/{0.major}.{0.minor}".format(request.version)
+                )
+            if not self._must_be_empty_body:
+                writer.enable_chunking()
+                headers[hdrs.TRANSFER_ENCODING] = "chunked"
+            if hdrs.CONTENT_LENGTH in headers:
+                del headers[hdrs.CONTENT_LENGTH]
+        elif self._length_check:
+            writer.length = self.content_length
+            if writer.length is None:
+                if version >= HttpVersion11:
+                    if not self._must_be_empty_body:
+                        writer.enable_chunking()
+                        headers[hdrs.TRANSFER_ENCODING] = "chunked"
+                elif not self._must_be_empty_body:
+                    keep_alive = False
+
+        # HTTP 1.1: https://tools.ietf.org/html/rfc7230#section-3.3.2
+        # HTTP 1.0: https://tools.ietf.org/html/rfc1945#section-10.4
+        if self._must_be_empty_body:
+            if hdrs.CONTENT_LENGTH in headers and should_remove_content_length(
+                request.method, self.status
+            ):
+                del headers[hdrs.CONTENT_LENGTH]
+            # https://datatracker.ietf.org/doc/html/rfc9112#section-6.1-10
+            # https://datatracker.ietf.org/doc/html/rfc9112#section-6.1-13
+            if hdrs.TRANSFER_ENCODING in headers:
+                del headers[hdrs.TRANSFER_ENCODING]
+        else:
+            headers.setdefault(hdrs.CONTENT_TYPE, "application/octet-stream")
+        headers.setdefault(hdrs.DATE, rfc822_formatted_time())
+        headers.setdefault(hdrs.SERVER, SERVER_SOFTWARE)
+
+        # connection header
+        if hdrs.CONNECTION not in headers:
+            if keep_alive:
+                if version == HttpVersion10:
+                    headers[hdrs.CONNECTION] = "keep-alive"
+            else:
+                if version == HttpVersion11:
+                    headers[hdrs.CONNECTION] = "close"
+
+    async def _write_headers(self) -> None:
+        request = self._req
+        assert request is not None
+        writer = self._payload_writer
+        assert writer is not None
+        # status line
+        version = request.version
+        status_line = "HTTP/{}.{} {} {}".format(
+            version[0], version[1], self._status, self._reason
+        )
+        await writer.write_headers(status_line, self._headers)
+
+    async def write(self, data: bytes) -> None:
+        assert isinstance(
+            data, (bytes, bytearray, memoryview)
+        ), "data argument must be byte-ish (%r)" % type(data)
+
+        if self._eof_sent:
+            raise RuntimeError("Cannot call write() after write_eof()")
+        if self._payload_writer is None:
+            raise RuntimeError("Cannot call write() before prepare()")
+
+        await self._payload_writer.write(data)
+
+    async def drain(self) -> None:
+        assert not self._eof_sent, "EOF has already been sent"
+        assert self._payload_writer is not None, "Response has not been started"
+        warnings.warn(
+            "drain method is deprecated, use await resp.write()",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        await self._payload_writer.drain()
+
+    async def write_eof(self, data: bytes = b"") -> None:
+        assert isinstance(
+            data, (bytes, bytearray, memoryview)
+        ), "data argument must be byte-ish (%r)" % type(data)
+
+        if self._eof_sent:
+            return
+
+        assert self._payload_writer is not None, "Response has not been started"
+
+        await self._payload_writer.write_eof(data)
+        self._eof_sent = True
+        self._req = None
+        self._body_length = self._payload_writer.output_size
+        self._payload_writer = None
+
+    def __repr__(self) -> str:
+        if self._eof_sent:
+            info = "eof"
+        elif self.prepared:
+            assert self._req is not None
+            info = f"{self._req.method} {self._req.path} "
+        else:
+            info = "not prepared"
+        return f"<{self.__class__.__name__} {self.reason} {info}>"
+
+    def __getitem__(self, key: str) -> Any:
+        return self._state[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self._state[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self._state[key]
+
+    def __len__(self) -> int:
+        return len(self._state)
+
+    def __iter__(self) -> Iterator[str]:
+        return iter(self._state)
+
+    def __hash__(self) -> int:
+        return hash(id(self))
+
+    def __eq__(self, other: object) -> bool:
+        return self is other
+
+
+class Response(StreamResponse):
+    def __init__(
+        self,
+        *,
+        body: Any = None,
+        status: int = 200,
+        reason: Optional[str] = None,
+        text: Optional[str] = None,
+        headers: Optional[LooseHeaders] = None,
+        content_type: Optional[str] = None,
+        charset: Optional[str] = None,
+        zlib_executor_size: Optional[int] = None,
+        zlib_executor: Optional[Executor] = None,
+    ) -> None:
+        if body is not None and text is not None:
+            raise ValueError("body and text are not allowed together")
+
+        if headers is None:
+            real_headers: CIMultiDict[str] = CIMultiDict()
+        elif not isinstance(headers, CIMultiDict):
+            real_headers = CIMultiDict(headers)
+        else:
+            real_headers = headers  # = cast('CIMultiDict[str]', headers)
+
+        if content_type is not None and "charset" in content_type:
+            raise ValueError("charset must not be in content_type " "argument")
+
+        if text is not None:
+            if hdrs.CONTENT_TYPE in real_headers:
+                if content_type or charset:
+                    raise ValueError(
+                        "passing both Content-Type header and "
+                        "content_type or charset params "
+                        "is forbidden"
+                    )
+            else:
+                # fast path for filling headers
+                if not isinstance(text, str):
+                    raise TypeError("text argument must be str (%r)" % type(text))
+                if content_type is None:
+                    content_type = "text/plain"
+                if charset is None:
+                    charset = "utf-8"
+                real_headers[hdrs.CONTENT_TYPE] = content_type + "; charset=" + charset
+                body = text.encode(charset)
+                text = None
+        else:
+            if hdrs.CONTENT_TYPE in real_headers:
+                if content_type is not None or charset is not None:
+                    raise ValueError(
+                        "passing both Content-Type header and "
+                        "content_type or charset params "
+                        "is forbidden"
+                    )
+            else:
+                if content_type is not None:
+                    if charset is not None:
+                        content_type += "; charset=" + charset
+                    real_headers[hdrs.CONTENT_TYPE] = content_type
+
+        super().__init__(status=status, reason=reason, headers=real_headers)
+
+        if text is not None:
+            self.text = text
+        else:
+            self.body = body
+
+        self._compressed_body: Optional[bytes] = None
+        self._zlib_executor_size = zlib_executor_size
+        self._zlib_executor = zlib_executor
+
+    @property
+    def body(self) -> Optional[Union[bytes, Payload]]:
+        return self._body
+
+    @body.setter
+    def body(self, body: bytes) -> None:
+        if body is None:
+            self._body: Optional[bytes] = None
+            self._body_payload: bool = False
+        elif isinstance(body, (bytes, bytearray)):
+            self._body = body
+            self._body_payload = False
+        else:
+            try:
+                self._body = body = payload.PAYLOAD_REGISTRY.get(body)
+            except payload.LookupError:
+                raise ValueError("Unsupported body type %r" % type(body))
+
+            self._body_payload = True
+
+            headers = self._headers
+
+            # set content-type
+            if hdrs.CONTENT_TYPE not in headers:
+                headers[hdrs.CONTENT_TYPE] = body.content_type
+
+            # copy payload headers
+            if body.headers:
+                for (key, value) in body.headers.items():
+                    if key not in headers:
+                        headers[key] = value
+
+        self._compressed_body = None
+
+    @property
+    def text(self) -> Optional[str]:
+        if self._body is None:
+            return None
+        return self._body.decode(self.charset or "utf-8")
+
+    @text.setter
+    def text(self, text: str) -> None:
+        assert text is None or isinstance(
+            text, str
+        ), "text argument must be str (%r)" % type(text)
+
+        if self.content_type == "application/octet-stream":
+            self.content_type = "text/plain"
+        if self.charset is None:
+            self.charset = "utf-8"
+
+        self._body = text.encode(self.charset)
+        self._body_payload = False
+        self._compressed_body = None
+
+    @property
+    def content_length(self) -> Optional[int]:
+        if self._chunked:
+            return None
+
+        if hdrs.CONTENT_LENGTH in self._headers:
+            return super().content_length
+
+        if self._compressed_body is not None:
+            # Return length of the compressed body
+            return len(self._compressed_body)
+        elif self._body_payload:
+            # A payload without content length, or a compressed payload
+            return None
+        elif self._body is not None:
+            return len(self._body)
+        else:
+            return 0
+
+    @content_length.setter
+    def content_length(self, value: Optional[int]) -> None:
+        raise RuntimeError("Content length is set automatically")
+
+    async def write_eof(self, data: bytes = b"") -> None:
+        if self._eof_sent:
+            return
+        if self._compressed_body is None:
+            body: Optional[Union[bytes, Payload]] = self._body
+        else:
+            body = self._compressed_body
+        assert not data, f"data arg is not supported, got {data!r}"
+        assert self._req is not None
+        assert self._payload_writer is not None
+        if body is not None:
+            if self._must_be_empty_body:
+                await super().write_eof()
+            elif self._body_payload:
+                payload = cast(Payload, body)
+                await payload.write(self._payload_writer)
+                await super().write_eof()
+            else:
+                await super().write_eof(cast(bytes, body))
+        else:
+            await super().write_eof()
+
+    async def _start(self, request: "BaseRequest") -> AbstractStreamWriter:
+        if should_remove_content_length(request.method, self.status):
+            if hdrs.CONTENT_LENGTH in self._headers:
+                del self._headers[hdrs.CONTENT_LENGTH]
+        elif not self._chunked and hdrs.CONTENT_LENGTH not in self._headers:
+            if self._body_payload:
+                size = cast(Payload, self._body).size
+                if size is not None:
+                    self._headers[hdrs.CONTENT_LENGTH] = str(size)
+            else:
+                body_len = len(self._body) if self._body else "0"
+                # https://www.rfc-editor.org/rfc/rfc9110.html#section-8.6-7
+                if body_len != "0" or (
+                    self.status != 304 and request.method.upper() != hdrs.METH_HEAD
+                ):
+                    self._headers[hdrs.CONTENT_LENGTH] = str(body_len)
+
+        return await super()._start(request)
+
+    async def _do_start_compression(self, coding: ContentCoding) -> None:
+        if self._body_payload or self._chunked:
+            return await super()._do_start_compression(coding)
+
+        if coding != ContentCoding.identity:
+            # Instead of using _payload_writer.enable_compression,
+            # compress the whole body
+            compressor = ZLibCompressor(
+                encoding=str(coding.value),
+                max_sync_chunk_size=self._zlib_executor_size,
+                executor=self._zlib_executor,
+            )
+            assert self._body is not None
+            if self._zlib_executor_size is None and len(self._body) > 1024 * 1024:
+                warnings.warn(
+                    "Synchronous compression of large response bodies "
+                    f"({len(self._body)} bytes) might block the async event loop. "
+                    "Consider providing a custom value to zlib_executor_size/"
+                    "zlib_executor response properties or disabling compression on it."
+                )
+            self._compressed_body = (
+                await compressor.compress(self._body) + compressor.flush()
+            )
+            assert self._compressed_body is not None
+
+            self._headers[hdrs.CONTENT_ENCODING] = coding.value
+            self._headers[hdrs.CONTENT_LENGTH] = str(len(self._compressed_body))
+
+
+def json_response(
+    data: Any = sentinel,
+    *,
+    text: Optional[str] = None,
+    body: Optional[bytes] = None,
+    status: int = 200,
+    reason: Optional[str] = None,
+    headers: Optional[LooseHeaders] = None,
+    content_type: str = "application/json",
+    dumps: JSONEncoder = json.dumps,
+) -> Response:
+    if data is not sentinel:
+        if text or body:
+            raise ValueError("only one of data, text, or body should be specified")
+        else:
+            text = dumps(data)
+    return Response(
+        text=text,
+        body=body,
+        status=status,
+        reason=reason,
+        headers=headers,
+        content_type=content_type,
+    )
diff --git a/llm/Lib/site-packages/aiohttp/web_routedef.py b/llm/Lib/site-packages/aiohttp/web_routedef.py
new file mode 100644
index 0000000000000000000000000000000000000000..39f637df49eddfa7f18f76237033c06b373d8be6
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web_routedef.py
@@ -0,0 +1,216 @@
+import abc
+import os  # noqa
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+    Sequence,
+    Type,
+    Union,
+    overload,
+)
+
+import attr
+
+from . import hdrs
+from .abc import AbstractView
+from .typedefs import Handler, PathLike
+
+if TYPE_CHECKING:
+    from .web_request import Request
+    from .web_response import StreamResponse
+    from .web_urldispatcher import AbstractRoute, UrlDispatcher
+else:
+    Request = StreamResponse = UrlDispatcher = AbstractRoute = None
+
+
+__all__ = (
+    "AbstractRouteDef",
+    "RouteDef",
+    "StaticDef",
+    "RouteTableDef",
+    "head",
+    "options",
+    "get",
+    "post",
+    "patch",
+    "put",
+    "delete",
+    "route",
+    "view",
+    "static",
+)
+
+
+class AbstractRouteDef(abc.ABC):
+    @abc.abstractmethod
+    def register(self, router: UrlDispatcher) -> List[AbstractRoute]:
+        pass  # pragma: no cover
+
+
+_HandlerType = Union[Type[AbstractView], Handler]
+
+
+@attr.s(auto_attribs=True, frozen=True, repr=False, slots=True)
+class RouteDef(AbstractRouteDef):
+    method: str
+    path: str
+    handler: _HandlerType
+    kwargs: Dict[str, Any]
+
+    def __repr__(self) -> str:
+        info = []
+        for name, value in sorted(self.kwargs.items()):
+            info.append(f", {name}={value!r}")
+        return "<RouteDef {method} {path} -> {handler.__name__!r}" "{info}>".format(
+            method=self.method, path=self.path, handler=self.handler, info="".join(info)
+        )
+
+    def register(self, router: UrlDispatcher) -> List[AbstractRoute]:
+        if self.method in hdrs.METH_ALL:
+            reg = getattr(router, "add_" + self.method.lower())
+            return [reg(self.path, self.handler, **self.kwargs)]
+        else:
+            return [
+                router.add_route(self.method, self.path, self.handler, **self.kwargs)
+            ]
+
+
+@attr.s(auto_attribs=True, frozen=True, repr=False, slots=True)
+class StaticDef(AbstractRouteDef):
+    prefix: str
+    path: PathLike
+    kwargs: Dict[str, Any]
+
+    def __repr__(self) -> str:
+        info = []
+        for name, value in sorted(self.kwargs.items()):
+            info.append(f", {name}={value!r}")
+        return "<StaticDef {prefix} -> {path}" "{info}>".format(
+            prefix=self.prefix, path=self.path, info="".join(info)
+        )
+
+    def register(self, router: UrlDispatcher) -> List[AbstractRoute]:
+        resource = router.add_static(self.prefix, self.path, **self.kwargs)
+        routes = resource.get_info().get("routes", {})
+        return list(routes.values())
+
+
+def route(method: str, path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef:
+    return RouteDef(method, path, handler, kwargs)
+
+
+def head(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef:
+    return route(hdrs.METH_HEAD, path, handler, **kwargs)
+
+
+def options(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef:
+    return route(hdrs.METH_OPTIONS, path, handler, **kwargs)
+
+
+def get(
+    path: str,
+    handler: _HandlerType,
+    *,
+    name: Optional[str] = None,
+    allow_head: bool = True,
+    **kwargs: Any,
+) -> RouteDef:
+    return route(
+        hdrs.METH_GET, path, handler, name=name, allow_head=allow_head, **kwargs
+    )
+
+
+def post(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef:
+    return route(hdrs.METH_POST, path, handler, **kwargs)
+
+
+def put(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef:
+    return route(hdrs.METH_PUT, path, handler, **kwargs)
+
+
+def patch(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef:
+    return route(hdrs.METH_PATCH, path, handler, **kwargs)
+
+
+def delete(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef:
+    return route(hdrs.METH_DELETE, path, handler, **kwargs)
+
+
+def view(path: str, handler: Type[AbstractView], **kwargs: Any) -> RouteDef:
+    return route(hdrs.METH_ANY, path, handler, **kwargs)
+
+
+def static(prefix: str, path: PathLike, **kwargs: Any) -> StaticDef:
+    return StaticDef(prefix, path, kwargs)
+
+
+_Deco = Callable[[_HandlerType], _HandlerType]
+
+
+class RouteTableDef(Sequence[AbstractRouteDef]):
+    """Route definition table"""
+
+    def __init__(self) -> None:
+        self._items: List[AbstractRouteDef] = []
+
+    def __repr__(self) -> str:
+        return f"<RouteTableDef count={len(self._items)}>"
+
+    @overload
+    def __getitem__(self, index: int) -> AbstractRouteDef:
+        ...
+
+    @overload
+    def __getitem__(self, index: slice) -> List[AbstractRouteDef]:
+        ...
+
+    def __getitem__(self, index):  # type: ignore[no-untyped-def]
+        return self._items[index]
+
+    def __iter__(self) -> Iterator[AbstractRouteDef]:
+        return iter(self._items)
+
+    def __len__(self) -> int:
+        return len(self._items)
+
+    def __contains__(self, item: object) -> bool:
+        return item in self._items
+
+    def route(self, method: str, path: str, **kwargs: Any) -> _Deco:
+        def inner(handler: _HandlerType) -> _HandlerType:
+            self._items.append(RouteDef(method, path, handler, kwargs))
+            return handler
+
+        return inner
+
+    def head(self, path: str, **kwargs: Any) -> _Deco:
+        return self.route(hdrs.METH_HEAD, path, **kwargs)
+
+    def get(self, path: str, **kwargs: Any) -> _Deco:
+        return self.route(hdrs.METH_GET, path, **kwargs)
+
+    def post(self, path: str, **kwargs: Any) -> _Deco:
+        return self.route(hdrs.METH_POST, path, **kwargs)
+
+    def put(self, path: str, **kwargs: Any) -> _Deco:
+        return self.route(hdrs.METH_PUT, path, **kwargs)
+
+    def patch(self, path: str, **kwargs: Any) -> _Deco:
+        return self.route(hdrs.METH_PATCH, path, **kwargs)
+
+    def delete(self, path: str, **kwargs: Any) -> _Deco:
+        return self.route(hdrs.METH_DELETE, path, **kwargs)
+
+    def options(self, path: str, **kwargs: Any) -> _Deco:
+        return self.route(hdrs.METH_OPTIONS, path, **kwargs)
+
+    def view(self, path: str, **kwargs: Any) -> _Deco:
+        return self.route(hdrs.METH_ANY, path, **kwargs)
+
+    def static(self, prefix: str, path: PathLike, **kwargs: Any) -> None:
+        self._items.append(StaticDef(prefix, path, kwargs))
diff --git a/llm/Lib/site-packages/aiohttp/web_runner.py b/llm/Lib/site-packages/aiohttp/web_runner.py
new file mode 100644
index 0000000000000000000000000000000000000000..930e940d45753c9f9811ea84622bf833b5a1a206
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web_runner.py
@@ -0,0 +1,409 @@
+import asyncio
+import signal
+import socket
+import warnings
+from abc import ABC, abstractmethod
+from typing import Any, Awaitable, Callable, List, Optional, Set
+
+from yarl import URL
+
+from .typedefs import PathLike
+from .web_app import Application
+from .web_server import Server
+
+try:
+    from ssl import SSLContext
+except ImportError:
+    SSLContext = object  # type: ignore[misc,assignment]
+
+
+__all__ = (
+    "BaseSite",
+    "TCPSite",
+    "UnixSite",
+    "NamedPipeSite",
+    "SockSite",
+    "BaseRunner",
+    "AppRunner",
+    "ServerRunner",
+    "GracefulExit",
+)
+
+
+class GracefulExit(SystemExit):
+    code = 1
+
+
+def _raise_graceful_exit() -> None:
+    raise GracefulExit()
+
+
+class BaseSite(ABC):
+    __slots__ = ("_runner", "_ssl_context", "_backlog", "_server")
+
+    def __init__(
+        self,
+        runner: "BaseRunner",
+        *,
+        shutdown_timeout: float = 60.0,
+        ssl_context: Optional[SSLContext] = None,
+        backlog: int = 128,
+    ) -> None:
+        if runner.server is None:
+            raise RuntimeError("Call runner.setup() before making a site")
+        if shutdown_timeout != 60.0:
+            msg = "shutdown_timeout should be set on BaseRunner"
+            warnings.warn(msg, DeprecationWarning, stacklevel=2)
+            runner._shutdown_timeout = shutdown_timeout
+        self._runner = runner
+        self._ssl_context = ssl_context
+        self._backlog = backlog
+        self._server: Optional[asyncio.AbstractServer] = None
+
+    @property
+    @abstractmethod
+    def name(self) -> str:
+        pass  # pragma: no cover
+
+    @abstractmethod
+    async def start(self) -> None:
+        self._runner._reg_site(self)
+
+    async def stop(self) -> None:
+        self._runner._check_site(self)
+        if self._server is not None:  # Maybe not started yet
+            self._server.close()
+
+        self._runner._unreg_site(self)
+
+
+class TCPSite(BaseSite):
+    __slots__ = ("_host", "_port", "_reuse_address", "_reuse_port")
+
+    def __init__(
+        self,
+        runner: "BaseRunner",
+        host: Optional[str] = None,
+        port: Optional[int] = None,
+        *,
+        shutdown_timeout: float = 60.0,
+        ssl_context: Optional[SSLContext] = None,
+        backlog: int = 128,
+        reuse_address: Optional[bool] = None,
+        reuse_port: Optional[bool] = None,
+    ) -> None:
+        super().__init__(
+            runner,
+            shutdown_timeout=shutdown_timeout,
+            ssl_context=ssl_context,
+            backlog=backlog,
+        )
+        self._host = host
+        if port is None:
+            port = 8443 if self._ssl_context else 8080
+        self._port = port
+        self._reuse_address = reuse_address
+        self._reuse_port = reuse_port
+
+    @property
+    def name(self) -> str:
+        scheme = "https" if self._ssl_context else "http"
+        host = "0.0.0.0" if self._host is None else self._host
+        return str(URL.build(scheme=scheme, host=host, port=self._port))
+
+    async def start(self) -> None:
+        await super().start()
+        loop = asyncio.get_event_loop()
+        server = self._runner.server
+        assert server is not None
+        self._server = await loop.create_server(
+            server,
+            self._host,
+            self._port,
+            ssl=self._ssl_context,
+            backlog=self._backlog,
+            reuse_address=self._reuse_address,
+            reuse_port=self._reuse_port,
+        )
+
+
+class UnixSite(BaseSite):
+    __slots__ = ("_path",)
+
+    def __init__(
+        self,
+        runner: "BaseRunner",
+        path: PathLike,
+        *,
+        shutdown_timeout: float = 60.0,
+        ssl_context: Optional[SSLContext] = None,
+        backlog: int = 128,
+    ) -> None:
+        super().__init__(
+            runner,
+            shutdown_timeout=shutdown_timeout,
+            ssl_context=ssl_context,
+            backlog=backlog,
+        )
+        self._path = path
+
+    @property
+    def name(self) -> str:
+        scheme = "https" if self._ssl_context else "http"
+        return f"{scheme}://unix:{self._path}:"
+
+    async def start(self) -> None:
+        await super().start()
+        loop = asyncio.get_event_loop()
+        server = self._runner.server
+        assert server is not None
+        self._server = await loop.create_unix_server(
+            server,
+            self._path,
+            ssl=self._ssl_context,
+            backlog=self._backlog,
+        )
+
+
+class NamedPipeSite(BaseSite):
+    __slots__ = ("_path",)
+
+    def __init__(
+        self, runner: "BaseRunner", path: str, *, shutdown_timeout: float = 60.0
+    ) -> None:
+        loop = asyncio.get_event_loop()
+        if not isinstance(
+            loop, asyncio.ProactorEventLoop  # type: ignore[attr-defined]
+        ):
+            raise RuntimeError(
+                "Named Pipes only available in proactor" "loop under windows"
+            )
+        super().__init__(runner, shutdown_timeout=shutdown_timeout)
+        self._path = path
+
+    @property
+    def name(self) -> str:
+        return self._path
+
+    async def start(self) -> None:
+        await super().start()
+        loop = asyncio.get_event_loop()
+        server = self._runner.server
+        assert server is not None
+        _server = await loop.start_serving_pipe(  # type: ignore[attr-defined]
+            server, self._path
+        )
+        self._server = _server[0]
+
+
+class SockSite(BaseSite):
+    __slots__ = ("_sock", "_name")
+
+    def __init__(
+        self,
+        runner: "BaseRunner",
+        sock: socket.socket,
+        *,
+        shutdown_timeout: float = 60.0,
+        ssl_context: Optional[SSLContext] = None,
+        backlog: int = 128,
+    ) -> None:
+        super().__init__(
+            runner,
+            shutdown_timeout=shutdown_timeout,
+            ssl_context=ssl_context,
+            backlog=backlog,
+        )
+        self._sock = sock
+        scheme = "https" if self._ssl_context else "http"
+        if hasattr(socket, "AF_UNIX") and sock.family == socket.AF_UNIX:
+            name = f"{scheme}://unix:{sock.getsockname()}:"
+        else:
+            host, port = sock.getsockname()[:2]
+            name = str(URL.build(scheme=scheme, host=host, port=port))
+        self._name = name
+
+    @property
+    def name(self) -> str:
+        return self._name
+
+    async def start(self) -> None:
+        await super().start()
+        loop = asyncio.get_event_loop()
+        server = self._runner.server
+        assert server is not None
+        self._server = await loop.create_server(
+            server, sock=self._sock, ssl=self._ssl_context, backlog=self._backlog
+        )
+
+
+class BaseRunner(ABC):
+    __slots__ = (
+        "shutdown_callback",
+        "_handle_signals",
+        "_kwargs",
+        "_server",
+        "_sites",
+        "_shutdown_timeout",
+    )
+
+    def __init__(
+        self,
+        *,
+        handle_signals: bool = False,
+        shutdown_timeout: float = 60.0,
+        **kwargs: Any,
+    ) -> None:
+        self.shutdown_callback: Optional[Callable[[], Awaitable[None]]] = None
+        self._handle_signals = handle_signals
+        self._kwargs = kwargs
+        self._server: Optional[Server] = None
+        self._sites: List[BaseSite] = []
+        self._shutdown_timeout = shutdown_timeout
+
+    @property
+    def server(self) -> Optional[Server]:
+        return self._server
+
+    @property
+    def addresses(self) -> List[Any]:
+        ret: List[Any] = []
+        for site in self._sites:
+            server = site._server
+            if server is not None:
+                sockets = server.sockets  # type: ignore[attr-defined]
+                if sockets is not None:
+                    for sock in sockets:
+                        ret.append(sock.getsockname())
+        return ret
+
+    @property
+    def sites(self) -> Set[BaseSite]:
+        return set(self._sites)
+
+    async def setup(self) -> None:
+        loop = asyncio.get_event_loop()
+
+        if self._handle_signals:
+            try:
+                loop.add_signal_handler(signal.SIGINT, _raise_graceful_exit)
+                loop.add_signal_handler(signal.SIGTERM, _raise_graceful_exit)
+            except NotImplementedError:  # pragma: no cover
+                # add_signal_handler is not implemented on Windows
+                pass
+
+        self._server = await self._make_server()
+
+    @abstractmethod
+    async def shutdown(self) -> None:
+        """Call any shutdown hooks to help server close gracefully."""
+
+    async def cleanup(self) -> None:
+        # The loop over sites is intentional, an exception on gather()
+        # leaves self._sites in unpredictable state.
+        # The loop guaranties that a site is either deleted on success or
+        # still present on failure
+        for site in list(self._sites):
+            await site.stop()
+
+        if self._server:  # If setup succeeded
+            # Yield to event loop to ensure incoming requests prior to stopping the sites
+            # have all started to be handled before we proceed to close idle connections.
+            await asyncio.sleep(0)
+            self._server.pre_shutdown()
+            await self.shutdown()
+
+            if self.shutdown_callback:
+                await self.shutdown_callback()
+
+            await self._server.shutdown(self._shutdown_timeout)
+        await self._cleanup_server()
+
+        self._server = None
+        if self._handle_signals:
+            loop = asyncio.get_running_loop()
+            try:
+                loop.remove_signal_handler(signal.SIGINT)
+                loop.remove_signal_handler(signal.SIGTERM)
+            except NotImplementedError:  # pragma: no cover
+                # remove_signal_handler is not implemented on Windows
+                pass
+
+    @abstractmethod
+    async def _make_server(self) -> Server:
+        pass  # pragma: no cover
+
+    @abstractmethod
+    async def _cleanup_server(self) -> None:
+        pass  # pragma: no cover
+
+    def _reg_site(self, site: BaseSite) -> None:
+        if site in self._sites:
+            raise RuntimeError(f"Site {site} is already registered in runner {self}")
+        self._sites.append(site)
+
+    def _check_site(self, site: BaseSite) -> None:
+        if site not in self._sites:
+            raise RuntimeError(f"Site {site} is not registered in runner {self}")
+
+    def _unreg_site(self, site: BaseSite) -> None:
+        if site not in self._sites:
+            raise RuntimeError(f"Site {site} is not registered in runner {self}")
+        self._sites.remove(site)
+
+
+class ServerRunner(BaseRunner):
+    """Low-level web server runner"""
+
+    __slots__ = ("_web_server",)
+
+    def __init__(
+        self, web_server: Server, *, handle_signals: bool = False, **kwargs: Any
+    ) -> None:
+        super().__init__(handle_signals=handle_signals, **kwargs)
+        self._web_server = web_server
+
+    async def shutdown(self) -> None:
+        pass
+
+    async def _make_server(self) -> Server:
+        return self._web_server
+
+    async def _cleanup_server(self) -> None:
+        pass
+
+
+class AppRunner(BaseRunner):
+    """Web Application runner"""
+
+    __slots__ = ("_app",)
+
+    def __init__(
+        self, app: Application, *, handle_signals: bool = False, **kwargs: Any
+    ) -> None:
+        super().__init__(handle_signals=handle_signals, **kwargs)
+        if not isinstance(app, Application):
+            raise TypeError(
+                "The first argument should be web.Application "
+                "instance, got {!r}".format(app)
+            )
+        self._app = app
+
+    @property
+    def app(self) -> Application:
+        return self._app
+
+    async def shutdown(self) -> None:
+        await self._app.shutdown()
+
+    async def _make_server(self) -> Server:
+        loop = asyncio.get_event_loop()
+        self._app._set_loop(loop)
+        self._app.on_startup.freeze()
+        await self._app.startup()
+        self._app.freeze()
+
+        return self._app._make_handler(loop=loop, **self._kwargs)
+
+    async def _cleanup_server(self) -> None:
+        await self._app.cleanup()
diff --git a/llm/Lib/site-packages/aiohttp/web_server.py b/llm/Lib/site-packages/aiohttp/web_server.py
new file mode 100644
index 0000000000000000000000000000000000000000..31e9b79d2f8ea36dc711451b47677c37c596e1cf
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web_server.py
@@ -0,0 +1,77 @@
+"""Low level HTTP server."""
+import asyncio
+from typing import Any, Awaitable, Callable, Dict, List, Optional  # noqa
+
+from .abc import AbstractStreamWriter
+from .helpers import get_running_loop
+from .http_parser import RawRequestMessage
+from .streams import StreamReader
+from .web_protocol import RequestHandler, _RequestFactory, _RequestHandler
+from .web_request import BaseRequest
+
+__all__ = ("Server",)
+
+
+class Server:
+    def __init__(
+        self,
+        handler: _RequestHandler,
+        *,
+        request_factory: Optional[_RequestFactory] = None,
+        handler_cancellation: bool = False,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        **kwargs: Any
+    ) -> None:
+        self._loop = get_running_loop(loop)
+        self._connections: Dict[RequestHandler, asyncio.Transport] = {}
+        self._kwargs = kwargs
+        self.requests_count = 0
+        self.request_handler = handler
+        self.request_factory = request_factory or self._make_request
+        self.handler_cancellation = handler_cancellation
+
+    @property
+    def connections(self) -> List[RequestHandler]:
+        return list(self._connections.keys())
+
+    def connection_made(
+        self, handler: RequestHandler, transport: asyncio.Transport
+    ) -> None:
+        self._connections[handler] = transport
+
+    def connection_lost(
+        self, handler: RequestHandler, exc: Optional[BaseException] = None
+    ) -> None:
+        if handler in self._connections:
+            del self._connections[handler]
+
+    def _make_request(
+        self,
+        message: RawRequestMessage,
+        payload: StreamReader,
+        protocol: RequestHandler,
+        writer: AbstractStreamWriter,
+        task: "asyncio.Task[None]",
+    ) -> BaseRequest:
+        return BaseRequest(message, payload, protocol, writer, task, self._loop)
+
+    def pre_shutdown(self) -> None:
+        for conn in self._connections:
+            conn.close()
+
+    async def shutdown(self, timeout: Optional[float] = None) -> None:
+        coros = (conn.shutdown(timeout) for conn in self._connections)
+        await asyncio.gather(*coros)
+        self._connections.clear()
+
+    def __call__(self) -> RequestHandler:
+        try:
+            return RequestHandler(self, loop=self._loop, **self._kwargs)
+        except TypeError:
+            # Failsafe creation: remove all custom handler_args
+            kwargs = {
+                k: v
+                for k, v in self._kwargs.items()
+                if k in ["debug", "access_log_class"]
+            }
+            return RequestHandler(self, loop=self._loop, **kwargs)
diff --git a/llm/Lib/site-packages/aiohttp/web_urldispatcher.py b/llm/Lib/site-packages/aiohttp/web_urldispatcher.py
new file mode 100644
index 0000000000000000000000000000000000000000..5b3fed49d1de6d0414f2f6e0e117473a0cccb43e
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web_urldispatcher.py
@@ -0,0 +1,1234 @@
+import abc
+import asyncio
+import base64
+import functools
+import hashlib
+import html
+import inspect
+import keyword
+import os
+import re
+import warnings
+from contextlib import contextmanager
+from functools import wraps
+from pathlib import Path
+from types import MappingProxyType
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Awaitable,
+    Callable,
+    Container,
+    Dict,
+    Final,
+    Generator,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    NoReturn,
+    Optional,
+    Pattern,
+    Set,
+    Sized,
+    Tuple,
+    Type,
+    TypedDict,
+    Union,
+    cast,
+)
+
+from yarl import URL, __version__ as yarl_version  # type: ignore[attr-defined]
+
+from . import hdrs
+from .abc import AbstractMatchInfo, AbstractRouter, AbstractView
+from .helpers import DEBUG
+from .http import HttpVersion11
+from .typedefs import Handler, PathLike
+from .web_exceptions import (
+    HTTPException,
+    HTTPExpectationFailed,
+    HTTPForbidden,
+    HTTPMethodNotAllowed,
+    HTTPNotFound,
+)
+from .web_fileresponse import FileResponse
+from .web_request import Request
+from .web_response import Response, StreamResponse
+from .web_routedef import AbstractRouteDef
+
+__all__ = (
+    "UrlDispatcher",
+    "UrlMappingMatchInfo",
+    "AbstractResource",
+    "Resource",
+    "PlainResource",
+    "DynamicResource",
+    "AbstractRoute",
+    "ResourceRoute",
+    "StaticResource",
+    "View",
+)
+
+
+if TYPE_CHECKING:
+    from .web_app import Application
+
+    BaseDict = Dict[str, str]
+else:
+    BaseDict = dict
+
+YARL_VERSION: Final[Tuple[int, ...]] = tuple(map(int, yarl_version.split(".")[:2]))
+
+HTTP_METHOD_RE: Final[Pattern[str]] = re.compile(
+    r"^[0-9A-Za-z!#\$%&'\*\+\-\.\^_`\|~]+$"
+)
+ROUTE_RE: Final[Pattern[str]] = re.compile(
+    r"(\{[_a-zA-Z][^{}]*(?:\{[^{}]*\}[^{}]*)*\})"
+)
+PATH_SEP: Final[str] = re.escape("/")
+
+
+_ExpectHandler = Callable[[Request], Awaitable[Optional[StreamResponse]]]
+_Resolve = Tuple[Optional["UrlMappingMatchInfo"], Set[str]]
+
+html_escape = functools.partial(html.escape, quote=True)
+
+
+class _InfoDict(TypedDict, total=False):
+    path: str
+
+    formatter: str
+    pattern: Pattern[str]
+
+    directory: Path
+    prefix: str
+    routes: Mapping[str, "AbstractRoute"]
+
+    app: "Application"
+
+    domain: str
+
+    rule: "AbstractRuleMatching"
+
+    http_exception: HTTPException
+
+
+class AbstractResource(Sized, Iterable["AbstractRoute"]):
+    def __init__(self, *, name: Optional[str] = None) -> None:
+        self._name = name
+
+    @property
+    def name(self) -> Optional[str]:
+        return self._name
+
+    @property
+    @abc.abstractmethod
+    def canonical(self) -> str:
+        """Exposes the resource's canonical path.
+
+        For example '/foo/bar/{name}'
+
+        """
+
+    @abc.abstractmethod  # pragma: no branch
+    def url_for(self, **kwargs: str) -> URL:
+        """Construct url for resource with additional params."""
+
+    @abc.abstractmethod  # pragma: no branch
+    async def resolve(self, request: Request) -> _Resolve:
+        """Resolve resource.
+
+        Return (UrlMappingMatchInfo, allowed_methods) pair.
+        """
+
+    @abc.abstractmethod
+    def add_prefix(self, prefix: str) -> None:
+        """Add a prefix to processed URLs.
+
+        Required for subapplications support.
+        """
+
+    @abc.abstractmethod
+    def get_info(self) -> _InfoDict:
+        """Return a dict with additional info useful for introspection"""
+
+    def freeze(self) -> None:
+        pass
+
+    @abc.abstractmethod
+    def raw_match(self, path: str) -> bool:
+        """Perform a raw match against path"""
+
+
+class AbstractRoute(abc.ABC):
+    def __init__(
+        self,
+        method: str,
+        handler: Union[Handler, Type[AbstractView]],
+        *,
+        expect_handler: Optional[_ExpectHandler] = None,
+        resource: Optional[AbstractResource] = None,
+    ) -> None:
+
+        if expect_handler is None:
+            expect_handler = _default_expect_handler
+
+        assert asyncio.iscoroutinefunction(
+            expect_handler
+        ), f"Coroutine is expected, got {expect_handler!r}"
+
+        method = method.upper()
+        if not HTTP_METHOD_RE.match(method):
+            raise ValueError(f"{method} is not allowed HTTP method")
+
+        assert callable(handler), handler
+        if asyncio.iscoroutinefunction(handler):
+            pass
+        elif inspect.isgeneratorfunction(handler):
+            warnings.warn(
+                "Bare generators are deprecated, " "use @coroutine wrapper",
+                DeprecationWarning,
+            )
+        elif isinstance(handler, type) and issubclass(handler, AbstractView):
+            pass
+        else:
+            warnings.warn(
+                "Bare functions are deprecated, " "use async ones", DeprecationWarning
+            )
+
+            @wraps(handler)
+            async def handler_wrapper(request: Request) -> StreamResponse:
+                result = old_handler(request)
+                if asyncio.iscoroutine(result):
+                    result = await result
+                assert isinstance(result, StreamResponse)
+                return result
+
+            old_handler = handler
+            handler = handler_wrapper
+
+        self._method = method
+        self._handler = handler
+        self._expect_handler = expect_handler
+        self._resource = resource
+
+    @property
+    def method(self) -> str:
+        return self._method
+
+    @property
+    def handler(self) -> Handler:
+        return self._handler
+
+    @property
+    @abc.abstractmethod
+    def name(self) -> Optional[str]:
+        """Optional route's name, always equals to resource's name."""
+
+    @property
+    def resource(self) -> Optional[AbstractResource]:
+        return self._resource
+
+    @abc.abstractmethod
+    def get_info(self) -> _InfoDict:
+        """Return a dict with additional info useful for introspection"""
+
+    @abc.abstractmethod  # pragma: no branch
+    def url_for(self, *args: str, **kwargs: str) -> URL:
+        """Construct url for route with additional params."""
+
+    async def handle_expect_header(self, request: Request) -> Optional[StreamResponse]:
+        return await self._expect_handler(request)
+
+
+class UrlMappingMatchInfo(BaseDict, AbstractMatchInfo):
+    def __init__(self, match_dict: Dict[str, str], route: AbstractRoute):
+        super().__init__(match_dict)
+        self._route = route
+        self._apps: List[Application] = []
+        self._current_app: Optional[Application] = None
+        self._frozen = False
+
+    @property
+    def handler(self) -> Handler:
+        return self._route.handler
+
+    @property
+    def route(self) -> AbstractRoute:
+        return self._route
+
+    @property
+    def expect_handler(self) -> _ExpectHandler:
+        return self._route.handle_expect_header
+
+    @property
+    def http_exception(self) -> Optional[HTTPException]:
+        return None
+
+    def get_info(self) -> _InfoDict:  # type: ignore[override]
+        return self._route.get_info()
+
+    @property
+    def apps(self) -> Tuple["Application", ...]:
+        return tuple(self._apps)
+
+    def add_app(self, app: "Application") -> None:
+        if self._frozen:
+            raise RuntimeError("Cannot change apps stack after .freeze() call")
+        if self._current_app is None:
+            self._current_app = app
+        self._apps.insert(0, app)
+
+    @property
+    def current_app(self) -> "Application":
+        app = self._current_app
+        assert app is not None
+        return app
+
+    @contextmanager
+    def set_current_app(self, app: "Application") -> Generator[None, None, None]:
+        if DEBUG:  # pragma: no cover
+            if app not in self._apps:
+                raise RuntimeError(
+                    "Expected one of the following apps {!r}, got {!r}".format(
+                        self._apps, app
+                    )
+                )
+        prev = self._current_app
+        self._current_app = app
+        try:
+            yield
+        finally:
+            self._current_app = prev
+
+    def freeze(self) -> None:
+        self._frozen = True
+
+    def __repr__(self) -> str:
+        return f"<MatchInfo {super().__repr__()}: {self._route}>"
+
+
+class MatchInfoError(UrlMappingMatchInfo):
+    def __init__(self, http_exception: HTTPException) -> None:
+        self._exception = http_exception
+        super().__init__({}, SystemRoute(self._exception))
+
+    @property
+    def http_exception(self) -> HTTPException:
+        return self._exception
+
+    def __repr__(self) -> str:
+        return "<MatchInfoError {}: {}>".format(
+            self._exception.status, self._exception.reason
+        )
+
+
+async def _default_expect_handler(request: Request) -> None:
+    """Default handler for Expect header.
+
+    Just send "100 Continue" to client.
+    raise HTTPExpectationFailed if value of header is not "100-continue"
+    """
+    expect = request.headers.get(hdrs.EXPECT, "")
+    if request.version == HttpVersion11:
+        if expect.lower() == "100-continue":
+            await request.writer.write(b"HTTP/1.1 100 Continue\r\n\r\n")
+        else:
+            raise HTTPExpectationFailed(text="Unknown Expect: %s" % expect)
+
+
+class Resource(AbstractResource):
+    def __init__(self, *, name: Optional[str] = None) -> None:
+        super().__init__(name=name)
+        self._routes: List[ResourceRoute] = []
+
+    def add_route(
+        self,
+        method: str,
+        handler: Union[Type[AbstractView], Handler],
+        *,
+        expect_handler: Optional[_ExpectHandler] = None,
+    ) -> "ResourceRoute":
+
+        for route_obj in self._routes:
+            if route_obj.method == method or route_obj.method == hdrs.METH_ANY:
+                raise RuntimeError(
+                    "Added route will never be executed, "
+                    "method {route.method} is already "
+                    "registered".format(route=route_obj)
+                )
+
+        route_obj = ResourceRoute(method, handler, self, expect_handler=expect_handler)
+        self.register_route(route_obj)
+        return route_obj
+
+    def register_route(self, route: "ResourceRoute") -> None:
+        assert isinstance(
+            route, ResourceRoute
+        ), f"Instance of Route class is required, got {route!r}"
+        self._routes.append(route)
+
+    async def resolve(self, request: Request) -> _Resolve:
+        allowed_methods: Set[str] = set()
+
+        match_dict = self._match(request.rel_url.raw_path)
+        if match_dict is None:
+            return None, allowed_methods
+
+        for route_obj in self._routes:
+            route_method = route_obj.method
+            allowed_methods.add(route_method)
+
+            if route_method == request.method or route_method == hdrs.METH_ANY:
+                return (UrlMappingMatchInfo(match_dict, route_obj), allowed_methods)
+        else:
+            return None, allowed_methods
+
+    @abc.abstractmethod
+    def _match(self, path: str) -> Optional[Dict[str, str]]:
+        pass  # pragma: no cover
+
+    def __len__(self) -> int:
+        return len(self._routes)
+
+    def __iter__(self) -> Iterator["ResourceRoute"]:
+        return iter(self._routes)
+
+    # TODO: implement all abstract methods
+
+
+class PlainResource(Resource):
+    def __init__(self, path: str, *, name: Optional[str] = None) -> None:
+        super().__init__(name=name)
+        assert not path or path.startswith("/")
+        self._path = path
+
+    @property
+    def canonical(self) -> str:
+        return self._path
+
+    def freeze(self) -> None:
+        if not self._path:
+            self._path = "/"
+
+    def add_prefix(self, prefix: str) -> None:
+        assert prefix.startswith("/")
+        assert not prefix.endswith("/")
+        assert len(prefix) > 1
+        self._path = prefix + self._path
+
+    def _match(self, path: str) -> Optional[Dict[str, str]]:
+        # string comparison is about 10 times faster than regexp matching
+        if self._path == path:
+            return {}
+        else:
+            return None
+
+    def raw_match(self, path: str) -> bool:
+        return self._path == path
+
+    def get_info(self) -> _InfoDict:
+        return {"path": self._path}
+
+    def url_for(self) -> URL:  # type: ignore[override]
+        return URL.build(path=self._path, encoded=True)
+
+    def __repr__(self) -> str:
+        name = "'" + self.name + "' " if self.name is not None else ""
+        return f"<PlainResource {name} {self._path}>"
+
+
+class DynamicResource(Resource):
+
+    DYN = re.compile(r"\{(?P<var>[_a-zA-Z][_a-zA-Z0-9]*)\}")
+    DYN_WITH_RE = re.compile(r"\{(?P<var>[_a-zA-Z][_a-zA-Z0-9]*):(?P<re>.+)\}")
+    GOOD = r"[^{}/]+"
+
+    def __init__(self, path: str, *, name: Optional[str] = None) -> None:
+        super().__init__(name=name)
+        pattern = ""
+        formatter = ""
+        for part in ROUTE_RE.split(path):
+            match = self.DYN.fullmatch(part)
+            if match:
+                pattern += "(?P<{}>{})".format(match.group("var"), self.GOOD)
+                formatter += "{" + match.group("var") + "}"
+                continue
+
+            match = self.DYN_WITH_RE.fullmatch(part)
+            if match:
+                pattern += "(?P<{var}>{re})".format(**match.groupdict())
+                formatter += "{" + match.group("var") + "}"
+                continue
+
+            if "{" in part or "}" in part:
+                raise ValueError(f"Invalid path '{path}'['{part}']")
+
+            part = _requote_path(part)
+            formatter += part
+            pattern += re.escape(part)
+
+        try:
+            compiled = re.compile(pattern)
+        except re.error as exc:
+            raise ValueError(f"Bad pattern '{pattern}': {exc}") from None
+        assert compiled.pattern.startswith(PATH_SEP)
+        assert formatter.startswith("/")
+        self._pattern = compiled
+        self._formatter = formatter
+
+    @property
+    def canonical(self) -> str:
+        return self._formatter
+
+    def add_prefix(self, prefix: str) -> None:
+        assert prefix.startswith("/")
+        assert not prefix.endswith("/")
+        assert len(prefix) > 1
+        self._pattern = re.compile(re.escape(prefix) + self._pattern.pattern)
+        self._formatter = prefix + self._formatter
+
+    def _match(self, path: str) -> Optional[Dict[str, str]]:
+        match = self._pattern.fullmatch(path)
+        if match is None:
+            return None
+        else:
+            return {
+                key: _unquote_path(value) for key, value in match.groupdict().items()
+            }
+
+    def raw_match(self, path: str) -> bool:
+        return self._formatter == path
+
+    def get_info(self) -> _InfoDict:
+        return {"formatter": self._formatter, "pattern": self._pattern}
+
+    def url_for(self, **parts: str) -> URL:
+        url = self._formatter.format_map({k: _quote_path(v) for k, v in parts.items()})
+        return URL.build(path=url, encoded=True)
+
+    def __repr__(self) -> str:
+        name = "'" + self.name + "' " if self.name is not None else ""
+        return "<DynamicResource {name} {formatter}>".format(
+            name=name, formatter=self._formatter
+        )
+
+
+class PrefixResource(AbstractResource):
+    def __init__(self, prefix: str, *, name: Optional[str] = None) -> None:
+        assert not prefix or prefix.startswith("/"), prefix
+        assert prefix in ("", "/") or not prefix.endswith("/"), prefix
+        super().__init__(name=name)
+        self._prefix = _requote_path(prefix)
+        self._prefix2 = self._prefix + "/"
+
+    @property
+    def canonical(self) -> str:
+        return self._prefix
+
+    def add_prefix(self, prefix: str) -> None:
+        assert prefix.startswith("/")
+        assert not prefix.endswith("/")
+        assert len(prefix) > 1
+        self._prefix = prefix + self._prefix
+        self._prefix2 = self._prefix + "/"
+
+    def raw_match(self, prefix: str) -> bool:
+        return False
+
+    # TODO: impl missing abstract methods
+
+
+class StaticResource(PrefixResource):
+    VERSION_KEY = "v"
+
+    def __init__(
+        self,
+        prefix: str,
+        directory: PathLike,
+        *,
+        name: Optional[str] = None,
+        expect_handler: Optional[_ExpectHandler] = None,
+        chunk_size: int = 256 * 1024,
+        show_index: bool = False,
+        follow_symlinks: bool = False,
+        append_version: bool = False,
+    ) -> None:
+        super().__init__(prefix, name=name)
+        try:
+            directory = Path(directory)
+            if str(directory).startswith("~"):
+                directory = Path(os.path.expanduser(str(directory)))
+            directory = directory.resolve()
+            if not directory.is_dir():
+                raise ValueError("Not a directory")
+        except (FileNotFoundError, ValueError) as error:
+            raise ValueError(f"No directory exists at '{directory}'") from error
+        self._directory = directory
+        self._show_index = show_index
+        self._chunk_size = chunk_size
+        self._follow_symlinks = follow_symlinks
+        self._expect_handler = expect_handler
+        self._append_version = append_version
+
+        self._routes = {
+            "GET": ResourceRoute(
+                "GET", self._handle, self, expect_handler=expect_handler
+            ),
+            "HEAD": ResourceRoute(
+                "HEAD", self._handle, self, expect_handler=expect_handler
+            ),
+        }
+
+    def url_for(  # type: ignore[override]
+        self,
+        *,
+        filename: PathLike,
+        append_version: Optional[bool] = None,
+    ) -> URL:
+        if append_version is None:
+            append_version = self._append_version
+        filename = str(filename).lstrip("/")
+
+        url = URL.build(path=self._prefix, encoded=True)
+        # filename is not encoded
+        if YARL_VERSION < (1, 6):
+            url = url / filename.replace("%", "%25")
+        else:
+            url = url / filename
+
+        if append_version:
+            unresolved_path = self._directory.joinpath(filename)
+            try:
+                if self._follow_symlinks:
+                    normalized_path = Path(os.path.normpath(unresolved_path))
+                    normalized_path.relative_to(self._directory)
+                    filepath = normalized_path.resolve()
+                else:
+                    filepath = unresolved_path.resolve()
+                    filepath.relative_to(self._directory)
+            except (ValueError, FileNotFoundError):
+                # ValueError for case when path point to symlink
+                # with follow_symlinks is False
+                return url  # relatively safe
+            if filepath.is_file():
+                # TODO cache file content
+                # with file watcher for cache invalidation
+                with filepath.open("rb") as f:
+                    file_bytes = f.read()
+                h = self._get_file_hash(file_bytes)
+                url = url.with_query({self.VERSION_KEY: h})
+                return url
+        return url
+
+    @staticmethod
+    def _get_file_hash(byte_array: bytes) -> str:
+        m = hashlib.sha256()  # todo sha256 can be configurable param
+        m.update(byte_array)
+        b64 = base64.urlsafe_b64encode(m.digest())
+        return b64.decode("ascii")
+
+    def get_info(self) -> _InfoDict:
+        return {
+            "directory": self._directory,
+            "prefix": self._prefix,
+            "routes": self._routes,
+        }
+
+    def set_options_route(self, handler: Handler) -> None:
+        if "OPTIONS" in self._routes:
+            raise RuntimeError("OPTIONS route was set already")
+        self._routes["OPTIONS"] = ResourceRoute(
+            "OPTIONS", handler, self, expect_handler=self._expect_handler
+        )
+
+    async def resolve(self, request: Request) -> _Resolve:
+        path = request.rel_url.raw_path
+        method = request.method
+        allowed_methods = set(self._routes)
+        if not path.startswith(self._prefix2) and path != self._prefix:
+            return None, set()
+
+        if method not in allowed_methods:
+            return None, allowed_methods
+
+        match_dict = {"filename": _unquote_path(path[len(self._prefix) + 1 :])}
+        return (UrlMappingMatchInfo(match_dict, self._routes[method]), allowed_methods)
+
+    def __len__(self) -> int:
+        return len(self._routes)
+
+    def __iter__(self) -> Iterator[AbstractRoute]:
+        return iter(self._routes.values())
+
+    async def _handle(self, request: Request) -> StreamResponse:
+        rel_url = request.match_info["filename"]
+        try:
+            filename = Path(rel_url)
+            if filename.anchor:
+                # rel_url is an absolute name like
+                # /static/\\machine_name\c$ or /static/D:\path
+                # where the static dir is totally different
+                raise HTTPForbidden()
+            unresolved_path = self._directory.joinpath(filename)
+            if self._follow_symlinks:
+                normalized_path = Path(os.path.normpath(unresolved_path))
+                normalized_path.relative_to(self._directory)
+                filepath = normalized_path.resolve()
+            else:
+                filepath = unresolved_path.resolve()
+                filepath.relative_to(self._directory)
+        except (ValueError, FileNotFoundError) as error:
+            # relatively safe
+            raise HTTPNotFound() from error
+        except HTTPForbidden:
+            raise
+        except Exception as error:
+            # perm error or other kind!
+            request.app.logger.exception(error)
+            raise HTTPNotFound() from error
+
+        # on opening a dir, load its contents if allowed
+        if filepath.is_dir():
+            if self._show_index:
+                try:
+                    return Response(
+                        text=self._directory_as_html(filepath), content_type="text/html"
+                    )
+                except PermissionError:
+                    raise HTTPForbidden()
+            else:
+                raise HTTPForbidden()
+        elif filepath.is_file():
+            return FileResponse(filepath, chunk_size=self._chunk_size)
+        else:
+            raise HTTPNotFound
+
+    def _directory_as_html(self, filepath: Path) -> str:
+        # returns directory's index as html
+
+        # sanity check
+        assert filepath.is_dir()
+
+        relative_path_to_dir = filepath.relative_to(self._directory).as_posix()
+        index_of = f"Index of /{html_escape(relative_path_to_dir)}"
+        h1 = f"<h1>{index_of}</h1>"
+
+        index_list = []
+        dir_index = filepath.iterdir()
+        for _file in sorted(dir_index):
+            # show file url as relative to static path
+            rel_path = _file.relative_to(self._directory).as_posix()
+            quoted_file_url = _quote_path(f"{self._prefix}/{rel_path}")
+
+            # if file is a directory, add '/' to the end of the name
+            if _file.is_dir():
+                file_name = f"{_file.name}/"
+            else:
+                file_name = _file.name
+
+            index_list.append(
+                f'<li><a href="{quoted_file_url}">{html_escape(file_name)}</a></li>'
+            )
+        ul = "<ul>\n{}\n</ul>".format("\n".join(index_list))
+        body = f"<body>\n{h1}\n{ul}\n</body>"
+
+        head_str = f"<head>\n<title>{index_of}</title>\n</head>"
+        html = f"<html>\n{head_str}\n{body}\n</html>"
+
+        return html
+
+    def __repr__(self) -> str:
+        name = "'" + self.name + "'" if self.name is not None else ""
+        return "<StaticResource {name} {path} -> {directory!r}>".format(
+            name=name, path=self._prefix, directory=self._directory
+        )
+
+
+class PrefixedSubAppResource(PrefixResource):
+    def __init__(self, prefix: str, app: "Application") -> None:
+        super().__init__(prefix)
+        self._app = app
+        for resource in app.router.resources():
+            resource.add_prefix(prefix)
+
+    def add_prefix(self, prefix: str) -> None:
+        super().add_prefix(prefix)
+        for resource in self._app.router.resources():
+            resource.add_prefix(prefix)
+
+    def url_for(self, *args: str, **kwargs: str) -> URL:
+        raise RuntimeError(".url_for() is not supported " "by sub-application root")
+
+    def get_info(self) -> _InfoDict:
+        return {"app": self._app, "prefix": self._prefix}
+
+    async def resolve(self, request: Request) -> _Resolve:
+        if (
+            not request.url.raw_path.startswith(self._prefix2)
+            and request.url.raw_path != self._prefix
+        ):
+            return None, set()
+        match_info = await self._app.router.resolve(request)
+        match_info.add_app(self._app)
+        if isinstance(match_info.http_exception, HTTPMethodNotAllowed):
+            methods = match_info.http_exception.allowed_methods
+        else:
+            methods = set()
+        return match_info, methods
+
+    def __len__(self) -> int:
+        return len(self._app.router.routes())
+
+    def __iter__(self) -> Iterator[AbstractRoute]:
+        return iter(self._app.router.routes())
+
+    def __repr__(self) -> str:
+        return "<PrefixedSubAppResource {prefix} -> {app!r}>".format(
+            prefix=self._prefix, app=self._app
+        )
+
+
+class AbstractRuleMatching(abc.ABC):
+    @abc.abstractmethod  # pragma: no branch
+    async def match(self, request: Request) -> bool:
+        """Return bool if the request satisfies the criteria"""
+
+    @abc.abstractmethod  # pragma: no branch
+    def get_info(self) -> _InfoDict:
+        """Return a dict with additional info useful for introspection"""
+
+    @property
+    @abc.abstractmethod  # pragma: no branch
+    def canonical(self) -> str:
+        """Return a str"""
+
+
+class Domain(AbstractRuleMatching):
+    re_part = re.compile(r"(?!-)[a-z\d-]{1,63}(?<!-)")
+
+    def __init__(self, domain: str) -> None:
+        super().__init__()
+        self._domain = self.validation(domain)
+
+    @property
+    def canonical(self) -> str:
+        return self._domain
+
+    def validation(self, domain: str) -> str:
+        if not isinstance(domain, str):
+            raise TypeError("Domain must be str")
+        domain = domain.rstrip(".").lower()
+        if not domain:
+            raise ValueError("Domain cannot be empty")
+        elif "://" in domain:
+            raise ValueError("Scheme not supported")
+        url = URL("http://" + domain)
+        assert url.raw_host is not None
+        if not all(self.re_part.fullmatch(x) for x in url.raw_host.split(".")):
+            raise ValueError("Domain not valid")
+        if url.port == 80:
+            return url.raw_host
+        return f"{url.raw_host}:{url.port}"
+
+    async def match(self, request: Request) -> bool:
+        host = request.headers.get(hdrs.HOST)
+        if not host:
+            return False
+        return self.match_domain(host)
+
+    def match_domain(self, host: str) -> bool:
+        return host.lower() == self._domain
+
+    def get_info(self) -> _InfoDict:
+        return {"domain": self._domain}
+
+
+class MaskDomain(Domain):
+    re_part = re.compile(r"(?!-)[a-z\d\*-]{1,63}(?<!-)")
+
+    def __init__(self, domain: str) -> None:
+        super().__init__(domain)
+        mask = self._domain.replace(".", r"\.").replace("*", ".*")
+        self._mask = re.compile(mask)
+
+    @property
+    def canonical(self) -> str:
+        return self._mask.pattern
+
+    def match_domain(self, host: str) -> bool:
+        return self._mask.fullmatch(host) is not None
+
+
+class MatchedSubAppResource(PrefixedSubAppResource):
+    def __init__(self, rule: AbstractRuleMatching, app: "Application") -> None:
+        AbstractResource.__init__(self)
+        self._prefix = ""
+        self._app = app
+        self._rule = rule
+
+    @property
+    def canonical(self) -> str:
+        return self._rule.canonical
+
+    def get_info(self) -> _InfoDict:
+        return {"app": self._app, "rule": self._rule}
+
+    async def resolve(self, request: Request) -> _Resolve:
+        if not await self._rule.match(request):
+            return None, set()
+        match_info = await self._app.router.resolve(request)
+        match_info.add_app(self._app)
+        if isinstance(match_info.http_exception, HTTPMethodNotAllowed):
+            methods = match_info.http_exception.allowed_methods
+        else:
+            methods = set()
+        return match_info, methods
+
+    def __repr__(self) -> str:
+        return "<MatchedSubAppResource -> {app!r}>" "".format(app=self._app)
+
+
+class ResourceRoute(AbstractRoute):
+    """A route with resource"""
+
+    def __init__(
+        self,
+        method: str,
+        handler: Union[Handler, Type[AbstractView]],
+        resource: AbstractResource,
+        *,
+        expect_handler: Optional[_ExpectHandler] = None,
+    ) -> None:
+        super().__init__(
+            method, handler, expect_handler=expect_handler, resource=resource
+        )
+
+    def __repr__(self) -> str:
+        return "<ResourceRoute [{method}] {resource} -> {handler!r}".format(
+            method=self.method, resource=self._resource, handler=self.handler
+        )
+
+    @property
+    def name(self) -> Optional[str]:
+        if self._resource is None:
+            return None
+        return self._resource.name
+
+    def url_for(self, *args: str, **kwargs: str) -> URL:
+        """Construct url for route with additional params."""
+        assert self._resource is not None
+        return self._resource.url_for(*args, **kwargs)
+
+    def get_info(self) -> _InfoDict:
+        assert self._resource is not None
+        return self._resource.get_info()
+
+
+class SystemRoute(AbstractRoute):
+    def __init__(self, http_exception: HTTPException) -> None:
+        super().__init__(hdrs.METH_ANY, self._handle)
+        self._http_exception = http_exception
+
+    def url_for(self, *args: str, **kwargs: str) -> URL:
+        raise RuntimeError(".url_for() is not allowed for SystemRoute")
+
+    @property
+    def name(self) -> Optional[str]:
+        return None
+
+    def get_info(self) -> _InfoDict:
+        return {"http_exception": self._http_exception}
+
+    async def _handle(self, request: Request) -> StreamResponse:
+        raise self._http_exception
+
+    @property
+    def status(self) -> int:
+        return self._http_exception.status
+
+    @property
+    def reason(self) -> str:
+        return self._http_exception.reason
+
+    def __repr__(self) -> str:
+        return "<SystemRoute {self.status}: {self.reason}>".format(self=self)
+
+
+class View(AbstractView):
+    async def _iter(self) -> StreamResponse:
+        if self.request.method not in hdrs.METH_ALL:
+            self._raise_allowed_methods()
+        method: Optional[Callable[[], Awaitable[StreamResponse]]]
+        method = getattr(self, self.request.method.lower(), None)
+        if method is None:
+            self._raise_allowed_methods()
+        ret = await method()
+        assert isinstance(ret, StreamResponse)
+        return ret
+
+    def __await__(self) -> Generator[Any, None, StreamResponse]:
+        return self._iter().__await__()
+
+    def _raise_allowed_methods(self) -> NoReturn:
+        allowed_methods = {m for m in hdrs.METH_ALL if hasattr(self, m.lower())}
+        raise HTTPMethodNotAllowed(self.request.method, allowed_methods)
+
+
+class ResourcesView(Sized, Iterable[AbstractResource], Container[AbstractResource]):
+    def __init__(self, resources: List[AbstractResource]) -> None:
+        self._resources = resources
+
+    def __len__(self) -> int:
+        return len(self._resources)
+
+    def __iter__(self) -> Iterator[AbstractResource]:
+        yield from self._resources
+
+    def __contains__(self, resource: object) -> bool:
+        return resource in self._resources
+
+
+class RoutesView(Sized, Iterable[AbstractRoute], Container[AbstractRoute]):
+    def __init__(self, resources: List[AbstractResource]):
+        self._routes: List[AbstractRoute] = []
+        for resource in resources:
+            for route in resource:
+                self._routes.append(route)
+
+    def __len__(self) -> int:
+        return len(self._routes)
+
+    def __iter__(self) -> Iterator[AbstractRoute]:
+        yield from self._routes
+
+    def __contains__(self, route: object) -> bool:
+        return route in self._routes
+
+
+class UrlDispatcher(AbstractRouter, Mapping[str, AbstractResource]):
+
+    NAME_SPLIT_RE = re.compile(r"[.:-]")
+
+    def __init__(self) -> None:
+        super().__init__()
+        self._resources: List[AbstractResource] = []
+        self._named_resources: Dict[str, AbstractResource] = {}
+
+    async def resolve(self, request: Request) -> UrlMappingMatchInfo:
+        method = request.method
+        allowed_methods: Set[str] = set()
+
+        for resource in self._resources:
+            match_dict, allowed = await resource.resolve(request)
+            if match_dict is not None:
+                return match_dict
+            else:
+                allowed_methods |= allowed
+
+        if allowed_methods:
+            return MatchInfoError(HTTPMethodNotAllowed(method, allowed_methods))
+        else:
+            return MatchInfoError(HTTPNotFound())
+
+    def __iter__(self) -> Iterator[str]:
+        return iter(self._named_resources)
+
+    def __len__(self) -> int:
+        return len(self._named_resources)
+
+    def __contains__(self, resource: object) -> bool:
+        return resource in self._named_resources
+
+    def __getitem__(self, name: str) -> AbstractResource:
+        return self._named_resources[name]
+
+    def resources(self) -> ResourcesView:
+        return ResourcesView(self._resources)
+
+    def routes(self) -> RoutesView:
+        return RoutesView(self._resources)
+
+    def named_resources(self) -> Mapping[str, AbstractResource]:
+        return MappingProxyType(self._named_resources)
+
+    def register_resource(self, resource: AbstractResource) -> None:
+        assert isinstance(
+            resource, AbstractResource
+        ), f"Instance of AbstractResource class is required, got {resource!r}"
+        if self.frozen:
+            raise RuntimeError("Cannot register a resource into frozen router.")
+
+        name = resource.name
+
+        if name is not None:
+            parts = self.NAME_SPLIT_RE.split(name)
+            for part in parts:
+                if keyword.iskeyword(part):
+                    raise ValueError(
+                        f"Incorrect route name {name!r}, "
+                        "python keywords cannot be used "
+                        "for route name"
+                    )
+                if not part.isidentifier():
+                    raise ValueError(
+                        "Incorrect route name {!r}, "
+                        "the name should be a sequence of "
+                        "python identifiers separated "
+                        "by dash, dot or column".format(name)
+                    )
+            if name in self._named_resources:
+                raise ValueError(
+                    "Duplicate {!r}, "
+                    "already handled by {!r}".format(name, self._named_resources[name])
+                )
+            self._named_resources[name] = resource
+        self._resources.append(resource)
+
+    def add_resource(self, path: str, *, name: Optional[str] = None) -> Resource:
+        if path and not path.startswith("/"):
+            raise ValueError("path should be started with / or be empty")
+        # Reuse last added resource if path and name are the same
+        if self._resources:
+            resource = self._resources[-1]
+            if resource.name == name and resource.raw_match(path):
+                return cast(Resource, resource)
+        if not ("{" in path or "}" in path or ROUTE_RE.search(path)):
+            resource = PlainResource(_requote_path(path), name=name)
+            self.register_resource(resource)
+            return resource
+        resource = DynamicResource(path, name=name)
+        self.register_resource(resource)
+        return resource
+
+    def add_route(
+        self,
+        method: str,
+        path: str,
+        handler: Union[Handler, Type[AbstractView]],
+        *,
+        name: Optional[str] = None,
+        expect_handler: Optional[_ExpectHandler] = None,
+    ) -> AbstractRoute:
+        resource = self.add_resource(path, name=name)
+        return resource.add_route(method, handler, expect_handler=expect_handler)
+
+    def add_static(
+        self,
+        prefix: str,
+        path: PathLike,
+        *,
+        name: Optional[str] = None,
+        expect_handler: Optional[_ExpectHandler] = None,
+        chunk_size: int = 256 * 1024,
+        show_index: bool = False,
+        follow_symlinks: bool = False,
+        append_version: bool = False,
+    ) -> AbstractResource:
+        """Add static files view.
+
+        prefix - url prefix
+        path - folder with files
+
+        """
+        assert prefix.startswith("/")
+        if prefix.endswith("/"):
+            prefix = prefix[:-1]
+        resource = StaticResource(
+            prefix,
+            path,
+            name=name,
+            expect_handler=expect_handler,
+            chunk_size=chunk_size,
+            show_index=show_index,
+            follow_symlinks=follow_symlinks,
+            append_version=append_version,
+        )
+        self.register_resource(resource)
+        return resource
+
+    def add_head(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute:
+        """Shortcut for add_route with method HEAD."""
+        return self.add_route(hdrs.METH_HEAD, path, handler, **kwargs)
+
+    def add_options(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute:
+        """Shortcut for add_route with method OPTIONS."""
+        return self.add_route(hdrs.METH_OPTIONS, path, handler, **kwargs)
+
+    def add_get(
+        self,
+        path: str,
+        handler: Handler,
+        *,
+        name: Optional[str] = None,
+        allow_head: bool = True,
+        **kwargs: Any,
+    ) -> AbstractRoute:
+        """Shortcut for add_route with method GET.
+
+        If allow_head is true, another
+        route is added allowing head requests to the same endpoint.
+        """
+        resource = self.add_resource(path, name=name)
+        if allow_head:
+            resource.add_route(hdrs.METH_HEAD, handler, **kwargs)
+        return resource.add_route(hdrs.METH_GET, handler, **kwargs)
+
+    def add_post(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute:
+        """Shortcut for add_route with method POST."""
+        return self.add_route(hdrs.METH_POST, path, handler, **kwargs)
+
+    def add_put(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute:
+        """Shortcut for add_route with method PUT."""
+        return self.add_route(hdrs.METH_PUT, path, handler, **kwargs)
+
+    def add_patch(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute:
+        """Shortcut for add_route with method PATCH."""
+        return self.add_route(hdrs.METH_PATCH, path, handler, **kwargs)
+
+    def add_delete(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute:
+        """Shortcut for add_route with method DELETE."""
+        return self.add_route(hdrs.METH_DELETE, path, handler, **kwargs)
+
+    def add_view(
+        self, path: str, handler: Type[AbstractView], **kwargs: Any
+    ) -> AbstractRoute:
+        """Shortcut for add_route with ANY methods for a class-based view."""
+        return self.add_route(hdrs.METH_ANY, path, handler, **kwargs)
+
+    def freeze(self) -> None:
+        super().freeze()
+        for resource in self._resources:
+            resource.freeze()
+
+    def add_routes(self, routes: Iterable[AbstractRouteDef]) -> List[AbstractRoute]:
+        """Append routes to route table.
+
+        Parameter should be a sequence of RouteDef objects.
+
+        Returns a list of registered AbstractRoute instances.
+        """
+        registered_routes = []
+        for route_def in routes:
+            registered_routes.extend(route_def.register(self))
+        return registered_routes
+
+
+def _quote_path(value: str) -> str:
+    if YARL_VERSION < (1, 6):
+        value = value.replace("%", "%25")
+    return URL.build(path=value, encoded=False).raw_path
+
+
+def _unquote_path(value: str) -> str:
+    return URL.build(path=value, encoded=True).path
+
+
+def _requote_path(value: str) -> str:
+    # Quote non-ascii characters and other characters which must be quoted,
+    # but preserve existing %-sequences.
+    result = _quote_path(value)
+    if "%" in value:
+        result = result.replace("%25", "%")
+    return result
diff --git a/llm/Lib/site-packages/aiohttp/web_ws.py b/llm/Lib/site-packages/aiohttp/web_ws.py
new file mode 100644
index 0000000000000000000000000000000000000000..48bcb35742a23bb7d38227835206672480cf9537
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/web_ws.py
@@ -0,0 +1,539 @@
+import asyncio
+import base64
+import binascii
+import hashlib
+import json
+import sys
+from typing import Any, Final, Iterable, Optional, Tuple, cast
+
+import attr
+from multidict import CIMultiDict
+
+from . import hdrs
+from .abc import AbstractStreamWriter
+from .helpers import call_later, set_exception, set_result
+from .http import (
+    WS_CLOSED_MESSAGE,
+    WS_CLOSING_MESSAGE,
+    WS_KEY,
+    WebSocketError,
+    WebSocketReader,
+    WebSocketWriter,
+    WSCloseCode,
+    WSMessage,
+    WSMsgType as WSMsgType,
+    ws_ext_gen,
+    ws_ext_parse,
+)
+from .log import ws_logger
+from .streams import EofStream, FlowControlDataQueue
+from .typedefs import JSONDecoder, JSONEncoder
+from .web_exceptions import HTTPBadRequest, HTTPException
+from .web_request import BaseRequest
+from .web_response import StreamResponse
+
+if sys.version_info >= (3, 11):
+    import asyncio as async_timeout
+else:
+    import async_timeout
+
+__all__ = (
+    "WebSocketResponse",
+    "WebSocketReady",
+    "WSMsgType",
+)
+
+THRESHOLD_CONNLOST_ACCESS: Final[int] = 5
+
+
+@attr.s(auto_attribs=True, frozen=True, slots=True)
+class WebSocketReady:
+    ok: bool
+    protocol: Optional[str]
+
+    def __bool__(self) -> bool:
+        return self.ok
+
+
+class WebSocketResponse(StreamResponse):
+
+    _length_check = False
+
+    def __init__(
+        self,
+        *,
+        timeout: float = 10.0,
+        receive_timeout: Optional[float] = None,
+        autoclose: bool = True,
+        autoping: bool = True,
+        heartbeat: Optional[float] = None,
+        protocols: Iterable[str] = (),
+        compress: bool = True,
+        max_msg_size: int = 4 * 1024 * 1024,
+    ) -> None:
+        super().__init__(status=101)
+        self._protocols = protocols
+        self._ws_protocol: Optional[str] = None
+        self._writer: Optional[WebSocketWriter] = None
+        self._reader: Optional[FlowControlDataQueue[WSMessage]] = None
+        self._closed = False
+        self._closing = False
+        self._conn_lost = 0
+        self._close_code: Optional[int] = None
+        self._loop: Optional[asyncio.AbstractEventLoop] = None
+        self._waiting: Optional[asyncio.Future[bool]] = None
+        self._exception: Optional[BaseException] = None
+        self._timeout = timeout
+        self._receive_timeout = receive_timeout
+        self._autoclose = autoclose
+        self._autoping = autoping
+        self._heartbeat = heartbeat
+        self._heartbeat_cb: Optional[asyncio.TimerHandle] = None
+        if heartbeat is not None:
+            self._pong_heartbeat = heartbeat / 2.0
+        self._pong_response_cb: Optional[asyncio.TimerHandle] = None
+        self._compress = compress
+        self._max_msg_size = max_msg_size
+
+    def _cancel_heartbeat(self) -> None:
+        if self._pong_response_cb is not None:
+            self._pong_response_cb.cancel()
+            self._pong_response_cb = None
+
+        if self._heartbeat_cb is not None:
+            self._heartbeat_cb.cancel()
+            self._heartbeat_cb = None
+
+    def _reset_heartbeat(self) -> None:
+        self._cancel_heartbeat()
+
+        if self._heartbeat is not None:
+            assert self._loop is not None
+            self._heartbeat_cb = call_later(
+                self._send_heartbeat,
+                self._heartbeat,
+                self._loop,
+                timeout_ceil_threshold=self._req._protocol._timeout_ceil_threshold
+                if self._req is not None
+                else 5,
+            )
+
+    def _send_heartbeat(self) -> None:
+        if self._heartbeat is not None and not self._closed:
+            assert self._loop is not None
+            # fire-and-forget a task is not perfect but maybe ok for
+            # sending ping. Otherwise we need a long-living heartbeat
+            # task in the class.
+            self._loop.create_task(self._writer.ping())  # type: ignore[union-attr]
+
+            if self._pong_response_cb is not None:
+                self._pong_response_cb.cancel()
+            self._pong_response_cb = call_later(
+                self._pong_not_received,
+                self._pong_heartbeat,
+                self._loop,
+                timeout_ceil_threshold=self._req._protocol._timeout_ceil_threshold
+                if self._req is not None
+                else 5,
+            )
+
+    def _pong_not_received(self) -> None:
+        if self._req is not None and self._req.transport is not None:
+            self._closed = True
+            self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE)
+            self._exception = asyncio.TimeoutError()
+
+    async def prepare(self, request: BaseRequest) -> AbstractStreamWriter:
+        # make pre-check to don't hide it by do_handshake() exceptions
+        if self._payload_writer is not None:
+            return self._payload_writer
+
+        protocol, writer = self._pre_start(request)
+        payload_writer = await super().prepare(request)
+        assert payload_writer is not None
+        self._post_start(request, protocol, writer)
+        await payload_writer.drain()
+        return payload_writer
+
+    def _handshake(
+        self, request: BaseRequest
+    ) -> Tuple["CIMultiDict[str]", str, bool, bool]:
+        headers = request.headers
+        if "websocket" != headers.get(hdrs.UPGRADE, "").lower().strip():
+            raise HTTPBadRequest(
+                text=(
+                    "No WebSocket UPGRADE hdr: {}\n Can "
+                    '"Upgrade" only to "WebSocket".'
+                ).format(headers.get(hdrs.UPGRADE))
+            )
+
+        if "upgrade" not in headers.get(hdrs.CONNECTION, "").lower():
+            raise HTTPBadRequest(
+                text="No CONNECTION upgrade hdr: {}".format(
+                    headers.get(hdrs.CONNECTION)
+                )
+            )
+
+        # find common sub-protocol between client and server
+        protocol = None
+        if hdrs.SEC_WEBSOCKET_PROTOCOL in headers:
+            req_protocols = [
+                str(proto.strip())
+                for proto in headers[hdrs.SEC_WEBSOCKET_PROTOCOL].split(",")
+            ]
+
+            for proto in req_protocols:
+                if proto in self._protocols:
+                    protocol = proto
+                    break
+            else:
+                # No overlap found: Return no protocol as per spec
+                ws_logger.warning(
+                    "Client protocols %r don’t overlap server-known ones %r",
+                    req_protocols,
+                    self._protocols,
+                )
+
+        # check supported version
+        version = headers.get(hdrs.SEC_WEBSOCKET_VERSION, "")
+        if version not in ("13", "8", "7"):
+            raise HTTPBadRequest(text=f"Unsupported version: {version}")
+
+        # check client handshake for validity
+        key = headers.get(hdrs.SEC_WEBSOCKET_KEY)
+        try:
+            if not key or len(base64.b64decode(key)) != 16:
+                raise HTTPBadRequest(text=f"Handshake error: {key!r}")
+        except binascii.Error:
+            raise HTTPBadRequest(text=f"Handshake error: {key!r}") from None
+
+        accept_val = base64.b64encode(
+            hashlib.sha1(key.encode() + WS_KEY).digest()
+        ).decode()
+        response_headers = CIMultiDict(
+            {
+                hdrs.UPGRADE: "websocket",
+                hdrs.CONNECTION: "upgrade",
+                hdrs.SEC_WEBSOCKET_ACCEPT: accept_val,
+            }
+        )
+
+        notakeover = False
+        compress = 0
+        if self._compress:
+            extensions = headers.get(hdrs.SEC_WEBSOCKET_EXTENSIONS)
+            # Server side always get return with no exception.
+            # If something happened, just drop compress extension
+            compress, notakeover = ws_ext_parse(extensions, isserver=True)
+            if compress:
+                enabledext = ws_ext_gen(
+                    compress=compress, isserver=True, server_notakeover=notakeover
+                )
+                response_headers[hdrs.SEC_WEBSOCKET_EXTENSIONS] = enabledext
+
+        if protocol:
+            response_headers[hdrs.SEC_WEBSOCKET_PROTOCOL] = protocol
+        return (
+            response_headers,
+            protocol,
+            compress,
+            notakeover,
+        )  # type: ignore[return-value]
+
+    def _pre_start(self, request: BaseRequest) -> Tuple[str, WebSocketWriter]:
+        self._loop = request._loop
+
+        headers, protocol, compress, notakeover = self._handshake(request)
+
+        self.set_status(101)
+        self.headers.update(headers)
+        self.force_close()
+        self._compress = compress
+        transport = request._protocol.transport
+        assert transport is not None
+        writer = WebSocketWriter(
+            request._protocol, transport, compress=compress, notakeover=notakeover
+        )
+
+        return protocol, writer
+
+    def _post_start(
+        self, request: BaseRequest, protocol: str, writer: WebSocketWriter
+    ) -> None:
+        self._ws_protocol = protocol
+        self._writer = writer
+
+        self._reset_heartbeat()
+
+        loop = self._loop
+        assert loop is not None
+        self._reader = FlowControlDataQueue(request._protocol, 2**16, loop=loop)
+        request.protocol.set_parser(
+            WebSocketReader(self._reader, self._max_msg_size, compress=self._compress)
+        )
+        # disable HTTP keepalive for WebSocket
+        request.protocol.keep_alive(False)
+
+    def can_prepare(self, request: BaseRequest) -> WebSocketReady:
+        if self._writer is not None:
+            raise RuntimeError("Already started")
+        try:
+            _, protocol, _, _ = self._handshake(request)
+        except HTTPException:
+            return WebSocketReady(False, None)
+        else:
+            return WebSocketReady(True, protocol)
+
+    @property
+    def closed(self) -> bool:
+        return self._closed
+
+    @property
+    def close_code(self) -> Optional[int]:
+        return self._close_code
+
+    @property
+    def ws_protocol(self) -> Optional[str]:
+        return self._ws_protocol
+
+    @property
+    def compress(self) -> bool:
+        return self._compress
+
+    def get_extra_info(self, name: str, default: Any = None) -> Any:
+        """Get optional transport information.
+
+        If no value associated with ``name`` is found, ``default`` is returned.
+        """
+        writer = self._writer
+        if writer is None:
+            return default
+        transport = writer.transport
+        if transport is None:
+            return default
+        return transport.get_extra_info(name, default)
+
+    def exception(self) -> Optional[BaseException]:
+        return self._exception
+
+    async def ping(self, message: bytes = b"") -> None:
+        if self._writer is None:
+            raise RuntimeError("Call .prepare() first")
+        await self._writer.ping(message)
+
+    async def pong(self, message: bytes = b"") -> None:
+        # unsolicited pong
+        if self._writer is None:
+            raise RuntimeError("Call .prepare() first")
+        await self._writer.pong(message)
+
+    async def send_str(self, data: str, compress: Optional[bool] = None) -> None:
+        if self._writer is None:
+            raise RuntimeError("Call .prepare() first")
+        if not isinstance(data, str):
+            raise TypeError("data argument must be str (%r)" % type(data))
+        await self._writer.send(data, binary=False, compress=compress)
+
+    async def send_bytes(self, data: bytes, compress: Optional[bool] = None) -> None:
+        if self._writer is None:
+            raise RuntimeError("Call .prepare() first")
+        if not isinstance(data, (bytes, bytearray, memoryview)):
+            raise TypeError("data argument must be byte-ish (%r)" % type(data))
+        await self._writer.send(data, binary=True, compress=compress)
+
+    async def send_json(
+        self,
+        data: Any,
+        compress: Optional[bool] = None,
+        *,
+        dumps: JSONEncoder = json.dumps,
+    ) -> None:
+        await self.send_str(dumps(data), compress=compress)
+
+    async def write_eof(self) -> None:  # type: ignore[override]
+        if self._eof_sent:
+            return
+        if self._payload_writer is None:
+            raise RuntimeError("Response has not been started")
+
+        await self.close()
+        self._eof_sent = True
+
+    async def close(
+        self, *, code: int = WSCloseCode.OK, message: bytes = b"", drain: bool = True
+    ) -> bool:
+        """Close websocket connection."""
+        if self._writer is None:
+            raise RuntimeError("Call .prepare() first")
+
+        self._cancel_heartbeat()
+        reader = self._reader
+        assert reader is not None
+
+        # we need to break `receive()` cycle first,
+        # `close()` may be called from different task
+        if self._waiting is not None and not self._closed:
+            reader.feed_data(WS_CLOSING_MESSAGE, 0)
+            await self._waiting
+
+        if self._closed:
+            return False
+
+        self._closed = True
+        try:
+            await self._writer.close(code, message)
+            writer = self._payload_writer
+            assert writer is not None
+            if drain:
+                await writer.drain()
+        except (asyncio.CancelledError, asyncio.TimeoutError):
+            self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE)
+            raise
+        except Exception as exc:
+            self._exception = exc
+            self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE)
+            return True
+
+        if self._closing:
+            self._close_transport()
+            return True
+
+        reader = self._reader
+        assert reader is not None
+        try:
+            async with async_timeout.timeout(self._timeout):
+                msg = await reader.read()
+        except asyncio.CancelledError:
+            self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE)
+            raise
+        except Exception as exc:
+            self._exception = exc
+            self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE)
+            return True
+
+        if msg.type == WSMsgType.CLOSE:
+            self._set_code_close_transport(msg.data)
+            return True
+
+        self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE)
+        self._exception = asyncio.TimeoutError()
+        return True
+
+    def _set_closing(self, code: WSCloseCode) -> None:
+        """Set the close code and mark the connection as closing."""
+        self._closing = True
+        self._close_code = code
+
+    def _set_code_close_transport(self, code: WSCloseCode) -> None:
+        """Set the close code and close the transport."""
+        self._close_code = code
+        self._close_transport()
+
+    def _close_transport(self) -> None:
+        """Close the transport."""
+        if self._req is not None and self._req.transport is not None:
+            self._req.transport.close()
+
+    async def receive(self, timeout: Optional[float] = None) -> WSMessage:
+        if self._reader is None:
+            raise RuntimeError("Call .prepare() first")
+
+        loop = self._loop
+        assert loop is not None
+        while True:
+            if self._waiting is not None:
+                raise RuntimeError("Concurrent call to receive() is not allowed")
+
+            if self._closed:
+                self._conn_lost += 1
+                if self._conn_lost >= THRESHOLD_CONNLOST_ACCESS:
+                    raise RuntimeError("WebSocket connection is closed.")
+                return WS_CLOSED_MESSAGE
+            elif self._closing:
+                return WS_CLOSING_MESSAGE
+
+            try:
+                self._waiting = loop.create_future()
+                try:
+                    async with async_timeout.timeout(timeout or self._receive_timeout):
+                        msg = await self._reader.read()
+                    self._reset_heartbeat()
+                finally:
+                    waiter = self._waiting
+                    set_result(waiter, True)
+                    self._waiting = None
+            except asyncio.TimeoutError:
+                raise
+            except EofStream:
+                self._close_code = WSCloseCode.OK
+                await self.close()
+                return WSMessage(WSMsgType.CLOSED, None, None)
+            except WebSocketError as exc:
+                self._close_code = exc.code
+                await self.close(code=exc.code)
+                return WSMessage(WSMsgType.ERROR, exc, None)
+            except Exception as exc:
+                self._exception = exc
+                self._set_closing(WSCloseCode.ABNORMAL_CLOSURE)
+                await self.close()
+                return WSMessage(WSMsgType.ERROR, exc, None)
+
+            if msg.type == WSMsgType.CLOSE:
+                self._set_closing(msg.data)
+                # Could be closed while awaiting reader.
+                if not self._closed and self._autoclose:
+                    # The client is likely going to close the
+                    # connection out from under us so we do not
+                    # want to drain any pending writes as it will
+                    # likely result writing to a broken pipe.
+                    await self.close(drain=False)
+            elif msg.type == WSMsgType.CLOSING:
+                self._set_closing(WSCloseCode.OK)
+            elif msg.type == WSMsgType.PING and self._autoping:
+                await self.pong(msg.data)
+                continue
+            elif msg.type == WSMsgType.PONG and self._autoping:
+                continue
+
+            return msg
+
+    async def receive_str(self, *, timeout: Optional[float] = None) -> str:
+        msg = await self.receive(timeout)
+        if msg.type != WSMsgType.TEXT:
+            raise TypeError(
+                "Received message {}:{!r} is not WSMsgType.TEXT".format(
+                    msg.type, msg.data
+                )
+            )
+        return cast(str, msg.data)
+
+    async def receive_bytes(self, *, timeout: Optional[float] = None) -> bytes:
+        msg = await self.receive(timeout)
+        if msg.type != WSMsgType.BINARY:
+            raise TypeError(f"Received message {msg.type}:{msg.data!r} is not bytes")
+        return cast(bytes, msg.data)
+
+    async def receive_json(
+        self, *, loads: JSONDecoder = json.loads, timeout: Optional[float] = None
+    ) -> Any:
+        data = await self.receive_str(timeout=timeout)
+        return loads(data)
+
+    async def write(self, data: bytes) -> None:
+        raise RuntimeError("Cannot call .write() for websocket")
+
+    def __aiter__(self) -> "WebSocketResponse":
+        return self
+
+    async def __anext__(self) -> WSMessage:
+        msg = await self.receive()
+        if msg.type in (WSMsgType.CLOSE, WSMsgType.CLOSING, WSMsgType.CLOSED):
+            raise StopAsyncIteration
+        return msg
+
+    def _cancel(self, exc: BaseException) -> None:
+        # web_protocol calls this from connection_lost
+        # or when the server is shutting down.
+        self._closing = True
+        if self._reader is not None:
+            set_exception(self._reader, exc)
diff --git a/llm/Lib/site-packages/aiohttp/worker.py b/llm/Lib/site-packages/aiohttp/worker.py
new file mode 100644
index 0000000000000000000000000000000000000000..aa8c40472afa3f27e5349a7a42e934cf14d991ab
--- /dev/null
+++ b/llm/Lib/site-packages/aiohttp/worker.py
@@ -0,0 +1,247 @@
+"""Async gunicorn worker for aiohttp.web"""
+
+import asyncio
+import os
+import re
+import signal
+import sys
+from types import FrameType
+from typing import Any, Awaitable, Callable, Optional, Union  # noqa
+
+from gunicorn.config import AccessLogFormat as GunicornAccessLogFormat
+from gunicorn.workers import base
+
+from aiohttp import web
+
+from .helpers import set_result
+from .web_app import Application
+from .web_log import AccessLogger
+
+try:
+    import ssl
+
+    SSLContext = ssl.SSLContext
+except ImportError:  # pragma: no cover
+    ssl = None  # type: ignore[assignment]
+    SSLContext = object  # type: ignore[misc,assignment]
+
+
+__all__ = ("GunicornWebWorker", "GunicornUVLoopWebWorker")
+
+
+class GunicornWebWorker(base.Worker):  # type: ignore[misc,no-any-unimported]
+
+    DEFAULT_AIOHTTP_LOG_FORMAT = AccessLogger.LOG_FORMAT
+    DEFAULT_GUNICORN_LOG_FORMAT = GunicornAccessLogFormat.default
+
+    def __init__(self, *args: Any, **kw: Any) -> None:  # pragma: no cover
+        super().__init__(*args, **kw)
+
+        self._task: Optional[asyncio.Task[None]] = None
+        self.exit_code = 0
+        self._notify_waiter: Optional[asyncio.Future[bool]] = None
+
+    def init_process(self) -> None:
+        # create new event_loop after fork
+        asyncio.get_event_loop().close()
+
+        self.loop = asyncio.new_event_loop()
+        asyncio.set_event_loop(self.loop)
+
+        super().init_process()
+
+    def run(self) -> None:
+        self._task = self.loop.create_task(self._run())
+
+        try:  # ignore all finalization problems
+            self.loop.run_until_complete(self._task)
+        except Exception:
+            self.log.exception("Exception in gunicorn worker")
+        self.loop.run_until_complete(self.loop.shutdown_asyncgens())
+        self.loop.close()
+
+        sys.exit(self.exit_code)
+
+    async def _run(self) -> None:
+        runner = None
+        if isinstance(self.wsgi, Application):
+            app = self.wsgi
+        elif asyncio.iscoroutinefunction(self.wsgi):
+            wsgi = await self.wsgi()
+            if isinstance(wsgi, web.AppRunner):
+                runner = wsgi
+                app = runner.app
+            else:
+                app = wsgi
+        else:
+            raise RuntimeError(
+                "wsgi app should be either Application or "
+                "async function returning Application, got {}".format(self.wsgi)
+            )
+
+        if runner is None:
+            access_log = self.log.access_log if self.cfg.accesslog else None
+            runner = web.AppRunner(
+                app,
+                logger=self.log,
+                keepalive_timeout=self.cfg.keepalive,
+                access_log=access_log,
+                access_log_format=self._get_valid_log_format(
+                    self.cfg.access_log_format
+                ),
+                shutdown_timeout=self.cfg.graceful_timeout / 100 * 95,
+            )
+        await runner.setup()
+
+        ctx = self._create_ssl_context(self.cfg) if self.cfg.is_ssl else None
+
+        runner = runner
+        assert runner is not None
+        server = runner.server
+        assert server is not None
+        for sock in self.sockets:
+            site = web.SockSite(
+                runner,
+                sock,
+                ssl_context=ctx,
+            )
+            await site.start()
+
+        # If our parent changed then we shut down.
+        pid = os.getpid()
+        try:
+            while self.alive:  # type: ignore[has-type]
+                self.notify()
+
+                cnt = server.requests_count
+                if self.max_requests and cnt > self.max_requests:
+                    self.alive = False
+                    self.log.info("Max requests, shutting down: %s", self)
+
+                elif pid == os.getpid() and self.ppid != os.getppid():
+                    self.alive = False
+                    self.log.info("Parent changed, shutting down: %s", self)
+                else:
+                    await self._wait_next_notify()
+        except BaseException:
+            pass
+
+        await runner.cleanup()
+
+    def _wait_next_notify(self) -> "asyncio.Future[bool]":
+        self._notify_waiter_done()
+
+        loop = self.loop
+        assert loop is not None
+        self._notify_waiter = waiter = loop.create_future()
+        self.loop.call_later(1.0, self._notify_waiter_done, waiter)
+
+        return waiter
+
+    def _notify_waiter_done(
+        self, waiter: Optional["asyncio.Future[bool]"] = None
+    ) -> None:
+        if waiter is None:
+            waiter = self._notify_waiter
+        if waiter is not None:
+            set_result(waiter, True)
+
+        if waiter is self._notify_waiter:
+            self._notify_waiter = None
+
+    def init_signals(self) -> None:
+        # Set up signals through the event loop API.
+
+        self.loop.add_signal_handler(
+            signal.SIGQUIT, self.handle_quit, signal.SIGQUIT, None
+        )
+
+        self.loop.add_signal_handler(
+            signal.SIGTERM, self.handle_exit, signal.SIGTERM, None
+        )
+
+        self.loop.add_signal_handler(
+            signal.SIGINT, self.handle_quit, signal.SIGINT, None
+        )
+
+        self.loop.add_signal_handler(
+            signal.SIGWINCH, self.handle_winch, signal.SIGWINCH, None
+        )
+
+        self.loop.add_signal_handler(
+            signal.SIGUSR1, self.handle_usr1, signal.SIGUSR1, None
+        )
+
+        self.loop.add_signal_handler(
+            signal.SIGABRT, self.handle_abort, signal.SIGABRT, None
+        )
+
+        # Don't let SIGTERM and SIGUSR1 disturb active requests
+        # by interrupting system calls
+        signal.siginterrupt(signal.SIGTERM, False)
+        signal.siginterrupt(signal.SIGUSR1, False)
+        # Reset signals so Gunicorn doesn't swallow subprocess return codes
+        # See: https://github.com/aio-libs/aiohttp/issues/6130
+
+    def handle_quit(self, sig: int, frame: Optional[FrameType]) -> None:
+        self.alive = False
+
+        # worker_int callback
+        self.cfg.worker_int(self)
+
+        # wakeup closing process
+        self._notify_waiter_done()
+
+    def handle_abort(self, sig: int, frame: Optional[FrameType]) -> None:
+        self.alive = False
+        self.exit_code = 1
+        self.cfg.worker_abort(self)
+        sys.exit(1)
+
+    @staticmethod
+    def _create_ssl_context(cfg: Any) -> "SSLContext":
+        """Creates SSLContext instance for usage in asyncio.create_server.
+
+        See ssl.SSLSocket.__init__ for more details.
+        """
+        if ssl is None:  # pragma: no cover
+            raise RuntimeError("SSL is not supported.")
+
+        ctx = ssl.SSLContext(cfg.ssl_version)
+        ctx.load_cert_chain(cfg.certfile, cfg.keyfile)
+        ctx.verify_mode = cfg.cert_reqs
+        if cfg.ca_certs:
+            ctx.load_verify_locations(cfg.ca_certs)
+        if cfg.ciphers:
+            ctx.set_ciphers(cfg.ciphers)
+        return ctx
+
+    def _get_valid_log_format(self, source_format: str) -> str:
+        if source_format == self.DEFAULT_GUNICORN_LOG_FORMAT:
+            return self.DEFAULT_AIOHTTP_LOG_FORMAT
+        elif re.search(r"%\([^\)]+\)", source_format):
+            raise ValueError(
+                "Gunicorn's style options in form of `%(name)s` are not "
+                "supported for the log formatting. Please use aiohttp's "
+                "format specification to configure access log formatting: "
+                "http://docs.aiohttp.org/en/stable/logging.html"
+                "#format-specification"
+            )
+        else:
+            return source_format
+
+
+class GunicornUVLoopWebWorker(GunicornWebWorker):
+    def init_process(self) -> None:
+        import uvloop
+
+        # Close any existing event loop before setting a
+        # new policy.
+        asyncio.get_event_loop().close()
+
+        # Setup uvloop policy, so that every
+        # asyncio.get_event_loop() will create an instance
+        # of uvloop event loop.
+        asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())
+
+        super().init_process()
diff --git a/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/INSTALLER b/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/LICENSE b/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..7082a2d5b9047bfc09589f387053e24ea490bc54
--- /dev/null
+++ b/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/LICENSE
@@ -0,0 +1,201 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2013-2019 Nikolay Kim and Andrew Svetlov
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/METADATA b/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..fc964525f05e8e34961f0398b1930b8dec64ef26
--- /dev/null
+++ b/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/METADATA
@@ -0,0 +1,128 @@
+Metadata-Version: 2.1
+Name: aiosignal
+Version: 1.3.1
+Summary: aiosignal: a list of registered asynchronous callbacks
+Home-page: https://github.com/aio-libs/aiosignal
+Maintainer: aiohttp team <team@aiohttp.org>
+Maintainer-email: team@aiohttp.org
+License: Apache 2.0
+Project-URL: Chat: Gitter, https://gitter.im/aio-libs/Lobby
+Project-URL: CI: GitHub Actions, https://github.com/aio-libs/aiosignal/actions
+Project-URL: Coverage: codecov, https://codecov.io/github/aio-libs/aiosignal
+Project-URL: Docs: RTD, https://docs.aiosignal.org
+Project-URL: GitHub: issues, https://github.com/aio-libs/aiosignal/issues
+Project-URL: GitHub: repo, https://github.com/aio-libs/aiosignal
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.7
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: frozenlist (>=1.1.0)
+
+=========
+aiosignal
+=========
+
+.. image:: https://github.com/aio-libs/aiosignal/workflows/CI/badge.svg
+   :target: https://github.com/aio-libs/aiosignal/actions?query=workflow%3ACI
+   :alt: GitHub status for master branch
+
+.. image:: https://codecov.io/gh/aio-libs/aiosignal/branch/master/graph/badge.svg
+   :target: https://codecov.io/gh/aio-libs/aiosignal
+   :alt: codecov.io status for master branch
+
+.. image:: https://badge.fury.io/py/aiosignal.svg
+   :target: https://pypi.org/project/aiosignal
+   :alt: Latest PyPI package version
+
+.. image:: https://readthedocs.org/projects/aiosignal/badge/?version=latest
+   :target: https://aiosignal.readthedocs.io/
+   :alt: Latest Read The Docs
+
+.. image:: https://img.shields.io/discourse/topics?server=https%3A%2F%2Faio-libs.discourse.group%2F
+   :target: https://aio-libs.discourse.group/
+   :alt: Discourse group for io-libs
+
+.. image:: https://badges.gitter.im/Join%20Chat.svg
+   :target: https://gitter.im/aio-libs/Lobby
+   :alt: Chat on Gitter
+
+Introduction
+============
+
+A project to manage callbacks in `asyncio` projects.
+
+``Signal`` is a list of registered asynchronous callbacks.
+
+The signal's life-cycle has two stages: after creation its content
+could be filled by using standard list operations: ``sig.append()``
+etc.
+
+After you call ``sig.freeze()`` the signal is *frozen*: adding, removing
+and dropping callbacks is forbidden.
+
+The only available operation is calling the previously registered
+callbacks by using ``await sig.send(data)``.
+
+For concrete usage examples see the `Signals
+<https://docs.aiohttp.org/en/stable/web_advanced.html#aiohttp-web-signals>
+section of the `Web Server Advanced
+<https://docs.aiohttp.org/en/stable/web_advanced.html>` chapter of the `aiohttp
+documentation`_.
+
+
+Installation
+------------
+
+::
+
+   $ pip install aiosignal
+
+The library requires Python 3.6 or newer.
+
+
+Documentation
+=============
+
+https://aiosignal.readthedocs.io/
+
+Communication channels
+======================
+
+*gitter chat* https://gitter.im/aio-libs/Lobby
+
+Requirements
+============
+
+- Python >= 3.6
+- frozenlist >= 1.0.0
+
+License
+=======
+
+``aiosignal`` is offered under the Apache 2 license.
+
+Source code
+===========
+
+The project is hosted on GitHub_
+
+Please file an issue in the `bug tracker
+<https://github.com/aio-libs/aiosignal/issues>`_ if you have found a bug
+or have some suggestions to improve the library.
+
+.. _GitHub: https://github.com/aio-libs/aiosignal
+.. _aiohttp documentation: https://docs.aiohttp.org/
diff --git a/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/RECORD b/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..63cbabf5c681369801fdd2925ab317963da469a7
--- /dev/null
+++ b/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/RECORD
@@ -0,0 +1,10 @@
+aiosignal-1.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+aiosignal-1.3.1.dist-info/LICENSE,sha256=b9UkPpLdf5jsacesN3co50kFcJ_1J6W_mNbQJjwE9bY,11332
+aiosignal-1.3.1.dist-info/METADATA,sha256=c0HRnlYzfXKztZPTFDlPfygizTherhG5WdwXlvco0Ug,4008
+aiosignal-1.3.1.dist-info/RECORD,,
+aiosignal-1.3.1.dist-info/WHEEL,sha256=ZL1lC_LiPDNRgDnOl2taCMc83aPEUZgHHv2h-LDgdiM,92
+aiosignal-1.3.1.dist-info/top_level.txt,sha256=z45aNOKGDdrI1roqZY3BGXQ22kJFPHBmVdwtLYLtXC0,10
+aiosignal/__init__.py,sha256=zQNfFYRSd84bswvpFv8ZWjEr5DeYwV3LXbMSyo2222s,867
+aiosignal/__init__.pyi,sha256=xeCddYSS8fZAkz8S4HuKSR2IDe3N7RW_LKcXDPPA1Xk,311
+aiosignal/__pycache__/__init__.cpython-311.pyc,,
+aiosignal/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
diff --git a/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/WHEEL b/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..5e1f087ca1ac49327ef76b101df80489a03c2e7f
--- /dev/null
+++ b/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.38.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/top_level.txt b/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..ac6df3afe74a5fd43afc7ab7f8393571a495fdc5
--- /dev/null
+++ b/llm/Lib/site-packages/aiosignal-1.3.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+aiosignal
diff --git a/llm/Lib/site-packages/aiosignal/__init__.py b/llm/Lib/site-packages/aiosignal/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3d288e6ede67df2bb8e5660e30372e190eb23e65
--- /dev/null
+++ b/llm/Lib/site-packages/aiosignal/__init__.py
@@ -0,0 +1,36 @@
+from frozenlist import FrozenList
+
+__version__ = "1.3.1"
+
+__all__ = ("Signal",)
+
+
+class Signal(FrozenList):
+    """Coroutine-based signal implementation.
+
+    To connect a callback to a signal, use any list method.
+
+    Signals are fired using the send() coroutine, which takes named
+    arguments.
+    """
+
+    __slots__ = ("_owner",)
+
+    def __init__(self, owner):
+        super().__init__()
+        self._owner = owner
+
+    def __repr__(self):
+        return "<Signal owner={}, frozen={}, {!r}>".format(
+            self._owner, self.frozen, list(self)
+        )
+
+    async def send(self, *args, **kwargs):
+        """
+        Sends data to all registered receivers.
+        """
+        if not self.frozen:
+            raise RuntimeError("Cannot send non-frozen signal.")
+
+        for receiver in self:
+            await receiver(*args, **kwargs)  # type: ignore
diff --git a/llm/Lib/site-packages/aiosignal/__init__.pyi b/llm/Lib/site-packages/aiosignal/__init__.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..d4e3416d72246058259061578a82697e2bc0706e
--- /dev/null
+++ b/llm/Lib/site-packages/aiosignal/__init__.pyi
@@ -0,0 +1,12 @@
+from typing import Any, Generic, TypeVar
+
+from frozenlist import FrozenList
+
+__all__ = ("Signal",)
+
+_T = TypeVar("_T")
+
+class Signal(FrozenList[_T], Generic[_T]):
+    def __init__(self, owner: Any) -> None: ...
+    def __repr__(self) -> str: ...
+    async def send(self, *args: Any, **kwargs: Any) -> None: ...
diff --git a/llm/Lib/site-packages/aiosignal/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/aiosignal/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b01e54668ca26b59fb6763305e988e505020e583
Binary files /dev/null and b/llm/Lib/site-packages/aiosignal/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/aiosignal/py.typed b/llm/Lib/site-packages/aiosignal/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/altair-5.3.0.dist-info/INSTALLER b/llm/Lib/site-packages/altair-5.3.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/altair-5.3.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/altair-5.3.0.dist-info/METADATA b/llm/Lib/site-packages/altair-5.3.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..c1ce9ef9e7e9fe5f64fb0e661b1f0f9a5ce18ab1
--- /dev/null
+++ b/llm/Lib/site-packages/altair-5.3.0.dist-info/METADATA
@@ -0,0 +1,221 @@
+Metadata-Version: 2.3
+Name: altair
+Version: 5.3.0
+Summary: Vega-Altair: A declarative statistical visualization library for Python.
+Project-URL: Documentation, https://altair-viz.github.io
+Project-URL: Source, https://github.com/altair-viz/altair
+Author: Vega-Altair Contributors
+License-File: LICENSE
+Keywords: declarative,interactive,json,statistics,vega-lite,visualization
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Requires-Dist: jinja2
+Requires-Dist: jsonschema>=3.0
+Requires-Dist: numpy
+Requires-Dist: packaging
+Requires-Dist: pandas>=0.25
+Requires-Dist: toolz
+Requires-Dist: typing-extensions>=4.0.1; python_version < '3.11'
+Provides-Extra: all
+Requires-Dist: altair-tiles>=0.3.0; extra == 'all'
+Requires-Dist: anywidget>=0.9.0; extra == 'all'
+Requires-Dist: pyarrow>=11; extra == 'all'
+Requires-Dist: vega-datasets>=0.9.0; extra == 'all'
+Requires-Dist: vegafusion[embed]>=1.6.6; extra == 'all'
+Requires-Dist: vl-convert-python>=1.3.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: geopandas; extra == 'dev'
+Requires-Dist: hatch; extra == 'dev'
+Requires-Dist: ipython; extra == 'dev'
+Requires-Dist: m2r; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pandas-stubs; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Requires-Dist: types-jsonschema; extra == 'dev'
+Requires-Dist: types-setuptools; extra == 'dev'
+Provides-Extra: doc
+Requires-Dist: docutils; extra == 'doc'
+Requires-Dist: jinja2; extra == 'doc'
+Requires-Dist: myst-parser; extra == 'doc'
+Requires-Dist: numpydoc; extra == 'doc'
+Requires-Dist: pillow<10,>=9; extra == 'doc'
+Requires-Dist: pydata-sphinx-theme>=0.14.1; extra == 'doc'
+Requires-Dist: scipy; extra == 'doc'
+Requires-Dist: sphinx; extra == 'doc'
+Requires-Dist: sphinx-copybutton; extra == 'doc'
+Requires-Dist: sphinx-design; extra == 'doc'
+Requires-Dist: sphinxext-altair; extra == 'doc'
+Description-Content-Type: text/markdown
+
+# Vega-Altair <a href="https://altair-viz.github.io/"><img align="right" src="https://altair-viz.github.io/_static/altair-logo-light.png" height="50"></img></a>
+
+[![github actions](https://github.com/altair-viz/altair/workflows/build/badge.svg)](https://github.com/altair-viz/altair/actions?query=workflow%3Abuild)
+[![typedlib_mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://www.mypy-lang.org)
+[![JOSS Paper](https://joss.theoj.org/papers/10.21105/joss.01057/status.svg)](https://joss.theoj.org/papers/10.21105/joss.01057)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/altair)](https://pypi.org/project/altair)
+
+**Vega-Altair** is a declarative statistical visualization library for Python. With Vega-Altair, you can spend more time understanding your data and its meaning. Vega-Altair's
+API is simple, friendly and consistent and built on top of the powerful
+[Vega-Lite](https://github.com/vega/vega-lite) JSON specification. This elegant
+simplicity produces beautiful and effective visualizations with a minimal amount of code. 
+
+*Vega-Altair was originally developed by [Jake Vanderplas](https://github.com/jakevdp) and [Brian
+Granger](https://github.com/ellisonbg) in close collaboration with the [UW
+Interactive Data Lab](https://idl.cs.washington.edu/).*
+*The Vega-Altair open source project is not affiliated with Altair Engineering, Inc.*
+
+## Documentation
+
+See [Vega-Altair's Documentation Site](https://altair-viz.github.io) as well as the [Tutorial Notebooks](https://github.com/altair-viz/altair_notebooks). You can
+run the notebooks directly in your browser by clicking on one of the following badges:
+
+[![Binder](https://beta.mybinder.org/badge.svg)](https://beta.mybinder.org/v2/gh/altair-viz/altair_notebooks/master)
+[![Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/altair-viz/altair_notebooks/blob/master/notebooks/Index.ipynb)
+
+## Example
+
+Here is an example using Vega-Altair to quickly visualize and display a dataset with the native Vega-Lite renderer in the JupyterLab:
+
+```python
+import altair as alt
+
+# load a simple dataset as a pandas DataFrame
+from vega_datasets import data
+cars = data.cars()
+
+alt.Chart(cars).mark_point().encode(
+    x='Horsepower',
+    y='Miles_per_Gallon',
+    color='Origin',
+)
+```
+
+![Vega-Altair Visualization](https://raw.githubusercontent.com/altair-viz/altair/main/images/cars.png)
+
+One of the unique features of Vega-Altair, inherited from Vega-Lite, is a declarative grammar of not just visualization, but _interaction_. 
+With a few modifications to the example above we can create a linked histogram that is filtered based on a selection of the scatter plot.
+
+```python 
+import altair as alt
+from vega_datasets import data
+
+source = data.cars()
+
+brush = alt.selection_interval()
+
+points = alt.Chart(source).mark_point().encode(
+    x='Horsepower',
+    y='Miles_per_Gallon',
+    color=alt.condition(brush, 'Origin', alt.value('lightgray'))
+).add_params(
+    brush
+)
+
+bars = alt.Chart(source).mark_bar().encode(
+    y='Origin',
+    color='Origin',
+    x='count(Origin)'
+).transform_filter(
+    brush
+)
+
+points & bars
+```
+
+![Vega-Altair Visualization Gif](https://raw.githubusercontent.com/altair-viz/altair/main/images/cars_scatter_bar.gif)
+
+## Features
+
+* Carefully-designed, declarative Python API.
+* Auto-generated internal Python API that guarantees visualizations are type-checked and
+  in full conformance with the [Vega-Lite](https://github.com/vega/vega-lite)
+  specification.
+* Display visualizations in JupyterLab, Jupyter Notebook, Visual Studio Code, on GitHub and
+  [nbviewer](https://nbviewer.jupyter.org/), and many more.
+* Export visualizations to various formats such as PNG/SVG images, stand-alone HTML pages and the
+[Online Vega-Lite Editor](https://vega.github.io/editor/#/).
+* Serialize visualizations as JSON files.
+
+## Installation
+
+Vega-Altair can be installed with:
+```bash
+pip install altair
+```
+
+If you are using the conda package manager, the equivalent is:
+```bash
+conda install altair -c conda-forge
+```
+
+For full installation instructions, please see [the documentation](https://altair-viz.github.io/getting_started/installation.html).
+
+## Getting Help
+
+If you have a question that is not addressed in the documentation, 
+you can post it on [StackOverflow](https://stackoverflow.com/questions/tagged/altair) using the `altair` tag.
+For bugs and feature requests, please open a [Github Issue](https://github.com/altair-viz/altair/issues).
+
+## Development
+
+[![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![pytest](https://img.shields.io/badge/logo-pytest-blue?logo=pytest&labelColor=5c5c5c&label=%20)](https://github.com/pytest-dev/pytest)
+
+You can find the instructions on how to install the package for development in [the documentation](https://altair-viz.github.io/getting_started/installation.html).
+
+To run the tests and linters, use
+
+```
+hatch run test
+```
+
+For information on how to contribute your developments back to the Vega-Altair repository, see
+[`CONTRIBUTING.md`](https://github.com/altair-viz/altair/blob/main/CONTRIBUTING.md)
+
+## Citing Vega-Altair
+
+[![JOSS Paper](https://joss.theoj.org/papers/10.21105/joss.01057/status.svg)](https://joss.theoj.org/papers/10.21105/joss.01057)
+
+If you use Vega-Altair in academic work, please consider citing https://joss.theoj.org/papers/10.21105/joss.01057 as
+
+```bib
+@article{VanderPlas2018,
+    doi = {10.21105/joss.01057},
+    url = {https://doi.org/10.21105/joss.01057},
+    year = {2018},
+    publisher = {The Open Journal},
+    volume = {3},
+    number = {32},
+    pages = {1057},
+    author = {Jacob VanderPlas and Brian Granger and Jeffrey Heer and Dominik Moritz and Kanit Wongsuphasawat and Arvind Satyanarayan and Eitan Lees and Ilia Timofeev and Ben Welsh and Scott Sievert},
+    title = {Altair: Interactive Statistical Visualizations for Python},
+    journal = {Journal of Open Source Software}
+}
+```
+Please additionally consider citing the [Vega-Lite](https://vega.github.io/vega-lite/) project, which Vega-Altair is based on: https://dl.acm.org/doi/10.1109/TVCG.2016.2599030
+
+```bib
+@article{Satyanarayan2017,
+    author={Satyanarayan, Arvind and Moritz, Dominik and Wongsuphasawat, Kanit and Heer, Jeffrey},
+    title={Vega-Lite: A Grammar of Interactive Graphics},
+    journal={IEEE transactions on visualization and computer graphics},
+    year={2017},
+    volume={23},
+    number={1},
+    pages={341-350},
+    publisher={IEEE}
+} 
+```
diff --git a/llm/Lib/site-packages/altair-5.3.0.dist-info/RECORD b/llm/Lib/site-packages/altair-5.3.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..83bef022793bec993d1c2b0443d029bb5963a5fd
--- /dev/null
+++ b/llm/Lib/site-packages/altair-5.3.0.dist-info/RECORD
@@ -0,0 +1,96 @@
+altair-5.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+altair-5.3.0.dist-info/METADATA,sha256=l9xKPXtciPbAaiwLFlBsrk721JiyN31y5ghnqzbAxjE,9161
+altair-5.3.0.dist-info/RECORD,,
+altair-5.3.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+altair-5.3.0.dist-info/WHEEL,sha256=uNdcs2TADwSd5pVaP0Z_kcjcvvTUklh2S7bxZMF8Uj0,87
+altair-5.3.0.dist-info/licenses/LICENSE,sha256=FL9avQqjkvgG-gu8iPUd42lk1TBxpodjHmIYB-VWMx4,1497
+altair/__init__.py,sha256=MdaJpEMW9rR_ak5eYdyy69IJOnTQItOtu6e8ditWci0,14638
+altair/__pycache__/__init__.cpython-311.pyc,,
+altair/__pycache__/_magics.cpython-311.pyc,,
+altair/_magics.py,sha256=HoCk3nSeCe25IiARz6nvTBj5tV1F3dU5z84w2L5SGPU,2996
+altair/expr/__init__.py,sha256=wHX2XE8k_mK-BSbteNDjH2e5vJI4PPAmVau-UR5Tom8,449
+altair/expr/__pycache__/__init__.cpython-311.pyc,,
+altair/expr/__pycache__/consts.cpython-311.pyc,,
+altair/expr/__pycache__/core.cpython-311.pyc,,
+altair/expr/__pycache__/funcs.cpython-311.pyc,,
+altair/expr/consts.py,sha256=tFviBb2Dg2W0dYAuHpjU2vkZaCdzNFO8wTWBCKczeq4,916
+altair/expr/core.py,sha256=iWAS8HHE9qmUuP6MsnwVxsjZV6xzKZBKBRGgj88qUgk,6848
+altair/expr/funcs.py,sha256=EIR1TowHBbcnYj4MWDmw9hjeeMa8tZSNUVFxoVeJEyc,34418
+altair/jupyter/__init__.py,sha256=6xkrWgyUEe075vkf8c6IJdNJkI83qMMy66to8egXbz4,852
+altair/jupyter/__pycache__/__init__.cpython-311.pyc,,
+altair/jupyter/__pycache__/jupyter_chart.cpython-311.pyc,,
+altair/jupyter/js/README.md,sha256=iwzryhAUgm-HD7KupvKV2TKY5U74S7mLyGKe0rgB4D8,172
+altair/jupyter/js/index.js,sha256=Fq5QVsTmNZ-YdONfAGRYhKba9PCjOMxBML-yevju0qc,7936
+altair/jupyter/jupyter_chart.py,sha256=B7NTCwH94ecB-_FKAWCDdCP5jAb1PEMNvUaMi-x8JSU,15289
+altair/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+altair/utils/__init__.py,sha256=7-6IsrndhpIInccWeneLbZC5S-gjasA1cFbTmsd0Nvs,702
+altair/utils/__pycache__/__init__.cpython-311.pyc,,
+altair/utils/__pycache__/_dfi_types.cpython-311.pyc,,
+altair/utils/__pycache__/_importers.cpython-311.pyc,,
+altair/utils/__pycache__/_show.cpython-311.pyc,,
+altair/utils/__pycache__/_transformed_data.cpython-311.pyc,,
+altair/utils/__pycache__/_vegafusion_data.cpython-311.pyc,,
+altair/utils/__pycache__/compiler.cpython-311.pyc,,
+altair/utils/__pycache__/core.cpython-311.pyc,,
+altair/utils/__pycache__/data.cpython-311.pyc,,
+altair/utils/__pycache__/deprecation.cpython-311.pyc,,
+altair/utils/__pycache__/display.cpython-311.pyc,,
+altair/utils/__pycache__/execeval.cpython-311.pyc,,
+altair/utils/__pycache__/html.cpython-311.pyc,,
+altair/utils/__pycache__/mimebundle.cpython-311.pyc,,
+altair/utils/__pycache__/plugin_registry.cpython-311.pyc,,
+altair/utils/__pycache__/save.cpython-311.pyc,,
+altair/utils/__pycache__/schemapi.cpython-311.pyc,,
+altair/utils/__pycache__/selection.cpython-311.pyc,,
+altair/utils/__pycache__/server.cpython-311.pyc,,
+altair/utils/__pycache__/theme.cpython-311.pyc,,
+altair/utils/_dfi_types.py,sha256=75RF6_BS7Go8pVAjwkCN__jD2YOrnZmNGBiq_PFlHEU,6503
+altair/utils/_importers.py,sha256=W34Z6rFdPGOcr2xMIYGFqKEGuGG_xyUcYwwFmDu8k40,3690
+altair/utils/_show.py,sha256=cTzcyXgpT2tqkYAH-1tCZm5MZIKyTkYMgsTKQMaViDQ,2261
+altair/utils/_transformed_data.py,sha256=H9V9Na0bAfypMNICazBxIg2ThHRnI9IF12Zc7UPYzL4,18128
+altair/utils/_vegafusion_data.py,sha256=44-iwwhz_BOwxZxSXjGRS3NUNZsRvmbYVhqAEENrnSQ,8205
+altair/utils/compiler.py,sha256=Gku2l4Z6xI_Ei7J1j4MOk_WEE9rhrp1OuoFCcnB9_BU,396
+altair/utils/core.py,sha256=wAHj3qgGWeMMp4Wy1oOE-tAShhKAkbWpoe54XSSd52A,27776
+altair/utils/data.py,sha256=Sm7q4SrBKuLRnqqYaX02WB5nptEtoK0Yx-1uwhzm_iA,13030
+altair/utils/deprecation.py,sha256=AJ-3kdQB7pvWbyDxl5ZUiZoM3O-UpI3X9BOcgzuXmG4,1785
+altair/utils/display.py,sha256=RKK09oNUWN91mWBa77U8RRMe5doz-JygH25KxXjZux0,8852
+altair/utils/execeval.py,sha256=cTpnWPGVPUAnM8mqs1t5a6l9Bp9bnZWPjwa8_mKFvLo,1423
+altair/utils/html.py,sha256=9RYtr0llnf39titWJgRNbaT98m5Zp_GZcqW10izItyw,9843
+altair/utils/mimebundle.py,sha256=Rbs4f_gg3kSEK_zhG98P8Jr_o29U9cwGTN7Bbu1C5Nc,12178
+altair/utils/plugin_registry.py,sha256=l8o0mghMeamhhLfebKVeerH2NQr3KCG7rJLZDncUKQM,7936
+altair/utils/save.py,sha256=CD8yttjyjORGxLb7cyjEcbcM_2tGNGjWJdO1dk0VAaU,8004
+altair/utils/schemapi.py,sha256=Ib1qyv2qN_NllogJ0Bd5qkRLIgxWbse7VFOzXXGsRtQ,52252
+altair/utils/selection.py,sha256=T46Lv1KqSIjgSvKY6FcMa9LQ8rdIS--9ZfN5ZhTvU4E,4175
+altair/utils/server.py,sha256=le_OAjvz0kh-6p_OclWUTpOMaPYjbvYCP1yRR4iPqLs,4076
+altair/utils/theme.py,sha256=b1VS--VOilgE8hrw05-DjIz_d5ND8qVqTrT-OWTqD_Y,221
+altair/vegalite/__init__.py,sha256=BRCDyXuwAljV_GeiifreqCgCl1fevqeww1qGAnGTfQ4,31
+altair/vegalite/__pycache__/__init__.cpython-311.pyc,,
+altair/vegalite/__pycache__/api.cpython-311.pyc,,
+altair/vegalite/__pycache__/data.cpython-311.pyc,,
+altair/vegalite/__pycache__/display.cpython-311.pyc,,
+altair/vegalite/__pycache__/schema.cpython-311.pyc,,
+altair/vegalite/api.py,sha256=kZEoyq1nKhFNTcW6GRMyv7NYlQXqcpFuZ3m8eRApmEg,35
+altair/vegalite/data.py,sha256=zl1fVhwEpXQYWxrTAp6UlHIQe565thPpaMtMX-jG2Hs,1190
+altair/vegalite/display.py,sha256=2mpJo3ZRZYjtvzTKgJcBwq6MpZIrWdZLMCU377bpIlY,357
+altair/vegalite/schema.py,sha256=DsBPJA_bpac1CFyYhnsynqatGtQ38ZOSFhaef7DHTE8,68
+altair/vegalite/v5/__init__.py,sha256=-f54c8F5P2CjACqRWyQvqduejoZluEgBYuxd_BhCPVA,379
+altair/vegalite/v5/__pycache__/__init__.cpython-311.pyc,,
+altair/vegalite/v5/__pycache__/api.cpython-311.pyc,,
+altair/vegalite/v5/__pycache__/compiler.cpython-311.pyc,,
+altair/vegalite/v5/__pycache__/data.cpython-311.pyc,,
+altair/vegalite/v5/__pycache__/display.cpython-311.pyc,,
+altair/vegalite/v5/__pycache__/theme.cpython-311.pyc,,
+altair/vegalite/v5/api.py,sha256=2EsZuC0jeLBU5S0C_jvM3D9QeqIg4XkdflkBHKaV3AM,156055
+altair/vegalite/v5/compiler.py,sha256=ykOlGGV0PATiars7wg7_gnIBHWWpoTb_qUGBRmwoeWo,818
+altair/vegalite/v5/data.py,sha256=7kq6diO8u_SPzcCL7BvCAK6T961WfVgf2cuEnFL8H4c,1114
+altair/vegalite/v5/display.py,sha256=NuGhNKi--Bv5y5mUiPqoezT5mHrvmkkyCDrGAdFstYg,5659
+altair/vegalite/v5/schema/__init__.py,sha256=bSrsoSMf46OAK6V0yOzLBtKXPMTmGv3icAZHbbUiUIo,183
+altair/vegalite/v5/schema/__pycache__/__init__.cpython-311.pyc,,
+altair/vegalite/v5/schema/__pycache__/channels.cpython-311.pyc,,
+altair/vegalite/v5/schema/__pycache__/core.cpython-311.pyc,,
+altair/vegalite/v5/schema/__pycache__/mixins.cpython-311.pyc,,
+altair/vegalite/v5/schema/channels.py,sha256=oLXWKpAh9rQ0LBEG5hb65GkuSKeM0uSpdptONg8xwKc,2784087
+altair/vegalite/v5/schema/core.py,sha256=30bcwQyCewxFdTutH7oW2VREIf4ER_n_9yRAdFIb0Do,2157102
+altair/vegalite/v5/schema/mixins.py,sha256=04grHxBE8iphRmUrD73pcQ2whg9DSJ--YwYiNwdVO48,443354
+altair/vegalite/v5/schema/vega-lite-schema.json,sha256=8B1wGe1jk6DdjWmpkL1Z5alpIRCJSzPfOTsSXtA13xg,1817604
+altair/vegalite/v5/theme.py,sha256=MFElxfYfnMkpd58XY14nroBasuTZZ49fC6SsQEmBc58,1532
diff --git a/llm/Lib/site-packages/altair-5.3.0.dist-info/REQUESTED b/llm/Lib/site-packages/altair-5.3.0.dist-info/REQUESTED
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/altair-5.3.0.dist-info/WHEEL b/llm/Lib/site-packages/altair-5.3.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..0309176f93ce82503b6ac764edadacb3d3127758
--- /dev/null
+++ b/llm/Lib/site-packages/altair-5.3.0.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.22.4
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/altair-5.3.0.dist-info/licenses/LICENSE b/llm/Lib/site-packages/altair-5.3.0.dist-info/licenses/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..03635b4b1fb676f7e1ec7bc286345228cfca78ee
--- /dev/null
+++ b/llm/Lib/site-packages/altair-5.3.0.dist-info/licenses/LICENSE
@@ -0,0 +1,28 @@
+Copyright (c) 2015-2023, Vega-Altair Developers
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of vega-altair nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
diff --git a/llm/Lib/site-packages/altair/__init__.py b/llm/Lib/site-packages/altair/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7c792d3f51a73c8e9fe67aa459fe02455e7bea0
--- /dev/null
+++ b/llm/Lib/site-packages/altair/__init__.py
@@ -0,0 +1,627 @@
+# ruff: noqa
+__version__ = "5.3.0"
+
+from typing import Any
+
+# Necessary as mypy would see expr as the module alt.expr although due to how
+# the imports are set up it is expr in the alt.expr module
+expr: Any
+
+
+# The content of __all__ is automatically written by
+# tools/update_init_file.py. Do not modify directly.
+__all__ = [
+    "Aggregate",
+    "AggregateOp",
+    "AggregateTransform",
+    "AggregatedFieldDef",
+    "Align",
+    "AllSortString",
+    "Angle",
+    "AngleDatum",
+    "AngleValue",
+    "AnyMark",
+    "AnyMarkConfig",
+    "AreaConfig",
+    "ArgmaxDef",
+    "ArgminDef",
+    "AutoSizeParams",
+    "AutosizeType",
+    "Axis",
+    "AxisConfig",
+    "AxisOrient",
+    "AxisResolveMap",
+    "BBox",
+    "BarConfig",
+    "BaseTitleNoValueRefs",
+    "Baseline",
+    "Bin",
+    "BinExtent",
+    "BinParams",
+    "BinTransform",
+    "BindCheckbox",
+    "BindDirect",
+    "BindInput",
+    "BindRadioSelect",
+    "BindRange",
+    "Binding",
+    "BinnedTimeUnit",
+    "Blend",
+    "BoxPlot",
+    "BoxPlotConfig",
+    "BoxPlotDef",
+    "BrushConfig",
+    "CalculateTransform",
+    "Categorical",
+    "Chart",
+    "ChartDataType",
+    "Color",
+    "ColorDatum",
+    "ColorDef",
+    "ColorName",
+    "ColorScheme",
+    "ColorValue",
+    "Column",
+    "CompositeMark",
+    "CompositeMarkDef",
+    "CompositionConfig",
+    "ConcatChart",
+    "ConcatSpecGenericSpec",
+    "ConditionalAxisColor",
+    "ConditionalAxisLabelAlign",
+    "ConditionalAxisLabelBaseline",
+    "ConditionalAxisLabelFontStyle",
+    "ConditionalAxisLabelFontWeight",
+    "ConditionalAxisNumber",
+    "ConditionalAxisNumberArray",
+    "ConditionalAxisPropertyAlignnull",
+    "ConditionalAxisPropertyColornull",
+    "ConditionalAxisPropertyFontStylenull",
+    "ConditionalAxisPropertyFontWeightnull",
+    "ConditionalAxisPropertyTextBaselinenull",
+    "ConditionalAxisPropertynumberArraynull",
+    "ConditionalAxisPropertynumbernull",
+    "ConditionalAxisPropertystringnull",
+    "ConditionalAxisString",
+    "ConditionalMarkPropFieldOrDatumDef",
+    "ConditionalMarkPropFieldOrDatumDefTypeForShape",
+    "ConditionalParameterMarkPropFieldOrDatumDef",
+    "ConditionalParameterMarkPropFieldOrDatumDefTypeForShape",
+    "ConditionalParameterStringFieldDef",
+    "ConditionalParameterValueDefGradientstringnullExprRef",
+    "ConditionalParameterValueDefTextExprRef",
+    "ConditionalParameterValueDefnumber",
+    "ConditionalParameterValueDefnumberArrayExprRef",
+    "ConditionalParameterValueDefnumberExprRef",
+    "ConditionalParameterValueDefstringExprRef",
+    "ConditionalParameterValueDefstringnullExprRef",
+    "ConditionalPredicateMarkPropFieldOrDatumDef",
+    "ConditionalPredicateMarkPropFieldOrDatumDefTypeForShape",
+    "ConditionalPredicateStringFieldDef",
+    "ConditionalPredicateValueDefAlignnullExprRef",
+    "ConditionalPredicateValueDefColornullExprRef",
+    "ConditionalPredicateValueDefFontStylenullExprRef",
+    "ConditionalPredicateValueDefFontWeightnullExprRef",
+    "ConditionalPredicateValueDefGradientstringnullExprRef",
+    "ConditionalPredicateValueDefTextBaselinenullExprRef",
+    "ConditionalPredicateValueDefTextExprRef",
+    "ConditionalPredicateValueDefnumber",
+    "ConditionalPredicateValueDefnumberArrayExprRef",
+    "ConditionalPredicateValueDefnumberArraynullExprRef",
+    "ConditionalPredicateValueDefnumberExprRef",
+    "ConditionalPredicateValueDefnumbernullExprRef",
+    "ConditionalPredicateValueDefstringExprRef",
+    "ConditionalPredicateValueDefstringnullExprRef",
+    "ConditionalStringFieldDef",
+    "ConditionalValueDefGradientstringnullExprRef",
+    "ConditionalValueDefTextExprRef",
+    "ConditionalValueDefnumber",
+    "ConditionalValueDefnumberArrayExprRef",
+    "ConditionalValueDefnumberExprRef",
+    "ConditionalValueDefstringExprRef",
+    "ConditionalValueDefstringnullExprRef",
+    "Config",
+    "CsvDataFormat",
+    "Cursor",
+    "Cyclical",
+    "Data",
+    "DataFormat",
+    "DataFrameLike",
+    "DataSource",
+    "DataType",
+    "Datasets",
+    "DateTime",
+    "DatumChannelMixin",
+    "DatumDef",
+    "Day",
+    "DensityTransform",
+    "DerivedStream",
+    "Description",
+    "DescriptionValue",
+    "Detail",
+    "Dict",
+    "DictInlineDataset",
+    "DictSelectionInit",
+    "DictSelectionInitInterval",
+    "Diverging",
+    "DomainUnionWith",
+    "DsvDataFormat",
+    "Element",
+    "Encoding",
+    "EncodingSortField",
+    "ErrorBand",
+    "ErrorBandConfig",
+    "ErrorBandDef",
+    "ErrorBar",
+    "ErrorBarConfig",
+    "ErrorBarDef",
+    "ErrorBarExtent",
+    "EventStream",
+    "EventType",
+    "Expr",
+    "ExprRef",
+    "ExtentTransform",
+    "Facet",
+    "FacetChart",
+    "FacetEncodingFieldDef",
+    "FacetFieldDef",
+    "FacetMapping",
+    "FacetSpec",
+    "FacetedEncoding",
+    "FacetedUnitSpec",
+    "Feature",
+    "FeatureCollection",
+    "FeatureGeometryGeoJsonProperties",
+    "Field",
+    "FieldChannelMixin",
+    "FieldDefWithoutScale",
+    "FieldEqualPredicate",
+    "FieldGTEPredicate",
+    "FieldGTPredicate",
+    "FieldLTEPredicate",
+    "FieldLTPredicate",
+    "FieldName",
+    "FieldOneOfPredicate",
+    "FieldOrDatumDefWithConditionDatumDefGradientstringnull",
+    "FieldOrDatumDefWithConditionDatumDefnumber",
+    "FieldOrDatumDefWithConditionDatumDefnumberArray",
+    "FieldOrDatumDefWithConditionDatumDefstringnull",
+    "FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull",
+    "FieldOrDatumDefWithConditionMarkPropFieldDefTypeForShapestringnull",
+    "FieldOrDatumDefWithConditionMarkPropFieldDefnumber",
+    "FieldOrDatumDefWithConditionMarkPropFieldDefnumberArray",
+    "FieldOrDatumDefWithConditionStringDatumDefText",
+    "FieldOrDatumDefWithConditionStringFieldDefText",
+    "FieldOrDatumDefWithConditionStringFieldDefstring",
+    "FieldRange",
+    "FieldRangePredicate",
+    "FieldValidPredicate",
+    "Fill",
+    "FillDatum",
+    "FillOpacity",
+    "FillOpacityDatum",
+    "FillOpacityValue",
+    "FillValue",
+    "FilterTransform",
+    "Fit",
+    "FlattenTransform",
+    "FoldTransform",
+    "FontStyle",
+    "FontWeight",
+    "FormatConfig",
+    "Generator",
+    "GenericUnitSpecEncodingAnyMark",
+    "GeoJsonFeature",
+    "GeoJsonFeatureCollection",
+    "GeoJsonProperties",
+    "Geometry",
+    "GeometryCollection",
+    "Gradient",
+    "GradientStop",
+    "GraticuleGenerator",
+    "GraticuleParams",
+    "HConcatChart",
+    "HConcatSpecGenericSpec",
+    "Header",
+    "HeaderConfig",
+    "HexColor",
+    "Href",
+    "HrefValue",
+    "Impute",
+    "ImputeMethod",
+    "ImputeParams",
+    "ImputeSequence",
+    "ImputeTransform",
+    "InlineData",
+    "InlineDataset",
+    "Interpolate",
+    "IntervalSelectionConfig",
+    "IntervalSelectionConfigWithoutType",
+    "JoinAggregateFieldDef",
+    "JoinAggregateTransform",
+    "JsonDataFormat",
+    "JupyterChart",
+    "Key",
+    "LabelOverlap",
+    "LatLongDef",
+    "LatLongFieldDef",
+    "Latitude",
+    "Latitude2",
+    "Latitude2Datum",
+    "Latitude2Value",
+    "LatitudeDatum",
+    "LayerChart",
+    "LayerRepeatMapping",
+    "LayerRepeatSpec",
+    "LayerSpec",
+    "LayoutAlign",
+    "Legend",
+    "LegendBinding",
+    "LegendConfig",
+    "LegendOrient",
+    "LegendResolveMap",
+    "LegendStreamBinding",
+    "LineConfig",
+    "LineString",
+    "LinearGradient",
+    "LocalMultiTimeUnit",
+    "LocalSingleTimeUnit",
+    "Locale",
+    "LoessTransform",
+    "LogicalAndPredicate",
+    "LogicalNotPredicate",
+    "LogicalOrPredicate",
+    "Longitude",
+    "Longitude2",
+    "Longitude2Datum",
+    "Longitude2Value",
+    "LongitudeDatum",
+    "LookupData",
+    "LookupSelection",
+    "LookupTransform",
+    "Mark",
+    "MarkConfig",
+    "MarkDef",
+    "MarkPropDefGradientstringnull",
+    "MarkPropDefnumber",
+    "MarkPropDefnumberArray",
+    "MarkPropDefstringnullTypeForShape",
+    "MarkType",
+    "MaxRowsError",
+    "MergedStream",
+    "Month",
+    "MultiLineString",
+    "MultiPoint",
+    "MultiPolygon",
+    "MultiTimeUnit",
+    "NamedData",
+    "NonArgAggregateOp",
+    "NonLayerRepeatSpec",
+    "NonNormalizedSpec",
+    "NumberLocale",
+    "NumericArrayMarkPropDef",
+    "NumericMarkPropDef",
+    "OffsetDef",
+    "Opacity",
+    "OpacityDatum",
+    "OpacityValue",
+    "Order",
+    "OrderFieldDef",
+    "OrderOnlyDef",
+    "OrderValue",
+    "OrderValueDef",
+    "Orient",
+    "Orientation",
+    "OverlayMarkDef",
+    "Padding",
+    "Parameter",
+    "ParameterExpression",
+    "ParameterExtent",
+    "ParameterName",
+    "ParameterPredicate",
+    "Parse",
+    "ParseValue",
+    "PivotTransform",
+    "Point",
+    "PointSelectionConfig",
+    "PointSelectionConfigWithoutType",
+    "PolarDef",
+    "Polygon",
+    "Position",
+    "Position2Def",
+    "PositionDatumDef",
+    "PositionDatumDefBase",
+    "PositionDef",
+    "PositionFieldDef",
+    "PositionFieldDefBase",
+    "PositionValueDef",
+    "Predicate",
+    "PredicateComposition",
+    "PrimitiveValue",
+    "Projection",
+    "ProjectionConfig",
+    "ProjectionType",
+    "QuantileTransform",
+    "RadialGradient",
+    "Radius",
+    "Radius2",
+    "Radius2Datum",
+    "Radius2Value",
+    "RadiusDatum",
+    "RadiusValue",
+    "RangeConfig",
+    "RangeEnum",
+    "RangeRaw",
+    "RangeRawArray",
+    "RangeScheme",
+    "RectConfig",
+    "RegressionTransform",
+    "RelativeBandSize",
+    "RepeatChart",
+    "RepeatMapping",
+    "RepeatRef",
+    "RepeatSpec",
+    "Resolve",
+    "ResolveMode",
+    "Root",
+    "Row",
+    "RowColLayoutAlign",
+    "RowColboolean",
+    "RowColnumber",
+    "RowColumnEncodingFieldDef",
+    "SCHEMA_URL",
+    "SCHEMA_VERSION",
+    "SampleTransform",
+    "Scale",
+    "ScaleBinParams",
+    "ScaleBins",
+    "ScaleConfig",
+    "ScaleDatumDef",
+    "ScaleFieldDef",
+    "ScaleInterpolateEnum",
+    "ScaleInterpolateParams",
+    "ScaleResolveMap",
+    "ScaleType",
+    "SchemaBase",
+    "SchemeParams",
+    "SecondaryFieldDef",
+    "SelectionConfig",
+    "SelectionExpression",
+    "SelectionInit",
+    "SelectionInitInterval",
+    "SelectionInitIntervalMapping",
+    "SelectionInitMapping",
+    "SelectionParameter",
+    "SelectionPredicateComposition",
+    "SelectionResolution",
+    "SelectionType",
+    "SequenceGenerator",
+    "SequenceParams",
+    "SequentialMultiHue",
+    "SequentialSingleHue",
+    "Shape",
+    "ShapeDatum",
+    "ShapeDef",
+    "ShapeValue",
+    "SharedEncoding",
+    "SingleDefUnitChannel",
+    "SingleTimeUnit",
+    "Size",
+    "SizeDatum",
+    "SizeValue",
+    "Sort",
+    "SortArray",
+    "SortByChannel",
+    "SortByChannelDesc",
+    "SortByEncoding",
+    "SortField",
+    "SortOrder",
+    "Spec",
+    "SphereGenerator",
+    "StackOffset",
+    "StackTransform",
+    "StandardType",
+    "Step",
+    "StepFor",
+    "Stream",
+    "StringFieldDef",
+    "StringFieldDefWithCondition",
+    "StringValueDefWithCondition",
+    "Stroke",
+    "StrokeCap",
+    "StrokeDash",
+    "StrokeDashDatum",
+    "StrokeDashValue",
+    "StrokeDatum",
+    "StrokeJoin",
+    "StrokeOpacity",
+    "StrokeOpacityDatum",
+    "StrokeOpacityValue",
+    "StrokeValue",
+    "StrokeWidth",
+    "StrokeWidthDatum",
+    "StrokeWidthValue",
+    "StyleConfigIndex",
+    "SymbolShape",
+    "TOPLEVEL_ONLY_KEYS",
+    "Text",
+    "TextBaseline",
+    "TextDatum",
+    "TextDef",
+    "TextDirection",
+    "TextValue",
+    "Theta",
+    "Theta2",
+    "Theta2Datum",
+    "Theta2Value",
+    "ThetaDatum",
+    "ThetaValue",
+    "TickConfig",
+    "TickCount",
+    "TimeInterval",
+    "TimeIntervalStep",
+    "TimeLocale",
+    "TimeUnit",
+    "TimeUnitParams",
+    "TimeUnitTransform",
+    "TimeUnitTransformParams",
+    "Title",
+    "TitleAnchor",
+    "TitleConfig",
+    "TitleFrame",
+    "TitleOrient",
+    "TitleParams",
+    "Tooltip",
+    "TooltipContent",
+    "TooltipValue",
+    "TopLevelConcatSpec",
+    "TopLevelFacetSpec",
+    "TopLevelHConcatSpec",
+    "TopLevelLayerSpec",
+    "TopLevelMixin",
+    "TopLevelParameter",
+    "TopLevelRepeatSpec",
+    "TopLevelSelectionParameter",
+    "TopLevelSpec",
+    "TopLevelUnitSpec",
+    "TopLevelVConcatSpec",
+    "TopoDataFormat",
+    "Transform",
+    "Type",
+    "TypeForShape",
+    "TypedFieldDef",
+    "URI",
+    "Undefined",
+    "UndefinedType",
+    "UnitSpec",
+    "UnitSpecWithFrame",
+    "Url",
+    "UrlData",
+    "UrlValue",
+    "UtcMultiTimeUnit",
+    "UtcSingleTimeUnit",
+    "VConcatChart",
+    "VConcatSpecGenericSpec",
+    "VEGAEMBED_VERSION",
+    "VEGALITE_VERSION",
+    "VEGA_VERSION",
+    "ValueChannelMixin",
+    "ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull",
+    "ValueDefWithConditionMarkPropFieldOrDatumDefTypeForShapestringnull",
+    "ValueDefWithConditionMarkPropFieldOrDatumDefnumber",
+    "ValueDefWithConditionMarkPropFieldOrDatumDefnumberArray",
+    "ValueDefWithConditionMarkPropFieldOrDatumDefstringnull",
+    "ValueDefWithConditionStringFieldDefText",
+    "ValueDefnumber",
+    "ValueDefnumberwidthheightExprRef",
+    "VariableParameter",
+    "Vector10string",
+    "Vector12string",
+    "Vector2DateTime",
+    "Vector2Vector2number",
+    "Vector2boolean",
+    "Vector2number",
+    "Vector2string",
+    "Vector3number",
+    "Vector7string",
+    "VegaLite",
+    "VegaLiteSchema",
+    "ViewBackground",
+    "ViewConfig",
+    "WindowEventType",
+    "WindowFieldDef",
+    "WindowOnlyOp",
+    "WindowTransform",
+    "X",
+    "X2",
+    "X2Datum",
+    "X2Value",
+    "XDatum",
+    "XError",
+    "XError2",
+    "XError2Value",
+    "XErrorValue",
+    "XOffset",
+    "XOffsetDatum",
+    "XOffsetValue",
+    "XValue",
+    "Y",
+    "Y2",
+    "Y2Datum",
+    "Y2Value",
+    "YDatum",
+    "YError",
+    "YError2",
+    "YError2Value",
+    "YErrorValue",
+    "YOffset",
+    "YOffsetDatum",
+    "YOffsetValue",
+    "YValue",
+    "api",
+    "binding",
+    "binding_checkbox",
+    "binding_radio",
+    "binding_range",
+    "binding_select",
+    "channels",
+    "check_fields_and_encodings",
+    "compiler",
+    "concat",
+    "condition",
+    "core",
+    "curry",
+    "data",
+    "data_transformers",
+    "datum",
+    "default_data_transformer",
+    "display",
+    "expr",
+    "graticule",
+    "hconcat",
+    "jupyter",
+    "layer",
+    "limit_rows",
+    "load_ipython_extension",
+    "load_schema",
+    "mixins",
+    "overload",
+    "param",
+    "parse_shorthand",
+    "pipe",
+    "renderers",
+    "repeat",
+    "sample",
+    "schema",
+    "selection_interval",
+    "selection_point",
+    "sequence",
+    "sphere",
+    "theme",
+    "themes",
+    "to_csv",
+    "to_json",
+    "to_values",
+    "topo_feature",
+    "utils",
+    "v5",
+    "value",
+    "vconcat",
+    "vegalite",
+    "vegalite_compilers",
+    "with_property_setters",
+]
+
+
+def __dir__():
+    return __all__
+
+
+from .vegalite import *
+from .jupyter import JupyterChart
+
+
+def load_ipython_extension(ipython):
+    from ._magics import vegalite
+
+    ipython.register_magic_function(vegalite, "cell")
diff --git a/llm/Lib/site-packages/altair/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/altair/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dcc140d21ab43607361477394b92ca91c139a6af
Binary files /dev/null and b/llm/Lib/site-packages/altair/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/__pycache__/_magics.cpython-311.pyc b/llm/Lib/site-packages/altair/__pycache__/_magics.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0bd1ac9480ccfcd5bc02c8cd73a10675b4d48487
Binary files /dev/null and b/llm/Lib/site-packages/altair/__pycache__/_magics.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/_magics.py b/llm/Lib/site-packages/altair/_magics.py
new file mode 100644
index 0000000000000000000000000000000000000000..bac190aa321b9f8bdd86a0107911b2fe718957f8
--- /dev/null
+++ b/llm/Lib/site-packages/altair/_magics.py
@@ -0,0 +1,109 @@
+"""
+Magic functions for rendering vega-lite specifications
+"""
+
+__all__ = ["vegalite"]
+
+import json
+import warnings
+
+import IPython
+from IPython.core import magic_arguments
+import pandas as pd
+from toolz import curried
+
+from altair.vegalite import v5 as vegalite_v5
+
+try:
+    import yaml
+
+    YAML_AVAILABLE = True
+except ImportError:
+    YAML_AVAILABLE = False
+
+
+RENDERERS = {
+    "vega-lite": {
+        "5": vegalite_v5.VegaLite,
+    },
+}
+
+
+TRANSFORMERS = {
+    "vega-lite": {
+        "5": vegalite_v5.data_transformers,
+    },
+}
+
+
+def _prepare_data(data, data_transformers):
+    """Convert input data to data for use within schema"""
+    if data is None or isinstance(data, dict):
+        return data
+    elif isinstance(data, pd.DataFrame):
+        return curried.pipe(data, data_transformers.get())
+    elif isinstance(data, str):
+        return {"url": data}
+    else:
+        warnings.warn("data of type {} not recognized".format(type(data)), stacklevel=1)
+        return data
+
+
+def _get_variable(name):
+    """Get a variable from the notebook namespace."""
+    ip = IPython.get_ipython()
+    if ip is None:
+        raise ValueError(
+            "Magic command must be run within an IPython "
+            "environment, in which get_ipython() is defined."
+        )
+    if name not in ip.user_ns:
+        raise NameError(
+            "argument '{}' does not match the name of any defined variable".format(name)
+        )
+    return ip.user_ns[name]
+
+
+@magic_arguments.magic_arguments()
+@magic_arguments.argument(
+    "data",
+    nargs="?",
+    help="local variablename of a pandas DataFrame to be used as the dataset",
+)
+@magic_arguments.argument("-v", "--version", dest="version", default="v5")
+@magic_arguments.argument("-j", "--json", dest="json", action="store_true")
+def vegalite(line, cell):
+    """Cell magic for displaying vega-lite visualizations in CoLab.
+
+    %%vegalite [dataframe] [--json] [--version='v5']
+
+    Visualize the contents of the cell using Vega-Lite, optionally
+    specifying a pandas DataFrame object to be used as the dataset.
+
+    if --json is passed, then input is parsed as json rather than yaml.
+    """
+    args = magic_arguments.parse_argstring(vegalite, line)
+    existing_versions = {"v5": "5"}
+    version = existing_versions[args.version]
+    assert version in RENDERERS["vega-lite"]
+    VegaLite = RENDERERS["vega-lite"][version]
+    data_transformers = TRANSFORMERS["vega-lite"][version]
+
+    if args.json:
+        spec = json.loads(cell)
+    elif not YAML_AVAILABLE:
+        try:
+            spec = json.loads(cell)
+        except json.JSONDecodeError as err:
+            raise ValueError(
+                "%%vegalite: spec is not valid JSON. "
+                "Install pyyaml to parse spec as yaml"
+            ) from err
+    else:
+        spec = yaml.load(cell, Loader=yaml.SafeLoader)
+
+    if args.data is not None:
+        data = _get_variable(args.data)
+        spec["data"] = _prepare_data(data, data_transformers)
+
+    return VegaLite(spec)
diff --git a/llm/Lib/site-packages/altair/expr/__init__.py b/llm/Lib/site-packages/altair/expr/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..64916fe2bac46f86dded12948cf2174965df3fc8
--- /dev/null
+++ b/llm/Lib/site-packages/altair/expr/__init__.py
@@ -0,0 +1,20 @@
+"""Tools for creating transform & filter expressions with a python syntax"""
+
+# ruff: noqa
+from typing import Any
+
+from .core import datum, Expression
+from .funcs import *
+from .consts import *
+from ..vegalite.v5.schema.core import ExprRef as _ExprRef
+
+
+class _ExprType:
+    def __init__(self, expr):
+        vars(self).update(expr)
+
+    def __call__(self, expr, **kwargs):
+        return _ExprRef(expr, **kwargs)
+
+
+expr: Any = _ExprType(globals())
diff --git a/llm/Lib/site-packages/altair/expr/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/altair/expr/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7d15ad478be0c645eff4634273bf6103266ef1c5
Binary files /dev/null and b/llm/Lib/site-packages/altair/expr/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/expr/__pycache__/consts.cpython-311.pyc b/llm/Lib/site-packages/altair/expr/__pycache__/consts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..39b7a45eceeeae65193b1351e9f327d47656f79b
Binary files /dev/null and b/llm/Lib/site-packages/altair/expr/__pycache__/consts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/expr/__pycache__/core.cpython-311.pyc b/llm/Lib/site-packages/altair/expr/__pycache__/core.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b6a7a707c911204471a58993369d0f9df69579d2
Binary files /dev/null and b/llm/Lib/site-packages/altair/expr/__pycache__/core.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/expr/__pycache__/funcs.cpython-311.pyc b/llm/Lib/site-packages/altair/expr/__pycache__/funcs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..540ba2b266f5c90d3468547e4d7a48b461429b48
Binary files /dev/null and b/llm/Lib/site-packages/altair/expr/__pycache__/funcs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/expr/consts.py b/llm/Lib/site-packages/altair/expr/consts.py
new file mode 100644
index 0000000000000000000000000000000000000000..974fb06a3c756a7e27106f4d1bb9c17b78a094fd
--- /dev/null
+++ b/llm/Lib/site-packages/altair/expr/consts.py
@@ -0,0 +1,29 @@
+from typing import Dict
+
+from .core import ConstExpression
+
+
+CONST_LISTING = {
+    "NaN": "not a number (same as JavaScript literal NaN)",
+    "LN10": "the natural log of 10 (alias to Math.LN10)",
+    "E": "the transcendental number e (alias to Math.E)",
+    "LOG10E": "the base 10 logarithm e (alias to Math.LOG10E)",
+    "LOG2E": "the base 2 logarithm of e (alias to Math.LOG2E)",
+    "SQRT1_2": "the square root of 0.5 (alias to Math.SQRT1_2)",
+    "LN2": "the natural log of 2 (alias to Math.LN2)",
+    "SQRT2": "the square root of 2 (alias to Math.SQRT1_2)",
+    "PI": "the transcendental number pi (alias to Math.PI)",
+}
+
+NAME_MAP: Dict[str, str] = {}
+
+
+def _populate_namespace():
+    globals_ = globals()
+    for name, doc in CONST_LISTING.items():
+        py_name = NAME_MAP.get(name, name)
+        globals_[py_name] = ConstExpression(name, doc)
+        yield py_name
+
+
+__all__ = list(_populate_namespace())
diff --git a/llm/Lib/site-packages/altair/expr/core.py b/llm/Lib/site-packages/altair/expr/core.py
new file mode 100644
index 0000000000000000000000000000000000000000..9cc258c8b723613453d4033c85035e335a537318
--- /dev/null
+++ b/llm/Lib/site-packages/altair/expr/core.py
@@ -0,0 +1,234 @@
+from ..utils import SchemaBase
+
+
+class DatumType:
+    """An object to assist in building Vega-Lite Expressions"""
+
+    def __repr__(self):
+        return "datum"
+
+    def __getattr__(self, attr):
+        if attr.startswith("__") and attr.endswith("__"):
+            raise AttributeError(attr)
+        return GetAttrExpression("datum", attr)
+
+    def __getitem__(self, attr):
+        return GetItemExpression("datum", attr)
+
+    def __call__(self, datum, **kwargs):
+        """Specify a datum for use in an encoding"""
+        return dict(datum=datum, **kwargs)
+
+
+datum = DatumType()
+
+
+def _js_repr(val):
+    """Return a javascript-safe string representation of val"""
+    if val is True:
+        return "true"
+    elif val is False:
+        return "false"
+    elif val is None:
+        return "null"
+    elif isinstance(val, OperatorMixin):
+        return val._to_expr()
+    else:
+        return repr(val)
+
+
+# Designed to work with Expression and VariableParameter
+class OperatorMixin:
+    def _to_expr(self):
+        return repr(self)
+
+    def _from_expr(self, expr):
+        return expr
+
+    def __add__(self, other):
+        comp_value = BinaryExpression("+", self, other)
+        return self._from_expr(comp_value)
+
+    def __radd__(self, other):
+        comp_value = BinaryExpression("+", other, self)
+        return self._from_expr(comp_value)
+
+    def __sub__(self, other):
+        comp_value = BinaryExpression("-", self, other)
+        return self._from_expr(comp_value)
+
+    def __rsub__(self, other):
+        comp_value = BinaryExpression("-", other, self)
+        return self._from_expr(comp_value)
+
+    def __mul__(self, other):
+        comp_value = BinaryExpression("*", self, other)
+        return self._from_expr(comp_value)
+
+    def __rmul__(self, other):
+        comp_value = BinaryExpression("*", other, self)
+        return self._from_expr(comp_value)
+
+    def __truediv__(self, other):
+        comp_value = BinaryExpression("/", self, other)
+        return self._from_expr(comp_value)
+
+    def __rtruediv__(self, other):
+        comp_value = BinaryExpression("/", other, self)
+        return self._from_expr(comp_value)
+
+    __div__ = __truediv__
+
+    __rdiv__ = __rtruediv__
+
+    def __mod__(self, other):
+        comp_value = BinaryExpression("%", self, other)
+        return self._from_expr(comp_value)
+
+    def __rmod__(self, other):
+        comp_value = BinaryExpression("%", other, self)
+        return self._from_expr(comp_value)
+
+    def __pow__(self, other):
+        # "**" Javascript operator is not supported in all browsers
+        comp_value = FunctionExpression("pow", (self, other))
+        return self._from_expr(comp_value)
+
+    def __rpow__(self, other):
+        # "**" Javascript operator is not supported in all browsers
+        comp_value = FunctionExpression("pow", (other, self))
+        return self._from_expr(comp_value)
+
+    def __neg__(self):
+        comp_value = UnaryExpression("-", self)
+        return self._from_expr(comp_value)
+
+    def __pos__(self):
+        comp_value = UnaryExpression("+", self)
+        return self._from_expr(comp_value)
+
+    # comparison operators
+
+    def __eq__(self, other):
+        comp_value = BinaryExpression("===", self, other)
+        return self._from_expr(comp_value)
+
+    def __ne__(self, other):
+        comp_value = BinaryExpression("!==", self, other)
+        return self._from_expr(comp_value)
+
+    def __gt__(self, other):
+        comp_value = BinaryExpression(">", self, other)
+        return self._from_expr(comp_value)
+
+    def __lt__(self, other):
+        comp_value = BinaryExpression("<", self, other)
+        return self._from_expr(comp_value)
+
+    def __ge__(self, other):
+        comp_value = BinaryExpression(">=", self, other)
+        return self._from_expr(comp_value)
+
+    def __le__(self, other):
+        comp_value = BinaryExpression("<=", self, other)
+        return self._from_expr(comp_value)
+
+    def __abs__(self):
+        comp_value = FunctionExpression("abs", (self,))
+        return self._from_expr(comp_value)
+
+    # logical operators
+
+    def __and__(self, other):
+        comp_value = BinaryExpression("&&", self, other)
+        return self._from_expr(comp_value)
+
+    def __rand__(self, other):
+        comp_value = BinaryExpression("&&", other, self)
+        return self._from_expr(comp_value)
+
+    def __or__(self, other):
+        comp_value = BinaryExpression("||", self, other)
+        return self._from_expr(comp_value)
+
+    def __ror__(self, other):
+        comp_value = BinaryExpression("||", other, self)
+        return self._from_expr(comp_value)
+
+    def __invert__(self):
+        comp_value = UnaryExpression("!", self)
+        return self._from_expr(comp_value)
+
+
+class Expression(OperatorMixin, SchemaBase):
+    """Expression
+
+    Base object for enabling build-up of Javascript expressions using
+    a Python syntax. Calling ``repr(obj)`` will return a Javascript
+    representation of the object and the operations it encodes.
+    """
+
+    _schema = {"type": "string"}
+
+    def to_dict(self, *args, **kwargs):
+        return repr(self)
+
+    def __setattr__(self, attr, val):
+        # We don't need the setattr magic defined in SchemaBase
+        return object.__setattr__(self, attr, val)
+
+    # item access
+    def __getitem__(self, val):
+        return GetItemExpression(self, val)
+
+
+class UnaryExpression(Expression):
+    def __init__(self, op, val):
+        super(UnaryExpression, self).__init__(op=op, val=val)
+
+    def __repr__(self):
+        return "({op}{val})".format(op=self.op, val=_js_repr(self.val))
+
+
+class BinaryExpression(Expression):
+    def __init__(self, op, lhs, rhs):
+        super(BinaryExpression, self).__init__(op=op, lhs=lhs, rhs=rhs)
+
+    def __repr__(self):
+        return "({lhs} {op} {rhs})".format(
+            op=self.op, lhs=_js_repr(self.lhs), rhs=_js_repr(self.rhs)
+        )
+
+
+class FunctionExpression(Expression):
+    def __init__(self, name, args):
+        super(FunctionExpression, self).__init__(name=name, args=args)
+
+    def __repr__(self):
+        args = ",".join(_js_repr(arg) for arg in self.args)
+        return "{name}({args})".format(name=self.name, args=args)
+
+
+class ConstExpression(Expression):
+    def __init__(self, name, doc):
+        self.__doc__ = """{}: {}""".format(name, doc)
+        super(ConstExpression, self).__init__(name=name, doc=doc)
+
+    def __repr__(self):
+        return str(self.name)
+
+
+class GetAttrExpression(Expression):
+    def __init__(self, group, name):
+        super(GetAttrExpression, self).__init__(group=group, name=name)
+
+    def __repr__(self):
+        return "{}.{}".format(self.group, self.name)
+
+
+class GetItemExpression(Expression):
+    def __init__(self, group, name):
+        super(GetItemExpression, self).__init__(group=group, name=name)
+
+    def __repr__(self):
+        return "{}[{!r}]".format(self.group, self.name)
diff --git a/llm/Lib/site-packages/altair/expr/funcs.py b/llm/Lib/site-packages/altair/expr/funcs.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4a73f4c9d118f9c64163086445eb2448630daea
--- /dev/null
+++ b/llm/Lib/site-packages/altair/expr/funcs.py
@@ -0,0 +1,192 @@
+from .core import FunctionExpression
+
+
+FUNCTION_LISTING = {
+    "isArray": r"Returns true if _value_ is an array, false otherwise.",
+    "isBoolean": r"Returns true if _value_ is a boolean (`true` or `false`), false otherwise.",
+    "isDate": r"Returns true if _value_ is a Date object, false otherwise. This method will return false for timestamp numbers or date-formatted strings; it recognizes Date objects only.",
+    "isDefined": r"Returns true if _value_ is a defined value, false if _value_ equals `undefined`. This method will return true for `null` and `NaN` values.",
+    "isNumber": r"Returns true if _value_ is a number, false otherwise. `NaN` and `Infinity` are considered numbers.",
+    "isObject": r"Returns true if _value_ is an object (including arrays and Dates), false otherwise.",
+    "isRegExp": r"Returns true if _value_ is a RegExp (regular expression) object, false otherwise.",
+    "isString": r"Returns true if _value_ is a string, false otherwise.",
+    "isValid": r"Returns true if _value_ is not `null`, `undefined`, or `NaN`, false otherwise.",
+    "toBoolean": r"Coerces the input _value_ to a string. Null values and empty strings are mapped to `null`.",
+    "toDate": r"Coerces the input _value_ to a Date instance. Null values and empty strings are mapped to `null`. If an optional _parser_ function is provided, it is used to perform date parsing, otherwise `Date.parse` is used. Be aware that `Date.parse` has different implementations across browsers!",
+    "toNumber": r"Coerces the input _value_ to a number. Null values and empty strings are mapped to `null`.",
+    "toString": r"Coerces the input _value_ to a string. Null values and empty strings are mapped to `null`.",
+    "if": r"If _test_ is truthy, returns _thenValue_. Otherwise, returns _elseValue_. The _if_ function is equivalent to the ternary operator `a ? b : c`.",
+    "isNaN": r"Returns true if _value_ is not a number. Same as JavaScript's `isNaN`.",
+    "isFinite": r"Returns true if _value_ is a finite number. Same as JavaScript's `isFinite`.",
+    "abs": r"Returns the absolute value of _value_. Same as JavaScript's `Math.abs`.",
+    "acos": r"Trigonometric arccosine. Same as JavaScript's `Math.acos`.",
+    "asin": r"Trigonometric arcsine. Same as JavaScript's `Math.asin`.",
+    "atan": r"Trigonometric arctangent. Same as JavaScript's `Math.atan`.",
+    "atan2": r"Returns the arctangent of _dy / dx_. Same as JavaScript's `Math.atan2`.",
+    "ceil": r"Rounds _value_ to the nearest integer of equal or greater value. Same as JavaScript's `Math.ceil`.",
+    "clamp": r"Restricts _value_ to be between the specified _min_ and _max_.",
+    "cos": r"Trigonometric cosine. Same as JavaScript's `Math.cos`.",
+    "exp": r"Returns the value of _e_ raised to the provided _exponent_. Same as JavaScript's `Math.exp`.",
+    "floor": r"Rounds _value_ to the nearest integer of equal or lower value. Same as JavaScript's `Math.floor`.",
+    "hypot": r"Returns the square root of the sum of squares of its arguments. Same as JavaScript's `Math.hypot`.",
+    "log": r"Returns the natural logarithm of _value_. Same as JavaScript's `Math.log`.",
+    "max": r"Returns the maximum argument value. Same as JavaScript's `Math.max`.",
+    "min": r"Returns the minimum argument value. Same as JavaScript's `Math.min`.",
+    "pow": r"Returns _value_ raised to the given _exponent_. Same as JavaScript's `Math.pow`.",
+    "random": r"Returns a pseudo-random number in the range [0,1). Same as JavaScript's `Math.random`.",
+    "round": r"Rounds _value_ to the nearest integer. Same as JavaScript's `Math.round`.",
+    "sin": r"Trigonometric sine. Same as JavaScript's `Math.sin`.",
+    "sqrt": r"Square root function. Same as JavaScript's `Math.sqrt`.",
+    "tan": r"Trigonometric tangent. Same as JavaScript's `Math.tan`.",
+    "sampleNormal": r"Returns a sample from a univariate [normal (Gaussian) probability distribution](https://en.wikipedia.org/wiki/Normal_distribution) with specified _mean_ and standard deviation _stdev_. If unspecified, the mean defaults to `0` and the standard deviation defaults to `1`.",
+    "cumulativeNormal": r"Returns the value of the [cumulative distribution function](https://en.wikipedia.org/wiki/Cumulative_distribution_function) at the given input domain _value_ for a normal distribution with specified _mean_ and standard deviation _stdev_. If unspecified, the mean defaults to `0` and the standard deviation defaults to `1`.",
+    "densityNormal": r"Returns the value of the [probability density function](https://en.wikipedia.org/wiki/Probability_density_function) at the given input domain _value_, for a normal distribution with specified _mean_ and standard deviation _stdev_. If unspecified, the mean defaults to `0` and the standard deviation defaults to `1`.",
+    "quantileNormal": r"Returns the quantile value (the inverse of the [cumulative distribution function](https://en.wikipedia.org/wiki/Cumulative_distribution_function)) for the given input _probability_, for a normal distribution with specified _mean_ and standard deviation _stdev_. If unspecified, the mean defaults to `0` and the standard deviation defaults to `1`.",
+    "sampleLogNormal": r"Returns a sample from a univariate [log-normal probability distribution](https://en.wikipedia.org/wiki/Log-normal_distribution) with specified log _mean_ and log standard deviation _stdev_. If unspecified, the log mean defaults to `0` and the log standard deviation defaults to `1`.",
+    "cumulativeLogNormal": r"Returns the value of the [cumulative distribution function](https://en.wikipedia.org/wiki/Cumulative_distribution_function) at the given input domain _value_ for a log-normal distribution with specified log _mean_ and log standard deviation _stdev_. If unspecified, the log mean defaults to `0` and the log standard deviation defaults to `1`.",
+    "densityLogNormal": r"Returns the value of the [probability density function](https://en.wikipedia.org/wiki/Probability_density_function) at the given input domain _value_, for a log-normal distribution with specified log _mean_ and log standard deviation _stdev_. If unspecified, the log mean defaults to `0` and the log standard deviation defaults to `1`.",
+    "quantileLogNormal": r"Returns the quantile value (the inverse of the [cumulative distribution function](https://en.wikipedia.org/wiki/Cumulative_distribution_function)) for the given input _probability_, for a log-normal distribution with specified log _mean_ and log standard deviation _stdev_. If unspecified, the log mean defaults to `0` and the log standard deviation defaults to `1`.",
+    "sampleUniform": r"Returns a sample from a univariate [continuous uniform probability distribution](https://en.wikipedia.org/wiki/Uniform_distribution_(continuous)) over the interval [_min_, _max_). If unspecified, _min_ defaults to `0` and _max_ defaults to `1`. If only one argument is provided, it is interpreted as the _max_ value.",
+    "cumulativeUniform": r"Returns the value of the [cumulative distribution function](https://en.wikipedia.org/wiki/Cumulative_distribution_function) at the given input domain _value_ for a uniform distribution over the interval [_min_, _max_). If unspecified, _min_ defaults to `0` and _max_ defaults to `1`. If only one argument is provided, it is interpreted as the _max_ value.",
+    "densityUniform": r"Returns the value of the [probability density function](https://en.wikipedia.org/wiki/Probability_density_function) at the given input domain _value_,  for a uniform distribution over the interval [_min_, _max_). If unspecified, _min_ defaults to `0` and _max_ defaults to `1`. If only one argument is provided, it is interpreted as the _max_ value.",
+    "quantileUniform": r"Returns the quantile value (the inverse of the [cumulative distribution function](https://en.wikipedia.org/wiki/Cumulative_distribution_function)) for the given input _probability_,  for a uniform distribution over the interval [_min_, _max_). If unspecified, _min_ defaults to `0` and _max_ defaults to `1`. If only one argument is provided, it is interpreted as the _max_ value.",
+    "now": r"Returns the timestamp for the current time.",
+    "datetime": r"Returns a new `Date` instance. The _month_ is 0-based, such that `1` represents February.",
+    "date": r"Returns the day of the month for the given _datetime_ value, in local time.",
+    "day": r"Returns the day of the week for the given _datetime_ value, in local time.",
+    "dayofyear": r"Returns the one-based day of the year for the given _datetime_ value, in local time.",
+    "year": r"Returns the year for the given _datetime_ value, in local time.",
+    "quarter": r"Returns the quarter of the year (0-3) for the given _datetime_ value, in local time.",
+    "month": r"Returns the (zero-based) month for the given _datetime_ value, in local time.",
+    "week": r"Returns the week number of the year for the given _datetime_, in local time. This function assumes Sunday-based weeks. Days before the first Sunday of the year are considered to be in week 0, the first Sunday of the year is the start of week 1, the second Sunday week 2, _etc._.",
+    "hours": r"Returns the hours component for the given _datetime_ value, in local time.",
+    "minutes": r"Returns the minutes component for the given _datetime_ value, in local time.",
+    "seconds": r"Returns the seconds component for the given _datetime_ value, in local time.",
+    "milliseconds": r"Returns the milliseconds component for the given _datetime_ value, in local time.",
+    "time": r"Returns the epoch-based timestamp for the given _datetime_ value.",
+    "timezoneoffset": r"Returns the timezone offset from the local timezone to UTC for the given _datetime_ value.",
+    "timeOffset": r"Returns a new `Date` instance that offsets the given _date_ by the specified time [_unit_](../api/time/#time-units) in the local timezone. The optional _step_ argument indicates the number of time unit steps to offset by (default 1).",
+    "timeSequence": r"Returns an array of `Date` instances from _start_ (inclusive) to _stop_ (exclusive), with each entry separated by the given time [_unit_](../api/time/#time-units) in the local timezone. The optional _step_ argument indicates the number of time unit steps to take between each sequence entry (default 1).",
+    "utc": r"Returns a timestamp for the given UTC date. The _month_ is 0-based, such that `1` represents February.",
+    "utcdate": r"Returns the day of the month for the given _datetime_ value, in UTC time.",
+    "utcday": r"Returns the day of the week for the given _datetime_ value, in UTC time.",
+    "utcdayofyear": r"Returns the one-based day of the year for the given _datetime_ value, in UTC time.",
+    "utcyear": r"Returns the year for the given _datetime_ value, in UTC time.",
+    "utcquarter": r"Returns the quarter of the year (0-3) for the given _datetime_ value, in UTC time.",
+    "utcmonth": r"Returns the (zero-based) month for the given _datetime_ value, in UTC time.",
+    "utcweek": r"Returns the week number of the year for the given _datetime_, in UTC time. This function assumes Sunday-based weeks. Days before the first Sunday of the year are considered to be in week 0, the first Sunday of the year is the start of week 1, the second Sunday week 2, _etc._.",
+    "utchours": r"Returns the hours component for the given _datetime_ value, in UTC time.",
+    "utcminutes": r"Returns the minutes component for the given _datetime_ value, in UTC time.",
+    "utcseconds": r"Returns the seconds component for the given _datetime_ value, in UTC time.",
+    "utcmilliseconds": r"Returns the milliseconds component for the given _datetime_ value, in UTC time.",
+    "utcOffset": r"Returns a new `Date` instance that offsets the given _date_ by the specified time [_unit_](../api/time/#time-units) in UTC time. The optional _step_ argument indicates the number of time unit steps to offset by (default 1).",
+    "utcSequence": r"Returns an array of `Date` instances from _start_ (inclusive) to _stop_ (exclusive), with each entry separated by the given time [_unit_](../api/time/#time-units) in UTC time. The optional _step_ argument indicates the number of time unit steps to take between each sequence entry (default 1).",
+    "extent": r"Returns a new _[min, max]_ array with the minimum and maximum values of the input array, ignoring `null`, `undefined`, and `NaN` values.",
+    "clampRange": r"Clamps a two-element _range_ array in a span-preserving manner. If the span of the input _range_ is less than _(max - min)_ and an endpoint exceeds either the _min_ or _max_ value, the range is translated such that the span is preserved and one endpoint touches the boundary of the _[min, max]_ range. If the span exceeds _(max - min)_, the range _[min, max]_ is returned.",
+    "indexof": r"Returns the first index of _value_ in the input _array_, or the first index of _substring_ in the input _string_..",
+    "inrange": r"Tests whether _value_ lies within (or is equal to either) the first and last values of the _range_ array.",
+    "join": r"Returns a new string by concatenating all of the elements of the input _array_, separated by commas or a specified _separator_ string.",
+    "lastindexof": r"Returns the last index of _value_ in the input _array_, or the last index of _substring_ in the input _string_..",
+    "length": r"Returns the length of the input _array_, or the length of the input _string_.",
+    "lerp": r"Returns the linearly interpolated value between the first and last entries in the _array_ for the provided interpolation _fraction_ (typically between 0 and 1). For example, `lerp([0, 50], 0.5)` returns 25.",
+    "peek": r"Returns the last element in the input _array_. Similar to the built-in `Array.pop` method, except that it does not remove the last element. This method is a convenient shorthand for `array[array.length - 1]`.",
+    "pluck": r"Retrieves the value for the specified *field* from a given *array* of objects. The input *field* string may include nested properties (e.g., `foo.bar.bz`).",
+    "reverse": r"Returns a new array with elements in a reverse order of the input _array_. The first array element becomes the last, and the last array element becomes the first.",
+    "sequence": r"Returns an array containing an arithmetic sequence of numbers. If _step_ is omitted, it defaults to 1. If _start_ is omitted, it defaults to 0. The _stop_ value is exclusive; it is not included in the result. If _step_ is positive, the last element is the largest _start + i * step_ less than _stop_; if _step_ is negative, the last element is the smallest _start + i * step_ greater than _stop_. If the returned array would contain an infinite number of values, an empty range is returned. The arguments are not required to be integers.",
+    "slice": r"Returns a section of _array_ between the _start_ and _end_ indices. If the _end_ argument is negative, it is treated as an offset from the end of the array (_length(array) + end_).",
+    "span": r"Returns the span of _array_: the difference between the last and first elements, or _array[array.length-1] - array[0]_. Or if input is a string: a section of _string_ between the _start_ and _end_ indices. If the _end_ argument is negative, it is treated as an offset from the end of the string (_length(string) + end_)..",
+    "lower": r"Transforms _string_ to lower-case letters.",
+    "pad": r"Pads a _string_ value with repeated instances of a _character_ up to a specified _length_. If _character_ is not specified, a space (' ') is used. By default, padding is added to the end of a string. An optional _align_ parameter specifies if padding should be added to the `'left'` (beginning), `'center'`, or `'right'` (end) of the input string.",
+    "parseFloat": r"Parses the input _string_ to a floating-point value. Same as JavaScript's `parseFloat`.",
+    "parseInt": r"Parses the input _string_ to an integer value. Same as JavaScript's `parseInt`.",
+    "replace": r"Returns a new string with some or all matches of _pattern_ replaced by a _replacement_ string. The _pattern_ can be a string or a regular expression. If _pattern_ is a string, only the first instance will be replaced. Same as [JavaScript's String.replace](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replace).",
+    "split": r"Returns an array of tokens created by splitting the input _string_ according to a provided _separator_ pattern. The result can optionally be constrained to return at most _limit_ tokens.",
+    "substring": r"Returns a section of _string_ between the _start_ and _end_ indices.",
+    "trim": r"Returns a trimmed string with preceding and trailing whitespace removed.",
+    "truncate": r"Truncates an input _string_ to a target _length_. The optional _align_ argument indicates what part of the string should be truncated: `'left'` (the beginning), `'center'`, or `'right'` (the end). By default, the `'right'` end of the string is truncated. The optional _ellipsis_ argument indicates the string to use to indicate truncated content; by default the ellipsis character `...` (`\\u2026`) is used.",
+    "upper": r"Transforms _string_ to upper-case letters.",
+    "merge": r"Merges the input objects _object1_, _object2_, etc into a new output object. Inputs are visited in sequential order, such that key values from later arguments can overwrite those from earlier arguments. Example: `merge({a:1, b:2}, {a:3}) -> {a:3, b:2}`.",
+    "dayFormat": r"Formats a (0-6) _weekday_ number as a full week day name, according to the current locale. For example: `dayFormat(0) -> \"Sunday\"`.",
+    "dayAbbrevFormat": r"Formats a (0-6) _weekday_ number as an abbreviated week day name, according to the current locale. For example: `dayAbbrevFormat(0) -> \"Sun\"`.",
+    "format": r"Formats a numeric _value_ as a string. The _specifier_ must be a valid [d3-format specifier](https://github.com/d3/d3-format/) (e.g., `format(value, ',.2f')`.",
+    "monthFormat": r"Formats a (zero-based) _month_ number as a full month name, according to the current locale. For example: `monthFormat(0) -> \"January\"`.",
+    "monthAbbrevFormat": r"Formats a (zero-based) _month_ number as an abbreviated month name, according to the current locale. For example: `monthAbbrevFormat(0) -> \"Jan\"`.",
+    "timeUnitSpecifier": r"Returns a time format specifier string for the given time [_units_](../api/time/#time-units). The optional _specifiers_ object provides a set of specifier sub-strings for customizing the format; for more, see the [timeUnitSpecifier API documentation](../api/time/#timeUnitSpecifier). The resulting specifier string can then be used as input to the [timeFormat](#timeFormat) or [utcFormat](#utcFormat) functions, or as the _format_ parameter of an axis or legend. For example: `timeFormat(date, timeUnitSpecifier('year'))` or `timeFormat(date, timeUnitSpecifier(['hours', 'minutes']))`.",
+    "timeFormat": r"Formats a datetime _value_ (either a `Date` object or timestamp) as a string, according to the local time. The _specifier_ must be a valid [d3-time-format specifier](https://github.com/d3/d3-time-format/). For example: `timeFormat(timestamp, '%A')`.",
+    "timeParse": r"Parses a _string_ value to a Date object, according to the local time. The _specifier_ must be a valid [d3-time-format specifier](https://github.com/d3/d3-time-format/). For example: `timeParse('June 30, 2015', '%B %d, %Y')`.",
+    "utcFormat": r"Formats a datetime _value_ (either a `Date` object or timestamp) as a string, according to [UTC](https://en.wikipedia.org/wiki/Coordinated_Universal_Time) time. The _specifier_ must be a valid [d3-time-format specifier](https://github.com/d3/d3-time-format/). For example: `utcFormat(timestamp, '%A')`.",
+    "utcParse": r"Parses a _string_ value to a Date object, according to [UTC](https://en.wikipedia.org/wiki/Coordinated_Universal_Time) time. The _specifier_ must be a valid [d3-time-format specifier](https://github.com/d3/d3-time-format/). For example: `utcParse('June 30, 2015', '%B %d, %Y')`.",
+    "regexp": r"Creates a regular expression instance from an input _pattern_ string and optional _flags_. Same as [JavaScript's `RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp).",
+    "test": r"Evaluates a regular expression _regexp_ against the input _string_, returning `true` if the string matches the pattern, `false` otherwise. For example: `test(/\\d{3}/, \"32-21-9483\") -> true`.",
+    "rgb": r"Constructs a new [RGB](https://en.wikipedia.org/wiki/RGB_color_model) color. If _r_, _g_ and _b_ are specified, these represent the channel values of the returned color; an _opacity_ may also be specified. If a CSS Color Module Level 3 _specifier_ string is specified, it is parsed and then converted to the RGB color space. Uses [d3-color's rgb function](https://github.com/d3/d3-color#rgb).",
+    "hsl": r"Constructs a new [HSL](https://en.wikipedia.org/wiki/HSL_and_HSV) color. If _h_, _s_ and _l_ are specified, these represent the channel values of the returned color; an _opacity_ may also be specified. If a CSS Color Module Level 3 _specifier_ string is specified, it is parsed and then converted to the HSL color space. Uses [d3-color's hsl function](https://github.com/d3/d3-color#hsl).",
+    "lab": r"Constructs a new [CIE LAB](https://en.wikipedia.org/wiki/Lab_color_space#CIELAB) color. If _l_, _a_ and _b_ are specified, these represent the channel values of the returned color; an _opacity_ may also be specified. If a CSS Color Module Level 3 _specifier_ string is specified, it is parsed and then converted to the LAB color space. Uses [d3-color's lab function](https://github.com/d3/d3-color#lab).",
+    "hcl": r"Constructs a new [HCL](https://en.wikipedia.org/wiki/Lab_color_space#CIELAB) (hue, chroma, luminance) color. If _h_, _c_ and _l_ are specified, these represent the channel values of the returned color; an _opacity_ may also be specified. If a CSS Color Module Level 3 _specifier_ string is specified, it is parsed and then converted to the HCL color space. Uses [d3-color's hcl function](https://github.com/d3/d3-color#hcl).",
+    "luminance": r"Returns the luminance for the given color _specifier_ (compatible with [d3-color's rgb function](https://github.com/d3/d3-color#rgb)). The luminance is calculated according to the [W3C Web Content Accessibility Guidelines](https://www.w3.org/TR/2008/REC-WCAG20-20081211/#relativeluminancedef).",
+    "contrast": r"Returns the contrast ratio between the input color specifiers as a float between 1 and 21. The contrast is calculated according to the [W3C Web Content Accessibility Guidelines](https://www.w3.org/TR/2008/REC-WCAG20-20081211/#contrast-ratiodef).",
+    "item": r"Returns the current scenegraph item that is the target of the event.",
+    "group": r"Returns the scenegraph group mark item in which the current event has occurred. If no arguments are provided, the immediate parent group is returned. If a group name is provided, the matching ancestor group item is returned.",
+    "xy": r"Returns the x- and y-coordinates for the current event as a two-element array. If no arguments are provided, the top-level coordinate space of the view is used. If a scenegraph _item_ (or string group name) is provided, the coordinate space of the group item is used.",
+    "x": r"Returns the x coordinate for the current event. If no arguments are provided, the top-level coordinate space of the view is used. If a scenegraph _item_ (or string group name) is provided, the coordinate space of the group item is used.",
+    "y": r"Returns the y coordinate for the current event. If no arguments are provided, the top-level coordinate space of the view is used. If a scenegraph _item_ (or string group name) is provided, the coordinate space of the group item is used.",
+    "pinchDistance": r"Returns the pixel distance between the first two touch points of a multi-touch event.",
+    "pinchAngle": r"Returns the angle of the line connecting the first two touch points of a multi-touch event.",
+    "inScope": r"Returns true if the given scenegraph _item_ is a descendant of the group mark in which the event handler was defined, false otherwise.",
+    "data": r"Returns the array of data objects for the Vega data set with the given _name_. If the data set is not found, returns an empty array.",
+    "indata": r"Tests if the data set with a given _name_ contains a datum with a _field_ value that matches the input _value_. For example: `indata('table', 'category', value)`.",
+    "scale": r"Applies the named scale transform (or projection) to the specified _value_. The optional _group_ argument takes a scenegraph group mark item to indicate the specific scope in which to look up the scale or projection.",
+    "invert": r"Inverts the named scale transform (or projection) for the specified _value_. The optional _group_ argument takes a scenegraph group mark item to indicate the specific scope in which to look up the scale or projection.",
+    "copy": r"Returns a copy (a new cloned instance) of the named scale transform of projection, or `undefined` if no scale or projection is found. The optional _group_ argument takes a scenegraph group mark item to indicate the specific scope in which to look up the scale or projection.",
+    "domain": r"Returns the scale domain array for the named scale transform, or an empty array if the scale is not found. The optional _group_ argument takes a scenegraph group mark item to indicate the specific scope in which to look up the scale.",
+    "range": r"Returns the scale range array for the named scale transform, or an empty array if the scale is not found. The optional _group_ argument takes a scenegraph group mark item to indicate the specific scope in which to look up the scale.",
+    "bandwidth": r"Returns the current band width for the named band scale transform, or zero if the scale is not found or is not a band scale. The optional _group_ argument takes a scenegraph group mark item to indicate the specific scope in which to look up the scale.",
+    "bandspace": r"Returns the number of steps needed within a band scale, based on the _count_ of domain elements and the inner and outer padding values. While normally calculated within the scale itself, this function can be helpful for determining the size of a chart's layout.",
+    "gradient": r"Returns a linear color gradient for the _scale_ (whose range must be a [continuous color scheme](../schemes)) and starting and ending points _p0_ and _p1_, each an _[x, y]_ array. The points _p0_ and _p1_ should be expressed in normalized coordinates in the domain [0, 1], relative to the bounds of the item being colored. If unspecified, _p0_ defaults to `[0, 0]` and _p1_ defaults to `[1, 0]`, for a horizontal gradient that spans the full bounds of an item. The optional _count_ argument indicates a desired target number of sample points to take from the color scale.",
+    "panLinear": r"Given a linear scale _domain_ array with numeric or datetime values, returns a new two-element domain array that is the result of panning the domain by a fractional _delta_. The _delta_ value represents fractional units of the scale range; for example, `0.5` indicates panning the scale domain to the right by half the scale range.",
+    "panLog": r"Given a log scale _domain_ array with numeric or datetime values, returns a new two-element domain array that is the result of panning the domain by a fractional _delta_. The _delta_ value represents fractional units of the scale range; for example, `0.5` indicates panning the scale domain to the right by half the scale range.",
+    "panPow": r"Given a power scale _domain_ array with numeric or datetime values and the given _exponent_, returns a new two-element domain array that is the result of panning the domain by a fractional _delta_. The _delta_ value represents fractional units of the scale range; for example, `0.5` indicates panning the scale domain to the right by half the scale range.",
+    "panSymlog": r"Given a symmetric log scale _domain_ array with numeric or datetime values parameterized by the given _constant_, returns a new two-element domain array that is the result of panning the domain by a fractional _delta_. The _delta_ value represents fractional units of the scale range; for example, `0.5` indicates panning the scale domain to the right by half the scale range.",
+    "zoomLinear": r"Given a linear scale _domain_ array with numeric or datetime values, returns a new two-element domain array that is the result of zooming the domain by a _scaleFactor_, centered at the provided fractional _anchor_. The _anchor_ value represents the zoom position in terms of fractional units of the scale range; for example, `0.5` indicates a zoom centered on the mid-point of the scale range.",
+    "zoomLog": r"Given a log scale _domain_ array with numeric or datetime values, returns a new two-element domain array that is the result of zooming the domain by a _scaleFactor_, centered at the provided fractional _anchor_. The _anchor_ value represents the zoom position in terms of fractional units of the scale range; for example, `0.5` indicates a zoom centered on the mid-point of the scale range.",
+    "zoomPow": r"Given a power scale _domain_ array with numeric or datetime values and the given _exponent_, returns a new two-element domain array that is the result of zooming the domain by a _scaleFactor_, centered at the provided fractional _anchor_. The _anchor_ value represents the zoom position in terms of fractional units of the scale range; for example, `0.5` indicates a zoom centered on the mid-point of the scale range.",
+    "zoomSymlog": r"Given a symmetric log scale _domain_ array with numeric or datetime values parameterized by the given _constant_, returns a new two-element domain array that is the result of zooming the domain by a _scaleFactor_, centered at the provided fractional _anchor_. The _anchor_ value represents the zoom position in terms of fractional units of the scale range; for example, `0.5` indicates a zoom centered on the mid-point of the scale range.",
+    "geoArea": r"Returns the projected planar area (typically in square pixels) of a GeoJSON _feature_ according to the named _projection_. If the _projection_ argument is `null`, computes the spherical area in steradians using unprojected longitude, latitude coordinates. The optional _group_ argument takes a scenegraph group mark item to indicate the specific scope in which to look up the projection. Uses d3-geo's [geoArea](https://github.com/d3/d3-geo#geoArea) and [path.area](https://github.com/d3/d3-geo#path_area) methods.",
+    "geoBounds": r"Returns the projected planar bounding box (typically in pixels) for the specified GeoJSON _feature_, according to the named _projection_. The bounding box is represented by a two-dimensional array: [[_x0_, _y0_], [_x1_, _y1_]], where _x0_ is the minimum x-coordinate, _y0_ is the minimum y-coordinate, _x1_ is the maximum x-coordinate, and _y1_ is the maximum y-coordinate. If the _projection_ argument is `null`, computes the spherical bounding box using unprojected longitude, latitude coordinates. The optional _group_ argument takes a scenegraph group mark item to indicate the specific scope in which to look up the projection. Uses d3-geo's [geoBounds](https://github.com/d3/d3-geo#geoBounds) and [path.bounds](https://github.com/d3/d3-geo#path_bounds) methods.",
+    "geoCentroid": r"Returns the projected planar centroid (typically in pixels) for the specified GeoJSON _feature_, according to the named _projection_. If the _projection_ argument is `null`, computes the spherical centroid using unprojected longitude, latitude coordinates. The optional _group_ argument takes a scenegraph group mark item to indicate the specific scope in which to look up the projection. Uses d3-geo's [geoCentroid](https://github.com/d3/d3-geo#geoCentroid) and [path.centroid](https://github.com/d3/d3-geo#path_centroid) methods.",
+    "treePath": r"For the hierarchy data set with the given _name_, returns the shortest path through from the _source_ node id to the _target_ node id. The path starts at the _source_ node, ascends to the least common ancestor of the _source_ node and the _target_ node, and then descends to the _target_ node.",
+    "treeAncestors": r"For the hierarchy data set with the given _name_, returns the array of ancestors nodes, starting with the input _node_, then followed by each parent up to the root.",
+    "containerSize": r"Returns the current CSS box size (`[el.clientWidth, el.clientHeight]`) of the parent DOM element that contains the Vega view. If there is no container element, returns `[undefined, undefined]`.",
+    "screen": r"Returns the [`window.screen`](https://developer.mozilla.org/en-US/docs/Web/API/Window/screen) object, or `{}` if Vega is not running in a browser environment.",
+    "windowSize": r"Returns the current window size (`[window.innerWidth, window.innerHeight]`) or `[undefined, undefined]` if Vega is not running in a browser environment.",
+    "warn": r"Logs a warning message and returns the last argument. For the message to appear in the console, the visualization view must have the appropriate logging level set.",
+    "info": r"Logs an informative message and returns the last argument. For the message to appear in the console, the visualization view must have the appropriate logging level set.",
+    "debug": r"Logs a debugging message and returns the last argument. For the message to appear in the console, the visualization view must have the appropriate logging level set.",
+}
+
+
+# This maps vega expression function names to the Python name
+NAME_MAP = {"if": "if_"}
+
+
+class ExprFunc:
+    def __init__(self, name, doc):
+        self.name = name
+        self.doc = doc
+        self.__doc__ = """{}(*args)\n    {}""".format(name, doc)
+
+    def __call__(self, *args):
+        return FunctionExpression(self.name, args)
+
+    def __repr__(self):
+        return "<function expr.{}(*args)>".format(self.name)
+
+
+def _populate_namespace():
+    globals_ = globals()
+    for name, doc in FUNCTION_LISTING.items():
+        py_name = NAME_MAP.get(name, name)
+        globals_[py_name] = ExprFunc(name, doc)
+        yield py_name
+
+
+__all__ = list(_populate_namespace())
diff --git a/llm/Lib/site-packages/altair/jupyter/__init__.py b/llm/Lib/site-packages/altair/jupyter/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..651ab11e4cf8de15370bbf02efd36315c1d27e82
--- /dev/null
+++ b/llm/Lib/site-packages/altair/jupyter/__init__.py
@@ -0,0 +1,20 @@
+try:
+    import anywidget  # noqa: F401
+except ImportError:
+    # When anywidget isn't available, create stand-in JupyterChart class
+    # that raises an informative import error on construction. This
+    # way we can make JupyterChart available in the altair namespace
+    # when anywidget is not installed
+    class JupyterChart:
+        def __init__(self, *args, **kwargs):
+            raise ImportError(
+                "The Altair JupyterChart requires the anywidget \n"
+                "Python package which may be installed using pip with\n"
+                "    pip install anywidget\n"
+                "or using conda with\n"
+                "    conda install -c conda-forge anywidget\n"
+                "Afterwards, you will need to restart your Python kernel."
+            )
+
+else:
+    from .jupyter_chart import JupyterChart  # noqa: F401
diff --git a/llm/Lib/site-packages/altair/jupyter/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/altair/jupyter/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..03341aa0d6ae96e854a1db8e7729ab692abaa20d
Binary files /dev/null and b/llm/Lib/site-packages/altair/jupyter/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/jupyter/__pycache__/jupyter_chart.cpython-311.pyc b/llm/Lib/site-packages/altair/jupyter/__pycache__/jupyter_chart.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0a794901c42c8d06e1c26d39f1e9ae1e8c49f037
Binary files /dev/null and b/llm/Lib/site-packages/altair/jupyter/__pycache__/jupyter_chart.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/jupyter/js/README.md b/llm/Lib/site-packages/altair/jupyter/js/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..f1ec545894f60fea2a2096b4ac4b588c890b5192
--- /dev/null
+++ b/llm/Lib/site-packages/altair/jupyter/js/README.md
@@ -0,0 +1,2 @@
+# JupyterChart
+This directory contains the JavaScript portion of the Altair `JupyterChart`. The `JupyterChart` is based on the [AnyWidget](https://anywidget.dev/) project.
diff --git a/llm/Lib/site-packages/altair/jupyter/js/index.js b/llm/Lib/site-packages/altair/jupyter/js/index.js
new file mode 100644
index 0000000000000000000000000000000000000000..ba080010563c38e910f238b2b6bb31d54a41b4e0
--- /dev/null
+++ b/llm/Lib/site-packages/altair/jupyter/js/index.js
@@ -0,0 +1,230 @@
+import vegaEmbed from "https://esm.sh/vega-embed@6?deps=vega@5&deps=vega-lite@5.17.0";
+import lodashDebounce from "https://esm.sh/lodash-es@4.17.21/debounce";
+
+// Note: For offline support, the import lines above are removed and the remaining script
+// is bundled using vl-convert's javascript_bundle function. See the documentation of
+// the javascript_bundle function for details on the available imports and their names.
+// If an additional import is required in the future, it will need to be added to vl-convert
+// in order to preserve offline support.
+async function render({ model, el }) {
+    let finalize;
+
+    function showError(error){
+        el.innerHTML = (
+            '<div style="color:red;">'
+            + '<p>JavaScript Error: ' + error.message + '</p>'
+            + "<p>This usually means there's a typo in your chart specification. "
+            + "See the javascript console for the full traceback.</p>"
+            + '</div>'
+        );
+    }
+
+    const reembed = async () => {
+        if (finalize != null) {
+          finalize();
+        }
+
+        model.set("local_tz", Intl.DateTimeFormat().resolvedOptions().timeZone);
+
+        let spec = structuredClone(model.get("spec"));
+        if (spec == null) {
+            // Remove any existing chart and return
+            while (el.firstChild) {
+                el.removeChild(el.lastChild);
+            }
+            model.save_changes();
+            return;
+        }
+        let embedOptions = structuredClone(model.get("embed_options")) ?? undefined;
+
+        let api;
+        try {
+            api = await vegaEmbed(el, spec, embedOptions);
+        } catch (error) {
+            showError(error)
+            return;
+        }
+
+        finalize = api.finalize;
+
+        // Debounce config
+        const wait = model.get("debounce_wait") ?? 10;
+        const debounceOpts = {leading: false, trailing: true};
+        if (model.get("max_wait") ?? true) {
+            debounceOpts["maxWait"] = wait;
+        }
+
+        const initialSelections = {};
+        for (const selectionName of Object.keys(model.get("_vl_selections"))) {
+            const storeName = `${selectionName}_store`;
+            const selectionHandler = (_, value) => {
+                const newSelections = cleanJson(model.get("_vl_selections") ?? {});
+                const store = cleanJson(api.view.data(storeName) ?? []);
+
+                newSelections[selectionName] = {value, store};
+                model.set("_vl_selections", newSelections);
+                model.save_changes();
+            };
+            api.view.addSignalListener(selectionName, lodashDebounce(selectionHandler, wait, debounceOpts));
+
+            initialSelections[selectionName] = {
+                value: cleanJson(api.view.signal(selectionName) ?? {}),
+                store: cleanJson(api.view.data(storeName) ?? [])
+            }
+        }
+        model.set("_vl_selections", initialSelections);
+
+        const initialParams = {};
+        for (const paramName of Object.keys(model.get("_params"))) {
+            const paramHandler = (_, value) => {
+                const newParams = JSON.parse(JSON.stringify(model.get("_params"))) || {};
+                newParams[paramName] = value;
+                model.set("_params", newParams);
+                model.save_changes();
+            };
+            api.view.addSignalListener(paramName, lodashDebounce(paramHandler, wait, debounceOpts));
+
+            initialParams[paramName] = api.view.signal(paramName) ?? null
+        }
+        model.set("_params", initialParams);
+        model.save_changes();
+
+        // Param change callback
+        model.on('change:_params', async (new_params) => {
+            for (const [param, value] of Object.entries(new_params.changed._params)) {
+                api.view.signal(param, value);
+            }
+            await api.view.runAsync();
+        });
+
+        // Add signal/data listeners
+        for (const watch of model.get("_js_watch_plan") ?? []) {
+            if (watch.namespace === "data") {
+                const dataHandler = (_, value) => {
+                    model.set("_js_to_py_updates", [{
+                        namespace: "data",
+                        name: watch.name,
+                        scope: watch.scope,
+                        value: cleanJson(value)
+                    }]);
+                    model.save_changes();
+                };
+                addDataListener(api.view, watch.name, watch.scope, lodashDebounce(dataHandler, wait, debounceOpts))
+
+            } else if (watch.namespace === "signal") {
+                const signalHandler = (_, value) => {
+                    model.set("_js_to_py_updates", [{
+                        namespace: "signal",
+                        name: watch.name,
+                        scope: watch.scope,
+                        value: cleanJson(value)
+                    }]);
+                    model.save_changes();
+                };
+
+                addSignalListener(api.view, watch.name, watch.scope, lodashDebounce(signalHandler, wait, debounceOpts))
+            }
+        }
+
+        // Add signal/data updaters
+        model.on('change:_py_to_js_updates', async (updates) => {
+            for (const update of updates.changed._py_to_js_updates ?? []) {
+                if (update.namespace === "signal") {
+                    setSignalValue(api.view, update.name, update.scope, update.value);
+                } else if (update.namespace === "data") {
+                    setDataValue(api.view, update.name, update.scope, update.value);
+                }
+            }
+            await api.view.runAsync();
+        });
+    }
+
+    model.on('change:spec', reembed);
+    model.on('change:embed_options', reembed);
+    model.on('change:debounce_wait', reembed);
+    model.on('change:max_wait', reembed);
+    await reembed();
+}
+
+function cleanJson(data) {
+    return JSON.parse(JSON.stringify(data))
+}
+
+function getNestedRuntime(view, scope) {
+    var runtime = view._runtime;
+    for (const index of scope) {
+        runtime = runtime.subcontext[index];
+    }
+    return runtime
+}
+
+function lookupSignalOp(view, name, scope) {
+    let parent_runtime = getNestedRuntime(view, scope);
+    return parent_runtime.signals[name] ?? null;
+}
+
+function dataRef(view, name, scope) {
+    let parent_runtime = getNestedRuntime(view, scope);
+    return parent_runtime.data[name];
+}
+
+export function setSignalValue(view, name, scope, value) {
+    let signal_op = lookupSignalOp(view, name, scope);
+    view.update(signal_op, value);
+}
+
+export function setDataValue(view, name, scope, value) {
+    let dataset = dataRef(view, name, scope);
+    let changeset = view.changeset().remove(() => true).insert(value)
+    dataset.modified = true;
+    view.pulse(dataset.input, changeset);
+}
+
+export function addSignalListener(view, name, scope, handler) {
+    let signal_op = lookupSignalOp(view, name, scope);
+    return addOperatorListener(
+        view,
+        name,
+        signal_op,
+        handler,
+    );
+}
+
+export function addDataListener(view, name, scope, handler) {
+    let dataset = dataRef(view, name, scope).values;
+    return addOperatorListener(
+        view,
+        name,
+        dataset,
+        handler,
+    );
+}
+
+// Private helpers from Vega for dealing with nested signals/data
+function findOperatorHandler(op, handler) {
+    const h = (op._targets || [])
+        .filter(op => op._update && op._update.handler === handler);
+    return h.length ? h[0] : null;
+}
+
+function addOperatorListener(view, name, op, handler) {
+    let h = findOperatorHandler(op, handler);
+    if (!h) {
+        h = trap(view, () => handler(name, op.value));
+        h.handler = handler;
+        view.on(op, null, h);
+    }
+    return view;
+}
+
+function trap(view, fn) {
+    return !fn ? null : function() {
+        try {
+            fn.apply(this, arguments);
+        } catch (error) {
+            view.error(error);
+        }
+    };
+}
+
+export default { render }
diff --git a/llm/Lib/site-packages/altair/jupyter/jupyter_chart.py b/llm/Lib/site-packages/altair/jupyter/jupyter_chart.py
new file mode 100644
index 0000000000000000000000000000000000000000..0331c9820cd9943e8ced1abaec1d0e99573b595a
--- /dev/null
+++ b/llm/Lib/site-packages/altair/jupyter/jupyter_chart.py
@@ -0,0 +1,413 @@
+import json
+import anywidget
+import traitlets
+import pathlib
+from typing import Any, Set, Optional
+
+import altair as alt
+from altair.utils._vegafusion_data import (
+    using_vegafusion,
+    compile_to_vegafusion_chart_state,
+)
+from altair import TopLevelSpec
+from altair.utils.selection import IndexSelection, PointSelection, IntervalSelection
+
+_here = pathlib.Path(__file__).parent
+
+
+class Params(traitlets.HasTraits):
+    """
+    Traitlet class storing a JupyterChart's params
+    """
+
+    def __init__(self, trait_values):
+        super().__init__()
+
+        for key, value in trait_values.items():
+            if isinstance(value, (int, float)):
+                traitlet_type = traitlets.Float()
+            elif isinstance(value, str):
+                traitlet_type = traitlets.Unicode()
+            elif isinstance(value, list):
+                traitlet_type = traitlets.List()
+            elif isinstance(value, dict):
+                traitlet_type = traitlets.Dict()
+            else:
+                traitlet_type = traitlets.Any()
+
+            # Add the new trait.
+            self.add_traits(**{key: traitlet_type})
+
+            # Set the trait's value.
+            setattr(self, key, value)
+
+    def __repr__(self):
+        return f"Params({self.trait_values()})"
+
+
+class Selections(traitlets.HasTraits):
+    """
+    Traitlet class storing a JupyterChart's selections
+    """
+
+    def __init__(self, trait_values):
+        super().__init__()
+
+        for key, value in trait_values.items():
+            if isinstance(value, IndexSelection):
+                traitlet_type = traitlets.Instance(IndexSelection)
+            elif isinstance(value, PointSelection):
+                traitlet_type = traitlets.Instance(PointSelection)
+            elif isinstance(value, IntervalSelection):
+                traitlet_type = traitlets.Instance(IntervalSelection)
+            else:
+                raise ValueError(f"Unexpected selection type: {type(value)}")
+
+            # Add the new trait.
+            self.add_traits(**{key: traitlet_type})
+
+            # Set the trait's value.
+            setattr(self, key, value)
+
+            # Make read-only
+            self.observe(self._make_read_only, names=key)
+
+    def __repr__(self):
+        return f"Selections({self.trait_values()})"
+
+    def _make_read_only(self, change):
+        """
+        Work around to make traits read-only, but still allow us to change
+        them internally
+        """
+        if change["name"] in self.traits() and change["old"] != change["new"]:
+            self._set_value(change["name"], change["old"])
+        raise ValueError(
+            "Selections may not be set from Python.\n"
+            f"Attempted to set select: {change['name']}"
+        )
+
+    def _set_value(self, key, value):
+        self.unobserve(self._make_read_only, names=key)
+        setattr(self, key, value)
+        self.observe(self._make_read_only, names=key)
+
+
+def load_js_src() -> str:
+    return (_here / "js" / "index.js").read_text()
+
+
+class JupyterChart(anywidget.AnyWidget):
+    _esm = load_js_src()
+    _css = r"""
+    .vega-embed {
+        /* Make sure action menu isn't cut off */
+        overflow: visible;
+    }
+    """
+
+    # Public traitlets
+    chart = traitlets.Instance(TopLevelSpec, allow_none=True)
+    spec = traitlets.Dict(allow_none=True).tag(sync=True)
+    debounce_wait = traitlets.Float(default_value=10).tag(sync=True)
+    max_wait = traitlets.Bool(default_value=True).tag(sync=True)
+    local_tz = traitlets.Unicode(default_value=None, allow_none=True).tag(sync=True)
+    debug = traitlets.Bool(default_value=False)
+    embed_options = traitlets.Dict(default_value=None, allow_none=True).tag(sync=True)
+
+    # Internal selection traitlets
+    _selection_types = traitlets.Dict()
+    _vl_selections = traitlets.Dict().tag(sync=True)
+
+    # Internal param traitlets
+    _params = traitlets.Dict().tag(sync=True)
+
+    # Internal comm traitlets for VegaFusion support
+    _chart_state = traitlets.Any(allow_none=True)
+    _js_watch_plan = traitlets.Any(allow_none=True).tag(sync=True)
+    _js_to_py_updates = traitlets.Any(allow_none=True).tag(sync=True)
+    _py_to_js_updates = traitlets.Any(allow_none=True).tag(sync=True)
+
+    # Track whether charts are configured for offline use
+    _is_offline = False
+
+    @classmethod
+    def enable_offline(cls, offline: bool = True):
+        """
+        Configure JupyterChart's offline behavior
+
+        Parameters
+        ----------
+        offline: bool
+            If True, configure JupyterChart to operate in offline mode where JavaScript
+            dependencies are loaded from vl-convert.
+            If False, configure it to operate in online mode where JavaScript dependencies
+            are loaded from CDN dynamically. This is the default behavior.
+        """
+        from altair.utils._importers import import_vl_convert, vl_version_for_vl_convert
+
+        if offline:
+            if cls._is_offline:
+                # Already offline
+                return
+
+            vlc = import_vl_convert()
+
+            src_lines = load_js_src().split("\n")
+
+            # Remove leading lines with only whitespace, comments, or imports
+            while src_lines and (
+                len(src_lines[0].strip()) == 0
+                or src_lines[0].startswith("import")
+                or src_lines[0].startswith("//")
+            ):
+                src_lines.pop(0)
+
+            src = "\n".join(src_lines)
+
+            # vl-convert's javascript_bundle function creates a self-contained JavaScript bundle
+            # for JavaScript snippets that import from a small set of dependencies that
+            # vl-convert includes. To see the available imports and their imported names, run
+            #       import vl_convert as vlc
+            #       help(vlc.javascript_bundle)
+            bundled_src = vlc.javascript_bundle(
+                src, vl_version=vl_version_for_vl_convert()
+            )
+            cls._esm = bundled_src
+            cls._is_offline = True
+        else:
+            cls._esm = load_js_src()
+            cls._is_offline = False
+
+    def __init__(
+        self,
+        chart: TopLevelSpec,
+        debounce_wait: int = 10,
+        max_wait: bool = True,
+        debug: bool = False,
+        embed_options: Optional[dict] = None,
+        **kwargs: Any,
+    ):
+        """
+        Jupyter Widget for displaying and updating Altair Charts, and
+        retrieving selection and parameter values
+
+        Parameters
+        ----------
+        chart: Chart
+            Altair Chart instance
+        debounce_wait: int
+             Debouncing wait time in milliseconds. Updates will be sent from the client to the kernel
+             after debounce_wait milliseconds of no chart interactions.
+        max_wait: bool
+             If True (default), updates will be sent from the client to the kernel every debounce_wait
+             milliseconds even if there are ongoing chart interactions. If False, updates will not be
+             sent until chart interactions have completed.
+        debug: bool
+             If True, debug messages will be printed
+        embed_options: dict
+             Options to pass to vega-embed.
+             See https://github.com/vega/vega-embed?tab=readme-ov-file#options
+        """
+        self.params = Params({})
+        self.selections = Selections({})
+        super().__init__(
+            chart=chart,
+            debounce_wait=debounce_wait,
+            max_wait=max_wait,
+            debug=debug,
+            embed_options=embed_options,
+            **kwargs,
+        )
+
+    @traitlets.observe("chart")
+    def _on_change_chart(self, change):
+        """
+        Internal callback function that updates the JupyterChart's internal
+        state when the wrapped Chart instance changes
+        """
+        new_chart = change.new
+        selection_watches = []
+        selection_types = {}
+        initial_params = {}
+        initial_vl_selections = {}
+        empty_selections = {}
+
+        if new_chart is None:
+            with self.hold_sync():
+                self.spec = None
+                self._selection_types = selection_types
+                self._vl_selections = initial_vl_selections
+                self._params = initial_params
+            return
+
+        params = getattr(new_chart, "params", [])
+
+        if params is not alt.Undefined:
+            for param in new_chart.params:
+                if isinstance(param.name, alt.ParameterName):
+                    clean_name = param.name.to_json().strip('"')
+                else:
+                    clean_name = param.name
+
+                select = getattr(param, "select", alt.Undefined)
+
+                if select != alt.Undefined:
+                    if not isinstance(select, dict):
+                        select = select.to_dict()
+
+                    select_type = select["type"]
+                    if select_type == "point":
+                        if not (
+                            select.get("fields", None) or select.get("encodings", None)
+                        ):
+                            # Point selection with no associated fields or encodings specified.
+                            # This is an index-based selection
+                            selection_types[clean_name] = "index"
+                            empty_selections[clean_name] = IndexSelection(
+                                name=clean_name, value=[], store=[]
+                            )
+                        else:
+                            selection_types[clean_name] = "point"
+                            empty_selections[clean_name] = PointSelection(
+                                name=clean_name, value=[], store=[]
+                            )
+                    elif select_type == "interval":
+                        selection_types[clean_name] = "interval"
+                        empty_selections[clean_name] = IntervalSelection(
+                            name=clean_name, value={}, store=[]
+                        )
+                    else:
+                        raise ValueError(f"Unexpected selection type {select.type}")
+                    selection_watches.append(clean_name)
+                    initial_vl_selections[clean_name] = {"value": None, "store": []}
+                else:
+                    clean_value = param.value if param.value != alt.Undefined else None
+                    initial_params[clean_name] = clean_value
+
+        # Handle the params generated by transforms
+        for param_name in collect_transform_params(new_chart):
+            initial_params[param_name] = None
+
+        # Setup params
+        self.params = Params(initial_params)
+
+        def on_param_traitlet_changed(param_change):
+            new_params = dict(self._params)
+            new_params[param_change["name"]] = param_change["new"]
+            self._params = new_params
+
+        self.params.observe(on_param_traitlet_changed)
+
+        # Setup selections
+        self.selections = Selections(empty_selections)
+
+        # Update properties all together
+        with self.hold_sync():
+            if using_vegafusion():
+                if self.local_tz is None:
+                    self.spec = None
+
+                    def on_local_tz_change(change):
+                        self._init_with_vegafusion(change["new"])
+
+                    self.observe(on_local_tz_change, ["local_tz"])
+                else:
+                    self._init_with_vegafusion(self.local_tz)
+            else:
+                self.spec = new_chart.to_dict()
+            self._selection_types = selection_types
+            self._vl_selections = initial_vl_selections
+            self._params = initial_params
+
+    def _init_with_vegafusion(self, local_tz: str):
+        if self.chart is not None:
+            vegalite_spec = self.chart.to_dict(context={"pre_transform": False})
+            with self.hold_sync():
+                self._chart_state = compile_to_vegafusion_chart_state(
+                    vegalite_spec, local_tz
+                )
+                self._js_watch_plan = self._chart_state.get_watch_plan()[
+                    "client_to_server"
+                ]
+                self.spec = self._chart_state.get_transformed_spec()
+
+                # Callback to update chart state and send updates back to client
+                def on_js_to_py_updates(change):
+                    if self.debug:
+                        updates_str = json.dumps(change["new"], indent=2)
+                        print(
+                            f"JavaScript to Python VegaFusion updates:\n {updates_str}"
+                        )
+                    updates = self._chart_state.update(change["new"])
+                    if self.debug:
+                        updates_str = json.dumps(updates, indent=2)
+                        print(
+                            f"Python to JavaScript VegaFusion updates:\n {updates_str}"
+                        )
+                    self._py_to_js_updates = updates
+
+                self.observe(on_js_to_py_updates, ["_js_to_py_updates"])
+
+    @traitlets.observe("_params")
+    def _on_change_params(self, change):
+        for param_name, value in change.new.items():
+            setattr(self.params, param_name, value)
+
+    @traitlets.observe("_vl_selections")
+    def _on_change_selections(self, change):
+        """
+        Internal callback function that updates the JupyterChart's public
+        selections traitlet in response to changes that the JavaScript logic
+        makes to the internal _selections traitlet.
+        """
+        for selection_name, selection_dict in change.new.items():
+            value = selection_dict["value"]
+            store = selection_dict["store"]
+            selection_type = self._selection_types[selection_name]
+            if selection_type == "index":
+                self.selections._set_value(
+                    selection_name,
+                    IndexSelection.from_vega(selection_name, signal=value, store=store),
+                )
+            elif selection_type == "point":
+                self.selections._set_value(
+                    selection_name,
+                    PointSelection.from_vega(selection_name, signal=value, store=store),
+                )
+            elif selection_type == "interval":
+                self.selections._set_value(
+                    selection_name,
+                    IntervalSelection.from_vega(
+                        selection_name, signal=value, store=store
+                    ),
+                )
+
+
+def collect_transform_params(chart: TopLevelSpec) -> Set[str]:
+    """
+    Collect the names of params that are defined by transforms
+
+    Parameters
+    ----------
+    chart: Chart from which to extract transform params
+
+    Returns
+    -------
+    set of param names
+    """
+    transform_params = set()
+
+    # Handle recursive case
+    for prop in ("layer", "concat", "hconcat", "vconcat"):
+        for child in getattr(chart, prop, []):
+            transform_params.update(collect_transform_params(child))
+
+    # Handle chart's own transforms
+    transforms = getattr(chart, "transform", [])
+    transforms = transforms if transforms != alt.Undefined else []
+    for tx in transforms:
+        if hasattr(tx, "param"):
+            transform_params.add(tx.param)
+
+    return transform_params
diff --git a/llm/Lib/site-packages/altair/py.typed b/llm/Lib/site-packages/altair/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/altair/utils/__init__.py b/llm/Lib/site-packages/altair/utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..dba1e1f81c174e445f5e396bf9d0fa421618fe89
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/__init__.py
@@ -0,0 +1,32 @@
+from .core import (
+    infer_vegalite_type,
+    infer_encoding_types,
+    sanitize_dataframe,
+    sanitize_arrow_table,
+    parse_shorthand,
+    use_signature,
+    update_nested,
+    display_traceback,
+    SchemaBase,
+)
+from .html import spec_to_html
+from .plugin_registry import PluginRegistry
+from .deprecation import AltairDeprecationWarning
+from .schemapi import Undefined
+
+
+__all__ = (
+    "infer_vegalite_type",
+    "infer_encoding_types",
+    "sanitize_dataframe",
+    "sanitize_arrow_table",
+    "spec_to_html",
+    "parse_shorthand",
+    "use_signature",
+    "update_nested",
+    "display_traceback",
+    "AltairDeprecationWarning",
+    "SchemaBase",
+    "Undefined",
+    "PluginRegistry",
+)
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e7c3bea7e2b10710a37b0734f731d9a46fc7add0
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/_dfi_types.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/_dfi_types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ea86f83ce963f2207971908537763218e1ce8664
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/_dfi_types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/_importers.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/_importers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9a478c85a62fc9b54e8d335951c3c4979829eb7e
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/_importers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/_show.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/_show.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5a58667c240bb6068bed5bcc0a6162aa87359af1
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/_show.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/_transformed_data.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/_transformed_data.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2f0b3988fba837e115556a128f1e03a23810b03f
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/_transformed_data.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/_vegafusion_data.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/_vegafusion_data.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..65b2f39a571f01302ed6e17b2ee2c737fd5235cb
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/_vegafusion_data.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/compiler.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/compiler.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b2b88fa78c835e0828af21776cba7f255120e2e9
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/compiler.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/core.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/core.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d611e94ceaa8e1b4f81e7aa4f213e20dde96c60d
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/core.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/data.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/data.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fe1b1e7a851cf93bc12339aff6f34730ad23c9fb
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/data.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/deprecation.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/deprecation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e3b05af4e789131a87bc612f7fb07072cf9eed3f
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/deprecation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/display.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/display.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b7392df5c3af130e1272c4175c5d068be1f8ba2f
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/display.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/execeval.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/execeval.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..991f4cad2adfb909bf95abde02e8f5b8fb8e7acc
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/execeval.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/html.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/html.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4fc6b12bb4353b2c2d1e9df604aab1a6698fd308
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/html.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/mimebundle.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/mimebundle.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..45f7bf10d19435daf7c8b4423e59a92c845ae640
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/mimebundle.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/plugin_registry.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/plugin_registry.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7d4c4697c0dd6cb322eb3962f9bc6eeaef0d868d
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/plugin_registry.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/save.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/save.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..17c89669c9a2d163743d7f575c9f0eb0d7b5ac08
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/save.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/schemapi.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/schemapi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..431e15a7607384097af5a20d375c16d80d1a9aad
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/schemapi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/selection.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/selection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..14a51c516bb74f4b668e2cc79a15ddec77207d02
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/selection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/server.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/server.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4d5d78890483d5e5c8ae5750efe263f007dc9eb6
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/server.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/__pycache__/theme.cpython-311.pyc b/llm/Lib/site-packages/altair/utils/__pycache__/theme.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b7c97c2b174950a218c820c7392aedaa7677829e
Binary files /dev/null and b/llm/Lib/site-packages/altair/utils/__pycache__/theme.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/utils/_dfi_types.py b/llm/Lib/site-packages/altair/utils/_dfi_types.py
new file mode 100644
index 0000000000000000000000000000000000000000..a76435e7fdf9f771fd69d7bba37dc3c4a0f93fd1
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/_dfi_types.py
@@ -0,0 +1,165 @@
+# DataFrame Interchange Protocol Types
+# Copied from https://data-apis.org/dataframe-protocol/latest/API.html,
+# changed ABCs to Protocols, and subset the type hints to only those that are
+# relevant for Altair.
+#
+# These classes are only for use in type signatures
+import enum
+from typing import Any, Iterable, Optional, Tuple, Protocol
+
+
+class DtypeKind(enum.IntEnum):
+    """
+    Integer enum for data types.
+
+    Attributes
+    ----------
+    INT : int
+        Matches to signed integer data type.
+    UINT : int
+        Matches to unsigned integer data type.
+    FLOAT : int
+        Matches to floating point data type.
+    BOOL : int
+        Matches to boolean data type.
+    STRING : int
+        Matches to string data type (UTF-8 encoded).
+    DATETIME : int
+        Matches to datetime data type.
+    CATEGORICAL : int
+        Matches to categorical data type.
+    """
+
+    INT = 0
+    UINT = 1
+    FLOAT = 2
+    BOOL = 20
+    STRING = 21  # UTF-8
+    DATETIME = 22
+    CATEGORICAL = 23
+
+
+# Type hint of first element would actually be DtypeKind but can't use that
+# as other libraries won't use an instance of our own Enum in this module but have
+# their own. Type checkers will raise an error on that even though the enums
+# are identical.
+Dtype = Tuple[Any, int, str, str]  # see Column.dtype
+
+
+class Column(Protocol):
+    @property
+    def dtype(self) -> Dtype:
+        """
+        Dtype description as a tuple ``(kind, bit-width, format string, endianness)``.
+
+        Bit-width : the number of bits as an integer
+        Format string : data type description format string in Apache Arrow C
+                        Data Interface format.
+        Endianness : current only native endianness (``=``) is supported
+
+        Notes:
+            - Kind specifiers are aligned with DLPack where possible (hence the
+              jump to 20, leave enough room for future extension)
+            - Masks must be specified as boolean with either bit width 1 (for bit
+              masks) or 8 (for byte masks).
+            - Dtype width in bits was preferred over bytes
+            - Endianness isn't too useful, but included now in case in the future
+              we need to support non-native endianness
+            - Went with Apache Arrow format strings over NumPy format strings
+              because they're more complete from a dataframe perspective
+            - Format strings are mostly useful for datetime specification, and
+              for categoricals.
+            - For categoricals, the format string describes the type of the
+              categorical in the data buffer. In case of a separate encoding of
+              the categorical (e.g. an integer to string mapping), this can
+              be derived from ``self.describe_categorical``.
+            - Data types not included: complex, Arrow-style null, binary, decimal,
+              and nested (list, struct, map, union) dtypes.
+        """
+        pass
+
+    # Have to use a generic Any return type as not all libraries who implement
+    # the dataframe interchange protocol implement the TypedDict that is usually
+    # returned here in the same way. As TypedDicts are invariant, even a slight change
+    # will lead to an error by a type checker. See PR in which this code was added
+    # for details.
+    @property
+    def describe_categorical(self) -> Any:
+        """
+        If the dtype is categorical, there are two options:
+        - There are only values in the data buffer.
+        - There is a separate non-categorical Column encoding categorical values.
+
+        Raises TypeError if the dtype is not categorical
+
+        Returns the dictionary with description on how to interpret the data buffer:
+            - "is_ordered" : bool, whether the ordering of dictionary indices is
+                             semantically meaningful.
+            - "is_dictionary" : bool, whether a mapping of
+                                categorical values to other objects exists
+            - "categories" : Column representing the (implicit) mapping of indices to
+                             category values (e.g. an array of cat1, cat2, ...).
+                             None if not a dictionary-style categorical.
+
+        TBD: are there any other in-memory representations that are needed?
+        """
+        pass
+
+
+class DataFrame(Protocol):
+    """
+    A data frame class, with only the methods required by the interchange
+    protocol defined.
+
+    A "data frame" represents an ordered collection of named columns.
+    A column's "name" must be a unique string.
+    Columns may be accessed by name or by position.
+
+    This could be a public data frame class, or an object with the methods and
+    attributes defined on this DataFrame class could be returned from the
+    ``__dataframe__`` method of a public data frame class in a library adhering
+    to the dataframe interchange protocol specification.
+    """
+
+    def __dataframe__(
+        self, nan_as_null: bool = False, allow_copy: bool = True
+    ) -> "DataFrame":
+        """
+        Construct a new exchange object, potentially changing the parameters.
+
+        ``nan_as_null`` is a keyword intended for the consumer to tell the
+        producer to overwrite null values in the data with ``NaN``.
+        It is intended for cases where the consumer does not support the bit
+        mask or byte mask that is the producer's native representation.
+        ``allow_copy`` is a keyword that defines whether or not the library is
+        allowed to make a copy of the data. For example, copying data would be
+        necessary if a library supports strided buffers, given that this protocol
+        specifies contiguous buffers.
+        """
+        pass
+
+    def column_names(self) -> Iterable[str]:
+        """
+        Return an iterator yielding the column names.
+        """
+        pass
+
+    def get_column_by_name(self, name: str) -> Column:
+        """
+        Return the column whose name is the indicated name.
+        """
+        pass
+
+    def get_chunks(self, n_chunks: Optional[int] = None) -> Iterable["DataFrame"]:
+        """
+        Return an iterator yielding the chunks.
+
+        By default (None), yields the chunks that the data is stored as by the
+        producer. If given, ``n_chunks`` must be a multiple of
+        ``self.num_chunks()``, meaning the producer must subdivide each chunk
+        before yielding it.
+
+        Note that the producer must ensure that all columns are chunked the
+        same way.
+        """
+        pass
diff --git a/llm/Lib/site-packages/altair/utils/_importers.py b/llm/Lib/site-packages/altair/utils/_importers.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7fa8a9584a7b4f31bcae19369b7b1fd6d23872b
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/_importers.py
@@ -0,0 +1,97 @@
+from types import ModuleType
+from packaging.version import Version
+from importlib.metadata import version as importlib_version
+
+
+def import_vegafusion() -> ModuleType:
+    min_version = "1.5.0"
+    try:
+        version = importlib_version("vegafusion")
+        embed_version = importlib_version("vegafusion-python-embed")
+        if version != embed_version or Version(version) < Version(min_version):
+            raise RuntimeError(
+                "The versions of the vegafusion and vegafusion-python-embed packages must match\n"
+                f"and must be version {min_version} or greater.\n"
+                f"Found:\n"
+                f" - vegafusion=={version}\n"
+                f" - vegafusion-python-embed=={embed_version}\n"
+            )
+        import vegafusion as vf  # type: ignore
+
+        return vf
+    except ImportError as err:
+        raise ImportError(
+            'The "vegafusion" data transformer and chart.transformed_data feature requires\n'
+            f"version {min_version} or greater of the 'vegafusion-python-embed' and 'vegafusion' packages.\n"
+            "These can be installed with pip using:\n"
+            f'    pip install "vegafusion[embed]>={min_version}"\n'
+            "Or with conda using:\n"
+            f'    conda install -c conda-forge "vegafusion-python-embed>={min_version}" '
+            f'"vegafusion>={min_version}"\n\n'
+            f"ImportError: {err.args[0]}"
+        ) from err
+
+
+def import_vl_convert() -> ModuleType:
+    min_version = "1.3.0"
+    try:
+        version = importlib_version("vl-convert-python")
+        if Version(version) < Version(min_version):
+            raise RuntimeError(
+                f"The vl-convert-python package must be version {min_version} or greater. "
+                f"Found version {version}"
+            )
+        import vl_convert as vlc
+
+        return vlc
+    except ImportError as err:
+        raise ImportError(
+            f"The vl-convert Vega-Lite compiler and file export feature requires\n"
+            f"version {min_version} or greater of the 'vl-convert-python' package. \n"
+            f"This can be installed with pip using:\n"
+            f'   pip install "vl-convert-python>={min_version}"\n'
+            "or conda:\n"
+            f'   conda install -c conda-forge "vl-convert-python>={min_version}"\n\n'
+            f"ImportError: {err.args[0]}"
+        ) from err
+
+
+def vl_version_for_vl_convert() -> str:
+    from ..vegalite import SCHEMA_VERSION
+
+    # Compute VlConvert's vl_version string (of the form 'v5_2')
+    # from SCHEMA_VERSION (of the form 'v5.2.0')
+    return "_".join(SCHEMA_VERSION.split(".")[:2])
+
+
+def import_pyarrow_interchange() -> ModuleType:
+    min_version = "11.0.0"
+    try:
+        version = importlib_version("pyarrow")
+
+        if Version(version) < Version(min_version):
+            raise RuntimeError(
+                f"The pyarrow package must be version {min_version} or greater. "
+                f"Found version {version}"
+            )
+        import pyarrow.interchange as pi
+
+        return pi
+    except ImportError as err:
+        raise ImportError(
+            f"Usage of the DataFrame Interchange Protocol requires\n"
+            f"version {min_version} or greater of the pyarrow package. \n"
+            f"This can be installed with pip using:\n"
+            f'   pip install "pyarrow>={min_version}"\n'
+            "or conda:\n"
+            f'   conda install -c conda-forge "pyarrow>={min_version}"\n\n'
+            f"ImportError: {err.args[0]}"
+        ) from err
+
+
+def pyarrow_available() -> bool:
+    try:
+        import_pyarrow_interchange()
+        return True
+    except (ImportError, RuntimeError):
+        return False
diff --git a/llm/Lib/site-packages/altair/utils/_show.py b/llm/Lib/site-packages/altair/utils/_show.py
new file mode 100644
index 0000000000000000000000000000000000000000..0030570acb9e66be9a6f2e45f7e212b0020c8b56
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/_show.py
@@ -0,0 +1,73 @@
+import webbrowser
+from http.server import BaseHTTPRequestHandler, HTTPServer
+from typing import Union, Iterable, Optional
+
+
+def open_html_in_browser(
+    html: Union[str, bytes],
+    using: Union[str, Iterable[str], None] = None,
+    port: Optional[int] = None,
+):
+    """
+    Display an html document in a web browser without creating a temp file.
+
+    Instantiates a simple http server and uses the webbrowser module to
+    open the server's URL
+
+    Parameters
+    ----------
+    html: str
+        HTML string to display
+    using: str or iterable of str
+        Name of the web browser to open (e.g. "chrome", "firefox", etc.).
+        If an iterable, choose the first browser available on the system.
+        If none, choose the system default browser.
+    port: int
+        Port to use. Defaults to a random port
+    """
+    # Encode html to bytes
+    if isinstance(html, str):
+        html_bytes = html.encode("utf8")
+    else:
+        html_bytes = html
+
+    browser = None
+
+    if using is None:
+        browser = webbrowser.get(None)
+    else:
+        # normalize using to an iterable
+        if isinstance(using, str):
+            using = [using]
+
+        for browser_key in using:
+            try:
+                browser = webbrowser.get(browser_key)
+                if browser is not None:
+                    break
+            except webbrowser.Error:
+                pass
+
+        if browser is None:
+            raise ValueError("Failed to locate a browser with name in " + str(using))
+
+    class OneShotRequestHandler(BaseHTTPRequestHandler):
+        def do_GET(self):
+            self.send_response(200)
+            self.send_header("Content-type", "text/html")
+            self.end_headers()
+
+            bufferSize = 1024 * 1024
+            for i in range(0, len(html_bytes), bufferSize):
+                self.wfile.write(html_bytes[i : i + bufferSize])
+
+        def log_message(self, format, *args):
+            # Silence stderr logging
+            pass
+
+    # Use specified port if provided, otherwise choose a random port (port value of 0)
+    server = HTTPServer(
+        ("127.0.0.1", port if port is not None else 0), OneShotRequestHandler
+    )
+    browser.open("http://127.0.0.1:%s" % server.server_port)
+    server.handle_request()
diff --git a/llm/Lib/site-packages/altair/utils/_transformed_data.py b/llm/Lib/site-packages/altair/utils/_transformed_data.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d886eb5e9cf96818dff92a6115429b40683d457
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/_transformed_data.py
@@ -0,0 +1,557 @@
+from typing import List, Optional, Tuple, Dict, Iterable, overload, Union
+
+from altair import (
+    Chart,
+    FacetChart,
+    LayerChart,
+    HConcatChart,
+    VConcatChart,
+    ConcatChart,
+    TopLevelUnitSpec,
+    FacetedUnitSpec,
+    UnitSpec,
+    UnitSpecWithFrame,
+    NonNormalizedSpec,
+    TopLevelLayerSpec,
+    LayerSpec,
+    TopLevelConcatSpec,
+    ConcatSpecGenericSpec,
+    TopLevelHConcatSpec,
+    HConcatSpecGenericSpec,
+    TopLevelVConcatSpec,
+    VConcatSpecGenericSpec,
+    TopLevelFacetSpec,
+    FacetSpec,
+    data_transformers,
+)
+from altair.utils._vegafusion_data import get_inline_tables, import_vegafusion
+from altair.utils.core import DataFrameLike
+from altair.utils.schemapi import Undefined
+
+Scope = Tuple[int, ...]
+FacetMapping = Dict[Tuple[str, Scope], Tuple[str, Scope]]
+
+
+# For the transformed_data functionality, the chart classes in the values
+# can be considered equivalent to the chart class in the key.
+_chart_class_mapping = {
+    Chart: (
+        Chart,
+        TopLevelUnitSpec,
+        FacetedUnitSpec,
+        UnitSpec,
+        UnitSpecWithFrame,
+        NonNormalizedSpec,
+    ),
+    LayerChart: (LayerChart, TopLevelLayerSpec, LayerSpec),
+    ConcatChart: (ConcatChart, TopLevelConcatSpec, ConcatSpecGenericSpec),
+    HConcatChart: (HConcatChart, TopLevelHConcatSpec, HConcatSpecGenericSpec),
+    VConcatChart: (VConcatChart, TopLevelVConcatSpec, VConcatSpecGenericSpec),
+    FacetChart: (FacetChart, TopLevelFacetSpec, FacetSpec),
+}
+
+
+@overload
+def transformed_data(
+    chart: Union[Chart, FacetChart],
+    row_limit: Optional[int] = None,
+    exclude: Optional[Iterable[str]] = None,
+) -> Optional[DataFrameLike]: ...
+
+
+@overload
+def transformed_data(
+    chart: Union[LayerChart, HConcatChart, VConcatChart, ConcatChart],
+    row_limit: Optional[int] = None,
+    exclude: Optional[Iterable[str]] = None,
+) -> List[DataFrameLike]: ...
+
+
+def transformed_data(chart, row_limit=None, exclude=None):
+    """Evaluate a Chart's transforms
+
+    Evaluate the data transforms associated with a Chart and return the
+    transformed data as one or more DataFrames
+
+    Parameters
+    ----------
+    chart : Chart, FacetChart, LayerChart, HConcatChart, VConcatChart, or ConcatChart
+        Altair chart to evaluate transforms on
+    row_limit : int (optional)
+        Maximum number of rows to return for each DataFrame. None (default) for unlimited
+    exclude : iterable of str
+        Set of the names of charts to exclude
+
+    Returns
+    -------
+    DataFrame or list of DataFrames or None
+        If input chart is a Chart or Facet Chart, returns a DataFrame of the
+        transformed data. Otherwise, returns a list of DataFrames of the
+        transformed data
+    """
+    vf = import_vegafusion()
+
+    if isinstance(chart, Chart):
+        # Add mark if none is specified to satisfy Vega-Lite
+        if chart.mark == Undefined:
+            chart = chart.mark_point()
+
+    # Deep copy chart so that we can rename marks without affecting caller
+    chart = chart.copy(deep=True)
+
+    # Ensure that all views are named so that we can look them up in the
+    # resulting Vega specification
+    chart_names = name_views(chart, 0, exclude=exclude)
+
+    # Compile to Vega and extract inline DataFrames
+    with data_transformers.enable("vegafusion"):
+        vega_spec = chart.to_dict(format="vega", context={"pre_transform": False})
+        inline_datasets = get_inline_tables(vega_spec)
+
+    # Build mapping from mark names to vega datasets
+    facet_mapping = get_facet_mapping(vega_spec)
+    dataset_mapping = get_datasets_for_view_names(vega_spec, chart_names, facet_mapping)
+
+    # Build a list of vega dataset names that corresponds to the order
+    # of the chart components
+    dataset_names = []
+    for chart_name in chart_names:
+        if chart_name in dataset_mapping:
+            dataset_names.append(dataset_mapping[chart_name])
+        else:
+            raise ValueError("Failed to locate all datasets")
+
+    # Extract transformed datasets with VegaFusion
+    datasets, warnings = vf.runtime.pre_transform_datasets(
+        vega_spec,
+        dataset_names,
+        row_limit=row_limit,
+        inline_datasets=inline_datasets,
+    )
+
+    if isinstance(chart, (Chart, FacetChart)):
+        # Return DataFrame (or None if it was excluded) if input was a simple Chart
+        if not datasets:
+            return None
+        else:
+            return datasets[0]
+    else:
+        # Otherwise return the list of DataFrames
+        return datasets
+
+
+# The equivalent classes from _chart_class_mapping should also be added
+# to the type hints below for `chart` as the function would also work for them.
+# However, this was not possible so far as mypy then complains about
+# "Overloaded function signatures 1 and 2 overlap with incompatible return types [misc]"
+# This might be due to the complex type hierarchy of the chart classes.
+# See also https://github.com/python/mypy/issues/5119
+# and https://github.com/python/mypy/issues/4020 which show that mypy might not have
+# a very consistent behavior for overloaded functions.
+# The same error appeared when trying it with Protocols for the concat and layer charts.
+# This function is only used internally and so we accept this inconsistency for now.
+def name_views(
+    chart: Union[
+        Chart, FacetChart, LayerChart, HConcatChart, VConcatChart, ConcatChart
+    ],
+    i: int = 0,
+    exclude: Optional[Iterable[str]] = None,
+) -> List[str]:
+    """Name unnamed chart views
+
+    Name unnamed charts views so that we can look them up later in
+    the compiled Vega spec.
+
+    Note: This function mutates the input chart by applying names to
+    unnamed views.
+
+    Parameters
+    ----------
+    chart : Chart, FacetChart, LayerChart, HConcatChart, VConcatChart, or ConcatChart
+        Altair chart to apply names to
+    i : int (default 0)
+        Starting chart index
+    exclude : iterable of str
+        Names of charts to exclude
+
+    Returns
+    -------
+    list of str
+        List of the names of the charts and subcharts
+    """
+    exclude = set(exclude) if exclude is not None else set()
+    if isinstance(chart, _chart_class_mapping[Chart]) or isinstance(
+        chart, _chart_class_mapping[FacetChart]
+    ):
+        if chart.name not in exclude:
+            if chart.name in (None, Undefined):
+                # Add name since none is specified
+                chart.name = Chart._get_name()
+            return [chart.name]
+        else:
+            return []
+    else:
+        if isinstance(chart, _chart_class_mapping[LayerChart]):
+            subcharts = chart.layer
+        elif isinstance(chart, _chart_class_mapping[HConcatChart]):
+            subcharts = chart.hconcat
+        elif isinstance(chart, _chart_class_mapping[VConcatChart]):
+            subcharts = chart.vconcat
+        elif isinstance(chart, _chart_class_mapping[ConcatChart]):
+            subcharts = chart.concat
+        else:
+            raise ValueError(
+                "transformed_data accepts an instance of "
+                "Chart, FacetChart, LayerChart, HConcatChart, VConcatChart, or ConcatChart\n"
+                f"Received value of type: {type(chart)}"
+            )
+
+        chart_names: List[str] = []
+        for subchart in subcharts:
+            for name in name_views(subchart, i=i + len(chart_names), exclude=exclude):
+                chart_names.append(name)
+        return chart_names
+
+
+def get_group_mark_for_scope(vega_spec: dict, scope: Scope) -> Optional[dict]:
+    """Get the group mark at a particular scope
+
+    Parameters
+    ----------
+    vega_spec : dict
+        Top-level Vega specification dictionary
+    scope : tuple of int
+        Scope tuple. If empty, the original Vega specification is returned.
+        Otherwise, the nested group mark at the scope specified is returned.
+
+    Returns
+    -------
+    dict or None
+        Top-level Vega spec (if scope is empty)
+        or group mark (if scope is non-empty)
+        or None (if group mark at scope does not exist)
+
+    Examples
+    --------
+    >>> spec = {
+    ...     "marks": [
+    ...         {
+    ...             "type": "group",
+    ...             "marks": [{"type": "symbol"}]
+    ...         },
+    ...         {
+    ...             "type": "group",
+    ...             "marks": [{"type": "rect"}]}
+    ...     ]
+    ... }
+    >>> get_group_mark_for_scope(spec, (1,))
+    {'type': 'group', 'marks': [{'type': 'rect'}]}
+    """
+    group = vega_spec
+
+    # Find group at scope
+    for scope_value in scope:
+        group_index = 0
+        child_group = None
+        for mark in group.get("marks", []):
+            if mark.get("type") == "group":
+                if group_index == scope_value:
+                    child_group = mark
+                    break
+                group_index += 1
+        if child_group is None:
+            return None
+        group = child_group
+
+    return group
+
+
+def get_datasets_for_scope(vega_spec: dict, scope: Scope) -> List[str]:
+    """Get the names of the datasets that are defined at a given scope
+
+    Parameters
+    ----------
+    vega_spec : dict
+        Top-leve Vega specification
+    scope : tuple of int
+        Scope tuple. If empty, the names of top-level datasets are returned
+        Otherwise, the names of the datasets defined in the nested group mark
+        at the specified scope are returned.
+
+    Returns
+    -------
+    list of str
+        List of the names of the datasets defined at the specified scope
+
+    Examples
+    --------
+    >>> spec = {
+    ...     "data": [
+    ...         {"name": "data1"}
+    ...     ],
+    ...     "marks": [
+    ...         {
+    ...             "type": "group",
+    ...             "data": [
+    ...                 {"name": "data2"}
+    ...             ],
+    ...             "marks": [{"type": "symbol"}]
+    ...         },
+    ...         {
+    ...             "type": "group",
+    ...             "data": [
+    ...                 {"name": "data3"},
+    ...                 {"name": "data4"},
+    ...             ],
+    ...             "marks": [{"type": "rect"}]
+    ...         }
+    ...     ]
+    ... }
+
+    >>> get_datasets_for_scope(spec, ())
+    ['data1']
+
+    >>> get_datasets_for_scope(spec, (0,))
+    ['data2']
+
+    >>> get_datasets_for_scope(spec, (1,))
+    ['data3', 'data4']
+
+    Returns empty when no group mark exists at scope
+    >>> get_datasets_for_scope(spec, (1, 3))
+    []
+    """
+    group = get_group_mark_for_scope(vega_spec, scope) or {}
+
+    # get datasets from group
+    datasets = []
+    for dataset in group.get("data", []):
+        datasets.append(dataset["name"])
+
+    # Add facet dataset
+    facet_dataset = group.get("from", {}).get("facet", {}).get("name", None)
+    if facet_dataset:
+        datasets.append(facet_dataset)
+    return datasets
+
+
+def get_definition_scope_for_data_reference(
+    vega_spec: dict, data_name: str, usage_scope: Scope
+) -> Optional[Scope]:
+    """Return the scope that a dataset is defined at, for a given usage scope
+
+    Parameters
+    ----------
+    vega_spec: dict
+        Top-level Vega specification
+    data_name: str
+        The name of a dataset reference
+    usage_scope: tuple of int
+        The scope that the dataset is referenced in
+
+    Returns
+    -------
+    tuple of int
+        The scope where the referenced dataset is defined,
+        or None if no such dataset is found
+
+    Examples
+    --------
+    >>> spec = {
+    ...     "data": [
+    ...         {"name": "data1"}
+    ...     ],
+    ...     "marks": [
+    ...         {
+    ...             "type": "group",
+    ...             "data": [
+    ...                 {"name": "data2"}
+    ...             ],
+    ...             "marks": [{
+    ...                 "type": "symbol",
+    ...                 "encode": {
+    ...                     "update": {
+    ...                         "x": {"field": "x", "data": "data1"},
+    ...                         "y": {"field": "y", "data": "data2"},
+    ...                     }
+    ...                 }
+    ...             }]
+    ...         }
+    ...     ]
+    ... }
+
+    data1 is referenced at scope [0] and defined at scope []
+    >>> get_definition_scope_for_data_reference(spec, "data1", (0,))
+    ()
+
+    data2 is referenced at scope [0] and defined at scope [0]
+    >>> get_definition_scope_for_data_reference(spec, "data2", (0,))
+    (0,)
+
+    If data2 is not visible at scope [] (the top level),
+    because it's defined in scope [0]
+    >>> repr(get_definition_scope_for_data_reference(spec, "data2", ()))
+    'None'
+    """
+    for i in reversed(range(len(usage_scope) + 1)):
+        scope = usage_scope[:i]
+        datasets = get_datasets_for_scope(vega_spec, scope)
+        if data_name in datasets:
+            return scope
+    return None
+
+
+def get_facet_mapping(group: dict, scope: Scope = ()) -> FacetMapping:
+    """Create mapping from facet definitions to source datasets
+
+    Parameters
+    ----------
+    group : dict
+        Top-level Vega spec or nested group mark
+    scope : tuple of int
+        Scope of the group dictionary within a top-level Vega spec
+
+    Returns
+    -------
+    dict
+        Dictionary from (facet_name, facet_scope) to (dataset_name, dataset_scope)
+
+    Examples
+    --------
+    >>> spec = {
+    ...     "data": [
+    ...         {"name": "data1"}
+    ...     ],
+    ...     "marks": [
+    ...         {
+    ...             "type": "group",
+    ...             "from": {
+    ...                 "facet": {
+    ...                     "name": "facet1",
+    ...                     "data": "data1",
+    ...                     "groupby": ["colA"]
+    ...                 }
+    ...             }
+    ...         }
+    ...     ]
+    ... }
+    >>> get_facet_mapping(spec)
+    {('facet1', (0,)): ('data1', ())}
+    """
+    facet_mapping = {}
+    group_index = 0
+    mark_group = get_group_mark_for_scope(group, scope) or {}
+    for mark in mark_group.get("marks", []):
+        if mark.get("type", None) == "group":
+            # Get facet for this group
+            group_scope = scope + (group_index,)
+            facet = mark.get("from", {}).get("facet", None)
+            if facet is not None:
+                facet_name = facet.get("name", None)
+                facet_data = facet.get("data", None)
+                if facet_name is not None and facet_data is not None:
+                    definition_scope = get_definition_scope_for_data_reference(
+                        group, facet_data, scope
+                    )
+                    if definition_scope is not None:
+                        facet_mapping[(facet_name, group_scope)] = (
+                            facet_data,
+                            definition_scope,
+                        )
+
+            # Handle children recursively
+            child_mapping = get_facet_mapping(group, scope=group_scope)
+            facet_mapping.update(child_mapping)
+            group_index += 1
+
+    return facet_mapping
+
+
+def get_from_facet_mapping(
+    scoped_dataset: Tuple[str, Scope], facet_mapping: FacetMapping
+) -> Tuple[str, Scope]:
+    """Apply facet mapping to a scoped dataset
+
+    Parameters
+    ----------
+    scoped_dataset : (str, tuple of int)
+        A dataset name and scope tuple
+    facet_mapping : dict from (str, tuple of int) to (str, tuple of int)
+        The facet mapping produced by get_facet_mapping
+
+    Returns
+    -------
+    (str, tuple of int)
+        Dataset name and scope tuple that has been mapped as many times as possible
+
+    Examples
+    --------
+    Facet mapping as produced by get_facet_mapping
+    >>> facet_mapping = {("facet1", (0,)): ("data1", ()), ("facet2", (0, 1)): ("facet1", (0,))}
+    >>> get_from_facet_mapping(("facet2", (0, 1)), facet_mapping)
+    ('data1', ())
+    """
+    while scoped_dataset in facet_mapping:
+        scoped_dataset = facet_mapping[scoped_dataset]
+    return scoped_dataset
+
+
+def get_datasets_for_view_names(
+    group: dict,
+    vl_chart_names: List[str],
+    facet_mapping: FacetMapping,
+    scope: Scope = (),
+) -> Dict[str, Tuple[str, Scope]]:
+    """Get the Vega datasets that correspond to the provided Altair view names
+
+    Parameters
+    ----------
+    group : dict
+        Top-level Vega spec or nested group mark
+    vl_chart_names : list of str
+        List of the Vega-Lite
+    facet_mapping : dict from (str, tuple of int) to (str, tuple of int)
+        The facet mapping produced by get_facet_mapping
+    scope : tuple of int
+        Scope of the group dictionary within a top-level Vega spec
+
+    Returns
+    -------
+    dict from str to (str, tuple of int)
+        Dict from Altair view names to scoped datasets
+    """
+    datasets = {}
+    group_index = 0
+    mark_group = get_group_mark_for_scope(group, scope) or {}
+    for mark in mark_group.get("marks", []):
+        for vl_chart_name in vl_chart_names:
+            if mark.get("name", "") == f"{vl_chart_name}_cell":
+                data_name = mark.get("from", {}).get("facet", None).get("data", None)
+                scoped_data_name = (data_name, scope)
+                datasets[vl_chart_name] = get_from_facet_mapping(
+                    scoped_data_name, facet_mapping
+                )
+                break
+
+        name = mark.get("name", "")
+        if mark.get("type", "") == "group":
+            group_data_names = get_datasets_for_view_names(
+                group, vl_chart_names, facet_mapping, scope=scope + (group_index,)
+            )
+            for k, v in group_data_names.items():
+                datasets.setdefault(k, v)
+            group_index += 1
+        else:
+            for vl_chart_name in vl_chart_names:
+                if name.startswith(vl_chart_name) and name.endswith("_marks"):
+                    data_name = mark.get("from", {}).get("data", None)
+                    scoped_data = get_definition_scope_for_data_reference(
+                        group, data_name, scope
+                    )
+                    if scoped_data is not None:
+                        datasets[vl_chart_name] = get_from_facet_mapping(
+                            (data_name, scoped_data), facet_mapping
+                        )
+                        break
+
+    return datasets
diff --git a/llm/Lib/site-packages/altair/utils/_vegafusion_data.py b/llm/Lib/site-packages/altair/utils/_vegafusion_data.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce30e8d6d9bab4ebb72d2dcdb3e51d664d30c1bc
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/_vegafusion_data.py
@@ -0,0 +1,256 @@
+from toolz import curried
+import uuid
+from weakref import WeakValueDictionary
+
+from typing import (
+    Union,
+    Dict,
+    Set,
+    MutableMapping,
+    TypedDict,
+    Final,
+    TYPE_CHECKING,
+)
+
+from altair.utils._importers import import_vegafusion
+from altair.utils.core import DataFrameLike
+from altair.utils.data import DataType, ToValuesReturnType, MaxRowsError
+from altair.vegalite.data import default_data_transformer
+
+if TYPE_CHECKING:
+    from vegafusion.runtime import ChartState  # type: ignore
+
+# Temporary storage for dataframes that have been extracted
+# from charts by the vegafusion data transformer. Use a WeakValueDictionary
+# rather than a dict so that the Python interpreter is free to garbage
+# collect the stored DataFrames.
+extracted_inline_tables: MutableMapping[str, DataFrameLike] = WeakValueDictionary()
+
+# Special URL prefix that VegaFusion uses to denote that a
+# dataset in a Vega spec corresponds to an entry in the `inline_datasets`
+# kwarg of vf.runtime.pre_transform_spec().
+VEGAFUSION_PREFIX: Final = "vegafusion+dataset://"
+
+
+class _ToVegaFusionReturnUrlDict(TypedDict):
+    url: str
+
+
+@curried.curry
+def vegafusion_data_transformer(
+    data: DataType, max_rows: int = 100000
+) -> Union[_ToVegaFusionReturnUrlDict, ToValuesReturnType]:
+    """VegaFusion Data Transformer"""
+    if hasattr(data, "__geo_interface__"):
+        # Use default transformer for geo interface objects
+        # # (e.g. a geopandas GeoDataFrame)
+        return default_data_transformer(data)
+    elif isinstance(data, DataFrameLike):
+        table_name = f"table_{uuid.uuid4()}".replace("-", "_")
+        extracted_inline_tables[table_name] = data
+        return {"url": VEGAFUSION_PREFIX + table_name}
+    else:
+        # Use default transformer if we don't recognize data type
+        return default_data_transformer(data)
+
+
+def get_inline_table_names(vega_spec: dict) -> Set[str]:
+    """Get a set of the inline datasets names in the provided Vega spec
+
+    Inline datasets are encoded as URLs that start with the table://
+    prefix.
+
+    Parameters
+    ----------
+    vega_spec: dict
+        A Vega specification dict
+
+    Returns
+    -------
+    set of str
+        Set of the names of the inline datasets that are referenced
+        in the specification.
+
+    Examples
+    --------
+    >>> spec = {
+    ...     "data": [
+    ...         {
+    ...             "name": "foo",
+    ...             "url": "https://path/to/file.csv"
+    ...         },
+    ...         {
+    ...             "name": "bar",
+    ...             "url": "vegafusion+dataset://inline_dataset_123"
+    ...         }
+    ...     ]
+    ... }
+    >>> get_inline_table_names(spec)
+    {'inline_dataset_123'}
+    """
+    table_names = set()
+
+    # Process datasets
+    for data in vega_spec.get("data", []):
+        url = data.get("url", "")
+        if url.startswith(VEGAFUSION_PREFIX):
+            name = url[len(VEGAFUSION_PREFIX) :]
+            table_names.add(name)
+
+    # Recursively process child marks, which may have their own datasets
+    for mark in vega_spec.get("marks", []):
+        table_names.update(get_inline_table_names(mark))
+
+    return table_names
+
+
+def get_inline_tables(vega_spec: dict) -> Dict[str, DataFrameLike]:
+    """Get the inline tables referenced by a Vega specification
+
+    Note: This function should only be called on a Vega spec that corresponds
+    to a chart that was processed by the vegafusion_data_transformer.
+    Furthermore, this function may only be called once per spec because
+    the returned dataframes are deleted from internal storage.
+
+    Parameters
+    ----------
+    vega_spec: dict
+        A Vega specification dict
+
+    Returns
+    -------
+    dict from str to dataframe
+        dict from inline dataset name to dataframe object
+    """
+    table_names = get_inline_table_names(vega_spec)
+    tables = {}
+    for table_name in table_names:
+        try:
+            tables[table_name] = extracted_inline_tables.pop(table_name)
+        except KeyError:
+            # named dataset that was provided by the user
+            pass
+    return tables
+
+
+def compile_to_vegafusion_chart_state(
+    vegalite_spec: dict, local_tz: str
+) -> "ChartState":
+    """Compile a Vega-Lite spec to a VegaFusion ChartState
+
+    Note: This function should only be called on a Vega-Lite spec
+    that was generated with the "vegafusion" data transformer enabled.
+    In particular, this spec may contain references to extract datasets
+    using table:// prefixed URLs.
+
+    Parameters
+    ----------
+    vegalite_spec: dict
+        A Vega-Lite spec that was generated from an Altair chart with
+        the "vegafusion" data transformer enabled
+    local_tz: str
+        Local timezone name (e.g. 'America/New_York')
+
+    Returns
+    -------
+    ChartState
+        A VegaFusion ChartState object
+    """
+    # Local import to avoid circular ImportError
+    from altair import vegalite_compilers, data_transformers
+
+    vf = import_vegafusion()
+
+    # Compile Vega-Lite spec to Vega
+    compiler = vegalite_compilers.get()
+    if compiler is None:
+        raise ValueError("No active vega-lite compiler plugin found")
+
+    vega_spec = compiler(vegalite_spec)
+
+    # Retrieve dict of inline tables referenced by the spec
+    inline_tables = get_inline_tables(vega_spec)
+
+    # Pre-evaluate transforms in vega spec with vegafusion
+    row_limit = data_transformers.options.get("max_rows", None)
+
+    chart_state = vf.runtime.new_chart_state(
+        vega_spec,
+        local_tz=local_tz,
+        inline_datasets=inline_tables,
+        row_limit=row_limit,
+    )
+
+    # Check from row limit warning and convert to MaxRowsError
+    handle_row_limit_exceeded(row_limit, chart_state.get_warnings())
+
+    return chart_state
+
+
+def compile_with_vegafusion(vegalite_spec: dict) -> dict:
+    """Compile a Vega-Lite spec to Vega and pre-transform with VegaFusion
+
+    Note: This function should only be called on a Vega-Lite spec
+    that was generated with the "vegafusion" data transformer enabled.
+    In particular, this spec may contain references to extract datasets
+    using table:// prefixed URLs.
+
+    Parameters
+    ----------
+    vegalite_spec: dict
+        A Vega-Lite spec that was generated from an Altair chart with
+        the "vegafusion" data transformer enabled
+
+    Returns
+    -------
+    dict
+        A Vega spec that has been pre-transformed by VegaFusion
+    """
+    # Local import to avoid circular ImportError
+    from altair import vegalite_compilers, data_transformers
+
+    vf = import_vegafusion()
+
+    # Compile Vega-Lite spec to Vega
+    compiler = vegalite_compilers.get()
+    if compiler is None:
+        raise ValueError("No active vega-lite compiler plugin found")
+
+    vega_spec = compiler(vegalite_spec)
+
+    # Retrieve dict of inline tables referenced by the spec
+    inline_tables = get_inline_tables(vega_spec)
+
+    # Pre-evaluate transforms in vega spec with vegafusion
+    row_limit = data_transformers.options.get("max_rows", None)
+    transformed_vega_spec, warnings = vf.runtime.pre_transform_spec(
+        vega_spec,
+        vf.get_local_tz(),
+        inline_datasets=inline_tables,
+        row_limit=row_limit,
+    )
+
+    # Check from row limit warning and convert to MaxRowsError
+    handle_row_limit_exceeded(row_limit, warnings)
+
+    return transformed_vega_spec
+
+
+def handle_row_limit_exceeded(row_limit: int, warnings: list):
+    for warning in warnings:
+        if warning.get("type") == "RowLimitExceeded":
+            raise MaxRowsError(
+                "The number of dataset rows after filtering and aggregation exceeds\n"
+                f"the current limit of {row_limit}. Try adding an aggregation to reduce\n"
+                "the size of the dataset that must be loaded into the browser. Or, disable\n"
+                "the limit by calling alt.data_transformers.disable_max_rows(). Note that\n"
+                "disabling this limit may cause the browser to freeze or crash."
+            )
+
+
+def using_vegafusion() -> bool:
+    """Check whether the vegafusion data transformer is enabled"""
+    # Local import to avoid circular ImportError
+    from altair import data_transformers
+
+    return data_transformers.active == "vegafusion"
diff --git a/llm/Lib/site-packages/altair/utils/compiler.py b/llm/Lib/site-packages/altair/utils/compiler.py
new file mode 100644
index 0000000000000000000000000000000000000000..0944c92fddb4a620d11287a1df1583464b9b1c92
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/compiler.py
@@ -0,0 +1,11 @@
+from typing import Callable
+from altair.utils import PluginRegistry
+
+# ==============================================================================
+# Vega-Lite to Vega compiler registry
+# ==============================================================================
+VegaLiteCompilerType = Callable[[dict], dict]
+
+
+class VegaLiteCompilerRegistry(PluginRegistry[VegaLiteCompilerType]):
+    pass
diff --git a/llm/Lib/site-packages/altair/utils/core.py b/llm/Lib/site-packages/altair/utils/core.py
new file mode 100644
index 0000000000000000000000000000000000000000..baf1013f7d774c6caa79a9b77534bfcb2c577d79
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/core.py
@@ -0,0 +1,852 @@
+"""
+Utility routines
+"""
+
+from collections.abc import Mapping, MutableMapping
+from copy import deepcopy
+import json
+import itertools
+import re
+import sys
+import traceback
+import warnings
+from typing import (
+    Callable,
+    TypeVar,
+    Any,
+    Union,
+    Dict,
+    Optional,
+    Tuple,
+    Sequence,
+    Type,
+    cast,
+)
+from types import ModuleType
+
+import jsonschema
+import pandas as pd
+import numpy as np
+from pandas.api.types import infer_dtype
+
+from altair.utils.schemapi import SchemaBase
+from altair.utils._dfi_types import Column, DtypeKind, DataFrame as DfiDataFrame
+
+if sys.version_info >= (3, 10):
+    from typing import ParamSpec
+else:
+    from typing_extensions import ParamSpec
+
+from typing import Literal, Protocol, TYPE_CHECKING, runtime_checkable
+
+if TYPE_CHECKING:
+    from pandas.core.interchange.dataframe_protocol import Column as PandasColumn
+
+V = TypeVar("V")
+P = ParamSpec("P")
+
+
+@runtime_checkable
+class DataFrameLike(Protocol):
+    def __dataframe__(
+        self, nan_as_null: bool = False, allow_copy: bool = True
+    ) -> DfiDataFrame: ...
+
+
+TYPECODE_MAP = {
+    "ordinal": "O",
+    "nominal": "N",
+    "quantitative": "Q",
+    "temporal": "T",
+    "geojson": "G",
+}
+
+INV_TYPECODE_MAP = {v: k for k, v in TYPECODE_MAP.items()}
+
+
+# aggregates from vega-lite version 4.6.0
+AGGREGATES = [
+    "argmax",
+    "argmin",
+    "average",
+    "count",
+    "distinct",
+    "max",
+    "mean",
+    "median",
+    "min",
+    "missing",
+    "product",
+    "q1",
+    "q3",
+    "ci0",
+    "ci1",
+    "stderr",
+    "stdev",
+    "stdevp",
+    "sum",
+    "valid",
+    "values",
+    "variance",
+    "variancep",
+    "exponential",
+    "exponentialb",
+]
+
+# window aggregates from vega-lite version 4.6.0
+WINDOW_AGGREGATES = [
+    "row_number",
+    "rank",
+    "dense_rank",
+    "percent_rank",
+    "cume_dist",
+    "ntile",
+    "lag",
+    "lead",
+    "first_value",
+    "last_value",
+    "nth_value",
+]
+
+# timeUnits from vega-lite version 4.17.0
+TIMEUNITS = [
+    "year",
+    "quarter",
+    "month",
+    "week",
+    "day",
+    "dayofyear",
+    "date",
+    "hours",
+    "minutes",
+    "seconds",
+    "milliseconds",
+    "yearquarter",
+    "yearquartermonth",
+    "yearmonth",
+    "yearmonthdate",
+    "yearmonthdatehours",
+    "yearmonthdatehoursminutes",
+    "yearmonthdatehoursminutesseconds",
+    "yearweek",
+    "yearweekday",
+    "yearweekdayhours",
+    "yearweekdayhoursminutes",
+    "yearweekdayhoursminutesseconds",
+    "yeardayofyear",
+    "quartermonth",
+    "monthdate",
+    "monthdatehours",
+    "monthdatehoursminutes",
+    "monthdatehoursminutesseconds",
+    "weekday",
+    "weeksdayhours",
+    "weekdayhours",
+    "weekdayhoursminutes",
+    "weekdayhoursminutesseconds",
+    "dayhours",
+    "dayhoursminutes",
+    "dayhoursminutesseconds",
+    "hoursminutes",
+    "hoursminutesseconds",
+    "minutesseconds",
+    "secondsmilliseconds",
+    "utcyear",
+    "utcquarter",
+    "utcmonth",
+    "utcweek",
+    "utcday",
+    "utcdayofyear",
+    "utcdate",
+    "utchours",
+    "utcminutes",
+    "utcseconds",
+    "utcmilliseconds",
+    "utcyearquarter",
+    "utcyearquartermonth",
+    "utcyearmonth",
+    "utcyearmonthdate",
+    "utcyearmonthdatehours",
+    "utcyearmonthdatehoursminutes",
+    "utcyearmonthdatehoursminutesseconds",
+    "utcyearweek",
+    "utcyearweekday",
+    "utcyearweekdayhours",
+    "utcyearweekdayhoursminutes",
+    "utcyearweekdayhoursminutesseconds",
+    "utcyeardayofyear",
+    "utcquartermonth",
+    "utcmonthdate",
+    "utcmonthdatehours",
+    "utcmonthdatehoursminutes",
+    "utcmonthdatehoursminutesseconds",
+    "utcweekday",
+    "utcweeksdayhours",
+    "utcweekdayhoursminutes",
+    "utcweekdayhoursminutesseconds",
+    "utcdayhours",
+    "utcdayhoursminutes",
+    "utcdayhoursminutesseconds",
+    "utchoursminutes",
+    "utchoursminutesseconds",
+    "utcminutesseconds",
+    "utcsecondsmilliseconds",
+]
+
+
+InferredVegaLiteType = Literal["ordinal", "nominal", "quantitative", "temporal"]
+
+
+def infer_vegalite_type(
+    data: object,
+) -> Union[InferredVegaLiteType, Tuple[InferredVegaLiteType, list]]:
+    """
+    From an array-like input, infer the correct vega typecode
+    ('ordinal', 'nominal', 'quantitative', or 'temporal')
+
+    Parameters
+    ----------
+    data: object
+    """
+    typ = infer_dtype(data, skipna=False)
+
+    if typ in [
+        "floating",
+        "mixed-integer-float",
+        "integer",
+        "mixed-integer",
+        "complex",
+    ]:
+        return "quantitative"
+    elif typ == "categorical" and hasattr(data, "cat") and data.cat.ordered:
+        return ("ordinal", data.cat.categories.tolist())
+    elif typ in ["string", "bytes", "categorical", "boolean", "mixed", "unicode"]:
+        return "nominal"
+    elif typ in [
+        "datetime",
+        "datetime64",
+        "timedelta",
+        "timedelta64",
+        "date",
+        "time",
+        "period",
+    ]:
+        return "temporal"
+    else:
+        warnings.warn(
+            "I don't know how to infer vegalite type from '{}'.  "
+            "Defaulting to nominal.".format(typ),
+            stacklevel=1,
+        )
+        return "nominal"
+
+
+def merge_props_geom(feat: dict) -> dict:
+    """
+    Merge properties with geometry
+    * Overwrites 'type' and 'geometry' entries if existing
+    """
+
+    geom = {k: feat[k] for k in ("type", "geometry")}
+    try:
+        feat["properties"].update(geom)
+        props_geom = feat["properties"]
+    except (AttributeError, KeyError):
+        # AttributeError when 'properties' equals None
+        # KeyError when 'properties' is non-existing
+        props_geom = geom
+
+    return props_geom
+
+
+def sanitize_geo_interface(geo: MutableMapping) -> dict:
+    """Santize a geo_interface to prepare it for serialization.
+
+    * Make a copy
+    * Convert type array or _Array to list
+    * Convert tuples to lists (using json.loads/dumps)
+    * Merge properties with geometry
+    """
+
+    geo = deepcopy(geo)
+
+    # convert type _Array or array to list
+    for key in geo.keys():
+        if str(type(geo[key]).__name__).startswith(("_Array", "array")):
+            geo[key] = geo[key].tolist()
+
+    # convert (nested) tuples to lists
+    geo_dct: dict = json.loads(json.dumps(geo))
+
+    # sanitize features
+    if geo_dct["type"] == "FeatureCollection":
+        geo_dct = geo_dct["features"]
+        if len(geo_dct) > 0:
+            for idx, feat in enumerate(geo_dct):
+                geo_dct[idx] = merge_props_geom(feat)
+    elif geo_dct["type"] == "Feature":
+        geo_dct = merge_props_geom(geo_dct)
+    else:
+        geo_dct = {"type": "Feature", "geometry": geo_dct}
+
+    return geo_dct
+
+
+def numpy_is_subtype(dtype: Any, subtype: Any) -> bool:
+    try:
+        return np.issubdtype(dtype, subtype)
+    except (NotImplementedError, TypeError):
+        return False
+
+
+def sanitize_dataframe(df: pd.DataFrame) -> pd.DataFrame:  # noqa: C901
+    """Sanitize a DataFrame to prepare it for serialization.
+
+    * Make a copy
+    * Convert RangeIndex columns to strings
+    * Raise ValueError if column names are not strings
+    * Raise ValueError if it has a hierarchical index.
+    * Convert categoricals to strings.
+    * Convert np.bool_ dtypes to Python bool objects
+    * Convert np.int dtypes to Python int objects
+    * Convert floats to objects and replace NaNs/infs with None.
+    * Convert DateTime dtypes into appropriate string representations
+    * Convert Nullable integers to objects and replace NaN with None
+    * Convert Nullable boolean to objects and replace NaN with None
+    * convert dedicated string column to objects and replace NaN with None
+    * Raise a ValueError for TimeDelta dtypes
+    """
+    df = df.copy()
+
+    if isinstance(df.columns, pd.RangeIndex):
+        df.columns = df.columns.astype(str)
+
+    for col_name in df.columns:
+        if not isinstance(col_name, str):
+            raise ValueError(
+                "Dataframe contains invalid column name: {0!r}. "
+                "Column names must be strings".format(col_name)
+            )
+
+    if isinstance(df.index, pd.MultiIndex):
+        raise ValueError("Hierarchical indices not supported")
+    if isinstance(df.columns, pd.MultiIndex):
+        raise ValueError("Hierarchical indices not supported")
+
+    def to_list_if_array(val):
+        if isinstance(val, np.ndarray):
+            return val.tolist()
+        else:
+            return val
+
+    for dtype_item in df.dtypes.items():
+        # We know that the column names are strings from the isinstance check
+        # further above but mypy thinks it is of type Hashable and therefore does not
+        # let us assign it to the col_name variable which is already of type str.
+        col_name = cast(str, dtype_item[0])
+        dtype = dtype_item[1]
+        dtype_name = str(dtype)
+        if dtype_name == "category":
+            # Work around bug in to_json for categorical types in older versions
+            # of pandas as they do not properly convert NaN values to null in to_json.
+            # We can probably remove this part once we require pandas >= 1.0
+            col = df[col_name].astype(object)
+            df[col_name] = col.where(col.notnull(), None)
+        elif dtype_name == "string":
+            # dedicated string datatype (since 1.0)
+            # https://pandas.pydata.org/pandas-docs/version/1.0.0/whatsnew/v1.0.0.html#dedicated-string-data-type
+            col = df[col_name].astype(object)
+            df[col_name] = col.where(col.notnull(), None)
+        elif dtype_name == "bool":
+            # convert numpy bools to objects; np.bool is not JSON serializable
+            df[col_name] = df[col_name].astype(object)
+        elif dtype_name == "boolean":
+            # dedicated boolean datatype (since 1.0)
+            # https://pandas.io/docs/user_guide/boolean.html
+            col = df[col_name].astype(object)
+            df[col_name] = col.where(col.notnull(), None)
+        elif dtype_name.startswith("datetime") or dtype_name.startswith("timestamp"):
+            # Convert datetimes to strings. This needs to be a full ISO string
+            # with time, which is why we cannot use ``col.astype(str)``.
+            # This is because Javascript parses date-only times in UTC, but
+            # parses full ISO-8601 dates as local time, and dates in Vega and
+            # Vega-Lite are displayed in local time by default.
+            # (see https://github.com/altair-viz/altair/issues/1027)
+            df[col_name] = (
+                df[col_name].apply(lambda x: x.isoformat()).replace("NaT", "")
+            )
+        elif dtype_name.startswith("timedelta"):
+            raise ValueError(
+                'Field "{col_name}" has type "{dtype}" which is '
+                "not supported by Altair. Please convert to "
+                "either a timestamp or a numerical value."
+                "".format(col_name=col_name, dtype=dtype)
+            )
+        elif dtype_name.startswith("geometry"):
+            # geopandas >=0.6.1 uses the dtype geometry. Continue here
+            # otherwise it will give an error on np.issubdtype(dtype, np.integer)
+            continue
+        elif (
+            dtype_name
+            in {
+                "Int8",
+                "Int16",
+                "Int32",
+                "Int64",
+                "UInt8",
+                "UInt16",
+                "UInt32",
+                "UInt64",
+                "Float32",
+                "Float64",
+            }
+        ):  # nullable integer datatypes (since 24.0) and nullable float datatypes (since 1.2.0)
+            # https://pandas.pydata.org/pandas-docs/version/0.25/whatsnew/v0.24.0.html#optional-integer-na-support
+            col = df[col_name].astype(object)
+            df[col_name] = col.where(col.notnull(), None)
+        elif numpy_is_subtype(dtype, np.integer):
+            # convert integers to objects; np.int is not JSON serializable
+            df[col_name] = df[col_name].astype(object)
+        elif numpy_is_subtype(dtype, np.floating):
+            # For floats, convert to Python float: np.float is not JSON serializable
+            # Also convert NaN/inf values to null, as they are not JSON serializable
+            col = df[col_name]
+            bad_values = col.isnull() | np.isinf(col)
+            df[col_name] = col.astype(object).where(~bad_values, None)
+        elif dtype == object:
+            # Convert numpy arrays saved as objects to lists
+            # Arrays are not JSON serializable
+            col = df[col_name].astype(object).apply(to_list_if_array)
+            df[col_name] = col.where(col.notnull(), None)
+    return df
+
+
+def sanitize_arrow_table(pa_table):
+    """Sanitize arrow table for JSON serialization"""
+    import pyarrow as pa
+    import pyarrow.compute as pc
+
+    arrays = []
+    schema = pa_table.schema
+    for name in schema.names:
+        array = pa_table[name]
+        dtype_name = str(schema.field(name).type)
+        if dtype_name.startswith("timestamp") or dtype_name.startswith("date"):
+            arrays.append(pc.strftime(array))
+        elif dtype_name.startswith("duration"):
+            raise ValueError(
+                'Field "{col_name}" has type "{dtype}" which is '
+                "not supported by Altair. Please convert to "
+                "either a timestamp or a numerical value."
+                "".format(col_name=name, dtype=dtype_name)
+            )
+        else:
+            arrays.append(array)
+
+    return pa.Table.from_arrays(arrays, names=schema.names)
+
+
+def parse_shorthand(
+    shorthand: Union[Dict[str, Any], str],
+    data: Optional[Union[pd.DataFrame, DataFrameLike]] = None,
+    parse_aggregates: bool = True,
+    parse_window_ops: bool = False,
+    parse_timeunits: bool = True,
+    parse_types: bool = True,
+) -> Dict[str, Any]:
+    """General tool to parse shorthand values
+
+    These are of the form:
+
+    - "col_name"
+    - "col_name:O"
+    - "average(col_name)"
+    - "average(col_name):O"
+
+    Optionally, a dataframe may be supplied, from which the type
+    will be inferred if not specified in the shorthand.
+
+    Parameters
+    ----------
+    shorthand : dict or string
+        The shorthand representation to be parsed
+    data : DataFrame, optional
+        If specified and of type DataFrame, then use these values to infer the
+        column type if not provided by the shorthand.
+    parse_aggregates : boolean
+        If True (default), then parse aggregate functions within the shorthand.
+    parse_window_ops : boolean
+        If True then parse window operations within the shorthand (default:False)
+    parse_timeunits : boolean
+        If True (default), then parse timeUnits from within the shorthand
+    parse_types : boolean
+        If True (default), then parse typecodes within the shorthand
+
+    Returns
+    -------
+    attrs : dict
+        a dictionary of attributes extracted from the shorthand
+
+    Examples
+    --------
+    >>> data = pd.DataFrame({'foo': ['A', 'B', 'A', 'B'],
+    ...                      'bar': [1, 2, 3, 4]})
+
+    >>> parse_shorthand('name') == {'field': 'name'}
+    True
+
+    >>> parse_shorthand('name:Q') == {'field': 'name', 'type': 'quantitative'}
+    True
+
+    >>> parse_shorthand('average(col)') == {'aggregate': 'average', 'field': 'col'}
+    True
+
+    >>> parse_shorthand('foo:O') == {'field': 'foo', 'type': 'ordinal'}
+    True
+
+    >>> parse_shorthand('min(foo):Q') == {'aggregate': 'min', 'field': 'foo', 'type': 'quantitative'}
+    True
+
+    >>> parse_shorthand('month(col)') == {'field': 'col', 'timeUnit': 'month', 'type': 'temporal'}
+    True
+
+    >>> parse_shorthand('year(col):O') == {'field': 'col', 'timeUnit': 'year', 'type': 'ordinal'}
+    True
+
+    >>> parse_shorthand('foo', data) == {'field': 'foo', 'type': 'nominal'}
+    True
+
+    >>> parse_shorthand('bar', data) == {'field': 'bar', 'type': 'quantitative'}
+    True
+
+    >>> parse_shorthand('bar:O', data) == {'field': 'bar', 'type': 'ordinal'}
+    True
+
+    >>> parse_shorthand('sum(bar)', data) == {'aggregate': 'sum', 'field': 'bar', 'type': 'quantitative'}
+    True
+
+    >>> parse_shorthand('count()', data) == {'aggregate': 'count', 'type': 'quantitative'}
+    True
+    """
+    from altair.utils._importers import pyarrow_available
+
+    if not shorthand:
+        return {}
+
+    valid_typecodes = list(TYPECODE_MAP) + list(INV_TYPECODE_MAP)
+
+    units = {
+        "field": "(?P<field>.*)",
+        "type": "(?P<type>{})".format("|".join(valid_typecodes)),
+        "agg_count": "(?P<aggregate>count)",
+        "op_count": "(?P<op>count)",
+        "aggregate": "(?P<aggregate>{})".format("|".join(AGGREGATES)),
+        "window_op": "(?P<op>{})".format("|".join(AGGREGATES + WINDOW_AGGREGATES)),
+        "timeUnit": "(?P<timeUnit>{})".format("|".join(TIMEUNITS)),
+    }
+
+    patterns = []
+
+    if parse_aggregates:
+        patterns.extend([r"{agg_count}\(\)"])
+        patterns.extend([r"{aggregate}\({field}\)"])
+    if parse_window_ops:
+        patterns.extend([r"{op_count}\(\)"])
+        patterns.extend([r"{window_op}\({field}\)"])
+    if parse_timeunits:
+        patterns.extend([r"{timeUnit}\({field}\)"])
+
+    patterns.extend([r"{field}"])
+
+    if parse_types:
+        patterns = list(itertools.chain(*((p + ":{type}", p) for p in patterns)))
+
+    regexps = (
+        re.compile(r"\A" + p.format(**units) + r"\Z", re.DOTALL) for p in patterns
+    )
+
+    # find matches depending on valid fields passed
+    if isinstance(shorthand, dict):
+        attrs = shorthand
+    else:
+        attrs = next(
+            exp.match(shorthand).groupdict()  # type: ignore[union-attr]
+            for exp in regexps
+            if exp.match(shorthand) is not None
+        )
+
+    # Handle short form of the type expression
+    if "type" in attrs:
+        attrs["type"] = INV_TYPECODE_MAP.get(attrs["type"], attrs["type"])
+
+    # counts are quantitative by default
+    if attrs == {"aggregate": "count"}:
+        attrs["type"] = "quantitative"
+
+    # times are temporal by default
+    if "timeUnit" in attrs and "type" not in attrs:
+        attrs["type"] = "temporal"
+
+    # if data is specified and type is not, infer type from data
+    if "type" not in attrs:
+        if pyarrow_available() and data is not None and isinstance(data, DataFrameLike):
+            dfi = data.__dataframe__()
+            if "field" in attrs:
+                unescaped_field = attrs["field"].replace("\\", "")
+                if unescaped_field in dfi.column_names():
+                    column = dfi.get_column_by_name(unescaped_field)
+                    try:
+                        attrs["type"] = infer_vegalite_type_for_dfi_column(column)
+                    except (NotImplementedError, AttributeError, ValueError):
+                        # Fall back to pandas-based inference.
+                        # Note: The AttributeError catch is a workaround for
+                        # https://github.com/pandas-dev/pandas/issues/55332
+                        if isinstance(data, pd.DataFrame):
+                            attrs["type"] = infer_vegalite_type(data[unescaped_field])
+                        else:
+                            raise
+
+                    if isinstance(attrs["type"], tuple):
+                        attrs["sort"] = attrs["type"][1]
+                        attrs["type"] = attrs["type"][0]
+        elif isinstance(data, pd.DataFrame):
+            # Fallback if pyarrow is not installed or if pandas is older than 1.5
+            #
+            # Remove escape sequences so that types can be inferred for columns with special characters
+            if "field" in attrs and attrs["field"].replace("\\", "") in data.columns:
+                attrs["type"] = infer_vegalite_type(
+                    data[attrs["field"].replace("\\", "")]
+                )
+                # ordered categorical dataframe columns return the type and sort order as a tuple
+                if isinstance(attrs["type"], tuple):
+                    attrs["sort"] = attrs["type"][1]
+                    attrs["type"] = attrs["type"][0]
+
+    # If an unescaped colon is still present, it's often due to an incorrect data type specification
+    # but could also be due to using a column name with ":" in it.
+    if (
+        "field" in attrs
+        and ":" in attrs["field"]
+        and attrs["field"][attrs["field"].rfind(":") - 1] != "\\"
+    ):
+        raise ValueError(
+            '"{}" '.format(attrs["field"].split(":")[-1])
+            + "is not one of the valid encoding data types: {}.".format(
+                ", ".join(TYPECODE_MAP.values())
+            )
+            + "\nFor more details, see https://altair-viz.github.io/user_guide/encodings/index.html#encoding-data-types. "
+            + "If you are trying to use a column name that contains a colon, "
+            + 'prefix it with a backslash; for example "column\\:name" instead of "column:name".'
+        )
+    return attrs
+
+
+def infer_vegalite_type_for_dfi_column(
+    column: Union[Column, "PandasColumn"],
+) -> Union[InferredVegaLiteType, Tuple[InferredVegaLiteType, list]]:
+    from pyarrow.interchange.from_dataframe import column_to_array
+
+    try:
+        kind = column.dtype[0]
+    except NotImplementedError as e:
+        # Edge case hack:
+        # dtype access fails for pandas column with datetime64[ns, UTC] type,
+        # but all we need to know is that its temporal, so check the
+        # error message for the presence of datetime64.
+        #
+        # See https://github.com/pandas-dev/pandas/issues/54239
+        if "datetime64" in e.args[0] or "timestamp" in e.args[0]:
+            return "temporal"
+        raise e
+
+    if (
+        kind == DtypeKind.CATEGORICAL
+        and column.describe_categorical["is_ordered"]
+        and column.describe_categorical["categories"] is not None
+    ):
+        # Treat ordered categorical column as Vega-Lite ordinal
+        categories_column = column.describe_categorical["categories"]
+        categories_array = column_to_array(categories_column)
+        return "ordinal", categories_array.to_pylist()
+    if kind in (DtypeKind.STRING, DtypeKind.CATEGORICAL, DtypeKind.BOOL):
+        return "nominal"
+    elif kind in (DtypeKind.INT, DtypeKind.UINT, DtypeKind.FLOAT):
+        return "quantitative"
+    elif kind == DtypeKind.DATETIME:
+        return "temporal"
+    else:
+        raise ValueError(f"Unexpected DtypeKind: {kind}")
+
+
+def use_signature(Obj: Callable[P, Any]):
+    """Apply call signature and documentation of Obj to the decorated method"""
+
+    def decorate(f: Callable[..., V]) -> Callable[P, V]:
+        # call-signature of f is exposed via __wrapped__.
+        # we want it to mimic Obj.__init__
+        f.__wrapped__ = Obj.__init__  # type: ignore
+        f._uses_signature = Obj  # type: ignore
+
+        # Supplement the docstring of f with information from Obj
+        if Obj.__doc__:
+            # Patch in a reference to the class this docstring is copied from,
+            # to generate a hyperlink.
+            doclines = Obj.__doc__.splitlines()
+            doclines[0] = f"Refer to :class:`{Obj.__name__}`"
+
+            if f.__doc__:
+                doc = f.__doc__ + "\n".join(doclines[1:])
+            else:
+                doc = "\n".join(doclines)
+            try:
+                f.__doc__ = doc
+            except AttributeError:
+                # __doc__ is not modifiable for classes in Python < 3.3
+                pass
+
+        return f
+
+    return decorate
+
+
+def update_nested(
+    original: MutableMapping, update: Mapping, copy: bool = False
+) -> MutableMapping:
+    """Update nested dictionaries
+
+    Parameters
+    ----------
+    original : MutableMapping
+        the original (nested) dictionary, which will be updated in-place
+    update : Mapping
+        the nested dictionary of updates
+    copy : bool, default False
+        if True, then copy the original dictionary rather than modifying it
+
+    Returns
+    -------
+    original : MutableMapping
+        a reference to the (modified) original dict
+
+    Examples
+    --------
+    >>> original = {'x': {'b': 2, 'c': 4}}
+    >>> update = {'x': {'b': 5, 'd': 6}, 'y': 40}
+    >>> update_nested(original, update)  # doctest: +SKIP
+    {'x': {'b': 5, 'c': 4, 'd': 6}, 'y': 40}
+    >>> original  # doctest: +SKIP
+    {'x': {'b': 5, 'c': 4, 'd': 6}, 'y': 40}
+    """
+    if copy:
+        original = deepcopy(original)
+    for key, val in update.items():
+        if isinstance(val, Mapping):
+            orig_val = original.get(key, {})
+            if isinstance(orig_val, MutableMapping):
+                original[key] = update_nested(orig_val, val)
+            else:
+                original[key] = val
+        else:
+            original[key] = val
+    return original
+
+
+def display_traceback(in_ipython: bool = True):
+    exc_info = sys.exc_info()
+
+    if in_ipython:
+        from IPython.core.getipython import get_ipython
+
+        ip = get_ipython()
+    else:
+        ip = None
+
+    if ip is not None:
+        ip.showtraceback(exc_info)
+    else:
+        traceback.print_exception(*exc_info)
+
+
+def infer_encoding_types(args: Sequence, kwargs: MutableMapping, channels: ModuleType):
+    """Infer typed keyword arguments for args and kwargs
+
+    Parameters
+    ----------
+    args : Sequence
+        Sequence of function args
+    kwargs : MutableMapping
+        Dict of function kwargs
+    channels : ModuleType
+        The module containing all altair encoding channel classes.
+
+    Returns
+    -------
+    kwargs : dict
+        All args and kwargs in a single dict, with keys and types
+        based on the channels mapping.
+    """
+    # Construct a dictionary of channel type to encoding name
+    # TODO: cache this somehow?
+    channel_objs = (getattr(channels, name) for name in dir(channels))
+    channel_objs = (
+        c for c in channel_objs if isinstance(c, type) and issubclass(c, SchemaBase)
+    )
+    channel_to_name: Dict[Type[SchemaBase], str] = {
+        c: c._encoding_name for c in channel_objs
+    }
+    name_to_channel: Dict[str, Dict[str, Type[SchemaBase]]] = {}
+    for chan, name in channel_to_name.items():
+        chans = name_to_channel.setdefault(name, {})
+        if chan.__name__.endswith("Datum"):
+            key = "datum"
+        elif chan.__name__.endswith("Value"):
+            key = "value"
+        else:
+            key = "field"
+        chans[key] = chan
+
+    # First use the mapping to convert args to kwargs based on their types.
+    for arg in args:
+        if isinstance(arg, (list, tuple)) and len(arg) > 0:
+            type_ = type(arg[0])
+        else:
+            type_ = type(arg)
+
+        encoding = channel_to_name.get(type_, None)
+        if encoding is None:
+            raise NotImplementedError("positional of type {}" "".format(type_))
+        if encoding in kwargs:
+            raise ValueError("encoding {} specified twice.".format(encoding))
+        kwargs[encoding] = arg
+
+    def _wrap_in_channel_class(obj, encoding):
+        if isinstance(obj, SchemaBase):
+            return obj
+
+        if isinstance(obj, str):
+            obj = {"shorthand": obj}
+
+        if isinstance(obj, (list, tuple)):
+            return [_wrap_in_channel_class(subobj, encoding) for subobj in obj]
+
+        if encoding not in name_to_channel:
+            warnings.warn(
+                "Unrecognized encoding channel '{}'".format(encoding), stacklevel=1
+            )
+            return obj
+
+        classes = name_to_channel[encoding]
+        cls = classes["value"] if "value" in obj else classes["field"]
+
+        try:
+            # Don't force validation here; some objects won't be valid until
+            # they're created in the context of a chart.
+            return cls.from_dict(obj, validate=False)
+        except jsonschema.ValidationError:
+            # our attempts at finding the correct class have failed
+            return obj
+
+    return {
+        encoding: _wrap_in_channel_class(obj, encoding)
+        for encoding, obj in kwargs.items()
+    }
diff --git a/llm/Lib/site-packages/altair/utils/data.py b/llm/Lib/site-packages/altair/utils/data.py
new file mode 100644
index 0000000000000000000000000000000000000000..871b43092a257e270a5a790e64fdb56ebeca2fbf
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/data.py
@@ -0,0 +1,360 @@
+import json
+import os
+import random
+import hashlib
+import warnings
+from typing import Union, MutableMapping, Optional, Dict, Sequence, TYPE_CHECKING, List
+
+import pandas as pd
+from toolz import curried
+from typing import TypeVar
+
+from ._importers import import_pyarrow_interchange
+from .core import sanitize_dataframe, sanitize_arrow_table, DataFrameLike
+from .core import sanitize_geo_interface
+from .deprecation import AltairDeprecationWarning
+from .plugin_registry import PluginRegistry
+
+
+from typing import Protocol, TypedDict, Literal
+
+
+if TYPE_CHECKING:
+    import pyarrow.lib
+
+
+class SupportsGeoInterface(Protocol):
+    __geo_interface__: MutableMapping
+
+
+DataType = Union[dict, pd.DataFrame, SupportsGeoInterface, DataFrameLike]
+TDataType = TypeVar("TDataType", bound=DataType)
+
+VegaLiteDataDict = Dict[str, Union[str, dict, List[dict]]]
+ToValuesReturnType = Dict[str, Union[dict, List[dict]]]
+
+
+# ==============================================================================
+# Data transformer registry
+#
+# A data transformer is a callable that takes a supported data type and returns
+# a transformed dictionary version of it which is compatible with the VegaLite schema.
+# The dict objects will be the Data portion of the VegaLite schema.
+#
+# Renderers only deal with the dict form of a
+# VegaLite spec, after the Data model has been put into a schema compliant
+# form.
+# ==============================================================================
+class DataTransformerType(Protocol):
+    def __call__(self, data: DataType, **kwargs) -> VegaLiteDataDict:
+        pass
+
+
+class DataTransformerRegistry(PluginRegistry[DataTransformerType]):
+    _global_settings = {"consolidate_datasets": True}
+
+    @property
+    def consolidate_datasets(self) -> bool:
+        return self._global_settings["consolidate_datasets"]
+
+    @consolidate_datasets.setter
+    def consolidate_datasets(self, value: bool) -> None:
+        self._global_settings["consolidate_datasets"] = value
+
+
+# ==============================================================================
+class MaxRowsError(Exception):
+    """Raised when a data model has too many rows."""
+
+    pass
+
+
+@curried.curry
+def limit_rows(data: TDataType, max_rows: Optional[int] = 5000) -> TDataType:
+    """Raise MaxRowsError if the data model has more than max_rows.
+
+    If max_rows is None, then do not perform any check.
+    """
+    check_data_type(data)
+
+    def raise_max_rows_error():
+        raise MaxRowsError(
+            "The number of rows in your dataset is greater "
+            f"than the maximum allowed ({max_rows}).\n\n"
+            "Try enabling the VegaFusion data transformer which "
+            "raises this limit by pre-evaluating data\n"
+            "transformations in Python.\n"
+            "    >> import altair as alt\n"
+            '    >> alt.data_transformers.enable("vegafusion")\n\n'
+            "Or, see https://altair-viz.github.io/user_guide/large_datasets.html "
+            "for additional information\n"
+            "on how to plot large datasets."
+        )
+
+    if hasattr(data, "__geo_interface__"):
+        if data.__geo_interface__["type"] == "FeatureCollection":
+            values = data.__geo_interface__["features"]
+        else:
+            values = data.__geo_interface__
+    elif isinstance(data, pd.DataFrame):
+        values = data
+    elif isinstance(data, dict):
+        if "values" in data:
+            values = data["values"]
+        else:
+            # mypy gets confused as it doesn't see Dict[Any, Any]
+            # as equivalent to TDataType
+            return data  # type: ignore[return-value]
+    elif isinstance(data, DataFrameLike):
+        pa_table = arrow_table_from_dfi_dataframe(data)
+        if max_rows is not None and pa_table.num_rows > max_rows:
+            raise_max_rows_error()
+        # Return pyarrow Table instead of input since the
+        # `arrow_table_from_dfi_dataframe` call above may be expensive
+        return pa_table
+
+    if max_rows is not None and len(values) > max_rows:
+        raise_max_rows_error()
+
+    return data
+
+
+@curried.curry
+def sample(
+    data: DataType, n: Optional[int] = None, frac: Optional[float] = None
+) -> Optional[Union[pd.DataFrame, Dict[str, Sequence], "pyarrow.lib.Table"]]:
+    """Reduce the size of the data model by sampling without replacement."""
+    check_data_type(data)
+    if isinstance(data, pd.DataFrame):
+        return data.sample(n=n, frac=frac)
+    elif isinstance(data, dict):
+        if "values" in data:
+            values = data["values"]
+            if not n:
+                if frac is None:
+                    raise ValueError(
+                        "frac cannot be None if n is None and data is a dictionary"
+                    )
+                n = int(frac * len(values))
+            values = random.sample(values, n)
+            return {"values": values}
+        else:
+            # Maybe this should raise an error or return something useful?
+            return None
+    elif isinstance(data, DataFrameLike):
+        pa_table = arrow_table_from_dfi_dataframe(data)
+        if not n:
+            if frac is None:
+                raise ValueError(
+                    "frac cannot be None if n is None with this data input type"
+                )
+            n = int(frac * len(pa_table))
+        indices = random.sample(range(len(pa_table)), n)
+        return pa_table.take(indices)
+    else:
+        # Maybe this should raise an error or return something useful? Currently,
+        # if data is of type SupportsGeoInterface it lands here
+        return None
+
+
+class _JsonFormatDict(TypedDict):
+    type: Literal["json"]
+
+
+class _CsvFormatDict(TypedDict):
+    type: Literal["csv"]
+
+
+class _ToJsonReturnUrlDict(TypedDict):
+    url: str
+    format: _JsonFormatDict
+
+
+class _ToCsvReturnUrlDict(TypedDict):
+    url: str
+    format: _CsvFormatDict
+
+
+@curried.curry
+def to_json(
+    data: DataType,
+    prefix: str = "altair-data",
+    extension: str = "json",
+    filename: str = "{prefix}-{hash}.{extension}",
+    urlpath: str = "",
+) -> _ToJsonReturnUrlDict:
+    """
+    Write the data model to a .json file and return a url based data model.
+    """
+    data_json = _data_to_json_string(data)
+    data_hash = _compute_data_hash(data_json)
+    filename = filename.format(prefix=prefix, hash=data_hash, extension=extension)
+    with open(filename, "w") as f:
+        f.write(data_json)
+    return {"url": os.path.join(urlpath, filename), "format": {"type": "json"}}
+
+
+@curried.curry
+def to_csv(
+    data: Union[dict, pd.DataFrame, DataFrameLike],
+    prefix: str = "altair-data",
+    extension: str = "csv",
+    filename: str = "{prefix}-{hash}.{extension}",
+    urlpath: str = "",
+) -> _ToCsvReturnUrlDict:
+    """Write the data model to a .csv file and return a url based data model."""
+    data_csv = _data_to_csv_string(data)
+    data_hash = _compute_data_hash(data_csv)
+    filename = filename.format(prefix=prefix, hash=data_hash, extension=extension)
+    with open(filename, "w") as f:
+        f.write(data_csv)
+    return {"url": os.path.join(urlpath, filename), "format": {"type": "csv"}}
+
+
+@curried.curry
+def to_values(data: DataType) -> ToValuesReturnType:
+    """Replace a DataFrame by a data model with values."""
+    check_data_type(data)
+    if hasattr(data, "__geo_interface__"):
+        if isinstance(data, pd.DataFrame):
+            data = sanitize_dataframe(data)
+        # Maybe the type could be further clarified here that it is
+        # SupportGeoInterface and then the ignore statement is not needed?
+        data_sanitized = sanitize_geo_interface(data.__geo_interface__)  # type: ignore[arg-type]
+        return {"values": data_sanitized}
+    elif isinstance(data, pd.DataFrame):
+        data = sanitize_dataframe(data)
+        return {"values": data.to_dict(orient="records")}
+    elif isinstance(data, dict):
+        if "values" not in data:
+            raise KeyError("values expected in data dict, but not present.")
+        return data
+    elif isinstance(data, DataFrameLike):
+        pa_table = sanitize_arrow_table(arrow_table_from_dfi_dataframe(data))
+        return {"values": pa_table.to_pylist()}
+    else:
+        # Should never reach this state as tested by check_data_type
+        raise ValueError("Unrecognized data type: {}".format(type(data)))
+
+
+def check_data_type(data: DataType) -> None:
+    if not isinstance(data, (dict, pd.DataFrame, DataFrameLike)) and not any(
+        hasattr(data, attr) for attr in ["__geo_interface__"]
+    ):
+        raise TypeError(
+            "Expected dict, DataFrame or a __geo_interface__ attribute, got: {}".format(
+                type(data)
+            )
+        )
+
+
+# ==============================================================================
+# Private utilities
+# ==============================================================================
+def _compute_data_hash(data_str: str) -> str:
+    return hashlib.sha256(data_str.encode()).hexdigest()[:32]
+
+
+def _data_to_json_string(data: DataType) -> str:
+    """Return a JSON string representation of the input data"""
+    check_data_type(data)
+    if hasattr(data, "__geo_interface__"):
+        if isinstance(data, pd.DataFrame):
+            data = sanitize_dataframe(data)
+        # Maybe the type could be further clarified here that it is
+        # SupportGeoInterface and then the ignore statement is not needed?
+        data = sanitize_geo_interface(data.__geo_interface__)  # type: ignore[arg-type]
+        return json.dumps(data)
+    elif isinstance(data, pd.DataFrame):
+        data = sanitize_dataframe(data)
+        return data.to_json(orient="records", double_precision=15)
+    elif isinstance(data, dict):
+        if "values" not in data:
+            raise KeyError("values expected in data dict, but not present.")
+        return json.dumps(data["values"], sort_keys=True)
+    elif isinstance(data, DataFrameLike):
+        pa_table = arrow_table_from_dfi_dataframe(data)
+        return json.dumps(pa_table.to_pylist())
+    else:
+        raise NotImplementedError(
+            "to_json only works with data expressed as " "a DataFrame or as a dict"
+        )
+
+
+def _data_to_csv_string(data: Union[dict, pd.DataFrame, DataFrameLike]) -> str:
+    """return a CSV string representation of the input data"""
+    check_data_type(data)
+    if hasattr(data, "__geo_interface__"):
+        raise NotImplementedError(
+            "to_csv does not work with data that "
+            "contains the __geo_interface__ attribute"
+        )
+    elif isinstance(data, pd.DataFrame):
+        data = sanitize_dataframe(data)
+        return data.to_csv(index=False)
+    elif isinstance(data, dict):
+        if "values" not in data:
+            raise KeyError("values expected in data dict, but not present")
+        return pd.DataFrame.from_dict(data["values"]).to_csv(index=False)
+    elif isinstance(data, DataFrameLike):
+        # experimental interchange dataframe support
+        import pyarrow as pa
+        import pyarrow.csv as pa_csv
+
+        pa_table = arrow_table_from_dfi_dataframe(data)
+        csv_buffer = pa.BufferOutputStream()
+        pa_csv.write_csv(pa_table, csv_buffer)
+        return csv_buffer.getvalue().to_pybytes().decode()
+    else:
+        raise NotImplementedError(
+            "to_csv only works with data expressed as " "a DataFrame or as a dict"
+        )
+
+
+def pipe(data, *funcs):
+    """
+    Pipe a value through a sequence of functions
+
+    Deprecated: use toolz.curried.pipe() instead.
+    """
+    warnings.warn(
+        "alt.pipe() is deprecated, and will be removed in a future release. "
+        "Use toolz.curried.pipe() instead.",
+        AltairDeprecationWarning,
+        stacklevel=1,
+    )
+    return curried.pipe(data, *funcs)
+
+
+def curry(*args, **kwargs):
+    """Curry a callable function
+
+    Deprecated: use toolz.curried.curry() instead.
+    """
+    warnings.warn(
+        "alt.curry() is deprecated, and will be removed in a future release. "
+        "Use toolz.curried.curry() instead.",
+        AltairDeprecationWarning,
+        stacklevel=1,
+    )
+    return curried.curry(*args, **kwargs)
+
+
+def arrow_table_from_dfi_dataframe(dfi_df: DataFrameLike) -> "pyarrow.lib.Table":
+    """Convert a DataFrame Interchange Protocol compatible object to an Arrow Table"""
+    import pyarrow as pa
+
+    # First check if the dataframe object has a method to convert to arrow.
+    # Give this preference over the pyarrow from_dataframe function since the object
+    # has more control over the conversion, and may have broader compatibility.
+    # This is the case for Polars, which supports Date32 columns in direct conversion
+    # while pyarrow does not yet support this type in from_dataframe
+    for convert_method_name in ("arrow", "to_arrow", "to_arrow_table"):
+        convert_method = getattr(dfi_df, convert_method_name, None)
+        if callable(convert_method):
+            result = convert_method()
+            if isinstance(result, pa.Table):
+                return result
+
+    pi = import_pyarrow_interchange()
+    return pi.from_dataframe(dfi_df)
diff --git a/llm/Lib/site-packages/altair/utils/deprecation.py b/llm/Lib/site-packages/altair/utils/deprecation.py
new file mode 100644
index 0000000000000000000000000000000000000000..f0ed26ae98f9a71512f85ca589fd4e160033f97b
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/deprecation.py
@@ -0,0 +1,71 @@
+import warnings
+import functools
+
+
+class AltairDeprecationWarning(UserWarning):
+    pass
+
+
+def deprecated(message=None):
+    """Decorator to deprecate a function or class.
+
+    Parameters
+    ----------
+    message : string (optional)
+        The deprecation message
+    """
+
+    def wrapper(obj):
+        return _deprecate(obj, message=message)
+
+    return wrapper
+
+
+def _deprecate(obj, name=None, message=None):
+    """Return a version of a class or function that raises a deprecation warning.
+
+    Parameters
+    ----------
+    obj : class or function
+        The object to create a deprecated version of.
+    name : string (optional)
+        The name of the deprecated object
+    message : string (optional)
+        The deprecation message
+
+    Returns
+    -------
+    deprecated_obj :
+        The deprecated version of obj
+
+    Examples
+    --------
+    >>> class Foo: pass
+    >>> OldFoo = _deprecate(Foo, "OldFoo")
+    >>> f = OldFoo()  # doctest: +SKIP
+    AltairDeprecationWarning: alt.OldFoo is deprecated. Use alt.Foo instead.
+    """
+    if message is None:
+        message = "alt.{} is deprecated. Use alt.{} instead." "".format(
+            name, obj.__name__
+        )
+    if isinstance(obj, type):
+        return type(
+            name,
+            (obj,),
+            {
+                "__doc__": obj.__doc__,
+                "__init__": _deprecate(obj.__init__, "__init__", message),
+            },
+        )
+    elif callable(obj):
+
+        @functools.wraps(obj)
+        def new_obj(*args, **kwargs):
+            warnings.warn(message, AltairDeprecationWarning, stacklevel=1)
+            return obj(*args, **kwargs)
+
+        new_obj._deprecated = True
+        return new_obj
+    else:
+        raise ValueError("Cannot deprecate object of type {}".format(type(obj)))
diff --git a/llm/Lib/site-packages/altair/utils/display.py b/llm/Lib/site-packages/altair/utils/display.py
new file mode 100644
index 0000000000000000000000000000000000000000..c1585eda2e0489f7386dc66c08f2d0121125cd28
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/display.py
@@ -0,0 +1,229 @@
+import json
+import pkgutil
+import textwrap
+from typing import Callable, Dict, Optional, Tuple, Any, Union
+import uuid
+
+from ._vegafusion_data import compile_with_vegafusion, using_vegafusion
+from .plugin_registry import PluginRegistry, PluginEnabler
+from .mimebundle import spec_to_mimebundle
+from .schemapi import validate_jsonschema
+
+
+# ==============================================================================
+# Renderer registry
+# ==============================================================================
+# MimeBundleType needs to be the same as what are acceptable return values
+# for _repr_mimebundle_,
+# see https://ipython.readthedocs.io/en/stable/config/integrating.html#MyObject._repr_mimebundle_
+MimeBundleDataType = Dict[str, Any]
+MimeBundleMetaDataType = Dict[str, Any]
+MimeBundleType = Union[
+    MimeBundleDataType, Tuple[MimeBundleDataType, MimeBundleMetaDataType]
+]
+RendererType = Callable[..., MimeBundleType]
+# Subtype of MimeBundleType as more specific in the values of the dictionaries
+DefaultRendererReturnType = Tuple[
+    Dict[str, Union[str, dict]], Dict[str, Dict[str, Any]]
+]
+
+
+class RendererRegistry(PluginRegistry[RendererType]):
+    entrypoint_err_messages = {
+        "notebook": textwrap.dedent(
+            """
+            To use the 'notebook' renderer, you must install the vega package
+            and the associated Jupyter extension.
+            See https://altair-viz.github.io/getting_started/installation.html
+            for more information.
+            """
+        ),
+        "altair_viewer": textwrap.dedent(
+            """
+            To use the 'altair_viewer' renderer, you must install the altair_viewer
+            package; see http://github.com/altair-viz/altair_viewer/
+            for more information.
+            """
+        ),
+    }
+
+    def set_embed_options(
+        self,
+        defaultStyle: Optional[Union[bool, str]] = None,
+        renderer: Optional[str] = None,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+        padding: Optional[int] = None,
+        scaleFactor: Optional[float] = None,
+        actions: Optional[Union[bool, Dict[str, bool]]] = None,
+        format_locale: Optional[Union[str, dict]] = None,
+        time_format_locale: Optional[Union[str, dict]] = None,
+        **kwargs,
+    ) -> PluginEnabler:
+        """Set options for embeddings of Vega & Vega-Lite charts.
+
+        Options are fully documented at https://github.com/vega/vega-embed.
+        Similar to the `enable()` method, this can be used as either
+        a persistent global switch, or as a temporary local setting using
+        a context manager (i.e. a `with` statement).
+
+        Parameters
+        ----------
+        defaultStyle : bool or string
+            Specify a default stylesheet for embed actions.
+        renderer : string
+            The renderer to use for the view. One of "canvas" (default) or "svg"
+        width : integer
+            The view width in pixels
+        height : integer
+            The view height in pixels
+        padding : integer
+            The view padding in pixels
+        scaleFactor : number
+            The number by which to multiply the width and height (default 1)
+            of an exported PNG or SVG image.
+        actions : bool or dict
+            Determines if action links ("Export as PNG/SVG", "View Source",
+            "View Vega" (only for Vega-Lite), "Open in Vega Editor") are
+            included with the embedded view. If the value is true, all action
+            links will be shown and none if the value is false. This property
+            can take a key-value mapping object that maps keys (export, source,
+            compiled, editor) to boolean values for determining if
+            each action link should be shown.
+        format_locale : str or dict
+            d3-format locale name or dictionary. Defaults to "en-US" for United States English.
+            See https://github.com/d3/d3-format/tree/main/locale for available names and example
+            definitions.
+        time_format_locale : str or dict
+            d3-time-format locale name or dictionary. Defaults to "en-US" for United States English.
+            See https://github.com/d3/d3-time-format/tree/main/locale for available names and example
+            definitions.
+        **kwargs :
+            Additional options are passed directly to embed options.
+        """
+        options: Dict[str, Optional[Union[bool, str, float, Dict[str, bool]]]] = {
+            "defaultStyle": defaultStyle,
+            "renderer": renderer,
+            "width": width,
+            "height": height,
+            "padding": padding,
+            "scaleFactor": scaleFactor,
+            "actions": actions,
+            "formatLocale": format_locale,
+            "timeFormatLocale": time_format_locale,
+        }
+        kwargs.update({key: val for key, val in options.items() if val is not None})
+        return self.enable(None, embed_options=kwargs)
+
+
+# ==============================================================================
+# VegaLite v1/v2 renderer logic
+# ==============================================================================
+
+
+class Displayable:
+    """A base display class for VegaLite v1/v2.
+
+    This class takes a VegaLite v1/v2 spec and does the following:
+
+    1. Optionally validates the spec against a schema.
+    2. Uses the RendererPlugin to grab a renderer and call it when the
+       IPython/Jupyter display method (_repr_mimebundle_) is called.
+
+    The spec passed to this class must be fully schema compliant and already
+    have the data portion of the spec fully processed and ready to serialize.
+    In practice, this means, the data portion of the spec should have been passed
+    through appropriate data model transformers.
+    """
+
+    renderers: Optional[RendererRegistry] = None
+    schema_path = ("altair", "")
+
+    def __init__(self, spec: dict, validate: bool = False) -> None:
+        self.spec = spec
+        self.validate = validate
+        self._validate()
+
+    def _validate(self) -> None:
+        """Validate the spec against the schema."""
+        data = pkgutil.get_data(*self.schema_path)
+        assert data is not None
+        schema_dict: dict = json.loads(data.decode("utf-8"))
+        validate_jsonschema(
+            self.spec,
+            schema_dict,
+        )
+
+    def _repr_mimebundle_(
+        self, include: Any = None, exclude: Any = None
+    ) -> MimeBundleType:
+        """Return a MIME bundle for display in Jupyter frontends."""
+        if self.renderers is not None:
+            renderer_func = self.renderers.get()
+            assert renderer_func is not None
+            return renderer_func(self.spec)
+        else:
+            return {}
+
+
+def default_renderer_base(
+    spec: dict, mime_type: str, str_repr: str, **options
+) -> DefaultRendererReturnType:
+    """A default renderer for Vega or VegaLite that works for modern frontends.
+
+    This renderer works with modern frontends (JupyterLab, nteract) that know
+    how to render the custom VegaLite MIME type listed above.
+    """
+    # Local import to avoid circular ImportError
+    from altair.vegalite.v5.display import VEGA_MIME_TYPE, VEGALITE_MIME_TYPE
+
+    assert isinstance(spec, dict)
+    bundle: Dict[str, Union[str, dict]] = {}
+    metadata: Dict[str, Dict[str, Any]] = {}
+
+    if using_vegafusion():
+        spec = compile_with_vegafusion(spec)
+
+        # Swap mimetype from Vega-Lite to Vega.
+        # If mimetype was JSON, leave it alone
+        if mime_type == VEGALITE_MIME_TYPE:
+            mime_type = VEGA_MIME_TYPE
+
+    bundle[mime_type] = spec
+    bundle["text/plain"] = str_repr
+    if options:
+        metadata[mime_type] = options
+    return bundle, metadata
+
+
+def json_renderer_base(
+    spec: dict, str_repr: str, **options
+) -> DefaultRendererReturnType:
+    """A renderer that returns a MIME type of application/json.
+
+    In JupyterLab/nteract this is rendered as a nice JSON tree.
+    """
+    return default_renderer_base(
+        spec, mime_type="application/json", str_repr=str_repr, **options
+    )
+
+
+class HTMLRenderer:
+    """Object to render charts as HTML, with a unique output div each time"""
+
+    def __init__(self, output_div: str = "altair-viz-{}", **kwargs) -> None:
+        self._output_div = output_div
+        self.kwargs = kwargs
+
+    @property
+    def output_div(self) -> str:
+        return self._output_div.format(uuid.uuid4().hex)
+
+    def __call__(self, spec: dict, **metadata) -> Dict[str, str]:
+        kwargs = self.kwargs.copy()
+        kwargs.update(metadata)
+        # To get proper return value type, would need to write complex
+        # overload signatures for spec_to_mimebundle based on `format`
+        return spec_to_mimebundle(  # type: ignore[return-value]
+            spec, format="html", output_div=self.output_div, **kwargs
+        )
diff --git a/llm/Lib/site-packages/altair/utils/execeval.py b/llm/Lib/site-packages/altair/utils/execeval.py
new file mode 100644
index 0000000000000000000000000000000000000000..7e98fd378bfee470858b3a79e4ab3473086f2eef
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/execeval.py
@@ -0,0 +1,53 @@
+import ast
+import sys
+
+
+class _CatchDisplay:
+    """Class to temporarily catch sys.displayhook"""
+
+    def __init__(self):
+        self.output = None
+
+    def __enter__(self):
+        self.old_hook = sys.displayhook
+        sys.displayhook = self
+        return self
+
+    def __exit__(self, type, value, traceback):
+        sys.displayhook = self.old_hook
+        # Returning False will cause exceptions to propagate
+        return False
+
+    def __call__(self, output):
+        self.output = output
+
+
+def eval_block(code, namespace=None, filename="<string>"):
+    """
+    Execute a multi-line block of code in the given namespace
+
+    If the final statement in the code is an expression, return
+    the result of the expression.
+    """
+    tree = ast.parse(code, filename="<ast>", mode="exec")
+    if namespace is None:
+        namespace = {}
+    catch_display = _CatchDisplay()
+
+    if isinstance(tree.body[-1], ast.Expr):
+        to_exec, to_eval = tree.body[:-1], tree.body[-1:]
+    else:
+        to_exec, to_eval = tree.body, []
+
+    for node in to_exec:
+        compiled = compile(ast.Module([node], []), filename=filename, mode="exec")
+        exec(compiled, namespace)
+
+    with catch_display:
+        for node in to_eval:
+            compiled = compile(
+                ast.Interactive([node]), filename=filename, mode="single"
+            )
+            exec(compiled, namespace)
+
+    return catch_display.output
diff --git a/llm/Lib/site-packages/altair/utils/html.py b/llm/Lib/site-packages/altair/utils/html.py
new file mode 100644
index 0000000000000000000000000000000000000000..6cd89b2ddef982aad26e77970fbc020131f250fe
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/html.py
@@ -0,0 +1,303 @@
+import json
+from typing import Optional, Dict
+
+import jinja2
+
+from altair.utils._importers import import_vl_convert, vl_version_for_vl_convert
+
+HTML_TEMPLATE = jinja2.Template(
+    """
+{%- if fullhtml -%}
+<!DOCTYPE html>
+<html>
+<head>
+{%- endif %}
+  <style>
+    #{{ output_div }}.vega-embed {
+      width: 100%;
+      display: flex;
+    }
+
+    #{{ output_div }}.vega-embed details,
+    #{{ output_div }}.vega-embed details summary {
+      position: relative;
+    }
+  </style>
+{%- if not requirejs %}
+  <script type="text/javascript" src="{{ base_url }}/vega@{{ vega_version }}"></script>
+  {%- if mode == 'vega-lite' %}
+  <script type="text/javascript" src="{{ base_url }}/vega-lite@{{ vegalite_version }}"></script>
+  {%- endif %}
+  <script type="text/javascript" src="{{ base_url }}/vega-embed@{{ vegaembed_version }}"></script>
+{%- endif %}
+{%- if fullhtml %}
+{%- if requirejs %}
+<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.6/require.min.js"></script>
+<script>
+requirejs.config({
+    "paths": {
+        "vega": "{{ base_url }}/vega@{{ vega_version }}?noext",
+        "vega-lib": "{{ base_url }}/vega-lib?noext",
+        "vega-lite": "{{ base_url }}/vega-lite@{{ vegalite_version }}?noext",
+        "vega-embed": "{{ base_url }}/vega-embed@{{ vegaembed_version }}?noext",
+    }
+});
+</script>
+{%- endif %}
+</head>
+<body>
+{%- endif %}
+  <div id="{{ output_div }}"></div>
+  <script>
+    {%- if requirejs and not fullhtml %}
+    requirejs.config({
+        "paths": {
+            "vega": "{{ base_url }}/vega@{{ vega_version }}?noext",
+            "vega-lib": "{{ base_url }}/vega-lib?noext",
+            "vega-lite": "{{ base_url }}/vega-lite@{{ vegalite_version }}?noext",
+            "vega-embed": "{{ base_url }}/vega-embed@{{ vegaembed_version }}?noext",
+        }
+    });
+    {% endif %}
+    {% if requirejs -%}
+    require(['vega-embed'],
+    {%- else -%}
+    (
+    {%- endif -%}
+    function(vegaEmbed) {
+      var spec = {{ spec }};
+      var embedOpt = {{ embed_options }};
+
+      function showError(el, error){
+          el.innerHTML = ('<div style="color:red;">'
+                          + '<p>JavaScript Error: ' + error.message + '</p>'
+                          + "<p>This usually means there's a typo in your chart specification. "
+                          + "See the javascript console for the full traceback.</p>"
+                          + '</div>');
+          throw error;
+      }
+      const el = document.getElementById('{{ output_div }}');
+      vegaEmbed("#{{ output_div }}", spec, embedOpt)
+        .catch(error => showError(el, error));
+    }){% if not requirejs %}(vegaEmbed){% endif %};
+
+  </script>
+{%- if fullhtml %}
+</body>
+</html>
+{%- endif %}
+"""
+)
+
+
+HTML_TEMPLATE_UNIVERSAL = jinja2.Template(
+    """
+<style>
+  #{{ output_div }}.vega-embed {
+    width: 100%;
+    display: flex;
+  }
+
+  #{{ output_div }}.vega-embed details,
+  #{{ output_div }}.vega-embed details summary {
+    position: relative;
+  }
+</style>
+<div id="{{ output_div }}"></div>
+<script type="text/javascript">
+  var VEGA_DEBUG = (typeof VEGA_DEBUG == "undefined") ? {} : VEGA_DEBUG;
+  (function(spec, embedOpt){
+    let outputDiv = document.currentScript.previousElementSibling;
+    if (outputDiv.id !== "{{ output_div }}") {
+      outputDiv = document.getElementById("{{ output_div }}");
+    }
+    const paths = {
+      "vega": "{{ base_url }}/vega@{{ vega_version }}?noext",
+      "vega-lib": "{{ base_url }}/vega-lib?noext",
+      "vega-lite": "{{ base_url }}/vega-lite@{{ vegalite_version }}?noext",
+      "vega-embed": "{{ base_url }}/vega-embed@{{ vegaembed_version }}?noext",
+    };
+
+    function maybeLoadScript(lib, version) {
+      var key = `${lib.replace("-", "")}_version`;
+      return (VEGA_DEBUG[key] == version) ?
+        Promise.resolve(paths[lib]) :
+        new Promise(function(resolve, reject) {
+          var s = document.createElement('script');
+          document.getElementsByTagName("head")[0].appendChild(s);
+          s.async = true;
+          s.onload = () => {
+            VEGA_DEBUG[key] = version;
+            return resolve(paths[lib]);
+          };
+          s.onerror = () => reject(`Error loading script: ${paths[lib]}`);
+          s.src = paths[lib];
+        });
+    }
+
+    function showError(err) {
+      outputDiv.innerHTML = `<div class="error" style="color:red;">${err}</div>`;
+      throw err;
+    }
+
+    function displayChart(vegaEmbed) {
+      vegaEmbed(outputDiv, spec, embedOpt)
+        .catch(err => showError(`Javascript Error: ${err.message}<br>This usually means there's a typo in your chart specification. See the javascript console for the full traceback.`));
+    }
+
+    if(typeof define === "function" && define.amd) {
+      requirejs.config({paths});
+      require(["vega-embed"], displayChart, err => showError(`Error loading script: ${err.message}`));
+    } else {
+      maybeLoadScript("vega", "{{vega_version}}")
+        .then(() => maybeLoadScript("vega-lite", "{{vegalite_version}}"))
+        .then(() => maybeLoadScript("vega-embed", "{{vegaembed_version}}"))
+        .catch(showError)
+        .then(() => displayChart(vegaEmbed));
+    }
+  })({{ spec }}, {{ embed_options }});
+</script>
+"""
+)
+
+
+# This is like the HTML_TEMPLATE template, but includes vega javascript inline
+# so that the resulting file is not dependent on external resources. This was
+# ported over from altair_saver.
+#
+# implies requirejs=False and full_html=True
+INLINE_HTML_TEMPLATE = jinja2.Template(
+    """\
+<!DOCTYPE html>
+<html>
+<head>
+  <style>
+    #{{ output_div }}.vega-embed {
+      width: 100%;
+      display: flex;
+    }
+
+    #{{ output_div }}.vega-embed details,
+    #{{ output_div }}.vega-embed details summary {
+      position: relative;
+    }
+  </style>
+  <script type="text/javascript">
+    // vega-embed.js bundle with Vega-Lite version v{{ vegalite_version }}
+    {{ vegaembed_script }}
+  </script>
+</head>
+<body>
+<div class="vega-visualization" id="{{ output_div }}"></div>
+<script type="text/javascript">
+  const spec = {{ spec }};
+  const embedOpt = {{ embed_options }};
+  vegaEmbed('#{{ output_div }}', spec, embedOpt).catch(console.error);
+</script>
+</body>
+</html>
+"""
+)
+
+
+TEMPLATES: Dict[str, jinja2.Template] = {
+    "standard": HTML_TEMPLATE,
+    "universal": HTML_TEMPLATE_UNIVERSAL,
+    "inline": INLINE_HTML_TEMPLATE,
+}
+
+
+def spec_to_html(
+    spec: dict,
+    mode: str,
+    vega_version: Optional[str],
+    vegaembed_version: Optional[str],
+    vegalite_version: Optional[str] = None,
+    base_url: str = "https://cdn.jsdelivr.net/npm",
+    output_div: str = "vis",
+    embed_options: Optional[dict] = None,
+    json_kwds: Optional[dict] = None,
+    fullhtml: bool = True,
+    requirejs: bool = False,
+    template: str = "standard",
+) -> str:
+    """Embed a Vega/Vega-Lite spec into an HTML page
+
+    Parameters
+    ----------
+    spec : dict
+        a dictionary representing a vega-lite plot spec.
+    mode : string {'vega' | 'vega-lite'}
+        The rendering mode. This value is overridden by embed_options['mode'],
+        if it is present.
+    vega_version : string
+        For html output, the version of vega.js to use.
+    vegalite_version : string
+        For html output, the version of vegalite.js to use.
+    vegaembed_version : string
+        For html output, the version of vegaembed.js to use.
+    base_url : string (optional)
+        The base url from which to load the javascript libraries.
+    output_div : string (optional)
+        The id of the div element where the plot will be shown.
+    embed_options : dict (optional)
+        Dictionary of options to pass to the vega-embed script. Default
+        entry is {'mode': mode}.
+    json_kwds : dict (optional)
+        Dictionary of keywords to pass to json.dumps().
+    fullhtml : boolean (optional)
+        If True (default) then return a full html page. If False, then return
+        an HTML snippet that can be embedded into an HTML page.
+    requirejs : boolean (optional)
+        If False (default) then load libraries from base_url using <script>
+        tags. If True, then load libraries using requirejs
+    template : jinja2.Template or string (optional)
+        Specify the template to use (default = 'standard'). If template is a
+        string, it must be one of {'universal', 'standard', 'inline'}. Otherwise, it
+        can be a jinja2.Template object containing a custom template.
+
+    Returns
+    -------
+    output : string
+        an HTML string for rendering the chart.
+    """
+    embed_options = embed_options or {}
+    json_kwds = json_kwds or {}
+
+    mode = embed_options.setdefault("mode", mode)
+
+    if mode not in ["vega", "vega-lite"]:
+        raise ValueError("mode must be either 'vega' or 'vega-lite'")
+
+    if vega_version is None:
+        raise ValueError("must specify vega_version")
+
+    if vegaembed_version is None:
+        raise ValueError("must specify vegaembed_version")
+
+    if mode == "vega-lite" and vegalite_version is None:
+        raise ValueError("must specify vega-lite version for mode='vega-lite'")
+
+    render_kwargs = {}
+    if template == "inline":
+        vlc = import_vl_convert()
+        vl_version = vl_version_for_vl_convert()
+        render_kwargs["vegaembed_script"] = vlc.javascript_bundle(vl_version=vl_version)
+
+    jinja_template = TEMPLATES.get(template, template)
+    if not hasattr(jinja_template, "render"):
+        raise ValueError("Invalid template: {0}".format(jinja_template))
+
+    return jinja_template.render(
+        spec=json.dumps(spec, **json_kwds),
+        embed_options=json.dumps(embed_options),
+        mode=mode,
+        vega_version=vega_version,
+        vegalite_version=vegalite_version,
+        vegaembed_version=vegaembed_version,
+        base_url=base_url,
+        output_div=output_div,
+        fullhtml=fullhtml,
+        requirejs=requirejs,
+        **render_kwargs,
+    )
diff --git a/llm/Lib/site-packages/altair/utils/mimebundle.py b/llm/Lib/site-packages/altair/utils/mimebundle.py
new file mode 100644
index 0000000000000000000000000000000000000000..49a1f5557340624b51a271bef8a92bbf3f02f781
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/mimebundle.py
@@ -0,0 +1,338 @@
+from typing import Literal, Optional, Union, cast, Tuple
+
+from .deprecation import AltairDeprecationWarning
+from .html import spec_to_html
+from ._importers import import_vl_convert, vl_version_for_vl_convert
+import struct
+import warnings
+
+
+def spec_to_mimebundle(
+    spec: dict,
+    format: Literal["html", "json", "png", "svg", "pdf", "vega", "vega-lite"],
+    mode: Optional[Literal["vega-lite"]] = None,
+    vega_version: Optional[str] = None,
+    vegaembed_version: Optional[str] = None,
+    vegalite_version: Optional[str] = None,
+    embed_options: Optional[dict] = None,
+    engine: Optional[Literal["vl-convert", "altair_saver"]] = None,
+    **kwargs,
+) -> Union[dict, Tuple[dict, dict]]:
+    """Convert a vega-lite specification to a mimebundle
+
+    The mimebundle type is controlled by the ``format`` argument, which can be
+    one of the following ['html', 'json', 'png', 'svg', 'pdf', 'vega', 'vega-lite']
+
+    Parameters
+    ----------
+    spec : dict
+        a dictionary representing a vega-lite plot spec
+    format : string {'html', 'json', 'png', 'svg', 'pdf', 'vega', 'vega-lite'}
+        the file format to be saved.
+    mode : string {'vega-lite'}
+        The rendering mode.
+    vega_version : string
+        The version of vega.js to use
+    vegaembed_version : string
+        The version of vegaembed.js to use
+    vegalite_version : string
+        The version of vegalite.js to use. Only required if mode=='vega-lite'
+    embed_options : dict (optional)
+        The vegaEmbed options dictionary. Defaults to the embed options set with
+        alt.renderers.set_embed_options().
+        (See https://github.com/vega/vega-embed for details)
+    engine: string {'vl-convert', 'altair_saver'}
+        the conversion engine to use for 'png', 'svg', 'pdf', and 'vega' formats
+    **kwargs :
+        Additional arguments will be passed to the generating function
+
+    Returns
+    -------
+    output : dict
+        a mime-bundle representing the image
+
+    Note
+    ----
+    The png, svg, pdf, and vega outputs require the altair_saver package
+    """
+    # Local import to avoid circular ImportError
+    from altair.utils.display import (
+        compile_with_vegafusion,
+        using_vegafusion,
+    )
+    from altair import renderers
+
+    if mode != "vega-lite":
+        raise ValueError("mode must be 'vega-lite'")
+
+    internal_mode: Literal["vega-lite", "vega"] = mode
+    if using_vegafusion():
+        spec = compile_with_vegafusion(spec)
+        internal_mode = "vega"
+
+    # Default to the embed options set by alt.renderers.set_embed_options
+    if embed_options is None:
+        final_embed_options = renderers.options.get("embed_options", {})
+    else:
+        final_embed_options = embed_options
+
+    embed_options = preprocess_embed_options(final_embed_options)
+
+    if format in ["png", "svg", "pdf", "vega"]:
+        format = cast(Literal["png", "svg", "pdf", "vega"], format)
+        return _spec_to_mimebundle_with_engine(
+            spec,
+            format,
+            internal_mode,
+            engine=engine,
+            format_locale=embed_options.get("formatLocale", None),
+            time_format_locale=embed_options.get("timeFormatLocale", None),
+            **kwargs,
+        )
+    if format == "html":
+        html = spec_to_html(
+            spec,
+            mode=internal_mode,
+            vega_version=vega_version,
+            vegaembed_version=vegaembed_version,
+            vegalite_version=vegalite_version,
+            embed_options=embed_options,
+            **kwargs,
+        )
+        return {"text/html": html}
+    if format == "vega-lite":
+        if vegalite_version is None:
+            raise ValueError("Must specify vegalite_version")
+        return {"application/vnd.vegalite.v{}+json".format(vegalite_version[0]): spec}
+    if format == "json":
+        return {"application/json": spec}
+    raise ValueError(
+        "format must be one of "
+        "['html', 'json', 'png', 'svg', 'pdf', 'vega', 'vega-lite']"
+    )
+
+
+def _spec_to_mimebundle_with_engine(
+    spec: dict,
+    format: Literal["png", "svg", "pdf", "vega"],
+    mode: Literal["vega-lite", "vega"],
+    format_locale: Optional[Union[str, dict]] = None,
+    time_format_locale: Optional[Union[str, dict]] = None,
+    **kwargs,
+) -> Union[dict, Tuple[dict, dict]]:
+    """Helper for Vega-Lite to mimebundle conversions that require an engine
+
+    Parameters
+    ----------
+    spec : dict
+        a dictionary representing a vega-lite plot spec
+    format : string {'png', 'svg', 'pdf', 'vega'}
+        the format of the mimebundle to be returned
+    mode : string {'vega-lite', 'vega'}
+        The rendering mode.
+    engine: string {'vl-convert', 'altair_saver'}
+        the conversion engine to use
+    format_locale : str or dict
+        d3-format locale name or dictionary. Defaults to "en-US" for United States English.
+        See https://github.com/d3/d3-format/tree/main/locale for available names and example
+        definitions.
+    time_format_locale : str or dict
+        d3-time-format locale name or dictionary. Defaults to "en-US" for United States English.
+        See https://github.com/d3/d3-time-format/tree/main/locale for available names and example
+        definitions.
+    **kwargs :
+        Additional arguments will be passed to the conversion function
+    """
+    # Normalize the engine string (if any) by lower casing
+    # and removing underscores and hyphens
+    engine = kwargs.pop("engine", None)
+    normalized_engine = _validate_normalize_engine(engine, format)
+
+    if normalized_engine == "vlconvert":
+        vlc = import_vl_convert()
+        vl_version = vl_version_for_vl_convert()
+        if format == "vega":
+            if mode == "vega":
+                vg = spec
+            else:
+                vg = vlc.vegalite_to_vega(spec, vl_version=vl_version)
+            return {"application/vnd.vega.v5+json": vg}
+        elif format == "svg":
+            if mode == "vega":
+                svg = vlc.vega_to_svg(
+                    spec,
+                    format_locale=format_locale,
+                    time_format_locale=time_format_locale,
+                )
+            else:
+                svg = vlc.vegalite_to_svg(
+                    spec,
+                    vl_version=vl_version,
+                    format_locale=format_locale,
+                    time_format_locale=time_format_locale,
+                )
+            return {"image/svg+xml": svg}
+        elif format == "png":
+            scale = kwargs.get("scale_factor", 1)
+            # The default ppi for a PNG file is 72
+            default_ppi = 72
+            ppi = kwargs.get("ppi", default_ppi)
+            if mode == "vega":
+                png = vlc.vega_to_png(
+                    spec,
+                    scale=scale,
+                    ppi=ppi,
+                    format_locale=format_locale,
+                    time_format_locale=time_format_locale,
+                )
+            else:
+                png = vlc.vegalite_to_png(
+                    spec,
+                    vl_version=vl_version,
+                    scale=scale,
+                    ppi=ppi,
+                    format_locale=format_locale,
+                    time_format_locale=time_format_locale,
+                )
+            factor = ppi / default_ppi
+            w, h = _pngxy(png)
+            return {"image/png": png}, {
+                "image/png": {"width": w / factor, "height": h / factor}
+            }
+        elif format == "pdf":
+            scale = kwargs.get("scale_factor", 1)
+            if mode == "vega":
+                pdf = vlc.vega_to_pdf(
+                    spec,
+                    scale=scale,
+                    format_locale=format_locale,
+                    time_format_locale=time_format_locale,
+                )
+            else:
+                pdf = vlc.vegalite_to_pdf(
+                    spec,
+                    vl_version=vl_version,
+                    scale=scale,
+                    format_locale=format_locale,
+                    time_format_locale=time_format_locale,
+                )
+            return {"application/pdf": pdf}
+        else:
+            # This should be validated above
+            # but raise exception for the sake of future development
+            raise ValueError("Unexpected format {fmt!r}".format(fmt=format))
+    elif normalized_engine == "altairsaver":
+        warnings.warn(
+            "The altair_saver export engine is deprecated and will be removed in a future version.\n"
+            "Please migrate to the vl-convert engine",
+            AltairDeprecationWarning,
+            stacklevel=1,
+        )
+        import altair_saver
+
+        return altair_saver.render(spec, format, mode=mode, **kwargs)
+    else:
+        # This should be validated above
+        # but raise exception for the sake of future development
+        raise ValueError(
+            "Unexpected normalized_engine {eng!r}".format(eng=normalized_engine)
+        )
+
+
+def _validate_normalize_engine(
+    engine: Optional[Literal["vl-convert", "altair_saver"]],
+    format: Literal["png", "svg", "pdf", "vega"],
+) -> str:
+    """Helper to validate and normalize the user-provided engine
+
+    engine : {None, 'vl-convert', 'altair_saver'}
+        the user-provided engine string
+    format : string {'png', 'svg', 'pdf', 'vega'}
+        the format of the mimebundle to be returned
+    """
+    # Try to import vl_convert
+    try:
+        vlc = import_vl_convert()
+    except ImportError:
+        vlc = None
+
+    # Try to import altair_saver
+    try:
+        import altair_saver
+    except ImportError:
+        altair_saver = None
+
+    # Normalize engine string by lower casing and removing underscores and hyphens
+    normalized_engine = (
+        None if engine is None else engine.lower().replace("-", "").replace("_", "")
+    )
+
+    # Validate or infer default value of normalized_engine
+    if normalized_engine == "vlconvert":
+        if vlc is None:
+            raise ValueError(
+                "The 'vl-convert' conversion engine requires the vl-convert-python package"
+            )
+    elif normalized_engine == "altairsaver":
+        if altair_saver is None:
+            raise ValueError(
+                "The 'altair_saver' conversion engine requires the altair_saver package"
+            )
+    elif normalized_engine is None:
+        if vlc is not None:
+            normalized_engine = "vlconvert"
+        elif altair_saver is not None:
+            normalized_engine = "altairsaver"
+        else:
+            raise ValueError(
+                "Saving charts in {fmt!r} format requires the vl-convert-python or altair_saver package: "
+                "see http://github.com/altair-viz/altair_saver/".format(fmt=format)
+            )
+    else:
+        raise ValueError(
+            "Invalid conversion engine {engine!r}. Expected one of {valid!r}".format(
+                engine=engine, valid=("vl-convert", "altair_saver")
+            )
+        )
+    return normalized_engine
+
+
+def _pngxy(data):
+    """read the (width, height) from a PNG header
+
+    Taken from IPython.display
+    """
+    ihdr = data.index(b"IHDR")
+    # next 8 bytes are width/height
+    return struct.unpack(">ii", data[ihdr + 4 : ihdr + 12])
+
+
+def preprocess_embed_options(embed_options: dict) -> dict:
+    """Preprocess embed options to a form compatible with Vega Embed
+
+    Parameters
+    ----------
+    embed_options : dict
+        The embed options dictionary to preprocess.
+
+    Returns
+    -------
+    embed_opts : dict
+        The preprocessed embed options dictionary.
+    """
+    embed_options = (embed_options or {}).copy()
+
+    # Convert locale strings to objects compatible with Vega Embed using vl-convert
+    format_locale = embed_options.get("formatLocale", None)
+    if isinstance(format_locale, str):
+        vlc = import_vl_convert()
+        embed_options["formatLocale"] = vlc.get_format_locale(format_locale)
+
+    time_format_locale = embed_options.get("timeFormatLocale", None)
+    if isinstance(time_format_locale, str):
+        vlc = import_vl_convert()
+        embed_options["timeFormatLocale"] = vlc.get_time_format_locale(
+            time_format_locale
+        )
+
+    return embed_options
diff --git a/llm/Lib/site-packages/altair/utils/plugin_registry.py b/llm/Lib/site-packages/altair/utils/plugin_registry.py
new file mode 100644
index 0000000000000000000000000000000000000000..f6281ed14da02dfb0a387693565248ffe2103702
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/plugin_registry.py
@@ -0,0 +1,224 @@
+from typing import Any, Dict, List, Optional, Generic, TypeVar, cast
+from types import TracebackType
+
+from importlib.metadata import entry_points
+
+from toolz import curry
+
+
+PluginType = TypeVar("PluginType")
+
+
+class NoSuchEntryPoint(Exception):
+    def __init__(self, group, name):
+        self.group = group
+        self.name = name
+
+    def __str__(self):
+        return f"No {self.name!r} entry point found in group {self.group!r}"
+
+
+class PluginEnabler:
+    """Context manager for enabling plugins
+
+    This object lets you use enable() as a context manager to
+    temporarily enable a given plugin::
+
+        with plugins.enable('name'):
+            do_something()  # 'name' plugin temporarily enabled
+        # plugins back to original state
+    """
+
+    def __init__(self, registry: "PluginRegistry", name: str, **options):
+        self.registry = registry  # type: PluginRegistry
+        self.name = name  # type: str
+        self.options = options  # type: Dict[str, Any]
+        self.original_state = registry._get_state()  # type: Dict[str, Any]
+        self.registry._enable(name, **options)
+
+    def __enter__(self) -> "PluginEnabler":
+        return self
+
+    def __exit__(self, typ: type, value: Exception, traceback: TracebackType) -> None:
+        self.registry._set_state(self.original_state)
+
+    def __repr__(self) -> str:
+        return "{}.enable({!r})".format(self.registry.__class__.__name__, self.name)
+
+
+class PluginRegistry(Generic[PluginType]):
+    """A registry for plugins.
+
+    This is a plugin registry that allows plugins to be loaded/registered
+    in two ways:
+
+    1. Through an explicit call to ``.register(name, value)``.
+    2. By looking for other Python packages that are installed and provide
+       a setuptools entry point group.
+
+    When you create an instance of this class, provide the name of the
+    entry point group to use::
+
+        reg = PluginRegister('my_entrypoint_group')
+
+    """
+
+    # this is a mapping of name to error message to allow custom error messages
+    # in case an entrypoint is not found
+    entrypoint_err_messages = {}  # type: Dict[str, str]
+
+    # global settings is a key-value mapping of settings that are stored globally
+    # in the registry rather than passed to the plugins
+    _global_settings = {}  # type: Dict[str, Any]
+
+    def __init__(self, entry_point_group: str = "", plugin_type: type = object):
+        """Create a PluginRegistry for a named entry point group.
+
+        Parameters
+        ==========
+        entry_point_group: str
+            The name of the entry point group.
+        plugin_type: object
+            A type that will optionally be used for runtime type checking of
+            loaded plugins using isinstance.
+        """
+        self.entry_point_group = entry_point_group  # type: str
+        self.plugin_type = plugin_type  # type: Optional[type]
+        self._active = None  # type: Optional[PluginType]
+        self._active_name = ""  # type: str
+        self._plugins = {}  # type: Dict[str, PluginType]
+        self._options = {}  # type: Dict[str, Any]
+        self._global_settings = self.__class__._global_settings.copy()  # type: dict
+
+    def register(self, name: str, value: Optional[PluginType]) -> Optional[PluginType]:
+        """Register a plugin by name and value.
+
+        This method is used for explicit registration of a plugin and shouldn't be
+        used to manage entry point managed plugins, which are auto-loaded.
+
+        Parameters
+        ==========
+        name: str
+            The name of the plugin.
+        value: PluginType or None
+            The actual plugin object to register or None to unregister that plugin.
+
+        Returns
+        =======
+        plugin: PluginType or None
+            The plugin that was registered or unregistered.
+        """
+        if value is None:
+            return self._plugins.pop(name, None)
+        else:
+            assert isinstance(value, self.plugin_type)  # type: ignore[arg-type]  # Should ideally be fixed by better annotating plugin_type
+            self._plugins[name] = value
+            return value
+
+    def names(self) -> List[str]:
+        """List the names of the registered and entry points plugins."""
+        exts = list(self._plugins.keys())
+        e_points = importlib_metadata_get(self.entry_point_group)
+        more_exts = [ep.name for ep in e_points]
+        exts.extend(more_exts)
+        return sorted(set(exts))
+
+    def _get_state(self) -> Dict[str, Any]:
+        """Return a dictionary representing the current state of the registry"""
+        return {
+            "_active": self._active,
+            "_active_name": self._active_name,
+            "_plugins": self._plugins.copy(),
+            "_options": self._options.copy(),
+            "_global_settings": self._global_settings.copy(),
+        }
+
+    def _set_state(self, state: Dict[str, Any]) -> None:
+        """Reset the state of the registry"""
+        assert set(state.keys()) == {
+            "_active",
+            "_active_name",
+            "_plugins",
+            "_options",
+            "_global_settings",
+        }
+        for key, val in state.items():
+            setattr(self, key, val)
+
+    def _enable(self, name: str, **options) -> None:
+        if name not in self._plugins:
+            try:
+                (ep,) = [
+                    ep
+                    for ep in importlib_metadata_get(self.entry_point_group)
+                    if ep.name == name
+                ]
+            except ValueError as err:
+                if name in self.entrypoint_err_messages:
+                    raise ValueError(self.entrypoint_err_messages[name]) from err
+                else:
+                    raise NoSuchEntryPoint(self.entry_point_group, name) from err
+            value = cast(PluginType, ep.load())
+            self.register(name, value)
+        self._active_name = name
+        self._active = self._plugins[name]
+        for key in set(options.keys()) & set(self._global_settings.keys()):
+            self._global_settings[key] = options.pop(key)
+        self._options = options
+
+    def enable(self, name: Optional[str] = None, **options) -> PluginEnabler:
+        """Enable a plugin by name.
+
+        This can be either called directly, or used as a context manager.
+
+        Parameters
+        ----------
+        name : string (optional)
+            The name of the plugin to enable. If not specified, then use the
+            current active name.
+        **options :
+            Any additional parameters will be passed to the plugin as keyword
+            arguments
+
+        Returns
+        -------
+        PluginEnabler:
+            An object that allows enable() to be used as a context manager
+        """
+        if name is None:
+            name = self.active
+        return PluginEnabler(self, name, **options)
+
+    @property
+    def active(self) -> str:
+        """Return the name of the currently active plugin"""
+        return self._active_name
+
+    @property
+    def options(self) -> Dict[str, Any]:
+        """Return the current options dictionary"""
+        return self._options
+
+    def get(self) -> Optional[PluginType]:
+        """Return the currently active plugin."""
+        if self._options:
+            return curry(self._active, **self._options)
+        else:
+            return self._active
+
+    def __repr__(self) -> str:
+        return "{}(active={!r}, registered={!r})" "".format(
+            self.__class__.__name__, self._active_name, list(self.names())
+        )
+
+
+def importlib_metadata_get(group):
+    ep = entry_points()
+    # 'select' was introduced in Python 3.10 and 'get' got deprecated
+    # We don't check for Python version here as by checking with hasattr we
+    # also get compatibility with the importlib_metadata package which had a different
+    # deprecation cycle for 'get'
+    if hasattr(ep, "select"):
+        return ep.select(group=group)
+    else:
+        return ep.get(group, [])
diff --git a/llm/Lib/site-packages/altair/utils/save.py b/llm/Lib/site-packages/altair/utils/save.py
new file mode 100644
index 0000000000000000000000000000000000000000..1784cc43ec446a4751eb668230b3e8bc9d115666
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/save.py
@@ -0,0 +1,207 @@
+import json
+import pathlib
+import warnings
+from typing import IO, Union, Optional, Literal
+
+from .mimebundle import spec_to_mimebundle
+from ..vegalite.v5.data import data_transformers
+from altair.utils._vegafusion_data import using_vegafusion
+
+
+def write_file_or_filename(
+    fp: Union[str, pathlib.PurePath, IO],
+    content: Union[str, bytes],
+    mode: str = "w",
+    encoding: Optional[str] = None,
+) -> None:
+    """Write content to fp, whether fp is a string, a pathlib Path or a
+    file-like object"""
+    if isinstance(fp, str) or isinstance(fp, pathlib.PurePath):
+        with open(file=fp, mode=mode, encoding=encoding) as f:
+            f.write(content)
+    else:
+        fp.write(content)
+
+
+def set_inspect_format_argument(
+    format: Optional[str], fp: Union[str, pathlib.PurePath, IO], inline: bool
+) -> str:
+    """Inspect the format argument in the save function"""
+    if format is None:
+        if isinstance(fp, str):
+            format = fp.split(".")[-1]
+        elif isinstance(fp, pathlib.PurePath):
+            format = fp.suffix.lstrip(".")
+        else:
+            raise ValueError(
+                "must specify file format: "
+                "['png', 'svg', 'pdf', 'html', 'json', 'vega']"
+            )
+
+    if format != "html" and inline:
+        warnings.warn("inline argument ignored for non HTML formats.", stacklevel=1)
+
+    return format
+
+
+def set_inspect_mode_argument(
+    mode: Optional[Literal["vega-lite"]],
+    embed_options: dict,
+    spec: dict,
+    vegalite_version: Optional[str],
+) -> Literal["vega-lite"]:
+    """Inspect the mode argument in the save function"""
+    if mode is None:
+        if "mode" in embed_options:
+            mode = embed_options["mode"]
+        elif "$schema" in spec:
+            mode = spec["$schema"].split("/")[-2]
+        else:
+            mode = "vega-lite"
+
+    if mode != "vega-lite":
+        raise ValueError("mode must be 'vega-lite', " "not '{}'".format(mode))
+
+    if mode == "vega-lite" and vegalite_version is None:
+        raise ValueError("must specify vega-lite version")
+
+    return mode
+
+
+def save(
+    chart,
+    fp: Union[str, pathlib.PurePath, IO],
+    vega_version: Optional[str],
+    vegaembed_version: Optional[str],
+    format: Optional[Literal["json", "html", "png", "svg", "pdf"]] = None,
+    mode: Optional[Literal["vega-lite"]] = None,
+    vegalite_version: Optional[str] = None,
+    embed_options: Optional[dict] = None,
+    json_kwds: Optional[dict] = None,
+    webdriver: Optional[Literal["chrome", "firefox"]] = None,
+    scale_factor: float = 1,
+    engine: Optional[Literal["vl-convert", "altair_saver"]] = None,
+    inline: bool = False,
+    **kwargs,
+) -> None:
+    """Save a chart to file in a variety of formats
+
+    Supported formats are [json, html, png, svg, pdf]
+
+    Parameters
+    ----------
+    chart : alt.Chart
+        the chart instance to save
+    fp : string filename, pathlib.Path or file-like object
+        file to which to write the chart.
+    format : string (optional)
+        the format to write: one of ['json', 'html', 'png', 'svg', 'pdf'].
+        If not specified, the format will be determined from the filename.
+    mode : string (optional)
+        Must be 'vega-lite'. If not specified, then infer the mode from
+        the '$schema' property of the spec, or the ``opt`` dictionary.
+        If it's not specified in either of those places, then use 'vega-lite'.
+    vega_version : string (optional)
+        For html output, the version of vega.js to use
+    vegalite_version : string (optional)
+        For html output, the version of vegalite.js to use
+    vegaembed_version : string (optional)
+        For html output, the version of vegaembed.js to use
+    embed_options : dict (optional)
+        The vegaEmbed options dictionary. Default is {}
+        (See https://github.com/vega/vega-embed for details)
+    json_kwds : dict (optional)
+        Additional keyword arguments are passed to the output method
+        associated with the specified format.
+    webdriver : string {'chrome' | 'firefox'} (optional)
+        Webdriver to use for png, svg, or pdf output when using altair_saver engine
+    scale_factor : float (optional)
+        scale_factor to use to change size/resolution of png or svg output
+    engine: string {'vl-convert', 'altair_saver'}
+        the conversion engine to use for 'png', 'svg', and 'pdf' formats
+    inline: bool (optional)
+        If False (default), the required JavaScript libraries are loaded
+        from a CDN location in the resulting html file.
+        If True, the required JavaScript libraries are inlined into the resulting
+        html file so that it will work without an internet connection.
+        The vl-convert-python package is required if True.
+    **kwargs :
+        additional kwargs passed to spec_to_mimebundle.
+    """
+    if json_kwds is None:
+        json_kwds = {}
+
+    format = set_inspect_format_argument(format, fp, inline)  # type: ignore[assignment]
+
+    def perform_save():
+        spec = chart.to_dict(context={"pre_transform": False})
+
+        inner_mode = set_inspect_mode_argument(
+            mode, embed_options or {}, spec, vegalite_version
+        )
+
+        if format == "json":
+            json_spec = json.dumps(spec, **json_kwds)
+            write_file_or_filename(
+                fp, json_spec, mode="w", encoding=kwargs.get("encoding", "utf-8")
+            )
+        elif format == "html":
+            if inline:
+                kwargs["template"] = "inline"
+            mimebundle = spec_to_mimebundle(
+                spec=spec,
+                format=format,
+                mode=inner_mode,
+                vega_version=vega_version,
+                vegalite_version=vegalite_version,
+                vegaembed_version=vegaembed_version,
+                embed_options=embed_options,
+                json_kwds=json_kwds,
+                **kwargs,
+            )
+            write_file_or_filename(
+                fp,
+                mimebundle["text/html"],
+                mode="w",
+                encoding=kwargs.get("encoding", "utf-8"),
+            )
+        elif format in ["png", "svg", "pdf", "vega"]:
+            mimebundle = spec_to_mimebundle(
+                spec=spec,
+                format=format,
+                mode=inner_mode,
+                vega_version=vega_version,
+                vegalite_version=vegalite_version,
+                vegaembed_version=vegaembed_version,
+                embed_options=embed_options,
+                webdriver=webdriver,
+                scale_factor=scale_factor,
+                engine=engine,
+                **kwargs,
+            )
+            if format == "png":
+                write_file_or_filename(fp, mimebundle[0]["image/png"], mode="wb")
+            elif format == "pdf":
+                write_file_or_filename(fp, mimebundle["application/pdf"], mode="wb")
+            else:
+                encoding = kwargs.get("encoding", "utf-8")
+                write_file_or_filename(
+                    fp, mimebundle["image/svg+xml"], mode="w", encoding=encoding
+                )
+        else:
+            raise ValueError("Unsupported format: '{}'".format(format))
+
+    if using_vegafusion():
+        # When the vegafusion data transformer is enabled, transforms will be
+        # evaluated during save and the resulting data will be included in the
+        # vega specification that is saved.
+        with data_transformers.disable_max_rows():
+            perform_save()
+    else:
+        # Temporarily turn off any data transformers so that all data is inlined
+        # when calling chart.to_dict. This is relevant for vl-convert which cannot access
+        # local json files which could be created by a json data transformer. Furthermore,
+        # we don't exit the with statement until this function completed due to the issue
+        # described at https://github.com/vega/vl-convert/issues/31
+        with data_transformers.enable("default"), data_transformers.disable_max_rows():
+            perform_save()
diff --git a/llm/Lib/site-packages/altair/utils/schemapi.py b/llm/Lib/site-packages/altair/utils/schemapi.py
new file mode 100644
index 0000000000000000000000000000000000000000..11332a1ea73e18ea4e16b70ce9fb09cecfe46015
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/schemapi.py
@@ -0,0 +1,1334 @@
+# The contents of this file are automatically written by
+# tools/generate_schema_wrapper.py. Do not modify directly.
+import collections
+import contextlib
+import copy
+import inspect
+import json
+import sys
+import textwrap
+from typing import (
+    Any,
+    Sequence,
+    List,
+    Dict,
+    Optional,
+    DefaultDict,
+    Tuple,
+    Iterable,
+    Type,
+    Generator,
+    Union,
+    overload,
+    Literal,
+    TypeVar,
+)
+from itertools import zip_longest
+from importlib.metadata import version as importlib_version
+from typing import Final
+
+import jsonschema
+import jsonschema.exceptions
+import jsonschema.validators
+import numpy as np
+import pandas as pd
+from packaging.version import Version
+
+# This leads to circular imports with the vegalite module. Currently, this works
+# but be aware that when you access it in this script, the vegalite module might
+# not yet be fully instantiated in case your code is being executed during import time
+from altair import vegalite
+
+if sys.version_info >= (3, 11):
+    from typing import Self
+else:
+    from typing_extensions import Self
+
+TSchemaBase = TypeVar("TSchemaBase", bound=Type["SchemaBase"])
+
+ValidationErrorList = List[jsonschema.exceptions.ValidationError]
+GroupedValidationErrors = Dict[str, ValidationErrorList]
+
+# This URI is arbitrary and could be anything else. It just cannot be an empty
+# string as we need to reference the schema registered in
+# the referencing.Registry.
+_VEGA_LITE_ROOT_URI: Final = "urn:vega-lite-schema"
+
+# Ideally, jsonschema specification would be parsed from the current Vega-Lite
+# schema instead of being hardcoded here as a default value.
+# However, due to circular imports between this module and the altair.vegalite
+# modules, this information is not yet available at this point as altair.vegalite
+# is only partially loaded. The draft version which is used is unlikely to
+# change often so it's ok to keep this. There is also a test which validates
+# that this value is always the same as in the Vega-Lite schema.
+_DEFAULT_JSON_SCHEMA_DRAFT_URL: Final = "http://json-schema.org/draft-07/schema#"
+
+
+# If DEBUG_MODE is True, then schema objects are converted to dict and
+# validated at creation time. This slows things down, particularly for
+# larger specs, but leads to much more useful tracebacks for the user.
+# Individual schema classes can override this by setting the
+# class-level _class_is_valid_at_instantiation attribute to False
+DEBUG_MODE: bool = True
+
+jsonschema_version_str = importlib_version("jsonschema")
+
+
+def enable_debug_mode() -> None:
+    global DEBUG_MODE
+    DEBUG_MODE = True
+
+
+def disable_debug_mode() -> None:
+    global DEBUG_MODE
+    DEBUG_MODE = False
+
+
+@contextlib.contextmanager
+def debug_mode(arg: bool) -> Generator[None, None, None]:
+    global DEBUG_MODE
+    original = DEBUG_MODE
+    DEBUG_MODE = arg
+    try:
+        yield
+    finally:
+        DEBUG_MODE = original
+
+
+@overload
+def validate_jsonschema(
+    spec: Dict[str, Any],
+    schema: Dict[str, Any],
+    rootschema: Optional[Dict[str, Any]] = ...,
+    *,
+    raise_error: Literal[True] = ...,
+) -> None: ...
+
+
+@overload
+def validate_jsonschema(
+    spec: Dict[str, Any],
+    schema: Dict[str, Any],
+    rootschema: Optional[Dict[str, Any]] = ...,
+    *,
+    raise_error: Literal[False],
+) -> Optional[jsonschema.exceptions.ValidationError]: ...
+
+
+def validate_jsonschema(
+    spec,
+    schema,
+    rootschema=None,
+    *,
+    raise_error=True,
+):
+    """Validates the passed in spec against the schema in the context of the
+    rootschema. If any errors are found, they are deduplicated and prioritized
+    and only the most relevant errors are kept. Errors are then either raised
+    or returned, depending on the value of `raise_error`.
+    """
+    errors = _get_errors_from_spec(spec, schema, rootschema=rootschema)
+    if errors:
+        leaf_errors = _get_leaves_of_error_tree(errors)
+        grouped_errors = _group_errors_by_json_path(leaf_errors)
+        grouped_errors = _subset_to_most_specific_json_paths(grouped_errors)
+        grouped_errors = _deduplicate_errors(grouped_errors)
+
+        # Nothing special about this first error but we need to choose one
+        # which can be raised
+        main_error = list(grouped_errors.values())[0][0]
+        # All errors are then attached as a new attribute to ValidationError so that
+        # they can be used in SchemaValidationError to craft a more helpful
+        # error message. Setting a new attribute like this is not ideal as
+        # it then no longer matches the type ValidationError. It would be better
+        # to refactor this function to never raise but only return errors.
+        main_error._all_errors = grouped_errors
+        if raise_error:
+            raise main_error
+        else:
+            return main_error
+    else:
+        return None
+
+
+def _get_errors_from_spec(
+    spec: Dict[str, Any],
+    schema: Dict[str, Any],
+    rootschema: Optional[Dict[str, Any]] = None,
+) -> ValidationErrorList:
+    """Uses the relevant jsonschema validator to validate the passed in spec
+    against the schema using the rootschema to resolve references.
+    The schema and rootschema themselves are not validated but instead considered
+    as valid.
+    """
+    # We don't use jsonschema.validate as this would validate the schema itself.
+    # Instead, we pass the schema directly to the validator class. This is done for
+    # two reasons: The schema comes from Vega-Lite and is not based on the user
+    # input, therefore there is no need to validate it in the first place. Furthermore,
+    # the "uri-reference" format checker fails for some of the references as URIs in
+    # "$ref" are not encoded,
+    # e.g. '#/definitions/ValueDefWithCondition<MarkPropFieldOrDatumDef,
+    # (Gradient|string|null)>' would be a valid $ref in a Vega-Lite schema but
+    # it is not a valid URI reference due to the characters such as '<'.
+
+    json_schema_draft_url = _get_json_schema_draft_url(rootschema or schema)
+    validator_cls = jsonschema.validators.validator_for(
+        {"$schema": json_schema_draft_url}
+    )
+    validator_kwargs: Dict[str, Any] = {}
+    if hasattr(validator_cls, "FORMAT_CHECKER"):
+        validator_kwargs["format_checker"] = validator_cls.FORMAT_CHECKER
+
+    if _use_referencing_library():
+        schema = _prepare_references_in_schema(schema)
+        validator_kwargs["registry"] = _get_referencing_registry(
+            rootschema or schema, json_schema_draft_url
+        )
+
+    else:
+        # No resolver is necessary if the schema is already the full schema
+        validator_kwargs["resolver"] = (
+            jsonschema.RefResolver.from_schema(rootschema)
+            if rootschema is not None
+            else None
+        )
+
+    validator = validator_cls(schema, **validator_kwargs)
+    errors = list(validator.iter_errors(spec))
+    return errors
+
+
+def _get_json_schema_draft_url(schema: dict) -> str:
+    return schema.get("$schema", _DEFAULT_JSON_SCHEMA_DRAFT_URL)
+
+
+def _use_referencing_library() -> bool:
+    """In version 4.18.0, the jsonschema package deprecated RefResolver in
+    favor of the referencing library."""
+    return Version(jsonschema_version_str) >= Version("4.18")
+
+
+def _prepare_references_in_schema(schema: Dict[str, Any]) -> Dict[str, Any]:
+    # Create a copy so that $ref is not modified in the original schema in case
+    # that it would still reference a dictionary which might be attached to
+    # an Altair class _schema attribute
+    schema = copy.deepcopy(schema)
+
+    def _prepare_refs(d: Dict[str, Any]) -> Dict[str, Any]:
+        """Add _VEGA_LITE_ROOT_URI in front of all $ref values. This function
+        recursively iterates through the whole dictionary."""
+        for key, value in d.items():
+            if key == "$ref":
+                d[key] = _VEGA_LITE_ROOT_URI + d[key]
+            else:
+                # $ref values can only be nested in dictionaries or lists
+                # as the passed in `d` dictionary comes from the Vega-Lite json schema
+                # and in json we only have arrays (-> lists in Python) and objects
+                # (-> dictionaries in Python) which we need to iterate through.
+                if isinstance(value, dict):
+                    d[key] = _prepare_refs(value)
+                elif isinstance(value, list):
+                    prepared_values = []
+                    for v in value:
+                        if isinstance(v, dict):
+                            v = _prepare_refs(v)
+                        prepared_values.append(v)
+                    d[key] = prepared_values
+        return d
+
+    schema = _prepare_refs(schema)
+    return schema
+
+
+# We do not annotate the return value here as the referencing library is not always
+# available and this function is only executed in those cases.
+def _get_referencing_registry(
+    rootschema: Dict[str, Any], json_schema_draft_url: Optional[str] = None
+):
+    # Referencing is a dependency of newer jsonschema versions, starting with the
+    # version that is specified in _use_referencing_library and we therefore
+    # can expect that it is installed if the function returns True.
+    # We ignore 'import' mypy errors which happen when the referencing library
+    # is not installed. That's ok as in these cases this function is not called.
+    # We also have to ignore 'unused-ignore' errors as mypy raises those in case
+    # referencing is installed.
+    import referencing  # type: ignore[import,unused-ignore]
+    import referencing.jsonschema  # type: ignore[import,unused-ignore]
+
+    if json_schema_draft_url is None:
+        json_schema_draft_url = _get_json_schema_draft_url(rootschema)
+
+    specification = referencing.jsonschema.specification_with(json_schema_draft_url)
+    resource = specification.create_resource(rootschema)
+    return referencing.Registry().with_resource(
+        uri=_VEGA_LITE_ROOT_URI, resource=resource
+    )
+
+
+def _json_path(err: jsonschema.exceptions.ValidationError) -> str:
+    """Drop in replacement for the .json_path property of the jsonschema
+    ValidationError class, which is not available as property for
+    ValidationError with jsonschema<4.0.1.
+    More info, see https://github.com/altair-viz/altair/issues/3038
+    """
+    path = "$"
+    for elem in err.absolute_path:
+        if isinstance(elem, int):
+            path += "[" + str(elem) + "]"
+        else:
+            path += "." + elem
+    return path
+
+
+def _group_errors_by_json_path(
+    errors: ValidationErrorList,
+) -> GroupedValidationErrors:
+    """Groups errors by the `json_path` attribute of the jsonschema ValidationError
+    class. This attribute contains the path to the offending element within
+    a chart specification and can therefore be considered as an identifier of an
+    'issue' in the chart that needs to be fixed.
+    """
+    errors_by_json_path = collections.defaultdict(list)
+    for err in errors:
+        err_key = getattr(err, "json_path", _json_path(err))
+        errors_by_json_path[err_key].append(err)
+    return dict(errors_by_json_path)
+
+
+def _get_leaves_of_error_tree(
+    errors: ValidationErrorList,
+) -> ValidationErrorList:
+    """For each error in `errors`, it traverses down the "error tree" that is generated
+    by the jsonschema library to find and return all "leaf" errors. These are errors
+    which have no further errors that caused it and so they are the most specific errors
+    with the most specific error messages.
+    """
+    leaves: ValidationErrorList = []
+    for err in errors:
+        if err.context:
+            # This means that the error `err` was caused by errors in subschemas.
+            # The list of errors from the subschemas are available in the property
+            # `context`.
+            leaves.extend(_get_leaves_of_error_tree(err.context))
+        else:
+            leaves.append(err)
+    return leaves
+
+
+def _subset_to_most_specific_json_paths(
+    errors_by_json_path: GroupedValidationErrors,
+) -> GroupedValidationErrors:
+    """Removes key (json path), value (errors) pairs where the json path is fully
+    contained in another json path. For example if `errors_by_json_path` has two
+    keys, `$.encoding.X` and `$.encoding.X.tooltip`, then the first one will be removed
+    and only the second one is returned. This is done under the assumption that
+    more specific json paths give more helpful error messages to the user.
+    """
+    errors_by_json_path_specific: GroupedValidationErrors = {}
+    for json_path, errors in errors_by_json_path.items():
+        if not _contained_at_start_of_one_of_other_values(
+            json_path, list(errors_by_json_path.keys())
+        ):
+            errors_by_json_path_specific[json_path] = errors
+    return errors_by_json_path_specific
+
+
+def _contained_at_start_of_one_of_other_values(x: str, values: Sequence[str]) -> bool:
+    # Does not count as "contained at start of other value" if the values are
+    # the same. These cases should be handled separately
+    return any(value.startswith(x) for value in values if x != value)
+
+
+def _deduplicate_errors(
+    grouped_errors: GroupedValidationErrors,
+) -> GroupedValidationErrors:
+    """Some errors have very similar error messages or are just in general not helpful
+    for a user. This function removes as many of these cases as possible and
+    can be extended over time to handle new cases that come up.
+    """
+    grouped_errors_deduplicated: GroupedValidationErrors = {}
+    for json_path, element_errors in grouped_errors.items():
+        errors_by_validator = _group_errors_by_validator(element_errors)
+
+        deduplication_functions = {
+            "enum": _deduplicate_enum_errors,
+            "additionalProperties": _deduplicate_additional_properties_errors,
+        }
+        deduplicated_errors: ValidationErrorList = []
+        for validator, errors in errors_by_validator.items():
+            deduplication_func = deduplication_functions.get(validator, None)
+            if deduplication_func is not None:
+                errors = deduplication_func(errors)
+            deduplicated_errors.extend(_deduplicate_by_message(errors))
+
+        # Removes any ValidationError "'value' is a required property" as these
+        # errors are unlikely to be the relevant ones for the user. They come from
+        # validation against a schema definition where the output of `alt.value`
+        # would be valid. However, if a user uses `alt.value`, the `value` keyword
+        # is included automatically from that function and so it's unlikely
+        # that this was what the user intended if the keyword is not present
+        # in the first place.
+        deduplicated_errors = [
+            err for err in deduplicated_errors if not _is_required_value_error(err)
+        ]
+
+        grouped_errors_deduplicated[json_path] = deduplicated_errors
+    return grouped_errors_deduplicated
+
+
+def _is_required_value_error(err: jsonschema.exceptions.ValidationError) -> bool:
+    return err.validator == "required" and err.validator_value == ["value"]
+
+
+def _group_errors_by_validator(errors: ValidationErrorList) -> GroupedValidationErrors:
+    """Groups the errors by the json schema "validator" that casued the error. For
+    example if the error is that a value is not one of an enumeration in the json schema
+    then the "validator" is `"enum"`, if the error is due to an unknown property that
+    was set although no additional properties are allowed then "validator" is
+    `"additionalProperties`, etc.
+    """
+    errors_by_validator: DefaultDict[str, ValidationErrorList] = (
+        collections.defaultdict(list)
+    )
+    for err in errors:
+        # Ignore mypy error as err.validator as it wrongly sees err.validator
+        # as of type Optional[Validator] instead of str which it is according
+        # to the documentation and all tested cases
+        errors_by_validator[err.validator].append(err)  # type: ignore[index]
+    return dict(errors_by_validator)
+
+
+def _deduplicate_enum_errors(errors: ValidationErrorList) -> ValidationErrorList:
+    """Deduplicate enum errors by removing the errors where the allowed values
+    are a subset of another error. For example, if `enum` contains two errors
+    and one has `validator_value` (i.e. accepted values) ["A", "B"] and the
+    other one ["A", "B", "C"] then the first one is removed and the final
+    `enum` list only contains the error with ["A", "B", "C"].
+    """
+    if len(errors) > 1:
+        # Values (and therefore `validator_value`) of an enum are always arrays,
+        # see https://json-schema.org/understanding-json-schema/reference/generic.html#enumerated-values
+        # which is why we can use join below
+        value_strings = [",".join(err.validator_value) for err in errors]
+        longest_enums: ValidationErrorList = []
+        for value_str, err in zip(value_strings, errors):
+            if not _contained_at_start_of_one_of_other_values(value_str, value_strings):
+                longest_enums.append(err)
+        errors = longest_enums
+    return errors
+
+
+def _deduplicate_additional_properties_errors(
+    errors: ValidationErrorList,
+) -> ValidationErrorList:
+    """If there are multiple additional property errors it usually means that
+    the offending element was validated against multiple schemas and
+    its parent is a common anyOf validator.
+    The error messages produced from these cases are usually
+    very similar and we just take the shortest one. For example,
+    the following 3 errors are raised for the `unknown` channel option in
+    `alt.X("variety", unknown=2)`:
+    - "Additional properties are not allowed ('unknown' was unexpected)"
+    - "Additional properties are not allowed ('field', 'unknown' were unexpected)"
+    - "Additional properties are not allowed ('field', 'type', 'unknown' were unexpected)"
+    """
+    if len(errors) > 1:
+        # Test if all parent errors are the same anyOf error and only do
+        # the prioritization in these cases. Can't think of a chart spec where this
+        # would not be the case but still allow for it below to not break anything.
+        parent = errors[0].parent
+        if (
+            parent is not None
+            and parent.validator == "anyOf"
+            # Use [1:] as don't have to check for first error as it was used
+            # above to define `parent`
+            and all(err.parent is parent for err in errors[1:])
+        ):
+            errors = [min(errors, key=lambda x: len(x.message))]
+    return errors
+
+
+def _deduplicate_by_message(errors: ValidationErrorList) -> ValidationErrorList:
+    """Deduplicate errors by message. This keeps the original order in case
+    it was chosen intentionally.
+    """
+    return list({e.message: e for e in errors}.values())
+
+
+def _subclasses(cls: type) -> Generator[type, None, None]:
+    """Breadth-first sequence of all classes which inherit from cls."""
+    seen = set()
+    current_set = {cls}
+    while current_set:
+        seen |= current_set
+        current_set = set.union(*(set(cls.__subclasses__()) for cls in current_set))
+        for cls in current_set - seen:
+            yield cls
+
+
+def _todict(obj: Any, context: Optional[Dict[str, Any]]) -> Any:
+    """Convert an object to a dict representation."""
+    if isinstance(obj, SchemaBase):
+        return obj.to_dict(validate=False, context=context)
+    elif isinstance(obj, (list, tuple, np.ndarray)):
+        return [_todict(v, context) for v in obj]
+    elif isinstance(obj, dict):
+        return {k: _todict(v, context) for k, v in obj.items() if v is not Undefined}
+    elif hasattr(obj, "to_dict"):
+        return obj.to_dict()
+    elif isinstance(obj, np.number):
+        return float(obj)
+    elif isinstance(obj, (pd.Timestamp, np.datetime64)):
+        return pd.Timestamp(obj).isoformat()
+    else:
+        return obj
+
+
+def _resolve_references(
+    schema: Dict[str, Any], rootschema: Optional[Dict[str, Any]] = None
+) -> Dict[str, Any]:
+    """Resolve schema references until there is no $ref anymore
+    in the top-level of the dictionary.
+    """
+    if _use_referencing_library():
+        registry = _get_referencing_registry(rootschema or schema)
+        # Using a different variable name to show that this is not the
+        # jsonschema.RefResolver but instead a Resolver from the referencing
+        # library
+        referencing_resolver = registry.resolver()
+        while "$ref" in schema:
+            schema = referencing_resolver.lookup(
+                _VEGA_LITE_ROOT_URI + schema["$ref"]
+            ).contents
+    else:
+        resolver = jsonschema.RefResolver.from_schema(rootschema or schema)
+        while "$ref" in schema:
+            with resolver.resolving(schema["$ref"]) as resolved:
+                schema = resolved
+    return schema
+
+
+class SchemaValidationError(jsonschema.ValidationError):
+    """A wrapper for jsonschema.ValidationError with friendlier traceback"""
+
+    def __init__(self, obj: "SchemaBase", err: jsonschema.ValidationError) -> None:
+        super().__init__(**err._contents())
+        self.obj = obj
+        self._errors: GroupedValidationErrors = getattr(
+            err, "_all_errors", {getattr(err, "json_path", _json_path(err)): [err]}
+        )
+        # This is the message from err
+        self._original_message = self.message
+        self.message = self._get_message()
+
+    def __str__(self) -> str:
+        return self.message
+
+    def _get_message(self) -> str:
+        def indent_second_line_onwards(message: str, indent: int = 4) -> str:
+            modified_lines: List[str] = []
+            for idx, line in enumerate(message.split("\n")):
+                if idx > 0 and len(line) > 0:
+                    line = " " * indent + line
+                modified_lines.append(line)
+            return "\n".join(modified_lines)
+
+        error_messages: List[str] = []
+        # Only show a maximum of 3 errors as else the final message returned by this
+        # method could get very long.
+        for errors in list(self._errors.values())[:3]:
+            error_messages.append(self._get_message_for_errors_group(errors))
+
+        message = ""
+        if len(error_messages) > 1:
+            error_messages = [
+                indent_second_line_onwards(f"Error {error_id}: {m}")
+                for error_id, m in enumerate(error_messages, start=1)
+            ]
+            message += "Multiple errors were found.\n\n"
+        message += "\n\n".join(error_messages)
+        return message
+
+    def _get_message_for_errors_group(
+        self,
+        errors: ValidationErrorList,
+    ) -> str:
+        if errors[0].validator == "additionalProperties":
+            # During development, we only found cases where an additionalProperties
+            # error was raised if that was the only error for the offending instance
+            # as identifiable by the json path. Therefore, we just check here the first
+            # error. However, other constellations might exist in which case
+            # this should be adapted so that other error messages are shown as well.
+            message = self._get_additional_properties_error_message(errors[0])
+        else:
+            message = self._get_default_error_message(errors=errors)
+
+        return message.strip()
+
+    def _get_additional_properties_error_message(
+        self,
+        error: jsonschema.exceptions.ValidationError,
+    ) -> str:
+        """Output all existing parameters when an unknown parameter is specified."""
+        altair_cls = self._get_altair_class_for_error(error)
+        param_dict_keys = inspect.signature(altair_cls).parameters.keys()
+        param_names_table = self._format_params_as_table(param_dict_keys)
+
+        # Error messages for these errors look like this:
+        # "Additional properties are not allowed ('unknown' was unexpected)"
+        # Line below extracts "unknown" from this string
+        parameter_name = error.message.split("('")[-1].split("'")[0]
+        message = f"""\
+`{altair_cls.__name__}` has no parameter named '{parameter_name}'
+
+Existing parameter names are:
+{param_names_table}
+See the help for `{altair_cls.__name__}` to read the full description of these parameters"""
+        return message
+
+    def _get_altair_class_for_error(
+        self, error: jsonschema.exceptions.ValidationError
+    ) -> Type["SchemaBase"]:
+        """Try to get the lowest class possible in the chart hierarchy so
+        it can be displayed in the error message. This should lead to more informative
+        error messages pointing the user closer to the source of the issue.
+        """
+        for prop_name in reversed(error.absolute_path):
+            # Check if str as e.g. first item can be a 0
+            if isinstance(prop_name, str):
+                potential_class_name = prop_name[0].upper() + prop_name[1:]
+                cls = getattr(vegalite, potential_class_name, None)
+                if cls is not None:
+                    break
+        else:
+            # Did not find a suitable class based on traversing the path so we fall
+            # back on the class of the top-level object which created
+            # the SchemaValidationError
+            cls = self.obj.__class__
+        return cls
+
+    @staticmethod
+    def _format_params_as_table(param_dict_keys: Iterable[str]) -> str:
+        """Format param names into a table so that they are easier to read"""
+        param_names: Tuple[str, ...]
+        name_lengths: Tuple[int, ...]
+        param_names, name_lengths = zip(
+            *[
+                (name, len(name))
+                for name in param_dict_keys
+                if name not in ["kwds", "self"]
+            ]
+        )
+        # Worst case scenario with the same longest param name in the same
+        # row for all columns
+        max_name_length = max(name_lengths)
+        max_column_width = 80
+        # Output a square table if not too big (since it is easier to read)
+        num_param_names = len(param_names)
+        square_columns = int(np.ceil(num_param_names**0.5))
+        columns = min(max_column_width // max_name_length, square_columns)
+
+        # Compute roughly equal column heights to evenly divide the param names
+        def split_into_equal_parts(n: int, p: int) -> List[int]:
+            return [n // p + 1] * (n % p) + [n // p] * (p - n % p)
+
+        column_heights = split_into_equal_parts(num_param_names, columns)
+
+        # Section the param names into columns and compute their widths
+        param_names_columns: List[Tuple[str, ...]] = []
+        column_max_widths: List[int] = []
+        last_end_idx: int = 0
+        for ch in column_heights:
+            param_names_columns.append(param_names[last_end_idx : last_end_idx + ch])
+            column_max_widths.append(
+                max([len(param_name) for param_name in param_names_columns[-1]])
+            )
+            last_end_idx = ch + last_end_idx
+
+        # Transpose the param name columns into rows to facilitate looping
+        param_names_rows: List[Tuple[str, ...]] = []
+        for li in zip_longest(*param_names_columns, fillvalue=""):
+            param_names_rows.append(li)
+        # Build the table as a string by iterating over and formatting the rows
+        param_names_table: str = ""
+        for param_names_row in param_names_rows:
+            for num, param_name in enumerate(param_names_row):
+                # Set column width based on the longest param in the column
+                max_name_length_column = column_max_widths[num]
+                column_pad = 3
+                param_names_table += "{:<{}}".format(
+                    param_name, max_name_length_column + column_pad
+                )
+                # Insert newlines and spacing after the last element in each row
+                if num == (len(param_names_row) - 1):
+                    param_names_table += "\n"
+        return param_names_table
+
+    def _get_default_error_message(
+        self,
+        errors: ValidationErrorList,
+    ) -> str:
+        bullet_points: List[str] = []
+        errors_by_validator = _group_errors_by_validator(errors)
+        if "enum" in errors_by_validator:
+            for error in errors_by_validator["enum"]:
+                bullet_points.append(f"one of {error.validator_value}")
+
+        if "type" in errors_by_validator:
+            types = [f"'{err.validator_value}'" for err in errors_by_validator["type"]]
+            point = "of type "
+            if len(types) == 1:
+                point += types[0]
+            elif len(types) == 2:
+                point += f"{types[0]} or {types[1]}"
+            else:
+                point += ", ".join(types[:-1]) + f", or {types[-1]}"
+            bullet_points.append(point)
+
+        # It should not matter which error is specifically used as they are all
+        # about the same offending instance (i.e. invalid value), so we can just
+        # take the first one
+        error = errors[0]
+        # Add a summary line when parameters are passed an invalid value
+        # For example: "'asdf' is an invalid value for `stack`
+        message = f"'{error.instance}' is an invalid value"
+        if error.absolute_path:
+            message += f" for `{error.absolute_path[-1]}`"
+
+        # Add bullet points
+        if len(bullet_points) == 0:
+            message += ".\n\n"
+        elif len(bullet_points) == 1:
+            message += f". Valid values are {bullet_points[0]}.\n\n"
+        else:
+            # We don't use .capitalize below to make the first letter uppercase
+            # as that makes the rest of the message lowercase
+            bullet_points = [point[0].upper() + point[1:] for point in bullet_points]
+            message += ". Valid values are:\n\n"
+            message += "\n".join([f"- {point}" for point in bullet_points])
+            message += "\n\n"
+
+        # Add unformatted messages of any remaining errors which were not
+        # considered so far. This is not expected to be used but more exists
+        # as a fallback for cases which were not known during development.
+        for validator, errors in errors_by_validator.items():
+            if validator not in ("enum", "type"):
+                message += "\n".join([e.message for e in errors])
+
+        return message
+
+
+class UndefinedType:
+    """A singleton object for marking undefined parameters"""
+
+    __instance = None
+
+    def __new__(cls, *args, **kwargs):
+        if not isinstance(cls.__instance, cls):
+            cls.__instance = object.__new__(cls, *args, **kwargs)
+        return cls.__instance
+
+    def __repr__(self):
+        return "Undefined"
+
+
+Undefined = UndefinedType()
+
+
+class SchemaBase:
+    """Base class for schema wrappers.
+
+    Each derived class should set the _schema class attribute (and optionally
+    the _rootschema class attribute) which is used for validation.
+    """
+
+    _schema: Optional[Dict[str, Any]] = None
+    _rootschema: Optional[Dict[str, Any]] = None
+    _class_is_valid_at_instantiation: bool = True
+
+    def __init__(self, *args: Any, **kwds: Any) -> None:
+        # Two valid options for initialization, which should be handled by
+        # derived classes:
+        # - a single arg with no kwds, for, e.g. {'type': 'string'}
+        # - zero args with zero or more kwds for {'type': 'object'}
+        if self._schema is None:
+            raise ValueError(
+                "Cannot instantiate object of type {}: "
+                "_schema class attribute is not defined."
+                "".format(self.__class__)
+            )
+
+        if kwds:
+            assert len(args) == 0
+        else:
+            assert len(args) in [0, 1]
+
+        # use object.__setattr__ because we override setattr below.
+        object.__setattr__(self, "_args", args)
+        object.__setattr__(self, "_kwds", kwds)
+
+        if DEBUG_MODE and self._class_is_valid_at_instantiation:
+            self.to_dict(validate=True)
+
+    def copy(
+        self, deep: Union[bool, Iterable] = True, ignore: Optional[list] = None
+    ) -> Self:
+        """Return a copy of the object
+
+        Parameters
+        ----------
+        deep : boolean or list, optional
+            If True (default) then return a deep copy of all dict, list, and
+            SchemaBase objects within the object structure.
+            If False, then only copy the top object.
+            If a list or iterable, then only copy the listed attributes.
+        ignore : list, optional
+            A list of keys for which the contents should not be copied, but
+            only stored by reference.
+        """
+
+        def _shallow_copy(obj):
+            if isinstance(obj, SchemaBase):
+                return obj.copy(deep=False)
+            elif isinstance(obj, list):
+                return obj[:]
+            elif isinstance(obj, dict):
+                return obj.copy()
+            else:
+                return obj
+
+        def _deep_copy(obj, ignore: Optional[list] = None):
+            if ignore is None:
+                ignore = []
+            if isinstance(obj, SchemaBase):
+                args = tuple(_deep_copy(arg) for arg in obj._args)
+                kwds = {
+                    k: (_deep_copy(v, ignore=ignore) if k not in ignore else v)
+                    for k, v in obj._kwds.items()
+                }
+                with debug_mode(False):
+                    return obj.__class__(*args, **kwds)
+            elif isinstance(obj, list):
+                return [_deep_copy(v, ignore=ignore) for v in obj]
+            elif isinstance(obj, dict):
+                return {
+                    k: (_deep_copy(v, ignore=ignore) if k not in ignore else v)
+                    for k, v in obj.items()
+                }
+            else:
+                return obj
+
+        try:
+            deep = list(deep)  # type: ignore[arg-type]
+        except TypeError:
+            deep_is_list = False
+        else:
+            deep_is_list = True
+
+        if deep and not deep_is_list:
+            return _deep_copy(self, ignore=ignore)
+
+        with debug_mode(False):
+            copy = self.__class__(*self._args, **self._kwds)
+        if deep_is_list:
+            # Assert statement is for the benefit of Mypy
+            assert isinstance(deep, list)
+            for attr in deep:
+                copy[attr] = _shallow_copy(copy._get(attr))
+        return copy
+
+    def _get(self, attr, default=Undefined):
+        """Get an attribute, returning default if not present."""
+        attr = self._kwds.get(attr, Undefined)
+        if attr is Undefined:
+            attr = default
+        return attr
+
+    def __getattr__(self, attr):
+        # reminder: getattr is called after the normal lookups
+        if attr == "_kwds":
+            raise AttributeError()
+        if attr in self._kwds:
+            return self._kwds[attr]
+        else:
+            try:
+                _getattr = super(SchemaBase, self).__getattr__
+            except AttributeError:
+                _getattr = super(SchemaBase, self).__getattribute__
+            return _getattr(attr)
+
+    def __setattr__(self, item, val):
+        self._kwds[item] = val
+
+    def __getitem__(self, item):
+        return self._kwds[item]
+
+    def __setitem__(self, item, val):
+        self._kwds[item] = val
+
+    def __repr__(self):
+        if self._kwds:
+            args = (
+                "{}: {!r}".format(key, val)
+                for key, val in sorted(self._kwds.items())
+                if val is not Undefined
+            )
+            args = "\n" + ",\n".join(args)
+            return "{0}({{{1}\n}})".format(
+                self.__class__.__name__, args.replace("\n", "\n  ")
+            )
+        else:
+            return "{}({!r})".format(self.__class__.__name__, self._args[0])
+
+    def __eq__(self, other):
+        return (
+            type(self) is type(other)
+            and self._args == other._args
+            and self._kwds == other._kwds
+        )
+
+    def to_dict(
+        self,
+        validate: bool = True,
+        *,
+        ignore: Optional[List[str]] = None,
+        context: Optional[Dict[str, Any]] = None,
+    ) -> dict:
+        """Return a dictionary representation of the object
+
+        Parameters
+        ----------
+        validate : bool, optional
+            If True (default), then validate the output dictionary
+            against the schema.
+        ignore : list[str], optional
+            A list of keys to ignore. It is usually not needed
+            to specify this argument as a user.
+        context : dict[str, Any], optional
+            A context dictionary. It is usually not needed
+            to specify this argument as a user.
+
+        Notes
+        -----
+        Technical: The ignore parameter will *not* be passed to child to_dict
+        function calls.
+
+        Returns
+        -------
+        dict
+            The dictionary representation of this object
+
+        Raises
+        ------
+        SchemaValidationError :
+            if validate=True and the dict does not conform to the schema
+        """
+        if context is None:
+            context = {}
+        if ignore is None:
+            ignore = []
+
+        if self._args and not self._kwds:
+            result = _todict(self._args[0], context=context)
+        elif not self._args:
+            kwds = self._kwds.copy()
+            # parsed_shorthand is added by FieldChannelMixin.
+            # It's used below to replace shorthand with its long form equivalent
+            # parsed_shorthand is removed from context if it exists so that it is
+            # not passed to child to_dict function calls
+            parsed_shorthand = context.pop("parsed_shorthand", {})
+            # Prevent that pandas categorical data is automatically sorted
+            # when a non-ordinal data type is specifed manually
+            # or if the encoding channel does not support sorting
+            if "sort" in parsed_shorthand and (
+                "sort" not in kwds or kwds["type"] not in ["ordinal", Undefined]
+            ):
+                parsed_shorthand.pop("sort")
+
+            kwds.update(
+                {
+                    k: v
+                    for k, v in parsed_shorthand.items()
+                    if kwds.get(k, Undefined) is Undefined
+                }
+            )
+            kwds = {
+                k: v for k, v in kwds.items() if k not in list(ignore) + ["shorthand"]
+            }
+            if "mark" in kwds and isinstance(kwds["mark"], str):
+                kwds["mark"] = {"type": kwds["mark"]}
+            result = _todict(
+                kwds,
+                context=context,
+            )
+        else:
+            raise ValueError(
+                "{} instance has both a value and properties : "
+                "cannot serialize to dict".format(self.__class__)
+            )
+        if validate:
+            try:
+                self.validate(result)
+            except jsonschema.ValidationError as err:
+                # We do not raise `from err` as else the resulting
+                # traceback is very long as it contains part
+                # of the Vega-Lite schema. It would also first
+                # show the less helpful ValidationError instead of
+                # the more user friendly SchemaValidationError
+                raise SchemaValidationError(self, err) from None
+        return result
+
+    def to_json(
+        self,
+        validate: bool = True,
+        indent: Optional[Union[int, str]] = 2,
+        sort_keys: bool = True,
+        *,
+        ignore: Optional[List[str]] = None,
+        context: Optional[Dict[str, Any]] = None,
+        **kwargs,
+    ) -> str:
+        """Emit the JSON representation for this object as a string.
+
+        Parameters
+        ----------
+        validate : bool, optional
+            If True (default), then validate the output dictionary
+            against the schema.
+        indent : int, optional
+            The number of spaces of indentation to use. The default is 2.
+        sort_keys : bool, optional
+            If True (default), sort keys in the output.
+        ignore : list[str], optional
+            A list of keys to ignore. It is usually not needed
+            to specify this argument as a user.
+        context : dict[str, Any], optional
+            A context dictionary. It is usually not needed
+            to specify this argument as a user.
+        **kwargs
+            Additional keyword arguments are passed to ``json.dumps()``
+
+        Notes
+        -----
+        Technical: The ignore parameter will *not* be passed to child to_dict
+        function calls.
+
+        Returns
+        -------
+        str
+            The JSON specification of the chart object.
+        """
+        if ignore is None:
+            ignore = []
+        if context is None:
+            context = {}
+        dct = self.to_dict(validate=validate, ignore=ignore, context=context)
+        return json.dumps(dct, indent=indent, sort_keys=sort_keys, **kwargs)
+
+    @classmethod
+    def _default_wrapper_classes(cls) -> Generator[Type["SchemaBase"], None, None]:
+        """Return the set of classes used within cls.from_dict()"""
+        return _subclasses(SchemaBase)
+
+    @classmethod
+    def from_dict(
+        cls,
+        dct: dict,
+        validate: bool = True,
+        _wrapper_classes: Optional[Iterable[Type["SchemaBase"]]] = None,
+        # Type hints for this method would get rather complicated
+        # if we want to provide a more specific return type
+    ) -> "SchemaBase":
+        """Construct class from a dictionary representation
+
+        Parameters
+        ----------
+        dct : dictionary
+            The dict from which to construct the class
+        validate : boolean
+            If True (default), then validate the input against the schema.
+        _wrapper_classes : iterable (optional)
+            The set of SchemaBase classes to use when constructing wrappers
+            of the dict inputs. If not specified, the result of
+            cls._default_wrapper_classes will be used.
+
+        Returns
+        -------
+        obj : Schema object
+            The wrapped schema
+
+        Raises
+        ------
+        jsonschema.ValidationError :
+            if validate=True and dct does not conform to the schema
+        """
+        if validate:
+            cls.validate(dct)
+        if _wrapper_classes is None:
+            _wrapper_classes = cls._default_wrapper_classes()
+        converter = _FromDict(_wrapper_classes)
+        return converter.from_dict(dct, cls)
+
+    @classmethod
+    def from_json(
+        cls,
+        json_string: str,
+        validate: bool = True,
+        **kwargs: Any,
+        # Type hints for this method would get rather complicated
+        # if we want to provide a more specific return type
+    ) -> Any:
+        """Instantiate the object from a valid JSON string
+
+        Parameters
+        ----------
+        json_string : string
+            The string containing a valid JSON chart specification.
+        validate : boolean
+            If True (default), then validate the input against the schema.
+        **kwargs :
+            Additional keyword arguments are passed to json.loads
+
+        Returns
+        -------
+        chart : Chart object
+            The altair Chart object built from the specification.
+        """
+        dct = json.loads(json_string, **kwargs)
+        return cls.from_dict(dct, validate=validate)
+
+    @classmethod
+    def validate(
+        cls, instance: Dict[str, Any], schema: Optional[Dict[str, Any]] = None
+    ) -> None:
+        """
+        Validate the instance against the class schema in the context of the
+        rootschema.
+        """
+        if schema is None:
+            schema = cls._schema
+        # For the benefit of mypy
+        assert schema is not None
+        return validate_jsonschema(
+            instance, schema, rootschema=cls._rootschema or cls._schema
+        )
+
+    @classmethod
+    def resolve_references(cls, schema: Optional[dict] = None) -> dict:
+        """Resolve references in the context of this object's schema or root schema."""
+        schema_to_pass = schema or cls._schema
+        # For the benefit of mypy
+        assert schema_to_pass is not None
+        return _resolve_references(
+            schema=schema_to_pass,
+            rootschema=(cls._rootschema or cls._schema or schema),
+        )
+
+    @classmethod
+    def validate_property(
+        cls, name: str, value: Any, schema: Optional[dict] = None
+    ) -> None:
+        """
+        Validate a property against property schema in the context of the
+        rootschema
+        """
+        value = _todict(value, context={})
+        props = cls.resolve_references(schema or cls._schema).get("properties", {})
+        return validate_jsonschema(
+            value, props.get(name, {}), rootschema=cls._rootschema or cls._schema
+        )
+
+    def __dir__(self) -> list:
+        return sorted(list(super().__dir__()) + list(self._kwds.keys()))
+
+
+def _passthrough(*args, **kwds):
+    return args[0] if args else kwds
+
+
+class _FromDict:
+    """Class used to construct SchemaBase class hierarchies from a dict
+
+    The primary purpose of using this class is to be able to build a hash table
+    that maps schemas to their wrapper classes. The candidate classes are
+    specified in the ``class_list`` argument to the constructor.
+    """
+
+    _hash_exclude_keys = ("definitions", "title", "description", "$schema", "id")
+
+    def __init__(self, class_list: Iterable[Type[SchemaBase]]) -> None:
+        # Create a mapping of a schema hash to a list of matching classes
+        # This lets us quickly determine the correct class to construct
+        self.class_dict = collections.defaultdict(list)
+        for cls in class_list:
+            if cls._schema is not None:
+                self.class_dict[self.hash_schema(cls._schema)].append(cls)
+
+    @classmethod
+    def hash_schema(cls, schema: dict, use_json: bool = True) -> int:
+        """
+        Compute a python hash for a nested dictionary which
+        properly handles dicts, lists, sets, and tuples.
+
+        At the top level, the function excludes from the hashed schema all keys
+        listed in `exclude_keys`.
+
+        This implements two methods: one based on conversion to JSON, and one based
+        on recursive conversions of unhashable to hashable types; the former seems
+        to be slightly faster in several benchmarks.
+        """
+        if cls._hash_exclude_keys and isinstance(schema, dict):
+            schema = {
+                key: val
+                for key, val in schema.items()
+                if key not in cls._hash_exclude_keys
+            }
+        if use_json:
+            s = json.dumps(schema, sort_keys=True)
+            return hash(s)
+        else:
+
+            def _freeze(val):
+                if isinstance(val, dict):
+                    return frozenset((k, _freeze(v)) for k, v in val.items())
+                elif isinstance(val, set):
+                    return frozenset(map(_freeze, val))
+                elif isinstance(val, list) or isinstance(val, tuple):
+                    return tuple(map(_freeze, val))
+                else:
+                    return val
+
+            return hash(_freeze(schema))
+
+    def from_dict(
+        self,
+        dct: dict,
+        cls: Optional[Type[SchemaBase]] = None,
+        schema: Optional[dict] = None,
+        rootschema: Optional[dict] = None,
+        default_class=_passthrough,
+        # Type hints for this method would get rather complicated
+        # if we want to provide a more specific return type
+    ) -> Any:
+        """Construct an object from a dict representation"""
+        if (schema is None) == (cls is None):
+            raise ValueError("Must provide either cls or schema, but not both.")
+        if schema is None:
+            # Can ignore type errors as  cls is not None in case schema is
+            schema = cls._schema  # type: ignore[union-attr]
+            # For the benefit of mypy
+            assert schema is not None
+            if rootschema:
+                rootschema = rootschema
+            elif cls is not None and cls._rootschema is not None:
+                rootschema = cls._rootschema
+            else:
+                rootschema = None
+        rootschema = rootschema or schema
+
+        if isinstance(dct, SchemaBase):
+            return dct
+
+        if cls is None:
+            # If there are multiple matches, we use the first one in the dict.
+            # Our class dict is constructed breadth-first from top to bottom,
+            # so the first class that matches is the most general match.
+            matches = self.class_dict[self.hash_schema(schema)]
+            if matches:
+                cls = matches[0]
+            else:
+                cls = default_class
+        schema = _resolve_references(schema, rootschema)
+
+        if "anyOf" in schema or "oneOf" in schema:
+            schemas = schema.get("anyOf", []) + schema.get("oneOf", [])
+            for possible_schema in schemas:
+                try:
+                    validate_jsonschema(dct, possible_schema, rootschema=rootschema)
+                except jsonschema.ValidationError:
+                    continue
+                else:
+                    return self.from_dict(
+                        dct,
+                        schema=possible_schema,
+                        rootschema=rootschema,
+                        default_class=cls,
+                    )
+
+        if isinstance(dct, dict):
+            # TODO: handle schemas for additionalProperties/patternProperties
+            props = schema.get("properties", {})
+            kwds = {}
+            for key, val in dct.items():
+                if key in props:
+                    val = self.from_dict(val, schema=props[key], rootschema=rootschema)
+                kwds[key] = val
+            return cls(**kwds)
+
+        elif isinstance(dct, list):
+            item_schema = schema.get("items", {})
+            dct = [
+                self.from_dict(val, schema=item_schema, rootschema=rootschema)
+                for val in dct
+            ]
+            return cls(dct)
+        else:
+            return cls(dct)
+
+
+class _PropertySetter:
+    def __init__(self, prop: str, schema: dict) -> None:
+        self.prop = prop
+        self.schema = schema
+
+    def __get__(self, obj, cls):
+        self.obj = obj
+        self.cls = cls
+        # The docs from the encoding class parameter (e.g. `bin` in X, Color,
+        # etc); this provides a general description of the parameter.
+        self.__doc__ = self.schema["description"].replace("__", "**")
+        property_name = f"{self.prop}"[0].upper() + f"{self.prop}"[1:]
+        if hasattr(vegalite, property_name):
+            altair_prop = getattr(vegalite, property_name)
+            # Add the docstring from the helper class (e.g. `BinParams`) so
+            # that all the parameter names of the helper class are included in
+            # the final docstring
+            parameter_index = altair_prop.__doc__.find("Parameters\n")
+            if parameter_index > -1:
+                self.__doc__ = (
+                    altair_prop.__doc__[:parameter_index].replace("    ", "")
+                    + self.__doc__
+                    + textwrap.dedent(
+                        f"\n\n    {altair_prop.__doc__[parameter_index:]}"
+                    )
+                )
+            # For short docstrings such as Aggregate, Stack, et
+            else:
+                self.__doc__ = (
+                    altair_prop.__doc__.replace("    ", "") + "\n" + self.__doc__
+                )
+            # Add signatures and tab completion for the method and parameter names
+            self.__signature__ = inspect.signature(altair_prop)
+            self.__wrapped__ = inspect.getfullargspec(altair_prop)
+            self.__name__ = altair_prop.__name__
+        else:
+            # It seems like bandPosition is the only parameter that doesn't
+            # have a helper class.
+            pass
+        return self
+
+    def __call__(self, *args, **kwargs):
+        obj = self.obj.copy()
+        # TODO: use schema to validate
+        obj[self.prop] = args[0] if args else kwargs
+        return obj
+
+
+def with_property_setters(cls: TSchemaBase) -> TSchemaBase:
+    """
+    Decorator to add property setters to a Schema class.
+    """
+    schema = cls.resolve_references()
+    for prop, propschema in schema.get("properties", {}).items():
+        setattr(cls, prop, _PropertySetter(prop, propschema))
+    return cls
diff --git a/llm/Lib/site-packages/altair/utils/selection.py b/llm/Lib/site-packages/altair/utils/selection.py
new file mode 100644
index 0000000000000000000000000000000000000000..2e796cac091477a1ab594e400492b0a3532cb206
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/selection.py
@@ -0,0 +1,137 @@
+from dataclasses import dataclass
+from typing import List, Dict, Any, NewType, Optional
+
+
+# Type representing the "{selection}_store" dataset that corresponds to a
+# Vega-Lite selection
+Store = NewType("Store", List[Dict[str, Any]])
+
+
+@dataclass(frozen=True, eq=True)
+class IndexSelection:
+    """
+    An IndexSelection represents the state of an Altair
+    point selection (as constructed by alt.selection_point())
+    when neither the fields nor encodings arguments are specified.
+
+    The value field is a list of zero-based indices into the
+    selected dataset.
+
+    Note: These indices only apply to the input DataFrame
+    for charts that do not include aggregations (e.g. a scatter chart).
+    """
+
+    name: str
+    value: List[int]
+    store: Store
+
+    @staticmethod
+    def from_vega(name: str, signal: Optional[Dict[str, dict]], store: Store):
+        """
+        Construct an IndexSelection from the raw Vega signal and dataset values.
+
+        Parameters
+        ----------
+        name: str
+            The selection's name
+        signal: dict or None
+            The value of the Vega signal corresponding to the selection
+        store: list
+            The value of the Vega dataset corresponding to the selection.
+            This dataset is named "{name}_store" in the Vega view.
+
+        Returns
+        -------
+        IndexSelection
+        """
+        if signal is None:
+            indices = []
+        else:
+            points = signal.get("vlPoint", {}).get("or", [])
+            indices = [p["_vgsid_"] - 1 for p in points]
+        return IndexSelection(name=name, value=indices, store=store)
+
+
+@dataclass(frozen=True, eq=True)
+class PointSelection:
+    """
+    A PointSelection represents the state of an Altair
+    point selection (as constructed by alt.selection_point())
+    when the fields or encodings arguments are specified.
+
+    The value field is a list of dicts of the form:
+        [{"dim1": 1, "dim2": "A"}, {"dim1": 2, "dim2": "BB"}]
+
+    where "dim1" and "dim2" are dataset columns and the dict values
+    correspond to the specific selected values.
+    """
+
+    name: str
+    value: List[Dict[str, Any]]
+    store: Store
+
+    @staticmethod
+    def from_vega(name: str, signal: Optional[Dict[str, dict]], store: Store):
+        """
+        Construct a PointSelection from the raw Vega signal and dataset values.
+
+        Parameters
+        ----------
+        name: str
+            The selection's name
+        signal: dict or None
+            The value of the Vega signal corresponding to the selection
+        store: list
+            The value of the Vega dataset corresponding to the selection.
+            This dataset is named "{name}_store" in the Vega view.
+
+        Returns
+        -------
+        PointSelection
+        """
+        if signal is None:
+            points = []
+        else:
+            points = signal.get("vlPoint", {}).get("or", [])
+        return PointSelection(name=name, value=points, store=store)
+
+
+@dataclass(frozen=True, eq=True)
+class IntervalSelection:
+    """
+    An IntervalSelection represents the state of an Altair
+    interval selection (as constructed by alt.selection_interval()).
+
+    The value field is a dict of the form:
+        {"dim1": [0, 10], "dim2": ["A", "BB", "CCC"]}
+
+    where "dim1" and "dim2" are dataset columns and the dict values
+    correspond to the selected range.
+    """
+
+    name: str
+    value: Dict[str, list]
+    store: Store
+
+    @staticmethod
+    def from_vega(name: str, signal: Optional[Dict[str, list]], store: Store):
+        """
+        Construct an IntervalSelection from the raw Vega signal and dataset values.
+
+        Parameters
+        ----------
+        name: str
+            The selection's name
+        signal: dict or None
+            The value of the Vega signal corresponding to the selection
+        store: list
+            The value of the Vega dataset corresponding to the selection.
+            This dataset is named "{name}_store" in the Vega view.
+
+        Returns
+        -------
+        PointSelection
+        """
+        if signal is None:
+            signal = {}
+        return IntervalSelection(name=name, value=signal, store=store)
diff --git a/llm/Lib/site-packages/altair/utils/server.py b/llm/Lib/site-packages/altair/utils/server.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ec2b32fcc103e1ebd477582443ca675780f9059
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/server.py
@@ -0,0 +1,149 @@
+"""
+A Simple server used to show altair graphics from a prompt or script.
+
+This is adapted from the mpld3 package; see
+https://github.com/mpld3/mpld3/blob/master/mpld3/_server.py
+"""
+
+import sys
+import threading
+import webbrowser
+import socket
+from http import server
+from io import BytesIO as IO
+import itertools
+import random
+
+JUPYTER_WARNING = """
+Note: if you're in the Jupyter notebook, Chart.serve() is not the best
+      way to view plots. Consider using Chart.display().
+You must interrupt the kernel to cancel this command.
+"""
+
+
+# Mock server used for testing
+
+
+class MockRequest:
+    def makefile(self, *args, **kwargs):
+        return IO(b"GET /")
+
+    def sendall(self, response):
+        pass
+
+
+class MockServer:
+    def __init__(self, ip_port, Handler):
+        Handler(MockRequest(), ip_port[0], self)
+
+    def serve_forever(self):
+        pass
+
+    def server_close(self):
+        pass
+
+
+def generate_handler(html, files=None):
+    if files is None:
+        files = {}
+
+    class MyHandler(server.BaseHTTPRequestHandler):
+        def do_GET(self):
+            """Respond to a GET request."""
+            if self.path == "/":
+                self.send_response(200)
+                self.send_header("Content-type", "text/html")
+                self.end_headers()
+                self.wfile.write(html.encode())
+            elif self.path in files:
+                content_type, content = files[self.path]
+                self.send_response(200)
+                self.send_header("Content-type", content_type)
+                self.end_headers()
+                self.wfile.write(content.encode())
+            else:
+                self.send_error(404)
+
+    return MyHandler
+
+
+def find_open_port(ip, port, n=50):
+    """Find an open port near the specified port"""
+    ports = itertools.chain(
+        (port + i for i in range(n)), (port + random.randint(-2 * n, 2 * n))
+    )
+
+    for port in ports:
+        s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        result = s.connect_ex((ip, port))
+        s.close()
+        if result != 0:
+            return port
+    raise ValueError("no open ports found")
+
+
+def serve(
+    html,
+    ip="127.0.0.1",
+    port=8888,
+    n_retries=50,
+    files=None,
+    jupyter_warning=True,
+    open_browser=True,
+    http_server=None,
+):
+    """Start a server serving the given HTML, and (optionally) open a browser
+
+    Parameters
+    ----------
+    html : string
+        HTML to serve
+    ip : string (default = '127.0.0.1')
+        ip address at which the HTML will be served.
+    port : int (default = 8888)
+        the port at which to serve the HTML
+    n_retries : int (default = 50)
+        the number of nearby ports to search if the specified port is in use.
+    files : dictionary (optional)
+        dictionary of extra content to serve
+    jupyter_warning : bool (optional)
+        if True (default), then print a warning if this is used within Jupyter
+    open_browser : bool (optional)
+        if True (default), then open a web browser to the given HTML
+    http_server : class (optional)
+        optionally specify an HTTPServer class to use for showing the
+        figure. The default is Python's basic HTTPServer.
+    """
+    port = find_open_port(ip, port, n_retries)
+    Handler = generate_handler(html, files)
+
+    if http_server is None:
+        srvr = server.HTTPServer((ip, port), Handler)
+    else:
+        srvr = http_server((ip, port), Handler)
+
+    if jupyter_warning:
+        try:
+            __IPYTHON__  # noqa
+        except NameError:
+            pass
+        else:
+            print(JUPYTER_WARNING)
+
+    # Start the server
+    print("Serving to http://{}:{}/    [Ctrl-C to exit]".format(ip, port))
+    sys.stdout.flush()
+
+    if open_browser:
+        # Use a thread to open a web browser pointing to the server
+        def b():
+            return webbrowser.open("http://{}:{}".format(ip, port))
+
+        threading.Thread(target=b).start()
+
+    try:
+        srvr.serve_forever()
+    except (KeyboardInterrupt, SystemExit):
+        print("\nstopping Server...")
+
+    srvr.server_close()
diff --git a/llm/Lib/site-packages/altair/utils/theme.py b/llm/Lib/site-packages/altair/utils/theme.py
new file mode 100644
index 0000000000000000000000000000000000000000..10dc6fa8a81646ed7e9fa8d6be4e1634ec14e7d8
--- /dev/null
+++ b/llm/Lib/site-packages/altair/utils/theme.py
@@ -0,0 +1,10 @@
+"""Utilities for registering and working with themes"""
+
+from .plugin_registry import PluginRegistry
+from typing import Callable
+
+ThemeType = Callable[..., dict]
+
+
+class ThemeRegistry(PluginRegistry[ThemeType]):
+    pass
diff --git a/llm/Lib/site-packages/altair/vegalite/__init__.py b/llm/Lib/site-packages/altair/vegalite/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..690d64e63bc40a6006318cd70535017d41643def
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/__init__.py
@@ -0,0 +1,2 @@
+# ruff: noqa
+from .v5 import *
diff --git a/llm/Lib/site-packages/altair/vegalite/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8678607cfbcead1321c280c4a6cebe2ce388f891
Binary files /dev/null and b/llm/Lib/site-packages/altair/vegalite/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/vegalite/__pycache__/api.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/__pycache__/api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5ea167f15728fcb5883d301467dd3148ebd827ff
Binary files /dev/null and b/llm/Lib/site-packages/altair/vegalite/__pycache__/api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/vegalite/__pycache__/data.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/__pycache__/data.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6e5b5c85665a097093176101eb5e3a0589004601
Binary files /dev/null and b/llm/Lib/site-packages/altair/vegalite/__pycache__/data.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/vegalite/__pycache__/display.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/__pycache__/display.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..820e7632f5389a0d6b2e624e3f149059d061acd6
Binary files /dev/null and b/llm/Lib/site-packages/altair/vegalite/__pycache__/display.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/vegalite/__pycache__/schema.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/__pycache__/schema.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..764b51b8af4205f74ed38e16359e9500390b5d07
Binary files /dev/null and b/llm/Lib/site-packages/altair/vegalite/__pycache__/schema.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/vegalite/api.py b/llm/Lib/site-packages/altair/vegalite/api.py
new file mode 100644
index 0000000000000000000000000000000000000000..6602986fe9c617eb5f4e375c94985260a2773aaa
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/api.py
@@ -0,0 +1,2 @@
+# ruff: noqa
+from .v5.api import *
diff --git a/llm/Lib/site-packages/altair/vegalite/data.py b/llm/Lib/site-packages/altair/vegalite/data.py
new file mode 100644
index 0000000000000000000000000000000000000000..fbeda0feeae201793e92d4f7294056a1a7c5328f
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/data.py
@@ -0,0 +1,49 @@
+from toolz import curried
+from ..utils.core import sanitize_dataframe
+from ..utils.data import (
+    MaxRowsError,
+    curry,
+    limit_rows,
+    pipe,
+    sample,
+    to_csv,
+    to_json,
+    to_values,
+    check_data_type,
+)
+from ..utils.data import DataTransformerRegistry as _DataTransformerRegistry
+from ..utils.data import DataType, ToValuesReturnType
+from ..utils.plugin_registry import PluginEnabler
+
+
+@curried.curry
+def default_data_transformer(
+    data: DataType, max_rows: int = 5000
+) -> ToValuesReturnType:
+    return curried.pipe(data, limit_rows(max_rows=max_rows), to_values)
+
+
+class DataTransformerRegistry(_DataTransformerRegistry):
+    def disable_max_rows(self) -> PluginEnabler:
+        """Disable the MaxRowsError."""
+        options = self.options
+        if self.active in ("default", "vegafusion"):
+            options = options.copy()
+            options["max_rows"] = None
+        return self.enable(**options)
+
+
+__all__ = (
+    "DataTransformerRegistry",
+    "MaxRowsError",
+    "curry",
+    "sanitize_dataframe",
+    "default_data_transformer",
+    "limit_rows",
+    "pipe",
+    "sample",
+    "to_csv",
+    "to_json",
+    "to_values",
+    "check_data_type",
+)
diff --git a/llm/Lib/site-packages/altair/vegalite/display.py b/llm/Lib/site-packages/altair/vegalite/display.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f3a13b4613d155fc805849bc9f600f426889c68
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/display.py
@@ -0,0 +1,17 @@
+from ..utils.display import (
+    Displayable,
+    default_renderer_base,
+    json_renderer_base,
+    DefaultRendererReturnType,
+)
+from ..utils.display import RendererRegistry, HTMLRenderer
+
+
+__all__ = (
+    "Displayable",
+    "default_renderer_base",
+    "json_renderer_base",
+    "RendererRegistry",
+    "HTMLRenderer",
+    "DefaultRendererReturnType",
+)
diff --git a/llm/Lib/site-packages/altair/vegalite/schema.py b/llm/Lib/site-packages/altair/vegalite/schema.py
new file mode 100644
index 0000000000000000000000000000000000000000..3807f376775c86df14834629875a24dff1f83744
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/schema.py
@@ -0,0 +1,4 @@
+"""Altair schema wrappers"""
+
+# ruff: noqa
+from .v5.schema import *
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/__init__.py b/llm/Lib/site-packages/altair/vegalite/v5/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..8c75d5cc2cea1b0015aaad527dcab4e29b288da2
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/v5/__init__.py
@@ -0,0 +1,21 @@
+# ruff: noqa
+from .schema import *
+from .api import *
+
+from ...expr import datum, expr  # type: ignore[no-redef]
+
+from .display import VegaLite, renderers
+from .compiler import vegalite_compilers
+
+from .data import (
+    MaxRowsError,
+    pipe,
+    curry,
+    limit_rows,
+    sample,
+    to_json,
+    to_csv,
+    to_values,
+    default_data_transformer,
+    data_transformers,
+)
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1f5c34e1c9a2bfea3aec8615ea96e7f5ddc9f2f9
Binary files /dev/null and b/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/api.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6d1ac312fce7d88e7baeaf39528ac37e65e79161
Binary files /dev/null and b/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/compiler.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/compiler.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b1b7533facc9156a5a97c5deb9411eaaecda7547
Binary files /dev/null and b/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/compiler.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/data.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/data.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d8dee2a801c93bf95650086a91ff65cd8276011c
Binary files /dev/null and b/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/data.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/display.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/display.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f24f398fa0b29872b8a8395bbc0e39fe54207e24
Binary files /dev/null and b/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/display.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/theme.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/theme.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2be794a063d8ab912e14cd49af0445b0a796e328
Binary files /dev/null and b/llm/Lib/site-packages/altair/vegalite/v5/__pycache__/theme.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/api.py b/llm/Lib/site-packages/altair/vegalite/v5/api.py
new file mode 100644
index 0000000000000000000000000000000000000000..93bd295b356e2f4464e7d65626b3e7528533a7fd
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/v5/api.py
@@ -0,0 +1,4091 @@
+import warnings
+
+import hashlib
+import io
+import json
+import jsonschema
+import pandas as pd
+from toolz.curried import pipe as _pipe
+import itertools
+import sys
+from typing import cast, List, Optional, Any, Iterable, Union, Literal, IO
+
+# Have to rename it here as else it overlaps with schema.core.Type and schema.core.Dict
+from typing import Type as TypingType
+from typing import Dict as TypingDict
+
+from .schema import core, channels, mixins, Undefined, UndefinedType, SCHEMA_URL
+
+from .data import data_transformers
+from ... import utils, expr
+from ...expr import core as _expr_core
+from .display import renderers, VEGALITE_VERSION, VEGAEMBED_VERSION, VEGA_VERSION
+from .theme import themes
+from .compiler import vegalite_compilers
+from ...utils._vegafusion_data import (
+    using_vegafusion as _using_vegafusion,
+    compile_with_vegafusion as _compile_with_vegafusion,
+)
+from ...utils.core import DataFrameLike
+from ...utils.data import DataType
+
+if sys.version_info >= (3, 11):
+    from typing import Self
+else:
+    from typing_extensions import Self
+
+ChartDataType = Union[DataType, core.Data, str, core.Generator, UndefinedType]
+
+
+# ------------------------------------------------------------------------
+# Data Utilities
+def _dataset_name(values: Union[dict, list, core.InlineDataset]) -> str:
+    """Generate a unique hash of the data
+
+    Parameters
+    ----------
+    values : list, dict, core.InlineDataset
+        A representation of data values.
+
+    Returns
+    -------
+    name : string
+        A unique name generated from the hash of the values.
+    """
+    if isinstance(values, core.InlineDataset):
+        values = values.to_dict()
+    if values == [{}]:
+        return "empty"
+    values_json = json.dumps(values, sort_keys=True, default=str)
+    hsh = hashlib.sha256(values_json.encode()).hexdigest()[:32]
+    return "data-" + hsh
+
+
+def _consolidate_data(data, context):
+    """If data is specified inline, then move it to context['datasets']
+
+    This function will modify context in-place, and return a new version of data
+    """
+    values = Undefined
+    kwds = {}
+
+    if isinstance(data, core.InlineData):
+        if data.name is Undefined and data.values is not Undefined:
+            if isinstance(data.values, core.InlineDataset):
+                values = data.to_dict()["values"]
+            else:
+                values = data.values
+            kwds = {"format": data.format}
+
+    elif isinstance(data, dict):
+        if "name" not in data and "values" in data:
+            values = data["values"]
+            kwds = {k: v for k, v in data.items() if k != "values"}
+
+    if values is not Undefined:
+        name = _dataset_name(values)
+        data = core.NamedData(name=name, **kwds)
+        context.setdefault("datasets", {})[name] = values
+
+    return data
+
+
+def _prepare_data(data, context=None):
+    """Convert input data to data for use within schema
+
+    Parameters
+    ----------
+    data :
+        The input dataset in the form of a DataFrame, dictionary, altair data
+        object, or other type that is recognized by the data transformers.
+    context : dict (optional)
+        The to_dict context in which the data is being prepared. This is used
+        to keep track of information that needs to be passed up and down the
+        recursive serialization routine, such as global named datasets.
+    """
+    if data is Undefined:
+        return data
+
+    # convert dataframes  or objects with __geo_interface__ to dict
+    elif isinstance(data, pd.DataFrame) or hasattr(data, "__geo_interface__"):
+        data = _pipe(data, data_transformers.get())
+
+    # convert string input to a URLData
+    elif isinstance(data, str):
+        data = core.UrlData(data)
+
+    elif isinstance(data, DataFrameLike):
+        data = _pipe(data, data_transformers.get())
+
+    # consolidate inline data to top-level datasets
+    if context is not None and data_transformers.consolidate_datasets:
+        data = _consolidate_data(data, context)
+
+    # if data is still not a recognized type, then return
+    if not isinstance(data, (dict, core.Data)):
+        warnings.warn("data of type {} not recognized".format(type(data)), stacklevel=1)
+
+    return data
+
+
+# ------------------------------------------------------------------------
+# Aliases & specializations
+Bin = core.BinParams
+Impute = core.ImputeParams
+Title = core.TitleParams
+
+
+class LookupData(core.LookupData):
+    @utils.use_signature(core.LookupData)
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+    def to_dict(self, *args, **kwargs) -> dict:
+        """Convert the chart to a dictionary suitable for JSON export."""
+        copy = self.copy(deep=False)
+        copy.data = _prepare_data(copy.data, kwargs.get("context"))
+        return super(LookupData, copy).to_dict(*args, **kwargs)
+
+
+class FacetMapping(core.FacetMapping):
+    _class_is_valid_at_instantiation = False
+
+    @utils.use_signature(core.FacetMapping)
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+    def to_dict(self, *args, **kwargs) -> dict:
+        copy = self.copy(deep=False)
+        context = kwargs.get("context", {})
+        data = context.get("data", None)
+        if isinstance(self.row, str):
+            copy.row = core.FacetFieldDef(**utils.parse_shorthand(self.row, data))
+        if isinstance(self.column, str):
+            copy.column = core.FacetFieldDef(**utils.parse_shorthand(self.column, data))
+        return super(FacetMapping, copy).to_dict(*args, **kwargs)
+
+
+# ------------------------------------------------------------------------
+# Encoding will contain channel objects that aren't valid at instantiation
+core.FacetedEncoding._class_is_valid_at_instantiation = False
+
+# ------------------------------------------------------------------------
+# These are parameters that are valid at the top level, but are not valid
+# for specs that are within a composite chart
+# (layer, hconcat, vconcat, facet, repeat)
+TOPLEVEL_ONLY_KEYS = {"background", "config", "autosize", "padding", "$schema"}
+
+
+def _get_channels_mapping() -> TypingDict[TypingType[core.SchemaBase], str]:
+    mapping: TypingDict[TypingType[core.SchemaBase], str] = {}
+    for attr in dir(channels):
+        cls = getattr(channels, attr)
+        if isinstance(cls, type) and issubclass(cls, core.SchemaBase):
+            mapping[cls] = attr.replace("Value", "").lower()
+    return mapping
+
+
+# -------------------------------------------------------------------------
+# Tools for working with parameters
+class Parameter(_expr_core.OperatorMixin):
+    """A Parameter object"""
+
+    # NOTE: If you change this class, make sure that the protocol in
+    # altair/vegalite/v5/schema/core.py is updated accordingly if needed.
+
+    _counter: int = 0
+
+    @classmethod
+    def _get_name(cls) -> str:
+        cls._counter += 1
+        return f"param_{cls._counter}"
+
+    def __init__(
+        self,
+        name: Optional[str] = None,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[
+            core.VariableParameter,
+            core.TopLevelSelectionParameter,
+            core.SelectionParameter,
+            UndefinedType,
+        ] = Undefined,
+        param_type: Union[Literal["variable", "selection"], UndefinedType] = Undefined,
+    ) -> None:
+        if name is None:
+            name = self._get_name()
+        self.name = name
+        self.empty = empty
+        self.param = param
+        self.param_type = param_type
+
+    @utils.deprecation.deprecated(
+        message="'ref' is deprecated. No need to call '.ref()' anymore."
+    )
+    def ref(self) -> dict:
+        "'ref' is deprecated. No need to call '.ref()' anymore."
+        return self.to_dict()
+
+    def to_dict(self) -> TypingDict[str, Union[str, dict]]:
+        if self.param_type == "variable":
+            return {"expr": self.name}
+        elif self.param_type == "selection":
+            return {
+                "param": self.name.to_dict()
+                if hasattr(self.name, "to_dict")
+                else self.name
+            }
+        else:
+            raise ValueError(f"Unrecognized parameter type: {self.param_type}")
+
+    def __invert__(self):
+        if self.param_type == "selection":
+            return SelectionPredicateComposition({"not": {"param": self.name}})
+        else:
+            return _expr_core.OperatorMixin.__invert__(self)
+
+    def __and__(self, other):
+        if self.param_type == "selection":
+            if isinstance(other, Parameter):
+                other = {"param": other.name}
+            return SelectionPredicateComposition({"and": [{"param": self.name}, other]})
+        else:
+            return _expr_core.OperatorMixin.__and__(self, other)
+
+    def __or__(self, other):
+        if self.param_type == "selection":
+            if isinstance(other, Parameter):
+                other = {"param": other.name}
+            return SelectionPredicateComposition({"or": [{"param": self.name}, other]})
+        else:
+            return _expr_core.OperatorMixin.__or__(self, other)
+
+    def __repr__(self) -> str:
+        return "Parameter({0!r}, {1})".format(self.name, self.param)
+
+    def _to_expr(self) -> str:
+        return self.name
+
+    def _from_expr(self, expr) -> "ParameterExpression":
+        return ParameterExpression(expr=expr)
+
+    def __getattr__(
+        self, field_name: str
+    ) -> Union[_expr_core.GetAttrExpression, "SelectionExpression"]:
+        if field_name.startswith("__") and field_name.endswith("__"):
+            raise AttributeError(field_name)
+        _attrexpr = _expr_core.GetAttrExpression(self.name, field_name)
+        # If self is a SelectionParameter and field_name is in its
+        # fields or encodings list, then we want to return an expression.
+        if check_fields_and_encodings(self, field_name):
+            return SelectionExpression(_attrexpr)
+        return _expr_core.GetAttrExpression(self.name, field_name)
+
+    # TODO: Are there any special cases to consider for __getitem__?
+    # This was copied from v4.
+    def __getitem__(self, field_name: str) -> _expr_core.GetItemExpression:
+        return _expr_core.GetItemExpression(self.name, field_name)
+
+
+# Enables use of ~, &, | with compositions of selection objects.
+class SelectionPredicateComposition(core.PredicateComposition):
+    def __invert__(self):
+        return SelectionPredicateComposition({"not": self.to_dict()})
+
+    def __and__(self, other):
+        return SelectionPredicateComposition({"and": [self.to_dict(), other.to_dict()]})
+
+    def __or__(self, other):
+        return SelectionPredicateComposition({"or": [self.to_dict(), other.to_dict()]})
+
+
+class ParameterExpression(_expr_core.OperatorMixin, object):
+    def __init__(self, expr) -> None:
+        self.expr = expr
+
+    def to_dict(self) -> TypingDict[str, str]:
+        return {"expr": repr(self.expr)}
+
+    def _to_expr(self) -> str:
+        return repr(self.expr)
+
+    def _from_expr(self, expr) -> "ParameterExpression":
+        return ParameterExpression(expr=expr)
+
+
+class SelectionExpression(_expr_core.OperatorMixin, object):
+    def __init__(self, expr) -> None:
+        self.expr = expr
+
+    def to_dict(self) -> TypingDict[str, str]:
+        return {"expr": repr(self.expr)}
+
+    def _to_expr(self) -> str:
+        return repr(self.expr)
+
+    def _from_expr(self, expr) -> "SelectionExpression":
+        return SelectionExpression(expr=expr)
+
+
+def check_fields_and_encodings(parameter: Parameter, field_name: str) -> bool:
+    for prop in ["fields", "encodings"]:
+        try:
+            if field_name in getattr(parameter.param.select, prop):  # type: ignore[union-attr]
+                return True
+        except (AttributeError, TypeError):
+            pass
+
+    return False
+
+
+# ------------------------------------------------------------------------
+# Top-Level Functions
+
+
+def value(value, **kwargs) -> dict:
+    """Specify a value for use in an encoding"""
+    return dict(value=value, **kwargs)
+
+
+def param(
+    name: Optional[str] = None,
+    value: Union[Any, UndefinedType] = Undefined,
+    bind: Union[core.Binding, UndefinedType] = Undefined,
+    empty: Union[bool, UndefinedType] = Undefined,
+    expr: Union[str, core.Expr, _expr_core.Expression, UndefinedType] = Undefined,
+    **kwds,
+) -> Parameter:
+    """Create a named parameter.
+    See https://altair-viz.github.io/user_guide/interactions.html for examples.
+    Although both variable parameters and selection parameters can be created using
+    this 'param' function, to create a selection parameter, it is recommended to use
+    either 'selection_point' or 'selection_interval' instead.
+
+    Parameters
+    ----------
+    name : string (optional)
+        The name of the parameter. If not specified, a unique name will be
+        created.
+    value : any (optional)
+        The default value of the parameter. If not specified, the parameter
+        will be created without a default value.
+    bind : :class:`Binding` (optional)
+        Binds the parameter to an external input element such as a slider,
+        selection list or radio button group.
+    empty : boolean (optional)
+        For selection parameters, the predicate of empty selections returns
+        True by default. Override this behavior, by setting this property
+        'empty=False'.
+    expr : str, Expression (optional)
+        An expression for the value of the parameter. This expression may
+        include other parameters, in which case the parameter will
+        automatically update in response to upstream parameter changes.
+    **kwds :
+        additional keywords will be used to construct a parameter.  If 'select'
+        is among the keywords, then a selection parameter will be created.
+        Otherwise, a variable parameter will be created.
+
+    Returns
+    -------
+    parameter: Parameter
+        The parameter object that can be used in chart creation.
+    """
+    parameter = Parameter(name)
+
+    if empty is not Undefined:
+        parameter.empty = empty
+        if parameter.empty == "none":
+            warnings.warn(
+                """The value of 'empty' should be True or False.""",
+                utils.AltairDeprecationWarning,
+                stacklevel=1,
+            )
+            parameter.empty = False
+        elif parameter.empty == "all":
+            warnings.warn(
+                """The value of 'empty' should be True or False.""",
+                utils.AltairDeprecationWarning,
+                stacklevel=1,
+            )
+            parameter.empty = True
+        elif (parameter.empty is False) or (parameter.empty is True):
+            pass
+        else:
+            raise ValueError("The value of 'empty' should be True or False.")
+
+    if "init" in kwds:
+        warnings.warn(
+            """Use 'value' instead of 'init'.""",
+            utils.AltairDeprecationWarning,
+            stacklevel=1,
+        )
+        if value is Undefined:
+            kwds["value"] = kwds.pop("init")
+        else:
+            # If both 'value' and 'init' are set, we ignore 'init'.
+            kwds.pop("init")
+
+    # ignore[arg-type] comment is needed because we can also pass _expr_core.Expression
+    if "select" not in kwds:
+        parameter.param = core.VariableParameter(
+            name=parameter.name,
+            bind=bind,
+            value=value,
+            expr=expr,
+            **kwds,
+        )
+        parameter.param_type = "variable"
+    elif "views" in kwds:
+        parameter.param = core.TopLevelSelectionParameter(
+            name=parameter.name, bind=bind, value=value, expr=expr, **kwds
+        )
+        parameter.param_type = "selection"
+    else:
+        parameter.param = core.SelectionParameter(
+            name=parameter.name, bind=bind, value=value, expr=expr, **kwds
+        )
+        parameter.param_type = "selection"
+
+    return parameter
+
+
+def _selection(
+    type: Union[Literal["interval", "point"], UndefinedType] = Undefined, **kwds
+) -> Parameter:
+    # We separate out the parameter keywords from the selection keywords
+    param_kwds = {}
+
+    for kwd in {"name", "bind", "value", "empty", "init", "views"}:
+        if kwd in kwds:
+            param_kwds[kwd] = kwds.pop(kwd)
+
+    select: Union[core.IntervalSelectionConfig, core.PointSelectionConfig]
+    if type == "interval":
+        select = core.IntervalSelectionConfig(type=type, **kwds)
+    elif type == "point":
+        select = core.PointSelectionConfig(type=type, **kwds)
+    elif type in ["single", "multi"]:
+        select = core.PointSelectionConfig(type="point", **kwds)
+        warnings.warn(
+            """The types 'single' and 'multi' are now
+        combined and should be specified using "selection_point()".""",
+            utils.AltairDeprecationWarning,
+            stacklevel=1,
+        )
+    else:
+        raise ValueError("""'type' must be 'point' or 'interval'""")
+
+    return param(select=select, **param_kwds)
+
+
+@utils.deprecation.deprecated(
+    message="""'selection' is deprecated.
+   Use 'selection_point()' or 'selection_interval()' instead; these functions also include more helpful docstrings."""
+)
+def selection(
+    type: Union[Literal["interval", "point"], UndefinedType] = Undefined, **kwds
+) -> Parameter:
+    """
+    Users are recommended to use either 'selection_point' or 'selection_interval' instead, depending on the type of parameter they want to create.
+
+    Create a selection parameter.
+
+    Parameters
+    ----------
+    type : enum('point', 'interval') (required)
+        Determines the default event processing and data query for the
+        selection. Vega-Lite currently supports two selection types:
+        * "point" - to select multiple discrete data values; the first
+        value is selected on click and additional values toggled on
+        shift-click.
+        * "interval" - to select a continuous range of data values on
+        drag.
+    **kwds :
+        additional keywords to control the selection.
+    """
+
+    return _selection(type=type, **kwds)
+
+
+def selection_interval(
+    name: Optional[str] = None,
+    value: Union[Any, UndefinedType] = Undefined,
+    bind: Union[core.Binding, str, UndefinedType] = Undefined,
+    empty: Union[bool, UndefinedType] = Undefined,
+    expr: Union[str, core.Expr, _expr_core.Expression, UndefinedType] = Undefined,
+    encodings: Union[List[str], UndefinedType] = Undefined,
+    on: Union[str, UndefinedType] = Undefined,
+    clear: Union[str, bool, UndefinedType] = Undefined,
+    resolve: Union[Literal["global", "union", "intersect"], UndefinedType] = Undefined,
+    mark: Union[core.Mark, UndefinedType] = Undefined,
+    translate: Union[str, bool, UndefinedType] = Undefined,
+    zoom: Union[str, bool, UndefinedType] = Undefined,
+    **kwds,
+) -> Parameter:
+    """Create an interval selection parameter. Selection parameters define data queries that are driven by direct manipulation from user input (e.g., mouse clicks or drags). Interval selection parameters are used to select a continuous range of data values on drag, whereas point selection parameters (`selection_point`) are used to select multiple discrete data values.)
+
+    Parameters
+    ----------
+    name : string (optional)
+        The name of the parameter. If not specified, a unique name will be
+        created.
+    value : any (optional)
+        The default value of the parameter. If not specified, the parameter
+        will be created without a default value.
+    bind : :class:`Binding`, str (optional)
+        Binds the parameter to an external input element such as a slider,
+        selection list or radio button group.
+    empty : boolean (optional)
+        For selection parameters, the predicate of empty selections returns
+        True by default. Override this behavior, by setting this property
+        'empty=False'.
+    expr : :class:`Expr` (optional)
+        An expression for the value of the parameter. This expression may
+        include other parameters, in which case the parameter will
+        automatically update in response to upstream parameter changes.
+    encodings : List[str] (optional)
+        A list of encoding channels. The corresponding data field values
+        must match for a data tuple to fall within the selection.
+    on : string (optional)
+        A Vega event stream (object or selector) that triggers the selection.
+        For interval selections, the event stream must specify a start and end.
+    clear : string or boolean (optional)
+        Clears the selection, emptying it of all values. This property can
+        be an Event Stream or False to disable clear.  Default is 'dblclick'.
+    resolve : enum('global', 'union', 'intersect') (optional)
+        With layered and multi-view displays, a strategy that determines
+        how selections' data queries are resolved when applied in a filter
+        transform, conditional encoding rule, or scale domain.
+        One of:
+
+        * 'global': only one brush exists for the entire SPLOM. When the
+          user begins to drag, any previous brushes are cleared, and a
+          new one is constructed.
+        * 'union': each cell contains its own brush, and points are
+          highlighted if they lie within any of these individual brushes.
+        * 'intersect': each cell contains its own brush, and points are
+          highlighted only if they fall within all of these individual
+          brushes.
+
+        The default is 'global'.
+    mark : :class:`Mark` (optional)
+        An interval selection also adds a rectangle mark to depict the
+        extents of the interval. The mark property can be used to
+        customize the appearance of the mark.
+    translate : string or boolean (optional)
+        When truthy, allows a user to interactively move an interval
+        selection back-and-forth. Can be True, False (to disable panning),
+        or a Vega event stream definition which must include a start and
+        end event to trigger continuous panning. Discrete panning (e.g.,
+        pressing the left/right arrow keys) will be supported in future
+        versions.
+        The default value is True, which corresponds to
+        [pointerdown, window:pointerup] > window:pointermove!
+        This default allows users to click and drag within an interval
+        selection to reposition it.
+    zoom : string or boolean (optional)
+        When truthy, allows a user to interactively resize an interval
+        selection. Can be True, False (to disable zooming), or a Vega
+        event stream definition. Currently, only wheel events are supported,
+        but custom event streams can still be used to specify filters,
+        debouncing, and throttling. Future versions will expand the set of
+        events that can trigger this transformation.
+        The default value is True, which corresponds to wheel!. This
+        default allows users to use the mouse wheel to resize an interval
+        selection.
+    **kwds :
+        Additional keywords to control the selection.
+
+    Returns
+    -------
+    parameter: Parameter
+        The parameter object that can be used in chart creation.
+    """
+    return _selection(
+        type="interval",
+        name=name,
+        value=value,
+        bind=bind,
+        empty=empty,
+        expr=expr,
+        encodings=encodings,
+        on=on,
+        clear=clear,
+        resolve=resolve,
+        mark=mark,
+        translate=translate,
+        zoom=zoom,
+        **kwds,
+    )
+
+
+def selection_point(
+    name: Optional[str] = None,
+    value: Union[Any, UndefinedType] = Undefined,
+    bind: Union[core.Binding, str, UndefinedType] = Undefined,
+    empty: Union[bool, UndefinedType] = Undefined,
+    expr: Union[core.Expr, UndefinedType] = Undefined,
+    encodings: Union[List[str], UndefinedType] = Undefined,
+    fields: Union[List[str], UndefinedType] = Undefined,
+    on: Union[str, UndefinedType] = Undefined,
+    clear: Union[str, bool, UndefinedType] = Undefined,
+    resolve: Union[Literal["global", "union", "intersect"], UndefinedType] = Undefined,
+    toggle: Union[str, bool, UndefinedType] = Undefined,
+    nearest: Union[bool, UndefinedType] = Undefined,
+    **kwds,
+) -> Parameter:
+    """Create a point selection parameter. Selection parameters define data queries that are driven by direct manipulation from user input (e.g., mouse clicks or drags). Point selection parameters are used to select multiple discrete data values; the first value is selected on click and additional values toggled on shift-click. To select a continuous range of data values on drag interval selection parameters (`selection_interval`) can be used instead.
+
+    Parameters
+    ----------
+    name : string (optional)
+        The name of the parameter. If not specified, a unique name will be
+        created.
+    value : any (optional)
+        The default value of the parameter. If not specified, the parameter
+        will be created without a default value.
+    bind : :class:`Binding`, str (optional)
+        Binds the parameter to an external input element such as a slider,
+        selection list or radio button group.
+    empty : boolean (optional)
+        For selection parameters, the predicate of empty selections returns
+        True by default. Override this behavior, by setting this property
+        'empty=False'.
+    expr : :class:`Expr` (optional)
+        An expression for the value of the parameter. This expression may
+        include other parameters, in which case the parameter will
+        automatically update in response to upstream parameter changes.
+    encodings : List[str] (optional)
+        A list of encoding channels. The corresponding data field values
+        must match for a data tuple to fall within the selection.
+    fields : List[str] (optional)
+        A list of field names whose values must match for a data tuple to
+        fall within the selection.
+    on : string (optional)
+        A Vega event stream (object or selector) that triggers the selection.
+        For interval selections, the event stream must specify a start and end.
+    clear : string or boolean (optional)
+        Clears the selection, emptying it of all values. This property can
+        be an Event Stream or False to disable clear.  Default is 'dblclick'.
+    resolve : enum('global', 'union', 'intersect') (optional)
+        With layered and multi-view displays, a strategy that determines
+        how selections' data queries are resolved when applied in a filter
+        transform, conditional encoding rule, or scale domain.
+        One of:
+
+        * 'global': only one brush exists for the entire SPLOM. When the
+          user begins to drag, any previous brushes are cleared, and a
+          new one is constructed.
+        * 'union': each cell contains its own brush, and points are
+          highlighted if they lie within any of these individual brushes.
+        * 'intersect': each cell contains its own brush, and points are
+          highlighted only if they fall within all of these individual
+          brushes.
+
+        The default is 'global'.
+    toggle : string or boolean (optional)
+        Controls whether data values should be toggled (inserted or
+        removed from a point selection) or only ever inserted into
+        point selections.
+        One of:
+
+        * True (default): the toggle behavior, which corresponds to
+          "event.shiftKey". As a result, data values are toggled
+          when the user interacts with the shift-key pressed.
+        * False: disables toggling behaviour; the selection will
+          only ever contain a single data value corresponding
+          to the most recent interaction.
+        * A Vega expression which is re-evaluated as the user interacts.
+          If the expression evaluates to True, the data value is
+          toggled into or out of the point selection. If the expression
+          evaluates to False, the point selection is first cleared, and
+          the data value is then inserted. For example, setting the
+          value to the Vega expression True will toggle data values
+          without the user pressing the shift-key.
+
+    nearest : boolean (optional)
+        When true, an invisible voronoi diagram is computed to accelerate
+        discrete selection. The data value nearest the mouse cursor is
+        added to the selection.  The default is False, which means that
+        data values must be interacted with directly (e.g., clicked on)
+        to be added to the selection.
+    **kwds :
+        Additional keywords to control the selection.
+
+    Returns
+    -------
+    parameter: Parameter
+        The parameter object that can be used in chart creation.
+    """
+    return _selection(
+        type="point",
+        name=name,
+        value=value,
+        bind=bind,
+        empty=empty,
+        expr=expr,
+        encodings=encodings,
+        fields=fields,
+        on=on,
+        clear=clear,
+        resolve=resolve,
+        toggle=toggle,
+        nearest=nearest,
+        **kwds,
+    )
+
+
+@utils.deprecation.deprecated(
+    message="'selection_multi' is deprecated.  Use 'selection_point'"
+)
+@utils.use_signature(core.PointSelectionConfig)
+def selection_multi(**kwargs):
+    """'selection_multi' is deprecated.  Use 'selection_point'"""
+    return _selection(type="point", **kwargs)
+
+
+@utils.deprecation.deprecated(
+    message="'selection_single' is deprecated.  Use 'selection_point'"
+)
+@utils.use_signature(core.PointSelectionConfig)
+def selection_single(**kwargs):
+    """'selection_single' is deprecated.  Use 'selection_point'"""
+    return _selection(type="point", **kwargs)
+
+
+@utils.use_signature(core.Binding)
+def binding(input, **kwargs):
+    """A generic binding"""
+    return core.Binding(input=input, **kwargs)
+
+
+@utils.use_signature(core.BindCheckbox)
+def binding_checkbox(**kwargs):
+    """A checkbox binding"""
+    return core.BindCheckbox(input="checkbox", **kwargs)
+
+
+@utils.use_signature(core.BindRadioSelect)
+def binding_radio(**kwargs):
+    """A radio button binding"""
+    return core.BindRadioSelect(input="radio", **kwargs)
+
+
+@utils.use_signature(core.BindRadioSelect)
+def binding_select(**kwargs):
+    """A select binding"""
+    return core.BindRadioSelect(input="select", **kwargs)
+
+
+@utils.use_signature(core.BindRange)
+def binding_range(**kwargs):
+    """A range binding"""
+    return core.BindRange(input="range", **kwargs)
+
+
+# TODO: update the docstring
+def condition(
+    predicate: Union[
+        Parameter, str, expr.Expression, core.Expr, core.PredicateComposition, dict
+    ],
+    # Types of these depends on where the condition is used so we probably
+    # can't be more specific here.
+    if_true: Any,
+    if_false: Any,
+    **kwargs,
+) -> Union[dict, core.SchemaBase]:
+    """A conditional attribute or encoding
+
+    Parameters
+    ----------
+    predicate: Parameter, PredicateComposition, expr.Expression, dict, or string
+        the selection predicate or test predicate for the condition.
+        if a string is passed, it will be treated as a test operand.
+    if_true:
+        the spec or object to use if the selection predicate is true
+    if_false:
+        the spec or object to use if the selection predicate is false
+    **kwargs:
+        additional keyword args are added to the resulting dict
+
+    Returns
+    -------
+    spec: dict or VegaLiteSchema
+        the spec that describes the condition
+    """
+    test_predicates = (str, expr.Expression, core.PredicateComposition)
+
+    condition: TypingDict[
+        str,
+        Union[
+            bool, str, _expr_core.Expression, core.PredicateComposition, UndefinedType
+        ],
+    ]
+    if isinstance(predicate, Parameter):
+        if (
+            predicate.param_type == "selection"
+            or getattr(predicate.param, "expr", Undefined) is Undefined
+        ):
+            condition = {"param": predicate.name}
+            if "empty" in kwargs:
+                condition["empty"] = kwargs.pop("empty")
+            elif isinstance(predicate.empty, bool):
+                condition["empty"] = predicate.empty
+        else:
+            condition = {"test": getattr(predicate.param, "expr", Undefined)}
+    elif isinstance(predicate, test_predicates):
+        condition = {"test": predicate}
+    elif isinstance(predicate, dict):
+        condition = predicate
+    else:
+        raise NotImplementedError(
+            "condition predicate of type {}" "".format(type(predicate))
+        )
+
+    if isinstance(if_true, core.SchemaBase):
+        # convert to dict for now; the from_dict call below will wrap this
+        # dict in the appropriate schema
+        if_true = if_true.to_dict()
+    elif isinstance(if_true, str):
+        if isinstance(if_false, str):
+            raise ValueError(
+                "A field cannot be used for both the `if_true` and `if_false` values of a condition. One of them has to specify a `value` or `datum` definition."
+            )
+        else:
+            if_true = utils.parse_shorthand(if_true)
+            if_true.update(kwargs)
+    condition.update(if_true)
+
+    selection: Union[dict, core.SchemaBase]
+    if isinstance(if_false, core.SchemaBase):
+        # For the selection, the channel definitions all allow selections
+        # already. So use this SchemaBase wrapper if possible.
+        selection = if_false.copy()
+        selection.condition = condition
+    elif isinstance(if_false, str):
+        selection = {"condition": condition, "shorthand": if_false}
+        selection.update(kwargs)
+    else:
+        selection = dict(condition=condition, **if_false)
+
+    return selection
+
+
+# --------------------------------------------------------------------
+# Top-level objects
+
+
+class TopLevelMixin(mixins.ConfigMethodMixin):
+    """Mixin for top-level chart objects such as Chart, LayeredChart, etc."""
+
+    _class_is_valid_at_instantiation: bool = False
+
+    def to_dict(
+        self,
+        validate: bool = True,
+        *,
+        format: str = "vega-lite",
+        ignore: Optional[List[str]] = None,
+        context: Optional[TypingDict[str, Any]] = None,
+    ) -> dict:
+        """Convert the chart to a dictionary suitable for JSON export
+
+        Parameters
+        ----------
+        validate : bool, optional
+            If True (default), then validate the output dictionary
+            against the schema.
+        format : str, optional
+            Chart specification format, one of "vega-lite" (default) or "vega"
+        ignore : list[str], optional
+            A list of keys to ignore. It is usually not needed
+            to specify this argument as a user.
+        context : dict[str, Any], optional
+            A context dictionary. It is usually not needed
+            to specify this argument as a user.
+
+        Notes
+        -----
+        Technical: The ignore parameter will *not* be passed to child to_dict
+        function calls.
+
+        Returns
+        -------
+        dict
+            The dictionary representation of this chart
+
+        Raises
+        ------
+        SchemaValidationError
+            if validate=True and the dict does not conform to the schema
+        """
+
+        # Validate format
+        if format not in ("vega-lite", "vega"):
+            raise ValueError(
+                f'The format argument must be either "vega-lite" or "vega". Received {repr(format)}'
+            )
+
+        # We make use of three context markers:
+        # - 'data' points to the data that should be referenced for column type
+        #   inference.
+        # - 'top_level' is a boolean flag that is assumed to be true; if it's
+        #   true then a "$schema" arg is added to the dict.
+        # - 'datasets' is a dict of named datasets that should be inserted
+        #   in the top-level object
+        # - 'pre_transform' whether data transformations should be pre-evaluated
+        #   if the current data transformer supports it (currently only used when
+        #   the "vegafusion" transformer is enabled)
+
+        # note: not a deep copy because we want datasets and data arguments to
+        # be passed by reference
+        context = context.copy() if context else {}
+        context.setdefault("datasets", {})
+        is_top_level = context.get("top_level", True)
+
+        # TopLevelMixin instance does not necessarily have copy defined but due to how
+        # Altair is set up this should hold. Too complex to type hint right now
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        original_data = getattr(copy, "data", Undefined)
+        copy.data = _prepare_data(original_data, context)
+
+        if original_data is not Undefined:
+            context["data"] = original_data
+
+        # remaining to_dict calls are not at top level
+        context["top_level"] = False
+
+        # TopLevelMixin instance does not necessarily have to_dict defined
+        # but due to how Altair is set up this should hold.
+        # Too complex to type hint right now
+        vegalite_spec = super(TopLevelMixin, copy).to_dict(  # type: ignore[misc]
+            validate=validate, ignore=ignore, context=dict(context, pre_transform=False)
+        )
+
+        # TODO: following entries are added after validation. Should they be validated?
+        if is_top_level:
+            # since this is top-level we add $schema if it's missing
+            if "$schema" not in vegalite_spec:
+                vegalite_spec["$schema"] = SCHEMA_URL
+
+            # apply theme from theme registry
+            the_theme = themes.get()
+            # Use assert to tell type checkers that it is not None. Holds true
+            # as there is always a default theme set when importing Altair
+            assert the_theme is not None
+            vegalite_spec = utils.update_nested(the_theme(), vegalite_spec, copy=True)
+
+            # update datasets
+            if context["datasets"]:
+                vegalite_spec.setdefault("datasets", {}).update(context["datasets"])
+
+        if context.get("pre_transform", True) and _using_vegafusion():
+            if format == "vega-lite":
+                raise ValueError(
+                    'When the "vegafusion" data transformer is enabled, the \n'
+                    "to_dict() and to_json() chart methods must be called with "
+                    'format="vega". \n'
+                    "For example: \n"
+                    '    >>> chart.to_dict(format="vega")\n'
+                    '    >>> chart.to_json(format="vega")'
+                )
+            else:
+                return _compile_with_vegafusion(vegalite_spec)
+        else:
+            if format == "vega":
+                plugin = vegalite_compilers.get()
+                if plugin is None:
+                    raise ValueError("No active vega-lite compiler plugin found")
+                return plugin(vegalite_spec)
+            else:
+                return vegalite_spec
+
+    def to_json(
+        self,
+        validate: bool = True,
+        indent: Optional[Union[int, str]] = 2,
+        sort_keys: bool = True,
+        *,
+        format: str = "vega-lite",
+        ignore: Optional[List[str]] = None,
+        context: Optional[TypingDict[str, Any]] = None,
+        **kwargs,
+    ) -> str:
+        """Convert a chart to a JSON string
+
+        Parameters
+        ----------
+        validate : bool, optional
+            If True (default), then validate the output dictionary
+            against the schema.
+        indent : int, optional
+            The number of spaces of indentation to use. The default is 2.
+        sort_keys : bool, optional
+            If True (default), sort keys in the output.
+        format : str, optional
+            The chart specification format. One of "vega-lite" (default) or "vega".
+            The "vega" format relies on the active Vega-Lite compiler plugin, which
+            by default requires the vl-convert-python package.
+        ignore : list[str], optional
+            A list of keys to ignore. It is usually not needed
+            to specify this argument as a user.
+        context : dict[str, Any], optional
+            A context dictionary. It is usually not needed
+            to specify this argument as a user.
+        **kwargs
+            Additional keyword arguments are passed to ``json.dumps()``
+        """
+        if ignore is None:
+            ignore = []
+        if context is None:
+            context = {}
+        spec = self.to_dict(
+            validate=validate, format=format, ignore=ignore, context=context
+        )
+        return json.dumps(spec, indent=indent, sort_keys=sort_keys, **kwargs)
+
+    def to_html(
+        self,
+        base_url: str = "https://cdn.jsdelivr.net/npm",
+        output_div: str = "vis",
+        embed_options: Optional[dict] = None,
+        json_kwds: Optional[dict] = None,
+        fullhtml: bool = True,
+        requirejs: bool = False,
+        inline: bool = False,
+        **kwargs,
+    ) -> str:
+        """Embed a Vega/Vega-Lite spec into an HTML page
+
+        Parameters
+        ----------
+        base_url : string (optional)
+            The base url from which to load the javascript libraries.
+        output_div : string (optional)
+            The id of the div element where the plot will be shown.
+        embed_options : dict (optional)
+            Dictionary of options to pass to the vega-embed script. Default
+            entry is {'mode': mode}.
+        json_kwds : dict (optional)
+            Dictionary of keywords to pass to json.dumps().
+        fullhtml : boolean (optional)
+            If True (default) then return a full html page. If False, then return
+            an HTML snippet that can be embedded into an HTML page.
+        requirejs : boolean (optional)
+            If False (default) then load libraries from base_url using <script>
+            tags. If True, then load libraries using requirejs
+        inline: bool (optional)
+            If False (default), the required JavaScript libraries are loaded
+            from a CDN location in the resulting html file.
+            If True, the required JavaScript libraries are inlined into the resulting
+            html file so that it will work without an internet connection.
+            The vl-convert-python package is required if True.
+        **kwargs :
+            additional kwargs passed to spec_to_html.
+        Returns
+        -------
+        output : string
+            an HTML string for rendering the chart.
+        """
+        if inline:
+            kwargs["template"] = "inline"
+        return utils.spec_to_html(
+            self.to_dict(),
+            mode="vega-lite",
+            vegalite_version=VEGALITE_VERSION,
+            vegaembed_version=VEGAEMBED_VERSION,
+            vega_version=VEGA_VERSION,
+            base_url=base_url,
+            output_div=output_div,
+            embed_options=embed_options,
+            json_kwds=json_kwds,
+            fullhtml=fullhtml,
+            requirejs=requirejs,
+            **kwargs,
+        )
+
+    def to_url(self, *, fullscreen: bool = False) -> str:
+        """Convert a chart to a URL that opens the chart specification in the Vega chart editor
+        The chart specification (including any inline data) is encoded in the URL.
+
+        This method requires that the vl-convert-python package is installed.
+
+        Parameters
+        ----------
+        fullscreen : bool
+            If True, editor will open chart in fullscreen mode. Default False
+        """
+        from ...utils._importers import import_vl_convert
+
+        vlc = import_vl_convert()
+        if _using_vegafusion():
+            return vlc.vega_to_url(self.to_dict(format="vega"), fullscreen=fullscreen)
+        else:
+            return vlc.vegalite_to_url(self.to_dict(), fullscreen=fullscreen)
+
+    def open_editor(self, *, fullscreen: bool = False) -> None:
+        """Opens the chart specification in the Vega chart editor using the default browser.
+
+        Parameters
+        ----------
+        fullscreen : bool
+            If True, editor will open chart in fullscreen mode. Default False
+        """
+        import webbrowser
+
+        webbrowser.open(self.to_url(fullscreen=fullscreen))
+
+    def save(
+        self,
+        fp: Union[str, IO],
+        format: Optional[Literal["json", "html", "png", "svg", "pdf"]] = None,
+        override_data_transformer: bool = True,
+        scale_factor: float = 1.0,
+        mode: Optional[str] = None,
+        vegalite_version: str = VEGALITE_VERSION,
+        vega_version: str = VEGA_VERSION,
+        vegaembed_version: str = VEGAEMBED_VERSION,
+        embed_options: Optional[dict] = None,
+        json_kwds: Optional[dict] = None,
+        webdriver: Optional[str] = None,
+        engine: Optional[str] = None,
+        inline=False,
+        **kwargs,
+    ) -> None:
+        """Save a chart to file in a variety of formats
+
+        Supported formats are json, html, png, svg, pdf; the last three require
+        the altair_saver package to be installed.
+
+        Parameters
+        ----------
+        fp : string filename or file-like object
+            file in which to write the chart.
+        format : string (optional)
+            the format to write: one of ['json', 'html', 'png', 'svg', 'pdf'].
+            If not specified, the format will be determined from the filename.
+        override_data_transformer : `boolean` (optional)
+            If True (default), then the save action will be done with
+            the MaxRowsError disabled. If False, then do not change the data
+            transformer.
+        scale_factor : float (optional)
+            scale_factor to use to change size/resolution of png or svg output
+        mode : string (optional)
+            Must be 'vega-lite'. If not specified, then infer the mode from
+            the '$schema' property of the spec, or the ``opt`` dictionary.
+            If it's not specified in either of those places, then use 'vega-lite'.
+        vegalite_version : string (optional)
+            For html output, the version of vegalite.js to use
+        vega_version : string (optional)
+            For html output, the version of vega.js to use
+        vegaembed_version : string (optional)
+            For html output, the version of vegaembed.js to use
+        embed_options : dict (optional)
+            The vegaEmbed options dictionary. Default is {}
+            (See https://github.com/vega/vega-embed for details)
+        json_kwds : dict (optional)
+            Additional keyword arguments are passed to the output method
+            associated with the specified format.
+        webdriver : string {'chrome' | 'firefox'} (optional)
+            Webdriver to use for png, svg, or pdf output when using altair_saver engine
+        engine: string {'vl-convert', 'altair_saver'}
+            the conversion engine to use for 'png', 'svg', and 'pdf' formats
+        inline: bool (optional)
+            If False (default), the required JavaScript libraries are loaded
+            from a CDN location in the resulting html file.
+            If True, the required JavaScript libraries are inlined into the resulting
+            html file so that it will work without an internet connection.
+            The vl-convert-python package is required if True.
+        **kwargs :
+            additional kwargs passed to spec_to_mimebundle.
+        """
+        from ...utils.save import save
+
+        kwds = dict(
+            chart=self,
+            fp=fp,
+            format=format,
+            scale_factor=scale_factor,
+            mode=mode,
+            vegalite_version=vegalite_version,
+            vega_version=vega_version,
+            vegaembed_version=vegaembed_version,
+            embed_options=embed_options,
+            json_kwds=json_kwds,
+            webdriver=webdriver,
+            engine=engine,
+            inline=inline,
+            **kwargs,
+        )
+
+        # By default we override the data transformer. This makes it so
+        # that save() will succeed even for large datasets that would
+        # normally trigger a MaxRowsError
+        if override_data_transformer:
+            with data_transformers.disable_max_rows():
+                save(**kwds)
+        else:
+            save(**kwds)
+        return
+
+    # Fallback for when rendering fails; the full repr is too long to be
+    # useful in nearly all cases.
+    def __repr__(self) -> str:
+        return "alt.{}(...)".format(self.__class__.__name__)
+
+    # Layering and stacking
+    def __add__(self, other) -> "LayerChart":
+        if not isinstance(other, TopLevelMixin):
+            raise ValueError("Only Chart objects can be layered.")
+        return layer(self, other)
+
+    def __and__(self, other) -> "VConcatChart":
+        if not isinstance(other, TopLevelMixin):
+            raise ValueError("Only Chart objects can be concatenated.")
+        # Too difficult to type check this
+        return vconcat(self, other)
+
+    def __or__(self, other) -> "HConcatChart":
+        if not isinstance(other, TopLevelMixin):
+            raise ValueError("Only Chart objects can be concatenated.")
+        return hconcat(self, other)
+
+    def repeat(
+        self,
+        repeat: Union[List[str], UndefinedType] = Undefined,
+        row: Union[List[str], UndefinedType] = Undefined,
+        column: Union[List[str], UndefinedType] = Undefined,
+        layer: Union[List[str], UndefinedType] = Undefined,
+        columns: Union[int, UndefinedType] = Undefined,
+        **kwargs,
+    ) -> "RepeatChart":
+        """Return a RepeatChart built from the chart
+
+        Fields within the chart can be set to correspond to the row or
+        column using `alt.repeat('row')` and `alt.repeat('column')`.
+
+        Parameters
+        ----------
+        repeat : list
+            a list of data column names to be repeated. This cannot be
+            used along with the ``row``, ``column`` or ``layer`` argument.
+        row : list
+            a list of data column names to be mapped to the row facet
+        column : list
+            a list of data column names to be mapped to the column facet
+        layer : list
+            a list of data column names to be layered. This cannot be
+            used along with the ``row``, ``column`` or ``repeat`` argument.
+        columns : int
+            the maximum number of columns before wrapping. Only referenced
+            if ``repeat`` is specified.
+        **kwargs :
+            additional keywords passed to RepeatChart.
+
+        Returns
+        -------
+        chart : RepeatChart
+            a repeated chart.
+        """
+        repeat_specified = repeat is not Undefined
+        rowcol_specified = row is not Undefined or column is not Undefined
+        layer_specified = layer is not Undefined
+
+        if repeat_specified and rowcol_specified:
+            raise ValueError(
+                "repeat argument cannot be combined with row/column argument."
+            )
+        elif repeat_specified and layer_specified:
+            raise ValueError("repeat argument cannot be combined with layer argument.")
+
+        repeat_arg: Union[List[str], core.LayerRepeatMapping, core.RepeatMapping]
+        if repeat_specified:
+            assert not isinstance(repeat, UndefinedType)  # For mypy
+            repeat_arg = repeat
+        elif layer_specified:
+            repeat_arg = core.LayerRepeatMapping(layer=layer, row=row, column=column)
+        else:
+            repeat_arg = core.RepeatMapping(row=row, column=column)
+
+        return RepeatChart(spec=self, repeat=repeat_arg, columns=columns, **kwargs)
+
+    def properties(self, **kwargs) -> Self:
+        """Set top-level properties of the Chart.
+
+        Argument names and types are the same as class initialization.
+        """
+        # ignore type as copy comes from another class for subclasses of TopLevelMixin
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        for key, val in kwargs.items():
+            if key == "selection" and isinstance(val, Parameter):
+                # TODO: Can this be removed
+                # For backward compatibility with old selection interface.
+                setattr(copy, key, {val.name: val.selection})
+            else:
+                # Don't validate data, because it hasn't been processed.
+                if key != "data":
+                    # ignore type as validate_property comes from SchemaBase,
+                    # not from TopLevelMixin
+                    self.validate_property(key, val)  # type: ignore[attr-defined]
+                setattr(copy, key, val)
+        return copy
+
+    def project(
+        self,
+        type: Union[
+            str, core.ProjectionType, core.ExprRef, Parameter, UndefinedType
+        ] = Undefined,
+        center: Union[
+            List[float], core.Vector2number, core.ExprRef, Parameter, UndefinedType
+        ] = Undefined,
+        clipAngle: Union[float, core.ExprRef, Parameter, UndefinedType] = Undefined,
+        clipExtent: Union[
+            List[List[float]],
+            core.Vector2Vector2number,
+            core.ExprRef,
+            Parameter,
+            UndefinedType,
+        ] = Undefined,
+        coefficient: Union[float, core.ExprRef, Parameter, UndefinedType] = Undefined,
+        distance: Union[float, core.ExprRef, Parameter, UndefinedType] = Undefined,
+        fraction: Union[float, core.ExprRef, Parameter, UndefinedType] = Undefined,
+        lobes: Union[float, core.ExprRef, Parameter, UndefinedType] = Undefined,
+        parallel: Union[float, core.ExprRef, Parameter, UndefinedType] = Undefined,
+        precision: Union[float, core.ExprRef, Parameter, UndefinedType] = Undefined,
+        radius: Union[float, core.ExprRef, Parameter, UndefinedType] = Undefined,
+        ratio: Union[float, core.ExprRef, Parameter, UndefinedType] = Undefined,
+        reflectX: Union[bool, core.ExprRef, Parameter, UndefinedType] = Undefined,
+        reflectY: Union[bool, core.ExprRef, Parameter, UndefinedType] = Undefined,
+        rotate: Union[
+            List[float],
+            core.Vector2number,
+            core.Vector3number,
+            core.ExprRef,
+            Parameter,
+            UndefinedType,
+        ] = Undefined,
+        scale: Union[float, core.ExprRef, Parameter, UndefinedType] = Undefined,
+        spacing: Union[
+            float, core.Vector2number, core.ExprRef, Parameter, UndefinedType
+        ] = Undefined,
+        tilt: Union[float, core.ExprRef, Parameter, UndefinedType] = Undefined,
+        translate: Union[
+            List[float], core.Vector2number, core.ExprRef, Parameter, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Add a geographic projection to the chart.
+
+        This is generally used either with ``mark_geoshape`` or with the
+        ``latitude``/``longitude`` encodings.
+
+        Available projection types are
+        ['albers', 'albersUsa', 'azimuthalEqualArea', 'azimuthalEquidistant',
+        'conicConformal', 'conicEqualArea', 'conicEquidistant', 'equalEarth', 'equirectangular',
+        'gnomonic', 'identity', 'mercator', 'orthographic', 'stereographic', 'transverseMercator']
+
+        Parameters
+        ----------
+        type : str
+            The cartographic projection to use. This value is case-insensitive, for example
+            `"albers"` and `"Albers"` indicate the same projection type. You can find all valid
+            projection types [in the
+            documentation](https://vega.github.io/vega-lite/docs/projection.html#projection-types).
+
+            **Default value:** `equalEarth`
+        center : List(float)
+            Sets the projection’s center to the specified center, a two-element array of
+            longitude and latitude in degrees.
+
+            **Default value:** `[0, 0]`
+        clipAngle : float
+            Sets the projection’s clipping circle radius to the specified angle in degrees. If
+            `null`, switches to [antimeridian](http://bl.ocks.org/mbostock/3788999) cutting
+            rather than small-circle clipping.
+        clipExtent : List(List(float))
+            Sets the projection’s viewport clip extent to the specified bounds in pixels. The
+            extent bounds are specified as an array `[[x0, y0], [x1, y1]]`, where `x0` is the
+            left-side of the viewport, `y0` is the top, `x1` is the right and `y1` is the
+            bottom. If `null`, no viewport clipping is performed.
+        coefficient : float
+            The coefficient parameter for the ``hammer`` projection.
+
+            **Default value:** ``2``
+        distance : float
+            For the ``satellite`` projection, the distance from the center of the sphere to the
+            point of view, as a proportion of the sphere’s radius. The recommended maximum clip
+            angle for a given ``distance`` is acos(1 / distance) converted to degrees. If tilt
+            is also applied, then more conservative clipping may be necessary.
+
+            **Default value:** ``2.0``
+        fraction : float
+            The fraction parameter for the ``bottomley`` projection.
+
+            **Default value:** ``0.5``, corresponding to a sin(ψ) where ψ = π/6.
+        lobes : float
+            The number of lobes in projections that support multi-lobe views: ``berghaus``,
+            ``gingery``, or ``healpix``. The default value varies based on the projection type.
+        parallel : float
+            For conic projections, the `two standard parallels
+            <https://en.wikipedia.org/wiki/Map_projection#Conic>`__ that define the map layout.
+            The default depends on the specific conic projection used.
+        precision : float
+            Sets the threshold for the projection’s [adaptive
+            resampling](http://bl.ocks.org/mbostock/3795544) to the specified value in pixels.
+            This value corresponds to the [Douglas–Peucker
+            distance](http://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm).
+             If precision is not specified, returns the projection’s current resampling
+            precision which defaults to `√0.5 ≅ 0.70710…`.
+        radius : float
+            The radius parameter for the ``airy`` or ``gingery`` projection. The default value
+            varies based on the projection type.
+        ratio : float
+            The ratio parameter for the ``hill``, ``hufnagel``, or ``wagner`` projections. The
+            default value varies based on the projection type.
+        reflectX : boolean
+            Sets whether or not the x-dimension is reflected (negated) in the output.
+        reflectY : boolean
+            Sets whether or not the y-dimension is reflected (negated) in the output.
+        rotate : List(float)
+            Sets the projection’s three-axis rotation to the specified angles, which must be a
+            two- or three-element array of numbers [`lambda`, `phi`, `gamma`] specifying the
+            rotation angles in degrees about each spherical axis. (These correspond to yaw,
+            pitch and roll.)
+
+            **Default value:** `[0, 0, 0]`
+        scale : float
+            The projection’s scale (zoom) factor, overriding automatic fitting. The default
+            scale is projection-specific. The scale factor corresponds linearly to the distance
+            between projected points; however, scale factor values are not equivalent across
+            projections.
+        spacing : float
+            The spacing parameter for the ``lagrange`` projection.
+
+            **Default value:** ``0.5``
+        tilt : float
+            The tilt angle (in degrees) for the ``satellite`` projection.
+
+            **Default value:** ``0``.
+        translate : List(float)
+            The projection’s translation offset as a two-element array ``[tx, ty]``,
+            overriding automatic fitting.
+
+        """
+        projection = core.Projection(
+            center=center,
+            clipAngle=clipAngle,
+            clipExtent=clipExtent,
+            coefficient=coefficient,
+            distance=distance,
+            fraction=fraction,
+            lobes=lobes,
+            parallel=parallel,
+            precision=precision,
+            radius=radius,
+            ratio=ratio,
+            reflectX=reflectX,
+            reflectY=reflectY,
+            rotate=rotate,
+            scale=scale,
+            spacing=spacing,
+            tilt=tilt,
+            translate=translate,
+            # Ignore as we type here `type` as a str but in core.Projection
+            # it's a Literal with all options
+            type=type,  # type: ignore[arg-type]
+            **kwds,
+        )
+        return self.properties(projection=projection)
+
+    def _add_transform(self, *transforms: core.Transform) -> Self:
+        """Copy the chart and add specified transforms to chart.transform"""
+        copy = self.copy(deep=["transform"])  # type: ignore[attr-defined]
+        if copy.transform is Undefined:
+            copy.transform = []
+        copy.transform.extend(transforms)
+        return copy
+
+    def transform_aggregate(
+        self,
+        aggregate: Union[List[core.AggregatedFieldDef], UndefinedType] = Undefined,
+        groupby: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+        **kwds: Union[TypingDict[str, Any], str],
+    ) -> Self:
+        """
+        Add an :class:`AggregateTransform` to the schema.
+
+        Parameters
+        ----------
+        aggregate : List(:class:`AggregatedFieldDef`)
+            Array of objects that define fields to aggregate.
+        groupby : List(string)
+            The data fields to group by. If not specified, a single group containing all data
+            objects will be used.
+        **kwds : Union[TypingDict[str, Any], str]
+            additional keywords are converted to aggregates using standard
+            shorthand parsing.
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        Examples
+        --------
+        The aggregate transform allows you to specify transforms directly using
+        the same shorthand syntax as used in encodings:
+
+        >>> import altair as alt
+        >>> chart1 = alt.Chart().transform_aggregate(
+        ...     mean_acc='mean(Acceleration)',
+        ...     groupby=['Origin']
+        ... )
+        >>> print(chart1.transform[0].to_json())  # doctest: +NORMALIZE_WHITESPACE
+        {
+          "aggregate": [
+            {
+              "as": "mean_acc",
+              "field": "Acceleration",
+              "op": "mean"
+            }
+          ],
+          "groupby": [
+            "Origin"
+          ]
+        }
+
+        It also supports including AggregatedFieldDef instances or dicts directly,
+        so you can create the above transform like this:
+
+        >>> chart2 = alt.Chart().transform_aggregate(
+        ...     [alt.AggregatedFieldDef(field='Acceleration', op='mean',
+        ...                             **{'as': 'mean_acc'})],
+        ...     groupby=['Origin']
+        ... )
+        >>> chart2.transform == chart1.transform
+        True
+
+        See Also
+        --------
+        alt.AggregateTransform : underlying transform object
+
+        """
+        if aggregate is Undefined:
+            aggregate = []
+        for key, val in kwds.items():
+            parsed = utils.parse_shorthand(val)
+            dct = {
+                "as": key,
+                "field": parsed.get("field", Undefined),
+                "op": parsed.get("aggregate", Undefined),
+            }
+            assert not isinstance(aggregate, UndefinedType)  # For mypy
+            aggregate.append(core.AggregatedFieldDef(**dct))
+        return self._add_transform(
+            core.AggregateTransform(aggregate=aggregate, groupby=groupby)
+        )
+
+    def transform_bin(
+        self,
+        as_: Union[
+            str, core.FieldName, List[Union[str, core.FieldName]], UndefinedType
+        ] = Undefined,
+        field: Union[str, core.FieldName, UndefinedType] = Undefined,
+        bin: Union[Literal[True], core.BinParams] = True,
+        **kwargs,
+    ) -> Self:
+        """
+        Add a :class:`BinTransform` to the schema.
+
+        Parameters
+        ----------
+        as_ : anyOf(string, List(string))
+            The output fields at which to write the start and end bin values.
+        bin : anyOf(boolean, :class:`BinParams`)
+            An object indicating bin properties, or simply ``true`` for using default bin
+            parameters.
+        field : string
+            The data field to bin.
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        Examples
+        --------
+        >>> import altair as alt
+        >>> chart = alt.Chart().transform_bin("x_binned", "x")
+        >>> chart.transform[0]
+        BinTransform({
+          as: 'x_binned',
+          bin: True,
+          field: 'x'
+        })
+
+        >>> chart = alt.Chart().transform_bin("x_binned", "x",
+        ...                                   bin=alt.Bin(maxbins=10))
+        >>> chart.transform[0]
+        BinTransform({
+          as: 'x_binned',
+          bin: BinParams({
+            maxbins: 10
+          }),
+          field: 'x'
+        })
+
+        See Also
+        --------
+        alt.BinTransform : underlying transform object
+
+        """
+        if as_ is not Undefined:
+            if "as" in kwargs:
+                raise ValueError(
+                    "transform_bin: both 'as_' and 'as' passed as arguments."
+                )
+            kwargs["as"] = as_
+        kwargs["bin"] = bin
+        kwargs["field"] = field
+        return self._add_transform(core.BinTransform(**kwargs))
+
+    def transform_calculate(
+        self,
+        as_: Union[str, core.FieldName, UndefinedType] = Undefined,
+        calculate: Union[
+            str, core.Expr, _expr_core.Expression, UndefinedType
+        ] = Undefined,
+        **kwargs: Union[str, core.Expr, _expr_core.Expression],
+    ) -> Self:
+        """
+        Add a :class:`CalculateTransform` to the schema.
+
+        Parameters
+        ----------
+        as_ : string
+            The field for storing the computed formula value.
+        calculate : string or alt.expr.Expression
+            An `expression <https://vega.github.io/vega-lite/docs/types.html#expression>`__
+            string. Use the variable ``datum`` to refer to the current data object.
+        **kwargs
+            transforms can also be passed by keyword argument; see Examples
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        Examples
+        --------
+        >>> import altair as alt
+        >>> from altair import datum, expr
+
+        >>> chart = alt.Chart().transform_calculate(y = 2 * expr.sin(datum.x))
+        >>> chart.transform[0]
+        CalculateTransform({
+          as: 'y',
+          calculate: (2 * sin(datum.x))
+        })
+
+        It's also possible to pass the ``CalculateTransform`` arguments directly:
+
+        >>> kwds = {'as_': 'y', 'calculate': '2 * sin(datum.x)'}
+        >>> chart = alt.Chart().transform_calculate(**kwds)
+        >>> chart.transform[0]
+        CalculateTransform({
+          as: 'y',
+          calculate: '2 * sin(datum.x)'
+        })
+
+        As the first form is easier to write and understand, that is the
+        recommended method.
+
+        See Also
+        --------
+        alt.CalculateTransform : underlying transform object
+        """
+        if as_ is Undefined:
+            # Ignoring assignment error as passing 'as' as a keyword argument is
+            # an edge case and it's not worth changing the type annotation
+            # in this function to account for it as it could be confusing to
+            # users.
+            as_ = kwargs.pop("as", Undefined)  # type: ignore[assignment]
+        elif "as" in kwargs:
+            raise ValueError(
+                "transform_calculate: both 'as_' and 'as' passed as arguments."
+            )
+        if as_ is not Undefined or calculate is not Undefined:
+            dct = {"as": as_, "calculate": calculate}
+            self = self._add_transform(core.CalculateTransform(**dct))  # type: ignore[arg-type]
+        for as_, calculate in kwargs.items():
+            dct = {"as": as_, "calculate": calculate}
+            self = self._add_transform(core.CalculateTransform(**dct))  # type: ignore[arg-type]
+        return self
+
+    def transform_density(
+        self,
+        density: Union[str, core.FieldName],
+        as_: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+        bandwidth: Union[float, UndefinedType] = Undefined,
+        counts: Union[bool, UndefinedType] = Undefined,
+        cumulative: Union[bool, UndefinedType] = Undefined,
+        extent: Union[List[float], UndefinedType] = Undefined,
+        groupby: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+        maxsteps: Union[int, UndefinedType] = Undefined,
+        minsteps: Union[int, UndefinedType] = Undefined,
+        steps: Union[int, UndefinedType] = Undefined,
+    ) -> Self:
+        """Add a :class:`DensityTransform` to the spec.
+
+        Parameters
+        ----------
+        density : str
+            The data field for which to perform density estimation.
+        as_ : [str, str]
+            The output fields for the sample value and corresponding density estimate.
+            **Default value:** ``["value", "density"]``
+        bandwidth : float
+            The bandwidth (standard deviation) of the Gaussian kernel. If unspecified or set to
+            zero, the bandwidth value is automatically estimated from the input data using
+            Scott’s rule.
+        counts : boolean
+            A boolean flag indicating if the output values should be probability estimates
+            (false) or smoothed counts (true).
+            **Default value:** ``false``
+        cumulative : boolean
+            A boolean flag indicating whether to produce density estimates (false) or cumulative
+            density estimates (true).
+            **Default value:** ``false``
+        extent : List([float, float])
+            A [min, max] domain from which to sample the distribution. If unspecified, the
+            extent will be determined by the observed minimum and maximum values of the density
+            value field.
+        groupby : List(str)
+            The data fields to group by. If not specified, a single group containing all data
+            objects will be used.
+        maxsteps : int
+            The maximum number of samples to take along the extent domain for plotting the
+            density. **Default value:** ``200``
+        minsteps : int
+            The minimum number of samples to take along the extent domain for plotting the
+            density. **Default value:** ``25``
+        steps : int
+            The exact number of samples to take along the extent domain for plotting the
+            density. If specified, overrides both minsteps and maxsteps to set an exact number
+            of uniform samples. Potentially useful in conjunction with a fixed extent to ensure
+            consistent sample points for stacked densities.
+        """
+        return self._add_transform(
+            core.DensityTransform(
+                density=density,
+                bandwidth=bandwidth,
+                counts=counts,
+                cumulative=cumulative,
+                extent=extent,
+                groupby=groupby,
+                maxsteps=maxsteps,
+                minsteps=minsteps,
+                steps=steps,
+                **{"as": as_},
+            )
+        )
+
+    def transform_impute(
+        self,
+        impute: Union[str, core.FieldName],
+        key: Union[str, core.FieldName],
+        frame: Union[List[Optional[int]], UndefinedType] = Undefined,
+        groupby: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+        keyvals: Union[List[Any], core.ImputeSequence, UndefinedType] = Undefined,
+        method: Union[
+            Literal["value", "mean", "median", "max", "min"],
+            core.ImputeMethod,
+            UndefinedType,
+        ] = Undefined,
+        value=Undefined,
+    ) -> Self:
+        """
+        Add an :class:`ImputeTransform` to the schema.
+
+        Parameters
+        ----------
+        impute : string
+            The data field for which the missing values should be imputed.
+        key : string
+            A key field that uniquely identifies data objects within a group.
+            Missing key values (those occurring in the data but not in the current group) will
+            be imputed.
+        frame : List(anyOf(None, int))
+            A frame specification as a two-element array used to control the window over which
+            the specified method is applied. The array entries should either be a number
+            indicating the offset from the current data object, or null to indicate unbounded
+            rows preceding or following the current data object.  For example, the value ``[-5,
+            5]`` indicates that the window should include five objects preceding and five
+            objects following the current object.
+            **Default value:** :  ``[null, null]`` indicating that the window includes all
+            objects.
+        groupby : List(string)
+            An optional array of fields by which to group the values.
+            Imputation will then be performed on a per-group basis.
+        keyvals : anyOf(List(Mapping(required=[])), :class:`ImputeSequence`)
+            Defines the key values that should be considered for imputation.
+            An array of key values or an object defining a `number sequence
+            <https://vega.github.io/vega-lite/docs/impute.html#sequence-def>`__.
+            If provided, this will be used in addition to the key values observed within the
+            input data.  If not provided, the values will be derived from all unique values of
+            the ``key`` field. For ``impute`` in ``encoding``, the key field is the x-field if
+            the y-field is imputed, or vice versa.
+            If there is no impute grouping, this property *must* be specified.
+        method : :class:`ImputeMethod`
+            The imputation method to use for the field value of imputed data objects.
+            One of ``value``, ``mean``, ``median``, ``max`` or ``min``.
+            **Default value:**  ``"value"``
+        value : Mapping(required=[])
+            The field value to use when the imputation ``method`` is ``"value"``.
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        See Also
+        --------
+        alt.ImputeTransform : underlying transform object
+        """
+        return self._add_transform(
+            core.ImputeTransform(
+                impute=impute,
+                key=key,
+                frame=frame,
+                groupby=groupby,
+                keyvals=keyvals,
+                method=method,
+                value=value,
+            )
+        )
+
+    def transform_joinaggregate(
+        self,
+        joinaggregate: Union[
+            List[core.JoinAggregateFieldDef], UndefinedType
+        ] = Undefined,
+        groupby: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+        **kwargs: str,
+    ) -> Self:
+        """
+        Add a :class:`JoinAggregateTransform` to the schema.
+
+        Parameters
+        ----------
+        joinaggregate : List(:class:`JoinAggregateFieldDef`)
+            The definition of the fields in the join aggregate, and what calculations to use.
+        groupby : List(string)
+            The data fields for partitioning the data objects into separate groups. If
+            unspecified, all data points will be in a single group.
+        **kwargs
+            joinaggregates can also be passed by keyword argument; see Examples.
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        Examples
+        --------
+        >>> import altair as alt
+        >>> chart = alt.Chart().transform_joinaggregate(x='sum(y)')
+        >>> chart.transform[0]
+        JoinAggregateTransform({
+          joinaggregate: [JoinAggregateFieldDef({
+            as: 'x',
+            field: 'y',
+            op: 'sum'
+          })]
+        })
+
+        See Also
+        --------
+        alt.JoinAggregateTransform : underlying transform object
+        """
+        if joinaggregate is Undefined:
+            joinaggregate = []
+        for key, val in kwargs.items():
+            parsed = utils.parse_shorthand(val)
+            dct = {
+                "as": key,
+                "field": parsed.get("field", Undefined),
+                "op": parsed.get("aggregate", Undefined),
+            }
+            assert not isinstance(joinaggregate, UndefinedType)  # For mypy
+            joinaggregate.append(core.JoinAggregateFieldDef(**dct))
+        return self._add_transform(
+            core.JoinAggregateTransform(joinaggregate=joinaggregate, groupby=groupby)
+        )
+
+    def transform_extent(
+        self, extent: Union[str, core.FieldName], param: Union[str, core.ParameterName]
+    ) -> Self:
+        """Add a :class:`ExtentTransform` to the spec.
+
+        Parameters
+        ----------
+        extent : str
+            The field of which to get the extent.
+        param : str
+            The name of the output parameter which will be created by
+            the extent transform.
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+        """
+        return self._add_transform(core.ExtentTransform(extent=extent, param=param))
+
+    # TODO: Update docstring
+    def transform_filter(
+        self,
+        filter: Union[
+            str,
+            core.Expr,
+            _expr_core.Expression,
+            core.Predicate,
+            Parameter,
+            core.PredicateComposition,
+            # E.g. {'not': alt.FieldRangePredicate(field='year', range=[1950, 1960])}
+            TypingDict[str, Union[core.Predicate, str, list, bool]],
+        ],
+        **kwargs,
+    ) -> Self:
+        """
+        Add a :class:`FilterTransform` to the schema.
+
+        Parameters
+        ----------
+        filter : a filter expression or :class:`PredicateComposition`
+            The `filter` property must be one of the predicate definitions:
+            (1) a string or alt.expr expression
+            (2) a range predicate
+            (3) a selection predicate
+            (4) a logical operand combining (1)-(3)
+            (5) a Selection object
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+        """
+        if isinstance(filter, Parameter):
+            new_filter: TypingDict[str, Union[bool, str]] = {"param": filter.name}
+            if "empty" in kwargs:
+                new_filter["empty"] = kwargs.pop("empty")
+            elif isinstance(filter.empty, bool):
+                new_filter["empty"] = filter.empty
+            filter = new_filter  # type: ignore[assignment]
+        return self._add_transform(core.FilterTransform(filter=filter, **kwargs))  # type: ignore[arg-type]
+
+    def transform_flatten(
+        self,
+        flatten: List[Union[str, core.FieldName]],
+        as_: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+    ) -> Self:
+        """Add a :class:`FlattenTransform` to the schema.
+
+        Parameters
+        ----------
+        flatten : List(string)
+            An array of one or more data fields containing arrays to flatten.
+            If multiple fields are specified, their array values should have a parallel
+            structure, ideally with the same length.
+            If the lengths of parallel arrays do not match,
+            the longest array will be used with ``null`` values added for missing entries.
+        as : List(string)
+            The output field names for extracted array values.
+            **Default value:** The field name of the corresponding array field
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        See Also
+        --------
+        alt.FlattenTransform : underlying transform object
+        """
+        return self._add_transform(
+            core.FlattenTransform(flatten=flatten, **{"as": as_})
+        )
+
+    def transform_fold(
+        self,
+        fold: List[Union[str, core.FieldName]],
+        as_: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+    ) -> Self:
+        """Add a :class:`FoldTransform` to the spec.
+
+        Parameters
+        ----------
+        fold : List(string)
+            An array of data fields indicating the properties to fold.
+        as : [string, string]
+            The output field names for the key and value properties produced by the fold
+            transform. Default: ``["key", "value"]``
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        See Also
+        --------
+        Chart.transform_pivot : pivot transform - opposite of fold.
+        alt.FoldTransform : underlying transform object
+        """
+        return self._add_transform(core.FoldTransform(fold=fold, **{"as": as_}))
+
+    def transform_loess(
+        self,
+        on: Union[str, core.FieldName],
+        loess: Union[str, core.FieldName],
+        as_: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+        bandwidth: Union[float, UndefinedType] = Undefined,
+        groupby: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+    ) -> Self:
+        """Add a :class:`LoessTransform` to the spec.
+
+        Parameters
+        ----------
+        on : str
+            The data field of the independent variable to use a predictor.
+        loess : str
+            The data field of the dependent variable to smooth.
+        as_ : [str, str]
+            The output field names for the smoothed points generated by the loess transform.
+            **Default value:** The field names of the input x and y values.
+        bandwidth : float
+            A bandwidth parameter in the range ``[0, 1]`` that determines the amount of
+            smoothing. **Default value:** ``0.3``
+        groupby : List(str)
+            The data fields to group by. If not specified, a single group containing all data
+            objects will be used.
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        See Also
+        --------
+        Chart.transform_regression: regression transform
+        alt.LoessTransform : underlying transform object
+        """
+        return self._add_transform(
+            core.LoessTransform(
+                loess=loess, on=on, bandwidth=bandwidth, groupby=groupby, **{"as": as_}
+            )
+        )
+
+    def transform_lookup(
+        self,
+        lookup: Union[str, UndefinedType] = Undefined,
+        from_: Union[core.LookupData, core.LookupSelection, UndefinedType] = Undefined,
+        as_: Union[
+            Union[str, core.FieldName], List[Union[str, core.FieldName]], UndefinedType
+        ] = Undefined,
+        default: Union[str, UndefinedType] = Undefined,
+        **kwargs,
+    ) -> Self:
+        """Add a :class:`DataLookupTransform` or :class:`SelectionLookupTransform` to the chart
+
+        Parameters
+        ----------
+        lookup : string
+            Key in primary data source.
+        from_ : anyOf(:class:`LookupData`, :class:`LookupSelection`)
+            Secondary data reference.
+        as_ : anyOf(string, List(string))
+            The output fields on which to store the looked up data values.
+
+            For data lookups, this property may be left blank if ``from_.fields``
+            has been specified (those field names will be used); if ``from_.fields``
+            has not been specified, ``as_`` must be a string.
+
+            For selection lookups, this property is optional: if unspecified,
+            looked up values will be stored under a property named for the selection;
+            and if specified, it must correspond to ``from_.fields``.
+        default : string
+            The default value to use if lookup fails. **Default value:** ``null``
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        See Also
+        --------
+        alt.DataLookupTransform : underlying transform object
+        alt.SelectionLookupTransform : underlying transform object
+        """
+        if as_ is not Undefined:
+            if "as" in kwargs:
+                raise ValueError(
+                    "transform_lookup: both 'as_' and 'as' passed as arguments."
+                )
+            kwargs["as"] = as_
+        if from_ is not Undefined:
+            if "from" in kwargs:
+                raise ValueError(
+                    "transform_lookup: both 'from_' and 'from' passed as arguments."
+                )
+            kwargs["from"] = from_
+        kwargs["lookup"] = lookup
+        kwargs["default"] = default
+        return self._add_transform(core.LookupTransform(**kwargs))
+
+    def transform_pivot(
+        self,
+        pivot: Union[str, core.FieldName],
+        value: Union[str, core.FieldName],
+        groupby: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+        limit: Union[int, UndefinedType] = Undefined,
+        op: Union[str, core.AggregateOp, UndefinedType] = Undefined,
+    ) -> Self:
+        """Add a :class:`PivotTransform` to the chart.
+
+        Parameters
+        ----------
+        pivot : str
+            The data field to pivot on. The unique values of this field become new field names
+            in the output stream.
+        value : str
+            The data field to populate pivoted fields. The aggregate values of this field become
+            the values of the new pivoted fields.
+        groupby : List(str)
+            The optional data fields to group by. If not specified, a single group containing
+            all data objects will be used.
+        limit : int
+            An optional parameter indicating the maximum number of pivoted fields to generate.
+            The default ( ``0`` ) applies no limit. The pivoted ``pivot`` names are sorted in
+            ascending order prior to enforcing the limit.
+            **Default value:** ``0``
+        op : string
+            The aggregation operation to apply to grouped ``value`` field values.
+            **Default value:** ``sum``
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        See Also
+        --------
+        Chart.transform_fold : fold transform - opposite of pivot.
+        alt.PivotTransform : underlying transform object
+        """
+        return self._add_transform(
+            core.PivotTransform(
+                # Ignore as we type here `op` as a str but in core.PivotTransform
+                # it's a Literal with all options
+                pivot=pivot,
+                value=value,
+                groupby=groupby,
+                limit=limit,
+                op=op,  # type: ignore[arg-type]
+            )
+        )
+
+    def transform_quantile(
+        self,
+        quantile: Union[str, core.FieldName],
+        as_: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+        groupby: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+        probs: Union[List[float], UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+    ) -> Self:
+        """Add a :class:`QuantileTransform` to the chart
+
+        Parameters
+        ----------
+        quantile : str
+            The data field for which to perform quantile estimation.
+        as : [str, str]
+            The output field names for the probability and quantile values.
+        groupby : List(str)
+            The data fields to group by. If not specified, a single group containing all data
+            objects will be used.
+        probs : List(float)
+            An array of probabilities in the range (0, 1) for which to compute quantile values.
+            If not specified, the *step* parameter will be used.
+        step : float
+            A probability step size (default 0.01) for sampling quantile values. All values from
+            one-half the step size up to 1 (exclusive) will be sampled. This parameter is only
+            used if the *probs* parameter is not provided. **Default value:** ``["prob", "value"]``
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        See Also
+        --------
+        alt.QuantileTransform : underlying transform object
+        """
+        return self._add_transform(
+            core.QuantileTransform(
+                quantile=quantile,
+                groupby=groupby,
+                probs=probs,
+                step=step,
+                **{"as": as_},
+            )
+        )
+
+    def transform_regression(
+        self,
+        on: Union[str, core.FieldName],
+        regression: Union[str, core.FieldName],
+        as_: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+        extent: Union[List[float], UndefinedType] = Undefined,
+        groupby: Union[List[Union[str, core.FieldName]], UndefinedType] = Undefined,
+        method: Union[
+            Literal["linear", "log", "exp", "pow", "quad", "poly"], UndefinedType
+        ] = Undefined,
+        order: Union[int, UndefinedType] = Undefined,
+        params: Union[bool, UndefinedType] = Undefined,
+    ) -> Self:
+        """Add a :class:`RegressionTransform` to the chart.
+
+        Parameters
+        ----------
+        on : str
+            The data field of the independent variable to use a predictor.
+        regression : str
+            The data field of the dependent variable to predict.
+        as_ : [str, str]
+            The output field names for the smoothed points generated by the regression
+            transform. **Default value:** The field names of the input x and y values.
+        extent : [float, float]
+            A [min, max] domain over the independent (x) field for the starting and ending
+            points of the generated trend line.
+        groupby : List(str)
+            The data fields to group by. If not specified, a single group containing all data
+            objects will be used.
+        method : enum('linear', 'log', 'exp', 'pow', 'quad', 'poly')
+            The functional form of the regression model. One of ``"linear"``, ``"log"``,
+            ``"exp"``, ``"pow"``, ``"quad"``, or ``"poly"``.  **Default value:** ``"linear"``
+        order : int
+            The polynomial order (number of coefficients) for the 'poly' method.
+            **Default value:** ``3``
+        params : boolean
+            A boolean flag indicating if the transform should return the regression model
+            parameters (one object per group), rather than trend line points.
+            The resulting objects include a ``coef`` array of fitted coefficient values
+            (starting with the intercept term and then including terms of increasing order)
+            and an ``rSquared`` value (indicating the total variance explained by the model).
+            **Default value:** ``false``
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        See Also
+        --------
+        Chart.transform_loess : LOESS transform
+        alt.RegressionTransform : underlying transform object
+        """
+        return self._add_transform(
+            core.RegressionTransform(
+                regression=regression,
+                on=on,
+                extent=extent,
+                groupby=groupby,
+                method=method,
+                order=order,
+                params=params,
+                **{"as": as_},
+            )
+        )
+
+    def transform_sample(self, sample: int = 1000) -> Self:
+        """
+        Add a :class:`SampleTransform` to the schema.
+
+        Parameters
+        ----------
+        sample : int
+            The maximum number of data objects to include in the sample. Default: 1000.
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        See Also
+        --------
+        alt.SampleTransform : underlying transform object
+        """
+        return self._add_transform(core.SampleTransform(sample))
+
+    def transform_stack(
+        self,
+        as_: Union[str, core.FieldName, List[str]],
+        stack: Union[str, core.FieldName],
+        groupby: List[Union[str, core.FieldName]],
+        offset: Union[
+            Literal["zero", "center", "normalize"], UndefinedType
+        ] = Undefined,
+        sort: Union[List[core.SortField], UndefinedType] = Undefined,
+    ) -> Self:
+        """
+        Add a :class:`StackTransform` to the schema.
+
+        Parameters
+        ----------
+        as_ : anyOf(string, List(string))
+            Output field names. This can be either a string or an array of strings with
+            two elements denoting the name for the fields for stack start and stack end
+            respectively.
+            If a single string(eg."val") is provided, the end field will be "val_end".
+        stack : string
+            The field which is stacked.
+        groupby : List(string)
+            The data fields to group by.
+        offset : enum('zero', 'center', 'normalize')
+            Mode for stacking marks. Default: 'zero'.
+        sort : List(:class:`SortField`)
+            Field that determines the order of leaves in the stacked charts.
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        See Also
+        --------
+        alt.StackTransform : underlying transform object
+        """
+        return self._add_transform(
+            core.StackTransform(
+                stack=stack, groupby=groupby, offset=offset, sort=sort, **{"as": as_}
+            )
+        )
+
+    def transform_timeunit(
+        self,
+        as_: Union[str, core.FieldName, UndefinedType] = Undefined,
+        field: Union[str, core.FieldName, UndefinedType] = Undefined,
+        timeUnit: Union[str, core.TimeUnit, UndefinedType] = Undefined,
+        **kwargs: str,
+    ) -> Self:
+        """
+        Add a :class:`TimeUnitTransform` to the schema.
+
+        Parameters
+        ----------
+        as_ : string
+            The output field to write the timeUnit value.
+        field : string
+            The data field to apply time unit.
+        timeUnit : str or :class:`TimeUnit`
+            The timeUnit.
+        **kwargs
+            transforms can also be passed by keyword argument; see Examples
+
+        Returns
+        -------
+        self : Chart object
+            returns chart to allow for chaining
+
+        Examples
+        --------
+        >>> import altair as alt
+        >>> from altair import datum, expr
+
+        >>> chart = alt.Chart().transform_timeunit(month='month(date)')
+        >>> chart.transform[0]
+        TimeUnitTransform({
+          as: 'month',
+          field: 'date',
+          timeUnit: 'month'
+        })
+
+        It's also possible to pass the ``TimeUnitTransform`` arguments directly;
+        this is most useful in cases where the desired field name is not a
+        valid python identifier:
+
+        >>> kwds = {'as': 'month', 'timeUnit': 'month', 'field': 'The Month'}
+        >>> chart = alt.Chart().transform_timeunit(**kwds)
+        >>> chart.transform[0]
+        TimeUnitTransform({
+          as: 'month',
+          field: 'The Month',
+          timeUnit: 'month'
+        })
+
+        As the first form is easier to write and understand, that is the
+        recommended method.
+
+        See Also
+        --------
+        alt.TimeUnitTransform : underlying transform object
+
+        """
+        if as_ is Undefined:
+            as_ = kwargs.pop("as", Undefined)
+        else:
+            if "as" in kwargs:
+                raise ValueError(
+                    "transform_timeunit: both 'as_' and 'as' passed as arguments."
+                )
+        if as_ is not Undefined:
+            dct = {"as": as_, "timeUnit": timeUnit, "field": field}
+            self = self._add_transform(core.TimeUnitTransform(**dct))  # type: ignore[arg-type]
+        for as_, shorthand in kwargs.items():
+            dct = utils.parse_shorthand(
+                shorthand,
+                parse_timeunits=True,
+                parse_aggregates=False,
+                parse_types=False,
+            )
+            dct.pop("type", None)
+            dct["as"] = as_
+            if "timeUnit" not in dct:
+                raise ValueError("'{}' must include a valid timeUnit".format(shorthand))
+            self = self._add_transform(core.TimeUnitTransform(**dct))  # type: ignore[arg-type]
+        return self
+
+    def transform_window(
+        self,
+        window: Union[List[core.WindowFieldDef], UndefinedType] = Undefined,
+        frame: Union[List[Optional[int]], UndefinedType] = Undefined,
+        groupby: Union[List[str], UndefinedType] = Undefined,
+        ignorePeers: Union[bool, UndefinedType] = Undefined,
+        sort: Union[
+            List[Union[core.SortField, TypingDict[str, str]]], UndefinedType
+        ] = Undefined,
+        **kwargs: str,
+    ) -> Self:
+        """Add a :class:`WindowTransform` to the schema
+
+        Parameters
+        ----------
+        window : List(:class:`WindowFieldDef`)
+            The definition of the fields in the window, and what calculations to use.
+        frame : List(anyOf(None, int))
+            A frame specification as a two-element array indicating how the sliding window
+            should proceed. The array entries should either be a number indicating the offset
+            from the current data object, or null to indicate unbounded rows preceding or
+            following the current data object. The default value is ``[null, 0]``, indicating
+            that the sliding window includes the current object and all preceding objects. The
+            value ``[-5, 5]`` indicates that the window should include five objects preceding
+            and five objects following the current object. Finally, ``[null, null]`` indicates
+            that the window frame should always include all data objects. The only operators
+            affected are the aggregation operations and the ``first_value``, ``last_value``, and
+            ``nth_value`` window operations. The other window operations are not affected by
+            this.
+
+            **Default value:** :  ``[null, 0]`` (includes the current object and all preceding
+            objects)
+        groupby : List(string)
+            The data fields for partitioning the data objects into separate windows. If
+            unspecified, all data points will be in a single group.
+        ignorePeers : boolean
+            Indicates if the sliding window frame should ignore peer values. (Peer values are
+            those considered identical by the sort criteria). The default is false, causing the
+            window frame to expand to include all peer values. If set to true, the window frame
+            will be defined by offset values only. This setting only affects those operations
+            that depend on the window frame, namely aggregation operations and the first_value,
+            last_value, and nth_value window operations.
+
+            **Default value:** ``false``
+        sort : List(:class:`SortField`)
+            A sort field definition for sorting data objects within a window. If two data
+            objects are considered equal by the comparator, they are considered “peer” values of
+            equal rank. If sort is not specified, the order is undefined: data objects are
+            processed in the order they are observed and none are considered peers (the
+            ignorePeers parameter is ignored and treated as if set to ``true`` ).
+        **kwargs
+            transforms can also be passed by keyword argument; see Examples
+
+        Examples
+        --------
+        A cumulative line chart
+
+        >>> import altair as alt
+        >>> import numpy as np
+        >>> import pandas as pd
+        >>> data = pd.DataFrame({'x': np.arange(100),
+        ...                      'y': np.random.randn(100)})
+        >>> chart = alt.Chart(data).mark_line().encode(
+        ...     x='x:Q',
+        ...     y='ycuml:Q'
+        ... ).transform_window(
+        ...     ycuml='sum(y)'
+        ... )
+        >>> chart.transform[0]
+        WindowTransform({
+          window: [WindowFieldDef({
+            as: 'ycuml',
+            field: 'y',
+            op: 'sum'
+          })]
+        })
+
+        """
+        if kwargs:
+            if window is Undefined:
+                window = []
+            for as_, shorthand in kwargs.items():
+                kwds = {"as": as_}
+                kwds.update(
+                    utils.parse_shorthand(
+                        shorthand,
+                        parse_aggregates=False,
+                        parse_window_ops=True,
+                        parse_timeunits=False,
+                        parse_types=False,
+                    )
+                )
+                assert not isinstance(window, UndefinedType)  # For mypy
+                # Ignore as core.WindowFieldDef has a Literal type hint with all options
+                window.append(core.WindowFieldDef(**kwds))  # type: ignore[arg-type]
+
+        return self._add_transform(
+            core.WindowTransform(
+                window=window,
+                frame=frame,
+                groupby=groupby,
+                ignorePeers=ignorePeers,
+                sort=sort,
+            )
+        )
+
+    # Display-related methods
+
+    def _repr_mimebundle_(self, include=None, exclude=None):
+        """Return a MIME bundle for display in Jupyter frontends."""
+        # Catch errors explicitly to get around issues in Jupyter frontend
+        # see https://github.com/ipython/ipython/issues/11038
+        try:
+            dct = self.to_dict(context={"pre_transform": False})
+        except Exception:
+            utils.display_traceback(in_ipython=True)
+            return {}
+        else:
+            return renderers.get()(dct)
+
+    def display(
+        self,
+        renderer: Union[Literal["canvas", "svg"], UndefinedType] = Undefined,
+        theme: Union[str, UndefinedType] = Undefined,
+        actions: Union[bool, dict, UndefinedType] = Undefined,
+        **kwargs,
+    ) -> None:
+        """Display chart in Jupyter notebook or JupyterLab
+
+        Parameters are passed as options to vega-embed within supported frontends.
+        See https://github.com/vega/vega-embed#options for details.
+
+        Parameters
+        ----------
+        renderer : string ('canvas' or 'svg')
+            The renderer to use
+        theme : string
+            The Vega theme name to use; see https://github.com/vega/vega-themes
+        actions : bool or dict
+            Specify whether action links ("Open In Vega Editor", etc.) are
+            included in the view.
+        **kwargs :
+            Additional parameters are also passed to vega-embed as options.
+
+        """
+        from IPython.display import display
+
+        if renderer is not Undefined:
+            kwargs["renderer"] = renderer
+        if theme is not Undefined:
+            kwargs["theme"] = theme
+        if actions is not Undefined:
+            kwargs["actions"] = actions
+
+        if kwargs:
+            options = renderers.options.copy()
+            options["embed_options"] = options.get("embed_options", {}).copy()
+            options["embed_options"].update(kwargs)
+            with renderers.enable(**options):
+                display(self)
+        else:
+            display(self)
+
+    @utils.deprecation.deprecated(message="'serve' is deprecated. Use 'show' instead.")
+    def serve(
+        self,
+        ip="127.0.0.1",
+        port=8888,
+        n_retries=50,
+        files=None,
+        jupyter_warning=True,
+        open_browser=True,
+        http_server=None,
+        **kwargs,
+    ):
+        """
+        'serve' is deprecated. Use 'show' instead.
+
+        Open a browser window and display a rendering of the chart
+
+        Parameters
+        ----------
+        html : string
+            HTML to serve
+        ip : string (default = '127.0.0.1')
+            ip address at which the HTML will be served.
+        port : int (default = 8888)
+            the port at which to serve the HTML
+        n_retries : int (default = 50)
+            the number of nearby ports to search if the specified port
+            is already in use.
+        files : dictionary (optional)
+            dictionary of extra content to serve
+        jupyter_warning : bool (optional)
+            if True (default), then print a warning if this is used
+            within the Jupyter notebook
+        open_browser : bool (optional)
+            if True (default), then open a web browser to the given HTML
+        http_server : class (optional)
+            optionally specify an HTTPServer class to use for showing the
+            figure. The default is Python's basic HTTPServer.
+        **kwargs :
+            additional keyword arguments passed to the save() method
+
+        """
+        from ...utils.server import serve
+
+        html = io.StringIO()
+        self.save(html, format="html", **kwargs)
+        html.seek(0)
+
+        serve(
+            html.read(),
+            ip=ip,
+            port=port,
+            n_retries=n_retries,
+            files=files,
+            jupyter_warning=jupyter_warning,
+            open_browser=open_browser,
+            http_server=http_server,
+        )
+
+    def show(self) -> None:
+        """Display the chart using the active renderer"""
+        if renderers.active == "browser":
+            # Opens browser window as side-effect.
+            # We use a special case here so that IPython is not required
+            self._repr_mimebundle_()
+        else:
+            # Mime-bundle based renderer, requires running in an IPython session
+            from IPython.display import display
+
+            display(self)
+
+    @utils.use_signature(core.Resolve)
+    def _set_resolve(self, **kwargs):
+        """Copy the chart and update the resolve property with kwargs"""
+        if not hasattr(self, "resolve"):
+            raise ValueError(
+                "{} object has no attribute " "'resolve'".format(self.__class__)
+            )
+        copy = self.copy(deep=["resolve"])
+        if copy.resolve is Undefined:
+            copy.resolve = core.Resolve()
+        for key, val in kwargs.items():
+            copy.resolve[key] = val
+        return copy
+
+    @utils.use_signature(core.AxisResolveMap)
+    def resolve_axis(self, *args, **kwargs) -> Self:
+        return self._set_resolve(axis=core.AxisResolveMap(*args, **kwargs))
+
+    @utils.use_signature(core.LegendResolveMap)
+    def resolve_legend(self, *args, **kwargs) -> Self:
+        return self._set_resolve(legend=core.LegendResolveMap(*args, **kwargs))
+
+    @utils.use_signature(core.ScaleResolveMap)
+    def resolve_scale(self, *args, **kwargs) -> Self:
+        return self._set_resolve(scale=core.ScaleResolveMap(*args, **kwargs))
+
+
+class _EncodingMixin:
+    @utils.use_signature(channels._encode_signature)
+    def encode(self, *args, **kwargs) -> Self:
+        # Convert args to kwargs based on their types.
+        kwargs = utils.infer_encoding_types(args, kwargs, channels)
+
+        # get a copy of the dict representation of the previous encoding
+        # ignore type as copy method comes from SchemaBase
+        copy = self.copy(deep=["encoding"])  # type: ignore[attr-defined]
+        encoding = copy._get("encoding", {})
+        if isinstance(encoding, core.VegaLiteSchema):
+            encoding = {k: v for k, v in encoding._kwds.items() if v is not Undefined}
+
+        # update with the new encodings, and apply them to the copy
+        encoding.update(kwargs)
+        copy.encoding = core.FacetedEncoding(**encoding)
+        return copy
+
+    def facet(
+        self,
+        facet: Union[str, channels.Facet, UndefinedType] = Undefined,
+        row: Union[str, core.FacetFieldDef, channels.Row, UndefinedType] = Undefined,
+        column: Union[
+            str, core.FacetFieldDef, channels.Column, UndefinedType
+        ] = Undefined,
+        data: Union[ChartDataType, UndefinedType] = Undefined,
+        columns: Union[int, UndefinedType] = Undefined,
+        **kwargs,
+    ) -> "FacetChart":
+        """Create a facet chart from the current chart.
+
+        Faceted charts require data to be specified at the top level; if data
+        is not specified, the data from the current chart will be used at the
+        top level.
+
+        Parameters
+        ----------
+        facet : string, Facet (optional)
+            The data column to use as an encoding for a wrapped facet.
+            If specified, then neither row nor column may be specified.
+        column : string, Column, FacetFieldDef (optional)
+            The data column to use as an encoding for a column facet.
+            May be combined with row argument, but not with facet argument.
+        row : string or Row, FacetFieldDef (optional)
+            The data column to use as an encoding for a row facet.
+            May be combined with column argument, but not with facet argument.
+        data : string or dataframe (optional)
+            The dataset to use for faceting. If not supplied, then data must
+            be specified in the top-level chart that calls this method.
+        columns : integer
+            the maximum number of columns for a wrapped facet.
+
+        Returns
+        -------
+        self :
+            for chaining
+        """
+        facet_specified = facet is not Undefined
+        rowcol_specified = row is not Undefined or column is not Undefined
+
+        if facet_specified and rowcol_specified:
+            raise ValueError(
+                "facet argument cannot be combined with row/column argument."
+            )
+
+        if data is Undefined:
+            if self.data is Undefined:  # type: ignore[has-type]
+                raise ValueError(
+                    "Facet charts require data to be specified at the top level. "
+                    "If you are trying to facet layered or concatenated charts, "
+                    "ensure that the same data variable is passed to each chart "
+                    "or specify the data inside the facet method instead."
+                )
+            # ignore type as copy comes from another class
+            self = self.copy(deep=False)  # type: ignore[attr-defined]
+            data, self.data = self.data, Undefined  # type: ignore[has-type]
+
+        if facet_specified:
+            if isinstance(facet, str):
+                facet = channels.Facet(facet)
+        else:
+            facet = FacetMapping(row=row, column=column)
+
+        return FacetChart(spec=self, facet=facet, data=data, columns=columns, **kwargs)
+
+
+class Chart(
+    TopLevelMixin, _EncodingMixin, mixins.MarkMethodMixin, core.TopLevelUnitSpec
+):
+    """Create a basic Altair/Vega-Lite chart.
+
+    Although it is possible to set all Chart properties as constructor attributes,
+    it is more idiomatic to use methods such as ``mark_point()``, ``encode()``,
+    ``transform_filter()``, ``properties()``, etc. See Altair's documentation
+    for details and examples: http://altair-viz.github.io/.
+
+    Parameters
+    ----------
+    data : Data
+        An object describing the data source
+    mark : AnyMark
+        A `MarkDef` or `CompositeMarkDef` object, or a string describing the mark type
+        (one of `"arc"`, `"area"`, `"bar"`, `"circle"`, `"geoshape"`, `"image"`,
+        `"line"`, `"point"`, `"rule"`, `"rect"`, `"square"`, `"text"`, `"tick"`,
+        `"trail"`, `"boxplot"`, `"errorband"`, and `"errorbar"`).
+    encoding : FacetedEncoding
+        A key-value mapping between encoding channels and definition of fields.
+    autosize : anyOf(AutosizeType, AutoSizeParams)
+        Sets how the visualization size should be determined. If a string, should be one of
+        `"pad"`, `"fit"` or `"none"`. Object values can additionally specify parameters for
+        content sizing and automatic resizing. `"fit"` is only supported for single and
+        layered views that don't use `rangeStep`.  Default value: `pad`
+    background : string
+        CSS color property to use as the background of visualization.
+
+        **Default value:** none (transparent)
+    config : Config
+        Vega-Lite configuration object.  This property can only be defined at the top-level
+        of a specification.
+    description : string
+        Description of this mark for commenting purpose.
+    height : float
+        The height of a visualization.
+    name : string
+        Name of the visualization for later reference.
+    padding : Padding
+        The default visualization padding, in pixels, from the edge of the visualization
+        canvas to the data rectangle.  If a number, specifies padding for all sides. If an
+        object, the value should have the format `{"left": 5, "top": 5, "right": 5,
+        "bottom": 5}` to specify padding for each side of the visualization.  Default
+        value: `5`
+    projection : Projection
+        An object defining properties of geographic projection.  Works with `"geoshape"`
+        marks and `"point"` or `"line"` marks that have a channel (one or more of `"X"`,
+        `"X2"`, `"Y"`, `"Y2"`) with type `"latitude"`, or `"longitude"`.
+    selection : Mapping(required=[])
+        A key-value mapping between selection names and definitions.
+    title : anyOf(string, TitleParams)
+        Title for the plot.
+    transform : List(Transform)
+        An array of data transformations such as filter and new field calculation.
+    width : float
+        The width of a visualization.
+    """
+
+    def __init__(
+        self,
+        data: Union[ChartDataType, UndefinedType] = Undefined,
+        encoding: Union[core.FacetedEncoding, UndefinedType] = Undefined,
+        mark: Union[str, core.AnyMark, UndefinedType] = Undefined,
+        width: Union[int, str, dict, core.Step, UndefinedType] = Undefined,
+        height: Union[int, str, dict, core.Step, UndefinedType] = Undefined,
+        **kwargs,
+    ) -> None:
+        super(Chart, self).__init__(
+            # Data type hints won't match with what TopLevelUnitSpec expects
+            # as there is some data processing happening when converting to
+            # a VL spec
+            data=data,  # type: ignore[arg-type]
+            encoding=encoding,
+            mark=mark,
+            width=width,
+            height=height,
+            **kwargs,
+        )
+
+    _counter: int = 0
+
+    @classmethod
+    def _get_name(cls) -> str:
+        cls._counter += 1
+        return f"view_{cls._counter}"
+
+    @classmethod
+    def from_dict(cls, dct: dict, validate: bool = True) -> core.SchemaBase:  # type: ignore[override]  # Not the same signature as SchemaBase.from_dict. Would ideally be aligned in the future
+        """Construct class from a dictionary representation
+
+        Parameters
+        ----------
+        dct : dictionary
+            The dict from which to construct the class
+        validate : boolean
+            If True (default), then validate the input against the schema.
+
+        Returns
+        -------
+        obj : Chart object
+            The wrapped schema
+
+        Raises
+        ------
+        jsonschema.ValidationError :
+            if validate=True and dct does not conform to the schema
+        """
+        for class_ in TopLevelMixin.__subclasses__():
+            if class_ is Chart:
+                class_ = cast(TypingType[TopLevelMixin], super(Chart, cls))
+            try:
+                # TopLevelMixin classes don't necessarily have from_dict defined
+                # but all classes which are used here have due to how Altair is
+                # designed. Too complex to type check right now.
+                return class_.from_dict(dct, validate=validate)  # type: ignore[attr-defined]
+            except jsonschema.ValidationError:
+                pass
+
+        # As a last resort, try using the Root vegalite object
+        return core.Root.from_dict(dct, validate)
+
+    def to_dict(
+        self,
+        validate: bool = True,
+        *,
+        format: str = "vega-lite",
+        ignore: Optional[List[str]] = None,
+        context: Optional[TypingDict[str, Any]] = None,
+    ) -> dict:
+        """Convert the chart to a dictionary suitable for JSON export
+
+        Parameters
+        ----------
+        validate : bool, optional
+            If True (default), then validate the output dictionary
+            against the schema.
+        format : str, optional
+            Chart specification format, one of "vega-lite" (default) or "vega"
+        ignore : list[str], optional
+            A list of keys to ignore. It is usually not needed
+            to specify this argument as a user.
+        context : dict[str, Any], optional
+            A context dictionary. It is usually not needed
+            to specify this argument as a user.
+
+        Notes
+        -----
+        Technical: The ignore parameter will *not* be passed to child to_dict
+        function calls.
+
+        Returns
+        -------
+        dict
+            The dictionary representation of this chart
+
+        Raises
+        ------
+        SchemaValidationError
+            if validate=True and the dict does not conform to the schema
+        """
+        context = context or {}
+        if self.data is Undefined and "data" not in context:
+            # No data specified here or in parent: inject empty data
+            # for easier specification of datum encodings.
+            copy = self.copy(deep=False)
+            copy.data = core.InlineData(values=[{}])  # type: ignore[assignment]
+            return super(Chart, copy).to_dict(
+                validate=validate, format=format, ignore=ignore, context=context
+            )
+        return super().to_dict(
+            validate=validate, format=format, ignore=ignore, context=context
+        )
+
+    def transformed_data(
+        self,
+        row_limit: Optional[int] = None,
+        exclude: Optional[Iterable[str]] = None,
+    ) -> Optional[DataFrameLike]:
+        """Evaluate a Chart's transforms
+
+        Evaluate the data transforms associated with a Chart and return the
+        transformed data a DataFrame
+
+        Parameters
+        ----------
+        row_limit : int (optional)
+            Maximum number of rows to return for each DataFrame. None (default) for unlimited
+        exclude : iterable of str
+            Set of the names of charts to exclude
+
+        Returns
+        -------
+        DataFrame
+            Transformed data as a DataFrame
+        """
+        from altair.utils._transformed_data import transformed_data
+
+        return transformed_data(self, row_limit=row_limit, exclude=exclude)
+
+    def add_params(self, *params: Parameter) -> Self:
+        """Add one or more parameters to the chart."""
+        if not params:
+            return self
+        copy = self.copy(deep=["params"])
+        if copy.params is Undefined:
+            copy.params = []
+
+        for s in params:
+            copy.params.append(s.param)
+        return copy
+
+    @utils.deprecation.deprecated(
+        message="'add_selection' is deprecated. Use 'add_params' instead."
+    )
+    def add_selection(self, *params) -> Self:
+        """'add_selection' is deprecated. Use 'add_params' instead."""
+        return self.add_params(*params)
+
+    def interactive(
+        self, name: Optional[str] = None, bind_x: bool = True, bind_y: bool = True
+    ) -> Self:
+        """Make chart axes scales interactive
+
+        Parameters
+        ----------
+        name : string
+            The parameter name to use for the axes scales. This name should be
+            unique among all parameters within the chart.
+        bind_x : boolean, default True
+            If true, then bind the interactive scales to the x-axis
+        bind_y : boolean, default True
+            If true, then bind the interactive scales to the y-axis
+
+        Returns
+        -------
+        chart :
+            copy of self, with interactive axes added
+
+        """
+        encodings = []
+        if bind_x:
+            encodings.append("x")
+        if bind_y:
+            encodings.append("y")
+        return self.add_params(selection_interval(bind="scales", encodings=encodings))
+
+
+def _check_if_valid_subspec(spec: Union[dict, core.SchemaBase], classname: str) -> None:
+    """Check if the spec is a valid sub-spec.
+
+    If it is not, then raise a ValueError
+    """
+    err = (
+        'Objects with "{0}" attribute cannot be used within {1}. '
+        "Consider defining the {0} attribute in the {1} object instead."
+    )
+
+    if not isinstance(spec, (core.SchemaBase, dict)):
+        raise ValueError("Only chart objects can be used in {0}.".format(classname))
+    for attr in TOPLEVEL_ONLY_KEYS:
+        if isinstance(spec, core.SchemaBase):
+            val = getattr(spec, attr, Undefined)
+        else:
+            val = spec.get(attr, Undefined)
+        if val is not Undefined:
+            raise ValueError(err.format(attr, classname))
+
+
+def _check_if_can_be_layered(spec: Union[dict, core.SchemaBase]) -> None:
+    """Check if the spec can be layered."""
+
+    def _get(spec, attr):
+        if isinstance(spec, core.SchemaBase):
+            return spec._get(attr)
+        else:
+            return spec.get(attr, Undefined)
+
+    encoding = _get(spec, "encoding")
+    if encoding is not Undefined:
+        for channel in ["row", "column", "facet"]:
+            if _get(encoding, channel) is not Undefined:
+                raise ValueError(
+                    "Faceted charts cannot be layered. Instead, layer the charts before faceting."
+                )
+    if isinstance(spec, (Chart, LayerChart)):
+        return
+
+    if not isinstance(spec, (core.SchemaBase, dict)):
+        raise ValueError("Only chart objects can be layered.")
+    if _get(spec, "facet") is not Undefined:
+        raise ValueError(
+            "Faceted charts cannot be layered. Instead, layer the charts before faceting."
+        )
+    if isinstance(spec, FacetChart) or _get(spec, "facet") is not Undefined:
+        raise ValueError(
+            "Faceted charts cannot be layered. Instead, layer the charts before faceting."
+        )
+    if isinstance(spec, RepeatChart) or _get(spec, "repeat") is not Undefined:
+        raise ValueError(
+            "Repeat charts cannot be layered. Instead, layer the charts before repeating."
+        )
+    if isinstance(spec, ConcatChart) or _get(spec, "concat") is not Undefined:
+        raise ValueError(
+            "Concatenated charts cannot be layered. Instead, layer the charts before concatenating."
+        )
+    if isinstance(spec, HConcatChart) or _get(spec, "hconcat") is not Undefined:
+        raise ValueError(
+            "Concatenated charts cannot be layered. Instead, layer the charts before concatenating."
+        )
+    if isinstance(spec, VConcatChart) or _get(spec, "vconcat") is not Undefined:
+        raise ValueError(
+            "Concatenated charts cannot be layered. Instead, layer the charts before concatenating."
+        )
+
+
+class RepeatChart(TopLevelMixin, core.TopLevelRepeatSpec):
+    """A chart repeated across rows and columns with small changes"""
+
+    # Because TopLevelRepeatSpec is defined as a union as of Vega-Lite schema 4.9,
+    # we set the arguments explicitly here.
+    # TODO: Should we instead use tools/schemapi/codegen.get_args?
+    @utils.use_signature(core.TopLevelRepeatSpec)
+    def __init__(
+        self,
+        repeat=Undefined,
+        spec=Undefined,
+        align=Undefined,
+        autosize=Undefined,
+        background=Undefined,
+        bounds=Undefined,
+        center=Undefined,
+        columns=Undefined,
+        config=Undefined,
+        data=Undefined,
+        datasets=Undefined,
+        description=Undefined,
+        name=Undefined,
+        padding=Undefined,
+        params=Undefined,
+        resolve=Undefined,
+        spacing=Undefined,
+        title=Undefined,
+        transform=Undefined,
+        usermeta=Undefined,
+        **kwds,
+    ):
+        _check_if_valid_subspec(spec, "RepeatChart")
+        _spec_as_list = [spec]
+        params, _spec_as_list = _combine_subchart_params(params, _spec_as_list)
+        spec = _spec_as_list[0]
+        if isinstance(spec, (Chart, LayerChart)):
+            params = _repeat_names(params, repeat, spec)
+        super(RepeatChart, self).__init__(
+            repeat=repeat,
+            spec=spec,
+            align=align,
+            autosize=autosize,
+            background=background,
+            bounds=bounds,
+            center=center,
+            columns=columns,
+            config=config,
+            data=data,
+            datasets=datasets,
+            description=description,
+            name=name,
+            padding=padding,
+            params=params,
+            resolve=resolve,
+            spacing=spacing,
+            title=title,
+            transform=transform,
+            usermeta=usermeta,
+            **kwds,
+        )
+
+    def transformed_data(
+        self,
+        row_limit: Optional[int] = None,
+        exclude: Optional[Iterable[str]] = None,
+    ) -> Optional[DataFrameLike]:
+        """Evaluate a RepeatChart's transforms
+
+        Evaluate the data transforms associated with a RepeatChart and return the
+        transformed data a DataFrame
+
+        Parameters
+        ----------
+        row_limit : int (optional)
+            Maximum number of rows to return for each DataFrame. None (default) for unlimited
+        exclude : iterable of str
+            Set of the names of charts to exclude
+
+        Raises
+        ------
+        NotImplementedError
+            RepeatChart does not yet support transformed_data
+        """
+        raise NotImplementedError(
+            "transformed_data is not yet implemented for RepeatChart"
+        )
+
+    def interactive(
+        self, name: Optional[str] = None, bind_x: bool = True, bind_y: bool = True
+    ) -> Self:
+        """Make chart axes scales interactive
+
+        Parameters
+        ----------
+        name : string
+            The parameter name to use for the axes scales. This name should be
+            unique among all parameters within the chart.
+        bind_x : boolean, default True
+            If true, then bind the interactive scales to the x-axis
+        bind_y : boolean, default True
+            If true, then bind the interactive scales to the y-axis
+
+        Returns
+        -------
+        chart :
+            copy of self, with interactive axes added
+
+        """
+        copy = self.copy(deep=False)
+        copy.spec = copy.spec.interactive(name=name, bind_x=bind_x, bind_y=bind_y)
+        return copy
+
+    def add_params(self, *params: Parameter) -> Self:
+        """Add one or more parameters to the chart."""
+        if not params or self.spec is Undefined:
+            return self
+        copy = self.copy()
+        copy.spec = copy.spec.add_params(*params)
+        return copy.copy()
+
+    @utils.deprecation.deprecated(
+        message="'add_selection' is deprecated. Use 'add_params' instead."
+    )
+    def add_selection(self, *selections) -> Self:
+        """'add_selection' is deprecated. Use 'add_params' instead."""
+        return self.add_params(*selections)
+
+
+def repeat(
+    repeater: Literal["row", "column", "repeat", "layer"] = "repeat",
+) -> core.RepeatRef:
+    """Tie a channel to the row or column within a repeated chart
+
+    The output of this should be passed to the ``field`` attribute of
+    a channel.
+
+    Parameters
+    ----------
+    repeater : {'row'|'column'|'repeat'|'layer'}
+        The repeater to tie the field to. Default is 'repeat'.
+
+    Returns
+    -------
+    repeat : RepeatRef object
+    """
+    if repeater not in ["row", "column", "repeat", "layer"]:
+        raise ValueError("repeater must be one of ['row', 'column', 'repeat', 'layer']")
+    return core.RepeatRef(repeat=repeater)
+
+
+class ConcatChart(TopLevelMixin, core.TopLevelConcatSpec):
+    """A chart with horizontally-concatenated facets"""
+
+    @utils.use_signature(core.TopLevelConcatSpec)
+    def __init__(self, data=Undefined, concat=(), columns=Undefined, **kwargs):
+        # TODO: move common data to top level?
+        for spec in concat:
+            _check_if_valid_subspec(spec, "ConcatChart")
+        super(ConcatChart, self).__init__(
+            data=data, concat=list(concat), columns=columns, **kwargs
+        )
+        self.data, self.concat = _combine_subchart_data(self.data, self.concat)
+        self.params, self.concat = _combine_subchart_params(self.params, self.concat)
+
+    # Too difficult to fix override error
+    def __ior__(self, other: core.NonNormalizedSpec) -> Self:  # type: ignore[override]
+        _check_if_valid_subspec(other, "ConcatChart")
+        self.concat.append(other)
+        self.data, self.concat = _combine_subchart_data(self.data, self.concat)
+        self.params, self.concat = _combine_subchart_params(self.params, self.concat)
+        return self
+
+    # Too difficult to fix override error
+    def __or__(self, other: core.NonNormalizedSpec) -> Self:  # type: ignore[override]
+        copy = self.copy(deep=["concat"])
+        copy |= other
+        return copy
+
+    def transformed_data(
+        self,
+        row_limit: Optional[int] = None,
+        exclude: Optional[Iterable[str]] = None,
+    ) -> List[DataFrameLike]:
+        """Evaluate a ConcatChart's transforms
+
+        Evaluate the data transforms associated with a ConcatChart and return the
+        transformed data for each subplot as a list of DataFrames
+
+        Parameters
+        ----------
+        row_limit : int (optional)
+            Maximum number of rows to return for each DataFrame. None (default) for unlimited
+        exclude : iterable of str
+            Set of the names of charts to exclude
+
+        Returns
+        -------
+        list of DataFrame
+            Transformed data for each subplot as a list of DataFrames
+        """
+        from altair.utils._transformed_data import transformed_data
+
+        return transformed_data(self, row_limit=row_limit, exclude=exclude)
+
+    def interactive(
+        self, name: Optional[str] = None, bind_x: bool = True, bind_y: bool = True
+    ) -> Self:
+        """Make chart axes scales interactive
+
+        Parameters
+        ----------
+        name : string
+            The parameter name to use for the axes scales. This name should be
+            unique among all parameters within the chart.
+        bind_x : boolean, default True
+            If true, then bind the interactive scales to the x-axis
+        bind_y : boolean, default True
+            If true, then bind the interactive scales to the y-axis
+
+        Returns
+        -------
+        chart :
+            copy of self, with interactive axes added
+
+        """
+        encodings = []
+        if bind_x:
+            encodings.append("x")
+        if bind_y:
+            encodings.append("y")
+        return self.add_params(selection_interval(bind="scales", encodings=encodings))
+
+    def add_params(self, *params: Parameter) -> Self:
+        """Add one or more parameters to the chart."""
+        if not params or not self.concat:
+            return self
+        copy = self.copy()
+        copy.concat = [chart.add_params(*params) for chart in copy.concat]
+        return copy
+
+    @utils.deprecation.deprecated(
+        message="'add_selection' is deprecated. Use 'add_params' instead."
+    )
+    def add_selection(self, *selections) -> Self:
+        """'add_selection' is deprecated. Use 'add_params' instead."""
+        return self.add_params(*selections)
+
+
+def concat(*charts, **kwargs) -> ConcatChart:
+    """Concatenate charts horizontally"""
+    return ConcatChart(concat=charts, **kwargs)
+
+
+class HConcatChart(TopLevelMixin, core.TopLevelHConcatSpec):
+    """A chart with horizontally-concatenated facets"""
+
+    @utils.use_signature(core.TopLevelHConcatSpec)
+    def __init__(self, data=Undefined, hconcat=(), **kwargs):
+        # TODO: move common data to top level?
+        for spec in hconcat:
+            _check_if_valid_subspec(spec, "HConcatChart")
+        super(HConcatChart, self).__init__(data=data, hconcat=list(hconcat), **kwargs)
+        self.data, self.hconcat = _combine_subchart_data(self.data, self.hconcat)
+        self.params, self.hconcat = _combine_subchart_params(self.params, self.hconcat)
+
+    def __ior__(self, other: core.NonNormalizedSpec) -> Self:
+        _check_if_valid_subspec(other, "HConcatChart")
+        self.hconcat.append(other)
+        self.data, self.hconcat = _combine_subchart_data(self.data, self.hconcat)
+        self.params, self.hconcat = _combine_subchart_params(self.params, self.hconcat)
+        return self
+
+    def __or__(self, other: core.NonNormalizedSpec) -> Self:
+        copy = self.copy(deep=["hconcat"])
+        copy |= other
+        return copy
+
+    def transformed_data(
+        self,
+        row_limit: Optional[int] = None,
+        exclude: Optional[Iterable[str]] = None,
+    ) -> List[DataFrameLike]:
+        """Evaluate a HConcatChart's transforms
+
+        Evaluate the data transforms associated with a HConcatChart and return the
+        transformed data for each subplot as a list of DataFrames
+
+        Parameters
+        ----------
+        row_limit : int (optional)
+            Maximum number of rows to return for each DataFrame. None (default) for unlimited
+        exclude : iterable of str
+            Set of the names of charts to exclude
+
+        Returns
+        -------
+        list of DataFrame
+            Transformed data for each subplot as a list of DataFrames
+        """
+        from altair.utils._transformed_data import transformed_data
+
+        return transformed_data(self, row_limit=row_limit, exclude=exclude)
+
+    def interactive(
+        self, name: Optional[str] = None, bind_x: bool = True, bind_y: bool = True
+    ) -> Self:
+        """Make chart axes scales interactive
+
+        Parameters
+        ----------
+        name : string
+            The parameter name to use for the axes scales. This name should be
+            unique among all parameters within the chart.
+        bind_x : boolean, default True
+            If true, then bind the interactive scales to the x-axis
+        bind_y : boolean, default True
+            If true, then bind the interactive scales to the y-axis
+
+        Returns
+        -------
+        chart :
+            copy of self, with interactive axes added
+
+        """
+        encodings = []
+        if bind_x:
+            encodings.append("x")
+        if bind_y:
+            encodings.append("y")
+        return self.add_params(selection_interval(bind="scales", encodings=encodings))
+
+    def add_params(self, *params: Parameter) -> Self:
+        """Add one or more parameters to the chart."""
+        if not params or not self.hconcat:
+            return self
+        copy = self.copy()
+        copy.hconcat = [chart.add_params(*params) for chart in copy.hconcat]
+        return copy
+
+    @utils.deprecation.deprecated(
+        message="'add_selection' is deprecated. Use 'add_params' instead."
+    )
+    def add_selection(self, *selections) -> Self:
+        """'add_selection' is deprecated. Use 'add_params' instead."""
+        return self.add_params(*selections)
+
+
+def hconcat(*charts, **kwargs) -> HConcatChart:
+    """Concatenate charts horizontally"""
+    return HConcatChart(hconcat=charts, **kwargs)
+
+
+class VConcatChart(TopLevelMixin, core.TopLevelVConcatSpec):
+    """A chart with vertically-concatenated facets"""
+
+    @utils.use_signature(core.TopLevelVConcatSpec)
+    def __init__(self, data=Undefined, vconcat=(), **kwargs):
+        # TODO: move common data to top level?
+        for spec in vconcat:
+            _check_if_valid_subspec(spec, "VConcatChart")
+        super(VConcatChart, self).__init__(data=data, vconcat=list(vconcat), **kwargs)
+        self.data, self.vconcat = _combine_subchart_data(self.data, self.vconcat)
+        self.params, self.vconcat = _combine_subchart_params(self.params, self.vconcat)
+
+    def __iand__(self, other: core.NonNormalizedSpec) -> Self:
+        _check_if_valid_subspec(other, "VConcatChart")
+        self.vconcat.append(other)
+        self.data, self.vconcat = _combine_subchart_data(self.data, self.vconcat)
+        self.params, self.vconcat = _combine_subchart_params(self.params, self.vconcat)
+        return self
+
+    def __and__(self, other: core.NonNormalizedSpec) -> Self:
+        copy = self.copy(deep=["vconcat"])
+        copy &= other
+        return copy
+
+    def transformed_data(
+        self,
+        row_limit: Optional[int] = None,
+        exclude: Optional[Iterable[str]] = None,
+    ) -> List[DataFrameLike]:
+        """Evaluate a VConcatChart's transforms
+
+        Evaluate the data transforms associated with a VConcatChart and return the
+        transformed data for each subplot as a list of DataFrames
+
+        Parameters
+        ----------
+        row_limit : int (optional)
+            Maximum number of rows to return for each DataFrame. None (default) for unlimited
+        exclude : iterable of str
+            Set of the names of charts to exclude
+
+        Returns
+        -------
+        list of DataFrame
+            Transformed data for each subplot as a list of DataFrames
+        """
+        from altair.utils._transformed_data import transformed_data
+
+        return transformed_data(self, row_limit=row_limit, exclude=exclude)
+
+    def interactive(
+        self, name: Optional[str] = None, bind_x: bool = True, bind_y: bool = True
+    ) -> Self:
+        """Make chart axes scales interactive
+
+        Parameters
+        ----------
+        name : string
+            The parameter name to use for the axes scales. This name should be
+            unique among all parameters within the chart.
+        bind_x : boolean, default True
+            If true, then bind the interactive scales to the x-axis
+        bind_y : boolean, default True
+            If true, then bind the interactive scales to the y-axis
+
+        Returns
+        -------
+        chart :
+            copy of self, with interactive axes added
+
+        """
+        encodings = []
+        if bind_x:
+            encodings.append("x")
+        if bind_y:
+            encodings.append("y")
+        return self.add_params(selection_interval(bind="scales", encodings=encodings))
+
+    def add_params(self, *params: Parameter) -> Self:
+        """Add one or more parameters to the chart."""
+        if not params or not self.vconcat:
+            return self
+        copy = self.copy()
+        copy.vconcat = [chart.add_params(*params) for chart in copy.vconcat]
+        return copy
+
+    @utils.deprecation.deprecated(
+        message="'add_selection' is deprecated. Use 'add_params' instead."
+    )
+    def add_selection(self, *selections) -> Self:
+        """'add_selection' is deprecated. Use 'add_params' instead."""
+        return self.add_params(*selections)
+
+
+def vconcat(*charts, **kwargs) -> VConcatChart:
+    """Concatenate charts vertically"""
+    return VConcatChart(vconcat=charts, **kwargs)
+
+
+class LayerChart(TopLevelMixin, _EncodingMixin, core.TopLevelLayerSpec):
+    """A Chart with layers within a single panel"""
+
+    @utils.use_signature(core.TopLevelLayerSpec)
+    def __init__(self, data=Undefined, layer=(), **kwargs):
+        # TODO: move common data to top level?
+        # TODO: check for conflicting interaction
+        for spec in layer:
+            _check_if_valid_subspec(spec, "LayerChart")
+            _check_if_can_be_layered(spec)
+        super(LayerChart, self).__init__(data=data, layer=list(layer), **kwargs)
+        self.data, self.layer = _combine_subchart_data(self.data, self.layer)
+        # Currently (Vega-Lite 5.5) the same param can't occur on two layers
+        self.layer = _remove_duplicate_params(self.layer)
+        self.params, self.layer = _combine_subchart_params(self.params, self.layer)
+
+        # Some properties are not allowed within layer; we'll move to parent.
+        layer_props = ("height", "width", "view")
+        combined_dict, self.layer = _remove_layer_props(self, self.layer, layer_props)
+
+        for prop in combined_dict:
+            self[prop] = combined_dict[prop]
+
+    def transformed_data(
+        self,
+        row_limit: Optional[int] = None,
+        exclude: Optional[Iterable[str]] = None,
+    ) -> List[DataFrameLike]:
+        """Evaluate a LayerChart's transforms
+
+        Evaluate the data transforms associated with a LayerChart and return the
+        transformed data for each layer as a list of DataFrames
+
+        Parameters
+        ----------
+        row_limit : int (optional)
+            Maximum number of rows to return for each DataFrame. None (default) for unlimited
+        exclude : iterable of str
+            Set of the names of charts to exclude
+
+        Returns
+        -------
+        list of DataFrame
+            Transformed data for each layer as a list of DataFrames
+        """
+        from altair.utils._transformed_data import transformed_data
+
+        return transformed_data(self, row_limit=row_limit, exclude=exclude)
+
+    def __iadd__(self, other: Union[core.LayerSpec, core.UnitSpec]) -> Self:
+        _check_if_valid_subspec(other, "LayerChart")
+        _check_if_can_be_layered(other)
+        self.layer.append(other)
+        self.data, self.layer = _combine_subchart_data(self.data, self.layer)
+        self.params, self.layer = _combine_subchart_params(self.params, self.layer)
+        return self
+
+    def __add__(self, other: Union[core.LayerSpec, core.UnitSpec]) -> Self:
+        copy = self.copy(deep=["layer"])
+        copy += other
+        return copy
+
+    def add_layers(self, *layers: Union[core.LayerSpec, core.UnitSpec]) -> Self:
+        copy = self.copy(deep=["layer"])
+        for layer in layers:
+            copy += layer
+        return copy
+
+    def interactive(
+        self, name: Optional[str] = None, bind_x: bool = True, bind_y: bool = True
+    ) -> Self:
+        """Make chart axes scales interactive
+
+        Parameters
+        ----------
+        name : string
+            The parameter name to use for the axes scales. This name should be
+            unique among all parameters within the chart.
+        bind_x : boolean, default True
+            If true, then bind the interactive scales to the x-axis
+        bind_y : boolean, default True
+            If true, then bind the interactive scales to the y-axis
+
+        Returns
+        -------
+        chart :
+            copy of self, with interactive axes added
+
+        """
+        if not self.layer:
+            raise ValueError(
+                "LayerChart: cannot call interactive() until a " "layer is defined"
+            )
+        copy = self.copy(deep=["layer"])
+        copy.layer[0] = copy.layer[0].interactive(
+            name=name, bind_x=bind_x, bind_y=bind_y
+        )
+        return copy
+
+    def add_params(self, *params: Parameter) -> Self:
+        """Add one or more parameters to the chart."""
+        if not params or not self.layer:
+            return self
+        copy = self.copy()
+        copy.layer[0] = copy.layer[0].add_params(*params)
+        return copy.copy()
+
+    @utils.deprecation.deprecated(
+        message="'add_selection' is deprecated. Use 'add_params' instead."
+    )
+    def add_selection(self, *selections) -> Self:
+        """'add_selection' is deprecated. Use 'add_params' instead."""
+        return self.add_params(*selections)
+
+
+def layer(*charts, **kwargs) -> LayerChart:
+    """layer multiple charts"""
+    return LayerChart(layer=charts, **kwargs)
+
+
+class FacetChart(TopLevelMixin, core.TopLevelFacetSpec):
+    """A Chart with layers within a single panel"""
+
+    @utils.use_signature(core.TopLevelFacetSpec)
+    def __init__(
+        self,
+        data=Undefined,
+        spec=Undefined,
+        facet=Undefined,
+        params=Undefined,
+        **kwargs,
+    ):
+        _check_if_valid_subspec(spec, "FacetChart")
+        _spec_as_list = [spec]
+        params, _spec_as_list = _combine_subchart_params(params, _spec_as_list)
+        spec = _spec_as_list[0]
+        super(FacetChart, self).__init__(
+            data=data, spec=spec, facet=facet, params=params, **kwargs
+        )
+
+    def transformed_data(
+        self,
+        row_limit: Optional[int] = None,
+        exclude: Optional[Iterable[str]] = None,
+    ) -> Optional[DataFrameLike]:
+        """Evaluate a FacetChart's transforms
+
+        Evaluate the data transforms associated with a FacetChart and return the
+        transformed data a DataFrame
+
+        Parameters
+        ----------
+        row_limit : int (optional)
+            Maximum number of rows to return for each DataFrame. None (default) for unlimited
+        exclude : iterable of str
+            Set of the names of charts to exclude
+
+        Returns
+        -------
+        DataFrame
+            Transformed data as a DataFrame
+        """
+        from altair.utils._transformed_data import transformed_data
+
+        return transformed_data(self, row_limit=row_limit, exclude=exclude)
+
+    def interactive(
+        self, name: Optional[str] = None, bind_x: bool = True, bind_y: bool = True
+    ) -> Self:
+        """Make chart axes scales interactive
+
+        Parameters
+        ----------
+        name : string
+            The parameter name to use for the axes scales. This name should be
+            unique among all parameters within the chart.
+        bind_x : boolean, default True
+            If true, then bind the interactive scales to the x-axis
+        bind_y : boolean, default True
+            If true, then bind the interactive scales to the y-axis
+
+        Returns
+        -------
+        chart :
+            copy of self, with interactive axes added
+
+        """
+        copy = self.copy(deep=False)
+        copy.spec = copy.spec.interactive(name=name, bind_x=bind_x, bind_y=bind_y)
+        return copy
+
+    def add_params(self, *params: Parameter) -> Self:
+        """Add one or more parameters to the chart."""
+        if not params or self.spec is Undefined:
+            return self
+        copy = self.copy()
+        copy.spec = copy.spec.add_params(*params)
+        return copy.copy()
+
+    @utils.deprecation.deprecated(
+        message="'add_selection' is deprecated. Use 'add_params' instead."
+    )
+    def add_selection(self, *selections) -> Self:
+        """'add_selection' is deprecated. Use 'add_params' instead."""
+        return self.add_params(*selections)
+
+
+def topo_feature(url: str, feature: str, **kwargs) -> core.UrlData:
+    """A convenience function for extracting features from a topojson url
+
+    Parameters
+    ----------
+    url : string
+        An URL from which to load the data set.
+
+    feature : string
+        The name of the TopoJSON object set to convert to a GeoJSON feature collection. For
+        example, in a map of the world, there may be an object set named `"countries"`.
+        Using the feature property, we can extract this set and generate a GeoJSON feature
+        object for each country.
+
+    **kwargs :
+        additional keywords passed to TopoDataFormat
+    """
+    return core.UrlData(
+        url=url, format=core.TopoDataFormat(type="topojson", feature=feature, **kwargs)
+    )
+
+
+def _combine_subchart_data(data, subcharts):
+    def remove_data(subchart):
+        if subchart.data is not Undefined:
+            subchart = subchart.copy()
+            subchart.data = Undefined
+        return subchart
+
+    if not subcharts:
+        # No subcharts = nothing to do.
+        pass
+    elif data is Undefined:
+        # Top level has no data; all subchart data must
+        # be identical to proceed.
+        subdata = subcharts[0].data
+        if subdata is not Undefined and all(c.data is subdata for c in subcharts):
+            data = subdata
+            subcharts = [remove_data(c) for c in subcharts]
+    else:
+        # Top level has data; subchart data must be either
+        # undefined or identical to proceed.
+        if all(c.data is Undefined or c.data is data for c in subcharts):
+            subcharts = [remove_data(c) for c in subcharts]
+
+    return data, subcharts
+
+
+def _viewless_dict(param: Parameter) -> dict:
+    d = param.to_dict()
+    d.pop("views", None)
+    return d
+
+
+def _needs_name(subchart):
+    # Only `Chart` objects need a name
+    if (subchart.name is not Undefined) or (not isinstance(subchart, Chart)):
+        return False
+
+    # Variable parameters won't receive a views property.
+    if all(isinstance(p, core.VariableParameter) for p in subchart.params):
+        return False
+
+    return True
+
+
+# Convert SelectionParameters to TopLevelSelectionParameters with a views property.
+def _prepare_to_lift(param):
+    param = param.copy()
+
+    if isinstance(param, core.VariableParameter):
+        return param
+
+    if isinstance(param, core.SelectionParameter):
+        return core.TopLevelSelectionParameter(**param.to_dict(), views=[])
+
+    if param.views is Undefined:
+        param.views = []
+
+    return param
+
+
+def _remove_duplicate_params(layer):
+    subcharts = [subchart.copy() for subchart in layer]
+    found_params = []
+
+    for subchart in subcharts:
+        if (not hasattr(subchart, "params")) or (subchart.params is Undefined):
+            continue
+
+        params = []
+
+        # Ensure the same selection parameter doesn't appear twice
+        for param in subchart.params:
+            if isinstance(param, core.VariableParameter):
+                params.append(param)
+                continue
+
+            p = param.copy()
+            pd = _viewless_dict(p)
+
+            if pd not in found_params:
+                params.append(p)
+                found_params.append(pd)
+
+        if len(params) == 0:
+            subchart.params = Undefined
+        else:
+            subchart.params = params
+
+    return subcharts
+
+
+def _combine_subchart_params(params, subcharts):
+    if params is Undefined:
+        params = []
+
+    # List of triples related to params, (param, dictionary minus views, views)
+    param_info = []
+
+    # Put parameters already found into `param_info` list.
+    for param in params:
+        p = _prepare_to_lift(param)
+        param_info.append(
+            (
+                p,
+                _viewless_dict(p),
+                [] if isinstance(p, core.VariableParameter) else p.views,
+            )
+        )
+
+    subcharts = [subchart.copy() for subchart in subcharts]
+
+    for subchart in subcharts:
+        if (not hasattr(subchart, "params")) or (subchart.params is Undefined):
+            continue
+
+        if _needs_name(subchart):
+            subchart.name = subchart._get_name()
+
+        for param in subchart.params:
+            p = _prepare_to_lift(param)
+            pd = _viewless_dict(p)
+
+            dlist = [d for _, d, _ in param_info]
+            found = pd in dlist
+
+            if isinstance(p, core.VariableParameter) and found:
+                continue
+
+            if isinstance(p, core.VariableParameter) and not found:
+                param_info.append((p, pd, []))
+                continue
+
+            # At this stage in the loop, p must be a TopLevelSelectionParameter.
+
+            if isinstance(subchart, Chart) and (subchart.name not in p.views):
+                p.views.append(subchart.name)
+
+            if found:
+                i = dlist.index(pd)
+                _, _, old_views = param_info[i]
+                new_views = [v for v in p.views if v not in old_views]
+                old_views += new_views
+            else:
+                param_info.append((p, pd, p.views))
+
+        subchart.params = Undefined
+
+    for p, _, v in param_info:
+        if len(v) > 0:
+            p.views = v
+
+    subparams = [p for p, _, _ in param_info]
+
+    if len(subparams) == 0:
+        subparams = Undefined
+
+    return subparams, subcharts
+
+
+def _get_repeat_strings(repeat):
+    if isinstance(repeat, list):
+        return repeat
+    elif isinstance(repeat, core.LayerRepeatMapping):
+        klist = ["row", "column", "layer"]
+    elif isinstance(repeat, core.RepeatMapping):
+        klist = ["row", "column"]
+    rclist = [k for k in klist if repeat[k] is not Undefined]
+    rcstrings = [[f"{k}_{v}" for v in repeat[k]] for k in rclist]
+    return ["".join(s) for s in itertools.product(*rcstrings)]
+
+
+def _extend_view_name(v, r, spec):
+    # prevent the same extension from happening more than once
+    if isinstance(spec, Chart):
+        if v.endswith("child__" + r):
+            return v
+        else:
+            return f"{v}_child__{r}"
+    elif isinstance(spec, LayerChart):
+        if v.startswith("child__" + r):
+            return v
+        else:
+            return f"child__{r}_{v}"
+
+
+def _repeat_names(params, repeat, spec):
+    if params is Undefined:
+        return params
+
+    repeat = _get_repeat_strings(repeat)
+    params_named = []
+
+    for param in params:
+        if not isinstance(param, core.TopLevelSelectionParameter):
+            params_named.append(param)
+            continue
+        p = param.copy()
+        views = []
+        repeat_strings = _get_repeat_strings(repeat)
+        for v in param.views:
+            if isinstance(spec, Chart):
+                if any(v.endswith(f"child__{r}") for r in repeat_strings):
+                    views.append(v)
+                else:
+                    views += [_extend_view_name(v, r, spec) for r in repeat_strings]
+            elif isinstance(spec, LayerChart):
+                if any(v.startswith(f"child__{r}") for r in repeat_strings):
+                    views.append(v)
+                else:
+                    views += [_extend_view_name(v, r, spec) for r in repeat_strings]
+
+        p.views = views
+        params_named.append(p)
+
+    return params_named
+
+
+def _remove_layer_props(chart, subcharts, layer_props):
+    def remove_prop(subchart, prop):
+        # If subchart is a UnitSpec, then subchart["height"] raises a KeyError
+        try:
+            if subchart[prop] is not Undefined:
+                subchart = subchart.copy()
+                subchart[prop] = Undefined
+        except KeyError:
+            pass
+        return subchart
+
+    output_dict = {}
+
+    if not subcharts:
+        # No subcharts = nothing to do.
+        return output_dict, subcharts
+
+    for prop in layer_props:
+        if chart[prop] is Undefined:
+            # Top level does not have this prop.
+            # Check for consistent props within the subcharts.
+            values = []
+            for c in subcharts:
+                # If c is a UnitSpec, then c["height"] raises a KeyError.
+                try:
+                    val = c[prop]
+                    if val is not Undefined:
+                        values.append(val)
+                except KeyError:
+                    pass
+            if len(values) == 0:
+                pass
+            elif all(v == values[0] for v in values[1:]):
+                output_dict[prop] = values[0]
+            else:
+                raise ValueError(f"There are inconsistent values {values} for {prop}")
+        else:
+            # Top level has this prop; subchart must either not have the prop
+            # or it must be Undefined or identical to proceed.
+            if all(
+                getattr(c, prop, Undefined) is Undefined or c[prop] == chart[prop]
+                for c in subcharts
+            ):
+                output_dict[prop] = chart[prop]
+            else:
+                raise ValueError(f"There are inconsistent values {values} for {prop}")
+        subcharts = [remove_prop(c, prop) for c in subcharts]
+
+    return output_dict, subcharts
+
+
+@utils.use_signature(core.SequenceParams)
+def sequence(start, stop=None, step=Undefined, as_=Undefined, **kwds):
+    """Sequence generator."""
+    if stop is None:
+        start, stop = 0, start
+    params = core.SequenceParams(start=start, stop=stop, step=step, **{"as": as_})
+    return core.SequenceGenerator(sequence=params, **kwds)
+
+
+@utils.use_signature(core.GraticuleParams)
+def graticule(**kwds):
+    """Graticule generator."""
+    if not kwds:
+        # graticule: True indicates default parameters
+        graticule = True
+    else:
+        graticule = core.GraticuleParams(**kwds)
+    return core.GraticuleGenerator(graticule=graticule)
+
+
+def sphere() -> core.SphereGenerator:
+    """Sphere generator."""
+    return core.SphereGenerator(sphere=True)
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/compiler.py b/llm/Lib/site-packages/altair/vegalite/v5/compiler.py
new file mode 100644
index 0000000000000000000000000000000000000000..4a892e6ed018565c60e56b37c51cc097695f206b
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/v5/compiler.py
@@ -0,0 +1,26 @@
+from ...utils._importers import import_vl_convert
+from ...utils.compiler import VegaLiteCompilerRegistry
+
+from typing import Final
+
+
+ENTRY_POINT_GROUP: Final = "altair.vegalite.v5.vegalite_compiler"
+vegalite_compilers = VegaLiteCompilerRegistry(entry_point_group=ENTRY_POINT_GROUP)
+
+
+def vl_convert_compiler(vegalite_spec: dict) -> dict:
+    """
+    Vega-Lite to Vega compiler that uses vl-convert
+    """
+    from . import SCHEMA_VERSION
+
+    vlc = import_vl_convert()
+
+    # Compute vl-convert's vl_version string (of the form 'v5_8')
+    # from SCHEMA_VERSION (of the form 'v5.8.0')
+    vl_version = "_".join(SCHEMA_VERSION.split(".")[:2])
+    return vlc.vegalite_to_vega(vegalite_spec, vl_version=vl_version)
+
+
+vegalite_compilers.register("vl-convert", vl_convert_compiler)
+vegalite_compilers.enable("vl-convert")
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/data.py b/llm/Lib/site-packages/altair/vegalite/v5/data.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e47db52673e30552707ffe22684639ea910280c
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/v5/data.py
@@ -0,0 +1,47 @@
+from ..data import (
+    MaxRowsError,
+    curry,
+    default_data_transformer,
+    limit_rows,
+    pipe,
+    sample,
+    to_csv,
+    to_json,
+    to_values,
+    DataTransformerRegistry,
+)
+
+from ...utils._vegafusion_data import vegafusion_data_transformer
+
+from typing import Final
+
+
+# ==============================================================================
+# VegaLite 5 data transformers
+# ==============================================================================
+
+
+ENTRY_POINT_GROUP: Final = "altair.vegalite.v5.data_transformer"
+
+
+data_transformers = DataTransformerRegistry(entry_point_group=ENTRY_POINT_GROUP)
+data_transformers.register("default", default_data_transformer)
+data_transformers.register("json", to_json)
+data_transformers.register("csv", to_csv)
+data_transformers.register("vegafusion", vegafusion_data_transformer)
+data_transformers.enable("default")
+
+
+__all__ = (
+    "MaxRowsError",
+    "curry",
+    "default_data_transformer",
+    "limit_rows",
+    "pipe",
+    "sample",
+    "to_csv",
+    "to_json",
+    "to_values",
+    "data_transformers",
+    "vegafusion_data_transformer",
+)
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/display.py b/llm/Lib/site-packages/altair/vegalite/v5/display.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7901a7b748368e964952c925cb6c74fab7b3b4c
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/v5/display.py
@@ -0,0 +1,179 @@
+import os
+from typing import Dict
+
+from ...utils.mimebundle import spec_to_mimebundle
+from ..display import (
+    Displayable,
+    default_renderer_base,
+    json_renderer_base,
+    RendererRegistry,
+    HTMLRenderer,
+    DefaultRendererReturnType,
+)
+
+from .schema import SCHEMA_VERSION
+
+from typing import Final
+
+VEGALITE_VERSION: Final = SCHEMA_VERSION.lstrip("v")
+VEGA_VERSION: Final = "5"
+VEGAEMBED_VERSION: Final = "6"
+
+
+# ==============================================================================
+# VegaLite v5 renderer logic
+# ==============================================================================
+
+
+# The MIME type for Vega-Lite 5.x releases.
+VEGALITE_MIME_TYPE: Final = "application/vnd.vegalite.v5+json"
+
+# The MIME type for Vega 5.x releases.
+VEGA_MIME_TYPE: Final = "application/vnd.vega.v5+json"
+
+# The entry point group that can be used by other packages to declare other
+# renderers that will be auto-detected. Explicit registration is also
+# allowed by the PluginRegistery API.
+ENTRY_POINT_GROUP: Final = "altair.vegalite.v5.renderer"
+
+# The display message when rendering fails
+DEFAULT_DISPLAY: Final = f"""\
+<VegaLite {VEGALITE_VERSION.split('.')[0]} object>
+
+If you see this message, it means the renderer has not been properly enabled
+for the frontend that you are using. For more information, see
+https://altair-viz.github.io/user_guide/display_frontends.html#troubleshooting
+"""
+
+renderers = RendererRegistry(entry_point_group=ENTRY_POINT_GROUP)
+
+here = os.path.dirname(os.path.realpath(__file__))
+
+
+def mimetype_renderer(spec: dict, **metadata) -> DefaultRendererReturnType:
+    return default_renderer_base(spec, VEGALITE_MIME_TYPE, DEFAULT_DISPLAY, **metadata)
+
+
+def json_renderer(spec: dict, **metadata) -> DefaultRendererReturnType:
+    return json_renderer_base(spec, DEFAULT_DISPLAY, **metadata)
+
+
+def png_renderer(spec: dict, **metadata) -> Dict[str, bytes]:
+    # To get proper return value type, would need to write complex
+    # overload signatures for spec_to_mimebundle based on `format`
+    return spec_to_mimebundle(  # type: ignore[return-value]
+        spec,
+        format="png",
+        mode="vega-lite",
+        vega_version=VEGA_VERSION,
+        vegaembed_version=VEGAEMBED_VERSION,
+        vegalite_version=VEGALITE_VERSION,
+        **metadata,
+    )
+
+
+def svg_renderer(spec: dict, **metadata) -> Dict[str, str]:
+    # To get proper return value type, would need to write complex
+    # overload signatures for spec_to_mimebundle based on `format`
+    return spec_to_mimebundle(  # type: ignore[return-value]
+        spec,
+        format="svg",
+        mode="vega-lite",
+        vega_version=VEGA_VERSION,
+        vegaembed_version=VEGAEMBED_VERSION,
+        vegalite_version=VEGALITE_VERSION,
+        **metadata,
+    )
+
+
+def jupyter_renderer(spec: dict, **metadata):
+    """Render chart using the JupyterChart Jupyter Widget"""
+    from altair import Chart, JupyterChart
+
+    # Configure offline mode
+    offline = metadata.get("offline", False)
+
+    # mypy doesn't see the enable_offline class method for some reason
+    JupyterChart.enable_offline(offline=offline)  # type: ignore[attr-defined]
+
+    # propagate embed options
+    embed_options = metadata.get("embed_options", None)
+
+    # Need to ignore attr-defined mypy rule because mypy doesn't see _repr_mimebundle_
+    # conditionally defined in AnyWidget
+    return JupyterChart(
+        chart=Chart.from_dict(spec), embed_options=embed_options
+    )._repr_mimebundle_()  # type: ignore[attr-defined]
+
+
+def browser_renderer(
+    spec: dict, offline=False, using=None, port=0, **metadata
+) -> Dict[str, str]:
+    from altair.utils._show import open_html_in_browser
+
+    if offline:
+        metadata["template"] = "inline"
+    mimebundle = spec_to_mimebundle(
+        spec,
+        format="html",
+        mode="vega-lite",
+        vega_version=VEGA_VERSION,
+        vegaembed_version=VEGAEMBED_VERSION,
+        vegalite_version=VEGALITE_VERSION,
+        **metadata,
+    )
+
+    if isinstance(mimebundle, tuple):
+        mimebundle = mimebundle[0]
+
+    html = mimebundle["text/html"]
+    open_html_in_browser(html, using=using, port=port)
+    return {}
+
+
+html_renderer = HTMLRenderer(
+    mode="vega-lite",
+    template="universal",
+    vega_version=VEGA_VERSION,
+    vegaembed_version=VEGAEMBED_VERSION,
+    vegalite_version=VEGALITE_VERSION,
+)
+
+renderers.register("default", html_renderer)
+renderers.register("html", html_renderer)
+renderers.register("colab", html_renderer)
+renderers.register("kaggle", html_renderer)
+renderers.register("zeppelin", html_renderer)
+renderers.register("mimetype", mimetype_renderer)
+renderers.register("jupyterlab", mimetype_renderer)
+renderers.register("nteract", mimetype_renderer)
+renderers.register("json", json_renderer)
+renderers.register("png", png_renderer)
+renderers.register("svg", svg_renderer)
+renderers.register("jupyter", jupyter_renderer)
+renderers.register("browser", browser_renderer)
+renderers.enable("default")
+
+
+class VegaLite(Displayable):
+    """An IPython/Jupyter display class for rendering VegaLite 5."""
+
+    renderers = renderers
+    schema_path = (__name__, "schema/vega-lite-schema.json")
+
+
+def vegalite(spec: dict, validate: bool = True) -> None:
+    """Render and optionally validate a VegaLite 5 spec.
+
+    This will use the currently enabled renderer to render the spec.
+
+    Parameters
+    ==========
+    spec: dict
+        A fully compliant VegaLite 5 spec, with the data portion fully processed.
+    validate: bool
+        Should the spec be validated against the VegaLite 5 schema?
+    """
+    from IPython.display import display
+
+    display(VegaLite(spec, validate=validate))
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/schema/__init__.py b/llm/Lib/site-packages/altair/vegalite/v5/schema/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..291742db95a93ecdc560ecc631d2deba8df99d0f
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/v5/schema/__init__.py
@@ -0,0 +1,8 @@
+# ruff: noqa
+
+from .core import *
+from .channels import *  # type: ignore[assignment]
+
+SCHEMA_VERSION = "v5.17.0"
+
+SCHEMA_URL = "https://vega.github.io/schema/vega-lite/v5.17.0.json"
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e5747324ac91c557d1adfa7384ee1e57a206817e
Binary files /dev/null and b/llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/channels.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/channels.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..524fac2ae93c6a78ee11052e4fa2b7f8d3c48449
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/channels.cpython-311.pyc
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:40ba2ad127e1a27506a91bd1b76979bd15699c9797018daa58b0d6f74ea3da94
+size 1402436
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/core.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/core.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d127d636e92b61b0edd7d413b28d7527654b8fbf
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/core.cpython-311.pyc
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:620cf0c9a49256b8b85bd995f0b1e4fc493f49e30ccd96438fd271db8e84f61a
+size 1659806
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/mixins.cpython-311.pyc b/llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/mixins.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ac3d6a7964977683a29ca7996faaa9614e9e1043
Binary files /dev/null and b/llm/Lib/site-packages/altair/vegalite/v5/schema/__pycache__/mixins.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/schema/channels.py b/llm/Lib/site-packages/altair/vegalite/v5/schema/channels.py
new file mode 100644
index 0000000000000000000000000000000000000000..089a534a643849200a4c09c211415dca405b1ae5
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/v5/schema/channels.py
@@ -0,0 +1,78702 @@
+# The contents of this file are automatically written by
+# tools/generate_schema_wrapper.py. Do not modify directly.
+
+# These errors need to be ignored as they come from the overload methods
+# which trigger two kind of errors in mypy:
+# * all of them do not have an implementation in this file
+# * some of them are the only overload methods -> overloads usually only make
+#   sense if there are multiple ones
+# However, we need these overloads due to how the propertysetter works
+# mypy: disable-error-code="no-overload-impl, empty-body, misc"
+
+import sys
+from . import core
+import pandas as pd
+from altair.utils.schemapi import Undefined, UndefinedType, with_property_setters
+from altair.utils import parse_shorthand
+from typing import Any, overload, Sequence, List, Literal, Union, Optional
+from typing import Dict as TypingDict
+
+
+class FieldChannelMixin:
+    def to_dict(
+        self,
+        validate: bool = True,
+        ignore: Optional[List[str]] = None,
+        context: Optional[TypingDict[str, Any]] = None,
+    ) -> Union[dict, List[dict]]:
+        context = context or {}
+        ignore = ignore or []
+        shorthand = self._get("shorthand")  # type: ignore[attr-defined]
+        field = self._get("field")  # type: ignore[attr-defined]
+
+        if shorthand is not Undefined and field is not Undefined:
+            raise ValueError(
+                "{} specifies both shorthand={} and field={}. " "".format(
+                    self.__class__.__name__, shorthand, field
+                )
+            )
+
+        if isinstance(shorthand, (tuple, list)):
+            # If given a list of shorthands, then transform it to a list of classes
+            kwds = self._kwds.copy()  # type: ignore[attr-defined]
+            kwds.pop("shorthand")
+            return [
+                self.__class__(sh, **kwds).to_dict(  # type: ignore[call-arg]
+                    validate=validate, ignore=ignore, context=context
+                )
+                for sh in shorthand
+            ]
+
+        if shorthand is Undefined:
+            parsed = {}
+        elif isinstance(shorthand, str):
+            parsed = parse_shorthand(shorthand, data=context.get("data", None))
+            type_required = "type" in self._kwds  # type: ignore[attr-defined]
+            type_in_shorthand = "type" in parsed
+            type_defined_explicitly = self._get("type") is not Undefined  # type: ignore[attr-defined]
+            if not type_required:
+                # Secondary field names don't require a type argument in VegaLite 3+.
+                # We still parse it out of the shorthand, but drop it here.
+                parsed.pop("type", None)
+            elif not (type_in_shorthand or type_defined_explicitly):
+                if isinstance(context.get("data", None), pd.DataFrame):
+                    raise ValueError(
+                        'Unable to determine data type for the field "{}";'
+                        " verify that the field name is not misspelled."
+                        " If you are referencing a field from a transform,"
+                        " also confirm that the data type is specified correctly.".format(
+                            shorthand
+                        )
+                    )
+                else:
+                    raise ValueError(
+                        "{} encoding field is specified without a type; "
+                        "the type cannot be automatically inferred because "
+                        "the data is not specified as a pandas.DataFrame."
+                        "".format(shorthand)
+                    )
+        else:
+            # Shorthand is not a string; we pass the definition to field,
+            # and do not do any parsing.
+            parsed = {"field": shorthand}
+        context["parsed_shorthand"] = parsed
+
+        return super(FieldChannelMixin, self).to_dict(
+            validate=validate, ignore=ignore, context=context
+        )
+
+
+class ValueChannelMixin:
+    def to_dict(
+        self,
+        validate: bool = True,
+        ignore: Optional[List[str]] = None,
+        context: Optional[TypingDict[str, Any]] = None,
+    ) -> dict:
+        context = context or {}
+        ignore = ignore or []
+        condition = self._get("condition", Undefined)  # type: ignore[attr-defined]
+        copy = self  # don't copy unless we need to
+        if condition is not Undefined:
+            if isinstance(condition, core.SchemaBase):
+                pass
+            elif "field" in condition and "type" not in condition:
+                kwds = parse_shorthand(condition["field"], context.get("data", None))
+                copy = self.copy(deep=["condition"])  # type: ignore[attr-defined]
+                copy["condition"].update(kwds)  # type: ignore[index]
+        return super(ValueChannelMixin, copy).to_dict(
+            validate=validate, ignore=ignore, context=context
+        )
+
+
+class DatumChannelMixin:
+    def to_dict(
+        self,
+        validate: bool = True,
+        ignore: Optional[List[str]] = None,
+        context: Optional[TypingDict[str, Any]] = None,
+    ) -> dict:
+        context = context or {}
+        ignore = ignore or []
+        datum = self._get("datum", Undefined)  # type: ignore[attr-defined]
+        copy = self  # don't copy unless we need to
+        if datum is not Undefined:
+            if isinstance(datum, core.SchemaBase):
+                pass
+        return super(DatumChannelMixin, copy).to_dict(
+            validate=validate, ignore=ignore, context=context
+        )
+
+
+@with_property_setters
+class Angle(FieldChannelMixin, core.FieldOrDatumDefWithConditionMarkPropFieldDefnumber):
+    """Angle schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "angle"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Angle": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Angle": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Angle": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Angle": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Angle": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "Angle": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Angle": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def legend(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        clipHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columnPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columns: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        direction: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        fillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        gradientLength: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientThickness: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["all", "each", "none"],
+            UndefinedType,
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            core.SchemaBase,
+            Literal[
+                "none",
+                "left",
+                "right",
+                "top",
+                "bottom",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rowPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        symbolDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolFillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolType: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[Literal["symbol", "gradient"], UndefinedType] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def legend(self, _: None, **kwds) -> "Angle": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "Angle": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "Angle": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "Angle": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "Angle": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "Angle": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Angle": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "Angle": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Angle": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Angle": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Angle": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Angle": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Angle": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Angle, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class AngleDatum(DatumChannelMixin, core.FieldOrDatumDefWithConditionDatumDefnumber):
+    """AngleDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "angle"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "AngleDatum": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "AngleDatum": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "AngleDatum": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "AngleDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "AngleDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "AngleDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "AngleDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "AngleDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(AngleDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            condition=condition,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class AngleValue(
+    ValueChannelMixin, core.ValueDefWithConditionMarkPropFieldOrDatumDefnumber
+):
+    """AngleValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "angle"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "AngleValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "AngleValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "AngleValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "AngleValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "AngleValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "AngleValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "AngleValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(AngleValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class Color(
+    FieldChannelMixin,
+    core.FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull,
+):
+    """Color schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "color"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Color": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Color": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Color": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Color": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Color": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefGradientstringnullExprRef], **kwds
+    ) -> "Color": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Color": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def legend(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        clipHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columnPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columns: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        direction: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        fillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        gradientLength: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientThickness: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["all", "each", "none"],
+            UndefinedType,
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            core.SchemaBase,
+            Literal[
+                "none",
+                "left",
+                "right",
+                "top",
+                "bottom",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rowPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        symbolDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolFillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolType: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[Literal["symbol", "gradient"], UndefinedType] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def legend(self, _: None, **kwds) -> "Color": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "Color": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "Color": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "Color": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "Color": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "Color": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Color": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "Color": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Color": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Color": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Color": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Color": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Color": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Color, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class ColorDatum(
+    DatumChannelMixin, core.FieldOrDatumDefWithConditionDatumDefGradientstringnull
+):
+    """ColorDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "color"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "ColorDatum": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "ColorDatum": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "ColorDatum": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefGradientstringnullExprRef], **kwds
+    ) -> "ColorDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "ColorDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "ColorDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "ColorDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "ColorDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ColorDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            condition=condition,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class ColorValue(
+    ValueChannelMixin,
+    core.ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull,
+):
+    """ColorValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, None, :class:`ExprRef`, :class:`Gradient`, :class:`LinearGradient`, :class:`RadialGradient`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "color"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "ColorValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "ColorValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "ColorValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "ColorValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "ColorValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "ColorValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefGradientstringnullExprRef], **kwds
+    ) -> "ColorValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ColorValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class Column(FieldChannelMixin, core.RowColumnEncodingFieldDef):
+    """Column schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    align : :class:`LayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to row/column facet's subplot. The supported string values
+        are ``"all"``, ``"each"``, and ``"none"``.
+
+
+        * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply
+          placed one after the other.
+        * For ``"each"``, subviews will be aligned into a clean grid structure, but each row
+          or column may be of variable size.
+        * For ``"all"``, subviews will be aligned and each row or column will be sized
+          identically based on the maximum observed size. String values for this property
+          will be applied to both grid rows and columns.
+
+        **Default value:** ``"all"``.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    center : bool
+        Boolean flag indicating if facet's subviews should be centered relative to their
+        respective rows or columns.
+
+        **Default value:** ``false``
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    header : dict, None, :class:`Header`
+        An object defining properties of a facet's header.
+    sort : dict, None, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`EncodingSortField`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` is not supported for ``row`` and ``column``.
+    spacing : float
+        The spacing in pixels between facet's sub-views.
+
+        **Default value** : Depends on ``"spacing"`` property of `the view composition
+        configuration <https://vega.github.io/vega-lite/docs/config.html#view-config>`__ (
+        ``20`` by default)
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "column"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Column": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Column": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Column": ...
+
+    @overload
+    def align(self, _: Literal["all", "each", "none"], **kwds) -> "Column": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Column": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Column": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Column": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Column": ...
+
+    @overload
+    def center(self, _: bool, **kwds) -> "Column": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Column": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Column": ...
+
+    @overload
+    def header(
+        self,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelAnchor: Union[
+            core.SchemaBase, Literal[None, "start", "middle", "end"], UndefinedType
+        ] = Undefined,
+        labelAngle: Union[float, UndefinedType] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOrient: Union[
+            core.SchemaBase, Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labels: Union[bool, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            core.SchemaBase, Literal[None, "start", "middle", "end"], UndefinedType
+        ] = Undefined,
+        titleAngle: Union[float, UndefinedType] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            core.SchemaBase, Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Column": ...
+
+    @overload
+    def header(self, _: None, **kwds) -> "Column": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "Column": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "Column": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "Column": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "Column": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Column": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Column": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "Column": ...
+
+    @overload
+    def spacing(self, _: float, **kwds) -> "Column": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Column": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Column": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Column": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Column": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Column": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Column": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Column": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Column": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Column": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Column": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Column": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        align: Union[
+            core.SchemaBase, Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        center: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        header: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        spacing: Union[float, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Column, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            align=align,
+            bandPosition=bandPosition,
+            bin=bin,
+            center=center,
+            field=field,
+            header=header,
+            sort=sort,
+            spacing=spacing,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class Description(FieldChannelMixin, core.StringFieldDefWithCondition):
+    """Description schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefstringExprRef`, :class:`ConditionalParameterValueDefstringExprRef`, :class:`ConditionalPredicateValueDefstringExprRef`, Sequence[dict, :class:`ConditionalValueDefstringExprRef`, :class:`ConditionalParameterValueDefstringExprRef`, :class:`ConditionalPredicateValueDefstringExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "description"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Description": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Description": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Description": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Description": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Description": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Description": ...
+
+    @overload
+    def bin(self, _: str, **kwds) -> "Description": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Description": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Description": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Description": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefstringExprRef], **kwds
+    ) -> "Description": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Description": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Description": ...
+
+    @overload
+    def format(self, _: str, **kwds) -> "Description": ...
+
+    @overload
+    def format(self, _: dict, **kwds) -> "Description": ...
+
+    @overload
+    def formatType(self, _: str, **kwds) -> "Description": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Description": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Description": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Description": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Description": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Description": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Description": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Description": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Description": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Description": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Description": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Description": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Description, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            format=format,
+            formatType=formatType,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class DescriptionValue(ValueChannelMixin, core.StringValueDefWithCondition):
+    """DescriptionValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, None, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "description"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "DescriptionValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "DescriptionValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "DescriptionValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "DescriptionValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "DescriptionValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "DescriptionValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefstringnullExprRef], **kwds
+    ) -> "DescriptionValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(DescriptionValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class Detail(FieldChannelMixin, core.FieldDefWithoutScale):
+    """Detail schema wrapper
+    Definition object for a data field, its type and transformation of an encoding channel.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "detail"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Detail": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Detail": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Detail": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Detail": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Detail": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Detail": ...
+
+    @overload
+    def bin(self, _: str, **kwds) -> "Detail": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Detail": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Detail": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Detail": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Detail": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Detail": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Detail": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Detail": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Detail": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Detail": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Detail": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Detail": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Detail": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Detail": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Detail": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Detail, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class Facet(FieldChannelMixin, core.FacetEncodingFieldDef):
+    """Facet schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    align : dict, :class:`LayoutAlign`, :class:`RowColLayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to grid rows and columns. The supported string values are
+        ``"all"``, ``"each"``, and ``"none"``.
+
+
+        * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply
+          placed one after the other.
+        * For ``"each"``, subviews will be aligned into a clean grid structure, but each row
+          or column may be of variable size.
+        * For ``"all"``, subviews will be aligned and each row or column will be sized
+          identically based on the maximum observed size. String values for this property
+          will be applied to both grid rows and columns.
+
+        Alternatively, an object value of the form ``{"row": string, "column": string}`` can
+        be used to supply different alignments for rows and columns.
+
+        **Default value:** ``"all"``.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool, dict, :class:`RowColboolean`
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        An object value of the form ``{"row": boolean, "column": boolean}`` can be used to
+        supply different centering values for rows and columns.
+
+        **Default value:** ``false``
+    columns : float
+        The number of columns to include in the view composition layout.
+
+        **Default value** : ``undefined`` -- An infinite number of columns (a single row)
+        will be assumed. This is equivalent to ``hconcat`` (for ``concat`` ) and to using
+        the ``column`` channel (for ``facet`` and ``repeat`` ).
+
+        **Note** :
+
+        1) This property is only for:
+
+
+        * the general (wrappable) ``concat`` operator (not ``hconcat`` / ``vconcat`` )
+        * the ``facet`` and ``repeat`` operator with one field/repetition definition
+          (without row/column nesting)
+
+        2) Setting the ``columns`` to ``1`` is equivalent to ``vconcat`` (for ``concat`` )
+        and to using the ``row`` channel (for ``facet`` and ``repeat`` ).
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    header : dict, None, :class:`Header`
+        An object defining properties of a facet's header.
+    sort : dict, None, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`EncodingSortField`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` is not supported for ``row`` and ``column``.
+    spacing : dict, float, :class:`RowColnumber`
+        The spacing in pixels between sub-views of the composition operator. An object of
+        the form ``{"row": number, "column": number}`` can be used to set different spacing
+        values for rows and columns.
+
+        **Default value** : Depends on ``"spacing"`` property of `the view composition
+        configuration <https://vega.github.io/vega-lite/docs/config.html#view-config>`__ (
+        ``20`` by default)
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "facet"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Facet": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Facet": ...
+
+    @overload
+    def align(self, _: Literal["all", "each", "none"], **kwds) -> "Facet": ...
+
+    @overload
+    def align(
+        self,
+        column: Union[
+            core.SchemaBase, Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        row: Union[
+            core.SchemaBase, Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Facet": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Facet": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Facet": ...
+
+    @overload
+    def bounds(self, _: Literal["full", "flush"], **kwds) -> "Facet": ...
+
+    @overload
+    def center(self, _: bool, **kwds) -> "Facet": ...
+
+    @overload
+    def center(
+        self,
+        column: Union[bool, UndefinedType] = Undefined,
+        row: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def columns(self, _: float, **kwds) -> "Facet": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Facet": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def header(
+        self,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelAnchor: Union[
+            core.SchemaBase, Literal[None, "start", "middle", "end"], UndefinedType
+        ] = Undefined,
+        labelAngle: Union[float, UndefinedType] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOrient: Union[
+            core.SchemaBase, Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labels: Union[bool, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            core.SchemaBase, Literal[None, "start", "middle", "end"], UndefinedType
+        ] = Undefined,
+        titleAngle: Union[float, UndefinedType] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            core.SchemaBase, Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def header(self, _: None, **kwds) -> "Facet": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "Facet": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "Facet": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "Facet": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "Facet": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Facet": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "Facet": ...
+
+    @overload
+    def spacing(self, _: float, **kwds) -> "Facet": ...
+
+    @overload
+    def spacing(
+        self,
+        column: Union[float, UndefinedType] = Undefined,
+        row: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Facet": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Facet": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Facet": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Facet": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Facet": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        align: Union[
+            dict, core.SchemaBase, Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        columns: Union[float, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        header: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        spacing: Union[dict, float, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Facet, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            align=align,
+            bandPosition=bandPosition,
+            bin=bin,
+            bounds=bounds,
+            center=center,
+            columns=columns,
+            field=field,
+            header=header,
+            sort=sort,
+            spacing=spacing,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class Fill(
+    FieldChannelMixin,
+    core.FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull,
+):
+    """Fill schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "fill"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Fill": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Fill": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Fill": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Fill": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Fill": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefGradientstringnullExprRef], **kwds
+    ) -> "Fill": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Fill": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def legend(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        clipHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columnPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columns: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        direction: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        fillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        gradientLength: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientThickness: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["all", "each", "none"],
+            UndefinedType,
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            core.SchemaBase,
+            Literal[
+                "none",
+                "left",
+                "right",
+                "top",
+                "bottom",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rowPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        symbolDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolFillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolType: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[Literal["symbol", "gradient"], UndefinedType] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def legend(self, _: None, **kwds) -> "Fill": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "Fill": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "Fill": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "Fill": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "Fill": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "Fill": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Fill": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "Fill": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Fill": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Fill": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Fill": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Fill": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Fill": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Fill, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class FillDatum(
+    DatumChannelMixin, core.FieldOrDatumDefWithConditionDatumDefGradientstringnull
+):
+    """FillDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "fill"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "FillDatum": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillDatum": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillDatum": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefGradientstringnullExprRef], **kwds
+    ) -> "FillDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "FillDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "FillDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "FillDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "FillDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FillDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            condition=condition,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class FillValue(
+    ValueChannelMixin,
+    core.ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull,
+):
+    """FillValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, None, :class:`ExprRef`, :class:`Gradient`, :class:`LinearGradient`, :class:`RadialGradient`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "fill"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "FillValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "FillValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "FillValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "FillValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefGradientstringnullExprRef], **kwds
+    ) -> "FillValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FillValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class FillOpacity(
+    FieldChannelMixin, core.FieldOrDatumDefWithConditionMarkPropFieldDefnumber
+):
+    """FillOpacity schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "fillOpacity"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "FillOpacity": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "FillOpacity": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "FillOpacity": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "FillOpacity": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "FillOpacity": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "FillOpacity": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "FillOpacity": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def legend(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        clipHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columnPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columns: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        direction: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        fillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        gradientLength: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientThickness: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["all", "each", "none"],
+            UndefinedType,
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            core.SchemaBase,
+            Literal[
+                "none",
+                "left",
+                "right",
+                "top",
+                "bottom",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rowPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        symbolDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolFillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolType: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[Literal["symbol", "gradient"], UndefinedType] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def legend(self, _: None, **kwds) -> "FillOpacity": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "FillOpacity": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "FillOpacity": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "FillOpacity": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "FillOpacity": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "FillOpacity": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "FillOpacity": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "FillOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "FillOpacity": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "FillOpacity": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "FillOpacity": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "FillOpacity": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "FillOpacity": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FillOpacity, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class FillOpacityDatum(
+    DatumChannelMixin, core.FieldOrDatumDefWithConditionDatumDefnumber
+):
+    """FillOpacityDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "fillOpacity"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "FillOpacityDatum": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacityDatum": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacityDatum": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "FillOpacityDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "FillOpacityDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "FillOpacityDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "FillOpacityDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "FillOpacityDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FillOpacityDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            condition=condition,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class FillOpacityValue(
+    ValueChannelMixin, core.ValueDefWithConditionMarkPropFieldOrDatumDefnumber
+):
+    """FillOpacityValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "fillOpacity"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "FillOpacityValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "FillOpacityValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FillOpacityValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class Href(FieldChannelMixin, core.StringFieldDefWithCondition):
+    """Href schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefstringExprRef`, :class:`ConditionalParameterValueDefstringExprRef`, :class:`ConditionalPredicateValueDefstringExprRef`, Sequence[dict, :class:`ConditionalValueDefstringExprRef`, :class:`ConditionalParameterValueDefstringExprRef`, :class:`ConditionalPredicateValueDefstringExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "href"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Href": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Href": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Href": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Href": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Href": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Href": ...
+
+    @overload
+    def bin(self, _: str, **kwds) -> "Href": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Href": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Href": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Href": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefstringExprRef], **kwds
+    ) -> "Href": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Href": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Href": ...
+
+    @overload
+    def format(self, _: str, **kwds) -> "Href": ...
+
+    @overload
+    def format(self, _: dict, **kwds) -> "Href": ...
+
+    @overload
+    def formatType(self, _: str, **kwds) -> "Href": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Href": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Href": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Href": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Href": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Href": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Href": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Href": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Href": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Href": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Href": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Href": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Href, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            format=format,
+            formatType=formatType,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class HrefValue(ValueChannelMixin, core.StringValueDefWithCondition):
+    """HrefValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, None, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "href"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "HrefValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "HrefValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "HrefValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "HrefValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "HrefValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "HrefValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefstringnullExprRef], **kwds
+    ) -> "HrefValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(HrefValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class Key(FieldChannelMixin, core.FieldDefWithoutScale):
+    """Key schema wrapper
+    Definition object for a data field, its type and transformation of an encoding channel.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "key"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Key": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Key": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Key": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Key": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Key": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Key": ...
+
+    @overload
+    def bin(self, _: str, **kwds) -> "Key": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Key": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Key": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Key": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Key": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Key": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Key": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Key": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Key": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Key": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Key": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Key": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Key": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Key": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Key": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Key, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class Latitude(FieldChannelMixin, core.LatLongFieldDef):
+    """Latitude schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : str
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "latitude"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Latitude": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Latitude": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Latitude": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Latitude": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Latitude": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Latitude": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Latitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Latitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Latitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Latitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Latitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Latitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Latitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Latitude": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Latitude": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Latitude": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Latitude": ...
+
+    @overload
+    def type(self, _: str, **kwds) -> "Latitude": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(Latitude, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class LatitudeDatum(DatumChannelMixin, core.DatumDef):
+    """LatitudeDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "latitude"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "LatitudeDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "LatitudeDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "LatitudeDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "LatitudeDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "LatitudeDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(LatitudeDatum, self).__init__(
+            datum=datum, bandPosition=bandPosition, title=title, type=type, **kwds
+        )
+
+
+@with_property_setters
+class Latitude2(FieldChannelMixin, core.SecondaryFieldDef):
+    """Latitude2 schema wrapper
+    A field definition of a secondary channel that shares a scale with another primary channel.
+    For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "latitude2"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Latitude2": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Latitude2": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Latitude2": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Latitude2": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Latitude2": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Latitude2": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Latitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Latitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Latitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Latitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Latitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Latitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Latitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Latitude2": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Latitude2": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Latitude2": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Latitude2": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Latitude2, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            **kwds,
+        )
+
+
+@with_property_setters
+class Latitude2Datum(DatumChannelMixin, core.DatumDef):
+    """Latitude2Datum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "latitude2"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Latitude2Datum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Latitude2Datum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Latitude2Datum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Latitude2Datum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "Latitude2Datum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Latitude2Datum, self).__init__(
+            datum=datum, bandPosition=bandPosition, title=title, type=type, **kwds
+        )
+
+
+@with_property_setters
+class Latitude2Value(ValueChannelMixin, core.PositionValueDef):
+    """Latitude2Value schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : str, dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "latitude2"
+
+    def __init__(self, value, **kwds):
+        super(Latitude2Value, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class Longitude(FieldChannelMixin, core.LatLongFieldDef):
+    """Longitude schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : str
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "longitude"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Longitude": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Longitude": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Longitude": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Longitude": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Longitude": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Longitude": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Longitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Longitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Longitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Longitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Longitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Longitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Longitude": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Longitude": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Longitude": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Longitude": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Longitude": ...
+
+    @overload
+    def type(self, _: str, **kwds) -> "Longitude": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(Longitude, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class LongitudeDatum(DatumChannelMixin, core.DatumDef):
+    """LongitudeDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "longitude"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "LongitudeDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "LongitudeDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "LongitudeDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "LongitudeDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "LongitudeDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(LongitudeDatum, self).__init__(
+            datum=datum, bandPosition=bandPosition, title=title, type=type, **kwds
+        )
+
+
+@with_property_setters
+class Longitude2(FieldChannelMixin, core.SecondaryFieldDef):
+    """Longitude2 schema wrapper
+    A field definition of a secondary channel that shares a scale with another primary channel.
+    For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "longitude2"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Longitude2": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Longitude2": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Longitude2": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Longitude2": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Longitude2": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Longitude2": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Longitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Longitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Longitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Longitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Longitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Longitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Longitude2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Longitude2": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Longitude2": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Longitude2": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Longitude2": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Longitude2, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            **kwds,
+        )
+
+
+@with_property_setters
+class Longitude2Datum(DatumChannelMixin, core.DatumDef):
+    """Longitude2Datum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "longitude2"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Longitude2Datum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Longitude2Datum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Longitude2Datum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Longitude2Datum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "Longitude2Datum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Longitude2Datum, self).__init__(
+            datum=datum, bandPosition=bandPosition, title=title, type=type, **kwds
+        )
+
+
+@with_property_setters
+class Longitude2Value(ValueChannelMixin, core.PositionValueDef):
+    """Longitude2Value schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : str, dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "longitude2"
+
+    def __init__(self, value, **kwds):
+        super(Longitude2Value, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class Opacity(
+    FieldChannelMixin, core.FieldOrDatumDefWithConditionMarkPropFieldDefnumber
+):
+    """Opacity schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "opacity"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Opacity": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Opacity": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Opacity": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Opacity": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Opacity": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "Opacity": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Opacity": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def legend(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        clipHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columnPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columns: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        direction: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        fillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        gradientLength: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientThickness: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["all", "each", "none"],
+            UndefinedType,
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            core.SchemaBase,
+            Literal[
+                "none",
+                "left",
+                "right",
+                "top",
+                "bottom",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rowPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        symbolDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolFillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolType: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[Literal["symbol", "gradient"], UndefinedType] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def legend(self, _: None, **kwds) -> "Opacity": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "Opacity": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "Opacity": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "Opacity": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "Opacity": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "Opacity": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Opacity": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "Opacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Opacity": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Opacity": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Opacity": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Opacity": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Opacity": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Opacity, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class OpacityDatum(DatumChannelMixin, core.FieldOrDatumDefWithConditionDatumDefnumber):
+    """OpacityDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "opacity"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "OpacityDatum": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "OpacityDatum": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "OpacityDatum": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "OpacityDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "OpacityDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "OpacityDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "OpacityDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "OpacityDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(OpacityDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            condition=condition,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class OpacityValue(
+    ValueChannelMixin, core.ValueDefWithConditionMarkPropFieldOrDatumDefnumber
+):
+    """OpacityValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "opacity"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "OpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "OpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "OpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "OpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "OpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "OpacityValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "OpacityValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(OpacityValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class Order(FieldChannelMixin, core.OrderFieldDef):
+    """Order schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    sort : :class:`SortOrder`, Literal['ascending', 'descending']
+        The sort order. One of ``"ascending"`` (default) or ``"descending"``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "order"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Order": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Order": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Order": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Order": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Order": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Order": ...
+
+    @overload
+    def bin(self, _: str, **kwds) -> "Order": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Order": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Order": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Order": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Order": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Order": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Order": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Order": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Order": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Order": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Order": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Order": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Order": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Order": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Order": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Order": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Order, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class OrderValue(ValueChannelMixin, core.OrderValueDef):
+    """OrderValue schema wrapper
+
+    Parameters
+    ----------
+
+    value : dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    condition : dict, :class:`ConditionalValueDefnumber`, :class:`ConditionalParameterValueDefnumber`, :class:`ConditionalPredicateValueDefnumber`, Sequence[dict, :class:`ConditionalValueDefnumber`, :class:`ConditionalParameterValueDefnumber`, :class:`ConditionalPredicateValueDefnumber`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "order"
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "OrderValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "OrderValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumber], **kwds
+    ) -> "OrderValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(OrderValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class Radius(FieldChannelMixin, core.PositionFieldDefBase):
+    """Radius schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    stack : bool, None, :class:`StackOffset`, Literal['zero', 'center', 'normalize']
+        Type of stacking offset if the field should be stacked. ``stack`` is only applicable
+        for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For
+        example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar
+        chart.
+
+        ``stack`` can be one of the following values:
+
+
+        * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale
+          (for creating typical stacked
+          [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area
+          <https://vega.github.io/vega-lite/docs/stack.html#area>`__ chart).
+        * ``"normalize"`` - stacking with normalized domain (for creating `normalized
+          stacked bar and area charts
+          <https://vega.github.io/vega-lite/docs/stack.html#normalized>`__ and pie charts
+          `with percentage tooltip
+          <https://vega.github.io/vega-lite/docs/arc.html#tooltip>`__ ). :raw-html:`<br/>`
+        * ``"center"`` - stacking with center baseline (for `streamgraph
+          <https://vega.github.io/vega-lite/docs/stack.html#streamgraph>`__ ).
+        * ``null`` or ``false`` - No-stacking. This will produce layered `bar
+          <https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart>`__ and area
+          chart.
+
+        **Default value:** ``zero`` for plots with all of the following conditions are true:
+        (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x
+        or y) has a linear scale; (3) At least one of non-position channels mapped to an
+        unaggregated field that is different from x and y. Otherwise, ``null`` by default.
+
+        **See also:** `stack <https://vega.github.io/vega-lite/docs/stack.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "radius"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Radius": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Radius": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Radius": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Radius": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def bin(self, _: str, **kwds) -> "Radius": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Radius": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Radius": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "Radius": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "Radius": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "Radius": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "Radius": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "Radius": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Radius": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "Radius": ...
+
+    @overload
+    def stack(self, _: Literal["zero", "center", "normalize"], **kwds) -> "Radius": ...
+
+    @overload
+    def stack(self, _: None, **kwds) -> "Radius": ...
+
+    @overload
+    def stack(self, _: bool, **kwds) -> "Radius": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Radius": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Radius": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Radius": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Radius": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Radius": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        stack: Union[
+            bool,
+            None,
+            core.SchemaBase,
+            Literal["zero", "center", "normalize"],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Radius, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            scale=scale,
+            sort=sort,
+            stack=stack,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class RadiusDatum(DatumChannelMixin, core.PositionDatumDefBase):
+    """RadiusDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    stack : bool, None, :class:`StackOffset`, Literal['zero', 'center', 'normalize']
+        Type of stacking offset if the field should be stacked. ``stack`` is only applicable
+        for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For
+        example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar
+        chart.
+
+        ``stack`` can be one of the following values:
+
+
+        * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale
+          (for creating typical stacked
+          [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area
+          <https://vega.github.io/vega-lite/docs/stack.html#area>`__ chart).
+        * ``"normalize"`` - stacking with normalized domain (for creating `normalized
+          stacked bar and area charts
+          <https://vega.github.io/vega-lite/docs/stack.html#normalized>`__ and pie charts
+          `with percentage tooltip
+          <https://vega.github.io/vega-lite/docs/arc.html#tooltip>`__ ). :raw-html:`<br/>`
+        * ``"center"`` - stacking with center baseline (for `streamgraph
+          <https://vega.github.io/vega-lite/docs/stack.html#streamgraph>`__ ).
+        * ``null`` or ``false`` - No-stacking. This will produce layered `bar
+          <https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart>`__ and area
+          chart.
+
+        **Default value:** ``zero`` for plots with all of the following conditions are true:
+        (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x
+        or y) has a linear scale; (3) At least one of non-position channels mapped to an
+        unaggregated field that is different from x and y. Otherwise, ``null`` by default.
+
+        **See also:** `stack <https://vega.github.io/vega-lite/docs/stack.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "radius"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "RadiusDatum": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "RadiusDatum": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "RadiusDatum": ...
+
+    @overload
+    def stack(
+        self, _: Literal["zero", "center", "normalize"], **kwds
+    ) -> "RadiusDatum": ...
+
+    @overload
+    def stack(self, _: None, **kwds) -> "RadiusDatum": ...
+
+    @overload
+    def stack(self, _: bool, **kwds) -> "RadiusDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "RadiusDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "RadiusDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "RadiusDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "RadiusDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        stack: Union[
+            bool,
+            None,
+            core.SchemaBase,
+            Literal["zero", "center", "normalize"],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(RadiusDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            scale=scale,
+            stack=stack,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class RadiusValue(ValueChannelMixin, core.PositionValueDef):
+    """RadiusValue schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : str, dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "radius"
+
+    def __init__(self, value, **kwds):
+        super(RadiusValue, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class Radius2(FieldChannelMixin, core.SecondaryFieldDef):
+    """Radius2 schema wrapper
+    A field definition of a secondary channel that shares a scale with another primary channel.
+    For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "radius2"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Radius2": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Radius2": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Radius2": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Radius2": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Radius2": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Radius2": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Radius2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Radius2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Radius2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Radius2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Radius2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Radius2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Radius2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Radius2": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Radius2": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Radius2": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Radius2": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Radius2, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            **kwds,
+        )
+
+
+@with_property_setters
+class Radius2Datum(DatumChannelMixin, core.DatumDef):
+    """Radius2Datum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "radius2"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Radius2Datum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Radius2Datum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Radius2Datum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Radius2Datum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "Radius2Datum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Radius2Datum, self).__init__(
+            datum=datum, bandPosition=bandPosition, title=title, type=type, **kwds
+        )
+
+
+@with_property_setters
+class Radius2Value(ValueChannelMixin, core.PositionValueDef):
+    """Radius2Value schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : str, dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "radius2"
+
+    def __init__(self, value, **kwds):
+        super(Radius2Value, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class Row(FieldChannelMixin, core.RowColumnEncodingFieldDef):
+    """Row schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    align : :class:`LayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to row/column facet's subplot. The supported string values
+        are ``"all"``, ``"each"``, and ``"none"``.
+
+
+        * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply
+          placed one after the other.
+        * For ``"each"``, subviews will be aligned into a clean grid structure, but each row
+          or column may be of variable size.
+        * For ``"all"``, subviews will be aligned and each row or column will be sized
+          identically based on the maximum observed size. String values for this property
+          will be applied to both grid rows and columns.
+
+        **Default value:** ``"all"``.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    center : bool
+        Boolean flag indicating if facet's subviews should be centered relative to their
+        respective rows or columns.
+
+        **Default value:** ``false``
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    header : dict, None, :class:`Header`
+        An object defining properties of a facet's header.
+    sort : dict, None, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`EncodingSortField`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` is not supported for ``row`` and ``column``.
+    spacing : float
+        The spacing in pixels between facet's sub-views.
+
+        **Default value** : Depends on ``"spacing"`` property of `the view composition
+        configuration <https://vega.github.io/vega-lite/docs/config.html#view-config>`__ (
+        ``20`` by default)
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "row"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Row": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Row": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Row": ...
+
+    @overload
+    def align(self, _: Literal["all", "each", "none"], **kwds) -> "Row": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Row": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Row": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Row": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Row": ...
+
+    @overload
+    def center(self, _: bool, **kwds) -> "Row": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Row": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Row": ...
+
+    @overload
+    def header(
+        self,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelAnchor: Union[
+            core.SchemaBase, Literal[None, "start", "middle", "end"], UndefinedType
+        ] = Undefined,
+        labelAngle: Union[float, UndefinedType] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOrient: Union[
+            core.SchemaBase, Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labels: Union[bool, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            core.SchemaBase, Literal[None, "start", "middle", "end"], UndefinedType
+        ] = Undefined,
+        titleAngle: Union[float, UndefinedType] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            core.SchemaBase, Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Row": ...
+
+    @overload
+    def header(self, _: None, **kwds) -> "Row": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "Row": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "Row": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "Row": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "Row": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Row": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Row": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "Row": ...
+
+    @overload
+    def spacing(self, _: float, **kwds) -> "Row": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Row": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Row": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Row": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Row": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Row": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Row": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Row": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Row": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Row": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Row": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Row": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        align: Union[
+            core.SchemaBase, Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        center: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        header: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        spacing: Union[float, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Row, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            align=align,
+            bandPosition=bandPosition,
+            bin=bin,
+            center=center,
+            field=field,
+            header=header,
+            sort=sort,
+            spacing=spacing,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class Shape(
+    FieldChannelMixin,
+    core.FieldOrDatumDefWithConditionMarkPropFieldDefTypeForShapestringnull,
+):
+    """Shape schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`TypeForShape`, Literal['nominal', 'ordinal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "shape"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Shape": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Shape": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Shape": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Shape": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Shape": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefstringnullExprRef], **kwds
+    ) -> "Shape": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Shape": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def legend(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        clipHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columnPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columns: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        direction: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        fillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        gradientLength: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientThickness: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["all", "each", "none"],
+            UndefinedType,
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            core.SchemaBase,
+            Literal[
+                "none",
+                "left",
+                "right",
+                "top",
+                "bottom",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rowPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        symbolDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolFillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolType: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[Literal["symbol", "gradient"], UndefinedType] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def legend(self, _: None, **kwds) -> "Shape": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "Shape": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "Shape": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "Shape": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "Shape": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "Shape": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Shape": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "Shape": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Shape": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Shape": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Shape": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Shape": ...
+
+    @overload
+    def type(self, _: Literal["nominal", "ordinal", "geojson"], **kwds) -> "Shape": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase, Literal["nominal", "ordinal", "geojson"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Shape, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class ShapeDatum(
+    DatumChannelMixin, core.FieldOrDatumDefWithConditionDatumDefstringnull
+):
+    """ShapeDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "shape"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "ShapeDatum": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "ShapeDatum": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "ShapeDatum": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefstringnullExprRef], **kwds
+    ) -> "ShapeDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "ShapeDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "ShapeDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "ShapeDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "ShapeDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ShapeDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            condition=condition,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class ShapeValue(
+    ValueChannelMixin,
+    core.ValueDefWithConditionMarkPropFieldOrDatumDefTypeForShapestringnull,
+):
+    """ShapeValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`, :class:`ConditionalMarkPropFieldOrDatumDefTypeForShape`, :class:`ConditionalParameterMarkPropFieldOrDatumDefTypeForShape`, :class:`ConditionalPredicateMarkPropFieldOrDatumDefTypeForShape`, Sequence[dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, None, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "shape"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase, Literal["nominal", "ordinal", "geojson"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "ShapeValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "ShapeValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase, Literal["nominal", "ordinal", "geojson"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "ShapeValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "ShapeValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "ShapeValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "ShapeValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefstringnullExprRef], **kwds
+    ) -> "ShapeValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ShapeValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class Size(FieldChannelMixin, core.FieldOrDatumDefWithConditionMarkPropFieldDefnumber):
+    """Size schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "size"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Size": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Size": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Size": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Size": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Size": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "Size": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Size": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def legend(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        clipHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columnPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columns: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        direction: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        fillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        gradientLength: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientThickness: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["all", "each", "none"],
+            UndefinedType,
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            core.SchemaBase,
+            Literal[
+                "none",
+                "left",
+                "right",
+                "top",
+                "bottom",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rowPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        symbolDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolFillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolType: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[Literal["symbol", "gradient"], UndefinedType] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def legend(self, _: None, **kwds) -> "Size": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "Size": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "Size": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "Size": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "Size": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "Size": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Size": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "Size": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Size": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Size": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Size": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Size": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Size": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Size, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class SizeDatum(DatumChannelMixin, core.FieldOrDatumDefWithConditionDatumDefnumber):
+    """SizeDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "size"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "SizeDatum": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "SizeDatum": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "SizeDatum": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "SizeDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "SizeDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "SizeDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "SizeDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "SizeDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(SizeDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            condition=condition,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class SizeValue(
+    ValueChannelMixin, core.ValueDefWithConditionMarkPropFieldOrDatumDefnumber
+):
+    """SizeValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "size"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "SizeValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "SizeValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "SizeValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "SizeValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "SizeValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "SizeValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "SizeValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(SizeValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class Stroke(
+    FieldChannelMixin,
+    core.FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull,
+):
+    """Stroke schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "stroke"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Stroke": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Stroke": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Stroke": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Stroke": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Stroke": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefGradientstringnullExprRef], **kwds
+    ) -> "Stroke": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Stroke": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def legend(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        clipHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columnPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columns: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        direction: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        fillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        gradientLength: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientThickness: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["all", "each", "none"],
+            UndefinedType,
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            core.SchemaBase,
+            Literal[
+                "none",
+                "left",
+                "right",
+                "top",
+                "bottom",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rowPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        symbolDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolFillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolType: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[Literal["symbol", "gradient"], UndefinedType] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def legend(self, _: None, **kwds) -> "Stroke": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "Stroke": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "Stroke": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "Stroke": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "Stroke": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "Stroke": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Stroke": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "Stroke": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Stroke": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Stroke": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Stroke": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Stroke": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Stroke": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Stroke, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class StrokeDatum(
+    DatumChannelMixin, core.FieldOrDatumDefWithConditionDatumDefGradientstringnull
+):
+    """StrokeDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "stroke"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "StrokeDatum": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDatum": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDatum": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefGradientstringnullExprRef], **kwds
+    ) -> "StrokeDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "StrokeDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "StrokeDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "StrokeDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "StrokeDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StrokeDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            condition=condition,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class StrokeValue(
+    ValueChannelMixin,
+    core.ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull,
+):
+    """StrokeValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, None, :class:`ExprRef`, :class:`Gradient`, :class:`LinearGradient`, :class:`RadialGradient`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "stroke"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefGradientstringnullExprRef], **kwds
+    ) -> "StrokeValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StrokeValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class StrokeDash(
+    FieldChannelMixin, core.FieldOrDatumDefWithConditionMarkPropFieldDefnumberArray
+):
+    """StrokeDash schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefnumberArrayExprRef`, :class:`ConditionalParameterValueDefnumberArrayExprRef`, :class:`ConditionalPredicateValueDefnumberArrayExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberArrayExprRef`, :class:`ConditionalParameterValueDefnumberArrayExprRef`, :class:`ConditionalPredicateValueDefnumberArrayExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "strokeDash"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "StrokeDash": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "StrokeDash": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "StrokeDash": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "StrokeDash": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "StrokeDash": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberArrayExprRef], **kwds
+    ) -> "StrokeDash": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "StrokeDash": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def legend(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        clipHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columnPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columns: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        direction: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        fillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        gradientLength: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientThickness: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["all", "each", "none"],
+            UndefinedType,
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            core.SchemaBase,
+            Literal[
+                "none",
+                "left",
+                "right",
+                "top",
+                "bottom",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rowPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        symbolDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolFillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolType: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[Literal["symbol", "gradient"], UndefinedType] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def legend(self, _: None, **kwds) -> "StrokeDash": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "StrokeDash": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "StrokeDash": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "StrokeDash": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "StrokeDash": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "StrokeDash": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "StrokeDash": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "StrokeDash": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "StrokeDash": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "StrokeDash": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "StrokeDash": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "StrokeDash": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "StrokeDash": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StrokeDash, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class StrokeDashDatum(
+    DatumChannelMixin, core.FieldOrDatumDefWithConditionDatumDefnumberArray
+):
+    """StrokeDashDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefnumberArrayExprRef`, :class:`ConditionalParameterValueDefnumberArrayExprRef`, :class:`ConditionalPredicateValueDefnumberArrayExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberArrayExprRef`, :class:`ConditionalParameterValueDefnumberArrayExprRef`, :class:`ConditionalPredicateValueDefnumberArrayExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "strokeDash"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "StrokeDashDatum": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDashDatum": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDashDatum": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberArrayExprRef], **kwds
+    ) -> "StrokeDashDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "StrokeDashDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "StrokeDashDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "StrokeDashDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "StrokeDashDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StrokeDashDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            condition=condition,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class StrokeDashValue(
+    ValueChannelMixin, core.ValueDefWithConditionMarkPropFieldOrDatumDefnumberArray
+):
+    """StrokeDashValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefnumberArrayExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefnumberArrayExprRef`, :class:`ConditionalPredicateValueDefnumberArrayExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberArrayExprRef`, :class:`ConditionalParameterValueDefnumberArrayExprRef`, :class:`ConditionalPredicateValueDefnumberArrayExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : dict, Sequence[float], :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "strokeDash"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDashValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDashValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDashValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDashValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDashValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeDashValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberArrayExprRef], **kwds
+    ) -> "StrokeDashValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StrokeDashValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class StrokeOpacity(
+    FieldChannelMixin, core.FieldOrDatumDefWithConditionMarkPropFieldDefnumber
+):
+    """StrokeOpacity schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "strokeOpacity"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def legend(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        clipHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columnPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columns: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        direction: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        fillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        gradientLength: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientThickness: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["all", "each", "none"],
+            UndefinedType,
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            core.SchemaBase,
+            Literal[
+                "none",
+                "left",
+                "right",
+                "top",
+                "bottom",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rowPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        symbolDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolFillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolType: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[Literal["symbol", "gradient"], UndefinedType] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def legend(self, _: None, **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def sort(
+        self, _: Literal["ascending", "descending"], **kwds
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacity": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "StrokeOpacity": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "StrokeOpacity": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StrokeOpacity, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class StrokeOpacityDatum(
+    DatumChannelMixin, core.FieldOrDatumDefWithConditionDatumDefnumber
+):
+    """StrokeOpacityDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "strokeOpacity"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "StrokeOpacityDatum": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacityDatum": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacityDatum": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "StrokeOpacityDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "StrokeOpacityDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "StrokeOpacityDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "StrokeOpacityDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "StrokeOpacityDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StrokeOpacityDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            condition=condition,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class StrokeOpacityValue(
+    ValueChannelMixin, core.ValueDefWithConditionMarkPropFieldOrDatumDefnumber
+):
+    """StrokeOpacityValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "strokeOpacity"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacityValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeOpacityValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "StrokeOpacityValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StrokeOpacityValue, self).__init__(
+            value=value, condition=condition, **kwds
+        )
+
+
+@with_property_setters
+class StrokeWidth(
+    FieldChannelMixin, core.FieldOrDatumDefWithConditionMarkPropFieldDefnumber
+):
+    """StrokeWidth schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "strokeWidth"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def legend(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        clipHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columnPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        columns: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        direction: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        fillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        gradientLength: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gradientThickness: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["all", "each", "none"],
+            UndefinedType,
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        legendY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            core.SchemaBase,
+            Literal[
+                "none",
+                "left",
+                "right",
+                "top",
+                "bottom",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rowPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        symbolDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolFillColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolStrokeColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolStrokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        symbolType: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[Literal["symbol", "gradient"], UndefinedType] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def legend(self, _: None, **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "StrokeWidth": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "StrokeWidth": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "StrokeWidth": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StrokeWidth, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class StrokeWidthDatum(
+    DatumChannelMixin, core.FieldOrDatumDefWithConditionDatumDefnumber
+):
+    """StrokeWidthDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "strokeWidth"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "StrokeWidthDatum": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidthDatum": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidthDatum": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "StrokeWidthDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "StrokeWidthDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "StrokeWidthDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "StrokeWidthDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "StrokeWidthDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StrokeWidthDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            condition=condition,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class StrokeWidthValue(
+    ValueChannelMixin, core.ValueDefWithConditionMarkPropFieldOrDatumDefnumber
+):
+    """StrokeWidthValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "strokeWidth"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidthValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidthValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidthValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidthValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidthValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "StrokeWidthValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefnumberExprRef], **kwds
+    ) -> "StrokeWidthValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StrokeWidthValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class Text(FieldChannelMixin, core.FieldOrDatumDefWithConditionStringFieldDefText):
+    """Text schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefTextExprRef`, :class:`ConditionalParameterValueDefTextExprRef`, :class:`ConditionalPredicateValueDefTextExprRef`, Sequence[dict, :class:`ConditionalValueDefTextExprRef`, :class:`ConditionalParameterValueDefTextExprRef`, :class:`ConditionalPredicateValueDefTextExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "text"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Text": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Text": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Text": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Text": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Text": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Text": ...
+
+    @overload
+    def bin(self, _: str, **kwds) -> "Text": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Text": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Text": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Text": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefTextExprRef], **kwds
+    ) -> "Text": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Text": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Text": ...
+
+    @overload
+    def format(self, _: str, **kwds) -> "Text": ...
+
+    @overload
+    def format(self, _: dict, **kwds) -> "Text": ...
+
+    @overload
+    def formatType(self, _: str, **kwds) -> "Text": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Text": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Text": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Text": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Text": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Text": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Text": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Text": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Text": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Text": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Text": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Text": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Text, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            format=format,
+            formatType=formatType,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class TextDatum(DatumChannelMixin, core.FieldOrDatumDefWithConditionStringDatumDefText):
+    """TextDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefTextExprRef`, :class:`ConditionalParameterValueDefTextExprRef`, :class:`ConditionalPredicateValueDefTextExprRef`, Sequence[dict, :class:`ConditionalValueDefTextExprRef`, :class:`ConditionalParameterValueDefTextExprRef`, :class:`ConditionalPredicateValueDefTextExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "text"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "TextDatum": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "TextDatum": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "TextDatum": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefTextExprRef], **kwds
+    ) -> "TextDatum": ...
+
+    @overload
+    def format(self, _: str, **kwds) -> "TextDatum": ...
+
+    @overload
+    def format(self, _: dict, **kwds) -> "TextDatum": ...
+
+    @overload
+    def formatType(self, _: str, **kwds) -> "TextDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "TextDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "TextDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "TextDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "TextDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(TextDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            condition=condition,
+            format=format,
+            formatType=formatType,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class TextValue(ValueChannelMixin, core.ValueDefWithConditionStringFieldDefText):
+    """TextValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalStringFieldDef`, :class:`ConditionalValueDefTextExprRef`, :class:`ConditionalParameterStringFieldDef`, :class:`ConditionalPredicateStringFieldDef`, :class:`ConditionalParameterValueDefTextExprRef`, :class:`ConditionalPredicateValueDefTextExprRef`, Sequence[dict, :class:`ConditionalValueDefTextExprRef`, :class:`ConditionalParameterValueDefTextExprRef`, :class:`ConditionalPredicateValueDefTextExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, :class:`Text`, Sequence[str], :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "text"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "TextValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "TextValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "TextValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "TextValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefTextExprRef], **kwds
+    ) -> "TextValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(TextValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class Theta(FieldChannelMixin, core.PositionFieldDefBase):
+    """Theta schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    stack : bool, None, :class:`StackOffset`, Literal['zero', 'center', 'normalize']
+        Type of stacking offset if the field should be stacked. ``stack`` is only applicable
+        for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For
+        example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar
+        chart.
+
+        ``stack`` can be one of the following values:
+
+
+        * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale
+          (for creating typical stacked
+          [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area
+          <https://vega.github.io/vega-lite/docs/stack.html#area>`__ chart).
+        * ``"normalize"`` - stacking with normalized domain (for creating `normalized
+          stacked bar and area charts
+          <https://vega.github.io/vega-lite/docs/stack.html#normalized>`__ and pie charts
+          `with percentage tooltip
+          <https://vega.github.io/vega-lite/docs/arc.html#tooltip>`__ ). :raw-html:`<br/>`
+        * ``"center"`` - stacking with center baseline (for `streamgraph
+          <https://vega.github.io/vega-lite/docs/stack.html#streamgraph>`__ ).
+        * ``null`` or ``false`` - No-stacking. This will produce layered `bar
+          <https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart>`__ and area
+          chart.
+
+        **Default value:** ``zero`` for plots with all of the following conditions are true:
+        (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x
+        or y) has a linear scale; (3) At least one of non-position channels mapped to an
+        unaggregated field that is different from x and y. Otherwise, ``null`` by default.
+
+        **See also:** `stack <https://vega.github.io/vega-lite/docs/stack.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "theta"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Theta": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Theta": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Theta": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Theta": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def bin(self, _: str, **kwds) -> "Theta": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Theta": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Theta": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "Theta": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "Theta": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "Theta": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "Theta": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "Theta": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Theta": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "Theta": ...
+
+    @overload
+    def stack(self, _: Literal["zero", "center", "normalize"], **kwds) -> "Theta": ...
+
+    @overload
+    def stack(self, _: None, **kwds) -> "Theta": ...
+
+    @overload
+    def stack(self, _: bool, **kwds) -> "Theta": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Theta": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Theta": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Theta": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Theta": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Theta": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        stack: Union[
+            bool,
+            None,
+            core.SchemaBase,
+            Literal["zero", "center", "normalize"],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Theta, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            scale=scale,
+            sort=sort,
+            stack=stack,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class ThetaDatum(DatumChannelMixin, core.PositionDatumDefBase):
+    """ThetaDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    stack : bool, None, :class:`StackOffset`, Literal['zero', 'center', 'normalize']
+        Type of stacking offset if the field should be stacked. ``stack`` is only applicable
+        for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For
+        example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar
+        chart.
+
+        ``stack`` can be one of the following values:
+
+
+        * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale
+          (for creating typical stacked
+          [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area
+          <https://vega.github.io/vega-lite/docs/stack.html#area>`__ chart).
+        * ``"normalize"`` - stacking with normalized domain (for creating `normalized
+          stacked bar and area charts
+          <https://vega.github.io/vega-lite/docs/stack.html#normalized>`__ and pie charts
+          `with percentage tooltip
+          <https://vega.github.io/vega-lite/docs/arc.html#tooltip>`__ ). :raw-html:`<br/>`
+        * ``"center"`` - stacking with center baseline (for `streamgraph
+          <https://vega.github.io/vega-lite/docs/stack.html#streamgraph>`__ ).
+        * ``null`` or ``false`` - No-stacking. This will produce layered `bar
+          <https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart>`__ and area
+          chart.
+
+        **Default value:** ``zero`` for plots with all of the following conditions are true:
+        (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x
+        or y) has a linear scale; (3) At least one of non-position channels mapped to an
+        unaggregated field that is different from x and y. Otherwise, ``null`` by default.
+
+        **See also:** `stack <https://vega.github.io/vega-lite/docs/stack.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "theta"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "ThetaDatum": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "ThetaDatum": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "ThetaDatum": ...
+
+    @overload
+    def stack(
+        self, _: Literal["zero", "center", "normalize"], **kwds
+    ) -> "ThetaDatum": ...
+
+    @overload
+    def stack(self, _: None, **kwds) -> "ThetaDatum": ...
+
+    @overload
+    def stack(self, _: bool, **kwds) -> "ThetaDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "ThetaDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "ThetaDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "ThetaDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "ThetaDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        stack: Union[
+            bool,
+            None,
+            core.SchemaBase,
+            Literal["zero", "center", "normalize"],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ThetaDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            scale=scale,
+            stack=stack,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class ThetaValue(ValueChannelMixin, core.PositionValueDef):
+    """ThetaValue schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : str, dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "theta"
+
+    def __init__(self, value, **kwds):
+        super(ThetaValue, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class Theta2(FieldChannelMixin, core.SecondaryFieldDef):
+    """Theta2 schema wrapper
+    A field definition of a secondary channel that shares a scale with another primary channel.
+    For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "theta2"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Theta2": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Theta2": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Theta2": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Theta2": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Theta2": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Theta2": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Theta2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Theta2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Theta2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Theta2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Theta2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Theta2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Theta2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Theta2": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Theta2": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Theta2": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Theta2": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Theta2, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            **kwds,
+        )
+
+
+@with_property_setters
+class Theta2Datum(DatumChannelMixin, core.DatumDef):
+    """Theta2Datum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "theta2"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Theta2Datum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Theta2Datum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Theta2Datum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Theta2Datum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "Theta2Datum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Theta2Datum, self).__init__(
+            datum=datum, bandPosition=bandPosition, title=title, type=type, **kwds
+        )
+
+
+@with_property_setters
+class Theta2Value(ValueChannelMixin, core.PositionValueDef):
+    """Theta2Value schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : str, dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "theta2"
+
+    def __init__(self, value, **kwds):
+        super(Theta2Value, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class Tooltip(FieldChannelMixin, core.StringFieldDefWithCondition):
+    """Tooltip schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefstringExprRef`, :class:`ConditionalParameterValueDefstringExprRef`, :class:`ConditionalPredicateValueDefstringExprRef`, Sequence[dict, :class:`ConditionalValueDefstringExprRef`, :class:`ConditionalParameterValueDefstringExprRef`, :class:`ConditionalPredicateValueDefstringExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "tooltip"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Tooltip": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Tooltip": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Tooltip": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Tooltip": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Tooltip": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Tooltip": ...
+
+    @overload
+    def bin(self, _: str, **kwds) -> "Tooltip": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Tooltip": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Tooltip": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Tooltip": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefstringExprRef], **kwds
+    ) -> "Tooltip": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Tooltip": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Tooltip": ...
+
+    @overload
+    def format(self, _: str, **kwds) -> "Tooltip": ...
+
+    @overload
+    def format(self, _: dict, **kwds) -> "Tooltip": ...
+
+    @overload
+    def formatType(self, _: str, **kwds) -> "Tooltip": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Tooltip": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Tooltip": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Tooltip": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Tooltip": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Tooltip": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Tooltip": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Tooltip": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Tooltip": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Tooltip": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Tooltip": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Tooltip": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Tooltip, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            format=format,
+            formatType=formatType,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class TooltipValue(ValueChannelMixin, core.StringValueDefWithCondition):
+    """TooltipValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, None, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "tooltip"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "TooltipValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "TooltipValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "TooltipValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "TooltipValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "TooltipValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "TooltipValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefstringnullExprRef], **kwds
+    ) -> "TooltipValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(TooltipValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class Url(FieldChannelMixin, core.StringFieldDefWithCondition):
+    """Url schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefstringExprRef`, :class:`ConditionalParameterValueDefstringExprRef`, :class:`ConditionalPredicateValueDefstringExprRef`, Sequence[dict, :class:`ConditionalValueDefstringExprRef`, :class:`ConditionalParameterValueDefstringExprRef`, :class:`ConditionalPredicateValueDefstringExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "url"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Url": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Url": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Url": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Url": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Url": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Url": ...
+
+    @overload
+    def bin(self, _: str, **kwds) -> "Url": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Url": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Url": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Url": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefstringExprRef], **kwds
+    ) -> "Url": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Url": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Url": ...
+
+    @overload
+    def format(self, _: str, **kwds) -> "Url": ...
+
+    @overload
+    def format(self, _: dict, **kwds) -> "Url": ...
+
+    @overload
+    def formatType(self, _: str, **kwds) -> "Url": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Url": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Url": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Url": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Url": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Url": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Url": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Url": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Url": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Url": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Url": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Url": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Url, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            format=format,
+            formatType=formatType,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class UrlValue(ValueChannelMixin, core.StringValueDefWithCondition):
+    """UrlValue schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, None, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "url"
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "UrlValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "UrlValue": ...
+
+    @overload
+    def condition(
+        self,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "UrlValue": ...
+
+    @overload
+    def condition(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        legend: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ) -> "UrlValue": ...
+
+    @overload
+    def condition(
+        self,
+        test: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "UrlValue": ...
+
+    @overload
+    def condition(
+        self,
+        empty: Union[bool, UndefinedType] = Undefined,
+        param: Union[str, core.SchemaBase, UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "UrlValue": ...
+
+    @overload
+    def condition(
+        self, _: List[core.ConditionalValueDefstringnullExprRef], **kwds
+    ) -> "UrlValue": ...
+
+    def __init__(
+        self,
+        value,
+        condition: Union[
+            dict, core.SchemaBase, Sequence[Union[dict, core.SchemaBase]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(UrlValue, self).__init__(value=value, condition=condition, **kwds)
+
+
+@with_property_setters
+class X(FieldChannelMixin, core.PositionFieldDef):
+    """X schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    axis : dict, None, :class:`Axis`
+        An object defining properties of axis's gridlines, ticks and labels. If ``null``,
+        the axis for the encoding channel will be removed.
+
+        **Default value:** If undefined, default `axis properties
+        <https://vega.github.io/vega-lite/docs/axis.html>`__ are applied.
+
+        **See also:** `axis <https://vega.github.io/vega-lite/docs/axis.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    impute : dict, None, :class:`ImputeParams`
+        An object defining the properties of the Impute Operation to be applied. The field
+        value of the other positional channel is taken as ``key`` of the ``Impute``
+        Operation. The field of the ``color`` channel if specified is used as ``groupby`` of
+        the ``Impute`` Operation.
+
+        **See also:** `impute <https://vega.github.io/vega-lite/docs/impute.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    stack : bool, None, :class:`StackOffset`, Literal['zero', 'center', 'normalize']
+        Type of stacking offset if the field should be stacked. ``stack`` is only applicable
+        for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For
+        example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar
+        chart.
+
+        ``stack`` can be one of the following values:
+
+
+        * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale
+          (for creating typical stacked
+          [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area
+          <https://vega.github.io/vega-lite/docs/stack.html#area>`__ chart).
+        * ``"normalize"`` - stacking with normalized domain (for creating `normalized
+          stacked bar and area charts
+          <https://vega.github.io/vega-lite/docs/stack.html#normalized>`__ and pie charts
+          `with percentage tooltip
+          <https://vega.github.io/vega-lite/docs/arc.html#tooltip>`__ ). :raw-html:`<br/>`
+        * ``"center"`` - stacking with center baseline (for `streamgraph
+          <https://vega.github.io/vega-lite/docs/stack.html#streamgraph>`__ ).
+        * ``null`` or ``false`` - No-stacking. This will produce layered `bar
+          <https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart>`__ and area
+          chart.
+
+        **Default value:** ``zero`` for plots with all of the following conditions are true:
+        (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x
+        or y) has a linear scale; (3) At least one of non-position channels mapped to an
+        unaggregated field that is different from x and y. Otherwise, ``null`` by default.
+
+        **See also:** `stack <https://vega.github.io/vega-lite/docs/stack.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "x"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "X": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "X": ...
+
+    @overload
+    def axis(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandPosition: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[bool, UndefinedType] = Undefined,
+        domainCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        domainColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        domainDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        grid: Union[bool, UndefinedType] = Undefined,
+        gridCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        gridColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gridDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        gridDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelBound: Union[
+            bool, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFlush: Union[bool, float, UndefinedType] = Undefined,
+        labelFlushOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labels: Union[bool, UndefinedType] = Undefined,
+        maxExtent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minExtent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "bottom", "left", "right"],
+            UndefinedType,
+        ] = Undefined,
+        position: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tickBand: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["center", "extent"],
+            UndefinedType,
+        ] = Undefined,
+        tickCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        tickColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        tickDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickExtra: Union[bool, UndefinedType] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickRound: Union[bool, UndefinedType] = Undefined,
+        tickSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ticks: Union[bool, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        translate: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def axis(self, _: None, **kwds) -> "X": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "X": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "X": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def bin(self, _: str, **kwds) -> "X": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "X": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "X": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def impute(
+        self,
+        frame: Union[Sequence[Union[None, float]], UndefinedType] = Undefined,
+        keyvals: Union[dict, Sequence[Any], core.SchemaBase, UndefinedType] = Undefined,
+        method: Union[
+            core.SchemaBase,
+            Literal["value", "median", "max", "min", "mean"],
+            UndefinedType,
+        ] = Undefined,
+        value: Union[Any, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def impute(self, _: None, **kwds) -> "X": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "X": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "X": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "X": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "X": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "X": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "X": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "X": ...
+
+    @overload
+    def stack(self, _: Literal["zero", "center", "normalize"], **kwds) -> "X": ...
+
+    @overload
+    def stack(self, _: None, **kwds) -> "X": ...
+
+    @overload
+    def stack(self, _: bool, **kwds) -> "X": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "X": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "X": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "X": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "X": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "X": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        axis: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        impute: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        stack: Union[
+            bool,
+            None,
+            core.SchemaBase,
+            Literal["zero", "center", "normalize"],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(X, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            axis=axis,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            impute=impute,
+            scale=scale,
+            sort=sort,
+            stack=stack,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class XDatum(DatumChannelMixin, core.PositionDatumDef):
+    """XDatum schema wrapper
+
+    Parameters
+    ----------
+
+    axis : dict, None, :class:`Axis`
+        An object defining properties of axis's gridlines, ticks and labels. If ``null``,
+        the axis for the encoding channel will be removed.
+
+        **Default value:** If undefined, default `axis properties
+        <https://vega.github.io/vega-lite/docs/axis.html>`__ are applied.
+
+        **See also:** `axis <https://vega.github.io/vega-lite/docs/axis.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    impute : dict, None, :class:`ImputeParams`
+        An object defining the properties of the Impute Operation to be applied. The field
+        value of the other positional channel is taken as ``key`` of the ``Impute``
+        Operation. The field of the ``color`` channel if specified is used as ``groupby`` of
+        the ``Impute`` Operation.
+
+        **See also:** `impute <https://vega.github.io/vega-lite/docs/impute.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    stack : bool, None, :class:`StackOffset`, Literal['zero', 'center', 'normalize']
+        Type of stacking offset if the field should be stacked. ``stack`` is only applicable
+        for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For
+        example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar
+        chart.
+
+        ``stack`` can be one of the following values:
+
+
+        * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale
+          (for creating typical stacked
+          [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area
+          <https://vega.github.io/vega-lite/docs/stack.html#area>`__ chart).
+        * ``"normalize"`` - stacking with normalized domain (for creating `normalized
+          stacked bar and area charts
+          <https://vega.github.io/vega-lite/docs/stack.html#normalized>`__ and pie charts
+          `with percentage tooltip
+          <https://vega.github.io/vega-lite/docs/arc.html#tooltip>`__ ). :raw-html:`<br/>`
+        * ``"center"`` - stacking with center baseline (for `streamgraph
+          <https://vega.github.io/vega-lite/docs/stack.html#streamgraph>`__ ).
+        * ``null`` or ``false`` - No-stacking. This will produce layered `bar
+          <https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart>`__ and area
+          chart.
+
+        **Default value:** ``zero`` for plots with all of the following conditions are true:
+        (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x
+        or y) has a linear scale; (3) At least one of non-position channels mapped to an
+        unaggregated field that is different from x and y. Otherwise, ``null`` by default.
+
+        **See also:** `stack <https://vega.github.io/vega-lite/docs/stack.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "x"
+
+    @overload
+    def axis(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandPosition: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[bool, UndefinedType] = Undefined,
+        domainCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        domainColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        domainDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        grid: Union[bool, UndefinedType] = Undefined,
+        gridCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        gridColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gridDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        gridDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelBound: Union[
+            bool, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFlush: Union[bool, float, UndefinedType] = Undefined,
+        labelFlushOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labels: Union[bool, UndefinedType] = Undefined,
+        maxExtent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minExtent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "bottom", "left", "right"],
+            UndefinedType,
+        ] = Undefined,
+        position: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tickBand: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["center", "extent"],
+            UndefinedType,
+        ] = Undefined,
+        tickCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        tickColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        tickDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickExtra: Union[bool, UndefinedType] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickRound: Union[bool, UndefinedType] = Undefined,
+        tickSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ticks: Union[bool, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        translate: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "XDatum": ...
+
+    @overload
+    def axis(self, _: None, **kwds) -> "XDatum": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "XDatum": ...
+
+    @overload
+    def impute(
+        self,
+        frame: Union[Sequence[Union[None, float]], UndefinedType] = Undefined,
+        keyvals: Union[dict, Sequence[Any], core.SchemaBase, UndefinedType] = Undefined,
+        method: Union[
+            core.SchemaBase,
+            Literal["value", "median", "max", "min", "mean"],
+            UndefinedType,
+        ] = Undefined,
+        value: Union[Any, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "XDatum": ...
+
+    @overload
+    def impute(self, _: None, **kwds) -> "XDatum": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "XDatum": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "XDatum": ...
+
+    @overload
+    def stack(self, _: Literal["zero", "center", "normalize"], **kwds) -> "XDatum": ...
+
+    @overload
+    def stack(self, _: None, **kwds) -> "XDatum": ...
+
+    @overload
+    def stack(self, _: bool, **kwds) -> "XDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "XDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "XDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "XDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "XDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        axis: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        impute: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        stack: Union[
+            bool,
+            None,
+            core.SchemaBase,
+            Literal["zero", "center", "normalize"],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(XDatum, self).__init__(
+            datum=datum,
+            axis=axis,
+            bandPosition=bandPosition,
+            impute=impute,
+            scale=scale,
+            stack=stack,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class XValue(ValueChannelMixin, core.PositionValueDef):
+    """XValue schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : str, dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "x"
+
+    def __init__(self, value, **kwds):
+        super(XValue, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class X2(FieldChannelMixin, core.SecondaryFieldDef):
+    """X2 schema wrapper
+    A field definition of a secondary channel that shares a scale with another primary channel.
+    For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "x2"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "X2": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "X2": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "X2": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "X2": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "X2": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "X2": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "X2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "X2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "X2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "X2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "X2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "X2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "X2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "X2": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "X2": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "X2": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "X2": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(X2, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            **kwds,
+        )
+
+
+@with_property_setters
+class X2Datum(DatumChannelMixin, core.DatumDef):
+    """X2Datum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "x2"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "X2Datum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "X2Datum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "X2Datum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "X2Datum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "X2Datum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(X2Datum, self).__init__(
+            datum=datum, bandPosition=bandPosition, title=title, type=type, **kwds
+        )
+
+
+@with_property_setters
+class X2Value(ValueChannelMixin, core.PositionValueDef):
+    """X2Value schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : str, dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "x2"
+
+    def __init__(self, value, **kwds):
+        super(X2Value, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class XError(FieldChannelMixin, core.SecondaryFieldDef):
+    """XError schema wrapper
+    A field definition of a secondary channel that shares a scale with another primary channel.
+    For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "xError"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "XError": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "XError": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "XError": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "XError": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "XError": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "XError": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "XError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "XError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "XError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "XError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "XError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "XError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "XError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "XError": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "XError": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "XError": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "XError": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(XError, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            **kwds,
+        )
+
+
+@with_property_setters
+class XErrorValue(ValueChannelMixin, core.ValueDefnumber):
+    """XErrorValue schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : float
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "xError"
+
+    def __init__(self, value, **kwds):
+        super(XErrorValue, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class XError2(FieldChannelMixin, core.SecondaryFieldDef):
+    """XError2 schema wrapper
+    A field definition of a secondary channel that shares a scale with another primary channel.
+    For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "xError2"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "XError2": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "XError2": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "XError2": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "XError2": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "XError2": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "XError2": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "XError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "XError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "XError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "XError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "XError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "XError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "XError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "XError2": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "XError2": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "XError2": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "XError2": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(XError2, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            **kwds,
+        )
+
+
+@with_property_setters
+class XError2Value(ValueChannelMixin, core.ValueDefnumber):
+    """XError2Value schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : float
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "xError2"
+
+    def __init__(self, value, **kwds):
+        super(XError2Value, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class XOffset(FieldChannelMixin, core.ScaleFieldDef):
+    """XOffset schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "xOffset"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "XOffset": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "XOffset": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "XOffset": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "XOffset": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "XOffset": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "XOffset": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "XOffset": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "XOffset": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "XOffset": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "XOffset": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "XOffset": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "XOffset": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "XOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "XOffset": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "XOffset": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "XOffset": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "XOffset": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "XOffset": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(XOffset, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class XOffsetDatum(DatumChannelMixin, core.ScaleDatumDef):
+    """XOffsetDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "xOffset"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "XOffsetDatum": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "XOffsetDatum": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "XOffsetDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "XOffsetDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "XOffsetDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "XOffsetDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "XOffsetDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(XOffsetDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            scale=scale,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class XOffsetValue(ValueChannelMixin, core.ValueDefnumber):
+    """XOffsetValue schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : float
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "xOffset"
+
+    def __init__(self, value, **kwds):
+        super(XOffsetValue, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class Y(FieldChannelMixin, core.PositionFieldDef):
+    """Y schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    axis : dict, None, :class:`Axis`
+        An object defining properties of axis's gridlines, ticks and labels. If ``null``,
+        the axis for the encoding channel will be removed.
+
+        **Default value:** If undefined, default `axis properties
+        <https://vega.github.io/vega-lite/docs/axis.html>`__ are applied.
+
+        **See also:** `axis <https://vega.github.io/vega-lite/docs/axis.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    impute : dict, None, :class:`ImputeParams`
+        An object defining the properties of the Impute Operation to be applied. The field
+        value of the other positional channel is taken as ``key`` of the ``Impute``
+        Operation. The field of the ``color`` channel if specified is used as ``groupby`` of
+        the ``Impute`` Operation.
+
+        **See also:** `impute <https://vega.github.io/vega-lite/docs/impute.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    stack : bool, None, :class:`StackOffset`, Literal['zero', 'center', 'normalize']
+        Type of stacking offset if the field should be stacked. ``stack`` is only applicable
+        for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For
+        example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar
+        chart.
+
+        ``stack`` can be one of the following values:
+
+
+        * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale
+          (for creating typical stacked
+          [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area
+          <https://vega.github.io/vega-lite/docs/stack.html#area>`__ chart).
+        * ``"normalize"`` - stacking with normalized domain (for creating `normalized
+          stacked bar and area charts
+          <https://vega.github.io/vega-lite/docs/stack.html#normalized>`__ and pie charts
+          `with percentage tooltip
+          <https://vega.github.io/vega-lite/docs/arc.html#tooltip>`__ ). :raw-html:`<br/>`
+        * ``"center"`` - stacking with center baseline (for `streamgraph
+          <https://vega.github.io/vega-lite/docs/stack.html#streamgraph>`__ ).
+        * ``null`` or ``false`` - No-stacking. This will produce layered `bar
+          <https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart>`__ and area
+          chart.
+
+        **Default value:** ``zero`` for plots with all of the following conditions are true:
+        (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x
+        or y) has a linear scale; (3) At least one of non-position channels mapped to an
+        unaggregated field that is different from x and y. Otherwise, ``null`` by default.
+
+        **See also:** `stack <https://vega.github.io/vega-lite/docs/stack.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "y"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Y": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Y": ...
+
+    @overload
+    def axis(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandPosition: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[bool, UndefinedType] = Undefined,
+        domainCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        domainColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        domainDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        grid: Union[bool, UndefinedType] = Undefined,
+        gridCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        gridColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gridDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        gridDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelBound: Union[
+            bool, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFlush: Union[bool, float, UndefinedType] = Undefined,
+        labelFlushOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labels: Union[bool, UndefinedType] = Undefined,
+        maxExtent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minExtent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "bottom", "left", "right"],
+            UndefinedType,
+        ] = Undefined,
+        position: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tickBand: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["center", "extent"],
+            UndefinedType,
+        ] = Undefined,
+        tickCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        tickColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        tickDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickExtra: Union[bool, UndefinedType] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickRound: Union[bool, UndefinedType] = Undefined,
+        tickSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ticks: Union[bool, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        translate: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def axis(self, _: None, **kwds) -> "Y": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Y": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "Y": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def bin(self, _: str, **kwds) -> "Y": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Y": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Y": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def impute(
+        self,
+        frame: Union[Sequence[Union[None, float]], UndefinedType] = Undefined,
+        keyvals: Union[dict, Sequence[Any], core.SchemaBase, UndefinedType] = Undefined,
+        method: Union[
+            core.SchemaBase,
+            Literal["value", "median", "max", "min", "mean"],
+            UndefinedType,
+        ] = Undefined,
+        value: Union[Any, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def impute(self, _: None, **kwds) -> "Y": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "Y": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "Y": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "Y": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "Y": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "Y": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "Y": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "Y": ...
+
+    @overload
+    def stack(self, _: Literal["zero", "center", "normalize"], **kwds) -> "Y": ...
+
+    @overload
+    def stack(self, _: None, **kwds) -> "Y": ...
+
+    @overload
+    def stack(self, _: bool, **kwds) -> "Y": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Y": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Y": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Y": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Y": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "Y": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        axis: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        impute: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        stack: Union[
+            bool,
+            None,
+            core.SchemaBase,
+            Literal["zero", "center", "normalize"],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Y, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            axis=axis,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            impute=impute,
+            scale=scale,
+            sort=sort,
+            stack=stack,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class YDatum(DatumChannelMixin, core.PositionDatumDef):
+    """YDatum schema wrapper
+
+    Parameters
+    ----------
+
+    axis : dict, None, :class:`Axis`
+        An object defining properties of axis's gridlines, ticks and labels. If ``null``,
+        the axis for the encoding channel will be removed.
+
+        **Default value:** If undefined, default `axis properties
+        <https://vega.github.io/vega-lite/docs/axis.html>`__ are applied.
+
+        **See also:** `axis <https://vega.github.io/vega-lite/docs/axis.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    impute : dict, None, :class:`ImputeParams`
+        An object defining the properties of the Impute Operation to be applied. The field
+        value of the other positional channel is taken as ``key`` of the ``Impute``
+        Operation. The field of the ``color`` channel if specified is used as ``groupby`` of
+        the ``Impute`` Operation.
+
+        **See also:** `impute <https://vega.github.io/vega-lite/docs/impute.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    stack : bool, None, :class:`StackOffset`, Literal['zero', 'center', 'normalize']
+        Type of stacking offset if the field should be stacked. ``stack`` is only applicable
+        for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For
+        example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar
+        chart.
+
+        ``stack`` can be one of the following values:
+
+
+        * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale
+          (for creating typical stacked
+          [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area
+          <https://vega.github.io/vega-lite/docs/stack.html#area>`__ chart).
+        * ``"normalize"`` - stacking with normalized domain (for creating `normalized
+          stacked bar and area charts
+          <https://vega.github.io/vega-lite/docs/stack.html#normalized>`__ and pie charts
+          `with percentage tooltip
+          <https://vega.github.io/vega-lite/docs/arc.html#tooltip>`__ ). :raw-html:`<br/>`
+        * ``"center"`` - stacking with center baseline (for `streamgraph
+          <https://vega.github.io/vega-lite/docs/stack.html#streamgraph>`__ ).
+        * ``null`` or ``false`` - No-stacking. This will produce layered `bar
+          <https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart>`__ and area
+          chart.
+
+        **Default value:** ``zero`` for plots with all of the following conditions are true:
+        (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x
+        or y) has a linear scale; (3) At least one of non-position channels mapped to an
+        unaggregated field that is different from x and y. Otherwise, ``null`` by default.
+
+        **See also:** `stack <https://vega.github.io/vega-lite/docs/stack.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "y"
+
+    @overload
+    def axis(
+        self,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandPosition: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[bool, UndefinedType] = Undefined,
+        domainCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        domainColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        domainDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        format: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        grid: Union[bool, UndefinedType] = Undefined,
+        gridCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        gridColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gridDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        gridDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        gridWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelBound: Union[
+            bool, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFlush: Union[bool, float, UndefinedType] = Undefined,
+        labelFlushOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        labels: Union[bool, UndefinedType] = Undefined,
+        maxExtent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minExtent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        orient: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "bottom", "left", "right"],
+            UndefinedType,
+        ] = Undefined,
+        position: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tickBand: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["center", "extent"],
+            UndefinedType,
+        ] = Undefined,
+        tickCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        tickColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        tickDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickExtra: Union[bool, UndefinedType] = Undefined,
+        tickMinStep: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickRound: Union[bool, UndefinedType] = Undefined,
+        tickSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        tickWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ticks: Union[bool, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleAlign: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleX: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        titleY: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        translate: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        values: Union[
+            dict,
+            Sequence[str],
+            Sequence[bool],
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[float],
+            Sequence[Union[dict, core.SchemaBase]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "YDatum": ...
+
+    @overload
+    def axis(self, _: None, **kwds) -> "YDatum": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "YDatum": ...
+
+    @overload
+    def impute(
+        self,
+        frame: Union[Sequence[Union[None, float]], UndefinedType] = Undefined,
+        keyvals: Union[dict, Sequence[Any], core.SchemaBase, UndefinedType] = Undefined,
+        method: Union[
+            core.SchemaBase,
+            Literal["value", "median", "max", "min", "mean"],
+            UndefinedType,
+        ] = Undefined,
+        value: Union[Any, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "YDatum": ...
+
+    @overload
+    def impute(self, _: None, **kwds) -> "YDatum": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "YDatum": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "YDatum": ...
+
+    @overload
+    def stack(self, _: Literal["zero", "center", "normalize"], **kwds) -> "YDatum": ...
+
+    @overload
+    def stack(self, _: None, **kwds) -> "YDatum": ...
+
+    @overload
+    def stack(self, _: bool, **kwds) -> "YDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "YDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "YDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "YDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "YDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        axis: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        impute: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        stack: Union[
+            bool,
+            None,
+            core.SchemaBase,
+            Literal["zero", "center", "normalize"],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(YDatum, self).__init__(
+            datum=datum,
+            axis=axis,
+            bandPosition=bandPosition,
+            impute=impute,
+            scale=scale,
+            stack=stack,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class YValue(ValueChannelMixin, core.PositionValueDef):
+    """YValue schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : str, dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "y"
+
+    def __init__(self, value, **kwds):
+        super(YValue, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class Y2(FieldChannelMixin, core.SecondaryFieldDef):
+    """Y2 schema wrapper
+    A field definition of a secondary channel that shares a scale with another primary channel.
+    For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "y2"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "Y2": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Y2": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "Y2": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Y2": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "Y2": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "Y2": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "Y2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "Y2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "Y2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Y2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "Y2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Y2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "Y2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "Y2": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Y2": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Y2": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Y2": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Y2, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            **kwds,
+        )
+
+
+@with_property_setters
+class Y2Datum(DatumChannelMixin, core.DatumDef):
+    """Y2Datum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "y2"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "Y2Datum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "Y2Datum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "Y2Datum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "Y2Datum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "Y2Datum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Y2Datum, self).__init__(
+            datum=datum, bandPosition=bandPosition, title=title, type=type, **kwds
+        )
+
+
+@with_property_setters
+class Y2Value(ValueChannelMixin, core.PositionValueDef):
+    """Y2Value schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : str, dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "y2"
+
+    def __init__(self, value, **kwds):
+        super(Y2Value, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class YError(FieldChannelMixin, core.SecondaryFieldDef):
+    """YError schema wrapper
+    A field definition of a secondary channel that shares a scale with another primary channel.
+    For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "yError"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "YError": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "YError": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "YError": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "YError": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "YError": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "YError": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "YError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "YError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "YError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "YError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "YError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "YError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "YError": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "YError": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "YError": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "YError": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "YError": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(YError, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            **kwds,
+        )
+
+
+@with_property_setters
+class YErrorValue(ValueChannelMixin, core.ValueDefnumber):
+    """YErrorValue schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : float
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "yError"
+
+    def __init__(self, value, **kwds):
+        super(YErrorValue, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class YError2(FieldChannelMixin, core.SecondaryFieldDef):
+    """YError2 schema wrapper
+    A field definition of a secondary channel that shares a scale with another primary channel.
+    For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "yError2"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "YError2": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "YError2": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "YError2": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "YError2": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "YError2": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "YError2": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "YError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "YError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "YError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "YError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "YError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "YError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "YError2": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "YError2": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "YError2": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "YError2": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "YError2": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(YError2, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            **kwds,
+        )
+
+
+@with_property_setters
+class YError2Value(ValueChannelMixin, core.ValueDefnumber):
+    """YError2Value schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : float
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "yError2"
+
+    def __init__(self, value, **kwds):
+        super(YError2Value, self).__init__(value=value, **kwds)
+
+
+@with_property_setters
+class YOffset(FieldChannelMixin, core.ScaleFieldDef):
+    """YOffset schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "yOffset"
+
+    @overload
+    def aggregate(
+        self,
+        _: Literal[
+            "average",
+            "count",
+            "distinct",
+            "max",
+            "mean",
+            "median",
+            "min",
+            "missing",
+            "product",
+            "q1",
+            "q3",
+            "ci0",
+            "ci1",
+            "stderr",
+            "stdev",
+            "stdevp",
+            "sum",
+            "valid",
+            "values",
+            "variance",
+            "variancep",
+            "exponential",
+            "exponentialb",
+        ],
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def aggregate(
+        self, argmax: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "YOffset": ...
+
+    @overload
+    def aggregate(
+        self, argmin: Union[str, core.SchemaBase, UndefinedType] = Undefined, **kwds
+    ) -> "YOffset": ...
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "YOffset": ...
+
+    @overload
+    def bin(self, _: bool, **kwds) -> "YOffset": ...
+
+    @overload
+    def bin(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def bin(self, _: None, **kwds) -> "YOffset": ...
+
+    @overload
+    def field(self, _: str, **kwds) -> "YOffset": ...
+
+    @overload
+    def field(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "YOffset": ...
+
+    @overload
+    def sort(self, _: List[float], **kwds) -> "YOffset": ...
+
+    @overload
+    def sort(self, _: List[str], **kwds) -> "YOffset": ...
+
+    @overload
+    def sort(self, _: List[bool], **kwds) -> "YOffset": ...
+
+    @overload
+    def sort(self, _: List[core.DateTime], **kwds) -> "YOffset": ...
+
+    @overload
+    def sort(self, _: Literal["ascending", "descending"], **kwds) -> "YOffset": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "x",
+            "y",
+            "color",
+            "fill",
+            "stroke",
+            "strokeWidth",
+            "size",
+            "shape",
+            "fillOpacity",
+            "strokeOpacity",
+            "opacity",
+            "text",
+        ],
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def sort(
+        self,
+        _: Literal[
+            "-x",
+            "-y",
+            "-color",
+            "-fill",
+            "-stroke",
+            "-strokeWidth",
+            "-size",
+            "-shape",
+            "-fillOpacity",
+            "-strokeOpacity",
+            "-opacity",
+            "-text",
+        ],
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def sort(
+        self,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        op: Union[
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def sort(
+        self,
+        encoding: Union[
+            core.SchemaBase,
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, core.SchemaBase, Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def sort(self, _: None, **kwds) -> "YOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "year",
+            "quarter",
+            "month",
+            "week",
+            "day",
+            "dayofyear",
+            "date",
+            "hours",
+            "minutes",
+            "seconds",
+            "milliseconds",
+        ],
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyear",
+            "utcquarter",
+            "utcmonth",
+            "utcweek",
+            "utcday",
+            "utcdayofyear",
+            "utcdate",
+            "utchours",
+            "utcminutes",
+            "utcseconds",
+            "utcmilliseconds",
+        ],
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "yearquarter",
+            "yearquartermonth",
+            "yearmonth",
+            "yearmonthdate",
+            "yearmonthdatehours",
+            "yearmonthdatehoursminutes",
+            "yearmonthdatehoursminutesseconds",
+            "yearweek",
+            "yearweekday",
+            "yearweekdayhours",
+            "yearweekdayhoursminutes",
+            "yearweekdayhoursminutesseconds",
+            "yeardayofyear",
+            "quartermonth",
+            "monthdate",
+            "monthdatehours",
+            "monthdatehoursminutes",
+            "monthdatehoursminutesseconds",
+            "weekday",
+            "weekdayhours",
+            "weekdayhoursminutes",
+            "weekdayhoursminutesseconds",
+            "dayhours",
+            "dayhoursminutes",
+            "dayhoursminutesseconds",
+            "hoursminutes",
+            "hoursminutesseconds",
+            "minutesseconds",
+            "secondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "utcyearquarter",
+            "utcyearquartermonth",
+            "utcyearmonth",
+            "utcyearmonthdate",
+            "utcyearmonthdatehours",
+            "utcyearmonthdatehoursminutes",
+            "utcyearmonthdatehoursminutesseconds",
+            "utcyearweek",
+            "utcyearweekday",
+            "utcyearweekdayhours",
+            "utcyearweekdayhoursminutes",
+            "utcyearweekdayhoursminutesseconds",
+            "utcyeardayofyear",
+            "utcquartermonth",
+            "utcmonthdate",
+            "utcmonthdatehours",
+            "utcmonthdatehoursminutes",
+            "utcmonthdatehoursminutesseconds",
+            "utcweekday",
+            "utcweeksdayhours",
+            "utcweekdayhoursminutes",
+            "utcweekdayhoursminutesseconds",
+            "utcdayhours",
+            "utcdayhoursminutes",
+            "utcdayhoursminutesseconds",
+            "utchoursminutes",
+            "utchoursminutesseconds",
+            "utcminutesseconds",
+            "utcsecondsmilliseconds",
+        ],
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear",
+        ],
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        _: Literal[
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear",
+        ],
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def timeUnit(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ) -> "YOffset": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "YOffset": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "YOffset": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "YOffset": ...
+
+    @overload
+    def type(
+        self, _: Literal["quantitative", "ordinal", "temporal", "nominal"], **kwds
+    ) -> "YOffset": ...
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        field: Union[str, dict, core.SchemaBase, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            Sequence[str],
+            Sequence[bool],
+            core.SchemaBase,
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, core.SchemaBase]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            core.SchemaBase,
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(YOffset, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class YOffsetDatum(DatumChannelMixin, core.ScaleDatumDef):
+    """YOffsetDatum schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "yOffset"
+
+    @overload
+    def bandPosition(self, _: float, **kwds) -> "YOffsetDatum": ...
+
+    @overload
+    def scale(
+        self,
+        align: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        base: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bins: Union[dict, core.SchemaBase, Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        constant: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Sequence[
+                Union[str, bool, dict, None, float, core._Parameter, core.SchemaBase]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        domainRaw: Union[
+            dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        exponent: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            core.SchemaBase,
+            Sequence[
+                Union[
+                    str, dict, float, core._Parameter, core.SchemaBase, Sequence[float]
+                ]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        round: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        scheme: Union[
+            dict,
+            Sequence[str],
+            core._Parameter,
+            core.SchemaBase,
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> "YOffsetDatum": ...
+
+    @overload
+    def scale(self, _: None, **kwds) -> "YOffsetDatum": ...
+
+    @overload
+    def title(self, _: str, **kwds) -> "YOffsetDatum": ...
+
+    @overload
+    def title(self, _: List[str], **kwds) -> "YOffsetDatum": ...
+
+    @overload
+    def title(self, _: None, **kwds) -> "YOffsetDatum": ...
+
+    @overload
+    def type(
+        self,
+        _: Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+        **kwds,
+    ) -> "YOffsetDatum": ...
+
+    def __init__(
+        self,
+        datum,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        scale: Union[dict, None, core.SchemaBase, UndefinedType] = Undefined,
+        title: Union[
+            str, None, Sequence[str], core.SchemaBase, UndefinedType
+        ] = Undefined,
+        type: Union[
+            core.SchemaBase,
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(YOffsetDatum, self).__init__(
+            datum=datum,
+            bandPosition=bandPosition,
+            scale=scale,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+@with_property_setters
+class YOffsetValue(ValueChannelMixin, core.ValueDefnumber):
+    """YOffsetValue schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : float
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _class_is_valid_at_instantiation = False
+    _encoding_name = "yOffset"
+
+    def __init__(self, value, **kwds):
+        super(YOffsetValue, self).__init__(value=value, **kwds)
+
+
+def _encode_signature(
+    self,
+    angle: Union[str, Angle, dict, AngleDatum, AngleValue, UndefinedType] = Undefined,
+    color: Union[str, Color, dict, ColorDatum, ColorValue, UndefinedType] = Undefined,
+    column: Union[str, Column, dict, UndefinedType] = Undefined,
+    description: Union[
+        str, Description, dict, DescriptionValue, UndefinedType
+    ] = Undefined,
+    detail: Union[str, Detail, dict, list, UndefinedType] = Undefined,
+    facet: Union[str, Facet, dict, UndefinedType] = Undefined,
+    fill: Union[str, Fill, dict, FillDatum, FillValue, UndefinedType] = Undefined,
+    fillOpacity: Union[
+        str, FillOpacity, dict, FillOpacityDatum, FillOpacityValue, UndefinedType
+    ] = Undefined,
+    href: Union[str, Href, dict, HrefValue, UndefinedType] = Undefined,
+    key: Union[str, Key, dict, UndefinedType] = Undefined,
+    latitude: Union[str, Latitude, dict, LatitudeDatum, UndefinedType] = Undefined,
+    latitude2: Union[
+        str, Latitude2, dict, Latitude2Datum, Latitude2Value, UndefinedType
+    ] = Undefined,
+    longitude: Union[str, Longitude, dict, LongitudeDatum, UndefinedType] = Undefined,
+    longitude2: Union[
+        str, Longitude2, dict, Longitude2Datum, Longitude2Value, UndefinedType
+    ] = Undefined,
+    opacity: Union[
+        str, Opacity, dict, OpacityDatum, OpacityValue, UndefinedType
+    ] = Undefined,
+    order: Union[str, Order, dict, list, OrderValue, UndefinedType] = Undefined,
+    radius: Union[
+        str, Radius, dict, RadiusDatum, RadiusValue, UndefinedType
+    ] = Undefined,
+    radius2: Union[
+        str, Radius2, dict, Radius2Datum, Radius2Value, UndefinedType
+    ] = Undefined,
+    row: Union[str, Row, dict, UndefinedType] = Undefined,
+    shape: Union[str, Shape, dict, ShapeDatum, ShapeValue, UndefinedType] = Undefined,
+    size: Union[str, Size, dict, SizeDatum, SizeValue, UndefinedType] = Undefined,
+    stroke: Union[
+        str, Stroke, dict, StrokeDatum, StrokeValue, UndefinedType
+    ] = Undefined,
+    strokeDash: Union[
+        str, StrokeDash, dict, StrokeDashDatum, StrokeDashValue, UndefinedType
+    ] = Undefined,
+    strokeOpacity: Union[
+        str, StrokeOpacity, dict, StrokeOpacityDatum, StrokeOpacityValue, UndefinedType
+    ] = Undefined,
+    strokeWidth: Union[
+        str, StrokeWidth, dict, StrokeWidthDatum, StrokeWidthValue, UndefinedType
+    ] = Undefined,
+    text: Union[str, Text, dict, TextDatum, TextValue, UndefinedType] = Undefined,
+    theta: Union[str, Theta, dict, ThetaDatum, ThetaValue, UndefinedType] = Undefined,
+    theta2: Union[
+        str, Theta2, dict, Theta2Datum, Theta2Value, UndefinedType
+    ] = Undefined,
+    tooltip: Union[str, Tooltip, dict, list, TooltipValue, UndefinedType] = Undefined,
+    url: Union[str, Url, dict, UrlValue, UndefinedType] = Undefined,
+    x: Union[str, X, dict, XDatum, XValue, UndefinedType] = Undefined,
+    x2: Union[str, X2, dict, X2Datum, X2Value, UndefinedType] = Undefined,
+    xError: Union[str, XError, dict, XErrorValue, UndefinedType] = Undefined,
+    xError2: Union[str, XError2, dict, XError2Value, UndefinedType] = Undefined,
+    xOffset: Union[
+        str, XOffset, dict, XOffsetDatum, XOffsetValue, UndefinedType
+    ] = Undefined,
+    y: Union[str, Y, dict, YDatum, YValue, UndefinedType] = Undefined,
+    y2: Union[str, Y2, dict, Y2Datum, Y2Value, UndefinedType] = Undefined,
+    yError: Union[str, YError, dict, YErrorValue, UndefinedType] = Undefined,
+    yError2: Union[str, YError2, dict, YError2Value, UndefinedType] = Undefined,
+    yOffset: Union[
+        str, YOffset, dict, YOffsetDatum, YOffsetValue, UndefinedType
+    ] = Undefined,
+):
+    """Parameters
+    ----------
+
+    angle : str, :class:`Angle`, Dict, :class:`AngleDatum`, :class:`AngleValue`
+        Rotation angle of point and text marks.
+    color : str, :class:`Color`, Dict, :class:`ColorDatum`, :class:`ColorValue`
+        Color of the marks – either fill or stroke color based on  the ``filled`` property
+        of mark definition. By default, ``color`` represents fill color for ``"area"``,
+        ``"bar"``, ``"tick"``, ``"text"``, ``"trail"``, ``"circle"``, and ``"square"`` /
+        stroke color for ``"line"`` and ``"point"``.
+
+        **Default value:** If undefined, the default color depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's ``color``
+        property.
+
+        *Note:* 1) For fine-grained control over both fill and stroke colors of the marks,
+        please use the ``fill`` and ``stroke`` channels. The ``fill`` or ``stroke``
+        encodings have higher precedence than ``color``, thus may override the ``color``
+        encoding if conflicting encodings are specified. 2) See the scale documentation for
+        more information about customizing `color scheme
+        <https://vega.github.io/vega-lite/docs/scale.html#scheme>`__.
+    column : str, :class:`Column`, Dict
+        A field definition for the horizontal facet of trellis plots.
+    description : str, :class:`Description`, Dict, :class:`DescriptionValue`
+        A text description of this mark for ARIA accessibility (SVG output only). For SVG
+        output the ``"aria-label"`` attribute will be set to this description.
+    detail : str, :class:`Detail`, Dict, List
+        Additional levels of detail for grouping data in aggregate views and in line, trail,
+        and area marks without mapping data to a specific visual channel.
+    facet : str, :class:`Facet`, Dict
+        A field definition for the (flexible) facet of trellis plots.
+
+        If either ``row`` or ``column`` is specified, this channel will be ignored.
+    fill : str, :class:`Fill`, Dict, :class:`FillDatum`, :class:`FillValue`
+        Fill color of the marks. **Default value:** If undefined, the default color depends
+        on `mark config <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__
+        's ``color`` property.
+
+        *Note:* The ``fill`` encoding has higher precedence than ``color``, thus may
+        override the ``color`` encoding if conflicting encodings are specified.
+    fillOpacity : str, :class:`FillOpacity`, Dict, :class:`FillOpacityDatum`, :class:`FillOpacityValue`
+        Fill opacity of the marks.
+
+        **Default value:** If undefined, the default opacity depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's
+        ``fillOpacity`` property.
+    href : str, :class:`Href`, Dict, :class:`HrefValue`
+        A URL to load upon mouse click.
+    key : str, :class:`Key`, Dict
+        A data field to use as a unique key for data binding. When a visualization’s data is
+        updated, the key value will be used to match data elements to existing mark
+        instances. Use a key channel to enable object constancy for transitions over dynamic
+        data.
+    latitude : str, :class:`Latitude`, Dict, :class:`LatitudeDatum`
+        Latitude position of geographically projected marks.
+    latitude2 : str, :class:`Latitude2`, Dict, :class:`Latitude2Datum`, :class:`Latitude2Value`
+        Latitude-2 position for geographically projected ranged ``"area"``, ``"bar"``,
+        ``"rect"``, and  ``"rule"``.
+    longitude : str, :class:`Longitude`, Dict, :class:`LongitudeDatum`
+        Longitude position of geographically projected marks.
+    longitude2 : str, :class:`Longitude2`, Dict, :class:`Longitude2Datum`, :class:`Longitude2Value`
+        Longitude-2 position for geographically projected ranged ``"area"``, ``"bar"``,
+        ``"rect"``, and  ``"rule"``.
+    opacity : str, :class:`Opacity`, Dict, :class:`OpacityDatum`, :class:`OpacityValue`
+        Opacity of the marks.
+
+        **Default value:** If undefined, the default opacity depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's ``opacity``
+        property.
+    order : str, :class:`Order`, Dict, List, :class:`OrderValue`
+        Order of the marks.
+
+
+        * For stacked marks, this ``order`` channel encodes `stack order
+          <https://vega.github.io/vega-lite/docs/stack.html#order>`__.
+        * For line and trail marks, this ``order`` channel encodes order of data points in
+          the lines. This can be useful for creating `a connected scatterplot
+          <https://vega.github.io/vega-lite/examples/connected_scatterplot.html>`__. Setting
+          ``order`` to ``{"value": null}`` makes the line marks use the original order in
+          the data sources.
+        * Otherwise, this ``order`` channel encodes layer order of the marks.
+
+        **Note** : In aggregate plots, ``order`` field should be ``aggregate`` d to avoid
+        creating additional aggregation grouping.
+    radius : str, :class:`Radius`, Dict, :class:`RadiusDatum`, :class:`RadiusValue`
+        The outer radius in pixels of arc marks.
+    radius2 : str, :class:`Radius2`, Dict, :class:`Radius2Datum`, :class:`Radius2Value`
+        The inner radius in pixels of arc marks.
+    row : str, :class:`Row`, Dict
+        A field definition for the vertical facet of trellis plots.
+    shape : str, :class:`Shape`, Dict, :class:`ShapeDatum`, :class:`ShapeValue`
+        Shape of the mark.
+
+
+        #.
+        For ``point`` marks the supported values include:   - plotting shapes: ``"circle"``,
+        ``"square"``, ``"cross"``, ``"diamond"``, ``"triangle-up"``, ``"triangle-down"``,
+        ``"triangle-right"``, or ``"triangle-left"``.   - the line symbol ``"stroke"``   -
+        centered directional shapes ``"arrow"``, ``"wedge"``, or ``"triangle"``   - a custom
+        `SVG path string
+        <https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths>`__ (For correct
+        sizing, custom shape paths should be defined within a square bounding box with
+        coordinates ranging from -1 to 1 along both the x and y dimensions.)
+
+        #.
+        For ``geoshape`` marks it should be a field definition of the geojson data
+
+        **Default value:** If undefined, the default shape depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#point-config>`__ 's ``shape``
+        property. ( ``"circle"`` if unset.)
+    size : str, :class:`Size`, Dict, :class:`SizeDatum`, :class:`SizeValue`
+        Size of the mark.
+
+
+        * For ``"point"``, ``"square"`` and ``"circle"``, – the symbol size, or pixel area
+          of the mark.
+        * For ``"bar"`` and ``"tick"`` – the bar and tick's size.
+        * For ``"text"`` – the text's font size.
+        * Size is unsupported for ``"line"``, ``"area"``, and ``"rect"``. (Use ``"trail"``
+          instead of line with varying size)
+    stroke : str, :class:`Stroke`, Dict, :class:`StrokeDatum`, :class:`StrokeValue`
+        Stroke color of the marks. **Default value:** If undefined, the default color
+        depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's ``color``
+        property.
+
+        *Note:* The ``stroke`` encoding has higher precedence than ``color``, thus may
+        override the ``color`` encoding if conflicting encodings are specified.
+    strokeDash : str, :class:`StrokeDash`, Dict, :class:`StrokeDashDatum`, :class:`StrokeDashValue`
+        Stroke dash of the marks.
+
+        **Default value:** ``[1,0]`` (No dash).
+    strokeOpacity : str, :class:`StrokeOpacity`, Dict, :class:`StrokeOpacityDatum`, :class:`StrokeOpacityValue`
+        Stroke opacity of the marks.
+
+        **Default value:** If undefined, the default opacity depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's
+        ``strokeOpacity`` property.
+    strokeWidth : str, :class:`StrokeWidth`, Dict, :class:`StrokeWidthDatum`, :class:`StrokeWidthValue`
+        Stroke width of the marks.
+
+        **Default value:** If undefined, the default stroke width depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's
+        ``strokeWidth`` property.
+    text : str, :class:`Text`, Dict, :class:`TextDatum`, :class:`TextValue`
+        Text of the ``text`` mark.
+    theta : str, :class:`Theta`, Dict, :class:`ThetaDatum`, :class:`ThetaValue`
+        For arc marks, the arc length in radians if theta2 is not specified, otherwise the
+        start arc angle. (A value of 0 indicates up or “north”, increasing values proceed
+        clockwise.)
+
+        For text marks, polar coordinate angle in radians.
+    theta2 : str, :class:`Theta2`, Dict, :class:`Theta2Datum`, :class:`Theta2Value`
+        The end angle of arc marks in radians. A value of 0 indicates up or “north”,
+        increasing values proceed clockwise.
+    tooltip : str, :class:`Tooltip`, Dict, List, :class:`TooltipValue`
+        The tooltip text to show upon mouse hover. Specifying ``tooltip`` encoding overrides
+        `the tooltip property in the mark definition
+        <https://vega.github.io/vega-lite/docs/mark.html#mark-def>`__.
+
+        See the `tooltip <https://vega.github.io/vega-lite/docs/tooltip.html>`__
+        documentation for a detailed discussion about tooltip in Vega-Lite.
+    url : str, :class:`Url`, Dict, :class:`UrlValue`
+        The URL of an image mark.
+    x : str, :class:`X`, Dict, :class:`XDatum`, :class:`XValue`
+        X coordinates of the marks, or width of horizontal ``"bar"`` and ``"area"`` without
+        specified ``x2`` or ``width``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    x2 : str, :class:`X2`, Dict, :class:`X2Datum`, :class:`X2Value`
+        X2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    xError : str, :class:`XError`, Dict, :class:`XErrorValue`
+        Error value of x coordinates for error specified ``"errorbar"`` and ``"errorband"``.
+    xError2 : str, :class:`XError2`, Dict, :class:`XError2Value`
+        Secondary error value of x coordinates for error specified ``"errorbar"`` and
+        ``"errorband"``.
+    xOffset : str, :class:`XOffset`, Dict, :class:`XOffsetDatum`, :class:`XOffsetValue`
+        Offset of x-position of the marks
+    y : str, :class:`Y`, Dict, :class:`YDatum`, :class:`YValue`
+        Y coordinates of the marks, or height of vertical ``"bar"`` and ``"area"`` without
+        specified ``y2`` or ``height``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    y2 : str, :class:`Y2`, Dict, :class:`Y2Datum`, :class:`Y2Value`
+        Y2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    yError : str, :class:`YError`, Dict, :class:`YErrorValue`
+        Error value of y coordinates for error specified ``"errorbar"`` and ``"errorband"``.
+    yError2 : str, :class:`YError2`, Dict, :class:`YError2Value`
+        Secondary error value of y coordinates for error specified ``"errorbar"`` and
+        ``"errorband"``.
+    yOffset : str, :class:`YOffset`, Dict, :class:`YOffsetDatum`, :class:`YOffsetValue`
+        Offset of y-position of the marks
+    """
+    ...
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/schema/core.py b/llm/Lib/site-packages/altair/vegalite/v5/schema/core.py
new file mode 100644
index 0000000000000000000000000000000000000000..57f6cdd12606489edcdc44e09a931810141a7065
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/v5/schema/core.py
@@ -0,0 +1,48668 @@
+# The contents of this file are automatically written by
+# tools/generate_schema_wrapper.py. Do not modify directly.
+
+from typing import Any, Literal, Union, Protocol, Sequence, List
+from typing import Dict as TypingDict
+from typing import Generator as TypingGenerator
+from altair.utils.schemapi import SchemaBase, Undefined, UndefinedType, _subclasses
+
+import pkgutil
+import json
+
+
+def load_schema() -> dict:
+    """Load the json schema associated with this module's functions"""
+    schema_bytes = pkgutil.get_data(__name__, "vega-lite-schema.json")
+    if schema_bytes is None:
+        raise ValueError("Unable to load vega-lite-schema.json")
+    return json.loads(schema_bytes.decode("utf-8"))
+
+
+class _Parameter(Protocol):
+    # This protocol represents a Parameter as defined in api.py
+    # It would be better if we could directly use the Parameter class,
+    # but that would create a circular import.
+    # The protocol does not need to have all the attributes and methods of this
+    # class but the actual api.Parameter just needs to pass a type check
+    # as a core._Parameter.
+
+    _counter: int
+
+    def _get_name(cls) -> str: ...
+
+    def to_dict(self) -> TypingDict[str, Union[str, dict]]: ...
+
+    def _to_expr(self) -> str: ...
+
+
+class VegaLiteSchema(SchemaBase):
+    _rootschema = load_schema()
+
+    @classmethod
+    def _default_wrapper_classes(cls) -> TypingGenerator[type, None, None]:
+        return _subclasses(VegaLiteSchema)
+
+
+class Root(VegaLiteSchema):
+    """Root schema wrapper
+    A Vega-Lite top-level specification. This is the root class for all Vega-Lite
+    specifications. (The json schema is generated from this type.)
+    """
+
+    _schema = VegaLiteSchema._rootschema
+
+    def __init__(self, *args, **kwds):
+        super(Root, self).__init__(*args, **kwds)
+
+
+class Aggregate(VegaLiteSchema):
+    """Aggregate schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Aggregate"}
+
+    def __init__(self, *args, **kwds):
+        super(Aggregate, self).__init__(*args, **kwds)
+
+
+class AggregateOp(VegaLiteSchema):
+    """AggregateOp schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/AggregateOp"}
+
+    def __init__(self, *args):
+        super(AggregateOp, self).__init__(*args)
+
+
+class AggregatedFieldDef(VegaLiteSchema):
+    """AggregatedFieldDef schema wrapper
+
+    Parameters
+    ----------
+
+    op : :class:`AggregateOp`, Literal['argmax', 'argmin', 'average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        The aggregation operation to apply to the fields (e.g., ``"sum"``, ``"average"``, or
+        ``"count"`` ). See the `full list of supported aggregation operations
+        <https://vega.github.io/vega-lite/docs/aggregate.html#ops>`__ for more information.
+    field : str, :class:`FieldName`
+        The data field for which to compute aggregate function. This is required for all
+        aggregation operations except ``"count"``.
+    as : str, :class:`FieldName`
+        The output field names to use for each aggregated field.
+    """
+
+    _schema = {"$ref": "#/definitions/AggregatedFieldDef"}
+
+    def __init__(
+        self,
+        op: Union[
+            "SchemaBase",
+            Literal[
+                "argmax",
+                "argmin",
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(AggregatedFieldDef, self).__init__(op=op, field=field, **kwds)
+
+
+class Align(VegaLiteSchema):
+    """Align schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Align"}
+
+    def __init__(self, *args):
+        super(Align, self).__init__(*args)
+
+
+class AnyMark(VegaLiteSchema):
+    """AnyMark schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/AnyMark"}
+
+    def __init__(self, *args, **kwds):
+        super(AnyMark, self).__init__(*args, **kwds)
+
+
+class AnyMarkConfig(VegaLiteSchema):
+    """AnyMarkConfig schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/AnyMarkConfig"}
+
+    def __init__(self, *args, **kwds):
+        super(AnyMarkConfig, self).__init__(*args, **kwds)
+
+
+class AreaConfig(AnyMarkConfig):
+    """AreaConfig schema wrapper
+
+    Parameters
+    ----------
+
+    align : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule).
+        One of ``"left"``, ``"right"``, ``"center"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    angle : dict, float, :class:`ExprRef`
+        The rotation angle of the text, in degrees.
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG element, removing the mark item from the ARIA accessibility tree.
+    ariaRole : str, dict, :class:`ExprRef`
+        Sets the type of user interface element of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "role" attribute. Warning: this
+        property is experimental and may be changed in the future.
+    ariaRoleDescription : str, dict, :class:`ExprRef`
+        A human-readable, author-localized description for the role of the mark item for
+        `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "aria-roledescription" attribute.
+        Warning: this property is experimental and may be changed in the future.
+    aspect : bool, dict, :class:`ExprRef`
+        Whether to keep aspect ratio of image marks.
+    baseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        For text marks, the vertical text baseline. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, ``"line-bottom"``, or an
+        expression reference that provides one of the valid values. The ``"line-top"`` and
+        ``"line-bottom"`` values operate similarly to ``"top"`` and ``"bottom"``, but are
+        calculated relative to the ``lineHeight`` rather than ``fontSize`` alone.
+
+        For range marks, the vertical alignment of the marks. One of ``"top"``,
+        ``"middle"``, ``"bottom"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    blend : dict, :class:`Blend`, :class:`ExprRef`, Literal[None, 'multiply', 'screen', 'overlay', 'darken', 'lighten', 'color-dodge', 'color-burn', 'hard-light', 'soft-light', 'difference', 'exclusion', 'hue', 'saturation', 'color', 'luminosity']
+        The color blend mode for drawing an item on its current background. Any valid `CSS
+        mix-blend-mode <https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode>`__
+        value can be used.
+
+        __Default value:__ ``"source-over"``
+    color : str, dict, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default color.
+
+        **Default value:** :raw-html:`<span style="color: #4682b4;">&#9632;</span>`
+        ``"#4682b4"``
+
+        **Note:**
+
+
+        * This property cannot be used in a `style config
+          <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+        * The ``fill`` and ``stroke`` properties have higher precedence than ``color`` and
+          will override ``color``.
+    cornerRadius : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles or arcs' corners.
+
+        **Default value:** ``0``
+    cornerRadiusBottomLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom left corner.
+
+        **Default value:** ``0``
+    cornerRadiusBottomRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top left corner.
+
+        **Default value:** ``0``
+    cursor : dict, :class:`Cursor`, :class:`ExprRef`, Literal['auto', 'default', 'none', 'context-menu', 'help', 'pointer', 'progress', 'wait', 'cell', 'crosshair', 'text', 'vertical-text', 'alias', 'copy', 'move', 'no-drop', 'not-allowed', 'e-resize', 'n-resize', 'ne-resize', 'nw-resize', 's-resize', 'se-resize', 'sw-resize', 'w-resize', 'ew-resize', 'ns-resize', 'nesw-resize', 'nwse-resize', 'col-resize', 'row-resize', 'all-scroll', 'zoom-in', 'zoom-out', 'grab', 'grabbing']
+        The mouse cursor used over the mark. Any valid `CSS cursor type
+        <https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values>`__ can be used.
+    description : str, dict, :class:`ExprRef`
+        A text description of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the `"aria-label" attribute
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>`__.
+    dir : dict, :class:`ExprRef`, Literal['ltr', 'rtl'], :class:`TextDirection`
+        The direction of the text. One of ``"ltr"`` (left-to-right) or ``"rtl"``
+        (right-to-left). This property determines on which side is truncated in response to
+        the limit parameter.
+
+        **Default value:** ``"ltr"``
+    dx : dict, float, :class:`ExprRef`
+        The horizontal offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    dy : dict, float, :class:`ExprRef`
+        The vertical offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    ellipsis : str, dict, :class:`ExprRef`
+        The ellipsis string for text truncated in response to the limit parameter.
+
+        **Default value:** ``"…"``
+    endAngle : dict, float, :class:`ExprRef`
+        The end angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    fill : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default fill color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove fill.
+
+        **Default value:** (None)
+    fillOpacity : dict, float, :class:`ExprRef`
+        The fill opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    filled : bool
+        Whether the mark's color should be used as fill color instead of stroke color.
+
+        **Default value:** ``false`` for all ``point``, ``line``, and ``rule`` marks as well
+        as ``geoshape`` marks for `graticule
+        <https://vega.github.io/vega-lite/docs/data.html#graticule>`__ data sources;
+        otherwise, ``true``.
+
+        **Note:** This property cannot be used in a `style config
+        <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+    font : str, dict, :class:`ExprRef`
+        The typeface to set the text in (e.g., ``"Helvetica Neue"`` ).
+    fontSize : dict, float, :class:`ExprRef`
+        The font size, in pixels.
+
+        **Default value:** ``11``
+    fontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style (e.g., ``"italic"`` ).
+    fontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight. This can be either a string (e.g ``"bold"``, ``"normal"`` ) or a
+        number ( ``100``, ``200``, ``300``, ..., ``900`` where ``"normal"`` = ``400`` and
+        ``"bold"`` = ``700`` ).
+    height : dict, float, :class:`ExprRef`
+        Height of the marks.
+    href : str, dict, :class:`URI`, :class:`ExprRef`
+        A URL to load upon mouse click. If defined, the mark acts as a hyperlink.
+    innerRadius : dict, float, :class:`ExprRef`
+        The inner radius in pixels of arc marks. ``innerRadius`` is an alias for
+        ``radius2``.
+
+        **Default value:** ``0``
+    interpolate : dict, :class:`ExprRef`, :class:`Interpolate`, Literal['basis', 'basis-open', 'basis-closed', 'bundle', 'cardinal', 'cardinal-open', 'cardinal-closed', 'catmull-rom', 'linear', 'linear-closed', 'monotone', 'natural', 'step', 'step-before', 'step-after']
+        The line interpolation method to use for line and area marks. One of the following:
+
+
+        * ``"linear"`` : piecewise linear segments, as in a polyline.
+        * ``"linear-closed"`` : close the linear segments to form a polygon.
+        * ``"step"`` : alternate between horizontal and vertical segments, as in a step
+          function.
+        * ``"step-before"`` : alternate between vertical and horizontal segments, as in a
+          step function.
+        * ``"step-after"`` : alternate between horizontal and vertical segments, as in a
+          step function.
+        * ``"basis"`` : a B-spline, with control point duplication on the ends.
+        * ``"basis-open"`` : an open B-spline; may not intersect the start or end.
+        * ``"basis-closed"`` : a closed B-spline, as in a loop.
+        * ``"cardinal"`` : a Cardinal spline, with control point duplication on the ends.
+        * ``"cardinal-open"`` : an open Cardinal spline; may not intersect the start or end,
+          but will intersect other control points.
+        * ``"cardinal-closed"`` : a closed Cardinal spline, as in a loop.
+        * ``"bundle"`` : equivalent to basis, except the tension parameter is used to
+          straighten the spline.
+        * ``"monotone"`` : cubic interpolation that preserves monotonicity in y.
+    invalid : Literal['filter', None]
+        Defines how Vega-Lite should handle marks for invalid values ( ``null`` and ``NaN``
+        ).
+
+
+        * If set to ``"filter"`` (default), all data items with null values will be skipped
+          (for line, trail, and area marks) or filtered (for other marks).
+        * If ``null``, all data items are included. In this case, invalid values will be
+          interpreted as zeroes.
+    limit : dict, float, :class:`ExprRef`
+        The maximum length of the text mark in pixels. The text value will be automatically
+        truncated if the rendered size exceeds the limit.
+
+        **Default value:** ``0`` -- indicating no limit
+    line : bool, dict, :class:`OverlayMarkDef`
+        A flag for overlaying line on top of area marks, or an object defining the
+        properties of the overlayed lines.
+
+
+        If this value is an empty object ( ``{}`` ) or ``true``, lines with default
+        properties will be used.
+
+        If this value is ``false``, no lines would be automatically added to area marks.
+
+        **Default value:** ``false``.
+    lineBreak : str, dict, :class:`ExprRef`
+        A delimiter, such as a newline character, upon which to break text strings into
+        multiple lines. This property is ignored if the text is array-valued.
+    lineHeight : dict, float, :class:`ExprRef`
+        The line height in pixels (the spacing between subsequent lines of text) for
+        multi-line text marks.
+    opacity : dict, float, :class:`ExprRef`
+        The overall opacity (value between [0,1]).
+
+        **Default value:** ``0.7`` for non-aggregate plots with ``point``, ``tick``,
+        ``circle``, or ``square`` marks or layered ``bar`` charts and ``1`` otherwise.
+    order : bool, None
+        For line and trail marks, this ``order`` property can be set to ``null`` or
+        ``false`` to make the lines use the original order in the data sources.
+    orient : :class:`Orientation`, Literal['horizontal', 'vertical']
+        The orientation of a non-stacked bar, tick, area, and line charts. The value is
+        either horizontal (default) or vertical.
+
+
+        * For bar, rule and tick, this determines whether the size of the bar and tick
+          should be applied to x or y dimension.
+        * For area, this property determines the orient property of the Vega output.
+        * For line and trail marks, this property determines the sort order of the points in
+          the line if ``config.sortLineBy`` is not specified. For stacked charts, this is
+          always determined by the orientation of the stack; therefore explicitly specified
+          value will be ignored.
+    outerRadius : dict, float, :class:`ExprRef`
+        The outer radius in pixels of arc marks. ``outerRadius`` is an alias for ``radius``.
+
+        **Default value:** ``0``
+    padAngle : dict, float, :class:`ExprRef`
+        The angular padding applied to sides of the arc, in radians.
+    point : str, bool, dict, :class:`OverlayMarkDef`
+        A flag for overlaying points on top of line or area marks, or an object defining the
+        properties of the overlayed points.
+
+
+        If this property is ``"transparent"``, transparent points will be used (for
+        enhancing tooltips and selections).
+
+        If this property is an empty object ( ``{}`` ) or ``true``, filled points with
+        default properties will be used.
+
+        If this property is ``false``, no points would be automatically added to line or
+        area marks.
+
+        **Default value:** ``false``.
+    radius : dict, float, :class:`ExprRef`
+        For arc mark, the primary (outer) radius in pixels.
+
+        For text marks, polar coordinate radial offset, in pixels, of the text from the
+        origin determined by the ``x`` and ``y`` properties.
+
+        **Default value:** ``min(plot_width, plot_height)/2``
+    radius2 : dict, float, :class:`ExprRef`
+        The secondary (inner) radius in pixels of arc marks.
+
+        **Default value:** ``0``
+    shape : str, dict, :class:`ExprRef`, :class:`SymbolShape`
+        Shape of the point marks. Supported values include:
+
+
+        * plotting shapes: ``"circle"``, ``"square"``, ``"cross"``, ``"diamond"``,
+          ``"triangle-up"``, ``"triangle-down"``, ``"triangle-right"``, or
+          ``"triangle-left"``.
+        * the line symbol ``"stroke"``
+        * centered directional shapes ``"arrow"``, ``"wedge"``, or ``"triangle"``
+        * a custom `SVG path string
+          <https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths>`__ (For correct
+          sizing, custom shape paths should be defined within a square bounding box with
+          coordinates ranging from -1 to 1 along both the x and y dimensions.)
+
+        **Default value:** ``"circle"``
+    size : dict, float, :class:`ExprRef`
+        Default size for marks.
+
+
+        * For ``point`` / ``circle`` / ``square``, this represents the pixel area of the
+          marks. Note that this value sets the area of the symbol; the side lengths will
+          increase with the square root of this value.
+        * For ``bar``, this represents the band size of the bar, in pixels.
+        * For ``text``, this represents the font size, in pixels.
+
+        **Default value:**
+
+
+        * ``30`` for point, circle, square marks; width/height's ``step``
+        * ``2`` for bar marks with discrete dimensions;
+        * ``5`` for bar marks with continuous dimensions;
+        * ``11`` for text marks.
+    smooth : bool, dict, :class:`ExprRef`
+        A boolean flag (default true) indicating if the image should be smoothed when
+        resized. If false, individual pixels should be scaled directly rather than
+        interpolated with smoothing. For SVG rendering, this option may not work in some
+        browsers due to lack of standardization.
+    startAngle : dict, float, :class:`ExprRef`
+        The start angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    stroke : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default stroke color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove stroke.
+
+        **Default value:** (None)
+    strokeCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for line ending style. One of ``"butt"``, ``"round"``, or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    strokeDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating stroke, space lengths for creating dashed or dotted lines.
+    strokeDashOffset : dict, float, :class:`ExprRef`
+        The offset (in pixels) into which to begin drawing with the stroke dash array.
+    strokeJoin : dict, :class:`ExprRef`, :class:`StrokeJoin`, Literal['miter', 'round', 'bevel']
+        The stroke line join method. One of ``"miter"``, ``"round"`` or ``"bevel"``.
+
+        **Default value:** ``"miter"``
+    strokeMiterLimit : dict, float, :class:`ExprRef`
+        The miter limit at which to bevel a line join.
+    strokeOffset : dict, float, :class:`ExprRef`
+        The offset in pixels at which to draw the group stroke and fill. If unspecified, the
+        default behavior is to dynamically offset stroked groups such that 1 pixel stroke
+        widths align with the pixel grid.
+    strokeOpacity : dict, float, :class:`ExprRef`
+        The stroke opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    strokeWidth : dict, float, :class:`ExprRef`
+        The stroke width, in pixels.
+    tension : dict, float, :class:`ExprRef`
+        Depending on the interpolation type, sets the tension parameter (for line and area
+        marks).
+    text : str, dict, :class:`Text`, Sequence[str], :class:`ExprRef`
+        Placeholder text if the ``text`` channel is not specified
+    theta : dict, float, :class:`ExprRef`
+        For arc marks, the arc length in radians if theta2 is not specified, otherwise the
+        start arc angle. (A value of 0 indicates up or “north”, increasing values proceed
+        clockwise.)
+
+        For text marks, polar coordinate angle in radians.
+    theta2 : dict, float, :class:`ExprRef`
+        The end angle of arc marks in radians. A value of 0 indicates up or “north”,
+        increasing values proceed clockwise.
+    timeUnitBandPosition : float
+        Default relative band position for a time unit. If set to ``0``, the marks will be
+        positioned at the beginning of the time unit band step. If set to ``0.5``, the marks
+        will be positioned in the middle of the time unit band step.
+    timeUnitBandSize : float
+        Default relative band size for a time unit. If set to ``1``, the bandwidth of the
+        marks will be equal to the time unit band step. If set to ``0.5``, bandwidth of the
+        marks will be half of the time unit band step.
+    tooltip : str, bool, dict, None, float, :class:`ExprRef`, :class:`TooltipContent`
+        The tooltip text string to show upon mouse hover or an object defining which fields
+        should the tooltip be derived from.
+
+
+        * If ``tooltip`` is ``true`` or ``{"content": "encoding"}``, then all fields from
+          ``encoding`` will be used.
+        * If ``tooltip`` is ``{"content": "data"}``, then all fields that appear in the
+          highlighted data point will be used.
+        * If set to ``null`` or ``false``, then no tooltip will be used.
+
+        See the `tooltip <https://vega.github.io/vega-lite/docs/tooltip.html>`__
+        documentation for a detailed discussion about tooltip  in Vega-Lite.
+
+        **Default value:** ``null``
+    url : str, dict, :class:`URI`, :class:`ExprRef`
+        The URL of the image file for image marks.
+    width : dict, float, :class:`ExprRef`
+        Width of the marks.
+    x : str, dict, float, :class:`ExprRef`
+        X coordinates of the marks, or width of horizontal ``"bar"`` and ``"area"`` without
+        specified ``x2`` or ``width``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    x2 : str, dict, float, :class:`ExprRef`
+        X2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    y : str, dict, float, :class:`ExprRef`
+        Y coordinates of the marks, or height of vertical ``"bar"`` and ``"area"`` without
+        specified ``y2`` or ``height``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    y2 : str, dict, float, :class:`ExprRef`
+        Y2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    """
+
+    _schema = {"$ref": "#/definitions/AreaConfig"}
+
+    def __init__(
+        self,
+        align: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ariaRole: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        blend: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, "_Parameter", "SchemaBase", Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        dx: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        dy: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ellipsis: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        endAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        fontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        href: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        innerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            "SchemaBase", Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        shape: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        size: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        smooth: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        startAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tension: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, "_Parameter", "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        url: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        width: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(AreaConfig, self).__init__(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            baseline=baseline,
+            blend=blend,
+            color=color,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            endAngle=endAngle,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            startAngle=startAngle,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            y=y,
+            y2=y2,
+            **kwds,
+        )
+
+
+class ArgmaxDef(Aggregate):
+    """ArgmaxDef schema wrapper
+
+    Parameters
+    ----------
+
+    argmax : str, :class:`FieldName`
+
+    """
+
+    _schema = {"$ref": "#/definitions/ArgmaxDef"}
+
+    def __init__(
+        self, argmax: Union[str, "SchemaBase", UndefinedType] = Undefined, **kwds
+    ):
+        super(ArgmaxDef, self).__init__(argmax=argmax, **kwds)
+
+
+class ArgminDef(Aggregate):
+    """ArgminDef schema wrapper
+
+    Parameters
+    ----------
+
+    argmin : str, :class:`FieldName`
+
+    """
+
+    _schema = {"$ref": "#/definitions/ArgminDef"}
+
+    def __init__(
+        self, argmin: Union[str, "SchemaBase", UndefinedType] = Undefined, **kwds
+    ):
+        super(ArgminDef, self).__init__(argmin=argmin, **kwds)
+
+
+class AutoSizeParams(VegaLiteSchema):
+    """AutoSizeParams schema wrapper
+
+    Parameters
+    ----------
+
+    contains : Literal['content', 'padding']
+        Determines how size calculation should be performed, one of ``"content"`` or
+        ``"padding"``. The default setting ( ``"content"`` ) interprets the width and height
+        settings as the data rectangle (plotting) dimensions, to which padding is then
+        added. In contrast, the ``"padding"`` setting includes the padding within the view
+        size calculations, such that the width and height settings indicate the **total**
+        intended size of the view.
+
+        **Default value** : ``"content"``
+    resize : bool
+        A boolean flag indicating if autosize layout should be re-calculated on every view
+        update.
+
+        **Default value** : ``false``
+    type : :class:`AutosizeType`, Literal['pad', 'none', 'fit', 'fit-x', 'fit-y']
+        The sizing format type. One of ``"pad"``, ``"fit"``, ``"fit-x"``, ``"fit-y"``,  or
+        ``"none"``. See the `autosize type
+        <https://vega.github.io/vega-lite/docs/size.html#autosize>`__ documentation for
+        descriptions of each.
+
+        **Default value** : ``"pad"``
+    """
+
+    _schema = {"$ref": "#/definitions/AutoSizeParams"}
+
+    def __init__(
+        self,
+        contains: Union[Literal["content", "padding"], UndefinedType] = Undefined,
+        resize: Union[bool, UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase", Literal["pad", "none", "fit", "fit-x", "fit-y"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(AutoSizeParams, self).__init__(
+            contains=contains, resize=resize, type=type, **kwds
+        )
+
+
+class AutosizeType(VegaLiteSchema):
+    """AutosizeType schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/AutosizeType"}
+
+    def __init__(self, *args):
+        super(AutosizeType, self).__init__(*args)
+
+
+class Axis(VegaLiteSchema):
+    """Axis schema wrapper
+
+    Parameters
+    ----------
+
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG group, removing the axis from the ARIA accessibility tree.
+
+        **Default value:** ``true``
+    bandPosition : dict, float, :class:`ExprRef`
+        An interpolation fraction indicating where, for ``band`` scales, axis ticks should
+        be positioned. A value of ``0`` places ticks at the left edge of their bands. A
+        value of ``0.5`` places ticks in the middle of their bands.
+
+        **Default value:** ``0.5``
+    description : str, dict, :class:`ExprRef`
+        A text description of this axis for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If the ``aria`` property is true, for SVG output the `"aria-label" attribute
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>`__
+        will be set to this description. If the description is unspecified it will be
+        automatically generated.
+    domain : bool
+        A boolean flag indicating if the domain (the axis baseline) should be included as
+        part of the axis.
+
+        **Default value:** ``true``
+    domainCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for the domain line's ending style. One of ``"butt"``, ``"round"`` or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    domainColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Color of axis domain line.
+
+        **Default value:** ``"gray"``.
+    domainDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating [stroke, space] lengths for dashed domain lines.
+    domainDashOffset : dict, float, :class:`ExprRef`
+        The pixel offset at which to start drawing with the domain dash array.
+    domainOpacity : dict, float, :class:`ExprRef`
+        Opacity of the axis domain line.
+    domainWidth : dict, float, :class:`ExprRef`
+        Stroke width of axis domain line
+
+        **Default value:** ``1``
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    grid : bool
+        A boolean flag indicating if grid lines should be included as part of the axis
+
+        **Default value:** ``true`` for `continuous scales
+        <https://vega.github.io/vega-lite/docs/scale.html#continuous>`__ that are not
+        binned; otherwise, ``false``.
+    gridCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for grid lines' ending style. One of ``"butt"``, ``"round"`` or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    gridColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, :class:`ConditionalAxisColor`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Color of gridlines.
+
+        **Default value:** ``"lightGray"``.
+    gridDash : dict, Sequence[float], :class:`ExprRef`, :class:`ConditionalAxisNumberArray`
+        An array of alternating [stroke, space] lengths for dashed grid lines.
+    gridDashOffset : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The pixel offset at which to start drawing with the grid dash array.
+    gridOpacity : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The stroke opacity of grid (value between [0,1])
+
+        **Default value:** ``1``
+    gridWidth : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The grid width, in pixels.
+
+        **Default value:** ``1``
+    labelAlign : dict, :class:`Align`, :class:`ExprRef`, :class:`ConditionalAxisLabelAlign`, Literal['left', 'center', 'right']
+        Horizontal text alignment of axis tick labels, overriding the default setting for
+        the current axis orientation.
+    labelAngle : dict, float, :class:`ExprRef`
+        The rotation angle of the axis labels.
+
+        **Default value:** ``-90`` for nominal and ordinal fields; ``0`` otherwise.
+    labelBaseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom'], :class:`ConditionalAxisLabelBaseline`
+        Vertical text baseline of axis tick labels, overriding the default setting for the
+        current axis orientation. One of ``"alphabetic"`` (default), ``"top"``,
+        ``"middle"``, ``"bottom"``, ``"line-top"``, or ``"line-bottom"``. The ``"line-top"``
+        and ``"line-bottom"`` values operate similarly to ``"top"`` and ``"bottom"``, but
+        are calculated relative to the *lineHeight* rather than *fontSize* alone.
+    labelBound : bool, dict, float, :class:`ExprRef`
+        Indicates if labels should be hidden if they exceed the axis range. If ``false``
+        (the default) no bounds overlap analysis is performed. If ``true``, labels will be
+        hidden if they exceed the axis range by more than 1 pixel. If this property is a
+        number, it specifies the pixel tolerance: the maximum amount by which a label
+        bounding box may exceed the axis range.
+
+        **Default value:** ``false``.
+    labelColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, :class:`ConditionalAxisColor`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the tick label, can be in hex color code or regular color name.
+    labelExpr : str
+        `Vega expression <https://vega.github.io/vega/docs/expressions/>`__ for customizing
+        labels.
+
+        **Note:** The label text and value can be assessed via the ``label`` and ``value``
+        properties of the axis's backing ``datum`` object.
+    labelFlush : bool, float
+        Indicates if the first and last axis labels should be aligned flush with the scale
+        range. Flush alignment for a horizontal axis will left-align the first label and
+        right-align the last label. For vertical axes, bottom and top text baselines are
+        applied instead. If this property is a number, it also indicates the number of
+        pixels by which to offset the first and last labels; for example, a value of 2 will
+        flush-align the first and last labels and also push them 2 pixels outward from the
+        center of the axis. The additional adjustment can sometimes help the labels better
+        visually group with corresponding axis ticks.
+
+        **Default value:** ``true`` for axis of a continuous x-scale. Otherwise, ``false``.
+    labelFlushOffset : dict, float, :class:`ExprRef`
+        Indicates the number of pixels by which to offset flush-adjusted labels. For
+        example, a value of ``2`` will push flush-adjusted labels 2 pixels outward from the
+        center of the axis. Offsets can help the labels better visually group with
+        corresponding axis ticks.
+
+        **Default value:** ``0``.
+    labelFont : str, dict, :class:`ExprRef`, :class:`ConditionalAxisString`
+        The font of the tick label.
+    labelFontSize : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The font size of the label, in pixels.
+    labelFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`, :class:`ConditionalAxisLabelFontStyle`
+        Font style of the title.
+    labelFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, :class:`ConditionalAxisLabelFontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        Font weight of axis tick labels.
+    labelLimit : dict, float, :class:`ExprRef`
+        Maximum allowed pixel width of axis tick labels.
+
+        **Default value:** ``180``
+    labelLineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line label text or label text with ``"line-top"`` or
+        ``"line-bottom"`` baseline.
+    labelOffset : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        Position offset in pixels to apply to labels, in addition to tickOffset.
+
+        **Default value:** ``0``
+    labelOpacity : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The opacity of the labels.
+    labelOverlap : str, bool, dict, :class:`ExprRef`, :class:`LabelOverlap`
+        The strategy to use for resolving overlap of axis labels. If ``false`` (the
+        default), no overlap reduction is attempted. If set to ``true`` or ``"parity"``, a
+        strategy of removing every other label is used (this works well for standard linear
+        axes). If set to ``"greedy"``, a linear scan of the labels is performed, removing
+        any labels that overlaps with the last visible label (this often works better for
+        log-scaled axes).
+
+        **Default value:** ``true`` for non-nominal fields with non-log scales; ``"greedy"``
+        for log scales; otherwise ``false``.
+    labelPadding : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The padding in pixels between labels and ticks.
+
+        **Default value:** ``2``
+    labelSeparation : dict, float, :class:`ExprRef`
+        The minimum separation that must be between label bounding boxes for them to be
+        considered non-overlapping (default ``0`` ). This property is ignored if
+        *labelOverlap* resolution is not enabled.
+    labels : bool
+        A boolean flag indicating if labels should be included as part of the axis.
+
+        **Default value:** ``true``.
+    maxExtent : dict, float, :class:`ExprRef`
+        The maximum extent in pixels that axis ticks and labels should use. This determines
+        a maximum offset value for axis titles.
+
+        **Default value:** ``undefined``.
+    minExtent : dict, float, :class:`ExprRef`
+        The minimum extent in pixels that axis ticks and labels should use. This determines
+        a minimum offset value for axis titles.
+
+        **Default value:** ``30`` for y-axis; ``undefined`` for x-axis.
+    offset : dict, float, :class:`ExprRef`
+        The offset, in pixels, by which to displace the axis from the edge of the enclosing
+        group or data rectangle.
+
+        **Default value:** derived from the `axis config
+        <https://vega.github.io/vega-lite/docs/config.html#facet-scale-config>`__ 's
+        ``offset`` ( ``0`` by default)
+    orient : dict, :class:`ExprRef`, :class:`AxisOrient`, Literal['top', 'bottom', 'left', 'right']
+        The orientation of the axis. One of ``"top"``, ``"bottom"``, ``"left"`` or
+        ``"right"``. The orientation can be used to further specialize the axis type (e.g.,
+        a y-axis oriented towards the right edge of the chart).
+
+        **Default value:** ``"bottom"`` for x-axes and ``"left"`` for y-axes.
+    position : dict, float, :class:`ExprRef`
+        The anchor position of the axis in pixels. For x-axes with top or bottom
+        orientation, this sets the axis group x coordinate. For y-axes with left or right
+        orientation, this sets the axis group y coordinate.
+
+        **Default value** : ``0``
+    style : str, Sequence[str]
+        A string or array of strings indicating the name of custom styles to apply to the
+        axis. A style is a named collection of axis property defined within the `style
+        configuration <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__. If
+        style is an array, later styles will override earlier styles.
+
+        **Default value:** (none) **Note:** Any specified style will augment the default
+        style. For example, an x-axis mark with ``"style": "foo"`` will use ``config.axisX``
+        and ``config.style.foo`` (the specified style ``"foo"`` has higher precedence).
+    tickBand : dict, :class:`ExprRef`, Literal['center', 'extent']
+        For band scales, indicates if ticks and grid lines should be placed at the
+        ``"center"`` of a band (default) or at the band ``"extent"`` s to indicate intervals
+    tickCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for the tick lines' ending style. One of ``"butt"``, ``"round"`` or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    tickColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, :class:`ConditionalAxisColor`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the axis's tick.
+
+        **Default value:** ``"gray"``
+    tickCount : dict, float, :class:`ExprRef`, :class:`TimeInterval`, :class:`TimeIntervalStep`, Literal['millisecond', 'second', 'minute', 'hour', 'day', 'week', 'month', 'year']
+        A desired number of ticks, for axes visualizing quantitative scales. The resulting
+        number may be different so that values are "nice" (multiples of 2, 5, 10) and lie
+        within the underlying scale's range.
+
+        For scales of type ``"time"`` or ``"utc"``, the tick count can instead be a time
+        interval specifier. Legal string values are ``"millisecond"``, ``"second"``,
+        ``"minute"``, ``"hour"``, ``"day"``, ``"week"``, ``"month"``, and ``"year"``.
+        Alternatively, an object-valued interval specifier of the form ``{"interval":
+        "month", "step": 3}`` includes a desired number of interval steps. Here, ticks are
+        generated for each quarter (Jan, Apr, Jul, Oct) boundary.
+
+        **Default value** : Determine using a formula ``ceil(width/40)`` for x and
+        ``ceil(height/40)`` for y.
+    tickDash : dict, Sequence[float], :class:`ExprRef`, :class:`ConditionalAxisNumberArray`
+        An array of alternating [stroke, space] lengths for dashed tick mark lines.
+    tickDashOffset : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The pixel offset at which to start drawing with the tick mark dash array.
+    tickExtra : bool
+        Boolean flag indicating if an extra axis tick should be added for the initial
+        position of the axis. This flag is useful for styling axes for ``band`` scales such
+        that ticks are placed on band boundaries rather in the middle of a band. Use in
+        conjunction with ``"bandPosition": 1`` and an axis ``"padding"`` value of ``0``.
+    tickMinStep : dict, float, :class:`ExprRef`
+        The minimum desired step between axis ticks, in terms of scale domain values. For
+        example, a value of ``1`` indicates that ticks should not be less than 1 unit apart.
+        If ``tickMinStep`` is specified, the ``tickCount`` value will be adjusted, if
+        necessary, to enforce the minimum step value.
+    tickOffset : dict, float, :class:`ExprRef`
+        Position offset in pixels to apply to ticks, labels, and gridlines.
+    tickOpacity : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        Opacity of the ticks.
+    tickRound : bool
+        Boolean flag indicating if pixel position values should be rounded to the nearest
+        integer.
+
+        **Default value:** ``true``
+    tickSize : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The size in pixels of axis ticks.
+
+        **Default value:** ``5``
+    tickWidth : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The width, in pixels, of ticks.
+
+        **Default value:** ``1``
+    ticks : bool
+        Boolean value that determines whether the axis should include ticks.
+
+        **Default value:** ``true``
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    titleAlign : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        Horizontal text alignment of axis titles.
+    titleAnchor : dict, :class:`ExprRef`, :class:`TitleAnchor`, Literal[None, 'start', 'middle', 'end']
+        Text anchor position for placing axis titles.
+    titleAngle : dict, float, :class:`ExprRef`
+        Angle in degrees of axis titles.
+    titleBaseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        Vertical text baseline for axis titles. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, or ``"line-bottom"``. The
+        ``"line-top"`` and ``"line-bottom"`` values operate similarly to ``"top"`` and
+        ``"bottom"``, but are calculated relative to the *lineHeight* rather than *fontSize*
+        alone.
+    titleColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Color of the title, can be in hex color code or regular color name.
+    titleFont : str, dict, :class:`ExprRef`
+        Font of the title. (e.g., ``"Helvetica Neue"`` ).
+    titleFontSize : dict, float, :class:`ExprRef`
+        Font size of the title.
+    titleFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        Font style of the title.
+    titleFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        Font weight of the title. This can be either a string (e.g ``"bold"``, ``"normal"``
+        ) or a number ( ``100``, ``200``, ``300``, ..., ``900`` where ``"normal"`` = ``400``
+        and ``"bold"`` = ``700`` ).
+    titleLimit : dict, float, :class:`ExprRef`
+        Maximum allowed pixel width of axis titles.
+    titleLineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line title text or title text with ``"line-top"`` or
+        ``"line-bottom"`` baseline.
+    titleOpacity : dict, float, :class:`ExprRef`
+        Opacity of the axis title.
+    titlePadding : dict, float, :class:`ExprRef`
+        The padding, in pixels, between title and axis.
+    titleX : dict, float, :class:`ExprRef`
+        X-coordinate of the axis title relative to the axis group.
+    titleY : dict, float, :class:`ExprRef`
+        Y-coordinate of the axis title relative to the axis group.
+    translate : dict, float, :class:`ExprRef`
+        Coordinate space translation offset for axis layout. By default, axes are translated
+        by a 0.5 pixel offset for both the x and y coordinates in order to align stroked
+        lines with the pixel grid. However, for vector graphics output these pixel-specific
+        adjustments may be undesirable, in which case translate can be changed (for example,
+        to zero).
+
+        **Default value:** ``0.5``
+    values : dict, Sequence[str], Sequence[bool], Sequence[float], :class:`ExprRef`, Sequence[dict, :class:`DateTime`]
+        Explicitly set the visible axis tick values.
+    zindex : float
+        A non-negative integer indicating the z-index of the axis. If zindex is 0, axes
+        should be drawn behind all chart elements. To put them in front, set ``zindex`` to
+        ``1`` or more.
+
+        **Default value:** ``0`` (behind the marks).
+    """
+
+    _schema = {"$ref": "#/definitions/Axis"}
+
+    def __init__(
+        self,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        bandPosition: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        domain: Union[bool, UndefinedType] = Undefined,
+        domainCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        domainColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        domainDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        domainOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        domainWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        format: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        grid: Union[bool, UndefinedType] = Undefined,
+        gridCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        gridColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gridDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        gridDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gridOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gridWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelBound: Union[
+            bool, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFlush: Union[bool, float, UndefinedType] = Undefined,
+        labelFlushOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelLineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labels: Union[bool, UndefinedType] = Undefined,
+        maxExtent: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        minExtent: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        orient: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "bottom", "left", "right"],
+            UndefinedType,
+        ] = Undefined,
+        position: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tickBand: Union[
+            dict, "_Parameter", "SchemaBase", Literal["center", "extent"], UndefinedType
+        ] = Undefined,
+        tickCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        tickColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        tickDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tickExtra: Union[bool, UndefinedType] = Undefined,
+        tickMinStep: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tickOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tickOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tickRound: Union[bool, UndefinedType] = Undefined,
+        tickSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tickWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        ticks: Union[bool, UndefinedType] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        titleAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleX: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleY: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        translate: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        values: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Sequence[Union[dict, "SchemaBase"]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(Axis, self).__init__(
+            aria=aria,
+            bandPosition=bandPosition,
+            description=description,
+            domain=domain,
+            domainCap=domainCap,
+            domainColor=domainColor,
+            domainDash=domainDash,
+            domainDashOffset=domainDashOffset,
+            domainOpacity=domainOpacity,
+            domainWidth=domainWidth,
+            format=format,
+            formatType=formatType,
+            grid=grid,
+            gridCap=gridCap,
+            gridColor=gridColor,
+            gridDash=gridDash,
+            gridDashOffset=gridDashOffset,
+            gridOpacity=gridOpacity,
+            gridWidth=gridWidth,
+            labelAlign=labelAlign,
+            labelAngle=labelAngle,
+            labelBaseline=labelBaseline,
+            labelBound=labelBound,
+            labelColor=labelColor,
+            labelExpr=labelExpr,
+            labelFlush=labelFlush,
+            labelFlushOffset=labelFlushOffset,
+            labelFont=labelFont,
+            labelFontSize=labelFontSize,
+            labelFontStyle=labelFontStyle,
+            labelFontWeight=labelFontWeight,
+            labelLimit=labelLimit,
+            labelLineHeight=labelLineHeight,
+            labelOffset=labelOffset,
+            labelOpacity=labelOpacity,
+            labelOverlap=labelOverlap,
+            labelPadding=labelPadding,
+            labelSeparation=labelSeparation,
+            labels=labels,
+            maxExtent=maxExtent,
+            minExtent=minExtent,
+            offset=offset,
+            orient=orient,
+            position=position,
+            style=style,
+            tickBand=tickBand,
+            tickCap=tickCap,
+            tickColor=tickColor,
+            tickCount=tickCount,
+            tickDash=tickDash,
+            tickDashOffset=tickDashOffset,
+            tickExtra=tickExtra,
+            tickMinStep=tickMinStep,
+            tickOffset=tickOffset,
+            tickOpacity=tickOpacity,
+            tickRound=tickRound,
+            tickSize=tickSize,
+            tickWidth=tickWidth,
+            ticks=ticks,
+            title=title,
+            titleAlign=titleAlign,
+            titleAnchor=titleAnchor,
+            titleAngle=titleAngle,
+            titleBaseline=titleBaseline,
+            titleColor=titleColor,
+            titleFont=titleFont,
+            titleFontSize=titleFontSize,
+            titleFontStyle=titleFontStyle,
+            titleFontWeight=titleFontWeight,
+            titleLimit=titleLimit,
+            titleLineHeight=titleLineHeight,
+            titleOpacity=titleOpacity,
+            titlePadding=titlePadding,
+            titleX=titleX,
+            titleY=titleY,
+            translate=translate,
+            values=values,
+            zindex=zindex,
+            **kwds,
+        )
+
+
+class AxisConfig(VegaLiteSchema):
+    """AxisConfig schema wrapper
+
+    Parameters
+    ----------
+
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG group, removing the axis from the ARIA accessibility tree.
+
+        **Default value:** ``true``
+    bandPosition : dict, float, :class:`ExprRef`
+        An interpolation fraction indicating where, for ``band`` scales, axis ticks should
+        be positioned. A value of ``0`` places ticks at the left edge of their bands. A
+        value of ``0.5`` places ticks in the middle of their bands.
+
+        **Default value:** ``0.5``
+    description : str, dict, :class:`ExprRef`
+        A text description of this axis for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If the ``aria`` property is true, for SVG output the `"aria-label" attribute
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>`__
+        will be set to this description. If the description is unspecified it will be
+        automatically generated.
+    disable : bool
+        Disable axis by default.
+    domain : bool
+        A boolean flag indicating if the domain (the axis baseline) should be included as
+        part of the axis.
+
+        **Default value:** ``true``
+    domainCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for the domain line's ending style. One of ``"butt"``, ``"round"`` or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    domainColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Color of axis domain line.
+
+        **Default value:** ``"gray"``.
+    domainDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating [stroke, space] lengths for dashed domain lines.
+    domainDashOffset : dict, float, :class:`ExprRef`
+        The pixel offset at which to start drawing with the domain dash array.
+    domainOpacity : dict, float, :class:`ExprRef`
+        Opacity of the axis domain line.
+    domainWidth : dict, float, :class:`ExprRef`
+        Stroke width of axis domain line
+
+        **Default value:** ``1``
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    grid : bool
+        A boolean flag indicating if grid lines should be included as part of the axis
+
+        **Default value:** ``true`` for `continuous scales
+        <https://vega.github.io/vega-lite/docs/scale.html#continuous>`__ that are not
+        binned; otherwise, ``false``.
+    gridCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for grid lines' ending style. One of ``"butt"``, ``"round"`` or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    gridColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, :class:`ConditionalAxisColor`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Color of gridlines.
+
+        **Default value:** ``"lightGray"``.
+    gridDash : dict, Sequence[float], :class:`ExprRef`, :class:`ConditionalAxisNumberArray`
+        An array of alternating [stroke, space] lengths for dashed grid lines.
+    gridDashOffset : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The pixel offset at which to start drawing with the grid dash array.
+    gridOpacity : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The stroke opacity of grid (value between [0,1])
+
+        **Default value:** ``1``
+    gridWidth : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The grid width, in pixels.
+
+        **Default value:** ``1``
+    labelAlign : dict, :class:`Align`, :class:`ExprRef`, :class:`ConditionalAxisLabelAlign`, Literal['left', 'center', 'right']
+        Horizontal text alignment of axis tick labels, overriding the default setting for
+        the current axis orientation.
+    labelAngle : dict, float, :class:`ExprRef`
+        The rotation angle of the axis labels.
+
+        **Default value:** ``-90`` for nominal and ordinal fields; ``0`` otherwise.
+    labelBaseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom'], :class:`ConditionalAxisLabelBaseline`
+        Vertical text baseline of axis tick labels, overriding the default setting for the
+        current axis orientation. One of ``"alphabetic"`` (default), ``"top"``,
+        ``"middle"``, ``"bottom"``, ``"line-top"``, or ``"line-bottom"``. The ``"line-top"``
+        and ``"line-bottom"`` values operate similarly to ``"top"`` and ``"bottom"``, but
+        are calculated relative to the *lineHeight* rather than *fontSize* alone.
+    labelBound : bool, dict, float, :class:`ExprRef`
+        Indicates if labels should be hidden if they exceed the axis range. If ``false``
+        (the default) no bounds overlap analysis is performed. If ``true``, labels will be
+        hidden if they exceed the axis range by more than 1 pixel. If this property is a
+        number, it specifies the pixel tolerance: the maximum amount by which a label
+        bounding box may exceed the axis range.
+
+        **Default value:** ``false``.
+    labelColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, :class:`ConditionalAxisColor`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the tick label, can be in hex color code or regular color name.
+    labelExpr : str
+        `Vega expression <https://vega.github.io/vega/docs/expressions/>`__ for customizing
+        labels.
+
+        **Note:** The label text and value can be assessed via the ``label`` and ``value``
+        properties of the axis's backing ``datum`` object.
+    labelFlush : bool, float
+        Indicates if the first and last axis labels should be aligned flush with the scale
+        range. Flush alignment for a horizontal axis will left-align the first label and
+        right-align the last label. For vertical axes, bottom and top text baselines are
+        applied instead. If this property is a number, it also indicates the number of
+        pixels by which to offset the first and last labels; for example, a value of 2 will
+        flush-align the first and last labels and also push them 2 pixels outward from the
+        center of the axis. The additional adjustment can sometimes help the labels better
+        visually group with corresponding axis ticks.
+
+        **Default value:** ``true`` for axis of a continuous x-scale. Otherwise, ``false``.
+    labelFlushOffset : dict, float, :class:`ExprRef`
+        Indicates the number of pixels by which to offset flush-adjusted labels. For
+        example, a value of ``2`` will push flush-adjusted labels 2 pixels outward from the
+        center of the axis. Offsets can help the labels better visually group with
+        corresponding axis ticks.
+
+        **Default value:** ``0``.
+    labelFont : str, dict, :class:`ExprRef`, :class:`ConditionalAxisString`
+        The font of the tick label.
+    labelFontSize : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The font size of the label, in pixels.
+    labelFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`, :class:`ConditionalAxisLabelFontStyle`
+        Font style of the title.
+    labelFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, :class:`ConditionalAxisLabelFontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        Font weight of axis tick labels.
+    labelLimit : dict, float, :class:`ExprRef`
+        Maximum allowed pixel width of axis tick labels.
+
+        **Default value:** ``180``
+    labelLineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line label text or label text with ``"line-top"`` or
+        ``"line-bottom"`` baseline.
+    labelOffset : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        Position offset in pixels to apply to labels, in addition to tickOffset.
+
+        **Default value:** ``0``
+    labelOpacity : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The opacity of the labels.
+    labelOverlap : str, bool, dict, :class:`ExprRef`, :class:`LabelOverlap`
+        The strategy to use for resolving overlap of axis labels. If ``false`` (the
+        default), no overlap reduction is attempted. If set to ``true`` or ``"parity"``, a
+        strategy of removing every other label is used (this works well for standard linear
+        axes). If set to ``"greedy"``, a linear scan of the labels is performed, removing
+        any labels that overlaps with the last visible label (this often works better for
+        log-scaled axes).
+
+        **Default value:** ``true`` for non-nominal fields with non-log scales; ``"greedy"``
+        for log scales; otherwise ``false``.
+    labelPadding : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The padding in pixels between labels and ticks.
+
+        **Default value:** ``2``
+    labelSeparation : dict, float, :class:`ExprRef`
+        The minimum separation that must be between label bounding boxes for them to be
+        considered non-overlapping (default ``0`` ). This property is ignored if
+        *labelOverlap* resolution is not enabled.
+    labels : bool
+        A boolean flag indicating if labels should be included as part of the axis.
+
+        **Default value:** ``true``.
+    maxExtent : dict, float, :class:`ExprRef`
+        The maximum extent in pixels that axis ticks and labels should use. This determines
+        a maximum offset value for axis titles.
+
+        **Default value:** ``undefined``.
+    minExtent : dict, float, :class:`ExprRef`
+        The minimum extent in pixels that axis ticks and labels should use. This determines
+        a minimum offset value for axis titles.
+
+        **Default value:** ``30`` for y-axis; ``undefined`` for x-axis.
+    offset : dict, float, :class:`ExprRef`
+        The offset, in pixels, by which to displace the axis from the edge of the enclosing
+        group or data rectangle.
+
+        **Default value:** derived from the `axis config
+        <https://vega.github.io/vega-lite/docs/config.html#facet-scale-config>`__ 's
+        ``offset`` ( ``0`` by default)
+    orient : dict, :class:`ExprRef`, :class:`AxisOrient`, Literal['top', 'bottom', 'left', 'right']
+        The orientation of the axis. One of ``"top"``, ``"bottom"``, ``"left"`` or
+        ``"right"``. The orientation can be used to further specialize the axis type (e.g.,
+        a y-axis oriented towards the right edge of the chart).
+
+        **Default value:** ``"bottom"`` for x-axes and ``"left"`` for y-axes.
+    position : dict, float, :class:`ExprRef`
+        The anchor position of the axis in pixels. For x-axes with top or bottom
+        orientation, this sets the axis group x coordinate. For y-axes with left or right
+        orientation, this sets the axis group y coordinate.
+
+        **Default value** : ``0``
+    style : str, Sequence[str]
+        A string or array of strings indicating the name of custom styles to apply to the
+        axis. A style is a named collection of axis property defined within the `style
+        configuration <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__. If
+        style is an array, later styles will override earlier styles.
+
+        **Default value:** (none) **Note:** Any specified style will augment the default
+        style. For example, an x-axis mark with ``"style": "foo"`` will use ``config.axisX``
+        and ``config.style.foo`` (the specified style ``"foo"`` has higher precedence).
+    tickBand : dict, :class:`ExprRef`, Literal['center', 'extent']
+        For band scales, indicates if ticks and grid lines should be placed at the
+        ``"center"`` of a band (default) or at the band ``"extent"`` s to indicate intervals
+    tickCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for the tick lines' ending style. One of ``"butt"``, ``"round"`` or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    tickColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, :class:`ConditionalAxisColor`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the axis's tick.
+
+        **Default value:** ``"gray"``
+    tickCount : dict, float, :class:`ExprRef`, :class:`TimeInterval`, :class:`TimeIntervalStep`, Literal['millisecond', 'second', 'minute', 'hour', 'day', 'week', 'month', 'year']
+        A desired number of ticks, for axes visualizing quantitative scales. The resulting
+        number may be different so that values are "nice" (multiples of 2, 5, 10) and lie
+        within the underlying scale's range.
+
+        For scales of type ``"time"`` or ``"utc"``, the tick count can instead be a time
+        interval specifier. Legal string values are ``"millisecond"``, ``"second"``,
+        ``"minute"``, ``"hour"``, ``"day"``, ``"week"``, ``"month"``, and ``"year"``.
+        Alternatively, an object-valued interval specifier of the form ``{"interval":
+        "month", "step": 3}`` includes a desired number of interval steps. Here, ticks are
+        generated for each quarter (Jan, Apr, Jul, Oct) boundary.
+
+        **Default value** : Determine using a formula ``ceil(width/40)`` for x and
+        ``ceil(height/40)`` for y.
+    tickDash : dict, Sequence[float], :class:`ExprRef`, :class:`ConditionalAxisNumberArray`
+        An array of alternating [stroke, space] lengths for dashed tick mark lines.
+    tickDashOffset : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The pixel offset at which to start drawing with the tick mark dash array.
+    tickExtra : bool
+        Boolean flag indicating if an extra axis tick should be added for the initial
+        position of the axis. This flag is useful for styling axes for ``band`` scales such
+        that ticks are placed on band boundaries rather in the middle of a band. Use in
+        conjunction with ``"bandPosition": 1`` and an axis ``"padding"`` value of ``0``.
+    tickMinStep : dict, float, :class:`ExprRef`
+        The minimum desired step between axis ticks, in terms of scale domain values. For
+        example, a value of ``1`` indicates that ticks should not be less than 1 unit apart.
+        If ``tickMinStep`` is specified, the ``tickCount`` value will be adjusted, if
+        necessary, to enforce the minimum step value.
+    tickOffset : dict, float, :class:`ExprRef`
+        Position offset in pixels to apply to ticks, labels, and gridlines.
+    tickOpacity : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        Opacity of the ticks.
+    tickRound : bool
+        Boolean flag indicating if pixel position values should be rounded to the nearest
+        integer.
+
+        **Default value:** ``true``
+    tickSize : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The size in pixels of axis ticks.
+
+        **Default value:** ``5``
+    tickWidth : dict, float, :class:`ExprRef`, :class:`ConditionalAxisNumber`
+        The width, in pixels, of ticks.
+
+        **Default value:** ``1``
+    ticks : bool
+        Boolean value that determines whether the axis should include ticks.
+
+        **Default value:** ``true``
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    titleAlign : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        Horizontal text alignment of axis titles.
+    titleAnchor : dict, :class:`ExprRef`, :class:`TitleAnchor`, Literal[None, 'start', 'middle', 'end']
+        Text anchor position for placing axis titles.
+    titleAngle : dict, float, :class:`ExprRef`
+        Angle in degrees of axis titles.
+    titleBaseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        Vertical text baseline for axis titles. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, or ``"line-bottom"``. The
+        ``"line-top"`` and ``"line-bottom"`` values operate similarly to ``"top"`` and
+        ``"bottom"``, but are calculated relative to the *lineHeight* rather than *fontSize*
+        alone.
+    titleColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Color of the title, can be in hex color code or regular color name.
+    titleFont : str, dict, :class:`ExprRef`
+        Font of the title. (e.g., ``"Helvetica Neue"`` ).
+    titleFontSize : dict, float, :class:`ExprRef`
+        Font size of the title.
+    titleFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        Font style of the title.
+    titleFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        Font weight of the title. This can be either a string (e.g ``"bold"``, ``"normal"``
+        ) or a number ( ``100``, ``200``, ``300``, ..., ``900`` where ``"normal"`` = ``400``
+        and ``"bold"`` = ``700`` ).
+    titleLimit : dict, float, :class:`ExprRef`
+        Maximum allowed pixel width of axis titles.
+    titleLineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line title text or title text with ``"line-top"`` or
+        ``"line-bottom"`` baseline.
+    titleOpacity : dict, float, :class:`ExprRef`
+        Opacity of the axis title.
+    titlePadding : dict, float, :class:`ExprRef`
+        The padding, in pixels, between title and axis.
+    titleX : dict, float, :class:`ExprRef`
+        X-coordinate of the axis title relative to the axis group.
+    titleY : dict, float, :class:`ExprRef`
+        Y-coordinate of the axis title relative to the axis group.
+    translate : dict, float, :class:`ExprRef`
+        Coordinate space translation offset for axis layout. By default, axes are translated
+        by a 0.5 pixel offset for both the x and y coordinates in order to align stroked
+        lines with the pixel grid. However, for vector graphics output these pixel-specific
+        adjustments may be undesirable, in which case translate can be changed (for example,
+        to zero).
+
+        **Default value:** ``0.5``
+    values : dict, Sequence[str], Sequence[bool], Sequence[float], :class:`ExprRef`, Sequence[dict, :class:`DateTime`]
+        Explicitly set the visible axis tick values.
+    zindex : float
+        A non-negative integer indicating the z-index of the axis. If zindex is 0, axes
+        should be drawn behind all chart elements. To put them in front, set ``zindex`` to
+        ``1`` or more.
+
+        **Default value:** ``0`` (behind the marks).
+    """
+
+    _schema = {"$ref": "#/definitions/AxisConfig"}
+
+    def __init__(
+        self,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        bandPosition: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        disable: Union[bool, UndefinedType] = Undefined,
+        domain: Union[bool, UndefinedType] = Undefined,
+        domainCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        domainColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        domainDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        domainDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        domainOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        domainWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        format: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        grid: Union[bool, UndefinedType] = Undefined,
+        gridCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        gridColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gridDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        gridDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gridOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gridWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelBound: Union[
+            bool, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFlush: Union[bool, float, UndefinedType] = Undefined,
+        labelFlushOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelLineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labels: Union[bool, UndefinedType] = Undefined,
+        maxExtent: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        minExtent: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        orient: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "bottom", "left", "right"],
+            UndefinedType,
+        ] = Undefined,
+        position: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tickBand: Union[
+            dict, "_Parameter", "SchemaBase", Literal["center", "extent"], UndefinedType
+        ] = Undefined,
+        tickCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        tickColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        tickDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tickExtra: Union[bool, UndefinedType] = Undefined,
+        tickMinStep: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tickOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tickOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tickRound: Union[bool, UndefinedType] = Undefined,
+        tickSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tickWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        ticks: Union[bool, UndefinedType] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        titleAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleX: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleY: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        translate: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        values: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Sequence[Union[dict, "SchemaBase"]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(AxisConfig, self).__init__(
+            aria=aria,
+            bandPosition=bandPosition,
+            description=description,
+            disable=disable,
+            domain=domain,
+            domainCap=domainCap,
+            domainColor=domainColor,
+            domainDash=domainDash,
+            domainDashOffset=domainDashOffset,
+            domainOpacity=domainOpacity,
+            domainWidth=domainWidth,
+            format=format,
+            formatType=formatType,
+            grid=grid,
+            gridCap=gridCap,
+            gridColor=gridColor,
+            gridDash=gridDash,
+            gridDashOffset=gridDashOffset,
+            gridOpacity=gridOpacity,
+            gridWidth=gridWidth,
+            labelAlign=labelAlign,
+            labelAngle=labelAngle,
+            labelBaseline=labelBaseline,
+            labelBound=labelBound,
+            labelColor=labelColor,
+            labelExpr=labelExpr,
+            labelFlush=labelFlush,
+            labelFlushOffset=labelFlushOffset,
+            labelFont=labelFont,
+            labelFontSize=labelFontSize,
+            labelFontStyle=labelFontStyle,
+            labelFontWeight=labelFontWeight,
+            labelLimit=labelLimit,
+            labelLineHeight=labelLineHeight,
+            labelOffset=labelOffset,
+            labelOpacity=labelOpacity,
+            labelOverlap=labelOverlap,
+            labelPadding=labelPadding,
+            labelSeparation=labelSeparation,
+            labels=labels,
+            maxExtent=maxExtent,
+            minExtent=minExtent,
+            offset=offset,
+            orient=orient,
+            position=position,
+            style=style,
+            tickBand=tickBand,
+            tickCap=tickCap,
+            tickColor=tickColor,
+            tickCount=tickCount,
+            tickDash=tickDash,
+            tickDashOffset=tickDashOffset,
+            tickExtra=tickExtra,
+            tickMinStep=tickMinStep,
+            tickOffset=tickOffset,
+            tickOpacity=tickOpacity,
+            tickRound=tickRound,
+            tickSize=tickSize,
+            tickWidth=tickWidth,
+            ticks=ticks,
+            title=title,
+            titleAlign=titleAlign,
+            titleAnchor=titleAnchor,
+            titleAngle=titleAngle,
+            titleBaseline=titleBaseline,
+            titleColor=titleColor,
+            titleFont=titleFont,
+            titleFontSize=titleFontSize,
+            titleFontStyle=titleFontStyle,
+            titleFontWeight=titleFontWeight,
+            titleLimit=titleLimit,
+            titleLineHeight=titleLineHeight,
+            titleOpacity=titleOpacity,
+            titlePadding=titlePadding,
+            titleX=titleX,
+            titleY=titleY,
+            translate=translate,
+            values=values,
+            zindex=zindex,
+            **kwds,
+        )
+
+
+class AxisOrient(VegaLiteSchema):
+    """AxisOrient schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/AxisOrient"}
+
+    def __init__(self, *args):
+        super(AxisOrient, self).__init__(*args)
+
+
+class AxisResolveMap(VegaLiteSchema):
+    """AxisResolveMap schema wrapper
+
+    Parameters
+    ----------
+
+    x : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    y : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    """
+
+    _schema = {"$ref": "#/definitions/AxisResolveMap"}
+
+    def __init__(
+        self,
+        x: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        y: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(AxisResolveMap, self).__init__(x=x, y=y, **kwds)
+
+
+class BBox(VegaLiteSchema):
+    """BBox schema wrapper
+    Bounding box https://tools.ietf.org/html/rfc7946#section-5
+    """
+
+    _schema = {"$ref": "#/definitions/BBox"}
+
+    def __init__(self, *args, **kwds):
+        super(BBox, self).__init__(*args, **kwds)
+
+
+class BarConfig(AnyMarkConfig):
+    """BarConfig schema wrapper
+
+    Parameters
+    ----------
+
+    align : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule).
+        One of ``"left"``, ``"right"``, ``"center"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    angle : dict, float, :class:`ExprRef`
+        The rotation angle of the text, in degrees.
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG element, removing the mark item from the ARIA accessibility tree.
+    ariaRole : str, dict, :class:`ExprRef`
+        Sets the type of user interface element of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "role" attribute. Warning: this
+        property is experimental and may be changed in the future.
+    ariaRoleDescription : str, dict, :class:`ExprRef`
+        A human-readable, author-localized description for the role of the mark item for
+        `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "aria-roledescription" attribute.
+        Warning: this property is experimental and may be changed in the future.
+    aspect : bool, dict, :class:`ExprRef`
+        Whether to keep aspect ratio of image marks.
+    baseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        For text marks, the vertical text baseline. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, ``"line-bottom"``, or an
+        expression reference that provides one of the valid values. The ``"line-top"`` and
+        ``"line-bottom"`` values operate similarly to ``"top"`` and ``"bottom"``, but are
+        calculated relative to the ``lineHeight`` rather than ``fontSize`` alone.
+
+        For range marks, the vertical alignment of the marks. One of ``"top"``,
+        ``"middle"``, ``"bottom"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    binSpacing : float
+        Offset between bars for binned field. The ideal value for this is either 0
+        (preferred by statisticians) or 1 (Vega-Lite default, D3 example style).
+
+        **Default value:** ``1``
+    blend : dict, :class:`Blend`, :class:`ExprRef`, Literal[None, 'multiply', 'screen', 'overlay', 'darken', 'lighten', 'color-dodge', 'color-burn', 'hard-light', 'soft-light', 'difference', 'exclusion', 'hue', 'saturation', 'color', 'luminosity']
+        The color blend mode for drawing an item on its current background. Any valid `CSS
+        mix-blend-mode <https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode>`__
+        value can be used.
+
+        __Default value:__ ``"source-over"``
+    color : str, dict, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default color.
+
+        **Default value:** :raw-html:`<span style="color: #4682b4;">&#9632;</span>`
+        ``"#4682b4"``
+
+        **Note:**
+
+
+        * This property cannot be used in a `style config
+          <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+        * The ``fill`` and ``stroke`` properties have higher precedence than ``color`` and
+          will override ``color``.
+    continuousBandSize : float
+        The default size of the bars on continuous scales.
+
+        **Default value:** ``5``
+    cornerRadius : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles or arcs' corners.
+
+        **Default value:** ``0``
+    cornerRadiusBottomLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom left corner.
+
+        **Default value:** ``0``
+    cornerRadiusBottomRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom right corner.
+
+        **Default value:** ``0``
+    cornerRadiusEnd : dict, float, :class:`ExprRef`
+        For vertical bars, top-left and top-right corner radius.
+
+        For horizontal bars, top-right and bottom-right corner radius.
+    cornerRadiusTopLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top left corner.
+
+        **Default value:** ``0``
+    cursor : dict, :class:`Cursor`, :class:`ExprRef`, Literal['auto', 'default', 'none', 'context-menu', 'help', 'pointer', 'progress', 'wait', 'cell', 'crosshair', 'text', 'vertical-text', 'alias', 'copy', 'move', 'no-drop', 'not-allowed', 'e-resize', 'n-resize', 'ne-resize', 'nw-resize', 's-resize', 'se-resize', 'sw-resize', 'w-resize', 'ew-resize', 'ns-resize', 'nesw-resize', 'nwse-resize', 'col-resize', 'row-resize', 'all-scroll', 'zoom-in', 'zoom-out', 'grab', 'grabbing']
+        The mouse cursor used over the mark. Any valid `CSS cursor type
+        <https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values>`__ can be used.
+    description : str, dict, :class:`ExprRef`
+        A text description of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the `"aria-label" attribute
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>`__.
+    dir : dict, :class:`ExprRef`, Literal['ltr', 'rtl'], :class:`TextDirection`
+        The direction of the text. One of ``"ltr"`` (left-to-right) or ``"rtl"``
+        (right-to-left). This property determines on which side is truncated in response to
+        the limit parameter.
+
+        **Default value:** ``"ltr"``
+    discreteBandSize : dict, float, :class:`RelativeBandSize`
+        The default size of the bars with discrete dimensions. If unspecified, the default
+        size is  ``step-2``, which provides 2 pixel offset between bars.
+    dx : dict, float, :class:`ExprRef`
+        The horizontal offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    dy : dict, float, :class:`ExprRef`
+        The vertical offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    ellipsis : str, dict, :class:`ExprRef`
+        The ellipsis string for text truncated in response to the limit parameter.
+
+        **Default value:** ``"…"``
+    endAngle : dict, float, :class:`ExprRef`
+        The end angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    fill : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default fill color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove fill.
+
+        **Default value:** (None)
+    fillOpacity : dict, float, :class:`ExprRef`
+        The fill opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    filled : bool
+        Whether the mark's color should be used as fill color instead of stroke color.
+
+        **Default value:** ``false`` for all ``point``, ``line``, and ``rule`` marks as well
+        as ``geoshape`` marks for `graticule
+        <https://vega.github.io/vega-lite/docs/data.html#graticule>`__ data sources;
+        otherwise, ``true``.
+
+        **Note:** This property cannot be used in a `style config
+        <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+    font : str, dict, :class:`ExprRef`
+        The typeface to set the text in (e.g., ``"Helvetica Neue"`` ).
+    fontSize : dict, float, :class:`ExprRef`
+        The font size, in pixels.
+
+        **Default value:** ``11``
+    fontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style (e.g., ``"italic"`` ).
+    fontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight. This can be either a string (e.g ``"bold"``, ``"normal"`` ) or a
+        number ( ``100``, ``200``, ``300``, ..., ``900`` where ``"normal"`` = ``400`` and
+        ``"bold"`` = ``700`` ).
+    height : dict, float, :class:`ExprRef`
+        Height of the marks.
+    href : str, dict, :class:`URI`, :class:`ExprRef`
+        A URL to load upon mouse click. If defined, the mark acts as a hyperlink.
+    innerRadius : dict, float, :class:`ExprRef`
+        The inner radius in pixels of arc marks. ``innerRadius`` is an alias for
+        ``radius2``.
+
+        **Default value:** ``0``
+    interpolate : dict, :class:`ExprRef`, :class:`Interpolate`, Literal['basis', 'basis-open', 'basis-closed', 'bundle', 'cardinal', 'cardinal-open', 'cardinal-closed', 'catmull-rom', 'linear', 'linear-closed', 'monotone', 'natural', 'step', 'step-before', 'step-after']
+        The line interpolation method to use for line and area marks. One of the following:
+
+
+        * ``"linear"`` : piecewise linear segments, as in a polyline.
+        * ``"linear-closed"`` : close the linear segments to form a polygon.
+        * ``"step"`` : alternate between horizontal and vertical segments, as in a step
+          function.
+        * ``"step-before"`` : alternate between vertical and horizontal segments, as in a
+          step function.
+        * ``"step-after"`` : alternate between horizontal and vertical segments, as in a
+          step function.
+        * ``"basis"`` : a B-spline, with control point duplication on the ends.
+        * ``"basis-open"`` : an open B-spline; may not intersect the start or end.
+        * ``"basis-closed"`` : a closed B-spline, as in a loop.
+        * ``"cardinal"`` : a Cardinal spline, with control point duplication on the ends.
+        * ``"cardinal-open"`` : an open Cardinal spline; may not intersect the start or end,
+          but will intersect other control points.
+        * ``"cardinal-closed"`` : a closed Cardinal spline, as in a loop.
+        * ``"bundle"`` : equivalent to basis, except the tension parameter is used to
+          straighten the spline.
+        * ``"monotone"`` : cubic interpolation that preserves monotonicity in y.
+    invalid : Literal['filter', None]
+        Defines how Vega-Lite should handle marks for invalid values ( ``null`` and ``NaN``
+        ).
+
+
+        * If set to ``"filter"`` (default), all data items with null values will be skipped
+          (for line, trail, and area marks) or filtered (for other marks).
+        * If ``null``, all data items are included. In this case, invalid values will be
+          interpreted as zeroes.
+    limit : dict, float, :class:`ExprRef`
+        The maximum length of the text mark in pixels. The text value will be automatically
+        truncated if the rendered size exceeds the limit.
+
+        **Default value:** ``0`` -- indicating no limit
+    lineBreak : str, dict, :class:`ExprRef`
+        A delimiter, such as a newline character, upon which to break text strings into
+        multiple lines. This property is ignored if the text is array-valued.
+    lineHeight : dict, float, :class:`ExprRef`
+        The line height in pixels (the spacing between subsequent lines of text) for
+        multi-line text marks.
+    minBandSize : dict, float, :class:`ExprRef`
+        The minimum band size for bar and rectangle marks. **Default value:** ``0.25``
+    opacity : dict, float, :class:`ExprRef`
+        The overall opacity (value between [0,1]).
+
+        **Default value:** ``0.7`` for non-aggregate plots with ``point``, ``tick``,
+        ``circle``, or ``square`` marks or layered ``bar`` charts and ``1`` otherwise.
+    order : bool, None
+        For line and trail marks, this ``order`` property can be set to ``null`` or
+        ``false`` to make the lines use the original order in the data sources.
+    orient : :class:`Orientation`, Literal['horizontal', 'vertical']
+        The orientation of a non-stacked bar, tick, area, and line charts. The value is
+        either horizontal (default) or vertical.
+
+
+        * For bar, rule and tick, this determines whether the size of the bar and tick
+          should be applied to x or y dimension.
+        * For area, this property determines the orient property of the Vega output.
+        * For line and trail marks, this property determines the sort order of the points in
+          the line if ``config.sortLineBy`` is not specified. For stacked charts, this is
+          always determined by the orientation of the stack; therefore explicitly specified
+          value will be ignored.
+    outerRadius : dict, float, :class:`ExprRef`
+        The outer radius in pixels of arc marks. ``outerRadius`` is an alias for ``radius``.
+
+        **Default value:** ``0``
+    padAngle : dict, float, :class:`ExprRef`
+        The angular padding applied to sides of the arc, in radians.
+    radius : dict, float, :class:`ExprRef`
+        For arc mark, the primary (outer) radius in pixels.
+
+        For text marks, polar coordinate radial offset, in pixels, of the text from the
+        origin determined by the ``x`` and ``y`` properties.
+
+        **Default value:** ``min(plot_width, plot_height)/2``
+    radius2 : dict, float, :class:`ExprRef`
+        The secondary (inner) radius in pixels of arc marks.
+
+        **Default value:** ``0``
+    shape : str, dict, :class:`ExprRef`, :class:`SymbolShape`
+        Shape of the point marks. Supported values include:
+
+
+        * plotting shapes: ``"circle"``, ``"square"``, ``"cross"``, ``"diamond"``,
+          ``"triangle-up"``, ``"triangle-down"``, ``"triangle-right"``, or
+          ``"triangle-left"``.
+        * the line symbol ``"stroke"``
+        * centered directional shapes ``"arrow"``, ``"wedge"``, or ``"triangle"``
+        * a custom `SVG path string
+          <https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths>`__ (For correct
+          sizing, custom shape paths should be defined within a square bounding box with
+          coordinates ranging from -1 to 1 along both the x and y dimensions.)
+
+        **Default value:** ``"circle"``
+    size : dict, float, :class:`ExprRef`
+        Default size for marks.
+
+
+        * For ``point`` / ``circle`` / ``square``, this represents the pixel area of the
+          marks. Note that this value sets the area of the symbol; the side lengths will
+          increase with the square root of this value.
+        * For ``bar``, this represents the band size of the bar, in pixels.
+        * For ``text``, this represents the font size, in pixels.
+
+        **Default value:**
+
+
+        * ``30`` for point, circle, square marks; width/height's ``step``
+        * ``2`` for bar marks with discrete dimensions;
+        * ``5`` for bar marks with continuous dimensions;
+        * ``11`` for text marks.
+    smooth : bool, dict, :class:`ExprRef`
+        A boolean flag (default true) indicating if the image should be smoothed when
+        resized. If false, individual pixels should be scaled directly rather than
+        interpolated with smoothing. For SVG rendering, this option may not work in some
+        browsers due to lack of standardization.
+    startAngle : dict, float, :class:`ExprRef`
+        The start angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    stroke : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default stroke color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove stroke.
+
+        **Default value:** (None)
+    strokeCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for line ending style. One of ``"butt"``, ``"round"``, or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    strokeDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating stroke, space lengths for creating dashed or dotted lines.
+    strokeDashOffset : dict, float, :class:`ExprRef`
+        The offset (in pixels) into which to begin drawing with the stroke dash array.
+    strokeJoin : dict, :class:`ExprRef`, :class:`StrokeJoin`, Literal['miter', 'round', 'bevel']
+        The stroke line join method. One of ``"miter"``, ``"round"`` or ``"bevel"``.
+
+        **Default value:** ``"miter"``
+    strokeMiterLimit : dict, float, :class:`ExprRef`
+        The miter limit at which to bevel a line join.
+    strokeOffset : dict, float, :class:`ExprRef`
+        The offset in pixels at which to draw the group stroke and fill. If unspecified, the
+        default behavior is to dynamically offset stroked groups such that 1 pixel stroke
+        widths align with the pixel grid.
+    strokeOpacity : dict, float, :class:`ExprRef`
+        The stroke opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    strokeWidth : dict, float, :class:`ExprRef`
+        The stroke width, in pixels.
+    tension : dict, float, :class:`ExprRef`
+        Depending on the interpolation type, sets the tension parameter (for line and area
+        marks).
+    text : str, dict, :class:`Text`, Sequence[str], :class:`ExprRef`
+        Placeholder text if the ``text`` channel is not specified
+    theta : dict, float, :class:`ExprRef`
+        For arc marks, the arc length in radians if theta2 is not specified, otherwise the
+        start arc angle. (A value of 0 indicates up or “north”, increasing values proceed
+        clockwise.)
+
+        For text marks, polar coordinate angle in radians.
+    theta2 : dict, float, :class:`ExprRef`
+        The end angle of arc marks in radians. A value of 0 indicates up or “north”,
+        increasing values proceed clockwise.
+    timeUnitBandPosition : float
+        Default relative band position for a time unit. If set to ``0``, the marks will be
+        positioned at the beginning of the time unit band step. If set to ``0.5``, the marks
+        will be positioned in the middle of the time unit band step.
+    timeUnitBandSize : float
+        Default relative band size for a time unit. If set to ``1``, the bandwidth of the
+        marks will be equal to the time unit band step. If set to ``0.5``, bandwidth of the
+        marks will be half of the time unit band step.
+    tooltip : str, bool, dict, None, float, :class:`ExprRef`, :class:`TooltipContent`
+        The tooltip text string to show upon mouse hover or an object defining which fields
+        should the tooltip be derived from.
+
+
+        * If ``tooltip`` is ``true`` or ``{"content": "encoding"}``, then all fields from
+          ``encoding`` will be used.
+        * If ``tooltip`` is ``{"content": "data"}``, then all fields that appear in the
+          highlighted data point will be used.
+        * If set to ``null`` or ``false``, then no tooltip will be used.
+
+        See the `tooltip <https://vega.github.io/vega-lite/docs/tooltip.html>`__
+        documentation for a detailed discussion about tooltip  in Vega-Lite.
+
+        **Default value:** ``null``
+    url : str, dict, :class:`URI`, :class:`ExprRef`
+        The URL of the image file for image marks.
+    width : dict, float, :class:`ExprRef`
+        Width of the marks.
+    x : str, dict, float, :class:`ExprRef`
+        X coordinates of the marks, or width of horizontal ``"bar"`` and ``"area"`` without
+        specified ``x2`` or ``width``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    x2 : str, dict, float, :class:`ExprRef`
+        X2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    y : str, dict, float, :class:`ExprRef`
+        Y coordinates of the marks, or height of vertical ``"bar"`` and ``"area"`` without
+        specified ``y2`` or ``height``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    y2 : str, dict, float, :class:`ExprRef`
+        Y2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    """
+
+    _schema = {"$ref": "#/definitions/BarConfig"}
+
+    def __init__(
+        self,
+        align: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ariaRole: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, "_Parameter", "SchemaBase", Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[dict, float, "SchemaBase", UndefinedType] = Undefined,
+        dx: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        dy: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ellipsis: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        endAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        fontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        href: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        innerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineBreak: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            "SchemaBase", Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        shape: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        size: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        smooth: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        startAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tension: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, "_Parameter", "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        url: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        width: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(BarConfig, self).__init__(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            endAngle=endAngle,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            radius=radius,
+            radius2=radius2,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            startAngle=startAngle,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            y=y,
+            y2=y2,
+            **kwds,
+        )
+
+
+class BaseTitleNoValueRefs(VegaLiteSchema):
+    """BaseTitleNoValueRefs schema wrapper
+
+    Parameters
+    ----------
+
+    align : :class:`Align`, Literal['left', 'center', 'right']
+        Horizontal text alignment for title text. One of ``"left"``, ``"center"``, or
+        ``"right"``.
+    anchor : dict, :class:`ExprRef`, :class:`TitleAnchor`, Literal[None, 'start', 'middle', 'end']
+        The anchor position for placing the title and subtitle text. One of ``"start"``,
+        ``"middle"``, or ``"end"``. For example, with an orientation of top these anchor
+        positions map to a left-, center-, or right-aligned title.
+    angle : dict, float, :class:`ExprRef`
+        Angle in degrees of title and subtitle text.
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG group, removing the title from the ARIA accessibility tree.
+
+        **Default value:** ``true``
+    baseline : str, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        Vertical text baseline for title and subtitle text. One of ``"alphabetic"``
+        (default), ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, or
+        ``"line-bottom"``. The ``"line-top"`` and ``"line-bottom"`` values operate similarly
+        to ``"top"`` and ``"bottom"``, but are calculated relative to the *lineHeight*
+        rather than *fontSize* alone.
+    color : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Text color for title text.
+    dx : dict, float, :class:`ExprRef`
+        Delta offset for title and subtitle text x-coordinate.
+    dy : dict, float, :class:`ExprRef`
+        Delta offset for title and subtitle text y-coordinate.
+    font : str, dict, :class:`ExprRef`
+        Font name for title text.
+    fontSize : dict, float, :class:`ExprRef`
+        Font size in pixels for title text.
+    fontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        Font style for title text.
+    fontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        Font weight for title text. This can be either a string (e.g ``"bold"``,
+        ``"normal"`` ) or a number ( ``100``, ``200``, ``300``, ..., ``900`` where
+        ``"normal"`` = ``400`` and ``"bold"`` = ``700`` ).
+    frame : str, dict, :class:`ExprRef`, :class:`TitleFrame`, Literal['bounds', 'group']
+        The reference frame for the anchor position, one of ``"bounds"`` (to anchor relative
+        to the full bounding box) or ``"group"`` (to anchor relative to the group width or
+        height).
+    limit : dict, float, :class:`ExprRef`
+        The maximum allowed length in pixels of title and subtitle text.
+    lineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line title text or title text with ``"line-top"`` or
+        ``"line-bottom"`` baseline.
+    offset : dict, float, :class:`ExprRef`
+        The orthogonal offset in pixels by which to displace the title group from its
+        position along the edge of the chart.
+    orient : dict, :class:`ExprRef`, :class:`TitleOrient`, Literal['none', 'left', 'right', 'top', 'bottom']
+        Default title orientation ( ``"top"``, ``"bottom"``, ``"left"``, or ``"right"`` )
+    subtitleColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Text color for subtitle text.
+    subtitleFont : str, dict, :class:`ExprRef`
+        Font name for subtitle text.
+    subtitleFontSize : dict, float, :class:`ExprRef`
+        Font size in pixels for subtitle text.
+    subtitleFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        Font style for subtitle text.
+    subtitleFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        Font weight for subtitle text. This can be either a string (e.g ``"bold"``,
+        ``"normal"`` ) or a number ( ``100``, ``200``, ``300``, ..., ``900`` where
+        ``"normal"`` = ``400`` and ``"bold"`` = ``700`` ).
+    subtitleLineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line subtitle text.
+    subtitlePadding : dict, float, :class:`ExprRef`
+        The padding in pixels between title and subtitle text.
+    zindex : dict, float, :class:`ExprRef`
+        The integer z-index indicating the layering of the title group relative to other
+        axis, mark, and legend groups.
+
+        **Default value:** ``0``.
+    """
+
+    _schema = {"$ref": "#/definitions/BaseTitleNoValueRefs"}
+
+    def __init__(
+        self,
+        align: Union[
+            "SchemaBase", Literal["left", "center", "right"], UndefinedType
+        ] = Undefined,
+        anchor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        baseline: Union[
+            str, "SchemaBase", Literal["top", "middle", "bottom"], UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        dx: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        dy: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        font: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        fontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        frame: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["bounds", "group"],
+            UndefinedType,
+        ] = Undefined,
+        limit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        orient: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["none", "left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        subtitleColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        subtitleFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        subtitleFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        subtitleFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        subtitleFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        subtitleLineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        subtitlePadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        zindex: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(BaseTitleNoValueRefs, self).__init__(
+            align=align,
+            anchor=anchor,
+            angle=angle,
+            aria=aria,
+            baseline=baseline,
+            color=color,
+            dx=dx,
+            dy=dy,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            frame=frame,
+            limit=limit,
+            lineHeight=lineHeight,
+            offset=offset,
+            orient=orient,
+            subtitleColor=subtitleColor,
+            subtitleFont=subtitleFont,
+            subtitleFontSize=subtitleFontSize,
+            subtitleFontStyle=subtitleFontStyle,
+            subtitleFontWeight=subtitleFontWeight,
+            subtitleLineHeight=subtitleLineHeight,
+            subtitlePadding=subtitlePadding,
+            zindex=zindex,
+            **kwds,
+        )
+
+
+class BinExtent(VegaLiteSchema):
+    """BinExtent schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/BinExtent"}
+
+    def __init__(self, *args, **kwds):
+        super(BinExtent, self).__init__(*args, **kwds)
+
+
+class BinParams(VegaLiteSchema):
+    """BinParams schema wrapper
+    Binning properties or boolean flag for determining whether to bin data or not.
+
+    Parameters
+    ----------
+
+    anchor : float
+        A value in the binned domain at which to anchor the bins, shifting the bin
+        boundaries if necessary to ensure that a boundary aligns with the anchor value.
+
+        **Default value:** the minimum bin extent value
+    base : float
+        The number base to use for automatic bin determination (default is base 10).
+
+        **Default value:** ``10``
+    binned : bool
+        When set to ``true``, Vega-Lite treats the input data as already binned.
+    divide : Sequence[float]
+        Scale factors indicating allowable subdivisions. The default value is [5, 2], which
+        indicates that for base 10 numbers (the default base), the method may consider
+        dividing bin sizes by 5 and/or 2. For example, for an initial step size of 10, the
+        method can check if bin sizes of 2 (= 10/5), 5 (= 10/2), or 1 (= 10/(5*2)) might
+        also satisfy the given constraints.
+
+        **Default value:** ``[5, 2]``
+    extent : dict, Sequence[float], :class:`BinExtent`, :class:`ParameterExtent`
+        A two-element ( ``[min, max]`` ) array indicating the range of desired bin values.
+    maxbins : float
+        Maximum number of bins.
+
+        **Default value:** ``6`` for ``row``, ``column`` and ``shape`` channels; ``10`` for
+        other channels
+    minstep : float
+        A minimum allowable step size (particularly useful for integer values).
+    nice : bool
+        If true, attempts to make the bin boundaries use human-friendly boundaries, such as
+        multiples of ten.
+
+        **Default value:** ``true``
+    step : float
+        An exact step size to use between bins.
+
+        **Note:** If provided, options such as maxbins will be ignored.
+    steps : Sequence[float]
+        An array of allowable step sizes to choose from.
+    """
+
+    _schema = {"$ref": "#/definitions/BinParams"}
+
+    def __init__(
+        self,
+        anchor: Union[float, UndefinedType] = Undefined,
+        base: Union[float, UndefinedType] = Undefined,
+        binned: Union[bool, UndefinedType] = Undefined,
+        divide: Union[Sequence[float], UndefinedType] = Undefined,
+        extent: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        minstep: Union[float, UndefinedType] = Undefined,
+        nice: Union[bool, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        steps: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(BinParams, self).__init__(
+            anchor=anchor,
+            base=base,
+            binned=binned,
+            divide=divide,
+            extent=extent,
+            maxbins=maxbins,
+            minstep=minstep,
+            nice=nice,
+            step=step,
+            steps=steps,
+            **kwds,
+        )
+
+
+class Binding(VegaLiteSchema):
+    """Binding schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Binding"}
+
+    def __init__(self, *args, **kwds):
+        super(Binding, self).__init__(*args, **kwds)
+
+
+class BindCheckbox(Binding):
+    """BindCheckbox schema wrapper
+
+    Parameters
+    ----------
+
+    input : str
+
+    debounce : float
+        If defined, delays event handling until the specified milliseconds have elapsed
+        since the last event was fired.
+    element : str, :class:`Element`
+        An optional CSS selector string indicating the parent element to which the input
+        element should be added. By default, all input elements are added within the parent
+        container of the Vega view.
+    name : str
+        By default, the signal name is used to label input elements. This ``name`` property
+        can be used instead to specify a custom label for the bound signal.
+    """
+
+    _schema = {"$ref": "#/definitions/BindCheckbox"}
+
+    def __init__(
+        self,
+        input: Union[str, UndefinedType] = Undefined,
+        debounce: Union[float, UndefinedType] = Undefined,
+        element: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(BindCheckbox, self).__init__(
+            input=input, debounce=debounce, element=element, name=name, **kwds
+        )
+
+
+class BindDirect(Binding):
+    """BindDirect schema wrapper
+
+    Parameters
+    ----------
+
+    element : str, dict, :class:`Element`
+        An input element that exposes a *value* property and supports the `EventTarget
+        <https://developer.mozilla.org/en-US/docs/Web/API/EventTarget>`__ interface, or a
+        CSS selector string to such an element. When the element updates and dispatches an
+        event, the *value* property will be used as the new, bound signal value. When the
+        signal updates independent of the element, the *value* property will be set to the
+        signal value and a new event will be dispatched on the element.
+    debounce : float
+        If defined, delays event handling until the specified milliseconds have elapsed
+        since the last event was fired.
+    event : str
+        The event (default ``"input"`` ) to listen for to track changes on the external
+        element.
+    """
+
+    _schema = {"$ref": "#/definitions/BindDirect"}
+
+    def __init__(
+        self,
+        element: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        debounce: Union[float, UndefinedType] = Undefined,
+        event: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(BindDirect, self).__init__(
+            element=element, debounce=debounce, event=event, **kwds
+        )
+
+
+class BindInput(Binding):
+    """BindInput schema wrapper
+
+    Parameters
+    ----------
+
+    autocomplete : str
+        A hint for form autofill. See the `HTML autocomplete attribute
+        <https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete>`__ for
+        additional information.
+    debounce : float
+        If defined, delays event handling until the specified milliseconds have elapsed
+        since the last event was fired.
+    element : str, :class:`Element`
+        An optional CSS selector string indicating the parent element to which the input
+        element should be added. By default, all input elements are added within the parent
+        container of the Vega view.
+    input : str
+        The type of input element to use. The valid values are ``"checkbox"``, ``"radio"``,
+        ``"range"``, ``"select"``, and any other legal `HTML form input type
+        <https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input>`__.
+    name : str
+        By default, the signal name is used to label input elements. This ``name`` property
+        can be used instead to specify a custom label for the bound signal.
+    placeholder : str
+        Text that appears in the form control when it has no value set.
+    """
+
+    _schema = {"$ref": "#/definitions/BindInput"}
+
+    def __init__(
+        self,
+        autocomplete: Union[str, UndefinedType] = Undefined,
+        debounce: Union[float, UndefinedType] = Undefined,
+        element: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        input: Union[str, UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        placeholder: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(BindInput, self).__init__(
+            autocomplete=autocomplete,
+            debounce=debounce,
+            element=element,
+            input=input,
+            name=name,
+            placeholder=placeholder,
+            **kwds,
+        )
+
+
+class BindRadioSelect(Binding):
+    """BindRadioSelect schema wrapper
+
+    Parameters
+    ----------
+
+    input : Literal['radio', 'select']
+
+    options : Sequence[Any]
+        An array of options to select from.
+    debounce : float
+        If defined, delays event handling until the specified milliseconds have elapsed
+        since the last event was fired.
+    element : str, :class:`Element`
+        An optional CSS selector string indicating the parent element to which the input
+        element should be added. By default, all input elements are added within the parent
+        container of the Vega view.
+    labels : Sequence[str]
+        An array of label strings to represent the ``options`` values. If unspecified, the
+        ``options`` value will be coerced to a string and used as the label.
+    name : str
+        By default, the signal name is used to label input elements. This ``name`` property
+        can be used instead to specify a custom label for the bound signal.
+    """
+
+    _schema = {"$ref": "#/definitions/BindRadioSelect"}
+
+    def __init__(
+        self,
+        input: Union[Literal["radio", "select"], UndefinedType] = Undefined,
+        options: Union[Sequence[Any], UndefinedType] = Undefined,
+        debounce: Union[float, UndefinedType] = Undefined,
+        element: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        labels: Union[Sequence[str], UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(BindRadioSelect, self).__init__(
+            input=input,
+            options=options,
+            debounce=debounce,
+            element=element,
+            labels=labels,
+            name=name,
+            **kwds,
+        )
+
+
+class BindRange(Binding):
+    """BindRange schema wrapper
+
+    Parameters
+    ----------
+
+    input : str
+
+    debounce : float
+        If defined, delays event handling until the specified milliseconds have elapsed
+        since the last event was fired.
+    element : str, :class:`Element`
+        An optional CSS selector string indicating the parent element to which the input
+        element should be added. By default, all input elements are added within the parent
+        container of the Vega view.
+    max : float
+        Sets the maximum slider value. Defaults to the larger of the signal value and
+        ``100``.
+    min : float
+        Sets the minimum slider value. Defaults to the smaller of the signal value and
+        ``0``.
+    name : str
+        By default, the signal name is used to label input elements. This ``name`` property
+        can be used instead to specify a custom label for the bound signal.
+    step : float
+        Sets the minimum slider increment. If undefined, the step size will be automatically
+        determined based on the ``min`` and ``max`` values.
+    """
+
+    _schema = {"$ref": "#/definitions/BindRange"}
+
+    def __init__(
+        self,
+        input: Union[str, UndefinedType] = Undefined,
+        debounce: Union[float, UndefinedType] = Undefined,
+        element: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        max: Union[float, UndefinedType] = Undefined,
+        min: Union[float, UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(BindRange, self).__init__(
+            input=input,
+            debounce=debounce,
+            element=element,
+            max=max,
+            min=min,
+            name=name,
+            step=step,
+            **kwds,
+        )
+
+
+class BinnedTimeUnit(VegaLiteSchema):
+    """BinnedTimeUnit schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/BinnedTimeUnit"}
+
+    def __init__(self, *args, **kwds):
+        super(BinnedTimeUnit, self).__init__(*args, **kwds)
+
+
+class Blend(VegaLiteSchema):
+    """Blend schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Blend"}
+
+    def __init__(self, *args):
+        super(Blend, self).__init__(*args)
+
+
+class BoxPlotConfig(VegaLiteSchema):
+    """BoxPlotConfig schema wrapper
+
+    Parameters
+    ----------
+
+    box : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    extent : str, float
+        The extent of the whiskers. Available options include:
+
+
+        * ``"min-max"`` : min and max are the lower and upper whiskers respectively.
+        * A number representing multiple of the interquartile range. This number will be
+          multiplied by the IQR to determine whisker boundary, which spans from the smallest
+          data to the largest data within the range *[Q1 - k * IQR, Q3 + k * IQR]* where
+          *Q1* and *Q3* are the first and third quartiles while *IQR* is the interquartile
+          range ( *Q3-Q1* ).
+
+        **Default value:** ``1.5``.
+    median : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    outliers : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    rule : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    size : float
+        Size of the box and median tick of a box plot
+    ticks : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    """
+
+    _schema = {"$ref": "#/definitions/BoxPlotConfig"}
+
+    def __init__(
+        self,
+        box: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        extent: Union[str, float, UndefinedType] = Undefined,
+        median: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        outliers: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        rule: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        size: Union[float, UndefinedType] = Undefined,
+        ticks: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(BoxPlotConfig, self).__init__(
+            box=box,
+            extent=extent,
+            median=median,
+            outliers=outliers,
+            rule=rule,
+            size=size,
+            ticks=ticks,
+            **kwds,
+        )
+
+
+class BrushConfig(VegaLiteSchema):
+    """BrushConfig schema wrapper
+
+    Parameters
+    ----------
+
+    cursor : :class:`Cursor`, Literal['auto', 'default', 'none', 'context-menu', 'help', 'pointer', 'progress', 'wait', 'cell', 'crosshair', 'text', 'vertical-text', 'alias', 'copy', 'move', 'no-drop', 'not-allowed', 'e-resize', 'n-resize', 'ne-resize', 'nw-resize', 's-resize', 'se-resize', 'sw-resize', 'w-resize', 'ew-resize', 'ns-resize', 'nesw-resize', 'nwse-resize', 'col-resize', 'row-resize', 'all-scroll', 'zoom-in', 'zoom-out', 'grab', 'grabbing']
+        The mouse cursor used over the interval mark. Any valid `CSS cursor type
+        <https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values>`__ can be used.
+    fill : str, :class:`Color`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The fill color of the interval mark.
+
+        **Default value:** ``"#333333"``
+    fillOpacity : float
+        The fill opacity of the interval mark (a value between ``0`` and ``1`` ).
+
+        **Default value:** ``0.125``
+    stroke : str, :class:`Color`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The stroke color of the interval mark.
+
+        **Default value:** ``"#ffffff"``
+    strokeDash : Sequence[float]
+        An array of alternating stroke and space lengths, for creating dashed or dotted
+        lines.
+    strokeDashOffset : float
+        The offset (in pixels) with which to begin drawing the stroke dash array.
+    strokeOpacity : float
+        The stroke opacity of the interval mark (a value between ``0`` and ``1`` ).
+    strokeWidth : float
+        The stroke width of the interval mark.
+    """
+
+    _schema = {"$ref": "#/definitions/BrushConfig"}
+
+    def __init__(
+        self,
+        cursor: Union[
+            "SchemaBase",
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fill: Union[
+            str,
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[float, UndefinedType] = Undefined,
+        stroke: Union[
+            str,
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[Sequence[float], UndefinedType] = Undefined,
+        strokeDashOffset: Union[float, UndefinedType] = Undefined,
+        strokeOpacity: Union[float, UndefinedType] = Undefined,
+        strokeWidth: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(BrushConfig, self).__init__(
+            cursor=cursor,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            stroke=stroke,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            **kwds,
+        )
+
+
+class Color(VegaLiteSchema):
+    """Color schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Color"}
+
+    def __init__(self, *args, **kwds):
+        super(Color, self).__init__(*args, **kwds)
+
+
+class ColorDef(VegaLiteSchema):
+    """ColorDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ColorDef"}
+
+    def __init__(self, *args, **kwds):
+        super(ColorDef, self).__init__(*args, **kwds)
+
+
+class ColorName(Color):
+    """ColorName schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ColorName"}
+
+    def __init__(self, *args):
+        super(ColorName, self).__init__(*args)
+
+
+class ColorScheme(VegaLiteSchema):
+    """ColorScheme schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ColorScheme"}
+
+    def __init__(self, *args, **kwds):
+        super(ColorScheme, self).__init__(*args, **kwds)
+
+
+class Categorical(ColorScheme):
+    """Categorical schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Categorical"}
+
+    def __init__(self, *args):
+        super(Categorical, self).__init__(*args)
+
+
+class CompositeMark(AnyMark):
+    """CompositeMark schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/CompositeMark"}
+
+    def __init__(self, *args, **kwds):
+        super(CompositeMark, self).__init__(*args, **kwds)
+
+
+class BoxPlot(CompositeMark):
+    """BoxPlot schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/BoxPlot"}
+
+    def __init__(self, *args):
+        super(BoxPlot, self).__init__(*args)
+
+
+class CompositeMarkDef(AnyMark):
+    """CompositeMarkDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/CompositeMarkDef"}
+
+    def __init__(self, *args, **kwds):
+        super(CompositeMarkDef, self).__init__(*args, **kwds)
+
+
+class BoxPlotDef(CompositeMarkDef):
+    """BoxPlotDef schema wrapper
+
+    Parameters
+    ----------
+
+    type : str, :class:`BoxPlot`
+        The mark type. This could a primitive mark type (one of ``"bar"``, ``"circle"``,
+        ``"square"``, ``"tick"``, ``"line"``, ``"area"``, ``"point"``, ``"geoshape"``,
+        ``"rule"``, and ``"text"`` ) or a composite mark type ( ``"boxplot"``,
+        ``"errorband"``, ``"errorbar"`` ).
+    box : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    clip : bool
+        Whether a composite mark be clipped to the enclosing group’s width and height.
+    color : str, dict, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default color.
+
+        **Default value:** :raw-html:`<span style="color: #4682b4;">&#9632;</span>`
+        ``"#4682b4"``
+
+        **Note:**
+
+
+        * This property cannot be used in a `style config
+          <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+        * The ``fill`` and ``stroke`` properties have higher precedence than ``color`` and
+          will override ``color``.
+    extent : str, float
+        The extent of the whiskers. Available options include:
+
+
+        * ``"min-max"`` : min and max are the lower and upper whiskers respectively.
+        * A number representing multiple of the interquartile range. This number will be
+          multiplied by the IQR to determine whisker boundary, which spans from the smallest
+          data to the largest data within the range *[Q1 - k * IQR, Q3 + k * IQR]* where
+          *Q1* and *Q3* are the first and third quartiles while *IQR* is the interquartile
+          range ( *Q3-Q1* ).
+
+        **Default value:** ``1.5``.
+    invalid : Literal['filter', None]
+        Defines how Vega-Lite should handle marks for invalid values ( ``null`` and ``NaN``
+        ).
+
+
+        * If set to ``"filter"`` (default), all data items with null values will be skipped
+          (for line, trail, and area marks) or filtered (for other marks).
+        * If ``null``, all data items are included. In this case, invalid values will be
+          interpreted as zeroes.
+    median : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    opacity : float
+        The opacity (value between [0,1]) of the mark.
+    orient : :class:`Orientation`, Literal['horizontal', 'vertical']
+        Orientation of the box plot. This is normally automatically determined based on
+        types of fields on x and y channels. However, an explicit ``orient`` be specified
+        when the orientation is ambiguous.
+
+        **Default value:** ``"vertical"``.
+    outliers : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    rule : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    size : float
+        Size of the box and median tick of a box plot
+    ticks : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    """
+
+    _schema = {"$ref": "#/definitions/BoxPlotDef"}
+
+    def __init__(
+        self,
+        type: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        box: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        clip: Union[bool, UndefinedType] = Undefined,
+        color: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        extent: Union[str, float, UndefinedType] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        median: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        opacity: Union[float, UndefinedType] = Undefined,
+        orient: Union[
+            "SchemaBase", Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outliers: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        rule: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        size: Union[float, UndefinedType] = Undefined,
+        ticks: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(BoxPlotDef, self).__init__(
+            type=type,
+            box=box,
+            clip=clip,
+            color=color,
+            extent=extent,
+            invalid=invalid,
+            median=median,
+            opacity=opacity,
+            orient=orient,
+            outliers=outliers,
+            rule=rule,
+            size=size,
+            ticks=ticks,
+            **kwds,
+        )
+
+
+class CompositionConfig(VegaLiteSchema):
+    """CompositionConfig schema wrapper
+
+    Parameters
+    ----------
+
+    columns : float
+        The number of columns to include in the view composition layout.
+
+        **Default value** : ``undefined`` -- An infinite number of columns (a single row)
+        will be assumed. This is equivalent to ``hconcat`` (for ``concat`` ) and to using
+        the ``column`` channel (for ``facet`` and ``repeat`` ).
+
+        **Note** :
+
+        1) This property is only for:
+
+
+        * the general (wrappable) ``concat`` operator (not ``hconcat`` / ``vconcat`` )
+        * the ``facet`` and ``repeat`` operator with one field/repetition definition
+          (without row/column nesting)
+
+        2) Setting the ``columns`` to ``1`` is equivalent to ``vconcat`` (for ``concat`` )
+        and to using the ``row`` channel (for ``facet`` and ``repeat`` ).
+    spacing : float
+        The default spacing in pixels between composed sub-views.
+
+        **Default value** : ``20``
+    """
+
+    _schema = {"$ref": "#/definitions/CompositionConfig"}
+
+    def __init__(
+        self,
+        columns: Union[float, UndefinedType] = Undefined,
+        spacing: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(CompositionConfig, self).__init__(
+            columns=columns, spacing=spacing, **kwds
+        )
+
+
+class ConditionalAxisColor(VegaLiteSchema):
+    """ConditionalAxisColor schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisColor"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisColor, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisLabelAlign(VegaLiteSchema):
+    """ConditionalAxisLabelAlign schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisLabelAlign"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisLabelAlign, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisLabelBaseline(VegaLiteSchema):
+    """ConditionalAxisLabelBaseline schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisLabelBaseline"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisLabelBaseline, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisLabelFontStyle(VegaLiteSchema):
+    """ConditionalAxisLabelFontStyle schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisLabelFontStyle"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisLabelFontStyle, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisLabelFontWeight(VegaLiteSchema):
+    """ConditionalAxisLabelFontWeight schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisLabelFontWeight"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisLabelFontWeight, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisNumber(VegaLiteSchema):
+    """ConditionalAxisNumber schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisNumber"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisNumber, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisNumberArray(VegaLiteSchema):
+    """ConditionalAxisNumberArray schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisNumberArray"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisNumberArray, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisPropertyAlignnull(VegaLiteSchema):
+    """ConditionalAxisPropertyAlignnull schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisProperty<(Align|null)>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisPropertyAlignnull, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisPropertyColornull(VegaLiteSchema):
+    """ConditionalAxisPropertyColornull schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisProperty<(Color|null)>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisPropertyColornull, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisPropertyFontStylenull(VegaLiteSchema):
+    """ConditionalAxisPropertyFontStylenull schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisProperty<(FontStyle|null)>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisPropertyFontStylenull, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisPropertyFontWeightnull(VegaLiteSchema):
+    """ConditionalAxisPropertyFontWeightnull schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisProperty<(FontWeight|null)>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisPropertyFontWeightnull, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisPropertyTextBaselinenull(VegaLiteSchema):
+    """ConditionalAxisPropertyTextBaselinenull schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisProperty<(TextBaseline|null)>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisPropertyTextBaselinenull, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisPropertynumberArraynull(VegaLiteSchema):
+    """ConditionalAxisPropertynumberArraynull schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisProperty<(number[]|null)>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisPropertynumberArraynull, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisPropertynumbernull(VegaLiteSchema):
+    """ConditionalAxisPropertynumbernull schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisProperty<(number|null)>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisPropertynumbernull, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisPropertystringnull(VegaLiteSchema):
+    """ConditionalAxisPropertystringnull schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisProperty<(string|null)>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisPropertystringnull, self).__init__(*args, **kwds)
+
+
+class ConditionalAxisString(VegaLiteSchema):
+    """ConditionalAxisString schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalAxisString"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalAxisString, self).__init__(*args, **kwds)
+
+
+class ConditionalMarkPropFieldOrDatumDef(VegaLiteSchema):
+    """ConditionalMarkPropFieldOrDatumDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalMarkPropFieldOrDatumDef, self).__init__(*args, **kwds)
+
+
+class ConditionalMarkPropFieldOrDatumDefTypeForShape(VegaLiteSchema):
+    """ConditionalMarkPropFieldOrDatumDefTypeForShape schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef<TypeForShape>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalMarkPropFieldOrDatumDefTypeForShape, self).__init__(
+            *args, **kwds
+        )
+
+
+class ConditionalParameterMarkPropFieldOrDatumDef(ConditionalMarkPropFieldOrDatumDef):
+    """ConditionalParameterMarkPropFieldOrDatumDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalParameter<MarkPropFieldOrDatumDef>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalParameterMarkPropFieldOrDatumDef, self).__init__(*args, **kwds)
+
+
+class ConditionalParameterMarkPropFieldOrDatumDefTypeForShape(
+    ConditionalMarkPropFieldOrDatumDefTypeForShape
+):
+    """ConditionalParameterMarkPropFieldOrDatumDefTypeForShape schema wrapper"""
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalParameter<MarkPropFieldOrDatumDef<TypeForShape>>"
+    }
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalParameterMarkPropFieldOrDatumDefTypeForShape, self).__init__(
+            *args, **kwds
+        )
+
+
+class ConditionalPredicateMarkPropFieldOrDatumDef(ConditionalMarkPropFieldOrDatumDef):
+    """ConditionalPredicateMarkPropFieldOrDatumDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalPredicate<MarkPropFieldOrDatumDef>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalPredicateMarkPropFieldOrDatumDef, self).__init__(*args, **kwds)
+
+
+class ConditionalPredicateMarkPropFieldOrDatumDefTypeForShape(
+    ConditionalMarkPropFieldOrDatumDefTypeForShape
+):
+    """ConditionalPredicateMarkPropFieldOrDatumDefTypeForShape schema wrapper"""
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalPredicate<MarkPropFieldOrDatumDef<TypeForShape>>"
+    }
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalPredicateMarkPropFieldOrDatumDefTypeForShape, self).__init__(
+            *args, **kwds
+        )
+
+
+class ConditionalPredicateValueDefAlignnullExprRef(VegaLiteSchema):
+    """ConditionalPredicateValueDefAlignnullExprRef schema wrapper"""
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(Align|null)>|ExprRef)>"
+    }
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalPredicateValueDefAlignnullExprRef, self).__init__(
+            *args, **kwds
+        )
+
+
+class ConditionalPredicateValueDefColornullExprRef(VegaLiteSchema):
+    """ConditionalPredicateValueDefColornullExprRef schema wrapper"""
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(Color|null)>|ExprRef)>"
+    }
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalPredicateValueDefColornullExprRef, self).__init__(
+            *args, **kwds
+        )
+
+
+class ConditionalPredicateValueDefFontStylenullExprRef(VegaLiteSchema):
+    """ConditionalPredicateValueDefFontStylenullExprRef schema wrapper"""
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(FontStyle|null)>|ExprRef)>"
+    }
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalPredicateValueDefFontStylenullExprRef, self).__init__(
+            *args, **kwds
+        )
+
+
+class ConditionalPredicateValueDefFontWeightnullExprRef(VegaLiteSchema):
+    """ConditionalPredicateValueDefFontWeightnullExprRef schema wrapper"""
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(FontWeight|null)>|ExprRef)>"
+    }
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalPredicateValueDefFontWeightnullExprRef, self).__init__(
+            *args, **kwds
+        )
+
+
+class ConditionalPredicateValueDefTextBaselinenullExprRef(VegaLiteSchema):
+    """ConditionalPredicateValueDefTextBaselinenullExprRef schema wrapper"""
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(TextBaseline|null)>|ExprRef)>"
+    }
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalPredicateValueDefTextBaselinenullExprRef, self).__init__(
+            *args, **kwds
+        )
+
+
+class ConditionalPredicateValueDefnumberArraynullExprRef(VegaLiteSchema):
+    """ConditionalPredicateValueDefnumberArraynullExprRef schema wrapper"""
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(number[]|null)>|ExprRef)>"
+    }
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalPredicateValueDefnumberArraynullExprRef, self).__init__(
+            *args, **kwds
+        )
+
+
+class ConditionalPredicateValueDefnumbernullExprRef(VegaLiteSchema):
+    """ConditionalPredicateValueDefnumbernullExprRef schema wrapper"""
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(number|null)>|ExprRef)>"
+    }
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalPredicateValueDefnumbernullExprRef, self).__init__(
+            *args, **kwds
+        )
+
+
+class ConditionalStringFieldDef(VegaLiteSchema):
+    """ConditionalStringFieldDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalStringFieldDef"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalStringFieldDef, self).__init__(*args, **kwds)
+
+
+class ConditionalParameterStringFieldDef(ConditionalStringFieldDef):
+    """ConditionalParameterStringFieldDef schema wrapper
+
+    Parameters
+    ----------
+
+    param : str, :class:`ParameterName`
+        Filter using a parameter name.
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    empty : bool
+        For selection parameters, the predicate of empty selections returns true by default.
+        Override this behavior, by setting this property ``empty: false``.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/ConditionalParameter<StringFieldDef>"}
+
+    def __init__(
+        self,
+        param: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        format: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalParameterStringFieldDef, self).__init__(
+            param=param,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            empty=empty,
+            field=field,
+            format=format,
+            formatType=formatType,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class ConditionalPredicateStringFieldDef(ConditionalStringFieldDef):
+    """ConditionalPredicateStringFieldDef schema wrapper
+
+    Parameters
+    ----------
+
+    test : str, dict, :class:`Predicate`, :class:`FieldGTPredicate`, :class:`FieldLTPredicate`, :class:`FieldGTEPredicate`, :class:`FieldLTEPredicate`, :class:`LogicalOrPredicate`, :class:`ParameterPredicate`, :class:`FieldEqualPredicate`, :class:`FieldOneOfPredicate`, :class:`FieldRangePredicate`, :class:`FieldValidPredicate`, :class:`LogicalAndPredicate`, :class:`LogicalNotPredicate`, :class:`PredicateComposition`
+        Predicate for triggering the condition
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/ConditionalPredicate<StringFieldDef>"}
+
+    def __init__(
+        self,
+        test: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        format: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalPredicateStringFieldDef, self).__init__(
+            test=test,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            format=format,
+            formatType=formatType,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class ConditionalValueDefGradientstringnullExprRef(VegaLiteSchema):
+    """ConditionalValueDefGradientstringnullExprRef schema wrapper"""
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+    }
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalValueDefGradientstringnullExprRef, self).__init__(
+            *args, **kwds
+        )
+
+
+class ConditionalParameterValueDefGradientstringnullExprRef(
+    ConditionalValueDefGradientstringnullExprRef
+):
+    """ConditionalParameterValueDefGradientstringnullExprRef schema wrapper
+
+    Parameters
+    ----------
+
+    param : str, :class:`ParameterName`
+        Filter using a parameter name.
+    value : str, dict, None, :class:`ExprRef`, :class:`Gradient`, :class:`LinearGradient`, :class:`RadialGradient`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    empty : bool
+        For selection parameters, the predicate of empty selections returns true by default.
+        Override this behavior, by setting this property ``empty: false``.
+    """
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalParameter<ValueDef<(Gradient|string|null|ExprRef)>>"
+    }
+
+    def __init__(
+        self,
+        param: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalParameterValueDefGradientstringnullExprRef, self).__init__(
+            param=param, value=value, empty=empty, **kwds
+        )
+
+
+class ConditionalPredicateValueDefGradientstringnullExprRef(
+    ConditionalValueDefGradientstringnullExprRef
+):
+    """ConditionalPredicateValueDefGradientstringnullExprRef schema wrapper
+
+    Parameters
+    ----------
+
+    test : str, dict, :class:`Predicate`, :class:`FieldGTPredicate`, :class:`FieldLTPredicate`, :class:`FieldGTEPredicate`, :class:`FieldLTEPredicate`, :class:`LogicalOrPredicate`, :class:`ParameterPredicate`, :class:`FieldEqualPredicate`, :class:`FieldOneOfPredicate`, :class:`FieldRangePredicate`, :class:`FieldValidPredicate`, :class:`LogicalAndPredicate`, :class:`LogicalNotPredicate`, :class:`PredicateComposition`
+        Predicate for triggering the condition
+    value : str, dict, None, :class:`ExprRef`, :class:`Gradient`, :class:`LinearGradient`, :class:`RadialGradient`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalPredicate<ValueDef<(Gradient|string|null|ExprRef)>>"
+    }
+
+    def __init__(
+        self,
+        test: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalPredicateValueDefGradientstringnullExprRef, self).__init__(
+            test=test, value=value, **kwds
+        )
+
+
+class ConditionalValueDefTextExprRef(VegaLiteSchema):
+    """ConditionalValueDefTextExprRef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalValueDef<(Text|ExprRef)>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalValueDefTextExprRef, self).__init__(*args, **kwds)
+
+
+class ConditionalParameterValueDefTextExprRef(ConditionalValueDefTextExprRef):
+    """ConditionalParameterValueDefTextExprRef schema wrapper
+
+    Parameters
+    ----------
+
+    param : str, :class:`ParameterName`
+        Filter using a parameter name.
+    value : str, dict, :class:`Text`, Sequence[str], :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    empty : bool
+        For selection parameters, the predicate of empty selections returns true by default.
+        Override this behavior, by setting this property ``empty: false``.
+    """
+
+    _schema = {"$ref": "#/definitions/ConditionalParameter<ValueDef<(Text|ExprRef)>>"}
+
+    def __init__(
+        self,
+        param: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[
+            str, dict, "_Parameter", "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalParameterValueDefTextExprRef, self).__init__(
+            param=param, value=value, empty=empty, **kwds
+        )
+
+
+class ConditionalPredicateValueDefTextExprRef(ConditionalValueDefTextExprRef):
+    """ConditionalPredicateValueDefTextExprRef schema wrapper
+
+    Parameters
+    ----------
+
+    test : str, dict, :class:`Predicate`, :class:`FieldGTPredicate`, :class:`FieldLTPredicate`, :class:`FieldGTEPredicate`, :class:`FieldLTEPredicate`, :class:`LogicalOrPredicate`, :class:`ParameterPredicate`, :class:`FieldEqualPredicate`, :class:`FieldOneOfPredicate`, :class:`FieldRangePredicate`, :class:`FieldValidPredicate`, :class:`LogicalAndPredicate`, :class:`LogicalNotPredicate`, :class:`PredicateComposition`
+        Predicate for triggering the condition
+    value : str, dict, :class:`Text`, Sequence[str], :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {"$ref": "#/definitions/ConditionalPredicate<ValueDef<(Text|ExprRef)>>"}
+
+    def __init__(
+        self,
+        test: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[
+            str, dict, "_Parameter", "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalPredicateValueDefTextExprRef, self).__init__(
+            test=test, value=value, **kwds
+        )
+
+
+class ConditionalValueDefnumber(VegaLiteSchema):
+    """ConditionalValueDefnumber schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalValueDef<number>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalValueDefnumber, self).__init__(*args, **kwds)
+
+
+class ConditionalParameterValueDefnumber(ConditionalValueDefnumber):
+    """ConditionalParameterValueDefnumber schema wrapper
+
+    Parameters
+    ----------
+
+    param : str, :class:`ParameterName`
+        Filter using a parameter name.
+    value : float
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    empty : bool
+        For selection parameters, the predicate of empty selections returns true by default.
+        Override this behavior, by setting this property ``empty: false``.
+    """
+
+    _schema = {"$ref": "#/definitions/ConditionalParameter<ValueDef<number>>"}
+
+    def __init__(
+        self,
+        param: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[float, UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalParameterValueDefnumber, self).__init__(
+            param=param, value=value, empty=empty, **kwds
+        )
+
+
+class ConditionalPredicateValueDefnumber(ConditionalValueDefnumber):
+    """ConditionalPredicateValueDefnumber schema wrapper
+
+    Parameters
+    ----------
+
+    test : str, dict, :class:`Predicate`, :class:`FieldGTPredicate`, :class:`FieldLTPredicate`, :class:`FieldGTEPredicate`, :class:`FieldLTEPredicate`, :class:`LogicalOrPredicate`, :class:`ParameterPredicate`, :class:`FieldEqualPredicate`, :class:`FieldOneOfPredicate`, :class:`FieldRangePredicate`, :class:`FieldValidPredicate`, :class:`LogicalAndPredicate`, :class:`LogicalNotPredicate`, :class:`PredicateComposition`
+        Predicate for triggering the condition
+    value : float
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {"$ref": "#/definitions/ConditionalPredicate<ValueDef<number>>"}
+
+    def __init__(
+        self,
+        test: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalPredicateValueDefnumber, self).__init__(
+            test=test, value=value, **kwds
+        )
+
+
+class ConditionalValueDefnumberArrayExprRef(VegaLiteSchema):
+    """ConditionalValueDefnumberArrayExprRef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalValueDef<(number[]|ExprRef)>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalValueDefnumberArrayExprRef, self).__init__(*args, **kwds)
+
+
+class ConditionalParameterValueDefnumberArrayExprRef(
+    ConditionalValueDefnumberArrayExprRef
+):
+    """ConditionalParameterValueDefnumberArrayExprRef schema wrapper
+
+    Parameters
+    ----------
+
+    param : str, :class:`ParameterName`
+        Filter using a parameter name.
+    value : dict, Sequence[float], :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    empty : bool
+        For selection parameters, the predicate of empty selections returns true by default.
+        Override this behavior, by setting this property ``empty: false``.
+    """
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalParameter<ValueDef<(number[]|ExprRef)>>"
+    }
+
+    def __init__(
+        self,
+        param: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalParameterValueDefnumberArrayExprRef, self).__init__(
+            param=param, value=value, empty=empty, **kwds
+        )
+
+
+class ConditionalPredicateValueDefnumberArrayExprRef(
+    ConditionalValueDefnumberArrayExprRef
+):
+    """ConditionalPredicateValueDefnumberArrayExprRef schema wrapper
+
+    Parameters
+    ----------
+
+    test : str, dict, :class:`Predicate`, :class:`FieldGTPredicate`, :class:`FieldLTPredicate`, :class:`FieldGTEPredicate`, :class:`FieldLTEPredicate`, :class:`LogicalOrPredicate`, :class:`ParameterPredicate`, :class:`FieldEqualPredicate`, :class:`FieldOneOfPredicate`, :class:`FieldRangePredicate`, :class:`FieldValidPredicate`, :class:`LogicalAndPredicate`, :class:`LogicalNotPredicate`, :class:`PredicateComposition`
+        Predicate for triggering the condition
+    value : dict, Sequence[float], :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalPredicate<ValueDef<(number[]|ExprRef)>>"
+    }
+
+    def __init__(
+        self,
+        test: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalPredicateValueDefnumberArrayExprRef, self).__init__(
+            test=test, value=value, **kwds
+        )
+
+
+class ConditionalValueDefnumberExprRef(VegaLiteSchema):
+    """ConditionalValueDefnumberExprRef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalValueDefnumberExprRef, self).__init__(*args, **kwds)
+
+
+class ConditionalParameterValueDefnumberExprRef(ConditionalValueDefnumberExprRef):
+    """ConditionalParameterValueDefnumberExprRef schema wrapper
+
+    Parameters
+    ----------
+
+    param : str, :class:`ParameterName`
+        Filter using a parameter name.
+    value : dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    empty : bool
+        For selection parameters, the predicate of empty selections returns true by default.
+        Override this behavior, by setting this property ``empty: false``.
+    """
+
+    _schema = {"$ref": "#/definitions/ConditionalParameter<ValueDef<(number|ExprRef)>>"}
+
+    def __init__(
+        self,
+        param: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalParameterValueDefnumberExprRef, self).__init__(
+            param=param, value=value, empty=empty, **kwds
+        )
+
+
+class ConditionalPredicateValueDefnumberExprRef(ConditionalValueDefnumberExprRef):
+    """ConditionalPredicateValueDefnumberExprRef schema wrapper
+
+    Parameters
+    ----------
+
+    test : str, dict, :class:`Predicate`, :class:`FieldGTPredicate`, :class:`FieldLTPredicate`, :class:`FieldGTEPredicate`, :class:`FieldLTEPredicate`, :class:`LogicalOrPredicate`, :class:`ParameterPredicate`, :class:`FieldEqualPredicate`, :class:`FieldOneOfPredicate`, :class:`FieldRangePredicate`, :class:`FieldValidPredicate`, :class:`LogicalAndPredicate`, :class:`LogicalNotPredicate`, :class:`PredicateComposition`
+        Predicate for triggering the condition
+    value : dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {"$ref": "#/definitions/ConditionalPredicate<ValueDef<(number|ExprRef)>>"}
+
+    def __init__(
+        self,
+        test: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalPredicateValueDefnumberExprRef, self).__init__(
+            test=test, value=value, **kwds
+        )
+
+
+class ConditionalValueDefstringExprRef(VegaLiteSchema):
+    """ConditionalValueDefstringExprRef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalValueDef<(string|ExprRef)>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalValueDefstringExprRef, self).__init__(*args, **kwds)
+
+
+class ConditionalParameterValueDefstringExprRef(ConditionalValueDefstringExprRef):
+    """ConditionalParameterValueDefstringExprRef schema wrapper
+
+    Parameters
+    ----------
+
+    param : str, :class:`ParameterName`
+        Filter using a parameter name.
+    value : str, dict, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    empty : bool
+        For selection parameters, the predicate of empty selections returns true by default.
+        Override this behavior, by setting this property ``empty: false``.
+    """
+
+    _schema = {"$ref": "#/definitions/ConditionalParameter<ValueDef<(string|ExprRef)>>"}
+
+    def __init__(
+        self,
+        param: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalParameterValueDefstringExprRef, self).__init__(
+            param=param, value=value, empty=empty, **kwds
+        )
+
+
+class ConditionalPredicateValueDefstringExprRef(ConditionalValueDefstringExprRef):
+    """ConditionalPredicateValueDefstringExprRef schema wrapper
+
+    Parameters
+    ----------
+
+    test : str, dict, :class:`Predicate`, :class:`FieldGTPredicate`, :class:`FieldLTPredicate`, :class:`FieldGTEPredicate`, :class:`FieldLTEPredicate`, :class:`LogicalOrPredicate`, :class:`ParameterPredicate`, :class:`FieldEqualPredicate`, :class:`FieldOneOfPredicate`, :class:`FieldRangePredicate`, :class:`FieldValidPredicate`, :class:`LogicalAndPredicate`, :class:`LogicalNotPredicate`, :class:`PredicateComposition`
+        Predicate for triggering the condition
+    value : str, dict, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {"$ref": "#/definitions/ConditionalPredicate<ValueDef<(string|ExprRef)>>"}
+
+    def __init__(
+        self,
+        test: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalPredicateValueDefstringExprRef, self).__init__(
+            test=test, value=value, **kwds
+        )
+
+
+class ConditionalValueDefstringnullExprRef(VegaLiteSchema):
+    """ConditionalValueDefstringnullExprRef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"}
+
+    def __init__(self, *args, **kwds):
+        super(ConditionalValueDefstringnullExprRef, self).__init__(*args, **kwds)
+
+
+class ConditionalParameterValueDefstringnullExprRef(
+    ConditionalValueDefstringnullExprRef
+):
+    """ConditionalParameterValueDefstringnullExprRef schema wrapper
+
+    Parameters
+    ----------
+
+    param : str, :class:`ParameterName`
+        Filter using a parameter name.
+    value : str, dict, None, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    empty : bool
+        For selection parameters, the predicate of empty selections returns true by default.
+        Override this behavior, by setting this property ``empty: false``.
+    """
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalParameter<ValueDef<(string|null|ExprRef)>>"
+    }
+
+    def __init__(
+        self,
+        param: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalParameterValueDefstringnullExprRef, self).__init__(
+            param=param, value=value, empty=empty, **kwds
+        )
+
+
+class ConditionalPredicateValueDefstringnullExprRef(
+    ConditionalValueDefstringnullExprRef
+):
+    """ConditionalPredicateValueDefstringnullExprRef schema wrapper
+
+    Parameters
+    ----------
+
+    test : str, dict, :class:`Predicate`, :class:`FieldGTPredicate`, :class:`FieldLTPredicate`, :class:`FieldGTEPredicate`, :class:`FieldLTEPredicate`, :class:`LogicalOrPredicate`, :class:`ParameterPredicate`, :class:`FieldEqualPredicate`, :class:`FieldOneOfPredicate`, :class:`FieldRangePredicate`, :class:`FieldValidPredicate`, :class:`LogicalAndPredicate`, :class:`LogicalNotPredicate`, :class:`PredicateComposition`
+        Predicate for triggering the condition
+    value : str, dict, None, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {
+        "$ref": "#/definitions/ConditionalPredicate<ValueDef<(string|null|ExprRef)>>"
+    }
+
+    def __init__(
+        self,
+        test: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[
+            str, dict, None, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ConditionalPredicateValueDefstringnullExprRef, self).__init__(
+            test=test, value=value, **kwds
+        )
+
+
+class Config(VegaLiteSchema):
+    """Config schema wrapper
+
+    Parameters
+    ----------
+
+    arc : dict, :class:`RectConfig`
+        Arc-specific Config
+    area : dict, :class:`AreaConfig`
+        Area-Specific Config
+    aria : bool
+        A boolean flag indicating if ARIA default attributes should be included for marks
+        and guides (SVG output only). If false, the ``"aria-hidden"`` attribute will be set
+        for all guides, removing them from the ARIA accessibility tree and Vega-Lite will
+        not generate default descriptions for marks.
+
+        **Default value:** ``true``.
+    autosize : dict, :class:`AutosizeType`, :class:`AutoSizeParams`, Literal['pad', 'none', 'fit', 'fit-x', 'fit-y']
+        How the visualization size should be determined. If a string, should be one of
+        ``"pad"``, ``"fit"`` or ``"none"``. Object values can additionally specify
+        parameters for content sizing and automatic resizing.
+
+        **Default value** : ``pad``
+    axis : dict, :class:`AxisConfig`
+        Axis configuration, which determines default properties for all ``x`` and ``y``
+        `axes <https://vega.github.io/vega-lite/docs/axis.html>`__. For a full list of axis
+        configuration options, please see the `corresponding section of the axis
+        documentation <https://vega.github.io/vega-lite/docs/axis.html#config>`__.
+    axisBand : dict, :class:`AxisConfig`
+        Config for axes with "band" scales.
+    axisBottom : dict, :class:`AxisConfig`
+        Config for x-axis along the bottom edge of the chart.
+    axisDiscrete : dict, :class:`AxisConfig`
+        Config for axes with "point" or "band" scales.
+    axisLeft : dict, :class:`AxisConfig`
+        Config for y-axis along the left edge of the chart.
+    axisPoint : dict, :class:`AxisConfig`
+        Config for axes with "point" scales.
+    axisQuantitative : dict, :class:`AxisConfig`
+        Config for quantitative axes.
+    axisRight : dict, :class:`AxisConfig`
+        Config for y-axis along the right edge of the chart.
+    axisTemporal : dict, :class:`AxisConfig`
+        Config for temporal axes.
+    axisTop : dict, :class:`AxisConfig`
+        Config for x-axis along the top edge of the chart.
+    axisX : dict, :class:`AxisConfig`
+        X-axis specific config.
+    axisXBand : dict, :class:`AxisConfig`
+        Config for x-axes with "band" scales.
+    axisXDiscrete : dict, :class:`AxisConfig`
+        Config for x-axes with "point" or "band" scales.
+    axisXPoint : dict, :class:`AxisConfig`
+        Config for x-axes with "point" scales.
+    axisXQuantitative : dict, :class:`AxisConfig`
+        Config for x-quantitative axes.
+    axisXTemporal : dict, :class:`AxisConfig`
+        Config for x-temporal axes.
+    axisY : dict, :class:`AxisConfig`
+        Y-axis specific config.
+    axisYBand : dict, :class:`AxisConfig`
+        Config for y-axes with "band" scales.
+    axisYDiscrete : dict, :class:`AxisConfig`
+        Config for y-axes with "point" or "band" scales.
+    axisYPoint : dict, :class:`AxisConfig`
+        Config for y-axes with "point" scales.
+    axisYQuantitative : dict, :class:`AxisConfig`
+        Config for y-quantitative axes.
+    axisYTemporal : dict, :class:`AxisConfig`
+        Config for y-temporal axes.
+    background : str, dict, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        CSS color property to use as the background of the entire view.
+
+        **Default value:** ``"white"``
+    bar : dict, :class:`BarConfig`
+        Bar-Specific Config
+    boxplot : dict, :class:`BoxPlotConfig`
+        Box Config
+    circle : dict, :class:`MarkConfig`
+        Circle-Specific Config
+    concat : dict, :class:`CompositionConfig`
+        Default configuration for all concatenation and repeat view composition operators (
+        ``concat``, ``hconcat``, ``vconcat``, and ``repeat`` )
+    countTitle : str
+        Default axis and legend title for count fields.
+
+        **Default value:** ``'Count of Records``.
+    customFormatTypes : bool
+        Allow the ``formatType`` property for text marks and guides to accept a custom
+        formatter function `registered as a Vega expression
+        <https://vega.github.io/vega-lite/usage/compile.html#format-type>`__.
+    errorband : dict, :class:`ErrorBandConfig`
+        ErrorBand Config
+    errorbar : dict, :class:`ErrorBarConfig`
+        ErrorBar Config
+    facet : dict, :class:`CompositionConfig`
+        Default configuration for the ``facet`` view composition operator
+    fieldTitle : Literal['verbal', 'functional', 'plain']
+        Defines how Vega-Lite generates title for fields. There are three possible styles:
+
+
+        * ``"verbal"`` (Default) - displays function in a verbal style (e.g., "Sum of
+          field", "Year-month of date", "field (binned)").
+        * ``"function"`` - displays function using parentheses and capitalized texts (e.g.,
+          "SUM(field)", "YEARMONTH(date)", "BIN(field)").
+        * ``"plain"`` - displays only the field name without functions (e.g., "field",
+          "date", "field").
+    font : str
+        Default font for all text marks, titles, and labels.
+    geoshape : dict, :class:`MarkConfig`
+        Geoshape-Specific Config
+    header : dict, :class:`HeaderConfig`
+        Header configuration, which determines default properties for all `headers
+        <https://vega.github.io/vega-lite/docs/header.html>`__.
+
+        For a full list of header configuration options, please see the `corresponding
+        section of in the header documentation
+        <https://vega.github.io/vega-lite/docs/header.html#config>`__.
+    headerColumn : dict, :class:`HeaderConfig`
+        Header configuration, which determines default properties for column `headers
+        <https://vega.github.io/vega-lite/docs/header.html>`__.
+
+        For a full list of header configuration options, please see the `corresponding
+        section of in the header documentation
+        <https://vega.github.io/vega-lite/docs/header.html#config>`__.
+    headerFacet : dict, :class:`HeaderConfig`
+        Header configuration, which determines default properties for non-row/column facet
+        `headers <https://vega.github.io/vega-lite/docs/header.html>`__.
+
+        For a full list of header configuration options, please see the `corresponding
+        section of in the header documentation
+        <https://vega.github.io/vega-lite/docs/header.html#config>`__.
+    headerRow : dict, :class:`HeaderConfig`
+        Header configuration, which determines default properties for row `headers
+        <https://vega.github.io/vega-lite/docs/header.html>`__.
+
+        For a full list of header configuration options, please see the `corresponding
+        section of in the header documentation
+        <https://vega.github.io/vega-lite/docs/header.html#config>`__.
+    image : dict, :class:`RectConfig`
+        Image-specific Config
+    legend : dict, :class:`LegendConfig`
+        Legend configuration, which determines default properties for all `legends
+        <https://vega.github.io/vega-lite/docs/legend.html>`__. For a full list of legend
+        configuration options, please see the `corresponding section of in the legend
+        documentation <https://vega.github.io/vega-lite/docs/legend.html#config>`__.
+    line : dict, :class:`LineConfig`
+        Line-Specific Config
+    lineBreak : str, dict, :class:`ExprRef`
+        A delimiter, such as a newline character, upon which to break text strings into
+        multiple lines. This property provides a global default for text marks, which is
+        overridden by mark or style config settings, and by the lineBreak mark encoding
+        channel. If signal-valued, either string or regular expression (regexp) values are
+        valid.
+    locale : dict, :class:`Locale`
+        Locale definitions for string parsing and formatting of number and date values. The
+        locale object should contain ``number`` and/or ``time`` properties with `locale
+        definitions <https://vega.github.io/vega/docs/api/locale/>`__. Locale definitions
+        provided in the config block may be overridden by the View constructor locale
+        option.
+    mark : dict, :class:`MarkConfig`
+        Mark Config
+    normalizedNumberFormat : str
+        If normalizedNumberFormatType is not specified, D3 number format for axis labels,
+        text marks, and tooltips of normalized stacked fields (fields with ``stack:
+        "normalize"`` ). For example ``"s"`` for SI units. Use `D3's number format pattern
+        <https://github.com/d3/d3-format#locale_format>`__.
+
+        If ``config.normalizedNumberFormatType`` is specified and
+        ``config.customFormatTypes`` is ``true``, this value will be passed as ``format``
+        alongside ``datum.value`` to the ``config.numberFormatType`` function. **Default
+        value:** ``%``
+    normalizedNumberFormatType : str
+        `Custom format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__ for
+        ``config.normalizedNumberFormat``.
+
+        **Default value:** ``undefined`` -- This is equilvalent to call D3-format, which is
+        exposed as `format in Vega-Expression
+        <https://vega.github.io/vega/docs/expressions/#format>`__. **Note:** You must also
+        set ``customFormatTypes`` to ``true`` to use this feature.
+    numberFormat : str
+        If numberFormatType is not specified, D3 number format for guide labels, text marks,
+        and tooltips of non-normalized fields (fields *without* ``stack: "normalize"`` ).
+        For example ``"s"`` for SI units. Use `D3's number format pattern
+        <https://github.com/d3/d3-format#locale_format>`__.
+
+        If ``config.numberFormatType`` is specified and ``config.customFormatTypes`` is
+        ``true``, this value will be passed as ``format`` alongside ``datum.value`` to the
+        ``config.numberFormatType`` function.
+    numberFormatType : str
+        `Custom format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__ for
+        ``config.numberFormat``.
+
+        **Default value:** ``undefined`` -- This is equilvalent to call D3-format, which is
+        exposed as `format in Vega-Expression
+        <https://vega.github.io/vega/docs/expressions/#format>`__. **Note:** You must also
+        set ``customFormatTypes`` to ``true`` to use this feature.
+    padding : dict, float, :class:`ExprRef`, :class:`Padding`
+        The default visualization padding, in pixels, from the edge of the visualization
+        canvas to the data rectangle. If a number, specifies padding for all sides. If an
+        object, the value should have the format ``{"left": 5, "top": 5, "right": 5,
+        "bottom": 5}`` to specify padding for each side of the visualization.
+
+        **Default value** : ``5``
+    params : Sequence[dict, :class:`TopLevelParameter`, :class:`VariableParameter`, :class:`TopLevelSelectionParameter`]
+        Dynamic variables or selections that parameterize a visualization.
+    point : dict, :class:`MarkConfig`
+        Point-Specific Config
+    projection : dict, :class:`ProjectionConfig`
+        Projection configuration, which determines default properties for all `projections
+        <https://vega.github.io/vega-lite/docs/projection.html>`__. For a full list of
+        projection configuration options, please see the `corresponding section of the
+        projection documentation
+        <https://vega.github.io/vega-lite/docs/projection.html#config>`__.
+    range : dict, :class:`RangeConfig`
+        An object hash that defines default range arrays or schemes for using with scales.
+        For a full list of scale range configuration options, please see the `corresponding
+        section of the scale documentation
+        <https://vega.github.io/vega-lite/docs/scale.html#config>`__.
+    rect : dict, :class:`RectConfig`
+        Rect-Specific Config
+    rule : dict, :class:`MarkConfig`
+        Rule-Specific Config
+    scale : dict, :class:`ScaleConfig`
+        Scale configuration determines default properties for all `scales
+        <https://vega.github.io/vega-lite/docs/scale.html>`__. For a full list of scale
+        configuration options, please see the `corresponding section of the scale
+        documentation <https://vega.github.io/vega-lite/docs/scale.html#config>`__.
+    selection : dict, :class:`SelectionConfig`
+        An object hash for defining default properties for each type of selections.
+    square : dict, :class:`MarkConfig`
+        Square-Specific Config
+    style : dict, :class:`StyleConfigIndex`
+        An object hash that defines key-value mappings to determine default properties for
+        marks with a given `style
+        <https://vega.github.io/vega-lite/docs/mark.html#mark-def>`__. The keys represent
+        styles names; the values have to be valid `mark configuration objects
+        <https://vega.github.io/vega-lite/docs/mark.html#config>`__.
+    text : dict, :class:`MarkConfig`
+        Text-Specific Config
+    tick : dict, :class:`TickConfig`
+        Tick-Specific Config
+    timeFormat : str
+        Default time format for raw time values (without time units) in text marks, legend
+        labels and header labels.
+
+        **Default value:** ``"%b %d, %Y"`` **Note:** Axes automatically determine the format
+        for each label automatically so this config does not affect axes.
+    timeFormatType : str
+        `Custom format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__ for
+        ``config.timeFormat``.
+
+        **Default value:** ``undefined`` -- This is equilvalent to call D3-time-format,
+        which is exposed as `timeFormat in Vega-Expression
+        <https://vega.github.io/vega/docs/expressions/#timeFormat>`__. **Note:** You must
+        also set ``customFormatTypes`` to ``true`` and there must *not* be a ``timeUnit``
+        defined to use this feature.
+    title : dict, :class:`TitleConfig`
+        Title configuration, which determines default properties for all `titles
+        <https://vega.github.io/vega-lite/docs/title.html>`__. For a full list of title
+        configuration options, please see the `corresponding section of the title
+        documentation <https://vega.github.io/vega-lite/docs/title.html#config>`__.
+    tooltipFormat : dict, :class:`FormatConfig`
+        Define `custom format configuration
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ for tooltips. If
+        unspecified, default format config will be applied.
+    trail : dict, :class:`LineConfig`
+        Trail-Specific Config
+    view : dict, :class:`ViewConfig`
+        Default properties for `single view plots
+        <https://vega.github.io/vega-lite/docs/spec.html#single>`__.
+    """
+
+    _schema = {"$ref": "#/definitions/Config"}
+
+    def __init__(
+        self,
+        arc: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        area: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        aria: Union[bool, UndefinedType] = Undefined,
+        autosize: Union[
+            dict,
+            "SchemaBase",
+            Literal["pad", "none", "fit", "fit-x", "fit-y"],
+            UndefinedType,
+        ] = Undefined,
+        axis: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisBand: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisBottom: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisDiscrete: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisLeft: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisPoint: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisQuantitative: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisRight: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisTemporal: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisTop: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisX: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisXBand: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisXDiscrete: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisXPoint: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisXQuantitative: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisXTemporal: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisY: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisYBand: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisYDiscrete: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisYPoint: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisYQuantitative: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        axisYTemporal: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        background: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bar: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        boxplot: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        circle: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        concat: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        countTitle: Union[str, UndefinedType] = Undefined,
+        customFormatTypes: Union[bool, UndefinedType] = Undefined,
+        errorband: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        errorbar: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        facet: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        fieldTitle: Union[
+            Literal["verbal", "functional", "plain"], UndefinedType
+        ] = Undefined,
+        font: Union[str, UndefinedType] = Undefined,
+        geoshape: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        header: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        headerColumn: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        headerFacet: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        headerRow: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        image: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        legend: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        line: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        locale: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        mark: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        normalizedNumberFormat: Union[str, UndefinedType] = Undefined,
+        normalizedNumberFormatType: Union[str, UndefinedType] = Undefined,
+        numberFormat: Union[str, UndefinedType] = Undefined,
+        numberFormatType: Union[str, UndefinedType] = Undefined,
+        padding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        params: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        point: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        projection: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        range: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        rect: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        rule: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        scale: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        selection: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        square: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        style: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        text: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        tick: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        timeFormat: Union[str, UndefinedType] = Undefined,
+        timeFormatType: Union[str, UndefinedType] = Undefined,
+        title: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        tooltipFormat: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        trail: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        view: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(Config, self).__init__(
+            arc=arc,
+            area=area,
+            aria=aria,
+            autosize=autosize,
+            axis=axis,
+            axisBand=axisBand,
+            axisBottom=axisBottom,
+            axisDiscrete=axisDiscrete,
+            axisLeft=axisLeft,
+            axisPoint=axisPoint,
+            axisQuantitative=axisQuantitative,
+            axisRight=axisRight,
+            axisTemporal=axisTemporal,
+            axisTop=axisTop,
+            axisX=axisX,
+            axisXBand=axisXBand,
+            axisXDiscrete=axisXDiscrete,
+            axisXPoint=axisXPoint,
+            axisXQuantitative=axisXQuantitative,
+            axisXTemporal=axisXTemporal,
+            axisY=axisY,
+            axisYBand=axisYBand,
+            axisYDiscrete=axisYDiscrete,
+            axisYPoint=axisYPoint,
+            axisYQuantitative=axisYQuantitative,
+            axisYTemporal=axisYTemporal,
+            background=background,
+            bar=bar,
+            boxplot=boxplot,
+            circle=circle,
+            concat=concat,
+            countTitle=countTitle,
+            customFormatTypes=customFormatTypes,
+            errorband=errorband,
+            errorbar=errorbar,
+            facet=facet,
+            fieldTitle=fieldTitle,
+            font=font,
+            geoshape=geoshape,
+            header=header,
+            headerColumn=headerColumn,
+            headerFacet=headerFacet,
+            headerRow=headerRow,
+            image=image,
+            legend=legend,
+            line=line,
+            lineBreak=lineBreak,
+            locale=locale,
+            mark=mark,
+            normalizedNumberFormat=normalizedNumberFormat,
+            normalizedNumberFormatType=normalizedNumberFormatType,
+            numberFormat=numberFormat,
+            numberFormatType=numberFormatType,
+            padding=padding,
+            params=params,
+            point=point,
+            projection=projection,
+            range=range,
+            rect=rect,
+            rule=rule,
+            scale=scale,
+            selection=selection,
+            square=square,
+            style=style,
+            text=text,
+            tick=tick,
+            timeFormat=timeFormat,
+            timeFormatType=timeFormatType,
+            title=title,
+            tooltipFormat=tooltipFormat,
+            trail=trail,
+            view=view,
+            **kwds,
+        )
+
+
+class Cursor(VegaLiteSchema):
+    """Cursor schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Cursor"}
+
+    def __init__(self, *args):
+        super(Cursor, self).__init__(*args)
+
+
+class Cyclical(ColorScheme):
+    """Cyclical schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Cyclical"}
+
+    def __init__(self, *args):
+        super(Cyclical, self).__init__(*args)
+
+
+class Data(VegaLiteSchema):
+    """Data schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Data"}
+
+    def __init__(self, *args, **kwds):
+        super(Data, self).__init__(*args, **kwds)
+
+
+class DataFormat(VegaLiteSchema):
+    """DataFormat schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/DataFormat"}
+
+    def __init__(self, *args, **kwds):
+        super(DataFormat, self).__init__(*args, **kwds)
+
+
+class CsvDataFormat(DataFormat):
+    """CsvDataFormat schema wrapper
+
+    Parameters
+    ----------
+
+    parse : dict, None, :class:`Parse`
+        If set to ``null``, disable type inference based on the spec and only use type
+        inference based on the data. Alternatively, a parsing directive object can be
+        provided for explicit data types. Each property of the object corresponds to a field
+        name, and the value to the desired data type (one of ``"number"``, ``"boolean"``,
+        ``"date"``, or null (do not parse the field)). For example, ``"parse":
+        {"modified_on": "date"}`` parses the ``modified_on`` field in each input record a
+        Date value.
+
+        For ``"date"``, we parse data based using JavaScript's `Date.parse()
+        <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse>`__.
+        For Specific date formats can be provided (e.g., ``{foo: "date:'%m%d%Y'"}`` ), using
+        the `d3-time-format syntax <https://github.com/d3/d3-time-format#locale_format>`__.
+        UTC date format parsing is supported similarly (e.g., ``{foo: "utc:'%m%d%Y'"}`` ).
+        See more about `UTC time
+        <https://vega.github.io/vega-lite/docs/timeunit.html#utc>`__
+    type : Literal['csv', 'tsv']
+        Type of input data: ``"json"``, ``"csv"``, ``"tsv"``, ``"dsv"``.
+
+        **Default value:**  The default format type is determined by the extension of the
+        file URL. If no extension is detected, ``"json"`` will be used by default.
+    """
+
+    _schema = {"$ref": "#/definitions/CsvDataFormat"}
+
+    def __init__(
+        self,
+        parse: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        type: Union[Literal["csv", "tsv"], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(CsvDataFormat, self).__init__(parse=parse, type=type, **kwds)
+
+
+class DataSource(Data):
+    """DataSource schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/DataSource"}
+
+    def __init__(self, *args, **kwds):
+        super(DataSource, self).__init__(*args, **kwds)
+
+
+class Datasets(VegaLiteSchema):
+    """Datasets schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Datasets"}
+
+    def __init__(self, **kwds):
+        super(Datasets, self).__init__(**kwds)
+
+
+class Day(VegaLiteSchema):
+    """Day schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Day"}
+
+    def __init__(self, *args):
+        super(Day, self).__init__(*args)
+
+
+class Dict(VegaLiteSchema):
+    """Dict schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Dict"}
+
+    def __init__(self, **kwds):
+        super(Dict, self).__init__(**kwds)
+
+
+class DictInlineDataset(VegaLiteSchema):
+    """DictInlineDataset schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Dict<InlineDataset>"}
+
+    def __init__(self, **kwds):
+        super(DictInlineDataset, self).__init__(**kwds)
+
+
+class DictSelectionInit(VegaLiteSchema):
+    """DictSelectionInit schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Dict<SelectionInit>"}
+
+    def __init__(self, **kwds):
+        super(DictSelectionInit, self).__init__(**kwds)
+
+
+class DictSelectionInitInterval(VegaLiteSchema):
+    """DictSelectionInitInterval schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Dict<SelectionInitInterval>"}
+
+    def __init__(self, **kwds):
+        super(DictSelectionInitInterval, self).__init__(**kwds)
+
+
+class Diverging(ColorScheme):
+    """Diverging schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Diverging"}
+
+    def __init__(self, *args):
+        super(Diverging, self).__init__(*args)
+
+
+class DomainUnionWith(VegaLiteSchema):
+    """DomainUnionWith schema wrapper
+
+    Parameters
+    ----------
+
+    unionWith : Sequence[str, bool, dict, float, :class:`DateTime`]
+        Customized domain values to be union with the field's values or explicitly defined
+        domain. Should be an array of valid scale domain values.
+    """
+
+    _schema = {"$ref": "#/definitions/DomainUnionWith"}
+
+    def __init__(
+        self,
+        unionWith: Union[
+            Sequence[Union[str, bool, dict, float, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(DomainUnionWith, self).__init__(unionWith=unionWith, **kwds)
+
+
+class DsvDataFormat(DataFormat):
+    """DsvDataFormat schema wrapper
+
+    Parameters
+    ----------
+
+    delimiter : str
+        The delimiter between records. The delimiter must be a single character (i.e., a
+        single 16-bit code unit); so, ASCII delimiters are fine, but emoji delimiters are
+        not.
+    parse : dict, None, :class:`Parse`
+        If set to ``null``, disable type inference based on the spec and only use type
+        inference based on the data. Alternatively, a parsing directive object can be
+        provided for explicit data types. Each property of the object corresponds to a field
+        name, and the value to the desired data type (one of ``"number"``, ``"boolean"``,
+        ``"date"``, or null (do not parse the field)). For example, ``"parse":
+        {"modified_on": "date"}`` parses the ``modified_on`` field in each input record a
+        Date value.
+
+        For ``"date"``, we parse data based using JavaScript's `Date.parse()
+        <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse>`__.
+        For Specific date formats can be provided (e.g., ``{foo: "date:'%m%d%Y'"}`` ), using
+        the `d3-time-format syntax <https://github.com/d3/d3-time-format#locale_format>`__.
+        UTC date format parsing is supported similarly (e.g., ``{foo: "utc:'%m%d%Y'"}`` ).
+        See more about `UTC time
+        <https://vega.github.io/vega-lite/docs/timeunit.html#utc>`__
+    type : str
+        Type of input data: ``"json"``, ``"csv"``, ``"tsv"``, ``"dsv"``.
+
+        **Default value:**  The default format type is determined by the extension of the
+        file URL. If no extension is detected, ``"json"`` will be used by default.
+    """
+
+    _schema = {"$ref": "#/definitions/DsvDataFormat"}
+
+    def __init__(
+        self,
+        delimiter: Union[str, UndefinedType] = Undefined,
+        parse: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(DsvDataFormat, self).__init__(
+            delimiter=delimiter, parse=parse, type=type, **kwds
+        )
+
+
+class Element(VegaLiteSchema):
+    """Element schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Element"}
+
+    def __init__(self, *args):
+        super(Element, self).__init__(*args)
+
+
+class Encoding(VegaLiteSchema):
+    """Encoding schema wrapper
+
+    Parameters
+    ----------
+
+    angle : dict, :class:`NumericMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumber`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumber`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumber`
+        Rotation angle of point and text marks.
+    color : dict, :class:`ColorDef`, :class:`FieldOrDatumDefWithConditionDatumDefGradientstringnull`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull`
+        Color of the marks – either fill or stroke color based on  the ``filled`` property
+        of mark definition. By default, ``color`` represents fill color for ``"area"``,
+        ``"bar"``, ``"tick"``, ``"text"``, ``"trail"``, ``"circle"``, and ``"square"`` /
+        stroke color for ``"line"`` and ``"point"``.
+
+        **Default value:** If undefined, the default color depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's ``color``
+        property.
+
+        *Note:* 1) For fine-grained control over both fill and stroke colors of the marks,
+        please use the ``fill`` and ``stroke`` channels. The ``fill`` or ``stroke``
+        encodings have higher precedence than ``color``, thus may override the ``color``
+        encoding if conflicting encodings are specified. 2) See the scale documentation for
+        more information about customizing `color scheme
+        <https://vega.github.io/vega-lite/docs/scale.html#scheme>`__.
+    description : dict, :class:`StringFieldDefWithCondition`, :class:`StringValueDefWithCondition`
+        A text description of this mark for ARIA accessibility (SVG output only). For SVG
+        output the ``"aria-label"`` attribute will be set to this description.
+    detail : dict, :class:`FieldDefWithoutScale`, Sequence[dict, :class:`FieldDefWithoutScale`]
+        Additional levels of detail for grouping data in aggregate views and in line, trail,
+        and area marks without mapping data to a specific visual channel.
+    fill : dict, :class:`ColorDef`, :class:`FieldOrDatumDefWithConditionDatumDefGradientstringnull`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull`
+        Fill color of the marks. **Default value:** If undefined, the default color depends
+        on `mark config <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__
+        's ``color`` property.
+
+        *Note:* The ``fill`` encoding has higher precedence than ``color``, thus may
+        override the ``color`` encoding if conflicting encodings are specified.
+    fillOpacity : dict, :class:`NumericMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumber`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumber`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumber`
+        Fill opacity of the marks.
+
+        **Default value:** If undefined, the default opacity depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's
+        ``fillOpacity`` property.
+    href : dict, :class:`StringFieldDefWithCondition`, :class:`StringValueDefWithCondition`
+        A URL to load upon mouse click.
+    key : dict, :class:`FieldDefWithoutScale`
+        A data field to use as a unique key for data binding. When a visualization’s data is
+        updated, the key value will be used to match data elements to existing mark
+        instances. Use a key channel to enable object constancy for transitions over dynamic
+        data.
+    latitude : dict, :class:`DatumDef`, :class:`LatLongDef`, :class:`LatLongFieldDef`
+        Latitude position of geographically projected marks.
+    latitude2 : dict, :class:`DatumDef`, :class:`Position2Def`, :class:`PositionValueDef`, :class:`SecondaryFieldDef`
+        Latitude-2 position for geographically projected ranged ``"area"``, ``"bar"``,
+        ``"rect"``, and  ``"rule"``.
+    longitude : dict, :class:`DatumDef`, :class:`LatLongDef`, :class:`LatLongFieldDef`
+        Longitude position of geographically projected marks.
+    longitude2 : dict, :class:`DatumDef`, :class:`Position2Def`, :class:`PositionValueDef`, :class:`SecondaryFieldDef`
+        Longitude-2 position for geographically projected ranged ``"area"``, ``"bar"``,
+        ``"rect"``, and  ``"rule"``.
+    opacity : dict, :class:`NumericMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumber`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumber`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumber`
+        Opacity of the marks.
+
+        **Default value:** If undefined, the default opacity depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's ``opacity``
+        property.
+    order : dict, :class:`OrderOnlyDef`, :class:`OrderFieldDef`, :class:`OrderValueDef`, Sequence[dict, :class:`OrderFieldDef`]
+        Order of the marks.
+
+
+        * For stacked marks, this ``order`` channel encodes `stack order
+          <https://vega.github.io/vega-lite/docs/stack.html#order>`__.
+        * For line and trail marks, this ``order`` channel encodes order of data points in
+          the lines. This can be useful for creating `a connected scatterplot
+          <https://vega.github.io/vega-lite/examples/connected_scatterplot.html>`__. Setting
+          ``order`` to ``{"value": null}`` makes the line marks use the original order in
+          the data sources.
+        * Otherwise, this ``order`` channel encodes layer order of the marks.
+
+        **Note** : In aggregate plots, ``order`` field should be ``aggregate`` d to avoid
+        creating additional aggregation grouping.
+    radius : dict, :class:`PolarDef`, :class:`PositionValueDef`, :class:`PositionDatumDefBase`, :class:`PositionFieldDefBase`
+        The outer radius in pixels of arc marks.
+    radius2 : dict, :class:`DatumDef`, :class:`Position2Def`, :class:`PositionValueDef`, :class:`SecondaryFieldDef`
+        The inner radius in pixels of arc marks.
+    shape : dict, :class:`ShapeDef`, :class:`FieldOrDatumDefWithConditionDatumDefstringnull`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefTypeForShapestringnull`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefTypeForShapestringnull`
+        Shape of the mark.
+
+
+        #.
+        For ``point`` marks the supported values include:   - plotting shapes: ``"circle"``,
+        ``"square"``, ``"cross"``, ``"diamond"``, ``"triangle-up"``, ``"triangle-down"``,
+        ``"triangle-right"``, or ``"triangle-left"``.   - the line symbol ``"stroke"``   -
+        centered directional shapes ``"arrow"``, ``"wedge"``, or ``"triangle"``   - a custom
+        `SVG path string
+        <https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths>`__ (For correct
+        sizing, custom shape paths should be defined within a square bounding box with
+        coordinates ranging from -1 to 1 along both the x and y dimensions.)
+
+        #.
+        For ``geoshape`` marks it should be a field definition of the geojson data
+
+        **Default value:** If undefined, the default shape depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#point-config>`__ 's ``shape``
+        property. ( ``"circle"`` if unset.)
+    size : dict, :class:`NumericMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumber`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumber`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumber`
+        Size of the mark.
+
+
+        * For ``"point"``, ``"square"`` and ``"circle"``, – the symbol size, or pixel area
+          of the mark.
+        * For ``"bar"`` and ``"tick"`` – the bar and tick's size.
+        * For ``"text"`` – the text's font size.
+        * Size is unsupported for ``"line"``, ``"area"``, and ``"rect"``. (Use ``"trail"``
+          instead of line with varying size)
+    stroke : dict, :class:`ColorDef`, :class:`FieldOrDatumDefWithConditionDatumDefGradientstringnull`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull`
+        Stroke color of the marks. **Default value:** If undefined, the default color
+        depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's ``color``
+        property.
+
+        *Note:* The ``stroke`` encoding has higher precedence than ``color``, thus may
+        override the ``color`` encoding if conflicting encodings are specified.
+    strokeDash : dict, :class:`NumericArrayMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumberArray`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumberArray`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumberArray`
+        Stroke dash of the marks.
+
+        **Default value:** ``[1,0]`` (No dash).
+    strokeOpacity : dict, :class:`NumericMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumber`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumber`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumber`
+        Stroke opacity of the marks.
+
+        **Default value:** If undefined, the default opacity depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's
+        ``strokeOpacity`` property.
+    strokeWidth : dict, :class:`NumericMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumber`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumber`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumber`
+        Stroke width of the marks.
+
+        **Default value:** If undefined, the default stroke width depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's
+        ``strokeWidth`` property.
+    text : dict, :class:`TextDef`, :class:`ValueDefWithConditionStringFieldDefText`, :class:`FieldOrDatumDefWithConditionStringDatumDefText`, :class:`FieldOrDatumDefWithConditionStringFieldDefText`
+        Text of the ``text`` mark.
+    theta : dict, :class:`PolarDef`, :class:`PositionValueDef`, :class:`PositionDatumDefBase`, :class:`PositionFieldDefBase`
+        For arc marks, the arc length in radians if theta2 is not specified, otherwise the
+        start arc angle. (A value of 0 indicates up or “north”, increasing values proceed
+        clockwise.)
+
+        For text marks, polar coordinate angle in radians.
+    theta2 : dict, :class:`DatumDef`, :class:`Position2Def`, :class:`PositionValueDef`, :class:`SecondaryFieldDef`
+        The end angle of arc marks in radians. A value of 0 indicates up or “north”,
+        increasing values proceed clockwise.
+    tooltip : dict, None, :class:`StringFieldDefWithCondition`, :class:`StringValueDefWithCondition`, Sequence[dict, :class:`StringFieldDef`]
+        The tooltip text to show upon mouse hover. Specifying ``tooltip`` encoding overrides
+        `the tooltip property in the mark definition
+        <https://vega.github.io/vega-lite/docs/mark.html#mark-def>`__.
+
+        See the `tooltip <https://vega.github.io/vega-lite/docs/tooltip.html>`__
+        documentation for a detailed discussion about tooltip in Vega-Lite.
+    url : dict, :class:`StringFieldDefWithCondition`, :class:`StringValueDefWithCondition`
+        The URL of an image mark.
+    x : dict, :class:`PositionDef`, :class:`PositionDatumDef`, :class:`PositionFieldDef`, :class:`PositionValueDef`
+        X coordinates of the marks, or width of horizontal ``"bar"`` and ``"area"`` without
+        specified ``x2`` or ``width``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    x2 : dict, :class:`DatumDef`, :class:`Position2Def`, :class:`PositionValueDef`, :class:`SecondaryFieldDef`
+        X2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    xError : dict, :class:`ValueDefnumber`, :class:`SecondaryFieldDef`
+        Error value of x coordinates for error specified ``"errorbar"`` and ``"errorband"``.
+    xError2 : dict, :class:`ValueDefnumber`, :class:`SecondaryFieldDef`
+        Secondary error value of x coordinates for error specified ``"errorbar"`` and
+        ``"errorband"``.
+    xOffset : dict, :class:`OffsetDef`, :class:`ScaleDatumDef`, :class:`ScaleFieldDef`, :class:`ValueDefnumber`
+        Offset of x-position of the marks
+    y : dict, :class:`PositionDef`, :class:`PositionDatumDef`, :class:`PositionFieldDef`, :class:`PositionValueDef`
+        Y coordinates of the marks, or height of vertical ``"bar"`` and ``"area"`` without
+        specified ``y2`` or ``height``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    y2 : dict, :class:`DatumDef`, :class:`Position2Def`, :class:`PositionValueDef`, :class:`SecondaryFieldDef`
+        Y2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    yError : dict, :class:`ValueDefnumber`, :class:`SecondaryFieldDef`
+        Error value of y coordinates for error specified ``"errorbar"`` and ``"errorband"``.
+    yError2 : dict, :class:`ValueDefnumber`, :class:`SecondaryFieldDef`
+        Secondary error value of y coordinates for error specified ``"errorbar"`` and
+        ``"errorband"``.
+    yOffset : dict, :class:`OffsetDef`, :class:`ScaleDatumDef`, :class:`ScaleFieldDef`, :class:`ValueDefnumber`
+        Offset of y-position of the marks
+    """
+
+    _schema = {"$ref": "#/definitions/Encoding"}
+
+    def __init__(
+        self,
+        angle: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        color: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        detail: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        fill: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        fillOpacity: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        href: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        key: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        latitude: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        latitude2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        longitude: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        longitude2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        opacity: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        order: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        radius: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        radius2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        shape: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        size: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        stroke: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        strokeDash: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        strokeOpacity: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        strokeWidth: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        text: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        theta: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        theta2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        tooltip: Union[
+            dict, None, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        url: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        x: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        x2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        xError: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        xError2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        xOffset: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        y: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        y2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        yError: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        yError2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        yOffset: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(Encoding, self).__init__(
+            angle=angle,
+            color=color,
+            description=description,
+            detail=detail,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            href=href,
+            key=key,
+            latitude=latitude,
+            latitude2=latitude2,
+            longitude=longitude,
+            longitude2=longitude2,
+            opacity=opacity,
+            order=order,
+            radius=radius,
+            radius2=radius2,
+            shape=shape,
+            size=size,
+            stroke=stroke,
+            strokeDash=strokeDash,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            tooltip=tooltip,
+            url=url,
+            x=x,
+            x2=x2,
+            xError=xError,
+            xError2=xError2,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            yError=yError,
+            yError2=yError2,
+            yOffset=yOffset,
+            **kwds,
+        )
+
+
+class ErrorBand(CompositeMark):
+    """ErrorBand schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ErrorBand"}
+
+    def __init__(self, *args):
+        super(ErrorBand, self).__init__(*args)
+
+
+class ErrorBandConfig(VegaLiteSchema):
+    """ErrorBandConfig schema wrapper
+
+    Parameters
+    ----------
+
+    band : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    borders : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    extent : :class:`ErrorBarExtent`, Literal['ci', 'iqr', 'stderr', 'stdev']
+        The extent of the band. Available options include:
+
+
+        * ``"ci"`` : Extend the band to the confidence interval of the mean.
+        * ``"stderr"`` : The size of band are set to the value of standard error, extending
+          from the mean.
+        * ``"stdev"`` : The size of band are set to the value of standard deviation,
+          extending from the mean.
+        * ``"iqr"`` : Extend the band to the q1 and q3.
+
+        **Default value:** ``"stderr"``.
+    interpolate : :class:`Interpolate`, Literal['basis', 'basis-open', 'basis-closed', 'bundle', 'cardinal', 'cardinal-open', 'cardinal-closed', 'catmull-rom', 'linear', 'linear-closed', 'monotone', 'natural', 'step', 'step-before', 'step-after']
+        The line interpolation method for the error band. One of the following:
+
+
+        * ``"linear"`` : piecewise linear segments, as in a polyline.
+        * ``"linear-closed"`` : close the linear segments to form a polygon.
+        * ``"step"`` : a piecewise constant function (a step function) consisting of
+          alternating horizontal and vertical lines. The y-value changes at the midpoint of
+          each pair of adjacent x-values.
+        * ``"step-before"`` : a piecewise constant function (a step function) consisting of
+          alternating horizontal and vertical lines. The y-value changes before the x-value.
+        * ``"step-after"`` : a piecewise constant function (a step function) consisting of
+          alternating horizontal and vertical lines. The y-value changes after the x-value.
+        * ``"basis"`` : a B-spline, with control point duplication on the ends.
+        * ``"basis-open"`` : an open B-spline; may not intersect the start or end.
+        * ``"basis-closed"`` : a closed B-spline, as in a loop.
+        * ``"cardinal"`` : a Cardinal spline, with control point duplication on the ends.
+        * ``"cardinal-open"`` : an open Cardinal spline; may not intersect the start or end,
+          but will intersect other control points.
+        * ``"cardinal-closed"`` : a closed Cardinal spline, as in a loop.
+        * ``"bundle"`` : equivalent to basis, except the tension parameter is used to
+          straighten the spline.
+        * ``"monotone"`` : cubic interpolation that preserves monotonicity in y.
+    tension : float
+        The tension parameter for the interpolation type of the error band.
+    """
+
+    _schema = {"$ref": "#/definitions/ErrorBandConfig"}
+
+    def __init__(
+        self,
+        band: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        borders: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        extent: Union[
+            "SchemaBase", Literal["ci", "iqr", "stderr", "stdev"], UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            "SchemaBase",
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tension: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ErrorBandConfig, self).__init__(
+            band=band,
+            borders=borders,
+            extent=extent,
+            interpolate=interpolate,
+            tension=tension,
+            **kwds,
+        )
+
+
+class ErrorBandDef(CompositeMarkDef):
+    """ErrorBandDef schema wrapper
+
+    Parameters
+    ----------
+
+    type : str, :class:`ErrorBand`
+        The mark type. This could a primitive mark type (one of ``"bar"``, ``"circle"``,
+        ``"square"``, ``"tick"``, ``"line"``, ``"area"``, ``"point"``, ``"geoshape"``,
+        ``"rule"``, and ``"text"`` ) or a composite mark type ( ``"boxplot"``,
+        ``"errorband"``, ``"errorbar"`` ).
+    band : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    borders : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    clip : bool
+        Whether a composite mark be clipped to the enclosing group’s width and height.
+    color : str, dict, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default color.
+
+        **Default value:** :raw-html:`<span style="color: #4682b4;">&#9632;</span>`
+        ``"#4682b4"``
+
+        **Note:**
+
+
+        * This property cannot be used in a `style config
+          <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+        * The ``fill`` and ``stroke`` properties have higher precedence than ``color`` and
+          will override ``color``.
+    extent : :class:`ErrorBarExtent`, Literal['ci', 'iqr', 'stderr', 'stdev']
+        The extent of the band. Available options include:
+
+
+        * ``"ci"`` : Extend the band to the confidence interval of the mean.
+        * ``"stderr"`` : The size of band are set to the value of standard error, extending
+          from the mean.
+        * ``"stdev"`` : The size of band are set to the value of standard deviation,
+          extending from the mean.
+        * ``"iqr"`` : Extend the band to the q1 and q3.
+
+        **Default value:** ``"stderr"``.
+    interpolate : :class:`Interpolate`, Literal['basis', 'basis-open', 'basis-closed', 'bundle', 'cardinal', 'cardinal-open', 'cardinal-closed', 'catmull-rom', 'linear', 'linear-closed', 'monotone', 'natural', 'step', 'step-before', 'step-after']
+        The line interpolation method for the error band. One of the following:
+
+
+        * ``"linear"`` : piecewise linear segments, as in a polyline.
+        * ``"linear-closed"`` : close the linear segments to form a polygon.
+        * ``"step"`` : a piecewise constant function (a step function) consisting of
+          alternating horizontal and vertical lines. The y-value changes at the midpoint of
+          each pair of adjacent x-values.
+        * ``"step-before"`` : a piecewise constant function (a step function) consisting of
+          alternating horizontal and vertical lines. The y-value changes before the x-value.
+        * ``"step-after"`` : a piecewise constant function (a step function) consisting of
+          alternating horizontal and vertical lines. The y-value changes after the x-value.
+        * ``"basis"`` : a B-spline, with control point duplication on the ends.
+        * ``"basis-open"`` : an open B-spline; may not intersect the start or end.
+        * ``"basis-closed"`` : a closed B-spline, as in a loop.
+        * ``"cardinal"`` : a Cardinal spline, with control point duplication on the ends.
+        * ``"cardinal-open"`` : an open Cardinal spline; may not intersect the start or end,
+          but will intersect other control points.
+        * ``"cardinal-closed"`` : a closed Cardinal spline, as in a loop.
+        * ``"bundle"`` : equivalent to basis, except the tension parameter is used to
+          straighten the spline.
+        * ``"monotone"`` : cubic interpolation that preserves monotonicity in y.
+    opacity : float
+        The opacity (value between [0,1]) of the mark.
+    orient : :class:`Orientation`, Literal['horizontal', 'vertical']
+        Orientation of the error band. This is normally automatically determined, but can be
+        specified when the orientation is ambiguous and cannot be automatically determined.
+    tension : float
+        The tension parameter for the interpolation type of the error band.
+    """
+
+    _schema = {"$ref": "#/definitions/ErrorBandDef"}
+
+    def __init__(
+        self,
+        type: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        band: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        borders: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        clip: Union[bool, UndefinedType] = Undefined,
+        color: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        extent: Union[
+            "SchemaBase", Literal["ci", "iqr", "stderr", "stdev"], UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            "SchemaBase",
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        opacity: Union[float, UndefinedType] = Undefined,
+        orient: Union[
+            "SchemaBase", Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        tension: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ErrorBandDef, self).__init__(
+            type=type,
+            band=band,
+            borders=borders,
+            clip=clip,
+            color=color,
+            extent=extent,
+            interpolate=interpolate,
+            opacity=opacity,
+            orient=orient,
+            tension=tension,
+            **kwds,
+        )
+
+
+class ErrorBar(CompositeMark):
+    """ErrorBar schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ErrorBar"}
+
+    def __init__(self, *args):
+        super(ErrorBar, self).__init__(*args)
+
+
+class ErrorBarConfig(VegaLiteSchema):
+    """ErrorBarConfig schema wrapper
+
+    Parameters
+    ----------
+
+    extent : :class:`ErrorBarExtent`, Literal['ci', 'iqr', 'stderr', 'stdev']
+        The extent of the rule. Available options include:
+
+
+        * ``"ci"`` : Extend the rule to the confidence interval of the mean.
+        * ``"stderr"`` : The size of rule are set to the value of standard error, extending
+          from the mean.
+        * ``"stdev"`` : The size of rule are set to the value of standard deviation,
+          extending from the mean.
+        * ``"iqr"`` : Extend the rule to the q1 and q3.
+
+        **Default value:** ``"stderr"``.
+    rule : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    size : float
+        Size of the ticks of an error bar
+    thickness : float
+        Thickness of the ticks and the bar of an error bar
+    ticks : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    """
+
+    _schema = {"$ref": "#/definitions/ErrorBarConfig"}
+
+    def __init__(
+        self,
+        extent: Union[
+            "SchemaBase", Literal["ci", "iqr", "stderr", "stdev"], UndefinedType
+        ] = Undefined,
+        rule: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        size: Union[float, UndefinedType] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        ticks: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ErrorBarConfig, self).__init__(
+            extent=extent,
+            rule=rule,
+            size=size,
+            thickness=thickness,
+            ticks=ticks,
+            **kwds,
+        )
+
+
+class ErrorBarDef(CompositeMarkDef):
+    """ErrorBarDef schema wrapper
+
+    Parameters
+    ----------
+
+    type : str, :class:`ErrorBar`
+        The mark type. This could a primitive mark type (one of ``"bar"``, ``"circle"``,
+        ``"square"``, ``"tick"``, ``"line"``, ``"area"``, ``"point"``, ``"geoshape"``,
+        ``"rule"``, and ``"text"`` ) or a composite mark type ( ``"boxplot"``,
+        ``"errorband"``, ``"errorbar"`` ).
+    clip : bool
+        Whether a composite mark be clipped to the enclosing group’s width and height.
+    color : str, dict, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default color.
+
+        **Default value:** :raw-html:`<span style="color: #4682b4;">&#9632;</span>`
+        ``"#4682b4"``
+
+        **Note:**
+
+
+        * This property cannot be used in a `style config
+          <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+        * The ``fill`` and ``stroke`` properties have higher precedence than ``color`` and
+          will override ``color``.
+    extent : :class:`ErrorBarExtent`, Literal['ci', 'iqr', 'stderr', 'stdev']
+        The extent of the rule. Available options include:
+
+
+        * ``"ci"`` : Extend the rule to the confidence interval of the mean.
+        * ``"stderr"`` : The size of rule are set to the value of standard error, extending
+          from the mean.
+        * ``"stdev"`` : The size of rule are set to the value of standard deviation,
+          extending from the mean.
+        * ``"iqr"`` : Extend the rule to the q1 and q3.
+
+        **Default value:** ``"stderr"``.
+    opacity : float
+        The opacity (value between [0,1]) of the mark.
+    orient : :class:`Orientation`, Literal['horizontal', 'vertical']
+        Orientation of the error bar. This is normally automatically determined, but can be
+        specified when the orientation is ambiguous and cannot be automatically determined.
+    rule : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    size : float
+        Size of the ticks of an error bar
+    thickness : float
+        Thickness of the ticks and the bar of an error bar
+    ticks : bool, dict, :class:`BarConfig`, :class:`AreaConfig`, :class:`LineConfig`, :class:`MarkConfig`, :class:`RectConfig`, :class:`TickConfig`, :class:`AnyMarkConfig`
+
+    """
+
+    _schema = {"$ref": "#/definitions/ErrorBarDef"}
+
+    def __init__(
+        self,
+        type: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        clip: Union[bool, UndefinedType] = Undefined,
+        color: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        extent: Union[
+            "SchemaBase", Literal["ci", "iqr", "stderr", "stdev"], UndefinedType
+        ] = Undefined,
+        opacity: Union[float, UndefinedType] = Undefined,
+        orient: Union[
+            "SchemaBase", Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        rule: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        size: Union[float, UndefinedType] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        ticks: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ErrorBarDef, self).__init__(
+            type=type,
+            clip=clip,
+            color=color,
+            extent=extent,
+            opacity=opacity,
+            orient=orient,
+            rule=rule,
+            size=size,
+            thickness=thickness,
+            ticks=ticks,
+            **kwds,
+        )
+
+
+class ErrorBarExtent(VegaLiteSchema):
+    """ErrorBarExtent schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ErrorBarExtent"}
+
+    def __init__(self, *args):
+        super(ErrorBarExtent, self).__init__(*args)
+
+
+class Expr(VegaLiteSchema):
+    """Expr schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Expr"}
+
+    def __init__(self, *args):
+        super(Expr, self).__init__(*args)
+
+
+class ExprRef(VegaLiteSchema):
+    """ExprRef schema wrapper
+
+    Parameters
+    ----------
+
+    expr : str
+        Vega expression (which can refer to Vega-Lite parameters).
+    """
+
+    _schema = {"$ref": "#/definitions/ExprRef"}
+
+    def __init__(self, expr: Union[str, UndefinedType] = Undefined, **kwds):
+        super(ExprRef, self).__init__(expr=expr, **kwds)
+
+
+class FacetEncodingFieldDef(VegaLiteSchema):
+    """FacetEncodingFieldDef schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    align : dict, :class:`LayoutAlign`, :class:`RowColLayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to grid rows and columns. The supported string values are
+        ``"all"``, ``"each"``, and ``"none"``.
+
+
+        * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply
+          placed one after the other.
+        * For ``"each"``, subviews will be aligned into a clean grid structure, but each row
+          or column may be of variable size.
+        * For ``"all"``, subviews will be aligned and each row or column will be sized
+          identically based on the maximum observed size. String values for this property
+          will be applied to both grid rows and columns.
+
+        Alternatively, an object value of the form ``{"row": string, "column": string}`` can
+        be used to supply different alignments for rows and columns.
+
+        **Default value:** ``"all"``.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool, dict, :class:`RowColboolean`
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        An object value of the form ``{"row": boolean, "column": boolean}`` can be used to
+        supply different centering values for rows and columns.
+
+        **Default value:** ``false``
+    columns : float
+        The number of columns to include in the view composition layout.
+
+        **Default value** : ``undefined`` -- An infinite number of columns (a single row)
+        will be assumed. This is equivalent to ``hconcat`` (for ``concat`` ) and to using
+        the ``column`` channel (for ``facet`` and ``repeat`` ).
+
+        **Note** :
+
+        1) This property is only for:
+
+
+        * the general (wrappable) ``concat`` operator (not ``hconcat`` / ``vconcat`` )
+        * the ``facet`` and ``repeat`` operator with one field/repetition definition
+          (without row/column nesting)
+
+        2) Setting the ``columns`` to ``1`` is equivalent to ``vconcat`` (for ``concat`` )
+        and to using the ``row`` channel (for ``facet`` and ``repeat`` ).
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    header : dict, None, :class:`Header`
+        An object defining properties of a facet's header.
+    sort : dict, None, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`EncodingSortField`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` is not supported for ``row`` and ``column``.
+    spacing : dict, float, :class:`RowColnumber`
+        The spacing in pixels between sub-views of the composition operator. An object of
+        the form ``{"row": number, "column": number}`` can be used to set different spacing
+        values for rows and columns.
+
+        **Default value** : Depends on ``"spacing"`` property of `the view composition
+        configuration <https://vega.github.io/vega-lite/docs/config.html#view-config>`__ (
+        ``20`` by default)
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/FacetEncodingFieldDef"}
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        align: Union[
+            dict, "SchemaBase", Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        columns: Union[float, UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        header: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, "SchemaBase"]],
+            UndefinedType,
+        ] = Undefined,
+        spacing: Union[dict, float, "SchemaBase", UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FacetEncodingFieldDef, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            align=align,
+            bandPosition=bandPosition,
+            bin=bin,
+            bounds=bounds,
+            center=center,
+            columns=columns,
+            field=field,
+            header=header,
+            sort=sort,
+            spacing=spacing,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class FacetFieldDef(VegaLiteSchema):
+    """FacetFieldDef schema wrapper
+
+    Parameters
+    ----------
+
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    header : dict, None, :class:`Header`
+        An object defining properties of a facet's header.
+    sort : dict, None, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`EncodingSortField`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` is not supported for ``row`` and ``column``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/FacetFieldDef"}
+
+    def __init__(
+        self,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        header: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, "SchemaBase"]],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FacetFieldDef, self).__init__(
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            header=header,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class FacetMapping(VegaLiteSchema):
+    """FacetMapping schema wrapper
+
+    Parameters
+    ----------
+
+    column : dict, :class:`FacetFieldDef`
+        A field definition for the horizontal facet of trellis plots.
+    row : dict, :class:`FacetFieldDef`
+        A field definition for the vertical facet of trellis plots.
+    """
+
+    _schema = {"$ref": "#/definitions/FacetMapping"}
+
+    def __init__(
+        self,
+        column: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        row: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(FacetMapping, self).__init__(column=column, row=row, **kwds)
+
+
+class FacetedEncoding(VegaLiteSchema):
+    """FacetedEncoding schema wrapper
+
+    Parameters
+    ----------
+
+    angle : dict, :class:`NumericMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumber`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumber`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumber`
+        Rotation angle of point and text marks.
+    color : dict, :class:`ColorDef`, :class:`FieldOrDatumDefWithConditionDatumDefGradientstringnull`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull`
+        Color of the marks – either fill or stroke color based on  the ``filled`` property
+        of mark definition. By default, ``color`` represents fill color for ``"area"``,
+        ``"bar"``, ``"tick"``, ``"text"``, ``"trail"``, ``"circle"``, and ``"square"`` /
+        stroke color for ``"line"`` and ``"point"``.
+
+        **Default value:** If undefined, the default color depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's ``color``
+        property.
+
+        *Note:* 1) For fine-grained control over both fill and stroke colors of the marks,
+        please use the ``fill`` and ``stroke`` channels. The ``fill`` or ``stroke``
+        encodings have higher precedence than ``color``, thus may override the ``color``
+        encoding if conflicting encodings are specified. 2) See the scale documentation for
+        more information about customizing `color scheme
+        <https://vega.github.io/vega-lite/docs/scale.html#scheme>`__.
+    column : dict, :class:`RowColumnEncodingFieldDef`
+        A field definition for the horizontal facet of trellis plots.
+    description : dict, :class:`StringFieldDefWithCondition`, :class:`StringValueDefWithCondition`
+        A text description of this mark for ARIA accessibility (SVG output only). For SVG
+        output the ``"aria-label"`` attribute will be set to this description.
+    detail : dict, :class:`FieldDefWithoutScale`, Sequence[dict, :class:`FieldDefWithoutScale`]
+        Additional levels of detail for grouping data in aggregate views and in line, trail,
+        and area marks without mapping data to a specific visual channel.
+    facet : dict, :class:`FacetEncodingFieldDef`
+        A field definition for the (flexible) facet of trellis plots.
+
+        If either ``row`` or ``column`` is specified, this channel will be ignored.
+    fill : dict, :class:`ColorDef`, :class:`FieldOrDatumDefWithConditionDatumDefGradientstringnull`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull`
+        Fill color of the marks. **Default value:** If undefined, the default color depends
+        on `mark config <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__
+        's ``color`` property.
+
+        *Note:* The ``fill`` encoding has higher precedence than ``color``, thus may
+        override the ``color`` encoding if conflicting encodings are specified.
+    fillOpacity : dict, :class:`NumericMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumber`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumber`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumber`
+        Fill opacity of the marks.
+
+        **Default value:** If undefined, the default opacity depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's
+        ``fillOpacity`` property.
+    href : dict, :class:`StringFieldDefWithCondition`, :class:`StringValueDefWithCondition`
+        A URL to load upon mouse click.
+    key : dict, :class:`FieldDefWithoutScale`
+        A data field to use as a unique key for data binding. When a visualization’s data is
+        updated, the key value will be used to match data elements to existing mark
+        instances. Use a key channel to enable object constancy for transitions over dynamic
+        data.
+    latitude : dict, :class:`DatumDef`, :class:`LatLongDef`, :class:`LatLongFieldDef`
+        Latitude position of geographically projected marks.
+    latitude2 : dict, :class:`DatumDef`, :class:`Position2Def`, :class:`PositionValueDef`, :class:`SecondaryFieldDef`
+        Latitude-2 position for geographically projected ranged ``"area"``, ``"bar"``,
+        ``"rect"``, and  ``"rule"``.
+    longitude : dict, :class:`DatumDef`, :class:`LatLongDef`, :class:`LatLongFieldDef`
+        Longitude position of geographically projected marks.
+    longitude2 : dict, :class:`DatumDef`, :class:`Position2Def`, :class:`PositionValueDef`, :class:`SecondaryFieldDef`
+        Longitude-2 position for geographically projected ranged ``"area"``, ``"bar"``,
+        ``"rect"``, and  ``"rule"``.
+    opacity : dict, :class:`NumericMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumber`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumber`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumber`
+        Opacity of the marks.
+
+        **Default value:** If undefined, the default opacity depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's ``opacity``
+        property.
+    order : dict, :class:`OrderOnlyDef`, :class:`OrderFieldDef`, :class:`OrderValueDef`, Sequence[dict, :class:`OrderFieldDef`]
+        Order of the marks.
+
+
+        * For stacked marks, this ``order`` channel encodes `stack order
+          <https://vega.github.io/vega-lite/docs/stack.html#order>`__.
+        * For line and trail marks, this ``order`` channel encodes order of data points in
+          the lines. This can be useful for creating `a connected scatterplot
+          <https://vega.github.io/vega-lite/examples/connected_scatterplot.html>`__. Setting
+          ``order`` to ``{"value": null}`` makes the line marks use the original order in
+          the data sources.
+        * Otherwise, this ``order`` channel encodes layer order of the marks.
+
+        **Note** : In aggregate plots, ``order`` field should be ``aggregate`` d to avoid
+        creating additional aggregation grouping.
+    radius : dict, :class:`PolarDef`, :class:`PositionValueDef`, :class:`PositionDatumDefBase`, :class:`PositionFieldDefBase`
+        The outer radius in pixels of arc marks.
+    radius2 : dict, :class:`DatumDef`, :class:`Position2Def`, :class:`PositionValueDef`, :class:`SecondaryFieldDef`
+        The inner radius in pixels of arc marks.
+    row : dict, :class:`RowColumnEncodingFieldDef`
+        A field definition for the vertical facet of trellis plots.
+    shape : dict, :class:`ShapeDef`, :class:`FieldOrDatumDefWithConditionDatumDefstringnull`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefTypeForShapestringnull`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefTypeForShapestringnull`
+        Shape of the mark.
+
+
+        #.
+        For ``point`` marks the supported values include:   - plotting shapes: ``"circle"``,
+        ``"square"``, ``"cross"``, ``"diamond"``, ``"triangle-up"``, ``"triangle-down"``,
+        ``"triangle-right"``, or ``"triangle-left"``.   - the line symbol ``"stroke"``   -
+        centered directional shapes ``"arrow"``, ``"wedge"``, or ``"triangle"``   - a custom
+        `SVG path string
+        <https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths>`__ (For correct
+        sizing, custom shape paths should be defined within a square bounding box with
+        coordinates ranging from -1 to 1 along both the x and y dimensions.)
+
+        #.
+        For ``geoshape`` marks it should be a field definition of the geojson data
+
+        **Default value:** If undefined, the default shape depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#point-config>`__ 's ``shape``
+        property. ( ``"circle"`` if unset.)
+    size : dict, :class:`NumericMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumber`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumber`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumber`
+        Size of the mark.
+
+
+        * For ``"point"``, ``"square"`` and ``"circle"``, – the symbol size, or pixel area
+          of the mark.
+        * For ``"bar"`` and ``"tick"`` – the bar and tick's size.
+        * For ``"text"`` – the text's font size.
+        * Size is unsupported for ``"line"``, ``"area"``, and ``"rect"``. (Use ``"trail"``
+          instead of line with varying size)
+    stroke : dict, :class:`ColorDef`, :class:`FieldOrDatumDefWithConditionDatumDefGradientstringnull`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull`
+        Stroke color of the marks. **Default value:** If undefined, the default color
+        depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's ``color``
+        property.
+
+        *Note:* The ``stroke`` encoding has higher precedence than ``color``, thus may
+        override the ``color`` encoding if conflicting encodings are specified.
+    strokeDash : dict, :class:`NumericArrayMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumberArray`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumberArray`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumberArray`
+        Stroke dash of the marks.
+
+        **Default value:** ``[1,0]`` (No dash).
+    strokeOpacity : dict, :class:`NumericMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumber`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumber`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumber`
+        Stroke opacity of the marks.
+
+        **Default value:** If undefined, the default opacity depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's
+        ``strokeOpacity`` property.
+    strokeWidth : dict, :class:`NumericMarkPropDef`, :class:`FieldOrDatumDefWithConditionDatumDefnumber`, :class:`FieldOrDatumDefWithConditionMarkPropFieldDefnumber`, :class:`ValueDefWithConditionMarkPropFieldOrDatumDefnumber`
+        Stroke width of the marks.
+
+        **Default value:** If undefined, the default stroke width depends on `mark config
+        <https://vega.github.io/vega-lite/docs/config.html#mark-config>`__ 's
+        ``strokeWidth`` property.
+    text : dict, :class:`TextDef`, :class:`ValueDefWithConditionStringFieldDefText`, :class:`FieldOrDatumDefWithConditionStringDatumDefText`, :class:`FieldOrDatumDefWithConditionStringFieldDefText`
+        Text of the ``text`` mark.
+    theta : dict, :class:`PolarDef`, :class:`PositionValueDef`, :class:`PositionDatumDefBase`, :class:`PositionFieldDefBase`
+        For arc marks, the arc length in radians if theta2 is not specified, otherwise the
+        start arc angle. (A value of 0 indicates up or “north”, increasing values proceed
+        clockwise.)
+
+        For text marks, polar coordinate angle in radians.
+    theta2 : dict, :class:`DatumDef`, :class:`Position2Def`, :class:`PositionValueDef`, :class:`SecondaryFieldDef`
+        The end angle of arc marks in radians. A value of 0 indicates up or “north”,
+        increasing values proceed clockwise.
+    tooltip : dict, None, :class:`StringFieldDefWithCondition`, :class:`StringValueDefWithCondition`, Sequence[dict, :class:`StringFieldDef`]
+        The tooltip text to show upon mouse hover. Specifying ``tooltip`` encoding overrides
+        `the tooltip property in the mark definition
+        <https://vega.github.io/vega-lite/docs/mark.html#mark-def>`__.
+
+        See the `tooltip <https://vega.github.io/vega-lite/docs/tooltip.html>`__
+        documentation for a detailed discussion about tooltip in Vega-Lite.
+    url : dict, :class:`StringFieldDefWithCondition`, :class:`StringValueDefWithCondition`
+        The URL of an image mark.
+    x : dict, :class:`PositionDef`, :class:`PositionDatumDef`, :class:`PositionFieldDef`, :class:`PositionValueDef`
+        X coordinates of the marks, or width of horizontal ``"bar"`` and ``"area"`` without
+        specified ``x2`` or ``width``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    x2 : dict, :class:`DatumDef`, :class:`Position2Def`, :class:`PositionValueDef`, :class:`SecondaryFieldDef`
+        X2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    xError : dict, :class:`ValueDefnumber`, :class:`SecondaryFieldDef`
+        Error value of x coordinates for error specified ``"errorbar"`` and ``"errorband"``.
+    xError2 : dict, :class:`ValueDefnumber`, :class:`SecondaryFieldDef`
+        Secondary error value of x coordinates for error specified ``"errorbar"`` and
+        ``"errorband"``.
+    xOffset : dict, :class:`OffsetDef`, :class:`ScaleDatumDef`, :class:`ScaleFieldDef`, :class:`ValueDefnumber`
+        Offset of x-position of the marks
+    y : dict, :class:`PositionDef`, :class:`PositionDatumDef`, :class:`PositionFieldDef`, :class:`PositionValueDef`
+        Y coordinates of the marks, or height of vertical ``"bar"`` and ``"area"`` without
+        specified ``y2`` or ``height``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    y2 : dict, :class:`DatumDef`, :class:`Position2Def`, :class:`PositionValueDef`, :class:`SecondaryFieldDef`
+        Y2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    yError : dict, :class:`ValueDefnumber`, :class:`SecondaryFieldDef`
+        Error value of y coordinates for error specified ``"errorbar"`` and ``"errorband"``.
+    yError2 : dict, :class:`ValueDefnumber`, :class:`SecondaryFieldDef`
+        Secondary error value of y coordinates for error specified ``"errorbar"`` and
+        ``"errorband"``.
+    yOffset : dict, :class:`OffsetDef`, :class:`ScaleDatumDef`, :class:`ScaleFieldDef`, :class:`ValueDefnumber`
+        Offset of y-position of the marks
+    """
+
+    _schema = {"$ref": "#/definitions/FacetedEncoding"}
+
+    def __init__(
+        self,
+        angle: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        color: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        column: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        detail: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        facet: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        fill: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        fillOpacity: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        href: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        key: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        latitude: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        latitude2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        longitude: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        longitude2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        opacity: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        order: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        radius: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        radius2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        row: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        shape: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        size: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        stroke: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        strokeDash: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        strokeOpacity: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        strokeWidth: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        text: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        theta: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        theta2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        tooltip: Union[
+            dict, None, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        url: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        x: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        x2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        xError: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        xError2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        xOffset: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        y: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        y2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        yError: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        yError2: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        yOffset: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(FacetedEncoding, self).__init__(
+            angle=angle,
+            color=color,
+            column=column,
+            description=description,
+            detail=detail,
+            facet=facet,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            href=href,
+            key=key,
+            latitude=latitude,
+            latitude2=latitude2,
+            longitude=longitude,
+            longitude2=longitude2,
+            opacity=opacity,
+            order=order,
+            radius=radius,
+            radius2=radius2,
+            row=row,
+            shape=shape,
+            size=size,
+            stroke=stroke,
+            strokeDash=strokeDash,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            tooltip=tooltip,
+            url=url,
+            x=x,
+            x2=x2,
+            xError=xError,
+            xError2=xError2,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            yError=yError,
+            yError2=yError2,
+            yOffset=yOffset,
+            **kwds,
+        )
+
+
+class Feature(VegaLiteSchema):
+    """Feature schema wrapper
+    A feature object which contains a geometry and associated properties.
+    https://tools.ietf.org/html/rfc7946#section-3.2
+
+    Parameters
+    ----------
+
+    geometry : dict, :class:`Point`, :class:`Polygon`, :class:`Geometry`, :class:`LineString`, :class:`MultiPoint`, :class:`MultiPolygon`, :class:`MultiLineString`, :class:`GeometryCollection`
+        The feature's geometry
+    properties : dict, None, :class:`GeoJsonProperties`
+        Properties associated with this feature.
+    type : str
+        Specifies the type of GeoJSON object.
+    bbox : :class:`BBox`, Sequence[float]
+        Bounding box of the coordinate range of the object's Geometries, Features, or
+        Feature Collections. https://tools.ietf.org/html/rfc7946#section-5
+    id : str, float
+        A value that uniquely identifies this feature in a
+        https://tools.ietf.org/html/rfc7946#section-3.2.
+    """
+
+    _schema = {"$ref": "#/definitions/Feature"}
+
+    def __init__(
+        self,
+        geometry: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        properties: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        bbox: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        id: Union[str, float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(Feature, self).__init__(
+            geometry=geometry,
+            properties=properties,
+            type=type,
+            bbox=bbox,
+            id=id,
+            **kwds,
+        )
+
+
+class FeatureCollection(VegaLiteSchema):
+    """FeatureCollection schema wrapper
+    A collection of feature objects.  https://tools.ietf.org/html/rfc7946#section-3.3
+
+    Parameters
+    ----------
+
+    features : Sequence[dict, :class:`FeatureGeometryGeoJsonProperties`]
+
+    type : str
+        Specifies the type of GeoJSON object.
+    bbox : :class:`BBox`, Sequence[float]
+        Bounding box of the coordinate range of the object's Geometries, Features, or
+        Feature Collections. https://tools.ietf.org/html/rfc7946#section-5
+    """
+
+    _schema = {"$ref": "#/definitions/FeatureCollection"}
+
+    def __init__(
+        self,
+        features: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        bbox: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(FeatureCollection, self).__init__(
+            features=features, type=type, bbox=bbox, **kwds
+        )
+
+
+class FeatureGeometryGeoJsonProperties(VegaLiteSchema):
+    """FeatureGeometryGeoJsonProperties schema wrapper
+    A feature object which contains a geometry and associated properties.
+    https://tools.ietf.org/html/rfc7946#section-3.2
+
+    Parameters
+    ----------
+
+    geometry : dict, :class:`Point`, :class:`Polygon`, :class:`Geometry`, :class:`LineString`, :class:`MultiPoint`, :class:`MultiPolygon`, :class:`MultiLineString`, :class:`GeometryCollection`
+        The feature's geometry
+    properties : dict, None, :class:`GeoJsonProperties`
+        Properties associated with this feature.
+    type : str
+        Specifies the type of GeoJSON object.
+    bbox : :class:`BBox`, Sequence[float]
+        Bounding box of the coordinate range of the object's Geometries, Features, or
+        Feature Collections. https://tools.ietf.org/html/rfc7946#section-5
+    id : str, float
+        A value that uniquely identifies this feature in a
+        https://tools.ietf.org/html/rfc7946#section-3.2.
+    """
+
+    _schema = {"$ref": "#/definitions/Feature<Geometry,GeoJsonProperties>"}
+
+    def __init__(
+        self,
+        geometry: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        properties: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        bbox: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        id: Union[str, float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(FeatureGeometryGeoJsonProperties, self).__init__(
+            geometry=geometry,
+            properties=properties,
+            type=type,
+            bbox=bbox,
+            id=id,
+            **kwds,
+        )
+
+
+class Field(VegaLiteSchema):
+    """Field schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Field"}
+
+    def __init__(self, *args, **kwds):
+        super(Field, self).__init__(*args, **kwds)
+
+
+class FieldDefWithoutScale(VegaLiteSchema):
+    """FieldDefWithoutScale schema wrapper
+    Definition object for a data field, its type and transformation of an encoding channel.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/FieldDefWithoutScale"}
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldDefWithoutScale, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class FieldName(Field):
+    """FieldName schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/FieldName"}
+
+    def __init__(self, *args):
+        super(FieldName, self).__init__(*args)
+
+
+class FieldOrDatumDefWithConditionStringFieldDefstring(VegaLiteSchema):
+    """FieldOrDatumDefWithConditionStringFieldDefstring schema wrapper
+
+    Parameters
+    ----------
+
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefstringExprRef`, :class:`ConditionalParameterValueDefstringExprRef`, :class:`ConditionalPredicateValueDefstringExprRef`, Sequence[dict, :class:`ConditionalValueDefstringExprRef`, :class:`ConditionalParameterValueDefstringExprRef`, :class:`ConditionalPredicateValueDefstringExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {
+        "$ref": "#/definitions/FieldOrDatumDefWithCondition<StringFieldDef,string>"
+    }
+
+    def __init__(
+        self,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        format: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldOrDatumDefWithConditionStringFieldDefstring, self).__init__(
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            format=format,
+            formatType=formatType,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class FieldRange(VegaLiteSchema):
+    """FieldRange schema wrapper
+
+    Parameters
+    ----------
+
+    field : str
+
+    """
+
+    _schema = {"$ref": "#/definitions/FieldRange"}
+
+    def __init__(self, field: Union[str, UndefinedType] = Undefined, **kwds):
+        super(FieldRange, self).__init__(field=field, **kwds)
+
+
+class Fit(VegaLiteSchema):
+    """Fit schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Fit"}
+
+    def __init__(self, *args, **kwds):
+        super(Fit, self).__init__(*args, **kwds)
+
+
+class FontStyle(VegaLiteSchema):
+    """FontStyle schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/FontStyle"}
+
+    def __init__(self, *args):
+        super(FontStyle, self).__init__(*args)
+
+
+class FontWeight(VegaLiteSchema):
+    """FontWeight schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/FontWeight"}
+
+    def __init__(self, *args):
+        super(FontWeight, self).__init__(*args)
+
+
+class FormatConfig(VegaLiteSchema):
+    """FormatConfig schema wrapper
+
+    Parameters
+    ----------
+
+    normalizedNumberFormat : str
+        If normalizedNumberFormatType is not specified, D3 number format for axis labels,
+        text marks, and tooltips of normalized stacked fields (fields with ``stack:
+        "normalize"`` ). For example ``"s"`` for SI units. Use `D3's number format pattern
+        <https://github.com/d3/d3-format#locale_format>`__.
+
+        If ``config.normalizedNumberFormatType`` is specified and
+        ``config.customFormatTypes`` is ``true``, this value will be passed as ``format``
+        alongside ``datum.value`` to the ``config.numberFormatType`` function. **Default
+        value:** ``%``
+    normalizedNumberFormatType : str
+        `Custom format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__ for
+        ``config.normalizedNumberFormat``.
+
+        **Default value:** ``undefined`` -- This is equilvalent to call D3-format, which is
+        exposed as `format in Vega-Expression
+        <https://vega.github.io/vega/docs/expressions/#format>`__. **Note:** You must also
+        set ``customFormatTypes`` to ``true`` to use this feature.
+    numberFormat : str
+        If numberFormatType is not specified, D3 number format for guide labels, text marks,
+        and tooltips of non-normalized fields (fields *without* ``stack: "normalize"`` ).
+        For example ``"s"`` for SI units. Use `D3's number format pattern
+        <https://github.com/d3/d3-format#locale_format>`__.
+
+        If ``config.numberFormatType`` is specified and ``config.customFormatTypes`` is
+        ``true``, this value will be passed as ``format`` alongside ``datum.value`` to the
+        ``config.numberFormatType`` function.
+    numberFormatType : str
+        `Custom format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__ for
+        ``config.numberFormat``.
+
+        **Default value:** ``undefined`` -- This is equilvalent to call D3-format, which is
+        exposed as `format in Vega-Expression
+        <https://vega.github.io/vega/docs/expressions/#format>`__. **Note:** You must also
+        set ``customFormatTypes`` to ``true`` to use this feature.
+    timeFormat : str
+        Default time format for raw time values (without time units) in text marks, legend
+        labels and header labels.
+
+        **Default value:** ``"%b %d, %Y"`` **Note:** Axes automatically determine the format
+        for each label automatically so this config does not affect axes.
+    timeFormatType : str
+        `Custom format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__ for
+        ``config.timeFormat``.
+
+        **Default value:** ``undefined`` -- This is equilvalent to call D3-time-format,
+        which is exposed as `timeFormat in Vega-Expression
+        <https://vega.github.io/vega/docs/expressions/#timeFormat>`__. **Note:** You must
+        also set ``customFormatTypes`` to ``true`` and there must *not* be a ``timeUnit``
+        defined to use this feature.
+    """
+
+    _schema = {"$ref": "#/definitions/FormatConfig"}
+
+    def __init__(
+        self,
+        normalizedNumberFormat: Union[str, UndefinedType] = Undefined,
+        normalizedNumberFormatType: Union[str, UndefinedType] = Undefined,
+        numberFormat: Union[str, UndefinedType] = Undefined,
+        numberFormatType: Union[str, UndefinedType] = Undefined,
+        timeFormat: Union[str, UndefinedType] = Undefined,
+        timeFormatType: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(FormatConfig, self).__init__(
+            normalizedNumberFormat=normalizedNumberFormat,
+            normalizedNumberFormatType=normalizedNumberFormatType,
+            numberFormat=numberFormat,
+            numberFormatType=numberFormatType,
+            timeFormat=timeFormat,
+            timeFormatType=timeFormatType,
+            **kwds,
+        )
+
+
+class Generator(Data):
+    """Generator schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Generator"}
+
+    def __init__(self, *args, **kwds):
+        super(Generator, self).__init__(*args, **kwds)
+
+
+class GenericUnitSpecEncodingAnyMark(VegaLiteSchema):
+    """GenericUnitSpecEncodingAnyMark schema wrapper
+    Base interface for a unit (single-view) specification.
+
+    Parameters
+    ----------
+
+    mark : str, dict, :class:`Mark`, :class:`AnyMark`, :class:`BoxPlot`, :class:`MarkDef`, :class:`ErrorBar`, :class:`ErrorBand`, :class:`BoxPlotDef`, :class:`ErrorBarDef`, :class:`ErrorBandDef`, :class:`CompositeMark`, :class:`CompositeMarkDef`, Literal['arc', 'area', 'bar', 'image', 'line', 'point', 'rect', 'rule', 'text', 'tick', 'trail', 'circle', 'square', 'geoshape']
+        A string describing the mark type (one of ``"bar"``, ``"circle"``, ``"square"``,
+        ``"tick"``, ``"line"``, ``"area"``, ``"point"``, ``"rule"``, ``"geoshape"``, and
+        ``"text"`` ) or a `mark definition object
+        <https://vega.github.io/vega-lite/docs/mark.html#mark-def>`__.
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    description : str
+        Description of this mark for commenting purpose.
+    encoding : dict, :class:`Encoding`
+        A key-value mapping between encoding channels and definition of fields.
+    name : str
+        Name of the visualization for later reference.
+    params : Sequence[dict, :class:`SelectionParameter`]
+        An array of parameters that may either be simple variables, or more complex
+        selections that map user input to data queries.
+    projection : dict, :class:`Projection`
+        An object defining properties of geographic projection, which will be applied to
+        ``shape`` path for ``"geoshape"`` marks and to ``latitude`` and ``"longitude"``
+        channels for other marks.
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    """
+
+    _schema = {"$ref": "#/definitions/GenericUnitSpec<Encoding,AnyMark>"}
+
+    def __init__(
+        self,
+        mark: Union[
+            str,
+            dict,
+            "SchemaBase",
+            Literal[
+                "arc",
+                "area",
+                "bar",
+                "image",
+                "line",
+                "point",
+                "rect",
+                "rule",
+                "text",
+                "tick",
+                "trail",
+                "circle",
+                "square",
+                "geoshape",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        encoding: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        params: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        projection: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(GenericUnitSpecEncodingAnyMark, self).__init__(
+            mark=mark,
+            data=data,
+            description=description,
+            encoding=encoding,
+            name=name,
+            params=params,
+            projection=projection,
+            title=title,
+            transform=transform,
+            **kwds,
+        )
+
+
+class GeoJsonFeature(Fit):
+    """GeoJsonFeature schema wrapper
+    A feature object which contains a geometry and associated properties.
+    https://tools.ietf.org/html/rfc7946#section-3.2
+
+    Parameters
+    ----------
+
+    geometry : dict, :class:`Point`, :class:`Polygon`, :class:`Geometry`, :class:`LineString`, :class:`MultiPoint`, :class:`MultiPolygon`, :class:`MultiLineString`, :class:`GeometryCollection`
+        The feature's geometry
+    properties : dict, None, :class:`GeoJsonProperties`
+        Properties associated with this feature.
+    type : str
+        Specifies the type of GeoJSON object.
+    bbox : :class:`BBox`, Sequence[float]
+        Bounding box of the coordinate range of the object's Geometries, Features, or
+        Feature Collections. https://tools.ietf.org/html/rfc7946#section-5
+    id : str, float
+        A value that uniquely identifies this feature in a
+        https://tools.ietf.org/html/rfc7946#section-3.2.
+    """
+
+    _schema = {"$ref": "#/definitions/GeoJsonFeature"}
+
+    def __init__(
+        self,
+        geometry: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        properties: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        bbox: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        id: Union[str, float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(GeoJsonFeature, self).__init__(
+            geometry=geometry,
+            properties=properties,
+            type=type,
+            bbox=bbox,
+            id=id,
+            **kwds,
+        )
+
+
+class GeoJsonFeatureCollection(Fit):
+    """GeoJsonFeatureCollection schema wrapper
+    A collection of feature objects.  https://tools.ietf.org/html/rfc7946#section-3.3
+
+    Parameters
+    ----------
+
+    features : Sequence[dict, :class:`FeatureGeometryGeoJsonProperties`]
+
+    type : str
+        Specifies the type of GeoJSON object.
+    bbox : :class:`BBox`, Sequence[float]
+        Bounding box of the coordinate range of the object's Geometries, Features, or
+        Feature Collections. https://tools.ietf.org/html/rfc7946#section-5
+    """
+
+    _schema = {"$ref": "#/definitions/GeoJsonFeatureCollection"}
+
+    def __init__(
+        self,
+        features: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        bbox: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(GeoJsonFeatureCollection, self).__init__(
+            features=features, type=type, bbox=bbox, **kwds
+        )
+
+
+class GeoJsonProperties(VegaLiteSchema):
+    """GeoJsonProperties schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/GeoJsonProperties"}
+
+    def __init__(self, *args, **kwds):
+        super(GeoJsonProperties, self).__init__(*args, **kwds)
+
+
+class Geometry(VegaLiteSchema):
+    """Geometry schema wrapper
+    Union of geometry objects. https://tools.ietf.org/html/rfc7946#section-3
+    """
+
+    _schema = {"$ref": "#/definitions/Geometry"}
+
+    def __init__(self, *args, **kwds):
+        super(Geometry, self).__init__(*args, **kwds)
+
+
+class GeometryCollection(Geometry):
+    """GeometryCollection schema wrapper
+    Geometry Collection https://tools.ietf.org/html/rfc7946#section-3.1.8
+
+    Parameters
+    ----------
+
+    geometries : Sequence[dict, :class:`Point`, :class:`Polygon`, :class:`Geometry`, :class:`LineString`, :class:`MultiPoint`, :class:`MultiPolygon`, :class:`MultiLineString`, :class:`GeometryCollection`]
+
+    type : str
+        Specifies the type of GeoJSON object.
+    bbox : :class:`BBox`, Sequence[float]
+        Bounding box of the coordinate range of the object's Geometries, Features, or
+        Feature Collections. https://tools.ietf.org/html/rfc7946#section-5
+    """
+
+    _schema = {"$ref": "#/definitions/GeometryCollection"}
+
+    def __init__(
+        self,
+        geometries: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        bbox: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(GeometryCollection, self).__init__(
+            geometries=geometries, type=type, bbox=bbox, **kwds
+        )
+
+
+class Gradient(VegaLiteSchema):
+    """Gradient schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Gradient"}
+
+    def __init__(self, *args, **kwds):
+        super(Gradient, self).__init__(*args, **kwds)
+
+
+class GradientStop(VegaLiteSchema):
+    """GradientStop schema wrapper
+
+    Parameters
+    ----------
+
+    color : str, :class:`Color`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color value at this point in the gradient.
+    offset : float
+        The offset fraction for the color stop, indicating its position within the gradient.
+    """
+
+    _schema = {"$ref": "#/definitions/GradientStop"}
+
+    def __init__(
+        self,
+        color: Union[
+            str,
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        offset: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(GradientStop, self).__init__(color=color, offset=offset, **kwds)
+
+
+class GraticuleGenerator(Generator):
+    """GraticuleGenerator schema wrapper
+
+    Parameters
+    ----------
+
+    graticule : bool, dict, :class:`GraticuleParams`
+        Generate graticule GeoJSON data for geographic reference lines.
+    name : str
+        Provide a placeholder name and bind data at runtime.
+    """
+
+    _schema = {"$ref": "#/definitions/GraticuleGenerator"}
+
+    def __init__(
+        self,
+        graticule: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(GraticuleGenerator, self).__init__(graticule=graticule, name=name, **kwds)
+
+
+class GraticuleParams(VegaLiteSchema):
+    """GraticuleParams schema wrapper
+
+    Parameters
+    ----------
+
+    extent : :class:`Vector2Vector2number`, Sequence[Sequence[float], :class:`Vector2number`]
+        Sets both the major and minor extents to the same values.
+    extentMajor : :class:`Vector2Vector2number`, Sequence[Sequence[float], :class:`Vector2number`]
+        The major extent of the graticule as a two-element array of coordinates.
+    extentMinor : :class:`Vector2Vector2number`, Sequence[Sequence[float], :class:`Vector2number`]
+        The minor extent of the graticule as a two-element array of coordinates.
+    precision : float
+        The precision of the graticule in degrees.
+
+        **Default value:** ``2.5``
+    step : Sequence[float], :class:`Vector2number`
+        Sets both the major and minor step angles to the same values.
+    stepMajor : Sequence[float], :class:`Vector2number`
+        The major step angles of the graticule.
+
+        **Default value:** ``[90, 360]``
+    stepMinor : Sequence[float], :class:`Vector2number`
+        The minor step angles of the graticule.
+
+        **Default value:** ``[10, 10]``
+    """
+
+    _schema = {"$ref": "#/definitions/GraticuleParams"}
+
+    def __init__(
+        self,
+        extent: Union[
+            "SchemaBase", Sequence[Union["SchemaBase", Sequence[float]]], UndefinedType
+        ] = Undefined,
+        extentMajor: Union[
+            "SchemaBase", Sequence[Union["SchemaBase", Sequence[float]]], UndefinedType
+        ] = Undefined,
+        extentMinor: Union[
+            "SchemaBase", Sequence[Union["SchemaBase", Sequence[float]]], UndefinedType
+        ] = Undefined,
+        precision: Union[float, UndefinedType] = Undefined,
+        step: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        stepMajor: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        stepMinor: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(GraticuleParams, self).__init__(
+            extent=extent,
+            extentMajor=extentMajor,
+            extentMinor=extentMinor,
+            precision=precision,
+            step=step,
+            stepMajor=stepMajor,
+            stepMinor=stepMinor,
+            **kwds,
+        )
+
+
+class Header(VegaLiteSchema):
+    """Header schema wrapper
+    Headers of row / column channels for faceted plots.
+
+    Parameters
+    ----------
+
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    labelAlign : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        Horizontal text alignment of header labels. One of ``"left"``, ``"center"``, or
+        ``"right"``.
+    labelAnchor : :class:`TitleAnchor`, Literal[None, 'start', 'middle', 'end']
+        The anchor position for placing the labels. One of ``"start"``, ``"middle"``, or
+        ``"end"``. For example, with a label orientation of top these anchor positions map
+        to a left-, center-, or right-aligned label.
+    labelAngle : float
+        The rotation angle of the header labels.
+
+        **Default value:** ``0`` for column header, ``-90`` for row header.
+    labelBaseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        The vertical text baseline for the header labels. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, or ``"line-bottom"``. The
+        ``"line-top"`` and ``"line-bottom"`` values operate similarly to ``"top"`` and
+        ``"bottom"``, but are calculated relative to the ``titleLineHeight`` rather than
+        ``titleFontSize`` alone.
+    labelColor : str, dict, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the header label, can be in hex color code or regular color name.
+    labelExpr : str
+        `Vega expression <https://vega.github.io/vega/docs/expressions/>`__ for customizing
+        labels.
+
+        **Note:** The label text and value can be assessed via the ``label`` and ``value``
+        properties of the header's backing ``datum`` object.
+    labelFont : str, dict, :class:`ExprRef`
+        The font of the header label.
+    labelFontSize : dict, float, :class:`ExprRef`
+        The font size of the header label, in pixels.
+    labelFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style of the header label.
+    labelFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight of the header label.
+    labelLimit : dict, float, :class:`ExprRef`
+        The maximum length of the header label in pixels. The text value will be
+        automatically truncated if the rendered size exceeds the limit.
+
+        **Default value:** ``0``, indicating no limit
+    labelLineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line header labels or title text with ``"line-top"``
+        or ``"line-bottom"`` baseline.
+    labelOrient : :class:`Orient`, Literal['left', 'right', 'top', 'bottom']
+        The orientation of the header label. One of ``"top"``, ``"bottom"``, ``"left"`` or
+        ``"right"``.
+    labelPadding : dict, float, :class:`ExprRef`
+        The padding, in pixel, between facet header's label and the plot.
+
+        **Default value:** ``10``
+    labels : bool
+        A boolean flag indicating if labels should be included as part of the header.
+
+        **Default value:** ``true``.
+    orient : :class:`Orient`, Literal['left', 'right', 'top', 'bottom']
+        Shortcut for setting both labelOrient and titleOrient.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    titleAlign : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        Horizontal text alignment (to the anchor) of header titles.
+    titleAnchor : :class:`TitleAnchor`, Literal[None, 'start', 'middle', 'end']
+        The anchor position for placing the title. One of ``"start"``, ``"middle"``, or
+        ``"end"``. For example, with an orientation of top these anchor positions map to a
+        left-, center-, or right-aligned title.
+    titleAngle : float
+        The rotation angle of the header title.
+
+        **Default value:** ``0``.
+    titleBaseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        The vertical text baseline for the header title. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, or ``"line-bottom"``. The
+        ``"line-top"`` and ``"line-bottom"`` values operate similarly to ``"top"`` and
+        ``"bottom"``, but are calculated relative to the ``titleLineHeight`` rather than
+        ``titleFontSize`` alone.
+
+        **Default value:** ``"middle"``
+    titleColor : str, dict, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Color of the header title, can be in hex color code or regular color name.
+    titleFont : str, dict, :class:`ExprRef`
+        Font of the header title. (e.g., ``"Helvetica Neue"`` ).
+    titleFontSize : dict, float, :class:`ExprRef`
+        Font size of the header title.
+    titleFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style of the header title.
+    titleFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        Font weight of the header title. This can be either a string (e.g ``"bold"``,
+        ``"normal"`` ) or a number ( ``100``, ``200``, ``300``, ..., ``900`` where
+        ``"normal"`` = ``400`` and ``"bold"`` = ``700`` ).
+    titleLimit : dict, float, :class:`ExprRef`
+        The maximum length of the header title in pixels. The text value will be
+        automatically truncated if the rendered size exceeds the limit.
+
+        **Default value:** ``0``, indicating no limit
+    titleLineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line header title text or title text with
+        ``"line-top"`` or ``"line-bottom"`` baseline.
+    titleOrient : :class:`Orient`, Literal['left', 'right', 'top', 'bottom']
+        The orientation of the header title. One of ``"top"``, ``"bottom"``, ``"left"`` or
+        ``"right"``.
+    titlePadding : dict, float, :class:`ExprRef`
+        The padding, in pixel, between facet header's title and the label.
+
+        **Default value:** ``10``
+    """
+
+    _schema = {"$ref": "#/definitions/Header"}
+
+    def __init__(
+        self,
+        format: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        labelAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelAnchor: Union[
+            "SchemaBase", Literal[None, "start", "middle", "end"], UndefinedType
+        ] = Undefined,
+        labelAngle: Union[float, UndefinedType] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelLineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOrient: Union[
+            "SchemaBase", Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labels: Union[bool, UndefinedType] = Undefined,
+        orient: Union[
+            "SchemaBase", Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        titleAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            "SchemaBase", Literal[None, "start", "middle", "end"], UndefinedType
+        ] = Undefined,
+        titleAngle: Union[float, UndefinedType] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            "SchemaBase", Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Header, self).__init__(
+            format=format,
+            formatType=formatType,
+            labelAlign=labelAlign,
+            labelAnchor=labelAnchor,
+            labelAngle=labelAngle,
+            labelBaseline=labelBaseline,
+            labelColor=labelColor,
+            labelExpr=labelExpr,
+            labelFont=labelFont,
+            labelFontSize=labelFontSize,
+            labelFontStyle=labelFontStyle,
+            labelFontWeight=labelFontWeight,
+            labelLimit=labelLimit,
+            labelLineHeight=labelLineHeight,
+            labelOrient=labelOrient,
+            labelPadding=labelPadding,
+            labels=labels,
+            orient=orient,
+            title=title,
+            titleAlign=titleAlign,
+            titleAnchor=titleAnchor,
+            titleAngle=titleAngle,
+            titleBaseline=titleBaseline,
+            titleColor=titleColor,
+            titleFont=titleFont,
+            titleFontSize=titleFontSize,
+            titleFontStyle=titleFontStyle,
+            titleFontWeight=titleFontWeight,
+            titleLimit=titleLimit,
+            titleLineHeight=titleLineHeight,
+            titleOrient=titleOrient,
+            titlePadding=titlePadding,
+            **kwds,
+        )
+
+
+class HeaderConfig(VegaLiteSchema):
+    """HeaderConfig schema wrapper
+
+    Parameters
+    ----------
+
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    labelAlign : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        Horizontal text alignment of header labels. One of ``"left"``, ``"center"``, or
+        ``"right"``.
+    labelAnchor : :class:`TitleAnchor`, Literal[None, 'start', 'middle', 'end']
+        The anchor position for placing the labels. One of ``"start"``, ``"middle"``, or
+        ``"end"``. For example, with a label orientation of top these anchor positions map
+        to a left-, center-, or right-aligned label.
+    labelAngle : float
+        The rotation angle of the header labels.
+
+        **Default value:** ``0`` for column header, ``-90`` for row header.
+    labelBaseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        The vertical text baseline for the header labels. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, or ``"line-bottom"``. The
+        ``"line-top"`` and ``"line-bottom"`` values operate similarly to ``"top"`` and
+        ``"bottom"``, but are calculated relative to the ``titleLineHeight`` rather than
+        ``titleFontSize`` alone.
+    labelColor : str, dict, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the header label, can be in hex color code or regular color name.
+    labelExpr : str
+        `Vega expression <https://vega.github.io/vega/docs/expressions/>`__ for customizing
+        labels.
+
+        **Note:** The label text and value can be assessed via the ``label`` and ``value``
+        properties of the header's backing ``datum`` object.
+    labelFont : str, dict, :class:`ExprRef`
+        The font of the header label.
+    labelFontSize : dict, float, :class:`ExprRef`
+        The font size of the header label, in pixels.
+    labelFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style of the header label.
+    labelFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight of the header label.
+    labelLimit : dict, float, :class:`ExprRef`
+        The maximum length of the header label in pixels. The text value will be
+        automatically truncated if the rendered size exceeds the limit.
+
+        **Default value:** ``0``, indicating no limit
+    labelLineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line header labels or title text with ``"line-top"``
+        or ``"line-bottom"`` baseline.
+    labelOrient : :class:`Orient`, Literal['left', 'right', 'top', 'bottom']
+        The orientation of the header label. One of ``"top"``, ``"bottom"``, ``"left"`` or
+        ``"right"``.
+    labelPadding : dict, float, :class:`ExprRef`
+        The padding, in pixel, between facet header's label and the plot.
+
+        **Default value:** ``10``
+    labels : bool
+        A boolean flag indicating if labels should be included as part of the header.
+
+        **Default value:** ``true``.
+    orient : :class:`Orient`, Literal['left', 'right', 'top', 'bottom']
+        Shortcut for setting both labelOrient and titleOrient.
+    title : None
+        Set to null to disable title for the axis, legend, or header.
+    titleAlign : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        Horizontal text alignment (to the anchor) of header titles.
+    titleAnchor : :class:`TitleAnchor`, Literal[None, 'start', 'middle', 'end']
+        The anchor position for placing the title. One of ``"start"``, ``"middle"``, or
+        ``"end"``. For example, with an orientation of top these anchor positions map to a
+        left-, center-, or right-aligned title.
+    titleAngle : float
+        The rotation angle of the header title.
+
+        **Default value:** ``0``.
+    titleBaseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        The vertical text baseline for the header title. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, or ``"line-bottom"``. The
+        ``"line-top"`` and ``"line-bottom"`` values operate similarly to ``"top"`` and
+        ``"bottom"``, but are calculated relative to the ``titleLineHeight`` rather than
+        ``titleFontSize`` alone.
+
+        **Default value:** ``"middle"``
+    titleColor : str, dict, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Color of the header title, can be in hex color code or regular color name.
+    titleFont : str, dict, :class:`ExprRef`
+        Font of the header title. (e.g., ``"Helvetica Neue"`` ).
+    titleFontSize : dict, float, :class:`ExprRef`
+        Font size of the header title.
+    titleFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style of the header title.
+    titleFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        Font weight of the header title. This can be either a string (e.g ``"bold"``,
+        ``"normal"`` ) or a number ( ``100``, ``200``, ``300``, ..., ``900`` where
+        ``"normal"`` = ``400`` and ``"bold"`` = ``700`` ).
+    titleLimit : dict, float, :class:`ExprRef`
+        The maximum length of the header title in pixels. The text value will be
+        automatically truncated if the rendered size exceeds the limit.
+
+        **Default value:** ``0``, indicating no limit
+    titleLineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line header title text or title text with
+        ``"line-top"`` or ``"line-bottom"`` baseline.
+    titleOrient : :class:`Orient`, Literal['left', 'right', 'top', 'bottom']
+        The orientation of the header title. One of ``"top"``, ``"bottom"``, ``"left"`` or
+        ``"right"``.
+    titlePadding : dict, float, :class:`ExprRef`
+        The padding, in pixel, between facet header's title and the label.
+
+        **Default value:** ``10``
+    """
+
+    _schema = {"$ref": "#/definitions/HeaderConfig"}
+
+    def __init__(
+        self,
+        format: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        labelAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelAnchor: Union[
+            "SchemaBase", Literal[None, "start", "middle", "end"], UndefinedType
+        ] = Undefined,
+        labelAngle: Union[float, UndefinedType] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelLineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOrient: Union[
+            "SchemaBase", Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labels: Union[bool, UndefinedType] = Undefined,
+        orient: Union[
+            "SchemaBase", Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        title: Union[None, UndefinedType] = Undefined,
+        titleAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            "SchemaBase", Literal[None, "start", "middle", "end"], UndefinedType
+        ] = Undefined,
+        titleAngle: Union[float, UndefinedType] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            "SchemaBase", Literal["left", "right", "top", "bottom"], UndefinedType
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(HeaderConfig, self).__init__(
+            format=format,
+            formatType=formatType,
+            labelAlign=labelAlign,
+            labelAnchor=labelAnchor,
+            labelAngle=labelAngle,
+            labelBaseline=labelBaseline,
+            labelColor=labelColor,
+            labelExpr=labelExpr,
+            labelFont=labelFont,
+            labelFontSize=labelFontSize,
+            labelFontStyle=labelFontStyle,
+            labelFontWeight=labelFontWeight,
+            labelLimit=labelLimit,
+            labelLineHeight=labelLineHeight,
+            labelOrient=labelOrient,
+            labelPadding=labelPadding,
+            labels=labels,
+            orient=orient,
+            title=title,
+            titleAlign=titleAlign,
+            titleAnchor=titleAnchor,
+            titleAngle=titleAngle,
+            titleBaseline=titleBaseline,
+            titleColor=titleColor,
+            titleFont=titleFont,
+            titleFontSize=titleFontSize,
+            titleFontStyle=titleFontStyle,
+            titleFontWeight=titleFontWeight,
+            titleLimit=titleLimit,
+            titleLineHeight=titleLineHeight,
+            titleOrient=titleOrient,
+            titlePadding=titlePadding,
+            **kwds,
+        )
+
+
+class HexColor(Color):
+    """HexColor schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/HexColor"}
+
+    def __init__(self, *args):
+        super(HexColor, self).__init__(*args)
+
+
+class ImputeMethod(VegaLiteSchema):
+    """ImputeMethod schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ImputeMethod"}
+
+    def __init__(self, *args):
+        super(ImputeMethod, self).__init__(*args)
+
+
+class ImputeParams(VegaLiteSchema):
+    """ImputeParams schema wrapper
+
+    Parameters
+    ----------
+
+    frame : Sequence[None, float]
+        A frame specification as a two-element array used to control the window over which
+        the specified method is applied. The array entries should either be a number
+        indicating the offset from the current data object, or null to indicate unbounded
+        rows preceding or following the current data object. For example, the value ``[-5,
+        5]`` indicates that the window should include five objects preceding and five
+        objects following the current object.
+
+        **Default value:** :  ``[null, null]`` indicating that the window includes all
+        objects.
+    keyvals : dict, Sequence[Any], :class:`ImputeSequence`
+        Defines the key values that should be considered for imputation. An array of key
+        values or an object defining a `number sequence
+        <https://vega.github.io/vega-lite/docs/impute.html#sequence-def>`__.
+
+        If provided, this will be used in addition to the key values observed within the
+        input data. If not provided, the values will be derived from all unique values of
+        the ``key`` field. For ``impute`` in ``encoding``, the key field is the x-field if
+        the y-field is imputed, or vice versa.
+
+        If there is no impute grouping, this property *must* be specified.
+    method : :class:`ImputeMethod`, Literal['value', 'median', 'max', 'min', 'mean']
+        The imputation method to use for the field value of imputed data objects. One of
+        ``"value"``, ``"mean"``, ``"median"``, ``"max"`` or ``"min"``.
+
+        **Default value:**  ``"value"``
+    value : Any
+        The field value to use when the imputation ``method`` is ``"value"``.
+    """
+
+    _schema = {"$ref": "#/definitions/ImputeParams"}
+
+    def __init__(
+        self,
+        frame: Union[Sequence[Union[None, float]], UndefinedType] = Undefined,
+        keyvals: Union[dict, "SchemaBase", Sequence[Any], UndefinedType] = Undefined,
+        method: Union[
+            "SchemaBase",
+            Literal["value", "median", "max", "min", "mean"],
+            UndefinedType,
+        ] = Undefined,
+        value: Union[Any, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ImputeParams, self).__init__(
+            frame=frame, keyvals=keyvals, method=method, value=value, **kwds
+        )
+
+
+class ImputeSequence(VegaLiteSchema):
+    """ImputeSequence schema wrapper
+
+    Parameters
+    ----------
+
+    stop : float
+        The ending value(exclusive) of the sequence.
+    start : float
+        The starting value of the sequence. **Default value:** ``0``
+    step : float
+        The step value between sequence entries. **Default value:** ``1`` or ``-1`` if
+        ``stop < start``
+    """
+
+    _schema = {"$ref": "#/definitions/ImputeSequence"}
+
+    def __init__(
+        self,
+        stop: Union[float, UndefinedType] = Undefined,
+        start: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ImputeSequence, self).__init__(stop=stop, start=start, step=step, **kwds)
+
+
+class InlineData(DataSource):
+    """InlineData schema wrapper
+
+    Parameters
+    ----------
+
+    values : str, dict, Sequence[str], Sequence[bool], Sequence[dict], Sequence[float], :class:`InlineDataset`
+        The full data set, included inline. This can be an array of objects or primitive
+        values, an object, or a string. Arrays of primitive values are ingested as objects
+        with a ``data`` property. Strings are parsed according to the specified format type.
+    format : dict, :class:`DataFormat`, :class:`CsvDataFormat`, :class:`DsvDataFormat`, :class:`JsonDataFormat`, :class:`TopoDataFormat`
+        An object that specifies the format for parsing the data.
+    name : str
+        Provide a placeholder name and bind data at runtime.
+    """
+
+    _schema = {"$ref": "#/definitions/InlineData"}
+
+    def __init__(
+        self,
+        values: Union[
+            str,
+            dict,
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[dict],
+            Sequence[float],
+            UndefinedType,
+        ] = Undefined,
+        format: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(InlineData, self).__init__(
+            values=values, format=format, name=name, **kwds
+        )
+
+
+class InlineDataset(VegaLiteSchema):
+    """InlineDataset schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/InlineDataset"}
+
+    def __init__(self, *args, **kwds):
+        super(InlineDataset, self).__init__(*args, **kwds)
+
+
+class Interpolate(VegaLiteSchema):
+    """Interpolate schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Interpolate"}
+
+    def __init__(self, *args):
+        super(Interpolate, self).__init__(*args)
+
+
+class IntervalSelectionConfig(VegaLiteSchema):
+    """IntervalSelectionConfig schema wrapper
+
+    Parameters
+    ----------
+
+    type : str
+        Determines the default event processing and data query for the selection. Vega-Lite
+        currently supports two selection types:
+
+
+        * ``"point"`` -- to select multiple discrete data values; the first value is
+          selected on ``click`` and additional values toggled on shift-click.
+        * ``"interval"`` -- to select a continuous range of data values on ``drag``.
+    clear : str, bool, dict, :class:`Stream`, :class:`EventStream`, :class:`MergedStream`, :class:`DerivedStream`
+        Clears the selection, emptying it of all values. This property can be a `Event
+        Stream <https://vega.github.io/vega/docs/event-streams/>`__ or ``false`` to disable
+        clear.
+
+        **Default value:** ``dblclick``.
+
+        **See also:** `clear examples
+        <https://vega.github.io/vega-lite/docs/selection.html#clear>`__ in the
+        documentation.
+    encodings : Sequence[:class:`SingleDefUnitChannel`, Literal['x', 'y', 'xOffset', 'yOffset', 'x2', 'y2', 'longitude', 'latitude', 'longitude2', 'latitude2', 'theta', 'theta2', 'radius', 'radius2', 'color', 'fill', 'stroke', 'opacity', 'fillOpacity', 'strokeOpacity', 'strokeWidth', 'strokeDash', 'size', 'angle', 'shape', 'key', 'text', 'href', 'url', 'description']]
+        An array of encoding channels. The corresponding data field values must match for a
+        data tuple to fall within the selection.
+
+        **See also:** The `projection with encodings and fields section
+        <https://vega.github.io/vega-lite/docs/selection.html#project>`__ in the
+        documentation.
+    fields : Sequence[str, :class:`FieldName`]
+        An array of field names whose values must match for a data tuple to fall within the
+        selection.
+
+        **See also:** The `projection with encodings and fields section
+        <https://vega.github.io/vega-lite/docs/selection.html#project>`__ in the
+        documentation.
+    mark : dict, :class:`BrushConfig`
+        An interval selection also adds a rectangle mark to depict the extents of the
+        interval. The ``mark`` property can be used to customize the appearance of the mark.
+
+        **See also:** `mark examples
+        <https://vega.github.io/vega-lite/docs/selection.html#mark>`__ in the documentation.
+    on : str, dict, :class:`Stream`, :class:`EventStream`, :class:`MergedStream`, :class:`DerivedStream`
+        A `Vega event stream <https://vega.github.io/vega/docs/event-streams/>`__ (object or
+        selector) that triggers the selection. For interval selections, the event stream
+        must specify a `start and end
+        <https://vega.github.io/vega/docs/event-streams/#between-filters>`__.
+
+        **See also:** `on examples
+        <https://vega.github.io/vega-lite/docs/selection.html#on>`__ in the documentation.
+    resolve : :class:`SelectionResolution`, Literal['global', 'union', 'intersect']
+        With layered and multi-view displays, a strategy that determines how selections'
+        data queries are resolved when applied in a filter transform, conditional encoding
+        rule, or scale domain.
+
+        One of:
+
+
+        * ``"global"`` -- only one brush exists for the entire SPLOM. When the user begins
+          to drag, any previous brushes are cleared, and a new one is constructed.
+        * ``"union"`` -- each cell contains its own brush, and points are highlighted if
+          they lie within *any* of these individual brushes.
+        * ``"intersect"`` -- each cell contains its own brush, and points are highlighted
+          only if they fall within *all* of these individual brushes.
+
+        **Default value:** ``global``.
+
+        **See also:** `resolve examples
+        <https://vega.github.io/vega-lite/docs/selection.html#resolve>`__ in the
+        documentation.
+    translate : str, bool
+        When truthy, allows a user to interactively move an interval selection
+        back-and-forth. Can be ``true``, ``false`` (to disable panning), or a `Vega event
+        stream definition <https://vega.github.io/vega/docs/event-streams/>`__ which must
+        include a start and end event to trigger continuous panning. Discrete panning (e.g.,
+        pressing the left/right arrow keys) will be supported in future versions.
+
+        **Default value:** ``true``, which corresponds to ``[pointerdown, window:pointerup]
+        > window:pointermove!``. This default allows users to clicks and drags within an
+        interval selection to reposition it.
+
+        **See also:** `translate examples
+        <https://vega.github.io/vega-lite/docs/selection.html#translate>`__ in the
+        documentation.
+    zoom : str, bool
+        When truthy, allows a user to interactively resize an interval selection. Can be
+        ``true``, ``false`` (to disable zooming), or a `Vega event stream definition
+        <https://vega.github.io/vega/docs/event-streams/>`__. Currently, only ``wheel``
+        events are supported, but custom event streams can still be used to specify filters,
+        debouncing, and throttling. Future versions will expand the set of events that can
+        trigger this transformation.
+
+        **Default value:** ``true``, which corresponds to ``wheel!``. This default allows
+        users to use the mouse wheel to resize an interval selection.
+
+        **See also:** `zoom examples
+        <https://vega.github.io/vega-lite/docs/selection.html#zoom>`__ in the documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/IntervalSelectionConfig"}
+
+    def __init__(
+        self,
+        type: Union[str, UndefinedType] = Undefined,
+        clear: Union[str, bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        encodings: Union[
+            Sequence[
+                Union[
+                    "SchemaBase",
+                    Literal[
+                        "x",
+                        "y",
+                        "xOffset",
+                        "yOffset",
+                        "x2",
+                        "y2",
+                        "longitude",
+                        "latitude",
+                        "longitude2",
+                        "latitude2",
+                        "theta",
+                        "theta2",
+                        "radius",
+                        "radius2",
+                        "color",
+                        "fill",
+                        "stroke",
+                        "opacity",
+                        "fillOpacity",
+                        "strokeOpacity",
+                        "strokeWidth",
+                        "strokeDash",
+                        "size",
+                        "angle",
+                        "shape",
+                        "key",
+                        "text",
+                        "href",
+                        "url",
+                        "description",
+                    ],
+                ]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fields: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        mark: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        on: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        resolve: Union[
+            "SchemaBase", Literal["global", "union", "intersect"], UndefinedType
+        ] = Undefined,
+        translate: Union[str, bool, UndefinedType] = Undefined,
+        zoom: Union[str, bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(IntervalSelectionConfig, self).__init__(
+            type=type,
+            clear=clear,
+            encodings=encodings,
+            fields=fields,
+            mark=mark,
+            on=on,
+            resolve=resolve,
+            translate=translate,
+            zoom=zoom,
+            **kwds,
+        )
+
+
+class IntervalSelectionConfigWithoutType(VegaLiteSchema):
+    """IntervalSelectionConfigWithoutType schema wrapper
+
+    Parameters
+    ----------
+
+    clear : str, bool, dict, :class:`Stream`, :class:`EventStream`, :class:`MergedStream`, :class:`DerivedStream`
+        Clears the selection, emptying it of all values. This property can be a `Event
+        Stream <https://vega.github.io/vega/docs/event-streams/>`__ or ``false`` to disable
+        clear.
+
+        **Default value:** ``dblclick``.
+
+        **See also:** `clear examples
+        <https://vega.github.io/vega-lite/docs/selection.html#clear>`__ in the
+        documentation.
+    encodings : Sequence[:class:`SingleDefUnitChannel`, Literal['x', 'y', 'xOffset', 'yOffset', 'x2', 'y2', 'longitude', 'latitude', 'longitude2', 'latitude2', 'theta', 'theta2', 'radius', 'radius2', 'color', 'fill', 'stroke', 'opacity', 'fillOpacity', 'strokeOpacity', 'strokeWidth', 'strokeDash', 'size', 'angle', 'shape', 'key', 'text', 'href', 'url', 'description']]
+        An array of encoding channels. The corresponding data field values must match for a
+        data tuple to fall within the selection.
+
+        **See also:** The `projection with encodings and fields section
+        <https://vega.github.io/vega-lite/docs/selection.html#project>`__ in the
+        documentation.
+    fields : Sequence[str, :class:`FieldName`]
+        An array of field names whose values must match for a data tuple to fall within the
+        selection.
+
+        **See also:** The `projection with encodings and fields section
+        <https://vega.github.io/vega-lite/docs/selection.html#project>`__ in the
+        documentation.
+    mark : dict, :class:`BrushConfig`
+        An interval selection also adds a rectangle mark to depict the extents of the
+        interval. The ``mark`` property can be used to customize the appearance of the mark.
+
+        **See also:** `mark examples
+        <https://vega.github.io/vega-lite/docs/selection.html#mark>`__ in the documentation.
+    on : str, dict, :class:`Stream`, :class:`EventStream`, :class:`MergedStream`, :class:`DerivedStream`
+        A `Vega event stream <https://vega.github.io/vega/docs/event-streams/>`__ (object or
+        selector) that triggers the selection. For interval selections, the event stream
+        must specify a `start and end
+        <https://vega.github.io/vega/docs/event-streams/#between-filters>`__.
+
+        **See also:** `on examples
+        <https://vega.github.io/vega-lite/docs/selection.html#on>`__ in the documentation.
+    resolve : :class:`SelectionResolution`, Literal['global', 'union', 'intersect']
+        With layered and multi-view displays, a strategy that determines how selections'
+        data queries are resolved when applied in a filter transform, conditional encoding
+        rule, or scale domain.
+
+        One of:
+
+
+        * ``"global"`` -- only one brush exists for the entire SPLOM. When the user begins
+          to drag, any previous brushes are cleared, and a new one is constructed.
+        * ``"union"`` -- each cell contains its own brush, and points are highlighted if
+          they lie within *any* of these individual brushes.
+        * ``"intersect"`` -- each cell contains its own brush, and points are highlighted
+          only if they fall within *all* of these individual brushes.
+
+        **Default value:** ``global``.
+
+        **See also:** `resolve examples
+        <https://vega.github.io/vega-lite/docs/selection.html#resolve>`__ in the
+        documentation.
+    translate : str, bool
+        When truthy, allows a user to interactively move an interval selection
+        back-and-forth. Can be ``true``, ``false`` (to disable panning), or a `Vega event
+        stream definition <https://vega.github.io/vega/docs/event-streams/>`__ which must
+        include a start and end event to trigger continuous panning. Discrete panning (e.g.,
+        pressing the left/right arrow keys) will be supported in future versions.
+
+        **Default value:** ``true``, which corresponds to ``[pointerdown, window:pointerup]
+        > window:pointermove!``. This default allows users to clicks and drags within an
+        interval selection to reposition it.
+
+        **See also:** `translate examples
+        <https://vega.github.io/vega-lite/docs/selection.html#translate>`__ in the
+        documentation.
+    zoom : str, bool
+        When truthy, allows a user to interactively resize an interval selection. Can be
+        ``true``, ``false`` (to disable zooming), or a `Vega event stream definition
+        <https://vega.github.io/vega/docs/event-streams/>`__. Currently, only ``wheel``
+        events are supported, but custom event streams can still be used to specify filters,
+        debouncing, and throttling. Future versions will expand the set of events that can
+        trigger this transformation.
+
+        **Default value:** ``true``, which corresponds to ``wheel!``. This default allows
+        users to use the mouse wheel to resize an interval selection.
+
+        **See also:** `zoom examples
+        <https://vega.github.io/vega-lite/docs/selection.html#zoom>`__ in the documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/IntervalSelectionConfigWithoutType"}
+
+    def __init__(
+        self,
+        clear: Union[str, bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        encodings: Union[
+            Sequence[
+                Union[
+                    "SchemaBase",
+                    Literal[
+                        "x",
+                        "y",
+                        "xOffset",
+                        "yOffset",
+                        "x2",
+                        "y2",
+                        "longitude",
+                        "latitude",
+                        "longitude2",
+                        "latitude2",
+                        "theta",
+                        "theta2",
+                        "radius",
+                        "radius2",
+                        "color",
+                        "fill",
+                        "stroke",
+                        "opacity",
+                        "fillOpacity",
+                        "strokeOpacity",
+                        "strokeWidth",
+                        "strokeDash",
+                        "size",
+                        "angle",
+                        "shape",
+                        "key",
+                        "text",
+                        "href",
+                        "url",
+                        "description",
+                    ],
+                ]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fields: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        mark: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        on: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        resolve: Union[
+            "SchemaBase", Literal["global", "union", "intersect"], UndefinedType
+        ] = Undefined,
+        translate: Union[str, bool, UndefinedType] = Undefined,
+        zoom: Union[str, bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(IntervalSelectionConfigWithoutType, self).__init__(
+            clear=clear,
+            encodings=encodings,
+            fields=fields,
+            mark=mark,
+            on=on,
+            resolve=resolve,
+            translate=translate,
+            zoom=zoom,
+            **kwds,
+        )
+
+
+class JoinAggregateFieldDef(VegaLiteSchema):
+    """JoinAggregateFieldDef schema wrapper
+
+    Parameters
+    ----------
+
+    op : :class:`AggregateOp`, Literal['argmax', 'argmin', 'average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        The aggregation operation to apply (e.g., ``"sum"``, ``"average"`` or ``"count"`` ).
+        See the list of all supported operations `here
+        <https://vega.github.io/vega-lite/docs/aggregate.html#ops>`__.
+    field : str, :class:`FieldName`
+        The data field for which to compute the aggregate function. This can be omitted for
+        functions that do not operate over a field such as ``"count"``.
+    as : str, :class:`FieldName`
+        The output name for the join aggregate operation.
+    """
+
+    _schema = {"$ref": "#/definitions/JoinAggregateFieldDef"}
+
+    def __init__(
+        self,
+        op: Union[
+            "SchemaBase",
+            Literal[
+                "argmax",
+                "argmin",
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(JoinAggregateFieldDef, self).__init__(op=op, field=field, **kwds)
+
+
+class JsonDataFormat(DataFormat):
+    """JsonDataFormat schema wrapper
+
+    Parameters
+    ----------
+
+    parse : dict, None, :class:`Parse`
+        If set to ``null``, disable type inference based on the spec and only use type
+        inference based on the data. Alternatively, a parsing directive object can be
+        provided for explicit data types. Each property of the object corresponds to a field
+        name, and the value to the desired data type (one of ``"number"``, ``"boolean"``,
+        ``"date"``, or null (do not parse the field)). For example, ``"parse":
+        {"modified_on": "date"}`` parses the ``modified_on`` field in each input record a
+        Date value.
+
+        For ``"date"``, we parse data based using JavaScript's `Date.parse()
+        <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse>`__.
+        For Specific date formats can be provided (e.g., ``{foo: "date:'%m%d%Y'"}`` ), using
+        the `d3-time-format syntax <https://github.com/d3/d3-time-format#locale_format>`__.
+        UTC date format parsing is supported similarly (e.g., ``{foo: "utc:'%m%d%Y'"}`` ).
+        See more about `UTC time
+        <https://vega.github.io/vega-lite/docs/timeunit.html#utc>`__
+    property : str
+        The JSON property containing the desired data. This parameter can be used when the
+        loaded JSON file may have surrounding structure or meta-data. For example
+        ``"property": "values.features"`` is equivalent to retrieving
+        ``json.values.features`` from the loaded JSON object.
+    type : str
+        Type of input data: ``"json"``, ``"csv"``, ``"tsv"``, ``"dsv"``.
+
+        **Default value:**  The default format type is determined by the extension of the
+        file URL. If no extension is detected, ``"json"`` will be used by default.
+    """
+
+    _schema = {"$ref": "#/definitions/JsonDataFormat"}
+
+    def __init__(
+        self,
+        parse: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        property: Union[str, UndefinedType] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(JsonDataFormat, self).__init__(
+            parse=parse, property=property, type=type, **kwds
+        )
+
+
+class LabelOverlap(VegaLiteSchema):
+    """LabelOverlap schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/LabelOverlap"}
+
+    def __init__(self, *args, **kwds):
+        super(LabelOverlap, self).__init__(*args, **kwds)
+
+
+class LatLongDef(VegaLiteSchema):
+    """LatLongDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/LatLongDef"}
+
+    def __init__(self, *args, **kwds):
+        super(LatLongDef, self).__init__(*args, **kwds)
+
+
+class LatLongFieldDef(LatLongDef):
+    """LatLongFieldDef schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : str
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/LatLongFieldDef"}
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(LatLongFieldDef, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class LayerRepeatMapping(VegaLiteSchema):
+    """LayerRepeatMapping schema wrapper
+
+    Parameters
+    ----------
+
+    layer : Sequence[str]
+        An array of fields to be repeated as layers.
+    column : Sequence[str]
+        An array of fields to be repeated horizontally.
+    row : Sequence[str]
+        An array of fields to be repeated vertically.
+    """
+
+    _schema = {"$ref": "#/definitions/LayerRepeatMapping"}
+
+    def __init__(
+        self,
+        layer: Union[Sequence[str], UndefinedType] = Undefined,
+        column: Union[Sequence[str], UndefinedType] = Undefined,
+        row: Union[Sequence[str], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(LayerRepeatMapping, self).__init__(
+            layer=layer, column=column, row=row, **kwds
+        )
+
+
+class LayoutAlign(VegaLiteSchema):
+    """LayoutAlign schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/LayoutAlign"}
+
+    def __init__(self, *args):
+        super(LayoutAlign, self).__init__(*args)
+
+
+class Legend(VegaLiteSchema):
+    """Legend schema wrapper
+    Properties of a legend or boolean flag for determining whether to show it.
+
+    Parameters
+    ----------
+
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG group, removing the legend from the ARIA accessibility tree.
+
+        **Default value:** ``true``
+    clipHeight : dict, float, :class:`ExprRef`
+        The height in pixels to clip symbol legend entries and limit their size.
+    columnPadding : dict, float, :class:`ExprRef`
+        The horizontal padding in pixels between symbol legend entries.
+
+        **Default value:** ``10``.
+    columns : dict, float, :class:`ExprRef`
+        The number of columns in which to arrange symbol legend entries. A value of ``0`` or
+        lower indicates a single row with one column per entry.
+    cornerRadius : dict, float, :class:`ExprRef`
+        Corner radius for the full legend.
+    description : str, dict, :class:`ExprRef`
+        A text description of this legend for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If the ``aria`` property is true, for SVG output the `"aria-label" attribute
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>`__
+        will be set to this description. If the description is unspecified it will be
+        automatically generated.
+    direction : :class:`Orientation`, Literal['horizontal', 'vertical']
+        The direction of the legend, one of ``"vertical"`` or ``"horizontal"``.
+
+        **Default value:**
+
+
+        * For top-/bottom- ``orient`` ed legends, ``"horizontal"``
+        * For left-/right- ``orient`` ed legends, ``"vertical"``
+        * For top/bottom-left/right- ``orient`` ed legends, ``"horizontal"`` for gradient
+          legends and ``"vertical"`` for symbol legends.
+    fillColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Background fill color for the full legend.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    gradientLength : dict, float, :class:`ExprRef`
+        The length in pixels of the primary axis of a color gradient. This value corresponds
+        to the height of a vertical gradient or the width of a horizontal gradient.
+
+        **Default value:** ``200``.
+    gradientOpacity : dict, float, :class:`ExprRef`
+        Opacity of the color gradient.
+    gradientStrokeColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the gradient stroke, can be in hex color code or regular color name.
+
+        **Default value:** ``"lightGray"``.
+    gradientStrokeWidth : dict, float, :class:`ExprRef`
+        The width of the gradient stroke, in pixels.
+
+        **Default value:** ``0``.
+    gradientThickness : dict, float, :class:`ExprRef`
+        The thickness in pixels of the color gradient. This value corresponds to the width
+        of a vertical gradient or the height of a horizontal gradient.
+
+        **Default value:** ``16``.
+    gridAlign : dict, :class:`ExprRef`, :class:`LayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to symbol legends rows and columns. The supported string
+        values are ``"all"``, ``"each"`` (the default), and ``none``. For more information,
+        see the `grid layout documentation <https://vega.github.io/vega/docs/layout>`__.
+
+        **Default value:** ``"each"``.
+    labelAlign : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        The alignment of the legend label, can be left, center, or right.
+    labelBaseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        The position of the baseline of legend label, can be ``"top"``, ``"middle"``,
+        ``"bottom"``, or ``"alphabetic"``.
+
+        **Default value:** ``"middle"``.
+    labelColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the legend label, can be in hex color code or regular color name.
+    labelExpr : str
+        `Vega expression <https://vega.github.io/vega/docs/expressions/>`__ for customizing
+        labels.
+
+        **Note:** The label text and value can be assessed via the ``label`` and ``value``
+        properties of the legend's backing ``datum`` object.
+    labelFont : str, dict, :class:`ExprRef`
+        The font of the legend label.
+    labelFontSize : dict, float, :class:`ExprRef`
+        The font size of legend label.
+
+        **Default value:** ``10``.
+    labelFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style of legend label.
+    labelFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight of legend label.
+    labelLimit : dict, float, :class:`ExprRef`
+        Maximum allowed pixel width of legend tick labels.
+
+        **Default value:** ``160``.
+    labelOffset : dict, float, :class:`ExprRef`
+        The offset of the legend label.
+
+        **Default value:** ``4``.
+    labelOpacity : dict, float, :class:`ExprRef`
+        Opacity of labels.
+    labelOverlap : str, bool, dict, :class:`ExprRef`, :class:`LabelOverlap`
+        The strategy to use for resolving overlap of labels in gradient legends. If
+        ``false``, no overlap reduction is attempted. If set to ``true`` (default) or
+        ``"parity"``, a strategy of removing every other label is used. If set to
+        ``"greedy"``, a linear scan of the labels is performed, removing any label that
+        overlaps with the last visible label (this often works better for log-scaled axes).
+
+        **Default value:** ``true``.
+    labelPadding : dict, float, :class:`ExprRef`
+        Padding in pixels between the legend and legend labels.
+    labelSeparation : dict, float, :class:`ExprRef`
+        The minimum separation that must be between label bounding boxes for them to be
+        considered non-overlapping (default ``0`` ). This property is ignored if
+        *labelOverlap* resolution is not enabled.
+    legendX : dict, float, :class:`ExprRef`
+        Custom x-position for legend with orient "none".
+    legendY : dict, float, :class:`ExprRef`
+        Custom y-position for legend with orient "none".
+    offset : dict, float, :class:`ExprRef`
+        The offset in pixels by which to displace the legend from the data rectangle and
+        axes.
+
+        **Default value:** ``18``.
+    orient : :class:`LegendOrient`, Literal['none', 'left', 'right', 'top', 'bottom', 'top-left', 'top-right', 'bottom-left', 'bottom-right']
+        The orientation of the legend, which determines how the legend is positioned within
+        the scene. One of ``"left"``, ``"right"``, ``"top"``, ``"bottom"``, ``"top-left"``,
+        ``"top-right"``, ``"bottom-left"``, ``"bottom-right"``, ``"none"``.
+
+        **Default value:** ``"right"``
+    padding : dict, float, :class:`ExprRef`
+        The padding between the border and content of the legend group.
+
+        **Default value:** ``0``.
+    rowPadding : dict, float, :class:`ExprRef`
+        The vertical padding in pixels between symbol legend entries.
+
+        **Default value:** ``2``.
+    strokeColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Border stroke color for the full legend.
+    symbolDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating [stroke, space] lengths for dashed symbol strokes.
+    symbolDashOffset : dict, float, :class:`ExprRef`
+        The pixel offset at which to start drawing with the symbol stroke dash array.
+    symbolFillColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the legend symbol,
+    symbolLimit : dict, float, :class:`ExprRef`
+        The maximum number of allowed entries for a symbol legend. Additional entries will
+        be dropped.
+    symbolOffset : dict, float, :class:`ExprRef`
+        Horizontal pixel offset for legend symbols.
+
+        **Default value:** ``0``.
+    symbolOpacity : dict, float, :class:`ExprRef`
+        Opacity of the legend symbols.
+    symbolSize : dict, float, :class:`ExprRef`
+        The size of the legend symbol, in pixels.
+
+        **Default value:** ``100``.
+    symbolStrokeColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Stroke color for legend symbols.
+    symbolStrokeWidth : dict, float, :class:`ExprRef`
+        The width of the symbol's stroke.
+
+        **Default value:** ``1.5``.
+    symbolType : str, dict, :class:`ExprRef`, :class:`SymbolShape`
+        The symbol shape. One of the plotting shapes ``circle`` (default), ``square``,
+        ``cross``, ``diamond``, ``triangle-up``, ``triangle-down``, ``triangle-right``, or
+        ``triangle-left``, the line symbol ``stroke``, or one of the centered directional
+        shapes ``arrow``, ``wedge``, or ``triangle``. Alternatively, a custom `SVG path
+        string <https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths>`__ can be
+        provided. For correct sizing, custom shape paths should be defined within a square
+        bounding box with coordinates ranging from -1 to 1 along both the x and y
+        dimensions.
+
+        **Default value:** ``"circle"``.
+    tickCount : dict, float, :class:`ExprRef`, :class:`TickCount`, :class:`TimeInterval`, :class:`TimeIntervalStep`, Literal['millisecond', 'second', 'minute', 'hour', 'day', 'week', 'month', 'year']
+        The desired number of tick values for quantitative legends.
+    tickMinStep : dict, float, :class:`ExprRef`
+        The minimum desired step between legend ticks, in terms of scale domain values. For
+        example, a value of ``1`` indicates that ticks should not be less than 1 unit apart.
+        If ``tickMinStep`` is specified, the ``tickCount`` value will be adjusted, if
+        necessary, to enforce the minimum step value.
+
+        **Default value** : ``undefined``
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    titleAlign : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        Horizontal text alignment for legend titles.
+
+        **Default value:** ``"left"``.
+    titleAnchor : dict, :class:`ExprRef`, :class:`TitleAnchor`, Literal[None, 'start', 'middle', 'end']
+        Text anchor position for placing legend titles.
+    titleBaseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        Vertical text baseline for legend titles.  One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, or ``"line-bottom"``. The
+        ``"line-top"`` and ``"line-bottom"`` values operate similarly to ``"top"`` and
+        ``"bottom"``, but are calculated relative to the *lineHeight* rather than *fontSize*
+        alone.
+
+        **Default value:** ``"top"``.
+    titleColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the legend title, can be in hex color code or regular color name.
+    titleFont : str, dict, :class:`ExprRef`
+        The font of the legend title.
+    titleFontSize : dict, float, :class:`ExprRef`
+        The font size of the legend title.
+    titleFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style of the legend title.
+    titleFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight of the legend title. This can be either a string (e.g ``"bold"``,
+        ``"normal"`` ) or a number ( ``100``, ``200``, ``300``, ..., ``900`` where
+        ``"normal"`` = ``400`` and ``"bold"`` = ``700`` ).
+    titleLimit : dict, float, :class:`ExprRef`
+        Maximum allowed pixel width of legend titles.
+
+        **Default value:** ``180``.
+    titleLineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line title text or title text with ``"line-top"`` or
+        ``"line-bottom"`` baseline.
+    titleOpacity : dict, float, :class:`ExprRef`
+        Opacity of the legend title.
+    titleOrient : dict, :class:`Orient`, :class:`ExprRef`, Literal['left', 'right', 'top', 'bottom']
+        Orientation of the legend title.
+    titlePadding : dict, float, :class:`ExprRef`
+        The padding, in pixels, between title and legend.
+
+        **Default value:** ``5``.
+    type : Literal['symbol', 'gradient']
+        The type of the legend. Use ``"symbol"`` to create a discrete legend and
+        ``"gradient"`` for a continuous color gradient.
+
+        **Default value:** ``"gradient"`` for non-binned quantitative fields and temporal
+        fields; ``"symbol"`` otherwise.
+    values : dict, Sequence[str], Sequence[bool], Sequence[float], :class:`ExprRef`, Sequence[dict, :class:`DateTime`]
+        Explicitly set the visible legend values.
+    zindex : float
+        A non-negative integer indicating the z-index of the legend. If zindex is 0, legend
+        should be drawn behind all chart elements. To put them in front, use zindex = 1.
+    """
+
+    _schema = {"$ref": "#/definitions/Legend"}
+
+    def __init__(
+        self,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        clipHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        columnPadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        columns: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        direction: Union[
+            "SchemaBase", Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        fillColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        format: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        gradientLength: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gradientOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gradientStrokeColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientStrokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gradientThickness: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gridAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["all", "each", "none"],
+            UndefinedType,
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelExpr: Union[str, UndefinedType] = Undefined,
+        labelFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        legendX: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        legendY: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        orient: Union[
+            "SchemaBase",
+            Literal[
+                "none",
+                "left",
+                "right",
+                "top",
+                "bottom",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        rowPadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        symbolDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        symbolFillColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        symbolOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        symbolOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        symbolSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        symbolStrokeColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolStrokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        symbolType: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        tickMinStep: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        titleAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        type: Union[Literal["symbol", "gradient"], UndefinedType] = Undefined,
+        values: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Sequence[Union[dict, "SchemaBase"]],
+            UndefinedType,
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(Legend, self).__init__(
+            aria=aria,
+            clipHeight=clipHeight,
+            columnPadding=columnPadding,
+            columns=columns,
+            cornerRadius=cornerRadius,
+            description=description,
+            direction=direction,
+            fillColor=fillColor,
+            format=format,
+            formatType=formatType,
+            gradientLength=gradientLength,
+            gradientOpacity=gradientOpacity,
+            gradientStrokeColor=gradientStrokeColor,
+            gradientStrokeWidth=gradientStrokeWidth,
+            gradientThickness=gradientThickness,
+            gridAlign=gridAlign,
+            labelAlign=labelAlign,
+            labelBaseline=labelBaseline,
+            labelColor=labelColor,
+            labelExpr=labelExpr,
+            labelFont=labelFont,
+            labelFontSize=labelFontSize,
+            labelFontStyle=labelFontStyle,
+            labelFontWeight=labelFontWeight,
+            labelLimit=labelLimit,
+            labelOffset=labelOffset,
+            labelOpacity=labelOpacity,
+            labelOverlap=labelOverlap,
+            labelPadding=labelPadding,
+            labelSeparation=labelSeparation,
+            legendX=legendX,
+            legendY=legendY,
+            offset=offset,
+            orient=orient,
+            padding=padding,
+            rowPadding=rowPadding,
+            strokeColor=strokeColor,
+            symbolDash=symbolDash,
+            symbolDashOffset=symbolDashOffset,
+            symbolFillColor=symbolFillColor,
+            symbolLimit=symbolLimit,
+            symbolOffset=symbolOffset,
+            symbolOpacity=symbolOpacity,
+            symbolSize=symbolSize,
+            symbolStrokeColor=symbolStrokeColor,
+            symbolStrokeWidth=symbolStrokeWidth,
+            symbolType=symbolType,
+            tickCount=tickCount,
+            tickMinStep=tickMinStep,
+            title=title,
+            titleAlign=titleAlign,
+            titleAnchor=titleAnchor,
+            titleBaseline=titleBaseline,
+            titleColor=titleColor,
+            titleFont=titleFont,
+            titleFontSize=titleFontSize,
+            titleFontStyle=titleFontStyle,
+            titleFontWeight=titleFontWeight,
+            titleLimit=titleLimit,
+            titleLineHeight=titleLineHeight,
+            titleOpacity=titleOpacity,
+            titleOrient=titleOrient,
+            titlePadding=titlePadding,
+            type=type,
+            values=values,
+            zindex=zindex,
+            **kwds,
+        )
+
+
+class LegendBinding(VegaLiteSchema):
+    """LegendBinding schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/LegendBinding"}
+
+    def __init__(self, *args, **kwds):
+        super(LegendBinding, self).__init__(*args, **kwds)
+
+
+class LegendConfig(VegaLiteSchema):
+    """LegendConfig schema wrapper
+
+    Parameters
+    ----------
+
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG group, removing the legend from the ARIA accessibility tree.
+
+        **Default value:** ``true``
+    clipHeight : dict, float, :class:`ExprRef`
+        The height in pixels to clip symbol legend entries and limit their size.
+    columnPadding : dict, float, :class:`ExprRef`
+        The horizontal padding in pixels between symbol legend entries.
+
+        **Default value:** ``10``.
+    columns : dict, float, :class:`ExprRef`
+        The number of columns in which to arrange symbol legend entries. A value of ``0`` or
+        lower indicates a single row with one column per entry.
+    cornerRadius : dict, float, :class:`ExprRef`
+        Corner radius for the full legend.
+    description : str, dict, :class:`ExprRef`
+        A text description of this legend for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If the ``aria`` property is true, for SVG output the `"aria-label" attribute
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>`__
+        will be set to this description. If the description is unspecified it will be
+        automatically generated.
+    direction : :class:`Orientation`, Literal['horizontal', 'vertical']
+        The direction of the legend, one of ``"vertical"`` or ``"horizontal"``.
+
+        **Default value:**
+
+
+        * For top-/bottom- ``orient`` ed legends, ``"horizontal"``
+        * For left-/right- ``orient`` ed legends, ``"vertical"``
+        * For top/bottom-left/right- ``orient`` ed legends, ``"horizontal"`` for gradient
+          legends and ``"vertical"`` for symbol legends.
+    disable : bool
+        Disable legend by default
+    fillColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Background fill color for the full legend.
+    gradientDirection : dict, :class:`ExprRef`, :class:`Orientation`, Literal['horizontal', 'vertical']
+        The default direction ( ``"horizontal"`` or ``"vertical"`` ) for gradient legends.
+
+        **Default value:** ``"vertical"``.
+    gradientHorizontalMaxLength : float
+        Max legend length for a horizontal gradient when ``config.legend.gradientLength`` is
+        undefined.
+
+        **Default value:** ``200``
+    gradientHorizontalMinLength : float
+        Min legend length for a horizontal gradient when ``config.legend.gradientLength`` is
+        undefined.
+
+        **Default value:** ``100``
+    gradientLabelLimit : dict, float, :class:`ExprRef`
+        The maximum allowed length in pixels of color ramp gradient labels.
+    gradientLabelOffset : dict, float, :class:`ExprRef`
+        Vertical offset in pixels for color ramp gradient labels.
+
+        **Default value:** ``2``.
+    gradientLength : dict, float, :class:`ExprRef`
+        The length in pixels of the primary axis of a color gradient. This value corresponds
+        to the height of a vertical gradient or the width of a horizontal gradient.
+
+        **Default value:** ``200``.
+    gradientOpacity : dict, float, :class:`ExprRef`
+        Opacity of the color gradient.
+    gradientStrokeColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the gradient stroke, can be in hex color code or regular color name.
+
+        **Default value:** ``"lightGray"``.
+    gradientStrokeWidth : dict, float, :class:`ExprRef`
+        The width of the gradient stroke, in pixels.
+
+        **Default value:** ``0``.
+    gradientThickness : dict, float, :class:`ExprRef`
+        The thickness in pixels of the color gradient. This value corresponds to the width
+        of a vertical gradient or the height of a horizontal gradient.
+
+        **Default value:** ``16``.
+    gradientVerticalMaxLength : float
+        Max legend length for a vertical gradient when ``config.legend.gradientLength`` is
+        undefined.
+
+        **Default value:** ``200``
+    gradientVerticalMinLength : float
+        Min legend length for a vertical gradient when ``config.legend.gradientLength`` is
+        undefined.
+
+        **Default value:** ``100``
+    gridAlign : dict, :class:`ExprRef`, :class:`LayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to symbol legends rows and columns. The supported string
+        values are ``"all"``, ``"each"`` (the default), and ``none``. For more information,
+        see the `grid layout documentation <https://vega.github.io/vega/docs/layout>`__.
+
+        **Default value:** ``"each"``.
+    labelAlign : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        The alignment of the legend label, can be left, center, or right.
+    labelBaseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        The position of the baseline of legend label, can be ``"top"``, ``"middle"``,
+        ``"bottom"``, or ``"alphabetic"``.
+
+        **Default value:** ``"middle"``.
+    labelColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the legend label, can be in hex color code or regular color name.
+    labelFont : str, dict, :class:`ExprRef`
+        The font of the legend label.
+    labelFontSize : dict, float, :class:`ExprRef`
+        The font size of legend label.
+
+        **Default value:** ``10``.
+    labelFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style of legend label.
+    labelFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight of legend label.
+    labelLimit : dict, float, :class:`ExprRef`
+        Maximum allowed pixel width of legend tick labels.
+
+        **Default value:** ``160``.
+    labelOffset : dict, float, :class:`ExprRef`
+        The offset of the legend label.
+
+        **Default value:** ``4``.
+    labelOpacity : dict, float, :class:`ExprRef`
+        Opacity of labels.
+    labelOverlap : str, bool, dict, :class:`ExprRef`, :class:`LabelOverlap`
+        The strategy to use for resolving overlap of labels in gradient legends. If
+        ``false``, no overlap reduction is attempted. If set to ``true`` or ``"parity"``, a
+        strategy of removing every other label is used. If set to ``"greedy"``, a linear
+        scan of the labels is performed, removing any label that overlaps with the last
+        visible label (this often works better for log-scaled axes).
+
+        **Default value:** ``"greedy"`` for ``log scales otherwise`` true`.
+    labelPadding : dict, float, :class:`ExprRef`
+        Padding in pixels between the legend and legend labels.
+    labelSeparation : dict, float, :class:`ExprRef`
+        The minimum separation that must be between label bounding boxes for them to be
+        considered non-overlapping (default ``0`` ). This property is ignored if
+        *labelOverlap* resolution is not enabled.
+    layout : dict, :class:`ExprRef`
+
+    legendX : dict, float, :class:`ExprRef`
+        Custom x-position for legend with orient "none".
+    legendY : dict, float, :class:`ExprRef`
+        Custom y-position for legend with orient "none".
+    offset : dict, float, :class:`ExprRef`
+        The offset in pixels by which to displace the legend from the data rectangle and
+        axes.
+
+        **Default value:** ``18``.
+    orient : :class:`LegendOrient`, Literal['none', 'left', 'right', 'top', 'bottom', 'top-left', 'top-right', 'bottom-left', 'bottom-right']
+        The orientation of the legend, which determines how the legend is positioned within
+        the scene. One of ``"left"``, ``"right"``, ``"top"``, ``"bottom"``, ``"top-left"``,
+        ``"top-right"``, ``"bottom-left"``, ``"bottom-right"``, ``"none"``.
+
+        **Default value:** ``"right"``
+    padding : dict, float, :class:`ExprRef`
+        The padding between the border and content of the legend group.
+
+        **Default value:** ``0``.
+    rowPadding : dict, float, :class:`ExprRef`
+        The vertical padding in pixels between symbol legend entries.
+
+        **Default value:** ``2``.
+    strokeColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Border stroke color for the full legend.
+    strokeDash : dict, Sequence[float], :class:`ExprRef`
+        Border stroke dash pattern for the full legend.
+    strokeWidth : dict, float, :class:`ExprRef`
+        Border stroke width for the full legend.
+    symbolBaseFillColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default fill color for legend symbols. Only applied if there is no ``"fill"`` scale
+        color encoding for the legend.
+
+        **Default value:** ``"transparent"``.
+    symbolBaseStrokeColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default stroke color for legend symbols. Only applied if there is no ``"fill"``
+        scale color encoding for the legend.
+
+        **Default value:** ``"gray"``.
+    symbolDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating [stroke, space] lengths for dashed symbol strokes.
+    symbolDashOffset : dict, float, :class:`ExprRef`
+        The pixel offset at which to start drawing with the symbol stroke dash array.
+    symbolDirection : dict, :class:`ExprRef`, :class:`Orientation`, Literal['horizontal', 'vertical']
+        The default direction ( ``"horizontal"`` or ``"vertical"`` ) for symbol legends.
+
+        **Default value:** ``"vertical"``.
+    symbolFillColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the legend symbol,
+    symbolLimit : dict, float, :class:`ExprRef`
+        The maximum number of allowed entries for a symbol legend. Additional entries will
+        be dropped.
+    symbolOffset : dict, float, :class:`ExprRef`
+        Horizontal pixel offset for legend symbols.
+
+        **Default value:** ``0``.
+    symbolOpacity : dict, float, :class:`ExprRef`
+        Opacity of the legend symbols.
+    symbolSize : dict, float, :class:`ExprRef`
+        The size of the legend symbol, in pixels.
+
+        **Default value:** ``100``.
+    symbolStrokeColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Stroke color for legend symbols.
+    symbolStrokeWidth : dict, float, :class:`ExprRef`
+        The width of the symbol's stroke.
+
+        **Default value:** ``1.5``.
+    symbolType : str, dict, :class:`ExprRef`, :class:`SymbolShape`
+        The symbol shape. One of the plotting shapes ``circle`` (default), ``square``,
+        ``cross``, ``diamond``, ``triangle-up``, ``triangle-down``, ``triangle-right``, or
+        ``triangle-left``, the line symbol ``stroke``, or one of the centered directional
+        shapes ``arrow``, ``wedge``, or ``triangle``. Alternatively, a custom `SVG path
+        string <https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths>`__ can be
+        provided. For correct sizing, custom shape paths should be defined within a square
+        bounding box with coordinates ranging from -1 to 1 along both the x and y
+        dimensions.
+
+        **Default value:** ``"circle"``.
+    tickCount : dict, float, :class:`ExprRef`, :class:`TickCount`, :class:`TimeInterval`, :class:`TimeIntervalStep`, Literal['millisecond', 'second', 'minute', 'hour', 'day', 'week', 'month', 'year']
+        The desired number of tick values for quantitative legends.
+    title : None
+        Set to null to disable title for the axis, legend, or header.
+    titleAlign : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        Horizontal text alignment for legend titles.
+
+        **Default value:** ``"left"``.
+    titleAnchor : dict, :class:`ExprRef`, :class:`TitleAnchor`, Literal[None, 'start', 'middle', 'end']
+        Text anchor position for placing legend titles.
+    titleBaseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        Vertical text baseline for legend titles.  One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, or ``"line-bottom"``. The
+        ``"line-top"`` and ``"line-bottom"`` values operate similarly to ``"top"`` and
+        ``"bottom"``, but are calculated relative to the *lineHeight* rather than *fontSize*
+        alone.
+
+        **Default value:** ``"top"``.
+    titleColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The color of the legend title, can be in hex color code or regular color name.
+    titleFont : str, dict, :class:`ExprRef`
+        The font of the legend title.
+    titleFontSize : dict, float, :class:`ExprRef`
+        The font size of the legend title.
+    titleFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style of the legend title.
+    titleFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight of the legend title. This can be either a string (e.g ``"bold"``,
+        ``"normal"`` ) or a number ( ``100``, ``200``, ``300``, ..., ``900`` where
+        ``"normal"`` = ``400`` and ``"bold"`` = ``700`` ).
+    titleLimit : dict, float, :class:`ExprRef`
+        Maximum allowed pixel width of legend titles.
+
+        **Default value:** ``180``.
+    titleLineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line title text or title text with ``"line-top"`` or
+        ``"line-bottom"`` baseline.
+    titleOpacity : dict, float, :class:`ExprRef`
+        Opacity of the legend title.
+    titleOrient : dict, :class:`Orient`, :class:`ExprRef`, Literal['left', 'right', 'top', 'bottom']
+        Orientation of the legend title.
+    titlePadding : dict, float, :class:`ExprRef`
+        The padding, in pixels, between title and legend.
+
+        **Default value:** ``5``.
+    unselectedOpacity : float
+        The opacity of unselected legend entries.
+
+        **Default value:** 0.35.
+    zindex : dict, float, :class:`ExprRef`
+        The integer z-index indicating the layering of the legend group relative to other
+        axis, mark, and legend groups.
+    """
+
+    _schema = {"$ref": "#/definitions/LegendConfig"}
+
+    def __init__(
+        self,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        clipHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        columnPadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        columns: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        description: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        direction: Union[
+            "SchemaBase", Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        disable: Union[bool, UndefinedType] = Undefined,
+        fillColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientDirection: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["horizontal", "vertical"],
+            UndefinedType,
+        ] = Undefined,
+        gradientHorizontalMaxLength: Union[float, UndefinedType] = Undefined,
+        gradientHorizontalMinLength: Union[float, UndefinedType] = Undefined,
+        gradientLabelLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gradientLabelOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gradientLength: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gradientOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gradientStrokeColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        gradientStrokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gradientThickness: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        gradientVerticalMaxLength: Union[float, UndefinedType] = Undefined,
+        gradientVerticalMinLength: Union[float, UndefinedType] = Undefined,
+        gridAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["all", "each", "none"],
+            UndefinedType,
+        ] = Undefined,
+        labelAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        labelBaseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        labelColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        labelLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelOverlap: Union[
+            str, bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelPadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        labelSeparation: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        layout: Union[dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        legendX: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        legendY: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        orient: Union[
+            "SchemaBase",
+            Literal[
+                "none",
+                "left",
+                "right",
+                "top",
+                "bottom",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        rowPadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        symbolBaseFillColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolBaseStrokeColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        symbolDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        symbolDirection: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["horizontal", "vertical"],
+            UndefinedType,
+        ] = Undefined,
+        symbolFillColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        symbolOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        symbolOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        symbolSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        symbolStrokeColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbolStrokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        symbolType: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tickCount: Union[
+            dict,
+            float,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[None, UndefinedType] = Undefined,
+        titleAlign: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        titleAnchor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        titleBaseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titleColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        titleLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleLineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        titleOrient: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        titlePadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        unselectedOpacity: Union[float, UndefinedType] = Undefined,
+        zindex: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(LegendConfig, self).__init__(
+            aria=aria,
+            clipHeight=clipHeight,
+            columnPadding=columnPadding,
+            columns=columns,
+            cornerRadius=cornerRadius,
+            description=description,
+            direction=direction,
+            disable=disable,
+            fillColor=fillColor,
+            gradientDirection=gradientDirection,
+            gradientHorizontalMaxLength=gradientHorizontalMaxLength,
+            gradientHorizontalMinLength=gradientHorizontalMinLength,
+            gradientLabelLimit=gradientLabelLimit,
+            gradientLabelOffset=gradientLabelOffset,
+            gradientLength=gradientLength,
+            gradientOpacity=gradientOpacity,
+            gradientStrokeColor=gradientStrokeColor,
+            gradientStrokeWidth=gradientStrokeWidth,
+            gradientThickness=gradientThickness,
+            gradientVerticalMaxLength=gradientVerticalMaxLength,
+            gradientVerticalMinLength=gradientVerticalMinLength,
+            gridAlign=gridAlign,
+            labelAlign=labelAlign,
+            labelBaseline=labelBaseline,
+            labelColor=labelColor,
+            labelFont=labelFont,
+            labelFontSize=labelFontSize,
+            labelFontStyle=labelFontStyle,
+            labelFontWeight=labelFontWeight,
+            labelLimit=labelLimit,
+            labelOffset=labelOffset,
+            labelOpacity=labelOpacity,
+            labelOverlap=labelOverlap,
+            labelPadding=labelPadding,
+            labelSeparation=labelSeparation,
+            layout=layout,
+            legendX=legendX,
+            legendY=legendY,
+            offset=offset,
+            orient=orient,
+            padding=padding,
+            rowPadding=rowPadding,
+            strokeColor=strokeColor,
+            strokeDash=strokeDash,
+            strokeWidth=strokeWidth,
+            symbolBaseFillColor=symbolBaseFillColor,
+            symbolBaseStrokeColor=symbolBaseStrokeColor,
+            symbolDash=symbolDash,
+            symbolDashOffset=symbolDashOffset,
+            symbolDirection=symbolDirection,
+            symbolFillColor=symbolFillColor,
+            symbolLimit=symbolLimit,
+            symbolOffset=symbolOffset,
+            symbolOpacity=symbolOpacity,
+            symbolSize=symbolSize,
+            symbolStrokeColor=symbolStrokeColor,
+            symbolStrokeWidth=symbolStrokeWidth,
+            symbolType=symbolType,
+            tickCount=tickCount,
+            title=title,
+            titleAlign=titleAlign,
+            titleAnchor=titleAnchor,
+            titleBaseline=titleBaseline,
+            titleColor=titleColor,
+            titleFont=titleFont,
+            titleFontSize=titleFontSize,
+            titleFontStyle=titleFontStyle,
+            titleFontWeight=titleFontWeight,
+            titleLimit=titleLimit,
+            titleLineHeight=titleLineHeight,
+            titleOpacity=titleOpacity,
+            titleOrient=titleOrient,
+            titlePadding=titlePadding,
+            unselectedOpacity=unselectedOpacity,
+            zindex=zindex,
+            **kwds,
+        )
+
+
+class LegendOrient(VegaLiteSchema):
+    """LegendOrient schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/LegendOrient"}
+
+    def __init__(self, *args):
+        super(LegendOrient, self).__init__(*args)
+
+
+class LegendResolveMap(VegaLiteSchema):
+    """LegendResolveMap schema wrapper
+
+    Parameters
+    ----------
+
+    angle : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    color : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    fill : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    fillOpacity : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    opacity : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    shape : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    size : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    stroke : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    strokeDash : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    strokeOpacity : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    strokeWidth : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    """
+
+    _schema = {"$ref": "#/definitions/LegendResolveMap"}
+
+    def __init__(
+        self,
+        angle: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        color: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        fill: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        fillOpacity: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        shape: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        size: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        strokeDash: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(LegendResolveMap, self).__init__(
+            angle=angle,
+            color=color,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            opacity=opacity,
+            shape=shape,
+            size=size,
+            stroke=stroke,
+            strokeDash=strokeDash,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            **kwds,
+        )
+
+
+class LegendStreamBinding(LegendBinding):
+    """LegendStreamBinding schema wrapper
+
+    Parameters
+    ----------
+
+    legend : str, dict, :class:`Stream`, :class:`EventStream`, :class:`MergedStream`, :class:`DerivedStream`
+
+    """
+
+    _schema = {"$ref": "#/definitions/LegendStreamBinding"}
+
+    def __init__(
+        self, legend: Union[str, dict, "SchemaBase", UndefinedType] = Undefined, **kwds
+    ):
+        super(LegendStreamBinding, self).__init__(legend=legend, **kwds)
+
+
+class LineConfig(AnyMarkConfig):
+    """LineConfig schema wrapper
+
+    Parameters
+    ----------
+
+    align : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule).
+        One of ``"left"``, ``"right"``, ``"center"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    angle : dict, float, :class:`ExprRef`
+        The rotation angle of the text, in degrees.
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG element, removing the mark item from the ARIA accessibility tree.
+    ariaRole : str, dict, :class:`ExprRef`
+        Sets the type of user interface element of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "role" attribute. Warning: this
+        property is experimental and may be changed in the future.
+    ariaRoleDescription : str, dict, :class:`ExprRef`
+        A human-readable, author-localized description for the role of the mark item for
+        `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "aria-roledescription" attribute.
+        Warning: this property is experimental and may be changed in the future.
+    aspect : bool, dict, :class:`ExprRef`
+        Whether to keep aspect ratio of image marks.
+    baseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        For text marks, the vertical text baseline. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, ``"line-bottom"``, or an
+        expression reference that provides one of the valid values. The ``"line-top"`` and
+        ``"line-bottom"`` values operate similarly to ``"top"`` and ``"bottom"``, but are
+        calculated relative to the ``lineHeight`` rather than ``fontSize`` alone.
+
+        For range marks, the vertical alignment of the marks. One of ``"top"``,
+        ``"middle"``, ``"bottom"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    blend : dict, :class:`Blend`, :class:`ExprRef`, Literal[None, 'multiply', 'screen', 'overlay', 'darken', 'lighten', 'color-dodge', 'color-burn', 'hard-light', 'soft-light', 'difference', 'exclusion', 'hue', 'saturation', 'color', 'luminosity']
+        The color blend mode for drawing an item on its current background. Any valid `CSS
+        mix-blend-mode <https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode>`__
+        value can be used.
+
+        __Default value:__ ``"source-over"``
+    color : str, dict, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default color.
+
+        **Default value:** :raw-html:`<span style="color: #4682b4;">&#9632;</span>`
+        ``"#4682b4"``
+
+        **Note:**
+
+
+        * This property cannot be used in a `style config
+          <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+        * The ``fill`` and ``stroke`` properties have higher precedence than ``color`` and
+          will override ``color``.
+    cornerRadius : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles or arcs' corners.
+
+        **Default value:** ``0``
+    cornerRadiusBottomLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom left corner.
+
+        **Default value:** ``0``
+    cornerRadiusBottomRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top left corner.
+
+        **Default value:** ``0``
+    cursor : dict, :class:`Cursor`, :class:`ExprRef`, Literal['auto', 'default', 'none', 'context-menu', 'help', 'pointer', 'progress', 'wait', 'cell', 'crosshair', 'text', 'vertical-text', 'alias', 'copy', 'move', 'no-drop', 'not-allowed', 'e-resize', 'n-resize', 'ne-resize', 'nw-resize', 's-resize', 'se-resize', 'sw-resize', 'w-resize', 'ew-resize', 'ns-resize', 'nesw-resize', 'nwse-resize', 'col-resize', 'row-resize', 'all-scroll', 'zoom-in', 'zoom-out', 'grab', 'grabbing']
+        The mouse cursor used over the mark. Any valid `CSS cursor type
+        <https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values>`__ can be used.
+    description : str, dict, :class:`ExprRef`
+        A text description of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the `"aria-label" attribute
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>`__.
+    dir : dict, :class:`ExprRef`, Literal['ltr', 'rtl'], :class:`TextDirection`
+        The direction of the text. One of ``"ltr"`` (left-to-right) or ``"rtl"``
+        (right-to-left). This property determines on which side is truncated in response to
+        the limit parameter.
+
+        **Default value:** ``"ltr"``
+    dx : dict, float, :class:`ExprRef`
+        The horizontal offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    dy : dict, float, :class:`ExprRef`
+        The vertical offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    ellipsis : str, dict, :class:`ExprRef`
+        The ellipsis string for text truncated in response to the limit parameter.
+
+        **Default value:** ``"…"``
+    endAngle : dict, float, :class:`ExprRef`
+        The end angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    fill : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default fill color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove fill.
+
+        **Default value:** (None)
+    fillOpacity : dict, float, :class:`ExprRef`
+        The fill opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    filled : bool
+        Whether the mark's color should be used as fill color instead of stroke color.
+
+        **Default value:** ``false`` for all ``point``, ``line``, and ``rule`` marks as well
+        as ``geoshape`` marks for `graticule
+        <https://vega.github.io/vega-lite/docs/data.html#graticule>`__ data sources;
+        otherwise, ``true``.
+
+        **Note:** This property cannot be used in a `style config
+        <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+    font : str, dict, :class:`ExprRef`
+        The typeface to set the text in (e.g., ``"Helvetica Neue"`` ).
+    fontSize : dict, float, :class:`ExprRef`
+        The font size, in pixels.
+
+        **Default value:** ``11``
+    fontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style (e.g., ``"italic"`` ).
+    fontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight. This can be either a string (e.g ``"bold"``, ``"normal"`` ) or a
+        number ( ``100``, ``200``, ``300``, ..., ``900`` where ``"normal"`` = ``400`` and
+        ``"bold"`` = ``700`` ).
+    height : dict, float, :class:`ExprRef`
+        Height of the marks.
+    href : str, dict, :class:`URI`, :class:`ExprRef`
+        A URL to load upon mouse click. If defined, the mark acts as a hyperlink.
+    innerRadius : dict, float, :class:`ExprRef`
+        The inner radius in pixels of arc marks. ``innerRadius`` is an alias for
+        ``radius2``.
+
+        **Default value:** ``0``
+    interpolate : dict, :class:`ExprRef`, :class:`Interpolate`, Literal['basis', 'basis-open', 'basis-closed', 'bundle', 'cardinal', 'cardinal-open', 'cardinal-closed', 'catmull-rom', 'linear', 'linear-closed', 'monotone', 'natural', 'step', 'step-before', 'step-after']
+        The line interpolation method to use for line and area marks. One of the following:
+
+
+        * ``"linear"`` : piecewise linear segments, as in a polyline.
+        * ``"linear-closed"`` : close the linear segments to form a polygon.
+        * ``"step"`` : alternate between horizontal and vertical segments, as in a step
+          function.
+        * ``"step-before"`` : alternate between vertical and horizontal segments, as in a
+          step function.
+        * ``"step-after"`` : alternate between horizontal and vertical segments, as in a
+          step function.
+        * ``"basis"`` : a B-spline, with control point duplication on the ends.
+        * ``"basis-open"`` : an open B-spline; may not intersect the start or end.
+        * ``"basis-closed"`` : a closed B-spline, as in a loop.
+        * ``"cardinal"`` : a Cardinal spline, with control point duplication on the ends.
+        * ``"cardinal-open"`` : an open Cardinal spline; may not intersect the start or end,
+          but will intersect other control points.
+        * ``"cardinal-closed"`` : a closed Cardinal spline, as in a loop.
+        * ``"bundle"`` : equivalent to basis, except the tension parameter is used to
+          straighten the spline.
+        * ``"monotone"`` : cubic interpolation that preserves monotonicity in y.
+    invalid : Literal['filter', None]
+        Defines how Vega-Lite should handle marks for invalid values ( ``null`` and ``NaN``
+        ).
+
+
+        * If set to ``"filter"`` (default), all data items with null values will be skipped
+          (for line, trail, and area marks) or filtered (for other marks).
+        * If ``null``, all data items are included. In this case, invalid values will be
+          interpreted as zeroes.
+    limit : dict, float, :class:`ExprRef`
+        The maximum length of the text mark in pixels. The text value will be automatically
+        truncated if the rendered size exceeds the limit.
+
+        **Default value:** ``0`` -- indicating no limit
+    lineBreak : str, dict, :class:`ExprRef`
+        A delimiter, such as a newline character, upon which to break text strings into
+        multiple lines. This property is ignored if the text is array-valued.
+    lineHeight : dict, float, :class:`ExprRef`
+        The line height in pixels (the spacing between subsequent lines of text) for
+        multi-line text marks.
+    opacity : dict, float, :class:`ExprRef`
+        The overall opacity (value between [0,1]).
+
+        **Default value:** ``0.7`` for non-aggregate plots with ``point``, ``tick``,
+        ``circle``, or ``square`` marks or layered ``bar`` charts and ``1`` otherwise.
+    order : bool, None
+        For line and trail marks, this ``order`` property can be set to ``null`` or
+        ``false`` to make the lines use the original order in the data sources.
+    orient : :class:`Orientation`, Literal['horizontal', 'vertical']
+        The orientation of a non-stacked bar, tick, area, and line charts. The value is
+        either horizontal (default) or vertical.
+
+
+        * For bar, rule and tick, this determines whether the size of the bar and tick
+          should be applied to x or y dimension.
+        * For area, this property determines the orient property of the Vega output.
+        * For line and trail marks, this property determines the sort order of the points in
+          the line if ``config.sortLineBy`` is not specified. For stacked charts, this is
+          always determined by the orientation of the stack; therefore explicitly specified
+          value will be ignored.
+    outerRadius : dict, float, :class:`ExprRef`
+        The outer radius in pixels of arc marks. ``outerRadius`` is an alias for ``radius``.
+
+        **Default value:** ``0``
+    padAngle : dict, float, :class:`ExprRef`
+        The angular padding applied to sides of the arc, in radians.
+    point : str, bool, dict, :class:`OverlayMarkDef`
+        A flag for overlaying points on top of line or area marks, or an object defining the
+        properties of the overlayed points.
+
+
+        If this property is ``"transparent"``, transparent points will be used (for
+        enhancing tooltips and selections).
+
+        If this property is an empty object ( ``{}`` ) or ``true``, filled points with
+        default properties will be used.
+
+        If this property is ``false``, no points would be automatically added to line or
+        area marks.
+
+        **Default value:** ``false``.
+    radius : dict, float, :class:`ExprRef`
+        For arc mark, the primary (outer) radius in pixels.
+
+        For text marks, polar coordinate radial offset, in pixels, of the text from the
+        origin determined by the ``x`` and ``y`` properties.
+
+        **Default value:** ``min(plot_width, plot_height)/2``
+    radius2 : dict, float, :class:`ExprRef`
+        The secondary (inner) radius in pixels of arc marks.
+
+        **Default value:** ``0``
+    shape : str, dict, :class:`ExprRef`, :class:`SymbolShape`
+        Shape of the point marks. Supported values include:
+
+
+        * plotting shapes: ``"circle"``, ``"square"``, ``"cross"``, ``"diamond"``,
+          ``"triangle-up"``, ``"triangle-down"``, ``"triangle-right"``, or
+          ``"triangle-left"``.
+        * the line symbol ``"stroke"``
+        * centered directional shapes ``"arrow"``, ``"wedge"``, or ``"triangle"``
+        * a custom `SVG path string
+          <https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths>`__ (For correct
+          sizing, custom shape paths should be defined within a square bounding box with
+          coordinates ranging from -1 to 1 along both the x and y dimensions.)
+
+        **Default value:** ``"circle"``
+    size : dict, float, :class:`ExprRef`
+        Default size for marks.
+
+
+        * For ``point`` / ``circle`` / ``square``, this represents the pixel area of the
+          marks. Note that this value sets the area of the symbol; the side lengths will
+          increase with the square root of this value.
+        * For ``bar``, this represents the band size of the bar, in pixels.
+        * For ``text``, this represents the font size, in pixels.
+
+        **Default value:**
+
+
+        * ``30`` for point, circle, square marks; width/height's ``step``
+        * ``2`` for bar marks with discrete dimensions;
+        * ``5`` for bar marks with continuous dimensions;
+        * ``11`` for text marks.
+    smooth : bool, dict, :class:`ExprRef`
+        A boolean flag (default true) indicating if the image should be smoothed when
+        resized. If false, individual pixels should be scaled directly rather than
+        interpolated with smoothing. For SVG rendering, this option may not work in some
+        browsers due to lack of standardization.
+    startAngle : dict, float, :class:`ExprRef`
+        The start angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    stroke : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default stroke color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove stroke.
+
+        **Default value:** (None)
+    strokeCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for line ending style. One of ``"butt"``, ``"round"``, or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    strokeDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating stroke, space lengths for creating dashed or dotted lines.
+    strokeDashOffset : dict, float, :class:`ExprRef`
+        The offset (in pixels) into which to begin drawing with the stroke dash array.
+    strokeJoin : dict, :class:`ExprRef`, :class:`StrokeJoin`, Literal['miter', 'round', 'bevel']
+        The stroke line join method. One of ``"miter"``, ``"round"`` or ``"bevel"``.
+
+        **Default value:** ``"miter"``
+    strokeMiterLimit : dict, float, :class:`ExprRef`
+        The miter limit at which to bevel a line join.
+    strokeOffset : dict, float, :class:`ExprRef`
+        The offset in pixels at which to draw the group stroke and fill. If unspecified, the
+        default behavior is to dynamically offset stroked groups such that 1 pixel stroke
+        widths align with the pixel grid.
+    strokeOpacity : dict, float, :class:`ExprRef`
+        The stroke opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    strokeWidth : dict, float, :class:`ExprRef`
+        The stroke width, in pixels.
+    tension : dict, float, :class:`ExprRef`
+        Depending on the interpolation type, sets the tension parameter (for line and area
+        marks).
+    text : str, dict, :class:`Text`, Sequence[str], :class:`ExprRef`
+        Placeholder text if the ``text`` channel is not specified
+    theta : dict, float, :class:`ExprRef`
+        For arc marks, the arc length in radians if theta2 is not specified, otherwise the
+        start arc angle. (A value of 0 indicates up or “north”, increasing values proceed
+        clockwise.)
+
+        For text marks, polar coordinate angle in radians.
+    theta2 : dict, float, :class:`ExprRef`
+        The end angle of arc marks in radians. A value of 0 indicates up or “north”,
+        increasing values proceed clockwise.
+    timeUnitBandPosition : float
+        Default relative band position for a time unit. If set to ``0``, the marks will be
+        positioned at the beginning of the time unit band step. If set to ``0.5``, the marks
+        will be positioned in the middle of the time unit band step.
+    timeUnitBandSize : float
+        Default relative band size for a time unit. If set to ``1``, the bandwidth of the
+        marks will be equal to the time unit band step. If set to ``0.5``, bandwidth of the
+        marks will be half of the time unit band step.
+    tooltip : str, bool, dict, None, float, :class:`ExprRef`, :class:`TooltipContent`
+        The tooltip text string to show upon mouse hover or an object defining which fields
+        should the tooltip be derived from.
+
+
+        * If ``tooltip`` is ``true`` or ``{"content": "encoding"}``, then all fields from
+          ``encoding`` will be used.
+        * If ``tooltip`` is ``{"content": "data"}``, then all fields that appear in the
+          highlighted data point will be used.
+        * If set to ``null`` or ``false``, then no tooltip will be used.
+
+        See the `tooltip <https://vega.github.io/vega-lite/docs/tooltip.html>`__
+        documentation for a detailed discussion about tooltip  in Vega-Lite.
+
+        **Default value:** ``null``
+    url : str, dict, :class:`URI`, :class:`ExprRef`
+        The URL of the image file for image marks.
+    width : dict, float, :class:`ExprRef`
+        Width of the marks.
+    x : str, dict, float, :class:`ExprRef`
+        X coordinates of the marks, or width of horizontal ``"bar"`` and ``"area"`` without
+        specified ``x2`` or ``width``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    x2 : str, dict, float, :class:`ExprRef`
+        X2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    y : str, dict, float, :class:`ExprRef`
+        Y coordinates of the marks, or height of vertical ``"bar"`` and ``"area"`` without
+        specified ``y2`` or ``height``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    y2 : str, dict, float, :class:`ExprRef`
+        Y2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    """
+
+    _schema = {"$ref": "#/definitions/LineConfig"}
+
+    def __init__(
+        self,
+        align: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ariaRole: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        blend: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, "_Parameter", "SchemaBase", Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        dx: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        dy: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ellipsis: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        endAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        fontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        href: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        innerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineBreak: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            "SchemaBase", Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        shape: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        size: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        smooth: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        startAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tension: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, "_Parameter", "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        url: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        width: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(LineConfig, self).__init__(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            baseline=baseline,
+            blend=blend,
+            color=color,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            endAngle=endAngle,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            startAngle=startAngle,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            y=y,
+            y2=y2,
+            **kwds,
+        )
+
+
+class LineString(Geometry):
+    """LineString schema wrapper
+    LineString geometry object. https://tools.ietf.org/html/rfc7946#section-3.1.4
+
+    Parameters
+    ----------
+
+    coordinates : Sequence[Sequence[float], :class:`Position`]
+
+    type : str
+        Specifies the type of GeoJSON object.
+    bbox : :class:`BBox`, Sequence[float]
+        Bounding box of the coordinate range of the object's Geometries, Features, or
+        Feature Collections. https://tools.ietf.org/html/rfc7946#section-5
+    """
+
+    _schema = {"$ref": "#/definitions/LineString"}
+
+    def __init__(
+        self,
+        coordinates: Union[
+            Sequence[Union["SchemaBase", Sequence[float]]], UndefinedType
+        ] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        bbox: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(LineString, self).__init__(
+            coordinates=coordinates, type=type, bbox=bbox, **kwds
+        )
+
+
+class LinearGradient(Gradient):
+    """LinearGradient schema wrapper
+
+    Parameters
+    ----------
+
+    gradient : str
+        The type of gradient. Use ``"linear"`` for a linear gradient.
+    stops : Sequence[dict, :class:`GradientStop`]
+        An array of gradient stops defining the gradient color sequence.
+    id : str
+
+    x1 : float
+        The starting x-coordinate, in normalized [0, 1] coordinates, of the linear gradient.
+
+        **Default value:** ``0``
+    x2 : float
+        The ending x-coordinate, in normalized [0, 1] coordinates, of the linear gradient.
+
+        **Default value:** ``1``
+    y1 : float
+        The starting y-coordinate, in normalized [0, 1] coordinates, of the linear gradient.
+
+        **Default value:** ``0``
+    y2 : float
+        The ending y-coordinate, in normalized [0, 1] coordinates, of the linear gradient.
+
+        **Default value:** ``0``
+    """
+
+    _schema = {"$ref": "#/definitions/LinearGradient"}
+
+    def __init__(
+        self,
+        gradient: Union[str, UndefinedType] = Undefined,
+        stops: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        id: Union[str, UndefinedType] = Undefined,
+        x1: Union[float, UndefinedType] = Undefined,
+        x2: Union[float, UndefinedType] = Undefined,
+        y1: Union[float, UndefinedType] = Undefined,
+        y2: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(LinearGradient, self).__init__(
+            gradient=gradient, stops=stops, id=id, x1=x1, x2=x2, y1=y1, y2=y2, **kwds
+        )
+
+
+class Locale(VegaLiteSchema):
+    """Locale schema wrapper
+
+    Parameters
+    ----------
+
+    number : dict, :class:`NumberLocale`
+        Locale definition for formatting numbers.
+    time : dict, :class:`TimeLocale`
+        Locale definition for formatting dates and times.
+    """
+
+    _schema = {"$ref": "#/definitions/Locale"}
+
+    def __init__(
+        self,
+        number: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        time: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(Locale, self).__init__(number=number, time=time, **kwds)
+
+
+class LookupData(VegaLiteSchema):
+    """LookupData schema wrapper
+
+    Parameters
+    ----------
+
+    data : dict, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        Secondary data source to lookup in.
+    key : str, :class:`FieldName`
+        Key in data to lookup.
+    fields : Sequence[str, :class:`FieldName`]
+        Fields in foreign data or selection to lookup. If not specified, the entire object
+        is queried.
+    """
+
+    _schema = {"$ref": "#/definitions/LookupData"}
+
+    def __init__(
+        self,
+        data: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        key: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        fields: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(LookupData, self).__init__(data=data, key=key, fields=fields, **kwds)
+
+
+class LookupSelection(VegaLiteSchema):
+    """LookupSelection schema wrapper
+
+    Parameters
+    ----------
+
+    key : str, :class:`FieldName`
+        Key in data to lookup.
+    param : str, :class:`ParameterName`
+        Selection parameter name to look up.
+    fields : Sequence[str, :class:`FieldName`]
+        Fields in foreign data or selection to lookup. If not specified, the entire object
+        is queried.
+    """
+
+    _schema = {"$ref": "#/definitions/LookupSelection"}
+
+    def __init__(
+        self,
+        key: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        param: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        fields: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(LookupSelection, self).__init__(
+            key=key, param=param, fields=fields, **kwds
+        )
+
+
+class Mark(AnyMark):
+    """Mark schema wrapper
+    All types of primitive marks.
+    """
+
+    _schema = {"$ref": "#/definitions/Mark"}
+
+    def __init__(self, *args):
+        super(Mark, self).__init__(*args)
+
+
+class MarkConfig(AnyMarkConfig):
+    """MarkConfig schema wrapper
+
+    Parameters
+    ----------
+
+    align : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule).
+        One of ``"left"``, ``"right"``, ``"center"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    angle : dict, float, :class:`ExprRef`
+        The rotation angle of the text, in degrees.
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG element, removing the mark item from the ARIA accessibility tree.
+    ariaRole : str, dict, :class:`ExprRef`
+        Sets the type of user interface element of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "role" attribute. Warning: this
+        property is experimental and may be changed in the future.
+    ariaRoleDescription : str, dict, :class:`ExprRef`
+        A human-readable, author-localized description for the role of the mark item for
+        `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "aria-roledescription" attribute.
+        Warning: this property is experimental and may be changed in the future.
+    aspect : bool, dict, :class:`ExprRef`
+        Whether to keep aspect ratio of image marks.
+    baseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        For text marks, the vertical text baseline. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, ``"line-bottom"``, or an
+        expression reference that provides one of the valid values. The ``"line-top"`` and
+        ``"line-bottom"`` values operate similarly to ``"top"`` and ``"bottom"``, but are
+        calculated relative to the ``lineHeight`` rather than ``fontSize`` alone.
+
+        For range marks, the vertical alignment of the marks. One of ``"top"``,
+        ``"middle"``, ``"bottom"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    blend : dict, :class:`Blend`, :class:`ExprRef`, Literal[None, 'multiply', 'screen', 'overlay', 'darken', 'lighten', 'color-dodge', 'color-burn', 'hard-light', 'soft-light', 'difference', 'exclusion', 'hue', 'saturation', 'color', 'luminosity']
+        The color blend mode for drawing an item on its current background. Any valid `CSS
+        mix-blend-mode <https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode>`__
+        value can be used.
+
+        __Default value:__ ``"source-over"``
+    color : str, dict, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default color.
+
+        **Default value:** :raw-html:`<span style="color: #4682b4;">&#9632;</span>`
+        ``"#4682b4"``
+
+        **Note:**
+
+
+        * This property cannot be used in a `style config
+          <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+        * The ``fill`` and ``stroke`` properties have higher precedence than ``color`` and
+          will override ``color``.
+    cornerRadius : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles or arcs' corners.
+
+        **Default value:** ``0``
+    cornerRadiusBottomLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom left corner.
+
+        **Default value:** ``0``
+    cornerRadiusBottomRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top left corner.
+
+        **Default value:** ``0``
+    cursor : dict, :class:`Cursor`, :class:`ExprRef`, Literal['auto', 'default', 'none', 'context-menu', 'help', 'pointer', 'progress', 'wait', 'cell', 'crosshair', 'text', 'vertical-text', 'alias', 'copy', 'move', 'no-drop', 'not-allowed', 'e-resize', 'n-resize', 'ne-resize', 'nw-resize', 's-resize', 'se-resize', 'sw-resize', 'w-resize', 'ew-resize', 'ns-resize', 'nesw-resize', 'nwse-resize', 'col-resize', 'row-resize', 'all-scroll', 'zoom-in', 'zoom-out', 'grab', 'grabbing']
+        The mouse cursor used over the mark. Any valid `CSS cursor type
+        <https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values>`__ can be used.
+    description : str, dict, :class:`ExprRef`
+        A text description of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the `"aria-label" attribute
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>`__.
+    dir : dict, :class:`ExprRef`, Literal['ltr', 'rtl'], :class:`TextDirection`
+        The direction of the text. One of ``"ltr"`` (left-to-right) or ``"rtl"``
+        (right-to-left). This property determines on which side is truncated in response to
+        the limit parameter.
+
+        **Default value:** ``"ltr"``
+    dx : dict, float, :class:`ExprRef`
+        The horizontal offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    dy : dict, float, :class:`ExprRef`
+        The vertical offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    ellipsis : str, dict, :class:`ExprRef`
+        The ellipsis string for text truncated in response to the limit parameter.
+
+        **Default value:** ``"…"``
+    endAngle : dict, float, :class:`ExprRef`
+        The end angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    fill : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default fill color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove fill.
+
+        **Default value:** (None)
+    fillOpacity : dict, float, :class:`ExprRef`
+        The fill opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    filled : bool
+        Whether the mark's color should be used as fill color instead of stroke color.
+
+        **Default value:** ``false`` for all ``point``, ``line``, and ``rule`` marks as well
+        as ``geoshape`` marks for `graticule
+        <https://vega.github.io/vega-lite/docs/data.html#graticule>`__ data sources;
+        otherwise, ``true``.
+
+        **Note:** This property cannot be used in a `style config
+        <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+    font : str, dict, :class:`ExprRef`
+        The typeface to set the text in (e.g., ``"Helvetica Neue"`` ).
+    fontSize : dict, float, :class:`ExprRef`
+        The font size, in pixels.
+
+        **Default value:** ``11``
+    fontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style (e.g., ``"italic"`` ).
+    fontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight. This can be either a string (e.g ``"bold"``, ``"normal"`` ) or a
+        number ( ``100``, ``200``, ``300``, ..., ``900`` where ``"normal"`` = ``400`` and
+        ``"bold"`` = ``700`` ).
+    height : dict, float, :class:`ExprRef`
+        Height of the marks.
+    href : str, dict, :class:`URI`, :class:`ExprRef`
+        A URL to load upon mouse click. If defined, the mark acts as a hyperlink.
+    innerRadius : dict, float, :class:`ExprRef`
+        The inner radius in pixels of arc marks. ``innerRadius`` is an alias for
+        ``radius2``.
+
+        **Default value:** ``0``
+    interpolate : dict, :class:`ExprRef`, :class:`Interpolate`, Literal['basis', 'basis-open', 'basis-closed', 'bundle', 'cardinal', 'cardinal-open', 'cardinal-closed', 'catmull-rom', 'linear', 'linear-closed', 'monotone', 'natural', 'step', 'step-before', 'step-after']
+        The line interpolation method to use for line and area marks. One of the following:
+
+
+        * ``"linear"`` : piecewise linear segments, as in a polyline.
+        * ``"linear-closed"`` : close the linear segments to form a polygon.
+        * ``"step"`` : alternate between horizontal and vertical segments, as in a step
+          function.
+        * ``"step-before"`` : alternate between vertical and horizontal segments, as in a
+          step function.
+        * ``"step-after"`` : alternate between horizontal and vertical segments, as in a
+          step function.
+        * ``"basis"`` : a B-spline, with control point duplication on the ends.
+        * ``"basis-open"`` : an open B-spline; may not intersect the start or end.
+        * ``"basis-closed"`` : a closed B-spline, as in a loop.
+        * ``"cardinal"`` : a Cardinal spline, with control point duplication on the ends.
+        * ``"cardinal-open"`` : an open Cardinal spline; may not intersect the start or end,
+          but will intersect other control points.
+        * ``"cardinal-closed"`` : a closed Cardinal spline, as in a loop.
+        * ``"bundle"`` : equivalent to basis, except the tension parameter is used to
+          straighten the spline.
+        * ``"monotone"`` : cubic interpolation that preserves monotonicity in y.
+    invalid : Literal['filter', None]
+        Defines how Vega-Lite should handle marks for invalid values ( ``null`` and ``NaN``
+        ).
+
+
+        * If set to ``"filter"`` (default), all data items with null values will be skipped
+          (for line, trail, and area marks) or filtered (for other marks).
+        * If ``null``, all data items are included. In this case, invalid values will be
+          interpreted as zeroes.
+    limit : dict, float, :class:`ExprRef`
+        The maximum length of the text mark in pixels. The text value will be automatically
+        truncated if the rendered size exceeds the limit.
+
+        **Default value:** ``0`` -- indicating no limit
+    lineBreak : str, dict, :class:`ExprRef`
+        A delimiter, such as a newline character, upon which to break text strings into
+        multiple lines. This property is ignored if the text is array-valued.
+    lineHeight : dict, float, :class:`ExprRef`
+        The line height in pixels (the spacing between subsequent lines of text) for
+        multi-line text marks.
+    opacity : dict, float, :class:`ExprRef`
+        The overall opacity (value between [0,1]).
+
+        **Default value:** ``0.7`` for non-aggregate plots with ``point``, ``tick``,
+        ``circle``, or ``square`` marks or layered ``bar`` charts and ``1`` otherwise.
+    order : bool, None
+        For line and trail marks, this ``order`` property can be set to ``null`` or
+        ``false`` to make the lines use the original order in the data sources.
+    orient : :class:`Orientation`, Literal['horizontal', 'vertical']
+        The orientation of a non-stacked bar, tick, area, and line charts. The value is
+        either horizontal (default) or vertical.
+
+
+        * For bar, rule and tick, this determines whether the size of the bar and tick
+          should be applied to x or y dimension.
+        * For area, this property determines the orient property of the Vega output.
+        * For line and trail marks, this property determines the sort order of the points in
+          the line if ``config.sortLineBy`` is not specified. For stacked charts, this is
+          always determined by the orientation of the stack; therefore explicitly specified
+          value will be ignored.
+    outerRadius : dict, float, :class:`ExprRef`
+        The outer radius in pixels of arc marks. ``outerRadius`` is an alias for ``radius``.
+
+        **Default value:** ``0``
+    padAngle : dict, float, :class:`ExprRef`
+        The angular padding applied to sides of the arc, in radians.
+    radius : dict, float, :class:`ExprRef`
+        For arc mark, the primary (outer) radius in pixels.
+
+        For text marks, polar coordinate radial offset, in pixels, of the text from the
+        origin determined by the ``x`` and ``y`` properties.
+
+        **Default value:** ``min(plot_width, plot_height)/2``
+    radius2 : dict, float, :class:`ExprRef`
+        The secondary (inner) radius in pixels of arc marks.
+
+        **Default value:** ``0``
+    shape : str, dict, :class:`ExprRef`, :class:`SymbolShape`
+        Shape of the point marks. Supported values include:
+
+
+        * plotting shapes: ``"circle"``, ``"square"``, ``"cross"``, ``"diamond"``,
+          ``"triangle-up"``, ``"triangle-down"``, ``"triangle-right"``, or
+          ``"triangle-left"``.
+        * the line symbol ``"stroke"``
+        * centered directional shapes ``"arrow"``, ``"wedge"``, or ``"triangle"``
+        * a custom `SVG path string
+          <https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths>`__ (For correct
+          sizing, custom shape paths should be defined within a square bounding box with
+          coordinates ranging from -1 to 1 along both the x and y dimensions.)
+
+        **Default value:** ``"circle"``
+    size : dict, float, :class:`ExprRef`
+        Default size for marks.
+
+
+        * For ``point`` / ``circle`` / ``square``, this represents the pixel area of the
+          marks. Note that this value sets the area of the symbol; the side lengths will
+          increase with the square root of this value.
+        * For ``bar``, this represents the band size of the bar, in pixels.
+        * For ``text``, this represents the font size, in pixels.
+
+        **Default value:**
+
+
+        * ``30`` for point, circle, square marks; width/height's ``step``
+        * ``2`` for bar marks with discrete dimensions;
+        * ``5`` for bar marks with continuous dimensions;
+        * ``11`` for text marks.
+    smooth : bool, dict, :class:`ExprRef`
+        A boolean flag (default true) indicating if the image should be smoothed when
+        resized. If false, individual pixels should be scaled directly rather than
+        interpolated with smoothing. For SVG rendering, this option may not work in some
+        browsers due to lack of standardization.
+    startAngle : dict, float, :class:`ExprRef`
+        The start angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    stroke : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default stroke color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove stroke.
+
+        **Default value:** (None)
+    strokeCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for line ending style. One of ``"butt"``, ``"round"``, or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    strokeDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating stroke, space lengths for creating dashed or dotted lines.
+    strokeDashOffset : dict, float, :class:`ExprRef`
+        The offset (in pixels) into which to begin drawing with the stroke dash array.
+    strokeJoin : dict, :class:`ExprRef`, :class:`StrokeJoin`, Literal['miter', 'round', 'bevel']
+        The stroke line join method. One of ``"miter"``, ``"round"`` or ``"bevel"``.
+
+        **Default value:** ``"miter"``
+    strokeMiterLimit : dict, float, :class:`ExprRef`
+        The miter limit at which to bevel a line join.
+    strokeOffset : dict, float, :class:`ExprRef`
+        The offset in pixels at which to draw the group stroke and fill. If unspecified, the
+        default behavior is to dynamically offset stroked groups such that 1 pixel stroke
+        widths align with the pixel grid.
+    strokeOpacity : dict, float, :class:`ExprRef`
+        The stroke opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    strokeWidth : dict, float, :class:`ExprRef`
+        The stroke width, in pixels.
+    tension : dict, float, :class:`ExprRef`
+        Depending on the interpolation type, sets the tension parameter (for line and area
+        marks).
+    text : str, dict, :class:`Text`, Sequence[str], :class:`ExprRef`
+        Placeholder text if the ``text`` channel is not specified
+    theta : dict, float, :class:`ExprRef`
+        For arc marks, the arc length in radians if theta2 is not specified, otherwise the
+        start arc angle. (A value of 0 indicates up or “north”, increasing values proceed
+        clockwise.)
+
+        For text marks, polar coordinate angle in radians.
+    theta2 : dict, float, :class:`ExprRef`
+        The end angle of arc marks in radians. A value of 0 indicates up or “north”,
+        increasing values proceed clockwise.
+    timeUnitBandPosition : float
+        Default relative band position for a time unit. If set to ``0``, the marks will be
+        positioned at the beginning of the time unit band step. If set to ``0.5``, the marks
+        will be positioned in the middle of the time unit band step.
+    timeUnitBandSize : float
+        Default relative band size for a time unit. If set to ``1``, the bandwidth of the
+        marks will be equal to the time unit band step. If set to ``0.5``, bandwidth of the
+        marks will be half of the time unit band step.
+    tooltip : str, bool, dict, None, float, :class:`ExprRef`, :class:`TooltipContent`
+        The tooltip text string to show upon mouse hover or an object defining which fields
+        should the tooltip be derived from.
+
+
+        * If ``tooltip`` is ``true`` or ``{"content": "encoding"}``, then all fields from
+          ``encoding`` will be used.
+        * If ``tooltip`` is ``{"content": "data"}``, then all fields that appear in the
+          highlighted data point will be used.
+        * If set to ``null`` or ``false``, then no tooltip will be used.
+
+        See the `tooltip <https://vega.github.io/vega-lite/docs/tooltip.html>`__
+        documentation for a detailed discussion about tooltip  in Vega-Lite.
+
+        **Default value:** ``null``
+    url : str, dict, :class:`URI`, :class:`ExprRef`
+        The URL of the image file for image marks.
+    width : dict, float, :class:`ExprRef`
+        Width of the marks.
+    x : str, dict, float, :class:`ExprRef`
+        X coordinates of the marks, or width of horizontal ``"bar"`` and ``"area"`` without
+        specified ``x2`` or ``width``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    x2 : str, dict, float, :class:`ExprRef`
+        X2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    y : str, dict, float, :class:`ExprRef`
+        Y coordinates of the marks, or height of vertical ``"bar"`` and ``"area"`` without
+        specified ``y2`` or ``height``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    y2 : str, dict, float, :class:`ExprRef`
+        Y2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    """
+
+    _schema = {"$ref": "#/definitions/MarkConfig"}
+
+    def __init__(
+        self,
+        align: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ariaRole: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        blend: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, "_Parameter", "SchemaBase", Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        dx: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        dy: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ellipsis: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        endAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        fontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        href: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        innerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineBreak: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            "SchemaBase", Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        shape: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        size: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        smooth: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        startAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tension: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, "_Parameter", "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        url: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        width: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(MarkConfig, self).__init__(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            baseline=baseline,
+            blend=blend,
+            color=color,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            endAngle=endAngle,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            radius=radius,
+            radius2=radius2,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            startAngle=startAngle,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            y=y,
+            y2=y2,
+            **kwds,
+        )
+
+
+class MarkDef(AnyMark):
+    """MarkDef schema wrapper
+
+    Parameters
+    ----------
+
+    type : :class:`Mark`, Literal['arc', 'area', 'bar', 'image', 'line', 'point', 'rect', 'rule', 'text', 'tick', 'trail', 'circle', 'square', 'geoshape']
+        The mark type. This could a primitive mark type (one of ``"bar"``, ``"circle"``,
+        ``"square"``, ``"tick"``, ``"line"``, ``"area"``, ``"point"``, ``"geoshape"``,
+        ``"rule"``, and ``"text"`` ) or a composite mark type ( ``"boxplot"``,
+        ``"errorband"``, ``"errorbar"`` ).
+    align : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule).
+        One of ``"left"``, ``"right"``, ``"center"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    angle : dict, float, :class:`ExprRef`
+        The rotation angle of the text, in degrees.
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG element, removing the mark item from the ARIA accessibility tree.
+    ariaRole : str, dict, :class:`ExprRef`
+        Sets the type of user interface element of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "role" attribute. Warning: this
+        property is experimental and may be changed in the future.
+    ariaRoleDescription : str, dict, :class:`ExprRef`
+        A human-readable, author-localized description for the role of the mark item for
+        `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "aria-roledescription" attribute.
+        Warning: this property is experimental and may be changed in the future.
+    aspect : bool, dict, :class:`ExprRef`
+        Whether to keep aspect ratio of image marks.
+    bandSize : float
+        The width of the ticks.
+
+        **Default value:**  3/4 of step (width step for horizontal ticks and height step for
+        vertical ticks).
+    baseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        For text marks, the vertical text baseline. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, ``"line-bottom"``, or an
+        expression reference that provides one of the valid values. The ``"line-top"`` and
+        ``"line-bottom"`` values operate similarly to ``"top"`` and ``"bottom"``, but are
+        calculated relative to the ``lineHeight`` rather than ``fontSize`` alone.
+
+        For range marks, the vertical alignment of the marks. One of ``"top"``,
+        ``"middle"``, ``"bottom"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    binSpacing : float
+        Offset between bars for binned field. The ideal value for this is either 0
+        (preferred by statisticians) or 1 (Vega-Lite default, D3 example style).
+
+        **Default value:** ``1``
+    blend : dict, :class:`Blend`, :class:`ExprRef`, Literal[None, 'multiply', 'screen', 'overlay', 'darken', 'lighten', 'color-dodge', 'color-burn', 'hard-light', 'soft-light', 'difference', 'exclusion', 'hue', 'saturation', 'color', 'luminosity']
+        The color blend mode for drawing an item on its current background. Any valid `CSS
+        mix-blend-mode <https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode>`__
+        value can be used.
+
+        __Default value:__ ``"source-over"``
+    clip : bool, dict, :class:`ExprRef`
+        Whether a mark be clipped to the enclosing group’s width and height.
+    color : str, dict, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default color.
+
+        **Default value:** :raw-html:`<span style="color: #4682b4;">&#9632;</span>`
+        ``"#4682b4"``
+
+        **Note:**
+
+
+        * This property cannot be used in a `style config
+          <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+        * The ``fill`` and ``stroke`` properties have higher precedence than ``color`` and
+          will override ``color``.
+    continuousBandSize : float
+        The default size of the bars on continuous scales.
+
+        **Default value:** ``5``
+    cornerRadius : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles or arcs' corners.
+
+        **Default value:** ``0``
+    cornerRadiusBottomLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom left corner.
+
+        **Default value:** ``0``
+    cornerRadiusBottomRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom right corner.
+
+        **Default value:** ``0``
+    cornerRadiusEnd : dict, float, :class:`ExprRef`
+        For vertical bars, top-left and top-right corner radius.
+
+        For horizontal bars, top-right and bottom-right corner radius.
+    cornerRadiusTopLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top left corner.
+
+        **Default value:** ``0``
+    cursor : dict, :class:`Cursor`, :class:`ExprRef`, Literal['auto', 'default', 'none', 'context-menu', 'help', 'pointer', 'progress', 'wait', 'cell', 'crosshair', 'text', 'vertical-text', 'alias', 'copy', 'move', 'no-drop', 'not-allowed', 'e-resize', 'n-resize', 'ne-resize', 'nw-resize', 's-resize', 'se-resize', 'sw-resize', 'w-resize', 'ew-resize', 'ns-resize', 'nesw-resize', 'nwse-resize', 'col-resize', 'row-resize', 'all-scroll', 'zoom-in', 'zoom-out', 'grab', 'grabbing']
+        The mouse cursor used over the mark. Any valid `CSS cursor type
+        <https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values>`__ can be used.
+    description : str, dict, :class:`ExprRef`
+        A text description of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the `"aria-label" attribute
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>`__.
+    dir : dict, :class:`ExprRef`, Literal['ltr', 'rtl'], :class:`TextDirection`
+        The direction of the text. One of ``"ltr"`` (left-to-right) or ``"rtl"``
+        (right-to-left). This property determines on which side is truncated in response to
+        the limit parameter.
+
+        **Default value:** ``"ltr"``
+    discreteBandSize : dict, float, :class:`RelativeBandSize`
+        The default size of the bars with discrete dimensions. If unspecified, the default
+        size is  ``step-2``, which provides 2 pixel offset between bars.
+    dx : dict, float, :class:`ExprRef`
+        The horizontal offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    dy : dict, float, :class:`ExprRef`
+        The vertical offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    ellipsis : str, dict, :class:`ExprRef`
+        The ellipsis string for text truncated in response to the limit parameter.
+
+        **Default value:** ``"…"``
+    fill : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default fill color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove fill.
+
+        **Default value:** (None)
+    fillOpacity : dict, float, :class:`ExprRef`
+        The fill opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    filled : bool
+        Whether the mark's color should be used as fill color instead of stroke color.
+
+        **Default value:** ``false`` for all ``point``, ``line``, and ``rule`` marks as well
+        as ``geoshape`` marks for `graticule
+        <https://vega.github.io/vega-lite/docs/data.html#graticule>`__ data sources;
+        otherwise, ``true``.
+
+        **Note:** This property cannot be used in a `style config
+        <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+    font : str, dict, :class:`ExprRef`
+        The typeface to set the text in (e.g., ``"Helvetica Neue"`` ).
+    fontSize : dict, float, :class:`ExprRef`
+        The font size, in pixels.
+
+        **Default value:** ``11``
+    fontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style (e.g., ``"italic"`` ).
+    fontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight. This can be either a string (e.g ``"bold"``, ``"normal"`` ) or a
+        number ( ``100``, ``200``, ``300``, ..., ``900`` where ``"normal"`` = ``400`` and
+        ``"bold"`` = ``700`` ).
+    height : dict, float, :class:`ExprRef`, :class:`RelativeBandSize`
+        Height of the marks.  One of:
+
+
+        A number representing a fixed pixel height.
+
+        A relative band size definition.  For example, ``{band: 0.5}`` represents half of
+        the band
+    href : str, dict, :class:`URI`, :class:`ExprRef`
+        A URL to load upon mouse click. If defined, the mark acts as a hyperlink.
+    innerRadius : dict, float, :class:`ExprRef`
+        The inner radius in pixels of arc marks. ``innerRadius`` is an alias for
+        ``radius2``.
+
+        **Default value:** ``0``
+    interpolate : dict, :class:`ExprRef`, :class:`Interpolate`, Literal['basis', 'basis-open', 'basis-closed', 'bundle', 'cardinal', 'cardinal-open', 'cardinal-closed', 'catmull-rom', 'linear', 'linear-closed', 'monotone', 'natural', 'step', 'step-before', 'step-after']
+        The line interpolation method to use for line and area marks. One of the following:
+
+
+        * ``"linear"`` : piecewise linear segments, as in a polyline.
+        * ``"linear-closed"`` : close the linear segments to form a polygon.
+        * ``"step"`` : alternate between horizontal and vertical segments, as in a step
+          function.
+        * ``"step-before"`` : alternate between vertical and horizontal segments, as in a
+          step function.
+        * ``"step-after"`` : alternate between horizontal and vertical segments, as in a
+          step function.
+        * ``"basis"`` : a B-spline, with control point duplication on the ends.
+        * ``"basis-open"`` : an open B-spline; may not intersect the start or end.
+        * ``"basis-closed"`` : a closed B-spline, as in a loop.
+        * ``"cardinal"`` : a Cardinal spline, with control point duplication on the ends.
+        * ``"cardinal-open"`` : an open Cardinal spline; may not intersect the start or end,
+          but will intersect other control points.
+        * ``"cardinal-closed"`` : a closed Cardinal spline, as in a loop.
+        * ``"bundle"`` : equivalent to basis, except the tension parameter is used to
+          straighten the spline.
+        * ``"monotone"`` : cubic interpolation that preserves monotonicity in y.
+    invalid : Literal['filter', None]
+        Defines how Vega-Lite should handle marks for invalid values ( ``null`` and ``NaN``
+        ).
+
+
+        * If set to ``"filter"`` (default), all data items with null values will be skipped
+          (for line, trail, and area marks) or filtered (for other marks).
+        * If ``null``, all data items are included. In this case, invalid values will be
+          interpreted as zeroes.
+    limit : dict, float, :class:`ExprRef`
+        The maximum length of the text mark in pixels. The text value will be automatically
+        truncated if the rendered size exceeds the limit.
+
+        **Default value:** ``0`` -- indicating no limit
+    line : bool, dict, :class:`OverlayMarkDef`
+        A flag for overlaying line on top of area marks, or an object defining the
+        properties of the overlayed lines.
+
+
+        If this value is an empty object ( ``{}`` ) or ``true``, lines with default
+        properties will be used.
+
+        If this value is ``false``, no lines would be automatically added to area marks.
+
+        **Default value:** ``false``.
+    lineBreak : str, dict, :class:`ExprRef`
+        A delimiter, such as a newline character, upon which to break text strings into
+        multiple lines. This property is ignored if the text is array-valued.
+    lineHeight : dict, float, :class:`ExprRef`
+        The line height in pixels (the spacing between subsequent lines of text) for
+        multi-line text marks.
+    minBandSize : dict, float, :class:`ExprRef`
+        The minimum band size for bar and rectangle marks. **Default value:** ``0.25``
+    opacity : dict, float, :class:`ExprRef`
+        The overall opacity (value between [0,1]).
+
+        **Default value:** ``0.7`` for non-aggregate plots with ``point``, ``tick``,
+        ``circle``, or ``square`` marks or layered ``bar`` charts and ``1`` otherwise.
+    order : bool, None
+        For line and trail marks, this ``order`` property can be set to ``null`` or
+        ``false`` to make the lines use the original order in the data sources.
+    orient : :class:`Orientation`, Literal['horizontal', 'vertical']
+        The orientation of a non-stacked bar, tick, area, and line charts. The value is
+        either horizontal (default) or vertical.
+
+
+        * For bar, rule and tick, this determines whether the size of the bar and tick
+          should be applied to x or y dimension.
+        * For area, this property determines the orient property of the Vega output.
+        * For line and trail marks, this property determines the sort order of the points in
+          the line if ``config.sortLineBy`` is not specified. For stacked charts, this is
+          always determined by the orientation of the stack; therefore explicitly specified
+          value will be ignored.
+    outerRadius : dict, float, :class:`ExprRef`
+        The outer radius in pixels of arc marks. ``outerRadius`` is an alias for ``radius``.
+
+        **Default value:** ``0``
+    padAngle : dict, float, :class:`ExprRef`
+        The angular padding applied to sides of the arc, in radians.
+    point : str, bool, dict, :class:`OverlayMarkDef`
+        A flag for overlaying points on top of line or area marks, or an object defining the
+        properties of the overlayed points.
+
+
+        If this property is ``"transparent"``, transparent points will be used (for
+        enhancing tooltips and selections).
+
+        If this property is an empty object ( ``{}`` ) or ``true``, filled points with
+        default properties will be used.
+
+        If this property is ``false``, no points would be automatically added to line or
+        area marks.
+
+        **Default value:** ``false``.
+    radius : dict, float, :class:`ExprRef`
+        For arc mark, the primary (outer) radius in pixels.
+
+        For text marks, polar coordinate radial offset, in pixels, of the text from the
+        origin determined by the ``x`` and ``y`` properties.
+
+        **Default value:** ``min(plot_width, plot_height)/2``
+    radius2 : dict, float, :class:`ExprRef`
+        The secondary (inner) radius in pixels of arc marks.
+
+        **Default value:** ``0``
+    radius2Offset : dict, float, :class:`ExprRef`
+        Offset for radius2.
+    radiusOffset : dict, float, :class:`ExprRef`
+        Offset for radius.
+    shape : str, dict, :class:`ExprRef`, :class:`SymbolShape`
+        Shape of the point marks. Supported values include:
+
+
+        * plotting shapes: ``"circle"``, ``"square"``, ``"cross"``, ``"diamond"``,
+          ``"triangle-up"``, ``"triangle-down"``, ``"triangle-right"``, or
+          ``"triangle-left"``.
+        * the line symbol ``"stroke"``
+        * centered directional shapes ``"arrow"``, ``"wedge"``, or ``"triangle"``
+        * a custom `SVG path string
+          <https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths>`__ (For correct
+          sizing, custom shape paths should be defined within a square bounding box with
+          coordinates ranging from -1 to 1 along both the x and y dimensions.)
+
+        **Default value:** ``"circle"``
+    size : dict, float, :class:`ExprRef`
+        Default size for marks.
+
+
+        * For ``point`` / ``circle`` / ``square``, this represents the pixel area of the
+          marks. Note that this value sets the area of the symbol; the side lengths will
+          increase with the square root of this value.
+        * For ``bar``, this represents the band size of the bar, in pixels.
+        * For ``text``, this represents the font size, in pixels.
+
+        **Default value:**
+
+
+        * ``30`` for point, circle, square marks; width/height's ``step``
+        * ``2`` for bar marks with discrete dimensions;
+        * ``5`` for bar marks with continuous dimensions;
+        * ``11`` for text marks.
+    smooth : bool, dict, :class:`ExprRef`
+        A boolean flag (default true) indicating if the image should be smoothed when
+        resized. If false, individual pixels should be scaled directly rather than
+        interpolated with smoothing. For SVG rendering, this option may not work in some
+        browsers due to lack of standardization.
+    stroke : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default stroke color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove stroke.
+
+        **Default value:** (None)
+    strokeCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for line ending style. One of ``"butt"``, ``"round"``, or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    strokeDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating stroke, space lengths for creating dashed or dotted lines.
+    strokeDashOffset : dict, float, :class:`ExprRef`
+        The offset (in pixels) into which to begin drawing with the stroke dash array.
+    strokeJoin : dict, :class:`ExprRef`, :class:`StrokeJoin`, Literal['miter', 'round', 'bevel']
+        The stroke line join method. One of ``"miter"``, ``"round"`` or ``"bevel"``.
+
+        **Default value:** ``"miter"``
+    strokeMiterLimit : dict, float, :class:`ExprRef`
+        The miter limit at which to bevel a line join.
+    strokeOffset : dict, float, :class:`ExprRef`
+        The offset in pixels at which to draw the group stroke and fill. If unspecified, the
+        default behavior is to dynamically offset stroked groups such that 1 pixel stroke
+        widths align with the pixel grid.
+    strokeOpacity : dict, float, :class:`ExprRef`
+        The stroke opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    strokeWidth : dict, float, :class:`ExprRef`
+        The stroke width, in pixels.
+    style : str, Sequence[str]
+        A string or array of strings indicating the name of custom styles to apply to the
+        mark. A style is a named collection of mark property defaults defined within the
+        `style configuration
+        <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__. If style is an
+        array, later styles will override earlier styles. Any `mark properties
+        <https://vega.github.io/vega-lite/docs/encoding.html#mark-prop>`__ explicitly
+        defined within the ``encoding`` will override a style default.
+
+        **Default value:** The mark's name. For example, a bar mark will have style
+        ``"bar"`` by default. **Note:** Any specified style will augment the default style.
+        For example, a bar mark with ``"style": "foo"`` will receive from
+        ``config.style.bar`` and ``config.style.foo`` (the specified style ``"foo"`` has
+        higher precedence).
+    tension : dict, float, :class:`ExprRef`
+        Depending on the interpolation type, sets the tension parameter (for line and area
+        marks).
+    text : str, dict, :class:`Text`, Sequence[str], :class:`ExprRef`
+        Placeholder text if the ``text`` channel is not specified
+    theta : dict, float, :class:`ExprRef`
+        For arc marks, the arc length in radians if theta2 is not specified, otherwise the
+        start arc angle. (A value of 0 indicates up or “north”, increasing values proceed
+        clockwise.)
+
+        For text marks, polar coordinate angle in radians.
+    theta2 : dict, float, :class:`ExprRef`
+        The end angle of arc marks in radians. A value of 0 indicates up or “north”,
+        increasing values proceed clockwise.
+    theta2Offset : dict, float, :class:`ExprRef`
+        Offset for theta2.
+    thetaOffset : dict, float, :class:`ExprRef`
+        Offset for theta.
+    thickness : float
+        Thickness of the tick mark.
+
+        **Default value:**  ``1``
+    timeUnitBandPosition : float
+        Default relative band position for a time unit. If set to ``0``, the marks will be
+        positioned at the beginning of the time unit band step. If set to ``0.5``, the marks
+        will be positioned in the middle of the time unit band step.
+    timeUnitBandSize : float
+        Default relative band size for a time unit. If set to ``1``, the bandwidth of the
+        marks will be equal to the time unit band step. If set to ``0.5``, bandwidth of the
+        marks will be half of the time unit band step.
+    tooltip : str, bool, dict, None, float, :class:`ExprRef`, :class:`TooltipContent`
+        The tooltip text string to show upon mouse hover or an object defining which fields
+        should the tooltip be derived from.
+
+
+        * If ``tooltip`` is ``true`` or ``{"content": "encoding"}``, then all fields from
+          ``encoding`` will be used.
+        * If ``tooltip`` is ``{"content": "data"}``, then all fields that appear in the
+          highlighted data point will be used.
+        * If set to ``null`` or ``false``, then no tooltip will be used.
+
+        See the `tooltip <https://vega.github.io/vega-lite/docs/tooltip.html>`__
+        documentation for a detailed discussion about tooltip  in Vega-Lite.
+
+        **Default value:** ``null``
+    url : str, dict, :class:`URI`, :class:`ExprRef`
+        The URL of the image file for image marks.
+    width : dict, float, :class:`ExprRef`, :class:`RelativeBandSize`
+        Width of the marks.  One of:
+
+
+        A number representing a fixed pixel width.
+
+        A relative band size definition.  For example, ``{band: 0.5}`` represents half of
+        the band.
+    x : str, dict, float, :class:`ExprRef`
+        X coordinates of the marks, or width of horizontal ``"bar"`` and ``"area"`` without
+        specified ``x2`` or ``width``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    x2 : str, dict, float, :class:`ExprRef`
+        X2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    x2Offset : dict, float, :class:`ExprRef`
+        Offset for x2-position.
+    xOffset : dict, float, :class:`ExprRef`
+        Offset for x-position.
+    y : str, dict, float, :class:`ExprRef`
+        Y coordinates of the marks, or height of vertical ``"bar"`` and ``"area"`` without
+        specified ``y2`` or ``height``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    y2 : str, dict, float, :class:`ExprRef`
+        Y2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    y2Offset : dict, float, :class:`ExprRef`
+        Offset for y2-position.
+    yOffset : dict, float, :class:`ExprRef`
+        Offset for y-position.
+    """
+
+    _schema = {"$ref": "#/definitions/MarkDef"}
+
+    def __init__(
+        self,
+        type: Union[
+            "SchemaBase",
+            Literal[
+                "arc",
+                "area",
+                "bar",
+                "image",
+                "line",
+                "point",
+                "rect",
+                "rule",
+                "text",
+                "tick",
+                "trail",
+                "circle",
+                "square",
+                "geoshape",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        align: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ariaRole: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        color: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, "_Parameter", "SchemaBase", Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[dict, float, "SchemaBase", UndefinedType] = Undefined,
+        dx: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        dy: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ellipsis: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        fontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        href: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        innerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            "SchemaBase", Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        shape: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        size: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        smooth: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, "_Parameter", "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        url: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        width: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(MarkDef, self).__init__(
+            type=type,
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+
+
+class MarkPropDefGradientstringnull(VegaLiteSchema):
+    """MarkPropDefGradientstringnull schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/MarkPropDef<(Gradient|string|null)>"}
+
+    def __init__(self, *args, **kwds):
+        super(MarkPropDefGradientstringnull, self).__init__(*args, **kwds)
+
+
+class FieldOrDatumDefWithConditionDatumDefGradientstringnull(
+    ColorDef, MarkPropDefGradientstringnull
+):
+    """FieldOrDatumDefWithConditionDatumDefGradientstringnull schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {
+        "$ref": "#/definitions/FieldOrDatumDefWithCondition<DatumDef,(Gradient|string|null)>"
+    }
+
+    def __init__(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        datum: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldOrDatumDefWithConditionDatumDefGradientstringnull, self).__init__(
+            bandPosition=bandPosition,
+            condition=condition,
+            datum=datum,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull(
+    ColorDef, MarkPropDefGradientstringnull
+):
+    """FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {
+        "$ref": "#/definitions/FieldOrDatumDefWithCondition<MarkPropFieldDef,(Gradient|string|null)>"
+    }
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        legend: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        scale: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, "SchemaBase"]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(
+            FieldOrDatumDefWithConditionMarkPropFieldDefGradientstringnull, self
+        ).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class MarkPropDefnumber(VegaLiteSchema):
+    """MarkPropDefnumber schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/MarkPropDef<number>"}
+
+    def __init__(self, *args, **kwds):
+        super(MarkPropDefnumber, self).__init__(*args, **kwds)
+
+
+class MarkPropDefnumberArray(VegaLiteSchema):
+    """MarkPropDefnumberArray schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/MarkPropDef<number[]>"}
+
+    def __init__(self, *args, **kwds):
+        super(MarkPropDefnumberArray, self).__init__(*args, **kwds)
+
+
+class MarkPropDefstringnullTypeForShape(VegaLiteSchema):
+    """MarkPropDefstringnullTypeForShape schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/MarkPropDef<(string|null),TypeForShape>"}
+
+    def __init__(self, *args, **kwds):
+        super(MarkPropDefstringnullTypeForShape, self).__init__(*args, **kwds)
+
+
+class MarkType(VegaLiteSchema):
+    """MarkType schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/MarkType"}
+
+    def __init__(self, *args):
+        super(MarkType, self).__init__(*args)
+
+
+class Month(VegaLiteSchema):
+    """Month schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Month"}
+
+    def __init__(self, *args):
+        super(Month, self).__init__(*args)
+
+
+class MultiLineString(Geometry):
+    """MultiLineString schema wrapper
+    MultiLineString geometry object. https://tools.ietf.org/html/rfc7946#section-3.1.5
+
+    Parameters
+    ----------
+
+    coordinates : Sequence[Sequence[Sequence[float], :class:`Position`]]
+
+    type : str
+        Specifies the type of GeoJSON object.
+    bbox : :class:`BBox`, Sequence[float]
+        Bounding box of the coordinate range of the object's Geometries, Features, or
+        Feature Collections. https://tools.ietf.org/html/rfc7946#section-5
+    """
+
+    _schema = {"$ref": "#/definitions/MultiLineString"}
+
+    def __init__(
+        self,
+        coordinates: Union[
+            Sequence[Sequence[Union["SchemaBase", Sequence[float]]]], UndefinedType
+        ] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        bbox: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(MultiLineString, self).__init__(
+            coordinates=coordinates, type=type, bbox=bbox, **kwds
+        )
+
+
+class MultiPoint(Geometry):
+    """MultiPoint schema wrapper
+    MultiPoint geometry object.  https://tools.ietf.org/html/rfc7946#section-3.1.3
+
+    Parameters
+    ----------
+
+    coordinates : Sequence[Sequence[float], :class:`Position`]
+
+    type : str
+        Specifies the type of GeoJSON object.
+    bbox : :class:`BBox`, Sequence[float]
+        Bounding box of the coordinate range of the object's Geometries, Features, or
+        Feature Collections. https://tools.ietf.org/html/rfc7946#section-5
+    """
+
+    _schema = {"$ref": "#/definitions/MultiPoint"}
+
+    def __init__(
+        self,
+        coordinates: Union[
+            Sequence[Union["SchemaBase", Sequence[float]]], UndefinedType
+        ] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        bbox: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(MultiPoint, self).__init__(
+            coordinates=coordinates, type=type, bbox=bbox, **kwds
+        )
+
+
+class MultiPolygon(Geometry):
+    """MultiPolygon schema wrapper
+    MultiPolygon geometry object. https://tools.ietf.org/html/rfc7946#section-3.1.7
+
+    Parameters
+    ----------
+
+    coordinates : Sequence[Sequence[Sequence[Sequence[float], :class:`Position`]]]
+
+    type : str
+        Specifies the type of GeoJSON object.
+    bbox : :class:`BBox`, Sequence[float]
+        Bounding box of the coordinate range of the object's Geometries, Features, or
+        Feature Collections. https://tools.ietf.org/html/rfc7946#section-5
+    """
+
+    _schema = {"$ref": "#/definitions/MultiPolygon"}
+
+    def __init__(
+        self,
+        coordinates: Union[
+            Sequence[Sequence[Sequence[Union["SchemaBase", Sequence[float]]]]],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        bbox: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(MultiPolygon, self).__init__(
+            coordinates=coordinates, type=type, bbox=bbox, **kwds
+        )
+
+
+class NamedData(DataSource):
+    """NamedData schema wrapper
+
+    Parameters
+    ----------
+
+    name : str
+        Provide a placeholder name and bind data at runtime.
+
+        New data may change the layout but Vega does not always resize the chart. To update
+        the layout when the data updates, set `autosize
+        <https://vega.github.io/vega-lite/docs/size.html#autosize>`__ or explicitly use
+        `view.resize <https://vega.github.io/vega/docs/api/view/#view_resize>`__.
+    format : dict, :class:`DataFormat`, :class:`CsvDataFormat`, :class:`DsvDataFormat`, :class:`JsonDataFormat`, :class:`TopoDataFormat`
+        An object that specifies the format for parsing the data.
+    """
+
+    _schema = {"$ref": "#/definitions/NamedData"}
+
+    def __init__(
+        self,
+        name: Union[str, UndefinedType] = Undefined,
+        format: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(NamedData, self).__init__(name=name, format=format, **kwds)
+
+
+class NonArgAggregateOp(Aggregate):
+    """NonArgAggregateOp schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/NonArgAggregateOp"}
+
+    def __init__(self, *args):
+        super(NonArgAggregateOp, self).__init__(*args)
+
+
+class NonNormalizedSpec(VegaLiteSchema):
+    """NonNormalizedSpec schema wrapper
+    Any specification in Vega-Lite.
+    """
+
+    _schema = {"$ref": "#/definitions/NonNormalizedSpec"}
+
+    def __init__(self, *args, **kwds):
+        super(NonNormalizedSpec, self).__init__(*args, **kwds)
+
+
+class NumberLocale(VegaLiteSchema):
+    """NumberLocale schema wrapper
+    Locale definition for formatting numbers.
+
+    Parameters
+    ----------
+
+    currency : Sequence[str], :class:`Vector2string`
+        The currency prefix and suffix (e.g., ["$", ""]).
+    decimal : str
+        The decimal point (e.g., ".").
+    grouping : Sequence[float]
+        The array of group sizes (e.g., [3]), cycled as needed.
+    thousands : str
+        The group separator (e.g., ",").
+    minus : str
+        The minus sign (defaults to hyphen-minus, "-").
+    nan : str
+        The not-a-number value (defaults to "NaN").
+    numerals : Sequence[str], :class:`Vector10string`
+        An array of ten strings to replace the numerals 0-9.
+    percent : str
+        The percent sign (defaults to "%").
+    """
+
+    _schema = {"$ref": "#/definitions/NumberLocale"}
+
+    def __init__(
+        self,
+        currency: Union["SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        decimal: Union[str, UndefinedType] = Undefined,
+        grouping: Union[Sequence[float], UndefinedType] = Undefined,
+        thousands: Union[str, UndefinedType] = Undefined,
+        minus: Union[str, UndefinedType] = Undefined,
+        nan: Union[str, UndefinedType] = Undefined,
+        numerals: Union["SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        percent: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(NumberLocale, self).__init__(
+            currency=currency,
+            decimal=decimal,
+            grouping=grouping,
+            thousands=thousands,
+            minus=minus,
+            nan=nan,
+            numerals=numerals,
+            percent=percent,
+            **kwds,
+        )
+
+
+class NumericArrayMarkPropDef(VegaLiteSchema):
+    """NumericArrayMarkPropDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/NumericArrayMarkPropDef"}
+
+    def __init__(self, *args, **kwds):
+        super(NumericArrayMarkPropDef, self).__init__(*args, **kwds)
+
+
+class FieldOrDatumDefWithConditionDatumDefnumberArray(
+    MarkPropDefnumberArray, NumericArrayMarkPropDef
+):
+    """FieldOrDatumDefWithConditionDatumDefnumberArray schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefnumberArrayExprRef`, :class:`ConditionalParameterValueDefnumberArrayExprRef`, :class:`ConditionalPredicateValueDefnumberArrayExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberArrayExprRef`, :class:`ConditionalParameterValueDefnumberArrayExprRef`, :class:`ConditionalPredicateValueDefnumberArrayExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/FieldOrDatumDefWithCondition<DatumDef,number[]>"}
+
+    def __init__(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        datum: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldOrDatumDefWithConditionDatumDefnumberArray, self).__init__(
+            bandPosition=bandPosition,
+            condition=condition,
+            datum=datum,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class FieldOrDatumDefWithConditionMarkPropFieldDefnumberArray(
+    MarkPropDefnumberArray, NumericArrayMarkPropDef
+):
+    """FieldOrDatumDefWithConditionMarkPropFieldDefnumberArray schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefnumberArrayExprRef`, :class:`ConditionalParameterValueDefnumberArrayExprRef`, :class:`ConditionalPredicateValueDefnumberArrayExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberArrayExprRef`, :class:`ConditionalParameterValueDefnumberArrayExprRef`, :class:`ConditionalPredicateValueDefnumberArrayExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {
+        "$ref": "#/definitions/FieldOrDatumDefWithCondition<MarkPropFieldDef,number[]>"
+    }
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        legend: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        scale: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, "SchemaBase"]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldOrDatumDefWithConditionMarkPropFieldDefnumberArray, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class NumericMarkPropDef(VegaLiteSchema):
+    """NumericMarkPropDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/NumericMarkPropDef"}
+
+    def __init__(self, *args, **kwds):
+        super(NumericMarkPropDef, self).__init__(*args, **kwds)
+
+
+class FieldOrDatumDefWithConditionDatumDefnumber(MarkPropDefnumber, NumericMarkPropDef):
+    """FieldOrDatumDefWithConditionDatumDefnumber schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/FieldOrDatumDefWithCondition<DatumDef,number>"}
+
+    def __init__(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        datum: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldOrDatumDefWithConditionDatumDefnumber, self).__init__(
+            bandPosition=bandPosition,
+            condition=condition,
+            datum=datum,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class FieldOrDatumDefWithConditionMarkPropFieldDefnumber(
+    MarkPropDefnumber, NumericMarkPropDef
+):
+    """FieldOrDatumDefWithConditionMarkPropFieldDefnumber schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {
+        "$ref": "#/definitions/FieldOrDatumDefWithCondition<MarkPropFieldDef,number>"
+    }
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        legend: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        scale: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, "SchemaBase"]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldOrDatumDefWithConditionMarkPropFieldDefnumber, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class OffsetDef(VegaLiteSchema):
+    """OffsetDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/OffsetDef"}
+
+    def __init__(self, *args, **kwds):
+        super(OffsetDef, self).__init__(*args, **kwds)
+
+
+class OrderFieldDef(VegaLiteSchema):
+    """OrderFieldDef schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    sort : :class:`SortOrder`, Literal['ascending', 'descending']
+        The sort order. One of ``"ascending"`` (default) or ``"descending"``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/OrderFieldDef"}
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        sort: Union[
+            "SchemaBase", Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(OrderFieldDef, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class OrderOnlyDef(VegaLiteSchema):
+    """OrderOnlyDef schema wrapper
+
+    Parameters
+    ----------
+
+    sort : :class:`SortOrder`, Literal['ascending', 'descending']
+        The sort order. One of ``"ascending"`` (default) or ``"descending"``.
+    """
+
+    _schema = {"$ref": "#/definitions/OrderOnlyDef"}
+
+    def __init__(
+        self,
+        sort: Union[
+            "SchemaBase", Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(OrderOnlyDef, self).__init__(sort=sort, **kwds)
+
+
+class OrderValueDef(VegaLiteSchema):
+    """OrderValueDef schema wrapper
+
+    Parameters
+    ----------
+
+    value : dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    condition : dict, :class:`ConditionalValueDefnumber`, :class:`ConditionalParameterValueDefnumber`, :class:`ConditionalPredicateValueDefnumber`, Sequence[dict, :class:`ConditionalValueDefnumber`, :class:`ConditionalParameterValueDefnumber`, :class:`ConditionalPredicateValueDefnumber`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    """
+
+    _schema = {"$ref": "#/definitions/OrderValueDef"}
+
+    def __init__(
+        self,
+        value: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(OrderValueDef, self).__init__(value=value, condition=condition, **kwds)
+
+
+class Orient(VegaLiteSchema):
+    """Orient schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Orient"}
+
+    def __init__(self, *args):
+        super(Orient, self).__init__(*args)
+
+
+class Orientation(VegaLiteSchema):
+    """Orientation schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Orientation"}
+
+    def __init__(self, *args):
+        super(Orientation, self).__init__(*args)
+
+
+class OverlayMarkDef(VegaLiteSchema):
+    """OverlayMarkDef schema wrapper
+
+    Parameters
+    ----------
+
+    align : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule).
+        One of ``"left"``, ``"right"``, ``"center"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    angle : dict, float, :class:`ExprRef`
+        The rotation angle of the text, in degrees.
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG element, removing the mark item from the ARIA accessibility tree.
+    ariaRole : str, dict, :class:`ExprRef`
+        Sets the type of user interface element of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "role" attribute. Warning: this
+        property is experimental and may be changed in the future.
+    ariaRoleDescription : str, dict, :class:`ExprRef`
+        A human-readable, author-localized description for the role of the mark item for
+        `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "aria-roledescription" attribute.
+        Warning: this property is experimental and may be changed in the future.
+    aspect : bool, dict, :class:`ExprRef`
+        Whether to keep aspect ratio of image marks.
+    baseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        For text marks, the vertical text baseline. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, ``"line-bottom"``, or an
+        expression reference that provides one of the valid values. The ``"line-top"`` and
+        ``"line-bottom"`` values operate similarly to ``"top"`` and ``"bottom"``, but are
+        calculated relative to the ``lineHeight`` rather than ``fontSize`` alone.
+
+        For range marks, the vertical alignment of the marks. One of ``"top"``,
+        ``"middle"``, ``"bottom"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    blend : dict, :class:`Blend`, :class:`ExprRef`, Literal[None, 'multiply', 'screen', 'overlay', 'darken', 'lighten', 'color-dodge', 'color-burn', 'hard-light', 'soft-light', 'difference', 'exclusion', 'hue', 'saturation', 'color', 'luminosity']
+        The color blend mode for drawing an item on its current background. Any valid `CSS
+        mix-blend-mode <https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode>`__
+        value can be used.
+
+        __Default value:__ ``"source-over"``
+    clip : bool, dict, :class:`ExprRef`
+        Whether a mark be clipped to the enclosing group’s width and height.
+    color : str, dict, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default color.
+
+        **Default value:** :raw-html:`<span style="color: #4682b4;">&#9632;</span>`
+        ``"#4682b4"``
+
+        **Note:**
+
+
+        * This property cannot be used in a `style config
+          <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+        * The ``fill`` and ``stroke`` properties have higher precedence than ``color`` and
+          will override ``color``.
+    cornerRadius : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles or arcs' corners.
+
+        **Default value:** ``0``
+    cornerRadiusBottomLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom left corner.
+
+        **Default value:** ``0``
+    cornerRadiusBottomRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top left corner.
+
+        **Default value:** ``0``
+    cursor : dict, :class:`Cursor`, :class:`ExprRef`, Literal['auto', 'default', 'none', 'context-menu', 'help', 'pointer', 'progress', 'wait', 'cell', 'crosshair', 'text', 'vertical-text', 'alias', 'copy', 'move', 'no-drop', 'not-allowed', 'e-resize', 'n-resize', 'ne-resize', 'nw-resize', 's-resize', 'se-resize', 'sw-resize', 'w-resize', 'ew-resize', 'ns-resize', 'nesw-resize', 'nwse-resize', 'col-resize', 'row-resize', 'all-scroll', 'zoom-in', 'zoom-out', 'grab', 'grabbing']
+        The mouse cursor used over the mark. Any valid `CSS cursor type
+        <https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values>`__ can be used.
+    description : str, dict, :class:`ExprRef`
+        A text description of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the `"aria-label" attribute
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>`__.
+    dir : dict, :class:`ExprRef`, Literal['ltr', 'rtl'], :class:`TextDirection`
+        The direction of the text. One of ``"ltr"`` (left-to-right) or ``"rtl"``
+        (right-to-left). This property determines on which side is truncated in response to
+        the limit parameter.
+
+        **Default value:** ``"ltr"``
+    dx : dict, float, :class:`ExprRef`
+        The horizontal offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    dy : dict, float, :class:`ExprRef`
+        The vertical offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    ellipsis : str, dict, :class:`ExprRef`
+        The ellipsis string for text truncated in response to the limit parameter.
+
+        **Default value:** ``"…"``
+    endAngle : dict, float, :class:`ExprRef`
+        The end angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    fill : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default fill color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove fill.
+
+        **Default value:** (None)
+    fillOpacity : dict, float, :class:`ExprRef`
+        The fill opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    filled : bool
+        Whether the mark's color should be used as fill color instead of stroke color.
+
+        **Default value:** ``false`` for all ``point``, ``line``, and ``rule`` marks as well
+        as ``geoshape`` marks for `graticule
+        <https://vega.github.io/vega-lite/docs/data.html#graticule>`__ data sources;
+        otherwise, ``true``.
+
+        **Note:** This property cannot be used in a `style config
+        <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+    font : str, dict, :class:`ExprRef`
+        The typeface to set the text in (e.g., ``"Helvetica Neue"`` ).
+    fontSize : dict, float, :class:`ExprRef`
+        The font size, in pixels.
+
+        **Default value:** ``11``
+    fontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style (e.g., ``"italic"`` ).
+    fontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight. This can be either a string (e.g ``"bold"``, ``"normal"`` ) or a
+        number ( ``100``, ``200``, ``300``, ..., ``900`` where ``"normal"`` = ``400`` and
+        ``"bold"`` = ``700`` ).
+    height : dict, float, :class:`ExprRef`
+        Height of the marks.
+    href : str, dict, :class:`URI`, :class:`ExprRef`
+        A URL to load upon mouse click. If defined, the mark acts as a hyperlink.
+    innerRadius : dict, float, :class:`ExprRef`
+        The inner radius in pixels of arc marks. ``innerRadius`` is an alias for
+        ``radius2``.
+
+        **Default value:** ``0``
+    interpolate : dict, :class:`ExprRef`, :class:`Interpolate`, Literal['basis', 'basis-open', 'basis-closed', 'bundle', 'cardinal', 'cardinal-open', 'cardinal-closed', 'catmull-rom', 'linear', 'linear-closed', 'monotone', 'natural', 'step', 'step-before', 'step-after']
+        The line interpolation method to use for line and area marks. One of the following:
+
+
+        * ``"linear"`` : piecewise linear segments, as in a polyline.
+        * ``"linear-closed"`` : close the linear segments to form a polygon.
+        * ``"step"`` : alternate between horizontal and vertical segments, as in a step
+          function.
+        * ``"step-before"`` : alternate between vertical and horizontal segments, as in a
+          step function.
+        * ``"step-after"`` : alternate between horizontal and vertical segments, as in a
+          step function.
+        * ``"basis"`` : a B-spline, with control point duplication on the ends.
+        * ``"basis-open"`` : an open B-spline; may not intersect the start or end.
+        * ``"basis-closed"`` : a closed B-spline, as in a loop.
+        * ``"cardinal"`` : a Cardinal spline, with control point duplication on the ends.
+        * ``"cardinal-open"`` : an open Cardinal spline; may not intersect the start or end,
+          but will intersect other control points.
+        * ``"cardinal-closed"`` : a closed Cardinal spline, as in a loop.
+        * ``"bundle"`` : equivalent to basis, except the tension parameter is used to
+          straighten the spline.
+        * ``"monotone"`` : cubic interpolation that preserves monotonicity in y.
+    invalid : Literal['filter', None]
+        Defines how Vega-Lite should handle marks for invalid values ( ``null`` and ``NaN``
+        ).
+
+
+        * If set to ``"filter"`` (default), all data items with null values will be skipped
+          (for line, trail, and area marks) or filtered (for other marks).
+        * If ``null``, all data items are included. In this case, invalid values will be
+          interpreted as zeroes.
+    limit : dict, float, :class:`ExprRef`
+        The maximum length of the text mark in pixels. The text value will be automatically
+        truncated if the rendered size exceeds the limit.
+
+        **Default value:** ``0`` -- indicating no limit
+    lineBreak : str, dict, :class:`ExprRef`
+        A delimiter, such as a newline character, upon which to break text strings into
+        multiple lines. This property is ignored if the text is array-valued.
+    lineHeight : dict, float, :class:`ExprRef`
+        The line height in pixels (the spacing between subsequent lines of text) for
+        multi-line text marks.
+    opacity : dict, float, :class:`ExprRef`
+        The overall opacity (value between [0,1]).
+
+        **Default value:** ``0.7`` for non-aggregate plots with ``point``, ``tick``,
+        ``circle``, or ``square`` marks or layered ``bar`` charts and ``1`` otherwise.
+    order : bool, None
+        For line and trail marks, this ``order`` property can be set to ``null`` or
+        ``false`` to make the lines use the original order in the data sources.
+    orient : :class:`Orientation`, Literal['horizontal', 'vertical']
+        The orientation of a non-stacked bar, tick, area, and line charts. The value is
+        either horizontal (default) or vertical.
+
+
+        * For bar, rule and tick, this determines whether the size of the bar and tick
+          should be applied to x or y dimension.
+        * For area, this property determines the orient property of the Vega output.
+        * For line and trail marks, this property determines the sort order of the points in
+          the line if ``config.sortLineBy`` is not specified. For stacked charts, this is
+          always determined by the orientation of the stack; therefore explicitly specified
+          value will be ignored.
+    outerRadius : dict, float, :class:`ExprRef`
+        The outer radius in pixels of arc marks. ``outerRadius`` is an alias for ``radius``.
+
+        **Default value:** ``0``
+    padAngle : dict, float, :class:`ExprRef`
+        The angular padding applied to sides of the arc, in radians.
+    radius : dict, float, :class:`ExprRef`
+        For arc mark, the primary (outer) radius in pixels.
+
+        For text marks, polar coordinate radial offset, in pixels, of the text from the
+        origin determined by the ``x`` and ``y`` properties.
+
+        **Default value:** ``min(plot_width, plot_height)/2``
+    radius2 : dict, float, :class:`ExprRef`
+        The secondary (inner) radius in pixels of arc marks.
+
+        **Default value:** ``0``
+    radius2Offset : dict, float, :class:`ExprRef`
+        Offset for radius2.
+    radiusOffset : dict, float, :class:`ExprRef`
+        Offset for radius.
+    shape : str, dict, :class:`ExprRef`, :class:`SymbolShape`
+        Shape of the point marks. Supported values include:
+
+
+        * plotting shapes: ``"circle"``, ``"square"``, ``"cross"``, ``"diamond"``,
+          ``"triangle-up"``, ``"triangle-down"``, ``"triangle-right"``, or
+          ``"triangle-left"``.
+        * the line symbol ``"stroke"``
+        * centered directional shapes ``"arrow"``, ``"wedge"``, or ``"triangle"``
+        * a custom `SVG path string
+          <https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths>`__ (For correct
+          sizing, custom shape paths should be defined within a square bounding box with
+          coordinates ranging from -1 to 1 along both the x and y dimensions.)
+
+        **Default value:** ``"circle"``
+    size : dict, float, :class:`ExprRef`
+        Default size for marks.
+
+
+        * For ``point`` / ``circle`` / ``square``, this represents the pixel area of the
+          marks. Note that this value sets the area of the symbol; the side lengths will
+          increase with the square root of this value.
+        * For ``bar``, this represents the band size of the bar, in pixels.
+        * For ``text``, this represents the font size, in pixels.
+
+        **Default value:**
+
+
+        * ``30`` for point, circle, square marks; width/height's ``step``
+        * ``2`` for bar marks with discrete dimensions;
+        * ``5`` for bar marks with continuous dimensions;
+        * ``11`` for text marks.
+    smooth : bool, dict, :class:`ExprRef`
+        A boolean flag (default true) indicating if the image should be smoothed when
+        resized. If false, individual pixels should be scaled directly rather than
+        interpolated with smoothing. For SVG rendering, this option may not work in some
+        browsers due to lack of standardization.
+    startAngle : dict, float, :class:`ExprRef`
+        The start angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    stroke : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default stroke color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove stroke.
+
+        **Default value:** (None)
+    strokeCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for line ending style. One of ``"butt"``, ``"round"``, or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    strokeDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating stroke, space lengths for creating dashed or dotted lines.
+    strokeDashOffset : dict, float, :class:`ExprRef`
+        The offset (in pixels) into which to begin drawing with the stroke dash array.
+    strokeJoin : dict, :class:`ExprRef`, :class:`StrokeJoin`, Literal['miter', 'round', 'bevel']
+        The stroke line join method. One of ``"miter"``, ``"round"`` or ``"bevel"``.
+
+        **Default value:** ``"miter"``
+    strokeMiterLimit : dict, float, :class:`ExprRef`
+        The miter limit at which to bevel a line join.
+    strokeOffset : dict, float, :class:`ExprRef`
+        The offset in pixels at which to draw the group stroke and fill. If unspecified, the
+        default behavior is to dynamically offset stroked groups such that 1 pixel stroke
+        widths align with the pixel grid.
+    strokeOpacity : dict, float, :class:`ExprRef`
+        The stroke opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    strokeWidth : dict, float, :class:`ExprRef`
+        The stroke width, in pixels.
+    style : str, Sequence[str]
+        A string or array of strings indicating the name of custom styles to apply to the
+        mark. A style is a named collection of mark property defaults defined within the
+        `style configuration
+        <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__. If style is an
+        array, later styles will override earlier styles. Any `mark properties
+        <https://vega.github.io/vega-lite/docs/encoding.html#mark-prop>`__ explicitly
+        defined within the ``encoding`` will override a style default.
+
+        **Default value:** The mark's name. For example, a bar mark will have style
+        ``"bar"`` by default. **Note:** Any specified style will augment the default style.
+        For example, a bar mark with ``"style": "foo"`` will receive from
+        ``config.style.bar`` and ``config.style.foo`` (the specified style ``"foo"`` has
+        higher precedence).
+    tension : dict, float, :class:`ExprRef`
+        Depending on the interpolation type, sets the tension parameter (for line and area
+        marks).
+    text : str, dict, :class:`Text`, Sequence[str], :class:`ExprRef`
+        Placeholder text if the ``text`` channel is not specified
+    theta : dict, float, :class:`ExprRef`
+        For arc marks, the arc length in radians if theta2 is not specified, otherwise the
+        start arc angle. (A value of 0 indicates up or “north”, increasing values proceed
+        clockwise.)
+
+        For text marks, polar coordinate angle in radians.
+    theta2 : dict, float, :class:`ExprRef`
+        The end angle of arc marks in radians. A value of 0 indicates up or “north”,
+        increasing values proceed clockwise.
+    theta2Offset : dict, float, :class:`ExprRef`
+        Offset for theta2.
+    thetaOffset : dict, float, :class:`ExprRef`
+        Offset for theta.
+    timeUnitBandPosition : float
+        Default relative band position for a time unit. If set to ``0``, the marks will be
+        positioned at the beginning of the time unit band step. If set to ``0.5``, the marks
+        will be positioned in the middle of the time unit band step.
+    timeUnitBandSize : float
+        Default relative band size for a time unit. If set to ``1``, the bandwidth of the
+        marks will be equal to the time unit band step. If set to ``0.5``, bandwidth of the
+        marks will be half of the time unit band step.
+    tooltip : str, bool, dict, None, float, :class:`ExprRef`, :class:`TooltipContent`
+        The tooltip text string to show upon mouse hover or an object defining which fields
+        should the tooltip be derived from.
+
+
+        * If ``tooltip`` is ``true`` or ``{"content": "encoding"}``, then all fields from
+          ``encoding`` will be used.
+        * If ``tooltip`` is ``{"content": "data"}``, then all fields that appear in the
+          highlighted data point will be used.
+        * If set to ``null`` or ``false``, then no tooltip will be used.
+
+        See the `tooltip <https://vega.github.io/vega-lite/docs/tooltip.html>`__
+        documentation for a detailed discussion about tooltip  in Vega-Lite.
+
+        **Default value:** ``null``
+    url : str, dict, :class:`URI`, :class:`ExprRef`
+        The URL of the image file for image marks.
+    width : dict, float, :class:`ExprRef`
+        Width of the marks.
+    x : str, dict, float, :class:`ExprRef`
+        X coordinates of the marks, or width of horizontal ``"bar"`` and ``"area"`` without
+        specified ``x2`` or ``width``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    x2 : str, dict, float, :class:`ExprRef`
+        X2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    x2Offset : dict, float, :class:`ExprRef`
+        Offset for x2-position.
+    xOffset : dict, float, :class:`ExprRef`
+        Offset for x-position.
+    y : str, dict, float, :class:`ExprRef`
+        Y coordinates of the marks, or height of vertical ``"bar"`` and ``"area"`` without
+        specified ``y2`` or ``height``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    y2 : str, dict, float, :class:`ExprRef`
+        Y2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    y2Offset : dict, float, :class:`ExprRef`
+        Offset for y2-position.
+    yOffset : dict, float, :class:`ExprRef`
+        Offset for y-position.
+    """
+
+    _schema = {"$ref": "#/definitions/OverlayMarkDef"}
+
+    def __init__(
+        self,
+        align: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ariaRole: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        blend: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        color: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, "_Parameter", "SchemaBase", Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        dx: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        dy: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ellipsis: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        endAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        fontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        href: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        innerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineBreak: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            "SchemaBase", Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        shape: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        size: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        smooth: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        startAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, "_Parameter", "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        url: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        width: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(OverlayMarkDef, self).__init__(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            baseline=baseline,
+            blend=blend,
+            clip=clip,
+            color=color,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            endAngle=endAngle,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            startAngle=startAngle,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+
+
+class Padding(VegaLiteSchema):
+    """Padding schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Padding"}
+
+    def __init__(self, *args, **kwds):
+        super(Padding, self).__init__(*args, **kwds)
+
+
+class ParameterExtent(BinExtent):
+    """ParameterExtent schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ParameterExtent"}
+
+    def __init__(self, *args, **kwds):
+        super(ParameterExtent, self).__init__(*args, **kwds)
+
+
+class ParameterName(VegaLiteSchema):
+    """ParameterName schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ParameterName"}
+
+    def __init__(self, *args):
+        super(ParameterName, self).__init__(*args)
+
+
+class Parse(VegaLiteSchema):
+    """Parse schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Parse"}
+
+    def __init__(self, **kwds):
+        super(Parse, self).__init__(**kwds)
+
+
+class ParseValue(VegaLiteSchema):
+    """ParseValue schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ParseValue"}
+
+    def __init__(self, *args, **kwds):
+        super(ParseValue, self).__init__(*args, **kwds)
+
+
+class Point(Geometry):
+    """Point schema wrapper
+    Point geometry object. https://tools.ietf.org/html/rfc7946#section-3.1.2
+
+    Parameters
+    ----------
+
+    coordinates : Sequence[float], :class:`Position`
+        A Position is an array of coordinates.
+        https://tools.ietf.org/html/rfc7946#section-3.1.1 Array should contain between two
+        and three elements. The previous GeoJSON specification allowed more elements (e.g.,
+        which could be used to represent M values), but the current specification only
+        allows X, Y, and (optionally) Z to be defined.
+    type : str
+        Specifies the type of GeoJSON object.
+    bbox : :class:`BBox`, Sequence[float]
+        Bounding box of the coordinate range of the object's Geometries, Features, or
+        Feature Collections. https://tools.ietf.org/html/rfc7946#section-5
+    """
+
+    _schema = {"$ref": "#/definitions/Point"}
+
+    def __init__(
+        self,
+        coordinates: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        bbox: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(Point, self).__init__(
+            coordinates=coordinates, type=type, bbox=bbox, **kwds
+        )
+
+
+class PointSelectionConfig(VegaLiteSchema):
+    """PointSelectionConfig schema wrapper
+
+    Parameters
+    ----------
+
+    type : str
+        Determines the default event processing and data query for the selection. Vega-Lite
+        currently supports two selection types:
+
+
+        * ``"point"`` -- to select multiple discrete data values; the first value is
+          selected on ``click`` and additional values toggled on shift-click.
+        * ``"interval"`` -- to select a continuous range of data values on ``drag``.
+    clear : str, bool, dict, :class:`Stream`, :class:`EventStream`, :class:`MergedStream`, :class:`DerivedStream`
+        Clears the selection, emptying it of all values. This property can be a `Event
+        Stream <https://vega.github.io/vega/docs/event-streams/>`__ or ``false`` to disable
+        clear.
+
+        **Default value:** ``dblclick``.
+
+        **See also:** `clear examples
+        <https://vega.github.io/vega-lite/docs/selection.html#clear>`__ in the
+        documentation.
+    encodings : Sequence[:class:`SingleDefUnitChannel`, Literal['x', 'y', 'xOffset', 'yOffset', 'x2', 'y2', 'longitude', 'latitude', 'longitude2', 'latitude2', 'theta', 'theta2', 'radius', 'radius2', 'color', 'fill', 'stroke', 'opacity', 'fillOpacity', 'strokeOpacity', 'strokeWidth', 'strokeDash', 'size', 'angle', 'shape', 'key', 'text', 'href', 'url', 'description']]
+        An array of encoding channels. The corresponding data field values must match for a
+        data tuple to fall within the selection.
+
+        **See also:** The `projection with encodings and fields section
+        <https://vega.github.io/vega-lite/docs/selection.html#project>`__ in the
+        documentation.
+    fields : Sequence[str, :class:`FieldName`]
+        An array of field names whose values must match for a data tuple to fall within the
+        selection.
+
+        **See also:** The `projection with encodings and fields section
+        <https://vega.github.io/vega-lite/docs/selection.html#project>`__ in the
+        documentation.
+    nearest : bool
+        When true, an invisible voronoi diagram is computed to accelerate discrete
+        selection. The data value *nearest* the mouse cursor is added to the selection.
+
+        **Default value:** ``false``, which means that data values must be interacted with
+        directly (e.g., clicked on) to be added to the selection.
+
+        **See also:** `nearest examples
+        <https://vega.github.io/vega-lite/docs/selection.html#nearest>`__ documentation.
+    on : str, dict, :class:`Stream`, :class:`EventStream`, :class:`MergedStream`, :class:`DerivedStream`
+        A `Vega event stream <https://vega.github.io/vega/docs/event-streams/>`__ (object or
+        selector) that triggers the selection. For interval selections, the event stream
+        must specify a `start and end
+        <https://vega.github.io/vega/docs/event-streams/#between-filters>`__.
+
+        **See also:** `on examples
+        <https://vega.github.io/vega-lite/docs/selection.html#on>`__ in the documentation.
+    resolve : :class:`SelectionResolution`, Literal['global', 'union', 'intersect']
+        With layered and multi-view displays, a strategy that determines how selections'
+        data queries are resolved when applied in a filter transform, conditional encoding
+        rule, or scale domain.
+
+        One of:
+
+
+        * ``"global"`` -- only one brush exists for the entire SPLOM. When the user begins
+          to drag, any previous brushes are cleared, and a new one is constructed.
+        * ``"union"`` -- each cell contains its own brush, and points are highlighted if
+          they lie within *any* of these individual brushes.
+        * ``"intersect"`` -- each cell contains its own brush, and points are highlighted
+          only if they fall within *all* of these individual brushes.
+
+        **Default value:** ``global``.
+
+        **See also:** `resolve examples
+        <https://vega.github.io/vega-lite/docs/selection.html#resolve>`__ in the
+        documentation.
+    toggle : str, bool
+        Controls whether data values should be toggled (inserted or removed from a point
+        selection) or only ever inserted into point selections.
+
+        One of:
+
+
+        * ``true`` -- the default behavior, which corresponds to ``"event.shiftKey"``.  As a
+          result, data values are toggled when the user interacts with the shift-key
+          pressed.
+        * ``false`` -- disables toggling behaviour; the selection will only ever contain a
+          single data value corresponding to the most recent interaction.
+        * A `Vega expression <https://vega.github.io/vega/docs/expressions/>`__ which is
+          re-evaluated as the user interacts. If the expression evaluates to ``true``, the
+          data value is toggled into or out of the point selection. If the expression
+          evaluates to ``false``, the point selection is first cleared, and the data value
+          is then inserted. For example, setting the value to the Vega expression ``"true"``
+          will toggle data values without the user pressing the shift-key.
+
+        **Default value:** ``true``
+
+        **See also:** `toggle examples
+        <https://vega.github.io/vega-lite/docs/selection.html#toggle>`__ in the
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/PointSelectionConfig"}
+
+    def __init__(
+        self,
+        type: Union[str, UndefinedType] = Undefined,
+        clear: Union[str, bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        encodings: Union[
+            Sequence[
+                Union[
+                    "SchemaBase",
+                    Literal[
+                        "x",
+                        "y",
+                        "xOffset",
+                        "yOffset",
+                        "x2",
+                        "y2",
+                        "longitude",
+                        "latitude",
+                        "longitude2",
+                        "latitude2",
+                        "theta",
+                        "theta2",
+                        "radius",
+                        "radius2",
+                        "color",
+                        "fill",
+                        "stroke",
+                        "opacity",
+                        "fillOpacity",
+                        "strokeOpacity",
+                        "strokeWidth",
+                        "strokeDash",
+                        "size",
+                        "angle",
+                        "shape",
+                        "key",
+                        "text",
+                        "href",
+                        "url",
+                        "description",
+                    ],
+                ]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fields: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        nearest: Union[bool, UndefinedType] = Undefined,
+        on: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        resolve: Union[
+            "SchemaBase", Literal["global", "union", "intersect"], UndefinedType
+        ] = Undefined,
+        toggle: Union[str, bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(PointSelectionConfig, self).__init__(
+            type=type,
+            clear=clear,
+            encodings=encodings,
+            fields=fields,
+            nearest=nearest,
+            on=on,
+            resolve=resolve,
+            toggle=toggle,
+            **kwds,
+        )
+
+
+class PointSelectionConfigWithoutType(VegaLiteSchema):
+    """PointSelectionConfigWithoutType schema wrapper
+
+    Parameters
+    ----------
+
+    clear : str, bool, dict, :class:`Stream`, :class:`EventStream`, :class:`MergedStream`, :class:`DerivedStream`
+        Clears the selection, emptying it of all values. This property can be a `Event
+        Stream <https://vega.github.io/vega/docs/event-streams/>`__ or ``false`` to disable
+        clear.
+
+        **Default value:** ``dblclick``.
+
+        **See also:** `clear examples
+        <https://vega.github.io/vega-lite/docs/selection.html#clear>`__ in the
+        documentation.
+    encodings : Sequence[:class:`SingleDefUnitChannel`, Literal['x', 'y', 'xOffset', 'yOffset', 'x2', 'y2', 'longitude', 'latitude', 'longitude2', 'latitude2', 'theta', 'theta2', 'radius', 'radius2', 'color', 'fill', 'stroke', 'opacity', 'fillOpacity', 'strokeOpacity', 'strokeWidth', 'strokeDash', 'size', 'angle', 'shape', 'key', 'text', 'href', 'url', 'description']]
+        An array of encoding channels. The corresponding data field values must match for a
+        data tuple to fall within the selection.
+
+        **See also:** The `projection with encodings and fields section
+        <https://vega.github.io/vega-lite/docs/selection.html#project>`__ in the
+        documentation.
+    fields : Sequence[str, :class:`FieldName`]
+        An array of field names whose values must match for a data tuple to fall within the
+        selection.
+
+        **See also:** The `projection with encodings and fields section
+        <https://vega.github.io/vega-lite/docs/selection.html#project>`__ in the
+        documentation.
+    nearest : bool
+        When true, an invisible voronoi diagram is computed to accelerate discrete
+        selection. The data value *nearest* the mouse cursor is added to the selection.
+
+        **Default value:** ``false``, which means that data values must be interacted with
+        directly (e.g., clicked on) to be added to the selection.
+
+        **See also:** `nearest examples
+        <https://vega.github.io/vega-lite/docs/selection.html#nearest>`__ documentation.
+    on : str, dict, :class:`Stream`, :class:`EventStream`, :class:`MergedStream`, :class:`DerivedStream`
+        A `Vega event stream <https://vega.github.io/vega/docs/event-streams/>`__ (object or
+        selector) that triggers the selection. For interval selections, the event stream
+        must specify a `start and end
+        <https://vega.github.io/vega/docs/event-streams/#between-filters>`__.
+
+        **See also:** `on examples
+        <https://vega.github.io/vega-lite/docs/selection.html#on>`__ in the documentation.
+    resolve : :class:`SelectionResolution`, Literal['global', 'union', 'intersect']
+        With layered and multi-view displays, a strategy that determines how selections'
+        data queries are resolved when applied in a filter transform, conditional encoding
+        rule, or scale domain.
+
+        One of:
+
+
+        * ``"global"`` -- only one brush exists for the entire SPLOM. When the user begins
+          to drag, any previous brushes are cleared, and a new one is constructed.
+        * ``"union"`` -- each cell contains its own brush, and points are highlighted if
+          they lie within *any* of these individual brushes.
+        * ``"intersect"`` -- each cell contains its own brush, and points are highlighted
+          only if they fall within *all* of these individual brushes.
+
+        **Default value:** ``global``.
+
+        **See also:** `resolve examples
+        <https://vega.github.io/vega-lite/docs/selection.html#resolve>`__ in the
+        documentation.
+    toggle : str, bool
+        Controls whether data values should be toggled (inserted or removed from a point
+        selection) or only ever inserted into point selections.
+
+        One of:
+
+
+        * ``true`` -- the default behavior, which corresponds to ``"event.shiftKey"``.  As a
+          result, data values are toggled when the user interacts with the shift-key
+          pressed.
+        * ``false`` -- disables toggling behaviour; the selection will only ever contain a
+          single data value corresponding to the most recent interaction.
+        * A `Vega expression <https://vega.github.io/vega/docs/expressions/>`__ which is
+          re-evaluated as the user interacts. If the expression evaluates to ``true``, the
+          data value is toggled into or out of the point selection. If the expression
+          evaluates to ``false``, the point selection is first cleared, and the data value
+          is then inserted. For example, setting the value to the Vega expression ``"true"``
+          will toggle data values without the user pressing the shift-key.
+
+        **Default value:** ``true``
+
+        **See also:** `toggle examples
+        <https://vega.github.io/vega-lite/docs/selection.html#toggle>`__ in the
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/PointSelectionConfigWithoutType"}
+
+    def __init__(
+        self,
+        clear: Union[str, bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        encodings: Union[
+            Sequence[
+                Union[
+                    "SchemaBase",
+                    Literal[
+                        "x",
+                        "y",
+                        "xOffset",
+                        "yOffset",
+                        "x2",
+                        "y2",
+                        "longitude",
+                        "latitude",
+                        "longitude2",
+                        "latitude2",
+                        "theta",
+                        "theta2",
+                        "radius",
+                        "radius2",
+                        "color",
+                        "fill",
+                        "stroke",
+                        "opacity",
+                        "fillOpacity",
+                        "strokeOpacity",
+                        "strokeWidth",
+                        "strokeDash",
+                        "size",
+                        "angle",
+                        "shape",
+                        "key",
+                        "text",
+                        "href",
+                        "url",
+                        "description",
+                    ],
+                ]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fields: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        nearest: Union[bool, UndefinedType] = Undefined,
+        on: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        resolve: Union[
+            "SchemaBase", Literal["global", "union", "intersect"], UndefinedType
+        ] = Undefined,
+        toggle: Union[str, bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(PointSelectionConfigWithoutType, self).__init__(
+            clear=clear,
+            encodings=encodings,
+            fields=fields,
+            nearest=nearest,
+            on=on,
+            resolve=resolve,
+            toggle=toggle,
+            **kwds,
+        )
+
+
+class PolarDef(VegaLiteSchema):
+    """PolarDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/PolarDef"}
+
+    def __init__(self, *args, **kwds):
+        super(PolarDef, self).__init__(*args, **kwds)
+
+
+class Polygon(Geometry):
+    """Polygon schema wrapper
+    Polygon geometry object. https://tools.ietf.org/html/rfc7946#section-3.1.6
+
+    Parameters
+    ----------
+
+    coordinates : Sequence[Sequence[Sequence[float], :class:`Position`]]
+
+    type : str
+        Specifies the type of GeoJSON object.
+    bbox : :class:`BBox`, Sequence[float]
+        Bounding box of the coordinate range of the object's Geometries, Features, or
+        Feature Collections. https://tools.ietf.org/html/rfc7946#section-5
+    """
+
+    _schema = {"$ref": "#/definitions/Polygon"}
+
+    def __init__(
+        self,
+        coordinates: Union[
+            Sequence[Sequence[Union["SchemaBase", Sequence[float]]]], UndefinedType
+        ] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        bbox: Union["SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(Polygon, self).__init__(
+            coordinates=coordinates, type=type, bbox=bbox, **kwds
+        )
+
+
+class Position(VegaLiteSchema):
+    """Position schema wrapper
+    A Position is an array of coordinates. https://tools.ietf.org/html/rfc7946#section-3.1.1
+    Array should contain between two and three elements. The previous GeoJSON specification
+    allowed more elements (e.g., which could be used to represent M values), but the current
+    specification only allows X, Y, and (optionally) Z to be defined.
+    """
+
+    _schema = {"$ref": "#/definitions/Position"}
+
+    def __init__(self, *args):
+        super(Position, self).__init__(*args)
+
+
+class Position2Def(VegaLiteSchema):
+    """Position2Def schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Position2Def"}
+
+    def __init__(self, *args, **kwds):
+        super(Position2Def, self).__init__(*args, **kwds)
+
+
+class DatumDef(LatLongDef, Position2Def):
+    """DatumDef schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/DatumDef"}
+
+    def __init__(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(DatumDef, self).__init__(
+            bandPosition=bandPosition, datum=datum, title=title, type=type, **kwds
+        )
+
+
+class PositionDatumDefBase(PolarDef):
+    """PositionDatumDefBase schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    stack : bool, None, :class:`StackOffset`, Literal['zero', 'center', 'normalize']
+        Type of stacking offset if the field should be stacked. ``stack`` is only applicable
+        for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For
+        example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar
+        chart.
+
+        ``stack`` can be one of the following values:
+
+
+        * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale
+          (for creating typical stacked
+          [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area
+          <https://vega.github.io/vega-lite/docs/stack.html#area>`__ chart).
+        * ``"normalize"`` - stacking with normalized domain (for creating `normalized
+          stacked bar and area charts
+          <https://vega.github.io/vega-lite/docs/stack.html#normalized>`__ and pie charts
+          `with percentage tooltip
+          <https://vega.github.io/vega-lite/docs/arc.html#tooltip>`__ ). :raw-html:`<br/>`
+        * ``"center"`` - stacking with center baseline (for `streamgraph
+          <https://vega.github.io/vega-lite/docs/stack.html#streamgraph>`__ ).
+        * ``null`` or ``false`` - No-stacking. This will produce layered `bar
+          <https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart>`__ and area
+          chart.
+
+        **Default value:** ``zero`` for plots with all of the following conditions are true:
+        (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x
+        or y) has a linear scale; (3) At least one of non-position channels mapped to an
+        unaggregated field that is different from x and y. Otherwise, ``null`` by default.
+
+        **See also:** `stack <https://vega.github.io/vega-lite/docs/stack.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/PositionDatumDefBase"}
+
+    def __init__(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        scale: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        stack: Union[
+            bool,
+            None,
+            "SchemaBase",
+            Literal["zero", "center", "normalize"],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(PositionDatumDefBase, self).__init__(
+            bandPosition=bandPosition,
+            datum=datum,
+            scale=scale,
+            stack=stack,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class PositionDef(VegaLiteSchema):
+    """PositionDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/PositionDef"}
+
+    def __init__(self, *args, **kwds):
+        super(PositionDef, self).__init__(*args, **kwds)
+
+
+class PositionDatumDef(PositionDef):
+    """PositionDatumDef schema wrapper
+
+    Parameters
+    ----------
+
+    axis : dict, None, :class:`Axis`
+        An object defining properties of axis's gridlines, ticks and labels. If ``null``,
+        the axis for the encoding channel will be removed.
+
+        **Default value:** If undefined, default `axis properties
+        <https://vega.github.io/vega-lite/docs/axis.html>`__ are applied.
+
+        **See also:** `axis <https://vega.github.io/vega-lite/docs/axis.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    impute : dict, None, :class:`ImputeParams`
+        An object defining the properties of the Impute Operation to be applied. The field
+        value of the other positional channel is taken as ``key`` of the ``Impute``
+        Operation. The field of the ``color`` channel if specified is used as ``groupby`` of
+        the ``Impute`` Operation.
+
+        **See also:** `impute <https://vega.github.io/vega-lite/docs/impute.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    stack : bool, None, :class:`StackOffset`, Literal['zero', 'center', 'normalize']
+        Type of stacking offset if the field should be stacked. ``stack`` is only applicable
+        for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For
+        example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar
+        chart.
+
+        ``stack`` can be one of the following values:
+
+
+        * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale
+          (for creating typical stacked
+          [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area
+          <https://vega.github.io/vega-lite/docs/stack.html#area>`__ chart).
+        * ``"normalize"`` - stacking with normalized domain (for creating `normalized
+          stacked bar and area charts
+          <https://vega.github.io/vega-lite/docs/stack.html#normalized>`__ and pie charts
+          `with percentage tooltip
+          <https://vega.github.io/vega-lite/docs/arc.html#tooltip>`__ ). :raw-html:`<br/>`
+        * ``"center"`` - stacking with center baseline (for `streamgraph
+          <https://vega.github.io/vega-lite/docs/stack.html#streamgraph>`__ ).
+        * ``null`` or ``false`` - No-stacking. This will produce layered `bar
+          <https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart>`__ and area
+          chart.
+
+        **Default value:** ``zero`` for plots with all of the following conditions are true:
+        (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x
+        or y) has a linear scale; (3) At least one of non-position channels mapped to an
+        unaggregated field that is different from x and y. Otherwise, ``null`` by default.
+
+        **See also:** `stack <https://vega.github.io/vega-lite/docs/stack.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/PositionDatumDef"}
+
+    def __init__(
+        self,
+        axis: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        impute: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        scale: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        stack: Union[
+            bool,
+            None,
+            "SchemaBase",
+            Literal["zero", "center", "normalize"],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(PositionDatumDef, self).__init__(
+            axis=axis,
+            bandPosition=bandPosition,
+            datum=datum,
+            impute=impute,
+            scale=scale,
+            stack=stack,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class PositionFieldDef(PositionDef):
+    """PositionFieldDef schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    axis : dict, None, :class:`Axis`
+        An object defining properties of axis's gridlines, ticks and labels. If ``null``,
+        the axis for the encoding channel will be removed.
+
+        **Default value:** If undefined, default `axis properties
+        <https://vega.github.io/vega-lite/docs/axis.html>`__ are applied.
+
+        **See also:** `axis <https://vega.github.io/vega-lite/docs/axis.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    impute : dict, None, :class:`ImputeParams`
+        An object defining the properties of the Impute Operation to be applied. The field
+        value of the other positional channel is taken as ``key`` of the ``Impute``
+        Operation. The field of the ``color`` channel if specified is used as ``groupby`` of
+        the ``Impute`` Operation.
+
+        **See also:** `impute <https://vega.github.io/vega-lite/docs/impute.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    stack : bool, None, :class:`StackOffset`, Literal['zero', 'center', 'normalize']
+        Type of stacking offset if the field should be stacked. ``stack`` is only applicable
+        for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For
+        example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar
+        chart.
+
+        ``stack`` can be one of the following values:
+
+
+        * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale
+          (for creating typical stacked
+          [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area
+          <https://vega.github.io/vega-lite/docs/stack.html#area>`__ chart).
+        * ``"normalize"`` - stacking with normalized domain (for creating `normalized
+          stacked bar and area charts
+          <https://vega.github.io/vega-lite/docs/stack.html#normalized>`__ and pie charts
+          `with percentage tooltip
+          <https://vega.github.io/vega-lite/docs/arc.html#tooltip>`__ ). :raw-html:`<br/>`
+        * ``"center"`` - stacking with center baseline (for `streamgraph
+          <https://vega.github.io/vega-lite/docs/stack.html#streamgraph>`__ ).
+        * ``null`` or ``false`` - No-stacking. This will produce layered `bar
+          <https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart>`__ and area
+          chart.
+
+        **Default value:** ``zero`` for plots with all of the following conditions are true:
+        (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x
+        or y) has a linear scale; (3) At least one of non-position channels mapped to an
+        unaggregated field that is different from x and y. Otherwise, ``null`` by default.
+
+        **See also:** `stack <https://vega.github.io/vega-lite/docs/stack.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/PositionFieldDef"}
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        axis: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        impute: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        scale: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, "SchemaBase"]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        stack: Union[
+            bool,
+            None,
+            "SchemaBase",
+            Literal["zero", "center", "normalize"],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(PositionFieldDef, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            axis=axis,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            impute=impute,
+            scale=scale,
+            sort=sort,
+            stack=stack,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class PositionFieldDefBase(PolarDef):
+    """PositionFieldDefBase schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    stack : bool, None, :class:`StackOffset`, Literal['zero', 'center', 'normalize']
+        Type of stacking offset if the field should be stacked. ``stack`` is only applicable
+        for ``x``, ``y``, ``theta``, and ``radius`` channels with continuous domains. For
+        example, ``stack`` of ``y`` can be used to customize stacking for a vertical bar
+        chart.
+
+        ``stack`` can be one of the following values:
+
+
+        * ``"zero"`` or `true`: stacking with baseline offset at zero value of the scale
+          (for creating typical stacked
+          [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and `area
+          <https://vega.github.io/vega-lite/docs/stack.html#area>`__ chart).
+        * ``"normalize"`` - stacking with normalized domain (for creating `normalized
+          stacked bar and area charts
+          <https://vega.github.io/vega-lite/docs/stack.html#normalized>`__ and pie charts
+          `with percentage tooltip
+          <https://vega.github.io/vega-lite/docs/arc.html#tooltip>`__ ). :raw-html:`<br/>`
+        * ``"center"`` - stacking with center baseline (for `streamgraph
+          <https://vega.github.io/vega-lite/docs/stack.html#streamgraph>`__ ).
+        * ``null`` or ``false`` - No-stacking. This will produce layered `bar
+          <https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart>`__ and area
+          chart.
+
+        **Default value:** ``zero`` for plots with all of the following conditions are true:
+        (1) the mark is ``bar``, ``area``, or ``arc`` ; (2) the stacked measure channel (x
+        or y) has a linear scale; (3) At least one of non-position channels mapped to an
+        unaggregated field that is different from x and y. Otherwise, ``null`` by default.
+
+        **See also:** `stack <https://vega.github.io/vega-lite/docs/stack.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/PositionFieldDefBase"}
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        scale: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, "SchemaBase"]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        stack: Union[
+            bool,
+            None,
+            "SchemaBase",
+            Literal["zero", "center", "normalize"],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(PositionFieldDefBase, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            scale=scale,
+            sort=sort,
+            stack=stack,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class PositionValueDef(PolarDef, Position2Def, PositionDef):
+    """PositionValueDef schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : str, dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {"$ref": "#/definitions/PositionValueDef"}
+
+    def __init__(
+        self,
+        value: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(PositionValueDef, self).__init__(value=value, **kwds)
+
+
+class PredicateComposition(VegaLiteSchema):
+    """PredicateComposition schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/PredicateComposition"}
+
+    def __init__(self, *args, **kwds):
+        super(PredicateComposition, self).__init__(*args, **kwds)
+
+
+class LogicalAndPredicate(PredicateComposition):
+    """LogicalAndPredicate schema wrapper
+
+    Parameters
+    ----------
+
+    and : Sequence[str, dict, :class:`Predicate`, :class:`FieldGTPredicate`, :class:`FieldLTPredicate`, :class:`FieldGTEPredicate`, :class:`FieldLTEPredicate`, :class:`LogicalOrPredicate`, :class:`ParameterPredicate`, :class:`FieldEqualPredicate`, :class:`FieldOneOfPredicate`, :class:`FieldRangePredicate`, :class:`FieldValidPredicate`, :class:`LogicalAndPredicate`, :class:`LogicalNotPredicate`, :class:`PredicateComposition`]
+
+    """
+
+    _schema = {"$ref": "#/definitions/LogicalAnd<Predicate>"}
+
+    def __init__(self, **kwds):
+        super(LogicalAndPredicate, self).__init__(**kwds)
+
+
+class LogicalNotPredicate(PredicateComposition):
+    """LogicalNotPredicate schema wrapper
+
+    Parameters
+    ----------
+
+    not : str, dict, :class:`Predicate`, :class:`FieldGTPredicate`, :class:`FieldLTPredicate`, :class:`FieldGTEPredicate`, :class:`FieldLTEPredicate`, :class:`LogicalOrPredicate`, :class:`ParameterPredicate`, :class:`FieldEqualPredicate`, :class:`FieldOneOfPredicate`, :class:`FieldRangePredicate`, :class:`FieldValidPredicate`, :class:`LogicalAndPredicate`, :class:`LogicalNotPredicate`, :class:`PredicateComposition`
+
+    """
+
+    _schema = {"$ref": "#/definitions/LogicalNot<Predicate>"}
+
+    def __init__(self, **kwds):
+        super(LogicalNotPredicate, self).__init__(**kwds)
+
+
+class LogicalOrPredicate(PredicateComposition):
+    """LogicalOrPredicate schema wrapper
+
+    Parameters
+    ----------
+
+    or : Sequence[str, dict, :class:`Predicate`, :class:`FieldGTPredicate`, :class:`FieldLTPredicate`, :class:`FieldGTEPredicate`, :class:`FieldLTEPredicate`, :class:`LogicalOrPredicate`, :class:`ParameterPredicate`, :class:`FieldEqualPredicate`, :class:`FieldOneOfPredicate`, :class:`FieldRangePredicate`, :class:`FieldValidPredicate`, :class:`LogicalAndPredicate`, :class:`LogicalNotPredicate`, :class:`PredicateComposition`]
+
+    """
+
+    _schema = {"$ref": "#/definitions/LogicalOr<Predicate>"}
+
+    def __init__(self, **kwds):
+        super(LogicalOrPredicate, self).__init__(**kwds)
+
+
+class Predicate(PredicateComposition):
+    """Predicate schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Predicate"}
+
+    def __init__(self, *args, **kwds):
+        super(Predicate, self).__init__(*args, **kwds)
+
+
+class FieldEqualPredicate(Predicate):
+    """FieldEqualPredicate schema wrapper
+
+    Parameters
+    ----------
+
+    equal : str, bool, dict, float, :class:`ExprRef`, :class:`DateTime`
+        The value that the field should be equal to.
+    field : str, :class:`FieldName`
+        Field to be tested.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit for the field to be tested.
+    """
+
+    _schema = {"$ref": "#/definitions/FieldEqualPredicate"}
+
+    def __init__(
+        self,
+        equal: Union[
+            str, bool, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldEqualPredicate, self).__init__(
+            equal=equal, field=field, timeUnit=timeUnit, **kwds
+        )
+
+
+class FieldGTEPredicate(Predicate):
+    """FieldGTEPredicate schema wrapper
+
+    Parameters
+    ----------
+
+    field : str, :class:`FieldName`
+        Field to be tested.
+    gte : str, dict, float, :class:`ExprRef`, :class:`DateTime`
+        The value that the field should be greater than or equals to.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit for the field to be tested.
+    """
+
+    _schema = {"$ref": "#/definitions/FieldGTEPredicate"}
+
+    def __init__(
+        self,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        gte: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldGTEPredicate, self).__init__(
+            field=field, gte=gte, timeUnit=timeUnit, **kwds
+        )
+
+
+class FieldGTPredicate(Predicate):
+    """FieldGTPredicate schema wrapper
+
+    Parameters
+    ----------
+
+    field : str, :class:`FieldName`
+        Field to be tested.
+    gt : str, dict, float, :class:`ExprRef`, :class:`DateTime`
+        The value that the field should be greater than.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit for the field to be tested.
+    """
+
+    _schema = {"$ref": "#/definitions/FieldGTPredicate"}
+
+    def __init__(
+        self,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        gt: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldGTPredicate, self).__init__(
+            field=field, gt=gt, timeUnit=timeUnit, **kwds
+        )
+
+
+class FieldLTEPredicate(Predicate):
+    """FieldLTEPredicate schema wrapper
+
+    Parameters
+    ----------
+
+    field : str, :class:`FieldName`
+        Field to be tested.
+    lte : str, dict, float, :class:`ExprRef`, :class:`DateTime`
+        The value that the field should be less than or equals to.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit for the field to be tested.
+    """
+
+    _schema = {"$ref": "#/definitions/FieldLTEPredicate"}
+
+    def __init__(
+        self,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        lte: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldLTEPredicate, self).__init__(
+            field=field, lte=lte, timeUnit=timeUnit, **kwds
+        )
+
+
+class FieldLTPredicate(Predicate):
+    """FieldLTPredicate schema wrapper
+
+    Parameters
+    ----------
+
+    field : str, :class:`FieldName`
+        Field to be tested.
+    lt : str, dict, float, :class:`ExprRef`, :class:`DateTime`
+        The value that the field should be less than.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit for the field to be tested.
+    """
+
+    _schema = {"$ref": "#/definitions/FieldLTPredicate"}
+
+    def __init__(
+        self,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        lt: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldLTPredicate, self).__init__(
+            field=field, lt=lt, timeUnit=timeUnit, **kwds
+        )
+
+
+class FieldOneOfPredicate(Predicate):
+    """FieldOneOfPredicate schema wrapper
+
+    Parameters
+    ----------
+
+    field : str, :class:`FieldName`
+        Field to be tested.
+    oneOf : Sequence[str], Sequence[bool], Sequence[float], Sequence[dict, :class:`DateTime`]
+        A set of values that the ``field`` 's value should be a member of, for a data item
+        included in the filtered data.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit for the field to be tested.
+    """
+
+    _schema = {"$ref": "#/definitions/FieldOneOfPredicate"}
+
+    def __init__(
+        self,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        oneOf: Union[
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Sequence[Union[dict, "SchemaBase"]],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldOneOfPredicate, self).__init__(
+            field=field, oneOf=oneOf, timeUnit=timeUnit, **kwds
+        )
+
+
+class FieldRangePredicate(Predicate):
+    """FieldRangePredicate schema wrapper
+
+    Parameters
+    ----------
+
+    field : str, :class:`FieldName`
+        Field to be tested.
+    range : dict, :class:`ExprRef`, Sequence[dict, None, float, :class:`ExprRef`, :class:`DateTime`]
+        An array of inclusive minimum and maximum values for a field value of a data item to
+        be included in the filtered data.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit for the field to be tested.
+    """
+
+    _schema = {"$ref": "#/definitions/FieldRangePredicate"}
+
+    def __init__(
+        self,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        range: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Sequence[Union[dict, None, float, "_Parameter", "SchemaBase"]],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldRangePredicate, self).__init__(
+            field=field, range=range, timeUnit=timeUnit, **kwds
+        )
+
+
+class FieldValidPredicate(Predicate):
+    """FieldValidPredicate schema wrapper
+
+    Parameters
+    ----------
+
+    field : str, :class:`FieldName`
+        Field to be tested.
+    valid : bool
+        If set to true the field's value has to be valid, meaning both not ``null`` and not
+        `NaN
+        <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/NaN>`__.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit for the field to be tested.
+    """
+
+    _schema = {"$ref": "#/definitions/FieldValidPredicate"}
+
+    def __init__(
+        self,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        valid: Union[bool, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldValidPredicate, self).__init__(
+            field=field, valid=valid, timeUnit=timeUnit, **kwds
+        )
+
+
+class ParameterPredicate(Predicate):
+    """ParameterPredicate schema wrapper
+
+    Parameters
+    ----------
+
+    param : str, :class:`ParameterName`
+        Filter using a parameter name.
+    empty : bool
+        For selection parameters, the predicate of empty selections returns true by default.
+        Override this behavior, by setting this property ``empty: false``.
+    """
+
+    _schema = {"$ref": "#/definitions/ParameterPredicate"}
+
+    def __init__(
+        self,
+        param: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        empty: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ParameterPredicate, self).__init__(param=param, empty=empty, **kwds)
+
+
+class Projection(VegaLiteSchema):
+    """Projection schema wrapper
+
+    Parameters
+    ----------
+
+    center : dict, Sequence[float], :class:`ExprRef`, :class:`Vector2number`
+        The projection's center, a two-element array of longitude and latitude in degrees.
+
+        **Default value:** ``[0, 0]``
+    clipAngle : dict, float, :class:`ExprRef`
+        The projection's clipping circle radius to the specified angle in degrees. If
+        ``null``, switches to `antimeridian <http://bl.ocks.org/mbostock/3788999>`__ cutting
+        rather than small-circle clipping.
+    clipExtent : dict, :class:`ExprRef`, :class:`Vector2Vector2number`, Sequence[Sequence[float], :class:`Vector2number`]
+        The projection's viewport clip extent to the specified bounds in pixels. The extent
+        bounds are specified as an array ``[[x0, y0], [x1, y1]]``, where ``x0`` is the
+        left-side of the viewport, ``y0`` is the top, ``x1`` is the right and ``y1`` is the
+        bottom. If ``null``, no viewport clipping is performed.
+    coefficient : dict, float, :class:`ExprRef`
+        The coefficient parameter for the ``hammer`` projection.
+
+        **Default value:** ``2``
+    distance : dict, float, :class:`ExprRef`
+        For the ``satellite`` projection, the distance from the center of the sphere to the
+        point of view, as a proportion of the sphere’s radius. The recommended maximum clip
+        angle for a given ``distance`` is acos(1 / distance) converted to degrees. If tilt
+        is also applied, then more conservative clipping may be necessary.
+
+        **Default value:** ``2.0``
+    extent : dict, :class:`ExprRef`, :class:`Vector2Vector2number`, Sequence[Sequence[float], :class:`Vector2number`]
+
+    fit : dict, :class:`Fit`, :class:`ExprRef`, :class:`GeoJsonFeature`, :class:`GeoJsonFeatureCollection`, Sequence[dict, :class:`GeoJsonFeature`], Sequence[dict, :class:`Fit`, :class:`GeoJsonFeature`, :class:`GeoJsonFeatureCollection`, Sequence[dict, :class:`GeoJsonFeature`]]
+
+    fraction : dict, float, :class:`ExprRef`
+        The fraction parameter for the ``bottomley`` projection.
+
+        **Default value:** ``0.5``, corresponding to a sin(ψ) where ψ = π/6.
+    lobes : dict, float, :class:`ExprRef`
+        The number of lobes in projections that support multi-lobe views: ``berghaus``,
+        ``gingery``, or ``healpix``. The default value varies based on the projection type.
+    parallel : dict, float, :class:`ExprRef`
+        The parallel parameter for projections that support it: ``armadillo``, ``bonne``,
+        ``craig``, ``cylindricalEqualArea``, ``cylindricalStereographic``,
+        ``hammerRetroazimuthal``, ``loximuthal``, or ``rectangularPolyconic``. The default
+        value varies based on the projection type.
+    parallels : dict, Sequence[float], :class:`ExprRef`
+        For conic projections, the `two standard parallels
+        <https://en.wikipedia.org/wiki/Map_projection#Conic>`__ that define the map layout.
+        The default depends on the specific conic projection used.
+    pointRadius : dict, float, :class:`ExprRef`
+        The default radius (in pixels) to use when drawing GeoJSON ``Point`` and
+        ``MultiPoint`` geometries. This parameter sets a constant default value. To modify
+        the point radius in response to data, see the corresponding parameter of the GeoPath
+        and GeoShape transforms.
+
+        **Default value:** ``4.5``
+    precision : dict, float, :class:`ExprRef`
+        The threshold for the projection's `adaptive resampling
+        <http://bl.ocks.org/mbostock/3795544>`__ to the specified value in pixels. This
+        value corresponds to the `Douglas–Peucker distance
+        <http://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm>`__.
+        If precision is not specified, returns the projection's current resampling precision
+        which defaults to ``√0.5 ≅ 0.70710…``.
+    radius : dict, float, :class:`ExprRef`
+        The radius parameter for the ``airy`` or ``gingery`` projection. The default value
+        varies based on the projection type.
+    ratio : dict, float, :class:`ExprRef`
+        The ratio parameter for the ``hill``, ``hufnagel``, or ``wagner`` projections. The
+        default value varies based on the projection type.
+    reflectX : bool, dict, :class:`ExprRef`
+        Sets whether or not the x-dimension is reflected (negated) in the output.
+    reflectY : bool, dict, :class:`ExprRef`
+        Sets whether or not the y-dimension is reflected (negated) in the output.
+    rotate : dict, Sequence[float], :class:`ExprRef`, :class:`Vector2number`, :class:`Vector3number`
+        The projection's three-axis rotation to the specified angles, which must be a two-
+        or three-element array of numbers [ ``lambda``, ``phi``, ``gamma`` ] specifying the
+        rotation angles in degrees about each spherical axis. (These correspond to yaw,
+        pitch and roll.)
+
+        **Default value:** ``[0, 0, 0]``
+    scale : dict, float, :class:`ExprRef`
+        The projection’s scale (zoom) factor, overriding automatic fitting. The default
+        scale is projection-specific. The scale factor corresponds linearly to the distance
+        between projected points; however, scale factor values are not equivalent across
+        projections.
+    size : dict, Sequence[float], :class:`ExprRef`, :class:`Vector2number`
+        Used in conjunction with fit, provides the width and height in pixels of the area to
+        which the projection should be automatically fit.
+    spacing : dict, float, :class:`ExprRef`
+        The spacing parameter for the ``lagrange`` projection.
+
+        **Default value:** ``0.5``
+    tilt : dict, float, :class:`ExprRef`
+        The tilt angle (in degrees) for the ``satellite`` projection.
+
+        **Default value:** ``0``.
+    translate : dict, Sequence[float], :class:`ExprRef`, :class:`Vector2number`
+        The projection’s translation offset as a two-element array ``[tx, ty]``.
+    type : dict, :class:`ExprRef`, :class:`ProjectionType`, Literal['albers', 'albersUsa', 'azimuthalEqualArea', 'azimuthalEquidistant', 'conicConformal', 'conicEqualArea', 'conicEquidistant', 'equalEarth', 'equirectangular', 'gnomonic', 'identity', 'mercator', 'naturalEarth1', 'orthographic', 'stereographic', 'transverseMercator']
+        The cartographic projection to use. This value is case-insensitive, for example
+        ``"albers"`` and ``"Albers"`` indicate the same projection type. You can find all
+        valid projection types `in the documentation
+        <https://vega.github.io/vega-lite/docs/projection.html#projection-types>`__.
+
+        **Default value:** ``equalEarth``
+    """
+
+    _schema = {"$ref": "#/definitions/Projection"}
+
+    def __init__(
+        self,
+        center: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        clipAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        clipExtent: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Sequence[Union["SchemaBase", Sequence[float]]],
+            UndefinedType,
+        ] = Undefined,
+        coefficient: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        distance: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        extent: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Sequence[Union["SchemaBase", Sequence[float]]],
+            UndefinedType,
+        ] = Undefined,
+        fit: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Sequence[Union[dict, "SchemaBase"]],
+            Sequence[Union[dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]]]],
+            UndefinedType,
+        ] = Undefined,
+        fraction: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lobes: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        parallel: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        parallels: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        pointRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        precision: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        ratio: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        reflectX: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        reflectY: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        rotate: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        scale: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        spacing: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tilt: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        translate: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        type: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "albers",
+                "albersUsa",
+                "azimuthalEqualArea",
+                "azimuthalEquidistant",
+                "conicConformal",
+                "conicEqualArea",
+                "conicEquidistant",
+                "equalEarth",
+                "equirectangular",
+                "gnomonic",
+                "identity",
+                "mercator",
+                "naturalEarth1",
+                "orthographic",
+                "stereographic",
+                "transverseMercator",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(Projection, self).__init__(
+            center=center,
+            clipAngle=clipAngle,
+            clipExtent=clipExtent,
+            coefficient=coefficient,
+            distance=distance,
+            extent=extent,
+            fit=fit,
+            fraction=fraction,
+            lobes=lobes,
+            parallel=parallel,
+            parallels=parallels,
+            pointRadius=pointRadius,
+            precision=precision,
+            radius=radius,
+            ratio=ratio,
+            reflectX=reflectX,
+            reflectY=reflectY,
+            rotate=rotate,
+            scale=scale,
+            size=size,
+            spacing=spacing,
+            tilt=tilt,
+            translate=translate,
+            type=type,
+            **kwds,
+        )
+
+
+class ProjectionConfig(VegaLiteSchema):
+    """ProjectionConfig schema wrapper
+
+    Parameters
+    ----------
+
+    center : dict, Sequence[float], :class:`ExprRef`, :class:`Vector2number`
+        The projection's center, a two-element array of longitude and latitude in degrees.
+
+        **Default value:** ``[0, 0]``
+    clipAngle : dict, float, :class:`ExprRef`
+        The projection's clipping circle radius to the specified angle in degrees. If
+        ``null``, switches to `antimeridian <http://bl.ocks.org/mbostock/3788999>`__ cutting
+        rather than small-circle clipping.
+    clipExtent : dict, :class:`ExprRef`, :class:`Vector2Vector2number`, Sequence[Sequence[float], :class:`Vector2number`]
+        The projection's viewport clip extent to the specified bounds in pixels. The extent
+        bounds are specified as an array ``[[x0, y0], [x1, y1]]``, where ``x0`` is the
+        left-side of the viewport, ``y0`` is the top, ``x1`` is the right and ``y1`` is the
+        bottom. If ``null``, no viewport clipping is performed.
+    coefficient : dict, float, :class:`ExprRef`
+        The coefficient parameter for the ``hammer`` projection.
+
+        **Default value:** ``2``
+    distance : dict, float, :class:`ExprRef`
+        For the ``satellite`` projection, the distance from the center of the sphere to the
+        point of view, as a proportion of the sphere’s radius. The recommended maximum clip
+        angle for a given ``distance`` is acos(1 / distance) converted to degrees. If tilt
+        is also applied, then more conservative clipping may be necessary.
+
+        **Default value:** ``2.0``
+    extent : dict, :class:`ExprRef`, :class:`Vector2Vector2number`, Sequence[Sequence[float], :class:`Vector2number`]
+
+    fit : dict, :class:`Fit`, :class:`ExprRef`, :class:`GeoJsonFeature`, :class:`GeoJsonFeatureCollection`, Sequence[dict, :class:`GeoJsonFeature`], Sequence[dict, :class:`Fit`, :class:`GeoJsonFeature`, :class:`GeoJsonFeatureCollection`, Sequence[dict, :class:`GeoJsonFeature`]]
+
+    fraction : dict, float, :class:`ExprRef`
+        The fraction parameter for the ``bottomley`` projection.
+
+        **Default value:** ``0.5``, corresponding to a sin(ψ) where ψ = π/6.
+    lobes : dict, float, :class:`ExprRef`
+        The number of lobes in projections that support multi-lobe views: ``berghaus``,
+        ``gingery``, or ``healpix``. The default value varies based on the projection type.
+    parallel : dict, float, :class:`ExprRef`
+        The parallel parameter for projections that support it: ``armadillo``, ``bonne``,
+        ``craig``, ``cylindricalEqualArea``, ``cylindricalStereographic``,
+        ``hammerRetroazimuthal``, ``loximuthal``, or ``rectangularPolyconic``. The default
+        value varies based on the projection type.
+    parallels : dict, Sequence[float], :class:`ExprRef`
+        For conic projections, the `two standard parallels
+        <https://en.wikipedia.org/wiki/Map_projection#Conic>`__ that define the map layout.
+        The default depends on the specific conic projection used.
+    pointRadius : dict, float, :class:`ExprRef`
+        The default radius (in pixels) to use when drawing GeoJSON ``Point`` and
+        ``MultiPoint`` geometries. This parameter sets a constant default value. To modify
+        the point radius in response to data, see the corresponding parameter of the GeoPath
+        and GeoShape transforms.
+
+        **Default value:** ``4.5``
+    precision : dict, float, :class:`ExprRef`
+        The threshold for the projection's `adaptive resampling
+        <http://bl.ocks.org/mbostock/3795544>`__ to the specified value in pixels. This
+        value corresponds to the `Douglas–Peucker distance
+        <http://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm>`__.
+        If precision is not specified, returns the projection's current resampling precision
+        which defaults to ``√0.5 ≅ 0.70710…``.
+    radius : dict, float, :class:`ExprRef`
+        The radius parameter for the ``airy`` or ``gingery`` projection. The default value
+        varies based on the projection type.
+    ratio : dict, float, :class:`ExprRef`
+        The ratio parameter for the ``hill``, ``hufnagel``, or ``wagner`` projections. The
+        default value varies based on the projection type.
+    reflectX : bool, dict, :class:`ExprRef`
+        Sets whether or not the x-dimension is reflected (negated) in the output.
+    reflectY : bool, dict, :class:`ExprRef`
+        Sets whether or not the y-dimension is reflected (negated) in the output.
+    rotate : dict, Sequence[float], :class:`ExprRef`, :class:`Vector2number`, :class:`Vector3number`
+        The projection's three-axis rotation to the specified angles, which must be a two-
+        or three-element array of numbers [ ``lambda``, ``phi``, ``gamma`` ] specifying the
+        rotation angles in degrees about each spherical axis. (These correspond to yaw,
+        pitch and roll.)
+
+        **Default value:** ``[0, 0, 0]``
+    scale : dict, float, :class:`ExprRef`
+        The projection’s scale (zoom) factor, overriding automatic fitting. The default
+        scale is projection-specific. The scale factor corresponds linearly to the distance
+        between projected points; however, scale factor values are not equivalent across
+        projections.
+    size : dict, Sequence[float], :class:`ExprRef`, :class:`Vector2number`
+        Used in conjunction with fit, provides the width and height in pixels of the area to
+        which the projection should be automatically fit.
+    spacing : dict, float, :class:`ExprRef`
+        The spacing parameter for the ``lagrange`` projection.
+
+        **Default value:** ``0.5``
+    tilt : dict, float, :class:`ExprRef`
+        The tilt angle (in degrees) for the ``satellite`` projection.
+
+        **Default value:** ``0``.
+    translate : dict, Sequence[float], :class:`ExprRef`, :class:`Vector2number`
+        The projection’s translation offset as a two-element array ``[tx, ty]``.
+    type : dict, :class:`ExprRef`, :class:`ProjectionType`, Literal['albers', 'albersUsa', 'azimuthalEqualArea', 'azimuthalEquidistant', 'conicConformal', 'conicEqualArea', 'conicEquidistant', 'equalEarth', 'equirectangular', 'gnomonic', 'identity', 'mercator', 'naturalEarth1', 'orthographic', 'stereographic', 'transverseMercator']
+        The cartographic projection to use. This value is case-insensitive, for example
+        ``"albers"`` and ``"Albers"`` indicate the same projection type. You can find all
+        valid projection types `in the documentation
+        <https://vega.github.io/vega-lite/docs/projection.html#projection-types>`__.
+
+        **Default value:** ``equalEarth``
+    """
+
+    _schema = {"$ref": "#/definitions/ProjectionConfig"}
+
+    def __init__(
+        self,
+        center: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        clipAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        clipExtent: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Sequence[Union["SchemaBase", Sequence[float]]],
+            UndefinedType,
+        ] = Undefined,
+        coefficient: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        distance: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        extent: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Sequence[Union["SchemaBase", Sequence[float]]],
+            UndefinedType,
+        ] = Undefined,
+        fit: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Sequence[Union[dict, "SchemaBase"]],
+            Sequence[Union[dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]]]],
+            UndefinedType,
+        ] = Undefined,
+        fraction: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lobes: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        parallel: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        parallels: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        pointRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        precision: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        ratio: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        reflectX: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        reflectY: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        rotate: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        scale: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        spacing: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tilt: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        translate: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        type: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "albers",
+                "albersUsa",
+                "azimuthalEqualArea",
+                "azimuthalEquidistant",
+                "conicConformal",
+                "conicEqualArea",
+                "conicEquidistant",
+                "equalEarth",
+                "equirectangular",
+                "gnomonic",
+                "identity",
+                "mercator",
+                "naturalEarth1",
+                "orthographic",
+                "stereographic",
+                "transverseMercator",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ProjectionConfig, self).__init__(
+            center=center,
+            clipAngle=clipAngle,
+            clipExtent=clipExtent,
+            coefficient=coefficient,
+            distance=distance,
+            extent=extent,
+            fit=fit,
+            fraction=fraction,
+            lobes=lobes,
+            parallel=parallel,
+            parallels=parallels,
+            pointRadius=pointRadius,
+            precision=precision,
+            radius=radius,
+            ratio=ratio,
+            reflectX=reflectX,
+            reflectY=reflectY,
+            rotate=rotate,
+            scale=scale,
+            size=size,
+            spacing=spacing,
+            tilt=tilt,
+            translate=translate,
+            type=type,
+            **kwds,
+        )
+
+
+class ProjectionType(VegaLiteSchema):
+    """ProjectionType schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ProjectionType"}
+
+    def __init__(self, *args):
+        super(ProjectionType, self).__init__(*args)
+
+
+class RadialGradient(Gradient):
+    """RadialGradient schema wrapper
+
+    Parameters
+    ----------
+
+    gradient : str
+        The type of gradient. Use ``"radial"`` for a radial gradient.
+    stops : Sequence[dict, :class:`GradientStop`]
+        An array of gradient stops defining the gradient color sequence.
+    id : str
+
+    r1 : float
+        The radius length, in normalized [0, 1] coordinates, of the inner circle for the
+        gradient.
+
+        **Default value:** ``0``
+    r2 : float
+        The radius length, in normalized [0, 1] coordinates, of the outer circle for the
+        gradient.
+
+        **Default value:** ``0.5``
+    x1 : float
+        The x-coordinate, in normalized [0, 1] coordinates, for the center of the inner
+        circle for the gradient.
+
+        **Default value:** ``0.5``
+    x2 : float
+        The x-coordinate, in normalized [0, 1] coordinates, for the center of the outer
+        circle for the gradient.
+
+        **Default value:** ``0.5``
+    y1 : float
+        The y-coordinate, in normalized [0, 1] coordinates, for the center of the inner
+        circle for the gradient.
+
+        **Default value:** ``0.5``
+    y2 : float
+        The y-coordinate, in normalized [0, 1] coordinates, for the center of the outer
+        circle for the gradient.
+
+        **Default value:** ``0.5``
+    """
+
+    _schema = {"$ref": "#/definitions/RadialGradient"}
+
+    def __init__(
+        self,
+        gradient: Union[str, UndefinedType] = Undefined,
+        stops: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        id: Union[str, UndefinedType] = Undefined,
+        r1: Union[float, UndefinedType] = Undefined,
+        r2: Union[float, UndefinedType] = Undefined,
+        x1: Union[float, UndefinedType] = Undefined,
+        x2: Union[float, UndefinedType] = Undefined,
+        y1: Union[float, UndefinedType] = Undefined,
+        y2: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(RadialGradient, self).__init__(
+            gradient=gradient,
+            stops=stops,
+            id=id,
+            r1=r1,
+            r2=r2,
+            x1=x1,
+            x2=x2,
+            y1=y1,
+            y2=y2,
+            **kwds,
+        )
+
+
+class RangeConfig(VegaLiteSchema):
+    """RangeConfig schema wrapper
+
+    Parameters
+    ----------
+
+    category : dict, :class:`RangeRaw`, :class:`RangeEnum`, :class:`RangeScheme`, Sequence[str, bool, None, float, Sequence[float], :class:`RangeRawArray`], Literal['width', 'height', 'symbol', 'category', 'ordinal', 'ramp', 'diverging', 'heatmap'], Sequence[str, :class:`Color`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']]
+        Default `color scheme <https://vega.github.io/vega/docs/schemes/>`__ for categorical
+        data.
+    diverging : dict, :class:`RangeRaw`, :class:`RangeEnum`, :class:`RangeScheme`, Sequence[str, bool, None, float, Sequence[float], :class:`RangeRawArray`], Literal['width', 'height', 'symbol', 'category', 'ordinal', 'ramp', 'diverging', 'heatmap'], Sequence[str, :class:`Color`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']]
+        Default `color scheme <https://vega.github.io/vega/docs/schemes/>`__ for diverging
+        quantitative ramps.
+    heatmap : dict, :class:`RangeRaw`, :class:`RangeEnum`, :class:`RangeScheme`, Sequence[str, bool, None, float, Sequence[float], :class:`RangeRawArray`], Literal['width', 'height', 'symbol', 'category', 'ordinal', 'ramp', 'diverging', 'heatmap'], Sequence[str, :class:`Color`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']]
+        Default `color scheme <https://vega.github.io/vega/docs/schemes/>`__ for
+        quantitative heatmaps.
+    ordinal : dict, :class:`RangeRaw`, :class:`RangeEnum`, :class:`RangeScheme`, Sequence[str, bool, None, float, Sequence[float], :class:`RangeRawArray`], Literal['width', 'height', 'symbol', 'category', 'ordinal', 'ramp', 'diverging', 'heatmap'], Sequence[str, :class:`Color`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']]
+        Default `color scheme <https://vega.github.io/vega/docs/schemes/>`__ for
+        rank-ordered data.
+    ramp : dict, :class:`RangeRaw`, :class:`RangeEnum`, :class:`RangeScheme`, Sequence[str, bool, None, float, Sequence[float], :class:`RangeRawArray`], Literal['width', 'height', 'symbol', 'category', 'ordinal', 'ramp', 'diverging', 'heatmap'], Sequence[str, :class:`Color`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']]
+        Default `color scheme <https://vega.github.io/vega/docs/schemes/>`__ for sequential
+        quantitative ramps.
+    symbol : Sequence[str, :class:`SymbolShape`]
+        Array of `symbol <https://vega.github.io/vega/docs/marks/symbol/>`__ names or paths
+        for the default shape palette.
+    """
+
+    _schema = {"$ref": "#/definitions/RangeConfig"}
+
+    def __init__(
+        self,
+        category: Union[
+            dict,
+            "SchemaBase",
+            Sequence[Union[str, bool, None, float, "SchemaBase", Sequence[float]]],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            Sequence[
+                Union[
+                    str,
+                    "SchemaBase",
+                    Literal[
+                        "black",
+                        "silver",
+                        "gray",
+                        "white",
+                        "maroon",
+                        "red",
+                        "purple",
+                        "fuchsia",
+                        "green",
+                        "lime",
+                        "olive",
+                        "yellow",
+                        "navy",
+                        "blue",
+                        "teal",
+                        "aqua",
+                        "orange",
+                        "aliceblue",
+                        "antiquewhite",
+                        "aquamarine",
+                        "azure",
+                        "beige",
+                        "bisque",
+                        "blanchedalmond",
+                        "blueviolet",
+                        "brown",
+                        "burlywood",
+                        "cadetblue",
+                        "chartreuse",
+                        "chocolate",
+                        "coral",
+                        "cornflowerblue",
+                        "cornsilk",
+                        "crimson",
+                        "cyan",
+                        "darkblue",
+                        "darkcyan",
+                        "darkgoldenrod",
+                        "darkgray",
+                        "darkgreen",
+                        "darkgrey",
+                        "darkkhaki",
+                        "darkmagenta",
+                        "darkolivegreen",
+                        "darkorange",
+                        "darkorchid",
+                        "darkred",
+                        "darksalmon",
+                        "darkseagreen",
+                        "darkslateblue",
+                        "darkslategray",
+                        "darkslategrey",
+                        "darkturquoise",
+                        "darkviolet",
+                        "deeppink",
+                        "deepskyblue",
+                        "dimgray",
+                        "dimgrey",
+                        "dodgerblue",
+                        "firebrick",
+                        "floralwhite",
+                        "forestgreen",
+                        "gainsboro",
+                        "ghostwhite",
+                        "gold",
+                        "goldenrod",
+                        "greenyellow",
+                        "grey",
+                        "honeydew",
+                        "hotpink",
+                        "indianred",
+                        "indigo",
+                        "ivory",
+                        "khaki",
+                        "lavender",
+                        "lavenderblush",
+                        "lawngreen",
+                        "lemonchiffon",
+                        "lightblue",
+                        "lightcoral",
+                        "lightcyan",
+                        "lightgoldenrodyellow",
+                        "lightgray",
+                        "lightgreen",
+                        "lightgrey",
+                        "lightpink",
+                        "lightsalmon",
+                        "lightseagreen",
+                        "lightskyblue",
+                        "lightslategray",
+                        "lightslategrey",
+                        "lightsteelblue",
+                        "lightyellow",
+                        "limegreen",
+                        "linen",
+                        "magenta",
+                        "mediumaquamarine",
+                        "mediumblue",
+                        "mediumorchid",
+                        "mediumpurple",
+                        "mediumseagreen",
+                        "mediumslateblue",
+                        "mediumspringgreen",
+                        "mediumturquoise",
+                        "mediumvioletred",
+                        "midnightblue",
+                        "mintcream",
+                        "mistyrose",
+                        "moccasin",
+                        "navajowhite",
+                        "oldlace",
+                        "olivedrab",
+                        "orangered",
+                        "orchid",
+                        "palegoldenrod",
+                        "palegreen",
+                        "paleturquoise",
+                        "palevioletred",
+                        "papayawhip",
+                        "peachpuff",
+                        "peru",
+                        "pink",
+                        "plum",
+                        "powderblue",
+                        "rosybrown",
+                        "royalblue",
+                        "saddlebrown",
+                        "salmon",
+                        "sandybrown",
+                        "seagreen",
+                        "seashell",
+                        "sienna",
+                        "skyblue",
+                        "slateblue",
+                        "slategray",
+                        "slategrey",
+                        "snow",
+                        "springgreen",
+                        "steelblue",
+                        "tan",
+                        "thistle",
+                        "tomato",
+                        "turquoise",
+                        "violet",
+                        "wheat",
+                        "whitesmoke",
+                        "yellowgreen",
+                        "rebeccapurple",
+                    ],
+                ]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        diverging: Union[
+            dict,
+            "SchemaBase",
+            Sequence[Union[str, bool, None, float, "SchemaBase", Sequence[float]]],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            Sequence[
+                Union[
+                    str,
+                    "SchemaBase",
+                    Literal[
+                        "black",
+                        "silver",
+                        "gray",
+                        "white",
+                        "maroon",
+                        "red",
+                        "purple",
+                        "fuchsia",
+                        "green",
+                        "lime",
+                        "olive",
+                        "yellow",
+                        "navy",
+                        "blue",
+                        "teal",
+                        "aqua",
+                        "orange",
+                        "aliceblue",
+                        "antiquewhite",
+                        "aquamarine",
+                        "azure",
+                        "beige",
+                        "bisque",
+                        "blanchedalmond",
+                        "blueviolet",
+                        "brown",
+                        "burlywood",
+                        "cadetblue",
+                        "chartreuse",
+                        "chocolate",
+                        "coral",
+                        "cornflowerblue",
+                        "cornsilk",
+                        "crimson",
+                        "cyan",
+                        "darkblue",
+                        "darkcyan",
+                        "darkgoldenrod",
+                        "darkgray",
+                        "darkgreen",
+                        "darkgrey",
+                        "darkkhaki",
+                        "darkmagenta",
+                        "darkolivegreen",
+                        "darkorange",
+                        "darkorchid",
+                        "darkred",
+                        "darksalmon",
+                        "darkseagreen",
+                        "darkslateblue",
+                        "darkslategray",
+                        "darkslategrey",
+                        "darkturquoise",
+                        "darkviolet",
+                        "deeppink",
+                        "deepskyblue",
+                        "dimgray",
+                        "dimgrey",
+                        "dodgerblue",
+                        "firebrick",
+                        "floralwhite",
+                        "forestgreen",
+                        "gainsboro",
+                        "ghostwhite",
+                        "gold",
+                        "goldenrod",
+                        "greenyellow",
+                        "grey",
+                        "honeydew",
+                        "hotpink",
+                        "indianred",
+                        "indigo",
+                        "ivory",
+                        "khaki",
+                        "lavender",
+                        "lavenderblush",
+                        "lawngreen",
+                        "lemonchiffon",
+                        "lightblue",
+                        "lightcoral",
+                        "lightcyan",
+                        "lightgoldenrodyellow",
+                        "lightgray",
+                        "lightgreen",
+                        "lightgrey",
+                        "lightpink",
+                        "lightsalmon",
+                        "lightseagreen",
+                        "lightskyblue",
+                        "lightslategray",
+                        "lightslategrey",
+                        "lightsteelblue",
+                        "lightyellow",
+                        "limegreen",
+                        "linen",
+                        "magenta",
+                        "mediumaquamarine",
+                        "mediumblue",
+                        "mediumorchid",
+                        "mediumpurple",
+                        "mediumseagreen",
+                        "mediumslateblue",
+                        "mediumspringgreen",
+                        "mediumturquoise",
+                        "mediumvioletred",
+                        "midnightblue",
+                        "mintcream",
+                        "mistyrose",
+                        "moccasin",
+                        "navajowhite",
+                        "oldlace",
+                        "olivedrab",
+                        "orangered",
+                        "orchid",
+                        "palegoldenrod",
+                        "palegreen",
+                        "paleturquoise",
+                        "palevioletred",
+                        "papayawhip",
+                        "peachpuff",
+                        "peru",
+                        "pink",
+                        "plum",
+                        "powderblue",
+                        "rosybrown",
+                        "royalblue",
+                        "saddlebrown",
+                        "salmon",
+                        "sandybrown",
+                        "seagreen",
+                        "seashell",
+                        "sienna",
+                        "skyblue",
+                        "slateblue",
+                        "slategray",
+                        "slategrey",
+                        "snow",
+                        "springgreen",
+                        "steelblue",
+                        "tan",
+                        "thistle",
+                        "tomato",
+                        "turquoise",
+                        "violet",
+                        "wheat",
+                        "whitesmoke",
+                        "yellowgreen",
+                        "rebeccapurple",
+                    ],
+                ]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        heatmap: Union[
+            dict,
+            "SchemaBase",
+            Sequence[Union[str, bool, None, float, "SchemaBase", Sequence[float]]],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            Sequence[
+                Union[
+                    str,
+                    "SchemaBase",
+                    Literal[
+                        "black",
+                        "silver",
+                        "gray",
+                        "white",
+                        "maroon",
+                        "red",
+                        "purple",
+                        "fuchsia",
+                        "green",
+                        "lime",
+                        "olive",
+                        "yellow",
+                        "navy",
+                        "blue",
+                        "teal",
+                        "aqua",
+                        "orange",
+                        "aliceblue",
+                        "antiquewhite",
+                        "aquamarine",
+                        "azure",
+                        "beige",
+                        "bisque",
+                        "blanchedalmond",
+                        "blueviolet",
+                        "brown",
+                        "burlywood",
+                        "cadetblue",
+                        "chartreuse",
+                        "chocolate",
+                        "coral",
+                        "cornflowerblue",
+                        "cornsilk",
+                        "crimson",
+                        "cyan",
+                        "darkblue",
+                        "darkcyan",
+                        "darkgoldenrod",
+                        "darkgray",
+                        "darkgreen",
+                        "darkgrey",
+                        "darkkhaki",
+                        "darkmagenta",
+                        "darkolivegreen",
+                        "darkorange",
+                        "darkorchid",
+                        "darkred",
+                        "darksalmon",
+                        "darkseagreen",
+                        "darkslateblue",
+                        "darkslategray",
+                        "darkslategrey",
+                        "darkturquoise",
+                        "darkviolet",
+                        "deeppink",
+                        "deepskyblue",
+                        "dimgray",
+                        "dimgrey",
+                        "dodgerblue",
+                        "firebrick",
+                        "floralwhite",
+                        "forestgreen",
+                        "gainsboro",
+                        "ghostwhite",
+                        "gold",
+                        "goldenrod",
+                        "greenyellow",
+                        "grey",
+                        "honeydew",
+                        "hotpink",
+                        "indianred",
+                        "indigo",
+                        "ivory",
+                        "khaki",
+                        "lavender",
+                        "lavenderblush",
+                        "lawngreen",
+                        "lemonchiffon",
+                        "lightblue",
+                        "lightcoral",
+                        "lightcyan",
+                        "lightgoldenrodyellow",
+                        "lightgray",
+                        "lightgreen",
+                        "lightgrey",
+                        "lightpink",
+                        "lightsalmon",
+                        "lightseagreen",
+                        "lightskyblue",
+                        "lightslategray",
+                        "lightslategrey",
+                        "lightsteelblue",
+                        "lightyellow",
+                        "limegreen",
+                        "linen",
+                        "magenta",
+                        "mediumaquamarine",
+                        "mediumblue",
+                        "mediumorchid",
+                        "mediumpurple",
+                        "mediumseagreen",
+                        "mediumslateblue",
+                        "mediumspringgreen",
+                        "mediumturquoise",
+                        "mediumvioletred",
+                        "midnightblue",
+                        "mintcream",
+                        "mistyrose",
+                        "moccasin",
+                        "navajowhite",
+                        "oldlace",
+                        "olivedrab",
+                        "orangered",
+                        "orchid",
+                        "palegoldenrod",
+                        "palegreen",
+                        "paleturquoise",
+                        "palevioletred",
+                        "papayawhip",
+                        "peachpuff",
+                        "peru",
+                        "pink",
+                        "plum",
+                        "powderblue",
+                        "rosybrown",
+                        "royalblue",
+                        "saddlebrown",
+                        "salmon",
+                        "sandybrown",
+                        "seagreen",
+                        "seashell",
+                        "sienna",
+                        "skyblue",
+                        "slateblue",
+                        "slategray",
+                        "slategrey",
+                        "snow",
+                        "springgreen",
+                        "steelblue",
+                        "tan",
+                        "thistle",
+                        "tomato",
+                        "turquoise",
+                        "violet",
+                        "wheat",
+                        "whitesmoke",
+                        "yellowgreen",
+                        "rebeccapurple",
+                    ],
+                ]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        ordinal: Union[
+            dict,
+            "SchemaBase",
+            Sequence[Union[str, bool, None, float, "SchemaBase", Sequence[float]]],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            Sequence[
+                Union[
+                    str,
+                    "SchemaBase",
+                    Literal[
+                        "black",
+                        "silver",
+                        "gray",
+                        "white",
+                        "maroon",
+                        "red",
+                        "purple",
+                        "fuchsia",
+                        "green",
+                        "lime",
+                        "olive",
+                        "yellow",
+                        "navy",
+                        "blue",
+                        "teal",
+                        "aqua",
+                        "orange",
+                        "aliceblue",
+                        "antiquewhite",
+                        "aquamarine",
+                        "azure",
+                        "beige",
+                        "bisque",
+                        "blanchedalmond",
+                        "blueviolet",
+                        "brown",
+                        "burlywood",
+                        "cadetblue",
+                        "chartreuse",
+                        "chocolate",
+                        "coral",
+                        "cornflowerblue",
+                        "cornsilk",
+                        "crimson",
+                        "cyan",
+                        "darkblue",
+                        "darkcyan",
+                        "darkgoldenrod",
+                        "darkgray",
+                        "darkgreen",
+                        "darkgrey",
+                        "darkkhaki",
+                        "darkmagenta",
+                        "darkolivegreen",
+                        "darkorange",
+                        "darkorchid",
+                        "darkred",
+                        "darksalmon",
+                        "darkseagreen",
+                        "darkslateblue",
+                        "darkslategray",
+                        "darkslategrey",
+                        "darkturquoise",
+                        "darkviolet",
+                        "deeppink",
+                        "deepskyblue",
+                        "dimgray",
+                        "dimgrey",
+                        "dodgerblue",
+                        "firebrick",
+                        "floralwhite",
+                        "forestgreen",
+                        "gainsboro",
+                        "ghostwhite",
+                        "gold",
+                        "goldenrod",
+                        "greenyellow",
+                        "grey",
+                        "honeydew",
+                        "hotpink",
+                        "indianred",
+                        "indigo",
+                        "ivory",
+                        "khaki",
+                        "lavender",
+                        "lavenderblush",
+                        "lawngreen",
+                        "lemonchiffon",
+                        "lightblue",
+                        "lightcoral",
+                        "lightcyan",
+                        "lightgoldenrodyellow",
+                        "lightgray",
+                        "lightgreen",
+                        "lightgrey",
+                        "lightpink",
+                        "lightsalmon",
+                        "lightseagreen",
+                        "lightskyblue",
+                        "lightslategray",
+                        "lightslategrey",
+                        "lightsteelblue",
+                        "lightyellow",
+                        "limegreen",
+                        "linen",
+                        "magenta",
+                        "mediumaquamarine",
+                        "mediumblue",
+                        "mediumorchid",
+                        "mediumpurple",
+                        "mediumseagreen",
+                        "mediumslateblue",
+                        "mediumspringgreen",
+                        "mediumturquoise",
+                        "mediumvioletred",
+                        "midnightblue",
+                        "mintcream",
+                        "mistyrose",
+                        "moccasin",
+                        "navajowhite",
+                        "oldlace",
+                        "olivedrab",
+                        "orangered",
+                        "orchid",
+                        "palegoldenrod",
+                        "palegreen",
+                        "paleturquoise",
+                        "palevioletred",
+                        "papayawhip",
+                        "peachpuff",
+                        "peru",
+                        "pink",
+                        "plum",
+                        "powderblue",
+                        "rosybrown",
+                        "royalblue",
+                        "saddlebrown",
+                        "salmon",
+                        "sandybrown",
+                        "seagreen",
+                        "seashell",
+                        "sienna",
+                        "skyblue",
+                        "slateblue",
+                        "slategray",
+                        "slategrey",
+                        "snow",
+                        "springgreen",
+                        "steelblue",
+                        "tan",
+                        "thistle",
+                        "tomato",
+                        "turquoise",
+                        "violet",
+                        "wheat",
+                        "whitesmoke",
+                        "yellowgreen",
+                        "rebeccapurple",
+                    ],
+                ]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        ramp: Union[
+            dict,
+            "SchemaBase",
+            Sequence[Union[str, bool, None, float, "SchemaBase", Sequence[float]]],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            Sequence[
+                Union[
+                    str,
+                    "SchemaBase",
+                    Literal[
+                        "black",
+                        "silver",
+                        "gray",
+                        "white",
+                        "maroon",
+                        "red",
+                        "purple",
+                        "fuchsia",
+                        "green",
+                        "lime",
+                        "olive",
+                        "yellow",
+                        "navy",
+                        "blue",
+                        "teal",
+                        "aqua",
+                        "orange",
+                        "aliceblue",
+                        "antiquewhite",
+                        "aquamarine",
+                        "azure",
+                        "beige",
+                        "bisque",
+                        "blanchedalmond",
+                        "blueviolet",
+                        "brown",
+                        "burlywood",
+                        "cadetblue",
+                        "chartreuse",
+                        "chocolate",
+                        "coral",
+                        "cornflowerblue",
+                        "cornsilk",
+                        "crimson",
+                        "cyan",
+                        "darkblue",
+                        "darkcyan",
+                        "darkgoldenrod",
+                        "darkgray",
+                        "darkgreen",
+                        "darkgrey",
+                        "darkkhaki",
+                        "darkmagenta",
+                        "darkolivegreen",
+                        "darkorange",
+                        "darkorchid",
+                        "darkred",
+                        "darksalmon",
+                        "darkseagreen",
+                        "darkslateblue",
+                        "darkslategray",
+                        "darkslategrey",
+                        "darkturquoise",
+                        "darkviolet",
+                        "deeppink",
+                        "deepskyblue",
+                        "dimgray",
+                        "dimgrey",
+                        "dodgerblue",
+                        "firebrick",
+                        "floralwhite",
+                        "forestgreen",
+                        "gainsboro",
+                        "ghostwhite",
+                        "gold",
+                        "goldenrod",
+                        "greenyellow",
+                        "grey",
+                        "honeydew",
+                        "hotpink",
+                        "indianred",
+                        "indigo",
+                        "ivory",
+                        "khaki",
+                        "lavender",
+                        "lavenderblush",
+                        "lawngreen",
+                        "lemonchiffon",
+                        "lightblue",
+                        "lightcoral",
+                        "lightcyan",
+                        "lightgoldenrodyellow",
+                        "lightgray",
+                        "lightgreen",
+                        "lightgrey",
+                        "lightpink",
+                        "lightsalmon",
+                        "lightseagreen",
+                        "lightskyblue",
+                        "lightslategray",
+                        "lightslategrey",
+                        "lightsteelblue",
+                        "lightyellow",
+                        "limegreen",
+                        "linen",
+                        "magenta",
+                        "mediumaquamarine",
+                        "mediumblue",
+                        "mediumorchid",
+                        "mediumpurple",
+                        "mediumseagreen",
+                        "mediumslateblue",
+                        "mediumspringgreen",
+                        "mediumturquoise",
+                        "mediumvioletred",
+                        "midnightblue",
+                        "mintcream",
+                        "mistyrose",
+                        "moccasin",
+                        "navajowhite",
+                        "oldlace",
+                        "olivedrab",
+                        "orangered",
+                        "orchid",
+                        "palegoldenrod",
+                        "palegreen",
+                        "paleturquoise",
+                        "palevioletred",
+                        "papayawhip",
+                        "peachpuff",
+                        "peru",
+                        "pink",
+                        "plum",
+                        "powderblue",
+                        "rosybrown",
+                        "royalblue",
+                        "saddlebrown",
+                        "salmon",
+                        "sandybrown",
+                        "seagreen",
+                        "seashell",
+                        "sienna",
+                        "skyblue",
+                        "slateblue",
+                        "slategray",
+                        "slategrey",
+                        "snow",
+                        "springgreen",
+                        "steelblue",
+                        "tan",
+                        "thistle",
+                        "tomato",
+                        "turquoise",
+                        "violet",
+                        "wheat",
+                        "whitesmoke",
+                        "yellowgreen",
+                        "rebeccapurple",
+                    ],
+                ]
+            ],
+            UndefinedType,
+        ] = Undefined,
+        symbol: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(RangeConfig, self).__init__(
+            category=category,
+            diverging=diverging,
+            heatmap=heatmap,
+            ordinal=ordinal,
+            ramp=ramp,
+            symbol=symbol,
+            **kwds,
+        )
+
+
+class RangeRawArray(VegaLiteSchema):
+    """RangeRawArray schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/RangeRawArray"}
+
+    def __init__(self, *args):
+        super(RangeRawArray, self).__init__(*args)
+
+
+class RangeScheme(VegaLiteSchema):
+    """RangeScheme schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/RangeScheme"}
+
+    def __init__(self, *args, **kwds):
+        super(RangeScheme, self).__init__(*args, **kwds)
+
+
+class RangeEnum(RangeScheme):
+    """RangeEnum schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/RangeEnum"}
+
+    def __init__(self, *args):
+        super(RangeEnum, self).__init__(*args)
+
+
+class RangeRaw(RangeScheme):
+    """RangeRaw schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/RangeRaw"}
+
+    def __init__(self, *args):
+        super(RangeRaw, self).__init__(*args)
+
+
+class RectConfig(AnyMarkConfig):
+    """RectConfig schema wrapper
+
+    Parameters
+    ----------
+
+    align : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule).
+        One of ``"left"``, ``"right"``, ``"center"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    angle : dict, float, :class:`ExprRef`
+        The rotation angle of the text, in degrees.
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG element, removing the mark item from the ARIA accessibility tree.
+    ariaRole : str, dict, :class:`ExprRef`
+        Sets the type of user interface element of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "role" attribute. Warning: this
+        property is experimental and may be changed in the future.
+    ariaRoleDescription : str, dict, :class:`ExprRef`
+        A human-readable, author-localized description for the role of the mark item for
+        `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "aria-roledescription" attribute.
+        Warning: this property is experimental and may be changed in the future.
+    aspect : bool, dict, :class:`ExprRef`
+        Whether to keep aspect ratio of image marks.
+    baseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        For text marks, the vertical text baseline. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, ``"line-bottom"``, or an
+        expression reference that provides one of the valid values. The ``"line-top"`` and
+        ``"line-bottom"`` values operate similarly to ``"top"`` and ``"bottom"``, but are
+        calculated relative to the ``lineHeight`` rather than ``fontSize`` alone.
+
+        For range marks, the vertical alignment of the marks. One of ``"top"``,
+        ``"middle"``, ``"bottom"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    binSpacing : float
+        Offset between bars for binned field. The ideal value for this is either 0
+        (preferred by statisticians) or 1 (Vega-Lite default, D3 example style).
+
+        **Default value:** ``1``
+    blend : dict, :class:`Blend`, :class:`ExprRef`, Literal[None, 'multiply', 'screen', 'overlay', 'darken', 'lighten', 'color-dodge', 'color-burn', 'hard-light', 'soft-light', 'difference', 'exclusion', 'hue', 'saturation', 'color', 'luminosity']
+        The color blend mode for drawing an item on its current background. Any valid `CSS
+        mix-blend-mode <https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode>`__
+        value can be used.
+
+        __Default value:__ ``"source-over"``
+    color : str, dict, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default color.
+
+        **Default value:** :raw-html:`<span style="color: #4682b4;">&#9632;</span>`
+        ``"#4682b4"``
+
+        **Note:**
+
+
+        * This property cannot be used in a `style config
+          <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+        * The ``fill`` and ``stroke`` properties have higher precedence than ``color`` and
+          will override ``color``.
+    continuousBandSize : float
+        The default size of the bars on continuous scales.
+
+        **Default value:** ``5``
+    cornerRadius : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles or arcs' corners.
+
+        **Default value:** ``0``
+    cornerRadiusBottomLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom left corner.
+
+        **Default value:** ``0``
+    cornerRadiusBottomRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top left corner.
+
+        **Default value:** ``0``
+    cursor : dict, :class:`Cursor`, :class:`ExprRef`, Literal['auto', 'default', 'none', 'context-menu', 'help', 'pointer', 'progress', 'wait', 'cell', 'crosshair', 'text', 'vertical-text', 'alias', 'copy', 'move', 'no-drop', 'not-allowed', 'e-resize', 'n-resize', 'ne-resize', 'nw-resize', 's-resize', 'se-resize', 'sw-resize', 'w-resize', 'ew-resize', 'ns-resize', 'nesw-resize', 'nwse-resize', 'col-resize', 'row-resize', 'all-scroll', 'zoom-in', 'zoom-out', 'grab', 'grabbing']
+        The mouse cursor used over the mark. Any valid `CSS cursor type
+        <https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values>`__ can be used.
+    description : str, dict, :class:`ExprRef`
+        A text description of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the `"aria-label" attribute
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>`__.
+    dir : dict, :class:`ExprRef`, Literal['ltr', 'rtl'], :class:`TextDirection`
+        The direction of the text. One of ``"ltr"`` (left-to-right) or ``"rtl"``
+        (right-to-left). This property determines on which side is truncated in response to
+        the limit parameter.
+
+        **Default value:** ``"ltr"``
+    discreteBandSize : dict, float, :class:`RelativeBandSize`
+        The default size of the bars with discrete dimensions. If unspecified, the default
+        size is  ``step-2``, which provides 2 pixel offset between bars.
+    dx : dict, float, :class:`ExprRef`
+        The horizontal offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    dy : dict, float, :class:`ExprRef`
+        The vertical offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    ellipsis : str, dict, :class:`ExprRef`
+        The ellipsis string for text truncated in response to the limit parameter.
+
+        **Default value:** ``"…"``
+    endAngle : dict, float, :class:`ExprRef`
+        The end angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    fill : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default fill color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove fill.
+
+        **Default value:** (None)
+    fillOpacity : dict, float, :class:`ExprRef`
+        The fill opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    filled : bool
+        Whether the mark's color should be used as fill color instead of stroke color.
+
+        **Default value:** ``false`` for all ``point``, ``line``, and ``rule`` marks as well
+        as ``geoshape`` marks for `graticule
+        <https://vega.github.io/vega-lite/docs/data.html#graticule>`__ data sources;
+        otherwise, ``true``.
+
+        **Note:** This property cannot be used in a `style config
+        <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+    font : str, dict, :class:`ExprRef`
+        The typeface to set the text in (e.g., ``"Helvetica Neue"`` ).
+    fontSize : dict, float, :class:`ExprRef`
+        The font size, in pixels.
+
+        **Default value:** ``11``
+    fontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style (e.g., ``"italic"`` ).
+    fontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight. This can be either a string (e.g ``"bold"``, ``"normal"`` ) or a
+        number ( ``100``, ``200``, ``300``, ..., ``900`` where ``"normal"`` = ``400`` and
+        ``"bold"`` = ``700`` ).
+    height : dict, float, :class:`ExprRef`
+        Height of the marks.
+    href : str, dict, :class:`URI`, :class:`ExprRef`
+        A URL to load upon mouse click. If defined, the mark acts as a hyperlink.
+    innerRadius : dict, float, :class:`ExprRef`
+        The inner radius in pixels of arc marks. ``innerRadius`` is an alias for
+        ``radius2``.
+
+        **Default value:** ``0``
+    interpolate : dict, :class:`ExprRef`, :class:`Interpolate`, Literal['basis', 'basis-open', 'basis-closed', 'bundle', 'cardinal', 'cardinal-open', 'cardinal-closed', 'catmull-rom', 'linear', 'linear-closed', 'monotone', 'natural', 'step', 'step-before', 'step-after']
+        The line interpolation method to use for line and area marks. One of the following:
+
+
+        * ``"linear"`` : piecewise linear segments, as in a polyline.
+        * ``"linear-closed"`` : close the linear segments to form a polygon.
+        * ``"step"`` : alternate between horizontal and vertical segments, as in a step
+          function.
+        * ``"step-before"`` : alternate between vertical and horizontal segments, as in a
+          step function.
+        * ``"step-after"`` : alternate between horizontal and vertical segments, as in a
+          step function.
+        * ``"basis"`` : a B-spline, with control point duplication on the ends.
+        * ``"basis-open"`` : an open B-spline; may not intersect the start or end.
+        * ``"basis-closed"`` : a closed B-spline, as in a loop.
+        * ``"cardinal"`` : a Cardinal spline, with control point duplication on the ends.
+        * ``"cardinal-open"`` : an open Cardinal spline; may not intersect the start or end,
+          but will intersect other control points.
+        * ``"cardinal-closed"`` : a closed Cardinal spline, as in a loop.
+        * ``"bundle"`` : equivalent to basis, except the tension parameter is used to
+          straighten the spline.
+        * ``"monotone"`` : cubic interpolation that preserves monotonicity in y.
+    invalid : Literal['filter', None]
+        Defines how Vega-Lite should handle marks for invalid values ( ``null`` and ``NaN``
+        ).
+
+
+        * If set to ``"filter"`` (default), all data items with null values will be skipped
+          (for line, trail, and area marks) or filtered (for other marks).
+        * If ``null``, all data items are included. In this case, invalid values will be
+          interpreted as zeroes.
+    limit : dict, float, :class:`ExprRef`
+        The maximum length of the text mark in pixels. The text value will be automatically
+        truncated if the rendered size exceeds the limit.
+
+        **Default value:** ``0`` -- indicating no limit
+    lineBreak : str, dict, :class:`ExprRef`
+        A delimiter, such as a newline character, upon which to break text strings into
+        multiple lines. This property is ignored if the text is array-valued.
+    lineHeight : dict, float, :class:`ExprRef`
+        The line height in pixels (the spacing between subsequent lines of text) for
+        multi-line text marks.
+    minBandSize : dict, float, :class:`ExprRef`
+        The minimum band size for bar and rectangle marks. **Default value:** ``0.25``
+    opacity : dict, float, :class:`ExprRef`
+        The overall opacity (value between [0,1]).
+
+        **Default value:** ``0.7`` for non-aggregate plots with ``point``, ``tick``,
+        ``circle``, or ``square`` marks or layered ``bar`` charts and ``1`` otherwise.
+    order : bool, None
+        For line and trail marks, this ``order`` property can be set to ``null`` or
+        ``false`` to make the lines use the original order in the data sources.
+    orient : :class:`Orientation`, Literal['horizontal', 'vertical']
+        The orientation of a non-stacked bar, tick, area, and line charts. The value is
+        either horizontal (default) or vertical.
+
+
+        * For bar, rule and tick, this determines whether the size of the bar and tick
+          should be applied to x or y dimension.
+        * For area, this property determines the orient property of the Vega output.
+        * For line and trail marks, this property determines the sort order of the points in
+          the line if ``config.sortLineBy`` is not specified. For stacked charts, this is
+          always determined by the orientation of the stack; therefore explicitly specified
+          value will be ignored.
+    outerRadius : dict, float, :class:`ExprRef`
+        The outer radius in pixels of arc marks. ``outerRadius`` is an alias for ``radius``.
+
+        **Default value:** ``0``
+    padAngle : dict, float, :class:`ExprRef`
+        The angular padding applied to sides of the arc, in radians.
+    radius : dict, float, :class:`ExprRef`
+        For arc mark, the primary (outer) radius in pixels.
+
+        For text marks, polar coordinate radial offset, in pixels, of the text from the
+        origin determined by the ``x`` and ``y`` properties.
+
+        **Default value:** ``min(plot_width, plot_height)/2``
+    radius2 : dict, float, :class:`ExprRef`
+        The secondary (inner) radius in pixels of arc marks.
+
+        **Default value:** ``0``
+    shape : str, dict, :class:`ExprRef`, :class:`SymbolShape`
+        Shape of the point marks. Supported values include:
+
+
+        * plotting shapes: ``"circle"``, ``"square"``, ``"cross"``, ``"diamond"``,
+          ``"triangle-up"``, ``"triangle-down"``, ``"triangle-right"``, or
+          ``"triangle-left"``.
+        * the line symbol ``"stroke"``
+        * centered directional shapes ``"arrow"``, ``"wedge"``, or ``"triangle"``
+        * a custom `SVG path string
+          <https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths>`__ (For correct
+          sizing, custom shape paths should be defined within a square bounding box with
+          coordinates ranging from -1 to 1 along both the x and y dimensions.)
+
+        **Default value:** ``"circle"``
+    size : dict, float, :class:`ExprRef`
+        Default size for marks.
+
+
+        * For ``point`` / ``circle`` / ``square``, this represents the pixel area of the
+          marks. Note that this value sets the area of the symbol; the side lengths will
+          increase with the square root of this value.
+        * For ``bar``, this represents the band size of the bar, in pixels.
+        * For ``text``, this represents the font size, in pixels.
+
+        **Default value:**
+
+
+        * ``30`` for point, circle, square marks; width/height's ``step``
+        * ``2`` for bar marks with discrete dimensions;
+        * ``5`` for bar marks with continuous dimensions;
+        * ``11`` for text marks.
+    smooth : bool, dict, :class:`ExprRef`
+        A boolean flag (default true) indicating if the image should be smoothed when
+        resized. If false, individual pixels should be scaled directly rather than
+        interpolated with smoothing. For SVG rendering, this option may not work in some
+        browsers due to lack of standardization.
+    startAngle : dict, float, :class:`ExprRef`
+        The start angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    stroke : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default stroke color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove stroke.
+
+        **Default value:** (None)
+    strokeCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for line ending style. One of ``"butt"``, ``"round"``, or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    strokeDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating stroke, space lengths for creating dashed or dotted lines.
+    strokeDashOffset : dict, float, :class:`ExprRef`
+        The offset (in pixels) into which to begin drawing with the stroke dash array.
+    strokeJoin : dict, :class:`ExprRef`, :class:`StrokeJoin`, Literal['miter', 'round', 'bevel']
+        The stroke line join method. One of ``"miter"``, ``"round"`` or ``"bevel"``.
+
+        **Default value:** ``"miter"``
+    strokeMiterLimit : dict, float, :class:`ExprRef`
+        The miter limit at which to bevel a line join.
+    strokeOffset : dict, float, :class:`ExprRef`
+        The offset in pixels at which to draw the group stroke and fill. If unspecified, the
+        default behavior is to dynamically offset stroked groups such that 1 pixel stroke
+        widths align with the pixel grid.
+    strokeOpacity : dict, float, :class:`ExprRef`
+        The stroke opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    strokeWidth : dict, float, :class:`ExprRef`
+        The stroke width, in pixels.
+    tension : dict, float, :class:`ExprRef`
+        Depending on the interpolation type, sets the tension parameter (for line and area
+        marks).
+    text : str, dict, :class:`Text`, Sequence[str], :class:`ExprRef`
+        Placeholder text if the ``text`` channel is not specified
+    theta : dict, float, :class:`ExprRef`
+        For arc marks, the arc length in radians if theta2 is not specified, otherwise the
+        start arc angle. (A value of 0 indicates up or “north”, increasing values proceed
+        clockwise.)
+
+        For text marks, polar coordinate angle in radians.
+    theta2 : dict, float, :class:`ExprRef`
+        The end angle of arc marks in radians. A value of 0 indicates up or “north”,
+        increasing values proceed clockwise.
+    timeUnitBandPosition : float
+        Default relative band position for a time unit. If set to ``0``, the marks will be
+        positioned at the beginning of the time unit band step. If set to ``0.5``, the marks
+        will be positioned in the middle of the time unit band step.
+    timeUnitBandSize : float
+        Default relative band size for a time unit. If set to ``1``, the bandwidth of the
+        marks will be equal to the time unit band step. If set to ``0.5``, bandwidth of the
+        marks will be half of the time unit band step.
+    tooltip : str, bool, dict, None, float, :class:`ExprRef`, :class:`TooltipContent`
+        The tooltip text string to show upon mouse hover or an object defining which fields
+        should the tooltip be derived from.
+
+
+        * If ``tooltip`` is ``true`` or ``{"content": "encoding"}``, then all fields from
+          ``encoding`` will be used.
+        * If ``tooltip`` is ``{"content": "data"}``, then all fields that appear in the
+          highlighted data point will be used.
+        * If set to ``null`` or ``false``, then no tooltip will be used.
+
+        See the `tooltip <https://vega.github.io/vega-lite/docs/tooltip.html>`__
+        documentation for a detailed discussion about tooltip  in Vega-Lite.
+
+        **Default value:** ``null``
+    url : str, dict, :class:`URI`, :class:`ExprRef`
+        The URL of the image file for image marks.
+    width : dict, float, :class:`ExprRef`
+        Width of the marks.
+    x : str, dict, float, :class:`ExprRef`
+        X coordinates of the marks, or width of horizontal ``"bar"`` and ``"area"`` without
+        specified ``x2`` or ``width``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    x2 : str, dict, float, :class:`ExprRef`
+        X2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    y : str, dict, float, :class:`ExprRef`
+        Y coordinates of the marks, or height of vertical ``"bar"`` and ``"area"`` without
+        specified ``y2`` or ``height``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    y2 : str, dict, float, :class:`ExprRef`
+        Y2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    """
+
+    _schema = {"$ref": "#/definitions/RectConfig"}
+
+    def __init__(
+        self,
+        align: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ariaRole: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, "_Parameter", "SchemaBase", Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[dict, float, "SchemaBase", UndefinedType] = Undefined,
+        dx: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        dy: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ellipsis: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        endAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        fontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        href: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        innerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineBreak: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            "SchemaBase", Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        shape: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        size: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        smooth: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        startAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tension: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, "_Parameter", "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        url: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        width: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(RectConfig, self).__init__(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            endAngle=endAngle,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            radius=radius,
+            radius2=radius2,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            startAngle=startAngle,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            y=y,
+            y2=y2,
+            **kwds,
+        )
+
+
+class RelativeBandSize(VegaLiteSchema):
+    """RelativeBandSize schema wrapper
+
+    Parameters
+    ----------
+
+    band : float
+        The relative band size.  For example ``0.5`` means half of the band scale's band
+        width.
+    """
+
+    _schema = {"$ref": "#/definitions/RelativeBandSize"}
+
+    def __init__(self, band: Union[float, UndefinedType] = Undefined, **kwds):
+        super(RelativeBandSize, self).__init__(band=band, **kwds)
+
+
+class RepeatMapping(VegaLiteSchema):
+    """RepeatMapping schema wrapper
+
+    Parameters
+    ----------
+
+    column : Sequence[str]
+        An array of fields to be repeated horizontally.
+    row : Sequence[str]
+        An array of fields to be repeated vertically.
+    """
+
+    _schema = {"$ref": "#/definitions/RepeatMapping"}
+
+    def __init__(
+        self,
+        column: Union[Sequence[str], UndefinedType] = Undefined,
+        row: Union[Sequence[str], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(RepeatMapping, self).__init__(column=column, row=row, **kwds)
+
+
+class RepeatRef(Field):
+    """RepeatRef schema wrapper
+    Reference to a repeated value.
+
+    Parameters
+    ----------
+
+    repeat : Literal['row', 'column', 'repeat', 'layer']
+
+    """
+
+    _schema = {"$ref": "#/definitions/RepeatRef"}
+
+    def __init__(
+        self,
+        repeat: Union[
+            Literal["row", "column", "repeat", "layer"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(RepeatRef, self).__init__(repeat=repeat, **kwds)
+
+
+class Resolve(VegaLiteSchema):
+    """Resolve schema wrapper
+    Defines how scales, axes, and legends from different specs should be combined. Resolve is a
+    mapping from ``scale``, ``axis``, and ``legend`` to a mapping from channels to resolutions.
+    Scales and guides can be resolved to be ``"independent"`` or ``"shared"``.
+
+    Parameters
+    ----------
+
+    axis : dict, :class:`AxisResolveMap`
+
+    legend : dict, :class:`LegendResolveMap`
+
+    scale : dict, :class:`ScaleResolveMap`
+
+    """
+
+    _schema = {"$ref": "#/definitions/Resolve"}
+
+    def __init__(
+        self,
+        axis: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        legend: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        scale: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(Resolve, self).__init__(axis=axis, legend=legend, scale=scale, **kwds)
+
+
+class ResolveMode(VegaLiteSchema):
+    """ResolveMode schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ResolveMode"}
+
+    def __init__(self, *args):
+        super(ResolveMode, self).__init__(*args)
+
+
+class RowColLayoutAlign(VegaLiteSchema):
+    """RowColLayoutAlign schema wrapper
+
+    Parameters
+    ----------
+
+    column : :class:`LayoutAlign`, Literal['all', 'each', 'none']
+
+    row : :class:`LayoutAlign`, Literal['all', 'each', 'none']
+
+    """
+
+    _schema = {"$ref": "#/definitions/RowCol<LayoutAlign>"}
+
+    def __init__(
+        self,
+        column: Union[
+            "SchemaBase", Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        row: Union[
+            "SchemaBase", Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(RowColLayoutAlign, self).__init__(column=column, row=row, **kwds)
+
+
+class RowColboolean(VegaLiteSchema):
+    """RowColboolean schema wrapper
+
+    Parameters
+    ----------
+
+    column : bool
+
+    row : bool
+
+    """
+
+    _schema = {"$ref": "#/definitions/RowCol<boolean>"}
+
+    def __init__(
+        self,
+        column: Union[bool, UndefinedType] = Undefined,
+        row: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(RowColboolean, self).__init__(column=column, row=row, **kwds)
+
+
+class RowColnumber(VegaLiteSchema):
+    """RowColnumber schema wrapper
+
+    Parameters
+    ----------
+
+    column : float
+
+    row : float
+
+    """
+
+    _schema = {"$ref": "#/definitions/RowCol<number>"}
+
+    def __init__(
+        self,
+        column: Union[float, UndefinedType] = Undefined,
+        row: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(RowColnumber, self).__init__(column=column, row=row, **kwds)
+
+
+class RowColumnEncodingFieldDef(VegaLiteSchema):
+    """RowColumnEncodingFieldDef schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    align : :class:`LayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to row/column facet's subplot. The supported string values
+        are ``"all"``, ``"each"``, and ``"none"``.
+
+
+        * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply
+          placed one after the other.
+        * For ``"each"``, subviews will be aligned into a clean grid structure, but each row
+          or column may be of variable size.
+        * For ``"all"``, subviews will be aligned and each row or column will be sized
+          identically based on the maximum observed size. String values for this property
+          will be applied to both grid rows and columns.
+
+        **Default value:** ``"all"``.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    center : bool
+        Boolean flag indicating if facet's subviews should be centered relative to their
+        respective rows or columns.
+
+        **Default value:** ``false``
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    header : dict, None, :class:`Header`
+        An object defining properties of a facet's header.
+    sort : dict, None, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`EncodingSortField`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` is not supported for ``row`` and ``column``.
+    spacing : float
+        The spacing in pixels between facet's sub-views.
+
+        **Default value** : Depends on ``"spacing"`` property of `the view composition
+        configuration <https://vega.github.io/vega-lite/docs/config.html#view-config>`__ (
+        ``20`` by default)
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/RowColumnEncodingFieldDef"}
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        align: Union[
+            "SchemaBase", Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        center: Union[bool, UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        header: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, "SchemaBase"]],
+            UndefinedType,
+        ] = Undefined,
+        spacing: Union[float, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(RowColumnEncodingFieldDef, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            align=align,
+            bandPosition=bandPosition,
+            bin=bin,
+            center=center,
+            field=field,
+            header=header,
+            sort=sort,
+            spacing=spacing,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class Scale(VegaLiteSchema):
+    """Scale schema wrapper
+
+    Parameters
+    ----------
+
+    align : dict, float, :class:`ExprRef`
+        The alignment of the steps within the scale range.
+
+        This value must lie in the range ``[0,1]``. A value of ``0.5`` indicates that the
+        steps should be centered within the range. A value of ``0`` or ``1`` may be used to
+        shift the bands to one side, say to position them adjacent to an axis.
+
+        **Default value:** ``0.5``
+    base : dict, float, :class:`ExprRef`
+        The logarithm base of the ``log`` scale (default ``10`` ).
+    bins : dict, Sequence[float], :class:`ScaleBins`, :class:`ScaleBinParams`
+        Bin boundaries can be provided to scales as either an explicit array of bin
+        boundaries or as a bin specification object. The legal values are:
+
+
+        * An `array <../types/#Array>`__ literal of bin boundary values. For example, ``[0,
+          5, 10, 15, 20]``. The array must include both starting and ending boundaries. The
+          previous example uses five values to indicate a total of four bin intervals:
+          [0-5), [5-10), [10-15), [15-20]. Array literals may include signal references as
+          elements.
+        * A `bin specification object
+          <https://vega.github.io/vega-lite/docs/scale.html#bins>`__ that indicates the bin
+          *step* size, and optionally the *start* and *stop* boundaries.
+        * An array of bin boundaries over the scale domain. If provided, axes and legends
+          will use the bin boundaries to inform the choice of tick marks and text labels.
+    clamp : bool, dict, :class:`ExprRef`
+        If ``true``, values that exceed the data domain are clamped to either the minimum or
+        maximum range value
+
+        **Default value:** derived from the `scale config
+        <https://vega.github.io/vega-lite/docs/config.html#scale-config>`__ 's ``clamp`` (
+        ``true`` by default).
+    constant : dict, float, :class:`ExprRef`
+        A constant determining the slope of the symlog function around zero. Only used for
+        ``symlog`` scales.
+
+        **Default value:** ``1``
+    domain : str, dict, :class:`ExprRef`, :class:`DomainUnionWith`, :class:`ParameterExtent`, Sequence[str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`]
+        Customized domain values in the form of constant values or dynamic values driven by
+        a parameter.
+
+        1) Constant ``domain`` for *quantitative* fields can take one of the following
+        forms:
+
+
+        * A two-element array with minimum and maximum values. To create a diverging scale,
+          this two-element array can be combined with the ``domainMid`` property.
+        * An array with more than two entries, for `Piecewise quantitative scales
+          <https://vega.github.io/vega-lite/docs/scale.html#piecewise>`__.
+        * A string value ``"unaggregated"``, if the input field is aggregated, to indicate
+          that the domain should include the raw data values prior to the aggregation.
+
+        2) Constant ``domain`` for *temporal* fields can be a two-element array with minimum
+        and maximum values, in the form of either timestamps or the `DateTime definition
+        objects <https://vega.github.io/vega-lite/docs/types.html#datetime>`__.
+
+        3) Constant ``domain`` for *ordinal* and *nominal* fields can be an array that lists
+        valid input values.
+
+        4) To combine (union) specified constant domain with the field's values, ``domain``
+        can be an object with a ``unionWith`` property that specify constant domain to be
+        combined. For example, ``domain: {unionWith: [0, 100]}`` for a quantitative scale
+        means that the scale domain always includes ``[0, 100]``, but will include other
+        values in the fields beyond ``[0, 100]``.
+
+        5) Domain can also takes an object defining a field or encoding of a parameter that
+        `interactively determines
+        <https://vega.github.io/vega-lite/docs/selection.html#scale-domains>`__ the scale
+        domain.
+    domainMax : dict, float, :class:`ExprRef`, :class:`DateTime`
+        Sets the maximum value in the scale domain, overriding the ``domain`` property. This
+        property is only intended for use with scales having continuous domains.
+    domainMid : dict, float, :class:`ExprRef`
+        Inserts a single mid-point value into a two-element domain. The mid-point value must
+        lie between the domain minimum and maximum values. This property can be useful for
+        setting a midpoint for `diverging color scales
+        <https://vega.github.io/vega-lite/docs/scale.html#piecewise>`__. The domainMid
+        property is only intended for use with scales supporting continuous, piecewise
+        domains.
+    domainMin : dict, float, :class:`ExprRef`, :class:`DateTime`
+        Sets the minimum value in the scale domain, overriding the domain property. This
+        property is only intended for use with scales having continuous domains.
+    domainRaw : dict, :class:`ExprRef`
+        An expression for an array of raw values that, if non-null, directly overrides the
+        *domain* property. This is useful for supporting interactions such as panning or
+        zooming a scale. The scale may be initially determined using a data-driven domain,
+        then modified in response to user input by setting the rawDomain value.
+    exponent : dict, float, :class:`ExprRef`
+        The exponent of the ``pow`` scale.
+    interpolate : dict, :class:`ExprRef`, :class:`ScaleInterpolateEnum`, :class:`ScaleInterpolateParams`, Literal['rgb', 'lab', 'hcl', 'hsl', 'hsl-long', 'hcl-long', 'cubehelix', 'cubehelix-long']
+        The interpolation method for range values. By default, a general interpolator for
+        numbers, dates, strings and colors (in HCL space) is used. For color ranges, this
+        property allows interpolation in alternative color spaces. Legal values include
+        ``rgb``, ``hsl``, ``hsl-long``, ``lab``, ``hcl``, ``hcl-long``, ``cubehelix`` and
+        ``cubehelix-long`` ('-long' variants use longer paths in polar coordinate spaces).
+        If object-valued, this property accepts an object with a string-valued *type*
+        property and an optional numeric *gamma* property applicable to rgb and cubehelix
+        interpolators. For more, see the `d3-interpolate documentation
+        <https://github.com/d3/d3-interpolate>`__.
+
+
+        * **Default value:** ``hcl``
+    nice : bool, dict, float, :class:`ExprRef`, :class:`TimeInterval`, :class:`TimeIntervalStep`, Literal['millisecond', 'second', 'minute', 'hour', 'day', 'week', 'month', 'year']
+        Extending the domain so that it starts and ends on nice round values. This method
+        typically modifies the scale’s domain, and may only extend the bounds to the nearest
+        round value. Nicing is useful if the domain is computed from data and may be
+        irregular. For example, for a domain of *[0.201479…, 0.996679…]*, a nice domain
+        might be *[0.2, 1.0]*.
+
+        For quantitative scales such as linear, ``nice`` can be either a boolean flag or a
+        number. If ``nice`` is a number, it will represent a desired tick count. This allows
+        greater control over the step size used to extend the bounds, guaranteeing that the
+        returned ticks will exactly cover the domain.
+
+        For temporal fields with time and utc scales, the ``nice`` value can be a string
+        indicating the desired time interval. Legal values are ``"millisecond"``,
+        ``"second"``, ``"minute"``, ``"hour"``, ``"day"``, ``"week"``, ``"month"``, and
+        ``"year"``. Alternatively, ``time`` and ``utc`` scales can accept an object-valued
+        interval specifier of the form ``{"interval": "month", "step": 3}``, which includes
+        a desired number of interval steps. Here, the domain would snap to quarter (Jan,
+        Apr, Jul, Oct) boundaries.
+
+        **Default value:** ``true`` for unbinned *quantitative* fields without explicit
+        domain bounds; ``false`` otherwise.
+    padding : dict, float, :class:`ExprRef`
+        For * `continuous <https://vega.github.io/vega-lite/docs/scale.html#continuous>`__ *
+        scales, expands the scale domain to accommodate the specified number of pixels on
+        each of the scale range. The scale range must represent pixels for this parameter to
+        function as intended. Padding adjustment is performed prior to all other
+        adjustments, including the effects of the  ``zero``,  ``nice``,  ``domainMin``, and
+        ``domainMax``  properties.
+
+        For * `band <https://vega.github.io/vega-lite/docs/scale.html#band>`__ * scales,
+        shortcut for setting ``paddingInner`` and ``paddingOuter`` to the same value.
+
+        For * `point <https://vega.github.io/vega-lite/docs/scale.html#point>`__ * scales,
+        alias for ``paddingOuter``.
+
+        **Default value:** For *continuous* scales, derived from the `scale config
+        <https://vega.github.io/vega-lite/docs/scale.html#config>`__ 's
+        ``continuousPadding``. For *band and point* scales, see ``paddingInner`` and
+        ``paddingOuter``. By default, Vega-Lite sets padding such that *width/height =
+        number of unique values * step*.
+    paddingInner : dict, float, :class:`ExprRef`
+        The inner padding (spacing) within each band step of band scales, as a fraction of
+        the step size. This value must lie in the range [0,1].
+
+        For point scale, this property is invalid as point scales do not have internal band
+        widths (only step sizes between bands).
+
+        **Default value:** derived from the `scale config
+        <https://vega.github.io/vega-lite/docs/scale.html#config>`__ 's
+        ``bandPaddingInner``.
+    paddingOuter : dict, float, :class:`ExprRef`
+        The outer padding (spacing) at the ends of the range of band and point scales, as a
+        fraction of the step size. This value must lie in the range [0,1].
+
+        **Default value:** derived from the `scale config
+        <https://vega.github.io/vega-lite/docs/scale.html#config>`__ 's ``bandPaddingOuter``
+        for band scales and ``pointPadding`` for point scales. By default, Vega-Lite sets
+        outer padding such that *width/height = number of unique values * step*.
+    range : dict, :class:`RangeEnum`, :class:`FieldRange`, Sequence[str, dict, float, Sequence[float], :class:`ExprRef`], Literal['width', 'height', 'symbol', 'category', 'ordinal', 'ramp', 'diverging', 'heatmap']
+        The range of the scale. One of:
+
+
+        A string indicating a `pre-defined named scale range
+        <https://vega.github.io/vega-lite/docs/scale.html#range-config>`__ (e.g., example,
+        ``"symbol"``, or ``"diverging"`` ).
+
+        For `continuous scales
+        <https://vega.github.io/vega-lite/docs/scale.html#continuous>`__, two-element array
+        indicating  minimum and maximum values, or an array with more than two entries for
+        specifying a `piecewise scale
+        <https://vega.github.io/vega-lite/docs/scale.html#piecewise>`__.
+
+        For `discrete <https://vega.github.io/vega-lite/docs/scale.html#discrete>`__ and
+        `discretizing <https://vega.github.io/vega-lite/docs/scale.html#discretizing>`__
+        scales, an array of desired output values or an object with a ``field`` property
+        representing the range values.  For example, if a field ``color`` contains CSS color
+        names, we can set ``range`` to ``{field: "color"}``.
+
+        **Notes:**
+
+        1) For color scales you can also specify a color `scheme
+        <https://vega.github.io/vega-lite/docs/scale.html#scheme>`__ instead of ``range``.
+
+        2) Any directly specified ``range`` for ``x`` and ``y`` channels will be ignored.
+        Range can be customized via the view's corresponding `size
+        <https://vega.github.io/vega-lite/docs/size.html>`__ ( ``width`` and ``height`` ).
+    rangeMax : str, dict, float, :class:`ExprRef`
+        Sets the maximum value in the scale range, overriding the ``range`` property or the
+        default range. This property is only intended for use with scales having continuous
+        ranges.
+    rangeMin : str, dict, float, :class:`ExprRef`
+        Sets the minimum value in the scale range, overriding the ``range`` property or the
+        default range. This property is only intended for use with scales having continuous
+        ranges.
+    reverse : bool, dict, :class:`ExprRef`
+        If true, reverses the order of the scale range. **Default value:** ``false``.
+    round : bool, dict, :class:`ExprRef`
+        If ``true``, rounds numeric output values to integers. This can be helpful for
+        snapping to the pixel grid.
+
+        **Default value:** ``false``.
+    scheme : dict, Sequence[str], :class:`ExprRef`, :class:`Cyclical`, :class:`Diverging`, :class:`Categorical`, :class:`ColorScheme`, :class:`SchemeParams`, :class:`SequentialMultiHue`, :class:`SequentialSingleHue`, Literal['rainbow', 'sinebow'], Literal['blues', 'tealblues', 'teals', 'greens', 'browns', 'greys', 'purples', 'warmgreys', 'reds', 'oranges'], Literal['accent', 'category10', 'category20', 'category20b', 'category20c', 'dark2', 'paired', 'pastel1', 'pastel2', 'set1', 'set2', 'set3', 'tableau10', 'tableau20'], Literal['blueorange', 'blueorange-3', 'blueorange-4', 'blueorange-5', 'blueorange-6', 'blueorange-7', 'blueorange-8', 'blueorange-9', 'blueorange-10', 'blueorange-11', 'brownbluegreen', 'brownbluegreen-3', 'brownbluegreen-4', 'brownbluegreen-5', 'brownbluegreen-6', 'brownbluegreen-7', 'brownbluegreen-8', 'brownbluegreen-9', 'brownbluegreen-10', 'brownbluegreen-11', 'purplegreen', 'purplegreen-3', 'purplegreen-4', 'purplegreen-5', 'purplegreen-6', 'purplegreen-7', 'purplegreen-8', 'purplegreen-9', 'purplegreen-10', 'purplegreen-11', 'pinkyellowgreen', 'pinkyellowgreen-3', 'pinkyellowgreen-4', 'pinkyellowgreen-5', 'pinkyellowgreen-6', 'pinkyellowgreen-7', 'pinkyellowgreen-8', 'pinkyellowgreen-9', 'pinkyellowgreen-10', 'pinkyellowgreen-11', 'purpleorange', 'purpleorange-3', 'purpleorange-4', 'purpleorange-5', 'purpleorange-6', 'purpleorange-7', 'purpleorange-8', 'purpleorange-9', 'purpleorange-10', 'purpleorange-11', 'redblue', 'redblue-3', 'redblue-4', 'redblue-5', 'redblue-6', 'redblue-7', 'redblue-8', 'redblue-9', 'redblue-10', 'redblue-11', 'redgrey', 'redgrey-3', 'redgrey-4', 'redgrey-5', 'redgrey-6', 'redgrey-7', 'redgrey-8', 'redgrey-9', 'redgrey-10', 'redgrey-11', 'redyellowblue', 'redyellowblue-3', 'redyellowblue-4', 'redyellowblue-5', 'redyellowblue-6', 'redyellowblue-7', 'redyellowblue-8', 'redyellowblue-9', 'redyellowblue-10', 'redyellowblue-11', 'redyellowgreen', 'redyellowgreen-3', 'redyellowgreen-4', 'redyellowgreen-5', 'redyellowgreen-6', 'redyellowgreen-7', 'redyellowgreen-8', 'redyellowgreen-9', 'redyellowgreen-10', 'redyellowgreen-11', 'spectral', 'spectral-3', 'spectral-4', 'spectral-5', 'spectral-6', 'spectral-7', 'spectral-8', 'spectral-9', 'spectral-10', 'spectral-11'], Literal['turbo', 'viridis', 'inferno', 'magma', 'plasma', 'cividis', 'bluegreen', 'bluegreen-3', 'bluegreen-4', 'bluegreen-5', 'bluegreen-6', 'bluegreen-7', 'bluegreen-8', 'bluegreen-9', 'bluepurple', 'bluepurple-3', 'bluepurple-4', 'bluepurple-5', 'bluepurple-6', 'bluepurple-7', 'bluepurple-8', 'bluepurple-9', 'goldgreen', 'goldgreen-3', 'goldgreen-4', 'goldgreen-5', 'goldgreen-6', 'goldgreen-7', 'goldgreen-8', 'goldgreen-9', 'goldorange', 'goldorange-3', 'goldorange-4', 'goldorange-5', 'goldorange-6', 'goldorange-7', 'goldorange-8', 'goldorange-9', 'goldred', 'goldred-3', 'goldred-4', 'goldred-5', 'goldred-6', 'goldred-7', 'goldred-8', 'goldred-9', 'greenblue', 'greenblue-3', 'greenblue-4', 'greenblue-5', 'greenblue-6', 'greenblue-7', 'greenblue-8', 'greenblue-9', 'orangered', 'orangered-3', 'orangered-4', 'orangered-5', 'orangered-6', 'orangered-7', 'orangered-8', 'orangered-9', 'purplebluegreen', 'purplebluegreen-3', 'purplebluegreen-4', 'purplebluegreen-5', 'purplebluegreen-6', 'purplebluegreen-7', 'purplebluegreen-8', 'purplebluegreen-9', 'purpleblue', 'purpleblue-3', 'purpleblue-4', 'purpleblue-5', 'purpleblue-6', 'purpleblue-7', 'purpleblue-8', 'purpleblue-9', 'purplered', 'purplered-3', 'purplered-4', 'purplered-5', 'purplered-6', 'purplered-7', 'purplered-8', 'purplered-9', 'redpurple', 'redpurple-3', 'redpurple-4', 'redpurple-5', 'redpurple-6', 'redpurple-7', 'redpurple-8', 'redpurple-9', 'yellowgreenblue', 'yellowgreenblue-3', 'yellowgreenblue-4', 'yellowgreenblue-5', 'yellowgreenblue-6', 'yellowgreenblue-7', 'yellowgreenblue-8', 'yellowgreenblue-9', 'yellowgreen', 'yellowgreen-3', 'yellowgreen-4', 'yellowgreen-5', 'yellowgreen-6', 'yellowgreen-7', 'yellowgreen-8', 'yellowgreen-9', 'yelloworangebrown', 'yelloworangebrown-3', 'yelloworangebrown-4', 'yelloworangebrown-5', 'yelloworangebrown-6', 'yelloworangebrown-7', 'yelloworangebrown-8', 'yelloworangebrown-9', 'yelloworangered', 'yelloworangered-3', 'yelloworangered-4', 'yelloworangered-5', 'yelloworangered-6', 'yelloworangered-7', 'yelloworangered-8', 'yelloworangered-9', 'darkblue', 'darkblue-3', 'darkblue-4', 'darkblue-5', 'darkblue-6', 'darkblue-7', 'darkblue-8', 'darkblue-9', 'darkgold', 'darkgold-3', 'darkgold-4', 'darkgold-5', 'darkgold-6', 'darkgold-7', 'darkgold-8', 'darkgold-9', 'darkgreen', 'darkgreen-3', 'darkgreen-4', 'darkgreen-5', 'darkgreen-6', 'darkgreen-7', 'darkgreen-8', 'darkgreen-9', 'darkmulti', 'darkmulti-3', 'darkmulti-4', 'darkmulti-5', 'darkmulti-6', 'darkmulti-7', 'darkmulti-8', 'darkmulti-9', 'darkred', 'darkred-3', 'darkred-4', 'darkred-5', 'darkred-6', 'darkred-7', 'darkred-8', 'darkred-9', 'lightgreyred', 'lightgreyred-3', 'lightgreyred-4', 'lightgreyred-5', 'lightgreyred-6', 'lightgreyred-7', 'lightgreyred-8', 'lightgreyred-9', 'lightgreyteal', 'lightgreyteal-3', 'lightgreyteal-4', 'lightgreyteal-5', 'lightgreyteal-6', 'lightgreyteal-7', 'lightgreyteal-8', 'lightgreyteal-9', 'lightmulti', 'lightmulti-3', 'lightmulti-4', 'lightmulti-5', 'lightmulti-6', 'lightmulti-7', 'lightmulti-8', 'lightmulti-9', 'lightorange', 'lightorange-3', 'lightorange-4', 'lightorange-5', 'lightorange-6', 'lightorange-7', 'lightorange-8', 'lightorange-9', 'lighttealblue', 'lighttealblue-3', 'lighttealblue-4', 'lighttealblue-5', 'lighttealblue-6', 'lighttealblue-7', 'lighttealblue-8', 'lighttealblue-9']
+        A string indicating a color `scheme
+        <https://vega.github.io/vega-lite/docs/scale.html#scheme>`__ name (e.g.,
+        ``"category10"`` or ``"blues"`` ) or a `scheme parameter object
+        <https://vega.github.io/vega-lite/docs/scale.html#scheme-params>`__.
+
+        Discrete color schemes may be used with `discrete
+        <https://vega.github.io/vega-lite/docs/scale.html#discrete>`__ or `discretizing
+        <https://vega.github.io/vega-lite/docs/scale.html#discretizing>`__ scales.
+        Continuous color schemes are intended for use with color scales.
+
+        For the full list of supported schemes, please refer to the `Vega Scheme
+        <https://vega.github.io/vega/docs/schemes/#reference>`__ reference.
+    type : :class:`ScaleType`, Literal['linear', 'log', 'pow', 'sqrt', 'symlog', 'identity', 'sequential', 'time', 'utc', 'quantile', 'quantize', 'threshold', 'bin-ordinal', 'ordinal', 'point', 'band']
+        The type of scale. Vega-Lite supports the following categories of scale types:
+
+        1) `Continuous Scales
+        <https://vega.github.io/vega-lite/docs/scale.html#continuous>`__ -- mapping
+        continuous domains to continuous output ranges ( `"linear"
+        <https://vega.github.io/vega-lite/docs/scale.html#linear>`__, `"pow"
+        <https://vega.github.io/vega-lite/docs/scale.html#pow>`__, `"sqrt"
+        <https://vega.github.io/vega-lite/docs/scale.html#sqrt>`__, `"symlog"
+        <https://vega.github.io/vega-lite/docs/scale.html#symlog>`__, `"log"
+        <https://vega.github.io/vega-lite/docs/scale.html#log>`__, `"time"
+        <https://vega.github.io/vega-lite/docs/scale.html#time>`__, `"utc"
+        <https://vega.github.io/vega-lite/docs/scale.html#utc>`__.
+
+        2) `Discrete Scales <https://vega.github.io/vega-lite/docs/scale.html#discrete>`__
+        -- mapping discrete domains to discrete ( `"ordinal"
+        <https://vega.github.io/vega-lite/docs/scale.html#ordinal>`__ ) or continuous (
+        `"band" <https://vega.github.io/vega-lite/docs/scale.html#band>`__ and `"point"
+        <https://vega.github.io/vega-lite/docs/scale.html#point>`__ ) output ranges.
+
+        3) `Discretizing Scales
+        <https://vega.github.io/vega-lite/docs/scale.html#discretizing>`__ -- mapping
+        continuous domains to discrete output ranges `"bin-ordinal"
+        <https://vega.github.io/vega-lite/docs/scale.html#bin-ordinal>`__, `"quantile"
+        <https://vega.github.io/vega-lite/docs/scale.html#quantile>`__, `"quantize"
+        <https://vega.github.io/vega-lite/docs/scale.html#quantize>`__ and `"threshold"
+        <https://vega.github.io/vega-lite/docs/scale.html#threshold>`__.
+
+        **Default value:** please see the `scale type table
+        <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+    zero : bool, dict, :class:`ExprRef`
+        If ``true``, ensures that a zero baseline value is included in the scale domain.
+
+        **Default value:** ``true`` for x and y channels if the quantitative field is not
+        binned and no custom ``domain`` is provided; ``false`` otherwise.
+
+        **Note:** Log, time, and utc scales do not support ``zero``.
+    """
+
+    _schema = {"$ref": "#/definitions/Scale"}
+
+    def __init__(
+        self,
+        align: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        base: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        bins: Union[dict, "SchemaBase", Sequence[float], UndefinedType] = Undefined,
+        clamp: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        constant: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        domain: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Sequence[Union[str, bool, dict, None, float, "_Parameter", "SchemaBase"]],
+            UndefinedType,
+        ] = Undefined,
+        domainMax: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        domainMid: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        domainMin: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        domainRaw: Union[dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        exponent: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "rgb",
+                "lab",
+                "hcl",
+                "hsl",
+                "hsl-long",
+                "hcl-long",
+                "cubehelix",
+                "cubehelix-long",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        nice: Union[
+            bool,
+            dict,
+            float,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        padding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        paddingInner: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        paddingOuter: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        range: Union[
+            dict,
+            "SchemaBase",
+            Sequence[
+                Union[str, dict, float, "_Parameter", "SchemaBase", Sequence[float]]
+            ],
+            Literal[
+                "width",
+                "height",
+                "symbol",
+                "category",
+                "ordinal",
+                "ramp",
+                "diverging",
+                "heatmap",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        rangeMax: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        rangeMin: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        reverse: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        round: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        scheme: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Sequence[str],
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal[
+                "linear",
+                "log",
+                "pow",
+                "sqrt",
+                "symlog",
+                "identity",
+                "sequential",
+                "time",
+                "utc",
+                "quantile",
+                "quantize",
+                "threshold",
+                "bin-ordinal",
+                "ordinal",
+                "point",
+                "band",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        zero: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(Scale, self).__init__(
+            align=align,
+            base=base,
+            bins=bins,
+            clamp=clamp,
+            constant=constant,
+            domain=domain,
+            domainMax=domainMax,
+            domainMid=domainMid,
+            domainMin=domainMin,
+            domainRaw=domainRaw,
+            exponent=exponent,
+            interpolate=interpolate,
+            nice=nice,
+            padding=padding,
+            paddingInner=paddingInner,
+            paddingOuter=paddingOuter,
+            range=range,
+            rangeMax=rangeMax,
+            rangeMin=rangeMin,
+            reverse=reverse,
+            round=round,
+            scheme=scheme,
+            type=type,
+            zero=zero,
+            **kwds,
+        )
+
+
+class ScaleBins(VegaLiteSchema):
+    """ScaleBins schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ScaleBins"}
+
+    def __init__(self, *args, **kwds):
+        super(ScaleBins, self).__init__(*args, **kwds)
+
+
+class ScaleBinParams(ScaleBins):
+    """ScaleBinParams schema wrapper
+
+    Parameters
+    ----------
+
+    step : float
+        The step size defining the bin interval width.
+    start : float
+        The starting (lowest-valued) bin boundary.
+
+        **Default value:** The lowest value of the scale domain will be used.
+    stop : float
+        The stopping (highest-valued) bin boundary.
+
+        **Default value:** The highest value of the scale domain will be used.
+    """
+
+    _schema = {"$ref": "#/definitions/ScaleBinParams"}
+
+    def __init__(
+        self,
+        step: Union[float, UndefinedType] = Undefined,
+        start: Union[float, UndefinedType] = Undefined,
+        stop: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ScaleBinParams, self).__init__(step=step, start=start, stop=stop, **kwds)
+
+
+class ScaleConfig(VegaLiteSchema):
+    """ScaleConfig schema wrapper
+
+    Parameters
+    ----------
+
+    bandPaddingInner : dict, float, :class:`ExprRef`
+        Default inner padding for ``x`` and ``y`` band scales.
+
+        **Default value:**
+
+
+        * ``nestedOffsetPaddingInner`` for x/y scales with nested x/y offset scales.
+        * ``barBandPaddingInner`` for bar marks ( ``0.1`` by default)
+        * ``rectBandPaddingInner`` for rect and other marks ( ``0`` by default)
+    bandPaddingOuter : dict, float, :class:`ExprRef`
+        Default outer padding for ``x`` and ``y`` band scales.
+
+        **Default value:** ``paddingInner/2`` (which makes *width/height = number of unique
+        values * step* )
+    bandWithNestedOffsetPaddingInner : dict, float, :class:`ExprRef`
+        Default inner padding for ``x`` and ``y`` band scales with nested ``xOffset`` and
+        ``yOffset`` encoding.
+
+        **Default value:** ``0.2``
+    bandWithNestedOffsetPaddingOuter : dict, float, :class:`ExprRef`
+        Default outer padding for ``x`` and ``y`` band scales with nested ``xOffset`` and
+        ``yOffset`` encoding.
+
+        **Default value:** ``0.2``
+    barBandPaddingInner : dict, float, :class:`ExprRef`
+        Default inner padding for ``x`` and ``y`` band-ordinal scales of ``"bar"`` marks.
+
+        **Default value:** ``0.1``
+    clamp : bool, dict, :class:`ExprRef`
+        If true, values that exceed the data domain are clamped to either the minimum or
+        maximum range value
+    continuousPadding : dict, float, :class:`ExprRef`
+        Default padding for continuous x/y scales.
+
+        **Default:** The bar width for continuous x-scale of a vertical bar and continuous
+        y-scale of a horizontal bar.; ``0`` otherwise.
+    maxBandSize : float
+        The default max value for mapping quantitative fields to bar's size/bandSize.
+
+        If undefined (default), we will use the axis's size (width or height) - 1.
+    maxFontSize : float
+        The default max value for mapping quantitative fields to text's size/fontSize.
+
+        **Default value:** ``40``
+    maxOpacity : float
+        Default max opacity for mapping a field to opacity.
+
+        **Default value:** ``0.8``
+    maxSize : float
+        Default max value for point size scale.
+    maxStrokeWidth : float
+        Default max strokeWidth for the scale of strokeWidth for rule and line marks and of
+        size for trail marks.
+
+        **Default value:** ``4``
+    minBandSize : float
+        The default min value for mapping quantitative fields to bar and tick's
+        size/bandSize scale with zero=false.
+
+        **Default value:** ``2``
+    minFontSize : float
+        The default min value for mapping quantitative fields to tick's size/fontSize scale
+        with zero=false
+
+        **Default value:** ``8``
+    minOpacity : float
+        Default minimum opacity for mapping a field to opacity.
+
+        **Default value:** ``0.3``
+    minSize : float
+        Default minimum value for point size scale with zero=false.
+
+        **Default value:** ``9``
+    minStrokeWidth : float
+        Default minimum strokeWidth for the scale of strokeWidth for rule and line marks and
+        of size for trail marks with zero=false.
+
+        **Default value:** ``1``
+    offsetBandPaddingInner : dict, float, :class:`ExprRef`
+        Default padding inner for xOffset/yOffset's band scales.
+
+        **Default Value:** ``0``
+    offsetBandPaddingOuter : dict, float, :class:`ExprRef`
+        Default padding outer for xOffset/yOffset's band scales.
+
+        **Default Value:** ``0``
+    pointPadding : dict, float, :class:`ExprRef`
+        Default outer padding for ``x`` and ``y`` point-ordinal scales.
+
+        **Default value:** ``0.5`` (which makes *width/height = number of unique values *
+        step* )
+    quantileCount : float
+        Default range cardinality for `quantile
+        <https://vega.github.io/vega-lite/docs/scale.html#quantile>`__ scale.
+
+        **Default value:** ``4``
+    quantizeCount : float
+        Default range cardinality for `quantize
+        <https://vega.github.io/vega-lite/docs/scale.html#quantize>`__ scale.
+
+        **Default value:** ``4``
+    rectBandPaddingInner : dict, float, :class:`ExprRef`
+        Default inner padding for ``x`` and ``y`` band-ordinal scales of ``"rect"`` marks.
+
+        **Default value:** ``0``
+    round : bool, dict, :class:`ExprRef`
+        If true, rounds numeric output values to integers. This can be helpful for snapping
+        to the pixel grid. (Only available for ``x``, ``y``, and ``size`` scales.)
+    useUnaggregatedDomain : bool
+        Use the source data range before aggregation as scale domain instead of aggregated
+        data for aggregate axis.
+
+        This is equivalent to setting ``domain`` to ``"unaggregate"`` for aggregated
+        *quantitative* fields by default.
+
+        This property only works with aggregate functions that produce values within the raw
+        data domain ( ``"mean"``, ``"average"``, ``"median"``, ``"q1"``, ``"q3"``,
+        ``"min"``, ``"max"`` ). For other aggregations that produce values outside of the
+        raw data domain (e.g. ``"count"``, ``"sum"`` ), this property is ignored.
+
+        **Default value:** ``false``
+    xReverse : bool, dict, :class:`ExprRef`
+        Reverse x-scale by default (useful for right-to-left charts).
+    zero : bool
+        Default ``scale.zero`` for `continuous
+        <https://vega.github.io/vega-lite/docs/scale.html#continuous>`__ scales except for
+        (1) x/y-scales of non-ranged bar or area charts and (2) size scales.
+
+        **Default value:** ``true``
+    """
+
+    _schema = {"$ref": "#/definitions/ScaleConfig"}
+
+    def __init__(
+        self,
+        bandPaddingInner: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        bandPaddingOuter: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        bandWithNestedOffsetPaddingInner: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        bandWithNestedOffsetPaddingOuter: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        barBandPaddingInner: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        clamp: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        continuousPadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        maxBandSize: Union[float, UndefinedType] = Undefined,
+        maxFontSize: Union[float, UndefinedType] = Undefined,
+        maxOpacity: Union[float, UndefinedType] = Undefined,
+        maxSize: Union[float, UndefinedType] = Undefined,
+        maxStrokeWidth: Union[float, UndefinedType] = Undefined,
+        minBandSize: Union[float, UndefinedType] = Undefined,
+        minFontSize: Union[float, UndefinedType] = Undefined,
+        minOpacity: Union[float, UndefinedType] = Undefined,
+        minSize: Union[float, UndefinedType] = Undefined,
+        minStrokeWidth: Union[float, UndefinedType] = Undefined,
+        offsetBandPaddingInner: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        offsetBandPaddingOuter: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        pointPadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        quantileCount: Union[float, UndefinedType] = Undefined,
+        quantizeCount: Union[float, UndefinedType] = Undefined,
+        rectBandPaddingInner: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        round: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        useUnaggregatedDomain: Union[bool, UndefinedType] = Undefined,
+        xReverse: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        zero: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ScaleConfig, self).__init__(
+            bandPaddingInner=bandPaddingInner,
+            bandPaddingOuter=bandPaddingOuter,
+            bandWithNestedOffsetPaddingInner=bandWithNestedOffsetPaddingInner,
+            bandWithNestedOffsetPaddingOuter=bandWithNestedOffsetPaddingOuter,
+            barBandPaddingInner=barBandPaddingInner,
+            clamp=clamp,
+            continuousPadding=continuousPadding,
+            maxBandSize=maxBandSize,
+            maxFontSize=maxFontSize,
+            maxOpacity=maxOpacity,
+            maxSize=maxSize,
+            maxStrokeWidth=maxStrokeWidth,
+            minBandSize=minBandSize,
+            minFontSize=minFontSize,
+            minOpacity=minOpacity,
+            minSize=minSize,
+            minStrokeWidth=minStrokeWidth,
+            offsetBandPaddingInner=offsetBandPaddingInner,
+            offsetBandPaddingOuter=offsetBandPaddingOuter,
+            pointPadding=pointPadding,
+            quantileCount=quantileCount,
+            quantizeCount=quantizeCount,
+            rectBandPaddingInner=rectBandPaddingInner,
+            round=round,
+            useUnaggregatedDomain=useUnaggregatedDomain,
+            xReverse=xReverse,
+            zero=zero,
+            **kwds,
+        )
+
+
+class ScaleDatumDef(OffsetDef):
+    """ScaleDatumDef schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/ScaleDatumDef"}
+
+    def __init__(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        datum: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        scale: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ScaleDatumDef, self).__init__(
+            bandPosition=bandPosition,
+            datum=datum,
+            scale=scale,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class ScaleFieldDef(OffsetDef):
+    """ScaleFieldDef schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/ScaleFieldDef"}
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        scale: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, "SchemaBase"]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ScaleFieldDef, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class ScaleInterpolateEnum(VegaLiteSchema):
+    """ScaleInterpolateEnum schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ScaleInterpolateEnum"}
+
+    def __init__(self, *args):
+        super(ScaleInterpolateEnum, self).__init__(*args)
+
+
+class ScaleInterpolateParams(VegaLiteSchema):
+    """ScaleInterpolateParams schema wrapper
+
+    Parameters
+    ----------
+
+    type : Literal['rgb', 'cubehelix', 'cubehelix-long']
+
+    gamma : float
+
+    """
+
+    _schema = {"$ref": "#/definitions/ScaleInterpolateParams"}
+
+    def __init__(
+        self,
+        type: Union[
+            Literal["rgb", "cubehelix", "cubehelix-long"], UndefinedType
+        ] = Undefined,
+        gamma: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ScaleInterpolateParams, self).__init__(type=type, gamma=gamma, **kwds)
+
+
+class ScaleResolveMap(VegaLiteSchema):
+    """ScaleResolveMap schema wrapper
+
+    Parameters
+    ----------
+
+    angle : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    color : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    fill : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    fillOpacity : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    opacity : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    radius : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    shape : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    size : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    stroke : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    strokeDash : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    strokeOpacity : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    strokeWidth : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    theta : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    x : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    xOffset : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    y : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    yOffset : :class:`ResolveMode`, Literal['independent', 'shared']
+
+    """
+
+    _schema = {"$ref": "#/definitions/ScaleResolveMap"}
+
+    def __init__(
+        self,
+        angle: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        color: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        fill: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        fillOpacity: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        radius: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        shape: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        size: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        strokeDash: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        theta: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        x: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        y: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            "SchemaBase", Literal["independent", "shared"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ScaleResolveMap, self).__init__(
+            angle=angle,
+            color=color,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            opacity=opacity,
+            radius=radius,
+            shape=shape,
+            size=size,
+            stroke=stroke,
+            strokeDash=strokeDash,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            theta=theta,
+            x=x,
+            xOffset=xOffset,
+            y=y,
+            yOffset=yOffset,
+            **kwds,
+        )
+
+
+class ScaleType(VegaLiteSchema):
+    """ScaleType schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ScaleType"}
+
+    def __init__(self, *args):
+        super(ScaleType, self).__init__(*args)
+
+
+class SchemeParams(VegaLiteSchema):
+    """SchemeParams schema wrapper
+
+    Parameters
+    ----------
+
+    name : :class:`Cyclical`, :class:`Diverging`, :class:`Categorical`, :class:`ColorScheme`, :class:`SequentialMultiHue`, :class:`SequentialSingleHue`, Literal['rainbow', 'sinebow'], Literal['blues', 'tealblues', 'teals', 'greens', 'browns', 'greys', 'purples', 'warmgreys', 'reds', 'oranges'], Literal['accent', 'category10', 'category20', 'category20b', 'category20c', 'dark2', 'paired', 'pastel1', 'pastel2', 'set1', 'set2', 'set3', 'tableau10', 'tableau20'], Literal['blueorange', 'blueorange-3', 'blueorange-4', 'blueorange-5', 'blueorange-6', 'blueorange-7', 'blueorange-8', 'blueorange-9', 'blueorange-10', 'blueorange-11', 'brownbluegreen', 'brownbluegreen-3', 'brownbluegreen-4', 'brownbluegreen-5', 'brownbluegreen-6', 'brownbluegreen-7', 'brownbluegreen-8', 'brownbluegreen-9', 'brownbluegreen-10', 'brownbluegreen-11', 'purplegreen', 'purplegreen-3', 'purplegreen-4', 'purplegreen-5', 'purplegreen-6', 'purplegreen-7', 'purplegreen-8', 'purplegreen-9', 'purplegreen-10', 'purplegreen-11', 'pinkyellowgreen', 'pinkyellowgreen-3', 'pinkyellowgreen-4', 'pinkyellowgreen-5', 'pinkyellowgreen-6', 'pinkyellowgreen-7', 'pinkyellowgreen-8', 'pinkyellowgreen-9', 'pinkyellowgreen-10', 'pinkyellowgreen-11', 'purpleorange', 'purpleorange-3', 'purpleorange-4', 'purpleorange-5', 'purpleorange-6', 'purpleorange-7', 'purpleorange-8', 'purpleorange-9', 'purpleorange-10', 'purpleorange-11', 'redblue', 'redblue-3', 'redblue-4', 'redblue-5', 'redblue-6', 'redblue-7', 'redblue-8', 'redblue-9', 'redblue-10', 'redblue-11', 'redgrey', 'redgrey-3', 'redgrey-4', 'redgrey-5', 'redgrey-6', 'redgrey-7', 'redgrey-8', 'redgrey-9', 'redgrey-10', 'redgrey-11', 'redyellowblue', 'redyellowblue-3', 'redyellowblue-4', 'redyellowblue-5', 'redyellowblue-6', 'redyellowblue-7', 'redyellowblue-8', 'redyellowblue-9', 'redyellowblue-10', 'redyellowblue-11', 'redyellowgreen', 'redyellowgreen-3', 'redyellowgreen-4', 'redyellowgreen-5', 'redyellowgreen-6', 'redyellowgreen-7', 'redyellowgreen-8', 'redyellowgreen-9', 'redyellowgreen-10', 'redyellowgreen-11', 'spectral', 'spectral-3', 'spectral-4', 'spectral-5', 'spectral-6', 'spectral-7', 'spectral-8', 'spectral-9', 'spectral-10', 'spectral-11'], Literal['turbo', 'viridis', 'inferno', 'magma', 'plasma', 'cividis', 'bluegreen', 'bluegreen-3', 'bluegreen-4', 'bluegreen-5', 'bluegreen-6', 'bluegreen-7', 'bluegreen-8', 'bluegreen-9', 'bluepurple', 'bluepurple-3', 'bluepurple-4', 'bluepurple-5', 'bluepurple-6', 'bluepurple-7', 'bluepurple-8', 'bluepurple-9', 'goldgreen', 'goldgreen-3', 'goldgreen-4', 'goldgreen-5', 'goldgreen-6', 'goldgreen-7', 'goldgreen-8', 'goldgreen-9', 'goldorange', 'goldorange-3', 'goldorange-4', 'goldorange-5', 'goldorange-6', 'goldorange-7', 'goldorange-8', 'goldorange-9', 'goldred', 'goldred-3', 'goldred-4', 'goldred-5', 'goldred-6', 'goldred-7', 'goldred-8', 'goldred-9', 'greenblue', 'greenblue-3', 'greenblue-4', 'greenblue-5', 'greenblue-6', 'greenblue-7', 'greenblue-8', 'greenblue-9', 'orangered', 'orangered-3', 'orangered-4', 'orangered-5', 'orangered-6', 'orangered-7', 'orangered-8', 'orangered-9', 'purplebluegreen', 'purplebluegreen-3', 'purplebluegreen-4', 'purplebluegreen-5', 'purplebluegreen-6', 'purplebluegreen-7', 'purplebluegreen-8', 'purplebluegreen-9', 'purpleblue', 'purpleblue-3', 'purpleblue-4', 'purpleblue-5', 'purpleblue-6', 'purpleblue-7', 'purpleblue-8', 'purpleblue-9', 'purplered', 'purplered-3', 'purplered-4', 'purplered-5', 'purplered-6', 'purplered-7', 'purplered-8', 'purplered-9', 'redpurple', 'redpurple-3', 'redpurple-4', 'redpurple-5', 'redpurple-6', 'redpurple-7', 'redpurple-8', 'redpurple-9', 'yellowgreenblue', 'yellowgreenblue-3', 'yellowgreenblue-4', 'yellowgreenblue-5', 'yellowgreenblue-6', 'yellowgreenblue-7', 'yellowgreenblue-8', 'yellowgreenblue-9', 'yellowgreen', 'yellowgreen-3', 'yellowgreen-4', 'yellowgreen-5', 'yellowgreen-6', 'yellowgreen-7', 'yellowgreen-8', 'yellowgreen-9', 'yelloworangebrown', 'yelloworangebrown-3', 'yelloworangebrown-4', 'yelloworangebrown-5', 'yelloworangebrown-6', 'yelloworangebrown-7', 'yelloworangebrown-8', 'yelloworangebrown-9', 'yelloworangered', 'yelloworangered-3', 'yelloworangered-4', 'yelloworangered-5', 'yelloworangered-6', 'yelloworangered-7', 'yelloworangered-8', 'yelloworangered-9', 'darkblue', 'darkblue-3', 'darkblue-4', 'darkblue-5', 'darkblue-6', 'darkblue-7', 'darkblue-8', 'darkblue-9', 'darkgold', 'darkgold-3', 'darkgold-4', 'darkgold-5', 'darkgold-6', 'darkgold-7', 'darkgold-8', 'darkgold-9', 'darkgreen', 'darkgreen-3', 'darkgreen-4', 'darkgreen-5', 'darkgreen-6', 'darkgreen-7', 'darkgreen-8', 'darkgreen-9', 'darkmulti', 'darkmulti-3', 'darkmulti-4', 'darkmulti-5', 'darkmulti-6', 'darkmulti-7', 'darkmulti-8', 'darkmulti-9', 'darkred', 'darkred-3', 'darkred-4', 'darkred-5', 'darkred-6', 'darkred-7', 'darkred-8', 'darkred-9', 'lightgreyred', 'lightgreyred-3', 'lightgreyred-4', 'lightgreyred-5', 'lightgreyred-6', 'lightgreyred-7', 'lightgreyred-8', 'lightgreyred-9', 'lightgreyteal', 'lightgreyteal-3', 'lightgreyteal-4', 'lightgreyteal-5', 'lightgreyteal-6', 'lightgreyteal-7', 'lightgreyteal-8', 'lightgreyteal-9', 'lightmulti', 'lightmulti-3', 'lightmulti-4', 'lightmulti-5', 'lightmulti-6', 'lightmulti-7', 'lightmulti-8', 'lightmulti-9', 'lightorange', 'lightorange-3', 'lightorange-4', 'lightorange-5', 'lightorange-6', 'lightorange-7', 'lightorange-8', 'lightorange-9', 'lighttealblue', 'lighttealblue-3', 'lighttealblue-4', 'lighttealblue-5', 'lighttealblue-6', 'lighttealblue-7', 'lighttealblue-8', 'lighttealblue-9']
+        A color scheme name for ordinal scales (e.g., ``"category10"`` or ``"blues"`` ).
+
+        For the full list of supported schemes, please refer to the `Vega Scheme
+        <https://vega.github.io/vega/docs/schemes/#reference>`__ reference.
+    count : float
+        The number of colors to use in the scheme. This can be useful for scale types such
+        as ``"quantize"``, which use the length of the scale range to determine the number
+        of discrete bins for the scale domain.
+    extent : Sequence[float]
+        The extent of the color range to use. For example ``[0.2, 1]`` will rescale the
+        color scheme such that color values in the range *[0, 0.2)* are excluded from the
+        scheme.
+    """
+
+    _schema = {"$ref": "#/definitions/SchemeParams"}
+
+    def __init__(
+        self,
+        name: Union[
+            "SchemaBase",
+            Literal["rainbow", "sinebow"],
+            Literal[
+                "blues",
+                "tealblues",
+                "teals",
+                "greens",
+                "browns",
+                "greys",
+                "purples",
+                "warmgreys",
+                "reds",
+                "oranges",
+            ],
+            Literal[
+                "accent",
+                "category10",
+                "category20",
+                "category20b",
+                "category20c",
+                "dark2",
+                "paired",
+                "pastel1",
+                "pastel2",
+                "set1",
+                "set2",
+                "set3",
+                "tableau10",
+                "tableau20",
+            ],
+            Literal[
+                "blueorange",
+                "blueorange-3",
+                "blueorange-4",
+                "blueorange-5",
+                "blueorange-6",
+                "blueorange-7",
+                "blueorange-8",
+                "blueorange-9",
+                "blueorange-10",
+                "blueorange-11",
+                "brownbluegreen",
+                "brownbluegreen-3",
+                "brownbluegreen-4",
+                "brownbluegreen-5",
+                "brownbluegreen-6",
+                "brownbluegreen-7",
+                "brownbluegreen-8",
+                "brownbluegreen-9",
+                "brownbluegreen-10",
+                "brownbluegreen-11",
+                "purplegreen",
+                "purplegreen-3",
+                "purplegreen-4",
+                "purplegreen-5",
+                "purplegreen-6",
+                "purplegreen-7",
+                "purplegreen-8",
+                "purplegreen-9",
+                "purplegreen-10",
+                "purplegreen-11",
+                "pinkyellowgreen",
+                "pinkyellowgreen-3",
+                "pinkyellowgreen-4",
+                "pinkyellowgreen-5",
+                "pinkyellowgreen-6",
+                "pinkyellowgreen-7",
+                "pinkyellowgreen-8",
+                "pinkyellowgreen-9",
+                "pinkyellowgreen-10",
+                "pinkyellowgreen-11",
+                "purpleorange",
+                "purpleorange-3",
+                "purpleorange-4",
+                "purpleorange-5",
+                "purpleorange-6",
+                "purpleorange-7",
+                "purpleorange-8",
+                "purpleorange-9",
+                "purpleorange-10",
+                "purpleorange-11",
+                "redblue",
+                "redblue-3",
+                "redblue-4",
+                "redblue-5",
+                "redblue-6",
+                "redblue-7",
+                "redblue-8",
+                "redblue-9",
+                "redblue-10",
+                "redblue-11",
+                "redgrey",
+                "redgrey-3",
+                "redgrey-4",
+                "redgrey-5",
+                "redgrey-6",
+                "redgrey-7",
+                "redgrey-8",
+                "redgrey-9",
+                "redgrey-10",
+                "redgrey-11",
+                "redyellowblue",
+                "redyellowblue-3",
+                "redyellowblue-4",
+                "redyellowblue-5",
+                "redyellowblue-6",
+                "redyellowblue-7",
+                "redyellowblue-8",
+                "redyellowblue-9",
+                "redyellowblue-10",
+                "redyellowblue-11",
+                "redyellowgreen",
+                "redyellowgreen-3",
+                "redyellowgreen-4",
+                "redyellowgreen-5",
+                "redyellowgreen-6",
+                "redyellowgreen-7",
+                "redyellowgreen-8",
+                "redyellowgreen-9",
+                "redyellowgreen-10",
+                "redyellowgreen-11",
+                "spectral",
+                "spectral-3",
+                "spectral-4",
+                "spectral-5",
+                "spectral-6",
+                "spectral-7",
+                "spectral-8",
+                "spectral-9",
+                "spectral-10",
+                "spectral-11",
+            ],
+            Literal[
+                "turbo",
+                "viridis",
+                "inferno",
+                "magma",
+                "plasma",
+                "cividis",
+                "bluegreen",
+                "bluegreen-3",
+                "bluegreen-4",
+                "bluegreen-5",
+                "bluegreen-6",
+                "bluegreen-7",
+                "bluegreen-8",
+                "bluegreen-9",
+                "bluepurple",
+                "bluepurple-3",
+                "bluepurple-4",
+                "bluepurple-5",
+                "bluepurple-6",
+                "bluepurple-7",
+                "bluepurple-8",
+                "bluepurple-9",
+                "goldgreen",
+                "goldgreen-3",
+                "goldgreen-4",
+                "goldgreen-5",
+                "goldgreen-6",
+                "goldgreen-7",
+                "goldgreen-8",
+                "goldgreen-9",
+                "goldorange",
+                "goldorange-3",
+                "goldorange-4",
+                "goldorange-5",
+                "goldorange-6",
+                "goldorange-7",
+                "goldorange-8",
+                "goldorange-9",
+                "goldred",
+                "goldred-3",
+                "goldred-4",
+                "goldred-5",
+                "goldred-6",
+                "goldred-7",
+                "goldred-8",
+                "goldred-9",
+                "greenblue",
+                "greenblue-3",
+                "greenblue-4",
+                "greenblue-5",
+                "greenblue-6",
+                "greenblue-7",
+                "greenblue-8",
+                "greenblue-9",
+                "orangered",
+                "orangered-3",
+                "orangered-4",
+                "orangered-5",
+                "orangered-6",
+                "orangered-7",
+                "orangered-8",
+                "orangered-9",
+                "purplebluegreen",
+                "purplebluegreen-3",
+                "purplebluegreen-4",
+                "purplebluegreen-5",
+                "purplebluegreen-6",
+                "purplebluegreen-7",
+                "purplebluegreen-8",
+                "purplebluegreen-9",
+                "purpleblue",
+                "purpleblue-3",
+                "purpleblue-4",
+                "purpleblue-5",
+                "purpleblue-6",
+                "purpleblue-7",
+                "purpleblue-8",
+                "purpleblue-9",
+                "purplered",
+                "purplered-3",
+                "purplered-4",
+                "purplered-5",
+                "purplered-6",
+                "purplered-7",
+                "purplered-8",
+                "purplered-9",
+                "redpurple",
+                "redpurple-3",
+                "redpurple-4",
+                "redpurple-5",
+                "redpurple-6",
+                "redpurple-7",
+                "redpurple-8",
+                "redpurple-9",
+                "yellowgreenblue",
+                "yellowgreenblue-3",
+                "yellowgreenblue-4",
+                "yellowgreenblue-5",
+                "yellowgreenblue-6",
+                "yellowgreenblue-7",
+                "yellowgreenblue-8",
+                "yellowgreenblue-9",
+                "yellowgreen",
+                "yellowgreen-3",
+                "yellowgreen-4",
+                "yellowgreen-5",
+                "yellowgreen-6",
+                "yellowgreen-7",
+                "yellowgreen-8",
+                "yellowgreen-9",
+                "yelloworangebrown",
+                "yelloworangebrown-3",
+                "yelloworangebrown-4",
+                "yelloworangebrown-5",
+                "yelloworangebrown-6",
+                "yelloworangebrown-7",
+                "yelloworangebrown-8",
+                "yelloworangebrown-9",
+                "yelloworangered",
+                "yelloworangered-3",
+                "yelloworangered-4",
+                "yelloworangered-5",
+                "yelloworangered-6",
+                "yelloworangered-7",
+                "yelloworangered-8",
+                "yelloworangered-9",
+                "darkblue",
+                "darkblue-3",
+                "darkblue-4",
+                "darkblue-5",
+                "darkblue-6",
+                "darkblue-7",
+                "darkblue-8",
+                "darkblue-9",
+                "darkgold",
+                "darkgold-3",
+                "darkgold-4",
+                "darkgold-5",
+                "darkgold-6",
+                "darkgold-7",
+                "darkgold-8",
+                "darkgold-9",
+                "darkgreen",
+                "darkgreen-3",
+                "darkgreen-4",
+                "darkgreen-5",
+                "darkgreen-6",
+                "darkgreen-7",
+                "darkgreen-8",
+                "darkgreen-9",
+                "darkmulti",
+                "darkmulti-3",
+                "darkmulti-4",
+                "darkmulti-5",
+                "darkmulti-6",
+                "darkmulti-7",
+                "darkmulti-8",
+                "darkmulti-9",
+                "darkred",
+                "darkred-3",
+                "darkred-4",
+                "darkred-5",
+                "darkred-6",
+                "darkred-7",
+                "darkred-8",
+                "darkred-9",
+                "lightgreyred",
+                "lightgreyred-3",
+                "lightgreyred-4",
+                "lightgreyred-5",
+                "lightgreyred-6",
+                "lightgreyred-7",
+                "lightgreyred-8",
+                "lightgreyred-9",
+                "lightgreyteal",
+                "lightgreyteal-3",
+                "lightgreyteal-4",
+                "lightgreyteal-5",
+                "lightgreyteal-6",
+                "lightgreyteal-7",
+                "lightgreyteal-8",
+                "lightgreyteal-9",
+                "lightmulti",
+                "lightmulti-3",
+                "lightmulti-4",
+                "lightmulti-5",
+                "lightmulti-6",
+                "lightmulti-7",
+                "lightmulti-8",
+                "lightmulti-9",
+                "lightorange",
+                "lightorange-3",
+                "lightorange-4",
+                "lightorange-5",
+                "lightorange-6",
+                "lightorange-7",
+                "lightorange-8",
+                "lightorange-9",
+                "lighttealblue",
+                "lighttealblue-3",
+                "lighttealblue-4",
+                "lighttealblue-5",
+                "lighttealblue-6",
+                "lighttealblue-7",
+                "lighttealblue-8",
+                "lighttealblue-9",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        count: Union[float, UndefinedType] = Undefined,
+        extent: Union[Sequence[float], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(SchemeParams, self).__init__(
+            name=name, count=count, extent=extent, **kwds
+        )
+
+
+class SecondaryFieldDef(Position2Def):
+    """SecondaryFieldDef schema wrapper
+    A field definition of a secondary channel that shares a scale with another primary channel.
+    For example, ``x2``, ``xError`` and ``xError2`` share the same scale with ``x``.
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : None
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    """
+
+    _schema = {"$ref": "#/definitions/SecondaryFieldDef"}
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[None, UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(SecondaryFieldDef, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            **kwds,
+        )
+
+
+class SelectionConfig(VegaLiteSchema):
+    """SelectionConfig schema wrapper
+
+    Parameters
+    ----------
+
+    interval : dict, :class:`IntervalSelectionConfigWithoutType`
+        The default definition for an `interval
+        <https://vega.github.io/vega-lite/docs/parameter.html#select>`__ selection. All
+        properties and transformations for an interval selection definition (except ``type``
+        ) may be specified here.
+
+        For instance, setting ``interval`` to ``{"translate": false}`` disables the ability
+        to move interval selections by default.
+    point : dict, :class:`PointSelectionConfigWithoutType`
+        The default definition for a `point
+        <https://vega.github.io/vega-lite/docs/parameter.html#select>`__ selection. All
+        properties and transformations  for a point selection definition (except ``type`` )
+        may be specified here.
+
+        For instance, setting ``point`` to ``{"on": "dblclick"}`` populates point selections
+        on double-click by default.
+    """
+
+    _schema = {"$ref": "#/definitions/SelectionConfig"}
+
+    def __init__(
+        self,
+        interval: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        point: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(SelectionConfig, self).__init__(interval=interval, point=point, **kwds)
+
+
+class SelectionInit(VegaLiteSchema):
+    """SelectionInit schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SelectionInit"}
+
+    def __init__(self, *args, **kwds):
+        super(SelectionInit, self).__init__(*args, **kwds)
+
+
+class DateTime(SelectionInit):
+    """DateTime schema wrapper
+    Object for defining datetime in Vega-Lite Filter. If both month and quarter are provided,
+    month has higher precedence. ``day`` cannot be combined with other date. We accept string
+    for month and day names.
+
+    Parameters
+    ----------
+
+    date : float
+        Integer value representing the date (day of the month) from 1-31.
+    day : str, float, :class:`Day`
+        Value representing the day of a week. This can be one of: (1) integer value -- ``1``
+        represents Monday; (2) case-insensitive day name (e.g., ``"Monday"`` ); (3)
+        case-insensitive, 3-character short day name (e.g., ``"Mon"`` ).
+
+        **Warning:** A DateTime definition object with ``day`` ** should not be combined
+        with ``year``, ``quarter``, ``month``, or ``date``.
+    hours : float
+        Integer value representing the hour of a day from 0-23.
+    milliseconds : float
+        Integer value representing the millisecond segment of time.
+    minutes : float
+        Integer value representing the minute segment of time from 0-59.
+    month : str, float, :class:`Month`
+        One of: (1) integer value representing the month from ``1`` - ``12``. ``1``
+        represents January; (2) case-insensitive month name (e.g., ``"January"`` ); (3)
+        case-insensitive, 3-character short month name (e.g., ``"Jan"`` ).
+    quarter : float
+        Integer value representing the quarter of the year (from 1-4).
+    seconds : float
+        Integer value representing the second segment (0-59) of a time value
+    utc : bool
+        A boolean flag indicating if date time is in utc time. If false, the date time is in
+        local time
+    year : float
+        Integer value representing the year.
+    """
+
+    _schema = {"$ref": "#/definitions/DateTime"}
+
+    def __init__(
+        self,
+        date: Union[float, UndefinedType] = Undefined,
+        day: Union[str, float, "SchemaBase", UndefinedType] = Undefined,
+        hours: Union[float, UndefinedType] = Undefined,
+        milliseconds: Union[float, UndefinedType] = Undefined,
+        minutes: Union[float, UndefinedType] = Undefined,
+        month: Union[str, float, "SchemaBase", UndefinedType] = Undefined,
+        quarter: Union[float, UndefinedType] = Undefined,
+        seconds: Union[float, UndefinedType] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        year: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(DateTime, self).__init__(
+            date=date,
+            day=day,
+            hours=hours,
+            milliseconds=milliseconds,
+            minutes=minutes,
+            month=month,
+            quarter=quarter,
+            seconds=seconds,
+            utc=utc,
+            year=year,
+            **kwds,
+        )
+
+
+class PrimitiveValue(SelectionInit):
+    """PrimitiveValue schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/PrimitiveValue"}
+
+    def __init__(self, *args):
+        super(PrimitiveValue, self).__init__(*args)
+
+
+class SelectionInitInterval(VegaLiteSchema):
+    """SelectionInitInterval schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SelectionInitInterval"}
+
+    def __init__(self, *args, **kwds):
+        super(SelectionInitInterval, self).__init__(*args, **kwds)
+
+
+class SelectionInitIntervalMapping(VegaLiteSchema):
+    """SelectionInitIntervalMapping schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SelectionInitIntervalMapping"}
+
+    def __init__(self, **kwds):
+        super(SelectionInitIntervalMapping, self).__init__(**kwds)
+
+
+class SelectionInitMapping(VegaLiteSchema):
+    """SelectionInitMapping schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SelectionInitMapping"}
+
+    def __init__(self, **kwds):
+        super(SelectionInitMapping, self).__init__(**kwds)
+
+
+class SelectionParameter(VegaLiteSchema):
+    """SelectionParameter schema wrapper
+
+    Parameters
+    ----------
+
+    name : str, :class:`ParameterName`
+        Required. A unique name for the selection parameter. Selection names should be valid
+        JavaScript identifiers: they should contain only alphanumeric characters (or "$", or
+        "_") and may not start with a digit. Reserved keywords that may not be used as
+        parameter names are "datum", "event", "item", and "parent".
+    select : dict, :class:`SelectionType`, Literal['point', 'interval'], :class:`PointSelectionConfig`, :class:`IntervalSelectionConfig`
+        Determines the default event processing and data query for the selection. Vega-Lite
+        currently supports two selection types:
+
+
+        * ``"point"`` -- to select multiple discrete data values; the first value is
+          selected on ``click`` and additional values toggled on shift-click.
+        * ``"interval"`` -- to select a continuous range of data values on ``drag``.
+    bind : str, dict, :class:`Binding`, :class:`BindInput`, :class:`BindRange`, :class:`BindDirect`, :class:`BindCheckbox`, :class:`LegendBinding`, :class:`BindRadioSelect`, :class:`LegendStreamBinding`
+        When set, a selection is populated by input elements (also known as dynamic query
+        widgets) or by interacting with the corresponding legend. Direct manipulation
+        interaction is disabled by default; to re-enable it, set the selection's `on
+        <https://vega.github.io/vega-lite/docs/selection.html#common-selection-properties>`__
+        property.
+
+        Legend bindings are restricted to selections that only specify a single field or
+        encoding.
+
+        Query widget binding takes the form of Vega's `input element binding definition
+        <https://vega.github.io/vega/docs/signals/#bind>`__ or can be a mapping between
+        projected field/encodings and binding definitions.
+
+        **See also:** `bind <https://vega.github.io/vega-lite/docs/bind.html>`__
+        documentation.
+    value : str, bool, dict, None, float, :class:`DateTime`, :class:`SelectionInit`, :class:`PrimitiveValue`, :class:`SelectionInitIntervalMapping`, Sequence[dict, :class:`SelectionInitMapping`]
+        Initialize the selection with a mapping between `projected channels or field names
+        <https://vega.github.io/vega-lite/docs/selection.html#project>`__ and initial
+        values.
+
+        **See also:** `init <https://vega.github.io/vega-lite/docs/value.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/SelectionParameter"}
+
+    def __init__(
+        self,
+        name: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        select: Union[
+            dict, "SchemaBase", Literal["point", "interval"], UndefinedType
+        ] = Undefined,
+        bind: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            "SchemaBase",
+            Sequence[Union[dict, "SchemaBase"]],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(SelectionParameter, self).__init__(
+            name=name, select=select, bind=bind, value=value, **kwds
+        )
+
+
+class SelectionResolution(VegaLiteSchema):
+    """SelectionResolution schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SelectionResolution"}
+
+    def __init__(self, *args):
+        super(SelectionResolution, self).__init__(*args)
+
+
+class SelectionType(VegaLiteSchema):
+    """SelectionType schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SelectionType"}
+
+    def __init__(self, *args):
+        super(SelectionType, self).__init__(*args)
+
+
+class SequenceGenerator(Generator):
+    """SequenceGenerator schema wrapper
+
+    Parameters
+    ----------
+
+    sequence : dict, :class:`SequenceParams`
+        Generate a sequence of numbers.
+    name : str
+        Provide a placeholder name and bind data at runtime.
+    """
+
+    _schema = {"$ref": "#/definitions/SequenceGenerator"}
+
+    def __init__(
+        self,
+        sequence: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(SequenceGenerator, self).__init__(sequence=sequence, name=name, **kwds)
+
+
+class SequenceParams(VegaLiteSchema):
+    """SequenceParams schema wrapper
+
+    Parameters
+    ----------
+
+    start : float
+        The starting value of the sequence (inclusive).
+    stop : float
+        The ending value of the sequence (exclusive).
+    step : float
+        The step value between sequence entries.
+
+        **Default value:** ``1``
+    as : str, :class:`FieldName`
+        The name of the generated sequence field.
+
+        **Default value:** ``"data"``
+    """
+
+    _schema = {"$ref": "#/definitions/SequenceParams"}
+
+    def __init__(
+        self,
+        start: Union[float, UndefinedType] = Undefined,
+        stop: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(SequenceParams, self).__init__(start=start, stop=stop, step=step, **kwds)
+
+
+class SequentialMultiHue(ColorScheme):
+    """SequentialMultiHue schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SequentialMultiHue"}
+
+    def __init__(self, *args):
+        super(SequentialMultiHue, self).__init__(*args)
+
+
+class SequentialSingleHue(ColorScheme):
+    """SequentialSingleHue schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SequentialSingleHue"}
+
+    def __init__(self, *args):
+        super(SequentialSingleHue, self).__init__(*args)
+
+
+class ShapeDef(VegaLiteSchema):
+    """ShapeDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/ShapeDef"}
+
+    def __init__(self, *args, **kwds):
+        super(ShapeDef, self).__init__(*args, **kwds)
+
+
+class FieldOrDatumDefWithConditionDatumDefstringnull(
+    MarkPropDefstringnullTypeForShape, ShapeDef
+):
+    """FieldOrDatumDefWithConditionDatumDefstringnull schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {
+        "$ref": "#/definitions/FieldOrDatumDefWithCondition<DatumDef,(string|null)>"
+    }
+
+    def __init__(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        datum: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldOrDatumDefWithConditionDatumDefstringnull, self).__init__(
+            bandPosition=bandPosition,
+            condition=condition,
+            datum=datum,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class FieldOrDatumDefWithConditionMarkPropFieldDefTypeForShapestringnull(
+    MarkPropDefstringnullTypeForShape, ShapeDef
+):
+    """FieldOrDatumDefWithConditionMarkPropFieldDefTypeForShapestringnull schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    legend : dict, None, :class:`Legend`
+        An object defining properties of the legend. If ``null``, the legend for the
+        encoding channel will be removed.
+
+        **Default value:** If undefined, default `legend properties
+        <https://vega.github.io/vega-lite/docs/legend.html>`__ are applied.
+
+        **See also:** `legend <https://vega.github.io/vega-lite/docs/legend.html>`__
+        documentation.
+    scale : dict, None, :class:`Scale`
+        An object defining properties of the channel's scale, which is the function that
+        transforms values in the data domain (numbers, dates, strings, etc) to visual values
+        (pixels, colors, sizes) of the encoding channels.
+
+        If ``null``, the scale will be `disabled and the data value will be directly encoded
+        <https://vega.github.io/vega-lite/docs/scale.html#disable>`__.
+
+        **Default value:** If undefined, default `scale properties
+        <https://vega.github.io/vega-lite/docs/scale.html>`__ are applied.
+
+        **See also:** `scale <https://vega.github.io/vega-lite/docs/scale.html>`__
+        documentation.
+    sort : dict, None, :class:`Sort`, Sequence[str], Sequence[bool], Sequence[float], :class:`SortArray`, :class:`SortOrder`, :class:`AllSortString`, :class:`SortByChannel`, :class:`SortByEncoding`, :class:`EncodingSortField`, :class:`SortByChannelDesc`, Sequence[dict, :class:`DateTime`], Literal['ascending', 'descending'], Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text'], Literal['-x', '-y', '-color', '-fill', '-stroke', '-strokeWidth', '-size', '-shape', '-fillOpacity', '-strokeOpacity', '-opacity', '-text']
+        Sort order for the encoded field.
+
+        For continuous fields (quantitative or temporal), ``sort`` can be either
+        ``"ascending"`` or ``"descending"``.
+
+        For discrete fields, ``sort`` can be one of the following:
+
+
+        * ``"ascending"`` or ``"descending"`` -- for sorting by the values' natural order in
+          JavaScript.
+        * `A string indicating an encoding channel name to sort by
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__ (e.g.,
+          ``"x"`` or ``"y"`` ) with an optional minus prefix for descending sort (e.g.,
+          ``"-x"`` to sort by x-field, descending). This channel string is short-form of `a
+          sort-by-encoding definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding>`__. For
+          example, ``"sort": "-x"`` is equivalent to ``"sort": {"encoding": "x", "order":
+          "descending"}``.
+        * `A sort field definition
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-field>`__ for sorting by
+          another field.
+        * `An array specifying the field values in preferred order
+          <https://vega.github.io/vega-lite/docs/sort.html#sort-array>`__. In this case, the
+          sort order will obey the values in the array, followed by any unspecified values
+          in their original order. For discrete time field, values in the sort array can be
+          `date-time definition objects
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__. In addition, for time
+          units ``"month"`` and ``"day"``, the values can be the month or day names (case
+          insensitive) or their 3-letter initials (e.g., ``"Mon"``, ``"Tue"`` ).
+        * ``null`` indicating no sort.
+
+        **Default value:** ``"ascending"``
+
+        **Note:** ``null`` and sorting by another channel is not supported for ``row`` and
+        ``column``.
+
+        **See also:** `sort <https://vega.github.io/vega-lite/docs/sort.html>`__
+        documentation.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`TypeForShape`, Literal['nominal', 'ordinal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {
+        "$ref": "#/definitions/FieldOrDatumDefWithCondition<MarkPropFieldDef<TypeForShape>,(string|null)>"
+    }
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        legend: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        scale: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        sort: Union[
+            dict,
+            None,
+            "SchemaBase",
+            Sequence[str],
+            Sequence[bool],
+            Sequence[float],
+            Literal["ascending", "descending"],
+            Sequence[Union[dict, "SchemaBase"]],
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            Literal[
+                "-x",
+                "-y",
+                "-color",
+                "-fill",
+                "-stroke",
+                "-strokeWidth",
+                "-size",
+                "-shape",
+                "-fillOpacity",
+                "-strokeOpacity",
+                "-opacity",
+                "-text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase", Literal["nominal", "ordinal", "geojson"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(
+            FieldOrDatumDefWithConditionMarkPropFieldDefTypeForShapestringnull, self
+        ).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            legend=legend,
+            scale=scale,
+            sort=sort,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class SharedEncoding(VegaLiteSchema):
+    """SharedEncoding schema wrapper
+
+    Parameters
+    ----------
+
+    angle : dict
+
+    color : dict
+
+    description : dict
+
+    detail : dict, :class:`FieldDefWithoutScale`, Sequence[dict, :class:`FieldDefWithoutScale`]
+        Additional levels of detail for grouping data in aggregate views and in line, trail,
+        and area marks without mapping data to a specific visual channel.
+    fill : dict
+
+    fillOpacity : dict
+
+    href : dict
+
+    key : dict
+
+    latitude : dict
+
+    latitude2 : dict
+
+    longitude : dict
+
+    longitude2 : dict
+
+    opacity : dict
+
+    order : dict, :class:`OrderOnlyDef`, :class:`OrderFieldDef`, :class:`OrderValueDef`, Sequence[dict, :class:`OrderFieldDef`]
+        Order of the marks.
+
+
+        * For stacked marks, this ``order`` channel encodes `stack order
+          <https://vega.github.io/vega-lite/docs/stack.html#order>`__.
+        * For line and trail marks, this ``order`` channel encodes order of data points in
+          the lines. This can be useful for creating `a connected scatterplot
+          <https://vega.github.io/vega-lite/examples/connected_scatterplot.html>`__. Setting
+          ``order`` to ``{"value": null}`` makes the line marks use the original order in
+          the data sources.
+        * Otherwise, this ``order`` channel encodes layer order of the marks.
+
+        **Note** : In aggregate plots, ``order`` field should be ``aggregate`` d to avoid
+        creating additional aggregation grouping.
+    radius : dict
+
+    radius2 : dict
+
+    shape : dict
+
+    size : dict
+
+    stroke : dict
+
+    strokeDash : dict
+
+    strokeOpacity : dict
+
+    strokeWidth : dict
+
+    text : dict
+
+    theta : dict
+
+    theta2 : dict
+
+    tooltip : dict, None, :class:`StringFieldDefWithCondition`, :class:`StringValueDefWithCondition`, Sequence[dict, :class:`StringFieldDef`]
+        The tooltip text to show upon mouse hover. Specifying ``tooltip`` encoding overrides
+        `the tooltip property in the mark definition
+        <https://vega.github.io/vega-lite/docs/mark.html#mark-def>`__.
+
+        See the `tooltip <https://vega.github.io/vega-lite/docs/tooltip.html>`__
+        documentation for a detailed discussion about tooltip in Vega-Lite.
+    url : dict
+
+    x : dict
+
+    x2 : dict
+
+    xError : dict
+
+    xError2 : dict
+
+    xOffset : dict
+
+    y : dict
+
+    y2 : dict
+
+    yError : dict
+
+    yError2 : dict
+
+    yOffset : dict
+
+    """
+
+    _schema = {"$ref": "#/definitions/SharedEncoding"}
+
+    def __init__(
+        self,
+        angle: Union[dict, UndefinedType] = Undefined,
+        color: Union[dict, UndefinedType] = Undefined,
+        description: Union[dict, UndefinedType] = Undefined,
+        detail: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        fill: Union[dict, UndefinedType] = Undefined,
+        fillOpacity: Union[dict, UndefinedType] = Undefined,
+        href: Union[dict, UndefinedType] = Undefined,
+        key: Union[dict, UndefinedType] = Undefined,
+        latitude: Union[dict, UndefinedType] = Undefined,
+        latitude2: Union[dict, UndefinedType] = Undefined,
+        longitude: Union[dict, UndefinedType] = Undefined,
+        longitude2: Union[dict, UndefinedType] = Undefined,
+        opacity: Union[dict, UndefinedType] = Undefined,
+        order: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        radius: Union[dict, UndefinedType] = Undefined,
+        radius2: Union[dict, UndefinedType] = Undefined,
+        shape: Union[dict, UndefinedType] = Undefined,
+        size: Union[dict, UndefinedType] = Undefined,
+        stroke: Union[dict, UndefinedType] = Undefined,
+        strokeDash: Union[dict, UndefinedType] = Undefined,
+        strokeOpacity: Union[dict, UndefinedType] = Undefined,
+        strokeWidth: Union[dict, UndefinedType] = Undefined,
+        text: Union[dict, UndefinedType] = Undefined,
+        theta: Union[dict, UndefinedType] = Undefined,
+        theta2: Union[dict, UndefinedType] = Undefined,
+        tooltip: Union[
+            dict, None, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        url: Union[dict, UndefinedType] = Undefined,
+        x: Union[dict, UndefinedType] = Undefined,
+        x2: Union[dict, UndefinedType] = Undefined,
+        xError: Union[dict, UndefinedType] = Undefined,
+        xError2: Union[dict, UndefinedType] = Undefined,
+        xOffset: Union[dict, UndefinedType] = Undefined,
+        y: Union[dict, UndefinedType] = Undefined,
+        y2: Union[dict, UndefinedType] = Undefined,
+        yError: Union[dict, UndefinedType] = Undefined,
+        yError2: Union[dict, UndefinedType] = Undefined,
+        yOffset: Union[dict, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(SharedEncoding, self).__init__(
+            angle=angle,
+            color=color,
+            description=description,
+            detail=detail,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            href=href,
+            key=key,
+            latitude=latitude,
+            latitude2=latitude2,
+            longitude=longitude,
+            longitude2=longitude2,
+            opacity=opacity,
+            order=order,
+            radius=radius,
+            radius2=radius2,
+            shape=shape,
+            size=size,
+            stroke=stroke,
+            strokeDash=strokeDash,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            tooltip=tooltip,
+            url=url,
+            x=x,
+            x2=x2,
+            xError=xError,
+            xError2=xError2,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            yError=yError,
+            yError2=yError2,
+            yOffset=yOffset,
+            **kwds,
+        )
+
+
+class SingleDefUnitChannel(VegaLiteSchema):
+    """SingleDefUnitChannel schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SingleDefUnitChannel"}
+
+    def __init__(self, *args):
+        super(SingleDefUnitChannel, self).__init__(*args)
+
+
+class Sort(VegaLiteSchema):
+    """Sort schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Sort"}
+
+    def __init__(self, *args, **kwds):
+        super(Sort, self).__init__(*args, **kwds)
+
+
+class AllSortString(Sort):
+    """AllSortString schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/AllSortString"}
+
+    def __init__(self, *args, **kwds):
+        super(AllSortString, self).__init__(*args, **kwds)
+
+
+class EncodingSortField(Sort):
+    """EncodingSortField schema wrapper
+    A sort definition for sorting a discrete scale in an encoding field definition.
+
+    Parameters
+    ----------
+
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        The data `field <https://vega.github.io/vega-lite/docs/field.html>`__ to sort by.
+
+        **Default value:** If unspecified, defaults to the field specified in the outer data
+        reference.
+    op : :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        An `aggregate operation
+        <https://vega.github.io/vega-lite/docs/aggregate.html#ops>`__ to perform on the
+        field prior to sorting (e.g., ``"count"``, ``"mean"`` and ``"median"`` ). An
+        aggregation is required when there are multiple values of the sort field for each
+        encoded data field. The input data objects will be aggregated, grouped by the
+        encoded data field.
+
+        For a full list of operations, please see the documentation for `aggregate
+        <https://vega.github.io/vega-lite/docs/aggregate.html#ops>`__.
+
+        **Default value:** ``"sum"`` for stacked plots. Otherwise, ``"min"``.
+    order : None, :class:`SortOrder`, Literal['ascending', 'descending']
+        The sort order. One of ``"ascending"`` (default), ``"descending"``, or ``null`` (no
+        not sort).
+    """
+
+    _schema = {"$ref": "#/definitions/EncodingSortField"}
+
+    def __init__(
+        self,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        op: Union[
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, "SchemaBase", Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(EncodingSortField, self).__init__(field=field, op=op, order=order, **kwds)
+
+
+class SortArray(Sort):
+    """SortArray schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SortArray"}
+
+    def __init__(self, *args, **kwds):
+        super(SortArray, self).__init__(*args, **kwds)
+
+
+class SortByChannel(AllSortString):
+    """SortByChannel schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SortByChannel"}
+
+    def __init__(self, *args):
+        super(SortByChannel, self).__init__(*args)
+
+
+class SortByChannelDesc(AllSortString):
+    """SortByChannelDesc schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SortByChannelDesc"}
+
+    def __init__(self, *args):
+        super(SortByChannelDesc, self).__init__(*args)
+
+
+class SortByEncoding(Sort):
+    """SortByEncoding schema wrapper
+
+    Parameters
+    ----------
+
+    encoding : :class:`SortByChannel`, Literal['x', 'y', 'color', 'fill', 'stroke', 'strokeWidth', 'size', 'shape', 'fillOpacity', 'strokeOpacity', 'opacity', 'text']
+        The `encoding channel
+        <https://vega.github.io/vega-lite/docs/encoding.html#channels>`__ to sort by (e.g.,
+        ``"x"``, ``"y"`` )
+    order : None, :class:`SortOrder`, Literal['ascending', 'descending']
+        The sort order. One of ``"ascending"`` (default), ``"descending"``, or ``null`` (no
+        not sort).
+    """
+
+    _schema = {"$ref": "#/definitions/SortByEncoding"}
+
+    def __init__(
+        self,
+        encoding: Union[
+            "SchemaBase",
+            Literal[
+                "x",
+                "y",
+                "color",
+                "fill",
+                "stroke",
+                "strokeWidth",
+                "size",
+                "shape",
+                "fillOpacity",
+                "strokeOpacity",
+                "opacity",
+                "text",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        order: Union[
+            None, "SchemaBase", Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(SortByEncoding, self).__init__(encoding=encoding, order=order, **kwds)
+
+
+class SortField(VegaLiteSchema):
+    """SortField schema wrapper
+    A sort definition for transform
+
+    Parameters
+    ----------
+
+    field : str, :class:`FieldName`
+        The name of the field to sort.
+    order : None, :class:`SortOrder`, Literal['ascending', 'descending']
+        Whether to sort the field in ascending or descending order. One of ``"ascending"``
+        (default), ``"descending"``, or ``null`` (no not sort).
+    """
+
+    _schema = {"$ref": "#/definitions/SortField"}
+
+    def __init__(
+        self,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        order: Union[
+            None, "SchemaBase", Literal["ascending", "descending"], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(SortField, self).__init__(field=field, order=order, **kwds)
+
+
+class SortOrder(AllSortString):
+    """SortOrder schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SortOrder"}
+
+    def __init__(self, *args):
+        super(SortOrder, self).__init__(*args)
+
+
+class Spec(VegaLiteSchema):
+    """Spec schema wrapper
+    Any specification in Vega-Lite.
+    """
+
+    _schema = {"$ref": "#/definitions/Spec"}
+
+    def __init__(self, *args, **kwds):
+        super(Spec, self).__init__(*args, **kwds)
+
+
+class ConcatSpecGenericSpec(Spec, NonNormalizedSpec):
+    """ConcatSpecGenericSpec schema wrapper
+    Base interface for a generalized concatenation specification.
+
+    Parameters
+    ----------
+
+    concat : Sequence[dict, :class:`Spec`, :class:`FacetSpec`, :class:`LayerSpec`, :class:`RepeatSpec`, :class:`FacetedUnitSpec`, :class:`LayerRepeatSpec`, :class:`NonLayerRepeatSpec`, :class:`ConcatSpecGenericSpec`, :class:`HConcatSpecGenericSpec`, :class:`VConcatSpecGenericSpec`]
+        A list of views to be concatenated.
+    align : dict, :class:`LayoutAlign`, :class:`RowColLayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to grid rows and columns. The supported string values are
+        ``"all"``, ``"each"``, and ``"none"``.
+
+
+        * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply
+          placed one after the other.
+        * For ``"each"``, subviews will be aligned into a clean grid structure, but each row
+          or column may be of variable size.
+        * For ``"all"``, subviews will be aligned and each row or column will be sized
+          identically based on the maximum observed size. String values for this property
+          will be applied to both grid rows and columns.
+
+        Alternatively, an object value of the form ``{"row": string, "column": string}`` can
+        be used to supply different alignments for rows and columns.
+
+        **Default value:** ``"all"``.
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool, dict, :class:`RowColboolean`
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        An object value of the form ``{"row": boolean, "column": boolean}`` can be used to
+        supply different centering values for rows and columns.
+
+        **Default value:** ``false``
+    columns : float
+        The number of columns to include in the view composition layout.
+
+        **Default value** : ``undefined`` -- An infinite number of columns (a single row)
+        will be assumed. This is equivalent to ``hconcat`` (for ``concat`` ) and to using
+        the ``column`` channel (for ``facet`` and ``repeat`` ).
+
+        **Note** :
+
+        1) This property is only for:
+
+
+        * the general (wrappable) ``concat`` operator (not ``hconcat`` / ``vconcat`` )
+        * the ``facet`` and ``repeat`` operator with one field/repetition definition
+          (without row/column nesting)
+
+        2) Setting the ``columns`` to ``1`` is equivalent to ``vconcat`` (for ``concat`` )
+        and to using the ``row`` channel (for ``facet`` and ``repeat`` ).
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    description : str
+        Description of this mark for commenting purpose.
+    name : str
+        Name of the visualization for later reference.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    spacing : dict, float, :class:`RowColnumber`
+        The spacing in pixels between sub-views of the composition operator. An object of
+        the form ``{"row": number, "column": number}`` can be used to set different spacing
+        values for rows and columns.
+
+        **Default value** : Depends on ``"spacing"`` property of `the view composition
+        configuration <https://vega.github.io/vega-lite/docs/config.html#view-config>`__ (
+        ``20`` by default)
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    """
+
+    _schema = {"$ref": "#/definitions/ConcatSpec<GenericSpec>"}
+
+    def __init__(
+        self,
+        concat: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        align: Union[
+            dict, "SchemaBase", Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        columns: Union[float, UndefinedType] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spacing: Union[dict, float, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ConcatSpecGenericSpec, self).__init__(
+            concat=concat,
+            align=align,
+            bounds=bounds,
+            center=center,
+            columns=columns,
+            data=data,
+            description=description,
+            name=name,
+            resolve=resolve,
+            spacing=spacing,
+            title=title,
+            transform=transform,
+            **kwds,
+        )
+
+
+class FacetSpec(Spec, NonNormalizedSpec):
+    """FacetSpec schema wrapper
+    Base interface for a facet specification.
+
+    Parameters
+    ----------
+
+    facet : dict, :class:`FacetMapping`, :class:`FacetFieldDef`
+        Definition for how to facet the data. One of: 1) `a field definition for faceting
+        the plot by one field
+        <https://vega.github.io/vega-lite/docs/facet.html#field-def>`__ 2) `An object that
+        maps row and column channels to their field definitions
+        <https://vega.github.io/vega-lite/docs/facet.html#mapping>`__
+    spec : dict, :class:`LayerSpec`, :class:`FacetedUnitSpec`
+        A specification of the view that gets faceted.
+    align : dict, :class:`LayoutAlign`, :class:`RowColLayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to grid rows and columns. The supported string values are
+        ``"all"``, ``"each"``, and ``"none"``.
+
+
+        * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply
+          placed one after the other.
+        * For ``"each"``, subviews will be aligned into a clean grid structure, but each row
+          or column may be of variable size.
+        * For ``"all"``, subviews will be aligned and each row or column will be sized
+          identically based on the maximum observed size. String values for this property
+          will be applied to both grid rows and columns.
+
+        Alternatively, an object value of the form ``{"row": string, "column": string}`` can
+        be used to supply different alignments for rows and columns.
+
+        **Default value:** ``"all"``.
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool, dict, :class:`RowColboolean`
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        An object value of the form ``{"row": boolean, "column": boolean}`` can be used to
+        supply different centering values for rows and columns.
+
+        **Default value:** ``false``
+    columns : float
+        The number of columns to include in the view composition layout.
+
+        **Default value** : ``undefined`` -- An infinite number of columns (a single row)
+        will be assumed. This is equivalent to ``hconcat`` (for ``concat`` ) and to using
+        the ``column`` channel (for ``facet`` and ``repeat`` ).
+
+        **Note** :
+
+        1) This property is only for:
+
+
+        * the general (wrappable) ``concat`` operator (not ``hconcat`` / ``vconcat`` )
+        * the ``facet`` and ``repeat`` operator with one field/repetition definition
+          (without row/column nesting)
+
+        2) Setting the ``columns`` to ``1`` is equivalent to ``vconcat`` (for ``concat`` )
+        and to using the ``row`` channel (for ``facet`` and ``repeat`` ).
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    description : str
+        Description of this mark for commenting purpose.
+    name : str
+        Name of the visualization for later reference.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    spacing : dict, float, :class:`RowColnumber`
+        The spacing in pixels between sub-views of the composition operator. An object of
+        the form ``{"row": number, "column": number}`` can be used to set different spacing
+        values for rows and columns.
+
+        **Default value** : Depends on ``"spacing"`` property of `the view composition
+        configuration <https://vega.github.io/vega-lite/docs/config.html#view-config>`__ (
+        ``20`` by default)
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    """
+
+    _schema = {"$ref": "#/definitions/FacetSpec"}
+
+    def __init__(
+        self,
+        facet: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spec: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        align: Union[
+            dict, "SchemaBase", Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        columns: Union[float, UndefinedType] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spacing: Union[dict, float, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FacetSpec, self).__init__(
+            facet=facet,
+            spec=spec,
+            align=align,
+            bounds=bounds,
+            center=center,
+            columns=columns,
+            data=data,
+            description=description,
+            name=name,
+            resolve=resolve,
+            spacing=spacing,
+            title=title,
+            transform=transform,
+            **kwds,
+        )
+
+
+class FacetedUnitSpec(Spec, NonNormalizedSpec):
+    """FacetedUnitSpec schema wrapper
+    Unit spec that can have a composite mark and row or column channels (shorthand for a facet
+    spec).
+
+    Parameters
+    ----------
+
+    mark : str, dict, :class:`Mark`, :class:`AnyMark`, :class:`BoxPlot`, :class:`MarkDef`, :class:`ErrorBar`, :class:`ErrorBand`, :class:`BoxPlotDef`, :class:`ErrorBarDef`, :class:`ErrorBandDef`, :class:`CompositeMark`, :class:`CompositeMarkDef`, Literal['arc', 'area', 'bar', 'image', 'line', 'point', 'rect', 'rule', 'text', 'tick', 'trail', 'circle', 'square', 'geoshape']
+        A string describing the mark type (one of ``"bar"``, ``"circle"``, ``"square"``,
+        ``"tick"``, ``"line"``, ``"area"``, ``"point"``, ``"rule"``, ``"geoshape"``, and
+        ``"text"`` ) or a `mark definition object
+        <https://vega.github.io/vega-lite/docs/mark.html#mark-def>`__.
+    align : dict, :class:`LayoutAlign`, :class:`RowColLayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to grid rows and columns. The supported string values are
+        ``"all"``, ``"each"``, and ``"none"``.
+
+
+        * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply
+          placed one after the other.
+        * For ``"each"``, subviews will be aligned into a clean grid structure, but each row
+          or column may be of variable size.
+        * For ``"all"``, subviews will be aligned and each row or column will be sized
+          identically based on the maximum observed size. String values for this property
+          will be applied to both grid rows and columns.
+
+        Alternatively, an object value of the form ``{"row": string, "column": string}`` can
+        be used to supply different alignments for rows and columns.
+
+        **Default value:** ``"all"``.
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool, dict, :class:`RowColboolean`
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        An object value of the form ``{"row": boolean, "column": boolean}`` can be used to
+        supply different centering values for rows and columns.
+
+        **Default value:** ``false``
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    description : str
+        Description of this mark for commenting purpose.
+    encoding : dict, :class:`FacetedEncoding`
+        A key-value mapping between encoding channels and definition of fields.
+    height : str, dict, float, :class:`Step`
+        The height of a visualization.
+
+
+        * For a plot with a continuous y-field, height should be a number.
+        * For a plot with either a discrete y-field or no y-field, height can be either a
+          number indicating a fixed height or an object in the form of ``{step: number}``
+          defining the height per discrete step. (No y-field is equivalent to having one
+          discrete step.)
+        * To enable responsive sizing on height, it should be set to ``"container"``.
+
+        **Default value:** Based on ``config.view.continuousHeight`` for a plot with a
+        continuous y-field and ``config.view.discreteHeight`` otherwise.
+
+        **Note:** For plots with `row and column channels
+        <https://vega.github.io/vega-lite/docs/encoding.html#facet>`__, this represents the
+        height of a single view and the ``"container"`` option cannot be used.
+
+        **See also:** `height <https://vega.github.io/vega-lite/docs/size.html>`__
+        documentation.
+    name : str
+        Name of the visualization for later reference.
+    params : Sequence[dict, :class:`SelectionParameter`]
+        An array of parameters that may either be simple variables, or more complex
+        selections that map user input to data queries.
+    projection : dict, :class:`Projection`
+        An object defining properties of geographic projection, which will be applied to
+        ``shape`` path for ``"geoshape"`` marks and to ``latitude`` and ``"longitude"``
+        channels for other marks.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    spacing : dict, float, :class:`RowColnumber`
+        The spacing in pixels between sub-views of the composition operator. An object of
+        the form ``{"row": number, "column": number}`` can be used to set different spacing
+        values for rows and columns.
+
+        **Default value** : Depends on ``"spacing"`` property of `the view composition
+        configuration <https://vega.github.io/vega-lite/docs/config.html#view-config>`__ (
+        ``20`` by default)
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    view : dict, :class:`ViewBackground`
+        An object defining the view background's fill and stroke.
+
+        **Default value:** none (transparent)
+    width : str, dict, float, :class:`Step`
+        The width of a visualization.
+
+
+        * For a plot with a continuous x-field, width should be a number.
+        * For a plot with either a discrete x-field or no x-field, width can be either a
+          number indicating a fixed width or an object in the form of ``{step: number}``
+          defining the width per discrete step. (No x-field is equivalent to having one
+          discrete step.)
+        * To enable responsive sizing on width, it should be set to ``"container"``.
+
+        **Default value:** Based on ``config.view.continuousWidth`` for a plot with a
+        continuous x-field and ``config.view.discreteWidth`` otherwise.
+
+        **Note:** For plots with `row and column channels
+        <https://vega.github.io/vega-lite/docs/encoding.html#facet>`__, this represents the
+        width of a single view and the ``"container"`` option cannot be used.
+
+        **See also:** `width <https://vega.github.io/vega-lite/docs/size.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/FacetedUnitSpec"}
+
+    def __init__(
+        self,
+        mark: Union[
+            str,
+            dict,
+            "SchemaBase",
+            Literal[
+                "arc",
+                "area",
+                "bar",
+                "image",
+                "line",
+                "point",
+                "rect",
+                "rule",
+                "text",
+                "tick",
+                "trail",
+                "circle",
+                "square",
+                "geoshape",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        align: Union[
+            dict, "SchemaBase", Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        encoding: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        height: Union[str, dict, float, "SchemaBase", UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        params: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        projection: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spacing: Union[dict, float, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        view: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        width: Union[str, dict, float, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(FacetedUnitSpec, self).__init__(
+            mark=mark,
+            align=align,
+            bounds=bounds,
+            center=center,
+            data=data,
+            description=description,
+            encoding=encoding,
+            height=height,
+            name=name,
+            params=params,
+            projection=projection,
+            resolve=resolve,
+            spacing=spacing,
+            title=title,
+            transform=transform,
+            view=view,
+            width=width,
+            **kwds,
+        )
+
+
+class HConcatSpecGenericSpec(Spec, NonNormalizedSpec):
+    """HConcatSpecGenericSpec schema wrapper
+    Base interface for a horizontal concatenation specification.
+
+    Parameters
+    ----------
+
+    hconcat : Sequence[dict, :class:`Spec`, :class:`FacetSpec`, :class:`LayerSpec`, :class:`RepeatSpec`, :class:`FacetedUnitSpec`, :class:`LayerRepeatSpec`, :class:`NonLayerRepeatSpec`, :class:`ConcatSpecGenericSpec`, :class:`HConcatSpecGenericSpec`, :class:`VConcatSpecGenericSpec`]
+        A list of views to be concatenated and put into a row.
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        **Default value:** ``false``
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    description : str
+        Description of this mark for commenting purpose.
+    name : str
+        Name of the visualization for later reference.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    spacing : float
+        The spacing in pixels between sub-views of the concat operator.
+
+        **Default value** : ``10``
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    """
+
+    _schema = {"$ref": "#/definitions/HConcatSpec<GenericSpec>"}
+
+    def __init__(
+        self,
+        hconcat: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, UndefinedType] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spacing: Union[float, UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(HConcatSpecGenericSpec, self).__init__(
+            hconcat=hconcat,
+            bounds=bounds,
+            center=center,
+            data=data,
+            description=description,
+            name=name,
+            resolve=resolve,
+            spacing=spacing,
+            title=title,
+            transform=transform,
+            **kwds,
+        )
+
+
+class LayerSpec(Spec, NonNormalizedSpec):
+    """LayerSpec schema wrapper
+    A full layered plot specification, which may contains ``encoding`` and ``projection``
+    properties that will be applied to underlying unit (single-view) specifications.
+
+    Parameters
+    ----------
+
+    layer : Sequence[dict, :class:`UnitSpec`, :class:`LayerSpec`]
+        Layer or single view specifications to be layered.
+
+        **Note** : Specifications inside ``layer`` cannot use ``row`` and ``column``
+        channels as layering facet specifications is not allowed. Instead, use the `facet
+        operator <https://vega.github.io/vega-lite/docs/facet.html>`__ and place a layer
+        inside a facet.
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    description : str
+        Description of this mark for commenting purpose.
+    encoding : dict, :class:`SharedEncoding`
+        A shared key-value mapping between encoding channels and definition of fields in the
+        underlying layers.
+    height : str, dict, float, :class:`Step`
+        The height of a visualization.
+
+
+        * For a plot with a continuous y-field, height should be a number.
+        * For a plot with either a discrete y-field or no y-field, height can be either a
+          number indicating a fixed height or an object in the form of ``{step: number}``
+          defining the height per discrete step. (No y-field is equivalent to having one
+          discrete step.)
+        * To enable responsive sizing on height, it should be set to ``"container"``.
+
+        **Default value:** Based on ``config.view.continuousHeight`` for a plot with a
+        continuous y-field and ``config.view.discreteHeight`` otherwise.
+
+        **Note:** For plots with `row and column channels
+        <https://vega.github.io/vega-lite/docs/encoding.html#facet>`__, this represents the
+        height of a single view and the ``"container"`` option cannot be used.
+
+        **See also:** `height <https://vega.github.io/vega-lite/docs/size.html>`__
+        documentation.
+    name : str
+        Name of the visualization for later reference.
+    projection : dict, :class:`Projection`
+        An object defining properties of the geographic projection shared by underlying
+        layers.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    view : dict, :class:`ViewBackground`
+        An object defining the view background's fill and stroke.
+
+        **Default value:** none (transparent)
+    width : str, dict, float, :class:`Step`
+        The width of a visualization.
+
+
+        * For a plot with a continuous x-field, width should be a number.
+        * For a plot with either a discrete x-field or no x-field, width can be either a
+          number indicating a fixed width or an object in the form of ``{step: number}``
+          defining the width per discrete step. (No x-field is equivalent to having one
+          discrete step.)
+        * To enable responsive sizing on width, it should be set to ``"container"``.
+
+        **Default value:** Based on ``config.view.continuousWidth`` for a plot with a
+        continuous x-field and ``config.view.discreteWidth`` otherwise.
+
+        **Note:** For plots with `row and column channels
+        <https://vega.github.io/vega-lite/docs/encoding.html#facet>`__, this represents the
+        width of a single view and the ``"container"`` option cannot be used.
+
+        **See also:** `width <https://vega.github.io/vega-lite/docs/size.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/LayerSpec"}
+
+    def __init__(
+        self,
+        layer: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        encoding: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        height: Union[str, dict, float, "SchemaBase", UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        projection: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        view: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        width: Union[str, dict, float, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(LayerSpec, self).__init__(
+            layer=layer,
+            data=data,
+            description=description,
+            encoding=encoding,
+            height=height,
+            name=name,
+            projection=projection,
+            resolve=resolve,
+            title=title,
+            transform=transform,
+            view=view,
+            width=width,
+            **kwds,
+        )
+
+
+class RepeatSpec(Spec, NonNormalizedSpec):
+    """RepeatSpec schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/RepeatSpec"}
+
+    def __init__(self, *args, **kwds):
+        super(RepeatSpec, self).__init__(*args, **kwds)
+
+
+class LayerRepeatSpec(RepeatSpec):
+    """LayerRepeatSpec schema wrapper
+
+    Parameters
+    ----------
+
+    repeat : dict, :class:`LayerRepeatMapping`
+        Definition for fields to be repeated. One of: 1) An array of fields to be repeated.
+        If ``"repeat"`` is an array, the field can be referred to as ``{"repeat":
+        "repeat"}``. The repeated views are laid out in a wrapped row. You can set the
+        number of columns to control the wrapping. 2) An object that maps ``"row"`` and/or
+        ``"column"`` to the listed fields to be repeated along the particular orientations.
+        The objects ``{"repeat": "row"}`` and ``{"repeat": "column"}`` can be used to refer
+        to the repeated field respectively.
+    spec : dict, :class:`LayerSpec`, :class:`UnitSpecWithFrame`
+        A specification of the view that gets repeated.
+    align : dict, :class:`LayoutAlign`, :class:`RowColLayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to grid rows and columns. The supported string values are
+        ``"all"``, ``"each"``, and ``"none"``.
+
+
+        * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply
+          placed one after the other.
+        * For ``"each"``, subviews will be aligned into a clean grid structure, but each row
+          or column may be of variable size.
+        * For ``"all"``, subviews will be aligned and each row or column will be sized
+          identically based on the maximum observed size. String values for this property
+          will be applied to both grid rows and columns.
+
+        Alternatively, an object value of the form ``{"row": string, "column": string}`` can
+        be used to supply different alignments for rows and columns.
+
+        **Default value:** ``"all"``.
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool, dict, :class:`RowColboolean`
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        An object value of the form ``{"row": boolean, "column": boolean}`` can be used to
+        supply different centering values for rows and columns.
+
+        **Default value:** ``false``
+    columns : float
+        The number of columns to include in the view composition layout.
+
+        **Default value** : ``undefined`` -- An infinite number of columns (a single row)
+        will be assumed. This is equivalent to ``hconcat`` (for ``concat`` ) and to using
+        the ``column`` channel (for ``facet`` and ``repeat`` ).
+
+        **Note** :
+
+        1) This property is only for:
+
+
+        * the general (wrappable) ``concat`` operator (not ``hconcat`` / ``vconcat`` )
+        * the ``facet`` and ``repeat`` operator with one field/repetition definition
+          (without row/column nesting)
+
+        2) Setting the ``columns`` to ``1`` is equivalent to ``vconcat`` (for ``concat`` )
+        and to using the ``row`` channel (for ``facet`` and ``repeat`` ).
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    description : str
+        Description of this mark for commenting purpose.
+    name : str
+        Name of the visualization for later reference.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    spacing : dict, float, :class:`RowColnumber`
+        The spacing in pixels between sub-views of the composition operator. An object of
+        the form ``{"row": number, "column": number}`` can be used to set different spacing
+        values for rows and columns.
+
+        **Default value** : Depends on ``"spacing"`` property of `the view composition
+        configuration <https://vega.github.io/vega-lite/docs/config.html#view-config>`__ (
+        ``20`` by default)
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    """
+
+    _schema = {"$ref": "#/definitions/LayerRepeatSpec"}
+
+    def __init__(
+        self,
+        repeat: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spec: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        align: Union[
+            dict, "SchemaBase", Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        columns: Union[float, UndefinedType] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spacing: Union[dict, float, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(LayerRepeatSpec, self).__init__(
+            repeat=repeat,
+            spec=spec,
+            align=align,
+            bounds=bounds,
+            center=center,
+            columns=columns,
+            data=data,
+            description=description,
+            name=name,
+            resolve=resolve,
+            spacing=spacing,
+            title=title,
+            transform=transform,
+            **kwds,
+        )
+
+
+class NonLayerRepeatSpec(RepeatSpec):
+    """NonLayerRepeatSpec schema wrapper
+    Base interface for a repeat specification.
+
+    Parameters
+    ----------
+
+    repeat : dict, Sequence[str], :class:`RepeatMapping`
+        Definition for fields to be repeated. One of: 1) An array of fields to be repeated.
+        If ``"repeat"`` is an array, the field can be referred to as ``{"repeat":
+        "repeat"}``. The repeated views are laid out in a wrapped row. You can set the
+        number of columns to control the wrapping. 2) An object that maps ``"row"`` and/or
+        ``"column"`` to the listed fields to be repeated along the particular orientations.
+        The objects ``{"repeat": "row"}`` and ``{"repeat": "column"}`` can be used to refer
+        to the repeated field respectively.
+    spec : dict, :class:`FacetSpec`, :class:`LayerSpec`, :class:`RepeatSpec`, :class:`FacetedUnitSpec`, :class:`LayerRepeatSpec`, :class:`NonNormalizedSpec`, :class:`NonLayerRepeatSpec`, :class:`ConcatSpecGenericSpec`, :class:`HConcatSpecGenericSpec`, :class:`VConcatSpecGenericSpec`
+        A specification of the view that gets repeated.
+    align : dict, :class:`LayoutAlign`, :class:`RowColLayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to grid rows and columns. The supported string values are
+        ``"all"``, ``"each"``, and ``"none"``.
+
+
+        * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply
+          placed one after the other.
+        * For ``"each"``, subviews will be aligned into a clean grid structure, but each row
+          or column may be of variable size.
+        * For ``"all"``, subviews will be aligned and each row or column will be sized
+          identically based on the maximum observed size. String values for this property
+          will be applied to both grid rows and columns.
+
+        Alternatively, an object value of the form ``{"row": string, "column": string}`` can
+        be used to supply different alignments for rows and columns.
+
+        **Default value:** ``"all"``.
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool, dict, :class:`RowColboolean`
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        An object value of the form ``{"row": boolean, "column": boolean}`` can be used to
+        supply different centering values for rows and columns.
+
+        **Default value:** ``false``
+    columns : float
+        The number of columns to include in the view composition layout.
+
+        **Default value** : ``undefined`` -- An infinite number of columns (a single row)
+        will be assumed. This is equivalent to ``hconcat`` (for ``concat`` ) and to using
+        the ``column`` channel (for ``facet`` and ``repeat`` ).
+
+        **Note** :
+
+        1) This property is only for:
+
+
+        * the general (wrappable) ``concat`` operator (not ``hconcat`` / ``vconcat`` )
+        * the ``facet`` and ``repeat`` operator with one field/repetition definition
+          (without row/column nesting)
+
+        2) Setting the ``columns`` to ``1`` is equivalent to ``vconcat`` (for ``concat`` )
+        and to using the ``row`` channel (for ``facet`` and ``repeat`` ).
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    description : str
+        Description of this mark for commenting purpose.
+    name : str
+        Name of the visualization for later reference.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    spacing : dict, float, :class:`RowColnumber`
+        The spacing in pixels between sub-views of the composition operator. An object of
+        the form ``{"row": number, "column": number}`` can be used to set different spacing
+        values for rows and columns.
+
+        **Default value** : Depends on ``"spacing"`` property of `the view composition
+        configuration <https://vega.github.io/vega-lite/docs/config.html#view-config>`__ (
+        ``20`` by default)
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    """
+
+    _schema = {"$ref": "#/definitions/NonLayerRepeatSpec"}
+
+    def __init__(
+        self,
+        repeat: Union[dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        spec: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        align: Union[
+            dict, "SchemaBase", Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        columns: Union[float, UndefinedType] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spacing: Union[dict, float, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(NonLayerRepeatSpec, self).__init__(
+            repeat=repeat,
+            spec=spec,
+            align=align,
+            bounds=bounds,
+            center=center,
+            columns=columns,
+            data=data,
+            description=description,
+            name=name,
+            resolve=resolve,
+            spacing=spacing,
+            title=title,
+            transform=transform,
+            **kwds,
+        )
+
+
+class SphereGenerator(Generator):
+    """SphereGenerator schema wrapper
+
+    Parameters
+    ----------
+
+    sphere : bool, dict
+        Generate sphere GeoJSON data for the full globe.
+    name : str
+        Provide a placeholder name and bind data at runtime.
+    """
+
+    _schema = {"$ref": "#/definitions/SphereGenerator"}
+
+    def __init__(
+        self,
+        sphere: Union[bool, dict, UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(SphereGenerator, self).__init__(sphere=sphere, name=name, **kwds)
+
+
+class StackOffset(VegaLiteSchema):
+    """StackOffset schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/StackOffset"}
+
+    def __init__(self, *args):
+        super(StackOffset, self).__init__(*args)
+
+
+class StandardType(VegaLiteSchema):
+    """StandardType schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/StandardType"}
+
+    def __init__(self, *args):
+        super(StandardType, self).__init__(*args)
+
+
+class Step(VegaLiteSchema):
+    """Step schema wrapper
+
+    Parameters
+    ----------
+
+    step : float
+        The size (width/height) per discrete step.
+    for : :class:`StepFor`, Literal['position', 'offset']
+        Whether to apply the step to position scale or offset scale when there are both
+        ``x`` and ``xOffset`` or both ``y`` and ``yOffset`` encodings.
+    """
+
+    _schema = {"$ref": "#/definitions/Step"}
+
+    def __init__(self, step: Union[float, UndefinedType] = Undefined, **kwds):
+        super(Step, self).__init__(step=step, **kwds)
+
+
+class StepFor(VegaLiteSchema):
+    """StepFor schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/StepFor"}
+
+    def __init__(self, *args):
+        super(StepFor, self).__init__(*args)
+
+
+class Stream(VegaLiteSchema):
+    """Stream schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Stream"}
+
+    def __init__(self, *args, **kwds):
+        super(Stream, self).__init__(*args, **kwds)
+
+
+class DerivedStream(Stream):
+    """DerivedStream schema wrapper
+
+    Parameters
+    ----------
+
+    stream : dict, :class:`Stream`, :class:`EventStream`, :class:`MergedStream`, :class:`DerivedStream`
+
+    between : Sequence[dict, :class:`Stream`, :class:`EventStream`, :class:`MergedStream`, :class:`DerivedStream`]
+
+    consume : bool
+
+    debounce : float
+
+    filter : str, :class:`Expr`, Sequence[str, :class:`Expr`]
+
+    markname : str
+
+    marktype : :class:`MarkType`, Literal['arc', 'area', 'image', 'group', 'line', 'path', 'rect', 'rule', 'shape', 'symbol', 'text', 'trail']
+
+    throttle : float
+
+    """
+
+    _schema = {"$ref": "#/definitions/DerivedStream"}
+
+    def __init__(
+        self,
+        stream: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        between: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        consume: Union[bool, UndefinedType] = Undefined,
+        debounce: Union[float, UndefinedType] = Undefined,
+        filter: Union[
+            str, "SchemaBase", Sequence[Union[str, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        markname: Union[str, UndefinedType] = Undefined,
+        marktype: Union[
+            "SchemaBase",
+            Literal[
+                "arc",
+                "area",
+                "image",
+                "group",
+                "line",
+                "path",
+                "rect",
+                "rule",
+                "shape",
+                "symbol",
+                "text",
+                "trail",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        throttle: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(DerivedStream, self).__init__(
+            stream=stream,
+            between=between,
+            consume=consume,
+            debounce=debounce,
+            filter=filter,
+            markname=markname,
+            marktype=marktype,
+            throttle=throttle,
+            **kwds,
+        )
+
+
+class EventStream(Stream):
+    """EventStream schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/EventStream"}
+
+    def __init__(self, *args, **kwds):
+        super(EventStream, self).__init__(*args, **kwds)
+
+
+class MergedStream(Stream):
+    """MergedStream schema wrapper
+
+    Parameters
+    ----------
+
+    merge : Sequence[dict, :class:`Stream`, :class:`EventStream`, :class:`MergedStream`, :class:`DerivedStream`]
+
+    between : Sequence[dict, :class:`Stream`, :class:`EventStream`, :class:`MergedStream`, :class:`DerivedStream`]
+
+    consume : bool
+
+    debounce : float
+
+    filter : str, :class:`Expr`, Sequence[str, :class:`Expr`]
+
+    markname : str
+
+    marktype : :class:`MarkType`, Literal['arc', 'area', 'image', 'group', 'line', 'path', 'rect', 'rule', 'shape', 'symbol', 'text', 'trail']
+
+    throttle : float
+
+    """
+
+    _schema = {"$ref": "#/definitions/MergedStream"}
+
+    def __init__(
+        self,
+        merge: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        between: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        consume: Union[bool, UndefinedType] = Undefined,
+        debounce: Union[float, UndefinedType] = Undefined,
+        filter: Union[
+            str, "SchemaBase", Sequence[Union[str, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        markname: Union[str, UndefinedType] = Undefined,
+        marktype: Union[
+            "SchemaBase",
+            Literal[
+                "arc",
+                "area",
+                "image",
+                "group",
+                "line",
+                "path",
+                "rect",
+                "rule",
+                "shape",
+                "symbol",
+                "text",
+                "trail",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        throttle: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(MergedStream, self).__init__(
+            merge=merge,
+            between=between,
+            consume=consume,
+            debounce=debounce,
+            filter=filter,
+            markname=markname,
+            marktype=marktype,
+            throttle=throttle,
+            **kwds,
+        )
+
+
+class StringFieldDef(VegaLiteSchema):
+    """StringFieldDef schema wrapper
+
+    Parameters
+    ----------
+
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/StringFieldDef"}
+
+    def __init__(
+        self,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        format: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StringFieldDef, self).__init__(
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            format=format,
+            formatType=formatType,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class StringFieldDefWithCondition(VegaLiteSchema):
+    """StringFieldDefWithCondition schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefstringExprRef`, :class:`ConditionalParameterValueDefstringExprRef`, :class:`ConditionalPredicateValueDefstringExprRef`, Sequence[dict, :class:`ConditionalValueDefstringExprRef`, :class:`ConditionalParameterValueDefstringExprRef`, :class:`ConditionalPredicateValueDefstringExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/StringFieldDefWithCondition"}
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        format: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StringFieldDefWithCondition, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            format=format,
+            formatType=formatType,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class StringValueDefWithCondition(VegaLiteSchema):
+    """StringValueDefWithCondition schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, None, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {"$ref": "#/definitions/StringValueDefWithCondition"}
+
+    def __init__(
+        self,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        value: Union[
+            str, dict, None, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(StringValueDefWithCondition, self).__init__(
+            condition=condition, value=value, **kwds
+        )
+
+
+class StrokeCap(VegaLiteSchema):
+    """StrokeCap schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/StrokeCap"}
+
+    def __init__(self, *args):
+        super(StrokeCap, self).__init__(*args)
+
+
+class StrokeJoin(VegaLiteSchema):
+    """StrokeJoin schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/StrokeJoin"}
+
+    def __init__(self, *args):
+        super(StrokeJoin, self).__init__(*args)
+
+
+class StyleConfigIndex(VegaLiteSchema):
+    """StyleConfigIndex schema wrapper
+
+    Parameters
+    ----------
+
+    arc : dict, :class:`RectConfig`
+        Arc-specific Config
+    area : dict, :class:`AreaConfig`
+        Area-Specific Config
+    bar : dict, :class:`BarConfig`
+        Bar-Specific Config
+    circle : dict, :class:`MarkConfig`
+        Circle-Specific Config
+    geoshape : dict, :class:`MarkConfig`
+        Geoshape-Specific Config
+    image : dict, :class:`RectConfig`
+        Image-specific Config
+    line : dict, :class:`LineConfig`
+        Line-Specific Config
+    mark : dict, :class:`MarkConfig`
+        Mark Config
+    point : dict, :class:`MarkConfig`
+        Point-Specific Config
+    rect : dict, :class:`RectConfig`
+        Rect-Specific Config
+    rule : dict, :class:`MarkConfig`
+        Rule-Specific Config
+    square : dict, :class:`MarkConfig`
+        Square-Specific Config
+    text : dict, :class:`MarkConfig`
+        Text-Specific Config
+    tick : dict, :class:`TickConfig`
+        Tick-Specific Config
+    trail : dict, :class:`LineConfig`
+        Trail-Specific Config
+    group-subtitle : dict, :class:`MarkConfig`
+        Default style for chart subtitles
+    group-title : dict, :class:`MarkConfig`
+        Default style for chart titles
+    guide-label : dict, :class:`MarkConfig`
+        Default style for axis, legend, and header labels.
+    guide-title : dict, :class:`MarkConfig`
+        Default style for axis, legend, and header titles.
+    """
+
+    _schema = {"$ref": "#/definitions/StyleConfigIndex"}
+
+    def __init__(
+        self,
+        arc: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        area: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        bar: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        circle: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        geoshape: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        image: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        line: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        mark: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        point: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        rect: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        rule: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        square: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        text: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        tick: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        trail: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(StyleConfigIndex, self).__init__(
+            arc=arc,
+            area=area,
+            bar=bar,
+            circle=circle,
+            geoshape=geoshape,
+            image=image,
+            line=line,
+            mark=mark,
+            point=point,
+            rect=rect,
+            rule=rule,
+            square=square,
+            text=text,
+            tick=tick,
+            trail=trail,
+            **kwds,
+        )
+
+
+class SymbolShape(VegaLiteSchema):
+    """SymbolShape schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SymbolShape"}
+
+    def __init__(self, *args):
+        super(SymbolShape, self).__init__(*args)
+
+
+class Text(VegaLiteSchema):
+    """Text schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Text"}
+
+    def __init__(self, *args, **kwds):
+        super(Text, self).__init__(*args, **kwds)
+
+
+class TextBaseline(VegaLiteSchema):
+    """TextBaseline schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/TextBaseline"}
+
+    def __init__(self, *args, **kwds):
+        super(TextBaseline, self).__init__(*args, **kwds)
+
+
+class Baseline(TextBaseline):
+    """Baseline schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Baseline"}
+
+    def __init__(self, *args):
+        super(Baseline, self).__init__(*args)
+
+
+class TextDef(VegaLiteSchema):
+    """TextDef schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/TextDef"}
+
+    def __init__(self, *args, **kwds):
+        super(TextDef, self).__init__(*args, **kwds)
+
+
+class FieldOrDatumDefWithConditionStringDatumDefText(TextDef):
+    """FieldOrDatumDefWithConditionStringDatumDefText schema wrapper
+
+    Parameters
+    ----------
+
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    condition : dict, :class:`ConditionalValueDefTextExprRef`, :class:`ConditionalParameterValueDefTextExprRef`, :class:`ConditionalPredicateValueDefTextExprRef`, Sequence[dict, :class:`ConditionalValueDefTextExprRef`, :class:`ConditionalParameterValueDefTextExprRef`, :class:`ConditionalPredicateValueDefTextExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    datum : str, bool, dict, None, float, :class:`ExprRef`, :class:`DateTime`, :class:`RepeatRef`, :class:`PrimitiveValue`
+        A constant value in data domain.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`Type`, Literal['quantitative', 'ordinal', 'temporal', 'nominal', 'geojson']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {
+        "$ref": "#/definitions/FieldOrDatumDefWithCondition<StringDatumDef,Text>"
+    }
+
+    def __init__(
+        self,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        datum: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        format: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal", "geojson"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldOrDatumDefWithConditionStringDatumDefText, self).__init__(
+            bandPosition=bandPosition,
+            condition=condition,
+            datum=datum,
+            format=format,
+            formatType=formatType,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class FieldOrDatumDefWithConditionStringFieldDefText(TextDef):
+    """FieldOrDatumDefWithConditionStringFieldDefText schema wrapper
+
+    Parameters
+    ----------
+
+    shorthand : str, dict, Sequence[str], :class:`RepeatRef`
+        shorthand for field, aggregate, and type
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    condition : dict, :class:`ConditionalValueDefTextExprRef`, :class:`ConditionalParameterValueDefTextExprRef`, :class:`ConditionalPredicateValueDefTextExprRef`, Sequence[dict, :class:`ConditionalValueDefTextExprRef`, :class:`ConditionalParameterValueDefTextExprRef`, :class:`ConditionalPredicateValueDefTextExprRef`]
+        One or more value definition(s) with `a parameter or a test predicate
+        <https://vega.github.io/vega-lite/docs/condition.html>`__.
+
+        **Note:** A field definition's ``condition`` property can only contain `conditional
+        value definitions <https://vega.github.io/vega-lite/docs/condition.html#value>`__
+        since Vega-Lite only allows at most one encoded field per encoding channel.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    format : str, dict, :class:`Dict`
+        When used with the default ``"number"`` and ``"time"`` format type, the text
+        formatting pattern for labels of guides (axes, legends, headers) and text marks.
+
+
+        * If the format type is ``"number"`` (e.g., for quantitative fields), this is D3's
+          `number format pattern <https://github.com/d3/d3-format#locale_format>`__.
+        * If the format type is ``"time"`` (e.g., for temporal fields), this is D3's `time
+          format pattern <https://github.com/d3/d3-time-format#locale_format>`__.
+
+        See the `format documentation <https://vega.github.io/vega-lite/docs/format.html>`__
+        for more examples.
+
+        When used with a `custom formatType
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__, this
+        value will be passed as ``format`` alongside ``datum.value`` to the registered
+        function.
+
+        **Default value:**  Derived from `numberFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for number
+        format and from `timeFormat
+        <https://vega.github.io/vega-lite/docs/config.html#format>`__ config for time
+        format.
+    formatType : str
+        The format type for labels. One of ``"number"``, ``"time"``, or a `registered custom
+        format type
+        <https://vega.github.io/vega-lite/docs/config.html#custom-format-type>`__.
+
+        **Default value:**
+
+
+        * ``"time"`` for temporal fields and ordinal and nominal fields with ``timeUnit``.
+        * ``"number"`` for quantitative fields as well as ordinal and nominal fields without
+          ``timeUnit``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {
+        "$ref": "#/definitions/FieldOrDatumDefWithCondition<StringFieldDef,Text>"
+    }
+
+    def __init__(
+        self,
+        shorthand: Union[
+            str, dict, "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        format: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        formatType: Union[str, UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(FieldOrDatumDefWithConditionStringFieldDefText, self).__init__(
+            shorthand=shorthand,
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            condition=condition,
+            field=field,
+            format=format,
+            formatType=formatType,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class TextDirection(VegaLiteSchema):
+    """TextDirection schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/TextDirection"}
+
+    def __init__(self, *args):
+        super(TextDirection, self).__init__(*args)
+
+
+class TickConfig(AnyMarkConfig):
+    """TickConfig schema wrapper
+
+    Parameters
+    ----------
+
+    align : dict, :class:`Align`, :class:`ExprRef`, Literal['left', 'center', 'right']
+        The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule).
+        One of ``"left"``, ``"right"``, ``"center"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    angle : dict, float, :class:`ExprRef`
+        The rotation angle of the text, in degrees.
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG element, removing the mark item from the ARIA accessibility tree.
+    ariaRole : str, dict, :class:`ExprRef`
+        Sets the type of user interface element of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "role" attribute. Warning: this
+        property is experimental and may be changed in the future.
+    ariaRoleDescription : str, dict, :class:`ExprRef`
+        A human-readable, author-localized description for the role of the mark item for
+        `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the "aria-roledescription" attribute.
+        Warning: this property is experimental and may be changed in the future.
+    aspect : bool, dict, :class:`ExprRef`
+        Whether to keep aspect ratio of image marks.
+    bandSize : float
+        The width of the ticks.
+
+        **Default value:**  3/4 of step (width step for horizontal ticks and height step for
+        vertical ticks).
+    baseline : str, dict, :class:`ExprRef`, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        For text marks, the vertical text baseline. One of ``"alphabetic"`` (default),
+        ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, ``"line-bottom"``, or an
+        expression reference that provides one of the valid values. The ``"line-top"`` and
+        ``"line-bottom"`` values operate similarly to ``"top"`` and ``"bottom"``, but are
+        calculated relative to the ``lineHeight`` rather than ``fontSize`` alone.
+
+        For range marks, the vertical alignment of the marks. One of ``"top"``,
+        ``"middle"``, ``"bottom"``.
+
+        **Note:** Expression reference is *not* supported for range marks.
+    blend : dict, :class:`Blend`, :class:`ExprRef`, Literal[None, 'multiply', 'screen', 'overlay', 'darken', 'lighten', 'color-dodge', 'color-burn', 'hard-light', 'soft-light', 'difference', 'exclusion', 'hue', 'saturation', 'color', 'luminosity']
+        The color blend mode for drawing an item on its current background. Any valid `CSS
+        mix-blend-mode <https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode>`__
+        value can be used.
+
+        __Default value:__ ``"source-over"``
+    color : str, dict, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default color.
+
+        **Default value:** :raw-html:`<span style="color: #4682b4;">&#9632;</span>`
+        ``"#4682b4"``
+
+        **Note:**
+
+
+        * This property cannot be used in a `style config
+          <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+        * The ``fill`` and ``stroke`` properties have higher precedence than ``color`` and
+          will override ``color``.
+    cornerRadius : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles or arcs' corners.
+
+        **Default value:** ``0``
+    cornerRadiusBottomLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom left corner.
+
+        **Default value:** ``0``
+    cornerRadiusBottomRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' bottom right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopLeft : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top right corner.
+
+        **Default value:** ``0``
+    cornerRadiusTopRight : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles' top left corner.
+
+        **Default value:** ``0``
+    cursor : dict, :class:`Cursor`, :class:`ExprRef`, Literal['auto', 'default', 'none', 'context-menu', 'help', 'pointer', 'progress', 'wait', 'cell', 'crosshair', 'text', 'vertical-text', 'alias', 'copy', 'move', 'no-drop', 'not-allowed', 'e-resize', 'n-resize', 'ne-resize', 'nw-resize', 's-resize', 'se-resize', 'sw-resize', 'w-resize', 'ew-resize', 'ns-resize', 'nesw-resize', 'nwse-resize', 'col-resize', 'row-resize', 'all-scroll', 'zoom-in', 'zoom-out', 'grab', 'grabbing']
+        The mouse cursor used over the mark. Any valid `CSS cursor type
+        <https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values>`__ can be used.
+    description : str, dict, :class:`ExprRef`
+        A text description of the mark item for `ARIA accessibility
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ (SVG output
+        only). If specified, this property determines the `"aria-label" attribute
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute>`__.
+    dir : dict, :class:`ExprRef`, Literal['ltr', 'rtl'], :class:`TextDirection`
+        The direction of the text. One of ``"ltr"`` (left-to-right) or ``"rtl"``
+        (right-to-left). This property determines on which side is truncated in response to
+        the limit parameter.
+
+        **Default value:** ``"ltr"``
+    dx : dict, float, :class:`ExprRef`
+        The horizontal offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    dy : dict, float, :class:`ExprRef`
+        The vertical offset, in pixels, between the text label and its anchor point. The
+        offset is applied after rotation by the *angle* property.
+    ellipsis : str, dict, :class:`ExprRef`
+        The ellipsis string for text truncated in response to the limit parameter.
+
+        **Default value:** ``"…"``
+    endAngle : dict, float, :class:`ExprRef`
+        The end angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    fill : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default fill color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove fill.
+
+        **Default value:** (None)
+    fillOpacity : dict, float, :class:`ExprRef`
+        The fill opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    filled : bool
+        Whether the mark's color should be used as fill color instead of stroke color.
+
+        **Default value:** ``false`` for all ``point``, ``line``, and ``rule`` marks as well
+        as ``geoshape`` marks for `graticule
+        <https://vega.github.io/vega-lite/docs/data.html#graticule>`__ data sources;
+        otherwise, ``true``.
+
+        **Note:** This property cannot be used in a `style config
+        <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__.
+    font : str, dict, :class:`ExprRef`
+        The typeface to set the text in (e.g., ``"Helvetica Neue"`` ).
+    fontSize : dict, float, :class:`ExprRef`
+        The font size, in pixels.
+
+        **Default value:** ``11``
+    fontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        The font style (e.g., ``"italic"`` ).
+    fontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        The font weight. This can be either a string (e.g ``"bold"``, ``"normal"`` ) or a
+        number ( ``100``, ``200``, ``300``, ..., ``900`` where ``"normal"`` = ``400`` and
+        ``"bold"`` = ``700`` ).
+    height : dict, float, :class:`ExprRef`
+        Height of the marks.
+    href : str, dict, :class:`URI`, :class:`ExprRef`
+        A URL to load upon mouse click. If defined, the mark acts as a hyperlink.
+    innerRadius : dict, float, :class:`ExprRef`
+        The inner radius in pixels of arc marks. ``innerRadius`` is an alias for
+        ``radius2``.
+
+        **Default value:** ``0``
+    interpolate : dict, :class:`ExprRef`, :class:`Interpolate`, Literal['basis', 'basis-open', 'basis-closed', 'bundle', 'cardinal', 'cardinal-open', 'cardinal-closed', 'catmull-rom', 'linear', 'linear-closed', 'monotone', 'natural', 'step', 'step-before', 'step-after']
+        The line interpolation method to use for line and area marks. One of the following:
+
+
+        * ``"linear"`` : piecewise linear segments, as in a polyline.
+        * ``"linear-closed"`` : close the linear segments to form a polygon.
+        * ``"step"`` : alternate between horizontal and vertical segments, as in a step
+          function.
+        * ``"step-before"`` : alternate between vertical and horizontal segments, as in a
+          step function.
+        * ``"step-after"`` : alternate between horizontal and vertical segments, as in a
+          step function.
+        * ``"basis"`` : a B-spline, with control point duplication on the ends.
+        * ``"basis-open"`` : an open B-spline; may not intersect the start or end.
+        * ``"basis-closed"`` : a closed B-spline, as in a loop.
+        * ``"cardinal"`` : a Cardinal spline, with control point duplication on the ends.
+        * ``"cardinal-open"`` : an open Cardinal spline; may not intersect the start or end,
+          but will intersect other control points.
+        * ``"cardinal-closed"`` : a closed Cardinal spline, as in a loop.
+        * ``"bundle"`` : equivalent to basis, except the tension parameter is used to
+          straighten the spline.
+        * ``"monotone"`` : cubic interpolation that preserves monotonicity in y.
+    invalid : Literal['filter', None]
+        Defines how Vega-Lite should handle marks for invalid values ( ``null`` and ``NaN``
+        ).
+
+
+        * If set to ``"filter"`` (default), all data items with null values will be skipped
+          (for line, trail, and area marks) or filtered (for other marks).
+        * If ``null``, all data items are included. In this case, invalid values will be
+          interpreted as zeroes.
+    limit : dict, float, :class:`ExprRef`
+        The maximum length of the text mark in pixels. The text value will be automatically
+        truncated if the rendered size exceeds the limit.
+
+        **Default value:** ``0`` -- indicating no limit
+    lineBreak : str, dict, :class:`ExprRef`
+        A delimiter, such as a newline character, upon which to break text strings into
+        multiple lines. This property is ignored if the text is array-valued.
+    lineHeight : dict, float, :class:`ExprRef`
+        The line height in pixels (the spacing between subsequent lines of text) for
+        multi-line text marks.
+    opacity : dict, float, :class:`ExprRef`
+        The overall opacity (value between [0,1]).
+
+        **Default value:** ``0.7`` for non-aggregate plots with ``point``, ``tick``,
+        ``circle``, or ``square`` marks or layered ``bar`` charts and ``1`` otherwise.
+    order : bool, None
+        For line and trail marks, this ``order`` property can be set to ``null`` or
+        ``false`` to make the lines use the original order in the data sources.
+    orient : :class:`Orientation`, Literal['horizontal', 'vertical']
+        The orientation of a non-stacked bar, tick, area, and line charts. The value is
+        either horizontal (default) or vertical.
+
+
+        * For bar, rule and tick, this determines whether the size of the bar and tick
+          should be applied to x or y dimension.
+        * For area, this property determines the orient property of the Vega output.
+        * For line and trail marks, this property determines the sort order of the points in
+          the line if ``config.sortLineBy`` is not specified. For stacked charts, this is
+          always determined by the orientation of the stack; therefore explicitly specified
+          value will be ignored.
+    outerRadius : dict, float, :class:`ExprRef`
+        The outer radius in pixels of arc marks. ``outerRadius`` is an alias for ``radius``.
+
+        **Default value:** ``0``
+    padAngle : dict, float, :class:`ExprRef`
+        The angular padding applied to sides of the arc, in radians.
+    radius : dict, float, :class:`ExprRef`
+        For arc mark, the primary (outer) radius in pixels.
+
+        For text marks, polar coordinate radial offset, in pixels, of the text from the
+        origin determined by the ``x`` and ``y`` properties.
+
+        **Default value:** ``min(plot_width, plot_height)/2``
+    radius2 : dict, float, :class:`ExprRef`
+        The secondary (inner) radius in pixels of arc marks.
+
+        **Default value:** ``0``
+    shape : str, dict, :class:`ExprRef`, :class:`SymbolShape`
+        Shape of the point marks. Supported values include:
+
+
+        * plotting shapes: ``"circle"``, ``"square"``, ``"cross"``, ``"diamond"``,
+          ``"triangle-up"``, ``"triangle-down"``, ``"triangle-right"``, or
+          ``"triangle-left"``.
+        * the line symbol ``"stroke"``
+        * centered directional shapes ``"arrow"``, ``"wedge"``, or ``"triangle"``
+        * a custom `SVG path string
+          <https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths>`__ (For correct
+          sizing, custom shape paths should be defined within a square bounding box with
+          coordinates ranging from -1 to 1 along both the x and y dimensions.)
+
+        **Default value:** ``"circle"``
+    size : dict, float, :class:`ExprRef`
+        Default size for marks.
+
+
+        * For ``point`` / ``circle`` / ``square``, this represents the pixel area of the
+          marks. Note that this value sets the area of the symbol; the side lengths will
+          increase with the square root of this value.
+        * For ``bar``, this represents the band size of the bar, in pixels.
+        * For ``text``, this represents the font size, in pixels.
+
+        **Default value:**
+
+
+        * ``30`` for point, circle, square marks; width/height's ``step``
+        * ``2`` for bar marks with discrete dimensions;
+        * ``5`` for bar marks with continuous dimensions;
+        * ``11`` for text marks.
+    smooth : bool, dict, :class:`ExprRef`
+        A boolean flag (default true) indicating if the image should be smoothed when
+        resized. If false, individual pixels should be scaled directly rather than
+        interpolated with smoothing. For SVG rendering, this option may not work in some
+        browsers due to lack of standardization.
+    startAngle : dict, float, :class:`ExprRef`
+        The start angle in radians for arc marks. A value of ``0`` indicates up (north),
+        increasing values proceed clockwise.
+    stroke : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`Gradient`, :class:`HexColor`, :class:`ColorName`, :class:`LinearGradient`, :class:`RadialGradient`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Default stroke color. This property has higher precedence than ``config.color``. Set
+        to ``null`` to remove stroke.
+
+        **Default value:** (None)
+    strokeCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for line ending style. One of ``"butt"``, ``"round"``, or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    strokeDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating stroke, space lengths for creating dashed or dotted lines.
+    strokeDashOffset : dict, float, :class:`ExprRef`
+        The offset (in pixels) into which to begin drawing with the stroke dash array.
+    strokeJoin : dict, :class:`ExprRef`, :class:`StrokeJoin`, Literal['miter', 'round', 'bevel']
+        The stroke line join method. One of ``"miter"``, ``"round"`` or ``"bevel"``.
+
+        **Default value:** ``"miter"``
+    strokeMiterLimit : dict, float, :class:`ExprRef`
+        The miter limit at which to bevel a line join.
+    strokeOffset : dict, float, :class:`ExprRef`
+        The offset in pixels at which to draw the group stroke and fill. If unspecified, the
+        default behavior is to dynamically offset stroked groups such that 1 pixel stroke
+        widths align with the pixel grid.
+    strokeOpacity : dict, float, :class:`ExprRef`
+        The stroke opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    strokeWidth : dict, float, :class:`ExprRef`
+        The stroke width, in pixels.
+    tension : dict, float, :class:`ExprRef`
+        Depending on the interpolation type, sets the tension parameter (for line and area
+        marks).
+    text : str, dict, :class:`Text`, Sequence[str], :class:`ExprRef`
+        Placeholder text if the ``text`` channel is not specified
+    theta : dict, float, :class:`ExprRef`
+        For arc marks, the arc length in radians if theta2 is not specified, otherwise the
+        start arc angle. (A value of 0 indicates up or “north”, increasing values proceed
+        clockwise.)
+
+        For text marks, polar coordinate angle in radians.
+    theta2 : dict, float, :class:`ExprRef`
+        The end angle of arc marks in radians. A value of 0 indicates up or “north”,
+        increasing values proceed clockwise.
+    thickness : float
+        Thickness of the tick mark.
+
+        **Default value:**  ``1``
+    timeUnitBandPosition : float
+        Default relative band position for a time unit. If set to ``0``, the marks will be
+        positioned at the beginning of the time unit band step. If set to ``0.5``, the marks
+        will be positioned in the middle of the time unit band step.
+    timeUnitBandSize : float
+        Default relative band size for a time unit. If set to ``1``, the bandwidth of the
+        marks will be equal to the time unit band step. If set to ``0.5``, bandwidth of the
+        marks will be half of the time unit band step.
+    tooltip : str, bool, dict, None, float, :class:`ExprRef`, :class:`TooltipContent`
+        The tooltip text string to show upon mouse hover or an object defining which fields
+        should the tooltip be derived from.
+
+
+        * If ``tooltip`` is ``true`` or ``{"content": "encoding"}``, then all fields from
+          ``encoding`` will be used.
+        * If ``tooltip`` is ``{"content": "data"}``, then all fields that appear in the
+          highlighted data point will be used.
+        * If set to ``null`` or ``false``, then no tooltip will be used.
+
+        See the `tooltip <https://vega.github.io/vega-lite/docs/tooltip.html>`__
+        documentation for a detailed discussion about tooltip  in Vega-Lite.
+
+        **Default value:** ``null``
+    url : str, dict, :class:`URI`, :class:`ExprRef`
+        The URL of the image file for image marks.
+    width : dict, float, :class:`ExprRef`
+        Width of the marks.
+    x : str, dict, float, :class:`ExprRef`
+        X coordinates of the marks, or width of horizontal ``"bar"`` and ``"area"`` without
+        specified ``x2`` or ``width``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    x2 : str, dict, float, :class:`ExprRef`
+        X2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"width"`` for the width
+        of the plot.
+    y : str, dict, float, :class:`ExprRef`
+        Y coordinates of the marks, or height of vertical ``"bar"`` and ``"area"`` without
+        specified ``y2`` or ``height``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    y2 : str, dict, float, :class:`ExprRef`
+        Y2 coordinates for ranged ``"area"``, ``"bar"``, ``"rect"``, and  ``"rule"``.
+
+        The ``value`` of this channel can be a number or a string ``"height"`` for the
+        height of the plot.
+    """
+
+    _schema = {"$ref": "#/definitions/TickConfig"}
+
+    def __init__(
+        self,
+        align: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ariaRole: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        blend: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        cornerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, "_Parameter", "SchemaBase", Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        dx: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        dy: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        ellipsis: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        endAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        fontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        href: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        innerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineBreak: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            "SchemaBase", Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        shape: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        size: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        smooth: Union[
+            bool, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        startAngle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        tension: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, "_Parameter", "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str, bool, dict, None, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        url: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        width: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(TickConfig, self).__init__(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            blend=blend,
+            color=color,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            endAngle=endAngle,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            radius=radius,
+            radius2=radius2,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            startAngle=startAngle,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            y=y,
+            y2=y2,
+            **kwds,
+        )
+
+
+class TickCount(VegaLiteSchema):
+    """TickCount schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/TickCount"}
+
+    def __init__(self, *args, **kwds):
+        super(TickCount, self).__init__(*args, **kwds)
+
+
+class TimeInterval(TickCount):
+    """TimeInterval schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/TimeInterval"}
+
+    def __init__(self, *args):
+        super(TimeInterval, self).__init__(*args)
+
+
+class TimeIntervalStep(TickCount):
+    """TimeIntervalStep schema wrapper
+
+    Parameters
+    ----------
+
+    interval : :class:`TimeInterval`, Literal['millisecond', 'second', 'minute', 'hour', 'day', 'week', 'month', 'year']
+
+    step : float
+
+    """
+
+    _schema = {"$ref": "#/definitions/TimeIntervalStep"}
+
+    def __init__(
+        self,
+        interval: Union[
+            "SchemaBase",
+            Literal[
+                "millisecond",
+                "second",
+                "minute",
+                "hour",
+                "day",
+                "week",
+                "month",
+                "year",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TimeIntervalStep, self).__init__(interval=interval, step=step, **kwds)
+
+
+class TimeLocale(VegaLiteSchema):
+    """TimeLocale schema wrapper
+    Locale definition for formatting dates and times.
+
+    Parameters
+    ----------
+
+    date : str
+        The date (%x) format specifier (e.g., "%m/%d/%Y").
+    dateTime : str
+        The date and time (%c) format specifier (e.g., "%a %b %e %X %Y").
+    days : Sequence[str], :class:`Vector7string`
+        The full names of the weekdays, starting with Sunday.
+    months : Sequence[str], :class:`Vector12string`
+        The full names of the months (starting with January).
+    periods : Sequence[str], :class:`Vector2string`
+        The A.M. and P.M. equivalents (e.g., ["AM", "PM"]).
+    shortDays : Sequence[str], :class:`Vector7string`
+        The abbreviated names of the weekdays, starting with Sunday.
+    shortMonths : Sequence[str], :class:`Vector12string`
+        The abbreviated names of the months (starting with January).
+    time : str
+        The time (%X) format specifier (e.g., "%H:%M:%S").
+    """
+
+    _schema = {"$ref": "#/definitions/TimeLocale"}
+
+    def __init__(
+        self,
+        date: Union[str, UndefinedType] = Undefined,
+        dateTime: Union[str, UndefinedType] = Undefined,
+        days: Union["SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        months: Union["SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        periods: Union["SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        shortDays: Union["SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        shortMonths: Union["SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        time: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TimeLocale, self).__init__(
+            date=date,
+            dateTime=dateTime,
+            days=days,
+            months=months,
+            periods=periods,
+            shortDays=shortDays,
+            shortMonths=shortMonths,
+            time=time,
+            **kwds,
+        )
+
+
+class TimeUnit(VegaLiteSchema):
+    """TimeUnit schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/TimeUnit"}
+
+    def __init__(self, *args, **kwds):
+        super(TimeUnit, self).__init__(*args, **kwds)
+
+
+class MultiTimeUnit(TimeUnit):
+    """MultiTimeUnit schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/MultiTimeUnit"}
+
+    def __init__(self, *args, **kwds):
+        super(MultiTimeUnit, self).__init__(*args, **kwds)
+
+
+class LocalMultiTimeUnit(MultiTimeUnit):
+    """LocalMultiTimeUnit schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/LocalMultiTimeUnit"}
+
+    def __init__(self, *args):
+        super(LocalMultiTimeUnit, self).__init__(*args)
+
+
+class SingleTimeUnit(TimeUnit):
+    """SingleTimeUnit schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/SingleTimeUnit"}
+
+    def __init__(self, *args, **kwds):
+        super(SingleTimeUnit, self).__init__(*args, **kwds)
+
+
+class LocalSingleTimeUnit(SingleTimeUnit):
+    """LocalSingleTimeUnit schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/LocalSingleTimeUnit"}
+
+    def __init__(self, *args):
+        super(LocalSingleTimeUnit, self).__init__(*args)
+
+
+class TimeUnitParams(VegaLiteSchema):
+    """TimeUnitParams schema wrapper
+    Time Unit Params for encoding predicate, which can specified if the data is  already
+    "binned".
+
+    Parameters
+    ----------
+
+    binned : bool
+        Whether the data has already been binned to this time unit. If true, Vega-Lite will
+        only format the data, marks, and guides, without applying the timeUnit transform to
+        re-bin the data again.
+    maxbins : float
+        If no ``unit`` is specified, maxbins is used to infer time units.
+    step : float
+        The number of steps between bins, in terms of the least significant unit provided.
+    unit : :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`SingleTimeUnit`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Defines how date-time values should be binned.
+    utc : bool
+        True to use UTC timezone. Equivalent to using a ``utc`` prefixed ``TimeUnit``.
+    """
+
+    _schema = {"$ref": "#/definitions/TimeUnitParams"}
+
+    def __init__(
+        self,
+        binned: Union[bool, UndefinedType] = Undefined,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TimeUnitParams, self).__init__(
+            binned=binned, maxbins=maxbins, step=step, unit=unit, utc=utc, **kwds
+        )
+
+
+class TimeUnitTransformParams(VegaLiteSchema):
+    """TimeUnitTransformParams schema wrapper
+
+    Parameters
+    ----------
+
+    maxbins : float
+        If no ``unit`` is specified, maxbins is used to infer time units.
+    step : float
+        The number of steps between bins, in terms of the least significant unit provided.
+    unit : :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`SingleTimeUnit`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Defines how date-time values should be binned.
+    utc : bool
+        True to use UTC timezone. Equivalent to using a ``utc`` prefixed ``TimeUnit``.
+    """
+
+    _schema = {"$ref": "#/definitions/TimeUnitTransformParams"}
+
+    def __init__(
+        self,
+        maxbins: Union[float, UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        unit: Union[
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        utc: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TimeUnitTransformParams, self).__init__(
+            maxbins=maxbins, step=step, unit=unit, utc=utc, **kwds
+        )
+
+
+class TitleAnchor(VegaLiteSchema):
+    """TitleAnchor schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/TitleAnchor"}
+
+    def __init__(self, *args):
+        super(TitleAnchor, self).__init__(*args)
+
+
+class TitleConfig(VegaLiteSchema):
+    """TitleConfig schema wrapper
+
+    Parameters
+    ----------
+
+    align : :class:`Align`, Literal['left', 'center', 'right']
+        Horizontal text alignment for title text. One of ``"left"``, ``"center"``, or
+        ``"right"``.
+    anchor : dict, :class:`ExprRef`, :class:`TitleAnchor`, Literal[None, 'start', 'middle', 'end']
+        The anchor position for placing the title and subtitle text. One of ``"start"``,
+        ``"middle"``, or ``"end"``. For example, with an orientation of top these anchor
+        positions map to a left-, center-, or right-aligned title.
+    angle : dict, float, :class:`ExprRef`
+        Angle in degrees of title and subtitle text.
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG group, removing the title from the ARIA accessibility tree.
+
+        **Default value:** ``true``
+    baseline : str, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        Vertical text baseline for title and subtitle text. One of ``"alphabetic"``
+        (default), ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, or
+        ``"line-bottom"``. The ``"line-top"`` and ``"line-bottom"`` values operate similarly
+        to ``"top"`` and ``"bottom"``, but are calculated relative to the *lineHeight*
+        rather than *fontSize* alone.
+    color : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Text color for title text.
+    dx : dict, float, :class:`ExprRef`
+        Delta offset for title and subtitle text x-coordinate.
+    dy : dict, float, :class:`ExprRef`
+        Delta offset for title and subtitle text y-coordinate.
+    font : str, dict, :class:`ExprRef`
+        Font name for title text.
+    fontSize : dict, float, :class:`ExprRef`
+        Font size in pixels for title text.
+    fontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        Font style for title text.
+    fontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        Font weight for title text. This can be either a string (e.g ``"bold"``,
+        ``"normal"`` ) or a number ( ``100``, ``200``, ``300``, ..., ``900`` where
+        ``"normal"`` = ``400`` and ``"bold"`` = ``700`` ).
+    frame : str, dict, :class:`ExprRef`, :class:`TitleFrame`, Literal['bounds', 'group']
+        The reference frame for the anchor position, one of ``"bounds"`` (to anchor relative
+        to the full bounding box) or ``"group"`` (to anchor relative to the group width or
+        height).
+    limit : dict, float, :class:`ExprRef`
+        The maximum allowed length in pixels of title and subtitle text.
+    lineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line title text or title text with ``"line-top"`` or
+        ``"line-bottom"`` baseline.
+    offset : dict, float, :class:`ExprRef`
+        The orthogonal offset in pixels by which to displace the title group from its
+        position along the edge of the chart.
+    orient : dict, :class:`ExprRef`, :class:`TitleOrient`, Literal['none', 'left', 'right', 'top', 'bottom']
+        Default title orientation ( ``"top"``, ``"bottom"``, ``"left"``, or ``"right"`` )
+    subtitleColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Text color for subtitle text.
+    subtitleFont : str, dict, :class:`ExprRef`
+        Font name for subtitle text.
+    subtitleFontSize : dict, float, :class:`ExprRef`
+        Font size in pixels for subtitle text.
+    subtitleFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        Font style for subtitle text.
+    subtitleFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        Font weight for subtitle text. This can be either a string (e.g ``"bold"``,
+        ``"normal"`` ) or a number ( ``100``, ``200``, ``300``, ..., ``900`` where
+        ``"normal"`` = ``400`` and ``"bold"`` = ``700`` ).
+    subtitleLineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line subtitle text.
+    subtitlePadding : dict, float, :class:`ExprRef`
+        The padding in pixels between title and subtitle text.
+    zindex : dict, float, :class:`ExprRef`
+        The integer z-index indicating the layering of the title group relative to other
+        axis, mark, and legend groups.
+
+        **Default value:** ``0``.
+    """
+
+    _schema = {"$ref": "#/definitions/TitleConfig"}
+
+    def __init__(
+        self,
+        align: Union[
+            "SchemaBase", Literal["left", "center", "right"], UndefinedType
+        ] = Undefined,
+        anchor: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[None, "start", "middle", "end"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        baseline: Union[
+            str, "SchemaBase", Literal["top", "middle", "bottom"], UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        dx: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        dy: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        font: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        fontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        frame: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["bounds", "group"],
+            UndefinedType,
+        ] = Undefined,
+        limit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        orient: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["none", "left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        subtitleColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        subtitleFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        subtitleFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        subtitleFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        subtitleFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        subtitleLineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        subtitlePadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        zindex: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(TitleConfig, self).__init__(
+            align=align,
+            anchor=anchor,
+            angle=angle,
+            aria=aria,
+            baseline=baseline,
+            color=color,
+            dx=dx,
+            dy=dy,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            frame=frame,
+            limit=limit,
+            lineHeight=lineHeight,
+            offset=offset,
+            orient=orient,
+            subtitleColor=subtitleColor,
+            subtitleFont=subtitleFont,
+            subtitleFontSize=subtitleFontSize,
+            subtitleFontStyle=subtitleFontStyle,
+            subtitleFontWeight=subtitleFontWeight,
+            subtitleLineHeight=subtitleLineHeight,
+            subtitlePadding=subtitlePadding,
+            zindex=zindex,
+            **kwds,
+        )
+
+
+class TitleFrame(VegaLiteSchema):
+    """TitleFrame schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/TitleFrame"}
+
+    def __init__(self, *args):
+        super(TitleFrame, self).__init__(*args)
+
+
+class TitleOrient(VegaLiteSchema):
+    """TitleOrient schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/TitleOrient"}
+
+    def __init__(self, *args):
+        super(TitleOrient, self).__init__(*args)
+
+
+class TitleParams(VegaLiteSchema):
+    """TitleParams schema wrapper
+
+    Parameters
+    ----------
+
+    text : str, dict, :class:`Text`, Sequence[str], :class:`ExprRef`
+        The title text.
+    align : :class:`Align`, Literal['left', 'center', 'right']
+        Horizontal text alignment for title text. One of ``"left"``, ``"center"``, or
+        ``"right"``.
+    anchor : :class:`TitleAnchor`, Literal[None, 'start', 'middle', 'end']
+        The anchor position for placing the title. One of ``"start"``, ``"middle"``, or
+        ``"end"``. For example, with an orientation of top these anchor positions map to a
+        left-, center-, or right-aligned title.
+
+        **Default value:** ``"middle"`` for `single
+        <https://vega.github.io/vega-lite/docs/spec.html>`__ and `layered
+        <https://vega.github.io/vega-lite/docs/layer.html>`__ views. ``"start"`` for other
+        composite views.
+
+        **Note:** `For now <https://github.com/vega/vega-lite/issues/2875>`__, ``anchor`` is
+        only customizable only for `single
+        <https://vega.github.io/vega-lite/docs/spec.html>`__ and `layered
+        <https://vega.github.io/vega-lite/docs/layer.html>`__ views. For other composite
+        views, ``anchor`` is always ``"start"``.
+    angle : dict, float, :class:`ExprRef`
+        Angle in degrees of title and subtitle text.
+    aria : bool, dict, :class:`ExprRef`
+        A boolean flag indicating if `ARIA attributes
+        <https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA>`__ should be
+        included (SVG output only). If ``false``, the "aria-hidden" attribute will be set on
+        the output SVG group, removing the title from the ARIA accessibility tree.
+
+        **Default value:** ``true``
+    baseline : str, :class:`Baseline`, :class:`TextBaseline`, Literal['top', 'middle', 'bottom']
+        Vertical text baseline for title and subtitle text. One of ``"alphabetic"``
+        (default), ``"top"``, ``"middle"``, ``"bottom"``, ``"line-top"``, or
+        ``"line-bottom"``. The ``"line-top"`` and ``"line-bottom"`` values operate similarly
+        to ``"top"`` and ``"bottom"``, but are calculated relative to the *lineHeight*
+        rather than *fontSize* alone.
+    color : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Text color for title text.
+    dx : dict, float, :class:`ExprRef`
+        Delta offset for title and subtitle text x-coordinate.
+    dy : dict, float, :class:`ExprRef`
+        Delta offset for title and subtitle text y-coordinate.
+    font : str, dict, :class:`ExprRef`
+        Font name for title text.
+    fontSize : dict, float, :class:`ExprRef`
+        Font size in pixels for title text.
+    fontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        Font style for title text.
+    fontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        Font weight for title text. This can be either a string (e.g ``"bold"``,
+        ``"normal"`` ) or a number ( ``100``, ``200``, ``300``, ..., ``900`` where
+        ``"normal"`` = ``400`` and ``"bold"`` = ``700`` ).
+    frame : str, dict, :class:`ExprRef`, :class:`TitleFrame`, Literal['bounds', 'group']
+        The reference frame for the anchor position, one of ``"bounds"`` (to anchor relative
+        to the full bounding box) or ``"group"`` (to anchor relative to the group width or
+        height).
+    limit : dict, float, :class:`ExprRef`
+        The maximum allowed length in pixels of title and subtitle text.
+    lineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line title text or title text with ``"line-top"`` or
+        ``"line-bottom"`` baseline.
+    offset : dict, float, :class:`ExprRef`
+        The orthogonal offset in pixels by which to displace the title group from its
+        position along the edge of the chart.
+    orient : dict, :class:`ExprRef`, :class:`TitleOrient`, Literal['none', 'left', 'right', 'top', 'bottom']
+        Default title orientation ( ``"top"``, ``"bottom"``, ``"left"``, or ``"right"`` )
+    style : str, Sequence[str]
+        A `mark style property <https://vega.github.io/vega-lite/docs/config.html#style>`__
+        to apply to the title text mark.
+
+        **Default value:** ``"group-title"``.
+    subtitle : str, :class:`Text`, Sequence[str]
+        The subtitle Text.
+    subtitleColor : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        Text color for subtitle text.
+    subtitleFont : str, dict, :class:`ExprRef`
+        Font name for subtitle text.
+    subtitleFontSize : dict, float, :class:`ExprRef`
+        Font size in pixels for subtitle text.
+    subtitleFontStyle : str, dict, :class:`ExprRef`, :class:`FontStyle`
+        Font style for subtitle text.
+    subtitleFontWeight : dict, :class:`ExprRef`, :class:`FontWeight`, Literal['normal', 'bold', 'lighter', 'bolder', 100, 200, 300, 400, 500, 600, 700, 800, 900]
+        Font weight for subtitle text. This can be either a string (e.g ``"bold"``,
+        ``"normal"`` ) or a number ( ``100``, ``200``, ``300``, ..., ``900`` where
+        ``"normal"`` = ``400`` and ``"bold"`` = ``700`` ).
+    subtitleLineHeight : dict, float, :class:`ExprRef`
+        Line height in pixels for multi-line subtitle text.
+    subtitlePadding : dict, float, :class:`ExprRef`
+        The padding in pixels between title and subtitle text.
+    zindex : float
+        The integer z-index indicating the layering of the title group relative to other
+        axis, mark and legend groups.
+
+        **Default value:** ``0``.
+    """
+
+    _schema = {"$ref": "#/definitions/TitleParams"}
+
+    def __init__(
+        self,
+        text: Union[
+            str, dict, "_Parameter", "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        align: Union[
+            "SchemaBase", Literal["left", "center", "right"], UndefinedType
+        ] = Undefined,
+        anchor: Union[
+            "SchemaBase", Literal[None, "start", "middle", "end"], UndefinedType
+        ] = Undefined,
+        angle: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        aria: Union[bool, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        baseline: Union[
+            str, "SchemaBase", Literal["top", "middle", "bottom"], UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        dx: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        dy: Union[dict, float, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        font: Union[str, dict, "_Parameter", "SchemaBase", UndefinedType] = Undefined,
+        fontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        frame: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["bounds", "group"],
+            UndefinedType,
+        ] = Undefined,
+        limit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        offset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        orient: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["none", "left", "right", "top", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        subtitle: Union[str, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        subtitleColor: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        subtitleFont: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        subtitleFontSize: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        subtitleFontStyle: Union[
+            str, dict, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        subtitleFontWeight: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        subtitleLineHeight: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        subtitlePadding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        zindex: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TitleParams, self).__init__(
+            text=text,
+            align=align,
+            anchor=anchor,
+            angle=angle,
+            aria=aria,
+            baseline=baseline,
+            color=color,
+            dx=dx,
+            dy=dy,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            frame=frame,
+            limit=limit,
+            lineHeight=lineHeight,
+            offset=offset,
+            orient=orient,
+            style=style,
+            subtitle=subtitle,
+            subtitleColor=subtitleColor,
+            subtitleFont=subtitleFont,
+            subtitleFontSize=subtitleFontSize,
+            subtitleFontStyle=subtitleFontStyle,
+            subtitleFontWeight=subtitleFontWeight,
+            subtitleLineHeight=subtitleLineHeight,
+            subtitlePadding=subtitlePadding,
+            zindex=zindex,
+            **kwds,
+        )
+
+
+class TooltipContent(VegaLiteSchema):
+    """TooltipContent schema wrapper
+
+    Parameters
+    ----------
+
+    content : Literal['encoding', 'data']
+
+    """
+
+    _schema = {"$ref": "#/definitions/TooltipContent"}
+
+    def __init__(
+        self,
+        content: Union[Literal["encoding", "data"], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TooltipContent, self).__init__(content=content, **kwds)
+
+
+class TopLevelParameter(VegaLiteSchema):
+    """TopLevelParameter schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/TopLevelParameter"}
+
+    def __init__(self, *args, **kwds):
+        super(TopLevelParameter, self).__init__(*args, **kwds)
+
+
+class TopLevelSelectionParameter(TopLevelParameter):
+    """TopLevelSelectionParameter schema wrapper
+
+    Parameters
+    ----------
+
+    name : str, :class:`ParameterName`
+        Required. A unique name for the selection parameter. Selection names should be valid
+        JavaScript identifiers: they should contain only alphanumeric characters (or "$", or
+        "_") and may not start with a digit. Reserved keywords that may not be used as
+        parameter names are "datum", "event", "item", and "parent".
+    select : dict, :class:`SelectionType`, Literal['point', 'interval'], :class:`PointSelectionConfig`, :class:`IntervalSelectionConfig`
+        Determines the default event processing and data query for the selection. Vega-Lite
+        currently supports two selection types:
+
+
+        * ``"point"`` -- to select multiple discrete data values; the first value is
+          selected on ``click`` and additional values toggled on shift-click.
+        * ``"interval"`` -- to select a continuous range of data values on ``drag``.
+    bind : str, dict, :class:`Binding`, :class:`BindInput`, :class:`BindRange`, :class:`BindDirect`, :class:`BindCheckbox`, :class:`LegendBinding`, :class:`BindRadioSelect`, :class:`LegendStreamBinding`
+        When set, a selection is populated by input elements (also known as dynamic query
+        widgets) or by interacting with the corresponding legend. Direct manipulation
+        interaction is disabled by default; to re-enable it, set the selection's `on
+        <https://vega.github.io/vega-lite/docs/selection.html#common-selection-properties>`__
+        property.
+
+        Legend bindings are restricted to selections that only specify a single field or
+        encoding.
+
+        Query widget binding takes the form of Vega's `input element binding definition
+        <https://vega.github.io/vega/docs/signals/#bind>`__ or can be a mapping between
+        projected field/encodings and binding definitions.
+
+        **See also:** `bind <https://vega.github.io/vega-lite/docs/bind.html>`__
+        documentation.
+    value : str, bool, dict, None, float, :class:`DateTime`, :class:`SelectionInit`, :class:`PrimitiveValue`, :class:`SelectionInitIntervalMapping`, Sequence[dict, :class:`SelectionInitMapping`]
+        Initialize the selection with a mapping between `projected channels or field names
+        <https://vega.github.io/vega-lite/docs/selection.html#project>`__ and initial
+        values.
+
+        **See also:** `init <https://vega.github.io/vega-lite/docs/value.html>`__
+        documentation.
+    views : Sequence[str]
+        By default, top-level selections are applied to every view in the visualization. If
+        this property is specified, selections will only be applied to views with the given
+        names.
+    """
+
+    _schema = {"$ref": "#/definitions/TopLevelSelectionParameter"}
+
+    def __init__(
+        self,
+        name: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        select: Union[
+            dict, "SchemaBase", Literal["point", "interval"], UndefinedType
+        ] = Undefined,
+        bind: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            "SchemaBase",
+            Sequence[Union[dict, "SchemaBase"]],
+            UndefinedType,
+        ] = Undefined,
+        views: Union[Sequence[str], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TopLevelSelectionParameter, self).__init__(
+            name=name, select=select, bind=bind, value=value, views=views, **kwds
+        )
+
+
+class TopLevelSpec(VegaLiteSchema):
+    """TopLevelSpec schema wrapper
+    A Vega-Lite top-level specification. This is the root class for all Vega-Lite
+    specifications. (The json schema is generated from this type.)
+    """
+
+    _schema = {"$ref": "#/definitions/TopLevelSpec"}
+
+    def __init__(self, *args, **kwds):
+        super(TopLevelSpec, self).__init__(*args, **kwds)
+
+
+class TopLevelConcatSpec(TopLevelSpec):
+    """TopLevelConcatSpec schema wrapper
+
+    Parameters
+    ----------
+
+    concat : Sequence[dict, :class:`FacetSpec`, :class:`LayerSpec`, :class:`RepeatSpec`, :class:`FacetedUnitSpec`, :class:`LayerRepeatSpec`, :class:`NonNormalizedSpec`, :class:`NonLayerRepeatSpec`, :class:`ConcatSpecGenericSpec`, :class:`HConcatSpecGenericSpec`, :class:`VConcatSpecGenericSpec`]
+        A list of views to be concatenated.
+    align : dict, :class:`LayoutAlign`, :class:`RowColLayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to grid rows and columns. The supported string values are
+        ``"all"``, ``"each"``, and ``"none"``.
+
+
+        * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply
+          placed one after the other.
+        * For ``"each"``, subviews will be aligned into a clean grid structure, but each row
+          or column may be of variable size.
+        * For ``"all"``, subviews will be aligned and each row or column will be sized
+          identically based on the maximum observed size. String values for this property
+          will be applied to both grid rows and columns.
+
+        Alternatively, an object value of the form ``{"row": string, "column": string}`` can
+        be used to supply different alignments for rows and columns.
+
+        **Default value:** ``"all"``.
+    autosize : dict, :class:`AutosizeType`, :class:`AutoSizeParams`, Literal['pad', 'none', 'fit', 'fit-x', 'fit-y']
+        How the visualization size should be determined. If a string, should be one of
+        ``"pad"``, ``"fit"`` or ``"none"``. Object values can additionally specify
+        parameters for content sizing and automatic resizing.
+
+        **Default value** : ``pad``
+    background : str, dict, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        CSS color property to use as the background of the entire view.
+
+        **Default value:** ``"white"``
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool, dict, :class:`RowColboolean`
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        An object value of the form ``{"row": boolean, "column": boolean}`` can be used to
+        supply different centering values for rows and columns.
+
+        **Default value:** ``false``
+    columns : float
+        The number of columns to include in the view composition layout.
+
+        **Default value** : ``undefined`` -- An infinite number of columns (a single row)
+        will be assumed. This is equivalent to ``hconcat`` (for ``concat`` ) and to using
+        the ``column`` channel (for ``facet`` and ``repeat`` ).
+
+        **Note** :
+
+        1) This property is only for:
+
+
+        * the general (wrappable) ``concat`` operator (not ``hconcat`` / ``vconcat`` )
+        * the ``facet`` and ``repeat`` operator with one field/repetition definition
+          (without row/column nesting)
+
+        2) Setting the ``columns`` to ``1`` is equivalent to ``vconcat`` (for ``concat`` )
+        and to using the ``row`` channel (for ``facet`` and ``repeat`` ).
+    config : dict, :class:`Config`
+        Vega-Lite configuration object. This property can only be defined at the top-level
+        of a specification.
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    datasets : dict, :class:`Datasets`
+        A global data store for named datasets. This is a mapping from names to inline
+        datasets. This can be an array of objects or primitive values or a string. Arrays of
+        primitive values are ingested as objects with a ``data`` property.
+    description : str
+        Description of this mark for commenting purpose.
+    name : str
+        Name of the visualization for later reference.
+    padding : dict, float, :class:`ExprRef`, :class:`Padding`
+        The default visualization padding, in pixels, from the edge of the visualization
+        canvas to the data rectangle. If a number, specifies padding for all sides. If an
+        object, the value should have the format ``{"left": 5, "top": 5, "right": 5,
+        "bottom": 5}`` to specify padding for each side of the visualization.
+
+        **Default value** : ``5``
+    params : Sequence[dict, :class:`TopLevelParameter`, :class:`VariableParameter`, :class:`TopLevelSelectionParameter`]
+        Dynamic variables or selections that parameterize a visualization.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    spacing : dict, float, :class:`RowColnumber`
+        The spacing in pixels between sub-views of the composition operator. An object of
+        the form ``{"row": number, "column": number}`` can be used to set different spacing
+        values for rows and columns.
+
+        **Default value** : Depends on ``"spacing"`` property of `the view composition
+        configuration <https://vega.github.io/vega-lite/docs/config.html#view-config>`__ (
+        ``20`` by default)
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    usermeta : dict, :class:`Dict`
+        Optional metadata that will be passed to Vega. This object is completely ignored by
+        Vega and Vega-Lite and can be used for custom metadata.
+    $schema : str
+        URL to `JSON schema <http://json-schema.org/>`__ for a Vega-Lite specification.
+        Unless you have a reason to change this, use
+        ``https://vega.github.io/schema/vega-lite/v5.json``. Setting the ``$schema``
+        property allows automatic validation and autocomplete in editors that support JSON
+        schema.
+    """
+
+    _schema = {"$ref": "#/definitions/TopLevelConcatSpec"}
+
+    def __init__(
+        self,
+        concat: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        align: Union[
+            dict, "SchemaBase", Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        autosize: Union[
+            dict,
+            "SchemaBase",
+            Literal["pad", "none", "fit", "fit-x", "fit-y"],
+            UndefinedType,
+        ] = Undefined,
+        background: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        columns: Union[float, UndefinedType] = Undefined,
+        config: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        datasets: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        padding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        params: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spacing: Union[dict, float, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        usermeta: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TopLevelConcatSpec, self).__init__(
+            concat=concat,
+            align=align,
+            autosize=autosize,
+            background=background,
+            bounds=bounds,
+            center=center,
+            columns=columns,
+            config=config,
+            data=data,
+            datasets=datasets,
+            description=description,
+            name=name,
+            padding=padding,
+            params=params,
+            resolve=resolve,
+            spacing=spacing,
+            title=title,
+            transform=transform,
+            usermeta=usermeta,
+            **kwds,
+        )
+
+
+class TopLevelFacetSpec(TopLevelSpec):
+    """TopLevelFacetSpec schema wrapper
+
+    Parameters
+    ----------
+
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    facet : dict, :class:`FacetMapping`, :class:`FacetFieldDef`
+        Definition for how to facet the data. One of: 1) `a field definition for faceting
+        the plot by one field
+        <https://vega.github.io/vega-lite/docs/facet.html#field-def>`__ 2) `An object that
+        maps row and column channels to their field definitions
+        <https://vega.github.io/vega-lite/docs/facet.html#mapping>`__
+    spec : dict, :class:`LayerSpec`, :class:`UnitSpecWithFrame`
+        A specification of the view that gets faceted.
+    align : dict, :class:`LayoutAlign`, :class:`RowColLayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to grid rows and columns. The supported string values are
+        ``"all"``, ``"each"``, and ``"none"``.
+
+
+        * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply
+          placed one after the other.
+        * For ``"each"``, subviews will be aligned into a clean grid structure, but each row
+          or column may be of variable size.
+        * For ``"all"``, subviews will be aligned and each row or column will be sized
+          identically based on the maximum observed size. String values for this property
+          will be applied to both grid rows and columns.
+
+        Alternatively, an object value of the form ``{"row": string, "column": string}`` can
+        be used to supply different alignments for rows and columns.
+
+        **Default value:** ``"all"``.
+    autosize : dict, :class:`AutosizeType`, :class:`AutoSizeParams`, Literal['pad', 'none', 'fit', 'fit-x', 'fit-y']
+        How the visualization size should be determined. If a string, should be one of
+        ``"pad"``, ``"fit"`` or ``"none"``. Object values can additionally specify
+        parameters for content sizing and automatic resizing.
+
+        **Default value** : ``pad``
+    background : str, dict, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        CSS color property to use as the background of the entire view.
+
+        **Default value:** ``"white"``
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool, dict, :class:`RowColboolean`
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        An object value of the form ``{"row": boolean, "column": boolean}`` can be used to
+        supply different centering values for rows and columns.
+
+        **Default value:** ``false``
+    columns : float
+        The number of columns to include in the view composition layout.
+
+        **Default value** : ``undefined`` -- An infinite number of columns (a single row)
+        will be assumed. This is equivalent to ``hconcat`` (for ``concat`` ) and to using
+        the ``column`` channel (for ``facet`` and ``repeat`` ).
+
+        **Note** :
+
+        1) This property is only for:
+
+
+        * the general (wrappable) ``concat`` operator (not ``hconcat`` / ``vconcat`` )
+        * the ``facet`` and ``repeat`` operator with one field/repetition definition
+          (without row/column nesting)
+
+        2) Setting the ``columns`` to ``1`` is equivalent to ``vconcat`` (for ``concat`` )
+        and to using the ``row`` channel (for ``facet`` and ``repeat`` ).
+    config : dict, :class:`Config`
+        Vega-Lite configuration object. This property can only be defined at the top-level
+        of a specification.
+    datasets : dict, :class:`Datasets`
+        A global data store for named datasets. This is a mapping from names to inline
+        datasets. This can be an array of objects or primitive values or a string. Arrays of
+        primitive values are ingested as objects with a ``data`` property.
+    description : str
+        Description of this mark for commenting purpose.
+    name : str
+        Name of the visualization for later reference.
+    padding : dict, float, :class:`ExprRef`, :class:`Padding`
+        The default visualization padding, in pixels, from the edge of the visualization
+        canvas to the data rectangle. If a number, specifies padding for all sides. If an
+        object, the value should have the format ``{"left": 5, "top": 5, "right": 5,
+        "bottom": 5}`` to specify padding for each side of the visualization.
+
+        **Default value** : ``5``
+    params : Sequence[dict, :class:`TopLevelParameter`, :class:`VariableParameter`, :class:`TopLevelSelectionParameter`]
+        Dynamic variables or selections that parameterize a visualization.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    spacing : dict, float, :class:`RowColnumber`
+        The spacing in pixels between sub-views of the composition operator. An object of
+        the form ``{"row": number, "column": number}`` can be used to set different spacing
+        values for rows and columns.
+
+        **Default value** : Depends on ``"spacing"`` property of `the view composition
+        configuration <https://vega.github.io/vega-lite/docs/config.html#view-config>`__ (
+        ``20`` by default)
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    usermeta : dict, :class:`Dict`
+        Optional metadata that will be passed to Vega. This object is completely ignored by
+        Vega and Vega-Lite and can be used for custom metadata.
+    $schema : str
+        URL to `JSON schema <http://json-schema.org/>`__ for a Vega-Lite specification.
+        Unless you have a reason to change this, use
+        ``https://vega.github.io/schema/vega-lite/v5.json``. Setting the ``$schema``
+        property allows automatic validation and autocomplete in editors that support JSON
+        schema.
+    """
+
+    _schema = {"$ref": "#/definitions/TopLevelFacetSpec"}
+
+    def __init__(
+        self,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        facet: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spec: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        align: Union[
+            dict, "SchemaBase", Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        autosize: Union[
+            dict,
+            "SchemaBase",
+            Literal["pad", "none", "fit", "fit-x", "fit-y"],
+            UndefinedType,
+        ] = Undefined,
+        background: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        columns: Union[float, UndefinedType] = Undefined,
+        config: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        datasets: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        padding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        params: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spacing: Union[dict, float, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        usermeta: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TopLevelFacetSpec, self).__init__(
+            data=data,
+            facet=facet,
+            spec=spec,
+            align=align,
+            autosize=autosize,
+            background=background,
+            bounds=bounds,
+            center=center,
+            columns=columns,
+            config=config,
+            datasets=datasets,
+            description=description,
+            name=name,
+            padding=padding,
+            params=params,
+            resolve=resolve,
+            spacing=spacing,
+            title=title,
+            transform=transform,
+            usermeta=usermeta,
+            **kwds,
+        )
+
+
+class TopLevelHConcatSpec(TopLevelSpec):
+    """TopLevelHConcatSpec schema wrapper
+
+    Parameters
+    ----------
+
+    hconcat : Sequence[dict, :class:`FacetSpec`, :class:`LayerSpec`, :class:`RepeatSpec`, :class:`FacetedUnitSpec`, :class:`LayerRepeatSpec`, :class:`NonNormalizedSpec`, :class:`NonLayerRepeatSpec`, :class:`ConcatSpecGenericSpec`, :class:`HConcatSpecGenericSpec`, :class:`VConcatSpecGenericSpec`]
+        A list of views to be concatenated and put into a row.
+    autosize : dict, :class:`AutosizeType`, :class:`AutoSizeParams`, Literal['pad', 'none', 'fit', 'fit-x', 'fit-y']
+        How the visualization size should be determined. If a string, should be one of
+        ``"pad"``, ``"fit"`` or ``"none"``. Object values can additionally specify
+        parameters for content sizing and automatic resizing.
+
+        **Default value** : ``pad``
+    background : str, dict, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        CSS color property to use as the background of the entire view.
+
+        **Default value:** ``"white"``
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        **Default value:** ``false``
+    config : dict, :class:`Config`
+        Vega-Lite configuration object. This property can only be defined at the top-level
+        of a specification.
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    datasets : dict, :class:`Datasets`
+        A global data store for named datasets. This is a mapping from names to inline
+        datasets. This can be an array of objects or primitive values or a string. Arrays of
+        primitive values are ingested as objects with a ``data`` property.
+    description : str
+        Description of this mark for commenting purpose.
+    name : str
+        Name of the visualization for later reference.
+    padding : dict, float, :class:`ExprRef`, :class:`Padding`
+        The default visualization padding, in pixels, from the edge of the visualization
+        canvas to the data rectangle. If a number, specifies padding for all sides. If an
+        object, the value should have the format ``{"left": 5, "top": 5, "right": 5,
+        "bottom": 5}`` to specify padding for each side of the visualization.
+
+        **Default value** : ``5``
+    params : Sequence[dict, :class:`TopLevelParameter`, :class:`VariableParameter`, :class:`TopLevelSelectionParameter`]
+        Dynamic variables or selections that parameterize a visualization.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    spacing : float
+        The spacing in pixels between sub-views of the concat operator.
+
+        **Default value** : ``10``
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    usermeta : dict, :class:`Dict`
+        Optional metadata that will be passed to Vega. This object is completely ignored by
+        Vega and Vega-Lite and can be used for custom metadata.
+    $schema : str
+        URL to `JSON schema <http://json-schema.org/>`__ for a Vega-Lite specification.
+        Unless you have a reason to change this, use
+        ``https://vega.github.io/schema/vega-lite/v5.json``. Setting the ``$schema``
+        property allows automatic validation and autocomplete in editors that support JSON
+        schema.
+    """
+
+    _schema = {"$ref": "#/definitions/TopLevelHConcatSpec"}
+
+    def __init__(
+        self,
+        hconcat: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        autosize: Union[
+            dict,
+            "SchemaBase",
+            Literal["pad", "none", "fit", "fit-x", "fit-y"],
+            UndefinedType,
+        ] = Undefined,
+        background: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, UndefinedType] = Undefined,
+        config: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        datasets: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        padding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        params: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spacing: Union[float, UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        usermeta: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TopLevelHConcatSpec, self).__init__(
+            hconcat=hconcat,
+            autosize=autosize,
+            background=background,
+            bounds=bounds,
+            center=center,
+            config=config,
+            data=data,
+            datasets=datasets,
+            description=description,
+            name=name,
+            padding=padding,
+            params=params,
+            resolve=resolve,
+            spacing=spacing,
+            title=title,
+            transform=transform,
+            usermeta=usermeta,
+            **kwds,
+        )
+
+
+class TopLevelLayerSpec(TopLevelSpec):
+    """TopLevelLayerSpec schema wrapper
+
+    Parameters
+    ----------
+
+    layer : Sequence[dict, :class:`UnitSpec`, :class:`LayerSpec`]
+        Layer or single view specifications to be layered.
+
+        **Note** : Specifications inside ``layer`` cannot use ``row`` and ``column``
+        channels as layering facet specifications is not allowed. Instead, use the `facet
+        operator <https://vega.github.io/vega-lite/docs/facet.html>`__ and place a layer
+        inside a facet.
+    autosize : dict, :class:`AutosizeType`, :class:`AutoSizeParams`, Literal['pad', 'none', 'fit', 'fit-x', 'fit-y']
+        How the visualization size should be determined. If a string, should be one of
+        ``"pad"``, ``"fit"`` or ``"none"``. Object values can additionally specify
+        parameters for content sizing and automatic resizing.
+
+        **Default value** : ``pad``
+    background : str, dict, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        CSS color property to use as the background of the entire view.
+
+        **Default value:** ``"white"``
+    config : dict, :class:`Config`
+        Vega-Lite configuration object. This property can only be defined at the top-level
+        of a specification.
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    datasets : dict, :class:`Datasets`
+        A global data store for named datasets. This is a mapping from names to inline
+        datasets. This can be an array of objects or primitive values or a string. Arrays of
+        primitive values are ingested as objects with a ``data`` property.
+    description : str
+        Description of this mark for commenting purpose.
+    encoding : dict, :class:`SharedEncoding`
+        A shared key-value mapping between encoding channels and definition of fields in the
+        underlying layers.
+    height : str, dict, float, :class:`Step`
+        The height of a visualization.
+
+
+        * For a plot with a continuous y-field, height should be a number.
+        * For a plot with either a discrete y-field or no y-field, height can be either a
+          number indicating a fixed height or an object in the form of ``{step: number}``
+          defining the height per discrete step. (No y-field is equivalent to having one
+          discrete step.)
+        * To enable responsive sizing on height, it should be set to ``"container"``.
+
+        **Default value:** Based on ``config.view.continuousHeight`` for a plot with a
+        continuous y-field and ``config.view.discreteHeight`` otherwise.
+
+        **Note:** For plots with `row and column channels
+        <https://vega.github.io/vega-lite/docs/encoding.html#facet>`__, this represents the
+        height of a single view and the ``"container"`` option cannot be used.
+
+        **See also:** `height <https://vega.github.io/vega-lite/docs/size.html>`__
+        documentation.
+    name : str
+        Name of the visualization for later reference.
+    padding : dict, float, :class:`ExprRef`, :class:`Padding`
+        The default visualization padding, in pixels, from the edge of the visualization
+        canvas to the data rectangle. If a number, specifies padding for all sides. If an
+        object, the value should have the format ``{"left": 5, "top": 5, "right": 5,
+        "bottom": 5}`` to specify padding for each side of the visualization.
+
+        **Default value** : ``5``
+    params : Sequence[dict, :class:`TopLevelParameter`, :class:`VariableParameter`, :class:`TopLevelSelectionParameter`]
+        Dynamic variables or selections that parameterize a visualization.
+    projection : dict, :class:`Projection`
+        An object defining properties of the geographic projection shared by underlying
+        layers.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    usermeta : dict, :class:`Dict`
+        Optional metadata that will be passed to Vega. This object is completely ignored by
+        Vega and Vega-Lite and can be used for custom metadata.
+    view : dict, :class:`ViewBackground`
+        An object defining the view background's fill and stroke.
+
+        **Default value:** none (transparent)
+    width : str, dict, float, :class:`Step`
+        The width of a visualization.
+
+
+        * For a plot with a continuous x-field, width should be a number.
+        * For a plot with either a discrete x-field or no x-field, width can be either a
+          number indicating a fixed width or an object in the form of ``{step: number}``
+          defining the width per discrete step. (No x-field is equivalent to having one
+          discrete step.)
+        * To enable responsive sizing on width, it should be set to ``"container"``.
+
+        **Default value:** Based on ``config.view.continuousWidth`` for a plot with a
+        continuous x-field and ``config.view.discreteWidth`` otherwise.
+
+        **Note:** For plots with `row and column channels
+        <https://vega.github.io/vega-lite/docs/encoding.html#facet>`__, this represents the
+        width of a single view and the ``"container"`` option cannot be used.
+
+        **See also:** `width <https://vega.github.io/vega-lite/docs/size.html>`__
+        documentation.
+    $schema : str
+        URL to `JSON schema <http://json-schema.org/>`__ for a Vega-Lite specification.
+        Unless you have a reason to change this, use
+        ``https://vega.github.io/schema/vega-lite/v5.json``. Setting the ``$schema``
+        property allows automatic validation and autocomplete in editors that support JSON
+        schema.
+    """
+
+    _schema = {"$ref": "#/definitions/TopLevelLayerSpec"}
+
+    def __init__(
+        self,
+        layer: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        autosize: Union[
+            dict,
+            "SchemaBase",
+            Literal["pad", "none", "fit", "fit-x", "fit-y"],
+            UndefinedType,
+        ] = Undefined,
+        background: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        config: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        datasets: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        encoding: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        height: Union[str, dict, float, "SchemaBase", UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        padding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        params: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        projection: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        usermeta: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        view: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        width: Union[str, dict, float, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TopLevelLayerSpec, self).__init__(
+            layer=layer,
+            autosize=autosize,
+            background=background,
+            config=config,
+            data=data,
+            datasets=datasets,
+            description=description,
+            encoding=encoding,
+            height=height,
+            name=name,
+            padding=padding,
+            params=params,
+            projection=projection,
+            resolve=resolve,
+            title=title,
+            transform=transform,
+            usermeta=usermeta,
+            view=view,
+            width=width,
+            **kwds,
+        )
+
+
+class TopLevelRepeatSpec(TopLevelSpec):
+    """TopLevelRepeatSpec schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/TopLevelRepeatSpec"}
+
+    def __init__(self, *args, **kwds):
+        super(TopLevelRepeatSpec, self).__init__(*args, **kwds)
+
+
+class TopLevelUnitSpec(TopLevelSpec):
+    """TopLevelUnitSpec schema wrapper
+
+    Parameters
+    ----------
+
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    mark : str, dict, :class:`Mark`, :class:`AnyMark`, :class:`BoxPlot`, :class:`MarkDef`, :class:`ErrorBar`, :class:`ErrorBand`, :class:`BoxPlotDef`, :class:`ErrorBarDef`, :class:`ErrorBandDef`, :class:`CompositeMark`, :class:`CompositeMarkDef`, Literal['arc', 'area', 'bar', 'image', 'line', 'point', 'rect', 'rule', 'text', 'tick', 'trail', 'circle', 'square', 'geoshape']
+        A string describing the mark type (one of ``"bar"``, ``"circle"``, ``"square"``,
+        ``"tick"``, ``"line"``, ``"area"``, ``"point"``, ``"rule"``, ``"geoshape"``, and
+        ``"text"`` ) or a `mark definition object
+        <https://vega.github.io/vega-lite/docs/mark.html#mark-def>`__.
+    align : dict, :class:`LayoutAlign`, :class:`RowColLayoutAlign`, Literal['all', 'each', 'none']
+        The alignment to apply to grid rows and columns. The supported string values are
+        ``"all"``, ``"each"``, and ``"none"``.
+
+
+        * For ``"none"``, a flow layout will be used, in which adjacent subviews are simply
+          placed one after the other.
+        * For ``"each"``, subviews will be aligned into a clean grid structure, but each row
+          or column may be of variable size.
+        * For ``"all"``, subviews will be aligned and each row or column will be sized
+          identically based on the maximum observed size. String values for this property
+          will be applied to both grid rows and columns.
+
+        Alternatively, an object value of the form ``{"row": string, "column": string}`` can
+        be used to supply different alignments for rows and columns.
+
+        **Default value:** ``"all"``.
+    autosize : dict, :class:`AutosizeType`, :class:`AutoSizeParams`, Literal['pad', 'none', 'fit', 'fit-x', 'fit-y']
+        How the visualization size should be determined. If a string, should be one of
+        ``"pad"``, ``"fit"`` or ``"none"``. Object values can additionally specify
+        parameters for content sizing and automatic resizing.
+
+        **Default value** : ``pad``
+    background : str, dict, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        CSS color property to use as the background of the entire view.
+
+        **Default value:** ``"white"``
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool, dict, :class:`RowColboolean`
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        An object value of the form ``{"row": boolean, "column": boolean}`` can be used to
+        supply different centering values for rows and columns.
+
+        **Default value:** ``false``
+    config : dict, :class:`Config`
+        Vega-Lite configuration object. This property can only be defined at the top-level
+        of a specification.
+    datasets : dict, :class:`Datasets`
+        A global data store for named datasets. This is a mapping from names to inline
+        datasets. This can be an array of objects or primitive values or a string. Arrays of
+        primitive values are ingested as objects with a ``data`` property.
+    description : str
+        Description of this mark for commenting purpose.
+    encoding : dict, :class:`FacetedEncoding`
+        A key-value mapping between encoding channels and definition of fields.
+    height : str, dict, float, :class:`Step`
+        The height of a visualization.
+
+
+        * For a plot with a continuous y-field, height should be a number.
+        * For a plot with either a discrete y-field or no y-field, height can be either a
+          number indicating a fixed height or an object in the form of ``{step: number}``
+          defining the height per discrete step. (No y-field is equivalent to having one
+          discrete step.)
+        * To enable responsive sizing on height, it should be set to ``"container"``.
+
+        **Default value:** Based on ``config.view.continuousHeight`` for a plot with a
+        continuous y-field and ``config.view.discreteHeight`` otherwise.
+
+        **Note:** For plots with `row and column channels
+        <https://vega.github.io/vega-lite/docs/encoding.html#facet>`__, this represents the
+        height of a single view and the ``"container"`` option cannot be used.
+
+        **See also:** `height <https://vega.github.io/vega-lite/docs/size.html>`__
+        documentation.
+    name : str
+        Name of the visualization for later reference.
+    padding : dict, float, :class:`ExprRef`, :class:`Padding`
+        The default visualization padding, in pixels, from the edge of the visualization
+        canvas to the data rectangle. If a number, specifies padding for all sides. If an
+        object, the value should have the format ``{"left": 5, "top": 5, "right": 5,
+        "bottom": 5}`` to specify padding for each side of the visualization.
+
+        **Default value** : ``5``
+    params : Sequence[dict, :class:`TopLevelParameter`, :class:`VariableParameter`, :class:`TopLevelSelectionParameter`]
+        An array of parameters that may either be simple variables, or more complex
+        selections that map user input to data queries.
+    projection : dict, :class:`Projection`
+        An object defining properties of geographic projection, which will be applied to
+        ``shape`` path for ``"geoshape"`` marks and to ``latitude`` and ``"longitude"``
+        channels for other marks.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    spacing : dict, float, :class:`RowColnumber`
+        The spacing in pixels between sub-views of the composition operator. An object of
+        the form ``{"row": number, "column": number}`` can be used to set different spacing
+        values for rows and columns.
+
+        **Default value** : Depends on ``"spacing"`` property of `the view composition
+        configuration <https://vega.github.io/vega-lite/docs/config.html#view-config>`__ (
+        ``20`` by default)
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    usermeta : dict, :class:`Dict`
+        Optional metadata that will be passed to Vega. This object is completely ignored by
+        Vega and Vega-Lite and can be used for custom metadata.
+    view : dict, :class:`ViewBackground`
+        An object defining the view background's fill and stroke.
+
+        **Default value:** none (transparent)
+    width : str, dict, float, :class:`Step`
+        The width of a visualization.
+
+
+        * For a plot with a continuous x-field, width should be a number.
+        * For a plot with either a discrete x-field or no x-field, width can be either a
+          number indicating a fixed width or an object in the form of ``{step: number}``
+          defining the width per discrete step. (No x-field is equivalent to having one
+          discrete step.)
+        * To enable responsive sizing on width, it should be set to ``"container"``.
+
+        **Default value:** Based on ``config.view.continuousWidth`` for a plot with a
+        continuous x-field and ``config.view.discreteWidth`` otherwise.
+
+        **Note:** For plots with `row and column channels
+        <https://vega.github.io/vega-lite/docs/encoding.html#facet>`__, this represents the
+        width of a single view and the ``"container"`` option cannot be used.
+
+        **See also:** `width <https://vega.github.io/vega-lite/docs/size.html>`__
+        documentation.
+    $schema : str
+        URL to `JSON schema <http://json-schema.org/>`__ for a Vega-Lite specification.
+        Unless you have a reason to change this, use
+        ``https://vega.github.io/schema/vega-lite/v5.json``. Setting the ``$schema``
+        property allows automatic validation and autocomplete in editors that support JSON
+        schema.
+    """
+
+    _schema = {"$ref": "#/definitions/TopLevelUnitSpec"}
+
+    def __init__(
+        self,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        mark: Union[
+            str,
+            dict,
+            "SchemaBase",
+            Literal[
+                "arc",
+                "area",
+                "bar",
+                "image",
+                "line",
+                "point",
+                "rect",
+                "rule",
+                "text",
+                "tick",
+                "trail",
+                "circle",
+                "square",
+                "geoshape",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        align: Union[
+            dict, "SchemaBase", Literal["all", "each", "none"], UndefinedType
+        ] = Undefined,
+        autosize: Union[
+            dict,
+            "SchemaBase",
+            Literal["pad", "none", "fit", "fit-x", "fit-y"],
+            UndefinedType,
+        ] = Undefined,
+        background: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        config: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        datasets: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        encoding: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        height: Union[str, dict, float, "SchemaBase", UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        padding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        params: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        projection: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spacing: Union[dict, float, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        usermeta: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        view: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        width: Union[str, dict, float, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TopLevelUnitSpec, self).__init__(
+            data=data,
+            mark=mark,
+            align=align,
+            autosize=autosize,
+            background=background,
+            bounds=bounds,
+            center=center,
+            config=config,
+            datasets=datasets,
+            description=description,
+            encoding=encoding,
+            height=height,
+            name=name,
+            padding=padding,
+            params=params,
+            projection=projection,
+            resolve=resolve,
+            spacing=spacing,
+            title=title,
+            transform=transform,
+            usermeta=usermeta,
+            view=view,
+            width=width,
+            **kwds,
+        )
+
+
+class TopLevelVConcatSpec(TopLevelSpec):
+    """TopLevelVConcatSpec schema wrapper
+
+    Parameters
+    ----------
+
+    vconcat : Sequence[dict, :class:`FacetSpec`, :class:`LayerSpec`, :class:`RepeatSpec`, :class:`FacetedUnitSpec`, :class:`LayerRepeatSpec`, :class:`NonNormalizedSpec`, :class:`NonLayerRepeatSpec`, :class:`ConcatSpecGenericSpec`, :class:`HConcatSpecGenericSpec`, :class:`VConcatSpecGenericSpec`]
+        A list of views to be concatenated and put into a column.
+    autosize : dict, :class:`AutosizeType`, :class:`AutoSizeParams`, Literal['pad', 'none', 'fit', 'fit-x', 'fit-y']
+        How the visualization size should be determined. If a string, should be one of
+        ``"pad"``, ``"fit"`` or ``"none"``. Object values can additionally specify
+        parameters for content sizing and automatic resizing.
+
+        **Default value** : ``pad``
+    background : str, dict, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        CSS color property to use as the background of the entire view.
+
+        **Default value:** ``"white"``
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        **Default value:** ``false``
+    config : dict, :class:`Config`
+        Vega-Lite configuration object. This property can only be defined at the top-level
+        of a specification.
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    datasets : dict, :class:`Datasets`
+        A global data store for named datasets. This is a mapping from names to inline
+        datasets. This can be an array of objects or primitive values or a string. Arrays of
+        primitive values are ingested as objects with a ``data`` property.
+    description : str
+        Description of this mark for commenting purpose.
+    name : str
+        Name of the visualization for later reference.
+    padding : dict, float, :class:`ExprRef`, :class:`Padding`
+        The default visualization padding, in pixels, from the edge of the visualization
+        canvas to the data rectangle. If a number, specifies padding for all sides. If an
+        object, the value should have the format ``{"left": 5, "top": 5, "right": 5,
+        "bottom": 5}`` to specify padding for each side of the visualization.
+
+        **Default value** : ``5``
+    params : Sequence[dict, :class:`TopLevelParameter`, :class:`VariableParameter`, :class:`TopLevelSelectionParameter`]
+        Dynamic variables or selections that parameterize a visualization.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    spacing : float
+        The spacing in pixels between sub-views of the concat operator.
+
+        **Default value** : ``10``
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    usermeta : dict, :class:`Dict`
+        Optional metadata that will be passed to Vega. This object is completely ignored by
+        Vega and Vega-Lite and can be used for custom metadata.
+    $schema : str
+        URL to `JSON schema <http://json-schema.org/>`__ for a Vega-Lite specification.
+        Unless you have a reason to change this, use
+        ``https://vega.github.io/schema/vega-lite/v5.json``. Setting the ``$schema``
+        property allows automatic validation and autocomplete in editors that support JSON
+        schema.
+    """
+
+    _schema = {"$ref": "#/definitions/TopLevelVConcatSpec"}
+
+    def __init__(
+        self,
+        vconcat: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        autosize: Union[
+            dict,
+            "SchemaBase",
+            Literal["pad", "none", "fit", "fit-x", "fit-y"],
+            UndefinedType,
+        ] = Undefined,
+        background: Union[
+            str,
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, UndefinedType] = Undefined,
+        config: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        datasets: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        padding: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        params: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spacing: Union[float, UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        usermeta: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TopLevelVConcatSpec, self).__init__(
+            vconcat=vconcat,
+            autosize=autosize,
+            background=background,
+            bounds=bounds,
+            center=center,
+            config=config,
+            data=data,
+            datasets=datasets,
+            description=description,
+            name=name,
+            padding=padding,
+            params=params,
+            resolve=resolve,
+            spacing=spacing,
+            title=title,
+            transform=transform,
+            usermeta=usermeta,
+            **kwds,
+        )
+
+
+class TopoDataFormat(DataFormat):
+    """TopoDataFormat schema wrapper
+
+    Parameters
+    ----------
+
+    feature : str
+        The name of the TopoJSON object set to convert to a GeoJSON feature collection. For
+        example, in a map of the world, there may be an object set named ``"countries"``.
+        Using the feature property, we can extract this set and generate a GeoJSON feature
+        object for each country.
+    mesh : str
+        The name of the TopoJSON object set to convert to mesh. Similar to the ``feature``
+        option, ``mesh`` extracts a named TopoJSON object set.  Unlike the ``feature``
+        option, the corresponding geo data is returned as a single, unified mesh instance,
+        not as individual GeoJSON features. Extracting a mesh is useful for more efficiently
+        drawing borders or other geographic elements that you do not need to associate with
+        specific regions such as individual countries, states or counties.
+    parse : dict, None, :class:`Parse`
+        If set to ``null``, disable type inference based on the spec and only use type
+        inference based on the data. Alternatively, a parsing directive object can be
+        provided for explicit data types. Each property of the object corresponds to a field
+        name, and the value to the desired data type (one of ``"number"``, ``"boolean"``,
+        ``"date"``, or null (do not parse the field)). For example, ``"parse":
+        {"modified_on": "date"}`` parses the ``modified_on`` field in each input record a
+        Date value.
+
+        For ``"date"``, we parse data based using JavaScript's `Date.parse()
+        <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse>`__.
+        For Specific date formats can be provided (e.g., ``{foo: "date:'%m%d%Y'"}`` ), using
+        the `d3-time-format syntax <https://github.com/d3/d3-time-format#locale_format>`__.
+        UTC date format parsing is supported similarly (e.g., ``{foo: "utc:'%m%d%Y'"}`` ).
+        See more about `UTC time
+        <https://vega.github.io/vega-lite/docs/timeunit.html#utc>`__
+    type : str
+        Type of input data: ``"json"``, ``"csv"``, ``"tsv"``, ``"dsv"``.
+
+        **Default value:**  The default format type is determined by the extension of the
+        file URL. If no extension is detected, ``"json"`` will be used by default.
+    """
+
+    _schema = {"$ref": "#/definitions/TopoDataFormat"}
+
+    def __init__(
+        self,
+        feature: Union[str, UndefinedType] = Undefined,
+        mesh: Union[str, UndefinedType] = Undefined,
+        parse: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        type: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(TopoDataFormat, self).__init__(
+            feature=feature, mesh=mesh, parse=parse, type=type, **kwds
+        )
+
+
+class Transform(VegaLiteSchema):
+    """Transform schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Transform"}
+
+    def __init__(self, *args, **kwds):
+        super(Transform, self).__init__(*args, **kwds)
+
+
+class AggregateTransform(Transform):
+    """AggregateTransform schema wrapper
+
+    Parameters
+    ----------
+
+    aggregate : Sequence[dict, :class:`AggregatedFieldDef`]
+        Array of objects that define fields to aggregate.
+    groupby : Sequence[str, :class:`FieldName`]
+        The data fields to group by. If not specified, a single group containing all data
+        objects will be used.
+    """
+
+    _schema = {"$ref": "#/definitions/AggregateTransform"}
+
+    def __init__(
+        self,
+        aggregate: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        groupby: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(AggregateTransform, self).__init__(
+            aggregate=aggregate, groupby=groupby, **kwds
+        )
+
+
+class BinTransform(Transform):
+    """BinTransform schema wrapper
+
+    Parameters
+    ----------
+
+    bin : bool, dict, :class:`BinParams`
+        An object indicating bin properties, or simply ``true`` for using default bin
+        parameters.
+    field : str, :class:`FieldName`
+        The data field to bin.
+    as : str, :class:`FieldName`, Sequence[str, :class:`FieldName`]
+        The output fields at which to write the start and end bin values. This can be either
+        a string or an array of strings with two elements denoting the name for the fields
+        for bin start and bin end respectively. If a single string (e.g., ``"val"`` ) is
+        provided, the end field will be ``"val_end"``.
+    """
+
+    _schema = {"$ref": "#/definitions/BinTransform"}
+
+    def __init__(
+        self,
+        bin: Union[bool, dict, "SchemaBase", UndefinedType] = Undefined,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(BinTransform, self).__init__(bin=bin, field=field, **kwds)
+
+
+class CalculateTransform(Transform):
+    """CalculateTransform schema wrapper
+
+    Parameters
+    ----------
+
+    calculate : str
+        A `expression <https://vega.github.io/vega-lite/docs/types.html#expression>`__
+        string. Use the variable ``datum`` to refer to the current data object.
+    as : str, :class:`FieldName`
+        The field for storing the computed formula value.
+    """
+
+    _schema = {"$ref": "#/definitions/CalculateTransform"}
+
+    def __init__(self, calculate: Union[str, UndefinedType] = Undefined, **kwds):
+        super(CalculateTransform, self).__init__(calculate=calculate, **kwds)
+
+
+class DensityTransform(Transform):
+    """DensityTransform schema wrapper
+
+    Parameters
+    ----------
+
+    density : str, :class:`FieldName`
+        The data field for which to perform density estimation.
+    bandwidth : float
+        The bandwidth (standard deviation) of the Gaussian kernel. If unspecified or set to
+        zero, the bandwidth value is automatically estimated from the input data using
+        Scott’s rule.
+    counts : bool
+        A boolean flag indicating if the output values should be probability estimates
+        (false) or smoothed counts (true).
+
+        **Default value:** ``false``
+    cumulative : bool
+        A boolean flag indicating whether to produce density estimates (false) or cumulative
+        density estimates (true).
+
+        **Default value:** ``false``
+    extent : Sequence[float]
+        A [min, max] domain from which to sample the distribution. If unspecified, the
+        extent will be determined by the observed minimum and maximum values of the density
+        value field.
+    groupby : Sequence[str, :class:`FieldName`]
+        The data fields to group by. If not specified, a single group containing all data
+        objects will be used.
+    maxsteps : float
+        The maximum number of samples to take along the extent domain for plotting the
+        density.
+
+        **Default value:** ``200``
+    minsteps : float
+        The minimum number of samples to take along the extent domain for plotting the
+        density.
+
+        **Default value:** ``25``
+    steps : float
+        The exact number of samples to take along the extent domain for plotting the
+        density. If specified, overrides both minsteps and maxsteps to set an exact number
+        of uniform samples. Potentially useful in conjunction with a fixed extent to ensure
+        consistent sample points for stacked densities.
+    as : Sequence[str, :class:`FieldName`]
+        The output fields for the sample value and corresponding density estimate.
+
+        **Default value:** ``["value", "density"]``
+    """
+
+    _schema = {"$ref": "#/definitions/DensityTransform"}
+
+    def __init__(
+        self,
+        density: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        bandwidth: Union[float, UndefinedType] = Undefined,
+        counts: Union[bool, UndefinedType] = Undefined,
+        cumulative: Union[bool, UndefinedType] = Undefined,
+        extent: Union[Sequence[float], UndefinedType] = Undefined,
+        groupby: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        maxsteps: Union[float, UndefinedType] = Undefined,
+        minsteps: Union[float, UndefinedType] = Undefined,
+        steps: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(DensityTransform, self).__init__(
+            density=density,
+            bandwidth=bandwidth,
+            counts=counts,
+            cumulative=cumulative,
+            extent=extent,
+            groupby=groupby,
+            maxsteps=maxsteps,
+            minsteps=minsteps,
+            steps=steps,
+            **kwds,
+        )
+
+
+class ExtentTransform(Transform):
+    """ExtentTransform schema wrapper
+
+    Parameters
+    ----------
+
+    extent : str, :class:`FieldName`
+        The field of which to get the extent.
+    param : str, :class:`ParameterName`
+        The output parameter produced by the extent transform.
+    """
+
+    _schema = {"$ref": "#/definitions/ExtentTransform"}
+
+    def __init__(
+        self,
+        extent: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        param: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ExtentTransform, self).__init__(extent=extent, param=param, **kwds)
+
+
+class FilterTransform(Transform):
+    """FilterTransform schema wrapper
+
+    Parameters
+    ----------
+
+    filter : str, dict, :class:`Predicate`, :class:`FieldGTPredicate`, :class:`FieldLTPredicate`, :class:`FieldGTEPredicate`, :class:`FieldLTEPredicate`, :class:`LogicalOrPredicate`, :class:`ParameterPredicate`, :class:`FieldEqualPredicate`, :class:`FieldOneOfPredicate`, :class:`FieldRangePredicate`, :class:`FieldValidPredicate`, :class:`LogicalAndPredicate`, :class:`LogicalNotPredicate`, :class:`PredicateComposition`
+        The ``filter`` property must be a predication definition, which can take one of the
+        following forms:
+
+        1) an `expression <https://vega.github.io/vega-lite/docs/types.html#expression>`__
+        string, where ``datum`` can be used to refer to the current data object. For
+        example, ``{filter: "datum.b2 > 60"}`` would make the output data includes only
+        items that have values in the field ``b2`` over 60.
+
+        2) one of the `field predicates
+        <https://vega.github.io/vega-lite/docs/predicate.html#field-predicate>`__ : `equal
+        <https://vega.github.io/vega-lite/docs/predicate.html#field-equal-predicate>`__, `lt
+        <https://vega.github.io/vega-lite/docs/predicate.html#lt-predicate>`__, `lte
+        <https://vega.github.io/vega-lite/docs/predicate.html#lte-predicate>`__, `gt
+        <https://vega.github.io/vega-lite/docs/predicate.html#gt-predicate>`__, `gte
+        <https://vega.github.io/vega-lite/docs/predicate.html#gte-predicate>`__, `range
+        <https://vega.github.io/vega-lite/docs/predicate.html#range-predicate>`__, `oneOf
+        <https://vega.github.io/vega-lite/docs/predicate.html#one-of-predicate>`__, or
+        `valid <https://vega.github.io/vega-lite/docs/predicate.html#valid-predicate>`__,
+
+        3) a `selection predicate
+        <https://vega.github.io/vega-lite/docs/predicate.html#selection-predicate>`__, which
+        define the names of a selection that the data point should belong to (or a logical
+        composition of selections).
+
+        4) a `logical composition
+        <https://vega.github.io/vega-lite/docs/predicate.html#composition>`__ of (1), (2),
+        or (3).
+    """
+
+    _schema = {"$ref": "#/definitions/FilterTransform"}
+
+    def __init__(
+        self, filter: Union[str, dict, "SchemaBase", UndefinedType] = Undefined, **kwds
+    ):
+        super(FilterTransform, self).__init__(filter=filter, **kwds)
+
+
+class FlattenTransform(Transform):
+    """FlattenTransform schema wrapper
+
+    Parameters
+    ----------
+
+    flatten : Sequence[str, :class:`FieldName`]
+        An array of one or more data fields containing arrays to flatten. If multiple fields
+        are specified, their array values should have a parallel structure, ideally with the
+        same length. If the lengths of parallel arrays do not match, the longest array will
+        be used with ``null`` values added for missing entries.
+    as : Sequence[str, :class:`FieldName`]
+        The output field names for extracted array values.
+
+        **Default value:** The field name of the corresponding array field
+    """
+
+    _schema = {"$ref": "#/definitions/FlattenTransform"}
+
+    def __init__(
+        self,
+        flatten: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(FlattenTransform, self).__init__(flatten=flatten, **kwds)
+
+
+class FoldTransform(Transform):
+    """FoldTransform schema wrapper
+
+    Parameters
+    ----------
+
+    fold : Sequence[str, :class:`FieldName`]
+        An array of data fields indicating the properties to fold.
+    as : Sequence[str, :class:`FieldName`]
+        The output field names for the key and value properties produced by the fold
+        transform. **Default value:** ``["key", "value"]``
+    """
+
+    _schema = {"$ref": "#/definitions/FoldTransform"}
+
+    def __init__(
+        self,
+        fold: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(FoldTransform, self).__init__(fold=fold, **kwds)
+
+
+class ImputeTransform(Transform):
+    """ImputeTransform schema wrapper
+
+    Parameters
+    ----------
+
+    impute : str, :class:`FieldName`
+        The data field for which the missing values should be imputed.
+    key : str, :class:`FieldName`
+        A key field that uniquely identifies data objects within a group. Missing key values
+        (those occurring in the data but not in the current group) will be imputed.
+    frame : Sequence[None, float]
+        A frame specification as a two-element array used to control the window over which
+        the specified method is applied. The array entries should either be a number
+        indicating the offset from the current data object, or null to indicate unbounded
+        rows preceding or following the current data object. For example, the value ``[-5,
+        5]`` indicates that the window should include five objects preceding and five
+        objects following the current object.
+
+        **Default value:** :  ``[null, null]`` indicating that the window includes all
+        objects.
+    groupby : Sequence[str, :class:`FieldName`]
+        An optional array of fields by which to group the values. Imputation will then be
+        performed on a per-group basis.
+    keyvals : dict, Sequence[Any], :class:`ImputeSequence`
+        Defines the key values that should be considered for imputation. An array of key
+        values or an object defining a `number sequence
+        <https://vega.github.io/vega-lite/docs/impute.html#sequence-def>`__.
+
+        If provided, this will be used in addition to the key values observed within the
+        input data. If not provided, the values will be derived from all unique values of
+        the ``key`` field. For ``impute`` in ``encoding``, the key field is the x-field if
+        the y-field is imputed, or vice versa.
+
+        If there is no impute grouping, this property *must* be specified.
+    method : :class:`ImputeMethod`, Literal['value', 'median', 'max', 'min', 'mean']
+        The imputation method to use for the field value of imputed data objects. One of
+        ``"value"``, ``"mean"``, ``"median"``, ``"max"`` or ``"min"``.
+
+        **Default value:**  ``"value"``
+    value : Any
+        The field value to use when the imputation ``method`` is ``"value"``.
+    """
+
+    _schema = {"$ref": "#/definitions/ImputeTransform"}
+
+    def __init__(
+        self,
+        impute: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        key: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        frame: Union[Sequence[Union[None, float]], UndefinedType] = Undefined,
+        groupby: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        keyvals: Union[dict, "SchemaBase", Sequence[Any], UndefinedType] = Undefined,
+        method: Union[
+            "SchemaBase",
+            Literal["value", "median", "max", "min", "mean"],
+            UndefinedType,
+        ] = Undefined,
+        value: Union[Any, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ImputeTransform, self).__init__(
+            impute=impute,
+            key=key,
+            frame=frame,
+            groupby=groupby,
+            keyvals=keyvals,
+            method=method,
+            value=value,
+            **kwds,
+        )
+
+
+class JoinAggregateTransform(Transform):
+    """JoinAggregateTransform schema wrapper
+
+    Parameters
+    ----------
+
+    joinaggregate : Sequence[dict, :class:`JoinAggregateFieldDef`]
+        The definition of the fields in the join aggregate, and what calculations to use.
+    groupby : Sequence[str, :class:`FieldName`]
+        The data fields for partitioning the data objects into separate groups. If
+        unspecified, all data points will be in a single group.
+    """
+
+    _schema = {"$ref": "#/definitions/JoinAggregateTransform"}
+
+    def __init__(
+        self,
+        joinaggregate: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        groupby: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(JoinAggregateTransform, self).__init__(
+            joinaggregate=joinaggregate, groupby=groupby, **kwds
+        )
+
+
+class LoessTransform(Transform):
+    """LoessTransform schema wrapper
+
+    Parameters
+    ----------
+
+    loess : str, :class:`FieldName`
+        The data field of the dependent variable to smooth.
+    on : str, :class:`FieldName`
+        The data field of the independent variable to use a predictor.
+    bandwidth : float
+        A bandwidth parameter in the range ``[0, 1]`` that determines the amount of
+        smoothing.
+
+        **Default value:** ``0.3``
+    groupby : Sequence[str, :class:`FieldName`]
+        The data fields to group by. If not specified, a single group containing all data
+        objects will be used.
+    as : Sequence[str, :class:`FieldName`]
+        The output field names for the smoothed points generated by the loess transform.
+
+        **Default value:** The field names of the input x and y values.
+    """
+
+    _schema = {"$ref": "#/definitions/LoessTransform"}
+
+    def __init__(
+        self,
+        loess: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        on: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        bandwidth: Union[float, UndefinedType] = Undefined,
+        groupby: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(LoessTransform, self).__init__(
+            loess=loess, on=on, bandwidth=bandwidth, groupby=groupby, **kwds
+        )
+
+
+class LookupTransform(Transform):
+    """LookupTransform schema wrapper
+
+    Parameters
+    ----------
+
+    lookup : str
+        Key in primary data source.
+    default : Any
+        The default value to use if lookup fails.
+
+        **Default value:** ``null``
+    as : str, :class:`FieldName`, Sequence[str, :class:`FieldName`]
+        The output fields on which to store the looked up data values.
+
+        For data lookups, this property may be left blank if ``from.fields`` has been
+        specified (those field names will be used); if ``from.fields`` has not been
+        specified, ``as`` must be a string.
+
+        For selection lookups, this property is optional: if unspecified, looked up values
+        will be stored under a property named for the selection; and if specified, it must
+        correspond to ``from.fields``.
+    from : dict, :class:`LookupData`, :class:`LookupSelection`
+        Data source or selection for secondary data reference.
+    """
+
+    _schema = {"$ref": "#/definitions/LookupTransform"}
+
+    def __init__(
+        self,
+        lookup: Union[str, UndefinedType] = Undefined,
+        default: Union[Any, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(LookupTransform, self).__init__(lookup=lookup, default=default, **kwds)
+
+
+class PivotTransform(Transform):
+    """PivotTransform schema wrapper
+
+    Parameters
+    ----------
+
+    pivot : str, :class:`FieldName`
+        The data field to pivot on. The unique values of this field become new field names
+        in the output stream.
+    value : str, :class:`FieldName`
+        The data field to populate pivoted fields. The aggregate values of this field become
+        the values of the new pivoted fields.
+    groupby : Sequence[str, :class:`FieldName`]
+        The optional data fields to group by. If not specified, a single group containing
+        all data objects will be used.
+    limit : float
+        An optional parameter indicating the maximum number of pivoted fields to generate.
+        The default ( ``0`` ) applies no limit. The pivoted ``pivot`` names are sorted in
+        ascending order prior to enforcing the limit. **Default value:** ``0``
+    op : :class:`AggregateOp`, Literal['argmax', 'argmin', 'average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        The aggregation operation to apply to grouped ``value`` field values. **Default
+        value:** ``sum``
+    """
+
+    _schema = {"$ref": "#/definitions/PivotTransform"}
+
+    def __init__(
+        self,
+        pivot: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        groupby: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        limit: Union[float, UndefinedType] = Undefined,
+        op: Union[
+            "SchemaBase",
+            Literal[
+                "argmax",
+                "argmin",
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(PivotTransform, self).__init__(
+            pivot=pivot, value=value, groupby=groupby, limit=limit, op=op, **kwds
+        )
+
+
+class QuantileTransform(Transform):
+    """QuantileTransform schema wrapper
+
+    Parameters
+    ----------
+
+    quantile : str, :class:`FieldName`
+        The data field for which to perform quantile estimation.
+    groupby : Sequence[str, :class:`FieldName`]
+        The data fields to group by. If not specified, a single group containing all data
+        objects will be used.
+    probs : Sequence[float]
+        An array of probabilities in the range (0, 1) for which to compute quantile values.
+        If not specified, the *step* parameter will be used.
+    step : float
+        A probability step size (default 0.01) for sampling quantile values. All values from
+        one-half the step size up to 1 (exclusive) will be sampled. This parameter is only
+        used if the *probs* parameter is not provided.
+    as : Sequence[str, :class:`FieldName`]
+        The output field names for the probability and quantile values.
+
+        **Default value:** ``["prob", "value"]``
+    """
+
+    _schema = {"$ref": "#/definitions/QuantileTransform"}
+
+    def __init__(
+        self,
+        quantile: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        groupby: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        probs: Union[Sequence[float], UndefinedType] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(QuantileTransform, self).__init__(
+            quantile=quantile, groupby=groupby, probs=probs, step=step, **kwds
+        )
+
+
+class RegressionTransform(Transform):
+    """RegressionTransform schema wrapper
+
+    Parameters
+    ----------
+
+    on : str, :class:`FieldName`
+        The data field of the independent variable to use a predictor.
+    regression : str, :class:`FieldName`
+        The data field of the dependent variable to predict.
+    extent : Sequence[float]
+        A [min, max] domain over the independent (x) field for the starting and ending
+        points of the generated trend line.
+    groupby : Sequence[str, :class:`FieldName`]
+        The data fields to group by. If not specified, a single group containing all data
+        objects will be used.
+    method : Literal['linear', 'log', 'exp', 'pow', 'quad', 'poly']
+        The functional form of the regression model. One of ``"linear"``, ``"log"``,
+        ``"exp"``, ``"pow"``, ``"quad"``, or ``"poly"``.
+
+        **Default value:** ``"linear"``
+    order : float
+        The polynomial order (number of coefficients) for the 'poly' method.
+
+        **Default value:** ``3``
+    params : bool
+        A boolean flag indicating if the transform should return the regression model
+        parameters (one object per group), rather than trend line points. The resulting
+        objects include a ``coef`` array of fitted coefficient values (starting with the
+        intercept term and then including terms of increasing order) and an ``rSquared``
+        value (indicating the total variance explained by the model).
+
+        **Default value:** ``false``
+    as : Sequence[str, :class:`FieldName`]
+        The output field names for the smoothed points generated by the regression
+        transform.
+
+        **Default value:** The field names of the input x and y values.
+    """
+
+    _schema = {"$ref": "#/definitions/RegressionTransform"}
+
+    def __init__(
+        self,
+        on: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        regression: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        extent: Union[Sequence[float], UndefinedType] = Undefined,
+        groupby: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        method: Union[
+            Literal["linear", "log", "exp", "pow", "quad", "poly"], UndefinedType
+        ] = Undefined,
+        order: Union[float, UndefinedType] = Undefined,
+        params: Union[bool, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(RegressionTransform, self).__init__(
+            on=on,
+            regression=regression,
+            extent=extent,
+            groupby=groupby,
+            method=method,
+            order=order,
+            params=params,
+            **kwds,
+        )
+
+
+class SampleTransform(Transform):
+    """SampleTransform schema wrapper
+
+    Parameters
+    ----------
+
+    sample : float
+        The maximum number of data objects to include in the sample.
+
+        **Default value:** ``1000``
+    """
+
+    _schema = {"$ref": "#/definitions/SampleTransform"}
+
+    def __init__(self, sample: Union[float, UndefinedType] = Undefined, **kwds):
+        super(SampleTransform, self).__init__(sample=sample, **kwds)
+
+
+class StackTransform(Transform):
+    """StackTransform schema wrapper
+
+    Parameters
+    ----------
+
+    groupby : Sequence[str, :class:`FieldName`]
+        The data fields to group by.
+    stack : str, :class:`FieldName`
+        The field which is stacked.
+    offset : Literal['zero', 'center', 'normalize']
+        Mode for stacking marks. One of ``"zero"`` (default), ``"center"``, or
+        ``"normalize"``. The ``"zero"`` offset will stack starting at ``0``. The
+        ``"center"`` offset will center the stacks. The ``"normalize"`` offset will compute
+        percentage values for each stack point, with output values in the range ``[0,1]``.
+
+        **Default value:** ``"zero"``
+    sort : Sequence[dict, :class:`SortField`]
+        Field that determines the order of leaves in the stacked charts.
+    as : str, :class:`FieldName`, Sequence[str, :class:`FieldName`]
+        Output field names. This can be either a string or an array of strings with two
+        elements denoting the name for the fields for stack start and stack end
+        respectively. If a single string(e.g., ``"val"`` ) is provided, the end field will
+        be ``"val_end"``.
+    """
+
+    _schema = {"$ref": "#/definitions/StackTransform"}
+
+    def __init__(
+        self,
+        groupby: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        stack: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        offset: Union[
+            Literal["zero", "center", "normalize"], UndefinedType
+        ] = Undefined,
+        sort: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(StackTransform, self).__init__(
+            groupby=groupby, stack=stack, offset=offset, sort=sort, **kwds
+        )
+
+
+class TimeUnitTransform(Transform):
+    """TimeUnitTransform schema wrapper
+
+    Parameters
+    ----------
+
+    field : str, :class:`FieldName`
+        The data field to apply time unit.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`SingleTimeUnit`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, :class:`TimeUnitTransformParams`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        The timeUnit.
+    as : str, :class:`FieldName`
+        The output field to write the timeUnit value.
+    """
+
+    _schema = {"$ref": "#/definitions/TimeUnitTransform"}
+
+    def __init__(
+        self,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(TimeUnitTransform, self).__init__(field=field, timeUnit=timeUnit, **kwds)
+
+
+class Type(VegaLiteSchema):
+    """Type schema wrapper
+    Data type based on level of measurement
+    """
+
+    _schema = {"$ref": "#/definitions/Type"}
+
+    def __init__(self, *args):
+        super(Type, self).__init__(*args)
+
+
+class TypeForShape(VegaLiteSchema):
+    """TypeForShape schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/TypeForShape"}
+
+    def __init__(self, *args):
+        super(TypeForShape, self).__init__(*args)
+
+
+class TypedFieldDef(VegaLiteSchema):
+    """TypedFieldDef schema wrapper
+    Definition object for a data field, its type and transformation of an encoding channel.
+
+    Parameters
+    ----------
+
+    aggregate : dict, :class:`Aggregate`, :class:`ArgmaxDef`, :class:`ArgminDef`, :class:`NonArgAggregateOp`, Literal['average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        Aggregation function for the field (e.g., ``"mean"``, ``"sum"``, ``"median"``,
+        ``"min"``, ``"max"``, ``"count"`` ).
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `aggregate <https://vega.github.io/vega-lite/docs/aggregate.html>`__
+        documentation.
+    bandPosition : float
+        Relative position on a band of a stacked, binned, time unit, or band scale. For
+        example, the marks will be positioned at the beginning of the band if set to ``0``,
+        and at the middle of the band if set to ``0.5``.
+    bin : str, bool, dict, None, :class:`BinParams`
+        A flag for binning a ``quantitative`` field, `an object defining binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__, or indicating
+        that the data for ``x`` or ``y`` channel are binned before they are imported into
+        Vega-Lite ( ``"binned"`` ).
+
+
+        If ``true``, default `binning parameters
+        <https://vega.github.io/vega-lite/docs/bin.html#bin-parameters>`__ will be applied.
+
+        If ``"binned"``, this indicates that the data for the ``x`` (or ``y`` ) channel are
+        already binned. You can map the bin-start field to ``x`` (or ``y`` ) and the bin-end
+        field to ``x2`` (or ``y2`` ). The scale and axis will be formatted similar to
+        binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also
+        set the axis's `tickMinStep
+        <https://vega.github.io/vega-lite/docs/axis.html#ticks>`__ property.
+
+        **Default value:** ``false``
+
+        **See also:** `bin <https://vega.github.io/vega-lite/docs/bin.html>`__
+        documentation.
+    field : str, dict, :class:`Field`, :class:`FieldName`, :class:`RepeatRef`
+        **Required.** A string defining the name of the field from which to pull a data
+        value or an object defining iterated values from the `repeat
+        <https://vega.github.io/vega-lite/docs/repeat.html>`__ operator.
+
+        **See also:** `field <https://vega.github.io/vega-lite/docs/field.html>`__
+        documentation.
+
+        **Notes:** 1)  Dots ( ``.`` ) and brackets ( ``[`` and ``]`` ) can be used to access
+        nested objects (e.g., ``"field": "foo.bar"`` and ``"field": "foo['bar']"`` ). If
+        field names contain dots or brackets but are not nested, you can use ``\\`` to
+        escape dots and brackets (e.g., ``"a\\.b"`` and ``"a\\[0\\]"`` ). See more details
+        about escaping in the `field documentation
+        <https://vega.github.io/vega-lite/docs/field.html>`__. 2) ``field`` is not required
+        if ``aggregate`` is ``count``.
+    timeUnit : dict, :class:`TimeUnit`, :class:`MultiTimeUnit`, :class:`BinnedTimeUnit`, :class:`SingleTimeUnit`, :class:`TimeUnitParams`, :class:`UtcMultiTimeUnit`, :class:`UtcSingleTimeUnit`, :class:`LocalMultiTimeUnit`, :class:`LocalSingleTimeUnit`, Literal['year', 'quarter', 'month', 'week', 'day', 'dayofyear', 'date', 'hours', 'minutes', 'seconds', 'milliseconds'], Literal['utcyear', 'utcquarter', 'utcmonth', 'utcweek', 'utcday', 'utcdayofyear', 'utcdate', 'utchours', 'utcminutes', 'utcseconds', 'utcmilliseconds'], Literal['binnedyear', 'binnedyearquarter', 'binnedyearquartermonth', 'binnedyearmonth', 'binnedyearmonthdate', 'binnedyearmonthdatehours', 'binnedyearmonthdatehoursminutes', 'binnedyearmonthdatehoursminutesseconds', 'binnedyearweek', 'binnedyearweekday', 'binnedyearweekdayhours', 'binnedyearweekdayhoursminutes', 'binnedyearweekdayhoursminutesseconds', 'binnedyeardayofyear'], Literal['binnedutcyear', 'binnedutcyearquarter', 'binnedutcyearquartermonth', 'binnedutcyearmonth', 'binnedutcyearmonthdate', 'binnedutcyearmonthdatehours', 'binnedutcyearmonthdatehoursminutes', 'binnedutcyearmonthdatehoursminutesseconds', 'binnedutcyearweek', 'binnedutcyearweekday', 'binnedutcyearweekdayhours', 'binnedutcyearweekdayhoursminutes', 'binnedutcyearweekdayhoursminutesseconds', 'binnedutcyeardayofyear'], Literal['yearquarter', 'yearquartermonth', 'yearmonth', 'yearmonthdate', 'yearmonthdatehours', 'yearmonthdatehoursminutes', 'yearmonthdatehoursminutesseconds', 'yearweek', 'yearweekday', 'yearweekdayhours', 'yearweekdayhoursminutes', 'yearweekdayhoursminutesseconds', 'yeardayofyear', 'quartermonth', 'monthdate', 'monthdatehours', 'monthdatehoursminutes', 'monthdatehoursminutesseconds', 'weekday', 'weekdayhours', 'weekdayhoursminutes', 'weekdayhoursminutesseconds', 'dayhours', 'dayhoursminutes', 'dayhoursminutesseconds', 'hoursminutes', 'hoursminutesseconds', 'minutesseconds', 'secondsmilliseconds'], Literal['utcyearquarter', 'utcyearquartermonth', 'utcyearmonth', 'utcyearmonthdate', 'utcyearmonthdatehours', 'utcyearmonthdatehoursminutes', 'utcyearmonthdatehoursminutesseconds', 'utcyearweek', 'utcyearweekday', 'utcyearweekdayhours', 'utcyearweekdayhoursminutes', 'utcyearweekdayhoursminutesseconds', 'utcyeardayofyear', 'utcquartermonth', 'utcmonthdate', 'utcmonthdatehours', 'utcmonthdatehoursminutes', 'utcmonthdatehoursminutesseconds', 'utcweekday', 'utcweeksdayhours', 'utcweekdayhoursminutes', 'utcweekdayhoursminutesseconds', 'utcdayhours', 'utcdayhoursminutes', 'utcdayhoursminutesseconds', 'utchoursminutes', 'utchoursminutesseconds', 'utcminutesseconds', 'utcsecondsmilliseconds']
+        Time unit (e.g., ``year``, ``yearmonth``, ``month``, ``hours`` ) for a temporal
+        field. or `a temporal field that gets casted as ordinal
+        <https://vega.github.io/vega-lite/docs/type.html#cast>`__.
+
+        **Default value:** ``undefined`` (None)
+
+        **See also:** `timeUnit <https://vega.github.io/vega-lite/docs/timeunit.html>`__
+        documentation.
+    title : str, None, :class:`Text`, Sequence[str]
+        A title for the field. If ``null``, the title will be removed.
+
+        **Default value:**  derived from the field's name and transformation function (
+        ``aggregate``, ``bin`` and ``timeUnit`` ). If the field has an aggregate function,
+        the function is displayed as part of the title (e.g., ``"Sum of Profit"`` ). If the
+        field is binned or has a time unit applied, the applied function is shown in
+        parentheses (e.g., ``"Profit (binned)"``, ``"Transaction Date (year-month)"`` ).
+        Otherwise, the title is simply the field name.
+
+        **Notes** :
+
+        1) You can customize the default field title format by providing the `fieldTitle
+        <https://vega.github.io/vega-lite/docs/config.html#top-level-config>`__ property in
+        the `config <https://vega.github.io/vega-lite/docs/config.html>`__ or `fieldTitle
+        function via the compile function's options
+        <https://vega.github.io/vega-lite/usage/compile.html#field-title>`__.
+
+        2) If both field definition's ``title`` and axis, header, or legend ``title`` are
+        defined, axis/header/legend title will be used.
+    type : :class:`StandardType`, Literal['quantitative', 'ordinal', 'temporal', 'nominal']
+        The type of measurement ( ``"quantitative"``, ``"temporal"``, ``"ordinal"``, or
+        ``"nominal"`` ) for the encoded field or constant value ( ``datum`` ). It can also
+        be a ``"geojson"`` type for encoding `'geoshape'
+        <https://vega.github.io/vega-lite/docs/geoshape.html>`__.
+
+        Vega-Lite automatically infers data types in many cases as discussed below. However,
+        type is required for a field if: (1) the field is not nominal and the field encoding
+        has no specified ``aggregate`` (except ``argmin`` and ``argmax`` ), ``bin``, scale
+        type, custom ``sort`` order, nor ``timeUnit`` or (2) if you wish to use an ordinal
+        scale for a field with ``bin`` or ``timeUnit``.
+
+        **Default value:**
+
+        1) For a data ``field``, ``"nominal"`` is the default data type unless the field
+        encoding has ``aggregate``, ``channel``, ``bin``, scale type, ``sort``, or
+        ``timeUnit`` that satisfies the following criteria:
+
+
+        * ``"quantitative"`` is the default type if (1) the encoded field contains ``bin``
+          or ``aggregate`` except ``"argmin"`` and ``"argmax"``, (2) the encoding channel is
+          ``latitude`` or ``longitude`` channel or (3) if the specified scale type is `a
+          quantitative scale <https://vega.github.io/vega-lite/docs/scale.html#type>`__.
+        * ``"temporal"`` is the default type if (1) the encoded field contains ``timeUnit``
+          or (2) the specified scale type is a time or utc scale
+        * ``"ordinal"`` is the default type if (1) the encoded field contains a `custom sort
+          order
+          <https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order>`__,
+          (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding
+          channel is ``order``.
+
+        2) For a constant value in data domain ( ``datum`` ):
+
+
+        * ``"quantitative"`` if the datum is a number
+        * ``"nominal"`` if the datum is a string
+        * ``"temporal"`` if the datum is `a date time object
+          <https://vega.github.io/vega-lite/docs/datetime.html>`__
+
+        **Note:**
+
+
+        * Data ``type`` describes the semantics of the data rather than the primitive data
+          types (number, string, etc.). The same primitive data type can have different
+          types of measurement. For example, numeric data can represent quantitative,
+          ordinal, or nominal data.
+        * Data values for a temporal field can be either a date-time string (e.g.,
+          ``"2015-03-07 12:32:17"``, ``"17:01"``, ``"2015-03-16"``. ``"2015"`` ) or a
+          timestamp number (e.g., ``1552199579097`` ).
+        * When using with `bin <https://vega.github.io/vega-lite/docs/bin.html>`__, the
+          ``type`` property can be either ``"quantitative"`` (for using a linear bin scale)
+          or `"ordinal" (for using an ordinal bin scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `timeUnit
+          <https://vega.github.io/vega-lite/docs/timeunit.html>`__, the ``type`` property
+          can be either ``"temporal"`` (default, for using a temporal scale) or `"ordinal"
+          (for using an ordinal scale)
+          <https://vega.github.io/vega-lite/docs/type.html#cast-bin>`__.
+        * When using with `aggregate
+          <https://vega.github.io/vega-lite/docs/aggregate.html>`__, the ``type`` property
+          refers to the post-aggregation data type. For example, we can calculate count
+          ``distinct`` of a categorical field ``"cat"`` using ``{"aggregate": "distinct",
+          "field": "cat"}``. The ``"type"`` of the aggregate output is ``"quantitative"``.
+        * Secondary channels (e.g., ``x2``, ``y2``, ``xError``, ``yError`` ) do not have
+          ``type`` as they must have exactly the same type as their primary channels (e.g.,
+          ``x``, ``y`` ).
+
+        **See also:** `type <https://vega.github.io/vega-lite/docs/type.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/TypedFieldDef"}
+
+    def __init__(
+        self,
+        aggregate: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        bandPosition: Union[float, UndefinedType] = Undefined,
+        bin: Union[str, bool, dict, None, "SchemaBase", UndefinedType] = Undefined,
+        field: Union[str, dict, "SchemaBase", UndefinedType] = Undefined,
+        timeUnit: Union[
+            dict,
+            "SchemaBase",
+            Literal[
+                "year",
+                "quarter",
+                "month",
+                "week",
+                "day",
+                "dayofyear",
+                "date",
+                "hours",
+                "minutes",
+                "seconds",
+                "milliseconds",
+            ],
+            Literal[
+                "utcyear",
+                "utcquarter",
+                "utcmonth",
+                "utcweek",
+                "utcday",
+                "utcdayofyear",
+                "utcdate",
+                "utchours",
+                "utcminutes",
+                "utcseconds",
+                "utcmilliseconds",
+            ],
+            Literal[
+                "binnedyear",
+                "binnedyearquarter",
+                "binnedyearquartermonth",
+                "binnedyearmonth",
+                "binnedyearmonthdate",
+                "binnedyearmonthdatehours",
+                "binnedyearmonthdatehoursminutes",
+                "binnedyearmonthdatehoursminutesseconds",
+                "binnedyearweek",
+                "binnedyearweekday",
+                "binnedyearweekdayhours",
+                "binnedyearweekdayhoursminutes",
+                "binnedyearweekdayhoursminutesseconds",
+                "binnedyeardayofyear",
+            ],
+            Literal[
+                "binnedutcyear",
+                "binnedutcyearquarter",
+                "binnedutcyearquartermonth",
+                "binnedutcyearmonth",
+                "binnedutcyearmonthdate",
+                "binnedutcyearmonthdatehours",
+                "binnedutcyearmonthdatehoursminutes",
+                "binnedutcyearmonthdatehoursminutesseconds",
+                "binnedutcyearweek",
+                "binnedutcyearweekday",
+                "binnedutcyearweekdayhours",
+                "binnedutcyearweekdayhoursminutes",
+                "binnedutcyearweekdayhoursminutesseconds",
+                "binnedutcyeardayofyear",
+            ],
+            Literal[
+                "yearquarter",
+                "yearquartermonth",
+                "yearmonth",
+                "yearmonthdate",
+                "yearmonthdatehours",
+                "yearmonthdatehoursminutes",
+                "yearmonthdatehoursminutesseconds",
+                "yearweek",
+                "yearweekday",
+                "yearweekdayhours",
+                "yearweekdayhoursminutes",
+                "yearweekdayhoursminutesseconds",
+                "yeardayofyear",
+                "quartermonth",
+                "monthdate",
+                "monthdatehours",
+                "monthdatehoursminutes",
+                "monthdatehoursminutesseconds",
+                "weekday",
+                "weekdayhours",
+                "weekdayhoursminutes",
+                "weekdayhoursminutesseconds",
+                "dayhours",
+                "dayhoursminutes",
+                "dayhoursminutesseconds",
+                "hoursminutes",
+                "hoursminutesseconds",
+                "minutesseconds",
+                "secondsmilliseconds",
+            ],
+            Literal[
+                "utcyearquarter",
+                "utcyearquartermonth",
+                "utcyearmonth",
+                "utcyearmonthdate",
+                "utcyearmonthdatehours",
+                "utcyearmonthdatehoursminutes",
+                "utcyearmonthdatehoursminutesseconds",
+                "utcyearweek",
+                "utcyearweekday",
+                "utcyearweekdayhours",
+                "utcyearweekdayhoursminutes",
+                "utcyearweekdayhoursminutesseconds",
+                "utcyeardayofyear",
+                "utcquartermonth",
+                "utcmonthdate",
+                "utcmonthdatehours",
+                "utcmonthdatehoursminutes",
+                "utcmonthdatehoursminutesseconds",
+                "utcweekday",
+                "utcweeksdayhours",
+                "utcweekdayhoursminutes",
+                "utcweekdayhoursminutesseconds",
+                "utcdayhours",
+                "utcdayhoursminutes",
+                "utcdayhoursminutesseconds",
+                "utchoursminutes",
+                "utchoursminutesseconds",
+                "utcminutesseconds",
+                "utcsecondsmilliseconds",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        title: Union[str, None, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        type: Union[
+            "SchemaBase",
+            Literal["quantitative", "ordinal", "temporal", "nominal"],
+            UndefinedType,
+        ] = Undefined,
+        **kwds,
+    ):
+        super(TypedFieldDef, self).__init__(
+            aggregate=aggregate,
+            bandPosition=bandPosition,
+            bin=bin,
+            field=field,
+            timeUnit=timeUnit,
+            title=title,
+            type=type,
+            **kwds,
+        )
+
+
+class URI(VegaLiteSchema):
+    """URI schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/URI"}
+
+    def __init__(self, *args):
+        super(URI, self).__init__(*args)
+
+
+class UnitSpec(VegaLiteSchema):
+    """UnitSpec schema wrapper
+    Base interface for a unit (single-view) specification.
+
+    Parameters
+    ----------
+
+    mark : str, dict, :class:`Mark`, :class:`AnyMark`, :class:`BoxPlot`, :class:`MarkDef`, :class:`ErrorBar`, :class:`ErrorBand`, :class:`BoxPlotDef`, :class:`ErrorBarDef`, :class:`ErrorBandDef`, :class:`CompositeMark`, :class:`CompositeMarkDef`, Literal['arc', 'area', 'bar', 'image', 'line', 'point', 'rect', 'rule', 'text', 'tick', 'trail', 'circle', 'square', 'geoshape']
+        A string describing the mark type (one of ``"bar"``, ``"circle"``, ``"square"``,
+        ``"tick"``, ``"line"``, ``"area"``, ``"point"``, ``"rule"``, ``"geoshape"``, and
+        ``"text"`` ) or a `mark definition object
+        <https://vega.github.io/vega-lite/docs/mark.html#mark-def>`__.
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    description : str
+        Description of this mark for commenting purpose.
+    encoding : dict, :class:`Encoding`
+        A key-value mapping between encoding channels and definition of fields.
+    name : str
+        Name of the visualization for later reference.
+    params : Sequence[dict, :class:`SelectionParameter`]
+        An array of parameters that may either be simple variables, or more complex
+        selections that map user input to data queries.
+    projection : dict, :class:`Projection`
+        An object defining properties of geographic projection, which will be applied to
+        ``shape`` path for ``"geoshape"`` marks and to ``latitude`` and ``"longitude"``
+        channels for other marks.
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    """
+
+    _schema = {"$ref": "#/definitions/UnitSpec"}
+
+    def __init__(
+        self,
+        mark: Union[
+            str,
+            dict,
+            "SchemaBase",
+            Literal[
+                "arc",
+                "area",
+                "bar",
+                "image",
+                "line",
+                "point",
+                "rect",
+                "rule",
+                "text",
+                "tick",
+                "trail",
+                "circle",
+                "square",
+                "geoshape",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        encoding: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        params: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        projection: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(UnitSpec, self).__init__(
+            mark=mark,
+            data=data,
+            description=description,
+            encoding=encoding,
+            name=name,
+            params=params,
+            projection=projection,
+            title=title,
+            transform=transform,
+            **kwds,
+        )
+
+
+class UnitSpecWithFrame(VegaLiteSchema):
+    """UnitSpecWithFrame schema wrapper
+
+    Parameters
+    ----------
+
+    mark : str, dict, :class:`Mark`, :class:`AnyMark`, :class:`BoxPlot`, :class:`MarkDef`, :class:`ErrorBar`, :class:`ErrorBand`, :class:`BoxPlotDef`, :class:`ErrorBarDef`, :class:`ErrorBandDef`, :class:`CompositeMark`, :class:`CompositeMarkDef`, Literal['arc', 'area', 'bar', 'image', 'line', 'point', 'rect', 'rule', 'text', 'tick', 'trail', 'circle', 'square', 'geoshape']
+        A string describing the mark type (one of ``"bar"``, ``"circle"``, ``"square"``,
+        ``"tick"``, ``"line"``, ``"area"``, ``"point"``, ``"rule"``, ``"geoshape"``, and
+        ``"text"`` ) or a `mark definition object
+        <https://vega.github.io/vega-lite/docs/mark.html#mark-def>`__.
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    description : str
+        Description of this mark for commenting purpose.
+    encoding : dict, :class:`Encoding`
+        A key-value mapping between encoding channels and definition of fields.
+    height : str, dict, float, :class:`Step`
+        The height of a visualization.
+
+
+        * For a plot with a continuous y-field, height should be a number.
+        * For a plot with either a discrete y-field or no y-field, height can be either a
+          number indicating a fixed height or an object in the form of ``{step: number}``
+          defining the height per discrete step. (No y-field is equivalent to having one
+          discrete step.)
+        * To enable responsive sizing on height, it should be set to ``"container"``.
+
+        **Default value:** Based on ``config.view.continuousHeight`` for a plot with a
+        continuous y-field and ``config.view.discreteHeight`` otherwise.
+
+        **Note:** For plots with `row and column channels
+        <https://vega.github.io/vega-lite/docs/encoding.html#facet>`__, this represents the
+        height of a single view and the ``"container"`` option cannot be used.
+
+        **See also:** `height <https://vega.github.io/vega-lite/docs/size.html>`__
+        documentation.
+    name : str
+        Name of the visualization for later reference.
+    params : Sequence[dict, :class:`SelectionParameter`]
+        An array of parameters that may either be simple variables, or more complex
+        selections that map user input to data queries.
+    projection : dict, :class:`Projection`
+        An object defining properties of geographic projection, which will be applied to
+        ``shape`` path for ``"geoshape"`` marks and to ``latitude`` and ``"longitude"``
+        channels for other marks.
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    view : dict, :class:`ViewBackground`
+        An object defining the view background's fill and stroke.
+
+        **Default value:** none (transparent)
+    width : str, dict, float, :class:`Step`
+        The width of a visualization.
+
+
+        * For a plot with a continuous x-field, width should be a number.
+        * For a plot with either a discrete x-field or no x-field, width can be either a
+          number indicating a fixed width or an object in the form of ``{step: number}``
+          defining the width per discrete step. (No x-field is equivalent to having one
+          discrete step.)
+        * To enable responsive sizing on width, it should be set to ``"container"``.
+
+        **Default value:** Based on ``config.view.continuousWidth`` for a plot with a
+        continuous x-field and ``config.view.discreteWidth`` otherwise.
+
+        **Note:** For plots with `row and column channels
+        <https://vega.github.io/vega-lite/docs/encoding.html#facet>`__, this represents the
+        width of a single view and the ``"container"`` option cannot be used.
+
+        **See also:** `width <https://vega.github.io/vega-lite/docs/size.html>`__
+        documentation.
+    """
+
+    _schema = {"$ref": "#/definitions/UnitSpecWithFrame"}
+
+    def __init__(
+        self,
+        mark: Union[
+            str,
+            dict,
+            "SchemaBase",
+            Literal[
+                "arc",
+                "area",
+                "bar",
+                "image",
+                "line",
+                "point",
+                "rect",
+                "rule",
+                "text",
+                "tick",
+                "trail",
+                "circle",
+                "square",
+                "geoshape",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        encoding: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        height: Union[str, dict, float, "SchemaBase", UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        params: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        projection: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        view: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        width: Union[str, dict, float, "SchemaBase", UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(UnitSpecWithFrame, self).__init__(
+            mark=mark,
+            data=data,
+            description=description,
+            encoding=encoding,
+            height=height,
+            name=name,
+            params=params,
+            projection=projection,
+            title=title,
+            transform=transform,
+            view=view,
+            width=width,
+            **kwds,
+        )
+
+
+class UrlData(DataSource):
+    """UrlData schema wrapper
+
+    Parameters
+    ----------
+
+    url : str
+        An URL from which to load the data set. Use the ``format.type`` property to ensure
+        the loaded data is correctly parsed.
+    format : dict, :class:`DataFormat`, :class:`CsvDataFormat`, :class:`DsvDataFormat`, :class:`JsonDataFormat`, :class:`TopoDataFormat`
+        An object that specifies the format for parsing the data.
+    name : str
+        Provide a placeholder name and bind data at runtime.
+    """
+
+    _schema = {"$ref": "#/definitions/UrlData"}
+
+    def __init__(
+        self,
+        url: Union[str, UndefinedType] = Undefined,
+        format: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(UrlData, self).__init__(url=url, format=format, name=name, **kwds)
+
+
+class UtcMultiTimeUnit(MultiTimeUnit):
+    """UtcMultiTimeUnit schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/UtcMultiTimeUnit"}
+
+    def __init__(self, *args):
+        super(UtcMultiTimeUnit, self).__init__(*args)
+
+
+class UtcSingleTimeUnit(SingleTimeUnit):
+    """UtcSingleTimeUnit schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/UtcSingleTimeUnit"}
+
+    def __init__(self, *args):
+        super(UtcSingleTimeUnit, self).__init__(*args)
+
+
+class VConcatSpecGenericSpec(Spec, NonNormalizedSpec):
+    """VConcatSpecGenericSpec schema wrapper
+    Base interface for a vertical concatenation specification.
+
+    Parameters
+    ----------
+
+    vconcat : Sequence[dict, :class:`Spec`, :class:`FacetSpec`, :class:`LayerSpec`, :class:`RepeatSpec`, :class:`FacetedUnitSpec`, :class:`LayerRepeatSpec`, :class:`NonLayerRepeatSpec`, :class:`ConcatSpecGenericSpec`, :class:`HConcatSpecGenericSpec`, :class:`VConcatSpecGenericSpec`]
+        A list of views to be concatenated and put into a column.
+    bounds : Literal['full', 'flush']
+        The bounds calculation method to use for determining the extent of a sub-plot. One
+        of ``full`` (the default) or ``flush``.
+
+
+        * If set to ``full``, the entire calculated bounds (including axes, title, and
+          legend) will be used.
+        * If set to ``flush``, only the specified width and height values for the sub-view
+          will be used. The ``flush`` setting can be useful when attempting to place
+          sub-plots without axes or legends into a uniform grid structure.
+
+        **Default value:** ``"full"``
+    center : bool
+        Boolean flag indicating if subviews should be centered relative to their respective
+        rows or columns.
+
+        **Default value:** ``false``
+    data : dict, None, :class:`Data`, :class:`UrlData`, :class:`Generator`, :class:`NamedData`, :class:`DataSource`, :class:`InlineData`, :class:`SphereGenerator`, :class:`SequenceGenerator`, :class:`GraticuleGenerator`
+        An object describing the data source. Set to ``null`` to ignore the parent's data
+        source. If no data is set, it is derived from the parent.
+    description : str
+        Description of this mark for commenting purpose.
+    name : str
+        Name of the visualization for later reference.
+    resolve : dict, :class:`Resolve`
+        Scale, axis, and legend resolutions for view composition specifications.
+    spacing : float
+        The spacing in pixels between sub-views of the concat operator.
+
+        **Default value** : ``10``
+    title : str, dict, :class:`Text`, Sequence[str], :class:`TitleParams`
+        Title for the plot.
+    transform : Sequence[dict, :class:`Transform`, :class:`BinTransform`, :class:`FoldTransform`, :class:`LoessTransform`, :class:`PivotTransform`, :class:`StackTransform`, :class:`ExtentTransform`, :class:`FilterTransform`, :class:`ImputeTransform`, :class:`LookupTransform`, :class:`SampleTransform`, :class:`WindowTransform`, :class:`DensityTransform`, :class:`FlattenTransform`, :class:`QuantileTransform`, :class:`TimeUnitTransform`, :class:`AggregateTransform`, :class:`CalculateTransform`, :class:`RegressionTransform`, :class:`JoinAggregateTransform`]
+        An array of data transformations such as filter and new field calculation.
+    """
+
+    _schema = {"$ref": "#/definitions/VConcatSpec<GenericSpec>"}
+
+    def __init__(
+        self,
+        vconcat: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        bounds: Union[Literal["full", "flush"], UndefinedType] = Undefined,
+        center: Union[bool, UndefinedType] = Undefined,
+        data: Union[dict, None, "SchemaBase", UndefinedType] = Undefined,
+        description: Union[str, UndefinedType] = Undefined,
+        name: Union[str, UndefinedType] = Undefined,
+        resolve: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        spacing: Union[float, UndefinedType] = Undefined,
+        title: Union[str, dict, "SchemaBase", Sequence[str], UndefinedType] = Undefined,
+        transform: Union[
+            Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(VConcatSpecGenericSpec, self).__init__(
+            vconcat=vconcat,
+            bounds=bounds,
+            center=center,
+            data=data,
+            description=description,
+            name=name,
+            resolve=resolve,
+            spacing=spacing,
+            title=title,
+            transform=transform,
+            **kwds,
+        )
+
+
+class ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull(
+    ColorDef, MarkPropDefGradientstringnull
+):
+    """ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefGradientstringnullExprRef`, :class:`ConditionalParameterValueDefGradientstringnullExprRef`, :class:`ConditionalPredicateValueDefGradientstringnullExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, None, :class:`ExprRef`, :class:`Gradient`, :class:`LinearGradient`, :class:`RadialGradient`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {
+        "$ref": "#/definitions/ValueDefWithCondition<MarkPropFieldOrDatumDef,(Gradient|string|null)>"
+    }
+
+    def __init__(
+        self,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        value: Union[
+            str, dict, None, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(
+            ValueDefWithConditionMarkPropFieldOrDatumDefGradientstringnull, self
+        ).__init__(condition=condition, value=value, **kwds)
+
+
+class ValueDefWithConditionMarkPropFieldOrDatumDefTypeForShapestringnull(
+    MarkPropDefstringnullTypeForShape, ShapeDef
+):
+    """ValueDefWithConditionMarkPropFieldOrDatumDefTypeForShapestringnull schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`, :class:`ConditionalMarkPropFieldOrDatumDefTypeForShape`, :class:`ConditionalParameterMarkPropFieldOrDatumDefTypeForShape`, :class:`ConditionalPredicateMarkPropFieldOrDatumDefTypeForShape`, Sequence[dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, None, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {
+        "$ref": "#/definitions/ValueDefWithCondition<MarkPropFieldOrDatumDef<TypeForShape>,(string|null)>"
+    }
+
+    def __init__(
+        self,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        value: Union[
+            str, dict, None, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(
+            ValueDefWithConditionMarkPropFieldOrDatumDefTypeForShapestringnull, self
+        ).__init__(condition=condition, value=value, **kwds)
+
+
+class ValueDefWithConditionMarkPropFieldOrDatumDefnumber(
+    MarkPropDefnumber, NumericMarkPropDef
+):
+    """ValueDefWithConditionMarkPropFieldOrDatumDefnumber schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, Sequence[dict, :class:`ConditionalValueDefnumberExprRef`, :class:`ConditionalParameterValueDefnumberExprRef`, :class:`ConditionalPredicateValueDefnumberExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {
+        "$ref": "#/definitions/ValueDefWithCondition<MarkPropFieldOrDatumDef,number>"
+    }
+
+    def __init__(
+        self,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        value: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ValueDefWithConditionMarkPropFieldOrDatumDefnumber, self).__init__(
+            condition=condition, value=value, **kwds
+        )
+
+
+class ValueDefWithConditionMarkPropFieldOrDatumDefnumberArray(
+    MarkPropDefnumberArray, NumericArrayMarkPropDef
+):
+    """ValueDefWithConditionMarkPropFieldOrDatumDefnumberArray schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefnumberArrayExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefnumberArrayExprRef`, :class:`ConditionalPredicateValueDefnumberArrayExprRef`, Sequence[dict, :class:`ConditionalValueDefnumberArrayExprRef`, :class:`ConditionalParameterValueDefnumberArrayExprRef`, :class:`ConditionalPredicateValueDefnumberArrayExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : dict, Sequence[float], :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {
+        "$ref": "#/definitions/ValueDefWithCondition<MarkPropFieldOrDatumDef,number[]>"
+    }
+
+    def __init__(
+        self,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        value: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ValueDefWithConditionMarkPropFieldOrDatumDefnumberArray, self).__init__(
+            condition=condition, value=value, **kwds
+        )
+
+
+class ValueDefWithConditionMarkPropFieldOrDatumDefstringnull(VegaLiteSchema):
+    """ValueDefWithConditionMarkPropFieldOrDatumDefstringnull schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalMarkPropFieldOrDatumDef`, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterMarkPropFieldOrDatumDef`, :class:`ConditionalPredicateMarkPropFieldOrDatumDef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`, Sequence[dict, :class:`ConditionalValueDefstringnullExprRef`, :class:`ConditionalParameterValueDefstringnullExprRef`, :class:`ConditionalPredicateValueDefstringnullExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, None, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {
+        "$ref": "#/definitions/ValueDefWithCondition<MarkPropFieldOrDatumDef,(string|null)>"
+    }
+
+    def __init__(
+        self,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        value: Union[
+            str, dict, None, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ValueDefWithConditionMarkPropFieldOrDatumDefstringnull, self).__init__(
+            condition=condition, value=value, **kwds
+        )
+
+
+class ValueDefWithConditionStringFieldDefText(TextDef):
+    """ValueDefWithConditionStringFieldDefText schema wrapper
+
+    Parameters
+    ----------
+
+    condition : dict, :class:`ConditionalStringFieldDef`, :class:`ConditionalValueDefTextExprRef`, :class:`ConditionalParameterStringFieldDef`, :class:`ConditionalPredicateStringFieldDef`, :class:`ConditionalParameterValueDefTextExprRef`, :class:`ConditionalPredicateValueDefTextExprRef`, Sequence[dict, :class:`ConditionalValueDefTextExprRef`, :class:`ConditionalParameterValueDefTextExprRef`, :class:`ConditionalPredicateValueDefTextExprRef`]
+        A field definition or one or more value definition(s) with a parameter predicate.
+    value : str, dict, :class:`Text`, Sequence[str], :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {"$ref": "#/definitions/ValueDefWithCondition<StringFieldDef,Text>"}
+
+    def __init__(
+        self,
+        condition: Union[
+            dict, "SchemaBase", Sequence[Union[dict, "SchemaBase"]], UndefinedType
+        ] = Undefined,
+        value: Union[
+            str, dict, "_Parameter", "SchemaBase", Sequence[str], UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ValueDefWithConditionStringFieldDefText, self).__init__(
+            condition=condition, value=value, **kwds
+        )
+
+
+class ValueDefnumber(OffsetDef):
+    """ValueDefnumber schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : float
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {"$ref": "#/definitions/ValueDef<number>"}
+
+    def __init__(self, value: Union[float, UndefinedType] = Undefined, **kwds):
+        super(ValueDefnumber, self).__init__(value=value, **kwds)
+
+
+class ValueDefnumberwidthheightExprRef(VegaLiteSchema):
+    """ValueDefnumberwidthheightExprRef schema wrapper
+    Definition object for a constant value (primitive value or gradient definition) of an
+    encoding channel.
+
+    Parameters
+    ----------
+
+    value : str, dict, float, :class:`ExprRef`
+        A constant value in visual domain (e.g., ``"red"`` / ``"#0099ff"`` / `gradient
+        definition <https://vega.github.io/vega-lite/docs/types.html#gradient>`__ for color,
+        values between ``0`` to ``1`` for opacity).
+    """
+
+    _schema = {"$ref": '#/definitions/ValueDef<(number|"width"|"height"|ExprRef)>'}
+
+    def __init__(
+        self,
+        value: Union[
+            str, dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ValueDefnumberwidthheightExprRef, self).__init__(value=value, **kwds)
+
+
+class VariableParameter(TopLevelParameter):
+    """VariableParameter schema wrapper
+
+    Parameters
+    ----------
+
+    name : str, :class:`ParameterName`
+        A unique name for the variable parameter. Parameter names should be valid JavaScript
+        identifiers: they should contain only alphanumeric characters (or "$", or "_") and
+        may not start with a digit. Reserved keywords that may not be used as parameter
+        names are "datum", "event", "item", and "parent".
+    bind : dict, :class:`Binding`, :class:`BindInput`, :class:`BindRange`, :class:`BindDirect`, :class:`BindCheckbox`, :class:`BindRadioSelect`
+        Binds the parameter to an external input element such as a slider, selection list or
+        radio button group.
+    expr : str, :class:`Expr`
+        An expression for the value of the parameter. This expression may include other
+        parameters, in which case the parameter will automatically update in response to
+        upstream parameter changes.
+    value : Any
+        The `initial value <http://vega.github.io/vega-lite/docs/value.html>`__ of the
+        parameter.
+
+        **Default value:** ``undefined``
+    """
+
+    _schema = {"$ref": "#/definitions/VariableParameter"}
+
+    def __init__(
+        self,
+        name: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        bind: Union[dict, "SchemaBase", UndefinedType] = Undefined,
+        expr: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        value: Union[Any, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(VariableParameter, self).__init__(
+            name=name, bind=bind, expr=expr, value=value, **kwds
+        )
+
+
+class Vector10string(VegaLiteSchema):
+    """Vector10string schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Vector10<string>"}
+
+    def __init__(self, *args):
+        super(Vector10string, self).__init__(*args)
+
+
+class Vector12string(VegaLiteSchema):
+    """Vector12string schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Vector12<string>"}
+
+    def __init__(self, *args):
+        super(Vector12string, self).__init__(*args)
+
+
+class Vector2DateTime(SelectionInitInterval):
+    """Vector2DateTime schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Vector2<DateTime>"}
+
+    def __init__(self, *args):
+        super(Vector2DateTime, self).__init__(*args)
+
+
+class Vector2Vector2number(VegaLiteSchema):
+    """Vector2Vector2number schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Vector2<Vector2<number>>"}
+
+    def __init__(self, *args):
+        super(Vector2Vector2number, self).__init__(*args)
+
+
+class Vector2boolean(SelectionInitInterval):
+    """Vector2boolean schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Vector2<boolean>"}
+
+    def __init__(self, *args):
+        super(Vector2boolean, self).__init__(*args)
+
+
+class Vector2number(SelectionInitInterval):
+    """Vector2number schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Vector2<number>"}
+
+    def __init__(self, *args):
+        super(Vector2number, self).__init__(*args)
+
+
+class Vector2string(SelectionInitInterval):
+    """Vector2string schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Vector2<string>"}
+
+    def __init__(self, *args):
+        super(Vector2string, self).__init__(*args)
+
+
+class Vector3number(VegaLiteSchema):
+    """Vector3number schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Vector3<number>"}
+
+    def __init__(self, *args):
+        super(Vector3number, self).__init__(*args)
+
+
+class Vector7string(VegaLiteSchema):
+    """Vector7string schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/Vector7<string>"}
+
+    def __init__(self, *args):
+        super(Vector7string, self).__init__(*args)
+
+
+class ViewBackground(VegaLiteSchema):
+    """ViewBackground schema wrapper
+
+    Parameters
+    ----------
+
+    cornerRadius : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles or arcs' corners.
+
+        **Default value:** ``0``
+    cursor : :class:`Cursor`, Literal['auto', 'default', 'none', 'context-menu', 'help', 'pointer', 'progress', 'wait', 'cell', 'crosshair', 'text', 'vertical-text', 'alias', 'copy', 'move', 'no-drop', 'not-allowed', 'e-resize', 'n-resize', 'ne-resize', 'nw-resize', 's-resize', 'se-resize', 'sw-resize', 'w-resize', 'ew-resize', 'ns-resize', 'nesw-resize', 'nwse-resize', 'col-resize', 'row-resize', 'all-scroll', 'zoom-in', 'zoom-out', 'grab', 'grabbing']
+        The mouse cursor used over the view. Any valid `CSS cursor type
+        <https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values>`__ can be used.
+    fill : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The fill color.
+
+        **Default value:** ``undefined``
+    fillOpacity : dict, float, :class:`ExprRef`
+        The fill opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    opacity : dict, float, :class:`ExprRef`
+        The overall opacity (value between [0,1]).
+
+        **Default value:** ``0.7`` for non-aggregate plots with ``point``, ``tick``,
+        ``circle``, or ``square`` marks or layered ``bar`` charts and ``1`` otherwise.
+    stroke : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The stroke color.
+
+        **Default value:** ``"#ddd"``
+    strokeCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for line ending style. One of ``"butt"``, ``"round"``, or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    strokeDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating stroke, space lengths for creating dashed or dotted lines.
+    strokeDashOffset : dict, float, :class:`ExprRef`
+        The offset (in pixels) into which to begin drawing with the stroke dash array.
+    strokeJoin : dict, :class:`ExprRef`, :class:`StrokeJoin`, Literal['miter', 'round', 'bevel']
+        The stroke line join method. One of ``"miter"``, ``"round"`` or ``"bevel"``.
+
+        **Default value:** ``"miter"``
+    strokeMiterLimit : dict, float, :class:`ExprRef`
+        The miter limit at which to bevel a line join.
+    strokeOpacity : dict, float, :class:`ExprRef`
+        The stroke opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    strokeWidth : dict, float, :class:`ExprRef`
+        The stroke width, in pixels.
+    style : str, Sequence[str]
+        A string or array of strings indicating the name of custom styles to apply to the
+        view background. A style is a named collection of mark property defaults defined
+        within the `style configuration
+        <https://vega.github.io/vega-lite/docs/mark.html#style-config>`__. If style is an
+        array, later styles will override earlier styles.
+
+        **Default value:** ``"cell"`` **Note:** Any specified view background properties
+        will augment the default style.
+    """
+
+    _schema = {"$ref": "#/definitions/ViewBackground"}
+
+    def __init__(
+        self,
+        cornerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            "SchemaBase",
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(ViewBackground, self).__init__(
+            cornerRadius=cornerRadius,
+            cursor=cursor,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            opacity=opacity,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            **kwds,
+        )
+
+
+class ViewConfig(VegaLiteSchema):
+    """ViewConfig schema wrapper
+
+    Parameters
+    ----------
+
+    clip : bool
+        Whether the view should be clipped.
+    continuousHeight : float
+        The default height when the plot has a continuous y-field for x or latitude, or has
+        arc marks.
+
+        **Default value:** ``200``
+    continuousWidth : float
+        The default width when the plot has a continuous field for x or longitude, or has
+        arc marks.
+
+        **Default value:** ``200``
+    cornerRadius : dict, float, :class:`ExprRef`
+        The radius in pixels of rounded rectangles or arcs' corners.
+
+        **Default value:** ``0``
+    cursor : :class:`Cursor`, Literal['auto', 'default', 'none', 'context-menu', 'help', 'pointer', 'progress', 'wait', 'cell', 'crosshair', 'text', 'vertical-text', 'alias', 'copy', 'move', 'no-drop', 'not-allowed', 'e-resize', 'n-resize', 'ne-resize', 'nw-resize', 's-resize', 'se-resize', 'sw-resize', 'w-resize', 'ew-resize', 'ns-resize', 'nesw-resize', 'nwse-resize', 'col-resize', 'row-resize', 'all-scroll', 'zoom-in', 'zoom-out', 'grab', 'grabbing']
+        The mouse cursor used over the view. Any valid `CSS cursor type
+        <https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values>`__ can be used.
+    discreteHeight : dict, float
+        The default height when the plot has non arc marks and either a discrete y-field or
+        no y-field. The height can be either a number indicating a fixed height or an object
+        in the form of ``{step: number}`` defining the height per discrete step.
+
+        **Default value:** a step size based on ``config.view.step``.
+    discreteWidth : dict, float
+        The default width when the plot has non-arc marks and either a discrete x-field or
+        no x-field. The width can be either a number indicating a fixed width or an object
+        in the form of ``{step: number}`` defining the width per discrete step.
+
+        **Default value:** a step size based on ``config.view.step``.
+    fill : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The fill color.
+
+        **Default value:** ``undefined``
+    fillOpacity : dict, float, :class:`ExprRef`
+        The fill opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    opacity : dict, float, :class:`ExprRef`
+        The overall opacity (value between [0,1]).
+
+        **Default value:** ``0.7`` for non-aggregate plots with ``point``, ``tick``,
+        ``circle``, or ``square`` marks or layered ``bar`` charts and ``1`` otherwise.
+    step : float
+        Default step size for x-/y- discrete fields.
+    stroke : str, dict, None, :class:`Color`, :class:`ExprRef`, :class:`HexColor`, :class:`ColorName`, Literal['black', 'silver', 'gray', 'white', 'maroon', 'red', 'purple', 'fuchsia', 'green', 'lime', 'olive', 'yellow', 'navy', 'blue', 'teal', 'aqua', 'orange', 'aliceblue', 'antiquewhite', 'aquamarine', 'azure', 'beige', 'bisque', 'blanchedalmond', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'limegreen', 'linen', 'magenta', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'oldlace', 'olivedrab', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'whitesmoke', 'yellowgreen', 'rebeccapurple']
+        The stroke color.
+
+        **Default value:** ``"#ddd"``
+    strokeCap : dict, :class:`ExprRef`, :class:`StrokeCap`, Literal['butt', 'round', 'square']
+        The stroke cap for line ending style. One of ``"butt"``, ``"round"``, or
+        ``"square"``.
+
+        **Default value:** ``"butt"``
+    strokeDash : dict, Sequence[float], :class:`ExprRef`
+        An array of alternating stroke, space lengths for creating dashed or dotted lines.
+    strokeDashOffset : dict, float, :class:`ExprRef`
+        The offset (in pixels) into which to begin drawing with the stroke dash array.
+    strokeJoin : dict, :class:`ExprRef`, :class:`StrokeJoin`, Literal['miter', 'round', 'bevel']
+        The stroke line join method. One of ``"miter"``, ``"round"`` or ``"bevel"``.
+
+        **Default value:** ``"miter"``
+    strokeMiterLimit : dict, float, :class:`ExprRef`
+        The miter limit at which to bevel a line join.
+    strokeOpacity : dict, float, :class:`ExprRef`
+        The stroke opacity (value between [0,1]).
+
+        **Default value:** ``1``
+    strokeWidth : dict, float, :class:`ExprRef`
+        The stroke width, in pixels.
+    """
+
+    _schema = {"$ref": "#/definitions/ViewConfig"}
+
+    def __init__(
+        self,
+        clip: Union[bool, UndefinedType] = Undefined,
+        continuousHeight: Union[float, UndefinedType] = Undefined,
+        continuousWidth: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            "SchemaBase",
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        discreteHeight: Union[dict, float, UndefinedType] = Undefined,
+        discreteWidth: Union[dict, float, UndefinedType] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        step: Union[float, UndefinedType] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            "_Parameter",
+            "SchemaBase",
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, "_Parameter", "SchemaBase", Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            "_Parameter",
+            "SchemaBase",
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, "_Parameter", "SchemaBase", UndefinedType
+        ] = Undefined,
+        **kwds,
+    ):
+        super(ViewConfig, self).__init__(
+            clip=clip,
+            continuousHeight=continuousHeight,
+            continuousWidth=continuousWidth,
+            cornerRadius=cornerRadius,
+            cursor=cursor,
+            discreteHeight=discreteHeight,
+            discreteWidth=discreteWidth,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            opacity=opacity,
+            step=step,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            **kwds,
+        )
+
+
+class WindowEventType(VegaLiteSchema):
+    """WindowEventType schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/WindowEventType"}
+
+    def __init__(self, *args, **kwds):
+        super(WindowEventType, self).__init__(*args, **kwds)
+
+
+class EventType(WindowEventType):
+    """EventType schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/EventType"}
+
+    def __init__(self, *args):
+        super(EventType, self).__init__(*args)
+
+
+class WindowFieldDef(VegaLiteSchema):
+    """WindowFieldDef schema wrapper
+
+    Parameters
+    ----------
+
+    op : :class:`AggregateOp`, :class:`WindowOnlyOp`, Literal['row_number', 'rank', 'dense_rank', 'percent_rank', 'cume_dist', 'ntile', 'lag', 'lead', 'first_value', 'last_value', 'nth_value'], Literal['argmax', 'argmin', 'average', 'count', 'distinct', 'max', 'mean', 'median', 'min', 'missing', 'product', 'q1', 'q3', 'ci0', 'ci1', 'stderr', 'stdev', 'stdevp', 'sum', 'valid', 'values', 'variance', 'variancep', 'exponential', 'exponentialb']
+        The window or aggregation operation to apply within a window (e.g., ``"rank"``,
+        ``"lead"``, ``"sum"``, ``"average"`` or ``"count"`` ). See the list of all supported
+        operations `here <https://vega.github.io/vega-lite/docs/window.html#ops>`__.
+    field : str, :class:`FieldName`
+        The data field for which to compute the aggregate or window function. This can be
+        omitted for window functions that do not operate over a field such as ``"count"``,
+        ``"rank"``, ``"dense_rank"``.
+    param : float
+        Parameter values for the window functions. Parameter values can be omitted for
+        operations that do not accept a parameter.
+
+        See the list of all supported operations and their parameters `here
+        <https://vega.github.io/vega-lite/docs/transforms/window.html>`__.
+    as : str, :class:`FieldName`
+        The output name for the window operation.
+    """
+
+    _schema = {"$ref": "#/definitions/WindowFieldDef"}
+
+    def __init__(
+        self,
+        op: Union[
+            "SchemaBase",
+            Literal[
+                "row_number",
+                "rank",
+                "dense_rank",
+                "percent_rank",
+                "cume_dist",
+                "ntile",
+                "lag",
+                "lead",
+                "first_value",
+                "last_value",
+                "nth_value",
+            ],
+            Literal[
+                "argmax",
+                "argmin",
+                "average",
+                "count",
+                "distinct",
+                "max",
+                "mean",
+                "median",
+                "min",
+                "missing",
+                "product",
+                "q1",
+                "q3",
+                "ci0",
+                "ci1",
+                "stderr",
+                "stdev",
+                "stdevp",
+                "sum",
+                "valid",
+                "values",
+                "variance",
+                "variancep",
+                "exponential",
+                "exponentialb",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        field: Union[str, "SchemaBase", UndefinedType] = Undefined,
+        param: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(WindowFieldDef, self).__init__(op=op, field=field, param=param, **kwds)
+
+
+class WindowOnlyOp(VegaLiteSchema):
+    """WindowOnlyOp schema wrapper"""
+
+    _schema = {"$ref": "#/definitions/WindowOnlyOp"}
+
+    def __init__(self, *args):
+        super(WindowOnlyOp, self).__init__(*args)
+
+
+class WindowTransform(Transform):
+    """WindowTransform schema wrapper
+
+    Parameters
+    ----------
+
+    window : Sequence[dict, :class:`WindowFieldDef`]
+        The definition of the fields in the window, and what calculations to use.
+    frame : Sequence[None, float]
+        A frame specification as a two-element array indicating how the sliding window
+        should proceed. The array entries should either be a number indicating the offset
+        from the current data object, or null to indicate unbounded rows preceding or
+        following the current data object. The default value is ``[null, 0]``, indicating
+        that the sliding window includes the current object and all preceding objects. The
+        value ``[-5, 5]`` indicates that the window should include five objects preceding
+        and five objects following the current object. Finally, ``[null, null]`` indicates
+        that the window frame should always include all data objects. If you this frame and
+        want to assign the same value to add objects, you can use the simpler `join
+        aggregate transform <https://vega.github.io/vega-lite/docs/joinaggregate.html>`__.
+        The only operators affected are the aggregation operations and the ``first_value``,
+        ``last_value``, and ``nth_value`` window operations. The other window operations are
+        not affected by this.
+
+        **Default value:** :  ``[null, 0]`` (includes the current object and all preceding
+        objects)
+    groupby : Sequence[str, :class:`FieldName`]
+        The data fields for partitioning the data objects into separate windows. If
+        unspecified, all data points will be in a single window.
+    ignorePeers : bool
+        Indicates if the sliding window frame should ignore peer values (data that are
+        considered identical by the sort criteria). The default is false, causing the window
+        frame to expand to include all peer values. If set to true, the window frame will be
+        defined by offset values only. This setting only affects those operations that
+        depend on the window frame, namely aggregation operations and the first_value,
+        last_value, and nth_value window operations.
+
+        **Default value:** ``false``
+    sort : Sequence[dict, :class:`SortField`]
+        A sort field definition for sorting data objects within a window. If two data
+        objects are considered equal by the comparator, they are considered "peer" values of
+        equal rank. If sort is not specified, the order is undefined: data objects are
+        processed in the order they are observed and none are considered peers (the
+        ignorePeers parameter is ignored and treated as if set to ``true`` ).
+    """
+
+    _schema = {"$ref": "#/definitions/WindowTransform"}
+
+    def __init__(
+        self,
+        window: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        frame: Union[Sequence[Union[None, float]], UndefinedType] = Undefined,
+        groupby: Union[Sequence[Union[str, "SchemaBase"]], UndefinedType] = Undefined,
+        ignorePeers: Union[bool, UndefinedType] = Undefined,
+        sort: Union[Sequence[Union[dict, "SchemaBase"]], UndefinedType] = Undefined,
+        **kwds,
+    ):
+        super(WindowTransform, self).__init__(
+            window=window,
+            frame=frame,
+            groupby=groupby,
+            ignorePeers=ignorePeers,
+            sort=sort,
+            **kwds,
+        )
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/schema/mixins.py b/llm/Lib/site-packages/altair/vegalite/v5/schema/mixins.py
new file mode 100644
index 0000000000000000000000000000000000000000..24002b68eb99b6a99634aa59f1ebbc622e638513
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/v5/schema/mixins.py
@@ -0,0 +1,13987 @@
+# The contents of this file are automatically written by
+# tools/generate_schema_wrapper.py. Do not modify directly.
+
+import sys
+
+
+from . import core
+from altair.utils import use_signature
+from altair.utils.schemapi import Undefined, UndefinedType
+from typing import Any, Sequence, List, Literal, Union
+
+
+if sys.version_info >= (3, 11):
+    from typing import Self
+else:
+    from typing_extensions import Self
+
+
+class MarkMethodMixin:
+    """A mixin class that defines mark methods"""
+
+    def mark_arc(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'arc' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="arc", **kwds)
+        else:
+            copy.mark = "arc"
+        return copy
+
+    def mark_area(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'area' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="area", **kwds)
+        else:
+            copy.mark = "area"
+        return copy
+
+    def mark_bar(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'bar' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="bar", **kwds)
+        else:
+            copy.mark = "bar"
+        return copy
+
+    def mark_image(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'image' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="image", **kwds)
+        else:
+            copy.mark = "image"
+        return copy
+
+    def mark_line(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'line' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="line", **kwds)
+        else:
+            copy.mark = "line"
+        return copy
+
+    def mark_point(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'point' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="point", **kwds)
+        else:
+            copy.mark = "point"
+        return copy
+
+    def mark_rect(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'rect' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="rect", **kwds)
+        else:
+            copy.mark = "rect"
+        return copy
+
+    def mark_rule(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'rule' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="rule", **kwds)
+        else:
+            copy.mark = "rule"
+        return copy
+
+    def mark_text(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'text' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="text", **kwds)
+        else:
+            copy.mark = "text"
+        return copy
+
+    def mark_tick(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'tick' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="tick", **kwds)
+        else:
+            copy.mark = "tick"
+        return copy
+
+    def mark_trail(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'trail' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="trail", **kwds)
+        else:
+            copy.mark = "trail"
+        return copy
+
+    def mark_circle(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'circle' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="circle", **kwds)
+        else:
+            copy.mark = "circle"
+        return copy
+
+    def mark_square(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'square' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="square", **kwds)
+        else:
+            copy.mark = "square"
+        return copy
+
+    def mark_geoshape(
+        self,
+        align: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["left", "center", "right"],
+            UndefinedType,
+        ] = Undefined,
+        angle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aria: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRole: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ariaRoleDescription: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        aspect: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        bandSize: Union[float, UndefinedType] = Undefined,
+        baseline: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["top", "middle", "bottom"],
+            UndefinedType,
+        ] = Undefined,
+        binSpacing: Union[float, UndefinedType] = Undefined,
+        blend: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                None,
+                "multiply",
+                "screen",
+                "overlay",
+                "darken",
+                "lighten",
+                "color-dodge",
+                "color-burn",
+                "hard-light",
+                "soft-light",
+                "difference",
+                "exclusion",
+                "hue",
+                "saturation",
+                "color",
+                "luminosity",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        clip: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        continuousBandSize: Union[float, UndefinedType] = Undefined,
+        cornerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusBottomRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusEnd: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopLeft: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cornerRadiusTopRight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        cursor: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "auto",
+                "default",
+                "none",
+                "context-menu",
+                "help",
+                "pointer",
+                "progress",
+                "wait",
+                "cell",
+                "crosshair",
+                "text",
+                "vertical-text",
+                "alias",
+                "copy",
+                "move",
+                "no-drop",
+                "not-allowed",
+                "e-resize",
+                "n-resize",
+                "ne-resize",
+                "nw-resize",
+                "s-resize",
+                "se-resize",
+                "sw-resize",
+                "w-resize",
+                "ew-resize",
+                "ns-resize",
+                "nesw-resize",
+                "nwse-resize",
+                "col-resize",
+                "row-resize",
+                "all-scroll",
+                "zoom-in",
+                "zoom-out",
+                "grab",
+                "grabbing",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        description: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dir: Union[
+            dict, core._Parameter, core.SchemaBase, Literal["ltr", "rtl"], UndefinedType
+        ] = Undefined,
+        discreteBandSize: Union[
+            dict, float, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dx: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        dy: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        ellipsis: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fill: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        fillOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        filled: Union[bool, UndefinedType] = Undefined,
+        font: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontStyle: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        fontWeight: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "normal",
+                "bold",
+                "lighter",
+                "bolder",
+                100,
+                200,
+                300,
+                400,
+                500,
+                600,
+                700,
+                800,
+                900,
+            ],
+            UndefinedType,
+        ] = Undefined,
+        height: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        href: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        innerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        limit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        line: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        lineBreak: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        lineHeight: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        minBandSize: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        opacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        order: Union[bool, None, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outerRadius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        padAngle: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        point: Union[str, bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        radius: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radius2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        radiusOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        shape: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        size: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        smooth: Union[
+            bool, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        stroke: Union[
+            str,
+            dict,
+            None,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        strokeCap: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["butt", "round", "square"],
+            UndefinedType,
+        ] = Undefined,
+        strokeDash: Union[
+            dict, core._Parameter, core.SchemaBase, Sequence[float], UndefinedType
+        ] = Undefined,
+        strokeDashOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeJoin: Union[
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal["miter", "round", "bevel"],
+            UndefinedType,
+        ] = Undefined,
+        strokeMiterLimit: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeOpacity: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        strokeWidth: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        style: Union[str, Sequence[str], UndefinedType] = Undefined,
+        tension: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        text: Union[
+            str, dict, Sequence[str], core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        theta2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thetaOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        timeUnitBandPosition: Union[float, UndefinedType] = Undefined,
+        timeUnitBandSize: Union[float, UndefinedType] = Undefined,
+        tooltip: Union[
+            str,
+            bool,
+            dict,
+            None,
+            float,
+            core._Parameter,
+            core.SchemaBase,
+            UndefinedType,
+        ] = Undefined,
+        url: Union[
+            str, dict, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        width: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        x2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        xOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2: Union[
+            str, dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        y2Offset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        yOffset: Union[
+            dict, float, core._Parameter, core.SchemaBase, UndefinedType
+        ] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'geoshape' (see :class:`MarkDef`)"""
+        kwds = dict(
+            align=align,
+            angle=angle,
+            aria=aria,
+            ariaRole=ariaRole,
+            ariaRoleDescription=ariaRoleDescription,
+            aspect=aspect,
+            bandSize=bandSize,
+            baseline=baseline,
+            binSpacing=binSpacing,
+            blend=blend,
+            clip=clip,
+            color=color,
+            continuousBandSize=continuousBandSize,
+            cornerRadius=cornerRadius,
+            cornerRadiusBottomLeft=cornerRadiusBottomLeft,
+            cornerRadiusBottomRight=cornerRadiusBottomRight,
+            cornerRadiusEnd=cornerRadiusEnd,
+            cornerRadiusTopLeft=cornerRadiusTopLeft,
+            cornerRadiusTopRight=cornerRadiusTopRight,
+            cursor=cursor,
+            description=description,
+            dir=dir,
+            discreteBandSize=discreteBandSize,
+            dx=dx,
+            dy=dy,
+            ellipsis=ellipsis,
+            fill=fill,
+            fillOpacity=fillOpacity,
+            filled=filled,
+            font=font,
+            fontSize=fontSize,
+            fontStyle=fontStyle,
+            fontWeight=fontWeight,
+            height=height,
+            href=href,
+            innerRadius=innerRadius,
+            interpolate=interpolate,
+            invalid=invalid,
+            limit=limit,
+            line=line,
+            lineBreak=lineBreak,
+            lineHeight=lineHeight,
+            minBandSize=minBandSize,
+            opacity=opacity,
+            order=order,
+            orient=orient,
+            outerRadius=outerRadius,
+            padAngle=padAngle,
+            point=point,
+            radius=radius,
+            radius2=radius2,
+            radius2Offset=radius2Offset,
+            radiusOffset=radiusOffset,
+            shape=shape,
+            size=size,
+            smooth=smooth,
+            stroke=stroke,
+            strokeCap=strokeCap,
+            strokeDash=strokeDash,
+            strokeDashOffset=strokeDashOffset,
+            strokeJoin=strokeJoin,
+            strokeMiterLimit=strokeMiterLimit,
+            strokeOffset=strokeOffset,
+            strokeOpacity=strokeOpacity,
+            strokeWidth=strokeWidth,
+            style=style,
+            tension=tension,
+            text=text,
+            theta=theta,
+            theta2=theta2,
+            theta2Offset=theta2Offset,
+            thetaOffset=thetaOffset,
+            thickness=thickness,
+            timeUnitBandPosition=timeUnitBandPosition,
+            timeUnitBandSize=timeUnitBandSize,
+            tooltip=tooltip,
+            url=url,
+            width=width,
+            x=x,
+            x2=x2,
+            x2Offset=x2Offset,
+            xOffset=xOffset,
+            y=y,
+            y2=y2,
+            y2Offset=y2Offset,
+            yOffset=yOffset,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.MarkDef(type="geoshape", **kwds)
+        else:
+            copy.mark = "geoshape"
+        return copy
+
+    def mark_boxplot(
+        self,
+        box: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        clip: Union[bool, UndefinedType] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        extent: Union[str, float, UndefinedType] = Undefined,
+        invalid: Union[Literal["filter", None], UndefinedType] = Undefined,
+        median: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        opacity: Union[float, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        outliers: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        rule: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        size: Union[float, UndefinedType] = Undefined,
+        ticks: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'boxplot' (see :class:`BoxPlotDef`)"""
+        kwds = dict(
+            box=box,
+            clip=clip,
+            color=color,
+            extent=extent,
+            invalid=invalid,
+            median=median,
+            opacity=opacity,
+            orient=orient,
+            outliers=outliers,
+            rule=rule,
+            size=size,
+            ticks=ticks,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.BoxPlotDef(type="boxplot", **kwds)
+        else:
+            copy.mark = "boxplot"
+        return copy
+
+    def mark_errorbar(
+        self,
+        clip: Union[bool, UndefinedType] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        extent: Union[
+            core.SchemaBase, Literal["ci", "iqr", "stderr", "stdev"], UndefinedType
+        ] = Undefined,
+        opacity: Union[float, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        rule: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        size: Union[float, UndefinedType] = Undefined,
+        thickness: Union[float, UndefinedType] = Undefined,
+        ticks: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'errorbar' (see :class:`ErrorBarDef`)"""
+        kwds = dict(
+            clip=clip,
+            color=color,
+            extent=extent,
+            opacity=opacity,
+            orient=orient,
+            rule=rule,
+            size=size,
+            thickness=thickness,
+            ticks=ticks,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.ErrorBarDef(type="errorbar", **kwds)
+        else:
+            copy.mark = "errorbar"
+        return copy
+
+    def mark_errorband(
+        self,
+        band: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        borders: Union[bool, dict, core.SchemaBase, UndefinedType] = Undefined,
+        clip: Union[bool, UndefinedType] = Undefined,
+        color: Union[
+            str,
+            dict,
+            core._Parameter,
+            core.SchemaBase,
+            Literal[
+                "black",
+                "silver",
+                "gray",
+                "white",
+                "maroon",
+                "red",
+                "purple",
+                "fuchsia",
+                "green",
+                "lime",
+                "olive",
+                "yellow",
+                "navy",
+                "blue",
+                "teal",
+                "aqua",
+                "orange",
+                "aliceblue",
+                "antiquewhite",
+                "aquamarine",
+                "azure",
+                "beige",
+                "bisque",
+                "blanchedalmond",
+                "blueviolet",
+                "brown",
+                "burlywood",
+                "cadetblue",
+                "chartreuse",
+                "chocolate",
+                "coral",
+                "cornflowerblue",
+                "cornsilk",
+                "crimson",
+                "cyan",
+                "darkblue",
+                "darkcyan",
+                "darkgoldenrod",
+                "darkgray",
+                "darkgreen",
+                "darkgrey",
+                "darkkhaki",
+                "darkmagenta",
+                "darkolivegreen",
+                "darkorange",
+                "darkorchid",
+                "darkred",
+                "darksalmon",
+                "darkseagreen",
+                "darkslateblue",
+                "darkslategray",
+                "darkslategrey",
+                "darkturquoise",
+                "darkviolet",
+                "deeppink",
+                "deepskyblue",
+                "dimgray",
+                "dimgrey",
+                "dodgerblue",
+                "firebrick",
+                "floralwhite",
+                "forestgreen",
+                "gainsboro",
+                "ghostwhite",
+                "gold",
+                "goldenrod",
+                "greenyellow",
+                "grey",
+                "honeydew",
+                "hotpink",
+                "indianred",
+                "indigo",
+                "ivory",
+                "khaki",
+                "lavender",
+                "lavenderblush",
+                "lawngreen",
+                "lemonchiffon",
+                "lightblue",
+                "lightcoral",
+                "lightcyan",
+                "lightgoldenrodyellow",
+                "lightgray",
+                "lightgreen",
+                "lightgrey",
+                "lightpink",
+                "lightsalmon",
+                "lightseagreen",
+                "lightskyblue",
+                "lightslategray",
+                "lightslategrey",
+                "lightsteelblue",
+                "lightyellow",
+                "limegreen",
+                "linen",
+                "magenta",
+                "mediumaquamarine",
+                "mediumblue",
+                "mediumorchid",
+                "mediumpurple",
+                "mediumseagreen",
+                "mediumslateblue",
+                "mediumspringgreen",
+                "mediumturquoise",
+                "mediumvioletred",
+                "midnightblue",
+                "mintcream",
+                "mistyrose",
+                "moccasin",
+                "navajowhite",
+                "oldlace",
+                "olivedrab",
+                "orangered",
+                "orchid",
+                "palegoldenrod",
+                "palegreen",
+                "paleturquoise",
+                "palevioletred",
+                "papayawhip",
+                "peachpuff",
+                "peru",
+                "pink",
+                "plum",
+                "powderblue",
+                "rosybrown",
+                "royalblue",
+                "saddlebrown",
+                "salmon",
+                "sandybrown",
+                "seagreen",
+                "seashell",
+                "sienna",
+                "skyblue",
+                "slateblue",
+                "slategray",
+                "slategrey",
+                "snow",
+                "springgreen",
+                "steelblue",
+                "tan",
+                "thistle",
+                "tomato",
+                "turquoise",
+                "violet",
+                "wheat",
+                "whitesmoke",
+                "yellowgreen",
+                "rebeccapurple",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        extent: Union[
+            core.SchemaBase, Literal["ci", "iqr", "stderr", "stdev"], UndefinedType
+        ] = Undefined,
+        interpolate: Union[
+            core.SchemaBase,
+            Literal[
+                "basis",
+                "basis-open",
+                "basis-closed",
+                "bundle",
+                "cardinal",
+                "cardinal-open",
+                "cardinal-closed",
+                "catmull-rom",
+                "linear",
+                "linear-closed",
+                "monotone",
+                "natural",
+                "step",
+                "step-before",
+                "step-after",
+            ],
+            UndefinedType,
+        ] = Undefined,
+        opacity: Union[float, UndefinedType] = Undefined,
+        orient: Union[
+            core.SchemaBase, Literal["horizontal", "vertical"], UndefinedType
+        ] = Undefined,
+        tension: Union[float, UndefinedType] = Undefined,
+        **kwds,
+    ) -> Self:
+        """Set the chart's mark to 'errorband' (see :class:`ErrorBandDef`)"""
+        kwds = dict(
+            band=band,
+            borders=borders,
+            clip=clip,
+            color=color,
+            extent=extent,
+            interpolate=interpolate,
+            opacity=opacity,
+            orient=orient,
+            tension=tension,
+            **kwds,
+        )
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        if any(val is not Undefined for val in kwds.values()):
+            copy.mark = core.ErrorBandDef(type="errorband", **kwds)
+        else:
+            copy.mark = "errorband"
+        return copy
+
+
+class ConfigMethodMixin:
+    """A mixin class that defines config methods"""
+
+    @use_signature(core.Config)
+    def configure(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=False)  # type: ignore[attr-defined]
+        copy.config = core.Config(*args, **kwargs)
+        return copy
+
+    @use_signature(core.RectConfig)
+    def configure_arc(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["arc"] = core.RectConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AreaConfig)
+    def configure_area(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["area"] = core.AreaConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axis(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axis"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisBand(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisBand"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisBottom(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisBottom"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisDiscrete(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisDiscrete"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisLeft(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisLeft"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisPoint(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisPoint"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisQuantitative(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisQuantitative"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisRight(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisRight"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisTemporal(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisTemporal"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisTop(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisTop"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisX(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisX"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisXBand(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisXBand"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisXDiscrete(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisXDiscrete"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisXPoint(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisXPoint"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisXQuantitative(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisXQuantitative"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisXTemporal(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisXTemporal"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisY(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisY"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisYBand(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisYBand"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisYDiscrete(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisYDiscrete"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisYPoint(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisYPoint"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisYQuantitative(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisYQuantitative"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.AxisConfig)
+    def configure_axisYTemporal(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["axisYTemporal"] = core.AxisConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.BarConfig)
+    def configure_bar(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["bar"] = core.BarConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.BoxPlotConfig)
+    def configure_boxplot(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["boxplot"] = core.BoxPlotConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.MarkConfig)
+    def configure_circle(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["circle"] = core.MarkConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.CompositionConfig)
+    def configure_concat(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["concat"] = core.CompositionConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.ErrorBandConfig)
+    def configure_errorband(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["errorband"] = core.ErrorBandConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.ErrorBarConfig)
+    def configure_errorbar(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["errorbar"] = core.ErrorBarConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.CompositionConfig)
+    def configure_facet(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["facet"] = core.CompositionConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.MarkConfig)
+    def configure_geoshape(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["geoshape"] = core.MarkConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.HeaderConfig)
+    def configure_header(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["header"] = core.HeaderConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.HeaderConfig)
+    def configure_headerColumn(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["headerColumn"] = core.HeaderConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.HeaderConfig)
+    def configure_headerFacet(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["headerFacet"] = core.HeaderConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.HeaderConfig)
+    def configure_headerRow(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["headerRow"] = core.HeaderConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.RectConfig)
+    def configure_image(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["image"] = core.RectConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.LegendConfig)
+    def configure_legend(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["legend"] = core.LegendConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.LineConfig)
+    def configure_line(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["line"] = core.LineConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.MarkConfig)
+    def configure_mark(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["mark"] = core.MarkConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.MarkConfig)
+    def configure_point(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["point"] = core.MarkConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.ProjectionConfig)
+    def configure_projection(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["projection"] = core.ProjectionConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.RangeConfig)
+    def configure_range(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["range"] = core.RangeConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.RectConfig)
+    def configure_rect(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["rect"] = core.RectConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.MarkConfig)
+    def configure_rule(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["rule"] = core.MarkConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.ScaleConfig)
+    def configure_scale(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["scale"] = core.ScaleConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.SelectionConfig)
+    def configure_selection(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["selection"] = core.SelectionConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.MarkConfig)
+    def configure_square(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["square"] = core.MarkConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.MarkConfig)
+    def configure_text(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["text"] = core.MarkConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.TickConfig)
+    def configure_tick(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["tick"] = core.TickConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.TitleConfig)
+    def configure_title(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["title"] = core.TitleConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.FormatConfig)
+    def configure_tooltipFormat(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["tooltipFormat"] = core.FormatConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.LineConfig)
+    def configure_trail(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["trail"] = core.LineConfig(*args, **kwargs)
+        return copy
+
+    @use_signature(core.ViewConfig)
+    def configure_view(self, *args, **kwargs) -> Self:
+        copy = self.copy(deep=["config"])  # type: ignore[attr-defined]
+        if copy.config is Undefined:
+            copy.config = core.Config()
+        copy.config["view"] = core.ViewConfig(*args, **kwargs)
+        return copy
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/schema/vega-lite-schema.json b/llm/Lib/site-packages/altair/vegalite/v5/schema/vega-lite-schema.json
new file mode 100644
index 0000000000000000000000000000000000000000..6f8de4b46c08699e675c81d3971e54c63bfcc049
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/v5/schema/vega-lite-schema.json
@@ -0,0 +1,31709 @@
+{
+  "$ref": "#/definitions/TopLevelSpec",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "Aggregate": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/NonArgAggregateOp"
+        },
+        {
+          "$ref": "#/definitions/ArgmaxDef"
+        },
+        {
+          "$ref": "#/definitions/ArgminDef"
+        }
+      ]
+    },
+    "AggregateOp": {
+      "enum": [
+        "argmax",
+        "argmin",
+        "average",
+        "count",
+        "distinct",
+        "max",
+        "mean",
+        "median",
+        "min",
+        "missing",
+        "product",
+        "q1",
+        "q3",
+        "ci0",
+        "ci1",
+        "stderr",
+        "stdev",
+        "stdevp",
+        "sum",
+        "valid",
+        "values",
+        "variance",
+        "variancep",
+        "exponential",
+        "exponentialb"
+      ],
+      "type": "string"
+    },
+    "AggregateTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "aggregate": {
+          "description": "Array of objects that define fields to aggregate.",
+          "items": {
+            "$ref": "#/definitions/AggregatedFieldDef"
+          },
+          "type": "array"
+        },
+        "groupby": {
+          "description": "The data fields to group by. If not specified, a single group containing all data objects will be used.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "aggregate"
+      ],
+      "type": "object"
+    },
+    "AggregatedFieldDef": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The output field names to use for each aggregated field."
+        },
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field for which to compute aggregate function. This is required for all aggregation operations except `\"count\"`."
+        },
+        "op": {
+          "$ref": "#/definitions/AggregateOp",
+          "description": "The aggregation operation to apply to the fields (e.g., `\"sum\"`, `\"average\"`, or `\"count\"`). See the [full list of supported aggregation operations](https://vega.github.io/vega-lite/docs/aggregate.html#ops) for more information."
+        }
+      },
+      "required": [
+        "op",
+        "as"
+      ],
+      "type": "object"
+    },
+    "Align": {
+      "enum": [
+        "left",
+        "center",
+        "right"
+      ],
+      "type": "string"
+    },
+    "AllSortString": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/SortOrder"
+        },
+        {
+          "$ref": "#/definitions/SortByChannel"
+        },
+        {
+          "$ref": "#/definitions/SortByChannelDesc"
+        }
+      ]
+    },
+    "AnyMark": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/CompositeMark"
+        },
+        {
+          "$ref": "#/definitions/CompositeMarkDef"
+        },
+        {
+          "$ref": "#/definitions/Mark"
+        },
+        {
+          "$ref": "#/definitions/MarkDef"
+        }
+      ]
+    },
+    "AnyMarkConfig": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/MarkConfig"
+        },
+        {
+          "$ref": "#/definitions/AreaConfig"
+        },
+        {
+          "$ref": "#/definitions/BarConfig"
+        },
+        {
+          "$ref": "#/definitions/RectConfig"
+        },
+        {
+          "$ref": "#/definitions/LineConfig"
+        },
+        {
+          "$ref": "#/definitions/TickConfig"
+        }
+      ]
+    },
+    "AreaConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule). One of `\"left\"`, `\"right\"`, `\"center\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "angle": {
+          "anyOf": [
+            {
+              "description": "The rotation angle of the text, in degrees.",
+              "maximum": 360,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG element, removing the mark item from the ARIA accessibility tree.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRole": {
+          "anyOf": [
+            {
+              "description": "Sets the type of user interface element of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"role\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRoleDescription": {
+          "anyOf": [
+            {
+              "description": "A human-readable, author-localized description for the role of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"aria-roledescription\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aspect": {
+          "anyOf": [
+            {
+              "description": "Whether to keep aspect ratio of image marks.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "baseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For text marks, the vertical text baseline. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, `\"line-bottom\"`, or an expression reference that provides one of the valid values. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the `lineHeight` rather than `fontSize` alone.\n\nFor range marks, the vertical alignment of the marks. One of `\"top\"`, `\"middle\"`, `\"bottom\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "blend": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Blend",
+              "description": "The color blend mode for drawing an item on its current background. Any valid [CSS mix-blend-mode](https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode) value can be used.\n\n__Default value: `\"source-over\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "color": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default color.\n\n__Default value:__ <span style=\"color: #4682b4;\">&#9632;</span> `\"#4682b4\"`\n\n__Note:__\n- This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).\n- The `fill` and `stroke` properties have higher precedence than `color` and will override `color`."
+        },
+        "cornerRadius": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles or arcs' corners.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cursor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Cursor",
+              "description": "The mouse cursor used over the mark. Any valid [CSS cursor type](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values) can be used."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "description": {
+          "anyOf": [
+            {
+              "description": "A text description of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the [\"aria-label\" attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dir": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextDirection",
+              "description": "The direction of the text. One of `\"ltr\"` (left-to-right) or `\"rtl\"` (right-to-left). This property determines on which side is truncated in response to the limit parameter.\n\n__Default value:__ `\"ltr\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dx": {
+          "anyOf": [
+            {
+              "description": "The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dy": {
+          "anyOf": [
+            {
+              "description": "The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ellipsis": {
+          "anyOf": [
+            {
+              "description": "The ellipsis string for text truncated in response to the limit parameter.\n\n__Default value:__ `\"…\"`",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "endAngle": {
+          "anyOf": [
+            {
+              "description": "The end angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fill": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default fill color. This property has higher precedence than `config.color`. Set to `null` to remove fill.\n\n__Default value:__ (None)"
+        },
+        "fillOpacity": {
+          "anyOf": [
+            {
+              "description": "The fill opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "filled": {
+          "description": "Whether the mark's color should be used as fill color instead of stroke color.\n\n__Default value:__ `false` for all `point`, `line`, and `rule` marks as well as `geoshape` marks for [`graticule`](https://vega.github.io/vega-lite/docs/data.html#graticule) data sources; otherwise, `true`.\n\n__Note:__ This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).",
+          "type": "boolean"
+        },
+        "font": {
+          "anyOf": [
+            {
+              "description": "The typeface to set the text in (e.g., `\"Helvetica Neue\"`).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontSize": {
+          "anyOf": [
+            {
+              "description": "The font size, in pixels.\n\n__Default value:__ `11`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "The font style (e.g., `\"italic\"`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "The font weight. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "height": {
+          "anyOf": [
+            {
+              "description": "Height of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "href": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "A URL to load upon mouse click. If defined, the mark acts as a hyperlink."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "innerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The inner radius in pixels of arc marks. `innerRadius` is an alias for `radius2`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "interpolate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Interpolate",
+              "description": "The line interpolation method to use for line and area marks. One of the following:\n- `\"linear\"`: piecewise linear segments, as in a polyline.\n- `\"linear-closed\"`: close the linear segments to form a polygon.\n- `\"step\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"step-before\"`: alternate between vertical and horizontal segments, as in a step function.\n- `\"step-after\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"basis\"`: a B-spline, with control point duplication on the ends.\n- `\"basis-open\"`: an open B-spline; may not intersect the start or end.\n- `\"basis-closed\"`: a closed B-spline, as in a loop.\n- `\"cardinal\"`: a Cardinal spline, with control point duplication on the ends.\n- `\"cardinal-open\"`: an open Cardinal spline; may not intersect the start or end, but will intersect other control points.\n- `\"cardinal-closed\"`: a closed Cardinal spline, as in a loop.\n- `\"bundle\"`: equivalent to basis, except the tension parameter is used to straighten the spline.\n- `\"monotone\"`: cubic interpolation that preserves monotonicity in y."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "invalid": {
+          "description": "Defines how Vega-Lite should handle marks for invalid values (`null` and `NaN`).\n- If set to `\"filter\"` (default), all data items with null values will be skipped (for line, trail, and area marks) or filtered (for other marks).\n- If `null`, all data items are included. In this case, invalid values will be interpreted as zeroes.",
+          "enum": [
+            "filter",
+            null
+          ],
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "limit": {
+          "anyOf": [
+            {
+              "description": "The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.\n\n__Default value:__ `0` -- indicating no limit",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "line": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/OverlayMarkDef"
+            }
+          ],
+          "description": "A flag for overlaying line on top of area marks, or an object defining the properties of the overlayed lines.\n\n- If this value is an empty object (`{}`) or `true`, lines with default properties will be used.\n\n- If this value is `false`, no lines would be automatically added to area marks.\n\n__Default value:__ `false`."
+        },
+        "lineBreak": {
+          "anyOf": [
+            {
+              "description": "A delimiter, such as a newline character, upon which to break text strings into multiple lines. This property is ignored if the text is array-valued.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineHeight": {
+          "anyOf": [
+            {
+              "description": "The line height in pixels (the spacing between subsequent lines of text) for multi-line text marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "opacity": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The overall opacity (value between [0,1]).\n\n__Default value:__ `0.7` for non-aggregate plots with `point`, `tick`, `circle`, or `square` marks or layered `bar` charts and `1` otherwise.",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "order": {
+          "description": "For line and trail marks, this `order` property can be set to `null` or `false` to make the lines use the original order in the data sources.",
+          "type": [
+            "null",
+            "boolean"
+          ]
+        },
+        "orient": {
+          "$ref": "#/definitions/Orientation",
+          "description": "The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.\n- For bar, rule and tick, this determines whether the size of the bar and tick should be applied to x or y dimension.\n- For area, this property determines the orient property of the Vega output.\n- For line and trail marks, this property determines the sort order of the points in the line if `config.sortLineBy` is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored."
+        },
+        "outerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The outer radius in pixels of arc marks. `outerRadius` is an alias for `radius`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "padAngle": {
+          "anyOf": [
+            {
+              "description": "The angular padding applied to sides of the arc, in radians.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "point": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/OverlayMarkDef"
+            },
+            {
+              "const": "transparent",
+              "type": "string"
+            }
+          ],
+          "description": "A flag for overlaying points on top of line or area marks, or an object defining the properties of the overlayed points.\n\n- If this property is `\"transparent\"`, transparent points will be used (for enhancing tooltips and selections).\n\n- If this property is an empty object (`{}`) or `true`, filled points with default properties will be used.\n\n- If this property is `false`, no points would be automatically added to line or area marks.\n\n__Default value:__ `false`."
+        },
+        "radius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For arc mark, the primary (outer) radius in pixels.\n\nFor text marks, polar coordinate radial offset, in pixels, of the text from the origin determined by the `x` and `y` properties.\n\n__Default value:__ `min(plot_width, plot_height)/2`",
+          "minimum": 0
+        },
+        "radius2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The secondary (inner) radius in pixels of arc marks.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "shape": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/SymbolShape"
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "description": "Shape of the point marks. Supported values include:\n- plotting shapes: `\"circle\"`, `\"square\"`, `\"cross\"`, `\"diamond\"`, `\"triangle-up\"`, `\"triangle-down\"`, `\"triangle-right\"`, or `\"triangle-left\"`.\n- the line symbol `\"stroke\"`\n- centered directional shapes `\"arrow\"`, `\"wedge\"`, or `\"triangle\"`\n- a custom [SVG path string](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths) (For correct sizing, custom shape paths should be defined within a square bounding box with coordinates ranging from -1 to 1 along both the x and y dimensions.)\n\n__Default value:__ `\"circle\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "size": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default size for marks.\n- For `point`/`circle`/`square`, this represents the pixel area of the marks. Note that this value sets the area of the symbol; the side lengths will increase with the square root of this value.\n- For `bar`, this represents the band size of the bar, in pixels.\n- For `text`, this represents the font size, in pixels.\n\n__Default value:__\n- `30` for point, circle, square marks; width/height's `step`\n- `2` for bar marks with discrete dimensions;\n- `5` for bar marks with continuous dimensions;\n- `11` for text marks.",
+          "minimum": 0
+        },
+        "smooth": {
+          "anyOf": [
+            {
+              "description": "A boolean flag (default true) indicating if the image should be smoothed when resized. If false, individual pixels should be scaled directly rather than interpolated with smoothing. For SVG rendering, this option may not work in some browsers due to lack of standardization.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "startAngle": {
+          "anyOf": [
+            {
+              "description": "The start angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "stroke": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default stroke color. This property has higher precedence than `config.color`. Set to `null` to remove stroke.\n\n__Default value:__ (None)"
+        },
+        "strokeCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for line ending style. One of `\"butt\"`, `\"round\"`, or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating stroke, space lengths for creating dashed or dotted lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDashOffset": {
+          "anyOf": [
+            {
+              "description": "The offset (in pixels) into which to begin drawing with the stroke dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeJoin": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeJoin",
+              "description": "The stroke line join method. One of `\"miter\"`, `\"round\"` or `\"bevel\"`.\n\n__Default value:__ `\"miter\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeMiterLimit": {
+          "anyOf": [
+            {
+              "description": "The miter limit at which to bevel a line join.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOffset": {
+          "anyOf": [
+            {
+              "description": "The offset in pixels at which to draw the group stroke and fill. If unspecified, the default behavior is to dynamically offset stroked groups such that 1 pixel stroke widths align with the pixel grid.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOpacity": {
+          "anyOf": [
+            {
+              "description": "The stroke opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeWidth": {
+          "anyOf": [
+            {
+              "description": "The stroke width, in pixels.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tension": {
+          "anyOf": [
+            {
+              "description": "Depending on the interpolation type, sets the tension parameter (for line and area marks).",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "text": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text",
+              "description": "Placeholder text if the `text` channel is not specified"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "theta": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "- For arc marks, the arc length in radians if theta2 is not specified, otherwise the start arc angle. (A value of 0 indicates up or “north”, increasing values proceed clockwise.)\n\n- For text marks, polar coordinate angle in radians.",
+          "maximum": 360,
+          "minimum": 0
+        },
+        "theta2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The end angle of arc marks in radians. A value of 0 indicates up or “north”, increasing values proceed clockwise."
+        },
+        "timeUnitBandPosition": {
+          "description": "Default relative band position for a time unit. If set to `0`, the marks will be positioned at the beginning of the time unit band step. If set to `0.5`, the marks will be positioned in the middle of the time unit band step.",
+          "type": "number"
+        },
+        "timeUnitBandSize": {
+          "description": "Default relative band size for a time unit. If set to `1`, the bandwidth of the marks will be equal to the time unit band step. If set to `0.5`, bandwidth of the marks will be half of the time unit band step.",
+          "type": "number"
+        },
+        "tooltip": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/TooltipContent"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The tooltip text string to show upon mouse hover or an object defining which fields should the tooltip be derived from.\n\n- If `tooltip` is `true` or `{\"content\": \"encoding\"}`, then all fields from `encoding` will be used.\n- If `tooltip` is `{\"content\": \"data\"}`, then all fields that appear in the highlighted data point will be used.\n- If set to `null` or `false`, then no tooltip will be used.\n\nSee the [`tooltip`](https://vega.github.io/vega-lite/docs/tooltip.html) documentation for a detailed discussion about tooltip  in Vega-Lite.\n\n__Default value:__ `null`"
+        },
+        "url": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "The URL of the image file for image marks."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "width": {
+          "anyOf": [
+            {
+              "description": "Width of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "x": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X coordinates of the marks, or width of horizontal `\"bar\"` and `\"area\"` without specified `x2` or `width`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "x2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "y": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y coordinates of the marks, or height of vertical `\"bar\"` and `\"area\"` without specified `y2` or `height`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "y2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        }
+      },
+      "type": "object"
+    },
+    "ArgmaxDef": {
+      "additionalProperties": false,
+      "properties": {
+        "argmax": {
+          "$ref": "#/definitions/FieldName"
+        }
+      },
+      "required": [
+        "argmax"
+      ],
+      "type": "object"
+    },
+    "ArgminDef": {
+      "additionalProperties": false,
+      "properties": {
+        "argmin": {
+          "$ref": "#/definitions/FieldName"
+        }
+      },
+      "required": [
+        "argmin"
+      ],
+      "type": "object"
+    },
+    "AutoSizeParams": {
+      "additionalProperties": false,
+      "properties": {
+        "contains": {
+          "description": "Determines how size calculation should be performed, one of `\"content\"` or `\"padding\"`. The default setting (`\"content\"`) interprets the width and height settings as the data rectangle (plotting) dimensions, to which padding is then added. In contrast, the `\"padding\"` setting includes the padding within the view size calculations, such that the width and height settings indicate the **total** intended size of the view.\n\n__Default value__: `\"content\"`",
+          "enum": [
+            "content",
+            "padding"
+          ],
+          "type": "string"
+        },
+        "resize": {
+          "description": "A boolean flag indicating if autosize layout should be re-calculated on every view update.\n\n__Default value__: `false`",
+          "type": "boolean"
+        },
+        "type": {
+          "$ref": "#/definitions/AutosizeType",
+          "description": "The sizing format type. One of `\"pad\"`, `\"fit\"`, `\"fit-x\"`, `\"fit-y\"`,  or `\"none\"`. See the [autosize type](https://vega.github.io/vega-lite/docs/size.html#autosize) documentation for descriptions of each.\n\n__Default value__: `\"pad\"`"
+        }
+      },
+      "type": "object"
+    },
+    "AutosizeType": {
+      "enum": [
+        "pad",
+        "none",
+        "fit",
+        "fit-x",
+        "fit-y"
+      ],
+      "type": "string"
+    },
+    "Axis": {
+      "additionalProperties": false,
+      "properties": {
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG group, removing the axis from the ARIA accessibility tree.\n\n__Default value:__ `true`",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "bandPosition": {
+          "anyOf": [
+            {
+              "description": "An interpolation fraction indicating where, for `band` scales, axis ticks should be positioned. A value of `0` places ticks at the left edge of their bands. A value of `0.5` places ticks in the middle of their bands.\n\n __Default value:__ `0.5`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "description": {
+          "anyOf": [
+            {
+              "description": "A text description of this axis for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If the `aria` property is true, for SVG output the [\"aria-label\" attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute) will be set to this description. If the description is unspecified it will be automatically generated.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "domain": {
+          "description": "A boolean flag indicating if the domain (the axis baseline) should be included as part of the axis.\n\n__Default value:__ `true`",
+          "type": "boolean"
+        },
+        "domainCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for the domain line's ending style. One of `\"butt\"`, `\"round\"` or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "domainColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Color of axis domain line.\n\n__Default value:__ `\"gray\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "domainDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating [stroke, space] lengths for dashed domain lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "domainDashOffset": {
+          "anyOf": [
+            {
+              "description": "The pixel offset at which to start drawing with the domain dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "domainOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of the axis domain line.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "domainWidth": {
+          "anyOf": [
+            {
+              "description": "Stroke width of axis domain line\n\n__Default value:__ `1`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "format": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Dict"
+            }
+          ],
+          "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+        },
+        "formatType": {
+          "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+          "type": "string"
+        },
+        "grid": {
+          "description": "A boolean flag indicating if grid lines should be included as part of the axis\n\n__Default value:__ `true` for [continuous scales](https://vega.github.io/vega-lite/docs/scale.html#continuous) that are not binned; otherwise, `false`.",
+          "type": "boolean"
+        },
+        "gridCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for grid lines' ending style. One of `\"butt\"`, `\"round\"` or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gridColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Color of gridlines.\n\n__Default value:__ `\"lightGray\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisColor"
+            }
+          ]
+        },
+        "gridDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating [stroke, space] lengths for dashed grid lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumberArray"
+            }
+          ]
+        },
+        "gridDashOffset": {
+          "anyOf": [
+            {
+              "description": "The pixel offset at which to start drawing with the grid dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "gridOpacity": {
+          "anyOf": [
+            {
+              "description": "The stroke opacity of grid (value between [0,1])\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "gridWidth": {
+          "anyOf": [
+            {
+              "description": "The grid width, in pixels.\n\n__Default value:__ `1`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "labelAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align",
+              "description": "Horizontal text alignment of axis tick labels, overriding the default setting for the current axis orientation."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisLabelAlign"
+            }
+          ]
+        },
+        "labelAngle": {
+          "anyOf": [
+            {
+              "description": "The rotation angle of the axis labels.\n\n__Default value:__ `-90` for nominal and ordinal fields; `0` otherwise.",
+              "maximum": 360,
+              "minimum": -360,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelBaseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline",
+              "description": "Vertical text baseline of axis tick labels, overriding the default setting for the current axis orientation. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, or `\"line-bottom\"`. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the *lineHeight* rather than *fontSize* alone."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisLabelBaseline"
+            }
+          ]
+        },
+        "labelBound": {
+          "anyOf": [
+            {
+              "description": "Indicates if labels should be hidden if they exceed the axis range. If `false` (the default) no bounds overlap analysis is performed. If `true`, labels will be hidden if they exceed the axis range by more than 1 pixel. If this property is a number, it specifies the pixel tolerance: the maximum amount by which a label bounding box may exceed the axis range.\n\n__Default value:__ `false`.",
+              "type": [
+                "number",
+                "boolean"
+              ]
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "The color of the tick label, can be in hex color code or regular color name."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisColor"
+            }
+          ]
+        },
+        "labelExpr": {
+          "description": "[Vega expression](https://vega.github.io/vega/docs/expressions/) for customizing labels.\n\n__Note:__ The label text and value can be assessed via the `label` and `value` properties of the axis's backing `datum` object.",
+          "type": "string"
+        },
+        "labelFlush": {
+          "description": "Indicates if the first and last axis labels should be aligned flush with the scale range. Flush alignment for a horizontal axis will left-align the first label and right-align the last label. For vertical axes, bottom and top text baselines are applied instead. If this property is a number, it also indicates the number of pixels by which to offset the first and last labels; for example, a value of 2 will flush-align the first and last labels and also push them 2 pixels outward from the center of the axis. The additional adjustment can sometimes help the labels better visually group with corresponding axis ticks.\n\n__Default value:__ `true` for axis of a continuous x-scale. Otherwise, `false`.",
+          "type": [
+            "boolean",
+            "number"
+          ]
+        },
+        "labelFlushOffset": {
+          "anyOf": [
+            {
+              "description": "Indicates the number of pixels by which to offset flush-adjusted labels. For example, a value of `2` will push flush-adjusted labels 2 pixels outward from the center of the axis. Offsets can help the labels better visually group with corresponding axis ticks.\n\n__Default value:__ `0`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelFont": {
+          "anyOf": [
+            {
+              "description": "The font of the tick label.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisString"
+            }
+          ]
+        },
+        "labelFontSize": {
+          "anyOf": [
+            {
+              "description": "The font size of the label, in pixels.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "labelFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "Font style of the title."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisLabelFontStyle"
+            }
+          ]
+        },
+        "labelFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "Font weight of axis tick labels."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisLabelFontWeight"
+            }
+          ]
+        },
+        "labelLimit": {
+          "anyOf": [
+            {
+              "description": "Maximum allowed pixel width of axis tick labels.\n\n__Default value:__ `180`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelLineHeight": {
+          "anyOf": [
+            {
+              "description": "Line height in pixels for multi-line label text or label text with `\"line-top\"` or `\"line-bottom\"` baseline.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelOffset": {
+          "anyOf": [
+            {
+              "description": "Position offset in pixels to apply to labels, in addition to tickOffset.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "labelOpacity": {
+          "anyOf": [
+            {
+              "description": "The opacity of the labels.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "labelOverlap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LabelOverlap"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The strategy to use for resolving overlap of axis labels. If `false` (the default), no overlap reduction is attempted. If set to `true` or `\"parity\"`, a strategy of removing every other label is used (this works well for standard linear axes). If set to `\"greedy\"`, a linear scan of the labels is performed, removing any labels that overlaps with the last visible label (this often works better for log-scaled axes).\n\n__Default value:__ `true` for non-nominal fields with non-log scales; `\"greedy\"` for log scales; otherwise `false`."
+        },
+        "labelPadding": {
+          "anyOf": [
+            {
+              "description": "The padding in pixels between labels and ticks.\n\n__Default value:__ `2`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "labelSeparation": {
+          "anyOf": [
+            {
+              "description": "The minimum separation that must be between label bounding boxes for them to be considered non-overlapping (default `0`). This property is ignored if *labelOverlap* resolution is not enabled.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labels": {
+          "description": "A boolean flag indicating if labels should be included as part of the axis.\n\n__Default value:__ `true`.",
+          "type": "boolean"
+        },
+        "maxExtent": {
+          "anyOf": [
+            {
+              "description": "The maximum extent in pixels that axis ticks and labels should use. This determines a maximum offset value for axis titles.\n\n__Default value:__ `undefined`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "minExtent": {
+          "anyOf": [
+            {
+              "description": "The minimum extent in pixels that axis ticks and labels should use. This determines a minimum offset value for axis titles.\n\n__Default value:__ `30` for y-axis; `undefined` for x-axis.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "offset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The offset, in pixels, by which to displace the axis from the edge of the enclosing group or data rectangle.\n\n__Default value:__ derived from the [axis config](https://vega.github.io/vega-lite/docs/config.html#facet-scale-config)'s `offset` (`0` by default)"
+        },
+        "orient": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/AxisOrient"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The orientation of the axis. One of `\"top\"`, `\"bottom\"`, `\"left\"` or `\"right\"`. The orientation can be used to further specialize the axis type (e.g., a y-axis oriented towards the right edge of the chart).\n\n__Default value:__ `\"bottom\"` for x-axes and `\"left\"` for y-axes."
+        },
+        "position": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The anchor position of the axis in pixels. For x-axes with top or bottom orientation, this sets the axis group x coordinate. For y-axes with left or right orientation, this sets the axis group y coordinate.\n\n__Default value__: `0`"
+        },
+        "style": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "A string or array of strings indicating the name of custom styles to apply to the axis. A style is a named collection of axis property defined within the [style configuration](https://vega.github.io/vega-lite/docs/mark.html#style-config). If style is an array, later styles will override earlier styles.\n\n__Default value:__ (none) __Note:__ Any specified style will augment the default style. For example, an x-axis mark with `\"style\": \"foo\"` will use `config.axisX` and `config.style.foo` (the specified style `\"foo\"` has higher precedence)."
+        },
+        "tickBand": {
+          "anyOf": [
+            {
+              "description": "For band scales, indicates if ticks and grid lines should be placed at the `\"center\"` of a band (default) or at the band `\"extent\"`s to indicate intervals",
+              "enum": [
+                "center",
+                "extent"
+              ],
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tickCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for the tick lines' ending style. One of `\"butt\"`, `\"round\"` or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tickColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "The color of the axis's tick.\n\n__Default value:__ `\"gray\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisColor"
+            }
+          ]
+        },
+        "tickCount": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/TimeInterval"
+            },
+            {
+              "$ref": "#/definitions/TimeIntervalStep"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A desired number of ticks, for axes visualizing quantitative scales. The resulting number may be different so that values are \"nice\" (multiples of 2, 5, 10) and lie within the underlying scale's range.\n\nFor scales of type `\"time\"` or `\"utc\"`, the tick count can instead be a time interval specifier. Legal string values are `\"millisecond\"`, `\"second\"`, `\"minute\"`, `\"hour\"`, `\"day\"`, `\"week\"`, `\"month\"`, and `\"year\"`. Alternatively, an object-valued interval specifier of the form `{\"interval\": \"month\", \"step\": 3}` includes a desired number of interval steps. Here, ticks are generated for each quarter (Jan, Apr, Jul, Oct) boundary.\n\n__Default value__: Determine using a formula `ceil(width/40)` for x and `ceil(height/40)` for y.",
+          "minimum": 0
+        },
+        "tickDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating [stroke, space] lengths for dashed tick mark lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumberArray"
+            }
+          ]
+        },
+        "tickDashOffset": {
+          "anyOf": [
+            {
+              "description": "The pixel offset at which to start drawing with the tick mark dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "tickExtra": {
+          "description": "Boolean flag indicating if an extra axis tick should be added for the initial position of the axis. This flag is useful for styling axes for `band` scales such that ticks are placed on band boundaries rather in the middle of a band. Use in conjunction with `\"bandPosition\": 1` and an axis `\"padding\"` value of `0`.",
+          "type": "boolean"
+        },
+        "tickMinStep": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The minimum desired step between axis ticks, in terms of scale domain values. For example, a value of `1` indicates that ticks should not be less than 1 unit apart. If `tickMinStep` is specified, the `tickCount` value will be adjusted, if necessary, to enforce the minimum step value."
+        },
+        "tickOffset": {
+          "anyOf": [
+            {
+              "description": "Position offset in pixels to apply to ticks, labels, and gridlines.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tickOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of the ticks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "tickRound": {
+          "description": "Boolean flag indicating if pixel position values should be rounded to the nearest integer.\n\n__Default value:__ `true`",
+          "type": "boolean"
+        },
+        "tickSize": {
+          "anyOf": [
+            {
+              "description": "The size in pixels of axis ticks.\n\n__Default value:__ `5`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "tickWidth": {
+          "anyOf": [
+            {
+              "description": "The width, in pixels, of ticks.\n\n__Default value:__ `1`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "ticks": {
+          "description": "Boolean value that determines whether the axis should include ticks.\n\n__Default value:__ `true`",
+          "type": "boolean"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "titleAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align",
+              "description": "Horizontal text alignment of axis titles."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleAnchor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TitleAnchor",
+              "description": "Text anchor position for placing axis titles."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleAngle": {
+          "anyOf": [
+            {
+              "description": "Angle in degrees of axis titles.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleBaseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline",
+              "description": "Vertical text baseline for axis titles. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, or `\"line-bottom\"`. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the *lineHeight* rather than *fontSize* alone."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Color of the title, can be in hex color code or regular color name."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFont": {
+          "anyOf": [
+            {
+              "description": "Font of the title. (e.g., `\"Helvetica Neue\"`).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFontSize": {
+          "anyOf": [
+            {
+              "description": "Font size of the title.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "Font style of the title."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "Font weight of the title. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleLimit": {
+          "anyOf": [
+            {
+              "description": "Maximum allowed pixel width of axis titles.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleLineHeight": {
+          "anyOf": [
+            {
+              "description": "Line height in pixels for multi-line title text or title text with `\"line-top\"` or `\"line-bottom\"` baseline.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of the axis title.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titlePadding": {
+          "anyOf": [
+            {
+              "description": "The padding, in pixels, between title and axis.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleX": {
+          "anyOf": [
+            {
+              "description": "X-coordinate of the axis title relative to the axis group.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleY": {
+          "anyOf": [
+            {
+              "description": "Y-coordinate of the axis title relative to the axis group.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "translate": {
+          "anyOf": [
+            {
+              "description": "Coordinate space translation offset for axis layout. By default, axes are translated by a 0.5 pixel offset for both the x and y coordinates in order to align stroked lines with the pixel grid. However, for vector graphics output these pixel-specific adjustments may be undesirable, in which case translate can be changed (for example, to zero).\n\n__Default value:__ `0.5`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "values": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            {
+              "items": {
+                "type": "boolean"
+              },
+              "type": "array"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/DateTime"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Explicitly set the visible axis tick values."
+        },
+        "zindex": {
+          "description": "A non-negative integer indicating the z-index of the axis. If zindex is 0, axes should be drawn behind all chart elements. To put them in front, set `zindex` to `1` or more.\n\n__Default value:__ `0` (behind the marks).",
+          "minimum": 0,
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "AxisConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG group, removing the axis from the ARIA accessibility tree.\n\n__Default value:__ `true`",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "bandPosition": {
+          "anyOf": [
+            {
+              "description": "An interpolation fraction indicating where, for `band` scales, axis ticks should be positioned. A value of `0` places ticks at the left edge of their bands. A value of `0.5` places ticks in the middle of their bands.\n\n __Default value:__ `0.5`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "description": {
+          "anyOf": [
+            {
+              "description": "A text description of this axis for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If the `aria` property is true, for SVG output the [\"aria-label\" attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute) will be set to this description. If the description is unspecified it will be automatically generated.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "disable": {
+          "description": "Disable axis by default.",
+          "type": "boolean"
+        },
+        "domain": {
+          "description": "A boolean flag indicating if the domain (the axis baseline) should be included as part of the axis.\n\n__Default value:__ `true`",
+          "type": "boolean"
+        },
+        "domainCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for the domain line's ending style. One of `\"butt\"`, `\"round\"` or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "domainColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Color of axis domain line.\n\n__Default value:__ `\"gray\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "domainDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating [stroke, space] lengths for dashed domain lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "domainDashOffset": {
+          "anyOf": [
+            {
+              "description": "The pixel offset at which to start drawing with the domain dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "domainOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of the axis domain line.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "domainWidth": {
+          "anyOf": [
+            {
+              "description": "Stroke width of axis domain line\n\n__Default value:__ `1`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "format": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Dict"
+            }
+          ],
+          "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+        },
+        "formatType": {
+          "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+          "type": "string"
+        },
+        "grid": {
+          "description": "A boolean flag indicating if grid lines should be included as part of the axis\n\n__Default value:__ `true` for [continuous scales](https://vega.github.io/vega-lite/docs/scale.html#continuous) that are not binned; otherwise, `false`.",
+          "type": "boolean"
+        },
+        "gridCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for grid lines' ending style. One of `\"butt\"`, `\"round\"` or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gridColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Color of gridlines.\n\n__Default value:__ `\"lightGray\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisColor"
+            }
+          ]
+        },
+        "gridDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating [stroke, space] lengths for dashed grid lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumberArray"
+            }
+          ]
+        },
+        "gridDashOffset": {
+          "anyOf": [
+            {
+              "description": "The pixel offset at which to start drawing with the grid dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "gridOpacity": {
+          "anyOf": [
+            {
+              "description": "The stroke opacity of grid (value between [0,1])\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "gridWidth": {
+          "anyOf": [
+            {
+              "description": "The grid width, in pixels.\n\n__Default value:__ `1`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "labelAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align",
+              "description": "Horizontal text alignment of axis tick labels, overriding the default setting for the current axis orientation."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisLabelAlign"
+            }
+          ]
+        },
+        "labelAngle": {
+          "anyOf": [
+            {
+              "description": "The rotation angle of the axis labels.\n\n__Default value:__ `-90` for nominal and ordinal fields; `0` otherwise.",
+              "maximum": 360,
+              "minimum": -360,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelBaseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline",
+              "description": "Vertical text baseline of axis tick labels, overriding the default setting for the current axis orientation. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, or `\"line-bottom\"`. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the *lineHeight* rather than *fontSize* alone."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisLabelBaseline"
+            }
+          ]
+        },
+        "labelBound": {
+          "anyOf": [
+            {
+              "description": "Indicates if labels should be hidden if they exceed the axis range. If `false` (the default) no bounds overlap analysis is performed. If `true`, labels will be hidden if they exceed the axis range by more than 1 pixel. If this property is a number, it specifies the pixel tolerance: the maximum amount by which a label bounding box may exceed the axis range.\n\n__Default value:__ `false`.",
+              "type": [
+                "number",
+                "boolean"
+              ]
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "The color of the tick label, can be in hex color code or regular color name."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisColor"
+            }
+          ]
+        },
+        "labelExpr": {
+          "description": "[Vega expression](https://vega.github.io/vega/docs/expressions/) for customizing labels.\n\n__Note:__ The label text and value can be assessed via the `label` and `value` properties of the axis's backing `datum` object.",
+          "type": "string"
+        },
+        "labelFlush": {
+          "description": "Indicates if the first and last axis labels should be aligned flush with the scale range. Flush alignment for a horizontal axis will left-align the first label and right-align the last label. For vertical axes, bottom and top text baselines are applied instead. If this property is a number, it also indicates the number of pixels by which to offset the first and last labels; for example, a value of 2 will flush-align the first and last labels and also push them 2 pixels outward from the center of the axis. The additional adjustment can sometimes help the labels better visually group with corresponding axis ticks.\n\n__Default value:__ `true` for axis of a continuous x-scale. Otherwise, `false`.",
+          "type": [
+            "boolean",
+            "number"
+          ]
+        },
+        "labelFlushOffset": {
+          "anyOf": [
+            {
+              "description": "Indicates the number of pixels by which to offset flush-adjusted labels. For example, a value of `2` will push flush-adjusted labels 2 pixels outward from the center of the axis. Offsets can help the labels better visually group with corresponding axis ticks.\n\n__Default value:__ `0`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelFont": {
+          "anyOf": [
+            {
+              "description": "The font of the tick label.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisString"
+            }
+          ]
+        },
+        "labelFontSize": {
+          "anyOf": [
+            {
+              "description": "The font size of the label, in pixels.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "labelFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "Font style of the title."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisLabelFontStyle"
+            }
+          ]
+        },
+        "labelFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "Font weight of axis tick labels."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisLabelFontWeight"
+            }
+          ]
+        },
+        "labelLimit": {
+          "anyOf": [
+            {
+              "description": "Maximum allowed pixel width of axis tick labels.\n\n__Default value:__ `180`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelLineHeight": {
+          "anyOf": [
+            {
+              "description": "Line height in pixels for multi-line label text or label text with `\"line-top\"` or `\"line-bottom\"` baseline.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelOffset": {
+          "anyOf": [
+            {
+              "description": "Position offset in pixels to apply to labels, in addition to tickOffset.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "labelOpacity": {
+          "anyOf": [
+            {
+              "description": "The opacity of the labels.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "labelOverlap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LabelOverlap"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The strategy to use for resolving overlap of axis labels. If `false` (the default), no overlap reduction is attempted. If set to `true` or `\"parity\"`, a strategy of removing every other label is used (this works well for standard linear axes). If set to `\"greedy\"`, a linear scan of the labels is performed, removing any labels that overlaps with the last visible label (this often works better for log-scaled axes).\n\n__Default value:__ `true` for non-nominal fields with non-log scales; `\"greedy\"` for log scales; otherwise `false`."
+        },
+        "labelPadding": {
+          "anyOf": [
+            {
+              "description": "The padding in pixels between labels and ticks.\n\n__Default value:__ `2`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "labelSeparation": {
+          "anyOf": [
+            {
+              "description": "The minimum separation that must be between label bounding boxes for them to be considered non-overlapping (default `0`). This property is ignored if *labelOverlap* resolution is not enabled.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labels": {
+          "description": "A boolean flag indicating if labels should be included as part of the axis.\n\n__Default value:__ `true`.",
+          "type": "boolean"
+        },
+        "maxExtent": {
+          "anyOf": [
+            {
+              "description": "The maximum extent in pixels that axis ticks and labels should use. This determines a maximum offset value for axis titles.\n\n__Default value:__ `undefined`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "minExtent": {
+          "anyOf": [
+            {
+              "description": "The minimum extent in pixels that axis ticks and labels should use. This determines a minimum offset value for axis titles.\n\n__Default value:__ `30` for y-axis; `undefined` for x-axis.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "offset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The offset, in pixels, by which to displace the axis from the edge of the enclosing group or data rectangle.\n\n__Default value:__ derived from the [axis config](https://vega.github.io/vega-lite/docs/config.html#facet-scale-config)'s `offset` (`0` by default)"
+        },
+        "orient": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/AxisOrient"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The orientation of the axis. One of `\"top\"`, `\"bottom\"`, `\"left\"` or `\"right\"`. The orientation can be used to further specialize the axis type (e.g., a y-axis oriented towards the right edge of the chart).\n\n__Default value:__ `\"bottom\"` for x-axes and `\"left\"` for y-axes."
+        },
+        "position": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The anchor position of the axis in pixels. For x-axes with top or bottom orientation, this sets the axis group x coordinate. For y-axes with left or right orientation, this sets the axis group y coordinate.\n\n__Default value__: `0`"
+        },
+        "style": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "A string or array of strings indicating the name of custom styles to apply to the axis. A style is a named collection of axis property defined within the [style configuration](https://vega.github.io/vega-lite/docs/mark.html#style-config). If style is an array, later styles will override earlier styles.\n\n__Default value:__ (none) __Note:__ Any specified style will augment the default style. For example, an x-axis mark with `\"style\": \"foo\"` will use `config.axisX` and `config.style.foo` (the specified style `\"foo\"` has higher precedence)."
+        },
+        "tickBand": {
+          "anyOf": [
+            {
+              "description": "For band scales, indicates if ticks and grid lines should be placed at the `\"center\"` of a band (default) or at the band `\"extent\"`s to indicate intervals",
+              "enum": [
+                "center",
+                "extent"
+              ],
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tickCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for the tick lines' ending style. One of `\"butt\"`, `\"round\"` or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tickColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "The color of the axis's tick.\n\n__Default value:__ `\"gray\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisColor"
+            }
+          ]
+        },
+        "tickCount": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/TimeInterval"
+            },
+            {
+              "$ref": "#/definitions/TimeIntervalStep"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A desired number of ticks, for axes visualizing quantitative scales. The resulting number may be different so that values are \"nice\" (multiples of 2, 5, 10) and lie within the underlying scale's range.\n\nFor scales of type `\"time\"` or `\"utc\"`, the tick count can instead be a time interval specifier. Legal string values are `\"millisecond\"`, `\"second\"`, `\"minute\"`, `\"hour\"`, `\"day\"`, `\"week\"`, `\"month\"`, and `\"year\"`. Alternatively, an object-valued interval specifier of the form `{\"interval\": \"month\", \"step\": 3}` includes a desired number of interval steps. Here, ticks are generated for each quarter (Jan, Apr, Jul, Oct) boundary.\n\n__Default value__: Determine using a formula `ceil(width/40)` for x and `ceil(height/40)` for y.",
+          "minimum": 0
+        },
+        "tickDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating [stroke, space] lengths for dashed tick mark lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumberArray"
+            }
+          ]
+        },
+        "tickDashOffset": {
+          "anyOf": [
+            {
+              "description": "The pixel offset at which to start drawing with the tick mark dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "tickExtra": {
+          "description": "Boolean flag indicating if an extra axis tick should be added for the initial position of the axis. This flag is useful for styling axes for `band` scales such that ticks are placed on band boundaries rather in the middle of a band. Use in conjunction with `\"bandPosition\": 1` and an axis `\"padding\"` value of `0`.",
+          "type": "boolean"
+        },
+        "tickMinStep": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The minimum desired step between axis ticks, in terms of scale domain values. For example, a value of `1` indicates that ticks should not be less than 1 unit apart. If `tickMinStep` is specified, the `tickCount` value will be adjusted, if necessary, to enforce the minimum step value."
+        },
+        "tickOffset": {
+          "anyOf": [
+            {
+              "description": "Position offset in pixels to apply to ticks, labels, and gridlines.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tickOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of the ticks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "tickRound": {
+          "description": "Boolean flag indicating if pixel position values should be rounded to the nearest integer.\n\n__Default value:__ `true`",
+          "type": "boolean"
+        },
+        "tickSize": {
+          "anyOf": [
+            {
+              "description": "The size in pixels of axis ticks.\n\n__Default value:__ `5`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "tickWidth": {
+          "anyOf": [
+            {
+              "description": "The width, in pixels, of ticks.\n\n__Default value:__ `1`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalAxisNumber"
+            }
+          ]
+        },
+        "ticks": {
+          "description": "Boolean value that determines whether the axis should include ticks.\n\n__Default value:__ `true`",
+          "type": "boolean"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "titleAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align",
+              "description": "Horizontal text alignment of axis titles."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleAnchor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TitleAnchor",
+              "description": "Text anchor position for placing axis titles."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleAngle": {
+          "anyOf": [
+            {
+              "description": "Angle in degrees of axis titles.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleBaseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline",
+              "description": "Vertical text baseline for axis titles. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, or `\"line-bottom\"`. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the *lineHeight* rather than *fontSize* alone."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Color of the title, can be in hex color code or regular color name."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFont": {
+          "anyOf": [
+            {
+              "description": "Font of the title. (e.g., `\"Helvetica Neue\"`).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFontSize": {
+          "anyOf": [
+            {
+              "description": "Font size of the title.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "Font style of the title."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "Font weight of the title. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleLimit": {
+          "anyOf": [
+            {
+              "description": "Maximum allowed pixel width of axis titles.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleLineHeight": {
+          "anyOf": [
+            {
+              "description": "Line height in pixels for multi-line title text or title text with `\"line-top\"` or `\"line-bottom\"` baseline.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of the axis title.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titlePadding": {
+          "anyOf": [
+            {
+              "description": "The padding, in pixels, between title and axis.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleX": {
+          "anyOf": [
+            {
+              "description": "X-coordinate of the axis title relative to the axis group.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleY": {
+          "anyOf": [
+            {
+              "description": "Y-coordinate of the axis title relative to the axis group.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "translate": {
+          "anyOf": [
+            {
+              "description": "Coordinate space translation offset for axis layout. By default, axes are translated by a 0.5 pixel offset for both the x and y coordinates in order to align stroked lines with the pixel grid. However, for vector graphics output these pixel-specific adjustments may be undesirable, in which case translate can be changed (for example, to zero).\n\n__Default value:__ `0.5`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "values": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            {
+              "items": {
+                "type": "boolean"
+              },
+              "type": "array"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/DateTime"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Explicitly set the visible axis tick values."
+        },
+        "zindex": {
+          "description": "A non-negative integer indicating the z-index of the axis. If zindex is 0, axes should be drawn behind all chart elements. To put them in front, set `zindex` to `1` or more.\n\n__Default value:__ `0` (behind the marks).",
+          "minimum": 0,
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "AxisOrient": {
+      "enum": [
+        "top",
+        "bottom",
+        "left",
+        "right"
+      ],
+      "type": "string"
+    },
+    "AxisResolveMap": {
+      "additionalProperties": false,
+      "properties": {
+        "x": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "y": {
+          "$ref": "#/definitions/ResolveMode"
+        }
+      },
+      "type": "object"
+    },
+    "BBox": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "number"
+          },
+          "maxItems": 4,
+          "minItems": 4,
+          "type": "array"
+        },
+        {
+          "items": {
+            "type": "number"
+          },
+          "maxItems": 6,
+          "minItems": 6,
+          "type": "array"
+        }
+      ],
+      "description": "Bounding box https://tools.ietf.org/html/rfc7946#section-5"
+    },
+    "BarConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule). One of `\"left\"`, `\"right\"`, `\"center\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "angle": {
+          "anyOf": [
+            {
+              "description": "The rotation angle of the text, in degrees.",
+              "maximum": 360,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG element, removing the mark item from the ARIA accessibility tree.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRole": {
+          "anyOf": [
+            {
+              "description": "Sets the type of user interface element of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"role\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRoleDescription": {
+          "anyOf": [
+            {
+              "description": "A human-readable, author-localized description for the role of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"aria-roledescription\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aspect": {
+          "anyOf": [
+            {
+              "description": "Whether to keep aspect ratio of image marks.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "baseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For text marks, the vertical text baseline. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, `\"line-bottom\"`, or an expression reference that provides one of the valid values. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the `lineHeight` rather than `fontSize` alone.\n\nFor range marks, the vertical alignment of the marks. One of `\"top\"`, `\"middle\"`, `\"bottom\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "binSpacing": {
+          "description": "Offset between bars for binned field. The ideal value for this is either 0 (preferred by statisticians) or 1 (Vega-Lite default, D3 example style).\n\n__Default value:__ `1`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "blend": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Blend",
+              "description": "The color blend mode for drawing an item on its current background. Any valid [CSS mix-blend-mode](https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode) value can be used.\n\n__Default value: `\"source-over\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "color": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default color.\n\n__Default value:__ <span style=\"color: #4682b4;\">&#9632;</span> `\"#4682b4\"`\n\n__Note:__\n- This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).\n- The `fill` and `stroke` properties have higher precedence than `color` and will override `color`."
+        },
+        "continuousBandSize": {
+          "description": "The default size of the bars on continuous scales.\n\n__Default value:__ `5`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "cornerRadius": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles or arcs' corners.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusEnd": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "- For vertical bars, top-left and top-right corner radius.\n\n- For horizontal bars, top-right and bottom-right corner radius."
+        },
+        "cornerRadiusTopLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cursor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Cursor",
+              "description": "The mouse cursor used over the mark. Any valid [CSS cursor type](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values) can be used."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "description": {
+          "anyOf": [
+            {
+              "description": "A text description of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the [\"aria-label\" attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dir": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextDirection",
+              "description": "The direction of the text. One of `\"ltr\"` (left-to-right) or `\"rtl\"` (right-to-left). This property determines on which side is truncated in response to the limit parameter.\n\n__Default value:__ `\"ltr\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "discreteBandSize": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/RelativeBandSize"
+            }
+          ],
+          "description": "The default size of the bars with discrete dimensions. If unspecified, the default size is  `step-2`, which provides 2 pixel offset between bars.",
+          "minimum": 0
+        },
+        "dx": {
+          "anyOf": [
+            {
+              "description": "The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dy": {
+          "anyOf": [
+            {
+              "description": "The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ellipsis": {
+          "anyOf": [
+            {
+              "description": "The ellipsis string for text truncated in response to the limit parameter.\n\n__Default value:__ `\"…\"`",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "endAngle": {
+          "anyOf": [
+            {
+              "description": "The end angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fill": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default fill color. This property has higher precedence than `config.color`. Set to `null` to remove fill.\n\n__Default value:__ (None)"
+        },
+        "fillOpacity": {
+          "anyOf": [
+            {
+              "description": "The fill opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "filled": {
+          "description": "Whether the mark's color should be used as fill color instead of stroke color.\n\n__Default value:__ `false` for all `point`, `line`, and `rule` marks as well as `geoshape` marks for [`graticule`](https://vega.github.io/vega-lite/docs/data.html#graticule) data sources; otherwise, `true`.\n\n__Note:__ This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).",
+          "type": "boolean"
+        },
+        "font": {
+          "anyOf": [
+            {
+              "description": "The typeface to set the text in (e.g., `\"Helvetica Neue\"`).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontSize": {
+          "anyOf": [
+            {
+              "description": "The font size, in pixels.\n\n__Default value:__ `11`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "The font style (e.g., `\"italic\"`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "The font weight. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "height": {
+          "anyOf": [
+            {
+              "description": "Height of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "href": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "A URL to load upon mouse click. If defined, the mark acts as a hyperlink."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "innerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The inner radius in pixels of arc marks. `innerRadius` is an alias for `radius2`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "interpolate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Interpolate",
+              "description": "The line interpolation method to use for line and area marks. One of the following:\n- `\"linear\"`: piecewise linear segments, as in a polyline.\n- `\"linear-closed\"`: close the linear segments to form a polygon.\n- `\"step\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"step-before\"`: alternate between vertical and horizontal segments, as in a step function.\n- `\"step-after\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"basis\"`: a B-spline, with control point duplication on the ends.\n- `\"basis-open\"`: an open B-spline; may not intersect the start or end.\n- `\"basis-closed\"`: a closed B-spline, as in a loop.\n- `\"cardinal\"`: a Cardinal spline, with control point duplication on the ends.\n- `\"cardinal-open\"`: an open Cardinal spline; may not intersect the start or end, but will intersect other control points.\n- `\"cardinal-closed\"`: a closed Cardinal spline, as in a loop.\n- `\"bundle\"`: equivalent to basis, except the tension parameter is used to straighten the spline.\n- `\"monotone\"`: cubic interpolation that preserves monotonicity in y."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "invalid": {
+          "description": "Defines how Vega-Lite should handle marks for invalid values (`null` and `NaN`).\n- If set to `\"filter\"` (default), all data items with null values will be skipped (for line, trail, and area marks) or filtered (for other marks).\n- If `null`, all data items are included. In this case, invalid values will be interpreted as zeroes.",
+          "enum": [
+            "filter",
+            null
+          ],
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "limit": {
+          "anyOf": [
+            {
+              "description": "The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.\n\n__Default value:__ `0` -- indicating no limit",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineBreak": {
+          "anyOf": [
+            {
+              "description": "A delimiter, such as a newline character, upon which to break text strings into multiple lines. This property is ignored if the text is array-valued.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineHeight": {
+          "anyOf": [
+            {
+              "description": "The line height in pixels (the spacing between subsequent lines of text) for multi-line text marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "minBandSize": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The minimum band size for bar and rectangle marks. __Default value:__ `0.25`"
+        },
+        "opacity": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The overall opacity (value between [0,1]).\n\n__Default value:__ `0.7` for non-aggregate plots with `point`, `tick`, `circle`, or `square` marks or layered `bar` charts and `1` otherwise.",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "order": {
+          "description": "For line and trail marks, this `order` property can be set to `null` or `false` to make the lines use the original order in the data sources.",
+          "type": [
+            "null",
+            "boolean"
+          ]
+        },
+        "orient": {
+          "$ref": "#/definitions/Orientation",
+          "description": "The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.\n- For bar, rule and tick, this determines whether the size of the bar and tick should be applied to x or y dimension.\n- For area, this property determines the orient property of the Vega output.\n- For line and trail marks, this property determines the sort order of the points in the line if `config.sortLineBy` is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored."
+        },
+        "outerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The outer radius in pixels of arc marks. `outerRadius` is an alias for `radius`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "padAngle": {
+          "anyOf": [
+            {
+              "description": "The angular padding applied to sides of the arc, in radians.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "radius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For arc mark, the primary (outer) radius in pixels.\n\nFor text marks, polar coordinate radial offset, in pixels, of the text from the origin determined by the `x` and `y` properties.\n\n__Default value:__ `min(plot_width, plot_height)/2`",
+          "minimum": 0
+        },
+        "radius2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The secondary (inner) radius in pixels of arc marks.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "shape": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/SymbolShape"
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "description": "Shape of the point marks. Supported values include:\n- plotting shapes: `\"circle\"`, `\"square\"`, `\"cross\"`, `\"diamond\"`, `\"triangle-up\"`, `\"triangle-down\"`, `\"triangle-right\"`, or `\"triangle-left\"`.\n- the line symbol `\"stroke\"`\n- centered directional shapes `\"arrow\"`, `\"wedge\"`, or `\"triangle\"`\n- a custom [SVG path string](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths) (For correct sizing, custom shape paths should be defined within a square bounding box with coordinates ranging from -1 to 1 along both the x and y dimensions.)\n\n__Default value:__ `\"circle\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "size": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default size for marks.\n- For `point`/`circle`/`square`, this represents the pixel area of the marks. Note that this value sets the area of the symbol; the side lengths will increase with the square root of this value.\n- For `bar`, this represents the band size of the bar, in pixels.\n- For `text`, this represents the font size, in pixels.\n\n__Default value:__\n- `30` for point, circle, square marks; width/height's `step`\n- `2` for bar marks with discrete dimensions;\n- `5` for bar marks with continuous dimensions;\n- `11` for text marks.",
+          "minimum": 0
+        },
+        "smooth": {
+          "anyOf": [
+            {
+              "description": "A boolean flag (default true) indicating if the image should be smoothed when resized. If false, individual pixels should be scaled directly rather than interpolated with smoothing. For SVG rendering, this option may not work in some browsers due to lack of standardization.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "startAngle": {
+          "anyOf": [
+            {
+              "description": "The start angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "stroke": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default stroke color. This property has higher precedence than `config.color`. Set to `null` to remove stroke.\n\n__Default value:__ (None)"
+        },
+        "strokeCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for line ending style. One of `\"butt\"`, `\"round\"`, or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating stroke, space lengths for creating dashed or dotted lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDashOffset": {
+          "anyOf": [
+            {
+              "description": "The offset (in pixels) into which to begin drawing with the stroke dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeJoin": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeJoin",
+              "description": "The stroke line join method. One of `\"miter\"`, `\"round\"` or `\"bevel\"`.\n\n__Default value:__ `\"miter\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeMiterLimit": {
+          "anyOf": [
+            {
+              "description": "The miter limit at which to bevel a line join.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOffset": {
+          "anyOf": [
+            {
+              "description": "The offset in pixels at which to draw the group stroke and fill. If unspecified, the default behavior is to dynamically offset stroked groups such that 1 pixel stroke widths align with the pixel grid.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOpacity": {
+          "anyOf": [
+            {
+              "description": "The stroke opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeWidth": {
+          "anyOf": [
+            {
+              "description": "The stroke width, in pixels.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tension": {
+          "anyOf": [
+            {
+              "description": "Depending on the interpolation type, sets the tension parameter (for line and area marks).",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "text": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text",
+              "description": "Placeholder text if the `text` channel is not specified"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "theta": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "- For arc marks, the arc length in radians if theta2 is not specified, otherwise the start arc angle. (A value of 0 indicates up or “north”, increasing values proceed clockwise.)\n\n- For text marks, polar coordinate angle in radians.",
+          "maximum": 360,
+          "minimum": 0
+        },
+        "theta2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The end angle of arc marks in radians. A value of 0 indicates up or “north”, increasing values proceed clockwise."
+        },
+        "timeUnitBandPosition": {
+          "description": "Default relative band position for a time unit. If set to `0`, the marks will be positioned at the beginning of the time unit band step. If set to `0.5`, the marks will be positioned in the middle of the time unit band step.",
+          "type": "number"
+        },
+        "timeUnitBandSize": {
+          "description": "Default relative band size for a time unit. If set to `1`, the bandwidth of the marks will be equal to the time unit band step. If set to `0.5`, bandwidth of the marks will be half of the time unit band step.",
+          "type": "number"
+        },
+        "tooltip": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/TooltipContent"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The tooltip text string to show upon mouse hover or an object defining which fields should the tooltip be derived from.\n\n- If `tooltip` is `true` or `{\"content\": \"encoding\"}`, then all fields from `encoding` will be used.\n- If `tooltip` is `{\"content\": \"data\"}`, then all fields that appear in the highlighted data point will be used.\n- If set to `null` or `false`, then no tooltip will be used.\n\nSee the [`tooltip`](https://vega.github.io/vega-lite/docs/tooltip.html) documentation for a detailed discussion about tooltip  in Vega-Lite.\n\n__Default value:__ `null`"
+        },
+        "url": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "The URL of the image file for image marks."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "width": {
+          "anyOf": [
+            {
+              "description": "Width of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "x": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X coordinates of the marks, or width of horizontal `\"bar\"` and `\"area\"` without specified `x2` or `width`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "x2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "y": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y coordinates of the marks, or height of vertical `\"bar\"` and `\"area\"` without specified `y2` or `height`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "y2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        }
+      },
+      "type": "object"
+    },
+    "BaseTitleNoValueRefs": {
+      "additionalProperties": false,
+      "properties": {
+        "align": {
+          "$ref": "#/definitions/Align",
+          "description": "Horizontal text alignment for title text. One of `\"left\"`, `\"center\"`, or `\"right\"`."
+        },
+        "anchor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TitleAnchor",
+              "description": "The anchor position for placing the title and subtitle text. One of `\"start\"`, `\"middle\"`, or `\"end\"`. For example, with an orientation of top these anchor positions map to a left-, center-, or right-aligned title."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "angle": {
+          "anyOf": [
+            {
+              "description": "Angle in degrees of title and subtitle text.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG group, removing the title from the ARIA accessibility tree.\n\n__Default value:__ `true`",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "baseline": {
+          "$ref": "#/definitions/TextBaseline",
+          "description": "Vertical text baseline for title and subtitle text. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, or `\"line-bottom\"`. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the *lineHeight* rather than *fontSize* alone."
+        },
+        "color": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Text color for title text."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dx": {
+          "anyOf": [
+            {
+              "description": "Delta offset for title and subtitle text x-coordinate.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dy": {
+          "anyOf": [
+            {
+              "description": "Delta offset for title and subtitle text y-coordinate.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "font": {
+          "anyOf": [
+            {
+              "description": "Font name for title text.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontSize": {
+          "anyOf": [
+            {
+              "description": "Font size in pixels for title text.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "Font style for title text."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "Font weight for title text. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "frame": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TitleFrame"
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "description": "The reference frame for the anchor position, one of `\"bounds\"` (to anchor relative to the full bounding box) or `\"group\"` (to anchor relative to the group width or height)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "limit": {
+          "anyOf": [
+            {
+              "description": "The maximum allowed length in pixels of title and subtitle text.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineHeight": {
+          "anyOf": [
+            {
+              "description": "Line height in pixels for multi-line title text or title text with `\"line-top\"` or `\"line-bottom\"` baseline.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "offset": {
+          "anyOf": [
+            {
+              "description": "The orthogonal offset in pixels by which to displace the title group from its position along the edge of the chart.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "orient": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TitleOrient",
+              "description": "Default title orientation (`\"top\"`, `\"bottom\"`, `\"left\"`, or `\"right\"`)"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "subtitleColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Text color for subtitle text."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "subtitleFont": {
+          "anyOf": [
+            {
+              "description": "Font name for subtitle text.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "subtitleFontSize": {
+          "anyOf": [
+            {
+              "description": "Font size in pixels for subtitle text.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "subtitleFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "Font style for subtitle text."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "subtitleFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "Font weight for subtitle text. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "subtitleLineHeight": {
+          "anyOf": [
+            {
+              "description": "Line height in pixels for multi-line subtitle text.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "subtitlePadding": {
+          "anyOf": [
+            {
+              "description": "The padding in pixels between title and subtitle text.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "zindex": {
+          "anyOf": [
+            {
+              "description": "The integer z-index indicating the layering of the title group relative to other axis, mark, and legend groups.\n\n__Default value:__ `0`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "Baseline": {
+      "enum": [
+        "top",
+        "middle",
+        "bottom"
+      ],
+      "type": "string"
+    },
+    "BinExtent": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "number"
+          },
+          "maxItems": 2,
+          "minItems": 2,
+          "type": "array"
+        },
+        {
+          "$ref": "#/definitions/ParameterExtent"
+        }
+      ]
+    },
+    "BinParams": {
+      "additionalProperties": false,
+      "description": "Binning properties or boolean flag for determining whether to bin data or not.",
+      "properties": {
+        "anchor": {
+          "description": "A value in the binned domain at which to anchor the bins, shifting the bin boundaries if necessary to ensure that a boundary aligns with the anchor value.\n\n__Default value:__ the minimum bin extent value",
+          "type": "number"
+        },
+        "base": {
+          "description": "The number base to use for automatic bin determination (default is base 10).\n\n__Default value:__ `10`",
+          "type": "number"
+        },
+        "binned": {
+          "description": "When set to `true`, Vega-Lite treats the input data as already binned.",
+          "type": "boolean"
+        },
+        "divide": {
+          "description": "Scale factors indicating allowable subdivisions. The default value is [5, 2], which indicates that for base 10 numbers (the default base), the method may consider dividing bin sizes by 5 and/or 2. For example, for an initial step size of 10, the method can check if bin sizes of 2 (= 10/5), 5 (= 10/2), or 1 (= 10/(5*2)) might also satisfy the given constraints.\n\n__Default value:__ `[5, 2]`",
+          "items": {
+            "type": "number"
+          },
+          "maxItems": 2,
+          "minItems": 1,
+          "type": "array"
+        },
+        "extent": {
+          "$ref": "#/definitions/BinExtent",
+          "description": "A two-element (`[min, max]`) array indicating the range of desired bin values."
+        },
+        "maxbins": {
+          "description": "Maximum number of bins.\n\n__Default value:__ `6` for `row`, `column` and `shape` channels; `10` for other channels",
+          "minimum": 2,
+          "type": "number"
+        },
+        "minstep": {
+          "description": "A minimum allowable step size (particularly useful for integer values).",
+          "type": "number"
+        },
+        "nice": {
+          "description": "If true, attempts to make the bin boundaries use human-friendly boundaries, such as multiples of ten.\n\n__Default value:__ `true`",
+          "type": "boolean"
+        },
+        "step": {
+          "description": "An exact step size to use between bins.\n\n__Note:__ If provided, options such as maxbins will be ignored.",
+          "type": "number"
+        },
+        "steps": {
+          "description": "An array of allowable step sizes to choose from.",
+          "items": {
+            "type": "number"
+          },
+          "minItems": 1,
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "BinTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FieldName"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/FieldName"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "The output fields at which to write the start and end bin values. This can be either a string or an array of strings with two elements denoting the name for the fields for bin start and bin end respectively. If a single string (e.g., `\"val\"`) is provided, the end field will be `\"val_end\"`."
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "const": true,
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            }
+          ],
+          "description": "An object indicating bin properties, or simply `true` for using default bin parameters."
+        },
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field to bin."
+        }
+      },
+      "required": [
+        "bin",
+        "field",
+        "as"
+      ],
+      "type": "object"
+    },
+    "BindCheckbox": {
+      "additionalProperties": false,
+      "properties": {
+        "debounce": {
+          "description": "If defined, delays event handling until the specified milliseconds have elapsed since the last event was fired.",
+          "type": "number"
+        },
+        "element": {
+          "$ref": "#/definitions/Element",
+          "description": "An optional CSS selector string indicating the parent element to which the input element should be added. By default, all input elements are added within the parent container of the Vega view."
+        },
+        "input": {
+          "const": "checkbox",
+          "type": "string"
+        },
+        "name": {
+          "description": "By default, the signal name is used to label input elements. This `name` property can be used instead to specify a custom label for the bound signal.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "input"
+      ],
+      "type": "object"
+    },
+    "BindDirect": {
+      "additionalProperties": false,
+      "properties": {
+        "debounce": {
+          "description": "If defined, delays event handling until the specified milliseconds have elapsed since the last event was fired.",
+          "type": "number"
+        },
+        "element": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Element"
+            },
+            {
+              "additionalProperties": false,
+              "type": "object"
+            }
+          ],
+          "description": "An input element that exposes a _value_ property and supports the [EventTarget](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget) interface, or a CSS selector string to such an element. When the element updates and dispatches an event, the _value_ property will be used as the new, bound signal value. When the signal updates independent of the element, the _value_ property will be set to the signal value and a new event will be dispatched on the element."
+        },
+        "event": {
+          "description": "The event (default `\"input\"`) to listen for to track changes on the external element.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "element"
+      ],
+      "type": "object"
+    },
+    "BindInput": {
+      "additionalProperties": false,
+      "properties": {
+        "autocomplete": {
+          "description": "A hint for form autofill. See the [HTML autocomplete attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete) for additional information.",
+          "type": "string"
+        },
+        "debounce": {
+          "description": "If defined, delays event handling until the specified milliseconds have elapsed since the last event was fired.",
+          "type": "number"
+        },
+        "element": {
+          "$ref": "#/definitions/Element",
+          "description": "An optional CSS selector string indicating the parent element to which the input element should be added. By default, all input elements are added within the parent container of the Vega view."
+        },
+        "input": {
+          "description": "The type of input element to use. The valid values are `\"checkbox\"`, `\"radio\"`, `\"range\"`, `\"select\"`, and any other legal [HTML form input type](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input).",
+          "type": "string"
+        },
+        "name": {
+          "description": "By default, the signal name is used to label input elements. This `name` property can be used instead to specify a custom label for the bound signal.",
+          "type": "string"
+        },
+        "placeholder": {
+          "description": "Text that appears in the form control when it has no value set.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "BindRadioSelect": {
+      "additionalProperties": false,
+      "properties": {
+        "debounce": {
+          "description": "If defined, delays event handling until the specified milliseconds have elapsed since the last event was fired.",
+          "type": "number"
+        },
+        "element": {
+          "$ref": "#/definitions/Element",
+          "description": "An optional CSS selector string indicating the parent element to which the input element should be added. By default, all input elements are added within the parent container of the Vega view."
+        },
+        "input": {
+          "enum": [
+            "radio",
+            "select"
+          ],
+          "type": "string"
+        },
+        "labels": {
+          "description": "An array of label strings to represent the `options` values. If unspecified, the `options` value will be coerced to a string and used as the label.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "name": {
+          "description": "By default, the signal name is used to label input elements. This `name` property can be used instead to specify a custom label for the bound signal.",
+          "type": "string"
+        },
+        "options": {
+          "description": "An array of options to select from.",
+          "items": {},
+          "type": "array"
+        }
+      },
+      "required": [
+        "input",
+        "options"
+      ],
+      "type": "object"
+    },
+    "BindRange": {
+      "additionalProperties": false,
+      "properties": {
+        "debounce": {
+          "description": "If defined, delays event handling until the specified milliseconds have elapsed since the last event was fired.",
+          "type": "number"
+        },
+        "element": {
+          "$ref": "#/definitions/Element",
+          "description": "An optional CSS selector string indicating the parent element to which the input element should be added. By default, all input elements are added within the parent container of the Vega view."
+        },
+        "input": {
+          "const": "range",
+          "type": "string"
+        },
+        "max": {
+          "description": "Sets the maximum slider value. Defaults to the larger of the signal value and `100`.",
+          "type": "number"
+        },
+        "min": {
+          "description": "Sets the minimum slider value. Defaults to the smaller of the signal value and `0`.",
+          "type": "number"
+        },
+        "name": {
+          "description": "By default, the signal name is used to label input elements. This `name` property can be used instead to specify a custom label for the bound signal.",
+          "type": "string"
+        },
+        "step": {
+          "description": "Sets the minimum slider increment. If undefined, the step size will be automatically determined based on the `min` and `max` values.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "input"
+      ],
+      "type": "object"
+    },
+    "Binding": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/BindCheckbox"
+        },
+        {
+          "$ref": "#/definitions/BindRadioSelect"
+        },
+        {
+          "$ref": "#/definitions/BindRange"
+        },
+        {
+          "$ref": "#/definitions/BindInput"
+        },
+        {
+          "$ref": "#/definitions/BindDirect"
+        }
+      ]
+    },
+    "BinnedTimeUnit": {
+      "anyOf": [
+        {
+          "enum": [
+            "binnedyear",
+            "binnedyearquarter",
+            "binnedyearquartermonth",
+            "binnedyearmonth",
+            "binnedyearmonthdate",
+            "binnedyearmonthdatehours",
+            "binnedyearmonthdatehoursminutes",
+            "binnedyearmonthdatehoursminutesseconds",
+            "binnedyearweek",
+            "binnedyearweekday",
+            "binnedyearweekdayhours",
+            "binnedyearweekdayhoursminutes",
+            "binnedyearweekdayhoursminutesseconds",
+            "binnedyeardayofyear"
+          ],
+          "type": "string"
+        },
+        {
+          "enum": [
+            "binnedutcyear",
+            "binnedutcyearquarter",
+            "binnedutcyearquartermonth",
+            "binnedutcyearmonth",
+            "binnedutcyearmonthdate",
+            "binnedutcyearmonthdatehours",
+            "binnedutcyearmonthdatehoursminutes",
+            "binnedutcyearmonthdatehoursminutesseconds",
+            "binnedutcyearweek",
+            "binnedutcyearweekday",
+            "binnedutcyearweekdayhours",
+            "binnedutcyearweekdayhoursminutes",
+            "binnedutcyearweekdayhoursminutesseconds",
+            "binnedutcyeardayofyear"
+          ],
+          "type": "string"
+        }
+      ]
+    },
+    "Blend": {
+      "enum": [
+        null,
+        "multiply",
+        "screen",
+        "overlay",
+        "darken",
+        "lighten",
+        "color-dodge",
+        "color-burn",
+        "hard-light",
+        "soft-light",
+        "difference",
+        "exclusion",
+        "hue",
+        "saturation",
+        "color",
+        "luminosity"
+      ],
+      "type": [
+        "null",
+        "string"
+      ]
+    },
+    "BoxPlot": {
+      "const": "boxplot",
+      "type": "string"
+    },
+    "BoxPlotConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "box": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "extent": {
+          "anyOf": [
+            {
+              "const": "min-max",
+              "type": "string"
+            },
+            {
+              "type": "number"
+            }
+          ],
+          "description": "The extent of the whiskers. Available options include:\n- `\"min-max\"`: min and max are the lower and upper whiskers respectively.\n- A number representing multiple of the interquartile range. This number will be multiplied by the IQR to determine whisker boundary, which spans from the smallest data to the largest data within the range _[Q1 - k * IQR, Q3 + k * IQR]_ where _Q1_ and _Q3_ are the first and third quartiles while _IQR_ is the interquartile range (_Q3-Q1_).\n\n__Default value:__ `1.5`."
+        },
+        "median": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "outliers": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "rule": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "size": {
+          "description": "Size of the box and median tick of a box plot",
+          "type": "number"
+        },
+        "ticks": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "BoxPlotDef": {
+      "additionalProperties": false,
+      "properties": {
+        "box": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "clip": {
+          "description": "Whether a composite mark be clipped to the enclosing group’s width and height.",
+          "type": "boolean"
+        },
+        "color": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default color.\n\n__Default value:__ <span style=\"color: #4682b4;\">&#9632;</span> `\"#4682b4\"`\n\n__Note:__\n- This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).\n- The `fill` and `stroke` properties have higher precedence than `color` and will override `color`."
+        },
+        "extent": {
+          "anyOf": [
+            {
+              "const": "min-max",
+              "type": "string"
+            },
+            {
+              "type": "number"
+            }
+          ],
+          "description": "The extent of the whiskers. Available options include:\n- `\"min-max\"`: min and max are the lower and upper whiskers respectively.\n- A number representing multiple of the interquartile range. This number will be multiplied by the IQR to determine whisker boundary, which spans from the smallest data to the largest data within the range _[Q1 - k * IQR, Q3 + k * IQR]_ where _Q1_ and _Q3_ are the first and third quartiles while _IQR_ is the interquartile range (_Q3-Q1_).\n\n__Default value:__ `1.5`."
+        },
+        "invalid": {
+          "description": "Defines how Vega-Lite should handle marks for invalid values (`null` and `NaN`).\n- If set to `\"filter\"` (default), all data items with null values will be skipped (for line, trail, and area marks) or filtered (for other marks).\n- If `null`, all data items are included. In this case, invalid values will be interpreted as zeroes.",
+          "enum": [
+            "filter",
+            null
+          ],
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "median": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "opacity": {
+          "description": "The opacity (value between [0,1]) of the mark.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "orient": {
+          "$ref": "#/definitions/Orientation",
+          "description": "Orientation of the box plot. This is normally automatically determined based on types of fields on x and y channels. However, an explicit `orient` be specified when the orientation is ambiguous.\n\n__Default value:__ `\"vertical\"`."
+        },
+        "outliers": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "rule": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "size": {
+          "description": "Size of the box and median tick of a box plot",
+          "type": "number"
+        },
+        "ticks": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "type": {
+          "$ref": "#/definitions/BoxPlot",
+          "description": "The mark type. This could a primitive mark type (one of `\"bar\"`, `\"circle\"`, `\"square\"`, `\"tick\"`, `\"line\"`, `\"area\"`, `\"point\"`, `\"geoshape\"`, `\"rule\"`, and `\"text\"`) or a composite mark type (`\"boxplot\"`, `\"errorband\"`, `\"errorbar\"`)."
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "type": "object"
+    },
+    "BrushConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "cursor": {
+          "$ref": "#/definitions/Cursor",
+          "description": "The mouse cursor used over the interval mark. Any valid [CSS cursor type](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values) can be used."
+        },
+        "fill": {
+          "$ref": "#/definitions/Color",
+          "description": "The fill color of the interval mark.\n\n__Default value:__ `\"#333333\"`"
+        },
+        "fillOpacity": {
+          "description": "The fill opacity of the interval mark (a value between `0` and `1`).\n\n__Default value:__ `0.125`",
+          "type": "number"
+        },
+        "stroke": {
+          "$ref": "#/definitions/Color",
+          "description": "The stroke color of the interval mark.\n\n__Default value:__ `\"#ffffff\"`"
+        },
+        "strokeDash": {
+          "description": "An array of alternating stroke and space lengths, for creating dashed or dotted lines.",
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        },
+        "strokeDashOffset": {
+          "description": "The offset (in pixels) with which to begin drawing the stroke dash array.",
+          "type": "number"
+        },
+        "strokeOpacity": {
+          "description": "The stroke opacity of the interval mark (a value between `0` and `1`).",
+          "type": "number"
+        },
+        "strokeWidth": {
+          "description": "The stroke width of the interval mark.",
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "CalculateTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The field for storing the computed formula value."
+        },
+        "calculate": {
+          "description": "A [expression](https://vega.github.io/vega-lite/docs/types.html#expression) string. Use the variable `datum` to refer to the current data object.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "calculate",
+        "as"
+      ],
+      "type": "object"
+    },
+    "Categorical": {
+      "enum": [
+        "accent",
+        "category10",
+        "category20",
+        "category20b",
+        "category20c",
+        "dark2",
+        "paired",
+        "pastel1",
+        "pastel2",
+        "set1",
+        "set2",
+        "set3",
+        "tableau10",
+        "tableau20"
+      ],
+      "type": "string"
+    },
+    "Color": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ColorName"
+        },
+        {
+          "$ref": "#/definitions/HexColor"
+        },
+        {
+          "type": "string"
+        }
+      ]
+    },
+    "ColorDef": {
+      "$ref": "#/definitions/MarkPropDef<(Gradient|string|null)>"
+    },
+    "ColorName": {
+      "enum": [
+        "black",
+        "silver",
+        "gray",
+        "white",
+        "maroon",
+        "red",
+        "purple",
+        "fuchsia",
+        "green",
+        "lime",
+        "olive",
+        "yellow",
+        "navy",
+        "blue",
+        "teal",
+        "aqua",
+        "orange",
+        "aliceblue",
+        "antiquewhite",
+        "aquamarine",
+        "azure",
+        "beige",
+        "bisque",
+        "blanchedalmond",
+        "blueviolet",
+        "brown",
+        "burlywood",
+        "cadetblue",
+        "chartreuse",
+        "chocolate",
+        "coral",
+        "cornflowerblue",
+        "cornsilk",
+        "crimson",
+        "cyan",
+        "darkblue",
+        "darkcyan",
+        "darkgoldenrod",
+        "darkgray",
+        "darkgreen",
+        "darkgrey",
+        "darkkhaki",
+        "darkmagenta",
+        "darkolivegreen",
+        "darkorange",
+        "darkorchid",
+        "darkred",
+        "darksalmon",
+        "darkseagreen",
+        "darkslateblue",
+        "darkslategray",
+        "darkslategrey",
+        "darkturquoise",
+        "darkviolet",
+        "deeppink",
+        "deepskyblue",
+        "dimgray",
+        "dimgrey",
+        "dodgerblue",
+        "firebrick",
+        "floralwhite",
+        "forestgreen",
+        "gainsboro",
+        "ghostwhite",
+        "gold",
+        "goldenrod",
+        "greenyellow",
+        "grey",
+        "honeydew",
+        "hotpink",
+        "indianred",
+        "indigo",
+        "ivory",
+        "khaki",
+        "lavender",
+        "lavenderblush",
+        "lawngreen",
+        "lemonchiffon",
+        "lightblue",
+        "lightcoral",
+        "lightcyan",
+        "lightgoldenrodyellow",
+        "lightgray",
+        "lightgreen",
+        "lightgrey",
+        "lightpink",
+        "lightsalmon",
+        "lightseagreen",
+        "lightskyblue",
+        "lightslategray",
+        "lightslategrey",
+        "lightsteelblue",
+        "lightyellow",
+        "limegreen",
+        "linen",
+        "magenta",
+        "mediumaquamarine",
+        "mediumblue",
+        "mediumorchid",
+        "mediumpurple",
+        "mediumseagreen",
+        "mediumslateblue",
+        "mediumspringgreen",
+        "mediumturquoise",
+        "mediumvioletred",
+        "midnightblue",
+        "mintcream",
+        "mistyrose",
+        "moccasin",
+        "navajowhite",
+        "oldlace",
+        "olivedrab",
+        "orangered",
+        "orchid",
+        "palegoldenrod",
+        "palegreen",
+        "paleturquoise",
+        "palevioletred",
+        "papayawhip",
+        "peachpuff",
+        "peru",
+        "pink",
+        "plum",
+        "powderblue",
+        "rosybrown",
+        "royalblue",
+        "saddlebrown",
+        "salmon",
+        "sandybrown",
+        "seagreen",
+        "seashell",
+        "sienna",
+        "skyblue",
+        "slateblue",
+        "slategray",
+        "slategrey",
+        "snow",
+        "springgreen",
+        "steelblue",
+        "tan",
+        "thistle",
+        "tomato",
+        "turquoise",
+        "violet",
+        "wheat",
+        "whitesmoke",
+        "yellowgreen",
+        "rebeccapurple"
+      ],
+      "type": "string"
+    },
+    "ColorScheme": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/Categorical"
+        },
+        {
+          "$ref": "#/definitions/SequentialSingleHue"
+        },
+        {
+          "$ref": "#/definitions/SequentialMultiHue"
+        },
+        {
+          "$ref": "#/definitions/Diverging"
+        },
+        {
+          "$ref": "#/definitions/Cyclical"
+        }
+      ]
+    },
+    "Encoding": {
+      "additionalProperties": false,
+      "properties": {
+        "angle": {
+          "$ref": "#/definitions/NumericMarkPropDef",
+          "description": "Rotation angle of point and text marks."
+        },
+        "color": {
+          "$ref": "#/definitions/ColorDef",
+          "description": "Color of the marks – either fill or stroke color based on  the `filled` property of mark definition. By default, `color` represents fill color for `\"area\"`, `\"bar\"`, `\"tick\"`, `\"text\"`, `\"trail\"`, `\"circle\"`, and `\"square\"` / stroke color for `\"line\"` and `\"point\"`.\n\n__Default value:__ If undefined, the default color depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `color` property.\n\n_Note:_ 1) For fine-grained control over both fill and stroke colors of the marks, please use the `fill` and `stroke` channels. The `fill` or `stroke` encodings have higher precedence than `color`, thus may override the `color` encoding if conflicting encodings are specified. 2) See the scale documentation for more information about customizing [color scheme](https://vega.github.io/vega-lite/docs/scale.html#scheme)."
+        },
+        "description": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StringFieldDefWithCondition"
+            },
+            {
+              "$ref": "#/definitions/StringValueDefWithCondition"
+            }
+          ],
+          "description": "A text description of this mark for ARIA accessibility (SVG output only). For SVG output the `\"aria-label\"` attribute will be set to this description."
+        },
+        "detail": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FieldDefWithoutScale"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/FieldDefWithoutScale"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "Additional levels of detail for grouping data in aggregate views and in line, trail, and area marks without mapping data to a specific visual channel."
+        },
+        "fill": {
+          "$ref": "#/definitions/ColorDef",
+          "description": "Fill color of the marks. __Default value:__ If undefined, the default color depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `color` property.\n\n_Note:_ The `fill` encoding has higher precedence than `color`, thus may override the `color` encoding if conflicting encodings are specified."
+        },
+        "fillOpacity": {
+          "$ref": "#/definitions/NumericMarkPropDef",
+          "description": "Fill opacity of the marks.\n\n__Default value:__ If undefined, the default opacity depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `fillOpacity` property."
+        },
+        "href": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StringFieldDefWithCondition"
+            },
+            {
+              "$ref": "#/definitions/StringValueDefWithCondition"
+            }
+          ],
+          "description": "A URL to load upon mouse click."
+        },
+        "key": {
+          "$ref": "#/definitions/FieldDefWithoutScale",
+          "description": "A data field to use as a unique key for data binding. When a visualization’s data is updated, the key value will be used to match data elements to existing mark instances. Use a key channel to enable object constancy for transitions over dynamic data."
+        },
+        "latitude": {
+          "$ref": "#/definitions/LatLongDef",
+          "description": "Latitude position of geographically projected marks."
+        },
+        "latitude2": {
+          "$ref": "#/definitions/Position2Def",
+          "description": "Latitude-2 position for geographically projected ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`."
+        },
+        "longitude": {
+          "$ref": "#/definitions/LatLongDef",
+          "description": "Longitude position of geographically projected marks."
+        },
+        "longitude2": {
+          "$ref": "#/definitions/Position2Def",
+          "description": "Longitude-2 position for geographically projected ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`."
+        },
+        "opacity": {
+          "$ref": "#/definitions/NumericMarkPropDef",
+          "description": "Opacity of the marks.\n\n__Default value:__ If undefined, the default opacity depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `opacity` property."
+        },
+        "order": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/OrderFieldDef"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/OrderFieldDef"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/OrderValueDef"
+            },
+            {
+              "$ref": "#/definitions/OrderOnlyDef"
+            }
+          ],
+          "description": "Order of the marks.\n- For stacked marks, this `order` channel encodes [stack order](https://vega.github.io/vega-lite/docs/stack.html#order).\n- For line and trail marks, this `order` channel encodes order of data points in the lines. This can be useful for creating [a connected scatterplot](https://vega.github.io/vega-lite/examples/connected_scatterplot.html). Setting `order` to `{\"value\": null}` makes the line marks use the original order in the data sources.\n- Otherwise, this `order` channel encodes layer order of the marks.\n\n__Note__: In aggregate plots, `order` field should be `aggregate`d to avoid creating additional aggregation grouping."
+        },
+        "radius": {
+          "$ref": "#/definitions/PolarDef",
+          "description": "The outer radius in pixels of arc marks."
+        },
+        "radius2": {
+          "$ref": "#/definitions/Position2Def",
+          "description": "The inner radius in pixels of arc marks."
+        },
+        "shape": {
+          "$ref": "#/definitions/ShapeDef",
+          "description": "Shape of the mark.\n\n1. For `point` marks the supported values include:   - plotting shapes: `\"circle\"`, `\"square\"`, `\"cross\"`, `\"diamond\"`, `\"triangle-up\"`, `\"triangle-down\"`, `\"triangle-right\"`, or `\"triangle-left\"`.   - the line symbol `\"stroke\"`   - centered directional shapes `\"arrow\"`, `\"wedge\"`, or `\"triangle\"`   - a custom [SVG path string](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths) (For correct sizing, custom shape paths should be defined within a square bounding box with coordinates ranging from -1 to 1 along both the x and y dimensions.)\n\n2. For `geoshape` marks it should be a field definition of the geojson data\n\n__Default value:__ If undefined, the default shape depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#point-config)'s `shape` property. (`\"circle\"` if unset.)"
+        },
+        "size": {
+          "$ref": "#/definitions/NumericMarkPropDef",
+          "description": "Size of the mark.\n- For `\"point\"`, `\"square\"` and `\"circle\"`, – the symbol size, or pixel area of the mark.\n- For `\"bar\"` and `\"tick\"` – the bar and tick's size.\n- For `\"text\"` – the text's font size.\n- Size is unsupported for `\"line\"`, `\"area\"`, and `\"rect\"`. (Use `\"trail\"` instead of line with varying size)"
+        },
+        "stroke": {
+          "$ref": "#/definitions/ColorDef",
+          "description": "Stroke color of the marks. __Default value:__ If undefined, the default color depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `color` property.\n\n_Note:_ The `stroke` encoding has higher precedence than `color`, thus may override the `color` encoding if conflicting encodings are specified."
+        },
+        "strokeDash": {
+          "$ref": "#/definitions/NumericArrayMarkPropDef",
+          "description": "Stroke dash of the marks.\n\n__Default value:__ `[1,0]` (No dash)."
+        },
+        "strokeOpacity": {
+          "$ref": "#/definitions/NumericMarkPropDef",
+          "description": "Stroke opacity of the marks.\n\n__Default value:__ If undefined, the default opacity depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `strokeOpacity` property."
+        },
+        "strokeWidth": {
+          "$ref": "#/definitions/NumericMarkPropDef",
+          "description": "Stroke width of the marks.\n\n__Default value:__ If undefined, the default stroke width depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `strokeWidth` property."
+        },
+        "text": {
+          "$ref": "#/definitions/TextDef",
+          "description": "Text of the `text` mark."
+        },
+        "theta": {
+          "$ref": "#/definitions/PolarDef",
+          "description": "- For arc marks, the arc length in radians if theta2 is not specified, otherwise the start arc angle. (A value of 0 indicates up or “north”, increasing values proceed clockwise.)\n\n- For text marks, polar coordinate angle in radians."
+        },
+        "theta2": {
+          "$ref": "#/definitions/Position2Def",
+          "description": "The end angle of arc marks in radians. A value of 0 indicates up or “north”, increasing values proceed clockwise."
+        },
+        "tooltip": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StringFieldDefWithCondition"
+            },
+            {
+              "$ref": "#/definitions/StringValueDefWithCondition"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/StringFieldDef"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The tooltip text to show upon mouse hover. Specifying `tooltip` encoding overrides [the `tooltip` property in the mark definition](https://vega.github.io/vega-lite/docs/mark.html#mark-def).\n\nSee the [`tooltip`](https://vega.github.io/vega-lite/docs/tooltip.html) documentation for a detailed discussion about tooltip in Vega-Lite."
+        },
+        "url": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StringFieldDefWithCondition"
+            },
+            {
+              "$ref": "#/definitions/StringValueDefWithCondition"
+            }
+          ],
+          "description": "The URL of an image mark."
+        },
+        "x": {
+          "$ref": "#/definitions/PositionDef",
+          "description": "X coordinates of the marks, or width of horizontal `\"bar\"` and `\"area\"` without specified `x2` or `width`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "x2": {
+          "$ref": "#/definitions/Position2Def",
+          "description": "X2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "xError": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SecondaryFieldDef"
+            },
+            {
+              "$ref": "#/definitions/ValueDef<number>"
+            }
+          ],
+          "description": "Error value of x coordinates for error specified `\"errorbar\"` and `\"errorband\"`."
+        },
+        "xError2": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SecondaryFieldDef"
+            },
+            {
+              "$ref": "#/definitions/ValueDef<number>"
+            }
+          ],
+          "description": "Secondary error value of x coordinates for error specified `\"errorbar\"` and `\"errorband\"`."
+        },
+        "xOffset": {
+          "$ref": "#/definitions/OffsetDef",
+          "description": "Offset of x-position of the marks"
+        },
+        "y": {
+          "$ref": "#/definitions/PositionDef",
+          "description": "Y coordinates of the marks, or height of vertical `\"bar\"` and `\"area\"` without specified `y2` or `height`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "y2": {
+          "$ref": "#/definitions/Position2Def",
+          "description": "Y2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "yError": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SecondaryFieldDef"
+            },
+            {
+              "$ref": "#/definitions/ValueDef<number>"
+            }
+          ],
+          "description": "Error value of y coordinates for error specified `\"errorbar\"` and `\"errorband\"`."
+        },
+        "yError2": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SecondaryFieldDef"
+            },
+            {
+              "$ref": "#/definitions/ValueDef<number>"
+            }
+          ],
+          "description": "Secondary error value of y coordinates for error specified `\"errorbar\"` and `\"errorband\"`."
+        },
+        "yOffset": {
+          "$ref": "#/definitions/OffsetDef",
+          "description": "Offset of y-position of the marks"
+        }
+      },
+      "type": "object"
+    },
+    "CompositeMark": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/BoxPlot"
+        },
+        {
+          "$ref": "#/definitions/ErrorBar"
+        },
+        {
+          "$ref": "#/definitions/ErrorBand"
+        }
+      ]
+    },
+    "CompositeMarkDef": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/BoxPlotDef"
+        },
+        {
+          "$ref": "#/definitions/ErrorBarDef"
+        },
+        {
+          "$ref": "#/definitions/ErrorBandDef"
+        }
+      ]
+    },
+    "CompositionConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "columns": {
+          "description": "The number of columns to include in the view composition layout.\n\n__Default value__: `undefined` -- An infinite number of columns (a single row) will be assumed. This is equivalent to `hconcat` (for `concat`) and to using the `column` channel (for `facet` and `repeat`).\n\n__Note__:\n\n1) This property is only for:\n- the general (wrappable) `concat` operator (not `hconcat`/`vconcat`)\n- the `facet` and `repeat` operator with one field/repetition definition (without row/column nesting)\n\n2) Setting the `columns` to `1` is equivalent to `vconcat` (for `concat`) and to using the `row` channel (for `facet` and `repeat`).",
+          "type": "number"
+        },
+        "spacing": {
+          "description": "The default spacing in pixels between composed sub-views.\n\n__Default value__: `20`",
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "ConditionalMarkPropFieldOrDatumDef": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ConditionalPredicate<MarkPropFieldOrDatumDef>"
+        },
+        {
+          "$ref": "#/definitions/ConditionalParameter<MarkPropFieldOrDatumDef>"
+        }
+      ]
+    },
+    "ConditionalMarkPropFieldOrDatumDef<TypeForShape>": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ConditionalPredicate<MarkPropFieldOrDatumDef<TypeForShape>>"
+        },
+        {
+          "$ref": "#/definitions/ConditionalParameter<MarkPropFieldOrDatumDef<TypeForShape>>"
+        }
+      ]
+    },
+    "ConditionalStringFieldDef": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ConditionalPredicate<StringFieldDef>"
+        },
+        {
+          "$ref": "#/definitions/ConditionalParameter<StringFieldDef>"
+        }
+      ]
+    },
+    "ConditionalValueDef<(Gradient|string|null|ExprRef)>": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ConditionalPredicate<ValueDef<(Gradient|string|null|ExprRef)>>"
+        },
+        {
+          "$ref": "#/definitions/ConditionalParameter<ValueDef<(Gradient|string|null|ExprRef)>>"
+        }
+      ]
+    },
+    "ConditionalValueDef<(Text|ExprRef)>": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ConditionalPredicate<ValueDef<(Text|ExprRef)>>"
+        },
+        {
+          "$ref": "#/definitions/ConditionalParameter<ValueDef<(Text|ExprRef)>>"
+        }
+      ]
+    },
+    "ConditionalValueDef<(number[]|ExprRef)>": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ConditionalPredicate<ValueDef<(number[]|ExprRef)>>"
+        },
+        {
+          "$ref": "#/definitions/ConditionalParameter<ValueDef<(number[]|ExprRef)>>"
+        }
+      ]
+    },
+    "ConditionalValueDef<(number|ExprRef)>": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ConditionalPredicate<ValueDef<(number|ExprRef)>>"
+        },
+        {
+          "$ref": "#/definitions/ConditionalParameter<ValueDef<(number|ExprRef)>>"
+        }
+      ]
+    },
+    "ConditionalValueDef<(string|ExprRef)>": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ConditionalPredicate<ValueDef<(string|ExprRef)>>"
+        },
+        {
+          "$ref": "#/definitions/ConditionalParameter<ValueDef<(string|ExprRef)>>"
+        }
+      ]
+    },
+    "ConditionalValueDef<(string|null|ExprRef)>": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ConditionalPredicate<ValueDef<(string|null|ExprRef)>>"
+        },
+        {
+          "$ref": "#/definitions/ConditionalParameter<ValueDef<(string|null|ExprRef)>>"
+        }
+      ]
+    },
+    "ConditionalValueDef<number>": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ConditionalPredicate<ValueDef<number>>"
+        },
+        {
+          "$ref": "#/definitions/ConditionalParameter<ValueDef<number>>"
+        }
+      ]
+    },
+    "ConditionalAxisColor": {
+      "$ref": "#/definitions/ConditionalAxisProperty<(Color|null)>"
+    },
+    "ConditionalAxisLabelAlign": {
+      "$ref": "#/definitions/ConditionalAxisProperty<(Align|null)>"
+    },
+    "ConditionalAxisLabelBaseline": {
+      "$ref": "#/definitions/ConditionalAxisProperty<(TextBaseline|null)>"
+    },
+    "ConditionalAxisLabelFontStyle": {
+      "$ref": "#/definitions/ConditionalAxisProperty<(FontStyle|null)>"
+    },
+    "ConditionalAxisLabelFontWeight": {
+      "$ref": "#/definitions/ConditionalAxisProperty<(FontWeight|null)>"
+    },
+    "ConditionalAxisNumber": {
+      "$ref": "#/definitions/ConditionalAxisProperty<(number|null)>"
+    },
+    "ConditionalAxisNumberArray": {
+      "$ref": "#/definitions/ConditionalAxisProperty<(number[]|null)>"
+    },
+    "ConditionalAxisProperty<(Align|null)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(Align|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(Align|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Align"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "required": [
+            "condition",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(Align|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(Align|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            }
+          },
+          "required": [
+            "condition",
+            "expr"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalAxisProperty<(Color|null)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(Color|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(Color|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Color"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "required": [
+            "condition",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(Color|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(Color|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            }
+          },
+          "required": [
+            "condition",
+            "expr"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalAxisProperty<(FontStyle|null)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(FontStyle|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(FontStyle|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/FontStyle"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "required": [
+            "condition",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(FontStyle|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(FontStyle|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            }
+          },
+          "required": [
+            "condition",
+            "expr"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalAxisProperty<(FontWeight|null)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(FontWeight|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(FontWeight|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/FontWeight"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "required": [
+            "condition",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(FontWeight|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(FontWeight|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            }
+          },
+          "required": [
+            "condition",
+            "expr"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalAxisProperty<(TextBaseline|null)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(TextBaseline|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(TextBaseline|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TextBaseline"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "required": [
+            "condition",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(TextBaseline|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(TextBaseline|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            }
+          },
+          "required": [
+            "condition",
+            "expr"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalAxisProperty<(number[]|null)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(number[]|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(number[]|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "items": {
+                    "type": "number"
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "required": [
+            "condition",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(number[]|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(number[]|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            }
+          },
+          "required": [
+            "condition",
+            "expr"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalAxisProperty<(number|null)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(number|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(number|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "value": {
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity).",
+              "type": [
+                "number",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "condition",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(number|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(number|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            }
+          },
+          "required": [
+            "condition",
+            "expr"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalAxisProperty<(string|null)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(string|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(string|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "value": {
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity).",
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "condition",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(string|null)>|ExprRef)>"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/ConditionalPredicate<(ValueDef<(string|null)>|ExprRef)>"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            }
+          },
+          "required": [
+            "condition",
+            "expr"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalAxisString": {
+      "$ref": "#/definitions/ConditionalAxisProperty<(string|null)>"
+    },
+    "ConditionalParameter<MarkPropFieldOrDatumDef>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "empty": {
+              "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
+              "type": "boolean"
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "param": {
+              "$ref": "#/definitions/ParameterName",
+              "description": "Filter using a parameter name."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/StandardType",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            }
+          },
+          "required": [
+            "param"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "empty": {
+              "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
+              "type": "boolean"
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "param": {
+              "$ref": "#/definitions/ParameterName",
+              "description": "Filter using a parameter name."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/Type",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            }
+          },
+          "required": [
+            "param"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalParameter<MarkPropFieldOrDatumDef<TypeForShape>>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "empty": {
+              "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
+              "type": "boolean"
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "param": {
+              "$ref": "#/definitions/ParameterName",
+              "description": "Filter using a parameter name."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/TypeForShape",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            }
+          },
+          "required": [
+            "param"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "empty": {
+              "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
+              "type": "boolean"
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "param": {
+              "$ref": "#/definitions/ParameterName",
+              "description": "Filter using a parameter name."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/Type",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            }
+          },
+          "required": [
+            "param"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalParameter<StringFieldDef>": {
+      "additionalProperties": false,
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "const": "binned",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "empty": {
+          "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
+          "type": "boolean"
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "format": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Dict"
+            }
+          ],
+          "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+        },
+        "formatType": {
+          "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+          "type": "string"
+        },
+        "param": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "Filter using a parameter name."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "required": [
+        "param"
+      ],
+      "type": "object"
+    },
+    "ConditionalParameter<ValueDef<(Gradient|string|null|ExprRef)>>": {
+      "additionalProperties": false,
+      "properties": {
+        "empty": {
+          "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
+          "type": "boolean"
+        },
+        "param": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "Filter using a parameter name."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "param",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ConditionalParameter<ValueDef<(Text|ExprRef)>>": {
+      "additionalProperties": false,
+      "properties": {
+        "empty": {
+          "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
+          "type": "boolean"
+        },
+        "param": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "Filter using a parameter name."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "param",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ConditionalParameter<ValueDef<(number[]|ExprRef)>>": {
+      "additionalProperties": false,
+      "properties": {
+        "empty": {
+          "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
+          "type": "boolean"
+        },
+        "param": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "Filter using a parameter name."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "param",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ConditionalParameter<ValueDef<(number|ExprRef)>>": {
+      "additionalProperties": false,
+      "properties": {
+        "empty": {
+          "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
+          "type": "boolean"
+        },
+        "param": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "Filter using a parameter name."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "param",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ConditionalParameter<ValueDef<(string|ExprRef)>>": {
+      "additionalProperties": false,
+      "properties": {
+        "empty": {
+          "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
+          "type": "boolean"
+        },
+        "param": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "Filter using a parameter name."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "param",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ConditionalParameter<ValueDef<(string|null|ExprRef)>>": {
+      "additionalProperties": false,
+      "properties": {
+        "empty": {
+          "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
+          "type": "boolean"
+        },
+        "param": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "Filter using a parameter name."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "param",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ConditionalParameter<ValueDef<number>>": {
+      "additionalProperties": false,
+      "properties": {
+        "empty": {
+          "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
+          "type": "boolean"
+        },
+        "param": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "Filter using a parameter name."
+        },
+        "value": {
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity).",
+          "type": "number"
+        }
+      },
+      "required": [
+        "param",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ConditionalPredicate<(ValueDef<(Align|null)>|ExprRef)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Align"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "required": [
+            "test",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            },
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            }
+          },
+          "required": [
+            "expr",
+            "test"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalPredicate<(ValueDef<(Color|null)>|ExprRef)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Color"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "required": [
+            "test",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            },
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            }
+          },
+          "required": [
+            "expr",
+            "test"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalPredicate<(ValueDef<(FontStyle|null)>|ExprRef)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/FontStyle"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "required": [
+            "test",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            },
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            }
+          },
+          "required": [
+            "expr",
+            "test"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalPredicate<(ValueDef<(FontWeight|null)>|ExprRef)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/FontWeight"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "required": [
+            "test",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            },
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            }
+          },
+          "required": [
+            "expr",
+            "test"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalPredicate<(ValueDef<(TextBaseline|null)>|ExprRef)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TextBaseline"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "required": [
+            "test",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            },
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            }
+          },
+          "required": [
+            "expr",
+            "test"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalPredicate<(ValueDef<(number[]|null)>|ExprRef)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "items": {
+                    "type": "number"
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "required": [
+            "test",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            },
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            }
+          },
+          "required": [
+            "expr",
+            "test"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalPredicate<(ValueDef<(number|null)>|ExprRef)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            },
+            "value": {
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity).",
+              "type": [
+                "number",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "test",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            },
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            }
+          },
+          "required": [
+            "expr",
+            "test"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalPredicate<(ValueDef<(string|null)>|ExprRef)>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            },
+            "value": {
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity).",
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "test",
+            "value"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "expr": {
+              "description": "Vega expression (which can refer to Vega-Lite parameters).",
+              "type": "string"
+            },
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            }
+          },
+          "required": [
+            "expr",
+            "test"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalPredicate<MarkPropFieldOrDatumDef>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/StandardType",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            }
+          },
+          "required": [
+            "test"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/Type",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            }
+          },
+          "required": [
+            "test"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalPredicate<MarkPropFieldOrDatumDef<TypeForShape>>": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/TypeForShape",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            }
+          },
+          "required": [
+            "test"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "test": {
+              "$ref": "#/definitions/PredicateComposition",
+              "description": "Predicate for triggering the condition"
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/Type",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            }
+          },
+          "required": [
+            "test"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ConditionalPredicate<StringFieldDef>": {
+      "additionalProperties": false,
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "const": "binned",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "format": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Dict"
+            }
+          ],
+          "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+        },
+        "formatType": {
+          "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+          "type": "string"
+        },
+        "test": {
+          "$ref": "#/definitions/PredicateComposition",
+          "description": "Predicate for triggering the condition"
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "required": [
+        "test"
+      ],
+      "type": "object"
+    },
+    "ConditionalPredicate<ValueDef<(Gradient|string|null|ExprRef)>>": {
+      "additionalProperties": false,
+      "properties": {
+        "test": {
+          "$ref": "#/definitions/PredicateComposition",
+          "description": "Predicate for triggering the condition"
+        },
+        "value": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "test",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ConditionalPredicate<ValueDef<(Text|ExprRef)>>": {
+      "additionalProperties": false,
+      "properties": {
+        "test": {
+          "$ref": "#/definitions/PredicateComposition",
+          "description": "Predicate for triggering the condition"
+        },
+        "value": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "test",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ConditionalPredicate<ValueDef<(number[]|ExprRef)>>": {
+      "additionalProperties": false,
+      "properties": {
+        "test": {
+          "$ref": "#/definitions/PredicateComposition",
+          "description": "Predicate for triggering the condition"
+        },
+        "value": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "test",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ConditionalPredicate<ValueDef<(number|ExprRef)>>": {
+      "additionalProperties": false,
+      "properties": {
+        "test": {
+          "$ref": "#/definitions/PredicateComposition",
+          "description": "Predicate for triggering the condition"
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "test",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ConditionalPredicate<ValueDef<(string|ExprRef)>>": {
+      "additionalProperties": false,
+      "properties": {
+        "test": {
+          "$ref": "#/definitions/PredicateComposition",
+          "description": "Predicate for triggering the condition"
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "test",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ConditionalPredicate<ValueDef<(string|null|ExprRef)>>": {
+      "additionalProperties": false,
+      "properties": {
+        "test": {
+          "$ref": "#/definitions/PredicateComposition",
+          "description": "Predicate for triggering the condition"
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "test",
+        "value"
+      ],
+      "type": "object"
+    },
+    "ConditionalPredicate<ValueDef<number>>": {
+      "additionalProperties": false,
+      "properties": {
+        "test": {
+          "$ref": "#/definitions/PredicateComposition",
+          "description": "Predicate for triggering the condition"
+        },
+        "value": {
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity).",
+          "type": "number"
+        }
+      },
+      "required": [
+        "test",
+        "value"
+      ],
+      "type": "object"
+    },
+    "Config": {
+      "additionalProperties": false,
+      "properties": {
+        "arc": {
+          "$ref": "#/definitions/RectConfig",
+          "description": "Arc-specific Config"
+        },
+        "area": {
+          "$ref": "#/definitions/AreaConfig",
+          "description": "Area-Specific Config"
+        },
+        "aria": {
+          "description": "A boolean flag indicating if ARIA default attributes should be included for marks and guides (SVG output only). If false, the `\"aria-hidden\"` attribute will be set for all guides, removing them from the ARIA accessibility tree and Vega-Lite will not generate default descriptions for marks.\n\n__Default value:__ `true`.",
+          "type": "boolean"
+        },
+        "autosize": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/AutosizeType"
+            },
+            {
+              "$ref": "#/definitions/AutoSizeParams"
+            }
+          ],
+          "description": "How the visualization size should be determined. If a string, should be one of `\"pad\"`, `\"fit\"` or `\"none\"`. Object values can additionally specify parameters for content sizing and automatic resizing.\n\n__Default value__: `pad`"
+        },
+        "axis": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Axis configuration, which determines default properties for all `x` and `y` [axes](https://vega.github.io/vega-lite/docs/axis.html). For a full list of axis configuration options, please see the [corresponding section of the axis documentation](https://vega.github.io/vega-lite/docs/axis.html#config)."
+        },
+        "axisBand": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for axes with \"band\" scales."
+        },
+        "axisBottom": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for x-axis along the bottom edge of the chart."
+        },
+        "axisDiscrete": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for axes with \"point\" or \"band\" scales."
+        },
+        "axisLeft": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for y-axis along the left edge of the chart."
+        },
+        "axisPoint": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for axes with \"point\" scales."
+        },
+        "axisQuantitative": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for quantitative axes."
+        },
+        "axisRight": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for y-axis along the right edge of the chart."
+        },
+        "axisTemporal": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for temporal axes."
+        },
+        "axisTop": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for x-axis along the top edge of the chart."
+        },
+        "axisX": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "X-axis specific config."
+        },
+        "axisXBand": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for x-axes with \"band\" scales."
+        },
+        "axisXDiscrete": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for x-axes with \"point\" or \"band\" scales."
+        },
+        "axisXPoint": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for x-axes with \"point\" scales."
+        },
+        "axisXQuantitative": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for x-quantitative axes."
+        },
+        "axisXTemporal": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for x-temporal axes."
+        },
+        "axisY": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Y-axis specific config."
+        },
+        "axisYBand": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for y-axes with \"band\" scales."
+        },
+        "axisYDiscrete": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for y-axes with \"point\" or \"band\" scales."
+        },
+        "axisYPoint": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for y-axes with \"point\" scales."
+        },
+        "axisYQuantitative": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for y-quantitative axes."
+        },
+        "axisYTemporal": {
+          "$ref": "#/definitions/AxisConfig",
+          "description": "Config for y-temporal axes."
+        },
+        "background": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "CSS color property to use as the background of the entire view.\n\n__Default value:__ `\"white\"`"
+        },
+        "bar": {
+          "$ref": "#/definitions/BarConfig",
+          "description": "Bar-Specific Config"
+        },
+        "boxplot": {
+          "$ref": "#/definitions/BoxPlotConfig",
+          "description": "Box Config"
+        },
+        "circle": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Circle-Specific Config"
+        },
+        "concat": {
+          "$ref": "#/definitions/CompositionConfig",
+          "description": "Default configuration for all concatenation and repeat view composition operators (`concat`, `hconcat`, `vconcat`, and `repeat`)"
+        },
+        "countTitle": {
+          "description": "Default axis and legend title for count fields.\n\n__Default value:__ `'Count of Records`.",
+          "type": "string"
+        },
+        "customFormatTypes": {
+          "description": "Allow the `formatType` property for text marks and guides to accept a custom formatter function [registered as a Vega expression](https://vega.github.io/vega-lite/usage/compile.html#format-type).",
+          "type": "boolean"
+        },
+        "errorband": {
+          "$ref": "#/definitions/ErrorBandConfig",
+          "description": "ErrorBand Config"
+        },
+        "errorbar": {
+          "$ref": "#/definitions/ErrorBarConfig",
+          "description": "ErrorBar Config"
+        },
+        "facet": {
+          "$ref": "#/definitions/CompositionConfig",
+          "description": "Default configuration for the `facet` view composition operator"
+        },
+        "fieldTitle": {
+          "description": "Defines how Vega-Lite generates title for fields. There are three possible styles:\n- `\"verbal\"` (Default) - displays function in a verbal style (e.g., \"Sum of field\", \"Year-month of date\", \"field (binned)\").\n- `\"function\"` - displays function using parentheses and capitalized texts (e.g., \"SUM(field)\", \"YEARMONTH(date)\", \"BIN(field)\").\n- `\"plain\"` - displays only the field name without functions (e.g., \"field\", \"date\", \"field\").",
+          "enum": [
+            "verbal",
+            "functional",
+            "plain"
+          ],
+          "type": "string"
+        },
+        "font": {
+          "description": "Default font for all text marks, titles, and labels.",
+          "type": "string"
+        },
+        "geoshape": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Geoshape-Specific Config"
+        },
+        "header": {
+          "$ref": "#/definitions/HeaderConfig",
+          "description": "Header configuration, which determines default properties for all [headers](https://vega.github.io/vega-lite/docs/header.html).\n\nFor a full list of header configuration options, please see the [corresponding section of in the header documentation](https://vega.github.io/vega-lite/docs/header.html#config)."
+        },
+        "headerColumn": {
+          "$ref": "#/definitions/HeaderConfig",
+          "description": "Header configuration, which determines default properties for column [headers](https://vega.github.io/vega-lite/docs/header.html).\n\nFor a full list of header configuration options, please see the [corresponding section of in the header documentation](https://vega.github.io/vega-lite/docs/header.html#config)."
+        },
+        "headerFacet": {
+          "$ref": "#/definitions/HeaderConfig",
+          "description": "Header configuration, which determines default properties for non-row/column facet [headers](https://vega.github.io/vega-lite/docs/header.html).\n\nFor a full list of header configuration options, please see the [corresponding section of in the header documentation](https://vega.github.io/vega-lite/docs/header.html#config)."
+        },
+        "headerRow": {
+          "$ref": "#/definitions/HeaderConfig",
+          "description": "Header configuration, which determines default properties for row [headers](https://vega.github.io/vega-lite/docs/header.html).\n\nFor a full list of header configuration options, please see the [corresponding section of in the header documentation](https://vega.github.io/vega-lite/docs/header.html#config)."
+        },
+        "image": {
+          "$ref": "#/definitions/RectConfig",
+          "description": "Image-specific Config"
+        },
+        "legend": {
+          "$ref": "#/definitions/LegendConfig",
+          "description": "Legend configuration, which determines default properties for all [legends](https://vega.github.io/vega-lite/docs/legend.html). For a full list of legend configuration options, please see the [corresponding section of in the legend documentation](https://vega.github.io/vega-lite/docs/legend.html#config)."
+        },
+        "line": {
+          "$ref": "#/definitions/LineConfig",
+          "description": "Line-Specific Config"
+        },
+        "lineBreak": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A delimiter, such as a newline character, upon which to break text strings into multiple lines. This property provides a global default for text marks, which is overridden by mark or style config settings, and by the lineBreak mark encoding channel. If signal-valued, either string or regular expression (regexp) values are valid."
+        },
+        "locale": {
+          "$ref": "#/definitions/Locale",
+          "description": "Locale definitions for string parsing and formatting of number and date values. The locale object should contain `number` and/or `time` properties with [locale definitions](https://vega.github.io/vega/docs/api/locale/). Locale definitions provided in the config block may be overridden by the View constructor locale option."
+        },
+        "mark": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Mark Config"
+        },
+        "normalizedNumberFormat": {
+          "description": "If normalizedNumberFormatType is not specified, D3 number format for axis labels, text marks, and tooltips of normalized stacked fields (fields with `stack: \"normalize\"`). For example `\"s\"` for SI units. Use [D3's number format pattern](https://github.com/d3/d3-format#locale_format).\n\nIf `config.normalizedNumberFormatType` is specified and `config.customFormatTypes` is `true`, this value will be passed as `format` alongside `datum.value` to the `config.numberFormatType` function. __Default value:__ `%`",
+          "type": "string"
+        },
+        "normalizedNumberFormatType": {
+          "description": "[Custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type) for `config.normalizedNumberFormat`.\n\n__Default value:__ `undefined` -- This is equilvalent to call D3-format, which is exposed as [`format` in Vega-Expression](https://vega.github.io/vega/docs/expressions/#format). __Note:__ You must also set `customFormatTypes` to `true` to use this feature.",
+          "type": "string"
+        },
+        "numberFormat": {
+          "description": "If numberFormatType is not specified, D3 number format for guide labels, text marks, and tooltips of non-normalized fields (fields *without* `stack: \"normalize\"`). For example `\"s\"` for SI units. Use [D3's number format pattern](https://github.com/d3/d3-format#locale_format).\n\nIf `config.numberFormatType` is specified and `config.customFormatTypes` is `true`, this value will be passed as `format` alongside `datum.value` to the `config.numberFormatType` function.",
+          "type": "string"
+        },
+        "numberFormatType": {
+          "description": "[Custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type) for `config.numberFormat`.\n\n__Default value:__ `undefined` -- This is equilvalent to call D3-format, which is exposed as [`format` in Vega-Expression](https://vega.github.io/vega/docs/expressions/#format). __Note:__ You must also set `customFormatTypes` to `true` to use this feature.",
+          "type": "string"
+        },
+        "padding": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Padding"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The default visualization padding, in pixels, from the edge of the visualization canvas to the data rectangle. If a number, specifies padding for all sides. If an object, the value should have the format `{\"left\": 5, \"top\": 5, \"right\": 5, \"bottom\": 5}` to specify padding for each side of the visualization.\n\n__Default value__: `5`"
+        },
+        "params": {
+          "description": "Dynamic variables or selections that parameterize a visualization.",
+          "items": {
+            "$ref": "#/definitions/TopLevelParameter"
+          },
+          "type": "array"
+        },
+        "point": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Point-Specific Config"
+        },
+        "projection": {
+          "$ref": "#/definitions/ProjectionConfig",
+          "description": "Projection configuration, which determines default properties for all [projections](https://vega.github.io/vega-lite/docs/projection.html). For a full list of projection configuration options, please see the [corresponding section of the projection documentation](https://vega.github.io/vega-lite/docs/projection.html#config)."
+        },
+        "range": {
+          "$ref": "#/definitions/RangeConfig",
+          "description": "An object hash that defines default range arrays or schemes for using with scales. For a full list of scale range configuration options, please see the [corresponding section of the scale documentation](https://vega.github.io/vega-lite/docs/scale.html#config)."
+        },
+        "rect": {
+          "$ref": "#/definitions/RectConfig",
+          "description": "Rect-Specific Config"
+        },
+        "rule": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Rule-Specific Config"
+        },
+        "scale": {
+          "$ref": "#/definitions/ScaleConfig",
+          "description": "Scale configuration determines default properties for all [scales](https://vega.github.io/vega-lite/docs/scale.html). For a full list of scale configuration options, please see the [corresponding section of the scale documentation](https://vega.github.io/vega-lite/docs/scale.html#config)."
+        },
+        "selection": {
+          "$ref": "#/definitions/SelectionConfig",
+          "description": "An object hash for defining default properties for each type of selections."
+        },
+        "square": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Square-Specific Config"
+        },
+        "style": {
+          "$ref": "#/definitions/StyleConfigIndex",
+          "description": "An object hash that defines key-value mappings to determine default properties for marks with a given [style](https://vega.github.io/vega-lite/docs/mark.html#mark-def). The keys represent styles names; the values have to be valid [mark configuration objects](https://vega.github.io/vega-lite/docs/mark.html#config)."
+        },
+        "text": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Text-Specific Config"
+        },
+        "tick": {
+          "$ref": "#/definitions/TickConfig",
+          "description": "Tick-Specific Config"
+        },
+        "timeFormat": {
+          "description": "Default time format for raw time values (without time units) in text marks, legend labels and header labels.\n\n__Default value:__ `\"%b %d, %Y\"` __Note:__ Axes automatically determine the format for each label automatically so this config does not affect axes.",
+          "type": "string"
+        },
+        "timeFormatType": {
+          "description": "[Custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type) for `config.timeFormat`.\n\n__Default value:__ `undefined` -- This is equilvalent to call D3-time-format, which is exposed as [`timeFormat` in Vega-Expression](https://vega.github.io/vega/docs/expressions/#timeFormat). __Note:__ You must also set `customFormatTypes` to `true` and there must *not* be a `timeUnit` defined to use this feature.",
+          "type": "string"
+        },
+        "title": {
+          "$ref": "#/definitions/TitleConfig",
+          "description": "Title configuration, which determines default properties for all [titles](https://vega.github.io/vega-lite/docs/title.html). For a full list of title configuration options, please see the [corresponding section of the title documentation](https://vega.github.io/vega-lite/docs/title.html#config)."
+        },
+        "tooltipFormat": {
+          "$ref": "#/definitions/FormatConfig",
+          "description": "Define [custom format configuration](https://vega.github.io/vega-lite/docs/config.html#format) for tooltips. If unspecified, default format config will be applied."
+        },
+        "trail": {
+          "$ref": "#/definitions/LineConfig",
+          "description": "Trail-Specific Config"
+        },
+        "view": {
+          "$ref": "#/definitions/ViewConfig",
+          "description": "Default properties for [single view plots](https://vega.github.io/vega-lite/docs/spec.html#single)."
+        }
+      },
+      "type": "object"
+    },
+    "CsvDataFormat": {
+      "additionalProperties": false,
+      "properties": {
+        "parse": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Parse"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "If set to `null`, disable type inference based on the spec and only use type inference based on the data. Alternatively, a parsing directive object can be provided for explicit data types. Each property of the object corresponds to a field name, and the value to the desired data type (one of `\"number\"`, `\"boolean\"`, `\"date\"`, or null (do not parse the field)). For example, `\"parse\": {\"modified_on\": \"date\"}` parses the `modified_on` field in each input record a Date value.\n\nFor `\"date\"`, we parse data based using JavaScript's [`Date.parse()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse). For Specific date formats can be provided (e.g., `{foo: \"date:'%m%d%Y'\"}`), using the [d3-time-format syntax](https://github.com/d3/d3-time-format#locale_format). UTC date format parsing is supported similarly (e.g., `{foo: \"utc:'%m%d%Y'\"}`). See more about [UTC time](https://vega.github.io/vega-lite/docs/timeunit.html#utc)"
+        },
+        "type": {
+          "description": "Type of input data: `\"json\"`, `\"csv\"`, `\"tsv\"`, `\"dsv\"`.\n\n__Default value:__  The default format type is determined by the extension of the file URL. If no extension is detected, `\"json\"` will be used by default.",
+          "enum": [
+            "csv",
+            "tsv"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "Cursor": {
+      "enum": [
+        "auto",
+        "default",
+        "none",
+        "context-menu",
+        "help",
+        "pointer",
+        "progress",
+        "wait",
+        "cell",
+        "crosshair",
+        "text",
+        "vertical-text",
+        "alias",
+        "copy",
+        "move",
+        "no-drop",
+        "not-allowed",
+        "e-resize",
+        "n-resize",
+        "ne-resize",
+        "nw-resize",
+        "s-resize",
+        "se-resize",
+        "sw-resize",
+        "w-resize",
+        "ew-resize",
+        "ns-resize",
+        "nesw-resize",
+        "nwse-resize",
+        "col-resize",
+        "row-resize",
+        "all-scroll",
+        "zoom-in",
+        "zoom-out",
+        "grab",
+        "grabbing"
+      ],
+      "type": "string"
+    },
+    "Cyclical": {
+      "enum": [
+        "rainbow",
+        "sinebow"
+      ],
+      "type": "string"
+    },
+    "Data": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/DataSource"
+        },
+        {
+          "$ref": "#/definitions/Generator"
+        }
+      ]
+    },
+    "DataFormat": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/CsvDataFormat"
+        },
+        {
+          "$ref": "#/definitions/DsvDataFormat"
+        },
+        {
+          "$ref": "#/definitions/JsonDataFormat"
+        },
+        {
+          "$ref": "#/definitions/TopoDataFormat"
+        }
+      ]
+    },
+    "DataSource": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/UrlData"
+        },
+        {
+          "$ref": "#/definitions/InlineData"
+        },
+        {
+          "$ref": "#/definitions/NamedData"
+        }
+      ]
+    },
+    "Datasets": {
+      "$ref": "#/definitions/Dict<InlineDataset>"
+    },
+    "DateTime": {
+      "additionalProperties": false,
+      "description": "Object for defining datetime in Vega-Lite Filter. If both month and quarter are provided, month has higher precedence. `day` cannot be combined with other date. We accept string for month and day names.",
+      "properties": {
+        "date": {
+          "description": "Integer value representing the date (day of the month) from 1-31.",
+          "maximum": 31,
+          "minimum": 1,
+          "type": "number"
+        },
+        "day": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Day"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "description": "Value representing the day of a week. This can be one of: (1) integer value -- `1` represents Monday; (2) case-insensitive day name (e.g., `\"Monday\"`); (3) case-insensitive, 3-character short day name (e.g., `\"Mon\"`).\n\n**Warning:** A DateTime definition object with `day`** should not be combined with `year`, `quarter`, `month`, or `date`."
+        },
+        "hours": {
+          "description": "Integer value representing the hour of a day from 0-23.",
+          "maximum": 24,
+          "minimum": 0,
+          "type": "number"
+        },
+        "milliseconds": {
+          "description": "Integer value representing the millisecond segment of time.",
+          "maximum": 1000,
+          "minimum": 0,
+          "type": "number"
+        },
+        "minutes": {
+          "description": "Integer value representing the minute segment of time from 0-59.",
+          "maximum": 60,
+          "minimum": 0,
+          "type": "number"
+        },
+        "month": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Month"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "description": "One of: (1) integer value representing the month from `1`-`12`. `1` represents January; (2) case-insensitive month name (e.g., `\"January\"`); (3) case-insensitive, 3-character short month name (e.g., `\"Jan\"`)."
+        },
+        "quarter": {
+          "description": "Integer value representing the quarter of the year (from 1-4).",
+          "maximum": 4,
+          "minimum": 1,
+          "type": "number"
+        },
+        "seconds": {
+          "description": "Integer value representing the second segment (0-59) of a time value",
+          "maximum": 60,
+          "minimum": 0,
+          "type": "number"
+        },
+        "utc": {
+          "description": "A boolean flag indicating if date time is in utc time. If false, the date time is in local time",
+          "type": "boolean"
+        },
+        "year": {
+          "description": "Integer value representing the year.",
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "DatumDef": {
+      "additionalProperties": false,
+      "properties": {
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "datum": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PrimitiveValue"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/RepeatRef"
+            }
+          ],
+          "description": "A constant value in data domain."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/Type",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "Day": {
+      "maximum": 7,
+      "minimum": 1,
+      "type": "number"
+    },
+    "DensityTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "description": "The output fields for the sample value and corresponding density estimate.\n\n__Default value:__ `[\"value\", \"density\"]`",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "maxItems": 2,
+          "minItems": 2,
+          "type": "array"
+        },
+        "bandwidth": {
+          "description": "The bandwidth (standard deviation) of the Gaussian kernel. If unspecified or set to zero, the bandwidth value is automatically estimated from the input data using Scott’s rule.",
+          "type": "number"
+        },
+        "counts": {
+          "description": "A boolean flag indicating if the output values should be probability estimates (false) or smoothed counts (true).\n\n__Default value:__ `false`",
+          "type": "boolean"
+        },
+        "cumulative": {
+          "description": "A boolean flag indicating whether to produce density estimates (false) or cumulative density estimates (true).\n\n__Default value:__ `false`",
+          "type": "boolean"
+        },
+        "density": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field for which to perform density estimation."
+        },
+        "extent": {
+          "description": "A [min, max] domain from which to sample the distribution. If unspecified, the extent will be determined by the observed minimum and maximum values of the density value field.",
+          "items": {
+            "type": "number"
+          },
+          "maxItems": 2,
+          "minItems": 2,
+          "type": "array"
+        },
+        "groupby": {
+          "description": "The data fields to group by. If not specified, a single group containing all data objects will be used.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "maxsteps": {
+          "description": "The maximum number of samples to take along the extent domain for plotting the density.\n\n__Default value:__ `200`",
+          "type": "number"
+        },
+        "minsteps": {
+          "description": "The minimum number of samples to take along the extent domain for plotting the density.\n\n__Default value:__ `25`",
+          "type": "number"
+        },
+        "steps": {
+          "description": "The exact number of samples to take along the extent domain for plotting the density. If specified, overrides both minsteps and maxsteps to set an exact number of uniform samples. Potentially useful in conjunction with a fixed extent to ensure consistent sample points for stacked densities.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "density"
+      ],
+      "type": "object"
+    },
+    "DerivedStream": {
+      "additionalProperties": false,
+      "properties": {
+        "between": {
+          "items": {
+            "$ref": "#/definitions/Stream"
+          },
+          "type": "array"
+        },
+        "consume": {
+          "type": "boolean"
+        },
+        "debounce": {
+          "type": "number"
+        },
+        "filter": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Expr"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/Expr"
+              },
+              "type": "array"
+            }
+          ]
+        },
+        "markname": {
+          "type": "string"
+        },
+        "marktype": {
+          "$ref": "#/definitions/MarkType"
+        },
+        "stream": {
+          "$ref": "#/definitions/Stream"
+        },
+        "throttle": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "stream"
+      ],
+      "type": "object"
+    },
+    "Dict<InlineDataset>": {
+      "additionalProperties": {
+        "$ref": "#/definitions/InlineDataset"
+      },
+      "type": "object"
+    },
+    "Dict<SelectionInit>": {
+      "additionalProperties": {
+        "$ref": "#/definitions/SelectionInit"
+      },
+      "type": "object"
+    },
+    "Dict<SelectionInitInterval>": {
+      "additionalProperties": {
+        "$ref": "#/definitions/SelectionInitInterval"
+      },
+      "type": "object"
+    },
+    "Dict": {
+      "additionalProperties": {},
+      "type": "object"
+    },
+    "Diverging": {
+      "enum": [
+        "blueorange",
+        "blueorange-3",
+        "blueorange-4",
+        "blueorange-5",
+        "blueorange-6",
+        "blueorange-7",
+        "blueorange-8",
+        "blueorange-9",
+        "blueorange-10",
+        "blueorange-11",
+        "brownbluegreen",
+        "brownbluegreen-3",
+        "brownbluegreen-4",
+        "brownbluegreen-5",
+        "brownbluegreen-6",
+        "brownbluegreen-7",
+        "brownbluegreen-8",
+        "brownbluegreen-9",
+        "brownbluegreen-10",
+        "brownbluegreen-11",
+        "purplegreen",
+        "purplegreen-3",
+        "purplegreen-4",
+        "purplegreen-5",
+        "purplegreen-6",
+        "purplegreen-7",
+        "purplegreen-8",
+        "purplegreen-9",
+        "purplegreen-10",
+        "purplegreen-11",
+        "pinkyellowgreen",
+        "pinkyellowgreen-3",
+        "pinkyellowgreen-4",
+        "pinkyellowgreen-5",
+        "pinkyellowgreen-6",
+        "pinkyellowgreen-7",
+        "pinkyellowgreen-8",
+        "pinkyellowgreen-9",
+        "pinkyellowgreen-10",
+        "pinkyellowgreen-11",
+        "purpleorange",
+        "purpleorange-3",
+        "purpleorange-4",
+        "purpleorange-5",
+        "purpleorange-6",
+        "purpleorange-7",
+        "purpleorange-8",
+        "purpleorange-9",
+        "purpleorange-10",
+        "purpleorange-11",
+        "redblue",
+        "redblue-3",
+        "redblue-4",
+        "redblue-5",
+        "redblue-6",
+        "redblue-7",
+        "redblue-8",
+        "redblue-9",
+        "redblue-10",
+        "redblue-11",
+        "redgrey",
+        "redgrey-3",
+        "redgrey-4",
+        "redgrey-5",
+        "redgrey-6",
+        "redgrey-7",
+        "redgrey-8",
+        "redgrey-9",
+        "redgrey-10",
+        "redgrey-11",
+        "redyellowblue",
+        "redyellowblue-3",
+        "redyellowblue-4",
+        "redyellowblue-5",
+        "redyellowblue-6",
+        "redyellowblue-7",
+        "redyellowblue-8",
+        "redyellowblue-9",
+        "redyellowblue-10",
+        "redyellowblue-11",
+        "redyellowgreen",
+        "redyellowgreen-3",
+        "redyellowgreen-4",
+        "redyellowgreen-5",
+        "redyellowgreen-6",
+        "redyellowgreen-7",
+        "redyellowgreen-8",
+        "redyellowgreen-9",
+        "redyellowgreen-10",
+        "redyellowgreen-11",
+        "spectral",
+        "spectral-3",
+        "spectral-4",
+        "spectral-5",
+        "spectral-6",
+        "spectral-7",
+        "spectral-8",
+        "spectral-9",
+        "spectral-10",
+        "spectral-11"
+      ],
+      "type": "string"
+    },
+    "DomainUnionWith": {
+      "additionalProperties": false,
+      "properties": {
+        "unionWith": {
+          "description": "Customized domain values to be union with the field's values or explicitly defined domain. Should be an array of valid scale domain values.",
+          "items": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "string"
+              },
+              {
+                "type": "boolean"
+              },
+              {
+                "$ref": "#/definitions/DateTime"
+              }
+            ]
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "unionWith"
+      ],
+      "type": "object"
+    },
+    "DsvDataFormat": {
+      "additionalProperties": false,
+      "properties": {
+        "delimiter": {
+          "description": "The delimiter between records. The delimiter must be a single character (i.e., a single 16-bit code unit); so, ASCII delimiters are fine, but emoji delimiters are not.",
+          "maxLength": 1,
+          "minLength": 1,
+          "type": "string"
+        },
+        "parse": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Parse"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "If set to `null`, disable type inference based on the spec and only use type inference based on the data. Alternatively, a parsing directive object can be provided for explicit data types. Each property of the object corresponds to a field name, and the value to the desired data type (one of `\"number\"`, `\"boolean\"`, `\"date\"`, or null (do not parse the field)). For example, `\"parse\": {\"modified_on\": \"date\"}` parses the `modified_on` field in each input record a Date value.\n\nFor `\"date\"`, we parse data based using JavaScript's [`Date.parse()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse). For Specific date formats can be provided (e.g., `{foo: \"date:'%m%d%Y'\"}`), using the [d3-time-format syntax](https://github.com/d3/d3-time-format#locale_format). UTC date format parsing is supported similarly (e.g., `{foo: \"utc:'%m%d%Y'\"}`). See more about [UTC time](https://vega.github.io/vega-lite/docs/timeunit.html#utc)"
+        },
+        "type": {
+          "const": "dsv",
+          "description": "Type of input data: `\"json\"`, `\"csv\"`, `\"tsv\"`, `\"dsv\"`.\n\n__Default value:__  The default format type is determined by the extension of the file URL. If no extension is detected, `\"json\"` will be used by default.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "delimiter"
+      ],
+      "type": "object"
+    },
+    "Element": {
+      "type": "string"
+    },
+    "EncodingSortField": {
+      "additionalProperties": false,
+      "description": "A sort definition for sorting a discrete scale in an encoding field definition.",
+      "properties": {
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "The data [field](https://vega.github.io/vega-lite/docs/field.html) to sort by.\n\n__Default value:__ If unspecified, defaults to the field specified in the outer data reference."
+        },
+        "op": {
+          "$ref": "#/definitions/NonArgAggregateOp",
+          "description": "An [aggregate operation](https://vega.github.io/vega-lite/docs/aggregate.html#ops) to perform on the field prior to sorting (e.g., `\"count\"`, `\"mean\"` and `\"median\"`). An aggregation is required when there are multiple values of the sort field for each encoded data field. The input data objects will be aggregated, grouped by the encoded data field.\n\nFor a full list of operations, please see the documentation for [aggregate](https://vega.github.io/vega-lite/docs/aggregate.html#ops).\n\n__Default value:__ `\"sum\"` for stacked plots. Otherwise, `\"min\"`."
+        },
+        "order": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SortOrder"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The sort order. One of `\"ascending\"` (default), `\"descending\"`, or `null` (no not sort)."
+        }
+      },
+      "type": "object"
+    },
+    "ErrorBand": {
+      "const": "errorband",
+      "type": "string"
+    },
+    "ErrorBandConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "band": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "borders": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "extent": {
+          "$ref": "#/definitions/ErrorBarExtent",
+          "description": "The extent of the band. Available options include:\n- `\"ci\"`: Extend the band to the confidence interval of the mean.\n- `\"stderr\"`: The size of band are set to the value of standard error, extending from the mean.\n- `\"stdev\"`: The size of band are set to the value of standard deviation, extending from the mean.\n- `\"iqr\"`: Extend the band to the q1 and q3.\n\n__Default value:__ `\"stderr\"`."
+        },
+        "interpolate": {
+          "$ref": "#/definitions/Interpolate",
+          "description": "The line interpolation method for the error band. One of the following:\n- `\"linear\"`: piecewise linear segments, as in a polyline.\n- `\"linear-closed\"`: close the linear segments to form a polygon.\n- `\"step\"`: a piecewise constant function (a step function) consisting of alternating horizontal and vertical lines. The y-value changes at the midpoint of each pair of adjacent x-values.\n- `\"step-before\"`: a piecewise constant function (a step function) consisting of alternating horizontal and vertical lines. The y-value changes before the x-value.\n- `\"step-after\"`: a piecewise constant function (a step function) consisting of alternating horizontal and vertical lines. The y-value changes after the x-value.\n- `\"basis\"`: a B-spline, with control point duplication on the ends.\n- `\"basis-open\"`: an open B-spline; may not intersect the start or end.\n- `\"basis-closed\"`: a closed B-spline, as in a loop.\n- `\"cardinal\"`: a Cardinal spline, with control point duplication on the ends.\n- `\"cardinal-open\"`: an open Cardinal spline; may not intersect the start or end, but will intersect other control points.\n- `\"cardinal-closed\"`: a closed Cardinal spline, as in a loop.\n- `\"bundle\"`: equivalent to basis, except the tension parameter is used to straighten the spline.\n- `\"monotone\"`: cubic interpolation that preserves monotonicity in y."
+        },
+        "tension": {
+          "description": "The tension parameter for the interpolation type of the error band.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "ErrorBandDef": {
+      "additionalProperties": false,
+      "properties": {
+        "band": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "borders": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "clip": {
+          "description": "Whether a composite mark be clipped to the enclosing group’s width and height.",
+          "type": "boolean"
+        },
+        "color": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default color.\n\n__Default value:__ <span style=\"color: #4682b4;\">&#9632;</span> `\"#4682b4\"`\n\n__Note:__\n- This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).\n- The `fill` and `stroke` properties have higher precedence than `color` and will override `color`."
+        },
+        "extent": {
+          "$ref": "#/definitions/ErrorBarExtent",
+          "description": "The extent of the band. Available options include:\n- `\"ci\"`: Extend the band to the confidence interval of the mean.\n- `\"stderr\"`: The size of band are set to the value of standard error, extending from the mean.\n- `\"stdev\"`: The size of band are set to the value of standard deviation, extending from the mean.\n- `\"iqr\"`: Extend the band to the q1 and q3.\n\n__Default value:__ `\"stderr\"`."
+        },
+        "interpolate": {
+          "$ref": "#/definitions/Interpolate",
+          "description": "The line interpolation method for the error band. One of the following:\n- `\"linear\"`: piecewise linear segments, as in a polyline.\n- `\"linear-closed\"`: close the linear segments to form a polygon.\n- `\"step\"`: a piecewise constant function (a step function) consisting of alternating horizontal and vertical lines. The y-value changes at the midpoint of each pair of adjacent x-values.\n- `\"step-before\"`: a piecewise constant function (a step function) consisting of alternating horizontal and vertical lines. The y-value changes before the x-value.\n- `\"step-after\"`: a piecewise constant function (a step function) consisting of alternating horizontal and vertical lines. The y-value changes after the x-value.\n- `\"basis\"`: a B-spline, with control point duplication on the ends.\n- `\"basis-open\"`: an open B-spline; may not intersect the start or end.\n- `\"basis-closed\"`: a closed B-spline, as in a loop.\n- `\"cardinal\"`: a Cardinal spline, with control point duplication on the ends.\n- `\"cardinal-open\"`: an open Cardinal spline; may not intersect the start or end, but will intersect other control points.\n- `\"cardinal-closed\"`: a closed Cardinal spline, as in a loop.\n- `\"bundle\"`: equivalent to basis, except the tension parameter is used to straighten the spline.\n- `\"monotone\"`: cubic interpolation that preserves monotonicity in y."
+        },
+        "opacity": {
+          "description": "The opacity (value between [0,1]) of the mark.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "orient": {
+          "$ref": "#/definitions/Orientation",
+          "description": "Orientation of the error band. This is normally automatically determined, but can be specified when the orientation is ambiguous and cannot be automatically determined."
+        },
+        "tension": {
+          "description": "The tension parameter for the interpolation type of the error band.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "type": {
+          "$ref": "#/definitions/ErrorBand",
+          "description": "The mark type. This could a primitive mark type (one of `\"bar\"`, `\"circle\"`, `\"square\"`, `\"tick\"`, `\"line\"`, `\"area\"`, `\"point\"`, `\"geoshape\"`, `\"rule\"`, and `\"text\"`) or a composite mark type (`\"boxplot\"`, `\"errorband\"`, `\"errorbar\"`)."
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "type": "object"
+    },
+    "ErrorBar": {
+      "const": "errorbar",
+      "type": "string"
+    },
+    "ErrorBarConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "extent": {
+          "$ref": "#/definitions/ErrorBarExtent",
+          "description": "The extent of the rule. Available options include:\n- `\"ci\"`: Extend the rule to the confidence interval of the mean.\n- `\"stderr\"`: The size of rule are set to the value of standard error, extending from the mean.\n- `\"stdev\"`: The size of rule are set to the value of standard deviation, extending from the mean.\n- `\"iqr\"`: Extend the rule to the q1 and q3.\n\n__Default value:__ `\"stderr\"`."
+        },
+        "rule": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "size": {
+          "description": "Size of the ticks of an error bar",
+          "type": "number"
+        },
+        "thickness": {
+          "description": "Thickness of the ticks and the bar of an error bar",
+          "type": "number"
+        },
+        "ticks": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "ErrorBarDef": {
+      "additionalProperties": false,
+      "properties": {
+        "clip": {
+          "description": "Whether a composite mark be clipped to the enclosing group’s width and height.",
+          "type": "boolean"
+        },
+        "color": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default color.\n\n__Default value:__ <span style=\"color: #4682b4;\">&#9632;</span> `\"#4682b4\"`\n\n__Note:__\n- This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).\n- The `fill` and `stroke` properties have higher precedence than `color` and will override `color`."
+        },
+        "extent": {
+          "$ref": "#/definitions/ErrorBarExtent",
+          "description": "The extent of the rule. Available options include:\n- `\"ci\"`: Extend the rule to the confidence interval of the mean.\n- `\"stderr\"`: The size of rule are set to the value of standard error, extending from the mean.\n- `\"stdev\"`: The size of rule are set to the value of standard deviation, extending from the mean.\n- `\"iqr\"`: Extend the rule to the q1 and q3.\n\n__Default value:__ `\"stderr\"`."
+        },
+        "opacity": {
+          "description": "The opacity (value between [0,1]) of the mark.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "orient": {
+          "$ref": "#/definitions/Orientation",
+          "description": "Orientation of the error bar. This is normally automatically determined, but can be specified when the orientation is ambiguous and cannot be automatically determined."
+        },
+        "rule": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "size": {
+          "description": "Size of the ticks of an error bar",
+          "type": "number"
+        },
+        "thickness": {
+          "description": "Thickness of the ticks and the bar of an error bar",
+          "type": "number"
+        },
+        "ticks": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/AnyMarkConfig"
+            }
+          ]
+        },
+        "type": {
+          "$ref": "#/definitions/ErrorBar",
+          "description": "The mark type. This could a primitive mark type (one of `\"bar\"`, `\"circle\"`, `\"square\"`, `\"tick\"`, `\"line\"`, `\"area\"`, `\"point\"`, `\"geoshape\"`, `\"rule\"`, and `\"text\"`) or a composite mark type (`\"boxplot\"`, `\"errorband\"`, `\"errorbar\"`)."
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "type": "object"
+    },
+    "ErrorBarExtent": {
+      "enum": [
+        "ci",
+        "iqr",
+        "stderr",
+        "stdev"
+      ],
+      "type": "string"
+    },
+    "EventStream": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "between": {
+              "items": {
+                "$ref": "#/definitions/Stream"
+              },
+              "type": "array"
+            },
+            "consume": {
+              "type": "boolean"
+            },
+            "debounce": {
+              "type": "number"
+            },
+            "filter": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Expr"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/Expr"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "markname": {
+              "type": "string"
+            },
+            "marktype": {
+              "$ref": "#/definitions/MarkType"
+            },
+            "source": {
+              "enum": [
+                "view",
+                "scope"
+              ],
+              "type": "string"
+            },
+            "throttle": {
+              "type": "number"
+            },
+            "type": {
+              "$ref": "#/definitions/EventType"
+            }
+          },
+          "required": [
+            "type"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "between": {
+              "items": {
+                "$ref": "#/definitions/Stream"
+              },
+              "type": "array"
+            },
+            "consume": {
+              "type": "boolean"
+            },
+            "debounce": {
+              "type": "number"
+            },
+            "filter": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Expr"
+                },
+                {
+                  "items": {
+                    "$ref": "#/definitions/Expr"
+                  },
+                  "type": "array"
+                }
+              ]
+            },
+            "markname": {
+              "type": "string"
+            },
+            "marktype": {
+              "$ref": "#/definitions/MarkType"
+            },
+            "source": {
+              "const": "window",
+              "type": "string"
+            },
+            "throttle": {
+              "type": "number"
+            },
+            "type": {
+              "$ref": "#/definitions/WindowEventType"
+            }
+          },
+          "required": [
+            "source",
+            "type"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "EventType": {
+      "enum": [
+        "click",
+        "dblclick",
+        "dragenter",
+        "dragleave",
+        "dragover",
+        "keydown",
+        "keypress",
+        "keyup",
+        "mousedown",
+        "mousemove",
+        "mouseout",
+        "mouseover",
+        "mouseup",
+        "mousewheel",
+        "pointerdown",
+        "pointermove",
+        "pointerout",
+        "pointerover",
+        "pointerup",
+        "timer",
+        "touchend",
+        "touchmove",
+        "touchstart",
+        "wheel"
+      ],
+      "type": "string"
+    },
+    "Expr": {
+      "type": "string"
+    },
+    "ExprRef": {
+      "additionalProperties": false,
+      "properties": {
+        "expr": {
+          "description": "Vega expression (which can refer to Vega-Lite parameters).",
+          "type": "string"
+        }
+      },
+      "required": [
+        "expr"
+      ],
+      "type": "object"
+    },
+    "ExtentTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "extent": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The field of which to get the extent."
+        },
+        "param": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "The output parameter produced by the extent transform."
+        }
+      },
+      "required": [
+        "extent",
+        "param"
+      ],
+      "type": "object"
+    },
+    "FacetEncodingFieldDef": {
+      "additionalProperties": false,
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayoutAlign"
+            },
+            {
+              "$ref": "#/definitions/RowCol<LayoutAlign>"
+            }
+          ],
+          "description": "The alignment to apply to grid rows and columns. The supported string values are `\"all\"`, `\"each\"`, and `\"none\"`.\n\n- For `\"none\"`, a flow layout will be used, in which adjacent subviews are simply placed one after the other.\n- For `\"each\"`, subviews will be aligned into a clean grid structure, but each row or column may be of variable size.\n- For `\"all\"`, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns.\n\nAlternatively, an object value of the form `{\"row\": string, \"column\": string}` can be used to supply different alignments for rows and columns.\n\n__Default value:__ `\"all\"`."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "bounds": {
+          "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+          "enum": [
+            "full",
+            "flush"
+          ],
+          "type": "string"
+        },
+        "center": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/RowCol<boolean>"
+            }
+          ],
+          "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\nAn object value of the form `{\"row\": boolean, \"column\": boolean}` can be used to supply different centering values for rows and columns.\n\n__Default value:__ `false`"
+        },
+        "columns": {
+          "description": "The number of columns to include in the view composition layout.\n\n__Default value__: `undefined` -- An infinite number of columns (a single row) will be assumed. This is equivalent to `hconcat` (for `concat`) and to using the `column` channel (for `facet` and `repeat`).\n\n__Note__:\n\n1) This property is only for:\n- the general (wrappable) `concat` operator (not `hconcat`/`vconcat`)\n- the `facet` and `repeat` operator with one field/repetition definition (without row/column nesting)\n\n2) Setting the `columns` to `1` is equivalent to `vconcat` (for `concat`) and to using the `row` channel (for `facet` and `repeat`).",
+          "type": "number"
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "header": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Header"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of a facet's header."
+        },
+        "sort": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SortArray"
+            },
+            {
+              "$ref": "#/definitions/SortOrder"
+            },
+            {
+              "$ref": "#/definitions/EncodingSortField"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` is not supported for `row` and `column`."
+        },
+        "spacing": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/RowCol<number>"
+            }
+          ],
+          "description": "The spacing in pixels between sub-views of the composition operator. An object of the form `{\"row\": number, \"column\": number}` can be used to set different spacing values for rows and columns.\n\n__Default value__: Depends on `\"spacing\"` property of [the view composition configuration](https://vega.github.io/vega-lite/docs/config.html#view-config) (`20` by default)"
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "FacetFieldDef": {
+      "additionalProperties": false,
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "header": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Header"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of a facet's header."
+        },
+        "sort": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SortArray"
+            },
+            {
+              "$ref": "#/definitions/SortOrder"
+            },
+            {
+              "$ref": "#/definitions/EncodingSortField"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` is not supported for `row` and `column`."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "FacetMapping": {
+      "additionalProperties": false,
+      "properties": {
+        "column": {
+          "$ref": "#/definitions/FacetFieldDef",
+          "description": "A field definition for the horizontal facet of trellis plots."
+        },
+        "row": {
+          "$ref": "#/definitions/FacetFieldDef",
+          "description": "A field definition for the vertical facet of trellis plots."
+        }
+      },
+      "type": "object"
+    },
+    "FacetedEncoding": {
+      "additionalProperties": false,
+      "properties": {
+        "angle": {
+          "$ref": "#/definitions/NumericMarkPropDef",
+          "description": "Rotation angle of point and text marks."
+        },
+        "color": {
+          "$ref": "#/definitions/ColorDef",
+          "description": "Color of the marks – either fill or stroke color based on  the `filled` property of mark definition. By default, `color` represents fill color for `\"area\"`, `\"bar\"`, `\"tick\"`, `\"text\"`, `\"trail\"`, `\"circle\"`, and `\"square\"` / stroke color for `\"line\"` and `\"point\"`.\n\n__Default value:__ If undefined, the default color depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `color` property.\n\n_Note:_ 1) For fine-grained control over both fill and stroke colors of the marks, please use the `fill` and `stroke` channels. The `fill` or `stroke` encodings have higher precedence than `color`, thus may override the `color` encoding if conflicting encodings are specified. 2) See the scale documentation for more information about customizing [color scheme](https://vega.github.io/vega-lite/docs/scale.html#scheme)."
+        },
+        "column": {
+          "$ref": "#/definitions/RowColumnEncodingFieldDef",
+          "description": "A field definition for the horizontal facet of trellis plots."
+        },
+        "description": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StringFieldDefWithCondition"
+            },
+            {
+              "$ref": "#/definitions/StringValueDefWithCondition"
+            }
+          ],
+          "description": "A text description of this mark for ARIA accessibility (SVG output only). For SVG output the `\"aria-label\"` attribute will be set to this description."
+        },
+        "detail": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FieldDefWithoutScale"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/FieldDefWithoutScale"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "Additional levels of detail for grouping data in aggregate views and in line, trail, and area marks without mapping data to a specific visual channel."
+        },
+        "facet": {
+          "$ref": "#/definitions/FacetEncodingFieldDef",
+          "description": "A field definition for the (flexible) facet of trellis plots.\n\nIf either `row` or `column` is specified, this channel will be ignored."
+        },
+        "fill": {
+          "$ref": "#/definitions/ColorDef",
+          "description": "Fill color of the marks. __Default value:__ If undefined, the default color depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `color` property.\n\n_Note:_ The `fill` encoding has higher precedence than `color`, thus may override the `color` encoding if conflicting encodings are specified."
+        },
+        "fillOpacity": {
+          "$ref": "#/definitions/NumericMarkPropDef",
+          "description": "Fill opacity of the marks.\n\n__Default value:__ If undefined, the default opacity depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `fillOpacity` property."
+        },
+        "href": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StringFieldDefWithCondition"
+            },
+            {
+              "$ref": "#/definitions/StringValueDefWithCondition"
+            }
+          ],
+          "description": "A URL to load upon mouse click."
+        },
+        "key": {
+          "$ref": "#/definitions/FieldDefWithoutScale",
+          "description": "A data field to use as a unique key for data binding. When a visualization’s data is updated, the key value will be used to match data elements to existing mark instances. Use a key channel to enable object constancy for transitions over dynamic data."
+        },
+        "latitude": {
+          "$ref": "#/definitions/LatLongDef",
+          "description": "Latitude position of geographically projected marks."
+        },
+        "latitude2": {
+          "$ref": "#/definitions/Position2Def",
+          "description": "Latitude-2 position for geographically projected ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`."
+        },
+        "longitude": {
+          "$ref": "#/definitions/LatLongDef",
+          "description": "Longitude position of geographically projected marks."
+        },
+        "longitude2": {
+          "$ref": "#/definitions/Position2Def",
+          "description": "Longitude-2 position for geographically projected ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`."
+        },
+        "opacity": {
+          "$ref": "#/definitions/NumericMarkPropDef",
+          "description": "Opacity of the marks.\n\n__Default value:__ If undefined, the default opacity depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `opacity` property."
+        },
+        "order": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/OrderFieldDef"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/OrderFieldDef"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/OrderValueDef"
+            },
+            {
+              "$ref": "#/definitions/OrderOnlyDef"
+            }
+          ],
+          "description": "Order of the marks.\n- For stacked marks, this `order` channel encodes [stack order](https://vega.github.io/vega-lite/docs/stack.html#order).\n- For line and trail marks, this `order` channel encodes order of data points in the lines. This can be useful for creating [a connected scatterplot](https://vega.github.io/vega-lite/examples/connected_scatterplot.html). Setting `order` to `{\"value\": null}` makes the line marks use the original order in the data sources.\n- Otherwise, this `order` channel encodes layer order of the marks.\n\n__Note__: In aggregate plots, `order` field should be `aggregate`d to avoid creating additional aggregation grouping."
+        },
+        "radius": {
+          "$ref": "#/definitions/PolarDef",
+          "description": "The outer radius in pixels of arc marks."
+        },
+        "radius2": {
+          "$ref": "#/definitions/Position2Def",
+          "description": "The inner radius in pixels of arc marks."
+        },
+        "row": {
+          "$ref": "#/definitions/RowColumnEncodingFieldDef",
+          "description": "A field definition for the vertical facet of trellis plots."
+        },
+        "shape": {
+          "$ref": "#/definitions/ShapeDef",
+          "description": "Shape of the mark.\n\n1. For `point` marks the supported values include:   - plotting shapes: `\"circle\"`, `\"square\"`, `\"cross\"`, `\"diamond\"`, `\"triangle-up\"`, `\"triangle-down\"`, `\"triangle-right\"`, or `\"triangle-left\"`.   - the line symbol `\"stroke\"`   - centered directional shapes `\"arrow\"`, `\"wedge\"`, or `\"triangle\"`   - a custom [SVG path string](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths) (For correct sizing, custom shape paths should be defined within a square bounding box with coordinates ranging from -1 to 1 along both the x and y dimensions.)\n\n2. For `geoshape` marks it should be a field definition of the geojson data\n\n__Default value:__ If undefined, the default shape depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#point-config)'s `shape` property. (`\"circle\"` if unset.)"
+        },
+        "size": {
+          "$ref": "#/definitions/NumericMarkPropDef",
+          "description": "Size of the mark.\n- For `\"point\"`, `\"square\"` and `\"circle\"`, – the symbol size, or pixel area of the mark.\n- For `\"bar\"` and `\"tick\"` – the bar and tick's size.\n- For `\"text\"` – the text's font size.\n- Size is unsupported for `\"line\"`, `\"area\"`, and `\"rect\"`. (Use `\"trail\"` instead of line with varying size)"
+        },
+        "stroke": {
+          "$ref": "#/definitions/ColorDef",
+          "description": "Stroke color of the marks. __Default value:__ If undefined, the default color depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `color` property.\n\n_Note:_ The `stroke` encoding has higher precedence than `color`, thus may override the `color` encoding if conflicting encodings are specified."
+        },
+        "strokeDash": {
+          "$ref": "#/definitions/NumericArrayMarkPropDef",
+          "description": "Stroke dash of the marks.\n\n__Default value:__ `[1,0]` (No dash)."
+        },
+        "strokeOpacity": {
+          "$ref": "#/definitions/NumericMarkPropDef",
+          "description": "Stroke opacity of the marks.\n\n__Default value:__ If undefined, the default opacity depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `strokeOpacity` property."
+        },
+        "strokeWidth": {
+          "$ref": "#/definitions/NumericMarkPropDef",
+          "description": "Stroke width of the marks.\n\n__Default value:__ If undefined, the default stroke width depends on [mark config](https://vega.github.io/vega-lite/docs/config.html#mark-config)'s `strokeWidth` property."
+        },
+        "text": {
+          "$ref": "#/definitions/TextDef",
+          "description": "Text of the `text` mark."
+        },
+        "theta": {
+          "$ref": "#/definitions/PolarDef",
+          "description": "- For arc marks, the arc length in radians if theta2 is not specified, otherwise the start arc angle. (A value of 0 indicates up or “north”, increasing values proceed clockwise.)\n\n- For text marks, polar coordinate angle in radians."
+        },
+        "theta2": {
+          "$ref": "#/definitions/Position2Def",
+          "description": "The end angle of arc marks in radians. A value of 0 indicates up or “north”, increasing values proceed clockwise."
+        },
+        "tooltip": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StringFieldDefWithCondition"
+            },
+            {
+              "$ref": "#/definitions/StringValueDefWithCondition"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/StringFieldDef"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The tooltip text to show upon mouse hover. Specifying `tooltip` encoding overrides [the `tooltip` property in the mark definition](https://vega.github.io/vega-lite/docs/mark.html#mark-def).\n\nSee the [`tooltip`](https://vega.github.io/vega-lite/docs/tooltip.html) documentation for a detailed discussion about tooltip in Vega-Lite."
+        },
+        "url": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StringFieldDefWithCondition"
+            },
+            {
+              "$ref": "#/definitions/StringValueDefWithCondition"
+            }
+          ],
+          "description": "The URL of an image mark."
+        },
+        "x": {
+          "$ref": "#/definitions/PositionDef",
+          "description": "X coordinates of the marks, or width of horizontal `\"bar\"` and `\"area\"` without specified `x2` or `width`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "x2": {
+          "$ref": "#/definitions/Position2Def",
+          "description": "X2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "xError": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SecondaryFieldDef"
+            },
+            {
+              "$ref": "#/definitions/ValueDef<number>"
+            }
+          ],
+          "description": "Error value of x coordinates for error specified `\"errorbar\"` and `\"errorband\"`."
+        },
+        "xError2": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SecondaryFieldDef"
+            },
+            {
+              "$ref": "#/definitions/ValueDef<number>"
+            }
+          ],
+          "description": "Secondary error value of x coordinates for error specified `\"errorbar\"` and `\"errorband\"`."
+        },
+        "xOffset": {
+          "$ref": "#/definitions/OffsetDef",
+          "description": "Offset of x-position of the marks"
+        },
+        "y": {
+          "$ref": "#/definitions/PositionDef",
+          "description": "Y coordinates of the marks, or height of vertical `\"bar\"` and `\"area\"` without specified `y2` or `height`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "y2": {
+          "$ref": "#/definitions/Position2Def",
+          "description": "Y2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "yError": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SecondaryFieldDef"
+            },
+            {
+              "$ref": "#/definitions/ValueDef<number>"
+            }
+          ],
+          "description": "Error value of y coordinates for error specified `\"errorbar\"` and `\"errorband\"`."
+        },
+        "yError2": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SecondaryFieldDef"
+            },
+            {
+              "$ref": "#/definitions/ValueDef<number>"
+            }
+          ],
+          "description": "Secondary error value of y coordinates for error specified `\"errorbar\"` and `\"errorband\"`."
+        },
+        "yOffset": {
+          "$ref": "#/definitions/OffsetDef",
+          "description": "Offset of y-position of the marks"
+        }
+      },
+      "type": "object"
+    },
+    "FacetedUnitSpec": {
+      "additionalProperties": false,
+      "description": "Unit spec that can have a composite mark and row or column channels (shorthand for a facet spec).",
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayoutAlign"
+            },
+            {
+              "$ref": "#/definitions/RowCol<LayoutAlign>"
+            }
+          ],
+          "description": "The alignment to apply to grid rows and columns. The supported string values are `\"all\"`, `\"each\"`, and `\"none\"`.\n\n- For `\"none\"`, a flow layout will be used, in which adjacent subviews are simply placed one after the other.\n- For `\"each\"`, subviews will be aligned into a clean grid structure, but each row or column may be of variable size.\n- For `\"all\"`, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns.\n\nAlternatively, an object value of the form `{\"row\": string, \"column\": string}` can be used to supply different alignments for rows and columns.\n\n__Default value:__ `\"all\"`."
+        },
+        "bounds": {
+          "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+          "enum": [
+            "full",
+            "flush"
+          ],
+          "type": "string"
+        },
+        "center": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/RowCol<boolean>"
+            }
+          ],
+          "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\nAn object value of the form `{\"row\": boolean, \"column\": boolean}` can be used to supply different centering values for rows and columns.\n\n__Default value:__ `false`"
+        },
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "encoding": {
+          "$ref": "#/definitions/FacetedEncoding",
+          "description": "A key-value mapping between encoding channels and definition of fields."
+        },
+        "height": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "container",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Step"
+            }
+          ],
+          "description": "The height of a visualization.\n\n- For a plot with a continuous y-field, height should be a number.\n- For a plot with either a discrete y-field or no y-field, height can be either a number indicating a fixed height or an object in the form of `{step: number}` defining the height per discrete step. (No y-field is equivalent to having one discrete step.)\n- To enable responsive sizing on height, it should be set to `\"container\"`.\n\n__Default value:__ Based on `config.view.continuousHeight` for a plot with a continuous y-field and `config.view.discreteHeight` otherwise.\n\n__Note:__ For plots with [`row` and `column` channels](https://vega.github.io/vega-lite/docs/encoding.html#facet), this represents the height of a single view and the `\"container\"` option cannot be used.\n\n__See also:__ [`height`](https://vega.github.io/vega-lite/docs/size.html) documentation."
+        },
+        "mark": {
+          "$ref": "#/definitions/AnyMark",
+          "description": "A string describing the mark type (one of `\"bar\"`, `\"circle\"`, `\"square\"`, `\"tick\"`, `\"line\"`, `\"area\"`, `\"point\"`, `\"rule\"`, `\"geoshape\"`, and `\"text\"`) or a [mark definition object](https://vega.github.io/vega-lite/docs/mark.html#mark-def)."
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "params": {
+          "description": "An array of parameters that may either be simple variables, or more complex selections that map user input to data queries.",
+          "items": {
+            "$ref": "#/definitions/SelectionParameter"
+          },
+          "type": "array"
+        },
+        "projection": {
+          "$ref": "#/definitions/Projection",
+          "description": "An object defining properties of geographic projection, which will be applied to `shape` path for `\"geoshape\"` marks and to `latitude` and `\"longitude\"` channels for other marks."
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "spacing": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/RowCol<number>"
+            }
+          ],
+          "description": "The spacing in pixels between sub-views of the composition operator. An object of the form `{\"row\": number, \"column\": number}` can be used to set different spacing values for rows and columns.\n\n__Default value__: Depends on `\"spacing\"` property of [the view composition configuration](https://vega.github.io/vega-lite/docs/config.html#view-config) (`20` by default)"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        },
+        "view": {
+          "$ref": "#/definitions/ViewBackground",
+          "description": "An object defining the view background's fill and stroke.\n\n__Default value:__ none (transparent)"
+        },
+        "width": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "container",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Step"
+            }
+          ],
+          "description": "The width of a visualization.\n\n- For a plot with a continuous x-field, width should be a number.\n- For a plot with either a discrete x-field or no x-field, width can be either a number indicating a fixed width or an object in the form of `{step: number}` defining the width per discrete step. (No x-field is equivalent to having one discrete step.)\n- To enable responsive sizing on width, it should be set to `\"container\"`.\n\n__Default value:__ Based on `config.view.continuousWidth` for a plot with a continuous x-field and `config.view.discreteWidth` otherwise.\n\n__Note:__ For plots with [`row` and `column` channels](https://vega.github.io/vega-lite/docs/encoding.html#facet), this represents the width of a single view and the `\"container\"` option cannot be used.\n\n__See also:__ [`width`](https://vega.github.io/vega-lite/docs/size.html) documentation."
+        }
+      },
+      "required": [
+        "mark"
+      ],
+      "type": "object"
+    },
+    "Feature": {
+      "additionalProperties": false,
+      "description": "A feature object which contains a geometry and associated properties. https://tools.ietf.org/html/rfc7946#section-3.2",
+      "properties": {
+        "bbox": {
+          "$ref": "#/definitions/BBox",
+          "description": "Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections. https://tools.ietf.org/html/rfc7946#section-5"
+        },
+        "geometry": {
+          "$ref": "#/definitions/Geometry",
+          "description": "The feature's geometry"
+        },
+        "id": {
+          "description": "A value that uniquely identifies this feature in a https://tools.ietf.org/html/rfc7946#section-3.2.",
+          "type": [
+            "string",
+            "number"
+          ]
+        },
+        "properties": {
+          "$ref": "#/definitions/GeoJsonProperties",
+          "description": "Properties associated with this feature."
+        },
+        "type": {
+          "const": "Feature",
+          "description": "Specifies the type of GeoJSON object.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "geometry",
+        "properties",
+        "type"
+      ],
+      "type": "object"
+    },
+    "Feature<Geometry,GeoJsonProperties>": {
+      "additionalProperties": false,
+      "description": "A feature object which contains a geometry and associated properties. https://tools.ietf.org/html/rfc7946#section-3.2",
+      "properties": {
+        "bbox": {
+          "$ref": "#/definitions/BBox",
+          "description": "Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections. https://tools.ietf.org/html/rfc7946#section-5"
+        },
+        "geometry": {
+          "$ref": "#/definitions/Geometry",
+          "description": "The feature's geometry"
+        },
+        "id": {
+          "description": "A value that uniquely identifies this feature in a https://tools.ietf.org/html/rfc7946#section-3.2.",
+          "type": [
+            "string",
+            "number"
+          ]
+        },
+        "properties": {
+          "$ref": "#/definitions/GeoJsonProperties",
+          "description": "Properties associated with this feature."
+        },
+        "type": {
+          "const": "Feature",
+          "description": "Specifies the type of GeoJSON object.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "geometry",
+        "properties",
+        "type"
+      ],
+      "type": "object"
+    },
+    "FeatureCollection": {
+      "additionalProperties": false,
+      "description": "A collection of feature objects.  https://tools.ietf.org/html/rfc7946#section-3.3",
+      "properties": {
+        "bbox": {
+          "$ref": "#/definitions/BBox",
+          "description": "Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections. https://tools.ietf.org/html/rfc7946#section-5"
+        },
+        "features": {
+          "items": {
+            "$ref": "#/definitions/Feature<Geometry,GeoJsonProperties>"
+          },
+          "type": "array"
+        },
+        "type": {
+          "const": "FeatureCollection",
+          "description": "Specifies the type of GeoJSON object.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "features",
+        "type"
+      ],
+      "type": "object"
+    },
+    "Field": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/FieldName"
+        },
+        {
+          "$ref": "#/definitions/RepeatRef"
+        }
+      ]
+    },
+    "FieldDefWithoutScale": {
+      "$ref": "#/definitions/TypedFieldDef",
+      "description": "Field Def without scale (and without bin: \"binned\" support)."
+    },
+    "FieldEqualPredicate": {
+      "additionalProperties": false,
+      "properties": {
+        "equal": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The value that the field should be equal to."
+        },
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "Field to be tested."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit for the field to be tested."
+        }
+      },
+      "required": [
+        "equal",
+        "field"
+      ],
+      "type": "object"
+    },
+    "FieldGTEPredicate": {
+      "additionalProperties": false,
+      "properties": {
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "Field to be tested."
+        },
+        "gte": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The value that the field should be greater than or equals to."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit for the field to be tested."
+        }
+      },
+      "required": [
+        "field",
+        "gte"
+      ],
+      "type": "object"
+    },
+    "FieldGTPredicate": {
+      "additionalProperties": false,
+      "properties": {
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "Field to be tested."
+        },
+        "gt": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The value that the field should be greater than."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit for the field to be tested."
+        }
+      },
+      "required": [
+        "field",
+        "gt"
+      ],
+      "type": "object"
+    },
+    "FieldLTEPredicate": {
+      "additionalProperties": false,
+      "properties": {
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "Field to be tested."
+        },
+        "lte": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The value that the field should be less than or equals to."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit for the field to be tested."
+        }
+      },
+      "required": [
+        "field",
+        "lte"
+      ],
+      "type": "object"
+    },
+    "FieldLTPredicate": {
+      "additionalProperties": false,
+      "properties": {
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "Field to be tested."
+        },
+        "lt": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The value that the field should be less than."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit for the field to be tested."
+        }
+      },
+      "required": [
+        "field",
+        "lt"
+      ],
+      "type": "object"
+    },
+    "FieldName": {
+      "type": "string"
+    },
+    "FieldOneOfPredicate": {
+      "additionalProperties": false,
+      "properties": {
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "Field to be tested."
+        },
+        "oneOf": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            {
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "items": {
+                "type": "boolean"
+              },
+              "type": "array"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/DateTime"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "A set of values that the `field`'s value should be a member of, for a data item included in the filtered data."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit for the field to be tested."
+        }
+      },
+      "required": [
+        "field",
+        "oneOf"
+      ],
+      "type": "object"
+    },
+    "FieldOrDatumDefWithCondition<DatumDef,(Gradient|string|null)>": {
+      "additionalProperties": false,
+      "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
+      "properties": {
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+        },
+        "datum": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PrimitiveValue"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/RepeatRef"
+            }
+          ],
+          "description": "A constant value in data domain."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/Type",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "FieldOrDatumDefWithCondition<DatumDef,(string|null)>": {
+      "additionalProperties": false,
+      "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
+      "properties": {
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+        },
+        "datum": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PrimitiveValue"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/RepeatRef"
+            }
+          ],
+          "description": "A constant value in data domain."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/Type",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "FieldOrDatumDefWithCondition<DatumDef,number>": {
+      "additionalProperties": false,
+      "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
+      "properties": {
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+        },
+        "datum": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PrimitiveValue"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/RepeatRef"
+            }
+          ],
+          "description": "A constant value in data domain."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/Type",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "FieldOrDatumDefWithCondition<DatumDef,number[]>": {
+      "additionalProperties": false,
+      "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
+      "properties": {
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(number[]|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(number[]|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+        },
+        "datum": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PrimitiveValue"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/RepeatRef"
+            }
+          ],
+          "description": "A constant value in data domain."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/Type",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "FieldOrDatumDefWithCondition<MarkPropFieldDef,(Gradient|string|null)>": {
+      "additionalProperties": false,
+      "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "legend": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Legend"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+        },
+        "scale": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scale"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+        },
+        "sort": {
+          "$ref": "#/definitions/Sort",
+          "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "FieldOrDatumDefWithCondition<MarkPropFieldDef,number>": {
+      "additionalProperties": false,
+      "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "legend": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Legend"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+        },
+        "scale": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scale"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+        },
+        "sort": {
+          "$ref": "#/definitions/Sort",
+          "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "FieldOrDatumDefWithCondition<MarkPropFieldDef,number[]>": {
+      "additionalProperties": false,
+      "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(number[]|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(number[]|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "legend": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Legend"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+        },
+        "scale": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scale"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+        },
+        "sort": {
+          "$ref": "#/definitions/Sort",
+          "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "FieldOrDatumDefWithCondition<MarkPropFieldDef<TypeForShape>,(string|null)>": {
+      "additionalProperties": false,
+      "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "legend": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Legend"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+        },
+        "scale": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scale"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+        },
+        "sort": {
+          "$ref": "#/definitions/Sort",
+          "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/TypeForShape",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "FieldOrDatumDefWithCondition<StringDatumDef,Text>": {
+      "additionalProperties": false,
+      "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
+      "properties": {
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(Text|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(Text|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+        },
+        "datum": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PrimitiveValue"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/RepeatRef"
+            }
+          ],
+          "description": "A constant value in data domain."
+        },
+        "format": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Dict"
+            }
+          ],
+          "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+        },
+        "formatType": {
+          "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+          "type": "string"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/Type",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "FieldOrDatumDefWithCondition<StringFieldDef,Text>": {
+      "additionalProperties": false,
+      "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "const": "binned",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(Text|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(Text|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "format": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Dict"
+            }
+          ],
+          "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+        },
+        "formatType": {
+          "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+          "type": "string"
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "FieldOrDatumDefWithCondition<StringFieldDef,string>": {
+      "additionalProperties": false,
+      "description": "A FieldDef with Condition<ValueDef> {   condition: {value: ...},   field: ...,   ... }",
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "const": "binned",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(string|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(string|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "format": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Dict"
+            }
+          ],
+          "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+        },
+        "formatType": {
+          "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+          "type": "string"
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "FieldRange": {
+      "additionalProperties": false,
+      "properties": {
+        "field": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "field"
+      ],
+      "type": "object"
+    },
+    "FieldRangePredicate": {
+      "additionalProperties": false,
+      "properties": {
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "Field to be tested."
+        },
+        "range": {
+          "anyOf": [
+            {
+              "items": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "$ref": "#/definitions/DateTime"
+                  },
+                  {
+                    "type": "null"
+                  },
+                  {
+                    "$ref": "#/definitions/ExprRef"
+                  }
+                ]
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "An array of inclusive minimum and maximum values for a field value of a data item to be included in the filtered data.",
+          "maxItems": 2,
+          "minItems": 2
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit for the field to be tested."
+        }
+      },
+      "required": [
+        "field",
+        "range"
+      ],
+      "type": "object"
+    },
+    "FieldValidPredicate": {
+      "additionalProperties": false,
+      "properties": {
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "Field to be tested."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit for the field to be tested."
+        },
+        "valid": {
+          "description": "If set to true the field's value has to be valid, meaning both not `null` and not [`NaN`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/NaN).",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "field",
+        "valid"
+      ],
+      "type": "object"
+    },
+    "FilterTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "filter": {
+          "$ref": "#/definitions/PredicateComposition",
+          "description": "The `filter` property must be a predication definition, which can take one of the following forms:\n\n1) an [expression](https://vega.github.io/vega-lite/docs/types.html#expression) string, where `datum` can be used to refer to the current data object. For example, `{filter: \"datum.b2 > 60\"}` would make the output data includes only items that have values in the field `b2` over 60.\n\n2) one of the [field predicates](https://vega.github.io/vega-lite/docs/predicate.html#field-predicate): [`equal`](https://vega.github.io/vega-lite/docs/predicate.html#field-equal-predicate), [`lt`](https://vega.github.io/vega-lite/docs/predicate.html#lt-predicate), [`lte`](https://vega.github.io/vega-lite/docs/predicate.html#lte-predicate), [`gt`](https://vega.github.io/vega-lite/docs/predicate.html#gt-predicate), [`gte`](https://vega.github.io/vega-lite/docs/predicate.html#gte-predicate), [`range`](https://vega.github.io/vega-lite/docs/predicate.html#range-predicate), [`oneOf`](https://vega.github.io/vega-lite/docs/predicate.html#one-of-predicate), or [`valid`](https://vega.github.io/vega-lite/docs/predicate.html#valid-predicate),\n\n3) a [selection predicate](https://vega.github.io/vega-lite/docs/predicate.html#selection-predicate), which define the names of a selection that the data point should belong to (or a logical composition of selections).\n\n4) a [logical composition](https://vega.github.io/vega-lite/docs/predicate.html#composition) of (1), (2), or (3)."
+        }
+      },
+      "required": [
+        "filter"
+      ],
+      "type": "object"
+    },
+    "Fit": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/GeoJsonFeature"
+        },
+        {
+          "$ref": "#/definitions/GeoJsonFeatureCollection"
+        },
+        {
+          "items": {
+            "$ref": "#/definitions/GeoJsonFeature"
+          },
+          "type": "array"
+        }
+      ]
+    },
+    "FlattenTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "description": "The output field names for extracted array values.\n\n__Default value:__ The field name of the corresponding array field",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "flatten": {
+          "description": "An array of one or more data fields containing arrays to flatten. If multiple fields are specified, their array values should have a parallel structure, ideally with the same length. If the lengths of parallel arrays do not match, the longest array will be used with `null` values added for missing entries.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "flatten"
+      ],
+      "type": "object"
+    },
+    "FoldTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "description": "The output field names for the key and value properties produced by the fold transform. __Default value:__ `[\"key\", \"value\"]`",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "maxItems": 2,
+          "minItems": 2,
+          "type": "array"
+        },
+        "fold": {
+          "description": "An array of data fields indicating the properties to fold.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "fold"
+      ],
+      "type": "object"
+    },
+    "FontStyle": {
+      "type": "string"
+    },
+    "FontWeight": {
+      "enum": [
+        "normal",
+        "bold",
+        "lighter",
+        "bolder",
+        100,
+        200,
+        300,
+        400,
+        500,
+        600,
+        700,
+        800,
+        900
+      ],
+      "type": [
+        "string",
+        "number"
+      ]
+    },
+    "FormatConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "normalizedNumberFormat": {
+          "description": "If normalizedNumberFormatType is not specified, D3 number format for axis labels, text marks, and tooltips of normalized stacked fields (fields with `stack: \"normalize\"`). For example `\"s\"` for SI units. Use [D3's number format pattern](https://github.com/d3/d3-format#locale_format).\n\nIf `config.normalizedNumberFormatType` is specified and `config.customFormatTypes` is `true`, this value will be passed as `format` alongside `datum.value` to the `config.numberFormatType` function. __Default value:__ `%`",
+          "type": "string"
+        },
+        "normalizedNumberFormatType": {
+          "description": "[Custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type) for `config.normalizedNumberFormat`.\n\n__Default value:__ `undefined` -- This is equilvalent to call D3-format, which is exposed as [`format` in Vega-Expression](https://vega.github.io/vega/docs/expressions/#format). __Note:__ You must also set `customFormatTypes` to `true` to use this feature.",
+          "type": "string"
+        },
+        "numberFormat": {
+          "description": "If numberFormatType is not specified, D3 number format for guide labels, text marks, and tooltips of non-normalized fields (fields *without* `stack: \"normalize\"`). For example `\"s\"` for SI units. Use [D3's number format pattern](https://github.com/d3/d3-format#locale_format).\n\nIf `config.numberFormatType` is specified and `config.customFormatTypes` is `true`, this value will be passed as `format` alongside `datum.value` to the `config.numberFormatType` function.",
+          "type": "string"
+        },
+        "numberFormatType": {
+          "description": "[Custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type) for `config.numberFormat`.\n\n__Default value:__ `undefined` -- This is equilvalent to call D3-format, which is exposed as [`format` in Vega-Expression](https://vega.github.io/vega/docs/expressions/#format). __Note:__ You must also set `customFormatTypes` to `true` to use this feature.",
+          "type": "string"
+        },
+        "timeFormat": {
+          "description": "Default time format for raw time values (without time units) in text marks, legend labels and header labels.\n\n__Default value:__ `\"%b %d, %Y\"` __Note:__ Axes automatically determine the format for each label automatically so this config does not affect axes.",
+          "type": "string"
+        },
+        "timeFormatType": {
+          "description": "[Custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type) for `config.timeFormat`.\n\n__Default value:__ `undefined` -- This is equilvalent to call D3-time-format, which is exposed as [`timeFormat` in Vega-Expression](https://vega.github.io/vega/docs/expressions/#timeFormat). __Note:__ You must also set `customFormatTypes` to `true` and there must *not* be a `timeUnit` defined to use this feature.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "Generator": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/SequenceGenerator"
+        },
+        {
+          "$ref": "#/definitions/SphereGenerator"
+        },
+        {
+          "$ref": "#/definitions/GraticuleGenerator"
+        }
+      ]
+    },
+    "ConcatSpec<GenericSpec>": {
+      "additionalProperties": false,
+      "description": "Base interface for a generalized concatenation specification.",
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayoutAlign"
+            },
+            {
+              "$ref": "#/definitions/RowCol<LayoutAlign>"
+            }
+          ],
+          "description": "The alignment to apply to grid rows and columns. The supported string values are `\"all\"`, `\"each\"`, and `\"none\"`.\n\n- For `\"none\"`, a flow layout will be used, in which adjacent subviews are simply placed one after the other.\n- For `\"each\"`, subviews will be aligned into a clean grid structure, but each row or column may be of variable size.\n- For `\"all\"`, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns.\n\nAlternatively, an object value of the form `{\"row\": string, \"column\": string}` can be used to supply different alignments for rows and columns.\n\n__Default value:__ `\"all\"`."
+        },
+        "bounds": {
+          "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+          "enum": [
+            "full",
+            "flush"
+          ],
+          "type": "string"
+        },
+        "center": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/RowCol<boolean>"
+            }
+          ],
+          "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\nAn object value of the form `{\"row\": boolean, \"column\": boolean}` can be used to supply different centering values for rows and columns.\n\n__Default value:__ `false`"
+        },
+        "columns": {
+          "description": "The number of columns to include in the view composition layout.\n\n__Default value__: `undefined` -- An infinite number of columns (a single row) will be assumed. This is equivalent to `hconcat` (for `concat`) and to using the `column` channel (for `facet` and `repeat`).\n\n__Note__:\n\n1) This property is only for:\n- the general (wrappable) `concat` operator (not `hconcat`/`vconcat`)\n- the `facet` and `repeat` operator with one field/repetition definition (without row/column nesting)\n\n2) Setting the `columns` to `1` is equivalent to `vconcat` (for `concat`) and to using the `row` channel (for `facet` and `repeat`).",
+          "type": "number"
+        },
+        "concat": {
+          "description": "A list of views to be concatenated.",
+          "items": {
+            "$ref": "#/definitions/Spec"
+          },
+          "type": "array"
+        },
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "spacing": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/RowCol<number>"
+            }
+          ],
+          "description": "The spacing in pixels between sub-views of the composition operator. An object of the form `{\"row\": number, \"column\": number}` can be used to set different spacing values for rows and columns.\n\n__Default value__: Depends on `\"spacing\"` property of [the view composition configuration](https://vega.github.io/vega-lite/docs/config.html#view-config) (`20` by default)"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "concat"
+      ],
+      "type": "object"
+    },
+    "FacetSpec": {
+      "additionalProperties": false,
+      "description": "Base interface for a facet specification.",
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayoutAlign"
+            },
+            {
+              "$ref": "#/definitions/RowCol<LayoutAlign>"
+            }
+          ],
+          "description": "The alignment to apply to grid rows and columns. The supported string values are `\"all\"`, `\"each\"`, and `\"none\"`.\n\n- For `\"none\"`, a flow layout will be used, in which adjacent subviews are simply placed one after the other.\n- For `\"each\"`, subviews will be aligned into a clean grid structure, but each row or column may be of variable size.\n- For `\"all\"`, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns.\n\nAlternatively, an object value of the form `{\"row\": string, \"column\": string}` can be used to supply different alignments for rows and columns.\n\n__Default value:__ `\"all\"`."
+        },
+        "bounds": {
+          "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+          "enum": [
+            "full",
+            "flush"
+          ],
+          "type": "string"
+        },
+        "center": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/RowCol<boolean>"
+            }
+          ],
+          "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\nAn object value of the form `{\"row\": boolean, \"column\": boolean}` can be used to supply different centering values for rows and columns.\n\n__Default value:__ `false`"
+        },
+        "columns": {
+          "description": "The number of columns to include in the view composition layout.\n\n__Default value__: `undefined` -- An infinite number of columns (a single row) will be assumed. This is equivalent to `hconcat` (for `concat`) and to using the `column` channel (for `facet` and `repeat`).\n\n__Note__:\n\n1) This property is only for:\n- the general (wrappable) `concat` operator (not `hconcat`/`vconcat`)\n- the `facet` and `repeat` operator with one field/repetition definition (without row/column nesting)\n\n2) Setting the `columns` to `1` is equivalent to `vconcat` (for `concat`) and to using the `row` channel (for `facet` and `repeat`).",
+          "type": "number"
+        },
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "facet": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FacetFieldDef"
+            },
+            {
+              "$ref": "#/definitions/FacetMapping"
+            }
+          ],
+          "description": "Definition for how to facet the data. One of: 1) [a field definition for faceting the plot by one field](https://vega.github.io/vega-lite/docs/facet.html#field-def) 2) [An object that maps `row` and `column` channels to their field definitions](https://vega.github.io/vega-lite/docs/facet.html#mapping)"
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "spacing": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/RowCol<number>"
+            }
+          ],
+          "description": "The spacing in pixels between sub-views of the composition operator. An object of the form `{\"row\": number, \"column\": number}` can be used to set different spacing values for rows and columns.\n\n__Default value__: Depends on `\"spacing\"` property of [the view composition configuration](https://vega.github.io/vega-lite/docs/config.html#view-config) (`20` by default)"
+        },
+        "spec": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayerSpec"
+            },
+            {
+              "$ref": "#/definitions/FacetedUnitSpec"
+            }
+          ],
+          "description": "A specification of the view that gets faceted."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "facet",
+        "spec"
+      ],
+      "type": "object"
+    },
+    "HConcatSpec<GenericSpec>": {
+      "additionalProperties": false,
+      "description": "Base interface for a horizontal concatenation specification.",
+      "properties": {
+        "bounds": {
+          "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+          "enum": [
+            "full",
+            "flush"
+          ],
+          "type": "string"
+        },
+        "center": {
+          "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\n__Default value:__ `false`",
+          "type": "boolean"
+        },
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "hconcat": {
+          "description": "A list of views to be concatenated and put into a row.",
+          "items": {
+            "$ref": "#/definitions/Spec"
+          },
+          "type": "array"
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "spacing": {
+          "description": "The spacing in pixels between sub-views of the concat operator.\n\n__Default value__: `10`",
+          "type": "number"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "hconcat"
+      ],
+      "type": "object"
+    },
+    "Spec": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/FacetedUnitSpec"
+        },
+        {
+          "$ref": "#/definitions/LayerSpec"
+        },
+        {
+          "$ref": "#/definitions/RepeatSpec"
+        },
+        {
+          "$ref": "#/definitions/FacetSpec"
+        },
+        {
+          "$ref": "#/definitions/ConcatSpec<GenericSpec>"
+        },
+        {
+          "$ref": "#/definitions/VConcatSpec<GenericSpec>"
+        },
+        {
+          "$ref": "#/definitions/HConcatSpec<GenericSpec>"
+        }
+      ],
+      "description": "Any specification in Vega-Lite."
+    },
+    "GenericUnitSpec<Encoding,AnyMark>": {
+      "additionalProperties": false,
+      "description": "Base interface for a unit (single-view) specification.",
+      "properties": {
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "encoding": {
+          "$ref": "#/definitions/Encoding",
+          "description": "A key-value mapping between encoding channels and definition of fields."
+        },
+        "mark": {
+          "$ref": "#/definitions/AnyMark",
+          "description": "A string describing the mark type (one of `\"bar\"`, `\"circle\"`, `\"square\"`, `\"tick\"`, `\"line\"`, `\"area\"`, `\"point\"`, `\"rule\"`, `\"geoshape\"`, and `\"text\"`) or a [mark definition object](https://vega.github.io/vega-lite/docs/mark.html#mark-def)."
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "params": {
+          "description": "An array of parameters that may either be simple variables, or more complex selections that map user input to data queries.",
+          "items": {
+            "$ref": "#/definitions/SelectionParameter"
+          },
+          "type": "array"
+        },
+        "projection": {
+          "$ref": "#/definitions/Projection",
+          "description": "An object defining properties of geographic projection, which will be applied to `shape` path for `\"geoshape\"` marks and to `latitude` and `\"longitude\"` channels for other marks."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "mark"
+      ],
+      "type": "object"
+    },
+    "VConcatSpec<GenericSpec>": {
+      "additionalProperties": false,
+      "description": "Base interface for a vertical concatenation specification.",
+      "properties": {
+        "bounds": {
+          "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+          "enum": [
+            "full",
+            "flush"
+          ],
+          "type": "string"
+        },
+        "center": {
+          "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\n__Default value:__ `false`",
+          "type": "boolean"
+        },
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "spacing": {
+          "description": "The spacing in pixels between sub-views of the concat operator.\n\n__Default value__: `10`",
+          "type": "number"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        },
+        "vconcat": {
+          "description": "A list of views to be concatenated and put into a column.",
+          "items": {
+            "$ref": "#/definitions/Spec"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "vconcat"
+      ],
+      "type": "object"
+    },
+    "GeoJsonFeature": {
+      "$ref": "#/definitions/Feature"
+    },
+    "GeoJsonFeatureCollection": {
+      "$ref": "#/definitions/FeatureCollection"
+    },
+    "GeoJsonProperties": {
+      "anyOf": [
+        {
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "Geometry": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/Point"
+        },
+        {
+          "$ref": "#/definitions/MultiPoint"
+        },
+        {
+          "$ref": "#/definitions/LineString"
+        },
+        {
+          "$ref": "#/definitions/MultiLineString"
+        },
+        {
+          "$ref": "#/definitions/Polygon"
+        },
+        {
+          "$ref": "#/definitions/MultiPolygon"
+        },
+        {
+          "$ref": "#/definitions/GeometryCollection"
+        }
+      ],
+      "description": "Union of geometry objects. https://tools.ietf.org/html/rfc7946#section-3"
+    },
+    "GeometryCollection": {
+      "additionalProperties": false,
+      "description": "Geometry Collection https://tools.ietf.org/html/rfc7946#section-3.1.8",
+      "properties": {
+        "bbox": {
+          "$ref": "#/definitions/BBox",
+          "description": "Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections. https://tools.ietf.org/html/rfc7946#section-5"
+        },
+        "geometries": {
+          "items": {
+            "$ref": "#/definitions/Geometry"
+          },
+          "type": "array"
+        },
+        "type": {
+          "const": "GeometryCollection",
+          "description": "Specifies the type of GeoJSON object.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "geometries",
+        "type"
+      ],
+      "type": "object"
+    },
+    "Gradient": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/LinearGradient"
+        },
+        {
+          "$ref": "#/definitions/RadialGradient"
+        }
+      ]
+    },
+    "GradientStop": {
+      "additionalProperties": false,
+      "properties": {
+        "color": {
+          "$ref": "#/definitions/Color",
+          "description": "The color value at this point in the gradient."
+        },
+        "offset": {
+          "description": "The offset fraction for the color stop, indicating its position within the gradient.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "offset",
+        "color"
+      ],
+      "type": "object"
+    },
+    "GraticuleGenerator": {
+      "additionalProperties": false,
+      "properties": {
+        "graticule": {
+          "anyOf": [
+            {
+              "const": true,
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/GraticuleParams"
+            }
+          ],
+          "description": "Generate graticule GeoJSON data for geographic reference lines."
+        },
+        "name": {
+          "description": "Provide a placeholder name and bind data at runtime.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "graticule"
+      ],
+      "type": "object"
+    },
+    "GraticuleParams": {
+      "additionalProperties": false,
+      "properties": {
+        "extent": {
+          "$ref": "#/definitions/Vector2<Vector2<number>>",
+          "description": "Sets both the major and minor extents to the same values."
+        },
+        "extentMajor": {
+          "$ref": "#/definitions/Vector2<Vector2<number>>",
+          "description": "The major extent of the graticule as a two-element array of coordinates."
+        },
+        "extentMinor": {
+          "$ref": "#/definitions/Vector2<Vector2<number>>",
+          "description": "The minor extent of the graticule as a two-element array of coordinates."
+        },
+        "precision": {
+          "description": "The precision of the graticule in degrees.\n\n__Default value:__ `2.5`",
+          "type": "number"
+        },
+        "step": {
+          "$ref": "#/definitions/Vector2<number>",
+          "description": "Sets both the major and minor step angles to the same values."
+        },
+        "stepMajor": {
+          "$ref": "#/definitions/Vector2<number>",
+          "description": "The major step angles of the graticule.\n\n\n__Default value:__ `[90, 360]`"
+        },
+        "stepMinor": {
+          "$ref": "#/definitions/Vector2<number>",
+          "description": "The minor step angles of the graticule.\n\n__Default value:__ `[10, 10]`"
+        }
+      },
+      "type": "object"
+    },
+    "Header": {
+      "additionalProperties": false,
+      "description": "Headers of row / column channels for faceted plots.",
+      "properties": {
+        "format": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Dict"
+            }
+          ],
+          "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+        },
+        "formatType": {
+          "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+          "type": "string"
+        },
+        "labelAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Horizontal text alignment of header labels. One of `\"left\"`, `\"center\"`, or `\"right\"`."
+        },
+        "labelAnchor": {
+          "$ref": "#/definitions/TitleAnchor",
+          "description": "The anchor position for placing the labels. One of `\"start\"`, `\"middle\"`, or `\"end\"`. For example, with a label orientation of top these anchor positions map to a left-, center-, or right-aligned label."
+        },
+        "labelAngle": {
+          "description": "The rotation angle of the header labels.\n\n__Default value:__ `0` for column header, `-90` for row header.",
+          "maximum": 360,
+          "minimum": -360,
+          "type": "number"
+        },
+        "labelBaseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The vertical text baseline for the header labels. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, or `\"line-bottom\"`. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the `titleLineHeight` rather than `titleFontSize` alone."
+        },
+        "labelColor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The color of the header label, can be in hex color code or regular color name."
+        },
+        "labelExpr": {
+          "description": "[Vega expression](https://vega.github.io/vega/docs/expressions/) for customizing labels.\n\n__Note:__ The label text and value can be assessed via the `label` and `value` properties of the header's backing `datum` object.",
+          "type": "string"
+        },
+        "labelFont": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The font of the header label."
+        },
+        "labelFontSize": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The font size of the header label, in pixels.",
+          "minimum": 0
+        },
+        "labelFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The font style of the header label."
+        },
+        "labelFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The font weight of the header label."
+        },
+        "labelLimit": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The maximum length of the header label in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.\n\n__Default value:__ `0`, indicating no limit"
+        },
+        "labelLineHeight": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Line height in pixels for multi-line header labels or title text with `\"line-top\"` or `\"line-bottom\"` baseline."
+        },
+        "labelOrient": {
+          "$ref": "#/definitions/Orient",
+          "description": "The orientation of the header label. One of `\"top\"`, `\"bottom\"`, `\"left\"` or `\"right\"`."
+        },
+        "labelPadding": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The padding, in pixel, between facet header's label and the plot.\n\n__Default value:__ `10`"
+        },
+        "labels": {
+          "description": "A boolean flag indicating if labels should be included as part of the header.\n\n__Default value:__ `true`.",
+          "type": "boolean"
+        },
+        "orient": {
+          "$ref": "#/definitions/Orient",
+          "description": "Shortcut for setting both labelOrient and titleOrient."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "titleAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Horizontal text alignment (to the anchor) of header titles."
+        },
+        "titleAnchor": {
+          "$ref": "#/definitions/TitleAnchor",
+          "description": "The anchor position for placing the title. One of `\"start\"`, `\"middle\"`, or `\"end\"`. For example, with an orientation of top these anchor positions map to a left-, center-, or right-aligned title."
+        },
+        "titleAngle": {
+          "description": "The rotation angle of the header title.\n\n__Default value:__ `0`.",
+          "maximum": 360,
+          "minimum": -360,
+          "type": "number"
+        },
+        "titleBaseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The vertical text baseline for the header title. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, or `\"line-bottom\"`. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the `titleLineHeight` rather than `titleFontSize` alone.\n\n__Default value:__ `\"middle\"`"
+        },
+        "titleColor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Color of the header title, can be in hex color code or regular color name."
+        },
+        "titleFont": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Font of the header title. (e.g., `\"Helvetica Neue\"`)."
+        },
+        "titleFontSize": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Font size of the header title.",
+          "minimum": 0
+        },
+        "titleFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The font style of the header title."
+        },
+        "titleFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Font weight of the header title. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+        },
+        "titleLimit": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The maximum length of the header title in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.\n\n__Default value:__ `0`, indicating no limit"
+        },
+        "titleLineHeight": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Line height in pixels for multi-line header title text or title text with `\"line-top\"` or `\"line-bottom\"` baseline."
+        },
+        "titleOrient": {
+          "$ref": "#/definitions/Orient",
+          "description": "The orientation of the header title. One of `\"top\"`, `\"bottom\"`, `\"left\"` or `\"right\"`."
+        },
+        "titlePadding": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The padding, in pixel, between facet header's title and the label.\n\n__Default value:__ `10`"
+        }
+      },
+      "type": "object"
+    },
+    "HeaderConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "format": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Dict"
+            }
+          ],
+          "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+        },
+        "formatType": {
+          "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+          "type": "string"
+        },
+        "labelAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Horizontal text alignment of header labels. One of `\"left\"`, `\"center\"`, or `\"right\"`."
+        },
+        "labelAnchor": {
+          "$ref": "#/definitions/TitleAnchor",
+          "description": "The anchor position for placing the labels. One of `\"start\"`, `\"middle\"`, or `\"end\"`. For example, with a label orientation of top these anchor positions map to a left-, center-, or right-aligned label."
+        },
+        "labelAngle": {
+          "description": "The rotation angle of the header labels.\n\n__Default value:__ `0` for column header, `-90` for row header.",
+          "maximum": 360,
+          "minimum": -360,
+          "type": "number"
+        },
+        "labelBaseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The vertical text baseline for the header labels. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, or `\"line-bottom\"`. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the `titleLineHeight` rather than `titleFontSize` alone."
+        },
+        "labelColor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The color of the header label, can be in hex color code or regular color name."
+        },
+        "labelExpr": {
+          "description": "[Vega expression](https://vega.github.io/vega/docs/expressions/) for customizing labels.\n\n__Note:__ The label text and value can be assessed via the `label` and `value` properties of the header's backing `datum` object.",
+          "type": "string"
+        },
+        "labelFont": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The font of the header label."
+        },
+        "labelFontSize": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The font size of the header label, in pixels.",
+          "minimum": 0
+        },
+        "labelFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The font style of the header label."
+        },
+        "labelFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The font weight of the header label."
+        },
+        "labelLimit": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The maximum length of the header label in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.\n\n__Default value:__ `0`, indicating no limit"
+        },
+        "labelLineHeight": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Line height in pixels for multi-line header labels or title text with `\"line-top\"` or `\"line-bottom\"` baseline."
+        },
+        "labelOrient": {
+          "$ref": "#/definitions/Orient",
+          "description": "The orientation of the header label. One of `\"top\"`, `\"bottom\"`, `\"left\"` or `\"right\"`."
+        },
+        "labelPadding": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The padding, in pixel, between facet header's label and the plot.\n\n__Default value:__ `10`"
+        },
+        "labels": {
+          "description": "A boolean flag indicating if labels should be included as part of the header.\n\n__Default value:__ `true`.",
+          "type": "boolean"
+        },
+        "orient": {
+          "$ref": "#/definitions/Orient",
+          "description": "Shortcut for setting both labelOrient and titleOrient."
+        },
+        "title": {
+          "description": "Set to null to disable title for the axis, legend, or header.",
+          "type": "null"
+        },
+        "titleAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Horizontal text alignment (to the anchor) of header titles."
+        },
+        "titleAnchor": {
+          "$ref": "#/definitions/TitleAnchor",
+          "description": "The anchor position for placing the title. One of `\"start\"`, `\"middle\"`, or `\"end\"`. For example, with an orientation of top these anchor positions map to a left-, center-, or right-aligned title."
+        },
+        "titleAngle": {
+          "description": "The rotation angle of the header title.\n\n__Default value:__ `0`.",
+          "maximum": 360,
+          "minimum": -360,
+          "type": "number"
+        },
+        "titleBaseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The vertical text baseline for the header title. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, or `\"line-bottom\"`. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the `titleLineHeight` rather than `titleFontSize` alone.\n\n__Default value:__ `\"middle\"`"
+        },
+        "titleColor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Color of the header title, can be in hex color code or regular color name."
+        },
+        "titleFont": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Font of the header title. (e.g., `\"Helvetica Neue\"`)."
+        },
+        "titleFontSize": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Font size of the header title.",
+          "minimum": 0
+        },
+        "titleFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The font style of the header title."
+        },
+        "titleFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Font weight of the header title. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+        },
+        "titleLimit": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The maximum length of the header title in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.\n\n__Default value:__ `0`, indicating no limit"
+        },
+        "titleLineHeight": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Line height in pixels for multi-line header title text or title text with `\"line-top\"` or `\"line-bottom\"` baseline."
+        },
+        "titleOrient": {
+          "$ref": "#/definitions/Orient",
+          "description": "The orientation of the header title. One of `\"top\"`, `\"bottom\"`, `\"left\"` or `\"right\"`."
+        },
+        "titlePadding": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The padding, in pixel, between facet header's title and the label.\n\n__Default value:__ `10`"
+        }
+      },
+      "type": "object"
+    },
+    "HexColor": {
+      "format": "color-hex",
+      "type": "string"
+    },
+    "ImputeMethod": {
+      "enum": [
+        "value",
+        "median",
+        "max",
+        "min",
+        "mean"
+      ],
+      "type": "string"
+    },
+    "ImputeParams": {
+      "additionalProperties": false,
+      "properties": {
+        "frame": {
+          "description": "A frame specification as a two-element array used to control the window over which the specified method is applied. The array entries should either be a number indicating the offset from the current data object, or null to indicate unbounded rows preceding or following the current data object. For example, the value `[-5, 5]` indicates that the window should include five objects preceding and five objects following the current object.\n\n__Default value:__:  `[null, null]` indicating that the window includes all objects.",
+          "items": {
+            "type": [
+              "null",
+              "number"
+            ]
+          },
+          "maxItems": 2,
+          "minItems": 2,
+          "type": "array"
+        },
+        "keyvals": {
+          "anyOf": [
+            {
+              "items": {},
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ImputeSequence"
+            }
+          ],
+          "description": "Defines the key values that should be considered for imputation. An array of key values or an object defining a [number sequence](https://vega.github.io/vega-lite/docs/impute.html#sequence-def).\n\nIf provided, this will be used in addition to the key values observed within the input data. If not provided, the values will be derived from all unique values of the `key` field. For `impute` in `encoding`, the key field is the x-field if the y-field is imputed, or vice versa.\n\nIf there is no impute grouping, this property _must_ be specified."
+        },
+        "method": {
+          "$ref": "#/definitions/ImputeMethod",
+          "description": "The imputation method to use for the field value of imputed data objects. One of `\"value\"`, `\"mean\"`, `\"median\"`, `\"max\"` or `\"min\"`.\n\n__Default value:__  `\"value\"`"
+        },
+        "value": {
+          "description": "The field value to use when the imputation `method` is `\"value\"`."
+        }
+      },
+      "type": "object"
+    },
+    "ImputeSequence": {
+      "additionalProperties": false,
+      "properties": {
+        "start": {
+          "description": "The starting value of the sequence. __Default value:__ `0`",
+          "type": "number"
+        },
+        "step": {
+          "description": "The step value between sequence entries. __Default value:__ `1` or `-1` if `stop < start`",
+          "type": "number"
+        },
+        "stop": {
+          "description": "The ending value(exclusive) of the sequence.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "stop"
+      ],
+      "type": "object"
+    },
+    "ImputeTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "frame": {
+          "description": "A frame specification as a two-element array used to control the window over which the specified method is applied. The array entries should either be a number indicating the offset from the current data object, or null to indicate unbounded rows preceding or following the current data object. For example, the value `[-5, 5]` indicates that the window should include five objects preceding and five objects following the current object.\n\n__Default value:__:  `[null, null]` indicating that the window includes all objects.",
+          "items": {
+            "type": [
+              "null",
+              "number"
+            ]
+          },
+          "maxItems": 2,
+          "minItems": 2,
+          "type": "array"
+        },
+        "groupby": {
+          "description": "An optional array of fields by which to group the values. Imputation will then be performed on a per-group basis.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "impute": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field for which the missing values should be imputed."
+        },
+        "key": {
+          "$ref": "#/definitions/FieldName",
+          "description": "A key field that uniquely identifies data objects within a group. Missing key values (those occurring in the data but not in the current group) will be imputed."
+        },
+        "keyvals": {
+          "anyOf": [
+            {
+              "items": {},
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ImputeSequence"
+            }
+          ],
+          "description": "Defines the key values that should be considered for imputation. An array of key values or an object defining a [number sequence](https://vega.github.io/vega-lite/docs/impute.html#sequence-def).\n\nIf provided, this will be used in addition to the key values observed within the input data. If not provided, the values will be derived from all unique values of the `key` field. For `impute` in `encoding`, the key field is the x-field if the y-field is imputed, or vice versa.\n\nIf there is no impute grouping, this property _must_ be specified."
+        },
+        "method": {
+          "$ref": "#/definitions/ImputeMethod",
+          "description": "The imputation method to use for the field value of imputed data objects. One of `\"value\"`, `\"mean\"`, `\"median\"`, `\"max\"` or `\"min\"`.\n\n__Default value:__  `\"value\"`"
+        },
+        "value": {
+          "description": "The field value to use when the imputation `method` is `\"value\"`."
+        }
+      },
+      "required": [
+        "impute",
+        "key"
+      ],
+      "type": "object"
+    },
+    "InlineData": {
+      "additionalProperties": false,
+      "properties": {
+        "format": {
+          "$ref": "#/definitions/DataFormat",
+          "description": "An object that specifies the format for parsing the data."
+        },
+        "name": {
+          "description": "Provide a placeholder name and bind data at runtime.",
+          "type": "string"
+        },
+        "values": {
+          "$ref": "#/definitions/InlineDataset",
+          "description": "The full data set, included inline. This can be an array of objects or primitive values, an object, or a string. Arrays of primitive values are ingested as objects with a `data` property. Strings are parsed according to the specified format type."
+        }
+      },
+      "required": [
+        "values"
+      ],
+      "type": "object"
+    },
+    "InlineDataset": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        },
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "items": {
+            "type": "boolean"
+          },
+          "type": "array"
+        },
+        {
+          "items": {
+            "type": "object"
+          },
+          "type": "array"
+        },
+        {
+          "type": "string"
+        },
+        {
+          "type": "object"
+        }
+      ]
+    },
+    "Interpolate": {
+      "enum": [
+        "basis",
+        "basis-open",
+        "basis-closed",
+        "bundle",
+        "cardinal",
+        "cardinal-open",
+        "cardinal-closed",
+        "catmull-rom",
+        "linear",
+        "linear-closed",
+        "monotone",
+        "natural",
+        "step",
+        "step-before",
+        "step-after"
+      ],
+      "type": "string"
+    },
+    "IntervalSelectionConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "clear": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Stream"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Clears the selection, emptying it of all values. This property can be a [Event Stream](https://vega.github.io/vega/docs/event-streams/) or `false` to disable clear.\n\n__Default value:__ `dblclick`.\n\n__See also:__ [`clear` examples ](https://vega.github.io/vega-lite/docs/selection.html#clear) in the documentation."
+        },
+        "encodings": {
+          "description": "An array of encoding channels. The corresponding data field values must match for a data tuple to fall within the selection.\n\n__See also:__ The [projection with `encodings` and `fields` section](https://vega.github.io/vega-lite/docs/selection.html#project) in the documentation.",
+          "items": {
+            "$ref": "#/definitions/SingleDefUnitChannel"
+          },
+          "type": "array"
+        },
+        "fields": {
+          "description": "An array of field names whose values must match for a data tuple to fall within the selection.\n\n__See also:__ The [projection with `encodings` and `fields` section](https://vega.github.io/vega-lite/docs/selection.html#project) in the documentation.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "mark": {
+          "$ref": "#/definitions/BrushConfig",
+          "description": "An interval selection also adds a rectangle mark to depict the extents of the interval. The `mark` property can be used to customize the appearance of the mark.\n\n__See also:__ [`mark` examples](https://vega.github.io/vega-lite/docs/selection.html#mark) in the documentation."
+        },
+        "on": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Stream"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "description": "A [Vega event stream](https://vega.github.io/vega/docs/event-streams/) (object or selector) that triggers the selection. For interval selections, the event stream must specify a [start and end](https://vega.github.io/vega/docs/event-streams/#between-filters).\n\n__See also:__ [`on` examples](https://vega.github.io/vega-lite/docs/selection.html#on) in the documentation."
+        },
+        "resolve": {
+          "$ref": "#/definitions/SelectionResolution",
+          "description": "With layered and multi-view displays, a strategy that determines how selections' data queries are resolved when applied in a filter transform, conditional encoding rule, or scale domain.\n\nOne of:\n- `\"global\"` -- only one brush exists for the entire SPLOM. When the user begins to drag, any previous brushes are cleared, and a new one is constructed.\n- `\"union\"` -- each cell contains its own brush, and points are highlighted if they lie within _any_ of these individual brushes.\n- `\"intersect\"` -- each cell contains its own brush, and points are highlighted only if they fall within _all_ of these individual brushes.\n\n__Default value:__ `global`.\n\n__See also:__ [`resolve` examples](https://vega.github.io/vega-lite/docs/selection.html#resolve) in the documentation."
+        },
+        "translate": {
+          "description": "When truthy, allows a user to interactively move an interval selection back-and-forth. Can be `true`, `false` (to disable panning), or a [Vega event stream definition](https://vega.github.io/vega/docs/event-streams/) which must include a start and end event to trigger continuous panning. Discrete panning (e.g., pressing the left/right arrow keys) will be supported in future versions.\n\n__Default value:__ `true`, which corresponds to `[pointerdown, window:pointerup] > window:pointermove!`. This default allows users to clicks and drags within an interval selection to reposition it.\n\n__See also:__ [`translate` examples](https://vega.github.io/vega-lite/docs/selection.html#translate) in the documentation.",
+          "type": [
+            "string",
+            "boolean"
+          ]
+        },
+        "type": {
+          "const": "interval",
+          "description": "Determines the default event processing and data query for the selection. Vega-Lite currently supports two selection types:\n\n- `\"point\"` -- to select multiple discrete data values; the first value is selected on `click` and additional values toggled on shift-click.\n- `\"interval\"` -- to select a continuous range of data values on `drag`.",
+          "type": "string"
+        },
+        "zoom": {
+          "description": "When truthy, allows a user to interactively resize an interval selection. Can be `true`, `false` (to disable zooming), or a [Vega event stream definition](https://vega.github.io/vega/docs/event-streams/). Currently, only `wheel` events are supported, but custom event streams can still be used to specify filters, debouncing, and throttling. Future versions will expand the set of events that can trigger this transformation.\n\n__Default value:__ `true`, which corresponds to `wheel!`. This default allows users to use the mouse wheel to resize an interval selection.\n\n__See also:__ [`zoom` examples](https://vega.github.io/vega-lite/docs/selection.html#zoom) in the documentation.",
+          "type": [
+            "string",
+            "boolean"
+          ]
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "type": "object"
+    },
+    "IntervalSelectionConfigWithoutType": {
+      "additionalProperties": false,
+      "properties": {
+        "clear": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Stream"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Clears the selection, emptying it of all values. This property can be a [Event Stream](https://vega.github.io/vega/docs/event-streams/) or `false` to disable clear.\n\n__Default value:__ `dblclick`.\n\n__See also:__ [`clear` examples ](https://vega.github.io/vega-lite/docs/selection.html#clear) in the documentation."
+        },
+        "encodings": {
+          "description": "An array of encoding channels. The corresponding data field values must match for a data tuple to fall within the selection.\n\n__See also:__ The [projection with `encodings` and `fields` section](https://vega.github.io/vega-lite/docs/selection.html#project) in the documentation.",
+          "items": {
+            "$ref": "#/definitions/SingleDefUnitChannel"
+          },
+          "type": "array"
+        },
+        "fields": {
+          "description": "An array of field names whose values must match for a data tuple to fall within the selection.\n\n__See also:__ The [projection with `encodings` and `fields` section](https://vega.github.io/vega-lite/docs/selection.html#project) in the documentation.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "mark": {
+          "$ref": "#/definitions/BrushConfig",
+          "description": "An interval selection also adds a rectangle mark to depict the extents of the interval. The `mark` property can be used to customize the appearance of the mark.\n\n__See also:__ [`mark` examples](https://vega.github.io/vega-lite/docs/selection.html#mark) in the documentation."
+        },
+        "on": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Stream"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "description": "A [Vega event stream](https://vega.github.io/vega/docs/event-streams/) (object or selector) that triggers the selection. For interval selections, the event stream must specify a [start and end](https://vega.github.io/vega/docs/event-streams/#between-filters).\n\n__See also:__ [`on` examples](https://vega.github.io/vega-lite/docs/selection.html#on) in the documentation."
+        },
+        "resolve": {
+          "$ref": "#/definitions/SelectionResolution",
+          "description": "With layered and multi-view displays, a strategy that determines how selections' data queries are resolved when applied in a filter transform, conditional encoding rule, or scale domain.\n\nOne of:\n- `\"global\"` -- only one brush exists for the entire SPLOM. When the user begins to drag, any previous brushes are cleared, and a new one is constructed.\n- `\"union\"` -- each cell contains its own brush, and points are highlighted if they lie within _any_ of these individual brushes.\n- `\"intersect\"` -- each cell contains its own brush, and points are highlighted only if they fall within _all_ of these individual brushes.\n\n__Default value:__ `global`.\n\n__See also:__ [`resolve` examples](https://vega.github.io/vega-lite/docs/selection.html#resolve) in the documentation."
+        },
+        "translate": {
+          "description": "When truthy, allows a user to interactively move an interval selection back-and-forth. Can be `true`, `false` (to disable panning), or a [Vega event stream definition](https://vega.github.io/vega/docs/event-streams/) which must include a start and end event to trigger continuous panning. Discrete panning (e.g., pressing the left/right arrow keys) will be supported in future versions.\n\n__Default value:__ `true`, which corresponds to `[pointerdown, window:pointerup] > window:pointermove!`. This default allows users to clicks and drags within an interval selection to reposition it.\n\n__See also:__ [`translate` examples](https://vega.github.io/vega-lite/docs/selection.html#translate) in the documentation.",
+          "type": [
+            "string",
+            "boolean"
+          ]
+        },
+        "zoom": {
+          "description": "When truthy, allows a user to interactively resize an interval selection. Can be `true`, `false` (to disable zooming), or a [Vega event stream definition](https://vega.github.io/vega/docs/event-streams/). Currently, only `wheel` events are supported, but custom event streams can still be used to specify filters, debouncing, and throttling. Future versions will expand the set of events that can trigger this transformation.\n\n__Default value:__ `true`, which corresponds to `wheel!`. This default allows users to use the mouse wheel to resize an interval selection.\n\n__See also:__ [`zoom` examples](https://vega.github.io/vega-lite/docs/selection.html#zoom) in the documentation.",
+          "type": [
+            "string",
+            "boolean"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "JoinAggregateFieldDef": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The output name for the join aggregate operation."
+        },
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field for which to compute the aggregate function. This can be omitted for functions that do not operate over a field such as `\"count\"`."
+        },
+        "op": {
+          "$ref": "#/definitions/AggregateOp",
+          "description": "The aggregation operation to apply (e.g., `\"sum\"`, `\"average\"` or `\"count\"`). See the list of all supported operations [here](https://vega.github.io/vega-lite/docs/aggregate.html#ops)."
+        }
+      },
+      "required": [
+        "op",
+        "as"
+      ],
+      "type": "object"
+    },
+    "JoinAggregateTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "groupby": {
+          "description": "The data fields for partitioning the data objects into separate groups. If unspecified, all data points will be in a single group.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "joinaggregate": {
+          "description": "The definition of the fields in the join aggregate, and what calculations to use.",
+          "items": {
+            "$ref": "#/definitions/JoinAggregateFieldDef"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "joinaggregate"
+      ],
+      "type": "object"
+    },
+    "JsonDataFormat": {
+      "additionalProperties": false,
+      "properties": {
+        "parse": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Parse"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "If set to `null`, disable type inference based on the spec and only use type inference based on the data. Alternatively, a parsing directive object can be provided for explicit data types. Each property of the object corresponds to a field name, and the value to the desired data type (one of `\"number\"`, `\"boolean\"`, `\"date\"`, or null (do not parse the field)). For example, `\"parse\": {\"modified_on\": \"date\"}` parses the `modified_on` field in each input record a Date value.\n\nFor `\"date\"`, we parse data based using JavaScript's [`Date.parse()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse). For Specific date formats can be provided (e.g., `{foo: \"date:'%m%d%Y'\"}`), using the [d3-time-format syntax](https://github.com/d3/d3-time-format#locale_format). UTC date format parsing is supported similarly (e.g., `{foo: \"utc:'%m%d%Y'\"}`). See more about [UTC time](https://vega.github.io/vega-lite/docs/timeunit.html#utc)"
+        },
+        "property": {
+          "description": "The JSON property containing the desired data. This parameter can be used when the loaded JSON file may have surrounding structure or meta-data. For example `\"property\": \"values.features\"` is equivalent to retrieving `json.values.features` from the loaded JSON object.",
+          "type": "string"
+        },
+        "type": {
+          "const": "json",
+          "description": "Type of input data: `\"json\"`, `\"csv\"`, `\"tsv\"`, `\"dsv\"`.\n\n__Default value:__  The default format type is determined by the extension of the file URL. If no extension is detected, `\"json\"` will be used by default.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "LabelOverlap": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "const": "parity",
+          "type": "string"
+        },
+        {
+          "const": "greedy",
+          "type": "string"
+        }
+      ]
+    },
+    "LatLongDef": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/LatLongFieldDef"
+        },
+        {
+          "$ref": "#/definitions/DatumDef"
+        }
+      ]
+    },
+    "LatLongFieldDef": {
+      "additionalProperties": false,
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+          "type": "null"
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "const": "quantitative",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "LayerRepeatMapping": {
+      "additionalProperties": false,
+      "properties": {
+        "column": {
+          "description": "An array of fields to be repeated horizontally.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "layer": {
+          "description": "An array of fields to be repeated as layers.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "row": {
+          "description": "An array of fields to be repeated vertically.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "layer"
+      ],
+      "type": "object"
+    },
+    "LayerRepeatSpec": {
+      "additionalProperties": false,
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayoutAlign"
+            },
+            {
+              "$ref": "#/definitions/RowCol<LayoutAlign>"
+            }
+          ],
+          "description": "The alignment to apply to grid rows and columns. The supported string values are `\"all\"`, `\"each\"`, and `\"none\"`.\n\n- For `\"none\"`, a flow layout will be used, in which adjacent subviews are simply placed one after the other.\n- For `\"each\"`, subviews will be aligned into a clean grid structure, but each row or column may be of variable size.\n- For `\"all\"`, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns.\n\nAlternatively, an object value of the form `{\"row\": string, \"column\": string}` can be used to supply different alignments for rows and columns.\n\n__Default value:__ `\"all\"`."
+        },
+        "bounds": {
+          "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+          "enum": [
+            "full",
+            "flush"
+          ],
+          "type": "string"
+        },
+        "center": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/RowCol<boolean>"
+            }
+          ],
+          "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\nAn object value of the form `{\"row\": boolean, \"column\": boolean}` can be used to supply different centering values for rows and columns.\n\n__Default value:__ `false`"
+        },
+        "columns": {
+          "description": "The number of columns to include in the view composition layout.\n\n__Default value__: `undefined` -- An infinite number of columns (a single row) will be assumed. This is equivalent to `hconcat` (for `concat`) and to using the `column` channel (for `facet` and `repeat`).\n\n__Note__:\n\n1) This property is only for:\n- the general (wrappable) `concat` operator (not `hconcat`/`vconcat`)\n- the `facet` and `repeat` operator with one field/repetition definition (without row/column nesting)\n\n2) Setting the `columns` to `1` is equivalent to `vconcat` (for `concat`) and to using the `row` channel (for `facet` and `repeat`).",
+          "type": "number"
+        },
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "repeat": {
+          "$ref": "#/definitions/LayerRepeatMapping",
+          "description": "Definition for fields to be repeated. One of: 1) An array of fields to be repeated. If `\"repeat\"` is an array, the field can be referred to as `{\"repeat\": \"repeat\"}`. The repeated views are laid out in a wrapped row. You can set the number of columns to control the wrapping. 2) An object that maps `\"row\"` and/or `\"column\"` to the listed fields to be repeated along the particular orientations. The objects `{\"repeat\": \"row\"}` and `{\"repeat\": \"column\"}` can be used to refer to the repeated field respectively."
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "spacing": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/RowCol<number>"
+            }
+          ],
+          "description": "The spacing in pixels between sub-views of the composition operator. An object of the form `{\"row\": number, \"column\": number}` can be used to set different spacing values for rows and columns.\n\n__Default value__: Depends on `\"spacing\"` property of [the view composition configuration](https://vega.github.io/vega-lite/docs/config.html#view-config) (`20` by default)"
+        },
+        "spec": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayerSpec"
+            },
+            {
+              "$ref": "#/definitions/UnitSpecWithFrame"
+            }
+          ],
+          "description": "A specification of the view that gets repeated."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "repeat",
+        "spec"
+      ],
+      "type": "object"
+    },
+    "LayerSpec": {
+      "additionalProperties": false,
+      "description": "A full layered plot specification, which may contains `encoding` and `projection` properties that will be applied to underlying unit (single-view) specifications.",
+      "properties": {
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "encoding": {
+          "$ref": "#/definitions/SharedEncoding",
+          "description": "A shared key-value mapping between encoding channels and definition of fields in the underlying layers."
+        },
+        "height": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "container",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Step"
+            }
+          ],
+          "description": "The height of a visualization.\n\n- For a plot with a continuous y-field, height should be a number.\n- For a plot with either a discrete y-field or no y-field, height can be either a number indicating a fixed height or an object in the form of `{step: number}` defining the height per discrete step. (No y-field is equivalent to having one discrete step.)\n- To enable responsive sizing on height, it should be set to `\"container\"`.\n\n__Default value:__ Based on `config.view.continuousHeight` for a plot with a continuous y-field and `config.view.discreteHeight` otherwise.\n\n__Note:__ For plots with [`row` and `column` channels](https://vega.github.io/vega-lite/docs/encoding.html#facet), this represents the height of a single view and the `\"container\"` option cannot be used.\n\n__See also:__ [`height`](https://vega.github.io/vega-lite/docs/size.html) documentation."
+        },
+        "layer": {
+          "description": "Layer or single view specifications to be layered.\n\n__Note__: Specifications inside `layer` cannot use `row` and `column` channels as layering facet specifications is not allowed. Instead, use the [facet operator](https://vega.github.io/vega-lite/docs/facet.html) and place a layer inside a facet.",
+          "items": {
+            "anyOf": [
+              {
+                "$ref": "#/definitions/LayerSpec"
+              },
+              {
+                "$ref": "#/definitions/UnitSpec"
+              }
+            ]
+          },
+          "type": "array"
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "projection": {
+          "$ref": "#/definitions/Projection",
+          "description": "An object defining properties of the geographic projection shared by underlying layers."
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        },
+        "view": {
+          "$ref": "#/definitions/ViewBackground",
+          "description": "An object defining the view background's fill and stroke.\n\n__Default value:__ none (transparent)"
+        },
+        "width": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "container",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Step"
+            }
+          ],
+          "description": "The width of a visualization.\n\n- For a plot with a continuous x-field, width should be a number.\n- For a plot with either a discrete x-field or no x-field, width can be either a number indicating a fixed width or an object in the form of `{step: number}` defining the width per discrete step. (No x-field is equivalent to having one discrete step.)\n- To enable responsive sizing on width, it should be set to `\"container\"`.\n\n__Default value:__ Based on `config.view.continuousWidth` for a plot with a continuous x-field and `config.view.discreteWidth` otherwise.\n\n__Note:__ For plots with [`row` and `column` channels](https://vega.github.io/vega-lite/docs/encoding.html#facet), this represents the width of a single view and the `\"container\"` option cannot be used.\n\n__See also:__ [`width`](https://vega.github.io/vega-lite/docs/size.html) documentation."
+        }
+      },
+      "required": [
+        "layer"
+      ],
+      "type": "object"
+    },
+    "LayoutAlign": {
+      "enum": [
+        "all",
+        "each",
+        "none"
+      ],
+      "type": "string"
+    },
+    "Legend": {
+      "additionalProperties": false,
+      "description": "Properties of a legend or boolean flag for determining whether to show it.",
+      "properties": {
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG group, removing the legend from the ARIA accessibility tree.\n\n__Default value:__ `true`",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "clipHeight": {
+          "anyOf": [
+            {
+              "description": "The height in pixels to clip symbol legend entries and limit their size.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "columnPadding": {
+          "anyOf": [
+            {
+              "description": "The horizontal padding in pixels between symbol legend entries.\n\n__Default value:__ `10`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "columns": {
+          "anyOf": [
+            {
+              "description": "The number of columns in which to arrange symbol legend entries. A value of `0` or lower indicates a single row with one column per entry.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadius": {
+          "anyOf": [
+            {
+              "description": "Corner radius for the full legend.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "description": {
+          "anyOf": [
+            {
+              "description": "A text description of this legend for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If the `aria` property is true, for SVG output the [\"aria-label\" attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute) will be set to this description. If the description is unspecified it will be automatically generated.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "direction": {
+          "$ref": "#/definitions/Orientation",
+          "description": "The direction of the legend, one of `\"vertical\"` or `\"horizontal\"`.\n\n__Default value:__\n- For top-/bottom-`orient`ed legends, `\"horizontal\"`\n- For left-/right-`orient`ed legends, `\"vertical\"`\n- For top/bottom-left/right-`orient`ed legends, `\"horizontal\"` for gradient legends and `\"vertical\"` for symbol legends."
+        },
+        "fillColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Background fill color for the full legend."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "format": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Dict"
+            }
+          ],
+          "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+        },
+        "formatType": {
+          "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+          "type": "string"
+        },
+        "gradientLength": {
+          "anyOf": [
+            {
+              "description": "The length in pixels of the primary axis of a color gradient. This value corresponds to the height of a vertical gradient or the width of a horizontal gradient.\n\n__Default value:__ `200`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gradientOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of the color gradient.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gradientStrokeColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "The color of the gradient stroke, can be in hex color code or regular color name.\n\n__Default value:__ `\"lightGray\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gradientStrokeWidth": {
+          "anyOf": [
+            {
+              "description": "The width of the gradient stroke, in pixels.\n\n__Default value:__ `0`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gradientThickness": {
+          "anyOf": [
+            {
+              "description": "The thickness in pixels of the color gradient. This value corresponds to the width of a vertical gradient or the height of a horizontal gradient.\n\n__Default value:__ `16`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gridAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayoutAlign",
+              "description": "The alignment to apply to symbol legends rows and columns. The supported string values are `\"all\"`, `\"each\"` (the default), and `none`. For more information, see the [grid layout documentation](https://vega.github.io/vega/docs/layout).\n\n__Default value:__ `\"each\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align",
+              "description": "The alignment of the legend label, can be left, center, or right."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelBaseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline",
+              "description": "The position of the baseline of legend label, can be `\"top\"`, `\"middle\"`, `\"bottom\"`, or `\"alphabetic\"`.\n\n__Default value:__ `\"middle\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "The color of the legend label, can be in hex color code or regular color name."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelExpr": {
+          "description": "[Vega expression](https://vega.github.io/vega/docs/expressions/) for customizing labels.\n\n__Note:__ The label text and value can be assessed via the `label` and `value` properties of the legend's backing `datum` object.",
+          "type": "string"
+        },
+        "labelFont": {
+          "anyOf": [
+            {
+              "description": "The font of the legend label.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelFontSize": {
+          "anyOf": [
+            {
+              "description": "The font size of legend label.\n\n__Default value:__ `10`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "The font style of legend label."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "The font weight of legend label."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelLimit": {
+          "anyOf": [
+            {
+              "description": "Maximum allowed pixel width of legend tick labels.\n\n__Default value:__ `160`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelOffset": {
+          "anyOf": [
+            {
+              "description": "The offset of the legend label.\n\n__Default value:__ `4`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of labels.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelOverlap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LabelOverlap",
+              "description": "The strategy to use for resolving overlap of labels in gradient legends. If `false`, no overlap reduction is attempted. If set to `true` (default) or `\"parity\"`, a strategy of removing every other label is used. If set to `\"greedy\"`, a linear scan of the labels is performed, removing any label that overlaps with the last visible label (this often works better for log-scaled axes).\n\n__Default value:__ `true`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelPadding": {
+          "anyOf": [
+            {
+              "description": "Padding in pixels between the legend and legend labels.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelSeparation": {
+          "anyOf": [
+            {
+              "description": "The minimum separation that must be between label bounding boxes for them to be considered non-overlapping (default `0`). This property is ignored if *labelOverlap* resolution is not enabled.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "legendX": {
+          "anyOf": [
+            {
+              "description": "Custom x-position for legend with orient \"none\".",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "legendY": {
+          "anyOf": [
+            {
+              "description": "Custom y-position for legend with orient \"none\".",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "offset": {
+          "anyOf": [
+            {
+              "description": "The offset in pixels by which to displace the legend from the data rectangle and axes.\n\n__Default value:__ `18`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "orient": {
+          "$ref": "#/definitions/LegendOrient",
+          "description": "The orientation of the legend, which determines how the legend is positioned within the scene. One of `\"left\"`, `\"right\"`, `\"top\"`, `\"bottom\"`, `\"top-left\"`, `\"top-right\"`, `\"bottom-left\"`, `\"bottom-right\"`, `\"none\"`.\n\n__Default value:__ `\"right\"`"
+        },
+        "padding": {
+          "anyOf": [
+            {
+              "description": "The padding between the border and content of the legend group.\n\n__Default value:__ `0`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "rowPadding": {
+          "anyOf": [
+            {
+              "description": "The vertical padding in pixels between symbol legend entries.\n\n__Default value:__ `2`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Border stroke color for the full legend."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating [stroke, space] lengths for dashed symbol strokes.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolDashOffset": {
+          "anyOf": [
+            {
+              "description": "The pixel offset at which to start drawing with the symbol stroke dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolFillColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "The color of the legend symbol,"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolLimit": {
+          "anyOf": [
+            {
+              "description": "The maximum number of allowed entries for a symbol legend. Additional entries will be dropped.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolOffset": {
+          "anyOf": [
+            {
+              "description": "Horizontal pixel offset for legend symbols.\n\n__Default value:__ `0`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of the legend symbols.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolSize": {
+          "anyOf": [
+            {
+              "description": "The size of the legend symbol, in pixels.\n\n__Default value:__ `100`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolStrokeColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Stroke color for legend symbols."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolStrokeWidth": {
+          "anyOf": [
+            {
+              "description": "The width of the symbol's stroke.\n\n__Default value:__ `1.5`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolType": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SymbolShape",
+              "description": "The symbol shape. One of the plotting shapes `circle` (default), `square`, `cross`, `diamond`, `triangle-up`, `triangle-down`, `triangle-right`, or `triangle-left`, the line symbol `stroke`, or one of the centered directional shapes `arrow`, `wedge`, or `triangle`. Alternatively, a custom [SVG path string](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths) can be provided. For correct sizing, custom shape paths should be defined within a square bounding box with coordinates ranging from -1 to 1 along both the x and y dimensions.\n\n__Default value:__ `\"circle\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tickCount": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TickCount",
+              "description": "The desired number of tick values for quantitative legends."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tickMinStep": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The minimum desired step between legend ticks, in terms of scale domain values. For example, a value of `1` indicates that ticks should not be less than 1 unit apart. If `tickMinStep` is specified, the `tickCount` value will be adjusted, if necessary, to enforce the minimum step value.\n\n__Default value__: `undefined`"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "titleAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align",
+              "description": "Horizontal text alignment for legend titles.\n\n__Default value:__ `\"left\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleAnchor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TitleAnchor",
+              "description": "Text anchor position for placing legend titles."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleBaseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline",
+              "description": "Vertical text baseline for legend titles.  One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, or `\"line-bottom\"`. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the *lineHeight* rather than *fontSize* alone.\n\n__Default value:__ `\"top\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "The color of the legend title, can be in hex color code or regular color name."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFont": {
+          "anyOf": [
+            {
+              "description": "The font of the legend title.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFontSize": {
+          "anyOf": [
+            {
+              "description": "The font size of the legend title.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "The font style of the legend title."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "The font weight of the legend title. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleLimit": {
+          "anyOf": [
+            {
+              "description": "Maximum allowed pixel width of legend titles.\n\n__Default value:__ `180`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleLineHeight": {
+          "anyOf": [
+            {
+              "description": "Line height in pixels for multi-line title text or title text with `\"line-top\"` or `\"line-bottom\"` baseline.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of the legend title.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleOrient": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Orient",
+              "description": "Orientation of the legend title."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titlePadding": {
+          "anyOf": [
+            {
+              "description": "The padding, in pixels, between title and legend.\n\n__Default value:__ `5`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "type": {
+          "description": "The type of the legend. Use `\"symbol\"` to create a discrete legend and `\"gradient\"` for a continuous color gradient.\n\n__Default value:__ `\"gradient\"` for non-binned quantitative fields and temporal fields; `\"symbol\"` otherwise.",
+          "enum": [
+            "symbol",
+            "gradient"
+          ],
+          "type": "string"
+        },
+        "values": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            {
+              "items": {
+                "type": "boolean"
+              },
+              "type": "array"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/DateTime"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Explicitly set the visible legend values."
+        },
+        "zindex": {
+          "description": "A non-negative integer indicating the z-index of the legend. If zindex is 0, legend should be drawn behind all chart elements. To put them in front, use zindex = 1.",
+          "minimum": 0,
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "LegendBinding": {
+      "anyOf": [
+        {
+          "const": "legend",
+          "type": "string"
+        },
+        {
+          "$ref": "#/definitions/LegendStreamBinding"
+        }
+      ]
+    },
+    "LegendConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG group, removing the legend from the ARIA accessibility tree.\n\n__Default value:__ `true`",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "clipHeight": {
+          "anyOf": [
+            {
+              "description": "The height in pixels to clip symbol legend entries and limit their size.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "columnPadding": {
+          "anyOf": [
+            {
+              "description": "The horizontal padding in pixels between symbol legend entries.\n\n__Default value:__ `10`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "columns": {
+          "anyOf": [
+            {
+              "description": "The number of columns in which to arrange symbol legend entries. A value of `0` or lower indicates a single row with one column per entry.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadius": {
+          "anyOf": [
+            {
+              "description": "Corner radius for the full legend.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "description": {
+          "anyOf": [
+            {
+              "description": "A text description of this legend for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If the `aria` property is true, for SVG output the [\"aria-label\" attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute) will be set to this description. If the description is unspecified it will be automatically generated.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "direction": {
+          "$ref": "#/definitions/Orientation",
+          "description": "The direction of the legend, one of `\"vertical\"` or `\"horizontal\"`.\n\n__Default value:__\n- For top-/bottom-`orient`ed legends, `\"horizontal\"`\n- For left-/right-`orient`ed legends, `\"vertical\"`\n- For top/bottom-left/right-`orient`ed legends, `\"horizontal\"` for gradient legends and `\"vertical\"` for symbol legends."
+        },
+        "disable": {
+          "description": "Disable legend by default",
+          "type": "boolean"
+        },
+        "fillColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Background fill color for the full legend."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gradientDirection": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Orientation",
+              "description": "The default direction (`\"horizontal\"` or `\"vertical\"`) for gradient legends.\n\n__Default value:__ `\"vertical\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gradientHorizontalMaxLength": {
+          "description": "Max legend length for a horizontal gradient when `config.legend.gradientLength` is undefined.\n\n__Default value:__ `200`",
+          "type": "number"
+        },
+        "gradientHorizontalMinLength": {
+          "description": "Min legend length for a horizontal gradient when `config.legend.gradientLength` is undefined.\n\n__Default value:__ `100`",
+          "type": "number"
+        },
+        "gradientLabelLimit": {
+          "anyOf": [
+            {
+              "description": "The maximum allowed length in pixels of color ramp gradient labels.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gradientLabelOffset": {
+          "anyOf": [
+            {
+              "description": "Vertical offset in pixels for color ramp gradient labels.\n\n__Default value:__ `2`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gradientLength": {
+          "anyOf": [
+            {
+              "description": "The length in pixels of the primary axis of a color gradient. This value corresponds to the height of a vertical gradient or the width of a horizontal gradient.\n\n__Default value:__ `200`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gradientOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of the color gradient.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gradientStrokeColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "The color of the gradient stroke, can be in hex color code or regular color name.\n\n__Default value:__ `\"lightGray\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gradientStrokeWidth": {
+          "anyOf": [
+            {
+              "description": "The width of the gradient stroke, in pixels.\n\n__Default value:__ `0`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gradientThickness": {
+          "anyOf": [
+            {
+              "description": "The thickness in pixels of the color gradient. This value corresponds to the width of a vertical gradient or the height of a horizontal gradient.\n\n__Default value:__ `16`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "gradientVerticalMaxLength": {
+          "description": "Max legend length for a vertical gradient when `config.legend.gradientLength` is undefined.\n\n__Default value:__ `200`",
+          "type": "number"
+        },
+        "gradientVerticalMinLength": {
+          "description": "Min legend length for a vertical gradient when `config.legend.gradientLength` is undefined.\n\n__Default value:__ `100`",
+          "type": "number"
+        },
+        "gridAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayoutAlign",
+              "description": "The alignment to apply to symbol legends rows and columns. The supported string values are `\"all\"`, `\"each\"` (the default), and `none`. For more information, see the [grid layout documentation](https://vega.github.io/vega/docs/layout).\n\n__Default value:__ `\"each\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align",
+              "description": "The alignment of the legend label, can be left, center, or right."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelBaseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline",
+              "description": "The position of the baseline of legend label, can be `\"top\"`, `\"middle\"`, `\"bottom\"`, or `\"alphabetic\"`.\n\n__Default value:__ `\"middle\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "The color of the legend label, can be in hex color code or regular color name."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelFont": {
+          "anyOf": [
+            {
+              "description": "The font of the legend label.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelFontSize": {
+          "anyOf": [
+            {
+              "description": "The font size of legend label.\n\n__Default value:__ `10`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "The font style of legend label."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "The font weight of legend label."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelLimit": {
+          "anyOf": [
+            {
+              "description": "Maximum allowed pixel width of legend tick labels.\n\n__Default value:__ `160`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelOffset": {
+          "anyOf": [
+            {
+              "description": "The offset of the legend label.\n\n__Default value:__ `4`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of labels.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelOverlap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LabelOverlap"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The strategy to use for resolving overlap of labels in gradient legends. If `false`, no overlap reduction is attempted. If set to `true` or `\"parity\"`, a strategy of removing every other label is used. If set to `\"greedy\"`, a linear scan of the labels is performed, removing any label that overlaps with the last visible label (this often works better for log-scaled axes).\n\n__Default value:__ `\"greedy\"` for `log scales otherwise `true`."
+        },
+        "labelPadding": {
+          "anyOf": [
+            {
+              "description": "Padding in pixels between the legend and legend labels.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "labelSeparation": {
+          "anyOf": [
+            {
+              "description": "The minimum separation that must be between label bounding boxes for them to be considered non-overlapping (default `0`). This property is ignored if *labelOverlap* resolution is not enabled.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "layout": {
+          "$ref": "#/definitions/ExprRef"
+        },
+        "legendX": {
+          "anyOf": [
+            {
+              "description": "Custom x-position for legend with orient \"none\".",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "legendY": {
+          "anyOf": [
+            {
+              "description": "Custom y-position for legend with orient \"none\".",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "offset": {
+          "anyOf": [
+            {
+              "description": "The offset in pixels by which to displace the legend from the data rectangle and axes.\n\n__Default value:__ `18`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "orient": {
+          "$ref": "#/definitions/LegendOrient",
+          "description": "The orientation of the legend, which determines how the legend is positioned within the scene. One of `\"left\"`, `\"right\"`, `\"top\"`, `\"bottom\"`, `\"top-left\"`, `\"top-right\"`, `\"bottom-left\"`, `\"bottom-right\"`, `\"none\"`.\n\n__Default value:__ `\"right\"`"
+        },
+        "padding": {
+          "anyOf": [
+            {
+              "description": "The padding between the border and content of the legend group.\n\n__Default value:__ `0`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "rowPadding": {
+          "anyOf": [
+            {
+              "description": "The vertical padding in pixels between symbol legend entries.\n\n__Default value:__ `2`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Border stroke color for the full legend."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDash": {
+          "anyOf": [
+            {
+              "description": "Border stroke dash pattern for the full legend.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeWidth": {
+          "anyOf": [
+            {
+              "description": "Border stroke width for the full legend.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolBaseFillColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Default fill color for legend symbols. Only applied if there is no `\"fill\"` scale color encoding for the legend.\n\n__Default value:__ `\"transparent\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolBaseStrokeColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Default stroke color for legend symbols. Only applied if there is no `\"fill\"` scale color encoding for the legend.\n\n__Default value:__ `\"gray\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating [stroke, space] lengths for dashed symbol strokes.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolDashOffset": {
+          "anyOf": [
+            {
+              "description": "The pixel offset at which to start drawing with the symbol stroke dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolDirection": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Orientation",
+              "description": "The default direction (`\"horizontal\"` or `\"vertical\"`) for symbol legends.\n\n__Default value:__ `\"vertical\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolFillColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "The color of the legend symbol,"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolLimit": {
+          "anyOf": [
+            {
+              "description": "The maximum number of allowed entries for a symbol legend. Additional entries will be dropped.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolOffset": {
+          "anyOf": [
+            {
+              "description": "Horizontal pixel offset for legend symbols.\n\n__Default value:__ `0`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of the legend symbols.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolSize": {
+          "anyOf": [
+            {
+              "description": "The size of the legend symbol, in pixels.\n\n__Default value:__ `100`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolStrokeColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Stroke color for legend symbols."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolStrokeWidth": {
+          "anyOf": [
+            {
+              "description": "The width of the symbol's stroke.\n\n__Default value:__ `1.5`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "symbolType": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SymbolShape",
+              "description": "The symbol shape. One of the plotting shapes `circle` (default), `square`, `cross`, `diamond`, `triangle-up`, `triangle-down`, `triangle-right`, or `triangle-left`, the line symbol `stroke`, or one of the centered directional shapes `arrow`, `wedge`, or `triangle`. Alternatively, a custom [SVG path string](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths) can be provided. For correct sizing, custom shape paths should be defined within a square bounding box with coordinates ranging from -1 to 1 along both the x and y dimensions.\n\n__Default value:__ `\"circle\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tickCount": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TickCount",
+              "description": "The desired number of tick values for quantitative legends."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "title": {
+          "description": "Set to null to disable title for the axis, legend, or header.",
+          "type": "null"
+        },
+        "titleAlign": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align",
+              "description": "Horizontal text alignment for legend titles.\n\n__Default value:__ `\"left\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleAnchor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TitleAnchor",
+              "description": "Text anchor position for placing legend titles."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleBaseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline",
+              "description": "Vertical text baseline for legend titles.  One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, or `\"line-bottom\"`. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the *lineHeight* rather than *fontSize* alone.\n\n__Default value:__ `\"top\"`."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "The color of the legend title, can be in hex color code or regular color name."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFont": {
+          "anyOf": [
+            {
+              "description": "The font of the legend title.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFontSize": {
+          "anyOf": [
+            {
+              "description": "The font size of the legend title.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "The font style of the legend title."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "The font weight of the legend title. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleLimit": {
+          "anyOf": [
+            {
+              "description": "Maximum allowed pixel width of legend titles.\n\n__Default value:__ `180`.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleLineHeight": {
+          "anyOf": [
+            {
+              "description": "Line height in pixels for multi-line title text or title text with `\"line-top\"` or `\"line-bottom\"` baseline.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleOpacity": {
+          "anyOf": [
+            {
+              "description": "Opacity of the legend title.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titleOrient": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Orient",
+              "description": "Orientation of the legend title."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "titlePadding": {
+          "anyOf": [
+            {
+              "description": "The padding, in pixels, between title and legend.\n\n__Default value:__ `5`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "unselectedOpacity": {
+          "description": "The opacity of unselected legend entries.\n\n__Default value:__ 0.35.",
+          "type": "number"
+        },
+        "zindex": {
+          "anyOf": [
+            {
+              "description": "The integer z-index indicating the layering of the legend group relative to other axis, mark, and legend groups.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "LegendOrient": {
+      "enum": [
+        "none",
+        "left",
+        "right",
+        "top",
+        "bottom",
+        "top-left",
+        "top-right",
+        "bottom-left",
+        "bottom-right"
+      ],
+      "type": "string"
+    },
+    "LegendResolveMap": {
+      "additionalProperties": false,
+      "properties": {
+        "angle": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "color": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "fill": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "fillOpacity": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "opacity": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "shape": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "size": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "stroke": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "strokeDash": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "strokeOpacity": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "strokeWidth": {
+          "$ref": "#/definitions/ResolveMode"
+        }
+      },
+      "type": "object"
+    },
+    "LegendStreamBinding": {
+      "additionalProperties": false,
+      "properties": {
+        "legend": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Stream"
+            }
+          ]
+        }
+      },
+      "required": [
+        "legend"
+      ],
+      "type": "object"
+    },
+    "LineConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule). One of `\"left\"`, `\"right\"`, `\"center\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "angle": {
+          "anyOf": [
+            {
+              "description": "The rotation angle of the text, in degrees.",
+              "maximum": 360,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG element, removing the mark item from the ARIA accessibility tree.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRole": {
+          "anyOf": [
+            {
+              "description": "Sets the type of user interface element of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"role\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRoleDescription": {
+          "anyOf": [
+            {
+              "description": "A human-readable, author-localized description for the role of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"aria-roledescription\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aspect": {
+          "anyOf": [
+            {
+              "description": "Whether to keep aspect ratio of image marks.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "baseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For text marks, the vertical text baseline. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, `\"line-bottom\"`, or an expression reference that provides one of the valid values. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the `lineHeight` rather than `fontSize` alone.\n\nFor range marks, the vertical alignment of the marks. One of `\"top\"`, `\"middle\"`, `\"bottom\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "blend": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Blend",
+              "description": "The color blend mode for drawing an item on its current background. Any valid [CSS mix-blend-mode](https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode) value can be used.\n\n__Default value: `\"source-over\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "color": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default color.\n\n__Default value:__ <span style=\"color: #4682b4;\">&#9632;</span> `\"#4682b4\"`\n\n__Note:__\n- This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).\n- The `fill` and `stroke` properties have higher precedence than `color` and will override `color`."
+        },
+        "cornerRadius": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles or arcs' corners.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cursor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Cursor",
+              "description": "The mouse cursor used over the mark. Any valid [CSS cursor type](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values) can be used."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "description": {
+          "anyOf": [
+            {
+              "description": "A text description of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the [\"aria-label\" attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dir": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextDirection",
+              "description": "The direction of the text. One of `\"ltr\"` (left-to-right) or `\"rtl\"` (right-to-left). This property determines on which side is truncated in response to the limit parameter.\n\n__Default value:__ `\"ltr\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dx": {
+          "anyOf": [
+            {
+              "description": "The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dy": {
+          "anyOf": [
+            {
+              "description": "The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ellipsis": {
+          "anyOf": [
+            {
+              "description": "The ellipsis string for text truncated in response to the limit parameter.\n\n__Default value:__ `\"…\"`",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "endAngle": {
+          "anyOf": [
+            {
+              "description": "The end angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fill": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default fill color. This property has higher precedence than `config.color`. Set to `null` to remove fill.\n\n__Default value:__ (None)"
+        },
+        "fillOpacity": {
+          "anyOf": [
+            {
+              "description": "The fill opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "filled": {
+          "description": "Whether the mark's color should be used as fill color instead of stroke color.\n\n__Default value:__ `false` for all `point`, `line`, and `rule` marks as well as `geoshape` marks for [`graticule`](https://vega.github.io/vega-lite/docs/data.html#graticule) data sources; otherwise, `true`.\n\n__Note:__ This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).",
+          "type": "boolean"
+        },
+        "font": {
+          "anyOf": [
+            {
+              "description": "The typeface to set the text in (e.g., `\"Helvetica Neue\"`).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontSize": {
+          "anyOf": [
+            {
+              "description": "The font size, in pixels.\n\n__Default value:__ `11`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "The font style (e.g., `\"italic\"`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "The font weight. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "height": {
+          "anyOf": [
+            {
+              "description": "Height of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "href": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "A URL to load upon mouse click. If defined, the mark acts as a hyperlink."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "innerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The inner radius in pixels of arc marks. `innerRadius` is an alias for `radius2`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "interpolate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Interpolate",
+              "description": "The line interpolation method to use for line and area marks. One of the following:\n- `\"linear\"`: piecewise linear segments, as in a polyline.\n- `\"linear-closed\"`: close the linear segments to form a polygon.\n- `\"step\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"step-before\"`: alternate between vertical and horizontal segments, as in a step function.\n- `\"step-after\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"basis\"`: a B-spline, with control point duplication on the ends.\n- `\"basis-open\"`: an open B-spline; may not intersect the start or end.\n- `\"basis-closed\"`: a closed B-spline, as in a loop.\n- `\"cardinal\"`: a Cardinal spline, with control point duplication on the ends.\n- `\"cardinal-open\"`: an open Cardinal spline; may not intersect the start or end, but will intersect other control points.\n- `\"cardinal-closed\"`: a closed Cardinal spline, as in a loop.\n- `\"bundle\"`: equivalent to basis, except the tension parameter is used to straighten the spline.\n- `\"monotone\"`: cubic interpolation that preserves monotonicity in y."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "invalid": {
+          "description": "Defines how Vega-Lite should handle marks for invalid values (`null` and `NaN`).\n- If set to `\"filter\"` (default), all data items with null values will be skipped (for line, trail, and area marks) or filtered (for other marks).\n- If `null`, all data items are included. In this case, invalid values will be interpreted as zeroes.",
+          "enum": [
+            "filter",
+            null
+          ],
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "limit": {
+          "anyOf": [
+            {
+              "description": "The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.\n\n__Default value:__ `0` -- indicating no limit",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineBreak": {
+          "anyOf": [
+            {
+              "description": "A delimiter, such as a newline character, upon which to break text strings into multiple lines. This property is ignored if the text is array-valued.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineHeight": {
+          "anyOf": [
+            {
+              "description": "The line height in pixels (the spacing between subsequent lines of text) for multi-line text marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "opacity": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The overall opacity (value between [0,1]).\n\n__Default value:__ `0.7` for non-aggregate plots with `point`, `tick`, `circle`, or `square` marks or layered `bar` charts and `1` otherwise.",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "order": {
+          "description": "For line and trail marks, this `order` property can be set to `null` or `false` to make the lines use the original order in the data sources.",
+          "type": [
+            "null",
+            "boolean"
+          ]
+        },
+        "orient": {
+          "$ref": "#/definitions/Orientation",
+          "description": "The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.\n- For bar, rule and tick, this determines whether the size of the bar and tick should be applied to x or y dimension.\n- For area, this property determines the orient property of the Vega output.\n- For line and trail marks, this property determines the sort order of the points in the line if `config.sortLineBy` is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored."
+        },
+        "outerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The outer radius in pixels of arc marks. `outerRadius` is an alias for `radius`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "padAngle": {
+          "anyOf": [
+            {
+              "description": "The angular padding applied to sides of the arc, in radians.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "point": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/OverlayMarkDef"
+            },
+            {
+              "const": "transparent",
+              "type": "string"
+            }
+          ],
+          "description": "A flag for overlaying points on top of line or area marks, or an object defining the properties of the overlayed points.\n\n- If this property is `\"transparent\"`, transparent points will be used (for enhancing tooltips and selections).\n\n- If this property is an empty object (`{}`) or `true`, filled points with default properties will be used.\n\n- If this property is `false`, no points would be automatically added to line or area marks.\n\n__Default value:__ `false`."
+        },
+        "radius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For arc mark, the primary (outer) radius in pixels.\n\nFor text marks, polar coordinate radial offset, in pixels, of the text from the origin determined by the `x` and `y` properties.\n\n__Default value:__ `min(plot_width, plot_height)/2`",
+          "minimum": 0
+        },
+        "radius2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The secondary (inner) radius in pixels of arc marks.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "shape": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/SymbolShape"
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "description": "Shape of the point marks. Supported values include:\n- plotting shapes: `\"circle\"`, `\"square\"`, `\"cross\"`, `\"diamond\"`, `\"triangle-up\"`, `\"triangle-down\"`, `\"triangle-right\"`, or `\"triangle-left\"`.\n- the line symbol `\"stroke\"`\n- centered directional shapes `\"arrow\"`, `\"wedge\"`, or `\"triangle\"`\n- a custom [SVG path string](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths) (For correct sizing, custom shape paths should be defined within a square bounding box with coordinates ranging from -1 to 1 along both the x and y dimensions.)\n\n__Default value:__ `\"circle\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "size": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default size for marks.\n- For `point`/`circle`/`square`, this represents the pixel area of the marks. Note that this value sets the area of the symbol; the side lengths will increase with the square root of this value.\n- For `bar`, this represents the band size of the bar, in pixels.\n- For `text`, this represents the font size, in pixels.\n\n__Default value:__\n- `30` for point, circle, square marks; width/height's `step`\n- `2` for bar marks with discrete dimensions;\n- `5` for bar marks with continuous dimensions;\n- `11` for text marks.",
+          "minimum": 0
+        },
+        "smooth": {
+          "anyOf": [
+            {
+              "description": "A boolean flag (default true) indicating if the image should be smoothed when resized. If false, individual pixels should be scaled directly rather than interpolated with smoothing. For SVG rendering, this option may not work in some browsers due to lack of standardization.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "startAngle": {
+          "anyOf": [
+            {
+              "description": "The start angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "stroke": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default stroke color. This property has higher precedence than `config.color`. Set to `null` to remove stroke.\n\n__Default value:__ (None)"
+        },
+        "strokeCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for line ending style. One of `\"butt\"`, `\"round\"`, or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating stroke, space lengths for creating dashed or dotted lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDashOffset": {
+          "anyOf": [
+            {
+              "description": "The offset (in pixels) into which to begin drawing with the stroke dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeJoin": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeJoin",
+              "description": "The stroke line join method. One of `\"miter\"`, `\"round\"` or `\"bevel\"`.\n\n__Default value:__ `\"miter\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeMiterLimit": {
+          "anyOf": [
+            {
+              "description": "The miter limit at which to bevel a line join.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOffset": {
+          "anyOf": [
+            {
+              "description": "The offset in pixels at which to draw the group stroke and fill. If unspecified, the default behavior is to dynamically offset stroked groups such that 1 pixel stroke widths align with the pixel grid.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOpacity": {
+          "anyOf": [
+            {
+              "description": "The stroke opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeWidth": {
+          "anyOf": [
+            {
+              "description": "The stroke width, in pixels.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tension": {
+          "anyOf": [
+            {
+              "description": "Depending on the interpolation type, sets the tension parameter (for line and area marks).",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "text": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text",
+              "description": "Placeholder text if the `text` channel is not specified"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "theta": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "- For arc marks, the arc length in radians if theta2 is not specified, otherwise the start arc angle. (A value of 0 indicates up or “north”, increasing values proceed clockwise.)\n\n- For text marks, polar coordinate angle in radians.",
+          "maximum": 360,
+          "minimum": 0
+        },
+        "theta2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The end angle of arc marks in radians. A value of 0 indicates up or “north”, increasing values proceed clockwise."
+        },
+        "timeUnitBandPosition": {
+          "description": "Default relative band position for a time unit. If set to `0`, the marks will be positioned at the beginning of the time unit band step. If set to `0.5`, the marks will be positioned in the middle of the time unit band step.",
+          "type": "number"
+        },
+        "timeUnitBandSize": {
+          "description": "Default relative band size for a time unit. If set to `1`, the bandwidth of the marks will be equal to the time unit band step. If set to `0.5`, bandwidth of the marks will be half of the time unit band step.",
+          "type": "number"
+        },
+        "tooltip": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/TooltipContent"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The tooltip text string to show upon mouse hover or an object defining which fields should the tooltip be derived from.\n\n- If `tooltip` is `true` or `{\"content\": \"encoding\"}`, then all fields from `encoding` will be used.\n- If `tooltip` is `{\"content\": \"data\"}`, then all fields that appear in the highlighted data point will be used.\n- If set to `null` or `false`, then no tooltip will be used.\n\nSee the [`tooltip`](https://vega.github.io/vega-lite/docs/tooltip.html) documentation for a detailed discussion about tooltip  in Vega-Lite.\n\n__Default value:__ `null`"
+        },
+        "url": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "The URL of the image file for image marks."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "width": {
+          "anyOf": [
+            {
+              "description": "Width of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "x": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X coordinates of the marks, or width of horizontal `\"bar\"` and `\"area\"` without specified `x2` or `width`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "x2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "y": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y coordinates of the marks, or height of vertical `\"bar\"` and `\"area\"` without specified `y2` or `height`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "y2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        }
+      },
+      "type": "object"
+    },
+    "LineString": {
+      "additionalProperties": false,
+      "description": "LineString geometry object. https://tools.ietf.org/html/rfc7946#section-3.1.4",
+      "properties": {
+        "bbox": {
+          "$ref": "#/definitions/BBox",
+          "description": "Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections. https://tools.ietf.org/html/rfc7946#section-5"
+        },
+        "coordinates": {
+          "items": {
+            "$ref": "#/definitions/Position"
+          },
+          "type": "array"
+        },
+        "type": {
+          "const": "LineString",
+          "description": "Specifies the type of GeoJSON object.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "coordinates",
+        "type"
+      ],
+      "type": "object"
+    },
+    "LinearGradient": {
+      "additionalProperties": false,
+      "properties": {
+        "gradient": {
+          "const": "linear",
+          "description": "The type of gradient. Use `\"linear\"` for a linear gradient.",
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "stops": {
+          "description": "An array of gradient stops defining the gradient color sequence.",
+          "items": {
+            "$ref": "#/definitions/GradientStop"
+          },
+          "type": "array"
+        },
+        "x1": {
+          "description": "The starting x-coordinate, in normalized [0, 1] coordinates, of the linear gradient.\n\n__Default value:__ `0`",
+          "type": "number"
+        },
+        "x2": {
+          "description": "The ending x-coordinate, in normalized [0, 1] coordinates, of the linear gradient.\n\n__Default value:__ `1`",
+          "type": "number"
+        },
+        "y1": {
+          "description": "The starting y-coordinate, in normalized [0, 1] coordinates, of the linear gradient.\n\n__Default value:__ `0`",
+          "type": "number"
+        },
+        "y2": {
+          "description": "The ending y-coordinate, in normalized [0, 1] coordinates, of the linear gradient.\n\n__Default value:__ `0`",
+          "type": "number"
+        }
+      },
+      "required": [
+        "gradient",
+        "stops"
+      ],
+      "type": "object"
+    },
+    "LocalMultiTimeUnit": {
+      "enum": [
+        "yearquarter",
+        "yearquartermonth",
+        "yearmonth",
+        "yearmonthdate",
+        "yearmonthdatehours",
+        "yearmonthdatehoursminutes",
+        "yearmonthdatehoursminutesseconds",
+        "yearweek",
+        "yearweekday",
+        "yearweekdayhours",
+        "yearweekdayhoursminutes",
+        "yearweekdayhoursminutesseconds",
+        "yeardayofyear",
+        "quartermonth",
+        "monthdate",
+        "monthdatehours",
+        "monthdatehoursminutes",
+        "monthdatehoursminutesseconds",
+        "weekday",
+        "weekdayhours",
+        "weekdayhoursminutes",
+        "weekdayhoursminutesseconds",
+        "dayhours",
+        "dayhoursminutes",
+        "dayhoursminutesseconds",
+        "hoursminutes",
+        "hoursminutesseconds",
+        "minutesseconds",
+        "secondsmilliseconds"
+      ],
+      "type": "string"
+    },
+    "LocalSingleTimeUnit": {
+      "enum": [
+        "year",
+        "quarter",
+        "month",
+        "week",
+        "day",
+        "dayofyear",
+        "date",
+        "hours",
+        "minutes",
+        "seconds",
+        "milliseconds"
+      ],
+      "type": "string"
+    },
+    "Locale": {
+      "additionalProperties": false,
+      "properties": {
+        "number": {
+          "$ref": "#/definitions/NumberLocale"
+        },
+        "time": {
+          "$ref": "#/definitions/TimeLocale"
+        }
+      },
+      "type": "object"
+    },
+    "LoessTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "description": "The output field names for the smoothed points generated by the loess transform.\n\n__Default value:__ The field names of the input x and y values.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "maxItems": 2,
+          "minItems": 2,
+          "type": "array"
+        },
+        "bandwidth": {
+          "description": "A bandwidth parameter in the range `[0, 1]` that determines the amount of smoothing.\n\n__Default value:__ `0.3`",
+          "type": "number"
+        },
+        "groupby": {
+          "description": "The data fields to group by. If not specified, a single group containing all data objects will be used.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "loess": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field of the dependent variable to smooth."
+        },
+        "on": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field of the independent variable to use a predictor."
+        }
+      },
+      "required": [
+        "loess",
+        "on"
+      ],
+      "type": "object"
+    },
+    "LogicalAnd<Predicate>": {
+      "additionalProperties": false,
+      "properties": {
+        "and": {
+          "items": {
+            "$ref": "#/definitions/PredicateComposition"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "and"
+      ],
+      "type": "object"
+    },
+    "PredicateComposition": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/LogicalNot<Predicate>"
+        },
+        {
+          "$ref": "#/definitions/LogicalAnd<Predicate>"
+        },
+        {
+          "$ref": "#/definitions/LogicalOr<Predicate>"
+        },
+        {
+          "$ref": "#/definitions/Predicate"
+        }
+      ]
+    },
+    "LogicalNot<Predicate>": {
+      "additionalProperties": false,
+      "properties": {
+        "not": {
+          "$ref": "#/definitions/PredicateComposition"
+        }
+      },
+      "required": [
+        "not"
+      ],
+      "type": "object"
+    },
+    "LogicalOr<Predicate>": {
+      "additionalProperties": false,
+      "properties": {
+        "or": {
+          "items": {
+            "$ref": "#/definitions/PredicateComposition"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "or"
+      ],
+      "type": "object"
+    },
+    "LookupData": {
+      "additionalProperties": false,
+      "properties": {
+        "data": {
+          "$ref": "#/definitions/Data",
+          "description": "Secondary data source to lookup in."
+        },
+        "fields": {
+          "description": "Fields in foreign data or selection to lookup. If not specified, the entire object is queried.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "key": {
+          "$ref": "#/definitions/FieldName",
+          "description": "Key in data to lookup."
+        }
+      },
+      "required": [
+        "data",
+        "key"
+      ],
+      "type": "object"
+    },
+    "LookupSelection": {
+      "additionalProperties": false,
+      "properties": {
+        "fields": {
+          "description": "Fields in foreign data or selection to lookup. If not specified, the entire object is queried.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "key": {
+          "$ref": "#/definitions/FieldName",
+          "description": "Key in data to lookup."
+        },
+        "param": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "Selection parameter name to look up."
+        }
+      },
+      "required": [
+        "key",
+        "param"
+      ],
+      "type": "object"
+    },
+    "LookupTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FieldName"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/FieldName"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "The output fields on which to store the looked up data values.\n\nFor data lookups, this property may be left blank if `from.fields` has been specified (those field names will be used); if `from.fields` has not been specified, `as` must be a string.\n\nFor selection lookups, this property is optional: if unspecified, looked up values will be stored under a property named for the selection; and if specified, it must correspond to `from.fields`."
+        },
+        "default": {
+          "description": "The default value to use if lookup fails.\n\n__Default value:__ `null`"
+        },
+        "from": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LookupData"
+            },
+            {
+              "$ref": "#/definitions/LookupSelection"
+            }
+          ],
+          "description": "Data source or selection for secondary data reference."
+        },
+        "lookup": {
+          "description": "Key in primary data source.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "lookup",
+        "from"
+      ],
+      "type": "object"
+    },
+    "Mark": {
+      "description": "All types of primitive marks.",
+      "enum": [
+        "arc",
+        "area",
+        "bar",
+        "image",
+        "line",
+        "point",
+        "rect",
+        "rule",
+        "text",
+        "tick",
+        "trail",
+        "circle",
+        "square",
+        "geoshape"
+      ],
+      "type": "string"
+    },
+    "MarkConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule). One of `\"left\"`, `\"right\"`, `\"center\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "angle": {
+          "anyOf": [
+            {
+              "description": "The rotation angle of the text, in degrees.",
+              "maximum": 360,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG element, removing the mark item from the ARIA accessibility tree.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRole": {
+          "anyOf": [
+            {
+              "description": "Sets the type of user interface element of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"role\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRoleDescription": {
+          "anyOf": [
+            {
+              "description": "A human-readable, author-localized description for the role of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"aria-roledescription\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aspect": {
+          "anyOf": [
+            {
+              "description": "Whether to keep aspect ratio of image marks.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "baseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For text marks, the vertical text baseline. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, `\"line-bottom\"`, or an expression reference that provides one of the valid values. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the `lineHeight` rather than `fontSize` alone.\n\nFor range marks, the vertical alignment of the marks. One of `\"top\"`, `\"middle\"`, `\"bottom\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "blend": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Blend",
+              "description": "The color blend mode for drawing an item on its current background. Any valid [CSS mix-blend-mode](https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode) value can be used.\n\n__Default value: `\"source-over\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "color": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default color.\n\n__Default value:__ <span style=\"color: #4682b4;\">&#9632;</span> `\"#4682b4\"`\n\n__Note:__\n- This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).\n- The `fill` and `stroke` properties have higher precedence than `color` and will override `color`."
+        },
+        "cornerRadius": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles or arcs' corners.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cursor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Cursor",
+              "description": "The mouse cursor used over the mark. Any valid [CSS cursor type](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values) can be used."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "description": {
+          "anyOf": [
+            {
+              "description": "A text description of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the [\"aria-label\" attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dir": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextDirection",
+              "description": "The direction of the text. One of `\"ltr\"` (left-to-right) or `\"rtl\"` (right-to-left). This property determines on which side is truncated in response to the limit parameter.\n\n__Default value:__ `\"ltr\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dx": {
+          "anyOf": [
+            {
+              "description": "The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dy": {
+          "anyOf": [
+            {
+              "description": "The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ellipsis": {
+          "anyOf": [
+            {
+              "description": "The ellipsis string for text truncated in response to the limit parameter.\n\n__Default value:__ `\"…\"`",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "endAngle": {
+          "anyOf": [
+            {
+              "description": "The end angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fill": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default fill color. This property has higher precedence than `config.color`. Set to `null` to remove fill.\n\n__Default value:__ (None)"
+        },
+        "fillOpacity": {
+          "anyOf": [
+            {
+              "description": "The fill opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "filled": {
+          "description": "Whether the mark's color should be used as fill color instead of stroke color.\n\n__Default value:__ `false` for all `point`, `line`, and `rule` marks as well as `geoshape` marks for [`graticule`](https://vega.github.io/vega-lite/docs/data.html#graticule) data sources; otherwise, `true`.\n\n__Note:__ This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).",
+          "type": "boolean"
+        },
+        "font": {
+          "anyOf": [
+            {
+              "description": "The typeface to set the text in (e.g., `\"Helvetica Neue\"`).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontSize": {
+          "anyOf": [
+            {
+              "description": "The font size, in pixels.\n\n__Default value:__ `11`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "The font style (e.g., `\"italic\"`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "The font weight. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "height": {
+          "anyOf": [
+            {
+              "description": "Height of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "href": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "A URL to load upon mouse click. If defined, the mark acts as a hyperlink."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "innerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The inner radius in pixels of arc marks. `innerRadius` is an alias for `radius2`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "interpolate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Interpolate",
+              "description": "The line interpolation method to use for line and area marks. One of the following:\n- `\"linear\"`: piecewise linear segments, as in a polyline.\n- `\"linear-closed\"`: close the linear segments to form a polygon.\n- `\"step\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"step-before\"`: alternate between vertical and horizontal segments, as in a step function.\n- `\"step-after\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"basis\"`: a B-spline, with control point duplication on the ends.\n- `\"basis-open\"`: an open B-spline; may not intersect the start or end.\n- `\"basis-closed\"`: a closed B-spline, as in a loop.\n- `\"cardinal\"`: a Cardinal spline, with control point duplication on the ends.\n- `\"cardinal-open\"`: an open Cardinal spline; may not intersect the start or end, but will intersect other control points.\n- `\"cardinal-closed\"`: a closed Cardinal spline, as in a loop.\n- `\"bundle\"`: equivalent to basis, except the tension parameter is used to straighten the spline.\n- `\"monotone\"`: cubic interpolation that preserves monotonicity in y."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "invalid": {
+          "description": "Defines how Vega-Lite should handle marks for invalid values (`null` and `NaN`).\n- If set to `\"filter\"` (default), all data items with null values will be skipped (for line, trail, and area marks) or filtered (for other marks).\n- If `null`, all data items are included. In this case, invalid values will be interpreted as zeroes.",
+          "enum": [
+            "filter",
+            null
+          ],
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "limit": {
+          "anyOf": [
+            {
+              "description": "The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.\n\n__Default value:__ `0` -- indicating no limit",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineBreak": {
+          "anyOf": [
+            {
+              "description": "A delimiter, such as a newline character, upon which to break text strings into multiple lines. This property is ignored if the text is array-valued.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineHeight": {
+          "anyOf": [
+            {
+              "description": "The line height in pixels (the spacing between subsequent lines of text) for multi-line text marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "opacity": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The overall opacity (value between [0,1]).\n\n__Default value:__ `0.7` for non-aggregate plots with `point`, `tick`, `circle`, or `square` marks or layered `bar` charts and `1` otherwise.",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "order": {
+          "description": "For line and trail marks, this `order` property can be set to `null` or `false` to make the lines use the original order in the data sources.",
+          "type": [
+            "null",
+            "boolean"
+          ]
+        },
+        "orient": {
+          "$ref": "#/definitions/Orientation",
+          "description": "The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.\n- For bar, rule and tick, this determines whether the size of the bar and tick should be applied to x or y dimension.\n- For area, this property determines the orient property of the Vega output.\n- For line and trail marks, this property determines the sort order of the points in the line if `config.sortLineBy` is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored."
+        },
+        "outerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The outer radius in pixels of arc marks. `outerRadius` is an alias for `radius`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "padAngle": {
+          "anyOf": [
+            {
+              "description": "The angular padding applied to sides of the arc, in radians.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "radius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For arc mark, the primary (outer) radius in pixels.\n\nFor text marks, polar coordinate radial offset, in pixels, of the text from the origin determined by the `x` and `y` properties.\n\n__Default value:__ `min(plot_width, plot_height)/2`",
+          "minimum": 0
+        },
+        "radius2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The secondary (inner) radius in pixels of arc marks.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "shape": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/SymbolShape"
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "description": "Shape of the point marks. Supported values include:\n- plotting shapes: `\"circle\"`, `\"square\"`, `\"cross\"`, `\"diamond\"`, `\"triangle-up\"`, `\"triangle-down\"`, `\"triangle-right\"`, or `\"triangle-left\"`.\n- the line symbol `\"stroke\"`\n- centered directional shapes `\"arrow\"`, `\"wedge\"`, or `\"triangle\"`\n- a custom [SVG path string](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths) (For correct sizing, custom shape paths should be defined within a square bounding box with coordinates ranging from -1 to 1 along both the x and y dimensions.)\n\n__Default value:__ `\"circle\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "size": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default size for marks.\n- For `point`/`circle`/`square`, this represents the pixel area of the marks. Note that this value sets the area of the symbol; the side lengths will increase with the square root of this value.\n- For `bar`, this represents the band size of the bar, in pixels.\n- For `text`, this represents the font size, in pixels.\n\n__Default value:__\n- `30` for point, circle, square marks; width/height's `step`\n- `2` for bar marks with discrete dimensions;\n- `5` for bar marks with continuous dimensions;\n- `11` for text marks.",
+          "minimum": 0
+        },
+        "smooth": {
+          "anyOf": [
+            {
+              "description": "A boolean flag (default true) indicating if the image should be smoothed when resized. If false, individual pixels should be scaled directly rather than interpolated with smoothing. For SVG rendering, this option may not work in some browsers due to lack of standardization.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "startAngle": {
+          "anyOf": [
+            {
+              "description": "The start angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "stroke": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default stroke color. This property has higher precedence than `config.color`. Set to `null` to remove stroke.\n\n__Default value:__ (None)"
+        },
+        "strokeCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for line ending style. One of `\"butt\"`, `\"round\"`, or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating stroke, space lengths for creating dashed or dotted lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDashOffset": {
+          "anyOf": [
+            {
+              "description": "The offset (in pixels) into which to begin drawing with the stroke dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeJoin": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeJoin",
+              "description": "The stroke line join method. One of `\"miter\"`, `\"round\"` or `\"bevel\"`.\n\n__Default value:__ `\"miter\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeMiterLimit": {
+          "anyOf": [
+            {
+              "description": "The miter limit at which to bevel a line join.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOffset": {
+          "anyOf": [
+            {
+              "description": "The offset in pixels at which to draw the group stroke and fill. If unspecified, the default behavior is to dynamically offset stroked groups such that 1 pixel stroke widths align with the pixel grid.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOpacity": {
+          "anyOf": [
+            {
+              "description": "The stroke opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeWidth": {
+          "anyOf": [
+            {
+              "description": "The stroke width, in pixels.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tension": {
+          "anyOf": [
+            {
+              "description": "Depending on the interpolation type, sets the tension parameter (for line and area marks).",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "text": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text",
+              "description": "Placeholder text if the `text` channel is not specified"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "theta": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "- For arc marks, the arc length in radians if theta2 is not specified, otherwise the start arc angle. (A value of 0 indicates up or “north”, increasing values proceed clockwise.)\n\n- For text marks, polar coordinate angle in radians.",
+          "maximum": 360,
+          "minimum": 0
+        },
+        "theta2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The end angle of arc marks in radians. A value of 0 indicates up or “north”, increasing values proceed clockwise."
+        },
+        "timeUnitBandPosition": {
+          "description": "Default relative band position for a time unit. If set to `0`, the marks will be positioned at the beginning of the time unit band step. If set to `0.5`, the marks will be positioned in the middle of the time unit band step.",
+          "type": "number"
+        },
+        "timeUnitBandSize": {
+          "description": "Default relative band size for a time unit. If set to `1`, the bandwidth of the marks will be equal to the time unit band step. If set to `0.5`, bandwidth of the marks will be half of the time unit band step.",
+          "type": "number"
+        },
+        "tooltip": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/TooltipContent"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The tooltip text string to show upon mouse hover or an object defining which fields should the tooltip be derived from.\n\n- If `tooltip` is `true` or `{\"content\": \"encoding\"}`, then all fields from `encoding` will be used.\n- If `tooltip` is `{\"content\": \"data\"}`, then all fields that appear in the highlighted data point will be used.\n- If set to `null` or `false`, then no tooltip will be used.\n\nSee the [`tooltip`](https://vega.github.io/vega-lite/docs/tooltip.html) documentation for a detailed discussion about tooltip  in Vega-Lite.\n\n__Default value:__ `null`"
+        },
+        "url": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "The URL of the image file for image marks."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "width": {
+          "anyOf": [
+            {
+              "description": "Width of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "x": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X coordinates of the marks, or width of horizontal `\"bar\"` and `\"area\"` without specified `x2` or `width`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "x2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "y": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y coordinates of the marks, or height of vertical `\"bar\"` and `\"area\"` without specified `y2` or `height`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "y2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        }
+      },
+      "type": "object"
+    },
+    "MarkDef": {
+      "additionalProperties": false,
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule). One of `\"left\"`, `\"right\"`, `\"center\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "angle": {
+          "anyOf": [
+            {
+              "description": "The rotation angle of the text, in degrees.",
+              "maximum": 360,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG element, removing the mark item from the ARIA accessibility tree.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRole": {
+          "anyOf": [
+            {
+              "description": "Sets the type of user interface element of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"role\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRoleDescription": {
+          "anyOf": [
+            {
+              "description": "A human-readable, author-localized description for the role of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"aria-roledescription\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aspect": {
+          "anyOf": [
+            {
+              "description": "Whether to keep aspect ratio of image marks.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "bandSize": {
+          "description": "The width of the ticks.\n\n__Default value:__  3/4 of step (width step for horizontal ticks and height step for vertical ticks).",
+          "minimum": 0,
+          "type": "number"
+        },
+        "baseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For text marks, the vertical text baseline. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, `\"line-bottom\"`, or an expression reference that provides one of the valid values. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the `lineHeight` rather than `fontSize` alone.\n\nFor range marks, the vertical alignment of the marks. One of `\"top\"`, `\"middle\"`, `\"bottom\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "binSpacing": {
+          "description": "Offset between bars for binned field. The ideal value for this is either 0 (preferred by statisticians) or 1 (Vega-Lite default, D3 example style).\n\n__Default value:__ `1`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "blend": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Blend",
+              "description": "The color blend mode for drawing an item on its current background. Any valid [CSS mix-blend-mode](https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode) value can be used.\n\n__Default value: `\"source-over\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "clip": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Whether a mark be clipped to the enclosing group’s width and height."
+        },
+        "color": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default color.\n\n__Default value:__ <span style=\"color: #4682b4;\">&#9632;</span> `\"#4682b4\"`\n\n__Note:__\n- This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).\n- The `fill` and `stroke` properties have higher precedence than `color` and will override `color`."
+        },
+        "continuousBandSize": {
+          "description": "The default size of the bars on continuous scales.\n\n__Default value:__ `5`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "cornerRadius": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles or arcs' corners.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusEnd": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "- For vertical bars, top-left and top-right corner radius.\n\n- For horizontal bars, top-right and bottom-right corner radius."
+        },
+        "cornerRadiusTopLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cursor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Cursor",
+              "description": "The mouse cursor used over the mark. Any valid [CSS cursor type](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values) can be used."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "description": {
+          "anyOf": [
+            {
+              "description": "A text description of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the [\"aria-label\" attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dir": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextDirection",
+              "description": "The direction of the text. One of `\"ltr\"` (left-to-right) or `\"rtl\"` (right-to-left). This property determines on which side is truncated in response to the limit parameter.\n\n__Default value:__ `\"ltr\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "discreteBandSize": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/RelativeBandSize"
+            }
+          ],
+          "description": "The default size of the bars with discrete dimensions. If unspecified, the default size is  `step-2`, which provides 2 pixel offset between bars.",
+          "minimum": 0
+        },
+        "dx": {
+          "anyOf": [
+            {
+              "description": "The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dy": {
+          "anyOf": [
+            {
+              "description": "The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ellipsis": {
+          "anyOf": [
+            {
+              "description": "The ellipsis string for text truncated in response to the limit parameter.\n\n__Default value:__ `\"…\"`",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fill": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default fill color. This property has higher precedence than `config.color`. Set to `null` to remove fill.\n\n__Default value:__ (None)"
+        },
+        "fillOpacity": {
+          "anyOf": [
+            {
+              "description": "The fill opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "filled": {
+          "description": "Whether the mark's color should be used as fill color instead of stroke color.\n\n__Default value:__ `false` for all `point`, `line`, and `rule` marks as well as `geoshape` marks for [`graticule`](https://vega.github.io/vega-lite/docs/data.html#graticule) data sources; otherwise, `true`.\n\n__Note:__ This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).",
+          "type": "boolean"
+        },
+        "font": {
+          "anyOf": [
+            {
+              "description": "The typeface to set the text in (e.g., `\"Helvetica Neue\"`).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontSize": {
+          "anyOf": [
+            {
+              "description": "The font size, in pixels.\n\n__Default value:__ `11`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "The font style (e.g., `\"italic\"`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "The font weight. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "height": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/RelativeBandSize"
+            }
+          ],
+          "description": "Height of the marks.  One of:\n\n- A number representing a fixed pixel height.\n\n- A relative band size definition.  For example, `{band: 0.5}` represents half of the band"
+        },
+        "href": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "A URL to load upon mouse click. If defined, the mark acts as a hyperlink."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "innerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The inner radius in pixels of arc marks. `innerRadius` is an alias for `radius2`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "interpolate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Interpolate",
+              "description": "The line interpolation method to use for line and area marks. One of the following:\n- `\"linear\"`: piecewise linear segments, as in a polyline.\n- `\"linear-closed\"`: close the linear segments to form a polygon.\n- `\"step\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"step-before\"`: alternate between vertical and horizontal segments, as in a step function.\n- `\"step-after\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"basis\"`: a B-spline, with control point duplication on the ends.\n- `\"basis-open\"`: an open B-spline; may not intersect the start or end.\n- `\"basis-closed\"`: a closed B-spline, as in a loop.\n- `\"cardinal\"`: a Cardinal spline, with control point duplication on the ends.\n- `\"cardinal-open\"`: an open Cardinal spline; may not intersect the start or end, but will intersect other control points.\n- `\"cardinal-closed\"`: a closed Cardinal spline, as in a loop.\n- `\"bundle\"`: equivalent to basis, except the tension parameter is used to straighten the spline.\n- `\"monotone\"`: cubic interpolation that preserves monotonicity in y."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "invalid": {
+          "description": "Defines how Vega-Lite should handle marks for invalid values (`null` and `NaN`).\n- If set to `\"filter\"` (default), all data items with null values will be skipped (for line, trail, and area marks) or filtered (for other marks).\n- If `null`, all data items are included. In this case, invalid values will be interpreted as zeroes.",
+          "enum": [
+            "filter",
+            null
+          ],
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "limit": {
+          "anyOf": [
+            {
+              "description": "The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.\n\n__Default value:__ `0` -- indicating no limit",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "line": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/OverlayMarkDef"
+            }
+          ],
+          "description": "A flag for overlaying line on top of area marks, or an object defining the properties of the overlayed lines.\n\n- If this value is an empty object (`{}`) or `true`, lines with default properties will be used.\n\n- If this value is `false`, no lines would be automatically added to area marks.\n\n__Default value:__ `false`."
+        },
+        "lineBreak": {
+          "anyOf": [
+            {
+              "description": "A delimiter, such as a newline character, upon which to break text strings into multiple lines. This property is ignored if the text is array-valued.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineHeight": {
+          "anyOf": [
+            {
+              "description": "The line height in pixels (the spacing between subsequent lines of text) for multi-line text marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "minBandSize": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The minimum band size for bar and rectangle marks. __Default value:__ `0.25`"
+        },
+        "opacity": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The overall opacity (value between [0,1]).\n\n__Default value:__ `0.7` for non-aggregate plots with `point`, `tick`, `circle`, or `square` marks or layered `bar` charts and `1` otherwise.",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "order": {
+          "description": "For line and trail marks, this `order` property can be set to `null` or `false` to make the lines use the original order in the data sources.",
+          "type": [
+            "null",
+            "boolean"
+          ]
+        },
+        "orient": {
+          "$ref": "#/definitions/Orientation",
+          "description": "The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.\n- For bar, rule and tick, this determines whether the size of the bar and tick should be applied to x or y dimension.\n- For area, this property determines the orient property of the Vega output.\n- For line and trail marks, this property determines the sort order of the points in the line if `config.sortLineBy` is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored."
+        },
+        "outerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The outer radius in pixels of arc marks. `outerRadius` is an alias for `radius`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "padAngle": {
+          "anyOf": [
+            {
+              "description": "The angular padding applied to sides of the arc, in radians.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "point": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/OverlayMarkDef"
+            },
+            {
+              "const": "transparent",
+              "type": "string"
+            }
+          ],
+          "description": "A flag for overlaying points on top of line or area marks, or an object defining the properties of the overlayed points.\n\n- If this property is `\"transparent\"`, transparent points will be used (for enhancing tooltips and selections).\n\n- If this property is an empty object (`{}`) or `true`, filled points with default properties will be used.\n\n- If this property is `false`, no points would be automatically added to line or area marks.\n\n__Default value:__ `false`."
+        },
+        "radius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For arc mark, the primary (outer) radius in pixels.\n\nFor text marks, polar coordinate radial offset, in pixels, of the text from the origin determined by the `x` and `y` properties.\n\n__Default value:__ `min(plot_width, plot_height)/2`",
+          "minimum": 0
+        },
+        "radius2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The secondary (inner) radius in pixels of arc marks.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "radius2Offset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for radius2."
+        },
+        "radiusOffset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for radius."
+        },
+        "shape": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/SymbolShape"
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "description": "Shape of the point marks. Supported values include:\n- plotting shapes: `\"circle\"`, `\"square\"`, `\"cross\"`, `\"diamond\"`, `\"triangle-up\"`, `\"triangle-down\"`, `\"triangle-right\"`, or `\"triangle-left\"`.\n- the line symbol `\"stroke\"`\n- centered directional shapes `\"arrow\"`, `\"wedge\"`, or `\"triangle\"`\n- a custom [SVG path string](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths) (For correct sizing, custom shape paths should be defined within a square bounding box with coordinates ranging from -1 to 1 along both the x and y dimensions.)\n\n__Default value:__ `\"circle\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "size": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default size for marks.\n- For `point`/`circle`/`square`, this represents the pixel area of the marks. Note that this value sets the area of the symbol; the side lengths will increase with the square root of this value.\n- For `bar`, this represents the band size of the bar, in pixels.\n- For `text`, this represents the font size, in pixels.\n\n__Default value:__\n- `30` for point, circle, square marks; width/height's `step`\n- `2` for bar marks with discrete dimensions;\n- `5` for bar marks with continuous dimensions;\n- `11` for text marks.",
+          "minimum": 0
+        },
+        "smooth": {
+          "anyOf": [
+            {
+              "description": "A boolean flag (default true) indicating if the image should be smoothed when resized. If false, individual pixels should be scaled directly rather than interpolated with smoothing. For SVG rendering, this option may not work in some browsers due to lack of standardization.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "stroke": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default stroke color. This property has higher precedence than `config.color`. Set to `null` to remove stroke.\n\n__Default value:__ (None)"
+        },
+        "strokeCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for line ending style. One of `\"butt\"`, `\"round\"`, or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating stroke, space lengths for creating dashed or dotted lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDashOffset": {
+          "anyOf": [
+            {
+              "description": "The offset (in pixels) into which to begin drawing with the stroke dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeJoin": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeJoin",
+              "description": "The stroke line join method. One of `\"miter\"`, `\"round\"` or `\"bevel\"`.\n\n__Default value:__ `\"miter\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeMiterLimit": {
+          "anyOf": [
+            {
+              "description": "The miter limit at which to bevel a line join.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOffset": {
+          "anyOf": [
+            {
+              "description": "The offset in pixels at which to draw the group stroke and fill. If unspecified, the default behavior is to dynamically offset stroked groups such that 1 pixel stroke widths align with the pixel grid.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOpacity": {
+          "anyOf": [
+            {
+              "description": "The stroke opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeWidth": {
+          "anyOf": [
+            {
+              "description": "The stroke width, in pixels.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "style": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "A string or array of strings indicating the name of custom styles to apply to the mark. A style is a named collection of mark property defaults defined within the [style configuration](https://vega.github.io/vega-lite/docs/mark.html#style-config). If style is an array, later styles will override earlier styles. Any [mark properties](https://vega.github.io/vega-lite/docs/encoding.html#mark-prop) explicitly defined within the `encoding` will override a style default.\n\n__Default value:__ The mark's name. For example, a bar mark will have style `\"bar\"` by default. __Note:__ Any specified style will augment the default style. For example, a bar mark with `\"style\": \"foo\"` will receive from `config.style.bar` and `config.style.foo` (the specified style `\"foo\"` has higher precedence)."
+        },
+        "tension": {
+          "anyOf": [
+            {
+              "description": "Depending on the interpolation type, sets the tension parameter (for line and area marks).",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "text": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text",
+              "description": "Placeholder text if the `text` channel is not specified"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "theta": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "- For arc marks, the arc length in radians if theta2 is not specified, otherwise the start arc angle. (A value of 0 indicates up or “north”, increasing values proceed clockwise.)\n\n- For text marks, polar coordinate angle in radians.",
+          "maximum": 360,
+          "minimum": 0
+        },
+        "theta2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The end angle of arc marks in radians. A value of 0 indicates up or “north”, increasing values proceed clockwise."
+        },
+        "theta2Offset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for theta2."
+        },
+        "thetaOffset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for theta."
+        },
+        "thickness": {
+          "description": "Thickness of the tick mark.\n\n__Default value:__  `1`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "timeUnitBandPosition": {
+          "description": "Default relative band position for a time unit. If set to `0`, the marks will be positioned at the beginning of the time unit band step. If set to `0.5`, the marks will be positioned in the middle of the time unit band step.",
+          "type": "number"
+        },
+        "timeUnitBandSize": {
+          "description": "Default relative band size for a time unit. If set to `1`, the bandwidth of the marks will be equal to the time unit band step. If set to `0.5`, bandwidth of the marks will be half of the time unit band step.",
+          "type": "number"
+        },
+        "tooltip": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/TooltipContent"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The tooltip text string to show upon mouse hover or an object defining which fields should the tooltip be derived from.\n\n- If `tooltip` is `true` or `{\"content\": \"encoding\"}`, then all fields from `encoding` will be used.\n- If `tooltip` is `{\"content\": \"data\"}`, then all fields that appear in the highlighted data point will be used.\n- If set to `null` or `false`, then no tooltip will be used.\n\nSee the [`tooltip`](https://vega.github.io/vega-lite/docs/tooltip.html) documentation for a detailed discussion about tooltip  in Vega-Lite.\n\n__Default value:__ `null`"
+        },
+        "type": {
+          "$ref": "#/definitions/Mark",
+          "description": "The mark type. This could a primitive mark type (one of `\"bar\"`, `\"circle\"`, `\"square\"`, `\"tick\"`, `\"line\"`, `\"area\"`, `\"point\"`, `\"geoshape\"`, `\"rule\"`, and `\"text\"`) or a composite mark type (`\"boxplot\"`, `\"errorband\"`, `\"errorbar\"`)."
+        },
+        "url": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "The URL of the image file for image marks."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "width": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/RelativeBandSize"
+            }
+          ],
+          "description": "Width of the marks.  One of:\n\n- A number representing a fixed pixel width.\n\n- A relative band size definition.  For example, `{band: 0.5}` represents half of the band."
+        },
+        "x": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X coordinates of the marks, or width of horizontal `\"bar\"` and `\"area\"` without specified `x2` or `width`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "x2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "x2Offset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for x2-position."
+        },
+        "xOffset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for x-position."
+        },
+        "y": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y coordinates of the marks, or height of vertical `\"bar\"` and `\"area\"` without specified `y2` or `height`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "y2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "y2Offset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for y2-position."
+        },
+        "yOffset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for y-position."
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "type": "object"
+    },
+    "MarkPropDef<(Gradient|string|null)>": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/FieldOrDatumDefWithCondition<MarkPropFieldDef,(Gradient|string|null)>"
+        },
+        {
+          "$ref": "#/definitions/FieldOrDatumDefWithCondition<DatumDef,(Gradient|string|null)>"
+        },
+        {
+          "$ref": "#/definitions/ValueDefWithCondition<MarkPropFieldOrDatumDef,(Gradient|string|null)>"
+        }
+      ]
+    },
+    "MarkPropDef<(string|null),TypeForShape>": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/FieldOrDatumDefWithCondition<MarkPropFieldDef<TypeForShape>,(string|null)>"
+        },
+        {
+          "$ref": "#/definitions/FieldOrDatumDefWithCondition<DatumDef,(string|null)>"
+        },
+        {
+          "$ref": "#/definitions/ValueDefWithCondition<MarkPropFieldOrDatumDef<TypeForShape>,(string|null)>"
+        }
+      ]
+    },
+    "MarkPropDef<number>": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/FieldOrDatumDefWithCondition<MarkPropFieldDef,number>"
+        },
+        {
+          "$ref": "#/definitions/FieldOrDatumDefWithCondition<DatumDef,number>"
+        },
+        {
+          "$ref": "#/definitions/ValueDefWithCondition<MarkPropFieldOrDatumDef,number>"
+        }
+      ]
+    },
+    "MarkPropDef<number[]>": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/FieldOrDatumDefWithCondition<MarkPropFieldDef,number[]>"
+        },
+        {
+          "$ref": "#/definitions/FieldOrDatumDefWithCondition<DatumDef,number[]>"
+        },
+        {
+          "$ref": "#/definitions/ValueDefWithCondition<MarkPropFieldOrDatumDef,number[]>"
+        }
+      ]
+    },
+    "MarkType": {
+      "enum": [
+        "arc",
+        "area",
+        "image",
+        "group",
+        "line",
+        "path",
+        "rect",
+        "rule",
+        "shape",
+        "symbol",
+        "text",
+        "trail"
+      ],
+      "type": "string"
+    },
+    "MergedStream": {
+      "additionalProperties": false,
+      "properties": {
+        "between": {
+          "items": {
+            "$ref": "#/definitions/Stream"
+          },
+          "type": "array"
+        },
+        "consume": {
+          "type": "boolean"
+        },
+        "debounce": {
+          "type": "number"
+        },
+        "filter": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Expr"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/Expr"
+              },
+              "type": "array"
+            }
+          ]
+        },
+        "markname": {
+          "type": "string"
+        },
+        "marktype": {
+          "$ref": "#/definitions/MarkType"
+        },
+        "merge": {
+          "items": {
+            "$ref": "#/definitions/Stream"
+          },
+          "type": "array"
+        },
+        "throttle": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "merge"
+      ],
+      "type": "object"
+    },
+    "Month": {
+      "maximum": 12,
+      "minimum": 1,
+      "type": "number"
+    },
+    "MultiLineString": {
+      "additionalProperties": false,
+      "description": "MultiLineString geometry object. https://tools.ietf.org/html/rfc7946#section-3.1.5",
+      "properties": {
+        "bbox": {
+          "$ref": "#/definitions/BBox",
+          "description": "Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections. https://tools.ietf.org/html/rfc7946#section-5"
+        },
+        "coordinates": {
+          "items": {
+            "items": {
+              "$ref": "#/definitions/Position"
+            },
+            "type": "array"
+          },
+          "type": "array"
+        },
+        "type": {
+          "const": "MultiLineString",
+          "description": "Specifies the type of GeoJSON object.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "coordinates",
+        "type"
+      ],
+      "type": "object"
+    },
+    "MultiPoint": {
+      "additionalProperties": false,
+      "description": "MultiPoint geometry object.  https://tools.ietf.org/html/rfc7946#section-3.1.3",
+      "properties": {
+        "bbox": {
+          "$ref": "#/definitions/BBox",
+          "description": "Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections. https://tools.ietf.org/html/rfc7946#section-5"
+        },
+        "coordinates": {
+          "items": {
+            "$ref": "#/definitions/Position"
+          },
+          "type": "array"
+        },
+        "type": {
+          "const": "MultiPoint",
+          "description": "Specifies the type of GeoJSON object.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "coordinates",
+        "type"
+      ],
+      "type": "object"
+    },
+    "MultiPolygon": {
+      "additionalProperties": false,
+      "description": "MultiPolygon geometry object. https://tools.ietf.org/html/rfc7946#section-3.1.7",
+      "properties": {
+        "bbox": {
+          "$ref": "#/definitions/BBox",
+          "description": "Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections. https://tools.ietf.org/html/rfc7946#section-5"
+        },
+        "coordinates": {
+          "items": {
+            "items": {
+              "items": {
+                "$ref": "#/definitions/Position"
+              },
+              "type": "array"
+            },
+            "type": "array"
+          },
+          "type": "array"
+        },
+        "type": {
+          "const": "MultiPolygon",
+          "description": "Specifies the type of GeoJSON object.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "coordinates",
+        "type"
+      ],
+      "type": "object"
+    },
+    "MultiTimeUnit": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/LocalMultiTimeUnit"
+        },
+        {
+          "$ref": "#/definitions/UtcMultiTimeUnit"
+        }
+      ]
+    },
+    "NamedData": {
+      "additionalProperties": false,
+      "properties": {
+        "format": {
+          "$ref": "#/definitions/DataFormat",
+          "description": "An object that specifies the format for parsing the data."
+        },
+        "name": {
+          "description": "Provide a placeholder name and bind data at runtime.\n\nNew data may change the layout but Vega does not always resize the chart. To update the layout when the data updates, set [autosize](https://vega.github.io/vega-lite/docs/size.html#autosize) or explicitly use [view.resize](https://vega.github.io/vega/docs/api/view/#view_resize).",
+          "type": "string"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "type": "object"
+    },
+    "NonArgAggregateOp": {
+      "enum": [
+        "average",
+        "count",
+        "distinct",
+        "max",
+        "mean",
+        "median",
+        "min",
+        "missing",
+        "product",
+        "q1",
+        "q3",
+        "ci0",
+        "ci1",
+        "stderr",
+        "stdev",
+        "stdevp",
+        "sum",
+        "valid",
+        "values",
+        "variance",
+        "variancep",
+        "exponential",
+        "exponentialb"
+      ],
+      "type": "string"
+    },
+    "NonLayerRepeatSpec": {
+      "additionalProperties": false,
+      "description": "Base interface for a repeat specification.",
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayoutAlign"
+            },
+            {
+              "$ref": "#/definitions/RowCol<LayoutAlign>"
+            }
+          ],
+          "description": "The alignment to apply to grid rows and columns. The supported string values are `\"all\"`, `\"each\"`, and `\"none\"`.\n\n- For `\"none\"`, a flow layout will be used, in which adjacent subviews are simply placed one after the other.\n- For `\"each\"`, subviews will be aligned into a clean grid structure, but each row or column may be of variable size.\n- For `\"all\"`, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns.\n\nAlternatively, an object value of the form `{\"row\": string, \"column\": string}` can be used to supply different alignments for rows and columns.\n\n__Default value:__ `\"all\"`."
+        },
+        "bounds": {
+          "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+          "enum": [
+            "full",
+            "flush"
+          ],
+          "type": "string"
+        },
+        "center": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/RowCol<boolean>"
+            }
+          ],
+          "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\nAn object value of the form `{\"row\": boolean, \"column\": boolean}` can be used to supply different centering values for rows and columns.\n\n__Default value:__ `false`"
+        },
+        "columns": {
+          "description": "The number of columns to include in the view composition layout.\n\n__Default value__: `undefined` -- An infinite number of columns (a single row) will be assumed. This is equivalent to `hconcat` (for `concat`) and to using the `column` channel (for `facet` and `repeat`).\n\n__Note__:\n\n1) This property is only for:\n- the general (wrappable) `concat` operator (not `hconcat`/`vconcat`)\n- the `facet` and `repeat` operator with one field/repetition definition (without row/column nesting)\n\n2) Setting the `columns` to `1` is equivalent to `vconcat` (for `concat`) and to using the `row` channel (for `facet` and `repeat`).",
+          "type": "number"
+        },
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "repeat": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/RepeatMapping"
+            }
+          ],
+          "description": "Definition for fields to be repeated. One of: 1) An array of fields to be repeated. If `\"repeat\"` is an array, the field can be referred to as `{\"repeat\": \"repeat\"}`. The repeated views are laid out in a wrapped row. You can set the number of columns to control the wrapping. 2) An object that maps `\"row\"` and/or `\"column\"` to the listed fields to be repeated along the particular orientations. The objects `{\"repeat\": \"row\"}` and `{\"repeat\": \"column\"}` can be used to refer to the repeated field respectively."
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "spacing": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/RowCol<number>"
+            }
+          ],
+          "description": "The spacing in pixels between sub-views of the composition operator. An object of the form `{\"row\": number, \"column\": number}` can be used to set different spacing values for rows and columns.\n\n__Default value__: Depends on `\"spacing\"` property of [the view composition configuration](https://vega.github.io/vega-lite/docs/config.html#view-config) (`20` by default)"
+        },
+        "spec": {
+          "$ref": "#/definitions/NonNormalizedSpec",
+          "description": "A specification of the view that gets repeated."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "repeat",
+        "spec"
+      ],
+      "type": "object"
+    },
+    "NonNormalizedSpec": {
+      "$ref": "#/definitions/Spec"
+    },
+    "NumberLocale": {
+      "additionalProperties": false,
+      "description": "Locale definition for formatting numbers.",
+      "properties": {
+        "currency": {
+          "$ref": "#/definitions/Vector2<string>",
+          "description": "The currency prefix and suffix (e.g., [\"$\", \"\"])."
+        },
+        "decimal": {
+          "description": "The decimal point (e.g., \".\").",
+          "type": "string"
+        },
+        "grouping": {
+          "description": "The array of group sizes (e.g., [3]), cycled as needed.",
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        },
+        "minus": {
+          "description": "The minus sign (defaults to hyphen-minus, \"-\").",
+          "type": "string"
+        },
+        "nan": {
+          "description": "The not-a-number value (defaults to \"NaN\").",
+          "type": "string"
+        },
+        "numerals": {
+          "$ref": "#/definitions/Vector10<string>",
+          "description": "An array of ten strings to replace the numerals 0-9."
+        },
+        "percent": {
+          "description": "The percent sign (defaults to \"%\").",
+          "type": "string"
+        },
+        "thousands": {
+          "description": "The group separator (e.g., \",\").",
+          "type": "string"
+        }
+      },
+      "required": [
+        "decimal",
+        "thousands",
+        "grouping",
+        "currency"
+      ],
+      "type": "object"
+    },
+    "NumericArrayMarkPropDef": {
+      "$ref": "#/definitions/MarkPropDef<number[]>"
+    },
+    "NumericMarkPropDef": {
+      "$ref": "#/definitions/MarkPropDef<number>"
+    },
+    "OffsetDef": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ScaleFieldDef"
+        },
+        {
+          "$ref": "#/definitions/ScaleDatumDef"
+        },
+        {
+          "$ref": "#/definitions/ValueDef<number>"
+        }
+      ]
+    },
+    "OrderFieldDef": {
+      "additionalProperties": false,
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "const": "binned",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "sort": {
+          "$ref": "#/definitions/SortOrder",
+          "description": "The sort order. One of `\"ascending\"` (default) or `\"descending\"`."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "OrderOnlyDef": {
+      "additionalProperties": false,
+      "properties": {
+        "sort": {
+          "$ref": "#/definitions/SortOrder",
+          "description": "The sort order. One of `\"ascending\"` (default) or `\"descending\"`."
+        }
+      },
+      "type": "object"
+    },
+    "OrderValueDef": {
+      "additionalProperties": false,
+      "properties": {
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalValueDef<number>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<number>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "value"
+      ],
+      "type": "object"
+    },
+    "Orient": {
+      "enum": [
+        "left",
+        "right",
+        "top",
+        "bottom"
+      ],
+      "type": "string"
+    },
+    "Orientation": {
+      "enum": [
+        "horizontal",
+        "vertical"
+      ],
+      "type": "string"
+    },
+    "OverlayMarkDef": {
+      "additionalProperties": false,
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule). One of `\"left\"`, `\"right\"`, `\"center\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "angle": {
+          "anyOf": [
+            {
+              "description": "The rotation angle of the text, in degrees.",
+              "maximum": 360,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG element, removing the mark item from the ARIA accessibility tree.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRole": {
+          "anyOf": [
+            {
+              "description": "Sets the type of user interface element of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"role\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRoleDescription": {
+          "anyOf": [
+            {
+              "description": "A human-readable, author-localized description for the role of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"aria-roledescription\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aspect": {
+          "anyOf": [
+            {
+              "description": "Whether to keep aspect ratio of image marks.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "baseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For text marks, the vertical text baseline. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, `\"line-bottom\"`, or an expression reference that provides one of the valid values. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the `lineHeight` rather than `fontSize` alone.\n\nFor range marks, the vertical alignment of the marks. One of `\"top\"`, `\"middle\"`, `\"bottom\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "blend": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Blend",
+              "description": "The color blend mode for drawing an item on its current background. Any valid [CSS mix-blend-mode](https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode) value can be used.\n\n__Default value: `\"source-over\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "clip": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Whether a mark be clipped to the enclosing group’s width and height."
+        },
+        "color": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default color.\n\n__Default value:__ <span style=\"color: #4682b4;\">&#9632;</span> `\"#4682b4\"`\n\n__Note:__\n- This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).\n- The `fill` and `stroke` properties have higher precedence than `color` and will override `color`."
+        },
+        "cornerRadius": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles or arcs' corners.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cursor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Cursor",
+              "description": "The mouse cursor used over the mark. Any valid [CSS cursor type](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values) can be used."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "description": {
+          "anyOf": [
+            {
+              "description": "A text description of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the [\"aria-label\" attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dir": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextDirection",
+              "description": "The direction of the text. One of `\"ltr\"` (left-to-right) or `\"rtl\"` (right-to-left). This property determines on which side is truncated in response to the limit parameter.\n\n__Default value:__ `\"ltr\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dx": {
+          "anyOf": [
+            {
+              "description": "The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dy": {
+          "anyOf": [
+            {
+              "description": "The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ellipsis": {
+          "anyOf": [
+            {
+              "description": "The ellipsis string for text truncated in response to the limit parameter.\n\n__Default value:__ `\"…\"`",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "endAngle": {
+          "anyOf": [
+            {
+              "description": "The end angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fill": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default fill color. This property has higher precedence than `config.color`. Set to `null` to remove fill.\n\n__Default value:__ (None)"
+        },
+        "fillOpacity": {
+          "anyOf": [
+            {
+              "description": "The fill opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "filled": {
+          "description": "Whether the mark's color should be used as fill color instead of stroke color.\n\n__Default value:__ `false` for all `point`, `line`, and `rule` marks as well as `geoshape` marks for [`graticule`](https://vega.github.io/vega-lite/docs/data.html#graticule) data sources; otherwise, `true`.\n\n__Note:__ This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).",
+          "type": "boolean"
+        },
+        "font": {
+          "anyOf": [
+            {
+              "description": "The typeface to set the text in (e.g., `\"Helvetica Neue\"`).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontSize": {
+          "anyOf": [
+            {
+              "description": "The font size, in pixels.\n\n__Default value:__ `11`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "The font style (e.g., `\"italic\"`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "The font weight. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "height": {
+          "anyOf": [
+            {
+              "description": "Height of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "href": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "A URL to load upon mouse click. If defined, the mark acts as a hyperlink."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "innerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The inner radius in pixels of arc marks. `innerRadius` is an alias for `radius2`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "interpolate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Interpolate",
+              "description": "The line interpolation method to use for line and area marks. One of the following:\n- `\"linear\"`: piecewise linear segments, as in a polyline.\n- `\"linear-closed\"`: close the linear segments to form a polygon.\n- `\"step\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"step-before\"`: alternate between vertical and horizontal segments, as in a step function.\n- `\"step-after\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"basis\"`: a B-spline, with control point duplication on the ends.\n- `\"basis-open\"`: an open B-spline; may not intersect the start or end.\n- `\"basis-closed\"`: a closed B-spline, as in a loop.\n- `\"cardinal\"`: a Cardinal spline, with control point duplication on the ends.\n- `\"cardinal-open\"`: an open Cardinal spline; may not intersect the start or end, but will intersect other control points.\n- `\"cardinal-closed\"`: a closed Cardinal spline, as in a loop.\n- `\"bundle\"`: equivalent to basis, except the tension parameter is used to straighten the spline.\n- `\"monotone\"`: cubic interpolation that preserves monotonicity in y."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "invalid": {
+          "description": "Defines how Vega-Lite should handle marks for invalid values (`null` and `NaN`).\n- If set to `\"filter\"` (default), all data items with null values will be skipped (for line, trail, and area marks) or filtered (for other marks).\n- If `null`, all data items are included. In this case, invalid values will be interpreted as zeroes.",
+          "enum": [
+            "filter",
+            null
+          ],
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "limit": {
+          "anyOf": [
+            {
+              "description": "The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.\n\n__Default value:__ `0` -- indicating no limit",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineBreak": {
+          "anyOf": [
+            {
+              "description": "A delimiter, such as a newline character, upon which to break text strings into multiple lines. This property is ignored if the text is array-valued.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineHeight": {
+          "anyOf": [
+            {
+              "description": "The line height in pixels (the spacing between subsequent lines of text) for multi-line text marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "opacity": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The overall opacity (value between [0,1]).\n\n__Default value:__ `0.7` for non-aggregate plots with `point`, `tick`, `circle`, or `square` marks or layered `bar` charts and `1` otherwise.",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "order": {
+          "description": "For line and trail marks, this `order` property can be set to `null` or `false` to make the lines use the original order in the data sources.",
+          "type": [
+            "null",
+            "boolean"
+          ]
+        },
+        "orient": {
+          "$ref": "#/definitions/Orientation",
+          "description": "The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.\n- For bar, rule and tick, this determines whether the size of the bar and tick should be applied to x or y dimension.\n- For area, this property determines the orient property of the Vega output.\n- For line and trail marks, this property determines the sort order of the points in the line if `config.sortLineBy` is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored."
+        },
+        "outerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The outer radius in pixels of arc marks. `outerRadius` is an alias for `radius`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "padAngle": {
+          "anyOf": [
+            {
+              "description": "The angular padding applied to sides of the arc, in radians.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "radius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For arc mark, the primary (outer) radius in pixels.\n\nFor text marks, polar coordinate radial offset, in pixels, of the text from the origin determined by the `x` and `y` properties.\n\n__Default value:__ `min(plot_width, plot_height)/2`",
+          "minimum": 0
+        },
+        "radius2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The secondary (inner) radius in pixels of arc marks.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "radius2Offset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for radius2."
+        },
+        "radiusOffset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for radius."
+        },
+        "shape": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/SymbolShape"
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "description": "Shape of the point marks. Supported values include:\n- plotting shapes: `\"circle\"`, `\"square\"`, `\"cross\"`, `\"diamond\"`, `\"triangle-up\"`, `\"triangle-down\"`, `\"triangle-right\"`, or `\"triangle-left\"`.\n- the line symbol `\"stroke\"`\n- centered directional shapes `\"arrow\"`, `\"wedge\"`, or `\"triangle\"`\n- a custom [SVG path string](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths) (For correct sizing, custom shape paths should be defined within a square bounding box with coordinates ranging from -1 to 1 along both the x and y dimensions.)\n\n__Default value:__ `\"circle\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "size": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default size for marks.\n- For `point`/`circle`/`square`, this represents the pixel area of the marks. Note that this value sets the area of the symbol; the side lengths will increase with the square root of this value.\n- For `bar`, this represents the band size of the bar, in pixels.\n- For `text`, this represents the font size, in pixels.\n\n__Default value:__\n- `30` for point, circle, square marks; width/height's `step`\n- `2` for bar marks with discrete dimensions;\n- `5` for bar marks with continuous dimensions;\n- `11` for text marks.",
+          "minimum": 0
+        },
+        "smooth": {
+          "anyOf": [
+            {
+              "description": "A boolean flag (default true) indicating if the image should be smoothed when resized. If false, individual pixels should be scaled directly rather than interpolated with smoothing. For SVG rendering, this option may not work in some browsers due to lack of standardization.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "startAngle": {
+          "anyOf": [
+            {
+              "description": "The start angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "stroke": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default stroke color. This property has higher precedence than `config.color`. Set to `null` to remove stroke.\n\n__Default value:__ (None)"
+        },
+        "strokeCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for line ending style. One of `\"butt\"`, `\"round\"`, or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating stroke, space lengths for creating dashed or dotted lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDashOffset": {
+          "anyOf": [
+            {
+              "description": "The offset (in pixels) into which to begin drawing with the stroke dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeJoin": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeJoin",
+              "description": "The stroke line join method. One of `\"miter\"`, `\"round\"` or `\"bevel\"`.\n\n__Default value:__ `\"miter\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeMiterLimit": {
+          "anyOf": [
+            {
+              "description": "The miter limit at which to bevel a line join.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOffset": {
+          "anyOf": [
+            {
+              "description": "The offset in pixels at which to draw the group stroke and fill. If unspecified, the default behavior is to dynamically offset stroked groups such that 1 pixel stroke widths align with the pixel grid.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOpacity": {
+          "anyOf": [
+            {
+              "description": "The stroke opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeWidth": {
+          "anyOf": [
+            {
+              "description": "The stroke width, in pixels.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "style": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "A string or array of strings indicating the name of custom styles to apply to the mark. A style is a named collection of mark property defaults defined within the [style configuration](https://vega.github.io/vega-lite/docs/mark.html#style-config). If style is an array, later styles will override earlier styles. Any [mark properties](https://vega.github.io/vega-lite/docs/encoding.html#mark-prop) explicitly defined within the `encoding` will override a style default.\n\n__Default value:__ The mark's name. For example, a bar mark will have style `\"bar\"` by default. __Note:__ Any specified style will augment the default style. For example, a bar mark with `\"style\": \"foo\"` will receive from `config.style.bar` and `config.style.foo` (the specified style `\"foo\"` has higher precedence)."
+        },
+        "tension": {
+          "anyOf": [
+            {
+              "description": "Depending on the interpolation type, sets the tension parameter (for line and area marks).",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "text": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text",
+              "description": "Placeholder text if the `text` channel is not specified"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "theta": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "- For arc marks, the arc length in radians if theta2 is not specified, otherwise the start arc angle. (A value of 0 indicates up or “north”, increasing values proceed clockwise.)\n\n- For text marks, polar coordinate angle in radians.",
+          "maximum": 360,
+          "minimum": 0
+        },
+        "theta2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The end angle of arc marks in radians. A value of 0 indicates up or “north”, increasing values proceed clockwise."
+        },
+        "theta2Offset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for theta2."
+        },
+        "thetaOffset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for theta."
+        },
+        "timeUnitBandPosition": {
+          "description": "Default relative band position for a time unit. If set to `0`, the marks will be positioned at the beginning of the time unit band step. If set to `0.5`, the marks will be positioned in the middle of the time unit band step.",
+          "type": "number"
+        },
+        "timeUnitBandSize": {
+          "description": "Default relative band size for a time unit. If set to `1`, the bandwidth of the marks will be equal to the time unit band step. If set to `0.5`, bandwidth of the marks will be half of the time unit band step.",
+          "type": "number"
+        },
+        "tooltip": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/TooltipContent"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The tooltip text string to show upon mouse hover or an object defining which fields should the tooltip be derived from.\n\n- If `tooltip` is `true` or `{\"content\": \"encoding\"}`, then all fields from `encoding` will be used.\n- If `tooltip` is `{\"content\": \"data\"}`, then all fields that appear in the highlighted data point will be used.\n- If set to `null` or `false`, then no tooltip will be used.\n\nSee the [`tooltip`](https://vega.github.io/vega-lite/docs/tooltip.html) documentation for a detailed discussion about tooltip  in Vega-Lite.\n\n__Default value:__ `null`"
+        },
+        "url": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "The URL of the image file for image marks."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "width": {
+          "anyOf": [
+            {
+              "description": "Width of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "x": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X coordinates of the marks, or width of horizontal `\"bar\"` and `\"area\"` without specified `x2` or `width`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "x2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "x2Offset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for x2-position."
+        },
+        "xOffset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for x-position."
+        },
+        "y": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y coordinates of the marks, or height of vertical `\"bar\"` and `\"area\"` without specified `y2` or `height`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "y2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "y2Offset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for y2-position."
+        },
+        "yOffset": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Offset for y-position."
+        }
+      },
+      "type": "object"
+    },
+    "Padding": {
+      "anyOf": [
+        {
+          "type": "number"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "bottom": {
+              "type": "number"
+            },
+            "left": {
+              "type": "number"
+            },
+            "right": {
+              "type": "number"
+            },
+            "top": {
+              "type": "number"
+            }
+          },
+          "type": "object"
+        }
+      ],
+      "minimum": 0
+    },
+    "ParameterExtent": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "field": {
+              "$ref": "#/definitions/FieldName",
+              "description": "If a selection parameter is specified, the field name to extract selected values for when the selection is [projected](https://vega.github.io/vega-lite/docs/selection.html#project) over multiple fields or encodings."
+            },
+            "param": {
+              "$ref": "#/definitions/ParameterName",
+              "description": "The name of a parameter."
+            }
+          },
+          "required": [
+            "param"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "encoding": {
+              "$ref": "#/definitions/SingleDefUnitChannel",
+              "description": "If a selection parameter is specified, the encoding channel to extract selected values for when a selection is [projected](https://vega.github.io/vega-lite/docs/selection.html#project) over multiple fields or encodings."
+            },
+            "param": {
+              "$ref": "#/definitions/ParameterName",
+              "description": "The name of a parameter."
+            }
+          },
+          "required": [
+            "param"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "ParameterName": {
+      "type": "string"
+    },
+    "ParameterPredicate": {
+      "additionalProperties": false,
+      "properties": {
+        "empty": {
+          "description": "For selection parameters, the predicate of empty selections returns true by default. Override this behavior, by setting this property `empty: false`.",
+          "type": "boolean"
+        },
+        "param": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "Filter using a parameter name."
+        }
+      },
+      "required": [
+        "param"
+      ],
+      "type": "object"
+    },
+    "Parse": {
+      "additionalProperties": {
+        "$ref": "#/definitions/ParseValue"
+      },
+      "type": "object"
+    },
+    "ParseValue": {
+      "anyOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "string"
+        },
+        {
+          "const": "string",
+          "type": "string"
+        },
+        {
+          "const": "boolean",
+          "type": "string"
+        },
+        {
+          "const": "date",
+          "type": "string"
+        },
+        {
+          "const": "number",
+          "type": "string"
+        }
+      ]
+    },
+    "PivotTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "groupby": {
+          "description": "The optional data fields to group by. If not specified, a single group containing all data objects will be used.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "limit": {
+          "description": "An optional parameter indicating the maximum number of pivoted fields to generate. The default (`0`) applies no limit. The pivoted `pivot` names are sorted in ascending order prior to enforcing the limit. __Default value:__ `0`",
+          "type": "number"
+        },
+        "op": {
+          "$ref": "#/definitions/AggregateOp",
+          "description": "The aggregation operation to apply to grouped `value` field values. __Default value:__ `sum`"
+        },
+        "pivot": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field to pivot on. The unique values of this field become new field names in the output stream."
+        },
+        "value": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field to populate pivoted fields. The aggregate values of this field become the values of the new pivoted fields."
+        }
+      },
+      "required": [
+        "pivot",
+        "value"
+      ],
+      "type": "object"
+    },
+    "Point": {
+      "additionalProperties": false,
+      "description": "Point geometry object. https://tools.ietf.org/html/rfc7946#section-3.1.2",
+      "properties": {
+        "bbox": {
+          "$ref": "#/definitions/BBox",
+          "description": "Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections. https://tools.ietf.org/html/rfc7946#section-5"
+        },
+        "coordinates": {
+          "$ref": "#/definitions/Position"
+        },
+        "type": {
+          "const": "Point",
+          "description": "Specifies the type of GeoJSON object.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "coordinates",
+        "type"
+      ],
+      "type": "object"
+    },
+    "PointSelectionConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "clear": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Stream"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Clears the selection, emptying it of all values. This property can be a [Event Stream](https://vega.github.io/vega/docs/event-streams/) or `false` to disable clear.\n\n__Default value:__ `dblclick`.\n\n__See also:__ [`clear` examples ](https://vega.github.io/vega-lite/docs/selection.html#clear) in the documentation."
+        },
+        "encodings": {
+          "description": "An array of encoding channels. The corresponding data field values must match for a data tuple to fall within the selection.\n\n__See also:__ The [projection with `encodings` and `fields` section](https://vega.github.io/vega-lite/docs/selection.html#project) in the documentation.",
+          "items": {
+            "$ref": "#/definitions/SingleDefUnitChannel"
+          },
+          "type": "array"
+        },
+        "fields": {
+          "description": "An array of field names whose values must match for a data tuple to fall within the selection.\n\n__See also:__ The [projection with `encodings` and `fields` section](https://vega.github.io/vega-lite/docs/selection.html#project) in the documentation.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "nearest": {
+          "description": "When true, an invisible voronoi diagram is computed to accelerate discrete selection. The data value _nearest_ the mouse cursor is added to the selection.\n\n__Default value:__ `false`, which means that data values must be interacted with directly (e.g., clicked on) to be added to the selection.\n\n__See also:__ [`nearest` examples](https://vega.github.io/vega-lite/docs/selection.html#nearest) documentation.",
+          "type": "boolean"
+        },
+        "on": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Stream"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "description": "A [Vega event stream](https://vega.github.io/vega/docs/event-streams/) (object or selector) that triggers the selection. For interval selections, the event stream must specify a [start and end](https://vega.github.io/vega/docs/event-streams/#between-filters).\n\n__See also:__ [`on` examples](https://vega.github.io/vega-lite/docs/selection.html#on) in the documentation."
+        },
+        "resolve": {
+          "$ref": "#/definitions/SelectionResolution",
+          "description": "With layered and multi-view displays, a strategy that determines how selections' data queries are resolved when applied in a filter transform, conditional encoding rule, or scale domain.\n\nOne of:\n- `\"global\"` -- only one brush exists for the entire SPLOM. When the user begins to drag, any previous brushes are cleared, and a new one is constructed.\n- `\"union\"` -- each cell contains its own brush, and points are highlighted if they lie within _any_ of these individual brushes.\n- `\"intersect\"` -- each cell contains its own brush, and points are highlighted only if they fall within _all_ of these individual brushes.\n\n__Default value:__ `global`.\n\n__See also:__ [`resolve` examples](https://vega.github.io/vega-lite/docs/selection.html#resolve) in the documentation."
+        },
+        "toggle": {
+          "description": "Controls whether data values should be toggled (inserted or removed from a point selection) or only ever inserted into point selections.\n\nOne of:\n- `true` -- the default behavior, which corresponds to `\"event.shiftKey\"`.  As a result, data values are toggled when the user interacts with the shift-key pressed.\n- `false` -- disables toggling behaviour; the selection will only ever contain a single data value corresponding to the most recent interaction.\n- A [Vega expression](https://vega.github.io/vega/docs/expressions/) which is re-evaluated as the user interacts. If the expression evaluates to `true`, the data value is toggled into or out of the point selection. If the expression evaluates to `false`, the point selection is first cleared, and the data value is then inserted. For example, setting the value to the Vega expression `\"true\"` will toggle data values without the user pressing the shift-key.\n\n__Default value:__ `true`\n\n__See also:__ [`toggle` examples](https://vega.github.io/vega-lite/docs/selection.html#toggle) in the documentation.",
+          "type": [
+            "string",
+            "boolean"
+          ]
+        },
+        "type": {
+          "const": "point",
+          "description": "Determines the default event processing and data query for the selection. Vega-Lite currently supports two selection types:\n\n- `\"point\"` -- to select multiple discrete data values; the first value is selected on `click` and additional values toggled on shift-click.\n- `\"interval\"` -- to select a continuous range of data values on `drag`.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "type": "object"
+    },
+    "PointSelectionConfigWithoutType": {
+      "additionalProperties": false,
+      "properties": {
+        "clear": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Stream"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Clears the selection, emptying it of all values. This property can be a [Event Stream](https://vega.github.io/vega/docs/event-streams/) or `false` to disable clear.\n\n__Default value:__ `dblclick`.\n\n__See also:__ [`clear` examples ](https://vega.github.io/vega-lite/docs/selection.html#clear) in the documentation."
+        },
+        "encodings": {
+          "description": "An array of encoding channels. The corresponding data field values must match for a data tuple to fall within the selection.\n\n__See also:__ The [projection with `encodings` and `fields` section](https://vega.github.io/vega-lite/docs/selection.html#project) in the documentation.",
+          "items": {
+            "$ref": "#/definitions/SingleDefUnitChannel"
+          },
+          "type": "array"
+        },
+        "fields": {
+          "description": "An array of field names whose values must match for a data tuple to fall within the selection.\n\n__See also:__ The [projection with `encodings` and `fields` section](https://vega.github.io/vega-lite/docs/selection.html#project) in the documentation.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "nearest": {
+          "description": "When true, an invisible voronoi diagram is computed to accelerate discrete selection. The data value _nearest_ the mouse cursor is added to the selection.\n\n__Default value:__ `false`, which means that data values must be interacted with directly (e.g., clicked on) to be added to the selection.\n\n__See also:__ [`nearest` examples](https://vega.github.io/vega-lite/docs/selection.html#nearest) documentation.",
+          "type": "boolean"
+        },
+        "on": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Stream"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "description": "A [Vega event stream](https://vega.github.io/vega/docs/event-streams/) (object or selector) that triggers the selection. For interval selections, the event stream must specify a [start and end](https://vega.github.io/vega/docs/event-streams/#between-filters).\n\n__See also:__ [`on` examples](https://vega.github.io/vega-lite/docs/selection.html#on) in the documentation."
+        },
+        "resolve": {
+          "$ref": "#/definitions/SelectionResolution",
+          "description": "With layered and multi-view displays, a strategy that determines how selections' data queries are resolved when applied in a filter transform, conditional encoding rule, or scale domain.\n\nOne of:\n- `\"global\"` -- only one brush exists for the entire SPLOM. When the user begins to drag, any previous brushes are cleared, and a new one is constructed.\n- `\"union\"` -- each cell contains its own brush, and points are highlighted if they lie within _any_ of these individual brushes.\n- `\"intersect\"` -- each cell contains its own brush, and points are highlighted only if they fall within _all_ of these individual brushes.\n\n__Default value:__ `global`.\n\n__See also:__ [`resolve` examples](https://vega.github.io/vega-lite/docs/selection.html#resolve) in the documentation."
+        },
+        "toggle": {
+          "description": "Controls whether data values should be toggled (inserted or removed from a point selection) or only ever inserted into point selections.\n\nOne of:\n- `true` -- the default behavior, which corresponds to `\"event.shiftKey\"`.  As a result, data values are toggled when the user interacts with the shift-key pressed.\n- `false` -- disables toggling behaviour; the selection will only ever contain a single data value corresponding to the most recent interaction.\n- A [Vega expression](https://vega.github.io/vega/docs/expressions/) which is re-evaluated as the user interacts. If the expression evaluates to `true`, the data value is toggled into or out of the point selection. If the expression evaluates to `false`, the point selection is first cleared, and the data value is then inserted. For example, setting the value to the Vega expression `\"true\"` will toggle data values without the user pressing the shift-key.\n\n__Default value:__ `true`\n\n__See also:__ [`toggle` examples](https://vega.github.io/vega-lite/docs/selection.html#toggle) in the documentation.",
+          "type": [
+            "string",
+            "boolean"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "PolarDef": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/PositionFieldDefBase"
+        },
+        {
+          "$ref": "#/definitions/PositionDatumDefBase"
+        },
+        {
+          "$ref": "#/definitions/PositionValueDef"
+        }
+      ]
+    },
+    "Polygon": {
+      "additionalProperties": false,
+      "description": "Polygon geometry object. https://tools.ietf.org/html/rfc7946#section-3.1.6",
+      "properties": {
+        "bbox": {
+          "$ref": "#/definitions/BBox",
+          "description": "Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections. https://tools.ietf.org/html/rfc7946#section-5"
+        },
+        "coordinates": {
+          "items": {
+            "items": {
+              "$ref": "#/definitions/Position"
+            },
+            "type": "array"
+          },
+          "type": "array"
+        },
+        "type": {
+          "const": "Polygon",
+          "description": "Specifies the type of GeoJSON object.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "coordinates",
+        "type"
+      ],
+      "type": "object"
+    },
+    "Position": {
+      "description": "A Position is an array of coordinates. https://tools.ietf.org/html/rfc7946#section-3.1.1 Array should contain between two and three elements. The previous GeoJSON specification allowed more elements (e.g., which could be used to represent M values), but the current specification only allows X, Y, and (optionally) Z to be defined.",
+      "items": {
+        "type": "number"
+      },
+      "type": "array"
+    },
+    "Position2Def": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/SecondaryFieldDef"
+        },
+        {
+          "$ref": "#/definitions/DatumDef"
+        },
+        {
+          "$ref": "#/definitions/PositionValueDef"
+        }
+      ]
+    },
+    "PositionDatumDef": {
+      "additionalProperties": false,
+      "properties": {
+        "axis": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Axis"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of axis's gridlines, ticks and labels. If `null`, the axis for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [axis properties](https://vega.github.io/vega-lite/docs/axis.html) are applied.\n\n__See also:__ [`axis`](https://vega.github.io/vega-lite/docs/axis.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "datum": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PrimitiveValue"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/RepeatRef"
+            }
+          ],
+          "description": "A constant value in data domain."
+        },
+        "impute": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ImputeParams"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining the properties of the Impute Operation to be applied. The field value of the other positional channel is taken as `key` of the `Impute` Operation. The field of the `color` channel if specified is used as `groupby` of the `Impute` Operation.\n\n__See also:__ [`impute`](https://vega.github.io/vega-lite/docs/impute.html) documentation."
+        },
+        "scale": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scale"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+        },
+        "stack": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StackOffset"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Type of stacking offset if the field should be stacked. `stack` is only applicable for `x`, `y`, `theta`, and `radius` channels with continuous domains. For example, `stack` of `y` can be used to customize stacking for a vertical bar chart.\n\n`stack` can be one of the following values:\n- `\"zero\"` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and [area](https://vega.github.io/vega-lite/docs/stack.html#area) chart).\n- `\"normalize\"` - stacking with normalized domain (for creating [normalized stacked bar and area charts](https://vega.github.io/vega-lite/docs/stack.html#normalized) and pie charts [with percentage tooltip](https://vega.github.io/vega-lite/docs/arc.html#tooltip)). <br/>\n-`\"center\"` - stacking with center baseline (for [streamgraph](https://vega.github.io/vega-lite/docs/stack.html#streamgraph)).\n- `null` or `false` - No-stacking. This will produce layered [bar](https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart) and area chart.\n\n__Default value:__ `zero` for plots with all of the following conditions are true: (1) the mark is `bar`, `area`, or `arc`; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, `null` by default.\n\n__See also:__ [`stack`](https://vega.github.io/vega-lite/docs/stack.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/Type",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "PositionDatumDefBase": {
+      "additionalProperties": false,
+      "properties": {
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "datum": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PrimitiveValue"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/RepeatRef"
+            }
+          ],
+          "description": "A constant value in data domain."
+        },
+        "scale": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scale"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+        },
+        "stack": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StackOffset"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Type of stacking offset if the field should be stacked. `stack` is only applicable for `x`, `y`, `theta`, and `radius` channels with continuous domains. For example, `stack` of `y` can be used to customize stacking for a vertical bar chart.\n\n`stack` can be one of the following values:\n- `\"zero\"` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and [area](https://vega.github.io/vega-lite/docs/stack.html#area) chart).\n- `\"normalize\"` - stacking with normalized domain (for creating [normalized stacked bar and area charts](https://vega.github.io/vega-lite/docs/stack.html#normalized) and pie charts [with percentage tooltip](https://vega.github.io/vega-lite/docs/arc.html#tooltip)). <br/>\n-`\"center\"` - stacking with center baseline (for [streamgraph](https://vega.github.io/vega-lite/docs/stack.html#streamgraph)).\n- `null` or `false` - No-stacking. This will produce layered [bar](https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart) and area chart.\n\n__Default value:__ `zero` for plots with all of the following conditions are true: (1) the mark is `bar`, `area`, or `arc`; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, `null` by default.\n\n__See also:__ [`stack`](https://vega.github.io/vega-lite/docs/stack.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/Type",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "PositionDef": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/PositionFieldDef"
+        },
+        {
+          "$ref": "#/definitions/PositionDatumDef"
+        },
+        {
+          "$ref": "#/definitions/PositionValueDef"
+        }
+      ]
+    },
+    "PositionFieldDef": {
+      "additionalProperties": false,
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "axis": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Axis"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of axis's gridlines, ticks and labels. If `null`, the axis for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [axis properties](https://vega.github.io/vega-lite/docs/axis.html) are applied.\n\n__See also:__ [`axis`](https://vega.github.io/vega-lite/docs/axis.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "const": "binned",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "impute": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ImputeParams"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining the properties of the Impute Operation to be applied. The field value of the other positional channel is taken as `key` of the `Impute` Operation. The field of the `color` channel if specified is used as `groupby` of the `Impute` Operation.\n\n__See also:__ [`impute`](https://vega.github.io/vega-lite/docs/impute.html) documentation."
+        },
+        "scale": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scale"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+        },
+        "sort": {
+          "$ref": "#/definitions/Sort",
+          "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+        },
+        "stack": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StackOffset"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Type of stacking offset if the field should be stacked. `stack` is only applicable for `x`, `y`, `theta`, and `radius` channels with continuous domains. For example, `stack` of `y` can be used to customize stacking for a vertical bar chart.\n\n`stack` can be one of the following values:\n- `\"zero\"` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and [area](https://vega.github.io/vega-lite/docs/stack.html#area) chart).\n- `\"normalize\"` - stacking with normalized domain (for creating [normalized stacked bar and area charts](https://vega.github.io/vega-lite/docs/stack.html#normalized) and pie charts [with percentage tooltip](https://vega.github.io/vega-lite/docs/arc.html#tooltip)). <br/>\n-`\"center\"` - stacking with center baseline (for [streamgraph](https://vega.github.io/vega-lite/docs/stack.html#streamgraph)).\n- `null` or `false` - No-stacking. This will produce layered [bar](https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart) and area chart.\n\n__Default value:__ `zero` for plots with all of the following conditions are true: (1) the mark is `bar`, `area`, or `arc`; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, `null` by default.\n\n__See also:__ [`stack`](https://vega.github.io/vega-lite/docs/stack.html) documentation."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "PositionFieldDefBase": {
+      "additionalProperties": false,
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "const": "binned",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "scale": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scale"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+        },
+        "sort": {
+          "$ref": "#/definitions/Sort",
+          "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+        },
+        "stack": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StackOffset"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Type of stacking offset if the field should be stacked. `stack` is only applicable for `x`, `y`, `theta`, and `radius` channels with continuous domains. For example, `stack` of `y` can be used to customize stacking for a vertical bar chart.\n\n`stack` can be one of the following values:\n- `\"zero\"` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and [area](https://vega.github.io/vega-lite/docs/stack.html#area) chart).\n- `\"normalize\"` - stacking with normalized domain (for creating [normalized stacked bar and area charts](https://vega.github.io/vega-lite/docs/stack.html#normalized) and pie charts [with percentage tooltip](https://vega.github.io/vega-lite/docs/arc.html#tooltip)). <br/>\n-`\"center\"` - stacking with center baseline (for [streamgraph](https://vega.github.io/vega-lite/docs/stack.html#streamgraph)).\n- `null` or `false` - No-stacking. This will produce layered [bar](https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart) and area chart.\n\n__Default value:__ `zero` for plots with all of the following conditions are true: (1) the mark is `bar`, `area`, or `arc`; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, `null` by default.\n\n__See also:__ [`stack`](https://vega.github.io/vega-lite/docs/stack.html) documentation."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "PositionValueDef": {
+      "$ref": "#/definitions/ValueDef<(number|\"width\"|\"height\"|ExprRef)>"
+    },
+    "Predicate": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/FieldEqualPredicate"
+        },
+        {
+          "$ref": "#/definitions/FieldRangePredicate"
+        },
+        {
+          "$ref": "#/definitions/FieldOneOfPredicate"
+        },
+        {
+          "$ref": "#/definitions/FieldLTPredicate"
+        },
+        {
+          "$ref": "#/definitions/FieldGTPredicate"
+        },
+        {
+          "$ref": "#/definitions/FieldLTEPredicate"
+        },
+        {
+          "$ref": "#/definitions/FieldGTEPredicate"
+        },
+        {
+          "$ref": "#/definitions/FieldValidPredicate"
+        },
+        {
+          "$ref": "#/definitions/ParameterPredicate"
+        },
+        {
+          "type": "string"
+        }
+      ]
+    },
+    "PrimitiveValue": {
+      "type": [
+        "number",
+        "string",
+        "boolean",
+        "null"
+      ]
+    },
+    "Projection": {
+      "additionalProperties": false,
+      "properties": {
+        "center": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Vector2<number>",
+              "description": "The projection's center, a two-element array of longitude and latitude in degrees.\n\n__Default value:__ `[0, 0]`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "clipAngle": {
+          "anyOf": [
+            {
+              "description": "The projection's clipping circle radius to the specified angle in degrees. If `null`, switches to [antimeridian](http://bl.ocks.org/mbostock/3788999) cutting rather than small-circle clipping.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "clipExtent": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Vector2<Vector2<number>>",
+              "description": "The projection's viewport clip extent to the specified bounds in pixels. The extent bounds are specified as an array `[[x0, y0], [x1, y1]]`, where `x0` is the left-side of the viewport, `y0` is the top, `x1` is the right and `y1` is the bottom. If `null`, no viewport clipping is performed."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "coefficient": {
+          "anyOf": [
+            {
+              "description": "The coefficient parameter for the `hammer` projection.\n\n__Default value:__ `2`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "distance": {
+          "anyOf": [
+            {
+              "description": "For the `satellite` projection, the distance from the center of the sphere to the point of view, as a proportion of the sphere’s radius. The recommended maximum clip angle for a given `distance` is acos(1 / distance) converted to degrees. If tilt is also applied, then more conservative clipping may be necessary.\n\n__Default value:__ `2.0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "extent": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Vector2<Vector2<number>>"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Fit"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/Fit"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fraction": {
+          "anyOf": [
+            {
+              "description": "The fraction parameter for the `bottomley` projection.\n\n__Default value:__ `0.5`, corresponding to a sin(ψ) where ψ = π/6.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lobes": {
+          "anyOf": [
+            {
+              "description": "The number of lobes in projections that support multi-lobe views: `berghaus`, `gingery`, or `healpix`. The default value varies based on the projection type.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "parallel": {
+          "anyOf": [
+            {
+              "description": "The parallel parameter for projections that support it: `armadillo`, `bonne`, `craig`, `cylindricalEqualArea`, `cylindricalStereographic`, `hammerRetroazimuthal`, `loximuthal`, or `rectangularPolyconic`. The default value varies based on the projection type.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "parallels": {
+          "anyOf": [
+            {
+              "description": "For conic projections, the [two standard parallels](https://en.wikipedia.org/wiki/Map_projection#Conic) that define the map layout. The default depends on the specific conic projection used.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "pointRadius": {
+          "anyOf": [
+            {
+              "description": "The default radius (in pixels) to use when drawing GeoJSON `Point` and `MultiPoint` geometries. This parameter sets a constant default value. To modify the point radius in response to data, see the corresponding parameter of the GeoPath and GeoShape transforms.\n\n__Default value:__ `4.5`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "precision": {
+          "anyOf": [
+            {
+              "description": "The threshold for the projection's [adaptive resampling](http://bl.ocks.org/mbostock/3795544) to the specified value in pixels. This value corresponds to the [Douglas–Peucker distance](http://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm). If precision is not specified, returns the projection's current resampling precision which defaults to `√0.5 ≅ 0.70710…`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "radius": {
+          "anyOf": [
+            {
+              "description": "The radius parameter for the `airy` or `gingery` projection. The default value varies based on the projection type.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ratio": {
+          "anyOf": [
+            {
+              "description": "The ratio parameter for the `hill`, `hufnagel`, or `wagner` projections. The default value varies based on the projection type.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "reflectX": {
+          "anyOf": [
+            {
+              "description": "Sets whether or not the x-dimension is reflected (negated) in the output.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "reflectY": {
+          "anyOf": [
+            {
+              "description": "Sets whether or not the y-dimension is reflected (negated) in the output.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "rotate": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Vector2<number>"
+                },
+                {
+                  "$ref": "#/definitions/Vector3<number>"
+                }
+              ],
+              "description": "The projection's three-axis rotation to the specified angles, which must be a two- or three-element array of numbers [`lambda`, `phi`, `gamma`] specifying the rotation angles in degrees about each spherical axis. (These correspond to yaw, pitch and roll.)\n\n__Default value:__ `[0, 0, 0]`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "scale": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The projection’s scale (zoom) factor, overriding automatic fitting. The default scale is projection-specific. The scale factor corresponds linearly to the distance between projected points; however, scale factor values are not equivalent across projections."
+        },
+        "size": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Vector2<number>",
+              "description": "Used in conjunction with fit, provides the width and height in pixels of the area to which the projection should be automatically fit."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "spacing": {
+          "anyOf": [
+            {
+              "description": "The spacing parameter for the `lagrange` projection.\n\n__Default value:__ `0.5`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tilt": {
+          "anyOf": [
+            {
+              "description": "The tilt angle (in degrees) for the `satellite` projection.\n\n__Default value:__ `0`.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "translate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Vector2<number>"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The projection’s translation offset as a two-element array `[tx, ty]`."
+        },
+        "type": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ProjectionType"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The cartographic projection to use. This value is case-insensitive, for example `\"albers\"` and `\"Albers\"` indicate the same projection type. You can find all valid projection types [in the documentation](https://vega.github.io/vega-lite/docs/projection.html#projection-types).\n\n__Default value:__ `equalEarth`"
+        }
+      },
+      "type": "object"
+    },
+    "ProjectionConfig": {
+      "$ref": "#/definitions/Projection",
+      "description": "Any property of Projection can be in config"
+    },
+    "ProjectionType": {
+      "enum": [
+        "albers",
+        "albersUsa",
+        "azimuthalEqualArea",
+        "azimuthalEquidistant",
+        "conicConformal",
+        "conicEqualArea",
+        "conicEquidistant",
+        "equalEarth",
+        "equirectangular",
+        "gnomonic",
+        "identity",
+        "mercator",
+        "naturalEarth1",
+        "orthographic",
+        "stereographic",
+        "transverseMercator"
+      ],
+      "type": "string"
+    },
+    "QuantileTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "description": "The output field names for the probability and quantile values.\n\n__Default value:__ `[\"prob\", \"value\"]`",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "maxItems": 2,
+          "minItems": 2,
+          "type": "array"
+        },
+        "groupby": {
+          "description": "The data fields to group by. If not specified, a single group containing all data objects will be used.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "probs": {
+          "description": "An array of probabilities in the range (0, 1) for which to compute quantile values. If not specified, the *step* parameter will be used.",
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        },
+        "quantile": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field for which to perform quantile estimation."
+        },
+        "step": {
+          "description": "A probability step size (default 0.01) for sampling quantile values. All values from one-half the step size up to 1 (exclusive) will be sampled. This parameter is only used if the *probs* parameter is not provided.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "quantile"
+      ],
+      "type": "object"
+    },
+    "RadialGradient": {
+      "additionalProperties": false,
+      "properties": {
+        "gradient": {
+          "const": "radial",
+          "description": "The type of gradient. Use `\"radial\"` for a radial gradient.",
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "r1": {
+          "description": "The radius length, in normalized [0, 1] coordinates, of the inner circle for the gradient.\n\n__Default value:__ `0`",
+          "type": "number"
+        },
+        "r2": {
+          "description": "The radius length, in normalized [0, 1] coordinates, of the outer circle for the gradient.\n\n__Default value:__ `0.5`",
+          "type": "number"
+        },
+        "stops": {
+          "description": "An array of gradient stops defining the gradient color sequence.",
+          "items": {
+            "$ref": "#/definitions/GradientStop"
+          },
+          "type": "array"
+        },
+        "x1": {
+          "description": "The x-coordinate, in normalized [0, 1] coordinates, for the center of the inner circle for the gradient.\n\n__Default value:__ `0.5`",
+          "type": "number"
+        },
+        "x2": {
+          "description": "The x-coordinate, in normalized [0, 1] coordinates, for the center of the outer circle for the gradient.\n\n__Default value:__ `0.5`",
+          "type": "number"
+        },
+        "y1": {
+          "description": "The y-coordinate, in normalized [0, 1] coordinates, for the center of the inner circle for the gradient.\n\n__Default value:__ `0.5`",
+          "type": "number"
+        },
+        "y2": {
+          "description": "The y-coordinate, in normalized [0, 1] coordinates, for the center of the outer circle for the gradient.\n\n__Default value:__ `0.5`",
+          "type": "number"
+        }
+      },
+      "required": [
+        "gradient",
+        "stops"
+      ],
+      "type": "object"
+    },
+    "RangeConfig": {
+      "additionalProperties": {
+        "anyOf": [
+          {
+            "$ref": "#/definitions/RangeScheme"
+          },
+          {
+            "type": "array"
+          }
+        ]
+      },
+      "properties": {
+        "category": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/RangeScheme"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/Color"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "Default [color scheme](https://vega.github.io/vega/docs/schemes/) for categorical data."
+        },
+        "diverging": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/RangeScheme"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/Color"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "Default [color scheme](https://vega.github.io/vega/docs/schemes/) for diverging quantitative ramps."
+        },
+        "heatmap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/RangeScheme"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/Color"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "Default [color scheme](https://vega.github.io/vega/docs/schemes/) for quantitative heatmaps."
+        },
+        "ordinal": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/RangeScheme"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/Color"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "Default [color scheme](https://vega.github.io/vega/docs/schemes/) for rank-ordered data."
+        },
+        "ramp": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/RangeScheme"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/Color"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "Default [color scheme](https://vega.github.io/vega/docs/schemes/) for sequential quantitative ramps."
+        },
+        "symbol": {
+          "description": "Array of [symbol](https://vega.github.io/vega/docs/marks/symbol/) names or paths for the default shape palette.",
+          "items": {
+            "$ref": "#/definitions/SymbolShape"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "RangeEnum": {
+      "enum": [
+        "width",
+        "height",
+        "symbol",
+        "category",
+        "ordinal",
+        "ramp",
+        "diverging",
+        "heatmap"
+      ],
+      "type": "string"
+    },
+    "RangeRaw": {
+      "items": {
+        "anyOf": [
+          {
+            "type": "null"
+          },
+          {
+            "type": "boolean"
+          },
+          {
+            "type": "string"
+          },
+          {
+            "type": "number"
+          },
+          {
+            "$ref": "#/definitions/RangeRawArray"
+          }
+        ]
+      },
+      "type": "array"
+    },
+    "RangeRawArray": {
+      "items": {
+        "type": "number"
+      },
+      "type": "array"
+    },
+    "RangeScheme": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/RangeEnum"
+        },
+        {
+          "$ref": "#/definitions/RangeRaw"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "count": {
+              "type": "number"
+            },
+            "extent": {
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            "scheme": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                {
+                  "$ref": "#/definitions/ColorScheme"
+                }
+              ]
+            }
+          },
+          "required": [
+            "scheme"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "RectConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule). One of `\"left\"`, `\"right\"`, `\"center\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "angle": {
+          "anyOf": [
+            {
+              "description": "The rotation angle of the text, in degrees.",
+              "maximum": 360,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG element, removing the mark item from the ARIA accessibility tree.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRole": {
+          "anyOf": [
+            {
+              "description": "Sets the type of user interface element of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"role\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRoleDescription": {
+          "anyOf": [
+            {
+              "description": "A human-readable, author-localized description for the role of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"aria-roledescription\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aspect": {
+          "anyOf": [
+            {
+              "description": "Whether to keep aspect ratio of image marks.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "baseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For text marks, the vertical text baseline. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, `\"line-bottom\"`, or an expression reference that provides one of the valid values. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the `lineHeight` rather than `fontSize` alone.\n\nFor range marks, the vertical alignment of the marks. One of `\"top\"`, `\"middle\"`, `\"bottom\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "binSpacing": {
+          "description": "Offset between bars for binned field. The ideal value for this is either 0 (preferred by statisticians) or 1 (Vega-Lite default, D3 example style).\n\n__Default value:__ `1`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "blend": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Blend",
+              "description": "The color blend mode for drawing an item on its current background. Any valid [CSS mix-blend-mode](https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode) value can be used.\n\n__Default value: `\"source-over\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "color": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default color.\n\n__Default value:__ <span style=\"color: #4682b4;\">&#9632;</span> `\"#4682b4\"`\n\n__Note:__\n- This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).\n- The `fill` and `stroke` properties have higher precedence than `color` and will override `color`."
+        },
+        "continuousBandSize": {
+          "description": "The default size of the bars on continuous scales.\n\n__Default value:__ `5`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "cornerRadius": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles or arcs' corners.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cursor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Cursor",
+              "description": "The mouse cursor used over the mark. Any valid [CSS cursor type](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values) can be used."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "description": {
+          "anyOf": [
+            {
+              "description": "A text description of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the [\"aria-label\" attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dir": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextDirection",
+              "description": "The direction of the text. One of `\"ltr\"` (left-to-right) or `\"rtl\"` (right-to-left). This property determines on which side is truncated in response to the limit parameter.\n\n__Default value:__ `\"ltr\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "discreteBandSize": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/RelativeBandSize"
+            }
+          ],
+          "description": "The default size of the bars with discrete dimensions. If unspecified, the default size is  `step-2`, which provides 2 pixel offset between bars.",
+          "minimum": 0
+        },
+        "dx": {
+          "anyOf": [
+            {
+              "description": "The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dy": {
+          "anyOf": [
+            {
+              "description": "The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ellipsis": {
+          "anyOf": [
+            {
+              "description": "The ellipsis string for text truncated in response to the limit parameter.\n\n__Default value:__ `\"…\"`",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "endAngle": {
+          "anyOf": [
+            {
+              "description": "The end angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fill": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default fill color. This property has higher precedence than `config.color`. Set to `null` to remove fill.\n\n__Default value:__ (None)"
+        },
+        "fillOpacity": {
+          "anyOf": [
+            {
+              "description": "The fill opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "filled": {
+          "description": "Whether the mark's color should be used as fill color instead of stroke color.\n\n__Default value:__ `false` for all `point`, `line`, and `rule` marks as well as `geoshape` marks for [`graticule`](https://vega.github.io/vega-lite/docs/data.html#graticule) data sources; otherwise, `true`.\n\n__Note:__ This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).",
+          "type": "boolean"
+        },
+        "font": {
+          "anyOf": [
+            {
+              "description": "The typeface to set the text in (e.g., `\"Helvetica Neue\"`).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontSize": {
+          "anyOf": [
+            {
+              "description": "The font size, in pixels.\n\n__Default value:__ `11`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "The font style (e.g., `\"italic\"`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "The font weight. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "height": {
+          "anyOf": [
+            {
+              "description": "Height of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "href": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "A URL to load upon mouse click. If defined, the mark acts as a hyperlink."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "innerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The inner radius in pixels of arc marks. `innerRadius` is an alias for `radius2`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "interpolate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Interpolate",
+              "description": "The line interpolation method to use for line and area marks. One of the following:\n- `\"linear\"`: piecewise linear segments, as in a polyline.\n- `\"linear-closed\"`: close the linear segments to form a polygon.\n- `\"step\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"step-before\"`: alternate between vertical and horizontal segments, as in a step function.\n- `\"step-after\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"basis\"`: a B-spline, with control point duplication on the ends.\n- `\"basis-open\"`: an open B-spline; may not intersect the start or end.\n- `\"basis-closed\"`: a closed B-spline, as in a loop.\n- `\"cardinal\"`: a Cardinal spline, with control point duplication on the ends.\n- `\"cardinal-open\"`: an open Cardinal spline; may not intersect the start or end, but will intersect other control points.\n- `\"cardinal-closed\"`: a closed Cardinal spline, as in a loop.\n- `\"bundle\"`: equivalent to basis, except the tension parameter is used to straighten the spline.\n- `\"monotone\"`: cubic interpolation that preserves monotonicity in y."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "invalid": {
+          "description": "Defines how Vega-Lite should handle marks for invalid values (`null` and `NaN`).\n- If set to `\"filter\"` (default), all data items with null values will be skipped (for line, trail, and area marks) or filtered (for other marks).\n- If `null`, all data items are included. In this case, invalid values will be interpreted as zeroes.",
+          "enum": [
+            "filter",
+            null
+          ],
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "limit": {
+          "anyOf": [
+            {
+              "description": "The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.\n\n__Default value:__ `0` -- indicating no limit",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineBreak": {
+          "anyOf": [
+            {
+              "description": "A delimiter, such as a newline character, upon which to break text strings into multiple lines. This property is ignored if the text is array-valued.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineHeight": {
+          "anyOf": [
+            {
+              "description": "The line height in pixels (the spacing between subsequent lines of text) for multi-line text marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "minBandSize": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The minimum band size for bar and rectangle marks. __Default value:__ `0.25`"
+        },
+        "opacity": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The overall opacity (value between [0,1]).\n\n__Default value:__ `0.7` for non-aggregate plots with `point`, `tick`, `circle`, or `square` marks or layered `bar` charts and `1` otherwise.",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "order": {
+          "description": "For line and trail marks, this `order` property can be set to `null` or `false` to make the lines use the original order in the data sources.",
+          "type": [
+            "null",
+            "boolean"
+          ]
+        },
+        "orient": {
+          "$ref": "#/definitions/Orientation",
+          "description": "The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.\n- For bar, rule and tick, this determines whether the size of the bar and tick should be applied to x or y dimension.\n- For area, this property determines the orient property of the Vega output.\n- For line and trail marks, this property determines the sort order of the points in the line if `config.sortLineBy` is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored."
+        },
+        "outerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The outer radius in pixels of arc marks. `outerRadius` is an alias for `radius`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "padAngle": {
+          "anyOf": [
+            {
+              "description": "The angular padding applied to sides of the arc, in radians.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "radius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For arc mark, the primary (outer) radius in pixels.\n\nFor text marks, polar coordinate radial offset, in pixels, of the text from the origin determined by the `x` and `y` properties.\n\n__Default value:__ `min(plot_width, plot_height)/2`",
+          "minimum": 0
+        },
+        "radius2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The secondary (inner) radius in pixels of arc marks.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "shape": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/SymbolShape"
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "description": "Shape of the point marks. Supported values include:\n- plotting shapes: `\"circle\"`, `\"square\"`, `\"cross\"`, `\"diamond\"`, `\"triangle-up\"`, `\"triangle-down\"`, `\"triangle-right\"`, or `\"triangle-left\"`.\n- the line symbol `\"stroke\"`\n- centered directional shapes `\"arrow\"`, `\"wedge\"`, or `\"triangle\"`\n- a custom [SVG path string](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths) (For correct sizing, custom shape paths should be defined within a square bounding box with coordinates ranging from -1 to 1 along both the x and y dimensions.)\n\n__Default value:__ `\"circle\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "size": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default size for marks.\n- For `point`/`circle`/`square`, this represents the pixel area of the marks. Note that this value sets the area of the symbol; the side lengths will increase with the square root of this value.\n- For `bar`, this represents the band size of the bar, in pixels.\n- For `text`, this represents the font size, in pixels.\n\n__Default value:__\n- `30` for point, circle, square marks; width/height's `step`\n- `2` for bar marks with discrete dimensions;\n- `5` for bar marks with continuous dimensions;\n- `11` for text marks.",
+          "minimum": 0
+        },
+        "smooth": {
+          "anyOf": [
+            {
+              "description": "A boolean flag (default true) indicating if the image should be smoothed when resized. If false, individual pixels should be scaled directly rather than interpolated with smoothing. For SVG rendering, this option may not work in some browsers due to lack of standardization.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "startAngle": {
+          "anyOf": [
+            {
+              "description": "The start angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "stroke": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default stroke color. This property has higher precedence than `config.color`. Set to `null` to remove stroke.\n\n__Default value:__ (None)"
+        },
+        "strokeCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for line ending style. One of `\"butt\"`, `\"round\"`, or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating stroke, space lengths for creating dashed or dotted lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDashOffset": {
+          "anyOf": [
+            {
+              "description": "The offset (in pixels) into which to begin drawing with the stroke dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeJoin": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeJoin",
+              "description": "The stroke line join method. One of `\"miter\"`, `\"round\"` or `\"bevel\"`.\n\n__Default value:__ `\"miter\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeMiterLimit": {
+          "anyOf": [
+            {
+              "description": "The miter limit at which to bevel a line join.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOffset": {
+          "anyOf": [
+            {
+              "description": "The offset in pixels at which to draw the group stroke and fill. If unspecified, the default behavior is to dynamically offset stroked groups such that 1 pixel stroke widths align with the pixel grid.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOpacity": {
+          "anyOf": [
+            {
+              "description": "The stroke opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeWidth": {
+          "anyOf": [
+            {
+              "description": "The stroke width, in pixels.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tension": {
+          "anyOf": [
+            {
+              "description": "Depending on the interpolation type, sets the tension parameter (for line and area marks).",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "text": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text",
+              "description": "Placeholder text if the `text` channel is not specified"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "theta": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "- For arc marks, the arc length in radians if theta2 is not specified, otherwise the start arc angle. (A value of 0 indicates up or “north”, increasing values proceed clockwise.)\n\n- For text marks, polar coordinate angle in radians.",
+          "maximum": 360,
+          "minimum": 0
+        },
+        "theta2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The end angle of arc marks in radians. A value of 0 indicates up or “north”, increasing values proceed clockwise."
+        },
+        "timeUnitBandPosition": {
+          "description": "Default relative band position for a time unit. If set to `0`, the marks will be positioned at the beginning of the time unit band step. If set to `0.5`, the marks will be positioned in the middle of the time unit band step.",
+          "type": "number"
+        },
+        "timeUnitBandSize": {
+          "description": "Default relative band size for a time unit. If set to `1`, the bandwidth of the marks will be equal to the time unit band step. If set to `0.5`, bandwidth of the marks will be half of the time unit band step.",
+          "type": "number"
+        },
+        "tooltip": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/TooltipContent"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The tooltip text string to show upon mouse hover or an object defining which fields should the tooltip be derived from.\n\n- If `tooltip` is `true` or `{\"content\": \"encoding\"}`, then all fields from `encoding` will be used.\n- If `tooltip` is `{\"content\": \"data\"}`, then all fields that appear in the highlighted data point will be used.\n- If set to `null` or `false`, then no tooltip will be used.\n\nSee the [`tooltip`](https://vega.github.io/vega-lite/docs/tooltip.html) documentation for a detailed discussion about tooltip  in Vega-Lite.\n\n__Default value:__ `null`"
+        },
+        "url": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "The URL of the image file for image marks."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "width": {
+          "anyOf": [
+            {
+              "description": "Width of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "x": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X coordinates of the marks, or width of horizontal `\"bar\"` and `\"area\"` without specified `x2` or `width`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "x2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "y": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y coordinates of the marks, or height of vertical `\"bar\"` and `\"area\"` without specified `y2` or `height`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "y2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        }
+      },
+      "type": "object"
+    },
+    "RegressionTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "description": "The output field names for the smoothed points generated by the regression transform.\n\n__Default value:__ The field names of the input x and y values.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "maxItems": 2,
+          "minItems": 2,
+          "type": "array"
+        },
+        "extent": {
+          "description": "A [min, max] domain over the independent (x) field for the starting and ending points of the generated trend line.",
+          "items": {
+            "type": "number"
+          },
+          "maxItems": 2,
+          "minItems": 2,
+          "type": "array"
+        },
+        "groupby": {
+          "description": "The data fields to group by. If not specified, a single group containing all data objects will be used.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "method": {
+          "description": "The functional form of the regression model. One of `\"linear\"`, `\"log\"`, `\"exp\"`, `\"pow\"`, `\"quad\"`, or `\"poly\"`.\n\n__Default value:__ `\"linear\"`",
+          "enum": [
+            "linear",
+            "log",
+            "exp",
+            "pow",
+            "quad",
+            "poly"
+          ],
+          "type": "string"
+        },
+        "on": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field of the independent variable to use a predictor."
+        },
+        "order": {
+          "description": "The polynomial order (number of coefficients) for the 'poly' method.\n\n__Default value:__ `3`",
+          "type": "number"
+        },
+        "params": {
+          "description": "A boolean flag indicating if the transform should return the regression model parameters (one object per group), rather than trend line points. The resulting objects include a `coef` array of fitted coefficient values (starting with the intercept term and then including terms of increasing order) and an `rSquared` value (indicating the total variance explained by the model).\n\n__Default value:__ `false`",
+          "type": "boolean"
+        },
+        "regression": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field of the dependent variable to predict."
+        }
+      },
+      "required": [
+        "regression",
+        "on"
+      ],
+      "type": "object"
+    },
+    "RelativeBandSize": {
+      "additionalProperties": false,
+      "properties": {
+        "band": {
+          "description": "The relative band size.  For example `0.5` means half of the band scale's band width.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "band"
+      ],
+      "type": "object"
+    },
+    "RepeatMapping": {
+      "additionalProperties": false,
+      "properties": {
+        "column": {
+          "description": "An array of fields to be repeated horizontally.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "row": {
+          "description": "An array of fields to be repeated vertically.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "RepeatRef": {
+      "additionalProperties": false,
+      "description": "Reference to a repeated value.",
+      "properties": {
+        "repeat": {
+          "enum": [
+            "row",
+            "column",
+            "repeat",
+            "layer"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "repeat"
+      ],
+      "type": "object"
+    },
+    "RepeatSpec": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/NonLayerRepeatSpec"
+        },
+        {
+          "$ref": "#/definitions/LayerRepeatSpec"
+        }
+      ]
+    },
+    "Resolve": {
+      "additionalProperties": false,
+      "description": "Defines how scales, axes, and legends from different specs should be combined. Resolve is a mapping from `scale`, `axis`, and `legend` to a mapping from channels to resolutions. Scales and guides can be resolved to be `\"independent\"` or `\"shared\"`.",
+      "properties": {
+        "axis": {
+          "$ref": "#/definitions/AxisResolveMap"
+        },
+        "legend": {
+          "$ref": "#/definitions/LegendResolveMap"
+        },
+        "scale": {
+          "$ref": "#/definitions/ScaleResolveMap"
+        }
+      },
+      "type": "object"
+    },
+    "ResolveMode": {
+      "enum": [
+        "independent",
+        "shared"
+      ],
+      "type": "string"
+    },
+    "RowCol<LayoutAlign>": {
+      "additionalProperties": false,
+      "properties": {
+        "column": {
+          "$ref": "#/definitions/LayoutAlign"
+        },
+        "row": {
+          "$ref": "#/definitions/LayoutAlign"
+        }
+      },
+      "type": "object"
+    },
+    "RowCol<boolean>": {
+      "additionalProperties": false,
+      "properties": {
+        "column": {
+          "type": "boolean"
+        },
+        "row": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "RowCol<number>": {
+      "additionalProperties": false,
+      "properties": {
+        "column": {
+          "type": "number"
+        },
+        "row": {
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "RowColumnEncodingFieldDef": {
+      "additionalProperties": false,
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "align": {
+          "$ref": "#/definitions/LayoutAlign",
+          "description": "The alignment to apply to row/column facet's subplot. The supported string values are `\"all\"`, `\"each\"`, and `\"none\"`.\n\n- For `\"none\"`, a flow layout will be used, in which adjacent subviews are simply placed one after the other.\n- For `\"each\"`, subviews will be aligned into a clean grid structure, but each row or column may be of variable size.\n- For `\"all\"`, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns.\n\n__Default value:__ `\"all\"`."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "center": {
+          "description": "Boolean flag indicating if facet's subviews should be centered relative to their respective rows or columns.\n\n__Default value:__ `false`",
+          "type": "boolean"
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "header": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Header"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of a facet's header."
+        },
+        "sort": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SortArray"
+            },
+            {
+              "$ref": "#/definitions/SortOrder"
+            },
+            {
+              "$ref": "#/definitions/EncodingSortField"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` is not supported for `row` and `column`."
+        },
+        "spacing": {
+          "description": "The spacing in pixels between facet's sub-views.\n\n__Default value__: Depends on `\"spacing\"` property of [the view composition configuration](https://vega.github.io/vega-lite/docs/config.html#view-config) (`20` by default)",
+          "type": "number"
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "SampleTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "sample": {
+          "description": "The maximum number of data objects to include in the sample.\n\n__Default value:__ `1000`",
+          "type": "number"
+        }
+      },
+      "required": [
+        "sample"
+      ],
+      "type": "object"
+    },
+    "Scale": {
+      "additionalProperties": false,
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The alignment of the steps within the scale range.\n\nThis value must lie in the range `[0,1]`. A value of `0.5` indicates that the steps should be centered within the range. A value of `0` or `1` may be used to shift the bands to one side, say to position them adjacent to an axis.\n\n__Default value:__ `0.5`"
+        },
+        "base": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The logarithm base of the `log` scale (default `10`)."
+        },
+        "bins": {
+          "$ref": "#/definitions/ScaleBins",
+          "description": "Bin boundaries can be provided to scales as either an explicit array of bin boundaries or as a bin specification object. The legal values are:\n- An [array](../types/#Array) literal of bin boundary values. For example, `[0, 5, 10, 15, 20]`. The array must include both starting and ending boundaries. The previous example uses five values to indicate a total of four bin intervals: [0-5), [5-10), [10-15), [15-20]. Array literals may include signal references as elements.\n- A [bin specification object](https://vega.github.io/vega-lite/docs/scale.html#bins) that indicates the bin _step_ size, and optionally the _start_ and _stop_ boundaries.\n- An array of bin boundaries over the scale domain. If provided, axes and legends will use the bin boundaries to inform the choice of tick marks and text labels."
+        },
+        "clamp": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "If `true`, values that exceed the data domain are clamped to either the minimum or maximum range value\n\n__Default value:__ derived from the [scale config](https://vega.github.io/vega-lite/docs/config.html#scale-config)'s `clamp` (`true` by default)."
+        },
+        "constant": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant determining the slope of the symlog function around zero. Only used for `symlog` scales.\n\n__Default value:__ `1`"
+        },
+        "domain": {
+          "anyOf": [
+            {
+              "items": {
+                "anyOf": [
+                  {
+                    "type": "null"
+                  },
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "$ref": "#/definitions/DateTime"
+                  },
+                  {
+                    "$ref": "#/definitions/ExprRef"
+                  }
+                ]
+              },
+              "type": "array"
+            },
+            {
+              "const": "unaggregated",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ParameterExtent"
+            },
+            {
+              "$ref": "#/definitions/DomainUnionWith"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Customized domain values in the form of constant values or dynamic values driven by a parameter.\n\n1) Constant `domain` for _quantitative_ fields can take one of the following forms:\n\n- A two-element array with minimum and maximum values. To create a diverging scale, this two-element array can be combined with the `domainMid` property.\n- An array with more than two entries, for [Piecewise quantitative scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise).\n- A string value `\"unaggregated\"`, if the input field is aggregated, to indicate that the domain should include the raw data values prior to the aggregation.\n\n2) Constant `domain` for _temporal_ fields can be a two-element array with minimum and maximum values, in the form of either timestamps or the [DateTime definition objects](https://vega.github.io/vega-lite/docs/types.html#datetime).\n\n3) Constant `domain` for _ordinal_ and _nominal_ fields can be an array that lists valid input values.\n\n4) To combine (union) specified constant domain with the field's values, `domain` can be an object with a `unionWith` property that specify constant domain to be combined. For example, `domain: {unionWith: [0, 100]}` for a quantitative scale means that the scale domain always includes `[0, 100]`, but will include other values in the fields beyond `[0, 100]`.\n\n5) Domain can also takes an object defining a field or encoding of a parameter that [interactively determines](https://vega.github.io/vega-lite/docs/selection.html#scale-domains) the scale domain."
+        },
+        "domainMax": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Sets the maximum value in the scale domain, overriding the `domain` property. This property is only intended for use with scales having continuous domains."
+        },
+        "domainMid": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Inserts a single mid-point value into a two-element domain. The mid-point value must lie between the domain minimum and maximum values. This property can be useful for setting a midpoint for [diverging color scales](https://vega.github.io/vega-lite/docs/scale.html#piecewise). The domainMid property is only intended for use with scales supporting continuous, piecewise domains."
+        },
+        "domainMin": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Sets the minimum value in the scale domain, overriding the domain property. This property is only intended for use with scales having continuous domains."
+        },
+        "domainRaw": {
+          "$ref": "#/definitions/ExprRef",
+          "description": "An expression for an array of raw values that, if non-null, directly overrides the _domain_ property. This is useful for supporting interactions such as panning or zooming a scale. The scale may be initially determined using a data-driven domain, then modified in response to user input by setting the rawDomain value."
+        },
+        "exponent": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The exponent of the `pow` scale."
+        },
+        "interpolate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ScaleInterpolateEnum"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/ScaleInterpolateParams"
+            }
+          ],
+          "description": "The interpolation method for range values. By default, a general interpolator for numbers, dates, strings and colors (in HCL space) is used. For color ranges, this property allows interpolation in alternative color spaces. Legal values include `rgb`, `hsl`, `hsl-long`, `lab`, `hcl`, `hcl-long`, `cubehelix` and `cubehelix-long` ('-long' variants use longer paths in polar coordinate spaces). If object-valued, this property accepts an object with a string-valued _type_ property and an optional numeric _gamma_ property applicable to rgb and cubehelix interpolators. For more, see the [d3-interpolate documentation](https://github.com/d3/d3-interpolate).\n\n* __Default value:__ `hcl`"
+        },
+        "nice": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/TimeInterval"
+            },
+            {
+              "$ref": "#/definitions/TimeIntervalStep"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Extending the domain so that it starts and ends on nice round values. This method typically modifies the scale’s domain, and may only extend the bounds to the nearest round value. Nicing is useful if the domain is computed from data and may be irregular. For example, for a domain of _[0.201479…, 0.996679…]_, a nice domain might be _[0.2, 1.0]_.\n\nFor quantitative scales such as linear, `nice` can be either a boolean flag or a number. If `nice` is a number, it will represent a desired tick count. This allows greater control over the step size used to extend the bounds, guaranteeing that the returned ticks will exactly cover the domain.\n\nFor temporal fields with time and utc scales, the `nice` value can be a string indicating the desired time interval. Legal values are `\"millisecond\"`, `\"second\"`, `\"minute\"`, `\"hour\"`, `\"day\"`, `\"week\"`, `\"month\"`, and `\"year\"`. Alternatively, `time` and `utc` scales can accept an object-valued interval specifier of the form `{\"interval\": \"month\", \"step\": 3}`, which includes a desired number of interval steps. Here, the domain would snap to quarter (Jan, Apr, Jul, Oct) boundaries.\n\n__Default value:__ `true` for unbinned _quantitative_ fields without explicit domain bounds; `false` otherwise."
+        },
+        "padding": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For _[continuous](https://vega.github.io/vega-lite/docs/scale.html#continuous)_ scales, expands the scale domain to accommodate the specified number of pixels on each of the scale range. The scale range must represent pixels for this parameter to function as intended. Padding adjustment is performed prior to all other adjustments, including the effects of the `zero`, `nice`, `domainMin`, and `domainMax` properties.\n\nFor _[band](https://vega.github.io/vega-lite/docs/scale.html#band)_ scales, shortcut for setting `paddingInner` and `paddingOuter` to the same value.\n\nFor _[point](https://vega.github.io/vega-lite/docs/scale.html#point)_ scales, alias for `paddingOuter`.\n\n__Default value:__ For _continuous_ scales, derived from the [scale config](https://vega.github.io/vega-lite/docs/scale.html#config)'s `continuousPadding`. For _band and point_ scales, see `paddingInner` and `paddingOuter`. By default, Vega-Lite sets padding such that _width/height = number of unique values * step_.",
+          "minimum": 0
+        },
+        "paddingInner": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The inner padding (spacing) within each band step of band scales, as a fraction of the step size. This value must lie in the range [0,1].\n\nFor point scale, this property is invalid as point scales do not have internal band widths (only step sizes between bands).\n\n__Default value:__ derived from the [scale config](https://vega.github.io/vega-lite/docs/scale.html#config)'s `bandPaddingInner`.",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "paddingOuter": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The outer padding (spacing) at the ends of the range of band and point scales, as a fraction of the step size. This value must lie in the range [0,1].\n\n__Default value:__ derived from the [scale config](https://vega.github.io/vega-lite/docs/scale.html#config)'s `bandPaddingOuter` for band scales and `pointPadding` for point scales. By default, Vega-Lite sets outer padding such that _width/height = number of unique values * step_.",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "range": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/RangeEnum"
+            },
+            {
+              "items": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "items": {
+                      "type": "number"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "$ref": "#/definitions/ExprRef"
+                  }
+                ]
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/FieldRange"
+            }
+          ],
+          "description": "The range of the scale. One of:\n\n- A string indicating a [pre-defined named scale range](https://vega.github.io/vega-lite/docs/scale.html#range-config) (e.g., example, `\"symbol\"`, or `\"diverging\"`).\n\n- For [continuous scales](https://vega.github.io/vega-lite/docs/scale.html#continuous), two-element array indicating  minimum and maximum values, or an array with more than two entries for specifying a [piecewise scale](https://vega.github.io/vega-lite/docs/scale.html#piecewise).\n\n- For [discrete](https://vega.github.io/vega-lite/docs/scale.html#discrete) and [discretizing](https://vega.github.io/vega-lite/docs/scale.html#discretizing) scales, an array of desired output values or an object with a `field` property representing the range values.  For example, if a field `color` contains CSS color names, we can set `range` to `{field: \"color\"}`.\n\n__Notes:__\n\n1) For color scales you can also specify a color [`scheme`](https://vega.github.io/vega-lite/docs/scale.html#scheme) instead of `range`.\n\n2) Any directly specified `range` for `x` and `y` channels will be ignored. Range can be customized via the view's corresponding [size](https://vega.github.io/vega-lite/docs/size.html) (`width` and `height`)."
+        },
+        "rangeMax": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Sets the maximum value in the scale range, overriding the `range` property or the default range. This property is only intended for use with scales having continuous ranges."
+        },
+        "rangeMin": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Sets the minimum value in the scale range, overriding the `range` property or the default range. This property is only intended for use with scales having continuous ranges."
+        },
+        "reverse": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "If true, reverses the order of the scale range. __Default value:__ `false`."
+        },
+        "round": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "If `true`, rounds numeric output values to integers. This can be helpful for snapping to the pixel grid.\n\n__Default value:__ `false`."
+        },
+        "scheme": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ColorScheme"
+            },
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/SchemeParams"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A string indicating a color [scheme](https://vega.github.io/vega-lite/docs/scale.html#scheme) name (e.g., `\"category10\"` or `\"blues\"`) or a [scheme parameter object](https://vega.github.io/vega-lite/docs/scale.html#scheme-params).\n\nDiscrete color schemes may be used with [discrete](https://vega.github.io/vega-lite/docs/scale.html#discrete) or [discretizing](https://vega.github.io/vega-lite/docs/scale.html#discretizing) scales. Continuous color schemes are intended for use with color scales.\n\nFor the full list of supported schemes, please refer to the [Vega Scheme](https://vega.github.io/vega/docs/schemes/#reference) reference."
+        },
+        "type": {
+          "$ref": "#/definitions/ScaleType",
+          "description": "The type of scale. Vega-Lite supports the following categories of scale types:\n\n1) [**Continuous Scales**](https://vega.github.io/vega-lite/docs/scale.html#continuous) -- mapping continuous domains to continuous output ranges ([`\"linear\"`](https://vega.github.io/vega-lite/docs/scale.html#linear), [`\"pow\"`](https://vega.github.io/vega-lite/docs/scale.html#pow), [`\"sqrt\"`](https://vega.github.io/vega-lite/docs/scale.html#sqrt), [`\"symlog\"`](https://vega.github.io/vega-lite/docs/scale.html#symlog), [`\"log\"`](https://vega.github.io/vega-lite/docs/scale.html#log), [`\"time\"`](https://vega.github.io/vega-lite/docs/scale.html#time), [`\"utc\"`](https://vega.github.io/vega-lite/docs/scale.html#utc).\n\n2) [**Discrete Scales**](https://vega.github.io/vega-lite/docs/scale.html#discrete) -- mapping discrete domains to discrete ([`\"ordinal\"`](https://vega.github.io/vega-lite/docs/scale.html#ordinal)) or continuous ([`\"band\"`](https://vega.github.io/vega-lite/docs/scale.html#band) and [`\"point\"`](https://vega.github.io/vega-lite/docs/scale.html#point)) output ranges.\n\n3) [**Discretizing Scales**](https://vega.github.io/vega-lite/docs/scale.html#discretizing) -- mapping continuous domains to discrete output ranges [`\"bin-ordinal\"`](https://vega.github.io/vega-lite/docs/scale.html#bin-ordinal), [`\"quantile\"`](https://vega.github.io/vega-lite/docs/scale.html#quantile), [`\"quantize\"`](https://vega.github.io/vega-lite/docs/scale.html#quantize) and [`\"threshold\"`](https://vega.github.io/vega-lite/docs/scale.html#threshold).\n\n__Default value:__ please see the [scale type table](https://vega.github.io/vega-lite/docs/scale.html#type)."
+        },
+        "zero": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "If `true`, ensures that a zero baseline value is included in the scale domain.\n\n__Default value:__ `true` for x and y channels if the quantitative field is not binned and no custom `domain` is provided; `false` otherwise.\n\n__Note:__ Log, time, and utc scales do not support `zero`."
+        }
+      },
+      "type": "object"
+    },
+    "ScaleBinParams": {
+      "additionalProperties": false,
+      "properties": {
+        "start": {
+          "description": "The starting (lowest-valued) bin boundary.\n\n__Default value:__ The lowest value of the scale domain will be used.",
+          "type": "number"
+        },
+        "step": {
+          "description": "The step size defining the bin interval width.",
+          "type": "number"
+        },
+        "stop": {
+          "description": "The stopping (highest-valued) bin boundary.\n\n__Default value:__ The highest value of the scale domain will be used.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "step"
+      ],
+      "type": "object"
+    },
+    "ScaleBins": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        },
+        {
+          "$ref": "#/definitions/ScaleBinParams"
+        }
+      ]
+    },
+    "ScaleConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "bandPaddingInner": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default inner padding for `x` and `y` band scales.\n\n__Default value:__\n- `nestedOffsetPaddingInner` for x/y scales with nested x/y offset scales.\n- `barBandPaddingInner` for bar marks (`0.1` by default)\n- `rectBandPaddingInner` for rect and other marks (`0` by default)",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "bandPaddingOuter": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default outer padding for `x` and `y` band scales.\n\n__Default value:__ `paddingInner/2` (which makes _width/height = number of unique values * step_)",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "bandWithNestedOffsetPaddingInner": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default inner padding for `x` and `y` band scales with nested `xOffset` and `yOffset` encoding.\n\n__Default value:__ `0.2`",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "bandWithNestedOffsetPaddingOuter": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default outer padding for `x` and `y` band scales with nested `xOffset` and `yOffset` encoding.\n\n__Default value:__ `0.2`",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "barBandPaddingInner": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default inner padding for `x` and `y` band-ordinal scales of `\"bar\"` marks.\n\n__Default value:__ `0.1`",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "clamp": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "If true, values that exceed the data domain are clamped to either the minimum or maximum range value"
+        },
+        "continuousPadding": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default padding for continuous x/y scales.\n\n__Default:__ The bar width for continuous x-scale of a vertical bar and continuous y-scale of a horizontal bar.; `0` otherwise.",
+          "minimum": 0
+        },
+        "maxBandSize": {
+          "description": "The default max value for mapping quantitative fields to bar's size/bandSize.\n\nIf undefined (default), we will use the axis's size (width or height) - 1.",
+          "minimum": 0,
+          "type": "number"
+        },
+        "maxFontSize": {
+          "description": "The default max value for mapping quantitative fields to text's size/fontSize.\n\n__Default value:__ `40`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "maxOpacity": {
+          "description": "Default max opacity for mapping a field to opacity.\n\n__Default value:__ `0.8`",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "maxSize": {
+          "description": "Default max value for point size scale.",
+          "minimum": 0,
+          "type": "number"
+        },
+        "maxStrokeWidth": {
+          "description": "Default max strokeWidth for the scale of strokeWidth for rule and line marks and of size for trail marks.\n\n__Default value:__ `4`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "minBandSize": {
+          "description": "The default min value for mapping quantitative fields to bar and tick's size/bandSize scale with zero=false.\n\n__Default value:__ `2`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "minFontSize": {
+          "description": "The default min value for mapping quantitative fields to tick's size/fontSize scale with zero=false\n\n__Default value:__ `8`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "minOpacity": {
+          "description": "Default minimum opacity for mapping a field to opacity.\n\n__Default value:__ `0.3`",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "minSize": {
+          "description": "Default minimum value for point size scale with zero=false.\n\n__Default value:__ `9`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "minStrokeWidth": {
+          "description": "Default minimum strokeWidth for the scale of strokeWidth for rule and line marks and of size for trail marks with zero=false.\n\n__Default value:__ `1`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "offsetBandPaddingInner": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default padding inner for xOffset/yOffset's band scales.\n\n__Default Value:__ `0`"
+        },
+        "offsetBandPaddingOuter": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default padding outer for xOffset/yOffset's band scales.\n\n__Default Value:__ `0`"
+        },
+        "pointPadding": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default outer padding for `x` and `y` point-ordinal scales.\n\n__Default value:__ `0.5` (which makes _width/height = number of unique values * step_)",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "quantileCount": {
+          "description": "Default range cardinality for [`quantile`](https://vega.github.io/vega-lite/docs/scale.html#quantile) scale.\n\n__Default value:__ `4`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "quantizeCount": {
+          "description": "Default range cardinality for [`quantize`](https://vega.github.io/vega-lite/docs/scale.html#quantize) scale.\n\n__Default value:__ `4`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "rectBandPaddingInner": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default inner padding for `x` and `y` band-ordinal scales of `\"rect\"` marks.\n\n__Default value:__ `0`",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "round": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "If true, rounds numeric output values to integers. This can be helpful for snapping to the pixel grid. (Only available for `x`, `y`, and `size` scales.)"
+        },
+        "useUnaggregatedDomain": {
+          "description": "Use the source data range before aggregation as scale domain instead of aggregated data for aggregate axis.\n\nThis is equivalent to setting `domain` to `\"unaggregate\"` for aggregated _quantitative_ fields by default.\n\nThis property only works with aggregate functions that produce values within the raw data domain (`\"mean\"`, `\"average\"`, `\"median\"`, `\"q1\"`, `\"q3\"`, `\"min\"`, `\"max\"`). For other aggregations that produce values outside of the raw data domain (e.g. `\"count\"`, `\"sum\"`), this property is ignored.\n\n__Default value:__ `false`",
+          "type": "boolean"
+        },
+        "xReverse": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Reverse x-scale by default (useful for right-to-left charts)."
+        },
+        "zero": {
+          "description": "Default `scale.zero` for [`continuous`](https://vega.github.io/vega-lite/docs/scale.html#continuous) scales except for (1) x/y-scales of non-ranged bar or area charts and (2) size scales.\n\n__Default value:__ `true`",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "ScaleDatumDef": {
+      "additionalProperties": false,
+      "properties": {
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "datum": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PrimitiveValue"
+            },
+            {
+              "$ref": "#/definitions/DateTime"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "$ref": "#/definitions/RepeatRef"
+            }
+          ],
+          "description": "A constant value in data domain."
+        },
+        "scale": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scale"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/Type",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "ScaleFieldDef": {
+      "additionalProperties": false,
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "scale": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Scale"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+        },
+        "sort": {
+          "$ref": "#/definitions/Sort",
+          "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "ScaleInterpolateEnum": {
+      "enum": [
+        "rgb",
+        "lab",
+        "hcl",
+        "hsl",
+        "hsl-long",
+        "hcl-long",
+        "cubehelix",
+        "cubehelix-long"
+      ],
+      "type": "string"
+    },
+    "ScaleInterpolateParams": {
+      "additionalProperties": false,
+      "properties": {
+        "gamma": {
+          "type": "number"
+        },
+        "type": {
+          "enum": [
+            "rgb",
+            "cubehelix",
+            "cubehelix-long"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "type": "object"
+    },
+    "ScaleResolveMap": {
+      "additionalProperties": false,
+      "properties": {
+        "angle": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "color": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "fill": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "fillOpacity": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "opacity": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "radius": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "shape": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "size": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "stroke": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "strokeDash": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "strokeOpacity": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "strokeWidth": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "theta": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "x": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "xOffset": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "y": {
+          "$ref": "#/definitions/ResolveMode"
+        },
+        "yOffset": {
+          "$ref": "#/definitions/ResolveMode"
+        }
+      },
+      "type": "object"
+    },
+    "ScaleType": {
+      "enum": [
+        "linear",
+        "log",
+        "pow",
+        "sqrt",
+        "symlog",
+        "identity",
+        "sequential",
+        "time",
+        "utc",
+        "quantile",
+        "quantize",
+        "threshold",
+        "bin-ordinal",
+        "ordinal",
+        "point",
+        "band"
+      ],
+      "type": "string"
+    },
+    "SchemeParams": {
+      "additionalProperties": false,
+      "properties": {
+        "count": {
+          "description": "The number of colors to use in the scheme. This can be useful for scale types such as `\"quantize\"`, which use the length of the scale range to determine the number of discrete bins for the scale domain.",
+          "type": "number"
+        },
+        "extent": {
+          "description": "The extent of the color range to use. For example `[0.2, 1]` will rescale the color scheme such that color values in the range _[0, 0.2)_ are excluded from the scheme.",
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        },
+        "name": {
+          "$ref": "#/definitions/ColorScheme",
+          "description": "A color scheme name for ordinal scales (e.g., `\"category10\"` or `\"blues\"`).\n\nFor the full list of supported schemes, please refer to the [Vega Scheme](https://vega.github.io/vega/docs/schemes/#reference) reference."
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "type": "object"
+    },
+    "SecondaryFieldDef": {
+      "additionalProperties": false,
+      "description": "A field definition of a secondary channel that shares a scale with another primary channel. For example, `x2`, `xError` and `xError2` share the same scale with `x`.",
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+          "type": "null"
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        }
+      },
+      "type": "object"
+    },
+    "SelectionConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "interval": {
+          "$ref": "#/definitions/IntervalSelectionConfigWithoutType",
+          "description": "The default definition for an [`interval`](https://vega.github.io/vega-lite/docs/parameter.html#select) selection. All properties and transformations for an interval selection definition (except `type`) may be specified here.\n\nFor instance, setting `interval` to `{\"translate\": false}` disables the ability to move interval selections by default."
+        },
+        "point": {
+          "$ref": "#/definitions/PointSelectionConfigWithoutType",
+          "description": "The default definition for a [`point`](https://vega.github.io/vega-lite/docs/parameter.html#select) selection. All properties and transformations  for a point selection definition (except `type`) may be specified here.\n\nFor instance, setting `point` to `{\"on\": \"dblclick\"}` populates point selections on double-click by default."
+        }
+      },
+      "type": "object"
+    },
+    "SelectionInit": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/PrimitiveValue"
+        },
+        {
+          "$ref": "#/definitions/DateTime"
+        }
+      ]
+    },
+    "SelectionInitInterval": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/Vector2<boolean>"
+        },
+        {
+          "$ref": "#/definitions/Vector2<number>"
+        },
+        {
+          "$ref": "#/definitions/Vector2<string>"
+        },
+        {
+          "$ref": "#/definitions/Vector2<DateTime>"
+        }
+      ]
+    },
+    "SelectionInitIntervalMapping": {
+      "$ref": "#/definitions/Dict<SelectionInitInterval>"
+    },
+    "SelectionInitMapping": {
+      "$ref": "#/definitions/Dict<SelectionInit>"
+    },
+    "SelectionParameter": {
+      "additionalProperties": false,
+      "properties": {
+        "bind": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Binding"
+            },
+            {
+              "additionalProperties": {
+                "$ref": "#/definitions/Binding"
+              },
+              "type": "object"
+            },
+            {
+              "$ref": "#/definitions/LegendBinding"
+            },
+            {
+              "const": "scales",
+              "type": "string"
+            }
+          ],
+          "description": "When set, a selection is populated by input elements (also known as dynamic query widgets) or by interacting with the corresponding legend. Direct manipulation interaction is disabled by default; to re-enable it, set the selection's [`on`](https://vega.github.io/vega-lite/docs/selection.html#common-selection-properties) property.\n\nLegend bindings are restricted to selections that only specify a single field or encoding.\n\nQuery widget binding takes the form of Vega's [input element binding definition](https://vega.github.io/vega/docs/signals/#bind) or can be a mapping between projected field/encodings and binding definitions.\n\n__See also:__ [`bind`](https://vega.github.io/vega-lite/docs/bind.html) documentation."
+        },
+        "name": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "Required. A unique name for the selection parameter. Selection names should be valid JavaScript identifiers: they should contain only alphanumeric characters (or \"$\", or \"_\") and may not start with a digit. Reserved keywords that may not be used as parameter names are \"datum\", \"event\", \"item\", and \"parent\"."
+        },
+        "select": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SelectionType"
+            },
+            {
+              "$ref": "#/definitions/PointSelectionConfig"
+            },
+            {
+              "$ref": "#/definitions/IntervalSelectionConfig"
+            }
+          ],
+          "description": "Determines the default event processing and data query for the selection. Vega-Lite currently supports two selection types:\n\n- `\"point\"` -- to select multiple discrete data values; the first value is selected on `click` and additional values toggled on shift-click.\n- `\"interval\"` -- to select a continuous range of data values on `drag`."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SelectionInit"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/SelectionInitMapping"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/SelectionInitIntervalMapping"
+            }
+          ],
+          "description": "Initialize the selection with a mapping between [projected channels or field names](https://vega.github.io/vega-lite/docs/selection.html#project) and initial values.\n\n__See also:__ [`init`](https://vega.github.io/vega-lite/docs/value.html) documentation."
+        }
+      },
+      "required": [
+        "name",
+        "select"
+      ],
+      "type": "object"
+    },
+    "SelectionResolution": {
+      "enum": [
+        "global",
+        "union",
+        "intersect"
+      ],
+      "type": "string"
+    },
+    "SelectionType": {
+      "enum": [
+        "point",
+        "interval"
+      ],
+      "type": "string"
+    },
+    "SequenceGenerator": {
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "description": "Provide a placeholder name and bind data at runtime.",
+          "type": "string"
+        },
+        "sequence": {
+          "$ref": "#/definitions/SequenceParams",
+          "description": "Generate a sequence of numbers."
+        }
+      },
+      "required": [
+        "sequence"
+      ],
+      "type": "object"
+    },
+    "SequenceParams": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The name of the generated sequence field.\n\n__Default value:__ `\"data\"`"
+        },
+        "start": {
+          "description": "The starting value of the sequence (inclusive).",
+          "type": "number"
+        },
+        "step": {
+          "description": "The step value between sequence entries.\n\n__Default value:__ `1`",
+          "type": "number"
+        },
+        "stop": {
+          "description": "The ending value of the sequence (exclusive).",
+          "type": "number"
+        }
+      },
+      "required": [
+        "start",
+        "stop"
+      ],
+      "type": "object"
+    },
+    "SequentialMultiHue": {
+      "enum": [
+        "turbo",
+        "viridis",
+        "inferno",
+        "magma",
+        "plasma",
+        "cividis",
+        "bluegreen",
+        "bluegreen-3",
+        "bluegreen-4",
+        "bluegreen-5",
+        "bluegreen-6",
+        "bluegreen-7",
+        "bluegreen-8",
+        "bluegreen-9",
+        "bluepurple",
+        "bluepurple-3",
+        "bluepurple-4",
+        "bluepurple-5",
+        "bluepurple-6",
+        "bluepurple-7",
+        "bluepurple-8",
+        "bluepurple-9",
+        "goldgreen",
+        "goldgreen-3",
+        "goldgreen-4",
+        "goldgreen-5",
+        "goldgreen-6",
+        "goldgreen-7",
+        "goldgreen-8",
+        "goldgreen-9",
+        "goldorange",
+        "goldorange-3",
+        "goldorange-4",
+        "goldorange-5",
+        "goldorange-6",
+        "goldorange-7",
+        "goldorange-8",
+        "goldorange-9",
+        "goldred",
+        "goldred-3",
+        "goldred-4",
+        "goldred-5",
+        "goldred-6",
+        "goldred-7",
+        "goldred-8",
+        "goldred-9",
+        "greenblue",
+        "greenblue-3",
+        "greenblue-4",
+        "greenblue-5",
+        "greenblue-6",
+        "greenblue-7",
+        "greenblue-8",
+        "greenblue-9",
+        "orangered",
+        "orangered-3",
+        "orangered-4",
+        "orangered-5",
+        "orangered-6",
+        "orangered-7",
+        "orangered-8",
+        "orangered-9",
+        "purplebluegreen",
+        "purplebluegreen-3",
+        "purplebluegreen-4",
+        "purplebluegreen-5",
+        "purplebluegreen-6",
+        "purplebluegreen-7",
+        "purplebluegreen-8",
+        "purplebluegreen-9",
+        "purpleblue",
+        "purpleblue-3",
+        "purpleblue-4",
+        "purpleblue-5",
+        "purpleblue-6",
+        "purpleblue-7",
+        "purpleblue-8",
+        "purpleblue-9",
+        "purplered",
+        "purplered-3",
+        "purplered-4",
+        "purplered-5",
+        "purplered-6",
+        "purplered-7",
+        "purplered-8",
+        "purplered-9",
+        "redpurple",
+        "redpurple-3",
+        "redpurple-4",
+        "redpurple-5",
+        "redpurple-6",
+        "redpurple-7",
+        "redpurple-8",
+        "redpurple-9",
+        "yellowgreenblue",
+        "yellowgreenblue-3",
+        "yellowgreenblue-4",
+        "yellowgreenblue-5",
+        "yellowgreenblue-6",
+        "yellowgreenblue-7",
+        "yellowgreenblue-8",
+        "yellowgreenblue-9",
+        "yellowgreen",
+        "yellowgreen-3",
+        "yellowgreen-4",
+        "yellowgreen-5",
+        "yellowgreen-6",
+        "yellowgreen-7",
+        "yellowgreen-8",
+        "yellowgreen-9",
+        "yelloworangebrown",
+        "yelloworangebrown-3",
+        "yelloworangebrown-4",
+        "yelloworangebrown-5",
+        "yelloworangebrown-6",
+        "yelloworangebrown-7",
+        "yelloworangebrown-8",
+        "yelloworangebrown-9",
+        "yelloworangered",
+        "yelloworangered-3",
+        "yelloworangered-4",
+        "yelloworangered-5",
+        "yelloworangered-6",
+        "yelloworangered-7",
+        "yelloworangered-8",
+        "yelloworangered-9",
+        "darkblue",
+        "darkblue-3",
+        "darkblue-4",
+        "darkblue-5",
+        "darkblue-6",
+        "darkblue-7",
+        "darkblue-8",
+        "darkblue-9",
+        "darkgold",
+        "darkgold-3",
+        "darkgold-4",
+        "darkgold-5",
+        "darkgold-6",
+        "darkgold-7",
+        "darkgold-8",
+        "darkgold-9",
+        "darkgreen",
+        "darkgreen-3",
+        "darkgreen-4",
+        "darkgreen-5",
+        "darkgreen-6",
+        "darkgreen-7",
+        "darkgreen-8",
+        "darkgreen-9",
+        "darkmulti",
+        "darkmulti-3",
+        "darkmulti-4",
+        "darkmulti-5",
+        "darkmulti-6",
+        "darkmulti-7",
+        "darkmulti-8",
+        "darkmulti-9",
+        "darkred",
+        "darkred-3",
+        "darkred-4",
+        "darkred-5",
+        "darkred-6",
+        "darkred-7",
+        "darkred-8",
+        "darkred-9",
+        "lightgreyred",
+        "lightgreyred-3",
+        "lightgreyred-4",
+        "lightgreyred-5",
+        "lightgreyred-6",
+        "lightgreyred-7",
+        "lightgreyred-8",
+        "lightgreyred-9",
+        "lightgreyteal",
+        "lightgreyteal-3",
+        "lightgreyteal-4",
+        "lightgreyteal-5",
+        "lightgreyteal-6",
+        "lightgreyteal-7",
+        "lightgreyteal-8",
+        "lightgreyteal-9",
+        "lightmulti",
+        "lightmulti-3",
+        "lightmulti-4",
+        "lightmulti-5",
+        "lightmulti-6",
+        "lightmulti-7",
+        "lightmulti-8",
+        "lightmulti-9",
+        "lightorange",
+        "lightorange-3",
+        "lightorange-4",
+        "lightorange-5",
+        "lightorange-6",
+        "lightorange-7",
+        "lightorange-8",
+        "lightorange-9",
+        "lighttealblue",
+        "lighttealblue-3",
+        "lighttealblue-4",
+        "lighttealblue-5",
+        "lighttealblue-6",
+        "lighttealblue-7",
+        "lighttealblue-8",
+        "lighttealblue-9"
+      ],
+      "type": "string"
+    },
+    "SequentialSingleHue": {
+      "enum": [
+        "blues",
+        "tealblues",
+        "teals",
+        "greens",
+        "browns",
+        "greys",
+        "purples",
+        "warmgreys",
+        "reds",
+        "oranges"
+      ],
+      "type": "string"
+    },
+    "ShapeDef": {
+      "$ref": "#/definitions/MarkPropDef<(string|null),TypeForShape>"
+    },
+    "SharedEncoding": {
+      "additionalProperties": false,
+      "properties": {
+        "angle": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "color": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Gradient"
+                },
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "description": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "const": "binned",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(string|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(string|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "format": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/Dict"
+                }
+              ],
+              "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+            },
+            "formatType": {
+              "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+              "type": "string"
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/StandardType",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "detail": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FieldDefWithoutScale"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/FieldDefWithoutScale"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "Additional levels of detail for grouping data in aggregate views and in line, trail, and area marks without mapping data to a specific visual channel."
+        },
+        "fill": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Gradient"
+                },
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "fillOpacity": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "href": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "const": "binned",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(string|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(string|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "format": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/Dict"
+                }
+              ],
+              "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+            },
+            "formatType": {
+              "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+              "type": "string"
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/StandardType",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "key": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "const": "binned",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/StandardType",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            }
+          },
+          "type": "object"
+        },
+        "latitude": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+              "type": "null"
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "const": "quantitative",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation.",
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            }
+          },
+          "type": "object"
+        },
+        "latitude2": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+              "type": "null"
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/Type",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "const": "width",
+                  "type": "string"
+                },
+                {
+                  "const": "height",
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "longitude": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+              "type": "null"
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "const": "quantitative",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation.",
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            }
+          },
+          "type": "object"
+        },
+        "longitude2": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+              "type": "null"
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/Type",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "const": "width",
+                  "type": "string"
+                },
+                {
+                  "const": "height",
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "opacity": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "order": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/OrderFieldDef"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/OrderFieldDef"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/OrderValueDef"
+            },
+            {
+              "$ref": "#/definitions/OrderOnlyDef"
+            }
+          ],
+          "description": "Order of the marks.\n- For stacked marks, this `order` channel encodes [stack order](https://vega.github.io/vega-lite/docs/stack.html#order).\n- For line and trail marks, this `order` channel encodes order of data points in the lines. This can be useful for creating [a connected scatterplot](https://vega.github.io/vega-lite/examples/connected_scatterplot.html). Setting `order` to `{\"value\": null}` makes the line marks use the original order in the data sources.\n- Otherwise, this `order` channel encodes layer order of the marks.\n\n__Note__: In aggregate plots, `order` field should be `aggregate`d to avoid creating additional aggregation grouping."
+        },
+        "radius": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "const": "binned",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "stack": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StackOffset"
+                },
+                {
+                  "type": "null"
+                },
+                {
+                  "type": "boolean"
+                }
+              ],
+              "description": "Type of stacking offset if the field should be stacked. `stack` is only applicable for `x`, `y`, `theta`, and `radius` channels with continuous domains. For example, `stack` of `y` can be used to customize stacking for a vertical bar chart.\n\n`stack` can be one of the following values:\n- `\"zero\"` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and [area](https://vega.github.io/vega-lite/docs/stack.html#area) chart).\n- `\"normalize\"` - stacking with normalized domain (for creating [normalized stacked bar and area charts](https://vega.github.io/vega-lite/docs/stack.html#normalized) and pie charts [with percentage tooltip](https://vega.github.io/vega-lite/docs/arc.html#tooltip)). <br/>\n-`\"center\"` - stacking with center baseline (for [streamgraph](https://vega.github.io/vega-lite/docs/stack.html#streamgraph)).\n- `null` or `false` - No-stacking. This will produce layered [bar](https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart) and area chart.\n\n__Default value:__ `zero` for plots with all of the following conditions are true: (1) the mark is `bar`, `area`, or `arc`; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, `null` by default.\n\n__See also:__ [`stack`](https://vega.github.io/vega-lite/docs/stack.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "const": "width",
+                  "type": "string"
+                },
+                {
+                  "const": "height",
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "radius2": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+              "type": "null"
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/Type",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "const": "width",
+                  "type": "string"
+                },
+                {
+                  "const": "height",
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "shape": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef<TypeForShape>"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TypeForShape",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "size": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "stroke": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Gradient"
+                },
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "strokeDash": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number[]|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number[]|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number[]|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number[]|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "items": {
+                    "type": "number"
+                  },
+                  "type": "array"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "strokeOpacity": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "strokeWidth": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "legend": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Legend"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the legend. If `null`, the legend for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.\n\n__See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "text": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "const": "binned",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(Text|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(Text|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalStringFieldDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(Text|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(Text|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "format": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/Dict"
+                }
+              ],
+              "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+            },
+            "formatType": {
+              "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+              "type": "string"
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "theta": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "const": "binned",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "stack": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StackOffset"
+                },
+                {
+                  "type": "null"
+                },
+                {
+                  "type": "boolean"
+                }
+              ],
+              "description": "Type of stacking offset if the field should be stacked. `stack` is only applicable for `x`, `y`, `theta`, and `radius` channels with continuous domains. For example, `stack` of `y` can be used to customize stacking for a vertical bar chart.\n\n`stack` can be one of the following values:\n- `\"zero\"` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and [area](https://vega.github.io/vega-lite/docs/stack.html#area) chart).\n- `\"normalize\"` - stacking with normalized domain (for creating [normalized stacked bar and area charts](https://vega.github.io/vega-lite/docs/stack.html#normalized) and pie charts [with percentage tooltip](https://vega.github.io/vega-lite/docs/arc.html#tooltip)). <br/>\n-`\"center\"` - stacking with center baseline (for [streamgraph](https://vega.github.io/vega-lite/docs/stack.html#streamgraph)).\n- `null` or `false` - No-stacking. This will produce layered [bar](https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart) and area chart.\n\n__Default value:__ `zero` for plots with all of the following conditions are true: (1) the mark is `bar`, `area`, or `arc`; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, `null` by default.\n\n__See also:__ [`stack`](https://vega.github.io/vega-lite/docs/stack.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "const": "width",
+                  "type": "string"
+                },
+                {
+                  "const": "height",
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "theta2": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+              "type": "null"
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/Type",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "const": "width",
+                  "type": "string"
+                },
+                {
+                  "const": "height",
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "tooltip": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StringFieldDefWithCondition"
+            },
+            {
+              "$ref": "#/definitions/StringValueDefWithCondition"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/StringFieldDef"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The tooltip text to show upon mouse hover. Specifying `tooltip` encoding overrides [the `tooltip` property in the mark definition](https://vega.github.io/vega-lite/docs/mark.html#mark-def).\n\nSee the [`tooltip`](https://vega.github.io/vega-lite/docs/tooltip.html) documentation for a detailed discussion about tooltip in Vega-Lite."
+        },
+        "url": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "const": "binned",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "condition": {
+              "anyOf": [
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(string|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(string|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+                },
+                {
+                  "anyOf": [
+                    {
+                      "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+                    },
+                    {
+                      "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+                    },
+                    {
+                      "items": {
+                        "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+                      },
+                      "type": "array"
+                    }
+                  ],
+                  "description": "A field definition or one or more value definition(s) with a parameter predicate."
+                }
+              ],
+              "description": "One or more value definition(s) with [a parameter or a test predicate](https://vega.github.io/vega-lite/docs/condition.html).\n\n__Note:__ A field definition's `condition` property can only contain [conditional value definitions](https://vega.github.io/vega-lite/docs/condition.html#value) since Vega-Lite only allows at most one encoded field per encoding channel."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "format": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/Dict"
+                }
+              ],
+              "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+            },
+            "formatType": {
+              "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+              "type": "string"
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/StandardType",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "x": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "axis": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Axis"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of axis's gridlines, ticks and labels. If `null`, the axis for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [axis properties](https://vega.github.io/vega-lite/docs/axis.html) are applied.\n\n__See also:__ [`axis`](https://vega.github.io/vega-lite/docs/axis.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "const": "binned",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "impute": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ImputeParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining the properties of the Impute Operation to be applied. The field value of the other positional channel is taken as `key` of the `Impute` Operation. The field of the `color` channel if specified is used as `groupby` of the `Impute` Operation.\n\n__See also:__ [`impute`](https://vega.github.io/vega-lite/docs/impute.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "stack": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StackOffset"
+                },
+                {
+                  "type": "null"
+                },
+                {
+                  "type": "boolean"
+                }
+              ],
+              "description": "Type of stacking offset if the field should be stacked. `stack` is only applicable for `x`, `y`, `theta`, and `radius` channels with continuous domains. For example, `stack` of `y` can be used to customize stacking for a vertical bar chart.\n\n`stack` can be one of the following values:\n- `\"zero\"` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and [area](https://vega.github.io/vega-lite/docs/stack.html#area) chart).\n- `\"normalize\"` - stacking with normalized domain (for creating [normalized stacked bar and area charts](https://vega.github.io/vega-lite/docs/stack.html#normalized) and pie charts [with percentage tooltip](https://vega.github.io/vega-lite/docs/arc.html#tooltip)). <br/>\n-`\"center\"` - stacking with center baseline (for [streamgraph](https://vega.github.io/vega-lite/docs/stack.html#streamgraph)).\n- `null` or `false` - No-stacking. This will produce layered [bar](https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart) and area chart.\n\n__Default value:__ `zero` for plots with all of the following conditions are true: (1) the mark is `bar`, `area`, or `arc`; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, `null` by default.\n\n__See also:__ [`stack`](https://vega.github.io/vega-lite/docs/stack.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "const": "width",
+                  "type": "string"
+                },
+                {
+                  "const": "height",
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "x2": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+              "type": "null"
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/Type",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "const": "width",
+                  "type": "string"
+                },
+                {
+                  "const": "height",
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "xError": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+              "type": "null"
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "value": {
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity).",
+              "type": "number"
+            }
+          },
+          "type": "object"
+        },
+        "xError2": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+              "type": "null"
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "value": {
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity).",
+              "type": "number"
+            }
+          },
+          "type": "object"
+        },
+        "xOffset": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity).",
+              "type": "number"
+            }
+          },
+          "type": "object"
+        },
+        "y": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "axis": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Axis"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of axis's gridlines, ticks and labels. If `null`, the axis for the encoding channel will be removed.\n\n__Default value:__ If undefined, default [axis properties](https://vega.github.io/vega-lite/docs/axis.html) are applied.\n\n__See also:__ [`axis`](https://vega.github.io/vega-lite/docs/axis.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "const": "binned",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "impute": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ImputeParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining the properties of the Impute Operation to be applied. The field value of the other positional channel is taken as `key` of the `Impute` Operation. The field of the `color` channel if specified is used as `groupby` of the `Impute` Operation.\n\n__See also:__ [`impute`](https://vega.github.io/vega-lite/docs/impute.html) documentation."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "stack": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StackOffset"
+                },
+                {
+                  "type": "null"
+                },
+                {
+                  "type": "boolean"
+                }
+              ],
+              "description": "Type of stacking offset if the field should be stacked. `stack` is only applicable for `x`, `y`, `theta`, and `radius` channels with continuous domains. For example, `stack` of `y` can be used to customize stacking for a vertical bar chart.\n\n`stack` can be one of the following values:\n- `\"zero\"` or `true`: stacking with baseline offset at zero value of the scale (for creating typical stacked [bar](https://vega.github.io/vega-lite/docs/stack.html#bar) and [area](https://vega.github.io/vega-lite/docs/stack.html#area) chart).\n- `\"normalize\"` - stacking with normalized domain (for creating [normalized stacked bar and area charts](https://vega.github.io/vega-lite/docs/stack.html#normalized) and pie charts [with percentage tooltip](https://vega.github.io/vega-lite/docs/arc.html#tooltip)). <br/>\n-`\"center\"` - stacking with center baseline (for [streamgraph](https://vega.github.io/vega-lite/docs/stack.html#streamgraph)).\n- `null` or `false` - No-stacking. This will produce layered [bar](https://vega.github.io/vega-lite/docs/stack.html#layered-bar-chart) and area chart.\n\n__Default value:__ `zero` for plots with all of the following conditions are true: (1) the mark is `bar`, `area`, or `arc`; (2) the stacked measure channel (x or y) has a linear scale; (3) At least one of non-position channels mapped to an unaggregated field that is different from x and y. Otherwise, `null` by default.\n\n__See also:__ [`stack`](https://vega.github.io/vega-lite/docs/stack.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "const": "width",
+                  "type": "string"
+                },
+                {
+                  "const": "height",
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "y2": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+              "type": "null"
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "$ref": "#/definitions/Type",
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "const": "width",
+                  "type": "string"
+                },
+                {
+                  "const": "height",
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+            }
+          },
+          "type": "object"
+        },
+        "yError": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+              "type": "null"
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "value": {
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity).",
+              "type": "number"
+            }
+          },
+          "type": "object"
+        },
+        "yError2": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation.",
+              "type": "null"
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "value": {
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity).",
+              "type": "number"
+            }
+          },
+          "type": "object"
+        },
+        "yOffset": {
+          "additionalProperties": false,
+          "properties": {
+            "aggregate": {
+              "$ref": "#/definitions/Aggregate",
+              "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+            },
+            "bandPosition": {
+              "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "bin": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/BinParams"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+            },
+            "datum": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PrimitiveValue"
+                },
+                {
+                  "$ref": "#/definitions/DateTime"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                },
+                {
+                  "$ref": "#/definitions/RepeatRef"
+                }
+              ],
+              "description": "A constant value in data domain."
+            },
+            "field": {
+              "$ref": "#/definitions/Field",
+              "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+            },
+            "scale": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Scale"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object defining properties of the channel's scale, which is the function that transforms values in the data domain (numbers, dates, strings, etc) to visual values (pixels, colors, sizes) of the encoding channels.\n\nIf `null`, the scale will be [disabled and the data value will be directly encoded](https://vega.github.io/vega-lite/docs/scale.html#disable).\n\n__Default value:__ If undefined, default [scale properties](https://vega.github.io/vega-lite/docs/scale.html) are applied.\n\n__See also:__ [`scale`](https://vega.github.io/vega-lite/docs/scale.html) documentation."
+            },
+            "sort": {
+              "$ref": "#/definitions/Sort",
+              "description": "Sort order for the encoded field.\n\nFor continuous fields (quantitative or temporal), `sort` can be either `\"ascending\"` or `\"descending\"`.\n\nFor discrete fields, `sort` can be one of the following:\n- `\"ascending\"` or `\"descending\"` -- for sorting by the values' natural order in JavaScript.\n- [A string indicating an encoding channel name to sort by](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding) (e.g., `\"x\"` or `\"y\"`) with an optional minus prefix for descending sort (e.g., `\"-x\"` to sort by x-field, descending). This channel string is short-form of [a sort-by-encoding definition](https://vega.github.io/vega-lite/docs/sort.html#sort-by-encoding). For example, `\"sort\": \"-x\"` is equivalent to `\"sort\": {\"encoding\": \"x\", \"order\": \"descending\"}`.\n- [A sort field definition](https://vega.github.io/vega-lite/docs/sort.html#sort-field) for sorting by another field.\n- [An array specifying the field values in preferred order](https://vega.github.io/vega-lite/docs/sort.html#sort-array). In this case, the sort order will obey the values in the array, followed by any unspecified values in their original order. For discrete time field, values in the sort array can be [date-time definition objects](types#datetime). In addition, for time units `\"month\"` and `\"day\"`, the values can be the month or day names (case insensitive) or their 3-letter initials (e.g., `\"Mon\"`, `\"Tue\"`).\n- `null` indicating no sort.\n\n__Default value:__ `\"ascending\"`\n\n__Note:__ `null` and sorting by another channel is not supported for `row` and `column`.\n\n__See also:__ [`sort`](https://vega.github.io/vega-lite/docs/sort.html) documentation."
+            },
+            "timeUnit": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/BinnedTimeUnit"
+                },
+                {
+                  "$ref": "#/definitions/TimeUnitParams"
+                }
+              ],
+              "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+            },
+            "type": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/StandardType",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                },
+                {
+                  "$ref": "#/definitions/Type",
+                  "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+                }
+              ],
+              "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+            },
+            "value": {
+              "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity).",
+              "type": "number"
+            }
+          },
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
+    "SingleDefUnitChannel": {
+      "enum": [
+        "x",
+        "y",
+        "xOffset",
+        "yOffset",
+        "x2",
+        "y2",
+        "longitude",
+        "latitude",
+        "longitude2",
+        "latitude2",
+        "theta",
+        "theta2",
+        "radius",
+        "radius2",
+        "color",
+        "fill",
+        "stroke",
+        "opacity",
+        "fillOpacity",
+        "strokeOpacity",
+        "strokeWidth",
+        "strokeDash",
+        "size",
+        "angle",
+        "shape",
+        "key",
+        "text",
+        "href",
+        "url",
+        "description"
+      ],
+      "type": "string"
+    },
+    "SingleTimeUnit": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/LocalSingleTimeUnit"
+        },
+        {
+          "$ref": "#/definitions/UtcSingleTimeUnit"
+        }
+      ]
+    },
+    "Sort": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/SortArray"
+        },
+        {
+          "$ref": "#/definitions/AllSortString"
+        },
+        {
+          "$ref": "#/definitions/EncodingSortField"
+        },
+        {
+          "$ref": "#/definitions/SortByEncoding"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "SortArray": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        },
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        {
+          "items": {
+            "type": "boolean"
+          },
+          "type": "array"
+        },
+        {
+          "items": {
+            "$ref": "#/definitions/DateTime"
+          },
+          "type": "array"
+        }
+      ]
+    },
+    "SortByChannel": {
+      "enum": [
+        "x",
+        "y",
+        "color",
+        "fill",
+        "stroke",
+        "strokeWidth",
+        "size",
+        "shape",
+        "fillOpacity",
+        "strokeOpacity",
+        "opacity",
+        "text"
+      ],
+      "type": "string"
+    },
+    "SortByChannelDesc": {
+      "enum": [
+        "-x",
+        "-y",
+        "-color",
+        "-fill",
+        "-stroke",
+        "-strokeWidth",
+        "-size",
+        "-shape",
+        "-fillOpacity",
+        "-strokeOpacity",
+        "-opacity",
+        "-text"
+      ],
+      "type": "string"
+    },
+    "SortByEncoding": {
+      "additionalProperties": false,
+      "properties": {
+        "encoding": {
+          "$ref": "#/definitions/SortByChannel",
+          "description": "The [encoding channel](https://vega.github.io/vega-lite/docs/encoding.html#channels) to sort by (e.g., `\"x\"`, `\"y\"`)"
+        },
+        "order": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SortOrder"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The sort order. One of `\"ascending\"` (default), `\"descending\"`, or `null` (no not sort)."
+        }
+      },
+      "required": [
+        "encoding"
+      ],
+      "type": "object"
+    },
+    "SortField": {
+      "additionalProperties": false,
+      "description": "A sort definition for transform",
+      "properties": {
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The name of the field to sort."
+        },
+        "order": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SortOrder"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Whether to sort the field in ascending or descending order. One of `\"ascending\"` (default), `\"descending\"`, or `null` (no not sort)."
+        }
+      },
+      "required": [
+        "field"
+      ],
+      "type": "object"
+    },
+    "SortOrder": {
+      "enum": [
+        "ascending",
+        "descending"
+      ],
+      "type": "string"
+    },
+    "SphereGenerator": {
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "description": "Provide a placeholder name and bind data at runtime.",
+          "type": "string"
+        },
+        "sphere": {
+          "anyOf": [
+            {
+              "const": true,
+              "type": "boolean"
+            },
+            {
+              "additionalProperties": false,
+              "type": "object"
+            }
+          ],
+          "description": "Generate sphere GeoJSON data for the full globe."
+        }
+      },
+      "required": [
+        "sphere"
+      ],
+      "type": "object"
+    },
+    "StackOffset": {
+      "enum": [
+        "zero",
+        "center",
+        "normalize"
+      ],
+      "type": "string"
+    },
+    "StackTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FieldName"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/FieldName"
+              },
+              "maxItems": 2,
+              "minItems": 2,
+              "type": "array"
+            }
+          ],
+          "description": "Output field names. This can be either a string or an array of strings with two elements denoting the name for the fields for stack start and stack end respectively. If a single string(e.g., `\"val\"`) is provided, the end field will be `\"val_end\"`."
+        },
+        "groupby": {
+          "description": "The data fields to group by.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "offset": {
+          "description": "Mode for stacking marks. One of `\"zero\"` (default), `\"center\"`, or `\"normalize\"`. The `\"zero\"` offset will stack starting at `0`. The `\"center\"` offset will center the stacks. The `\"normalize\"` offset will compute percentage values for each stack point, with output values in the range `[0,1]`.\n\n__Default value:__ `\"zero\"`",
+          "enum": [
+            "zero",
+            "center",
+            "normalize"
+          ],
+          "type": "string"
+        },
+        "sort": {
+          "description": "Field that determines the order of leaves in the stacked charts.",
+          "items": {
+            "$ref": "#/definitions/SortField"
+          },
+          "type": "array"
+        },
+        "stack": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The field which is stacked."
+        }
+      },
+      "required": [
+        "stack",
+        "groupby",
+        "as"
+      ],
+      "type": "object"
+    },
+    "StandardType": {
+      "enum": [
+        "quantitative",
+        "ordinal",
+        "temporal",
+        "nominal"
+      ],
+      "type": "string"
+    },
+    "Step": {
+      "additionalProperties": false,
+      "properties": {
+        "for": {
+          "$ref": "#/definitions/StepFor",
+          "description": "Whether to apply the step to position scale or offset scale when there are both `x` and `xOffset` or both `y` and `yOffset` encodings."
+        },
+        "step": {
+          "description": "The size (width/height) per discrete step.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "step"
+      ],
+      "type": "object"
+    },
+    "StepFor": {
+      "enum": [
+        "position",
+        "offset"
+      ],
+      "type": "string"
+    },
+    "Stream": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/EventStream"
+        },
+        {
+          "$ref": "#/definitions/DerivedStream"
+        },
+        {
+          "$ref": "#/definitions/MergedStream"
+        }
+      ]
+    },
+    "StringFieldDef": {
+      "additionalProperties": false,
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "const": "binned",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "format": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Dict"
+            }
+          ],
+          "description": "When used with the default `\"number\"` and `\"time\"` format type, the text formatting pattern for labels of guides (axes, legends, headers) and text marks.\n\n- If the format type is `\"number\"` (e.g., for quantitative fields), this is D3's [number format pattern](https://github.com/d3/d3-format#locale_format).\n- If the format type is `\"time\"` (e.g., for temporal fields), this is D3's [time format pattern](https://github.com/d3/d3-time-format#locale_format).\n\nSee the [format documentation](https://vega.github.io/vega-lite/docs/format.html) for more examples.\n\nWhen used with a [custom `formatType`](https://vega.github.io/vega-lite/docs/config.html#custom-format-type), this value will be passed as `format` alongside `datum.value` to the registered function.\n\n__Default value:__  Derived from [numberFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for number format and from [timeFormat](https://vega.github.io/vega-lite/docs/config.html#format) config for time format."
+        },
+        "formatType": {
+          "description": "The format type for labels. One of `\"number\"`, `\"time\"`, or a [registered custom format type](https://vega.github.io/vega-lite/docs/config.html#custom-format-type).\n\n__Default value:__\n- `\"time\"` for temporal fields and ordinal and nominal fields with `timeUnit`.\n- `\"number\"` for quantitative fields as well as ordinal and nominal fields without `timeUnit`.",
+          "type": "string"
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "StringFieldDefWithCondition": {
+      "$ref": "#/definitions/FieldOrDatumDefWithCondition<StringFieldDef,string>"
+    },
+    "StringValueDefWithCondition": {
+      "$ref": "#/definitions/ValueDefWithCondition<MarkPropFieldOrDatumDef,(string|null)>"
+    },
+    "StrokeCap": {
+      "enum": [
+        "butt",
+        "round",
+        "square"
+      ],
+      "type": "string"
+    },
+    "StrokeJoin": {
+      "enum": [
+        "miter",
+        "round",
+        "bevel"
+      ],
+      "type": "string"
+    },
+    "StyleConfigIndex": {
+      "additionalProperties": {
+        "anyOf": [
+          {
+            "$ref": "#/definitions/AnyMarkConfig"
+          },
+          {
+            "$ref": "#/definitions/Axis"
+          }
+        ]
+      },
+      "properties": {
+        "arc": {
+          "$ref": "#/definitions/RectConfig",
+          "description": "Arc-specific Config"
+        },
+        "area": {
+          "$ref": "#/definitions/AreaConfig",
+          "description": "Area-Specific Config"
+        },
+        "bar": {
+          "$ref": "#/definitions/BarConfig",
+          "description": "Bar-Specific Config"
+        },
+        "circle": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Circle-Specific Config"
+        },
+        "geoshape": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Geoshape-Specific Config"
+        },
+        "group-subtitle": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Default style for chart subtitles"
+        },
+        "group-title": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Default style for chart titles"
+        },
+        "guide-label": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Default style for axis, legend, and header labels."
+        },
+        "guide-title": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Default style for axis, legend, and header titles."
+        },
+        "image": {
+          "$ref": "#/definitions/RectConfig",
+          "description": "Image-specific Config"
+        },
+        "line": {
+          "$ref": "#/definitions/LineConfig",
+          "description": "Line-Specific Config"
+        },
+        "mark": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Mark Config"
+        },
+        "point": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Point-Specific Config"
+        },
+        "rect": {
+          "$ref": "#/definitions/RectConfig",
+          "description": "Rect-Specific Config"
+        },
+        "rule": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Rule-Specific Config"
+        },
+        "square": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Square-Specific Config"
+        },
+        "text": {
+          "$ref": "#/definitions/MarkConfig",
+          "description": "Text-Specific Config"
+        },
+        "tick": {
+          "$ref": "#/definitions/TickConfig",
+          "description": "Tick-Specific Config"
+        },
+        "trail": {
+          "$ref": "#/definitions/LineConfig",
+          "description": "Trail-Specific Config"
+        }
+      },
+      "type": "object"
+    },
+    "SymbolShape": {
+      "type": "string"
+    },
+    "Text": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      ]
+    },
+    "TextBaseline": {
+      "anyOf": [
+        {
+          "const": "alphabetic",
+          "type": "string"
+        },
+        {
+          "$ref": "#/definitions/Baseline"
+        },
+        {
+          "const": "line-top",
+          "type": "string"
+        },
+        {
+          "const": "line-bottom",
+          "type": "string"
+        }
+      ]
+    },
+    "TextDef": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/FieldOrDatumDefWithCondition<StringFieldDef,Text>"
+        },
+        {
+          "$ref": "#/definitions/FieldOrDatumDefWithCondition<StringDatumDef,Text>"
+        },
+        {
+          "$ref": "#/definitions/ValueDefWithCondition<StringFieldDef,Text>"
+        }
+      ]
+    },
+    "TextDirection": {
+      "enum": [
+        "ltr",
+        "rtl"
+      ],
+      "type": "string"
+    },
+    "TickConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Align"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The horizontal alignment of the text or ranged marks (area, bar, image, rect, rule). One of `\"left\"`, `\"right\"`, `\"center\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "angle": {
+          "anyOf": [
+            {
+              "description": "The rotation angle of the text, in degrees.",
+              "maximum": 360,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG element, removing the mark item from the ARIA accessibility tree.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRole": {
+          "anyOf": [
+            {
+              "description": "Sets the type of user interface element of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"role\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ariaRoleDescription": {
+          "anyOf": [
+            {
+              "description": "A human-readable, author-localized description for the role of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the \"aria-roledescription\" attribute. Warning: this property is experimental and may be changed in the future.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aspect": {
+          "anyOf": [
+            {
+              "description": "Whether to keep aspect ratio of image marks.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "bandSize": {
+          "description": "The width of the ticks.\n\n__Default value:__  3/4 of step (width step for horizontal ticks and height step for vertical ticks).",
+          "minimum": 0,
+          "type": "number"
+        },
+        "baseline": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextBaseline"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For text marks, the vertical text baseline. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, `\"line-bottom\"`, or an expression reference that provides one of the valid values. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the `lineHeight` rather than `fontSize` alone.\n\nFor range marks, the vertical alignment of the marks. One of `\"top\"`, `\"middle\"`, `\"bottom\"`.\n\n__Note:__ Expression reference is *not* supported for range marks."
+        },
+        "blend": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Blend",
+              "description": "The color blend mode for drawing an item on its current background. Any valid [CSS mix-blend-mode](https://developer.mozilla.org/en-US/docs/Web/CSS/mix-blend-mode) value can be used.\n\n__Default value: `\"source-over\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "color": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default color.\n\n__Default value:__ <span style=\"color: #4682b4;\">&#9632;</span> `\"#4682b4\"`\n\n__Note:__\n- This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).\n- The `fill` and `stroke` properties have higher precedence than `color` and will override `color`."
+        },
+        "cornerRadius": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles or arcs' corners.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusBottomRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' bottom right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopLeft": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top right corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cornerRadiusTopRight": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles' top left corner.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cursor": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Cursor",
+              "description": "The mouse cursor used over the mark. Any valid [CSS cursor type](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values) can be used."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "description": {
+          "anyOf": [
+            {
+              "description": "A text description of the mark item for [ARIA accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) (SVG output only). If specified, this property determines the [\"aria-label\" attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dir": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TextDirection",
+              "description": "The direction of the text. One of `\"ltr\"` (left-to-right) or `\"rtl\"` (right-to-left). This property determines on which side is truncated in response to the limit parameter.\n\n__Default value:__ `\"ltr\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dx": {
+          "anyOf": [
+            {
+              "description": "The horizontal offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dy": {
+          "anyOf": [
+            {
+              "description": "The vertical offset, in pixels, between the text label and its anchor point. The offset is applied after rotation by the _angle_ property.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "ellipsis": {
+          "anyOf": [
+            {
+              "description": "The ellipsis string for text truncated in response to the limit parameter.\n\n__Default value:__ `\"…\"`",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "endAngle": {
+          "anyOf": [
+            {
+              "description": "The end angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fill": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default fill color. This property has higher precedence than `config.color`. Set to `null` to remove fill.\n\n__Default value:__ (None)"
+        },
+        "fillOpacity": {
+          "anyOf": [
+            {
+              "description": "The fill opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "filled": {
+          "description": "Whether the mark's color should be used as fill color instead of stroke color.\n\n__Default value:__ `false` for all `point`, `line`, and `rule` marks as well as `geoshape` marks for [`graticule`](https://vega.github.io/vega-lite/docs/data.html#graticule) data sources; otherwise, `true`.\n\n__Note:__ This property cannot be used in a [style config](https://vega.github.io/vega-lite/docs/mark.html#style-config).",
+          "type": "boolean"
+        },
+        "font": {
+          "anyOf": [
+            {
+              "description": "The typeface to set the text in (e.g., `\"Helvetica Neue\"`).",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontSize": {
+          "anyOf": [
+            {
+              "description": "The font size, in pixels.\n\n__Default value:__ `11`",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "The font style (e.g., `\"italic\"`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "The font weight. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "height": {
+          "anyOf": [
+            {
+              "description": "Height of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "href": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "A URL to load upon mouse click. If defined, the mark acts as a hyperlink."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "innerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The inner radius in pixels of arc marks. `innerRadius` is an alias for `radius2`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "interpolate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Interpolate",
+              "description": "The line interpolation method to use for line and area marks. One of the following:\n- `\"linear\"`: piecewise linear segments, as in a polyline.\n- `\"linear-closed\"`: close the linear segments to form a polygon.\n- `\"step\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"step-before\"`: alternate between vertical and horizontal segments, as in a step function.\n- `\"step-after\"`: alternate between horizontal and vertical segments, as in a step function.\n- `\"basis\"`: a B-spline, with control point duplication on the ends.\n- `\"basis-open\"`: an open B-spline; may not intersect the start or end.\n- `\"basis-closed\"`: a closed B-spline, as in a loop.\n- `\"cardinal\"`: a Cardinal spline, with control point duplication on the ends.\n- `\"cardinal-open\"`: an open Cardinal spline; may not intersect the start or end, but will intersect other control points.\n- `\"cardinal-closed\"`: a closed Cardinal spline, as in a loop.\n- `\"bundle\"`: equivalent to basis, except the tension parameter is used to straighten the spline.\n- `\"monotone\"`: cubic interpolation that preserves monotonicity in y."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "invalid": {
+          "description": "Defines how Vega-Lite should handle marks for invalid values (`null` and `NaN`).\n- If set to `\"filter\"` (default), all data items with null values will be skipped (for line, trail, and area marks) or filtered (for other marks).\n- If `null`, all data items are included. In this case, invalid values will be interpreted as zeroes.",
+          "enum": [
+            "filter",
+            null
+          ],
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "limit": {
+          "anyOf": [
+            {
+              "description": "The maximum length of the text mark in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.\n\n__Default value:__ `0` -- indicating no limit",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineBreak": {
+          "anyOf": [
+            {
+              "description": "A delimiter, such as a newline character, upon which to break text strings into multiple lines. This property is ignored if the text is array-valued.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineHeight": {
+          "anyOf": [
+            {
+              "description": "The line height in pixels (the spacing between subsequent lines of text) for multi-line text marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "opacity": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The overall opacity (value between [0,1]).\n\n__Default value:__ `0.7` for non-aggregate plots with `point`, `tick`, `circle`, or `square` marks or layered `bar` charts and `1` otherwise.",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "order": {
+          "description": "For line and trail marks, this `order` property can be set to `null` or `false` to make the lines use the original order in the data sources.",
+          "type": [
+            "null",
+            "boolean"
+          ]
+        },
+        "orient": {
+          "$ref": "#/definitions/Orientation",
+          "description": "The orientation of a non-stacked bar, tick, area, and line charts. The value is either horizontal (default) or vertical.\n- For bar, rule and tick, this determines whether the size of the bar and tick should be applied to x or y dimension.\n- For area, this property determines the orient property of the Vega output.\n- For line and trail marks, this property determines the sort order of the points in the line if `config.sortLineBy` is not specified. For stacked charts, this is always determined by the orientation of the stack; therefore explicitly specified value will be ignored."
+        },
+        "outerRadius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The outer radius in pixels of arc marks. `outerRadius` is an alias for `radius`.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "padAngle": {
+          "anyOf": [
+            {
+              "description": "The angular padding applied to sides of the arc, in radians.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "radius": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "For arc mark, the primary (outer) radius in pixels.\n\nFor text marks, polar coordinate radial offset, in pixels, of the text from the origin determined by the `x` and `y` properties.\n\n__Default value:__ `min(plot_width, plot_height)/2`",
+          "minimum": 0
+        },
+        "radius2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The secondary (inner) radius in pixels of arc marks.\n\n__Default value:__ `0`",
+          "minimum": 0
+        },
+        "shape": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/SymbolShape"
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "description": "Shape of the point marks. Supported values include:\n- plotting shapes: `\"circle\"`, `\"square\"`, `\"cross\"`, `\"diamond\"`, `\"triangle-up\"`, `\"triangle-down\"`, `\"triangle-right\"`, or `\"triangle-left\"`.\n- the line symbol `\"stroke\"`\n- centered directional shapes `\"arrow\"`, `\"wedge\"`, or `\"triangle\"`\n- a custom [SVG path string](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths) (For correct sizing, custom shape paths should be defined within a square bounding box with coordinates ranging from -1 to 1 along both the x and y dimensions.)\n\n__Default value:__ `\"circle\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "size": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default size for marks.\n- For `point`/`circle`/`square`, this represents the pixel area of the marks. Note that this value sets the area of the symbol; the side lengths will increase with the square root of this value.\n- For `bar`, this represents the band size of the bar, in pixels.\n- For `text`, this represents the font size, in pixels.\n\n__Default value:__\n- `30` for point, circle, square marks; width/height's `step`\n- `2` for bar marks with discrete dimensions;\n- `5` for bar marks with continuous dimensions;\n- `11` for text marks.",
+          "minimum": 0
+        },
+        "smooth": {
+          "anyOf": [
+            {
+              "description": "A boolean flag (default true) indicating if the image should be smoothed when resized. If false, individual pixels should be scaled directly rather than interpolated with smoothing. For SVG rendering, this option may not work in some browsers due to lack of standardization.",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "startAngle": {
+          "anyOf": [
+            {
+              "description": "The start angle in radians for arc marks. A value of `0` indicates up (north), increasing values proceed clockwise.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "stroke": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Default stroke color. This property has higher precedence than `config.color`. Set to `null` to remove stroke.\n\n__Default value:__ (None)"
+        },
+        "strokeCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for line ending style. One of `\"butt\"`, `\"round\"`, or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating stroke, space lengths for creating dashed or dotted lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDashOffset": {
+          "anyOf": [
+            {
+              "description": "The offset (in pixels) into which to begin drawing with the stroke dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeJoin": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeJoin",
+              "description": "The stroke line join method. One of `\"miter\"`, `\"round\"` or `\"bevel\"`.\n\n__Default value:__ `\"miter\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeMiterLimit": {
+          "anyOf": [
+            {
+              "description": "The miter limit at which to bevel a line join.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOffset": {
+          "anyOf": [
+            {
+              "description": "The offset in pixels at which to draw the group stroke and fill. If unspecified, the default behavior is to dynamically offset stroked groups such that 1 pixel stroke widths align with the pixel grid.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOpacity": {
+          "anyOf": [
+            {
+              "description": "The stroke opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeWidth": {
+          "anyOf": [
+            {
+              "description": "The stroke width, in pixels.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "tension": {
+          "anyOf": [
+            {
+              "description": "Depending on the interpolation type, sets the tension parameter (for line and area marks).",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "text": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text",
+              "description": "Placeholder text if the `text` channel is not specified"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "theta": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "- For arc marks, the arc length in radians if theta2 is not specified, otherwise the start arc angle. (A value of 0 indicates up or “north”, increasing values proceed clockwise.)\n\n- For text marks, polar coordinate angle in radians.",
+          "maximum": 360,
+          "minimum": 0
+        },
+        "theta2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The end angle of arc marks in radians. A value of 0 indicates up or “north”, increasing values proceed clockwise."
+        },
+        "thickness": {
+          "description": "Thickness of the tick mark.\n\n__Default value:__  `1`",
+          "minimum": 0,
+          "type": "number"
+        },
+        "timeUnitBandPosition": {
+          "description": "Default relative band position for a time unit. If set to `0`, the marks will be positioned at the beginning of the time unit band step. If set to `0.5`, the marks will be positioned in the middle of the time unit band step.",
+          "type": "number"
+        },
+        "timeUnitBandSize": {
+          "description": "Default relative band size for a time unit. If set to `1`, the bandwidth of the marks will be equal to the time unit band step. If set to `0.5`, bandwidth of the marks will be half of the time unit band step.",
+          "type": "number"
+        },
+        "tooltip": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/TooltipContent"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The tooltip text string to show upon mouse hover or an object defining which fields should the tooltip be derived from.\n\n- If `tooltip` is `true` or `{\"content\": \"encoding\"}`, then all fields from `encoding` will be used.\n- If `tooltip` is `{\"content\": \"data\"}`, then all fields that appear in the highlighted data point will be used.\n- If set to `null` or `false`, then no tooltip will be used.\n\nSee the [`tooltip`](https://vega.github.io/vega-lite/docs/tooltip.html) documentation for a detailed discussion about tooltip  in Vega-Lite.\n\n__Default value:__ `null`"
+        },
+        "url": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/URI",
+              "description": "The URL of the image file for image marks."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "width": {
+          "anyOf": [
+            {
+              "description": "Width of the marks.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "x": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X coordinates of the marks, or width of horizontal `\"bar\"` and `\"area\"` without specified `x2` or `width`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "x2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "X2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"width\"` for the width of the plot."
+        },
+        "y": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y coordinates of the marks, or height of vertical `\"bar\"` and `\"area\"` without specified `y2` or `height`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        },
+        "y2": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "Y2 coordinates for ranged `\"area\"`, `\"bar\"`, `\"rect\"`, and  `\"rule\"`.\n\nThe `value` of this channel can be a number or a string `\"height\"` for the height of the plot."
+        }
+      },
+      "type": "object"
+    },
+    "TickCount": {
+      "anyOf": [
+        {
+          "type": "number"
+        },
+        {
+          "$ref": "#/definitions/TimeInterval"
+        },
+        {
+          "$ref": "#/definitions/TimeIntervalStep"
+        }
+      ]
+    },
+    "TimeInterval": {
+      "enum": [
+        "millisecond",
+        "second",
+        "minute",
+        "hour",
+        "day",
+        "week",
+        "month",
+        "year"
+      ],
+      "type": "string"
+    },
+    "TimeIntervalStep": {
+      "additionalProperties": false,
+      "properties": {
+        "interval": {
+          "$ref": "#/definitions/TimeInterval"
+        },
+        "step": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "interval",
+        "step"
+      ],
+      "type": "object"
+    },
+    "TimeLocale": {
+      "additionalProperties": false,
+      "description": "Locale definition for formatting dates and times.",
+      "properties": {
+        "date": {
+          "description": "The date (%x) format specifier (e.g., \"%m/%d/%Y\").",
+          "type": "string"
+        },
+        "dateTime": {
+          "description": "The date and time (%c) format specifier (e.g., \"%a %b %e %X %Y\").",
+          "type": "string"
+        },
+        "days": {
+          "$ref": "#/definitions/Vector7<string>",
+          "description": "The full names of the weekdays, starting with Sunday."
+        },
+        "months": {
+          "$ref": "#/definitions/Vector12<string>",
+          "description": "The full names of the months (starting with January)."
+        },
+        "periods": {
+          "$ref": "#/definitions/Vector2<string>",
+          "description": "The A.M. and P.M. equivalents (e.g., [\"AM\", \"PM\"])."
+        },
+        "shortDays": {
+          "$ref": "#/definitions/Vector7<string>",
+          "description": "The abbreviated names of the weekdays, starting with Sunday."
+        },
+        "shortMonths": {
+          "$ref": "#/definitions/Vector12<string>",
+          "description": "The abbreviated names of the months (starting with January)."
+        },
+        "time": {
+          "description": "The time (%X) format specifier (e.g., \"%H:%M:%S\").",
+          "type": "string"
+        }
+      },
+      "required": [
+        "dateTime",
+        "date",
+        "time",
+        "periods",
+        "days",
+        "shortDays",
+        "months",
+        "shortMonths"
+      ],
+      "type": "object"
+    },
+    "TimeUnit": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/SingleTimeUnit"
+        },
+        {
+          "$ref": "#/definitions/MultiTimeUnit"
+        }
+      ]
+    },
+    "TimeUnitParams": {
+      "additionalProperties": false,
+      "description": "Time Unit Params for encoding predicate, which can specified if the data is  already \"binned\".",
+      "properties": {
+        "binned": {
+          "description": "Whether the data has already been binned to this time unit. If true, Vega-Lite will only format the data, marks, and guides, without applying the timeUnit transform to re-bin the data again.",
+          "type": "boolean"
+        },
+        "maxbins": {
+          "description": "If no `unit` is specified, maxbins is used to infer time units.",
+          "type": "number"
+        },
+        "step": {
+          "description": "The number of steps between bins, in terms of the least significant unit provided.",
+          "type": "number"
+        },
+        "unit": {
+          "$ref": "#/definitions/TimeUnit",
+          "description": "Defines how date-time values should be binned."
+        },
+        "utc": {
+          "description": "True to use UTC timezone. Equivalent to using a `utc` prefixed `TimeUnit`.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "TimeUnitTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The output field to write the timeUnit value."
+        },
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field to apply time unit."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitTransformParams"
+            }
+          ],
+          "description": "The timeUnit."
+        }
+      },
+      "required": [
+        "timeUnit",
+        "field",
+        "as"
+      ],
+      "type": "object"
+    },
+    "TimeUnitTransformParams": {
+      "additionalProperties": false,
+      "properties": {
+        "maxbins": {
+          "description": "If no `unit` is specified, maxbins is used to infer time units.",
+          "type": "number"
+        },
+        "step": {
+          "description": "The number of steps between bins, in terms of the least significant unit provided.",
+          "type": "number"
+        },
+        "unit": {
+          "$ref": "#/definitions/TimeUnit",
+          "description": "Defines how date-time values should be binned."
+        },
+        "utc": {
+          "description": "True to use UTC timezone. Equivalent to using a `utc` prefixed `TimeUnit`.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "TitleAnchor": {
+      "enum": [
+        null,
+        "start",
+        "middle",
+        "end"
+      ],
+      "type": [
+        "null",
+        "string"
+      ]
+    },
+    "TitleConfig": {
+      "$ref": "#/definitions/BaseTitleNoValueRefs"
+    },
+    "TitleFrame": {
+      "enum": [
+        "bounds",
+        "group"
+      ],
+      "type": "string"
+    },
+    "TitleOrient": {
+      "enum": [
+        "none",
+        "left",
+        "right",
+        "top",
+        "bottom"
+      ],
+      "type": "string"
+    },
+    "TitleParams": {
+      "additionalProperties": false,
+      "properties": {
+        "align": {
+          "$ref": "#/definitions/Align",
+          "description": "Horizontal text alignment for title text. One of `\"left\"`, `\"center\"`, or `\"right\"`."
+        },
+        "anchor": {
+          "$ref": "#/definitions/TitleAnchor",
+          "description": "The anchor position for placing the title. One of `\"start\"`, `\"middle\"`, or `\"end\"`. For example, with an orientation of top these anchor positions map to a left-, center-, or right-aligned title.\n\n__Default value:__ `\"middle\"` for [single](https://vega.github.io/vega-lite/docs/spec.html) and [layered](https://vega.github.io/vega-lite/docs/layer.html) views. `\"start\"` for other composite views.\n\n__Note:__ [For now](https://github.com/vega/vega-lite/issues/2875), `anchor` is only customizable only for [single](https://vega.github.io/vega-lite/docs/spec.html) and [layered](https://vega.github.io/vega-lite/docs/layer.html) views. For other composite views, `anchor` is always `\"start\"`."
+        },
+        "angle": {
+          "anyOf": [
+            {
+              "description": "Angle in degrees of title and subtitle text.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "aria": {
+          "anyOf": [
+            {
+              "description": "A boolean flag indicating if [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA) should be included (SVG output only). If `false`, the \"aria-hidden\" attribute will be set on the output SVG group, removing the title from the ARIA accessibility tree.\n\n__Default value:__ `true`",
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "baseline": {
+          "$ref": "#/definitions/TextBaseline",
+          "description": "Vertical text baseline for title and subtitle text. One of `\"alphabetic\"` (default), `\"top\"`, `\"middle\"`, `\"bottom\"`, `\"line-top\"`, or `\"line-bottom\"`. The `\"line-top\"` and `\"line-bottom\"` values operate similarly to `\"top\"` and `\"bottom\"`, but are calculated relative to the *lineHeight* rather than *fontSize* alone."
+        },
+        "color": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Text color for title text."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dx": {
+          "anyOf": [
+            {
+              "description": "Delta offset for title and subtitle text x-coordinate.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "dy": {
+          "anyOf": [
+            {
+              "description": "Delta offset for title and subtitle text y-coordinate.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "font": {
+          "anyOf": [
+            {
+              "description": "Font name for title text.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontSize": {
+          "anyOf": [
+            {
+              "description": "Font size in pixels for title text.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "Font style for title text."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "fontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "Font weight for title text. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "frame": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TitleFrame"
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "description": "The reference frame for the anchor position, one of `\"bounds\"` (to anchor relative to the full bounding box) or `\"group\"` (to anchor relative to the group width or height)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "limit": {
+          "anyOf": [
+            {
+              "description": "The maximum allowed length in pixels of title and subtitle text.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "lineHeight": {
+          "anyOf": [
+            {
+              "description": "Line height in pixels for multi-line title text or title text with `\"line-top\"` or `\"line-bottom\"` baseline.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "offset": {
+          "anyOf": [
+            {
+              "description": "The orthogonal offset in pixels by which to displace the title group from its position along the edge of the chart.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "orient": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TitleOrient",
+              "description": "Default title orientation (`\"top\"`, `\"bottom\"`, `\"left\"`, or `\"right\"`)"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "style": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "A [mark style property](https://vega.github.io/vega-lite/docs/config.html#style) to apply to the title text mark.\n\n__Default value:__ `\"group-title\"`."
+        },
+        "subtitle": {
+          "$ref": "#/definitions/Text",
+          "description": "The subtitle Text."
+        },
+        "subtitleColor": {
+          "anyOf": [
+            {
+              "anyOf": [
+                {
+                  "type": "null"
+                },
+                {
+                  "$ref": "#/definitions/Color"
+                }
+              ],
+              "description": "Text color for subtitle text."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "subtitleFont": {
+          "anyOf": [
+            {
+              "description": "Font name for subtitle text.",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "subtitleFontSize": {
+          "anyOf": [
+            {
+              "description": "Font size in pixels for subtitle text.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "subtitleFontStyle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontStyle",
+              "description": "Font style for subtitle text."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "subtitleFontWeight": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FontWeight",
+              "description": "Font weight for subtitle text. This can be either a string (e.g `\"bold\"`, `\"normal\"`) or a number (`100`, `200`, `300`, ..., `900` where `\"normal\"` = `400` and `\"bold\"` = `700`)."
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "subtitleLineHeight": {
+          "anyOf": [
+            {
+              "description": "Line height in pixels for multi-line subtitle text.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "subtitlePadding": {
+          "anyOf": [
+            {
+              "description": "The padding in pixels between title and subtitle text.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "text": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The title text."
+        },
+        "zindex": {
+          "description": "The integer z-index indicating the layering of the title group relative to other axis, mark and legend groups.\n\n__Default value:__ `0`.",
+          "minimum": 0,
+          "type": "number"
+        }
+      },
+      "required": [
+        "text"
+      ],
+      "type": "object"
+    },
+    "TooltipContent": {
+      "additionalProperties": false,
+      "properties": {
+        "content": {
+          "enum": [
+            "encoding",
+            "data"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "content"
+      ],
+      "type": "object"
+    },
+    "TopLevelConcatSpec": {
+      "additionalProperties": false,
+      "properties": {
+        "$schema": {
+          "description": "URL to [JSON schema](http://json-schema.org/) for a Vega-Lite specification. Unless you have a reason to change this, use `https://vega.github.io/schema/vega-lite/v5.json`. Setting the `$schema` property allows automatic validation and autocomplete in editors that support JSON schema.",
+          "format": "uri",
+          "type": "string"
+        },
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayoutAlign"
+            },
+            {
+              "$ref": "#/definitions/RowCol<LayoutAlign>"
+            }
+          ],
+          "description": "The alignment to apply to grid rows and columns. The supported string values are `\"all\"`, `\"each\"`, and `\"none\"`.\n\n- For `\"none\"`, a flow layout will be used, in which adjacent subviews are simply placed one after the other.\n- For `\"each\"`, subviews will be aligned into a clean grid structure, but each row or column may be of variable size.\n- For `\"all\"`, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns.\n\nAlternatively, an object value of the form `{\"row\": string, \"column\": string}` can be used to supply different alignments for rows and columns.\n\n__Default value:__ `\"all\"`."
+        },
+        "autosize": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/AutosizeType"
+            },
+            {
+              "$ref": "#/definitions/AutoSizeParams"
+            }
+          ],
+          "description": "How the visualization size should be determined. If a string, should be one of `\"pad\"`, `\"fit\"` or `\"none\"`. Object values can additionally specify parameters for content sizing and automatic resizing.\n\n__Default value__: `pad`"
+        },
+        "background": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "CSS color property to use as the background of the entire view.\n\n__Default value:__ `\"white\"`"
+        },
+        "bounds": {
+          "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+          "enum": [
+            "full",
+            "flush"
+          ],
+          "type": "string"
+        },
+        "center": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/RowCol<boolean>"
+            }
+          ],
+          "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\nAn object value of the form `{\"row\": boolean, \"column\": boolean}` can be used to supply different centering values for rows and columns.\n\n__Default value:__ `false`"
+        },
+        "columns": {
+          "description": "The number of columns to include in the view composition layout.\n\n__Default value__: `undefined` -- An infinite number of columns (a single row) will be assumed. This is equivalent to `hconcat` (for `concat`) and to using the `column` channel (for `facet` and `repeat`).\n\n__Note__:\n\n1) This property is only for:\n- the general (wrappable) `concat` operator (not `hconcat`/`vconcat`)\n- the `facet` and `repeat` operator with one field/repetition definition (without row/column nesting)\n\n2) Setting the `columns` to `1` is equivalent to `vconcat` (for `concat`) and to using the `row` channel (for `facet` and `repeat`).",
+          "type": "number"
+        },
+        "concat": {
+          "description": "A list of views to be concatenated.",
+          "items": {
+            "$ref": "#/definitions/NonNormalizedSpec"
+          },
+          "type": "array"
+        },
+        "config": {
+          "$ref": "#/definitions/Config",
+          "description": "Vega-Lite configuration object. This property can only be defined at the top-level of a specification."
+        },
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "datasets": {
+          "$ref": "#/definitions/Datasets",
+          "description": "A global data store for named datasets. This is a mapping from names to inline datasets. This can be an array of objects or primitive values or a string. Arrays of primitive values are ingested as objects with a `data` property."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "padding": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Padding"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The default visualization padding, in pixels, from the edge of the visualization canvas to the data rectangle. If a number, specifies padding for all sides. If an object, the value should have the format `{\"left\": 5, \"top\": 5, \"right\": 5, \"bottom\": 5}` to specify padding for each side of the visualization.\n\n__Default value__: `5`"
+        },
+        "params": {
+          "description": "Dynamic variables or selections that parameterize a visualization.",
+          "items": {
+            "$ref": "#/definitions/TopLevelParameter"
+          },
+          "type": "array"
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "spacing": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/RowCol<number>"
+            }
+          ],
+          "description": "The spacing in pixels between sub-views of the composition operator. An object of the form `{\"row\": number, \"column\": number}` can be used to set different spacing values for rows and columns.\n\n__Default value__: Depends on `\"spacing\"` property of [the view composition configuration](https://vega.github.io/vega-lite/docs/config.html#view-config) (`20` by default)"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        },
+        "usermeta": {
+          "$ref": "#/definitions/Dict",
+          "description": "Optional metadata that will be passed to Vega. This object is completely ignored by Vega and Vega-Lite and can be used for custom metadata."
+        }
+      },
+      "required": [
+        "concat"
+      ],
+      "type": "object"
+    },
+    "TopLevelHConcatSpec": {
+      "additionalProperties": false,
+      "properties": {
+        "$schema": {
+          "description": "URL to [JSON schema](http://json-schema.org/) for a Vega-Lite specification. Unless you have a reason to change this, use `https://vega.github.io/schema/vega-lite/v5.json`. Setting the `$schema` property allows automatic validation and autocomplete in editors that support JSON schema.",
+          "format": "uri",
+          "type": "string"
+        },
+        "autosize": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/AutosizeType"
+            },
+            {
+              "$ref": "#/definitions/AutoSizeParams"
+            }
+          ],
+          "description": "How the visualization size should be determined. If a string, should be one of `\"pad\"`, `\"fit\"` or `\"none\"`. Object values can additionally specify parameters for content sizing and automatic resizing.\n\n__Default value__: `pad`"
+        },
+        "background": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "CSS color property to use as the background of the entire view.\n\n__Default value:__ `\"white\"`"
+        },
+        "bounds": {
+          "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+          "enum": [
+            "full",
+            "flush"
+          ],
+          "type": "string"
+        },
+        "center": {
+          "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\n__Default value:__ `false`",
+          "type": "boolean"
+        },
+        "config": {
+          "$ref": "#/definitions/Config",
+          "description": "Vega-Lite configuration object. This property can only be defined at the top-level of a specification."
+        },
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "datasets": {
+          "$ref": "#/definitions/Datasets",
+          "description": "A global data store for named datasets. This is a mapping from names to inline datasets. This can be an array of objects or primitive values or a string. Arrays of primitive values are ingested as objects with a `data` property."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "hconcat": {
+          "description": "A list of views to be concatenated and put into a row.",
+          "items": {
+            "$ref": "#/definitions/NonNormalizedSpec"
+          },
+          "type": "array"
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "padding": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Padding"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The default visualization padding, in pixels, from the edge of the visualization canvas to the data rectangle. If a number, specifies padding for all sides. If an object, the value should have the format `{\"left\": 5, \"top\": 5, \"right\": 5, \"bottom\": 5}` to specify padding for each side of the visualization.\n\n__Default value__: `5`"
+        },
+        "params": {
+          "description": "Dynamic variables or selections that parameterize a visualization.",
+          "items": {
+            "$ref": "#/definitions/TopLevelParameter"
+          },
+          "type": "array"
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "spacing": {
+          "description": "The spacing in pixels between sub-views of the concat operator.\n\n__Default value__: `10`",
+          "type": "number"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        },
+        "usermeta": {
+          "$ref": "#/definitions/Dict",
+          "description": "Optional metadata that will be passed to Vega. This object is completely ignored by Vega and Vega-Lite and can be used for custom metadata."
+        }
+      },
+      "required": [
+        "hconcat"
+      ],
+      "type": "object"
+    },
+    "TopLevelVConcatSpec": {
+      "additionalProperties": false,
+      "properties": {
+        "$schema": {
+          "description": "URL to [JSON schema](http://json-schema.org/) for a Vega-Lite specification. Unless you have a reason to change this, use `https://vega.github.io/schema/vega-lite/v5.json`. Setting the `$schema` property allows automatic validation and autocomplete in editors that support JSON schema.",
+          "format": "uri",
+          "type": "string"
+        },
+        "autosize": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/AutosizeType"
+            },
+            {
+              "$ref": "#/definitions/AutoSizeParams"
+            }
+          ],
+          "description": "How the visualization size should be determined. If a string, should be one of `\"pad\"`, `\"fit\"` or `\"none\"`. Object values can additionally specify parameters for content sizing and automatic resizing.\n\n__Default value__: `pad`"
+        },
+        "background": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "CSS color property to use as the background of the entire view.\n\n__Default value:__ `\"white\"`"
+        },
+        "bounds": {
+          "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+          "enum": [
+            "full",
+            "flush"
+          ],
+          "type": "string"
+        },
+        "center": {
+          "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\n__Default value:__ `false`",
+          "type": "boolean"
+        },
+        "config": {
+          "$ref": "#/definitions/Config",
+          "description": "Vega-Lite configuration object. This property can only be defined at the top-level of a specification."
+        },
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "datasets": {
+          "$ref": "#/definitions/Datasets",
+          "description": "A global data store for named datasets. This is a mapping from names to inline datasets. This can be an array of objects or primitive values or a string. Arrays of primitive values are ingested as objects with a `data` property."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "padding": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Padding"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The default visualization padding, in pixels, from the edge of the visualization canvas to the data rectangle. If a number, specifies padding for all sides. If an object, the value should have the format `{\"left\": 5, \"top\": 5, \"right\": 5, \"bottom\": 5}` to specify padding for each side of the visualization.\n\n__Default value__: `5`"
+        },
+        "params": {
+          "description": "Dynamic variables or selections that parameterize a visualization.",
+          "items": {
+            "$ref": "#/definitions/TopLevelParameter"
+          },
+          "type": "array"
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "spacing": {
+          "description": "The spacing in pixels between sub-views of the concat operator.\n\n__Default value__: `10`",
+          "type": "number"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        },
+        "usermeta": {
+          "$ref": "#/definitions/Dict",
+          "description": "Optional metadata that will be passed to Vega. This object is completely ignored by Vega and Vega-Lite and can be used for custom metadata."
+        },
+        "vconcat": {
+          "description": "A list of views to be concatenated and put into a column.",
+          "items": {
+            "$ref": "#/definitions/NonNormalizedSpec"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "vconcat"
+      ],
+      "type": "object"
+    },
+    "TopLevelLayerSpec": {
+      "additionalProperties": false,
+      "properties": {
+        "$schema": {
+          "description": "URL to [JSON schema](http://json-schema.org/) for a Vega-Lite specification. Unless you have a reason to change this, use `https://vega.github.io/schema/vega-lite/v5.json`. Setting the `$schema` property allows automatic validation and autocomplete in editors that support JSON schema.",
+          "format": "uri",
+          "type": "string"
+        },
+        "autosize": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/AutosizeType"
+            },
+            {
+              "$ref": "#/definitions/AutoSizeParams"
+            }
+          ],
+          "description": "How the visualization size should be determined. If a string, should be one of `\"pad\"`, `\"fit\"` or `\"none\"`. Object values can additionally specify parameters for content sizing and automatic resizing.\n\n__Default value__: `pad`"
+        },
+        "background": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "CSS color property to use as the background of the entire view.\n\n__Default value:__ `\"white\"`"
+        },
+        "config": {
+          "$ref": "#/definitions/Config",
+          "description": "Vega-Lite configuration object. This property can only be defined at the top-level of a specification."
+        },
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "datasets": {
+          "$ref": "#/definitions/Datasets",
+          "description": "A global data store for named datasets. This is a mapping from names to inline datasets. This can be an array of objects or primitive values or a string. Arrays of primitive values are ingested as objects with a `data` property."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "encoding": {
+          "$ref": "#/definitions/SharedEncoding",
+          "description": "A shared key-value mapping between encoding channels and definition of fields in the underlying layers."
+        },
+        "height": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "container",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Step"
+            }
+          ],
+          "description": "The height of a visualization.\n\n- For a plot with a continuous y-field, height should be a number.\n- For a plot with either a discrete y-field or no y-field, height can be either a number indicating a fixed height or an object in the form of `{step: number}` defining the height per discrete step. (No y-field is equivalent to having one discrete step.)\n- To enable responsive sizing on height, it should be set to `\"container\"`.\n\n__Default value:__ Based on `config.view.continuousHeight` for a plot with a continuous y-field and `config.view.discreteHeight` otherwise.\n\n__Note:__ For plots with [`row` and `column` channels](https://vega.github.io/vega-lite/docs/encoding.html#facet), this represents the height of a single view and the `\"container\"` option cannot be used.\n\n__See also:__ [`height`](https://vega.github.io/vega-lite/docs/size.html) documentation."
+        },
+        "layer": {
+          "description": "Layer or single view specifications to be layered.\n\n__Note__: Specifications inside `layer` cannot use `row` and `column` channels as layering facet specifications is not allowed. Instead, use the [facet operator](https://vega.github.io/vega-lite/docs/facet.html) and place a layer inside a facet.",
+          "items": {
+            "anyOf": [
+              {
+                "$ref": "#/definitions/LayerSpec"
+              },
+              {
+                "$ref": "#/definitions/UnitSpec"
+              }
+            ]
+          },
+          "type": "array"
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "padding": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Padding"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The default visualization padding, in pixels, from the edge of the visualization canvas to the data rectangle. If a number, specifies padding for all sides. If an object, the value should have the format `{\"left\": 5, \"top\": 5, \"right\": 5, \"bottom\": 5}` to specify padding for each side of the visualization.\n\n__Default value__: `5`"
+        },
+        "params": {
+          "description": "Dynamic variables or selections that parameterize a visualization.",
+          "items": {
+            "$ref": "#/definitions/TopLevelParameter"
+          },
+          "type": "array"
+        },
+        "projection": {
+          "$ref": "#/definitions/Projection",
+          "description": "An object defining properties of the geographic projection shared by underlying layers."
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        },
+        "usermeta": {
+          "$ref": "#/definitions/Dict",
+          "description": "Optional metadata that will be passed to Vega. This object is completely ignored by Vega and Vega-Lite and can be used for custom metadata."
+        },
+        "view": {
+          "$ref": "#/definitions/ViewBackground",
+          "description": "An object defining the view background's fill and stroke.\n\n__Default value:__ none (transparent)"
+        },
+        "width": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "container",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Step"
+            }
+          ],
+          "description": "The width of a visualization.\n\n- For a plot with a continuous x-field, width should be a number.\n- For a plot with either a discrete x-field or no x-field, width can be either a number indicating a fixed width or an object in the form of `{step: number}` defining the width per discrete step. (No x-field is equivalent to having one discrete step.)\n- To enable responsive sizing on width, it should be set to `\"container\"`.\n\n__Default value:__ Based on `config.view.continuousWidth` for a plot with a continuous x-field and `config.view.discreteWidth` otherwise.\n\n__Note:__ For plots with [`row` and `column` channels](https://vega.github.io/vega-lite/docs/encoding.html#facet), this represents the width of a single view and the `\"container\"` option cannot be used.\n\n__See also:__ [`width`](https://vega.github.io/vega-lite/docs/size.html) documentation."
+        }
+      },
+      "required": [
+        "layer"
+      ],
+      "type": "object"
+    },
+    "TopLevelRepeatSpec": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "$schema": {
+              "description": "URL to [JSON schema](http://json-schema.org/) for a Vega-Lite specification. Unless you have a reason to change this, use `https://vega.github.io/schema/vega-lite/v5.json`. Setting the `$schema` property allows automatic validation and autocomplete in editors that support JSON schema.",
+              "format": "uri",
+              "type": "string"
+            },
+            "align": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/LayoutAlign"
+                },
+                {
+                  "$ref": "#/definitions/RowCol<LayoutAlign>"
+                }
+              ],
+              "description": "The alignment to apply to grid rows and columns. The supported string values are `\"all\"`, `\"each\"`, and `\"none\"`.\n\n- For `\"none\"`, a flow layout will be used, in which adjacent subviews are simply placed one after the other.\n- For `\"each\"`, subviews will be aligned into a clean grid structure, but each row or column may be of variable size.\n- For `\"all\"`, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns.\n\nAlternatively, an object value of the form `{\"row\": string, \"column\": string}` can be used to supply different alignments for rows and columns.\n\n__Default value:__ `\"all\"`."
+            },
+            "autosize": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/AutosizeType"
+                },
+                {
+                  "$ref": "#/definitions/AutoSizeParams"
+                }
+              ],
+              "description": "How the visualization size should be determined. If a string, should be one of `\"pad\"`, `\"fit\"` or `\"none\"`. Object values can additionally specify parameters for content sizing and automatic resizing.\n\n__Default value__: `pad`"
+            },
+            "background": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Color"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "CSS color property to use as the background of the entire view.\n\n__Default value:__ `\"white\"`"
+            },
+            "bounds": {
+              "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+              "enum": [
+                "full",
+                "flush"
+              ],
+              "type": "string"
+            },
+            "center": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/RowCol<boolean>"
+                }
+              ],
+              "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\nAn object value of the form `{\"row\": boolean, \"column\": boolean}` can be used to supply different centering values for rows and columns.\n\n__Default value:__ `false`"
+            },
+            "columns": {
+              "description": "The number of columns to include in the view composition layout.\n\n__Default value__: `undefined` -- An infinite number of columns (a single row) will be assumed. This is equivalent to `hconcat` (for `concat`) and to using the `column` channel (for `facet` and `repeat`).\n\n__Note__:\n\n1) This property is only for:\n- the general (wrappable) `concat` operator (not `hconcat`/`vconcat`)\n- the `facet` and `repeat` operator with one field/repetition definition (without row/column nesting)\n\n2) Setting the `columns` to `1` is equivalent to `vconcat` (for `concat`) and to using the `row` channel (for `facet` and `repeat`).",
+              "type": "number"
+            },
+            "config": {
+              "$ref": "#/definitions/Config",
+              "description": "Vega-Lite configuration object. This property can only be defined at the top-level of a specification."
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Data"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+            },
+            "datasets": {
+              "$ref": "#/definitions/Datasets",
+              "description": "A global data store for named datasets. This is a mapping from names to inline datasets. This can be an array of objects or primitive values or a string. Arrays of primitive values are ingested as objects with a `data` property."
+            },
+            "description": {
+              "description": "Description of this mark for commenting purpose.",
+              "type": "string"
+            },
+            "name": {
+              "description": "Name of the visualization for later reference.",
+              "type": "string"
+            },
+            "padding": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Padding"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "The default visualization padding, in pixels, from the edge of the visualization canvas to the data rectangle. If a number, specifies padding for all sides. If an object, the value should have the format `{\"left\": 5, \"top\": 5, \"right\": 5, \"bottom\": 5}` to specify padding for each side of the visualization.\n\n__Default value__: `5`"
+            },
+            "params": {
+              "description": "Dynamic variables or selections that parameterize a visualization.",
+              "items": {
+                "$ref": "#/definitions/TopLevelParameter"
+              },
+              "type": "array"
+            },
+            "repeat": {
+              "anyOf": [
+                {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                {
+                  "$ref": "#/definitions/RepeatMapping"
+                }
+              ],
+              "description": "Definition for fields to be repeated. One of: 1) An array of fields to be repeated. If `\"repeat\"` is an array, the field can be referred to as `{\"repeat\": \"repeat\"}`. The repeated views are laid out in a wrapped row. You can set the number of columns to control the wrapping. 2) An object that maps `\"row\"` and/or `\"column\"` to the listed fields to be repeated along the particular orientations. The objects `{\"repeat\": \"row\"}` and `{\"repeat\": \"column\"}` can be used to refer to the repeated field respectively."
+            },
+            "resolve": {
+              "$ref": "#/definitions/Resolve",
+              "description": "Scale, axis, and legend resolutions for view composition specifications."
+            },
+            "spacing": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/definitions/RowCol<number>"
+                }
+              ],
+              "description": "The spacing in pixels between sub-views of the composition operator. An object of the form `{\"row\": number, \"column\": number}` can be used to set different spacing values for rows and columns.\n\n__Default value__: Depends on `\"spacing\"` property of [the view composition configuration](https://vega.github.io/vega-lite/docs/config.html#view-config) (`20` by default)"
+            },
+            "spec": {
+              "$ref": "#/definitions/NonNormalizedSpec",
+              "description": "A specification of the view that gets repeated."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "$ref": "#/definitions/TitleParams"
+                }
+              ],
+              "description": "Title for the plot."
+            },
+            "transform": {
+              "description": "An array of data transformations such as filter and new field calculation.",
+              "items": {
+                "$ref": "#/definitions/Transform"
+              },
+              "type": "array"
+            },
+            "usermeta": {
+              "$ref": "#/definitions/Dict",
+              "description": "Optional metadata that will be passed to Vega. This object is completely ignored by Vega and Vega-Lite and can be used for custom metadata."
+            }
+          },
+          "required": [
+            "repeat",
+            "spec"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "$schema": {
+              "description": "URL to [JSON schema](http://json-schema.org/) for a Vega-Lite specification. Unless you have a reason to change this, use `https://vega.github.io/schema/vega-lite/v5.json`. Setting the `$schema` property allows automatic validation and autocomplete in editors that support JSON schema.",
+              "format": "uri",
+              "type": "string"
+            },
+            "align": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/LayoutAlign"
+                },
+                {
+                  "$ref": "#/definitions/RowCol<LayoutAlign>"
+                }
+              ],
+              "description": "The alignment to apply to grid rows and columns. The supported string values are `\"all\"`, `\"each\"`, and `\"none\"`.\n\n- For `\"none\"`, a flow layout will be used, in which adjacent subviews are simply placed one after the other.\n- For `\"each\"`, subviews will be aligned into a clean grid structure, but each row or column may be of variable size.\n- For `\"all\"`, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns.\n\nAlternatively, an object value of the form `{\"row\": string, \"column\": string}` can be used to supply different alignments for rows and columns.\n\n__Default value:__ `\"all\"`."
+            },
+            "autosize": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/AutosizeType"
+                },
+                {
+                  "$ref": "#/definitions/AutoSizeParams"
+                }
+              ],
+              "description": "How the visualization size should be determined. If a string, should be one of `\"pad\"`, `\"fit\"` or `\"none\"`. Object values can additionally specify parameters for content sizing and automatic resizing.\n\n__Default value__: `pad`"
+            },
+            "background": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Color"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "CSS color property to use as the background of the entire view.\n\n__Default value:__ `\"white\"`"
+            },
+            "bounds": {
+              "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+              "enum": [
+                "full",
+                "flush"
+              ],
+              "type": "string"
+            },
+            "center": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "$ref": "#/definitions/RowCol<boolean>"
+                }
+              ],
+              "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\nAn object value of the form `{\"row\": boolean, \"column\": boolean}` can be used to supply different centering values for rows and columns.\n\n__Default value:__ `false`"
+            },
+            "columns": {
+              "description": "The number of columns to include in the view composition layout.\n\n__Default value__: `undefined` -- An infinite number of columns (a single row) will be assumed. This is equivalent to `hconcat` (for `concat`) and to using the `column` channel (for `facet` and `repeat`).\n\n__Note__:\n\n1) This property is only for:\n- the general (wrappable) `concat` operator (not `hconcat`/`vconcat`)\n- the `facet` and `repeat` operator with one field/repetition definition (without row/column nesting)\n\n2) Setting the `columns` to `1` is equivalent to `vconcat` (for `concat`) and to using the `row` channel (for `facet` and `repeat`).",
+              "type": "number"
+            },
+            "config": {
+              "$ref": "#/definitions/Config",
+              "description": "Vega-Lite configuration object. This property can only be defined at the top-level of a specification."
+            },
+            "data": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Data"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+            },
+            "datasets": {
+              "$ref": "#/definitions/Datasets",
+              "description": "A global data store for named datasets. This is a mapping from names to inline datasets. This can be an array of objects or primitive values or a string. Arrays of primitive values are ingested as objects with a `data` property."
+            },
+            "description": {
+              "description": "Description of this mark for commenting purpose.",
+              "type": "string"
+            },
+            "name": {
+              "description": "Name of the visualization for later reference.",
+              "type": "string"
+            },
+            "padding": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Padding"
+                },
+                {
+                  "$ref": "#/definitions/ExprRef"
+                }
+              ],
+              "description": "The default visualization padding, in pixels, from the edge of the visualization canvas to the data rectangle. If a number, specifies padding for all sides. If an object, the value should have the format `{\"left\": 5, \"top\": 5, \"right\": 5, \"bottom\": 5}` to specify padding for each side of the visualization.\n\n__Default value__: `5`"
+            },
+            "params": {
+              "description": "Dynamic variables or selections that parameterize a visualization.",
+              "items": {
+                "$ref": "#/definitions/TopLevelParameter"
+              },
+              "type": "array"
+            },
+            "repeat": {
+              "$ref": "#/definitions/LayerRepeatMapping",
+              "description": "Definition for fields to be repeated. One of: 1) An array of fields to be repeated. If `\"repeat\"` is an array, the field can be referred to as `{\"repeat\": \"repeat\"}`. The repeated views are laid out in a wrapped row. You can set the number of columns to control the wrapping. 2) An object that maps `\"row\"` and/or `\"column\"` to the listed fields to be repeated along the particular orientations. The objects `{\"repeat\": \"row\"}` and `{\"repeat\": \"column\"}` can be used to refer to the repeated field respectively."
+            },
+            "resolve": {
+              "$ref": "#/definitions/Resolve",
+              "description": "Scale, axis, and legend resolutions for view composition specifications."
+            },
+            "spacing": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/definitions/RowCol<number>"
+                }
+              ],
+              "description": "The spacing in pixels between sub-views of the composition operator. An object of the form `{\"row\": number, \"column\": number}` can be used to set different spacing values for rows and columns.\n\n__Default value__: Depends on `\"spacing\"` property of [the view composition configuration](https://vega.github.io/vega-lite/docs/config.html#view-config) (`20` by default)"
+            },
+            "spec": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/LayerSpec"
+                },
+                {
+                  "$ref": "#/definitions/UnitSpecWithFrame"
+                }
+              ],
+              "description": "A specification of the view that gets repeated."
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Text"
+                },
+                {
+                  "$ref": "#/definitions/TitleParams"
+                }
+              ],
+              "description": "Title for the plot."
+            },
+            "transform": {
+              "description": "An array of data transformations such as filter and new field calculation.",
+              "items": {
+                "$ref": "#/definitions/Transform"
+              },
+              "type": "array"
+            },
+            "usermeta": {
+              "$ref": "#/definitions/Dict",
+              "description": "Optional metadata that will be passed to Vega. This object is completely ignored by Vega and Vega-Lite and can be used for custom metadata."
+            }
+          },
+          "required": [
+            "repeat",
+            "spec"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "TopLevelFacetSpec": {
+      "additionalProperties": false,
+      "properties": {
+        "$schema": {
+          "description": "URL to [JSON schema](http://json-schema.org/) for a Vega-Lite specification. Unless you have a reason to change this, use `https://vega.github.io/schema/vega-lite/v5.json`. Setting the `$schema` property allows automatic validation and autocomplete in editors that support JSON schema.",
+          "format": "uri",
+          "type": "string"
+        },
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayoutAlign"
+            },
+            {
+              "$ref": "#/definitions/RowCol<LayoutAlign>"
+            }
+          ],
+          "description": "The alignment to apply to grid rows and columns. The supported string values are `\"all\"`, `\"each\"`, and `\"none\"`.\n\n- For `\"none\"`, a flow layout will be used, in which adjacent subviews are simply placed one after the other.\n- For `\"each\"`, subviews will be aligned into a clean grid structure, but each row or column may be of variable size.\n- For `\"all\"`, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns.\n\nAlternatively, an object value of the form `{\"row\": string, \"column\": string}` can be used to supply different alignments for rows and columns.\n\n__Default value:__ `\"all\"`."
+        },
+        "autosize": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/AutosizeType"
+            },
+            {
+              "$ref": "#/definitions/AutoSizeParams"
+            }
+          ],
+          "description": "How the visualization size should be determined. If a string, should be one of `\"pad\"`, `\"fit\"` or `\"none\"`. Object values can additionally specify parameters for content sizing and automatic resizing.\n\n__Default value__: `pad`"
+        },
+        "background": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "CSS color property to use as the background of the entire view.\n\n__Default value:__ `\"white\"`"
+        },
+        "bounds": {
+          "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+          "enum": [
+            "full",
+            "flush"
+          ],
+          "type": "string"
+        },
+        "center": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/RowCol<boolean>"
+            }
+          ],
+          "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\nAn object value of the form `{\"row\": boolean, \"column\": boolean}` can be used to supply different centering values for rows and columns.\n\n__Default value:__ `false`"
+        },
+        "columns": {
+          "description": "The number of columns to include in the view composition layout.\n\n__Default value__: `undefined` -- An infinite number of columns (a single row) will be assumed. This is equivalent to `hconcat` (for `concat`) and to using the `column` channel (for `facet` and `repeat`).\n\n__Note__:\n\n1) This property is only for:\n- the general (wrappable) `concat` operator (not `hconcat`/`vconcat`)\n- the `facet` and `repeat` operator with one field/repetition definition (without row/column nesting)\n\n2) Setting the `columns` to `1` is equivalent to `vconcat` (for `concat`) and to using the `row` channel (for `facet` and `repeat`).",
+          "type": "number"
+        },
+        "config": {
+          "$ref": "#/definitions/Config",
+          "description": "Vega-Lite configuration object. This property can only be defined at the top-level of a specification."
+        },
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "datasets": {
+          "$ref": "#/definitions/Datasets",
+          "description": "A global data store for named datasets. This is a mapping from names to inline datasets. This can be an array of objects or primitive values or a string. Arrays of primitive values are ingested as objects with a `data` property."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "facet": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FacetFieldDef"
+            },
+            {
+              "$ref": "#/definitions/FacetMapping"
+            }
+          ],
+          "description": "Definition for how to facet the data. One of: 1) [a field definition for faceting the plot by one field](https://vega.github.io/vega-lite/docs/facet.html#field-def) 2) [An object that maps `row` and `column` channels to their field definitions](https://vega.github.io/vega-lite/docs/facet.html#mapping)"
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "padding": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Padding"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The default visualization padding, in pixels, from the edge of the visualization canvas to the data rectangle. If a number, specifies padding for all sides. If an object, the value should have the format `{\"left\": 5, \"top\": 5, \"right\": 5, \"bottom\": 5}` to specify padding for each side of the visualization.\n\n__Default value__: `5`"
+        },
+        "params": {
+          "description": "Dynamic variables or selections that parameterize a visualization.",
+          "items": {
+            "$ref": "#/definitions/TopLevelParameter"
+          },
+          "type": "array"
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "spacing": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/RowCol<number>"
+            }
+          ],
+          "description": "The spacing in pixels between sub-views of the composition operator. An object of the form `{\"row\": number, \"column\": number}` can be used to set different spacing values for rows and columns.\n\n__Default value__: Depends on `\"spacing\"` property of [the view composition configuration](https://vega.github.io/vega-lite/docs/config.html#view-config) (`20` by default)"
+        },
+        "spec": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayerSpec"
+            },
+            {
+              "$ref": "#/definitions/UnitSpecWithFrame"
+            }
+          ],
+          "description": "A specification of the view that gets faceted."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        },
+        "usermeta": {
+          "$ref": "#/definitions/Dict",
+          "description": "Optional metadata that will be passed to Vega. This object is completely ignored by Vega and Vega-Lite and can be used for custom metadata."
+        }
+      },
+      "required": [
+        "data",
+        "facet",
+        "spec"
+      ],
+      "type": "object"
+    },
+    "TopLevelParameter": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/VariableParameter"
+        },
+        {
+          "$ref": "#/definitions/TopLevelSelectionParameter"
+        }
+      ]
+    },
+    "TopLevelSelectionParameter": {
+      "additionalProperties": false,
+      "properties": {
+        "bind": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Binding"
+            },
+            {
+              "additionalProperties": {
+                "$ref": "#/definitions/Binding"
+              },
+              "type": "object"
+            },
+            {
+              "$ref": "#/definitions/LegendBinding"
+            },
+            {
+              "const": "scales",
+              "type": "string"
+            }
+          ],
+          "description": "When set, a selection is populated by input elements (also known as dynamic query widgets) or by interacting with the corresponding legend. Direct manipulation interaction is disabled by default; to re-enable it, set the selection's [`on`](https://vega.github.io/vega-lite/docs/selection.html#common-selection-properties) property.\n\nLegend bindings are restricted to selections that only specify a single field or encoding.\n\nQuery widget binding takes the form of Vega's [input element binding definition](https://vega.github.io/vega/docs/signals/#bind) or can be a mapping between projected field/encodings and binding definitions.\n\n__See also:__ [`bind`](https://vega.github.io/vega-lite/docs/bind.html) documentation."
+        },
+        "name": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "Required. A unique name for the selection parameter. Selection names should be valid JavaScript identifiers: they should contain only alphanumeric characters (or \"$\", or \"_\") and may not start with a digit. Reserved keywords that may not be used as parameter names are \"datum\", \"event\", \"item\", and \"parent\"."
+        },
+        "select": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SelectionType"
+            },
+            {
+              "$ref": "#/definitions/PointSelectionConfig"
+            },
+            {
+              "$ref": "#/definitions/IntervalSelectionConfig"
+            }
+          ],
+          "description": "Determines the default event processing and data query for the selection. Vega-Lite currently supports two selection types:\n\n- `\"point\"` -- to select multiple discrete data values; the first value is selected on `click` and additional values toggled on shift-click.\n- `\"interval\"` -- to select a continuous range of data values on `drag`."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SelectionInit"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/SelectionInitMapping"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/SelectionInitIntervalMapping"
+            }
+          ],
+          "description": "Initialize the selection with a mapping between [projected channels or field names](https://vega.github.io/vega-lite/docs/selection.html#project) and initial values.\n\n__See also:__ [`init`](https://vega.github.io/vega-lite/docs/value.html) documentation."
+        },
+        "views": {
+          "description": "By default, top-level selections are applied to every view in the visualization. If this property is specified, selections will only be applied to views with the given names.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "name",
+        "select"
+      ],
+      "type": "object"
+    },
+    "TopLevelSpec": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/TopLevelUnitSpec"
+        },
+        {
+          "$ref": "#/definitions/TopLevelFacetSpec"
+        },
+        {
+          "$ref": "#/definitions/TopLevelLayerSpec"
+        },
+        {
+          "$ref": "#/definitions/TopLevelRepeatSpec"
+        },
+        {
+          "$ref": "#/definitions/TopLevelConcatSpec"
+        },
+        {
+          "$ref": "#/definitions/TopLevelVConcatSpec"
+        },
+        {
+          "$ref": "#/definitions/TopLevelHConcatSpec"
+        }
+      ],
+      "description": "A Vega-Lite top-level specification. This is the root class for all Vega-Lite specifications. (The json schema is generated from this type.)"
+    },
+    "TopLevelUnitSpec": {
+      "additionalProperties": false,
+      "properties": {
+        "$schema": {
+          "description": "URL to [JSON schema](http://json-schema.org/) for a Vega-Lite specification. Unless you have a reason to change this, use `https://vega.github.io/schema/vega-lite/v5.json`. Setting the `$schema` property allows automatic validation and autocomplete in editors that support JSON schema.",
+          "format": "uri",
+          "type": "string"
+        },
+        "align": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/LayoutAlign"
+            },
+            {
+              "$ref": "#/definitions/RowCol<LayoutAlign>"
+            }
+          ],
+          "description": "The alignment to apply to grid rows and columns. The supported string values are `\"all\"`, `\"each\"`, and `\"none\"`.\n\n- For `\"none\"`, a flow layout will be used, in which adjacent subviews are simply placed one after the other.\n- For `\"each\"`, subviews will be aligned into a clean grid structure, but each row or column may be of variable size.\n- For `\"all\"`, subviews will be aligned and each row or column will be sized identically based on the maximum observed size. String values for this property will be applied to both grid rows and columns.\n\nAlternatively, an object value of the form `{\"row\": string, \"column\": string}` can be used to supply different alignments for rows and columns.\n\n__Default value:__ `\"all\"`."
+        },
+        "autosize": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/AutosizeType"
+            },
+            {
+              "$ref": "#/definitions/AutoSizeParams"
+            }
+          ],
+          "description": "How the visualization size should be determined. If a string, should be one of `\"pad\"`, `\"fit\"` or `\"none\"`. Object values can additionally specify parameters for content sizing and automatic resizing.\n\n__Default value__: `pad`"
+        },
+        "background": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "CSS color property to use as the background of the entire view.\n\n__Default value:__ `\"white\"`"
+        },
+        "bounds": {
+          "description": "The bounds calculation method to use for determining the extent of a sub-plot. One of `full` (the default) or `flush`.\n\n- If set to `full`, the entire calculated bounds (including axes, title, and legend) will be used.\n- If set to `flush`, only the specified width and height values for the sub-view will be used. The `flush` setting can be useful when attempting to place sub-plots without axes or legends into a uniform grid structure.\n\n__Default value:__ `\"full\"`",
+          "enum": [
+            "full",
+            "flush"
+          ],
+          "type": "string"
+        },
+        "center": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/RowCol<boolean>"
+            }
+          ],
+          "description": "Boolean flag indicating if subviews should be centered relative to their respective rows or columns.\n\nAn object value of the form `{\"row\": boolean, \"column\": boolean}` can be used to supply different centering values for rows and columns.\n\n__Default value:__ `false`"
+        },
+        "config": {
+          "$ref": "#/definitions/Config",
+          "description": "Vega-Lite configuration object. This property can only be defined at the top-level of a specification."
+        },
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "datasets": {
+          "$ref": "#/definitions/Datasets",
+          "description": "A global data store for named datasets. This is a mapping from names to inline datasets. This can be an array of objects or primitive values or a string. Arrays of primitive values are ingested as objects with a `data` property."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "encoding": {
+          "$ref": "#/definitions/FacetedEncoding",
+          "description": "A key-value mapping between encoding channels and definition of fields."
+        },
+        "height": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "container",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Step"
+            }
+          ],
+          "description": "The height of a visualization.\n\n- For a plot with a continuous y-field, height should be a number.\n- For a plot with either a discrete y-field or no y-field, height can be either a number indicating a fixed height or an object in the form of `{step: number}` defining the height per discrete step. (No y-field is equivalent to having one discrete step.)\n- To enable responsive sizing on height, it should be set to `\"container\"`.\n\n__Default value:__ Based on `config.view.continuousHeight` for a plot with a continuous y-field and `config.view.discreteHeight` otherwise.\n\n__Note:__ For plots with [`row` and `column` channels](https://vega.github.io/vega-lite/docs/encoding.html#facet), this represents the height of a single view and the `\"container\"` option cannot be used.\n\n__See also:__ [`height`](https://vega.github.io/vega-lite/docs/size.html) documentation."
+        },
+        "mark": {
+          "$ref": "#/definitions/AnyMark",
+          "description": "A string describing the mark type (one of `\"bar\"`, `\"circle\"`, `\"square\"`, `\"tick\"`, `\"line\"`, `\"area\"`, `\"point\"`, `\"rule\"`, `\"geoshape\"`, and `\"text\"`) or a [mark definition object](https://vega.github.io/vega-lite/docs/mark.html#mark-def)."
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "padding": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Padding"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The default visualization padding, in pixels, from the edge of the visualization canvas to the data rectangle. If a number, specifies padding for all sides. If an object, the value should have the format `{\"left\": 5, \"top\": 5, \"right\": 5, \"bottom\": 5}` to specify padding for each side of the visualization.\n\n__Default value__: `5`"
+        },
+        "params": {
+          "description": "An array of parameters that may either be simple variables, or more complex selections that map user input to data queries.",
+          "items": {
+            "$ref": "#/definitions/TopLevelParameter"
+          },
+          "type": "array"
+        },
+        "projection": {
+          "$ref": "#/definitions/Projection",
+          "description": "An object defining properties of geographic projection, which will be applied to `shape` path for `\"geoshape\"` marks and to `latitude` and `\"longitude\"` channels for other marks."
+        },
+        "resolve": {
+          "$ref": "#/definitions/Resolve",
+          "description": "Scale, axis, and legend resolutions for view composition specifications."
+        },
+        "spacing": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/RowCol<number>"
+            }
+          ],
+          "description": "The spacing in pixels between sub-views of the composition operator. An object of the form `{\"row\": number, \"column\": number}` can be used to set different spacing values for rows and columns.\n\n__Default value__: Depends on `\"spacing\"` property of [the view composition configuration](https://vega.github.io/vega-lite/docs/config.html#view-config) (`20` by default)"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        },
+        "usermeta": {
+          "$ref": "#/definitions/Dict",
+          "description": "Optional metadata that will be passed to Vega. This object is completely ignored by Vega and Vega-Lite and can be used for custom metadata."
+        },
+        "view": {
+          "$ref": "#/definitions/ViewBackground",
+          "description": "An object defining the view background's fill and stroke.\n\n__Default value:__ none (transparent)"
+        },
+        "width": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "container",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Step"
+            }
+          ],
+          "description": "The width of a visualization.\n\n- For a plot with a continuous x-field, width should be a number.\n- For a plot with either a discrete x-field or no x-field, width can be either a number indicating a fixed width or an object in the form of `{step: number}` defining the width per discrete step. (No x-field is equivalent to having one discrete step.)\n- To enable responsive sizing on width, it should be set to `\"container\"`.\n\n__Default value:__ Based on `config.view.continuousWidth` for a plot with a continuous x-field and `config.view.discreteWidth` otherwise.\n\n__Note:__ For plots with [`row` and `column` channels](https://vega.github.io/vega-lite/docs/encoding.html#facet), this represents the width of a single view and the `\"container\"` option cannot be used.\n\n__See also:__ [`width`](https://vega.github.io/vega-lite/docs/size.html) documentation."
+        }
+      },
+      "required": [
+        "data",
+        "mark"
+      ],
+      "type": "object"
+    },
+    "TopoDataFormat": {
+      "additionalProperties": false,
+      "properties": {
+        "feature": {
+          "description": "The name of the TopoJSON object set to convert to a GeoJSON feature collection. For example, in a map of the world, there may be an object set named `\"countries\"`. Using the feature property, we can extract this set and generate a GeoJSON feature object for each country.",
+          "type": "string"
+        },
+        "mesh": {
+          "description": "The name of the TopoJSON object set to convert to mesh. Similar to the `feature` option, `mesh` extracts a named TopoJSON object set.  Unlike the `feature` option, the corresponding geo data is returned as a single, unified mesh instance, not as individual GeoJSON features. Extracting a mesh is useful for more efficiently drawing borders or other geographic elements that you do not need to associate with specific regions such as individual countries, states or counties.",
+          "type": "string"
+        },
+        "parse": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Parse"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "If set to `null`, disable type inference based on the spec and only use type inference based on the data. Alternatively, a parsing directive object can be provided for explicit data types. Each property of the object corresponds to a field name, and the value to the desired data type (one of `\"number\"`, `\"boolean\"`, `\"date\"`, or null (do not parse the field)). For example, `\"parse\": {\"modified_on\": \"date\"}` parses the `modified_on` field in each input record a Date value.\n\nFor `\"date\"`, we parse data based using JavaScript's [`Date.parse()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse). For Specific date formats can be provided (e.g., `{foo: \"date:'%m%d%Y'\"}`), using the [d3-time-format syntax](https://github.com/d3/d3-time-format#locale_format). UTC date format parsing is supported similarly (e.g., `{foo: \"utc:'%m%d%Y'\"}`). See more about [UTC time](https://vega.github.io/vega-lite/docs/timeunit.html#utc)"
+        },
+        "type": {
+          "const": "topojson",
+          "description": "Type of input data: `\"json\"`, `\"csv\"`, `\"tsv\"`, `\"dsv\"`.\n\n__Default value:__  The default format type is determined by the extension of the file URL. If no extension is detected, `\"json\"` will be used by default.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "Transform": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/AggregateTransform"
+        },
+        {
+          "$ref": "#/definitions/BinTransform"
+        },
+        {
+          "$ref": "#/definitions/CalculateTransform"
+        },
+        {
+          "$ref": "#/definitions/DensityTransform"
+        },
+        {
+          "$ref": "#/definitions/ExtentTransform"
+        },
+        {
+          "$ref": "#/definitions/FilterTransform"
+        },
+        {
+          "$ref": "#/definitions/FlattenTransform"
+        },
+        {
+          "$ref": "#/definitions/FoldTransform"
+        },
+        {
+          "$ref": "#/definitions/ImputeTransform"
+        },
+        {
+          "$ref": "#/definitions/JoinAggregateTransform"
+        },
+        {
+          "$ref": "#/definitions/LoessTransform"
+        },
+        {
+          "$ref": "#/definitions/LookupTransform"
+        },
+        {
+          "$ref": "#/definitions/QuantileTransform"
+        },
+        {
+          "$ref": "#/definitions/RegressionTransform"
+        },
+        {
+          "$ref": "#/definitions/TimeUnitTransform"
+        },
+        {
+          "$ref": "#/definitions/SampleTransform"
+        },
+        {
+          "$ref": "#/definitions/StackTransform"
+        },
+        {
+          "$ref": "#/definitions/WindowTransform"
+        },
+        {
+          "$ref": "#/definitions/PivotTransform"
+        }
+      ]
+    },
+    "Type": {
+      "description": "Data type based on level of measurement",
+      "enum": [
+        "quantitative",
+        "ordinal",
+        "temporal",
+        "nominal",
+        "geojson"
+      ],
+      "type": "string"
+    },
+    "TypeForShape": {
+      "enum": [
+        "nominal",
+        "ordinal",
+        "geojson"
+      ],
+      "type": "string"
+    },
+    "TypedFieldDef": {
+      "additionalProperties": false,
+      "description": "Definition object for a data field, its type and transformation of an encoding channel.",
+      "properties": {
+        "aggregate": {
+          "$ref": "#/definitions/Aggregate",
+          "description": "Aggregation function for the field (e.g., `\"mean\"`, `\"sum\"`, `\"median\"`, `\"min\"`, `\"max\"`, `\"count\"`).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html) documentation."
+        },
+        "bandPosition": {
+          "description": "Relative position on a band of a stacked, binned, time unit, or band scale. For example, the marks will be positioned at the beginning of the band if set to `0`, and at the middle of the band if set to `0.5`.",
+          "maximum": 1,
+          "minimum": 0,
+          "type": "number"
+        },
+        "bin": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/definitions/BinParams"
+            },
+            {
+              "const": "binned",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A flag for binning a `quantitative` field, [an object defining binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters), or indicating that the data for `x` or `y` channel are binned before they are imported into Vega-Lite (`\"binned\"`).\n\n- If `true`, default [binning parameters](https://vega.github.io/vega-lite/docs/bin.html#bin-parameters) will be applied.\n\n- If `\"binned\"`, this indicates that the data for the `x` (or `y`) channel are already binned. You can map the bin-start field to `x` (or `y`) and the bin-end field to `x2` (or `y2`). The scale and axis will be formatted similar to binning in Vega-Lite.  To adjust the axis ticks based on the bin step, you can also set the axis's [`tickMinStep`](https://vega.github.io/vega-lite/docs/axis.html#ticks) property.\n\n__Default value:__ `false`\n\n__See also:__ [`bin`](https://vega.github.io/vega-lite/docs/bin.html) documentation."
+        },
+        "field": {
+          "$ref": "#/definitions/Field",
+          "description": "__Required.__ A string defining the name of the field from which to pull a data value or an object defining iterated values from the [`repeat`](https://vega.github.io/vega-lite/docs/repeat.html) operator.\n\n__See also:__ [`field`](https://vega.github.io/vega-lite/docs/field.html) documentation.\n\n__Notes:__ 1)  Dots (`.`) and brackets (`[` and `]`) can be used to access nested objects (e.g., `\"field\": \"foo.bar\"` and `\"field\": \"foo['bar']\"`). If field names contain dots or brackets but are not nested, you can use `\\\\` to escape dots and brackets (e.g., `\"a\\\\.b\"` and `\"a\\\\[0\\\\]\"`). See more details about escaping in the [field documentation](https://vega.github.io/vega-lite/docs/field.html). 2) `field` is not required if `aggregate` is `count`."
+        },
+        "timeUnit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeUnit"
+            },
+            {
+              "$ref": "#/definitions/BinnedTimeUnit"
+            },
+            {
+              "$ref": "#/definitions/TimeUnitParams"
+            }
+          ],
+          "description": "Time unit (e.g., `year`, `yearmonth`, `month`, `hours`) for a temporal field. or [a temporal field that gets casted as ordinal](https://vega.github.io/vega-lite/docs/type.html#cast).\n\n__Default value:__ `undefined` (None)\n\n__See also:__ [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html) documentation."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A title for the field. If `null`, the title will be removed.\n\n__Default value:__  derived from the field's name and transformation function (`aggregate`, `bin` and `timeUnit`). If the field has an aggregate function, the function is displayed as part of the title (e.g., `\"Sum of Profit\"`). If the field is binned or has a time unit applied, the applied function is shown in parentheses (e.g., `\"Profit (binned)\"`, `\"Transaction Date (year-month)\"`). Otherwise, the title is simply the field name.\n\n__Notes__:\n\n1) You can customize the default field title format by providing the [`fieldTitle`](https://vega.github.io/vega-lite/docs/config.html#top-level-config) property in the [config](https://vega.github.io/vega-lite/docs/config.html) or [`fieldTitle` function via the `compile` function's options](https://vega.github.io/vega-lite/usage/compile.html#field-title).\n\n2) If both field definition's `title` and axis, header, or legend `title` are defined, axis/header/legend title will be used."
+        },
+        "type": {
+          "$ref": "#/definitions/StandardType",
+          "description": "The type of measurement (`\"quantitative\"`, `\"temporal\"`, `\"ordinal\"`, or `\"nominal\"`) for the encoded field or constant value (`datum`). It can also be a `\"geojson\"` type for encoding ['geoshape'](https://vega.github.io/vega-lite/docs/geoshape.html).\n\nVega-Lite automatically infers data types in many cases as discussed below. However, type is required for a field if: (1) the field is not nominal and the field encoding has no specified `aggregate` (except `argmin` and `argmax`), `bin`, scale type, custom `sort` order, nor `timeUnit` or (2) if you wish to use an ordinal scale for a field with `bin` or `timeUnit`.\n\n__Default value:__\n\n1) For a data `field`, `\"nominal\"` is the default data type unless the field encoding has `aggregate`, `channel`, `bin`, scale type, `sort`, or `timeUnit` that satisfies the following criteria:\n- `\"quantitative\"` is the default type if (1) the encoded field contains `bin` or `aggregate` except `\"argmin\"` and `\"argmax\"`, (2) the encoding channel is `latitude` or `longitude` channel or (3) if the specified scale type is [a quantitative scale](https://vega.github.io/vega-lite/docs/scale.html#type).\n- `\"temporal\"` is the default type if (1) the encoded field contains `timeUnit` or (2) the specified scale type is a time or utc scale\n- `\"ordinal\"` is the default type if (1) the encoded field contains a [custom `sort` order](https://vega.github.io/vega-lite/docs/sort.html#specifying-custom-sort-order), (2) the specified scale type is an ordinal/point/band scale, or (3) the encoding channel is `order`.\n\n2) For a constant value in data domain (`datum`):\n- `\"quantitative\"` if the datum is a number\n- `\"nominal\"` if the datum is a string\n- `\"temporal\"` if the datum is [a date time object](https://vega.github.io/vega-lite/docs/datetime.html)\n\n__Note:__\n- Data `type` describes the semantics of the data rather than the primitive data types (number, string, etc.). The same primitive data type can have different types of measurement. For example, numeric data can represent quantitative, ordinal, or nominal data.\n- Data values for a temporal field can be either a date-time string (e.g., `\"2015-03-07 12:32:17\"`, `\"17:01\"`, `\"2015-03-16\"`. `\"2015\"`) or a timestamp number (e.g., `1552199579097`).\n- When using with [`bin`](https://vega.github.io/vega-lite/docs/bin.html), the `type` property can be either `\"quantitative\"` (for using a linear bin scale) or [`\"ordinal\"` (for using an ordinal bin scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`timeUnit`](https://vega.github.io/vega-lite/docs/timeunit.html), the `type` property can be either `\"temporal\"` (default, for using a temporal scale) or [`\"ordinal\"` (for using an ordinal scale)](https://vega.github.io/vega-lite/docs/type.html#cast-bin).\n- When using with [`aggregate`](https://vega.github.io/vega-lite/docs/aggregate.html), the `type` property refers to the post-aggregation data type. For example, we can calculate count `distinct` of a categorical field `\"cat\"` using `{\"aggregate\": \"distinct\", \"field\": \"cat\"}`. The `\"type\"` of the aggregate output is `\"quantitative\"`.\n- Secondary channels (e.g., `x2`, `y2`, `xError`, `yError`) do not have `type` as they must have exactly the same type as their primary channels (e.g., `x`, `y`).\n\n__See also:__ [`type`](https://vega.github.io/vega-lite/docs/type.html) documentation."
+        }
+      },
+      "type": "object"
+    },
+    "URI": {
+      "format": "uri-reference",
+      "type": "string"
+    },
+    "UnitSpec": {
+      "$ref": "#/definitions/GenericUnitSpec<Encoding,AnyMark>",
+      "description": "A unit specification, which can contain either [primitive marks or composite marks](https://vega.github.io/vega-lite/docs/mark.html#types)."
+    },
+    "UnitSpecWithFrame": {
+      "additionalProperties": false,
+      "properties": {
+        "data": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Data"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "An object describing the data source. Set to `null` to ignore the parent's data source. If no data is set, it is derived from the parent."
+        },
+        "description": {
+          "description": "Description of this mark for commenting purpose.",
+          "type": "string"
+        },
+        "encoding": {
+          "$ref": "#/definitions/Encoding",
+          "description": "A key-value mapping between encoding channels and definition of fields."
+        },
+        "height": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "container",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Step"
+            }
+          ],
+          "description": "The height of a visualization.\n\n- For a plot with a continuous y-field, height should be a number.\n- For a plot with either a discrete y-field or no y-field, height can be either a number indicating a fixed height or an object in the form of `{step: number}` defining the height per discrete step. (No y-field is equivalent to having one discrete step.)\n- To enable responsive sizing on height, it should be set to `\"container\"`.\n\n__Default value:__ Based on `config.view.continuousHeight` for a plot with a continuous y-field and `config.view.discreteHeight` otherwise.\n\n__Note:__ For plots with [`row` and `column` channels](https://vega.github.io/vega-lite/docs/encoding.html#facet), this represents the height of a single view and the `\"container\"` option cannot be used.\n\n__See also:__ [`height`](https://vega.github.io/vega-lite/docs/size.html) documentation."
+        },
+        "mark": {
+          "$ref": "#/definitions/AnyMark",
+          "description": "A string describing the mark type (one of `\"bar\"`, `\"circle\"`, `\"square\"`, `\"tick\"`, `\"line\"`, `\"area\"`, `\"point\"`, `\"rule\"`, `\"geoshape\"`, and `\"text\"`) or a [mark definition object](https://vega.github.io/vega-lite/docs/mark.html#mark-def)."
+        },
+        "name": {
+          "description": "Name of the visualization for later reference.",
+          "type": "string"
+        },
+        "params": {
+          "description": "An array of parameters that may either be simple variables, or more complex selections that map user input to data queries.",
+          "items": {
+            "$ref": "#/definitions/SelectionParameter"
+          },
+          "type": "array"
+        },
+        "projection": {
+          "$ref": "#/definitions/Projection",
+          "description": "An object defining properties of geographic projection, which will be applied to `shape` path for `\"geoshape\"` marks and to `latitude` and `\"longitude\"` channels for other marks."
+        },
+        "title": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/TitleParams"
+            }
+          ],
+          "description": "Title for the plot."
+        },
+        "transform": {
+          "description": "An array of data transformations such as filter and new field calculation.",
+          "items": {
+            "$ref": "#/definitions/Transform"
+          },
+          "type": "array"
+        },
+        "view": {
+          "$ref": "#/definitions/ViewBackground",
+          "description": "An object defining the view background's fill and stroke.\n\n__Default value:__ none (transparent)"
+        },
+        "width": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "container",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/Step"
+            }
+          ],
+          "description": "The width of a visualization.\n\n- For a plot with a continuous x-field, width should be a number.\n- For a plot with either a discrete x-field or no x-field, width can be either a number indicating a fixed width or an object in the form of `{step: number}` defining the width per discrete step. (No x-field is equivalent to having one discrete step.)\n- To enable responsive sizing on width, it should be set to `\"container\"`.\n\n__Default value:__ Based on `config.view.continuousWidth` for a plot with a continuous x-field and `config.view.discreteWidth` otherwise.\n\n__Note:__ For plots with [`row` and `column` channels](https://vega.github.io/vega-lite/docs/encoding.html#facet), this represents the width of a single view and the `\"container\"` option cannot be used.\n\n__See also:__ [`width`](https://vega.github.io/vega-lite/docs/size.html) documentation."
+        }
+      },
+      "required": [
+        "mark"
+      ],
+      "type": "object"
+    },
+    "UrlData": {
+      "additionalProperties": false,
+      "properties": {
+        "format": {
+          "$ref": "#/definitions/DataFormat",
+          "description": "An object that specifies the format for parsing the data."
+        },
+        "name": {
+          "description": "Provide a placeholder name and bind data at runtime.",
+          "type": "string"
+        },
+        "url": {
+          "description": "An URL from which to load the data set. Use the `format.type` property to ensure the loaded data is correctly parsed.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "url"
+      ],
+      "type": "object"
+    },
+    "UtcMultiTimeUnit": {
+      "enum": [
+        "utcyearquarter",
+        "utcyearquartermonth",
+        "utcyearmonth",
+        "utcyearmonthdate",
+        "utcyearmonthdatehours",
+        "utcyearmonthdatehoursminutes",
+        "utcyearmonthdatehoursminutesseconds",
+        "utcyearweek",
+        "utcyearweekday",
+        "utcyearweekdayhours",
+        "utcyearweekdayhoursminutes",
+        "utcyearweekdayhoursminutesseconds",
+        "utcyeardayofyear",
+        "utcquartermonth",
+        "utcmonthdate",
+        "utcmonthdatehours",
+        "utcmonthdatehoursminutes",
+        "utcmonthdatehoursminutesseconds",
+        "utcweekday",
+        "utcweeksdayhours",
+        "utcweekdayhoursminutes",
+        "utcweekdayhoursminutesseconds",
+        "utcdayhours",
+        "utcdayhoursminutes",
+        "utcdayhoursminutesseconds",
+        "utchoursminutes",
+        "utchoursminutesseconds",
+        "utcminutesseconds",
+        "utcsecondsmilliseconds"
+      ],
+      "type": "string"
+    },
+    "UtcSingleTimeUnit": {
+      "enum": [
+        "utcyear",
+        "utcquarter",
+        "utcmonth",
+        "utcweek",
+        "utcday",
+        "utcdayofyear",
+        "utcdate",
+        "utchours",
+        "utcminutes",
+        "utcseconds",
+        "utcmilliseconds"
+      ],
+      "type": "string"
+    },
+    "ValueDef<(number|\"width\"|\"height\"|ExprRef)>": {
+      "additionalProperties": false,
+      "description": "Definition object for a constant value (primitive value or gradient definition) of an encoding channel.",
+      "properties": {
+        "value": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "const": "width",
+              "type": "string"
+            },
+            {
+              "const": "height",
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "required": [
+        "value"
+      ],
+      "type": "object"
+    },
+    "ValueDef<number>": {
+      "additionalProperties": false,
+      "description": "Definition object for a constant value (primitive value or gradient definition) of an encoding channel.",
+      "properties": {
+        "value": {
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity).",
+          "type": "number"
+        }
+      },
+      "required": [
+        "value"
+      ],
+      "type": "object"
+    },
+    "ValueDefWithCondition<MarkPropFieldOrDatumDef,(Gradient|string|null)>": {
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(Gradient|string|null|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "A field definition or one or more value definition(s) with a parameter predicate."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Gradient"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "type": "object"
+    },
+    "ValueDefWithCondition<MarkPropFieldOrDatumDef,(string|null)>": {
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "A field definition or one or more value definition(s) with a parameter predicate."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "type": "object"
+    },
+    "ValueDefWithCondition<MarkPropFieldOrDatumDef,number>": {
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(number|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "A field definition or one or more value definition(s) with a parameter predicate."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "type": "object"
+    },
+    "ValueDefWithCondition<MarkPropFieldOrDatumDef,number[]>": {
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(number[]|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(number[]|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "A field definition or one or more value definition(s) with a parameter predicate."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "type": "object"
+    },
+    "ValueDefWithCondition<MarkPropFieldOrDatumDef<TypeForShape>,(string|null)>": {
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalMarkPropFieldOrDatumDef<TypeForShape>"
+            },
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(string|null|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "A field definition or one or more value definition(s) with a parameter predicate."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "type": "object"
+    },
+    "ValueDefWithCondition<StringFieldDef,Text>": {
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "condition": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ConditionalStringFieldDef"
+            },
+            {
+              "$ref": "#/definitions/ConditionalValueDef<(Text|ExprRef)>"
+            },
+            {
+              "items": {
+                "$ref": "#/definitions/ConditionalValueDef<(Text|ExprRef)>"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "A field definition or one or more value definition(s) with a parameter predicate."
+        },
+        "value": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Text"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "A constant value in visual domain (e.g., `\"red\"` / `\"#0099ff\"` / [gradient definition](https://vega.github.io/vega-lite/docs/types.html#gradient) for color, values between `0` to `1` for opacity)."
+        }
+      },
+      "type": "object"
+    },
+    "VariableParameter": {
+      "additionalProperties": false,
+      "properties": {
+        "bind": {
+          "$ref": "#/definitions/Binding",
+          "description": "Binds the parameter to an external input element such as a slider, selection list or radio button group."
+        },
+        "expr": {
+          "$ref": "#/definitions/Expr",
+          "description": "An expression for the value of the parameter. This expression may include other parameters, in which case the parameter will automatically update in response to upstream parameter changes."
+        },
+        "name": {
+          "$ref": "#/definitions/ParameterName",
+          "description": "A unique name for the variable parameter. Parameter names should be valid JavaScript identifiers: they should contain only alphanumeric characters (or \"$\", or \"_\") and may not start with a digit. Reserved keywords that may not be used as parameter names are \"datum\", \"event\", \"item\", and \"parent\"."
+        },
+        "value": {
+          "description": "The [initial value](http://vega.github.io/vega-lite/docs/value.html) of the parameter.\n\n__Default value:__ `undefined`"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "type": "object"
+    },
+    "Vector10<string>": {
+      "items": {
+        "type": "string"
+      },
+      "maxItems": 10,
+      "minItems": 10,
+      "type": "array"
+    },
+    "Vector12<string>": {
+      "items": {
+        "type": "string"
+      },
+      "maxItems": 12,
+      "minItems": 12,
+      "type": "array"
+    },
+    "Vector2<DateTime>": {
+      "items": {
+        "$ref": "#/definitions/DateTime"
+      },
+      "maxItems": 2,
+      "minItems": 2,
+      "type": "array"
+    },
+    "Vector2<Vector2<number>>": {
+      "items": {
+        "$ref": "#/definitions/Vector2<number>"
+      },
+      "maxItems": 2,
+      "minItems": 2,
+      "type": "array"
+    },
+    "Vector2<boolean>": {
+      "items": {
+        "type": "boolean"
+      },
+      "maxItems": 2,
+      "minItems": 2,
+      "type": "array"
+    },
+    "Vector2<number>": {
+      "items": {
+        "type": "number"
+      },
+      "maxItems": 2,
+      "minItems": 2,
+      "type": "array"
+    },
+    "Vector2<string>": {
+      "items": {
+        "type": "string"
+      },
+      "maxItems": 2,
+      "minItems": 2,
+      "type": "array"
+    },
+    "Vector3<number>": {
+      "items": {
+        "type": "number"
+      },
+      "maxItems": 3,
+      "minItems": 3,
+      "type": "array"
+    },
+    "Vector7<string>": {
+      "items": {
+        "type": "string"
+      },
+      "maxItems": 7,
+      "minItems": 7,
+      "type": "array"
+    },
+    "ViewBackground": {
+      "additionalProperties": false,
+      "properties": {
+        "cornerRadius": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles or arcs' corners.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cursor": {
+          "$ref": "#/definitions/Cursor",
+          "description": "The mouse cursor used over the view. Any valid [CSS cursor type](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values) can be used."
+        },
+        "fill": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The fill color.\n\n__Default value:__ `undefined`"
+        },
+        "fillOpacity": {
+          "anyOf": [
+            {
+              "description": "The fill opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "opacity": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The overall opacity (value between [0,1]).\n\n__Default value:__ `0.7` for non-aggregate plots with `point`, `tick`, `circle`, or `square` marks or layered `bar` charts and `1` otherwise.",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "stroke": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The stroke color.\n\n__Default value:__ `\"#ddd\"`"
+        },
+        "strokeCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for line ending style. One of `\"butt\"`, `\"round\"`, or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating stroke, space lengths for creating dashed or dotted lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDashOffset": {
+          "anyOf": [
+            {
+              "description": "The offset (in pixels) into which to begin drawing with the stroke dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeJoin": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeJoin",
+              "description": "The stroke line join method. One of `\"miter\"`, `\"round\"` or `\"bevel\"`.\n\n__Default value:__ `\"miter\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeMiterLimit": {
+          "anyOf": [
+            {
+              "description": "The miter limit at which to bevel a line join.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOpacity": {
+          "anyOf": [
+            {
+              "description": "The stroke opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeWidth": {
+          "anyOf": [
+            {
+              "description": "The stroke width, in pixels.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "style": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            }
+          ],
+          "description": "A string or array of strings indicating the name of custom styles to apply to the view background. A style is a named collection of mark property defaults defined within the [style configuration](https://vega.github.io/vega-lite/docs/mark.html#style-config). If style is an array, later styles will override earlier styles.\n\n__Default value:__ `\"cell\"` __Note:__ Any specified view background properties will augment the default style."
+        }
+      },
+      "type": "object"
+    },
+    "ViewConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "clip": {
+          "description": "Whether the view should be clipped.",
+          "type": "boolean"
+        },
+        "continuousHeight": {
+          "description": "The default height when the plot has a continuous y-field for x or latitude, or has arc marks.\n\n__Default value:__ `200`",
+          "type": "number"
+        },
+        "continuousWidth": {
+          "description": "The default width when the plot has a continuous field for x or longitude, or has arc marks.\n\n__Default value:__ `200`",
+          "type": "number"
+        },
+        "cornerRadius": {
+          "anyOf": [
+            {
+              "description": "The radius in pixels of rounded rectangles or arcs' corners.\n\n__Default value:__ `0`",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "cursor": {
+          "$ref": "#/definitions/Cursor",
+          "description": "The mouse cursor used over the view. Any valid [CSS cursor type](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor#Values) can be used."
+        },
+        "discreteHeight": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "step": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "step"
+              ],
+              "type": "object"
+            }
+          ],
+          "description": "The default height when the plot has non arc marks and either a discrete y-field or no y-field. The height can be either a number indicating a fixed height or an object in the form of `{step: number}` defining the height per discrete step.\n\n__Default value:__ a step size based on `config.view.step`."
+        },
+        "discreteWidth": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "step": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "step"
+              ],
+              "type": "object"
+            }
+          ],
+          "description": "The default width when the plot has non-arc marks and either a discrete x-field or no x-field. The width can be either a number indicating a fixed width or an object in the form of `{step: number}` defining the width per discrete step.\n\n__Default value:__ a step size based on `config.view.step`."
+        },
+        "fill": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The fill color.\n\n__Default value:__ `undefined`"
+        },
+        "fillOpacity": {
+          "anyOf": [
+            {
+              "description": "The fill opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "opacity": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The overall opacity (value between [0,1]).\n\n__Default value:__ `0.7` for non-aggregate plots with `point`, `tick`, `circle`, or `square` marks or layered `bar` charts and `1` otherwise.",
+          "maximum": 1,
+          "minimum": 0
+        },
+        "step": {
+          "description": "Default step size for x-/y- discrete fields.",
+          "type": "number"
+        },
+        "stroke": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Color"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "The stroke color.\n\n__Default value:__ `\"#ddd\"`"
+        },
+        "strokeCap": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeCap",
+              "description": "The stroke cap for line ending style. One of `\"butt\"`, `\"round\"`, or `\"square\"`.\n\n__Default value:__ `\"butt\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDash": {
+          "anyOf": [
+            {
+              "description": "An array of alternating stroke, space lengths for creating dashed or dotted lines.",
+              "items": {
+                "type": "number"
+              },
+              "type": "array"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeDashOffset": {
+          "anyOf": [
+            {
+              "description": "The offset (in pixels) into which to begin drawing with the stroke dash array.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeJoin": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/StrokeJoin",
+              "description": "The stroke line join method. One of `\"miter\"`, `\"round\"` or `\"bevel\"`.\n\n__Default value:__ `\"miter\"`"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeMiterLimit": {
+          "anyOf": [
+            {
+              "description": "The miter limit at which to bevel a line join.",
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeOpacity": {
+          "anyOf": [
+            {
+              "description": "The stroke opacity (value between [0,1]).\n\n__Default value:__ `1`",
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        },
+        "strokeWidth": {
+          "anyOf": [
+            {
+              "description": "The stroke width, in pixels.",
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "WindowEventType": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/EventType"
+        },
+        {
+          "type": "string"
+        }
+      ]
+    },
+    "WindowFieldDef": {
+      "additionalProperties": false,
+      "properties": {
+        "as": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The output name for the window operation."
+        },
+        "field": {
+          "$ref": "#/definitions/FieldName",
+          "description": "The data field for which to compute the aggregate or window function. This can be omitted for window functions that do not operate over a field such as `\"count\"`, `\"rank\"`, `\"dense_rank\"`."
+        },
+        "op": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/AggregateOp"
+            },
+            {
+              "$ref": "#/definitions/WindowOnlyOp"
+            }
+          ],
+          "description": "The window or aggregation operation to apply within a window (e.g., `\"rank\"`, `\"lead\"`, `\"sum\"`, `\"average\"` or `\"count\"`). See the list of all supported operations [here](https://vega.github.io/vega-lite/docs/window.html#ops)."
+        },
+        "param": {
+          "description": "Parameter values for the window functions. Parameter values can be omitted for operations that do not accept a parameter.\n\nSee the list of all supported operations and their parameters [here](https://vega.github.io/vega-lite/docs/transforms/window.html).",
+          "type": "number"
+        }
+      },
+      "required": [
+        "op",
+        "as"
+      ],
+      "type": "object"
+    },
+    "WindowOnlyOp": {
+      "enum": [
+        "row_number",
+        "rank",
+        "dense_rank",
+        "percent_rank",
+        "cume_dist",
+        "ntile",
+        "lag",
+        "lead",
+        "first_value",
+        "last_value",
+        "nth_value"
+      ],
+      "type": "string"
+    },
+    "WindowTransform": {
+      "additionalProperties": false,
+      "properties": {
+        "frame": {
+          "description": "A frame specification as a two-element array indicating how the sliding window should proceed. The array entries should either be a number indicating the offset from the current data object, or null to indicate unbounded rows preceding or following the current data object. The default value is `[null, 0]`, indicating that the sliding window includes the current object and all preceding objects. The value `[-5, 5]` indicates that the window should include five objects preceding and five objects following the current object. Finally, `[null, null]` indicates that the window frame should always include all data objects. If you this frame and want to assign the same value to add objects, you can use the simpler [join aggregate transform](https://vega.github.io/vega-lite/docs/joinaggregate.html). The only operators affected are the aggregation operations and the `first_value`, `last_value`, and `nth_value` window operations. The other window operations are not affected by this.\n\n__Default value:__:  `[null, 0]` (includes the current object and all preceding objects)",
+          "items": {
+            "type": [
+              "null",
+              "number"
+            ]
+          },
+          "type": "array"
+        },
+        "groupby": {
+          "description": "The data fields for partitioning the data objects into separate windows. If unspecified, all data points will be in a single window.",
+          "items": {
+            "$ref": "#/definitions/FieldName"
+          },
+          "type": "array"
+        },
+        "ignorePeers": {
+          "description": "Indicates if the sliding window frame should ignore peer values (data that are considered identical by the sort criteria). The default is false, causing the window frame to expand to include all peer values. If set to true, the window frame will be defined by offset values only. This setting only affects those operations that depend on the window frame, namely aggregation operations and the first_value, last_value, and nth_value window operations.\n\n__Default value:__ `false`",
+          "type": "boolean"
+        },
+        "sort": {
+          "description": "A sort field definition for sorting data objects within a window. If two data objects are considered equal by the comparator, they are considered \"peer\" values of equal rank. If sort is not specified, the order is undefined: data objects are processed in the order they are observed and none are considered peers (the ignorePeers parameter is ignored and treated as if set to `true`).",
+          "items": {
+            "$ref": "#/definitions/SortField"
+          },
+          "type": "array"
+        },
+        "window": {
+          "description": "The definition of the fields in the window, and what calculations to use.",
+          "items": {
+            "$ref": "#/definitions/WindowFieldDef"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "window"
+      ],
+      "type": "object"
+    }
+  }
+}
diff --git a/llm/Lib/site-packages/altair/vegalite/v5/theme.py b/llm/Lib/site-packages/altair/vegalite/v5/theme.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf99ad63878cb01663c66601ff83530646ff26d4
--- /dev/null
+++ b/llm/Lib/site-packages/altair/vegalite/v5/theme.py
@@ -0,0 +1,61 @@
+"""Tools for enabling and registering chart themes"""
+
+from typing import Dict, Union, Final
+
+from ...utils.theme import ThemeRegistry
+
+VEGA_THEMES = [
+    "ggplot2",
+    "quartz",
+    "vox",
+    "fivethirtyeight",
+    "dark",
+    "latimes",
+    "urbaninstitute",
+    "excel",
+    "googlecharts",
+    "powerbi",
+]
+
+
+class VegaTheme:
+    """Implementation of a builtin vega theme."""
+
+    def __init__(self, theme: str) -> None:
+        self.theme = theme
+
+    def __call__(self) -> Dict[str, Dict[str, Dict[str, Union[str, int]]]]:
+        return {
+            "usermeta": {"embedOptions": {"theme": self.theme}},
+            "config": {"view": {"continuousWidth": 300, "continuousHeight": 300}},
+        }
+
+    def __repr__(self) -> str:
+        return "VegaTheme({!r})".format(self.theme)
+
+
+# The entry point group that can be used by other packages to declare other
+# themes that will be auto-detected. Explicit registration is also
+# allowed by the PluginRegistery API.
+ENTRY_POINT_GROUP: Final = "altair.vegalite.v5.theme"
+themes = ThemeRegistry(entry_point_group=ENTRY_POINT_GROUP)
+
+themes.register(
+    "default",
+    lambda: {"config": {"view": {"continuousWidth": 300, "continuousHeight": 300}}},
+)
+themes.register(
+    "opaque",
+    lambda: {
+        "config": {
+            "background": "white",
+            "view": {"continuousWidth": 300, "continuousHeight": 300},
+        }
+    },
+)
+themes.register("none", lambda: {})
+
+for theme in VEGA_THEMES:
+    themes.register(theme, VegaTheme(theme))
+
+themes.enable("default")
diff --git a/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/INSTALLER b/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/METADATA b/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..36ec9b0d6ce27ed5511a80cf0fa4b25c91dae522
--- /dev/null
+++ b/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/METADATA
@@ -0,0 +1,242 @@
+Metadata-Version: 2.1
+Name: annotated-types
+Version: 0.6.0
+Summary: Reusable constraint types to use with typing.Annotated
+Author-email: Samuel Colvin <s@muelcolvin.com>, Adrian Garcia Badaracco <1755071+adriangb@users.noreply.github.com>, Zac Hatfield-Dodds <zac@zhd.dev>
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: MacOS X
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Unix
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Requires-Dist: typing-extensions>=4.0.0; python_version < '3.9'
+Description-Content-Type: text/markdown
+
+# annotated-types
+
+[![CI](https://github.com/annotated-types/annotated-types/workflows/CI/badge.svg?event=push)](https://github.com/annotated-types/annotated-types/actions?query=event%3Apush+branch%3Amain+workflow%3ACI)
+[![pypi](https://img.shields.io/pypi/v/annotated-types.svg)](https://pypi.python.org/pypi/annotated-types)
+[![versions](https://img.shields.io/pypi/pyversions/annotated-types.svg)](https://github.com/annotated-types/annotated-types)
+[![license](https://img.shields.io/github/license/annotated-types/annotated-types.svg)](https://github.com/annotated-types/annotated-types/blob/main/LICENSE)
+
+[PEP-593](https://peps.python.org/pep-0593/) added `typing.Annotated` as a way of
+adding context-specific metadata to existing types, and specifies that
+`Annotated[T, x]` _should_ be treated as `T` by any tool or library without special
+logic for `x`.
+
+This package provides metadata objects which can be used to represent common
+constraints such as upper and lower bounds on scalar values and collection sizes,
+a `Predicate` marker for runtime checks, and
+descriptions of how we intend these metadata to be interpreted. In some cases,
+we also note alternative representations which do not require this package.
+
+## Install
+
+```bash
+pip install annotated-types
+```
+
+## Examples
+
+```python
+from typing import Annotated
+from annotated_types import Gt, Len, Predicate
+
+class MyClass:
+    age: Annotated[int, Gt(18)]                         # Valid: 19, 20, ...
+                                                        # Invalid: 17, 18, "19", 19.0, ...
+    factors: list[Annotated[int, Predicate(is_prime)]]  # Valid: 2, 3, 5, 7, 11, ...
+                                                        # Invalid: 4, 8, -2, 5.0, "prime", ...
+
+    my_list: Annotated[list[int], Len(0, 10)]           # Valid: [], [10, 20, 30, 40, 50]
+                                                        # Invalid: (1, 2), ["abc"], [0] * 20
+```
+
+## Documentation
+
+_While `annotated-types` avoids runtime checks for performance, users should not
+construct invalid combinations such as `MultipleOf("non-numeric")` or `Annotated[int, Len(3)]`.
+Downstream implementors may choose to raise an error, emit a warning, silently ignore
+a metadata item, etc., if the metadata objects described below are used with an
+incompatible type - or for any other reason!_
+
+### Gt, Ge, Lt, Le
+
+Express inclusive and/or exclusive bounds on orderable values - which may be numbers,
+dates, times, strings, sets, etc. Note that the boundary value need not be of the
+same type that was annotated, so long as they can be compared: `Annotated[int, Gt(1.5)]`
+is fine, for example, and implies that the value is an integer x such that `x > 1.5`.
+
+We suggest that implementors may also interpret `functools.partial(operator.le, 1.5)`
+as being equivalent to `Gt(1.5)`, for users who wish to avoid a runtime dependency on
+the `annotated-types` package.
+
+To be explicit, these types have the following meanings:
+
+* `Gt(x)` - value must be "Greater Than" `x` - equivalent to exclusive minimum
+* `Ge(x)` - value must be "Greater than or Equal" to `x` - equivalent to inclusive minimum
+* `Lt(x)` - value must be "Less Than" `x` - equivalent to exclusive maximum
+* `Le(x)` - value must be "Less than or Equal" to `x` - equivalent to inclusive maximum
+
+### Interval
+
+`Interval(gt, ge, lt, le)` allows you to specify an upper and lower bound with a single
+metadata object. `None` attributes should be ignored, and non-`None` attributes
+treated as per the single bounds above.
+
+### MultipleOf
+
+`MultipleOf(multiple_of=x)` might be interpreted in two ways:
+
+1. Python semantics, implying `value % multiple_of == 0`, or
+2. [JSONschema semantics](https://json-schema.org/draft/2020-12/json-schema-validation.html#rfc.section.6.2.1),
+   where `int(value / multiple_of) == value / multiple_of`.
+
+We encourage users to be aware of these two common interpretations and their
+distinct behaviours, especially since very large or non-integer numbers make
+it easy to cause silent data corruption due to floating-point imprecision.
+
+We encourage libraries to carefully document which interpretation they implement.
+
+### MinLen, MaxLen, Len
+
+`Len()` implies that `min_length <= len(value) <= max_length` - lower and upper bounds are inclusive.
+
+As well as `Len()` which can optionally include upper and lower bounds, we also
+provide `MinLen(x)` and `MaxLen(y)` which are equivalent to `Len(min_length=x)`
+and `Len(max_length=y)` respectively.
+
+`Len`, `MinLen`, and `MaxLen` may be used with any type which supports `len(value)`.
+
+Examples of usage:
+
+* `Annotated[list, MaxLen(10)]` (or `Annotated[list, Len(max_length=10))`) - list must have a length of 10 or less
+* `Annotated[str, MaxLen(10)]` - string must have a length of 10 or less
+* `Annotated[list, MinLen(3))` (or `Annotated[list, Len(min_length=3))`) - list must have a length of 3 or more
+* `Annotated[list, Len(4, 6)]` - list must have a length of 4, 5, or 6
+* `Annotated[list, Len(8, 8)]` - list must have a length of exactly 8
+
+#### Changed in v0.4.0
+
+* `min_inclusive` has been renamed to `min_length`, no change in meaning
+* `max_exclusive` has been renamed to `max_length`, upper bound is now **inclusive** instead of **exclusive**
+* The recommendation that slices are interpreted as `Len` has been removed due to ambiguity and different semantic
+  meaning of the upper bound in slices vs. `Len`
+
+See [issue #23](https://github.com/annotated-types/annotated-types/issues/23) for discussion.
+
+### Timezone
+
+`Timezone` can be used with a `datetime` or a `time` to express which timezones
+are allowed. `Annotated[datetime, Timezone(None)]` must be a naive datetime.
+`Timezone[...]` ([literal ellipsis](https://docs.python.org/3/library/constants.html#Ellipsis))
+expresses that any timezone-aware datetime is allowed. You may also pass a specific
+timezone string or `timezone` object such as `Timezone(timezone.utc)` or
+`Timezone("Africa/Abidjan")` to express that you only allow a specific timezone,
+though we note that this is often a symptom of fragile design.
+
+### Predicate
+
+`Predicate(func: Callable)` expresses that `func(value)` is truthy for valid values.
+Users should prefer the statically inspectable metadata above, but if you need
+the full power and flexibility of arbitrary runtime predicates... here it is.
+
+We provide a few predefined predicates for common string constraints:
+
+* `IsLower = Predicate(str.islower)`
+* `IsUpper = Predicate(str.isupper)`
+* `IsDigit = Predicate(str.isdigit)`
+* `IsFinite = Predicate(math.isfinite)`
+* `IsNotFinite = Predicate(Not(math.isfinite))`
+* `IsNan = Predicate(math.isnan)`
+* `IsNotNan = Predicate(Not(math.isnan))`
+* `IsInfinite = Predicate(math.isinf)`
+* `IsNotInfinite = Predicate(Not(math.isinf))`
+
+Some libraries might have special logic to handle known or understandable predicates,
+for example by checking for `str.isdigit` and using its presence to both call custom
+logic to enforce digit-only strings, and customise some generated external schema.
+Users are therefore encouraged to avoid indirection like `lambda s: s.lower()`, in
+favor of introspectable methods such as `str.lower` or `re.compile("pattern").search`.
+
+To enable basic negation of commonly used predicates like `math.isnan` without introducing introspection that makes it impossible for implementers to introspect the predicate we provide a `Not` wrapper that simply negates the predicate in an introspectable manner. Several of the predicates listed above are created in this manner.
+
+We do not specify what behaviour should be expected for predicates that raise
+an exception.  For example `Annotated[int, Predicate(str.isdigit)]` might silently
+skip invalid constraints, or statically raise an error; or it might try calling it
+and then propogate or discard the resulting
+`TypeError: descriptor 'isdigit' for 'str' objects doesn't apply to a 'int' object`
+exception.  We encourage libraries to document the behaviour they choose.
+
+### Doc
+
+`doc()` can be used to add documentation information in `Annotated`, for function and method parameters, variables, class attributes, return types, and any place where `Annotated` can be used.
+
+It expects a value that can be statically analyzed, as the main use case is for static analysis, editors, documentation generators, and similar tools.
+
+It returns a `DocInfo` class with a single attribute `documentation` containing the value passed to `doc()`.
+
+This is the early adopter's alternative form of the [`typing-doc` proposal](https://github.com/tiangolo/fastapi/blob/typing-doc/typing_doc.md).
+
+### Integrating downstream types with `GroupedMetadata`
+
+Implementers may choose to provide a convenience wrapper that groups multiple pieces of metadata.
+This can help reduce verbosity and cognitive overhead for users.
+For example, an implementer like Pydantic might provide a `Field` or `Meta` type that accepts keyword arguments and transforms these into low-level metadata:
+
+```python
+from dataclasses import dataclass
+from typing import Iterator
+from annotated_types import GroupedMetadata, Ge
+
+@dataclass
+class Field(GroupedMetadata):
+    ge: int | None = None
+    description: str | None = None
+
+    def __iter__(self) -> Iterator[object]:
+        # Iterating over a GroupedMetadata object should yield annotated-types
+        # constraint metadata objects which describe it as fully as possible,
+        # and may include other unknown objects too.
+        if self.ge is not None:
+            yield Ge(self.ge)
+        if self.description is not None:
+            yield Description(self.description)
+```
+
+Libraries consuming annotated-types constraints should check for `GroupedMetadata` and unpack it by iterating over the object and treating the results as if they had been "unpacked" in the `Annotated` type.  The same logic should be applied to the [PEP 646 `Unpack` type](https://peps.python.org/pep-0646/), so that `Annotated[T, Field(...)]`, `Annotated[T, Unpack[Field(...)]]` and `Annotated[T, *Field(...)]` are all treated consistently.
+
+Libraries consuming annotated-types should also ignore any metadata they do not recongize that came from unpacking a `GroupedMetadata`, just like they ignore unrecognized metadata in `Annotated` itself.
+
+Our own `annotated_types.Interval` class is a `GroupedMetadata` which unpacks itself into `Gt`, `Lt`, etc., so this is not an abstract concern.  Similarly, `annotated_types.Len` is a `GroupedMetadata` which unpacks itself into `MinLen` (optionally) and `MaxLen`.
+
+### Consuming metadata
+
+We intend to not be prescriptive as to _how_ the metadata and constraints are used, but as an example of how one might parse constraints from types annotations see our [implementation in `test_main.py`](https://github.com/annotated-types/annotated-types/blob/f59cf6d1b5255a0fe359b93896759a180bec30ae/tests/test_main.py#L94-L103).
+
+It is up to the implementer to determine how this metadata is used.
+You could use the metadata for runtime type checking, for generating schemas or to generate example data, amongst other use cases.
+
+## Design & History
+
+This package was designed at the PyCon 2022 sprints by the maintainers of Pydantic
+and Hypothesis, with the goal of making it as easy as possible for end-users to
+provide more informative annotations for use by runtime libraries.
+
+It is deliberately minimal, and following PEP-593 allows considerable downstream
+discretion in what (if anything!) they choose to support. Nonetheless, we expect
+that staying simple and covering _only_ the most common use-cases will give users
+and maintainers the best experience we can. If you'd like more constraints for your
+types - follow our lead, by defining them and documenting them downstream!
diff --git a/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/RECORD b/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..6cce972464517a4fe3e601a2cc13e4900a537b63
--- /dev/null
+++ b/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/RECORD
@@ -0,0 +1,10 @@
+annotated_types-0.6.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+annotated_types-0.6.0.dist-info/METADATA,sha256=78YeruT3b_doh8TbsK7qcbqY4cvCMz_QQRCGUbyAo6M,12879
+annotated_types-0.6.0.dist-info/RECORD,,
+annotated_types-0.6.0.dist-info/WHEEL,sha256=9QBuHhg6FNW7lppboF2vKVbCGTVzsFykgRQjjlajrhA,87
+annotated_types-0.6.0.dist-info/licenses/LICENSE,sha256=_hBJiEsaDZNCkB6I4H8ykl0ksxIdmXK2poBfuYJLCV0,1083
+annotated_types/__init__.py,sha256=txLoRt8iSiAc-Su37esWpMI0wFjN92V7gE5HdFIeeKI,12151
+annotated_types/__pycache__/__init__.cpython-311.pyc,,
+annotated_types/__pycache__/test_cases.cpython-311.pyc,,
+annotated_types/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+annotated_types/test_cases.py,sha256=LfFyURZwr7X3NVfoCrSXSMMxTxJD4o8Xz-Y8qbmY7JU,6327
diff --git a/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/WHEEL b/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ba1a8af28bcccdacebb8c22dfda1537447a1a58a
--- /dev/null
+++ b/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.18.0
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/licenses/LICENSE b/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/licenses/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..d99323a9965f146d5b0888c4ca1bf0727e12b04f
--- /dev/null
+++ b/llm/Lib/site-packages/annotated_types-0.6.0.dist-info/licenses/LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 the contributors
+
+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
+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.
diff --git a/llm/Lib/site-packages/annotated_types/__init__.py b/llm/Lib/site-packages/annotated_types/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f989504caa131c634ab51bcea435f3196a546bf
--- /dev/null
+++ b/llm/Lib/site-packages/annotated_types/__init__.py
@@ -0,0 +1,396 @@
+import math
+import sys
+from dataclasses import dataclass
+from datetime import timezone
+from typing import TYPE_CHECKING, Any, Callable, Iterator, Optional, SupportsFloat, SupportsIndex, TypeVar, Union
+
+if sys.version_info < (3, 8):
+    from typing_extensions import Protocol, runtime_checkable
+else:
+    from typing import Protocol, runtime_checkable
+
+if sys.version_info < (3, 9):
+    from typing_extensions import Annotated, Literal
+else:
+    from typing import Annotated, Literal
+
+if sys.version_info < (3, 10):
+    EllipsisType = type(Ellipsis)
+    KW_ONLY = {}
+    SLOTS = {}
+else:
+    from types import EllipsisType
+
+    KW_ONLY = {"kw_only": True}
+    SLOTS = {"slots": True}
+
+
+__all__ = (
+    'BaseMetadata',
+    'GroupedMetadata',
+    'Gt',
+    'Ge',
+    'Lt',
+    'Le',
+    'Interval',
+    'MultipleOf',
+    'MinLen',
+    'MaxLen',
+    'Len',
+    'Timezone',
+    'Predicate',
+    'LowerCase',
+    'UpperCase',
+    'IsDigits',
+    'IsFinite',
+    'IsNotFinite',
+    'IsNan',
+    'IsNotNan',
+    'IsInfinite',
+    'IsNotInfinite',
+    'doc',
+    'DocInfo',
+    '__version__',
+)
+
+__version__ = '0.6.0'
+
+
+T = TypeVar('T')
+
+
+# arguments that start with __ are considered
+# positional only
+# see https://peps.python.org/pep-0484/#positional-only-arguments
+
+
+class SupportsGt(Protocol):
+    def __gt__(self: T, __other: T) -> bool:
+        ...
+
+
+class SupportsGe(Protocol):
+    def __ge__(self: T, __other: T) -> bool:
+        ...
+
+
+class SupportsLt(Protocol):
+    def __lt__(self: T, __other: T) -> bool:
+        ...
+
+
+class SupportsLe(Protocol):
+    def __le__(self: T, __other: T) -> bool:
+        ...
+
+
+class SupportsMod(Protocol):
+    def __mod__(self: T, __other: T) -> T:
+        ...
+
+
+class SupportsDiv(Protocol):
+    def __div__(self: T, __other: T) -> T:
+        ...
+
+
+class BaseMetadata:
+    """Base class for all metadata.
+
+    This exists mainly so that implementers
+    can do `isinstance(..., BaseMetadata)` while traversing field annotations.
+    """
+
+    __slots__ = ()
+
+
+@dataclass(frozen=True, **SLOTS)
+class Gt(BaseMetadata):
+    """Gt(gt=x) implies that the value must be greater than x.
+
+    It can be used with any type that supports the ``>`` operator,
+    including numbers, dates and times, strings, sets, and so on.
+    """
+
+    gt: SupportsGt
+
+
+@dataclass(frozen=True, **SLOTS)
+class Ge(BaseMetadata):
+    """Ge(ge=x) implies that the value must be greater than or equal to x.
+
+    It can be used with any type that supports the ``>=`` operator,
+    including numbers, dates and times, strings, sets, and so on.
+    """
+
+    ge: SupportsGe
+
+
+@dataclass(frozen=True, **SLOTS)
+class Lt(BaseMetadata):
+    """Lt(lt=x) implies that the value must be less than x.
+
+    It can be used with any type that supports the ``<`` operator,
+    including numbers, dates and times, strings, sets, and so on.
+    """
+
+    lt: SupportsLt
+
+
+@dataclass(frozen=True, **SLOTS)
+class Le(BaseMetadata):
+    """Le(le=x) implies that the value must be less than or equal to x.
+
+    It can be used with any type that supports the ``<=`` operator,
+    including numbers, dates and times, strings, sets, and so on.
+    """
+
+    le: SupportsLe
+
+
+@runtime_checkable
+class GroupedMetadata(Protocol):
+    """A grouping of multiple BaseMetadata objects.
+
+    `GroupedMetadata` on its own is not metadata and has no meaning.
+    All it the the constraint and metadata should be fully expressable
+    in terms of the `BaseMetadata`'s returned by `GroupedMetadata.__iter__()`.
+
+    Concrete implementations should override `GroupedMetadata.__iter__()`
+    to add their own metadata.
+    For example:
+
+    >>> @dataclass
+    >>> class Field(GroupedMetadata):
+    >>>     gt: float | None = None
+    >>>     description: str | None = None
+    ...
+    >>>     def __iter__(self) -> Iterable[BaseMetadata]:
+    >>>         if self.gt is not None:
+    >>>             yield Gt(self.gt)
+    >>>         if self.description is not None:
+    >>>             yield Description(self.gt)
+
+    Also see the implementation of `Interval` below for an example.
+
+    Parsers should recognize this and unpack it so that it can be used
+    both with and without unpacking:
+
+    - `Annotated[int, Field(...)]` (parser must unpack Field)
+    - `Annotated[int, *Field(...)]` (PEP-646)
+    """  # noqa: trailing-whitespace
+
+    @property
+    def __is_annotated_types_grouped_metadata__(self) -> Literal[True]:
+        return True
+
+    def __iter__(self) -> Iterator[BaseMetadata]:
+        ...
+
+    if not TYPE_CHECKING:
+        __slots__ = ()  # allow subclasses to use slots
+
+        def __init_subclass__(cls, *args: Any, **kwargs: Any) -> None:
+            # Basic ABC like functionality without the complexity of an ABC
+            super().__init_subclass__(*args, **kwargs)
+            if cls.__iter__ is GroupedMetadata.__iter__:
+                raise TypeError("Can't subclass GroupedMetadata without implementing __iter__")
+
+        def __iter__(self) -> Iterator[BaseMetadata]:  # noqa: F811
+            raise NotImplementedError  # more helpful than "None has no attribute..." type errors
+
+
+@dataclass(frozen=True, **KW_ONLY, **SLOTS)
+class Interval(GroupedMetadata):
+    """Interval can express inclusive or exclusive bounds with a single object.
+
+    It accepts keyword arguments ``gt``, ``ge``, ``lt``, and/or ``le``, which
+    are interpreted the same way as the single-bound constraints.
+    """
+
+    gt: Union[SupportsGt, None] = None
+    ge: Union[SupportsGe, None] = None
+    lt: Union[SupportsLt, None] = None
+    le: Union[SupportsLe, None] = None
+
+    def __iter__(self) -> Iterator[BaseMetadata]:
+        """Unpack an Interval into zero or more single-bounds."""
+        if self.gt is not None:
+            yield Gt(self.gt)
+        if self.ge is not None:
+            yield Ge(self.ge)
+        if self.lt is not None:
+            yield Lt(self.lt)
+        if self.le is not None:
+            yield Le(self.le)
+
+
+@dataclass(frozen=True, **SLOTS)
+class MultipleOf(BaseMetadata):
+    """MultipleOf(multiple_of=x) might be interpreted in two ways:
+
+    1. Python semantics, implying ``value % multiple_of == 0``, or
+    2. JSONschema semantics, where ``int(value / multiple_of) == value / multiple_of``
+
+    We encourage users to be aware of these two common interpretations,
+    and libraries to carefully document which they implement.
+    """
+
+    multiple_of: Union[SupportsDiv, SupportsMod]
+
+
+@dataclass(frozen=True, **SLOTS)
+class MinLen(BaseMetadata):
+    """
+    MinLen() implies minimum inclusive length,
+    e.g. ``len(value) >= min_length``.
+    """
+
+    min_length: Annotated[int, Ge(0)]
+
+
+@dataclass(frozen=True, **SLOTS)
+class MaxLen(BaseMetadata):
+    """
+    MaxLen() implies maximum inclusive length,
+    e.g. ``len(value) <= max_length``.
+    """
+
+    max_length: Annotated[int, Ge(0)]
+
+
+@dataclass(frozen=True, **SLOTS)
+class Len(GroupedMetadata):
+    """
+    Len() implies that ``min_length <= len(value) <= max_length``.
+
+    Upper bound may be omitted or ``None`` to indicate no upper length bound.
+    """
+
+    min_length: Annotated[int, Ge(0)] = 0
+    max_length: Optional[Annotated[int, Ge(0)]] = None
+
+    def __iter__(self) -> Iterator[BaseMetadata]:
+        """Unpack a Len into zone or more single-bounds."""
+        if self.min_length > 0:
+            yield MinLen(self.min_length)
+        if self.max_length is not None:
+            yield MaxLen(self.max_length)
+
+
+@dataclass(frozen=True, **SLOTS)
+class Timezone(BaseMetadata):
+    """Timezone(tz=...) requires a datetime to be aware (or ``tz=None``, naive).
+
+    ``Annotated[datetime, Timezone(None)]`` must be a naive datetime.
+    ``Timezone[...]`` (the ellipsis literal) expresses that the datetime must be
+    tz-aware but any timezone is allowed.
+
+    You may also pass a specific timezone string or timezone object such as
+    ``Timezone(timezone.utc)`` or ``Timezone("Africa/Abidjan")`` to express that
+    you only allow a specific timezone, though we note that this is often
+    a symptom of poor design.
+    """
+
+    tz: Union[str, timezone, EllipsisType, None]
+
+
+@dataclass(frozen=True, **SLOTS)
+class Predicate(BaseMetadata):
+    """``Predicate(func: Callable)`` implies `func(value)` is truthy for valid values.
+
+    Users should prefer statically inspectable metadata, but if you need the full
+    power and flexibility of arbitrary runtime predicates... here it is.
+
+    We provide a few predefined predicates for common string constraints:
+    ``IsLower = Predicate(str.islower)``, ``IsUpper = Predicate(str.isupper)``, and
+    ``IsDigit = Predicate(str.isdigit)``. Users are encouraged to use methods which
+    can be given special handling, and avoid indirection like ``lambda s: s.lower()``.
+
+    Some libraries might have special logic to handle certain predicates, e.g. by
+    checking for `str.isdigit` and using its presence to both call custom logic to
+    enforce digit-only strings, and customise some generated external schema.
+
+    We do not specify what behaviour should be expected for predicates that raise
+    an exception.  For example `Annotated[int, Predicate(str.isdigit)]` might silently
+    skip invalid constraints, or statically raise an error; or it might try calling it
+    and then propogate or discard the resulting exception.
+    """
+
+    func: Callable[[Any], bool]
+
+
+@dataclass
+class Not:
+    func: Callable[[Any], bool]
+
+    def __call__(self, __v: Any) -> bool:
+        return not self.func(__v)
+
+
+_StrType = TypeVar("_StrType", bound=str)
+
+LowerCase = Annotated[_StrType, Predicate(str.islower)]
+"""
+Return True if the string is a lowercase string, False otherwise.
+
+A string is lowercase if all cased characters in the string are lowercase and there is at least one cased character in the string.
+"""  # noqa: E501
+UpperCase = Annotated[_StrType, Predicate(str.isupper)]
+"""
+Return True if the string is an uppercase string, False otherwise.
+
+A string is uppercase if all cased characters in the string are uppercase and there is at least one cased character in the string.
+"""  # noqa: E501
+IsDigits = Annotated[_StrType, Predicate(str.isdigit)]
+"""
+Return True if the string is a digit string, False otherwise.
+
+A string is a digit string if all characters in the string are digits and there is at least one character in the string.
+"""  # noqa: E501
+IsAscii = Annotated[_StrType, Predicate(str.isascii)]
+"""
+Return True if all characters in the string are ASCII, False otherwise.
+
+ASCII characters have code points in the range U+0000-U+007F. Empty string is ASCII too.
+"""
+
+_NumericType = TypeVar('_NumericType', bound=Union[SupportsFloat, SupportsIndex])
+IsFinite = Annotated[_NumericType, Predicate(math.isfinite)]
+"""Return True if x is neither an infinity nor a NaN, and False otherwise."""
+IsNotFinite = Annotated[_NumericType, Predicate(Not(math.isfinite))]
+"""Return True if x is one of infinity or NaN, and False otherwise"""
+IsNan = Annotated[_NumericType, Predicate(math.isnan)]
+"""Return True if x is a NaN (not a number), and False otherwise."""
+IsNotNan = Annotated[_NumericType, Predicate(Not(math.isnan))]
+"""Return True if x is anything but NaN (not a number), and False otherwise."""
+IsInfinite = Annotated[_NumericType, Predicate(math.isinf)]
+"""Return True if x is a positive or negative infinity, and False otherwise."""
+IsNotInfinite = Annotated[_NumericType, Predicate(Not(math.isinf))]
+"""Return True if x is neither a positive or negative infinity, and False otherwise."""
+
+try:
+    from typing_extensions import DocInfo, doc  # type: ignore [attr-defined]
+except ImportError:
+
+    @dataclass(frozen=True, **SLOTS)
+    class DocInfo:  # type: ignore [no-redef]
+        """ "
+        The return value of doc(), mainly to be used by tools that want to extract the
+        Annotated documentation at runtime.
+        """
+
+        documentation: str
+        """The documentation string passed to doc()."""
+
+    def doc(
+        documentation: str,
+    ) -> DocInfo:
+        """
+        Add documentation to a type annotation inside of Annotated.
+
+        For example:
+
+        >>> def hi(name: Annotated[int, doc("The name of the user")]) -> None: ...
+        """
+        return DocInfo(documentation)
diff --git a/llm/Lib/site-packages/annotated_types/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/annotated_types/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9fbf86860a4ec80180adde7ed99de54f2db67909
Binary files /dev/null and b/llm/Lib/site-packages/annotated_types/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/annotated_types/__pycache__/test_cases.cpython-311.pyc b/llm/Lib/site-packages/annotated_types/__pycache__/test_cases.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..127e3671366db06d7058402d77736ab2177d38da
Binary files /dev/null and b/llm/Lib/site-packages/annotated_types/__pycache__/test_cases.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/annotated_types/py.typed b/llm/Lib/site-packages/annotated_types/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/annotated_types/test_cases.py b/llm/Lib/site-packages/annotated_types/test_cases.py
new file mode 100644
index 0000000000000000000000000000000000000000..f54df700283bb31f60106443af0e54c8cfbdb834
--- /dev/null
+++ b/llm/Lib/site-packages/annotated_types/test_cases.py
@@ -0,0 +1,147 @@
+import math
+import sys
+from datetime import date, datetime, timedelta, timezone
+from decimal import Decimal
+from typing import Any, Dict, Iterable, Iterator, List, NamedTuple, Set, Tuple
+
+if sys.version_info < (3, 9):
+    from typing_extensions import Annotated
+else:
+    from typing import Annotated
+
+import annotated_types as at
+
+
+class Case(NamedTuple):
+    """
+    A test case for `annotated_types`.
+    """
+
+    annotation: Any
+    valid_cases: Iterable[Any]
+    invalid_cases: Iterable[Any]
+
+
+def cases() -> Iterable[Case]:
+    # Gt, Ge, Lt, Le
+    yield Case(Annotated[int, at.Gt(4)], (5, 6, 1000), (4, 0, -1))
+    yield Case(Annotated[float, at.Gt(0.5)], (0.6, 0.7, 0.8, 0.9), (0.5, 0.0, -0.1))
+    yield Case(
+        Annotated[datetime, at.Gt(datetime(2000, 1, 1))],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+        [datetime(2000, 1, 1), datetime(1999, 12, 31)],
+    )
+    yield Case(
+        Annotated[datetime, at.Gt(date(2000, 1, 1))],
+        [date(2000, 1, 2), date(2000, 1, 3)],
+        [date(2000, 1, 1), date(1999, 12, 31)],
+    )
+    yield Case(
+        Annotated[datetime, at.Gt(Decimal('1.123'))],
+        [Decimal('1.1231'), Decimal('123')],
+        [Decimal('1.123'), Decimal('0')],
+    )
+
+    yield Case(Annotated[int, at.Ge(4)], (4, 5, 6, 1000, 4), (0, -1))
+    yield Case(Annotated[float, at.Ge(0.5)], (0.5, 0.6, 0.7, 0.8, 0.9), (0.4, 0.0, -0.1))
+    yield Case(
+        Annotated[datetime, at.Ge(datetime(2000, 1, 1))],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+        [datetime(1998, 1, 1), datetime(1999, 12, 31)],
+    )
+
+    yield Case(Annotated[int, at.Lt(4)], (0, -1), (4, 5, 6, 1000, 4))
+    yield Case(Annotated[float, at.Lt(0.5)], (0.4, 0.0, -0.1), (0.5, 0.6, 0.7, 0.8, 0.9))
+    yield Case(
+        Annotated[datetime, at.Lt(datetime(2000, 1, 1))],
+        [datetime(1999, 12, 31), datetime(1999, 12, 31)],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+    )
+
+    yield Case(Annotated[int, at.Le(4)], (4, 0, -1), (5, 6, 1000))
+    yield Case(Annotated[float, at.Le(0.5)], (0.5, 0.0, -0.1), (0.6, 0.7, 0.8, 0.9))
+    yield Case(
+        Annotated[datetime, at.Le(datetime(2000, 1, 1))],
+        [datetime(2000, 1, 1), datetime(1999, 12, 31)],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+    )
+
+    # Interval
+    yield Case(Annotated[int, at.Interval(gt=4)], (5, 6, 1000), (4, 0, -1))
+    yield Case(Annotated[int, at.Interval(gt=4, lt=10)], (5, 6), (4, 10, 1000, 0, -1))
+    yield Case(Annotated[float, at.Interval(ge=0.5, le=1)], (0.5, 0.9, 1), (0.49, 1.1))
+    yield Case(
+        Annotated[datetime, at.Interval(gt=datetime(2000, 1, 1), le=datetime(2000, 1, 3))],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+        [datetime(2000, 1, 1), datetime(2000, 1, 4)],
+    )
+
+    yield Case(Annotated[int, at.MultipleOf(multiple_of=3)], (0, 3, 9), (1, 2, 4))
+    yield Case(Annotated[float, at.MultipleOf(multiple_of=0.5)], (0, 0.5, 1, 1.5), (0.4, 1.1))
+
+    # lengths
+
+    yield Case(Annotated[str, at.MinLen(3)], ('123', '1234', 'x' * 10), ('', '1', '12'))
+    yield Case(Annotated[str, at.Len(3)], ('123', '1234', 'x' * 10), ('', '1', '12'))
+    yield Case(Annotated[List[int], at.MinLen(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2]))
+    yield Case(Annotated[List[int], at.Len(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2]))
+
+    yield Case(Annotated[str, at.MaxLen(4)], ('', '1234'), ('12345', 'x' * 10))
+    yield Case(Annotated[str, at.Len(0, 4)], ('', '1234'), ('12345', 'x' * 10))
+    yield Case(Annotated[List[str], at.MaxLen(4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10))
+    yield Case(Annotated[List[str], at.Len(0, 4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10))
+
+    yield Case(Annotated[str, at.Len(3, 5)], ('123', '12345'), ('', '1', '12', '123456', 'x' * 10))
+    yield Case(Annotated[str, at.Len(3, 3)], ('123',), ('12', '1234'))
+
+    yield Case(Annotated[Dict[int, int], at.Len(2, 3)], [{1: 1, 2: 2}], [{}, {1: 1}, {1: 1, 2: 2, 3: 3, 4: 4}])
+    yield Case(Annotated[Set[int], at.Len(2, 3)], ({1, 2}, {1, 2, 3}), (set(), {1}, {1, 2, 3, 4}))
+    yield Case(Annotated[Tuple[int, ...], at.Len(2, 3)], ((1, 2), (1, 2, 3)), ((), (1,), (1, 2, 3, 4)))
+
+    # Timezone
+
+    yield Case(
+        Annotated[datetime, at.Timezone(None)], [datetime(2000, 1, 1)], [datetime(2000, 1, 1, tzinfo=timezone.utc)]
+    )
+    yield Case(
+        Annotated[datetime, at.Timezone(...)], [datetime(2000, 1, 1, tzinfo=timezone.utc)], [datetime(2000, 1, 1)]
+    )
+    yield Case(
+        Annotated[datetime, at.Timezone(timezone.utc)],
+        [datetime(2000, 1, 1, tzinfo=timezone.utc)],
+        [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))],
+    )
+    yield Case(
+        Annotated[datetime, at.Timezone('Europe/London')],
+        [datetime(2000, 1, 1, tzinfo=timezone(timedelta(0), name='Europe/London'))],
+        [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))],
+    )
+
+    # predicate types
+
+    yield Case(at.LowerCase[str], ['abc', 'foobar'], ['', 'A', 'Boom'])
+    yield Case(at.UpperCase[str], ['ABC', 'DEFO'], ['', 'a', 'abc', 'AbC'])
+    yield Case(at.IsDigits[str], ['123'], ['', 'ab', 'a1b2'])
+    yield Case(at.IsAscii[str], ['123', 'foo bar'], ['£100', '😊', 'whatever 👀'])
+
+    yield Case(Annotated[int, at.Predicate(lambda x: x % 2 == 0)], [0, 2, 4], [1, 3, 5])
+
+    yield Case(at.IsFinite[float], [1.23], [math.nan, math.inf, -math.inf])
+    yield Case(at.IsNotFinite[float], [math.nan, math.inf], [1.23])
+    yield Case(at.IsNan[float], [math.nan], [1.23, math.inf])
+    yield Case(at.IsNotNan[float], [1.23, math.inf], [math.nan])
+    yield Case(at.IsInfinite[float], [math.inf], [math.nan, 1.23])
+    yield Case(at.IsNotInfinite[float], [math.nan, 1.23], [math.inf])
+
+    # check stacked predicates
+    yield Case(at.IsInfinite[Annotated[float, at.Predicate(lambda x: x > 0)]], [math.inf], [-math.inf, 1.23, math.nan])
+
+    # doc
+    yield Case(Annotated[int, at.doc("A number")], [1, 2], [])
+
+    # custom GroupedMetadata
+    class MyCustomGroupedMetadata(at.GroupedMetadata):
+        def __iter__(self) -> Iterator[at.Predicate]:
+            yield at.Predicate(lambda x: float(x).is_integer())
+
+    yield Case(Annotated[float, MyCustomGroupedMetadata()], [0, 2.0], [0.01, 1.5])
diff --git a/llm/Lib/site-packages/anyio-4.3.0.dist-info/INSTALLER b/llm/Lib/site-packages/anyio-4.3.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/anyio-4.3.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/anyio-4.3.0.dist-info/LICENSE b/llm/Lib/site-packages/anyio-4.3.0.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..104eebf5a3002fccdaceef3a4cb936173c1c2035
--- /dev/null
+++ b/llm/Lib/site-packages/anyio-4.3.0.dist-info/LICENSE
@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Alex Grönholm
+
+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 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.
diff --git a/llm/Lib/site-packages/anyio-4.3.0.dist-info/METADATA b/llm/Lib/site-packages/anyio-4.3.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..e02715ca28378772d397d581b5477559ae2838b6
--- /dev/null
+++ b/llm/Lib/site-packages/anyio-4.3.0.dist-info/METADATA
@@ -0,0 +1,104 @@
+Metadata-Version: 2.1
+Name: anyio
+Version: 4.3.0
+Summary: High level compatibility layer for multiple asynchronous event loop implementations
+Author-email: Alex Grönholm <alex.gronholm@nextday.fi>
+License: MIT
+Project-URL: Documentation, https://anyio.readthedocs.io/en/latest/
+Project-URL: Changelog, https://anyio.readthedocs.io/en/stable/versionhistory.html
+Project-URL: Source code, https://github.com/agronholm/anyio
+Project-URL: Issue tracker, https://github.com/agronholm/anyio/issues
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Framework :: AnyIO
+Classifier: Typing :: Typed
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: idna >=2.8
+Requires-Dist: sniffio >=1.1
+Requires-Dist: exceptiongroup >=1.0.2 ; python_version < "3.11"
+Requires-Dist: typing-extensions >=4.1 ; python_version < "3.11"
+Provides-Extra: doc
+Requires-Dist: packaging ; extra == 'doc'
+Requires-Dist: Sphinx >=7 ; extra == 'doc'
+Requires-Dist: sphinx-rtd-theme ; extra == 'doc'
+Requires-Dist: sphinx-autodoc-typehints >=1.2.0 ; extra == 'doc'
+Provides-Extra: test
+Requires-Dist: anyio[trio] ; extra == 'test'
+Requires-Dist: coverage[toml] >=7 ; extra == 'test'
+Requires-Dist: exceptiongroup >=1.2.0 ; extra == 'test'
+Requires-Dist: hypothesis >=4.0 ; extra == 'test'
+Requires-Dist: psutil >=5.9 ; extra == 'test'
+Requires-Dist: pytest >=7.0 ; extra == 'test'
+Requires-Dist: pytest-mock >=3.6.1 ; extra == 'test'
+Requires-Dist: trustme ; extra == 'test'
+Requires-Dist: uvloop >=0.17 ; (platform_python_implementation == "CPython" and platform_system != "Windows") and extra == 'test'
+Provides-Extra: trio
+Requires-Dist: trio >=0.23 ; extra == 'trio'
+
+.. image:: https://github.com/agronholm/anyio/actions/workflows/test.yml/badge.svg
+  :target: https://github.com/agronholm/anyio/actions/workflows/test.yml
+  :alt: Build Status
+.. image:: https://coveralls.io/repos/github/agronholm/anyio/badge.svg?branch=master
+  :target: https://coveralls.io/github/agronholm/anyio?branch=master
+  :alt: Code Coverage
+.. image:: https://readthedocs.org/projects/anyio/badge/?version=latest
+  :target: https://anyio.readthedocs.io/en/latest/?badge=latest
+  :alt: Documentation
+.. image:: https://badges.gitter.im/gitterHQ/gitter.svg
+  :target: https://gitter.im/python-trio/AnyIO
+  :alt: Gitter chat
+
+AnyIO is an asynchronous networking and concurrency library that works on top of either asyncio_ or
+trio_. It implements trio-like `structured concurrency`_ (SC) on top of asyncio and works in harmony
+with the native SC of trio itself.
+
+Applications and libraries written against AnyIO's API will run unmodified on either asyncio_ or
+trio_. AnyIO can also be adopted into a library or application incrementally – bit by bit, no full
+refactoring necessary. It will blend in with the native libraries of your chosen backend.
+
+Documentation
+-------------
+
+View full documentation at: https://anyio.readthedocs.io/
+
+Features
+--------
+
+AnyIO offers the following functionality:
+
+* Task groups (nurseries_ in trio terminology)
+* High-level networking (TCP, UDP and UNIX sockets)
+
+  * `Happy eyeballs`_ algorithm for TCP connections (more robust than that of asyncio on Python
+    3.8)
+  * async/await style UDP sockets (unlike asyncio where you still have to use Transports and
+    Protocols)
+
+* A versatile API for byte streams and object streams
+* Inter-task synchronization and communication (locks, conditions, events, semaphores, object
+  streams)
+* Worker threads
+* Subprocesses
+* Asynchronous file I/O (using worker threads)
+* Signal handling
+
+AnyIO also comes with its own pytest_ plugin which also supports asynchronous fixtures.
+It even works with the popular Hypothesis_ library.
+
+.. _asyncio: https://docs.python.org/3/library/asyncio.html
+.. _trio: https://github.com/python-trio/trio
+.. _structured concurrency: https://en.wikipedia.org/wiki/Structured_concurrency
+.. _nurseries: https://trio.readthedocs.io/en/stable/reference-core.html#nurseries-and-spawning
+.. _Happy eyeballs: https://en.wikipedia.org/wiki/Happy_Eyeballs
+.. _pytest: https://docs.pytest.org/en/latest/
+.. _Hypothesis: https://hypothesis.works/
diff --git a/llm/Lib/site-packages/anyio-4.3.0.dist-info/RECORD b/llm/Lib/site-packages/anyio-4.3.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..593bf79b9ac7485022c685985732bb071774f6c7
--- /dev/null
+++ b/llm/Lib/site-packages/anyio-4.3.0.dist-info/RECORD
@@ -0,0 +1,82 @@
+anyio-4.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+anyio-4.3.0.dist-info/LICENSE,sha256=U2GsncWPLvX9LpsJxoKXwX8ElQkJu8gCO9uC6s8iwrA,1081
+anyio-4.3.0.dist-info/METADATA,sha256=Xy5N0vn6s_rjN1C0EbX_z1N_lf3bZIJu88RAQxVAsrI,4599
+anyio-4.3.0.dist-info/RECORD,,
+anyio-4.3.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+anyio-4.3.0.dist-info/entry_points.txt,sha256=_d6Yu6uiaZmNe0CydowirE9Cmg7zUL2g08tQpoS3Qvc,39
+anyio-4.3.0.dist-info/top_level.txt,sha256=QglSMiWX8_5dpoVAEIHdEYzvqFMdSYWmCj6tYw2ITkQ,6
+anyio/__init__.py,sha256=CxUxIHOIONI3KpsDLCg-dI6lQaDkW_4Zhtu5jWt1XO8,4344
+anyio/__pycache__/__init__.cpython-311.pyc,,
+anyio/__pycache__/from_thread.cpython-311.pyc,,
+anyio/__pycache__/lowlevel.cpython-311.pyc,,
+anyio/__pycache__/pytest_plugin.cpython-311.pyc,,
+anyio/__pycache__/to_process.cpython-311.pyc,,
+anyio/__pycache__/to_thread.cpython-311.pyc,,
+anyio/_backends/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+anyio/_backends/__pycache__/__init__.cpython-311.pyc,,
+anyio/_backends/__pycache__/_asyncio.cpython-311.pyc,,
+anyio/_backends/__pycache__/_trio.cpython-311.pyc,,
+anyio/_backends/_asyncio.py,sha256=D1ME_t4zfei7sm7Ic8jEQBsAc3uMykvsQjZxhT5aTNg,81968
+anyio/_backends/_trio.py,sha256=87ahML2dsX3uQuCkyIB4E7XFK6jAGpxs5hVlGmHHd8Q,35642
+anyio/_core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+anyio/_core/__pycache__/__init__.cpython-311.pyc,,
+anyio/_core/__pycache__/_eventloop.cpython-311.pyc,,
+anyio/_core/__pycache__/_exceptions.cpython-311.pyc,,
+anyio/_core/__pycache__/_fileio.cpython-311.pyc,,
+anyio/_core/__pycache__/_resources.cpython-311.pyc,,
+anyio/_core/__pycache__/_signals.cpython-311.pyc,,
+anyio/_core/__pycache__/_sockets.cpython-311.pyc,,
+anyio/_core/__pycache__/_streams.cpython-311.pyc,,
+anyio/_core/__pycache__/_subprocesses.cpython-311.pyc,,
+anyio/_core/__pycache__/_synchronization.cpython-311.pyc,,
+anyio/_core/__pycache__/_tasks.cpython-311.pyc,,
+anyio/_core/__pycache__/_testing.cpython-311.pyc,,
+anyio/_core/__pycache__/_typedattr.cpython-311.pyc,,
+anyio/_core/_eventloop.py,sha256=uCwWwGtN9Tf46nkcWLyku8iYEFWCkSjPW0AkDbnpCM0,4408
+anyio/_core/_exceptions.py,sha256=wUmhDu80qEB7z9EdCqUwVEhNUlNEok4_W2-rC6sCAUQ,2078
+anyio/_core/_fileio.py,sha256=Zdp3L0_T7mMCaYq3bFTCb-udTnIknKpzcLEvHK-Tmbc,19512
+anyio/_core/_resources.py,sha256=NbmU5O5UX3xEyACnkmYX28Fmwdl-f-ny0tHym26e0w0,435
+anyio/_core/_signals.py,sha256=rDOVxtugZDgC5AhfW3lrwsre2n9Pj_adoRUidBiF6dA,878
+anyio/_core/_sockets.py,sha256=HwOMg0xUPw0T7N-aipxq_4OEM703llh3I9_YIg9a4XM,24048
+anyio/_core/_streams.py,sha256=Z8ZlTY6xom5EszrMsgCT3TphiT4JIlQG-y33CrD0NQY,1811
+anyio/_core/_subprocesses.py,sha256=ZLLNXAtlRGfbyC4sOIltYB1k3NJa3tqk_x_Fsnbcs1M,5272
+anyio/_core/_synchronization.py,sha256=h3o6dWWbzVrcNmi7i2mQjEgRtnIxkGtjmYK7KMpdlaE,18444
+anyio/_core/_tasks.py,sha256=pvVEX2Fw159sf0ypAPerukKsZgRRwvFFedVW52nR2Vk,4764
+anyio/_core/_testing.py,sha256=i97S5rSWIFqfCGPm4mEMdiJaUpVskk-cWEjarWTeXXs,1964
+anyio/_core/_typedattr.py,sha256=QTbaIwZEewhwAKvbBHFBcO_cRhNP_lXjAobEldzExCU,2499
+anyio/abc/__init__.py,sha256=U44_s3BglL8BojWQiq0KuokvCqkunIp-ySH3GyRXxAc,2681
+anyio/abc/__pycache__/__init__.cpython-311.pyc,,
+anyio/abc/__pycache__/_eventloop.cpython-311.pyc,,
+anyio/abc/__pycache__/_resources.cpython-311.pyc,,
+anyio/abc/__pycache__/_sockets.cpython-311.pyc,,
+anyio/abc/__pycache__/_streams.cpython-311.pyc,,
+anyio/abc/__pycache__/_subprocesses.cpython-311.pyc,,
+anyio/abc/__pycache__/_tasks.cpython-311.pyc,,
+anyio/abc/__pycache__/_testing.cpython-311.pyc,,
+anyio/abc/_eventloop.py,sha256=QOtkEHCkoE8czGu4RNzZ_q-xNjC0nRyoS0QQJ5KTvYU,10097
+anyio/abc/_resources.py,sha256=KBJP3wGbvSfKfTjfOLL4QCJdeiaNwqqF_6FwPsmQssM,763
+anyio/abc/_sockets.py,sha256=XdZ42TQ1omZN9Ec3HUfTMWG_i-21yMjXQ_FFslAZtzQ,6269
+anyio/abc/_streams.py,sha256=GzST5Q2zQmxVzdrAqtbSyHNxkPlIC9AzeZJg_YyPAXw,6598
+anyio/abc/_subprocesses.py,sha256=cumAPJTktOQtw63IqG0lDpyZqu_l1EElvQHMiwJgL08,2067
+anyio/abc/_tasks.py,sha256=q3bEbCF46I2tQjYSbRdbaavq0R_HOV9JAjzQr8biprU,2747
+anyio/abc/_testing.py,sha256=EiWEaIVy15lHszO000Xp4FsB13NbBvC1BpUci47B5zs,1829
+anyio/from_thread.py,sha256=UTEY_NsiqQRukO3L3riQx4Eegulj3RyLlbITJz7pvLM,15749
+anyio/lowlevel.py,sha256=0awnMh05kA5WUNaOBoQZSImBj0xLNRlYOuMGGiztWnM,4185
+anyio/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+anyio/pytest_plugin.py,sha256=TBgRAfT-Oxy6efhO1Tziq54NND3Jy4dRmwkMmQXSvhI,5386
+anyio/streams/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+anyio/streams/__pycache__/__init__.cpython-311.pyc,,
+anyio/streams/__pycache__/buffered.cpython-311.pyc,,
+anyio/streams/__pycache__/file.cpython-311.pyc,,
+anyio/streams/__pycache__/memory.cpython-311.pyc,,
+anyio/streams/__pycache__/stapled.cpython-311.pyc,,
+anyio/streams/__pycache__/text.cpython-311.pyc,,
+anyio/streams/__pycache__/tls.cpython-311.pyc,,
+anyio/streams/buffered.py,sha256=UCldKC168YuLvT7n3HtNPnQ2iWAMSTYQWbZvzLwMwkM,4500
+anyio/streams/file.py,sha256=6uoTNb5KbMoj-6gS3_xrrL8uZN8Q4iIvOS1WtGyFfKw,4383
+anyio/streams/memory.py,sha256=bqN9YwAPA6ZtdohOsq_YBpLFlRHR5k-W8y0pD_jznb8,9296
+anyio/streams/stapled.py,sha256=U09pCrmOw9kkNhe6tKopsm1QIMT1lFTFvtb-A7SIe4k,4302
+anyio/streams/text.py,sha256=6x8w8xlfCZKTUWQoJiMPoMhSSJFUBRKgoBNSBtbd9yg,5094
+anyio/streams/tls.py,sha256=ev-6yNOGcIkziIkcIfKj8VmLqQJW-iDBJttaKgKDsF4,12752
+anyio/to_process.py,sha256=lx_bt0CUJsS1eSlraw662OpCjRgGXowoyf1Q-i-kOxo,9535
+anyio/to_thread.py,sha256=WM2JQ2MbVsd5D5CM08bQiTwzZIvpsGjfH1Fy247KoDQ,2396
diff --git a/llm/Lib/site-packages/anyio-4.3.0.dist-info/WHEEL b/llm/Lib/site-packages/anyio-4.3.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..98c0d20b7a64f4f998d7913e1d38a05dba20916c
--- /dev/null
+++ b/llm/Lib/site-packages/anyio-4.3.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.42.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/anyio-4.3.0.dist-info/entry_points.txt b/llm/Lib/site-packages/anyio-4.3.0.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..44dd9bdc3039122cc98014c1439ca254313fd014
--- /dev/null
+++ b/llm/Lib/site-packages/anyio-4.3.0.dist-info/entry_points.txt
@@ -0,0 +1,2 @@
+[pytest11]
+anyio = anyio.pytest_plugin
diff --git a/llm/Lib/site-packages/anyio-4.3.0.dist-info/top_level.txt b/llm/Lib/site-packages/anyio-4.3.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..c77c069ecc9b7f8b1f97dbcfec905725db0253a8
--- /dev/null
+++ b/llm/Lib/site-packages/anyio-4.3.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+anyio
diff --git a/llm/Lib/site-packages/anyio/__init__.py b/llm/Lib/site-packages/anyio/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7bfe231645cc9453fe28733093841924afb7d43d
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/__init__.py
@@ -0,0 +1,76 @@
+from __future__ import annotations
+
+from typing import Any
+
+from ._core._eventloop import current_time as current_time
+from ._core._eventloop import get_all_backends as get_all_backends
+from ._core._eventloop import get_cancelled_exc_class as get_cancelled_exc_class
+from ._core._eventloop import run as run
+from ._core._eventloop import sleep as sleep
+from ._core._eventloop import sleep_forever as sleep_forever
+from ._core._eventloop import sleep_until as sleep_until
+from ._core._exceptions import BrokenResourceError as BrokenResourceError
+from ._core._exceptions import BrokenWorkerProcess as BrokenWorkerProcess
+from ._core._exceptions import BusyResourceError as BusyResourceError
+from ._core._exceptions import ClosedResourceError as ClosedResourceError
+from ._core._exceptions import DelimiterNotFound as DelimiterNotFound
+from ._core._exceptions import EndOfStream as EndOfStream
+from ._core._exceptions import IncompleteRead as IncompleteRead
+from ._core._exceptions import TypedAttributeLookupError as TypedAttributeLookupError
+from ._core._exceptions import WouldBlock as WouldBlock
+from ._core._fileio import AsyncFile as AsyncFile
+from ._core._fileio import Path as Path
+from ._core._fileio import open_file as open_file
+from ._core._fileio import wrap_file as wrap_file
+from ._core._resources import aclose_forcefully as aclose_forcefully
+from ._core._signals import open_signal_receiver as open_signal_receiver
+from ._core._sockets import connect_tcp as connect_tcp
+from ._core._sockets import connect_unix as connect_unix
+from ._core._sockets import create_connected_udp_socket as create_connected_udp_socket
+from ._core._sockets import (
+    create_connected_unix_datagram_socket as create_connected_unix_datagram_socket,
+)
+from ._core._sockets import create_tcp_listener as create_tcp_listener
+from ._core._sockets import create_udp_socket as create_udp_socket
+from ._core._sockets import create_unix_datagram_socket as create_unix_datagram_socket
+from ._core._sockets import create_unix_listener as create_unix_listener
+from ._core._sockets import getaddrinfo as getaddrinfo
+from ._core._sockets import getnameinfo as getnameinfo
+from ._core._sockets import wait_socket_readable as wait_socket_readable
+from ._core._sockets import wait_socket_writable as wait_socket_writable
+from ._core._streams import create_memory_object_stream as create_memory_object_stream
+from ._core._subprocesses import open_process as open_process
+from ._core._subprocesses import run_process as run_process
+from ._core._synchronization import CapacityLimiter as CapacityLimiter
+from ._core._synchronization import (
+    CapacityLimiterStatistics as CapacityLimiterStatistics,
+)
+from ._core._synchronization import Condition as Condition
+from ._core._synchronization import ConditionStatistics as ConditionStatistics
+from ._core._synchronization import Event as Event
+from ._core._synchronization import EventStatistics as EventStatistics
+from ._core._synchronization import Lock as Lock
+from ._core._synchronization import LockStatistics as LockStatistics
+from ._core._synchronization import ResourceGuard as ResourceGuard
+from ._core._synchronization import Semaphore as Semaphore
+from ._core._synchronization import SemaphoreStatistics as SemaphoreStatistics
+from ._core._tasks import TASK_STATUS_IGNORED as TASK_STATUS_IGNORED
+from ._core._tasks import CancelScope as CancelScope
+from ._core._tasks import create_task_group as create_task_group
+from ._core._tasks import current_effective_deadline as current_effective_deadline
+from ._core._tasks import fail_after as fail_after
+from ._core._tasks import move_on_after as move_on_after
+from ._core._testing import TaskInfo as TaskInfo
+from ._core._testing import get_current_task as get_current_task
+from ._core._testing import get_running_tasks as get_running_tasks
+from ._core._testing import wait_all_tasks_blocked as wait_all_tasks_blocked
+from ._core._typedattr import TypedAttributeProvider as TypedAttributeProvider
+from ._core._typedattr import TypedAttributeSet as TypedAttributeSet
+from ._core._typedattr import typed_attribute as typed_attribute
+
+# Re-export imports so they look like they live directly in this package
+key: str
+value: Any
+for key, value in list(locals().items()):
+    if getattr(value, "__module__", "").startswith("anyio."):
+        value.__module__ = __name__
diff --git a/llm/Lib/site-packages/anyio/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/anyio/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ecee451639b7d0681594ec9610a3e6a3e5d26aef
Binary files /dev/null and b/llm/Lib/site-packages/anyio/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/__pycache__/from_thread.cpython-311.pyc b/llm/Lib/site-packages/anyio/__pycache__/from_thread.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5e06f8648dd97a6e35548adf921d4fdc2508fbfa
Binary files /dev/null and b/llm/Lib/site-packages/anyio/__pycache__/from_thread.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/__pycache__/lowlevel.cpython-311.pyc b/llm/Lib/site-packages/anyio/__pycache__/lowlevel.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..361b5ed8293966d1d7473784938946869ee9d286
Binary files /dev/null and b/llm/Lib/site-packages/anyio/__pycache__/lowlevel.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/__pycache__/pytest_plugin.cpython-311.pyc b/llm/Lib/site-packages/anyio/__pycache__/pytest_plugin.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..464026fba7d455929ee37db8675c5553e115c39a
Binary files /dev/null and b/llm/Lib/site-packages/anyio/__pycache__/pytest_plugin.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/__pycache__/to_process.cpython-311.pyc b/llm/Lib/site-packages/anyio/__pycache__/to_process.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2d97158531af0aa4fe048ec565d4a8475dacb45e
Binary files /dev/null and b/llm/Lib/site-packages/anyio/__pycache__/to_process.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/__pycache__/to_thread.cpython-311.pyc b/llm/Lib/site-packages/anyio/__pycache__/to_thread.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0d77257bfadf9c8c75a982dffbbe0834b34efae3
Binary files /dev/null and b/llm/Lib/site-packages/anyio/__pycache__/to_thread.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_backends/__init__.py b/llm/Lib/site-packages/anyio/_backends/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/anyio/_backends/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/anyio/_backends/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cbaa0f126061ae08ddcfba2097dabd31987d76a3
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_backends/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_backends/__pycache__/_asyncio.cpython-311.pyc b/llm/Lib/site-packages/anyio/_backends/__pycache__/_asyncio.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7b63ed8a3a8aecf148ecb4ce322263aab5896e18
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_backends/__pycache__/_asyncio.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_backends/__pycache__/_trio.cpython-311.pyc b/llm/Lib/site-packages/anyio/_backends/__pycache__/_trio.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5d04946e6add73585bdeba25572edb789c2b136f
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_backends/__pycache__/_trio.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_backends/_asyncio.py b/llm/Lib/site-packages/anyio/_backends/_asyncio.py
new file mode 100644
index 0000000000000000000000000000000000000000..2699bf8146e53be354c38fa40712ae22c57c4ce5
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_backends/_asyncio.py
@@ -0,0 +1,2478 @@
+from __future__ import annotations
+
+import array
+import asyncio
+import concurrent.futures
+import math
+import socket
+import sys
+import threading
+from asyncio import (
+    AbstractEventLoop,
+    CancelledError,
+    all_tasks,
+    create_task,
+    current_task,
+    get_running_loop,
+    sleep,
+)
+from asyncio.base_events import _run_until_complete_cb  # type: ignore[attr-defined]
+from collections import OrderedDict, deque
+from collections.abc import AsyncIterator, Generator, Iterable
+from concurrent.futures import Future
+from contextlib import suppress
+from contextvars import Context, copy_context
+from dataclasses import dataclass
+from functools import partial, wraps
+from inspect import (
+    CORO_RUNNING,
+    CORO_SUSPENDED,
+    getcoroutinestate,
+    iscoroutine,
+)
+from io import IOBase
+from os import PathLike
+from queue import Queue
+from signal import Signals
+from socket import AddressFamily, SocketKind
+from threading import Thread
+from types import TracebackType
+from typing import (
+    IO,
+    Any,
+    AsyncGenerator,
+    Awaitable,
+    Callable,
+    Collection,
+    ContextManager,
+    Coroutine,
+    Mapping,
+    Optional,
+    Sequence,
+    Tuple,
+    TypeVar,
+    cast,
+)
+from weakref import WeakKeyDictionary
+
+import sniffio
+
+from .. import CapacityLimiterStatistics, EventStatistics, TaskInfo, abc
+from .._core._eventloop import claim_worker_thread, threadlocals
+from .._core._exceptions import (
+    BrokenResourceError,
+    BusyResourceError,
+    ClosedResourceError,
+    EndOfStream,
+    WouldBlock,
+)
+from .._core._sockets import convert_ipv6_sockaddr
+from .._core._streams import create_memory_object_stream
+from .._core._synchronization import CapacityLimiter as BaseCapacityLimiter
+from .._core._synchronization import Event as BaseEvent
+from .._core._synchronization import ResourceGuard
+from .._core._tasks import CancelScope as BaseCancelScope
+from ..abc import (
+    AsyncBackend,
+    IPSockAddrType,
+    SocketListener,
+    UDPPacketType,
+    UNIXDatagramPacketType,
+)
+from ..lowlevel import RunVar
+from ..streams.memory import MemoryObjectReceiveStream, MemoryObjectSendStream
+
+if sys.version_info >= (3, 10):
+    from typing import ParamSpec
+else:
+    from typing_extensions import ParamSpec
+
+if sys.version_info >= (3, 11):
+    from asyncio import Runner
+    from typing import TypeVarTuple, Unpack
+else:
+    import contextvars
+    import enum
+    import signal
+    from asyncio import coroutines, events, exceptions, tasks
+
+    from exceptiongroup import BaseExceptionGroup
+    from typing_extensions import TypeVarTuple, Unpack
+
+    class _State(enum.Enum):
+        CREATED = "created"
+        INITIALIZED = "initialized"
+        CLOSED = "closed"
+
+    class Runner:
+        # Copied from CPython 3.11
+        def __init__(
+            self,
+            *,
+            debug: bool | None = None,
+            loop_factory: Callable[[], AbstractEventLoop] | None = None,
+        ):
+            self._state = _State.CREATED
+            self._debug = debug
+            self._loop_factory = loop_factory
+            self._loop: AbstractEventLoop | None = None
+            self._context = None
+            self._interrupt_count = 0
+            self._set_event_loop = False
+
+        def __enter__(self) -> Runner:
+            self._lazy_init()
+            return self
+
+        def __exit__(
+            self,
+            exc_type: type[BaseException],
+            exc_val: BaseException,
+            exc_tb: TracebackType,
+        ) -> None:
+            self.close()
+
+        def close(self) -> None:
+            """Shutdown and close event loop."""
+            if self._state is not _State.INITIALIZED:
+                return
+            try:
+                loop = self._loop
+                _cancel_all_tasks(loop)
+                loop.run_until_complete(loop.shutdown_asyncgens())
+                if hasattr(loop, "shutdown_default_executor"):
+                    loop.run_until_complete(loop.shutdown_default_executor())
+                else:
+                    loop.run_until_complete(_shutdown_default_executor(loop))
+            finally:
+                if self._set_event_loop:
+                    events.set_event_loop(None)
+                loop.close()
+                self._loop = None
+                self._state = _State.CLOSED
+
+        def get_loop(self) -> AbstractEventLoop:
+            """Return embedded event loop."""
+            self._lazy_init()
+            return self._loop
+
+        def run(self, coro: Coroutine[T_Retval], *, context=None) -> T_Retval:
+            """Run a coroutine inside the embedded event loop."""
+            if not coroutines.iscoroutine(coro):
+                raise ValueError(f"a coroutine was expected, got {coro!r}")
+
+            if events._get_running_loop() is not None:
+                # fail fast with short traceback
+                raise RuntimeError(
+                    "Runner.run() cannot be called from a running event loop"
+                )
+
+            self._lazy_init()
+
+            if context is None:
+                context = self._context
+            task = context.run(self._loop.create_task, coro)
+
+            if (
+                threading.current_thread() is threading.main_thread()
+                and signal.getsignal(signal.SIGINT) is signal.default_int_handler
+            ):
+                sigint_handler = partial(self._on_sigint, main_task=task)
+                try:
+                    signal.signal(signal.SIGINT, sigint_handler)
+                except ValueError:
+                    # `signal.signal` may throw if `threading.main_thread` does
+                    # not support signals (e.g. embedded interpreter with signals
+                    # not registered - see gh-91880)
+                    sigint_handler = None
+            else:
+                sigint_handler = None
+
+            self._interrupt_count = 0
+            try:
+                return self._loop.run_until_complete(task)
+            except exceptions.CancelledError:
+                if self._interrupt_count > 0:
+                    uncancel = getattr(task, "uncancel", None)
+                    if uncancel is not None and uncancel() == 0:
+                        raise KeyboardInterrupt()
+                raise  # CancelledError
+            finally:
+                if (
+                    sigint_handler is not None
+                    and signal.getsignal(signal.SIGINT) is sigint_handler
+                ):
+                    signal.signal(signal.SIGINT, signal.default_int_handler)
+
+        def _lazy_init(self) -> None:
+            if self._state is _State.CLOSED:
+                raise RuntimeError("Runner is closed")
+            if self._state is _State.INITIALIZED:
+                return
+            if self._loop_factory is None:
+                self._loop = events.new_event_loop()
+                if not self._set_event_loop:
+                    # Call set_event_loop only once to avoid calling
+                    # attach_loop multiple times on child watchers
+                    events.set_event_loop(self._loop)
+                    self._set_event_loop = True
+            else:
+                self._loop = self._loop_factory()
+            if self._debug is not None:
+                self._loop.set_debug(self._debug)
+            self._context = contextvars.copy_context()
+            self._state = _State.INITIALIZED
+
+        def _on_sigint(self, signum, frame, main_task: asyncio.Task) -> None:
+            self._interrupt_count += 1
+            if self._interrupt_count == 1 and not main_task.done():
+                main_task.cancel()
+                # wakeup loop if it is blocked by select() with long timeout
+                self._loop.call_soon_threadsafe(lambda: None)
+                return
+            raise KeyboardInterrupt()
+
+    def _cancel_all_tasks(loop: AbstractEventLoop) -> None:
+        to_cancel = tasks.all_tasks(loop)
+        if not to_cancel:
+            return
+
+        for task in to_cancel:
+            task.cancel()
+
+        loop.run_until_complete(tasks.gather(*to_cancel, return_exceptions=True))
+
+        for task in to_cancel:
+            if task.cancelled():
+                continue
+            if task.exception() is not None:
+                loop.call_exception_handler(
+                    {
+                        "message": "unhandled exception during asyncio.run() shutdown",
+                        "exception": task.exception(),
+                        "task": task,
+                    }
+                )
+
+    async def _shutdown_default_executor(loop: AbstractEventLoop) -> None:
+        """Schedule the shutdown of the default executor."""
+
+        def _do_shutdown(future: asyncio.futures.Future) -> None:
+            try:
+                loop._default_executor.shutdown(wait=True)  # type: ignore[attr-defined]
+                loop.call_soon_threadsafe(future.set_result, None)
+            except Exception as ex:
+                loop.call_soon_threadsafe(future.set_exception, ex)
+
+        loop._executor_shutdown_called = True
+        if loop._default_executor is None:
+            return
+        future = loop.create_future()
+        thread = threading.Thread(target=_do_shutdown, args=(future,))
+        thread.start()
+        try:
+            await future
+        finally:
+            thread.join()
+
+
+T_Retval = TypeVar("T_Retval")
+T_contra = TypeVar("T_contra", contravariant=True)
+PosArgsT = TypeVarTuple("PosArgsT")
+P = ParamSpec("P")
+
+_root_task: RunVar[asyncio.Task | None] = RunVar("_root_task")
+
+
+def find_root_task() -> asyncio.Task:
+    root_task = _root_task.get(None)
+    if root_task is not None and not root_task.done():
+        return root_task
+
+    # Look for a task that has been started via run_until_complete()
+    for task in all_tasks():
+        if task._callbacks and not task.done():
+            callbacks = [cb for cb, context in task._callbacks]
+            for cb in callbacks:
+                if (
+                    cb is _run_until_complete_cb
+                    or getattr(cb, "__module__", None) == "uvloop.loop"
+                ):
+                    _root_task.set(task)
+                    return task
+
+    # Look up the topmost task in the AnyIO task tree, if possible
+    task = cast(asyncio.Task, current_task())
+    state = _task_states.get(task)
+    if state:
+        cancel_scope = state.cancel_scope
+        while cancel_scope and cancel_scope._parent_scope is not None:
+            cancel_scope = cancel_scope._parent_scope
+
+        if cancel_scope is not None:
+            return cast(asyncio.Task, cancel_scope._host_task)
+
+    return task
+
+
+def get_callable_name(func: Callable) -> str:
+    module = getattr(func, "__module__", None)
+    qualname = getattr(func, "__qualname__", None)
+    return ".".join([x for x in (module, qualname) if x])
+
+
+#
+# Event loop
+#
+
+_run_vars: WeakKeyDictionary[asyncio.AbstractEventLoop, Any] = WeakKeyDictionary()
+
+
+def _task_started(task: asyncio.Task) -> bool:
+    """Return ``True`` if the task has been started and has not finished."""
+    try:
+        return getcoroutinestate(task.get_coro()) in (CORO_RUNNING, CORO_SUSPENDED)
+    except AttributeError:
+        # task coro is async_genenerator_asend https://bugs.python.org/issue37771
+        raise Exception(f"Cannot determine if task {task} has started or not") from None
+
+
+#
+# Timeouts and cancellation
+#
+
+
+class CancelScope(BaseCancelScope):
+    def __new__(
+        cls, *, deadline: float = math.inf, shield: bool = False
+    ) -> CancelScope:
+        return object.__new__(cls)
+
+    def __init__(self, deadline: float = math.inf, shield: bool = False):
+        self._deadline = deadline
+        self._shield = shield
+        self._parent_scope: CancelScope | None = None
+        self._child_scopes: set[CancelScope] = set()
+        self._cancel_called = False
+        self._cancelled_caught = False
+        self._active = False
+        self._timeout_handle: asyncio.TimerHandle | None = None
+        self._cancel_handle: asyncio.Handle | None = None
+        self._tasks: set[asyncio.Task] = set()
+        self._host_task: asyncio.Task | None = None
+        self._cancel_calls: int = 0
+        self._cancelling: int | None = None
+
+    def __enter__(self) -> CancelScope:
+        if self._active:
+            raise RuntimeError(
+                "Each CancelScope may only be used for a single 'with' block"
+            )
+
+        self._host_task = host_task = cast(asyncio.Task, current_task())
+        self._tasks.add(host_task)
+        try:
+            task_state = _task_states[host_task]
+        except KeyError:
+            task_state = TaskState(None, self)
+            _task_states[host_task] = task_state
+        else:
+            self._parent_scope = task_state.cancel_scope
+            task_state.cancel_scope = self
+            if self._parent_scope is not None:
+                self._parent_scope._child_scopes.add(self)
+                self._parent_scope._tasks.remove(host_task)
+
+        self._timeout()
+        self._active = True
+        if sys.version_info >= (3, 11):
+            self._cancelling = self._host_task.cancelling()
+
+        # Start cancelling the host task if the scope was cancelled before entering
+        if self._cancel_called:
+            self._deliver_cancellation(self)
+
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
+        if not self._active:
+            raise RuntimeError("This cancel scope is not active")
+        if current_task() is not self._host_task:
+            raise RuntimeError(
+                "Attempted to exit cancel scope in a different task than it was "
+                "entered in"
+            )
+
+        assert self._host_task is not None
+        host_task_state = _task_states.get(self._host_task)
+        if host_task_state is None or host_task_state.cancel_scope is not self:
+            raise RuntimeError(
+                "Attempted to exit a cancel scope that isn't the current tasks's "
+                "current cancel scope"
+            )
+
+        self._active = False
+        if self._timeout_handle:
+            self._timeout_handle.cancel()
+            self._timeout_handle = None
+
+        self._tasks.remove(self._host_task)
+        if self._parent_scope is not None:
+            self._parent_scope._child_scopes.remove(self)
+            self._parent_scope._tasks.add(self._host_task)
+
+        host_task_state.cancel_scope = self._parent_scope
+
+        # Restart the cancellation effort in the closest directly cancelled parent
+        # scope if this one was shielded
+        self._restart_cancellation_in_parent()
+
+        if self._cancel_called and exc_val is not None:
+            for exc in iterate_exceptions(exc_val):
+                if isinstance(exc, CancelledError):
+                    self._cancelled_caught = self._uncancel(exc)
+                    if self._cancelled_caught:
+                        break
+
+            return self._cancelled_caught
+
+        return None
+
+    def _uncancel(self, cancelled_exc: CancelledError) -> bool:
+        if sys.version_info < (3, 9) or self._host_task is None:
+            self._cancel_calls = 0
+            return True
+
+        # Undo all cancellations done by this scope
+        if self._cancelling is not None:
+            while self._cancel_calls:
+                self._cancel_calls -= 1
+                if self._host_task.uncancel() <= self._cancelling:
+                    return True
+
+        self._cancel_calls = 0
+        return f"Cancelled by cancel scope {id(self):x}" in cancelled_exc.args
+
+    def _timeout(self) -> None:
+        if self._deadline != math.inf:
+            loop = get_running_loop()
+            if loop.time() >= self._deadline:
+                self.cancel()
+            else:
+                self._timeout_handle = loop.call_at(self._deadline, self._timeout)
+
+    def _deliver_cancellation(self, origin: CancelScope) -> bool:
+        """
+        Deliver cancellation to directly contained tasks and nested cancel scopes.
+
+        Schedule another run at the end if we still have tasks eligible for
+        cancellation.
+
+        :param origin: the cancel scope that originated the cancellation
+        :return: ``True`` if the delivery needs to be retried on the next cycle
+
+        """
+        should_retry = False
+        current = current_task()
+        for task in self._tasks:
+            if task._must_cancel:  # type: ignore[attr-defined]
+                continue
+
+            # The task is eligible for cancellation if it has started
+            should_retry = True
+            if task is not current and (task is self._host_task or _task_started(task)):
+                waiter = task._fut_waiter  # type: ignore[attr-defined]
+                if not isinstance(waiter, asyncio.Future) or not waiter.done():
+                    self._cancel_calls += 1
+                    if sys.version_info >= (3, 9):
+                        task.cancel(f"Cancelled by cancel scope {id(origin):x}")
+                    else:
+                        task.cancel()
+
+        # Deliver cancellation to child scopes that aren't shielded or running their own
+        # cancellation callbacks
+        for scope in self._child_scopes:
+            if not scope._shield and not scope.cancel_called:
+                should_retry = scope._deliver_cancellation(origin) or should_retry
+
+        # Schedule another callback if there are still tasks left
+        if origin is self:
+            if should_retry:
+                self._cancel_handle = get_running_loop().call_soon(
+                    self._deliver_cancellation, origin
+                )
+            else:
+                self._cancel_handle = None
+
+        return should_retry
+
+    def _restart_cancellation_in_parent(self) -> None:
+        """
+        Restart the cancellation effort in the closest directly cancelled parent scope.
+
+        """
+        scope = self._parent_scope
+        while scope is not None:
+            if scope._cancel_called:
+                if scope._cancel_handle is None:
+                    scope._deliver_cancellation(scope)
+
+                break
+
+            # No point in looking beyond any shielded scope
+            if scope._shield:
+                break
+
+            scope = scope._parent_scope
+
+    def _parent_cancelled(self) -> bool:
+        # Check whether any parent has been cancelled
+        cancel_scope = self._parent_scope
+        while cancel_scope is not None and not cancel_scope._shield:
+            if cancel_scope._cancel_called:
+                return True
+            else:
+                cancel_scope = cancel_scope._parent_scope
+
+        return False
+
+    def cancel(self) -> None:
+        if not self._cancel_called:
+            if self._timeout_handle:
+                self._timeout_handle.cancel()
+                self._timeout_handle = None
+
+            self._cancel_called = True
+            if self._host_task is not None:
+                self._deliver_cancellation(self)
+
+    @property
+    def deadline(self) -> float:
+        return self._deadline
+
+    @deadline.setter
+    def deadline(self, value: float) -> None:
+        self._deadline = float(value)
+        if self._timeout_handle is not None:
+            self._timeout_handle.cancel()
+            self._timeout_handle = None
+
+        if self._active and not self._cancel_called:
+            self._timeout()
+
+    @property
+    def cancel_called(self) -> bool:
+        return self._cancel_called
+
+    @property
+    def cancelled_caught(self) -> bool:
+        return self._cancelled_caught
+
+    @property
+    def shield(self) -> bool:
+        return self._shield
+
+    @shield.setter
+    def shield(self, value: bool) -> None:
+        if self._shield != value:
+            self._shield = value
+            if not value:
+                self._restart_cancellation_in_parent()
+
+
+#
+# Task states
+#
+
+
+class TaskState:
+    """
+    Encapsulates auxiliary task information that cannot be added to the Task instance
+    itself because there are no guarantees about its implementation.
+    """
+
+    __slots__ = "parent_id", "cancel_scope"
+
+    def __init__(self, parent_id: int | None, cancel_scope: CancelScope | None):
+        self.parent_id = parent_id
+        self.cancel_scope = cancel_scope
+
+
+_task_states = WeakKeyDictionary()  # type: WeakKeyDictionary[asyncio.Task, TaskState]
+
+
+#
+# Task groups
+#
+
+
+class _AsyncioTaskStatus(abc.TaskStatus):
+    def __init__(self, future: asyncio.Future, parent_id: int):
+        self._future = future
+        self._parent_id = parent_id
+
+    def started(self, value: T_contra | None = None) -> None:
+        try:
+            self._future.set_result(value)
+        except asyncio.InvalidStateError:
+            raise RuntimeError(
+                "called 'started' twice on the same task status"
+            ) from None
+
+        task = cast(asyncio.Task, current_task())
+        _task_states[task].parent_id = self._parent_id
+
+
+def iterate_exceptions(
+    exception: BaseException,
+) -> Generator[BaseException, None, None]:
+    if isinstance(exception, BaseExceptionGroup):
+        for exc in exception.exceptions:
+            yield from iterate_exceptions(exc)
+    else:
+        yield exception
+
+
+class TaskGroup(abc.TaskGroup):
+    def __init__(self) -> None:
+        self.cancel_scope: CancelScope = CancelScope()
+        self._active = False
+        self._exceptions: list[BaseException] = []
+        self._tasks: set[asyncio.Task] = set()
+
+    async def __aenter__(self) -> TaskGroup:
+        self.cancel_scope.__enter__()
+        self._active = True
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
+        ignore_exception = self.cancel_scope.__exit__(exc_type, exc_val, exc_tb)
+        if exc_val is not None:
+            self.cancel_scope.cancel()
+            if not isinstance(exc_val, CancelledError):
+                self._exceptions.append(exc_val)
+
+        cancelled_exc_while_waiting_tasks: CancelledError | None = None
+        while self._tasks:
+            try:
+                await asyncio.wait(self._tasks)
+            except CancelledError as exc:
+                # This task was cancelled natively; reraise the CancelledError later
+                # unless this task was already interrupted by another exception
+                self.cancel_scope.cancel()
+                if cancelled_exc_while_waiting_tasks is None:
+                    cancelled_exc_while_waiting_tasks = exc
+
+        self._active = False
+        if self._exceptions:
+            raise BaseExceptionGroup(
+                "unhandled errors in a TaskGroup", self._exceptions
+            )
+
+        # Raise the CancelledError received while waiting for child tasks to exit,
+        # unless the context manager itself was previously exited with another
+        # exception, or if any of the  child tasks raised an exception other than
+        # CancelledError
+        if cancelled_exc_while_waiting_tasks:
+            if exc_val is None or ignore_exception:
+                raise cancelled_exc_while_waiting_tasks
+
+        return ignore_exception
+
+    def _spawn(
+        self,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[Any]],
+        args: tuple[Unpack[PosArgsT]],
+        name: object,
+        task_status_future: asyncio.Future | None = None,
+    ) -> asyncio.Task:
+        def task_done(_task: asyncio.Task) -> None:
+            task_state = _task_states[_task]
+            assert task_state.cancel_scope is not None
+            assert _task in task_state.cancel_scope._tasks
+            task_state.cancel_scope._tasks.remove(_task)
+            self._tasks.remove(task)
+            del _task_states[_task]
+
+            try:
+                exc = _task.exception()
+            except CancelledError as e:
+                while isinstance(e.__context__, CancelledError):
+                    e = e.__context__
+
+                exc = e
+
+            if exc is not None:
+                if task_status_future is None or task_status_future.done():
+                    if not isinstance(exc, CancelledError):
+                        self._exceptions.append(exc)
+
+                    if not self.cancel_scope._parent_cancelled():
+                        self.cancel_scope.cancel()
+                else:
+                    task_status_future.set_exception(exc)
+            elif task_status_future is not None and not task_status_future.done():
+                task_status_future.set_exception(
+                    RuntimeError("Child exited without calling task_status.started()")
+                )
+
+        if not self._active:
+            raise RuntimeError(
+                "This task group is not active; no new tasks can be started."
+            )
+
+        kwargs = {}
+        if task_status_future:
+            parent_id = id(current_task())
+            kwargs["task_status"] = _AsyncioTaskStatus(
+                task_status_future, id(self.cancel_scope._host_task)
+            )
+        else:
+            parent_id = id(self.cancel_scope._host_task)
+
+        coro = func(*args, **kwargs)
+        if not iscoroutine(coro):
+            prefix = f"{func.__module__}." if hasattr(func, "__module__") else ""
+            raise TypeError(
+                f"Expected {prefix}{func.__qualname__}() to return a coroutine, but "
+                f"the return value ({coro!r}) is not a coroutine object"
+            )
+
+        name = get_callable_name(func) if name is None else str(name)
+        task = create_task(coro, name=name)
+        task.add_done_callback(task_done)
+
+        # Make the spawned task inherit the task group's cancel scope
+        _task_states[task] = TaskState(
+            parent_id=parent_id, cancel_scope=self.cancel_scope
+        )
+        self.cancel_scope._tasks.add(task)
+        self._tasks.add(task)
+        return task
+
+    def start_soon(
+        self,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[Any]],
+        *args: Unpack[PosArgsT],
+        name: object = None,
+    ) -> None:
+        self._spawn(func, args, name)
+
+    async def start(
+        self, func: Callable[..., Awaitable[Any]], *args: object, name: object = None
+    ) -> Any:
+        future: asyncio.Future = asyncio.Future()
+        task = self._spawn(func, args, name, future)
+
+        # If the task raises an exception after sending a start value without a switch
+        # point between, the task group is cancelled and this method never proceeds to
+        # process the completed future. That's why we have to have a shielded cancel
+        # scope here.
+        try:
+            return await future
+        except CancelledError:
+            # Cancel the task and wait for it to exit before returning
+            task.cancel()
+            with CancelScope(shield=True), suppress(CancelledError):
+                await task
+
+            raise
+
+
+#
+# Threads
+#
+
+_Retval_Queue_Type = Tuple[Optional[T_Retval], Optional[BaseException]]
+
+
+class WorkerThread(Thread):
+    MAX_IDLE_TIME = 10  # seconds
+
+    def __init__(
+        self,
+        root_task: asyncio.Task,
+        workers: set[WorkerThread],
+        idle_workers: deque[WorkerThread],
+    ):
+        super().__init__(name="AnyIO worker thread")
+        self.root_task = root_task
+        self.workers = workers
+        self.idle_workers = idle_workers
+        self.loop = root_task._loop
+        self.queue: Queue[
+            tuple[Context, Callable, tuple, asyncio.Future, CancelScope] | None
+        ] = Queue(2)
+        self.idle_since = AsyncIOBackend.current_time()
+        self.stopping = False
+
+    def _report_result(
+        self, future: asyncio.Future, result: Any, exc: BaseException | None
+    ) -> None:
+        self.idle_since = AsyncIOBackend.current_time()
+        if not self.stopping:
+            self.idle_workers.append(self)
+
+        if not future.cancelled():
+            if exc is not None:
+                if isinstance(exc, StopIteration):
+                    new_exc = RuntimeError("coroutine raised StopIteration")
+                    new_exc.__cause__ = exc
+                    exc = new_exc
+
+                future.set_exception(exc)
+            else:
+                future.set_result(result)
+
+    def run(self) -> None:
+        with claim_worker_thread(AsyncIOBackend, self.loop):
+            while True:
+                item = self.queue.get()
+                if item is None:
+                    # Shutdown command received
+                    return
+
+                context, func, args, future, cancel_scope = item
+                if not future.cancelled():
+                    result = None
+                    exception: BaseException | None = None
+                    threadlocals.current_cancel_scope = cancel_scope
+                    try:
+                        result = context.run(func, *args)
+                    except BaseException as exc:
+                        exception = exc
+                    finally:
+                        del threadlocals.current_cancel_scope
+
+                    if not self.loop.is_closed():
+                        self.loop.call_soon_threadsafe(
+                            self._report_result, future, result, exception
+                        )
+
+                self.queue.task_done()
+
+    def stop(self, f: asyncio.Task | None = None) -> None:
+        self.stopping = True
+        self.queue.put_nowait(None)
+        self.workers.discard(self)
+        try:
+            self.idle_workers.remove(self)
+        except ValueError:
+            pass
+
+
+_threadpool_idle_workers: RunVar[deque[WorkerThread]] = RunVar(
+    "_threadpool_idle_workers"
+)
+_threadpool_workers: RunVar[set[WorkerThread]] = RunVar("_threadpool_workers")
+
+
+class BlockingPortal(abc.BlockingPortal):
+    def __new__(cls) -> BlockingPortal:
+        return object.__new__(cls)
+
+    def __init__(self) -> None:
+        super().__init__()
+        self._loop = get_running_loop()
+
+    def _spawn_task_from_thread(
+        self,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval] | T_Retval],
+        args: tuple[Unpack[PosArgsT]],
+        kwargs: dict[str, Any],
+        name: object,
+        future: Future[T_Retval],
+    ) -> None:
+        AsyncIOBackend.run_sync_from_thread(
+            partial(self._task_group.start_soon, name=name),
+            (self._call_func, func, args, kwargs, future),
+            self._loop,
+        )
+
+
+#
+# Subprocesses
+#
+
+
+@dataclass(eq=False)
+class StreamReaderWrapper(abc.ByteReceiveStream):
+    _stream: asyncio.StreamReader
+
+    async def receive(self, max_bytes: int = 65536) -> bytes:
+        data = await self._stream.read(max_bytes)
+        if data:
+            return data
+        else:
+            raise EndOfStream
+
+    async def aclose(self) -> None:
+        self._stream.feed_eof()
+        await AsyncIOBackend.checkpoint()
+
+
+@dataclass(eq=False)
+class StreamWriterWrapper(abc.ByteSendStream):
+    _stream: asyncio.StreamWriter
+
+    async def send(self, item: bytes) -> None:
+        self._stream.write(item)
+        await self._stream.drain()
+
+    async def aclose(self) -> None:
+        self._stream.close()
+        await AsyncIOBackend.checkpoint()
+
+
+@dataclass(eq=False)
+class Process(abc.Process):
+    _process: asyncio.subprocess.Process
+    _stdin: StreamWriterWrapper | None
+    _stdout: StreamReaderWrapper | None
+    _stderr: StreamReaderWrapper | None
+
+    async def aclose(self) -> None:
+        with CancelScope(shield=True):
+            if self._stdin:
+                await self._stdin.aclose()
+            if self._stdout:
+                await self._stdout.aclose()
+            if self._stderr:
+                await self._stderr.aclose()
+
+        try:
+            await self.wait()
+        except BaseException:
+            self.kill()
+            with CancelScope(shield=True):
+                await self.wait()
+
+            raise
+
+    async def wait(self) -> int:
+        return await self._process.wait()
+
+    def terminate(self) -> None:
+        self._process.terminate()
+
+    def kill(self) -> None:
+        self._process.kill()
+
+    def send_signal(self, signal: int) -> None:
+        self._process.send_signal(signal)
+
+    @property
+    def pid(self) -> int:
+        return self._process.pid
+
+    @property
+    def returncode(self) -> int | None:
+        return self._process.returncode
+
+    @property
+    def stdin(self) -> abc.ByteSendStream | None:
+        return self._stdin
+
+    @property
+    def stdout(self) -> abc.ByteReceiveStream | None:
+        return self._stdout
+
+    @property
+    def stderr(self) -> abc.ByteReceiveStream | None:
+        return self._stderr
+
+
+def _forcibly_shutdown_process_pool_on_exit(
+    workers: set[Process], _task: object
+) -> None:
+    """
+    Forcibly shuts down worker processes belonging to this event loop."""
+    child_watcher: asyncio.AbstractChildWatcher | None = None
+    if sys.version_info < (3, 12):
+        try:
+            child_watcher = asyncio.get_event_loop_policy().get_child_watcher()
+        except NotImplementedError:
+            pass
+
+    # Close as much as possible (w/o async/await) to avoid warnings
+    for process in workers:
+        if process.returncode is None:
+            continue
+
+        process._stdin._stream._transport.close()  # type: ignore[union-attr]
+        process._stdout._stream._transport.close()  # type: ignore[union-attr]
+        process._stderr._stream._transport.close()  # type: ignore[union-attr]
+        process.kill()
+        if child_watcher:
+            child_watcher.remove_child_handler(process.pid)
+
+
+async def _shutdown_process_pool_on_exit(workers: set[abc.Process]) -> None:
+    """
+    Shuts down worker processes belonging to this event loop.
+
+    NOTE: this only works when the event loop was started using asyncio.run() or
+    anyio.run().
+
+    """
+    process: abc.Process
+    try:
+        await sleep(math.inf)
+    except asyncio.CancelledError:
+        for process in workers:
+            if process.returncode is None:
+                process.kill()
+
+        for process in workers:
+            await process.aclose()
+
+
+#
+# Sockets and networking
+#
+
+
+class StreamProtocol(asyncio.Protocol):
+    read_queue: deque[bytes]
+    read_event: asyncio.Event
+    write_event: asyncio.Event
+    exception: Exception | None = None
+
+    def connection_made(self, transport: asyncio.BaseTransport) -> None:
+        self.read_queue = deque()
+        self.read_event = asyncio.Event()
+        self.write_event = asyncio.Event()
+        self.write_event.set()
+        cast(asyncio.Transport, transport).set_write_buffer_limits(0)
+
+    def connection_lost(self, exc: Exception | None) -> None:
+        if exc:
+            self.exception = BrokenResourceError()
+            self.exception.__cause__ = exc
+
+        self.read_event.set()
+        self.write_event.set()
+
+    def data_received(self, data: bytes) -> None:
+        self.read_queue.append(data)
+        self.read_event.set()
+
+    def eof_received(self) -> bool | None:
+        self.read_event.set()
+        return True
+
+    def pause_writing(self) -> None:
+        self.write_event = asyncio.Event()
+
+    def resume_writing(self) -> None:
+        self.write_event.set()
+
+
+class DatagramProtocol(asyncio.DatagramProtocol):
+    read_queue: deque[tuple[bytes, IPSockAddrType]]
+    read_event: asyncio.Event
+    write_event: asyncio.Event
+    exception: Exception | None = None
+
+    def connection_made(self, transport: asyncio.BaseTransport) -> None:
+        self.read_queue = deque(maxlen=100)  # arbitrary value
+        self.read_event = asyncio.Event()
+        self.write_event = asyncio.Event()
+        self.write_event.set()
+
+    def connection_lost(self, exc: Exception | None) -> None:
+        self.read_event.set()
+        self.write_event.set()
+
+    def datagram_received(self, data: bytes, addr: IPSockAddrType) -> None:
+        addr = convert_ipv6_sockaddr(addr)
+        self.read_queue.append((data, addr))
+        self.read_event.set()
+
+    def error_received(self, exc: Exception) -> None:
+        self.exception = exc
+
+    def pause_writing(self) -> None:
+        self.write_event.clear()
+
+    def resume_writing(self) -> None:
+        self.write_event.set()
+
+
+class SocketStream(abc.SocketStream):
+    def __init__(self, transport: asyncio.Transport, protocol: StreamProtocol):
+        self._transport = transport
+        self._protocol = protocol
+        self._receive_guard = ResourceGuard("reading from")
+        self._send_guard = ResourceGuard("writing to")
+        self._closed = False
+
+    @property
+    def _raw_socket(self) -> socket.socket:
+        return self._transport.get_extra_info("socket")
+
+    async def receive(self, max_bytes: int = 65536) -> bytes:
+        with self._receive_guard:
+            await AsyncIOBackend.checkpoint()
+
+            if (
+                not self._protocol.read_event.is_set()
+                and not self._transport.is_closing()
+            ):
+                self._transport.resume_reading()
+                await self._protocol.read_event.wait()
+                self._transport.pause_reading()
+
+            try:
+                chunk = self._protocol.read_queue.popleft()
+            except IndexError:
+                if self._closed:
+                    raise ClosedResourceError from None
+                elif self._protocol.exception:
+                    raise self._protocol.exception from None
+                else:
+                    raise EndOfStream from None
+
+            if len(chunk) > max_bytes:
+                # Split the oversized chunk
+                chunk, leftover = chunk[:max_bytes], chunk[max_bytes:]
+                self._protocol.read_queue.appendleft(leftover)
+
+            # If the read queue is empty, clear the flag so that the next call will
+            # block until data is available
+            if not self._protocol.read_queue:
+                self._protocol.read_event.clear()
+
+        return chunk
+
+    async def send(self, item: bytes) -> None:
+        with self._send_guard:
+            await AsyncIOBackend.checkpoint()
+
+            if self._closed:
+                raise ClosedResourceError
+            elif self._protocol.exception is not None:
+                raise self._protocol.exception
+
+            try:
+                self._transport.write(item)
+            except RuntimeError as exc:
+                if self._transport.is_closing():
+                    raise BrokenResourceError from exc
+                else:
+                    raise
+
+            await self._protocol.write_event.wait()
+
+    async def send_eof(self) -> None:
+        try:
+            self._transport.write_eof()
+        except OSError:
+            pass
+
+    async def aclose(self) -> None:
+        if not self._transport.is_closing():
+            self._closed = True
+            try:
+                self._transport.write_eof()
+            except OSError:
+                pass
+
+            self._transport.close()
+            await sleep(0)
+            self._transport.abort()
+
+
+class _RawSocketMixin:
+    _receive_future: asyncio.Future | None = None
+    _send_future: asyncio.Future | None = None
+    _closing = False
+
+    def __init__(self, raw_socket: socket.socket):
+        self.__raw_socket = raw_socket
+        self._receive_guard = ResourceGuard("reading from")
+        self._send_guard = ResourceGuard("writing to")
+
+    @property
+    def _raw_socket(self) -> socket.socket:
+        return self.__raw_socket
+
+    def _wait_until_readable(self, loop: asyncio.AbstractEventLoop) -> asyncio.Future:
+        def callback(f: object) -> None:
+            del self._receive_future
+            loop.remove_reader(self.__raw_socket)
+
+        f = self._receive_future = asyncio.Future()
+        loop.add_reader(self.__raw_socket, f.set_result, None)
+        f.add_done_callback(callback)
+        return f
+
+    def _wait_until_writable(self, loop: asyncio.AbstractEventLoop) -> asyncio.Future:
+        def callback(f: object) -> None:
+            del self._send_future
+            loop.remove_writer(self.__raw_socket)
+
+        f = self._send_future = asyncio.Future()
+        loop.add_writer(self.__raw_socket, f.set_result, None)
+        f.add_done_callback(callback)
+        return f
+
+    async def aclose(self) -> None:
+        if not self._closing:
+            self._closing = True
+            if self.__raw_socket.fileno() != -1:
+                self.__raw_socket.close()
+
+            if self._receive_future:
+                self._receive_future.set_result(None)
+            if self._send_future:
+                self._send_future.set_result(None)
+
+
+class UNIXSocketStream(_RawSocketMixin, abc.UNIXSocketStream):
+    async def send_eof(self) -> None:
+        with self._send_guard:
+            self._raw_socket.shutdown(socket.SHUT_WR)
+
+    async def receive(self, max_bytes: int = 65536) -> bytes:
+        loop = get_running_loop()
+        await AsyncIOBackend.checkpoint()
+        with self._receive_guard:
+            while True:
+                try:
+                    data = self._raw_socket.recv(max_bytes)
+                except BlockingIOError:
+                    await self._wait_until_readable(loop)
+                except OSError as exc:
+                    if self._closing:
+                        raise ClosedResourceError from None
+                    else:
+                        raise BrokenResourceError from exc
+                else:
+                    if not data:
+                        raise EndOfStream
+
+                    return data
+
+    async def send(self, item: bytes) -> None:
+        loop = get_running_loop()
+        await AsyncIOBackend.checkpoint()
+        with self._send_guard:
+            view = memoryview(item)
+            while view:
+                try:
+                    bytes_sent = self._raw_socket.send(view)
+                except BlockingIOError:
+                    await self._wait_until_writable(loop)
+                except OSError as exc:
+                    if self._closing:
+                        raise ClosedResourceError from None
+                    else:
+                        raise BrokenResourceError from exc
+                else:
+                    view = view[bytes_sent:]
+
+    async def receive_fds(self, msglen: int, maxfds: int) -> tuple[bytes, list[int]]:
+        if not isinstance(msglen, int) or msglen < 0:
+            raise ValueError("msglen must be a non-negative integer")
+        if not isinstance(maxfds, int) or maxfds < 1:
+            raise ValueError("maxfds must be a positive integer")
+
+        loop = get_running_loop()
+        fds = array.array("i")
+        await AsyncIOBackend.checkpoint()
+        with self._receive_guard:
+            while True:
+                try:
+                    message, ancdata, flags, addr = self._raw_socket.recvmsg(
+                        msglen, socket.CMSG_LEN(maxfds * fds.itemsize)
+                    )
+                except BlockingIOError:
+                    await self._wait_until_readable(loop)
+                except OSError as exc:
+                    if self._closing:
+                        raise ClosedResourceError from None
+                    else:
+                        raise BrokenResourceError from exc
+                else:
+                    if not message and not ancdata:
+                        raise EndOfStream
+
+                    break
+
+        for cmsg_level, cmsg_type, cmsg_data in ancdata:
+            if cmsg_level != socket.SOL_SOCKET or cmsg_type != socket.SCM_RIGHTS:
+                raise RuntimeError(
+                    f"Received unexpected ancillary data; message = {message!r}, "
+                    f"cmsg_level = {cmsg_level}, cmsg_type = {cmsg_type}"
+                )
+
+            fds.frombytes(cmsg_data[: len(cmsg_data) - (len(cmsg_data) % fds.itemsize)])
+
+        return message, list(fds)
+
+    async def send_fds(self, message: bytes, fds: Collection[int | IOBase]) -> None:
+        if not message:
+            raise ValueError("message must not be empty")
+        if not fds:
+            raise ValueError("fds must not be empty")
+
+        loop = get_running_loop()
+        filenos: list[int] = []
+        for fd in fds:
+            if isinstance(fd, int):
+                filenos.append(fd)
+            elif isinstance(fd, IOBase):
+                filenos.append(fd.fileno())
+
+        fdarray = array.array("i", filenos)
+        await AsyncIOBackend.checkpoint()
+        with self._send_guard:
+            while True:
+                try:
+                    # The ignore can be removed after mypy picks up
+                    # https://github.com/python/typeshed/pull/5545
+                    self._raw_socket.sendmsg(
+                        [message], [(socket.SOL_SOCKET, socket.SCM_RIGHTS, fdarray)]
+                    )
+                    break
+                except BlockingIOError:
+                    await self._wait_until_writable(loop)
+                except OSError as exc:
+                    if self._closing:
+                        raise ClosedResourceError from None
+                    else:
+                        raise BrokenResourceError from exc
+
+
+class TCPSocketListener(abc.SocketListener):
+    _accept_scope: CancelScope | None = None
+    _closed = False
+
+    def __init__(self, raw_socket: socket.socket):
+        self.__raw_socket = raw_socket
+        self._loop = cast(asyncio.BaseEventLoop, get_running_loop())
+        self._accept_guard = ResourceGuard("accepting connections from")
+
+    @property
+    def _raw_socket(self) -> socket.socket:
+        return self.__raw_socket
+
+    async def accept(self) -> abc.SocketStream:
+        if self._closed:
+            raise ClosedResourceError
+
+        with self._accept_guard:
+            await AsyncIOBackend.checkpoint()
+            with CancelScope() as self._accept_scope:
+                try:
+                    client_sock, _addr = await self._loop.sock_accept(self._raw_socket)
+                except asyncio.CancelledError:
+                    # Workaround for https://bugs.python.org/issue41317
+                    try:
+                        self._loop.remove_reader(self._raw_socket)
+                    except (ValueError, NotImplementedError):
+                        pass
+
+                    if self._closed:
+                        raise ClosedResourceError from None
+
+                    raise
+                finally:
+                    self._accept_scope = None
+
+        client_sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
+        transport, protocol = await self._loop.connect_accepted_socket(
+            StreamProtocol, client_sock
+        )
+        return SocketStream(transport, protocol)
+
+    async def aclose(self) -> None:
+        if self._closed:
+            return
+
+        self._closed = True
+        if self._accept_scope:
+            # Workaround for https://bugs.python.org/issue41317
+            try:
+                self._loop.remove_reader(self._raw_socket)
+            except (ValueError, NotImplementedError):
+                pass
+
+            self._accept_scope.cancel()
+            await sleep(0)
+
+        self._raw_socket.close()
+
+
+class UNIXSocketListener(abc.SocketListener):
+    def __init__(self, raw_socket: socket.socket):
+        self.__raw_socket = raw_socket
+        self._loop = get_running_loop()
+        self._accept_guard = ResourceGuard("accepting connections from")
+        self._closed = False
+
+    async def accept(self) -> abc.SocketStream:
+        await AsyncIOBackend.checkpoint()
+        with self._accept_guard:
+            while True:
+                try:
+                    client_sock, _ = self.__raw_socket.accept()
+                    client_sock.setblocking(False)
+                    return UNIXSocketStream(client_sock)
+                except BlockingIOError:
+                    f: asyncio.Future = asyncio.Future()
+                    self._loop.add_reader(self.__raw_socket, f.set_result, None)
+                    f.add_done_callback(
+                        lambda _: self._loop.remove_reader(self.__raw_socket)
+                    )
+                    await f
+                except OSError as exc:
+                    if self._closed:
+                        raise ClosedResourceError from None
+                    else:
+                        raise BrokenResourceError from exc
+
+    async def aclose(self) -> None:
+        self._closed = True
+        self.__raw_socket.close()
+
+    @property
+    def _raw_socket(self) -> socket.socket:
+        return self.__raw_socket
+
+
+class UDPSocket(abc.UDPSocket):
+    def __init__(
+        self, transport: asyncio.DatagramTransport, protocol: DatagramProtocol
+    ):
+        self._transport = transport
+        self._protocol = protocol
+        self._receive_guard = ResourceGuard("reading from")
+        self._send_guard = ResourceGuard("writing to")
+        self._closed = False
+
+    @property
+    def _raw_socket(self) -> socket.socket:
+        return self._transport.get_extra_info("socket")
+
+    async def aclose(self) -> None:
+        if not self._transport.is_closing():
+            self._closed = True
+            self._transport.close()
+
+    async def receive(self) -> tuple[bytes, IPSockAddrType]:
+        with self._receive_guard:
+            await AsyncIOBackend.checkpoint()
+
+            # If the buffer is empty, ask for more data
+            if not self._protocol.read_queue and not self._transport.is_closing():
+                self._protocol.read_event.clear()
+                await self._protocol.read_event.wait()
+
+            try:
+                return self._protocol.read_queue.popleft()
+            except IndexError:
+                if self._closed:
+                    raise ClosedResourceError from None
+                else:
+                    raise BrokenResourceError from None
+
+    async def send(self, item: UDPPacketType) -> None:
+        with self._send_guard:
+            await AsyncIOBackend.checkpoint()
+            await self._protocol.write_event.wait()
+            if self._closed:
+                raise ClosedResourceError
+            elif self._transport.is_closing():
+                raise BrokenResourceError
+            else:
+                self._transport.sendto(*item)
+
+
+class ConnectedUDPSocket(abc.ConnectedUDPSocket):
+    def __init__(
+        self, transport: asyncio.DatagramTransport, protocol: DatagramProtocol
+    ):
+        self._transport = transport
+        self._protocol = protocol
+        self._receive_guard = ResourceGuard("reading from")
+        self._send_guard = ResourceGuard("writing to")
+        self._closed = False
+
+    @property
+    def _raw_socket(self) -> socket.socket:
+        return self._transport.get_extra_info("socket")
+
+    async def aclose(self) -> None:
+        if not self._transport.is_closing():
+            self._closed = True
+            self._transport.close()
+
+    async def receive(self) -> bytes:
+        with self._receive_guard:
+            await AsyncIOBackend.checkpoint()
+
+            # If the buffer is empty, ask for more data
+            if not self._protocol.read_queue and not self._transport.is_closing():
+                self._protocol.read_event.clear()
+                await self._protocol.read_event.wait()
+
+            try:
+                packet = self._protocol.read_queue.popleft()
+            except IndexError:
+                if self._closed:
+                    raise ClosedResourceError from None
+                else:
+                    raise BrokenResourceError from None
+
+            return packet[0]
+
+    async def send(self, item: bytes) -> None:
+        with self._send_guard:
+            await AsyncIOBackend.checkpoint()
+            await self._protocol.write_event.wait()
+            if self._closed:
+                raise ClosedResourceError
+            elif self._transport.is_closing():
+                raise BrokenResourceError
+            else:
+                self._transport.sendto(item)
+
+
+class UNIXDatagramSocket(_RawSocketMixin, abc.UNIXDatagramSocket):
+    async def receive(self) -> UNIXDatagramPacketType:
+        loop = get_running_loop()
+        await AsyncIOBackend.checkpoint()
+        with self._receive_guard:
+            while True:
+                try:
+                    data = self._raw_socket.recvfrom(65536)
+                except BlockingIOError:
+                    await self._wait_until_readable(loop)
+                except OSError as exc:
+                    if self._closing:
+                        raise ClosedResourceError from None
+                    else:
+                        raise BrokenResourceError from exc
+                else:
+                    return data
+
+    async def send(self, item: UNIXDatagramPacketType) -> None:
+        loop = get_running_loop()
+        await AsyncIOBackend.checkpoint()
+        with self._send_guard:
+            while True:
+                try:
+                    self._raw_socket.sendto(*item)
+                except BlockingIOError:
+                    await self._wait_until_writable(loop)
+                except OSError as exc:
+                    if self._closing:
+                        raise ClosedResourceError from None
+                    else:
+                        raise BrokenResourceError from exc
+                else:
+                    return
+
+
+class ConnectedUNIXDatagramSocket(_RawSocketMixin, abc.ConnectedUNIXDatagramSocket):
+    async def receive(self) -> bytes:
+        loop = get_running_loop()
+        await AsyncIOBackend.checkpoint()
+        with self._receive_guard:
+            while True:
+                try:
+                    data = self._raw_socket.recv(65536)
+                except BlockingIOError:
+                    await self._wait_until_readable(loop)
+                except OSError as exc:
+                    if self._closing:
+                        raise ClosedResourceError from None
+                    else:
+                        raise BrokenResourceError from exc
+                else:
+                    return data
+
+    async def send(self, item: bytes) -> None:
+        loop = get_running_loop()
+        await AsyncIOBackend.checkpoint()
+        with self._send_guard:
+            while True:
+                try:
+                    self._raw_socket.send(item)
+                except BlockingIOError:
+                    await self._wait_until_writable(loop)
+                except OSError as exc:
+                    if self._closing:
+                        raise ClosedResourceError from None
+                    else:
+                        raise BrokenResourceError from exc
+                else:
+                    return
+
+
+_read_events: RunVar[dict[Any, asyncio.Event]] = RunVar("read_events")
+_write_events: RunVar[dict[Any, asyncio.Event]] = RunVar("write_events")
+
+
+#
+# Synchronization
+#
+
+
+class Event(BaseEvent):
+    def __new__(cls) -> Event:
+        return object.__new__(cls)
+
+    def __init__(self) -> None:
+        self._event = asyncio.Event()
+
+    def set(self) -> None:
+        self._event.set()
+
+    def is_set(self) -> bool:
+        return self._event.is_set()
+
+    async def wait(self) -> None:
+        if self.is_set():
+            await AsyncIOBackend.checkpoint()
+        else:
+            await self._event.wait()
+
+    def statistics(self) -> EventStatistics:
+        return EventStatistics(len(self._event._waiters))  # type: ignore[attr-defined]
+
+
+class CapacityLimiter(BaseCapacityLimiter):
+    _total_tokens: float = 0
+
+    def __new__(cls, total_tokens: float) -> CapacityLimiter:
+        return object.__new__(cls)
+
+    def __init__(self, total_tokens: float):
+        self._borrowers: set[Any] = set()
+        self._wait_queue: OrderedDict[Any, asyncio.Event] = OrderedDict()
+        self.total_tokens = total_tokens
+
+    async def __aenter__(self) -> None:
+        await self.acquire()
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> None:
+        self.release()
+
+    @property
+    def total_tokens(self) -> float:
+        return self._total_tokens
+
+    @total_tokens.setter
+    def total_tokens(self, value: float) -> None:
+        if not isinstance(value, int) and not math.isinf(value):
+            raise TypeError("total_tokens must be an int or math.inf")
+        if value < 1:
+            raise ValueError("total_tokens must be >= 1")
+
+        waiters_to_notify = max(value - self._total_tokens, 0)
+        self._total_tokens = value
+
+        # Notify waiting tasks that they have acquired the limiter
+        while self._wait_queue and waiters_to_notify:
+            event = self._wait_queue.popitem(last=False)[1]
+            event.set()
+            waiters_to_notify -= 1
+
+    @property
+    def borrowed_tokens(self) -> int:
+        return len(self._borrowers)
+
+    @property
+    def available_tokens(self) -> float:
+        return self._total_tokens - len(self._borrowers)
+
+    def acquire_nowait(self) -> None:
+        self.acquire_on_behalf_of_nowait(current_task())
+
+    def acquire_on_behalf_of_nowait(self, borrower: object) -> None:
+        if borrower in self._borrowers:
+            raise RuntimeError(
+                "this borrower is already holding one of this CapacityLimiter's "
+                "tokens"
+            )
+
+        if self._wait_queue or len(self._borrowers) >= self._total_tokens:
+            raise WouldBlock
+
+        self._borrowers.add(borrower)
+
+    async def acquire(self) -> None:
+        return await self.acquire_on_behalf_of(current_task())
+
+    async def acquire_on_behalf_of(self, borrower: object) -> None:
+        await AsyncIOBackend.checkpoint_if_cancelled()
+        try:
+            self.acquire_on_behalf_of_nowait(borrower)
+        except WouldBlock:
+            event = asyncio.Event()
+            self._wait_queue[borrower] = event
+            try:
+                await event.wait()
+            except BaseException:
+                self._wait_queue.pop(borrower, None)
+                raise
+
+            self._borrowers.add(borrower)
+        else:
+            try:
+                await AsyncIOBackend.cancel_shielded_checkpoint()
+            except BaseException:
+                self.release()
+                raise
+
+    def release(self) -> None:
+        self.release_on_behalf_of(current_task())
+
+    def release_on_behalf_of(self, borrower: object) -> None:
+        try:
+            self._borrowers.remove(borrower)
+        except KeyError:
+            raise RuntimeError(
+                "this borrower isn't holding any of this CapacityLimiter's " "tokens"
+            ) from None
+
+        # Notify the next task in line if this limiter has free capacity now
+        if self._wait_queue and len(self._borrowers) < self._total_tokens:
+            event = self._wait_queue.popitem(last=False)[1]
+            event.set()
+
+    def statistics(self) -> CapacityLimiterStatistics:
+        return CapacityLimiterStatistics(
+            self.borrowed_tokens,
+            self.total_tokens,
+            tuple(self._borrowers),
+            len(self._wait_queue),
+        )
+
+
+_default_thread_limiter: RunVar[CapacityLimiter] = RunVar("_default_thread_limiter")
+
+
+#
+# Operating system signals
+#
+
+
+class _SignalReceiver:
+    def __init__(self, signals: tuple[Signals, ...]):
+        self._signals = signals
+        self._loop = get_running_loop()
+        self._signal_queue: deque[Signals] = deque()
+        self._future: asyncio.Future = asyncio.Future()
+        self._handled_signals: set[Signals] = set()
+
+    def _deliver(self, signum: Signals) -> None:
+        self._signal_queue.append(signum)
+        if not self._future.done():
+            self._future.set_result(None)
+
+    def __enter__(self) -> _SignalReceiver:
+        for sig in set(self._signals):
+            self._loop.add_signal_handler(sig, self._deliver, sig)
+            self._handled_signals.add(sig)
+
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
+        for sig in self._handled_signals:
+            self._loop.remove_signal_handler(sig)
+        return None
+
+    def __aiter__(self) -> _SignalReceiver:
+        return self
+
+    async def __anext__(self) -> Signals:
+        await AsyncIOBackend.checkpoint()
+        if not self._signal_queue:
+            self._future = asyncio.Future()
+            await self._future
+
+        return self._signal_queue.popleft()
+
+
+#
+# Testing and debugging
+#
+
+
+def _create_task_info(task: asyncio.Task) -> TaskInfo:
+    task_state = _task_states.get(task)
+    if task_state is None:
+        parent_id = None
+    else:
+        parent_id = task_state.parent_id
+
+    return TaskInfo(id(task), parent_id, task.get_name(), task.get_coro())
+
+
+class TestRunner(abc.TestRunner):
+    _send_stream: MemoryObjectSendStream[tuple[Awaitable[Any], asyncio.Future[Any]]]
+
+    def __init__(
+        self,
+        *,
+        debug: bool | None = None,
+        use_uvloop: bool = False,
+        loop_factory: Callable[[], AbstractEventLoop] | None = None,
+    ) -> None:
+        if use_uvloop and loop_factory is None:
+            import uvloop
+
+            loop_factory = uvloop.new_event_loop
+
+        self._runner = Runner(debug=debug, loop_factory=loop_factory)
+        self._exceptions: list[BaseException] = []
+        self._runner_task: asyncio.Task | None = None
+
+    def __enter__(self) -> TestRunner:
+        self._runner.__enter__()
+        self.get_loop().set_exception_handler(self._exception_handler)
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> None:
+        self._runner.__exit__(exc_type, exc_val, exc_tb)
+
+    def get_loop(self) -> AbstractEventLoop:
+        return self._runner.get_loop()
+
+    def _exception_handler(
+        self, loop: asyncio.AbstractEventLoop, context: dict[str, Any]
+    ) -> None:
+        if isinstance(context.get("exception"), Exception):
+            self._exceptions.append(context["exception"])
+        else:
+            loop.default_exception_handler(context)
+
+    def _raise_async_exceptions(self) -> None:
+        # Re-raise any exceptions raised in asynchronous callbacks
+        if self._exceptions:
+            exceptions, self._exceptions = self._exceptions, []
+            if len(exceptions) == 1:
+                raise exceptions[0]
+            elif exceptions:
+                raise BaseExceptionGroup(
+                    "Multiple exceptions occurred in asynchronous callbacks", exceptions
+                )
+
+    @staticmethod
+    async def _run_tests_and_fixtures(
+        receive_stream: MemoryObjectReceiveStream[
+            tuple[Awaitable[T_Retval], asyncio.Future[T_Retval]]
+        ],
+    ) -> None:
+        with receive_stream:
+            async for coro, future in receive_stream:
+                try:
+                    retval = await coro
+                except BaseException as exc:
+                    if not future.cancelled():
+                        future.set_exception(exc)
+                else:
+                    if not future.cancelled():
+                        future.set_result(retval)
+
+    async def _call_in_runner_task(
+        self,
+        func: Callable[P, Awaitable[T_Retval]],
+        *args: P.args,
+        **kwargs: P.kwargs,
+    ) -> T_Retval:
+        if not self._runner_task:
+            self._send_stream, receive_stream = create_memory_object_stream[
+                Tuple[Awaitable[Any], asyncio.Future]
+            ](1)
+            self._runner_task = self.get_loop().create_task(
+                self._run_tests_and_fixtures(receive_stream)
+            )
+
+        coro = func(*args, **kwargs)
+        future: asyncio.Future[T_Retval] = self.get_loop().create_future()
+        self._send_stream.send_nowait((coro, future))
+        return await future
+
+    def run_asyncgen_fixture(
+        self,
+        fixture_func: Callable[..., AsyncGenerator[T_Retval, Any]],
+        kwargs: dict[str, Any],
+    ) -> Iterable[T_Retval]:
+        asyncgen = fixture_func(**kwargs)
+        fixturevalue: T_Retval = self.get_loop().run_until_complete(
+            self._call_in_runner_task(asyncgen.asend, None)
+        )
+        self._raise_async_exceptions()
+
+        yield fixturevalue
+
+        try:
+            self.get_loop().run_until_complete(
+                self._call_in_runner_task(asyncgen.asend, None)
+            )
+        except StopAsyncIteration:
+            self._raise_async_exceptions()
+        else:
+            self.get_loop().run_until_complete(asyncgen.aclose())
+            raise RuntimeError("Async generator fixture did not stop")
+
+    def run_fixture(
+        self,
+        fixture_func: Callable[..., Coroutine[Any, Any, T_Retval]],
+        kwargs: dict[str, Any],
+    ) -> T_Retval:
+        retval = self.get_loop().run_until_complete(
+            self._call_in_runner_task(fixture_func, **kwargs)
+        )
+        self._raise_async_exceptions()
+        return retval
+
+    def run_test(
+        self, test_func: Callable[..., Coroutine[Any, Any, Any]], kwargs: dict[str, Any]
+    ) -> None:
+        try:
+            self.get_loop().run_until_complete(
+                self._call_in_runner_task(test_func, **kwargs)
+            )
+        except Exception as exc:
+            self._exceptions.append(exc)
+
+        self._raise_async_exceptions()
+
+
+class AsyncIOBackend(AsyncBackend):
+    @classmethod
+    def run(
+        cls,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]],
+        args: tuple[Unpack[PosArgsT]],
+        kwargs: dict[str, Any],
+        options: dict[str, Any],
+    ) -> T_Retval:
+        @wraps(func)
+        async def wrapper() -> T_Retval:
+            task = cast(asyncio.Task, current_task())
+            task.set_name(get_callable_name(func))
+            _task_states[task] = TaskState(None, None)
+
+            try:
+                return await func(*args)
+            finally:
+                del _task_states[task]
+
+        debug = options.get("debug", False)
+        loop_factory = options.get("loop_factory", None)
+        if loop_factory is None and options.get("use_uvloop", False):
+            import uvloop
+
+            loop_factory = uvloop.new_event_loop
+
+        with Runner(debug=debug, loop_factory=loop_factory) as runner:
+            return runner.run(wrapper())
+
+    @classmethod
+    def current_token(cls) -> object:
+        return get_running_loop()
+
+    @classmethod
+    def current_time(cls) -> float:
+        return get_running_loop().time()
+
+    @classmethod
+    def cancelled_exception_class(cls) -> type[BaseException]:
+        return CancelledError
+
+    @classmethod
+    async def checkpoint(cls) -> None:
+        await sleep(0)
+
+    @classmethod
+    async def checkpoint_if_cancelled(cls) -> None:
+        task = current_task()
+        if task is None:
+            return
+
+        try:
+            cancel_scope = _task_states[task].cancel_scope
+        except KeyError:
+            return
+
+        while cancel_scope:
+            if cancel_scope.cancel_called:
+                await sleep(0)
+            elif cancel_scope.shield:
+                break
+            else:
+                cancel_scope = cancel_scope._parent_scope
+
+    @classmethod
+    async def cancel_shielded_checkpoint(cls) -> None:
+        with CancelScope(shield=True):
+            await sleep(0)
+
+    @classmethod
+    async def sleep(cls, delay: float) -> None:
+        await sleep(delay)
+
+    @classmethod
+    def create_cancel_scope(
+        cls, *, deadline: float = math.inf, shield: bool = False
+    ) -> CancelScope:
+        return CancelScope(deadline=deadline, shield=shield)
+
+    @classmethod
+    def current_effective_deadline(cls) -> float:
+        try:
+            cancel_scope = _task_states[
+                current_task()  # type: ignore[index]
+            ].cancel_scope
+        except KeyError:
+            return math.inf
+
+        deadline = math.inf
+        while cancel_scope:
+            deadline = min(deadline, cancel_scope.deadline)
+            if cancel_scope._cancel_called:
+                deadline = -math.inf
+                break
+            elif cancel_scope.shield:
+                break
+            else:
+                cancel_scope = cancel_scope._parent_scope
+
+        return deadline
+
+    @classmethod
+    def create_task_group(cls) -> abc.TaskGroup:
+        return TaskGroup()
+
+    @classmethod
+    def create_event(cls) -> abc.Event:
+        return Event()
+
+    @classmethod
+    def create_capacity_limiter(cls, total_tokens: float) -> abc.CapacityLimiter:
+        return CapacityLimiter(total_tokens)
+
+    @classmethod
+    async def run_sync_in_worker_thread(
+        cls,
+        func: Callable[[Unpack[PosArgsT]], T_Retval],
+        args: tuple[Unpack[PosArgsT]],
+        abandon_on_cancel: bool = False,
+        limiter: abc.CapacityLimiter | None = None,
+    ) -> T_Retval:
+        await cls.checkpoint()
+
+        # If this is the first run in this event loop thread, set up the necessary
+        # variables
+        try:
+            idle_workers = _threadpool_idle_workers.get()
+            workers = _threadpool_workers.get()
+        except LookupError:
+            idle_workers = deque()
+            workers = set()
+            _threadpool_idle_workers.set(idle_workers)
+            _threadpool_workers.set(workers)
+
+        async with limiter or cls.current_default_thread_limiter():
+            with CancelScope(shield=not abandon_on_cancel) as scope:
+                future: asyncio.Future = asyncio.Future()
+                root_task = find_root_task()
+                if not idle_workers:
+                    worker = WorkerThread(root_task, workers, idle_workers)
+                    worker.start()
+                    workers.add(worker)
+                    root_task.add_done_callback(worker.stop)
+                else:
+                    worker = idle_workers.pop()
+
+                    # Prune any other workers that have been idle for MAX_IDLE_TIME
+                    # seconds or longer
+                    now = cls.current_time()
+                    while idle_workers:
+                        if (
+                            now - idle_workers[0].idle_since
+                            < WorkerThread.MAX_IDLE_TIME
+                        ):
+                            break
+
+                        expired_worker = idle_workers.popleft()
+                        expired_worker.root_task.remove_done_callback(
+                            expired_worker.stop
+                        )
+                        expired_worker.stop()
+
+                context = copy_context()
+                context.run(sniffio.current_async_library_cvar.set, None)
+                if abandon_on_cancel or scope._parent_scope is None:
+                    worker_scope = scope
+                else:
+                    worker_scope = scope._parent_scope
+
+                worker.queue.put_nowait((context, func, args, future, worker_scope))
+                return await future
+
+    @classmethod
+    def check_cancelled(cls) -> None:
+        scope: CancelScope | None = threadlocals.current_cancel_scope
+        while scope is not None:
+            if scope.cancel_called:
+                raise CancelledError(f"Cancelled by cancel scope {id(scope):x}")
+
+            if scope.shield:
+                return
+
+            scope = scope._parent_scope
+
+    @classmethod
+    def run_async_from_thread(
+        cls,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]],
+        args: tuple[Unpack[PosArgsT]],
+        token: object,
+    ) -> T_Retval:
+        async def task_wrapper(scope: CancelScope) -> T_Retval:
+            __tracebackhide__ = True
+            task = cast(asyncio.Task, current_task())
+            _task_states[task] = TaskState(None, scope)
+            scope._tasks.add(task)
+            try:
+                return await func(*args)
+            except CancelledError as exc:
+                raise concurrent.futures.CancelledError(str(exc)) from None
+            finally:
+                scope._tasks.discard(task)
+
+        loop = cast(AbstractEventLoop, token)
+        context = copy_context()
+        context.run(sniffio.current_async_library_cvar.set, "asyncio")
+        wrapper = task_wrapper(threadlocals.current_cancel_scope)
+        f: concurrent.futures.Future[T_Retval] = context.run(
+            asyncio.run_coroutine_threadsafe, wrapper, loop
+        )
+        return f.result()
+
+    @classmethod
+    def run_sync_from_thread(
+        cls,
+        func: Callable[[Unpack[PosArgsT]], T_Retval],
+        args: tuple[Unpack[PosArgsT]],
+        token: object,
+    ) -> T_Retval:
+        @wraps(func)
+        def wrapper() -> None:
+            try:
+                sniffio.current_async_library_cvar.set("asyncio")
+                f.set_result(func(*args))
+            except BaseException as exc:
+                f.set_exception(exc)
+                if not isinstance(exc, Exception):
+                    raise
+
+        f: concurrent.futures.Future[T_Retval] = Future()
+        loop = cast(AbstractEventLoop, token)
+        loop.call_soon_threadsafe(wrapper)
+        return f.result()
+
+    @classmethod
+    def create_blocking_portal(cls) -> abc.BlockingPortal:
+        return BlockingPortal()
+
+    @classmethod
+    async def open_process(
+        cls,
+        command: str | bytes | Sequence[str | bytes],
+        *,
+        shell: bool,
+        stdin: int | IO[Any] | None,
+        stdout: int | IO[Any] | None,
+        stderr: int | IO[Any] | None,
+        cwd: str | bytes | PathLike | None = None,
+        env: Mapping[str, str] | None = None,
+        start_new_session: bool = False,
+    ) -> Process:
+        await cls.checkpoint()
+        if shell:
+            process = await asyncio.create_subprocess_shell(
+                cast("str | bytes", command),
+                stdin=stdin,
+                stdout=stdout,
+                stderr=stderr,
+                cwd=cwd,
+                env=env,
+                start_new_session=start_new_session,
+            )
+        else:
+            process = await asyncio.create_subprocess_exec(
+                *command,
+                stdin=stdin,
+                stdout=stdout,
+                stderr=stderr,
+                cwd=cwd,
+                env=env,
+                start_new_session=start_new_session,
+            )
+
+        stdin_stream = StreamWriterWrapper(process.stdin) if process.stdin else None
+        stdout_stream = StreamReaderWrapper(process.stdout) if process.stdout else None
+        stderr_stream = StreamReaderWrapper(process.stderr) if process.stderr else None
+        return Process(process, stdin_stream, stdout_stream, stderr_stream)
+
+    @classmethod
+    def setup_process_pool_exit_at_shutdown(cls, workers: set[abc.Process]) -> None:
+        create_task(
+            _shutdown_process_pool_on_exit(workers),
+            name="AnyIO process pool shutdown task",
+        )
+        find_root_task().add_done_callback(
+            partial(_forcibly_shutdown_process_pool_on_exit, workers)
+        )
+
+    @classmethod
+    async def connect_tcp(
+        cls, host: str, port: int, local_address: IPSockAddrType | None = None
+    ) -> abc.SocketStream:
+        transport, protocol = cast(
+            Tuple[asyncio.Transport, StreamProtocol],
+            await get_running_loop().create_connection(
+                StreamProtocol, host, port, local_addr=local_address
+            ),
+        )
+        transport.pause_reading()
+        return SocketStream(transport, protocol)
+
+    @classmethod
+    async def connect_unix(cls, path: str | bytes) -> abc.UNIXSocketStream:
+        await cls.checkpoint()
+        loop = get_running_loop()
+        raw_socket = socket.socket(socket.AF_UNIX)
+        raw_socket.setblocking(False)
+        while True:
+            try:
+                raw_socket.connect(path)
+            except BlockingIOError:
+                f: asyncio.Future = asyncio.Future()
+                loop.add_writer(raw_socket, f.set_result, None)
+                f.add_done_callback(lambda _: loop.remove_writer(raw_socket))
+                await f
+            except BaseException:
+                raw_socket.close()
+                raise
+            else:
+                return UNIXSocketStream(raw_socket)
+
+    @classmethod
+    def create_tcp_listener(cls, sock: socket.socket) -> SocketListener:
+        return TCPSocketListener(sock)
+
+    @classmethod
+    def create_unix_listener(cls, sock: socket.socket) -> SocketListener:
+        return UNIXSocketListener(sock)
+
+    @classmethod
+    async def create_udp_socket(
+        cls,
+        family: AddressFamily,
+        local_address: IPSockAddrType | None,
+        remote_address: IPSockAddrType | None,
+        reuse_port: bool,
+    ) -> UDPSocket | ConnectedUDPSocket:
+        transport, protocol = await get_running_loop().create_datagram_endpoint(
+            DatagramProtocol,
+            local_addr=local_address,
+            remote_addr=remote_address,
+            family=family,
+            reuse_port=reuse_port,
+        )
+        if protocol.exception:
+            transport.close()
+            raise protocol.exception
+
+        if not remote_address:
+            return UDPSocket(transport, protocol)
+        else:
+            return ConnectedUDPSocket(transport, protocol)
+
+    @classmethod
+    async def create_unix_datagram_socket(  # type: ignore[override]
+        cls, raw_socket: socket.socket, remote_path: str | bytes | None
+    ) -> abc.UNIXDatagramSocket | abc.ConnectedUNIXDatagramSocket:
+        await cls.checkpoint()
+        loop = get_running_loop()
+
+        if remote_path:
+            while True:
+                try:
+                    raw_socket.connect(remote_path)
+                except BlockingIOError:
+                    f: asyncio.Future = asyncio.Future()
+                    loop.add_writer(raw_socket, f.set_result, None)
+                    f.add_done_callback(lambda _: loop.remove_writer(raw_socket))
+                    await f
+                except BaseException:
+                    raw_socket.close()
+                    raise
+                else:
+                    return ConnectedUNIXDatagramSocket(raw_socket)
+        else:
+            return UNIXDatagramSocket(raw_socket)
+
+    @classmethod
+    async def getaddrinfo(
+        cls,
+        host: bytes | str | None,
+        port: str | int | None,
+        *,
+        family: int | AddressFamily = 0,
+        type: int | SocketKind = 0,
+        proto: int = 0,
+        flags: int = 0,
+    ) -> list[
+        tuple[
+            AddressFamily,
+            SocketKind,
+            int,
+            str,
+            tuple[str, int] | tuple[str, int, int, int],
+        ]
+    ]:
+        return await get_running_loop().getaddrinfo(
+            host, port, family=family, type=type, proto=proto, flags=flags
+        )
+
+    @classmethod
+    async def getnameinfo(
+        cls, sockaddr: IPSockAddrType, flags: int = 0
+    ) -> tuple[str, str]:
+        return await get_running_loop().getnameinfo(sockaddr, flags)
+
+    @classmethod
+    async def wait_socket_readable(cls, sock: socket.socket) -> None:
+        await cls.checkpoint()
+        try:
+            read_events = _read_events.get()
+        except LookupError:
+            read_events = {}
+            _read_events.set(read_events)
+
+        if read_events.get(sock):
+            raise BusyResourceError("reading from") from None
+
+        loop = get_running_loop()
+        event = read_events[sock] = asyncio.Event()
+        loop.add_reader(sock, event.set)
+        try:
+            await event.wait()
+        finally:
+            if read_events.pop(sock, None) is not None:
+                loop.remove_reader(sock)
+                readable = True
+            else:
+                readable = False
+
+        if not readable:
+            raise ClosedResourceError
+
+    @classmethod
+    async def wait_socket_writable(cls, sock: socket.socket) -> None:
+        await cls.checkpoint()
+        try:
+            write_events = _write_events.get()
+        except LookupError:
+            write_events = {}
+            _write_events.set(write_events)
+
+        if write_events.get(sock):
+            raise BusyResourceError("writing to") from None
+
+        loop = get_running_loop()
+        event = write_events[sock] = asyncio.Event()
+        loop.add_writer(sock.fileno(), event.set)
+        try:
+            await event.wait()
+        finally:
+            if write_events.pop(sock, None) is not None:
+                loop.remove_writer(sock)
+                writable = True
+            else:
+                writable = False
+
+        if not writable:
+            raise ClosedResourceError
+
+    @classmethod
+    def current_default_thread_limiter(cls) -> CapacityLimiter:
+        try:
+            return _default_thread_limiter.get()
+        except LookupError:
+            limiter = CapacityLimiter(40)
+            _default_thread_limiter.set(limiter)
+            return limiter
+
+    @classmethod
+    def open_signal_receiver(
+        cls, *signals: Signals
+    ) -> ContextManager[AsyncIterator[Signals]]:
+        return _SignalReceiver(signals)
+
+    @classmethod
+    def get_current_task(cls) -> TaskInfo:
+        return _create_task_info(current_task())  # type: ignore[arg-type]
+
+    @classmethod
+    def get_running_tasks(cls) -> list[TaskInfo]:
+        return [_create_task_info(task) for task in all_tasks() if not task.done()]
+
+    @classmethod
+    async def wait_all_tasks_blocked(cls) -> None:
+        await cls.checkpoint()
+        this_task = current_task()
+        while True:
+            for task in all_tasks():
+                if task is this_task:
+                    continue
+
+                waiter = task._fut_waiter  # type: ignore[attr-defined]
+                if waiter is None or waiter.done():
+                    await sleep(0.1)
+                    break
+            else:
+                return
+
+    @classmethod
+    def create_test_runner(cls, options: dict[str, Any]) -> TestRunner:
+        return TestRunner(**options)
+
+
+backend_class = AsyncIOBackend
diff --git a/llm/Lib/site-packages/anyio/_backends/_trio.py b/llm/Lib/site-packages/anyio/_backends/_trio.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a47192e3079e29d0ffd5b66c3f1e23396fee71d
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_backends/_trio.py
@@ -0,0 +1,1169 @@
+from __future__ import annotations
+
+import array
+import math
+import socket
+import sys
+import types
+from collections.abc import AsyncIterator, Iterable
+from concurrent.futures import Future
+from dataclasses import dataclass
+from functools import partial
+from io import IOBase
+from os import PathLike
+from signal import Signals
+from socket import AddressFamily, SocketKind
+from types import TracebackType
+from typing import (
+    IO,
+    Any,
+    AsyncGenerator,
+    Awaitable,
+    Callable,
+    Collection,
+    ContextManager,
+    Coroutine,
+    Generic,
+    Mapping,
+    NoReturn,
+    Sequence,
+    TypeVar,
+    cast,
+    overload,
+)
+
+import trio.from_thread
+import trio.lowlevel
+from outcome import Error, Outcome, Value
+from trio.lowlevel import (
+    current_root_task,
+    current_task,
+    wait_readable,
+    wait_writable,
+)
+from trio.socket import SocketType as TrioSocketType
+from trio.to_thread import run_sync
+
+from .. import CapacityLimiterStatistics, EventStatistics, TaskInfo, abc
+from .._core._eventloop import claim_worker_thread
+from .._core._exceptions import (
+    BrokenResourceError,
+    BusyResourceError,
+    ClosedResourceError,
+    EndOfStream,
+)
+from .._core._sockets import convert_ipv6_sockaddr
+from .._core._streams import create_memory_object_stream
+from .._core._synchronization import CapacityLimiter as BaseCapacityLimiter
+from .._core._synchronization import Event as BaseEvent
+from .._core._synchronization import ResourceGuard
+from .._core._tasks import CancelScope as BaseCancelScope
+from ..abc import IPSockAddrType, UDPPacketType, UNIXDatagramPacketType
+from ..abc._eventloop import AsyncBackend
+from ..streams.memory import MemoryObjectSendStream
+
+if sys.version_info >= (3, 10):
+    from typing import ParamSpec
+else:
+    from typing_extensions import ParamSpec
+
+if sys.version_info >= (3, 11):
+    from typing import TypeVarTuple, Unpack
+else:
+    from exceptiongroup import BaseExceptionGroup
+    from typing_extensions import TypeVarTuple, Unpack
+
+T = TypeVar("T")
+T_Retval = TypeVar("T_Retval")
+T_SockAddr = TypeVar("T_SockAddr", str, IPSockAddrType)
+PosArgsT = TypeVarTuple("PosArgsT")
+P = ParamSpec("P")
+
+
+#
+# Event loop
+#
+
+RunVar = trio.lowlevel.RunVar
+
+
+#
+# Timeouts and cancellation
+#
+
+
+class CancelScope(BaseCancelScope):
+    def __new__(
+        cls, original: trio.CancelScope | None = None, **kwargs: object
+    ) -> CancelScope:
+        return object.__new__(cls)
+
+    def __init__(self, original: trio.CancelScope | None = None, **kwargs: Any) -> None:
+        self.__original = original or trio.CancelScope(**kwargs)
+
+    def __enter__(self) -> CancelScope:
+        self.__original.__enter__()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
+        # https://github.com/python-trio/trio-typing/pull/79
+        return self.__original.__exit__(exc_type, exc_val, exc_tb)
+
+    def cancel(self) -> None:
+        self.__original.cancel()
+
+    @property
+    def deadline(self) -> float:
+        return self.__original.deadline
+
+    @deadline.setter
+    def deadline(self, value: float) -> None:
+        self.__original.deadline = value
+
+    @property
+    def cancel_called(self) -> bool:
+        return self.__original.cancel_called
+
+    @property
+    def cancelled_caught(self) -> bool:
+        return self.__original.cancelled_caught
+
+    @property
+    def shield(self) -> bool:
+        return self.__original.shield
+
+    @shield.setter
+    def shield(self, value: bool) -> None:
+        self.__original.shield = value
+
+
+#
+# Task groups
+#
+
+
+class TaskGroup(abc.TaskGroup):
+    def __init__(self) -> None:
+        self._active = False
+        self._nursery_manager = trio.open_nursery(strict_exception_groups=True)
+        self.cancel_scope = None  # type: ignore[assignment]
+
+    async def __aenter__(self) -> TaskGroup:
+        self._active = True
+        self._nursery = await self._nursery_manager.__aenter__()
+        self.cancel_scope = CancelScope(self._nursery.cancel_scope)
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
+        try:
+            return await self._nursery_manager.__aexit__(exc_type, exc_val, exc_tb)
+        except BaseExceptionGroup as exc:
+            _, rest = exc.split(trio.Cancelled)
+            if not rest:
+                cancelled_exc = trio.Cancelled._create()
+                raise cancelled_exc from exc
+
+            raise
+        finally:
+            self._active = False
+
+    def start_soon(
+        self,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[Any]],
+        *args: Unpack[PosArgsT],
+        name: object = None,
+    ) -> None:
+        if not self._active:
+            raise RuntimeError(
+                "This task group is not active; no new tasks can be started."
+            )
+
+        self._nursery.start_soon(func, *args, name=name)
+
+    async def start(
+        self, func: Callable[..., Awaitable[Any]], *args: object, name: object = None
+    ) -> Any:
+        if not self._active:
+            raise RuntimeError(
+                "This task group is not active; no new tasks can be started."
+            )
+
+        return await self._nursery.start(func, *args, name=name)
+
+
+#
+# Threads
+#
+
+
+class BlockingPortal(abc.BlockingPortal):
+    def __new__(cls) -> BlockingPortal:
+        return object.__new__(cls)
+
+    def __init__(self) -> None:
+        super().__init__()
+        self._token = trio.lowlevel.current_trio_token()
+
+    def _spawn_task_from_thread(
+        self,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval] | T_Retval],
+        args: tuple[Unpack[PosArgsT]],
+        kwargs: dict[str, Any],
+        name: object,
+        future: Future[T_Retval],
+    ) -> None:
+        trio.from_thread.run_sync(
+            partial(self._task_group.start_soon, name=name),
+            self._call_func,
+            func,
+            args,
+            kwargs,
+            future,
+            trio_token=self._token,
+        )
+
+
+#
+# Subprocesses
+#
+
+
+@dataclass(eq=False)
+class ReceiveStreamWrapper(abc.ByteReceiveStream):
+    _stream: trio.abc.ReceiveStream
+
+    async def receive(self, max_bytes: int | None = None) -> bytes:
+        try:
+            data = await self._stream.receive_some(max_bytes)
+        except trio.ClosedResourceError as exc:
+            raise ClosedResourceError from exc.__cause__
+        except trio.BrokenResourceError as exc:
+            raise BrokenResourceError from exc.__cause__
+
+        if data:
+            return data
+        else:
+            raise EndOfStream
+
+    async def aclose(self) -> None:
+        await self._stream.aclose()
+
+
+@dataclass(eq=False)
+class SendStreamWrapper(abc.ByteSendStream):
+    _stream: trio.abc.SendStream
+
+    async def send(self, item: bytes) -> None:
+        try:
+            await self._stream.send_all(item)
+        except trio.ClosedResourceError as exc:
+            raise ClosedResourceError from exc.__cause__
+        except trio.BrokenResourceError as exc:
+            raise BrokenResourceError from exc.__cause__
+
+    async def aclose(self) -> None:
+        await self._stream.aclose()
+
+
+@dataclass(eq=False)
+class Process(abc.Process):
+    _process: trio.Process
+    _stdin: abc.ByteSendStream | None
+    _stdout: abc.ByteReceiveStream | None
+    _stderr: abc.ByteReceiveStream | None
+
+    async def aclose(self) -> None:
+        with CancelScope(shield=True):
+            if self._stdin:
+                await self._stdin.aclose()
+            if self._stdout:
+                await self._stdout.aclose()
+            if self._stderr:
+                await self._stderr.aclose()
+
+        try:
+            await self.wait()
+        except BaseException:
+            self.kill()
+            with CancelScope(shield=True):
+                await self.wait()
+            raise
+
+    async def wait(self) -> int:
+        return await self._process.wait()
+
+    def terminate(self) -> None:
+        self._process.terminate()
+
+    def kill(self) -> None:
+        self._process.kill()
+
+    def send_signal(self, signal: Signals) -> None:
+        self._process.send_signal(signal)
+
+    @property
+    def pid(self) -> int:
+        return self._process.pid
+
+    @property
+    def returncode(self) -> int | None:
+        return self._process.returncode
+
+    @property
+    def stdin(self) -> abc.ByteSendStream | None:
+        return self._stdin
+
+    @property
+    def stdout(self) -> abc.ByteReceiveStream | None:
+        return self._stdout
+
+    @property
+    def stderr(self) -> abc.ByteReceiveStream | None:
+        return self._stderr
+
+
+class _ProcessPoolShutdownInstrument(trio.abc.Instrument):
+    def after_run(self) -> None:
+        super().after_run()
+
+
+current_default_worker_process_limiter: trio.lowlevel.RunVar = RunVar(
+    "current_default_worker_process_limiter"
+)
+
+
+async def _shutdown_process_pool(workers: set[abc.Process]) -> None:
+    try:
+        await trio.sleep(math.inf)
+    except trio.Cancelled:
+        for process in workers:
+            if process.returncode is None:
+                process.kill()
+
+        with CancelScope(shield=True):
+            for process in workers:
+                await process.aclose()
+
+
+#
+# Sockets and networking
+#
+
+
+class _TrioSocketMixin(Generic[T_SockAddr]):
+    def __init__(self, trio_socket: TrioSocketType) -> None:
+        self._trio_socket = trio_socket
+        self._closed = False
+
+    def _check_closed(self) -> None:
+        if self._closed:
+            raise ClosedResourceError
+        if self._trio_socket.fileno() < 0:
+            raise BrokenResourceError
+
+    @property
+    def _raw_socket(self) -> socket.socket:
+        return self._trio_socket._sock  # type: ignore[attr-defined]
+
+    async def aclose(self) -> None:
+        if self._trio_socket.fileno() >= 0:
+            self._closed = True
+            self._trio_socket.close()
+
+    def _convert_socket_error(self, exc: BaseException) -> NoReturn:
+        if isinstance(exc, trio.ClosedResourceError):
+            raise ClosedResourceError from exc
+        elif self._trio_socket.fileno() < 0 and self._closed:
+            raise ClosedResourceError from None
+        elif isinstance(exc, OSError):
+            raise BrokenResourceError from exc
+        else:
+            raise exc
+
+
+class SocketStream(_TrioSocketMixin, abc.SocketStream):
+    def __init__(self, trio_socket: TrioSocketType) -> None:
+        super().__init__(trio_socket)
+        self._receive_guard = ResourceGuard("reading from")
+        self._send_guard = ResourceGuard("writing to")
+
+    async def receive(self, max_bytes: int = 65536) -> bytes:
+        with self._receive_guard:
+            try:
+                data = await self._trio_socket.recv(max_bytes)
+            except BaseException as exc:
+                self._convert_socket_error(exc)
+
+            if data:
+                return data
+            else:
+                raise EndOfStream
+
+    async def send(self, item: bytes) -> None:
+        with self._send_guard:
+            view = memoryview(item)
+            while view:
+                try:
+                    bytes_sent = await self._trio_socket.send(view)
+                except BaseException as exc:
+                    self._convert_socket_error(exc)
+
+                view = view[bytes_sent:]
+
+    async def send_eof(self) -> None:
+        self._trio_socket.shutdown(socket.SHUT_WR)
+
+
+class UNIXSocketStream(SocketStream, abc.UNIXSocketStream):
+    async def receive_fds(self, msglen: int, maxfds: int) -> tuple[bytes, list[int]]:
+        if not isinstance(msglen, int) or msglen < 0:
+            raise ValueError("msglen must be a non-negative integer")
+        if not isinstance(maxfds, int) or maxfds < 1:
+            raise ValueError("maxfds must be a positive integer")
+
+        fds = array.array("i")
+        await trio.lowlevel.checkpoint()
+        with self._receive_guard:
+            while True:
+                try:
+                    message, ancdata, flags, addr = await self._trio_socket.recvmsg(
+                        msglen, socket.CMSG_LEN(maxfds * fds.itemsize)
+                    )
+                except BaseException as exc:
+                    self._convert_socket_error(exc)
+                else:
+                    if not message and not ancdata:
+                        raise EndOfStream
+
+                    break
+
+        for cmsg_level, cmsg_type, cmsg_data in ancdata:
+            if cmsg_level != socket.SOL_SOCKET or cmsg_type != socket.SCM_RIGHTS:
+                raise RuntimeError(
+                    f"Received unexpected ancillary data; message = {message!r}, "
+                    f"cmsg_level = {cmsg_level}, cmsg_type = {cmsg_type}"
+                )
+
+            fds.frombytes(cmsg_data[: len(cmsg_data) - (len(cmsg_data) % fds.itemsize)])
+
+        return message, list(fds)
+
+    async def send_fds(self, message: bytes, fds: Collection[int | IOBase]) -> None:
+        if not message:
+            raise ValueError("message must not be empty")
+        if not fds:
+            raise ValueError("fds must not be empty")
+
+        filenos: list[int] = []
+        for fd in fds:
+            if isinstance(fd, int):
+                filenos.append(fd)
+            elif isinstance(fd, IOBase):
+                filenos.append(fd.fileno())
+
+        fdarray = array.array("i", filenos)
+        await trio.lowlevel.checkpoint()
+        with self._send_guard:
+            while True:
+                try:
+                    await self._trio_socket.sendmsg(
+                        [message],
+                        [
+                            (
+                                socket.SOL_SOCKET,
+                                socket.SCM_RIGHTS,
+                                fdarray,
+                            )
+                        ],
+                    )
+                    break
+                except BaseException as exc:
+                    self._convert_socket_error(exc)
+
+
+class TCPSocketListener(_TrioSocketMixin, abc.SocketListener):
+    def __init__(self, raw_socket: socket.socket):
+        super().__init__(trio.socket.from_stdlib_socket(raw_socket))
+        self._accept_guard = ResourceGuard("accepting connections from")
+
+    async def accept(self) -> SocketStream:
+        with self._accept_guard:
+            try:
+                trio_socket, _addr = await self._trio_socket.accept()
+            except BaseException as exc:
+                self._convert_socket_error(exc)
+
+        trio_socket.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
+        return SocketStream(trio_socket)
+
+
+class UNIXSocketListener(_TrioSocketMixin, abc.SocketListener):
+    def __init__(self, raw_socket: socket.socket):
+        super().__init__(trio.socket.from_stdlib_socket(raw_socket))
+        self._accept_guard = ResourceGuard("accepting connections from")
+
+    async def accept(self) -> UNIXSocketStream:
+        with self._accept_guard:
+            try:
+                trio_socket, _addr = await self._trio_socket.accept()
+            except BaseException as exc:
+                self._convert_socket_error(exc)
+
+        return UNIXSocketStream(trio_socket)
+
+
+class UDPSocket(_TrioSocketMixin[IPSockAddrType], abc.UDPSocket):
+    def __init__(self, trio_socket: TrioSocketType) -> None:
+        super().__init__(trio_socket)
+        self._receive_guard = ResourceGuard("reading from")
+        self._send_guard = ResourceGuard("writing to")
+
+    async def receive(self) -> tuple[bytes, IPSockAddrType]:
+        with self._receive_guard:
+            try:
+                data, addr = await self._trio_socket.recvfrom(65536)
+                return data, convert_ipv6_sockaddr(addr)
+            except BaseException as exc:
+                self._convert_socket_error(exc)
+
+    async def send(self, item: UDPPacketType) -> None:
+        with self._send_guard:
+            try:
+                await self._trio_socket.sendto(*item)
+            except BaseException as exc:
+                self._convert_socket_error(exc)
+
+
+class ConnectedUDPSocket(_TrioSocketMixin[IPSockAddrType], abc.ConnectedUDPSocket):
+    def __init__(self, trio_socket: TrioSocketType) -> None:
+        super().__init__(trio_socket)
+        self._receive_guard = ResourceGuard("reading from")
+        self._send_guard = ResourceGuard("writing to")
+
+    async def receive(self) -> bytes:
+        with self._receive_guard:
+            try:
+                return await self._trio_socket.recv(65536)
+            except BaseException as exc:
+                self._convert_socket_error(exc)
+
+    async def send(self, item: bytes) -> None:
+        with self._send_guard:
+            try:
+                await self._trio_socket.send(item)
+            except BaseException as exc:
+                self._convert_socket_error(exc)
+
+
+class UNIXDatagramSocket(_TrioSocketMixin[str], abc.UNIXDatagramSocket):
+    def __init__(self, trio_socket: TrioSocketType) -> None:
+        super().__init__(trio_socket)
+        self._receive_guard = ResourceGuard("reading from")
+        self._send_guard = ResourceGuard("writing to")
+
+    async def receive(self) -> UNIXDatagramPacketType:
+        with self._receive_guard:
+            try:
+                data, addr = await self._trio_socket.recvfrom(65536)
+                return data, addr
+            except BaseException as exc:
+                self._convert_socket_error(exc)
+
+    async def send(self, item: UNIXDatagramPacketType) -> None:
+        with self._send_guard:
+            try:
+                await self._trio_socket.sendto(*item)
+            except BaseException as exc:
+                self._convert_socket_error(exc)
+
+
+class ConnectedUNIXDatagramSocket(
+    _TrioSocketMixin[str], abc.ConnectedUNIXDatagramSocket
+):
+    def __init__(self, trio_socket: TrioSocketType) -> None:
+        super().__init__(trio_socket)
+        self._receive_guard = ResourceGuard("reading from")
+        self._send_guard = ResourceGuard("writing to")
+
+    async def receive(self) -> bytes:
+        with self._receive_guard:
+            try:
+                return await self._trio_socket.recv(65536)
+            except BaseException as exc:
+                self._convert_socket_error(exc)
+
+    async def send(self, item: bytes) -> None:
+        with self._send_guard:
+            try:
+                await self._trio_socket.send(item)
+            except BaseException as exc:
+                self._convert_socket_error(exc)
+
+
+#
+# Synchronization
+#
+
+
+class Event(BaseEvent):
+    def __new__(cls) -> Event:
+        return object.__new__(cls)
+
+    def __init__(self) -> None:
+        self.__original = trio.Event()
+
+    def is_set(self) -> bool:
+        return self.__original.is_set()
+
+    async def wait(self) -> None:
+        return await self.__original.wait()
+
+    def statistics(self) -> EventStatistics:
+        orig_statistics = self.__original.statistics()
+        return EventStatistics(tasks_waiting=orig_statistics.tasks_waiting)
+
+    def set(self) -> None:
+        self.__original.set()
+
+
+class CapacityLimiter(BaseCapacityLimiter):
+    def __new__(
+        cls,
+        total_tokens: float | None = None,
+        *,
+        original: trio.CapacityLimiter | None = None,
+    ) -> CapacityLimiter:
+        return object.__new__(cls)
+
+    def __init__(
+        self,
+        total_tokens: float | None = None,
+        *,
+        original: trio.CapacityLimiter | None = None,
+    ) -> None:
+        if original is not None:
+            self.__original = original
+        else:
+            assert total_tokens is not None
+            self.__original = trio.CapacityLimiter(total_tokens)
+
+    async def __aenter__(self) -> None:
+        return await self.__original.__aenter__()
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> None:
+        await self.__original.__aexit__(exc_type, exc_val, exc_tb)
+
+    @property
+    def total_tokens(self) -> float:
+        return self.__original.total_tokens
+
+    @total_tokens.setter
+    def total_tokens(self, value: float) -> None:
+        self.__original.total_tokens = value
+
+    @property
+    def borrowed_tokens(self) -> int:
+        return self.__original.borrowed_tokens
+
+    @property
+    def available_tokens(self) -> float:
+        return self.__original.available_tokens
+
+    def acquire_nowait(self) -> None:
+        self.__original.acquire_nowait()
+
+    def acquire_on_behalf_of_nowait(self, borrower: object) -> None:
+        self.__original.acquire_on_behalf_of_nowait(borrower)
+
+    async def acquire(self) -> None:
+        await self.__original.acquire()
+
+    async def acquire_on_behalf_of(self, borrower: object) -> None:
+        await self.__original.acquire_on_behalf_of(borrower)
+
+    def release(self) -> None:
+        return self.__original.release()
+
+    def release_on_behalf_of(self, borrower: object) -> None:
+        return self.__original.release_on_behalf_of(borrower)
+
+    def statistics(self) -> CapacityLimiterStatistics:
+        orig = self.__original.statistics()
+        return CapacityLimiterStatistics(
+            borrowed_tokens=orig.borrowed_tokens,
+            total_tokens=orig.total_tokens,
+            borrowers=tuple(orig.borrowers),
+            tasks_waiting=orig.tasks_waiting,
+        )
+
+
+_capacity_limiter_wrapper: trio.lowlevel.RunVar = RunVar("_capacity_limiter_wrapper")
+
+
+#
+# Signal handling
+#
+
+
+class _SignalReceiver:
+    _iterator: AsyncIterator[int]
+
+    def __init__(self, signals: tuple[Signals, ...]):
+        self._signals = signals
+
+    def __enter__(self) -> _SignalReceiver:
+        self._cm = trio.open_signal_receiver(*self._signals)
+        self._iterator = self._cm.__enter__()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
+        return self._cm.__exit__(exc_type, exc_val, exc_tb)
+
+    def __aiter__(self) -> _SignalReceiver:
+        return self
+
+    async def __anext__(self) -> Signals:
+        signum = await self._iterator.__anext__()
+        return Signals(signum)
+
+
+#
+# Testing and debugging
+#
+
+
+class TestRunner(abc.TestRunner):
+    def __init__(self, **options: Any) -> None:
+        from queue import Queue
+
+        self._call_queue: Queue[Callable[[], object]] = Queue()
+        self._send_stream: MemoryObjectSendStream | None = None
+        self._options = options
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: types.TracebackType | None,
+    ) -> None:
+        if self._send_stream:
+            self._send_stream.close()
+            while self._send_stream is not None:
+                self._call_queue.get()()
+
+    async def _run_tests_and_fixtures(self) -> None:
+        self._send_stream, receive_stream = create_memory_object_stream(1)
+        with receive_stream:
+            async for coro, outcome_holder in receive_stream:
+                try:
+                    retval = await coro
+                except BaseException as exc:
+                    outcome_holder.append(Error(exc))
+                else:
+                    outcome_holder.append(Value(retval))
+
+    def _main_task_finished(self, outcome: object) -> None:
+        self._send_stream = None
+
+    def _call_in_runner_task(
+        self,
+        func: Callable[P, Awaitable[T_Retval]],
+        *args: P.args,
+        **kwargs: P.kwargs,
+    ) -> T_Retval:
+        if self._send_stream is None:
+            trio.lowlevel.start_guest_run(
+                self._run_tests_and_fixtures,
+                run_sync_soon_threadsafe=self._call_queue.put,
+                done_callback=self._main_task_finished,
+                **self._options,
+            )
+            while self._send_stream is None:
+                self._call_queue.get()()
+
+        outcome_holder: list[Outcome] = []
+        self._send_stream.send_nowait((func(*args, **kwargs), outcome_holder))
+        while not outcome_holder:
+            self._call_queue.get()()
+
+        return outcome_holder[0].unwrap()
+
+    def run_asyncgen_fixture(
+        self,
+        fixture_func: Callable[..., AsyncGenerator[T_Retval, Any]],
+        kwargs: dict[str, Any],
+    ) -> Iterable[T_Retval]:
+        asyncgen = fixture_func(**kwargs)
+        fixturevalue: T_Retval = self._call_in_runner_task(asyncgen.asend, None)
+
+        yield fixturevalue
+
+        try:
+            self._call_in_runner_task(asyncgen.asend, None)
+        except StopAsyncIteration:
+            pass
+        else:
+            self._call_in_runner_task(asyncgen.aclose)
+            raise RuntimeError("Async generator fixture did not stop")
+
+    def run_fixture(
+        self,
+        fixture_func: Callable[..., Coroutine[Any, Any, T_Retval]],
+        kwargs: dict[str, Any],
+    ) -> T_Retval:
+        return self._call_in_runner_task(fixture_func, **kwargs)
+
+    def run_test(
+        self, test_func: Callable[..., Coroutine[Any, Any, Any]], kwargs: dict[str, Any]
+    ) -> None:
+        self._call_in_runner_task(test_func, **kwargs)
+
+
+class TrioBackend(AsyncBackend):
+    @classmethod
+    def run(
+        cls,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]],
+        args: tuple[Unpack[PosArgsT]],
+        kwargs: dict[str, Any],
+        options: dict[str, Any],
+    ) -> T_Retval:
+        return trio.run(func, *args)
+
+    @classmethod
+    def current_token(cls) -> object:
+        return trio.lowlevel.current_trio_token()
+
+    @classmethod
+    def current_time(cls) -> float:
+        return trio.current_time()
+
+    @classmethod
+    def cancelled_exception_class(cls) -> type[BaseException]:
+        return trio.Cancelled
+
+    @classmethod
+    async def checkpoint(cls) -> None:
+        await trio.lowlevel.checkpoint()
+
+    @classmethod
+    async def checkpoint_if_cancelled(cls) -> None:
+        await trio.lowlevel.checkpoint_if_cancelled()
+
+    @classmethod
+    async def cancel_shielded_checkpoint(cls) -> None:
+        await trio.lowlevel.cancel_shielded_checkpoint()
+
+    @classmethod
+    async def sleep(cls, delay: float) -> None:
+        await trio.sleep(delay)
+
+    @classmethod
+    def create_cancel_scope(
+        cls, *, deadline: float = math.inf, shield: bool = False
+    ) -> abc.CancelScope:
+        return CancelScope(deadline=deadline, shield=shield)
+
+    @classmethod
+    def current_effective_deadline(cls) -> float:
+        return trio.current_effective_deadline()
+
+    @classmethod
+    def create_task_group(cls) -> abc.TaskGroup:
+        return TaskGroup()
+
+    @classmethod
+    def create_event(cls) -> abc.Event:
+        return Event()
+
+    @classmethod
+    def create_capacity_limiter(cls, total_tokens: float) -> CapacityLimiter:
+        return CapacityLimiter(total_tokens)
+
+    @classmethod
+    async def run_sync_in_worker_thread(
+        cls,
+        func: Callable[[Unpack[PosArgsT]], T_Retval],
+        args: tuple[Unpack[PosArgsT]],
+        abandon_on_cancel: bool = False,
+        limiter: abc.CapacityLimiter | None = None,
+    ) -> T_Retval:
+        def wrapper() -> T_Retval:
+            with claim_worker_thread(TrioBackend, token):
+                return func(*args)
+
+        token = TrioBackend.current_token()
+        return await run_sync(
+            wrapper,
+            abandon_on_cancel=abandon_on_cancel,
+            limiter=cast(trio.CapacityLimiter, limiter),
+        )
+
+    @classmethod
+    def check_cancelled(cls) -> None:
+        trio.from_thread.check_cancelled()
+
+    @classmethod
+    def run_async_from_thread(
+        cls,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]],
+        args: tuple[Unpack[PosArgsT]],
+        token: object,
+    ) -> T_Retval:
+        return trio.from_thread.run(func, *args)
+
+    @classmethod
+    def run_sync_from_thread(
+        cls,
+        func: Callable[[Unpack[PosArgsT]], T_Retval],
+        args: tuple[Unpack[PosArgsT]],
+        token: object,
+    ) -> T_Retval:
+        return trio.from_thread.run_sync(func, *args)
+
+    @classmethod
+    def create_blocking_portal(cls) -> abc.BlockingPortal:
+        return BlockingPortal()
+
+    @classmethod
+    async def open_process(
+        cls,
+        command: str | bytes | Sequence[str | bytes],
+        *,
+        shell: bool,
+        stdin: int | IO[Any] | None,
+        stdout: int | IO[Any] | None,
+        stderr: int | IO[Any] | None,
+        cwd: str | bytes | PathLike | None = None,
+        env: Mapping[str, str] | None = None,
+        start_new_session: bool = False,
+    ) -> Process:
+        process = await trio.lowlevel.open_process(  # type: ignore[misc]
+            command,  # type: ignore[arg-type]
+            stdin=stdin,
+            stdout=stdout,
+            stderr=stderr,
+            shell=shell,
+            cwd=cwd,
+            env=env,
+            start_new_session=start_new_session,
+        )
+        stdin_stream = SendStreamWrapper(process.stdin) if process.stdin else None
+        stdout_stream = ReceiveStreamWrapper(process.stdout) if process.stdout else None
+        stderr_stream = ReceiveStreamWrapper(process.stderr) if process.stderr else None
+        return Process(process, stdin_stream, stdout_stream, stderr_stream)
+
+    @classmethod
+    def setup_process_pool_exit_at_shutdown(cls, workers: set[abc.Process]) -> None:
+        trio.lowlevel.spawn_system_task(_shutdown_process_pool, workers)
+
+    @classmethod
+    async def connect_tcp(
+        cls, host: str, port: int, local_address: IPSockAddrType | None = None
+    ) -> SocketStream:
+        family = socket.AF_INET6 if ":" in host else socket.AF_INET
+        trio_socket = trio.socket.socket(family)
+        trio_socket.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
+        if local_address:
+            await trio_socket.bind(local_address)
+
+        try:
+            await trio_socket.connect((host, port))
+        except BaseException:
+            trio_socket.close()
+            raise
+
+        return SocketStream(trio_socket)
+
+    @classmethod
+    async def connect_unix(cls, path: str | bytes) -> abc.UNIXSocketStream:
+        trio_socket = trio.socket.socket(socket.AF_UNIX)
+        try:
+            await trio_socket.connect(path)
+        except BaseException:
+            trio_socket.close()
+            raise
+
+        return UNIXSocketStream(trio_socket)
+
+    @classmethod
+    def create_tcp_listener(cls, sock: socket.socket) -> abc.SocketListener:
+        return TCPSocketListener(sock)
+
+    @classmethod
+    def create_unix_listener(cls, sock: socket.socket) -> abc.SocketListener:
+        return UNIXSocketListener(sock)
+
+    @classmethod
+    async def create_udp_socket(
+        cls,
+        family: socket.AddressFamily,
+        local_address: IPSockAddrType | None,
+        remote_address: IPSockAddrType | None,
+        reuse_port: bool,
+    ) -> UDPSocket | ConnectedUDPSocket:
+        trio_socket = trio.socket.socket(family=family, type=socket.SOCK_DGRAM)
+
+        if reuse_port:
+            trio_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEPORT, 1)
+
+        if local_address:
+            await trio_socket.bind(local_address)
+
+        if remote_address:
+            await trio_socket.connect(remote_address)
+            return ConnectedUDPSocket(trio_socket)
+        else:
+            return UDPSocket(trio_socket)
+
+    @classmethod
+    @overload
+    async def create_unix_datagram_socket(
+        cls, raw_socket: socket.socket, remote_path: None
+    ) -> abc.UNIXDatagramSocket:
+        ...
+
+    @classmethod
+    @overload
+    async def create_unix_datagram_socket(
+        cls, raw_socket: socket.socket, remote_path: str | bytes
+    ) -> abc.ConnectedUNIXDatagramSocket:
+        ...
+
+    @classmethod
+    async def create_unix_datagram_socket(
+        cls, raw_socket: socket.socket, remote_path: str | bytes | None
+    ) -> abc.UNIXDatagramSocket | abc.ConnectedUNIXDatagramSocket:
+        trio_socket = trio.socket.from_stdlib_socket(raw_socket)
+
+        if remote_path:
+            await trio_socket.connect(remote_path)
+            return ConnectedUNIXDatagramSocket(trio_socket)
+        else:
+            return UNIXDatagramSocket(trio_socket)
+
+    @classmethod
+    async def getaddrinfo(
+        cls,
+        host: bytes | str | None,
+        port: str | int | None,
+        *,
+        family: int | AddressFamily = 0,
+        type: int | SocketKind = 0,
+        proto: int = 0,
+        flags: int = 0,
+    ) -> list[
+        tuple[
+            AddressFamily,
+            SocketKind,
+            int,
+            str,
+            tuple[str, int] | tuple[str, int, int, int],
+        ]
+    ]:
+        return await trio.socket.getaddrinfo(host, port, family, type, proto, flags)
+
+    @classmethod
+    async def getnameinfo(
+        cls, sockaddr: IPSockAddrType, flags: int = 0
+    ) -> tuple[str, str]:
+        return await trio.socket.getnameinfo(sockaddr, flags)
+
+    @classmethod
+    async def wait_socket_readable(cls, sock: socket.socket) -> None:
+        try:
+            await wait_readable(sock)
+        except trio.ClosedResourceError as exc:
+            raise ClosedResourceError().with_traceback(exc.__traceback__) from None
+        except trio.BusyResourceError:
+            raise BusyResourceError("reading from") from None
+
+    @classmethod
+    async def wait_socket_writable(cls, sock: socket.socket) -> None:
+        try:
+            await wait_writable(sock)
+        except trio.ClosedResourceError as exc:
+            raise ClosedResourceError().with_traceback(exc.__traceback__) from None
+        except trio.BusyResourceError:
+            raise BusyResourceError("writing to") from None
+
+    @classmethod
+    def current_default_thread_limiter(cls) -> CapacityLimiter:
+        try:
+            return _capacity_limiter_wrapper.get()
+        except LookupError:
+            limiter = CapacityLimiter(
+                original=trio.to_thread.current_default_thread_limiter()
+            )
+            _capacity_limiter_wrapper.set(limiter)
+            return limiter
+
+    @classmethod
+    def open_signal_receiver(
+        cls, *signals: Signals
+    ) -> ContextManager[AsyncIterator[Signals]]:
+        return _SignalReceiver(signals)
+
+    @classmethod
+    def get_current_task(cls) -> TaskInfo:
+        task = current_task()
+
+        parent_id = None
+        if task.parent_nursery and task.parent_nursery.parent_task:
+            parent_id = id(task.parent_nursery.parent_task)
+
+        return TaskInfo(id(task), parent_id, task.name, task.coro)
+
+    @classmethod
+    def get_running_tasks(cls) -> list[TaskInfo]:
+        root_task = current_root_task()
+        assert root_task
+        task_infos = [TaskInfo(id(root_task), None, root_task.name, root_task.coro)]
+        nurseries = root_task.child_nurseries
+        while nurseries:
+            new_nurseries: list[trio.Nursery] = []
+            for nursery in nurseries:
+                for task in nursery.child_tasks:
+                    task_infos.append(
+                        TaskInfo(
+                            id(task), id(nursery.parent_task), task.name, task.coro
+                        )
+                    )
+                    new_nurseries.extend(task.child_nurseries)
+
+            nurseries = new_nurseries
+
+        return task_infos
+
+    @classmethod
+    async def wait_all_tasks_blocked(cls) -> None:
+        from trio.testing import wait_all_tasks_blocked
+
+        await wait_all_tasks_blocked()
+
+    @classmethod
+    def create_test_runner(cls, options: dict[str, Any]) -> TestRunner:
+        return TestRunner(**options)
+
+
+backend_class = TrioBackend
diff --git a/llm/Lib/site-packages/anyio/_core/__init__.py b/llm/Lib/site-packages/anyio/_core/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/anyio/_core/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/anyio/_core/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aa0ac4a34a3097a96bfedc6f95c4820a0806fd88
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_core/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_core/__pycache__/_eventloop.cpython-311.pyc b/llm/Lib/site-packages/anyio/_core/__pycache__/_eventloop.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bc7608e9c3a7feb25fe481cc1c1696f99aca8b6e
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_core/__pycache__/_eventloop.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_core/__pycache__/_exceptions.cpython-311.pyc b/llm/Lib/site-packages/anyio/_core/__pycache__/_exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e4890a74102263ead4bac87e66fc8e204cd069b0
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_core/__pycache__/_exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_core/__pycache__/_fileio.cpython-311.pyc b/llm/Lib/site-packages/anyio/_core/__pycache__/_fileio.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..146f7d94f707c0dbc224d2852818cb7825e68917
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_core/__pycache__/_fileio.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_core/__pycache__/_resources.cpython-311.pyc b/llm/Lib/site-packages/anyio/_core/__pycache__/_resources.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1545be13145c55cdd198f72bc81babecebcf7ad4
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_core/__pycache__/_resources.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_core/__pycache__/_signals.cpython-311.pyc b/llm/Lib/site-packages/anyio/_core/__pycache__/_signals.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cdb2e1e9eed5a467c92df3951f94fa91e2d93240
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_core/__pycache__/_signals.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_core/__pycache__/_sockets.cpython-311.pyc b/llm/Lib/site-packages/anyio/_core/__pycache__/_sockets.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..052f3b13e9183b73c567c9fdf1d5f7d0ad4db43e
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_core/__pycache__/_sockets.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_core/__pycache__/_streams.cpython-311.pyc b/llm/Lib/site-packages/anyio/_core/__pycache__/_streams.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fbcf5f911e0a6ae9b92ae01a821b30cc70f52d0d
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_core/__pycache__/_streams.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_core/__pycache__/_subprocesses.cpython-311.pyc b/llm/Lib/site-packages/anyio/_core/__pycache__/_subprocesses.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..88ef3f3a98760ebbab447c3a7acd3177da4234cf
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_core/__pycache__/_subprocesses.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_core/__pycache__/_synchronization.cpython-311.pyc b/llm/Lib/site-packages/anyio/_core/__pycache__/_synchronization.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a0c9bf5751665b47b2dfff2fe63edc9a26cc47c2
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_core/__pycache__/_synchronization.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_core/__pycache__/_tasks.cpython-311.pyc b/llm/Lib/site-packages/anyio/_core/__pycache__/_tasks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b069a6d185f2cf3876a4241cf5f4d5d8a7e4bdb9
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_core/__pycache__/_tasks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_core/__pycache__/_testing.cpython-311.pyc b/llm/Lib/site-packages/anyio/_core/__pycache__/_testing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..00542abba1ccbf093d00208cd47337d91b85b2d8
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_core/__pycache__/_testing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_core/__pycache__/_typedattr.cpython-311.pyc b/llm/Lib/site-packages/anyio/_core/__pycache__/_typedattr.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f7944b9157687b2b7e8b37a54142eb3cdca28e07
Binary files /dev/null and b/llm/Lib/site-packages/anyio/_core/__pycache__/_typedattr.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/_core/_eventloop.py b/llm/Lib/site-packages/anyio/_core/_eventloop.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9c6e82585fb46f569161b8aae7d6238a507759d
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_core/_eventloop.py
@@ -0,0 +1,163 @@
+from __future__ import annotations
+
+import math
+import sys
+import threading
+from collections.abc import Awaitable, Callable, Generator
+from contextlib import contextmanager
+from importlib import import_module
+from typing import TYPE_CHECKING, Any, TypeVar
+
+import sniffio
+
+if sys.version_info >= (3, 11):
+    from typing import TypeVarTuple, Unpack
+else:
+    from typing_extensions import TypeVarTuple, Unpack
+
+if TYPE_CHECKING:
+    from ..abc import AsyncBackend
+
+# This must be updated when new backends are introduced
+BACKENDS = "asyncio", "trio"
+
+T_Retval = TypeVar("T_Retval")
+PosArgsT = TypeVarTuple("PosArgsT")
+
+threadlocals = threading.local()
+
+
+def run(
+    func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]],
+    *args: Unpack[PosArgsT],
+    backend: str = "asyncio",
+    backend_options: dict[str, Any] | None = None,
+) -> T_Retval:
+    """
+    Run the given coroutine function in an asynchronous event loop.
+
+    The current thread must not be already running an event loop.
+
+    :param func: a coroutine function
+    :param args: positional arguments to ``func``
+    :param backend: name of the asynchronous event loop implementation – currently
+        either ``asyncio`` or ``trio``
+    :param backend_options: keyword arguments to call the backend ``run()``
+        implementation with (documented :ref:`here <backend options>`)
+    :return: the return value of the coroutine function
+    :raises RuntimeError: if an asynchronous event loop is already running in this
+        thread
+    :raises LookupError: if the named backend is not found
+
+    """
+    try:
+        asynclib_name = sniffio.current_async_library()
+    except sniffio.AsyncLibraryNotFoundError:
+        pass
+    else:
+        raise RuntimeError(f"Already running {asynclib_name} in this thread")
+
+    try:
+        async_backend = get_async_backend(backend)
+    except ImportError as exc:
+        raise LookupError(f"No such backend: {backend}") from exc
+
+    token = None
+    if sniffio.current_async_library_cvar.get(None) is None:
+        # Since we're in control of the event loop, we can cache the name of the async
+        # library
+        token = sniffio.current_async_library_cvar.set(backend)
+
+    try:
+        backend_options = backend_options or {}
+        return async_backend.run(func, args, {}, backend_options)
+    finally:
+        if token:
+            sniffio.current_async_library_cvar.reset(token)
+
+
+async def sleep(delay: float) -> None:
+    """
+    Pause the current task for the specified duration.
+
+    :param delay: the duration, in seconds
+
+    """
+    return await get_async_backend().sleep(delay)
+
+
+async def sleep_forever() -> None:
+    """
+    Pause the current task until it's cancelled.
+
+    This is a shortcut for ``sleep(math.inf)``.
+
+    .. versionadded:: 3.1
+
+    """
+    await sleep(math.inf)
+
+
+async def sleep_until(deadline: float) -> None:
+    """
+    Pause the current task until the given time.
+
+    :param deadline: the absolute time to wake up at (according to the internal
+        monotonic clock of the event loop)
+
+    .. versionadded:: 3.1
+
+    """
+    now = current_time()
+    await sleep(max(deadline - now, 0))
+
+
+def current_time() -> float:
+    """
+    Return the current value of the event loop's internal clock.
+
+    :return: the clock value (seconds)
+
+    """
+    return get_async_backend().current_time()
+
+
+def get_all_backends() -> tuple[str, ...]:
+    """Return a tuple of the names of all built-in backends."""
+    return BACKENDS
+
+
+def get_cancelled_exc_class() -> type[BaseException]:
+    """Return the current async library's cancellation exception class."""
+    return get_async_backend().cancelled_exception_class()
+
+
+#
+# Private API
+#
+
+
+@contextmanager
+def claim_worker_thread(
+    backend_class: type[AsyncBackend], token: object
+) -> Generator[Any, None, None]:
+    threadlocals.current_async_backend = backend_class
+    threadlocals.current_token = token
+    try:
+        yield
+    finally:
+        del threadlocals.current_async_backend
+        del threadlocals.current_token
+
+
+def get_async_backend(asynclib_name: str | None = None) -> AsyncBackend:
+    if asynclib_name is None:
+        asynclib_name = sniffio.current_async_library()
+
+    modulename = "anyio._backends._" + asynclib_name
+    try:
+        module = sys.modules[modulename]
+    except KeyError:
+        module = import_module(modulename)
+
+    return getattr(module, "backend_class")
diff --git a/llm/Lib/site-packages/anyio/_core/_exceptions.py b/llm/Lib/site-packages/anyio/_core/_exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..571c3b853162c1ede38a77ab81ae02f322decdb2
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_core/_exceptions.py
@@ -0,0 +1,73 @@
+from __future__ import annotations
+
+
+class BrokenResourceError(Exception):
+    """
+    Raised when trying to use a resource that has been rendered unusable due to external
+    causes (e.g. a send stream whose peer has disconnected).
+    """
+
+
+class BrokenWorkerProcess(Exception):
+    """
+    Raised by :func:`run_sync_in_process` if the worker process terminates abruptly or
+    otherwise misbehaves.
+    """
+
+
+class BusyResourceError(Exception):
+    """
+    Raised when two tasks are trying to read from or write to the same resource
+    concurrently.
+    """
+
+    def __init__(self, action: str):
+        super().__init__(f"Another task is already {action} this resource")
+
+
+class ClosedResourceError(Exception):
+    """Raised when trying to use a resource that has been closed."""
+
+
+class DelimiterNotFound(Exception):
+    """
+    Raised during
+    :meth:`~anyio.streams.buffered.BufferedByteReceiveStream.receive_until` if the
+    maximum number of bytes has been read without the delimiter being found.
+    """
+
+    def __init__(self, max_bytes: int) -> None:
+        super().__init__(
+            f"The delimiter was not found among the first {max_bytes} bytes"
+        )
+
+
+class EndOfStream(Exception):
+    """
+    Raised when trying to read from a stream that has been closed from the other end.
+    """
+
+
+class IncompleteRead(Exception):
+    """
+    Raised during
+    :meth:`~anyio.streams.buffered.BufferedByteReceiveStream.receive_exactly` or
+    :meth:`~anyio.streams.buffered.BufferedByteReceiveStream.receive_until` if the
+    connection is closed before the requested amount of bytes has been read.
+    """
+
+    def __init__(self) -> None:
+        super().__init__(
+            "The stream was closed before the read operation could be completed"
+        )
+
+
+class TypedAttributeLookupError(LookupError):
+    """
+    Raised by :meth:`~anyio.TypedAttributeProvider.extra` when the given typed attribute
+    is not found and no default value has been given.
+    """
+
+
+class WouldBlock(Exception):
+    """Raised by ``X_nowait`` functions if ``X()`` would block."""
diff --git a/llm/Lib/site-packages/anyio/_core/_fileio.py b/llm/Lib/site-packages/anyio/_core/_fileio.py
new file mode 100644
index 0000000000000000000000000000000000000000..d054be693d45aeaa7f7fc3c365f0f6a7f514f3bc
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_core/_fileio.py
@@ -0,0 +1,645 @@
+from __future__ import annotations
+
+import os
+import pathlib
+import sys
+from collections.abc import Callable, Iterable, Iterator, Sequence
+from dataclasses import dataclass
+from functools import partial
+from os import PathLike
+from typing import (
+    IO,
+    TYPE_CHECKING,
+    Any,
+    AnyStr,
+    AsyncIterator,
+    Final,
+    Generic,
+    overload,
+)
+
+from .. import to_thread
+from ..abc import AsyncResource
+
+if TYPE_CHECKING:
+    from _typeshed import OpenBinaryMode, OpenTextMode, ReadableBuffer, WriteableBuffer
+else:
+    ReadableBuffer = OpenBinaryMode = OpenTextMode = WriteableBuffer = object
+
+
+class AsyncFile(AsyncResource, Generic[AnyStr]):
+    """
+    An asynchronous file object.
+
+    This class wraps a standard file object and provides async friendly versions of the
+    following blocking methods (where available on the original file object):
+
+    * read
+    * read1
+    * readline
+    * readlines
+    * readinto
+    * readinto1
+    * write
+    * writelines
+    * truncate
+    * seek
+    * tell
+    * flush
+
+    All other methods are directly passed through.
+
+    This class supports the asynchronous context manager protocol which closes the
+    underlying file at the end of the context block.
+
+    This class also supports asynchronous iteration::
+
+        async with await open_file(...) as f:
+            async for line in f:
+                print(line)
+    """
+
+    def __init__(self, fp: IO[AnyStr]) -> None:
+        self._fp: Any = fp
+
+    def __getattr__(self, name: str) -> object:
+        return getattr(self._fp, name)
+
+    @property
+    def wrapped(self) -> IO[AnyStr]:
+        """The wrapped file object."""
+        return self._fp
+
+    async def __aiter__(self) -> AsyncIterator[AnyStr]:
+        while True:
+            line = await self.readline()
+            if line:
+                yield line
+            else:
+                break
+
+    async def aclose(self) -> None:
+        return await to_thread.run_sync(self._fp.close)
+
+    async def read(self, size: int = -1) -> AnyStr:
+        return await to_thread.run_sync(self._fp.read, size)
+
+    async def read1(self: AsyncFile[bytes], size: int = -1) -> bytes:
+        return await to_thread.run_sync(self._fp.read1, size)
+
+    async def readline(self) -> AnyStr:
+        return await to_thread.run_sync(self._fp.readline)
+
+    async def readlines(self) -> list[AnyStr]:
+        return await to_thread.run_sync(self._fp.readlines)
+
+    async def readinto(self: AsyncFile[bytes], b: WriteableBuffer) -> bytes:
+        return await to_thread.run_sync(self._fp.readinto, b)
+
+    async def readinto1(self: AsyncFile[bytes], b: WriteableBuffer) -> bytes:
+        return await to_thread.run_sync(self._fp.readinto1, b)
+
+    @overload
+    async def write(self: AsyncFile[bytes], b: ReadableBuffer) -> int:
+        ...
+
+    @overload
+    async def write(self: AsyncFile[str], b: str) -> int:
+        ...
+
+    async def write(self, b: ReadableBuffer | str) -> int:
+        return await to_thread.run_sync(self._fp.write, b)
+
+    @overload
+    async def writelines(
+        self: AsyncFile[bytes], lines: Iterable[ReadableBuffer]
+    ) -> None:
+        ...
+
+    @overload
+    async def writelines(self: AsyncFile[str], lines: Iterable[str]) -> None:
+        ...
+
+    async def writelines(self, lines: Iterable[ReadableBuffer] | Iterable[str]) -> None:
+        return await to_thread.run_sync(self._fp.writelines, lines)
+
+    async def truncate(self, size: int | None = None) -> int:
+        return await to_thread.run_sync(self._fp.truncate, size)
+
+    async def seek(self, offset: int, whence: int | None = os.SEEK_SET) -> int:
+        return await to_thread.run_sync(self._fp.seek, offset, whence)
+
+    async def tell(self) -> int:
+        return await to_thread.run_sync(self._fp.tell)
+
+    async def flush(self) -> None:
+        return await to_thread.run_sync(self._fp.flush)
+
+
+@overload
+async def open_file(
+    file: str | PathLike[str] | int,
+    mode: OpenBinaryMode,
+    buffering: int = ...,
+    encoding: str | None = ...,
+    errors: str | None = ...,
+    newline: str | None = ...,
+    closefd: bool = ...,
+    opener: Callable[[str, int], int] | None = ...,
+) -> AsyncFile[bytes]:
+    ...
+
+
+@overload
+async def open_file(
+    file: str | PathLike[str] | int,
+    mode: OpenTextMode = ...,
+    buffering: int = ...,
+    encoding: str | None = ...,
+    errors: str | None = ...,
+    newline: str | None = ...,
+    closefd: bool = ...,
+    opener: Callable[[str, int], int] | None = ...,
+) -> AsyncFile[str]:
+    ...
+
+
+async def open_file(
+    file: str | PathLike[str] | int,
+    mode: str = "r",
+    buffering: int = -1,
+    encoding: str | None = None,
+    errors: str | None = None,
+    newline: str | None = None,
+    closefd: bool = True,
+    opener: Callable[[str, int], int] | None = None,
+) -> AsyncFile[Any]:
+    """
+    Open a file asynchronously.
+
+    The arguments are exactly the same as for the builtin :func:`open`.
+
+    :return: an asynchronous file object
+
+    """
+    fp = await to_thread.run_sync(
+        open, file, mode, buffering, encoding, errors, newline, closefd, opener
+    )
+    return AsyncFile(fp)
+
+
+def wrap_file(file: IO[AnyStr]) -> AsyncFile[AnyStr]:
+    """
+    Wrap an existing file as an asynchronous file.
+
+    :param file: an existing file-like object
+    :return: an asynchronous file object
+
+    """
+    return AsyncFile(file)
+
+
+@dataclass(eq=False)
+class _PathIterator(AsyncIterator["Path"]):
+    iterator: Iterator[PathLike[str]]
+
+    async def __anext__(self) -> Path:
+        nextval = await to_thread.run_sync(
+            next, self.iterator, None, abandon_on_cancel=True
+        )
+        if nextval is None:
+            raise StopAsyncIteration from None
+
+        return Path(nextval)
+
+
+class Path:
+    """
+    An asynchronous version of :class:`pathlib.Path`.
+
+    This class cannot be substituted for :class:`pathlib.Path` or
+    :class:`pathlib.PurePath`, but it is compatible with the :class:`os.PathLike`
+    interface.
+
+    It implements the Python 3.10 version of :class:`pathlib.Path` interface, except for
+    the deprecated :meth:`~pathlib.Path.link_to` method.
+
+    Any methods that do disk I/O need to be awaited on. These methods are:
+
+    * :meth:`~pathlib.Path.absolute`
+    * :meth:`~pathlib.Path.chmod`
+    * :meth:`~pathlib.Path.cwd`
+    * :meth:`~pathlib.Path.exists`
+    * :meth:`~pathlib.Path.expanduser`
+    * :meth:`~pathlib.Path.group`
+    * :meth:`~pathlib.Path.hardlink_to`
+    * :meth:`~pathlib.Path.home`
+    * :meth:`~pathlib.Path.is_block_device`
+    * :meth:`~pathlib.Path.is_char_device`
+    * :meth:`~pathlib.Path.is_dir`
+    * :meth:`~pathlib.Path.is_fifo`
+    * :meth:`~pathlib.Path.is_file`
+    * :meth:`~pathlib.Path.is_mount`
+    * :meth:`~pathlib.Path.lchmod`
+    * :meth:`~pathlib.Path.lstat`
+    * :meth:`~pathlib.Path.mkdir`
+    * :meth:`~pathlib.Path.open`
+    * :meth:`~pathlib.Path.owner`
+    * :meth:`~pathlib.Path.read_bytes`
+    * :meth:`~pathlib.Path.read_text`
+    * :meth:`~pathlib.Path.readlink`
+    * :meth:`~pathlib.Path.rename`
+    * :meth:`~pathlib.Path.replace`
+    * :meth:`~pathlib.Path.rmdir`
+    * :meth:`~pathlib.Path.samefile`
+    * :meth:`~pathlib.Path.stat`
+    * :meth:`~pathlib.Path.touch`
+    * :meth:`~pathlib.Path.unlink`
+    * :meth:`~pathlib.Path.write_bytes`
+    * :meth:`~pathlib.Path.write_text`
+
+    Additionally, the following methods return an async iterator yielding
+    :class:`~.Path` objects:
+
+    * :meth:`~pathlib.Path.glob`
+    * :meth:`~pathlib.Path.iterdir`
+    * :meth:`~pathlib.Path.rglob`
+    """
+
+    __slots__ = "_path", "__weakref__"
+
+    __weakref__: Any
+
+    def __init__(self, *args: str | PathLike[str]) -> None:
+        self._path: Final[pathlib.Path] = pathlib.Path(*args)
+
+    def __fspath__(self) -> str:
+        return self._path.__fspath__()
+
+    def __str__(self) -> str:
+        return self._path.__str__()
+
+    def __repr__(self) -> str:
+        return f"{self.__class__.__name__}({self.as_posix()!r})"
+
+    def __bytes__(self) -> bytes:
+        return self._path.__bytes__()
+
+    def __hash__(self) -> int:
+        return self._path.__hash__()
+
+    def __eq__(self, other: object) -> bool:
+        target = other._path if isinstance(other, Path) else other
+        return self._path.__eq__(target)
+
+    def __lt__(self, other: pathlib.PurePath | Path) -> bool:
+        target = other._path if isinstance(other, Path) else other
+        return self._path.__lt__(target)
+
+    def __le__(self, other: pathlib.PurePath | Path) -> bool:
+        target = other._path if isinstance(other, Path) else other
+        return self._path.__le__(target)
+
+    def __gt__(self, other: pathlib.PurePath | Path) -> bool:
+        target = other._path if isinstance(other, Path) else other
+        return self._path.__gt__(target)
+
+    def __ge__(self, other: pathlib.PurePath | Path) -> bool:
+        target = other._path if isinstance(other, Path) else other
+        return self._path.__ge__(target)
+
+    def __truediv__(self, other: str | PathLike[str]) -> Path:
+        return Path(self._path / other)
+
+    def __rtruediv__(self, other: str | PathLike[str]) -> Path:
+        return Path(other) / self
+
+    @property
+    def parts(self) -> tuple[str, ...]:
+        return self._path.parts
+
+    @property
+    def drive(self) -> str:
+        return self._path.drive
+
+    @property
+    def root(self) -> str:
+        return self._path.root
+
+    @property
+    def anchor(self) -> str:
+        return self._path.anchor
+
+    @property
+    def parents(self) -> Sequence[Path]:
+        return tuple(Path(p) for p in self._path.parents)
+
+    @property
+    def parent(self) -> Path:
+        return Path(self._path.parent)
+
+    @property
+    def name(self) -> str:
+        return self._path.name
+
+    @property
+    def suffix(self) -> str:
+        return self._path.suffix
+
+    @property
+    def suffixes(self) -> list[str]:
+        return self._path.suffixes
+
+    @property
+    def stem(self) -> str:
+        return self._path.stem
+
+    async def absolute(self) -> Path:
+        path = await to_thread.run_sync(self._path.absolute)
+        return Path(path)
+
+    def as_posix(self) -> str:
+        return self._path.as_posix()
+
+    def as_uri(self) -> str:
+        return self._path.as_uri()
+
+    def match(self, path_pattern: str) -> bool:
+        return self._path.match(path_pattern)
+
+    def is_relative_to(self, other: str | PathLike[str]) -> bool:
+        try:
+            self.relative_to(other)
+            return True
+        except ValueError:
+            return False
+
+    async def is_junction(self) -> bool:
+        return await to_thread.run_sync(self._path.is_junction)
+
+    async def chmod(self, mode: int, *, follow_symlinks: bool = True) -> None:
+        func = partial(os.chmod, follow_symlinks=follow_symlinks)
+        return await to_thread.run_sync(func, self._path, mode)
+
+    @classmethod
+    async def cwd(cls) -> Path:
+        path = await to_thread.run_sync(pathlib.Path.cwd)
+        return cls(path)
+
+    async def exists(self) -> bool:
+        return await to_thread.run_sync(self._path.exists, abandon_on_cancel=True)
+
+    async def expanduser(self) -> Path:
+        return Path(
+            await to_thread.run_sync(self._path.expanduser, abandon_on_cancel=True)
+        )
+
+    def glob(self, pattern: str) -> AsyncIterator[Path]:
+        gen = self._path.glob(pattern)
+        return _PathIterator(gen)
+
+    async def group(self) -> str:
+        return await to_thread.run_sync(self._path.group, abandon_on_cancel=True)
+
+    async def hardlink_to(
+        self, target: str | bytes | PathLike[str] | PathLike[bytes]
+    ) -> None:
+        if isinstance(target, Path):
+            target = target._path
+
+        await to_thread.run_sync(os.link, target, self)
+
+    @classmethod
+    async def home(cls) -> Path:
+        home_path = await to_thread.run_sync(pathlib.Path.home)
+        return cls(home_path)
+
+    def is_absolute(self) -> bool:
+        return self._path.is_absolute()
+
+    async def is_block_device(self) -> bool:
+        return await to_thread.run_sync(
+            self._path.is_block_device, abandon_on_cancel=True
+        )
+
+    async def is_char_device(self) -> bool:
+        return await to_thread.run_sync(
+            self._path.is_char_device, abandon_on_cancel=True
+        )
+
+    async def is_dir(self) -> bool:
+        return await to_thread.run_sync(self._path.is_dir, abandon_on_cancel=True)
+
+    async def is_fifo(self) -> bool:
+        return await to_thread.run_sync(self._path.is_fifo, abandon_on_cancel=True)
+
+    async def is_file(self) -> bool:
+        return await to_thread.run_sync(self._path.is_file, abandon_on_cancel=True)
+
+    async def is_mount(self) -> bool:
+        return await to_thread.run_sync(
+            os.path.ismount, self._path, abandon_on_cancel=True
+        )
+
+    def is_reserved(self) -> bool:
+        return self._path.is_reserved()
+
+    async def is_socket(self) -> bool:
+        return await to_thread.run_sync(self._path.is_socket, abandon_on_cancel=True)
+
+    async def is_symlink(self) -> bool:
+        return await to_thread.run_sync(self._path.is_symlink, abandon_on_cancel=True)
+
+    def iterdir(self) -> AsyncIterator[Path]:
+        gen = self._path.iterdir()
+        return _PathIterator(gen)
+
+    def joinpath(self, *args: str | PathLike[str]) -> Path:
+        return Path(self._path.joinpath(*args))
+
+    async def lchmod(self, mode: int) -> None:
+        await to_thread.run_sync(self._path.lchmod, mode)
+
+    async def lstat(self) -> os.stat_result:
+        return await to_thread.run_sync(self._path.lstat, abandon_on_cancel=True)
+
+    async def mkdir(
+        self, mode: int = 0o777, parents: bool = False, exist_ok: bool = False
+    ) -> None:
+        await to_thread.run_sync(self._path.mkdir, mode, parents, exist_ok)
+
+    @overload
+    async def open(
+        self,
+        mode: OpenBinaryMode,
+        buffering: int = ...,
+        encoding: str | None = ...,
+        errors: str | None = ...,
+        newline: str | None = ...,
+    ) -> AsyncFile[bytes]:
+        ...
+
+    @overload
+    async def open(
+        self,
+        mode: OpenTextMode = ...,
+        buffering: int = ...,
+        encoding: str | None = ...,
+        errors: str | None = ...,
+        newline: str | None = ...,
+    ) -> AsyncFile[str]:
+        ...
+
+    async def open(
+        self,
+        mode: str = "r",
+        buffering: int = -1,
+        encoding: str | None = None,
+        errors: str | None = None,
+        newline: str | None = None,
+    ) -> AsyncFile[Any]:
+        fp = await to_thread.run_sync(
+            self._path.open, mode, buffering, encoding, errors, newline
+        )
+        return AsyncFile(fp)
+
+    async def owner(self) -> str:
+        return await to_thread.run_sync(self._path.owner, abandon_on_cancel=True)
+
+    async def read_bytes(self) -> bytes:
+        return await to_thread.run_sync(self._path.read_bytes)
+
+    async def read_text(
+        self, encoding: str | None = None, errors: str | None = None
+    ) -> str:
+        return await to_thread.run_sync(self._path.read_text, encoding, errors)
+
+    if sys.version_info >= (3, 12):
+
+        def relative_to(
+            self, *other: str | PathLike[str], walk_up: bool = False
+        ) -> Path:
+            return Path(self._path.relative_to(*other, walk_up=walk_up))
+
+    else:
+
+        def relative_to(self, *other: str | PathLike[str]) -> Path:
+            return Path(self._path.relative_to(*other))
+
+    async def readlink(self) -> Path:
+        target = await to_thread.run_sync(os.readlink, self._path)
+        return Path(target)
+
+    async def rename(self, target: str | pathlib.PurePath | Path) -> Path:
+        if isinstance(target, Path):
+            target = target._path
+
+        await to_thread.run_sync(self._path.rename, target)
+        return Path(target)
+
+    async def replace(self, target: str | pathlib.PurePath | Path) -> Path:
+        if isinstance(target, Path):
+            target = target._path
+
+        await to_thread.run_sync(self._path.replace, target)
+        return Path(target)
+
+    async def resolve(self, strict: bool = False) -> Path:
+        func = partial(self._path.resolve, strict=strict)
+        return Path(await to_thread.run_sync(func, abandon_on_cancel=True))
+
+    def rglob(self, pattern: str) -> AsyncIterator[Path]:
+        gen = self._path.rglob(pattern)
+        return _PathIterator(gen)
+
+    async def rmdir(self) -> None:
+        await to_thread.run_sync(self._path.rmdir)
+
+    async def samefile(self, other_path: str | PathLike[str]) -> bool:
+        if isinstance(other_path, Path):
+            other_path = other_path._path
+
+        return await to_thread.run_sync(
+            self._path.samefile, other_path, abandon_on_cancel=True
+        )
+
+    async def stat(self, *, follow_symlinks: bool = True) -> os.stat_result:
+        func = partial(os.stat, follow_symlinks=follow_symlinks)
+        return await to_thread.run_sync(func, self._path, abandon_on_cancel=True)
+
+    async def symlink_to(
+        self,
+        target: str | bytes | PathLike[str] | PathLike[bytes],
+        target_is_directory: bool = False,
+    ) -> None:
+        if isinstance(target, Path):
+            target = target._path
+
+        await to_thread.run_sync(self._path.symlink_to, target, target_is_directory)
+
+    async def touch(self, mode: int = 0o666, exist_ok: bool = True) -> None:
+        await to_thread.run_sync(self._path.touch, mode, exist_ok)
+
+    async def unlink(self, missing_ok: bool = False) -> None:
+        try:
+            await to_thread.run_sync(self._path.unlink)
+        except FileNotFoundError:
+            if not missing_ok:
+                raise
+
+    if sys.version_info >= (3, 12):
+
+        async def walk(
+            self,
+            top_down: bool = True,
+            on_error: Callable[[OSError], object] | None = None,
+            follow_symlinks: bool = False,
+        ) -> AsyncIterator[tuple[Path, list[str], list[str]]]:
+            def get_next_value() -> tuple[pathlib.Path, list[str], list[str]] | None:
+                try:
+                    return next(gen)
+                except StopIteration:
+                    return None
+
+            gen = self._path.walk(top_down, on_error, follow_symlinks)
+            while True:
+                value = await to_thread.run_sync(get_next_value)
+                if value is None:
+                    return
+
+                root, dirs, paths = value
+                yield Path(root), dirs, paths
+
+    def with_name(self, name: str) -> Path:
+        return Path(self._path.with_name(name))
+
+    def with_stem(self, stem: str) -> Path:
+        return Path(self._path.with_name(stem + self._path.suffix))
+
+    def with_suffix(self, suffix: str) -> Path:
+        return Path(self._path.with_suffix(suffix))
+
+    def with_segments(self, *pathsegments: str | PathLike[str]) -> Path:
+        return Path(*pathsegments)
+
+    async def write_bytes(self, data: bytes) -> int:
+        return await to_thread.run_sync(self._path.write_bytes, data)
+
+    async def write_text(
+        self,
+        data: str,
+        encoding: str | None = None,
+        errors: str | None = None,
+        newline: str | None = None,
+    ) -> int:
+        # Path.write_text() does not support the "newline" parameter before Python 3.10
+        def sync_write_text() -> int:
+            with self._path.open(
+                "w", encoding=encoding, errors=errors, newline=newline
+            ) as fp:
+                return fp.write(data)
+
+        return await to_thread.run_sync(sync_write_text)
+
+
+PathLike.register(Path)
diff --git a/llm/Lib/site-packages/anyio/_core/_resources.py b/llm/Lib/site-packages/anyio/_core/_resources.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9a5344aef2962670f9b305a02cd0b11f2087d2f
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_core/_resources.py
@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+from ..abc import AsyncResource
+from ._tasks import CancelScope
+
+
+async def aclose_forcefully(resource: AsyncResource) -> None:
+    """
+    Close an asynchronous resource in a cancelled scope.
+
+    Doing this closes the resource without waiting on anything.
+
+    :param resource: the resource to close
+
+    """
+    with CancelScope() as scope:
+        scope.cancel()
+        await resource.aclose()
diff --git a/llm/Lib/site-packages/anyio/_core/_signals.py b/llm/Lib/site-packages/anyio/_core/_signals.py
new file mode 100644
index 0000000000000000000000000000000000000000..115c749bd9338b9cfaee071e3eb97d07ddff7fe9
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_core/_signals.py
@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from collections.abc import AsyncIterator
+from signal import Signals
+from typing import ContextManager
+
+from ._eventloop import get_async_backend
+
+
+def open_signal_receiver(*signals: Signals) -> ContextManager[AsyncIterator[Signals]]:
+    """
+    Start receiving operating system signals.
+
+    :param signals: signals to receive (e.g. ``signal.SIGINT``)
+    :return: an asynchronous context manager for an asynchronous iterator which yields
+        signal numbers
+
+    .. warning:: Windows does not support signals natively so it is best to avoid
+        relying on this in cross-platform applications.
+
+    .. warning:: On asyncio, this permanently replaces any previous signal handler for
+        the given signals, as set via :meth:`~asyncio.loop.add_signal_handler`.
+
+    """
+    return get_async_backend().open_signal_receiver(*signals)
diff --git a/llm/Lib/site-packages/anyio/_core/_sockets.py b/llm/Lib/site-packages/anyio/_core/_sockets.py
new file mode 100644
index 0000000000000000000000000000000000000000..0f0a3142fb257883e233058099efe9dd0daf3d71
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_core/_sockets.py
@@ -0,0 +1,716 @@
+from __future__ import annotations
+
+import errno
+import os
+import socket
+import ssl
+import stat
+import sys
+from collections.abc import Awaitable
+from ipaddress import IPv6Address, ip_address
+from os import PathLike, chmod
+from socket import AddressFamily, SocketKind
+from typing import Any, Literal, cast, overload
+
+from .. import to_thread
+from ..abc import (
+    ConnectedUDPSocket,
+    ConnectedUNIXDatagramSocket,
+    IPAddressType,
+    IPSockAddrType,
+    SocketListener,
+    SocketStream,
+    UDPSocket,
+    UNIXDatagramSocket,
+    UNIXSocketStream,
+)
+from ..streams.stapled import MultiListener
+from ..streams.tls import TLSStream
+from ._eventloop import get_async_backend
+from ._resources import aclose_forcefully
+from ._synchronization import Event
+from ._tasks import create_task_group, move_on_after
+
+if sys.version_info < (3, 11):
+    from exceptiongroup import ExceptionGroup
+
+IPPROTO_IPV6 = getattr(socket, "IPPROTO_IPV6", 41)  # https://bugs.python.org/issue29515
+
+AnyIPAddressFamily = Literal[
+    AddressFamily.AF_UNSPEC, AddressFamily.AF_INET, AddressFamily.AF_INET6
+]
+IPAddressFamily = Literal[AddressFamily.AF_INET, AddressFamily.AF_INET6]
+
+
+# tls_hostname given
+@overload
+async def connect_tcp(
+    remote_host: IPAddressType,
+    remote_port: int,
+    *,
+    local_host: IPAddressType | None = ...,
+    ssl_context: ssl.SSLContext | None = ...,
+    tls_standard_compatible: bool = ...,
+    tls_hostname: str,
+    happy_eyeballs_delay: float = ...,
+) -> TLSStream:
+    ...
+
+
+# ssl_context given
+@overload
+async def connect_tcp(
+    remote_host: IPAddressType,
+    remote_port: int,
+    *,
+    local_host: IPAddressType | None = ...,
+    ssl_context: ssl.SSLContext,
+    tls_standard_compatible: bool = ...,
+    tls_hostname: str | None = ...,
+    happy_eyeballs_delay: float = ...,
+) -> TLSStream:
+    ...
+
+
+# tls=True
+@overload
+async def connect_tcp(
+    remote_host: IPAddressType,
+    remote_port: int,
+    *,
+    local_host: IPAddressType | None = ...,
+    tls: Literal[True],
+    ssl_context: ssl.SSLContext | None = ...,
+    tls_standard_compatible: bool = ...,
+    tls_hostname: str | None = ...,
+    happy_eyeballs_delay: float = ...,
+) -> TLSStream:
+    ...
+
+
+# tls=False
+@overload
+async def connect_tcp(
+    remote_host: IPAddressType,
+    remote_port: int,
+    *,
+    local_host: IPAddressType | None = ...,
+    tls: Literal[False],
+    ssl_context: ssl.SSLContext | None = ...,
+    tls_standard_compatible: bool = ...,
+    tls_hostname: str | None = ...,
+    happy_eyeballs_delay: float = ...,
+) -> SocketStream:
+    ...
+
+
+# No TLS arguments
+@overload
+async def connect_tcp(
+    remote_host: IPAddressType,
+    remote_port: int,
+    *,
+    local_host: IPAddressType | None = ...,
+    happy_eyeballs_delay: float = ...,
+) -> SocketStream:
+    ...
+
+
+async def connect_tcp(
+    remote_host: IPAddressType,
+    remote_port: int,
+    *,
+    local_host: IPAddressType | None = None,
+    tls: bool = False,
+    ssl_context: ssl.SSLContext | None = None,
+    tls_standard_compatible: bool = True,
+    tls_hostname: str | None = None,
+    happy_eyeballs_delay: float = 0.25,
+) -> SocketStream | TLSStream:
+    """
+    Connect to a host using the TCP protocol.
+
+    This function implements the stateless version of the Happy Eyeballs algorithm (RFC
+    6555). If ``remote_host`` is a host name that resolves to multiple IP addresses,
+    each one is tried until one connection attempt succeeds. If the first attempt does
+    not connected within 250 milliseconds, a second attempt is started using the next
+    address in the list, and so on. On IPv6 enabled systems, an IPv6 address (if
+    available) is tried first.
+
+    When the connection has been established, a TLS handshake will be done if either
+    ``ssl_context`` or ``tls_hostname`` is not ``None``, or if ``tls`` is ``True``.
+
+    :param remote_host: the IP address or host name to connect to
+    :param remote_port: port on the target host to connect to
+    :param local_host: the interface address or name to bind the socket to before
+        connecting
+    :param tls: ``True`` to do a TLS handshake with the connected stream and return a
+        :class:`~anyio.streams.tls.TLSStream` instead
+    :param ssl_context: the SSL context object to use (if omitted, a default context is
+        created)
+    :param tls_standard_compatible: If ``True``, performs the TLS shutdown handshake
+        before closing the stream and requires that the server does this as well.
+        Otherwise, :exc:`~ssl.SSLEOFError` may be raised during reads from the stream.
+        Some protocols, such as HTTP, require this option to be ``False``.
+        See :meth:`~ssl.SSLContext.wrap_socket` for details.
+    :param tls_hostname: host name to check the server certificate against (defaults to
+        the value of ``remote_host``)
+    :param happy_eyeballs_delay: delay (in seconds) before starting the next connection
+        attempt
+    :return: a socket stream object if no TLS handshake was done, otherwise a TLS stream
+    :raises OSError: if the connection attempt fails
+
+    """
+    # Placed here due to https://github.com/python/mypy/issues/7057
+    connected_stream: SocketStream | None = None
+
+    async def try_connect(remote_host: str, event: Event) -> None:
+        nonlocal connected_stream
+        try:
+            stream = await asynclib.connect_tcp(remote_host, remote_port, local_address)
+        except OSError as exc:
+            oserrors.append(exc)
+            return
+        else:
+            if connected_stream is None:
+                connected_stream = stream
+                tg.cancel_scope.cancel()
+            else:
+                await stream.aclose()
+        finally:
+            event.set()
+
+    asynclib = get_async_backend()
+    local_address: IPSockAddrType | None = None
+    family = socket.AF_UNSPEC
+    if local_host:
+        gai_res = await getaddrinfo(str(local_host), None)
+        family, *_, local_address = gai_res[0]
+
+    target_host = str(remote_host)
+    try:
+        addr_obj = ip_address(remote_host)
+    except ValueError:
+        # getaddrinfo() will raise an exception if name resolution fails
+        gai_res = await getaddrinfo(
+            target_host, remote_port, family=family, type=socket.SOCK_STREAM
+        )
+
+        # Organize the list so that the first address is an IPv6 address (if available)
+        # and the second one is an IPv4 addresses. The rest can be in whatever order.
+        v6_found = v4_found = False
+        target_addrs: list[tuple[socket.AddressFamily, str]] = []
+        for af, *rest, sa in gai_res:
+            if af == socket.AF_INET6 and not v6_found:
+                v6_found = True
+                target_addrs.insert(0, (af, sa[0]))
+            elif af == socket.AF_INET and not v4_found and v6_found:
+                v4_found = True
+                target_addrs.insert(1, (af, sa[0]))
+            else:
+                target_addrs.append((af, sa[0]))
+    else:
+        if isinstance(addr_obj, IPv6Address):
+            target_addrs = [(socket.AF_INET6, addr_obj.compressed)]
+        else:
+            target_addrs = [(socket.AF_INET, addr_obj.compressed)]
+
+    oserrors: list[OSError] = []
+    async with create_task_group() as tg:
+        for i, (af, addr) in enumerate(target_addrs):
+            event = Event()
+            tg.start_soon(try_connect, addr, event)
+            with move_on_after(happy_eyeballs_delay):
+                await event.wait()
+
+    if connected_stream is None:
+        cause = (
+            oserrors[0]
+            if len(oserrors) == 1
+            else ExceptionGroup("multiple connection attempts failed", oserrors)
+        )
+        raise OSError("All connection attempts failed") from cause
+
+    if tls or tls_hostname or ssl_context:
+        try:
+            return await TLSStream.wrap(
+                connected_stream,
+                server_side=False,
+                hostname=tls_hostname or str(remote_host),
+                ssl_context=ssl_context,
+                standard_compatible=tls_standard_compatible,
+            )
+        except BaseException:
+            await aclose_forcefully(connected_stream)
+            raise
+
+    return connected_stream
+
+
+async def connect_unix(path: str | bytes | PathLike[Any]) -> UNIXSocketStream:
+    """
+    Connect to the given UNIX socket.
+
+    Not available on Windows.
+
+    :param path: path to the socket
+    :return: a socket stream object
+
+    """
+    path = os.fspath(path)
+    return await get_async_backend().connect_unix(path)
+
+
+async def create_tcp_listener(
+    *,
+    local_host: IPAddressType | None = None,
+    local_port: int = 0,
+    family: AnyIPAddressFamily = socket.AddressFamily.AF_UNSPEC,
+    backlog: int = 65536,
+    reuse_port: bool = False,
+) -> MultiListener[SocketStream]:
+    """
+    Create a TCP socket listener.
+
+    :param local_port: port number to listen on
+    :param local_host: IP address of the interface to listen on. If omitted, listen on
+        all IPv4 and IPv6 interfaces. To listen on all interfaces on a specific address
+        family, use ``0.0.0.0`` for IPv4 or ``::`` for IPv6.
+    :param family: address family (used if ``local_host`` was omitted)
+    :param backlog: maximum number of queued incoming connections (up to a maximum of
+        2**16, or 65536)
+    :param reuse_port: ``True`` to allow multiple sockets to bind to the same
+        address/port (not supported on Windows)
+    :return: a list of listener objects
+
+    """
+    asynclib = get_async_backend()
+    backlog = min(backlog, 65536)
+    local_host = str(local_host) if local_host is not None else None
+    gai_res = await getaddrinfo(
+        local_host,
+        local_port,
+        family=family,
+        type=socket.SocketKind.SOCK_STREAM if sys.platform == "win32" else 0,
+        flags=socket.AI_PASSIVE | socket.AI_ADDRCONFIG,
+    )
+    listeners: list[SocketListener] = []
+    try:
+        # The set() is here to work around a glibc bug:
+        # https://sourceware.org/bugzilla/show_bug.cgi?id=14969
+        sockaddr: tuple[str, int] | tuple[str, int, int, int]
+        for fam, kind, *_, sockaddr in sorted(set(gai_res)):
+            # Workaround for an uvloop bug where we don't get the correct scope ID for
+            # IPv6 link-local addresses when passing type=socket.SOCK_STREAM to
+            # getaddrinfo(): https://github.com/MagicStack/uvloop/issues/539
+            if sys.platform != "win32" and kind is not SocketKind.SOCK_STREAM:
+                continue
+
+            raw_socket = socket.socket(fam)
+            raw_socket.setblocking(False)
+
+            # For Windows, enable exclusive address use. For others, enable address
+            # reuse.
+            if sys.platform == "win32":
+                raw_socket.setsockopt(socket.SOL_SOCKET, socket.SO_EXCLUSIVEADDRUSE, 1)
+            else:
+                raw_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+
+            if reuse_port:
+                raw_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEPORT, 1)
+
+            # If only IPv6 was requested, disable dual stack operation
+            if fam == socket.AF_INET6:
+                raw_socket.setsockopt(IPPROTO_IPV6, socket.IPV6_V6ONLY, 1)
+
+                # Workaround for #554
+                if "%" in sockaddr[0]:
+                    addr, scope_id = sockaddr[0].split("%", 1)
+                    sockaddr = (addr, sockaddr[1], 0, int(scope_id))
+
+            raw_socket.bind(sockaddr)
+            raw_socket.listen(backlog)
+            listener = asynclib.create_tcp_listener(raw_socket)
+            listeners.append(listener)
+    except BaseException:
+        for listener in listeners:
+            await listener.aclose()
+
+        raise
+
+    return MultiListener(listeners)
+
+
+async def create_unix_listener(
+    path: str | bytes | PathLike[Any],
+    *,
+    mode: int | None = None,
+    backlog: int = 65536,
+) -> SocketListener:
+    """
+    Create a UNIX socket listener.
+
+    Not available on Windows.
+
+    :param path: path of the socket
+    :param mode: permissions to set on the socket
+    :param backlog: maximum number of queued incoming connections (up to a maximum of
+        2**16, or 65536)
+    :return: a listener object
+
+    .. versionchanged:: 3.0
+        If a socket already exists on the file system in the given path, it will be
+        removed first.
+
+    """
+    backlog = min(backlog, 65536)
+    raw_socket = await setup_unix_local_socket(path, mode, socket.SOCK_STREAM)
+    try:
+        raw_socket.listen(backlog)
+        return get_async_backend().create_unix_listener(raw_socket)
+    except BaseException:
+        raw_socket.close()
+        raise
+
+
+async def create_udp_socket(
+    family: AnyIPAddressFamily = AddressFamily.AF_UNSPEC,
+    *,
+    local_host: IPAddressType | None = None,
+    local_port: int = 0,
+    reuse_port: bool = False,
+) -> UDPSocket:
+    """
+    Create a UDP socket.
+
+    If ``port`` has been given, the socket will be bound to this port on the local
+    machine, making this socket suitable for providing UDP based services.
+
+    :param family: address family (``AF_INET`` or ``AF_INET6``) – automatically
+        determined from ``local_host`` if omitted
+    :param local_host: IP address or host name of the local interface to bind to
+    :param local_port: local port to bind to
+    :param reuse_port: ``True`` to allow multiple sockets to bind to the same
+        address/port (not supported on Windows)
+    :return: a UDP socket
+
+    """
+    if family is AddressFamily.AF_UNSPEC and not local_host:
+        raise ValueError('Either "family" or "local_host" must be given')
+
+    if local_host:
+        gai_res = await getaddrinfo(
+            str(local_host),
+            local_port,
+            family=family,
+            type=socket.SOCK_DGRAM,
+            flags=socket.AI_PASSIVE | socket.AI_ADDRCONFIG,
+        )
+        family = cast(AnyIPAddressFamily, gai_res[0][0])
+        local_address = gai_res[0][-1]
+    elif family is AddressFamily.AF_INET6:
+        local_address = ("::", 0)
+    else:
+        local_address = ("0.0.0.0", 0)
+
+    sock = await get_async_backend().create_udp_socket(
+        family, local_address, None, reuse_port
+    )
+    return cast(UDPSocket, sock)
+
+
+async def create_connected_udp_socket(
+    remote_host: IPAddressType,
+    remote_port: int,
+    *,
+    family: AnyIPAddressFamily = AddressFamily.AF_UNSPEC,
+    local_host: IPAddressType | None = None,
+    local_port: int = 0,
+    reuse_port: bool = False,
+) -> ConnectedUDPSocket:
+    """
+    Create a connected UDP socket.
+
+    Connected UDP sockets can only communicate with the specified remote host/port, an
+    any packets sent from other sources are dropped.
+
+    :param remote_host: remote host to set as the default target
+    :param remote_port: port on the remote host to set as the default target
+    :param family: address family (``AF_INET`` or ``AF_INET6``) – automatically
+        determined from ``local_host`` or ``remote_host`` if omitted
+    :param local_host: IP address or host name of the local interface to bind to
+    :param local_port: local port to bind to
+    :param reuse_port: ``True`` to allow multiple sockets to bind to the same
+        address/port (not supported on Windows)
+    :return: a connected UDP socket
+
+    """
+    local_address = None
+    if local_host:
+        gai_res = await getaddrinfo(
+            str(local_host),
+            local_port,
+            family=family,
+            type=socket.SOCK_DGRAM,
+            flags=socket.AI_PASSIVE | socket.AI_ADDRCONFIG,
+        )
+        family = cast(AnyIPAddressFamily, gai_res[0][0])
+        local_address = gai_res[0][-1]
+
+    gai_res = await getaddrinfo(
+        str(remote_host), remote_port, family=family, type=socket.SOCK_DGRAM
+    )
+    family = cast(AnyIPAddressFamily, gai_res[0][0])
+    remote_address = gai_res[0][-1]
+
+    sock = await get_async_backend().create_udp_socket(
+        family, local_address, remote_address, reuse_port
+    )
+    return cast(ConnectedUDPSocket, sock)
+
+
+async def create_unix_datagram_socket(
+    *,
+    local_path: None | str | bytes | PathLike[Any] = None,
+    local_mode: int | None = None,
+) -> UNIXDatagramSocket:
+    """
+    Create a UNIX datagram socket.
+
+    Not available on Windows.
+
+    If ``local_path`` has been given, the socket will be bound to this path, making this
+    socket suitable for receiving datagrams from other processes. Other processes can
+    send datagrams to this socket only if ``local_path`` is set.
+
+    If a socket already exists on the file system in the ``local_path``, it will be
+    removed first.
+
+    :param local_path: the path on which to bind to
+    :param local_mode: permissions to set on the local socket
+    :return: a UNIX datagram socket
+
+    """
+    raw_socket = await setup_unix_local_socket(
+        local_path, local_mode, socket.SOCK_DGRAM
+    )
+    return await get_async_backend().create_unix_datagram_socket(raw_socket, None)
+
+
+async def create_connected_unix_datagram_socket(
+    remote_path: str | bytes | PathLike[Any],
+    *,
+    local_path: None | str | bytes | PathLike[Any] = None,
+    local_mode: int | None = None,
+) -> ConnectedUNIXDatagramSocket:
+    """
+    Create a connected UNIX datagram socket.
+
+    Connected datagram sockets can only communicate with the specified remote path.
+
+    If ``local_path`` has been given, the socket will be bound to this path, making
+    this socket suitable for receiving datagrams from other processes. Other processes
+    can send datagrams to this socket only if ``local_path`` is set.
+
+    If a socket already exists on the file system in the ``local_path``, it will be
+    removed first.
+
+    :param remote_path: the path to set as the default target
+    :param local_path: the path on which to bind to
+    :param local_mode: permissions to set on the local socket
+    :return: a connected UNIX datagram socket
+
+    """
+    remote_path = os.fspath(remote_path)
+    raw_socket = await setup_unix_local_socket(
+        local_path, local_mode, socket.SOCK_DGRAM
+    )
+    return await get_async_backend().create_unix_datagram_socket(
+        raw_socket, remote_path
+    )
+
+
+async def getaddrinfo(
+    host: bytes | str | None,
+    port: str | int | None,
+    *,
+    family: int | AddressFamily = 0,
+    type: int | SocketKind = 0,
+    proto: int = 0,
+    flags: int = 0,
+) -> list[tuple[AddressFamily, SocketKind, int, str, tuple[str, int]]]:
+    """
+    Look up a numeric IP address given a host name.
+
+    Internationalized domain names are translated according to the (non-transitional)
+    IDNA 2008 standard.
+
+    .. note:: 4-tuple IPv6 socket addresses are automatically converted to 2-tuples of
+        (host, port), unlike what :func:`socket.getaddrinfo` does.
+
+    :param host: host name
+    :param port: port number
+    :param family: socket family (`'AF_INET``, ...)
+    :param type: socket type (``SOCK_STREAM``, ...)
+    :param proto: protocol number
+    :param flags: flags to pass to upstream ``getaddrinfo()``
+    :return: list of tuples containing (family, type, proto, canonname, sockaddr)
+
+    .. seealso:: :func:`socket.getaddrinfo`
+
+    """
+    # Handle unicode hostnames
+    if isinstance(host, str):
+        try:
+            encoded_host: bytes | None = host.encode("ascii")
+        except UnicodeEncodeError:
+            import idna
+
+            encoded_host = idna.encode(host, uts46=True)
+    else:
+        encoded_host = host
+
+    gai_res = await get_async_backend().getaddrinfo(
+        encoded_host, port, family=family, type=type, proto=proto, flags=flags
+    )
+    return [
+        (family, type, proto, canonname, convert_ipv6_sockaddr(sockaddr))
+        for family, type, proto, canonname, sockaddr in gai_res
+    ]
+
+
+def getnameinfo(sockaddr: IPSockAddrType, flags: int = 0) -> Awaitable[tuple[str, str]]:
+    """
+    Look up the host name of an IP address.
+
+    :param sockaddr: socket address (e.g. (ipaddress, port) for IPv4)
+    :param flags: flags to pass to upstream ``getnameinfo()``
+    :return: a tuple of (host name, service name)
+
+    .. seealso:: :func:`socket.getnameinfo`
+
+    """
+    return get_async_backend().getnameinfo(sockaddr, flags)
+
+
+def wait_socket_readable(sock: socket.socket) -> Awaitable[None]:
+    """
+    Wait until the given socket has data to be read.
+
+    This does **NOT** work on Windows when using the asyncio backend with a proactor
+    event loop (default on py3.8+).
+
+    .. warning:: Only use this on raw sockets that have not been wrapped by any higher
+        level constructs like socket streams!
+
+    :param sock: a socket object
+    :raises ~anyio.ClosedResourceError: if the socket was closed while waiting for the
+        socket to become readable
+    :raises ~anyio.BusyResourceError: if another task is already waiting for the socket
+        to become readable
+
+    """
+    return get_async_backend().wait_socket_readable(sock)
+
+
+def wait_socket_writable(sock: socket.socket) -> Awaitable[None]:
+    """
+    Wait until the given socket can be written to.
+
+    This does **NOT** work on Windows when using the asyncio backend with a proactor
+    event loop (default on py3.8+).
+
+    .. warning:: Only use this on raw sockets that have not been wrapped by any higher
+        level constructs like socket streams!
+
+    :param sock: a socket object
+    :raises ~anyio.ClosedResourceError: if the socket was closed while waiting for the
+        socket to become writable
+    :raises ~anyio.BusyResourceError: if another task is already waiting for the socket
+        to become writable
+
+    """
+    return get_async_backend().wait_socket_writable(sock)
+
+
+#
+# Private API
+#
+
+
+def convert_ipv6_sockaddr(
+    sockaddr: tuple[str, int, int, int] | tuple[str, int],
+) -> tuple[str, int]:
+    """
+    Convert a 4-tuple IPv6 socket address to a 2-tuple (address, port) format.
+
+    If the scope ID is nonzero, it is added to the address, separated with ``%``.
+    Otherwise the flow id and scope id are simply cut off from the tuple.
+    Any other kinds of socket addresses are returned as-is.
+
+    :param sockaddr: the result of :meth:`~socket.socket.getsockname`
+    :return: the converted socket address
+
+    """
+    # This is more complicated than it should be because of MyPy
+    if isinstance(sockaddr, tuple) and len(sockaddr) == 4:
+        host, port, flowinfo, scope_id = sockaddr
+        if scope_id:
+            # PyPy (as of v7.3.11) leaves the interface name in the result, so
+            # we discard it and only get the scope ID from the end
+            # (https://foss.heptapod.net/pypy/pypy/-/issues/3938)
+            host = host.split("%")[0]
+
+            # Add scope_id to the address
+            return f"{host}%{scope_id}", port
+        else:
+            return host, port
+    else:
+        return sockaddr
+
+
+async def setup_unix_local_socket(
+    path: None | str | bytes | PathLike[Any],
+    mode: int | None,
+    socktype: int,
+) -> socket.socket:
+    """
+    Create a UNIX local socket object, deleting the socket at the given path if it
+    exists.
+
+    Not available on Windows.
+
+    :param path: path of the socket
+    :param mode: permissions to set on the socket
+    :param socktype: socket.SOCK_STREAM or socket.SOCK_DGRAM
+
+    """
+    path_str: str | bytes | None
+    if path is not None:
+        path_str = os.fspath(path)
+
+        # Copied from pathlib...
+        try:
+            stat_result = os.stat(path)
+        except OSError as e:
+            if e.errno not in (errno.ENOENT, errno.ENOTDIR, errno.EBADF, errno.ELOOP):
+                raise
+        else:
+            if stat.S_ISSOCK(stat_result.st_mode):
+                os.unlink(path)
+    else:
+        path_str = None
+
+    raw_socket = socket.socket(socket.AF_UNIX, socktype)
+    raw_socket.setblocking(False)
+
+    if path_str is not None:
+        try:
+            await to_thread.run_sync(raw_socket.bind, path_str, abandon_on_cancel=True)
+            if mode is not None:
+                await to_thread.run_sync(chmod, path_str, mode, abandon_on_cancel=True)
+        except BaseException:
+            raw_socket.close()
+            raise
+
+    return raw_socket
diff --git a/llm/Lib/site-packages/anyio/_core/_streams.py b/llm/Lib/site-packages/anyio/_core/_streams.py
new file mode 100644
index 0000000000000000000000000000000000000000..aa6b0c222ad99d4bd7f285238c09e02a66f10e8a
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_core/_streams.py
@@ -0,0 +1,52 @@
+from __future__ import annotations
+
+import math
+from typing import Tuple, TypeVar
+from warnings import warn
+
+from ..streams.memory import (
+    MemoryObjectReceiveStream,
+    MemoryObjectSendStream,
+    MemoryObjectStreamState,
+)
+
+T_Item = TypeVar("T_Item")
+
+
+class create_memory_object_stream(
+    Tuple[MemoryObjectSendStream[T_Item], MemoryObjectReceiveStream[T_Item]],
+):
+    """
+    Create a memory object stream.
+
+    The stream's item type can be annotated like
+    :func:`create_memory_object_stream[T_Item]`.
+
+    :param max_buffer_size: number of items held in the buffer until ``send()`` starts
+        blocking
+    :param item_type: old way of marking the streams with the right generic type for
+        static typing (does nothing on AnyIO 4)
+
+        .. deprecated:: 4.0
+          Use ``create_memory_object_stream[YourItemType](...)`` instead.
+    :return: a tuple of (send stream, receive stream)
+
+    """
+
+    def __new__(  # type: ignore[misc]
+        cls, max_buffer_size: float = 0, item_type: object = None
+    ) -> tuple[MemoryObjectSendStream[T_Item], MemoryObjectReceiveStream[T_Item]]:
+        if max_buffer_size != math.inf and not isinstance(max_buffer_size, int):
+            raise ValueError("max_buffer_size must be either an integer or math.inf")
+        if max_buffer_size < 0:
+            raise ValueError("max_buffer_size cannot be negative")
+        if item_type is not None:
+            warn(
+                "The item_type argument has been deprecated in AnyIO 4.0. "
+                "Use create_memory_object_stream[YourItemType](...) instead.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+
+        state = MemoryObjectStreamState[T_Item](max_buffer_size)
+        return (MemoryObjectSendStream(state), MemoryObjectReceiveStream(state))
diff --git a/llm/Lib/site-packages/anyio/_core/_subprocesses.py b/llm/Lib/site-packages/anyio/_core/_subprocesses.py
new file mode 100644
index 0000000000000000000000000000000000000000..5d5d7b768a1c11c668583856176d2861b7354cb4
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_core/_subprocesses.py
@@ -0,0 +1,140 @@
+from __future__ import annotations
+
+from collections.abc import AsyncIterable, Mapping, Sequence
+from io import BytesIO
+from os import PathLike
+from subprocess import DEVNULL, PIPE, CalledProcessError, CompletedProcess
+from typing import IO, Any, cast
+
+from ..abc import Process
+from ._eventloop import get_async_backend
+from ._tasks import create_task_group
+
+
+async def run_process(
+    command: str | bytes | Sequence[str | bytes],
+    *,
+    input: bytes | None = None,
+    stdout: int | IO[Any] | None = PIPE,
+    stderr: int | IO[Any] | None = PIPE,
+    check: bool = True,
+    cwd: str | bytes | PathLike[str] | None = None,
+    env: Mapping[str, str] | None = None,
+    start_new_session: bool = False,
+) -> CompletedProcess[bytes]:
+    """
+    Run an external command in a subprocess and wait until it completes.
+
+    .. seealso:: :func:`subprocess.run`
+
+    :param command: either a string to pass to the shell, or an iterable of strings
+        containing the executable name or path and its arguments
+    :param input: bytes passed to the standard input of the subprocess
+    :param stdout: one of :data:`subprocess.PIPE`, :data:`subprocess.DEVNULL`,
+        a file-like object, or `None`
+    :param stderr: one of :data:`subprocess.PIPE`, :data:`subprocess.DEVNULL`,
+        :data:`subprocess.STDOUT`, a file-like object, or `None`
+    :param check: if ``True``, raise :exc:`~subprocess.CalledProcessError` if the
+        process terminates with a return code other than 0
+    :param cwd: If not ``None``, change the working directory to this before running the
+        command
+    :param env: if not ``None``, this mapping replaces the inherited environment
+        variables from the parent process
+    :param start_new_session: if ``true`` the setsid() system call will be made in the
+        child process prior to the execution of the subprocess. (POSIX only)
+    :return: an object representing the completed process
+    :raises ~subprocess.CalledProcessError: if ``check`` is ``True`` and the process
+        exits with a nonzero return code
+
+    """
+
+    async def drain_stream(stream: AsyncIterable[bytes], index: int) -> None:
+        buffer = BytesIO()
+        async for chunk in stream:
+            buffer.write(chunk)
+
+        stream_contents[index] = buffer.getvalue()
+
+    async with await open_process(
+        command,
+        stdin=PIPE if input else DEVNULL,
+        stdout=stdout,
+        stderr=stderr,
+        cwd=cwd,
+        env=env,
+        start_new_session=start_new_session,
+    ) as process:
+        stream_contents: list[bytes | None] = [None, None]
+        async with create_task_group() as tg:
+            if process.stdout:
+                tg.start_soon(drain_stream, process.stdout, 0)
+
+            if process.stderr:
+                tg.start_soon(drain_stream, process.stderr, 1)
+
+            if process.stdin and input:
+                await process.stdin.send(input)
+                await process.stdin.aclose()
+
+            await process.wait()
+
+    output, errors = stream_contents
+    if check and process.returncode != 0:
+        raise CalledProcessError(cast(int, process.returncode), command, output, errors)
+
+    return CompletedProcess(command, cast(int, process.returncode), output, errors)
+
+
+async def open_process(
+    command: str | bytes | Sequence[str | bytes],
+    *,
+    stdin: int | IO[Any] | None = PIPE,
+    stdout: int | IO[Any] | None = PIPE,
+    stderr: int | IO[Any] | None = PIPE,
+    cwd: str | bytes | PathLike[str] | None = None,
+    env: Mapping[str, str] | None = None,
+    start_new_session: bool = False,
+) -> Process:
+    """
+    Start an external command in a subprocess.
+
+    .. seealso:: :class:`subprocess.Popen`
+
+    :param command: either a string to pass to the shell, or an iterable of strings
+        containing the executable name or path and its arguments
+    :param stdin: one of :data:`subprocess.PIPE`, :data:`subprocess.DEVNULL`, a
+        file-like object, or ``None``
+    :param stdout: one of :data:`subprocess.PIPE`, :data:`subprocess.DEVNULL`,
+        a file-like object, or ``None``
+    :param stderr: one of :data:`subprocess.PIPE`, :data:`subprocess.DEVNULL`,
+        :data:`subprocess.STDOUT`, a file-like object, or ``None``
+    :param cwd: If not ``None``, the working directory is changed before executing
+    :param env: If env is not ``None``, it must be a mapping that defines the
+        environment variables for the new process
+    :param start_new_session: if ``true`` the setsid() system call will be made in the
+        child process prior to the execution of the subprocess. (POSIX only)
+    :return: an asynchronous process object
+
+    """
+    if isinstance(command, (str, bytes)):
+        return await get_async_backend().open_process(
+            command,
+            shell=True,
+            stdin=stdin,
+            stdout=stdout,
+            stderr=stderr,
+            cwd=cwd,
+            env=env,
+            start_new_session=start_new_session,
+        )
+    else:
+        return await get_async_backend().open_process(
+            command,
+            shell=False,
+            stdin=stdin,
+            stdout=stdout,
+            stderr=stderr,
+            cwd=cwd,
+            env=env,
+            start_new_session=start_new_session,
+        )
diff --git a/llm/Lib/site-packages/anyio/_core/_synchronization.py b/llm/Lib/site-packages/anyio/_core/_synchronization.py
new file mode 100644
index 0000000000000000000000000000000000000000..b274a31ea2ce2dccb3f4cb09f6d6f4a9cca3814f
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_core/_synchronization.py
@@ -0,0 +1,649 @@
+from __future__ import annotations
+
+import math
+from collections import deque
+from dataclasses import dataclass
+from types import TracebackType
+
+from sniffio import AsyncLibraryNotFoundError
+
+from ..lowlevel import cancel_shielded_checkpoint, checkpoint, checkpoint_if_cancelled
+from ._eventloop import get_async_backend
+from ._exceptions import BusyResourceError, WouldBlock
+from ._tasks import CancelScope
+from ._testing import TaskInfo, get_current_task
+
+
+@dataclass(frozen=True)
+class EventStatistics:
+    """
+    :ivar int tasks_waiting: number of tasks waiting on :meth:`~.Event.wait`
+    """
+
+    tasks_waiting: int
+
+
+@dataclass(frozen=True)
+class CapacityLimiterStatistics:
+    """
+    :ivar int borrowed_tokens: number of tokens currently borrowed by tasks
+    :ivar float total_tokens: total number of available tokens
+    :ivar tuple borrowers: tasks or other objects currently holding tokens borrowed from
+        this limiter
+    :ivar int tasks_waiting: number of tasks waiting on
+        :meth:`~.CapacityLimiter.acquire` or
+        :meth:`~.CapacityLimiter.acquire_on_behalf_of`
+    """
+
+    borrowed_tokens: int
+    total_tokens: float
+    borrowers: tuple[object, ...]
+    tasks_waiting: int
+
+
+@dataclass(frozen=True)
+class LockStatistics:
+    """
+    :ivar bool locked: flag indicating if this lock is locked or not
+    :ivar ~anyio.TaskInfo owner: task currently holding the lock (or ``None`` if the
+        lock is not held by any task)
+    :ivar int tasks_waiting: number of tasks waiting on :meth:`~.Lock.acquire`
+    """
+
+    locked: bool
+    owner: TaskInfo | None
+    tasks_waiting: int
+
+
+@dataclass(frozen=True)
+class ConditionStatistics:
+    """
+    :ivar int tasks_waiting: number of tasks blocked on :meth:`~.Condition.wait`
+    :ivar ~anyio.LockStatistics lock_statistics: statistics of the underlying
+        :class:`~.Lock`
+    """
+
+    tasks_waiting: int
+    lock_statistics: LockStatistics
+
+
+@dataclass(frozen=True)
+class SemaphoreStatistics:
+    """
+    :ivar int tasks_waiting: number of tasks waiting on :meth:`~.Semaphore.acquire`
+
+    """
+
+    tasks_waiting: int
+
+
+class Event:
+    def __new__(cls) -> Event:
+        try:
+            return get_async_backend().create_event()
+        except AsyncLibraryNotFoundError:
+            return EventAdapter()
+
+    def set(self) -> None:
+        """Set the flag, notifying all listeners."""
+        raise NotImplementedError
+
+    def is_set(self) -> bool:
+        """Return ``True`` if the flag is set, ``False`` if not."""
+        raise NotImplementedError
+
+    async def wait(self) -> None:
+        """
+        Wait until the flag has been set.
+
+        If the flag has already been set when this method is called, it returns
+        immediately.
+
+        """
+        raise NotImplementedError
+
+    def statistics(self) -> EventStatistics:
+        """Return statistics about the current state of this event."""
+        raise NotImplementedError
+
+
+class EventAdapter(Event):
+    _internal_event: Event | None = None
+
+    def __new__(cls) -> EventAdapter:
+        return object.__new__(cls)
+
+    @property
+    def _event(self) -> Event:
+        if self._internal_event is None:
+            self._internal_event = get_async_backend().create_event()
+
+        return self._internal_event
+
+    def set(self) -> None:
+        self._event.set()
+
+    def is_set(self) -> bool:
+        return self._internal_event is not None and self._internal_event.is_set()
+
+    async def wait(self) -> None:
+        await self._event.wait()
+
+    def statistics(self) -> EventStatistics:
+        if self._internal_event is None:
+            return EventStatistics(tasks_waiting=0)
+
+        return self._internal_event.statistics()
+
+
+class Lock:
+    _owner_task: TaskInfo | None = None
+
+    def __init__(self) -> None:
+        self._waiters: deque[tuple[TaskInfo, Event]] = deque()
+
+    async def __aenter__(self) -> None:
+        await self.acquire()
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> None:
+        self.release()
+
+    async def acquire(self) -> None:
+        """Acquire the lock."""
+        await checkpoint_if_cancelled()
+        try:
+            self.acquire_nowait()
+        except WouldBlock:
+            task = get_current_task()
+            event = Event()
+            token = task, event
+            self._waiters.append(token)
+            try:
+                await event.wait()
+            except BaseException:
+                if not event.is_set():
+                    self._waiters.remove(token)
+                elif self._owner_task == task:
+                    self.release()
+
+                raise
+
+            assert self._owner_task == task
+        else:
+            try:
+                await cancel_shielded_checkpoint()
+            except BaseException:
+                self.release()
+                raise
+
+    def acquire_nowait(self) -> None:
+        """
+        Acquire the lock, without blocking.
+
+        :raises ~anyio.WouldBlock: if the operation would block
+
+        """
+        task = get_current_task()
+        if self._owner_task == task:
+            raise RuntimeError("Attempted to acquire an already held Lock")
+
+        if self._owner_task is not None:
+            raise WouldBlock
+
+        self._owner_task = task
+
+    def release(self) -> None:
+        """Release the lock."""
+        if self._owner_task != get_current_task():
+            raise RuntimeError("The current task is not holding this lock")
+
+        if self._waiters:
+            self._owner_task, event = self._waiters.popleft()
+            event.set()
+        else:
+            del self._owner_task
+
+    def locked(self) -> bool:
+        """Return True if the lock is currently held."""
+        return self._owner_task is not None
+
+    def statistics(self) -> LockStatistics:
+        """
+        Return statistics about the current state of this lock.
+
+        .. versionadded:: 3.0
+        """
+        return LockStatistics(self.locked(), self._owner_task, len(self._waiters))
+
+
+class Condition:
+    _owner_task: TaskInfo | None = None
+
+    def __init__(self, lock: Lock | None = None):
+        self._lock = lock or Lock()
+        self._waiters: deque[Event] = deque()
+
+    async def __aenter__(self) -> None:
+        await self.acquire()
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> None:
+        self.release()
+
+    def _check_acquired(self) -> None:
+        if self._owner_task != get_current_task():
+            raise RuntimeError("The current task is not holding the underlying lock")
+
+    async def acquire(self) -> None:
+        """Acquire the underlying lock."""
+        await self._lock.acquire()
+        self._owner_task = get_current_task()
+
+    def acquire_nowait(self) -> None:
+        """
+        Acquire the underlying lock, without blocking.
+
+        :raises ~anyio.WouldBlock: if the operation would block
+
+        """
+        self._lock.acquire_nowait()
+        self._owner_task = get_current_task()
+
+    def release(self) -> None:
+        """Release the underlying lock."""
+        self._lock.release()
+
+    def locked(self) -> bool:
+        """Return True if the lock is set."""
+        return self._lock.locked()
+
+    def notify(self, n: int = 1) -> None:
+        """Notify exactly n listeners."""
+        self._check_acquired()
+        for _ in range(n):
+            try:
+                event = self._waiters.popleft()
+            except IndexError:
+                break
+
+            event.set()
+
+    def notify_all(self) -> None:
+        """Notify all the listeners."""
+        self._check_acquired()
+        for event in self._waiters:
+            event.set()
+
+        self._waiters.clear()
+
+    async def wait(self) -> None:
+        """Wait for a notification."""
+        await checkpoint()
+        event = Event()
+        self._waiters.append(event)
+        self.release()
+        try:
+            await event.wait()
+        except BaseException:
+            if not event.is_set():
+                self._waiters.remove(event)
+
+            raise
+        finally:
+            with CancelScope(shield=True):
+                await self.acquire()
+
+    def statistics(self) -> ConditionStatistics:
+        """
+        Return statistics about the current state of this condition.
+
+        .. versionadded:: 3.0
+        """
+        return ConditionStatistics(len(self._waiters), self._lock.statistics())
+
+
+class Semaphore:
+    def __init__(self, initial_value: int, *, max_value: int | None = None):
+        if not isinstance(initial_value, int):
+            raise TypeError("initial_value must be an integer")
+        if initial_value < 0:
+            raise ValueError("initial_value must be >= 0")
+        if max_value is not None:
+            if not isinstance(max_value, int):
+                raise TypeError("max_value must be an integer or None")
+            if max_value < initial_value:
+                raise ValueError(
+                    "max_value must be equal to or higher than initial_value"
+                )
+
+        self._value = initial_value
+        self._max_value = max_value
+        self._waiters: deque[Event] = deque()
+
+    async def __aenter__(self) -> Semaphore:
+        await self.acquire()
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> None:
+        self.release()
+
+    async def acquire(self) -> None:
+        """Decrement the semaphore value, blocking if necessary."""
+        await checkpoint_if_cancelled()
+        try:
+            self.acquire_nowait()
+        except WouldBlock:
+            event = Event()
+            self._waiters.append(event)
+            try:
+                await event.wait()
+            except BaseException:
+                if not event.is_set():
+                    self._waiters.remove(event)
+                else:
+                    self.release()
+
+                raise
+        else:
+            try:
+                await cancel_shielded_checkpoint()
+            except BaseException:
+                self.release()
+                raise
+
+    def acquire_nowait(self) -> None:
+        """
+        Acquire the underlying lock, without blocking.
+
+        :raises ~anyio.WouldBlock: if the operation would block
+
+        """
+        if self._value == 0:
+            raise WouldBlock
+
+        self._value -= 1
+
+    def release(self) -> None:
+        """Increment the semaphore value."""
+        if self._max_value is not None and self._value == self._max_value:
+            raise ValueError("semaphore released too many times")
+
+        if self._waiters:
+            self._waiters.popleft().set()
+        else:
+            self._value += 1
+
+    @property
+    def value(self) -> int:
+        """The current value of the semaphore."""
+        return self._value
+
+    @property
+    def max_value(self) -> int | None:
+        """The maximum value of the semaphore."""
+        return self._max_value
+
+    def statistics(self) -> SemaphoreStatistics:
+        """
+        Return statistics about the current state of this semaphore.
+
+        .. versionadded:: 3.0
+        """
+        return SemaphoreStatistics(len(self._waiters))
+
+
+class CapacityLimiter:
+    def __new__(cls, total_tokens: float) -> CapacityLimiter:
+        try:
+            return get_async_backend().create_capacity_limiter(total_tokens)
+        except AsyncLibraryNotFoundError:
+            return CapacityLimiterAdapter(total_tokens)
+
+    async def __aenter__(self) -> None:
+        raise NotImplementedError
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
+        raise NotImplementedError
+
+    @property
+    def total_tokens(self) -> float:
+        """
+        The total number of tokens available for borrowing.
+
+        This is a read-write property. If the total number of tokens is increased, the
+        proportionate number of tasks waiting on this limiter will be granted their
+        tokens.
+
+        .. versionchanged:: 3.0
+            The property is now writable.
+
+        """
+        raise NotImplementedError
+
+    @total_tokens.setter
+    def total_tokens(self, value: float) -> None:
+        raise NotImplementedError
+
+    @property
+    def borrowed_tokens(self) -> int:
+        """The number of tokens that have currently been borrowed."""
+        raise NotImplementedError
+
+    @property
+    def available_tokens(self) -> float:
+        """The number of tokens currently available to be borrowed"""
+        raise NotImplementedError
+
+    def acquire_nowait(self) -> None:
+        """
+        Acquire a token for the current task without waiting for one to become
+        available.
+
+        :raises ~anyio.WouldBlock: if there are no tokens available for borrowing
+
+        """
+        raise NotImplementedError
+
+    def acquire_on_behalf_of_nowait(self, borrower: object) -> None:
+        """
+        Acquire a token without waiting for one to become available.
+
+        :param borrower: the entity borrowing a token
+        :raises ~anyio.WouldBlock: if there are no tokens available for borrowing
+
+        """
+        raise NotImplementedError
+
+    async def acquire(self) -> None:
+        """
+        Acquire a token for the current task, waiting if necessary for one to become
+        available.
+
+        """
+        raise NotImplementedError
+
+    async def acquire_on_behalf_of(self, borrower: object) -> None:
+        """
+        Acquire a token, waiting if necessary for one to become available.
+
+        :param borrower: the entity borrowing a token
+
+        """
+        raise NotImplementedError
+
+    def release(self) -> None:
+        """
+        Release the token held by the current task.
+
+        :raises RuntimeError: if the current task has not borrowed a token from this
+            limiter.
+
+        """
+        raise NotImplementedError
+
+    def release_on_behalf_of(self, borrower: object) -> None:
+        """
+        Release the token held by the given borrower.
+
+        :raises RuntimeError: if the borrower has not borrowed a token from this
+            limiter.
+
+        """
+        raise NotImplementedError
+
+    def statistics(self) -> CapacityLimiterStatistics:
+        """
+        Return statistics about the current state of this limiter.
+
+        .. versionadded:: 3.0
+
+        """
+        raise NotImplementedError
+
+
+class CapacityLimiterAdapter(CapacityLimiter):
+    _internal_limiter: CapacityLimiter | None = None
+
+    def __new__(cls, total_tokens: float) -> CapacityLimiterAdapter:
+        return object.__new__(cls)
+
+    def __init__(self, total_tokens: float) -> None:
+        self.total_tokens = total_tokens
+
+    @property
+    def _limiter(self) -> CapacityLimiter:
+        if self._internal_limiter is None:
+            self._internal_limiter = get_async_backend().create_capacity_limiter(
+                self._total_tokens
+            )
+
+        return self._internal_limiter
+
+    async def __aenter__(self) -> None:
+        await self._limiter.__aenter__()
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
+        return await self._limiter.__aexit__(exc_type, exc_val, exc_tb)
+
+    @property
+    def total_tokens(self) -> float:
+        if self._internal_limiter is None:
+            return self._total_tokens
+
+        return self._internal_limiter.total_tokens
+
+    @total_tokens.setter
+    def total_tokens(self, value: float) -> None:
+        if not isinstance(value, int) and value is not math.inf:
+            raise TypeError("total_tokens must be an int or math.inf")
+        elif value < 1:
+            raise ValueError("total_tokens must be >= 1")
+
+        if self._internal_limiter is None:
+            self._total_tokens = value
+            return
+
+        self._limiter.total_tokens = value
+
+    @property
+    def borrowed_tokens(self) -> int:
+        if self._internal_limiter is None:
+            return 0
+
+        return self._internal_limiter.borrowed_tokens
+
+    @property
+    def available_tokens(self) -> float:
+        if self._internal_limiter is None:
+            return self._total_tokens
+
+        return self._internal_limiter.available_tokens
+
+    def acquire_nowait(self) -> None:
+        self._limiter.acquire_nowait()
+
+    def acquire_on_behalf_of_nowait(self, borrower: object) -> None:
+        self._limiter.acquire_on_behalf_of_nowait(borrower)
+
+    async def acquire(self) -> None:
+        await self._limiter.acquire()
+
+    async def acquire_on_behalf_of(self, borrower: object) -> None:
+        await self._limiter.acquire_on_behalf_of(borrower)
+
+    def release(self) -> None:
+        self._limiter.release()
+
+    def release_on_behalf_of(self, borrower: object) -> None:
+        self._limiter.release_on_behalf_of(borrower)
+
+    def statistics(self) -> CapacityLimiterStatistics:
+        if self._internal_limiter is None:
+            return CapacityLimiterStatistics(
+                borrowed_tokens=0,
+                total_tokens=self.total_tokens,
+                borrowers=(),
+                tasks_waiting=0,
+            )
+
+        return self._internal_limiter.statistics()
+
+
+class ResourceGuard:
+    """
+    A context manager for ensuring that a resource is only used by a single task at a
+    time.
+
+    Entering this context manager while the previous has not exited it yet will trigger
+    :exc:`BusyResourceError`.
+
+    :param action: the action to guard against (visible in the :exc:`BusyResourceError`
+        when triggered, e.g. "Another task is already {action} this resource")
+
+    .. versionadded:: 4.1
+    """
+
+    __slots__ = "action", "_guarded"
+
+    def __init__(self, action: str = "using"):
+        self.action: str = action
+        self._guarded = False
+
+    def __enter__(self) -> None:
+        if self._guarded:
+            raise BusyResourceError(self.action)
+
+        self._guarded = True
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
+        self._guarded = False
+        return None
diff --git a/llm/Lib/site-packages/anyio/_core/_tasks.py b/llm/Lib/site-packages/anyio/_core/_tasks.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f21ea20b13e0653e288161082e503f81162b507
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_core/_tasks.py
@@ -0,0 +1,158 @@
+from __future__ import annotations
+
+import math
+from collections.abc import Generator
+from contextlib import contextmanager
+from types import TracebackType
+
+from ..abc._tasks import TaskGroup, TaskStatus
+from ._eventloop import get_async_backend
+
+
+class _IgnoredTaskStatus(TaskStatus[object]):
+    def started(self, value: object = None) -> None:
+        pass
+
+
+TASK_STATUS_IGNORED = _IgnoredTaskStatus()
+
+
+class CancelScope:
+    """
+    Wraps a unit of work that can be made separately cancellable.
+
+    :param deadline: The time (clock value) when this scope is cancelled automatically
+    :param shield: ``True`` to shield the cancel scope from external cancellation
+    """
+
+    def __new__(
+        cls, *, deadline: float = math.inf, shield: bool = False
+    ) -> CancelScope:
+        return get_async_backend().create_cancel_scope(shield=shield, deadline=deadline)
+
+    def cancel(self) -> None:
+        """Cancel this scope immediately."""
+        raise NotImplementedError
+
+    @property
+    def deadline(self) -> float:
+        """
+        The time (clock value) when this scope is cancelled automatically.
+
+        Will be ``float('inf')`` if no timeout has been set.
+
+        """
+        raise NotImplementedError
+
+    @deadline.setter
+    def deadline(self, value: float) -> None:
+        raise NotImplementedError
+
+    @property
+    def cancel_called(self) -> bool:
+        """``True`` if :meth:`cancel` has been called."""
+        raise NotImplementedError
+
+    @property
+    def cancelled_caught(self) -> bool:
+        """
+        ``True`` if this scope suppressed a cancellation exception it itself raised.
+
+        This is typically used to check if any work was interrupted, or to see if the
+        scope was cancelled due to its deadline being reached. The value will, however,
+        only be ``True`` if the cancellation was triggered by the scope itself (and not
+        an outer scope).
+
+        """
+        raise NotImplementedError
+
+    @property
+    def shield(self) -> bool:
+        """
+        ``True`` if this scope is shielded from external cancellation.
+
+        While a scope is shielded, it will not receive cancellations from outside.
+
+        """
+        raise NotImplementedError
+
+    @shield.setter
+    def shield(self, value: bool) -> None:
+        raise NotImplementedError
+
+    def __enter__(self) -> CancelScope:
+        raise NotImplementedError
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
+        raise NotImplementedError
+
+
+@contextmanager
+def fail_after(
+    delay: float | None, shield: bool = False
+) -> Generator[CancelScope, None, None]:
+    """
+    Create a context manager which raises a :class:`TimeoutError` if does not finish in
+    time.
+
+    :param delay: maximum allowed time (in seconds) before raising the exception, or
+        ``None`` to disable the timeout
+    :param shield: ``True`` to shield the cancel scope from external cancellation
+    :return: a context manager that yields a cancel scope
+    :rtype: :class:`~typing.ContextManager`\\[:class:`~anyio.CancelScope`\\]
+
+    """
+    current_time = get_async_backend().current_time
+    deadline = (current_time() + delay) if delay is not None else math.inf
+    with get_async_backend().create_cancel_scope(
+        deadline=deadline, shield=shield
+    ) as cancel_scope:
+        yield cancel_scope
+
+    if cancel_scope.cancelled_caught and current_time() >= cancel_scope.deadline:
+        raise TimeoutError
+
+
+def move_on_after(delay: float | None, shield: bool = False) -> CancelScope:
+    """
+    Create a cancel scope with a deadline that expires after the given delay.
+
+    :param delay: maximum allowed time (in seconds) before exiting the context block, or
+        ``None`` to disable the timeout
+    :param shield: ``True`` to shield the cancel scope from external cancellation
+    :return: a cancel scope
+
+    """
+    deadline = (
+        (get_async_backend().current_time() + delay) if delay is not None else math.inf
+    )
+    return get_async_backend().create_cancel_scope(deadline=deadline, shield=shield)
+
+
+def current_effective_deadline() -> float:
+    """
+    Return the nearest deadline among all the cancel scopes effective for the current
+    task.
+
+    :return: a clock value from the event loop's internal clock (or ``float('inf')`` if
+        there is no deadline in effect, or ``float('-inf')`` if the current scope has
+        been cancelled)
+    :rtype: float
+
+    """
+    return get_async_backend().current_effective_deadline()
+
+
+def create_task_group() -> TaskGroup:
+    """
+    Create a task group.
+
+    :return: a task group
+
+    """
+    return get_async_backend().create_task_group()
diff --git a/llm/Lib/site-packages/anyio/_core/_testing.py b/llm/Lib/site-packages/anyio/_core/_testing.py
new file mode 100644
index 0000000000000000000000000000000000000000..1dae3b193a9a4674e10d64ab5688a86d026e7ef7
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_core/_testing.py
@@ -0,0 +1,74 @@
+from __future__ import annotations
+
+from collections.abc import Awaitable, Generator
+from typing import Any
+
+from ._eventloop import get_async_backend
+
+
+class TaskInfo:
+    """
+    Represents an asynchronous task.
+
+    :ivar int id: the unique identifier of the task
+    :ivar parent_id: the identifier of the parent task, if any
+    :vartype parent_id: Optional[int]
+    :ivar str name: the description of the task (if any)
+    :ivar ~collections.abc.Coroutine coro: the coroutine object of the task
+    """
+
+    __slots__ = "_name", "id", "parent_id", "name", "coro"
+
+    def __init__(
+        self,
+        id: int,
+        parent_id: int | None,
+        name: str | None,
+        coro: Generator[Any, Any, Any] | Awaitable[Any],
+    ):
+        func = get_current_task
+        self._name = f"{func.__module__}.{func.__qualname__}"
+        self.id: int = id
+        self.parent_id: int | None = parent_id
+        self.name: str | None = name
+        self.coro: Generator[Any, Any, Any] | Awaitable[Any] = coro
+
+    def __eq__(self, other: object) -> bool:
+        if isinstance(other, TaskInfo):
+            return self.id == other.id
+
+        return NotImplemented
+
+    def __hash__(self) -> int:
+        return hash(self.id)
+
+    def __repr__(self) -> str:
+        return f"{self.__class__.__name__}(id={self.id!r}, name={self.name!r})"
+
+    def _unwrap(self) -> TaskInfo:
+        return self
+
+
+def get_current_task() -> TaskInfo:
+    """
+    Return the current task.
+
+    :return: a representation of the current task
+
+    """
+    return get_async_backend().get_current_task()
+
+
+def get_running_tasks() -> list[TaskInfo]:
+    """
+    Return a list of running tasks in the current event loop.
+
+    :return: a list of task info objects
+
+    """
+    return get_async_backend().get_running_tasks()
+
+
+async def wait_all_tasks_blocked() -> None:
+    """Wait until all other tasks are waiting for something."""
+    await get_async_backend().wait_all_tasks_blocked()
diff --git a/llm/Lib/site-packages/anyio/_core/_typedattr.py b/llm/Lib/site-packages/anyio/_core/_typedattr.py
new file mode 100644
index 0000000000000000000000000000000000000000..74c6b8fdcb89f3c67bfa5034339e3f6768190860
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/_core/_typedattr.py
@@ -0,0 +1,81 @@
+from __future__ import annotations
+
+from collections.abc import Callable, Mapping
+from typing import Any, TypeVar, final, overload
+
+from ._exceptions import TypedAttributeLookupError
+
+T_Attr = TypeVar("T_Attr")
+T_Default = TypeVar("T_Default")
+undefined = object()
+
+
+def typed_attribute() -> Any:
+    """Return a unique object, used to mark typed attributes."""
+    return object()
+
+
+class TypedAttributeSet:
+    """
+    Superclass for typed attribute collections.
+
+    Checks that every public attribute of every subclass has a type annotation.
+    """
+
+    def __init_subclass__(cls) -> None:
+        annotations: dict[str, Any] = getattr(cls, "__annotations__", {})
+        for attrname in dir(cls):
+            if not attrname.startswith("_") and attrname not in annotations:
+                raise TypeError(
+                    f"Attribute {attrname!r} is missing its type annotation"
+                )
+
+        super().__init_subclass__()
+
+
+class TypedAttributeProvider:
+    """Base class for classes that wish to provide typed extra attributes."""
+
+    @property
+    def extra_attributes(self) -> Mapping[T_Attr, Callable[[], T_Attr]]:
+        """
+        A mapping of the extra attributes to callables that return the corresponding
+        values.
+
+        If the provider wraps another provider, the attributes from that wrapper should
+        also be included in the returned mapping (but the wrapper may override the
+        callables from the wrapped instance).
+
+        """
+        return {}
+
+    @overload
+    def extra(self, attribute: T_Attr) -> T_Attr:
+        ...
+
+    @overload
+    def extra(self, attribute: T_Attr, default: T_Default) -> T_Attr | T_Default:
+        ...
+
+    @final
+    def extra(self, attribute: Any, default: object = undefined) -> object:
+        """
+        extra(attribute, default=undefined)
+
+        Return the value of the given typed extra attribute.
+
+        :param attribute: the attribute (member of a :class:`~TypedAttributeSet`) to
+            look for
+        :param default: the value that should be returned if no value is found for the
+            attribute
+        :raises ~anyio.TypedAttributeLookupError: if the search failed and no default
+            value was given
+
+        """
+        try:
+            return self.extra_attributes[attribute]()
+        except KeyError:
+            if default is undefined:
+                raise TypedAttributeLookupError("Attribute not found") from None
+            else:
+                return default
diff --git a/llm/Lib/site-packages/anyio/abc/__init__.py b/llm/Lib/site-packages/anyio/abc/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1ca0fcf746e7e1f9e7be8124c3eb55712a253cc2
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/abc/__init__.py
@@ -0,0 +1,57 @@
+from __future__ import annotations
+
+from typing import Any
+
+from ._eventloop import AsyncBackend as AsyncBackend
+from ._resources import AsyncResource as AsyncResource
+from ._sockets import ConnectedUDPSocket as ConnectedUDPSocket
+from ._sockets import ConnectedUNIXDatagramSocket as ConnectedUNIXDatagramSocket
+from ._sockets import IPAddressType as IPAddressType
+from ._sockets import IPSockAddrType as IPSockAddrType
+from ._sockets import SocketAttribute as SocketAttribute
+from ._sockets import SocketListener as SocketListener
+from ._sockets import SocketStream as SocketStream
+from ._sockets import UDPPacketType as UDPPacketType
+from ._sockets import UDPSocket as UDPSocket
+from ._sockets import UNIXDatagramPacketType as UNIXDatagramPacketType
+from ._sockets import UNIXDatagramSocket as UNIXDatagramSocket
+from ._sockets import UNIXSocketStream as UNIXSocketStream
+from ._streams import AnyByteReceiveStream as AnyByteReceiveStream
+from ._streams import AnyByteSendStream as AnyByteSendStream
+from ._streams import AnyByteStream as AnyByteStream
+from ._streams import AnyUnreliableByteReceiveStream as AnyUnreliableByteReceiveStream
+from ._streams import AnyUnreliableByteSendStream as AnyUnreliableByteSendStream
+from ._streams import AnyUnreliableByteStream as AnyUnreliableByteStream
+from ._streams import ByteReceiveStream as ByteReceiveStream
+from ._streams import ByteSendStream as ByteSendStream
+from ._streams import ByteStream as ByteStream
+from ._streams import Listener as Listener
+from ._streams import ObjectReceiveStream as ObjectReceiveStream
+from ._streams import ObjectSendStream as ObjectSendStream
+from ._streams import ObjectStream as ObjectStream
+from ._streams import UnreliableObjectReceiveStream as UnreliableObjectReceiveStream
+from ._streams import UnreliableObjectSendStream as UnreliableObjectSendStream
+from ._streams import UnreliableObjectStream as UnreliableObjectStream
+from ._subprocesses import Process as Process
+from ._tasks import TaskGroup as TaskGroup
+from ._tasks import TaskStatus as TaskStatus
+from ._testing import TestRunner as TestRunner
+
+# Re-exported here, for backwards compatibility
+# isort: off
+from .._core._synchronization import (
+    CapacityLimiter as CapacityLimiter,
+    Condition as Condition,
+    Event as Event,
+    Lock as Lock,
+    Semaphore as Semaphore,
+)
+from .._core._tasks import CancelScope as CancelScope
+from ..from_thread import BlockingPortal as BlockingPortal
+
+# Re-export imports so they look like they live directly in this package
+key: str
+value: Any
+for key, value in list(locals().items()):
+    if getattr(value, "__module__", "").startswith("anyio.abc."):
+        value.__module__ = __name__
diff --git a/llm/Lib/site-packages/anyio/abc/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/anyio/abc/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c508b69217da6ca5702e2079dbca21fba0a78069
Binary files /dev/null and b/llm/Lib/site-packages/anyio/abc/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/abc/__pycache__/_eventloop.cpython-311.pyc b/llm/Lib/site-packages/anyio/abc/__pycache__/_eventloop.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e7c8d1f6b0c36f9f6ddecb3d3013d1c23a8b4ec
Binary files /dev/null and b/llm/Lib/site-packages/anyio/abc/__pycache__/_eventloop.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/abc/__pycache__/_resources.cpython-311.pyc b/llm/Lib/site-packages/anyio/abc/__pycache__/_resources.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f51c4f1fca2e6315fe8c6ae27fffeda10bbe39f4
Binary files /dev/null and b/llm/Lib/site-packages/anyio/abc/__pycache__/_resources.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/abc/__pycache__/_sockets.cpython-311.pyc b/llm/Lib/site-packages/anyio/abc/__pycache__/_sockets.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..db9c0306c0054cce47f81b14fef0794328ce1655
Binary files /dev/null and b/llm/Lib/site-packages/anyio/abc/__pycache__/_sockets.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/abc/__pycache__/_streams.cpython-311.pyc b/llm/Lib/site-packages/anyio/abc/__pycache__/_streams.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..719d2906bc5c68e613990fe5b40e0757323090fb
Binary files /dev/null and b/llm/Lib/site-packages/anyio/abc/__pycache__/_streams.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/abc/__pycache__/_subprocesses.cpython-311.pyc b/llm/Lib/site-packages/anyio/abc/__pycache__/_subprocesses.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b6e97f207050045333d4275600d337d0dd5b9aa9
Binary files /dev/null and b/llm/Lib/site-packages/anyio/abc/__pycache__/_subprocesses.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/abc/__pycache__/_tasks.cpython-311.pyc b/llm/Lib/site-packages/anyio/abc/__pycache__/_tasks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2698133e04aecbb00dcd2ef5f03c0dbc189c850f
Binary files /dev/null and b/llm/Lib/site-packages/anyio/abc/__pycache__/_tasks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/abc/__pycache__/_testing.cpython-311.pyc b/llm/Lib/site-packages/anyio/abc/__pycache__/_testing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4f384dd0e345350ad3494b836bab3d5141b53715
Binary files /dev/null and b/llm/Lib/site-packages/anyio/abc/__pycache__/_testing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/abc/_eventloop.py b/llm/Lib/site-packages/anyio/abc/_eventloop.py
new file mode 100644
index 0000000000000000000000000000000000000000..4470d83d249d13fe0002b84ffdd0ba4efc843a61
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/abc/_eventloop.py
@@ -0,0 +1,392 @@
+from __future__ import annotations
+
+import math
+import sys
+from abc import ABCMeta, abstractmethod
+from collections.abc import AsyncIterator, Awaitable, Mapping
+from os import PathLike
+from signal import Signals
+from socket import AddressFamily, SocketKind, socket
+from typing import (
+    IO,
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    ContextManager,
+    Sequence,
+    TypeVar,
+    overload,
+)
+
+if sys.version_info >= (3, 11):
+    from typing import TypeVarTuple, Unpack
+else:
+    from typing_extensions import TypeVarTuple, Unpack
+
+if TYPE_CHECKING:
+    from typing import Literal
+
+    from .._core._synchronization import CapacityLimiter, Event
+    from .._core._tasks import CancelScope
+    from .._core._testing import TaskInfo
+    from ..from_thread import BlockingPortal
+    from ._sockets import (
+        ConnectedUDPSocket,
+        ConnectedUNIXDatagramSocket,
+        IPSockAddrType,
+        SocketListener,
+        SocketStream,
+        UDPSocket,
+        UNIXDatagramSocket,
+        UNIXSocketStream,
+    )
+    from ._subprocesses import Process
+    from ._tasks import TaskGroup
+    from ._testing import TestRunner
+
+T_Retval = TypeVar("T_Retval")
+PosArgsT = TypeVarTuple("PosArgsT")
+
+
+class AsyncBackend(metaclass=ABCMeta):
+    @classmethod
+    @abstractmethod
+    def run(
+        cls,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]],
+        args: tuple[Unpack[PosArgsT]],
+        kwargs: dict[str, Any],
+        options: dict[str, Any],
+    ) -> T_Retval:
+        """
+        Run the given coroutine function in an asynchronous event loop.
+
+        The current thread must not be already running an event loop.
+
+        :param func: a coroutine function
+        :param args: positional arguments to ``func``
+        :param kwargs: positional arguments to ``func``
+        :param options: keyword arguments to call the backend ``run()`` implementation
+            with
+        :return: the return value of the coroutine function
+        """
+
+    @classmethod
+    @abstractmethod
+    def current_token(cls) -> object:
+        """
+
+        :return:
+        """
+
+    @classmethod
+    @abstractmethod
+    def current_time(cls) -> float:
+        """
+        Return the current value of the event loop's internal clock.
+
+        :return: the clock value (seconds)
+        """
+
+    @classmethod
+    @abstractmethod
+    def cancelled_exception_class(cls) -> type[BaseException]:
+        """Return the exception class that is raised in a task if it's cancelled."""
+
+    @classmethod
+    @abstractmethod
+    async def checkpoint(cls) -> None:
+        """
+        Check if the task has been cancelled, and allow rescheduling of other tasks.
+
+        This is effectively the same as running :meth:`checkpoint_if_cancelled` and then
+        :meth:`cancel_shielded_checkpoint`.
+        """
+
+    @classmethod
+    async def checkpoint_if_cancelled(cls) -> None:
+        """
+        Check if the current task group has been cancelled.
+
+        This will check if the task has been cancelled, but will not allow other tasks
+        to be scheduled if not.
+
+        """
+        if cls.current_effective_deadline() == -math.inf:
+            await cls.checkpoint()
+
+    @classmethod
+    async def cancel_shielded_checkpoint(cls) -> None:
+        """
+        Allow the rescheduling of other tasks.
+
+        This will give other tasks the opportunity to run, but without checking if the
+        current task group has been cancelled, unlike with :meth:`checkpoint`.
+
+        """
+        with cls.create_cancel_scope(shield=True):
+            await cls.sleep(0)
+
+    @classmethod
+    @abstractmethod
+    async def sleep(cls, delay: float) -> None:
+        """
+        Pause the current task for the specified duration.
+
+        :param delay: the duration, in seconds
+        """
+
+    @classmethod
+    @abstractmethod
+    def create_cancel_scope(
+        cls, *, deadline: float = math.inf, shield: bool = False
+    ) -> CancelScope:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def current_effective_deadline(cls) -> float:
+        """
+        Return the nearest deadline among all the cancel scopes effective for the
+        current task.
+
+        :return:
+            - a clock value from the event loop's internal clock
+            - ``inf`` if there is no deadline in effect
+            - ``-inf`` if the current scope has been cancelled
+        :rtype: float
+        """
+
+    @classmethod
+    @abstractmethod
+    def create_task_group(cls) -> TaskGroup:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def create_event(cls) -> Event:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def create_capacity_limiter(cls, total_tokens: float) -> CapacityLimiter:
+        pass
+
+    @classmethod
+    @abstractmethod
+    async def run_sync_in_worker_thread(
+        cls,
+        func: Callable[[Unpack[PosArgsT]], T_Retval],
+        args: tuple[Unpack[PosArgsT]],
+        abandon_on_cancel: bool = False,
+        limiter: CapacityLimiter | None = None,
+    ) -> T_Retval:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def check_cancelled(cls) -> None:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def run_async_from_thread(
+        cls,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]],
+        args: tuple[Unpack[PosArgsT]],
+        token: object,
+    ) -> T_Retval:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def run_sync_from_thread(
+        cls,
+        func: Callable[[Unpack[PosArgsT]], T_Retval],
+        args: tuple[Unpack[PosArgsT]],
+        token: object,
+    ) -> T_Retval:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def create_blocking_portal(cls) -> BlockingPortal:
+        pass
+
+    @classmethod
+    @overload
+    async def open_process(
+        cls,
+        command: str | bytes,
+        *,
+        shell: Literal[True],
+        stdin: int | IO[Any] | None,
+        stdout: int | IO[Any] | None,
+        stderr: int | IO[Any] | None,
+        cwd: str | bytes | PathLike[str] | None = None,
+        env: Mapping[str, str] | None = None,
+        start_new_session: bool = False,
+    ) -> Process:
+        pass
+
+    @classmethod
+    @overload
+    async def open_process(
+        cls,
+        command: Sequence[str | bytes],
+        *,
+        shell: Literal[False],
+        stdin: int | IO[Any] | None,
+        stdout: int | IO[Any] | None,
+        stderr: int | IO[Any] | None,
+        cwd: str | bytes | PathLike[str] | None = None,
+        env: Mapping[str, str] | None = None,
+        start_new_session: bool = False,
+    ) -> Process:
+        pass
+
+    @classmethod
+    @abstractmethod
+    async def open_process(
+        cls,
+        command: str | bytes | Sequence[str | bytes],
+        *,
+        shell: bool,
+        stdin: int | IO[Any] | None,
+        stdout: int | IO[Any] | None,
+        stderr: int | IO[Any] | None,
+        cwd: str | bytes | PathLike[str] | None = None,
+        env: Mapping[str, str] | None = None,
+        start_new_session: bool = False,
+    ) -> Process:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def setup_process_pool_exit_at_shutdown(cls, workers: set[Process]) -> None:
+        pass
+
+    @classmethod
+    @abstractmethod
+    async def connect_tcp(
+        cls, host: str, port: int, local_address: IPSockAddrType | None = None
+    ) -> SocketStream:
+        pass
+
+    @classmethod
+    @abstractmethod
+    async def connect_unix(cls, path: str | bytes) -> UNIXSocketStream:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def create_tcp_listener(cls, sock: socket) -> SocketListener:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def create_unix_listener(cls, sock: socket) -> SocketListener:
+        pass
+
+    @classmethod
+    @abstractmethod
+    async def create_udp_socket(
+        cls,
+        family: AddressFamily,
+        local_address: IPSockAddrType | None,
+        remote_address: IPSockAddrType | None,
+        reuse_port: bool,
+    ) -> UDPSocket | ConnectedUDPSocket:
+        pass
+
+    @classmethod
+    @overload
+    async def create_unix_datagram_socket(
+        cls, raw_socket: socket, remote_path: None
+    ) -> UNIXDatagramSocket:
+        ...
+
+    @classmethod
+    @overload
+    async def create_unix_datagram_socket(
+        cls, raw_socket: socket, remote_path: str | bytes
+    ) -> ConnectedUNIXDatagramSocket:
+        ...
+
+    @classmethod
+    @abstractmethod
+    async def create_unix_datagram_socket(
+        cls, raw_socket: socket, remote_path: str | bytes | None
+    ) -> UNIXDatagramSocket | ConnectedUNIXDatagramSocket:
+        pass
+
+    @classmethod
+    @abstractmethod
+    async def getaddrinfo(
+        cls,
+        host: bytes | str | None,
+        port: str | int | None,
+        *,
+        family: int | AddressFamily = 0,
+        type: int | SocketKind = 0,
+        proto: int = 0,
+        flags: int = 0,
+    ) -> list[
+        tuple[
+            AddressFamily,
+            SocketKind,
+            int,
+            str,
+            tuple[str, int] | tuple[str, int, int, int],
+        ]
+    ]:
+        pass
+
+    @classmethod
+    @abstractmethod
+    async def getnameinfo(
+        cls, sockaddr: IPSockAddrType, flags: int = 0
+    ) -> tuple[str, str]:
+        pass
+
+    @classmethod
+    @abstractmethod
+    async def wait_socket_readable(cls, sock: socket) -> None:
+        pass
+
+    @classmethod
+    @abstractmethod
+    async def wait_socket_writable(cls, sock: socket) -> None:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def current_default_thread_limiter(cls) -> CapacityLimiter:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def open_signal_receiver(
+        cls, *signals: Signals
+    ) -> ContextManager[AsyncIterator[Signals]]:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def get_current_task(cls) -> TaskInfo:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def get_running_tasks(cls) -> list[TaskInfo]:
+        pass
+
+    @classmethod
+    @abstractmethod
+    async def wait_all_tasks_blocked(cls) -> None:
+        pass
+
+    @classmethod
+    @abstractmethod
+    def create_test_runner(cls, options: dict[str, Any]) -> TestRunner:
+        pass
diff --git a/llm/Lib/site-packages/anyio/abc/_resources.py b/llm/Lib/site-packages/anyio/abc/_resources.py
new file mode 100644
index 0000000000000000000000000000000000000000..9693835baec1a29ede4774676359388e3b290d24
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/abc/_resources.py
@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from abc import ABCMeta, abstractmethod
+from types import TracebackType
+from typing import TypeVar
+
+T = TypeVar("T")
+
+
+class AsyncResource(metaclass=ABCMeta):
+    """
+    Abstract base class for all closeable asynchronous resources.
+
+    Works as an asynchronous context manager which returns the instance itself on enter,
+    and calls :meth:`aclose` on exit.
+    """
+
+    async def __aenter__(self: T) -> T:
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> None:
+        await self.aclose()
+
+    @abstractmethod
+    async def aclose(self) -> None:
+        """Close the resource."""
diff --git a/llm/Lib/site-packages/anyio/abc/_sockets.py b/llm/Lib/site-packages/anyio/abc/_sockets.py
new file mode 100644
index 0000000000000000000000000000000000000000..b321225a7b8811ca195179e85559522be50d0f1e
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/abc/_sockets.py
@@ -0,0 +1,194 @@
+from __future__ import annotations
+
+import socket
+from abc import abstractmethod
+from collections.abc import Callable, Collection, Mapping
+from contextlib import AsyncExitStack
+from io import IOBase
+from ipaddress import IPv4Address, IPv6Address
+from socket import AddressFamily
+from types import TracebackType
+from typing import Any, Tuple, TypeVar, Union
+
+from .._core._typedattr import (
+    TypedAttributeProvider,
+    TypedAttributeSet,
+    typed_attribute,
+)
+from ._streams import ByteStream, Listener, UnreliableObjectStream
+from ._tasks import TaskGroup
+
+IPAddressType = Union[str, IPv4Address, IPv6Address]
+IPSockAddrType = Tuple[str, int]
+SockAddrType = Union[IPSockAddrType, str]
+UDPPacketType = Tuple[bytes, IPSockAddrType]
+UNIXDatagramPacketType = Tuple[bytes, str]
+T_Retval = TypeVar("T_Retval")
+
+
+class _NullAsyncContextManager:
+    async def __aenter__(self) -> None:
+        pass
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
+        return None
+
+
+class SocketAttribute(TypedAttributeSet):
+    #: the address family of the underlying socket
+    family: AddressFamily = typed_attribute()
+    #: the local socket address of the underlying socket
+    local_address: SockAddrType = typed_attribute()
+    #: for IP addresses, the local port the underlying socket is bound to
+    local_port: int = typed_attribute()
+    #: the underlying stdlib socket object
+    raw_socket: socket.socket = typed_attribute()
+    #: the remote address the underlying socket is connected to
+    remote_address: SockAddrType = typed_attribute()
+    #: for IP addresses, the remote port the underlying socket is connected to
+    remote_port: int = typed_attribute()
+
+
+class _SocketProvider(TypedAttributeProvider):
+    @property
+    def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]:
+        from .._core._sockets import convert_ipv6_sockaddr as convert
+
+        attributes: dict[Any, Callable[[], Any]] = {
+            SocketAttribute.family: lambda: self._raw_socket.family,
+            SocketAttribute.local_address: lambda: convert(
+                self._raw_socket.getsockname()
+            ),
+            SocketAttribute.raw_socket: lambda: self._raw_socket,
+        }
+        try:
+            peername: tuple[str, int] | None = convert(self._raw_socket.getpeername())
+        except OSError:
+            peername = None
+
+        # Provide the remote address for connected sockets
+        if peername is not None:
+            attributes[SocketAttribute.remote_address] = lambda: peername
+
+        # Provide local and remote ports for IP based sockets
+        if self._raw_socket.family in (AddressFamily.AF_INET, AddressFamily.AF_INET6):
+            attributes[SocketAttribute.local_port] = (
+                lambda: self._raw_socket.getsockname()[1]
+            )
+            if peername is not None:
+                remote_port = peername[1]
+                attributes[SocketAttribute.remote_port] = lambda: remote_port
+
+        return attributes
+
+    @property
+    @abstractmethod
+    def _raw_socket(self) -> socket.socket:
+        pass
+
+
+class SocketStream(ByteStream, _SocketProvider):
+    """
+    Transports bytes over a socket.
+
+    Supports all relevant extra attributes from :class:`~SocketAttribute`.
+    """
+
+
+class UNIXSocketStream(SocketStream):
+    @abstractmethod
+    async def send_fds(self, message: bytes, fds: Collection[int | IOBase]) -> None:
+        """
+        Send file descriptors along with a message to the peer.
+
+        :param message: a non-empty bytestring
+        :param fds: a collection of files (either numeric file descriptors or open file
+            or socket objects)
+        """
+
+    @abstractmethod
+    async def receive_fds(self, msglen: int, maxfds: int) -> tuple[bytes, list[int]]:
+        """
+        Receive file descriptors along with a message from the peer.
+
+        :param msglen: length of the message to expect from the peer
+        :param maxfds: maximum number of file descriptors to expect from the peer
+        :return: a tuple of (message, file descriptors)
+        """
+
+
+class SocketListener(Listener[SocketStream], _SocketProvider):
+    """
+    Listens to incoming socket connections.
+
+    Supports all relevant extra attributes from :class:`~SocketAttribute`.
+    """
+
+    @abstractmethod
+    async def accept(self) -> SocketStream:
+        """Accept an incoming connection."""
+
+    async def serve(
+        self,
+        handler: Callable[[SocketStream], Any],
+        task_group: TaskGroup | None = None,
+    ) -> None:
+        from .. import create_task_group
+
+        async with AsyncExitStack() as stack:
+            if task_group is None:
+                task_group = await stack.enter_async_context(create_task_group())
+
+            while True:
+                stream = await self.accept()
+                task_group.start_soon(handler, stream)
+
+
+class UDPSocket(UnreliableObjectStream[UDPPacketType], _SocketProvider):
+    """
+    Represents an unconnected UDP socket.
+
+    Supports all relevant extra attributes from :class:`~SocketAttribute`.
+    """
+
+    async def sendto(self, data: bytes, host: str, port: int) -> None:
+        """
+        Alias for :meth:`~.UnreliableObjectSendStream.send` ((data, (host, port))).
+
+        """
+        return await self.send((data, (host, port)))
+
+
+class ConnectedUDPSocket(UnreliableObjectStream[bytes], _SocketProvider):
+    """
+    Represents an connected UDP socket.
+
+    Supports all relevant extra attributes from :class:`~SocketAttribute`.
+    """
+
+
+class UNIXDatagramSocket(
+    UnreliableObjectStream[UNIXDatagramPacketType], _SocketProvider
+):
+    """
+    Represents an unconnected Unix datagram socket.
+
+    Supports all relevant extra attributes from :class:`~SocketAttribute`.
+    """
+
+    async def sendto(self, data: bytes, path: str) -> None:
+        """Alias for :meth:`~.UnreliableObjectSendStream.send` ((data, path))."""
+        return await self.send((data, path))
+
+
+class ConnectedUNIXDatagramSocket(UnreliableObjectStream[bytes], _SocketProvider):
+    """
+    Represents a connected Unix datagram socket.
+
+    Supports all relevant extra attributes from :class:`~SocketAttribute`.
+    """
diff --git a/llm/Lib/site-packages/anyio/abc/_streams.py b/llm/Lib/site-packages/anyio/abc/_streams.py
new file mode 100644
index 0000000000000000000000000000000000000000..8c638683a49245b377ed1917e0385284be5a46dd
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/abc/_streams.py
@@ -0,0 +1,203 @@
+from __future__ import annotations
+
+from abc import abstractmethod
+from collections.abc import Callable
+from typing import Any, Generic, TypeVar, Union
+
+from .._core._exceptions import EndOfStream
+from .._core._typedattr import TypedAttributeProvider
+from ._resources import AsyncResource
+from ._tasks import TaskGroup
+
+T_Item = TypeVar("T_Item")
+T_co = TypeVar("T_co", covariant=True)
+T_contra = TypeVar("T_contra", contravariant=True)
+
+
+class UnreliableObjectReceiveStream(
+    Generic[T_co], AsyncResource, TypedAttributeProvider
+):
+    """
+    An interface for receiving objects.
+
+    This interface makes no guarantees that the received messages arrive in the order in
+    which they were sent, or that no messages are missed.
+
+    Asynchronously iterating over objects of this type will yield objects matching the
+    given type parameter.
+    """
+
+    def __aiter__(self) -> UnreliableObjectReceiveStream[T_co]:
+        return self
+
+    async def __anext__(self) -> T_co:
+        try:
+            return await self.receive()
+        except EndOfStream:
+            raise StopAsyncIteration
+
+    @abstractmethod
+    async def receive(self) -> T_co:
+        """
+        Receive the next item.
+
+        :raises ~anyio.ClosedResourceError: if the receive stream has been explicitly
+            closed
+        :raises ~anyio.EndOfStream: if this stream has been closed from the other end
+        :raises ~anyio.BrokenResourceError: if this stream has been rendered unusable
+            due to external causes
+        """
+
+
+class UnreliableObjectSendStream(
+    Generic[T_contra], AsyncResource, TypedAttributeProvider
+):
+    """
+    An interface for sending objects.
+
+    This interface makes no guarantees that the messages sent will reach the
+    recipient(s) in the same order in which they were sent, or at all.
+    """
+
+    @abstractmethod
+    async def send(self, item: T_contra) -> None:
+        """
+        Send an item to the peer(s).
+
+        :param item: the item to send
+        :raises ~anyio.ClosedResourceError: if the send stream has been explicitly
+            closed
+        :raises ~anyio.BrokenResourceError: if this stream has been rendered unusable
+            due to external causes
+        """
+
+
+class UnreliableObjectStream(
+    UnreliableObjectReceiveStream[T_Item], UnreliableObjectSendStream[T_Item]
+):
+    """
+    A bidirectional message stream which does not guarantee the order or reliability of
+    message delivery.
+    """
+
+
+class ObjectReceiveStream(UnreliableObjectReceiveStream[T_co]):
+    """
+    A receive message stream which guarantees that messages are received in the same
+    order in which they were sent, and that no messages are missed.
+    """
+
+
+class ObjectSendStream(UnreliableObjectSendStream[T_contra]):
+    """
+    A send message stream which guarantees that messages are delivered in the same order
+    in which they were sent, without missing any messages in the middle.
+    """
+
+
+class ObjectStream(
+    ObjectReceiveStream[T_Item],
+    ObjectSendStream[T_Item],
+    UnreliableObjectStream[T_Item],
+):
+    """
+    A bidirectional message stream which guarantees the order and reliability of message
+    delivery.
+    """
+
+    @abstractmethod
+    async def send_eof(self) -> None:
+        """
+        Send an end-of-file indication to the peer.
+
+        You should not try to send any further data to this stream after calling this
+        method. This method is idempotent (does nothing on successive calls).
+        """
+
+
+class ByteReceiveStream(AsyncResource, TypedAttributeProvider):
+    """
+    An interface for receiving bytes from a single peer.
+
+    Iterating this byte stream will yield a byte string of arbitrary length, but no more
+    than 65536 bytes.
+    """
+
+    def __aiter__(self) -> ByteReceiveStream:
+        return self
+
+    async def __anext__(self) -> bytes:
+        try:
+            return await self.receive()
+        except EndOfStream:
+            raise StopAsyncIteration
+
+    @abstractmethod
+    async def receive(self, max_bytes: int = 65536) -> bytes:
+        """
+        Receive at most ``max_bytes`` bytes from the peer.
+
+        .. note:: Implementors of this interface should not return an empty
+            :class:`bytes` object, and users should ignore them.
+
+        :param max_bytes: maximum number of bytes to receive
+        :return: the received bytes
+        :raises ~anyio.EndOfStream: if this stream has been closed from the other end
+        """
+
+
+class ByteSendStream(AsyncResource, TypedAttributeProvider):
+    """An interface for sending bytes to a single peer."""
+
+    @abstractmethod
+    async def send(self, item: bytes) -> None:
+        """
+        Send the given bytes to the peer.
+
+        :param item: the bytes to send
+        """
+
+
+class ByteStream(ByteReceiveStream, ByteSendStream):
+    """A bidirectional byte stream."""
+
+    @abstractmethod
+    async def send_eof(self) -> None:
+        """
+        Send an end-of-file indication to the peer.
+
+        You should not try to send any further data to this stream after calling this
+        method. This method is idempotent (does nothing on successive calls).
+        """
+
+
+#: Type alias for all unreliable bytes-oriented receive streams.
+AnyUnreliableByteReceiveStream = Union[
+    UnreliableObjectReceiveStream[bytes], ByteReceiveStream
+]
+#: Type alias for all unreliable bytes-oriented send streams.
+AnyUnreliableByteSendStream = Union[UnreliableObjectSendStream[bytes], ByteSendStream]
+#: Type alias for all unreliable bytes-oriented streams.
+AnyUnreliableByteStream = Union[UnreliableObjectStream[bytes], ByteStream]
+#: Type alias for all bytes-oriented receive streams.
+AnyByteReceiveStream = Union[ObjectReceiveStream[bytes], ByteReceiveStream]
+#: Type alias for all bytes-oriented send streams.
+AnyByteSendStream = Union[ObjectSendStream[bytes], ByteSendStream]
+#: Type alias for all bytes-oriented streams.
+AnyByteStream = Union[ObjectStream[bytes], ByteStream]
+
+
+class Listener(Generic[T_co], AsyncResource, TypedAttributeProvider):
+    """An interface for objects that let you accept incoming connections."""
+
+    @abstractmethod
+    async def serve(
+        self, handler: Callable[[T_co], Any], task_group: TaskGroup | None = None
+    ) -> None:
+        """
+        Accept incoming connections as they come in and start tasks to handle them.
+
+        :param handler: a callable that will be used to handle each accepted connection
+        :param task_group: the task group that will be used to start tasks for handling
+            each accepted connection (if omitted, an ad-hoc task group will be created)
+        """
diff --git a/llm/Lib/site-packages/anyio/abc/_subprocesses.py b/llm/Lib/site-packages/anyio/abc/_subprocesses.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce0564ceac8aac425675b5c8f7f7205d08061fd3
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/abc/_subprocesses.py
@@ -0,0 +1,79 @@
+from __future__ import annotations
+
+from abc import abstractmethod
+from signal import Signals
+
+from ._resources import AsyncResource
+from ._streams import ByteReceiveStream, ByteSendStream
+
+
+class Process(AsyncResource):
+    """An asynchronous version of :class:`subprocess.Popen`."""
+
+    @abstractmethod
+    async def wait(self) -> int:
+        """
+        Wait until the process exits.
+
+        :return: the exit code of the process
+        """
+
+    @abstractmethod
+    def terminate(self) -> None:
+        """
+        Terminates the process, gracefully if possible.
+
+        On Windows, this calls ``TerminateProcess()``.
+        On POSIX systems, this sends ``SIGTERM`` to the process.
+
+        .. seealso:: :meth:`subprocess.Popen.terminate`
+        """
+
+    @abstractmethod
+    def kill(self) -> None:
+        """
+        Kills the process.
+
+        On Windows, this calls ``TerminateProcess()``.
+        On POSIX systems, this sends ``SIGKILL`` to the process.
+
+        .. seealso:: :meth:`subprocess.Popen.kill`
+        """
+
+    @abstractmethod
+    def send_signal(self, signal: Signals) -> None:
+        """
+        Send a signal to the subprocess.
+
+        .. seealso:: :meth:`subprocess.Popen.send_signal`
+
+        :param signal: the signal number (e.g. :data:`signal.SIGHUP`)
+        """
+
+    @property
+    @abstractmethod
+    def pid(self) -> int:
+        """The process ID of the process."""
+
+    @property
+    @abstractmethod
+    def returncode(self) -> int | None:
+        """
+        The return code of the process. If the process has not yet terminated, this will
+        be ``None``.
+        """
+
+    @property
+    @abstractmethod
+    def stdin(self) -> ByteSendStream | None:
+        """The stream for the standard input of the process."""
+
+    @property
+    @abstractmethod
+    def stdout(self) -> ByteReceiveStream | None:
+        """The stream for the standard output of the process."""
+
+    @property
+    @abstractmethod
+    def stderr(self) -> ByteReceiveStream | None:
+        """The stream for the standard error output of the process."""
diff --git a/llm/Lib/site-packages/anyio/abc/_tasks.py b/llm/Lib/site-packages/anyio/abc/_tasks.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ad4938cb4adb994f327a257c49ba0b5d6cdbe4e
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/abc/_tasks.py
@@ -0,0 +1,97 @@
+from __future__ import annotations
+
+import sys
+from abc import ABCMeta, abstractmethod
+from collections.abc import Awaitable, Callable
+from types import TracebackType
+from typing import TYPE_CHECKING, Any, Protocol, TypeVar, overload
+
+if sys.version_info >= (3, 11):
+    from typing import TypeVarTuple, Unpack
+else:
+    from typing_extensions import TypeVarTuple, Unpack
+
+if TYPE_CHECKING:
+    from .._core._tasks import CancelScope
+
+T_Retval = TypeVar("T_Retval")
+T_contra = TypeVar("T_contra", contravariant=True)
+PosArgsT = TypeVarTuple("PosArgsT")
+
+
+class TaskStatus(Protocol[T_contra]):
+    @overload
+    def started(self: TaskStatus[None]) -> None:
+        ...
+
+    @overload
+    def started(self, value: T_contra) -> None:
+        ...
+
+    def started(self, value: T_contra | None = None) -> None:
+        """
+        Signal that the task has started.
+
+        :param value: object passed back to the starter of the task
+        """
+
+
+class TaskGroup(metaclass=ABCMeta):
+    """
+    Groups several asynchronous tasks together.
+
+    :ivar cancel_scope: the cancel scope inherited by all child tasks
+    :vartype cancel_scope: CancelScope
+    """
+
+    cancel_scope: CancelScope
+
+    @abstractmethod
+    def start_soon(
+        self,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[Any]],
+        *args: Unpack[PosArgsT],
+        name: object = None,
+    ) -> None:
+        """
+        Start a new task in this task group.
+
+        :param func: a coroutine function
+        :param args: positional arguments to call the function with
+        :param name: name of the task, for the purposes of introspection and debugging
+
+        .. versionadded:: 3.0
+        """
+
+    @abstractmethod
+    async def start(
+        self,
+        func: Callable[..., Awaitable[Any]],
+        *args: object,
+        name: object = None,
+    ) -> Any:
+        """
+        Start a new task and wait until it signals for readiness.
+
+        :param func: a coroutine function
+        :param args: positional arguments to call the function with
+        :param name: name of the task, for the purposes of introspection and debugging
+        :return: the value passed to ``task_status.started()``
+        :raises RuntimeError: if the task finishes without calling
+            ``task_status.started()``
+
+        .. versionadded:: 3.0
+        """
+
+    @abstractmethod
+    async def __aenter__(self) -> TaskGroup:
+        """Enter the task group context and allow starting new tasks."""
+
+    @abstractmethod
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
+        """Exit the task group context waiting for all tasks to finish."""
diff --git a/llm/Lib/site-packages/anyio/abc/_testing.py b/llm/Lib/site-packages/anyio/abc/_testing.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d70b9ec6b90e49a9d6b1d5ef39d362a7a661a2a
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/abc/_testing.py
@@ -0,0 +1,66 @@
+from __future__ import annotations
+
+import types
+from abc import ABCMeta, abstractmethod
+from collections.abc import AsyncGenerator, Callable, Coroutine, Iterable
+from typing import Any, TypeVar
+
+_T = TypeVar("_T")
+
+
+class TestRunner(metaclass=ABCMeta):
+    """
+    Encapsulates a running event loop. Every call made through this object will use the
+    same event loop.
+    """
+
+    def __enter__(self) -> TestRunner:
+        return self
+
+    @abstractmethod
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: types.TracebackType | None,
+    ) -> bool | None:
+        ...
+
+    @abstractmethod
+    def run_asyncgen_fixture(
+        self,
+        fixture_func: Callable[..., AsyncGenerator[_T, Any]],
+        kwargs: dict[str, Any],
+    ) -> Iterable[_T]:
+        """
+        Run an async generator fixture.
+
+        :param fixture_func: the fixture function
+        :param kwargs: keyword arguments to call the fixture function with
+        :return: an iterator yielding the value yielded from the async generator
+        """
+
+    @abstractmethod
+    def run_fixture(
+        self,
+        fixture_func: Callable[..., Coroutine[Any, Any, _T]],
+        kwargs: dict[str, Any],
+    ) -> _T:
+        """
+        Run an async fixture.
+
+        :param fixture_func: the fixture function
+        :param kwargs: keyword arguments to call the fixture function with
+        :return: the return value of the fixture function
+        """
+
+    @abstractmethod
+    def run_test(
+        self, test_func: Callable[..., Coroutine[Any, Any, Any]], kwargs: dict[str, Any]
+    ) -> None:
+        """
+        Run an async test function.
+
+        :param test_func: the test function
+        :param kwargs: keyword arguments to call the test function with
+        """
diff --git a/llm/Lib/site-packages/anyio/from_thread.py b/llm/Lib/site-packages/anyio/from_thread.py
new file mode 100644
index 0000000000000000000000000000000000000000..4a987031fec01662c41fd6a030f59fbe3e8a4abb
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/from_thread.py
@@ -0,0 +1,476 @@
+from __future__ import annotations
+
+import sys
+import threading
+from collections.abc import Awaitable, Callable, Generator
+from concurrent.futures import FIRST_COMPLETED, Future, ThreadPoolExecutor, wait
+from contextlib import AbstractContextManager, contextmanager
+from inspect import isawaitable
+from types import TracebackType
+from typing import (
+    Any,
+    AsyncContextManager,
+    ContextManager,
+    Generic,
+    Iterable,
+    TypeVar,
+    cast,
+    overload,
+)
+
+from ._core import _eventloop
+from ._core._eventloop import get_async_backend, get_cancelled_exc_class, threadlocals
+from ._core._synchronization import Event
+from ._core._tasks import CancelScope, create_task_group
+from .abc import AsyncBackend
+from .abc._tasks import TaskStatus
+
+if sys.version_info >= (3, 11):
+    from typing import TypeVarTuple, Unpack
+else:
+    from typing_extensions import TypeVarTuple, Unpack
+
+T_Retval = TypeVar("T_Retval")
+T_co = TypeVar("T_co", covariant=True)
+PosArgsT = TypeVarTuple("PosArgsT")
+
+
+def run(
+    func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]], *args: Unpack[PosArgsT]
+) -> T_Retval:
+    """
+    Call a coroutine function from a worker thread.
+
+    :param func: a coroutine function
+    :param args: positional arguments for the callable
+    :return: the return value of the coroutine function
+
+    """
+    try:
+        async_backend = threadlocals.current_async_backend
+        token = threadlocals.current_token
+    except AttributeError:
+        raise RuntimeError(
+            "This function can only be run from an AnyIO worker thread"
+        ) from None
+
+    return async_backend.run_async_from_thread(func, args, token=token)
+
+
+def run_sync(
+    func: Callable[[Unpack[PosArgsT]], T_Retval], *args: Unpack[PosArgsT]
+) -> T_Retval:
+    """
+    Call a function in the event loop thread from a worker thread.
+
+    :param func: a callable
+    :param args: positional arguments for the callable
+    :return: the return value of the callable
+
+    """
+    try:
+        async_backend = threadlocals.current_async_backend
+        token = threadlocals.current_token
+    except AttributeError:
+        raise RuntimeError(
+            "This function can only be run from an AnyIO worker thread"
+        ) from None
+
+    return async_backend.run_sync_from_thread(func, args, token=token)
+
+
+class _BlockingAsyncContextManager(Generic[T_co], AbstractContextManager):
+    _enter_future: Future[T_co]
+    _exit_future: Future[bool | None]
+    _exit_event: Event
+    _exit_exc_info: tuple[
+        type[BaseException] | None, BaseException | None, TracebackType | None
+    ] = (None, None, None)
+
+    def __init__(self, async_cm: AsyncContextManager[T_co], portal: BlockingPortal):
+        self._async_cm = async_cm
+        self._portal = portal
+
+    async def run_async_cm(self) -> bool | None:
+        try:
+            self._exit_event = Event()
+            value = await self._async_cm.__aenter__()
+        except BaseException as exc:
+            self._enter_future.set_exception(exc)
+            raise
+        else:
+            self._enter_future.set_result(value)
+
+        try:
+            # Wait for the sync context manager to exit.
+            # This next statement can raise `get_cancelled_exc_class()` if
+            # something went wrong in a task group in this async context
+            # manager.
+            await self._exit_event.wait()
+        finally:
+            # In case of cancellation, it could be that we end up here before
+            # `_BlockingAsyncContextManager.__exit__` is called, and an
+            # `_exit_exc_info` has been set.
+            result = await self._async_cm.__aexit__(*self._exit_exc_info)
+            return result
+
+    def __enter__(self) -> T_co:
+        self._enter_future = Future()
+        self._exit_future = self._portal.start_task_soon(self.run_async_cm)
+        return self._enter_future.result()
+
+    def __exit__(
+        self,
+        __exc_type: type[BaseException] | None,
+        __exc_value: BaseException | None,
+        __traceback: TracebackType | None,
+    ) -> bool | None:
+        self._exit_exc_info = __exc_type, __exc_value, __traceback
+        self._portal.call(self._exit_event.set)
+        return self._exit_future.result()
+
+
+class _BlockingPortalTaskStatus(TaskStatus):
+    def __init__(self, future: Future):
+        self._future = future
+
+    def started(self, value: object = None) -> None:
+        self._future.set_result(value)
+
+
+class BlockingPortal:
+    """An object that lets external threads run code in an asynchronous event loop."""
+
+    def __new__(cls) -> BlockingPortal:
+        return get_async_backend().create_blocking_portal()
+
+    def __init__(self) -> None:
+        self._event_loop_thread_id: int | None = threading.get_ident()
+        self._stop_event = Event()
+        self._task_group = create_task_group()
+        self._cancelled_exc_class = get_cancelled_exc_class()
+
+    async def __aenter__(self) -> BlockingPortal:
+        await self._task_group.__aenter__()
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> bool | None:
+        await self.stop()
+        return await self._task_group.__aexit__(exc_type, exc_val, exc_tb)
+
+    def _check_running(self) -> None:
+        if self._event_loop_thread_id is None:
+            raise RuntimeError("This portal is not running")
+        if self._event_loop_thread_id == threading.get_ident():
+            raise RuntimeError(
+                "This method cannot be called from the event loop thread"
+            )
+
+    async def sleep_until_stopped(self) -> None:
+        """Sleep until :meth:`stop` is called."""
+        await self._stop_event.wait()
+
+    async def stop(self, cancel_remaining: bool = False) -> None:
+        """
+        Signal the portal to shut down.
+
+        This marks the portal as no longer accepting new calls and exits from
+        :meth:`sleep_until_stopped`.
+
+        :param cancel_remaining: ``True`` to cancel all the remaining tasks, ``False``
+            to let them finish before returning
+
+        """
+        self._event_loop_thread_id = None
+        self._stop_event.set()
+        if cancel_remaining:
+            self._task_group.cancel_scope.cancel()
+
+    async def _call_func(
+        self,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval] | T_Retval],
+        args: tuple[Unpack[PosArgsT]],
+        kwargs: dict[str, Any],
+        future: Future[T_Retval],
+    ) -> None:
+        def callback(f: Future[T_Retval]) -> None:
+            if f.cancelled() and self._event_loop_thread_id not in (
+                None,
+                threading.get_ident(),
+            ):
+                self.call(scope.cancel)
+
+        try:
+            retval_or_awaitable = func(*args, **kwargs)
+            if isawaitable(retval_or_awaitable):
+                with CancelScope() as scope:
+                    if future.cancelled():
+                        scope.cancel()
+                    else:
+                        future.add_done_callback(callback)
+
+                    retval = await retval_or_awaitable
+            else:
+                retval = retval_or_awaitable
+        except self._cancelled_exc_class:
+            future.cancel()
+            future.set_running_or_notify_cancel()
+        except BaseException as exc:
+            if not future.cancelled():
+                future.set_exception(exc)
+
+            # Let base exceptions fall through
+            if not isinstance(exc, Exception):
+                raise
+        else:
+            if not future.cancelled():
+                future.set_result(retval)
+        finally:
+            scope = None  # type: ignore[assignment]
+
+    def _spawn_task_from_thread(
+        self,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval] | T_Retval],
+        args: tuple[Unpack[PosArgsT]],
+        kwargs: dict[str, Any],
+        name: object,
+        future: Future[T_Retval],
+    ) -> None:
+        """
+        Spawn a new task using the given callable.
+
+        Implementors must ensure that the future is resolved when the task finishes.
+
+        :param func: a callable
+        :param args: positional arguments to be passed to the callable
+        :param kwargs: keyword arguments to be passed to the callable
+        :param name: name of the task (will be coerced to a string if not ``None``)
+        :param future: a future that will resolve to the return value of the callable,
+            or the exception raised during its execution
+
+        """
+        raise NotImplementedError
+
+    @overload
+    def call(
+        self,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]],
+        *args: Unpack[PosArgsT],
+    ) -> T_Retval:
+        ...
+
+    @overload
+    def call(
+        self, func: Callable[[Unpack[PosArgsT]], T_Retval], *args: Unpack[PosArgsT]
+    ) -> T_Retval:
+        ...
+
+    def call(
+        self,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval] | T_Retval],
+        *args: Unpack[PosArgsT],
+    ) -> T_Retval:
+        """
+        Call the given function in the event loop thread.
+
+        If the callable returns a coroutine object, it is awaited on.
+
+        :param func: any callable
+        :raises RuntimeError: if the portal is not running or if this method is called
+            from within the event loop thread
+
+        """
+        return cast(T_Retval, self.start_task_soon(func, *args).result())
+
+    @overload
+    def start_task_soon(
+        self,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]],
+        *args: Unpack[PosArgsT],
+        name: object = None,
+    ) -> Future[T_Retval]:
+        ...
+
+    @overload
+    def start_task_soon(
+        self,
+        func: Callable[[Unpack[PosArgsT]], T_Retval],
+        *args: Unpack[PosArgsT],
+        name: object = None,
+    ) -> Future[T_Retval]:
+        ...
+
+    def start_task_soon(
+        self,
+        func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval] | T_Retval],
+        *args: Unpack[PosArgsT],
+        name: object = None,
+    ) -> Future[T_Retval]:
+        """
+        Start a task in the portal's task group.
+
+        The task will be run inside a cancel scope which can be cancelled by cancelling
+        the returned future.
+
+        :param func: the target function
+        :param args: positional arguments passed to ``func``
+        :param name: name of the task (will be coerced to a string if not ``None``)
+        :return: a future that resolves with the return value of the callable if the
+            task completes successfully, or with the exception raised in the task
+        :raises RuntimeError: if the portal is not running or if this method is called
+            from within the event loop thread
+        :rtype: concurrent.futures.Future[T_Retval]
+
+        .. versionadded:: 3.0
+
+        """
+        self._check_running()
+        f: Future[T_Retval] = Future()
+        self._spawn_task_from_thread(func, args, {}, name, f)
+        return f
+
+    def start_task(
+        self,
+        func: Callable[..., Awaitable[T_Retval]],
+        *args: object,
+        name: object = None,
+    ) -> tuple[Future[T_Retval], Any]:
+        """
+        Start a task in the portal's task group and wait until it signals for readiness.
+
+        This method works the same way as :meth:`.abc.TaskGroup.start`.
+
+        :param func: the target function
+        :param args: positional arguments passed to ``func``
+        :param name: name of the task (will be coerced to a string if not ``None``)
+        :return: a tuple of (future, task_status_value) where the ``task_status_value``
+            is the value passed to ``task_status.started()`` from within the target
+            function
+        :rtype: tuple[concurrent.futures.Future[T_Retval], Any]
+
+        .. versionadded:: 3.0
+
+        """
+
+        def task_done(future: Future[T_Retval]) -> None:
+            if not task_status_future.done():
+                if future.cancelled():
+                    task_status_future.cancel()
+                elif future.exception():
+                    task_status_future.set_exception(future.exception())
+                else:
+                    exc = RuntimeError(
+                        "Task exited without calling task_status.started()"
+                    )
+                    task_status_future.set_exception(exc)
+
+        self._check_running()
+        task_status_future: Future = Future()
+        task_status = _BlockingPortalTaskStatus(task_status_future)
+        f: Future = Future()
+        f.add_done_callback(task_done)
+        self._spawn_task_from_thread(func, args, {"task_status": task_status}, name, f)
+        return f, task_status_future.result()
+
+    def wrap_async_context_manager(
+        self, cm: AsyncContextManager[T_co]
+    ) -> ContextManager[T_co]:
+        """
+        Wrap an async context manager as a synchronous context manager via this portal.
+
+        Spawns a task that will call both ``__aenter__()`` and ``__aexit__()``, stopping
+        in the middle until the synchronous context manager exits.
+
+        :param cm: an asynchronous context manager
+        :return: a synchronous context manager
+
+        .. versionadded:: 2.1
+
+        """
+        return _BlockingAsyncContextManager(cm, self)
+
+
+@contextmanager
+def start_blocking_portal(
+    backend: str = "asyncio", backend_options: dict[str, Any] | None = None
+) -> Generator[BlockingPortal, Any, None]:
+    """
+    Start a new event loop in a new thread and run a blocking portal in its main task.
+
+    The parameters are the same as for :func:`~anyio.run`.
+
+    :param backend: name of the backend
+    :param backend_options: backend options
+    :return: a context manager that yields a blocking portal
+
+    .. versionchanged:: 3.0
+        Usage as a context manager is now required.
+
+    """
+
+    async def run_portal() -> None:
+        async with BlockingPortal() as portal_:
+            if future.set_running_or_notify_cancel():
+                future.set_result(portal_)
+                await portal_.sleep_until_stopped()
+
+    future: Future[BlockingPortal] = Future()
+    with ThreadPoolExecutor(1) as executor:
+        run_future = executor.submit(
+            _eventloop.run,  # type: ignore[arg-type]
+            run_portal,
+            backend=backend,
+            backend_options=backend_options,
+        )
+        try:
+            wait(
+                cast(Iterable[Future], [run_future, future]),
+                return_when=FIRST_COMPLETED,
+            )
+        except BaseException:
+            future.cancel()
+            run_future.cancel()
+            raise
+
+        if future.done():
+            portal = future.result()
+            cancel_remaining_tasks = False
+            try:
+                yield portal
+            except BaseException:
+                cancel_remaining_tasks = True
+                raise
+            finally:
+                try:
+                    portal.call(portal.stop, cancel_remaining_tasks)
+                except RuntimeError:
+                    pass
+
+        run_future.result()
+
+
+def check_cancelled() -> None:
+    """
+    Check if the cancel scope of the host task's running the current worker thread has
+    been cancelled.
+
+    If the host task's current cancel scope has indeed been cancelled, the
+    backend-specific cancellation exception will be raised.
+
+    :raises RuntimeError: if the current thread was not spawned by
+        :func:`.to_thread.run_sync`
+
+    """
+    try:
+        async_backend: AsyncBackend = threadlocals.current_async_backend
+    except AttributeError:
+        raise RuntimeError(
+            "This function can only be run from an AnyIO worker thread"
+        ) from None
+
+    async_backend.check_cancelled()
diff --git a/llm/Lib/site-packages/anyio/lowlevel.py b/llm/Lib/site-packages/anyio/lowlevel.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9e10f430ad83ae11d71df5cf60b95acb1996231
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/lowlevel.py
@@ -0,0 +1,163 @@
+from __future__ import annotations
+
+import enum
+from dataclasses import dataclass
+from typing import Any, Generic, Literal, TypeVar, overload
+from weakref import WeakKeyDictionary
+
+from ._core._eventloop import get_async_backend
+
+T = TypeVar("T")
+D = TypeVar("D")
+
+
+async def checkpoint() -> None:
+    """
+    Check for cancellation and allow the scheduler to switch to another task.
+
+    Equivalent to (but more efficient than)::
+
+        await checkpoint_if_cancelled()
+        await cancel_shielded_checkpoint()
+
+
+    .. versionadded:: 3.0
+
+    """
+    await get_async_backend().checkpoint()
+
+
+async def checkpoint_if_cancelled() -> None:
+    """
+    Enter a checkpoint if the enclosing cancel scope has been cancelled.
+
+    This does not allow the scheduler to switch to a different task.
+
+    .. versionadded:: 3.0
+
+    """
+    await get_async_backend().checkpoint_if_cancelled()
+
+
+async def cancel_shielded_checkpoint() -> None:
+    """
+    Allow the scheduler to switch to another task but without checking for cancellation.
+
+    Equivalent to (but potentially more efficient than)::
+
+        with CancelScope(shield=True):
+            await checkpoint()
+
+
+    .. versionadded:: 3.0
+
+    """
+    await get_async_backend().cancel_shielded_checkpoint()
+
+
+def current_token() -> object:
+    """
+    Return a backend specific token object that can be used to get back to the event
+    loop.
+
+    """
+    return get_async_backend().current_token()
+
+
+_run_vars: WeakKeyDictionary[Any, dict[str, Any]] = WeakKeyDictionary()
+_token_wrappers: dict[Any, _TokenWrapper] = {}
+
+
+@dataclass(frozen=True)
+class _TokenWrapper:
+    __slots__ = "_token", "__weakref__"
+    _token: object
+
+
+class _NoValueSet(enum.Enum):
+    NO_VALUE_SET = enum.auto()
+
+
+class RunvarToken(Generic[T]):
+    __slots__ = "_var", "_value", "_redeemed"
+
+    def __init__(self, var: RunVar[T], value: T | Literal[_NoValueSet.NO_VALUE_SET]):
+        self._var = var
+        self._value: T | Literal[_NoValueSet.NO_VALUE_SET] = value
+        self._redeemed = False
+
+
+class RunVar(Generic[T]):
+    """
+    Like a :class:`~contextvars.ContextVar`, except scoped to the running event loop.
+    """
+
+    __slots__ = "_name", "_default"
+
+    NO_VALUE_SET: Literal[_NoValueSet.NO_VALUE_SET] = _NoValueSet.NO_VALUE_SET
+
+    _token_wrappers: set[_TokenWrapper] = set()
+
+    def __init__(
+        self, name: str, default: T | Literal[_NoValueSet.NO_VALUE_SET] = NO_VALUE_SET
+    ):
+        self._name = name
+        self._default = default
+
+    @property
+    def _current_vars(self) -> dict[str, T]:
+        token = current_token()
+        try:
+            return _run_vars[token]
+        except KeyError:
+            run_vars = _run_vars[token] = {}
+            return run_vars
+
+    @overload
+    def get(self, default: D) -> T | D:
+        ...
+
+    @overload
+    def get(self) -> T:
+        ...
+
+    def get(
+        self, default: D | Literal[_NoValueSet.NO_VALUE_SET] = NO_VALUE_SET
+    ) -> T | D:
+        try:
+            return self._current_vars[self._name]
+        except KeyError:
+            if default is not RunVar.NO_VALUE_SET:
+                return default
+            elif self._default is not RunVar.NO_VALUE_SET:
+                return self._default
+
+        raise LookupError(
+            f'Run variable "{self._name}" has no value and no default set'
+        )
+
+    def set(self, value: T) -> RunvarToken[T]:
+        current_vars = self._current_vars
+        token = RunvarToken(self, current_vars.get(self._name, RunVar.NO_VALUE_SET))
+        current_vars[self._name] = value
+        return token
+
+    def reset(self, token: RunvarToken[T]) -> None:
+        if token._var is not self:
+            raise ValueError("This token does not belong to this RunVar")
+
+        if token._redeemed:
+            raise ValueError("This token has already been used")
+
+        if token._value is _NoValueSet.NO_VALUE_SET:
+            try:
+                del self._current_vars[self._name]
+            except KeyError:
+                pass
+        else:
+            self._current_vars[self._name] = token._value
+
+        token._redeemed = True
+
+    def __repr__(self) -> str:
+        return f"<RunVar name={self._name!r}>"
diff --git a/llm/Lib/site-packages/anyio/py.typed b/llm/Lib/site-packages/anyio/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/anyio/pytest_plugin.py b/llm/Lib/site-packages/anyio/pytest_plugin.py
new file mode 100644
index 0000000000000000000000000000000000000000..a8dd6f3e3f12eda1f4fdffaff6cc6fd7425949ff
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/pytest_plugin.py
@@ -0,0 +1,149 @@
+from __future__ import annotations
+
+from collections.abc import Iterator
+from contextlib import ExitStack, contextmanager
+from inspect import isasyncgenfunction, iscoroutinefunction
+from typing import Any, Dict, Tuple, cast
+
+import pytest
+import sniffio
+
+from ._core._eventloop import get_all_backends, get_async_backend
+from .abc import TestRunner
+
+_current_runner: TestRunner | None = None
+_runner_stack: ExitStack | None = None
+_runner_leases = 0
+
+
+def extract_backend_and_options(backend: object) -> tuple[str, dict[str, Any]]:
+    if isinstance(backend, str):
+        return backend, {}
+    elif isinstance(backend, tuple) and len(backend) == 2:
+        if isinstance(backend[0], str) and isinstance(backend[1], dict):
+            return cast(Tuple[str, Dict[str, Any]], backend)
+
+    raise TypeError("anyio_backend must be either a string or tuple of (string, dict)")
+
+
+@contextmanager
+def get_runner(
+    backend_name: str, backend_options: dict[str, Any]
+) -> Iterator[TestRunner]:
+    global _current_runner, _runner_leases, _runner_stack
+    if _current_runner is None:
+        asynclib = get_async_backend(backend_name)
+        _runner_stack = ExitStack()
+        if sniffio.current_async_library_cvar.get(None) is None:
+            # Since we're in control of the event loop, we can cache the name of the
+            # async library
+            token = sniffio.current_async_library_cvar.set(backend_name)
+            _runner_stack.callback(sniffio.current_async_library_cvar.reset, token)
+
+        backend_options = backend_options or {}
+        _current_runner = _runner_stack.enter_context(
+            asynclib.create_test_runner(backend_options)
+        )
+
+    _runner_leases += 1
+    try:
+        yield _current_runner
+    finally:
+        _runner_leases -= 1
+        if not _runner_leases:
+            assert _runner_stack is not None
+            _runner_stack.close()
+            _runner_stack = _current_runner = None
+
+
+def pytest_configure(config: Any) -> None:
+    config.addinivalue_line(
+        "markers",
+        "anyio: mark the (coroutine function) test to be run "
+        "asynchronously via anyio.",
+    )
+
+
+def pytest_fixture_setup(fixturedef: Any, request: Any) -> None:
+    def wrapper(*args, anyio_backend, **kwargs):  # type: ignore[no-untyped-def]
+        backend_name, backend_options = extract_backend_and_options(anyio_backend)
+        if has_backend_arg:
+            kwargs["anyio_backend"] = anyio_backend
+
+        with get_runner(backend_name, backend_options) as runner:
+            if isasyncgenfunction(func):
+                yield from runner.run_asyncgen_fixture(func, kwargs)
+            else:
+                yield runner.run_fixture(func, kwargs)
+
+    # Only apply this to coroutine functions and async generator functions in requests
+    # that involve the anyio_backend fixture
+    func = fixturedef.func
+    if isasyncgenfunction(func) or iscoroutinefunction(func):
+        if "anyio_backend" in request.fixturenames:
+            has_backend_arg = "anyio_backend" in fixturedef.argnames
+            fixturedef.func = wrapper
+            if not has_backend_arg:
+                fixturedef.argnames += ("anyio_backend",)
+
+
+@pytest.hookimpl(tryfirst=True)
+def pytest_pycollect_makeitem(collector: Any, name: Any, obj: Any) -> None:
+    if collector.istestfunction(obj, name):
+        inner_func = obj.hypothesis.inner_test if hasattr(obj, "hypothesis") else obj
+        if iscoroutinefunction(inner_func):
+            marker = collector.get_closest_marker("anyio")
+            own_markers = getattr(obj, "pytestmark", ())
+            if marker or any(marker.name == "anyio" for marker in own_markers):
+                pytest.mark.usefixtures("anyio_backend")(obj)
+
+
+@pytest.hookimpl(tryfirst=True)
+def pytest_pyfunc_call(pyfuncitem: Any) -> bool | None:
+    def run_with_hypothesis(**kwargs: Any) -> None:
+        with get_runner(backend_name, backend_options) as runner:
+            runner.run_test(original_func, kwargs)
+
+    backend = pyfuncitem.funcargs.get("anyio_backend")
+    if backend:
+        backend_name, backend_options = extract_backend_and_options(backend)
+
+        if hasattr(pyfuncitem.obj, "hypothesis"):
+            # Wrap the inner test function unless it's already wrapped
+            original_func = pyfuncitem.obj.hypothesis.inner_test
+            if original_func.__qualname__ != run_with_hypothesis.__qualname__:
+                if iscoroutinefunction(original_func):
+                    pyfuncitem.obj.hypothesis.inner_test = run_with_hypothesis
+
+            return None
+
+        if iscoroutinefunction(pyfuncitem.obj):
+            funcargs = pyfuncitem.funcargs
+            testargs = {arg: funcargs[arg] for arg in pyfuncitem._fixtureinfo.argnames}
+            with get_runner(backend_name, backend_options) as runner:
+                runner.run_test(pyfuncitem.obj, testargs)
+
+            return True
+
+    return None
+
+
+@pytest.fixture(scope="module", params=get_all_backends())
+def anyio_backend(request: Any) -> Any:
+    return request.param
+
+
+@pytest.fixture
+def anyio_backend_name(anyio_backend: Any) -> str:
+    if isinstance(anyio_backend, str):
+        return anyio_backend
+    else:
+        return anyio_backend[0]
+
+
+@pytest.fixture
+def anyio_backend_options(anyio_backend: Any) -> dict[str, Any]:
+    if isinstance(anyio_backend, str):
+        return {}
+    else:
+        return anyio_backend[1]
diff --git a/llm/Lib/site-packages/anyio/streams/__init__.py b/llm/Lib/site-packages/anyio/streams/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/anyio/streams/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/anyio/streams/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..712ca67606e940ee6c9785ac55dbce371e3d42ad
Binary files /dev/null and b/llm/Lib/site-packages/anyio/streams/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/streams/__pycache__/buffered.cpython-311.pyc b/llm/Lib/site-packages/anyio/streams/__pycache__/buffered.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..99fd590139f1eda2528176a34380a142f1d94351
Binary files /dev/null and b/llm/Lib/site-packages/anyio/streams/__pycache__/buffered.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/streams/__pycache__/file.cpython-311.pyc b/llm/Lib/site-packages/anyio/streams/__pycache__/file.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..32fabd786eee35c5c3e587b6fb14f96af76c1f50
Binary files /dev/null and b/llm/Lib/site-packages/anyio/streams/__pycache__/file.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/streams/__pycache__/memory.cpython-311.pyc b/llm/Lib/site-packages/anyio/streams/__pycache__/memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f10fb56893272d8b854eee4c2e88e6ba1fbe863d
Binary files /dev/null and b/llm/Lib/site-packages/anyio/streams/__pycache__/memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/streams/__pycache__/stapled.cpython-311.pyc b/llm/Lib/site-packages/anyio/streams/__pycache__/stapled.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a8169868163e1945ddafc723010aca6e2c12dbb7
Binary files /dev/null and b/llm/Lib/site-packages/anyio/streams/__pycache__/stapled.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/streams/__pycache__/text.cpython-311.pyc b/llm/Lib/site-packages/anyio/streams/__pycache__/text.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2f8ffba37d50d6d7adf273a210fc2ec11ddb9142
Binary files /dev/null and b/llm/Lib/site-packages/anyio/streams/__pycache__/text.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/streams/__pycache__/tls.cpython-311.pyc b/llm/Lib/site-packages/anyio/streams/__pycache__/tls.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..30086e9f7584910259a2508ab01297558ee4ffd4
Binary files /dev/null and b/llm/Lib/site-packages/anyio/streams/__pycache__/tls.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/anyio/streams/buffered.py b/llm/Lib/site-packages/anyio/streams/buffered.py
new file mode 100644
index 0000000000000000000000000000000000000000..f5d5e836dd43d616c553d9bf08260054ff96b961
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/streams/buffered.py
@@ -0,0 +1,119 @@
+from __future__ import annotations
+
+from collections.abc import Callable, Mapping
+from dataclasses import dataclass, field
+from typing import Any
+
+from .. import ClosedResourceError, DelimiterNotFound, EndOfStream, IncompleteRead
+from ..abc import AnyByteReceiveStream, ByteReceiveStream
+
+
+@dataclass(eq=False)
+class BufferedByteReceiveStream(ByteReceiveStream):
+    """
+    Wraps any bytes-based receive stream and uses a buffer to provide sophisticated
+    receiving capabilities in the form of a byte stream.
+    """
+
+    receive_stream: AnyByteReceiveStream
+    _buffer: bytearray = field(init=False, default_factory=bytearray)
+    _closed: bool = field(init=False, default=False)
+
+    async def aclose(self) -> None:
+        await self.receive_stream.aclose()
+        self._closed = True
+
+    @property
+    def buffer(self) -> bytes:
+        """The bytes currently in the buffer."""
+        return bytes(self._buffer)
+
+    @property
+    def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]:
+        return self.receive_stream.extra_attributes
+
+    async def receive(self, max_bytes: int = 65536) -> bytes:
+        if self._closed:
+            raise ClosedResourceError
+
+        if self._buffer:
+            chunk = bytes(self._buffer[:max_bytes])
+            del self._buffer[:max_bytes]
+            return chunk
+        elif isinstance(self.receive_stream, ByteReceiveStream):
+            return await self.receive_stream.receive(max_bytes)
+        else:
+            # With a bytes-oriented object stream, we need to handle any surplus bytes
+            # we get from the receive() call
+            chunk = await self.receive_stream.receive()
+            if len(chunk) > max_bytes:
+                # Save the surplus bytes in the buffer
+                self._buffer.extend(chunk[max_bytes:])
+                return chunk[:max_bytes]
+            else:
+                return chunk
+
+    async def receive_exactly(self, nbytes: int) -> bytes:
+        """
+        Read exactly the given amount of bytes from the stream.
+
+        :param nbytes: the number of bytes to read
+        :return: the bytes read
+        :raises ~anyio.IncompleteRead: if the stream was closed before the requested
+            amount of bytes could be read from the stream
+
+        """
+        while True:
+            remaining = nbytes - len(self._buffer)
+            if remaining <= 0:
+                retval = self._buffer[:nbytes]
+                del self._buffer[:nbytes]
+                return bytes(retval)
+
+            try:
+                if isinstance(self.receive_stream, ByteReceiveStream):
+                    chunk = await self.receive_stream.receive(remaining)
+                else:
+                    chunk = await self.receive_stream.receive()
+            except EndOfStream as exc:
+                raise IncompleteRead from exc
+
+            self._buffer.extend(chunk)
+
+    async def receive_until(self, delimiter: bytes, max_bytes: int) -> bytes:
+        """
+        Read from the stream until the delimiter is found or max_bytes have been read.
+
+        :param delimiter: the marker to look for in the stream
+        :param max_bytes: maximum number of bytes that will be read before raising
+            :exc:`~anyio.DelimiterNotFound`
+        :return: the bytes read (not including the delimiter)
+        :raises ~anyio.IncompleteRead: if the stream was closed before the delimiter
+            was found
+        :raises ~anyio.DelimiterNotFound: if the delimiter is not found within the
+            bytes read up to the maximum allowed
+
+        """
+        delimiter_size = len(delimiter)
+        offset = 0
+        while True:
+            # Check if the delimiter can be found in the current buffer
+            index = self._buffer.find(delimiter, offset)
+            if index >= 0:
+                found = self._buffer[:index]
+                del self._buffer[: index + len(delimiter) :]
+                return bytes(found)
+
+            # Check if the buffer is already at or over the limit
+            if len(self._buffer) >= max_bytes:
+                raise DelimiterNotFound(max_bytes)
+
+            # Read more data into the buffer from the socket
+            try:
+                data = await self.receive_stream.receive()
+            except EndOfStream as exc:
+                raise IncompleteRead from exc
+
+            # Move the offset forward and add the new data to the buffer
+            offset = max(len(self._buffer) - delimiter_size + 1, 0)
+            self._buffer.extend(data)
diff --git a/llm/Lib/site-packages/anyio/streams/file.py b/llm/Lib/site-packages/anyio/streams/file.py
new file mode 100644
index 0000000000000000000000000000000000000000..f492464267ac54b57ee9953a4aad128f06a2110a
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/streams/file.py
@@ -0,0 +1,148 @@
+from __future__ import annotations
+
+from collections.abc import Callable, Mapping
+from io import SEEK_SET, UnsupportedOperation
+from os import PathLike
+from pathlib import Path
+from typing import Any, BinaryIO, cast
+
+from .. import (
+    BrokenResourceError,
+    ClosedResourceError,
+    EndOfStream,
+    TypedAttributeSet,
+    to_thread,
+    typed_attribute,
+)
+from ..abc import ByteReceiveStream, ByteSendStream
+
+
+class FileStreamAttribute(TypedAttributeSet):
+    #: the open file descriptor
+    file: BinaryIO = typed_attribute()
+    #: the path of the file on the file system, if available (file must be a real file)
+    path: Path = typed_attribute()
+    #: the file number, if available (file must be a real file or a TTY)
+    fileno: int = typed_attribute()
+
+
+class _BaseFileStream:
+    def __init__(self, file: BinaryIO):
+        self._file = file
+
+    async def aclose(self) -> None:
+        await to_thread.run_sync(self._file.close)
+
+    @property
+    def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]:
+        attributes: dict[Any, Callable[[], Any]] = {
+            FileStreamAttribute.file: lambda: self._file,
+        }
+
+        if hasattr(self._file, "name"):
+            attributes[FileStreamAttribute.path] = lambda: Path(self._file.name)
+
+        try:
+            self._file.fileno()
+        except UnsupportedOperation:
+            pass
+        else:
+            attributes[FileStreamAttribute.fileno] = lambda: self._file.fileno()
+
+        return attributes
+
+
+class FileReadStream(_BaseFileStream, ByteReceiveStream):
+    """
+    A byte stream that reads from a file in the file system.
+
+    :param file: a file that has been opened for reading in binary mode
+
+    .. versionadded:: 3.0
+    """
+
+    @classmethod
+    async def from_path(cls, path: str | PathLike[str]) -> FileReadStream:
+        """
+        Create a file read stream by opening the given file.
+
+        :param path: path of the file to read from
+
+        """
+        file = await to_thread.run_sync(Path(path).open, "rb")
+        return cls(cast(BinaryIO, file))
+
+    async def receive(self, max_bytes: int = 65536) -> bytes:
+        try:
+            data = await to_thread.run_sync(self._file.read, max_bytes)
+        except ValueError:
+            raise ClosedResourceError from None
+        except OSError as exc:
+            raise BrokenResourceError from exc
+
+        if data:
+            return data
+        else:
+            raise EndOfStream
+
+    async def seek(self, position: int, whence: int = SEEK_SET) -> int:
+        """
+        Seek the file to the given position.
+
+        .. seealso:: :meth:`io.IOBase.seek`
+
+        .. note:: Not all file descriptors are seekable.
+
+        :param position: position to seek the file to
+        :param whence: controls how ``position`` is interpreted
+        :return: the new absolute position
+        :raises OSError: if the file is not seekable
+
+        """
+        return await to_thread.run_sync(self._file.seek, position, whence)
+
+    async def tell(self) -> int:
+        """
+        Return the current stream position.
+
+        .. note:: Not all file descriptors are seekable.
+
+        :return: the current absolute position
+        :raises OSError: if the file is not seekable
+
+        """
+        return await to_thread.run_sync(self._file.tell)
+
+
+class FileWriteStream(_BaseFileStream, ByteSendStream):
+    """
+    A byte stream that writes to a file in the file system.
+
+    :param file: a file that has been opened for writing in binary mode
+
+    .. versionadded:: 3.0
+    """
+
+    @classmethod
+    async def from_path(
+        cls, path: str | PathLike[str], append: bool = False
+    ) -> FileWriteStream:
+        """
+        Create a file write stream by opening the given file for writing.
+
+        :param path: path of the file to write to
+        :param append: if ``True``, open the file for appending; if ``False``, any
+            existing file at the given path will be truncated
+
+        """
+        mode = "ab" if append else "wb"
+        file = await to_thread.run_sync(Path(path).open, mode)
+        return cls(cast(BinaryIO, file))
+
+    async def send(self, item: bytes) -> None:
+        try:
+            await to_thread.run_sync(self._file.write, item)
+        except ValueError:
+            raise ClosedResourceError from None
+        except OSError as exc:
+            raise BrokenResourceError from exc
diff --git a/llm/Lib/site-packages/anyio/streams/memory.py b/llm/Lib/site-packages/anyio/streams/memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc2425b76fc2f1e78b6998c76918bd0c575dc4ba
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/streams/memory.py
@@ -0,0 +1,283 @@
+from __future__ import annotations
+
+from collections import OrderedDict, deque
+from dataclasses import dataclass, field
+from types import TracebackType
+from typing import Generic, NamedTuple, TypeVar
+
+from .. import (
+    BrokenResourceError,
+    ClosedResourceError,
+    EndOfStream,
+    WouldBlock,
+)
+from ..abc import Event, ObjectReceiveStream, ObjectSendStream
+from ..lowlevel import checkpoint
+
+T_Item = TypeVar("T_Item")
+T_co = TypeVar("T_co", covariant=True)
+T_contra = TypeVar("T_contra", contravariant=True)
+
+
+class MemoryObjectStreamStatistics(NamedTuple):
+    current_buffer_used: int  #: number of items stored in the buffer
+    #: maximum number of items that can be stored on this stream (or :data:`math.inf`)
+    max_buffer_size: float
+    open_send_streams: int  #: number of unclosed clones of the send stream
+    open_receive_streams: int  #: number of unclosed clones of the receive stream
+    #: number of tasks blocked on :meth:`MemoryObjectSendStream.send`
+    tasks_waiting_send: int
+    #: number of tasks blocked on :meth:`MemoryObjectReceiveStream.receive`
+    tasks_waiting_receive: int
+
+
+@dataclass(eq=False)
+class MemoryObjectStreamState(Generic[T_Item]):
+    max_buffer_size: float = field()
+    buffer: deque[T_Item] = field(init=False, default_factory=deque)
+    open_send_channels: int = field(init=False, default=0)
+    open_receive_channels: int = field(init=False, default=0)
+    waiting_receivers: OrderedDict[Event, list[T_Item]] = field(
+        init=False, default_factory=OrderedDict
+    )
+    waiting_senders: OrderedDict[Event, T_Item] = field(
+        init=False, default_factory=OrderedDict
+    )
+
+    def statistics(self) -> MemoryObjectStreamStatistics:
+        return MemoryObjectStreamStatistics(
+            len(self.buffer),
+            self.max_buffer_size,
+            self.open_send_channels,
+            self.open_receive_channels,
+            len(self.waiting_senders),
+            len(self.waiting_receivers),
+        )
+
+
+@dataclass(eq=False)
+class MemoryObjectReceiveStream(Generic[T_co], ObjectReceiveStream[T_co]):
+    _state: MemoryObjectStreamState[T_co]
+    _closed: bool = field(init=False, default=False)
+
+    def __post_init__(self) -> None:
+        self._state.open_receive_channels += 1
+
+    def receive_nowait(self) -> T_co:
+        """
+        Receive the next item if it can be done without waiting.
+
+        :return: the received item
+        :raises ~anyio.ClosedResourceError: if this send stream has been closed
+        :raises ~anyio.EndOfStream: if the buffer is empty and this stream has been
+            closed from the sending end
+        :raises ~anyio.WouldBlock: if there are no items in the buffer and no tasks
+            waiting to send
+
+        """
+        if self._closed:
+            raise ClosedResourceError
+
+        if self._state.waiting_senders:
+            # Get the item from the next sender
+            send_event, item = self._state.waiting_senders.popitem(last=False)
+            self._state.buffer.append(item)
+            send_event.set()
+
+        if self._state.buffer:
+            return self._state.buffer.popleft()
+        elif not self._state.open_send_channels:
+            raise EndOfStream
+
+        raise WouldBlock
+
+    async def receive(self) -> T_co:
+        await checkpoint()
+        try:
+            return self.receive_nowait()
+        except WouldBlock:
+            # Add ourselves in the queue
+            receive_event = Event()
+            container: list[T_co] = []
+            self._state.waiting_receivers[receive_event] = container
+
+            try:
+                await receive_event.wait()
+            finally:
+                self._state.waiting_receivers.pop(receive_event, None)
+
+            if container:
+                return container[0]
+            else:
+                raise EndOfStream
+
+    def clone(self) -> MemoryObjectReceiveStream[T_co]:
+        """
+        Create a clone of this receive stream.
+
+        Each clone can be closed separately. Only when all clones have been closed will
+        the receiving end of the memory stream be considered closed by the sending ends.
+
+        :return: the cloned stream
+
+        """
+        if self._closed:
+            raise ClosedResourceError
+
+        return MemoryObjectReceiveStream(_state=self._state)
+
+    def close(self) -> None:
+        """
+        Close the stream.
+
+        This works the exact same way as :meth:`aclose`, but is provided as a special
+        case for the benefit of synchronous callbacks.
+
+        """
+        if not self._closed:
+            self._closed = True
+            self._state.open_receive_channels -= 1
+            if self._state.open_receive_channels == 0:
+                send_events = list(self._state.waiting_senders.keys())
+                for event in send_events:
+                    event.set()
+
+    async def aclose(self) -> None:
+        self.close()
+
+    def statistics(self) -> MemoryObjectStreamStatistics:
+        """
+        Return statistics about the current state of this stream.
+
+        .. versionadded:: 3.0
+        """
+        return self._state.statistics()
+
+    def __enter__(self) -> MemoryObjectReceiveStream[T_co]:
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> None:
+        self.close()
+
+
+@dataclass(eq=False)
+class MemoryObjectSendStream(Generic[T_contra], ObjectSendStream[T_contra]):
+    _state: MemoryObjectStreamState[T_contra]
+    _closed: bool = field(init=False, default=False)
+
+    def __post_init__(self) -> None:
+        self._state.open_send_channels += 1
+
+    def send_nowait(self, item: T_contra) -> None:
+        """
+        Send an item immediately if it can be done without waiting.
+
+        :param item: the item to send
+        :raises ~anyio.ClosedResourceError: if this send stream has been closed
+        :raises ~anyio.BrokenResourceError: if the stream has been closed from the
+            receiving end
+        :raises ~anyio.WouldBlock: if the buffer is full and there are no tasks waiting
+            to receive
+
+        """
+        if self._closed:
+            raise ClosedResourceError
+        if not self._state.open_receive_channels:
+            raise BrokenResourceError
+
+        if self._state.waiting_receivers:
+            receive_event, container = self._state.waiting_receivers.popitem(last=False)
+            container.append(item)
+            receive_event.set()
+        elif len(self._state.buffer) < self._state.max_buffer_size:
+            self._state.buffer.append(item)
+        else:
+            raise WouldBlock
+
+    async def send(self, item: T_contra) -> None:
+        """
+        Send an item to the stream.
+
+        If the buffer is full, this method blocks until there is again room in the
+        buffer or the item can be sent directly to a receiver.
+
+        :param item: the item to send
+        :raises ~anyio.ClosedResourceError: if this send stream has been closed
+        :raises ~anyio.BrokenResourceError: if the stream has been closed from the
+            receiving end
+
+        """
+        await checkpoint()
+        try:
+            self.send_nowait(item)
+        except WouldBlock:
+            # Wait until there's someone on the receiving end
+            send_event = Event()
+            self._state.waiting_senders[send_event] = item
+            try:
+                await send_event.wait()
+            except BaseException:
+                self._state.waiting_senders.pop(send_event, None)
+                raise
+
+            if self._state.waiting_senders.pop(send_event, None):
+                raise BrokenResourceError from None
+
+    def clone(self) -> MemoryObjectSendStream[T_contra]:
+        """
+        Create a clone of this send stream.
+
+        Each clone can be closed separately. Only when all clones have been closed will
+        the sending end of the memory stream be considered closed by the receiving ends.
+
+        :return: the cloned stream
+
+        """
+        if self._closed:
+            raise ClosedResourceError
+
+        return MemoryObjectSendStream(_state=self._state)
+
+    def close(self) -> None:
+        """
+        Close the stream.
+
+        This works the exact same way as :meth:`aclose`, but is provided as a special
+        case for the benefit of synchronous callbacks.
+
+        """
+        if not self._closed:
+            self._closed = True
+            self._state.open_send_channels -= 1
+            if self._state.open_send_channels == 0:
+                receive_events = list(self._state.waiting_receivers.keys())
+                self._state.waiting_receivers.clear()
+                for event in receive_events:
+                    event.set()
+
+    async def aclose(self) -> None:
+        self.close()
+
+    def statistics(self) -> MemoryObjectStreamStatistics:
+        """
+        Return statistics about the current state of this stream.
+
+        .. versionadded:: 3.0
+        """
+        return self._state.statistics()
+
+    def __enter__(self) -> MemoryObjectSendStream[T_contra]:
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> None:
+        self.close()
diff --git a/llm/Lib/site-packages/anyio/streams/stapled.py b/llm/Lib/site-packages/anyio/streams/stapled.py
new file mode 100644
index 0000000000000000000000000000000000000000..80f64a2e8e5763ae327c5c213ec12e24f023b4d3
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/streams/stapled.py
@@ -0,0 +1,141 @@
+from __future__ import annotations
+
+from collections.abc import Callable, Mapping, Sequence
+from dataclasses import dataclass
+from typing import Any, Generic, TypeVar
+
+from ..abc import (
+    ByteReceiveStream,
+    ByteSendStream,
+    ByteStream,
+    Listener,
+    ObjectReceiveStream,
+    ObjectSendStream,
+    ObjectStream,
+    TaskGroup,
+)
+
+T_Item = TypeVar("T_Item")
+T_Stream = TypeVar("T_Stream")
+
+
+@dataclass(eq=False)
+class StapledByteStream(ByteStream):
+    """
+    Combines two byte streams into a single, bidirectional byte stream.
+
+    Extra attributes will be provided from both streams, with the receive stream
+    providing the values in case of a conflict.
+
+    :param ByteSendStream send_stream: the sending byte stream
+    :param ByteReceiveStream receive_stream: the receiving byte stream
+    """
+
+    send_stream: ByteSendStream
+    receive_stream: ByteReceiveStream
+
+    async def receive(self, max_bytes: int = 65536) -> bytes:
+        return await self.receive_stream.receive(max_bytes)
+
+    async def send(self, item: bytes) -> None:
+        await self.send_stream.send(item)
+
+    async def send_eof(self) -> None:
+        await self.send_stream.aclose()
+
+    async def aclose(self) -> None:
+        await self.send_stream.aclose()
+        await self.receive_stream.aclose()
+
+    @property
+    def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]:
+        return {
+            **self.send_stream.extra_attributes,
+            **self.receive_stream.extra_attributes,
+        }
+
+
+@dataclass(eq=False)
+class StapledObjectStream(Generic[T_Item], ObjectStream[T_Item]):
+    """
+    Combines two object streams into a single, bidirectional object stream.
+
+    Extra attributes will be provided from both streams, with the receive stream
+    providing the values in case of a conflict.
+
+    :param ObjectSendStream send_stream: the sending object stream
+    :param ObjectReceiveStream receive_stream: the receiving object stream
+    """
+
+    send_stream: ObjectSendStream[T_Item]
+    receive_stream: ObjectReceiveStream[T_Item]
+
+    async def receive(self) -> T_Item:
+        return await self.receive_stream.receive()
+
+    async def send(self, item: T_Item) -> None:
+        await self.send_stream.send(item)
+
+    async def send_eof(self) -> None:
+        await self.send_stream.aclose()
+
+    async def aclose(self) -> None:
+        await self.send_stream.aclose()
+        await self.receive_stream.aclose()
+
+    @property
+    def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]:
+        return {
+            **self.send_stream.extra_attributes,
+            **self.receive_stream.extra_attributes,
+        }
+
+
+@dataclass(eq=False)
+class MultiListener(Generic[T_Stream], Listener[T_Stream]):
+    """
+    Combines multiple listeners into one, serving connections from all of them at once.
+
+    Any MultiListeners in the given collection of listeners will have their listeners
+    moved into this one.
+
+    Extra attributes are provided from each listener, with each successive listener
+    overriding any conflicting attributes from the previous one.
+
+    :param listeners: listeners to serve
+    :type listeners: Sequence[Listener[T_Stream]]
+    """
+
+    listeners: Sequence[Listener[T_Stream]]
+
+    def __post_init__(self) -> None:
+        listeners: list[Listener[T_Stream]] = []
+        for listener in self.listeners:
+            if isinstance(listener, MultiListener):
+                listeners.extend(listener.listeners)
+                del listener.listeners[:]  # type: ignore[attr-defined]
+            else:
+                listeners.append(listener)
+
+        self.listeners = listeners
+
+    async def serve(
+        self, handler: Callable[[T_Stream], Any], task_group: TaskGroup | None = None
+    ) -> None:
+        from .. import create_task_group
+
+        async with create_task_group() as tg:
+            for listener in self.listeners:
+                tg.start_soon(listener.serve, handler, task_group)
+
+    async def aclose(self) -> None:
+        for listener in self.listeners:
+            await listener.aclose()
+
+    @property
+    def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]:
+        attributes: dict = {}
+        for listener in self.listeners:
+            attributes.update(listener.extra_attributes)
+
+        return attributes
diff --git a/llm/Lib/site-packages/anyio/streams/text.py b/llm/Lib/site-packages/anyio/streams/text.py
new file mode 100644
index 0000000000000000000000000000000000000000..f1a11278e3ddfa6aed3fc0c731084c6b22d89e0d
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/streams/text.py
@@ -0,0 +1,147 @@
+from __future__ import annotations
+
+import codecs
+from collections.abc import Callable, Mapping
+from dataclasses import InitVar, dataclass, field
+from typing import Any
+
+from ..abc import (
+    AnyByteReceiveStream,
+    AnyByteSendStream,
+    AnyByteStream,
+    ObjectReceiveStream,
+    ObjectSendStream,
+    ObjectStream,
+)
+
+
+@dataclass(eq=False)
+class TextReceiveStream(ObjectReceiveStream[str]):
+    """
+    Stream wrapper that decodes bytes to strings using the given encoding.
+
+    Decoding is done using :class:`~codecs.IncrementalDecoder` which returns any
+    completely received unicode characters as soon as they come in.
+
+    :param transport_stream: any bytes-based receive stream
+    :param encoding: character encoding to use for decoding bytes to strings (defaults
+        to ``utf-8``)
+    :param errors: handling scheme for decoding errors (defaults to ``strict``; see the
+        `codecs module documentation`_ for a comprehensive list of options)
+
+    .. _codecs module documentation:
+        https://docs.python.org/3/library/codecs.html#codec-objects
+    """
+
+    transport_stream: AnyByteReceiveStream
+    encoding: InitVar[str] = "utf-8"
+    errors: InitVar[str] = "strict"
+    _decoder: codecs.IncrementalDecoder = field(init=False)
+
+    def __post_init__(self, encoding: str, errors: str) -> None:
+        decoder_class = codecs.getincrementaldecoder(encoding)
+        self._decoder = decoder_class(errors=errors)
+
+    async def receive(self) -> str:
+        while True:
+            chunk = await self.transport_stream.receive()
+            decoded = self._decoder.decode(chunk)
+            if decoded:
+                return decoded
+
+    async def aclose(self) -> None:
+        await self.transport_stream.aclose()
+        self._decoder.reset()
+
+    @property
+    def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]:
+        return self.transport_stream.extra_attributes
+
+
+@dataclass(eq=False)
+class TextSendStream(ObjectSendStream[str]):
+    """
+    Sends strings to the wrapped stream as bytes using the given encoding.
+
+    :param AnyByteSendStream transport_stream: any bytes-based send stream
+    :param str encoding: character encoding to use for encoding strings to bytes
+        (defaults to ``utf-8``)
+    :param str errors: handling scheme for encoding errors (defaults to ``strict``; see
+        the `codecs module documentation`_ for a comprehensive list of options)
+
+    .. _codecs module documentation:
+        https://docs.python.org/3/library/codecs.html#codec-objects
+    """
+
+    transport_stream: AnyByteSendStream
+    encoding: InitVar[str] = "utf-8"
+    errors: str = "strict"
+    _encoder: Callable[..., tuple[bytes, int]] = field(init=False)
+
+    def __post_init__(self, encoding: str) -> None:
+        self._encoder = codecs.getencoder(encoding)
+
+    async def send(self, item: str) -> None:
+        encoded = self._encoder(item, self.errors)[0]
+        await self.transport_stream.send(encoded)
+
+    async def aclose(self) -> None:
+        await self.transport_stream.aclose()
+
+    @property
+    def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]:
+        return self.transport_stream.extra_attributes
+
+
+@dataclass(eq=False)
+class TextStream(ObjectStream[str]):
+    """
+    A bidirectional stream that decodes bytes to strings on receive and encodes strings
+    to bytes on send.
+
+    Extra attributes will be provided from both streams, with the receive stream
+    providing the values in case of a conflict.
+
+    :param AnyByteStream transport_stream: any bytes-based stream
+    :param str encoding: character encoding to use for encoding/decoding strings to/from
+        bytes (defaults to ``utf-8``)
+    :param str errors: handling scheme for encoding errors (defaults to ``strict``; see
+        the `codecs module documentation`_ for a comprehensive list of options)
+
+    .. _codecs module documentation:
+        https://docs.python.org/3/library/codecs.html#codec-objects
+    """
+
+    transport_stream: AnyByteStream
+    encoding: InitVar[str] = "utf-8"
+    errors: InitVar[str] = "strict"
+    _receive_stream: TextReceiveStream = field(init=False)
+    _send_stream: TextSendStream = field(init=False)
+
+    def __post_init__(self, encoding: str, errors: str) -> None:
+        self._receive_stream = TextReceiveStream(
+            self.transport_stream, encoding=encoding, errors=errors
+        )
+        self._send_stream = TextSendStream(
+            self.transport_stream, encoding=encoding, errors=errors
+        )
+
+    async def receive(self) -> str:
+        return await self._receive_stream.receive()
+
+    async def send(self, item: str) -> None:
+        await self._send_stream.send(item)
+
+    async def send_eof(self) -> None:
+        await self.transport_stream.send_eof()
+
+    async def aclose(self) -> None:
+        await self._send_stream.aclose()
+        await self._receive_stream.aclose()
+
+    @property
+    def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]:
+        return {
+            **self._send_stream.extra_attributes,
+            **self._receive_stream.extra_attributes,
+        }
diff --git a/llm/Lib/site-packages/anyio/streams/tls.py b/llm/Lib/site-packages/anyio/streams/tls.py
new file mode 100644
index 0000000000000000000000000000000000000000..e913eedbbf3e0d4265964c5400bdd2c9d917acc5
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/streams/tls.py
@@ -0,0 +1,338 @@
+from __future__ import annotations
+
+import logging
+import re
+import ssl
+import sys
+from collections.abc import Callable, Mapping
+from dataclasses import dataclass
+from functools import wraps
+from typing import Any, Tuple, TypeVar
+
+from .. import (
+    BrokenResourceError,
+    EndOfStream,
+    aclose_forcefully,
+    get_cancelled_exc_class,
+)
+from .._core._typedattr import TypedAttributeSet, typed_attribute
+from ..abc import AnyByteStream, ByteStream, Listener, TaskGroup
+
+if sys.version_info >= (3, 11):
+    from typing import TypeVarTuple, Unpack
+else:
+    from typing_extensions import TypeVarTuple, Unpack
+
+T_Retval = TypeVar("T_Retval")
+PosArgsT = TypeVarTuple("PosArgsT")
+_PCTRTT = Tuple[Tuple[str, str], ...]
+_PCTRTTT = Tuple[_PCTRTT, ...]
+
+
+class TLSAttribute(TypedAttributeSet):
+    """Contains Transport Layer Security related attributes."""
+
+    #: the selected ALPN protocol
+    alpn_protocol: str | None = typed_attribute()
+    #: the channel binding for type ``tls-unique``
+    channel_binding_tls_unique: bytes = typed_attribute()
+    #: the selected cipher
+    cipher: tuple[str, str, int] = typed_attribute()
+    #: the peer certificate in dictionary form (see :meth:`ssl.SSLSocket.getpeercert`
+    # for more information)
+    peer_certificate: None | (dict[str, str | _PCTRTTT | _PCTRTT]) = typed_attribute()
+    #: the peer certificate in binary form
+    peer_certificate_binary: bytes | None = typed_attribute()
+    #: ``True`` if this is the server side of the connection
+    server_side: bool = typed_attribute()
+    #: ciphers shared by the client during the TLS handshake (``None`` if this is the
+    #: client side)
+    shared_ciphers: list[tuple[str, str, int]] | None = typed_attribute()
+    #: the :class:`~ssl.SSLObject` used for encryption
+    ssl_object: ssl.SSLObject = typed_attribute()
+    #: ``True`` if this stream does (and expects) a closing TLS handshake when the
+    #: stream is being closed
+    standard_compatible: bool = typed_attribute()
+    #: the TLS protocol version (e.g. ``TLSv1.2``)
+    tls_version: str = typed_attribute()
+
+
+@dataclass(eq=False)
+class TLSStream(ByteStream):
+    """
+    A stream wrapper that encrypts all sent data and decrypts received data.
+
+    This class has no public initializer; use :meth:`wrap` instead.
+    All extra attributes from :class:`~TLSAttribute` are supported.
+
+    :var AnyByteStream transport_stream: the wrapped stream
+
+    """
+
+    transport_stream: AnyByteStream
+    standard_compatible: bool
+    _ssl_object: ssl.SSLObject
+    _read_bio: ssl.MemoryBIO
+    _write_bio: ssl.MemoryBIO
+
+    @classmethod
+    async def wrap(
+        cls,
+        transport_stream: AnyByteStream,
+        *,
+        server_side: bool | None = None,
+        hostname: str | None = None,
+        ssl_context: ssl.SSLContext | None = None,
+        standard_compatible: bool = True,
+    ) -> TLSStream:
+        """
+        Wrap an existing stream with Transport Layer Security.
+
+        This performs a TLS handshake with the peer.
+
+        :param transport_stream: a bytes-transporting stream to wrap
+        :param server_side: ``True`` if this is the server side of the connection,
+            ``False`` if this is the client side (if omitted, will be set to ``False``
+            if ``hostname`` has been provided, ``False`` otherwise). Used only to create
+            a default context when an explicit context has not been provided.
+        :param hostname: host name of the peer (if host name checking is desired)
+        :param ssl_context: the SSLContext object to use (if not provided, a secure
+            default will be created)
+        :param standard_compatible: if ``False``, skip the closing handshake when
+            closing the connection, and don't raise an exception if the peer does the
+            same
+        :raises ~ssl.SSLError: if the TLS handshake fails
+
+        """
+        if server_side is None:
+            server_side = not hostname
+
+        if not ssl_context:
+            purpose = (
+                ssl.Purpose.CLIENT_AUTH if server_side else ssl.Purpose.SERVER_AUTH
+            )
+            ssl_context = ssl.create_default_context(purpose)
+
+            # Re-enable detection of unexpected EOFs if it was disabled by Python
+            if hasattr(ssl, "OP_IGNORE_UNEXPECTED_EOF"):
+                ssl_context.options &= ~ssl.OP_IGNORE_UNEXPECTED_EOF
+
+        bio_in = ssl.MemoryBIO()
+        bio_out = ssl.MemoryBIO()
+        ssl_object = ssl_context.wrap_bio(
+            bio_in, bio_out, server_side=server_side, server_hostname=hostname
+        )
+        wrapper = cls(
+            transport_stream=transport_stream,
+            standard_compatible=standard_compatible,
+            _ssl_object=ssl_object,
+            _read_bio=bio_in,
+            _write_bio=bio_out,
+        )
+        await wrapper._call_sslobject_method(ssl_object.do_handshake)
+        return wrapper
+
+    async def _call_sslobject_method(
+        self, func: Callable[[Unpack[PosArgsT]], T_Retval], *args: Unpack[PosArgsT]
+    ) -> T_Retval:
+        while True:
+            try:
+                result = func(*args)
+            except ssl.SSLWantReadError:
+                try:
+                    # Flush any pending writes first
+                    if self._write_bio.pending:
+                        await self.transport_stream.send(self._write_bio.read())
+
+                    data = await self.transport_stream.receive()
+                except EndOfStream:
+                    self._read_bio.write_eof()
+                except OSError as exc:
+                    self._read_bio.write_eof()
+                    self._write_bio.write_eof()
+                    raise BrokenResourceError from exc
+                else:
+                    self._read_bio.write(data)
+            except ssl.SSLWantWriteError:
+                await self.transport_stream.send(self._write_bio.read())
+            except ssl.SSLSyscallError as exc:
+                self._read_bio.write_eof()
+                self._write_bio.write_eof()
+                raise BrokenResourceError from exc
+            except ssl.SSLError as exc:
+                self._read_bio.write_eof()
+                self._write_bio.write_eof()
+                if (
+                    isinstance(exc, ssl.SSLEOFError)
+                    or "UNEXPECTED_EOF_WHILE_READING" in exc.strerror
+                ):
+                    if self.standard_compatible:
+                        raise BrokenResourceError from exc
+                    else:
+                        raise EndOfStream from None
+
+                raise
+            else:
+                # Flush any pending writes first
+                if self._write_bio.pending:
+                    await self.transport_stream.send(self._write_bio.read())
+
+                return result
+
+    async def unwrap(self) -> tuple[AnyByteStream, bytes]:
+        """
+        Does the TLS closing handshake.
+
+        :return: a tuple of (wrapped byte stream, bytes left in the read buffer)
+
+        """
+        await self._call_sslobject_method(self._ssl_object.unwrap)
+        self._read_bio.write_eof()
+        self._write_bio.write_eof()
+        return self.transport_stream, self._read_bio.read()
+
+    async def aclose(self) -> None:
+        if self.standard_compatible:
+            try:
+                await self.unwrap()
+            except BaseException:
+                await aclose_forcefully(self.transport_stream)
+                raise
+
+        await self.transport_stream.aclose()
+
+    async def receive(self, max_bytes: int = 65536) -> bytes:
+        data = await self._call_sslobject_method(self._ssl_object.read, max_bytes)
+        if not data:
+            raise EndOfStream
+
+        return data
+
+    async def send(self, item: bytes) -> None:
+        await self._call_sslobject_method(self._ssl_object.write, item)
+
+    async def send_eof(self) -> None:
+        tls_version = self.extra(TLSAttribute.tls_version)
+        match = re.match(r"TLSv(\d+)(?:\.(\d+))?", tls_version)
+        if match:
+            major, minor = int(match.group(1)), int(match.group(2) or 0)
+            if (major, minor) < (1, 3):
+                raise NotImplementedError(
+                    f"send_eof() requires at least TLSv1.3; current "
+                    f"session uses {tls_version}"
+                )
+
+        raise NotImplementedError(
+            "send_eof() has not yet been implemented for TLS streams"
+        )
+
+    @property
+    def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]:
+        return {
+            **self.transport_stream.extra_attributes,
+            TLSAttribute.alpn_protocol: self._ssl_object.selected_alpn_protocol,
+            TLSAttribute.channel_binding_tls_unique: (
+                self._ssl_object.get_channel_binding
+            ),
+            TLSAttribute.cipher: self._ssl_object.cipher,
+            TLSAttribute.peer_certificate: lambda: self._ssl_object.getpeercert(False),
+            TLSAttribute.peer_certificate_binary: lambda: self._ssl_object.getpeercert(
+                True
+            ),
+            TLSAttribute.server_side: lambda: self._ssl_object.server_side,
+            TLSAttribute.shared_ciphers: lambda: self._ssl_object.shared_ciphers()
+            if self._ssl_object.server_side
+            else None,
+            TLSAttribute.standard_compatible: lambda: self.standard_compatible,
+            TLSAttribute.ssl_object: lambda: self._ssl_object,
+            TLSAttribute.tls_version: self._ssl_object.version,
+        }
+
+
+@dataclass(eq=False)
+class TLSListener(Listener[TLSStream]):
+    """
+    A convenience listener that wraps another listener and auto-negotiates a TLS session
+    on every accepted connection.
+
+    If the TLS handshake times out or raises an exception,
+    :meth:`handle_handshake_error` is called to do whatever post-mortem processing is
+    deemed necessary.
+
+    Supports only the :attr:`~TLSAttribute.standard_compatible` extra attribute.
+
+    :param Listener listener: the listener to wrap
+    :param ssl_context: the SSL context object
+    :param standard_compatible: a flag passed through to :meth:`TLSStream.wrap`
+    :param handshake_timeout: time limit for the TLS handshake
+        (passed to :func:`~anyio.fail_after`)
+    """
+
+    listener: Listener[Any]
+    ssl_context: ssl.SSLContext
+    standard_compatible: bool = True
+    handshake_timeout: float = 30
+
+    @staticmethod
+    async def handle_handshake_error(exc: BaseException, stream: AnyByteStream) -> None:
+        """
+        Handle an exception raised during the TLS handshake.
+
+        This method does 3 things:
+
+        #. Forcefully closes the original stream
+        #. Logs the exception (unless it was a cancellation exception) using the
+           ``anyio.streams.tls`` logger
+        #. Reraises the exception if it was a base exception or a cancellation exception
+
+        :param exc: the exception
+        :param stream: the original stream
+
+        """
+        await aclose_forcefully(stream)
+
+        # Log all except cancellation exceptions
+        if not isinstance(exc, get_cancelled_exc_class()):
+            # CPython (as of 3.11.5) returns incorrect `sys.exc_info()` here when using
+            # any asyncio implementation, so we explicitly pass the exception to log
+            # (https://github.com/python/cpython/issues/108668). Trio does not have this
+            # issue because it works around the CPython bug.
+            logging.getLogger(__name__).exception(
+                "Error during TLS handshake", exc_info=exc
+            )
+
+        # Only reraise base exceptions and cancellation exceptions
+        if not isinstance(exc, Exception) or isinstance(exc, get_cancelled_exc_class()):
+            raise
+
+    async def serve(
+        self,
+        handler: Callable[[TLSStream], Any],
+        task_group: TaskGroup | None = None,
+    ) -> None:
+        @wraps(handler)
+        async def handler_wrapper(stream: AnyByteStream) -> None:
+            from .. import fail_after
+
+            try:
+                with fail_after(self.handshake_timeout):
+                    wrapped_stream = await TLSStream.wrap(
+                        stream,
+                        ssl_context=self.ssl_context,
+                        standard_compatible=self.standard_compatible,
+                    )
+            except BaseException as exc:
+                await self.handle_handshake_error(exc, stream)
+            else:
+                await handler(wrapped_stream)
+
+        await self.listener.serve(handler_wrapper, task_group)
+
+    async def aclose(self) -> None:
+        await self.listener.aclose()
+
+    @property
+    def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]:
+        return {
+            TLSAttribute.standard_compatible: lambda: self.standard_compatible,
+        }
diff --git a/llm/Lib/site-packages/anyio/to_process.py b/llm/Lib/site-packages/anyio/to_process.py
new file mode 100644
index 0000000000000000000000000000000000000000..1ff06f0b259b1fe4b118299cf30478233c2f01ae
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/to_process.py
@@ -0,0 +1,259 @@
+from __future__ import annotations
+
+import os
+import pickle
+import subprocess
+import sys
+from collections import deque
+from collections.abc import Callable
+from importlib.util import module_from_spec, spec_from_file_location
+from typing import TypeVar, cast
+
+from ._core._eventloop import current_time, get_async_backend, get_cancelled_exc_class
+from ._core._exceptions import BrokenWorkerProcess
+from ._core._subprocesses import open_process
+from ._core._synchronization import CapacityLimiter
+from ._core._tasks import CancelScope, fail_after
+from .abc import ByteReceiveStream, ByteSendStream, Process
+from .lowlevel import RunVar, checkpoint_if_cancelled
+from .streams.buffered import BufferedByteReceiveStream
+
+if sys.version_info >= (3, 11):
+    from typing import TypeVarTuple, Unpack
+else:
+    from typing_extensions import TypeVarTuple, Unpack
+
+WORKER_MAX_IDLE_TIME = 300  # 5 minutes
+
+T_Retval = TypeVar("T_Retval")
+PosArgsT = TypeVarTuple("PosArgsT")
+
+_process_pool_workers: RunVar[set[Process]] = RunVar("_process_pool_workers")
+_process_pool_idle_workers: RunVar[deque[tuple[Process, float]]] = RunVar(
+    "_process_pool_idle_workers"
+)
+_default_process_limiter: RunVar[CapacityLimiter] = RunVar("_default_process_limiter")
+
+
+async def run_sync(
+    func: Callable[[Unpack[PosArgsT]], T_Retval],
+    *args: Unpack[PosArgsT],
+    cancellable: bool = False,
+    limiter: CapacityLimiter | None = None,
+) -> T_Retval:
+    """
+    Call the given function with the given arguments in a worker process.
+
+    If the ``cancellable`` option is enabled and the task waiting for its completion is
+    cancelled, the worker process running it will be abruptly terminated using SIGKILL
+    (or ``terminateProcess()`` on Windows).
+
+    :param func: a callable
+    :param args: positional arguments for the callable
+    :param cancellable: ``True`` to allow cancellation of the operation while it's
+        running
+    :param limiter: capacity limiter to use to limit the total amount of processes
+        running (if omitted, the default limiter is used)
+    :return: an awaitable that yields the return value of the function.
+
+    """
+
+    async def send_raw_command(pickled_cmd: bytes) -> object:
+        try:
+            await stdin.send(pickled_cmd)
+            response = await buffered.receive_until(b"\n", 50)
+            status, length = response.split(b" ")
+            if status not in (b"RETURN", b"EXCEPTION"):
+                raise RuntimeError(
+                    f"Worker process returned unexpected response: {response!r}"
+                )
+
+            pickled_response = await buffered.receive_exactly(int(length))
+        except BaseException as exc:
+            workers.discard(process)
+            try:
+                process.kill()
+                with CancelScope(shield=True):
+                    await process.aclose()
+            except ProcessLookupError:
+                pass
+
+            if isinstance(exc, get_cancelled_exc_class()):
+                raise
+            else:
+                raise BrokenWorkerProcess from exc
+
+        retval = pickle.loads(pickled_response)
+        if status == b"EXCEPTION":
+            assert isinstance(retval, BaseException)
+            raise retval
+        else:
+            return retval
+
+    # First pickle the request before trying to reserve a worker process
+    await checkpoint_if_cancelled()
+    request = pickle.dumps(("run", func, args), protocol=pickle.HIGHEST_PROTOCOL)
+
+    # If this is the first run in this event loop thread, set up the necessary variables
+    try:
+        workers = _process_pool_workers.get()
+        idle_workers = _process_pool_idle_workers.get()
+    except LookupError:
+        workers = set()
+        idle_workers = deque()
+        _process_pool_workers.set(workers)
+        _process_pool_idle_workers.set(idle_workers)
+        get_async_backend().setup_process_pool_exit_at_shutdown(workers)
+
+    async with limiter or current_default_process_limiter():
+        # Pop processes from the pool (starting from the most recently used) until we
+        # find one that hasn't exited yet
+        process: Process
+        while idle_workers:
+            process, idle_since = idle_workers.pop()
+            if process.returncode is None:
+                stdin = cast(ByteSendStream, process.stdin)
+                buffered = BufferedByteReceiveStream(
+                    cast(ByteReceiveStream, process.stdout)
+                )
+
+                # Prune any other workers that have been idle for WORKER_MAX_IDLE_TIME
+                # seconds or longer
+                now = current_time()
+                killed_processes: list[Process] = []
+                while idle_workers:
+                    if now - idle_workers[0][1] < WORKER_MAX_IDLE_TIME:
+                        break
+
+                    process_to_kill, idle_since = idle_workers.popleft()
+                    process_to_kill.kill()
+                    workers.remove(process_to_kill)
+                    killed_processes.append(process_to_kill)
+
+                with CancelScope(shield=True):
+                    for killed_process in killed_processes:
+                        await killed_process.aclose()
+
+                break
+
+            workers.remove(process)
+        else:
+            command = [sys.executable, "-u", "-m", __name__]
+            process = await open_process(
+                command, stdin=subprocess.PIPE, stdout=subprocess.PIPE
+            )
+            try:
+                stdin = cast(ByteSendStream, process.stdin)
+                buffered = BufferedByteReceiveStream(
+                    cast(ByteReceiveStream, process.stdout)
+                )
+                with fail_after(20):
+                    message = await buffered.receive(6)
+
+                if message != b"READY\n":
+                    raise BrokenWorkerProcess(
+                        f"Worker process returned unexpected response: {message!r}"
+                    )
+
+                main_module_path = getattr(sys.modules["__main__"], "__file__", None)
+                pickled = pickle.dumps(
+                    ("init", sys.path, main_module_path),
+                    protocol=pickle.HIGHEST_PROTOCOL,
+                )
+                await send_raw_command(pickled)
+            except (BrokenWorkerProcess, get_cancelled_exc_class()):
+                raise
+            except BaseException as exc:
+                process.kill()
+                raise BrokenWorkerProcess(
+                    "Error during worker process initialization"
+                ) from exc
+
+            workers.add(process)
+
+        with CancelScope(shield=not cancellable):
+            try:
+                return cast(T_Retval, await send_raw_command(request))
+            finally:
+                if process in workers:
+                    idle_workers.append((process, current_time()))
+
+
+def current_default_process_limiter() -> CapacityLimiter:
+    """
+    Return the capacity limiter that is used by default to limit the number of worker
+    processes.
+
+    :return: a capacity limiter object
+
+    """
+    try:
+        return _default_process_limiter.get()
+    except LookupError:
+        limiter = CapacityLimiter(os.cpu_count() or 2)
+        _default_process_limiter.set(limiter)
+        return limiter
+
+
+def process_worker() -> None:
+    # Redirect standard streams to os.devnull so that user code won't interfere with the
+    # parent-worker communication
+    stdin = sys.stdin
+    stdout = sys.stdout
+    sys.stdin = open(os.devnull)
+    sys.stdout = open(os.devnull, "w")
+
+    stdout.buffer.write(b"READY\n")
+    while True:
+        retval = exception = None
+        try:
+            command, *args = pickle.load(stdin.buffer)
+        except EOFError:
+            return
+        except BaseException as exc:
+            exception = exc
+        else:
+            if command == "run":
+                func, args = args
+                try:
+                    retval = func(*args)
+                except BaseException as exc:
+                    exception = exc
+            elif command == "init":
+                main_module_path: str | None
+                sys.path, main_module_path = args
+                del sys.modules["__main__"]
+                if main_module_path:
+                    # Load the parent's main module but as __mp_main__ instead of
+                    # __main__ (like multiprocessing does) to avoid infinite recursion
+                    try:
+                        spec = spec_from_file_location("__mp_main__", main_module_path)
+                        if spec and spec.loader:
+                            main = module_from_spec(spec)
+                            spec.loader.exec_module(main)
+                            sys.modules["__main__"] = main
+                    except BaseException as exc:
+                        exception = exc
+
+        try:
+            if exception is not None:
+                status = b"EXCEPTION"
+                pickled = pickle.dumps(exception, pickle.HIGHEST_PROTOCOL)
+            else:
+                status = b"RETURN"
+                pickled = pickle.dumps(retval, pickle.HIGHEST_PROTOCOL)
+        except BaseException as exc:
+            exception = exc
+            status = b"EXCEPTION"
+            pickled = pickle.dumps(exc, pickle.HIGHEST_PROTOCOL)
+
+        stdout.buffer.write(b"%s %d\n" % (status, len(pickled)))
+        stdout.buffer.write(pickled)
+
+        # Respect SIGTERM
+        if isinstance(exception, SystemExit):
+            raise exception
+
+
+if __name__ == "__main__":
+    process_worker()
diff --git a/llm/Lib/site-packages/anyio/to_thread.py b/llm/Lib/site-packages/anyio/to_thread.py
new file mode 100644
index 0000000000000000000000000000000000000000..5070516eb56679f863bd446c97cf76376d80d83b
--- /dev/null
+++ b/llm/Lib/site-packages/anyio/to_thread.py
@@ -0,0 +1,69 @@
+from __future__ import annotations
+
+import sys
+from collections.abc import Callable
+from typing import TypeVar
+from warnings import warn
+
+from ._core._eventloop import get_async_backend
+from .abc import CapacityLimiter
+
+if sys.version_info >= (3, 11):
+    from typing import TypeVarTuple, Unpack
+else:
+    from typing_extensions import TypeVarTuple, Unpack
+
+T_Retval = TypeVar("T_Retval")
+PosArgsT = TypeVarTuple("PosArgsT")
+
+
+async def run_sync(
+    func: Callable[[Unpack[PosArgsT]], T_Retval],
+    *args: Unpack[PosArgsT],
+    abandon_on_cancel: bool = False,
+    cancellable: bool | None = None,
+    limiter: CapacityLimiter | None = None,
+) -> T_Retval:
+    """
+    Call the given function with the given arguments in a worker thread.
+
+    If the ``cancellable`` option is enabled and the task waiting for its completion is
+    cancelled, the thread will still run its course but its return value (or any raised
+    exception) will be ignored.
+
+    :param func: a callable
+    :param args: positional arguments for the callable
+    :param abandon_on_cancel: ``True`` to abandon the thread (leaving it to run
+        unchecked on own) if the host task is cancelled, ``False`` to ignore
+        cancellations in the host task until the operation has completed in the worker
+        thread
+    :param cancellable: deprecated alias of ``abandon_on_cancel``; will override
+        ``abandon_on_cancel`` if both parameters are passed
+    :param limiter: capacity limiter to use to limit the total amount of threads running
+        (if omitted, the default limiter is used)
+    :return: an awaitable that yields the return value of the function.
+
+    """
+    if cancellable is not None:
+        abandon_on_cancel = cancellable
+        warn(
+            "The `cancellable=` keyword argument to `anyio.to_thread.run_sync` is "
+            "deprecated since AnyIO 4.1.0; use `abandon_on_cancel=` instead",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+
+    return await get_async_backend().run_sync_in_worker_thread(
+        func, args, abandon_on_cancel=abandon_on_cancel, limiter=limiter
+    )
+
+
+def current_default_thread_limiter() -> CapacityLimiter:
+    """
+    Return the capacity limiter that is used by default to limit the number of
+    concurrent threads.
+
+    :return: a capacity limiter object
+
+    """
+    return get_async_backend().current_default_thread_limiter()
diff --git a/llm/Lib/site-packages/astrapy-1.1.0.dist-info/INSTALLER b/llm/Lib/site-packages/astrapy-1.1.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy-1.1.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/astrapy-1.1.0.dist-info/LICENSE.md b/llm/Lib/site-packages/astrapy-1.1.0.dist-info/LICENSE.md
new file mode 100644
index 0000000000000000000000000000000000000000..261eeb9e9f8b2b4b0d119366dda99c6fd7d35c64
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy-1.1.0.dist-info/LICENSE.md
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/llm/Lib/site-packages/astrapy-1.1.0.dist-info/METADATA b/llm/Lib/site-packages/astrapy-1.1.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..aff02c6b17ceeac5917748fb3c86ec52d04414b9
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy-1.1.0.dist-info/METADATA
@@ -0,0 +1,447 @@
+Metadata-Version: 2.1
+Name: astrapy
+Version: 1.1.0
+Summary: AstraPy is a Pythonic SDK for DataStax Astra and its Data API
+Home-page: https://github.com/datastax/astrapy
+License: Apache-2.0
+Keywords: DataStax,Astra
+Author: Stefano Lottini
+Author-email: stefano.lottini@datastax.com
+Requires-Python: >=3.8.0,<4.0.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Dist: bson (>=0.5.10,<0.6.0)
+Requires-Dist: cassio (>=0.1.4,<0.2.0)
+Requires-Dist: deprecation (>=2.1.0,<2.2.0)
+Requires-Dist: httpx[http2] (>=0.25.2,<1)
+Requires-Dist: toml (>=0.10.2,<0.11.0)
+Requires-Dist: uuid6 (>=2024.1.12,<2024.2.0)
+Project-URL: Repository, https://github.com/datastax/astrapy
+Description-Content-Type: text/markdown
+
+# AstraPy
+
+A pythonic client for [DataStax Astra DB](https://astra.datastax.com).
+
+_This README targets AstraPy version **1.0.0+**, which introduces a whole new API.
+Click [here](https://github.com/datastax/astrapy/blob/cd3f5ce8146093e10a095709c0f5c3f8e3f2c7da/README.md) for the pre-existing API (fully compatible with newer versions)._
+
+
+## Quickstart
+
+Install with `pip install astrapy`.
+
+Get the *API Endpoint* and the *Token* to your Astra DB instance at [astra.datastax.com](https://astra.datastax.com).
+
+Try the following code after replacing the connection parameters:
+
+```python
+import astrapy
+
+
+my_client = astrapy.DataAPIClient("AstraCS:...")
+my_database = my_client.get_database_by_api_endpoint(
+   "https://01234567-....apps.astra.datastax.com"
+)
+
+my_collection = my_database.create_collection(
+    "dreams",
+    dimension=3,
+    metric=astrapy.constants.VectorMetric.COSINE,
+)
+
+my_collection.insert_one({"summary": "I was flying"}, vector=[-0.4, 0.7, 0])
+
+my_collection.insert_many(
+    [
+        {
+            "_id": astrapy.ids.UUID("018e65c9-e33d-749b-9386-e848739582f0"),
+            "summary": "A dinner on the Moon",
+        },
+        {"summary": "Riding the waves", "tags": ["sport"]},
+        {"summary": "Friendly aliens in town", "tags": ["scifi"]},
+        {"summary": "Meeting Beethoven at the dentist"},
+    ],
+    vectors=[
+        [0.2, -0.3, -0.5],
+        [0, 0.2, 1],
+        [-0.3, 0, 0.8],
+        [0.2, 0.6, 0],
+    ],
+)
+
+my_collection.update_one(
+    {"tags": "sport"},
+    {"$set": {"summary": "Surfers' paradise"}},
+)
+
+cursor = my_collection.find(
+    {},
+    vector=[0, 0.2, 0.4],
+    limit=2,
+    include_similarity=True,
+)
+
+for result in cursor:
+    print(f"{result['summary']}: {result['$similarity']}")
+
+# This would print:
+#   Surfers' paradise: 0.98238194
+#   Friendly aliens in town: 0.91873914
+```
+
+Next steps:
+
+- More info and usage patterns are given in the docstrings of classes and methods
+- [Data API reference](https://docs.datastax.com/en/astra/astra-db-vector/api-reference/overview.html)
+- [AstraPy reference](https://docs.datastax.com/en/astra/astra-db-vector/api-reference/dataapiclient.html)
+- Package on [PyPI](https://pypi.org/project/astrapy/)
+
+## AstraPy's API
+
+### Abstraction diagram
+
+AstraPy's abstractions for working at the data and admin layers are structured
+as depicted by this diagram:
+
+![AstraPy, abstractions chart](https://raw.githubusercontent.com/datastax/astrapy/master/pictures/astrapy_abstractions.png)
+
+Here's a small admin-oriented example:
+
+```python
+import astrapy
+
+my_client = astrapy.DataAPIClient("AstraCS:...")
+
+my_astra_admin = my_client.get_admin()
+
+database_list = list(my_astra_admin.list_databases())
+
+db_info = database_list[0].info
+print(db_info.name, db_info.id, db_info.region)
+
+my_database_admin = my_astra_admin.get_database_admin(db_info.id)
+
+my_database_admin.list_namespaces()
+my_database_admin.create_namespace("my_dreamspace")
+```
+
+### Exceptions
+
+The package comes with its own set of exceptions, arranged in this hierarchy:
+
+![AstraPy, exception hierarchy](https://raw.githubusercontent.com/datastax/astrapy/master/pictures/astrapy_exceptions.png)
+
+For more information, and code examples, check out the docstrings and consult
+the API reference linked above.
+
+### Working with dates
+
+Date and datetime objects, i.e. instances of the standard library
+`datetime.datetime` and `datetime.date` classes, can be used anywhere in documents:
+
+```python
+import datetime
+import astrapy
+
+my_client = astrapy.DataAPIClient("AstraCS:...")
+my_database = my_client.get_database_by_api_endpoint(
+   "https://01234567-....apps.astra.datastax.com"
+)
+my_collection = my_database.dreams
+
+my_collection.insert_one({"when": datetime.datetime.now()})
+my_collection.insert_one({"date_of_birth": datetime.date(2000, 1, 1)})
+
+my_collection.update_one(
+    {"registered_at": datetime.date(1999, 11, 14)},
+    {"$set": {"message": "happy Sunday!"}},
+)
+
+print(
+    my_collection.find_one(
+        {"date_of_birth": {"$lt": datetime.date(2001, 1, 1)}},
+        projection={"_id": False},
+    )
+)
+# This would print:
+#    {'date_of_birth': datetime.datetime(2000, 1, 1, 0, 0)}
+```
+
+_**Note**: reads from a collection will always_
+_return the `datetime` class regardless of wheter a `date` or a `datetime` was provided_
+_in the insertion._
+
+### Working with ObjectIds and UUIDs
+
+Astrapy repackages the ObjectId from `bson` and the UUID class and utilities
+from the `uuid` package and its `uuidv6` extension. You can also use them directly.
+
+Even when setting a default ID type for a collection, you still retain the freedom
+to use any ID type for any document:
+
+```python
+import astrapy
+import bson
+
+my_collection = my_database.create_collection(
+    "ecommerce",
+    default_id_type=astrapy.constants.DefaultIdType.UUIDV6,
+)
+
+my_collection.insert_one({"_id": astrapy.ids.ObjectId("65fd9b52d7fabba03349d013")})
+my_collection.find({
+    "_id": astrapy.ids.UUID("018e65c9-e33d-749b-9386-e848739582f0"),
+})
+
+my_collection.update_one(
+    {"tag": "in_stock"},
+    {"$set": {"inventory_id": bson.objectid.ObjectId()}},
+    upsert=True,
+)
+
+my_collection.insert_one({"_id": astrapy.ids.uuid8()})
+```
+
+## For contributors
+
+First install poetry with `pip install poetry` and then the project dependencies with `poetry install --with dev`.
+
+Linter, style and typecheck should all pass for a PR:
+
+```bash
+poetry run black --check astrapy && poetry run ruff astrapy && poetry run mypy astrapy
+
+poetry run black --check tests && poetry run ruff tests && poetry run mypy tests
+```
+
+Features must be thoroughly covered in tests (see `tests/idiomatic/*` for
+naming convention and module structure).
+
+### Running tests
+
+"Full regular" testing requires environment variables:
+
+```bash
+export ASTRA_DB_APPLICATION_TOKEN="AstraCS:..."
+export ASTRA_DB_API_ENDPOINT="https://.......apps.astra.datastax.com"
+
+export ASTRA_DB_KEYSPACE="default_keyspace"
+# Optional:
+export ASTRA_DB_SECONDARY_KEYSPACE="..."
+```
+
+Tests can be started in various ways:
+
+```bash
+# test the "idiomatic" layer
+poetry run pytest tests/idiomatic
+poetry run pytest tests/idiomatic/unit
+poetry run pytest tests/idiomatic/integration
+
+# remove logging noise:
+poetry run pytest [...] -o log_cli=0
+```
+
+The above runs the regular testing (i.e. non-Admin, non-core).
+The (idiomatic) Admin part is tested manually by you, on Astra accounts with room
+for up to 3 new databases, possibly both on prod and dev, and uses specific env vars,
+as can be seen on `tests/idiomatic/integration/test_admin.py`.
+
+Should you be interested in testing the "core" modules, moreover,
+this is also something for you to run manually (do that if you touch "core"):
+
+```bash
+# test the core modules
+poetry run pytest tests/core
+
+# do not drop collections:
+TEST_SKIP_COLLECTION_DELETE=1 poetry run pytest [...]
+
+# include astrapy.core.ops testing (tester must clean up after that):
+TEST_ASTRADBOPS=1 poetry run pytest [...]
+```
+
+## Appendices
+
+### Appendix A: quick reference for imports
+
+Client, data and admin abstractions:
+
+```python
+from astrapy import (
+    DataAPIClient,
+    Database,
+    AsyncDatabase,
+    Collection,
+    AsyncCollection,
+    AstraDBAdmin,
+    AstraDBDatabaseAdmin,
+)
+```
+
+Constants for data-related use:
+
+```python
+from astrapy.constants import (
+    ReturnDocument,
+    SortDocuments,
+    VectorMetric,
+    DefaultIdType,
+)
+```
+
+ObjectIds and UUIDs:
+
+```python
+from astrapy.ids import (
+    ObjectId,
+    uuid1,
+    uuid3,
+    uuid4,
+    uuid5,
+    uuid6,
+    uuid7,
+    uuid8,
+    UUID,
+)
+```
+
+Operations (for `bulk_write` collection method):
+
+```python
+from astrapy.operations import (
+    BaseOperation,
+    InsertOne,
+    InsertMany,
+    UpdateOne,
+    UpdateMany,
+    ReplaceOne,
+    DeleteOne,
+    DeleteMany,
+    AsyncBaseOperation,
+    AsyncInsertOne,
+    AsyncInsertMany,
+    AsyncUpdateOne,
+    AsyncUpdateMany,
+    AsyncReplaceOne,
+    AsyncDeleteOne,
+    AsyncDeleteMany,
+)
+```
+
+Result classes:
+
+```python
+from astrapy.results import (
+    OperationResult,
+    DeleteResult,
+    InsertOneResult,
+    InsertManyResult,
+    UpdateResult,
+    BulkWriteResult,
+)
+```
+
+Exceptions:
+
+```python
+from astrapy.exceptions import (
+    DevOpsAPIException,
+    DevOpsAPIResponseException,
+    DevOpsAPIErrorDescriptor,
+    DataAPIErrorDescriptor,
+    DataAPIDetailedErrorDescriptor,
+    DataAPIException,
+    DataAPITimeoutException,
+    CursorIsStartedException,
+    CollectionNotFoundException,
+    CollectionAlreadyExistsException,
+    TooManyDocumentsToCountException,
+    DataAPIFaultyResponseException,
+    DataAPIResponseException,
+    CumulativeOperationException,
+    InsertManyException,
+    DeleteManyException,
+    UpdateManyException,
+    BulkWriteException,
+)
+```
+
+Info/metadata classes:
+
+```python
+from astrapy.info import (
+    AdminDatabaseInfo,
+    DatabaseInfo,
+    CollectionInfo,
+    CollectionVectorServiceOptions,
+    CollectionDefaultIDOptions,
+    CollectionVectorOptions,
+    CollectionOptions,
+    CollectionDescriptor,
+)
+```
+
+Admin-related classes and constants:
+
+```python
+from astrapy.admin import (
+    Environment,
+    ParsedAPIEndpoint,
+)
+```
+
+Cursors:
+
+```python
+from astrapy.cursors import (
+    BaseCursor,
+    Cursor,
+    AsyncCursor,
+    CommandCursor,
+    AsyncCommandCursor,
+)
+```
+
+### Appendix B: compatibility with pre-1.0.0 library
+
+If your code uses the pre-1.0.0 astrapy (i.e. `from astrapy.db import Database, Collection` and so on) you are strongly advised to migrate to the current API.
+
+That being said, there are no known breakings of backward compatibility:
+**legacy code would run with a newest astrapy version just as well.**
+Here is a recap of the minor changes that came _to the old API_ with 1.0.0:
+
+- Added methods to `[Async]AstraDBCollection`: `delete_one_filter`, 
+- Paginated find methods (sync/async) type change from Iterable to Generator
+- Bugfix: handling of the mutable caller identity in copy and convert (sync/async) methods
+- Default value of `sort` is `None` and not `{}` for `find` (sync/async)
+- Introduction of `[Async]AstraDBCollection.chunked_delete_many` method
+- Added `projection` parameter to `find_one_and[replace/update]` (sync/async)
+- Bugfix: projection was silently ignored in `vector_find_one_and_[replace/update]` (sync/async)
+- Added `options` to `update_many` (sync/async)
+- `[Async]AstraDBDatabase.chunked_insert_many` does not intercept generic exceptions anymore, only `APIRequestError`
+- Bugfix: `AsyncAstraDBCollection.async chunked_insert_many` stops at the first error when `ordered=True`
+- Added payload info to `DataAPIException`
+- Added `find_one_and_delete` method (sync/async)
+- Added `skip_error_check` parameter to `delete_many` (sync/async)
+- Timeout support throughout the library
+- Added `sort` to `update_one`, `delete_one` and `delete_one_by_predicate` methods (sync/async)
+- Full support for UUID v1,3,4,5,6,7,8 and ObjectID at the collection data I/O level
+- `AstraDBOps.create_database` raises errors in case of failures
+- `AstraDBOps.create_database`, return type corrected
+- Fixed behaviour and return type of `AstraDBOps.create_keyspace` and `AstraDBOps.terminate_db`
+- Added `AstraDBOps.delete_keyspace` method
+- Method `create_collection` of `AstraDB` relaxes checks on passing `dimensions` for vector collections
+- AstraDBOps core class acquired async methods: `async_get_databases`, `async_get_database`, `async_create_database`, `async_terminate_database`, `async_create_keyspace`, `async_delete_keyspace`
+
+Keep in mind that the pre-1.0.0 library, now dubbed "core", is what the current 1.0.0 API ("idiomatic") builds on.
+
diff --git a/llm/Lib/site-packages/astrapy-1.1.0.dist-info/RECORD b/llm/Lib/site-packages/astrapy-1.1.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..20d493713a2bd3384bc7154e4e747802f89e6344
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy-1.1.0.dist-info/RECORD
@@ -0,0 +1,53 @@
+astrapy-1.1.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+astrapy-1.1.0.dist-info/LICENSE.md,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+astrapy-1.1.0.dist-info/METADATA,sha256=CZnvL722B8xxOBHON9MVQxWbe1Q6A0gemywg728yIaQ,12748
+astrapy-1.1.0.dist-info/RECORD,,
+astrapy-1.1.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+astrapy-1.1.0.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+astrapy/__init__.py,sha256=T0YOy0wjSlE1u_p6ebzFfzjJr7XMu9vlNNdrTbfemHU,2653
+astrapy/__pycache__/__init__.cpython-311.pyc,,
+astrapy/__pycache__/admin.cpython-311.pyc,,
+astrapy/__pycache__/client.cpython-311.pyc,,
+astrapy/__pycache__/collection.cpython-311.pyc,,
+astrapy/__pycache__/constants.cpython-311.pyc,,
+astrapy/__pycache__/cursors.cpython-311.pyc,,
+astrapy/__pycache__/database.cpython-311.pyc,,
+astrapy/__pycache__/exceptions.cpython-311.pyc,,
+astrapy/__pycache__/ids.cpython-311.pyc,,
+astrapy/__pycache__/info.cpython-311.pyc,,
+astrapy/__pycache__/operations.cpython-311.pyc,,
+astrapy/__pycache__/results.cpython-311.pyc,,
+astrapy/admin.py,sha256=Vse3St7KR5oVDUVrP5JnYF6tJ9GgZJn05NRtR22f2mQ,82432
+astrapy/api/__init__.py,sha256=Gs6PhpKGcT6Zj1dRKVDycGxh_7aHrYEHMg7IUj1C__g,727
+astrapy/api/__pycache__/__init__.cpython-311.pyc,,
+astrapy/client.py,sha256=tibWwYRlkPQWqS7KXNNPEctp9MqgdY7S12QkvoQK6eE,17415
+astrapy/collection.py,sha256=6h6KesHpWsskHcIqVYWpb0aKXVMWPnguzYdZ2Z1JF4I,214387
+astrapy/constants.py,sha256=7glZlbOL3gQ2mG8yExX4541PTg0Z55qUuUiqE-YLp_k,3004
+astrapy/core/__init__.py,sha256=ET-QOxoY4m8gDIBmLjCZMcz7-p4SGtWy2rjMdwGO2Q8,569
+astrapy/core/__pycache__/__init__.cpython-311.pyc,,
+astrapy/core/__pycache__/api.cpython-311.pyc,,
+astrapy/core/__pycache__/core_types.cpython-311.pyc,,
+astrapy/core/__pycache__/db.cpython-311.pyc,,
+astrapy/core/__pycache__/defaults.cpython-311.pyc,,
+astrapy/core/__pycache__/ids.cpython-311.pyc,,
+astrapy/core/__pycache__/ops.cpython-311.pyc,,
+astrapy/core/__pycache__/utils.cpython-311.pyc,,
+astrapy/core/api.py,sha256=ZBBrmumFj3wo3doPKEUfQDrL-FMwTV5J1JrjQ0hqbKw,6136
+astrapy/core/core_types.py,sha256=hu9Jk5vZ0eGz7nubUCe-A-7LYgOQzI6rnar3Vq34UTQ,1692
+astrapy/core/db.py,sha256=Xeq7Ernz9rYLbAJkCi2bweyWH_-o86rkRuuIsW166tM,126840
+astrapy/core/defaults.py,sha256=KJQCxLarExX_vosjS68RalzZAUYefx0JS38c5tFsClg,1009
+astrapy/core/ids.py,sha256=_iP01vkxOPWNRIpob86DLkvoJ8Sk2MoqQb2XjY4ei24,907
+astrapy/core/ops.py,sha256=vu-iuvwv5_aKRynLkKXZms4ffYD1V1wwZXejlu5tn_k,46165
+astrapy/core/utils.py,sha256=9vs4rNv4hY4NDWPwqAjB3Jjph3xfnajcZPfLFJL2Nic,13214
+astrapy/cursors.py,sha256=f2w1RllZLiDT1dkO2-k5O5v78fPcImaRR7Ts4gT2OR0,35775
+astrapy/database.py,sha256=NseF5hS7E3FR2fxep8SivfwAGLYdKui2xO8DdfTGlsI,61320
+astrapy/db/__init__.py,sha256=J9E4sO-ML6aLRqSQaKf9X3lmKy1tvrcKeG2vmegNty0,888
+astrapy/db/__pycache__/__init__.cpython-311.pyc,,
+astrapy/exceptions.py,sha256=_yzWvCvf9SOUG2joqq91J-dDaM9bXBKOE4o1qSK9dlM,28390
+astrapy/ids.py,sha256=vyqDyKiBgN5jZ4kPIWsYMRLrcq3Ew8wOEv5MBYrOVxI,874
+astrapy/info.py,sha256=OFA0RTHCn3E8zpDqL5gJyy5Cj-iOtr18l6XCrYYnubE,14210
+astrapy/operations.py,sha256=u3SBFWpD2prxzilkbZ8TcRxBpy7VFlKRtIF8fEKqVn0,29870
+astrapy/ops/__init__.py,sha256=Z6bLPdUDJWxPaZmeuFTO3nRG61FTed3NvG52XUo4Ce4,717
+astrapy/ops/__pycache__/__init__.cpython-311.pyc,,
+astrapy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+astrapy/results.py,sha256=HrIdZOa2QV0VIvMfMoZEo4Dab8jSlpswWx1XIeCg5FI,6111
diff --git a/llm/Lib/site-packages/astrapy-1.1.0.dist-info/REQUESTED b/llm/Lib/site-packages/astrapy-1.1.0.dist-info/REQUESTED
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/astrapy-1.1.0.dist-info/WHEEL b/llm/Lib/site-packages/astrapy-1.1.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..258a6ff36f44a40ff24d2bbd6d4c934481da1402
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy-1.1.0.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 1.6.1
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/astrapy/__init__.py b/llm/Lib/site-packages/astrapy/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed958231aea9cde66757bbcd3e72e8fc24d65fb2
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/__init__.py
@@ -0,0 +1,90 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import toml
+import os
+import importlib.metadata
+
+
+def get_version() -> str:
+    try:
+        # Poetry will create a __version__ attribute in the package's __init__.py file
+        return importlib.metadata.version(__package__)
+
+    # If the package is not installed, we can still get the version from the pyproject.toml file
+    except importlib.metadata.PackageNotFoundError:
+        # Get the path to the pyproject.toml file
+        dir_path = os.path.dirname(os.path.realpath(__file__))
+        pyproject_path = os.path.join(dir_path, "..", "pyproject.toml")
+
+        # Read the pyproject.toml file and get the version from the poetry section
+        try:
+            with open(pyproject_path, encoding="utf-8") as pyproject:
+                # Load the pyproject.toml file as a dictionary
+                file_contents = pyproject.read()
+                pyproject_data = toml.loads(file_contents)
+
+                # Return the version from the poetry section
+                return str(pyproject_data["tool"]["poetry"]["version"])
+
+        # If the pyproject.toml file does not exist or the version is not found, return unknown
+        except (FileNotFoundError, KeyError):
+            return "unknown"
+
+
+__version__: str = get_version()
+
+
+# A circular-import issue requires this to happen at the end of this module:
+from astrapy.database import (  # noqa: E402
+    AsyncDatabase,
+    Database,
+)
+from astrapy.collection import (  # noqa: E402
+    AsyncCollection,
+    Collection,
+)
+from astrapy.admin import (  # noqa: E402
+    AstraDBAdmin,
+    AstraDBDatabaseAdmin,
+)
+from astrapy.client import (  # noqa: E402
+    DataAPIClient,
+)
+
+import astrapy.ids  # noqa: E402
+import astrapy.constants  # noqa: E402
+import astrapy.cursors  # noqa: E402
+import astrapy.operations  # noqa: F401, E402
+
+
+__all__ = [
+    "AstraDBAdmin",
+    "AstraDBDatabaseAdmin",
+    "AsyncCollection",
+    "AsyncDatabase",
+    "Collection",
+    "Database",
+    "DataAPIClient",
+    "__version__",
+]
+
+
+__pdoc__ = {
+    "api": False,
+    "core": False,
+    "db": False,
+    "ops": False,
+    "ids": False,
+}
diff --git a/llm/Lib/site-packages/astrapy/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/astrapy/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1bd25aa3994cf080368a204e48dd4f45986e73c4
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/__pycache__/admin.cpython-311.pyc b/llm/Lib/site-packages/astrapy/__pycache__/admin.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..294a559c06ad1d166ed1378c76cb8c31b0418982
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/__pycache__/admin.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/__pycache__/client.cpython-311.pyc b/llm/Lib/site-packages/astrapy/__pycache__/client.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..99b8bc9346fe5a0b680d441db167455b488729ff
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/__pycache__/client.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/__pycache__/collection.cpython-311.pyc b/llm/Lib/site-packages/astrapy/__pycache__/collection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3778c164d6521ba997974e3cceb3bd6bc38829fd
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/__pycache__/collection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/__pycache__/constants.cpython-311.pyc b/llm/Lib/site-packages/astrapy/__pycache__/constants.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..871d6f7e52d1d9e0cb10f6ad4b6db849aea1097a
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/__pycache__/constants.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/__pycache__/cursors.cpython-311.pyc b/llm/Lib/site-packages/astrapy/__pycache__/cursors.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..79b1ae6f9d6ae2c4ae0902f507c7ab713dd5bb02
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/__pycache__/cursors.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/__pycache__/database.cpython-311.pyc b/llm/Lib/site-packages/astrapy/__pycache__/database.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..086f8072aa14da1769ab04d5dbeca435730c12b1
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/__pycache__/database.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/astrapy/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e1cbd5bd6c33bc1b757006fc27f225fc4e32f4ed
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/__pycache__/ids.cpython-311.pyc b/llm/Lib/site-packages/astrapy/__pycache__/ids.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..235318e6456eb74827021f8fe6259f6e8f45d940
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/__pycache__/ids.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/__pycache__/info.cpython-311.pyc b/llm/Lib/site-packages/astrapy/__pycache__/info.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cdf980127e7afa93777c30bcc5a897dd430abc20
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/__pycache__/info.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/__pycache__/operations.cpython-311.pyc b/llm/Lib/site-packages/astrapy/__pycache__/operations.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b376945c5656cdbd347595e72676f4fa393444b9
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/__pycache__/operations.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/__pycache__/results.cpython-311.pyc b/llm/Lib/site-packages/astrapy/__pycache__/results.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7defddf85b76aa57e0c70bbcdc4f45adef70ed9f
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/__pycache__/results.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/admin.py b/llm/Lib/site-packages/astrapy/admin.py
new file mode 100644
index 0000000000000000000000000000000000000000..72a3f96691383dec335779a6243e3907c0cd2212
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/admin.py
@@ -0,0 +1,2130 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import asyncio
+import logging
+import re
+import time
+from abc import ABC, abstractmethod
+from typing import Any, Dict, List, Optional, TYPE_CHECKING
+from dataclasses import dataclass
+
+import httpx
+
+from astrapy.core.ops import AstraDBOps
+from astrapy.cursors import CommandCursor
+from astrapy.info import AdminDatabaseInfo, DatabaseInfo
+from astrapy.exceptions import (
+    DevOpsAPIException,
+    MultiCallTimeoutManager,
+    base_timeout_info,
+    to_dataapi_timeout_exception,
+    ops_recast_method_sync,
+    ops_recast_method_async,
+)
+
+
+if TYPE_CHECKING:
+    from astrapy import AsyncDatabase, Database
+
+
+logger = logging.getLogger(__name__)
+
+
+DATABASE_POLL_NAMESPACE_SLEEP_TIME = 2
+DATABASE_POLL_SLEEP_TIME = 15
+
+STATUS_MAINTENANCE = "MAINTENANCE"
+STATUS_ACTIVE = "ACTIVE"
+STATUS_PENDING = "PENDING"
+STATUS_INITIALIZING = "INITIALIZING"
+STATUS_ERROR = "ERROR"
+STATUS_TERMINATING = "TERMINATING"
+
+
+class Environment:
+    """
+    Admitted values for `environment` property, such as the one denoting databases.
+    """
+
+    def __init__(self) -> None:
+        raise NotImplementedError
+
+    PROD = "prod"
+    DEV = "dev"
+    TEST = "test"
+
+
+database_id_matcher = re.compile(
+    "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
+)
+
+api_endpoint_parser = re.compile(
+    r"https://"
+    r"([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})"
+    r"-"
+    r"([a-z0-9\-]+)"
+    r".apps.astra[\-]{0,1}"
+    r"(dev|test)?"
+    r".datastax.com"
+)
+
+
+DEV_OPS_URL_MAP = {
+    Environment.PROD: "https://api.astra.datastax.com",
+    Environment.DEV: "https://api.dev.cloud.datastax.com",
+    Environment.TEST: "https://api.test.cloud.datastax.com",
+}
+
+API_ENDPOINT_TEMPLATE_MAP = {
+    Environment.PROD: "https://{database_id}-{region}.apps.astra.datastax.com",
+    Environment.DEV: "https://{database_id}-{region}.apps.astra-dev.datastax.com",
+    Environment.TEST: "https://{database_id}-{region}.apps.astra-test.datastax.com",
+}
+
+
+@dataclass
+class ParsedAPIEndpoint:
+    """
+    The results of successfully parsing an Astra DB API endpoint, for internal
+    by database metadata-related functions.
+
+    Attributes:
+        database_id: e. g. "01234567-89ab-cdef-0123-456789abcdef".
+        region: a region ID, such as "us-west1".
+        environment: a label, whose value is one of Environment.PROD,
+            Environment.DEV or Environment.TEST.
+    """
+
+    database_id: str
+    region: str
+    environment: str
+
+
+def parse_api_endpoint(api_endpoint: str) -> Optional[ParsedAPIEndpoint]:
+    """
+    Parse an API Endpoint into a ParsedAPIEndpoint structure.
+
+    Args:
+        api_endpoint: a full API endpoint for the Data Api.
+
+    Returns:
+        The parsed ParsedAPIEndpoint. If parsing fails, return None.
+    """
+
+    match = api_endpoint_parser.match(api_endpoint)
+    if match and match.groups():
+        d_id, d_re, d_en_x = match.groups()
+        return ParsedAPIEndpoint(
+            database_id=d_id,
+            region=d_re,
+            environment=d_en_x if d_en_x else "prod",
+        )
+    else:
+        return None
+
+
+def build_api_endpoint(environment: str, database_id: str, region: str) -> str:
+    """
+    Build the API Endpoint full strings from database parameters.
+
+    Args:
+        environment: a label, whose value is one of Environment.PROD,
+            Environment.DEV or Environment.TEST.
+        database_id: e. g. "01234567-89ab-cdef-0123-456789abcdef".
+        region: a region ID, such as "us-west1".
+
+    Returns:
+        the endpoint string, such as "https://01234567-...-eu-west1.apps.datastax.com"
+    """
+
+    return API_ENDPOINT_TEMPLATE_MAP[environment].format(
+        database_id=database_id,
+        region=region,
+    )
+
+
+def fetch_raw_database_info_from_id_token(
+    id: str,
+    *,
+    token: str,
+    environment: str = Environment.PROD,
+    max_time_ms: Optional[int] = None,
+) -> Dict[str, Any]:
+    """
+    Fetch database information through the DevOps API and return it in
+    full, exactly like the API gives it back.
+
+    Args:
+        id: e. g. "01234567-89ab-cdef-0123-456789abcdef".
+        token: a valid token to access the database information.
+        max_time_ms: a timeout, in milliseconds, for waiting on a response.
+
+    Returns:
+        The full response from the DevOps API about the database.
+    """
+
+    astra_db_ops = AstraDBOps(
+        token=token,
+        dev_ops_url=DEV_OPS_URL_MAP[environment],
+    )
+    try:
+        gd_response = astra_db_ops.get_database(
+            database=id,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        return gd_response
+    except httpx.TimeoutException as texc:
+        raise to_dataapi_timeout_exception(texc)
+
+
+async def async_fetch_raw_database_info_from_id_token(
+    id: str,
+    *,
+    token: str,
+    environment: str = Environment.PROD,
+    max_time_ms: Optional[int] = None,
+) -> Dict[str, Any]:
+    """
+    Fetch database information through the DevOps API and return it in
+    full, exactly like the API gives it back.
+    Async version of the function, for use in an asyncio context.
+
+    Args:
+        id: e. g. "01234567-89ab-cdef-0123-456789abcdef".
+        token: a valid token to access the database information.
+        max_time_ms: a timeout, in milliseconds, for waiting on a response.
+
+    Returns:
+        The full response from the DevOps API about the database.
+    """
+
+    astra_db_ops = AstraDBOps(
+        token=token,
+        dev_ops_url=DEV_OPS_URL_MAP[environment],
+    )
+    try:
+        gd_response = await astra_db_ops.async_get_database(
+            database=id,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        return gd_response
+    except httpx.TimeoutException as texc:
+        raise to_dataapi_timeout_exception(texc)
+
+
+def fetch_database_info(
+    api_endpoint: str, token: str, namespace: str, max_time_ms: Optional[int] = None
+) -> Optional[DatabaseInfo]:
+    """
+    Fetch database information through the DevOps API.
+
+    Args:
+        api_endpoint: a full API endpoint for the Data Api.
+        token: a valid token to access the database information.
+        namespace: the desired namespace that will be used in the result.
+        max_time_ms: a timeout, in milliseconds, for waiting on a response.
+
+    Returns:
+        A DatabaseInfo object.
+        If the API endpoint fails to be parsed, None is returned.
+        For valid-looking endpoints, if something goes wrong an exception is raised.
+    """
+
+    parsed_endpoint = parse_api_endpoint(api_endpoint)
+    if parsed_endpoint:
+        gd_response = fetch_raw_database_info_from_id_token(
+            id=parsed_endpoint.database_id,
+            token=token,
+            environment=parsed_endpoint.environment,
+            max_time_ms=max_time_ms,
+        )
+        raw_info = gd_response["info"]
+        if namespace not in raw_info["keyspaces"]:
+            raise DevOpsAPIException(f"Namespace {namespace} not found on DB.")
+        else:
+            return DatabaseInfo(
+                id=parsed_endpoint.database_id,
+                region=parsed_endpoint.region,
+                namespace=namespace,
+                name=raw_info["name"],
+                environment=parsed_endpoint.environment,
+                raw_info=raw_info,
+            )
+    else:
+        return None
+
+
+async def async_fetch_database_info(
+    api_endpoint: str, token: str, namespace: str, max_time_ms: Optional[int] = None
+) -> Optional[DatabaseInfo]:
+    """
+    Fetch database information through the DevOps API.
+    Async version of the function, for use in an asyncio context.
+
+    Args:
+        api_endpoint: a full API endpoint for the Data Api.
+        token: a valid token to access the database information.
+        namespace: the desired namespace that will be used in the result.
+        max_time_ms: a timeout, in milliseconds, for waiting on a response.
+
+    Returns:
+        A DatabaseInfo object.
+        If the API endpoint fails to be parsed, None is returned.
+        For valid-looking endpoints, if something goes wrong an exception is raised.
+    """
+
+    parsed_endpoint = parse_api_endpoint(api_endpoint)
+    if parsed_endpoint:
+        gd_response = await async_fetch_raw_database_info_from_id_token(
+            id=parsed_endpoint.database_id,
+            token=token,
+            environment=parsed_endpoint.environment,
+            max_time_ms=max_time_ms,
+        )
+        raw_info = gd_response["info"]
+        if namespace not in raw_info["keyspaces"]:
+            raise DevOpsAPIException(f"Namespace {namespace} not found on DB.")
+        else:
+            return DatabaseInfo(
+                id=parsed_endpoint.database_id,
+                region=parsed_endpoint.region,
+                namespace=namespace,
+                name=raw_info["name"],
+                environment=parsed_endpoint.environment,
+                raw_info=raw_info,
+            )
+    else:
+        return None
+
+
+def _recast_as_admin_database_info(
+    admin_database_info_dict: Dict[str, Any],
+    *,
+    environment: str,
+) -> AdminDatabaseInfo:
+    return AdminDatabaseInfo(
+        info=DatabaseInfo(
+            id=admin_database_info_dict["id"],
+            region=admin_database_info_dict["info"]["region"],
+            namespace=admin_database_info_dict["info"]["keyspace"],
+            name=admin_database_info_dict["info"]["name"],
+            environment=environment,
+            raw_info=admin_database_info_dict["info"],
+        ),
+        available_actions=admin_database_info_dict.get("availableActions"),
+        cost=admin_database_info_dict["cost"],
+        cqlsh_url=admin_database_info_dict["cqlshUrl"],
+        creation_time=admin_database_info_dict["creationTime"],
+        data_endpoint_url=admin_database_info_dict["dataEndpointUrl"],
+        grafana_url=admin_database_info_dict["grafanaUrl"],
+        graphql_url=admin_database_info_dict["graphqlUrl"],
+        id=admin_database_info_dict["id"],
+        last_usage_time=admin_database_info_dict["lastUsageTime"],
+        metrics=admin_database_info_dict["metrics"],
+        observed_status=admin_database_info_dict["observedStatus"],
+        org_id=admin_database_info_dict["orgId"],
+        owner_id=admin_database_info_dict["ownerId"],
+        status=admin_database_info_dict["status"],
+        storage=admin_database_info_dict["storage"],
+        termination_time=admin_database_info_dict["terminationTime"],
+        raw_info=admin_database_info_dict,
+    )
+
+
+class AstraDBAdmin:
+    """
+    An "admin" object, able to perform administrative tasks at the databases
+    level, such as creating, listing or dropping databases.
+
+    Args:
+        token: an access token with enough permission to perform admin tasks.
+        environment: a label, whose value is one of Environment.PROD (default),
+            Environment.DEV or Environment.TEST.
+        caller_name: name of the application, or framework, on behalf of which
+            the DevOps API calls are performed. This ends up in the request user-agent.
+        caller_version: version of the caller.
+        dev_ops_url: in case of custom deployments, this can be used to specify
+            the URL to the DevOps API, such as "https://api.astra.datastax.com".
+            Generally it can be omitted. The environment (prod/dev/...) is
+            determined from the API Endpoint.
+        dev_ops_api_version: this can specify a custom version of the DevOps API
+            (such as "v2"). Generally not needed.
+
+    Example:
+        >>> from astrapy import DataAPIClient
+        >>> my_client = DataAPIClient("AstraCS:...")
+        >>> my_astra_db_admin = my_client.get_admin()
+        >>> database_list = my_astra_db_admin.list_databases()
+        >>> len(database_list)
+        3
+        >>> database_list[2].id
+        '01234567-...'
+        >>> my_db_admin = my_astra_db_admin.get_database_admin("01234567-...")
+        >>> my_db_admin.list_namespaces()
+        ['default_keyspace', 'staging_namespace']
+    """
+
+    def __init__(
+        self,
+        token: str,
+        *,
+        environment: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+        dev_ops_url: Optional[str] = None,
+        dev_ops_api_version: Optional[str] = None,
+    ) -> None:
+        self.token = token
+        self.environment = environment or Environment.PROD
+        if dev_ops_url is None:
+            self.dev_ops_url = DEV_OPS_URL_MAP[self.environment]
+        else:
+            self.dev_ops_url = dev_ops_url
+        self._caller_name = caller_name
+        self._caller_version = caller_version
+        self._dev_ops_url = dev_ops_url
+        self._dev_ops_api_version = dev_ops_api_version
+        self._astra_db_ops = AstraDBOps(
+            token=self.token,
+            dev_ops_url=self.dev_ops_url,
+            dev_ops_api_version=dev_ops_api_version,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
+    def __repr__(self) -> str:
+        env_desc: str
+        if self.environment == Environment.PROD:
+            env_desc = ""
+        else:
+            env_desc = f', environment="{self.environment}"'
+        return f'{self.__class__.__name__}("{self.token[:12]}..."{env_desc})'
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, AstraDBAdmin):
+            return all(
+                [
+                    self.token == other.token,
+                    self.environment == other.environment,
+                    self.dev_ops_url == other.dev_ops_url,
+                    self.dev_ops_url == other.dev_ops_url,
+                    self._caller_name == other._caller_name,
+                    self._caller_version == other._caller_version,
+                    self._dev_ops_url == other._dev_ops_url,
+                    self._dev_ops_api_version == other._dev_ops_api_version,
+                    self._astra_db_ops == other._astra_db_ops,
+                ]
+            )
+        else:
+            return False
+
+    def _copy(
+        self,
+        *,
+        token: Optional[str] = None,
+        environment: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+        dev_ops_url: Optional[str] = None,
+        dev_ops_api_version: Optional[str] = None,
+    ) -> AstraDBAdmin:
+        return AstraDBAdmin(
+            token=token or self.token,
+            environment=environment or self.environment,
+            caller_name=caller_name or self._caller_name,
+            caller_version=caller_version or self._caller_version,
+            dev_ops_url=dev_ops_url or self._dev_ops_url,
+            dev_ops_api_version=dev_ops_api_version or self._dev_ops_api_version,
+        )
+
+    def with_options(
+        self,
+        *,
+        token: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> AstraDBAdmin:
+        """
+        Create a clone of this AstraDBAdmin with some changed attributes.
+
+        Args:
+            token: an Access Token to the database. Example: `"AstraCS:xyz..."`.
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API and DevOps API calls are performed. This ends up in
+                the request user-agent.
+            caller_version: version of the caller.
+
+        Returns:
+            a new AstraDBAdmin instance.
+
+        Example:
+            >>> another_astra_db_admin = my_astra_db_admin.with_options(
+            ...     caller_name="caller_identity",
+            ...     caller_version="1.2.0",
+            ... )
+        """
+
+        return self._copy(
+            token=token,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
+    def set_caller(
+        self,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        """
+        Set a new identity for the application/framework on behalf of which
+        the DevOps API calls will be performed (the "caller").
+
+        New objects spawned from this client afterwards will inherit the new settings.
+
+        Args:
+            caller_name: name of the application, or framework, on behalf of which
+                the DevOps API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+
+        Example:
+            >>> my_astra_db_admin.set_caller(
+            ...     caller_name="the_caller",
+            ...     caller_version="0.1.0",
+            ... )
+        """
+
+        logger.info(f"setting caller to {caller_name}/{caller_version}")
+        self._caller_name = caller_name
+        self._caller_version = caller_version
+        self._astra_db_ops.set_caller(caller_name, caller_version)
+
+    @ops_recast_method_sync
+    def list_databases(
+        self,
+        *,
+        max_time_ms: Optional[int] = None,
+    ) -> CommandCursor[AdminDatabaseInfo]:
+        """
+        Get the list of databases, as obtained with a request to the DevOps API.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the API request.
+
+        Returns:
+            A CommandCursor to iterate over the detected databases,
+            represented as AdminDatabaseInfo objects.
+
+        Example:
+            >>> database_cursor = my_astra_db_admin.list_databases()
+            >>> database_list = list(database_cursor)
+            >>> len(database_list)
+            3
+            >>> database_list[2].id
+            '01234567-...'
+            >>> database_list[2].status
+            'ACTIVE'
+            >>> database_list[2].info.region
+            'eu-west-1'
+        """
+
+        logger.info("getting databases")
+        gd_list_response = self._astra_db_ops.get_databases(
+            timeout_info=base_timeout_info(max_time_ms)
+        )
+        logger.info("finished getting databases")
+        if not isinstance(gd_list_response, list):
+            raise DevOpsAPIException(
+                "Faulty response from get-databases DevOps API command.",
+            )
+        else:
+            # we know this is a list of dicts which need a little adjusting
+            return CommandCursor(
+                address=self._astra_db_ops.base_url,
+                items=[
+                    _recast_as_admin_database_info(
+                        db_dict,
+                        environment=self.environment,
+                    )
+                    for db_dict in gd_list_response
+                ],
+            )
+
+    @ops_recast_method_async
+    async def async_list_databases(
+        self,
+        *,
+        max_time_ms: Optional[int] = None,
+    ) -> CommandCursor[AdminDatabaseInfo]:
+        """
+        Get the list of databases, as obtained with a request to the DevOps API.
+        Async version of the method, for use in an asyncio context.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the API request.
+
+        Returns:
+            A CommandCursor to iterate over the detected databases,
+            represented as AdminDatabaseInfo objects.
+            Note that the return type is not an awaitable, rather
+            a regular iterable, e.g. for use in ordinary "for" loops.
+
+        Example:
+            >>> async def check_if_db_exists(db_id: str) -> bool:
+            ...     db_cursor = await my_astra_db_admin.async_list_databases()
+            ...     db_list = list(dd_cursor)
+            ...     return db_id in db_list
+            ...
+            >>> asyncio.run(check_if_db_exists("xyz"))
+            True
+            >>> asyncio.run(check_if_db_exists("01234567-..."))
+            False
+        """
+
+        logger.info("getting databases, async")
+        gd_list_response = await self._astra_db_ops.async_get_databases(
+            timeout_info=base_timeout_info(max_time_ms)
+        )
+        logger.info("finished getting databases, async")
+        if not isinstance(gd_list_response, list):
+            raise DevOpsAPIException(
+                "Faulty response from get-databases DevOps API command.",
+            )
+        else:
+            # we know this is a list of dicts which need a little adjusting
+            return CommandCursor(
+                address=self._astra_db_ops.base_url,
+                items=[
+                    _recast_as_admin_database_info(
+                        db_dict,
+                        environment=self.environment,
+                    )
+                    for db_dict in gd_list_response
+                ],
+            )
+
+    @ops_recast_method_sync
+    def database_info(
+        self, id: str, *, max_time_ms: Optional[int] = None
+    ) -> AdminDatabaseInfo:
+        """
+        Get the full information on a given database, through a request to the DevOps API.
+
+        Args:
+            id: the ID of the target database, e. g.
+                "01234567-89ab-cdef-0123-456789abcdef".
+            max_time_ms: a timeout, in milliseconds, for the API request.
+
+        Returns:
+            An AdminDatabaseInfo object.
+
+        Example:
+            >>> details_of_my_db = my_astra_db_admin.database_info("01234567-...")
+            >>> details_of_my_db.id
+            '01234567-...'
+            >>> details_of_my_db.status
+            'ACTIVE'
+            >>> details_of_my_db.info.region
+            'eu-west-1'
+        """
+
+        logger.info(f"getting database info for '{id}'")
+        gd_response = self._astra_db_ops.get_database(
+            database=id,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished getting database info for '{id}'")
+        if not isinstance(gd_response, dict):
+            raise DevOpsAPIException(
+                "Faulty response from get-database DevOps API command.",
+            )
+        else:
+            return _recast_as_admin_database_info(
+                gd_response,
+                environment=self.environment,
+            )
+
+    @ops_recast_method_async
+    async def async_database_info(
+        self, id: str, *, max_time_ms: Optional[int] = None
+    ) -> AdminDatabaseInfo:
+        """
+        Get the full information on a given database, through a request to the DevOps API.
+        This is an awaitable method suitable for use within an asyncio event loop.
+
+        Args:
+            id: the ID of the target database, e. g.
+                "01234567-89ab-cdef-0123-456789abcdef".
+            max_time_ms: a timeout, in milliseconds, for the API request.
+
+        Returns:
+            An AdminDatabaseInfo object.
+
+        Example:
+            >>> async def check_if_db_active(db_id: str) -> bool:
+            ...     db_info = await my_astra_db_admin.async_database_info(db_id)
+            ...     return db_info.status == "ACTIVE"
+            ...
+            >>> asyncio.run(check_if_db_active("01234567-..."))
+            True
+        """
+
+        logger.info(f"getting database info for '{id}', async")
+        gd_response = await self._astra_db_ops.async_get_database(
+            database=id,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished getting database info for '{id}', async")
+        if not isinstance(gd_response, dict):
+            raise DevOpsAPIException(
+                "Faulty response from get-database DevOps API command.",
+            )
+        else:
+            return _recast_as_admin_database_info(
+                gd_response,
+                environment=self.environment,
+            )
+
+    @ops_recast_method_sync
+    def create_database(
+        self,
+        name: str,
+        *,
+        cloud_provider: str,
+        region: str,
+        namespace: Optional[str] = None,
+        wait_until_active: bool = True,
+        max_time_ms: Optional[int] = None,
+    ) -> AstraDBDatabaseAdmin:
+        """
+        Create a database as requested, optionally waiting for it to be ready.
+
+        Args:
+            name: the desired name for the database.
+            cloud_provider: one of 'aws', 'gcp' or 'azure'.
+            region: any of the available cloud regions.
+            namespace: name for the one namespace the database starts with.
+                If omitted, DevOps API will use its default.
+            wait_until_active: if True (default), the method returns only after
+                the newly-created database is in ACTIVE state (a few minutes,
+                usually). If False, it will return right after issuing the
+                creation request to the DevOps API, and it will be responsibility
+                of the caller to check the database status before working with it.
+            max_time_ms: a timeout, in milliseconds, for the whole requested
+                operation to complete.
+                Note that a timeout is no guarantee that the creation request
+                has not reached the API server.
+
+        Returns:
+            An AstraDBDatabaseAdmin instance.
+
+        Example:
+            >>> my_new_db_admin = my_astra_db_admin.create_database(
+            ...     "new_database",
+            ...     cloud_provider="aws",
+            ...     region="ap-south-1",
+            ... )
+            >>> my_new_db = my_new_db_admin.get_database()
+            >>> my_coll = my_new_db.create_collection("movies", dimension=512)
+            >>> my_coll.insert_one({"title": "The Title"}, vector=...)
+        """
+
+        database_definition = {
+            k: v
+            for k, v in {
+                "name": name,
+                "tier": "serverless",
+                "cloudProvider": cloud_provider,
+                "region": region,
+                "capacityUnits": 1,
+                "dbType": "vector",
+                "keyspace": namespace,
+            }.items()
+            if v is not None
+        }
+        timeout_manager = MultiCallTimeoutManager(
+            overall_max_time_ms=max_time_ms, exception_type="devops_api"
+        )
+        logger.info(f"creating database {name}/({cloud_provider}, {region})")
+        cd_response = self._astra_db_ops.create_database(
+            database_definition=database_definition,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(
+            "devops api returned from creating database "
+            f"{name}/({cloud_provider}, {region})"
+        )
+        if cd_response is not None and "id" in cd_response:
+            new_database_id = cd_response["id"]
+            if wait_until_active:
+                last_status_seen = STATUS_PENDING
+                while last_status_seen in {STATUS_PENDING, STATUS_INITIALIZING}:
+                    logger.info(f"sleeping to poll for status of '{new_database_id}'")
+                    time.sleep(DATABASE_POLL_SLEEP_TIME)
+                    last_db_info = self.database_info(
+                        id=new_database_id,
+                        max_time_ms=timeout_manager.remaining_timeout_ms(),
+                    )
+                    last_status_seen = last_db_info.status
+                if last_status_seen != STATUS_ACTIVE:
+                    raise DevOpsAPIException(
+                        f"Database {name} entered unexpected status {last_status_seen} after PENDING"
+                    )
+            # return the database instance
+            logger.info(
+                f"finished creating database '{new_database_id}' = "
+                f"{name}/({cloud_provider}, {region})"
+            )
+            return AstraDBDatabaseAdmin.from_astra_db_admin(
+                id=new_database_id,
+                astra_db_admin=self,
+            )
+        else:
+            raise DevOpsAPIException("Could not create the database.")
+
+    @ops_recast_method_async
+    async def async_create_database(
+        self,
+        name: str,
+        *,
+        cloud_provider: str,
+        region: str,
+        namespace: Optional[str] = None,
+        wait_until_active: bool = True,
+        max_time_ms: Optional[int] = None,
+    ) -> AstraDBDatabaseAdmin:
+        """
+        Create a database as requested, optionally waiting for it to be ready.
+        This is an awaitable method suitable for use within an asyncio event loop.
+
+        Args:
+            name: the desired name for the database.
+            cloud_provider: one of 'aws', 'gcp' or 'azure'.
+            region: any of the available cloud regions.
+            namespace: name for the one namespace the database starts with.
+                If omitted, DevOps API will use its default.
+            wait_until_active: if True (default), the method returns only after
+                the newly-created database is in ACTIVE state (a few minutes,
+                usually). If False, it will return right after issuing the
+                creation request to the DevOps API, and it will be responsibility
+                of the caller to check the database status before working with it.
+            max_time_ms: a timeout, in milliseconds, for the whole requested
+                operation to complete.
+                Note that a timeout is no guarantee that the creation request
+                has not reached the API server.
+
+        Returns:
+            An AstraDBDatabaseAdmin instance.
+
+        Example:
+            >>> asyncio.run(
+            ...     my_astra_db_admin.async_create_database(
+            ...         "new_database",
+            ...         cloud_provider="aws",
+            ...         region="ap-south-1",
+            ....    )
+            ... )
+            AstraDBDatabaseAdmin(id=...)
+        """
+
+        database_definition = {
+            k: v
+            for k, v in {
+                "name": name,
+                "tier": "serverless",
+                "cloudProvider": cloud_provider,
+                "region": region,
+                "capacityUnits": 1,
+                "dbType": "vector",
+                "keyspace": namespace,
+            }.items()
+            if v is not None
+        }
+        timeout_manager = MultiCallTimeoutManager(
+            overall_max_time_ms=max_time_ms, exception_type="devops_api"
+        )
+        logger.info(f"creating database {name}/({cloud_provider}, {region}), async")
+        cd_response = await self._astra_db_ops.async_create_database(
+            database_definition=database_definition,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(
+            "devops api returned from creating database "
+            f"{name}/({cloud_provider}, {region}), async"
+        )
+        if cd_response is not None and "id" in cd_response:
+            new_database_id = cd_response["id"]
+            if wait_until_active:
+                last_status_seen = STATUS_PENDING
+                while last_status_seen in {STATUS_PENDING, STATUS_INITIALIZING}:
+                    logger.info(
+                        f"sleeping to poll for status of '{new_database_id}', async"
+                    )
+                    await asyncio.sleep(DATABASE_POLL_SLEEP_TIME)
+                    last_db_info = await self.async_database_info(
+                        id=new_database_id,
+                        max_time_ms=timeout_manager.remaining_timeout_ms(),
+                    )
+                    last_status_seen = last_db_info.status
+                if last_status_seen != STATUS_ACTIVE:
+                    raise DevOpsAPIException(
+                        f"Database {name} entered unexpected status {last_status_seen} after PENDING"
+                    )
+            # return the database instance
+            logger.info(
+                f"finished creating database '{new_database_id}' = "
+                f"{name}/({cloud_provider}, {region}), async"
+            )
+            return AstraDBDatabaseAdmin.from_astra_db_admin(
+                id=new_database_id,
+                astra_db_admin=self,
+            )
+        else:
+            raise DevOpsAPIException("Could not create the database.")
+
+    @ops_recast_method_sync
+    def drop_database(
+        self,
+        id: str,
+        *,
+        wait_until_active: bool = True,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Drop a database, i.e. delete it completely and permanently with all its data.
+
+        Args:
+            id: The ID of the database to drop, e. g.
+                "01234567-89ab-cdef-0123-456789abcdef".
+            wait_until_active: if True (default), the method returns only after
+                the database has actually been deleted (generally a few minutes).
+                If False, it will return right after issuing the
+                drop request to the DevOps API, and it will be responsibility
+                of the caller to check the database status/availability
+                after that, if desired.
+            max_time_ms: a timeout, in milliseconds, for the whole requested
+                operation to complete.
+                Note that a timeout is no guarantee that the deletion request
+                has not reached the API server.
+
+        Returns:
+            A dictionary of the form {"ok": 1} in case of success.
+            Otherwise, an exception is raised.
+
+        Example:
+            >>> database_list_pre = my_astra_db_admin.list_databases()
+            >>> len(database_list_pre)
+            3
+            >>> my_astra_db_admin.drop_database("01234567-...")
+            {'ok': 1}
+            >>> database_list_post = my_astra_db_admin.list_databases()
+            >>> len(database_list_post)
+            2
+        """
+
+        timeout_manager = MultiCallTimeoutManager(
+            overall_max_time_ms=max_time_ms, exception_type="devops_api"
+        )
+        logger.info(f"dropping database '{id}'")
+        te_response = self._astra_db_ops.terminate_database(
+            database=id,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"devops api returned from dropping database '{id}'")
+        if te_response == id:
+            if wait_until_active:
+                last_status_seen: Optional[str] = STATUS_TERMINATING
+                _db_name: Optional[str] = None
+                while last_status_seen == STATUS_TERMINATING:
+                    logger.info(f"sleeping to poll for status of '{id}'")
+                    time.sleep(DATABASE_POLL_SLEEP_TIME)
+                    #
+                    detected_databases = [
+                        a_db_info
+                        for a_db_info in self.list_databases(
+                            max_time_ms=timeout_manager.remaining_timeout_ms(),
+                        )
+                        if a_db_info.id == id
+                    ]
+                    if detected_databases:
+                        last_status_seen = detected_databases[0].status
+                        _db_name = detected_databases[0].info.name
+                    else:
+                        last_status_seen = None
+                if last_status_seen is not None:
+                    _name_desc = f" ({_db_name})" if _db_name else ""
+                    raise DevOpsAPIException(
+                        f"Database {id}{_name_desc} entered unexpected status {last_status_seen} after PENDING"
+                    )
+            logger.info(f"finished dropping database '{id}'")
+            return {"ok": 1}
+        else:
+            raise DevOpsAPIException(
+                f"Could not issue a successful terminate-database DevOps API request for {id}."
+            )
+
+    @ops_recast_method_async
+    async def async_drop_database(
+        self,
+        id: str,
+        *,
+        wait_until_active: bool = True,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Drop a database, i.e. delete it completely and permanently with all its data.
+        Async version of the method, for use in an asyncio context.
+
+        Args:
+            id: The ID of the database to drop, e. g.
+                "01234567-89ab-cdef-0123-456789abcdef".
+            wait_until_active: if True (default), the method returns only after
+                the database has actually been deleted (generally a few minutes).
+                If False, it will return right after issuing the
+                drop request to the DevOps API, and it will be responsibility
+                of the caller to check the database status/availability
+                after that, if desired.
+            max_time_ms: a timeout, in milliseconds, for the whole requested
+                operation to complete.
+                Note that a timeout is no guarantee that the deletion request
+                has not reached the API server.
+
+        Returns:
+            A dictionary of the form {"ok": 1} in case of success.
+            Otherwise, an exception is raised.
+
+        Example:
+            >>> asyncio.run(
+            ...     my_astra_db_admin.async_drop_database("01234567-...")
+            ... )
+            {'ok': 1}
+        """
+
+        timeout_manager = MultiCallTimeoutManager(
+            overall_max_time_ms=max_time_ms, exception_type="devops_api"
+        )
+        logger.info(f"dropping database '{id}', async")
+        te_response = await self._astra_db_ops.async_terminate_database(
+            database=id,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"devops api returned from dropping database '{id}', async")
+        if te_response == id:
+            if wait_until_active:
+                last_status_seen: Optional[str] = STATUS_TERMINATING
+                _db_name: Optional[str] = None
+                while last_status_seen == STATUS_TERMINATING:
+                    logger.info(f"sleeping to poll for status of '{id}', async")
+                    await asyncio.sleep(DATABASE_POLL_SLEEP_TIME)
+                    #
+                    detected_databases = [
+                        a_db_info
+                        for a_db_info in await self.async_list_databases(
+                            max_time_ms=timeout_manager.remaining_timeout_ms(),
+                        )
+                        if a_db_info.id == id
+                    ]
+                    if detected_databases:
+                        last_status_seen = detected_databases[0].status
+                        _db_name = detected_databases[0].info.name
+                    else:
+                        last_status_seen = None
+                if last_status_seen is not None:
+                    _name_desc = f" ({_db_name})" if _db_name else ""
+                    raise DevOpsAPIException(
+                        f"Database {id}{_name_desc} entered unexpected status {last_status_seen} after PENDING"
+                    )
+            logger.info(f"finished dropping database '{id}', async")
+            return {"ok": 1}
+        else:
+            raise DevOpsAPIException(
+                f"Could not issue a successful terminate-database DevOps API request for {id}."
+            )
+
+    def get_database_admin(self, id: str) -> AstraDBDatabaseAdmin:
+        """
+        Create an AstraDBDatabaseAdmin object for admin work within a certain database.
+
+        Args:
+            id: the ID of the target database, e. g. "01234567-89ab-cdef-0123-456789abcdef".
+
+        Returns:
+            An AstraDBDatabaseAdmin instance representing the requested database.
+
+        Example:
+            >>> my_db_admin = my_astra_db_admin.get_database_admin("01234567-...")
+            >>> my_db_admin.list_namespaces()
+            ['default_keyspace']
+            >>> my_db_admin.create_namespace("that_other_one")
+            {'ok': 1}
+            >>> my_db_admin.list_namespaces()
+            ['default_keyspace', 'that_other_one']
+
+        Note:
+            This method does not perform any admin-level operation through
+            the DevOps API. For actual creation of a database, see the
+            `create_database` method.
+        """
+
+        return AstraDBDatabaseAdmin.from_astra_db_admin(
+            id=id,
+            astra_db_admin=self,
+        )
+
+    def get_database(
+        self,
+        id: str,
+        *,
+        token: Optional[str] = None,
+        namespace: Optional[str] = None,
+        region: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> Database:
+        """
+        Create a Database instance for a specific database, to be used
+        when doing data-level work (such as creating/managing collections).
+
+        Args:
+            id: e. g. "01234567-89ab-cdef-0123-456789abcdef".
+            token: if supplied, is passed to the Database instead of
+                the one set for this object.
+            namespace: used to specify a certain namespace the resulting
+                Database will primarily work on. If not specified, similar
+                as for `region`, an additional DevOps API call reveals
+                the default namespace for the target database.
+            region: the region to use for connecting to the database. The
+                database must be located in that region.
+                Note that if this parameter is not passed, an additional
+                DevOps API request is made to determine the default region
+                and use it subsequently.
+                If both `namespace` and `region` are missing, a single
+                DevOps API request is made.
+            api_path: path to append to the API Endpoint. In typical usage, this
+                should be left to its default of "/api/json".
+            api_version: version specifier to append to the API path. In typical
+                usage, this should be left to its default of "v1".
+            max_time_ms: a timeout, in milliseconds, for the DevOps API
+                HTTP request should it be necessary (see the `region` argument).
+
+        Returns:
+            A Database object ready to be used.
+
+        Example:
+            >>> my_db = my_astra_db_admin.get_database(
+            ...     "01234567-...",
+            ...     region="us-east1",
+            ... )
+            >>> coll = my_db.create_collection("movies", dimension=512)
+            >>> my_coll.insert_one({"title": "The Title"}, vector=...)
+
+        Note:
+            This method does not perform any admin-level operation through
+            the DevOps API. For actual creation of a database, see the
+            `create_database` method of class AstraDBAdmin.
+        """
+
+        # lazy importing here to avoid circular dependency
+        from astrapy import Database
+
+        # need to inspect for values?
+        this_db_info: Optional[AdminDatabaseInfo] = None
+        # handle overrides
+        _token = token or self.token
+        if namespace:
+            _namespace = namespace
+        else:
+            if this_db_info is None:
+                this_db_info = self.database_info(id, max_time_ms=max_time_ms)
+            _namespace = this_db_info.info.namespace
+        if region:
+            _region = region
+        else:
+            if this_db_info is None:
+                this_db_info = self.database_info(id, max_time_ms=max_time_ms)
+            _region = this_db_info.info.region
+
+        _api_endpoint = build_api_endpoint(
+            environment=self.environment,
+            database_id=id,
+            region=_region,
+        )
+        return Database(
+            api_endpoint=_api_endpoint,
+            token=_token,
+            namespace=_namespace,
+            caller_name=self._caller_name,
+            caller_version=self._caller_version,
+            api_path=api_path,
+            api_version=api_version,
+        )
+
+    def get_async_database(
+        self,
+        id: str,
+        *,
+        token: Optional[str] = None,
+        namespace: Optional[str] = None,
+        region: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+    ) -> AsyncDatabase:
+        """
+        Create an AsyncDatabase instance for a specific database, to be used
+        when doing data-level work (such as creating/managing collections).
+
+        This method has identical behavior and signature as the sync
+        counterpart `get_database`: please see that one for more details.
+        """
+
+        return self.get_database(
+            id=id,
+            token=token,
+            namespace=namespace,
+            region=region,
+            api_path=api_path,
+            api_version=api_version,
+        ).to_async()
+
+
+class DatabaseAdmin(ABC):
+    """
+    An abstract class defining the interface for a database admin object.
+    This supports generic namespace crud, as well as spawning databases,
+    without committing to a specific database architecture (e.g. Astra DB).
+    """
+
+    @abstractmethod
+    def list_namespaces(self, *pargs: Any, **kwargs: Any) -> List[str]:
+        """Get a list of namespaces for the database."""
+        ...
+
+    @abstractmethod
+    def create_namespace(self, name: str, *pargs: Any, **kwargs: Any) -> Dict[str, Any]:
+        """
+        Create a namespace in the database, returning {'ok': 1} if successful.
+        """
+        ...
+
+    @abstractmethod
+    def drop_namespace(self, name: str, *pargs: Any, **kwargs: Any) -> Dict[str, Any]:
+        """
+        Drop (delete) a namespace from the database, returning {'ok': 1} if successful.
+        """
+        ...
+
+    @abstractmethod
+    async def async_list_namespaces(self, *pargs: Any, **kwargs: Any) -> List[str]:
+        """
+        Get a list of namespaces for the database.
+        (Async version of the method.)
+        """
+        ...
+
+    @abstractmethod
+    async def async_create_namespace(
+        self, name: str, *pargs: Any, **kwargs: Any
+    ) -> Dict[str, Any]:
+        """
+        Create a namespace in the database, returning {'ok': 1} if successful.
+        (Async version of the method.)
+        """
+        ...
+
+    @abstractmethod
+    async def async_drop_namespace(
+        self, name: str, *pargs: Any, **kwargs: Any
+    ) -> Dict[str, Any]:
+        """
+        Drop (delete) a namespace from the database, returning {'ok': 1} if successful.
+        (Async version of the method.)
+        """
+        ...
+
+    @abstractmethod
+    def get_database(self, *pargs: Any, **kwargs: Any) -> Database:
+        """Get a Database object from this database admin."""
+        ...
+
+    @abstractmethod
+    def get_async_database(self, *pargs: Any, **kwargs: Any) -> AsyncDatabase:
+        """Get an AsyncDatabase object from this database admin."""
+        ...
+
+
+class AstraDBDatabaseAdmin(DatabaseAdmin):
+    """
+    An "admin" object, able to perform administrative tasks at the namespaces level
+    (i.e. within a certani database), such as creating/listing/dropping namespaces.
+
+    This is one layer below the AstraDBAdmin concept, in that it is tied to
+    a single database and enables admin work within it. As such, it is generally
+    created by a method call on an AstraDBAdmin.
+
+    Args:
+        id: e. g. "01234567-89ab-cdef-0123-456789abcdef".
+        token: an access token with enough permission to perform admin tasks.
+        environment: a label, whose value is one of Environment.PROD (default),
+            Environment.DEV or Environment.TEST.
+        caller_name: name of the application, or framework, on behalf of which
+            the DevOps API calls are performed. This ends up in the request user-agent.
+        caller_version: version of the caller.
+        dev_ops_url: in case of custom deployments, this can be used to specify
+            the URL to the DevOps API, such as "https://api.astra.datastax.com".
+            Generally it can be omitted. The environment (prod/dev/...) is
+            determined from the API Endpoint.
+        dev_ops_api_version: this can specify a custom version of the DevOps API
+            (such as "v2"). Generally not needed.
+
+    Example:
+        >>> from astrapy import DataAPIClient
+        >>> my_client = DataAPIClient("AstraCS:...")
+        >>> admin_for_my_db = my_client.get_admin().get_database_admin("01234567-...")
+        >>> admin_for_my_db.list_namespaces()
+        ['default_keyspace', 'staging_namespace']
+        >>> admin_for_my_db.info().status
+        'ACTIVE'
+
+    Note:
+        creating an instance of AstraDBDatabaseAdmin does not trigger actual creation
+        of the database itself, which should exist beforehand. To create databases,
+        see the AstraDBAdmin class.
+    """
+
+    def __init__(
+        self,
+        id: str,
+        *,
+        token: str,
+        environment: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+        dev_ops_url: Optional[str] = None,
+        dev_ops_api_version: Optional[str] = None,
+    ) -> None:
+        self.id = id
+        self.token = token
+        self.environment = environment or Environment.PROD
+        self._astra_db_admin = AstraDBAdmin(
+            token=self.token,
+            environment=self.environment,
+            caller_name=caller_name,
+            caller_version=caller_version,
+            dev_ops_url=dev_ops_url,
+            dev_ops_api_version=dev_ops_api_version,
+        )
+
+    def __repr__(self) -> str:
+        env_desc: str
+        if self.environment == Environment.PROD:
+            env_desc = ""
+        else:
+            env_desc = f', environment="{self.environment}"'
+        return (
+            f'{self.__class__.__name__}(id="{self.id}", '
+            f'"{self.token[:12]}..."{env_desc})'
+        )
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, AstraDBDatabaseAdmin):
+            return all(
+                [
+                    self.id == other.id,
+                    self.token == other.token,
+                    self.environment == other.environment,
+                    self._astra_db_admin == other._astra_db_admin,
+                ]
+            )
+        else:
+            return False
+
+    def _copy(
+        self,
+        id: Optional[str] = None,
+        token: Optional[str] = None,
+        environment: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+        dev_ops_url: Optional[str] = None,
+        dev_ops_api_version: Optional[str] = None,
+    ) -> AstraDBDatabaseAdmin:
+        return AstraDBDatabaseAdmin(
+            id=id or self.id,
+            token=token or self.token,
+            environment=environment or self.environment,
+            caller_name=caller_name or self._astra_db_admin._caller_name,
+            caller_version=caller_version or self._astra_db_admin._caller_version,
+            dev_ops_url=dev_ops_url or self._astra_db_admin._dev_ops_url,
+            dev_ops_api_version=dev_ops_api_version
+            or self._astra_db_admin._dev_ops_api_version,
+        )
+
+    def with_options(
+        self,
+        *,
+        id: Optional[str] = None,
+        token: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> AstraDBDatabaseAdmin:
+        """
+        Create a clone of this AstraDBDatabaseAdmin with some changed attributes.
+
+        Args:
+            id: e. g. "01234567-89ab-cdef-0123-456789abcdef".
+            token: an Access Token to the database. Example: `"AstraCS:xyz..."`.
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API and DevOps API calls are performed. This ends up in
+                the request user-agent.
+            caller_version: version of the caller.
+
+        Returns:
+            a new AstraDBDatabaseAdmin instance.
+
+        Example:
+            >>> admin_for_my_other_db = admin_for_my_db.with_options(
+            ...     id="abababab-0101-2323-4545-6789abcdef01",
+            ... )
+        """
+
+        return self._copy(
+            id=id,
+            token=token,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
+    def set_caller(
+        self,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        """
+        Set a new identity for the application/framework on behalf of which
+        the DevOps API calls will be performed (the "caller").
+
+        New objects spawned from this client afterwards will inherit the new settings.
+
+        Args:
+            caller_name: name of the application, or framework, on behalf of which
+                the DevOps API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+
+        Example:
+            >>> admin_for_my_db.set_caller(
+            ...     caller_name="the_caller",
+            ...     caller_version="0.1.0",
+            ... )
+        """
+
+        logger.info(f"setting caller to {caller_name}/{caller_version}")
+        self._astra_db_admin.set_caller(caller_name, caller_version)
+
+    @staticmethod
+    def from_astra_db_admin(
+        id: str, *, astra_db_admin: AstraDBAdmin
+    ) -> AstraDBDatabaseAdmin:
+        """
+        Create an AstraDBDatabaseAdmin from an AstraDBAdmin and a database ID.
+
+        Args:
+            id: e. g. "01234567-89ab-cdef-0123-456789abcdef".
+            astra_db_admin: an AstraDBAdmin object that has visibility over
+                the target database.
+
+        Returns:
+            An AstraDBDatabaseAdmin object, for admin work within the database.
+
+        Example:
+            >>> from astrapy import DataAPIClient, AstraDBDatabaseAdmin
+            >>> admin_for_my_db = AstraDBDatabaseAdmin.from_astra_db_admin(
+            ...     id="01234567-...",
+            ...     astra_db_admin=DataAPIClient("AstraCS:...").get_admin(),
+            ... )
+            >>> admin_for_my_db.list_namespaces()
+            ['default_keyspace', 'staging_namespace']
+            >>> admin_for_my_db.info().status
+            'ACTIVE'
+
+        Note:
+            Creating an instance of AstraDBDatabaseAdmin does not trigger actual creation
+            of the database itself, which should exist beforehand. To create databases,
+            see the AstraDBAdmin class.
+        """
+
+        return AstraDBDatabaseAdmin(
+            id=id,
+            token=astra_db_admin.token,
+            environment=astra_db_admin.environment,
+            caller_name=astra_db_admin._caller_name,
+            caller_version=astra_db_admin._caller_version,
+            dev_ops_url=astra_db_admin._dev_ops_url,
+            dev_ops_api_version=astra_db_admin._dev_ops_api_version,
+        )
+
+    @staticmethod
+    def from_api_endpoint(
+        api_endpoint: str,
+        *,
+        token: str,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+        dev_ops_url: Optional[str] = None,
+        dev_ops_api_version: Optional[str] = None,
+    ) -> AstraDBDatabaseAdmin:
+        """
+        Create an AstraDBDatabaseAdmin from an API Endpoint and optionally a token.
+
+        Args:
+            api_endpoint: a full API endpoint for the Data Api.
+            token: an access token with enough permissions to do admin work.
+            caller_name: name of the application, or framework, on behalf of which
+                the DevOps API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+            dev_ops_url: in case of custom deployments, this can be used to specify
+                the URL to the DevOps API, such as "https://api.astra.datastax.com".
+                Generally it can be omitted. The environment (prod/dev/...) is
+                determined from the API Endpoint.
+            dev_ops_api_version: this can specify a custom version of the DevOps API
+                (such as "v2"). Generally not needed.
+
+        Returns:
+            An AstraDBDatabaseAdmin object, for admin work within the database.
+
+        Example:
+            >>> from astrapy import AstraDBDatabaseAdmin
+            >>> admin_for_my_db = AstraDBDatabaseAdmin.from_api_endpoint(
+            ...     api_endpoint="https://01234567-....apps.astra.datastax.com",
+            ...     token="AstraCS:...",
+            ... )
+            >>> admin_for_my_db.list_namespaces()
+            ['default_keyspace', 'another_namespace']
+            >>> admin_for_my_db.info().status
+            'ACTIVE'
+
+        Note:
+            Creating an instance of AstraDBDatabaseAdmin does not trigger actual creation
+            of the database itself, which should exist beforehand. To create databases,
+            see the AstraDBAdmin class.
+        """
+
+        parsed_api_endpoint = parse_api_endpoint(api_endpoint)
+        if parsed_api_endpoint:
+            return AstraDBDatabaseAdmin(
+                id=parsed_api_endpoint.database_id,
+                token=token,
+                environment=parsed_api_endpoint.environment,
+                caller_name=caller_name,
+                caller_version=caller_version,
+                dev_ops_url=dev_ops_url,
+                dev_ops_api_version=dev_ops_api_version,
+            )
+        else:
+            raise ValueError("Cannot parse the provided API endpoint.")
+
+    def info(self, *, max_time_ms: Optional[int] = None) -> AdminDatabaseInfo:
+        """
+        Query the DevOps API for the full info on this database.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the DevOps API request.
+
+        Returns:
+            An AdminDatabaseInfo object.
+
+        Example:
+            >>> my_db_info = admin_for_my_db.info()
+            >>> my_db_info.status
+            'ACTIVE'
+            >>> my_db_info.info.region
+            'us-east1'
+        """
+
+        logger.info(f"getting info ('{self.id}')")
+        req_response = self._astra_db_admin.database_info(
+            id=self.id,
+            max_time_ms=max_time_ms,
+        )
+        logger.info(f"finished getting info ('{self.id}')")
+        return req_response  # type: ignore[no-any-return]
+
+    async def async_info(
+        self, *, max_time_ms: Optional[int] = None
+    ) -> AdminDatabaseInfo:
+        """
+        Query the DevOps API for the full info on this database.
+        Async version of the method, for use in an asyncio context.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the DevOps API request.
+
+        Returns:
+            An AdminDatabaseInfo object.
+
+        Example:
+            >>> async def wait_until_active(db_admin: AstraDBDatabaseAdmin) -> None:
+            ...     while True:
+            ...         info = await db_admin.async_info()
+            ...         if info.status == "ACTIVE":
+            ...             return
+            ...
+            >>> asyncio.run(wait_until_active(admin_for_my_db))
+        """
+
+        logger.info(f"getting info ('{self.id}'), async")
+        req_response = await self._astra_db_admin.async_database_info(
+            id=self.id,
+            max_time_ms=max_time_ms,
+        )
+        logger.info(f"finished getting info ('{self.id}'), async")
+        return req_response  # type: ignore[no-any-return]
+
+    def list_namespaces(self, *, max_time_ms: Optional[int] = None) -> List[str]:
+        """
+        Query the DevOps API for a list of the namespaces in the database.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the DevOps API request.
+
+        Returns:
+            A list of the namespaces, each a string, in no particular order.
+
+        Example:
+            >>> admin_for_my_db.list_namespaces()
+            ['default_keyspace', 'staging_namespace']
+        """
+
+        logger.info(f"getting namespaces ('{self.id}')")
+        info = self.info(max_time_ms=max_time_ms)
+        logger.info(f"finished getting namespaces ('{self.id}')")
+        if info.raw_info is None:
+            raise DevOpsAPIException("Could not get the namespace list.")
+        else:
+            return info.raw_info["info"]["keyspaces"]  # type: ignore[no-any-return]
+
+    async def async_list_namespaces(
+        self, *, max_time_ms: Optional[int] = None
+    ) -> List[str]:
+        """
+        Query the DevOps API for a list of the namespaces in the database.
+        Async version of the method, for use in an asyncio context.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the DevOps API request.
+
+        Returns:
+            A list of the namespaces, each a string, in no particular order.
+
+        Example:
+            >>> async def check_if_ns_exists(
+            ...     db_admin: AstraDBDatabaseAdmin, namespace: str
+            ... ) -> bool:
+            ...     ns_list = await db_admin.async_list_namespaces()
+            ...     return namespace in ns_list
+            ...
+            >>> asyncio.run(check_if_ns_exists(admin_for_my_db, "dragons"))
+            False
+            >>> asyncio.run(check_if_db_exists(admin_for_my_db, "app_namespace"))
+            True
+        """
+
+        logger.info(f"getting namespaces ('{self.id}'), async")
+        info = await self.async_info(max_time_ms=max_time_ms)
+        logger.info(f"finished getting namespaces ('{self.id}'), async")
+        if info.raw_info is None:
+            raise DevOpsAPIException("Could not get the namespace list.")
+        else:
+            return info.raw_info["info"]["keyspaces"]  # type: ignore[no-any-return]
+
+    @ops_recast_method_sync
+    def create_namespace(
+        self,
+        name: str,
+        *,
+        wait_until_active: bool = True,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Create a namespace in this database as requested,
+        optionally waiting for it to be ready.
+
+        Args:
+            name: the namespace name. If supplying a namespace that exists
+                already, the method call proceeds as usual, no errors are
+                raised, and the whole invocation is a no-op.
+            wait_until_active: if True (default), the method returns only after
+                the target database is in ACTIVE state again (a few
+                seconds, usually). If False, it will return right after issuing the
+                creation request to the DevOps API, and it will be responsibility
+                of the caller to check the database status/namespace availability
+                before working with it.
+            max_time_ms: a timeout, in milliseconds, for the whole requested
+                operation to complete.
+                Note that a timeout is no guarantee that the creation request
+                has not reached the API server.
+
+        Returns:
+            A dictionary of the form {"ok": 1} in case of success.
+            Otherwise, an exception is raised.
+
+        Example:
+            >>> my_db_admin.list_namespaces()
+            ['default_keyspace']
+            >>> my_db_admin.create_namespace("that_other_one")
+            {'ok': 1}
+            >>> my_db_admin.list_namespaces()
+            ['default_keyspace', 'that_other_one']
+        """
+
+        timeout_manager = MultiCallTimeoutManager(
+            overall_max_time_ms=max_time_ms, exception_type="devops_api"
+        )
+        logger.info(f"creating namespace '{name}' on '{self.id}'")
+        cn_response = self._astra_db_admin._astra_db_ops.create_keyspace(
+            database=self.id,
+            keyspace=name,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(
+            f"devops api returned from creating namespace '{name}' on '{self.id}'"
+        )
+        if cn_response is not None and name == cn_response.get("name"):
+            if wait_until_active:
+                last_status_seen = STATUS_MAINTENANCE
+                while last_status_seen == STATUS_MAINTENANCE:
+                    logger.info(f"sleeping to poll for status of '{self.id}'")
+                    time.sleep(DATABASE_POLL_NAMESPACE_SLEEP_TIME)
+                    last_status_seen = self.info(
+                        max_time_ms=timeout_manager.remaining_timeout_ms(),
+                    ).status
+                if last_status_seen != STATUS_ACTIVE:
+                    raise DevOpsAPIException(
+                        f"Database entered unexpected status {last_status_seen} after MAINTENANCE."
+                    )
+                # is the namespace found?
+                if name not in self.list_namespaces():
+                    raise DevOpsAPIException("Could not create the namespace.")
+            logger.info(f"finished creating namespace '{name}' on '{self.id}'")
+            return {"ok": 1}
+        else:
+            raise DevOpsAPIException(
+                f"Could not issue a successful create-namespace DevOps API request for {name}."
+            )
+
+    # the 'override' is because the error-recast decorator washes out the signature
+    @ops_recast_method_async
+    async def async_create_namespace(  # type: ignore[override]
+        self,
+        name: str,
+        *,
+        wait_until_active: bool = True,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Create a namespace in this database as requested,
+        optionally waiting for it to be ready.
+        Async version of the method, for use in an asyncio context.
+
+        Args:
+            name: the namespace name. If supplying a namespace that exists
+                already, the method call proceeds as usual, no errors are
+                raised, and the whole invocation is a no-op.
+            wait_until_active: if True (default), the method returns only after
+                the target database is in ACTIVE state again (a few
+                seconds, usually). If False, it will return right after issuing the
+                creation request to the DevOps API, and it will be responsibility
+                of the caller to check the database status/namespace availability
+                before working with it.
+            max_time_ms: a timeout, in milliseconds, for the whole requested
+                operation to complete.
+                Note that a timeout is no guarantee that the creation request
+                has not reached the API server.
+
+        Returns:
+            A dictionary of the form {"ok": 1} in case of success.
+            Otherwise, an exception is raised.
+
+        Example:
+            >>> asyncio.run(
+            ...     my_db_admin.async_create_namespace("app_namespace")
+            ... )
+            {'ok': 1}
+        """
+
+        timeout_manager = MultiCallTimeoutManager(
+            overall_max_time_ms=max_time_ms, exception_type="devops_api"
+        )
+        logger.info(f"creating namespace '{name}' on '{self.id}', async")
+        cn_response = await self._astra_db_admin._astra_db_ops.async_create_keyspace(
+            database=self.id,
+            keyspace=name,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(
+            f"devops api returned from creating namespace "
+            f"'{name}' on '{self.id}', async"
+        )
+        if cn_response is not None and name == cn_response.get("name"):
+            if wait_until_active:
+                last_status_seen = STATUS_MAINTENANCE
+                while last_status_seen == STATUS_MAINTENANCE:
+                    logger.info(f"sleeping to poll for status of '{self.id}', async")
+                    await asyncio.sleep(DATABASE_POLL_NAMESPACE_SLEEP_TIME)
+                    last_db_info = await self.async_info(
+                        max_time_ms=timeout_manager.remaining_timeout_ms(),
+                    )
+                    last_status_seen = last_db_info.status
+                if last_status_seen != STATUS_ACTIVE:
+                    raise DevOpsAPIException(
+                        f"Database entered unexpected status {last_status_seen} after MAINTENANCE."
+                    )
+                # is the namespace found?
+                if name not in await self.async_list_namespaces():
+                    raise DevOpsAPIException("Could not create the namespace.")
+            logger.info(f"finished creating namespace '{name}' on '{self.id}', async")
+            return {"ok": 1}
+        else:
+            raise DevOpsAPIException(
+                f"Could not issue a successful create-namespace DevOps API request for {name}."
+            )
+
+    @ops_recast_method_sync
+    def drop_namespace(
+        self,
+        name: str,
+        *,
+        wait_until_active: bool = True,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Delete a namespace from the database, optionally waiting for it
+        to become active again.
+
+        Args:
+            name: the namespace to delete. If it does not exist in this database,
+                an error is raised.
+            wait_until_active: if True (default), the method returns only after
+                the target database is in ACTIVE state again (a few
+                seconds, usually). If False, it will return right after issuing the
+                deletion request to the DevOps API, and it will be responsibility
+                of the caller to check the database status/namespace availability
+                before working with it.
+            max_time_ms: a timeout, in milliseconds, for the whole requested
+                operation to complete.
+                Note that a timeout is no guarantee that the deletion request
+                has not reached the API server.
+
+        Returns:
+            A dictionary of the form {"ok": 1} in case of success.
+            Otherwise, an exception is raised.
+
+        Example:
+            >>> my_db_admin.list_namespaces()
+            ['default_keyspace', 'that_other_one']
+            >>> my_db_admin.drop_namespace("that_other_one")
+            {'ok': 1}
+            >>> my_db_admin.list_namespaces()
+            ['default_keyspace']
+        """
+
+        timeout_manager = MultiCallTimeoutManager(
+            overall_max_time_ms=max_time_ms, exception_type="devops_api"
+        )
+        logger.info(f"dropping namespace '{name}' on '{self.id}'")
+        dk_response = self._astra_db_admin._astra_db_ops.delete_keyspace(
+            database=self.id,
+            keyspace=name,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(
+            f"devops api returned from dropping namespace '{name}' on '{self.id}'"
+        )
+        if dk_response == name:
+            if wait_until_active:
+                last_status_seen = STATUS_MAINTENANCE
+                while last_status_seen == STATUS_MAINTENANCE:
+                    logger.info(f"sleeping to poll for status of '{self.id}'")
+                    time.sleep(DATABASE_POLL_NAMESPACE_SLEEP_TIME)
+                    last_status_seen = self.info(
+                        max_time_ms=timeout_manager.remaining_timeout_ms(),
+                    ).status
+                if last_status_seen != STATUS_ACTIVE:
+                    raise DevOpsAPIException(
+                        f"Database entered unexpected status {last_status_seen} after MAINTENANCE."
+                    )
+                # is the namespace found?
+                if name in self.list_namespaces():
+                    raise DevOpsAPIException("Could not drop the namespace.")
+            logger.info(f"finished dropping namespace '{name}' on '{self.id}'")
+            return {"ok": 1}
+        else:
+            raise DevOpsAPIException(
+                f"Could not issue a successful delete-namespace DevOps API request for {name}."
+            )
+
+    # the 'override' is because the error-recast decorator washes out the signature
+    @ops_recast_method_async
+    async def async_drop_namespace(  # type: ignore[override]
+        self,
+        name: str,
+        *,
+        wait_until_active: bool = True,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Delete a namespace from the database, optionally waiting for it
+        to become active again.
+        Async version of the method, for use in an asyncio context.
+
+        Args:
+            name: the namespace to delete. If it does not exist in this database,
+                an error is raised.
+            wait_until_active: if True (default), the method returns only after
+                the target database is in ACTIVE state again (a few
+                seconds, usually). If False, it will return right after issuing the
+                deletion request to the DevOps API, and it will be responsibility
+                of the caller to check the database status/namespace availability
+                before working with it.
+            max_time_ms: a timeout, in milliseconds, for the whole requested
+                operation to complete.
+                Note that a timeout is no guarantee that the deletion request
+                has not reached the API server.
+
+        Returns:
+            A dictionary of the form {"ok": 1} in case of success.
+            Otherwise, an exception is raised.
+
+        Example:
+            >>> asyncio.run(
+            ...     my_db_admin.async_drop_namespace("app_namespace")
+            ... )
+            {'ok': 1}
+        """
+
+        timeout_manager = MultiCallTimeoutManager(
+            overall_max_time_ms=max_time_ms, exception_type="devops_api"
+        )
+        logger.info(f"dropping namespace '{name}' on '{self.id}', async")
+        dk_response = await self._astra_db_admin._astra_db_ops.async_delete_keyspace(
+            database=self.id,
+            keyspace=name,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(
+            f"devops api returned from dropping namespace "
+            f"'{name}' on '{self.id}', async"
+        )
+        if dk_response == name:
+            if wait_until_active:
+                last_status_seen = STATUS_MAINTENANCE
+                while last_status_seen == STATUS_MAINTENANCE:
+                    logger.info(f"sleeping to poll for status of '{self.id}', async")
+                    await asyncio.sleep(DATABASE_POLL_NAMESPACE_SLEEP_TIME)
+                    last_db_info = await self.async_info(
+                        max_time_ms=timeout_manager.remaining_timeout_ms(),
+                    )
+                    last_status_seen = last_db_info.status
+                if last_status_seen != STATUS_ACTIVE:
+                    raise DevOpsAPIException(
+                        f"Database entered unexpected status {last_status_seen} after MAINTENANCE."
+                    )
+                # is the namespace found?
+                if name in await self.async_list_namespaces():
+                    raise DevOpsAPIException("Could not drop the namespace.")
+            logger.info(f"finished dropping namespace '{name}' on '{self.id}', async")
+            return {"ok": 1}
+        else:
+            raise DevOpsAPIException(
+                f"Could not issue a successful delete-namespace DevOps API request for {name}."
+            )
+
+    def drop(
+        self,
+        *,
+        wait_until_active: bool = True,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Drop this database, i.e. delete it completely and permanently with all its data.
+
+        This method wraps the `drop_database` method of the AstraDBAdmin class,
+        where more information may be found.
+
+        Args:
+            wait_until_active: if True (default), the method returns only after
+                the database has actually been deleted (generally a few minutes).
+                If False, it will return right after issuing the
+                drop request to the DevOps API, and it will be responsibility
+                of the caller to check the database status/availability
+                after that, if desired.
+            max_time_ms: a timeout, in milliseconds, for the whole requested
+                operation to complete.
+                Note that a timeout is no guarantee that the deletion request
+                has not reached the API server.
+
+        Returns:
+            A dictionary of the form {"ok": 1} in case of success.
+            Otherwise, an exception is raised.
+
+        Example:
+            >>> my_db_admin.list_namespaces()
+            ['default_keyspace', 'that_other_one']
+            >>> my_db_admin.drop()
+            {'ok': 1}
+            >>> my_db_admin.list_namespaces()  # raises a 404 Not Found http error
+
+        Note:
+            Once the method succeeds, methods on this object -- such as `info()`,
+            or `list_namespaces()` -- can still be invoked: however, this hardly
+            makes sense as the underlying actual database is no more.
+            It is responsibility of the developer to design a correct flow
+            which avoids using a deceased database any further.
+        """
+
+        logger.info(f"dropping this database ('{self.id}')")
+        return self._astra_db_admin.drop_database(  # type: ignore[no-any-return]
+            id=self.id,
+            wait_until_active=wait_until_active,
+            max_time_ms=max_time_ms,
+        )
+        logger.info(f"finished dropping this database ('{self.id}')")
+
+    async def async_drop(
+        self,
+        *,
+        wait_until_active: bool = True,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Drop this database, i.e. delete it completely and permanently with all its data.
+        Async version of the method, for use in an asyncio context.
+
+        This method wraps the `drop_database` method of the AstraDBAdmin class,
+        where more information may be found.
+
+        Args:
+            wait_until_active: if True (default), the method returns only after
+                the database has actually been deleted (generally a few minutes).
+                If False, it will return right after issuing the
+                drop request to the DevOps API, and it will be responsibility
+                of the caller to check the database status/availability
+                after that, if desired.
+            max_time_ms: a timeout, in milliseconds, for the whole requested
+                operation to complete.
+                Note that a timeout is no guarantee that the deletion request
+                has not reached the API server.
+
+        Returns:
+            A dictionary of the form {"ok": 1} in case of success.
+            Otherwise, an exception is raised.
+
+        Example:
+            >>> asyncio.run(my_db_admin.async_drop())
+            {'ok': 1}
+
+        Note:
+            Once the method succeeds, methods on this object -- such as `info()`,
+            or `list_namespaces()` -- can still be invoked: however, this hardly
+            makes sense as the underlying actual database is no more.
+            It is responsibility of the developer to design a correct flow
+            which avoids using a deceased database any further.
+        """
+
+        logger.info(f"dropping this database ('{self.id}'), async")
+        return await self._astra_db_admin.async_drop_database(  # type: ignore[no-any-return]
+            id=self.id,
+            wait_until_active=wait_until_active,
+            max_time_ms=max_time_ms,
+        )
+        logger.info(f"finished dropping this database ('{self.id}'), async")
+
+    def get_database(
+        self,
+        *,
+        token: Optional[str] = None,
+        namespace: Optional[str] = None,
+        region: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> Database:
+        """
+        Create a Database instance out of this class for working with the data in it.
+
+        Args:
+            token: if supplied, is passed to the Database instead of
+                the one set for this object. Useful if one wants to work in
+                a least-privilege manner, limiting the permissions for non-admin work.
+            namespace: an optional namespace to set in the resulting Database.
+                The same default logic as for `AstraDBAdmin.get_database` applies.
+            region: an optional region for connecting to the database Data API endpoint.
+                The same default logic as for `AstraDBAdmin.get_database` applies.
+            api_path: path to append to the API Endpoint. In typical usage, this
+                should be left to its default of "/api/json".
+            api_version: version specifier to append to the API path. In typical
+                usage, this should be left to its default of "v1".
+
+        Returns:
+            A Database object, ready to be used for working with data and collections.
+
+        Example:
+            >>> my_db = my_db_admin.get_database()
+            >>> my_db.list_collection_names()
+            ['movies', 'another_collection']
+
+        Note:
+            creating an instance of Database does not trigger actual creation
+            of the database itself, which should exist beforehand. To create databases,
+            see the AstraDBAdmin class.
+        """
+
+        return self._astra_db_admin.get_database(
+            id=self.id,
+            token=token,
+            namespace=namespace,
+            region=region,
+            api_path=api_path,
+            api_version=api_version,
+            max_time_ms=max_time_ms,
+        )
+
+    def get_async_database(
+        self,
+        *,
+        token: Optional[str] = None,
+        namespace: Optional[str] = None,
+        region: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> AsyncDatabase:
+        """
+        Create an AsyncDatabase instance out of this class for working
+        with the data in it.
+
+        This method has identical behavior and signature as the sync
+        counterpart `get_database`: please see that one for more details.
+        """
+
+        return self.get_database(
+            token=token,
+            namespace=namespace,
+            region=region,
+            api_path=api_path,
+            api_version=api_version,
+            max_time_ms=max_time_ms,
+        ).to_async()
diff --git a/llm/Lib/site-packages/astrapy/api/__init__.py b/llm/Lib/site-packages/astrapy/api/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e5941972aee789b5d64c097f2480996f789a5004
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/api/__init__.py
@@ -0,0 +1,22 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Core "api" subpackage, exported here to preserve import patterns."""
+
+from astrapy.core.api import APIRequestError
+
+
+__all__ = [
+    "APIRequestError",
+]
diff --git a/llm/Lib/site-packages/astrapy/api/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/astrapy/api/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0355a2b6bebd500dbc881cb79df1bf9f41032d5c
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/api/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/client.py b/llm/Lib/site-packages/astrapy/client.py
new file mode 100644
index 0000000000000000000000000000000000000000..573cf581d2b8c0b7fd81212f2cbaa97151b5da9b
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/client.py
@@ -0,0 +1,451 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import logging
+import re
+from typing import Any, Dict, Optional, TYPE_CHECKING
+
+from astrapy.admin import (
+    Environment,
+    api_endpoint_parser,
+    build_api_endpoint,
+    database_id_matcher,
+    fetch_raw_database_info_from_id_token,
+    parse_api_endpoint,
+)
+
+
+if TYPE_CHECKING:
+    from astrapy import AsyncDatabase, Database
+    from astrapy.admin import AstraDBAdmin
+
+
+logger = logging.getLogger(__name__)
+
+
+class DataAPIClient:
+    """
+    A client for using the Data API. This is the main entry point and sits
+    at the top of the conceptual "client -> database -> collection" hierarchy.
+
+    The client is created by passing a suitable Access Token. Starting from the
+    client:
+        - databases (Database and AsyncDatabase) are created for working with data
+        - AstraDBAdmin objects can be created for admin-level work
+
+    Args:
+        token: an Access Token to the database. Example: `"AstraCS:xyz..."`.
+        environment: a string representing the target Astra environment.
+            It can be left unspecified for the default value of `Environment.PROD`;
+            other values are `Environment.DEV` and `Environment.TEST`.
+        caller_name: name of the application, or framework, on behalf of which
+            the Data API and DevOps API calls are performed. This ends up in
+            the request user-agent.
+        caller_version: version of the caller.
+
+    Example:
+        >>> from astrapy import DataAPIClient
+        >>> my_client = DataAPIClient("AstraCS:...")
+        >>> my_db0 = my_client.get_database_by_api_endpoint(
+        ...     "https://01234567-....apps.astra.datastax.com"
+        ... )
+        >>> my_coll = my_db0.create_collection("movies", dimension=512)
+        >>> my_coll.insert_one({"title": "The Title"}, vector=...)
+        >>> my_db1 = my_client.get_database("01234567-...")
+        >>> my_db2 = my_client.get_database("01234567-...", region="us-east1")
+        >>> my_adm0 = my_client.get_admin()
+        >>> my_adm1 = my_client.get_admin(token=more_powerful_token_override)
+        >>> database_list = my_adm0.list_databases()
+    """
+
+    def __init__(
+        self,
+        token: str,
+        *,
+        environment: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        self.token = token
+        self.environment = environment or Environment.PROD
+        self._caller_name = caller_name
+        self._caller_version = caller_version
+
+    def __repr__(self) -> str:
+        env_desc: str
+        if self.environment == Environment.PROD:
+            env_desc = ""
+        else:
+            env_desc = f', environment="{self.environment}"'
+        return f'{self.__class__.__name__}("{self.token[:12]}..."{env_desc})'
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, DataAPIClient):
+            return all(
+                [
+                    self.token == other.token,
+                    self.environment == other.environment,
+                    self._caller_name == other._caller_name,
+                    self._caller_version == other._caller_version,
+                ]
+            )
+        else:
+            return False
+
+    def __getitem__(self, database_id_or_api_endpoint: str) -> Database:
+        if re.match(database_id_matcher, database_id_or_api_endpoint):
+            return self.get_database(database_id_or_api_endpoint)
+        elif re.match(api_endpoint_parser, database_id_or_api_endpoint):
+            return self.get_database_by_api_endpoint(database_id_or_api_endpoint)
+        else:
+            raise ValueError(
+                "The provided input does not look like either a database ID "
+                f"or an API endpoint ('{database_id_or_api_endpoint}')."
+            )
+
+    def _copy(
+        self,
+        *,
+        token: Optional[str] = None,
+        environment: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> DataAPIClient:
+        return DataAPIClient(
+            token=token or self.token,
+            environment=environment or self.environment,
+            caller_name=caller_name or self._caller_name,
+            caller_version=caller_version or self._caller_version,
+        )
+
+    def with_options(
+        self,
+        *,
+        token: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> DataAPIClient:
+        """
+        Create a clone of this DataAPIClient with some changed attributes.
+
+        Args:
+            token: an Access Token to the database. Example: `"AstraCS:xyz..."`.
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API and DevOps API calls are performed. This ends up in
+                the request user-agent.
+            caller_version: version of the caller.
+
+        Returns:
+            a new DataAPIClient instance.
+
+        Example:
+            >>> another_client = my_client.with_options(
+            ...     caller_name="caller_identity",
+            ...     caller_version="1.2.0",
+            ... )
+        """
+
+        return self._copy(
+            token=token,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
+    def set_caller(
+        self,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        """
+        Set a new identity for the application/framework on behalf of which
+        the API calls will be performed (the "caller").
+
+        New objects spawned from this client afterwards will inherit the new settings.
+
+        Args:
+            caller_name: name of the application, or framework, on behalf of which
+                the API API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+
+        Example:
+            >>> my_client.set_caller(caller_name="the_caller", caller_version="0.1.0")
+        """
+
+        logger.info(f"setting caller to {caller_name}/{caller_version}")
+        self._caller_name = caller_name
+        self._caller_version = caller_version
+
+    def get_database(
+        self,
+        id: str,
+        *,
+        token: Optional[str] = None,
+        namespace: Optional[str] = None,
+        region: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> Database:
+        """
+        Get a Database object from this client, for doing data-related work.
+
+        Args:
+            id: the target database ID. The database must exist for the resulting
+                object to be effectively used; in other words, this invocation
+                does not create the database, just the object instance.
+                Actual admin work can be achieved by using the AstraDBAdmin object.
+            token: if supplied, is passed to the Database instead of the client token.
+            namespace: if provided, is passed to the Database
+                (it is left to the default otherwise).
+            region: the region to use for connecting to the database. The
+                database must be located in that region.
+                Note that if this parameter is not passed, an additional
+                DevOps API request is made to determine the default region
+                and use it subsequently.
+            api_path: path to append to the API Endpoint. In typical usage, this
+                should be left to its default of "/api/json".
+            api_version: version specifier to append to the API path. In typical
+                usage, this should be left to its default of "v1".
+            max_time_ms: a timeout, in milliseconds, for the DevOps API
+                HTTP request should it be necessary (see the `region` argument).
+
+        Returns:
+            a Database object with which to work on Data API collections.
+
+        Example:
+            >>> my_db0 = my_client.get_database("01234567-...")
+            >>> my_db1 = my_client.get_database("01234567-...", token="AstraCS:...")
+            >>> my_db2 = my_client.get_database("01234567-...", region="us-west1")
+            >>> my_coll = my_db0.create_collection("movies", dimension=512)
+            >>> my_coll.insert_one({"title": "The Title"}, vector=...)
+
+        Note:
+            This method does not perform any admin-level operation through
+            the DevOps API. For actual creation of a database, see the
+            `create_database` method of class AstraDBAdmin.
+        """
+
+        # lazy importing here to avoid circular dependency
+        from astrapy import Database
+
+        # need to inspect for values?
+        this_db_info: Optional[Dict[str, Any]] = None
+        # handle overrides. Only region is needed (namespace can stay empty)
+        if region:
+            _region = region
+        else:
+            if this_db_info is None:
+                logger.info(f"fetching raw database info for {id}")
+                this_db_info = fetch_raw_database_info_from_id_token(
+                    id=id,
+                    token=self.token,
+                    environment=self.environment,
+                    max_time_ms=max_time_ms,
+                )
+                logger.info(f"finished fetching raw database info for {id}")
+            _region = this_db_info["info"]["region"]
+
+        _token = token or self.token
+        _api_endpoint = build_api_endpoint(
+            environment=self.environment,
+            database_id=id,
+            region=_region,
+        )
+        return Database(
+            api_endpoint=_api_endpoint,
+            token=_token,
+            namespace=namespace,
+            caller_name=self._caller_name,
+            caller_version=self._caller_version,
+            api_path=api_path,
+            api_version=api_version,
+        )
+
+    def get_async_database(
+        self,
+        id: str,
+        *,
+        token: Optional[str] = None,
+        namespace: Optional[str] = None,
+        region: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> AsyncDatabase:
+        """
+        Get an AsyncDatabase object from this client.
+
+        This method has identical behavior and signature as the sync
+        counterpart `get_database`: please see that one for more details.
+        """
+
+        return self.get_database(
+            id=id,
+            token=token,
+            namespace=namespace,
+            region=region,
+            api_path=api_path,
+            api_version=api_version,
+            max_time_ms=max_time_ms,
+        ).to_async()
+
+    def get_database_by_api_endpoint(
+        self,
+        api_endpoint: str,
+        *,
+        token: Optional[str] = None,
+        namespace: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+    ) -> Database:
+        """
+        Get a Database object from this client, for doing data-related work.
+        The Database is specified by an API Endpoint instead of the ID and a region.
+
+        Args:
+            api_endpoint: the full "API Endpoint" string used to reach the Data API.
+                Example: "https://DATABASE_ID-REGION.apps.astra.datastax.com"
+            token: if supplied, is passed to the Database instead of the client token.
+            namespace: if provided, is passed to the Database
+                (it is left to the default otherwise).
+            api_path: path to append to the API Endpoint. In typical usage, this
+                should be left to its default of "/api/json".
+            api_version: version specifier to append to the API path. In typical
+                usage, this should be left to its default of "v1".
+
+        Returns:
+            a Database object with which to work on Data API collections.
+
+        Example:
+            >>> my_db0 = my_client.get_database_by_api_endpoint("01234567-...")
+            >>> my_db1 = my_client.get_database_by_api_endpoint(
+            ...     "https://01234567-....apps.astra.datastax.com",
+            ...     token="AstraCS:...",
+            ... )
+            >>> my_db2 = my_client.get_database_by_api_endpoint(
+            ...     "https://01234567-....apps.astra.datastax.com",
+            ...     namespace="the_other_namespace",
+            ... )
+            >>> my_coll = my_db0.create_collection("movies", dimension=512)
+            >>> my_coll.insert_one({"title": "The Title"}, vector=...)
+
+        Note:
+            This method does not perform any admin-level operation through
+            the DevOps API. For actual creation of a database, see the
+            `create_database` method of class AstraDBAdmin.
+        """
+
+        # lazy importing here to avoid circular dependency
+        from astrapy import Database
+
+        parsed_api_endpoint = parse_api_endpoint(api_endpoint)
+        if parsed_api_endpoint is not None:
+            if parsed_api_endpoint.environment != self.environment:
+                raise ValueError(
+                    "Environment mismatch between client and provided "
+                    "API endpoint. You can try adding "
+                    f'`environment="{parsed_api_endpoint.environment}"` '
+                    "to the DataAPIClient creation statement."
+                )
+            _token = token or self.token
+            return Database(
+                api_endpoint=api_endpoint,
+                token=_token,
+                namespace=namespace,
+                caller_name=self._caller_name,
+                caller_version=self._caller_version,
+                api_path=api_path,
+                api_version=api_version,
+            )
+        else:
+            raise ValueError("Cannot parse the provided API endpoint.")
+
+    def get_async_database_by_api_endpoint(
+        self,
+        api_endpoint: str,
+        *,
+        token: Optional[str] = None,
+        namespace: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+    ) -> AsyncDatabase:
+        """
+        Get an AsyncDatabase object from this client, for doing data-related work.
+        The Database is specified by an API Endpoint instead of the ID and a region.
+
+        This method has identical behavior and signature as the sync
+        counterpart `get_database_by_api_endpoint`: please see that one
+        for more details.
+        """
+
+        return self.get_database_by_api_endpoint(
+            api_endpoint=api_endpoint,
+            token=token,
+            namespace=namespace,
+            api_path=api_path,
+            api_version=api_version,
+        ).to_async()
+
+    def get_admin(
+        self,
+        *,
+        token: Optional[str] = None,
+        dev_ops_url: Optional[str] = None,
+        dev_ops_api_version: Optional[str] = None,
+    ) -> AstraDBAdmin:
+        """
+        Get an AstraDBAdmin instance corresponding to this client, for
+        admin work such as managing databases.
+
+        Args:
+            token: if supplied, is passed to the Astra DB Admin instead of the
+                client token. This may be useful when switching to a more powerful,
+                admin-capable permission set.
+            dev_ops_url: in case of custom deployments, this can be used to specify
+                the URL to the DevOps API, such as "https://api.astra.datastax.com".
+                Generally it can be omitted. The environment (prod/dev/...) is
+                determined from the API Endpoint.
+            dev_ops_api_version: this can specify a custom version of the DevOps API
+                (such as "v2"). Generally not needed.
+
+        Returns:
+            An AstraDBAdmin instance, wich which to perform management at the
+            database level.
+
+        Example:
+            >>> my_adm0 = my_client.get_admin()
+            >>> my_adm1 = my_client.get_admin(token=more_powerful_token_override)
+            >>> database_list = my_adm0.list_databases()
+            >>> my_db_admin = my_adm0.create_database(
+            ...     "the_other_database",
+            ...     cloud_provider="AWS",
+            ...     region="eu-west-1",
+            ... )
+            >>> my_db_admin.list_namespaces()
+            ['default_keyspace', 'that_other_one']
+        """
+
+        # lazy importing here to avoid circular dependency
+        from astrapy.admin import AstraDBAdmin
+
+        return AstraDBAdmin(
+            token=token or self.token,
+            environment=self.environment,
+            caller_name=self._caller_name,
+            caller_version=self._caller_version,
+            dev_ops_url=dev_ops_url,
+            dev_ops_api_version=dev_ops_api_version,
+        )
diff --git a/llm/Lib/site-packages/astrapy/collection.py b/llm/Lib/site-packages/astrapy/collection.py
new file mode 100644
index 0000000000000000000000000000000000000000..53fa78e2602ff57c2d493fedbc4a4a1481bc03fc
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/collection.py
@@ -0,0 +1,4765 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import asyncio
+import json
+import logging
+from concurrent.futures import ThreadPoolExecutor
+from typing import Any, Dict, Iterable, List, Optional, Tuple, Union, TYPE_CHECKING
+
+from astrapy.core.db import (
+    AstraDBCollection,
+    AsyncAstraDBCollection,
+)
+from astrapy.core.defaults import MAX_INSERT_NUM_DOCUMENTS
+from astrapy.exceptions import (
+    BulkWriteException,
+    CollectionNotFoundException,
+    CumulativeOperationException,
+    DataAPIFaultyResponseException,
+    DataAPIResponseException,
+    DeleteManyException,
+    InsertManyException,
+    MultiCallTimeoutManager,
+    TooManyDocumentsToCountException,
+    UpdateManyException,
+    recast_method_sync,
+    recast_method_async,
+    base_timeout_info,
+)
+from astrapy.constants import (
+    DocumentType,
+    FilterType,
+    ProjectionType,
+    ReturnDocument,
+    SortType,
+    VectorType,
+    normalize_optional_projection,
+)
+from astrapy.database import AsyncDatabase, Database
+from astrapy.results import (
+    DeleteResult,
+    InsertManyResult,
+    InsertOneResult,
+    UpdateResult,
+    BulkWriteResult,
+)
+from astrapy.cursors import AsyncCursor, Cursor
+from astrapy.info import CollectionInfo, CollectionOptions
+
+
+if TYPE_CHECKING:
+    from astrapy.operations import AsyncBaseOperation, BaseOperation
+
+
+logger = logging.getLogger(__name__)
+
+
+DEFAULT_INSERT_MANY_CONCURRENCY = 20
+DEFAULT_BULK_WRITE_CONCURRENCY = 10
+
+
+def _prepare_update_info(statuses: List[Dict[str, Any]]) -> Dict[str, Any]:
+    reduced_status = {
+        "matchedCount": sum(
+            status["matchedCount"] for status in statuses if "matchedCount" in status
+        ),
+        "modifiedCount": sum(
+            status["modifiedCount"] for status in statuses if "modifiedCount" in status
+        ),
+        "upsertedId": [
+            status["upsertedId"] for status in statuses if "upsertedId" in status
+        ],
+    }
+    if reduced_status["upsertedId"]:
+        if len(reduced_status["upsertedId"]) == 1:
+            ups_dict = {"upserted": reduced_status["upsertedId"][0]}
+        else:
+            ups_dict = {"upserteds": reduced_status["upsertedId"]}
+    else:
+        ups_dict = {}
+    return {
+        **{
+            "n": reduced_status["matchedCount"] + len(reduced_status["upsertedId"]),
+            "updatedExisting": reduced_status["modifiedCount"] > 0,
+            "ok": 1.0,
+            "nModified": reduced_status["modifiedCount"],
+        },
+        **ups_dict,
+    }
+
+
+def _collate_vector_to_sort(
+    sort: Optional[SortType],
+    vector: Optional[VectorType],
+    vectorize: Optional[str],
+) -> Optional[SortType]:
+    _vsort: Dict[str, Any]
+    if vector is None:
+        if vectorize is None:
+            return sort
+        else:
+            _vsort = {"$vectorize": vectorize}
+            if sort is None:
+                return _vsort
+            else:
+                raise ValueError(
+                    "The `vectorize` and `sort` clauses are mutually exclusive."
+                )
+    else:
+        if vectorize is None:
+            _vsort = {"$vector": vector}
+            if sort is None:
+                return _vsort
+            else:
+                raise ValueError(
+                    "The `vector` and `sort` clauses are mutually exclusive."
+                )
+        else:
+            raise ValueError(
+                "The `vector` and `vectorize` parameters cannot be passed at the same time."
+            )
+
+
+def _is_vector_sort(sort: Optional[SortType]) -> bool:
+    if sort is None:
+        return False
+    else:
+        return "$vector" in sort or "$vectorize" in sort
+
+
+def _collate_vector_to_document(
+    document0: DocumentType, vector: Optional[VectorType], vectorize: Optional[str]
+) -> DocumentType:
+    if vector is None:
+        if vectorize is None:
+            return document0
+        else:
+            if "$vectorize" in document0:
+                raise ValueError(
+                    "Cannot specify the `vectorize` separately for a document with "
+                    "its '$vectorize' field already."
+                )
+            else:
+                return {
+                    **document0,
+                    **{"$vectorize": vectorize},
+                }
+    else:
+        if vectorize is None:
+            if "$vector" in document0:
+                raise ValueError(
+                    "Cannot specify the `vector` separately for a document with "
+                    "its '$vector' field already."
+                )
+            else:
+                return {
+                    **document0,
+                    **{"$vector": vector},
+                }
+        else:
+            raise ValueError(
+                "The `vector` and `vectorize` parameters cannot be passed at the same time."
+            )
+
+
+def _collate_vectors_to_documents(
+    documents: Iterable[DocumentType],
+    vectors: Optional[Iterable[Optional[VectorType]]],
+    vectorize: Optional[Iterable[Optional[str]]],
+) -> List[DocumentType]:
+    if vectors is None and vectorize is None:
+        return list(documents)
+    else:
+        _documents = list(documents)
+        _ndocs = len(_documents)
+        _vectors = list(vectors) if vectors else [None] * _ndocs
+        _vectorize = list(vectorize) if vectorize else [None] * _ndocs
+        if _ndocs != len(_vectors):
+            raise ValueError(
+                "The `documents` and `vectors` parameters must have the same length"
+            )
+        elif _ndocs != len(_vectorize):
+            raise ValueError(
+                "The `documents` and `vectorize` parameters must have the same length"
+            )
+        return [
+            _collate_vector_to_document(_doc, _vec, _vecize)
+            for _doc, _vec, _vecize in zip(_documents, _vectors, _vectorize)
+        ]
+
+
+class Collection:
+    """
+    A Data API collection, the main object to interact with the Data API,
+    especially for DDL operations.
+    This class has a synchronous interface.
+
+    A Collection is spawned from a Database object, from which it inherits
+    the details on how to reach the API server (endpoint, authentication token).
+
+    Args:
+        database: a Database object, instantiated earlier. This represents
+            the database the collection belongs to.
+        name: the collection name. This parameter should match an existing
+            collection on the database.
+        namespace: this is the namespace to which the collection belongs.
+            If not specified, the database's working namespace is used.
+        caller_name: name of the application, or framework, on behalf of which
+            the Data API calls are performed. This ends up in the request user-agent.
+        caller_version: version of the caller.
+
+    Examples:
+        >>> from astrapy import DataAPIClient, Collection
+        >>> my_client = astrapy.DataAPIClient("AstraCS:...")
+        >>> my_db = my_client.get_database_by_api_endpoint(
+        ...    "https://01234567-....apps.astra.datastax.com"
+        ... )
+        >>> my_coll_1 = Collection(database=my_db, name="my_collection")
+        >>> my_coll_2 = my_db.create_collection(
+        ...     "my_v_collection",
+        ...     dimension=3,
+        ...     metric="cosine",
+        ... )
+        >>> my_coll_3a = my_db.get_collection("my_already_existing_collection")
+        >>> my_coll_3b = my_db.my_already_existing_collection
+        >>> my_coll_3c = my_db["my_already_existing_collection"]
+
+    Note:
+        creating an instance of Collection does not trigger actual creation
+        of the collection on the database. The latter should have been created
+        beforehand, e.g. through the `create_collection` method of a Database.
+    """
+
+    def __init__(
+        self,
+        database: Database,
+        name: str,
+        *,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        self._astra_db_collection: AstraDBCollection = AstraDBCollection(
+            collection_name=name,
+            astra_db=database._astra_db,
+            namespace=namespace,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+        # this comes after the above, lets AstraDBCollection resolve namespace
+        self._database = database._copy(
+            namespace=self._astra_db_collection.astra_db.namespace
+        )
+
+    def __repr__(self) -> str:
+        return (
+            f'{self.__class__.__name__}(name="{self.name}", '
+            f'namespace="{self.namespace}", database={self.database})'
+        )
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, Collection):
+            return self._astra_db_collection == other._astra_db_collection
+        else:
+            return False
+
+    def __call__(self, *pargs: Any, **kwargs: Any) -> None:
+        raise TypeError(
+            f"'{self.__class__.__name__}' object is not callable. If you "
+            f"meant to call the '{self.name}' method on a "
+            f"'{self.database.__class__.__name__}' object "
+            "it is failing because no such method exists."
+        )
+
+    def _copy(
+        self,
+        *,
+        database: Optional[Database] = None,
+        name: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> Collection:
+        return Collection(
+            database=database or self.database._copy(),
+            name=name or self.name,
+            namespace=namespace or self.namespace,
+            caller_name=caller_name or self._astra_db_collection.caller_name,
+            caller_version=caller_version or self._astra_db_collection.caller_version,
+        )
+
+    def with_options(
+        self,
+        *,
+        name: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> Collection:
+        """
+        Create a clone of this collection with some changed attributes.
+
+        Args:
+            name: the name of the collection. This parameter is useful to
+                quickly spawn Collection instances each pointing to a different
+                collection existing in the same namespace.
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+
+        Returns:
+            a new Collection instance.
+
+        Example:
+            >>> my_other_coll = my_coll.with_options(
+            ...     name="the_other_coll",
+            ...     caller_name="caller_identity",
+            ... )
+        """
+
+        return self._copy(
+            name=name,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
+    def to_async(
+        self,
+        *,
+        database: Optional[AsyncDatabase] = None,
+        name: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> AsyncCollection:
+        """
+        Create an AsyncCollection from this one. Save for the arguments
+        explicitly provided as overrides, everything else is kept identical
+        to this collection in the copy (the database is converted into
+        an async object).
+
+        Args:
+            database: an AsyncDatabase object, instantiated earlier.
+                This represents the database the new collection belongs to.
+            name: the collection name. This parameter should match an existing
+                collection on the database.
+            namespace: this is the namespace to which the collection belongs.
+                If not specified, the database's working namespace is used.
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+
+        Returns:
+            the new copy, an AsyncCollection instance.
+
+        Example:
+            >>> asyncio.run(my_coll.to_async().count_documents({},upper_bound=100))
+            77
+        """
+
+        return AsyncCollection(
+            database=database or self.database.to_async(),
+            name=name or self.name,
+            namespace=namespace or self.namespace,
+            caller_name=caller_name or self._astra_db_collection.caller_name,
+            caller_version=caller_version or self._astra_db_collection.caller_version,
+        )
+
+    def set_caller(
+        self,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        """
+        Set a new identity for the application/framework on behalf of which
+        the Data API calls are performed (the "caller").
+
+        Args:
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+
+        Example:
+            >>> my_coll.set_caller(caller_name="the_caller", caller_version="0.1.0")
+        """
+
+        logger.info(f"setting caller to {caller_name}/{caller_version}")
+        self._astra_db_collection.set_caller(
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
+    def options(self, *, max_time_ms: Optional[int] = None) -> CollectionOptions:
+        """
+        Get the collection options, i.e. its configuration as read from the database.
+
+        The method issues a request to the Data API each time is invoked,
+        without caching mechanisms: this ensures up-to-date information
+        for usages such as real-time collection validation by the application.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a CollectionOptions instance describing the collection.
+            (See also the database `list_collections` method.)
+
+        Example:
+            >>> my_coll.options()
+            CollectionOptions(vector=CollectionVectorOptions(dimension=3, metric='cosine'))
+        """
+
+        logger.info(f"getting collections in search of '{self.name}'")
+        self_descriptors = [
+            coll_desc
+            for coll_desc in self.database.list_collections(max_time_ms=max_time_ms)
+            if coll_desc.name == self.name
+        ]
+        logger.info(f"finished getting collections in search of '{self.name}'")
+        if self_descriptors:
+            return self_descriptors[0].options  # type: ignore[no-any-return]
+        else:
+            raise CollectionNotFoundException(
+                text=f"Collection {self.namespace}.{self.name} not found.",
+                namespace=self.namespace,
+                collection_name=self.name,
+            )
+
+    def info(self) -> CollectionInfo:
+        """
+        Information on the collection (name, location, database), in the
+        form of a CollectionInfo object.
+
+        Not to be confused with the collection `options` method (related
+        to the collection internal configuration).
+
+        Example:
+            >>> my_coll.info().database_info.region
+            'eu-west-1'
+            >>> my_coll.info().full_name
+            'default_keyspace.my_v_collection'
+
+        Note:
+            the returned CollectionInfo wraps, among other things,
+            the database information: as such, calling this method
+            triggers the same-named method of a Database object (which, in turn,
+            performs a HTTP request to the DevOps API).
+            See the documentation for `Database.info()` for more details.
+        """
+
+        return CollectionInfo(
+            database_info=self.database.info(),
+            namespace=self.namespace,
+            name=self.name,
+            full_name=self.full_name,
+        )
+
+    @property
+    def database(self) -> Database:
+        """
+        a Database object, the database this collection belongs to.
+
+        Example:
+            >>> my_coll.database.name
+            'the_application_database'
+        """
+
+        return self._database
+
+    @property
+    def namespace(self) -> str:
+        """
+        The namespace this collection is in.
+
+        Example:
+            >>> my_coll.namespace
+            'default_keyspace'
+        """
+
+        return self.database.namespace
+
+    @property
+    def name(self) -> str:
+        """
+        The name of this collection.
+
+        Example:
+            >>> my_coll.name
+            'my_v_collection'
+        """
+
+        # type hint added as for some reason the typechecker gets lost
+        return self._astra_db_collection.collection_name  # type: ignore[no-any-return, has-type]
+
+    @property
+    def full_name(self) -> str:
+        """
+        The fully-qualified collection name within the database,
+        in the form "namespace.collection_name".
+
+        Example:
+            >>> my_coll.full_name
+            'default_keyspace.my_v_collection'
+        """
+
+        return f"{self.namespace}.{self.name}"
+
+    @recast_method_sync
+    def insert_one(
+        self,
+        document: DocumentType,
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> InsertOneResult:
+        """
+        Insert a single document in the collection in an atomic operation.
+
+        Args:
+            document: the dictionary expressing the document to insert.
+                The `_id` field of the document can be left out, in which
+                case it will be created automatically.
+            vector: a vector (a list of numbers appropriate for the collection)
+                for the document. Passing this parameter is equivalent to
+                providing the vector in the "$vector" field of the document itself,
+                however the two are mutually exclusive.
+            vectorize: a string to be made into a vector, if such a service
+                is configured for the collection. Passing this parameter is
+                equivalent to providing a `$vectorize` field in the document itself,
+                however the two are mutually exclusive.
+                Moreover, this parameter cannot coexist with `vector`.
+                NOTE: This feature is under current development.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            an InsertOneResult object.
+
+        Examples:
+            >>> my_coll.count_documents({}, upper_bound=10)
+            0
+            >>> my_coll.insert_one(
+            ...     {
+            ...         "age": 30,
+            ...         "name": "Smith",
+            ...         "food": ["pear", "peach"],
+            ...         "likes_fruit": True,
+            ...     },
+            ... )
+            InsertOneResult(raw_results=..., inserted_id='ed4587a4-...-...-...')
+            >>> my_coll.insert_one({"_id": "user-123", "age": 50, "name": "Maccio"})
+            InsertOneResult(raw_results=..., inserted_id='user-123')
+            >>> my_coll.count_documents({}, upper_bound=10)
+            2
+
+            >>> my_coll.insert_one({"tag": v"}, vector=[10, 11])
+            InsertOneResult(...)
+
+        Note:
+            If an `_id` is explicitly provided, which corresponds to a document
+            that exists already in the collection, an error is raised and
+            the insertion fails.
+        """
+
+        _document = _collate_vector_to_document(document, vector, vectorize)
+        logger.info(f"inserting one document in '{self.name}'")
+        io_response = self._astra_db_collection.insert_one(
+            _document,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished inserting one document in '{self.name}'")
+        if "insertedIds" in io_response.get("status", {}):
+            if io_response["status"]["insertedIds"]:
+                inserted_id = io_response["status"]["insertedIds"][0]
+                return InsertOneResult(
+                    raw_results=[io_response],
+                    inserted_id=inserted_id,
+                )
+            else:
+                raise DataAPIFaultyResponseException(
+                    text="Faulty response from insert_one API command.",
+                    raw_response=io_response,
+                )
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from insert_one API command.",
+                raw_response=io_response,
+            )
+
+    @recast_method_sync
+    def insert_many(
+        self,
+        documents: Iterable[DocumentType],
+        *,
+        vectors: Optional[Iterable[Optional[VectorType]]] = None,
+        vectorize: Optional[Iterable[Optional[str]]] = None,
+        ordered: bool = True,
+        chunk_size: Optional[int] = None,
+        concurrency: Optional[int] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> InsertManyResult:
+        """
+        Insert a list of documents into the collection.
+        This is not an atomic operation.
+
+        Args:
+            documents: an iterable of dictionaries, each a document to insert.
+                Documents may specify their `_id` field or leave it out, in which
+                case it will be added automatically.
+            vectors: an optional list of vectors (as many vectors as the provided
+                documents) to associate to the documents when inserting.
+                Each vector is added to the corresponding document prior to
+                insertion on database. The list can be a mixture of None and vectors,
+                in which case some documents will not have a vector, unless it is
+                specified in their "$vector" field already.
+                Passing vectors this way is indeed equivalent to the "$vector" field
+                of the documents, however the two are mutually exclusive.
+            vectorize: an optional list of strings to be made into as many vectors
+                (one per document), if such a service is configured for the collection.
+                Passing this parameter is equivalent to providing a `$vectorize`
+                field in the documents themselves, however the two are mutually exclusive.
+                For any given document, this parameter cannot coexist with the
+                corresponding `vector` entry.
+                NOTE: This feature is under current development.
+            ordered: if True (default), the insertions are processed sequentially.
+                If False, they can occur in arbitrary order and possibly concurrently.
+            chunk_size: how many documents to include in a single API request.
+                Exceeding the server maximum allowed value results in an error.
+                Leave it unspecified (recommended) to use the system default.
+            concurrency: maximum number of concurrent requests to the API at
+                a given time. It cannot be more than one for ordered insertions.
+            max_time_ms: a timeout, in milliseconds, for the operation.
+
+        Returns:
+            an InsertManyResult object.
+
+        Examples:
+            >>> my_coll.count_documents({}, upper_bound=10)
+            0
+            >>> my_coll.insert_many([{"a": 10}, {"a": 5}, {"b": [True, False, False]}])
+            InsertManyResult(raw_results=..., inserted_ids=['184bb06f-...', '...', '...'])
+            >>> my_coll.count_documents({}, upper_bound=100)
+            3
+            >>> my_coll.insert_many(
+            ...     [{"seq": i} for i in range(50)],
+            ...     ordered=False,
+            ...     concurrency=5,
+            ... )
+            InsertManyResult(raw_results=..., inserted_ids=[... ...])
+            >>> my_coll.count_documents({}, upper_bound=100)
+            53
+
+            # The following are three equivalent statements:
+            >>> my_coll.insert_many(
+            ...     [{"tag": "a"}, {"tag": "b"}],
+            ...     vectors=[[1, 2], [3, 4]],
+            ... )
+            InsertManyResult(...)
+            >>> my_coll.insert_many(
+            ...     [{"tag": "a", "$vector": [1, 2]}, {"tag": "b"}],
+            ...     vectors=[None, [3, 4]],
+            ... )
+            InsertManyResult(...)
+            >>> my_coll.insert_many(
+            ...     [
+            ...         {"tag": "a", "$vector": [1, 2]},
+            ...         {"tag": "b", "$vector": [3, 4]},
+            ...     ]
+            ... )
+            InsertManyResult(...)
+
+        Note:
+            Unordered insertions are executed with some degree of concurrency,
+            so it is usually better to prefer this mode unless the order in the
+            document sequence is important.
+
+        Note:
+            A failure mode for this command is related to certain faulty documents
+            found among those to insert: a document may have the an `_id` already
+            present on the collection, or its vector dimension may not
+            match the collection setting.
+
+            For an ordered insertion, the method will raise an exception at
+            the first such faulty document -- nevertheless, all documents processed
+            until then will end up being written to the database.
+
+            For unordered insertions, if the error stems from faulty documents
+            the insertion proceeds until exhausting the input documents: then,
+            an exception is raised -- and all insertable documents will have been
+            written to the database, including those "after" the troublesome ones.
+
+            If, on the other hand, there are errors not related to individual
+            documents (such as a network connectivity error), the whole
+            `insert_many` operation will stop in mid-way, an exception will be raised,
+            and only a certain amount of the input documents will
+            have made their way to the database.
+        """
+
+        if concurrency is None:
+            if ordered:
+                _concurrency = 1
+            else:
+                _concurrency = DEFAULT_INSERT_MANY_CONCURRENCY
+        else:
+            _concurrency = concurrency
+        if _concurrency > 1 and ordered:
+            raise ValueError("Cannot run ordered insert_many concurrently.")
+        if chunk_size is None:
+            _chunk_size = MAX_INSERT_NUM_DOCUMENTS
+        else:
+            _chunk_size = chunk_size
+        _documents = _collate_vectors_to_documents(documents, vectors, vectorize)
+        logger.info(f"inserting {len(_documents)} documents in '{self.name}'")
+        raw_results: List[Dict[str, Any]] = []
+        timeout_manager = MultiCallTimeoutManager(overall_max_time_ms=max_time_ms)
+        if ordered:
+            options = {"ordered": True}
+            inserted_ids: List[Any] = []
+            for i in range(0, len(_documents), _chunk_size):
+                logger.info(f"inserting a chunk of documents in '{self.name}'")
+                chunk_response = self._astra_db_collection.insert_many(
+                    documents=_documents[i : i + _chunk_size],
+                    options=options,
+                    partial_failures_allowed=True,
+                    timeout_info=timeout_manager.remaining_timeout_info(),
+                )
+                logger.info(f"finished inserting a chunk of documents in '{self.name}'")
+                # accumulate the results in this call
+                chunk_inserted_ids = (chunk_response.get("status") or {}).get(
+                    "insertedIds", []
+                )
+                inserted_ids += chunk_inserted_ids
+                raw_results += [chunk_response]
+                # if errors, quit early
+                if chunk_response.get("errors", []):
+                    partial_result = InsertManyResult(
+                        raw_results=raw_results,
+                        inserted_ids=inserted_ids,
+                    )
+                    raise InsertManyException.from_response(
+                        command=None,
+                        raw_response=chunk_response,
+                        partial_result=partial_result,
+                    )
+
+            # return
+            full_result = InsertManyResult(
+                raw_results=raw_results,
+                inserted_ids=inserted_ids,
+            )
+            logger.info(
+                f"finished inserting {len(_documents)} documents in '{self.name}'"
+            )
+            return full_result
+
+        else:
+            # unordered: concurrent or not, do all of them and parse the results
+            options = {"ordered": False}
+            if _concurrency > 1:
+                with ThreadPoolExecutor(max_workers=_concurrency) as executor:
+
+                    def _chunk_insertor(
+                        document_chunk: List[Dict[str, Any]]
+                    ) -> Dict[str, Any]:
+                        logger.info(f"inserting a chunk of documents in '{self.name}'")
+                        im_response = self._astra_db_collection.insert_many(
+                            documents=document_chunk,
+                            options=options,
+                            partial_failures_allowed=True,
+                            timeout_info=timeout_manager.remaining_timeout_info(),
+                        )
+                        logger.info(
+                            f"finished inserting a chunk of documents in '{self.name}'"
+                        )
+                        return im_response
+
+                    raw_results = list(
+                        executor.map(
+                            _chunk_insertor,
+                            (
+                                _documents[i : i + _chunk_size]
+                                for i in range(0, len(_documents), _chunk_size)
+                            ),
+                        )
+                    )
+            else:
+                for i in range(0, len(_documents), _chunk_size):
+                    logger.info(f"inserting a chunk of documents in '{self.name}'")
+                    raw_results.append(
+                        self._astra_db_collection.insert_many(
+                            _documents[i : i + _chunk_size],
+                            options=options,
+                            partial_failures_allowed=True,
+                            timeout_info=timeout_manager.remaining_timeout_info(),
+                        )
+                    )
+                    logger.info(
+                        f"finished inserting a chunk of documents in '{self.name}'"
+                    )
+            # recast raw_results
+            inserted_ids = [
+                inserted_id
+                for chunk_response in raw_results
+                for inserted_id in (chunk_response.get("status") or {}).get(
+                    "insertedIds", []
+                )
+            ]
+
+            # check-raise
+            if any(
+                [chunk_response.get("errors", []) for chunk_response in raw_results]
+            ):
+                partial_result = InsertManyResult(
+                    raw_results=raw_results,
+                    inserted_ids=inserted_ids,
+                )
+                raise InsertManyException.from_responses(
+                    commands=[None for _ in raw_results],
+                    raw_responses=raw_results,
+                    partial_result=partial_result,
+                )
+
+            # return
+            full_result = InsertManyResult(
+                raw_results=raw_results,
+                inserted_ids=inserted_ids,
+            )
+            logger.info(
+                f"finished inserting {len(_documents)} documents in '{self.name}'"
+            )
+            return full_result
+
+    def find(
+        self,
+        filter: Optional[FilterType] = None,
+        *,
+        projection: Optional[ProjectionType] = None,
+        skip: Optional[int] = None,
+        limit: Optional[int] = None,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        include_similarity: Optional[bool] = None,
+        sort: Optional[SortType] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> Cursor:
+        """
+        Find documents on the collection, matching a certain provided filter.
+
+        The method returns a Cursor that can then be iterated over. Depending
+        on the method call pattern, the iteration over all documents can reflect
+        collection mutations occurred since the `find` method was called, or not.
+        In cases where the cursor reflects mutations in real-time, it will iterate
+        over cursors in an approximate way (i.e. exhibiting occasional skipped
+        or duplicate documents). This happens when making use of the `sort`
+        option in a non-vector-search manner.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            projection: used to select a subset of fields in the documents being
+                returned. The projection can be: an iterable over the field names
+                to return; a dictionary {field_name: True} to positively select
+                certain fields; or a dictionary {field_name: False} if one wants
+                to discard some fields from the response.
+                The default is to return the whole documents.
+            skip: with this integer parameter, what would be the first `skip`
+                documents returned by the query are discarded, and the results
+                start from the (skip+1)-th document.
+                This parameter can be used only in conjunction with an explicit
+                `sort` criterion of the ascending/descending type (i.e. it cannot
+                be used when not sorting, nor with vector-based ANN search).
+            limit: this (integer) parameter sets a limit over how many documents
+                are returned. Once `limit` is reached (or the cursor is exhausted
+                for lack of matching documents), nothing more is returned.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to perform vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search).
+                When running similarity search on a collection, no other sorting
+                criteria can be specified. Moreover, there is an upper bound
+                to the number of documents that can be returned. For details,
+                see the Note about upper bounds and the Data API documentation.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            include_similarity: a boolean to request the numeric value of the
+                similarity to be returned as an added "$similarity" key in each
+                returned document. Can only be used for vector ANN search, i.e.
+                when either `vector` is supplied or the `sort` parameter has the
+                shape {"$vector": ...}.
+            sort: with this dictionary parameter one can control the order
+                the documents are returned. See the Note about sorting, as well as
+                the one about upper bounds, for details.
+            max_time_ms: a timeout, in milliseconds, for each single one
+                of the underlying HTTP requests used to fetch documents as the
+                cursor is iterated over.
+
+        Returns:
+            a Cursor object representing iterations over the matching documents
+            (see the Cursor object for how to use it. The simplest thing is to
+            run a for loop: `for document in collection.sort(...):`).
+
+        Examples:
+            >>> filter = {"seq": {"$exists": True}}
+            >>> for doc in my_coll.find(filter, projection={"seq": True}, limit=5):
+            ...     print(doc["seq"])
+            ...
+            37
+            35
+            10
+            36
+            27
+            >>> cursor1 = my_coll.find(
+            ...     {},
+            ...     limit=4,
+            ...     sort={"seq": astrapy.constants.SortDocuments.DESCENDING},
+            ... )
+            >>> [doc["_id"] for doc in cursor1]
+            ['97e85f81-...', '1581efe4-...', '...', '...']
+            >>> cursor2 = my_coll.find({}, limit=3)
+            >>> cursor2.distinct("seq")
+            [37, 35, 10]
+
+            >>> my_coll.insert_many([
+            ...     {"tag": "A", "$vector": [4, 5]},
+            ...     {"tag": "B", "$vector": [3, 4]},
+            ...     {"tag": "C", "$vector": [3, 2]},
+            ...     {"tag": "D", "$vector": [4, 1]},
+            ...     {"tag": "E", "$vector": [2, 5]},
+            ... ])
+            >>> ann_tags = [
+            ...     document["tag"]
+            ...     for document in my_coll.find(
+            ...         {},
+            ...         limit=3,
+            ...         vector=[3, 3],
+            ...     )
+            ... ]
+            >>> ann_tags
+            ['A', 'B', 'C']
+            # (assuming the collection has metric VectorMetric.COSINE)
+
+        Note:
+            The following are example values for the `sort` parameter.
+            When no particular order is required:
+                sort={}  # (default when parameter not provided)
+            When sorting by a certain value in ascending/descending order:
+                sort={"field": SortDocuments.ASCENDING}
+                sort={"field": SortDocuments.DESCENDING}
+            When sorting first by "field" and then by "subfield"
+            (while modern Python versions preserve the order of dictionaries,
+            it is suggested for clarity to employ a `collections.OrderedDict`
+            in these cases):
+                sort={
+                    "field": SortDocuments.ASCENDING,
+                    "subfield": SortDocuments.ASCENDING,
+                }
+            When running a vector similarity (ANN) search:
+                sort={"$vector": [0.4, 0.15, -0.5]}
+
+        Note:
+            Some combinations of arguments impose an implicit upper bound on the
+            number of documents that are returned by the Data API. More specifically:
+            (a) Vector ANN searches cannot return more than a number of documents
+            that at the time of writing is set to 1000 items.
+            (b) When using a sort criterion of the ascending/descending type,
+            the Data API will return a smaller number of documents, set to 20
+            at the time of writing, and stop there. The returned documents are
+            the top results across the whole collection according to the requested
+            criterion.
+            These provisions should be kept in mind even when subsequently running
+            a command such as `.distinct()` on a cursor.
+
+        Note:
+            When not specifying sorting criteria at all (by vector or otherwise),
+            the cursor can scroll through an arbitrary number of documents as
+            the Data API and the client periodically exchange new chunks of documents.
+            It should be noted that the behavior of the cursor in the case documents
+            have been added/removed after the `find` was started depends on database
+            internals and it is not guaranteed, nor excluded, that such "real-time"
+            changes in the data would be picked up by the cursor.
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        if include_similarity is not None and not _is_vector_sort(_sort):
+            raise ValueError(
+                "Cannot use `include_similarity` when not searching through `vector`."
+            )
+        return (
+            Cursor(
+                collection=self,
+                filter=filter,
+                projection=projection,
+                max_time_ms=max_time_ms,
+                overall_max_time_ms=None,
+            )
+            .skip(skip)
+            .limit(limit)
+            .sort(_sort)
+            .include_similarity(include_similarity)
+        )
+
+    def find_one(
+        self,
+        filter: Optional[FilterType] = None,
+        *,
+        projection: Optional[ProjectionType] = None,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        include_similarity: Optional[bool] = None,
+        sort: Optional[SortType] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> Union[DocumentType, None]:
+        """
+        Run a search, returning the first document in the collection that matches
+        provided filters, if any is found.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            projection: used to select a subset of fields in the documents being
+                returned. The projection can be: an iterable over the field names
+                to return; a dictionary {field_name: True} to positively select
+                certain fields; or a dictionary {field_name: False} if one wants
+                to discard some fields from the response.
+                The default is to return the whole documents.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to perform vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), extracting the most
+                similar document in the collection matching the filter.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            include_similarity: a boolean to request the numeric value of the
+                similarity to be returned as an added "$similarity" key in the
+                returned document. Can only be used for vector ANN search, i.e.
+                when either `vector` is supplied or the `sort` parameter has the
+                shape {"$vector": ...}.
+            sort: with this dictionary parameter one can control the order
+                the documents are returned. See the Note about sorting for details.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a dictionary expressing the required document, otherwise None.
+
+        Examples:
+            >>> my_coll.find_one({})
+            {'_id': '68d1e515-...', 'seq': 37}
+            >>> my_coll.find_one({"seq": 10})
+            {'_id': 'd560e217-...', 'seq': 10}
+            >>> my_coll.find_one({"seq": 1011})
+            >>> # (returns None for no matches)
+            >>> my_coll.find_one({}, projection={"seq": False})
+            {'_id': '68d1e515-...'}
+            >>> my_coll.find_one(
+            ...     {},
+            ...     sort={"seq": astrapy.constants.SortDocuments.DESCENDING},
+            ... )
+            {'_id': '97e85f81-...', 'seq': 69}
+            >>> my_coll.find_one({}, vector=[1, 0])
+            {'_id': '...', 'tag': 'D', '$vector': [4.0, 1.0]}
+
+        Note:
+            See the `find` method for more details on the accepted parameters
+            (whereas `skip` and `limit` are not valid parameters for `find_one`).
+        """
+
+        fo_cursor = self.find(
+            filter=filter,
+            projection=projection,
+            skip=None,
+            limit=1,
+            vector=vector,
+            vectorize=vectorize,
+            include_similarity=include_similarity,
+            sort=sort,
+            max_time_ms=max_time_ms,
+        )
+        try:
+            document = fo_cursor.__next__()
+            return document  # type: ignore[no-any-return]
+        except StopIteration:
+            return None
+
+    def distinct(
+        self,
+        key: str,
+        *,
+        filter: Optional[FilterType] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> List[Any]:
+        """
+        Return a list of the unique values of `key` across the documents
+        in the collection that match the provided filter.
+
+        Args:
+            key: the name of the field whose value is inspected across documents.
+                Keys can use dot-notation to descend to deeper document levels.
+                Example of acceptable `key` values:
+                    "field"
+                    "field.subfield"
+                    "field.3"
+                    "field.3.subfield"
+                If lists are encountered and no numeric index is specified,
+                all items in the list are visited.
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            max_time_ms: a timeout, in milliseconds, for the operation.
+
+        Returns:
+            a list of all different values for `key` found across the documents
+            that match the filter. The result list has no repeated items.
+
+        Example:
+            >>> my_coll.insert_many(
+            ...     [
+            ...         {"name": "Marco", "food": ["apple", "orange"], "city": "Helsinki"},
+            ...         {"name": "Emma", "food": {"likes_fruit": True, "allergies": []}},
+            ...     ]
+            ... )
+            InsertManyResult(raw_results=..., inserted_ids=['c5b99f37-...', 'd6416321-...'])
+            >>> my_coll.distinct("name")
+            ['Marco', 'Emma']
+            >>> my_coll.distinct("city")
+            ['Helsinki']
+            >>> my_coll.distinct("food")
+            ['apple', 'orange', {'likes_fruit': True, 'allergies': []}]
+            >>> my_coll.distinct("food.1")
+            ['orange']
+            >>> my_coll.distinct("food.allergies")
+            []
+            >>> my_coll.distinct("food.likes_fruit")
+            [True]
+
+        Note:
+            It must be kept in mind that `distinct` is a client-side operation,
+            which effectively browses all required documents using the logic
+            of the `find` method and collects the unique values found for `key`.
+            As such, there may be performance, latency and ultimately
+            billing implications if the amount of matching documents is large.
+
+        Note:
+            For details on the behaviour of "distinct" in conjunction with
+            real-time changes in the collection contents, see the
+            Note of the `find` command.
+        """
+
+        f_cursor = Cursor(
+            collection=self,
+            filter=filter,
+            projection={key: True},
+            max_time_ms=None,
+            overall_max_time_ms=max_time_ms,
+        )
+        return f_cursor.distinct(key)  # type: ignore[no-any-return]
+
+    @recast_method_sync
+    def count_documents(
+        self,
+        filter: Dict[str, Any],
+        *,
+        upper_bound: int,
+        max_time_ms: Optional[int] = None,
+    ) -> int:
+        """
+        Count the documents in the collection matching the specified filter.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            upper_bound: a required ceiling on the result of the count operation.
+                If the actual number of documents exceeds this value,
+                an exception will be raised.
+                Furthermore, if the actual number of documents exceeds the maximum
+                count that the Data API can reach (regardless of upper_bound),
+                an exception will be raised.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            the exact count of matching documents.
+
+        Example:
+            >>> my_coll.insert_many([{"seq": i} for i in range(20)])
+            InsertManyResult(...)
+            >>> my_coll.count_documents({}, upper_bound=100)
+            20
+            >>> my_coll.count_documents({"seq":{"$gt": 15}}, upper_bound=100)
+            4
+            >>> my_coll.count_documents({}, upper_bound=10)
+            Traceback (most recent call last):
+                ... ...
+            astrapy.exceptions.TooManyDocumentsToCountException
+
+        Note:
+            Count operations are expensive: for this reason, the best practice
+            is to provide a reasonable `upper_bound` according to the caller
+            expectations. Moreover, indiscriminate usage of count operations
+            for sizeable amounts of documents (i.e. in the thousands and more)
+            is discouraged in favor of alternative application-specific solutions.
+            Keep in mind that the Data API has a hard upper limit on the amount
+            of documents it will count, and that an exception will be thrown
+            by this method if this limit is encountered.
+        """
+
+        logger.info("calling count_documents")
+        cd_response = self._astra_db_collection.count_documents(
+            filter=filter,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info("finished calling count_documents")
+        if "count" in cd_response.get("status", {}):
+            count: int = cd_response["status"]["count"]
+            if cd_response["status"].get("moreData", False):
+                raise TooManyDocumentsToCountException(
+                    text=f"Document count exceeds {count}, the maximum allowed by the server",
+                    server_max_count_exceeded=True,
+                )
+            else:
+                if count > upper_bound:
+                    raise TooManyDocumentsToCountException(
+                        text="Document count exceeds required upper bound",
+                        server_max_count_exceeded=False,
+                    )
+                else:
+                    return count
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from count_documents API command.",
+                raw_response=cd_response,
+            )
+
+    def estimated_document_count(
+        self,
+        *,
+        max_time_ms: Optional[int] = None,
+    ) -> int:
+        """
+        Query the API server for an estimate of the document count in the collection.
+
+        Contrary to `count_documents`, this method has no filtering parameters.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a server-provided estimate count of the documents in the collection.
+
+        Example:
+            >>> my_coll.estimated_document_count()
+            35700
+        """
+        ed_response = self.command(
+            {"estimatedDocumentCount": {}},
+            max_time_ms=max_time_ms,
+        )
+        if "count" in ed_response.get("status", {}):
+            count: int = ed_response["status"]["count"]
+            return count
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from estimated_document_count API command.",
+                raw_response=ed_response,
+            )
+
+    @recast_method_sync
+    def find_one_and_replace(
+        self,
+        filter: Dict[str, Any],
+        replacement: DocumentType,
+        *,
+        projection: Optional[ProjectionType] = None,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        upsert: bool = False,
+        return_document: str = ReturnDocument.BEFORE,
+        max_time_ms: Optional[int] = None,
+    ) -> Union[DocumentType, None]:
+        """
+        Find a document on the collection and replace it entirely with a new one,
+        optionally inserting a new one if no match is found.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            replacement: the new document to write into the collection.
+            projection: used to select a subset of fields in the document being
+                returned. The projection can be: an iterable over the field names
+                to return; a dictionary {field_name: True} to positively select
+                certain fields; or a dictionary {field_name: False} if one wants
+                to discard some fields from the response.
+                The default is to return the whole documents.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to use vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), as the sorting criterion.
+                In this way, the matched document (if any) will be the one
+                that is most similar to the provided vector.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            sort: with this dictionary parameter one can control the sorting
+                order of the documents matching the filter, effectively
+                determining what document will come first and hence be the
+                replaced one. See the `find` method for more on sorting.
+            upsert: this parameter controls the behavior in absence of matches.
+                If True, `replacement` is inserted as a new document
+                if no matches are found on the collection. If False,
+                the operation silently does nothing in case of no matches.
+            return_document: a flag controlling what document is returned:
+                if set to `ReturnDocument.BEFORE`, or the string "before",
+                the document found on database is returned; if set to
+                `ReturnDocument.AFTER`, or the string "after", the new
+                document is returned. The default is "before".
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            A document (or a projection thereof, as required), either the one
+            before the replace operation or the one after that.
+            Alternatively, the method returns None to represent
+            that no matching document was found, or that no replacement
+            was inserted (depending on the `return_document` parameter).
+
+        Example:
+            >>> my_coll.insert_one({"_id": "rule1", "text": "all animals are equal"})
+            InsertOneResult(...)
+            >>> my_coll.find_one_and_replace(
+            ...     {"_id": "rule1"},
+            ...     {"text": "some animals are more equal!"},
+            ... )
+            {'_id': 'rule1', 'text': 'all animals are equal'}
+            >>> my_coll.find_one_and_replace(
+            ...     {"text": "some animals are more equal!"},
+            ...     {"text": "and the pigs are the rulers"},
+            ...     return_document=astrapy.constants.ReturnDocument.AFTER,
+            ... )
+            {'_id': 'rule1', 'text': 'and the pigs are the rulers'}
+            >>> my_coll.find_one_and_replace(
+            ...     {"_id": "rule2"},
+            ...     {"text": "F=ma^2"},
+            ...     return_document=astrapy.constants.ReturnDocument.AFTER,
+            ... )
+            >>> # (returns None for no matches)
+            >>> my_coll.find_one_and_replace(
+            ...     {"_id": "rule2"},
+            ...     {"text": "F=ma"},
+            ...     upsert=True,
+            ...     return_document=astrapy.constants.ReturnDocument.AFTER,
+            ...     projection={"_id": False},
+            ... )
+            {'text': 'F=ma'}
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        options = {
+            "returnDocument": return_document,
+            "upsert": upsert,
+        }
+        logger.info(f"calling find_one_and_replace on '{self.name}'")
+        fo_response = self._astra_db_collection.find_one_and_replace(
+            replacement=replacement,
+            filter=filter,
+            projection=normalize_optional_projection(projection),
+            sort=_sort,
+            options=options,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished calling find_one_and_replace on '{self.name}'")
+        if "document" in fo_response.get("data", {}):
+            ret_document = fo_response.get("data", {}).get("document")
+            if ret_document is None:
+                return None
+            else:
+                return ret_document  # type: ignore[no-any-return]
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from find_one_and_replace API command.",
+                raw_response=fo_response,
+            )
+
+    @recast_method_sync
+    def replace_one(
+        self,
+        filter: Dict[str, Any],
+        replacement: DocumentType,
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        upsert: bool = False,
+        max_time_ms: Optional[int] = None,
+    ) -> UpdateResult:
+        """
+        Replace a single document on the collection with a new one,
+        optionally inserting a new one if no match is found.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            replacement: the new document to write into the collection.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to use vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), as the sorting criterion.
+                In this way, the matched document (if any) will be the one
+                that is most similar to the provided vector.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            sort: with this dictionary parameter one can control the sorting
+                order of the documents matching the filter, effectively
+                determining what document will come first and hence be the
+                replaced one. See the `find` method for more on sorting.
+            upsert: this parameter controls the behavior in absence of matches.
+                If True, `replacement` is inserted as a new document
+                if no matches are found on the collection. If False,
+                the operation silently does nothing in case of no matches.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            an UpdateResult object summarizing the outcome of the replace operation.
+
+        Example:
+            >>> my_coll.insert_one({"Marco": "Polo"})
+            InsertOneResult(...)
+            >>> my_coll.replace_one({"Marco": {"$exists": True}}, {"Buda": "Pest"})
+            UpdateResult(raw_results=..., update_info={'n': 1, 'updatedExisting': True, 'ok': 1.0, 'nModified': 1})
+            >>> my_coll.find_one({"Buda": "Pest"})
+            {'_id': '8424905a-...', 'Buda': 'Pest'}
+            >>> my_coll.replace_one({"Mirco": {"$exists": True}}, {"Oh": "yeah?"})
+            UpdateResult(raw_results=..., update_info={'n': 0, 'updatedExisting': False, 'ok': 1.0, 'nModified': 0})
+            >>> my_coll.replace_one({"Mirco": {"$exists": True}}, {"Oh": "yeah?"}, upsert=True)
+            UpdateResult(raw_results=..., update_info={'n': 1, 'updatedExisting': False, 'ok': 1.0, 'nModified': 0, 'upserted': '931b47d6-...'})
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        options = {
+            "upsert": upsert,
+        }
+        logger.info(f"calling find_one_and_replace on '{self.name}'")
+        fo_response = self._astra_db_collection.find_one_and_replace(
+            replacement=replacement,
+            filter=filter,
+            sort=_sort,
+            options=options,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished calling find_one_and_replace on '{self.name}'")
+        if "document" in fo_response.get("data", {}):
+            fo_status = fo_response.get("status") or {}
+            _update_info = _prepare_update_info([fo_status])
+            return UpdateResult(
+                raw_results=[fo_response],
+                update_info=_update_info,
+            )
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from find_one_and_replace API command.",
+                raw_response=fo_response,
+            )
+
+    @recast_method_sync
+    def find_one_and_update(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        *,
+        projection: Optional[ProjectionType] = None,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        upsert: bool = False,
+        return_document: str = ReturnDocument.BEFORE,
+        max_time_ms: Optional[int] = None,
+    ) -> Union[DocumentType, None]:
+        """
+        Find a document on the collection and update it as requested,
+        optionally inserting a new one if no match is found.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            update: the update prescription to apply to the document, expressed
+                as a dictionary as per Data API syntax. Examples are:
+                    {"$set": {"field": "value}}
+                    {"$inc": {"counter": 10}}
+                    {"$unset": {"field": ""}}
+                See the Data API documentation for the full syntax.
+            projection: used to select a subset of fields in the document being
+                returned. The projection can be: an iterable over the field names
+                to return; a dictionary {field_name: True} to positively select
+                certain fields; or a dictionary {field_name: False} if one wants
+                to discard some fields from the response.
+                The default is to return the whole documents.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to use vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), as the sorting criterion.
+                In this way, the matched document (if any) will be the one
+                that is most similar to the provided vector.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            sort: with this dictionary parameter one can control the sorting
+                order of the documents matching the filter, effectively
+                determining what document will come first and hence be the
+                updated one. See the `find` method for more on sorting.
+            upsert: this parameter controls the behavior in absence of matches.
+                If True, a new document (resulting from applying the `update`
+                to an empty document) is inserted if no matches are found on
+                the collection. If False, the operation silently does nothing
+                in case of no matches.
+            return_document: a flag controlling what document is returned:
+                if set to `ReturnDocument.BEFORE`, or the string "before",
+                the document found on database is returned; if set to
+                `ReturnDocument.AFTER`, or the string "after", the new
+                document is returned. The default is "before".
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            A document (or a projection thereof, as required), either the one
+            before the replace operation or the one after that.
+            Alternatively, the method returns None to represent
+            that no matching document was found, or that no update
+            was applied (depending on the `return_document` parameter).
+
+        Example:
+            >>> my_coll.insert_one({"Marco": "Polo"})
+            InsertOneResult(...)
+            >>> my_coll.find_one_and_update(
+            ...     {"Marco": {"$exists": True}},
+            ...     {"$set": {"title": "Mr."}},
+            ... )
+            {'_id': 'a80106f2-...', 'Marco': 'Polo'}
+            >>> my_coll.find_one_and_update(
+            ...     {"title": "Mr."},
+            ...     {"$inc": {"rank": 3}},
+            ...     projection=["title", "rank"],
+            ...     return_document=astrapy.constants.ReturnDocument.AFTER,
+            ... )
+            {'_id': 'a80106f2-...', 'title': 'Mr.', 'rank': 3}
+            >>> my_coll.find_one_and_update(
+            ...     {"name": "Johnny"},
+            ...     {"$set": {"rank": 0}},
+            ...     return_document=astrapy.constants.ReturnDocument.AFTER,
+            ... )
+            >>> # (returns None for no matches)
+            >>> my_coll.find_one_and_update(
+            ...     {"name": "Johnny"},
+            ...     {"$set": {"rank": 0}},
+            ...     upsert=True,
+            ...     return_document=astrapy.constants.ReturnDocument.AFTER,
+            ... )
+            {'_id': 'cb4ef2ab-...', 'name': 'Johnny', 'rank': 0}
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        options = {
+            "returnDocument": return_document,
+            "upsert": upsert,
+        }
+        logger.info(f"calling find_one_and_update on '{self.name}'")
+        fo_response = self._astra_db_collection.find_one_and_update(
+            update=update,
+            filter=filter,
+            projection=normalize_optional_projection(projection),
+            sort=_sort,
+            options=options,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished calling find_one_and_update on '{self.name}'")
+        if "document" in fo_response.get("data", {}):
+            ret_document = fo_response.get("data", {}).get("document")
+            if ret_document is None:
+                return None
+            else:
+                return ret_document  # type: ignore[no-any-return]
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from find_one_and_update API command.",
+                raw_response=fo_response,
+            )
+
+    @recast_method_sync
+    def update_one(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        upsert: bool = False,
+        max_time_ms: Optional[int] = None,
+    ) -> UpdateResult:
+        """
+        Update a single document on the collection as requested,
+        optionally inserting a new one if no match is found.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            update: the update prescription to apply to the document, expressed
+                as a dictionary as per Data API syntax. Examples are:
+                    {"$set": {"field": "value}}
+                    {"$inc": {"counter": 10}}
+                    {"$unset": {"field": ""}}
+                See the Data API documentation for the full syntax.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to use vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), as the sorting criterion.
+                In this way, the matched document (if any) will be the one
+                that is most similar to the provided vector.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            sort: with this dictionary parameter one can control the sorting
+                order of the documents matching the filter, effectively
+                determining what document will come first and hence be the
+                updated one. See the `find` method for more on sorting.
+            upsert: this parameter controls the behavior in absence of matches.
+                If True, a new document (resulting from applying the `update`
+                to an empty document) is inserted if no matches are found on
+                the collection. If False, the operation silently does nothing
+                in case of no matches.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            an UpdateResult object summarizing the outcome of the update operation.
+
+        Example:
+            >>> my_coll.insert_one({"Marco": "Polo"})
+            InsertOneResult(...)
+            >>> my_coll.update_one({"Marco": {"$exists": True}}, {"$inc": {"rank": 3}})
+            UpdateResult(raw_results=..., update_info={'n': 1, 'updatedExisting': True, 'ok': 1.0, 'nModified': 1})
+            >>> my_coll.update_one({"Mirko": {"$exists": True}}, {"$inc": {"rank": 3}})
+            UpdateResult(raw_results=..., update_info={'n': 0, 'updatedExisting': False, 'ok': 1.0, 'nModified': 0})
+            >>> my_coll.update_one({"Mirko": {"$exists": True}}, {"$inc": {"rank": 3}}, upsert=True)
+            UpdateResult(raw_results=..., update_info={'n': 1, 'updatedExisting': False, 'ok': 1.0, 'nModified': 0, 'upserted': '2a45ff60-...'})
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        options = {
+            "upsert": upsert,
+        }
+        logger.info(f"calling find_one_and_update on '{self.name}'")
+        fo_response = self._astra_db_collection.find_one_and_update(
+            update=update,
+            sort=_sort,
+            filter=filter,
+            options=options,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished calling find_one_and_update on '{self.name}'")
+        if "document" in fo_response.get("data", {}):
+            fo_status = fo_response.get("status") or {}
+            _update_info = _prepare_update_info([fo_status])
+            return UpdateResult(
+                raw_results=[fo_response],
+                update_info=_update_info,
+            )
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from find_one_and_update API command.",
+                raw_response=fo_response,
+            )
+
+    @recast_method_sync
+    def update_many(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        *,
+        upsert: bool = False,
+        max_time_ms: Optional[int] = None,
+    ) -> UpdateResult:
+        """
+        Apply an update operations to all documents matching a condition,
+        optionally inserting one documents in absence of matches.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            update: the update prescription to apply to the documents, expressed
+                as a dictionary as per Data API syntax. Examples are:
+                    {"$set": {"field": "value}}
+                    {"$inc": {"counter": 10}}
+                    {"$unset": {"field": ""}}
+                See the Data API documentation for the full syntax.
+            upsert: this parameter controls the behavior in absence of matches.
+                If True, a single new document (resulting from applying `update`
+                to an empty document) is inserted if no matches are found on
+                the collection. If False, the operation silently does nothing
+                in case of no matches.
+            max_time_ms: a timeout, in milliseconds, for the operation.
+
+        Returns:
+            an UpdateResult object summarizing the outcome of the update operation.
+
+        Example:
+            >>> my_coll.insert_many([{"c": "red"}, {"c": "green"}, {"c": "blue"}])
+            InsertManyResult(...)
+            >>> my_coll.update_many({"c": {"$ne": "green"}}, {"$set": {"nongreen": True}})
+            UpdateResult(raw_results=..., update_info={'n': 2, 'updatedExisting': True, 'ok': 1.0, 'nModified': 2})
+            >>> my_coll.update_many({"c": "orange"}, {"$set": {"is_also_fruit": True}})
+            UpdateResult(raw_results=..., update_info={'n': 0, 'updatedExisting': False, 'ok': 1.0, 'nModified': 0})
+            >>> my_coll.update_many(
+            ...     {"c": "orange"},
+            ...     {"$set": {"is_also_fruit": True}},
+            ...     upsert=True,
+            ... )
+            UpdateResult(raw_results=..., update_info={'n': 1, 'updatedExisting': False, 'ok': 1.0, 'nModified': 0, 'upserted': '46643050-...'})
+
+        Note:
+            Similarly to the case of `find` (see its docstring for more details),
+            running this command while, at the same time, another process is
+            inserting new documents which match the filter of the `update_many`
+            can result in an unpredictable fraction of these documents being updated.
+            In other words, it cannot be easily predicted whether a given
+            newly-inserted document will be picked up by the update_many command or not.
+        """
+
+        base_options = {
+            "upsert": upsert,
+        }
+        page_state_options: Dict[str, str] = {}
+        um_responses: List[Dict[str, Any]] = []
+        um_statuses: List[Dict[str, Any]] = []
+        must_proceed = True
+        timeout_manager = MultiCallTimeoutManager(overall_max_time_ms=max_time_ms)
+        logger.info(f"starting update_many on '{self.name}'")
+        while must_proceed:
+            options = {**base_options, **page_state_options}
+            logger.info(f"calling update_many on '{self.name}'")
+            this_um_response = self._astra_db_collection.update_many(
+                update=update,
+                filter=filter,
+                options=options,
+                timeout_info=timeout_manager.remaining_timeout_info(),
+            )
+            logger.info(f"finished calling update_many on '{self.name}'")
+            this_um_status = this_um_response.get("status") or {}
+            #
+            # if errors, quit early
+            if this_um_response.get("errors", []):
+                partial_update_info = _prepare_update_info(um_statuses)
+                partial_result = UpdateResult(
+                    raw_results=um_responses,
+                    update_info=partial_update_info,
+                )
+                all_um_responses = um_responses + [this_um_response]
+                raise UpdateManyException.from_responses(
+                    commands=[None for _ in all_um_responses],
+                    raw_responses=all_um_responses,
+                    partial_result=partial_result,
+                )
+            else:
+                if "status" not in this_um_response:
+                    raise DataAPIFaultyResponseException(
+                        text="Faulty response from update_many API command.",
+                        raw_response=this_um_response,
+                    )
+                um_responses.append(this_um_response)
+                um_statuses.append(this_um_status)
+                next_page_state = this_um_status.get("nextPageState")
+                if next_page_state is not None:
+                    must_proceed = True
+                    page_state_options = {"pageState": next_page_state}
+                else:
+                    must_proceed = False
+                    page_state_options = {}
+
+        update_info = _prepare_update_info(um_statuses)
+        logger.info(f"finished update_many on '{self.name}'")
+        return UpdateResult(
+            raw_results=um_responses,
+            update_info=update_info,
+        )
+
+    @recast_method_sync
+    def find_one_and_delete(
+        self,
+        filter: Dict[str, Any],
+        *,
+        projection: Optional[ProjectionType] = None,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> Union[DocumentType, None]:
+        """
+        Find a document in the collection and delete it. The deleted document,
+        however, is the return value of the method.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            projection: used to select a subset of fields in the document being
+                returned. The projection can be: an iterable over the field names
+                to return; a dictionary {field_name: True} to positively select
+                certain fields; or a dictionary {field_name: False} if one wants
+                to discard some fields from the response.
+                Note that the `_id` field will be returned with the document
+                in any case, regardless of what the provided `projection` requires.
+                The default is to return the whole documents.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to use vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), as the sorting criterion.
+                In this way, the matched document (if any) will be the one
+                that is most similar to the provided vector.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            sort: with this dictionary parameter one can control the sorting
+                order of the documents matching the filter, effectively
+                determining what document will come first and hence be the
+                deleted one. See the `find` method for more on sorting.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            Either the document (or a projection thereof, as requested), or None
+            if no matches were found in the first place.
+
+        Example:
+            >>> my_coll.insert_many(
+            ...     [
+            ...         {"species": "swan", "class": "Aves"},
+            ...         {"species": "frog", "class": "Amphibia"},
+            ...     ],
+            ... )
+            InsertManyResult(...)
+            >>> my_coll.find_one_and_delete(
+            ...     {"species": {"$ne": "frog"}},
+            ...     projection=["species"],
+            ... )
+            {'_id': '5997fb48-...', 'species': 'swan'}
+            >>> my_coll.find_one_and_delete({"species": {"$ne": "frog"}})
+            >>> # (returns None for no matches)
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        _projection = normalize_optional_projection(projection)
+        logger.info(f"calling find_one_and_delete on '{self.name}'")
+        fo_response = self._astra_db_collection.find_one_and_delete(
+            sort=_sort,
+            filter=filter,
+            projection=_projection,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished calling find_one_and_delete on '{self.name}'")
+        if "document" in fo_response.get("data", {}):
+            document = fo_response["data"]["document"]
+            return document  # type: ignore[no-any-return]
+        else:
+            deleted_count = fo_response.get("status", {}).get("deletedCount")
+            if deleted_count == 0:
+                return None
+            else:
+                raise DataAPIFaultyResponseException(
+                    text="Faulty response from find_one_and_delete API command.",
+                    raw_response=fo_response,
+                )
+
+    @recast_method_sync
+    def delete_one(
+        self,
+        filter: Dict[str, Any],
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> DeleteResult:
+        """
+        Delete one document matching a provided filter.
+        This method never deletes more than a single document, regardless
+        of the number of matches to the provided filters.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to use vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), as the sorting criterion.
+                In this way, the matched document (if any) will be the one
+                that is most similar to the provided vector.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            sort: with this dictionary parameter one can control the sorting
+                order of the documents matching the filter, effectively
+                determining what document will come first and hence be the
+                deleted one. See the `find` method for more on sorting.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a DeleteResult object summarizing the outcome of the delete operation.
+
+        Example:
+            >>> my_coll.insert_many([{"seq": 1}, {"seq": 0}, {"seq": 2}])
+            InsertManyResult(...)
+            >>> my_coll.delete_one({"seq": 1})
+            DeleteResult(raw_results=..., deleted_count=1)
+            >>> my_coll.distinct("seq")
+            [0, 2]
+            >>> my_coll.delete_one(
+            ...     {"seq": {"$exists": True}},
+            ...     sort={"seq": astrapy.constants.SortDocuments.DESCENDING},
+            ... )
+            DeleteResult(raw_results=..., deleted_count=1)
+            >>> my_coll.distinct("seq")
+            [0]
+            >>> my_coll.delete_one({"seq": 2})
+            DeleteResult(raw_results=..., deleted_count=0)
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        logger.info(f"calling delete_one_by_predicate on '{self.name}'")
+        do_response = self._astra_db_collection.delete_one_by_predicate(
+            filter=filter, timeout_info=base_timeout_info(max_time_ms), sort=_sort
+        )
+        logger.info(f"finished calling delete_one_by_predicate on '{self.name}'")
+        if "deletedCount" in do_response.get("status", {}):
+            deleted_count = do_response["status"]["deletedCount"]
+            if deleted_count == -1:
+                return DeleteResult(
+                    deleted_count=None,
+                    raw_results=[do_response],
+                )
+            else:
+                # expected a non-negative integer:
+                return DeleteResult(
+                    deleted_count=deleted_count,
+                    raw_results=[do_response],
+                )
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from delete_one API command.",
+                raw_response=do_response,
+            )
+
+    @recast_method_sync
+    def delete_many(
+        self,
+        filter: Dict[str, Any],
+        *,
+        max_time_ms: Optional[int] = None,
+    ) -> DeleteResult:
+        """
+        Delete all documents matching a provided filter.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+                The `delete_many` method does not accept an empty filter: see
+                `delete_all` to completely erase all contents of a collection
+            max_time_ms: a timeout, in milliseconds, for the operation.
+
+        Returns:
+            a DeleteResult object summarizing the outcome of the delete operation.
+
+        Example:
+            >>> my_coll.insert_many([{"seq": 1}, {"seq": 0}, {"seq": 2}])
+            InsertManyResult(...)
+            >>> my_coll.delete_many({"seq": {"$lte": 1}})
+            DeleteResult(raw_results=..., deleted_count=2)
+            >>> my_coll.distinct("seq")
+            [2]
+            >>> my_coll.delete_many({"seq": {"$lte": 1}})
+            DeleteResult(raw_results=..., deleted_count=0)
+
+        Note:
+            This operation is not atomic. Depending on the amount of matching
+            documents, it can keep running (in a blocking way) for a macroscopic
+            time. In that case, new documents that are meanwhile inserted
+            (e.g. from another process/application) will be deleted during
+            the execution of this method call until the collection is devoid
+            of matches.
+        """
+
+        if not filter:
+            raise ValueError(
+                "The `filter` parameter to method `delete_many` cannot be "
+                "empty. In order to completely clear the contents of a "
+                "collection, please use the `delete_all` method."
+            )
+
+        dm_responses: List[Dict[str, Any]] = []
+        deleted_count = 0
+        must_proceed = True
+        timeout_manager = MultiCallTimeoutManager(overall_max_time_ms=max_time_ms)
+        logger.info(f"starting delete_many on '{self.name}'")
+        while must_proceed:
+            logger.info(f"calling delete_many on '{self.name}'")
+            this_dm_response = self._astra_db_collection.delete_many(
+                filter=filter,
+                skip_error_check=True,
+                timeout_info=timeout_manager.remaining_timeout_info(),
+            )
+            logger.info(f"finished calling delete_many on '{self.name}'")
+            # if errors, quit early
+            if this_dm_response.get("errors", []):
+                partial_result = DeleteResult(
+                    deleted_count=deleted_count,
+                    raw_results=dm_responses,
+                )
+                all_dm_responses = dm_responses + [this_dm_response]
+                raise DeleteManyException.from_responses(
+                    commands=[None for _ in all_dm_responses],
+                    raw_responses=all_dm_responses,
+                    partial_result=partial_result,
+                )
+            else:
+                this_dc = this_dm_response.get("status", {}).get("deletedCount")
+                if this_dc is None or this_dc < 0:
+                    raise DataAPIFaultyResponseException(
+                        text="Faulty response from delete_many API command.",
+                        raw_response=this_dm_response,
+                    )
+                dm_responses.append(this_dm_response)
+                deleted_count += this_dc
+                must_proceed = this_dm_response.get("status", {}).get("moreData", False)
+
+        logger.info(f"finished delete_many on '{self.name}'")
+        return DeleteResult(
+            deleted_count=deleted_count,
+            raw_results=dm_responses,
+        )
+
+    @recast_method_sync
+    def delete_all(self, *, max_time_ms: Optional[int] = None) -> Dict[str, Any]:
+        """
+        Delete all documents in a collection.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a dictionary of the form {"ok": 1} to signal successful deletion.
+
+        Example:
+            >>> my_coll.distinct("seq")
+            [2, 1, 0]
+            >>> my_coll.count_documents({}, upper_bound=100)
+            4
+            >>> my_coll.delete_all()
+            {'ok': 1}
+            >>> my_coll.count_documents({}, upper_bound=100)
+            0
+
+        Note:
+            Use with caution.
+        """
+
+        logger.info(f"calling unfiltered delete_many on '{self.name}'")
+        dm_response = self._astra_db_collection.delete_many(
+            filter={}, timeout_info=base_timeout_info(max_time_ms)
+        )
+        logger.info(f"finished calling unfiltered delete_many on '{self.name}'")
+        deleted_count = dm_response["status"]["deletedCount"]
+        if deleted_count == -1:
+            return {"ok": 1}
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from delete_many API command.",
+                raw_response=dm_response,
+            )
+
+    def bulk_write(
+        self,
+        requests: Iterable[BaseOperation],
+        *,
+        ordered: bool = True,
+        concurrency: Optional[int] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> BulkWriteResult:
+        """
+        Execute an arbitrary amount of operations such as inserts, updates, deletes
+        either sequentially or concurrently.
+
+        This method does not execute atomically, i.e. individual operations are
+        each performed in the same way as the corresponding collection method,
+        and each one is a different and unrelated database mutation.
+
+        Args:
+            requests: an iterable over concrete subclasses of `BaseOperation`,
+                such as `InsertMany` or `ReplaceOne`. Each such object
+                represents an operation ready to be executed on a collection,
+                and is instantiated by passing the same parameters as one
+                would the corresponding collection method.
+            ordered: whether to launch the `requests` one after the other or
+                in arbitrary order, possibly in a concurrent fashion. For
+                performance reasons, `ordered=False` should be preferred
+                when compatible with the needs of the application flow.
+            concurrency: maximum number of concurrent operations executing at
+                a given time. It cannot be more than one for ordered bulk writes.
+            max_time_ms: a timeout, in milliseconds, for the whole bulk write.
+                Remember that, if the method call times out, then there's no
+                guarantee about what portion of the bulk write has been received
+                and successfully executed by the Data API.
+
+        Returns:
+            A single BulkWriteResult summarizing the whole list of requested
+            operations. The keys in the map attributes of BulkWriteResult
+            (when present) are the integer indices of the corresponding operation
+            in the `requests` iterable.
+
+        Example:
+            >>> from astrapy.operations import InsertMany, ReplaceOne
+            >>> op1 = InsertMany([{"a": 1}, {"a": 2}])
+            >>> op2 = ReplaceOne({"z": 9}, replacement={"z": 9, "replaced": True}, upsert=True)
+            >>> my_coll.bulk_write([op1, op2])
+            BulkWriteResult(bulk_api_results={0: ..., 1: ...}, deleted_count=0, inserted_count=3, matched_count=0, modified_count=0, upserted_count=1, upserted_ids={1: '2addd676-...'})
+            >>> my_coll.count_documents({}, upper_bound=100)
+            3
+            >>> my_coll.distinct("replaced")
+            [True]
+        """
+
+        # lazy importing here against circular-import error
+        from astrapy.operations import reduce_bulk_write_results
+
+        if concurrency is None:
+            if ordered:
+                _concurrency = 1
+            else:
+                _concurrency = DEFAULT_BULK_WRITE_CONCURRENCY
+        else:
+            _concurrency = concurrency
+        if _concurrency > 1 and ordered:
+            raise ValueError("Cannot run ordered bulk_write concurrently.")
+        timeout_manager = MultiCallTimeoutManager(overall_max_time_ms=max_time_ms)
+        logger.info(f"startng a bulk write on '{self.name}'")
+        if ordered:
+            bulk_write_results: List[BulkWriteResult] = []
+            for operation_i, operation in enumerate(requests):
+                try:
+                    this_bw_result = operation.execute(
+                        self,
+                        index_in_bulk_write=operation_i,
+                        bulk_write_timeout_ms=timeout_manager.remaining_timeout_ms(),
+                    )
+                    bulk_write_results.append(this_bw_result)
+                except CumulativeOperationException as exc:
+                    partial_result = exc.partial_result
+                    partial_bw_result = reduce_bulk_write_results(
+                        bulk_write_results
+                        + [
+                            partial_result.to_bulk_write_result(
+                                index_in_bulk_write=operation_i
+                            )
+                        ]
+                    )
+                    dar_exception = exc.data_api_response_exception()
+                    raise BulkWriteException(
+                        text=dar_exception.text,
+                        error_descriptors=dar_exception.error_descriptors,
+                        detailed_error_descriptors=dar_exception.detailed_error_descriptors,
+                        partial_result=partial_bw_result,
+                        exceptions=[dar_exception],
+                    )
+                except DataAPIResponseException as exc:
+                    # the cumulative exceptions, with their
+                    # partially-done-info, are handled above:
+                    # here it's just one-shot d.a.r. exceptions
+                    partial_bw_result = reduce_bulk_write_results(bulk_write_results)
+                    dar_exception = exc.data_api_response_exception()
+                    raise BulkWriteException(
+                        text=dar_exception.text,
+                        error_descriptors=dar_exception.error_descriptors,
+                        detailed_error_descriptors=dar_exception.detailed_error_descriptors,
+                        partial_result=partial_bw_result,
+                        exceptions=[dar_exception],
+                    )
+            full_bw_result = reduce_bulk_write_results(bulk_write_results)
+            logger.info(f"finished a bulk write on '{self.name}'")
+            return full_bw_result
+        else:
+
+            def _execute_as_either(
+                operation: BaseOperation, operation_i: int
+            ) -> Tuple[Optional[BulkWriteResult], Optional[DataAPIResponseException]]:
+                try:
+                    ex_result = operation.execute(
+                        self,
+                        index_in_bulk_write=operation_i,
+                        bulk_write_timeout_ms=timeout_manager.remaining_timeout_ms(),
+                    )
+                    return (ex_result, None)
+                except DataAPIResponseException as exc:
+                    return (None, exc)
+
+            with ThreadPoolExecutor(max_workers=_concurrency) as executor:
+                bulk_write_either_futures = [
+                    executor.submit(
+                        _execute_as_either,
+                        operation,
+                        operation_i,
+                    )
+                    for operation_i, operation in enumerate(requests)
+                ]
+                bulk_write_either_results = [
+                    bulk_write_either_future.result()
+                    for bulk_write_either_future in bulk_write_either_futures
+                ]
+                # regroup
+                bulk_write_successes = [
+                    bwr for bwr, _ in bulk_write_either_results if bwr
+                ]
+                bulk_write_failures = [
+                    bwf for _, bwf in bulk_write_either_results if bwf
+                ]
+                if bulk_write_failures:
+                    # extract and cumulate
+                    partial_results_from_failures = [
+                        failure.partial_result.to_bulk_write_result(
+                            index_in_bulk_write=operation_i
+                        )
+                        for failure in bulk_write_failures
+                        if isinstance(failure, CumulativeOperationException)
+                    ]
+                    partial_bw_result = reduce_bulk_write_results(
+                        bulk_write_successes + partial_results_from_failures
+                    )
+                    # raise and recast the first exception
+                    all_dar_exceptions = [
+                        bw_failure.data_api_response_exception()
+                        for bw_failure in bulk_write_failures
+                    ]
+                    dar_exception = all_dar_exceptions[0]
+                    raise BulkWriteException(
+                        text=dar_exception.text,
+                        error_descriptors=dar_exception.error_descriptors,
+                        detailed_error_descriptors=dar_exception.detailed_error_descriptors,
+                        partial_result=partial_bw_result,
+                        exceptions=all_dar_exceptions,
+                    )
+                else:
+                    logger.info(f"finished a bulk write on '{self.name}'")
+                    return reduce_bulk_write_results(bulk_write_successes)
+
+    def drop(self, *, max_time_ms: Optional[int] = None) -> Dict[str, Any]:
+        """
+        Drop the collection, i.e. delete it from the database along with
+        all the documents it contains.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+                Remember there is not guarantee that a request that has
+                timed out us not in fact honored.
+
+        Returns:
+            a dictionary of the form {"ok": 1} to signal successful deletion.
+
+        Example:
+            >>> my_coll.find_one({})
+            {'_id': '...', 'a': 100}
+            >>> my_coll.drop()
+            {'ok': 1}
+            >>> my_coll.find_one({})
+            Traceback (most recent call last):
+                ... ...
+            astrapy.exceptions.DataAPIResponseException: Collection does not exist, collection name: my_collection
+
+        Note:
+            Use with caution.
+
+
+        Note:
+            Once the method succeeds, methods on this object can still be invoked:
+            however, this hardly makes sense as the underlying actual collection
+            is no more.
+            It is responsibility of the developer to design a correct flow
+            which avoids using a deceased collection any further.
+
+        Note:
+            Once the method succeeds, methods on this object can still be invoked:
+            however, this hardly makes sense as the underlying actual collection
+            is no more.
+            It is responsibility of the developer to design a correct flow
+            which avoids using a deceased collection any further.
+        """
+
+        logger.info(f"dropping collection '{self.name}' (self)")
+        drop_result = self.database.drop_collection(self, max_time_ms=max_time_ms)
+        logger.info(f"finished dropping collection '{self.name}' (self)")
+        return drop_result  # type: ignore[no-any-return]
+
+    def command(
+        self,
+        body: Dict[str, Any],
+        *,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Send a POST request to the Data API for this collection with
+        an arbitrary, caller-provided payload.
+
+        Args:
+            body: a JSON-serializable dictionary, the payload of the request.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a dictionary with the response of the HTTP request.
+
+        Example:
+            >>> my_coll.command({"countDocuments": {}})
+            {'status': {'count': 123}}
+        """
+
+        logger.info(f"calling command on '{self.name}'")
+        command_result = self.database.command(
+            body=body,
+            namespace=self.namespace,
+            collection_name=self.name,
+            max_time_ms=max_time_ms,
+        )
+        logger.info(f"finished calling command on '{self.name}'")
+        return command_result  # type: ignore[no-any-return]
+
+
+class AsyncCollection:
+    """
+    A Data API collection, the main object to interact with the Data API,
+    especially for DDL operations.
+    This class has a synchronous interface.
+
+    A Collection is spawned from a Database object, from which it inherits
+    the details on how to reach the API server (endpoint, authentication token).
+
+    Args:
+        database: a Database object, instantiated earlier. This represents
+            the database the collection belongs to.
+        name: the collection name. This parameter should match an existing
+            collection on the database.
+        namespace: this is the namespace to which the collection belongs.
+            If not specified, the database's working namespace is used.
+        caller_name: name of the application, or framework, on behalf of which
+            the Data API calls are performed. This ends up in the request user-agent.
+        caller_version: version of the caller.
+
+    Examples:
+        >>> from astrapy import DataAPIClient, AsyncCollection
+        >>> my_client = astrapy.DataAPIClient("AstraCS:...")
+        >>> my_async_db = my_client.get_async_database_by_api_endpoint(
+        ...    "https://01234567-....apps.astra.datastax.com"
+        ... )
+        >>> my_async_coll_1 = AsyncCollection(database=my_async_db, name="my_collection")
+        >>> my_async coll_2 = asyncio.run(my_async_db.create_collection(
+        ...     "my_v_collection",
+        ...     dimension=3,
+        ...     metric="cosine",
+        ... ))
+        >>> my_async_coll_3a = asyncio.run(my_async_db.get_collection(
+        ...     "my_already_existing_collection",
+        ... ))
+        >>> my_async_coll_3b = my_async_db.my_already_existing_collection
+        >>> my_async_coll_3c = my_async_db["my_already_existing_collection"]
+
+    Note:
+        creating an instance of Collection does not trigger actual creation
+        of the collection on the database. The latter should have been created
+        beforehand, e.g. through the `create_collection` method of a Database.
+    """
+
+    def __init__(
+        self,
+        database: AsyncDatabase,
+        name: str,
+        *,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        self._astra_db_collection: AsyncAstraDBCollection = AsyncAstraDBCollection(
+            collection_name=name,
+            astra_db=database._astra_db,
+            namespace=namespace,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+        # this comes after the above, lets AstraDBCollection resolve namespace
+        self._database = database._copy(
+            namespace=self._astra_db_collection.astra_db.namespace
+        )
+
+    def __repr__(self) -> str:
+        return (
+            f'{self.__class__.__name__}(name="{self.name}", '
+            f'namespace="{self.namespace}", database={self.database})'
+        )
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, AsyncCollection):
+            return self._astra_db_collection == other._astra_db_collection
+        else:
+            return False
+
+    def __call__(self, *pargs: Any, **kwargs: Any) -> None:
+        raise TypeError(
+            f"'{self.__class__.__name__}' object is not callable. If you "
+            f"meant to call the '{self.name}' method on a "
+            f"'{self.database.__class__.__name__}' object "
+            "it is failing because no such method exists."
+        )
+
+    def _copy(
+        self,
+        *,
+        database: Optional[AsyncDatabase] = None,
+        name: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> AsyncCollection:
+        return AsyncCollection(
+            database=database or self.database._copy(),
+            name=name or self.name,
+            namespace=namespace or self.namespace,
+            caller_name=caller_name or self._astra_db_collection.caller_name,
+            caller_version=caller_version or self._astra_db_collection.caller_version,
+        )
+
+    def with_options(
+        self,
+        *,
+        name: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> AsyncCollection:
+        """
+        Create a clone of this collection with some changed attributes.
+
+        Args:
+            name: the name of the collection. This parameter is useful to
+                quickly spawn AsyncCollection instances each pointing to a different
+                collection existing in the same namespace.
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+
+        Returns:
+            a new AsyncCollection instance.
+
+        Example:
+            >>> my_other_async_coll = my_async_coll.with_options(
+            ...     name="the_other_coll",
+            ...     caller_name="caller_identity",
+            ... )
+        """
+
+        return self._copy(
+            name=name,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
+    def to_sync(
+        self,
+        *,
+        database: Optional[Database] = None,
+        name: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> Collection:
+        """
+        Create a Collection from this one. Save for the arguments
+        explicitly provided as overrides, everything else is kept identical
+        to this collection in the copy (the database is converted into
+        a sync object).
+
+        Args:
+            database: a Database object, instantiated earlier.
+                This represents the database the new collection belongs to.
+            name: the collection name. This parameter should match an existing
+                collection on the database.
+            namespace: this is the namespace to which the collection belongs.
+                If not specified, the database's working namespace is used.
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+
+        Returns:
+            the new copy, a Collection instance.
+
+        Example:
+            >>> my_async_coll.to_sync().count_documents({}, upper_bound=100)
+            77
+        """
+
+        return Collection(
+            database=database or self.database.to_sync(),
+            name=name or self.name,
+            namespace=namespace or self.namespace,
+            caller_name=caller_name or self._astra_db_collection.caller_name,
+            caller_version=caller_version or self._astra_db_collection.caller_version,
+        )
+
+    def set_caller(
+        self,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        """
+        Set a new identity for the application/framework on behalf of which
+        the Data API calls are performed (the "caller").
+
+        Args:
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+
+        Example:
+            >>> my_coll.set_caller(caller_name="the_caller", caller_version="0.1.0")
+        """
+
+        logger.info(f"setting caller to {caller_name}/{caller_version}")
+        self._astra_db_collection.set_caller(
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
+    async def options(self, *, max_time_ms: Optional[int] = None) -> CollectionOptions:
+        """
+        Get the collection options, i.e. its configuration as read from the database.
+
+        The method issues a request to the Data API each time is invoked,
+        without caching mechanisms: this ensures up-to-date information
+        for usages such as real-time collection validation by the application.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a CollectionOptions instance describing the collection.
+            (See also the database `list_collections` method.)
+
+        Example:
+            >>> asyncio.run(my_async_coll.options())
+            CollectionOptions(vector=CollectionVectorOptions(dimension=3, metric='cosine'))
+        """
+
+        logger.info(f"getting collections in search of '{self.name}'")
+        self_descriptors = [
+            coll_desc
+            async for coll_desc in self.database.list_collections(
+                max_time_ms=max_time_ms
+            )
+            if coll_desc.name == self.name
+        ]
+        logger.info(f"finished getting collections in search of '{self.name}'")
+        if self_descriptors:
+            return self_descriptors[0].options  # type: ignore[no-any-return]
+        else:
+            raise CollectionNotFoundException(
+                text=f"Collection {self.namespace}.{self.name} not found.",
+                namespace=self.namespace,
+                collection_name=self.name,
+            )
+
+    def info(self) -> CollectionInfo:
+        """
+        Information on the collection (name, location, database), in the
+        form of a CollectionInfo object.
+
+        Not to be confused with the collection `options` method (related
+        to the collection internal configuration).
+
+        Example:
+            >>> my_async_coll.info().database_info.region
+            'us-east1'
+            >>> my_async_coll.info().full_name
+            'default_keyspace.my_v_collection'
+
+        Note:
+            the returned CollectionInfo wraps, among other things,
+            the database information: as such, calling this method
+            triggers the same-named method of a Database object (which, in turn,
+            performs a HTTP request to the DevOps API).
+            See the documentation for `Database.info()` for more details.
+        """
+
+        return CollectionInfo(
+            database_info=self.database.info(),
+            namespace=self.namespace,
+            name=self.name,
+            full_name=self.full_name,
+        )
+
+    @property
+    def database(self) -> AsyncDatabase:
+        """
+        a Database object, the database this collection belongs to.
+
+        Example:
+            >>> my_async_coll.database.name
+            'quicktest'
+        """
+
+        return self._database
+
+    @property
+    def namespace(self) -> str:
+        """
+        The namespace this collection is in.
+
+        Example:
+            >>> my_async_coll.database.namespace
+            'default_keyspace'
+        """
+
+        return self.database.namespace
+
+    @property
+    def name(self) -> str:
+        """
+        The name of this collection.
+
+        Example:
+            >>> my_async_coll.name
+            'my_v_collection'
+        """
+
+        # type hint added as for some reason the typechecker gets lost
+        return self._astra_db_collection.collection_name  # type: ignore[no-any-return, has-type]
+
+    @property
+    def full_name(self) -> str:
+        """
+        The fully-qualified collection name within the database,
+        in the form "namespace.collection_name".
+
+        Example:
+            >>> my_async_coll.full_name
+            'default_keyspace.my_v_collection'
+        """
+
+        return f"{self.namespace}.{self.name}"
+
+    @recast_method_async
+    async def insert_one(
+        self,
+        document: DocumentType,
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> InsertOneResult:
+        """
+        Insert a single document in the collection in an atomic operation.
+
+        Args:
+            document: the dictionary expressing the document to insert.
+                The `_id` field of the document can be left out, in which
+                case it will be created automatically.
+            vector: a vector (a list of numbers appropriate for the collection)
+                for the document. Passing this parameter is equivalent to
+                providing the vector in the "$vector" field of the document itself,
+                however the two are mutually exclusive.
+            vectorize: a string to be made into a vector, if such a service
+                is configured for the collection. Passing this parameter is
+                equivalent to providing a `$vectorize` field in the document itself,
+                however the two are mutually exclusive.
+                Moreover, this parameter cannot coexist with `vector`.
+                NOTE: This feature is under current development.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            an InsertOneResult object.
+
+        Example:
+            >>> async def write_and_count(acol: AsyncCollection) -> None:
+            ...     count0 = await acol.count_documents({}, upper_bound=10)
+            ...     print("count0", count0)
+            ...     await acol.insert_one(
+            ...         {
+            ...             "age": 30,
+            ...             "name": "Smith",
+            ...             "food": ["pear", "peach"],
+            ...             "likes_fruit": True,
+            ...         },
+            ...     )
+            ...     await acol.insert_one({"_id": "user-123", "age": 50, "name": "Maccio"})
+            ...     count1 = await acol.count_documents({}, upper_bound=10)
+            ...     print("count1", count1)
+            ...
+            >>> asyncio.run(write_and_count(my_async_coll))
+            count0 0
+            count1 2
+
+            >>> asyncio.run(my_async_coll.insert_one({"tag": v"}, vector=[10, 11]))
+            InsertOneResult(...)
+
+        Note:
+            If an `_id` is explicitly provided, which corresponds to a document
+            that exists already in the collection, an error is raised and
+            the insertion fails.
+        """
+
+        _document = _collate_vector_to_document(document, vector, vectorize)
+        logger.info(f"inserting one document in '{self.name}'")
+        io_response = await self._astra_db_collection.insert_one(
+            _document,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished inserting one document in '{self.name}'")
+        if "insertedIds" in io_response.get("status", {}):
+            if io_response["status"]["insertedIds"]:
+                inserted_id = io_response["status"]["insertedIds"][0]
+                return InsertOneResult(
+                    raw_results=[io_response],
+                    inserted_id=inserted_id,
+                )
+            else:
+                raise ValueError(
+                    "Could not complete a insert_one operation. "
+                    f"(gotten '${json.dumps(io_response)}')"
+                )
+        else:
+            raise ValueError(
+                "Could not complete a insert_one operation. "
+                f"(gotten '${json.dumps(io_response)}')"
+            )
+
+    @recast_method_async
+    async def insert_many(
+        self,
+        documents: Iterable[DocumentType],
+        *,
+        vectors: Optional[Iterable[Optional[VectorType]]] = None,
+        vectorize: Optional[Iterable[Optional[str]]] = None,
+        ordered: bool = True,
+        chunk_size: Optional[int] = None,
+        concurrency: Optional[int] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> InsertManyResult:
+        """
+        Insert a list of documents into the collection.
+        This is not an atomic operation.
+
+        Args:
+            documents: an iterable of dictionaries, each a document to insert.
+                Documents may specify their `_id` field or leave it out, in which
+                case it will be added automatically.
+            vectors: an optional list of vectors (as many vectors as the provided
+                documents) to associate to the documents when inserting.
+                Each vector is added to the corresponding document prior to
+                insertion on database. The list can be a mixture of None and vectors,
+                in which case some documents will not have a vector, unless it is
+                specified in their "$vector" field already.
+                Passing vectors this way is indeed equivalent to the "$vector" field
+                of the documents, however the two are mutually exclusive.
+            vectorize: an optional list of strings to be made into as many vectors
+                (one per document), if such a service is configured for the collection.
+                Passing this parameter is equivalent to providing a `$vectorize`
+                field in the documents themselves, however the two are mutually exclusive.
+                For any given document, this parameter cannot coexist with the
+                corresponding `vector` entry.
+                NOTE: This feature is under current development.
+            ordered: if True (default), the insertions are processed sequentially.
+                If False, they can occur in arbitrary order and possibly concurrently.
+            chunk_size: how many documents to include in a single API request.
+                Exceeding the server maximum allowed value results in an error.
+                Leave it unspecified (recommended) to use the system default.
+            concurrency: maximum number of concurrent requests to the API at
+                a given time. It cannot be more than one for ordered insertions.
+            max_time_ms: a timeout, in milliseconds, for the operation.
+
+        Returns:
+            an InsertManyResult object.
+
+        Examples:
+            >>> async def write_and_count(acol: AsyncCollection) -> None:
+            ...             count0 = await acol.count_documents({}, upper_bound=10)
+            ...             print("count0", count0)
+            ...             im_result1 = await acol.insert_many(
+            ...                 [
+            ...                     {"a": 10},
+            ...                     {"a": 5},
+            ...                     {"b": [True, False, False]},
+            ...                 ],
+            ...             )
+            ...             print("inserted1", im_result1.inserted_ids)
+            ...             count1 = await acol.count_documents({}, upper_bound=100)
+            ...             print("count1", count1)
+            ...             await acol.insert_many(
+            ...                 [{"seq": i} for i in range(50)],
+            ...                 ordered=False,
+            ...                 concurrency=5,
+            ...             )
+            ...             count2 = await acol.count_documents({}, upper_bound=100)
+            ...             print("count2", count2)
+            ...
+            >>> asyncio.run(write_and_count(my_async_coll))
+            count0 0
+            inserted1 ['e3c2a684-...', '1de4949f-...', '167dacc3-...']
+            count1 3
+            count2 53
+
+            # The following are three equivalent statements:
+            >>> asyncio.run(my_async_coll.insert_many(
+            ...     [{"tag": "a"}, {"tag": "b"}],
+            ...     vectors=[[1, 2], [3, 4]],
+            ... ))
+            InsertManyResult(...)
+            >>> asyncio.run(my_async_coll.insert_many(
+            ...     [{"tag": "a", "$vector": [1, 2]}, {"tag": "b"}],
+            ...     vectors=[None, [3, 4]],
+            ... ))
+            InsertManyResult(...)
+            >>> asyncio.run(my_async_coll.insert_many(
+            ...     [
+            ...         {"tag": "a", "$vector": [1, 2]},
+            ...         {"tag": "b", "$vector": [3, 4]},
+            ...     ]
+            ... ))
+            InsertManyResult(...)
+
+
+        Note:
+            Unordered insertions are executed with some degree of concurrency,
+            so it is usually better to prefer this mode unless the order in the
+            document sequence is important.
+
+        Note:
+            A failure mode for this command is related to certain faulty documents
+            found among those to insert: a document may have the an `_id` already
+            present on the collection, or its vector dimension may not
+            match the collection setting.
+
+            For an ordered insertion, the method will raise an exception at
+            the first such faulty document -- nevertheless, all documents processed
+            until then will end up being written to the database.
+
+            For unordered insertions, if the error stems from faulty documents
+            the insertion proceeds until exhausting the input documents: then,
+            an exception is raised -- and all insertable documents will have been
+            written to the database, including those "after" the troublesome ones.
+
+            If, on the other hand, there are errors not related to individual
+            documents (such as a network connectivity error), the whole
+            `insert_many` operation will stop in mid-way, an exception will be raised,
+            and only a certain amount of the input documents will
+            have made their way to the database.
+        """
+
+        if concurrency is None:
+            if ordered:
+                _concurrency = 1
+            else:
+                _concurrency = DEFAULT_INSERT_MANY_CONCURRENCY
+        else:
+            _concurrency = concurrency
+        if _concurrency > 1 and ordered:
+            raise ValueError("Cannot run ordered insert_many concurrently.")
+        if chunk_size is None:
+            _chunk_size = MAX_INSERT_NUM_DOCUMENTS
+        else:
+            _chunk_size = chunk_size
+        _documents = _collate_vectors_to_documents(documents, vectors, vectorize)
+        logger.info(f"inserting {len(_documents)} documents in '{self.name}'")
+        raw_results: List[Dict[str, Any]] = []
+        timeout_manager = MultiCallTimeoutManager(overall_max_time_ms=max_time_ms)
+        if ordered:
+            options = {"ordered": True}
+            inserted_ids: List[Any] = []
+            for i in range(0, len(_documents), _chunk_size):
+                logger.info(f"inserting a chunk of documents in '{self.name}'")
+                chunk_response = await self._astra_db_collection.insert_many(
+                    documents=_documents[i : i + _chunk_size],
+                    options=options,
+                    partial_failures_allowed=True,
+                    timeout_info=timeout_manager.remaining_timeout_info(),
+                )
+                logger.info(f"finished inserting a chunk of documents in '{self.name}'")
+                # accumulate the results in this call
+                chunk_inserted_ids = (chunk_response.get("status") or {}).get(
+                    "insertedIds", []
+                )
+                inserted_ids += chunk_inserted_ids
+                raw_results += [chunk_response]
+                # if errors, quit early
+                if chunk_response.get("errors", []):
+                    partial_result = InsertManyResult(
+                        raw_results=raw_results,
+                        inserted_ids=inserted_ids,
+                    )
+                    raise InsertManyException.from_response(
+                        command=None,
+                        raw_response=chunk_response,
+                        partial_result=partial_result,
+                    )
+
+            # return
+            full_result = InsertManyResult(
+                raw_results=raw_results,
+                inserted_ids=inserted_ids,
+            )
+            logger.info(
+                f"finished inserting {len(_documents)} documents in '{self.name}'"
+            )
+            return full_result
+
+        else:
+            # unordered: concurrent or not, do all of them and parse the results
+            options = {"ordered": False}
+
+            sem = asyncio.Semaphore(_concurrency)
+
+            async def concurrent_insert_chunk(
+                document_chunk: List[DocumentType],
+            ) -> Dict[str, Any]:
+                async with sem:
+                    logger.info(f"inserting a chunk of documents in '{self.name}'")
+                    im_response = await self._astra_db_collection.insert_many(
+                        document_chunk,
+                        options=options,
+                        partial_failures_allowed=True,
+                        timeout_info=timeout_manager.remaining_timeout_info(),
+                    )
+                    logger.info(
+                        f"finished inserting a chunk of documents in '{self.name}'"
+                    )
+                    return im_response
+
+            if _concurrency > 1:
+                tasks = [
+                    asyncio.create_task(
+                        concurrent_insert_chunk(_documents[i : i + _chunk_size])
+                    )
+                    for i in range(0, len(_documents), _chunk_size)
+                ]
+                raw_results = await asyncio.gather(*tasks)
+            else:
+                raw_results = [
+                    await concurrent_insert_chunk(_documents[i : i + _chunk_size])
+                    for i in range(0, len(_documents), _chunk_size)
+                ]
+
+            # recast raw_results
+            inserted_ids = [
+                inserted_id
+                for chunk_response in raw_results
+                for inserted_id in (chunk_response.get("status") or {}).get(
+                    "insertedIds", []
+                )
+            ]
+
+            # check-raise
+            if any(
+                [chunk_response.get("errors", []) for chunk_response in raw_results]
+            ):
+                partial_result = InsertManyResult(
+                    raw_results=raw_results,
+                    inserted_ids=inserted_ids,
+                )
+                raise InsertManyException.from_responses(
+                    commands=[None for _ in raw_results],
+                    raw_responses=raw_results,
+                    partial_result=partial_result,
+                )
+
+            # return
+            full_result = InsertManyResult(
+                raw_results=raw_results,
+                inserted_ids=inserted_ids,
+            )
+            logger.info(
+                f"finished inserting {len(_documents)} documents in '{self.name}'"
+            )
+            return full_result
+
+    def find(
+        self,
+        filter: Optional[FilterType] = None,
+        *,
+        projection: Optional[ProjectionType] = None,
+        skip: Optional[int] = None,
+        limit: Optional[int] = None,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        include_similarity: Optional[bool] = None,
+        sort: Optional[SortType] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> AsyncCursor:
+        """
+        Find documents on the collection, matching a certain provided filter.
+
+        The method returns a Cursor that can then be iterated over. Depending
+        on the method call pattern, the iteration over all documents can reflect
+        collection mutations occurred since the `find` method was called, or not.
+        In cases where the cursor reflects mutations in real-time, it will iterate
+        over cursors in an approximate way (i.e. exhibiting occasional skipped
+        or duplicate documents). This happens when making use of the `sort`
+        option in a non-vector-search manner.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            projection: used to select a subset of fields in the documents being
+                returned. The projection can be: an iterable over the field names
+                to return; a dictionary {field_name: True} to positively select
+                certain fields; or a dictionary {field_name: False} if one wants
+                to discard some fields from the response.
+                The default is to return the whole documents.
+            skip: with this integer parameter, what would be the first `skip`
+                documents returned by the query are discarded, and the results
+                start from the (skip+1)-th document.
+                This parameter can be used only in conjunction with an explicit
+                `sort` criterion of the ascending/descending type (i.e. it cannot
+                be used when not sorting, nor with vector-based ANN search).
+            limit: this (integer) parameter sets a limit over how many documents
+                are returned. Once `limit` is reached (or the cursor is exhausted
+                for lack of matching documents), nothing more is returned.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to perform vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search).
+                When running similarity search on a collection, no other sorting
+                criteria can be specified. Moreover, there is an upper bound
+                to the number of documents that can be returned. For details,
+                see the Note about upper bounds and the Data API documentation.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            include_similarity: a boolean to request the numeric value of the
+                similarity to be returned as an added "$similarity" key in each
+                returned document. Can only be used for vector ANN search, i.e.
+                when either `vector` is supplied or the `sort` parameter has the
+                shape {"$vector": ...}.
+            sort: with this dictionary parameter one can control the order
+                the documents are returned. See the Note about sorting, as well as
+                the one about upper bounds, for details.
+            max_time_ms: a timeout, in milliseconds, for each single one
+                of the underlying HTTP requests used to fetch documents as the
+                cursor is iterated over.
+
+        Returns:
+            an AsyncCursor object representing iterations over the matching documents
+            (see the AsyncCursor object for how to use it. The simplest thing is to
+            run a for loop: `for document in collection.sort(...):`).
+
+        Examples:
+            >>> async def run_finds(acol: AsyncCollection) -> None:
+            ...             filter = {"seq": {"$exists": True}}
+            ...             print("find results 1:")
+            ...             async for doc in acol.find(filter, projection={"seq": True}, limit=5):
+            ...                 print(doc["seq"])
+            ...             async_cursor1 = acol.find(
+            ...                 {},
+            ...                 limit=4,
+            ...                 sort={"seq": astrapy.constants.SortDocuments.DESCENDING},
+            ...             )
+            ...             ids = [doc["_id"] async for doc in async_cursor1]
+            ...             print("find results 2:", ids)
+            ...             async_cursor2 = acol.find({}, limit=3)
+            ...             seqs = await async_cursor2.distinct("seq")
+            ...             print("distinct results 3:", seqs)
+            ...
+            >>> asyncio.run(run_finds(my_async_coll))
+            find results 1:
+            48
+            35
+            7
+            11
+            13
+            find results 2: ['d656cd9d-...', '479c7ce8-...', '96dc87fd-...', '83f0a21f-...']
+            distinct results 3: [48, 35, 7]
+
+            >>> async def run_vector_finds(acol: AsyncCollection) -> None:
+            ...     await acol.insert_many([
+            ...         {"tag": "A", "$vector": [4, 5]},
+            ...         {"tag": "B", "$vector": [3, 4]},
+            ...         {"tag": "C", "$vector": [3, 2]},
+            ...         {"tag": "D", "$vector": [4, 1]},
+            ...         {"tag": "E", "$vector": [2, 5]},
+            ...     ])
+            ...     ann_tags = [
+            ...         document["tag"]
+            ...         async for document in acol.find(
+            ...             {},
+            ...             limit=3,
+            ...             vector=[3, 3],
+            ...         )
+            ...     ]
+            ...     return ann_tags
+            ...
+            >>> asyncio.run(run_vector_finds(my_async_coll))
+            ['A', 'B', 'C']
+            # (assuming the collection has metric VectorMetric.COSINE)
+
+        Note:
+            The following are example values for the `sort` parameter.
+            When no particular order is required:
+                sort={}
+            When sorting by a certain value in ascending/descending order:
+                sort={"field": SortDocuments.ASCENDING}
+                sort={"field": SortDocuments.DESCENDING}
+            When sorting first by "field" and then by "subfield"
+            (while modern Python versions preserve the order of dictionaries,
+            it is suggested for clarity to employ a `collections.OrderedDict`
+            in these cases):
+                sort={
+                    "field": SortDocuments.ASCENDING,
+                    "subfield": SortDocuments.ASCENDING,
+                }
+            When running a vector similarity (ANN) search:
+                sort={"$vector": [0.4, 0.15, -0.5]}
+
+        Note:
+            Some combinations of arguments impose an implicit upper bound on the
+            number of documents that are returned by the Data API. More specifically:
+            (a) Vector ANN searches cannot return more than a number of documents
+            that at the time of writing is set to 1000 items.
+            (b) When using a sort criterion of the ascending/descending type,
+            the Data API will return a smaller number of documents, set to 20
+            at the time of writing, and stop there. The returned documents are
+            the top results across the whole collection according to the requested
+            criterion.
+            These provisions should be kept in mind even when subsequently running
+            a command such as `.distinct()` on a cursor.
+
+        Note:
+            When not specifying sorting criteria at all (by vector or otherwise),
+            the cursor can scroll through an arbitrary number of documents as
+            the Data API and the client periodically exchange new chunks of documents.
+            It should be noted that the behavior of the cursor in the case documents
+            have been added/removed after the `find` was started depends on database
+            internals and it is not guaranteed, nor excluded, that such "real-time"
+            changes in the data would be picked up by the cursor.
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        if include_similarity is not None and not _is_vector_sort(_sort):
+            raise ValueError(
+                "Cannot use `include_similarity` when not searching through `vector`."
+            )
+        return (
+            AsyncCursor(
+                collection=self,
+                filter=filter,
+                projection=projection,
+                max_time_ms=max_time_ms,
+                overall_max_time_ms=None,
+            )
+            .skip(skip)
+            .limit(limit)
+            .sort(_sort)
+            .include_similarity(include_similarity)
+        )
+
+    async def find_one(
+        self,
+        filter: Optional[FilterType] = None,
+        *,
+        projection: Optional[ProjectionType] = None,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        include_similarity: Optional[bool] = None,
+        sort: Optional[SortType] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> Union[DocumentType, None]:
+        """
+        Run a search, returning the first document in the collection that matches
+        provided filters, if any is found.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            projection: used to select a subset of fields in the documents being
+                returned. The projection can be: an iterable over the field names
+                to return; a dictionary {field_name: True} to positively select
+                certain fields; or a dictionary {field_name: False} if one wants
+                to discard some fields from the response.
+                The default is to return the whole documents.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to perform vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), extracting the most
+                similar document in the collection matching the filter.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            include_similarity: a boolean to request the numeric value of the
+                similarity to be returned as an added "$similarity" key in the
+                returned document. Can only be used for vector ANN search, i.e.
+                when either `vector` is supplied or the `sort` parameter has the
+                shape {"$vector": ...}.
+            sort: with this dictionary parameter one can control the order
+                the documents are returned. See the Note about sorting for details.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a dictionary expressing the required document, otherwise None.
+
+        Example:
+            >>> async def demo_find_one(acol: AsyncCollection) -> None:
+            ....    print("Count:", await acol.count_documents({}, upper_bound=100))
+            ...     result0 = await acol.find_one({})
+            ...     print("result0", result0)
+            ...     result1 = await acol.find_one({"seq": 10})
+            ...     print("result1", result1)
+            ...     result2 = await acol.find_one({"seq": 1011})
+            ...     print("result2", result2)
+            ...     result3 = await acol.find_one({}, projection={"seq": False})
+            ...     print("result3", result3)
+            ...     result4 = await acol.find_one(
+            ...         {},
+            ...         sort={"seq": astrapy.constants.SortDocuments.DESCENDING},
+            ...     )
+            ...     print("result4", result4)
+            ...
+            >>>
+            >>> asyncio.run(demo_find_one(my_async_coll))
+            Count: 50
+            result0 {'_id': '479c7ce8-...', 'seq': 48}
+            result1 {'_id': '93e992c4-...', 'seq': 10}
+            result2 None
+            result3 {'_id': '479c7ce8-...'}
+            result4 {'_id': 'd656cd9d-...', 'seq': 49}
+
+            >>> asyncio.run(my_async_coll.find_one({}, vector=[1, 0]))
+            {'_id': '...', 'tag': 'D', '$vector': [4.0, 1.0]}
+
+        Note:
+            See the `find` method for more details on the accepted parameters
+            (whereas `skip` and `limit` are not valid parameters for `find_one`).
+        """
+
+        fo_cursor = self.find(
+            filter=filter,
+            projection=projection,
+            skip=None,
+            limit=1,
+            vector=vector,
+            vectorize=vectorize,
+            include_similarity=include_similarity,
+            sort=sort,
+            max_time_ms=max_time_ms,
+        )
+        try:
+            document = await fo_cursor.__anext__()
+            return document  # type: ignore[no-any-return]
+        except StopAsyncIteration:
+            return None
+
+    async def distinct(
+        self,
+        key: str,
+        *,
+        filter: Optional[FilterType] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> List[Any]:
+        """
+        Return a list of the unique values of `key` across the documents
+        in the collection that match the provided filter.
+
+        Args:
+            key: the name of the field whose value is inspected across documents.
+                Keys can use dot-notation to descend to deeper document levels.
+                Example of acceptable `key` values:
+                    "field"
+                    "field.subfield"
+                    "field.3"
+                    "field.3.subfield"
+                If lists are encountered and no numeric index is specified,
+                all items in the list are visited.
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            max_time_ms: a timeout, in milliseconds, for the operation.
+
+        Returns:
+            a list of all different values for `key` found across the documents
+            that match the filter. The result list has no repeated items.
+
+        Example:
+            >>> async def run_distinct(acol: AsyncCollection) -> None:
+            ...     await acol.insert_many(
+            ...         [
+            ...             {"name": "Marco", "food": ["apple", "orange"], "city": "Helsinki"},
+            ...             {"name": "Emma", "food": {"likes_fruit": True, "allergies": []}},
+            ...         ]
+            ...     )
+            ...     distinct0 = await acol.distinct("name")
+            ...     print("distinct('name')", distinct0)
+            ...     distinct1 = await acol.distinct("city")
+            ...     print("distinct('city')", distinct1)
+            ...     distinct2 = await acol.distinct("food")
+            ...     print("distinct('food')", distinct2)
+            ...     distinct3 = await acol.distinct("food.1")
+            ...     print("distinct('food.1')", distinct3)
+            ...     distinct4 = await acol.distinct("food.allergies")
+            ...     print("distinct('food.allergies')", distinct4)
+            ...     distinct5 = await acol.distinct("food.likes_fruit")
+            ...     print("distinct('food.likes_fruit')", distinct5)
+            ...
+            >>> asyncio.run(run_distinct(my_async_coll))
+            distinct('name') ['Emma', 'Marco']
+            distinct('city') ['Helsinki']
+            distinct('food') [{'likes_fruit': True, 'allergies': []}, 'apple', 'orange']
+            distinct('food.1') ['orange']
+            distinct('food.allergies') []
+            distinct('food.likes_fruit') [True]
+
+        Note:
+            It must be kept in mind that `distinct` is a client-side operation,
+            which effectively browses all required documents using the logic
+            of the `find` method and collects the unique values found for `key`.
+            As such, there may be performance, latency and ultimately
+            billing implications if the amount of matching documents is large.
+
+        Note:
+            For details on the behaviour of "distinct" in conjunction with
+            real-time changes in the collection contents, see the
+            Note of the `find` command.
+        """
+
+        f_cursor = AsyncCursor(
+            collection=self,
+            filter=filter,
+            projection={key: True},
+            max_time_ms=None,
+            overall_max_time_ms=max_time_ms,
+        )
+        return await f_cursor.distinct(key)  # type: ignore[no-any-return]
+
+    @recast_method_async
+    async def count_documents(
+        self,
+        filter: Dict[str, Any],
+        *,
+        upper_bound: int,
+        max_time_ms: Optional[int] = None,
+    ) -> int:
+        """
+        Count the documents in the collection matching the specified filter.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            upper_bound: a required ceiling on the result of the count operation.
+                If the actual number of documents exceeds this value,
+                an exception will be raised.
+                Furthermore, if the actual number of documents exceeds the maximum
+                count that the Data API can reach (regardless of upper_bound),
+                an exception will be raised.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            the exact count of matching documents.
+
+        Example:
+            >>> async def do_count_docs(acol: AsyncCollection) -> None:
+            ...     await acol.insert_many([{"seq": i} for i in range(20)])
+            ...     count0 = await acol.count_documents({}, upper_bound=100)
+            ...     print("count0", count0)
+            ...     count1 = await acol.count_documents({"seq":{"$gt": 15}}, upper_bound=100)
+            ...     print("count1", count1)
+            ...     count2 = await acol.count_documents({}, upper_bound=10)
+            ...     print("count2", count2)
+            ...
+            >>> asyncio.run(do_count_docs(my_async_coll))
+            count0 20
+            count1 4
+            Traceback (most recent call last):
+                ... ...
+            astrapy.exceptions.TooManyDocumentsToCountException
+
+        Note:
+            Count operations are expensive: for this reason, the best practice
+            is to provide a reasonable `upper_bound` according to the caller
+            expectations. Moreover, indiscriminate usage of count operations
+            for sizeable amounts of documents (i.e. in the thousands and more)
+            is discouraged in favor of alternative application-specific solutions.
+            Keep in mind that the Data API has a hard upper limit on the amount
+            of documents it will count, and that an exception will be thrown
+            by this method if this limit is encountered.
+        """
+
+        logger.info("calling count_documents")
+        cd_response = await self._astra_db_collection.count_documents(
+            filter=filter,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info("finished calling count_documents")
+        if "count" in cd_response.get("status", {}):
+            count: int = cd_response["status"]["count"]
+            if cd_response["status"].get("moreData", False):
+                raise TooManyDocumentsToCountException(
+                    text=f"Document count exceeds {count}, the maximum allowed by the server",
+                    server_max_count_exceeded=True,
+                )
+            else:
+                if count > upper_bound:
+                    raise TooManyDocumentsToCountException(
+                        text="Document count exceeds required upper bound",
+                        server_max_count_exceeded=False,
+                    )
+                else:
+                    return count
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from count_documents API command.",
+                raw_response=cd_response,
+            )
+
+    async def estimated_document_count(
+        self,
+        *,
+        max_time_ms: Optional[int] = None,
+    ) -> int:
+        """
+        Query the API server for an estimate of the document count in the collection.
+
+        Contrary to `count_documents`, this method has no filtering parameters.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a server-provided estimate count of the documents in the collection.
+
+        Example:
+            >>> asyncio.run(my_async_coll.estimated_document_count())
+            35700
+        """
+        ed_response = await self.command(
+            {"estimatedDocumentCount": {}},
+            max_time_ms=max_time_ms,
+        )
+        if "count" in ed_response.get("status", {}):
+            count: int = ed_response["status"]["count"]
+            return count
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from estimated_document_count API command.",
+                raw_response=ed_response,
+            )
+
+    @recast_method_async
+    async def find_one_and_replace(
+        self,
+        filter: Dict[str, Any],
+        replacement: DocumentType,
+        *,
+        projection: Optional[ProjectionType] = None,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        upsert: bool = False,
+        return_document: str = ReturnDocument.BEFORE,
+        max_time_ms: Optional[int] = None,
+    ) -> Union[DocumentType, None]:
+        """
+        Find a document on the collection and replace it entirely with a new one,
+        optionally inserting a new one if no match is found.
+
+        Args:
+
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            replacement: the new document to write into the collection.
+            projection: used to select a subset of fields in the document being
+                returned. The projection can be: an iterable over the field names
+                to return; a dictionary {field_name: True} to positively select
+                certain fields; or a dictionary {field_name: False} if one wants
+                to discard some fields from the response.
+                The default is to return the whole documents.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to use vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), as the sorting criterion.
+                In this way, the matched document (if any) will be the one
+                that is most similar to the provided vector.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            sort: with this dictionary parameter one can control the sorting
+                order of the documents matching the filter, effectively
+                determining what document will come first and hence be the
+                replaced one. See the `find` method for more on sorting.
+            upsert: this parameter controls the behavior in absence of matches.
+                If True, `replacement` is inserted as a new document
+                if no matches are found on the collection. If False,
+                the operation silently does nothing in case of no matches.
+            return_document: a flag controlling what document is returned:
+                if set to `ReturnDocument.BEFORE`, or the string "before",
+                the document found on database is returned; if set to
+                `ReturnDocument.AFTER`, or the string "after", the new
+                document is returned. The default is "before".
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            A document, either the one before the replace operation or the
+            one after that. Alternatively, the method returns None to represent
+            that no matching document was found, or that no replacement
+            was inserted (depending on the `return_document` parameter).
+
+        Example:
+            >>> async def do_find_one_and_replace(acol: AsyncCollection) -> None:
+            ...             await acol.insert_one({"_id": "rule1", "text": "all animals are equal"})
+            ...             result0 = await acol.find_one_and_replace(
+            ...                 {"_id": "rule1"},
+            ...                 {"text": "some animals are more equal!"},
+            ...             )
+            ...             print("result0", result0)
+            ...             result1 = await acol.find_one_and_replace(
+            ...                 {"text": "some animals are more equal!"},
+            ...                 {"text": "and the pigs are the rulers"},
+            ...                 return_document=astrapy.constants.ReturnDocument.AFTER,
+            ...             )
+            ...             print("result1", result1)
+            ...             result2 = await acol.find_one_and_replace(
+            ...                 {"_id": "rule2"},
+            ...                 {"text": "F=ma^2"},
+            ...                 return_document=astrapy.constants.ReturnDocument.AFTER,
+            ...             )
+            ...             print("result2", result2)
+            ...             result3 = await acol.find_one_and_replace(
+            ...                 {"_id": "rule2"},
+            ...                 {"text": "F=ma"},
+            ...                 upsert=True,
+            ...                 return_document=astrapy.constants.ReturnDocument.AFTER,
+            ...                 projection={"_id": False},
+            ...             )
+            ...             print("result3", result3)
+            ...
+            >>> asyncio.run(do_find_one_and_replace(my_async_coll))
+            result0 {'_id': 'rule1', 'text': 'all animals are equal'}
+            result1 {'_id': 'rule1', 'text': 'and the pigs are the rulers'}
+            result2 None
+            result3 {'text': 'F=ma'}
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        options = {
+            "returnDocument": return_document,
+            "upsert": upsert,
+        }
+        logger.info(f"calling find_one_and_replace on '{self.name}'")
+        fo_response = await self._astra_db_collection.find_one_and_replace(
+            replacement=replacement,
+            filter=filter,
+            projection=normalize_optional_projection(projection),
+            sort=_sort,
+            options=options,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished calling find_one_and_replace on '{self.name}'")
+        if "document" in fo_response.get("data", {}):
+            ret_document = fo_response.get("data", {}).get("document")
+            if ret_document is None:
+                return None
+            else:
+                return ret_document  # type: ignore[no-any-return]
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from find_one_and_replace API command.",
+                raw_response=fo_response,
+            )
+
+    @recast_method_async
+    async def replace_one(
+        self,
+        filter: Dict[str, Any],
+        replacement: DocumentType,
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        upsert: bool = False,
+        max_time_ms: Optional[int] = None,
+    ) -> UpdateResult:
+        """
+        Replace a single document on the collection with a new one,
+        optionally inserting a new one if no match is found.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            replacement: the new document to write into the collection.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to use vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), as the sorting criterion.
+                In this way, the matched document (if any) will be the one
+                that is most similar to the provided vector.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            sort: with this dictionary parameter one can control the sorting
+                order of the documents matching the filter, effectively
+                determining what document will come first and hence be the
+                replaced one. See the `find` method for more on sorting.
+            upsert: this parameter controls the behavior in absence of matches.
+                If True, `replacement` is inserted as a new document
+                if no matches are found on the collection. If False,
+                the operation silently does nothing in case of no matches.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            an UpdateResult object summarizing the outcome of the replace operation.
+
+        Example:
+            >>> async def do_replace_one(acol: AsyncCollection) -> None:
+            ...     await acol.insert_one({"Marco": "Polo"})
+            ...     result0 = await acol.replace_one(
+            ...         {"Marco": {"$exists": True}},
+            ...         {"Buda": "Pest"},
+            ...     )
+            ...     print("result0.update_info", result0.update_info)
+            ...     doc1 = await acol.find_one({"Buda": "Pest"})
+            ...     print("doc1", doc1)
+            ...     result1 = await acol.replace_one(
+            ...         {"Mirco": {"$exists": True}},
+            ...         {"Oh": "yeah?"},
+            ...     )
+            ...     print("result1.update_info", result1.update_info)
+            ...     result2 = await acol.replace_one(
+            ...         {"Mirco": {"$exists": True}},
+            ...         {"Oh": "yeah?"},
+            ...         upsert=True,
+            ...     )
+            ...     print("result2.update_info", result2.update_info)
+            ...
+            >>> asyncio.run(do_replace_one(my_async_coll))
+            result0.update_info {'n': 1, 'updatedExisting': True, 'ok': 1.0, 'nModified': 1}
+            doc1 {'_id': '6e669a5a-...', 'Buda': 'Pest'}
+            result1.update_info {'n': 0, 'updatedExisting': False, 'ok': 1.0, 'nModified': 0}
+            result2.update_info {'n': 1, 'updatedExisting': False, 'ok': 1.0, 'nModified': 0, 'upserted': '30e34e00-...'}
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        options = {
+            "upsert": upsert,
+        }
+        logger.info(f"calling find_one_and_replace on '{self.name}'")
+        fo_response = await self._astra_db_collection.find_one_and_replace(
+            replacement=replacement,
+            filter=filter,
+            sort=_sort,
+            options=options,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished calling find_one_and_replace on '{self.name}'")
+        if "document" in fo_response.get("data", {}):
+            fo_status = fo_response.get("status") or {}
+            _update_info = _prepare_update_info([fo_status])
+            return UpdateResult(
+                raw_results=[fo_response],
+                update_info=_update_info,
+            )
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from find_one_and_replace API command.",
+                raw_response=fo_response,
+            )
+
+    @recast_method_async
+    async def find_one_and_update(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        *,
+        projection: Optional[ProjectionType] = None,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        upsert: bool = False,
+        return_document: str = ReturnDocument.BEFORE,
+        max_time_ms: Optional[int] = None,
+    ) -> Union[DocumentType, None]:
+        """
+        Find a document on the collection and update it as requested,
+        optionally inserting a new one if no match is found.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            update: the update prescription to apply to the document, expressed
+                as a dictionary as per Data API syntax. Examples are:
+                    {"$set": {"field": "value}}
+                    {"$inc": {"counter": 10}}
+                    {"$unset": {"field": ""}}
+                See the Data API documentation for the full syntax.
+            projection: used to select a subset of fields in the document being
+                returned. The projection can be: an iterable over the field names
+                to return; a dictionary {field_name: True} to positively select
+                certain fields; or a dictionary {field_name: False} if one wants
+                to discard some fields from the response.
+                The default is to return the whole documents.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to use vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), as the sorting criterion.
+                In this way, the matched document (if any) will be the one
+                that is most similar to the provided vector.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            sort: with this dictionary parameter one can control the sorting
+                order of the documents matching the filter, effectively
+                determining what document will come first and hence be the
+                updated one. See the `find` method for more on sorting.
+            upsert: this parameter controls the behavior in absence of matches.
+                If True, a new document (resulting from applying the `update`
+                to an empty document) is inserted if no matches are found on
+                the collection. If False, the operation silently does nothing
+                in case of no matches.
+            return_document: a flag controlling what document is returned:
+                if set to `ReturnDocument.BEFORE`, or the string "before",
+                the document found on database is returned; if set to
+                `ReturnDocument.AFTER`, or the string "after", the new
+                document is returned. The default is "before".
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            A document (or a projection thereof, as required), either the one
+            before the replace operation or the one after that.
+            Alternatively, the method returns None to represent
+            that no matching document was found, or that no update
+            was applied (depending on the `return_document` parameter).
+
+        Example:
+            >>> async def do_find_one_and_update(acol: AsyncCollection) -> None:
+            ...     await acol.insert_one({"Marco": "Polo"})
+            ...     result0 = await acol.find_one_and_update(
+            ...         {"Marco": {"$exists": True}},
+            ...         {"$set": {"title": "Mr."}},
+            ...     )
+            ...     print("result0", result0)
+            ...     result1 = await acol.find_one_and_update(
+            ...         {"title": "Mr."},
+            ...         {"$inc": {"rank": 3}},
+            ...         projection=["title", "rank"],
+            ...         return_document=astrapy.constants.ReturnDocument.AFTER,
+            ...     )
+            ...     print("result1", result1)
+            ...     result2 = await acol.find_one_and_update(
+            ...         {"name": "Johnny"},
+            ...         {"$set": {"rank": 0}},
+            ...         return_document=astrapy.constants.ReturnDocument.AFTER,
+            ...     )
+            ...     print("result2", result2)
+            ...     result3 = await acol.find_one_and_update(
+            ...         {"name": "Johnny"},
+            ...         {"$set": {"rank": 0}},
+            ...         upsert=True,
+            ...         return_document=astrapy.constants.ReturnDocument.AFTER,
+            ...     )
+            ...     print("result3", result3)
+            ...
+            >>> asyncio.run(do_find_one_and_update(my_async_coll))
+            result0 {'_id': 'f7c936d3-b0a0-45eb-a676-e2829662a57c', 'Marco': 'Polo'}
+            result1 {'_id': 'f7c936d3-b0a0-45eb-a676-e2829662a57c', 'title': 'Mr.', 'rank': 3}
+            result2 None
+            result3 {'_id': 'db3d678d-14d4-4caa-82d2-d5fb77dab7ec', 'name': 'Johnny', 'rank': 0}
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        options = {
+            "returnDocument": return_document,
+            "upsert": upsert,
+        }
+        logger.info(f"calling find_one_and_update on '{self.name}'")
+        fo_response = await self._astra_db_collection.find_one_and_update(
+            update=update,
+            filter=filter,
+            projection=normalize_optional_projection(projection),
+            sort=_sort,
+            options=options,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished calling find_one_and_update on '{self.name}'")
+        if "document" in fo_response.get("data", {}):
+            ret_document = fo_response.get("data", {}).get("document")
+            if ret_document is None:
+                return None
+            else:
+                return ret_document  # type: ignore[no-any-return]
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from find_one_and_update API command.",
+                raw_response=fo_response,
+            )
+
+    @recast_method_async
+    async def update_one(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        upsert: bool = False,
+        max_time_ms: Optional[int] = None,
+    ) -> UpdateResult:
+        """
+        Update a single document on the collection as requested,
+        optionally inserting a new one if no match is found.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            update: the update prescription to apply to the document, expressed
+                as a dictionary as per Data API syntax. Examples are:
+                    {"$set": {"field": "value}}
+                    {"$inc": {"counter": 10}}
+                    {"$unset": {"field": ""}}
+                See the Data API documentation for the full syntax.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to use vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), as the sorting criterion.
+                In this way, the matched document (if any) will be the one
+                that is most similar to the provided vector.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            sort: with this dictionary parameter one can control the sorting
+                order of the documents matching the filter, effectively
+                determining what document will come first and hence be the
+                updated one. See the `find` method for more on sorting.
+            upsert: this parameter controls the behavior in absence of matches.
+                If True, a new document (resulting from applying the `update`
+                to an empty document) is inserted if no matches are found on
+                the collection. If False, the operation silently does nothing
+                in case of no matches.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            an UpdateResult object summarizing the outcome of the update operation.
+
+        Example:
+            >>> async def do_update_one(acol: AsyncCollection) -> None:
+            ...     await acol.insert_one({"Marco": "Polo"})
+            ...     result0 = await acol.update_one(
+            ...         {"Marco": {"$exists": True}},
+            ...         {"$inc": {"rank": 3}},
+            ...     )
+            ...     print("result0.update_info", result0.update_info)
+            ...     result1 = await acol.update_one(
+            ...         {"Mirko": {"$exists": True}},
+            ...         {"$inc": {"rank": 3}},
+            ...     )
+            ...     print("result1.update_info", result1.update_info)
+            ...     result2 = await acol.update_one(
+            ...         {"Mirko": {"$exists": True}},
+            ...         {"$inc": {"rank": 3}},
+            ...         upsert=True,
+            ...     )
+            ...     print("result2.update_info", result2.update_info)
+            ...
+            >>> asyncio.run(do_update_one(my_async_coll))
+            result0.update_info {'n': 1, 'updatedExisting': True, 'ok': 1.0, 'nModified': 1})
+            result1.update_info {'n': 0, 'updatedExisting': False, 'ok': 1.0, 'nModified': 0})
+            result2.update_info {'n': 1, 'updatedExisting': False, 'ok': 1.0, 'nModified': 0, 'upserted': '75748092-...'}
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        options = {
+            "upsert": upsert,
+        }
+        logger.info(f"calling find_one_and_update on '{self.name}'")
+        fo_response = await self._astra_db_collection.find_one_and_update(
+            update=update,
+            sort=_sort,
+            filter=filter,
+            options=options,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished calling find_one_and_update on '{self.name}'")
+        if "document" in fo_response.get("data", {}):
+            fo_status = fo_response.get("status") or {}
+            _update_info = _prepare_update_info([fo_status])
+            return UpdateResult(
+                raw_results=[fo_response],
+                update_info=_update_info,
+            )
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from find_one_and_update API command.",
+                raw_response=fo_response,
+            )
+
+    @recast_method_async
+    async def update_many(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        *,
+        upsert: bool = False,
+        max_time_ms: Optional[int] = None,
+    ) -> UpdateResult:
+        """
+        Apply an update operations to all documents matching a condition,
+        optionally inserting one documents in absence of matches.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            update: the update prescription to apply to the documents, expressed
+                as a dictionary as per Data API syntax. Examples are:
+                    {"$set": {"field": "value}}
+                    {"$inc": {"counter": 10}}
+                    {"$unset": {"field": ""}}
+                See the Data API documentation for the full syntax.
+            upsert: this parameter controls the behavior in absence of matches.
+                If True, a single new document (resulting from applying `update`
+                to an empty document) is inserted if no matches are found on
+                the collection. If False, the operation silently does nothing
+                in case of no matches.
+            max_time_ms: a timeout, in milliseconds, for the operation.
+
+        Returns:
+            an UpdateResult object summarizing the outcome of the update operation.
+
+        Example:
+            >>> async def do_update_many(acol: AsyncCollection) -> None:
+            ...     await acol.insert_many([{"c": "red"}, {"c": "green"}, {"c": "blue"}])
+            ...     result0 = await acol.update_many(
+            ...         {"c": {"$ne": "green"}},
+            ...         {"$set": {"nongreen": True}},
+            ...     )
+            ...     print("result0.update_info", result0.update_info)
+            ...     result1 = await acol.update_many(
+            ...         {"c": "orange"},
+            ...         {"$set": {"is_also_fruit": True}},
+            ...     )
+            ...     print("result1.update_info", result1.update_info)
+            ...     result2 = await acol.update_many(
+            ...         {"c": "orange"},
+            ...         {"$set": {"is_also_fruit": True}},
+            ...         upsert=True,
+            ...     )
+            ...     print("result2.update_info", result2.update_info)
+            ...
+            >>> asyncio.run(do_update_many(my_async_coll))
+            result0.update_info {'n': 2, 'updatedExisting': True, 'ok': 1.0, 'nModified': 2}
+            result1.update_info {'n': 0, 'updatedExisting': False, 'ok': 1.0, 'nModified': 0}
+            result2.update_info {'n': 1, 'updatedExisting': False, 'ok': 1.0, 'nModified': 0, 'upserted': '79ffd5a3-ab99-4dff-a2a5-4aaa0e59e854'}
+
+        Note:
+            Similarly to the case of `find` (see its docstring for more details),
+            running this command while, at the same time, another process is
+            inserting new documents which match the filter of the `update_many`
+            can result in an unpredictable fraction of these documents being updated.
+            In other words, it cannot be easily predicted whether a given
+            newly-inserted document will be picked up by the update_many command or not.
+        """
+
+        base_options = {
+            "upsert": upsert,
+        }
+        page_state_options: Dict[str, str] = {}
+        um_responses: List[Dict[str, Any]] = []
+        um_statuses: List[Dict[str, Any]] = []
+        must_proceed = True
+        timeout_manager = MultiCallTimeoutManager(overall_max_time_ms=max_time_ms)
+        logger.info(f"starting update_many on '{self.name}'")
+        while must_proceed:
+            options = {**base_options, **page_state_options}
+            logger.info(f"calling update_many on '{self.name}'")
+            this_um_response = await self._astra_db_collection.update_many(
+                update=update,
+                filter=filter,
+                options=options,
+                timeout_info=timeout_manager.remaining_timeout_info(),
+            )
+            logger.info(f"finished calling update_many on '{self.name}'")
+            this_um_status = this_um_response.get("status") or {}
+            #
+            # if errors, quit early
+            if this_um_response.get("errors", []):
+                partial_update_info = _prepare_update_info(um_statuses)
+                partial_result = UpdateResult(
+                    raw_results=um_responses,
+                    update_info=partial_update_info,
+                )
+                all_um_responses = um_responses + [this_um_response]
+                raise UpdateManyException.from_responses(
+                    commands=[None for _ in all_um_responses],
+                    raw_responses=all_um_responses,
+                    partial_result=partial_result,
+                )
+            else:
+                if "status" not in this_um_response:
+                    raise DataAPIFaultyResponseException(
+                        text="Faulty response from update_many API command.",
+                        raw_response=this_um_response,
+                    )
+                um_responses.append(this_um_response)
+                um_statuses.append(this_um_status)
+                next_page_state = this_um_status.get("nextPageState")
+                if next_page_state is not None:
+                    must_proceed = True
+                    page_state_options = {"pageState": next_page_state}
+                else:
+                    must_proceed = False
+                    page_state_options = {}
+
+        update_info = _prepare_update_info(um_statuses)
+        logger.info(f"finished update_many on '{self.name}'")
+        return UpdateResult(
+            raw_results=um_responses,
+            update_info=update_info,
+        )
+
+    @recast_method_async
+    async def find_one_and_delete(
+        self,
+        filter: Dict[str, Any],
+        *,
+        projection: Optional[ProjectionType] = None,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> Union[DocumentType, None]:
+        """
+        Find a document in the collection and delete it. The deleted document,
+        however, is the return value of the method.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            projection: used to select a subset of fields in the document being
+                returned. The projection can be: an iterable over the field names
+                to return; a dictionary {field_name: True} to positively select
+                certain fields; or a dictionary {field_name: False} if one wants
+                to discard some fields from the response.
+                Note that the `_id` field will be returned with the document
+                in any case, regardless of what the provided `projection` requires.
+                The default is to return the whole documents.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to use vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), as the sorting criterion.
+                In this way, the matched document (if any) will be the one
+                that is most similar to the provided vector.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            sort: with this dictionary parameter one can control the sorting
+                order of the documents matching the filter, effectively
+                determining what document will come first and hence be the
+                deleted one. See the `find` method for more on sorting.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            Either the document (or a projection thereof, as requested), or None
+            if no matches were found in the first place.
+
+        Example:
+            >>> async def do_find_one_and_delete(acol: AsyncCollection) -> None:
+            ...     await acol.insert_many(
+            ...         [
+            ...             {"species": "swan", "class": "Aves"},
+            ...             {"species": "frog", "class": "Amphibia"},
+            ...         ],
+            ...     )
+            ...     delete_result0 = await acol.find_one_and_delete(
+            ...         {"species": {"$ne": "frog"}},
+            ...         projection=["species"],
+            ...     )
+            ...     print("delete_result0", delete_result0)
+            ...     delete_result1 = await acol.find_one_and_delete(
+            ...         {"species": {"$ne": "frog"}},
+            ...     )
+            ...     print("delete_result1", delete_result1)
+            ...
+            >>> asyncio.run(do_find_one_and_delete(my_async_coll))
+            delete_result0 {'_id': 'f335cd0f-...', 'species': 'swan'}
+            delete_result1 None
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        _projection = normalize_optional_projection(projection)
+        logger.info(f"calling find_one_and_delete on '{self.name}'")
+        fo_response = await self._astra_db_collection.find_one_and_delete(
+            sort=_sort,
+            filter=filter,
+            projection=_projection,
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        logger.info(f"finished calling find_one_and_delete on '{self.name}'")
+        if "document" in fo_response.get("data", {}):
+            document = fo_response["data"]["document"]
+            return document  # type: ignore[no-any-return]
+        else:
+            deleted_count = fo_response.get("status", {}).get("deletedCount")
+            if deleted_count == 0:
+                return None
+            else:
+                raise DataAPIFaultyResponseException(
+                    text="Faulty response from find_one_and_delete API command.",
+                    raw_response=fo_response,
+                )
+
+    @recast_method_async
+    async def delete_one(
+        self,
+        filter: Dict[str, Any],
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> DeleteResult:
+        """
+        Delete one document matching a provided filter.
+        This method never deletes more than a single document, regardless
+        of the number of matches to the provided filters.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            vector: a suitable vector, i.e. a list of float numbers of the appropriate
+                dimensionality, to use vector search (i.e. ANN,
+                or "approximate nearest-neighbours" search), as the sorting criterion.
+                In this way, the matched document (if any) will be the one
+                that is most similar to the provided vector.
+                This parameter cannot be used together with `sort`.
+                See the `find` method for more details on this parameter.
+            vectorize: a string to be made into a vector to perform vector search.
+                This can be supplied in (exclusive) alternative to `vector`,
+                provided such a service is configured for the collection,
+                and achieves the same effect.
+                NOTE: This feature is under current development.
+            sort: with this dictionary parameter one can control the sorting
+                order of the documents matching the filter, effectively
+                determining what document will come first and hence be the
+                deleted one. See the `find` method for more on sorting.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a DeleteResult object summarizing the outcome of the delete operation.
+
+        Example:
+            >>> my_coll.insert_many([{"seq": 1}, {"seq": 0}, {"seq": 2}])
+            InsertManyResult(...)
+            >>> my_coll.delete_one({"seq": 1})
+            DeleteResult(raw_results=..., deleted_count=1)
+            >>> my_coll.distinct("seq")
+            [0, 2]
+            >>> my_coll.delete_one(
+            ...     {"seq": {"$exists": True}},
+            ...     sort={"seq": astrapy.constants.SortDocuments.DESCENDING},
+            ... )
+            DeleteResult(raw_results=..., deleted_count=1)
+            >>> my_coll.distinct("seq")
+            [0]
+            >>> my_coll.delete_one({"seq": 2})
+            DeleteResult(raw_results=..., deleted_count=0)
+        """
+
+        _sort = _collate_vector_to_sort(sort, vector, vectorize)
+        logger.info(f"calling delete_one_by_predicate on '{self.name}'")
+        do_response = await self._astra_db_collection.delete_one_by_predicate(
+            filter=filter,
+            timeout_info=base_timeout_info(max_time_ms),
+            sort=_sort,
+        )
+        logger.info(f"finished calling delete_one_by_predicate on '{self.name}'")
+        if "deletedCount" in do_response.get("status", {}):
+            deleted_count = do_response["status"]["deletedCount"]
+            if deleted_count == -1:
+                return DeleteResult(
+                    deleted_count=None,
+                    raw_results=[do_response],
+                )
+            else:
+                # expected a non-negative integer:
+                return DeleteResult(
+                    deleted_count=deleted_count,
+                    raw_results=[do_response],
+                )
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from delete_one API command.",
+                raw_response=do_response,
+            )
+
+    @recast_method_async
+    async def delete_many(
+        self,
+        filter: Dict[str, Any],
+        *,
+        max_time_ms: Optional[int] = None,
+    ) -> DeleteResult:
+        """
+        Delete all documents matching a provided filter.
+
+        Args:
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+                The `delete_many` method does not accept an empty filter: see
+                `delete_all` to completely erase all contents of a collection
+            max_time_ms: a timeout, in milliseconds, for the operation.
+
+        Returns:
+            a DeleteResult object summarizing the outcome of the delete operation.
+
+        Example:
+            >>> async def do_delete_many(acol: AsyncCollection) -> None:
+            ...     await acol.insert_many([{"seq": 1}, {"seq": 0}, {"seq": 2}])
+            ...     delete_result0 = await acol.delete_many({"seq": {"$lte": 1}})
+            ...     print("delete_result0.deleted_count", delete_result0.deleted_count)
+            ...     distinct1 = await acol.distinct("seq")
+            ...     print("distinct1", distinct1)
+            ...     delete_result2 = await acol.delete_many({"seq": {"$lte": 1}})
+            ...     print("delete_result2.deleted_count", delete_result2.deleted_count)
+            ...
+            >>> asyncio.run(do_delete_many(my_async_coll))
+            delete_result0.deleted_count 2
+            distinct1 [2]
+            delete_result2.deleted_count 0
+
+        Note:
+            This operation is not atomic. Depending on the amount of matching
+            documents, it can keep running (in a blocking way) for a macroscopic
+            time. In that case, new documents that are meanwhile inserted
+            (e.g. from another process/application) will be deleted during
+            the execution of this method call until the collection is devoid
+            of matches.
+        """
+
+        if not filter:
+            raise ValueError(
+                "The `filter` parameter to method `delete_many` cannot be "
+                "empty. In order to completely clear the contents of a "
+                "collection, please use the `delete_all` method."
+            )
+
+        dm_responses: List[Dict[str, Any]] = []
+        deleted_count = 0
+        must_proceed = True
+        timeout_manager = MultiCallTimeoutManager(overall_max_time_ms=max_time_ms)
+        logger.info(f"starting delete_many on '{self.name}'")
+        while must_proceed:
+            logger.info(f"calling delete_many on '{self.name}'")
+            this_dm_response = await self._astra_db_collection.delete_many(
+                filter=filter,
+                skip_error_check=True,
+                timeout_info=timeout_manager.remaining_timeout_info(),
+            )
+            logger.info(f"finished calling delete_many on '{self.name}'")
+            # if errors, quit early
+            if this_dm_response.get("errors", []):
+                partial_result = DeleteResult(
+                    deleted_count=deleted_count,
+                    raw_results=dm_responses,
+                )
+                all_dm_responses = dm_responses + [this_dm_response]
+                raise DeleteManyException.from_responses(
+                    commands=[None for _ in all_dm_responses],
+                    raw_responses=all_dm_responses,
+                    partial_result=partial_result,
+                )
+            else:
+                this_dc = this_dm_response.get("status", {}).get("deletedCount")
+                if this_dc is None or this_dc < 0:
+                    raise DataAPIFaultyResponseException(
+                        text="Faulty response from delete_many API command.",
+                        raw_response=this_dm_response,
+                    )
+                dm_responses.append(this_dm_response)
+                deleted_count += this_dc
+                must_proceed = this_dm_response.get("status", {}).get("moreData", False)
+
+        logger.info(f"finished delete_many on '{self.name}'")
+        return DeleteResult(
+            deleted_count=deleted_count,
+            raw_results=dm_responses,
+        )
+
+    @recast_method_async
+    async def delete_all(self, *, max_time_ms: Optional[int] = None) -> Dict[str, Any]:
+        """
+        Delete all documents in a collection.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a dictionary of the form {"ok": 1} to signal successful deletion.
+
+        Example:
+            >>> async def do_delete_all(acol: AsyncCollection) -> None:
+            ...     distinct0 = await acol.distinct("seq")
+            ...     print("distinct0", distinct0)
+            ...     count1 = await acol.count_documents({}, upper_bound=100)
+            ...     print("count1", count1)
+            ...     delete_result2 = await acol.delete_all()
+            ...     print("delete_result2", delete_result2)
+            ...     count3 = await acol.count_documents({}, upper_bound=100)
+            ...     print("count3", count3)
+            ...
+            >>> asyncio.run(do_delete_all(my_async_coll))
+            distinct0 [4, 2, 3, 0, 1]
+            count1 5
+            delete_result2 {'ok': 1}
+            count3 0
+
+        Note:
+            Use with caution.
+
+        Note:
+            Once the method succeeds, methods on this object can still be invoked:
+            however, this hardly makes sense as the underlying actual collection
+            is no more.
+            It is responsibility of the developer to design a correct flow
+            which avoids using a deceased collection any further.
+        """
+
+        logger.info(f"calling unfiltered delete_many on '{self.name}'")
+        dm_response = await self._astra_db_collection.delete_many(
+            filter={}, timeout_info=base_timeout_info(max_time_ms)
+        )
+        logger.info(f"finished calling unfiltered delete_many on '{self.name}'")
+        deleted_count = dm_response["status"]["deletedCount"]
+        if deleted_count == -1:
+            return {"ok": 1}
+        else:
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from delete_many API command.",
+                raw_response=dm_response,
+            )
+
+    async def bulk_write(
+        self,
+        requests: Iterable[AsyncBaseOperation],
+        *,
+        ordered: bool = True,
+        concurrency: Optional[int] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> BulkWriteResult:
+        """
+        Execute an arbitrary amount of operations such as inserts, updates, deletes
+        either sequentially or concurrently.
+
+        This method does not execute atomically, i.e. individual operations are
+        each performed in the same way as the corresponding collection method,
+        and each one is a different and unrelated database mutation.
+
+        Args:
+            requests: an iterable over concrete subclasses of `BaseOperation`,
+                such as `AsyncInsertMany` or `AsyncReplaceOne`. Each such object
+                represents an operation ready to be executed on a collection,
+                and is instantiated by passing the same parameters as one
+                would the corresponding collection method.
+            ordered: whether to launch the `requests` one after the other or
+                in arbitrary order, possibly in a concurrent fashion. For
+                performance reasons, `ordered=False` should be preferred
+                when compatible with the needs of the application flow.
+            concurrency: maximum number of concurrent operations executing at
+                a given time. It cannot be more than one for ordered bulk writes.
+            max_time_ms: a timeout, in milliseconds, for the whole bulk write.
+                Remember that, if the method call times out, then there's no
+                guarantee about what portion of the bulk write has been received
+                and successfully executed by the Data API.
+
+        Returns:
+            A single BulkWriteResult summarizing the whole list of requested
+            operations. The keys in the map attributes of BulkWriteResult
+            (when present) are the integer indices of the corresponding operation
+            in the `requests` iterable.
+
+        Example:
+            >>> from astrapy.operations import AsyncInsertMany, AsyncReplaceOne, AsyncOperation
+            >>> from astrapy.results import BulkWriteResult
+            >>>
+            >>> async def do_bulk_write(
+            ...     acol: AsyncCollection,
+            ...     async_operations: List[AsyncOperation],
+            ... ) -> BulkWriteResult:
+            ...     bw_result = await acol.bulk_write(async_operations)
+            ...     count0 = await acol.count_documents({}, upper_bound=100)
+            ...     print("count0", count0)
+            ...     distinct0 = await acol.distinct("replaced")
+            ...     print("distinct0", distinct0)
+            ...     return bw_result
+            ...
+            >>> op1 = AsyncInsertMany([{"a": 1}, {"a": 2}])
+            >>> op2 = AsyncReplaceOne(
+            ...     {"z": 9},
+            ...     replacement={"z": 9, "replaced": True},
+            ...     upsert=True,
+            ... )
+            >>> result = asyncio.run(do_bulk_write(my_async_coll, [op1, op2]))
+            count0 3
+            distinct0 [True]
+            >>> print("result", result)
+            result BulkWriteResult(bulk_api_results={0: ..., 1: ...}, deleted_count=0, inserted_count=3, matched_count=0, modified_count=0, upserted_count=1, upserted_ids={1: 'ccd0a800-...'})
+        """
+
+        # lazy importing here against circular-import error
+        from astrapy.operations import reduce_bulk_write_results
+
+        if concurrency is None:
+            if ordered:
+                _concurrency = 1
+            else:
+                _concurrency = DEFAULT_BULK_WRITE_CONCURRENCY
+        else:
+            _concurrency = concurrency
+        if _concurrency > 1 and ordered:
+            raise ValueError("Cannot run ordered bulk_write concurrently.")
+        timeout_manager = MultiCallTimeoutManager(overall_max_time_ms=max_time_ms)
+        logger.info(f"startng a bulk write on '{self.name}'")
+        if ordered:
+            bulk_write_results: List[BulkWriteResult] = []
+            for operation_i, operation in enumerate(requests):
+                try:
+                    this_bw_result = await operation.execute(
+                        self,
+                        index_in_bulk_write=operation_i,
+                        bulk_write_timeout_ms=timeout_manager.remaining_timeout_ms(),
+                    )
+                    bulk_write_results.append(this_bw_result)
+                except CumulativeOperationException as exc:
+                    partial_result = exc.partial_result
+                    partial_bw_result = reduce_bulk_write_results(
+                        bulk_write_results
+                        + [
+                            partial_result.to_bulk_write_result(
+                                index_in_bulk_write=operation_i
+                            )
+                        ]
+                    )
+                    dar_exception = exc.data_api_response_exception()
+                    raise BulkWriteException(
+                        text=dar_exception.text,
+                        error_descriptors=dar_exception.error_descriptors,
+                        detailed_error_descriptors=dar_exception.detailed_error_descriptors,
+                        partial_result=partial_bw_result,
+                        exceptions=[dar_exception],
+                    )
+                except DataAPIResponseException as exc:
+                    # the cumulative exceptions, with their
+                    # partially-done-info, are handled above:
+                    # here it's just one-shot d.a.r. exceptions
+                    partial_bw_result = reduce_bulk_write_results(bulk_write_results)
+                    dar_exception = exc.data_api_response_exception()
+                    raise BulkWriteException(
+                        text=dar_exception.text,
+                        error_descriptors=dar_exception.error_descriptors,
+                        detailed_error_descriptors=dar_exception.detailed_error_descriptors,
+                        partial_result=partial_bw_result,
+                        exceptions=[dar_exception],
+                    )
+            full_bw_result = reduce_bulk_write_results(bulk_write_results)
+            logger.info(f"finished a bulk write on '{self.name}'")
+            return full_bw_result
+        else:
+
+            sem = asyncio.Semaphore(_concurrency)
+
+            async def _concurrent_execute_as_either(
+                operation: AsyncBaseOperation, operation_i: int
+            ) -> Tuple[Optional[BulkWriteResult], Optional[DataAPIResponseException]]:
+                async with sem:
+                    try:
+                        ex_result = await operation.execute(
+                            self,
+                            index_in_bulk_write=operation_i,
+                            bulk_write_timeout_ms=timeout_manager.remaining_timeout_ms(),
+                        )
+                        return (ex_result, None)
+                    except DataAPIResponseException as exc:
+                        return (None, exc)
+
+            tasks = [
+                asyncio.create_task(
+                    _concurrent_execute_as_either(operation, operation_i)
+                )
+                for operation_i, operation in enumerate(requests)
+            ]
+            bulk_write_either_results = await asyncio.gather(*tasks)
+            # regroup
+            bulk_write_successes = [bwr for bwr, _ in bulk_write_either_results if bwr]
+            bulk_write_failures = [bwf for _, bwf in bulk_write_either_results if bwf]
+            if bulk_write_failures:
+                # extract and cumulate
+                partial_results_from_failures = [
+                    failure.partial_result.to_bulk_write_result(
+                        index_in_bulk_write=operation_i
+                    )
+                    for failure in bulk_write_failures
+                    if isinstance(failure, CumulativeOperationException)
+                ]
+                partial_bw_result = reduce_bulk_write_results(
+                    bulk_write_successes + partial_results_from_failures
+                )
+                # raise and recast the first exception
+                all_dar_exceptions = [
+                    bw_failure.data_api_response_exception()
+                    for bw_failure in bulk_write_failures
+                ]
+                dar_exception = all_dar_exceptions[0]
+                raise BulkWriteException(
+                    text=dar_exception.text,
+                    error_descriptors=dar_exception.error_descriptors,
+                    detailed_error_descriptors=dar_exception.detailed_error_descriptors,
+                    partial_result=partial_bw_result,
+                    exceptions=all_dar_exceptions,
+                )
+            else:
+                logger.info(f"finished a bulk write on '{self.name}'")
+                return reduce_bulk_write_results(bulk_write_successes)
+
+    async def drop(self, *, max_time_ms: Optional[int] = None) -> Dict[str, Any]:
+        """
+        Drop the collection, i.e. delete it from the database along with
+        all the documents it contains.
+
+        Args:
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+                Remember there is not guarantee that a request that has
+                timed out us not in fact honored.
+
+        Returns:
+            a dictionary of the form {"ok": 1} to signal successful deletion.
+
+        Example:
+            >>> async def drop_and_check(acol: AsyncCollection) -> None:
+            ...     doc0 = await acol.find_one({})
+            ...     print("doc0", doc0)
+            ...     drop_result = await acol.drop()
+            ...     print("drop_result", drop_result)
+            ...     doc1 = await acol.find_one({})
+            ...
+            >>> asyncio.run(drop_and_check(my_async_coll))
+            doc0 {'_id': '...', 'z': -10}
+            drop_result {'ok': 1}
+            Traceback (most recent call last):
+                ... ...
+            astrapy.exceptions.DataAPIResponseException: Collection does not exist, collection name: my_collection
+
+        Note:
+            Use with caution.
+
+        Note:
+            Once the method succeeds, methods on this object can still be invoked:
+            however, this hardly makes sense as the underlying actual collection
+            is no more.
+            It is responsibility of the developer to design a correct flow
+            which avoids using a deceased collection any further.
+        """
+
+        logger.info(f"dropping collection '{self.name}' (self)")
+        drop_result = await self.database.drop_collection(self, max_time_ms=max_time_ms)
+        logger.info(f"finished dropping collection '{self.name}' (self)")
+        return drop_result  # type: ignore[no-any-return]
+
+    async def command(
+        self,
+        body: Dict[str, Any],
+        *,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Send a POST request to the Data API for this collection with
+        an arbitrary, caller-provided payload.
+
+        Args:
+            body: a JSON-serializable dictionary, the payload of the request.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a dictionary with the response of the HTTP request.
+
+        Example:
+            >>> asyncio.await(my_async_coll.command({"countDocuments": {}}))
+            {'status': {'count': 123}}
+        """
+
+        logger.info(f"calling command on '{self.name}'")
+        command_result = await self.database.command(
+            body=body,
+            namespace=self.namespace,
+            collection_name=self.name,
+            max_time_ms=max_time_ms,
+        )
+        logger.info(f"finished calling command on '{self.name}'")
+        return command_result  # type: ignore[no-any-return]
diff --git a/llm/Lib/site-packages/astrapy/constants.py b/llm/Lib/site-packages/astrapy/constants.py
new file mode 100644
index 0000000000000000000000000000000000000000..3d05a146519ec648b54d0389cc88694b40e99061
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/constants.py
@@ -0,0 +1,109 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+from typing import Any, Dict, Iterable, Optional, Union
+
+
+DocumentType = Dict[str, Any]
+ProjectionType = Union[Iterable[str], Dict[str, bool]]
+SortType = Dict[str, Any]
+FilterType = Dict[str, Any]
+VectorType = Iterable[float]
+
+
+def normalize_optional_projection(
+    projection: Optional[ProjectionType],
+    ensure_fields: Iterable[str] = set(),
+) -> Optional[Dict[str, bool]]:
+    _ensure_fields = set(ensure_fields)
+    if projection:
+        if isinstance(projection, dict):
+            if any(bool(v) for v in projection.values()):
+                # positive projection: {a: True, b: True ...}
+                return {
+                    k: projection.get(k, True)
+                    for k in list(projection.keys()) + list(_ensure_fields)
+                }
+            else:
+                # negative projection: {x: False, y: False, ...}
+                return {k: v for k, v in projection.items() if k not in _ensure_fields}
+        else:
+            # an iterable over strings
+            return {field: True for field in list(projection) + list(_ensure_fields)}
+    else:
+        return None
+
+
+class ReturnDocument:
+    """
+    Admitted values for the `return_document` parameter in
+    `find_one_and_replace` and `find_one_and_update` collection
+    methods.
+    """
+
+    def __init__(self) -> None:
+        raise NotImplementedError
+
+    BEFORE = "before"
+    AFTER = "after"
+
+
+class SortDocuments:
+    """
+    Admitted values for the `sort` parameter in the find collection methods,
+    e.g. `sort={"field": SortDocuments.ASCENDING}`.
+    """
+
+    def __init__(self) -> None:
+        raise NotImplementedError
+
+    ASCENDING = 1
+    DESCENDING = -1
+
+
+class VectorMetric:
+    """
+    Admitted values for the "metric" parameter when creating vector collections
+    through the database `create_collection` method.
+    """
+
+    def __init__(self) -> None:
+        raise NotImplementedError
+
+    DOT_PRODUCT = "dot_product"
+    EUCLIDEAN = "euclidean"
+    COSINE = "cosine"
+
+
+class DefaultIdType:
+    """
+    Admitted values for the "default_id_type" parameter when creating collections
+    through the database `create_collection` method.
+    """
+
+    def __init__(self) -> None:
+        raise NotImplementedError
+
+    UUID = "uuid"
+    OBJECTID = "objectId"
+    UUIDV6 = "uuidv6"
+    UUIDV7 = "uuidv7"
+    DEFAULT = "uuid"
+
+
+__pdoc__ = {
+    "normalize_optional_projection": False,
+}
diff --git a/llm/Lib/site-packages/astrapy/core/__init__.py b/llm/Lib/site-packages/astrapy/core/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2c9ca172f8934625b393103a4674ac699e3cda29
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/core/__init__.py
@@ -0,0 +1,13 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/llm/Lib/site-packages/astrapy/core/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/astrapy/core/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e5249b327130fac71be30dd820810533cdf04895
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/core/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/core/__pycache__/api.cpython-311.pyc b/llm/Lib/site-packages/astrapy/core/__pycache__/api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fd2e64064b5bdba5f7c7a04636a71770609cc4fe
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/core/__pycache__/api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/core/__pycache__/core_types.cpython-311.pyc b/llm/Lib/site-packages/astrapy/core/__pycache__/core_types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..474cbe20614e45c0f41b7d81c7e22c3044dfc758
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/core/__pycache__/core_types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/core/__pycache__/db.cpython-311.pyc b/llm/Lib/site-packages/astrapy/core/__pycache__/db.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1d911e8aab4673f17586b2bd2e90c7970369d95c
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/core/__pycache__/db.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/core/__pycache__/defaults.cpython-311.pyc b/llm/Lib/site-packages/astrapy/core/__pycache__/defaults.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..da43c16b7e4cdd9a45606afc9df7619433024319
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/core/__pycache__/defaults.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/core/__pycache__/ids.cpython-311.pyc b/llm/Lib/site-packages/astrapy/core/__pycache__/ids.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5d1cf26816a5c3c2a318eabff271f232bc7ef7f0
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/core/__pycache__/ids.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/core/__pycache__/ops.cpython-311.pyc b/llm/Lib/site-packages/astrapy/core/__pycache__/ops.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b9883989ce491d152faa0028bb3ac9068f36cf11
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/core/__pycache__/ops.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/core/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/astrapy/core/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..32ed45e203ae0abf12bdb72c08bcf73e656af1ab
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/core/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/core/api.py b/llm/Lib/site-packages/astrapy/core/api.py
new file mode 100644
index 0000000000000000000000000000000000000000..62292cdb58db6ce7e864ea8314d65b1bd3a170d7
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/core/api.py
@@ -0,0 +1,208 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import logging
+import httpx
+from typing import Any, Dict, Optional, Union, cast
+
+from astrapy.core.core_types import API_RESPONSE
+from astrapy.core.utils import amake_request, make_request
+
+logger = logging.getLogger(__name__)
+
+
+class APIRequestError(ValueError):
+    def __init__(
+        self, response: httpx.Response, payload: Optional[Dict[str, Any]]
+    ) -> None:
+        super().__init__(response.text)
+
+        self.response = response
+        self.payload = payload
+
+    def __repr__(self) -> str:
+        return f"{self.response}"
+
+
+def raw_api_request(
+    client: httpx.Client,
+    base_url: str,
+    auth_header: str,
+    token: str,
+    method: str,
+    json_data: Optional[Dict[str, Any]],
+    url_params: Optional[Dict[str, Any]],
+    path: Optional[str],
+    caller_name: Optional[str],
+    caller_version: Optional[str],
+    timeout: Optional[Union[httpx.Timeout, float]],
+) -> httpx.Response:
+    return make_request(
+        client=client,
+        base_url=base_url,
+        auth_header=auth_header,
+        token=token,
+        method=method,
+        json_data=json_data,
+        url_params=url_params,
+        path=path,
+        caller_name=caller_name,
+        caller_version=caller_version,
+        timeout=timeout,
+    )
+
+
+def process_raw_api_response(
+    raw_response: httpx.Response,
+    skip_error_check: bool,
+    json_data: Optional[Dict[str, Any]],
+) -> API_RESPONSE:
+    # In case of other successful responses, parse the JSON body.
+    try:
+        # Cast the response to the expected type.
+        response_body: API_RESPONSE = cast(API_RESPONSE, raw_response.json())
+
+        # If the API produced an error, warn and raise it as an Exception
+        if "errors" in response_body and not skip_error_check:
+            logger.debug(response_body["errors"])
+
+            raise APIRequestError(raw_response, payload=json_data)
+
+        # Otherwise, set the response body
+        return response_body
+    except ValueError:
+        # Handle cases where json() parsing fails (e.g., empty body)
+        raise APIRequestError(raw_response, payload=json_data)
+
+
+def api_request(
+    client: httpx.Client,
+    base_url: str,
+    auth_header: str,
+    token: str,
+    method: str,
+    json_data: Optional[Dict[str, Any]],
+    url_params: Optional[Dict[str, Any]],
+    path: Optional[str],
+    skip_error_check: bool,
+    caller_name: Optional[str],
+    caller_version: Optional[str],
+    timeout: Optional[Union[httpx.Timeout, float]],
+) -> API_RESPONSE:
+    raw_response = raw_api_request(
+        client=client,
+        base_url=base_url,
+        auth_header=auth_header,
+        token=token,
+        method=method,
+        json_data=json_data,
+        url_params=url_params,
+        path=path,
+        caller_name=caller_name,
+        caller_version=caller_version,
+        timeout=timeout,
+    )
+    raw_response.raise_for_status()
+    return process_raw_api_response(
+        raw_response, skip_error_check=skip_error_check, json_data=json_data
+    )
+
+
+###
+async def async_raw_api_request(
+    client: httpx.AsyncClient,
+    base_url: str,
+    auth_header: str,
+    token: str,
+    method: str,
+    json_data: Optional[Dict[str, Any]],
+    url_params: Optional[Dict[str, Any]],
+    path: Optional[str],
+    caller_name: Optional[str],
+    caller_version: Optional[str],
+    timeout: Optional[Union[httpx.Timeout, float]],
+) -> httpx.Response:
+    return await amake_request(
+        client=client,
+        base_url=base_url,
+        auth_header=auth_header,
+        token=token,
+        method=method,
+        json_data=json_data,
+        url_params=url_params,
+        path=path,
+        caller_name=caller_name,
+        caller_version=caller_version,
+        timeout=timeout,
+    )
+
+
+async def async_process_raw_api_response(
+    raw_response: httpx.Response,
+    skip_error_check: bool,
+    json_data: Optional[Dict[str, Any]],
+) -> API_RESPONSE:
+    # In case of other successful responses, parse the JSON body.
+    try:
+        # Cast the response to the expected type.
+        response_body: API_RESPONSE = cast(API_RESPONSE, raw_response.json())
+
+        # If the API produced an error, warn and return the API request error class
+        if "errors" in response_body and not skip_error_check:
+            logger.debug(response_body["errors"])
+
+            raise APIRequestError(raw_response, payload=json_data)
+
+        # Otherwise, set the response body
+        return response_body
+    except ValueError:
+        # Handle cases where json() parsing fails (e.g., empty body)
+        raise APIRequestError(raw_response, payload=json_data)
+
+
+async def async_api_request(
+    client: httpx.AsyncClient,
+    base_url: str,
+    auth_header: str,
+    token: str,
+    method: str,
+    json_data: Optional[Dict[str, Any]],
+    url_params: Optional[Dict[str, Any]],
+    path: Optional[str],
+    skip_error_check: bool,
+    caller_name: Optional[str],
+    caller_version: Optional[str],
+    timeout: Optional[Union[httpx.Timeout, float]],
+) -> API_RESPONSE:
+    raw_response = await async_raw_api_request(
+        client=client,
+        base_url=base_url,
+        auth_header=auth_header,
+        token=token,
+        method=method,
+        json_data=json_data,
+        url_params=url_params,
+        path=path,
+        caller_name=caller_name,
+        caller_version=caller_version,
+        timeout=timeout,
+    )
+    raw_response.raise_for_status()
+    return await async_process_raw_api_response(
+        raw_response,
+        skip_error_check=skip_error_check,
+        json_data=json_data,
+    )
diff --git a/llm/Lib/site-packages/astrapy/core/core_types.py b/llm/Lib/site-packages/astrapy/core/core_types.py
new file mode 100644
index 0000000000000000000000000000000000000000..401ba062c55b4cb9e7d41283ba320e3df660f242
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/core/core_types.py
@@ -0,0 +1,43 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+from typing import Any, Dict, List, Protocol, Union
+
+# A type for:
+#     "dict from parsing a JSON from the API responses"
+# This is not exactly == the JSON specs,
+# (e.g. 'null' is valid JSON), but the JSON API are committed to always
+# return JSON objects with a mapping as top-level.
+API_RESPONSE = Dict[str, Any]
+
+# The DevOps API has a broader return type in that some calls return
+# a list at top level (e.g. "get databases")
+OPS_API_RESPONSE = Union[API_RESPONSE, List[Any]]
+
+# A type for:
+#     "document stored on the collections"
+# Identical to the above in its nature, but preferrably marked as
+# 'a disting thing, conceptually, from the returned JSONs'
+API_DOC = Dict[str, Any]
+
+
+# This is for the (partialed, if necessary) functions that can be "paginated".
+class PaginableRequestMethod(Protocol):
+    def __call__(self, options: Dict[str, Any]) -> API_RESPONSE: ...
+
+
+# This is for the (partialed, if necessary) async functions that can be "paginated".
+class AsyncPaginableRequestMethod(Protocol):
+    async def __call__(self, options: Dict[str, Any]) -> API_RESPONSE: ...
diff --git a/llm/Lib/site-packages/astrapy/core/db.py b/llm/Lib/site-packages/astrapy/core/db.py
new file mode 100644
index 0000000000000000000000000000000000000000..50a004260d075a7d6c6a663a9e5236936b498ac0
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/core/db.py
@@ -0,0 +1,3473 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import asyncio
+import deprecation
+import httpx
+import logging
+import json
+import threading
+
+from collections.abc import (
+    AsyncGenerator,
+    AsyncIterator,
+    Generator,
+    Iterator,
+)
+from concurrent.futures import ThreadPoolExecutor
+from functools import partial
+from queue import Queue
+from types import TracebackType
+from typing import (
+    Any,
+    cast,
+    Dict,
+    List,
+    Optional,
+    Tuple,
+    Union,
+    Type,
+)
+
+from astrapy import __version__
+from astrapy.core.api import APIRequestError, api_request, async_api_request
+from astrapy.core.defaults import (
+    DEFAULT_AUTH_HEADER,
+    DEFAULT_JSON_API_PATH,
+    DEFAULT_JSON_API_VERSION,
+    DEFAULT_KEYSPACE_NAME,
+    MAX_INSERT_NUM_DOCUMENTS,
+)
+from astrapy.core.utils import (
+    convert_vector_to_floats,
+    make_payload,
+    normalize_for_api,
+    restore_from_api,
+    http_methods,
+    to_httpx_timeout,
+    TimeoutInfoWideType,
+)
+from astrapy.core.core_types import (
+    API_DOC,
+    API_RESPONSE,
+    PaginableRequestMethod,
+    AsyncPaginableRequestMethod,
+)
+
+
+logger = logging.getLogger(__name__)
+
+
+class AstraDBCollection:
+    # Initialize the shared httpx client as a class attribute
+    client = httpx.Client()
+
+    def __init__(
+        self,
+        collection_name: str,
+        astra_db: Optional[AstraDB] = None,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        """
+        Initialize an AstraDBCollection instance.
+
+        Args:
+            collection_name (str): The name of the collection.
+            astra_db (AstraDB, optional): An instance of Astra DB.
+            token (str, optional): Authentication token for Astra DB.
+            api_endpoint (str, optional): API endpoint URL.
+            namespace (str, optional): Namespace for the database.
+            caller_name (str, optional): identity of the caller ("my_framework")
+                If passing a client, its caller is used as fallback
+            caller_version (str, optional): version of the caller code ("1.0.3")
+                If passing a client, its caller is used as fallback
+        """
+        # Check for presence of the Astra DB object
+        if astra_db is None:
+            if token is None or api_endpoint is None:
+                raise AssertionError("Must provide token and api_endpoint")
+
+            astra_db = AstraDB(
+                token=token,
+                api_endpoint=api_endpoint,
+                namespace=namespace,
+                caller_name=caller_name,
+                caller_version=caller_version,
+            )
+        else:
+            # if astra_db passed, copy and apply possible overrides
+            astra_db = astra_db.copy(
+                token=token,
+                api_endpoint=api_endpoint,
+                namespace=namespace,
+                caller_name=caller_name,
+                caller_version=caller_version,
+            )
+
+        # Set the remaining instance attributes
+        self.astra_db = astra_db
+        self.caller_name: Optional[str] = self.astra_db.caller_name
+        self.caller_version: Optional[str] = self.astra_db.caller_version
+        self.collection_name = collection_name
+        self.base_path: str = f"{self.astra_db.base_path}/{self.collection_name}"
+
+    def __repr__(self) -> str:
+        return f'AstraDBCollection[astra_db="{self.astra_db}", collection_name="{self.collection_name}"]'
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, AstraDBCollection):
+            return all(
+                [
+                    self.collection_name == other.collection_name,
+                    self.astra_db == other.astra_db,
+                    self.caller_name == other.caller_name,
+                    self.caller_version == other.caller_version,
+                ]
+            )
+        else:
+            return False
+
+    def copy(
+        self,
+        *,
+        collection_name: Optional[str] = None,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> AstraDBCollection:
+        return AstraDBCollection(
+            collection_name=collection_name or self.collection_name,
+            astra_db=self.astra_db.copy(
+                token=token,
+                api_endpoint=api_endpoint,
+                api_path=api_path,
+                api_version=api_version,
+                namespace=namespace,
+                caller_name=caller_name,
+                caller_version=caller_version,
+            ),
+            caller_name=caller_name or self.caller_name,
+            caller_version=caller_version or self.caller_version,
+        )
+
+    def to_async(self) -> AsyncAstraDBCollection:
+        return AsyncAstraDBCollection(
+            collection_name=self.collection_name,
+            astra_db=self.astra_db.to_async(),
+            caller_name=self.caller_name,
+            caller_version=self.caller_version,
+        )
+
+    def set_caller(
+        self,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        self.astra_db.set_caller(
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+        self.caller_name = caller_name
+        self.caller_version = caller_version
+
+    def _request(
+        self,
+        method: str = http_methods.POST,
+        path: Optional[str] = None,
+        json_data: Optional[Dict[str, Any]] = None,
+        url_params: Optional[Dict[str, Any]] = None,
+        skip_error_check: bool = False,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        direct_response = api_request(
+            client=self.client,
+            base_url=self.astra_db.base_url,
+            auth_header=DEFAULT_AUTH_HEADER,
+            token=self.astra_db.token,
+            method=method,
+            json_data=normalize_for_api(json_data),
+            url_params=url_params,
+            path=path,
+            skip_error_check=skip_error_check,
+            caller_name=self.caller_name,
+            caller_version=self.caller_version,
+            timeout=to_httpx_timeout(timeout_info),
+        )
+        response = restore_from_api(direct_response)
+        return response
+
+    def post_raw_request(
+        self, body: Dict[str, Any], timeout_info: TimeoutInfoWideType = None
+    ) -> API_RESPONSE:
+        return self._request(
+            method=http_methods.POST,
+            path=self.base_path,
+            json_data=body,
+            timeout_info=timeout_info,
+        )
+
+    def _get(
+        self,
+        path: Optional[str] = None,
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> Optional[API_RESPONSE]:
+        full_path = f"{self.base_path}/{path}" if path else self.base_path
+        response = self._request(
+            method=http_methods.GET,
+            path=full_path,
+            url_params=options,
+            timeout_info=timeout_info,
+        )
+        if isinstance(response, dict):
+            return response
+        return None
+
+    def _put(
+        self,
+        path: Optional[str] = None,
+        document: Optional[API_RESPONSE] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        full_path = f"{self.base_path}/{path}" if path else self.base_path
+        response = self._request(
+            method=http_methods.PUT,
+            path=full_path,
+            json_data=document,
+            timeout_info=timeout_info,
+        )
+        return response
+
+    def _post(
+        self,
+        path: Optional[str] = None,
+        document: Optional[API_DOC] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        full_path = f"{self.base_path}/{path}" if path else self.base_path
+        response = self._request(
+            method=http_methods.POST,
+            path=full_path,
+            json_data=document,
+            timeout_info=timeout_info,
+        )
+        return response
+
+    def _recast_as_sort_projection(
+        self, vector: List[float], fields: Optional[List[str]] = None
+    ) -> Tuple[Dict[str, Any], Optional[Dict[str, Any]]]:
+        """
+        Given a vector and optionally a list of fields,
+        reformulate them as a sort, projection pair for regular
+        'find'-like API calls (with basic validation as well).
+        """
+        # Must pass a vector
+        if not vector:
+            raise ValueError("Must pass a vector")
+
+        # Edge case for field selection
+        if fields and "$similarity" in fields:
+            raise ValueError("Please use the `include_similarity` parameter")
+
+        # Build the new vector parameter
+        sort: Dict[str, Any] = {"$vector": vector}
+
+        # Build the new fields parameter
+        # Note: do not leave projection={}, make it None
+        # (or it will devour $similarity away in the API response)
+        if fields is not None and len(fields) > 0:
+            projection = {f: 1 for f in fields}
+        else:
+            projection = None
+
+        return sort, projection
+
+    def get(
+        self, path: Optional[str] = None, timeout_info: TimeoutInfoWideType = None
+    ) -> Optional[API_RESPONSE]:
+        """
+        Retrieve a document from the collection by its path.
+
+        Args:
+            path (str, optional): The path of the document to retrieve.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The retrieved document.
+        """
+        return self._get(path=path, timeout_info=timeout_info)
+
+    def find(
+        self,
+        filter: Optional[Dict[str, Any]] = None,
+        projection: Optional[Dict[str, Any]] = None,
+        sort: Optional[Dict[str, Any]] = None,
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Find documents in the collection that match the given filter.
+
+        Args:
+            filter (dict, optional): Criteria to filter documents.
+            projection (dict, optional): Specifies the fields to return.
+            sort (dict, optional): Specifies the order in which to return matching documents.
+            options (dict, optional): Additional options for the query.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The query response containing matched documents.
+        """
+        json_query = make_payload(
+            top_level="find",
+            filter=filter,
+            projection=projection,
+            options=options,
+            sort=sort,
+        )
+
+        response = self._post(document=json_query, timeout_info=timeout_info)
+
+        return response
+
+    def vector_find(
+        self,
+        vector: List[float],
+        *,
+        limit: int,
+        filter: Optional[Dict[str, Any]] = None,
+        fields: Optional[List[str]] = None,
+        include_similarity: bool = True,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> List[API_DOC]:
+        """
+        Perform a vector-based search in the collection.
+
+        Args:
+            vector (list): The vector to search with.
+            limit (int): The maximum number of documents to return.
+            filter (dict, optional): Criteria to filter documents.
+            fields (list, optional): Specifies the fields to return.
+            include_similarity (bool, optional): Whether to include similarity score in the result.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            list: A list of documents matching the vector search criteria.
+        """
+        # Must pass a limit
+        if not limit:
+            raise ValueError("Must pass a limit")
+
+        # Pre-process the included arguments
+        sort, projection = self._recast_as_sort_projection(
+            convert_vector_to_floats(vector),
+            fields=fields,
+        )
+
+        # Call the underlying find() method to search
+        raw_find_result = self.find(
+            filter=filter,
+            projection=projection,
+            sort=sort,
+            options={
+                "limit": limit,
+                "includeSimilarity": include_similarity,
+            },
+            timeout_info=timeout_info,
+        )
+
+        return cast(List[API_DOC], raw_find_result["data"]["documents"])
+
+    @staticmethod
+    def paginate(
+        *,
+        request_method: PaginableRequestMethod,
+        options: Optional[Dict[str, Any]],
+        prefetched: Optional[int] = None,
+    ) -> Generator[API_DOC, None, None]:
+        """
+        Generate paginated results for a given database query method.
+
+        Args:
+            request_method (function): The database query method to paginate.
+            options (dict, optional): Options for the database query.
+            prefetched (int, optional): Number of pre-fetched documents.
+
+        Yields:
+            dict: The next document in the paginated result set.
+        """
+        _options = options or {}
+        response0 = request_method(options=_options)
+        next_page_state = response0["data"]["nextPageState"]
+        options0 = _options
+        if next_page_state is not None and prefetched:
+
+            def queued_paginate(
+                queue: Queue[Optional[API_DOC]],
+                request_method: PaginableRequestMethod,
+                options: Optional[Dict[str, Any]],
+            ) -> None:
+                try:
+                    for row in AstraDBCollection.paginate(
+                        request_method=request_method, options=options
+                    ):
+                        queue.put(row)
+                finally:
+                    queue.put(None)
+
+            queue: Queue[Optional[API_DOC]] = Queue(prefetched)
+            options1 = {**options0, **{"pageState": next_page_state}}
+            t = threading.Thread(
+                target=queued_paginate, args=(queue, request_method, options1)
+            )
+            t.start()
+            for document in response0["data"]["documents"]:
+                yield document
+            doc = queue.get()
+            while doc is not None:
+                yield doc
+                doc = queue.get()
+            t.join()
+        else:
+            for document in response0["data"]["documents"]:
+                yield document
+            while next_page_state is not None and not prefetched:
+                options1 = {**options0, **{"pageState": next_page_state}}
+                response1 = request_method(options=options1)
+                for document in response1["data"]["documents"]:
+                    yield document
+                next_page_state = response1["data"]["nextPageState"]
+
+    def paginated_find(
+        self,
+        filter: Optional[Dict[str, Any]] = None,
+        projection: Optional[Dict[str, Any]] = None,
+        sort: Optional[Dict[str, Any]] = None,
+        options: Optional[Dict[str, Any]] = None,
+        prefetched: Optional[int] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> Iterator[API_DOC]:
+        """
+        Perform a paginated search in the collection.
+
+        Args:
+            filter (dict, optional): Criteria to filter documents.
+            projection (dict, optional): Specifies the fields to return.
+            sort (dict, optional): Specifies the order in which to return matching documents.
+            options (dict, optional): Additional options for the query.
+            prefetched (int, optional): Number of pre-fetched documents.
+            timeout_info: a float, or a TimeoutInfo dict, for each
+                single HTTP request.
+                This is a paginated method, that issues several requests as it
+                needs more data. This parameter controls a single request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            generator: A generator yielding documents in the paginated result set.
+        """
+        partialed_find = partial(
+            self.find,
+            filter=filter,
+            projection=projection,
+            sort=sort,
+            timeout_info=timeout_info,
+        )
+        return self.paginate(
+            request_method=partialed_find,
+            options=options,
+            prefetched=prefetched,
+        )
+
+    def pop(
+        self,
+        filter: Dict[str, Any],
+        pop: Dict[str, Any],
+        options: Dict[str, Any],
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Pop the last data in the tags array
+
+        Args:
+            filter (dict): Criteria to identify the document to update.
+            pop (dict): The pop to apply to the tags.
+            options (dict): Additional options for the update operation.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The original document before the update.
+        """
+        json_query = make_payload(
+            top_level="findOneAndUpdate",
+            filter=filter,
+            update={"$pop": pop},
+            options=options,
+        )
+
+        response = self._request(
+            method=http_methods.POST,
+            path=self.base_path,
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def push(
+        self,
+        filter: Dict[str, Any],
+        push: Dict[str, Any],
+        options: Dict[str, Any],
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Push new data to the tags array
+
+        Args:
+            filter (dict): Criteria to identify the document to update.
+            push (dict): The push to apply to the tags.
+            options (dict): Additional options for the update operation.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The result of the update operation.
+        """
+        json_query = make_payload(
+            top_level="findOneAndUpdate",
+            filter=filter,
+            update={"$push": push},
+            options=options,
+        )
+
+        response = self._request(
+            method=http_methods.POST,
+            path=self.base_path,
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def find_one_and_replace(
+        self,
+        replacement: Dict[str, Any],
+        *,
+        filter: Optional[Dict[str, Any]] = None,
+        projection: Optional[Dict[str, Any]] = None,
+        sort: Optional[Dict[str, Any]] = None,
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Find a single document and replace it.
+
+        Args:
+            replacement (dict): The new document to replace the existing one.
+            filter (dict, optional): Criteria to filter documents.
+            sort (dict, optional): Specifies the order in which to find the document.
+            options (dict, optional): Additional options for the operation.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The result of the find and replace operation.
+        """
+        json_query = make_payload(
+            top_level="findOneAndReplace",
+            filter=filter,
+            projection=projection,
+            replacement=replacement,
+            options=options,
+            sort=sort,
+        )
+
+        response = self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def vector_find_one_and_replace(
+        self,
+        vector: List[float],
+        replacement: Dict[str, Any],
+        *,
+        filter: Optional[Dict[str, Any]] = None,
+        fields: Optional[List[str]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> Union[API_DOC, None]:
+        """
+        Perform a vector-based search and replace the first matched document.
+
+        Args:
+            vector (dict): The vector to search with.
+            replacement (dict): The new document to replace the existing one.
+            filter (dict, optional): Criteria to filter documents.
+            fields (list, optional): Specifies the fields to return in the result.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict or None: either the matched document or None if nothing found
+        """
+        # Pre-process the included arguments
+        sort, projection = self._recast_as_sort_projection(
+            convert_vector_to_floats(vector),
+            fields=fields,
+        )
+
+        # Call the underlying find() method to search
+        raw_find_result = self.find_one_and_replace(
+            replacement=replacement,
+            filter=filter,
+            projection=projection,
+            sort=sort,
+            timeout_info=timeout_info,
+        )
+
+        return cast(Union[API_DOC, None], raw_find_result["data"]["document"])
+
+    def find_one_and_update(
+        self,
+        update: Dict[str, Any],
+        sort: Optional[Dict[str, Any]] = {},
+        filter: Optional[Dict[str, Any]] = None,
+        options: Optional[Dict[str, Any]] = None,
+        projection: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Find a single document and update it.
+
+        Args:
+            update (dict): The update to apply to the document.
+            sort (dict, optional): Specifies the order in which to find the document.
+            filter (dict, optional): Criteria to filter documents.
+            options (dict, optional): Additional options for the operation.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The result of the find and update operation.
+        """
+        json_query = make_payload(
+            top_level="findOneAndUpdate",
+            filter=filter,
+            update=update,
+            options=options,
+            sort=sort,
+            projection=projection,
+        )
+
+        response = self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def vector_find_one_and_update(
+        self,
+        vector: List[float],
+        update: Dict[str, Any],
+        *,
+        filter: Optional[Dict[str, Any]] = None,
+        fields: Optional[List[str]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> Union[API_DOC, None]:
+        """
+        Perform a vector-based search and update the first matched document.
+
+        Args:
+            vector (list): The vector to search with.
+            update (dict): The update to apply to the matched document.
+            filter (dict, optional): Criteria to filter documents before applying the vector search.
+            fields (list, optional): Specifies the fields to return in the updated document.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict or None: The result of the vector-based find and
+                update operation, or None if nothing found
+        """
+        # Pre-process the included arguments
+        sort, projection = self._recast_as_sort_projection(
+            convert_vector_to_floats(vector),
+            fields=fields,
+        )
+
+        # Call the underlying find() method to search
+        raw_find_result = self.find_one_and_update(
+            update=update,
+            filter=filter,
+            sort=sort,
+            projection=projection,
+            timeout_info=timeout_info,
+        )
+
+        return cast(Union[API_DOC, None], raw_find_result["data"]["document"])
+
+    def find_one_and_delete(
+        self,
+        sort: Optional[Dict[str, Any]] = {},
+        filter: Optional[Dict[str, Any]] = None,
+        projection: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Find a single document and delete it.
+
+        Args:
+            sort (dict, optional): Specifies the order in which to find the document.
+            filter (dict, optional): Criteria to filter documents.
+            projection (dict, optional): Specifies the fields to return.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The result of the find and delete operation.
+        """
+        json_query = make_payload(
+            top_level="findOneAndDelete",
+            filter=filter,
+            sort=sort,
+            projection=projection,
+        )
+
+        response = self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def count_documents(
+        self, filter: Dict[str, Any] = {}, timeout_info: TimeoutInfoWideType = None
+    ) -> API_RESPONSE:
+        """
+        Count documents matching a given predicate (expressed as filter).
+
+        Args:
+            filter (dict, defaults to {}): Criteria to filter documents.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: the response, either
+                {"status": {"count": <NUMBER> }}
+            or
+                {"errors": [...]}
+        """
+        json_query = make_payload(
+            top_level="countDocuments",
+            filter=filter,
+        )
+
+        response = self._post(document=json_query, timeout_info=timeout_info)
+
+        return response
+
+    def find_one(
+        self,
+        filter: Optional[Dict[str, Any]] = {},
+        projection: Optional[Dict[str, Any]] = {},
+        sort: Optional[Dict[str, Any]] = {},
+        options: Optional[Dict[str, Any]] = {},
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Find a single document in the collection.
+
+        Args:
+            filter (dict, optional): Criteria to filter documents.
+            projection (dict, optional): Specifies the fields to return.
+            sort (dict, optional): Specifies the order in which to return the document.
+            options (dict, optional): Additional options for the query.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: the response, either
+                {"data": {"document": <DOCUMENT> }}
+            or
+                {"data": {"document": None}}
+            depending on whether a matching document is found or not.
+        """
+        json_query = make_payload(
+            top_level="findOne",
+            filter=filter,
+            projection=projection,
+            options=options,
+            sort=sort,
+        )
+
+        response = self._post(document=json_query, timeout_info=timeout_info)
+
+        return response
+
+    def vector_find_one(
+        self,
+        vector: List[float],
+        *,
+        filter: Optional[Dict[str, Any]] = None,
+        fields: Optional[List[str]] = None,
+        include_similarity: bool = True,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> Union[API_DOC, None]:
+        """
+        Perform a vector-based search to find a single document in the collection.
+
+        Args:
+            vector (list): The vector to search with.
+            filter (dict, optional): Additional criteria to filter documents.
+            fields (list, optional): Specifies the fields to return in the result.
+            include_similarity (bool, optional): Whether to include similarity score in the result.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict or None: The found document or None if no matching document is found.
+        """
+        # Pre-process the included arguments
+        sort, projection = self._recast_as_sort_projection(
+            convert_vector_to_floats(vector),
+            fields=fields,
+        )
+
+        # Call the underlying find() method to search
+        raw_find_result = self.find_one(
+            filter=filter,
+            projection=projection,
+            sort=sort,
+            options={"includeSimilarity": include_similarity},
+            timeout_info=timeout_info,
+        )
+
+        return cast(Union[API_DOC, None], raw_find_result["data"]["document"])
+
+    def insert_one(
+        self,
+        document: API_DOC,
+        failures_allowed: bool = False,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Insert a single document into the collection.
+
+        Args:
+            document (dict): The document to insert.
+            failures_allowed (bool): Whether to allow failures in the insert operation.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the insert operation.
+        """
+        json_query = make_payload(top_level="insertOne", document=document)
+
+        response = self._request(
+            method=http_methods.POST,
+            path=self.base_path,
+            json_data=json_query,
+            skip_error_check=failures_allowed,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def insert_many(
+        self,
+        documents: List[API_DOC],
+        options: Optional[Dict[str, Any]] = None,
+        partial_failures_allowed: bool = False,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Insert multiple documents into the collection.
+
+        Args:
+            documents (list): A list of documents to insert.
+            options (dict, optional): Additional options for the insert operation.
+            partial_failures_allowed (bool, optional): Whether to allow partial
+                failures through the insertion (i.e. on some documents).
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the insert operation.
+        """
+        json_query = make_payload(
+            top_level="insertMany", documents=documents, options=options
+        )
+
+        # Send the data
+        response = self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            skip_error_check=partial_failures_allowed,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def chunked_insert_many(
+        self,
+        documents: List[API_DOC],
+        options: Optional[Dict[str, Any]] = None,
+        partial_failures_allowed: bool = False,
+        chunk_size: int = MAX_INSERT_NUM_DOCUMENTS,
+        concurrency: int = 1,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> List[Union[API_RESPONSE, Exception]]:
+        """
+        Insert multiple documents into the collection, handling chunking and
+        optionally with concurrent insertions.
+
+        Args:
+            documents (list): A list of documents to insert.
+            options (dict, optional): Additional options for the insert operation.
+            partial_failures_allowed (bool, optional): Whether to allow partial
+                failures in the chunk. Should be used combined with
+                options={"ordered": False} in most cases.
+            chunk_size (int, optional): Override the default insertion chunk size.
+            concurrency (int, optional): The number of concurrent chunk insertions.
+                Default is no concurrency.
+            timeout_info: a float, or a TimeoutInfo dict, for each single HTTP request.
+                This method runs a number of HTTP requests as it works on chunked
+                data. The timeout refers to each individual such request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            list: The responses from the database after the chunked insert operation.
+                This is a list of individual responses from the API: the caller
+                will need to inspect them all, e.g. to collate the inserted IDs.
+        """
+        results: List[Union[API_RESPONSE, Exception]] = []
+
+        # Raise a warning if ordered and concurrency
+        if options and options.get("ordered") is True and concurrency > 1:
+            logger.warning(
+                "Using ordered insert with concurrency may lead to unexpected results."
+            )
+
+        # If we have concurrency as 1, don't use a thread pool
+        if concurrency == 1:
+            # Split the documents into chunks
+            for i in range(0, len(documents), chunk_size):
+                try:
+                    results.append(
+                        self.insert_many(
+                            documents[i : i + chunk_size],
+                            options,
+                            partial_failures_allowed,
+                            timeout_info=timeout_info,
+                        )
+                    )
+                except APIRequestError as e:
+                    if partial_failures_allowed:
+                        results.append(e)
+                    else:
+                        raise e
+            return results
+
+        # Perform the bulk insert with concurrency otherwise
+        with ThreadPoolExecutor(max_workers=concurrency) as executor:
+            # Submit the jobs
+            futures = [
+                executor.submit(
+                    self.insert_many,
+                    documents[i : i + chunk_size],
+                    options,
+                    partial_failures_allowed,
+                    timeout_info=timeout_info,
+                )
+                for i in range(0, len(documents), chunk_size)
+            ]
+
+            # Collect the results
+            for future in futures:
+                try:
+                    results.append(future.result())
+                except APIRequestError as e:
+                    if partial_failures_allowed:
+                        results.append(e)
+                    else:
+                        raise e
+
+        return results
+
+    def update_one(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        sort: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Update a single document in the collection.
+
+        Args:
+            filter (dict): Criteria to identify the document to update.
+            update (dict): The update to apply to the document.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the update operation.
+        """
+        json_query = make_payload(
+            top_level="updateOne",
+            filter=filter,
+            update=update,
+            sort=sort,
+        )
+
+        response = self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def update_many(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Updates multiple documents in the collection.
+
+        Args:
+            filter (dict): Criteria to identify the document to update.
+            update (dict): The update to apply to the document.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the update operation.
+        """
+        json_query = make_payload(
+            top_level="updateMany",
+            filter=filter,
+            update=update,
+            options=options,
+        )
+
+        response = self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def replace(
+        self, path: str, document: API_DOC, timeout_info: TimeoutInfoWideType = None
+    ) -> API_RESPONSE:
+        """
+        Replace a document in the collection.
+
+        Args:
+            path (str): The path to the document to replace.
+            document (dict): The new document to replace the existing one.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the replace operation.
+        """
+        return self._put(path=path, document=document, timeout_info=timeout_info)
+
+    @deprecation.deprecated(  # type: ignore
+        deprecated_in="0.7.0",
+        removed_in="1.0.0",
+        current_version=__version__,
+        details="Use the 'delete_one' method instead",
+    )
+    def delete(self, id: str, timeout_info: TimeoutInfoWideType = None) -> API_RESPONSE:
+        return self.delete_one(id, timeout_info=timeout_info)
+
+    def delete_one(
+        self,
+        id: str,
+        sort: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Delete a single document from the collection based on its ID.
+
+        Args:
+            id (str): The ID of the document to delete.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the delete operation.
+        """
+        json_query = make_payload(
+            top_level="deleteOne",
+            filter={"_id": id},
+            sort=sort,
+        )
+
+        response = self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def delete_one_by_predicate(
+        self,
+        filter: Dict[str, Any],
+        sort: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Delete a single document from the collection based on a filter clause
+
+        Args:
+            filter: any filter dictionary
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the delete operation.
+        """
+        json_query = make_payload(
+            top_level="deleteOne",
+            filter=filter,
+            sort=sort,
+        )
+
+        response = self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def delete_many(
+        self,
+        filter: Dict[str, Any],
+        skip_error_check: bool = False,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Delete many documents from the collection based on a filter condition
+
+        Args:
+            filter (dict): Criteria to identify the documents to delete.
+            skip_error_check (bool): whether to ignore the check for API error
+                and return the response untouched. Default is False.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the delete operation.
+        """
+        json_query = {
+            "deleteMany": {
+                "filter": filter,
+            }
+        }
+
+        response = self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            skip_error_check=skip_error_check,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def chunked_delete_many(
+        self, filter: Dict[str, Any], timeout_info: TimeoutInfoWideType = None
+    ) -> List[API_RESPONSE]:
+        """
+        Delete many documents from the collection based on a filter condition,
+        chaining several API calls until exhaustion of the documents to delete.
+
+        Args:
+            filter (dict): Criteria to identify the documents to delete.
+            timeout_info: a float, or a TimeoutInfo dict, for each single HTTP request.
+                This method runs a number of HTTP requests as it works on a
+                pagination basis. The timeout refers to each individual such request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            List[dict]: The responses from the database from all the calls
+        """
+        responses = []
+        must_proceed = True
+        while must_proceed:
+            dm_response = self.delete_many(filter=filter, timeout_info=timeout_info)
+            responses.append(dm_response)
+            must_proceed = dm_response.get("status", {}).get("moreData", False)
+        return responses
+
+    def clear(self, timeout_info: TimeoutInfoWideType = None) -> API_RESPONSE:
+        """
+        Clear the collection, deleting all documents
+
+        Args:
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database.
+        """
+        clear_response = self.delete_many(filter={}, timeout_info=timeout_info)
+
+        if clear_response.get("status", {}).get("deletedCount") != -1:
+            raise ValueError(
+                f"Could not issue a clear-collection API command (response: {json.dumps(clear_response)})."
+            )
+
+        return clear_response
+
+    def delete_subdocument(
+        self, id: str, subdoc: str, timeout_info: TimeoutInfoWideType = None
+    ) -> API_RESPONSE:
+        """
+        Delete a subdocument or field from a document in the collection.
+
+        Args:
+            id (str): The ID of the document containing the subdocument.
+            subdoc (str): The key of the subdocument or field to remove.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the update operation.
+        """
+        json_query = {
+            "findOneAndUpdate": {
+                "filter": {"_id": id},
+                "update": {"$unset": {subdoc: ""}},
+            }
+        }
+
+        response = self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    @deprecation.deprecated(  # type: ignore
+        deprecated_in="0.7.0",
+        removed_in="1.0.0",
+        current_version=__version__,
+        details="Use the 'upsert_one' method instead",
+    )
+    def upsert(
+        self, document: API_DOC, timeout_info: TimeoutInfoWideType = None
+    ) -> str:
+        return self.upsert_one(document, timeout_info=timeout_info)
+
+    def upsert_one(
+        self, document: API_DOC, timeout_info: TimeoutInfoWideType = None
+    ) -> str:
+        """
+        Emulate an upsert operation for a single document in the collection.
+
+        This method attempts to insert the document.
+        If a document with the same _id exists, it updates the existing document.
+
+        Args:
+            document (dict): The document to insert or update.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP requests.
+                This method may issue one or two requests, depending on what
+                is detected on DB. This timeout controls each HTTP request individually.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            str: The _id of the inserted or updated document.
+        """
+        # Build the payload for the insert attempt
+        result = self.insert_one(
+            document, failures_allowed=True, timeout_info=timeout_info
+        )
+
+        # If the call failed because of preexisting doc, then we replace it
+        if "errors" in result:
+            if (
+                "errorCode" in result["errors"][0]
+                and result["errors"][0]["errorCode"] == "DOCUMENT_ALREADY_EXISTS"
+            ):
+                # Now we attempt the update
+                result = self.find_one_and_replace(
+                    replacement=document,
+                    filter={"_id": document["_id"]},
+                    timeout_info=timeout_info,
+                )
+                upserted_id = cast(str, result["data"]["document"]["_id"])
+            else:
+                raise ValueError(result)
+        else:
+            if result.get("status", {}).get("insertedIds", []):
+                upserted_id = cast(str, result["status"]["insertedIds"][0])
+            else:
+                raise ValueError("Unexplained empty insertedIds from API")
+
+        return upserted_id
+
+    def upsert_many(
+        self,
+        documents: list[API_DOC],
+        concurrency: int = 1,
+        partial_failures_allowed: bool = False,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> List[Union[str, Exception]]:
+        """
+        Emulate an upsert operation for multiple documents in the collection.
+
+        This method attempts to insert the documents.
+        If a document with the same _id exists, it updates the existing document.
+
+        Args:
+            documents (List[dict]): The documents to insert or update.
+            concurrency (int, optional): The number of concurrent upserts.
+            partial_failures_allowed (bool, optional): Whether to allow partial
+                failures in the batch.
+            timeout_info: a float, or a TimeoutInfo dict, for each HTTP request.
+                This method issues a separate HTTP request for each document to
+                insert: the timeout controls each such request individually.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            List[Union[str, Exception]]: A list of "_id"s of the inserted or updated documents.
+        """
+        results: List[Union[str, Exception]] = []
+
+        # If concurrency is 1, no need for thread pool
+        if concurrency == 1:
+            for document in documents:
+                try:
+                    results.append(self.upsert_one(document, timeout_info=timeout_info))
+                except Exception as e:
+                    results.append(e)
+            return results
+
+        # Perform the bulk upsert with concurrency
+        with ThreadPoolExecutor(max_workers=concurrency) as executor:
+            # Submit the jobs
+            futures = [
+                executor.submit(self.upsert, document, timeout_info=timeout_info)
+                for document in documents
+            ]
+
+            # Collect the results
+            for future in futures:
+                try:
+                    results.append(future.result())
+                except Exception as e:
+                    if partial_failures_allowed:
+                        results.append(e)
+                    else:
+                        raise e
+
+        return results
+
+
+class AsyncAstraDBCollection:
+    def __init__(
+        self,
+        collection_name: str,
+        astra_db: Optional[AsyncAstraDB] = None,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        """
+        Initialize an AstraDBCollection instance.
+
+        Args:
+            collection_name (str): The name of the collection.
+            astra_db (AstraDB, optional): An instance of Astra DB.
+            token (str, optional): Authentication token for Astra DB.
+            api_endpoint (str, optional): API endpoint URL.
+            namespace (str, optional): Namespace for the database.
+            caller_name (str, optional): identity of the caller ("my_framework")
+                If passing a client, its caller is used as fallback
+            caller_version (str, optional): version of the caller code ("1.0.3")
+                If passing a client, its caller is used as fallback
+        """
+        # Check for presence of the Astra DB object
+        if astra_db is None:
+            if token is None or api_endpoint is None:
+                raise AssertionError("Must provide token and api_endpoint")
+
+            astra_db = AsyncAstraDB(
+                token=token,
+                api_endpoint=api_endpoint,
+                namespace=namespace,
+                caller_name=caller_name,
+                caller_version=caller_version,
+            )
+        else:
+            # if astra_db passed, copy and apply possible overrides
+            astra_db = astra_db.copy(
+                token=token,
+                api_endpoint=api_endpoint,
+                namespace=namespace,
+                caller_name=caller_name,
+                caller_version=caller_version,
+            )
+
+        # Set the remaining instance attributes
+        self.astra_db: AsyncAstraDB = astra_db
+        self.caller_name: Optional[str] = self.astra_db.caller_name
+        self.caller_version: Optional[str] = self.astra_db.caller_version
+        self.client = astra_db.client
+        self.collection_name = collection_name
+        self.base_path: str = f"{self.astra_db.base_path}/{self.collection_name}"
+
+    def __repr__(self) -> str:
+        return f'AsyncAstraDBCollection[astra_db="{self.astra_db}", collection_name="{self.collection_name}"]'
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, AsyncAstraDBCollection):
+            return all(
+                [
+                    self.collection_name == other.collection_name,
+                    self.astra_db == other.astra_db,
+                    self.caller_name == other.caller_name,
+                    self.caller_version == other.caller_version,
+                ]
+            )
+        else:
+            return False
+
+    def copy(
+        self,
+        *,
+        collection_name: Optional[str] = None,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> AsyncAstraDBCollection:
+        return AsyncAstraDBCollection(
+            collection_name=collection_name or self.collection_name,
+            astra_db=self.astra_db.copy(
+                token=token,
+                api_endpoint=api_endpoint,
+                api_path=api_path,
+                api_version=api_version,
+                namespace=namespace,
+                caller_name=caller_name,
+                caller_version=caller_version,
+            ),
+            caller_name=caller_name or self.caller_name,
+            caller_version=caller_version or self.caller_version,
+        )
+
+    def set_caller(
+        self,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        self.astra_db.set_caller(
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+        self.caller_name = caller_name
+        self.caller_version = caller_version
+
+    def to_sync(self) -> AstraDBCollection:
+        return AstraDBCollection(
+            collection_name=self.collection_name,
+            astra_db=self.astra_db.to_sync(),
+            caller_name=self.caller_name,
+            caller_version=self.caller_version,
+        )
+
+    async def _request(
+        self,
+        method: str = http_methods.POST,
+        path: Optional[str] = None,
+        json_data: Optional[Dict[str, Any]] = None,
+        url_params: Optional[Dict[str, Any]] = None,
+        skip_error_check: bool = False,
+        timeout_info: TimeoutInfoWideType = None,
+        **kwargs: Any,
+    ) -> API_RESPONSE:
+        adirect_response = await async_api_request(
+            client=self.client,
+            base_url=self.astra_db.base_url,
+            auth_header=DEFAULT_AUTH_HEADER,
+            token=self.astra_db.token,
+            method=method,
+            json_data=normalize_for_api(json_data),
+            url_params=url_params,
+            path=path,
+            skip_error_check=skip_error_check,
+            caller_name=self.caller_name,
+            caller_version=self.caller_version,
+            timeout=to_httpx_timeout(timeout_info),
+        )
+        response = restore_from_api(adirect_response)
+        return response
+
+    async def post_raw_request(
+        self, body: Dict[str, Any], timeout_info: TimeoutInfoWideType = None
+    ) -> API_RESPONSE:
+        return await self._request(
+            method=http_methods.POST,
+            path=self.base_path,
+            json_data=body,
+            timeout_info=timeout_info,
+        )
+
+    async def _get(
+        self,
+        path: Optional[str] = None,
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> Optional[API_RESPONSE]:
+        full_path = f"{self.base_path}/{path}" if path else self.base_path
+        response = await self._request(
+            method=http_methods.GET,
+            path=full_path,
+            url_params=options,
+            timeout_info=timeout_info,
+        )
+        if isinstance(response, dict):
+            return response
+        return None
+
+    async def _put(
+        self,
+        path: Optional[str] = None,
+        document: Optional[API_RESPONSE] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        full_path = f"{self.base_path}/{path}" if path else self.base_path
+        response = await self._request(
+            method=http_methods.PUT,
+            path=full_path,
+            json_data=document,
+            timeout_info=timeout_info,
+        )
+        return response
+
+    async def _post(
+        self,
+        path: Optional[str] = None,
+        document: Optional[API_DOC] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        full_path = f"{self.base_path}/{path}" if path else self.base_path
+        response = await self._request(
+            method=http_methods.POST,
+            path=full_path,
+            json_data=document,
+            timeout_info=timeout_info,
+        )
+        return response
+
+    def _recast_as_sort_projection(
+        self, vector: List[float], fields: Optional[List[str]] = None
+    ) -> Tuple[Dict[str, Any], Optional[Dict[str, Any]]]:
+        """
+        Given a vector and optionally a list of fields,
+        reformulate them as a sort, projection pair for regular
+        'find'-like API calls (with basic validation as well).
+        """
+        # Must pass a vector
+        if not vector:
+            raise ValueError("Must pass a vector")
+
+        # Edge case for field selection
+        if fields and "$similarity" in fields:
+            raise ValueError("Please use the `include_similarity` parameter")
+
+        # Build the new vector parameter
+        sort: Dict[str, Any] = {"$vector": vector}
+
+        # Build the new fields parameter
+        # Note: do not leave projection={}, make it None
+        # (or it will devour $similarity away in the API response)
+        if fields is not None and len(fields) > 0:
+            projection = {f: 1 for f in fields}
+        else:
+            projection = None
+
+        return sort, projection
+
+    async def get(
+        self, path: Optional[str] = None, timeout_info: TimeoutInfoWideType = None
+    ) -> Optional[API_RESPONSE]:
+        """
+        Retrieve a document from the collection by its path.
+
+        Args:
+            path (str, optional): The path of the document to retrieve.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The retrieved document.
+        """
+        return await self._get(path=path, timeout_info=timeout_info)
+
+    async def find(
+        self,
+        filter: Optional[Dict[str, Any]] = None,
+        projection: Optional[Dict[str, Any]] = None,
+        sort: Optional[Dict[str, Any]] = None,
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Find documents in the collection that match the given filter.
+
+        Args:
+            filter (dict, optional): Criteria to filter documents.
+            projection (dict, optional): Specifies the fields to return.
+            sort (dict, optional): Specifies the order in which to return matching documents.
+            options (dict, optional): Additional options for the query.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The query response containing matched documents.
+        """
+        json_query = make_payload(
+            top_level="find",
+            filter=filter,
+            projection=projection,
+            options=options,
+            sort=sort,
+        )
+
+        response = await self._post(document=json_query, timeout_info=timeout_info)
+
+        return response
+
+    async def vector_find(
+        self,
+        vector: List[float],
+        *,
+        limit: int,
+        filter: Optional[Dict[str, Any]] = None,
+        fields: Optional[List[str]] = None,
+        include_similarity: bool = True,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> List[API_DOC]:
+        """
+        Perform a vector-based search in the collection.
+
+        Args:
+            vector (list): The vector to search with.
+            limit (int): The maximum number of documents to return.
+            filter (dict, optional): Criteria to filter documents.
+            fields (list, optional): Specifies the fields to return.
+            include_similarity (bool, optional): Whether to include similarity score in the result.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            list: A list of documents matching the vector search criteria.
+        """
+        # Must pass a limit
+        if not limit:
+            raise ValueError("Must pass a limit")
+
+        # Pre-process the included arguments
+        sort, projection = self._recast_as_sort_projection(
+            vector,
+            fields=fields,
+        )
+
+        # Call the underlying find() method to search
+        raw_find_result = await self.find(
+            filter=filter,
+            projection=projection,
+            sort=sort,
+            options={
+                "limit": limit,
+                "includeSimilarity": include_similarity,
+            },
+            timeout_info=timeout_info,
+        )
+
+        return cast(List[API_DOC], raw_find_result["data"]["documents"])
+
+    @staticmethod
+    async def paginate(
+        *,
+        request_method: AsyncPaginableRequestMethod,
+        options: Optional[Dict[str, Any]],
+        prefetched: Optional[int] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> AsyncGenerator[API_DOC, None]:
+        """
+        Generate paginated results for a given database query method.
+
+        Args:
+            request_method (function): The database query method to paginate.
+            options (dict, optional): Options for the database query.
+            prefetched (int, optional): Number of pre-fetched documents.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Yields:
+            dict: The next document in the paginated result set.
+        """
+        _options = options or {}
+        response0 = await request_method(options=_options)
+        next_page_state = response0["data"]["nextPageState"]
+        options0 = _options
+        if next_page_state is not None and prefetched:
+
+            async def queued_paginate(
+                queue: asyncio.Queue[Optional[API_DOC]],
+                request_method: AsyncPaginableRequestMethod,
+                options: Optional[Dict[str, Any]],
+            ) -> None:
+                try:
+                    async for doc in AsyncAstraDBCollection.paginate(
+                        request_method=request_method, options=options
+                    ):
+                        await queue.put(doc)
+                finally:
+                    await queue.put(None)
+
+            queue: asyncio.Queue[Optional[API_DOC]] = asyncio.Queue(prefetched)
+            options1 = {**options0, **{"pageState": next_page_state}}
+            asyncio.create_task(queued_paginate(queue, request_method, options1))
+            for document in response0["data"]["documents"]:
+                yield document
+            doc = await queue.get()
+            while doc is not None:
+                yield doc
+                doc = await queue.get()
+        else:
+            for document in response0["data"]["documents"]:
+                yield document
+            while next_page_state is not None:
+                options1 = {**options0, **{"pageState": next_page_state}}
+                response1 = await request_method(options=options1)
+                for document in response1["data"]["documents"]:
+                    yield document
+                next_page_state = response1["data"]["nextPageState"]
+
+    def paginated_find(
+        self,
+        filter: Optional[Dict[str, Any]] = None,
+        projection: Optional[Dict[str, Any]] = None,
+        sort: Optional[Dict[str, Any]] = None,
+        options: Optional[Dict[str, Any]] = None,
+        prefetched: Optional[int] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> AsyncIterator[API_DOC]:
+        """
+        Perform a paginated search in the collection.
+
+        Args:
+            filter (dict, optional): Criteria to filter documents.
+            projection (dict, optional): Specifies the fields to return.
+            sort (dict, optional): Specifies the order in which to return matching documents.
+            options (dict, optional): Additional options for the query.
+            prefetched (int, optional): Number of pre-fetched documents
+            timeout_info: a float, or a TimeoutInfo dict, for each
+                single HTTP request.
+                This is a paginated method, that issues several requests as it
+                needs more data. This parameter controls a single request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            generator: A generator yielding documents in the paginated result set.
+        """
+        partialed_find = partial(
+            self.find,
+            filter=filter,
+            projection=projection,
+            sort=sort,
+            timeout_info=timeout_info,
+        )
+        return self.paginate(
+            request_method=partialed_find,
+            options=options,
+            prefetched=prefetched,
+        )
+
+    async def pop(
+        self,
+        filter: Dict[str, Any],
+        pop: Dict[str, Any],
+        options: Dict[str, Any],
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Pop the last data in the tags array
+
+        Args:
+            filter (dict): Criteria to identify the document to update.
+            pop (dict): The pop to apply to the tags.
+            options (dict): Additional options for the update operation.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The original document before the update.
+        """
+        json_query = make_payload(
+            top_level="findOneAndUpdate",
+            filter=filter,
+            update={"$pop": pop},
+            options=options,
+        )
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=self.base_path,
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def push(
+        self,
+        filter: Dict[str, Any],
+        push: Dict[str, Any],
+        options: Dict[str, Any],
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Push new data to the tags array
+
+        Args:
+            filter (dict): Criteria to identify the document to update.
+            push (dict): The push to apply to the tags.
+            options (dict): Additional options for the update operation.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The result of the update operation.
+        """
+        json_query = make_payload(
+            top_level="findOneAndUpdate",
+            filter=filter,
+            update={"$push": push},
+            options=options,
+        )
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=self.base_path,
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def find_one_and_replace(
+        self,
+        replacement: Dict[str, Any],
+        *,
+        filter: Optional[Dict[str, Any]] = None,
+        projection: Optional[Dict[str, Any]] = None,
+        sort: Optional[Dict[str, Any]] = None,
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Find a single document and replace it.
+
+        Args:
+            replacement (dict): The new document to replace the existing one.
+            filter (dict, optional): Criteria to filter documents.
+            sort (dict, optional): Specifies the order in which to find the document.
+            options (dict, optional): Additional options for the operation.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The result of the find and replace operation.
+        """
+        json_query = make_payload(
+            top_level="findOneAndReplace",
+            filter=filter,
+            projection=projection,
+            replacement=replacement,
+            options=options,
+            sort=sort,
+        )
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def vector_find_one_and_replace(
+        self,
+        vector: List[float],
+        replacement: Dict[str, Any],
+        *,
+        filter: Optional[Dict[str, Any]] = None,
+        fields: Optional[List[str]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> Union[API_DOC, None]:
+        """
+        Perform a vector-based search and replace the first matched document.
+
+        Args:
+            vector (dict): The vector to search with.
+            replacement (dict): The new document to replace the existing one.
+            filter (dict, optional): Criteria to filter documents.
+            fields (list, optional): Specifies the fields to return in the result.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict or None: either the matched document or None if nothing found
+        """
+        # Pre-process the included arguments
+        sort, projection = self._recast_as_sort_projection(
+            vector,
+            fields=fields,
+        )
+
+        # Call the underlying find() method to search
+        raw_find_result = await self.find_one_and_replace(
+            replacement=replacement,
+            filter=filter,
+            projection=projection,
+            sort=sort,
+            timeout_info=timeout_info,
+        )
+
+        return cast(Union[API_DOC, None], raw_find_result["data"]["document"])
+
+    async def find_one_and_update(
+        self,
+        update: Dict[str, Any],
+        sort: Optional[Dict[str, Any]] = {},
+        filter: Optional[Dict[str, Any]] = None,
+        options: Optional[Dict[str, Any]] = None,
+        projection: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Find a single document and update it.
+
+        Args:
+            sort (dict, optional): Specifies the order in which to find the document.
+            update (dict): The update to apply to the document.
+            filter (dict, optional): Criteria to filter documents.
+            options (dict, optional): Additional options for the operation.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The result of the find and update operation.
+        """
+        json_query = make_payload(
+            top_level="findOneAndUpdate",
+            filter=filter,
+            update=update,
+            options=options,
+            sort=sort,
+            projection=projection,
+        )
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def vector_find_one_and_update(
+        self,
+        vector: List[float],
+        update: Dict[str, Any],
+        *,
+        filter: Optional[Dict[str, Any]] = None,
+        fields: Optional[List[str]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> Union[API_DOC, None]:
+        """
+        Perform a vector-based search and update the first matched document.
+
+        Args:
+            vector (list): The vector to search with.
+            update (dict): The update to apply to the matched document.
+            filter (dict, optional): Criteria to filter documents before applying the vector search.
+            fields (list, optional): Specifies the fields to return in the updated document.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict or None: The result of the vector-based find and
+                update operation, or None if nothing found
+        """
+        # Pre-process the included arguments
+        sort, projection = self._recast_as_sort_projection(
+            vector,
+            fields=fields,
+        )
+
+        # Call the underlying find() method to search
+        raw_find_result = await self.find_one_and_update(
+            update=update,
+            filter=filter,
+            sort=sort,
+            projection=projection,
+            timeout_info=timeout_info,
+        )
+
+        return cast(Union[API_DOC, None], raw_find_result["data"]["document"])
+
+    async def find_one_and_delete(
+        self,
+        sort: Optional[Dict[str, Any]] = {},
+        filter: Optional[Dict[str, Any]] = None,
+        projection: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Find a single document and delete it.
+
+        Args:
+            sort (dict, optional): Specifies the order in which to find the document.
+            filter (dict, optional): Criteria to filter documents.
+            projection (dict, optional): Specifies the fields to return.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The result of the find and delete operation.
+        """
+        json_query = make_payload(
+            top_level="findOneAndDelete",
+            filter=filter,
+            sort=sort,
+            projection=projection,
+        )
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def count_documents(
+        self, filter: Dict[str, Any] = {}, timeout_info: TimeoutInfoWideType = None
+    ) -> API_RESPONSE:
+        """
+        Count documents matching a given predicate (expressed as filter).
+
+        Args:
+            filter (dict, defaults to {}): Criteria to filter documents.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: the response, either
+                {"status": {"count": <NUMBER> }}
+            or
+                {"errors": [...]}
+        """
+        json_query = make_payload(
+            top_level="countDocuments",
+            filter=filter,
+        )
+
+        response = await self._post(document=json_query, timeout_info=timeout_info)
+
+        return response
+
+    async def find_one(
+        self,
+        filter: Optional[Dict[str, Any]] = {},
+        projection: Optional[Dict[str, Any]] = {},
+        sort: Optional[Dict[str, Any]] = {},
+        options: Optional[Dict[str, Any]] = {},
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Find a single document in the collection.
+
+        Args:
+            filter (dict, optional): Criteria to filter documents.
+            projection (dict, optional): Specifies the fields to return.
+            sort (dict, optional): Specifies the order in which to return the document.
+            options (dict, optional): Additional options for the query.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: the response, either
+                {"data": {"document": <DOCUMENT> }}
+            or
+                {"data": {"document": None}}
+            depending on whether a matching document is found or not.
+        """
+        json_query = make_payload(
+            top_level="findOne",
+            filter=filter,
+            projection=projection,
+            options=options,
+            sort=sort,
+        )
+
+        response = await self._post(document=json_query, timeout_info=timeout_info)
+
+        return response
+
+    async def vector_find_one(
+        self,
+        vector: List[float],
+        *,
+        filter: Optional[Dict[str, Any]] = None,
+        fields: Optional[List[str]] = None,
+        include_similarity: bool = True,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> Union[API_DOC, None]:
+        """
+        Perform a vector-based search to find a single document in the collection.
+
+        Args:
+            vector (list): The vector to search with.
+            filter (dict, optional): Additional criteria to filter documents.
+            fields (list, optional): Specifies the fields to return in the result.
+            include_similarity (bool, optional): Whether to include similarity score in the result.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict or None: The found document or None if no matching document is found.
+        """
+        # Pre-process the included arguments
+        sort, projection = self._recast_as_sort_projection(
+            vector,
+            fields=fields,
+        )
+
+        # Call the underlying find() method to search
+        raw_find_result = await self.find_one(
+            filter=filter,
+            projection=projection,
+            sort=sort,
+            options={"includeSimilarity": include_similarity},
+            timeout_info=timeout_info,
+        )
+
+        return cast(Union[API_DOC, None], raw_find_result["data"]["document"])
+
+    async def insert_one(
+        self,
+        document: API_DOC,
+        failures_allowed: bool = False,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Insert a single document into the collection.
+
+        Args:
+            document (dict): The document to insert.
+            failures_allowed (bool): Whether to allow failures in the insert operation.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the insert operation.
+        """
+        json_query = make_payload(top_level="insertOne", document=document)
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=self.base_path,
+            json_data=json_query,
+            skip_error_check=failures_allowed,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def insert_many(
+        self,
+        documents: List[API_DOC],
+        options: Optional[Dict[str, Any]] = None,
+        partial_failures_allowed: bool = False,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Insert multiple documents into the collection.
+
+        Args:
+            documents (list): A list of documents to insert.
+            options (dict, optional): Additional options for the insert operation.
+            partial_failures_allowed (bool, optional): Whether to allow partial
+                failures through the insertion (i.e. on some documents).
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the insert operation.
+        """
+        json_query = make_payload(
+            top_level="insertMany", documents=documents, options=options
+        )
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            skip_error_check=partial_failures_allowed,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def chunked_insert_many(
+        self,
+        documents: List[API_DOC],
+        options: Optional[Dict[str, Any]] = None,
+        partial_failures_allowed: bool = False,
+        chunk_size: int = MAX_INSERT_NUM_DOCUMENTS,
+        concurrency: int = 1,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> List[Union[API_RESPONSE, Exception]]:
+        """
+        Insert multiple documents into the collection, handling chunking and
+        optionally with concurrent insertions.
+
+        Args:
+            documents (list): A list of documents to insert.
+            options (dict, optional): Additional options for the insert operation.
+            partial_failures_allowed (bool, optional): Whether to allow partial
+                failures in the chunk. Should be used combined with
+                options={"ordered": False} in most cases.
+            chunk_size (int, optional): Override the default insertion chunk size.
+            concurrency (int, optional): The number of concurrent chunk insertions.
+                Default is no concurrency.
+            timeout_info: a float, or a TimeoutInfo dict, for each single HTTP request.
+                This method runs a number of HTTP requests as it works on chunked
+                data. The timeout refers to each individual such request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            list: The responses from the database after the chunked insert operation.
+                This is a list of individual responses from the API: the caller
+                will need to inspect them all, e.g. to collate the inserted IDs.
+        """
+        sem = asyncio.Semaphore(concurrency)
+
+        async def concurrent_insert_many(
+            docs: List[API_DOC],
+            index: int,
+            partial_failures_allowed: bool,
+        ) -> Union[API_RESPONSE, Exception]:
+            async with sem:
+                logger.debug(f"Processing chunk #{index + 1} of size {len(docs)}")
+                try:
+                    return await self.insert_many(
+                        documents=docs,
+                        options=options,
+                        partial_failures_allowed=partial_failures_allowed,
+                        timeout_info=timeout_info,
+                    )
+                except APIRequestError as e:
+                    if partial_failures_allowed:
+                        return e
+                    else:
+                        raise e
+
+        if concurrency > 1:
+            tasks = [
+                asyncio.create_task(
+                    concurrent_insert_many(
+                        documents[i : i + chunk_size], i, partial_failures_allowed
+                    )
+                )
+                for i in range(0, len(documents), chunk_size)
+            ]
+            results = await asyncio.gather(*tasks, return_exceptions=False)
+        else:
+            # this ensures the expectation of
+            # "sequential strictly obeys fail-fast if ordered and concurrency==1"
+            results = [
+                await concurrent_insert_many(
+                    documents[i : i + chunk_size], i, partial_failures_allowed
+                )
+                for i in range(0, len(documents), chunk_size)
+            ]
+        return results
+
+    async def update_one(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        sort: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Update a single document in the collection.
+
+        Args:
+            filter (dict): Criteria to identify the document to update.
+            update (dict): The update to apply to the document.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the update operation.
+        """
+        json_query = make_payload(
+            top_level="updateOne",
+            filter=filter,
+            update=update,
+            sort=sort,
+        )
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def update_many(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Updates multiple documents in the collection.
+
+        Args:
+            filter (dict): Criteria to identify the document to update.
+            update (dict): The update to apply to the document.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the update operation.
+        """
+        json_query = make_payload(
+            top_level="updateMany",
+            filter=filter,
+            update=update,
+            options=options,
+        )
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def replace(
+        self, path: str, document: API_DOC, timeout_info: TimeoutInfoWideType = None
+    ) -> API_RESPONSE:
+        """
+        Replace a document in the collection.
+
+        Args:
+            path (str): The path to the document to replace.
+            document (dict): The new document to replace the existing one.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the replace operation.
+        """
+        return await self._put(path=path, document=document, timeout_info=timeout_info)
+
+    async def delete_one(
+        self,
+        id: str,
+        sort: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Delete a single document from the collection based on its ID.
+
+        Args:
+            id (str): The ID of the document to delete.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the delete operation.
+        """
+        json_query = make_payload(
+            top_level="deleteOne",
+            filter={"_id": id},
+            sort=sort,
+        )
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def delete_one_by_predicate(
+        self,
+        filter: Dict[str, Any],
+        sort: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Delete a single document from the collection based on a filter clause
+
+        Args:
+            filter: any filter dictionary
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the delete operation.
+        """
+        json_query = make_payload(
+            top_level="deleteOne",
+            filter=filter,
+            sort=sort,
+        )
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def delete_many(
+        self,
+        filter: Dict[str, Any],
+        skip_error_check: bool = False,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Delete many documents from the collection based on a filter condition
+
+        Args:
+            filter (dict): Criteria to identify the documents to delete.
+            skip_error_check (bool): whether to ignore the check for API error
+                and return the response untouched. Default is False.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the delete operation.
+        """
+        json_query = {
+            "deleteMany": {
+                "filter": filter,
+            }
+        }
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            skip_error_check=skip_error_check,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def chunked_delete_many(
+        self, filter: Dict[str, Any], timeout_info: TimeoutInfoWideType = None
+    ) -> List[API_RESPONSE]:
+        """
+        Delete many documents from the collection based on a filter condition,
+        chaining several API calls until exhaustion of the documents to delete.
+
+        Args:
+            filter (dict): Criteria to identify the documents to delete.
+            timeout_info: a float, or a TimeoutInfo dict, for each single HTTP request.
+                This method runs a number of HTTP requests as it works on a
+                pagination basis. The timeout refers to each individual such request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            List[dict]: The responses from the database from all the calls
+        """
+        responses = []
+        must_proceed = True
+        while must_proceed:
+            dm_response = await self.delete_many(
+                filter=filter, timeout_info=timeout_info
+            )
+            responses.append(dm_response)
+            must_proceed = dm_response.get("status", {}).get("moreData", False)
+        return responses
+
+    async def clear(self, timeout_info: TimeoutInfoWideType = None) -> API_RESPONSE:
+        """
+        Clear the collection, deleting all documents
+
+        Args:
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database.
+        """
+        clear_response = await self.delete_many(filter={}, timeout_info=timeout_info)
+
+        if clear_response.get("status", {}).get("deletedCount") != -1:
+            raise ValueError(
+                f"Could not issue a clear-collection API command (response: {json.dumps(clear_response)})."
+            )
+
+        return clear_response
+
+    async def delete_subdocument(
+        self, id: str, subdoc: str, timeout_info: TimeoutInfoWideType = None
+    ) -> API_RESPONSE:
+        """
+        Delete a subdocument or field from a document in the collection.
+
+        Args:
+            id (str): The ID of the document containing the subdocument.
+            subdoc (str): The key of the subdocument or field to remove.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database after the update operation.
+        """
+        json_query = {
+            "findOneAndUpdate": {
+                "filter": {"_id": id},
+                "update": {"$unset": {subdoc: ""}},
+            }
+        }
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    @deprecation.deprecated(  # type: ignore
+        deprecated_in="0.7.0",
+        removed_in="1.0.0",
+        current_version=__version__,
+        details="Use the 'upsert_one' method instead",
+    )
+    async def upsert(
+        self, document: API_DOC, timeout_info: TimeoutInfoWideType = None
+    ) -> str:
+        return await self.upsert_one(document, timeout_info=timeout_info)
+
+    async def upsert_one(
+        self,
+        document: API_DOC,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> str:
+        """
+        Emulate an upsert operation for a single document in the collection.
+
+        This method attempts to insert the document.
+        If a document with the same _id exists, it updates the existing document.
+
+        Args:
+            document (dict): The document to insert or update.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP requests.
+                This method may issue one or two requests, depending on what
+                is detected on DB. This timeout controls each HTTP request individually.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            str: The _id of the inserted or updated document.
+        """
+        # Build the payload for the insert attempt
+        result = await self.insert_one(
+            document, failures_allowed=True, timeout_info=timeout_info
+        )
+
+        # If the call failed because of preexisting doc, then we replace it
+        if "errors" in result:
+            if (
+                "errorCode" in result["errors"][0]
+                and result["errors"][0]["errorCode"] == "DOCUMENT_ALREADY_EXISTS"
+            ):
+                # Now we attempt the update
+                result = await self.find_one_and_replace(
+                    replacement=document,
+                    filter={"_id": document["_id"]},
+                    timeout_info=timeout_info,
+                )
+                upserted_id = cast(str, result["data"]["document"]["_id"])
+            else:
+                raise ValueError(result)
+        else:
+            if result.get("status", {}).get("insertedIds", []):
+                upserted_id = cast(str, result["status"]["insertedIds"][0])
+            else:
+                raise ValueError("Unexplained empty insertedIds from API")
+
+        return upserted_id
+
+    async def upsert_many(
+        self,
+        documents: list[API_DOC],
+        concurrency: int = 1,
+        partial_failures_allowed: bool = False,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> List[Union[str, Exception]]:
+        """
+        Emulate an upsert operation for multiple documents in the collection.
+        This method attempts to insert the documents.
+        If a document with the same _id exists, it updates the existing document.
+
+        Args:
+            documents (List[dict]): The documents to insert or update.
+            concurrency (int, optional): The number of concurrent upserts.
+            partial_failures_allowed (bool, optional): Whether to allow partial
+                failures in the batch.
+            timeout_info: a float, or a TimeoutInfo dict, for each HTTP request.
+                This method issues a separate HTTP request for each document to
+                insert: the timeout controls each such request individually.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            List[Union[str, Exception]]: A list of "_id"s of the inserted or updated documents.
+        """
+        sem = asyncio.Semaphore(concurrency)
+
+        async def concurrent_upsert(doc: API_DOC) -> str:
+            async with sem:
+                return await self.upsert_one(document=doc, timeout_info=timeout_info)
+
+        tasks = [asyncio.create_task(concurrent_upsert(doc)) for doc in documents]
+        results = await asyncio.gather(
+            *tasks, return_exceptions=partial_failures_allowed
+        )
+        for result in results:
+            if isinstance(result, BaseException) and not isinstance(result, Exception):
+                raise result
+        return results  # type: ignore
+
+
+class AstraDB:
+    # Initialize the shared httpx client as a class attribute
+    client = httpx.Client()
+
+    def __init__(
+        self,
+        token: str,
+        api_endpoint: str,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        """
+        Initialize an Astra DB instance.
+
+        Args:
+            token (str): Authentication token for Astra DB.
+            api_endpoint (str): API endpoint URL.
+            api_path (str, optional): used to override default URI construction
+            api_version (str, optional): to override default URI construction
+            namespace (str, optional): Namespace for the database.
+            caller_name (str, optional): identity of the caller ("my_framework")
+            caller_version (str, optional): version of the caller code ("1.0.3")
+        """
+        self.caller_name = caller_name
+        self.caller_version = caller_version
+
+        if token is None or api_endpoint is None:
+            raise AssertionError("Must provide token and api_endpoint")
+
+        if namespace is None:
+            logger.info(
+                f"ASTRA_DB_KEYSPACE is not set. Defaulting to '{DEFAULT_KEYSPACE_NAME}'"
+            )
+            namespace = DEFAULT_KEYSPACE_NAME
+
+        # Store the API token
+        self.token = token
+
+        self.api_endpoint = api_endpoint
+
+        # Set the Base URL for the API calls
+        self.base_url = self.api_endpoint.strip("/")
+
+        # Set the API version and path from the call
+        self.api_path = (api_path or DEFAULT_JSON_API_PATH).strip("/")
+        self.api_version = (api_version or DEFAULT_JSON_API_VERSION).strip("/")
+
+        # Set the namespace
+        self.namespace = namespace
+
+        # Finally, construct the full base path
+        self.base_path: str = f"/{self.api_path}/{self.api_version}/{self.namespace}"
+
+    def __repr__(self) -> str:
+        return f'AstraDB[endpoint="{self.base_url}", keyspace="{self.namespace}"]'
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, AstraDB):
+            # work on the "normalized" quantities (stripped, etc)
+            return all(
+                [
+                    self.token == other.token,
+                    self.base_url == other.base_url,
+                    self.base_path == other.base_path,
+                    self.caller_name == other.caller_name,
+                    self.caller_version == other.caller_version,
+                ]
+            )
+        else:
+            return False
+
+    def copy(
+        self,
+        *,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> AstraDB:
+        return AstraDB(
+            token=token or self.token,
+            api_endpoint=api_endpoint or self.base_url,
+            api_path=api_path or self.api_path,
+            api_version=api_version or self.api_version,
+            namespace=namespace or self.namespace,
+            caller_name=caller_name or self.caller_name,
+            caller_version=caller_version or self.caller_version,
+        )
+
+    def to_async(self) -> AsyncAstraDB:
+        return AsyncAstraDB(
+            token=self.token,
+            api_endpoint=self.base_url,
+            api_path=self.api_path,
+            api_version=self.api_version,
+            namespace=self.namespace,
+            caller_name=self.caller_name,
+            caller_version=self.caller_version,
+        )
+
+    def set_caller(
+        self,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        self.caller_name = caller_name
+        self.caller_version = caller_version
+
+    def _request(
+        self,
+        method: str = http_methods.POST,
+        path: Optional[str] = None,
+        json_data: Optional[Dict[str, Any]] = None,
+        url_params: Optional[Dict[str, Any]] = None,
+        skip_error_check: bool = False,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        direct_response = api_request(
+            client=self.client,
+            base_url=self.base_url,
+            auth_header=DEFAULT_AUTH_HEADER,
+            token=self.token,
+            method=method,
+            json_data=normalize_for_api(json_data),
+            url_params=url_params,
+            path=path,
+            skip_error_check=skip_error_check,
+            caller_name=self.caller_name,
+            caller_version=self.caller_version,
+            timeout=to_httpx_timeout(timeout_info),
+        )
+        response = restore_from_api(direct_response)
+        return response
+
+    def post_raw_request(
+        self, body: Dict[str, Any], timeout_info: TimeoutInfoWideType = None
+    ) -> API_RESPONSE:
+        return self._request(
+            method=http_methods.POST,
+            path=self.base_path,
+            json_data=body,
+            timeout_info=timeout_info,
+        )
+
+    def collection(self, collection_name: str) -> AstraDBCollection:
+        """
+        Retrieve a collection from the database.
+
+        Args:
+            collection_name (str): The name of the collection to retrieve.
+
+        Returns:
+            AstraDBCollection: The collection object.
+        """
+        return AstraDBCollection(collection_name=collection_name, astra_db=self)
+
+    def get_collections(
+        self,
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Retrieve a list of collections from the database.
+
+        Args:
+            options (dict, optional): Options to get the collection list
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: An object containing the list of collections in the database:
+                {"status": {"collections": [...]}}
+        """
+        # Parse the options parameter
+        if options is None:
+            options = {}
+
+        json_query = make_payload(
+            top_level="findCollections",
+            options=options,
+        )
+
+        response = self._request(
+            method=http_methods.POST,
+            path=self.base_path,
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def create_collection(
+        self,
+        collection_name: str,
+        *,
+        options: Optional[Dict[str, Any]] = None,
+        dimension: Optional[int] = None,
+        metric: Optional[str] = None,
+        service_dict: Optional[Dict[str, str]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> AstraDBCollection:
+        """
+        Create a new collection in the database.
+
+        Args:
+            collection_name (str): The name of the collection to create.
+            options (dict, optional): Options for the collection.
+            dimension (int, optional): Dimension for vector search.
+            metric (str, optional): Metric choice for vector search.
+            service_dict (dict, optional): a definition for the $vectorize service
+                NOTE: This feature is under current development.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            AstraDBCollection: The created collection object.
+        """
+        # options from named params
+        vector_options = {
+            k: v
+            for k, v in {
+                "dimension": dimension,
+                "metric": metric,
+                "service": service_dict,
+            }.items()
+            if v is not None
+        }
+
+        # overlap/merge with stuff in options.vector
+        dup_params = set((options or {}).get("vector", {}).keys()) & set(
+            vector_options.keys()
+        )
+
+        # If any params are duplicated, we raise an error
+        if dup_params:
+            dups = ", ".join(sorted(dup_params))
+            raise ValueError(
+                f"Parameter(s) {dups} passed both to the method and in the options"
+            )
+
+        # Build our options dictionary if we have vector options
+        if vector_options:
+            options = options or {}
+            options["vector"] = {
+                **options.get("vector", {}),
+                **vector_options,
+            }
+
+        # Build the final json payload
+        jsondata = {
+            k: v
+            for k, v in {"name": collection_name, "options": options}.items()
+            if v is not None
+        }
+
+        # Make the request to the endpoint
+        self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data={"createCollection": jsondata},
+            timeout_info=timeout_info,
+        )
+
+        # Get the instance object as the return of the call
+        return AstraDBCollection(astra_db=self, collection_name=collection_name)
+
+    def delete_collection(
+        self, collection_name: str, timeout_info: TimeoutInfoWideType = None
+    ) -> API_RESPONSE:
+        """
+        Delete a collection from the database.
+
+        Args:
+            collection_name (str): The name of the collection to delete.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database.
+        """
+        # Make sure we provide a collection name
+        if not collection_name:
+            raise ValueError("Must provide a collection name")
+
+        response = self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data={"deleteCollection": {"name": collection_name}},
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    @deprecation.deprecated(  # type: ignore
+        deprecated_in="0.7.0",
+        removed_in="1.0.0",
+        current_version=__version__,
+        details="Use the 'AstraDBCollection.clear()' method instead",
+    )
+    def truncate_collection(
+        self, collection_name: str, timeout_info: TimeoutInfoWideType = None
+    ) -> AstraDBCollection:
+        """
+        Clear a collection in the database, deleting all stored documents.
+
+        Args:
+            collection_name (str): The name of the collection to clear.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            collection: an AstraDBCollection instance
+        """
+        collection = AstraDBCollection(
+            collection_name=collection_name,
+            astra_db=self,
+        )
+        clear_response = collection.clear(timeout_info=timeout_info)
+
+        if clear_response.get("status", {}).get("deletedCount") != -1:
+            raise ValueError(
+                f"Could not issue a truncation API command (response: {json.dumps(clear_response)})."
+            )
+
+        # return the collection itself
+        return collection
+
+
+class AsyncAstraDB:
+    def __init__(
+        self,
+        token: str,
+        api_endpoint: str,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        """
+        Initialize an Astra DB instance.
+
+        Args:
+            token (str): Authentication token for Astra DB.
+            api_endpoint (str): API endpoint URL.
+            api_path (str, optional): used to override default URI construction
+            api_version (str, optional): to override default URI construction
+            namespace (str, optional): Namespace for the database.
+            caller_name (str, optional): identity of the caller ("my_framework")
+            caller_version (str, optional): version of the caller code ("1.0.3")
+        """
+        self.caller_name = caller_name
+        self.caller_version = caller_version
+
+        self.client = httpx.AsyncClient()
+        if token is None or api_endpoint is None:
+            raise AssertionError("Must provide token and api_endpoint")
+
+        if namespace is None:
+            logger.info(
+                f"ASTRA_DB_KEYSPACE is not set. Defaulting to '{DEFAULT_KEYSPACE_NAME}'"
+            )
+            namespace = DEFAULT_KEYSPACE_NAME
+
+        # Store the API token
+        self.token = token
+
+        self.api_endpoint = api_endpoint
+
+        # Set the Base URL for the API calls
+        self.base_url = self.api_endpoint.strip("/")
+
+        # Set the API version and path from the call
+        self.api_path = (api_path or DEFAULT_JSON_API_PATH).strip("/")
+        self.api_version = (api_version or DEFAULT_JSON_API_VERSION).strip("/")
+
+        # Set the namespace
+        self.namespace = namespace
+
+        # Finally, construct the full base path
+        self.base_path: str = f"/{self.api_path}/{self.api_version}/{self.namespace}"
+
+    def __repr__(self) -> str:
+        return f'AsyncAstraDB[endpoint="{self.base_url}", keyspace="{self.namespace}"]'
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, AsyncAstraDB):
+            # work on the "normalized" quantities (stripped, etc)
+            return all(
+                [
+                    self.token == other.token,
+                    self.base_url == other.base_url,
+                    self.base_path == other.base_path,
+                    self.caller_name == other.caller_name,
+                    self.caller_version == other.caller_version,
+                ]
+            )
+        else:
+            return False
+
+    async def __aenter__(self) -> AsyncAstraDB:
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        await self.client.aclose()
+
+    def copy(
+        self,
+        *,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> AsyncAstraDB:
+        return AsyncAstraDB(
+            token=token or self.token,
+            api_endpoint=api_endpoint or self.base_url,
+            api_path=api_path or self.api_path,
+            api_version=api_version or self.api_version,
+            namespace=namespace or self.namespace,
+            caller_name=caller_name or self.caller_name,
+            caller_version=caller_version or self.caller_version,
+        )
+
+    def to_sync(self) -> AstraDB:
+        return AstraDB(
+            token=self.token,
+            api_endpoint=self.base_url,
+            api_path=self.api_path,
+            api_version=self.api_version,
+            namespace=self.namespace,
+            caller_name=self.caller_name,
+            caller_version=self.caller_version,
+        )
+
+    def set_caller(
+        self,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        self.caller_name = caller_name
+        self.caller_version = caller_version
+
+    async def _request(
+        self,
+        method: str = http_methods.POST,
+        path: Optional[str] = None,
+        json_data: Optional[Dict[str, Any]] = None,
+        url_params: Optional[Dict[str, Any]] = None,
+        skip_error_check: bool = False,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        adirect_response = await async_api_request(
+            client=self.client,
+            base_url=self.base_url,
+            auth_header=DEFAULT_AUTH_HEADER,
+            token=self.token,
+            method=method,
+            json_data=normalize_for_api(json_data),
+            url_params=url_params,
+            path=path,
+            skip_error_check=skip_error_check,
+            caller_name=self.caller_name,
+            caller_version=self.caller_version,
+            timeout=to_httpx_timeout(timeout_info),
+        )
+        response = restore_from_api(adirect_response)
+        return response
+
+    async def post_raw_request(
+        self, body: Dict[str, Any], timeout_info: TimeoutInfoWideType = None
+    ) -> API_RESPONSE:
+        return await self._request(
+            method=http_methods.POST,
+            path=self.base_path,
+            json_data=body,
+            timeout_info=timeout_info,
+        )
+
+    async def collection(self, collection_name: str) -> AsyncAstraDBCollection:
+        """
+        Retrieve a collection from the database.
+
+        Args:
+            collection_name (str): The name of the collection to retrieve.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            AstraDBCollection: The collection object.
+        """
+        return AsyncAstraDBCollection(collection_name=collection_name, astra_db=self)
+
+    async def get_collections(
+        self,
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Retrieve a list of collections from the database.
+
+        Args:
+            options (dict, optional): Options to get the collection list
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: An object containing the list of collections in the database:
+                {"status": {"collections": [...]}}
+        """
+        # Parse the options parameter
+        if options is None:
+            options = {}
+
+        json_query = make_payload(
+            top_level="findCollections",
+            options=options,
+        )
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=self.base_path,
+            json_data=json_query,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def create_collection(
+        self,
+        collection_name: str,
+        *,
+        options: Optional[Dict[str, Any]] = None,
+        dimension: Optional[int] = None,
+        metric: Optional[str] = None,
+        service_dict: Optional[Dict[str, str]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> AsyncAstraDBCollection:
+        """
+        Create a new collection in the database.
+
+        Args:
+            collection_name (str): The name of the collection to create.
+            options (dict, optional): Options for the collection.
+            dimension (int, optional): Dimension for vector search.
+            metric (str, optional): Metric choice for vector search.
+            service_dict (dict, optional): a definition for the $vectorize service
+                NOTE: This feature is under current development.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            AsyncAstraDBCollection: The created collection object.
+        """
+        # options from named params
+        vector_options = {
+            k: v
+            for k, v in {
+                "dimension": dimension,
+                "metric": metric,
+                "service": service_dict,
+            }.items()
+            if v is not None
+        }
+
+        # overlap/merge with stuff in options.vector
+        dup_params = set((options or {}).get("vector", {}).keys()) & set(
+            vector_options.keys()
+        )
+
+        # If any params are duplicated, we raise an error
+        if dup_params:
+            dups = ", ".join(sorted(dup_params))
+            raise ValueError(
+                f"Parameter(s) {dups} passed both to the method and in the options"
+            )
+
+        # Build our options dictionary if we have vector options
+        if vector_options:
+            options = options or {}
+            options["vector"] = {
+                **options.get("vector", {}),
+                **vector_options,
+            }
+
+        # Build the final json payload
+        jsondata = {
+            k: v
+            for k, v in {"name": collection_name, "options": options}.items()
+            if v is not None
+        }
+
+        # Make the request to the endpoint
+        await self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data={"createCollection": jsondata},
+            timeout_info=timeout_info,
+        )
+
+        # Get the instance object as the return of the call
+        return AsyncAstraDBCollection(astra_db=self, collection_name=collection_name)
+
+    async def delete_collection(
+        self, collection_name: str, timeout_info: TimeoutInfoWideType = None
+    ) -> API_RESPONSE:
+        """
+        Delete a collection from the database.
+
+        Args:
+            collection_name (str): The name of the collection to delete.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            dict: The response from the database.
+        """
+        # Make sure we provide a collection name
+        if not collection_name:
+            raise ValueError("Must provide a collection name")
+
+        response = await self._request(
+            method=http_methods.POST,
+            path=f"{self.base_path}",
+            json_data={"deleteCollection": {"name": collection_name}},
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    @deprecation.deprecated(  # type: ignore
+        deprecated_in="0.7.0",
+        removed_in="1.0.0",
+        current_version=__version__,
+        details="Use the 'AsyncAstraDBCollection.clear()' method instead",
+    )
+    async def truncate_collection(
+        self, collection_name: str, timeout_info: TimeoutInfoWideType = None
+    ) -> AsyncAstraDBCollection:
+        """
+        Clear a collection in the database, deleting all stored documents.
+
+        Args:
+            collection_name (str): The name of the collection to clear.
+            timeout_info: a float, or a TimeoutInfo dict, for the HTTP request.
+                Note that a 'read' timeout event will not block the action taken
+                by the API server if it has received the request already.
+
+        Returns:
+            collection: an AsyncAstraDBCollection instance
+        """
+
+        collection = AsyncAstraDBCollection(
+            collection_name=collection_name,
+            astra_db=self,
+        )
+        clear_response = await collection.clear(timeout_info=timeout_info)
+
+        if clear_response.get("status", {}).get("deletedCount") != -1:
+            raise ValueError(
+                f"Could not issue a truncation API command (response: {json.dumps(clear_response)})."
+            )
+
+        # return the collection itself
+        return collection
diff --git a/llm/Lib/site-packages/astrapy/core/defaults.py b/llm/Lib/site-packages/astrapy/core/defaults.py
new file mode 100644
index 0000000000000000000000000000000000000000..b1420cfafe1c3628f65c1aba32641f74aca90f80
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/core/defaults.py
@@ -0,0 +1,31 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+DEFAULT_AUTH_PATH = "/api/rest/v1/auth"
+
+DEFAULT_JSON_API_PATH = "/api/json"
+DEFAULT_JSON_API_VERSION = "v1"
+
+DEFAULT_DEV_OPS_URL = "https://api.astra.datastax.com"
+DEFAULT_DEV_OPS_API_VERSION = "v2"
+DEFAULT_DEV_OPS_AUTH_HEADER = "Authorization"
+
+DEFAULT_TIMEOUT = 30000
+DEFAULT_AUTH_HEADER = "Token"
+DEFAULT_KEYSPACE_NAME = "default_keyspace"
+DEFAULT_REGION = "us-east1"
+
+MAX_INSERT_NUM_DOCUMENTS = 20
diff --git a/llm/Lib/site-packages/astrapy/core/ids.py b/llm/Lib/site-packages/astrapy/core/ids.py
new file mode 100644
index 0000000000000000000000000000000000000000..df674349f58d0942f61f751fab859d2dd38c701f
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/core/ids.py
@@ -0,0 +1,33 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+from uuid import uuid1, uuid3, uuid4, uuid5, UUID  # noqa: F401
+
+from bson.objectid import ObjectId  # noqa: F401
+from uuid6 import uuid6, uuid7, uuid8  # noqa: F401
+
+
+__all__ = [
+    "ObjectId",
+    "uuid1",
+    "uuid3",
+    "uuid4",
+    "uuid5",
+    "uuid6",
+    "uuid7",
+    "uuid8",
+    "UUID",
+]
diff --git a/llm/Lib/site-packages/astrapy/core/ops.py b/llm/Lib/site-packages/astrapy/core/ops.py
new file mode 100644
index 0000000000000000000000000000000000000000..8a63c860b5dc7b22a6ac1619462426ff2081b38b
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/core/ops.py
@@ -0,0 +1,1423 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import logging
+from typing import Any, cast, Dict, Optional, TypedDict
+
+import httpx
+from astrapy.core.api import (
+    APIRequestError,
+    api_request,
+    async_api_request,
+    raw_api_request,
+    async_raw_api_request,
+)
+
+from astrapy.core.utils import (
+    http_methods,
+    to_httpx_timeout,
+    TimeoutInfoWideType,
+)
+from astrapy.core.defaults import (
+    DEFAULT_DEV_OPS_AUTH_HEADER,
+    DEFAULT_DEV_OPS_API_VERSION,
+    DEFAULT_DEV_OPS_URL,
+)
+from astrapy.core.core_types import API_RESPONSE, OPS_API_RESPONSE
+
+
+logger = logging.getLogger(__name__)
+
+
+class AstraDBOpsConstructorParams(TypedDict):
+    token: str
+    dev_ops_url: Optional[str]
+    dev_ops_api_version: Optional[str]
+    caller_name: Optional[str]
+    caller_version: Optional[str]
+
+
+class AstraDBOps:
+    # Initialize the shared httpx clients as class attributes
+    client = httpx.Client()
+    async_client = httpx.AsyncClient()
+
+    def __init__(
+        self,
+        token: str,
+        dev_ops_url: Optional[str] = None,
+        dev_ops_api_version: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        self.caller_name = caller_name
+        self.caller_version = caller_version
+        # constructor params (for the copy() method):
+        self.constructor_params: AstraDBOpsConstructorParams = {
+            "token": token,
+            "dev_ops_url": dev_ops_url,
+            "dev_ops_api_version": dev_ops_api_version,
+            "caller_name": caller_name,
+            "caller_version": caller_version,
+        }
+        #
+        dev_ops_url = (dev_ops_url or DEFAULT_DEV_OPS_URL).strip("/")
+        dev_ops_api_version = (
+            dev_ops_api_version or DEFAULT_DEV_OPS_API_VERSION
+        ).strip("/")
+
+        self.token = "Bearer " + token
+        self.base_url = f"{dev_ops_url}/{dev_ops_api_version}"
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, AstraDBOps):
+            # work on the "normalized" quantities (stripped, etc)
+            return all(
+                [
+                    self.token == other.token,
+                    self.base_url == other.base_url,
+                    self.caller_name == other.caller_name,
+                    self.caller_version == other.caller_version,
+                ]
+            )
+        else:
+            return False
+
+    def copy(
+        self,
+        *,
+        token: Optional[str] = None,
+        dev_ops_url: Optional[str] = None,
+        dev_ops_api_version: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> AstraDBOps:
+        return AstraDBOps(
+            token=token or self.constructor_params["token"],
+            dev_ops_url=dev_ops_url or self.constructor_params["dev_ops_url"],
+            dev_ops_api_version=dev_ops_api_version
+            or self.constructor_params["dev_ops_api_version"],
+            caller_name=caller_name or self.caller_name,
+            caller_version=caller_version or self.caller_version,
+        )
+
+    def set_caller(
+        self,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        self.caller_name = caller_name
+        self.caller_version = caller_version
+
+    def _ops_request(
+        self,
+        method: str,
+        path: str,
+        options: Optional[Dict[str, Any]] = None,
+        json_data: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> httpx.Response:
+        _options = {} if options is None else options
+
+        raw_response = raw_api_request(
+            client=self.client,
+            base_url=self.base_url,
+            auth_header=DEFAULT_DEV_OPS_AUTH_HEADER,
+            token=self.token,
+            method=method,
+            json_data=json_data,
+            url_params=_options,
+            path=path,
+            caller_name=self.caller_name,
+            caller_version=self.caller_version,
+            timeout=to_httpx_timeout(timeout_info),
+        )
+        return raw_response
+
+    async def _async_ops_request(
+        self,
+        method: str,
+        path: str,
+        options: Optional[Dict[str, Any]] = None,
+        json_data: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> httpx.Response:
+        _options = {} if options is None else options
+
+        raw_response = await async_raw_api_request(
+            client=self.async_client,
+            base_url=self.base_url,
+            auth_header=DEFAULT_DEV_OPS_AUTH_HEADER,
+            token=self.token,
+            method=method,
+            json_data=json_data,
+            url_params=_options,
+            path=path,
+            caller_name=self.caller_name,
+            caller_version=self.caller_version,
+            timeout=to_httpx_timeout(timeout_info),
+        )
+        return raw_response
+
+    def _json_ops_request(
+        self,
+        method: str,
+        path: str,
+        options: Optional[Dict[str, Any]] = None,
+        json_data: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        _options = {} if options is None else options
+
+        response = api_request(
+            client=self.client,
+            base_url=self.base_url,
+            auth_header="Authorization",
+            token=self.token,
+            method=method,
+            json_data=json_data,
+            url_params=_options,
+            path=path,
+            skip_error_check=False,
+            caller_name=None,
+            caller_version=None,
+            timeout=to_httpx_timeout(timeout_info),
+        )
+        return response
+
+    async def _async_json_ops_request(
+        self,
+        method: str,
+        path: str,
+        options: Optional[Dict[str, Any]] = None,
+        json_data: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        _options = {} if options is None else options
+
+        response = await async_api_request(
+            client=self.async_client,
+            base_url=self.base_url,
+            auth_header="Authorization",
+            token=self.token,
+            method=method,
+            json_data=json_data,
+            url_params=_options,
+            path=path,
+            skip_error_check=False,
+            caller_name=None,
+            caller_version=None,
+            timeout=to_httpx_timeout(timeout_info),
+        )
+        return response
+
+    def get_databases(
+        self,
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve a list of databases.
+
+        Args:
+            options (dict, optional): Additional options for the request.
+
+        Returns:
+            list: a JSON list of dictionaries, one per database.
+        """
+        response = self._json_ops_request(
+            method=http_methods.GET,
+            path="/databases",
+            options=options,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    async def async_get_databases(
+        self,
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve a list of databases - async version of the method.
+
+        Args:
+            options (dict, optional): Additional options for the request.
+
+        Returns:
+            list: a JSON list of dictionaries, one per database.
+        """
+        response = await self._async_json_ops_request(
+            method=http_methods.GET,
+            path="/databases",
+            options=options,
+            timeout_info=timeout_info,
+        )
+
+        return response
+
+    def create_database(
+        self,
+        database_definition: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> Dict[str, str]:
+        """
+        Create a new database.
+
+        Args:
+            database_definition (dict, optional): A dictionary defining the properties of the database to be created.
+            timeout_info: either a float (seconds) or a TimeoutInfo dict (see)
+
+        Returns:
+            dict: A dictionary such as: {"id": the ID of the created database}
+            Raises an error if not successful.
+        """
+        r = self._ops_request(
+            method=http_methods.POST,
+            path="/databases",
+            json_data=database_definition,
+            timeout_info=timeout_info,
+        )
+
+        if r.status_code == 201:
+            return {"id": r.headers["Location"]}
+        elif r.status_code >= 400 and r.status_code < 500:
+            raise APIRequestError(r, payload=database_definition)
+        else:
+            raise ValueError(f"[HTTP {r.status_code}] {r.text}")
+
+    async def async_create_database(
+        self,
+        database_definition: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> Dict[str, str]:
+        """
+        Create a new database - async version of the method.
+
+        Args:
+            database_definition (dict, optional): A dictionary defining the properties of the database to be created.
+            timeout_info: either a float (seconds) or a TimeoutInfo dict (see)
+
+        Returns:
+            dict: A dictionary such as: {"id": the ID of the created database}
+            Raises an error if not successful.
+        """
+        r = await self._async_ops_request(
+            method=http_methods.POST,
+            path="/databases",
+            json_data=database_definition,
+            timeout_info=timeout_info,
+        )
+
+        if r.status_code == 201:
+            return {"id": r.headers["Location"]}
+        elif r.status_code >= 400 and r.status_code < 500:
+            raise APIRequestError(r, payload=database_definition)
+        else:
+            raise ValueError(f"[HTTP {r.status_code}] {r.text}")
+
+    def terminate_database(
+        self, database: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> str:
+        """
+        Terminate an existing database.
+
+        Args:
+            database (str): The identifier of the database to terminate.
+            timeout_info: either a float (seconds) or a TimeoutInfo dict (see)
+
+        Returns:
+            str: The identifier of the terminated database, or None if termination was unsuccessful.
+        """
+        r = self._ops_request(
+            method=http_methods.POST,
+            path=f"/databases/{database}/terminate",
+            timeout_info=timeout_info,
+        )
+
+        if r.status_code == 202:
+            return database
+        elif r.status_code >= 400 and r.status_code < 500:
+            raise APIRequestError(r, payload=None)
+        else:
+            raise ValueError(f"[HTTP {r.status_code}] {r.text}")
+
+        return None
+
+    async def async_terminate_database(
+        self, database: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> str:
+        """
+        Terminate an existing database - async version of the method.
+
+        Args:
+            database (str): The identifier of the database to terminate.
+            timeout_info: either a float (seconds) or a TimeoutInfo dict (see)
+
+        Returns:
+            str: The identifier of the terminated database, or None if termination was unsuccessful.
+        """
+        r = await self._async_ops_request(
+            method=http_methods.POST,
+            path=f"/databases/{database}/terminate",
+            timeout_info=timeout_info,
+        )
+
+        if r.status_code == 202:
+            return database
+        elif r.status_code >= 400 and r.status_code < 500:
+            raise APIRequestError(r, payload=None)
+        else:
+            raise ValueError(f"[HTTP {r.status_code}] {r.text}")
+
+        return None
+
+    def get_database(
+        self,
+        database: str = "",
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Retrieve details of a specific database.
+
+        Args:
+            database (str): The identifier of the database to retrieve.
+            options (dict, optional): Additional options for the request.
+
+        Returns:
+            dict: A JSON response containing the details of the specified database.
+        """
+        return cast(
+            API_RESPONSE,
+            self._json_ops_request(
+                method=http_methods.GET,
+                path=f"/databases/{database}",
+                options=options,
+                timeout_info=timeout_info,
+            ),
+        )
+
+    async def async_get_database(
+        self,
+        database: str = "",
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> API_RESPONSE:
+        """
+        Retrieve details of a specific database - async version of the method.
+
+        Args:
+            database (str): The identifier of the database to retrieve.
+            options (dict, optional): Additional options for the request.
+
+        Returns:
+            dict: A JSON response containing the details of the specified database.
+        """
+        return cast(
+            API_RESPONSE,
+            await self._async_json_ops_request(
+                method=http_methods.GET,
+                path=f"/databases/{database}",
+                options=options,
+                timeout_info=timeout_info,
+            ),
+        )
+
+    def create_keyspace(
+        self,
+        database: str = "",
+        keyspace: str = "",
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> Dict[str, str]:
+        """
+        Create a keyspace in a specified database.
+
+        Args:
+            database (str): The identifier of the database where the keyspace will be created.
+            keyspace (str): The name of the keyspace to create.
+            timeout_info: either a float (seconds) or a TimeoutInfo dict (see)
+
+        Returns:
+            {"ok": 1} if successful. Raises errors otherwise.
+        """
+        r = self._ops_request(
+            method=http_methods.POST,
+            path=f"/databases/{database}/keyspaces/{keyspace}",
+            timeout_info=timeout_info,
+        )
+
+        if r.status_code == 201:
+            return {"name": keyspace}
+        elif r.status_code >= 400 and r.status_code < 500:
+            raise APIRequestError(r, payload=None)
+        else:
+            raise ValueError(f"[HTTP {r.status_code}] {r.text}")
+
+    async def async_create_keyspace(
+        self,
+        database: str = "",
+        keyspace: str = "",
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> Dict[str, str]:
+        """
+        Create a keyspace in a specified database - async version of the method.
+
+        Args:
+            database (str): The identifier of the database where the keyspace will be created.
+            keyspace (str): The name of the keyspace to create.
+            timeout_info: either a float (seconds) or a TimeoutInfo dict (see)
+
+        Returns:
+            {"ok": 1} if successful. Raises errors otherwise.
+        """
+        r = await self._async_ops_request(
+            method=http_methods.POST,
+            path=f"/databases/{database}/keyspaces/{keyspace}",
+            timeout_info=timeout_info,
+        )
+
+        if r.status_code == 201:
+            return {"name": keyspace}
+        elif r.status_code >= 400 and r.status_code < 500:
+            raise APIRequestError(r, payload=None)
+        else:
+            raise ValueError(f"[HTTP {r.status_code}] {r.text}")
+
+    def delete_keyspace(
+        self,
+        database: str = "",
+        keyspace: str = "",
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> str:
+        """
+        Delete a keyspace from a database
+
+        Args:
+            database (str): The identifier of the database to terminate.
+            keyspace (str): The name of the keyspace to create.
+            timeout_info: either a float (seconds) or a TimeoutInfo dict (see)
+
+        Returns:
+            str: The identifier of the deleted keyspace. Otherwise raises an error.
+        """
+        r = self._ops_request(
+            method=http_methods.DELETE,
+            path=f"/databases/{database}/keyspaces/{keyspace}",
+            timeout_info=timeout_info,
+        )
+
+        if r.status_code == 202:
+            return keyspace
+        elif r.status_code >= 400 and r.status_code < 500:
+            raise APIRequestError(r, payload=None)
+        else:
+            raise ValueError(f"[HTTP {r.status_code}] {r.text}")
+
+    async def async_delete_keyspace(
+        self,
+        database: str = "",
+        keyspace: str = "",
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> str:
+        """
+        Delete a keyspace from a database - async version of the method.
+
+        Args:
+            database (str): The identifier of the database to terminate.
+            keyspace (str): The name of the keyspace to create.
+            timeout_info: either a float (seconds) or a TimeoutInfo dict (see)
+
+        Returns:
+            str: The identifier of the deleted keyspace. Otherwise raises an error.
+        """
+        r = await self._async_ops_request(
+            method=http_methods.DELETE,
+            path=f"/databases/{database}/keyspaces/{keyspace}",
+            timeout_info=timeout_info,
+        )
+
+        if r.status_code == 202:
+            return keyspace
+        elif r.status_code >= 400 and r.status_code < 500:
+            raise APIRequestError(r, payload=None)
+        else:
+            raise ValueError(f"[HTTP {r.status_code}] {r.text}")
+
+    def park_database(
+        self, database: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Park a specific database, making it inactive.
+
+        Args:
+            database (str): The identifier of the database to park.
+
+        Returns:
+            dict: The response from the server after parking the database.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path=f"/databases/{database}/park",
+            timeout_info=timeout_info,
+        )
+
+    def unpark_database(
+        self, database: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Unpark a specific database, making it active again.
+
+        Args:
+            database (str): The identifier of the database to unpark.
+
+        Returns:
+            dict: The response from the server after unparking the database.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path=f"/databases/{database}/unpark",
+            timeout_info=timeout_info,
+        )
+
+    def resize_database(
+        self,
+        database: str = "",
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Resize a specific database according to provided options.
+
+        Args:
+            database (str): The identifier of the database to resize.
+            options (dict, optional): The specifications for the resize operation.
+
+        Returns:
+            dict: The response from the server after the resize operation.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path=f"/databases/{database}/resize",
+            json_data=options,
+            timeout_info=timeout_info,
+        )
+
+    def reset_database_password(
+        self,
+        database: str = "",
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Reset the password for a specific database.
+
+        Args:
+            database (str): The identifier of the database for which to reset the password.
+            options (dict, optional): Additional options for the password reset.
+
+        Returns:
+            dict: The response from the server after resetting the password.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path=f"/databases/{database}/resetPassword",
+            json_data=options,
+            timeout_info=timeout_info,
+        )
+
+    def get_secure_bundle(
+        self, database: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve a secure bundle URL for a specific database.
+
+        Args:
+            database (str): The identifier of the database for which to get the secure bundle.
+
+        Returns:
+            dict: The secure bundle URL and related information.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path=f"/databases/{database}/secureBundleURL",
+            timeout_info=timeout_info,
+        )
+
+    def get_datacenters(
+        self, database: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Get a list of datacenters associated with a specific database.
+
+        Args:
+            database (str): The identifier of the database for which to list datacenters.
+
+        Returns:
+            dict: A list of datacenters and their details.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path=f"/databases/{database}/datacenters",
+            timeout_info=timeout_info,
+        )
+
+    def create_datacenter(
+        self,
+        database: str = "",
+        options: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Create a new datacenter for a specific database.
+
+        Args:
+            database (str): The identifier of the database for which to create the datacenter.
+            options (dict, optional): Specifications for the new datacenter.
+
+        Returns:
+            dict: The response from the server after creating the datacenter.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path=f"/databases/{database}/datacenters",
+            json_data=options,
+            timeout_info=timeout_info,
+        )
+
+    def terminate_datacenter(
+        self,
+        database: str = "",
+        datacenter: str = "",
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Terminate a specific datacenter in a database.
+
+        Args:
+            database (str): The identifier of the database containing the datacenter.
+            datacenter (str): The identifier of the datacenter to terminate.
+
+        Returns:
+            dict: The response from the server after terminating the datacenter.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path=f"/databases/{database}/datacenters/{datacenter}/terminate",
+            timeout_info=timeout_info,
+        )
+
+    def get_access_list(
+        self, database: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve the access list for a specific database.
+
+        Args:
+            database (str): The identifier of the database for which to get the access list.
+
+        Returns:
+            dict: The current access list for the database.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path=f"/databases/{database}/access-list",
+            timeout_info=timeout_info,
+        )
+
+    def replace_access_list(
+        self,
+        database: str = "",
+        access_list: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Replace the entire access list for a specific database.
+
+        Args:
+            database (str): The identifier of the database for which to replace the access list.
+            access_list (dict): The new access list to be set.
+
+        Returns:
+            dict: The response from the server after replacing the access list.
+        """
+        return self._json_ops_request(
+            method=http_methods.PUT,
+            path=f"/databases/{database}/access-list",
+            json_data=access_list,
+            timeout_info=timeout_info,
+        )
+
+    def update_access_list(
+        self,
+        database: str = "",
+        access_list: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Update the access list for a specific database.
+
+        Args:
+            database (str): The identifier of the database for which to update the access list.
+            access_list (dict): The updates to be applied to the access list.
+
+        Returns:
+            dict: The response from the server after updating the access list.
+        """
+        return self._json_ops_request(
+            method=http_methods.PATCH,
+            path=f"/databases/{database}/access-list",
+            json_data=access_list,
+            timeout_info=timeout_info,
+        )
+
+    def add_access_list_address(
+        self,
+        database: str = "",
+        address: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Add a new address to the access list for a specific database.
+
+        Args:
+            database (str): The identifier of the database for which to add the address.
+            address (dict): The address details to add to the access list.
+
+        Returns:
+            dict: The response from the server after adding the address.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path=f"/databases/{database}/access-list",
+            json_data=address,
+            timeout_info=timeout_info,
+        )
+
+    def delete_access_list(
+        self, database: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Delete the access list for a specific database.
+
+        Args:
+            database (str): The identifier of the database for which to delete the access list.
+
+        Returns:
+            dict: The response from the server after deleting the access list.
+        """
+        return self._json_ops_request(
+            method=http_methods.DELETE,
+            path=f"/databases/{database}/access-list",
+            timeout_info=timeout_info,
+        )
+
+    def get_private_link(
+        self, database: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve the private link information for a specified database.
+
+        Args:
+            database (str): The identifier of the database.
+
+        Returns:
+            dict: The private link information for the database.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path=f"/organizations/clusters/{database}/private-link",
+            timeout_info=timeout_info,
+        )
+
+    def get_datacenter_private_link(
+        self,
+        database: str = "",
+        datacenter: str = "",
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve the private link information for a specific datacenter in a database.
+
+        Args:
+            database (str): The identifier of the database.
+            datacenter (str): The identifier of the datacenter.
+
+        Returns:
+            dict: The private link information for the specified datacenter.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path=f"/organizations/clusters/{database}/datacenters/{datacenter}/private-link",
+            timeout_info=timeout_info,
+        )
+
+    def create_datacenter_private_link(
+        self,
+        database: str = "",
+        datacenter: str = "",
+        private_link: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Create a private link for a specific datacenter in a database.
+
+        Args:
+            database (str): The identifier of the database.
+            datacenter (str): The identifier of the datacenter.
+            private_link (dict): The private link configuration details.
+
+        Returns:
+            dict: The response from the server after creating the private link.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path=f"/organizations/clusters/{database}/datacenters/{datacenter}/private-link",
+            json_data=private_link,
+            timeout_info=timeout_info,
+        )
+
+    def create_datacenter_endpoint(
+        self,
+        database: str = "",
+        datacenter: str = "",
+        endpoint: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Create an endpoint for a specific datacenter in a database.
+
+        Args:
+            database (str): The identifier of the database.
+            datacenter (str): The identifier of the datacenter.
+            endpoint (dict): The endpoint configuration details.
+
+        Returns:
+            dict: The response from the server after creating the endpoint.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path=f"/organizations/clusters/{database}/datacenters/{datacenter}/endpoint",
+            json_data=endpoint,
+            timeout_info=timeout_info,
+        )
+
+    def update_datacenter_endpoint(
+        self,
+        database: str = "",
+        datacenter: str = "",
+        endpoint: Dict[str, Any] = {},
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Update an existing endpoint for a specific datacenter in a database.
+
+        Args:
+            database (str): The identifier of the database.
+            datacenter (str): The identifier of the datacenter.
+            endpoint (dict): The updated endpoint configuration details.
+
+        Returns:
+            dict: The response from the server after updating the endpoint.
+        """
+        return self._json_ops_request(
+            method=http_methods.PUT,
+            path=f"/organizations/clusters/{database}/datacenters/{datacenter}/endpoints/{endpoint['id']}",
+            json_data=endpoint,
+            timeout_info=timeout_info,
+        )
+
+    def get_datacenter_endpoint(
+        self,
+        database: str = "",
+        datacenter: str = "",
+        endpoint: str = "",
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve information about a specific endpoint in a datacenter of a database.
+
+        Args:
+            database (str): The identifier of the database.
+            datacenter (str): The identifier of the datacenter.
+            endpoint (str): The identifier of the endpoint.
+
+        Returns:
+            dict: The endpoint information for the specified datacenter.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path=f"/organizations/clusters/{database}/datacenters/{datacenter}/endpoints/{endpoint}",
+            timeout_info=timeout_info,
+        )
+
+    def delete_datacenter_endpoint(
+        self,
+        database: str = "",
+        datacenter: str = "",
+        endpoint: str = "",
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Delete a specific endpoint in a datacenter of a database.
+
+        Args:
+            database (str): The identifier of the database.
+            datacenter (str): The identifier of the datacenter.
+            endpoint (str): The identifier of the endpoint to delete.
+
+        Returns:
+            dict: The response from the server after deleting the endpoint.
+        """
+        return self._json_ops_request(
+            method=http_methods.DELETE,
+            path=f"/organizations/clusters/{database}/datacenters/{datacenter}/endpoints/{endpoint}",
+            timeout_info=timeout_info,
+        )
+
+    def get_available_classic_regions(
+        self, timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve a list of available classic regions.
+
+        Returns:
+            dict: A list of available classic regions.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET, path="/availableRegions", timeout_info=timeout_info
+        )
+
+    def get_available_regions(
+        self, timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve a list of available regions for serverless deployment.
+
+        Returns:
+            dict: A list of available regions for serverless deployment.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path="/regions/serverless",
+            timeout_info=timeout_info,
+        )
+
+    def get_roles(self, timeout_info: TimeoutInfoWideType = None) -> OPS_API_RESPONSE:
+        """
+        Retrieve a list of roles within the organization.
+
+        Returns:
+            dict: A list of roles within the organization.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path="/organizations/roles",
+            timeout_info=timeout_info,
+        )
+
+    def create_role(
+        self,
+        role_definition: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Create a new role within the organization.
+
+        Args:
+            role_definition (dict, optional): The definition of the role to be created.
+
+        Returns:
+            dict: The response from the server after creating the role.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path="/organizations/roles",
+            json_data=role_definition,
+            timeout_info=timeout_info,
+        )
+
+    def get_role(
+        self, role: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve details of a specific role within the organization.
+
+        Args:
+            role (str): The identifier of the role.
+
+        Returns:
+            dict: The details of the specified role.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path=f"/organizations/roles/{role}",
+            timeout_info=timeout_info,
+        )
+
+    def update_role(
+        self,
+        role: str = "",
+        role_definition: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Update the definition of an existing role within the organization.
+
+        Args:
+            role (str): The identifier of the role to update.
+            role_definition (dict, optional): The new definition of the role.
+
+        Returns:
+            dict: The response from the server after updating the role.
+        """
+        return self._json_ops_request(
+            method=http_methods.PUT,
+            path=f"/organizations/roles/{role}",
+            json_data=role_definition,
+            timeout_info=timeout_info,
+        )
+
+    def delete_role(
+        self, role: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Delete a specific role from the organization.
+
+        Args:
+            role (str): The identifier of the role to delete.
+
+        Returns:
+            dict: The response from the server after deleting the role.
+        """
+        return self._json_ops_request(
+            method=http_methods.DELETE,
+            path=f"/organizations/roles/{role}",
+            timeout_info=timeout_info,
+        )
+
+    def invite_user(
+        self,
+        user_definition: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Invite a new user to the organization.
+
+        Args:
+            user_definition (dict, optional): The definition of the user to be invited.
+
+        Returns:
+            dict: The response from the server after inviting the user.
+        """
+        return self._json_ops_request(
+            method=http_methods.PUT,
+            path="/organizations/users",
+            json_data=user_definition,
+            timeout_info=timeout_info,
+        )
+
+    def get_users(self, timeout_info: TimeoutInfoWideType = None) -> OPS_API_RESPONSE:
+        """
+        Retrieve a list of users within the organization.
+
+        Returns:
+            dict: A list of users within the organization.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path="/organizations/users",
+            timeout_info=timeout_info,
+        )
+
+    def get_user(
+        self, user: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve details of a specific user within the organization.
+
+        Args:
+            user (str): The identifier of the user.
+
+        Returns:
+            dict: The details of the specified user.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path=f"/organizations/users/{user}",
+            timeout_info=timeout_info,
+        )
+
+    def remove_user(
+        self, user: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Remove a user from the organization.
+
+        Args:
+            user (str): The identifier of the user to remove.
+
+        Returns:
+            dict: The response from the server after removing the user.
+        """
+        return self._json_ops_request(
+            method=http_methods.DELETE,
+            path=f"/organizations/users/{user}",
+            timeout_info=timeout_info,
+        )
+
+    def update_user_roles(
+        self,
+        user: str = "",
+        roles: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Update the roles assigned to a specific user within the organization.
+
+        Args:
+            user (str): The identifier of the user.
+            roles (list, optional): The list of new roles to assign to the user.
+
+        Returns:
+            dict: The response from the server after updating the user's roles.
+        """
+        return self._json_ops_request(
+            method=http_methods.PUT,
+            path=f"/organizations/users/{user}/roles",
+            json_data=roles,
+            timeout_info=timeout_info,
+        )
+
+    def get_clients(self, timeout_info: TimeoutInfoWideType = None) -> OPS_API_RESPONSE:
+        """
+        Retrieve a list of client IDs and secrets associated with the organization.
+
+        Returns:
+            dict: A list of client IDs and their associated secrets.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET, path="/clientIdSecrets", timeout_info=timeout_info
+        )
+
+    def create_token(
+        self,
+        roles: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Create a new token with specific roles.
+
+        Args:
+            roles (dict, optional): The roles to associate with the token:
+                {"roles": ["<roleId>"]}
+
+        Returns:
+            dict: The response from the server after creating the token.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path="/clientIdSecrets",
+            json_data=roles,
+            timeout_info=timeout_info,
+        )
+
+    def delete_token(
+        self, token: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Delete a specific token.
+
+        Args:
+            token (str): The identifier of the token to delete.
+
+        Returns:
+            dict: The response from the server after deleting the token.
+        """
+        return self._json_ops_request(
+            method=http_methods.DELETE,
+            path=f"/clientIdSecret/{token}",
+            timeout_info=timeout_info,
+        )
+
+    def get_organization(
+        self, timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve details of the current organization.
+
+        Returns:
+            dict: The details of the organization.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET, path="/currentOrg", timeout_info=timeout_info
+        )
+
+    def get_access_lists(
+        self, timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve a list of access lists for the organization.
+
+        Returns:
+            dict: A list of access lists.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET, path="/access-lists", timeout_info=timeout_info
+        )
+
+    def get_access_list_template(
+        self, timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve a template for creating an access list.
+
+        Returns:
+            dict: An access list template.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path="/access-list/template",
+            timeout_info=timeout_info,
+        )
+
+    def validate_access_list(
+        self, timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Validate the configuration of the access list.
+
+        Returns:
+            dict: The validation result of the access list configuration.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path="/access-list/validate",
+            timeout_info=timeout_info,
+        )
+
+    def get_private_links(
+        self, timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve a list of private link connections for the organization.
+
+        Returns:
+            dict: A list of private link connections.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path="/organizations/private-link",
+            timeout_info=timeout_info,
+        )
+
+    def get_streaming_providers(
+        self, timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve a list of streaming service providers.
+
+        Returns:
+            dict: A list of available streaming service providers.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path="/streaming/providers",
+            timeout_info=timeout_info,
+        )
+
+    def get_streaming_tenants(
+        self, timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve a list of streaming tenants.
+
+        Returns:
+            dict: A list of streaming tenants and their details.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path="/streaming/tenants",
+            timeout_info=timeout_info,
+        )
+
+    def create_streaming_tenant(
+        self,
+        tenant: Optional[Dict[str, Any]] = None,
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> OPS_API_RESPONSE:
+        """
+        Create a new streaming tenant.
+
+        Args:
+            tenant (dict, optional): The configuration details for the new streaming tenant.
+
+        Returns:
+            dict: The response from the server after creating the streaming tenant.
+        """
+        return self._json_ops_request(
+            method=http_methods.POST,
+            path="/streaming/tenants",
+            json_data=tenant,
+            timeout_info=timeout_info,
+        )
+
+    def delete_streaming_tenant(
+        self,
+        tenant: str = "",
+        cluster: str = "",
+        timeout_info: TimeoutInfoWideType = None,
+    ) -> None:
+        """
+        Delete a specific streaming tenant from a cluster.
+
+        Args:
+            tenant (str): The identifier of the tenant to delete.
+            cluster (str): The identifier of the cluster from which the tenant is to be deleted.
+            timeout_info: either a float (seconds) or a TimeoutInfo dict (see)
+
+        Returns:
+            dict: The response from the server after deleting the streaming tenant.
+        """
+        r = self._ops_request(
+            method=http_methods.DELETE,
+            path=f"/streaming/tenants/{tenant}/clusters/{cluster}",
+            timeout_info=timeout_info,
+        )
+
+        if r.status_code == 202:  # 'Accepted'
+            return None
+        else:
+            raise ValueError(r.text)
+
+    def get_streaming_tenant(
+        self, tenant: str = "", timeout_info: TimeoutInfoWideType = None
+    ) -> OPS_API_RESPONSE:
+        """
+        Retrieve information about the limits and usage of a specific streaming tenant.
+
+        Args:
+            tenant (str): The identifier of the streaming tenant.
+
+        Returns:
+            dict: Details of the specified streaming tenant, including limits and current usage.
+        """
+        return self._json_ops_request(
+            method=http_methods.GET,
+            path=f"/streaming/tenants/{tenant}/limits",
+            timeout_info=timeout_info,
+        )
diff --git a/llm/Lib/site-packages/astrapy/core/utils.py b/llm/Lib/site-packages/astrapy/core/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..a46be5b57cd2c412ba7b37e16c8d0c896c7b63fe
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/core/utils.py
@@ -0,0 +1,436 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+from typing import (
+    Any,
+    cast,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    TypedDict,
+    Union,
+)
+import json
+import time
+import datetime
+import logging
+import copy
+
+import httpx
+
+from astrapy import __version__
+from astrapy.core.defaults import DEFAULT_AUTH_HEADER, DEFAULT_TIMEOUT
+from astrapy.core.core_types import API_RESPONSE
+from astrapy.core.ids import ObjectId, UUID
+
+
+class CustomLogger(logging.Logger):
+    def trace(self, msg: str, *args: Any, **kwargs: Any) -> None:
+        if self.isEnabledFor(5):
+            self._log(5, msg, args, **kwargs)
+
+
+# Add a new TRACE logging level
+logging.addLevelName(5, "TRACE")
+
+# Tell the logging system to use your custom logger
+logging.setLoggerClass(CustomLogger)
+
+
+logger = logging.getLogger(__name__)
+
+
+class http_methods:
+    GET = "GET"
+    POST = "POST"
+    PUT = "PUT"
+    PATCH = "PATCH"
+    DELETE = "DELETE"
+
+
+package_name = __name__.split(".")[0]
+
+user_agent_astrapy = f"{package_name}/{__version__}"
+
+
+def detect_ragstack_user_agent() -> Optional[str]:
+    from importlib import metadata
+    from importlib.metadata import PackageNotFoundError
+
+    try:
+        ragstack_meta = metadata.metadata("ragstack-ai")
+        if ragstack_meta:
+            ragstack_version = ragstack_meta["version"]
+            return f"ragstack/{ragstack_version}"
+    except PackageNotFoundError:
+        pass
+    return None
+
+
+user_agent_rs = detect_ragstack_user_agent()
+
+
+def log_request(
+    method: str,
+    url: str,
+    params: Optional[Dict[str, Any]],
+    headers: Dict[str, str],
+    json_data: Optional[Dict[str, Any]],
+) -> None:
+    """
+    Log the details of an HTTP request for debugging purposes.
+
+    Args:
+        json_data (dict or None): The JSON payload sent with the request, if any.
+    """
+    logger.debug(f"Request url: {url}")
+    logger.debug(f"Request method: {method}")
+    logger.debug(f"Request params: {params}")
+
+    # Redact the token from the request headers
+    headers_log = copy.deepcopy(headers)
+    if DEFAULT_AUTH_HEADER in headers_log:
+        headers_log[DEFAULT_AUTH_HEADER] = "AstraCS:<...>"
+
+    logger.debug(f"Request headers: {headers_log}")
+
+    if json_data:
+        logger.trace(f"Request payload: {json_data}")  # type: ignore
+
+
+def log_response(r: httpx.Response) -> None:
+    """
+    Log the details of an HTTP response for debugging purposes.
+
+    Args:
+        r (requests.Response): The response object from the HTTP request.
+    """
+    logger.debug(f"Response status code: {r.status_code}")
+    logger.debug(f"Response headers: {r.headers}")
+    logger.debug(f"Response content: {r.text}")
+
+
+def compose_user_agent(
+    caller_name: Optional[str], caller_version: Optional[str]
+) -> str:
+    user_agent_caller: Optional[str] = None
+    if caller_name:
+        if caller_version:
+            user_agent_caller = f"{caller_name}/{caller_version}"
+        else:
+            user_agent_caller = f"{caller_name}"
+    all_user_agents = [
+        ua_block
+        for ua_block in [
+            user_agent_rs,
+            user_agent_caller,
+            user_agent_astrapy,
+        ]
+        if ua_block
+    ]
+    return " ".join(all_user_agents)
+
+
+class TimeoutInfo(TypedDict, total=False):
+    read: float
+    write: float
+    base: float
+
+
+TimeoutInfoWideType = Union[TimeoutInfo, float, None]
+
+
+def to_httpx_timeout(timeout_info: TimeoutInfoWideType) -> Union[httpx.Timeout, None]:
+    if timeout_info is None:
+        return None
+    if isinstance(timeout_info, float) or isinstance(timeout_info, int):
+        return httpx.Timeout(timeout_info)
+    elif isinstance(timeout_info, dict):
+        _base = timeout_info.get("base") or DEFAULT_TIMEOUT
+        _read = timeout_info.get("read") or _base
+        _write = timeout_info.get("write") or _base
+        return httpx.Timeout(_base, read=_read, write=_write)
+    else:
+        raise ValueError("Invalid timeout info provided.")
+
+
+def make_request(
+    client: httpx.Client,
+    base_url: str,
+    auth_header: str,
+    token: str,
+    method: str,
+    json_data: Optional[Dict[str, Any]],
+    url_params: Optional[Dict[str, Any]],
+    path: Optional[str],
+    caller_name: Optional[str],
+    caller_version: Optional[str],
+    timeout: Optional[Union[httpx.Timeout, float]],
+) -> httpx.Response:
+    """
+    Make an HTTP request to a specified URL.
+
+    Args:
+        client (httpx): The httpx client for the request.
+        base_url (str): The base URL for the request.
+        auth_header (str): The authentication header key.
+        token (str): The token used for authentication.
+        method (str, optional): The HTTP method to use for the request. Default is POST.
+        path (str, optional): The specific path to append to the base URL.
+        json_data (dict, optional): JSON payload to be sent with the request.
+        url_params (dict, optional): URL parameters to be sent with the request.
+
+    Returns:
+        requests.Response: The response from the HTTP request.
+    """
+    # Build the request headers from the token and user agent
+    request_headers = {
+        auth_header: token,
+        "User-Agent": compose_user_agent(caller_name, caller_version),
+    }
+
+    # Log the parameters of the request accordingly
+    log_request(method, f"{base_url}{path}", url_params, request_headers, json_data)
+
+    # Make the request
+    r = client.request(
+        method=method,
+        url=f"{base_url}{path}",
+        params=url_params,
+        content=json.dumps(json_data, allow_nan=False, separators=(",", ":")).encode(),
+        timeout=timeout or DEFAULT_TIMEOUT,
+        headers=request_headers,
+    )
+
+    # Log the response before returning it
+    log_response(r)
+
+    return r
+
+
+async def amake_request(
+    client: httpx.AsyncClient,
+    base_url: str,
+    auth_header: str,
+    token: str,
+    method: str,
+    path: Optional[str],
+    json_data: Optional[Dict[str, Any]],
+    url_params: Optional[Dict[str, Any]],
+    caller_name: Optional[str],
+    caller_version: Optional[str],
+    timeout: Optional[Union[httpx.Timeout, float]],
+) -> httpx.Response:
+    """
+    Make an HTTP request to a specified URL.
+
+    Args:
+        client (httpx): The httpx client for the request.
+        base_url (str): The base URL for the request.
+        auth_header (str): The authentication header key.
+        token (str): The token used for authentication.
+        method (str, optional): The HTTP method to use for the request. Default is POST.
+        path (str, optional): The specific path to append to the base URL.
+        json_data (dict, optional): JSON payload to be sent with the request.
+        url_params (dict, optional): URL parameters to be sent with the request.
+
+    Returns:
+        requests.Response: The response from the HTTP request.
+    """
+    # Build the request headers from the token and user agent
+    request_headers = {
+        auth_header: token,
+        "User-Agent": compose_user_agent(caller_name, caller_version),
+    }
+
+    # Log the parameters of the request accordingly
+    log_request(method, f"{base_url}{path}", url_params, request_headers, json_data)
+
+    # Make the request
+    r = await client.request(
+        method=method,
+        url=f"{base_url}{path}",
+        params=url_params,
+        content=json.dumps(json_data, allow_nan=False, separators=(",", ":")).encode(),
+        timeout=timeout or DEFAULT_TIMEOUT,
+        headers=request_headers,
+    )
+
+    # Log the response before returning it
+    log_response(r)
+
+    return r
+
+
+def make_payload(top_level: str, **kwargs: Any) -> Dict[str, Any]:
+    """
+    Construct a JSON payload for an HTTP request with a specified top-level key.
+
+    Args:
+        top_level (str): The top-level key for the JSON payload.
+        **kwargs: Arbitrary keyword arguments representing other keys and their values to be included in the payload.
+
+    Returns:
+        dict: The constructed JSON payload.
+    """
+    params = {}
+    for key, value in kwargs.items():
+        params[key] = value
+
+    json_query: Dict[str, Any] = {top_level: {}}
+
+    # Adding keys only if they're provided
+    for key, value in params.items():
+        if value is not None:
+            json_query[top_level][key] = value
+
+    return json_query
+
+
+def convert_vector_to_floats(vector: Iterable[Any]) -> List[float]:
+    """
+    Convert a vector of strings to a vector of floats.
+
+    Args:
+        vector (list): A vector of objects.
+
+    Returns:
+        list: A vector of floats.
+    """
+    return [float(value) for value in vector]
+
+
+def is_list_of_floats(vector: Iterable[Any]) -> bool:
+    """
+    Safely determine if it's a list of floats.
+    Assumption: if list, and first item is float, then all items are.
+    """
+    return isinstance(vector, list) and (
+        len(vector) == 0 or isinstance(vector[0], float) or isinstance(vector[0], int)
+    )
+
+
+def convert_to_ejson_date_object(
+    date_value: Union[datetime.date, datetime.datetime]
+) -> Dict[str, int]:
+    return {"$date": int(time.mktime(date_value.timetuple()) * 1000)}
+
+
+def convert_to_ejson_uuid_object(uuid_value: UUID) -> Dict[str, str]:
+    return {"$uuid": str(uuid_value)}
+
+
+def convert_to_ejson_objectid_object(objectid_value: ObjectId) -> Dict[str, str]:
+    return {"$objectId": str(objectid_value)}
+
+
+def convert_ejson_date_object_to_datetime(
+    date_object: Dict[str, int]
+) -> datetime.datetime:
+    return datetime.datetime.fromtimestamp(date_object["$date"] / 1000.0)
+
+
+def convert_ejson_uuid_object_to_uuid(uuid_object: Dict[str, str]) -> UUID:
+    return UUID(uuid_object["$uuid"])
+
+
+def convert_ejson_objectid_object_to_objectid(
+    objectid_object: Dict[str, str]
+) -> ObjectId:
+    return ObjectId(objectid_object["$objectId"])
+
+
+def _normalize_payload_value(path: List[str], value: Any) -> Any:
+    """
+    The path helps determining special treatments
+    """
+    _l2 = ".".join(path[-2:])
+    _l1 = ".".join(path[-1:])
+    if _l1 == "$vector" and _l2 != "projection.$vector":
+        if not is_list_of_floats(value):
+            return convert_vector_to_floats(value)
+        else:
+            return value
+    else:
+        if isinstance(value, dict):
+            return {
+                k: _normalize_payload_value(path + [k], v) for k, v in value.items()
+            }
+        elif isinstance(value, list):
+            return [
+                _normalize_payload_value(path + [""], list_item) for list_item in value
+            ]
+        else:
+            if isinstance(value, datetime.datetime) or isinstance(value, datetime.date):
+                return convert_to_ejson_date_object(value)
+            elif isinstance(value, UUID):
+                return convert_to_ejson_uuid_object(value)
+            elif isinstance(value, ObjectId):
+                return convert_to_ejson_objectid_object(value)
+            else:
+                return value
+
+
+def normalize_for_api(
+    payload: Union[Dict[str, Any], None]
+) -> Union[Dict[str, Any], None]:
+    """
+    Normalize a payload for API calls.
+    This includes e.g. ensuring values for "$vector" key
+    are made into plain lists of floats.
+
+    Args:
+        payload (Dict[str, Any]): A dict expressing a payload for an API call
+
+    Returns:
+        Dict[str, Any]: a "normalized" payload dict
+    """
+
+    if payload:
+        return cast(Dict[str, Any], _normalize_payload_value([], payload))
+    else:
+        return payload
+
+
+def _restore_response_value(path: List[str], value: Any) -> Any:
+    """
+    The path helps determining special treatments
+    """
+    if isinstance(value, dict):
+        if len(value) == 1 and "$date" in value:
+            # this is `{"$date": 123456}`, restore to datetime.datetime
+            return convert_ejson_date_object_to_datetime(value)
+        elif len(value) == 1 and "$uuid" in value:
+            # this is `{"$uuid": "abc123..."}`, restore to UUID
+            return convert_ejson_uuid_object_to_uuid(value)
+        elif len(value) == 1 and "$objectId" in value:
+            # this is `{"$objectId": "123abc..."}`, restore to ObjectId
+            return convert_ejson_objectid_object_to_objectid(value)
+        else:
+            return {k: _restore_response_value(path + [k], v) for k, v in value.items()}
+    elif isinstance(value, list):
+        return [_restore_response_value(path + [""], list_item) for list_item in value]
+    else:
+        return value
+
+
+def restore_from_api(response: API_RESPONSE) -> API_RESPONSE:
+    """
+    Process a dictionary just returned from the API.
+    This is the place where e.g. `{"$date": 123}` is
+    converted back into a datetime object.
+    """
+    return cast(API_RESPONSE, _restore_response_value([], response))
diff --git a/llm/Lib/site-packages/astrapy/cursors.py b/llm/Lib/site-packages/astrapy/cursors.py
new file mode 100644
index 0000000000000000000000000000000000000000..be04914b2636c5362cc0ebe485ff8b82a4c8bac9
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/cursors.py
@@ -0,0 +1,1059 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import hashlib
+import json
+import logging
+import time
+from collections.abc import Iterator, AsyncIterator
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Generic,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    TypeVar,
+    Union,
+    TYPE_CHECKING,
+)
+
+from astrapy.core.utils import _normalize_payload_value
+from astrapy.exceptions import (
+    CursorIsStartedException,
+    DataAPITimeoutException,
+    recast_method_sync,
+    recast_method_async,
+    base_timeout_info,
+)
+from astrapy.constants import (
+    DocumentType,
+    ProjectionType,
+    normalize_optional_projection,
+)
+
+if TYPE_CHECKING:
+    from astrapy.collection import AsyncCollection, Collection
+
+
+logger = logging.getLogger(__name__)
+
+
+BC = TypeVar("BC", bound="BaseCursor")
+T = TypeVar("T")
+IndexPairType = Tuple[str, Optional[int]]
+
+FIND_PREFETCH = 20
+
+
+def _maybe_valid_list_index(key_block: str) -> Optional[int]:
+    # '0', '1' is good. '00', '01', '-30' are not.
+    try:
+        kb_index = int(key_block)
+        if kb_index >= 0 and key_block == str(kb_index):
+            return kb_index
+        else:
+            return None
+    except ValueError:
+        return None
+
+
+def _create_document_key_extractor(
+    key: str,
+) -> Callable[[Dict[str, Any]], Iterable[Any]]:
+
+    key_blocks0: List[IndexPairType] = [
+        (kb_str, _maybe_valid_list_index(kb_str)) for kb_str in key.split(".")
+    ]
+    if key_blocks0 == []:
+        raise ValueError("Field path specification cannot be empty")
+    if any(kb[0] == "" for kb in key_blocks0):
+        raise ValueError("Field path components cannot be empty")
+
+    def _extract_with_key_blocks(
+        key_blocks: List[IndexPairType], value: Any
+    ) -> Iterable[Any]:
+        if key_blocks == []:
+            if isinstance(value, list):
+                for item in value:
+                    yield item
+            else:
+                yield value
+            return
+        else:
+            # go deeper as requested
+            rest_key_blocks = key_blocks[1:]
+            key_block = key_blocks[0]
+            k_str, k_int = key_block
+            if isinstance(value, dict):
+                if k_str in value:
+                    new_value = value[k_str]
+                    for item in _extract_with_key_blocks(rest_key_blocks, new_value):
+                        yield item
+                return
+            elif isinstance(value, list):
+                if k_int is not None:
+                    if len(value) > k_int:
+                        new_value = value[k_int]
+                        for item in _extract_with_key_blocks(
+                            rest_key_blocks, new_value
+                        ):
+                            yield item
+                    else:
+                        # list has no such element. Nothing to extract.
+                        return
+                else:
+                    for item in value:
+                        for item in _extract_with_key_blocks(key_blocks, item):
+                            yield item
+                return
+            else:
+                # keyblocks are deeper than the document. Nothing to extract.
+                return
+
+    def _item_extractor(document: Dict[str, Any]) -> Iterable[Any]:
+        return _extract_with_key_blocks(key_blocks=key_blocks0, value=document)
+
+    return _item_extractor
+
+
+def _reduce_distinct_key_to_safe(distinct_key: str) -> str:
+    """
+    In light of the twofold interpretation of "0" as index and dict key
+    in selection (for distinct), and the auto-unroll of lists, it is not
+    safe to go beyond the first level. See this example:
+        document = {'x': [{'y': 'Y', '0': 'ZERO'}]}
+        key = "x.0"
+    With full key as projection, we would lose the `"y": "Y"` part (mistakenly).
+    """
+    blocks = distinct_key.split(".")
+    valid_portion = []
+    for block in blocks:
+        if _maybe_valid_list_index(block) is None:
+            valid_portion.append(block)
+        else:
+            break
+    return ".".join(valid_portion)
+
+
+def _hash_document(document: Dict[str, Any]) -> str:
+    _normalized_item = _normalize_payload_value(path=[], value=document)
+    _normalized_json = json.dumps(
+        _normalized_item, sort_keys=True, separators=(",", ":")
+    )
+    _item_hash = hashlib.md5(_normalized_json.encode()).hexdigest()
+    return _item_hash
+
+
+class BaseCursor:
+    """
+    Represents a generic Cursor over query results, regardless of whether
+    synchronous or asynchronous. It cannot be instantiated.
+
+    See classes Cursor and AsyncCursor for more information.
+    """
+
+    _collection: Union[Collection, AsyncCollection]
+    _filter: Optional[Dict[str, Any]]
+    _projection: Optional[ProjectionType]
+    _max_time_ms: Optional[int]
+    _overall_max_time_ms: Optional[int]
+    _started_time_s: Optional[float]
+    _limit: Optional[int]
+    _skip: Optional[int]
+    _include_similarity: Optional[bool]
+    _sort: Optional[Dict[str, Any]]
+    _started: bool
+    _retrieved: int
+    _alive: bool
+    _iterator: Optional[Union[Iterator[DocumentType], AsyncIterator[DocumentType]]] = (
+        None
+    )
+
+    def __init__(
+        self,
+        collection: Union[Collection, AsyncCollection],
+        filter: Optional[Dict[str, Any]],
+        projection: Optional[ProjectionType],
+        max_time_ms: Optional[int],
+        overall_max_time_ms: Optional[int],
+    ) -> None:
+        raise NotImplementedError
+
+    # Note: this, i.e. cursor[i]/cursor[i:j], is disabled
+    # pending full skip/limit support by the Data API.
+    #
+    # def __getitem__(self: BC, index: Union[int, slice]) -> Union[BC, DocumentType]:
+    #     self._ensure_not_started()
+    #     self._ensure_alive()
+    #     if isinstance(index, int):
+    #         # In this case, a separate cursor is run, not touching self
+    #         return self._item_at_index(index)
+    #     elif isinstance(index, slice):
+    #         start = index.start
+    #         stop = index.stop
+    #         step = index.step
+    #         if step is not None and step != 1:
+    #             raise ValueError("Cursor slicing cannot have arbitrary step")
+    #         _skip = start
+    #         _limit = stop - start
+    #         return self.limit(_limit).skip(_skip)
+    #     else:
+    #         raise TypeError(
+    #             f"cursor indices must be integers or slices, not {type(index).__name__}"
+    #         )
+
+    def __repr__(self) -> str:
+        return (
+            f'{self.__class__.__name__}("{self._collection.name}", '
+            f"{self.state}, "
+            f"retrieved: {self.retrieved})"
+        )
+
+    def _item_at_index(self, index: int) -> DocumentType:
+        # deferred to subclasses
+        raise NotImplementedError
+
+    def _ensure_alive(self) -> None:
+        if not self._alive:
+            raise CursorIsStartedException(
+                text="Cursor is closed.",
+                cursor_state=self.state,
+            )
+
+    def _ensure_not_started(self) -> None:
+        if self._started:
+            raise CursorIsStartedException(
+                text="Cursor is started already.",
+                cursor_state=self.state,
+            )
+
+    def _copy(
+        self: BC,
+        *,
+        projection: Optional[ProjectionType] = None,
+        max_time_ms: Optional[int] = None,
+        overall_max_time_ms: Optional[int] = None,
+        limit: Optional[int] = None,
+        skip: Optional[int] = None,
+        include_similarity: Optional[bool] = None,
+        started: Optional[bool] = None,
+        sort: Optional[Dict[str, Any]] = None,
+    ) -> BC:
+        new_cursor = self.__class__(
+            collection=self._collection,
+            filter=self._filter,
+            projection=projection or self._projection,
+            max_time_ms=max_time_ms or self._max_time_ms,
+            overall_max_time_ms=overall_max_time_ms or self._overall_max_time_ms,
+        )
+        # Cursor treated as mutable within this function scope:
+        new_cursor._limit = limit if limit is not None else self._limit
+        new_cursor._skip = skip if skip is not None else self._skip
+        new_cursor._include_similarity = (
+            include_similarity
+            if include_similarity is not None
+            else self._include_similarity
+        )
+        new_cursor._started = started if started is not None else self._started
+        new_cursor._sort = sort if sort is not None else self._sort
+        if started is False:
+            new_cursor._retrieved = 0
+            new_cursor._alive = True
+        else:
+            new_cursor._retrieved = self._retrieved
+            new_cursor._alive = self._alive
+        return new_cursor
+
+    @property
+    def state(self) -> str:
+        """
+        The current state of this cursor, which can be:
+            - "new": if iteration over results has not started yet
+            - "running": iteration has started, can still yield results
+            - "exhausted": the cursor has finished and won't return documents
+        """
+
+        state_desc: str
+        if self._started:
+            if self._alive:
+                state_desc = "running"
+            else:
+                state_desc = "exhausted"
+        else:
+            state_desc = "new"
+        return state_desc
+
+    @property
+    def address(self) -> str:
+        """
+        The API endpoint used by this cursor when issuing
+        requests to the database.
+        """
+
+        return self._collection._astra_db_collection.base_path
+
+    @property
+    def alive(self) -> bool:
+        """
+        Whether the cursor has the potential to yield more data.
+        """
+
+        return self._alive
+
+    def clone(self: BC) -> BC:
+        """
+        Clone the cursor into a new, fresh one.
+
+        Returns:
+            a copy of this cursor, reset to its pristine state,
+            i.e. fully un-consumed.
+        """
+
+        return self._copy(started=False)
+
+    def close(self) -> None:
+        """
+        Stop/kill the cursor, regardless of its status.
+        """
+
+        self._alive = False
+
+    @property
+    def cursor_id(self) -> int:
+        """
+        An integer uniquely identifying this cursor.
+        """
+
+        return id(self)
+
+    def limit(self: BC, limit: Optional[int]) -> BC:
+        """
+        Set a new `limit` value for this cursor.
+
+        Args:
+            limit: the new value to set
+
+        Returns:
+            this cursor itself.
+        """
+
+        self._ensure_not_started()
+        self._ensure_alive()
+        self._limit = limit if limit != 0 else None
+        return self
+
+    def include_similarity(self: BC, include_similarity: Optional[bool]) -> BC:
+        """
+        Set a new `include_similarity` value for this cursor.
+
+        Args:
+            include_similarity: the new value to set
+
+        Returns:
+            this cursor itself.
+        """
+
+        self._ensure_not_started()
+        self._ensure_alive()
+        self._include_similarity = include_similarity
+        return self
+
+    @property
+    def retrieved(self) -> int:
+        """
+        The number of documents retrieved so far.
+        """
+
+        return self._retrieved
+
+    def rewind(self: BC) -> BC:
+        """
+        Reset the cursor to its pristine state, i.e. fully unconsumed.
+
+        Returns:
+            this cursor itself.
+        """
+
+        self._started = False
+        self._retrieved = 0
+        self._alive = True
+        self._iterator = None
+        return self
+
+    def skip(self: BC, skip: Optional[int]) -> BC:
+        """
+        Set a new `skip` value for this cursor.
+
+        Args:
+            skip: the new value to set
+
+        Returns:
+            this cursor itself.
+
+        Note:
+            This parameter can be used only in conjunction with an explicit
+            `sort` criterion of the ascending/descending type (i.e. it cannot
+            be used when not sorting, nor with vector-based ANN search).
+        """
+        self._ensure_not_started()
+        self._ensure_alive()
+        self._skip = skip
+        return self
+
+    def sort(
+        self: BC,
+        sort: Optional[Dict[str, Any]],
+    ) -> BC:
+        """
+        Set a new `sort` value for this cursor.
+
+        Args:
+            sort: the new sorting prescription to set
+
+        Returns:
+            this cursor itself.
+
+        Note:
+            Some combinations of arguments impose an implicit upper bound on the
+            number of documents that are returned by the Data API. More specifically:
+            (a) Vector ANN searches cannot return more than a number of documents
+            that at the time of writing is set to 1000 items.
+            (b) When using a sort criterion of the ascending/descending type,
+            the Data API will return a smaller number of documents, set to 20
+            at the time of writing, and stop there. The returned documents are
+            the top results across the whole collection according to the requested
+            criterion.
+            These provisions should be kept in mind even when subsequently running
+            a command such as `.distinct()` on a cursor.
+        """
+
+        self._ensure_not_started()
+        self._ensure_alive()
+        self._sort = sort
+        return self
+
+
+class Cursor(BaseCursor):
+    """
+    Represents a (synchronous) cursor over documents in a collection.
+    A cursor is iterated over, e.g. with a for loop, and keeps track of
+    its progress.
+
+    Generally cursors are not supposed to be instantiated directly,
+    rather they are obtained by invoking the `find` method on a collection.
+
+    Attributes:
+        collection: the collection to find documents in
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            projection: used to select a subset of fields in the document being
+                returned. The projection can be: an iterable over the field names
+                to return; a dictionary {field_name: True} to positively select
+                certain fields; or a dictionary {field_name: False} if one wants
+                to discard some fields from the response.
+                The default is to return the whole documents.
+            max_time_ms: a timeout, in milliseconds, for each single one
+                of the underlying HTTP requests used to fetch documents as the
+                cursor is iterated over.
+
+    Note:
+        When not specifying sorting criteria at all (by vector or otherwise),
+        the cursor can scroll through an arbitrary number of documents as
+        the Data API and the client periodically exchange new chunks of documents.
+        It should be noted that the behavior of the cursor in the case documents
+        have been added/removed after the cursor was started depends on database
+        internals and it is not guaranteed, nor excluded, that such "real-time"
+        changes in the data would be picked up by the cursor.
+    """
+
+    def __init__(
+        self,
+        collection: Collection,
+        filter: Optional[Dict[str, Any]],
+        projection: Optional[ProjectionType],
+        max_time_ms: Optional[int],
+        overall_max_time_ms: Optional[int],
+    ) -> None:
+        self._collection: Collection = collection
+        self._filter = filter
+        self._projection = projection
+        self._overall_max_time_ms = overall_max_time_ms
+        if overall_max_time_ms is not None and max_time_ms is not None:
+            self._max_time_ms = min(max_time_ms, overall_max_time_ms)
+        else:
+            self._max_time_ms = max_time_ms
+        self._limit: Optional[int] = None
+        self._skip: Optional[int] = None
+        self._include_similarity: Optional[bool] = None
+        self._sort: Optional[Dict[str, Any]] = None
+        self._started = False
+        self._retrieved = 0
+        self._alive = True
+        #
+        self._iterator: Optional[Iterator[DocumentType]] = None
+
+    def __iter__(self) -> Cursor:
+        self._ensure_alive()
+        if self._iterator is None:
+            self._iterator = self._create_iterator()
+            self._started = True
+        return self
+
+    @recast_method_sync
+    def __next__(self) -> DocumentType:
+        if not self.alive:
+            # keep raising once exhausted:
+            raise StopIteration
+        if self._iterator is None:
+            self._iterator = self._create_iterator()
+            self._started = True
+        # check for overall timing out
+        if self._overall_max_time_ms is not None:
+            _elapsed = time.time() - self._started_time_s  # type: ignore[operator]
+            if _elapsed > (self._overall_max_time_ms / 1000.0):
+                raise DataAPITimeoutException(
+                    text="Cursor timed out.",
+                    timeout_type="generic",
+                    endpoint=None,
+                    raw_payload=None,
+                )
+        try:
+            next_item = self._iterator.__next__()
+            self._retrieved = self._retrieved + 1
+            return next_item
+        except StopIteration:
+            self._alive = False
+            raise
+
+    def _item_at_index(self, index: int) -> DocumentType:
+        finder_cursor = self._copy().skip(index).limit(1)
+        items = list(finder_cursor)
+        if items:
+            return items[0]  # type: ignore[no-any-return]
+        else:
+            raise IndexError("no such item for Cursor instance")
+
+    @recast_method_sync
+    def _create_iterator(self) -> Iterator[DocumentType]:
+        self._ensure_not_started()
+        self._ensure_alive()
+        _options = {
+            k: v
+            for k, v in {
+                "limit": self._limit,
+                "skip": self._skip,
+                "includeSimilarity": self._include_similarity,
+            }.items()
+            if v is not None
+        }
+
+        # recast parameters for paginated_find call
+        pf_projection: Optional[Dict[str, bool]] = normalize_optional_projection(
+            self._projection
+        )
+        pf_sort: Optional[Dict[str, int]]
+        if self._sort:
+            pf_sort = dict(self._sort)
+        else:
+            pf_sort = None
+
+        logger.info(f"creating iterator on '{self._collection.name}'")
+        iterator = self._collection._astra_db_collection.paginated_find(
+            filter=self._filter,
+            projection=pf_projection,
+            sort=pf_sort,
+            options=_options,
+            prefetched=0,
+            timeout_info=base_timeout_info(self._max_time_ms),
+        )
+        logger.info(f"finished creating iterator on '{self._collection.name}'")
+        self._started_time_s = time.time()
+        return iterator
+
+    @property
+    def collection(self) -> Collection:
+        """
+        The (synchronous) collection this cursor is targeting.
+        """
+
+        return self._collection
+
+    @recast_method_sync
+    def distinct(self, key: str, max_time_ms: Optional[int] = None) -> List[Any]:
+        """
+        Compute a list of unique values for a specific field across all
+        documents the cursor iterates through.
+
+        Invoking this method has no effect on the cursor state, i.e.
+        the position of the cursor is unchanged.
+
+        Args:
+            key: the name of the field whose value is inspected across documents.
+                Keys can use dot-notation to descend to deeper document levels.
+                Example of acceptable `key` values:
+                    "field"
+                    "field.subfield"
+                    "field.3"
+                    "field.3.subfield"
+                if lists are encountered and no numeric index is specified,
+                all items in the list are visited.
+            max_time_ms: a timeout, in milliseconds, for the operation.
+
+        Note:
+            this operation works at client-side by scrolling through all
+            documents matching the cursor parameters (such as `filter`).
+            Please be aware of this fact, especially for a very large
+            amount of documents, for this may have implications on latency,
+            network traffic and possibly billing.
+        """
+
+        _item_hashes = set()
+        distinct_items = []
+
+        _extractor = _create_document_key_extractor(key)
+        _key = _reduce_distinct_key_to_safe(key)
+
+        if _key == "":
+            raise ValueError(
+                "The 'key' parameter for distinct cannot be empty "
+                "or start with a list index."
+            )
+
+        d_cursor = self._copy(
+            projection={_key: True},
+            started=False,
+            overall_max_time_ms=max_time_ms,
+        )
+        logger.info(f"running distinct() on '{self._collection.name}'")
+        for document in d_cursor:
+            for item in _extractor(document):
+                _item_hash = _hash_document(item)
+                if _item_hash not in _item_hashes:
+                    _item_hashes.add(_item_hash)
+                    distinct_items.append(item)
+
+        logger.info(f"finished running distinct() on '{self._collection.name}'")
+        return distinct_items
+
+
+class AsyncCursor(BaseCursor):
+    """
+    Represents a (asynchronous) cursor over documents in a collection.
+    An asynchronous cursor is iterated over, e.g. with a for loop,
+    and keeps track of its progress.
+
+    Generally cursors are not supposed to be instantiated directly,
+    rather they are obtained by invoking the `find` method on a collection.
+
+    Attributes:
+        collection: the collection to find documents in
+            filter: a predicate expressed as a dictionary according to the
+                Data API filter syntax. Examples are:
+                    {}
+                    {"name": "John"}
+                    {"price": {"$le": 100}}
+                    {"$and": [{"name": "John"}, {"price": {"$le": 100}}]}
+                See the Data API documentation for the full set of operators.
+            projection: used to select a subset of fields in the document being
+                returned. The projection can be: an iterable over the field names
+                to return; a dictionary {field_name: True} to positively select
+                certain fields; or a dictionary {field_name: False} if one wants
+                to discard some fields from the response.
+                The default is to return the whole documents.
+            max_time_ms: a timeout, in milliseconds, for each single one
+                of the underlying HTTP requests used to fetch documents as the
+                cursor is iterated over.
+
+    Note:
+        When not specifying sorting criteria at all (by vector or otherwise),
+        the cursor can scroll through an arbitrary number of documents as
+        the Data API and the client periodically exchange new chunks of documents.
+        It should be noted that the behavior of the cursor in the case documents
+        have been added/removed after the cursor was started depends on database
+        internals and it is not guaranteed, nor excluded, that such "real-time"
+        changes in the data would be picked up by the cursor.
+    """
+
+    def __init__(
+        self,
+        collection: AsyncCollection,
+        filter: Optional[Dict[str, Any]],
+        projection: Optional[ProjectionType],
+        max_time_ms: Optional[int],
+        overall_max_time_ms: Optional[int],
+    ) -> None:
+        self._collection: AsyncCollection = collection
+        self._filter = filter
+        self._projection = projection
+        self._overall_max_time_ms = overall_max_time_ms
+        if overall_max_time_ms is not None and max_time_ms is not None:
+            self._max_time_ms = min(max_time_ms, overall_max_time_ms)
+        else:
+            self._max_time_ms = max_time_ms
+        self._limit: Optional[int] = None
+        self._skip: Optional[int] = None
+        self._include_similarity: Optional[bool] = None
+        self._sort: Optional[Dict[str, Any]] = None
+        self._started = False
+        self._retrieved = 0
+        self._alive = True
+        #
+        self._iterator: Optional[AsyncIterator[DocumentType]] = None
+
+    def __aiter__(self) -> AsyncCursor:
+        self._ensure_alive()
+        if self._iterator is None:
+            self._iterator = self._create_iterator()
+            self._started = True
+        return self
+
+    @recast_method_async
+    async def __anext__(self) -> DocumentType:
+        if not self.alive:
+            # keep raising once exhausted:
+            raise StopAsyncIteration
+        if self._iterator is None:
+            self._iterator = self._create_iterator()
+            self._started = True
+        # check for overall timing out
+        if self._overall_max_time_ms is not None:
+            _elapsed = time.time() - self._started_time_s  # type: ignore[operator]
+            if _elapsed > (self._overall_max_time_ms / 1000.0):
+                raise DataAPITimeoutException(
+                    text="Cursor timed out.",
+                    timeout_type="generic",
+                    endpoint=None,
+                    raw_payload=None,
+                )
+        try:
+            next_item = await self._iterator.__anext__()
+            self._retrieved = self._retrieved + 1
+            return next_item
+        except StopAsyncIteration:
+            self._alive = False
+            raise
+
+    def _item_at_index(self, index: int) -> DocumentType:
+        finder_cursor = self._to_sync().skip(index).limit(1)
+        items = list(finder_cursor)
+        if items:
+            return items[0]  # type: ignore[no-any-return]
+        else:
+            raise IndexError("no such item for AsyncCursor instance")
+
+    @recast_method_sync
+    def _create_iterator(self) -> AsyncIterator[DocumentType]:
+        self._ensure_not_started()
+        self._ensure_alive()
+        _options = {
+            k: v
+            for k, v in {
+                "limit": self._limit,
+                "skip": self._skip,
+                "includeSimilarity": self._include_similarity,
+            }.items()
+            if v is not None
+        }
+
+        # recast parameters for paginated_find call
+        pf_projection: Optional[Dict[str, bool]] = normalize_optional_projection(
+            self._projection
+        )
+        pf_sort: Optional[Dict[str, int]]
+        if self._sort:
+            pf_sort = dict(self._sort)
+        else:
+            pf_sort = None
+
+        logger.info(f"creating iterator on '{self._collection.name}'")
+        iterator = self._collection._astra_db_collection.paginated_find(
+            filter=self._filter,
+            projection=pf_projection,
+            sort=pf_sort,
+            options=_options,
+            prefetched=0,
+            timeout_info=base_timeout_info(self._max_time_ms),
+        )
+        logger.info(f"finished creating iterator on '{self._collection.name}'")
+        self._started_time_s = time.time()
+        return iterator
+
+    def _to_sync(
+        self: AsyncCursor,
+        *,
+        limit: Optional[int] = None,
+        skip: Optional[int] = None,
+        include_similarity: Optional[bool] = None,
+        started: Optional[bool] = None,
+        sort: Optional[Dict[str, Any]] = None,
+    ) -> Cursor:
+        new_cursor = Cursor(
+            collection=self._collection.to_sync(),
+            filter=self._filter,
+            projection=self._projection,
+            max_time_ms=self._max_time_ms,
+            overall_max_time_ms=self._overall_max_time_ms,
+        )
+        # Cursor treated as mutable within this function scope:
+        new_cursor._limit = limit if limit is not None else self._limit
+        new_cursor._skip = skip if skip is not None else self._skip
+        new_cursor._include_similarity = (
+            include_similarity
+            if include_similarity is not None
+            else self._include_similarity
+        )
+        new_cursor._started = started if started is not None else self._started
+        new_cursor._sort = sort if sort is not None else self._sort
+        if started is False:
+            new_cursor._retrieved = 0
+            new_cursor._alive = True
+        else:
+            new_cursor._retrieved = self._retrieved
+            new_cursor._alive = self._alive
+        return new_cursor
+
+    @property
+    def collection(self) -> AsyncCollection:
+        """
+        The (asynchronous) collection this cursor is targeting.
+        """
+
+        return self._collection
+
+    @recast_method_async
+    async def distinct(self, key: str, max_time_ms: Optional[int] = None) -> List[Any]:
+        """
+        Compute a list of unique values for a specific field across all
+        documents the cursor iterates through.
+
+        Invoking this method has no effect on the cursor state, i.e.
+        the position of the cursor is unchanged.
+
+        Args:
+            key: the name of the field whose value is inspected across documents.
+                Keys can use dot-notation to descend to deeper document levels.
+                Example of acceptable `key` values:
+                    "field"
+                    "field.subfield"
+                    "field.3"
+                    "field.3.subfield"
+                if lists are encountered and no numeric index is specified,
+                all items in the list are visited.
+            max_time_ms: a timeout, in milliseconds, for the operation.
+
+        Note:
+            this operation works at client-side by scrolling through all
+            documents matching the cursor parameters (such as `filter`).
+            Please be aware of this fact, especially for a very large
+            amount of documents, for this may have implications on latency,
+            network traffic and possibly billing.
+        """
+
+        _item_hashes = set()
+        distinct_items = []
+
+        _extractor = _create_document_key_extractor(key)
+        _key = _reduce_distinct_key_to_safe(key)
+
+        d_cursor = self._copy(
+            projection={_key: True},
+            started=False,
+            overall_max_time_ms=max_time_ms,
+        )
+        logger.info(f"running distinct() on '{self._collection.name}'")
+        async for document in d_cursor:
+            for item in _extractor(document):
+                _item_hash = _hash_document(item)
+                if _item_hash not in _item_hashes:
+                    _item_hashes.add(_item_hash)
+                    distinct_items.append(item)
+
+        logger.info(f"finished running distinct() on '{self._collection.name}'")
+        return distinct_items
+
+
+class CommandCursor(Generic[T]):
+    """
+    A (synchronous) cursor over the results of a Data API command
+    (as opposed to a cursor over data as one would get with a `find` method).
+
+    Command cursors are iterated over, e.g. with a for loop.
+
+    Generally command cursors are not supposed to be instantiated directly,
+    rather they are obtained by invoking methods on a collection/database
+    (such as the database `list_collections` method).
+    """
+
+    def __init__(self, address: str, items: List[T]) -> None:
+        self._address = address
+        self.items = items
+        self.iterable = items.__iter__()
+        self._alive = True
+
+    def __repr__(self) -> str:
+        return f'{self.__class__.__name__}("{self.address}", ' f"{self.state})"
+
+    def __iter__(self) -> CommandCursor[T]:
+        self._ensure_alive()
+        return self
+
+    def __next__(self) -> T:
+        try:
+            item = self.iterable.__next__()
+            return item
+        except StopIteration:
+            self._alive = False
+            raise
+
+    @property
+    def state(self) -> str:
+        """
+        The current state of this cursor, which can be:
+            - "alive": the cursor has still the potential to return items.
+            - "exhausted": the cursor has finished and won't return documents
+        """
+
+        return "alive" if self._alive else "exhausted"
+
+    @property
+    def address(self) -> str:
+        """
+        The API endpoint used by this cursor when issuing
+        requests to the database.
+        """
+
+        return self._address
+
+    @property
+    def alive(self) -> bool:
+        """
+        Whether the cursor has the potential to yield more data.
+        """
+
+        return self._alive
+
+    @property
+    def cursor_id(self) -> int:
+        """
+        An integer uniquely identifying this cursor.
+        """
+
+        return id(self)
+
+    def _ensure_alive(self) -> None:
+        if not self._alive:
+            raise CursorIsStartedException(
+                text="Cursor is closed.",
+                cursor_state=self.state,
+            )
+
+    def close(self) -> None:
+        """
+        Stop/kill the cursor, regardless of its status.
+        """
+
+        self._alive = False
+
+
+class AsyncCommandCursor(Generic[T]):
+    """
+    A (asynchronous) cursor over the results of a Data API command
+    (as opposed to a cursor over data as one would get with a `find` method).
+
+    Asynchronous command cursors are iterated over, e.g. with an async for loop.
+
+    Generally command cursors are not supposed to be instantiated directly,
+    rather they are obtained by invoking methods on a collection/database
+    (such as the database `list_collections` method).
+    """
+
+    def __init__(self, address: str, items: List[T]) -> None:
+        self._address = address
+        self.items = items
+        self.iterable = items.__iter__()
+        self._alive = True
+
+    def __repr__(self) -> str:
+        return f'{self.__class__.__name__}("{self.address}", ' f"{self.state})"
+
+    def __aiter__(self) -> AsyncCommandCursor[T]:
+        self._ensure_alive()
+        return self
+
+    async def __anext__(self) -> T:
+        try:
+            item = self.iterable.__next__()
+            return item
+        except StopIteration:
+            self._alive = False
+            raise StopAsyncIteration
+
+    @property
+    def state(self) -> str:
+        """
+        The current state of this cursor, which can be:
+            - "alive": the cursor has still the potential to return items.
+            - "exhausted": the cursor has finished and won't return documents
+        """
+
+        return "alive" if self._alive else "exhausted"
+
+    @property
+    def address(self) -> str:
+        """
+        The API endpoint used by this cursor when issuing
+        requests to the database.
+        """
+
+        return self._address
+
+    @property
+    def alive(self) -> bool:
+        """
+        Whether the cursor has the potential to yield more data.
+        """
+
+        return self._alive
+
+    @property
+    def cursor_id(self) -> int:
+        """
+        An integer uniquely identifying this cursor.
+        """
+
+        return id(self)
+
+    def _ensure_alive(self) -> None:
+        if not self._alive:
+            raise CursorIsStartedException(
+                text="Cursor is closed.",
+                cursor_state=self.state,
+            )
+
+    def close(self) -> None:
+        """
+        Stop/kill the cursor, regardless of its status.
+        """
+
+        self._alive = False
diff --git a/llm/Lib/site-packages/astrapy/database.py b/llm/Lib/site-packages/astrapy/database.py
new file mode 100644
index 0000000000000000000000000000000000000000..a4c585372abfdc5d6966a3478c53c65e28b8520f
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/database.py
@@ -0,0 +1,1536 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import logging
+
+from types import TracebackType
+from typing import Any, Dict, List, Optional, Type, Union, TYPE_CHECKING
+
+from astrapy.core.db import AstraDB, AsyncAstraDB
+from astrapy.exceptions import (
+    CollectionAlreadyExistsException,
+    DataAPIFaultyResponseException,
+    DevOpsAPIException,
+    MultiCallTimeoutManager,
+    recast_method_sync,
+    recast_method_async,
+    base_timeout_info,
+)
+from astrapy.cursors import AsyncCommandCursor, CommandCursor
+from astrapy.info import (
+    DatabaseInfo,
+    CollectionDescriptor,
+    CollectionVectorServiceOptions,
+)
+from astrapy.admin import parse_api_endpoint, fetch_database_info
+
+if TYPE_CHECKING:
+    from astrapy.collection import AsyncCollection, Collection
+    from astrapy.admin import AstraDBDatabaseAdmin
+
+
+logger = logging.getLogger(__name__)
+
+
+def _validate_create_collection_options(
+    dimension: Optional[int],
+    metric: Optional[str],
+    service: Optional[Union[CollectionVectorServiceOptions, Dict[str, Any]]],
+    indexing: Optional[Dict[str, Any]],
+    default_id_type: Optional[str],
+    additional_options: Optional[Dict[str, Any]],
+) -> None:
+    if additional_options:
+        if "vector" in additional_options:
+            raise ValueError(
+                "`additional_options` dict parameter to create_collection "
+                "cannot have a `vector` key. Please use the specific "
+                "method parameter."
+            )
+        if "indexing" in additional_options:
+            raise ValueError(
+                "`additional_options` dict parameter to create_collection "
+                "cannot have a `indexing` key. Please use the specific "
+                "method parameter."
+            )
+        if "defaultId" in additional_options and default_id_type is not None:
+            # this leaves the workaround to pass more info in the defaultId
+            # should that become part of the specs:
+            raise ValueError(
+                "`additional_options` dict parameter to create_collection "
+                "cannot have a `defaultId` key when passing the "
+                "`default_id_type` parameter as well."
+            )
+    is_vector: bool
+    if service is not None or dimension is not None:
+        is_vector = True
+    else:
+        is_vector = False
+    if not is_vector and metric is not None:
+        raise ValueError(
+            "Cannot specify `metric` for non-vector collections in the "
+            "create_collection method."
+        )
+
+
+class Database:
+    """
+    A Data API database. This is the entry-point object for doing database-level
+    DML, such as creating/deleting collections, and for obtaining Collection
+    objects themselves. This class has a synchronous interface.
+
+    A Database comes with an "API Endpoint", which implies a Database object
+    instance reaches a specific region (relevant point in case of multi-region
+    databases).
+
+    Args:
+        api_endpoint: the full "API Endpoint" string used to reach the Data API.
+            Example: "https://<database_id>-<region>.apps.astra.datastax.com"
+        token: an Access Token to the database. Example: "AstraCS:xyz..."
+        namespace: this is the namespace all method calls will target, unless
+            one is explicitly specified in the call. If no namespace is supplied
+            when creating a Database, the name "default_namespace" is set.
+        caller_name: name of the application, or framework, on behalf of which
+            the Data API calls are performed. This ends up in the request user-agent.
+        caller_version: version of the caller.
+        api_path: path to append to the API Endpoint. In typical usage, this
+            should be left to its default of "/api/json".
+        api_version: version specifier to append to the API path. In typical
+            usage, this should be left to its default of "v1".
+
+    Example:
+        >>> from astrapy import DataAPIClient
+        >>> my_client = astrapy.DataAPIClient("AstraCS:...")
+        >>> my_db = my_client.get_database_by_api_endpoint(
+        ...    "https://01234567-....apps.astra.datastax.com"
+        ... )
+
+    Note:
+        creating an instance of Database does not trigger actual creation
+        of the database itself, which should exist beforehand. To create databases,
+        see the AstraDBAdmin class.
+    """
+
+    def __init__(
+        self,
+        api_endpoint: str,
+        token: str,
+        *,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+    ) -> None:
+        self._astra_db = AstraDB(
+            token=token,
+            api_endpoint=api_endpoint,
+            api_path=api_path,
+            api_version=api_version,
+            namespace=namespace,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+        self._name: Optional[str] = None
+
+    def __getattr__(self, collection_name: str) -> Collection:
+        return self.get_collection(name=collection_name)
+
+    def __getitem__(self, collection_name: str) -> Collection:
+        return self.get_collection(name=collection_name)
+
+    def __repr__(self) -> str:
+        return (
+            f'{self.__class__.__name__}(api_endpoint="{self._astra_db.api_endpoint}", '
+            f'token="{self._astra_db.token[:12]}...", namespace="{self._astra_db.namespace}")'
+        )
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, Database):
+            return self._astra_db == other._astra_db
+        else:
+            return False
+
+    def _copy(
+        self,
+        *,
+        api_endpoint: Optional[str] = None,
+        token: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+    ) -> Database:
+        return Database(
+            api_endpoint=api_endpoint or self._astra_db.api_endpoint,
+            token=token or self._astra_db.token,
+            namespace=namespace or self._astra_db.namespace,
+            caller_name=caller_name or self._astra_db.caller_name,
+            caller_version=caller_version or self._astra_db.caller_version,
+            api_path=api_path or self._astra_db.api_path,
+            api_version=api_version or self._astra_db.api_version,
+        )
+
+    def with_options(
+        self,
+        *,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> Database:
+        """
+        Create a clone of this database with some changed attributes.
+
+        Args:
+            namespace: this is the namespace all method calls will target, unless
+                one is explicitly specified in the call. If no namespace is supplied
+                when creating a Database, the name "default_namespace" is set.
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+
+        Returns:
+            a new `Database` instance.
+
+        Example:
+            >>> my_db_2 = my_db.with_options(
+            ...     namespace="the_other_namespace",
+            ...     caller_name="the_caller",
+            ...     caller_version="0.1.0",
+            ... )
+        """
+
+        return self._copy(
+            namespace=namespace,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
+    def to_async(
+        self,
+        *,
+        api_endpoint: Optional[str] = None,
+        token: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+    ) -> AsyncDatabase:
+        """
+        Create an AsyncDatabase from this one. Save for the arguments
+        explicitly provided as overrides, everything else is kept identical
+        to this database in the copy.
+
+        Args:
+            api_endpoint: the full "API Endpoint" string used to reach the Data API.
+                Example: "https://<database_id>-<region>.apps.astra.datastax.com"
+            token: an Access Token to the database. Example: "AstraCS:xyz..."
+            namespace: this is the namespace all method calls will target, unless
+                one is explicitly specified in the call. If no namespace is supplied
+                when creating a Database, the name "default_namespace" is set.
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+            api_path: path to append to the API Endpoint. In typical usage, this
+                should be left to its default of "/api/json".
+            api_version: version specifier to append to the API path. In typical
+                usage, this should be left to its default of "v1".
+
+        Returns:
+            the new copy, an `AsyncDatabase` instance.
+
+        Example:
+            >>> my_async_db = my_db.to_async()
+            >>> asyncio.run(my_async_db.list_collection_names())
+        """
+
+        return AsyncDatabase(
+            api_endpoint=api_endpoint or self._astra_db.api_endpoint,
+            token=token or self._astra_db.token,
+            namespace=namespace or self._astra_db.namespace,
+            caller_name=caller_name or self._astra_db.caller_name,
+            caller_version=caller_version or self._astra_db.caller_version,
+            api_path=api_path or self._astra_db.api_path,
+            api_version=api_version or self._astra_db.api_version,
+        )
+
+    def set_caller(
+        self,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        """
+        Set a new identity for the application/framework on behalf of which
+        the Data API calls are performed (the "caller").
+
+        Args:
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+
+        Example:
+            >>> my_db.set_caller(caller_name="the_caller", caller_version="0.1.0")
+        """
+
+        logger.info(f"setting caller to {caller_name}/{caller_version}")
+        self._astra_db.set_caller(
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
+    def info(self) -> DatabaseInfo:
+        """
+        Additional information on the database as a DatabaseInfo instance.
+
+        Some of the returned properties are dynamic throughout the lifetime
+        of the database (such as raw_info["keyspaces"]). For this reason,
+        each invocation of this method triggers a new request to the DevOps API.
+
+        Example:
+            >>> my_db.info().region
+            'eu-west-1'
+
+            >>> my_db.info().raw_info['datacenters'][0]['dateCreated']
+            '2023-01-30T12:34:56Z'
+
+        Note:
+            see the DatabaseInfo documentation for a caveat about the difference
+            between the `region` and the `raw_info["region"]` attributes.
+        """
+
+        logger.info("getting database info")
+        database_info = fetch_database_info(
+            self._astra_db.api_endpoint,
+            token=self._astra_db.token,
+            namespace=self.namespace,
+        )
+        if database_info is not None:
+            logger.info("finished getting database info")
+            return database_info
+        else:
+            raise DevOpsAPIException(
+                "Database is not in a supported environment for this operation."
+            )
+
+    @property
+    def id(self) -> str:
+        """
+        The ID of this database.
+
+        Example:
+            >>> my_db.id
+            '01234567-89ab-cdef-0123-456789abcdef'
+        """
+
+        parsed_api_endpoint = parse_api_endpoint(self._astra_db.api_endpoint)
+        if parsed_api_endpoint is not None:
+            return parsed_api_endpoint.database_id
+        else:
+            raise DevOpsAPIException(
+                "Database is not in a supported environment for this operation."
+            )
+
+    def name(self) -> str:
+        """
+        The name of this database. Note that this bears no unicity guarantees.
+
+        Calling this method the first time involves a request
+        to the DevOps API (the resulting database name is then cached).
+        See the `info()` method for more details.
+
+        Example:
+            >>> my_db.name()
+            'the_application_database'
+        """
+
+        if self._name is None:
+            self._name = self.info().name
+        return self._name
+
+    @property
+    def namespace(self) -> str:
+        """
+        The namespace this database uses as target for all commands when
+        no method-call-specific namespace is specified.
+
+        Example:
+            >>> my_db.namespace
+            'the_keyspace'
+        """
+
+        return self._astra_db.namespace
+
+    def get_collection(
+        self, name: str, *, namespace: Optional[str] = None
+    ) -> Collection:
+        """
+        Spawn a `Collection` object instance representing a collection
+        on this database.
+
+        Creating a `Collection` instance does not have any effect on the
+        actual state of the database: in other words, for the created
+        `Collection` instance to be used meaningfully, the collection
+        must exist already (for instance, it should have been created
+        previously by calling the `create_collection` method).
+
+        Args:
+            name: the name of the collection.
+            namespace: the namespace containing the collection. If no namespace
+                is specified, the general setting for this database is used.
+
+        Returns:
+            a `Collection` instance, representing the desired collection
+                (but without any form of validation).
+
+        Example:
+            >>> my_col = my_db.get_collection("my_collection")
+            >>> my_col.count_documents({}, upper_bound=100)
+            41
+
+        Note:
+            The attribute and indexing syntax forms achieve the same effect
+            as this method. In other words, the following are equivalent:
+                my_db.get_collection("coll_name")
+                my_db.coll_name
+                my_db["coll_name"]
+        """
+
+        # lazy importing here against circular-import error
+        from astrapy.collection import Collection
+
+        _namespace = namespace or self._astra_db.namespace
+        return Collection(self, name, namespace=_namespace)
+
+    @recast_method_sync
+    def create_collection(
+        self,
+        name: str,
+        *,
+        namespace: Optional[str] = None,
+        dimension: Optional[int] = None,
+        metric: Optional[str] = None,
+        service: Optional[Union[CollectionVectorServiceOptions, Dict[str, Any]]] = None,
+        indexing: Optional[Dict[str, Any]] = None,
+        default_id_type: Optional[str] = None,
+        additional_options: Optional[Dict[str, Any]] = None,
+        check_exists: Optional[bool] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> Collection:
+        """
+        Creates a collection on the database and return the Collection
+        instance that represents it.
+
+        This is a blocking operation: the method returns when the collection
+        is ready to be used. As opposed to the `get_collection` instance,
+        this method triggers causes the collection to be actually created on DB.
+
+        Args:
+            name: the name of the collection.
+            namespace: the namespace where the collection is to be created.
+                If not specified, the general setting for this database is used.
+            dimension: for vector collections, the dimension of the vectors
+                (i.e. the number of their components).
+            metric: the similarity metric used for vector searches.
+                Allowed values are `VectorMetric.DOT_PRODUCT`, `VectorMetric.EUCLIDEAN`
+                or `VectorMetric.COSINE` (default).
+            service: a dictionary describing a service for
+                embedding computation, e.g. `{"provider": "ab", "modelName": "xy"}`.
+                Alternatively, a CollectionVectorServiceOptions object to the same effect.
+                NOTE: This feature is under current development.
+            indexing: optional specification of the indexing options for
+                the collection, in the form of a dictionary such as
+                    {"deny": [...]}
+                or
+                    {"allow": [...]}
+            default_id_type: this sets what type of IDs the API server will
+                generate when inserting documents that do not specify their
+                `_id` field explicitly. Can be set to any of the values
+                `DefaultIdType.UUID`, `DefaultIdType.OBJECTID`,
+                `DefaultIdType.UUIDV6`, `DefaultIdType.UUIDV7`,
+                `DefaultIdType.DEFAULT`.
+            additional_options: any further set of key-value pairs that will
+                be added to the "options" part of the payload when sending
+                the Data API command to create a collection.
+            check_exists: whether to run an existence check for the collection
+                name before attempting to create the collection:
+                If check_exists is True, an error is raised when creating
+                an existing collection.
+                If it is False, the creation is attempted. In this case, for
+                preexisting collections, the command will succeed or fail
+                depending on whether the options match or not.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a (synchronous) `Collection` instance, representing the
+            newly-created collection.
+
+        Example:
+            >>> new_col = my_db.create_collection("my_v_col", dimension=3)
+            >>> new_col.insert_one({"name": "the_row"}, vector=[0.4, 0.5, 0.7])
+            InsertOneResult(raw_results=..., inserted_id='e22dd65e-...-...-...')
+
+        Note:
+            A collection is considered a vector collection if at least one of
+            `dimension` or `service` are provided and not null. In that case,
+            and only in that case, is `metric` an accepted parameter.
+            Note, moreover, that if passing both these parameters, then
+            the dimension must be compatible with the chosen service.
+        """
+
+        _validate_create_collection_options(
+            dimension=dimension,
+            metric=metric,
+            service=service,
+            indexing=indexing,
+            default_id_type=default_id_type,
+            additional_options=additional_options,
+        )
+        _options = {
+            **(additional_options or {}),
+            **({"indexing": indexing} if indexing else {}),
+            **({"defaultId": {"type": default_id_type}} if default_id_type else {}),
+        }
+
+        timeout_manager = MultiCallTimeoutManager(overall_max_time_ms=max_time_ms)
+
+        if check_exists is None:
+            _check_exists = True
+        else:
+            _check_exists = check_exists
+        existing_names: List[str]
+        if _check_exists:
+            logger.info(f"checking collection existence for '{name}'")
+            existing_names = self.list_collection_names(
+                namespace=namespace,
+                max_time_ms=timeout_manager.remaining_timeout_ms(),
+            )
+        else:
+            existing_names = []
+
+        driver_db = self._astra_db.copy(namespace=namespace)
+        if name in existing_names:
+            raise CollectionAlreadyExistsException(
+                text=f"CollectionInvalid: collection {name} already exists",
+                namespace=driver_db.namespace,
+                collection_name=name,
+            )
+
+        service_dict: Optional[Dict[str, Any]]
+        if service is not None:
+            service_dict = service if isinstance(service, dict) else service.as_dict()
+        else:
+            service_dict = None
+
+        logger.info(f"creating collection '{name}'")
+        driver_db.create_collection(
+            name,
+            options=_options,
+            dimension=dimension,
+            metric=metric,
+            service_dict=service_dict,
+            timeout_info=timeout_manager.remaining_timeout_info(),
+        )
+        logger.info(f"finished creating collection '{name}'")
+        return self.get_collection(name, namespace=namespace)
+
+    @recast_method_sync
+    def drop_collection(
+        self,
+        name_or_collection: Union[str, Collection],
+        *,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Drop a collection from the database, along with all documents therein.
+
+        Args:
+            name_or_collection: either the name of a collection or
+                a `Collection` instance.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a dictionary in the form {"ok": 1} if the command succeeds.
+
+        Example:
+            >>> my_db.list_collection_names()
+            ['a_collection', 'my_v_col', 'another_col']
+            >>> my_db.drop_collection("my_v_col")
+            {'ok': 1}
+            >>> my_db.list_collection_names()
+            ['a_collection', 'another_col']
+
+        Note:
+            when providing a collection name, it is assumed that the collection
+            is to be found in the namespace set at database instance level.
+        """
+
+        # lazy importing here against circular-import error
+        from astrapy.collection import Collection
+
+        if isinstance(name_or_collection, Collection):
+            _namespace = name_or_collection.namespace
+            _name: str = name_or_collection.name
+            logger.info(f"dropping collection '{_name}'")
+            dc_response = self._astra_db.copy(namespace=_namespace).delete_collection(
+                _name,
+                timeout_info=base_timeout_info(max_time_ms),
+            )
+            logger.info(f"finished dropping collection '{_name}'")
+            return dc_response.get("status", {})  # type: ignore[no-any-return]
+        else:
+            logger.info(f"dropping collection '{name_or_collection}'")
+            dc_response = self._astra_db.delete_collection(
+                name_or_collection,
+                timeout_info=base_timeout_info(max_time_ms),
+            )
+            logger.info(f"finished dropping collection '{name_or_collection}'")
+            return dc_response.get("status", {})  # type: ignore[no-any-return]
+
+    @recast_method_sync
+    def list_collections(
+        self,
+        *,
+        namespace: Optional[str] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> CommandCursor[CollectionDescriptor]:
+        """
+        List all collections in a given namespace for this database.
+
+        Args:
+            namespace: the namespace to be inspected. If not specified,
+                the general setting for this database is assumed.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a `CommandCursor` to iterate over CollectionDescriptor instances,
+            each corresponding to a collection.
+
+        Example:
+            >>> ccur = my_db.list_collections()
+            >>> ccur
+            <astrapy.cursors.CommandCursor object at ...>
+            >>> list(ccur)
+            [CollectionDescriptor(name='my_v_col', options=CollectionOptions())]
+            >>> for coll_dict in my_db.list_collections():
+            ...     print(coll_dict)
+            ...
+            CollectionDescriptor(name='my_v_col', options=CollectionOptions())
+        """
+
+        if namespace:
+            _client = self._astra_db.copy(namespace=namespace)
+        else:
+            _client = self._astra_db
+        logger.info("getting collections")
+        gc_response = _client.get_collections(
+            options={"explain": True}, timeout_info=base_timeout_info(max_time_ms)
+        )
+        if "collections" not in gc_response.get("status", {}):
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from get_collections API command.",
+                raw_response=gc_response,
+            )
+        else:
+            # we know this is a list of dicts, to marshal into "descriptors"
+            logger.info("finished getting collections")
+            return CommandCursor(
+                address=self._astra_db.base_url,
+                items=[
+                    CollectionDescriptor.from_dict(col_dict)
+                    for col_dict in gc_response["status"]["collections"]
+                ],
+            )
+
+    @recast_method_sync
+    def list_collection_names(
+        self,
+        *,
+        namespace: Optional[str] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> List[str]:
+        """
+        List the names of all collections in a given namespace of this database.
+
+        Args:
+            namespace: the namespace to be inspected. If not specified,
+                the general setting for this database is assumed.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a list of the collection names as strings, in no particular order.
+
+        Example:
+            >>> my_db.list_collection_names()
+            ['a_collection', 'another_col']
+        """
+
+        logger.info("getting collection names")
+        gc_response = self._astra_db.copy(namespace=namespace).get_collections(
+            timeout_info=base_timeout_info(max_time_ms)
+        )
+        if "collections" not in gc_response.get("status", {}):
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from get_collections API command.",
+                raw_response=gc_response,
+            )
+        else:
+            # we know this is a list of strings
+            logger.info("finished getting collection names")
+            return gc_response["status"]["collections"]  # type: ignore[no-any-return]
+
+    @recast_method_sync
+    def command(
+        self,
+        body: Dict[str, Any],
+        *,
+        namespace: Optional[str] = None,
+        collection_name: Optional[str] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Send a POST request to the Data API for this database with
+        an arbitrary, caller-provided payload.
+
+        Args:
+            body: a JSON-serializable dictionary, the payload of the request.
+            namespace: the namespace to use. Requests always target a namespace:
+                if not specified, the general setting for this database is assumed.
+            collection_name: if provided, the collection name is appended at the end
+                of the endpoint. In this way, this method allows collection-level
+                arbitrary POST requests as well.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a dictionary with the response of the HTTP request.
+
+        Example:
+            >>> my_db.command({"findCollections": {}})
+            {'status': {'collections': ['my_coll']}}
+            >>> my_db.command({"countDocuments": {}}, collection_name="my_coll")
+            {'status': {'count': 123}}
+        """
+
+        if namespace:
+            _client = self._astra_db.copy(namespace=namespace)
+        else:
+            _client = self._astra_db
+        if collection_name:
+            _collection = _client.collection(collection_name)
+            logger.info(f"issuing custom command to API (on '{collection_name}')")
+            req_response = _collection.post_raw_request(
+                body=body,
+                timeout_info=base_timeout_info(max_time_ms),
+            )
+            logger.info(
+                f"finished issuing custom command to API (on '{collection_name}')"
+            )
+            return req_response
+        else:
+            logger.info("issuing custom command to API")
+            req_response = _client.post_raw_request(
+                body=body,
+                timeout_info=base_timeout_info(max_time_ms),
+            )
+            logger.info("finished issuing custom command to API")
+            return req_response
+
+    def get_database_admin(
+        self,
+        *,
+        token: Optional[str] = None,
+        dev_ops_url: Optional[str] = None,
+        dev_ops_api_version: Optional[str] = None,
+    ) -> AstraDBDatabaseAdmin:
+        """
+        Return an AstraDBDatabaseAdmin object corresponding to this database, for
+        use in admin tasks such as managing namespaces.
+
+        Args:
+            token: an access token with enough permission on the database to
+                perform the desired tasks. If omitted (as it can generally be done),
+                the token of this Database is used.
+            dev_ops_url: in case of custom deployments, this can be used to specify
+                the URL to the DevOps API, such as "https://api.astra.datastax.com".
+                Generally it can be omitted. The environment (prod/dev/...) is
+                determined from the API Endpoint.
+            dev_ops_api_version: this can specify a custom version of the DevOps API
+                (such as "v2"). Generally not needed.
+
+        Returns:
+            An AstraDBDatabaseAdmin instance targeting this database.
+
+        Example:
+            >>> my_db_admin = my_db.get_database_admin()
+            >>> if "new_namespace" not in my_db_admin.list_namespaces():
+            ...     my_db_admin.create_namespace("new_namespace")
+            >>> my_db_admin.list_namespaces()
+            ['default_keyspace', 'new_namespace']
+        """
+
+        # lazy importing here to avoid circular dependency
+        from astrapy.admin import AstraDBDatabaseAdmin
+
+        return AstraDBDatabaseAdmin.from_api_endpoint(
+            api_endpoint=self._astra_db.api_endpoint,
+            token=token or self._astra_db.token,
+            caller_name=self._astra_db.caller_name,
+            caller_version=self._astra_db.caller_version,
+            dev_ops_url=dev_ops_url,
+            dev_ops_api_version=dev_ops_api_version,
+        )
+
+
+class AsyncDatabase:
+    """
+    A Data API database. This is the entry-point object for doing database-level
+    DML, such as creating/deleting collections, and for obtaining Collection
+    objects themselves. This class has an asynchronous interface.
+
+    A Database comes with an "API Endpoint", which implies a Database object
+    instance reaches a specific region (relevant point in case of multi-region
+    databases).
+
+    Args:
+        api_endpoint: the full "API Endpoint" string used to reach the Data API.
+            Example: "https://<database_id>-<region>.apps.astra.datastax.com"
+        token: an Access Token to the database. Example: "AstraCS:xyz..."
+        namespace: this is the namespace all method calls will target, unless
+            one is explicitly specified in the call. If no namespace is supplied
+            when creating a Database, the name "default_namespace" is set.
+        caller_name: name of the application, or framework, on behalf of which
+            the Data API calls are performed. This ends up in the request user-agent.
+        caller_version: version of the caller.
+        api_path: path to append to the API Endpoint. In typical usage, this
+            should be left to its default of "/api/json".
+        api_version: version specifier to append to the API path. In typical
+            usage, this should be left to its default of "v1".
+
+    Example:
+        >>> from astrapy import DataAPIClient
+        >>> my_client = astrapy.DataAPIClient("AstraCS:...")
+        >>> my_db = my_client.get_async_database_by_api_endpoint(
+        ...    "https://01234567-....apps.astra.datastax.com"
+        ... )
+
+    Note:
+        creating an instance of AsyncDatabase does not trigger actual creation
+        of the database itself, which should exist beforehand. To create databases,
+        see the AstraDBAdmin class.
+    """
+
+    def __init__(
+        self,
+        api_endpoint: str,
+        token: str,
+        *,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+    ) -> None:
+        self._astra_db = AsyncAstraDB(
+            token=token,
+            api_endpoint=api_endpoint,
+            api_path=api_path,
+            api_version=api_version,
+            namespace=namespace,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+        self._name: Optional[str] = None
+
+    def __getattr__(self, collection_name: str) -> AsyncCollection:
+        return self.to_sync().get_collection(name=collection_name).to_async()
+
+    def __getitem__(self, collection_name: str) -> AsyncCollection:
+        return self.to_sync().get_collection(name=collection_name).to_async()
+
+    def __repr__(self) -> str:
+        return (
+            f'{self.__class__.__name__}(api_endpoint="{self._astra_db.api_endpoint}", '
+            f'token="{self._astra_db.token[:12]}...", namespace="{self._astra_db.namespace}")'
+        )
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, AsyncDatabase):
+            return self._astra_db == other._astra_db
+        else:
+            return False
+
+    async def __aenter__(self) -> AsyncDatabase:
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        await self._astra_db.__aexit__(
+            exc_type=exc_type,
+            exc_value=exc_value,
+            traceback=traceback,
+        )
+
+    def _copy(
+        self,
+        *,
+        api_endpoint: Optional[str] = None,
+        token: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+    ) -> AsyncDatabase:
+        return AsyncDatabase(
+            api_endpoint=api_endpoint or self._astra_db.api_endpoint,
+            token=token or self._astra_db.token,
+            namespace=namespace or self._astra_db.namespace,
+            caller_name=caller_name or self._astra_db.caller_name,
+            caller_version=caller_version or self._astra_db.caller_version,
+            api_path=api_path or self._astra_db.api_path,
+            api_version=api_version or self._astra_db.api_version,
+        )
+
+    def with_options(
+        self,
+        *,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> AsyncDatabase:
+        """
+        Create a clone of this database with some changed attributes.
+
+        Args:
+            namespace: this is the namespace all method calls will target, unless
+                one is explicitly specified in the call. If no namespace is supplied
+                when creating a Database, the name "default_namespace" is set.
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+
+        Returns:
+            a new `AsyncDatabase` instance.
+
+        Example:
+            >>> my_async_db_2 = my_async_db.with_options(
+            ...     namespace="the_other_namespace",
+            ...     caller_name="the_caller",
+            ...     caller_version="0.1.0",
+            ... )
+        """
+
+        return self._copy(
+            namespace=namespace,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
+    def to_sync(
+        self,
+        *,
+        api_endpoint: Optional[str] = None,
+        token: Optional[str] = None,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+        api_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+    ) -> Database:
+        """
+        Create a (synchronous) Database from this one. Save for the arguments
+        explicitly provided as overrides, everything else is kept identical
+        to this database in the copy.
+
+        Args:
+            api_endpoint: the full "API Endpoint" string used to reach the Data API.
+                Example: "https://<database_id>-<region>.apps.astra.datastax.com"
+            token: an Access Token to the database. Example: "AstraCS:xyz..."
+            namespace: this is the namespace all method calls will target, unless
+                one is explicitly specified in the call. If no namespace is supplied
+                when creating a Database, the name "default_namespace" is set.
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+            api_path: path to append to the API Endpoint. In typical usage, this
+                should be left to its default of "/api/json".
+            api_version: version specifier to append to the API path. In typical
+                usage, this should be left to its default of "v1".
+
+        Returns:
+            the new copy, a `Database` instance.
+
+        Example:
+            >>> my_sync_db = my_async_db.to_sync()
+            >>> my_sync_db.list_collection_names()
+            ['a_collection', 'another_collection']
+        """
+
+        return Database(
+            api_endpoint=api_endpoint or self._astra_db.api_endpoint,
+            token=token or self._astra_db.token,
+            namespace=namespace or self._astra_db.namespace,
+            caller_name=caller_name or self._astra_db.caller_name,
+            caller_version=caller_version or self._astra_db.caller_version,
+            api_path=api_path or self._astra_db.api_path,
+            api_version=api_version or self._astra_db.api_version,
+        )
+
+    def set_caller(
+        self,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> None:
+        """
+        Set a new identity for the application/framework on behalf of which
+        the Data API calls are performed (the "caller").
+
+        Args:
+            caller_name: name of the application, or framework, on behalf of which
+                the Data API calls are performed. This ends up in the request user-agent.
+            caller_version: version of the caller.
+
+        Example:
+            >>> my_db.set_caller(caller_name="the_caller", caller_version="0.1.0")
+        """
+
+        logger.info(f"setting caller to {caller_name}/{caller_version}")
+        self._astra_db.set_caller(
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
+    def info(self) -> DatabaseInfo:
+        """
+        Additional information on the database as a DatabaseInfo instance.
+
+        Some of the returned properties are dynamic throughout the lifetime
+        of the database (such as raw_info["keyspaces"]). For this reason,
+        each invocation of this method triggers a new request to the DevOps API.
+
+        Example:
+            >>> my_async_db.info().region
+            'eu-west-1'
+
+            >>> my_async_db.info().raw_info['datacenters'][0]['dateCreated']
+            '2023-01-30T12:34:56Z'
+
+        Note:
+            see the DatabaseInfo documentation for a caveat about the difference
+            between the `region` and the `raw_info["region"]` attributes.
+        """
+
+        logger.info("getting database info")
+        database_info = fetch_database_info(
+            self._astra_db.api_endpoint,
+            token=self._astra_db.token,
+            namespace=self.namespace,
+        )
+        if database_info is not None:
+            logger.info("finished getting database info")
+            return database_info
+        else:
+            raise DevOpsAPIException(
+                "Database is not in a supported environment for this operation."
+            )
+
+    @property
+    def id(self) -> str:
+        """
+        The ID of this database.
+
+        Example:
+            >>> my_async_db.id
+            '01234567-89ab-cdef-0123-456789abcdef'
+        """
+
+        parsed_api_endpoint = parse_api_endpoint(self._astra_db.api_endpoint)
+        if parsed_api_endpoint is not None:
+            return parsed_api_endpoint.database_id
+        else:
+            raise DevOpsAPIException(
+                "Database is not in a supported environment for this operation."
+            )
+
+    def name(self) -> str:
+        """
+        The name of this database. Note that this bears no unicity guarantees.
+
+        Calling this method the first time involves a request
+        to the DevOps API (the resulting database name is then cached).
+        See the `info()` method for more details.
+
+        Example:
+            >>> my_async_db.name()
+            'the_application_database'
+        """
+
+        if self._name is None:
+            self._name = self.info().name
+        return self._name
+
+    @property
+    def namespace(self) -> str:
+        """
+        The namespace this database uses as target for all commands when
+        no method-call-specific namespace is specified.
+
+        Example:
+            >>> my_async_db.namespace
+            'the_keyspace'
+        """
+
+        return self._astra_db.namespace
+
+    async def get_collection(
+        self, name: str, *, namespace: Optional[str] = None
+    ) -> AsyncCollection:
+        """
+        Spawn an `AsyncCollection` object instance representing a collection
+        on this database.
+
+        Creating an `AsyncCollection` instance does not have any effect on the
+        actual state of the database: in other words, for the created
+        `AsyncCollection` instance to be used meaningfully, the collection
+        must exist already (for instance, it should have been created
+        previously by calling the `create_collection` method).
+
+        Args:
+            name: the name of the collection.
+            namespace: the namespace containing the collection. If no namespace
+                is specified, the setting for this database is used.
+
+        Returns:
+            an `AsyncCollection` instance, representing the desired collection
+                (but without any form of validation).
+
+        Example:
+            >>> async def count_docs(adb: AsyncDatabase, c_name: str) -> int:
+            ...    async_col = await adb.get_collection(c_name)
+            ...    return await async_col.count_documents({}, upper_bound=100)
+            ...
+            >>> asyncio.run(count_docs(my_async_db, "my_collection"))
+            45
+
+        Note: the attribute and indexing syntax forms achieve the same effect
+            as this method, returning an AsyncCollection, albeit
+            in a synchronous way. In other words, the following are equivalent:
+                await my_async_db.get_collection("coll_name")
+                my_async_db.coll_name
+                my_async_db["coll_name"]
+        """
+
+        # lazy importing here against circular-import error
+        from astrapy.collection import AsyncCollection
+
+        _namespace = namespace or self._astra_db.namespace
+        return AsyncCollection(self, name, namespace=_namespace)
+
+    @recast_method_async
+    async def create_collection(
+        self,
+        name: str,
+        *,
+        namespace: Optional[str] = None,
+        dimension: Optional[int] = None,
+        metric: Optional[str] = None,
+        service: Optional[Union[CollectionVectorServiceOptions, Dict[str, Any]]] = None,
+        indexing: Optional[Dict[str, Any]] = None,
+        default_id_type: Optional[str] = None,
+        additional_options: Optional[Dict[str, Any]] = None,
+        check_exists: Optional[bool] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> AsyncCollection:
+        """
+        Creates a collection on the database and return the AsyncCollection
+        instance that represents it.
+
+        This is a blocking operation: the method returns when the collection
+        is ready to be used. As opposed to the `get_collection` instance,
+        this method triggers causes the collection to be actually created on DB.
+
+        Args:
+            name: the name of the collection.
+            namespace: the namespace where the collection is to be created.
+                If not specified, the general setting for this database is used.
+            dimension: for vector collections, the dimension of the vectors
+                (i.e. the number of their components).
+            metric: the similarity metric used for vector searches.
+                Allowed values are `VectorMetric.DOT_PRODUCT`, `VectorMetric.EUCLIDEAN`
+                or `VectorMetric.COSINE` (default).
+            service: a dictionary describing a service for
+                embedding computation, e.g. `{"provider": "ab", "modelName": "xy"}`.
+                Alternatively, a CollectionVectorServiceOptions object to the same effect.
+                NOTE: This feature is under current development.
+            indexing: optional specification of the indexing options for
+                the collection, in the form of a dictionary such as
+                    {"deny": [...]}
+                or
+                    {"allow": [...]}
+            default_id_type: this sets what type of IDs the API server will
+                generate when inserting documents that do not specify their
+                `_id` field explicitly. Can be set to any of the values
+                `DefaultIdType.UUID`, `DefaultIdType.OBJECTID`,
+                `DefaultIdType.UUIDV6`, `DefaultIdType.UUIDV7`,
+                `DefaultIdType.DEFAULT`.
+            additional_options: any further set of key-value pairs that will
+                be added to the "options" part of the payload when sending
+                the Data API command to create a collection.
+            check_exists: whether to run an existence check for the collection
+                name before attempting to create the collection:
+                If check_exists is True, an error is raised when creating
+                an existing collection.
+                If it is False, the creation is attempted. In this case, for
+                preexisting collections, the command will succeed or fail
+                depending on whether the options match or not.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            an `AsyncCollection` instance, representing the newly-created collection.
+
+        Example:
+            >>> async def create_and_insert(adb: AsyncDatabase) -> Dict[str, Any]:
+            ...     new_a_col = await adb.create_collection("my_v_col", dimension=3)
+            ...     return await new_a_col.insert_one(
+            ...         {"name": "the_row"},
+            ...         vector=[0.4, 0.5, 0.7],
+            ...     )
+            ...
+            >>> asyncio.run(create_and_insert(my_async_db))
+            InsertOneResult(raw_results=..., inserted_id='08f05ecf-...-...-...')
+
+        Note:
+            A collection is considered a vector collection if at least one of
+            `dimension` or `service` are provided and not null. In that case,
+            and only in that case, is `metric` an accepted parameter.
+            Note, moreover, that if passing both these parameters, then
+            the dimension must be compatible with the chosen service.
+        """
+
+        _validate_create_collection_options(
+            dimension=dimension,
+            metric=metric,
+            service=service,
+            indexing=indexing,
+            default_id_type=default_id_type,
+            additional_options=additional_options,
+        )
+        _options = {
+            **(additional_options or {}),
+            **({"indexing": indexing} if indexing else {}),
+            **({"defaultId": {"type": default_id_type}} if default_id_type else {}),
+        }
+
+        timeout_manager = MultiCallTimeoutManager(overall_max_time_ms=max_time_ms)
+
+        if check_exists is None:
+            _check_exists = True
+        else:
+            _check_exists = check_exists
+        existing_names: List[str]
+        if _check_exists:
+            logger.info(f"checking collection existence for '{name}'")
+            existing_names = await self.list_collection_names(
+                namespace=namespace,
+                max_time_ms=timeout_manager.remaining_timeout_ms(),
+            )
+        else:
+            existing_names = []
+        driver_db = self._astra_db.copy(namespace=namespace)
+        if name in existing_names:
+            raise CollectionAlreadyExistsException(
+                text=f"CollectionInvalid: collection {name} already exists",
+                namespace=driver_db.namespace,
+                collection_name=name,
+            )
+
+        service_dict: Optional[Dict[str, Any]]
+        if service is not None:
+            service_dict = service if isinstance(service, dict) else service.as_dict()
+        else:
+            service_dict = None
+
+        logger.info(f"creating collection '{name}'")
+        await driver_db.create_collection(
+            name,
+            options=_options,
+            dimension=dimension,
+            metric=metric,
+            service_dict=service_dict,
+            timeout_info=timeout_manager.remaining_timeout_info(),
+        )
+        logger.info(f"finished creating collection '{name}'")
+        return await self.get_collection(name, namespace=namespace)
+
+    @recast_method_async
+    async def drop_collection(
+        self,
+        name_or_collection: Union[str, AsyncCollection],
+        *,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Drop a collection from the database, along with all documents therein.
+
+        Args:
+            name_or_collection: either the name of a collection or
+                an `AsyncCollection` instance.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a dictionary in the form {"ok": 1} if the command succeeds.
+
+        Example:
+            >>> asyncio.run(my_async_db.list_collection_names())
+            ['a_collection', 'my_v_col', 'another_col']
+            >>> asyncio.run(my_async_db.drop_collection("my_v_col"))
+            {'ok': 1}
+            >>> asyncio.run(my_async_db.list_collection_names())
+            ['a_collection', 'another_col']
+
+        Note:
+            when providing a collection name, it is assumed that the collection
+            is to be found in the namespace set at database instance level.
+        """
+
+        # lazy importing here against circular-import error
+        from astrapy.collection import AsyncCollection
+
+        if isinstance(name_or_collection, AsyncCollection):
+            _namespace = name_or_collection.namespace
+            _name = name_or_collection.name
+            logger.info(f"dropping collection '{_name}'")
+            dc_response = await self._astra_db.copy(
+                namespace=_namespace
+            ).delete_collection(
+                _name,
+                timeout_info=base_timeout_info(max_time_ms),
+            )
+            logger.info(f"finished dropping collection '{_name}'")
+            return dc_response.get("status", {})  # type: ignore[no-any-return]
+        else:
+            logger.info(f"dropping collection '{name_or_collection}'")
+            dc_response = await self._astra_db.delete_collection(
+                name_or_collection,
+                timeout_info=base_timeout_info(max_time_ms),
+            )
+            logger.info(f"finished dropping collection '{name_or_collection}'")
+            return dc_response.get("status", {})  # type: ignore[no-any-return]
+
+    @recast_method_sync
+    def list_collections(
+        self,
+        *,
+        namespace: Optional[str] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> AsyncCommandCursor[CollectionDescriptor]:
+        """
+        List all collections in a given namespace for this database.
+
+        Args:
+            namespace: the namespace to be inspected. If not specified,
+                the general setting for this database is assumed.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            an `AsyncCommandCursor` to iterate over CollectionDescriptor instances,
+            each corresponding to a collection.
+
+        Example:
+            >>> async def a_list_colls(adb: AsyncDatabase) -> None:
+            ...     a_ccur = adb.list_collections()
+            ...     print("* a_ccur:", a_ccur)
+            ...     print("* list:", [coll async for coll in a_ccur])
+            ...     async for coll in adb.list_collections():
+            ...         print("* coll:", coll)
+            ...
+            >>> asyncio.run(a_list_colls(my_async_db))
+            * a_ccur: <astrapy.cursors.AsyncCommandCursor object at ...>
+            * list: [CollectionDescriptor(name='my_v_col', options=CollectionOptions())]
+            * coll: CollectionDescriptor(name='my_v_col', options=CollectionOptions())
+        """
+
+        _client: AsyncAstraDB
+        if namespace:
+            _client = self._astra_db.copy(namespace=namespace)
+        else:
+            _client = self._astra_db
+        logger.info("getting collections")
+        gc_response = _client.to_sync().get_collections(
+            options={"explain": True},
+            timeout_info=base_timeout_info(max_time_ms),
+        )
+        if "collections" not in gc_response.get("status", {}):
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from get_collections API command.",
+                raw_response=gc_response,
+            )
+        else:
+            # we know this is a list of dicts, to marshal into "descriptors"
+            logger.info("finished getting collections")
+            return AsyncCommandCursor(
+                address=self._astra_db.base_url,
+                items=[
+                    CollectionDescriptor.from_dict(col_dict)
+                    for col_dict in gc_response["status"]["collections"]
+                ],
+            )
+
+    @recast_method_async
+    async def list_collection_names(
+        self,
+        *,
+        namespace: Optional[str] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> List[str]:
+        """
+        List the names of all collections in a given namespace of this database.
+
+        Args:
+            namespace: the namespace to be inspected. If not specified,
+                the general setting for this database is assumed.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a list of the collection names as strings, in no particular order.
+
+        Example:
+            >>> asyncio.run(my_async_db.list_collection_names())
+            ['a_collection', 'another_col']
+        """
+
+        logger.info("getting collection names")
+        gc_response = await self._astra_db.copy(namespace=namespace).get_collections(
+            timeout_info=base_timeout_info(max_time_ms)
+        )
+        if "collections" not in gc_response.get("status", {}):
+            raise DataAPIFaultyResponseException(
+                text="Faulty response from get_collections API command.",
+                raw_response=gc_response,
+            )
+        else:
+            # we know this is a list of strings
+            logger.info("finished getting collection names")
+            return gc_response["status"]["collections"]  # type: ignore[no-any-return]
+
+    @recast_method_async
+    async def command(
+        self,
+        body: Dict[str, Any],
+        *,
+        namespace: Optional[str] = None,
+        collection_name: Optional[str] = None,
+        max_time_ms: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        """
+        Send a POST request to the Data API for this database with
+        an arbitrary, caller-provided payload.
+
+        Args:
+            body: a JSON-serializable dictionary, the payload of the request.
+            namespace: the namespace to use. Requests always target a namespace:
+                if not specified, the general setting for this database is assumed.
+            collection_name: if provided, the collection name is appended at the end
+                of the endpoint. In this way, this method allows collection-level
+                arbitrary POST requests as well.
+            max_time_ms: a timeout, in milliseconds, for the underlying HTTP request.
+
+        Returns:
+            a dictionary with the response of the HTTP request.
+
+        Example:
+            >>> asyncio.run(my_async_db.command({"findCollections": {}}))
+            {'status': {'collections': ['my_coll']}}
+            >>> asyncio.run(my_async_db.command(
+            ...     {"countDocuments": {}},
+            ...     collection_name="my_coll",
+            ... )
+            {'status': {'count': 123}}
+        """
+
+        if namespace:
+            _client = self._astra_db.copy(namespace=namespace)
+        else:
+            _client = self._astra_db
+        if collection_name:
+            _collection = await _client.collection(collection_name)
+            logger.info(f"issuing custom command to API (on '{collection_name}')")
+            req_response = await _collection.post_raw_request(
+                body=body,
+                timeout_info=base_timeout_info(max_time_ms),
+            )
+            logger.info(
+                f"finished issuing custom command to API (on '{collection_name}')"
+            )
+            return req_response
+        else:
+            logger.info("issuing custom command to API")
+            req_response = await _client.post_raw_request(
+                body=body,
+                timeout_info=base_timeout_info(max_time_ms),
+            )
+            logger.info("finished issuing custom command to API")
+            return req_response
+
+    def get_database_admin(
+        self,
+        *,
+        token: Optional[str] = None,
+        dev_ops_url: Optional[str] = None,
+        dev_ops_api_version: Optional[str] = None,
+    ) -> AstraDBDatabaseAdmin:
+        """
+        Return an AstraDBDatabaseAdmin object corresponding to this database, for
+        use in admin tasks such as managing namespaces.
+
+        Args:
+            token: an access token with enough permission on the database to
+                perform the desired tasks. If omitted (as it can generally be done),
+                the token of this Database is used.
+            dev_ops_url: in case of custom deployments, this can be used to specify
+                the URL to the DevOps API, such as "https://api.astra.datastax.com".
+                Generally it can be omitted. The environment (prod/dev/...) is
+                determined from the API Endpoint.
+            dev_ops_api_version: this can specify a custom version of the DevOps API
+                (such as "v2"). Generally not needed.
+
+        Returns:
+            An AstraDBDatabaseAdmin instance targeting this database.
+
+        Example:
+            >>> my_db_admin = my_async_db.get_database_admin()
+            >>> if "new_namespace" not in my_db_admin.list_namespaces():
+            ...     my_db_admin.create_namespace("new_namespace")
+            >>> my_db_admin.list_namespaces()
+            ['default_keyspace', 'new_namespace']
+        """
+
+        # lazy importing here to avoid circular dependency
+        from astrapy.admin import AstraDBDatabaseAdmin
+
+        return AstraDBDatabaseAdmin.from_api_endpoint(
+            api_endpoint=self._astra_db.api_endpoint,
+            token=token or self._astra_db.token,
+            caller_name=self._astra_db.caller_name,
+            caller_version=self._astra_db.caller_version,
+            dev_ops_url=dev_ops_url,
+            dev_ops_api_version=dev_ops_api_version,
+        )
diff --git a/llm/Lib/site-packages/astrapy/db/__init__.py b/llm/Lib/site-packages/astrapy/db/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6c772c8e6e3ead532d15e7fc493fe8097eabf836
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/db/__init__.py
@@ -0,0 +1,32 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Core "db" subpackage, exported here to preserve import patterns."""
+
+from astrapy.core.db import (
+    AstraDBCollection,
+    AsyncAstraDBCollection,
+    AstraDB,
+    AsyncAstraDB,
+    logger,
+)
+
+
+__all__ = [
+    "AstraDBCollection",
+    "AsyncAstraDBCollection",
+    "AstraDB",
+    "AsyncAstraDB",
+    "logger",
+]
diff --git a/llm/Lib/site-packages/astrapy/db/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/astrapy/db/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1c2b10e28b2e5a13f065c885a2aafd56d7f2864f
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/db/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/exceptions.py b/llm/Lib/site-packages/astrapy/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..899d6f2effd0e3e74711c764660b178bd9bea07c
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/exceptions.py
@@ -0,0 +1,817 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import time
+from functools import wraps
+from typing import Any, Awaitable, Callable, Dict, List, Optional, Union
+from dataclasses import dataclass
+
+import httpx
+
+from astrapy.core.api import APIRequestError
+from astrapy.core.utils import TimeoutInfo
+from astrapy.results import (
+    BulkWriteResult,
+    DeleteResult,
+    InsertManyResult,
+    OperationResult,
+    UpdateResult,
+)
+
+
+class DevOpsAPIException(ValueError):
+    """
+    An exception specific to issuing requests to the DevOps API.
+    """
+
+    def __init__(self, text: str = ""):
+        super().__init__(text)
+
+
+@dataclass
+class DevOpsAPIErrorDescriptor:
+    """
+    An object representing a single error returned from the DevOps API,
+    typically with an error code and a text message.
+
+    A single response from the Devops API may return zero, one or more of these.
+
+    Attributes:
+        id: a numeric code as found in the API "ID" item.
+        message: the text found in the API "error" item.
+        attributes: a dict with any further key-value pairs returned by the API.
+    """
+
+    id: Optional[int]
+    message: Optional[str]
+    attributes: Dict[str, Any]
+
+    def __init__(self, error_dict: Dict[str, Any]) -> None:
+        self.id = error_dict.get("ID")
+        self.message = error_dict.get("message")
+        self.attributes = {
+            k: v for k, v in error_dict.items() if k not in {"ID", "message"}
+        }
+
+
+class DevOpsAPIResponseException(DevOpsAPIException):
+    """
+    A request to the DevOps API returned with a non-success return code
+    and one of more errors in the HTTP response.
+
+    Attributes:
+        text: a text message about the exception.
+        command: the raw payload that was sent to the DevOps API.
+        error_descriptors: a list of all DevOpsAPIErrorDescriptor objects
+            returned by the API in the response.
+    """
+
+    text: Optional[str]
+    command: Optional[Dict[str, Any]]
+    error_descriptors: List[DevOpsAPIErrorDescriptor]
+
+    def __init__(
+        self,
+        text: Optional[str] = None,
+        *,
+        command: Optional[Dict[str, Any]] = None,
+        error_descriptors: List[DevOpsAPIErrorDescriptor] = [],
+    ) -> None:
+        super().__init__(text or self.__class__.__name__)
+        self.text = text
+        self.command = command
+        self.error_descriptors = error_descriptors
+
+    @staticmethod
+    def from_response(
+        command: Optional[Dict[str, Any]],
+        raw_response: Dict[str, Any],
+    ) -> DevOpsAPIResponseException:
+        """Parse a raw response from the API into this exception."""
+
+        error_descriptors = [
+            DevOpsAPIErrorDescriptor(error_dict)
+            for error_dict in raw_response.get("errors") or []
+        ]
+        if error_descriptors:
+            _text = error_descriptors[0].message
+        else:
+            _text = None
+        return DevOpsAPIResponseException(
+            text=_text, command=command, error_descriptors=error_descriptors
+        )
+
+
+@dataclass
+class DataAPIErrorDescriptor:
+    """list of
+    Ans object representing a single error returned from the Data API,
+    typically with an error code and a text message.
+    An API request would return with an HTTP 200 success error code,
+    but contain a nonzero amount of these.
+
+    A single response from the Data API may return zero, one or more of these.
+    Moreover, some operations, such as an insert_many, may partally succeed
+    yet return these errors about the rest of the operation (such as,
+    some of the input documents could not be inserted).
+
+    Attributes:
+        error_code: a string code as found in the API "error" item.
+        message: the text found in the API "error" item.
+        attributes: a dict with any further key-value pairs returned by the API.
+    """
+
+    error_code: Optional[str]
+    message: Optional[str]
+    attributes: Dict[str, Any]
+
+    def __init__(self, error_dict: Dict[str, str]) -> None:
+        self.error_code = error_dict.get("errorCode")
+        self.message = error_dict.get("message")
+        self.attributes = {
+            k: v for k, v in error_dict.items() if k not in {"errorCode", "message"}
+        }
+
+
+@dataclass
+class DataAPIDetailedErrorDescriptor:
+    """
+    An object representing an errorful response from the Data API.
+    Errors specific to the Data API (as opposed to e.g. network failures)
+    would result in an HTTP 200 success response code but coming with
+    one or more DataAPIErrorDescriptor objects.
+
+    This object corresponds to one response, and as such its attributes
+    are a single request payload, a single response, but a list of
+    DataAPIErrorDescriptor instances.
+
+    Attributes:
+        error_descriptors: a list of DataAPIErrorDescriptor objects.
+        command: the raw payload of the API request.
+        raw_response: the full API response in the form of a dict.
+    """
+
+    error_descriptors: List[DataAPIErrorDescriptor]
+    command: Optional[Dict[str, Any]]
+    raw_response: Dict[str, Any]
+
+
+class DataAPIException(ValueError):
+    """
+    Any exception occurred while issuing requests to the Data API
+    and specific to it, such as:
+      - a collection is found not to exist when gettings its metadata,
+      - the API return a response with an error,
+    but not, for instance,
+      - a network error while sending an HTTP request to the API.
+    """
+
+    pass
+
+
+@dataclass
+class DataAPITimeoutException(DataAPIException):
+    """
+    A Data API operation timed out. This can be a request timeout occurring
+    during a specific HTTP request, or can happen over the course of a method
+    involving several requests in a row, such as a paginated find.
+
+    Attributes:
+        text: a textual description of the error
+        timeout_type: this denotes the phase of the HTTP request when the event
+            occurred ("connect", "read", "write", "pool") or "generic" if there is
+            not a specific request associated to the exception.
+        endpoint: if the timeout is tied to a specific request, this is the
+            URL that the request was targeting.
+        raw_payload:  if the timeout is tied to a specific request, this is the
+            associated payload (as a string).
+    """
+
+    text: str
+    timeout_type: str
+    endpoint: Optional[str]
+    raw_payload: Optional[str]
+
+    def __init__(
+        self,
+        text: str,
+        *,
+        timeout_type: str,
+        endpoint: Optional[str],
+        raw_payload: Optional[str],
+    ) -> None:
+        super().__init__(text)
+        self.text = text
+        self.timeout_type = timeout_type
+        self.endpoint = endpoint
+        self.raw_payload = raw_payload
+
+
+@dataclass
+class CursorIsStartedException(DataAPIException):
+    """
+    The cursor operation cannot be invoked if a cursor is not in its pristine
+    state (i.e. is already being consumed or is exhausted altogether).
+
+    Attributes:
+        text: a text message about the exception.
+        cursor_state: a string description of the current state
+            of the cursor. See the documentation for Cursor.
+    """
+
+    text: str
+    cursor_state: str
+
+    def __init__(
+        self,
+        text: str,
+        *,
+        cursor_state: str,
+    ) -> None:
+        super().__init__(text)
+        self.text = text
+        self.cursor_state = cursor_state
+
+
+@dataclass
+class CollectionNotFoundException(DataAPIException):
+    """
+    A collection is found non-existing and the requested operation
+    cannot be performed.
+
+    Attributes:
+        text: a text message about the exception.
+        namespace: the namespace where the collection was supposed to be.
+        collection_name: the name of the expected collection.
+    """
+
+    text: str
+    namespace: str
+    collection_name: str
+
+    def __init__(
+        self,
+        text: str,
+        *,
+        namespace: str,
+        collection_name: str,
+    ) -> None:
+        super().__init__(text)
+        self.text = text
+        self.namespace = namespace
+        self.collection_name = collection_name
+
+
+@dataclass
+class CollectionAlreadyExistsException(DataAPIException):
+    """
+    An operation expected a collection not to exist, yet it has
+    been detected as pre-existing.
+
+    Attributes:
+        text: a text message about the exception.
+        namespace: the namespace where the collection was expected not to exist.
+        collection_name: the name of the collection.
+    """
+
+    text: str
+    namespace: str
+    collection_name: str
+
+    def __init__(
+        self,
+        text: str,
+        *,
+        namespace: str,
+        collection_name: str,
+    ) -> None:
+        super().__init__(text)
+        self.text = text
+        self.namespace = namespace
+        self.collection_name = collection_name
+
+
+@dataclass
+class TooManyDocumentsToCountException(DataAPIException):
+    """
+    A `count_documents()` operation failed because the resulting number of documents
+    exceeded either the upper bound set by the caller or the hard limit imposed
+    by the Data API.
+
+    Attributes:
+        text: a text message about the exception.
+        server_max_count_exceeded: True if the count limit imposed by the API
+            is reached. In that case, increasing the upper bound in the method
+            invocation is of no help.
+    """
+
+    text: str
+    server_max_count_exceeded: bool
+
+    def __init__(
+        self,
+        text: str,
+        *,
+        server_max_count_exceeded: bool,
+    ) -> None:
+        super().__init__(text)
+        self.text = text
+        self.server_max_count_exceeded = server_max_count_exceeded
+
+
+@dataclass
+class DataAPIFaultyResponseException(DataAPIException):
+    """
+    The Data API response is malformed in that it does not have
+    expected field(s), or they are of the wrong type.
+
+    Attributes:
+        text: a text message about the exception.
+        raw_response: the response returned by the API in the form of a dict.
+    """
+
+    text: str
+    raw_response: Optional[Dict[str, Any]]
+
+    def __init__(
+        self,
+        text: str,
+        raw_response: Optional[Dict[str, Any]],
+    ) -> None:
+        super().__init__(text)
+        self.text = text
+        self.raw_response = raw_response
+
+
+@dataclass
+class DataAPIResponseException(DataAPIException):
+    """
+    The Data API returned an HTTP 200 success response, which however
+    reports about API-specific error(s), possibly alongside partial successes.
+
+    This exception is related to an operation that can have spanned several
+    HTTP requests in sequence (e.g. a chunked insert_many). For this
+    reason, it should be not thought as being in a 1:1 relation with
+    actual API requests, rather with operations invoked by the user,
+    such as the methods of the Collection object.
+
+    Attributes:
+        text: a text message about the exception.
+        error_descriptors: a list of all DataAPIErrorDescriptor objects
+            found across all requests involved in this exception, which are
+            possibly more than one.
+        detailed_error_descriptors: a list of DataAPIDetailedErrorDescriptor
+            objects, one for each of the requests performed during this operation.
+            For single-request methods, such as insert_one, this list always
+            has a single element.
+    """
+
+    text: Optional[str]
+    error_descriptors: List[DataAPIErrorDescriptor]
+    detailed_error_descriptors: List[DataAPIDetailedErrorDescriptor]
+
+    def __init__(
+        self,
+        text: Optional[str],
+        *,
+        error_descriptors: List[DataAPIErrorDescriptor],
+        detailed_error_descriptors: List[DataAPIDetailedErrorDescriptor],
+    ) -> None:
+        super().__init__(text)
+        self.text = text
+        self.error_descriptors = error_descriptors
+        self.detailed_error_descriptors = detailed_error_descriptors
+
+    @classmethod
+    def from_response(
+        cls,
+        command: Optional[Dict[str, Any]],
+        raw_response: Dict[str, Any],
+        **kwargs: Any,
+    ) -> DataAPIResponseException:
+        """Parse a raw response from the API into this exception."""
+
+        return cls.from_responses(
+            commands=[command],
+            raw_responses=[raw_response],
+            **kwargs,
+        )
+
+    @classmethod
+    def from_responses(
+        cls,
+        commands: List[Optional[Dict[str, Any]]],
+        raw_responses: List[Dict[str, Any]],
+        **kwargs: Any,
+    ) -> DataAPIResponseException:
+        """Parse a list of raw responses from the API into this exception."""
+
+        detailed_error_descriptors: List[DataAPIDetailedErrorDescriptor] = []
+        for command, raw_response in zip(commands, raw_responses):
+            if raw_response.get("errors", []):
+                error_descriptors = [
+                    DataAPIErrorDescriptor(error_dict)
+                    for error_dict in raw_response["errors"]
+                ]
+                detailed_error_descriptor = DataAPIDetailedErrorDescriptor(
+                    error_descriptors=error_descriptors,
+                    command=command,
+                    raw_response=raw_response,
+                )
+                detailed_error_descriptors.append(detailed_error_descriptor)
+
+        # flatten
+        error_descriptors = [
+            error_descriptor
+            for d_e_d in detailed_error_descriptors
+            for error_descriptor in d_e_d.error_descriptors
+        ]
+
+        if error_descriptors:
+            text = error_descriptors[0].message
+        else:
+            text = ""
+
+        return cls(
+            text,
+            error_descriptors=error_descriptors,
+            detailed_error_descriptors=detailed_error_descriptors,
+            **kwargs,
+        )
+
+    def data_api_response_exception(self) -> DataAPIResponseException:
+        """Cast the exception, whatever the subclass, into this parent superclass."""
+
+        return DataAPIResponseException(
+            text=self.text,
+            error_descriptors=self.error_descriptors,
+            detailed_error_descriptors=self.detailed_error_descriptors,
+        )
+
+
+class CumulativeOperationException(DataAPIResponseException):
+    """
+    An exception of type DataAPIResponseException (see) occurred
+    during an operation that in general spans several requests.
+    As such, besides information on the error, it may have accumulated
+    a partial result from past successful Data API requests.
+
+    Attributes:
+        text: a text message about the exception.
+        error_descriptors: a list of all DataAPIErrorDescriptor objects
+            found across all requests involved in this exception, which are
+            possibly more than one.
+        detailed_error_descriptors: a list of DataAPIDetailedErrorDescriptor
+            objects, one for each of the requests performed during this operation.
+            For single-request methods, such as insert_one, this list always
+            has a single element.
+        partial_result: an OperationResult object, just like the one that would
+            be the return value of the operation, had it succeeded completely.
+    """
+
+    partial_result: OperationResult
+
+
+@dataclass
+class InsertManyException(CumulativeOperationException):
+    """
+    An exception of type DataAPIResponseException (see) occurred
+    during an insert_many (that in general spans several requests).
+    As such, besides information on the error, it may have accumulated
+    a partial result from past successful Data API requests.
+
+    Attributes:
+        text: a text message about the exception.
+        error_descriptors: a list of all DataAPIErrorDescriptor objects
+            found across all requests involved in this exception, which are
+            possibly more than one.
+        detailed_error_descriptors: a list of DataAPIDetailedErrorDescriptor
+            objects, one for each of the requests performed during this operation.
+            For single-request methods, such as insert_one, this list always
+            has a single element.
+        partial_result: an InsertManyResult object, just like the one that would
+            be the return value of the operation, had it succeeded completely.
+    """
+
+    partial_result: InsertManyResult
+
+    def __init__(
+        self, text: str, partial_result: InsertManyResult, *pargs: Any, **kwargs: Any
+    ) -> None:
+        super().__init__(text, *pargs, **kwargs)
+        self.partial_result = partial_result
+
+
+@dataclass
+class DeleteManyException(CumulativeOperationException):
+    """
+    An exception of type DataAPIResponseException (see) occurred
+    during a delete_many (that in general spans several requests).
+    As such, besides information on the error, it may have accumulated
+    a partial result from past successful Data API requests.
+
+    Attributes:
+        text: a text message about the exception.
+        error_descriptors: a list of all DataAPIErrorDescriptor objects
+            found across all requests involved in this exception, which are
+            possibly more than one.
+        detailed_error_descriptors: a list of DataAPIDetailedErrorDescriptor
+            objects, one for each of the requests performed during this operation.
+            For single-request methods, such as insert_one, this list always
+            has a single element.
+        partial_result: a DeleteResult object, just like the one that would
+            be the return value of the operation, had it succeeded completely.
+    """
+
+    partial_result: DeleteResult
+
+    def __init__(
+        self, text: str, partial_result: DeleteResult, *pargs: Any, **kwargs: Any
+    ) -> None:
+        super().__init__(text, *pargs, **kwargs)
+        self.partial_result = partial_result
+
+
+@dataclass
+class UpdateManyException(CumulativeOperationException):
+    """
+    An exception of type DataAPIResponseException (see) occurred
+    during an update_many (that in general spans several requests).
+    As such, besides information on the error, it may have accumulated
+    a partial result from past successful Data API requests.
+
+    Attributes:
+        text: a text message about the exception.
+        error_descriptors: a list of all DataAPIErrorDescriptor objects
+            found across all requests involved in this exception, which are
+            possibly more than one.
+        detailed_error_descriptors: a list of DataAPIDetailedErrorDescriptor
+            objects, one for each of the requests performed during this operation.
+            For single-request methods, such as insert_one, this list always
+            has a single element.
+        partial_result: an UpdateResult object, just like the one that would
+            be the return value of the operation, had it succeeded completely.
+    """
+
+    partial_result: UpdateResult
+
+    def __init__(
+        self, text: str, partial_result: UpdateResult, *pargs: Any, **kwargs: Any
+    ) -> None:
+        super().__init__(text, *pargs, **kwargs)
+        self.partial_result = partial_result
+
+
+@dataclass
+class BulkWriteException(DataAPIResponseException):
+    """
+    An exception of type DataAPIResponseException (see) occurred
+    during a bulk_write of a list of operations.
+    As such, besides information on the error, it may have accumulated
+    a partial result from past successful operations.
+
+    Attributes:
+        text: a text message about the exception.
+        error_descriptors: a list of all DataAPIErrorDescriptor objects
+            found across all requests involved in the first
+            operation that has failed.
+        detailed_error_descriptors: a list of DataAPIDetailedErrorDescriptor
+            objects, one for each of the requests performed during the first operation
+            that has failed.
+        partial_result: a BulkWriteResult object, just like the one that would
+            be the return value of the operation, had it succeeded completely.
+        exceptions: a list of DataAPIResponseException objects, one for each
+            operation in the bulk that has failed. This information is made
+            available here since the top-level fields of this error
+            only surface the first such failure that is detected across the bulk.
+            In case of bulk_writes with ordered=True, this trivially contains
+            a single element, the same described by the top-level fields
+            text, error_descriptors and detailed_error_descriptors.
+    """
+
+    partial_result: BulkWriteResult
+    exceptions: List[DataAPIResponseException]
+
+    def __init__(
+        self,
+        text: Optional[str],
+        partial_result: BulkWriteResult,
+        exceptions: List[DataAPIResponseException],
+        *pargs: Any,
+        **kwargs: Any,
+    ) -> None:
+        _text = text or "Bulk write exception"
+        super().__init__(_text, *pargs, **kwargs)
+        self.partial_result = partial_result
+        self.exceptions = exceptions
+
+
+def to_dataapi_timeout_exception(
+    httpx_timeout: httpx.TimeoutException,
+) -> DataAPITimeoutException:
+    text = str(httpx_timeout)
+    if isinstance(httpx_timeout, httpx.ConnectTimeout):
+        timeout_type = "connect"
+    elif isinstance(httpx_timeout, httpx.ReadTimeout):
+        timeout_type = "read"
+    elif isinstance(httpx_timeout, httpx.WriteTimeout):
+        timeout_type = "write"
+    elif isinstance(httpx_timeout, httpx.PoolTimeout):
+        timeout_type = "pool"
+    else:
+        timeout_type = "generic"
+    if httpx_timeout.request:
+        endpoint = str(httpx_timeout.request.url)
+        if isinstance(httpx_timeout.request.content, bytes):
+            raw_payload = httpx_timeout.request.content.decode()
+        else:
+            raw_payload = None
+    else:
+        endpoint = None
+        raw_payload = None
+    return DataAPITimeoutException(
+        text=text,
+        timeout_type=timeout_type,
+        endpoint=endpoint,
+        raw_payload=raw_payload,
+    )
+
+
+def recast_method_sync(method: Callable[..., Any]) -> Callable[..., Any]:
+    """
+    Decorator for a sync method liable to generate the core APIRequestError.
+    That exception is intercepted and recast as DataAPIResponseException.
+    Moreover, timeouts are also caught and converted into Data API timeouts.
+    """
+
+    @wraps(method)
+    def _wrapped_sync(*pargs: Any, **kwargs: Any) -> Any:
+        try:
+            return method(*pargs, **kwargs)
+        except APIRequestError as exc:
+            raise DataAPIResponseException.from_response(
+                command=exc.payload, raw_response=exc.response.json()
+            )
+        except httpx.TimeoutException as texc:
+            raise to_dataapi_timeout_exception(texc)
+
+    return _wrapped_sync
+
+
+def recast_method_async(
+    method: Callable[..., Awaitable[Any]]
+) -> Callable[..., Awaitable[Any]]:
+    """
+    Decorator for an async method liable to generate the core APIRequestError.
+    That exception is intercepted and recast as DataAPIResponseException.
+    Moreover, timeouts are also caught and converted into Data API timeouts.
+    """
+
+    @wraps(method)
+    async def _wrapped_async(*pargs: Any, **kwargs: Any) -> Any:
+        try:
+            return await method(*pargs, **kwargs)
+        except APIRequestError as exc:
+            raise DataAPIResponseException.from_response(
+                command=exc.payload, raw_response=exc.response.json()
+            )
+        except httpx.TimeoutException as texc:
+            raise to_dataapi_timeout_exception(texc)
+
+    return _wrapped_async
+
+
+def ops_recast_method_sync(method: Callable[..., Any]) -> Callable[..., Any]:
+    """
+    Decorator for a sync DevOps method liable to generate the core APIRequestError.
+    That exception is intercepted and recast as DevOpsAPIException.
+    Moreover, timeouts are also caught and converted into Data API timeouts.
+    """
+
+    @wraps(method)
+    def _wrapped_sync(*pargs: Any, **kwargs: Any) -> Any:
+        try:
+            return method(*pargs, **kwargs)
+        except APIRequestError as exc:
+            raise DevOpsAPIResponseException.from_response(
+                command=exc.payload, raw_response=exc.response.json()
+            )
+        except httpx.TimeoutException as texc:
+            raise to_dataapi_timeout_exception(texc)
+
+    return _wrapped_sync
+
+
+def ops_recast_method_async(
+    method: Callable[..., Awaitable[Any]]
+) -> Callable[..., Awaitable[Any]]:
+    """
+    Decorator for an async DevOps method liable to generate the core APIRequestError.
+    That exception is intercepted and recast as DevOpsAPIException.
+    Moreover, timeouts are also caught and converted into Data API timeouts.
+    """
+
+    @wraps(method)
+    async def _wrapped_async(*pargs: Any, **kwargs: Any) -> Any:
+        try:
+            return await method(*pargs, **kwargs)
+        except APIRequestError as exc:
+            raise DevOpsAPIResponseException.from_response(
+                command=exc.payload, raw_response=exc.response.json()
+            )
+        except httpx.TimeoutException as texc:
+            raise to_dataapi_timeout_exception(texc)
+
+    return _wrapped_async
+
+
+def base_timeout_info(max_time_ms: Optional[int]) -> Union[TimeoutInfo, None]:
+    if max_time_ms is not None:
+        return {"base": max_time_ms / 1000.0}
+    else:
+        return None
+
+
+class MultiCallTimeoutManager:
+    """
+    A helper class to keep track of timing and timeouts
+    in a multi-call method context.
+
+    Args:
+        overall_max_time_ms: an optional max duration to track (milliseconds)
+
+    Attributes:
+        overall_max_time_ms: an optional max duration to track (milliseconds)
+        started_ms: timestamp of the instance construction (milliseconds)
+        deadline_ms: optional deadline in milliseconds (computed by the class).
+    """
+
+    overall_max_time_ms: Optional[int]
+    started_ms: int = -1
+    deadline_ms: Optional[int]
+
+    def __init__(
+        self, overall_max_time_ms: Optional[int], exception_type: str = "data_api"
+    ) -> None:
+        self.started_ms = int(time.time() * 1000)
+        self.overall_max_time_ms = overall_max_time_ms
+        self.exception_type = exception_type
+        if self.overall_max_time_ms is not None:
+            self.deadline_ms = self.started_ms + self.overall_max_time_ms
+        else:
+            self.deadline_ms = None
+
+    def remaining_timeout_ms(self) -> Union[int, None]:
+        """
+        Ensure the deadline, if any, is not yet in the past.
+        If it is, raise an appropriate timeout error.
+        If not, return either None (if no timeout) or the remaining milliseconds.
+        For use within the multi-call method.
+        """
+        now_ms = int(time.time() * 1000)
+        if self.deadline_ms is not None:
+            if now_ms < self.deadline_ms:
+                return self.deadline_ms - now_ms
+            else:
+                if self.exception_type == "data_api":
+                    raise DataAPITimeoutException(
+                        text="Operation timed out.",
+                        timeout_type="generic",
+                        endpoint=None,
+                        raw_payload=None,
+                    )
+                elif self.exception_type == "devops_api":
+                    raise DevOpsAPIException("Operation timed out.")
+                else:
+                    raise ValueError("Operation timed out.")
+        else:
+            return None
+
+    def remaining_timeout_info(self) -> Union[TimeoutInfo, None]:
+        """
+        Ensure the deadline, if any, is not yet in the past.
+        If it is, raise an appropriate timeout error.
+        It it is not, or there is no deadline, return a suitable TimeoutInfo
+        for use within the multi-call method.
+        """
+        return base_timeout_info(max_time_ms=self.remaining_timeout_ms())
+
+
+__pdoc__ = {
+    "base_timeout_info": False,
+    "to_dataapi_timeout_exception": False,
+    "MultiCallTimeoutManager": False,
+}
diff --git a/llm/Lib/site-packages/astrapy/ids.py b/llm/Lib/site-packages/astrapy/ids.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2aac8d1e66cf686b02c95cb8301e2ea3c5311f5
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/ids.py
@@ -0,0 +1,39 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+from astrapy.core.ids import (
+    ObjectId,
+    uuid1,
+    uuid3,
+    uuid4,
+    uuid5,
+    uuid6,
+    uuid7,
+    uuid8,
+    UUID,
+)
+
+__all__ = [
+    "ObjectId",
+    "uuid1",
+    "uuid3",
+    "uuid4",
+    "uuid5",
+    "uuid6",
+    "uuid7",
+    "uuid8",
+    "UUID",
+]
diff --git a/llm/Lib/site-packages/astrapy/info.py b/llm/Lib/site-packages/astrapy/info.py
new file mode 100644
index 0000000000000000000000000000000000000000..a0bdd53aeeb6b6f11bcb07146769631d93ace2f3
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/info.py
@@ -0,0 +1,429 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+from dataclasses import dataclass
+
+
+@dataclass
+class DatabaseInfo:
+    """
+    Represents the identifying information for a database,
+    including the region the connection is established to.
+
+    Attributes:
+        id: the database ID.
+        region: the ID of the region through which the connection to DB is done.
+        namespace: the namespace this DB is set to work with.
+        name: the database name. Not necessarily unique: there can be multiple
+            databases with the same name.
+        environment: a label, whose value is one of Environment.PROD, Environment.DEV
+            or Environment.TEST.
+        raw_info: the full response from the DevOPS API call to get this info.
+
+    Note:
+        The `raw_info` dictionary usually has a `region` key describing
+        the default region as configured in the database, which does not
+        necessarily (for multi-region databases) match the region through
+        which the connection is established: the latter is the one specified
+        by the "api endpoint" used for connecting. In other words, for multi-region
+        databases it is possible that
+            database_info.region != database_info.raw_info["region"]
+        Conversely, in case of a DatabaseInfo not obtained through a
+        connected database, such as when calling `Admin.list_databases()`,
+        all fields except `environment` (e.g. namespace, region, etc)
+        are set as found on the DevOps API response directly.
+    """
+
+    id: str
+    region: str
+    namespace: str
+    name: str
+    environment: str
+    raw_info: Optional[Dict[str, Any]]
+
+
+@dataclass
+class AdminDatabaseInfo:
+    """
+    Represents the full response from the DevOps API about a database info.
+
+    Most attributes just contain the corresponding part of the raw response:
+    for this reason, please consult the DevOps API documentation for details.
+
+    Attributes:
+        info: a DatabaseInfo instance for the underlying database.
+            The DatabaseInfo is a subset of the information described by
+            AdminDatabaseInfo - in terms of the DevOps API response,
+            it corresponds to just its "info" subdictionary.
+        available_actions: the "availableActions" value in the full API response.
+        cost: the "cost" value in the full API response.
+        cqlsh_url: the "cqlshUrl" value in the full API response.
+        creation_time: the "creationTime" value in the full API response.
+        data_endpoint_url: the "dataEndpointUrl" value in the full API response.
+        grafana_url: the "grafanaUrl" value in the full API response.
+        graphql_url: the "graphqlUrl" value in the full API response.
+        id: the "id" value in the full API response.
+        last_usage_time: the "lastUsageTime" value in the full API response.
+        metrics: the "metrics" value in the full API response.
+        observed_status: the "observedStatus" value in the full API response.
+        org_id: the "orgId" value in the full API response.
+        owner_id: the "ownerId" value in the full API response.
+        status: the "status" value in the full API response.
+        storage: the "storage" value in the full API response.
+        termination_time: the "terminationTime" value in the full API response.
+        raw_info: the full raw response from the DevOps API.
+    """
+
+    info: DatabaseInfo
+    available_actions: Optional[List[str]]
+    cost: Dict[str, Any]
+    cqlsh_url: str
+    creation_time: str
+    data_endpoint_url: str
+    grafana_url: str
+    graphql_url: str
+    id: str
+    last_usage_time: str
+    metrics: Dict[str, Any]
+    observed_status: str
+    org_id: str
+    owner_id: str
+    status: str
+    storage: Dict[str, Any]
+    termination_time: str
+    raw_info: Optional[Dict[str, Any]]
+
+
+@dataclass
+class CollectionInfo:
+    """
+    Represents the identifying information for a collection,
+    including the information about the database the collection belongs to.
+
+    Attributes:
+        database_info: a DatabaseInfo instance for the underlying database.
+        namespace: the namespace where the collection is located.
+        name: collection name. Unique within a namespace.
+        full_name: identifier for the collection within the database,
+            in the form "namespace.collection_name".
+    """
+
+    database_info: DatabaseInfo
+    namespace: str
+    name: str
+    full_name: str
+
+
+@dataclass
+class CollectionDefaultIDOptions:
+    """
+    The "defaultId" component of the collection options.
+    See the Data API specifications for allowed values.
+
+    Attributes:
+        default_id_type: string such as `objectId`, `uuid6` and so on.
+    """
+
+    default_id_type: str
+
+    def as_dict(self) -> Dict[str, Any]:
+        """Recast this object into a dictionary."""
+
+        return {"type": self.default_id_type}
+
+    @staticmethod
+    def from_dict(
+        raw_dict: Optional[Dict[str, Any]]
+    ) -> Optional[CollectionDefaultIDOptions]:
+        """
+        Create an instance of CollectionDefaultIDOptions from a dictionary
+        such as one from the Data API.
+        """
+
+        if raw_dict is not None:
+            return CollectionDefaultIDOptions(default_id_type=raw_dict["type"])
+        else:
+            return None
+
+
+@dataclass
+class CollectionVectorServiceOptions:
+    """
+    The "vector.service" component of the collection options.
+    See the Data API specifications for allowed values.
+
+    NOTE: This feature is under current development.
+
+    Attributes:
+        provider: the name of a service provider for embedding calculation.
+        model_name: the name of a specific model for use by the service.
+    """
+
+    provider: Optional[str]
+    model_name: Optional[str]
+
+    def as_dict(self) -> Dict[str, Any]:
+        """Recast this object into a dictionary."""
+
+        return {
+            k: v
+            for k, v in {
+                "provider": self.provider,
+                "modelName": self.model_name,
+            }.items()
+            if v is not None
+        }
+
+    @staticmethod
+    def from_dict(
+        raw_dict: Optional[Dict[str, Any]]
+    ) -> Optional[CollectionVectorServiceOptions]:
+        """
+        Create an instance of CollectionVectorServiceOptions from a dictionary
+        such as one from the Data API.
+        """
+
+        if raw_dict is not None:
+            return CollectionVectorServiceOptions(
+                provider=raw_dict.get("provider"),
+                model_name=raw_dict.get("modelName"),
+            )
+        else:
+            return None
+
+
+@dataclass
+class CollectionVectorOptions:
+    """
+    The "vector" component of the collection options.
+    See the Data API specifications for allowed values.
+
+    Attributes:
+        dimension: an optional positive integer, the dimensionality of the vector space.
+        metric: an optional metric among `VectorMetric.DOT_PRODUCT`,
+            `VectorMetric.EUCLIDEAN` and `VectorMetric.COSINE`.
+        service: an optional X object in case a service is configured for the collection.
+            NOTE: This feature is under current development.
+    """
+
+    dimension: Optional[int]
+    metric: Optional[str]
+    service: Optional[CollectionVectorServiceOptions]
+
+    def as_dict(self) -> Dict[str, Any]:
+        """Recast this object into a dictionary."""
+
+        return {
+            k: v
+            for k, v in {
+                "dimension": self.dimension,
+                "metric": self.metric,
+                "service": None if self.service is None else self.service.as_dict(),
+            }.items()
+            if v is not None
+        }
+
+    @staticmethod
+    def from_dict(
+        raw_dict: Optional[Dict[str, Any]]
+    ) -> Optional[CollectionVectorOptions]:
+        """
+        Create an instance of CollectionVectorOptions from a dictionary
+        such as one from the Data API.
+        """
+
+        if raw_dict is not None:
+            return CollectionVectorOptions(
+                dimension=raw_dict.get("dimension"),
+                metric=raw_dict.get("metric"),
+                service=CollectionVectorServiceOptions.from_dict(
+                    raw_dict.get("service")
+                ),
+            )
+        else:
+            return None
+
+
+@dataclass
+class CollectionOptions:
+    """
+    A structure expressing the options of a collection.
+    See the Data API specifications for detailed specification and allowed values.
+
+    Attributes:
+        vector: an optional CollectionVectorOptions object.
+        indexing: an optional dictionary with the "indexing" collection properties.
+        default_id: an optional CollectionDefaultIDOptions object.
+        raw_options: the raw response from the Data API for the collection configuration.
+    """
+
+    vector: Optional[CollectionVectorOptions]
+    indexing: Optional[Dict[str, Any]]
+    default_id: Optional[CollectionDefaultIDOptions]
+    raw_options: Optional[Dict[str, Any]]
+
+    def __repr__(self) -> str:
+        not_null_pieces = [
+            pc
+            for pc in [
+                None if self.vector is None else f"vector={self.vector.__repr__()}",
+                (
+                    None
+                    if self.indexing is None
+                    else f"indexing={self.indexing.__repr__()}"
+                ),
+                (
+                    None
+                    if self.default_id is None
+                    else f"default_id={self.default_id.__repr__()}"
+                ),
+            ]
+            if pc is not None
+        ]
+        return f"{self.__class__.__name__}({', '.join(not_null_pieces)})"
+
+    def as_dict(self) -> Dict[str, Any]:
+        """Recast this object into a dictionary."""
+
+        return {
+            k: v
+            for k, v in {
+                "vector": None if self.vector is None else self.vector.as_dict(),
+                "indexing": self.indexing,
+                "defaultId": (
+                    None if self.default_id is None else self.default_id.as_dict()
+                ),
+            }.items()
+            if v is not None
+        }
+
+    def flatten(self) -> Dict[str, Any]:
+        """
+        Recast this object as a flat key-value pair suitable for
+        use as kwargs in a create_collection method call (including recasts).
+        """
+
+        _dimension: Optional[int]
+        _metric: Optional[str]
+        _indexing: Optional[Dict[str, Any]]
+        _service: Optional[Dict[str, Any]]
+        _default_id_type: Optional[str]
+        if self.vector is not None:
+            _dimension = self.vector.dimension
+            _metric = self.vector.metric
+            if self.vector.service is None:
+                _service = None
+            else:
+                _service = self.vector.service.as_dict()
+        else:
+            _dimension = None
+            _metric = None
+            _service = None
+        _indexing = self.indexing
+        if self.default_id is not None:
+            _default_id_type = self.default_id.default_id_type
+        else:
+            _default_id_type = None
+
+        return {
+            k: v
+            for k, v in {
+                "dimension": _dimension,
+                "metric": _metric,
+                "service": _service,
+                "indexing": _indexing,
+                "default_id_type": _default_id_type,
+            }.items()
+            if v is not None
+        }
+
+    @staticmethod
+    def from_dict(raw_dict: Dict[str, Any]) -> CollectionOptions:
+        """
+        Create an instance of CollectionOptions from a dictionary
+        such as one from the Data API.
+        """
+
+        return CollectionOptions(
+            vector=CollectionVectorOptions.from_dict(raw_dict.get("vector")),
+            indexing=raw_dict.get("indexing"),
+            default_id=CollectionDefaultIDOptions.from_dict(raw_dict.get("defaultId")),
+            raw_options=raw_dict,
+        )
+
+
+@dataclass
+class CollectionDescriptor:
+    """
+    A structure expressing full description of a collection as the Data API
+    returns it, i.e. its name and its `options` sub-structure.
+
+    Attributes:
+        name: the name of the collection.
+        options: a CollectionOptions instance.
+        raw_descriptor: the raw response from the Data API.
+    """
+
+    name: str
+    options: CollectionOptions
+    raw_descriptor: Optional[Dict[str, Any]]
+
+    def __repr__(self) -> str:
+        return (
+            f"{self.__class__.__name__}("
+            f"name={self.name.__repr__()}, "
+            f"options={self.options.__repr__()})"
+        )
+
+    def as_dict(self) -> Dict[str, Any]:
+        """
+        Recast this object into a dictionary.
+        Empty `options` will not be returned at all.
+        """
+
+        return {
+            k: v
+            for k, v in {
+                "name": self.name,
+                "options": self.options.as_dict(),
+            }.items()
+            if v
+        }
+
+    def flatten(self) -> Dict[str, Any]:
+        """
+        Recast this object as a flat key-value pair suitable for
+        use as kwargs in a create_collection method call (including recasts).
+        """
+
+        return {
+            **(self.options.flatten()),
+            **{"name": self.name},
+        }
+
+    @staticmethod
+    def from_dict(raw_dict: Dict[str, Any]) -> CollectionDescriptor:
+        """
+        Create an instance of CollectionDescriptor from a dictionary
+        such as one from the Data API.
+        """
+
+        return CollectionDescriptor(
+            name=raw_dict["name"],
+            options=CollectionOptions.from_dict(raw_dict.get("options") or {}),
+            raw_descriptor=raw_dict,
+        )
diff --git a/llm/Lib/site-packages/astrapy/operations.py b/llm/Lib/site-packages/astrapy/operations.py
new file mode 100644
index 0000000000000000000000000000000000000000..5c7a6c23552ee0b579659066f7ecb3a9cfaf2fc3
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/operations.py
@@ -0,0 +1,913 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from dataclasses import dataclass
+from functools import reduce
+from typing import (
+    Any,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+)
+
+from astrapy.constants import DocumentType, SortType, VectorType
+from astrapy.results import (
+    BulkWriteResult,
+    DeleteResult,
+    InsertManyResult,
+    InsertOneResult,
+    UpdateResult,
+)
+from astrapy.collection import AsyncCollection, Collection
+
+
+def reduce_bulk_write_results(results: List[BulkWriteResult]) -> BulkWriteResult:
+    """
+    Reduce a list of bulk write results into a single one.
+
+    Args:
+        results: a list of BulkWriteResult instances.
+
+    Returns:
+        A new BulkWRiteResult object which summarized the whole input list.
+    """
+
+    zero = BulkWriteResult.zero()
+
+    def _sum_results(r1: BulkWriteResult, r2: BulkWriteResult) -> BulkWriteResult:
+        bulk_api_results = {**r1.bulk_api_results, **r2.bulk_api_results}
+        if r1.deleted_count is None or r2.deleted_count is None:
+            deleted_count = None
+        else:
+            deleted_count = r1.deleted_count + r2.deleted_count
+        inserted_count = r1.inserted_count + r2.inserted_count
+        matched_count = r1.matched_count + r2.matched_count
+        modified_count = r1.modified_count + r2.modified_count
+        upserted_count = r1.upserted_count + r2.upserted_count
+        upserted_ids = {**r1.upserted_ids, **r2.upserted_ids}
+        return BulkWriteResult(
+            bulk_api_results=bulk_api_results,
+            deleted_count=deleted_count,
+            inserted_count=inserted_count,
+            matched_count=matched_count,
+            modified_count=modified_count,
+            upserted_count=upserted_count,
+            upserted_ids=upserted_ids,
+        )
+
+    return reduce(_sum_results, results, zero)
+
+
+class BaseOperation(ABC):
+    """
+    Base class for all operations amenable to be used
+    in bulk writes on (sync) collections.
+    """
+
+    @abstractmethod
+    def execute(
+        self,
+        collection: Collection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult: ...
+
+
+@dataclass
+class InsertOne(BaseOperation):
+    """
+    Represents an `insert_one` operation on a (sync) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        document: the document to insert.
+        vector: an optional suitable vector to enrich the document at insertion.
+        vectorize: a string to be made into a vector, with the same result as the
+            `vector` attribute, through an embedding service, assuming one is
+            configured for the collection.
+            NOTE: This feature is under current development.
+    """
+
+    document: DocumentType
+    vector: Optional[VectorType]
+    vectorize: Optional[str]
+
+    def __init__(
+        self,
+        document: DocumentType,
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+    ) -> None:
+        self.document = document
+        self.vector = vector
+        self.vectorize = vectorize
+
+    def execute(
+        self,
+        collection: Collection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: InsertOneResult = collection.insert_one(
+            document=self.document,
+            vector=self.vector,
+            vectorize=self.vectorize,
+            max_time_ms=bulk_write_timeout_ms,
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
+
+
+@dataclass
+class InsertMany(BaseOperation):
+    """
+    Represents an `insert_many` operation on a (sync) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        documents: the list document to insert.
+        vectors: an optional list of vectors to enrich the documents at insertion.
+        vectorize: an optional list of texts achieving the same effect as `vectors`
+            except through an embedding service, if one is configured for the collection.
+            NOTE: This feature is under current development.
+        ordered: whether the inserts should be done in sequence.
+        chunk_size: how many documents to include in a single API request.
+            Exceeding the server maximum allowed value results in an error.
+            Leave it unspecified (recommended) to use the system default.
+        concurrency: maximum number of concurrent requests to the API at
+            a given time. It cannot be more than one for ordered insertions.
+    """
+
+    documents: Iterable[DocumentType]
+    vectors: Optional[Iterable[Optional[VectorType]]]
+    vectorize: Optional[Iterable[Optional[str]]]
+    ordered: bool
+    chunk_size: Optional[int]
+    concurrency: Optional[int]
+
+    def __init__(
+        self,
+        documents: Iterable[DocumentType],
+        *,
+        vectors: Optional[Iterable[Optional[VectorType]]] = None,
+        vectorize: Optional[Iterable[Optional[str]]] = None,
+        ordered: bool = True,
+        chunk_size: Optional[int] = None,
+        concurrency: Optional[int] = None,
+    ) -> None:
+        self.documents = documents
+        self.ordered = ordered
+        self.vectors = vectors
+        self.vectorize = vectorize
+        self.chunk_size = chunk_size
+        self.concurrency = concurrency
+
+    def execute(
+        self,
+        collection: Collection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: InsertManyResult = collection.insert_many(
+            documents=self.documents,
+            vectors=self.vectors,
+            vectorize=self.vectorize,
+            ordered=self.ordered,
+            chunk_size=self.chunk_size,
+            concurrency=self.concurrency,
+            max_time_ms=bulk_write_timeout_ms,
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
+
+
+@dataclass
+class UpdateOne(BaseOperation):
+    """
+    Represents an `update_one` operation on a (sync) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        filter: a filter condition to select a target document.
+        update: an update prescription to apply to the document.
+        vector: a vector of numbers to use for ANN (vector-search) sorting.
+        vectorize: a string to be made into a vector, with the same result as the
+            `vector` attribute, through an embedding service, assuming one is
+            configured for the collection.
+            NOTE: This feature is under current development.
+        sort: controls ordering of results, hence which document is affected.
+        upsert: controls what to do when no documents are found.
+    """
+
+    filter: Dict[str, Any]
+    update: Dict[str, Any]
+    vector: Optional[VectorType]
+    vectorize: Optional[str]
+    sort: Optional[SortType]
+    upsert: bool
+
+    def __init__(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        upsert: bool = False,
+    ) -> None:
+        self.filter = filter
+        self.update = update
+        self.vector = vector
+        self.vectorize = vectorize
+        self.sort = sort
+        self.upsert = upsert
+
+    def execute(
+        self,
+        collection: Collection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: UpdateResult = collection.update_one(
+            filter=self.filter,
+            update=self.update,
+            vector=self.vector,
+            vectorize=self.vectorize,
+            sort=self.sort,
+            upsert=self.upsert,
+            max_time_ms=bulk_write_timeout_ms,
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
+
+
+@dataclass
+class UpdateMany(BaseOperation):
+    """
+    Represents an `update_many` operation on a (sync) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        filter: a filter condition to select target documents.
+        update: an update prescription to apply to the documents.
+        upsert: controls what to do when no documents are found.
+    """
+
+    filter: Dict[str, Any]
+    update: Dict[str, Any]
+    upsert: bool
+
+    def __init__(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        *,
+        upsert: bool = False,
+    ) -> None:
+        self.filter = filter
+        self.update = update
+        self.upsert = upsert
+
+    def execute(
+        self,
+        collection: Collection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: UpdateResult = collection.update_many(
+            filter=self.filter,
+            update=self.update,
+            upsert=self.upsert,
+            max_time_ms=bulk_write_timeout_ms,
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
+
+
+@dataclass
+class ReplaceOne(BaseOperation):
+    """
+    Represents a `replace_one` operation on a (sync) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        filter: a filter condition to select a target document.
+        replacement: the replacement document.
+        vector: a vector of numbers to use for ANN (vector-search) sorting.
+        vectorize: a string to be made into a vector, with the same result as the
+            `vector` attribute, through an embedding service, assuming one is
+            configured for the collection.
+            NOTE: This feature is under current development.
+        sort: controls ordering of results, hence which document is affected.
+        upsert: controls what to do when no documents are found.
+    """
+
+    filter: Dict[str, Any]
+    replacement: DocumentType
+    vector: Optional[VectorType]
+    vectorize: Optional[str]
+    sort: Optional[SortType]
+    upsert: bool
+
+    def __init__(
+        self,
+        filter: Dict[str, Any],
+        replacement: DocumentType,
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        upsert: bool = False,
+    ) -> None:
+        self.filter = filter
+        self.replacement = replacement
+        self.vector = vector
+        self.vectorize = vectorize
+        self.sort = sort
+        self.upsert = upsert
+
+    def execute(
+        self,
+        collection: Collection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: UpdateResult = collection.replace_one(
+            filter=self.filter,
+            replacement=self.replacement,
+            vector=self.vector,
+            vectorize=self.vectorize,
+            sort=self.sort,
+            upsert=self.upsert,
+            max_time_ms=bulk_write_timeout_ms,
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
+
+
+@dataclass
+class DeleteOne(BaseOperation):
+    """
+    Represents a `delete_one` operation on a (sync) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        filter: a filter condition to select a target document.
+        vector: a vector of numbers to use for ANN (vector-search) sorting.
+        vectorize: a string to be made into a vector, with the same result as the
+            `vector` attribute, through an embedding service, assuming one is
+            configured for the collection.
+            NOTE: This feature is under current development.
+        sort: controls ordering of results, hence which document is affected.
+    """
+
+    filter: Dict[str, Any]
+    vector: Optional[VectorType]
+    vectorize: Optional[str]
+    sort: Optional[SortType]
+
+    def __init__(
+        self,
+        filter: Dict[str, Any],
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+    ) -> None:
+        self.filter = filter
+        self.vector = vector
+        self.vectorize = vectorize
+        self.sort = sort
+
+    def execute(
+        self,
+        collection: Collection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: DeleteResult = collection.delete_one(
+            filter=self.filter,
+            vector=self.vector,
+            vectorize=self.vectorize,
+            sort=self.sort,
+            max_time_ms=bulk_write_timeout_ms,
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
+
+
+@dataclass
+class DeleteMany(BaseOperation):
+    """
+    Represents a `delete_many` operation on a (sync) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        filter: a filter condition to select target documents.
+    """
+
+    filter: Dict[str, Any]
+
+    def __init__(
+        self,
+        filter: Dict[str, Any],
+    ) -> None:
+        self.filter = filter
+
+    def execute(
+        self,
+        collection: Collection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: DeleteResult = collection.delete_many(
+            filter=self.filter, max_time_ms=bulk_write_timeout_ms
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
+
+
+class AsyncBaseOperation(ABC):
+    """
+    Base class for all operations amenable to be used
+    in bulk writes on (async) collections.
+    """
+
+    @abstractmethod
+    async def execute(
+        self,
+        collection: AsyncCollection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult: ...
+
+
+@dataclass
+class AsyncInsertOne(AsyncBaseOperation):
+    """
+    Represents an `insert_one` operation on a (async) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        document: the document to insert.
+        vector: an optional suitable vector to enrich the document at insertion.
+        vectorize: a string to be made into a vector, with the same result as the
+            `vector` attribute, through an embedding service, assuming one is
+            configured for the collection.
+            NOTE: This feature is under current development.
+    """
+
+    document: DocumentType
+    vector: Optional[VectorType]
+    vectorize: Optional[str]
+
+    def __init__(
+        self,
+        document: DocumentType,
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+    ) -> None:
+        self.document = document
+        self.vector = vector
+        self.vectorize = vectorize
+
+    async def execute(
+        self,
+        collection: AsyncCollection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: InsertOneResult = await collection.insert_one(
+            document=self.document,
+            vector=self.vector,
+            vectorize=self.vectorize,
+            max_time_ms=bulk_write_timeout_ms,
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
+
+
+@dataclass
+class AsyncInsertMany(AsyncBaseOperation):
+    """
+    Represents an `insert_many` operation on a (async) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        documents: the list document to insert.
+        vectors: an optional list of vectors to enrich the documents at insertion.
+        vectorize: an optional list of texts achieving the same effect as `vectors`
+            except through an embedding service, if one is configured for the collection.
+            NOTE: This feature is under current development.
+        ordered: whether the inserts should be done in sequence.
+        chunk_size: how many documents to include in a single API request.
+            Exceeding the server maximum allowed value results in an error.
+            Leave it unspecified (recommended) to use the system default.
+        concurrency: maximum number of concurrent requests to the API at
+            a given time. It cannot be more than one for ordered insertions.
+    """
+
+    documents: Iterable[DocumentType]
+    vectors: Optional[Iterable[Optional[VectorType]]]
+    vectorize: Optional[Iterable[Optional[str]]]
+    ordered: bool
+    chunk_size: Optional[int]
+    concurrency: Optional[int]
+
+    def __init__(
+        self,
+        documents: Iterable[DocumentType],
+        *,
+        vectors: Optional[Iterable[Optional[VectorType]]] = None,
+        vectorize: Optional[Iterable[Optional[str]]] = None,
+        ordered: bool = True,
+        chunk_size: Optional[int] = None,
+        concurrency: Optional[int] = None,
+    ) -> None:
+        self.documents = documents
+        self.vectors = vectors
+        self.vectorize = vectorize
+        self.ordered = ordered
+        self.chunk_size = chunk_size
+        self.concurrency = concurrency
+
+    async def execute(
+        self,
+        collection: AsyncCollection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: InsertManyResult = await collection.insert_many(
+            documents=self.documents,
+            vectors=self.vectors,
+            vectorize=self.vectorize,
+            ordered=self.ordered,
+            chunk_size=self.chunk_size,
+            concurrency=self.concurrency,
+            max_time_ms=bulk_write_timeout_ms,
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
+
+
+@dataclass
+class AsyncUpdateOne(AsyncBaseOperation):
+    """
+    Represents an `update_one` operation on a (async) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        filter: a filter condition to select a target document.
+        update: an update prescription to apply to the document.
+        vector: a vector of numbers to use for ANN (vector-search) sorting.
+        vectorize: a string to be made into a vector, with the same result as the
+            `vector` attribute, through an embedding service, assuming one is
+            configured for the collection.
+            NOTE: This feature is under current development.
+        sort: controls ordering of results, hence which document is affected.
+        upsert: controls what to do when no documents are found.
+    """
+
+    filter: Dict[str, Any]
+    update: Dict[str, Any]
+    vector: Optional[VectorType]
+    vectorize: Optional[str]
+    sort: Optional[SortType]
+    upsert: bool
+
+    def __init__(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        upsert: bool = False,
+    ) -> None:
+        self.filter = filter
+        self.update = update
+        self.vector = vector
+        self.vectorize = vectorize
+        self.sort = sort
+        self.upsert = upsert
+
+    async def execute(
+        self,
+        collection: AsyncCollection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: UpdateResult = await collection.update_one(
+            filter=self.filter,
+            update=self.update,
+            vector=self.vector,
+            vectorize=self.vectorize,
+            sort=self.sort,
+            upsert=self.upsert,
+            max_time_ms=bulk_write_timeout_ms,
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
+
+
+@dataclass
+class AsyncUpdateMany(AsyncBaseOperation):
+    """
+    Represents an `update_many` operation on a (async) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        filter: a filter condition to select target documents.
+        update: an update prescription to apply to the documents.
+        upsert: controls what to do when no documents are found.
+    """
+
+    filter: Dict[str, Any]
+    update: Dict[str, Any]
+    upsert: bool
+
+    def __init__(
+        self,
+        filter: Dict[str, Any],
+        update: Dict[str, Any],
+        *,
+        upsert: bool = False,
+    ) -> None:
+        self.filter = filter
+        self.update = update
+        self.upsert = upsert
+
+    async def execute(
+        self,
+        collection: AsyncCollection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: UpdateResult = await collection.update_many(
+            filter=self.filter,
+            update=self.update,
+            upsert=self.upsert,
+            max_time_ms=bulk_write_timeout_ms,
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
+
+
+@dataclass
+class AsyncReplaceOne(AsyncBaseOperation):
+    """
+    Represents a `replace_one` operation on a (async) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        filter: a filter condition to select a target document.
+        replacement: the replacement document.
+        vector: a vector of numbers to use for ANN (vector-search) sorting.
+        vectorize: a string to be made into a vector, with the same result as the
+            `vector` attribute, through an embedding service, assuming one is
+            configured for the collection.
+            NOTE: This feature is under current development.
+        sort: controls ordering of results, hence which document is affected.
+        upsert: controls what to do when no documents are found.
+    """
+
+    filter: Dict[str, Any]
+    replacement: DocumentType
+    vector: Optional[VectorType]
+    vectorize: Optional[str]
+    sort: Optional[SortType]
+    upsert: bool
+
+    def __init__(
+        self,
+        filter: Dict[str, Any],
+        replacement: DocumentType,
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+        upsert: bool = False,
+    ) -> None:
+        self.filter = filter
+        self.replacement = replacement
+        self.vector = vector
+        self.vectorize = vectorize
+        self.sort = sort
+        self.upsert = upsert
+
+    async def execute(
+        self,
+        collection: AsyncCollection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: UpdateResult = await collection.replace_one(
+            filter=self.filter,
+            replacement=self.replacement,
+            vector=self.vector,
+            vectorize=self.vectorize,
+            sort=self.sort,
+            upsert=self.upsert,
+            max_time_ms=bulk_write_timeout_ms,
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
+
+
+@dataclass
+class AsyncDeleteOne(AsyncBaseOperation):
+    """
+    Represents a `delete_one` operation on a (async) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        filter: a filter condition to select a target document.
+        vector: a vector of numbers to use for ANN (vector-search) sorting.
+        vectorize: a string to be made into a vector, with the same result as the
+            `vector` attribute, through an embedding service, assuming one is
+            configured for the collection.
+            NOTE: This feature is under current development.
+        sort: controls ordering of results, hence which document is affected.
+    """
+
+    filter: Dict[str, Any]
+    vector: Optional[VectorType]
+    vectorize: Optional[str]
+    sort: Optional[SortType]
+
+    def __init__(
+        self,
+        filter: Dict[str, Any],
+        *,
+        vector: Optional[VectorType] = None,
+        vectorize: Optional[str] = None,
+        sort: Optional[SortType] = None,
+    ) -> None:
+        self.filter = filter
+        self.vector = vector
+        self.vectorize = vectorize
+        self.sort = sort
+
+    async def execute(
+        self,
+        collection: AsyncCollection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: DeleteResult = await collection.delete_one(
+            filter=self.filter,
+            vector=self.vector,
+            vectorize=self.vectorize,
+            sort=self.sort,
+            max_time_ms=bulk_write_timeout_ms,
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
+
+
+@dataclass
+class AsyncDeleteMany(AsyncBaseOperation):
+    """
+    Represents a `delete_many` operation on a (async) collection.
+    See the documentation on the collection method for more information.
+
+    Attributes:
+        filter: a filter condition to select target documents.
+    """
+
+    filter: Dict[str, Any]
+
+    def __init__(
+        self,
+        filter: Dict[str, Any],
+    ) -> None:
+        self.filter = filter
+
+    async def execute(
+        self,
+        collection: AsyncCollection,
+        index_in_bulk_write: int,
+        bulk_write_timeout_ms: Optional[int],
+    ) -> BulkWriteResult:
+        """
+        Execute this operation against a collection as part of a bulk write.
+
+        Args:
+            collection: the collection this write targets.
+            insert_in_bulk_write: the index in the list of bulkoperations
+        """
+
+        op_result: DeleteResult = await collection.delete_many(
+            filter=self.filter, max_time_ms=bulk_write_timeout_ms
+        )
+        return op_result.to_bulk_write_result(index_in_bulk_write=index_in_bulk_write)
diff --git a/llm/Lib/site-packages/astrapy/ops/__init__.py b/llm/Lib/site-packages/astrapy/ops/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..05e524e1e874b46ab3314068dbdfc22b74c81e5a
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/ops/__init__.py
@@ -0,0 +1,22 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Core "ops" subpackage, exported here to preserve import patterns."""
+
+from astrapy.core.ops import AstraDBOps
+
+
+__all__ = [
+    "AstraDBOps",
+]
diff --git a/llm/Lib/site-packages/astrapy/ops/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/astrapy/ops/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..601b79bb5fe4e7d2f682c47da1194e4ee2918f18
Binary files /dev/null and b/llm/Lib/site-packages/astrapy/ops/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/astrapy/py.typed b/llm/Lib/site-packages/astrapy/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/astrapy/results.py b/llm/Lib/site-packages/astrapy/results.py
new file mode 100644
index 0000000000000000000000000000000000000000..7dc40b2b757cd0fd57db43251cc8c94c79f499e9
--- /dev/null
+++ b/llm/Lib/site-packages/astrapy/results.py
@@ -0,0 +1,192 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+
+from dataclasses import dataclass
+from typing import Any, Dict, List, Optional
+
+
+@dataclass
+class OperationResult(ABC):
+    """
+    Class that represents the generic result of a single mutation operation.
+
+    Attributes:
+        raw_results: response/responses from the Data API call.
+            Depending on the exact delete method being used, this
+            list of raw responses can contain exactly one or a number of items.
+    """
+
+    raw_results: List[Dict[str, Any]]
+
+    @abstractmethod
+    def to_bulk_write_result(self, index_in_bulk_write: int) -> BulkWriteResult: ...
+
+
+@dataclass
+class DeleteResult(OperationResult):
+    """
+    Class that represents the result of delete operations.
+
+    Attributes:
+        deleted_count: number of deleted documents
+        raw_results: response/responses from the Data API call.
+            Depending on the exact delete method being used, this
+            list of raw responses can contain exactly one or a number of items.
+    """
+
+    deleted_count: Optional[int]
+
+    def to_bulk_write_result(self, index_in_bulk_write: int) -> BulkWriteResult:
+        return BulkWriteResult(
+            bulk_api_results={index_in_bulk_write: self.raw_results},
+            deleted_count=self.deleted_count,
+            inserted_count=0,
+            matched_count=0,
+            modified_count=0,
+            upserted_count=0,
+            upserted_ids={},
+        )
+
+
+@dataclass
+class InsertOneResult(OperationResult):
+    """
+    Class that represents the result of insert_one operations.
+
+    Attributes:
+        raw_results: one-item list with the response from the Data API call
+        inserted_id: the ID of the inserted document
+    """
+
+    inserted_id: Any
+
+    def to_bulk_write_result(self, index_in_bulk_write: int) -> BulkWriteResult:
+        return BulkWriteResult(
+            bulk_api_results={index_in_bulk_write: self.raw_results},
+            deleted_count=0,
+            inserted_count=1,
+            matched_count=0,
+            modified_count=0,
+            upserted_count=0,
+            upserted_ids={},
+        )
+
+
+@dataclass
+class InsertManyResult(OperationResult):
+    """
+    Class that represents the result of insert_many operations.
+
+    Attributes:
+        raw_results: responses from the Data API calls
+        inserted_ids: list of the IDs of the inserted documents
+    """
+
+    inserted_ids: List[Any]
+
+    def to_bulk_write_result(self, index_in_bulk_write: int) -> BulkWriteResult:
+        return BulkWriteResult(
+            bulk_api_results={index_in_bulk_write: self.raw_results},
+            deleted_count=0,
+            inserted_count=len(self.inserted_ids),
+            matched_count=0,
+            modified_count=0,
+            upserted_count=0,
+            upserted_ids={},
+        )
+
+
+@dataclass
+class UpdateResult(OperationResult):
+    """
+    Class that represents the result of any update operation.
+
+    Attributes:
+        raw_results: responses from the Data API calls
+        update_info: a dictionary reporting about the update
+
+    Note:
+        the "update_info" field has the following fields: "n" (int),
+        "updatedExisting" (bool), "ok" (float), "nModified" (int)
+        and optionally "upserted" containing the ID of an upserted document.
+
+    """
+
+    update_info: Dict[str, Any]
+
+    def to_bulk_write_result(self, index_in_bulk_write: int) -> BulkWriteResult:
+        inserted_count = 1 if "upserted" in self.update_info else 0
+        matched_count = (self.update_info.get("n") or 0) - inserted_count
+        if "upserted" in self.update_info:
+            upserted_ids = {index_in_bulk_write: self.update_info["upserted"]}
+        else:
+            upserted_ids = {}
+        return BulkWriteResult(
+            bulk_api_results={index_in_bulk_write: self.raw_results},
+            deleted_count=0,
+            inserted_count=inserted_count,
+            matched_count=matched_count,
+            modified_count=self.update_info.get("nModified") or 0,
+            upserted_count=1 if "upserted" in self.update_info else 0,
+            upserted_ids=upserted_ids,
+        )
+
+
+@dataclass
+class BulkWriteResult:
+    """
+    Class that represents the result of a bulk write operations.
+
+    Indices in the maps below refer to the position of each write operation
+    in the list of operations passed to the bulk_write command.
+
+    The numeric counts refer to the whole of the bulk write.
+
+    Attributes:
+        bulk_api_results: a map from indices to the corresponding raw responses
+        deleted_count: number of deleted documents
+        inserted_count: number of inserted documents
+        matched_count: number of matched documents
+        modified_count: number of modified documents
+        upserted_count: number of upserted documents
+        upserted_ids: a (sparse) map from indices to ID of the upserted document
+    """
+
+    bulk_api_results: Dict[int, List[Dict[str, Any]]]
+    deleted_count: Optional[int]
+    inserted_count: int
+    matched_count: int
+    modified_count: int
+    upserted_count: int
+    upserted_ids: Dict[int, Any]
+
+    @staticmethod
+    def zero() -> BulkWriteResult:
+        """
+        Return an empty BulkWriteResult, for use in no-ops and list reductions.
+        """
+
+        return BulkWriteResult(
+            bulk_api_results={},
+            deleted_count=0,
+            inserted_count=0,
+            matched_count=0,
+            modified_count=0,
+            upserted_count=0,
+            upserted_ids={},
+        )
diff --git a/llm/Lib/site-packages/attr/__init__.py b/llm/Lib/site-packages/attr/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9226258a2d58777f1d5536c5695bbf1b4a635991
--- /dev/null
+++ b/llm/Lib/site-packages/attr/__init__.py
@@ -0,0 +1,134 @@
+# SPDX-License-Identifier: MIT
+
+"""
+Classes Without Boilerplate
+"""
+
+from functools import partial
+from typing import Callable
+
+from . import converters, exceptions, filters, setters, validators
+from ._cmp import cmp_using
+from ._compat import Protocol
+from ._config import get_run_validators, set_run_validators
+from ._funcs import asdict, assoc, astuple, evolve, has, resolve_types
+from ._make import (
+    NOTHING,
+    Attribute,
+    Factory,
+    attrib,
+    attrs,
+    fields,
+    fields_dict,
+    make_class,
+    validate,
+)
+from ._next_gen import define, field, frozen, mutable
+from ._version_info import VersionInfo
+
+
+s = attributes = attrs
+ib = attr = attrib
+dataclass = partial(attrs, auto_attribs=True)  # happy Easter ;)
+
+
+class AttrsInstance(Protocol):
+    pass
+
+
+__all__ = [
+    "Attribute",
+    "AttrsInstance",
+    "Factory",
+    "NOTHING",
+    "asdict",
+    "assoc",
+    "astuple",
+    "attr",
+    "attrib",
+    "attributes",
+    "attrs",
+    "cmp_using",
+    "converters",
+    "define",
+    "evolve",
+    "exceptions",
+    "field",
+    "fields",
+    "fields_dict",
+    "filters",
+    "frozen",
+    "get_run_validators",
+    "has",
+    "ib",
+    "make_class",
+    "mutable",
+    "resolve_types",
+    "s",
+    "set_run_validators",
+    "setters",
+    "validate",
+    "validators",
+]
+
+
+def _make_getattr(mod_name: str) -> Callable:
+    """
+    Create a metadata proxy for packaging information that uses *mod_name* in
+    its warnings and errors.
+    """
+
+    def __getattr__(name: str) -> str:
+        dunder_to_metadata = {
+            "__title__": "Name",
+            "__copyright__": "",
+            "__version__": "version",
+            "__version_info__": "version",
+            "__description__": "summary",
+            "__uri__": "",
+            "__url__": "",
+            "__author__": "",
+            "__email__": "",
+            "__license__": "license",
+        }
+        if name not in dunder_to_metadata:
+            msg = f"module {mod_name} has no attribute {name}"
+            raise AttributeError(msg)
+
+        import sys
+        import warnings
+
+        if sys.version_info < (3, 8):
+            from importlib_metadata import metadata
+        else:
+            from importlib.metadata import metadata
+
+        if name not in ("__version__", "__version_info__"):
+            warnings.warn(
+                f"Accessing {mod_name}.{name} is deprecated and will be "
+                "removed in a future release. Use importlib.metadata directly "
+                "to query for attrs's packaging metadata.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+
+        meta = metadata("attrs")
+        if name == "__license__":
+            return "MIT"
+        if name == "__copyright__":
+            return "Copyright (c) 2015 Hynek Schlawack"
+        if name in ("__uri__", "__url__"):
+            return meta["Project-URL"].split(" ", 1)[-1]
+        if name == "__version_info__":
+            return VersionInfo._from_version_string(meta["version"])
+        if name == "__author__":
+            return meta["Author-email"].rsplit(" ", 1)[0]
+        if name == "__email__":
+            return meta["Author-email"].rsplit("<", 1)[1][:-1]
+
+        return meta[dunder_to_metadata[name]]
+
+    return __getattr__
+
+
+__getattr__ = _make_getattr(__name__)
diff --git a/llm/Lib/site-packages/attr/__init__.pyi b/llm/Lib/site-packages/attr/__init__.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..37a208732acf774ed369811d51f1393798f22148
--- /dev/null
+++ b/llm/Lib/site-packages/attr/__init__.pyi
@@ -0,0 +1,555 @@
+import enum
+import sys
+
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Generic,
+    List,
+    Mapping,
+    Optional,
+    Protocol,
+    Sequence,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    overload,
+)
+
+# `import X as X` is required to make these public
+from . import converters as converters
+from . import exceptions as exceptions
+from . import filters as filters
+from . import setters as setters
+from . import validators as validators
+from ._cmp import cmp_using as cmp_using
+from ._typing_compat import AttrsInstance_
+from ._version_info import VersionInfo
+
+if sys.version_info >= (3, 10):
+    from typing import TypeGuard
+else:
+    from typing_extensions import TypeGuard
+
+if sys.version_info >= (3, 11):
+    from typing import dataclass_transform
+else:
+    from typing_extensions import dataclass_transform
+
+__version__: str
+__version_info__: VersionInfo
+__title__: str
+__description__: str
+__url__: str
+__uri__: str
+__author__: str
+__email__: str
+__license__: str
+__copyright__: str
+
+_T = TypeVar("_T")
+_C = TypeVar("_C", bound=type)
+
+_EqOrderType = Union[bool, Callable[[Any], Any]]
+_ValidatorType = Callable[[Any, "Attribute[_T]", _T], Any]
+_ConverterType = Callable[[Any], Any]
+_FilterType = Callable[["Attribute[_T]", _T], bool]
+_ReprType = Callable[[Any], str]
+_ReprArgType = Union[bool, _ReprType]
+_OnSetAttrType = Callable[[Any, "Attribute[Any]", Any], Any]
+_OnSetAttrArgType = Union[
+    _OnSetAttrType, List[_OnSetAttrType], setters._NoOpType
+]
+_FieldTransformer = Callable[
+    [type, List["Attribute[Any]"]], List["Attribute[Any]"]
+]
+# FIXME: in reality, if multiple validators are passed they must be in a list
+# or tuple, but those are invariant and so would prevent subtypes of
+# _ValidatorType from working when passed in a list or tuple.
+_ValidatorArgType = Union[_ValidatorType[_T], Sequence[_ValidatorType[_T]]]
+
+# We subclass this here to keep the protocol's qualified name clean.
+class AttrsInstance(AttrsInstance_, Protocol):
+    pass
+
+_A = TypeVar("_A", bound=type[AttrsInstance])
+
+class _Nothing(enum.Enum):
+    NOTHING = enum.auto()
+
+NOTHING = _Nothing.NOTHING
+
+# NOTE: Factory lies about its return type to make this possible:
+# `x: List[int] # = Factory(list)`
+# Work around mypy issue #4554 in the common case by using an overload.
+if sys.version_info >= (3, 8):
+    from typing import Literal
+    @overload
+    def Factory(factory: Callable[[], _T]) -> _T: ...
+    @overload
+    def Factory(
+        factory: Callable[[Any], _T],
+        takes_self: Literal[True],
+    ) -> _T: ...
+    @overload
+    def Factory(
+        factory: Callable[[], _T],
+        takes_self: Literal[False],
+    ) -> _T: ...
+
+else:
+    @overload
+    def Factory(factory: Callable[[], _T]) -> _T: ...
+    @overload
+    def Factory(
+        factory: Union[Callable[[Any], _T], Callable[[], _T]],
+        takes_self: bool = ...,
+    ) -> _T: ...
+
+class Attribute(Generic[_T]):
+    name: str
+    default: Optional[_T]
+    validator: Optional[_ValidatorType[_T]]
+    repr: _ReprArgType
+    cmp: _EqOrderType
+    eq: _EqOrderType
+    order: _EqOrderType
+    hash: Optional[bool]
+    init: bool
+    converter: Optional[_ConverterType]
+    metadata: Dict[Any, Any]
+    type: Optional[Type[_T]]
+    kw_only: bool
+    on_setattr: _OnSetAttrType
+    alias: Optional[str]
+
+    def evolve(self, **changes: Any) -> "Attribute[Any]": ...
+
+# NOTE: We had several choices for the annotation to use for type arg:
+# 1) Type[_T]
+#   - Pros: Handles simple cases correctly
+#   - Cons: Might produce less informative errors in the case of conflicting
+#     TypeVars e.g. `attr.ib(default='bad', type=int)`
+# 2) Callable[..., _T]
+#   - Pros: Better error messages than #1 for conflicting TypeVars
+#   - Cons: Terrible error messages for validator checks.
+#   e.g. attr.ib(type=int, validator=validate_str)
+#        -> error: Cannot infer function type argument
+# 3) type (and do all of the work in the mypy plugin)
+#   - Pros: Simple here, and we could customize the plugin with our own errors.
+#   - Cons: Would need to write mypy plugin code to handle all the cases.
+# We chose option #1.
+
+# `attr` lies about its return type to make the following possible:
+#     attr()    -> Any
+#     attr(8)   -> int
+#     attr(validator=<some callable>)  -> Whatever the callable expects.
+# This makes this type of assignments possible:
+#     x: int = attr(8)
+#
+# This form catches explicit None or no default but with no other arguments
+# returns Any.
+@overload
+def attrib(
+    default: None = ...,
+    validator: None = ...,
+    repr: _ReprArgType = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    type: None = ...,
+    converter: None = ...,
+    factory: None = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    alias: Optional[str] = ...,
+) -> Any: ...
+
+# This form catches an explicit None or no default and infers the type from the
+# other arguments.
+@overload
+def attrib(
+    default: None = ...,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    type: Optional[Type[_T]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    alias: Optional[str] = ...,
+) -> _T: ...
+
+# This form catches an explicit default argument.
+@overload
+def attrib(
+    default: _T,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    type: Optional[Type[_T]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    alias: Optional[str] = ...,
+) -> _T: ...
+
+# This form covers type=non-Type: e.g. forward references (str), Any
+@overload
+def attrib(
+    default: Optional[_T] = ...,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    type: object = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    alias: Optional[str] = ...,
+) -> Any: ...
+@overload
+def field(
+    *,
+    default: None = ...,
+    validator: None = ...,
+    repr: _ReprArgType = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    converter: None = ...,
+    factory: None = ...,
+    kw_only: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    alias: Optional[str] = ...,
+    type: Optional[type] = ...,
+) -> Any: ...
+
+# This form catches an explicit None or no default and infers the type from the
+# other arguments.
+@overload
+def field(
+    *,
+    default: None = ...,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    alias: Optional[str] = ...,
+    type: Optional[type] = ...,
+) -> _T: ...
+
+# This form catches an explicit default argument.
+@overload
+def field(
+    *,
+    default: _T,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    alias: Optional[str] = ...,
+    type: Optional[type] = ...,
+) -> _T: ...
+
+# This form covers type=non-Type: e.g. forward references (str), Any
+@overload
+def field(
+    *,
+    default: Optional[_T] = ...,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    alias: Optional[str] = ...,
+    type: Optional[type] = ...,
+) -> Any: ...
+@overload
+@dataclass_transform(order_default=True, field_specifiers=(attrib, field))
+def attrs(
+    maybe_cls: _C,
+    these: Optional[Dict[str, Any]] = ...,
+    repr_ns: Optional[str] = ...,
+    repr: bool = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    auto_detect: bool = ...,
+    collect_by_mro: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+    match_args: bool = ...,
+    unsafe_hash: Optional[bool] = ...,
+) -> _C: ...
+@overload
+@dataclass_transform(order_default=True, field_specifiers=(attrib, field))
+def attrs(
+    maybe_cls: None = ...,
+    these: Optional[Dict[str, Any]] = ...,
+    repr_ns: Optional[str] = ...,
+    repr: bool = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    auto_detect: bool = ...,
+    collect_by_mro: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+    match_args: bool = ...,
+    unsafe_hash: Optional[bool] = ...,
+) -> Callable[[_C], _C]: ...
+@overload
+@dataclass_transform(field_specifiers=(attrib, field))
+def define(
+    maybe_cls: _C,
+    *,
+    these: Optional[Dict[str, Any]] = ...,
+    repr: bool = ...,
+    unsafe_hash: Optional[bool] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    auto_detect: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+    match_args: bool = ...,
+) -> _C: ...
+@overload
+@dataclass_transform(field_specifiers=(attrib, field))
+def define(
+    maybe_cls: None = ...,
+    *,
+    these: Optional[Dict[str, Any]] = ...,
+    repr: bool = ...,
+    unsafe_hash: Optional[bool] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    auto_detect: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+    match_args: bool = ...,
+) -> Callable[[_C], _C]: ...
+
+mutable = define
+
+@overload
+@dataclass_transform(frozen_default=True, field_specifiers=(attrib, field))
+def frozen(
+    maybe_cls: _C,
+    *,
+    these: Optional[Dict[str, Any]] = ...,
+    repr: bool = ...,
+    unsafe_hash: Optional[bool] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    auto_detect: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+    match_args: bool = ...,
+) -> _C: ...
+@overload
+@dataclass_transform(frozen_default=True, field_specifiers=(attrib, field))
+def frozen(
+    maybe_cls: None = ...,
+    *,
+    these: Optional[Dict[str, Any]] = ...,
+    repr: bool = ...,
+    unsafe_hash: Optional[bool] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    auto_detect: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+    match_args: bool = ...,
+) -> Callable[[_C], _C]: ...
+def fields(cls: Type[AttrsInstance]) -> Any: ...
+def fields_dict(cls: Type[AttrsInstance]) -> Dict[str, Attribute[Any]]: ...
+def validate(inst: AttrsInstance) -> None: ...
+def resolve_types(
+    cls: _A,
+    globalns: Optional[Dict[str, Any]] = ...,
+    localns: Optional[Dict[str, Any]] = ...,
+    attribs: Optional[List[Attribute[Any]]] = ...,
+    include_extras: bool = ...,
+) -> _A: ...
+
+# TODO: add support for returning a proper attrs class from the mypy plugin
+# we use Any instead of _CountingAttr so that e.g. `make_class('Foo',
+# [attr.ib()])` is valid
+def make_class(
+    name: str,
+    attrs: Union[List[str], Tuple[str, ...], Dict[str, Any]],
+    bases: Tuple[type, ...] = ...,
+    class_body: Optional[Dict[str, Any]] = ...,
+    repr_ns: Optional[str] = ...,
+    repr: bool = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    collect_by_mro: bool = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+) -> type: ...
+
+# _funcs --
+
+# TODO: add support for returning TypedDict from the mypy plugin
+# FIXME: asdict/astuple do not honor their factory args. Waiting on one of
+# these:
+# https://github.com/python/mypy/issues/4236
+# https://github.com/python/typing/issues/253
+# XXX: remember to fix attrs.asdict/astuple too!
+def asdict(
+    inst: AttrsInstance,
+    recurse: bool = ...,
+    filter: Optional[_FilterType[Any]] = ...,
+    dict_factory: Type[Mapping[Any, Any]] = ...,
+    retain_collection_types: bool = ...,
+    value_serializer: Optional[
+        Callable[[type, Attribute[Any], Any], Any]
+    ] = ...,
+    tuple_keys: Optional[bool] = ...,
+) -> Dict[str, Any]: ...
+
+# TODO: add support for returning NamedTuple from the mypy plugin
+def astuple(
+    inst: AttrsInstance,
+    recurse: bool = ...,
+    filter: Optional[_FilterType[Any]] = ...,
+    tuple_factory: Type[Sequence[Any]] = ...,
+    retain_collection_types: bool = ...,
+) -> Tuple[Any, ...]: ...
+def has(cls: type) -> TypeGuard[Type[AttrsInstance]]: ...
+def assoc(inst: _T, **changes: Any) -> _T: ...
+def evolve(inst: _T, **changes: Any) -> _T: ...
+
+# _config --
+
+def set_run_validators(run: bool) -> None: ...
+def get_run_validators() -> bool: ...
+
+# aliases --
+
+s = attributes = attrs
+ib = attr = attrib
+dataclass = attrs  # Technically, partial(attrs, auto_attribs=True) ;)
diff --git a/llm/Lib/site-packages/attr/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/attr/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..65b0af5575706495beaf42a3f5577c9ac5f9da8d
Binary files /dev/null and b/llm/Lib/site-packages/attr/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attr/__pycache__/_cmp.cpython-311.pyc b/llm/Lib/site-packages/attr/__pycache__/_cmp.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..626b475c1742212341b04402cd0653acd2c4d4f5
Binary files /dev/null and b/llm/Lib/site-packages/attr/__pycache__/_cmp.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attr/__pycache__/_compat.cpython-311.pyc b/llm/Lib/site-packages/attr/__pycache__/_compat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fe142429de63231bd818738cb8971d83d9f140c1
Binary files /dev/null and b/llm/Lib/site-packages/attr/__pycache__/_compat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attr/__pycache__/_config.cpython-311.pyc b/llm/Lib/site-packages/attr/__pycache__/_config.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..037334890f9d0a7ff1e9c69788ffa5df575ca272
Binary files /dev/null and b/llm/Lib/site-packages/attr/__pycache__/_config.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attr/__pycache__/_funcs.cpython-311.pyc b/llm/Lib/site-packages/attr/__pycache__/_funcs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c26e3e09f63a6d459ff00c2330004c627b7b9662
Binary files /dev/null and b/llm/Lib/site-packages/attr/__pycache__/_funcs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attr/__pycache__/_make.cpython-311.pyc b/llm/Lib/site-packages/attr/__pycache__/_make.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..86a4c9157d4f22c1f346c309eac548118099239a
Binary files /dev/null and b/llm/Lib/site-packages/attr/__pycache__/_make.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attr/__pycache__/_next_gen.cpython-311.pyc b/llm/Lib/site-packages/attr/__pycache__/_next_gen.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..70b20added0c0551c07d0a06ec56e03d4158a3aa
Binary files /dev/null and b/llm/Lib/site-packages/attr/__pycache__/_next_gen.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attr/__pycache__/_version_info.cpython-311.pyc b/llm/Lib/site-packages/attr/__pycache__/_version_info.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fdb6a05d63891b8000afeff61ba2e0bd04cbdec7
Binary files /dev/null and b/llm/Lib/site-packages/attr/__pycache__/_version_info.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attr/__pycache__/converters.cpython-311.pyc b/llm/Lib/site-packages/attr/__pycache__/converters.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..67810ab9288a9170bae0db73aa30a27f8889c3aa
Binary files /dev/null and b/llm/Lib/site-packages/attr/__pycache__/converters.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attr/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/attr/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ad7facad299844a076dd6dec92f00d8fe6bd5c8a
Binary files /dev/null and b/llm/Lib/site-packages/attr/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attr/__pycache__/filters.cpython-311.pyc b/llm/Lib/site-packages/attr/__pycache__/filters.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..04f21c0d4abfef66883249928681cb0b0feb80c7
Binary files /dev/null and b/llm/Lib/site-packages/attr/__pycache__/filters.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attr/__pycache__/setters.cpython-311.pyc b/llm/Lib/site-packages/attr/__pycache__/setters.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7851bafcd46fa425d149869cdd4e70b97e2d0014
Binary files /dev/null and b/llm/Lib/site-packages/attr/__pycache__/setters.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attr/__pycache__/validators.cpython-311.pyc b/llm/Lib/site-packages/attr/__pycache__/validators.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..249ec4899775bad8c7fbabe7dcc22388d0ed3345
Binary files /dev/null and b/llm/Lib/site-packages/attr/__pycache__/validators.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attr/_cmp.py b/llm/Lib/site-packages/attr/_cmp.py
new file mode 100644
index 0000000000000000000000000000000000000000..a4a35e08fc9d9b078a11edc3236d7e27027cd28e
--- /dev/null
+++ b/llm/Lib/site-packages/attr/_cmp.py
@@ -0,0 +1,150 @@
+# SPDX-License-Identifier: MIT
+
+
+import functools
+import types
+
+from ._make import _make_ne
+
+
+_operation_names = {"eq": "==", "lt": "<", "le": "<=", "gt": ">", "ge": ">="}
+
+
+def cmp_using(
+    eq=None,
+    lt=None,
+    le=None,
+    gt=None,
+    ge=None,
+    require_same_type=True,
+    class_name="Comparable",
+):
+    """
+    Create a class that can be passed into `attrs.field`'s ``eq``, ``order``,
+    and ``cmp`` arguments to customize field comparison.
+
+    The resulting class will have a full set of ordering methods if at least
+    one of ``{lt, le, gt, ge}`` and ``eq``  are provided.
+
+    :param Optional[callable] eq: `callable` used to evaluate equality of two
+        objects.
+    :param Optional[callable] lt: `callable` used to evaluate whether one
+        object is less than another object.
+    :param Optional[callable] le: `callable` used to evaluate whether one
+        object is less than or equal to another object.
+    :param Optional[callable] gt: `callable` used to evaluate whether one
+        object is greater than another object.
+    :param Optional[callable] ge: `callable` used to evaluate whether one
+        object is greater than or equal to another object.
+
+    :param bool require_same_type: When `True`, equality and ordering methods
+        will return `NotImplemented` if objects are not of the same type.
+
+    :param Optional[str] class_name: Name of class. Defaults to 'Comparable'.
+
+    See `comparison` for more details.
+
+    .. versionadded:: 21.1.0
+    """
+
+    body = {
+        "__slots__": ["value"],
+        "__init__": _make_init(),
+        "_requirements": [],
+        "_is_comparable_to": _is_comparable_to,
+    }
+
+    # Add operations.
+    num_order_functions = 0
+    has_eq_function = False
+
+    if eq is not None:
+        has_eq_function = True
+        body["__eq__"] = _make_operator("eq", eq)
+        body["__ne__"] = _make_ne()
+
+    if lt is not None:
+        num_order_functions += 1
+        body["__lt__"] = _make_operator("lt", lt)
+
+    if le is not None:
+        num_order_functions += 1
+        body["__le__"] = _make_operator("le", le)
+
+    if gt is not None:
+        num_order_functions += 1
+        body["__gt__"] = _make_operator("gt", gt)
+
+    if ge is not None:
+        num_order_functions += 1
+        body["__ge__"] = _make_operator("ge", ge)
+
+    type_ = types.new_class(
+        class_name, (object,), {}, lambda ns: ns.update(body)
+    )
+
+    # Add same type requirement.
+    if require_same_type:
+        type_._requirements.append(_check_same_type)
+
+    # Add total ordering if at least one operation was defined.
+    if 0 < num_order_functions < 4:
+        if not has_eq_function:
+            # functools.total_ordering requires __eq__ to be defined,
+            # so raise early error here to keep a nice stack.
+            msg = "eq must be define is order to complete ordering from lt, le, gt, ge."
+            raise ValueError(msg)
+        type_ = functools.total_ordering(type_)
+
+    return type_
+
+
+def _make_init():
+    """
+    Create __init__ method.
+    """
+
+    def __init__(self, value):
+        """
+        Initialize object with *value*.
+        """
+        self.value = value
+
+    return __init__
+
+
+def _make_operator(name, func):
+    """
+    Create operator method.
+    """
+
+    def method(self, other):
+        if not self._is_comparable_to(other):
+            return NotImplemented
+
+        result = func(self.value, other.value)
+        if result is NotImplemented:
+            return NotImplemented
+
+        return result
+
+    method.__name__ = f"__{name}__"
+    method.__doc__ = (
+        f"Return a {_operation_names[name]} b.  Computed by attrs."
+    )
+
+    return method
+
+
+def _is_comparable_to(self, other):
+    """
+    Check whether `other` is comparable to `self`.
+    """
+    return all(func(self, other) for func in self._requirements)
+
+
+def _check_same_type(self, other):
+    """
+    Return True if *self* and *other* are of the same type, False otherwise.
+    """
+    return other.value.__class__ is self.value.__class__
diff --git a/llm/Lib/site-packages/attr/_cmp.pyi b/llm/Lib/site-packages/attr/_cmp.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..f3dcdc1a754146303b28009cbff9ec9bf960e450
--- /dev/null
+++ b/llm/Lib/site-packages/attr/_cmp.pyi
@@ -0,0 +1,13 @@
+from typing import Any, Callable, Optional, Type
+
+_CompareWithType = Callable[[Any, Any], bool]
+
+def cmp_using(
+    eq: Optional[_CompareWithType] = ...,
+    lt: Optional[_CompareWithType] = ...,
+    le: Optional[_CompareWithType] = ...,
+    gt: Optional[_CompareWithType] = ...,
+    ge: Optional[_CompareWithType] = ...,
+    require_same_type: bool = ...,
+    class_name: str = ...,
+) -> Type: ...
diff --git a/llm/Lib/site-packages/attr/_compat.py b/llm/Lib/site-packages/attr/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..46b05ca453773da7f2972f023c4a4f447b44e824
--- /dev/null
+++ b/llm/Lib/site-packages/attr/_compat.py
@@ -0,0 +1,87 @@
+# SPDX-License-Identifier: MIT
+
+import inspect
+import platform
+import sys
+import threading
+
+from collections.abc import Mapping, Sequence  # noqa: F401
+from typing import _GenericAlias
+
+
+PYPY = platform.python_implementation() == "PyPy"
+PY_3_8_PLUS = sys.version_info[:2] >= (3, 8)
+PY_3_9_PLUS = sys.version_info[:2] >= (3, 9)
+PY310 = sys.version_info[:2] >= (3, 10)
+PY_3_12_PLUS = sys.version_info[:2] >= (3, 12)
+
+
+if sys.version_info < (3, 8):
+    try:
+        from typing_extensions import Protocol
+    except ImportError:  # pragma: no cover
+        Protocol = object
+else:
+    from typing import Protocol  # noqa: F401
+
+
+class _AnnotationExtractor:
+    """
+    Extract type annotations from a callable, returning None whenever there
+    is none.
+    """
+
+    __slots__ = ["sig"]
+
+    def __init__(self, callable):
+        try:
+            self.sig = inspect.signature(callable)
+        except (ValueError, TypeError):  # inspect failed
+            self.sig = None
+
+    def get_first_param_type(self):
+        """
+        Return the type annotation of the first argument if it's not empty.
+        """
+        if not self.sig:
+            return None
+
+        params = list(self.sig.parameters.values())
+        if params and params[0].annotation is not inspect.Parameter.empty:
+            return params[0].annotation
+
+        return None
+
+    def get_return_type(self):
+        """
+        Return the return type if it's not empty.
+        """
+        if (
+            self.sig
+            and self.sig.return_annotation is not inspect.Signature.empty
+        ):
+            return self.sig.return_annotation
+
+        return None
+
+
+# Thread-local global to track attrs instances which are already being repr'd.
+# This is needed because there is no other (thread-safe) way to pass info
+# about the instances that are already being repr'd through the call stack
+# in order to ensure we don't perform infinite recursion.
+#
+# For instance, if an instance contains a dict which contains that instance,
+# we need to know that we're already repr'ing the outside instance from within
+# the dict's repr() call.
+#
+# This lives here rather than in _make.py so that the functions in _make.py
+# don't have a direct reference to the thread-local in their globals dict.
+# If they have such a reference, it breaks cloudpickle.
+repr_context = threading.local()
+
+
+def get_generic_base(cl):
+    """If this is a generic class (A[str]), return the generic base for it."""
+    if cl.__class__ is _GenericAlias:
+        return cl.__origin__
+    return None
diff --git a/llm/Lib/site-packages/attr/_config.py b/llm/Lib/site-packages/attr/_config.py
new file mode 100644
index 0000000000000000000000000000000000000000..9c245b1461abd5dc5143f69bc74c75ae50fabdc5
--- /dev/null
+++ b/llm/Lib/site-packages/attr/_config.py
@@ -0,0 +1,31 @@
+# SPDX-License-Identifier: MIT
+
+__all__ = ["set_run_validators", "get_run_validators"]
+
+_run_validators = True
+
+
+def set_run_validators(run):
+    """
+    Set whether or not validators are run.  By default, they are run.
+
+    .. deprecated:: 21.3.0 It will not be removed, but it also will not be
+        moved to new ``attrs`` namespace. Use `attrs.validators.set_disabled()`
+        instead.
+    """
+    if not isinstance(run, bool):
+        msg = "'run' must be bool."
+        raise TypeError(msg)
+    global _run_validators
+    _run_validators = run
+
+
+def get_run_validators():
+    """
+    Return whether or not validators are run.
+
+    .. deprecated:: 21.3.0 It will not be removed, but it also will not be
+        moved to new ``attrs`` namespace. Use `attrs.validators.get_disabled()`
+        instead.
+    """
+    return _run_validators
diff --git a/llm/Lib/site-packages/attr/_funcs.py b/llm/Lib/site-packages/attr/_funcs.py
new file mode 100644
index 0000000000000000000000000000000000000000..a888991d98fdac72abb6e5ce8ac6d620a8f0e54b
--- /dev/null
+++ b/llm/Lib/site-packages/attr/_funcs.py
@@ -0,0 +1,483 @@
+# SPDX-License-Identifier: MIT
+
+
+import copy
+
+from ._compat import PY_3_9_PLUS, get_generic_base
+from ._make import NOTHING, _obj_setattr, fields
+from .exceptions import AttrsAttributeNotFoundError
+
+
+def asdict(
+    inst,
+    recurse=True,
+    filter=None,
+    dict_factory=dict,
+    retain_collection_types=False,
+    value_serializer=None,
+):
+    """
+    Return the *attrs* attribute values of *inst* as a dict.
+
+    Optionally recurse into other *attrs*-decorated classes.
+
+    :param inst: Instance of an *attrs*-decorated class.
+    :param bool recurse: Recurse into classes that are also
+        *attrs*-decorated.
+    :param callable filter: A callable whose return code determines whether an
+        attribute or element is included (``True``) or dropped (``False``).  Is
+        called with the `attrs.Attribute` as the first argument and the
+        value as the second argument.
+    :param callable dict_factory: A callable to produce dictionaries from.  For
+        example, to produce ordered dictionaries instead of normal Python
+        dictionaries, pass in ``collections.OrderedDict``.
+    :param bool retain_collection_types: Do not convert to ``list`` when
+        encountering an attribute whose type is ``tuple`` or ``set``.  Only
+        meaningful if ``recurse`` is ``True``.
+    :param Optional[callable] value_serializer: A hook that is called for every
+        attribute or dict key/value.  It receives the current instance, field
+        and value and must return the (updated) value.  The hook is run *after*
+        the optional *filter* has been applied.
+
+    :rtype: return type of *dict_factory*
+
+    :raise attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs*
+        class.
+
+    ..  versionadded:: 16.0.0 *dict_factory*
+    ..  versionadded:: 16.1.0 *retain_collection_types*
+    ..  versionadded:: 20.3.0 *value_serializer*
+    ..  versionadded:: 21.3.0 If a dict has a collection for a key, it is
+        serialized as a tuple.
+    """
+    attrs = fields(inst.__class__)
+    rv = dict_factory()
+    for a in attrs:
+        v = getattr(inst, a.name)
+        if filter is not None and not filter(a, v):
+            continue
+
+        if value_serializer is not None:
+            v = value_serializer(inst, a, v)
+
+        if recurse is True:
+            if has(v.__class__):
+                rv[a.name] = asdict(
+                    v,
+                    recurse=True,
+                    filter=filter,
+                    dict_factory=dict_factory,
+                    retain_collection_types=retain_collection_types,
+                    value_serializer=value_serializer,
+                )
+            elif isinstance(v, (tuple, list, set, frozenset)):
+                cf = v.__class__ if retain_collection_types is True else list
+                items = [
+                    _asdict_anything(
+                        i,
+                        is_key=False,
+                        filter=filter,
+                        dict_factory=dict_factory,
+                        retain_collection_types=retain_collection_types,
+                        value_serializer=value_serializer,
+                    )
+                    for i in v
+                ]
+                try:
+                    rv[a.name] = cf(items)
+                except TypeError:
+                    if not issubclass(cf, tuple):
+                        raise
+                    # Workaround for TypeError: cf.__new__() missing 1 required
+                    # positional argument (which appears, for a namedturle)
+                    rv[a.name] = cf(*items)
+            elif isinstance(v, dict):
+                df = dict_factory
+                rv[a.name] = df(
+                    (
+                        _asdict_anything(
+                            kk,
+                            is_key=True,
+                            filter=filter,
+                            dict_factory=df,
+                            retain_collection_types=retain_collection_types,
+                            value_serializer=value_serializer,
+                        ),
+                        _asdict_anything(
+                            vv,
+                            is_key=False,
+                            filter=filter,
+                            dict_factory=df,
+                            retain_collection_types=retain_collection_types,
+                            value_serializer=value_serializer,
+                        ),
+                    )
+                    for kk, vv in v.items()
+                )
+            else:
+                rv[a.name] = v
+        else:
+            rv[a.name] = v
+    return rv
+
+
+def _asdict_anything(
+    val,
+    is_key,
+    filter,
+    dict_factory,
+    retain_collection_types,
+    value_serializer,
+):
+    """
+    ``asdict`` only works on attrs instances, this works on anything.
+    """
+    if getattr(val.__class__, "__attrs_attrs__", None) is not None:
+        # Attrs class.
+        rv = asdict(
+            val,
+            recurse=True,
+            filter=filter,
+            dict_factory=dict_factory,
+            retain_collection_types=retain_collection_types,
+            value_serializer=value_serializer,
+        )
+    elif isinstance(val, (tuple, list, set, frozenset)):
+        if retain_collection_types is True:
+            cf = val.__class__
+        elif is_key:
+            cf = tuple
+        else:
+            cf = list
+
+        rv = cf(
+            [
+                _asdict_anything(
+                    i,
+                    is_key=False,
+                    filter=filter,
+                    dict_factory=dict_factory,
+                    retain_collection_types=retain_collection_types,
+                    value_serializer=value_serializer,
+                )
+                for i in val
+            ]
+        )
+    elif isinstance(val, dict):
+        df = dict_factory
+        rv = df(
+            (
+                _asdict_anything(
+                    kk,
+                    is_key=True,
+                    filter=filter,
+                    dict_factory=df,
+                    retain_collection_types=retain_collection_types,
+                    value_serializer=value_serializer,
+                ),
+                _asdict_anything(
+                    vv,
+                    is_key=False,
+                    filter=filter,
+                    dict_factory=df,
+                    retain_collection_types=retain_collection_types,
+                    value_serializer=value_serializer,
+                ),
+            )
+            for kk, vv in val.items()
+        )
+    else:
+        rv = val
+        if value_serializer is not None:
+            rv = value_serializer(None, None, rv)
+
+    return rv
+
+
+def astuple(
+    inst,
+    recurse=True,
+    filter=None,
+    tuple_factory=tuple,
+    retain_collection_types=False,
+):
+    """
+    Return the *attrs* attribute values of *inst* as a tuple.
+
+    Optionally recurse into other *attrs*-decorated classes.
+
+    :param inst: Instance of an *attrs*-decorated class.
+    :param bool recurse: Recurse into classes that are also
+        *attrs*-decorated.
+    :param callable filter: A callable whose return code determines whether an
+        attribute or element is included (``True``) or dropped (``False``).  Is
+        called with the `attrs.Attribute` as the first argument and the
+        value as the second argument.
+    :param callable tuple_factory: A callable to produce tuples from.  For
+        example, to produce lists instead of tuples.
+    :param bool retain_collection_types: Do not convert to ``list``
+        or ``dict`` when encountering an attribute which type is
+        ``tuple``, ``dict`` or ``set``.  Only meaningful if ``recurse`` is
+        ``True``.
+
+    :rtype: return type of *tuple_factory*
+
+    :raise attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs*
+        class.
+
+    ..  versionadded:: 16.2.0
+    """
+    attrs = fields(inst.__class__)
+    rv = []
+    retain = retain_collection_types  # Very long. :/
+    for a in attrs:
+        v = getattr(inst, a.name)
+        if filter is not None and not filter(a, v):
+            continue
+        if recurse is True:
+            if has(v.__class__):
+                rv.append(
+                    astuple(
+                        v,
+                        recurse=True,
+                        filter=filter,
+                        tuple_factory=tuple_factory,
+                        retain_collection_types=retain,
+                    )
+                )
+            elif isinstance(v, (tuple, list, set, frozenset)):
+                cf = v.__class__ if retain is True else list
+                items = [
+                    astuple(
+                        j,
+                        recurse=True,
+                        filter=filter,
+                        tuple_factory=tuple_factory,
+                        retain_collection_types=retain,
+                    )
+                    if has(j.__class__)
+                    else j
+                    for j in v
+                ]
+                try:
+                    rv.append(cf(items))
+                except TypeError:
+                    if not issubclass(cf, tuple):
+                        raise
+                    # Workaround for TypeError: cf.__new__() missing 1 required
+                    # positional argument (which appears, for a namedturle)
+                    rv.append(cf(*items))
+            elif isinstance(v, dict):
+                df = v.__class__ if retain is True else dict
+                rv.append(
+                    df(
+                        (
+                            astuple(
+                                kk,
+                                tuple_factory=tuple_factory,
+                                retain_collection_types=retain,
+                            )
+                            if has(kk.__class__)
+                            else kk,
+                            astuple(
+                                vv,
+                                tuple_factory=tuple_factory,
+                                retain_collection_types=retain,
+                            )
+                            if has(vv.__class__)
+                            else vv,
+                        )
+                        for kk, vv in v.items()
+                    )
+                )
+            else:
+                rv.append(v)
+        else:
+            rv.append(v)
+
+    return rv if tuple_factory is list else tuple_factory(rv)
+
+
+def has(cls):
+    """
+    Check whether *cls* is a class with *attrs* attributes.
+
+    :param type cls: Class to introspect.
+    :raise TypeError: If *cls* is not a class.
+
+    :rtype: bool
+    """
+    attrs = getattr(cls, "__attrs_attrs__", None)
+    if attrs is not None:
+        return True
+
+    # No attrs, maybe it's a specialized generic (A[str])?
+    generic_base = get_generic_base(cls)
+    if generic_base is not None:
+        generic_attrs = getattr(generic_base, "__attrs_attrs__", None)
+        if generic_attrs is not None:
+            # Stick it on here for speed next time.
+            cls.__attrs_attrs__ = generic_attrs
+        return generic_attrs is not None
+    return False
+
+
+def assoc(inst, **changes):
+    """
+    Copy *inst* and apply *changes*.
+
+    This is different from `evolve` that applies the changes to the arguments
+    that create the new instance.
+
+    `evolve`'s behavior is preferable, but there are `edge cases`_ where it
+    doesn't work. Therefore `assoc` is deprecated, but will not be removed.
+
+    .. _`edge cases`: https://github.com/python-attrs/attrs/issues/251
+
+    :param inst: Instance of a class with *attrs* attributes.
+    :param changes: Keyword changes in the new copy.
+
+    :return: A copy of inst with *changes* incorporated.
+
+    :raise attrs.exceptions.AttrsAttributeNotFoundError: If *attr_name*
+        couldn't be found on *cls*.
+    :raise attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs*
+        class.
+
+    ..  deprecated:: 17.1.0
+        Use `attrs.evolve` instead if you can.
+        This function will not be removed du to the slightly different approach
+        compared to `attrs.evolve`.
+    """
+    new = copy.copy(inst)
+    attrs = fields(inst.__class__)
+    for k, v in changes.items():
+        a = getattr(attrs, k, NOTHING)
+        if a is NOTHING:
+            msg = f"{k} is not an attrs attribute on {new.__class__}."
+            raise AttrsAttributeNotFoundError(msg)
+        _obj_setattr(new, k, v)
+    return new
+
+
+def evolve(*args, **changes):
+    """
+    Create a new instance, based on the first positional argument with
+    *changes* applied.
+
+    :param inst: Instance of a class with *attrs* attributes.
+    :param changes: Keyword changes in the new copy.
+
+    :return: A copy of inst with *changes* incorporated.
+
+    :raise TypeError: If *attr_name* couldn't be found in the class
+        ``__init__``.
+    :raise attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs*
+        class.
+
+    .. versionadded:: 17.1.0
+    .. deprecated:: 23.1.0
+       It is now deprecated to pass the instance using the keyword argument
+       *inst*. It will raise a warning until at least April 2024, after which
+       it will become an error. Always pass the instance as a positional
+       argument.
+    """
+    # Try to get instance by positional argument first.
+    # Use changes otherwise and warn it'll break.
+    if args:
+        try:
+            (inst,) = args
+        except ValueError:
+            msg = f"evolve() takes 1 positional argument, but {len(args)} were given"
+            raise TypeError(msg) from None
+    else:
+        try:
+            inst = changes.pop("inst")
+        except KeyError:
+            msg = "evolve() missing 1 required positional argument: 'inst'"
+            raise TypeError(msg) from None
+
+        import warnings
+
+        warnings.warn(
+            "Passing the instance per keyword argument is deprecated and "
+            "will stop working in, or after, April 2024.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+
+    cls = inst.__class__
+    attrs = fields(cls)
+    for a in attrs:
+        if not a.init:
+            continue
+        attr_name = a.name  # To deal with private attributes.
+        init_name = a.alias
+        if init_name not in changes:
+            changes[init_name] = getattr(inst, attr_name)
+
+    return cls(**changes)
+
+
+def resolve_types(
+    cls, globalns=None, localns=None, attribs=None, include_extras=True
+):
+    """
+    Resolve any strings and forward annotations in type annotations.
+
+    This is only required if you need concrete types in `Attribute`'s *type*
+    field. In other words, you don't need to resolve your types if you only
+    use them for static type checking.
+
+    With no arguments, names will be looked up in the module in which the class
+    was created. If this is not what you want, e.g. if the name only exists
+    inside a method, you may pass *globalns* or *localns* to specify other
+    dictionaries in which to look up these names. See the docs of
+    `typing.get_type_hints` for more details.
+
+    :param type cls: Class to resolve.
+    :param Optional[dict] globalns: Dictionary containing global variables.
+    :param Optional[dict] localns: Dictionary containing local variables.
+    :param Optional[list] attribs: List of attribs for the given class.
+        This is necessary when calling from inside a ``field_transformer``
+        since *cls* is not an *attrs* class yet.
+    :param bool include_extras: Resolve more accurately, if possible.
+        Pass ``include_extras`` to ``typing.get_hints``, if supported by the
+        typing module. On supported Python versions (3.9+), this resolves the
+        types more accurately.
+
+    :raise TypeError: If *cls* is not a class.
+    :raise attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs*
+        class and you didn't pass any attribs.
+    :raise NameError: If types cannot be resolved because of missing variables.
+
+    :returns: *cls* so you can use this function also as a class decorator.
+        Please note that you have to apply it **after** `attrs.define`. That
+        means the decorator has to come in the line **before** `attrs.define`.
+
+    ..  versionadded:: 20.1.0
+    ..  versionadded:: 21.1.0 *attribs*
+    ..  versionadded:: 23.1.0 *include_extras*
+
+    """
+    # Since calling get_type_hints is expensive we cache whether we've
+    # done it already.
+    if getattr(cls, "__attrs_types_resolved__", None) != cls:
+        import typing
+
+        kwargs = {"globalns": globalns, "localns": localns}
+
+        if PY_3_9_PLUS:
+            kwargs["include_extras"] = include_extras
+
+        hints = typing.get_type_hints(cls, **kwargs)
+        for field in fields(cls) if attribs is None else attribs:
+            if field.name in hints:
+                # Since fields have been frozen we must work around it.
+                _obj_setattr(field, "type", hints[field.name])
+        # We store the class we resolved so that subclasses know they haven't
+        # been resolved.
+        cls.__attrs_types_resolved__ = cls
+
+    # Return the class so you can use it as a decorator too.
+    return cls
diff --git a/llm/Lib/site-packages/attr/_make.py b/llm/Lib/site-packages/attr/_make.py
new file mode 100644
index 0000000000000000000000000000000000000000..10b4eca779621c819060c4564379fa2c098c36d5
--- /dev/null
+++ b/llm/Lib/site-packages/attr/_make.py
@@ -0,0 +1,3119 @@
+# SPDX-License-Identifier: MIT
+
+import contextlib
+import copy
+import enum
+import functools
+import inspect
+import itertools
+import linecache
+import sys
+import types
+import typing
+
+from operator import itemgetter
+
+# We need to import _compat itself in addition to the _compat members to avoid
+# having the thread-local in the globals here.
+from . import _compat, _config, setters
+from ._compat import (
+    PY310,
+    PY_3_8_PLUS,
+    _AnnotationExtractor,
+    get_generic_base,
+)
+from .exceptions import (
+    DefaultAlreadySetError,
+    FrozenInstanceError,
+    NotAnAttrsClassError,
+    UnannotatedAttributeError,
+)
+
+
+# This is used at least twice, so cache it here.
+_obj_setattr = object.__setattr__
+_init_converter_pat = "__attr_converter_%s"
+_init_factory_pat = "__attr_factory_%s"
+_classvar_prefixes = (
+    "typing.ClassVar",
+    "t.ClassVar",
+    "ClassVar",
+    "typing_extensions.ClassVar",
+)
+# we don't use a double-underscore prefix because that triggers
+# name mangling when trying to create a slot for the field
+# (when slots=True)
+_hash_cache_field = "_attrs_cached_hash"
+
+_empty_metadata_singleton = types.MappingProxyType({})
+
+# Unique object for unequivocal getattr() defaults.
+_sentinel = object()
+
+_ng_default_on_setattr = setters.pipe(setters.convert, setters.validate)
+
+
+class _Nothing(enum.Enum):
+    """
+    Sentinel to indicate the lack of a value when ``None`` is ambiguous.
+
+    If extending attrs, you can use ``typing.Literal[NOTHING]`` to show
+    that a value may be ``NOTHING``.
+
+    .. versionchanged:: 21.1.0 ``bool(NOTHING)`` is now False.
+    .. versionchanged:: 22.2.0 ``NOTHING`` is now an ``enum.Enum`` variant.
+    """
+
+    NOTHING = enum.auto()
+
+    def __repr__(self):
+        return "NOTHING"
+
+    def __bool__(self):
+        return False
+
+
+NOTHING = _Nothing.NOTHING
+"""
+Sentinel to indicate the lack of a value when ``None`` is ambiguous.
+"""
+
+
+class _CacheHashWrapper(int):
+    """
+    An integer subclass that pickles / copies as None
+
+    This is used for non-slots classes with ``cache_hash=True``, to avoid
+    serializing a potentially (even likely) invalid hash value. Since ``None``
+    is the default value for uncalculated hashes, whenever this is copied,
+    the copy's value for the hash should automatically reset.
+
+    See GH #613 for more details.
+    """
+
+    def __reduce__(self, _none_constructor=type(None), _args=()):  # noqa: B008
+        return _none_constructor, _args
+
+
+def attrib(
+    default=NOTHING,
+    validator=None,
+    repr=True,
+    cmp=None,
+    hash=None,
+    init=True,
+    metadata=None,
+    type=None,
+    converter=None,
+    factory=None,
+    kw_only=False,
+    eq=None,
+    order=None,
+    on_setattr=None,
+    alias=None,
+):
+    """
+    Create a new attribute on a class.
+
+    ..  warning::
+
+        Does *not* do anything unless the class is also decorated with `attr.s`
+        / `attrs.define` / and so on!
+
+    Please consider using `attrs.field` in new code (``attr.ib`` will *never*
+    go away, though).
+
+    :param default: A value that is used if an *attrs*-generated ``__init__``
+        is used and no value is passed while instantiating or the attribute is
+        excluded using ``init=False``.
+
+        If the value is an instance of `attrs.Factory`, its callable will be
+        used to construct a new value (useful for mutable data types like lists
+        or dicts).
+
+        If a default is not set (or set manually to `attrs.NOTHING`), a value
+        *must* be supplied when instantiating; otherwise a `TypeError` will be
+        raised.
+
+        The default can also be set using decorator notation as shown below.
+
+        .. seealso:: `defaults`
+
+    :param callable factory: Syntactic sugar for
+        ``default=attr.Factory(factory)``.
+
+    :param validator: `callable` that is called by *attrs*-generated
+        ``__init__`` methods after the instance has been initialized.  They
+        receive the initialized instance, the :func:`~attrs.Attribute`, and the
+        passed value.
+
+        The return value is *not* inspected so the validator has to throw an
+        exception itself.
+
+        If a `list` is passed, its items are treated as validators and must all
+        pass.
+
+        Validators can be globally disabled and re-enabled using
+        `attrs.validators.get_disabled` / `attrs.validators.set_disabled`.
+
+        The validator can also be set using decorator notation as shown below.
+
+        .. seealso:: :ref:`validators`
+
+    :type validator: `callable` or a `list` of `callable`\\ s.
+
+    :param repr: Include this attribute in the generated ``__repr__`` method.
+        If ``True``, include the attribute; if ``False``, omit it. By default,
+        the built-in ``repr()`` function is used. To override how the attribute
+        value is formatted, pass a ``callable`` that takes a single value and
+        returns a string. Note that the resulting string is used as-is, i.e. it
+        will be used directly *instead* of calling ``repr()`` (the default).
+    :type repr: a `bool` or a `callable` to use a custom function.
+
+    :param eq: If ``True`` (default), include this attribute in the generated
+        ``__eq__`` and ``__ne__`` methods that check two instances for
+        equality. To override how the attribute value is compared, pass a
+        ``callable`` that takes a single value and returns the value to be
+        compared.
+
+        .. seealso:: `comparison`
+    :type eq: a `bool` or a `callable`.
+
+    :param order: If ``True`` (default), include this attributes in the
+        generated ``__lt__``, ``__le__``, ``__gt__`` and ``__ge__`` methods. To
+        override how the attribute value is ordered, pass a ``callable`` that
+        takes a single value and returns the value to be ordered.
+
+        .. seealso:: `comparison`
+    :type order: a `bool` or a `callable`.
+
+    :param cmp: Setting *cmp* is equivalent to setting *eq* and *order* to the
+        same value. Must not be mixed with *eq* or *order*.
+
+        .. seealso:: `comparison`
+    :type cmp: a `bool` or a `callable`.
+
+    :param bool | None hash: Include this attribute in the generated
+        ``__hash__`` method.  If ``None`` (default), mirror *eq*'s value.  This
+        is the correct behavior according the Python spec.  Setting this value
+        to anything else than ``None`` is *discouraged*.
+
+        .. seealso:: `hashing`
+    :param bool init: Include this attribute in the generated ``__init__``
+        method.  It is possible to set this to ``False`` and set a default
+        value.  In that case this attributed is unconditionally initialized
+        with the specified default value or factory.
+
+        .. seealso:: `init`
+    :param callable converter: `callable` that is called by *attrs*-generated
+        ``__init__`` methods to convert attribute's value to the desired
+        format.  It is given the passed-in value, and the returned value will
+        be used as the new value of the attribute.  The value is converted
+        before being passed to the validator, if any.
+
+        .. seealso:: :ref:`converters`
+    :param dict | None metadata: An arbitrary mapping, to be used by
+        third-party components.  See `extending-metadata`.
+
+    :param type: The type of the attribute. Nowadays, the preferred method to
+        specify the type is using a variable annotation (see :pep:`526`). This
+        argument is provided for backward compatibility. Regardless of the
+        approach used, the type will be stored on ``Attribute.type``.
+
+        Please note that *attrs* doesn't do anything with this metadata by
+        itself. You can use it as part of your own code or for `static type
+        checking <types>`.
+    :param bool kw_only: Make this attribute keyword-only in the generated
+        ``__init__`` (if ``init`` is ``False``, this parameter is ignored).
+    :param on_setattr: Allows to overwrite the *on_setattr* setting from
+        `attr.s`. If left `None`, the *on_setattr* value from `attr.s` is used.
+        Set to `attrs.setters.NO_OP` to run **no** `setattr` hooks for this
+        attribute -- regardless of the setting in `attr.s`.
+    :type on_setattr: `callable`, or a list of callables, or `None`, or
+        `attrs.setters.NO_OP`
+    :param str | None alias: Override this attribute's parameter name in the
+        generated ``__init__`` method. If left `None`, default to ``name``
+        stripped of leading underscores. See `private-attributes`.
+
+    .. versionadded:: 15.2.0 *convert*
+    .. versionadded:: 16.3.0 *metadata*
+    .. versionchanged:: 17.1.0 *validator* can be a ``list`` now.
+    .. versionchanged:: 17.1.0
+       *hash* is ``None`` and therefore mirrors *eq* by default.
+    .. versionadded:: 17.3.0 *type*
+    .. deprecated:: 17.4.0 *convert*
+    .. versionadded:: 17.4.0 *converter* as a replacement for the deprecated
+       *convert* to achieve consistency with other noun-based arguments.
+    .. versionadded:: 18.1.0
+       ``factory=f`` is syntactic sugar for ``default=attr.Factory(f)``.
+    .. versionadded:: 18.2.0 *kw_only*
+    .. versionchanged:: 19.2.0 *convert* keyword argument removed.
+    .. versionchanged:: 19.2.0 *repr* also accepts a custom callable.
+    .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01.
+    .. versionadded:: 19.2.0 *eq* and *order*
+    .. versionadded:: 20.1.0 *on_setattr*
+    .. versionchanged:: 20.3.0 *kw_only* backported to Python 2
+    .. versionchanged:: 21.1.0
+       *eq*, *order*, and *cmp* also accept a custom callable
+    .. versionchanged:: 21.1.0 *cmp* undeprecated
+    .. versionadded:: 22.2.0 *alias*
+    """
+    eq, eq_key, order, order_key = _determine_attrib_eq_order(
+        cmp, eq, order, True
+    )
+
+    if hash is not None and hash is not True and hash is not False:
+        msg = "Invalid value for hash.  Must be True, False, or None."
+        raise TypeError(msg)
+
+    if factory is not None:
+        if default is not NOTHING:
+            msg = (
+                "The `default` and `factory` arguments are mutually exclusive."
+            )
+            raise ValueError(msg)
+        if not callable(factory):
+            msg = "The `factory` argument must be a callable."
+            raise ValueError(msg)
+        default = Factory(factory)
+
+    if metadata is None:
+        metadata = {}
+
+    # Apply syntactic sugar by auto-wrapping.
+    if isinstance(on_setattr, (list, tuple)):
+        on_setattr = setters.pipe(*on_setattr)
+
+    if validator and isinstance(validator, (list, tuple)):
+        validator = and_(*validator)
+
+    if converter and isinstance(converter, (list, tuple)):
+        converter = pipe(*converter)
+
+    return _CountingAttr(
+        default=default,
+        validator=validator,
+        repr=repr,
+        cmp=None,
+        hash=hash,
+        init=init,
+        converter=converter,
+        metadata=metadata,
+        type=type,
+        kw_only=kw_only,
+        eq=eq,
+        eq_key=eq_key,
+        order=order,
+        order_key=order_key,
+        on_setattr=on_setattr,
+        alias=alias,
+    )
+
+
+def _compile_and_eval(script, globs, locs=None, filename=""):
+    """
+    "Exec" the script with the given global (globs) and local (locs) variables.
+    """
+    bytecode = compile(script, filename, "exec")
+    eval(bytecode, globs, locs)
+
+
+def _make_method(name, script, filename, globs):
+    """
+    Create the method with the script given and return the method object.
+    """
+    locs = {}
+
+    # In order of debuggers like PDB being able to step through the code,
+    # we add a fake linecache entry.
+    count = 1
+    base_filename = filename
+    while True:
+        linecache_tuple = (
+            len(script),
+            None,
+            script.splitlines(True),
+            filename,
+        )
+        old_val = linecache.cache.setdefault(filename, linecache_tuple)
+        if old_val == linecache_tuple:
+            break
+
+        filename = f"{base_filename[:-1]}-{count}>"
+        count += 1
+
+    _compile_and_eval(script, globs, locs, filename)
+
+    return locs[name]
+
+
+def _make_attr_tuple_class(cls_name, attr_names):
+    """
+    Create a tuple subclass to hold `Attribute`s for an `attrs` class.
+
+    The subclass is a bare tuple with properties for names.
+
+    class MyClassAttributes(tuple):
+        __slots__ = ()
+        x = property(itemgetter(0))
+    """
+    attr_class_name = f"{cls_name}Attributes"
+    attr_class_template = [
+        f"class {attr_class_name}(tuple):",
+        "    __slots__ = ()",
+    ]
+    if attr_names:
+        for i, attr_name in enumerate(attr_names):
+            attr_class_template.append(
+                f"    {attr_name} = _attrs_property(_attrs_itemgetter({i}))"
+            )
+    else:
+        attr_class_template.append("    pass")
+    globs = {"_attrs_itemgetter": itemgetter, "_attrs_property": property}
+    _compile_and_eval("\n".join(attr_class_template), globs)
+    return globs[attr_class_name]
+
+
+# Tuple class for extracted attributes from a class definition.
+# `base_attrs` is a subset of `attrs`.
+_Attributes = _make_attr_tuple_class(
+    "_Attributes",
+    [
+        # all attributes to build dunder methods for
+        "attrs",
+        # attributes that have been inherited
+        "base_attrs",
+        # map inherited attributes to their originating classes
+        "base_attrs_map",
+    ],
+)
+
+
+def _is_class_var(annot):
+    """
+    Check whether *annot* is a typing.ClassVar.
+
+    The string comparison hack is used to avoid evaluating all string
+    annotations which would put attrs-based classes at a performance
+    disadvantage compared to plain old classes.
+    """
+    annot = str(annot)
+
+    # Annotation can be quoted.
+    if annot.startswith(("'", '"')) and annot.endswith(("'", '"')):
+        annot = annot[1:-1]
+
+    return annot.startswith(_classvar_prefixes)
+
+
+def _has_own_attribute(cls, attrib_name):
+    """
+    Check whether *cls* defines *attrib_name* (and doesn't just inherit it).
+    """
+    attr = getattr(cls, attrib_name, _sentinel)
+    if attr is _sentinel:
+        return False
+
+    for base_cls in cls.__mro__[1:]:
+        a = getattr(base_cls, attrib_name, None)
+        if attr is a:
+            return False
+
+    return True
+
+
+def _get_annotations(cls):
+    """
+    Get annotations for *cls*.
+    """
+    if _has_own_attribute(cls, "__annotations__"):
+        return cls.__annotations__
+
+    return {}
+
+
+def _collect_base_attrs(cls, taken_attr_names):
+    """
+    Collect attr.ibs from base classes of *cls*, except *taken_attr_names*.
+    """
+    base_attrs = []
+    base_attr_map = {}  # A dictionary of base attrs to their classes.
+
+    # Traverse the MRO and collect attributes.
+    for base_cls in reversed(cls.__mro__[1:-1]):
+        for a in getattr(base_cls, "__attrs_attrs__", []):
+            if a.inherited or a.name in taken_attr_names:
+                continue
+
+            a = a.evolve(inherited=True)  # noqa: PLW2901
+            base_attrs.append(a)
+            base_attr_map[a.name] = base_cls
+
+    # For each name, only keep the freshest definition i.e. the furthest at the
+    # back.  base_attr_map is fine because it gets overwritten with every new
+    # instance.
+    filtered = []
+    seen = set()
+    for a in reversed(base_attrs):
+        if a.name in seen:
+            continue
+        filtered.insert(0, a)
+        seen.add(a.name)
+
+    return filtered, base_attr_map
+
+
+def _collect_base_attrs_broken(cls, taken_attr_names):
+    """
+    Collect attr.ibs from base classes of *cls*, except *taken_attr_names*.
+
+    N.B. *taken_attr_names* will be mutated.
+
+    Adhere to the old incorrect behavior.
+
+    Notably it collects from the front and considers inherited attributes which
+    leads to the buggy behavior reported in #428.
+    """
+    base_attrs = []
+    base_attr_map = {}  # A dictionary of base attrs to their classes.
+
+    # Traverse the MRO and collect attributes.
+    for base_cls in cls.__mro__[1:-1]:
+        for a in getattr(base_cls, "__attrs_attrs__", []):
+            if a.name in taken_attr_names:
+                continue
+
+            a = a.evolve(inherited=True)  # noqa: PLW2901
+            taken_attr_names.add(a.name)
+            base_attrs.append(a)
+            base_attr_map[a.name] = base_cls
+
+    return base_attrs, base_attr_map
+
+
+def _transform_attrs(
+    cls, these, auto_attribs, kw_only, collect_by_mro, field_transformer
+):
+    """
+    Transform all `_CountingAttr`s on a class into `Attribute`s.
+
+    If *these* is passed, use that and don't look for them on the class.
+
+    *collect_by_mro* is True, collect them in the correct MRO order, otherwise
+    use the old -- incorrect -- order.  See #428.
+
+    Return an `_Attributes`.
+    """
+    cd = cls.__dict__
+    anns = _get_annotations(cls)
+
+    if these is not None:
+        ca_list = list(these.items())
+    elif auto_attribs is True:
+        ca_names = {
+            name
+            for name, attr in cd.items()
+            if isinstance(attr, _CountingAttr)
+        }
+        ca_list = []
+        annot_names = set()
+        for attr_name, type in anns.items():
+            if _is_class_var(type):
+                continue
+            annot_names.add(attr_name)
+            a = cd.get(attr_name, NOTHING)
+
+            if not isinstance(a, _CountingAttr):
+                a = attrib() if a is NOTHING else attrib(default=a)
+            ca_list.append((attr_name, a))
+
+        unannotated = ca_names - annot_names
+        if len(unannotated) > 0:
+            raise UnannotatedAttributeError(
+                "The following `attr.ib`s lack a type annotation: "
+                + ", ".join(
+                    sorted(unannotated, key=lambda n: cd.get(n).counter)
+                )
+                + "."
+            )
+    else:
+        ca_list = sorted(
+            (
+                (name, attr)
+                for name, attr in cd.items()
+                if isinstance(attr, _CountingAttr)
+            ),
+            key=lambda e: e[1].counter,
+        )
+
+    own_attrs = [
+        Attribute.from_counting_attr(
+            name=attr_name, ca=ca, type=anns.get(attr_name)
+        )
+        for attr_name, ca in ca_list
+    ]
+
+    if collect_by_mro:
+        base_attrs, base_attr_map = _collect_base_attrs(
+            cls, {a.name for a in own_attrs}
+        )
+    else:
+        base_attrs, base_attr_map = _collect_base_attrs_broken(
+            cls, {a.name for a in own_attrs}
+        )
+
+    if kw_only:
+        own_attrs = [a.evolve(kw_only=True) for a in own_attrs]
+        base_attrs = [a.evolve(kw_only=True) for a in base_attrs]
+
+    attrs = base_attrs + own_attrs
+
+    # Mandatory vs non-mandatory attr order only matters when they are part of
+    # the __init__ signature and when they aren't kw_only (which are moved to
+    # the end and can be mandatory or non-mandatory in any order, as they will
+    # be specified as keyword args anyway). Check the order of those attrs:
+    had_default = False
+    for a in (a for a in attrs if a.init is not False and a.kw_only is False):
+        if had_default is True and a.default is NOTHING:
+            msg = f"No mandatory attributes allowed after an attribute with a default value or factory.  Attribute in question: {a!r}"
+            raise ValueError(msg)
+
+        if had_default is False and a.default is not NOTHING:
+            had_default = True
+
+    if field_transformer is not None:
+        attrs = field_transformer(cls, attrs)
+
+    # Resolve default field alias after executing field_transformer.
+    # This allows field_transformer to differentiate between explicit vs
+    # default aliases and supply their own defaults.
+    attrs = [
+        a.evolve(alias=_default_init_alias_for(a.name)) if not a.alias else a
+        for a in attrs
+    ]
+
+    # Create AttrsClass *after* applying the field_transformer since it may
+    # add or remove attributes!
+    attr_names = [a.name for a in attrs]
+    AttrsClass = _make_attr_tuple_class(cls.__name__, attr_names)
+
+    return _Attributes((AttrsClass(attrs), base_attrs, base_attr_map))
+
+
+def _make_cached_property_getattr(
+    cached_properties,
+    original_getattr,
+    cls,
+):
+    lines = [
+        # Wrapped to get `__class__` into closure cell for super()
+        # (It will be replaced with the newly constructed class after construction).
+        "def wrapper():",
+        "    __class__ = _cls",
+        "    def __getattr__(self, item, cached_properties=cached_properties, original_getattr=original_getattr, _cached_setattr_get=_cached_setattr_get):",
+        "         func = cached_properties.get(item)",
+        "         if func is not None:",
+        "              result = func(self)",
+        "              _setter = _cached_setattr_get(self)",
+        "              _setter(item, result)",
+        "              return result",
+    ]
+    if original_getattr is not None:
+        lines.append(
+            "         return original_getattr(self, item)",
+        )
+    else:
+        lines.extend(
+            [
+                "         if hasattr(super(), '__getattr__'):",
+                "              return super().__getattr__(item)",
+                "         original_error = f\"'{self.__class__.__name__}' object has no attribute '{item}'\"",
+                "         raise AttributeError(original_error)",
+            ]
+        )
+
+    lines.extend(
+        [
+            "    return __getattr__",
+            "__getattr__ = wrapper()",
+        ]
+    )
+
+    unique_filename = _generate_unique_filename(cls, "getattr")
+
+    glob = {
+        "cached_properties": cached_properties,
+        "_cached_setattr_get": _obj_setattr.__get__,
+        "_cls": cls,
+        "original_getattr": original_getattr,
+    }
+
+    return _make_method(
+        "__getattr__",
+        "\n".join(lines),
+        unique_filename,
+        glob,
+    )
+
+
+def _frozen_setattrs(self, name, value):
+    """
+    Attached to frozen classes as __setattr__.
+    """
+    if isinstance(self, BaseException) and name in (
+        "__cause__",
+        "__context__",
+        "__traceback__",
+    ):
+        BaseException.__setattr__(self, name, value)
+        return
+
+    raise FrozenInstanceError()
+
+
+def _frozen_delattrs(self, name):
+    """
+    Attached to frozen classes as __delattr__.
+    """
+    raise FrozenInstanceError()
+
+
+class _ClassBuilder:
+    """
+    Iteratively build *one* class.
+    """
+
+    __slots__ = (
+        "_attr_names",
+        "_attrs",
+        "_base_attr_map",
+        "_base_names",
+        "_cache_hash",
+        "_cls",
+        "_cls_dict",
+        "_delete_attribs",
+        "_frozen",
+        "_has_pre_init",
+        "_pre_init_has_args",
+        "_has_post_init",
+        "_is_exc",
+        "_on_setattr",
+        "_slots",
+        "_weakref_slot",
+        "_wrote_own_setattr",
+        "_has_custom_setattr",
+    )
+
+    def __init__(
+        self,
+        cls,
+        these,
+        slots,
+        frozen,
+        weakref_slot,
+        getstate_setstate,
+        auto_attribs,
+        kw_only,
+        cache_hash,
+        is_exc,
+        collect_by_mro,
+        on_setattr,
+        has_custom_setattr,
+        field_transformer,
+    ):
+        attrs, base_attrs, base_map = _transform_attrs(
+            cls,
+            these,
+            auto_attribs,
+            kw_only,
+            collect_by_mro,
+            field_transformer,
+        )
+
+        self._cls = cls
+        self._cls_dict = dict(cls.__dict__) if slots else {}
+        self._attrs = attrs
+        self._base_names = {a.name for a in base_attrs}
+        self._base_attr_map = base_map
+        self._attr_names = tuple(a.name for a in attrs)
+        self._slots = slots
+        self._frozen = frozen
+        self._weakref_slot = weakref_slot
+        self._cache_hash = cache_hash
+        self._has_pre_init = bool(getattr(cls, "__attrs_pre_init__", False))
+        self._pre_init_has_args = False
+        if self._has_pre_init:
+            # Check if the pre init method has more arguments than just `self`
+            # We want to pass arguments if pre init expects arguments
+            pre_init_func = cls.__attrs_pre_init__
+            pre_init_signature = inspect.signature(pre_init_func)
+            self._pre_init_has_args = len(pre_init_signature.parameters) > 1
+        self._has_post_init = bool(getattr(cls, "__attrs_post_init__", False))
+        self._delete_attribs = not bool(these)
+        self._is_exc = is_exc
+        self._on_setattr = on_setattr
+
+        self._has_custom_setattr = has_custom_setattr
+        self._wrote_own_setattr = False
+
+        self._cls_dict["__attrs_attrs__"] = self._attrs
+
+        if frozen:
+            self._cls_dict["__setattr__"] = _frozen_setattrs
+            self._cls_dict["__delattr__"] = _frozen_delattrs
+
+            self._wrote_own_setattr = True
+        elif on_setattr in (
+            _ng_default_on_setattr,
+            setters.validate,
+            setters.convert,
+        ):
+            has_validator = has_converter = False
+            for a in attrs:
+                if a.validator is not None:
+                    has_validator = True
+                if a.converter is not None:
+                    has_converter = True
+
+                if has_validator and has_converter:
+                    break
+            if (
+                (
+                    on_setattr == _ng_default_on_setattr
+                    and not (has_validator or has_converter)
+                )
+                or (on_setattr == setters.validate and not has_validator)
+                or (on_setattr == setters.convert and not has_converter)
+            ):
+                # If class-level on_setattr is set to convert + validate, but
+                # there's no field to convert or validate, pretend like there's
+                # no on_setattr.
+                self._on_setattr = None
+
+        if getstate_setstate:
+            (
+                self._cls_dict["__getstate__"],
+                self._cls_dict["__setstate__"],
+            ) = self._make_getstate_setstate()
+
+    def __repr__(self):
+        return f"<_ClassBuilder(cls={self._cls.__name__})>"
+
+    if PY310:
+        import abc
+
+        def build_class(self):
+            """
+            Finalize class based on the accumulated configuration.
+
+            Builder cannot be used after calling this method.
+            """
+            if self._slots is True:
+                return self._create_slots_class()
+
+            return self.abc.update_abstractmethods(
+                self._patch_original_class()
+            )
+
+    else:
+
+        def build_class(self):
+            """
+            Finalize class based on the accumulated configuration.
+
+            Builder cannot be used after calling this method.
+            """
+            if self._slots is True:
+                return self._create_slots_class()
+
+            return self._patch_original_class()
+
+    def _patch_original_class(self):
+        """
+        Apply accumulated methods and return the class.
+        """
+        cls = self._cls
+        base_names = self._base_names
+
+        # Clean class of attribute definitions (`attr.ib()`s).
+        if self._delete_attribs:
+            for name in self._attr_names:
+                if (
+                    name not in base_names
+                    and getattr(cls, name, _sentinel) is not _sentinel
+                ):
+                    # An AttributeError can happen if a base class defines a
+                    # class variable and we want to set an attribute with the
+                    # same name by using only a type annotation.
+                    with contextlib.suppress(AttributeError):
+                        delattr(cls, name)
+
+        # Attach our dunder methods.
+        for name, value in self._cls_dict.items():
+            setattr(cls, name, value)
+
+        # If we've inherited an attrs __setattr__ and don't write our own,
+        # reset it to object's.
+        if not self._wrote_own_setattr and getattr(
+            cls, "__attrs_own_setattr__", False
+        ):
+            cls.__attrs_own_setattr__ = False
+
+            if not self._has_custom_setattr:
+                cls.__setattr__ = _obj_setattr
+
+        return cls
+
+    def _create_slots_class(self):
+        """
+        Build and return a new class with a `__slots__` attribute.
+        """
+        cd = {
+            k: v
+            for k, v in self._cls_dict.items()
+            if k not in (*tuple(self._attr_names), "__dict__", "__weakref__")
+        }
+
+        # If our class doesn't have its own implementation of __setattr__
+        # (either from the user or by us), check the bases, if one of them has
+        # an attrs-made __setattr__, that needs to be reset. We don't walk the
+        # MRO because we only care about our immediate base classes.
+        # XXX: This can be confused by subclassing a slotted attrs class with
+        # XXX: a non-attrs class and subclass the resulting class with an attrs
+        # XXX: class.  See `test_slotted_confused` for details.  For now that's
+        # XXX: OK with us.
+        if not self._wrote_own_setattr:
+            cd["__attrs_own_setattr__"] = False
+
+            if not self._has_custom_setattr:
+                for base_cls in self._cls.__bases__:
+                    if base_cls.__dict__.get("__attrs_own_setattr__", False):
+                        cd["__setattr__"] = _obj_setattr
+                        break
+
+        # Traverse the MRO to collect existing slots
+        # and check for an existing __weakref__.
+        existing_slots = {}
+        weakref_inherited = False
+        for base_cls in self._cls.__mro__[1:-1]:
+            if base_cls.__dict__.get("__weakref__", None) is not None:
+                weakref_inherited = True
+            existing_slots.update(
+                {
+                    name: getattr(base_cls, name)
+                    for name in getattr(base_cls, "__slots__", [])
+                }
+            )
+
+        base_names = set(self._base_names)
+
+        names = self._attr_names
+        if (
+            self._weakref_slot
+            and "__weakref__" not in getattr(self._cls, "__slots__", ())
+            and "__weakref__" not in names
+            and not weakref_inherited
+        ):
+            names += ("__weakref__",)
+
+        if PY_3_8_PLUS:
+            cached_properties = {
+                name: cached_property.func
+                for name, cached_property in cd.items()
+                if isinstance(cached_property, functools.cached_property)
+            }
+        else:
+            # `functools.cached_property` was introduced in 3.8.
+            # So can't be used before this.
+            cached_properties = {}
+
+        # Collect methods with a `__class__` reference that are shadowed in the new class.
+        # To know to update them.
+        additional_closure_functions_to_update = []
+        if cached_properties:
+            # Add cached properties to names for slotting.
+            names += tuple(cached_properties.keys())
+
+            for name in cached_properties:
+                # Clear out function from class to avoid clashing.
+                del cd[name]
+
+            class_annotations = _get_annotations(self._cls)
+            for name, func in cached_properties.items():
+                annotation = inspect.signature(func).return_annotation
+                if annotation is not inspect.Parameter.empty:
+                    class_annotations[name] = annotation
+
+            original_getattr = cd.get("__getattr__")
+            if original_getattr is not None:
+                additional_closure_functions_to_update.append(original_getattr)
+
+            cd["__getattr__"] = _make_cached_property_getattr(
+                cached_properties, original_getattr, self._cls
+            )
+
+        # We only add the names of attributes that aren't inherited.
+        # Setting __slots__ to inherited attributes wastes memory.
+        slot_names = [name for name in names if name not in base_names]
+
+        # There are slots for attributes from current class
+        # that are defined in parent classes.
+        # As their descriptors may be overridden by a child class,
+        # we collect them here and update the class dict
+        reused_slots = {
+            slot: slot_descriptor
+            for slot, slot_descriptor in existing_slots.items()
+            if slot in slot_names
+        }
+        slot_names = [name for name in slot_names if name not in reused_slots]
+        cd.update(reused_slots)
+        if self._cache_hash:
+            slot_names.append(_hash_cache_field)
+
+        cd["__slots__"] = tuple(slot_names)
+
+        cd["__qualname__"] = self._cls.__qualname__
+
+        # Create new class based on old class and our methods.
+        cls = type(self._cls)(self._cls.__name__, self._cls.__bases__, cd)
+
+        # The following is a fix for
+        # <https://github.com/python-attrs/attrs/issues/102>.
+        # If a method mentions `__class__` or uses the no-arg super(), the
+        # compiler will bake a reference to the class in the method itself
+        # as `method.__closure__`.  Since we replace the class with a
+        # clone, we rewrite these references so it keeps working.
+        for item in itertools.chain(
+            cls.__dict__.values(), additional_closure_functions_to_update
+        ):
+            if isinstance(item, (classmethod, staticmethod)):
+                # Class- and staticmethods hide their functions inside.
+                # These might need to be rewritten as well.
+                closure_cells = getattr(item.__func__, "__closure__", None)
+            elif isinstance(item, property):
+                # Workaround for property `super()` shortcut (PY3-only).
+                # There is no universal way for other descriptors.
+                closure_cells = getattr(item.fget, "__closure__", None)
+            else:
+                closure_cells = getattr(item, "__closure__", None)
+
+            if not closure_cells:  # Catch None or the empty list.
+                continue
+            for cell in closure_cells:
+                try:
+                    match = cell.cell_contents is self._cls
+                except ValueError:  # noqa: PERF203
+                    # ValueError: Cell is empty
+                    pass
+                else:
+                    if match:
+                        cell.cell_contents = cls
+        return cls
+
+    def add_repr(self, ns):
+        self._cls_dict["__repr__"] = self._add_method_dunders(
+            _make_repr(self._attrs, ns, self._cls)
+        )
+        return self
+
+    def add_str(self):
+        repr = self._cls_dict.get("__repr__")
+        if repr is None:
+            msg = "__str__ can only be generated if a __repr__ exists."
+            raise ValueError(msg)
+
+        def __str__(self):
+            return self.__repr__()
+
+        self._cls_dict["__str__"] = self._add_method_dunders(__str__)
+        return self
+
+    def _make_getstate_setstate(self):
+        """
+        Create custom __setstate__ and __getstate__ methods.
+        """
+        # __weakref__ is not writable.
+        state_attr_names = tuple(
+            an for an in self._attr_names if an != "__weakref__"
+        )
+
+        def slots_getstate(self):
+            """
+            Automatically created by attrs.
+            """
+            return {name: getattr(self, name) for name in state_attr_names}
+
+        hash_caching_enabled = self._cache_hash
+
+        def slots_setstate(self, state):
+            """
+            Automatically created by attrs.
+            """
+            __bound_setattr = _obj_setattr.__get__(self)
+            if isinstance(state, tuple):
+                # Backward compatibility with attrs instances pickled with
+                # attrs versions before v22.2.0 which stored tuples.
+                for name, value in zip(state_attr_names, state):
+                    __bound_setattr(name, value)
+            else:
+                for name in state_attr_names:
+                    if name in state:
+                        __bound_setattr(name, state[name])
+
+            # The hash code cache is not included when the object is
+            # serialized, but it still needs to be initialized to None to
+            # indicate that the first call to __hash__ should be a cache
+            # miss.
+            if hash_caching_enabled:
+                __bound_setattr(_hash_cache_field, None)
+
+        return slots_getstate, slots_setstate
+
+    def make_unhashable(self):
+        self._cls_dict["__hash__"] = None
+        return self
+
+    def add_hash(self):
+        self._cls_dict["__hash__"] = self._add_method_dunders(
+            _make_hash(
+                self._cls,
+                self._attrs,
+                frozen=self._frozen,
+                cache_hash=self._cache_hash,
+            )
+        )
+
+        return self
+
+    def add_init(self):
+        self._cls_dict["__init__"] = self._add_method_dunders(
+            _make_init(
+                self._cls,
+                self._attrs,
+                self._has_pre_init,
+                self._pre_init_has_args,
+                self._has_post_init,
+                self._frozen,
+                self._slots,
+                self._cache_hash,
+                self._base_attr_map,
+                self._is_exc,
+                self._on_setattr,
+                attrs_init=False,
+            )
+        )
+
+        return self
+
+    def add_match_args(self):
+        self._cls_dict["__match_args__"] = tuple(
+            field.name
+            for field in self._attrs
+            if field.init and not field.kw_only
+        )
+
+    def add_attrs_init(self):
+        self._cls_dict["__attrs_init__"] = self._add_method_dunders(
+            _make_init(
+                self._cls,
+                self._attrs,
+                self._has_pre_init,
+                self._pre_init_has_args,
+                self._has_post_init,
+                self._frozen,
+                self._slots,
+                self._cache_hash,
+                self._base_attr_map,
+                self._is_exc,
+                self._on_setattr,
+                attrs_init=True,
+            )
+        )
+
+        return self
+
+    def add_eq(self):
+        cd = self._cls_dict
+
+        cd["__eq__"] = self._add_method_dunders(
+            _make_eq(self._cls, self._attrs)
+        )
+        cd["__ne__"] = self._add_method_dunders(_make_ne())
+
+        return self
+
+    def add_order(self):
+        cd = self._cls_dict
+
+        cd["__lt__"], cd["__le__"], cd["__gt__"], cd["__ge__"] = (
+            self._add_method_dunders(meth)
+            for meth in _make_order(self._cls, self._attrs)
+        )
+
+        return self
+
+    def add_setattr(self):
+        if self._frozen:
+            return self
+
+        sa_attrs = {}
+        for a in self._attrs:
+            on_setattr = a.on_setattr or self._on_setattr
+            if on_setattr and on_setattr is not setters.NO_OP:
+                sa_attrs[a.name] = a, on_setattr
+
+        if not sa_attrs:
+            return self
+
+        if self._has_custom_setattr:
+            # We need to write a __setattr__ but there already is one!
+            msg = "Can't combine custom __setattr__ with on_setattr hooks."
+            raise ValueError(msg)
+
+        # docstring comes from _add_method_dunders
+        def __setattr__(self, name, val):
+            try:
+                a, hook = sa_attrs[name]
+            except KeyError:
+                nval = val
+            else:
+                nval = hook(self, a, val)
+
+            _obj_setattr(self, name, nval)
+
+        self._cls_dict["__attrs_own_setattr__"] = True
+        self._cls_dict["__setattr__"] = self._add_method_dunders(__setattr__)
+        self._wrote_own_setattr = True
+
+        return self
+
+    def _add_method_dunders(self, method):
+        """
+        Add __module__ and __qualname__ to a *method* if possible.
+        """
+        with contextlib.suppress(AttributeError):
+            method.__module__ = self._cls.__module__
+
+        with contextlib.suppress(AttributeError):
+            method.__qualname__ = f"{self._cls.__qualname__}.{method.__name__}"
+
+        with contextlib.suppress(AttributeError):
+            method.__doc__ = (
+                "Method generated by attrs for class "
+                f"{self._cls.__qualname__}."
+            )
+
+        return method
+
+
+def _determine_attrs_eq_order(cmp, eq, order, default_eq):
+    """
+    Validate the combination of *cmp*, *eq*, and *order*. Derive the effective
+    values of eq and order.  If *eq* is None, set it to *default_eq*.
+    """
+    if cmp is not None and any((eq is not None, order is not None)):
+        msg = "Don't mix `cmp` with `eq' and `order`."
+        raise ValueError(msg)
+
+    # cmp takes precedence due to bw-compatibility.
+    if cmp is not None:
+        return cmp, cmp
+
+    # If left None, equality is set to the specified default and ordering
+    # mirrors equality.
+    if eq is None:
+        eq = default_eq
+
+    if order is None:
+        order = eq
+
+    if eq is False and order is True:
+        msg = "`order` can only be True if `eq` is True too."
+        raise ValueError(msg)
+
+    return eq, order
+
+
+def _determine_attrib_eq_order(cmp, eq, order, default_eq):
+    """
+    Validate the combination of *cmp*, *eq*, and *order*. Derive the effective
+    values of eq and order.  If *eq* is None, set it to *default_eq*.
+    """
+    if cmp is not None and any((eq is not None, order is not None)):
+        msg = "Don't mix `cmp` with `eq' and `order`."
+        raise ValueError(msg)
+
+    def decide_callable_or_boolean(value):
+        """
+        Decide whether a key function is used.
+        """
+        if callable(value):
+            value, key = True, value
+        else:
+            key = None
+        return value, key
+
+    # cmp takes precedence due to bw-compatibility.
+    if cmp is not None:
+        cmp, cmp_key = decide_callable_or_boolean(cmp)
+        return cmp, cmp_key, cmp, cmp_key
+
+    # If left None, equality is set to the specified default and ordering
+    # mirrors equality.
+    if eq is None:
+        eq, eq_key = default_eq, None
+    else:
+        eq, eq_key = decide_callable_or_boolean(eq)
+
+    if order is None:
+        order, order_key = eq, eq_key
+    else:
+        order, order_key = decide_callable_or_boolean(order)
+
+    if eq is False and order is True:
+        msg = "`order` can only be True if `eq` is True too."
+        raise ValueError(msg)
+
+    return eq, eq_key, order, order_key
+
+
+def _determine_whether_to_implement(
+    cls, flag, auto_detect, dunders, default=True
+):
+    """
+    Check whether we should implement a set of methods for *cls*.
+
+    *flag* is the argument passed into @attr.s like 'init', *auto_detect* the
+    same as passed into @attr.s and *dunders* is a tuple of attribute names
+    whose presence signal that the user has implemented it themselves.
+
+    Return *default* if no reason for either for or against is found.
+    """
+    if flag is True or flag is False:
+        return flag
+
+    if flag is None and auto_detect is False:
+        return default
+
+    # Logically, flag is None and auto_detect is True here.
+    for dunder in dunders:
+        if _has_own_attribute(cls, dunder):
+            return False
+
+    return default
+
+
+def attrs(
+    maybe_cls=None,
+    these=None,
+    repr_ns=None,
+    repr=None,
+    cmp=None,
+    hash=None,
+    init=None,
+    slots=False,
+    frozen=False,
+    weakref_slot=True,
+    str=False,
+    auto_attribs=False,
+    kw_only=False,
+    cache_hash=False,
+    auto_exc=False,
+    eq=None,
+    order=None,
+    auto_detect=False,
+    collect_by_mro=False,
+    getstate_setstate=None,
+    on_setattr=None,
+    field_transformer=None,
+    match_args=True,
+    unsafe_hash=None,
+):
+    r"""
+    A class decorator that adds :term:`dunder methods` according to the
+    specified attributes using `attr.ib` or the *these* argument.
+
+    Please consider using `attrs.define` / `attrs.frozen` in new code
+    (``attr.s`` will *never* go away, though).
+
+    :param these: A dictionary of name to `attr.ib` mappings.  This is useful
+        to avoid the definition of your attributes within the class body
+        because you can't (e.g. if you want to add ``__repr__`` methods to
+        Django models) or don't want to.
+
+        If *these* is not ``None``, *attrs* will *not* search the class body
+        for attributes and will *not* remove any attributes from it.
+
+        The order is deduced from the order of the attributes inside *these*.
+
+    :type these: `dict` of `str` to `attr.ib`
+
+    :param str repr_ns: When using nested classes, there's no way in Python 2
+        to automatically detect that.  Therefore it's possible to set the
+        namespace explicitly for a more meaningful ``repr`` output.
+    :param bool auto_detect: Instead of setting the *init*, *repr*, *eq*,
+        *order*, and *hash* arguments explicitly, assume they are set to
+        ``True`` **unless any** of the involved methods for one of the
+        arguments is implemented in the *current* class (i.e. it is *not*
+        inherited from some base class).
+
+        So for example by implementing ``__eq__`` on a class yourself, *attrs*
+        will deduce ``eq=False`` and will create *neither* ``__eq__`` *nor*
+        ``__ne__`` (but Python classes come with a sensible ``__ne__`` by
+        default, so it *should* be enough to only implement ``__eq__`` in most
+        cases).
+
+        .. warning::
+
+           If you prevent *attrs* from creating the ordering methods for you
+           (``order=False``, e.g. by implementing ``__le__``), it becomes
+           *your* responsibility to make sure its ordering is sound. The best
+           way is to use the `functools.total_ordering` decorator.
+
+
+        Passing ``True`` or ``False`` to *init*, *repr*, *eq*, *order*, *cmp*,
+        or *hash* overrides whatever *auto_detect* would determine.
+
+    :param bool repr: Create a ``__repr__`` method with a human readable
+        representation of *attrs* attributes..
+    :param bool str: Create a ``__str__`` method that is identical to
+        ``__repr__``.  This is usually not necessary except for `Exception`\ s.
+    :param bool | None eq: If ``True`` or ``None`` (default), add ``__eq__``
+        and ``__ne__`` methods that check two instances for equality.
+
+        They compare the instances as if they were tuples of their *attrs*
+        attributes if and only if the types of both classes are *identical*!
+
+        .. seealso:: `comparison`
+    :param bool | None order: If ``True``, add ``__lt__``, ``__le__``,
+        ``__gt__``, and ``__ge__`` methods that behave like *eq* above and
+        allow instances to be ordered. If ``None`` (default) mirror value of
+        *eq*.
+
+        .. seealso:: `comparison`
+    :param bool | None cmp: Setting *cmp* is equivalent to setting *eq* and
+        *order* to the same value. Must not be mixed with *eq* or *order*.
+
+        .. seealso:: `comparison`
+    :param bool | None unsafe_hash: If ``None`` (default), the ``__hash__``
+        method is generated according how *eq* and *frozen* are set.
+
+        1. If *both* are True, *attrs* will generate a ``__hash__`` for you.
+        2. If *eq* is True and *frozen* is False, ``__hash__`` will be set to
+           None, marking it unhashable (which it is).
+        3. If *eq* is False, ``__hash__`` will be left untouched meaning the
+           ``__hash__`` method of the base class will be used (if base class is
+           ``object``, this means it will fall back to id-based hashing.).
+
+        Although not recommended, you can decide for yourself and force *attrs*
+        to create one (e.g. if the class is immutable even though you didn't
+        freeze it programmatically) by passing ``True`` or not.  Both of these
+        cases are rather special and should be used carefully.
+
+        .. seealso::
+
+           - Our documentation on `hashing`,
+           - Python's documentation on `object.__hash__`,
+           - and the `GitHub issue that led to the default \
+             behavior <https://github.com/python-attrs/attrs/issues/136>`_ for
+             more details.
+
+    :param bool | None hash: Alias for *unsafe_hash*. *unsafe_hash* takes
+        precedence.
+    :param bool init: Create a ``__init__`` method that initializes the *attrs*
+        attributes. Leading underscores are stripped for the argument name. If
+        a ``__attrs_pre_init__`` method exists on the class, it will be called
+        before the class is initialized. If a ``__attrs_post_init__`` method
+        exists on the class, it will be called after the class is fully
+        initialized.
+
+        If ``init`` is ``False``, an ``__attrs_init__`` method will be injected
+        instead. This allows you to define a custom ``__init__`` method that
+        can do pre-init work such as ``super().__init__()``, and then call
+        ``__attrs_init__()`` and ``__attrs_post_init__()``.
+
+        .. seealso:: `init`
+    :param bool slots: Create a :term:`slotted class <slotted classes>` that's
+        more memory-efficient. Slotted classes are generally superior to the
+        default dict classes, but have some gotchas you should know about, so
+        we encourage you to read the :term:`glossary entry <slotted classes>`.
+    :param bool frozen: Make instances immutable after initialization.  If
+        someone attempts to modify a frozen instance,
+        `attrs.exceptions.FrozenInstanceError` is raised.
+
+        .. note::
+
+            1. This is achieved by installing a custom ``__setattr__`` method
+               on your class, so you can't implement your own.
+
+            2. True immutability is impossible in Python.
+
+            3. This *does* have a minor a runtime performance `impact
+               <how-frozen>` when initializing new instances.  In other words:
+               ``__init__`` is slightly slower with ``frozen=True``.
+
+            4. If a class is frozen, you cannot modify ``self`` in
+               ``__attrs_post_init__`` or a self-written ``__init__``. You can
+               circumvent that limitation by using ``object.__setattr__(self,
+               "attribute_name", value)``.
+
+            5. Subclasses of a frozen class are frozen too.
+
+    :param bool weakref_slot: Make instances weak-referenceable.  This has no
+        effect unless ``slots`` is also enabled.
+    :param bool auto_attribs: If ``True``, collect :pep:`526`-annotated
+        attributes from the class body.
+
+        In this case, you **must** annotate every field.  If *attrs* encounters
+        a field that is set to an `attr.ib` but lacks a type annotation, an
+        `attr.exceptions.UnannotatedAttributeError` is raised.  Use
+        ``field_name: typing.Any = attr.ib(...)`` if you don't want to set a
+        type.
+
+        If you assign a value to those attributes (e.g. ``x: int = 42``), that
+        value becomes the default value like if it were passed using
+        ``attr.ib(default=42)``.  Passing an instance of `attrs.Factory` also
+        works as expected in most cases (see warning below).
+
+        Attributes annotated as `typing.ClassVar`, and attributes that are
+        neither annotated nor set to an `attr.ib` are **ignored**.
+
+        .. warning::
+           For features that use the attribute name to create decorators (e.g.
+           :ref:`validators <validators>`), you still *must* assign `attr.ib`
+           to them. Otherwise Python will either not find the name or try to
+           use the default value to call e.g. ``validator`` on it.
+
+           These errors can be quite confusing and probably the most common bug
+           report on our bug tracker.
+
+    :param bool kw_only: Make all attributes keyword-only in the generated
+        ``__init__`` (if ``init`` is ``False``, this parameter is ignored).
+    :param bool cache_hash: Ensure that the object's hash code is computed only
+        once and stored on the object.  If this is set to ``True``, hashing
+        must be either explicitly or implicitly enabled for this class.  If the
+        hash code is cached, avoid any reassignments of fields involved in hash
+        code computation or mutations of the objects those fields point to
+        after object creation.  If such changes occur, the behavior of the
+        object's hash code is undefined.
+    :param bool auto_exc: If the class subclasses `BaseException` (which
+        implicitly includes any subclass of any exception), the following
+        happens to behave like a well-behaved Python exceptions class:
+
+        - the values for *eq*, *order*, and *hash* are ignored and the
+          instances compare and hash by the instance's ids (N.B. *attrs* will
+          *not* remove existing implementations of ``__hash__`` or the equality
+          methods. It just won't add own ones.),
+        - all attributes that are either passed into ``__init__`` or have a
+          default value are additionally available as a tuple in the ``args``
+          attribute,
+        - the value of *str* is ignored leaving ``__str__`` to base classes.
+    :param bool collect_by_mro: Setting this to `True` fixes the way *attrs*
+       collects attributes from base classes.  The default behavior is
+       incorrect in certain cases of multiple inheritance.  It should be on by
+       default but is kept off for backward-compatibility.
+
+       .. seealso::
+          Issue `#428 <https://github.com/python-attrs/attrs/issues/428>`_
+
+    :param bool | None getstate_setstate:
+       .. note::
+          This is usually only interesting for slotted classes and you should
+          probably just set *auto_detect* to `True`.
+
+       If `True`, ``__getstate__`` and ``__setstate__`` are generated and
+       attached to the class. This is necessary for slotted classes to be
+       pickleable. If left `None`, it's `True` by default for slotted classes
+       and ``False`` for dict classes.
+
+       If *auto_detect* is `True`, and *getstate_setstate* is left `None`, and
+       **either** ``__getstate__`` or ``__setstate__`` is detected directly on
+       the class (i.e. not inherited), it is set to `False` (this is usually
+       what you want).
+
+    :param on_setattr: A callable that is run whenever the user attempts to set
+        an attribute (either by assignment like ``i.x = 42`` or by using
+        `setattr` like ``setattr(i, "x", 42)``). It receives the same arguments
+        as validators: the instance, the attribute that is being modified, and
+        the new value.
+
+        If no exception is raised, the attribute is set to the return value of
+        the callable.
+
+        If a list of callables is passed, they're automatically wrapped in an
+        `attrs.setters.pipe`.
+    :type on_setattr: `callable`, or a list of callables, or `None`, or
+        `attrs.setters.NO_OP`
+
+    :param callable | None field_transformer:
+        A function that is called with the original class object and all fields
+        right before *attrs* finalizes the class.  You can use this, e.g., to
+        automatically add converters or validators to fields based on their
+        types.
+
+        .. seealso:: `transform-fields`
+
+    :param bool match_args:
+        If `True` (default), set ``__match_args__`` on the class to support
+        :pep:`634` (Structural Pattern Matching). It is a tuple of all
+        non-keyword-only ``__init__`` parameter names on Python 3.10 and later.
+        Ignored on older Python versions.
+
+    .. versionadded:: 16.0.0 *slots*
+    .. versionadded:: 16.1.0 *frozen*
+    .. versionadded:: 16.3.0 *str*
+    .. versionadded:: 16.3.0 Support for ``__attrs_post_init__``.
+    .. versionchanged:: 17.1.0
+       *hash* supports ``None`` as value which is also the default now.
+    .. versionadded:: 17.3.0 *auto_attribs*
+    .. versionchanged:: 18.1.0
+       If *these* is passed, no attributes are deleted from the class body.
+    .. versionchanged:: 18.1.0 If *these* is ordered, the order is retained.
+    .. versionadded:: 18.2.0 *weakref_slot*
+    .. deprecated:: 18.2.0
+       ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now raise a
+       `DeprecationWarning` if the classes compared are subclasses of
+       each other. ``__eq`` and ``__ne__`` never tried to compared subclasses
+       to each other.
+    .. versionchanged:: 19.2.0
+       ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now do not consider
+       subclasses comparable anymore.
+    .. versionadded:: 18.2.0 *kw_only*
+    .. versionadded:: 18.2.0 *cache_hash*
+    .. versionadded:: 19.1.0 *auto_exc*
+    .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01.
+    .. versionadded:: 19.2.0 *eq* and *order*
+    .. versionadded:: 20.1.0 *auto_detect*
+    .. versionadded:: 20.1.0 *collect_by_mro*
+    .. versionadded:: 20.1.0 *getstate_setstate*
+    .. versionadded:: 20.1.0 *on_setattr*
+    .. versionadded:: 20.3.0 *field_transformer*
+    .. versionchanged:: 21.1.0
+       ``init=False`` injects ``__attrs_init__``
+    .. versionchanged:: 21.1.0 Support for ``__attrs_pre_init__``
+    .. versionchanged:: 21.1.0 *cmp* undeprecated
+    .. versionadded:: 21.3.0 *match_args*
+    .. versionadded:: 22.2.0
+       *unsafe_hash* as an alias for *hash* (for :pep:`681` compliance).
+    """
+    eq_, order_ = _determine_attrs_eq_order(cmp, eq, order, None)
+
+    # unsafe_hash takes precedence due to PEP 681.
+    if unsafe_hash is not None:
+        hash = unsafe_hash
+
+    if isinstance(on_setattr, (list, tuple)):
+        on_setattr = setters.pipe(*on_setattr)
+
+    def wrap(cls):
+        is_frozen = frozen or _has_frozen_base_class(cls)
+        is_exc = auto_exc is True and issubclass(cls, BaseException)
+        has_own_setattr = auto_detect and _has_own_attribute(
+            cls, "__setattr__"
+        )
+
+        if has_own_setattr and is_frozen:
+            msg = "Can't freeze a class with a custom __setattr__."
+            raise ValueError(msg)
+
+        builder = _ClassBuilder(
+            cls,
+            these,
+            slots,
+            is_frozen,
+            weakref_slot,
+            _determine_whether_to_implement(
+                cls,
+                getstate_setstate,
+                auto_detect,
+                ("__getstate__", "__setstate__"),
+                default=slots,
+            ),
+            auto_attribs,
+            kw_only,
+            cache_hash,
+            is_exc,
+            collect_by_mro,
+            on_setattr,
+            has_own_setattr,
+            field_transformer,
+        )
+        if _determine_whether_to_implement(
+            cls, repr, auto_detect, ("__repr__",)
+        ):
+            builder.add_repr(repr_ns)
+        if str is True:
+            builder.add_str()
+
+        eq = _determine_whether_to_implement(
+            cls, eq_, auto_detect, ("__eq__", "__ne__")
+        )
+        if not is_exc and eq is True:
+            builder.add_eq()
+        if not is_exc and _determine_whether_to_implement(
+            cls, order_, auto_detect, ("__lt__", "__le__", "__gt__", "__ge__")
+        ):
+            builder.add_order()
+
+        builder.add_setattr()
+
+        nonlocal hash
+        if (
+            hash is None
+            and auto_detect is True
+            and _has_own_attribute(cls, "__hash__")
+        ):
+            hash = False
+
+        if hash is not True and hash is not False and hash is not None:
+            # Can't use `hash in` because 1 == True for example.
+            msg = "Invalid value for hash.  Must be True, False, or None."
+            raise TypeError(msg)
+
+        if hash is False or (hash is None and eq is False) or is_exc:
+            # Don't do anything. Should fall back to __object__'s __hash__
+            # which is by id.
+            if cache_hash:
+                msg = "Invalid value for cache_hash.  To use hash caching, hashing must be either explicitly or implicitly enabled."
+                raise TypeError(msg)
+        elif hash is True or (
+            hash is None and eq is True and is_frozen is True
+        ):
+            # Build a __hash__ if told so, or if it's safe.
+            builder.add_hash()
+        else:
+            # Raise TypeError on attempts to hash.
+            if cache_hash:
+                msg = "Invalid value for cache_hash.  To use hash caching, hashing must be either explicitly or implicitly enabled."
+                raise TypeError(msg)
+            builder.make_unhashable()
+
+        if _determine_whether_to_implement(
+            cls, init, auto_detect, ("__init__",)
+        ):
+            builder.add_init()
+        else:
+            builder.add_attrs_init()
+            if cache_hash:
+                msg = "Invalid value for cache_hash.  To use hash caching, init must be True."
+                raise TypeError(msg)
+
+        if (
+            PY310
+            and match_args
+            and not _has_own_attribute(cls, "__match_args__")
+        ):
+            builder.add_match_args()
+
+        return builder.build_class()
+
+    # maybe_cls's type depends on the usage of the decorator.  It's a class
+    # if it's used as `@attrs` but ``None`` if used as `@attrs()`.
+    if maybe_cls is None:
+        return wrap
+
+    return wrap(maybe_cls)
+
+
+_attrs = attrs
+"""
+Internal alias so we can use it in functions that take an argument called
+*attrs*.
+"""
+
+
+def _has_frozen_base_class(cls):
+    """
+    Check whether *cls* has a frozen ancestor by looking at its
+    __setattr__.
+    """
+    return cls.__setattr__ is _frozen_setattrs
+
+
+def _generate_unique_filename(cls, func_name):
+    """
+    Create a "filename" suitable for a function being generated.
+    """
+    return (
+        f"<attrs generated {func_name} {cls.__module__}."
+        f"{getattr(cls, '__qualname__', cls.__name__)}>"
+    )
+
+
+def _make_hash(cls, attrs, frozen, cache_hash):
+    attrs = tuple(
+        a for a in attrs if a.hash is True or (a.hash is None and a.eq is True)
+    )
+
+    tab = "        "
+
+    unique_filename = _generate_unique_filename(cls, "hash")
+    type_hash = hash(unique_filename)
+    # If eq is custom generated, we need to include the functions in globs
+    globs = {}
+
+    hash_def = "def __hash__(self"
+    hash_func = "hash(("
+    closing_braces = "))"
+    if not cache_hash:
+        hash_def += "):"
+    else:
+        hash_def += ", *"
+
+        hash_def += ", _cache_wrapper=__import__('attr._make')._make._CacheHashWrapper):"
+        hash_func = "_cache_wrapper(" + hash_func
+        closing_braces += ")"
+
+    method_lines = [hash_def]
+
+    def append_hash_computation_lines(prefix, indent):
+        """
+        Generate the code for actually computing the hash code.
+        Below this will either be returned directly or used to compute
+        a value which is then cached, depending on the value of cache_hash
+        """
+
+        method_lines.extend(
+            [
+                indent + prefix + hash_func,
+                indent + f"        {type_hash},",
+            ]
+        )
+
+        for a in attrs:
+            if a.eq_key:
+                cmp_name = f"_{a.name}_key"
+                globs[cmp_name] = a.eq_key
+                method_lines.append(
+                    indent + f"        {cmp_name}(self.{a.name}),"
+                )
+            else:
+                method_lines.append(indent + f"        self.{a.name},")
+
+        method_lines.append(indent + "    " + closing_braces)
+
+    if cache_hash:
+        method_lines.append(tab + f"if self.{_hash_cache_field} is None:")
+        if frozen:
+            append_hash_computation_lines(
+                f"object.__setattr__(self, '{_hash_cache_field}', ", tab * 2
+            )
+            method_lines.append(tab * 2 + ")")  # close __setattr__
+        else:
+            append_hash_computation_lines(
+                f"self.{_hash_cache_field} = ", tab * 2
+            )
+        method_lines.append(tab + f"return self.{_hash_cache_field}")
+    else:
+        append_hash_computation_lines("return ", tab)
+
+    script = "\n".join(method_lines)
+    return _make_method("__hash__", script, unique_filename, globs)
+
+
+def _add_hash(cls, attrs):
+    """
+    Add a hash method to *cls*.
+    """
+    cls.__hash__ = _make_hash(cls, attrs, frozen=False, cache_hash=False)
+    return cls
+
+
+def _make_ne():
+    """
+    Create __ne__ method.
+    """
+
+    def __ne__(self, other):
+        """
+        Check equality and either forward a NotImplemented or
+        return the result negated.
+        """
+        result = self.__eq__(other)
+        if result is NotImplemented:
+            return NotImplemented
+
+        return not result
+
+    return __ne__
+
+
+def _make_eq(cls, attrs):
+    """
+    Create __eq__ method for *cls* with *attrs*.
+    """
+    attrs = [a for a in attrs if a.eq]
+
+    unique_filename = _generate_unique_filename(cls, "eq")
+    lines = [
+        "def __eq__(self, other):",
+        "    if other.__class__ is not self.__class__:",
+        "        return NotImplemented",
+    ]
+
+    # We can't just do a big self.x = other.x and... clause due to
+    # irregularities like nan == nan is false but (nan,) == (nan,) is true.
+    globs = {}
+    if attrs:
+        lines.append("    return  (")
+        others = ["    ) == ("]
+        for a in attrs:
+            if a.eq_key:
+                cmp_name = f"_{a.name}_key"
+                # Add the key function to the global namespace
+                # of the evaluated function.
+                globs[cmp_name] = a.eq_key
+                lines.append(f"        {cmp_name}(self.{a.name}),")
+                others.append(f"        {cmp_name}(other.{a.name}),")
+            else:
+                lines.append(f"        self.{a.name},")
+                others.append(f"        other.{a.name},")
+
+        lines += [*others, "    )"]
+    else:
+        lines.append("    return True")
+
+    script = "\n".join(lines)
+
+    return _make_method("__eq__", script, unique_filename, globs)
+
+
+def _make_order(cls, attrs):
+    """
+    Create ordering methods for *cls* with *attrs*.
+    """
+    attrs = [a for a in attrs if a.order]
+
+    def attrs_to_tuple(obj):
+        """
+        Save us some typing.
+        """
+        return tuple(
+            key(value) if key else value
+            for value, key in (
+                (getattr(obj, a.name), a.order_key) for a in attrs
+            )
+        )
+
+    def __lt__(self, other):
+        """
+        Automatically created by attrs.
+        """
+        if other.__class__ is self.__class__:
+            return attrs_to_tuple(self) < attrs_to_tuple(other)
+
+        return NotImplemented
+
+    def __le__(self, other):
+        """
+        Automatically created by attrs.
+        """
+        if other.__class__ is self.__class__:
+            return attrs_to_tuple(self) <= attrs_to_tuple(other)
+
+        return NotImplemented
+
+    def __gt__(self, other):
+        """
+        Automatically created by attrs.
+        """
+        if other.__class__ is self.__class__:
+            return attrs_to_tuple(self) > attrs_to_tuple(other)
+
+        return NotImplemented
+
+    def __ge__(self, other):
+        """
+        Automatically created by attrs.
+        """
+        if other.__class__ is self.__class__:
+            return attrs_to_tuple(self) >= attrs_to_tuple(other)
+
+        return NotImplemented
+
+    return __lt__, __le__, __gt__, __ge__
+
+
+def _add_eq(cls, attrs=None):
+    """
+    Add equality methods to *cls* with *attrs*.
+    """
+    if attrs is None:
+        attrs = cls.__attrs_attrs__
+
+    cls.__eq__ = _make_eq(cls, attrs)
+    cls.__ne__ = _make_ne()
+
+    return cls
+
+
+def _make_repr(attrs, ns, cls):
+    unique_filename = _generate_unique_filename(cls, "repr")
+    # Figure out which attributes to include, and which function to use to
+    # format them. The a.repr value can be either bool or a custom
+    # callable.
+    attr_names_with_reprs = tuple(
+        (a.name, (repr if a.repr is True else a.repr), a.init)
+        for a in attrs
+        if a.repr is not False
+    )
+    globs = {
+        name + "_repr": r for name, r, _ in attr_names_with_reprs if r != repr
+    }
+    globs["_compat"] = _compat
+    globs["AttributeError"] = AttributeError
+    globs["NOTHING"] = NOTHING
+    attribute_fragments = []
+    for name, r, i in attr_names_with_reprs:
+        accessor = (
+            "self." + name if i else 'getattr(self, "' + name + '", NOTHING)'
+        )
+        fragment = (
+            "%s={%s!r}" % (name, accessor)
+            if r == repr
+            else "%s={%s_repr(%s)}" % (name, name, accessor)
+        )
+        attribute_fragments.append(fragment)
+    repr_fragment = ", ".join(attribute_fragments)
+
+    if ns is None:
+        cls_name_fragment = '{self.__class__.__qualname__.rsplit(">.", 1)[-1]}'
+    else:
+        cls_name_fragment = ns + ".{self.__class__.__name__}"
+
+    lines = [
+        "def __repr__(self):",
+        "  try:",
+        "    already_repring = _compat.repr_context.already_repring",
+        "  except AttributeError:",
+        "    already_repring = {id(self),}",
+        "    _compat.repr_context.already_repring = already_repring",
+        "  else:",
+        "    if id(self) in already_repring:",
+        "      return '...'",
+        "    else:",
+        "      already_repring.add(id(self))",
+        "  try:",
+        f"    return f'{cls_name_fragment}({repr_fragment})'",
+        "  finally:",
+        "    already_repring.remove(id(self))",
+    ]
+
+    return _make_method(
+        "__repr__", "\n".join(lines), unique_filename, globs=globs
+    )
+
+
+def _add_repr(cls, ns=None, attrs=None):
+    """
+    Add a repr method to *cls*.
+    """
+    if attrs is None:
+        attrs = cls.__attrs_attrs__
+
+    cls.__repr__ = _make_repr(attrs, ns, cls)
+    return cls
+
+
+def fields(cls):
+    """
+    Return the tuple of *attrs* attributes for a class.
+
+    The tuple also allows accessing the fields by their names (see below for
+    examples).
+
+    :param type cls: Class to introspect.
+
+    :raise TypeError: If *cls* is not a class.
+    :raise attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs*
+        class.
+
+    :rtype: tuple (with name accessors) of `attrs.Attribute`
+
+    .. versionchanged:: 16.2.0 Returned tuple allows accessing the fields
+       by name.
+    .. versionchanged:: 23.1.0 Add support for generic classes.
+    """
+    generic_base = get_generic_base(cls)
+
+    if generic_base is None and not isinstance(cls, type):
+        msg = "Passed object must be a class."
+        raise TypeError(msg)
+
+    attrs = getattr(cls, "__attrs_attrs__", None)
+
+    if attrs is None:
+        if generic_base is not None:
+            attrs = getattr(generic_base, "__attrs_attrs__", None)
+            if attrs is not None:
+                # Even though this is global state, stick it on here to speed
+                # it up. We rely on `cls` being cached for this to be
+                # efficient.
+                cls.__attrs_attrs__ = attrs
+                return attrs
+        msg = f"{cls!r} is not an attrs-decorated class."
+        raise NotAnAttrsClassError(msg)
+
+    return attrs
+
+
+def fields_dict(cls):
+    """
+    Return an ordered dictionary of *attrs* attributes for a class, whose
+    keys are the attribute names.
+
+    :param type cls: Class to introspect.
+
+    :raise TypeError: If *cls* is not a class.
+    :raise attrs.exceptions.NotAnAttrsClassError: If *cls* is not an *attrs*
+        class.
+
+    :rtype: dict
+
+    .. versionadded:: 18.1.0
+    """
+    if not isinstance(cls, type):
+        msg = "Passed object must be a class."
+        raise TypeError(msg)
+    attrs = getattr(cls, "__attrs_attrs__", None)
+    if attrs is None:
+        msg = f"{cls!r} is not an attrs-decorated class."
+        raise NotAnAttrsClassError(msg)
+    return {a.name: a for a in attrs}
+
+
+def validate(inst):
+    """
+    Validate all attributes on *inst* that have a validator.
+
+    Leaves all exceptions through.
+
+    :param inst: Instance of a class with *attrs* attributes.
+    """
+    if _config._run_validators is False:
+        return
+
+    for a in fields(inst.__class__):
+        v = a.validator
+        if v is not None:
+            v(inst, a, getattr(inst, a.name))
+
+
+def _is_slot_cls(cls):
+    return "__slots__" in cls.__dict__
+
+
+def _is_slot_attr(a_name, base_attr_map):
+    """
+    Check if the attribute name comes from a slot class.
+    """
+    return a_name in base_attr_map and _is_slot_cls(base_attr_map[a_name])
+
+
+def _make_init(
+    cls,
+    attrs,
+    pre_init,
+    pre_init_has_args,
+    post_init,
+    frozen,
+    slots,
+    cache_hash,
+    base_attr_map,
+    is_exc,
+    cls_on_setattr,
+    attrs_init,
+):
+    has_cls_on_setattr = (
+        cls_on_setattr is not None and cls_on_setattr is not setters.NO_OP
+    )
+
+    if frozen and has_cls_on_setattr:
+        msg = "Frozen classes can't use on_setattr."
+        raise ValueError(msg)
+
+    needs_cached_setattr = cache_hash or frozen
+    filtered_attrs = []
+    attr_dict = {}
+    for a in attrs:
+        if not a.init and a.default is NOTHING:
+            continue
+
+        filtered_attrs.append(a)
+        attr_dict[a.name] = a
+
+        if a.on_setattr is not None:
+            if frozen is True:
+                msg = "Frozen classes can't use on_setattr."
+                raise ValueError(msg)
+
+            needs_cached_setattr = True
+        elif has_cls_on_setattr and a.on_setattr is not setters.NO_OP:
+            needs_cached_setattr = True
+
+    unique_filename = _generate_unique_filename(cls, "init")
+
+    script, globs, annotations = _attrs_to_init_script(
+        filtered_attrs,
+        frozen,
+        slots,
+        pre_init,
+        pre_init_has_args,
+        post_init,
+        cache_hash,
+        base_attr_map,
+        is_exc,
+        needs_cached_setattr,
+        has_cls_on_setattr,
+        attrs_init,
+    )
+    if cls.__module__ in sys.modules:
+        # This makes typing.get_type_hints(CLS.__init__) resolve string types.
+        globs.update(sys.modules[cls.__module__].__dict__)
+
+    globs.update({"NOTHING": NOTHING, "attr_dict": attr_dict})
+
+    if needs_cached_setattr:
+        # Save the lookup overhead in __init__ if we need to circumvent
+        # setattr hooks.
+        globs["_cached_setattr_get"] = _obj_setattr.__get__
+
+    init = _make_method(
+        "__attrs_init__" if attrs_init else "__init__",
+        script,
+        unique_filename,
+        globs,
+    )
+    init.__annotations__ = annotations
+
+    return init
+
+
+def _setattr(attr_name, value_var, has_on_setattr):
+    """
+    Use the cached object.setattr to set *attr_name* to *value_var*.
+    """
+    return f"_setattr('{attr_name}', {value_var})"
+
+
+def _setattr_with_converter(attr_name, value_var, has_on_setattr):
+    """
+    Use the cached object.setattr to set *attr_name* to *value_var*, but run
+    its converter first.
+    """
+    return "_setattr('%s', %s(%s))" % (
+        attr_name,
+        _init_converter_pat % (attr_name,),
+        value_var,
+    )
+
+
+def _assign(attr_name, value, has_on_setattr):
+    """
+    Unless *attr_name* has an on_setattr hook, use normal assignment. Otherwise
+    relegate to _setattr.
+    """
+    if has_on_setattr:
+        return _setattr(attr_name, value, True)
+
+    return f"self.{attr_name} = {value}"
+
+
+def _assign_with_converter(attr_name, value_var, has_on_setattr):
+    """
+    Unless *attr_name* has an on_setattr hook, use normal assignment after
+    conversion. Otherwise relegate to _setattr_with_converter.
+    """
+    if has_on_setattr:
+        return _setattr_with_converter(attr_name, value_var, True)
+
+    return "self.%s = %s(%s)" % (
+        attr_name,
+        _init_converter_pat % (attr_name,),
+        value_var,
+    )
+
+
+def _attrs_to_init_script(
+    attrs,
+    frozen,
+    slots,
+    pre_init,
+    pre_init_has_args,
+    post_init,
+    cache_hash,
+    base_attr_map,
+    is_exc,
+    needs_cached_setattr,
+    has_cls_on_setattr,
+    attrs_init,
+):
+    """
+    Return a script of an initializer for *attrs* and a dict of globals.
+
+    The globals are expected by the generated script.
+
+    If *frozen* is True, we cannot set the attributes directly so we use
+    a cached ``object.__setattr__``.
+    """
+    lines = []
+    if pre_init:
+        lines.append("self.__attrs_pre_init__()")
+
+    if needs_cached_setattr:
+        lines.append(
+            # Circumvent the __setattr__ descriptor to save one lookup per
+            # assignment.
+            # Note _setattr will be used again below if cache_hash is True
+            "_setattr = _cached_setattr_get(self)"
+        )
+
+    if frozen is True:
+        if slots is True:
+            fmt_setter = _setattr
+            fmt_setter_with_converter = _setattr_with_converter
+        else:
+            # Dict frozen classes assign directly to __dict__.
+            # But only if the attribute doesn't come from an ancestor slot
+            # class.
+            # Note _inst_dict will be used again below if cache_hash is True
+            lines.append("_inst_dict = self.__dict__")
+
+            def fmt_setter(attr_name, value_var, has_on_setattr):
+                if _is_slot_attr(attr_name, base_attr_map):
+                    return _setattr(attr_name, value_var, has_on_setattr)
+
+                return f"_inst_dict['{attr_name}'] = {value_var}"
+
+            def fmt_setter_with_converter(
+                attr_name, value_var, has_on_setattr
+            ):
+                if has_on_setattr or _is_slot_attr(attr_name, base_attr_map):
+                    return _setattr_with_converter(
+                        attr_name, value_var, has_on_setattr
+                    )
+
+                return "_inst_dict['%s'] = %s(%s)" % (
+                    attr_name,
+                    _init_converter_pat % (attr_name,),
+                    value_var,
+                )
+
+    else:
+        # Not frozen.
+        fmt_setter = _assign
+        fmt_setter_with_converter = _assign_with_converter
+
+    args = []
+    kw_only_args = []
+    attrs_to_validate = []
+
+    # This is a dictionary of names to validator and converter callables.
+    # Injecting this into __init__ globals lets us avoid lookups.
+    names_for_globals = {}
+    annotations = {"return": None}
+
+    for a in attrs:
+        if a.validator:
+            attrs_to_validate.append(a)
+
+        attr_name = a.name
+        has_on_setattr = a.on_setattr is not None or (
+            a.on_setattr is not setters.NO_OP and has_cls_on_setattr
+        )
+        # a.alias is set to maybe-mangled attr_name in _ClassBuilder if not
+        # explicitly provided
+        arg_name = a.alias
+
+        has_factory = isinstance(a.default, Factory)
+        maybe_self = "self" if has_factory and a.default.takes_self else ""
+
+        if a.init is False:
+            if has_factory:
+                init_factory_name = _init_factory_pat % (a.name,)
+                if a.converter is not None:
+                    lines.append(
+                        fmt_setter_with_converter(
+                            attr_name,
+                            init_factory_name + f"({maybe_self})",
+                            has_on_setattr,
+                        )
+                    )
+                    conv_name = _init_converter_pat % (a.name,)
+                    names_for_globals[conv_name] = a.converter
+                else:
+                    lines.append(
+                        fmt_setter(
+                            attr_name,
+                            init_factory_name + f"({maybe_self})",
+                            has_on_setattr,
+                        )
+                    )
+                names_for_globals[init_factory_name] = a.default.factory
+            elif a.converter is not None:
+                lines.append(
+                    fmt_setter_with_converter(
+                        attr_name,
+                        f"attr_dict['{attr_name}'].default",
+                        has_on_setattr,
+                    )
+                )
+                conv_name = _init_converter_pat % (a.name,)
+                names_for_globals[conv_name] = a.converter
+            else:
+                lines.append(
+                    fmt_setter(
+                        attr_name,
+                        f"attr_dict['{attr_name}'].default",
+                        has_on_setattr,
+                    )
+                )
+        elif a.default is not NOTHING and not has_factory:
+            arg = f"{arg_name}=attr_dict['{attr_name}'].default"
+            if a.kw_only:
+                kw_only_args.append(arg)
+            else:
+                args.append(arg)
+
+            if a.converter is not None:
+                lines.append(
+                    fmt_setter_with_converter(
+                        attr_name, arg_name, has_on_setattr
+                    )
+                )
+                names_for_globals[
+                    _init_converter_pat % (a.name,)
+                ] = a.converter
+            else:
+                lines.append(fmt_setter(attr_name, arg_name, has_on_setattr))
+
+        elif has_factory:
+            arg = f"{arg_name}=NOTHING"
+            if a.kw_only:
+                kw_only_args.append(arg)
+            else:
+                args.append(arg)
+            lines.append(f"if {arg_name} is not NOTHING:")
+
+            init_factory_name = _init_factory_pat % (a.name,)
+            if a.converter is not None:
+                lines.append(
+                    "    "
+                    + fmt_setter_with_converter(
+                        attr_name, arg_name, has_on_setattr
+                    )
+                )
+                lines.append("else:")
+                lines.append(
+                    "    "
+                    + fmt_setter_with_converter(
+                        attr_name,
+                        init_factory_name + "(" + maybe_self + ")",
+                        has_on_setattr,
+                    )
+                )
+                names_for_globals[
+                    _init_converter_pat % (a.name,)
+                ] = a.converter
+            else:
+                lines.append(
+                    "    " + fmt_setter(attr_name, arg_name, has_on_setattr)
+                )
+                lines.append("else:")
+                lines.append(
+                    "    "
+                    + fmt_setter(
+                        attr_name,
+                        init_factory_name + "(" + maybe_self + ")",
+                        has_on_setattr,
+                    )
+                )
+            names_for_globals[init_factory_name] = a.default.factory
+        else:
+            if a.kw_only:
+                kw_only_args.append(arg_name)
+            else:
+                args.append(arg_name)
+
+            if a.converter is not None:
+                lines.append(
+                    fmt_setter_with_converter(
+                        attr_name, arg_name, has_on_setattr
+                    )
+                )
+                names_for_globals[
+                    _init_converter_pat % (a.name,)
+                ] = a.converter
+            else:
+                lines.append(fmt_setter(attr_name, arg_name, has_on_setattr))
+
+        if a.init is True:
+            if a.type is not None and a.converter is None:
+                annotations[arg_name] = a.type
+            elif a.converter is not None:
+                # Try to get the type from the converter.
+                t = _AnnotationExtractor(a.converter).get_first_param_type()
+                if t:
+                    annotations[arg_name] = t
+
+    if attrs_to_validate:  # we can skip this if there are no validators.
+        names_for_globals["_config"] = _config
+        lines.append("if _config._run_validators is True:")
+        for a in attrs_to_validate:
+            val_name = "__attr_validator_" + a.name
+            attr_name = "__attr_" + a.name
+            lines.append(f"    {val_name}(self, {attr_name}, self.{a.name})")
+            names_for_globals[val_name] = a.validator
+            names_for_globals[attr_name] = a
+
+    if post_init:
+        lines.append("self.__attrs_post_init__()")
+
+    # because this is set only after __attrs_post_init__ is called, a crash
+    # will result if post-init tries to access the hash code.  This seemed
+    # preferable to setting this beforehand, in which case alteration to
+    # field values during post-init combined with post-init accessing the
+    # hash code would result in silent bugs.
+    if cache_hash:
+        if frozen:
+            if slots:  # noqa: SIM108
+                # if frozen and slots, then _setattr defined above
+                init_hash_cache = "_setattr('%s', %s)"
+            else:
+                # if frozen and not slots, then _inst_dict defined above
+                init_hash_cache = "_inst_dict['%s'] = %s"
+        else:
+            init_hash_cache = "self.%s = %s"
+        lines.append(init_hash_cache % (_hash_cache_field, "None"))
+
+    # For exceptions we rely on BaseException.__init__ for proper
+    # initialization.
+    if is_exc:
+        vals = ",".join(f"self.{a.name}" for a in attrs if a.init)
+
+        lines.append(f"BaseException.__init__(self, {vals})")
+
+    args = ", ".join(args)
+    pre_init_args = args
+    if kw_only_args:
+        args += "%s*, %s" % (
+            ", " if args else "",  # leading comma
+            ", ".join(kw_only_args),  # kw_only args
+        )
+        pre_init_kw_only_args = ", ".join(
+            ["%s=%s" % (kw_arg, kw_arg) for kw_arg in kw_only_args]
+        )
+        pre_init_args += (
+            ", " if pre_init_args else ""
+        )  # handle only kwargs and no regular args
+        pre_init_args += pre_init_kw_only_args
+
+    if pre_init and pre_init_has_args:
+        # If pre init method has arguments, pass same arguments as `__init__`
+        lines[0] = "self.__attrs_pre_init__(%s)" % pre_init_args
+
+    return (
+        "def %s(self, %s):\n    %s\n"
+        % (
+            ("__attrs_init__" if attrs_init else "__init__"),
+            args,
+            "\n    ".join(lines) if lines else "pass",
+        ),
+        names_for_globals,
+        annotations,
+    )
+
+
+def _default_init_alias_for(name: str) -> str:
+    """
+    The default __init__ parameter name for a field.
+
+    This performs private-name adjustment via leading-unscore stripping,
+    and is the default value of Attribute.alias if not provided.
+    """
+
+    return name.lstrip("_")
+
+
+class Attribute:
+    """
+    *Read-only* representation of an attribute.
+
+    .. warning::
+
+       You should never instantiate this class yourself.
+
+    The class has *all* arguments of `attr.ib` (except for ``factory``
+    which is only syntactic sugar for ``default=Factory(...)`` plus the
+    following:
+
+    - ``name`` (`str`): The name of the attribute.
+    - ``alias`` (`str`): The __init__ parameter name of the attribute, after
+      any explicit overrides and default private-attribute-name handling.
+    - ``inherited`` (`bool`): Whether or not that attribute has been inherited
+      from a base class.
+    - ``eq_key`` and ``order_key`` (`typing.Callable` or `None`): The callables
+      that are used for comparing and ordering objects by this attribute,
+      respectively. These are set by passing a callable to `attr.ib`'s ``eq``,
+      ``order``, or ``cmp`` arguments. See also :ref:`comparison customization
+      <custom-comparison>`.
+
+    Instances of this class are frequently used for introspection purposes
+    like:
+
+    - `fields` returns a tuple of them.
+    - Validators get them passed as the first argument.
+    - The :ref:`field transformer <transform-fields>` hook receives a list of
+      them.
+    - The ``alias`` property exposes the __init__ parameter name of the field,
+      with any overrides and default private-attribute handling applied.
+
+
+    .. versionadded:: 20.1.0 *inherited*
+    .. versionadded:: 20.1.0 *on_setattr*
+    .. versionchanged:: 20.2.0 *inherited* is not taken into account for
+        equality checks and hashing anymore.
+    .. versionadded:: 21.1.0 *eq_key* and *order_key*
+    .. versionadded:: 22.2.0 *alias*
+
+    For the full version history of the fields, see `attr.ib`.
+    """
+
+    __slots__ = (
+        "name",
+        "default",
+        "validator",
+        "repr",
+        "eq",
+        "eq_key",
+        "order",
+        "order_key",
+        "hash",
+        "init",
+        "metadata",
+        "type",
+        "converter",
+        "kw_only",
+        "inherited",
+        "on_setattr",
+        "alias",
+    )
+
+    def __init__(
+        self,
+        name,
+        default,
+        validator,
+        repr,
+        cmp,  # XXX: unused, remove along with other cmp code.
+        hash,
+        init,
+        inherited,
+        metadata=None,
+        type=None,
+        converter=None,
+        kw_only=False,
+        eq=None,
+        eq_key=None,
+        order=None,
+        order_key=None,
+        on_setattr=None,
+        alias=None,
+    ):
+        eq, eq_key, order, order_key = _determine_attrib_eq_order(
+            cmp, eq_key or eq, order_key or order, True
+        )
+
+        # Cache this descriptor here to speed things up later.
+        bound_setattr = _obj_setattr.__get__(self)
+
+        # Despite the big red warning, people *do* instantiate `Attribute`
+        # themselves.
+        bound_setattr("name", name)
+        bound_setattr("default", default)
+        bound_setattr("validator", validator)
+        bound_setattr("repr", repr)
+        bound_setattr("eq", eq)
+        bound_setattr("eq_key", eq_key)
+        bound_setattr("order", order)
+        bound_setattr("order_key", order_key)
+        bound_setattr("hash", hash)
+        bound_setattr("init", init)
+        bound_setattr("converter", converter)
+        bound_setattr(
+            "metadata",
+            (
+                types.MappingProxyType(dict(metadata))  # Shallow copy
+                if metadata
+                else _empty_metadata_singleton
+            ),
+        )
+        bound_setattr("type", type)
+        bound_setattr("kw_only", kw_only)
+        bound_setattr("inherited", inherited)
+        bound_setattr("on_setattr", on_setattr)
+        bound_setattr("alias", alias)
+
+    def __setattr__(self, name, value):
+        raise FrozenInstanceError()
+
+    @classmethod
+    def from_counting_attr(cls, name, ca, type=None):
+        # type holds the annotated value. deal with conflicts:
+        if type is None:
+            type = ca.type
+        elif ca.type is not None:
+            msg = "Type annotation and type argument cannot both be present"
+            raise ValueError(msg)
+        inst_dict = {
+            k: getattr(ca, k)
+            for k in Attribute.__slots__
+            if k
+            not in (
+                "name",
+                "validator",
+                "default",
+                "type",
+                "inherited",
+            )  # exclude methods and deprecated alias
+        }
+        return cls(
+            name=name,
+            validator=ca._validator,
+            default=ca._default,
+            type=type,
+            cmp=None,
+            inherited=False,
+            **inst_dict,
+        )
+
+    # Don't use attrs.evolve since fields(Attribute) doesn't work
+    def evolve(self, **changes):
+        """
+        Copy *self* and apply *changes*.
+
+        This works similarly to `attrs.evolve` but that function does not work
+        with `Attribute`.
+
+        It is mainly meant to be used for `transform-fields`.
+
+        .. versionadded:: 20.3.0
+        """
+        new = copy.copy(self)
+
+        new._setattrs(changes.items())
+
+        return new
+
+    # Don't use _add_pickle since fields(Attribute) doesn't work
+    def __getstate__(self):
+        """
+        Play nice with pickle.
+        """
+        return tuple(
+            getattr(self, name) if name != "metadata" else dict(self.metadata)
+            for name in self.__slots__
+        )
+
+    def __setstate__(self, state):
+        """
+        Play nice with pickle.
+        """
+        self._setattrs(zip(self.__slots__, state))
+
+    def _setattrs(self, name_values_pairs):
+        bound_setattr = _obj_setattr.__get__(self)
+        for name, value in name_values_pairs:
+            if name != "metadata":
+                bound_setattr(name, value)
+            else:
+                bound_setattr(
+                    name,
+                    types.MappingProxyType(dict(value))
+                    if value
+                    else _empty_metadata_singleton,
+                )
+
+
+_a = [
+    Attribute(
+        name=name,
+        default=NOTHING,
+        validator=None,
+        repr=True,
+        cmp=None,
+        eq=True,
+        order=False,
+        hash=(name != "metadata"),
+        init=True,
+        inherited=False,
+        alias=_default_init_alias_for(name),
+    )
+    for name in Attribute.__slots__
+]
+
+Attribute = _add_hash(
+    _add_eq(
+        _add_repr(Attribute, attrs=_a),
+        attrs=[a for a in _a if a.name != "inherited"],
+    ),
+    attrs=[a for a in _a if a.hash and a.name != "inherited"],
+)
+
+
+class _CountingAttr:
+    """
+    Intermediate representation of attributes that uses a counter to preserve
+    the order in which the attributes have been defined.
+
+    *Internal* data structure of the attrs library.  Running into is most
+    likely the result of a bug like a forgotten `@attr.s` decorator.
+    """
+
+    __slots__ = (
+        "counter",
+        "_default",
+        "repr",
+        "eq",
+        "eq_key",
+        "order",
+        "order_key",
+        "hash",
+        "init",
+        "metadata",
+        "_validator",
+        "converter",
+        "type",
+        "kw_only",
+        "on_setattr",
+        "alias",
+    )
+    __attrs_attrs__ = (
+        *tuple(
+            Attribute(
+                name=name,
+                alias=_default_init_alias_for(name),
+                default=NOTHING,
+                validator=None,
+                repr=True,
+                cmp=None,
+                hash=True,
+                init=True,
+                kw_only=False,
+                eq=True,
+                eq_key=None,
+                order=False,
+                order_key=None,
+                inherited=False,
+                on_setattr=None,
+            )
+            for name in (
+                "counter",
+                "_default",
+                "repr",
+                "eq",
+                "order",
+                "hash",
+                "init",
+                "on_setattr",
+                "alias",
+            )
+        ),
+        Attribute(
+            name="metadata",
+            alias="metadata",
+            default=None,
+            validator=None,
+            repr=True,
+            cmp=None,
+            hash=False,
+            init=True,
+            kw_only=False,
+            eq=True,
+            eq_key=None,
+            order=False,
+            order_key=None,
+            inherited=False,
+            on_setattr=None,
+        ),
+    )
+    cls_counter = 0
+
+    def __init__(
+        self,
+        default,
+        validator,
+        repr,
+        cmp,
+        hash,
+        init,
+        converter,
+        metadata,
+        type,
+        kw_only,
+        eq,
+        eq_key,
+        order,
+        order_key,
+        on_setattr,
+        alias,
+    ):
+        _CountingAttr.cls_counter += 1
+        self.counter = _CountingAttr.cls_counter
+        self._default = default
+        self._validator = validator
+        self.converter = converter
+        self.repr = repr
+        self.eq = eq
+        self.eq_key = eq_key
+        self.order = order
+        self.order_key = order_key
+        self.hash = hash
+        self.init = init
+        self.metadata = metadata
+        self.type = type
+        self.kw_only = kw_only
+        self.on_setattr = on_setattr
+        self.alias = alias
+
+    def validator(self, meth):
+        """
+        Decorator that adds *meth* to the list of validators.
+
+        Returns *meth* unchanged.
+
+        .. versionadded:: 17.1.0
+        """
+        if self._validator is None:
+            self._validator = meth
+        else:
+            self._validator = and_(self._validator, meth)
+        return meth
+
+    def default(self, meth):
+        """
+        Decorator that allows to set the default for an attribute.
+
+        Returns *meth* unchanged.
+
+        :raises DefaultAlreadySetError: If default has been set before.
+
+        .. versionadded:: 17.1.0
+        """
+        if self._default is not NOTHING:
+            raise DefaultAlreadySetError()
+
+        self._default = Factory(meth, takes_self=True)
+
+        return meth
+
+
+_CountingAttr = _add_eq(_add_repr(_CountingAttr))
+
+
+class Factory:
+    """
+    Stores a factory callable.
+
+    If passed as the default value to `attrs.field`, the factory is used to
+    generate a new value.
+
+    :param callable factory: A callable that takes either none or exactly one
+        mandatory positional argument depending on *takes_self*.
+    :param bool takes_self: Pass the partially initialized instance that is
+        being initialized as a positional argument.
+
+    .. versionadded:: 17.1.0  *takes_self*
+    """
+
+    __slots__ = ("factory", "takes_self")
+
+    def __init__(self, factory, takes_self=False):
+        self.factory = factory
+        self.takes_self = takes_self
+
+    def __getstate__(self):
+        """
+        Play nice with pickle.
+        """
+        return tuple(getattr(self, name) for name in self.__slots__)
+
+    def __setstate__(self, state):
+        """
+        Play nice with pickle.
+        """
+        for name, value in zip(self.__slots__, state):
+            setattr(self, name, value)
+
+
+_f = [
+    Attribute(
+        name=name,
+        default=NOTHING,
+        validator=None,
+        repr=True,
+        cmp=None,
+        eq=True,
+        order=False,
+        hash=True,
+        init=True,
+        inherited=False,
+    )
+    for name in Factory.__slots__
+]
+
+Factory = _add_hash(_add_eq(_add_repr(Factory, attrs=_f), attrs=_f), attrs=_f)
+
+
+def make_class(
+    name, attrs, bases=(object,), class_body=None, **attributes_arguments
+):
+    r"""
+    A quick way to create a new class called *name* with *attrs*.
+
+    :param str name: The name for the new class.
+
+    :param attrs: A list of names or a dictionary of mappings of names to
+        `attr.ib`\ s / `attrs.field`\ s.
+
+        The order is deduced from the order of the names or attributes inside
+        *attrs*.  Otherwise the order of the definition of the attributes is
+        used.
+    :type attrs: `list` or `dict`
+
+    :param tuple bases: Classes that the new class will subclass.
+
+    :param dict class_body: An optional dictionary of class attributes for the new class.
+
+    :param attributes_arguments: Passed unmodified to `attr.s`.
+
+    :return: A new class with *attrs*.
+    :rtype: type
+
+    .. versionadded:: 17.1.0 *bases*
+    .. versionchanged:: 18.1.0 If *attrs* is ordered, the order is retained.
+    .. versionchanged:: 23.2.0 *class_body*
+    """
+    if isinstance(attrs, dict):
+        cls_dict = attrs
+    elif isinstance(attrs, (list, tuple)):
+        cls_dict = {a: attrib() for a in attrs}
+    else:
+        msg = "attrs argument must be a dict or a list."
+        raise TypeError(msg)
+
+    pre_init = cls_dict.pop("__attrs_pre_init__", None)
+    post_init = cls_dict.pop("__attrs_post_init__", None)
+    user_init = cls_dict.pop("__init__", None)
+
+    body = {}
+    if class_body is not None:
+        body.update(class_body)
+    if pre_init is not None:
+        body["__attrs_pre_init__"] = pre_init
+    if post_init is not None:
+        body["__attrs_post_init__"] = post_init
+    if user_init is not None:
+        body["__init__"] = user_init
+
+    type_ = types.new_class(name, bases, {}, lambda ns: ns.update(body))
+
+    # For pickling to work, the __module__ variable needs to be set to the
+    # frame where the class is created.  Bypass this step in environments where
+    # sys._getframe is not defined (Jython for example) or sys._getframe is not
+    # defined for arguments greater than 0 (IronPython).
+    with contextlib.suppress(AttributeError, ValueError):
+        type_.__module__ = sys._getframe(1).f_globals.get(
+            "__name__", "__main__"
+        )
+
+    # We do it here for proper warnings with meaningful stacklevel.
+    cmp = attributes_arguments.pop("cmp", None)
+    (
+        attributes_arguments["eq"],
+        attributes_arguments["order"],
+    ) = _determine_attrs_eq_order(
+        cmp,
+        attributes_arguments.get("eq"),
+        attributes_arguments.get("order"),
+        True,
+    )
+
+    return _attrs(these=cls_dict, **attributes_arguments)(type_)
+
+
+# These are required by within this module so we define them here and merely
+# import into .validators / .converters.
+
+
+@attrs(slots=True, hash=True)
+class _AndValidator:
+    """
+    Compose many validators to a single one.
+    """
+
+    _validators = attrib()
+
+    def __call__(self, inst, attr, value):
+        for v in self._validators:
+            v(inst, attr, value)
+
+
+def and_(*validators):
+    """
+    A validator that composes multiple validators into one.
+
+    When called on a value, it runs all wrapped validators.
+
+    :param callables validators: Arbitrary number of validators.
+
+    .. versionadded:: 17.1.0
+    """
+    vals = []
+    for validator in validators:
+        vals.extend(
+            validator._validators
+            if isinstance(validator, _AndValidator)
+            else [validator]
+        )
+
+    return _AndValidator(tuple(vals))
+
+
+def pipe(*converters):
+    """
+    A converter that composes multiple converters into one.
+
+    When called on a value, it runs all wrapped converters, returning the
+    *last* value.
+
+    Type annotations will be inferred from the wrapped converters', if
+    they have any.
+
+    :param callables converters: Arbitrary number of converters.
+
+    .. versionadded:: 20.1.0
+    """
+
+    def pipe_converter(val):
+        for converter in converters:
+            val = converter(val)
+
+        return val
+
+    if not converters:
+        # If the converter list is empty, pipe_converter is the identity.
+        A = typing.TypeVar("A")
+        pipe_converter.__annotations__ = {"val": A, "return": A}
+    else:
+        # Get parameter type from first converter.
+        t = _AnnotationExtractor(converters[0]).get_first_param_type()
+        if t:
+            pipe_converter.__annotations__["val"] = t
+
+        # Get return type from last converter.
+        rt = _AnnotationExtractor(converters[-1]).get_return_type()
+        if rt:
+            pipe_converter.__annotations__["return"] = rt
+
+    return pipe_converter
diff --git a/llm/Lib/site-packages/attr/_next_gen.py b/llm/Lib/site-packages/attr/_next_gen.py
new file mode 100644
index 0000000000000000000000000000000000000000..1fb9f259b53b851336c3135f06cfa377ab3240d7
--- /dev/null
+++ b/llm/Lib/site-packages/attr/_next_gen.py
@@ -0,0 +1,229 @@
+# SPDX-License-Identifier: MIT
+
+"""
+These are keyword-only APIs that call `attr.s` and `attr.ib` with different
+default values.
+"""
+
+
+from functools import partial
+
+from . import setters
+from ._funcs import asdict as _asdict
+from ._funcs import astuple as _astuple
+from ._make import (
+    NOTHING,
+    _frozen_setattrs,
+    _ng_default_on_setattr,
+    attrib,
+    attrs,
+)
+from .exceptions import UnannotatedAttributeError
+
+
+def define(
+    maybe_cls=None,
+    *,
+    these=None,
+    repr=None,
+    unsafe_hash=None,
+    hash=None,
+    init=None,
+    slots=True,
+    frozen=False,
+    weakref_slot=True,
+    str=False,
+    auto_attribs=None,
+    kw_only=False,
+    cache_hash=False,
+    auto_exc=True,
+    eq=None,
+    order=False,
+    auto_detect=True,
+    getstate_setstate=None,
+    on_setattr=None,
+    field_transformer=None,
+    match_args=True,
+):
+    r"""
+    Define an *attrs* class.
+
+    Differences to the classic `attr.s` that it uses underneath:
+
+    - Automatically detect whether or not *auto_attribs* should be `True` (c.f.
+      *auto_attribs* parameter).
+    - Converters and validators run when attributes are set by default -- if
+      *frozen* is `False`.
+    - *slots=True*
+
+      .. caution::
+
+         Usually this has only upsides and few visible effects in everyday
+         programming. But it *can* lead to some surprising behaviors, so please
+         make sure to read :term:`slotted classes`.
+    - *auto_exc=True*
+    - *auto_detect=True*
+    - *order=False*
+    - Some options that were only relevant on Python 2 or were kept around for
+      backwards-compatibility have been removed.
+
+    Please note that these are all defaults and you can change them as you
+    wish.
+
+    :param Optional[bool] auto_attribs: If set to `True` or `False`, it behaves
+       exactly like `attr.s`. If left `None`, `attr.s` will try to guess:
+
+       1. If any attributes are annotated and no unannotated `attrs.fields`\ s
+          are found, it assumes *auto_attribs=True*.
+       2. Otherwise it assumes *auto_attribs=False* and tries to collect
+          `attrs.fields`\ s.
+
+    For now, please refer to `attr.s` for the rest of the parameters.
+
+    .. versionadded:: 20.1.0
+    .. versionchanged:: 21.3.0 Converters are also run ``on_setattr``.
+    .. versionadded:: 22.2.0
+       *unsafe_hash* as an alias for *hash* (for :pep:`681` compliance).
+    """
+
+    def do_it(cls, auto_attribs):
+        return attrs(
+            maybe_cls=cls,
+            these=these,
+            repr=repr,
+            hash=hash,
+            unsafe_hash=unsafe_hash,
+            init=init,
+            slots=slots,
+            frozen=frozen,
+            weakref_slot=weakref_slot,
+            str=str,
+            auto_attribs=auto_attribs,
+            kw_only=kw_only,
+            cache_hash=cache_hash,
+            auto_exc=auto_exc,
+            eq=eq,
+            order=order,
+            auto_detect=auto_detect,
+            collect_by_mro=True,
+            getstate_setstate=getstate_setstate,
+            on_setattr=on_setattr,
+            field_transformer=field_transformer,
+            match_args=match_args,
+        )
+
+    def wrap(cls):
+        """
+        Making this a wrapper ensures this code runs during class creation.
+
+        We also ensure that frozen-ness of classes is inherited.
+        """
+        nonlocal frozen, on_setattr
+
+        had_on_setattr = on_setattr not in (None, setters.NO_OP)
+
+        # By default, mutable classes convert & validate on setattr.
+        if frozen is False and on_setattr is None:
+            on_setattr = _ng_default_on_setattr
+
+        # However, if we subclass a frozen class, we inherit the immutability
+        # and disable on_setattr.
+        for base_cls in cls.__bases__:
+            if base_cls.__setattr__ is _frozen_setattrs:
+                if had_on_setattr:
+                    msg = "Frozen classes can't use on_setattr (frozen-ness was inherited)."
+                    raise ValueError(msg)
+
+                on_setattr = setters.NO_OP
+                break
+
+        if auto_attribs is not None:
+            return do_it(cls, auto_attribs)
+
+        try:
+            return do_it(cls, True)
+        except UnannotatedAttributeError:
+            return do_it(cls, False)
+
+    # maybe_cls's type depends on the usage of the decorator.  It's a class
+    # if it's used as `@attrs` but ``None`` if used as `@attrs()`.
+    if maybe_cls is None:
+        return wrap
+
+    return wrap(maybe_cls)
+
+
+mutable = define
+frozen = partial(define, frozen=True, on_setattr=None)
+
+
+def field(
+    *,
+    default=NOTHING,
+    validator=None,
+    repr=True,
+    hash=None,
+    init=True,
+    metadata=None,
+    type=None,
+    converter=None,
+    factory=None,
+    kw_only=False,
+    eq=None,
+    order=None,
+    on_setattr=None,
+    alias=None,
+):
+    """
+    Identical to `attr.ib`, except keyword-only and with some arguments
+    removed.
+
+    .. versionadded:: 23.1.0
+       The *type* parameter has been re-added; mostly for `attrs.make_class`.
+       Please note that type checkers ignore this metadata.
+    .. versionadded:: 20.1.0
+    """
+    return attrib(
+        default=default,
+        validator=validator,
+        repr=repr,
+        hash=hash,
+        init=init,
+        metadata=metadata,
+        type=type,
+        converter=converter,
+        factory=factory,
+        kw_only=kw_only,
+        eq=eq,
+        order=order,
+        on_setattr=on_setattr,
+        alias=alias,
+    )
+
+
+def asdict(inst, *, recurse=True, filter=None, value_serializer=None):
+    """
+    Same as `attr.asdict`, except that collections types are always retained
+    and dict is always used as *dict_factory*.
+
+    .. versionadded:: 21.3.0
+    """
+    return _asdict(
+        inst=inst,
+        recurse=recurse,
+        filter=filter,
+        value_serializer=value_serializer,
+        retain_collection_types=True,
+    )
+
+
+def astuple(inst, *, recurse=True, filter=None):
+    """
+    Same as `attr.astuple`, except that collections types are always retained
+    and `tuple` is always used as the *tuple_factory*.
+
+    .. versionadded:: 21.3.0
+    """
+    return _astuple(
+        inst=inst, recurse=recurse, filter=filter, retain_collection_types=True
+    )
diff --git a/llm/Lib/site-packages/attr/_typing_compat.pyi b/llm/Lib/site-packages/attr/_typing_compat.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..ca7b71e906a28f88726bbd342fdfe636af0281e7
--- /dev/null
+++ b/llm/Lib/site-packages/attr/_typing_compat.pyi
@@ -0,0 +1,15 @@
+from typing import Any, ClassVar, Protocol
+
+# MYPY is a special constant in mypy which works the same way as `TYPE_CHECKING`.
+MYPY = False
+
+if MYPY:
+    # A protocol to be able to statically accept an attrs class.
+    class AttrsInstance_(Protocol):
+        __attrs_attrs__: ClassVar[Any]
+
+else:
+    # For type checkers without plug-in support use an empty protocol that
+    # will (hopefully) be combined into a union.
+    class AttrsInstance_(Protocol):
+        pass
diff --git a/llm/Lib/site-packages/attr/_version_info.py b/llm/Lib/site-packages/attr/_version_info.py
new file mode 100644
index 0000000000000000000000000000000000000000..51a1312f9759f21063caea779a62882d7f7c86ae
--- /dev/null
+++ b/llm/Lib/site-packages/attr/_version_info.py
@@ -0,0 +1,86 @@
+# SPDX-License-Identifier: MIT
+
+
+from functools import total_ordering
+
+from ._funcs import astuple
+from ._make import attrib, attrs
+
+
+@total_ordering
+@attrs(eq=False, order=False, slots=True, frozen=True)
+class VersionInfo:
+    """
+    A version object that can be compared to tuple of length 1--4:
+
+    >>> attr.VersionInfo(19, 1, 0, "final")  <= (19, 2)
+    True
+    >>> attr.VersionInfo(19, 1, 0, "final") < (19, 1, 1)
+    True
+    >>> vi = attr.VersionInfo(19, 2, 0, "final")
+    >>> vi < (19, 1, 1)
+    False
+    >>> vi < (19,)
+    False
+    >>> vi == (19, 2,)
+    True
+    >>> vi == (19, 2, 1)
+    False
+
+    .. versionadded:: 19.2
+    """
+
+    year = attrib(type=int)
+    minor = attrib(type=int)
+    micro = attrib(type=int)
+    releaselevel = attrib(type=str)
+
+    @classmethod
+    def _from_version_string(cls, s):
+        """
+        Parse *s* and return a _VersionInfo.
+        """
+        v = s.split(".")
+        if len(v) == 3:
+            v.append("final")
+
+        return cls(
+            year=int(v[0]), minor=int(v[1]), micro=int(v[2]), releaselevel=v[3]
+        )
+
+    def _ensure_tuple(self, other):
+        """
+        Ensure *other* is a tuple of a valid length.
+
+        Returns a possibly transformed *other* and ourselves as a tuple of
+        the same length as *other*.
+        """
+
+        if self.__class__ is other.__class__:
+            other = astuple(other)
+
+        if not isinstance(other, tuple):
+            raise NotImplementedError
+
+        if not (1 <= len(other) <= 4):
+            raise NotImplementedError
+
+        return astuple(self)[: len(other)], other
+
+    def __eq__(self, other):
+        try:
+            us, them = self._ensure_tuple(other)
+        except NotImplementedError:
+            return NotImplemented
+
+        return us == them
+
+    def __lt__(self, other):
+        try:
+            us, them = self._ensure_tuple(other)
+        except NotImplementedError:
+            return NotImplemented
+
+        # Since alphabetically "dev0" < "final" < "post1" < "post2", we don't
+        # have to do anything special with releaselevel for now.
+        return us < them
diff --git a/llm/Lib/site-packages/attr/_version_info.pyi b/llm/Lib/site-packages/attr/_version_info.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..45ced086337783c4b73b26cd17d2c1c260e24029
--- /dev/null
+++ b/llm/Lib/site-packages/attr/_version_info.pyi
@@ -0,0 +1,9 @@
+class VersionInfo:
+    @property
+    def year(self) -> int: ...
+    @property
+    def minor(self) -> int: ...
+    @property
+    def micro(self) -> int: ...
+    @property
+    def releaselevel(self) -> str: ...
diff --git a/llm/Lib/site-packages/attr/converters.py b/llm/Lib/site-packages/attr/converters.py
new file mode 100644
index 0000000000000000000000000000000000000000..2bf4c902a66faeeda4cbae89d75f063df99c5039
--- /dev/null
+++ b/llm/Lib/site-packages/attr/converters.py
@@ -0,0 +1,144 @@
+# SPDX-License-Identifier: MIT
+
+"""
+Commonly useful converters.
+"""
+
+
+import typing
+
+from ._compat import _AnnotationExtractor
+from ._make import NOTHING, Factory, pipe
+
+
+__all__ = [
+    "default_if_none",
+    "optional",
+    "pipe",
+    "to_bool",
+]
+
+
+def optional(converter):
+    """
+    A converter that allows an attribute to be optional. An optional attribute
+    is one which can be set to ``None``.
+
+    Type annotations will be inferred from the wrapped converter's, if it
+    has any.
+
+    :param callable converter: the converter that is used for non-``None``
+        values.
+
+    .. versionadded:: 17.1.0
+    """
+
+    def optional_converter(val):
+        if val is None:
+            return None
+        return converter(val)
+
+    xtr = _AnnotationExtractor(converter)
+
+    t = xtr.get_first_param_type()
+    if t:
+        optional_converter.__annotations__["val"] = typing.Optional[t]
+
+    rt = xtr.get_return_type()
+    if rt:
+        optional_converter.__annotations__["return"] = typing.Optional[rt]
+
+    return optional_converter
+
+
+def default_if_none(default=NOTHING, factory=None):
+    """
+    A converter that allows to replace ``None`` values by *default* or the
+    result of *factory*.
+
+    :param default: Value to be used if ``None`` is passed. Passing an instance
+       of `attrs.Factory` is supported, however the ``takes_self`` option
+       is *not*.
+    :param callable factory: A callable that takes no parameters whose result
+       is used if ``None`` is passed.
+
+    :raises TypeError: If **neither** *default* or *factory* is passed.
+    :raises TypeError: If **both** *default* and *factory* are passed.
+    :raises ValueError: If an instance of `attrs.Factory` is passed with
+       ``takes_self=True``.
+
+    .. versionadded:: 18.2.0
+    """
+    if default is NOTHING and factory is None:
+        msg = "Must pass either `default` or `factory`."
+        raise TypeError(msg)
+
+    if default is not NOTHING and factory is not None:
+        msg = "Must pass either `default` or `factory` but not both."
+        raise TypeError(msg)
+
+    if factory is not None:
+        default = Factory(factory)
+
+    if isinstance(default, Factory):
+        if default.takes_self:
+            msg = "`takes_self` is not supported by default_if_none."
+            raise ValueError(msg)
+
+        def default_if_none_converter(val):
+            if val is not None:
+                return val
+
+            return default.factory()
+
+    else:
+
+        def default_if_none_converter(val):
+            if val is not None:
+                return val
+
+            return default
+
+    return default_if_none_converter
+
+
+def to_bool(val):
+    """
+    Convert "boolean" strings (e.g., from env. vars.) to real booleans.
+
+    Values mapping to :code:`True`:
+
+    - :code:`True`
+    - :code:`"true"` / :code:`"t"`
+    - :code:`"yes"` / :code:`"y"`
+    - :code:`"on"`
+    - :code:`"1"`
+    - :code:`1`
+
+    Values mapping to :code:`False`:
+
+    - :code:`False`
+    - :code:`"false"` / :code:`"f"`
+    - :code:`"no"` / :code:`"n"`
+    - :code:`"off"`
+    - :code:`"0"`
+    - :code:`0`
+
+    :raises ValueError: for any other value.
+
+    .. versionadded:: 21.3.0
+    """
+    if isinstance(val, str):
+        val = val.lower()
+    truthy = {True, "true", "t", "yes", "y", "on", "1", 1}
+    falsy = {False, "false", "f", "no", "n", "off", "0", 0}
+    try:
+        if val in truthy:
+            return True
+        if val in falsy:
+            return False
+    except TypeError:
+        # Raised when "val" is not hashable (e.g., lists)
+        pass
+    msg = f"Cannot convert value to bool: {val}"
+    raise ValueError(msg)
diff --git a/llm/Lib/site-packages/attr/converters.pyi b/llm/Lib/site-packages/attr/converters.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..5abb49f6d5a8c3447d0f223a308e2278ad027416
--- /dev/null
+++ b/llm/Lib/site-packages/attr/converters.pyi
@@ -0,0 +1,13 @@
+from typing import Callable, TypeVar, overload
+
+from . import _ConverterType
+
+_T = TypeVar("_T")
+
+def pipe(*validators: _ConverterType) -> _ConverterType: ...
+def optional(converter: _ConverterType) -> _ConverterType: ...
+@overload
+def default_if_none(default: _T) -> _ConverterType: ...
+@overload
+def default_if_none(*, factory: Callable[[], _T]) -> _ConverterType: ...
+def to_bool(val: str) -> bool: ...
diff --git a/llm/Lib/site-packages/attr/exceptions.py b/llm/Lib/site-packages/attr/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b7abb8154108aa1d0ae52fa9ee8e489f05b5563
--- /dev/null
+++ b/llm/Lib/site-packages/attr/exceptions.py
@@ -0,0 +1,95 @@
+# SPDX-License-Identifier: MIT
+
+from __future__ import annotations
+
+from typing import ClassVar
+
+
+class FrozenError(AttributeError):
+    """
+    A frozen/immutable instance or attribute have been attempted to be
+    modified.
+
+    It mirrors the behavior of ``namedtuples`` by using the same error message
+    and subclassing `AttributeError`.
+
+    .. versionadded:: 20.1.0
+    """
+
+    msg = "can't set attribute"
+    args: ClassVar[tuple[str]] = [msg]
+
+
+class FrozenInstanceError(FrozenError):
+    """
+    A frozen instance has been attempted to be modified.
+
+    .. versionadded:: 16.1.0
+    """
+
+
+class FrozenAttributeError(FrozenError):
+    """
+    A frozen attribute has been attempted to be modified.
+
+    .. versionadded:: 20.1.0
+    """
+
+
+class AttrsAttributeNotFoundError(ValueError):
+    """
+    An *attrs* function couldn't find an attribute that the user asked for.
+
+    .. versionadded:: 16.2.0
+    """
+
+
+class NotAnAttrsClassError(ValueError):
+    """
+    A non-*attrs* class has been passed into an *attrs* function.
+
+    .. versionadded:: 16.2.0
+    """
+
+
+class DefaultAlreadySetError(RuntimeError):
+    """
+    A default has been set when defining the field and is attempted to be reset
+    using the decorator.
+
+    .. versionadded:: 17.1.0
+    """
+
+
+class UnannotatedAttributeError(RuntimeError):
+    """
+    A class with ``auto_attribs=True`` has a field without a type annotation.
+
+    .. versionadded:: 17.3.0
+    """
+
+
+class PythonTooOldError(RuntimeError):
+    """
+    It was attempted to use an *attrs* feature that requires a newer Python
+    version.
+
+    .. versionadded:: 18.2.0
+    """
+
+
+class NotCallableError(TypeError):
+    """
+    A field requiring a callable has been set with a value that is not
+    callable.
+
+    .. versionadded:: 19.2.0
+    """
+
+    def __init__(self, msg, value):
+        super(TypeError, self).__init__(msg, value)
+        self.msg = msg
+        self.value = value
+
+    def __str__(self):
+        return str(self.msg)
diff --git a/llm/Lib/site-packages/attr/exceptions.pyi b/llm/Lib/site-packages/attr/exceptions.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..f2680118b404db8f5227d04d27e8439331341c4d
--- /dev/null
+++ b/llm/Lib/site-packages/attr/exceptions.pyi
@@ -0,0 +1,17 @@
+from typing import Any
+
+class FrozenError(AttributeError):
+    msg: str = ...
+
+class FrozenInstanceError(FrozenError): ...
+class FrozenAttributeError(FrozenError): ...
+class AttrsAttributeNotFoundError(ValueError): ...
+class NotAnAttrsClassError(ValueError): ...
+class DefaultAlreadySetError(RuntimeError): ...
+class UnannotatedAttributeError(RuntimeError): ...
+class PythonTooOldError(RuntimeError): ...
+
+class NotCallableError(TypeError):
+    msg: str = ...
+    value: Any = ...
+    def __init__(self, msg: str, value: Any) -> None: ...
diff --git a/llm/Lib/site-packages/attr/filters.py b/llm/Lib/site-packages/attr/filters.py
new file mode 100644
index 0000000000000000000000000000000000000000..a1e40c98db853aa375ab0b24559e0559f91e6152
--- /dev/null
+++ b/llm/Lib/site-packages/attr/filters.py
@@ -0,0 +1,66 @@
+# SPDX-License-Identifier: MIT
+
+"""
+Commonly useful filters for `attr.asdict`.
+"""
+
+from ._make import Attribute
+
+
+def _split_what(what):
+    """
+    Returns a tuple of `frozenset`s of classes and attributes.
+    """
+    return (
+        frozenset(cls for cls in what if isinstance(cls, type)),
+        frozenset(cls for cls in what if isinstance(cls, str)),
+        frozenset(cls for cls in what if isinstance(cls, Attribute)),
+    )
+
+
+def include(*what):
+    """
+    Include *what*.
+
+    :param what: What to include.
+    :type what: `list` of classes `type`, field names `str` or
+        `attrs.Attribute`\\ s
+
+    :rtype: `callable`
+
+    .. versionchanged:: 23.1.0 Accept strings with field names.
+    """
+    cls, names, attrs = _split_what(what)
+
+    def include_(attribute, value):
+        return (
+            value.__class__ in cls
+            or attribute.name in names
+            or attribute in attrs
+        )
+
+    return include_
+
+
+def exclude(*what):
+    """
+    Exclude *what*.
+
+    :param what: What to exclude.
+    :type what: `list` of classes `type`, field names `str` or
+        `attrs.Attribute`\\ s.
+
+    :rtype: `callable`
+
+    .. versionchanged:: 23.3.0 Accept field name string as input argument
+    """
+    cls, names, attrs = _split_what(what)
+
+    def exclude_(attribute, value):
+        return not (
+            value.__class__ in cls
+            or attribute.name in names
+            or attribute in attrs
+        )
+
+    return exclude_
diff --git a/llm/Lib/site-packages/attr/filters.pyi b/llm/Lib/site-packages/attr/filters.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..8a02fa0fc0631dde0b4501c8d1c168b467c0d1a9
--- /dev/null
+++ b/llm/Lib/site-packages/attr/filters.pyi
@@ -0,0 +1,6 @@
+from typing import Any, Union
+
+from . import Attribute, _FilterType
+
+def include(*what: Union[type, str, Attribute[Any]]) -> _FilterType[Any]: ...
+def exclude(*what: Union[type, str, Attribute[Any]]) -> _FilterType[Any]: ...
diff --git a/llm/Lib/site-packages/attr/py.typed b/llm/Lib/site-packages/attr/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/attr/setters.py b/llm/Lib/site-packages/attr/setters.py
new file mode 100644
index 0000000000000000000000000000000000000000..12ed6750df35b96e2ccde24a9752dca22929188d
--- /dev/null
+++ b/llm/Lib/site-packages/attr/setters.py
@@ -0,0 +1,73 @@
+# SPDX-License-Identifier: MIT
+
+"""
+Commonly used hooks for on_setattr.
+"""
+
+
+from . import _config
+from .exceptions import FrozenAttributeError
+
+
+def pipe(*setters):
+    """
+    Run all *setters* and return the return value of the last one.
+
+    .. versionadded:: 20.1.0
+    """
+
+    def wrapped_pipe(instance, attrib, new_value):
+        rv = new_value
+
+        for setter in setters:
+            rv = setter(instance, attrib, rv)
+
+        return rv
+
+    return wrapped_pipe
+
+
+def frozen(_, __, ___):
+    """
+    Prevent an attribute to be modified.
+
+    .. versionadded:: 20.1.0
+    """
+    raise FrozenAttributeError()
+
+
+def validate(instance, attrib, new_value):
+    """
+    Run *attrib*'s validator on *new_value* if it has one.
+
+    .. versionadded:: 20.1.0
+    """
+    if _config._run_validators is False:
+        return new_value
+
+    v = attrib.validator
+    if not v:
+        return new_value
+
+    v(instance, attrib, new_value)
+
+    return new_value
+
+
+def convert(instance, attrib, new_value):
+    """
+    Run *attrib*'s converter -- if it has one --  on *new_value* and return the
+    result.
+
+    .. versionadded:: 20.1.0
+    """
+    c = attrib.converter
+    if c:
+        return c(new_value)
+
+    return new_value
+
+
+# Sentinel for disabling class-wide *on_setattr* hooks for certain attributes.
+# autodata stopped working, so the docstring is inlined in the API docs.
+NO_OP = object()
diff --git a/llm/Lib/site-packages/attr/setters.pyi b/llm/Lib/site-packages/attr/setters.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..72f7ce4761c343860d8b230dd50dcdeba10b03fb
--- /dev/null
+++ b/llm/Lib/site-packages/attr/setters.pyi
@@ -0,0 +1,19 @@
+from typing import Any, NewType, NoReturn, TypeVar
+
+from . import Attribute, _OnSetAttrType
+
+_T = TypeVar("_T")
+
+def frozen(
+    instance: Any, attribute: Attribute[Any], new_value: Any
+) -> NoReturn: ...
+def pipe(*setters: _OnSetAttrType) -> _OnSetAttrType: ...
+def validate(instance: Any, attribute: Attribute[_T], new_value: _T) -> _T: ...
+
+# convert is allowed to return Any, because they can be chained using pipe.
+def convert(
+    instance: Any, attribute: Attribute[Any], new_value: Any
+) -> Any: ...
+
+_NoOpType = NewType("_NoOpType", object)
+NO_OP: _NoOpType
diff --git a/llm/Lib/site-packages/attr/validators.py b/llm/Lib/site-packages/attr/validators.py
new file mode 100644
index 0000000000000000000000000000000000000000..34d6b761d37857e876a7d0fd1970a758f8f71981
--- /dev/null
+++ b/llm/Lib/site-packages/attr/validators.py
@@ -0,0 +1,681 @@
+# SPDX-License-Identifier: MIT
+
+"""
+Commonly useful validators.
+"""
+
+
+import operator
+import re
+
+from contextlib import contextmanager
+from re import Pattern
+
+from ._config import get_run_validators, set_run_validators
+from ._make import _AndValidator, and_, attrib, attrs
+from .converters import default_if_none
+from .exceptions import NotCallableError
+
+
+__all__ = [
+    "and_",
+    "deep_iterable",
+    "deep_mapping",
+    "disabled",
+    "ge",
+    "get_disabled",
+    "gt",
+    "in_",
+    "instance_of",
+    "is_callable",
+    "le",
+    "lt",
+    "matches_re",
+    "max_len",
+    "min_len",
+    "not_",
+    "optional",
+    "provides",
+    "set_disabled",
+]
+
+
+def set_disabled(disabled):
+    """
+    Globally disable or enable running validators.
+
+    By default, they are run.
+
+    :param disabled: If ``True``, disable running all validators.
+    :type disabled: bool
+
+    .. warning::
+
+        This function is not thread-safe!
+
+    .. versionadded:: 21.3.0
+    """
+    set_run_validators(not disabled)
+
+
+def get_disabled():
+    """
+    Return a bool indicating whether validators are currently disabled or not.
+
+    :return: ``True`` if validators are currently disabled.
+    :rtype: bool
+
+    .. versionadded:: 21.3.0
+    """
+    return not get_run_validators()
+
+
+@contextmanager
+def disabled():
+    """
+    Context manager that disables running validators within its context.
+
+    .. warning::
+
+        This context manager is not thread-safe!
+
+    .. versionadded:: 21.3.0
+    """
+    set_run_validators(False)
+    try:
+        yield
+    finally:
+        set_run_validators(True)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _InstanceOfValidator:
+    type = attrib()
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not isinstance(value, self.type):
+            msg = "'{name}' must be {type!r} (got {value!r} that is a {actual!r}).".format(
+                name=attr.name,
+                type=self.type,
+                actual=value.__class__,
+                value=value,
+            )
+            raise TypeError(
+                msg,
+                attr,
+                self.type,
+                value,
+            )
+
+    def __repr__(self):
+        return f"<instance_of validator for type {self.type!r}>"
+
+
+def instance_of(type):
+    """
+    A validator that raises a `TypeError` if the initializer is called
+    with a wrong type for this particular attribute (checks are performed using
+    `isinstance` therefore it's also valid to pass a tuple of types).
+
+    :param type: The type to check for.
+    :type type: type or tuple of type
+
+    :raises TypeError: With a human readable error message, the attribute
+        (of type `attrs.Attribute`), the expected type, and the value it
+        got.
+    """
+    return _InstanceOfValidator(type)
+
+
+@attrs(repr=False, frozen=True, slots=True)
+class _MatchesReValidator:
+    pattern = attrib()
+    match_func = attrib()
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not self.match_func(value):
+            msg = "'{name}' must match regex {pattern!r} ({value!r} doesn't)".format(
+                name=attr.name, pattern=self.pattern.pattern, value=value
+            )
+            raise ValueError(
+                msg,
+                attr,
+                self.pattern,
+                value,
+            )
+
+    def __repr__(self):
+        return f"<matches_re validator for pattern {self.pattern!r}>"
+
+
+def matches_re(regex, flags=0, func=None):
+    r"""
+    A validator that raises `ValueError` if the initializer is called
+    with a string that doesn't match *regex*.
+
+    :param regex: a regex string or precompiled pattern to match against
+    :param int flags: flags that will be passed to the underlying re function
+        (default 0)
+    :param callable func: which underlying `re` function to call. Valid options
+        are `re.fullmatch`, `re.search`, and `re.match`; the default ``None``
+        means `re.fullmatch`. For performance reasons, the pattern is always
+        precompiled using `re.compile`.
+
+    .. versionadded:: 19.2.0
+    .. versionchanged:: 21.3.0 *regex* can be a pre-compiled pattern.
+    """
+    valid_funcs = (re.fullmatch, None, re.search, re.match)
+    if func not in valid_funcs:
+        msg = "'func' must be one of {}.".format(
+            ", ".join(
+                sorted(e and e.__name__ or "None" for e in set(valid_funcs))
+            )
+        )
+        raise ValueError(msg)
+
+    if isinstance(regex, Pattern):
+        if flags:
+            msg = "'flags' can only be used with a string pattern; pass flags to re.compile() instead"
+            raise TypeError(msg)
+        pattern = regex
+    else:
+        pattern = re.compile(regex, flags)
+
+    if func is re.match:
+        match_func = pattern.match
+    elif func is re.search:
+        match_func = pattern.search
+    else:
+        match_func = pattern.fullmatch
+
+    return _MatchesReValidator(pattern, match_func)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _ProvidesValidator:
+    interface = attrib()
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not self.interface.providedBy(value):
+            msg = "'{name}' must provide {interface!r} which {value!r} doesn't.".format(
+                name=attr.name, interface=self.interface, value=value
+            )
+            raise TypeError(
+                msg,
+                attr,
+                self.interface,
+                value,
+            )
+
+    def __repr__(self):
+        return f"<provides validator for interface {self.interface!r}>"
+
+
+def provides(interface):
+    """
+    A validator that raises a `TypeError` if the initializer is called
+    with an object that does not provide the requested *interface* (checks are
+    performed using ``interface.providedBy(value)`` (see `zope.interface
+    <https://zopeinterface.readthedocs.io/en/latest/>`_).
+
+    :param interface: The interface to check for.
+    :type interface: ``zope.interface.Interface``
+
+    :raises TypeError: With a human readable error message, the attribute
+        (of type `attrs.Attribute`), the expected interface, and the
+        value it got.
+
+    .. deprecated:: 23.1.0
+    """
+    import warnings
+
+    warnings.warn(
+        "attrs's zope-interface support is deprecated and will be removed in, "
+        "or after, April 2024.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return _ProvidesValidator(interface)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _OptionalValidator:
+    validator = attrib()
+
+    def __call__(self, inst, attr, value):
+        if value is None:
+            return
+
+        self.validator(inst, attr, value)
+
+    def __repr__(self):
+        return f"<optional validator for {self.validator!r} or None>"
+
+
+def optional(validator):
+    """
+    A validator that makes an attribute optional.  An optional attribute is one
+    which can be set to ``None`` in addition to satisfying the requirements of
+    the sub-validator.
+
+    :param Callable | tuple[Callable] | list[Callable] validator: A validator
+        (or validators) that is used for non-``None`` values.
+
+    .. versionadded:: 15.1.0
+    .. versionchanged:: 17.1.0 *validator* can be a list of validators.
+    .. versionchanged:: 23.1.0 *validator* can also be a tuple of validators.
+    """
+    if isinstance(validator, (list, tuple)):
+        return _OptionalValidator(_AndValidator(validator))
+
+    return _OptionalValidator(validator)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _InValidator:
+    options = attrib()
+
+    def __call__(self, inst, attr, value):
+        try:
+            in_options = value in self.options
+        except TypeError:  # e.g. `1 in "abc"`
+            in_options = False
+
+        if not in_options:
+            msg = f"'{attr.name}' must be in {self.options!r} (got {value!r})"
+            raise ValueError(
+                msg,
+                attr,
+                self.options,
+                value,
+            )
+
+    def __repr__(self):
+        return f"<in_ validator with options {self.options!r}>"
+
+
+def in_(options):
+    """
+    A validator that raises a `ValueError` if the initializer is called
+    with a value that does not belong in the options provided.  The check is
+    performed using ``value in options``.
+
+    :param options: Allowed options.
+    :type options: list, tuple, `enum.Enum`, ...
+
+    :raises ValueError: With a human readable error message, the attribute (of
+       type `attrs.Attribute`), the expected options, and the value it
+       got.
+
+    .. versionadded:: 17.1.0
+    .. versionchanged:: 22.1.0
+       The ValueError was incomplete until now and only contained the human
+       readable error message. Now it contains all the information that has
+       been promised since 17.1.0.
+    """
+    return _InValidator(options)
+
+
+@attrs(repr=False, slots=False, hash=True)
+class _IsCallableValidator:
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not callable(value):
+            message = (
+                "'{name}' must be callable "
+                "(got {value!r} that is a {actual!r})."
+            )
+            raise NotCallableError(
+                msg=message.format(
+                    name=attr.name, value=value, actual=value.__class__
+                ),
+                value=value,
+            )
+
+    def __repr__(self):
+        return "<is_callable validator>"
+
+
+def is_callable():
+    """
+    A validator that raises a `attrs.exceptions.NotCallableError` if the
+    initializer is called with a value for this particular attribute
+    that is not callable.
+
+    .. versionadded:: 19.1.0
+
+    :raises attrs.exceptions.NotCallableError: With a human readable error
+        message containing the attribute (`attrs.Attribute`) name,
+        and the value it got.
+    """
+    return _IsCallableValidator()
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _DeepIterable:
+    member_validator = attrib(validator=is_callable())
+    iterable_validator = attrib(
+        default=None, validator=optional(is_callable())
+    )
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if self.iterable_validator is not None:
+            self.iterable_validator(inst, attr, value)
+
+        for member in value:
+            self.member_validator(inst, attr, member)
+
+    def __repr__(self):
+        iterable_identifier = (
+            ""
+            if self.iterable_validator is None
+            else f" {self.iterable_validator!r}"
+        )
+        return (
+            f"<deep_iterable validator for{iterable_identifier}"
+            f" iterables of {self.member_validator!r}>"
+        )
+
+
+def deep_iterable(member_validator, iterable_validator=None):
+    """
+    A validator that performs deep validation of an iterable.
+
+    :param member_validator: Validator(s) to apply to iterable members
+    :param iterable_validator: Validator to apply to iterable itself
+        (optional)
+
+    .. versionadded:: 19.1.0
+
+    :raises TypeError: if any sub-validators fail
+    """
+    if isinstance(member_validator, (list, tuple)):
+        member_validator = and_(*member_validator)
+    return _DeepIterable(member_validator, iterable_validator)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _DeepMapping:
+    key_validator = attrib(validator=is_callable())
+    value_validator = attrib(validator=is_callable())
+    mapping_validator = attrib(default=None, validator=optional(is_callable()))
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if self.mapping_validator is not None:
+            self.mapping_validator(inst, attr, value)
+
+        for key in value:
+            self.key_validator(inst, attr, key)
+            self.value_validator(inst, attr, value[key])
+
+    def __repr__(self):
+        return (
+            "<deep_mapping validator for objects mapping {key!r} to {value!r}>"
+        ).format(key=self.key_validator, value=self.value_validator)
+
+
+def deep_mapping(key_validator, value_validator, mapping_validator=None):
+    """
+    A validator that performs deep validation of a dictionary.
+
+    :param key_validator: Validator to apply to dictionary keys
+    :param value_validator: Validator to apply to dictionary values
+    :param mapping_validator: Validator to apply to top-level mapping
+        attribute (optional)
+
+    .. versionadded:: 19.1.0
+
+    :raises TypeError: if any sub-validators fail
+    """
+    return _DeepMapping(key_validator, value_validator, mapping_validator)
+
+
+@attrs(repr=False, frozen=True, slots=True)
+class _NumberValidator:
+    bound = attrib()
+    compare_op = attrib()
+    compare_func = attrib()
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not self.compare_func(value, self.bound):
+            msg = f"'{attr.name}' must be {self.compare_op} {self.bound}: {value}"
+            raise ValueError(msg)
+
+    def __repr__(self):
+        return f"<Validator for x {self.compare_op} {self.bound}>"
+
+
+def lt(val):
+    """
+    A validator that raises `ValueError` if the initializer is called
+    with a number larger or equal to *val*.
+
+    :param val: Exclusive upper bound for values
+
+    .. versionadded:: 21.3.0
+    """
+    return _NumberValidator(val, "<", operator.lt)
+
+
+def le(val):
+    """
+    A validator that raises `ValueError` if the initializer is called
+    with a number greater than *val*.
+
+    :param val: Inclusive upper bound for values
+
+    .. versionadded:: 21.3.0
+    """
+    return _NumberValidator(val, "<=", operator.le)
+
+
+def ge(val):
+    """
+    A validator that raises `ValueError` if the initializer is called
+    with a number smaller than *val*.
+
+    :param val: Inclusive lower bound for values
+
+    .. versionadded:: 21.3.0
+    """
+    return _NumberValidator(val, ">=", operator.ge)
+
+
+def gt(val):
+    """
+    A validator that raises `ValueError` if the initializer is called
+    with a number smaller or equal to *val*.
+
+    :param val: Exclusive lower bound for values
+
+    .. versionadded:: 21.3.0
+    """
+    return _NumberValidator(val, ">", operator.gt)
+
+
+@attrs(repr=False, frozen=True, slots=True)
+class _MaxLengthValidator:
+    max_length = attrib()
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if len(value) > self.max_length:
+            msg = f"Length of '{attr.name}' must be <= {self.max_length}: {len(value)}"
+            raise ValueError(msg)
+
+    def __repr__(self):
+        return f"<max_len validator for {self.max_length}>"
+
+
+def max_len(length):
+    """
+    A validator that raises `ValueError` if the initializer is called
+    with a string or iterable that is longer than *length*.
+
+    :param int length: Maximum length of the string or iterable
+
+    .. versionadded:: 21.3.0
+    """
+    return _MaxLengthValidator(length)
+
+
+@attrs(repr=False, frozen=True, slots=True)
+class _MinLengthValidator:
+    min_length = attrib()
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if len(value) < self.min_length:
+            msg = f"Length of '{attr.name}' must be >= {self.min_length}: {len(value)}"
+            raise ValueError(msg)
+
+    def __repr__(self):
+        return f"<min_len validator for {self.min_length}>"
+
+
+def min_len(length):
+    """
+    A validator that raises `ValueError` if the initializer is called
+    with a string or iterable that is shorter than *length*.
+
+    :param int length: Minimum length of the string or iterable
+
+    .. versionadded:: 22.1.0
+    """
+    return _MinLengthValidator(length)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _SubclassOfValidator:
+    type = attrib()
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not issubclass(value, self.type):
+            msg = f"'{attr.name}' must be a subclass of {self.type!r} (got {value!r})."
+            raise TypeError(
+                msg,
+                attr,
+                self.type,
+                value,
+            )
+
+    def __repr__(self):
+        return f"<subclass_of validator for type {self.type!r}>"
+
+
+def _subclass_of(type):
+    """
+    A validator that raises a `TypeError` if the initializer is called
+    with a wrong type for this particular attribute (checks are performed using
+    `issubclass` therefore it's also valid to pass a tuple of types).
+
+    :param type: The type to check for.
+    :type type: type or tuple of types
+
+    :raises TypeError: With a human readable error message, the attribute
+        (of type `attrs.Attribute`), the expected type, and the value it
+        got.
+    """
+    return _SubclassOfValidator(type)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _NotValidator:
+    validator = attrib()
+    msg = attrib(
+        converter=default_if_none(
+            "not_ validator child '{validator!r}' "
+            "did not raise a captured error"
+        )
+    )
+    exc_types = attrib(
+        validator=deep_iterable(
+            member_validator=_subclass_of(Exception),
+            iterable_validator=instance_of(tuple),
+        ),
+    )
+
+    def __call__(self, inst, attr, value):
+        try:
+            self.validator(inst, attr, value)
+        except self.exc_types:
+            pass  # suppress error to invert validity
+        else:
+            raise ValueError(
+                self.msg.format(
+                    validator=self.validator,
+                    exc_types=self.exc_types,
+                ),
+                attr,
+                self.validator,
+                value,
+                self.exc_types,
+            )
+
+    def __repr__(self):
+        return (
+            "<not_ validator wrapping {what!r}, capturing {exc_types!r}>"
+        ).format(
+            what=self.validator,
+            exc_types=self.exc_types,
+        )
+
+
+def not_(validator, *, msg=None, exc_types=(ValueError, TypeError)):
+    """
+    A validator that wraps and logically 'inverts' the validator passed to it.
+    It will raise a `ValueError` if the provided validator *doesn't* raise a
+    `ValueError` or `TypeError` (by default), and will suppress the exception
+    if the provided validator *does*.
+
+    Intended to be used with existing validators to compose logic without
+    needing to create inverted variants, for example, ``not_(in_(...))``.
+
+    :param validator: A validator to be logically inverted.
+    :param msg: Message to raise if validator fails.
+        Formatted with keys ``exc_types`` and ``validator``.
+    :type msg: str
+    :param exc_types: Exception type(s) to capture.
+        Other types raised by child validators will not be intercepted and
+        pass through.
+
+    :raises ValueError: With a human readable error message,
+        the attribute (of type `attrs.Attribute`),
+        the validator that failed to raise an exception,
+        the value it got,
+        and the expected exception types.
+
+    .. versionadded:: 22.2.0
+    """
+    try:
+        exc_types = tuple(exc_types)
+    except TypeError:
+        exc_types = (exc_types,)
+    return _NotValidator(validator, msg, exc_types)
diff --git a/llm/Lib/site-packages/attr/validators.pyi b/llm/Lib/site-packages/attr/validators.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..d194a75abcacfa434f2445e66ea25975236dffcf
--- /dev/null
+++ b/llm/Lib/site-packages/attr/validators.pyi
@@ -0,0 +1,88 @@
+from typing import (
+    Any,
+    AnyStr,
+    Callable,
+    Container,
+    ContextManager,
+    Iterable,
+    List,
+    Mapping,
+    Match,
+    Optional,
+    Pattern,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    overload,
+)
+
+from . import _ValidatorType
+from . import _ValidatorArgType
+
+_T = TypeVar("_T")
+_T1 = TypeVar("_T1")
+_T2 = TypeVar("_T2")
+_T3 = TypeVar("_T3")
+_I = TypeVar("_I", bound=Iterable)
+_K = TypeVar("_K")
+_V = TypeVar("_V")
+_M = TypeVar("_M", bound=Mapping)
+
+def set_disabled(run: bool) -> None: ...
+def get_disabled() -> bool: ...
+def disabled() -> ContextManager[None]: ...
+
+# To be more precise on instance_of use some overloads.
+# If there are more than 3 items in the tuple then we fall back to Any
+@overload
+def instance_of(type: Type[_T]) -> _ValidatorType[_T]: ...
+@overload
+def instance_of(type: Tuple[Type[_T]]) -> _ValidatorType[_T]: ...
+@overload
+def instance_of(
+    type: Tuple[Type[_T1], Type[_T2]]
+) -> _ValidatorType[Union[_T1, _T2]]: ...
+@overload
+def instance_of(
+    type: Tuple[Type[_T1], Type[_T2], Type[_T3]]
+) -> _ValidatorType[Union[_T1, _T2, _T3]]: ...
+@overload
+def instance_of(type: Tuple[type, ...]) -> _ValidatorType[Any]: ...
+def provides(interface: Any) -> _ValidatorType[Any]: ...
+def optional(
+    validator: Union[
+        _ValidatorType[_T], List[_ValidatorType[_T]], Tuple[_ValidatorType[_T]]
+    ]
+) -> _ValidatorType[Optional[_T]]: ...
+def in_(options: Container[_T]) -> _ValidatorType[_T]: ...
+def and_(*validators: _ValidatorType[_T]) -> _ValidatorType[_T]: ...
+def matches_re(
+    regex: Union[Pattern[AnyStr], AnyStr],
+    flags: int = ...,
+    func: Optional[
+        Callable[[AnyStr, AnyStr, int], Optional[Match[AnyStr]]]
+    ] = ...,
+) -> _ValidatorType[AnyStr]: ...
+def deep_iterable(
+    member_validator: _ValidatorArgType[_T],
+    iterable_validator: Optional[_ValidatorType[_I]] = ...,
+) -> _ValidatorType[_I]: ...
+def deep_mapping(
+    key_validator: _ValidatorType[_K],
+    value_validator: _ValidatorType[_V],
+    mapping_validator: Optional[_ValidatorType[_M]] = ...,
+) -> _ValidatorType[_M]: ...
+def is_callable() -> _ValidatorType[_T]: ...
+def lt(val: _T) -> _ValidatorType[_T]: ...
+def le(val: _T) -> _ValidatorType[_T]: ...
+def ge(val: _T) -> _ValidatorType[_T]: ...
+def gt(val: _T) -> _ValidatorType[_T]: ...
+def max_len(length: int) -> _ValidatorType[_T]: ...
+def min_len(length: int) -> _ValidatorType[_T]: ...
+def not_(
+    validator: _ValidatorType[_T],
+    *,
+    msg: Optional[str] = None,
+    exc_types: Union[Type[Exception], Iterable[Type[Exception]]] = ...,
+) -> _ValidatorType[_T]: ...
diff --git a/llm/Lib/site-packages/attrs-23.2.0.dist-info/INSTALLER b/llm/Lib/site-packages/attrs-23.2.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/attrs-23.2.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/attrs-23.2.0.dist-info/METADATA b/llm/Lib/site-packages/attrs-23.2.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..c20be76c7476ea998872511afa4449f41d8bb832
--- /dev/null
+++ b/llm/Lib/site-packages/attrs-23.2.0.dist-info/METADATA
@@ -0,0 +1,202 @@
+Metadata-Version: 2.1
+Name: attrs
+Version: 23.2.0
+Summary: Classes Without Boilerplate
+Project-URL: Documentation, https://www.attrs.org/
+Project-URL: Changelog, https://www.attrs.org/en/stable/changelog.html
+Project-URL: GitHub, https://github.com/python-attrs/attrs
+Project-URL: Funding, https://github.com/sponsors/hynek
+Project-URL: Tidelift, https://tidelift.com/subscription/pkg/pypi-attrs?utm_source=pypi-attrs&utm_medium=pypi
+Author-email: Hynek Schlawack <hs@ox.cx>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: attribute,boilerplate,class
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Typing :: Typed
+Requires-Python: >=3.7
+Requires-Dist: importlib-metadata; python_version < '3.8'
+Provides-Extra: cov
+Requires-Dist: attrs[tests]; extra == 'cov'
+Requires-Dist: coverage[toml]>=5.3; extra == 'cov'
+Provides-Extra: dev
+Requires-Dist: attrs[tests]; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: furo; extra == 'docs'
+Requires-Dist: myst-parser; extra == 'docs'
+Requires-Dist: sphinx; extra == 'docs'
+Requires-Dist: sphinx-notfound-page; extra == 'docs'
+Requires-Dist: sphinxcontrib-towncrier; extra == 'docs'
+Requires-Dist: towncrier; extra == 'docs'
+Requires-Dist: zope-interface; extra == 'docs'
+Provides-Extra: tests
+Requires-Dist: attrs[tests-no-zope]; extra == 'tests'
+Requires-Dist: zope-interface; extra == 'tests'
+Provides-Extra: tests-mypy
+Requires-Dist: mypy>=1.6; (platform_python_implementation == 'CPython' and python_version >= '3.8') and extra == 'tests-mypy'
+Requires-Dist: pytest-mypy-plugins; (platform_python_implementation == 'CPython' and python_version >= '3.8') and extra == 'tests-mypy'
+Provides-Extra: tests-no-zope
+Requires-Dist: attrs[tests-mypy]; extra == 'tests-no-zope'
+Requires-Dist: cloudpickle; (platform_python_implementation == 'CPython') and extra == 'tests-no-zope'
+Requires-Dist: hypothesis; extra == 'tests-no-zope'
+Requires-Dist: pympler; extra == 'tests-no-zope'
+Requires-Dist: pytest-xdist[psutil]; extra == 'tests-no-zope'
+Requires-Dist: pytest>=4.3.0; extra == 'tests-no-zope'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <a href="https://www.attrs.org/">
+    <img src="https://raw.githubusercontent.com/python-attrs/attrs/main/docs/_static/attrs_logo.svg" width="35%" alt="attrs" />
+  </a>
+</p>
+
+
+*attrs* is the Python package that will bring back the **joy** of **writing classes** by relieving you from the drudgery of implementing object protocols (aka [dunder methods](https://www.attrs.org/en/latest/glossary.html#term-dunder-methods)).
+[Trusted by NASA](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile#list-of-qualifying-repositories-for-mars-2020-helicopter-contributor-achievement) for Mars missions since 2020!
+
+Its main goal is to help you to write **concise** and **correct** software without slowing down your code.
+
+
+## Sponsors
+
+*attrs* would not be possible without our [amazing sponsors](https://github.com/sponsors/hynek).
+Especially those generously supporting us at the *The Organization* tier and higher:
+
+<p align="center">
+   <a href="https://www.variomedia.de/"><img src="https://www.attrs.org/en/23.2.0/_static/sponsors/Variomedia.svg" width="200" height="60" /></a>
+   <a href="https://tidelift.com/subscription/pkg/pypi-attrs?utm_source=pypi-attrs&utm_medium=referral&utm_campaign=enterprise&utm_term=repo"><img src="https://www.attrs.org/en/23.2.0/_static/sponsors/Tidelift.svg" width="200" height="60" /></a>
+   <a href="https://filepreviews.io/"><img src="https://www.attrs.org/en/23.2.0/_static/sponsors/FilePreviews.svg" width="200" height="60"/></a>
+</p>
+
+<p align="center">
+   <strong>Please consider <a href="https://github.com/sponsors/hynek">joining them</a> to help make <em>attrs</em>’s maintenance more sustainable!</strong>
+</p>
+
+<!-- teaser-end -->
+
+## Example
+
+*attrs* gives you a class decorator and a way to declaratively define the attributes on that class:
+
+<!-- code-begin -->
+
+```pycon
+>>> from attrs import asdict, define, make_class, Factory
+
+>>> @define
+... class SomeClass:
+...     a_number: int = 42
+...     list_of_numbers: list[int] = Factory(list)
+...
+...     def hard_math(self, another_number):
+...         return self.a_number + sum(self.list_of_numbers) * another_number
+
+
+>>> sc = SomeClass(1, [1, 2, 3])
+>>> sc
+SomeClass(a_number=1, list_of_numbers=[1, 2, 3])
+
+>>> sc.hard_math(3)
+19
+>>> sc == SomeClass(1, [1, 2, 3])
+True
+>>> sc != SomeClass(2, [3, 2, 1])
+True
+
+>>> asdict(sc)
+{'a_number': 1, 'list_of_numbers': [1, 2, 3]}
+
+>>> SomeClass()
+SomeClass(a_number=42, list_of_numbers=[])
+
+>>> C = make_class("C", ["a", "b"])
+>>> C("foo", "bar")
+C(a='foo', b='bar')
+```
+
+After *declaring* your attributes, *attrs* gives you:
+
+- a concise and explicit overview of the class's attributes,
+- a nice human-readable `__repr__`,
+- equality-checking methods,
+- an initializer,
+- and much more,
+
+*without* writing dull boilerplate code again and again and *without* runtime performance penalties.
+
+**Hate type annotations**!?
+No problem!
+Types are entirely **optional** with *attrs*.
+Simply assign `attrs.field()` to the attributes instead of annotating them with types.
+
+---
+
+This example uses *attrs*'s modern APIs that have been introduced in version 20.1.0, and the *attrs* package import name that has been added in version 21.3.0.
+The classic APIs (`@attr.s`, `attr.ib`, plus their serious-business aliases) and the `attr` package import name will remain **indefinitely**.
+
+Please check out [*On The Core API Names*](https://www.attrs.org/en/latest/names.html) for a more in-depth explanation.
+
+
+## Data Classes
+
+On the tin, *attrs* might remind you of `dataclasses` (and indeed, `dataclasses` [are a descendant](https://hynek.me/articles/import-attrs/) of *attrs*).
+In practice it does a lot more and is more flexible.
+For instance it allows you to define [special handling of NumPy arrays for equality checks](https://www.attrs.org/en/stable/comparison.html#customization), allows more ways to [plug into the initialization process](https://www.attrs.org/en/stable/init.html#hooking-yourself-into-initialization), and allows for stepping through the generated methods using a debugger.
+
+For more details, please refer to our [comparison page](https://www.attrs.org/en/stable/why.html#data-classes).
+
+
+## Project Information
+
+- [**Changelog**](https://www.attrs.org/en/stable/changelog.html)
+- [**Documentation**](https://www.attrs.org/)
+- [**PyPI**](https://pypi.org/project/attrs/)
+- [**Source Code**](https://github.com/python-attrs/attrs)
+- [**Contributing**](https://github.com/python-attrs/attrs/blob/main/.github/CONTRIBUTING.md)
+- [**Third-party Extensions**](https://github.com/python-attrs/attrs/wiki/Extensions-to-attrs)
+- **Get Help**: please use the `python-attrs` tag on [StackOverflow](https://stackoverflow.com/questions/tagged/python-attrs)
+
+
+### *attrs* for Enterprise
+
+Available as part of the Tidelift Subscription.
+
+The maintainers of *attrs* and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications.
+Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use.
+[Learn more.](https://tidelift.com/subscription/pkg/pypi-attrs?utm_source=pypi-attrs&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)
+
+## Release Information
+
+### Changes
+
+- The type annotation for `attrs.resolve_types()` is now correct.
+  [#1141](https://github.com/python-attrs/attrs/issues/1141)
+- Type stubs now use `typing.dataclass_transform` to decorate dataclass-like decorators, instead of the non-standard `__dataclass_transform__` special form, which is only supported by Pyright.
+  [#1158](https://github.com/python-attrs/attrs/issues/1158)
+- Fixed serialization of namedtuple fields using `attrs.asdict/astuple()` with `retain_collection_types=True`.
+  [#1165](https://github.com/python-attrs/attrs/issues/1165)
+- `attrs.AttrsInstance` is now a `typing.Protocol` in both type hints and code.
+  This allows you to subclass it along with another `Protocol`.
+  [#1172](https://github.com/python-attrs/attrs/issues/1172)
+- If *attrs* detects that `__attrs_pre_init__` accepts more than just `self`, it will call it with the same arguments as `__init__` was called.
+  This allows you to, for example, pass arguments to `super().__init__()`.
+  [#1187](https://github.com/python-attrs/attrs/issues/1187)
+- Slotted classes now transform `functools.cached_property` decorated methods to support equivalent semantics.
+  [#1200](https://github.com/python-attrs/attrs/issues/1200)
+- Added *class_body* argument to `attrs.make_class()` to provide additional attributes for newly created classes.
+  It is, for example, now possible to attach methods.
+  [#1203](https://github.com/python-attrs/attrs/issues/1203)
+
+
+---
+
+[Full changelog](https://www.attrs.org/en/stable/changelog.html)
diff --git a/llm/Lib/site-packages/attrs-23.2.0.dist-info/RECORD b/llm/Lib/site-packages/attrs-23.2.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..08fba2a9ab4dfe0383f3175daf34fcf112d2faa6
--- /dev/null
+++ b/llm/Lib/site-packages/attrs-23.2.0.dist-info/RECORD
@@ -0,0 +1,55 @@
+attr/__init__.py,sha256=WlXJN6ICB0Y_HZ0lmuTUgia0kuSdn2p67d4N6cYxNZM,3307
+attr/__init__.pyi,sha256=u08EujYHy_rSyebNn-I9Xv2S_cXmtA9xWGc0cBsyl18,16976
+attr/__pycache__/__init__.cpython-311.pyc,,
+attr/__pycache__/_cmp.cpython-311.pyc,,
+attr/__pycache__/_compat.cpython-311.pyc,,
+attr/__pycache__/_config.cpython-311.pyc,,
+attr/__pycache__/_funcs.cpython-311.pyc,,
+attr/__pycache__/_make.cpython-311.pyc,,
+attr/__pycache__/_next_gen.cpython-311.pyc,,
+attr/__pycache__/_version_info.cpython-311.pyc,,
+attr/__pycache__/converters.cpython-311.pyc,,
+attr/__pycache__/exceptions.cpython-311.pyc,,
+attr/__pycache__/filters.cpython-311.pyc,,
+attr/__pycache__/setters.cpython-311.pyc,,
+attr/__pycache__/validators.cpython-311.pyc,,
+attr/_cmp.py,sha256=OQZlWdFX74z18adGEUp40Ojqm0NNu1Flqnv2JE8B2ng,4025
+attr/_cmp.pyi,sha256=sGQmOM0w3_K4-X8cTXR7g0Hqr290E8PTObA9JQxWQqc,399
+attr/_compat.py,sha256=QmRyxii295wcQfaugWqxuIumAPsNQ2-RUF82QZPqMKw,2540
+attr/_config.py,sha256=z81Vt-GeT_2taxs1XZfmHx9TWlSxjPb6eZH1LTGsS54,843
+attr/_funcs.py,sha256=VBTUFKLklsmqxys3qWSTK_Ac9Z4s0mAJWwgW9nA7Llk,17173
+attr/_make.py,sha256=LnVy2e0HygoqaZknhC19z7JmOt7qGkAadf2LZgWVJWI,101923
+attr/_next_gen.py,sha256=as1voi8siAI_o2OQG8YIiZvmn0G7-S3_j_774rnoZ_g,6203
+attr/_typing_compat.pyi,sha256=XDP54TUn-ZKhD62TOQebmzrwFyomhUCoGRpclb6alRA,469
+attr/_version_info.py,sha256=exSqb3b5E-fMSsgZAlEw9XcLpEgobPORCZpcaEglAM4,2121
+attr/_version_info.pyi,sha256=x_M3L3WuB7r_ULXAWjx959udKQ4HLB8l-hsc1FDGNvk,209
+attr/converters.py,sha256=Kyw5MY0yfnUR_RwN1Vydf0EiE---htDxOgSc_-NYL6A,3622
+attr/converters.pyi,sha256=jKlpHBEt6HVKJvgrMFJRrHq8p61GXg4-Nd5RZWKJX7M,406
+attr/exceptions.py,sha256=HRFq4iybmv7-DcZwyjl6M1euM2YeJVK_hFxuaBGAngI,1977
+attr/exceptions.pyi,sha256=zZq8bCUnKAy9mDtBEw42ZhPhAUIHoTKedDQInJD883M,539
+attr/filters.py,sha256=9pYvXqdg6mtLvKIIb56oALRMoHFnQTcGCO4EXTc1qyM,1470
+attr/filters.pyi,sha256=0mRCjLKxdcvAo0vD-Cr81HfRXXCp9j_cAXjOoAHtPGM,225
+attr/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+attr/setters.py,sha256=pbCZQ-pE6ZxjDqZfWWUhUFefXtpekIU4qS_YDMLPQ50,1400
+attr/setters.pyi,sha256=pyY8TVNBu8TWhOldv_RxHzmGvdgFQH981db70r0fn5I,567
+attr/validators.py,sha256=LGVpbiNg_KGzYrKUD5JPiZkx8TMfynDZGoQoLJNCIMo,19676
+attr/validators.pyi,sha256=167Dl9nt7NUhE9wht1I-buo039qyUT1nEUT_nKjSWr4,2580
+attrs-23.2.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+attrs-23.2.0.dist-info/METADATA,sha256=WwvG7OHyKjEPpyFUZCCYt1n0E_CcqdRb7bliGEdcm-A,9531
+attrs-23.2.0.dist-info/RECORD,,
+attrs-23.2.0.dist-info/WHEEL,sha256=mRYSEL3Ih6g5a_CVMIcwiF__0Ae4_gLYh01YFNwiq1k,87
+attrs-23.2.0.dist-info/licenses/LICENSE,sha256=iCEVyV38KvHutnFPjsbVy8q_Znyv-HKfQkINpj9xTp8,1109
+attrs/__init__.py,sha256=9_5waVbFs7rLqtXZ73tNDrxhezyZ8VZeX4BbvQ3EeJw,1039
+attrs/__init__.pyi,sha256=s_ajQ_U14DOsOz0JbmAKDOi46B3v2PcdO0UAV1MY6Ek,2168
+attrs/__pycache__/__init__.cpython-311.pyc,,
+attrs/__pycache__/converters.cpython-311.pyc,,
+attrs/__pycache__/exceptions.cpython-311.pyc,,
+attrs/__pycache__/filters.cpython-311.pyc,,
+attrs/__pycache__/setters.cpython-311.pyc,,
+attrs/__pycache__/validators.cpython-311.pyc,,
+attrs/converters.py,sha256=8kQljrVwfSTRu8INwEk8SI0eGrzmWftsT7rM0EqyohM,76
+attrs/exceptions.py,sha256=ACCCmg19-vDFaDPY9vFl199SPXCQMN_bENs4DALjzms,76
+attrs/filters.py,sha256=VOUMZug9uEU6dUuA0dF1jInUK0PL3fLgP0VBS5d-CDE,73
+attrs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+attrs/setters.py,sha256=eL1YidYQV3T2h9_SYIZSZR1FAcHGb1TuCTy0E0Lv2SU,73
+attrs/validators.py,sha256=xcy6wD5TtTkdCG1f4XWbocPSO0faBjk5IfVJfP6SUj0,76
diff --git a/llm/Lib/site-packages/attrs-23.2.0.dist-info/WHEEL b/llm/Lib/site-packages/attrs-23.2.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..2860816abecb3c5ad7da6d018a4334b87e6b6cfc
--- /dev/null
+++ b/llm/Lib/site-packages/attrs-23.2.0.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.21.0
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/attrs-23.2.0.dist-info/licenses/LICENSE b/llm/Lib/site-packages/attrs-23.2.0.dist-info/licenses/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..2bd6453d255e19b973f19b128596a8b6dd65b2c3
--- /dev/null
+++ b/llm/Lib/site-packages/attrs-23.2.0.dist-info/licenses/LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Hynek Schlawack and the attrs contributors
+
+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
+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.
diff --git a/llm/Lib/site-packages/attrs/__init__.py b/llm/Lib/site-packages/attrs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c2481561a93a912503754396782e987fcdd9629
--- /dev/null
+++ b/llm/Lib/site-packages/attrs/__init__.py
@@ -0,0 +1,65 @@
+# SPDX-License-Identifier: MIT
+
+from attr import (
+    NOTHING,
+    Attribute,
+    AttrsInstance,
+    Factory,
+    _make_getattr,
+    assoc,
+    cmp_using,
+    define,
+    evolve,
+    field,
+    fields,
+    fields_dict,
+    frozen,
+    has,
+    make_class,
+    mutable,
+    resolve_types,
+    validate,
+)
+from attr._next_gen import asdict, astuple
+
+from . import converters, exceptions, filters, setters, validators
+
+
+__all__ = [
+    "__author__",
+    "__copyright__",
+    "__description__",
+    "__doc__",
+    "__email__",
+    "__license__",
+    "__title__",
+    "__url__",
+    "__version__",
+    "__version_info__",
+    "asdict",
+    "assoc",
+    "astuple",
+    "Attribute",
+    "AttrsInstance",
+    "cmp_using",
+    "converters",
+    "define",
+    "evolve",
+    "exceptions",
+    "Factory",
+    "field",
+    "fields_dict",
+    "fields",
+    "filters",
+    "frozen",
+    "has",
+    "make_class",
+    "mutable",
+    "NOTHING",
+    "resolve_types",
+    "setters",
+    "validate",
+    "validators",
+]
+
+__getattr__ = _make_getattr(__name__)
diff --git a/llm/Lib/site-packages/attrs/__init__.pyi b/llm/Lib/site-packages/attrs/__init__.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..9372cfea16e89790cb0f515b1d9d48d8f1897151
--- /dev/null
+++ b/llm/Lib/site-packages/attrs/__init__.pyi
@@ -0,0 +1,67 @@
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Mapping,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+)
+
+# Because we need to type our own stuff, we have to make everything from
+# attr explicitly public too.
+from attr import __author__ as __author__
+from attr import __copyright__ as __copyright__
+from attr import __description__ as __description__
+from attr import __email__ as __email__
+from attr import __license__ as __license__
+from attr import __title__ as __title__
+from attr import __url__ as __url__
+from attr import __version__ as __version__
+from attr import __version_info__ as __version_info__
+from attr import _FilterType
+from attr import assoc as assoc
+from attr import Attribute as Attribute
+from attr import AttrsInstance as AttrsInstance
+from attr import cmp_using as cmp_using
+from attr import converters as converters
+from attr import define as define
+from attr import evolve as evolve
+from attr import exceptions as exceptions
+from attr import Factory as Factory
+from attr import field as field
+from attr import fields as fields
+from attr import fields_dict as fields_dict
+from attr import filters as filters
+from attr import frozen as frozen
+from attr import has as has
+from attr import make_class as make_class
+from attr import mutable as mutable
+from attr import NOTHING as NOTHING
+from attr import resolve_types as resolve_types
+from attr import setters as setters
+from attr import validate as validate
+from attr import validators as validators
+
+# TODO: see definition of attr.asdict/astuple
+def asdict(
+    inst: AttrsInstance,
+    recurse: bool = ...,
+    filter: Optional[_FilterType[Any]] = ...,
+    dict_factory: Type[Mapping[Any, Any]] = ...,
+    retain_collection_types: bool = ...,
+    value_serializer: Optional[
+        Callable[[type, Attribute[Any], Any], Any]
+    ] = ...,
+    tuple_keys: bool = ...,
+) -> Dict[str, Any]: ...
+
+# TODO: add support for returning NamedTuple from the mypy plugin
+def astuple(
+    inst: AttrsInstance,
+    recurse: bool = ...,
+    filter: Optional[_FilterType[Any]] = ...,
+    tuple_factory: Type[Sequence[Any]] = ...,
+    retain_collection_types: bool = ...,
+) -> Tuple[Any, ...]: ...
diff --git a/llm/Lib/site-packages/attrs/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/attrs/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b8ed642857ea4fbe01f89363808749553b6f8f49
Binary files /dev/null and b/llm/Lib/site-packages/attrs/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attrs/__pycache__/converters.cpython-311.pyc b/llm/Lib/site-packages/attrs/__pycache__/converters.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..66f0c498df490019b5f0c40f805783d752877b87
Binary files /dev/null and b/llm/Lib/site-packages/attrs/__pycache__/converters.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attrs/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/attrs/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a81aab4decc94cb903c54ceaf2c70b27a38937dc
Binary files /dev/null and b/llm/Lib/site-packages/attrs/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attrs/__pycache__/filters.cpython-311.pyc b/llm/Lib/site-packages/attrs/__pycache__/filters.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..40ecc43706b008e3510c45001ca8ecd964fee8c4
Binary files /dev/null and b/llm/Lib/site-packages/attrs/__pycache__/filters.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attrs/__pycache__/setters.cpython-311.pyc b/llm/Lib/site-packages/attrs/__pycache__/setters.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2c6a6f91187f73cec46ac878ac0b431f896ac127
Binary files /dev/null and b/llm/Lib/site-packages/attrs/__pycache__/setters.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attrs/__pycache__/validators.cpython-311.pyc b/llm/Lib/site-packages/attrs/__pycache__/validators.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..babfc81ca3117a93f736ff2eae4967c2c45e2c42
Binary files /dev/null and b/llm/Lib/site-packages/attrs/__pycache__/validators.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/attrs/converters.py b/llm/Lib/site-packages/attrs/converters.py
new file mode 100644
index 0000000000000000000000000000000000000000..7821f6c02cca81277d1ecc87b6bdafad886d8b70
--- /dev/null
+++ b/llm/Lib/site-packages/attrs/converters.py
@@ -0,0 +1,3 @@
+# SPDX-License-Identifier: MIT
+
+from attr.converters import *  # noqa: F403
diff --git a/llm/Lib/site-packages/attrs/exceptions.py b/llm/Lib/site-packages/attrs/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..3323f9d2112c54b203763d45b455bd5abbe020f6
--- /dev/null
+++ b/llm/Lib/site-packages/attrs/exceptions.py
@@ -0,0 +1,3 @@
+# SPDX-License-Identifier: MIT
+
+from attr.exceptions import *  # noqa: F403
diff --git a/llm/Lib/site-packages/attrs/filters.py b/llm/Lib/site-packages/attrs/filters.py
new file mode 100644
index 0000000000000000000000000000000000000000..3080f48398e5ed8d3428ca3efeb7500633b0cb0f
--- /dev/null
+++ b/llm/Lib/site-packages/attrs/filters.py
@@ -0,0 +1,3 @@
+# SPDX-License-Identifier: MIT
+
+from attr.filters import *  # noqa: F403
diff --git a/llm/Lib/site-packages/attrs/py.typed b/llm/Lib/site-packages/attrs/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/attrs/setters.py b/llm/Lib/site-packages/attrs/setters.py
new file mode 100644
index 0000000000000000000000000000000000000000..f3d73bb793dd49c138950961f41943bb26c57fde
--- /dev/null
+++ b/llm/Lib/site-packages/attrs/setters.py
@@ -0,0 +1,3 @@
+# SPDX-License-Identifier: MIT
+
+from attr.setters import *  # noqa: F403
diff --git a/llm/Lib/site-packages/attrs/validators.py b/llm/Lib/site-packages/attrs/validators.py
new file mode 100644
index 0000000000000000000000000000000000000000..037e124f29f32d37c1642d159bf828de44f7c349
--- /dev/null
+++ b/llm/Lib/site-packages/attrs/validators.py
@@ -0,0 +1,3 @@
+# SPDX-License-Identifier: MIT
+
+from attr.validators import *  # noqa: F403
diff --git a/llm/Lib/site-packages/blinker-1.7.0.dist-info/INSTALLER b/llm/Lib/site-packages/blinker-1.7.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/blinker-1.7.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/blinker-1.7.0.dist-info/LICENSE.rst b/llm/Lib/site-packages/blinker-1.7.0.dist-info/LICENSE.rst
new file mode 100644
index 0000000000000000000000000000000000000000..79c9825adbacb5d8c6eaee51863b8a40051d97c8
--- /dev/null
+++ b/llm/Lib/site-packages/blinker-1.7.0.dist-info/LICENSE.rst
@@ -0,0 +1,20 @@
+Copyright 2010 Jason Kirtland
+
+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 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.
diff --git a/llm/Lib/site-packages/blinker-1.7.0.dist-info/METADATA b/llm/Lib/site-packages/blinker-1.7.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..f96613c4b8a43f7e2ca78ed12e1e0270ab899e30
--- /dev/null
+++ b/llm/Lib/site-packages/blinker-1.7.0.dist-info/METADATA
@@ -0,0 +1,62 @@
+Metadata-Version: 2.1
+Name: blinker
+Version: 1.7.0
+Summary: Fast, simple object-to-object and broadcast signaling
+Keywords: signal,emit,events,broadcast
+Author-email: Jason Kirtland <jek@discorporate.us>
+Maintainer-email: Pallets Ecosystem <contact@palletsprojects.com>
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Topic :: Software Development :: Libraries
+Project-URL: Chat, https://discord.gg/pallets
+Project-URL: Documentation, https://blinker.readthedocs.io
+Project-URL: Homepage, https://blinker.readthedocs.io
+Project-URL: Issue Tracker, https://github.com/pallets-eco/blinker/issues/
+Project-URL: Source Code, https://github.com/pallets-eco/blinker/
+
+Blinker
+=======
+
+Blinker provides a fast dispatching system that allows any number of
+interested parties to subscribe to events, or "signals".
+
+Signal receivers can subscribe to specific senders or receive signals
+sent by any sender.
+
+.. code-block:: pycon
+
+    >>> from blinker import signal
+    >>> started = signal('round-started')
+    >>> def each(round):
+    ...     print(f"Round {round}")
+    ...
+    >>> started.connect(each)
+
+    >>> def round_two(round):
+    ...     print("This is round two.")
+    ...
+    >>> started.connect(round_two, sender=2)
+
+    >>> for round in range(1, 4):
+    ...     started.send(round)
+    ...
+    Round 1!
+    Round 2!
+    This is round two.
+    Round 3!
+
+
+Links
+-----
+
+-   Documentation: https://blinker.readthedocs.io/
+-   Changes: https://blinker.readthedocs.io/#changes
+-   PyPI Releases: https://pypi.org/project/blinker/
+-   Source Code: https://github.com/pallets-eco/blinker/
+-   Issue Tracker: https://github.com/pallets-eco/blinker/issues/
+
diff --git a/llm/Lib/site-packages/blinker-1.7.0.dist-info/RECORD b/llm/Lib/site-packages/blinker-1.7.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..036b9fe23005b3a45a01c26c7c284416e611f73e
--- /dev/null
+++ b/llm/Lib/site-packages/blinker-1.7.0.dist-info/RECORD
@@ -0,0 +1,14 @@
+blinker-1.7.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+blinker-1.7.0.dist-info/LICENSE.rst,sha256=nrc6HzhZekqhcCXSrhvjg5Ykx5XphdTw6Xac4p-spGc,1054
+blinker-1.7.0.dist-info/METADATA,sha256=kDgzPgrw4he78pEX88bSAqwYMVWrfUMk8QmNjekjg_U,1918
+blinker-1.7.0.dist-info/RECORD,,
+blinker-1.7.0.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+blinker/__init__.py,sha256=s75XaRDHwSDzZ21BZUOEkQDQIcQEyT8hT7vk3EhYFQU,408
+blinker/__pycache__/__init__.cpython-311.pyc,,
+blinker/__pycache__/_saferef.cpython-311.pyc,,
+blinker/__pycache__/_utilities.cpython-311.pyc,,
+blinker/__pycache__/base.cpython-311.pyc,,
+blinker/_saferef.py,sha256=kWOTIWnCY3kOb8lZP74Rbx7bR_BLVg4TjwzNCRLhKHs,9096
+blinker/_utilities.py,sha256=S2njKDmlBpK_yCK4RT8hq98hEj30I0TQCC5mNhtY22I,2856
+blinker/base.py,sha256=FqZmAI5YzuRrvRmye1Jb-utyVOjXtF5vUVP3-1u-HtU,20544
+blinker/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
diff --git a/llm/Lib/site-packages/blinker-1.7.0.dist-info/WHEEL b/llm/Lib/site-packages/blinker-1.7.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..3b5e64b5e6c4a210201d1676a891fd57b15cda99
--- /dev/null
+++ b/llm/Lib/site-packages/blinker-1.7.0.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: flit 3.9.0
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/blinker/__init__.py b/llm/Lib/site-packages/blinker/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d014caa0ff2564a1e83485fadd8c9b5efcdc3853
--- /dev/null
+++ b/llm/Lib/site-packages/blinker/__init__.py
@@ -0,0 +1,19 @@
+from blinker.base import ANY
+from blinker.base import NamedSignal
+from blinker.base import Namespace
+from blinker.base import receiver_connected
+from blinker.base import Signal
+from blinker.base import signal
+from blinker.base import WeakNamespace
+
+__all__ = [
+    "ANY",
+    "NamedSignal",
+    "Namespace",
+    "Signal",
+    "WeakNamespace",
+    "receiver_connected",
+    "signal",
+]
+
+__version__ = "1.7.0"
diff --git a/llm/Lib/site-packages/blinker/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/blinker/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a1f2cbe1f3e836ea8e68c4850453350421f5f346
Binary files /dev/null and b/llm/Lib/site-packages/blinker/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/blinker/__pycache__/_saferef.cpython-311.pyc b/llm/Lib/site-packages/blinker/__pycache__/_saferef.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6de89e20afbc101c2020def80410fbefb00b02f7
Binary files /dev/null and b/llm/Lib/site-packages/blinker/__pycache__/_saferef.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/blinker/__pycache__/_utilities.cpython-311.pyc b/llm/Lib/site-packages/blinker/__pycache__/_utilities.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bb75bb31a9f122f17a51b15eb8528e5f15988c90
Binary files /dev/null and b/llm/Lib/site-packages/blinker/__pycache__/_utilities.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/blinker/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/blinker/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..abac53ce87796b32bd424994509ec85cf09b36a5
Binary files /dev/null and b/llm/Lib/site-packages/blinker/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/blinker/_saferef.py b/llm/Lib/site-packages/blinker/_saferef.py
new file mode 100644
index 0000000000000000000000000000000000000000..dcb70c1899df9c8e5b4ead958d796efde6a2929e
--- /dev/null
+++ b/llm/Lib/site-packages/blinker/_saferef.py
@@ -0,0 +1,230 @@
+# extracted from Louie, http://pylouie.org/
+# updated for Python 3
+#
+# Copyright (c) 2006 Patrick K. O'Brien, Mike C. Fletcher,
+#                    Matthew R. Scott
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+#       notice, this list of conditions and the following disclaimer.
+#
+#     * Redistributions in binary form must reproduce the above
+#       copyright notice, this list of conditions and the following
+#       disclaimer in the documentation and/or other materials provided
+#       with the distribution.
+#
+#     * Neither the name of the <ORGANIZATION> nor the names of its
+#       contributors may be used to endorse or promote products derived
+#       from this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+"""Refactored 'safe reference from dispatcher.py"""
+import operator
+import sys
+import traceback
+import weakref
+
+
+get_self = operator.attrgetter("__self__")
+get_func = operator.attrgetter("__func__")
+
+
+def safe_ref(target, on_delete=None):
+    """Return a *safe* weak reference to a callable target.
+
+    - ``target``: The object to be weakly referenced, if it's a bound
+      method reference, will create a BoundMethodWeakref, otherwise
+      creates a simple weakref.
+
+    - ``on_delete``: If provided, will have a hard reference stored to
+      the callable to be called after the safe reference goes out of
+      scope with the reference object, (either a weakref or a
+      BoundMethodWeakref) as argument.
+    """
+    try:
+        im_self = get_self(target)
+    except AttributeError:
+        if callable(on_delete):
+            return weakref.ref(target, on_delete)
+        else:
+            return weakref.ref(target)
+    else:
+        if im_self is not None:
+            # Turn a bound method into a BoundMethodWeakref instance.
+            # Keep track of these instances for lookup by disconnect().
+            assert hasattr(target, "im_func") or hasattr(target, "__func__"), (
+                f"safe_ref target {target!r} has im_self, but no im_func, "
+                "don't know how to create reference"
+            )
+            reference = BoundMethodWeakref(target=target, on_delete=on_delete)
+            return reference
+
+
+class BoundMethodWeakref:
+    """'Safe' and reusable weak references to instance methods.
+
+    BoundMethodWeakref objects provide a mechanism for referencing a
+    bound method without requiring that the method object itself
+    (which is normally a transient object) is kept alive.  Instead,
+    the BoundMethodWeakref object keeps weak references to both the
+    object and the function which together define the instance method.
+
+    Attributes:
+
+    - ``key``: The identity key for the reference, calculated by the
+      class's calculate_key method applied to the target instance method.
+
+    - ``deletion_methods``: Sequence of callable objects taking single
+      argument, a reference to this object which will be called when
+      *either* the target object or target function is garbage
+      collected (i.e. when this object becomes invalid).  These are
+      specified as the on_delete parameters of safe_ref calls.
+
+    - ``weak_self``: Weak reference to the target object.
+
+    - ``weak_func``: Weak reference to the target function.
+
+    Class Attributes:
+
+    - ``_all_instances``: Class attribute pointing to all live
+      BoundMethodWeakref objects indexed by the class's
+      calculate_key(target) method applied to the target objects.
+      This weak value dictionary is used to short-circuit creation so
+      that multiple references to the same (object, function) pair
+      produce the same BoundMethodWeakref instance.
+    """
+
+    _all_instances = weakref.WeakValueDictionary()  # type: ignore[var-annotated]
+
+    def __new__(cls, target, on_delete=None, *arguments, **named):
+        """Create new instance or return current instance.
+
+        Basically this method of construction allows us to
+        short-circuit creation of references to already-referenced
+        instance methods.  The key corresponding to the target is
+        calculated, and if there is already an existing reference,
+        that is returned, with its deletion_methods attribute updated.
+        Otherwise the new instance is created and registered in the
+        table of already-referenced methods.
+        """
+        key = cls.calculate_key(target)
+        current = cls._all_instances.get(key)
+        if current is not None:
+            current.deletion_methods.append(on_delete)
+            return current
+        else:
+            base = super().__new__(cls)
+            cls._all_instances[key] = base
+            base.__init__(target, on_delete, *arguments, **named)
+            return base
+
+    def __init__(self, target, on_delete=None):
+        """Return a weak-reference-like instance for a bound method.
+
+        - ``target``: The instance-method target for the weak reference,
+          must have im_self and im_func attributes and be
+          reconstructable via the following, which is true of built-in
+          instance methods::
+
+            target.im_func.__get__( target.im_self )
+
+        - ``on_delete``: Optional callback which will be called when
+          this weak reference ceases to be valid (i.e. either the
+          object or the function is garbage collected).  Should take a
+          single argument, which will be passed a pointer to this
+          object.
+        """
+
+        def remove(weak, self=self):
+            """Set self.isDead to True when method or instance is destroyed."""
+            methods = self.deletion_methods[:]
+            del self.deletion_methods[:]
+            try:
+                del self.__class__._all_instances[self.key]
+            except KeyError:
+                pass
+            for function in methods:
+                try:
+                    if callable(function):
+                        function(self)
+                except Exception:
+                    try:
+                        traceback.print_exc()
+                    except AttributeError:
+                        e = sys.exc_info()[1]
+                        print(
+                            f"Exception during saferef {self} "
+                            f"cleanup function {function}: {e}"
+                        )
+
+        self.deletion_methods = [on_delete]
+        self.key = self.calculate_key(target)
+        im_self = get_self(target)
+        im_func = get_func(target)
+        self.weak_self = weakref.ref(im_self, remove)
+        self.weak_func = weakref.ref(im_func, remove)
+        self.self_name = str(im_self)
+        self.func_name = str(im_func.__name__)
+
+    @classmethod
+    def calculate_key(cls, target):
+        """Calculate the reference key for this reference.
+
+        Currently this is a two-tuple of the id()'s of the target
+        object and the target function respectively.
+        """
+        return (id(get_self(target)), id(get_func(target)))
+
+    def __str__(self):
+        """Give a friendly representation of the object."""
+        return "{}({}.{})".format(
+            self.__class__.__name__,
+            self.self_name,
+            self.func_name,
+        )
+
+    __repr__ = __str__
+
+    def __hash__(self):
+        return hash((self.self_name, self.key))
+
+    def __nonzero__(self):
+        """Whether we are still a valid reference."""
+        return self() is not None
+
+    def __eq__(self, other):
+        """Compare with another reference."""
+        if not isinstance(other, self.__class__):
+            return operator.eq(self.__class__, type(other))
+        return operator.eq(self.key, other.key)
+
+    def __call__(self):
+        """Return a strong reference to the bound method.
+
+        If the target cannot be retrieved, then will return None,
+        otherwise returns a bound instance method for our object and
+        function.
+
+        Note: You may call this method any number of times, as it does
+        not invalidate the reference.
+        """
+        target = self.weak_self()
+        if target is not None:
+            function = self.weak_func()
+            if function is not None:
+                return function.__get__(target)
+        return None
diff --git a/llm/Lib/site-packages/blinker/_utilities.py b/llm/Lib/site-packages/blinker/_utilities.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b711c67d3e1fb0f6e55cf75f5c63913e15bc63f
--- /dev/null
+++ b/llm/Lib/site-packages/blinker/_utilities.py
@@ -0,0 +1,105 @@
+from __future__ import annotations
+
+import typing as t
+from weakref import ref
+
+from blinker._saferef import BoundMethodWeakref
+
+IdentityType = t.Union[t.Tuple[int, int], str, int]
+
+
+class _symbol:
+    def __init__(self, name):
+        """Construct a new named symbol."""
+        self.__name__ = self.name = name
+
+    def __reduce__(self):
+        return symbol, (self.name,)
+
+    def __repr__(self):
+        return self.name
+
+
+_symbol.__name__ = "symbol"
+
+
+class symbol:
+    """A constant symbol.
+
+    >>> symbol('foo') is symbol('foo')
+    True
+    >>> symbol('foo')
+    foo
+
+    A slight refinement of the MAGICCOOKIE=object() pattern.  The primary
+    advantage of symbol() is its repr().  They are also singletons.
+
+    Repeated calls of symbol('name') will all return the same instance.
+
+    """
+
+    symbols = {}  # type: ignore[var-annotated]
+
+    def __new__(cls, name):
+        try:
+            return cls.symbols[name]
+        except KeyError:
+            return cls.symbols.setdefault(name, _symbol(name))
+
+
+def hashable_identity(obj: object) -> IdentityType:
+    if hasattr(obj, "__func__"):
+        return (id(obj.__func__), id(obj.__self__))  # type: ignore[attr-defined]
+    elif hasattr(obj, "im_func"):
+        return (id(obj.im_func), id(obj.im_self))  # type: ignore[attr-defined]
+    elif isinstance(obj, (int, str)):
+        return obj
+    else:
+        return id(obj)
+
+
+WeakTypes = (ref, BoundMethodWeakref)
+
+
+class annotatable_weakref(ref):
+    """A weakref.ref that supports custom instance attributes."""
+
+    receiver_id: t.Optional[IdentityType]
+    sender_id: t.Optional[IdentityType]
+
+
+def reference(  # type: ignore[no-untyped-def]
+    object, callback=None, **annotations
+) -> annotatable_weakref:
+    """Return an annotated weak ref."""
+    if callable(object):
+        weak = callable_reference(object, callback)
+    else:
+        weak = annotatable_weakref(object, callback)
+    for key, value in annotations.items():
+        setattr(weak, key, value)
+    return weak  # type: ignore[no-any-return]
+
+
+def callable_reference(object, callback=None):
+    """Return an annotated weak ref, supporting bound instance methods."""
+    if hasattr(object, "im_self") and object.im_self is not None:
+        return BoundMethodWeakref(target=object, on_delete=callback)
+    elif hasattr(object, "__self__") and object.__self__ is not None:
+        return BoundMethodWeakref(target=object, on_delete=callback)
+    return annotatable_weakref(object, callback)
+
+
+class lazy_property:
+    """A @property that is only evaluated once."""
+
+    def __init__(self, deferred):
+        self._deferred = deferred
+        self.__doc__ = deferred.__doc__
+
+    def __get__(self, obj, cls):
+        if obj is None:
+            return self
+        value = self._deferred(obj)
+        setattr(obj, self._deferred.__name__, value)
+        return value
diff --git a/llm/Lib/site-packages/blinker/base.py b/llm/Lib/site-packages/blinker/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9d703586deb018a80053c2a6406bef9b10ad961
--- /dev/null
+++ b/llm/Lib/site-packages/blinker/base.py
@@ -0,0 +1,558 @@
+"""Signals and events.
+
+A small implementation of signals, inspired by a snippet of Django signal
+API client code seen in a blog post.  Signals are first-class objects and
+each manages its own receivers and message emission.
+
+The :func:`signal` function provides singleton behavior for named signals.
+
+"""
+from __future__ import annotations
+
+import typing as t
+from collections import defaultdict
+from contextlib import contextmanager
+from inspect import iscoroutinefunction
+from warnings import warn
+from weakref import WeakValueDictionary
+
+from blinker._utilities import annotatable_weakref
+from blinker._utilities import hashable_identity
+from blinker._utilities import IdentityType
+from blinker._utilities import lazy_property
+from blinker._utilities import reference
+from blinker._utilities import symbol
+from blinker._utilities import WeakTypes
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+
+    T_callable = t.TypeVar("T_callable", bound=t.Callable[..., t.Any])
+
+    T = t.TypeVar("T")
+    P = te.ParamSpec("P")
+
+    AsyncWrapperType = t.Callable[[t.Callable[P, t.Awaitable[T]]], t.Callable[P, T]]
+    SyncWrapperType = t.Callable[[t.Callable[P, T]], t.Callable[P, t.Awaitable[T]]]
+
+ANY = symbol("ANY")
+ANY.__doc__ = 'Token for "any sender".'
+ANY_ID = 0
+
+# NOTE: We need a reference to cast for use in weakref callbacks otherwise
+#       t.cast may have already been set to None during finalization.
+cast = t.cast
+
+
+class Signal:
+    """A notification emitter."""
+
+    #: An :obj:`ANY` convenience synonym, allows ``Signal.ANY``
+    #: without an additional import.
+    ANY = ANY
+
+    set_class: type[set] = set
+
+    @lazy_property
+    def receiver_connected(self) -> Signal:
+        """Emitted after each :meth:`connect`.
+
+        The signal sender is the signal instance, and the :meth:`connect`
+        arguments are passed through: *receiver*, *sender*, and *weak*.
+
+        .. versionadded:: 1.2
+
+        """
+        return Signal(doc="Emitted after a receiver connects.")
+
+    @lazy_property
+    def receiver_disconnected(self) -> Signal:
+        """Emitted after :meth:`disconnect`.
+
+        The sender is the signal instance, and the :meth:`disconnect` arguments
+        are passed through: *receiver* and *sender*.
+
+        Note, this signal is emitted **only** when :meth:`disconnect` is
+        called explicitly.
+
+        The disconnect signal can not be emitted by an automatic disconnect
+        (due to a weakly referenced receiver or sender going out of scope),
+        as the receiver and/or sender instances are no longer available for
+        use at the time this signal would be emitted.
+
+        An alternative approach is available by subscribing to
+        :attr:`receiver_connected` and setting up a custom weakref cleanup
+        callback on weak receivers and senders.
+
+        .. versionadded:: 1.2
+
+        """
+        return Signal(doc="Emitted after a receiver disconnects.")
+
+    def __init__(self, doc: str | None = None) -> None:
+        """
+        :param doc: optional.  If provided, will be assigned to the signal's
+          __doc__ attribute.
+
+        """
+        if doc:
+            self.__doc__ = doc
+        #: A mapping of connected receivers.
+        #:
+        #: The values of this mapping are not meaningful outside of the
+        #: internal :class:`Signal` implementation, however the boolean value
+        #: of the mapping is useful as an extremely efficient check to see if
+        #: any receivers are connected to the signal.
+        self.receivers: dict[IdentityType, t.Callable | annotatable_weakref] = {}
+        self.is_muted = False
+        self._by_receiver: dict[IdentityType, set[IdentityType]] = defaultdict(
+            self.set_class
+        )
+        self._by_sender: dict[IdentityType, set[IdentityType]] = defaultdict(
+            self.set_class
+        )
+        self._weak_senders: dict[IdentityType, annotatable_weakref] = {}
+
+    def connect(
+        self, receiver: T_callable, sender: t.Any = ANY, weak: bool = True
+    ) -> T_callable:
+        """Connect *receiver* to signal events sent by *sender*.
+
+        :param receiver: A callable.  Will be invoked by :meth:`send` with
+          `sender=` as a single positional argument and any ``kwargs`` that
+          were provided to a call to :meth:`send`.
+
+        :param sender: Any object or :obj:`ANY`, defaults to ``ANY``.
+          Restricts notifications delivered to *receiver* to only those
+          :meth:`send` emissions sent by *sender*.  If ``ANY``, the receiver
+          will always be notified.  A *receiver* may be connected to
+          multiple *sender* values on the same Signal through multiple calls
+          to :meth:`connect`.
+
+        :param weak: If true, the Signal will hold a weakref to *receiver*
+          and automatically disconnect when *receiver* goes out of scope or
+          is garbage collected.  Defaults to True.
+
+        """
+        receiver_id = hashable_identity(receiver)
+        receiver_ref: T_callable | annotatable_weakref
+
+        if weak:
+            receiver_ref = reference(receiver, self._cleanup_receiver)
+            receiver_ref.receiver_id = receiver_id
+        else:
+            receiver_ref = receiver
+        sender_id: IdentityType
+        if sender is ANY:
+            sender_id = ANY_ID
+        else:
+            sender_id = hashable_identity(sender)
+
+        self.receivers.setdefault(receiver_id, receiver_ref)
+        self._by_sender[sender_id].add(receiver_id)
+        self._by_receiver[receiver_id].add(sender_id)
+        del receiver_ref
+
+        if sender is not ANY and sender_id not in self._weak_senders:
+            # wire together a cleanup for weakref-able senders
+            try:
+                sender_ref = reference(sender, self._cleanup_sender)
+                sender_ref.sender_id = sender_id
+            except TypeError:
+                pass
+            else:
+                self._weak_senders.setdefault(sender_id, sender_ref)
+                del sender_ref
+
+        # broadcast this connection.  if receivers raise, disconnect.
+        if "receiver_connected" in self.__dict__ and self.receiver_connected.receivers:
+            try:
+                self.receiver_connected.send(
+                    self, receiver=receiver, sender=sender, weak=weak
+                )
+            except TypeError as e:
+                self.disconnect(receiver, sender)
+                raise e
+        if receiver_connected.receivers and self is not receiver_connected:
+            try:
+                receiver_connected.send(
+                    self, receiver_arg=receiver, sender_arg=sender, weak_arg=weak
+                )
+            except TypeError as e:
+                self.disconnect(receiver, sender)
+                raise e
+        return receiver
+
+    def connect_via(
+        self, sender: t.Any, weak: bool = False
+    ) -> t.Callable[[T_callable], T_callable]:
+        """Connect the decorated function as a receiver for *sender*.
+
+        :param sender: Any object or :obj:`ANY`.  The decorated function
+          will only receive :meth:`send` emissions sent by *sender*.  If
+          ``ANY``, the receiver will always be notified.  A function may be
+          decorated multiple times with differing *sender* values.
+
+        :param weak: If true, the Signal will hold a weakref to the
+          decorated function and automatically disconnect when *receiver*
+          goes out of scope or is garbage collected.  Unlike
+          :meth:`connect`, this defaults to False.
+
+        The decorated function will be invoked by :meth:`send` with
+          `sender=` as a single positional argument and any ``kwargs`` that
+          were provided to the call to :meth:`send`.
+
+
+        .. versionadded:: 1.1
+
+        """
+
+        def decorator(fn: T_callable) -> T_callable:
+            self.connect(fn, sender, weak)
+            return fn
+
+        return decorator
+
+    @contextmanager
+    def connected_to(
+        self, receiver: t.Callable, sender: t.Any = ANY
+    ) -> t.Generator[None, None, None]:
+        """Execute a block with the signal temporarily connected to *receiver*.
+
+        :param receiver: a receiver callable
+        :param sender: optional, a sender to filter on
+
+        This is a context manager for use in the ``with`` statement.  It can
+        be useful in unit tests.  *receiver* is connected to the signal for
+        the duration of the ``with`` block, and will be disconnected
+        automatically when exiting the block:
+
+        .. code-block:: python
+
+          with on_ready.connected_to(receiver):
+             # do stuff
+             on_ready.send(123)
+
+        .. versionadded:: 1.1
+
+        """
+        self.connect(receiver, sender=sender, weak=False)
+        try:
+            yield None
+        finally:
+            self.disconnect(receiver)
+
+    @contextmanager
+    def muted(self) -> t.Generator[None, None, None]:
+        """Context manager for temporarily disabling signal.
+        Useful for test purposes.
+        """
+        self.is_muted = True
+        try:
+            yield None
+        except Exception as e:
+            raise e
+        finally:
+            self.is_muted = False
+
+    def temporarily_connected_to(
+        self, receiver: t.Callable, sender: t.Any = ANY
+    ) -> t.ContextManager[None]:
+        """An alias for :meth:`connected_to`.
+
+        :param receiver: a receiver callable
+        :param sender: optional, a sender to filter on
+
+        .. versionadded:: 0.9
+
+        .. versionchanged:: 1.1
+          Renamed to :meth:`connected_to`.  ``temporarily_connected_to`` was
+          deprecated in 1.2 and will be removed in a subsequent version.
+
+        """
+        warn(
+            "temporarily_connected_to is deprecated; use connected_to instead.",
+            DeprecationWarning,
+        )
+        return self.connected_to(receiver, sender)
+
+    def send(
+        self,
+        *sender: t.Any,
+        _async_wrapper: AsyncWrapperType | None = None,
+        **kwargs: t.Any,
+    ) -> list[tuple[t.Callable, t.Any]]:
+        """Emit this signal on behalf of *sender*, passing on ``kwargs``.
+
+        Returns a list of 2-tuples, pairing receivers with their return
+        value. The ordering of receiver notification is undefined.
+
+        :param sender: Any object or ``None``.  If omitted, synonymous
+          with ``None``.  Only accepts one positional argument.
+        :param _async_wrapper: A callable that should wrap a coroutine
+          receiver and run it when called synchronously.
+
+        :param kwargs: Data to be sent to receivers.
+        """
+        if self.is_muted:
+            return []
+
+        sender = self._extract_sender(sender)
+        results = []
+        for receiver in self.receivers_for(sender):
+            if iscoroutinefunction(receiver):
+                if _async_wrapper is None:
+                    raise RuntimeError("Cannot send to a coroutine function")
+                receiver = _async_wrapper(receiver)
+            result = receiver(sender, **kwargs)
+            results.append((receiver, result))
+        return results
+
+    async def send_async(
+        self,
+        *sender: t.Any,
+        _sync_wrapper: SyncWrapperType | None = None,
+        **kwargs: t.Any,
+    ) -> list[tuple[t.Callable, t.Any]]:
+        """Emit this signal on behalf of *sender*, passing on ``kwargs``.
+
+        Returns a list of 2-tuples, pairing receivers with their return
+        value. The ordering of receiver notification is undefined.
+
+        :param sender: Any object or ``None``.  If omitted, synonymous
+          with ``None``. Only accepts one positional argument.
+        :param _sync_wrapper: A callable that should wrap a synchronous
+          receiver and run it when awaited.
+
+        :param kwargs: Data to be sent to receivers.
+        """
+        if self.is_muted:
+            return []
+
+        sender = self._extract_sender(sender)
+        results = []
+        for receiver in self.receivers_for(sender):
+            if not iscoroutinefunction(receiver):
+                if _sync_wrapper is None:
+                    raise RuntimeError("Cannot send to a non-coroutine function")
+                receiver = _sync_wrapper(receiver)
+            result = await receiver(sender, **kwargs)
+            results.append((receiver, result))
+        return results
+
+    def _extract_sender(self, sender: t.Any) -> t.Any:
+        if not self.receivers:
+            # Ensure correct signature even on no-op sends, disable with -O
+            # for lowest possible cost.
+            if __debug__ and sender and len(sender) > 1:
+                raise TypeError(
+                    f"send() accepts only one positional argument, {len(sender)} given"
+                )
+            return []
+
+        # Using '*sender' rather than 'sender=None' allows 'sender' to be
+        # used as a keyword argument- i.e. it's an invisible name in the
+        # function signature.
+        if len(sender) == 0:
+            sender = None
+        elif len(sender) > 1:
+            raise TypeError(
+                f"send() accepts only one positional argument, {len(sender)} given"
+            )
+        else:
+            sender = sender[0]
+        return sender
+
+    def has_receivers_for(self, sender: t.Any) -> bool:
+        """True if there is probably a receiver for *sender*.
+
+        Performs an optimistic check only.  Does not guarantee that all
+        weakly referenced receivers are still alive.  See
+        :meth:`receivers_for` for a stronger search.
+
+        """
+        if not self.receivers:
+            return False
+        if self._by_sender[ANY_ID]:
+            return True
+        if sender is ANY:
+            return False
+        return hashable_identity(sender) in self._by_sender
+
+    def receivers_for(
+        self, sender: t.Any
+    ) -> t.Generator[t.Callable[[t.Any], t.Any], None, None]:
+        """Iterate all live receivers listening for *sender*."""
+        # TODO: test receivers_for(ANY)
+        if self.receivers:
+            sender_id = hashable_identity(sender)
+            if sender_id in self._by_sender:
+                ids = self._by_sender[ANY_ID] | self._by_sender[sender_id]
+            else:
+                ids = self._by_sender[ANY_ID].copy()
+            for receiver_id in ids:
+                receiver = self.receivers.get(receiver_id)
+                if receiver is None:
+                    continue
+                if isinstance(receiver, WeakTypes):
+                    strong = receiver()
+                    if strong is None:
+                        self._disconnect(receiver_id, ANY_ID)
+                        continue
+                    receiver = strong
+                yield receiver  # type: ignore[misc]
+
+    def disconnect(self, receiver: t.Callable, sender: t.Any = ANY) -> None:
+        """Disconnect *receiver* from this signal's events.
+
+        :param receiver: a previously :meth:`connected<connect>` callable
+
+        :param sender: a specific sender to disconnect from, or :obj:`ANY`
+          to disconnect from all senders.  Defaults to ``ANY``.
+
+        """
+        sender_id: IdentityType
+        if sender is ANY:
+            sender_id = ANY_ID
+        else:
+            sender_id = hashable_identity(sender)
+        receiver_id = hashable_identity(receiver)
+        self._disconnect(receiver_id, sender_id)
+
+        if (
+            "receiver_disconnected" in self.__dict__
+            and self.receiver_disconnected.receivers
+        ):
+            self.receiver_disconnected.send(self, receiver=receiver, sender=sender)
+
+    def _disconnect(self, receiver_id: IdentityType, sender_id: IdentityType) -> None:
+        if sender_id == ANY_ID:
+            if self._by_receiver.pop(receiver_id, False):
+                for bucket in self._by_sender.values():
+                    bucket.discard(receiver_id)
+            self.receivers.pop(receiver_id, None)
+        else:
+            self._by_sender[sender_id].discard(receiver_id)
+            self._by_receiver[receiver_id].discard(sender_id)
+
+    def _cleanup_receiver(self, receiver_ref: annotatable_weakref) -> None:
+        """Disconnect a receiver from all senders."""
+        self._disconnect(cast(IdentityType, receiver_ref.receiver_id), ANY_ID)
+
+    def _cleanup_sender(self, sender_ref: annotatable_weakref) -> None:
+        """Disconnect all receivers from a sender."""
+        sender_id = cast(IdentityType, sender_ref.sender_id)
+        assert sender_id != ANY_ID
+        self._weak_senders.pop(sender_id, None)
+        for receiver_id in self._by_sender.pop(sender_id, ()):
+            self._by_receiver[receiver_id].discard(sender_id)
+
+    def _cleanup_bookkeeping(self) -> None:
+        """Prune unused sender/receiver bookkeeping. Not threadsafe.
+
+        Connecting & disconnecting leave behind a small amount of bookkeeping
+        for the receiver and sender values. Typical workloads using Blinker,
+        for example in most web apps, Flask, CLI scripts, etc., are not
+        adversely affected by this bookkeeping.
+
+        With a long-running Python process performing dynamic signal routing
+        with high volume- e.g. connecting to function closures, "senders" are
+        all unique object instances, and doing all of this over and over- you
+        may see memory usage will grow due to extraneous bookkeeping. (An empty
+        set() for each stale sender/receiver pair.)
+
+        This method will prune that bookkeeping away, with the caveat that such
+        pruning is not threadsafe. The risk is that cleanup of a fully
+        disconnected receiver/sender pair occurs while another thread is
+        connecting that same pair. If you are in the highly dynamic, unique
+        receiver/sender situation that has lead you to this method, that
+        failure mode is perhaps not a big deal for you.
+        """
+        for mapping in (self._by_sender, self._by_receiver):
+            for _id, bucket in list(mapping.items()):
+                if not bucket:
+                    mapping.pop(_id, None)
+
+    def _clear_state(self) -> None:
+        """Throw away all signal state.  Useful for unit tests."""
+        self._weak_senders.clear()
+        self.receivers.clear()
+        self._by_sender.clear()
+        self._by_receiver.clear()
+
+
+receiver_connected = Signal(
+    """\
+Sent by a :class:`Signal` after a receiver connects.
+
+:argument: the Signal that was connected to
+:keyword receiver_arg: the connected receiver
+:keyword sender_arg: the sender to connect to
+:keyword weak_arg: true if the connection to receiver_arg is a weak reference
+
+.. deprecated:: 1.2
+
+As of 1.2, individual signals have their own private
+:attr:`~Signal.receiver_connected` and
+:attr:`~Signal.receiver_disconnected` signals with a slightly simplified
+call signature.  This global signal is planned to be removed in 1.6.
+
+"""
+)
+
+
+class NamedSignal(Signal):
+    """A named generic notification emitter."""
+
+    def __init__(self, name: str, doc: str | None = None) -> None:
+        Signal.__init__(self, doc)
+
+        #: The name of this signal.
+        self.name = name
+
+    def __repr__(self) -> str:
+        base = Signal.__repr__(self)
+        return f"{base[:-1]}; {self.name!r}>"  # noqa: E702
+
+
+class Namespace(dict):
+    """A mapping of signal names to signals."""
+
+    def signal(self, name: str, doc: str | None = None) -> NamedSignal:
+        """Return the :class:`NamedSignal` *name*, creating it if required.
+
+        Repeated calls to this function will return the same signal object.
+
+        """
+        try:
+            return self[name]  # type: ignore[no-any-return]
+        except KeyError:
+            result = self.setdefault(name, NamedSignal(name, doc))
+            return result  # type: ignore[no-any-return]
+
+
+class WeakNamespace(WeakValueDictionary):
+    """A weak mapping of signal names to signals.
+
+    Automatically cleans up unused Signals when the last reference goes out
+    of scope.  This namespace implementation exists for a measure of legacy
+    compatibility with Blinker <= 1.2, and may be dropped in the future.
+
+    .. versionadded:: 1.3
+
+    """
+
+    def signal(self, name: str, doc: str | None = None) -> NamedSignal:
+        """Return the :class:`NamedSignal` *name*, creating it if required.
+
+        Repeated calls to this function will return the same signal object.
+
+        """
+        try:
+            return self[name]  # type: ignore[no-any-return]
+        except KeyError:
+            result = self.setdefault(name, NamedSignal(name, doc))
+            return result  # type: ignore[no-any-return]
+
+
+signal = Namespace().signal
diff --git a/llm/Lib/site-packages/blinker/py.typed b/llm/Lib/site-packages/blinker/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/bson-0.5.10.dist-info/INSTALLER b/llm/Lib/site-packages/bson-0.5.10.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/bson-0.5.10.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/bson-0.5.10.dist-info/METADATA b/llm/Lib/site-packages/bson-0.5.10.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..952aa5b7f579d2a2dc8a7691a8e0c7b0698036df
--- /dev/null
+++ b/llm/Lib/site-packages/bson-0.5.10.dist-info/METADATA
@@ -0,0 +1,20 @@
+Metadata-Version: 2.1
+Name: bson
+Version: 0.5.10
+Summary: BSON codec for Python
+Home-page: http://github.com/py-bson/bson
+Author: Ayun Park
+Author-email: iamparkayun@gmail.com
+License: BSD
+Keywords: BSON codec
+Platform: Any
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Requires-Dist: python-dateutil >=2.4.0
+Requires-Dist: six >=1.9.0
+
+Independent BSON codec for Python that doesn't depend on MongoDB.
diff --git a/llm/Lib/site-packages/bson-0.5.10.dist-info/RECORD b/llm/Lib/site-packages/bson-0.5.10.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..8e22e1923efcd21637726ac28fa1b4d35ba81da4
--- /dev/null
+++ b/llm/Lib/site-packages/bson-0.5.10.dist-info/RECORD
@@ -0,0 +1,17 @@
+bson-0.5.10.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+bson-0.5.10.dist-info/METADATA,sha256=gLOkrPXUxKeFzWngtSYN8DsEEJzGuID_t0U_3pLYEow,677
+bson-0.5.10.dist-info/RECORD,,
+bson-0.5.10.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+bson-0.5.10.dist-info/top_level.txt,sha256=SndJcRKceJ1z6Wujx0zp_fVam-mKGGJYI7vJvCLNK4o,5
+bson/__init__.py,sha256=sumv2aJaj2UZKfWvDPKZ2rfSiatYWpZdZw9w-4OE6ac,2264
+bson/__pycache__/__init__.cpython-311.pyc,,
+bson/__pycache__/codec.cpython-311.pyc,,
+bson/__pycache__/network.cpython-311.pyc,,
+bson/__pycache__/objectid.cpython-311.pyc,,
+bson/__pycache__/py3compat.cpython-311.pyc,,
+bson/__pycache__/tz_util.cpython-311.pyc,,
+bson/codec.py,sha256=UlQ9jZhajCF-Yx9R3-GdS_2X0AYvGDJzzIUaXyeJAI0,12976
+bson/network.py,sha256=7_V25J42d-mUOvHOlEOx6QYwP5wmQRoyqcO0kfs4Gls,1569
+bson/objectid.py,sha256=AObuQF2dEOrgtJSatD2aHkcTip2fgoVFMTjbPOqSsSk,10004
+bson/py3compat.py,sha256=uRu5fXc9lx9toavXYcKUf5FXN3R26mtNi4PkZQTCcTc,2276
+bson/tz_util.py,sha256=Zy_bA8x2YWrTbIx08HQYYJVghKKwChcCkO4VSBwaNVU,1518
diff --git a/llm/Lib/site-packages/bson-0.5.10.dist-info/WHEEL b/llm/Lib/site-packages/bson-0.5.10.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..bab98d675883cc7567a79df485cd7b4f015e376f
--- /dev/null
+++ b/llm/Lib/site-packages/bson-0.5.10.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/bson-0.5.10.dist-info/top_level.txt b/llm/Lib/site-packages/bson-0.5.10.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..f18b5e8cd054c3fff012c41f70594e241f5f4c92
--- /dev/null
+++ b/llm/Lib/site-packages/bson-0.5.10.dist-info/top_level.txt
@@ -0,0 +1 @@
+bson
diff --git a/llm/Lib/site-packages/bson/__init__.py b/llm/Lib/site-packages/bson/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..85d712ed0c726a9d752ff914b10684c81486e317
--- /dev/null
+++ b/llm/Lib/site-packages/bson/__init__.py
@@ -0,0 +1,69 @@
+#!/usr/bin/python -OOOO
+# vim: set fileencoding=utf8 shiftwidth=4 tabstop=4 textwidth=80 foldmethod=marker :
+# Copyright (c) 2010, Kou Man Tong. All rights reserved.
+# For licensing, see LICENSE file included in the package.
+"""
+BSON serialization and deserialization logic.
+Specifications taken from: http://bsonspec.org/#/specification
+The following types are unsupported, because for data exchange purposes, they're
+over-engineered:
+    0x06 (Undefined)
+    0x0b (Regex - Exactly which flavor do you want? Better let higher level
+        programmers make that decision.)
+    0x0c (DBPointer)
+    0x0d (JavaScript code)
+    0x0e (Symbol)
+    0x0f (JS w/ scope)
+    0x11 (MongoDB-specific timestamp)
+
+For binaries, only the default 0x0 type is supported.
+"""
+
+from .codec import *
+from .objectid import ObjectId
+
+__all__ = ["loads", "dumps"]
+
+
+def dumps(obj, generator=None, on_unknown=None):
+    """
+    Given a dict, outputs a BSON string.
+
+    generator is an optional function which accepts the dictionary/array being
+    encoded, the current DFS traversal stack, and outputs an iterator indicating
+    the correct encoding order for keys.
+    """
+    if isinstance(obj, BSONCoding):
+        return encode_object(obj, [],
+                             generator_func=generator, on_unknown=on_unknown)
+    return encode_document(obj, [],
+                           generator_func=generator, on_unknown=on_unknown)
+
+
+def loads(data):
+    """
+        Given a BSON string, outputs a dict.
+    """
+    return decode_document(data, 0)[1]
+
+
+def patch_socket():
+    """
+        Patches the Python socket class such that sockets can send and receive BSON
+        objects atomically.
+
+        This adds the following functions to socket:
+
+        recvbytes(bytes_needed, sock_buf = None) - reads bytes_needed bytes
+        atomically. Returns None if socket closed.
+
+        recvobj() - reads a BSON document from the socket atomically and returns
+        the deserialized dictionary. Returns None if socket closed.
+
+        sendobj(obj) - sends a BSON document to the socket atomically.
+    """
+    from socket import socket
+    from .network import recvbytes, recvobj, sendobj
+    socket.recvbytes = recvbytes
+    socket.recvobj = recvobj
+    socket.sendobj = sendobj
diff --git a/llm/Lib/site-packages/bson/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/bson/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..faf39d263966257ff859237c33c47f4bded8ed8f
Binary files /dev/null and b/llm/Lib/site-packages/bson/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/bson/__pycache__/codec.cpython-311.pyc b/llm/Lib/site-packages/bson/__pycache__/codec.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7eef361d858eef059bc12585e572a5c2a7ddd6e3
Binary files /dev/null and b/llm/Lib/site-packages/bson/__pycache__/codec.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/bson/__pycache__/network.cpython-311.pyc b/llm/Lib/site-packages/bson/__pycache__/network.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..99ffedd617ad29d86b1f41425f7fd93a18a2183f
Binary files /dev/null and b/llm/Lib/site-packages/bson/__pycache__/network.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/bson/__pycache__/objectid.cpython-311.pyc b/llm/Lib/site-packages/bson/__pycache__/objectid.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6aa2d9bd3aa40f7256ad857df8c69881f024929b
Binary files /dev/null and b/llm/Lib/site-packages/bson/__pycache__/objectid.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/bson/__pycache__/py3compat.cpython-311.pyc b/llm/Lib/site-packages/bson/__pycache__/py3compat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d1118fed2bf72d41958ab2c3dbe347e5c7ebae11
Binary files /dev/null and b/llm/Lib/site-packages/bson/__pycache__/py3compat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/bson/__pycache__/tz_util.cpython-311.pyc b/llm/Lib/site-packages/bson/__pycache__/tz_util.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ab56bdb416532af21b552b55fef04204a1d9656c
Binary files /dev/null and b/llm/Lib/site-packages/bson/__pycache__/tz_util.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/bson/codec.py b/llm/Lib/site-packages/bson/codec.py
new file mode 100644
index 0000000000000000000000000000000000000000..88e0bf8f356ad4c287e3ea63316de65daa212e13
--- /dev/null
+++ b/llm/Lib/site-packages/bson/codec.py
@@ -0,0 +1,400 @@
+#!/usr/bin/python -OOOO
+# vim: set fileencoding=utf8 shiftwidth=4 tabstop=4 textwidth=80 foldmethod=marker :
+# Copyright (c) 2010, Kou Man Tong. All rights reserved.
+# Copyright (c) 2015, Ayun Park. All rights reserved.
+# For licensing, see LICENSE file included in the package.
+"""
+Base codec functions for bson.
+"""
+import struct
+import warnings
+from datetime import datetime
+from abc import ABCMeta, abstractmethod
+from uuid import UUID
+from decimal import Decimal
+try:
+    from io import BytesIO as StringIO
+except ImportError:
+    from cStringIO import StringIO
+
+import calendar
+from dateutil.tz import tzutc
+from binascii import b2a_hex
+
+from six import integer_types, iterkeys, text_type, PY3
+from six.moves import xrange
+
+
+utc = tzutc()
+
+class MissingClassDefinition(ValueError):
+    def __init__(self, class_name):
+        super(MissingClassDefinition,
+              self).__init__("No class definition for class %s" % (class_name,))
+
+
+class UnknownSerializerError(ValueError):
+    def __init__(self, key, value):
+        super(UnknownSerializerError,
+              self).__init__("Unable to serialize: key '%s' value: %s type: %s" % (key,value, type(value)))
+
+
+class MissingTimezoneWarning(RuntimeWarning):
+    def __init__(self, *args):
+        args = list(args)
+        if len(args) < 1:
+            args.append("Input datetime object has no tzinfo, assuming UTC.")
+        super(MissingTimezoneWarning, self).__init__(*args)
+
+
+class TraversalStep(object):
+    def __init__(self, parent, key):
+        self.parent = parent
+        self.key = key
+
+
+class BSONCoding(object):
+    __metaclass__ = ABCMeta
+
+    @abstractmethod
+    def bson_encode(self):
+        pass
+
+    @abstractmethod
+    def bson_init(self, raw_values):
+        pass
+
+
+classes = {}
+
+
+def import_class(cls):
+    if not issubclass(cls, BSONCoding):
+        return
+
+    global classes
+    classes[cls.__name__] = cls
+
+
+def import_classes(*args):
+    for cls in args:
+        import_class(cls)
+
+
+def import_classes_from_modules(*args):
+    for module in args:
+        for item in module.__dict__:
+            if hasattr(item, "__new__") and hasattr(item, "__name__"):
+                import_class(item)
+
+
+def encode_object(obj, traversal_stack, generator_func, on_unknown=None):
+    values = obj.bson_encode()
+    class_name = obj.__class__.__name__
+    values["$$__CLASS_NAME__$$"] = class_name
+    return encode_document(values, traversal_stack, obj,
+                           generator_func, on_unknown)
+
+
+def encode_object_element(name, value, traversal_stack,
+                          generator_func, on_unknown):
+    return b"\x03" + encode_cstring(name) + \
+           encode_object(value, traversal_stack,
+                         generator_func=generator_func, on_unknown=on_unknown)
+
+
+class _EmptyClass(object):
+    pass
+
+
+def decode_object(raw_values):
+    global classes
+    class_name = raw_values["$$__CLASS_NAME__$$"]
+    try:
+        cls = classes[class_name]
+    except KeyError:
+        raise MissingClassDefinition(class_name)
+
+    retval = _EmptyClass()
+    retval.__class__ = cls
+    alt_retval = retval.bson_init(raw_values)
+    return alt_retval or retval
+
+
+def encode_string(value):
+    value = value.encode("utf-8")
+    length = len(value)
+    return struct.pack("<i%dsb" % (length,), length + 1, value, 0)
+
+
+def encode_cstring(value):
+    if not isinstance(value, bytes):
+        value = text_type(value).encode("utf-8")
+    if b"\x00" in value:
+        raise ValueError("Element names may not include NUL bytes.")
+        # A NUL byte is used to delimit our string, accepting one would cause
+        # our string to terminate early.
+    return value + b"\x00"
+
+
+def encode_binary(value, binary_subtype=0):
+    length = len(value)
+    return struct.pack("<ib", length, binary_subtype) + value
+
+
+def encode_double(value):
+    return struct.pack("<d", value)
+
+
+ELEMENT_TYPES = {
+    0x01: "double",
+    0x02: "string",
+    0x03: "document",
+    0x04: "array",
+    0x05: "binary",
+    0x07: "object_id",
+    0x08: "boolean",
+    0x09: "UTCdatetime",
+    0x0A: "none",
+    0x10: "int32",
+    0x11: "uint64",
+    0x12: "int64"
+}
+
+
+def encode_double_element(name, value):
+    return b"\x01" + encode_cstring(name) + encode_double(value)
+
+
+def encode_string_element(name, value):
+    return b"\x02" + encode_cstring(name) + encode_string(value)
+
+
+def _is_string(value):
+    if isinstance(value, text_type):
+        return True
+    elif isinstance(value, str) or isinstance(value, bytes):
+        try:
+            unicode(value, errors='strict')
+            return True
+        except:
+            pass
+    return False
+
+
+def encode_value(name, value, buf, traversal_stack,
+                 generator_func, on_unknown=None):
+    if isinstance(value, bool):
+        buf.write(encode_boolean_element(name, value))
+    elif isinstance(value, integer_types):
+        if value < -0x80000000 or 0x7FFFFFFFFFFFFFFF >= value > 0x7fffffff:
+            buf.write(encode_int64_element(name, value))
+        elif value > 0x7FFFFFFFFFFFFFFF:
+            if value > 0xFFFFFFFFFFFFFFFF:
+                raise Exception("BSON format supports only int value < %s" % 0xFFFFFFFFFFFFFFFF) 
+            buf.write(encode_uint64_element(name, value))
+        else:
+            buf.write(encode_int32_element(name, value))
+    elif isinstance(value, float):
+        buf.write(encode_double_element(name, value))
+    elif _is_string(value):
+        buf.write(encode_string_element(name, value))
+    elif isinstance(value, str) or isinstance(value, bytes):
+        buf.write(encode_binary_element(name, value))
+    elif isinstance(value, UUID):
+        buf.write(encode_binary_element(name, value.bytes, binary_subtype=4))
+    elif isinstance(value, datetime):
+        buf.write(encode_utc_datetime_element(name, value))
+    elif value is None:
+        buf.write(encode_none_element(name, value))
+    elif isinstance(value, dict):
+        buf.write(encode_document_element(name, value, traversal_stack,
+                                          generator_func, on_unknown))
+    elif isinstance(value, list) or isinstance(value, tuple):
+        buf.write(encode_array_element(name, value, traversal_stack,
+                                       generator_func, on_unknown))
+    elif isinstance(value, BSONCoding):
+        buf.write(encode_object_element(name, value, traversal_stack,
+                                        generator_func, on_unknown))
+    elif isinstance(value, Decimal):
+        buf.write(encode_double_element(name, float(value)))
+    else:
+        if on_unknown is not None:
+            encode_value(name, on_unknown(value), buf, traversal_stack,
+                         generator_func, on_unknown)
+        else:
+            raise UnknownSerializerError(name, value)
+
+
+def encode_document(obj, traversal_stack, traversal_parent=None,
+                    generator_func=None, on_unknown=None):
+    buf = StringIO()
+    key_iter = iterkeys(obj)
+    if generator_func is not None:
+        key_iter = generator_func(obj, traversal_stack)
+    for name in key_iter:
+        value = obj[name]
+        traversal_stack.append(TraversalStep(traversal_parent or obj, name))
+        encode_value(name, value, buf, traversal_stack,
+                     generator_func, on_unknown)
+        traversal_stack.pop()
+    e_list = buf.getvalue()
+    e_list_length = len(e_list)
+    return struct.pack("<i%dsb" % (e_list_length,),
+                       e_list_length + 4 + 1, e_list, 0)
+
+
+def encode_array(array, traversal_stack, traversal_parent=None,
+                 generator_func=None, on_unknown=None):
+    buf = StringIO()
+    for i in xrange(0, len(array)):
+        value = array[i]
+        traversal_stack.append(TraversalStep(traversal_parent or array, i))
+        encode_value(str(i), value, buf, traversal_stack,
+                     generator_func, on_unknown)
+        traversal_stack.pop()
+    e_list = buf.getvalue()
+    e_list_length = len(e_list)
+    return struct.pack("<i%dsb" % (e_list_length,),
+                       e_list_length + 4 + 1, e_list, 0)
+
+
+def decode_binary_subtype(value, binary_subtype):
+    if binary_subtype in [0x03, 0x04]:  # legacy UUID, UUID
+        return UUID(bytes=value)
+    return value
+
+
+def decode_document(data, base, as_array=False):
+    # Create all the struct formats we might use.
+    double_struct = struct.Struct("<d")
+    int_struct = struct.Struct("<i")
+    char_struct = struct.Struct("<b")
+    long_struct = struct.Struct("<q")
+    uint64_struct = struct.Struct("<Q")
+    int_char_struct = struct.Struct("<ib")
+
+    length = struct.unpack("<i", data[base:base + 4])[0]
+    end_point = base + length
+    if data[end_point - 1] not in ('\0', 0):
+        raise ValueError('missing null-terminator in document')
+    base += 4
+    retval = [] if as_array else {}
+    decode_name = not as_array
+
+    while base < end_point - 1:
+
+        element_type = char_struct.unpack(data[base:base + 1])[0]
+
+        if PY3:
+            ll = data.index(0, base + 1) + 1
+        else:
+            ll = data.index("\x00", base + 1) + 1
+        if decode_name:
+            name = data[base + 1:ll - 1]
+            try:
+                name = name.decode("utf-8")
+            except UnicodeDecodeError:
+                pass
+        else:
+            name = None
+        base = ll
+
+        if element_type == 0x01:  # double
+            value = double_struct.unpack(data[base: base + 8])[0]
+            base += 8
+        elif element_type == 0x02:  # string
+            length = int_struct.unpack(data[base:base + 4])[0]
+            value = data[base + 4: base + 4 + length - 1]
+            value = value.decode("utf-8")
+            base += 4 + length
+        elif element_type == 0x03:  # document
+            base, value = decode_document(data, base)
+        elif element_type == 0x04:  # array
+            base, value = decode_document(data, base, as_array=True)
+        elif element_type == 0x05:  # binary
+            length, binary_subtype = int_char_struct.unpack(
+                data[base:base + 5])
+            value = data[base + 5:base + 5 + length]
+            value = decode_binary_subtype(value, binary_subtype)
+            base += 5 + length
+        elif element_type == 0x07:  # object_id
+            value = b2a_hex(data[base:base + 12])
+            base += 12
+        elif element_type == 0x08:  # boolean
+            value = bool(char_struct.unpack(data[base:base + 1])[0])
+            base += 1
+        elif element_type == 0x09:  # UTCdatetime
+            value = datetime.fromtimestamp(
+                long_struct.unpack(data[base:base + 8])[0] / 1000.0, utc)
+            base += 8
+        elif element_type == 0x0A:  # none
+            value = None
+        elif element_type == 0x10:  # int32
+            value = int_struct.unpack(data[base:base + 4])[0]
+            base += 4
+        elif element_type == 0x11:  # uint64
+            value = uint64_struct.unpack(data[base:base + 8])[0]
+            base += 8
+        elif element_type == 0x12:  # int64
+            value = long_struct.unpack(data[base:base + 8])[0]
+            base += 8
+
+        if as_array:
+            retval.append(value)
+        else:
+            retval[name] = value
+    if "$$__CLASS_NAME__$$" in retval:
+        retval = decode_object(retval)
+    return end_point, retval
+
+
+def encode_document_element(name, value, traversal_stack,
+                            generator_func, on_unknown):
+    return b"\x03" + encode_cstring(name) + \
+           encode_document(value, traversal_stack,
+                           generator_func=generator_func, on_unknown=on_unknown)
+
+
+def encode_array_element(name, value, traversal_stack,
+                         generator_func, on_unknown):
+    return b"\x04" + encode_cstring(name) + \
+           encode_array(value, traversal_stack,
+                        generator_func=generator_func, on_unknown=on_unknown)
+
+
+def encode_binary_element(name, value, binary_subtype=0):
+    return b"\x05" + encode_cstring(name) + encode_binary(value, binary_subtype=binary_subtype)
+
+
+def encode_boolean_element(name, value):
+    return b"\x08" + encode_cstring(name) + struct.pack("<b", value)
+
+
+def encode_utc_datetime_element(name, value):
+    if value.tzinfo is None:
+        warnings.warn(MissingTimezoneWarning(), None, 4)
+    value = int(round(calendar.timegm(value.utctimetuple()) * 1000 +
+                      (value.microsecond / 1000.0)))
+    return b"\x09" + encode_cstring(name) + struct.pack("<q", value)
+
+
+def encode_none_element(name, value):
+    return b"\x0a" + encode_cstring(name)
+
+
+def encode_int32_element(name, value):
+    value = struct.pack("<i", value)
+    return b"\x10" + encode_cstring(name) + value
+
+
+def encode_uint64_element(name, value):
+    return b"\x11" + encode_cstring(name) + struct.pack("<Q", value)
+
+
+def encode_int64_element(name, value):
+    return b"\x12" + encode_cstring(name) + struct.pack("<q", value)
+
+
+def encode_object_id_element(name, value):
+    return b"\x07" + encode_cstring(name) + value
diff --git a/llm/Lib/site-packages/bson/network.py b/llm/Lib/site-packages/bson/network.py
new file mode 100644
index 0000000000000000000000000000000000000000..d24e5bd9e9fd406f8f3c82fb0f86d9f5f937c9f5
--- /dev/null
+++ b/llm/Lib/site-packages/bson/network.py
@@ -0,0 +1,67 @@
+#!/usr/bin/env python
+from struct import unpack
+
+from six import BytesIO, b
+
+from . import dumps, loads
+
+
+def _bintoint(data):
+    return unpack("<i", data)[0]
+
+
+def sendobj(self, obj):
+    """
+        Atomically send a BSON message.
+    """
+    data = dumps(obj)
+    self.sendall(data)
+
+
+def recvobj(self):
+    """
+        Atomic read of a BSON message.
+
+        This function either returns a dict, None, or raises a socket error.
+
+        If the return value is None, it means the socket is closed by the other side.
+    """
+    sock_buf = self.recvbytes(4)
+    if sock_buf is None:
+        return None
+
+    message_length = _bintoint(sock_buf.getvalue())
+    sock_buf = self.recvbytes(message_length - 4, sock_buf)
+    if sock_buf is None:
+        return None
+
+    retval = loads(sock_buf.getvalue())
+    return retval
+
+
+def recvbytes(self, bytes_needed, sock_buf = None):
+    """
+        Atomic read of bytes_needed bytes.
+
+        This function either returns exactly the nmber of bytes requested in a
+        StringIO buffer, None, or raises a socket error.
+
+        If the return value is None, it means the socket is closed by the other side.
+    """
+    if sock_buf is None:
+        sock_buf = BytesIO()
+    bytes_count = 0
+    while bytes_count < bytes_needed:
+        chunk = self.recv(min(bytes_needed - bytes_count, 32768))
+        part_count = len(chunk)
+
+        if type(chunk) == str:
+            chunk = b(chunk)
+
+        if part_count < 1:
+            return None
+
+        bytes_count += part_count
+        sock_buf.write(chunk)
+
+    return sock_buf
diff --git a/llm/Lib/site-packages/bson/objectid.py b/llm/Lib/site-packages/bson/objectid.py
new file mode 100644
index 0000000000000000000000000000000000000000..35061b1efc8d0e3dedda80a5d1713a4f179f6085
--- /dev/null
+++ b/llm/Lib/site-packages/bson/objectid.py
@@ -0,0 +1,309 @@
+# Copyright 2009-2015 MongoDB, Inc.
+# Modifications copyright (C) 2018 Gabriel Leopoldino
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Tools for working with MongoDB `ObjectIds
+<http://dochub.mongodb.org/core/objectids>`_.
+"""
+
+import binascii
+import calendar
+import datetime
+import os
+import random
+import socket
+import struct
+import threading
+import time
+
+from bson.py3compat import PY3, bytes_from_hex, string_type, text_type
+from bson.tz_util import utc
+
+
+# fnv_1a_24 adaptation taken from MongoDB Python Driver at https://github.com/mongodb/mongo-python-driver/commit/61850357a0e0eeec1a30e1adc0bbf7ebee807358
+if PY3:
+    _ord = lambda x: x
+else:
+    _ord = ord
+# http://isthe.com/chongo/tech/comp/fnv/index.html#FNV-1a
+def _fnv_1a_24(data, _ord=_ord):
+    """FNV-1a 24 bit hash"""
+    # http://www.isthe.com/chongo/tech/comp/fnv/index.html#xor-fold
+    # Start with FNV-1a 32 bit.
+    hash_size = 2 ** 32
+    fnv_32_prime = 16777619
+    fnv_1a_hash = 2166136261  # 32-bit FNV-1 offset basis
+    for elt in data:
+        fnv_1a_hash = fnv_1a_hash ^ _ord(elt)
+        fnv_1a_hash = (fnv_1a_hash * fnv_32_prime) % hash_size
+    # xor-fold the result to 24 bit.
+    return (fnv_1a_hash >> 24) ^ (fnv_1a_hash & 0xffffff)
+
+def _machine_bytes():
+    """Get the machine portion of an ObjectId.
+    """
+    # gethostname() returns a unicode string in python 3.x
+    # We only need 3 bytes, and _fnv_1a_24 returns a 24 bit integer.
+    # Remove the padding byte.
+    return struct.pack("<I", _fnv_1a_24(socket.gethostname().encode()))[:3]
+
+
+class InvalidId(ValueError):
+    """Raised when trying to create an ObjectId from invalid data.
+    """
+
+def _raise_invalid_id(oid):
+    raise InvalidId(
+        "%r is not a valid ObjectId, it must be a 12-byte input"
+        " or a 24-character hex string" % oid)
+
+
+class ObjectId(object):
+    """A MongoDB ObjectId.
+    """
+
+    _inc = random.randint(0, 0xFFFFFF)
+    _inc_lock = threading.Lock()
+
+    _machine_bytes = _machine_bytes()
+
+    __slots__ = ('__id')
+
+    _type_marker = 7
+
+    def __init__(self, oid=None):
+        """Initialize a new ObjectId.
+
+        An ObjectId is a 12-byte unique identifier consisting of:
+
+          - a 4-byte value representing the seconds since the Unix epoch,
+          - a 3-byte machine identifier,
+          - a 2-byte process id, and
+          - a 3-byte counter, starting with a random value.
+
+        By default, ``ObjectId()`` creates a new unique identifier. The
+        optional parameter `oid` can be an :class:`ObjectId`, or any 12
+        :class:`bytes` or, in Python 2, any 12-character :class:`str`.
+
+        For example, the 12 bytes b'foo-bar-quux' do not follow the ObjectId
+        specification but they are acceptable input::
+
+          >>> ObjectId(b'foo-bar-quux')
+          ObjectId('666f6f2d6261722d71757578')
+
+        `oid` can also be a :class:`unicode` or :class:`str` of 24 hex digits::
+
+          >>> ObjectId('0123456789ab0123456789ab')
+          ObjectId('0123456789ab0123456789ab')
+          >>>
+          >>> # A u-prefixed unicode literal:
+          >>> ObjectId(u'0123456789ab0123456789ab')
+          ObjectId('0123456789ab0123456789ab')
+
+        Raises :class:`~bson.errors.InvalidId` if `oid` is not 12 bytes nor
+        24 hex digits, or :class:`TypeError` if `oid` is not an accepted type.
+
+        :Parameters:
+          - `oid` (optional): a valid ObjectId.
+
+        .. mongodoc:: objectids
+        """
+        if oid is None:
+            self.__generate()
+        elif isinstance(oid, bytes) and len(oid) == 12:
+            self.__id = oid
+        else:
+            self.__validate(oid)
+
+    @classmethod
+    def from_datetime(cls, generation_time):
+        """Create a dummy ObjectId instance with a specific generation time.
+
+        This method is useful for doing range queries on a field
+        containing :class:`ObjectId` instances.
+
+        .. warning::
+           It is not safe to insert a document containing an ObjectId
+           generated using this method. This method deliberately
+           eliminates the uniqueness guarantee that ObjectIds
+           generally provide. ObjectIds generated with this method
+           should be used exclusively in queries.
+
+        `generation_time` will be converted to UTC. Naive datetime
+        instances will be treated as though they already contain UTC.
+
+        An example using this helper to get documents where ``"_id"``
+        was generated before January 1, 2010 would be:
+
+        >>> gen_time = datetime.datetime(2010, 1, 1)
+        >>> dummy_id = ObjectId.from_datetime(gen_time)
+        >>> result = collection.find({"_id": {"$lt": dummy_id}})
+
+        :Parameters:
+          - `generation_time`: :class:`~datetime.datetime` to be used
+            as the generation time for the resulting ObjectId.
+        """
+        if generation_time.utcoffset() is not None:
+            generation_time = generation_time - generation_time.utcoffset()
+        timestamp = calendar.timegm(generation_time.timetuple())
+        oid = struct.pack(
+            ">i", int(timestamp)) + b"\x00\x00\x00\x00\x00\x00\x00\x00"
+        return cls(oid)
+
+    @classmethod
+    def is_valid(cls, oid):
+        """Checks if a `oid` string is valid or not.
+
+        :Parameters:
+          - `oid`: the object id to validate
+
+        .. versionadded:: 2.3
+        """
+        if not oid:
+            return False
+
+        try:
+            ObjectId(oid)
+            return True
+        except (InvalidId, TypeError):
+            return False
+
+    def __generate(self):
+        """Generate a new value for this ObjectId.
+        """
+
+        # 4 bytes current time
+        oid = struct.pack(">i", int(time.time()))
+
+        # 3 bytes machine
+        oid += ObjectId._machine_bytes
+
+        # 2 bytes pid
+        oid += struct.pack(">H", os.getpid() % 0xFFFF)
+
+        # 3 bytes inc
+        with ObjectId._inc_lock:
+            oid += struct.pack(">i", ObjectId._inc)[1:4]
+            ObjectId._inc = (ObjectId._inc + 1) % 0xFFFFFF
+
+        self.__id = oid
+
+    def __validate(self, oid):
+        """Validate and use the given id for this ObjectId.
+
+        Raises TypeError if id is not an instance of
+        (:class:`basestring` (:class:`str` or :class:`bytes`
+        in python 3), ObjectId) and InvalidId if it is not a
+        valid ObjectId.
+
+        :Parameters:
+          - `oid`: a valid ObjectId
+        """
+        if isinstance(oid, ObjectId):
+            self.__id = oid.binary
+        # bytes or unicode in python 2, str in python 3
+        elif isinstance(oid, string_type):
+            if len(oid) == 24:
+                try:
+                    self.__id = bytes_from_hex(oid)
+                except (TypeError, ValueError):
+                    _raise_invalid_id(oid)
+            else:
+                _raise_invalid_id(oid)
+        else:
+            raise TypeError("id must be an instance of (bytes, %s, ObjectId), "
+                            "not %s" % (text_type.__name__, type(oid)))
+
+    @property
+    def binary(self):
+        """12-byte binary representation of this ObjectId.
+        """
+        return self.__id
+
+    @property
+    def generation_time(self):
+        """A :class:`datetime.datetime` instance representing the time of
+        generation for this :class:`ObjectId`.
+
+        The :class:`datetime.datetime` is timezone aware, and
+        represents the generation time in UTC. It is precise to the
+        second.
+        """
+        timestamp = struct.unpack(">i", self.__id[0:4])[0]
+        return datetime.datetime.fromtimestamp(timestamp, utc)
+
+    def __getstate__(self):
+        """return value of object for pickling.
+        needed explicitly because __slots__() defined.
+        """
+        return self.__id
+
+    def __setstate__(self, value):
+        """explicit state set from pickling
+        """
+        # Provide backwards compatability with OIDs
+        # pickled with pymongo-1.9 or older.
+        if isinstance(value, dict):
+            oid = value["_ObjectId__id"]
+        else:
+            oid = value
+        # ObjectIds pickled in python 2.x used `str` for __id.
+        # In python 3.x this has to be converted to `bytes`
+        # by encoding latin-1.
+        if PY3 and isinstance(oid, text_type):
+            self.__id = oid.encode('latin-1')
+        else:
+            self.__id = oid
+
+    def __str__(self):
+        if PY3:
+            return binascii.hexlify(self.__id).decode()
+        return binascii.hexlify(self.__id)
+
+    def __repr__(self):
+        return "ObjectId('%s')" % (str(self),)
+
+    def __eq__(self, other):
+        if isinstance(other, ObjectId):
+            return self.__id == other.binary
+        return NotImplemented
+
+    def __ne__(self, other):
+        if isinstance(other, ObjectId):
+            return self.__id != other.binary
+        return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, ObjectId):
+            return self.__id < other.binary
+        return NotImplemented
+
+    def __le__(self, other):
+        if isinstance(other, ObjectId):
+            return self.__id <= other.binary
+        return NotImplemented
+
+    def __gt__(self, other):
+        if isinstance(other, ObjectId):
+            return self.__id > other.binary
+        return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, ObjectId):
+            return self.__id >= other.binary
+        return NotImplemented
+
+    def __hash__(self):
+        """Get a hash value for this :class:`ObjectId`."""
+        return hash(self.__id)
diff --git a/llm/Lib/site-packages/bson/py3compat.py b/llm/Lib/site-packages/bson/py3compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..0a2aa325439aad2ca3cd5db6719ae05fa23375a9
--- /dev/null
+++ b/llm/Lib/site-packages/bson/py3compat.py
@@ -0,0 +1,88 @@
+# Copyright 2009-2015 MongoDB, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you
+# may not use this file except in compliance with the License.  You
+# may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+# implied.  See the License for the specific language governing
+# permissions and limitations under the License.
+
+"""Utility functions and definitions for python3 compatibility."""
+
+import sys
+
+PY3 = sys.version_info[0] == 3
+
+if PY3:
+    import codecs
+    import _thread as thread
+    from io import BytesIO as StringIO
+    MAXSIZE = sys.maxsize
+
+    imap = map
+
+    def b(s):
+        # BSON and socket operations deal in binary data. In
+        # python 3 that means instances of `bytes`. In python
+        # 2.6 and 2.7 you can create an alias for `bytes` using
+        # the b prefix (e.g. b'foo').
+        # See http://python3porting.com/problems.html#nicer-solutions
+        return codecs.latin_1_encode(s)[0]
+
+    def bytes_from_hex(h):
+        return bytes.fromhex(h)
+
+    def iteritems(d):
+        return iter(d.items())
+
+    def itervalues(d):
+        return iter(d.values())
+
+    def reraise(exctype, value, trace=None):
+        raise exctype(str(value)).with_traceback(trace)
+
+    def _unicode(s):
+        return s
+
+    text_type = str
+    string_type = str
+    integer_types = int
+else:
+    import thread
+
+    from itertools import imap
+    try:
+        from cStringIO import StringIO
+    except ImportError:
+        from StringIO import StringIO
+
+    MAXSIZE = sys.maxint
+
+    def b(s):
+        # See comments above. In python 2.x b('foo') is just 'foo'.
+        return s
+
+    def bytes_from_hex(h):
+        return h.decode('hex')
+
+    def iteritems(d):
+        return d.iteritems()
+
+    def itervalues(d):
+        return d.itervalues()
+
+    # "raise x, y, z" raises SyntaxError in Python 3
+    exec("""def reraise(exctype, value, trace=None):
+    raise exctype, str(value), trace
+""")
+
+    _unicode = unicode
+
+    string_type = basestring
+    text_type = unicode
+    integer_types = (int, long)
diff --git a/llm/Lib/site-packages/bson/tz_util.py b/llm/Lib/site-packages/bson/tz_util.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ec918fb2bacb4d82fbe2945b3a4c418b57aaf70
--- /dev/null
+++ b/llm/Lib/site-packages/bson/tz_util.py
@@ -0,0 +1,52 @@
+# Copyright 2010-2015 MongoDB, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Timezone related utilities for BSON."""
+
+from datetime import (timedelta,
+                      tzinfo)
+
+ZERO = timedelta(0)
+
+
+class FixedOffset(tzinfo):
+    """Fixed offset timezone, in minutes east from UTC.
+
+    Implementation based from the Python `standard library documentation
+    <http://docs.python.org/library/datetime.html#tzinfo-objects>`_.
+    Defining __getinitargs__ enables pickling / copying.
+    """
+
+    def __init__(self, offset, name):
+        if isinstance(offset, timedelta):
+            self.__offset = offset
+        else:
+            self.__offset = timedelta(minutes=offset)
+        self.__name = name
+
+    def __getinitargs__(self):
+        return self.__offset, self.__name
+
+    def utcoffset(self, dt):
+        return self.__offset
+
+    def tzname(self, dt):
+        return self.__name
+
+    def dst(self, dt):
+        return ZERO
+
+
+utc = FixedOffset(0, "UTC")
+"""Fixed offset timezone representing UTC."""
diff --git a/llm/Lib/site-packages/cachetools-5.3.3.dist-info/INSTALLER b/llm/Lib/site-packages/cachetools-5.3.3.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/cachetools-5.3.3.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/cachetools-5.3.3.dist-info/LICENSE b/llm/Lib/site-packages/cachetools-5.3.3.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..67da58ecd7a5500dc5baa751043f092b580022af
--- /dev/null
+++ b/llm/Lib/site-packages/cachetools-5.3.3.dist-info/LICENSE
@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014-2024 Thomas Kemmer
+
+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 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.
diff --git a/llm/Lib/site-packages/cachetools-5.3.3.dist-info/METADATA b/llm/Lib/site-packages/cachetools-5.3.3.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..5846ebf16760a343f04e422c37096a813f70dff6
--- /dev/null
+++ b/llm/Lib/site-packages/cachetools-5.3.3.dist-info/METADATA
@@ -0,0 +1,150 @@
+Metadata-Version: 2.1
+Name: cachetools
+Version: 5.3.3
+Summary: Extensible memoizing collections and decorators
+Home-page: https://github.com/tkem/cachetools/
+Author: Thomas Kemmer
+Author-email: tkemmer@computer.org
+License: MIT
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Other Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+License-File: LICENSE
+
+cachetools
+========================================================================
+
+.. image:: https://img.shields.io/pypi/v/cachetools
+   :target: https://pypi.org/project/cachetools/
+   :alt: Latest PyPI version
+
+.. image:: https://img.shields.io/github/actions/workflow/status/tkem/cachetools/ci.yml
+   :target: https://github.com/tkem/cachetools/actions/workflows/ci.yml
+   :alt: CI build status
+
+.. image:: https://img.shields.io/readthedocs/cachetools
+   :target: https://cachetools.readthedocs.io/
+   :alt: Documentation build status
+
+.. image:: https://img.shields.io/codecov/c/github/tkem/cachetools/master.svg
+   :target: https://codecov.io/gh/tkem/cachetools
+   :alt: Test coverage
+
+.. image:: https://img.shields.io/librariesio/sourcerank/pypi/cachetools
+   :target: https://libraries.io/pypi/cachetools
+   :alt: Libraries.io SourceRank
+
+.. image:: https://img.shields.io/github/license/tkem/cachetools
+   :target: https://raw.github.com/tkem/cachetools/master/LICENSE
+   :alt: License
+
+.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
+   :target: https://github.com/psf/black
+   :alt: Code style: black
+
+
+This module provides various memoizing collections and decorators,
+including variants of the Python Standard Library's `@lru_cache`_
+function decorator.
+
+.. code-block:: python
+
+   from cachetools import cached, LRUCache, TTLCache
+
+   # speed up calculating Fibonacci numbers with dynamic programming
+   @cached(cache={})
+   def fib(n):
+       return n if n < 2 else fib(n - 1) + fib(n - 2)
+
+   # cache least recently used Python Enhancement Proposals
+   @cached(cache=LRUCache(maxsize=32))
+   def get_pep(num):
+       url = 'http://www.python.org/dev/peps/pep-%04d/' % num
+       with urllib.request.urlopen(url) as s:
+           return s.read()
+
+   # cache weather data for no longer than ten minutes
+   @cached(cache=TTLCache(maxsize=1024, ttl=600))
+   def get_weather(place):
+       return owm.weather_at_place(place).get_weather()
+
+For the purpose of this module, a *cache* is a mutable_ mapping_ of a
+fixed maximum size.  When the cache is full, i.e. by adding another
+item the cache would exceed its maximum size, the cache must choose
+which item(s) to discard based on a suitable `cache algorithm`_.
+
+This module provides multiple cache classes based on different cache
+algorithms, as well as decorators for easily memoizing function and
+method calls.
+
+
+Installation
+------------------------------------------------------------------------
+
+cachetools is available from PyPI_ and can be installed by running::
+
+  pip install cachetools
+
+Typing stubs for this package are provided by typeshed_ and can be
+installed by running::
+
+  pip install types-cachetools
+
+
+Project Resources
+------------------------------------------------------------------------
+
+- `Documentation`_
+- `Issue tracker`_
+- `Source code`_
+- `Change log`_
+
+
+Related Projects
+------------------------------------------------------------------------
+
+- asyncache_: Helpers to use cachetools with async functions
+- cacheing_: Pure Python Cacheing Library
+- CacheToolsUtils_: Cachetools Utilities
+- kids.cache_: Kids caching library
+- shelved-cache_: Persistent cache for Python cachetools
+
+
+License
+------------------------------------------------------------------------
+
+Copyright (c) 2014-2024 Thomas Kemmer.
+
+Licensed under the `MIT License`_.
+
+
+.. _@lru_cache: https://docs.python.org/3/library/functools.html#functools.lru_cache
+.. _mutable: https://docs.python.org/dev/glossary.html#term-mutable
+.. _mapping: https://docs.python.org/dev/glossary.html#term-mapping
+.. _cache algorithm: https://en.wikipedia.org/wiki/Cache_algorithms
+
+.. _PyPI: https://pypi.org/project/cachetools/
+.. _typeshed: https://github.com/python/typeshed/
+.. _Documentation: https://cachetools.readthedocs.io/
+.. _Issue tracker: https://github.com/tkem/cachetools/issues/
+.. _Source code: https://github.com/tkem/cachetools/
+.. _Change log: https://github.com/tkem/cachetools/blob/master/CHANGELOG.rst
+.. _MIT License: https://raw.github.com/tkem/cachetools/master/LICENSE
+
+.. _asyncache: https://pypi.org/project/asyncache/
+.. _cacheing: https://github.com/breid48/cacheing
+.. _CacheToolsUtils: https://pypi.org/project/CacheToolsUtils/
+.. _kids.cache: https://pypi.org/project/kids.cache/
+.. _shelved-cache: https://pypi.org/project/shelved-cache/
diff --git a/llm/Lib/site-packages/cachetools-5.3.3.dist-info/RECORD b/llm/Lib/site-packages/cachetools-5.3.3.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..bb2f699f94ea9f87fceb1e26274955550ffc398f
--- /dev/null
+++ b/llm/Lib/site-packages/cachetools-5.3.3.dist-info/RECORD
@@ -0,0 +1,12 @@
+cachetools-5.3.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+cachetools-5.3.3.dist-info/LICENSE,sha256=L00v8F8Fxdo4efQCkrdgAzLXddx-0yDUPdQvPNfZLJs,1085
+cachetools-5.3.3.dist-info/METADATA,sha256=8rVPp2Ex0NAh8seyqBKCGnqjIxXQRPG73v0AT8USKjY,5328
+cachetools-5.3.3.dist-info/RECORD,,
+cachetools-5.3.3.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+cachetools-5.3.3.dist-info/top_level.txt,sha256=ai2FH78TGwoBcCgVfoqbzk5IQCtnDukdSs4zKuVPvDs,11
+cachetools/__init__.py,sha256=DXPKkJUBff3WW8ufHS8TU53eOzlZ6wGX-GXNAH0Hvdk,24981
+cachetools/__pycache__/__init__.cpython-311.pyc,,
+cachetools/__pycache__/func.cpython-311.pyc,,
+cachetools/__pycache__/keys.cpython-311.pyc,,
+cachetools/func.py,sha256=KxCw7akhw-WkltvsfgzkL4XFGxd54srqroKzV3ZP2OM,3616
+cachetools/keys.py,sha256=d-cpW252E_uV50ySlw13IevdNQnSc0MfiMViImQktRI,1613
diff --git a/llm/Lib/site-packages/cachetools-5.3.3.dist-info/WHEEL b/llm/Lib/site-packages/cachetools-5.3.3.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..98c0d20b7a64f4f998d7913e1d38a05dba20916c
--- /dev/null
+++ b/llm/Lib/site-packages/cachetools-5.3.3.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.42.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/cachetools-5.3.3.dist-info/top_level.txt b/llm/Lib/site-packages/cachetools-5.3.3.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..50d14084a9bc37250ae243ccae4a536f85f3ca2f
--- /dev/null
+++ b/llm/Lib/site-packages/cachetools-5.3.3.dist-info/top_level.txt
@@ -0,0 +1 @@
+cachetools
diff --git a/llm/Lib/site-packages/cachetools/__init__.py b/llm/Lib/site-packages/cachetools/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..341c1c7ff09f5fe7ced34a4a3ebc24812993713f
--- /dev/null
+++ b/llm/Lib/site-packages/cachetools/__init__.py
@@ -0,0 +1,844 @@
+"""Extensible memoizing collections and decorators."""
+
+__all__ = (
+    "Cache",
+    "FIFOCache",
+    "LFUCache",
+    "LRUCache",
+    "MRUCache",
+    "RRCache",
+    "TLRUCache",
+    "TTLCache",
+    "cached",
+    "cachedmethod",
+)
+
+__version__ = "5.3.3"
+
+import collections
+import collections.abc
+import functools
+import heapq
+import random
+import time
+
+from . import keys
+
+
+class _DefaultSize:
+
+    __slots__ = ()
+
+    def __getitem__(self, _):
+        return 1
+
+    def __setitem__(self, _, value):
+        assert value == 1
+
+    def pop(self, _):
+        return 1
+
+
+class Cache(collections.abc.MutableMapping):
+    """Mutable mapping to serve as a simple cache or cache base class."""
+
+    __marker = object()
+
+    __size = _DefaultSize()
+
+    def __init__(self, maxsize, getsizeof=None):
+        if getsizeof:
+            self.getsizeof = getsizeof
+        if self.getsizeof is not Cache.getsizeof:
+            self.__size = dict()
+        self.__data = dict()
+        self.__currsize = 0
+        self.__maxsize = maxsize
+
+    def __repr__(self):
+        return "%s(%s, maxsize=%r, currsize=%r)" % (
+            self.__class__.__name__,
+            repr(self.__data),
+            self.__maxsize,
+            self.__currsize,
+        )
+
+    def __getitem__(self, key):
+        try:
+            return self.__data[key]
+        except KeyError:
+            return self.__missing__(key)
+
+    def __setitem__(self, key, value):
+        maxsize = self.__maxsize
+        size = self.getsizeof(value)
+        if size > maxsize:
+            raise ValueError("value too large")
+        if key not in self.__data or self.__size[key] < size:
+            while self.__currsize + size > maxsize:
+                self.popitem()
+        if key in self.__data:
+            diffsize = size - self.__size[key]
+        else:
+            diffsize = size
+        self.__data[key] = value
+        self.__size[key] = size
+        self.__currsize += diffsize
+
+    def __delitem__(self, key):
+        size = self.__size.pop(key)
+        del self.__data[key]
+        self.__currsize -= size
+
+    def __contains__(self, key):
+        return key in self.__data
+
+    def __missing__(self, key):
+        raise KeyError(key)
+
+    def __iter__(self):
+        return iter(self.__data)
+
+    def __len__(self):
+        return len(self.__data)
+
+    def get(self, key, default=None):
+        if key in self:
+            return self[key]
+        else:
+            return default
+
+    def pop(self, key, default=__marker):
+        if key in self:
+            value = self[key]
+            del self[key]
+        elif default is self.__marker:
+            raise KeyError(key)
+        else:
+            value = default
+        return value
+
+    def setdefault(self, key, default=None):
+        if key in self:
+            value = self[key]
+        else:
+            self[key] = value = default
+        return value
+
+    @property
+    def maxsize(self):
+        """The maximum size of the cache."""
+        return self.__maxsize
+
+    @property
+    def currsize(self):
+        """The current size of the cache."""
+        return self.__currsize
+
+    @staticmethod
+    def getsizeof(value):
+        """Return the size of a cache element's value."""
+        return 1
+
+
+class FIFOCache(Cache):
+    """First In First Out (FIFO) cache implementation."""
+
+    def __init__(self, maxsize, getsizeof=None):
+        Cache.__init__(self, maxsize, getsizeof)
+        self.__order = collections.OrderedDict()
+
+    def __setitem__(self, key, value, cache_setitem=Cache.__setitem__):
+        cache_setitem(self, key, value)
+        try:
+            self.__order.move_to_end(key)
+        except KeyError:
+            self.__order[key] = None
+
+    def __delitem__(self, key, cache_delitem=Cache.__delitem__):
+        cache_delitem(self, key)
+        del self.__order[key]
+
+    def popitem(self):
+        """Remove and return the `(key, value)` pair first inserted."""
+        try:
+            key = next(iter(self.__order))
+        except StopIteration:
+            raise KeyError("%s is empty" % type(self).__name__) from None
+        else:
+            return (key, self.pop(key))
+
+
+class LFUCache(Cache):
+    """Least Frequently Used (LFU) cache implementation."""
+
+    def __init__(self, maxsize, getsizeof=None):
+        Cache.__init__(self, maxsize, getsizeof)
+        self.__counter = collections.Counter()
+
+    def __getitem__(self, key, cache_getitem=Cache.__getitem__):
+        value = cache_getitem(self, key)
+        if key in self:  # __missing__ may not store item
+            self.__counter[key] -= 1
+        return value
+
+    def __setitem__(self, key, value, cache_setitem=Cache.__setitem__):
+        cache_setitem(self, key, value)
+        self.__counter[key] -= 1
+
+    def __delitem__(self, key, cache_delitem=Cache.__delitem__):
+        cache_delitem(self, key)
+        del self.__counter[key]
+
+    def popitem(self):
+        """Remove and return the `(key, value)` pair least frequently used."""
+        try:
+            ((key, _),) = self.__counter.most_common(1)
+        except ValueError:
+            raise KeyError("%s is empty" % type(self).__name__) from None
+        else:
+            return (key, self.pop(key))
+
+
+class LRUCache(Cache):
+    """Least Recently Used (LRU) cache implementation."""
+
+    def __init__(self, maxsize, getsizeof=None):
+        Cache.__init__(self, maxsize, getsizeof)
+        self.__order = collections.OrderedDict()
+
+    def __getitem__(self, key, cache_getitem=Cache.__getitem__):
+        value = cache_getitem(self, key)
+        if key in self:  # __missing__ may not store item
+            self.__update(key)
+        return value
+
+    def __setitem__(self, key, value, cache_setitem=Cache.__setitem__):
+        cache_setitem(self, key, value)
+        self.__update(key)
+
+    def __delitem__(self, key, cache_delitem=Cache.__delitem__):
+        cache_delitem(self, key)
+        del self.__order[key]
+
+    def popitem(self):
+        """Remove and return the `(key, value)` pair least recently used."""
+        try:
+            key = next(iter(self.__order))
+        except StopIteration:
+            raise KeyError("%s is empty" % type(self).__name__) from None
+        else:
+            return (key, self.pop(key))
+
+    def __update(self, key):
+        try:
+            self.__order.move_to_end(key)
+        except KeyError:
+            self.__order[key] = None
+
+
+class MRUCache(Cache):
+    """Most Recently Used (MRU) cache implementation."""
+
+    def __init__(self, maxsize, getsizeof=None):
+        Cache.__init__(self, maxsize, getsizeof)
+        self.__order = collections.OrderedDict()
+
+    def __getitem__(self, key, cache_getitem=Cache.__getitem__):
+        value = cache_getitem(self, key)
+        if key in self:  # __missing__ may not store item
+            self.__update(key)
+        return value
+
+    def __setitem__(self, key, value, cache_setitem=Cache.__setitem__):
+        cache_setitem(self, key, value)
+        self.__update(key)
+
+    def __delitem__(self, key, cache_delitem=Cache.__delitem__):
+        cache_delitem(self, key)
+        del self.__order[key]
+
+    def popitem(self):
+        """Remove and return the `(key, value)` pair most recently used."""
+        try:
+            key = next(iter(self.__order))
+        except StopIteration:
+            raise KeyError("%s is empty" % type(self).__name__) from None
+        else:
+            return (key, self.pop(key))
+
+    def __update(self, key):
+        try:
+            self.__order.move_to_end(key, last=False)
+        except KeyError:
+            self.__order[key] = None
+
+
+class RRCache(Cache):
+    """Random Replacement (RR) cache implementation."""
+
+    def __init__(self, maxsize, choice=random.choice, getsizeof=None):
+        Cache.__init__(self, maxsize, getsizeof)
+        self.__choice = choice
+
+    @property
+    def choice(self):
+        """The `choice` function used by the cache."""
+        return self.__choice
+
+    def popitem(self):
+        """Remove and return a random `(key, value)` pair."""
+        try:
+            key = self.__choice(list(self))
+        except IndexError:
+            raise KeyError("%s is empty" % type(self).__name__) from None
+        else:
+            return (key, self.pop(key))
+
+
+class _TimedCache(Cache):
+    """Base class for time aware cache implementations."""
+
+    class _Timer:
+        def __init__(self, timer):
+            self.__timer = timer
+            self.__nesting = 0
+
+        def __call__(self):
+            if self.__nesting == 0:
+                return self.__timer()
+            else:
+                return self.__time
+
+        def __enter__(self):
+            if self.__nesting == 0:
+                self.__time = time = self.__timer()
+            else:
+                time = self.__time
+            self.__nesting += 1
+            return time
+
+        def __exit__(self, *exc):
+            self.__nesting -= 1
+
+        def __reduce__(self):
+            return _TimedCache._Timer, (self.__timer,)
+
+        def __getattr__(self, name):
+            return getattr(self.__timer, name)
+
+    def __init__(self, maxsize, timer=time.monotonic, getsizeof=None):
+        Cache.__init__(self, maxsize, getsizeof)
+        self.__timer = _TimedCache._Timer(timer)
+
+    def __repr__(self, cache_repr=Cache.__repr__):
+        with self.__timer as time:
+            self.expire(time)
+            return cache_repr(self)
+
+    def __len__(self, cache_len=Cache.__len__):
+        with self.__timer as time:
+            self.expire(time)
+            return cache_len(self)
+
+    @property
+    def currsize(self):
+        with self.__timer as time:
+            self.expire(time)
+            return super().currsize
+
+    @property
+    def timer(self):
+        """The timer function used by the cache."""
+        return self.__timer
+
+    def clear(self):
+        with self.__timer as time:
+            self.expire(time)
+            Cache.clear(self)
+
+    def get(self, *args, **kwargs):
+        with self.__timer:
+            return Cache.get(self, *args, **kwargs)
+
+    def pop(self, *args, **kwargs):
+        with self.__timer:
+            return Cache.pop(self, *args, **kwargs)
+
+    def setdefault(self, *args, **kwargs):
+        with self.__timer:
+            return Cache.setdefault(self, *args, **kwargs)
+
+
+class TTLCache(_TimedCache):
+    """LRU Cache implementation with per-item time-to-live (TTL) value."""
+
+    class _Link:
+
+        __slots__ = ("key", "expires", "next", "prev")
+
+        def __init__(self, key=None, expires=None):
+            self.key = key
+            self.expires = expires
+
+        def __reduce__(self):
+            return TTLCache._Link, (self.key, self.expires)
+
+        def unlink(self):
+            next = self.next
+            prev = self.prev
+            prev.next = next
+            next.prev = prev
+
+    def __init__(self, maxsize, ttl, timer=time.monotonic, getsizeof=None):
+        _TimedCache.__init__(self, maxsize, timer, getsizeof)
+        self.__root = root = TTLCache._Link()
+        root.prev = root.next = root
+        self.__links = collections.OrderedDict()
+        self.__ttl = ttl
+
+    def __contains__(self, key):
+        try:
+            link = self.__links[key]  # no reordering
+        except KeyError:
+            return False
+        else:
+            return self.timer() < link.expires
+
+    def __getitem__(self, key, cache_getitem=Cache.__getitem__):
+        try:
+            link = self.__getlink(key)
+        except KeyError:
+            expired = False
+        else:
+            expired = not (self.timer() < link.expires)
+        if expired:
+            return self.__missing__(key)
+        else:
+            return cache_getitem(self, key)
+
+    def __setitem__(self, key, value, cache_setitem=Cache.__setitem__):
+        with self.timer as time:
+            self.expire(time)
+            cache_setitem(self, key, value)
+        try:
+            link = self.__getlink(key)
+        except KeyError:
+            self.__links[key] = link = TTLCache._Link(key)
+        else:
+            link.unlink()
+        link.expires = time + self.__ttl
+        link.next = root = self.__root
+        link.prev = prev = root.prev
+        prev.next = root.prev = link
+
+    def __delitem__(self, key, cache_delitem=Cache.__delitem__):
+        cache_delitem(self, key)
+        link = self.__links.pop(key)
+        link.unlink()
+        if not (self.timer() < link.expires):
+            raise KeyError(key)
+
+    def __iter__(self):
+        root = self.__root
+        curr = root.next
+        while curr is not root:
+            # "freeze" time for iterator access
+            with self.timer as time:
+                if time < curr.expires:
+                    yield curr.key
+            curr = curr.next
+
+    def __setstate__(self, state):
+        self.__dict__.update(state)
+        root = self.__root
+        root.prev = root.next = root
+        for link in sorted(self.__links.values(), key=lambda obj: obj.expires):
+            link.next = root
+            link.prev = prev = root.prev
+            prev.next = root.prev = link
+        self.expire(self.timer())
+
+    @property
+    def ttl(self):
+        """The time-to-live value of the cache's items."""
+        return self.__ttl
+
+    def expire(self, time=None):
+        """Remove expired items from the cache."""
+        if time is None:
+            time = self.timer()
+        root = self.__root
+        curr = root.next
+        links = self.__links
+        cache_delitem = Cache.__delitem__
+        while curr is not root and not (time < curr.expires):
+            cache_delitem(self, curr.key)
+            del links[curr.key]
+            next = curr.next
+            curr.unlink()
+            curr = next
+
+    def popitem(self):
+        """Remove and return the `(key, value)` pair least recently used that
+        has not already expired.
+
+        """
+        with self.timer as time:
+            self.expire(time)
+            try:
+                key = next(iter(self.__links))
+            except StopIteration:
+                raise KeyError("%s is empty" % type(self).__name__) from None
+            else:
+                return (key, self.pop(key))
+
+    def __getlink(self, key):
+        value = self.__links[key]
+        self.__links.move_to_end(key)
+        return value
+
+
+class TLRUCache(_TimedCache):
+    """Time aware Least Recently Used (TLRU) cache implementation."""
+
+    @functools.total_ordering
+    class _Item:
+
+        __slots__ = ("key", "expires", "removed")
+
+        def __init__(self, key=None, expires=None):
+            self.key = key
+            self.expires = expires
+            self.removed = False
+
+        def __lt__(self, other):
+            return self.expires < other.expires
+
+    def __init__(self, maxsize, ttu, timer=time.monotonic, getsizeof=None):
+        _TimedCache.__init__(self, maxsize, timer, getsizeof)
+        self.__items = collections.OrderedDict()
+        self.__order = []
+        self.__ttu = ttu
+
+    def __contains__(self, key):
+        try:
+            item = self.__items[key]  # no reordering
+        except KeyError:
+            return False
+        else:
+            return self.timer() < item.expires
+
+    def __getitem__(self, key, cache_getitem=Cache.__getitem__):
+        try:
+            item = self.__getitem(key)
+        except KeyError:
+            expired = False
+        else:
+            expired = not (self.timer() < item.expires)
+        if expired:
+            return self.__missing__(key)
+        else:
+            return cache_getitem(self, key)
+
+    def __setitem__(self, key, value, cache_setitem=Cache.__setitem__):
+        with self.timer as time:
+            expires = self.__ttu(key, value, time)
+            if not (time < expires):
+                return  # skip expired items
+            self.expire(time)
+            cache_setitem(self, key, value)
+        # removing an existing item would break the heap structure, so
+        # only mark it as removed for now
+        try:
+            self.__getitem(key).removed = True
+        except KeyError:
+            pass
+        self.__items[key] = item = TLRUCache._Item(key, expires)
+        heapq.heappush(self.__order, item)
+
+    def __delitem__(self, key, cache_delitem=Cache.__delitem__):
+        with self.timer as time:
+            # no self.expire() for performance reasons, e.g. self.clear() [#67]
+            cache_delitem(self, key)
+        item = self.__items.pop(key)
+        item.removed = True
+        if not (time < item.expires):
+            raise KeyError(key)
+
+    def __iter__(self):
+        for curr in self.__order:
+            # "freeze" time for iterator access
+            with self.timer as time:
+                if time < curr.expires and not curr.removed:
+                    yield curr.key
+
+    @property
+    def ttu(self):
+        """The local time-to-use function used by the cache."""
+        return self.__ttu
+
+    def expire(self, time=None):
+        """Remove expired items from the cache."""
+        if time is None:
+            time = self.timer()
+        items = self.__items
+        order = self.__order
+        # clean up the heap if too many items are marked as removed
+        if len(order) > len(items) * 2:
+            self.__order = order = [item for item in order if not item.removed]
+            heapq.heapify(order)
+        cache_delitem = Cache.__delitem__
+        while order and (order[0].removed or not (time < order[0].expires)):
+            item = heapq.heappop(order)
+            if not item.removed:
+                cache_delitem(self, item.key)
+                del items[item.key]
+
+    def popitem(self):
+        """Remove and return the `(key, value)` pair least recently used that
+        has not already expired.
+
+        """
+        with self.timer as time:
+            self.expire(time)
+            try:
+                key = next(iter(self.__items))
+            except StopIteration:
+                raise KeyError("%s is empty" % self.__class__.__name__) from None
+            else:
+                return (key, self.pop(key))
+
+    def __getitem(self, key):
+        value = self.__items[key]
+        self.__items.move_to_end(key)
+        return value
+
+
+_CacheInfo = collections.namedtuple(
+    "CacheInfo", ["hits", "misses", "maxsize", "currsize"]
+)
+
+
+def cached(cache, key=keys.hashkey, lock=None, info=False):
+    """Decorator to wrap a function with a memoizing callable that saves
+    results in a cache.
+
+    """
+
+    def decorator(func):
+        if info:
+            hits = misses = 0
+
+            if isinstance(cache, Cache):
+
+                def getinfo():
+                    nonlocal hits, misses
+                    return _CacheInfo(hits, misses, cache.maxsize, cache.currsize)
+
+            elif isinstance(cache, collections.abc.Mapping):
+
+                def getinfo():
+                    nonlocal hits, misses
+                    return _CacheInfo(hits, misses, None, len(cache))
+
+            else:
+
+                def getinfo():
+                    nonlocal hits, misses
+                    return _CacheInfo(hits, misses, 0, 0)
+
+            if cache is None:
+
+                def wrapper(*args, **kwargs):
+                    nonlocal misses
+                    misses += 1
+                    return func(*args, **kwargs)
+
+                def cache_clear():
+                    nonlocal hits, misses
+                    hits = misses = 0
+
+                cache_info = getinfo
+
+            elif lock is None:
+
+                def wrapper(*args, **kwargs):
+                    nonlocal hits, misses
+                    k = key(*args, **kwargs)
+                    try:
+                        result = cache[k]
+                        hits += 1
+                        return result
+                    except KeyError:
+                        misses += 1
+                    v = func(*args, **kwargs)
+                    try:
+                        cache[k] = v
+                    except ValueError:
+                        pass  # value too large
+                    return v
+
+                def cache_clear():
+                    nonlocal hits, misses
+                    cache.clear()
+                    hits = misses = 0
+
+                cache_info = getinfo
+
+            else:
+
+                def wrapper(*args, **kwargs):
+                    nonlocal hits, misses
+                    k = key(*args, **kwargs)
+                    try:
+                        with lock:
+                            result = cache[k]
+                            hits += 1
+                            return result
+                    except KeyError:
+                        with lock:
+                            misses += 1
+                    v = func(*args, **kwargs)
+                    # in case of a race, prefer the item already in the cache
+                    try:
+                        with lock:
+                            return cache.setdefault(k, v)
+                    except ValueError:
+                        return v  # value too large
+
+                def cache_clear():
+                    nonlocal hits, misses
+                    with lock:
+                        cache.clear()
+                        hits = misses = 0
+
+                def cache_info():
+                    with lock:
+                        return getinfo()
+
+        else:
+            if cache is None:
+
+                def wrapper(*args, **kwargs):
+                    return func(*args, **kwargs)
+
+                def cache_clear():
+                    pass
+
+            elif lock is None:
+
+                def wrapper(*args, **kwargs):
+                    k = key(*args, **kwargs)
+                    try:
+                        return cache[k]
+                    except KeyError:
+                        pass  # key not found
+                    v = func(*args, **kwargs)
+                    try:
+                        cache[k] = v
+                    except ValueError:
+                        pass  # value too large
+                    return v
+
+                def cache_clear():
+                    cache.clear()
+
+            else:
+
+                def wrapper(*args, **kwargs):
+                    k = key(*args, **kwargs)
+                    try:
+                        with lock:
+                            return cache[k]
+                    except KeyError:
+                        pass  # key not found
+                    v = func(*args, **kwargs)
+                    # in case of a race, prefer the item already in the cache
+                    try:
+                        with lock:
+                            return cache.setdefault(k, v)
+                    except ValueError:
+                        return v  # value too large
+
+                def cache_clear():
+                    with lock:
+                        cache.clear()
+
+            cache_info = None
+
+        wrapper.cache = cache
+        wrapper.cache_key = key
+        wrapper.cache_lock = lock
+        wrapper.cache_clear = cache_clear
+        wrapper.cache_info = cache_info
+
+        return functools.update_wrapper(wrapper, func)
+
+    return decorator
+
+
+def cachedmethod(cache, key=keys.methodkey, lock=None):
+    """Decorator to wrap a class or instance method with a memoizing
+    callable that saves results in a cache.
+
+    """
+
+    def decorator(method):
+        if lock is None:
+
+            def wrapper(self, *args, **kwargs):
+                c = cache(self)
+                if c is None:
+                    return method(self, *args, **kwargs)
+                k = key(self, *args, **kwargs)
+                try:
+                    return c[k]
+                except KeyError:
+                    pass  # key not found
+                v = method(self, *args, **kwargs)
+                try:
+                    c[k] = v
+                except ValueError:
+                    pass  # value too large
+                return v
+
+            def clear(self):
+                c = cache(self)
+                if c is not None:
+                    c.clear()
+
+        else:
+
+            def wrapper(self, *args, **kwargs):
+                c = cache(self)
+                if c is None:
+                    return method(self, *args, **kwargs)
+                k = key(self, *args, **kwargs)
+                try:
+                    with lock(self):
+                        return c[k]
+                except KeyError:
+                    pass  # key not found
+                v = method(self, *args, **kwargs)
+                # in case of a race, prefer the item already in the cache
+                try:
+                    with lock(self):
+                        return c.setdefault(k, v)
+                except ValueError:
+                    return v  # value too large
+
+            def clear(self):
+                c = cache(self)
+                if c is not None:
+                    with lock(self):
+                        c.clear()
+
+        wrapper.cache = cache
+        wrapper.cache_key = key
+        wrapper.cache_lock = lock
+        wrapper.cache_clear = clear
+
+        return functools.update_wrapper(wrapper, method)
+
+    return decorator
diff --git a/llm/Lib/site-packages/cachetools/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cachetools/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b83dfcd662a6389cbc8b10b23c3aaaf6aff53fb
Binary files /dev/null and b/llm/Lib/site-packages/cachetools/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cachetools/__pycache__/func.cpython-311.pyc b/llm/Lib/site-packages/cachetools/__pycache__/func.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5390bb18d1f7f485dc63885d87bdf94d94bd0fb5
Binary files /dev/null and b/llm/Lib/site-packages/cachetools/__pycache__/func.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cachetools/__pycache__/keys.cpython-311.pyc b/llm/Lib/site-packages/cachetools/__pycache__/keys.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2ce0ffa14c3c10cbae34c0f967210fb7d98d34e9
Binary files /dev/null and b/llm/Lib/site-packages/cachetools/__pycache__/keys.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cachetools/func.py b/llm/Lib/site-packages/cachetools/func.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c09a60b4951019966a4c607ca2128ebee35c72a
--- /dev/null
+++ b/llm/Lib/site-packages/cachetools/func.py
@@ -0,0 +1,117 @@
+"""`functools.lru_cache` compatible memoizing function decorators."""
+
+__all__ = ("fifo_cache", "lfu_cache", "lru_cache", "mru_cache", "rr_cache", "ttl_cache")
+
+import math
+import random
+import time
+
+try:
+    from threading import RLock
+except ImportError:  # pragma: no cover
+    from dummy_threading import RLock
+
+from . import FIFOCache, LFUCache, LRUCache, MRUCache, RRCache, TTLCache
+from . import cached
+from . import keys
+
+
+class _UnboundTTLCache(TTLCache):
+    def __init__(self, ttl, timer):
+        TTLCache.__init__(self, math.inf, ttl, timer)
+
+    @property
+    def maxsize(self):
+        return None
+
+
+def _cache(cache, maxsize, typed):
+    def decorator(func):
+        key = keys.typedkey if typed else keys.hashkey
+        wrapper = cached(cache=cache, key=key, lock=RLock(), info=True)(func)
+        wrapper.cache_parameters = lambda: {"maxsize": maxsize, "typed": typed}
+        return wrapper
+
+    return decorator
+
+
+def fifo_cache(maxsize=128, typed=False):
+    """Decorator to wrap a function with a memoizing callable that saves
+    up to `maxsize` results based on a First In First Out (FIFO)
+    algorithm.
+
+    """
+    if maxsize is None:
+        return _cache({}, None, typed)
+    elif callable(maxsize):
+        return _cache(FIFOCache(128), 128, typed)(maxsize)
+    else:
+        return _cache(FIFOCache(maxsize), maxsize, typed)
+
+
+def lfu_cache(maxsize=128, typed=False):
+    """Decorator to wrap a function with a memoizing callable that saves
+    up to `maxsize` results based on a Least Frequently Used (LFU)
+    algorithm.
+
+    """
+    if maxsize is None:
+        return _cache({}, None, typed)
+    elif callable(maxsize):
+        return _cache(LFUCache(128), 128, typed)(maxsize)
+    else:
+        return _cache(LFUCache(maxsize), maxsize, typed)
+
+
+def lru_cache(maxsize=128, typed=False):
+    """Decorator to wrap a function with a memoizing callable that saves
+    up to `maxsize` results based on a Least Recently Used (LRU)
+    algorithm.
+
+    """
+    if maxsize is None:
+        return _cache({}, None, typed)
+    elif callable(maxsize):
+        return _cache(LRUCache(128), 128, typed)(maxsize)
+    else:
+        return _cache(LRUCache(maxsize), maxsize, typed)
+
+
+def mru_cache(maxsize=128, typed=False):
+    """Decorator to wrap a function with a memoizing callable that saves
+    up to `maxsize` results based on a Most Recently Used (MRU)
+    algorithm.
+    """
+    if maxsize is None:
+        return _cache({}, None, typed)
+    elif callable(maxsize):
+        return _cache(MRUCache(128), 128, typed)(maxsize)
+    else:
+        return _cache(MRUCache(maxsize), maxsize, typed)
+
+
+def rr_cache(maxsize=128, choice=random.choice, typed=False):
+    """Decorator to wrap a function with a memoizing callable that saves
+    up to `maxsize` results based on a Random Replacement (RR)
+    algorithm.
+
+    """
+    if maxsize is None:
+        return _cache({}, None, typed)
+    elif callable(maxsize):
+        return _cache(RRCache(128, choice), 128, typed)(maxsize)
+    else:
+        return _cache(RRCache(maxsize, choice), maxsize, typed)
+
+
+def ttl_cache(maxsize=128, ttl=600, timer=time.monotonic, typed=False):
+    """Decorator to wrap a function with a memoizing callable that saves
+    up to `maxsize` results based on a Least Recently Used (LRU)
+    algorithm with a per-item time-to-live (TTL) value.
+    """
+    if maxsize is None:
+        return _cache(_UnboundTTLCache(ttl, timer), None, typed)
+    elif callable(maxsize):
+        return _cache(TTLCache(128, ttl, timer), 128, typed)(maxsize)
+    else:
+        return _cache(TTLCache(maxsize, ttl, timer), maxsize, typed)
diff --git a/llm/Lib/site-packages/cachetools/keys.py b/llm/Lib/site-packages/cachetools/keys.py
new file mode 100644
index 0000000000000000000000000000000000000000..f2feb4182b7029568181f8e39d3061f0a90f4f87
--- /dev/null
+++ b/llm/Lib/site-packages/cachetools/keys.py
@@ -0,0 +1,57 @@
+"""Key functions for memoizing decorators."""
+
+__all__ = ("hashkey", "methodkey", "typedkey")
+
+
+class _HashedTuple(tuple):
+    """A tuple that ensures that hash() will be called no more than once
+    per element, since cache decorators will hash the key multiple
+    times on a cache miss.  See also _HashedSeq in the standard
+    library functools implementation.
+
+    """
+
+    __hashvalue = None
+
+    def __hash__(self, hash=tuple.__hash__):
+        hashvalue = self.__hashvalue
+        if hashvalue is None:
+            self.__hashvalue = hashvalue = hash(self)
+        return hashvalue
+
+    def __add__(self, other, add=tuple.__add__):
+        return _HashedTuple(add(self, other))
+
+    def __radd__(self, other, add=tuple.__add__):
+        return _HashedTuple(add(other, self))
+
+    def __getstate__(self):
+        return {}
+
+
+# used for separating keyword arguments; we do not use an object
+# instance here so identity is preserved when pickling/unpickling
+_kwmark = (_HashedTuple,)
+
+
+def hashkey(*args, **kwargs):
+    """Return a cache key for the specified hashable arguments."""
+
+    if kwargs:
+        return _HashedTuple(args + sum(sorted(kwargs.items()), _kwmark))
+    else:
+        return _HashedTuple(args)
+
+
+def methodkey(self, *args, **kwargs):
+    """Return a cache key for use with cached methods."""
+    return hashkey(*args, **kwargs)
+
+
+def typedkey(*args, **kwargs):
+    """Return a typed cache key for the specified hashable arguments."""
+
+    key = hashkey(*args, **kwargs)
+    key += tuple(type(v) for v in args)
+    key += tuple(type(v) for _, v in sorted(kwargs.items()))
+    return key
diff --git a/llm/Lib/site-packages/cassandra/__init__.py b/llm/Lib/site-packages/cassandra/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..44303c469b572ca8083eb0ebd28d2e45e52566fa
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/__init__.py
@@ -0,0 +1,752 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+
+
+class NullHandler(logging.Handler):
+
+    def emit(self, record):
+        pass
+
+logging.getLogger('cassandra').addHandler(NullHandler())
+
+__version_info__ = (3, 29, 1)
+__version__ = '.'.join(map(str, __version_info__))
+
+
+class ConsistencyLevel(object):
+    """
+    Spcifies how many replicas must respond for an operation to be considered
+    a success.  By default, ``ONE`` is used for all operations.
+    """
+
+    ANY = 0
+    """
+    Only requires that one replica receives the write *or* the coordinator
+    stores a hint to replay later. Valid only for writes.
+    """
+
+    ONE = 1
+    """
+    Only one replica needs to respond to consider the operation a success
+    """
+
+    TWO = 2
+    """
+    Two replicas must respond to consider the operation a success
+    """
+
+    THREE = 3
+    """
+    Three replicas must respond to consider the operation a success
+    """
+
+    QUORUM = 4
+    """
+    ``ceil(RF/2) + 1`` replicas must respond to consider the operation a success
+    """
+
+    ALL = 5
+    """
+    All replicas must respond to consider the operation a success
+    """
+
+    LOCAL_QUORUM = 6
+    """
+    Requires a quorum of replicas in the local datacenter
+    """
+
+    EACH_QUORUM = 7
+    """
+    Requires a quorum of replicas in each datacenter
+    """
+
+    SERIAL = 8
+    """
+    For conditional inserts/updates that utilize Cassandra's lightweight
+    transactions, this requires consensus among all replicas for the
+    modified data.
+    """
+
+    LOCAL_SERIAL = 9
+    """
+    Like :attr:`~ConsistencyLevel.SERIAL`, but only requires consensus
+    among replicas in the local datacenter.
+    """
+
+    LOCAL_ONE = 10
+    """
+    Sends a request only to replicas in the local datacenter and waits for
+    one response.
+    """
+
+    @staticmethod
+    def is_serial(cl):
+        return cl == ConsistencyLevel.SERIAL or cl == ConsistencyLevel.LOCAL_SERIAL
+
+
+ConsistencyLevel.value_to_name = {
+    ConsistencyLevel.ANY: 'ANY',
+    ConsistencyLevel.ONE: 'ONE',
+    ConsistencyLevel.TWO: 'TWO',
+    ConsistencyLevel.THREE: 'THREE',
+    ConsistencyLevel.QUORUM: 'QUORUM',
+    ConsistencyLevel.ALL: 'ALL',
+    ConsistencyLevel.LOCAL_QUORUM: 'LOCAL_QUORUM',
+    ConsistencyLevel.EACH_QUORUM: 'EACH_QUORUM',
+    ConsistencyLevel.SERIAL: 'SERIAL',
+    ConsistencyLevel.LOCAL_SERIAL: 'LOCAL_SERIAL',
+    ConsistencyLevel.LOCAL_ONE: 'LOCAL_ONE'
+}
+
+ConsistencyLevel.name_to_value = {
+    'ANY': ConsistencyLevel.ANY,
+    'ONE': ConsistencyLevel.ONE,
+    'TWO': ConsistencyLevel.TWO,
+    'THREE': ConsistencyLevel.THREE,
+    'QUORUM': ConsistencyLevel.QUORUM,
+    'ALL': ConsistencyLevel.ALL,
+    'LOCAL_QUORUM': ConsistencyLevel.LOCAL_QUORUM,
+    'EACH_QUORUM': ConsistencyLevel.EACH_QUORUM,
+    'SERIAL': ConsistencyLevel.SERIAL,
+    'LOCAL_SERIAL': ConsistencyLevel.LOCAL_SERIAL,
+    'LOCAL_ONE': ConsistencyLevel.LOCAL_ONE
+}
+
+
+def consistency_value_to_name(value):
+    return ConsistencyLevel.value_to_name[value] if value is not None else "Not Set"
+
+
+class ProtocolVersion(object):
+    """
+    Defines native protocol versions supported by this driver.
+    """
+    V1 = 1
+    """
+    v1, supported in Cassandra 1.2-->2.2
+    """
+
+    V2 = 2
+    """
+    v2, supported in Cassandra 2.0-->2.2;
+    added support for lightweight transactions, batch operations, and automatic query paging.
+    """
+
+    V3 = 3
+    """
+    v3, supported in Cassandra 2.1-->3.x+;
+    added support for protocol-level client-side timestamps (see :attr:`.Session.use_client_timestamp`),
+    serial consistency levels for :class:`~.BatchStatement`, and an improved connection pool.
+    """
+
+    V4 = 4
+    """
+    v4, supported in Cassandra 2.2-->3.x+;
+    added a number of new types, server warnings, new failure messages, and custom payloads. Details in the
+    `project docs <https://github.com/apache/cassandra/blob/trunk/doc/native_protocol_v4.spec>`_
+    """
+
+    V5 = 5
+    """
+    v5, in beta from 3.x+. Finalised in 4.0-beta5
+    """
+
+    V6 = 6
+    """
+    v6, in beta from 4.0-beta5
+    """
+
+    DSE_V1 = 0x41
+    """
+    DSE private protocol v1, supported in DSE 5.1+
+    """
+
+    DSE_V2 = 0x42
+    """
+    DSE private protocol v2, supported in DSE 6.0+
+    """
+
+    SUPPORTED_VERSIONS = (DSE_V2, DSE_V1, V6, V5, V4, V3, V2, V1)
+    """
+    A tuple of all supported protocol versions
+    """
+
+    BETA_VERSIONS = (V6,)
+    """
+    A tuple of all beta protocol versions
+    """
+
+    MIN_SUPPORTED = min(SUPPORTED_VERSIONS)
+    """
+    Minimum protocol version supported by this driver.
+    """
+
+    MAX_SUPPORTED = max(SUPPORTED_VERSIONS)
+    """
+    Maximum protocol version supported by this driver.
+    """
+
+    @classmethod
+    def get_lower_supported(cls, previous_version):
+        """
+        Return the lower supported protocol version. Beta versions are omitted.
+        """
+        try:
+            version = next(v for v in sorted(ProtocolVersion.SUPPORTED_VERSIONS, reverse=True) if
+                           v not in ProtocolVersion.BETA_VERSIONS and v < previous_version)
+        except StopIteration:
+            version = 0
+
+        return version
+
+    @classmethod
+    def uses_int_query_flags(cls, version):
+        return version >= cls.V5
+
+    @classmethod
+    def uses_prepare_flags(cls, version):
+        return version >= cls.V5 and version != cls.DSE_V1
+
+    @classmethod
+    def uses_prepared_metadata(cls, version):
+        return version >= cls.V5 and version != cls.DSE_V1
+
+    @classmethod
+    def uses_error_code_map(cls, version):
+        return version >= cls.V5
+
+    @classmethod
+    def uses_keyspace_flag(cls, version):
+        return version >= cls.V5 and version != cls.DSE_V1
+
+    @classmethod
+    def has_continuous_paging_support(cls, version):
+        return version >= cls.DSE_V1
+
+    @classmethod
+    def has_continuous_paging_next_pages(cls, version):
+        return version >= cls.DSE_V2
+
+    @classmethod
+    def has_checksumming_support(cls, version):
+        return cls.V5 <= version < cls.DSE_V1
+
+
+class WriteType(object):
+    """
+    For usage with :class:`.RetryPolicy`, this describe a type
+    of write operation.
+    """
+
+    SIMPLE = 0
+    """
+    A write to a single partition key. Such writes are guaranteed to be atomic
+    and isolated.
+    """
+
+    BATCH = 1
+    """
+    A write to multiple partition keys that used the distributed batch log to
+    ensure atomicity.
+    """
+
+    UNLOGGED_BATCH = 2
+    """
+    A write to multiple partition keys that did not use the distributed batch
+    log. Atomicity for such writes is not guaranteed.
+    """
+
+    COUNTER = 3
+    """
+    A counter write (for one or multiple partition keys). Such writes should
+    not be replayed in order to avoid overcount.
+    """
+
+    BATCH_LOG = 4
+    """
+    The initial write to the distributed batch log that Cassandra performs
+    internally before a BATCH write.
+    """
+
+    CAS = 5
+    """
+    A lighweight-transaction write, such as "DELETE ... IF EXISTS".
+    """
+
+    VIEW = 6
+    """
+    This WriteType is only seen in results for requests that were unable to
+    complete MV operations.
+    """
+
+    CDC = 7
+    """
+    This WriteType is only seen in results for requests that were unable to
+    complete CDC operations.
+    """
+
+
+WriteType.name_to_value = {
+    'SIMPLE': WriteType.SIMPLE,
+    'BATCH': WriteType.BATCH,
+    'UNLOGGED_BATCH': WriteType.UNLOGGED_BATCH,
+    'COUNTER': WriteType.COUNTER,
+    'BATCH_LOG': WriteType.BATCH_LOG,
+    'CAS': WriteType.CAS,
+    'VIEW': WriteType.VIEW,
+    'CDC': WriteType.CDC
+}
+
+
+WriteType.value_to_name = {v: k for k, v in WriteType.name_to_value.items()}
+
+
+class SchemaChangeType(object):
+    DROPPED = 'DROPPED'
+    CREATED = 'CREATED'
+    UPDATED = 'UPDATED'
+
+
+class SchemaTargetType(object):
+    KEYSPACE = 'KEYSPACE'
+    TABLE = 'TABLE'
+    TYPE = 'TYPE'
+    FUNCTION = 'FUNCTION'
+    AGGREGATE = 'AGGREGATE'
+
+
+class SignatureDescriptor(object):
+
+    def __init__(self, name, argument_types):
+        self.name = name
+        self.argument_types = argument_types
+
+    @property
+    def signature(self):
+        """
+        function signature string in the form 'name([type0[,type1[...]]])'
+
+        can be used to uniquely identify overloaded function names within a keyspace
+        """
+        return self.format_signature(self.name, self.argument_types)
+
+    @staticmethod
+    def format_signature(name, argument_types):
+        return "%s(%s)" % (name, ','.join(t for t in argument_types))
+
+    def __repr__(self):
+        return "%s(%s, %s)" % (self.__class__.__name__, self.name, self.argument_types)
+
+
+class UserFunctionDescriptor(SignatureDescriptor):
+    """
+    Describes a User function by name and argument signature
+    """
+
+    name = None
+    """
+    name of the function
+    """
+
+    argument_types = None
+    """
+    Ordered list of CQL argument type names comprising the type signature
+    """
+
+
+class UserAggregateDescriptor(SignatureDescriptor):
+    """
+    Describes a User aggregate function by name and argument signature
+    """
+
+    name = None
+    """
+    name of the aggregate
+    """
+
+    argument_types = None
+    """
+    Ordered list of CQL argument type names comprising the type signature
+    """
+
+
+class DriverException(Exception):
+    """
+    Base for all exceptions explicitly raised by the driver.
+    """
+    pass
+
+
+class RequestExecutionException(DriverException):
+    """
+    Base for request execution exceptions returned from the server.
+    """
+    pass
+
+
+class Unavailable(RequestExecutionException):
+    """
+    There were not enough live replicas to satisfy the requested consistency
+    level, so the coordinator node immediately failed the request without
+    forwarding it to any replicas.
+    """
+
+    consistency = None
+    """ The requested :class:`ConsistencyLevel` """
+
+    required_replicas = None
+    """ The number of replicas that needed to be live to complete the operation """
+
+    alive_replicas = None
+    """ The number of replicas that were actually alive """
+
+    def __init__(self, summary_message, consistency=None, required_replicas=None, alive_replicas=None):
+        self.consistency = consistency
+        self.required_replicas = required_replicas
+        self.alive_replicas = alive_replicas
+        Exception.__init__(self, summary_message + ' info=' +
+                           repr({'consistency': consistency_value_to_name(consistency),
+                                 'required_replicas': required_replicas,
+                                 'alive_replicas': alive_replicas}))
+
+
+class Timeout(RequestExecutionException):
+    """
+    Replicas failed to respond to the coordinator node before timing out.
+    """
+
+    consistency = None
+    """ The requested :class:`ConsistencyLevel` """
+
+    required_responses = None
+    """ The number of required replica responses """
+
+    received_responses = None
+    """
+    The number of replicas that responded before the coordinator timed out
+    the operation
+    """
+
+    def __init__(self, summary_message, consistency=None, required_responses=None,
+                 received_responses=None, **kwargs):
+        self.consistency = consistency
+        self.required_responses = required_responses
+        self.received_responses = received_responses
+
+        if "write_type" in kwargs:
+            kwargs["write_type"] = WriteType.value_to_name[kwargs["write_type"]]
+
+        info = {'consistency': consistency_value_to_name(consistency),
+                'required_responses': required_responses,
+                'received_responses': received_responses}
+        info.update(kwargs)
+
+        Exception.__init__(self, summary_message + ' info=' + repr(info))
+
+
+class ReadTimeout(Timeout):
+    """
+    A subclass of :exc:`Timeout` for read operations.
+
+    This indicates that the replicas failed to respond to the coordinator
+    node before the configured timeout. This timeout is configured in
+    ``cassandra.yaml`` with the ``read_request_timeout_in_ms``
+    and ``range_request_timeout_in_ms`` options.
+    """
+
+    data_retrieved = None
+    """
+    A boolean indicating whether the requested data was retrieved
+    by the coordinator from any replicas before it timed out the
+    operation
+    """
+
+    def __init__(self, message, data_retrieved=None, **kwargs):
+        Timeout.__init__(self, message, **kwargs)
+        self.data_retrieved = data_retrieved
+
+
+class WriteTimeout(Timeout):
+    """
+    A subclass of :exc:`Timeout` for write operations.
+
+    This indicates that the replicas failed to respond to the coordinator
+    node before the configured timeout. This timeout is configured in
+    ``cassandra.yaml`` with the ``write_request_timeout_in_ms``
+    option.
+    """
+
+    write_type = None
+    """
+    The type of write operation, enum on :class:`~cassandra.policies.WriteType`
+    """
+
+    def __init__(self, message, write_type=None, **kwargs):
+        kwargs["write_type"] = write_type
+        Timeout.__init__(self, message, **kwargs)
+        self.write_type = write_type
+
+
+class CDCWriteFailure(RequestExecutionException):
+    """
+    Hit limit on data in CDC folder, writes are rejected
+    """
+    def __init__(self, message):
+        Exception.__init__(self, message)
+
+
+class CoordinationFailure(RequestExecutionException):
+    """
+    Replicas sent a failure to the coordinator.
+    """
+
+    consistency = None
+    """ The requested :class:`ConsistencyLevel` """
+
+    required_responses = None
+    """ The number of required replica responses """
+
+    received_responses = None
+    """
+    The number of replicas that responded before the coordinator timed out
+    the operation
+    """
+
+    failures = None
+    """
+    The number of replicas that sent a failure message
+    """
+
+    error_code_map = None
+    """
+    A map of inet addresses to error codes representing replicas that sent
+    a failure message.  Only set when `protocol_version` is 5 or higher.
+    """
+
+    def __init__(self, summary_message, consistency=None, required_responses=None,
+                 received_responses=None, failures=None, error_code_map=None):
+        self.consistency = consistency
+        self.required_responses = required_responses
+        self.received_responses = received_responses
+        self.failures = failures
+        self.error_code_map = error_code_map
+
+        info_dict = {
+            'consistency': consistency_value_to_name(consistency),
+            'required_responses': required_responses,
+            'received_responses': received_responses,
+            'failures': failures
+        }
+
+        if error_code_map is not None:
+            # make error codes look like "0x002a"
+            formatted_map = dict((addr, '0x%04x' % err_code)
+                                 for (addr, err_code) in error_code_map.items())
+            info_dict['error_code_map'] = formatted_map
+
+        Exception.__init__(self, summary_message + ' info=' + repr(info_dict))
+
+
+class ReadFailure(CoordinationFailure):
+    """
+    A subclass of :exc:`CoordinationFailure` for read operations.
+
+    This indicates that the replicas sent a failure message to the coordinator.
+    """
+
+    data_retrieved = None
+    """
+    A boolean indicating whether the requested data was retrieved
+    by the coordinator from any replicas before it timed out the
+    operation
+    """
+
+    def __init__(self, message, data_retrieved=None, **kwargs):
+        CoordinationFailure.__init__(self, message, **kwargs)
+        self.data_retrieved = data_retrieved
+
+
+class WriteFailure(CoordinationFailure):
+    """
+    A subclass of :exc:`CoordinationFailure` for write operations.
+
+    This indicates that the replicas sent a failure message to the coordinator.
+    """
+
+    write_type = None
+    """
+    The type of write operation, enum on :class:`~cassandra.policies.WriteType`
+    """
+
+    def __init__(self, message, write_type=None, **kwargs):
+        CoordinationFailure.__init__(self, message, **kwargs)
+        self.write_type = write_type
+
+
+class FunctionFailure(RequestExecutionException):
+    """
+    User Defined Function failed during execution
+    """
+
+    keyspace = None
+    """
+    Keyspace of the function
+    """
+
+    function = None
+    """
+    Name of the function
+    """
+
+    arg_types = None
+    """
+    List of argument type names of the function
+    """
+
+    def __init__(self, summary_message, keyspace, function, arg_types):
+        self.keyspace = keyspace
+        self.function = function
+        self.arg_types = arg_types
+        Exception.__init__(self, summary_message)
+
+
+class RequestValidationException(DriverException):
+    """
+    Server request validation failed
+    """
+    pass
+
+
+class ConfigurationException(RequestValidationException):
+    """
+    Server indicated request errro due to current configuration
+    """
+    pass
+
+
+class AlreadyExists(ConfigurationException):
+    """
+    An attempt was made to create a keyspace or table that already exists.
+    """
+
+    keyspace = None
+    """
+    The name of the keyspace that already exists, or, if an attempt was
+    made to create a new table, the keyspace that the table is in.
+    """
+
+    table = None
+    """
+    The name of the table that already exists, or, if an attempt was
+    make to create a keyspace, :const:`None`.
+    """
+
+    def __init__(self, keyspace=None, table=None):
+        if table:
+            message = "Table '%s.%s' already exists" % (keyspace, table)
+        else:
+            message = "Keyspace '%s' already exists" % (keyspace,)
+
+        Exception.__init__(self, message)
+        self.keyspace = keyspace
+        self.table = table
+
+
+class InvalidRequest(RequestValidationException):
+    """
+    A query was made that was invalid for some reason, such as trying to set
+    the keyspace for a connection to a nonexistent keyspace.
+    """
+    pass
+
+
+class Unauthorized(RequestValidationException):
+    """
+    The current user is not authorized to perform the requested operation.
+    """
+    pass
+
+
+class AuthenticationFailed(DriverException):
+    """
+    Failed to authenticate.
+    """
+    pass
+
+
+class OperationTimedOut(DriverException):
+    """
+    The operation took longer than the specified (client-side) timeout
+    to complete.  This is not an error generated by Cassandra, only
+    the driver.
+    """
+
+    errors = None
+    """
+    A dict of errors keyed by the :class:`~.Host` against which they occurred.
+    """
+
+    last_host = None
+    """
+    The last :class:`~.Host` this operation was attempted against.
+    """
+
+    def __init__(self, errors=None, last_host=None):
+        self.errors = errors
+        self.last_host = last_host
+        message = "errors=%s, last_host=%s" % (self.errors, self.last_host)
+        Exception.__init__(self, message)
+
+
+class UnsupportedOperation(DriverException):
+    """
+    An attempt was made to use a feature that is not supported by the
+    selected protocol version.  See :attr:`Cluster.protocol_version`
+    for more details.
+    """
+    pass
+
+
+class UnresolvableContactPoints(DriverException):
+    """
+    The driver was unable to resolve any provided hostnames.
+
+    Note that this is *not* raised when a :class:`.Cluster` is created with no
+    contact points, only when lookup fails for all hosts
+    """
+    pass
+
+class DependencyException(Exception):
+    """
+    Specific exception class for handling issues with driver dependencies
+    """
+
+    excs = []
+    """
+    A sequence of child exceptions
+    """
+
+    def __init__(self, msg, excs=[]):
+        complete_msg = msg
+        if excs:
+            complete_msg += ("\nThe following exceptions were observed: \n - " + '\n - '.join(str(e) for e in excs))
+        Exception.__init__(self, complete_msg)
+
+class VectorDeserializationFailure(DriverException):
+    """
+    The driver was unable to deserialize a given vector
+    """
+    pass
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e025b02eedfb25fda8ae0cca5cd099515e85a339
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/auth.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/auth.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3bee686f30ac2b452ab847ce19f1315516c6ba56
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/auth.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/cluster.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/cluster.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c9736139c8c9daceb98100633a283c1ea6249d19
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/cluster.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/concurrent.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/concurrent.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d1d8f801bc949f5abd7fc2891a3acc09a6637f01
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/concurrent.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/connection.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/connection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a318b1cb62dd578b24b36ff0a1a46fdf420950bc
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/connection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/cqltypes.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/cqltypes.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2c9dc4f0e9d7d3e480add9cf264aa3aec472df33
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/cqltypes.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/cython_deps.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/cython_deps.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e63da9e7e98373afefe256f6c5fcdf194ebcb92
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/cython_deps.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/encoder.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/encoder.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6bd0ca90e15d24377eb58f339f44bb1e8f0884a9
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/encoder.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/marshal.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/marshal.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0cdfbcde8312e561e1d954f5aabcc69d5df798a0
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/marshal.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/metadata.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/metadata.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..df62d5b5942c9761ca5ed2556553282879739d76
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/metadata.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/metrics.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/metrics.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..30879d392b4ab84e1b05a83a1094878efa6d4bb3
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/metrics.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/murmur3.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/murmur3.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..75aa073e3cb393023917b149b3fc7a3187c3024a
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/murmur3.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/policies.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/policies.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3bcca803b54acad9e31610408e6ade29d53995d9
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/policies.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/pool.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/pool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..091f5cef6cba82cd29b939e0f59d6927b5e14a58
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/pool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/protocol.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/protocol.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b4ab771cc3420a97408bf37ab3a4a4cf5a5be0d
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/protocol.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/query.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/query.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3636a9a5947af006014bab502bd359d3fee0a319
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/query.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/segment.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/segment.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..738f963611e8992303a12fa1814b2d33fca742ed
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/segment.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/timestamps.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/timestamps.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..79f38b9daa85e89f8646c0000d8cac5421db3902
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/timestamps.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/type_codes.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/type_codes.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0f98fbef37490a22612df47736a0d600a4dc0090
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/type_codes.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/__pycache__/util.cpython-311.pyc b/llm/Lib/site-packages/cassandra/__pycache__/util.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..30e33c456316c1e4886aa6061d13a2a7e1517fcd
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/__pycache__/util.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/auth.py b/llm/Lib/site-packages/cassandra/auth.py
new file mode 100644
index 0000000000000000000000000000000000000000..a1b210f731ade4e3c8f25b3fbd791bc633c85cf0
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/auth.py
@@ -0,0 +1,307 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import socket
+import logging
+
+try:
+    import kerberos
+    _have_kerberos = True
+except ImportError:
+    _have_kerberos = False
+
+try:
+    from puresasl.client import SASLClient
+    _have_puresasl = True
+except ImportError:
+    _have_puresasl = False
+
+try:
+    from puresasl.client import SASLClient
+except ImportError:
+    SASLClient = None
+
+log = logging.getLogger(__name__)
+
+# Custom payload keys related to DSE Unified Auth
+_proxy_execute_key = 'ProxyExecute'
+
+
+class AuthProvider(object):
+    """
+    An abstract class that defines the interface that will be used for
+    creating :class:`~.Authenticator` instances when opening new
+    connections to Cassandra.
+
+    .. versionadded:: 2.0.0
+    """
+
+    def new_authenticator(self, host):
+        """
+        Implementations of this class should return a new instance
+        of :class:`~.Authenticator` or one of its subclasses.
+        """
+        raise NotImplementedError()
+
+
+class Authenticator(object):
+    """
+    An abstract class that handles SASL authentication with Cassandra servers.
+
+    Each time a new connection is created and the server requires authentication,
+    a new instance of this class will be created by the corresponding
+    :class:`~.AuthProvider` to handler that authentication. The lifecycle of the
+    new :class:`~.Authenticator` will the be:
+
+    1) The :meth:`~.initial_response()` method will be called. The return
+    value will be sent to the server to initiate the handshake.
+
+    2) The server will respond to each client response by either issuing a
+    challenge or indicating that the authentication is complete (successful or not).
+    If a new challenge is issued, :meth:`~.evaluate_challenge()`
+    will be called to produce a response that will be sent to the
+    server. This challenge/response negotiation will continue until the server
+    responds that authentication is successful (or an :exc:`~.AuthenticationFailed`
+    is raised).
+
+    3) When the server indicates that authentication is successful,
+    :meth:`~.on_authentication_success` will be called a token string that
+    that the server may optionally have sent.
+
+    The exact nature of the negotiation between the client and server is specific
+    to the authentication mechanism configured server-side.
+
+    .. versionadded:: 2.0.0
+    """
+
+    server_authenticator_class = None
+    """ Set during the connection AUTHENTICATE phase """
+
+    def initial_response(self):
+        """
+        Returns an message to send to the server to initiate the SASL handshake.
+        :const:`None` may be returned to send an empty message.
+        """
+        return None
+
+    def evaluate_challenge(self, challenge):
+        """
+        Called when the server sends a challenge message.  Generally, this method
+        should return :const:`None` when authentication is complete from a
+        client perspective.  Otherwise, a string should be returned.
+        """
+        raise NotImplementedError()
+
+    def on_authentication_success(self, token):
+        """
+        Called when the server indicates that authentication was successful.
+        Depending on the authentication mechanism, `token` may be :const:`None`
+        or a string.
+        """
+        pass
+
+
+class PlainTextAuthProvider(AuthProvider):
+    """
+    An :class:`~.AuthProvider` that works with Cassandra's PasswordAuthenticator.
+
+    Example usage::
+
+        from cassandra.cluster import Cluster
+        from cassandra.auth import PlainTextAuthProvider
+
+        auth_provider = PlainTextAuthProvider(
+                username='cassandra', password='cassandra')
+        cluster = Cluster(auth_provider=auth_provider)
+
+    .. versionadded:: 2.0.0
+    """
+
+    def __init__(self, username, password):
+        self.username = username
+        self.password = password
+
+    def new_authenticator(self, host):
+        return PlainTextAuthenticator(self.username, self.password)
+
+
+class TransitionalModePlainTextAuthProvider(object):
+    """
+    An :class:`~.AuthProvider` that works with DSE TransitionalModePlainTextAuthenticator.
+
+    Example usage::
+
+        from cassandra.cluster import Cluster
+        from cassandra.auth import TransitionalModePlainTextAuthProvider
+
+        auth_provider = TransitionalModePlainTextAuthProvider()
+        cluster = Cluster(auth_provider=auth_provider)
+
+    .. warning:: TransitionalModePlainTextAuthProvider will be removed in cassandra-driver
+                 4.0. The transitional mode will be handled internally without the need
+                 of any auth provider.
+    """
+
+    def __init__(self):
+        # TODO remove next major
+        log.warning("TransitionalModePlainTextAuthProvider will be removed in cassandra-driver "
+                    "4.0. The transitional mode will be handled internally without the need "
+                    "of any auth provider.")
+
+    def new_authenticator(self, host):
+        return TransitionalModePlainTextAuthenticator()
+
+
+class SaslAuthProvider(AuthProvider):
+    """
+    An :class:`~.AuthProvider` supporting general SASL auth mechanisms
+
+    Suitable for GSSAPI or other SASL mechanisms
+
+    Example usage::
+
+        from cassandra.cluster import Cluster
+        from cassandra.auth import SaslAuthProvider
+
+        sasl_kwargs = {'service': 'something',
+                       'mechanism': 'GSSAPI',
+                       'qops': 'auth'.split(',')}
+        auth_provider = SaslAuthProvider(**sasl_kwargs)
+        cluster = Cluster(auth_provider=auth_provider)
+
+    .. versionadded:: 2.1.4
+    """
+
+    def __init__(self, **sasl_kwargs):
+        if SASLClient is None:
+            raise ImportError('The puresasl library has not been installed')
+        if 'host' in sasl_kwargs:
+            raise ValueError("kwargs should not contain 'host' since it is passed dynamically to new_authenticator")
+        self.sasl_kwargs = sasl_kwargs
+
+    def new_authenticator(self, host):
+        return SaslAuthenticator(host, **self.sasl_kwargs)
+
+
+class SaslAuthenticator(Authenticator):
+    """
+    A pass-through :class:`~.Authenticator` using the third party package
+    'pure-sasl' for authentication
+
+    .. versionadded:: 2.1.4
+    """
+
+    def __init__(self, host, service, mechanism='GSSAPI', **sasl_kwargs):
+        if SASLClient is None:
+            raise ImportError('The puresasl library has not been installed')
+        self.sasl = SASLClient(host, service, mechanism, **sasl_kwargs)
+
+    def initial_response(self):
+        return self.sasl.process()
+
+    def evaluate_challenge(self, challenge):
+        return self.sasl.process(challenge)
+
+# TODO remove me next major
+DSEPlainTextAuthProvider = PlainTextAuthProvider
+
+
+class DSEGSSAPIAuthProvider(AuthProvider):
+    """
+    Auth provider for GSS API authentication. Works with legacy `KerberosAuthenticator`
+    or `DseAuthenticator` if `kerberos` scheme is enabled.
+    """
+    def __init__(self, service='dse', qops=('auth',), resolve_host_name=True, **properties):
+        """
+        :param service: name of the service
+        :param qops: iterable of "Quality of Protection" allowed; see ``puresasl.QOP``
+        :param resolve_host_name: boolean flag indicating whether the authenticator should reverse-lookup an FQDN when
+            creating a new authenticator. Default is ``True``, which will resolve, or return the numeric address if there is no PTR
+            record. Setting ``False`` creates the authenticator with the numeric address known by Cassandra
+        :param properties: additional keyword properties to pass for the ``puresasl.mechanisms.GSSAPIMechanism`` class.
+            Presently, 'principal' (user) is the only one referenced in the ``pure-sasl`` implementation
+        """
+        if not _have_puresasl:
+            raise ImportError('The puresasl library has not been installed')
+        if not _have_kerberos:
+            raise ImportError('The kerberos library has not been installed')
+        self.service = service
+        self.qops = qops
+        self.resolve_host_name = resolve_host_name
+        self.properties = properties
+
+    def new_authenticator(self, host):
+        if self.resolve_host_name:
+            host = socket.getnameinfo((host, 0), 0)[0]
+        return GSSAPIAuthenticator(host, self.service, self.qops, self.properties)
+
+
+class BaseDSEAuthenticator(Authenticator):
+    def get_mechanism(self):
+        raise NotImplementedError("get_mechanism not implemented")
+
+    def get_initial_challenge(self):
+        raise NotImplementedError("get_initial_challenge not implemented")
+
+    def initial_response(self):
+        if self.server_authenticator_class == "com.datastax.bdp.cassandra.auth.DseAuthenticator":
+            return self.get_mechanism()
+        else:
+            return self.evaluate_challenge(self.get_initial_challenge())
+
+
+class PlainTextAuthenticator(BaseDSEAuthenticator):
+
+    def __init__(self, username, password):
+        self.username = username
+        self.password = password
+
+    def get_mechanism(self):
+        return b"PLAIN"
+
+    def get_initial_challenge(self):
+        return b"PLAIN-START"
+
+    def evaluate_challenge(self, challenge):
+        if challenge == b'PLAIN-START':
+            data = "\x00%s\x00%s" % (self.username, self.password)
+            return data.encode()
+        raise Exception('Did not receive a valid challenge response from server')
+
+
+class TransitionalModePlainTextAuthenticator(PlainTextAuthenticator):
+    """
+     Authenticator that accounts for DSE authentication is configured with transitional mode.
+    """
+
+    def __init__(self):
+        super(TransitionalModePlainTextAuthenticator, self).__init__('', '')
+
+
+class GSSAPIAuthenticator(BaseDSEAuthenticator):
+    def __init__(self, host, service, qops, properties):
+        properties = properties or {}
+        self.sasl = SASLClient(host, service, 'GSSAPI', qops=qops, **properties)
+
+    def get_mechanism(self):
+        return b"GSSAPI"
+
+    def get_initial_challenge(self):
+        return b"GSSAPI-START"
+
+    def evaluate_challenge(self, challenge):
+        if challenge == b'GSSAPI-START':
+            return self.sasl.process()
+        else:
+            return self.sasl.process(challenge)
diff --git a/llm/Lib/site-packages/cassandra/buffer.pxd b/llm/Lib/site-packages/cassandra/buffer.pxd
new file mode 100644
index 0000000000000000000000000000000000000000..2515615c475c9f5826e4457eca5501a69cb6b8b4
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/buffer.pxd
@@ -0,0 +1,58 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Simple buffer data structure that provides a view on existing memory
+(e.g. from a bytes object). This memory must stay alive while the
+buffer is in use.
+"""
+
+from cpython.bytes cimport PyBytes_AS_STRING
+    # char* PyBytes_AS_STRING(object string)
+    # Macro form of PyBytes_AsString() but without error
+    # checking. Only string objects are supported; no Unicode objects
+    # should be passed.
+
+
+cdef struct Buffer:
+    char *ptr
+    Py_ssize_t size
+
+
+cdef inline bytes to_bytes(Buffer *buf):
+    return buf.ptr[:buf.size]
+
+cdef inline char *buf_ptr(Buffer *buf):
+    return buf.ptr
+
+cdef inline char *buf_read(Buffer *buf, Py_ssize_t size) except NULL:
+    if size > buf.size:
+        raise IndexError("Requested more than length of buffer")
+    return buf.ptr
+
+cdef inline int slice_buffer(Buffer *buf, Buffer *out,
+                             Py_ssize_t start, Py_ssize_t size) except -1:
+    if size < 0:
+        raise ValueError("Length must be positive")
+
+    if start + size > buf.size:
+        raise IndexError("Buffer slice out of bounds")
+
+    out.ptr = buf.ptr + start
+    out.size = size
+    return 0
+
+cdef inline void from_ptr_and_size(char *ptr, Py_ssize_t size, Buffer *out):
+    out.ptr = ptr
+    out.size = size
diff --git a/llm/Lib/site-packages/cassandra/bytesio.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/bytesio.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..bbc6c98035d2a13eebc8d83c409784ee352155dd
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/bytesio.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/bytesio.pxd b/llm/Lib/site-packages/cassandra/bytesio.pxd
new file mode 100644
index 0000000000000000000000000000000000000000..fb0202c27fbc356dcc48ba89748e3fb75ee61694
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/bytesio.pxd
@@ -0,0 +1,20 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+cdef class BytesIOReader:
+    cdef bytes buf
+    cdef char *buf_ptr
+    cdef Py_ssize_t pos
+    cdef Py_ssize_t size
+    cdef char *read(self, Py_ssize_t n = ?) except NULL
diff --git a/llm/Lib/site-packages/cassandra/bytesio.pyx b/llm/Lib/site-packages/cassandra/bytesio.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..53c49bc39e7d7c10f4b3e295784a6cfee2a410c9
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/bytesio.pyx
@@ -0,0 +1,44 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+cdef class BytesIOReader:
+    """
+    This class provides efficient support for reading bytes from a 'bytes' buffer,
+    by returning char * values directly without allocating intermediate objects.
+    """
+
+    def __init__(self, bytes buf):
+        self.buf = buf
+        self.size = len(buf)
+        self.buf_ptr = self.buf
+
+    cdef char *read(self, Py_ssize_t n = -1) except NULL:
+        """Read at most size bytes from the file
+        (less if the read hits EOF before obtaining size bytes).
+
+        If the size argument is negative or omitted, read all data until EOF
+        is reached. The bytes are returned as a string object. An empty
+        string is returned when EOF is encountered immediately.
+        """
+        cdef Py_ssize_t newpos = self.pos + n
+        if n < 0:
+            newpos = self.size
+        elif newpos > self.size:
+            # Raise an error here, as we do not want the caller to consume past the
+            # end of the buffer
+            raise EOFError("Cannot read past the end of the file")
+
+        cdef char *res = self.buf_ptr + self.pos
+        self.pos = newpos
+        return res
diff --git a/llm/Lib/site-packages/cassandra/cluster.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/cluster.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..fc125646895526916b0c825f3e4e3798f0437ba0
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cluster.cp311-win_amd64.pyd
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:713c6efd98ddb580a4ed56f69153e23f03ced2e94ead53648f71e3ef42311116
+size 1199616
diff --git a/llm/Lib/site-packages/cassandra/cluster.py b/llm/Lib/site-packages/cassandra/cluster.py
new file mode 100644
index 0000000000000000000000000000000000000000..f9a6a87179e9fa6570f39ad55a1fd53f3400f24b
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cluster.py
@@ -0,0 +1,5325 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+This module houses the main classes you will interact with,
+:class:`.Cluster` and :class:`.Session`.
+"""
+from __future__ import absolute_import
+
+import atexit
+from binascii import hexlify
+from collections import defaultdict
+from collections.abc import Mapping
+from concurrent.futures import ThreadPoolExecutor, FIRST_COMPLETED, wait as wait_futures
+from copy import copy
+from functools import partial, reduce, wraps
+from itertools import groupby, count, chain
+import json
+import logging
+from warnings import warn
+from random import random
+import re
+import queue
+import socket
+import sys
+import time
+from threading import Lock, RLock, Thread, Event
+import uuid
+
+import weakref
+from weakref import WeakValueDictionary
+
+from cassandra import (ConsistencyLevel, AuthenticationFailed,
+                       OperationTimedOut, UnsupportedOperation,
+                       SchemaTargetType, DriverException, ProtocolVersion,
+                       UnresolvableContactPoints, DependencyException)
+from cassandra.auth import _proxy_execute_key, PlainTextAuthProvider
+from cassandra.connection import (ConnectionException, ConnectionShutdown,
+                                  ConnectionHeartbeat, ProtocolVersionUnsupported,
+                                  EndPoint, DefaultEndPoint, DefaultEndPointFactory,
+                                  ContinuousPagingState, SniEndPointFactory, ConnectionBusy)
+from cassandra.cqltypes import UserType
+from cassandra.encoder import Encoder
+from cassandra.protocol import (QueryMessage, ResultMessage,
+                                ErrorMessage, ReadTimeoutErrorMessage,
+                                WriteTimeoutErrorMessage,
+                                UnavailableErrorMessage,
+                                OverloadedErrorMessage,
+                                PrepareMessage, ExecuteMessage,
+                                PreparedQueryNotFound,
+                                IsBootstrappingErrorMessage,
+                                TruncateError, ServerError,
+                                BatchMessage, RESULT_KIND_PREPARED,
+                                RESULT_KIND_SET_KEYSPACE, RESULT_KIND_ROWS,
+                                RESULT_KIND_SCHEMA_CHANGE, ProtocolHandler,
+                                RESULT_KIND_VOID, ProtocolException)
+from cassandra.metadata import Metadata, protect_name, murmur3, _NodeInfo
+from cassandra.policies import (TokenAwarePolicy, DCAwareRoundRobinPolicy, SimpleConvictionPolicy,
+                                ExponentialReconnectionPolicy, HostDistance,
+                                RetryPolicy, IdentityTranslator, NoSpeculativeExecutionPlan,
+                                NoSpeculativeExecutionPolicy, DefaultLoadBalancingPolicy,
+                                NeverRetryPolicy)
+from cassandra.pool import (Host, _ReconnectionHandler, _HostReconnectionHandler,
+                            HostConnectionPool, HostConnection,
+                            NoConnectionsAvailable)
+from cassandra.query import (SimpleStatement, PreparedStatement, BoundStatement,
+                             BatchStatement, bind_params, QueryTrace, TraceUnavailable,
+                             named_tuple_factory, dict_factory, tuple_factory, FETCH_SIZE_UNSET,
+                             HostTargetingStatement)
+from cassandra.marshal import int64_pack
+from cassandra.timestamps import MonotonicTimestampGenerator
+from cassandra.util import _resolve_contact_points_to_string_map, Version
+
+from cassandra.datastax.insights.reporter import MonitorReporter
+from cassandra.datastax.insights.util import version_supports_insights
+
+from cassandra.datastax.graph import (graph_object_row_factory, GraphOptions, GraphSON1Serializer,
+                                      GraphProtocol, GraphSON2Serializer, GraphStatement, SimpleGraphStatement,
+                                      graph_graphson2_row_factory, graph_graphson3_row_factory,
+                                      GraphSON3Serializer)
+from cassandra.datastax.graph.query import _request_timeout_key, _GraphSONContextRowFactory
+from cassandra.datastax import cloud as dscloud
+
+try:
+    from cassandra.io.twistedreactor import TwistedConnection
+except ImportError:
+    TwistedConnection = None
+
+try:
+    from cassandra.io.eventletreactor import EventletConnection
+# PYTHON-1364
+#
+# At the moment eventlet initialization is chucking AttributeErrors due to it's dependence on pyOpenSSL
+# and some changes in Python 3.12 which have some knock-on effects there.
+except (ImportError, AttributeError):
+    EventletConnection = None
+
+try:
+    from weakref import WeakSet
+except ImportError:
+    from cassandra.util import WeakSet  # NOQA
+
+def _is_gevent_monkey_patched():
+    if 'gevent.monkey' not in sys.modules:
+        return False
+    import gevent.socket
+    return socket.socket is gevent.socket.socket
+
+def _try_gevent_import():
+    if _is_gevent_monkey_patched():
+        from cassandra.io.geventreactor import GeventConnection
+        return (GeventConnection,None)
+    else:
+        return (None,None)
+
+def _is_eventlet_monkey_patched():
+    if 'eventlet.patcher' not in sys.modules:
+        return False
+    try:
+        import eventlet.patcher
+        return eventlet.patcher.is_monkey_patched('socket')
+    # Another case related to PYTHON-1364
+    except AttributeError:
+        return False
+
+def _try_eventlet_import():
+    if _is_eventlet_monkey_patched():
+        from cassandra.io.eventletreactor import EventletConnection
+        return (EventletConnection,None)
+    else:
+        return (None,None)
+
+def _try_libev_import():
+    try:
+        from cassandra.io.libevreactor import LibevConnection
+        return (LibevConnection,None)
+    except DependencyException as e:
+        return (None, e)
+
+def _try_asyncore_import():
+    try:
+        from cassandra.io.asyncorereactor import AsyncoreConnection
+        return (AsyncoreConnection,None)
+    except DependencyException as e:
+        return (None, e)
+
+def _connection_reduce_fn(val,import_fn):
+    (rv, excs) = val
+    # If we've already found a workable Connection class return immediately
+    if rv:
+        return val
+    (import_result, exc) = import_fn()
+    if exc:
+        excs.append(exc)
+    return (rv or import_result, excs)
+
+log = logging.getLogger(__name__)
+
+conn_fns = (_try_gevent_import, _try_eventlet_import, _try_libev_import, _try_asyncore_import)
+(conn_class, excs) = reduce(_connection_reduce_fn, conn_fns, (None,[]))
+if not conn_class:
+    raise DependencyException("Unable to load a default connection class", excs)
+DefaultConnection = conn_class
+
+# Forces load of utf8 encoding module to avoid deadlock that occurs
+# if code that is being imported tries to import the module in a seperate
+# thread.
+# See http://bugs.python.org/issue10923
+"".encode('utf8')
+
+
+DEFAULT_MIN_REQUESTS = 5
+DEFAULT_MAX_REQUESTS = 100
+
+DEFAULT_MIN_CONNECTIONS_PER_LOCAL_HOST = 2
+DEFAULT_MAX_CONNECTIONS_PER_LOCAL_HOST = 8
+
+DEFAULT_MIN_CONNECTIONS_PER_REMOTE_HOST = 1
+DEFAULT_MAX_CONNECTIONS_PER_REMOTE_HOST = 2
+
+_GRAPH_PAGING_MIN_DSE_VERSION = Version('6.8.0')
+
+_NOT_SET = object()
+
+
+class NoHostAvailable(Exception):
+    """
+    Raised when an operation is attempted but all connections are
+    busy, defunct, closed, or resulted in errors when used.
+    """
+
+    errors = None
+    """
+    A map of the form ``{ip: exception}`` which details the particular
+    Exception that was caught for each host the operation was attempted
+    against.
+    """
+
+    def __init__(self, message, errors):
+        Exception.__init__(self, message, errors)
+        self.errors = errors
+
+
+def _future_completed(future):
+    """ Helper for run_in_executor() """
+    exc = future.exception()
+    if exc:
+        log.debug("Failed to run task on executor", exc_info=exc)
+
+
+def run_in_executor(f):
+    """
+    A decorator to run the given method in the ThreadPoolExecutor.
+    """
+
+    @wraps(f)
+    def new_f(self, *args, **kwargs):
+
+        if self.is_shutdown:
+            return
+        try:
+            future = self.executor.submit(f, self, *args, **kwargs)
+            future.add_done_callback(_future_completed)
+        except Exception:
+            log.exception("Failed to submit task to executor")
+
+    return new_f
+
+
+_clusters_for_shutdown = set()
+
+
+def _register_cluster_shutdown(cluster):
+    _clusters_for_shutdown.add(cluster)
+
+
+def _discard_cluster_shutdown(cluster):
+    _clusters_for_shutdown.discard(cluster)
+
+
+def _shutdown_clusters():
+    clusters = _clusters_for_shutdown.copy()  # copy because shutdown modifies the global set "discard"
+    for cluster in clusters:
+        cluster.shutdown()
+
+
+atexit.register(_shutdown_clusters)
+
+
+def default_lbp_factory():
+    if murmur3 is not None:
+        return TokenAwarePolicy(DCAwareRoundRobinPolicy())
+    return DCAwareRoundRobinPolicy()
+
+
+class ContinuousPagingOptions(object):
+
+    class PagingUnit(object):
+        BYTES = 1
+        ROWS = 2
+
+    page_unit = None
+    """
+    Value of PagingUnit. Default is PagingUnit.ROWS.
+
+    Units refer to the :attr:`~.Statement.fetch_size` or :attr:`~.Session.default_fetch_size`.
+    """
+
+    max_pages = None
+    """
+    Max number of pages to send
+    """
+
+    max_pages_per_second = None
+    """
+    Max rate at which to send pages
+    """
+
+    max_queue_size = None
+    """
+    The maximum queue size for caching pages, only honored for protocol version DSE_V2 and higher,
+    by default it is 4 and it must be at least 2.
+    """
+
+    def __init__(self, page_unit=PagingUnit.ROWS, max_pages=0, max_pages_per_second=0, max_queue_size=4):
+        self.page_unit = page_unit
+        self.max_pages = max_pages
+        self.max_pages_per_second = max_pages_per_second
+        if max_queue_size < 2:
+            raise ValueError('ContinuousPagingOptions.max_queue_size must be 2 or greater')
+        self.max_queue_size = max_queue_size
+
+    def page_unit_bytes(self):
+        return self.page_unit == ContinuousPagingOptions.PagingUnit.BYTES
+
+
+def _addrinfo_or_none(contact_point, port):
+    """
+    A helper function that wraps socket.getaddrinfo and returns None
+    when it fails to, e.g. resolve one of the hostnames. Used to address
+    PYTHON-895.
+    """
+    try:
+        return socket.getaddrinfo(contact_point, port,
+                                  socket.AF_UNSPEC, socket.SOCK_STREAM)
+    except socket.gaierror:
+        log.debug('Could not resolve hostname "{}" '
+                  'with port {}'.format(contact_point, port))
+        return None
+
+
+def _execution_profile_to_string(name):
+    default_profiles = {
+        EXEC_PROFILE_DEFAULT: 'EXEC_PROFILE_DEFAULT',
+        EXEC_PROFILE_GRAPH_DEFAULT: 'EXEC_PROFILE_GRAPH_DEFAULT',
+        EXEC_PROFILE_GRAPH_SYSTEM_DEFAULT: 'EXEC_PROFILE_GRAPH_SYSTEM_DEFAULT',
+        EXEC_PROFILE_GRAPH_ANALYTICS_DEFAULT: 'EXEC_PROFILE_GRAPH_ANALYTICS_DEFAULT',
+    }
+
+    if name in default_profiles:
+        return default_profiles[name]
+
+    return '"%s"' % (name,)
+
+
+class ExecutionProfile(object):
+    load_balancing_policy = None
+    """
+    An instance of :class:`.policies.LoadBalancingPolicy` or one of its subclasses.
+
+    Used in determining host distance for establishing connections, and routing requests.
+
+    Defaults to ``TokenAwarePolicy(DCAwareRoundRobinPolicy())`` if not specified
+    """
+
+    retry_policy = None
+    """
+    An instance of :class:`.policies.RetryPolicy` instance used when :class:`.Statement` objects do not have a
+    :attr:`~.Statement.retry_policy` explicitly set.
+
+    Defaults to :class:`.RetryPolicy` if not specified
+    """
+
+    consistency_level = ConsistencyLevel.LOCAL_ONE
+    """
+    :class:`.ConsistencyLevel` used when not specified on a :class:`.Statement`.
+    """
+
+    serial_consistency_level = None
+    """
+    Serial :class:`.ConsistencyLevel` used when not specified on a :class:`.Statement` (for LWT conditional statements).
+    """
+
+    request_timeout = 10.0
+    """
+    Request timeout used when not overridden in :meth:`.Session.execute`
+    """
+
+    row_factory = staticmethod(named_tuple_factory)
+    """
+    A callable to format results, accepting ``(colnames, rows)`` where ``colnames`` is a list of column names, and
+    ``rows`` is a list of tuples, with each tuple representing a row of parsed values.
+
+    Some example implementations:
+
+    - :func:`cassandra.query.tuple_factory` - return a result row as a tuple
+    - :func:`cassandra.query.named_tuple_factory` - return a result row as a named tuple
+    - :func:`cassandra.query.dict_factory` - return a result row as a dict
+    - :func:`cassandra.query.ordered_dict_factory` - return a result row as an OrderedDict
+    """
+
+    speculative_execution_policy = None
+    """
+    An instance of :class:`.policies.SpeculativeExecutionPolicy`
+
+    Defaults to :class:`.NoSpeculativeExecutionPolicy` if not specified
+    """
+
+    continuous_paging_options = None
+    """
+    *Note:* This feature is implemented to facilitate server integration testing. It is not intended for general use in the Python driver.
+    See :attr:`.Statement.fetch_size` or :attr:`Session.default_fetch_size` for configuring normal paging.
+
+    When set, requests will use DSE's continuous paging, which streams multiple pages without
+    intermediate requests.
+
+    This has the potential to materialize all results in memory at once if the consumer cannot keep up. Use options
+    to constrain page size and rate.
+
+    This is only available for DSE clusters.
+    """
+
+    # indicates if lbp was set explicitly or uses default values
+    _load_balancing_policy_explicit = False
+    _consistency_level_explicit = False
+
+    def __init__(self, load_balancing_policy=_NOT_SET, retry_policy=None,
+                 consistency_level=_NOT_SET, serial_consistency_level=None,
+                 request_timeout=10.0, row_factory=named_tuple_factory, speculative_execution_policy=None,
+                 continuous_paging_options=None):
+
+        if load_balancing_policy is _NOT_SET:
+            self._load_balancing_policy_explicit = False
+            self.load_balancing_policy = default_lbp_factory()
+        else:
+            self._load_balancing_policy_explicit = True
+            self.load_balancing_policy = load_balancing_policy
+
+        if consistency_level is _NOT_SET:
+            self._consistency_level_explicit = False
+            self.consistency_level = ConsistencyLevel.LOCAL_ONE
+        else:
+            self._consistency_level_explicit = True
+            self.consistency_level = consistency_level
+
+        self.retry_policy = retry_policy or RetryPolicy()
+
+        if (serial_consistency_level is not None and
+                not ConsistencyLevel.is_serial(serial_consistency_level)):
+            raise ValueError("serial_consistency_level must be either "
+                             "ConsistencyLevel.SERIAL "
+                             "or ConsistencyLevel.LOCAL_SERIAL.")
+        self.serial_consistency_level = serial_consistency_level
+
+        self.request_timeout = request_timeout
+        self.row_factory = row_factory
+        self.speculative_execution_policy = speculative_execution_policy or NoSpeculativeExecutionPolicy()
+        self.continuous_paging_options = continuous_paging_options
+
+
+class GraphExecutionProfile(ExecutionProfile):
+    graph_options = None
+    """
+    :class:`.GraphOptions` to use with this execution
+
+    Default options for graph queries, initialized as follows by default::
+
+        GraphOptions(graph_language=b'gremlin-groovy')
+
+    See cassandra.graph.GraphOptions
+    """
+
+    def __init__(self, load_balancing_policy=_NOT_SET, retry_policy=None,
+                 consistency_level=_NOT_SET, serial_consistency_level=None,
+                 request_timeout=30.0, row_factory=None,
+                 graph_options=None, continuous_paging_options=_NOT_SET):
+        """
+        Default execution profile for graph execution.
+
+        See :class:`.ExecutionProfile` for base attributes. Note that if not explicitly set,
+        the row_factory and graph_options.graph_protocol are resolved during the query execution.
+        These options will resolve to graph_graphson3_row_factory and GraphProtocol.GRAPHSON_3_0
+        for the core graph engine (DSE 6.8+), otherwise graph_object_row_factory and GraphProtocol.GRAPHSON_1_0
+
+        In addition to default parameters shown in the signature, this profile also defaults ``retry_policy`` to
+        :class:`cassandra.policies.NeverRetryPolicy`.
+        """
+        retry_policy = retry_policy or NeverRetryPolicy()
+        super(GraphExecutionProfile, self).__init__(load_balancing_policy, retry_policy, consistency_level,
+                                                    serial_consistency_level, request_timeout, row_factory,
+                                                    continuous_paging_options=continuous_paging_options)
+        self.graph_options = graph_options or GraphOptions(graph_source=b'g',
+                                                           graph_language=b'gremlin-groovy')
+
+
+class GraphAnalyticsExecutionProfile(GraphExecutionProfile):
+
+    def __init__(self, load_balancing_policy=None, retry_policy=None,
+                 consistency_level=_NOT_SET, serial_consistency_level=None,
+                 request_timeout=3600. * 24. * 7., row_factory=None,
+                 graph_options=None):
+        """
+        Execution profile with timeout and load balancing appropriate for graph analytics queries.
+
+        See also :class:`~.GraphExecutionPolicy`.
+
+        In addition to default parameters shown in the signature, this profile also defaults ``retry_policy`` to
+        :class:`cassandra.policies.NeverRetryPolicy`, and ``load_balancing_policy`` to one that targets the current Spark
+        master.
+
+        Note: The graph_options.graph_source is set automatically to b'a' (analytics)
+        when using GraphAnalyticsExecutionProfile. This is mandatory to target analytics nodes.
+        """
+        load_balancing_policy = load_balancing_policy or DefaultLoadBalancingPolicy(default_lbp_factory())
+        graph_options = graph_options or GraphOptions(graph_language=b'gremlin-groovy')
+        super(GraphAnalyticsExecutionProfile, self).__init__(load_balancing_policy, retry_policy, consistency_level,
+                                                             serial_consistency_level, request_timeout, row_factory,
+                                                             graph_options)
+        # ensure the graph_source is analytics, since this is the purpose of the GraphAnalyticsExecutionProfile
+        self.graph_options.set_source_analytics()
+
+
+class ProfileManager(object):
+
+    def __init__(self):
+        self.profiles = dict()
+
+    def _profiles_without_explicit_lbps(self):
+        names = (profile_name for
+                 profile_name, profile in self.profiles.items()
+                 if not profile._load_balancing_policy_explicit)
+        return tuple(
+            'EXEC_PROFILE_DEFAULT' if n is EXEC_PROFILE_DEFAULT else n
+            for n in names
+        )
+
+    def distance(self, host):
+        distances = set(p.load_balancing_policy.distance(host) for p in self.profiles.values())
+        return HostDistance.LOCAL if HostDistance.LOCAL in distances else \
+            HostDistance.REMOTE if HostDistance.REMOTE in distances else \
+            HostDistance.IGNORED
+
+    def populate(self, cluster, hosts):
+        for p in self.profiles.values():
+            p.load_balancing_policy.populate(cluster, hosts)
+
+    def check_supported(self):
+        for p in self.profiles.values():
+            p.load_balancing_policy.check_supported()
+
+    def on_up(self, host):
+        for p in self.profiles.values():
+            p.load_balancing_policy.on_up(host)
+
+    def on_down(self, host):
+        for p in self.profiles.values():
+            p.load_balancing_policy.on_down(host)
+
+    def on_add(self, host):
+        for p in self.profiles.values():
+            p.load_balancing_policy.on_add(host)
+
+    def on_remove(self, host):
+        for p in self.profiles.values():
+            p.load_balancing_policy.on_remove(host)
+
+    @property
+    def default(self):
+        """
+        internal-only; no checks are done because this entry is populated on cluster init
+        """
+        return self.profiles[EXEC_PROFILE_DEFAULT]
+
+
+EXEC_PROFILE_DEFAULT = object()
+"""
+Key for the ``Cluster`` default execution profile, used when no other profile is selected in
+``Session.execute(execution_profile)``.
+
+Use this as the key in ``Cluster(execution_profiles)`` to override the default profile.
+"""
+
+EXEC_PROFILE_GRAPH_DEFAULT = object()
+"""
+Key for the default graph execution profile, used when no other profile is selected in
+``Session.execute_graph(execution_profile)``.
+
+Use this as the key in :doc:`Cluster(execution_profiles) </execution_profiles>`
+to override the default graph profile.
+"""
+
+EXEC_PROFILE_GRAPH_SYSTEM_DEFAULT = object()
+"""
+Key for the default graph system execution profile. This can be used for graph statements using the DSE graph
+system API.
+
+Selected using ``Session.execute_graph(execution_profile=EXEC_PROFILE_GRAPH_SYSTEM_DEFAULT)``.
+"""
+
+EXEC_PROFILE_GRAPH_ANALYTICS_DEFAULT = object()
+"""
+Key for the default graph analytics execution profile. This can be used for graph statements intended to
+use Spark/analytics as the traversal source.
+
+Selected using ``Session.execute_graph(execution_profile=EXEC_PROFILE_GRAPH_ANALYTICS_DEFAULT)``.
+"""
+
+
+class _ConfigMode(object):
+    UNCOMMITTED = 0
+    LEGACY = 1
+    PROFILES = 2
+
+
+class Cluster(object):
+    """
+    The main class to use when interacting with a Cassandra cluster.
+    Typically, one instance of this class will be created for each
+    separate Cassandra cluster that your application interacts with.
+
+    Example usage::
+
+        >>> from cassandra.cluster import Cluster
+        >>> cluster = Cluster(['192.168.1.1', '192.168.1.2'])
+        >>> session = cluster.connect()
+        >>> session.execute("CREATE KEYSPACE ...")
+        >>> ...
+        >>> cluster.shutdown()
+
+    ``Cluster`` and ``Session`` also provide context management functions
+    which implicitly handle shutdown when leaving scope.
+    """
+
+    contact_points = ['127.0.0.1']
+    """
+    The list of contact points to try connecting for cluster discovery. A
+    contact point can be a string (ip or hostname), a tuple (ip/hostname, port) or a
+    :class:`.connection.EndPoint` instance.
+
+    Defaults to loopback interface.
+
+    Note: When using :class:`.DCAwareLoadBalancingPolicy` with no explicit
+    local_dc set (as is the default), the DC is chosen from an arbitrary
+    host in contact_points. In this case, contact_points should contain
+    only nodes from a single, local DC.
+
+    Note: In the next major version, if you specify contact points, you will
+    also be required to also explicitly specify a load-balancing policy. This
+    change will help prevent cases where users had hard-to-debug issues
+    surrounding unintuitive default load-balancing policy behavior.
+    """
+    # tracks if contact_points was set explicitly or with default values
+    _contact_points_explicit = None
+
+    port = 9042
+    """
+    The server-side port to open connections to. Defaults to 9042.
+    """
+
+    cql_version = None
+    """
+    If a specific version of CQL should be used, this may be set to that
+    string version.  Otherwise, the highest CQL version supported by the
+    server will be automatically used.
+    """
+
+    protocol_version = ProtocolVersion.DSE_V2
+    """
+    The maximum version of the native protocol to use.
+
+    See :class:`.ProtocolVersion` for more information about versions.
+
+    If not set in the constructor, the driver will automatically downgrade
+    version based on a negotiation with the server, but it is most efficient
+    to set this to the maximum supported by your version of Cassandra.
+    Setting this will also prevent conflicting versions negotiated if your
+    cluster is upgraded.
+
+    """
+
+    allow_beta_protocol_version = False
+
+    no_compact = False
+
+    """
+    Setting true injects a flag in all messages that makes the server accept and use "beta" protocol version.
+    Used for testing new protocol features incrementally before the new version is complete.
+    """
+
+    compression = True
+    """
+    Controls compression for communications between the driver and Cassandra.
+    If left as the default of :const:`True`, either lz4 or snappy compression
+    may be used, depending on what is supported by both the driver
+    and Cassandra.  If both are fully supported, lz4 will be preferred.
+
+    You may also set this to 'snappy' or 'lz4' to request that specific
+    compression type.
+
+    Setting this to :const:`False` disables compression.
+    """
+
+    _auth_provider = None
+    _auth_provider_callable = None
+
+    @property
+    def auth_provider(self):
+        """
+        When :attr:`~.Cluster.protocol_version` is 2 or higher, this should
+        be an instance of a subclass of :class:`~cassandra.auth.AuthProvider`,
+        such as :class:`~.PlainTextAuthProvider`.
+
+        When :attr:`~.Cluster.protocol_version` is 1, this should be
+        a function that accepts one argument, the IP address of a node,
+        and returns a dict of credentials for that node.
+
+        When not using authentication, this should be left as :const:`None`.
+        """
+        return self._auth_provider
+
+    @auth_provider.setter  # noqa
+    def auth_provider(self, value):
+        if not value:
+            self._auth_provider = value
+            return
+
+        try:
+            self._auth_provider_callable = value.new_authenticator
+        except AttributeError:
+            if self.protocol_version > 1:
+                raise TypeError("auth_provider must implement the cassandra.auth.AuthProvider "
+                                "interface when protocol_version >= 2")
+            elif not callable(value):
+                raise TypeError("auth_provider must be callable when protocol_version == 1")
+            self._auth_provider_callable = value
+
+        self._auth_provider = value
+
+    _load_balancing_policy = None
+    @property
+    def load_balancing_policy(self):
+        """
+        An instance of :class:`.policies.LoadBalancingPolicy` or
+        one of its subclasses.
+
+        .. versionchanged:: 2.6.0
+
+        Defaults to :class:`~.TokenAwarePolicy` (:class:`~.DCAwareRoundRobinPolicy`).
+        when using CPython (where the murmur3 extension is available). :class:`~.DCAwareRoundRobinPolicy`
+        otherwise. Default local DC will be chosen from contact points.
+
+        **Please see** :class:`~.DCAwareRoundRobinPolicy` **for a discussion on default behavior with respect to
+        DC locality and remote nodes.**
+        """
+        return self._load_balancing_policy
+
+    @load_balancing_policy.setter
+    def load_balancing_policy(self, lbp):
+        if self._config_mode == _ConfigMode.PROFILES:
+            raise ValueError("Cannot set Cluster.load_balancing_policy while using Configuration Profiles. Set this in a profile instead.")
+        self._load_balancing_policy = lbp
+        self._config_mode = _ConfigMode.LEGACY
+
+    @property
+    def _default_load_balancing_policy(self):
+        return self.profile_manager.default.load_balancing_policy
+
+    reconnection_policy = ExponentialReconnectionPolicy(1.0, 600.0)
+    """
+    An instance of :class:`.policies.ReconnectionPolicy`. Defaults to an instance
+    of :class:`.ExponentialReconnectionPolicy` with a base delay of one second and
+    a max delay of ten minutes.
+    """
+
+    _default_retry_policy = RetryPolicy()
+    @property
+    def default_retry_policy(self):
+        """
+        A default :class:`.policies.RetryPolicy` instance to use for all
+        :class:`.Statement` objects which do not have a :attr:`~.Statement.retry_policy`
+        explicitly set.
+        """
+        return self._default_retry_policy
+
+    @default_retry_policy.setter
+    def default_retry_policy(self, policy):
+        if self._config_mode == _ConfigMode.PROFILES:
+            raise ValueError("Cannot set Cluster.default_retry_policy while using Configuration Profiles. Set this in a profile instead.")
+        self._default_retry_policy = policy
+        self._config_mode = _ConfigMode.LEGACY
+
+    conviction_policy_factory = SimpleConvictionPolicy
+    """
+    A factory function which creates instances of
+    :class:`.policies.ConvictionPolicy`.  Defaults to
+    :class:`.policies.SimpleConvictionPolicy`.
+    """
+
+    address_translator = IdentityTranslator()
+    """
+    :class:`.policies.AddressTranslator` instance to be used in translating server node addresses
+    to driver connection addresses.
+    """
+
+    connect_to_remote_hosts = True
+    """
+    If left as :const:`True`, hosts that are considered :attr:`~.HostDistance.REMOTE`
+    by the :attr:`~.Cluster.load_balancing_policy` will have a connection
+    opened to them.  Otherwise, they will not have a connection opened to them.
+
+    Note that the default load balancing policy ignores remote hosts by default.
+
+    .. versionadded:: 2.1.0
+    """
+
+    metrics_enabled = False
+    """
+    Whether or not metric collection is enabled.  If enabled, :attr:`.metrics`
+    will be an instance of :class:`~cassandra.metrics.Metrics`.
+    """
+
+    metrics = None
+    """
+    An instance of :class:`cassandra.metrics.Metrics` if :attr:`.metrics_enabled` is
+    :const:`True`, else :const:`None`.
+    """
+
+    ssl_options = None
+    """
+    Using ssl_options without ssl_context is deprecated and will be removed in the
+    next major release.
+
+    An optional dict which will be used as kwargs for ``ssl.SSLContext.wrap_socket`` 
+    when new sockets are created. This should be used when client encryption is enabled 
+    in Cassandra.
+
+    The following documentation only applies when ssl_options is used without ssl_context.
+
+    By default, a ``ca_certs`` value should be supplied (the value should be
+    a string pointing to the location of the CA certs file), and you probably
+    want to specify ``ssl_version`` as ``ssl.PROTOCOL_TLS`` to match
+    Cassandra's default protocol.
+
+    .. versionchanged:: 3.3.0
+
+    In addition to ``wrap_socket`` kwargs, clients may also specify ``'check_hostname': True`` to verify the cert hostname
+    as outlined in RFC 2818 and RFC 6125. Note that this requires the certificate to be transferred, so
+    should almost always require the option ``'cert_reqs': ssl.CERT_REQUIRED``. Note also that this functionality was not built into
+    Python standard library until (2.7.9, 3.2). To enable this mechanism in earlier versions, patch ``ssl.match_hostname``
+    with a custom or `back-ported function <https://pypi.org/project/backports.ssl_match_hostname/>`_.
+
+    .. versionchanged:: 3.29.0
+
+    ``ssl.match_hostname`` has been deprecated since Python 3.7 (and removed in Python 3.12).  This functionality is now implemented
+    via ``ssl.SSLContext.check_hostname``.  All options specified above (including ``check_hostname``) should continue to behave in a
+    way that is consistent with prior implementations.
+    """
+
+    ssl_context = None
+    """
+    An optional ``ssl.SSLContext`` instance which will be used when new sockets are created.
+    This should be used when client encryption is enabled in Cassandra.
+
+    ``wrap_socket`` options can be set using :attr:`~Cluster.ssl_options`. ssl_options will
+    be used as kwargs for ``ssl.SSLContext.wrap_socket``.
+
+    .. versionadded:: 3.17.0
+    """
+
+    sockopts = None
+    """
+    An optional list of tuples which will be used as arguments to
+    ``socket.setsockopt()`` for all created sockets.
+
+    Note: some drivers find setting TCPNODELAY beneficial in the context of
+    their execution model. It was not found generally beneficial for this driver.
+    To try with your own workload, set ``sockopts = [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]``
+    """
+
+    max_schema_agreement_wait = 10
+    """
+    The maximum duration (in seconds) that the driver will wait for schema
+    agreement across the cluster. Defaults to ten seconds.
+    If set <= 0, the driver will bypass schema agreement waits altogether.
+    """
+
+    metadata = None
+    """
+    An instance of :class:`cassandra.metadata.Metadata`.
+    """
+
+    connection_class = DefaultConnection
+    """
+    This determines what event loop system will be used for managing
+    I/O with Cassandra.  These are the current options:
+
+    * :class:`cassandra.io.asyncorereactor.AsyncoreConnection`
+    * :class:`cassandra.io.libevreactor.LibevConnection`
+    * :class:`cassandra.io.eventletreactor.EventletConnection` (requires monkey-patching - see doc for details)
+    * :class:`cassandra.io.geventreactor.GeventConnection` (requires monkey-patching - see doc for details)
+    * :class:`cassandra.io.twistedreactor.TwistedConnection`
+    * EXPERIMENTAL: :class:`cassandra.io.asyncioreactor.AsyncioConnection`
+
+    By default, ``AsyncoreConnection`` will be used, which uses
+    the ``asyncore`` module in the Python standard library.
+
+    If ``libev`` is installed, ``LibevConnection`` will be used instead.
+
+    If ``gevent`` or ``eventlet`` monkey-patching is detected, the corresponding
+    connection class will be used automatically.
+
+    ``AsyncioConnection``, which uses the ``asyncio`` module in the Python
+    standard library, is also available, but currently experimental. Note that
+    it requires ``asyncio`` features that were only introduced in the 3.4 line
+    in 3.4.6, and in the 3.5 line in 3.5.1.
+    """
+
+    control_connection_timeout = 2.0
+    """
+    A timeout, in seconds, for queries made by the control connection, such
+    as querying the current schema and information about nodes in the cluster.
+    If set to :const:`None`, there will be no timeout for these queries.
+    """
+
+    idle_heartbeat_interval = 30
+    """
+    Interval, in seconds, on which to heartbeat idle connections. This helps
+    keep connections open through network devices that expire idle connections.
+    It also helps discover bad connections early in low-traffic scenarios.
+    Setting to zero disables heartbeats.
+    """
+
+    idle_heartbeat_timeout = 30
+    """
+    Timeout, in seconds, on which the heartbeat wait for idle connection responses.
+    Lowering this value can help to discover bad connections earlier.
+    """
+
+    schema_event_refresh_window = 2
+    """
+    Window, in seconds, within which a schema component will be refreshed after
+    receiving a schema_change event.
+
+    The driver delays a random amount of time in the range [0.0, window)
+    before executing the refresh. This serves two purposes:
+
+    1.) Spread the refresh for deployments with large fanout from C* to client tier,
+    preventing a 'thundering herd' problem with many clients refreshing simultaneously.
+
+    2.) Remove redundant refreshes. Redundant events arriving within the delay period
+    are discarded, and only one refresh is executed.
+
+    Setting this to zero will execute refreshes immediately.
+
+    Setting this negative will disable schema refreshes in response to push events
+    (refreshes will still occur in response to schema change responses to DDL statements
+    executed by Sessions of this Cluster).
+    """
+
+    topology_event_refresh_window = 10
+    """
+    Window, in seconds, within which the node and token list will be refreshed after
+    receiving a topology_change event.
+
+    Setting this to zero will execute refreshes immediately.
+
+    Setting this negative will disable node refreshes in response to push events.
+
+    See :attr:`.schema_event_refresh_window` for discussion of rationale
+    """
+
+    status_event_refresh_window = 2
+    """
+    Window, in seconds, within which the driver will start the reconnect after
+    receiving a status_change event.
+
+    Setting this to zero will connect immediately.
+
+    This is primarily used to avoid 'thundering herd' in deployments with large fanout from cluster to clients.
+    When nodes come up, clients attempt to reprepare prepared statements (depending on :attr:`.reprepare_on_up`), and
+    establish connection pools. This can cause a rush of connections and queries if not mitigated with this factor.
+    """
+
+    prepare_on_all_hosts = True
+    """
+    Specifies whether statements should be prepared on all hosts, or just one.
+
+    This can reasonably be disabled on long-running applications with numerous clients preparing statements on startup,
+    where a randomized initial condition of the load balancing policy can be expected to distribute prepares from
+    different clients across the cluster.
+    """
+
+    reprepare_on_up = True
+    """
+    Specifies whether all known prepared statements should be prepared on a node when it comes up.
+
+    May be used to avoid overwhelming a node on return, or if it is supposed that the node was only marked down due to
+    network. If statements are not reprepared, they are prepared on the first execution, causing
+    an extra roundtrip for one or more client requests.
+    """
+
+    connect_timeout = 5
+    """
+    Timeout, in seconds, for creating new connections.
+
+    This timeout covers the entire connection negotiation, including TCP
+    establishment, options passing, and authentication.
+    """
+
+    timestamp_generator = None
+    """
+    An object, shared between all sessions created by this cluster instance,
+    that generates timestamps when client-side timestamp generation is enabled.
+    By default, each :class:`Cluster` uses a new
+    :class:`~.MonotonicTimestampGenerator`.
+
+    Applications can set this value for custom timestamp behavior. See the
+    documentation for :meth:`Session.timestamp_generator`.
+    """
+
+    monitor_reporting_enabled = True
+    """
+    A boolean indicating if monitor reporting, which sends gathered data to
+    Insights when running against DSE 6.8 and higher.
+    """
+
+    monitor_reporting_interval = 30
+    """
+    A boolean indicating if monitor reporting, which sends gathered data to
+    Insights when running against DSE 6.8 and higher.
+    """
+
+    client_id = None
+    """
+    A UUID that uniquely identifies this Cluster object to Insights. This will
+    be generated automatically unless the user provides one.
+    """
+
+    application_name = ''
+    """
+    A string identifying this application to Insights.
+    """
+
+    application_version = ''
+    """
+    A string identifiying this application's version to Insights
+    """
+
+    cloud = None
+    """
+    A dict of the cloud configuration. Example::
+
+        {
+            # path to the secure connect bundle
+            'secure_connect_bundle': '/path/to/secure-connect-dbname.zip',
+
+            # optional config options
+            'use_default_tempdir': True  # use the system temp dir for the zip extraction
+        }
+
+    The zip file will be temporarily extracted in the same directory to
+    load the configuration and certificates.
+    """
+
+    column_encryption_policy = None
+    """
+    An instance of :class:`cassandra.policies.ColumnEncryptionPolicy` specifying encryption materials to be
+    used for columns in this cluster.
+    """
+
+    @property
+    def schema_metadata_enabled(self):
+        """
+        Flag indicating whether internal schema metadata is updated.
+
+        When disabled, the driver does not populate Cluster.metadata.keyspaces on connect, or on schema change events. This
+        can be used to speed initial connection, and reduce load on client and server during operation. Turning this off
+        gives away token aware request routing, and programmatic inspection of the metadata model.
+        """
+        return self.control_connection._schema_meta_enabled
+
+    @schema_metadata_enabled.setter
+    def schema_metadata_enabled(self, enabled):
+        self.control_connection._schema_meta_enabled = bool(enabled)
+
+    @property
+    def token_metadata_enabled(self):
+        """
+        Flag indicating whether internal token metadata is updated.
+
+        When disabled, the driver does not query node token information on connect, or on topology change events. This
+        can be used to speed initial connection, and reduce load on client and server during operation. It is most useful
+        in large clusters using vnodes, where the token map can be expensive to compute. Turning this off
+        gives away token aware request routing, and programmatic inspection of the token ring.
+        """
+        return self.control_connection._token_meta_enabled
+
+    @token_metadata_enabled.setter
+    def token_metadata_enabled(self, enabled):
+        self.control_connection._token_meta_enabled = bool(enabled)
+
+    endpoint_factory = None
+    """
+    An :class:`~.connection.EndPointFactory` instance to use internally when creating
+    a socket connection to a node. You can ignore this unless you need a special
+    connection mechanism.
+    """
+
+    profile_manager = None
+    _config_mode = _ConfigMode.UNCOMMITTED
+
+    sessions = None
+    control_connection = None
+    scheduler = None
+    executor = None
+    is_shutdown = False
+    _is_setup = False
+    _prepared_statements = None
+    _prepared_statement_lock = None
+    _idle_heartbeat = None
+    _protocol_version_explicit = False
+    _discount_down_events = True
+
+    _user_types = None
+    """
+    A map of {keyspace: {type_name: UserType}}
+    """
+
+    _listeners = None
+    _listener_lock = None
+
+    def __init__(self,
+                 contact_points=_NOT_SET,
+                 port=9042,
+                 compression=True,
+                 auth_provider=None,
+                 load_balancing_policy=None,
+                 reconnection_policy=None,
+                 default_retry_policy=None,
+                 conviction_policy_factory=None,
+                 metrics_enabled=False,
+                 connection_class=None,
+                 ssl_options=None,
+                 sockopts=None,
+                 cql_version=None,
+                 protocol_version=_NOT_SET,
+                 executor_threads=2,
+                 max_schema_agreement_wait=10,
+                 control_connection_timeout=2.0,
+                 idle_heartbeat_interval=30,
+                 schema_event_refresh_window=2,
+                 topology_event_refresh_window=10,
+                 connect_timeout=5,
+                 schema_metadata_enabled=True,
+                 token_metadata_enabled=True,
+                 address_translator=None,
+                 status_event_refresh_window=2,
+                 prepare_on_all_hosts=True,
+                 reprepare_on_up=True,
+                 execution_profiles=None,
+                 allow_beta_protocol_version=False,
+                 timestamp_generator=None,
+                 idle_heartbeat_timeout=30,
+                 no_compact=False,
+                 ssl_context=None,
+                 endpoint_factory=None,
+                 application_name=None,
+                 application_version=None,
+                 monitor_reporting_enabled=True,
+                 monitor_reporting_interval=30,
+                 client_id=None,
+                 cloud=None,
+                 column_encryption_policy=None):
+        """
+        ``executor_threads`` defines the number of threads in a pool for handling asynchronous tasks such as
+        extablishing connection pools or refreshing metadata.
+
+        Any of the mutable Cluster attributes may be set as keyword arguments to the constructor.
+        """
+        if connection_class is not None:
+            self.connection_class = connection_class
+
+        if cloud is not None:
+            self.cloud = cloud
+            if contact_points is not _NOT_SET or endpoint_factory or ssl_context or ssl_options:
+                raise ValueError("contact_points, endpoint_factory, ssl_context, and ssl_options "
+                                 "cannot be specified with a cloud configuration")
+
+            uses_twisted = TwistedConnection and issubclass(self.connection_class, TwistedConnection)
+            uses_eventlet = EventletConnection and issubclass(self.connection_class, EventletConnection)
+            cloud_config = dscloud.get_cloud_config(cloud, create_pyopenssl_context=uses_twisted or uses_eventlet)
+
+            ssl_context = cloud_config.ssl_context
+            ssl_options = {'check_hostname': True}
+            if (auth_provider is None and cloud_config.username
+                    and cloud_config.password):
+                auth_provider = PlainTextAuthProvider(cloud_config.username, cloud_config.password)
+
+            endpoint_factory = SniEndPointFactory(cloud_config.sni_host, cloud_config.sni_port)
+            contact_points = [
+                endpoint_factory.create_from_sni(host_id)
+                for host_id in cloud_config.host_ids
+            ]
+
+        if contact_points is not None:
+            if contact_points is _NOT_SET:
+                self._contact_points_explicit = False
+                contact_points = ['127.0.0.1']
+            else:
+                self._contact_points_explicit = True
+
+            if isinstance(contact_points, str):
+                raise TypeError("contact_points should not be a string, it should be a sequence (e.g. list) of strings")
+
+            if None in contact_points:
+                raise ValueError("contact_points should not contain None (it can resolve to localhost)")
+            self.contact_points = contact_points
+
+        self.port = port
+
+        if column_encryption_policy is not None:
+            self.column_encryption_policy = column_encryption_policy
+
+        self.endpoint_factory = endpoint_factory or DefaultEndPointFactory(port=self.port)
+        self.endpoint_factory.configure(self)
+
+        raw_contact_points = []
+        for cp in [cp for cp in self.contact_points if not isinstance(cp, EndPoint)]:
+            raw_contact_points.append(cp if isinstance(cp, tuple) else (cp, port))
+
+        self.endpoints_resolved = [cp for cp in self.contact_points if isinstance(cp, EndPoint)]
+        self._endpoint_map_for_insights = {repr(ep): '{ip}:{port}'.format(ip=ep.address, port=ep.port)
+                                           for ep in self.endpoints_resolved}
+
+        strs_resolved_map = _resolve_contact_points_to_string_map(raw_contact_points)
+        self.endpoints_resolved.extend(list(chain(
+            *[
+                [DefaultEndPoint(ip, port) for ip, port in xs if ip is not None]
+                for xs in strs_resolved_map.values() if xs is not None
+            ]
+        )))
+
+        self._endpoint_map_for_insights.update(
+            {key: ['{ip}:{port}'.format(ip=ip, port=port) for ip, port in value]
+             for key, value in strs_resolved_map.items() if value is not None}
+        )
+
+        if contact_points and (not self.endpoints_resolved):
+            # only want to raise here if the user specified CPs but resolution failed
+            raise UnresolvableContactPoints(self._endpoint_map_for_insights)
+
+        self.compression = compression
+
+        if protocol_version is not _NOT_SET:
+            self.protocol_version = protocol_version
+            self._protocol_version_explicit = True
+        self.allow_beta_protocol_version = allow_beta_protocol_version
+
+        self.no_compact = no_compact
+
+        self.auth_provider = auth_provider
+
+        if load_balancing_policy is not None:
+            if isinstance(load_balancing_policy, type):
+                raise TypeError("load_balancing_policy should not be a class, it should be an instance of that class")
+            self.load_balancing_policy = load_balancing_policy
+        else:
+            self._load_balancing_policy = default_lbp_factory()  # set internal attribute to avoid committing to legacy config mode
+
+        if reconnection_policy is not None:
+            if isinstance(reconnection_policy, type):
+                raise TypeError("reconnection_policy should not be a class, it should be an instance of that class")
+            self.reconnection_policy = reconnection_policy
+
+        if default_retry_policy is not None:
+            if isinstance(default_retry_policy, type):
+                raise TypeError("default_retry_policy should not be a class, it should be an instance of that class")
+            self.default_retry_policy = default_retry_policy
+
+        if conviction_policy_factory is not None:
+            if not callable(conviction_policy_factory):
+                raise ValueError("conviction_policy_factory must be callable")
+            self.conviction_policy_factory = conviction_policy_factory
+
+        if address_translator is not None:
+            if isinstance(address_translator, type):
+                raise TypeError("address_translator should not be a class, it should be an instance of that class")
+            self.address_translator = address_translator
+
+        if timestamp_generator is not None:
+            if not callable(timestamp_generator):
+                raise ValueError("timestamp_generator must be callable")
+            self.timestamp_generator = timestamp_generator
+        else:
+            self.timestamp_generator = MonotonicTimestampGenerator()
+
+        self.profile_manager = ProfileManager()
+        self.profile_manager.profiles[EXEC_PROFILE_DEFAULT] = ExecutionProfile(
+            self.load_balancing_policy,
+            self.default_retry_policy,
+            request_timeout=Session._default_timeout,
+            row_factory=Session._row_factory
+        )
+
+        # legacy mode if either of these is not default
+        if load_balancing_policy or default_retry_policy:
+            if execution_profiles:
+                raise ValueError("Clusters constructed with execution_profiles should not specify legacy parameters "
+                                 "load_balancing_policy or default_retry_policy. Configure this in a profile instead.")
+
+            self._config_mode = _ConfigMode.LEGACY
+            warn("Legacy execution parameters will be removed in 4.0. Consider using "
+                 "execution profiles.", DeprecationWarning)
+
+        else:
+            profiles = self.profile_manager.profiles
+            if execution_profiles:
+                profiles.update(execution_profiles)
+                self._config_mode = _ConfigMode.PROFILES
+
+            lbp = DefaultLoadBalancingPolicy(self.profile_manager.default.load_balancing_policy)
+            profiles.setdefault(EXEC_PROFILE_GRAPH_DEFAULT, GraphExecutionProfile(load_balancing_policy=lbp))
+            profiles.setdefault(EXEC_PROFILE_GRAPH_SYSTEM_DEFAULT,
+                                GraphExecutionProfile(load_balancing_policy=lbp, request_timeout=60. * 3.))
+            profiles.setdefault(EXEC_PROFILE_GRAPH_ANALYTICS_DEFAULT,
+                                GraphAnalyticsExecutionProfile(load_balancing_policy=lbp))
+
+        if self._contact_points_explicit and not self.cloud:  # avoid this warning for cloud users.
+            if self._config_mode is _ConfigMode.PROFILES:
+                default_lbp_profiles = self.profile_manager._profiles_without_explicit_lbps()
+                if default_lbp_profiles:
+                    log.warning(
+                        'Cluster.__init__ called with contact_points '
+                        'specified, but load-balancing policies are not '
+                        'specified in some ExecutionProfiles. In the next '
+                        'major version, this will raise an error; please '
+                        'specify a load-balancing policy. '
+                        '(contact_points = {cp}, '
+                        'EPs without explicit LBPs = {eps})'
+                        ''.format(cp=contact_points, eps=default_lbp_profiles))
+            else:
+                if load_balancing_policy is None:
+                    log.warning(
+                        'Cluster.__init__ called with contact_points '
+                        'specified, but no load_balancing_policy. In the next '
+                        'major version, this will raise an error; please '
+                        'specify a load-balancing policy. '
+                        '(contact_points = {cp}, lbp = {lbp})'
+                        ''.format(cp=contact_points, lbp=load_balancing_policy))
+
+        self.metrics_enabled = metrics_enabled
+
+        if ssl_options and not ssl_context:
+            warn('Using ssl_options without ssl_context is '
+                 'deprecated and will result in an error in '
+                 'the next major release. Please use ssl_context '
+                 'to prepare for that release.',
+                 DeprecationWarning)
+
+        self.ssl_options = ssl_options
+        self.ssl_context = ssl_context
+        self.sockopts = sockopts
+        self.cql_version = cql_version
+        self.max_schema_agreement_wait = max_schema_agreement_wait
+        self.control_connection_timeout = control_connection_timeout
+        self.idle_heartbeat_interval = idle_heartbeat_interval
+        self.idle_heartbeat_timeout = idle_heartbeat_timeout
+        self.schema_event_refresh_window = schema_event_refresh_window
+        self.topology_event_refresh_window = topology_event_refresh_window
+        self.status_event_refresh_window = status_event_refresh_window
+        self.connect_timeout = connect_timeout
+        self.prepare_on_all_hosts = prepare_on_all_hosts
+        self.reprepare_on_up = reprepare_on_up
+        self.monitor_reporting_enabled = monitor_reporting_enabled
+        self.monitor_reporting_interval = monitor_reporting_interval
+
+        self._listeners = set()
+        self._listener_lock = Lock()
+
+        # let Session objects be GC'ed (and shutdown) when the user no longer
+        # holds a reference.
+        self.sessions = WeakSet()
+        self.metadata = Metadata()
+        self.control_connection = None
+        self._prepared_statements = WeakValueDictionary()
+        self._prepared_statement_lock = Lock()
+
+        self._user_types = defaultdict(dict)
+
+        self._min_requests_per_connection = {
+            HostDistance.LOCAL: DEFAULT_MIN_REQUESTS,
+            HostDistance.REMOTE: DEFAULT_MIN_REQUESTS
+        }
+
+        self._max_requests_per_connection = {
+            HostDistance.LOCAL: DEFAULT_MAX_REQUESTS,
+            HostDistance.REMOTE: DEFAULT_MAX_REQUESTS
+        }
+
+        self._core_connections_per_host = {
+            HostDistance.LOCAL: DEFAULT_MIN_CONNECTIONS_PER_LOCAL_HOST,
+            HostDistance.REMOTE: DEFAULT_MIN_CONNECTIONS_PER_REMOTE_HOST
+        }
+
+        self._max_connections_per_host = {
+            HostDistance.LOCAL: DEFAULT_MAX_CONNECTIONS_PER_LOCAL_HOST,
+            HostDistance.REMOTE: DEFAULT_MAX_CONNECTIONS_PER_REMOTE_HOST
+        }
+
+        self.executor = self._create_thread_pool_executor(max_workers=executor_threads)
+        self.scheduler = _Scheduler(self.executor)
+
+        self._lock = RLock()
+
+        if self.metrics_enabled:
+            from cassandra.metrics import Metrics
+            self.metrics = Metrics(weakref.proxy(self))
+
+        self.control_connection = ControlConnection(
+            self, self.control_connection_timeout,
+            self.schema_event_refresh_window, self.topology_event_refresh_window,
+            self.status_event_refresh_window,
+            schema_metadata_enabled, token_metadata_enabled)
+
+        if client_id is None:
+            self.client_id = uuid.uuid4()
+        if application_name is not None:
+            self.application_name = application_name
+        if application_version is not None:
+            self.application_version = application_version
+
+    def _create_thread_pool_executor(self, **kwargs):
+        """
+        Create a ThreadPoolExecutor for the cluster. In most cases, the built-in
+        `concurrent.futures.ThreadPoolExecutor` is used.
+
+        Python 3.7+ and Eventlet cause the `concurrent.futures.ThreadPoolExecutor`
+        to hang indefinitely. In that case, the user needs to have the `futurist`
+        package so we can use the `futurist.GreenThreadPoolExecutor` class instead.
+
+        :param kwargs: All keyword args are passed to the ThreadPoolExecutor constructor.
+        :return: A ThreadPoolExecutor instance.
+        """
+        tpe_class = ThreadPoolExecutor
+        if sys.version_info[0] >= 3 and sys.version_info[1] >= 7:
+            try:
+                from cassandra.io.eventletreactor import EventletConnection
+                is_eventlet = issubclass(self.connection_class, EventletConnection)
+            except:
+                # Eventlet is not available or can't be detected
+                return tpe_class(**kwargs)
+
+            if is_eventlet:
+                try:
+                    from futurist import GreenThreadPoolExecutor
+                    tpe_class = GreenThreadPoolExecutor
+                except ImportError:
+                    # futurist is not available
+                    raise ImportError(
+                        ("Python 3.7+ and Eventlet cause the `concurrent.futures.ThreadPoolExecutor` "
+                         "to hang indefinitely. If you want to use the Eventlet reactor, you "
+                         "need to install the `futurist` package to allow the driver to use "
+                         "the GreenThreadPoolExecutor. See https://github.com/eventlet/eventlet/issues/508 "
+                         "for more details."))
+
+        return tpe_class(**kwargs)
+
+    def register_user_type(self, keyspace, user_type, klass):
+        """
+        Registers a class to use to represent a particular user-defined type.
+        Query parameters for this user-defined type will be assumed to be
+        instances of `klass`.  Result sets for this user-defined type will
+        be instances of `klass`.  If no class is registered for a user-defined
+        type, a namedtuple will be used for result sets, and non-prepared
+        statements may not encode parameters for this type correctly.
+
+        `keyspace` is the name of the keyspace that the UDT is defined in.
+
+        `user_type` is the string name of the UDT to register the mapping
+        for.
+
+        `klass` should be a class with attributes whose names match the
+        fields of the user-defined type.  The constructor must accepts kwargs
+        for each of the fields in the UDT.
+
+        This method should only be called after the type has been created
+        within Cassandra.
+
+        Example::
+
+            cluster = Cluster(protocol_version=3)
+            session = cluster.connect()
+            session.set_keyspace('mykeyspace')
+            session.execute("CREATE TYPE address (street text, zipcode int)")
+            session.execute("CREATE TABLE users (id int PRIMARY KEY, location address)")
+
+            # create a class to map to the "address" UDT
+            class Address(object):
+
+                def __init__(self, street, zipcode):
+                    self.street = street
+                    self.zipcode = zipcode
+
+            cluster.register_user_type('mykeyspace', 'address', Address)
+
+            # insert a row using an instance of Address
+            session.execute("INSERT INTO users (id, location) VALUES (%s, %s)",
+                            (0, Address("123 Main St.", 78723)))
+
+            # results will include Address instances
+            results = session.execute("SELECT * FROM users")
+            row = results[0]
+            print(row.id, row.location.street, row.location.zipcode)
+
+        """
+        if self.protocol_version < 3:
+            log.warning("User Type serialization is only supported in native protocol version 3+ (%d in use). "
+                        "CQL encoding for simple statements will still work, but named tuples will "
+                        "be returned when reading type %s.%s.", self.protocol_version, keyspace, user_type)
+
+        self._user_types[keyspace][user_type] = klass
+        for session in tuple(self.sessions):
+            session.user_type_registered(keyspace, user_type, klass)
+        UserType.evict_udt_class(keyspace, user_type)
+
+    def add_execution_profile(self, name, profile, pool_wait_timeout=5):
+        """
+        Adds an :class:`.ExecutionProfile` to the cluster. This makes it available for use by ``name`` in :meth:`.Session.execute`
+        and :meth:`.Session.execute_async`. This method will raise if the profile already exists.
+
+        Normally profiles will be injected at cluster initialization via ``Cluster(execution_profiles)``. This method
+        provides a way of adding them dynamically.
+
+        Adding a new profile updates the connection pools according to the specified ``load_balancing_policy``. By default,
+        this method will wait up to five seconds for the pool creation to complete, so the profile can be used immediately
+        upon return. This behavior can be controlled using ``pool_wait_timeout`` (see
+        `concurrent.futures.wait <https://docs.python.org/3/library/concurrent.futures.html#concurrent.futures.wait>`_
+        for timeout semantics).
+        """
+        if not isinstance(profile, ExecutionProfile):
+            raise TypeError("profile must be an instance of ExecutionProfile")
+        if self._config_mode == _ConfigMode.LEGACY:
+            raise ValueError("Cannot add execution profiles when legacy parameters are set explicitly.")
+        if name in self.profile_manager.profiles:
+            raise ValueError("Profile {} already exists".format(name))
+        contact_points_but_no_lbp = (
+            self._contact_points_explicit and not
+            profile._load_balancing_policy_explicit)
+        if contact_points_but_no_lbp:
+            log.warning(
+                'Tried to add an ExecutionProfile with name {name}. '
+                '{self} was explicitly configured with contact_points, but '
+                '{ep} was not explicitly configured with a '
+                'load_balancing_policy. In the next major version, trying to '
+                'add an ExecutionProfile without an explicitly configured LBP '
+                'to a cluster with explicitly configured contact_points will '
+                'raise an exception; please specify a load-balancing policy '
+                'in the ExecutionProfile.'
+                ''.format(name=_execution_profile_to_string(name), self=self, ep=profile))
+
+        self.profile_manager.profiles[name] = profile
+        profile.load_balancing_policy.populate(self, self.metadata.all_hosts())
+        # on_up after populate allows things like DCA LBP to choose default local dc
+        for host in filter(lambda h: h.is_up, self.metadata.all_hosts()):
+            profile.load_balancing_policy.on_up(host)
+        futures = set()
+        for session in tuple(self.sessions):
+            self._set_default_dbaas_consistency(session)
+            futures.update(session.update_created_pools())
+        _, not_done = wait_futures(futures, pool_wait_timeout)
+        if not_done:
+            raise OperationTimedOut("Failed to create all new connection pools in the %ss timeout.")
+
+    def get_min_requests_per_connection(self, host_distance):
+        return self._min_requests_per_connection[host_distance]
+
+    def set_min_requests_per_connection(self, host_distance, min_requests):
+        """
+        Sets a threshold for concurrent requests per connection, below which
+        connections will be considered for disposal (down to core connections;
+        see :meth:`~Cluster.set_core_connections_per_host`).
+
+        Pertains to connection pool management in protocol versions {1,2}.
+        """
+        if self.protocol_version >= 3:
+            raise UnsupportedOperation(
+                "Cluster.set_min_requests_per_connection() only has an effect "
+                "when using protocol_version 1 or 2.")
+        if min_requests < 0 or min_requests > 126 or \
+           min_requests >= self._max_requests_per_connection[host_distance]:
+            raise ValueError("min_requests must be 0-126 and less than the max_requests for this host_distance (%d)" %
+                             (self._min_requests_per_connection[host_distance],))
+        self._min_requests_per_connection[host_distance] = min_requests
+
+    def get_max_requests_per_connection(self, host_distance):
+        return self._max_requests_per_connection[host_distance]
+
+    def set_max_requests_per_connection(self, host_distance, max_requests):
+        """
+        Sets a threshold for concurrent requests per connection, above which new
+        connections will be created to a host (up to max connections;
+        see :meth:`~Cluster.set_max_connections_per_host`).
+
+        Pertains to connection pool management in protocol versions {1,2}.
+        """
+        if self.protocol_version >= 3:
+            raise UnsupportedOperation(
+                "Cluster.set_max_requests_per_connection() only has an effect "
+                "when using protocol_version 1 or 2.")
+        if max_requests < 1 or max_requests > 127 or \
+           max_requests <= self._min_requests_per_connection[host_distance]:
+            raise ValueError("max_requests must be 1-127 and greater than the min_requests for this host_distance (%d)" %
+                             (self._min_requests_per_connection[host_distance],))
+        self._max_requests_per_connection[host_distance] = max_requests
+
+    def get_core_connections_per_host(self, host_distance):
+        """
+        Gets the minimum number of connections per Session that will be opened
+        for each host with :class:`~.HostDistance` equal to `host_distance`.
+        The default is 2 for :attr:`~HostDistance.LOCAL` and 1 for
+        :attr:`~HostDistance.REMOTE`.
+
+        This property is ignored if :attr:`~.Cluster.protocol_version` is
+        3 or higher.
+        """
+        return self._core_connections_per_host[host_distance]
+
+    def set_core_connections_per_host(self, host_distance, core_connections):
+        """
+        Sets the minimum number of connections per Session that will be opened
+        for each host with :class:`~.HostDistance` equal to `host_distance`.
+        The default is 2 for :attr:`~HostDistance.LOCAL` and 1 for
+        :attr:`~HostDistance.REMOTE`.
+
+        Protocol version 1 and 2 are limited in the number of concurrent
+        requests they can send per connection. The driver implements connection
+        pooling to support higher levels of concurrency.
+
+        If :attr:`~.Cluster.protocol_version` is set to 3 or higher, this
+        is not supported (there is always one connection per host, unless
+        the host is remote and :attr:`connect_to_remote_hosts` is :const:`False`)
+        and using this will result in an :exc:`~.UnsupportedOperation`.
+        """
+        if self.protocol_version >= 3:
+            raise UnsupportedOperation(
+                "Cluster.set_core_connections_per_host() only has an effect "
+                "when using protocol_version 1 or 2.")
+        old = self._core_connections_per_host[host_distance]
+        self._core_connections_per_host[host_distance] = core_connections
+        if old < core_connections:
+            self._ensure_core_connections()
+
+    def get_max_connections_per_host(self, host_distance):
+        """
+        Gets the maximum number of connections per Session that will be opened
+        for each host with :class:`~.HostDistance` equal to `host_distance`.
+        The default is 8 for :attr:`~HostDistance.LOCAL` and 2 for
+        :attr:`~HostDistance.REMOTE`.
+
+        This property is ignored if :attr:`~.Cluster.protocol_version` is
+        3 or higher.
+        """
+        return self._max_connections_per_host[host_distance]
+
+    def set_max_connections_per_host(self, host_distance, max_connections):
+        """
+        Sets the maximum number of connections per Session that will be opened
+        for each host with :class:`~.HostDistance` equal to `host_distance`.
+        The default is 2 for :attr:`~HostDistance.LOCAL` and 1 for
+        :attr:`~HostDistance.REMOTE`.
+
+        If :attr:`~.Cluster.protocol_version` is set to 3 or higher, this
+        is not supported (there is always one connection per host, unless
+        the host is remote and :attr:`connect_to_remote_hosts` is :const:`False`)
+        and using this will result in an :exc:`~.UnsupportedOperation`.
+        """
+        if self.protocol_version >= 3:
+            raise UnsupportedOperation(
+                "Cluster.set_max_connections_per_host() only has an effect "
+                "when using protocol_version 1 or 2.")
+        self._max_connections_per_host[host_distance] = max_connections
+
+    def connection_factory(self, endpoint, *args, **kwargs):
+        """
+        Called to create a new connection with proper configuration.
+        Intended for internal use only.
+        """
+        kwargs = self._make_connection_kwargs(endpoint, kwargs)
+        return self.connection_class.factory(endpoint, self.connect_timeout, *args, **kwargs)
+
+    def _make_connection_factory(self, host, *args, **kwargs):
+        kwargs = self._make_connection_kwargs(host.endpoint, kwargs)
+        return partial(self.connection_class.factory, host.endpoint, self.connect_timeout, *args, **kwargs)
+
+    def _make_connection_kwargs(self, endpoint, kwargs_dict):
+        if self._auth_provider_callable:
+            kwargs_dict.setdefault('authenticator', self._auth_provider_callable(endpoint.address))
+
+        kwargs_dict.setdefault('port', self.port)
+        kwargs_dict.setdefault('compression', self.compression)
+        kwargs_dict.setdefault('sockopts', self.sockopts)
+        kwargs_dict.setdefault('ssl_options', self.ssl_options)
+        kwargs_dict.setdefault('ssl_context', self.ssl_context)
+        kwargs_dict.setdefault('cql_version', self.cql_version)
+        kwargs_dict.setdefault('protocol_version', self.protocol_version)
+        kwargs_dict.setdefault('user_type_map', self._user_types)
+        kwargs_dict.setdefault('allow_beta_protocol_version', self.allow_beta_protocol_version)
+        kwargs_dict.setdefault('no_compact', self.no_compact)
+
+        return kwargs_dict
+
+    def protocol_downgrade(self, host_endpoint, previous_version):
+        if self._protocol_version_explicit:
+            raise DriverException("ProtocolError returned from server while using explicitly set client protocol_version %d" % (previous_version,))
+        new_version = ProtocolVersion.get_lower_supported(previous_version)
+        if new_version < ProtocolVersion.MIN_SUPPORTED:
+            raise DriverException(
+                "Cannot downgrade protocol version below minimum supported version: %d" % (ProtocolVersion.MIN_SUPPORTED,))
+
+        log.warning("Downgrading core protocol version from %d to %d for %s. "
+                    "To avoid this, it is best practice to explicitly set Cluster(protocol_version) to the version supported by your cluster. "
+                    "http://datastax.github.io/python-driver/api/cassandra/cluster.html#cassandra.cluster.Cluster.protocol_version", self.protocol_version, new_version, host_endpoint)
+        self.protocol_version = new_version
+
+    def connect(self, keyspace=None, wait_for_all_pools=False):
+        """
+        Creates and returns a new :class:`~.Session` object.
+
+        If `keyspace` is specified, that keyspace will be the default keyspace for
+        operations on the ``Session``.
+
+        `wait_for_all_pools` specifies whether this call should wait for all connection pools to be
+        established or attempted. Default is `False`, which means it will return when the first
+        successful connection is established. Remaining pools are added asynchronously.
+        """
+        with self._lock:
+            if self.is_shutdown:
+                raise DriverException("Cluster is already shut down")
+
+            if not self._is_setup:
+                log.debug("Connecting to cluster, contact points: %s; protocol version: %s",
+                          self.contact_points, self.protocol_version)
+                self.connection_class.initialize_reactor()
+                _register_cluster_shutdown(self)
+                for endpoint in self.endpoints_resolved:
+                    host, new = self.add_host(endpoint, signal=False)
+                    if new:
+                        host.set_up()
+                        for listener in self.listeners:
+                            listener.on_add(host)
+
+                self.profile_manager.populate(
+                    weakref.proxy(self), self.metadata.all_hosts())
+                self.load_balancing_policy.populate(
+                    weakref.proxy(self), self.metadata.all_hosts()
+                )
+
+                try:
+                    self.control_connection.connect()
+
+                    # we set all contact points up for connecting, but we won't infer state after this
+                    for endpoint in self.endpoints_resolved:
+                        h = self.metadata.get_host(endpoint)
+                        if h and self.profile_manager.distance(h) == HostDistance.IGNORED:
+                            h.is_up = None
+
+                    log.debug("Control connection created")
+                except Exception:
+                    log.exception("Control connection failed to connect, "
+                                  "shutting down Cluster:")
+                    self.shutdown()
+                    raise
+
+                self.profile_manager.check_supported()  # todo: rename this method
+
+                if self.idle_heartbeat_interval:
+                    self._idle_heartbeat = ConnectionHeartbeat(
+                        self.idle_heartbeat_interval,
+                        self.get_connection_holders,
+                        timeout=self.idle_heartbeat_timeout
+                    )
+                self._is_setup = True
+
+        session = self._new_session(keyspace)
+        if wait_for_all_pools:
+            wait_futures(session._initial_connect_futures)
+
+        self._set_default_dbaas_consistency(session)
+
+        return session
+
+    def _set_default_dbaas_consistency(self, session):
+        if session.cluster.metadata.dbaas:
+            for profile in self.profile_manager.profiles.values():
+                if not profile._consistency_level_explicit:
+                    profile.consistency_level = ConsistencyLevel.LOCAL_QUORUM
+            session._default_consistency_level = ConsistencyLevel.LOCAL_QUORUM
+
+    def get_connection_holders(self):
+        holders = []
+        for s in tuple(self.sessions):
+            holders.extend(s.get_pools())
+        holders.append(self.control_connection)
+        return holders
+
+    def shutdown(self):
+        """
+        Closes all sessions and connection associated with this Cluster.
+        To ensure all connections are properly closed, **you should always
+        call shutdown() on a Cluster instance when you are done with it**.
+
+        Once shutdown, a Cluster should not be used for any purpose.
+        """
+        with self._lock:
+            if self.is_shutdown:
+                return
+            else:
+                self.is_shutdown = True
+
+        if self._idle_heartbeat:
+            self._idle_heartbeat.stop()
+
+        self.scheduler.shutdown()
+
+        self.control_connection.shutdown()
+
+        for session in tuple(self.sessions):
+            session.shutdown()
+
+        self.executor.shutdown()
+
+        _discard_cluster_shutdown(self)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.shutdown()
+
+    def _new_session(self, keyspace):
+        session = Session(self, self.metadata.all_hosts(), keyspace)
+        self._session_register_user_types(session)
+        self.sessions.add(session)
+        return session
+
+    def _session_register_user_types(self, session):
+        for keyspace, type_map in self._user_types.items():
+            for udt_name, klass in type_map.items():
+                session.user_type_registered(keyspace, udt_name, klass)
+
+    def _cleanup_failed_on_up_handling(self, host):
+        self.profile_manager.on_down(host)
+        self.control_connection.on_down(host)
+        for session in tuple(self.sessions):
+            session.remove_pool(host)
+
+        self._start_reconnector(host, is_host_addition=False)
+
+    def _on_up_future_completed(self, host, futures, results, lock, finished_future):
+        with lock:
+            futures.discard(finished_future)
+
+            try:
+                results.append(finished_future.result())
+            except Exception as exc:
+                results.append(exc)
+
+            if futures:
+                return
+
+        try:
+            # all futures have completed at this point
+            for exc in [f for f in results if isinstance(f, Exception)]:
+                log.error("Unexpected failure while marking node %s up:", host, exc_info=exc)
+                self._cleanup_failed_on_up_handling(host)
+                return
+
+            if not all(results):
+                log.debug("Connection pool could not be created, not marking node %s up", host)
+                self._cleanup_failed_on_up_handling(host)
+                return
+
+            log.info("Connection pools established for node %s", host)
+            # mark the host as up and notify all listeners
+            host.set_up()
+            for listener in self.listeners:
+                listener.on_up(host)
+        finally:
+            with host.lock:
+                host._currently_handling_node_up = False
+
+        # see if there are any pools to add or remove now that the host is marked up
+        for session in tuple(self.sessions):
+            session.update_created_pools()
+
+    def on_up(self, host):
+        """
+        Intended for internal use only.
+        """
+        if self.is_shutdown:
+            return
+
+        log.debug("Waiting to acquire lock for handling up status of node %s", host)
+        with host.lock:
+            if host._currently_handling_node_up:
+                log.debug("Another thread is already handling up status of node %s", host)
+                return
+
+            if host.is_up:
+                log.debug("Host %s was already marked up", host)
+                return
+
+            host._currently_handling_node_up = True
+        log.debug("Starting to handle up status of node %s", host)
+
+        have_future = False
+        futures = set()
+        try:
+            log.info("Host %s may be up; will prepare queries and open connection pool", host)
+
+            reconnector = host.get_and_set_reconnection_handler(None)
+            if reconnector:
+                log.debug("Now that host %s is up, cancelling the reconnection handler", host)
+                reconnector.cancel()
+
+            if self.profile_manager.distance(host) != HostDistance.IGNORED:
+                self._prepare_all_queries(host)
+                log.debug("Done preparing all queries for host %s, ", host)
+
+            for session in tuple(self.sessions):
+                session.remove_pool(host)
+
+            log.debug("Signalling to load balancing policies that host %s is up", host)
+            self.profile_manager.on_up(host)
+
+            log.debug("Signalling to control connection that host %s is up", host)
+            self.control_connection.on_up(host)
+
+            log.debug("Attempting to open new connection pools for host %s", host)
+            futures_lock = Lock()
+            futures_results = []
+            callback = partial(self._on_up_future_completed, host, futures, futures_results, futures_lock)
+            for session in tuple(self.sessions):
+                future = session.add_or_renew_pool(host, is_host_addition=False)
+                if future is not None:
+                    have_future = True
+                    future.add_done_callback(callback)
+                    futures.add(future)
+        except Exception:
+            log.exception("Unexpected failure handling node %s being marked up:", host)
+            for future in futures:
+                future.cancel()
+
+            self._cleanup_failed_on_up_handling(host)
+
+            with host.lock:
+                host._currently_handling_node_up = False
+            raise
+        else:
+            if not have_future:
+                with host.lock:
+                    host.set_up()
+                    host._currently_handling_node_up = False
+
+        # for testing purposes
+        return futures
+
+    def _start_reconnector(self, host, is_host_addition):
+        if self.profile_manager.distance(host) == HostDistance.IGNORED:
+            return
+
+        schedule = self.reconnection_policy.new_schedule()
+
+        # in order to not hold references to this Cluster open and prevent
+        # proper shutdown when the program ends, we'll just make a closure
+        # of the current Cluster attributes to create new Connections with
+        conn_factory = self._make_connection_factory(host)
+
+        reconnector = _HostReconnectionHandler(
+            host, conn_factory, is_host_addition, self.on_add, self.on_up,
+            self.scheduler, schedule, host.get_and_set_reconnection_handler,
+            new_handler=None)
+
+        old_reconnector = host.get_and_set_reconnection_handler(reconnector)
+        if old_reconnector:
+            log.debug("Old host reconnector found for %s, cancelling", host)
+            old_reconnector.cancel()
+
+        log.debug("Starting reconnector for host %s", host)
+        reconnector.start()
+
+    @run_in_executor
+    def on_down(self, host, is_host_addition, expect_host_to_be_down=False):
+        """
+        Intended for internal use only.
+        """
+        if self.is_shutdown:
+            return
+
+        with host.lock:
+            was_up = host.is_up
+
+            # ignore down signals if we have open pools to the host
+            # this is to avoid closing pools when a control connection host became isolated
+            if self._discount_down_events and self.profile_manager.distance(host) != HostDistance.IGNORED:
+                connected = False
+                for session in tuple(self.sessions):
+                    pool_states = session.get_pool_state()
+                    pool_state = pool_states.get(host)
+                    if pool_state:
+                        connected |= pool_state['open_count'] > 0
+                if connected:
+                    return
+
+            host.set_down()
+            if (not was_up and not expect_host_to_be_down) or host.is_currently_reconnecting():
+                return
+
+        log.warning("Host %s has been marked down", host)
+
+        self.profile_manager.on_down(host)
+        self.control_connection.on_down(host)
+        for session in tuple(self.sessions):
+            session.on_down(host)
+
+        for listener in self.listeners:
+            listener.on_down(host)
+
+        self._start_reconnector(host, is_host_addition)
+
+    def on_add(self, host, refresh_nodes=True):
+        if self.is_shutdown:
+            return
+
+        log.debug("Handling new host %r and notifying listeners", host)
+
+        distance = self.profile_manager.distance(host)
+        if distance != HostDistance.IGNORED:
+            self._prepare_all_queries(host)
+            log.debug("Done preparing queries for new host %r", host)
+
+        self.profile_manager.on_add(host)
+        self.control_connection.on_add(host, refresh_nodes)
+
+        if distance == HostDistance.IGNORED:
+            log.debug("Not adding connection pool for new host %r because the "
+                      "load balancing policy has marked it as IGNORED", host)
+            self._finalize_add(host, set_up=False)
+            return
+
+        futures_lock = Lock()
+        futures_results = []
+        futures = set()
+
+        def future_completed(future):
+            with futures_lock:
+                futures.discard(future)
+
+                try:
+                    futures_results.append(future.result())
+                except Exception as exc:
+                    futures_results.append(exc)
+
+                if futures:
+                    return
+
+            log.debug('All futures have completed for added host %s', host)
+
+            for exc in [f for f in futures_results if isinstance(f, Exception)]:
+                log.error("Unexpected failure while adding node %s, will not mark up:", host, exc_info=exc)
+                return
+
+            if not all(futures_results):
+                log.warning("Connection pool could not be created, not marking node %s up", host)
+                return
+
+            self._finalize_add(host)
+
+        have_future = False
+        for session in tuple(self.sessions):
+            future = session.add_or_renew_pool(host, is_host_addition=True)
+            if future is not None:
+                have_future = True
+                futures.add(future)
+                future.add_done_callback(future_completed)
+
+        if not have_future:
+            self._finalize_add(host)
+
+    def _finalize_add(self, host, set_up=True):
+        if set_up:
+            host.set_up()
+
+        for listener in self.listeners:
+            listener.on_add(host)
+
+        # see if there are any pools to add or remove now that the host is marked up
+        for session in tuple(self.sessions):
+            session.update_created_pools()
+
+    def on_remove(self, host):
+        if self.is_shutdown:
+            return
+
+        log.debug("Removing host %s", host)
+        host.set_down()
+        self.profile_manager.on_remove(host)
+        for session in tuple(self.sessions):
+            session.on_remove(host)
+        for listener in self.listeners:
+            listener.on_remove(host)
+        self.control_connection.on_remove(host)
+
+        reconnection_handler = host.get_and_set_reconnection_handler(None)
+        if reconnection_handler:
+            reconnection_handler.cancel()
+
+    def signal_connection_failure(self, host, connection_exc, is_host_addition, expect_host_to_be_down=False):
+        is_down = host.signal_connection_failure(connection_exc)
+        if is_down:
+            self.on_down(host, is_host_addition, expect_host_to_be_down)
+        return is_down
+
+    def add_host(self, endpoint, datacenter=None, rack=None, signal=True, refresh_nodes=True):
+        """
+        Called when adding initial contact points and when the control
+        connection subsequently discovers a new node.
+        Returns a Host instance, and a flag indicating whether it was new in
+        the metadata.
+        Intended for internal use only.
+        """
+        host, new = self.metadata.add_or_return_host(Host(endpoint, self.conviction_policy_factory, datacenter, rack))
+        if new and signal:
+            log.info("New Cassandra host %r discovered", host)
+            self.on_add(host, refresh_nodes)
+
+        return host, new
+
+    def remove_host(self, host):
+        """
+        Called when the control connection observes that a node has left the
+        ring.  Intended for internal use only.
+        """
+        if host and self.metadata.remove_host(host):
+            log.info("Cassandra host %s removed", host)
+            self.on_remove(host)
+
+    def register_listener(self, listener):
+        """
+        Adds a :class:`cassandra.policies.HostStateListener` subclass instance to
+        the list of listeners to be notified when a host is added, removed,
+        marked up, or marked down.
+        """
+        with self._listener_lock:
+            self._listeners.add(listener)
+
+    def unregister_listener(self, listener):
+        """ Removes a registered listener. """
+        with self._listener_lock:
+            self._listeners.remove(listener)
+
+    @property
+    def listeners(self):
+        with self._listener_lock:
+            return self._listeners.copy()
+
+    def _ensure_core_connections(self):
+        """
+        If any host has fewer than the configured number of core connections
+        open, attempt to open connections until that number is met.
+        """
+        for session in tuple(self.sessions):
+            for pool in tuple(session._pools.values()):
+                pool.ensure_core_connections()
+
+    @staticmethod
+    def _validate_refresh_schema(keyspace, table, usertype, function, aggregate):
+        if any((table, usertype, function, aggregate)):
+            if not keyspace:
+                raise ValueError("keyspace is required to refresh specific sub-entity {table, usertype, function, aggregate}")
+            if sum(1 for e in (table, usertype, function) if e) > 1:
+                raise ValueError("{table, usertype, function, aggregate} are mutually exclusive")
+
+    @staticmethod
+    def _target_type_from_refresh_args(keyspace, table, usertype, function, aggregate):
+        if aggregate:
+            return SchemaTargetType.AGGREGATE
+        elif function:
+            return SchemaTargetType.FUNCTION
+        elif usertype:
+            return SchemaTargetType.TYPE
+        elif table:
+            return SchemaTargetType.TABLE
+        elif keyspace:
+            return SchemaTargetType.KEYSPACE
+        return None
+
+    def get_control_connection_host(self):
+        """
+        Returns the control connection host metadata.
+        """
+        connection = self.control_connection._connection
+        endpoint = connection.endpoint if connection else None
+        return self.metadata.get_host(endpoint) if endpoint else None
+
+    def refresh_schema_metadata(self, max_schema_agreement_wait=None):
+        """
+        Synchronously refresh all schema metadata.
+
+        By default, the timeout for this operation is governed by :attr:`~.Cluster.max_schema_agreement_wait`
+        and :attr:`~.Cluster.control_connection_timeout`.
+
+        Passing max_schema_agreement_wait here overrides :attr:`~.Cluster.max_schema_agreement_wait`.
+
+        Setting max_schema_agreement_wait <= 0 will bypass schema agreement and refresh schema immediately.
+
+        An Exception is raised if schema refresh fails for any reason.
+        """
+        if not self.control_connection.refresh_schema(schema_agreement_wait=max_schema_agreement_wait, force=True):
+            raise DriverException("Schema metadata was not refreshed. See log for details.")
+
+    def refresh_keyspace_metadata(self, keyspace, max_schema_agreement_wait=None):
+        """
+        Synchronously refresh keyspace metadata. This applies to keyspace-level information such as replication
+        and durability settings. It does not refresh tables, types, etc. contained in the keyspace.
+
+        See :meth:`~.Cluster.refresh_schema_metadata` for description of ``max_schema_agreement_wait`` behavior
+        """
+        if not self.control_connection.refresh_schema(target_type=SchemaTargetType.KEYSPACE, keyspace=keyspace,
+                                                      schema_agreement_wait=max_schema_agreement_wait, force=True):
+            raise DriverException("Keyspace metadata was not refreshed. See log for details.")
+
+    def refresh_table_metadata(self, keyspace, table, max_schema_agreement_wait=None):
+        """
+        Synchronously refresh table metadata. This applies to a table, and any triggers or indexes attached
+        to the table.
+
+        See :meth:`~.Cluster.refresh_schema_metadata` for description of ``max_schema_agreement_wait`` behavior
+        """
+        if not self.control_connection.refresh_schema(target_type=SchemaTargetType.TABLE, keyspace=keyspace, table=table,
+                                                      schema_agreement_wait=max_schema_agreement_wait, force=True):
+            raise DriverException("Table metadata was not refreshed. See log for details.")
+
+    def refresh_materialized_view_metadata(self, keyspace, view, max_schema_agreement_wait=None):
+        """
+        Synchronously refresh materialized view metadata.
+
+        See :meth:`~.Cluster.refresh_schema_metadata` for description of ``max_schema_agreement_wait`` behavior
+        """
+        if not self.control_connection.refresh_schema(target_type=SchemaTargetType.TABLE, keyspace=keyspace, table=view,
+                                                      schema_agreement_wait=max_schema_agreement_wait, force=True):
+            raise DriverException("View metadata was not refreshed. See log for details.")
+
+    def refresh_user_type_metadata(self, keyspace, user_type, max_schema_agreement_wait=None):
+        """
+        Synchronously refresh user defined type metadata.
+
+        See :meth:`~.Cluster.refresh_schema_metadata` for description of ``max_schema_agreement_wait`` behavior
+        """
+        if not self.control_connection.refresh_schema(target_type=SchemaTargetType.TYPE, keyspace=keyspace, type=user_type,
+                                                      schema_agreement_wait=max_schema_agreement_wait, force=True):
+            raise DriverException("User Type metadata was not refreshed. See log for details.")
+
+    def refresh_user_function_metadata(self, keyspace, function, max_schema_agreement_wait=None):
+        """
+        Synchronously refresh user defined function metadata.
+
+        ``function`` is a :class:`cassandra.UserFunctionDescriptor`.
+
+        See :meth:`~.Cluster.refresh_schema_metadata` for description of ``max_schema_agreement_wait`` behavior
+        """
+        if not self.control_connection.refresh_schema(target_type=SchemaTargetType.FUNCTION, keyspace=keyspace, function=function,
+                                                      schema_agreement_wait=max_schema_agreement_wait, force=True):
+            raise DriverException("User Function metadata was not refreshed. See log for details.")
+
+    def refresh_user_aggregate_metadata(self, keyspace, aggregate, max_schema_agreement_wait=None):
+        """
+        Synchronously refresh user defined aggregate metadata.
+
+        ``aggregate`` is a :class:`cassandra.UserAggregateDescriptor`.
+
+        See :meth:`~.Cluster.refresh_schema_metadata` for description of ``max_schema_agreement_wait`` behavior
+        """
+        if not self.control_connection.refresh_schema(target_type=SchemaTargetType.AGGREGATE, keyspace=keyspace, aggregate=aggregate,
+                                                      schema_agreement_wait=max_schema_agreement_wait, force=True):
+            raise DriverException("User Aggregate metadata was not refreshed. See log for details.")
+
+    def refresh_nodes(self, force_token_rebuild=False):
+        """
+        Synchronously refresh the node list and token metadata
+
+        `force_token_rebuild` can be used to rebuild the token map metadata, even if no new nodes are discovered.
+
+        An Exception is raised if node refresh fails for any reason.
+        """
+        if not self.control_connection.refresh_node_list_and_token_map(force_token_rebuild):
+            raise DriverException("Node list was not refreshed. See log for details.")
+
+    def set_meta_refresh_enabled(self, enabled):
+        """
+        *Deprecated:* set :attr:`~.Cluster.schema_metadata_enabled` :attr:`~.Cluster.token_metadata_enabled` instead
+
+        Sets a flag to enable (True) or disable (False) all metadata refresh queries.
+        This applies to both schema and node topology.
+
+        Disabling this is useful to minimize refreshes during multiple changes.
+
+        Meta refresh must be enabled for the driver to become aware of any cluster
+        topology changes or schema updates.
+        """
+        warn("Cluster.set_meta_refresh_enabled is deprecated and will be removed in 4.0. Set "
+             "Cluster.schema_metadata_enabled and Cluster.token_metadata_enabled instead.", DeprecationWarning)
+        self.schema_metadata_enabled = enabled
+        self.token_metadata_enabled = enabled
+
+    @classmethod
+    def _send_chunks(cls, connection, host, chunks, set_keyspace=False):
+        for ks_chunk in chunks:
+            messages = [PrepareMessage(query=s.query_string,
+                                       keyspace=s.keyspace if set_keyspace else None)
+                        for s in ks_chunk]
+            # TODO: make this timeout configurable somehow?
+            responses = connection.wait_for_responses(*messages, timeout=5.0, fail_on_error=False)
+            for success, response in responses:
+                if not success:
+                    log.debug("Got unexpected response when preparing "
+                              "statement on host %s: %r", host, response)
+
+    def _prepare_all_queries(self, host):
+        if not self._prepared_statements or not self.reprepare_on_up:
+            return
+
+        log.debug("Preparing all known prepared statements against host %s", host)
+        connection = None
+        try:
+            connection = self.connection_factory(host.endpoint)
+            statements = list(self._prepared_statements.values())
+            if ProtocolVersion.uses_keyspace_flag(self.protocol_version):
+                # V5 protocol and higher, no need to set the keyspace
+                chunks = []
+                for i in range(0, len(statements), 10):
+                    chunks.append(statements[i:i + 10])
+                    self._send_chunks(connection, host, chunks, True)
+            else:
+                for keyspace, ks_statements in groupby(statements, lambda s: s.keyspace):
+                    if keyspace is not None:
+                        connection.set_keyspace_blocking(keyspace)
+
+                    # prepare 10 statements at a time
+                    ks_statements = list(ks_statements)
+                    chunks = []
+                    for i in range(0, len(ks_statements), 10):
+                        chunks.append(ks_statements[i:i + 10])
+                    self._send_chunks(connection, host, chunks)
+
+            log.debug("Done preparing all known prepared statements against host %s", host)
+        except OperationTimedOut as timeout:
+            log.warning("Timed out trying to prepare all statements on host %s: %s", host, timeout)
+        except (ConnectionException, socket.error) as exc:
+            log.warning("Error trying to prepare all statements on host %s: %r", host, exc)
+        except Exception:
+            log.exception("Error trying to prepare all statements on host %s", host)
+        finally:
+            if connection:
+                connection.close()
+
+    def add_prepared(self, query_id, prepared_statement):
+        with self._prepared_statement_lock:
+            self._prepared_statements[query_id] = prepared_statement
+
+
+class Session(object):
+    """
+    A collection of connection pools for each host in the cluster.
+    Instances of this class should not be created directly, only
+    using :meth:`.Cluster.connect()`.
+
+    Queries and statements can be executed through ``Session`` instances
+    using the :meth:`~.Session.execute()` and :meth:`~.Session.execute_async()`
+    methods.
+
+    Example usage::
+
+        >>> session = cluster.connect()
+        >>> session.set_keyspace("mykeyspace")
+        >>> session.execute("SELECT * FROM mycf")
+
+    """
+
+    cluster = None
+    hosts = None
+    keyspace = None
+    is_shutdown = False
+    session_id = None
+    _monitor_reporter = None
+
+    _row_factory = staticmethod(named_tuple_factory)
+    @property
+    def row_factory(self):
+        """
+        The format to return row results in.  By default, each
+        returned row will be a named tuple.  You can alternatively
+        use any of the following:
+
+        - :func:`cassandra.query.tuple_factory` - return a result row as a tuple
+        - :func:`cassandra.query.named_tuple_factory` - return a result row as a named tuple
+        - :func:`cassandra.query.dict_factory` - return a result row as a dict
+        - :func:`cassandra.query.ordered_dict_factory` - return a result row as an OrderedDict
+
+        """
+        return self._row_factory
+
+    @row_factory.setter
+    def row_factory(self, rf):
+        self._validate_set_legacy_config('row_factory', rf)
+
+    _default_timeout = 10.0
+
+    @property
+    def default_timeout(self):
+        """
+        A default timeout, measured in seconds, for queries executed through
+        :meth:`.execute()` or :meth:`.execute_async()`.  This default may be
+        overridden with the `timeout` parameter for either of those methods.
+
+        Setting this to :const:`None` will cause no timeouts to be set by default.
+
+        Please see :meth:`.ResponseFuture.result` for details on the scope and
+        effect of this timeout.
+
+        .. versionadded:: 2.0.0
+        """
+        return self._default_timeout
+
+    @default_timeout.setter
+    def default_timeout(self, timeout):
+        self._validate_set_legacy_config('default_timeout', timeout)
+
+    _default_consistency_level = ConsistencyLevel.LOCAL_ONE
+
+    @property
+    def default_consistency_level(self):
+        """
+        *Deprecated:* use execution profiles instead
+        The default :class:`~ConsistencyLevel` for operations executed through
+        this session.  This default may be overridden by setting the
+        :attr:`~.Statement.consistency_level` on individual statements.
+
+        .. versionadded:: 1.2.0
+
+        .. versionchanged:: 3.0.0
+
+            default changed from ONE to LOCAL_ONE
+        """
+        return self._default_consistency_level
+
+    @default_consistency_level.setter
+    def default_consistency_level(self, cl):
+        """
+        *Deprecated:* use execution profiles instead
+        """
+        warn("Setting the consistency level at the session level will be removed in 4.0. Consider using "
+             "execution profiles and setting the desired consistency level to the EXEC_PROFILE_DEFAULT profile."
+             , DeprecationWarning)
+        self._validate_set_legacy_config('default_consistency_level', cl)
+
+    _default_serial_consistency_level = None
+
+    @property
+    def default_serial_consistency_level(self):
+        """
+        The default :class:`~ConsistencyLevel` for serial phase of  conditional updates executed through
+        this session.  This default may be overridden by setting the
+        :attr:`~.Statement.serial_consistency_level` on individual statements.
+
+        Only valid for ``protocol_version >= 2``.
+        """
+        return self._default_serial_consistency_level
+
+    @default_serial_consistency_level.setter
+    def default_serial_consistency_level(self, cl):
+        if (cl is not None and
+                not ConsistencyLevel.is_serial(cl)):
+            raise ValueError("default_serial_consistency_level must be either "
+                             "ConsistencyLevel.SERIAL "
+                             "or ConsistencyLevel.LOCAL_SERIAL.")
+
+        self._validate_set_legacy_config('default_serial_consistency_level', cl)
+
+    max_trace_wait = 2.0
+    """
+    The maximum amount of time (in seconds) the driver will wait for trace
+    details to be populated server-side for a query before giving up.
+    If the `trace` parameter for :meth:`~.execute()` or :meth:`~.execute_async()`
+    is :const:`True`, the driver will repeatedly attempt to fetch trace
+    details for the query (using exponential backoff) until this limit is
+    hit.  If the limit is passed, an error will be logged and the
+    :attr:`.Statement.trace` will be left as :const:`None`. """
+
+    default_fetch_size = 5000
+    """
+    By default, this many rows will be fetched at a time. Setting
+    this to :const:`None` will disable automatic paging for large query
+    results.  The fetch size can be also specified per-query through
+    :attr:`.Statement.fetch_size`.
+
+    This only takes effect when protocol version 2 or higher is used.
+    See :attr:`.Cluster.protocol_version` for details.
+
+    .. versionadded:: 2.0.0
+    """
+
+    use_client_timestamp = True
+    """
+    When using protocol version 3 or higher, write timestamps may be supplied
+    client-side at the protocol level.  (Normally they are generated
+    server-side by the coordinator node.)  Note that timestamps specified
+    within a CQL query will override this timestamp.
+
+    .. versionadded:: 2.1.0
+    """
+
+    timestamp_generator = None
+    """
+    When :attr:`use_client_timestamp` is set, sessions call this object and use
+    the result as the timestamp.  (Note that timestamps specified within a CQL
+    query will override this timestamp.)  By default, a new
+    :class:`~.MonotonicTimestampGenerator` is created for
+    each :class:`Cluster` instance.
+
+    Applications can set this value for custom timestamp behavior.  For
+    example, an application could share a timestamp generator across
+    :class:`Cluster` objects to guarantee that the application will use unique,
+    increasing timestamps across clusters, or set it to to ``lambda:
+    int(time.time() * 1e6)`` if losing records over clock inconsistencies is
+    acceptable for the application. Custom :attr:`timestamp_generator` s should
+    be callable, and calling them should return an integer representing microseconds
+    since some point in time, typically UNIX epoch.
+
+    .. versionadded:: 3.8.0
+    """
+
+    encoder = None
+    """
+    A :class:`~cassandra.encoder.Encoder` instance that will be used when
+    formatting query parameters for non-prepared statements.  This is not used
+    for prepared statements (because prepared statements give the driver more
+    information about what CQL types are expected, allowing it to accept a
+    wider range of python types).
+
+    The encoder uses a mapping from python types to encoder methods (for
+    specific CQL types).  This mapping can be be modified by users as they see
+    fit.  Methods of :class:`~cassandra.encoder.Encoder` should be used for mapping
+    values if possible, because they take precautions to avoid injections and
+    properly sanitize data.
+
+    Example::
+
+        cluster = Cluster()
+        session = cluster.connect("mykeyspace")
+        session.encoder.mapping[tuple] = session.encoder.cql_encode_tuple
+
+        session.execute("CREATE TABLE mytable (k int PRIMARY KEY, col tuple<int, ascii>)")
+        session.execute("INSERT INTO mytable (k, col) VALUES (%s, %s)", [0, (123, 'abc')])
+
+    .. versionadded:: 2.1.0
+    """
+
+    client_protocol_handler = ProtocolHandler
+    """
+    Specifies a protocol handler that will be used for client-initiated requests (i.e. no
+    internal driver requests). This can be used to override or extend features such as
+    message or type ser/des.
+
+    The default pure python implementation is :class:`cassandra.protocol.ProtocolHandler`.
+
+    When compiled with Cython, there are also built-in faster alternatives. See :ref:`faster_deser`
+    """
+
+    session_id = None
+    """
+    A UUID that uniquely identifies this Session to Insights. This will be
+    generated automatically.
+    """
+
+    _lock = None
+    _pools = None
+    _profile_manager = None
+    _metrics = None
+    _request_init_callbacks = None
+    _graph_paging_available = False
+
+    def __init__(self, cluster, hosts, keyspace=None):
+        self.cluster = cluster
+        self.hosts = hosts
+        self.keyspace = keyspace
+
+        self._lock = RLock()
+        self._pools = {}
+        self._profile_manager = cluster.profile_manager
+        self._metrics = cluster.metrics
+        self._request_init_callbacks = []
+        self._protocol_version = self.cluster.protocol_version
+
+        self.encoder = Encoder()
+
+        # create connection pools in parallel
+        self._initial_connect_futures = set()
+        for host in hosts:
+            future = self.add_or_renew_pool(host, is_host_addition=False)
+            if future:
+                self._initial_connect_futures.add(future)
+
+        futures = wait_futures(self._initial_connect_futures, return_when=FIRST_COMPLETED)
+        while futures.not_done and not any(f.result() for f in futures.done):
+            futures = wait_futures(futures.not_done, return_when=FIRST_COMPLETED)
+
+        if not any(f.result() for f in self._initial_connect_futures):
+            msg = "Unable to connect to any servers"
+            if self.keyspace:
+                msg += " using keyspace '%s'" % self.keyspace
+            raise NoHostAvailable(msg, [h.address for h in hosts])
+
+        self.session_id = uuid.uuid4()
+        self._graph_paging_available = self._check_graph_paging_available()
+
+        if self.cluster.column_encryption_policy is not None:
+            try:
+                self.client_protocol_handler = type(
+                    str(self.session_id) + "-ProtocolHandler",
+                    (ProtocolHandler,),
+                    {"column_encryption_policy": self.cluster.column_encryption_policy})
+            except AttributeError:
+                log.info("Unable to set column encryption policy for session")
+
+        if self.cluster.monitor_reporting_enabled:
+            cc_host = self.cluster.get_control_connection_host()
+            valid_insights_version = (cc_host and version_supports_insights(cc_host.dse_version))
+            if valid_insights_version:
+                self._monitor_reporter = MonitorReporter(
+                    interval_sec=self.cluster.monitor_reporting_interval,
+                    session=self,
+                )
+            else:
+                if cc_host:
+                    log.debug('Not starting MonitorReporter thread for Insights; '
+                              'not supported by server version {v} on '
+                              'ControlConnection host {c}'.format(v=cc_host.release_version, c=cc_host))
+
+        log.debug('Started Session with client_id {} and session_id {}'.format(self.cluster.client_id,
+                                                                               self.session_id))
+
+    def execute(self, query, parameters=None, timeout=_NOT_SET, trace=False,
+                custom_payload=None, execution_profile=EXEC_PROFILE_DEFAULT,
+                paging_state=None, host=None, execute_as=None):
+        """
+        Execute the given query and synchronously wait for the response.
+
+        If an error is encountered while executing the query, an Exception
+        will be raised.
+
+        `query` may be a query string or an instance of :class:`cassandra.query.Statement`.
+
+        `parameters` may be a sequence or dict of parameters to bind.  If a
+        sequence is used, ``%s`` should be used the placeholder for each
+        argument.  If a dict is used, ``%(name)s`` style placeholders must
+        be used.
+
+        `timeout` should specify a floating-point timeout (in seconds) after
+        which an :exc:`.OperationTimedOut` exception will be raised if the query
+        has not completed.  If not set, the timeout defaults to the request_timeout of the selected ``execution_profile``.
+        If set to :const:`None`, there is no timeout. Please see :meth:`.ResponseFuture.result` for details on
+        the scope and effect of this timeout.
+
+        If `trace` is set to :const:`True`, the query will be sent with tracing enabled.
+        The trace details can be obtained using the returned :class:`.ResultSet` object.
+
+        `custom_payload` is a :ref:`custom_payload` dict to be passed to the server.
+        If `query` is a Statement with its own custom_payload. The message payload
+        will be a union of the two, with the values specified here taking precedence.
+
+        `execution_profile` is the execution profile to use for this request. It can be a key to a profile configured
+        via :meth:`Cluster.add_execution_profile` or an instance (from :meth:`Session.execution_profile_clone_update`,
+        for example
+
+        `paging_state` is an optional paging state, reused from a previous :class:`ResultSet`.
+
+        `host` is the :class:`cassandra.pool.Host` that should handle the query. If the host specified is down or
+        not yet connected, the query will fail with :class:`NoHostAvailable`. Using this is
+        discouraged except in a few cases, e.g., querying node-local tables and applying schema changes.
+
+        `execute_as` the user that will be used on the server to execute the request. This is only available
+        on a DSE cluster.
+        """
+
+        return self.execute_async(query, parameters, trace, custom_payload, timeout, execution_profile, paging_state, host, execute_as).result()
+
+    def execute_async(self, query, parameters=None, trace=False, custom_payload=None,
+                      timeout=_NOT_SET, execution_profile=EXEC_PROFILE_DEFAULT,
+                      paging_state=None, host=None, execute_as=None):
+        """
+        Execute the given query and return a :class:`~.ResponseFuture` object
+        which callbacks may be attached to for asynchronous response
+        delivery.  You may also call :meth:`~.ResponseFuture.result()`
+        on the :class:`.ResponseFuture` to synchronously block for results at
+        any time.
+
+        See :meth:`Session.execute` for parameter definitions.
+
+        Example usage::
+
+            >>> session = cluster.connect()
+            >>> future = session.execute_async("SELECT * FROM mycf")
+
+            >>> def log_results(results):
+            ...     for row in results:
+            ...         log.info("Results: %s", row)
+
+            >>> def log_error(exc):
+            >>>     log.error("Operation failed: %s", exc)
+
+            >>> future.add_callbacks(log_results, log_error)
+
+        Async execution with blocking wait for results::
+
+            >>> future = session.execute_async("SELECT * FROM mycf")
+            >>> # do other stuff...
+
+            >>> try:
+            ...     results = future.result()
+            ... except Exception:
+            ...     log.exception("Operation failed:")
+
+        """
+        custom_payload = custom_payload if custom_payload else {}
+        if execute_as:
+            custom_payload[_proxy_execute_key] = execute_as.encode()
+
+        future = self._create_response_future(
+            query, parameters, trace, custom_payload, timeout,
+            execution_profile, paging_state, host)
+        future._protocol_handler = self.client_protocol_handler
+        self._on_request(future)
+        future.send_request()
+        return future
+
+    def execute_graph(self, query, parameters=None, trace=False, execution_profile=EXEC_PROFILE_GRAPH_DEFAULT, execute_as=None):
+        """
+        Executes a Gremlin query string or GraphStatement synchronously,
+        and returns a ResultSet from this execution.
+
+        `parameters` is dict of named parameters to bind. The values must be
+        JSON-serializable.
+
+        `execution_profile`: Selects an execution profile for the request.
+
+        `execute_as` the user that will be used on the server to execute the request.
+        """
+        return self.execute_graph_async(query, parameters, trace, execution_profile, execute_as).result()
+
+    def execute_graph_async(self, query, parameters=None, trace=False, execution_profile=EXEC_PROFILE_GRAPH_DEFAULT, execute_as=None):
+        """
+        Execute the graph query and return a :class:`ResponseFuture`
+        object which callbacks may be attached to for asynchronous response delivery. You may also call ``ResponseFuture.result()`` to synchronously block for
+        results at any time.
+        """
+        if self.cluster._config_mode is _ConfigMode.LEGACY:
+            raise ValueError(("Cannot execute graph queries using Cluster legacy parameters. "
+                              "Consider using Execution profiles: "
+                              "https://docs.datastax.com/en/developer/python-driver/latest/execution_profiles/#execution-profiles"))
+
+        if not isinstance(query, GraphStatement):
+            query = SimpleGraphStatement(query)
+
+        # Clone and look up instance here so we can resolve and apply the extended attributes
+        execution_profile = self.execution_profile_clone_update(execution_profile)
+
+        if not hasattr(execution_profile, 'graph_options'):
+            raise ValueError(
+                "Execution profile for graph queries must derive from GraphExecutionProfile, and provide graph_options")
+
+        self._resolve_execution_profile_options(execution_profile)
+
+        # make sure the graphson context row factory is binded to this cluster
+        try:
+            if issubclass(execution_profile.row_factory, _GraphSONContextRowFactory):
+                execution_profile.row_factory = execution_profile.row_factory(self.cluster)
+        except TypeError:
+            # issubclass might fail if arg1 is an instance
+            pass
+
+            # set graph paging if needed
+        self._maybe_set_graph_paging(execution_profile)
+
+        graph_parameters = None
+        if parameters:
+            graph_parameters = self._transform_params(parameters, graph_options=execution_profile.graph_options)
+
+        custom_payload = execution_profile.graph_options.get_options_map()
+        if execute_as:
+            custom_payload[_proxy_execute_key] = execute_as.encode()
+        custom_payload[_request_timeout_key] = int64_pack(int(execution_profile.request_timeout * 1000))
+
+        future = self._create_response_future(query, parameters=None, trace=trace, custom_payload=custom_payload,
+                                              timeout=_NOT_SET, execution_profile=execution_profile)
+
+        future.message.query_params = graph_parameters
+        future._protocol_handler = self.client_protocol_handler
+
+        if execution_profile.graph_options.is_analytics_source and \
+                isinstance(execution_profile.load_balancing_policy, DefaultLoadBalancingPolicy):
+            self._target_analytics_master(future)
+        else:
+            future.send_request()
+        return future
+
+    def _maybe_set_graph_paging(self, execution_profile):
+        graph_paging = execution_profile.continuous_paging_options
+        if execution_profile.continuous_paging_options is _NOT_SET:
+            graph_paging = ContinuousPagingOptions() if self._graph_paging_available else None
+
+        execution_profile.continuous_paging_options = graph_paging
+
+    def _check_graph_paging_available(self):
+        """Verify if we can enable graph paging. This executed only once when the session is created."""
+
+        if not ProtocolVersion.has_continuous_paging_next_pages(self._protocol_version):
+            return False
+
+        for host in self.cluster.metadata.all_hosts():
+            if host.dse_version is None:
+                return False
+
+            version = Version(host.dse_version)
+            if version < _GRAPH_PAGING_MIN_DSE_VERSION:
+                return False
+
+        return True
+
+    def _resolve_execution_profile_options(self, execution_profile):
+        """
+        Determine the GraphSON protocol and row factory for a graph query. This is useful
+        to configure automatically the execution profile when executing a query on a
+        core graph.
+
+        If `graph_protocol` is not explicitly specified, the following rules apply:
+        - Default to GraphProtocol.GRAPHSON_1_0, or GRAPHSON_2_0 if the `graph_language` is not gremlin-groovy.
+        - If `graph_options.graph_name` is specified and is a Core graph, set GraphSON_3_0.
+        If `row_factory` is not explicitly specified, the following rules apply:
+        - Default to graph_object_row_factory.
+        - If `graph_options.graph_name` is specified and is a Core graph, set graph_graphson3_row_factory.
+        """
+        if execution_profile.graph_options.graph_protocol is not None and \
+                execution_profile.row_factory is not None:
+            return
+
+        graph_options = execution_profile.graph_options
+
+        is_core_graph = False
+        if graph_options.graph_name:
+            # graph_options.graph_name is bytes ...
+            name = graph_options.graph_name.decode('utf-8')
+            if name in self.cluster.metadata.keyspaces:
+                ks_metadata = self.cluster.metadata.keyspaces[name]
+                if ks_metadata.graph_engine == 'Core':
+                    is_core_graph = True
+
+        if is_core_graph:
+            graph_protocol = GraphProtocol.GRAPHSON_3_0
+            row_factory = graph_graphson3_row_factory
+        else:
+            if graph_options.graph_language == GraphOptions.DEFAULT_GRAPH_LANGUAGE:
+                graph_protocol = GraphOptions.DEFAULT_GRAPH_PROTOCOL
+                row_factory = graph_object_row_factory
+            else:
+                # if not gremlin-groovy, GraphSON_2_0
+                graph_protocol = GraphProtocol.GRAPHSON_2_0
+                row_factory = graph_graphson2_row_factory
+
+        # Only apply if not set explicitly
+        if graph_options.graph_protocol is None:
+            graph_options.graph_protocol = graph_protocol
+        if execution_profile.row_factory is None:
+            execution_profile.row_factory = row_factory
+
+    def _transform_params(self, parameters, graph_options):
+        if not isinstance(parameters, dict):
+            raise ValueError('The parameters must be a dictionary. Unnamed parameters are not allowed.')
+
+        # Serialize python types to graphson
+        serializer = GraphSON1Serializer
+        if graph_options.graph_protocol == GraphProtocol.GRAPHSON_2_0:
+            serializer = GraphSON2Serializer()
+        elif graph_options.graph_protocol == GraphProtocol.GRAPHSON_3_0:
+            # only required for core graphs
+            context = {
+                'cluster': self.cluster,
+                'graph_name': graph_options.graph_name.decode('utf-8') if graph_options.graph_name else None
+            }
+            serializer = GraphSON3Serializer(context)
+
+        serialized_parameters = serializer.serialize(parameters)
+        return [json.dumps(serialized_parameters).encode('utf-8')]
+
+    def _target_analytics_master(self, future):
+        future._start_timer()
+        master_query_future = self._create_response_future("CALL DseClientTool.getAnalyticsGraphServer()",
+                                                           parameters=None, trace=False,
+                                                           custom_payload=None, timeout=future.timeout)
+        master_query_future.row_factory = tuple_factory
+        master_query_future.send_request()
+
+        cb = self._on_analytics_master_result
+        args = (master_query_future, future)
+        master_query_future.add_callbacks(callback=cb, callback_args=args, errback=cb, errback_args=args)
+
+    def _on_analytics_master_result(self, response, master_future, query_future):
+        try:
+            row = master_future.result()[0]
+            addr = row[0]['location']
+            delimiter_index = addr.rfind(':')  # assumes <ip>:<port> - not robust, but that's what is being provided
+            if delimiter_index > 0:
+                addr = addr[:delimiter_index]
+            targeted_query = HostTargetingStatement(query_future.query, addr)
+            query_future.query_plan = query_future._load_balancer.make_query_plan(self.keyspace, targeted_query)
+        except Exception:
+            log.debug("Failed querying analytics master (request might not be routed optimally). "
+                      "Make sure the session is connecting to a graph analytics datacenter.", exc_info=True)
+
+        self.submit(query_future.send_request)
+
+    def _create_response_future(self, query, parameters, trace, custom_payload,
+                                timeout, execution_profile=EXEC_PROFILE_DEFAULT,
+                                paging_state=None, host=None):
+        """ Returns the ResponseFuture before calling send_request() on it """
+
+        prepared_statement = None
+
+        if isinstance(query, str):
+            query = SimpleStatement(query)
+        elif isinstance(query, PreparedStatement):
+            query = query.bind(parameters)
+
+        if self.cluster._config_mode == _ConfigMode.LEGACY:
+            if execution_profile is not EXEC_PROFILE_DEFAULT:
+                raise ValueError("Cannot specify execution_profile while using legacy parameters.")
+
+            if timeout is _NOT_SET:
+                timeout = self.default_timeout
+
+            cl = query.consistency_level if query.consistency_level is not None else self.default_consistency_level
+            serial_cl = query.serial_consistency_level if query.serial_consistency_level is not None else self.default_serial_consistency_level
+
+            retry_policy = query.retry_policy or self.cluster.default_retry_policy
+            row_factory = self.row_factory
+            load_balancing_policy = self.cluster.load_balancing_policy
+            spec_exec_policy = None
+            continuous_paging_options = None
+        else:
+            execution_profile = self._maybe_get_execution_profile(execution_profile)
+
+            if timeout is _NOT_SET:
+                timeout = execution_profile.request_timeout
+
+            cl = query.consistency_level if query.consistency_level is not None else execution_profile.consistency_level
+            serial_cl = query.serial_consistency_level if query.serial_consistency_level is not None else execution_profile.serial_consistency_level
+            continuous_paging_options = execution_profile.continuous_paging_options
+
+            retry_policy = query.retry_policy or execution_profile.retry_policy
+            row_factory = execution_profile.row_factory
+            load_balancing_policy = execution_profile.load_balancing_policy
+            spec_exec_policy = execution_profile.speculative_execution_policy
+
+        fetch_size = query.fetch_size
+        if fetch_size is FETCH_SIZE_UNSET and self._protocol_version >= 2:
+            fetch_size = self.default_fetch_size
+        elif self._protocol_version == 1:
+            fetch_size = None
+
+        start_time = time.time()
+        if self._protocol_version >= 3 and self.use_client_timestamp:
+            timestamp = self.cluster.timestamp_generator()
+        else:
+            timestamp = None
+
+        supports_continuous_paging_state = (
+            ProtocolVersion.has_continuous_paging_next_pages(self._protocol_version)
+        )
+        if continuous_paging_options and supports_continuous_paging_state:
+            continuous_paging_state = ContinuousPagingState(continuous_paging_options.max_queue_size)
+        else:
+            continuous_paging_state = None
+
+        if isinstance(query, SimpleStatement):
+            query_string = query.query_string
+            statement_keyspace = query.keyspace if ProtocolVersion.uses_keyspace_flag(self._protocol_version) else None
+            if parameters:
+                query_string = bind_params(query_string, parameters, self.encoder)
+            message = QueryMessage(
+                query_string, cl, serial_cl,
+                fetch_size, paging_state, timestamp,
+                continuous_paging_options, statement_keyspace)
+        elif isinstance(query, BoundStatement):
+            prepared_statement = query.prepared_statement
+            message = ExecuteMessage(
+                prepared_statement.query_id, query.values, cl,
+                serial_cl, fetch_size, paging_state, timestamp,
+                skip_meta=bool(prepared_statement.result_metadata),
+                continuous_paging_options=continuous_paging_options,
+                result_metadata_id=prepared_statement.result_metadata_id)
+        elif isinstance(query, BatchStatement):
+            if self._protocol_version < 2:
+                raise UnsupportedOperation(
+                    "BatchStatement execution is only supported with protocol version "
+                    "2 or higher (supported in Cassandra 2.0 and higher).  Consider "
+                    "setting Cluster.protocol_version to 2 to support this operation.")
+            statement_keyspace = query.keyspace if ProtocolVersion.uses_keyspace_flag(self._protocol_version) else None
+            message = BatchMessage(
+                query.batch_type, query._statements_and_parameters, cl,
+                serial_cl, timestamp, statement_keyspace)
+        elif isinstance(query, GraphStatement):
+            # the statement_keyspace is not aplicable to GraphStatement
+            message = QueryMessage(query.query, cl, serial_cl, fetch_size,
+                                   paging_state, timestamp,
+                                   continuous_paging_options)
+
+        message.tracing = trace
+        message.update_custom_payload(query.custom_payload)
+        message.update_custom_payload(custom_payload)
+        message.allow_beta_protocol_version = self.cluster.allow_beta_protocol_version
+
+        spec_exec_plan = spec_exec_policy.new_plan(query.keyspace or self.keyspace, query) if query.is_idempotent and spec_exec_policy else None
+        return ResponseFuture(
+            self, message, query, timeout, metrics=self._metrics,
+            prepared_statement=prepared_statement, retry_policy=retry_policy, row_factory=row_factory,
+            load_balancer=load_balancing_policy, start_time=start_time, speculative_execution_plan=spec_exec_plan,
+            continuous_paging_state=continuous_paging_state, host=host)
+
+    def get_execution_profile(self, name):
+        """
+        Returns the execution profile associated with the provided ``name``.
+
+        :param name: The name (or key) of the execution profile.
+        """
+        profiles = self.cluster.profile_manager.profiles
+        try:
+            return profiles[name]
+        except KeyError:
+            eps = [_execution_profile_to_string(ep) for ep in profiles.keys()]
+            raise ValueError("Invalid execution_profile: %s; valid profiles are: %s." % (
+                _execution_profile_to_string(name), ', '.join(eps)))
+
+    def _maybe_get_execution_profile(self, ep):
+        return ep if isinstance(ep, ExecutionProfile) else self.get_execution_profile(ep)
+
+    def execution_profile_clone_update(self, ep, **kwargs):
+        """
+        Returns a clone of the ``ep`` profile.  ``kwargs`` can be specified to update attributes
+        of the returned profile.
+
+        This is a shallow clone, so any objects referenced by the profile are shared. This means Load Balancing Policy
+        is maintained by inclusion in the active profiles. It also means updating any other rich objects will be seen
+        by the active profile. In cases where this is not desirable, be sure to replace the instance instead of manipulating
+        the shared object.
+        """
+        clone = copy(self._maybe_get_execution_profile(ep))
+        for attr, value in kwargs.items():
+            setattr(clone, attr, value)
+        return clone
+
+    def add_request_init_listener(self, fn, *args, **kwargs):
+        """
+        Adds a callback with arguments to be called when any request is created.
+
+        It will be invoked as `fn(response_future, *args, **kwargs)` after each client request is created,
+        and before the request is sent. This can be used to create extensions by adding result callbacks to the
+        response future.
+
+        `response_future` is the :class:`.ResponseFuture` for the request.
+
+        Note that the init callback is done on the client thread creating the request, so you may need to consider
+        synchronization if you have multiple threads. Any callbacks added to the response future will be executed
+        on the event loop thread, so the normal advice about minimizing cycles and avoiding blocking apply (see Note in
+        :meth:`.ResponseFuture.add_callbacks`.
+
+        See `this example <https://github.com/datastax/python-driver/blob/master/examples/request_init_listener.py>`_ in the
+        source tree for an example.
+        """
+        self._request_init_callbacks.append((fn, args, kwargs))
+
+    def remove_request_init_listener(self, fn, *args, **kwargs):
+        """
+        Removes a callback and arguments from the list.
+
+        See :meth:`.Session.add_request_init_listener`.
+        """
+        self._request_init_callbacks.remove((fn, args, kwargs))
+
+    def _on_request(self, response_future):
+        for fn, args, kwargs in self._request_init_callbacks:
+            fn(response_future, *args, **kwargs)
+
+    def prepare(self, query, custom_payload=None, keyspace=None):
+        """
+        Prepares a query string, returning a :class:`~cassandra.query.PreparedStatement`
+        instance which can be used as follows::
+
+            >>> session = cluster.connect("mykeyspace")
+            >>> query = "INSERT INTO users (id, name, age) VALUES (?, ?, ?)"
+            >>> prepared = session.prepare(query)
+            >>> session.execute(prepared, (user.id, user.name, user.age))
+
+        Or you may bind values to the prepared statement ahead of time::
+
+            >>> prepared = session.prepare(query)
+            >>> bound_stmt = prepared.bind((user.id, user.name, user.age))
+            >>> session.execute(bound_stmt)
+
+        Of course, prepared statements may (and should) be reused::
+
+            >>> prepared = session.prepare(query)
+            >>> for user in users:
+            ...     bound = prepared.bind((user.id, user.name, user.age))
+            ...     session.execute(bound)
+
+        Alternatively, if :attr:`~.Cluster.protocol_version` is 5 or higher
+        (requires Cassandra 4.0+), the keyspace can be specified as a
+        parameter. This will allow you to avoid specifying the keyspace in the
+        query without specifying a keyspace in :meth:`~.Cluster.connect`. It
+        even will let you prepare and use statements against a keyspace other
+        than the one originally specified on connection:
+
+            >>> analyticskeyspace_prepared = session.prepare(
+            ...     "INSERT INTO user_activity id, last_activity VALUES (?, ?)",
+            ...     keyspace="analyticskeyspace")  # note the different keyspace
+
+        **Important**: PreparedStatements should be prepared only once.
+        Preparing the same query more than once will likely affect performance.
+
+        `custom_payload` is a key value map to be passed along with the prepare
+        message. See :ref:`custom_payload`.
+        """
+        message = PrepareMessage(query=query, keyspace=keyspace)
+        future = ResponseFuture(self, message, query=None, timeout=self.default_timeout)
+        try:
+            future.send_request()
+            response = future.result().one()
+        except Exception:
+            log.exception("Error preparing query:")
+            raise
+
+        prepared_keyspace = keyspace if keyspace else None
+        prepared_statement = PreparedStatement.from_message(
+            response.query_id, response.bind_metadata, response.pk_indexes, self.cluster.metadata, query, prepared_keyspace,
+            self._protocol_version, response.column_metadata, response.result_metadata_id, self.cluster.column_encryption_policy)
+        prepared_statement.custom_payload = future.custom_payload
+
+        self.cluster.add_prepared(response.query_id, prepared_statement)
+
+        if self.cluster.prepare_on_all_hosts:
+            host = future._current_host
+            try:
+                self.prepare_on_all_hosts(prepared_statement.query_string, host, prepared_keyspace)
+            except Exception:
+                log.exception("Error preparing query on all hosts:")
+
+        return prepared_statement
+
+    def prepare_on_all_hosts(self, query, excluded_host, keyspace=None):
+        """
+        Prepare the given query on all hosts, excluding ``excluded_host``.
+        Intended for internal use only.
+        """
+        futures = []
+        for host in tuple(self._pools.keys()):
+            if host != excluded_host and host.is_up:
+                future = ResponseFuture(self, PrepareMessage(query=query, keyspace=keyspace),
+                                            None, self.default_timeout)
+
+                # we don't care about errors preparing against specific hosts,
+                # since we can always prepare them as needed when the prepared
+                # statement is used.  Just log errors and continue on.
+                try:
+                    request_id = future._query(host)
+                except Exception:
+                    log.exception("Error preparing query for host %s:", host)
+                    continue
+
+                if request_id is None:
+                    # the error has already been logged by ResponsFuture
+                    log.debug("Failed to prepare query for host %s: %r",
+                              host, future._errors.get(host))
+                    continue
+
+                futures.append((host, future))
+
+        for host, future in futures:
+            try:
+                future.result()
+            except Exception:
+                log.exception("Error preparing query for host %s:", host)
+
+    def shutdown(self):
+        """
+        Close all connections.  ``Session`` instances should not be used
+        for any purpose after being shutdown.
+        """
+        with self._lock:
+            if self.is_shutdown:
+                return
+            else:
+                self.is_shutdown = True
+
+        # PYTHON-673. If shutdown was called shortly after session init, avoid
+        # a race by cancelling any initial connection attempts haven't started,
+        # then blocking on any that have.
+        for future in self._initial_connect_futures:
+            future.cancel()
+        wait_futures(self._initial_connect_futures)
+
+        if self._monitor_reporter:
+            self._monitor_reporter.stop()
+
+        for pool in tuple(self._pools.values()):
+            pool.shutdown()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.shutdown()
+
+    def __del__(self):
+        try:
+            # Ensure all connections are closed, in case the Session object is deleted by the GC
+            self.shutdown()
+        except:
+            # Ignore all errors. Shutdown errors can be caught by the user
+            # when cluster.shutdown() is called explicitly.
+            pass
+
+    def add_or_renew_pool(self, host, is_host_addition):
+        """
+        For internal use only.
+        """
+        distance = self._profile_manager.distance(host)
+        if distance == HostDistance.IGNORED:
+            return None
+
+        def run_add_or_renew_pool():
+            try:
+                if self._protocol_version >= 3:
+                    new_pool = HostConnection(host, distance, self)
+                else:
+                    # TODO remove host pool again ???
+                    new_pool = HostConnectionPool(host, distance, self)
+            except AuthenticationFailed as auth_exc:
+                conn_exc = ConnectionException(str(auth_exc), endpoint=host)
+                self.cluster.signal_connection_failure(host, conn_exc, is_host_addition)
+                return False
+            except Exception as conn_exc:
+                log.warning("Failed to create connection pool for new host %s:",
+                            host, exc_info=conn_exc)
+                # the host itself will still be marked down, so we need to pass
+                # a special flag to make sure the reconnector is created
+                self.cluster.signal_connection_failure(
+                    host, conn_exc, is_host_addition, expect_host_to_be_down=True)
+                return False
+
+            previous = self._pools.get(host)
+            with self._lock:
+                while new_pool._keyspace != self.keyspace:
+                    self._lock.release()
+                    set_keyspace_event = Event()
+                    errors_returned = []
+
+                    def callback(pool, errors):
+                        errors_returned.extend(errors)
+                        set_keyspace_event.set()
+
+                    new_pool._set_keyspace_for_all_conns(self.keyspace, callback)
+                    set_keyspace_event.wait(self.cluster.connect_timeout)
+                    if not set_keyspace_event.is_set() or errors_returned:
+                        log.warning("Failed setting keyspace for pool after keyspace changed during connect: %s", errors_returned)
+                        self.cluster.on_down(host, is_host_addition)
+                        new_pool.shutdown()
+                        self._lock.acquire()
+                        return False
+                    self._lock.acquire()
+                self._pools[host] = new_pool
+
+            log.debug("Added pool for host %s to session", host)
+            if previous:
+                previous.shutdown()
+
+            return True
+
+        return self.submit(run_add_or_renew_pool)
+
+    def remove_pool(self, host):
+        pool = self._pools.pop(host, None)
+        if pool:
+            log.debug("Removed connection pool for %r", host)
+            return self.submit(pool.shutdown)
+        else:
+            return None
+
+    def update_created_pools(self):
+        """
+        When the set of live nodes change, the loadbalancer will change its
+        mind on host distances. It might change it on the node that came/left
+        but also on other nodes (for instance, if a node dies, another
+        previously ignored node may be now considered).
+
+        This method ensures that all hosts for which a pool should exist
+        have one, and hosts that shouldn't don't.
+
+        For internal use only.
+        """
+        futures = set()
+        for host in self.cluster.metadata.all_hosts():
+            distance = self._profile_manager.distance(host)
+            pool = self._pools.get(host)
+            future = None
+            if not pool or pool.is_shutdown:
+                # we don't eagerly set is_up on previously ignored hosts. None is included here
+                # to allow us to attempt connections to hosts that have gone from ignored to something
+                # else.
+                if distance != HostDistance.IGNORED and host.is_up in (True, None):
+                    future = self.add_or_renew_pool(host, False)
+            elif distance != pool.host_distance:
+                # the distance has changed
+                if distance == HostDistance.IGNORED:
+                    future = self.remove_pool(host)
+                else:
+                    pool.host_distance = distance
+            if future:
+                futures.add(future)
+        return futures
+
+    def on_down(self, host):
+        """
+        Called by the parent Cluster instance when a node is marked down.
+        Only intended for internal use.
+        """
+        future = self.remove_pool(host)
+        if future:
+            future.add_done_callback(lambda f: self.update_created_pools())
+
+    def on_remove(self, host):
+        """ Internal """
+        self.on_down(host)
+
+    def set_keyspace(self, keyspace):
+        """
+        Set the default keyspace for all queries made through this Session.
+        This operation blocks until complete.
+        """
+        self.execute('USE %s' % (protect_name(keyspace),))
+
+    def _set_keyspace_for_all_pools(self, keyspace, callback):
+        """
+        Asynchronously sets the keyspace on all pools.  When all
+        pools have set all of their connections, `callback` will be
+        called with a dictionary of all errors that occurred, keyed
+        by the `Host` that they occurred against.
+        """
+        with self._lock:
+            self.keyspace = keyspace
+            remaining_callbacks = set(self._pools.values())
+        errors = {}
+
+        if not remaining_callbacks:
+            callback(errors)
+            return
+
+        def pool_finished_setting_keyspace(pool, host_errors):
+            remaining_callbacks.remove(pool)
+            if host_errors:
+                errors[pool.host] = host_errors
+
+            if not remaining_callbacks:
+                callback(host_errors)
+
+        for pool in tuple(self._pools.values()):
+            pool._set_keyspace_for_all_conns(keyspace, pool_finished_setting_keyspace)
+
+    def user_type_registered(self, keyspace, user_type, klass):
+        """
+        Called by the parent Cluster instance when the user registers a new
+        mapping from a user-defined type to a class.  Intended for internal
+        use only.
+        """
+        try:
+            ks_meta = self.cluster.metadata.keyspaces[keyspace]
+        except KeyError:
+            raise UserTypeDoesNotExist(
+                'Keyspace %s does not exist or has not been discovered by the driver' % (keyspace,))
+
+        try:
+            type_meta = ks_meta.user_types[user_type]
+        except KeyError:
+            raise UserTypeDoesNotExist(
+                'User type %s does not exist in keyspace %s' % (user_type, keyspace))
+
+        field_names = type_meta.field_names
+
+        def encode(val):
+            return '{ %s }' % ' , '.join('%s : %s' % (
+                field_name,
+                self.encoder.cql_encode_all_types(getattr(val, field_name, None))
+            ) for field_name in field_names)
+
+        self.encoder.mapping[klass] = encode
+
+    def submit(self, fn, *args, **kwargs):
+        """ Internal """
+        if not self.is_shutdown:
+            return self.cluster.executor.submit(fn, *args, **kwargs)
+
+    def get_pool_state(self):
+        return dict((host, pool.get_state()) for host, pool in tuple(self._pools.items()))
+
+    def get_pools(self):
+        return self._pools.values()
+
+    def _validate_set_legacy_config(self, attr_name, value):
+        if self.cluster._config_mode == _ConfigMode.PROFILES:
+            raise ValueError("Cannot set Session.%s while using Configuration Profiles. Set this in a profile instead." % (attr_name,))
+        setattr(self, '_' + attr_name, value)
+        self.cluster._config_mode = _ConfigMode.LEGACY
+
+
+class UserTypeDoesNotExist(Exception):
+    """
+    An attempt was made to use a user-defined type that does not exist.
+
+    .. versionadded:: 2.1.0
+    """
+    pass
+
+
+class _ControlReconnectionHandler(_ReconnectionHandler):
+    """
+    Internal
+    """
+
+    def __init__(self, control_connection, *args, **kwargs):
+        _ReconnectionHandler.__init__(self, *args, **kwargs)
+        self.control_connection = weakref.proxy(control_connection)
+
+    def try_reconnect(self):
+        return self.control_connection._reconnect_internal()
+
+    def on_reconnection(self, connection):
+        self.control_connection._set_new_connection(connection)
+
+    def on_exception(self, exc, next_delay):
+        # TODO only overridden to add logging, so add logging
+        if isinstance(exc, AuthenticationFailed):
+            return False
+        else:
+            log.debug("Error trying to reconnect control connection: %r", exc)
+            return True
+
+
+def _watch_callback(obj_weakref, method_name, *args, **kwargs):
+    """
+    A callback handler for the ControlConnection that tolerates
+    weak references.
+    """
+    obj = obj_weakref()
+    if obj is None:
+        return
+    getattr(obj, method_name)(*args, **kwargs)
+
+
+def _clear_watcher(conn, expiring_weakref):
+    """
+    Called when the ControlConnection object is about to be finalized.
+    This clears watchers on the underlying Connection object.
+    """
+    try:
+        conn.control_conn_disposed()
+    except ReferenceError:
+        pass
+
+
+class ControlConnection(object):
+    """
+    Internal
+    """
+
+    _SELECT_PEERS = "SELECT * FROM system.peers"
+    _SELECT_PEERS_NO_TOKENS_TEMPLATE = "SELECT host_id, peer, data_center, rack, rpc_address, {nt_col_name}, release_version, schema_version FROM system.peers"
+    _SELECT_LOCAL = "SELECT * FROM system.local WHERE key='local'"
+    _SELECT_LOCAL_NO_TOKENS = "SELECT host_id, cluster_name, data_center, rack, partitioner, release_version, schema_version FROM system.local WHERE key='local'"
+    # Used only when token_metadata_enabled is set to False
+    _SELECT_LOCAL_NO_TOKENS_RPC_ADDRESS = "SELECT rpc_address FROM system.local WHERE key='local'"
+
+    _SELECT_SCHEMA_PEERS_TEMPLATE = "SELECT peer, host_id, {nt_col_name}, schema_version FROM system.peers"
+    _SELECT_SCHEMA_LOCAL = "SELECT schema_version FROM system.local WHERE key='local'"
+
+    _SELECT_PEERS_V2 = "SELECT * FROM system.peers_v2"
+    _SELECT_PEERS_NO_TOKENS_V2 = "SELECT host_id, peer, peer_port, data_center, rack, native_address, native_port, release_version, schema_version FROM system.peers_v2"
+    _SELECT_SCHEMA_PEERS_V2 = "SELECT host_id, peer, peer_port, native_address, native_port, schema_version FROM system.peers_v2"
+
+    _MINIMUM_NATIVE_ADDRESS_DSE_VERSION = Version("6.0.0")
+
+    class PeersQueryType(object):
+        """internal Enum for _peers_query"""
+        PEERS = 0
+        PEERS_SCHEMA = 1
+
+    _is_shutdown = False
+    _timeout = None
+    _protocol_version = None
+
+    _schema_event_refresh_window = None
+    _topology_event_refresh_window = None
+    _status_event_refresh_window = None
+
+    _schema_meta_enabled = True
+    _token_meta_enabled = True
+
+    _uses_peers_v2 = True
+
+    # for testing purposes
+    _time = time
+
+    def __init__(self, cluster, timeout,
+                 schema_event_refresh_window,
+                 topology_event_refresh_window,
+                 status_event_refresh_window,
+                 schema_meta_enabled=True,
+                 token_meta_enabled=True):
+        # use a weak reference to allow the Cluster instance to be GC'ed (and
+        # shutdown) since implementing __del__ disables the cycle detector
+        self._cluster = weakref.proxy(cluster)
+        self._connection = None
+        self._timeout = timeout
+
+        self._schema_event_refresh_window = schema_event_refresh_window
+        self._topology_event_refresh_window = topology_event_refresh_window
+        self._status_event_refresh_window = status_event_refresh_window
+        self._schema_meta_enabled = schema_meta_enabled
+        self._token_meta_enabled = token_meta_enabled
+
+        self._lock = RLock()
+        self._schema_agreement_lock = Lock()
+
+        self._reconnection_handler = None
+        self._reconnection_lock = RLock()
+
+        self._event_schedule_times = {}
+
+    def connect(self):
+        if self._is_shutdown:
+            return
+
+        self._protocol_version = self._cluster.protocol_version
+        self._set_new_connection(self._reconnect_internal())
+
+        self._cluster.metadata.dbaas = self._connection._product_type == dscloud.DATASTAX_CLOUD_PRODUCT_TYPE
+
+    def _set_new_connection(self, conn):
+        """
+        Replace existing connection (if there is one) and close it.
+        """
+        with self._lock:
+            old = self._connection
+            self._connection = conn
+
+        if old:
+            log.debug("[control connection] Closing old connection %r, replacing with %r", old, conn)
+            old.close()
+
+    def _reconnect_internal(self):
+        """
+        Tries to connect to each host in the query plan until one succeeds
+        or every attempt fails. If successful, a new Connection will be
+        returned.  Otherwise, :exc:`NoHostAvailable` will be raised
+        with an "errors" arg that is a dict mapping host addresses
+        to the exception that was raised when an attempt was made to open
+        a connection to that host.
+        """
+        errors = {}
+        lbp = (
+            self._cluster.load_balancing_policy
+            if self._cluster._config_mode == _ConfigMode.LEGACY else
+            self._cluster._default_load_balancing_policy
+        )
+
+        for host in lbp.make_query_plan():
+            try:
+                return self._try_connect(host)
+            except ConnectionException as exc:
+                errors[str(host.endpoint)] = exc
+                log.warning("[control connection] Error connecting to %s:", host, exc_info=True)
+                self._cluster.signal_connection_failure(host, exc, is_host_addition=False)
+            except Exception as exc:
+                errors[str(host.endpoint)] = exc
+                log.warning("[control connection] Error connecting to %s:", host, exc_info=True)
+            if self._is_shutdown:
+                raise DriverException("[control connection] Reconnection in progress during shutdown")
+
+        raise NoHostAvailable("Unable to connect to any servers", errors)
+
+    def _try_connect(self, host):
+        """
+        Creates a new Connection, registers for pushed events, and refreshes
+        node/token and schema metadata.
+        """
+        log.debug("[control connection] Opening new connection to %s", host)
+
+        while True:
+            try:
+                connection = self._cluster.connection_factory(host.endpoint, is_control_connection=True)
+                if self._is_shutdown:
+                    connection.close()
+                    raise DriverException("Reconnecting during shutdown")
+                break
+            except ProtocolVersionUnsupported as e:
+                self._cluster.protocol_downgrade(host.endpoint, e.startup_version)
+            except ProtocolException as e:
+                # protocol v5 is out of beta in C* >=4.0-beta5 and is now the default driver
+                # protocol version. If the protocol version was not explicitly specified,
+                # and that the server raises a beta protocol error, we should downgrade.
+                if not self._cluster._protocol_version_explicit and e.is_beta_protocol_error:
+                    self._cluster.protocol_downgrade(host.endpoint, self._cluster.protocol_version)
+                else:
+                    raise
+
+        log.debug("[control connection] Established new connection %r, "
+                  "registering watchers and refreshing schema and topology",
+                  connection)
+
+        # use weak references in both directions
+        # _clear_watcher will be called when this ControlConnection is about to be finalized
+        # _watch_callback will get the actual callback from the Connection and relay it to
+        # this object (after a dereferencing a weakref)
+        self_weakref = weakref.ref(self, partial(_clear_watcher, weakref.proxy(connection)))
+        try:
+            connection.register_watchers({
+                "TOPOLOGY_CHANGE": partial(_watch_callback, self_weakref, '_handle_topology_change'),
+                "STATUS_CHANGE": partial(_watch_callback, self_weakref, '_handle_status_change'),
+                "SCHEMA_CHANGE": partial(_watch_callback, self_weakref, '_handle_schema_change')
+            }, register_timeout=self._timeout)
+
+            sel_peers = self._get_peers_query(self.PeersQueryType.PEERS, connection)
+            sel_local = self._SELECT_LOCAL if self._token_meta_enabled else self._SELECT_LOCAL_NO_TOKENS
+            peers_query = QueryMessage(query=sel_peers, consistency_level=ConsistencyLevel.ONE)
+            local_query = QueryMessage(query=sel_local, consistency_level=ConsistencyLevel.ONE)
+            (peers_success, peers_result), (local_success, local_result) = connection.wait_for_responses(
+                peers_query, local_query, timeout=self._timeout, fail_on_error=False)
+
+            if not local_success:
+                raise local_result
+
+            if not peers_success:
+                # error with the peers v2 query, fallback to peers v1
+                self._uses_peers_v2 = False
+                sel_peers = self._get_peers_query(self.PeersQueryType.PEERS, connection)
+                peers_query = QueryMessage(query=sel_peers, consistency_level=ConsistencyLevel.ONE)
+                peers_result = connection.wait_for_response(
+                    peers_query, timeout=self._timeout)
+
+            shared_results = (peers_result, local_result)
+            self._refresh_node_list_and_token_map(connection, preloaded_results=shared_results)
+            self._refresh_schema(connection, preloaded_results=shared_results, schema_agreement_wait=-1)
+        except Exception:
+            connection.close()
+            raise
+
+        return connection
+
+    def reconnect(self):
+        if self._is_shutdown:
+            return
+
+        self._submit(self._reconnect)
+
+    def _reconnect(self):
+        log.debug("[control connection] Attempting to reconnect")
+        try:
+            self._set_new_connection(self._reconnect_internal())
+        except NoHostAvailable:
+            # make a retry schedule (which includes backoff)
+            schedule = self._cluster.reconnection_policy.new_schedule()
+
+            with self._reconnection_lock:
+
+                # cancel existing reconnection attempts
+                if self._reconnection_handler:
+                    self._reconnection_handler.cancel()
+
+                # when a connection is successfully made, _set_new_connection
+                # will be called with the new connection and then our
+                # _reconnection_handler will be cleared out
+                self._reconnection_handler = _ControlReconnectionHandler(
+                    self, self._cluster.scheduler, schedule,
+                    self._get_and_set_reconnection_handler,
+                    new_handler=None)
+                self._reconnection_handler.start()
+        except Exception:
+            log.debug("[control connection] error reconnecting", exc_info=True)
+            raise
+
+    def _get_and_set_reconnection_handler(self, new_handler):
+        """
+        Called by the _ControlReconnectionHandler when a new connection
+        is successfully created.  Clears out the _reconnection_handler on
+        this ControlConnection.
+        """
+        with self._reconnection_lock:
+            old = self._reconnection_handler
+            self._reconnection_handler = new_handler
+            return old
+
+    def _submit(self, *args, **kwargs):
+        try:
+            if not self._cluster.is_shutdown:
+                return self._cluster.executor.submit(*args, **kwargs)
+        except ReferenceError:
+            pass
+        return None
+
+    def shutdown(self):
+        # stop trying to reconnect (if we are)
+        with self._reconnection_lock:
+            if self._reconnection_handler:
+                self._reconnection_handler.cancel()
+
+        with self._lock:
+            if self._is_shutdown:
+                return
+            else:
+                self._is_shutdown = True
+
+            log.debug("Shutting down control connection")
+            if self._connection:
+                self._connection.close()
+                self._connection = None
+
+    def refresh_schema(self, force=False, **kwargs):
+        try:
+            if self._connection:
+                return self._refresh_schema(self._connection, force=force, **kwargs)
+        except ReferenceError:
+            pass  # our weak reference to the Cluster is no good
+        except Exception:
+            log.debug("[control connection] Error refreshing schema", exc_info=True)
+            self._signal_error()
+        return False
+
+    def _refresh_schema(self, connection, preloaded_results=None, schema_agreement_wait=None, force=False, **kwargs):
+        if self._cluster.is_shutdown:
+            return False
+
+        agreed = self.wait_for_schema_agreement(connection,
+                                                preloaded_results=preloaded_results,
+                                                wait_time=schema_agreement_wait)
+
+        if not self._schema_meta_enabled and not force:
+            log.debug("[control connection] Skipping schema refresh because schema metadata is disabled")
+            return False
+
+        if not agreed:
+            log.debug("Skipping schema refresh due to lack of schema agreement")
+            return False
+
+        self._cluster.metadata.refresh(connection, self._timeout, **kwargs)
+
+        return True
+
+    def refresh_node_list_and_token_map(self, force_token_rebuild=False):
+        try:
+            if self._connection:
+                self._refresh_node_list_and_token_map(self._connection, force_token_rebuild=force_token_rebuild)
+                return True
+        except ReferenceError:
+            pass  # our weak reference to the Cluster is no good
+        except Exception:
+            log.debug("[control connection] Error refreshing node list and token map", exc_info=True)
+            self._signal_error()
+        return False
+
+    def _refresh_node_list_and_token_map(self, connection, preloaded_results=None,
+                                         force_token_rebuild=False):
+        if preloaded_results:
+            log.debug("[control connection] Refreshing node list and token map using preloaded results")
+            peers_result = preloaded_results[0]
+            local_result = preloaded_results[1]
+        else:
+            cl = ConsistencyLevel.ONE
+            sel_peers = self._get_peers_query(self.PeersQueryType.PEERS, connection)
+            if not self._token_meta_enabled:
+                log.debug("[control connection] Refreshing node list without token map")
+                sel_local = self._SELECT_LOCAL_NO_TOKENS
+            else:
+                log.debug("[control connection] Refreshing node list and token map")
+                sel_local = self._SELECT_LOCAL
+            peers_query = QueryMessage(query=sel_peers, consistency_level=cl)
+            local_query = QueryMessage(query=sel_local, consistency_level=cl)
+            peers_result, local_result = connection.wait_for_responses(
+                peers_query, local_query, timeout=self._timeout)
+
+        peers_result = dict_factory(peers_result.column_names, peers_result.parsed_rows)
+
+        partitioner = None
+        token_map = {}
+
+        found_hosts = set()
+        if local_result.parsed_rows:
+            found_hosts.add(connection.endpoint)
+            local_rows = dict_factory(local_result.column_names, local_result.parsed_rows)
+            local_row = local_rows[0]
+            cluster_name = local_row["cluster_name"]
+            self._cluster.metadata.cluster_name = cluster_name
+
+            partitioner = local_row.get("partitioner")
+            tokens = local_row.get("tokens")
+
+            host = self._cluster.metadata.get_host(connection.endpoint)
+            if host:
+                datacenter = local_row.get("data_center")
+                rack = local_row.get("rack")
+                self._update_location_info(host, datacenter, rack)
+                host.host_id = local_row.get("host_id")
+                host.listen_address = local_row.get("listen_address")
+                host.listen_port = local_row.get("listen_port")
+                host.broadcast_address = _NodeInfo.get_broadcast_address(local_row)
+                host.broadcast_port = _NodeInfo.get_broadcast_port(local_row)
+
+                host.broadcast_rpc_address = _NodeInfo.get_broadcast_rpc_address(local_row)
+                host.broadcast_rpc_port = _NodeInfo.get_broadcast_rpc_port(local_row)
+                if host.broadcast_rpc_address is None:
+                    if self._token_meta_enabled:
+                        # local rpc_address is not available, use the connection endpoint
+                        host.broadcast_rpc_address = connection.endpoint.address
+                        host.broadcast_rpc_port = connection.endpoint.port
+                    else:
+                        # local rpc_address has not been queried yet, try to fetch it
+                        # separately, which might fail because C* < 2.1.6 doesn't have rpc_address
+                        # in system.local. See CASSANDRA-9436.
+                        local_rpc_address_query = QueryMessage(query=self._SELECT_LOCAL_NO_TOKENS_RPC_ADDRESS,
+                                                               consistency_level=ConsistencyLevel.ONE)
+                        success, local_rpc_address_result = connection.wait_for_response(
+                            local_rpc_address_query, timeout=self._timeout, fail_on_error=False)
+                        if success:
+                            row = dict_factory(
+                                local_rpc_address_result.column_names,
+                                local_rpc_address_result.parsed_rows)
+                            host.broadcast_rpc_address = _NodeInfo.get_broadcast_rpc_address(row[0])
+                            host.broadcast_rpc_port = _NodeInfo.get_broadcast_rpc_port(row[0])
+                        else:
+                            host.broadcast_rpc_address = connection.endpoint.address
+                            host.broadcast_rpc_port = connection.endpoint.port
+
+                host.release_version = local_row.get("release_version")
+                host.dse_version = local_row.get("dse_version")
+                host.dse_workload = local_row.get("workload")
+                host.dse_workloads = local_row.get("workloads")
+
+                if partitioner and tokens:
+                    token_map[host] = tokens
+
+        # Check metadata.partitioner to see if we haven't built anything yet. If
+        # every node in the cluster was in the contact points, we won't discover
+        # any new nodes, so we need this additional check.  (See PYTHON-90)
+        should_rebuild_token_map = force_token_rebuild or self._cluster.metadata.partitioner is None
+        for row in peers_result:
+            if not self._is_valid_peer(row):
+                log.warning(
+                    "Found an invalid row for peer (%s). Ignoring host." %
+                    _NodeInfo.get_broadcast_rpc_address(row))
+                continue
+
+            endpoint = self._cluster.endpoint_factory.create(row)
+
+            if endpoint in found_hosts:
+                log.warning("Found multiple hosts with the same endpoint (%s). Excluding peer %s", endpoint, row.get("peer"))
+                continue
+
+            found_hosts.add(endpoint)
+
+            host = self._cluster.metadata.get_host(endpoint)
+            datacenter = row.get("data_center")
+            rack = row.get("rack")
+            if host is None:
+                log.debug("[control connection] Found new host to connect to: %s", endpoint)
+                host, _ = self._cluster.add_host(endpoint, datacenter, rack, signal=True, refresh_nodes=False)
+                should_rebuild_token_map = True
+            else:
+                should_rebuild_token_map |= self._update_location_info(host, datacenter, rack)
+
+            host.host_id = row.get("host_id")
+            host.broadcast_address = _NodeInfo.get_broadcast_address(row)
+            host.broadcast_port = _NodeInfo.get_broadcast_port(row)
+            host.broadcast_rpc_address = _NodeInfo.get_broadcast_rpc_address(row)
+            host.broadcast_rpc_port = _NodeInfo.get_broadcast_rpc_port(row)
+            host.release_version = row.get("release_version")
+            host.dse_version = row.get("dse_version")
+            host.dse_workload = row.get("workload")
+            host.dse_workloads = row.get("workloads")
+
+            tokens = row.get("tokens", None)
+            if partitioner and tokens and self._token_meta_enabled:
+                token_map[host] = tokens
+
+        for old_host in self._cluster.metadata.all_hosts():
+            if old_host.endpoint.address != connection.endpoint and old_host.endpoint not in found_hosts:
+                should_rebuild_token_map = True
+                log.debug("[control connection] Removing host not found in peers metadata: %r", old_host)
+                self._cluster.remove_host(old_host)
+
+        log.debug("[control connection] Finished fetching ring info")
+        if partitioner and should_rebuild_token_map:
+            log.debug("[control connection] Rebuilding token map due to topology changes")
+            self._cluster.metadata.rebuild_token_map(partitioner, token_map)
+
+    @staticmethod
+    def _is_valid_peer(row):
+        return bool(_NodeInfo.get_broadcast_rpc_address(row) and row.get("host_id") and
+                    row.get("data_center") and row.get("rack") and
+                    ('tokens' not in row or row.get('tokens')))
+
+    def _update_location_info(self, host, datacenter, rack):
+        if host.datacenter == datacenter and host.rack == rack:
+            return False
+
+        # If the dc/rack information changes, we need to update the load balancing policy.
+        # For that, we remove and re-add the node against the policy. Not the most elegant, and assumes
+        # that the policy will update correctly, but in practice this should work.
+        self._cluster.profile_manager.on_down(host)
+        host.set_location_info(datacenter, rack)
+        self._cluster.profile_manager.on_up(host)
+        return True
+
+    def _delay_for_event_type(self, event_type, delay_window):
+        # this serves to order processing correlated events (received within the window)
+        # the window and randomization still have the desired effect of skew across client instances
+        next_time = self._event_schedule_times.get(event_type, 0)
+        now = self._time.time()
+        if now <= next_time:
+            this_time = next_time + 0.01
+            delay = this_time - now
+        else:
+            delay = random() * delay_window
+            this_time = now + delay
+        self._event_schedule_times[event_type] = this_time
+        return delay
+
+    def _refresh_nodes_if_not_up(self, host):
+        """
+        Used to mitigate refreshes for nodes that are already known.
+        Some versions of the server send superfluous NEW_NODE messages in addition to UP events.
+        """
+        if not host or not host.is_up:
+            self.refresh_node_list_and_token_map()
+
+    def _handle_topology_change(self, event):
+        change_type = event["change_type"]
+        addr, port = event["address"]
+        host = self._cluster.metadata.get_host(addr, port)
+        if change_type == "NEW_NODE" or change_type == "MOVED_NODE":
+            if self._topology_event_refresh_window >= 0:
+                delay = self._delay_for_event_type('topology_change', self._topology_event_refresh_window)
+                self._cluster.scheduler.schedule_unique(delay, self._refresh_nodes_if_not_up, host)
+        elif change_type == "REMOVED_NODE":
+            self._cluster.scheduler.schedule_unique(0, self._cluster.remove_host, host)
+
+    def _handle_status_change(self, event):
+        change_type = event["change_type"]
+        addr, port = event["address"]
+        host = self._cluster.metadata.get_host(addr, port)
+        if change_type == "UP":
+            delay = self._delay_for_event_type('status_change', self._status_event_refresh_window)
+            if host is None:
+                # this is the first time we've seen the node
+                self._cluster.scheduler.schedule_unique(delay, self.refresh_node_list_and_token_map)
+            else:
+                self._cluster.scheduler.schedule_unique(delay, self._cluster.on_up, host)
+        elif change_type == "DOWN":
+            # Note that there is a slight risk we can receive the event late and thus
+            # mark the host down even though we already had reconnected successfully.
+            # But it is unlikely, and don't have too much consequence since we'll try reconnecting
+            # right away, so we favor the detection to make the Host.is_up more accurate.
+            if host is not None:
+                # this will be run by the scheduler
+                self._cluster.on_down(host, is_host_addition=False)
+
+    def _handle_schema_change(self, event):
+        if self._schema_event_refresh_window < 0:
+            return
+        delay = self._delay_for_event_type('schema_change', self._schema_event_refresh_window)
+        self._cluster.scheduler.schedule_unique(delay, self.refresh_schema, **event)
+
+    def wait_for_schema_agreement(self, connection=None, preloaded_results=None, wait_time=None):
+
+        total_timeout = wait_time if wait_time is not None else self._cluster.max_schema_agreement_wait
+        if total_timeout <= 0:
+            return True
+
+        # Each schema change typically generates two schema refreshes, one
+        # from the response type and one from the pushed notification. Holding
+        # a lock is just a simple way to cut down on the number of schema queries
+        # we'll make.
+        with self._schema_agreement_lock:
+            if self._is_shutdown:
+                return
+
+            if not connection:
+                connection = self._connection
+
+            if preloaded_results:
+                log.debug("[control connection] Attempting to use preloaded results for schema agreement")
+
+                peers_result = preloaded_results[0]
+                local_result = preloaded_results[1]
+                schema_mismatches = self._get_schema_mismatches(peers_result, local_result, connection.endpoint)
+                if schema_mismatches is None:
+                    return True
+
+            log.debug("[control connection] Waiting for schema agreement")
+            start = self._time.time()
+            elapsed = 0
+            cl = ConsistencyLevel.ONE
+            schema_mismatches = None
+            select_peers_query = self._get_peers_query(self.PeersQueryType.PEERS_SCHEMA, connection)
+
+            while elapsed < total_timeout:
+                peers_query = QueryMessage(query=select_peers_query, consistency_level=cl)
+                local_query = QueryMessage(query=self._SELECT_SCHEMA_LOCAL, consistency_level=cl)
+                try:
+                    timeout = min(self._timeout, total_timeout - elapsed)
+                    peers_result, local_result = connection.wait_for_responses(
+                        peers_query, local_query, timeout=timeout)
+                except OperationTimedOut as timeout:
+                    log.debug("[control connection] Timed out waiting for "
+                              "response during schema agreement check: %s", timeout)
+                    elapsed = self._time.time() - start
+                    continue
+                except ConnectionShutdown:
+                    if self._is_shutdown:
+                        log.debug("[control connection] Aborting wait for schema match due to shutdown")
+                        return None
+                    else:
+                        raise
+
+                schema_mismatches = self._get_schema_mismatches(peers_result, local_result, connection.endpoint)
+                if schema_mismatches is None:
+                    return True
+
+                log.debug("[control connection] Schemas mismatched, trying again")
+                self._time.sleep(0.2)
+                elapsed = self._time.time() - start
+
+            log.warning("Node %s is reporting a schema disagreement: %s",
+                        connection.endpoint, schema_mismatches)
+            return False
+
+    def _get_schema_mismatches(self, peers_result, local_result, local_address):
+        peers_result = dict_factory(peers_result.column_names, peers_result.parsed_rows)
+
+        versions = defaultdict(set)
+        if local_result.parsed_rows:
+            local_row = dict_factory(local_result.column_names, local_result.parsed_rows)[0]
+            if local_row.get("schema_version"):
+                versions[local_row.get("schema_version")].add(local_address)
+
+        for row in peers_result:
+            schema_ver = row.get('schema_version')
+            if not schema_ver:
+                continue
+            endpoint = self._cluster.endpoint_factory.create(row)
+            peer = self._cluster.metadata.get_host(endpoint)
+            if peer and peer.is_up is not False:
+                versions[schema_ver].add(endpoint)
+
+        if len(versions) == 1:
+            log.debug("[control connection] Schemas match")
+            return None
+
+        return dict((version, list(nodes)) for version, nodes in versions.items())
+
+    def _get_peers_query(self, peers_query_type, connection=None):
+        """
+        Determine the peers query to use.
+
+        :param peers_query_type: Should be one of PeersQueryType enum.
+
+        If _uses_peers_v2 is True, return the proper peers_v2 query (no templating).
+        Else, apply the logic below to choose the peers v1 address column name:
+
+        Given a connection:
+
+        - find the server product version running on the connection's host,
+        - use that to choose the column name for the transport address (see APOLLO-1130), and
+        - use that column name in the provided peers query template.
+        """
+        if peers_query_type not in (self.PeersQueryType.PEERS, self.PeersQueryType.PEERS_SCHEMA):
+            raise ValueError("Invalid peers query type: %s" % peers_query_type)
+
+        if self._uses_peers_v2:
+            if peers_query_type == self.PeersQueryType.PEERS:
+                query = self._SELECT_PEERS_V2 if self._token_meta_enabled else self._SELECT_PEERS_NO_TOKENS_V2
+            else:
+                query = self._SELECT_SCHEMA_PEERS_V2
+        else:
+            if peers_query_type == self.PeersQueryType.PEERS and self._token_meta_enabled:
+                query = self._SELECT_PEERS
+            else:
+                query_template = (self._SELECT_SCHEMA_PEERS_TEMPLATE
+                                  if peers_query_type == self.PeersQueryType.PEERS_SCHEMA
+                                  else self._SELECT_PEERS_NO_TOKENS_TEMPLATE)
+
+                host_release_version = self._cluster.metadata.get_host(connection.endpoint).release_version
+                host_dse_version = self._cluster.metadata.get_host(connection.endpoint).dse_version
+                uses_native_address_query = (
+                    host_dse_version and Version(host_dse_version) >= self._MINIMUM_NATIVE_ADDRESS_DSE_VERSION)
+
+                if uses_native_address_query:
+                    query = query_template.format(nt_col_name="native_transport_address")
+                elif host_release_version:
+                    query = query_template.format(nt_col_name="rpc_address")
+                else:
+                    query = self._SELECT_PEERS
+
+        return query
+
+    def _signal_error(self):
+        with self._lock:
+            if self._is_shutdown:
+                return
+
+            # try just signaling the cluster, as this will trigger a reconnect
+            # as part of marking the host down
+            if self._connection and self._connection.is_defunct:
+                host = self._cluster.metadata.get_host(self._connection.endpoint)
+                # host may be None if it's already been removed, but that indicates
+                # that errors have already been reported, so we're fine
+                if host:
+                    self._cluster.signal_connection_failure(
+                        host, self._connection.last_error, is_host_addition=False)
+                    return
+
+        # if the connection is not defunct or the host already left, reconnect
+        # manually
+        self.reconnect()
+
+    def on_up(self, host):
+        pass
+
+    def on_down(self, host):
+
+        conn = self._connection
+        if conn and conn.endpoint == host.endpoint and \
+                self._reconnection_handler is None:
+            log.debug("[control connection] Control connection host (%s) is "
+                      "considered down, starting reconnection", host)
+            # this will result in a task being submitted to the executor to reconnect
+            self.reconnect()
+
+    def on_add(self, host, refresh_nodes=True):
+        if refresh_nodes:
+            self.refresh_node_list_and_token_map(force_token_rebuild=True)
+
+    def on_remove(self, host):
+        c = self._connection
+        if c and c.endpoint == host.endpoint:
+            log.debug("[control connection] Control connection host (%s) is being removed. Reconnecting", host)
+            # refresh will be done on reconnect
+            self.reconnect()
+        else:
+            self.refresh_node_list_and_token_map(force_token_rebuild=True)
+
+    def get_connections(self):
+        c = getattr(self, '_connection', None)
+        return [c] if c else []
+
+    def return_connection(self, connection):
+        if connection is self._connection and (connection.is_defunct or connection.is_closed):
+            self.reconnect()
+
+
+def _stop_scheduler(scheduler, thread):
+    try:
+        if not scheduler.is_shutdown:
+            scheduler.shutdown()
+    except ReferenceError:
+        pass
+
+    thread.join()
+
+
+class _Scheduler(Thread):
+
+    _queue = None
+    _scheduled_tasks = None
+    _executor = None
+    is_shutdown = False
+
+    def __init__(self, executor):
+        self._queue = queue.PriorityQueue()
+        self._scheduled_tasks = set()
+        self._count = count()
+        self._executor = executor
+
+        Thread.__init__(self, name="Task Scheduler")
+        self.daemon = True
+        self.start()
+
+    def shutdown(self):
+        try:
+            log.debug("Shutting down Cluster Scheduler")
+        except AttributeError:
+            # this can happen on interpreter shutdown
+            pass
+        self.is_shutdown = True
+        self._queue.put_nowait((0, 0, None))
+        self.join()
+
+    def schedule(self, delay, fn, *args, **kwargs):
+        self._insert_task(delay, (fn, args, tuple(kwargs.items())))
+
+    def schedule_unique(self, delay, fn, *args, **kwargs):
+        task = (fn, args, tuple(kwargs.items()))
+        if task not in self._scheduled_tasks:
+            self._insert_task(delay, task)
+        else:
+            log.debug("Ignoring schedule_unique for already-scheduled task: %r", task)
+
+    def _insert_task(self, delay, task):
+        if not self.is_shutdown:
+            run_at = time.time() + delay
+            self._scheduled_tasks.add(task)
+            self._queue.put_nowait((run_at, next(self._count), task))
+        else:
+            log.debug("Ignoring scheduled task after shutdown: %r", task)
+
+    def run(self):
+        while True:
+            if self.is_shutdown:
+                return
+
+            try:
+                while True:
+                    run_at, i, task = self._queue.get(block=True, timeout=None)
+                    if self.is_shutdown:
+                        if task:
+                            log.debug("Not executing scheduled task due to Scheduler shutdown")
+                        return
+                    if run_at <= time.time():
+                        self._scheduled_tasks.discard(task)
+                        fn, args, kwargs = task
+                        kwargs = dict(kwargs)
+                        future = self._executor.submit(fn, *args, **kwargs)
+                        future.add_done_callback(self._log_if_failed)
+                    else:
+                        self._queue.put_nowait((run_at, i, task))
+                        break
+            except queue.Empty:
+                pass
+
+            time.sleep(0.1)
+
+    def _log_if_failed(self, future):
+        exc = future.exception()
+        if exc:
+            log.warning(
+                "An internally scheduled tasked failed with an unhandled exception:",
+                exc_info=exc)
+
+
+def refresh_schema_and_set_result(control_conn, response_future, connection, **kwargs):
+    try:
+        log.debug("Refreshing schema in response to schema change. "
+                  "%s", kwargs)
+        response_future.is_schema_agreed = control_conn._refresh_schema(connection, **kwargs)
+    except Exception:
+        log.exception("Exception refreshing schema in response to schema change:")
+        response_future.session.submit(control_conn.refresh_schema, **kwargs)
+    finally:
+        response_future._set_final_result(None)
+
+
+class ResponseFuture(object):
+    """
+    An asynchronous response delivery mechanism that is returned from calls
+    to :meth:`.Session.execute_async()`.
+
+    There are two ways for results to be delivered:
+     - Synchronously, by calling :meth:`.result()`
+     - Asynchronously, by attaching callback and errback functions via
+       :meth:`.add_callback()`, :meth:`.add_errback()`, and
+       :meth:`.add_callbacks()`.
+    """
+
+    query = None
+    """
+    The :class:`~.Statement` instance that is being executed through this
+    :class:`.ResponseFuture`.
+    """
+
+    is_schema_agreed = True
+    """
+    For DDL requests, this may be set ``False`` if the schema agreement poll after the response fails.
+
+    Always ``True`` for non-DDL requests.
+    """
+
+    request_encoded_size = None
+    """
+    Size of the request message sent
+    """
+
+    coordinator_host = None
+    """
+    The host from which we received a response
+    """
+
+    attempted_hosts = None
+    """
+    A list of hosts tried, including all speculative executions, retries, and pages
+    """
+
+    session = None
+    row_factory = None
+    message = None
+    default_timeout = None
+
+    _retry_policy = None
+    _profile_manager = None
+
+    _req_id = None
+    _final_result = _NOT_SET
+    _col_names = None
+    _col_types = None
+    _final_exception = None
+    _query_traces = None
+    _callbacks = None
+    _errbacks = None
+    _current_host = None
+    _connection = None
+    _query_retries = 0
+    _start_time = None
+    _metrics = None
+    _paging_state = None
+    _custom_payload = None
+    _warnings = None
+    _timer = None
+    _protocol_handler = ProtocolHandler
+    _spec_execution_plan = NoSpeculativeExecutionPlan()
+    _continuous_paging_options = None
+    _continuous_paging_session = None
+    _host = None
+
+    _warned_timeout = False
+
+    def __init__(self, session, message, query, timeout, metrics=None, prepared_statement=None,
+                 retry_policy=RetryPolicy(), row_factory=None, load_balancer=None, start_time=None,
+                 speculative_execution_plan=None, continuous_paging_state=None, host=None):
+        self.session = session
+        # TODO: normalize handling of retry policy and row factory
+        self.row_factory = row_factory or session.row_factory
+        self._load_balancer = load_balancer or session.cluster._default_load_balancing_policy
+        self.message = message
+        self.query = query
+        self.timeout = timeout
+        self._retry_policy = retry_policy
+        self._metrics = metrics
+        self.prepared_statement = prepared_statement
+        self._callback_lock = Lock()
+        self._start_time = start_time or time.time()
+        self._host = host
+        self._spec_execution_plan = speculative_execution_plan or self._spec_execution_plan
+        self._make_query_plan()
+        self._event = Event()
+        self._errors = {}
+        self._callbacks = []
+        self._errbacks = []
+        self.attempted_hosts = []
+        self._start_timer()
+        self._continuous_paging_state = continuous_paging_state
+
+    @property
+    def _time_remaining(self):
+        if self.timeout is None:
+            return None
+        return (self._start_time + self.timeout) - time.time()
+
+    def _start_timer(self):
+        if self._timer is None:
+            spec_delay = self._spec_execution_plan.next_execution(self._current_host)
+            if spec_delay >= 0:
+                if self._time_remaining is None or self._time_remaining > spec_delay:
+                    self._timer = self.session.cluster.connection_class.create_timer(spec_delay, self._on_speculative_execute)
+                    return
+            if self._time_remaining is not None:
+                self._timer = self.session.cluster.connection_class.create_timer(self._time_remaining, self._on_timeout)
+
+    def _cancel_timer(self):
+        if self._timer:
+            self._timer.cancel()
+
+    def _on_timeout(self, _attempts=0):
+        """
+        Called when the request associated with this ResponseFuture times out.
+
+        This function may reschedule itself. The ``_attempts`` parameter tracks
+        the number of times this has happened. This parameter should only be
+        set in those cases, where ``_on_timeout`` reschedules itself.
+        """
+        # PYTHON-853: for short timeouts, we sometimes race with our __init__
+        if self._connection is None and _attempts < 3:
+            self._timer = self.session.cluster.connection_class.create_timer(
+                0.01,
+                partial(self._on_timeout, _attempts=_attempts + 1)
+            )
+            return
+
+        if self._connection is not None:
+            try:
+                self._connection._requests.pop(self._req_id)
+            # PYTHON-1044
+            # This request might have been removed from the connection after the latter was defunct by heartbeat.
+            # We should still raise OperationTimedOut to reject the future so that the main event thread will not
+            # wait for it endlessly
+            except KeyError:
+                key = "Connection defunct by heartbeat"
+                errors = {key: "Client request timeout. See Session.execute[_async](timeout)"}
+                self._set_final_exception(OperationTimedOut(errors, self._current_host))
+                return
+
+            pool = self.session._pools.get(self._current_host)
+            if pool and not pool.is_shutdown:
+                # Do not return the stream ID to the pool yet. We cannot reuse it
+                # because the node might still be processing the query and will
+                # return a late response to that query - if we used such stream
+                # before the response to the previous query has arrived, the new
+                # query could get a response from the old query
+                with self._connection.lock:
+                    self._connection.orphaned_request_ids.add(self._req_id)
+                    if len(self._connection.orphaned_request_ids) >= self._connection.orphaned_threshold:
+                        self._connection.orphaned_threshold_reached = True
+
+                pool.return_connection(self._connection, stream_was_orphaned=True)
+
+        errors = self._errors
+        if not errors:
+            if self.is_schema_agreed:
+                key = str(self._current_host.endpoint) if self._current_host else 'no host queried before timeout'
+                errors = {key: "Client request timeout. See Session.execute[_async](timeout)"}
+            else:
+                connection = self.session.cluster.control_connection._connection
+                host = str(connection.endpoint) if connection else 'unknown'
+                errors = {host: "Request timed out while waiting for schema agreement. See Session.execute[_async](timeout) and Cluster.max_schema_agreement_wait."}
+
+        self._set_final_exception(OperationTimedOut(errors, self._current_host))
+
+    def _on_speculative_execute(self):
+        self._timer = None
+        if not self._event.is_set():
+
+            # PYTHON-836, the speculative queries must be after
+            # the query is sent from the main thread, otherwise the
+            # query from the main thread may raise NoHostAvailable
+            # if the _query_plan has been exhausted by the specualtive queries.
+            # This also prevents a race condition accessing the iterator.
+            # We reschedule this call until the main thread has succeeded
+            # making a query
+            if not self.attempted_hosts:
+                self._timer = self.session.cluster.connection_class.create_timer(0.01, self._on_speculative_execute)
+                return
+
+            if self._time_remaining is not None:
+                if self._time_remaining <= 0:
+                    self._on_timeout()
+                    return
+            self.send_request(error_no_hosts=False)
+            self._start_timer()
+
+    def _make_query_plan(self):
+        # set the query_plan according to the load balancing policy,
+        # or to the explicit host target if set
+        if self._host:
+            # returning a single value effectively disables retries
+            self.query_plan = [self._host]
+        else:
+            # convert the list/generator/etc to an iterator so that subsequent
+            # calls to send_request (which retries may do) will resume where
+            # they last left off
+            self.query_plan = iter(self._load_balancer.make_query_plan(self.session.keyspace, self.query))
+
+    def send_request(self, error_no_hosts=True):
+        """ Internal """
+        # query_plan is an iterator, so this will resume where we last left
+        # off if send_request() is called multiple times
+        for host in self.query_plan:
+            req_id = self._query(host)
+            if req_id is not None:
+                self._req_id = req_id
+                return True
+            if self.timeout is not None and time.time() - self._start_time > self.timeout:
+                self._on_timeout()
+                return True
+        if error_no_hosts:
+            self._set_final_exception(NoHostAvailable(
+                "Unable to complete the operation against any hosts", self._errors))
+        return False
+
+    def _query(self, host, message=None, cb=None):
+        if message is None:
+            message = self.message
+
+        pool = self.session._pools.get(host)
+        if not pool:
+            self._errors[host] = ConnectionException("Host has been marked down or removed")
+            return None
+        elif pool.is_shutdown:
+            self._errors[host] = ConnectionException("Pool is shutdown")
+            return None
+
+        self._current_host = host
+
+        connection = None
+        try:
+            # TODO get connectTimeout from cluster settings
+            connection, request_id = pool.borrow_connection(timeout=2.0)
+            self._connection = connection
+            result_meta = self.prepared_statement.result_metadata if self.prepared_statement else []
+
+            if cb is None:
+                cb = partial(self._set_result, host, connection, pool)
+
+            self.request_encoded_size = connection.send_msg(message, request_id, cb=cb,
+                                                            encoder=self._protocol_handler.encode_message,
+                                                            decoder=self._protocol_handler.decode_message,
+                                                            result_metadata=result_meta)
+            self.attempted_hosts.append(host)
+            return request_id
+        except NoConnectionsAvailable as exc:
+            log.debug("All connections for host %s are at capacity, moving to the next host", host)
+            self._errors[host] = exc
+        except ConnectionBusy as exc:
+            log.debug("Connection for host %s is busy, moving to the next host", host)
+            self._errors[host] = exc
+        except Exception as exc:
+            log.debug("Error querying host %s", host, exc_info=True)
+            self._errors[host] = exc
+            if self._metrics is not None:
+                self._metrics.on_connection_error()
+            if connection:
+                pool.return_connection(connection)
+
+        return None
+
+    @property
+    def has_more_pages(self):
+        """
+        Returns :const:`True` if there are more pages left in the
+        query results, :const:`False` otherwise.  This should only
+        be checked after the first page has been returned.
+
+        .. versionadded:: 2.0.0
+        """
+        return self._paging_state is not None
+
+    @property
+    def warnings(self):
+        """
+        Warnings returned from the server, if any. This will only be
+        set for protocol_version 4+.
+
+        Warnings may be returned for such things as oversized batches,
+        or too many tombstones in slice queries.
+
+        Ensure the future is complete before trying to access this property
+        (call :meth:`.result()`, or after callback is invoked).
+        Otherwise it may throw if the response has not been received.
+        """
+        # TODO: When timers are introduced, just make this wait
+        if not self._event.is_set():
+            raise DriverException("warnings cannot be retrieved before ResponseFuture is finalized")
+        return self._warnings
+
+    @property
+    def custom_payload(self):
+        """
+        The custom payload returned from the server, if any. This will only be
+        set by Cassandra servers implementing a custom QueryHandler, and only
+        for protocol_version 4+.
+
+        Ensure the future is complete before trying to access this property
+        (call :meth:`.result()`, or after callback is invoked).
+        Otherwise it may throw if the response has not been received.
+
+        :return: :ref:`custom_payload`.
+        """
+        # TODO: When timers are introduced, just make this wait
+        if not self._event.is_set():
+            raise DriverException("custom_payload cannot be retrieved before ResponseFuture is finalized")
+        return self._custom_payload
+
+    def start_fetching_next_page(self):
+        """
+        If there are more pages left in the query result, this asynchronously
+        starts fetching the next page.  If there are no pages left, :exc:`.QueryExhausted`
+        is raised.  Also see :attr:`.has_more_pages`.
+
+        This should only be called after the first page has been returned.
+
+        .. versionadded:: 2.0.0
+        """
+        if not self._paging_state:
+            raise QueryExhausted()
+
+        self._make_query_plan()
+        self.message.paging_state = self._paging_state
+        self._event.clear()
+        self._final_result = _NOT_SET
+        self._final_exception = None
+        self._start_timer()
+        self.send_request()
+
+    def _reprepare(self, prepare_message, host, connection, pool):
+        cb = partial(self.session.submit, self._execute_after_prepare, host, connection, pool)
+        request_id = self._query(host, prepare_message, cb=cb)
+        if request_id is None:
+            # try to submit the original prepared statement on some other host
+            self.send_request()
+
+    def _set_result(self, host, connection, pool, response):
+        try:
+            self.coordinator_host = host
+            if pool:
+                pool.return_connection(connection)
+
+            trace_id = getattr(response, 'trace_id', None)
+            if trace_id:
+                if not self._query_traces:
+                    self._query_traces = []
+                self._query_traces.append(QueryTrace(trace_id, self.session))
+
+            self._warnings = getattr(response, 'warnings', None)
+            self._custom_payload = getattr(response, 'custom_payload', None)
+
+            if isinstance(response, ResultMessage):
+                if response.kind == RESULT_KIND_SET_KEYSPACE:
+                    session = getattr(self, 'session', None)
+                    # since we're running on the event loop thread, we need to
+                    # use a non-blocking method for setting the keyspace on
+                    # all connections in this session, otherwise the event
+                    # loop thread will deadlock waiting for keyspaces to be
+                    # set.  This uses a callback chain which ends with
+                    # self._set_keyspace_completed() being called in the
+                    # event loop thread.
+                    if session:
+                        session._set_keyspace_for_all_pools(
+                            response.new_keyspace, self._set_keyspace_completed)
+                elif response.kind == RESULT_KIND_SCHEMA_CHANGE:
+                    # refresh the schema before responding, but do it in another
+                    # thread instead of the event loop thread
+                    self.is_schema_agreed = False
+                    self.session.submit(
+                        refresh_schema_and_set_result,
+                        self.session.cluster.control_connection,
+                        self, connection, **response.schema_change_event)
+                elif response.kind == RESULT_KIND_ROWS:
+                    self._paging_state = response.paging_state
+                    self._col_names = response.column_names
+                    self._col_types = response.column_types
+                    if getattr(self.message, 'continuous_paging_options', None):
+                        self._handle_continuous_paging_first_response(connection, response)
+                    else:
+                        self._set_final_result(self.row_factory(response.column_names, response.parsed_rows))
+                elif response.kind == RESULT_KIND_VOID:
+                    self._set_final_result(None)
+                else:
+                    self._set_final_result(response)
+            elif isinstance(response, ErrorMessage):
+                retry_policy = self._retry_policy
+
+                if isinstance(response, ReadTimeoutErrorMessage):
+                    if self._metrics is not None:
+                        self._metrics.on_read_timeout()
+                    retry = retry_policy.on_read_timeout(
+                        self.query, retry_num=self._query_retries, **response.info)
+                elif isinstance(response, WriteTimeoutErrorMessage):
+                    if self._metrics is not None:
+                        self._metrics.on_write_timeout()
+                    retry = retry_policy.on_write_timeout(
+                        self.query, retry_num=self._query_retries, **response.info)
+                elif isinstance(response, UnavailableErrorMessage):
+                    if self._metrics is not None:
+                        self._metrics.on_unavailable()
+                    retry = retry_policy.on_unavailable(
+                        self.query, retry_num=self._query_retries, **response.info)
+                elif isinstance(response, (OverloadedErrorMessage,
+                                           IsBootstrappingErrorMessage,
+                                           TruncateError, ServerError)):
+                    log.warning("Host %s error: %s.", host, response.summary)
+                    if self._metrics is not None:
+                        self._metrics.on_other_error()
+                    cl = getattr(self.message, 'consistency_level', None)
+                    retry = retry_policy.on_request_error(
+                        self.query, cl, error=response,
+                        retry_num=self._query_retries)
+                elif isinstance(response, PreparedQueryNotFound):
+                    if self.prepared_statement:
+                        query_id = self.prepared_statement.query_id
+                        assert query_id == response.info, \
+                            "Got different query ID in server response (%s) than we " \
+                            "had before (%s)" % (response.info, query_id)
+                    else:
+                        query_id = response.info
+
+                    try:
+                        prepared_statement = self.session.cluster._prepared_statements[query_id]
+                    except KeyError:
+                        if not self.prepared_statement:
+                            log.error("Tried to execute unknown prepared statement: id=%s",
+                                      query_id.encode('hex'))
+                            self._set_final_exception(response)
+                            return
+                        else:
+                            prepared_statement = self.prepared_statement
+                            self.session.cluster._prepared_statements[query_id] = prepared_statement
+
+                    current_keyspace = self._connection.keyspace
+                    prepared_keyspace = prepared_statement.keyspace
+                    if not ProtocolVersion.uses_keyspace_flag(self.session.cluster.protocol_version) \
+                            and prepared_keyspace  and current_keyspace != prepared_keyspace:
+                        self._set_final_exception(
+                            ValueError("The Session's current keyspace (%s) does "
+                                       "not match the keyspace the statement was "
+                                       "prepared with (%s)" %
+                                       (current_keyspace, prepared_keyspace)))
+                        return
+
+                    log.debug("Re-preparing unrecognized prepared statement against host %s: %s",
+                              host, prepared_statement.query_string)
+                    prepared_keyspace = prepared_statement.keyspace \
+                        if ProtocolVersion.uses_keyspace_flag(self.session.cluster.protocol_version) else None
+                    prepare_message = PrepareMessage(query=prepared_statement.query_string,
+                                                     keyspace=prepared_keyspace)
+                    # since this might block, run on the executor to avoid hanging
+                    # the event loop thread
+                    self.session.submit(self._reprepare, prepare_message, host, connection, pool)
+                    return
+                else:
+                    if hasattr(response, 'to_exception'):
+                        self._set_final_exception(response.to_exception())
+                    else:
+                        self._set_final_exception(response)
+                    return
+
+                self._handle_retry_decision(retry, response, host)
+            elif isinstance(response, ConnectionException):
+                if self._metrics is not None:
+                    self._metrics.on_connection_error()
+                if not isinstance(response, ConnectionShutdown):
+                    self._connection.defunct(response)
+                cl = getattr(self.message, 'consistency_level', None)
+                retry = self._retry_policy.on_request_error(
+                    self.query, cl, error=response, retry_num=self._query_retries)
+                self._handle_retry_decision(retry, response, host)
+            elif isinstance(response, Exception):
+                if hasattr(response, 'to_exception'):
+                    self._set_final_exception(response.to_exception())
+                else:
+                    self._set_final_exception(response)
+            else:
+                # we got some other kind of response message
+                msg = "Got unexpected message: %r" % (response,)
+                exc = ConnectionException(msg, host)
+                self._cancel_timer()
+                self._connection.defunct(exc)
+                self._set_final_exception(exc)
+        except Exception as exc:
+            # almost certainly caused by a bug, but we need to set something here
+            log.exception("Unexpected exception while handling result in ResponseFuture:")
+            self._set_final_exception(exc)
+
+    def _handle_continuous_paging_first_response(self, connection, response):
+        self._continuous_paging_session = connection.new_continuous_paging_session(response.stream_id,
+                                                                                   self._protocol_handler.decode_message,
+                                                                                   self.row_factory,
+                                                                                   self._continuous_paging_state)
+        self._continuous_paging_session.on_message(response)
+        self._set_final_result(self._continuous_paging_session.results())
+
+    def _set_keyspace_completed(self, errors):
+        if not errors:
+            self._set_final_result(None)
+        else:
+            self._set_final_exception(ConnectionException(
+                "Failed to set keyspace on all hosts: %s" % (errors,)))
+
+    def _execute_after_prepare(self, host, connection, pool, response):
+        """
+        Handle the response to our attempt to prepare a statement.
+        If it succeeded, run the original query again against the same host.
+        """
+        if pool:
+            pool.return_connection(connection)
+
+        if self._final_exception:
+            return
+
+        if isinstance(response, ResultMessage):
+            if response.kind == RESULT_KIND_PREPARED:
+                if self.prepared_statement:
+                    if self.prepared_statement.query_id != response.query_id:
+                        self._set_final_exception(DriverException(
+                            "ID mismatch while trying to reprepare (expected {expected}, got {got}). "
+                            "This prepared statement won't work anymore. "
+                            "This usually happens when you run a 'USE...' "
+                            "query after the statement was prepared.".format(
+                                expected=hexlify(self.prepared_statement.query_id), got=hexlify(response.query_id)
+                            )
+                        ))
+                    self.prepared_statement.result_metadata = response.column_metadata
+                    new_metadata_id = response.result_metadata_id
+                    if new_metadata_id is not None:
+                        self.prepared_statement.result_metadata_id = new_metadata_id
+
+                # use self._query to re-use the same host and
+                # at the same time properly borrow the connection
+                request_id = self._query(host)
+                if request_id is None:
+                    # this host errored out, move on to the next
+                    self.send_request()
+            else:
+                self._set_final_exception(ConnectionException(
+                    "Got unexpected response when preparing statement "
+                    "on host %s: %s" % (host, response)))
+        elif isinstance(response, ErrorMessage):
+            if hasattr(response, 'to_exception'):
+                self._set_final_exception(response.to_exception())
+            else:
+                self._set_final_exception(response)
+        elif isinstance(response, ConnectionException):
+            log.debug("Connection error when preparing statement on host %s: %s",
+                      host, response)
+            # try again on a different host, preparing again if necessary
+            self._errors[host] = response
+            self.send_request()
+        else:
+            self._set_final_exception(ConnectionException(
+                "Got unexpected response type when preparing "
+                "statement on host %s: %s" % (host, response)))
+
+    def _set_final_result(self, response):
+        self._cancel_timer()
+        if self._metrics is not None:
+            self._metrics.request_timer.addValue(time.time() - self._start_time)
+
+        with self._callback_lock:
+            self._final_result = response
+            # save off current callbacks inside lock for execution outside it
+            # -- prevents case where _final_result is set, then a callback is
+            # added and executed on the spot, then executed again as a
+            # registered callback
+            to_call = tuple(
+                partial(fn, response, *args, **kwargs)
+                for (fn, args, kwargs) in self._callbacks
+            )
+
+        self._event.set()
+
+        # apply each callback
+        for callback_partial in to_call:
+            callback_partial()
+
+    def _set_final_exception(self, response):
+        self._cancel_timer()
+        if self._metrics is not None:
+            self._metrics.request_timer.addValue(time.time() - self._start_time)
+
+        with self._callback_lock:
+            self._final_exception = response
+            # save off current errbacks inside lock for execution outside it --
+            # prevents case where _final_exception is set, then an errback is
+            # added and executed on the spot, then executed again as a
+            # registered errback
+            to_call = tuple(
+                partial(fn, response, *args, **kwargs)
+                for (fn, args, kwargs) in self._errbacks
+            )
+        self._event.set()
+
+        # apply each callback
+        for callback_partial in to_call:
+            callback_partial()
+
+    def _handle_retry_decision(self, retry_decision, response, host):
+
+        def exception_from_response(response):
+            if hasattr(response, 'to_exception'):
+                return response.to_exception()
+            else:
+                return response
+
+        retry_type, consistency = retry_decision
+        if retry_type in (RetryPolicy.RETRY, RetryPolicy.RETRY_NEXT_HOST):
+            self._query_retries += 1
+            reuse = retry_type == RetryPolicy.RETRY
+            self._retry(reuse, consistency, host)
+        elif retry_type is RetryPolicy.RETHROW:
+            self._set_final_exception(exception_from_response(response))
+        else:  # IGNORE
+            if self._metrics is not None:
+                self._metrics.on_ignore()
+            self._set_final_result(None)
+
+        self._errors[host] = exception_from_response(response)
+
+    def _retry(self, reuse_connection, consistency_level, host):
+        if self._final_exception:
+            # the connection probably broke while we were waiting
+            # to retry the operation
+            return
+
+        if self._metrics is not None:
+            self._metrics.on_retry()
+        if consistency_level is not None:
+            self.message.consistency_level = consistency_level
+
+        # don't retry on the event loop thread
+        self.session.submit(self._retry_task, reuse_connection, host)
+
+    def _retry_task(self, reuse_connection, host):
+        if self._final_exception:
+            # the connection probably broke while we were waiting
+            # to retry the operation
+            return
+
+        if reuse_connection and self._query(host) is not None:
+            return
+
+        # otherwise, move onto another host
+        self.send_request()
+
+    def result(self):
+        """
+        Return the final result or raise an Exception if errors were
+        encountered.  If the final result or error has not been set
+        yet, this method will block until it is set, or the timeout
+        set for the request expires.
+
+        Timeout is specified in the Session request execution functions.
+        If the timeout is exceeded, an :exc:`cassandra.OperationTimedOut` will be raised.
+        This is a client-side timeout. For more information
+        about server-side coordinator timeouts, see :class:`.policies.RetryPolicy`.
+
+        Example usage::
+
+            >>> future = session.execute_async("SELECT * FROM mycf")
+            >>> # do other stuff...
+
+            >>> try:
+            ...     rows = future.result()
+            ...     for row in rows:
+            ...         ... # process results
+            ... except Exception:
+            ...     log.exception("Operation failed:")
+
+        """
+        self._event.wait()
+        if self._final_result is not _NOT_SET:
+            return ResultSet(self, self._final_result)
+        else:
+            raise self._final_exception
+
+    def get_query_trace_ids(self):
+        """
+        Returns the trace session ids for this future, if tracing was enabled (does not fetch trace data).
+        """
+        return [trace.trace_id for trace in self._query_traces]
+
+    def get_query_trace(self, max_wait=None, query_cl=ConsistencyLevel.LOCAL_ONE):
+        """
+        Fetches and returns the query trace of the last response, or `None` if tracing was
+        not enabled.
+
+        Note that this may raise an exception if there are problems retrieving the trace
+        details from Cassandra. If the trace is not available after `max_wait`,
+        :exc:`cassandra.query.TraceUnavailable` will be raised.
+
+        If the ResponseFuture is not done (async execution) and you try to retrieve the trace,
+        :exc:`cassandra.query.TraceUnavailable` will be raised.
+
+        `query_cl` is the consistency level used to poll the trace tables.
+        """
+        if self._final_result is _NOT_SET and self._final_exception is None:
+            raise TraceUnavailable(
+                "Trace information was not available. The ResponseFuture is not done.")
+
+        if self._query_traces:
+            return self._get_query_trace(len(self._query_traces) - 1, max_wait, query_cl)
+
+    def get_all_query_traces(self, max_wait_per=None, query_cl=ConsistencyLevel.LOCAL_ONE):
+        """
+        Fetches and returns the query traces for all query pages, if tracing was enabled.
+
+        See note in :meth:`~.get_query_trace` regarding possible exceptions.
+        """
+        if self._query_traces:
+            return [self._get_query_trace(i, max_wait_per, query_cl) for i in range(len(self._query_traces))]
+        return []
+
+    def _get_query_trace(self, i, max_wait, query_cl):
+        trace = self._query_traces[i]
+        if not trace.events:
+            trace.populate(max_wait=max_wait, query_cl=query_cl)
+        return trace
+
+    def add_callback(self, fn, *args, **kwargs):
+        """
+        Attaches a callback function to be called when the final results arrive.
+
+        By default, `fn` will be called with the results as the first and only
+        argument.  If `*args` or `**kwargs` are supplied, they will be passed
+        through as additional positional or keyword arguments to `fn`.
+
+        If an error is hit while executing the operation, a callback attached
+        here will not be called.  Use :meth:`.add_errback()` or :meth:`add_callbacks()`
+        if you wish to handle that case.
+
+        If the final result has already been seen when this method is called,
+        the callback will be called immediately (before this method returns).
+
+        Note: in the case that the result is not available when the callback is added,
+        the callback is executed by IO event thread. This means that the callback
+        should not block or attempt further synchronous requests, because no further
+        IO will be processed until the callback returns.
+
+        **Important**: if the callback you attach results in an exception being
+        raised, **the exception will be ignored**, so please ensure your
+        callback handles all error cases that you care about.
+
+        Usage example::
+
+            >>> session = cluster.connect("mykeyspace")
+
+            >>> def handle_results(rows, start_time, should_log=False):
+            ...     if should_log:
+            ...         log.info("Total time: %f", time.time() - start_time)
+            ...     ...
+
+            >>> future = session.execute_async("SELECT * FROM users")
+            >>> future.add_callback(handle_results, time.time(), should_log=True)
+
+        """
+        run_now = False
+        with self._callback_lock:
+            # Always add fn to self._callbacks, even when we're about to
+            # execute it, to prevent races with functions like
+            # start_fetching_next_page that reset _final_result
+            self._callbacks.append((fn, args, kwargs))
+            if self._final_result is not _NOT_SET:
+                run_now = True
+        if run_now:
+            fn(self._final_result, *args, **kwargs)
+        return self
+
+    def add_errback(self, fn, *args, **kwargs):
+        """
+        Like :meth:`.add_callback()`, but handles error cases.
+        An Exception instance will be passed as the first positional argument
+        to `fn`.
+        """
+        run_now = False
+        with self._callback_lock:
+            # Always add fn to self._errbacks, even when we're about to execute
+            # it, to prevent races with functions like start_fetching_next_page
+            # that reset _final_exception
+            self._errbacks.append((fn, args, kwargs))
+            if self._final_exception:
+                run_now = True
+        if run_now:
+            fn(self._final_exception, *args, **kwargs)
+        return self
+
+    def add_callbacks(self, callback, errback,
+                      callback_args=(), callback_kwargs=None,
+                      errback_args=(), errback_kwargs=None):
+        """
+        A convenient combination of :meth:`.add_callback()` and
+        :meth:`.add_errback()`.
+
+        Example usage::
+
+            >>> session = cluster.connect()
+            >>> query = "SELECT * FROM mycf"
+            >>> future = session.execute_async(query)
+
+            >>> def log_results(results, level='debug'):
+            ...     for row in results:
+            ...         log.log(level, "Result: %s", row)
+
+            >>> def log_error(exc, query):
+            ...     log.error("Query '%s' failed: %s", query, exc)
+
+            >>> future.add_callbacks(
+            ...     callback=log_results, callback_kwargs={'level': 'info'},
+            ...     errback=log_error, errback_args=(query,))
+
+        """
+        self.add_callback(callback, *callback_args, **(callback_kwargs or {}))
+        self.add_errback(errback, *errback_args, **(errback_kwargs or {}))
+
+    def clear_callbacks(self):
+        with self._callback_lock:
+            self._callbacks = []
+            self._errbacks = []
+
+    def __str__(self):
+        result = "(no result yet)" if self._final_result is _NOT_SET else self._final_result
+        return "<ResponseFuture: query='%s' request_id=%s result=%s exception=%s coordinator_host=%s>" \
+               % (self.query, self._req_id, result, self._final_exception, self.coordinator_host)
+    __repr__ = __str__
+
+
+class QueryExhausted(Exception):
+    """
+    Raised when :meth:`.ResponseFuture.start_fetching_next_page()` is called and
+    there are no more pages.  You can check :attr:`.ResponseFuture.has_more_pages`
+    before calling to avoid this.
+
+    .. versionadded:: 2.0.0
+    """
+    pass
+
+
+class ResultSet(object):
+    """
+    An iterator over the rows from a query result. Also supplies basic equality
+    and indexing methods for backward-compatability. These methods materialize
+    the entire result set (loading all pages), and should only be used if the
+    total result size is understood. Warnings are emitted when paged results
+    are materialized in this fashion.
+
+    You can treat this as a normal iterator over rows::
+
+        >>> from cassandra.query import SimpleStatement
+        >>> statement = SimpleStatement("SELECT * FROM users", fetch_size=10)
+        >>> for user_row in session.execute(statement):
+        ...     process_user(user_row)
+
+    Whenever there are no more rows in the current page, the next page will
+    be fetched transparently.  However, note that it *is* possible for
+    an :class:`Exception` to be raised while fetching the next page, just
+    like you might see on a normal call to ``session.execute()``.
+    """
+
+    def __init__(self, response_future, initial_response):
+        self.response_future = response_future
+        self.column_names = response_future._col_names
+        self.column_types = response_future._col_types
+        self._set_current_rows(initial_response)
+        self._page_iter = None
+        self._list_mode = False
+
+    @property
+    def has_more_pages(self):
+        """
+        True if the last response indicated more pages; False otherwise
+        """
+        return self.response_future.has_more_pages
+
+    @property
+    def current_rows(self):
+        """
+        The list of current page rows. May be empty if the result was empty,
+        or this is the last page.
+        """
+        return self._current_rows or []
+
+    def all(self):
+        """
+        Returns all the remaining rows as a list. This is basically
+        a convenient shortcut to `list(result_set)`.
+
+        This function is not recommended for queries that return a large number of elements.
+        """
+        return list(self)
+
+    def one(self):
+        """
+        Return a single row of the results or None if empty. This is basically
+        a shortcut to `result_set.current_rows[0]` and should only be used when
+        you know a query returns a single row. Consider using an iterator if the
+        ResultSet contains more than one row.
+        """
+        row = None
+        if self._current_rows:
+            try:
+                row = self._current_rows[0]
+            except TypeError:  # generator object is not subscriptable, PYTHON-1026
+                row = next(iter(self._current_rows))
+
+        return row
+
+    def __iter__(self):
+        if self._list_mode:
+            return iter(self._current_rows)
+        self._page_iter = iter(self._current_rows)
+        return self
+
+    def next(self):
+        try:
+            return next(self._page_iter)
+        except StopIteration:
+            if not self.response_future.has_more_pages:
+                if not self._list_mode:
+                    self._current_rows = []
+                raise
+
+        if not self.response_future._continuous_paging_session:
+            self.fetch_next_page()
+            self._page_iter = iter(self._current_rows)
+
+            # Some servers can return empty pages in this case; Scylla is known to do
+            # so in some circumstances.  Guard against this by recursing to handle
+            # the next(iter) call.  If we have an empty page in that case it will
+            # get handled by the StopIteration handler when we recurse.
+            return self.next()
+
+        return next(self._page_iter)
+
+    __next__ = next
+
+    def fetch_next_page(self):
+        """
+        Manually, synchronously fetch the next page. Supplied for manually retrieving pages
+        and inspecting :meth:`~.current_page`. It is not necessary to call this when iterating
+        through results; paging happens implicitly in iteration.
+        """
+        if self.response_future.has_more_pages:
+            self.response_future.start_fetching_next_page()
+            result = self.response_future.result()
+            self._current_rows = result._current_rows  # ResultSet has already _set_current_rows to the appropriate form
+        else:
+            self._current_rows = []
+
+    def _set_current_rows(self, result):
+        if isinstance(result, Mapping):
+            self._current_rows = [result] if result else []
+            return
+        try:
+            iter(result)  # can't check directly for generator types because cython generators are different
+            self._current_rows = result
+        except TypeError:
+            self._current_rows = [result] if result else []
+
+    def _fetch_all(self):
+        self._current_rows = list(self)
+        self._page_iter = None
+
+    def _enter_list_mode(self, operator):
+        if self._list_mode:
+            return
+        if self._page_iter:
+            raise RuntimeError("Cannot use %s when results have been iterated." % operator)
+        if self.response_future.has_more_pages:
+            log.warning("Using %s on paged results causes entire result set to be materialized.", operator)
+        self._fetch_all()  # done regardless of paging status in case the row factory produces a generator
+        self._list_mode = True
+
+    def __eq__(self, other):
+        self._enter_list_mode("equality operator")
+        return self._current_rows == other
+
+    def __getitem__(self, i):
+        if i == 0:
+            warn("ResultSet indexing support will be removed in 4.0. Consider using "
+                 "ResultSet.one() to get a single row.", DeprecationWarning)
+        self._enter_list_mode("index operator")
+        return self._current_rows[i]
+
+    def __nonzero__(self):
+        return bool(self._current_rows)
+
+    __bool__ = __nonzero__
+
+    def get_query_trace(self, max_wait_sec=None):
+        """
+        Gets the last query trace from the associated future.
+        See :meth:`.ResponseFuture.get_query_trace` for details.
+        """
+        return self.response_future.get_query_trace(max_wait_sec)
+
+    def get_all_query_traces(self, max_wait_sec_per=None):
+        """
+        Gets all query traces from the associated future.
+        See :meth:`.ResponseFuture.get_all_query_traces` for details.
+        """
+        return self.response_future.get_all_query_traces(max_wait_sec_per)
+
+    def cancel_continuous_paging(self):
+        try:
+            self.response_future._continuous_paging_session.cancel()
+        except AttributeError:
+            raise DriverException("Attempted to cancel paging with no active session. This is only for requests with ContinuousdPagingOptions.")
+
+    @property
+    def was_applied(self):
+        """
+        For LWT results, returns whether the transaction was applied.
+
+        Result is indeterminate if called on a result that was not an LWT request or on
+        a :class:`.query.BatchStatement` containing LWT. In the latter case either all the batch
+        succeeds or fails.
+
+        Only valid when one of the of the internal row factories is in use.
+        """
+        if self.response_future.row_factory not in (named_tuple_factory, dict_factory, tuple_factory):
+            raise RuntimeError("Cannot determine LWT result with row factory %s" % (self.response_future.row_factory,))
+
+        is_batch_statement = isinstance(self.response_future.query, BatchStatement)
+        if is_batch_statement and (not self.column_names or self.column_names[0] != "[applied]"):
+            raise RuntimeError("No LWT were present in the BatchStatement")
+
+        if not is_batch_statement and len(self.current_rows) != 1:
+            raise RuntimeError("LWT result should have exactly one row. This has %d." % (len(self.current_rows)))
+
+        row = self.current_rows[0]
+        if isinstance(row, tuple):
+            return row[0]
+        else:
+            return row['[applied]']
+
+    @property
+    def paging_state(self):
+        """
+        Server paging state of the query. Can be `None` if the query was not paged.
+
+        The driver treats paging state as opaque, but it may contain primary key data, so applications may want to
+        avoid sending this to untrusted parties.
+        """
+        return self.response_future._paging_state
diff --git a/llm/Lib/site-packages/cassandra/cmurmur3.c b/llm/Lib/site-packages/cassandra/cmurmur3.c
new file mode 100644
index 0000000000000000000000000000000000000000..54a4295012d221f18b59a71672629b464e21caa7
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cmurmur3.c
@@ -0,0 +1,275 @@
+/*
+ * The majority of this code was taken from the python-smhasher library,
+ * which can be found here: https://github.com/phensley/python-smhasher
+ *
+ * That library is under the MIT license with the following copyright:
+ *
+ * Copyright (c) 2011 Austin Appleby (Murmur3 routine)
+ * Copyright (c) 2011 Patrick Hensley (Python wrapper, packaging)
+ * Copyright DataStax (Minor modifications to match Cassandra's MM3 hashes)
+ *
+ */
+
+#define PY_SSIZE_T_CLEAN 1
+#include <Python.h>
+#include <stdio.h>
+
+#if PY_VERSION_HEX < 0x02050000
+typedef int Py_ssize_t;
+#define PY_SSIZE_T_MAX INT_MAX
+#define PY_SSIZE_T_MIN INT_MIN
+#endif
+
+#ifdef PYPY_VERSION
+#define COMPILING_IN_PYPY 1
+#define COMPILING_IN_CPYTHON 0
+#else
+#define COMPILING_IN_PYPY 0
+#define COMPILING_IN_CPYTHON 1
+#endif
+//-----------------------------------------------------------------------------
+// Platform-specific functions and macros
+
+// Microsoft Visual Studio
+
+#if defined(_MSC_VER)
+
+typedef unsigned char uint8_t;
+typedef unsigned long uint32_t;
+typedef unsigned __int64 uint64_t;
+
+typedef char int8_t;
+typedef long int32_t;
+typedef __int64 int64_t;
+
+#define FORCE_INLINE	__forceinline
+
+#include <stdlib.h>
+
+#define ROTL32(x,y)	_rotl(x,y)
+#define ROTL64(x,y)	_rotl64(x,y)
+
+#define BIG_CONSTANT(x) (x)
+
+// Other compilers
+
+#else	// defined(_MSC_VER)
+
+#include <stdint.h>
+
+#define	FORCE_INLINE inline __attribute__((always_inline))
+
+inline uint32_t rotl32 ( int32_t x, int8_t r )
+{
+  // cast to unsigned for logical right bitshift (to match C* MM3 implementation)
+  return (x << r) | ((int32_t) (((uint32_t) x) >> (32 - r)));
+}
+
+inline int64_t rotl64 ( int64_t x, int8_t r )
+{
+  // cast to unsigned for logical right bitshift (to match C* MM3 implementation)
+  return (x << r) | ((int64_t) (((uint64_t) x) >> (64 - r)));
+}
+
+#define ROTL32(x,y)	rotl32(x,y)
+#define ROTL64(x,y)	rotl64(x,y)
+
+#define BIG_CONSTANT(x) (x##LL)
+
+#endif // !defined(_MSC_VER)
+
+//-----------------------------------------------------------------------------
+// Block read - if your platform needs to do endian-swapping or can only
+// handle aligned reads, do the conversion here
+
+// TODO 32bit?
+
+FORCE_INLINE int64_t getblock ( const int64_t * p, int i )
+{
+  return p[i];
+}
+
+//-----------------------------------------------------------------------------
+// Finalization mix - force all bits of a hash block to avalanche
+
+FORCE_INLINE int64_t fmix ( int64_t k )
+{
+  // cast to unsigned for logical right bitshift (to match C* MM3 implementation)
+  k ^= ((uint64_t) k) >> 33;
+  k *= BIG_CONSTANT(0xff51afd7ed558ccd);
+  k ^= ((uint64_t) k) >> 33;
+  k *= BIG_CONSTANT(0xc4ceb9fe1a85ec53);
+  k ^= ((uint64_t) k) >> 33;
+
+  return k;
+}
+
+int64_t MurmurHash3_x64_128 (const void * key, const int len,
+                              const uint32_t seed)
+{
+  const int8_t * data = (const int8_t*)key;
+  const int nblocks = len / 16;
+
+  int64_t h1 = seed;
+  int64_t h2 = seed;
+
+  int64_t c1 = BIG_CONSTANT(0x87c37b91114253d5);
+  int64_t c2 = BIG_CONSTANT(0x4cf5ad432745937f);
+  int64_t k1 = 0;
+  int64_t k2 = 0;
+
+  const int64_t * blocks = (const int64_t *)(data);
+  const int8_t * tail = (const int8_t*)(data + nblocks*16);
+
+  //----------
+  // body
+
+  int i;
+  for(i = 0; i < nblocks; i++)
+  {
+    int64_t k1 = getblock(blocks,i*2+0);
+    int64_t k2 = getblock(blocks,i*2+1);
+
+    k1 *= c1; k1  = ROTL64(k1,31); k1 *= c2; h1 ^= k1;
+
+    h1 = ROTL64(h1,27); h1 += h2; h1 = h1*5+0x52dce729;
+
+    k2 *= c2; k2  = ROTL64(k2,33); k2 *= c1; h2 ^= k2;
+
+    h2 = ROTL64(h2,31); h2 += h1; h2 = h2*5+0x38495ab5;
+  }
+
+  //----------
+  // tail
+  switch(len & 15)
+  {
+    case 15: k2 ^= ((int64_t) (tail[14])) << 48;
+    case 14: k2 ^= ((int64_t) (tail[13])) << 40;
+    case 13: k2 ^= ((int64_t) (tail[12])) << 32;
+    case 12: k2 ^= ((int64_t) (tail[11])) << 24;
+    case 11: k2 ^= ((int64_t) (tail[10])) << 16;
+    case 10: k2 ^= ((int64_t) (tail[ 9])) << 8;
+    case  9: k2 ^= ((int64_t) (tail[ 8])) << 0;
+             k2 *= c2; k2  = ROTL64(k2,33); k2 *= c1; h2 ^= k2;
+
+    case  8: k1 ^= ((int64_t) (tail[ 7])) << 56;
+    case  7: k1 ^= ((int64_t) (tail[ 6])) << 48;
+    case  6: k1 ^= ((int64_t) (tail[ 5])) << 40;
+    case  5: k1 ^= ((int64_t) (tail[ 4])) << 32;
+    case  4: k1 ^= ((int64_t) (tail[ 3])) << 24;
+    case  3: k1 ^= ((int64_t) (tail[ 2])) << 16;
+    case  2: k1 ^= ((int64_t) (tail[ 1])) << 8;
+    case  1: k1 ^= ((int64_t) (tail[ 0])) << 0;
+             k1 *= c1; k1  = ROTL64(k1,31); k1 *= c2; h1 ^= k1;
+  };
+
+  //----------
+  // finalization
+
+  h1 ^= len; h2 ^= len;
+
+  h1 += h2;
+  h2 += h1;
+
+  h1 = fmix(h1);
+  h2 = fmix(h2);
+
+  h1 += h2;
+  h2 += h1;
+
+  return h1;
+}
+
+
+struct module_state {
+    PyObject *error;
+};
+
+// pypy3 doesn't have GetState yet.
+#if COMPILING_IN_CPYTHON && PY_MAJOR_VERSION >= 3
+#define GETSTATE(m) ((struct module_state*)PyModule_GetState(m))
+#else
+#define GETSTATE(m) (&_state)
+static struct module_state _state;
+#endif
+
+static PyObject *
+murmur3(PyObject *self, PyObject *args)
+{
+    const char *key;
+    Py_ssize_t len;
+    uint32_t seed = 0;
+    int64_t result = 0;
+
+
+    if (!PyArg_ParseTuple(args, "s#|I", &key, &len, &seed)) {
+        return NULL;
+    }
+
+    // TODO handle x86 version?
+    result = MurmurHash3_x64_128((void *)key, len, seed);
+    return (PyObject *) PyLong_FromLongLong(result);
+}
+
+static PyMethodDef cmurmur3_methods[] = {
+    {"murmur3", murmur3, METH_VARARGS, "Make an x64 murmur3 64-bit hash value"},
+    {NULL, NULL, 0, NULL}
+};
+
+#if PY_MAJOR_VERSION >= 3
+
+static int cmurmur3_traverse(PyObject *m, visitproc visit, void *arg) {
+    Py_VISIT(GETSTATE(m)->error);
+    return 0;
+}
+
+static int cmurmur3_clear(PyObject *m) {
+    Py_CLEAR(GETSTATE(m)->error);
+    return 0;
+}
+
+static struct PyModuleDef moduledef = {
+        PyModuleDef_HEAD_INIT,
+        "cmurmur3",
+        NULL,
+        sizeof(struct module_state),
+        cmurmur3_methods,
+        NULL,
+        cmurmur3_traverse,
+        cmurmur3_clear,
+        NULL
+};
+
+#define INITERROR return NULL
+
+PyObject *
+PyInit_cmurmur3(void)
+
+#else
+#define INITERROR return
+
+void
+initcmurmur3(void)
+#endif
+{
+#if PY_MAJOR_VERSION >= 3
+    PyObject *module = PyModule_Create(&moduledef);
+#else
+    PyObject *module = Py_InitModule("cmurmur3", cmurmur3_methods);
+#endif
+    struct module_state *st = NULL;
+
+    if (module == NULL)
+        INITERROR;
+    st = GETSTATE(module);
+
+    st->error = PyErr_NewException("cmurmur3.Error", NULL, NULL);
+    if (st->error == NULL) {
+        Py_DECREF(module);
+        INITERROR;
+    }
+
+#if PY_MAJOR_VERSION >= 3
+    return module;
+#endif
+}
diff --git a/llm/Lib/site-packages/cassandra/cmurmur3.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/cmurmur3.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..a394ae169145815a97eb21f2b3864c584ff5b3b2
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cmurmur3.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/column_encryption/__pycache__/_policies.cpython-311.pyc b/llm/Lib/site-packages/cassandra/column_encryption/__pycache__/_policies.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6e802b45ebf44611e23c00d2e3564ad35c05bc84
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/column_encryption/__pycache__/_policies.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/column_encryption/__pycache__/policies.cpython-311.pyc b/llm/Lib/site-packages/cassandra/column_encryption/__pycache__/policies.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..130787c7c62fd1a35ea93d053c3edf6d73930a77
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/column_encryption/__pycache__/policies.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/column_encryption/_policies.py b/llm/Lib/site-packages/cassandra/column_encryption/_policies.py
new file mode 100644
index 0000000000000000000000000000000000000000..ddc4894f88aa9615ec461c9d172bd5772a4a188a
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/column_encryption/_policies.py
@@ -0,0 +1,139 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from collections import namedtuple
+from functools import lru_cache
+
+import logging
+import os
+
+log = logging.getLogger(__name__)
+
+from cassandra.cqltypes import _cqltypes
+from cassandra.policies import ColumnEncryptionPolicy
+
+from cryptography.hazmat.primitives import padding
+from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes
+
+AES256_BLOCK_SIZE = 128
+AES256_BLOCK_SIZE_BYTES = int(AES256_BLOCK_SIZE / 8)
+AES256_KEY_SIZE = 256
+AES256_KEY_SIZE_BYTES = int(AES256_KEY_SIZE / 8)
+
+ColData = namedtuple('ColData', ['key','type'])
+
+class AES256ColumnEncryptionPolicy(ColumnEncryptionPolicy):
+
+    # Fix block cipher mode for now.  IV size is a function of block cipher used
+    # so fixing this avoids (possibly unnecessary) validation logic here.
+    mode = modes.CBC
+
+    # "iv" param here expects a bytearray that's the same size as the block
+    # size for AES-256 (128 bits or 16 bytes).  If none is provided a new one
+    # will be randomly generated, but in this case the IV should be recorded and
+    # preserved or else you will not be able to decrypt any data encrypted by this
+    # policy.
+    def __init__(self, iv=None):
+
+        # CBC uses an IV that's the same size as the block size
+        #
+        # Avoid defining IV with a default arg in order to stay away from
+        # any issues around the caching of default args
+        self.iv = iv
+        if self.iv:
+            if not len(self.iv) == AES256_BLOCK_SIZE_BYTES:
+                raise ValueError("This policy uses AES-256 with CBC mode and therefore expects a 128-bit initialization vector")
+        else:
+            self.iv = os.urandom(AES256_BLOCK_SIZE_BYTES)
+
+        # ColData for a given ColDesc is always preserved.  We only create a Cipher
+        # when there's an actual need to for a given ColDesc
+        self.coldata = {}
+        self.ciphers = {}
+
+    def encrypt(self, coldesc, obj_bytes):
+
+        # AES256 has a 128-bit block size so if the input bytes don't align perfectly on
+        # those blocks we have to pad them.  There's plenty of room for optimization here:
+        #
+        # * Instances of the PKCS7 padder should be managed in a bounded pool
+        # * It would be nice if we could get a flag from encrypted data to indicate
+        #   whether it was padded or not
+        #   * Might be able to make this happen with a leading block of flags in encrypted data
+        padder = padding.PKCS7(AES256_BLOCK_SIZE).padder()
+        padded_bytes = padder.update(obj_bytes) + padder.finalize()
+
+        cipher = self._get_cipher(coldesc)
+        encryptor = cipher.encryptor()
+        return self.iv + encryptor.update(padded_bytes) + encryptor.finalize()
+
+    def decrypt(self, coldesc, bytes):
+
+        iv = bytes[:AES256_BLOCK_SIZE_BYTES]
+        encrypted_bytes = bytes[AES256_BLOCK_SIZE_BYTES:]
+        cipher = self._get_cipher(coldesc, iv=iv)
+        decryptor = cipher.decryptor()
+        padded_bytes = decryptor.update(encrypted_bytes) + decryptor.finalize()
+
+        unpadder = padding.PKCS7(AES256_BLOCK_SIZE).unpadder()
+        return unpadder.update(padded_bytes) + unpadder.finalize()
+
+    def add_column(self, coldesc, key, type):
+
+        if not coldesc:
+            raise ValueError("ColDesc supplied to add_column cannot be None")
+        if not key:
+            raise ValueError("Key supplied to add_column cannot be None")
+        if not type:
+            raise ValueError("Type supplied to add_column cannot be None")
+        if type not in _cqltypes.keys():
+            raise ValueError("Type %s is not a supported type".format(type))
+        if not len(key) == AES256_KEY_SIZE_BYTES:
+            raise ValueError("AES256 column encryption policy expects a 256-bit encryption key")
+        self.coldata[coldesc] = ColData(key, _cqltypes[type])
+
+    def contains_column(self, coldesc):
+        return coldesc in self.coldata
+
+    def encode_and_encrypt(self, coldesc, obj):
+        if not coldesc:
+            raise ValueError("ColDesc supplied to encode_and_encrypt cannot be None")
+        if not obj:
+            raise ValueError("Object supplied to encode_and_encrypt cannot be None")
+        coldata = self.coldata.get(coldesc)
+        if not coldata:
+            raise ValueError("Could not find ColData for ColDesc %s".format(coldesc))
+        return self.encrypt(coldesc, coldata.type.serialize(obj, None))
+
+    def cache_info(self):
+        return AES256ColumnEncryptionPolicy._build_cipher.cache_info()
+
+    def column_type(self, coldesc):
+        return self.coldata[coldesc].type
+
+    def _get_cipher(self, coldesc, iv=None):
+        """
+        Access relevant state from this instance necessary to create a Cipher and then get one,
+        hopefully returning a cached instance if we've already done so (and it hasn't been evicted)
+        """
+        try:
+            coldata = self.coldata[coldesc]
+            return AES256ColumnEncryptionPolicy._build_cipher(coldata.key, iv or self.iv)
+        except KeyError:
+            raise ValueError("Could not find column {}".format(coldesc))
+
+    # Explicitly use a class method here to avoid caching self
+    @lru_cache(maxsize=128)
+    def _build_cipher(key, iv):
+        return Cipher(algorithms.AES256(key), AES256ColumnEncryptionPolicy.mode(iv))
diff --git a/llm/Lib/site-packages/cassandra/column_encryption/policies.py b/llm/Lib/site-packages/cassandra/column_encryption/policies.py
new file mode 100644
index 0000000000000000000000000000000000000000..90cff2d2b0319aee8469007716d369dd58313c9f
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/column_encryption/policies.py
@@ -0,0 +1,20 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import cryptography
+    from cassandra.column_encryption._policies import *
+except ImportError:
+    # Cryptography is not installed
+    pass
diff --git a/llm/Lib/site-packages/cassandra/concurrent.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/concurrent.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..37b71b2eecb524830e5d2658d77fce8c73ecbd82
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/concurrent.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/concurrent.py b/llm/Lib/site-packages/cassandra/concurrent.py
new file mode 100644
index 0000000000000000000000000000000000000000..c7dd48bafb9a0909dc424f4f7f7b78f9e28eb2c7
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/concurrent.py
@@ -0,0 +1,229 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from collections import namedtuple
+from heapq import heappush, heappop
+from itertools import cycle
+from threading import Condition
+import sys
+
+from cassandra.cluster import ResultSet, EXEC_PROFILE_DEFAULT
+
+import logging
+log = logging.getLogger(__name__)
+
+
+ExecutionResult = namedtuple('ExecutionResult', ['success', 'result_or_exc'])
+
+def execute_concurrent(session, statements_and_parameters, concurrency=100, raise_on_first_error=True, results_generator=False, execution_profile=EXEC_PROFILE_DEFAULT):
+    """
+    Executes a sequence of (statement, parameters) tuples concurrently.  Each
+    ``parameters`` item must be a sequence or :const:`None`.
+
+    The `concurrency` parameter controls how many statements will be executed
+    concurrently.  When :attr:`.Cluster.protocol_version` is set to 1 or 2,
+    it is recommended that this be kept below 100 times the number of
+    core connections per host times the number of connected hosts (see
+    :meth:`.Cluster.set_core_connections_per_host`).  If that amount is exceeded,
+    the event loop thread may attempt to block on new connection creation,
+    substantially impacting throughput.  If :attr:`~.Cluster.protocol_version`
+    is 3 or higher, you can safely experiment with higher levels of concurrency.
+
+    If `raise_on_first_error` is left as :const:`True`, execution will stop
+    after the first failed statement and the corresponding exception will be
+    raised.
+
+    `results_generator` controls how the results are returned.
+
+    * If :const:`False`, the results are returned only after all requests have completed.
+    * If :const:`True`, a generator expression is returned. Using a generator results in a constrained
+      memory footprint when the results set will be large -- results are yielded
+      as they return instead of materializing the entire list at once. The trade for lower memory
+      footprint is marginal CPU overhead (more thread coordination and sorting out-of-order results
+      on-the-fly).
+
+    `execution_profile` argument is the execution profile to use for this
+    request, it is passed directly to :meth:`Session.execute_async`.
+
+    A sequence of ``ExecutionResult(success, result_or_exc)`` namedtuples is returned
+    in the same order that the statements were passed in.  If ``success`` is :const:`False`,
+    there was an error executing the statement, and ``result_or_exc`` will be
+    an :class:`Exception`.  If ``success`` is :const:`True`, ``result_or_exc``
+    will be the query result.
+
+    Example usage::
+
+        select_statement = session.prepare("SELECT * FROM users WHERE id=?")
+
+        statements_and_params = []
+        for user_id in user_ids:
+            params = (user_id, )
+            statements_and_params.append((select_statement, params))
+
+        results = execute_concurrent(
+            session, statements_and_params, raise_on_first_error=False)
+
+        for (success, result) in results:
+            if not success:
+                handle_error(result)  # result will be an Exception
+            else:
+                process_user(result[0])  # result will be a list of rows
+
+    Note: in the case that `generators` are used, it is important to ensure the consumers do not
+    block or attempt further synchronous requests, because no further IO will be processed until
+    the consumer returns. This may also produce a deadlock in the IO event thread.
+    """
+    if concurrency <= 0:
+        raise ValueError("concurrency must be greater than 0")
+
+    if not statements_and_parameters:
+        return []
+
+    executor = ConcurrentExecutorGenResults(session, statements_and_parameters, execution_profile) \
+        if results_generator else ConcurrentExecutorListResults(session, statements_and_parameters, execution_profile)
+    return executor.execute(concurrency, raise_on_first_error)
+
+
+class _ConcurrentExecutor(object):
+
+    max_error_recursion = 100
+
+    def __init__(self, session, statements_and_params, execution_profile):
+        self.session = session
+        self._enum_statements = enumerate(iter(statements_and_params))
+        self._execution_profile = execution_profile
+        self._condition = Condition()
+        self._fail_fast = False
+        self._results_queue = []
+        self._current = 0
+        self._exec_count = 0
+        self._exec_depth = 0
+
+    def execute(self, concurrency, fail_fast):
+        self._fail_fast = fail_fast
+        self._results_queue = []
+        self._current = 0
+        self._exec_count = 0
+        with self._condition:
+            for n in range(concurrency):
+                if not self._execute_next():
+                    break
+        return self._results()
+
+    def _execute_next(self):
+        # lock must be held
+        try:
+            (idx, (statement, params)) = next(self._enum_statements)
+            self._exec_count += 1
+            self._execute(idx, statement, params)
+            return True
+        except StopIteration:
+            pass
+
+    def _execute(self, idx, statement, params):
+        self._exec_depth += 1
+        try:
+            future = self.session.execute_async(statement, params, timeout=None, execution_profile=self._execution_profile)
+            args = (future, idx)
+            future.add_callbacks(
+                callback=self._on_success, callback_args=args,
+                errback=self._on_error, errback_args=args)
+        except Exception as exc:
+            # If we're not failing fast and all executions are raising, there is a chance of recursing
+            # here as subsequent requests are attempted. If we hit this threshold, schedule this result/retry
+            # and let the event loop thread return.
+            if self._exec_depth < self.max_error_recursion:
+                self._put_result(exc, idx, False)
+            else:
+                self.session.submit(self._put_result, exc, idx, False)
+        self._exec_depth -= 1
+
+    def _on_success(self, result, future, idx):
+        future.clear_callbacks()
+        self._put_result(ResultSet(future, result), idx, True)
+
+    def _on_error(self, result, future, idx):
+        self._put_result(result, idx, False)
+
+
+class ConcurrentExecutorGenResults(_ConcurrentExecutor):
+
+    def _put_result(self, result, idx, success):
+        with self._condition:
+            heappush(self._results_queue, (idx, ExecutionResult(success, result)))
+            self._execute_next()
+            self._condition.notify()
+
+    def _results(self):
+        with self._condition:
+            while self._current < self._exec_count:
+                while not self._results_queue or self._results_queue[0][0] != self._current:
+                    self._condition.wait()
+                while self._results_queue and self._results_queue[0][0] == self._current:
+                    _, res = heappop(self._results_queue)
+                    try:
+                        self._condition.release()
+                        if self._fail_fast and not res[0]:
+                            raise res[1]
+                        yield res
+                    finally:
+                        self._condition.acquire()
+                    self._current += 1
+
+
+class ConcurrentExecutorListResults(_ConcurrentExecutor):
+
+    _exception = None
+
+    def execute(self, concurrency, fail_fast):
+        self._exception = None
+        return super(ConcurrentExecutorListResults, self).execute(concurrency, fail_fast)
+
+    def _put_result(self, result, idx, success):
+        self._results_queue.append((idx, ExecutionResult(success, result)))
+        with self._condition:
+            self._current += 1
+            if not success and self._fail_fast:
+                if not self._exception:
+                    self._exception = result
+                self._condition.notify()
+            elif not self._execute_next() and self._current == self._exec_count:
+                self._condition.notify()
+
+    def _results(self):
+        with self._condition:
+            while self._current < self._exec_count:
+                self._condition.wait()
+                if self._exception and self._fail_fast:
+                    raise self._exception
+        if self._exception and self._fail_fast:  # raise the exception even if there was no wait
+            raise self._exception
+        return [r[1] for r in sorted(self._results_queue)]
+
+
+
+def execute_concurrent_with_args(session, statement, parameters, *args, **kwargs):
+    """
+    Like :meth:`~cassandra.concurrent.execute_concurrent()`, but takes a single
+    statement and a sequence of parameters.  Each item in ``parameters``
+    should be a sequence or :const:`None`.
+
+    Example usage::
+
+        statement = session.prepare("INSERT INTO mytable (a, b) VALUES (1, ?)")
+        parameters = [(x,) for x in range(1000)]
+        execute_concurrent_with_args(session, statement, parameters, concurrency=50)
+    """
+    return execute_concurrent(session, zip(cycle((statement,)), parameters), *args, **kwargs)
diff --git a/llm/Lib/site-packages/cassandra/connection.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/connection.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..6ce300f26ac585053181f849248931c436141e6d
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/connection.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/connection.py b/llm/Lib/site-packages/cassandra/connection.py
new file mode 100644
index 0000000000000000000000000000000000000000..a18181242c55486729cfdac59b0783ae341885f9
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/connection.py
@@ -0,0 +1,1829 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import  # to enable import io from stdlib
+from collections import defaultdict, deque
+import errno
+from functools import wraps, partial, total_ordering
+from heapq import heappush, heappop
+import io
+import logging
+import socket
+import struct
+import sys
+from threading import Thread, Event, RLock, Condition
+import time
+import ssl
+import weakref
+
+
+if 'gevent.monkey' in sys.modules:
+    from gevent.queue import Queue, Empty
+else:
+    from queue import Queue, Empty  # noqa
+
+from cassandra import ConsistencyLevel, AuthenticationFailed, OperationTimedOut, ProtocolVersion
+from cassandra.marshal import int32_pack
+from cassandra.protocol import (ReadyMessage, AuthenticateMessage, OptionsMessage,
+                                StartupMessage, ErrorMessage, CredentialsMessage,
+                                QueryMessage, ResultMessage, ProtocolHandler,
+                                InvalidRequestException, SupportedMessage,
+                                AuthResponseMessage, AuthChallengeMessage,
+                                AuthSuccessMessage, ProtocolException,
+                                RegisterMessage, ReviseRequestMessage)
+from cassandra.segment import SegmentCodec, CrcException
+from cassandra.util import OrderedDict
+
+
+log = logging.getLogger(__name__)
+
+segment_codec_no_compression = SegmentCodec()
+segment_codec_lz4 = None
+
+# We use an ordered dictionary and specifically add lz4 before
+# snappy so that lz4 will be preferred. Changing the order of this
+# will change the compression preferences for the driver.
+locally_supported_compressions = OrderedDict()
+
+try:
+    import lz4
+except ImportError:
+    pass
+else:
+    # The compress and decompress functions we need were moved from the lz4 to
+    # the lz4.block namespace, so we try both here.
+    try:
+        from lz4 import block as lz4_block
+    except ImportError:
+        lz4_block = lz4
+
+    try:
+        lz4_block.compress
+        lz4_block.decompress
+    except AttributeError:
+        raise ImportError(
+            'lz4 not imported correctly. Imported object should have '
+            '.compress and and .decompress attributes but does not. '
+            'Please file a bug report on JIRA. (Imported object was '
+            '{lz4_block})'.format(lz4_block=repr(lz4_block))
+        )
+
+    # Cassandra writes the uncompressed message length in big endian order,
+    # but the lz4 lib requires little endian order, so we wrap these
+    # functions to handle that
+
+    def lz4_compress(byts):
+        # write length in big-endian instead of little-endian
+        return int32_pack(len(byts)) + lz4_block.compress(byts)[4:]
+
+    def lz4_decompress(byts):
+        # flip from big-endian to little-endian
+        return lz4_block.decompress(byts[3::-1] + byts[4:])
+
+    locally_supported_compressions['lz4'] = (lz4_compress, lz4_decompress)
+    segment_codec_lz4 = SegmentCodec(lz4_compress, lz4_decompress)
+
+try:
+    import snappy
+except ImportError:
+    pass
+else:
+    # work around apparently buggy snappy decompress
+    def decompress(byts):
+        if byts == '\x00':
+            return ''
+        return snappy.decompress(byts)
+    locally_supported_compressions['snappy'] = (snappy.compress, decompress)
+
+DRIVER_NAME, DRIVER_VERSION = 'DataStax Python Driver', sys.modules['cassandra'].__version__
+
+PROTOCOL_VERSION_MASK = 0x7f
+
+HEADER_DIRECTION_FROM_CLIENT = 0x00
+HEADER_DIRECTION_TO_CLIENT = 0x80
+HEADER_DIRECTION_MASK = 0x80
+
+frame_header_v1_v2 = struct.Struct('>BbBi')
+frame_header_v3 = struct.Struct('>BhBi')
+
+
+class EndPoint(object):
+    """
+    Represents the information to connect to a cassandra node.
+    """
+
+    @property
+    def address(self):
+        """
+        The IP address of the node. This is the RPC address the driver uses when connecting to the node
+        """
+        raise NotImplementedError()
+
+    @property
+    def port(self):
+        """
+        The port of the node.
+        """
+        raise NotImplementedError()
+
+    @property
+    def ssl_options(self):
+        """
+        SSL options specific to this endpoint.
+        """
+        return None
+
+    @property
+    def socket_family(self):
+        """
+        The socket family of the endpoint.
+        """
+        return socket.AF_UNSPEC
+
+    def resolve(self):
+        """
+        Resolve the endpoint to an address/port. This is called
+        only on socket connection.
+        """
+        raise NotImplementedError()
+
+
+class EndPointFactory(object):
+
+    cluster = None
+
+    def configure(self, cluster):
+        """
+        This is called by the cluster during its initialization.
+        """
+        self.cluster = cluster
+        return self
+
+    def create(self, row):
+        """
+        Create an EndPoint from a system.peers row.
+        """
+        raise NotImplementedError()
+
+
+@total_ordering
+class DefaultEndPoint(EndPoint):
+    """
+    Default EndPoint implementation, basically just an address and port.
+    """
+
+    def __init__(self, address, port=9042):
+        self._address = address
+        self._port = port
+
+    @property
+    def address(self):
+        return self._address
+
+    @property
+    def port(self):
+        return self._port
+
+    def resolve(self):
+        return self._address, self._port
+
+    def __eq__(self, other):
+        return isinstance(other, DefaultEndPoint) and \
+               self.address == other.address and self.port == other.port
+
+    def __hash__(self):
+        return hash((self.address, self.port))
+
+    def __lt__(self, other):
+        return (self.address, self.port) < (other.address, other.port)
+
+    def __str__(self):
+        return str("%s:%d" % (self.address, self.port))
+
+    def __repr__(self):
+        return "<%s: %s:%d>" % (self.__class__.__name__, self.address, self.port)
+
+
+class DefaultEndPointFactory(EndPointFactory):
+
+    port = None
+    """
+    If no port is discovered in the row, this is the default port
+    used for endpoint creation. 
+    """
+
+    def __init__(self, port=None):
+        self.port = port
+
+    def create(self, row):
+        # TODO next major... move this class so we don't need this kind of hack
+        from cassandra.metadata import _NodeInfo
+        addr = _NodeInfo.get_broadcast_rpc_address(row)
+        port = _NodeInfo.get_broadcast_rpc_port(row)
+        if port is None:
+            port = self.port if self.port else 9042
+
+        # create the endpoint with the translated address
+        # TODO next major, create a TranslatedEndPoint type
+        return DefaultEndPoint(
+            self.cluster.address_translator.translate(addr),
+            port)
+
+
+@total_ordering
+class SniEndPoint(EndPoint):
+    """SNI Proxy EndPoint implementation."""
+
+    def __init__(self, proxy_address, server_name, port=9042):
+        self._proxy_address = proxy_address
+        self._index = 0
+        self._resolved_address = None  # resolved address
+        self._port = port
+        self._server_name = server_name
+        self._ssl_options = {'server_hostname': server_name}
+
+    @property
+    def address(self):
+        return self._proxy_address
+
+    @property
+    def port(self):
+        return self._port
+
+    @property
+    def ssl_options(self):
+        return self._ssl_options
+
+    def resolve(self):
+        try:
+            resolved_addresses = socket.getaddrinfo(self._proxy_address, self._port,
+                                                    socket.AF_UNSPEC, socket.SOCK_STREAM)
+        except socket.gaierror:
+            log.debug('Could not resolve sni proxy hostname "%s" '
+                      'with port %d' % (self._proxy_address, self._port))
+            raise
+
+        # round-robin pick
+        self._resolved_address = sorted(addr[4][0] for addr in resolved_addresses)[self._index % len(resolved_addresses)]
+        self._index += 1
+
+        return self._resolved_address, self._port
+
+    def __eq__(self, other):
+        return (isinstance(other, SniEndPoint) and
+                self.address == other.address and self.port == other.port and
+                self._server_name == other._server_name)
+
+    def __hash__(self):
+        return hash((self.address, self.port, self._server_name))
+
+    def __lt__(self, other):
+        return ((self.address, self.port, self._server_name) <
+                (other.address, other.port, self._server_name))
+
+    def __str__(self):
+        return str("%s:%d:%s" % (self.address, self.port, self._server_name))
+
+    def __repr__(self):
+        return "<%s: %s:%d:%s>" % (self.__class__.__name__,
+                                   self.address, self.port, self._server_name)
+
+
+class SniEndPointFactory(EndPointFactory):
+
+    def __init__(self, proxy_address, port):
+        self._proxy_address = proxy_address
+        self._port = port
+
+    def create(self, row):
+        host_id = row.get("host_id")
+        if host_id is None:
+            raise ValueError("No host_id to create the SniEndPoint")
+
+        return SniEndPoint(self._proxy_address, str(host_id), self._port)
+
+    def create_from_sni(self, sni):
+        return SniEndPoint(self._proxy_address, sni, self._port)
+
+
+@total_ordering
+class UnixSocketEndPoint(EndPoint):
+    """
+    Unix Socket EndPoint implementation.
+    """
+
+    def __init__(self, unix_socket_path):
+        self._unix_socket_path = unix_socket_path
+
+    @property
+    def address(self):
+        return self._unix_socket_path
+
+    @property
+    def port(self):
+        return None
+
+    @property
+    def socket_family(self):
+        return socket.AF_UNIX
+
+    def resolve(self):
+        return self.address, None
+
+    def __eq__(self, other):
+        return (isinstance(other, UnixSocketEndPoint) and
+                self._unix_socket_path == other._unix_socket_path)
+
+    def __hash__(self):
+        return hash(self._unix_socket_path)
+
+    def __lt__(self, other):
+        return self._unix_socket_path < other._unix_socket_path
+
+    def __str__(self):
+        return str("%s" % (self._unix_socket_path,))
+
+    def __repr__(self):
+        return "<%s: %s>" % (self.__class__.__name__, self._unix_socket_path)
+
+
+class _Frame(object):
+    def __init__(self, version, flags, stream, opcode, body_offset, end_pos):
+        self.version = version
+        self.flags = flags
+        self.stream = stream
+        self.opcode = opcode
+        self.body_offset = body_offset
+        self.end_pos = end_pos
+
+    def __eq__(self, other):  # facilitates testing
+        if isinstance(other, _Frame):
+            return (self.version == other.version and
+                    self.flags == other.flags and
+                    self.stream == other.stream and
+                    self.opcode == other.opcode and
+                    self.body_offset == other.body_offset and
+                    self.end_pos == other.end_pos)
+        return NotImplemented
+
+    def __str__(self):
+        return "ver({0}); flags({1:04b}); stream({2}); op({3}); offset({4}); len({5})".format(self.version, self.flags, self.stream, self.opcode, self.body_offset, self.end_pos - self.body_offset)
+
+
+NONBLOCKING = (errno.EAGAIN, errno.EWOULDBLOCK)
+
+
+class ConnectionException(Exception):
+    """
+    An unrecoverable error was hit when attempting to use a connection,
+    or the connection was already closed or defunct.
+    """
+
+    def __init__(self, message, endpoint=None):
+        Exception.__init__(self, message)
+        self.endpoint = endpoint
+
+    @property
+    def host(self):
+        return self.endpoint.address
+
+
+class ConnectionShutdown(ConnectionException):
+    """
+    Raised when a connection has been marked as defunct or has been closed.
+    """
+    pass
+
+
+class ProtocolVersionUnsupported(ConnectionException):
+    """
+    Server rejected startup message due to unsupported protocol version
+    """
+    def __init__(self, endpoint, startup_version):
+        msg = "Unsupported protocol version on %s: %d" % (endpoint, startup_version)
+        super(ProtocolVersionUnsupported, self).__init__(msg, endpoint)
+        self.startup_version = startup_version
+
+
+class ConnectionBusy(Exception):
+    """
+    An attempt was made to send a message through a :class:`.Connection` that
+    was already at the max number of in-flight operations.
+    """
+    pass
+
+
+class ProtocolError(Exception):
+    """
+    Communication did not match the protocol that this driver expects.
+    """
+    pass
+
+
+class CrcMismatchException(ConnectionException):
+    pass
+
+
+class ContinuousPagingState(object):
+    """
+     A class for specifying continuous paging state, only supported starting with DSE_V2.
+    """
+
+    num_pages_requested = None
+    """
+    How many pages we have already requested
+    """
+
+    num_pages_received = None
+    """
+    How many pages we have already received
+    """
+
+    max_queue_size = None
+    """
+    The max queue size chosen by the user via the options
+    """
+
+    def __init__(self, max_queue_size):
+        self.num_pages_requested = max_queue_size  # the initial query requests max_queue_size
+        self.num_pages_received = 0
+        self.max_queue_size = max_queue_size
+
+
+class ContinuousPagingSession(object):
+    def __init__(self, stream_id, decoder, row_factory, connection, state):
+        self.stream_id = stream_id
+        self.decoder = decoder
+        self.row_factory = row_factory
+        self.connection = connection
+        self._condition = Condition()
+        self._stop = False
+        self._page_queue = deque()
+        self._state = state
+        self.released = False
+
+    def on_message(self, result):
+        if isinstance(result, ResultMessage):
+            self.on_page(result)
+        elif isinstance(result, ErrorMessage):
+            self.on_error(result)
+
+    def on_page(self, result):
+        with self._condition:
+            if self._state:
+                self._state.num_pages_received += 1
+            self._page_queue.appendleft((result.column_names, result.parsed_rows, None))
+            self._stop |= result.continuous_paging_last
+            self._condition.notify()
+
+        if result.continuous_paging_last:
+            self.released = True
+
+    def on_error(self, error):
+        if isinstance(error, ErrorMessage):
+            error = error.to_exception()
+
+        log.debug("Got error %s for session %s", error, self.stream_id)
+
+        with self._condition:
+            self._page_queue.appendleft((None, None, error))
+            self._stop = True
+            self._condition.notify()
+
+        self.released = True
+
+    def results(self):
+        try:
+            self._condition.acquire()
+            while True:
+                while not self._page_queue and not self._stop:
+                    self._condition.wait(timeout=5)
+                while self._page_queue:
+                    names, rows, err = self._page_queue.pop()
+                    if err:
+                        raise err
+                    self.maybe_request_more()
+                    self._condition.release()
+                    for row in self.row_factory(names, rows):
+                        yield row
+                    self._condition.acquire()
+                if self._stop:
+                    break
+        finally:
+            try:
+                self._condition.release()
+            except RuntimeError:
+                # This exception happens if the CP results are not entirely consumed
+                # and the session is terminated by the runtime. See PYTHON-1054
+                pass
+
+    def maybe_request_more(self):
+        if not self._state:
+            return
+
+        max_queue_size = self._state.max_queue_size
+        num_in_flight = self._state.num_pages_requested - self._state.num_pages_received
+        space_in_queue = max_queue_size - len(self._page_queue) - num_in_flight
+        log.debug("Session %s from %s, space in CP queue: %s, requested: %s, received: %s, num_in_flight: %s",
+                  self.stream_id, self.connection.host, space_in_queue, self._state.num_pages_requested,
+                  self._state.num_pages_received, num_in_flight)
+
+        if space_in_queue >= max_queue_size / 2:
+            self.update_next_pages(space_in_queue)
+
+    def update_next_pages(self, num_next_pages):
+        try:
+            self._state.num_pages_requested += num_next_pages
+            log.debug("Updating backpressure for session %s from %s", self.stream_id, self.connection.host)
+            with self.connection.lock:
+                self.connection.send_msg(ReviseRequestMessage(ReviseRequestMessage.RevisionType.PAGING_BACKPRESSURE,
+                                                              self.stream_id,
+                                                              next_pages=num_next_pages),
+                                         self.connection.get_request_id(),
+                                         self._on_backpressure_response)
+        except ConnectionShutdown as ex:
+            log.debug("Failed to update backpressure for session %s from %s, connection is shutdown",
+                      self.stream_id, self.connection.host)
+            self.on_error(ex)
+
+    def _on_backpressure_response(self, response):
+        if isinstance(response, ResultMessage):
+            log.debug("Paging session %s backpressure updated.", self.stream_id)
+        else:
+            log.error("Failed updating backpressure for session %s from %s: %s", self.stream_id, self.connection.host,
+                      response.to_exception() if hasattr(response, 'to_exception') else response)
+            self.on_error(response)
+
+    def cancel(self):
+        try:
+            log.debug("Canceling paging session %s from %s", self.stream_id, self.connection.host)
+            with self.connection.lock:
+                self.connection.send_msg(ReviseRequestMessage(ReviseRequestMessage.RevisionType.PAGING_CANCEL,
+                                                              self.stream_id),
+                                         self.connection.get_request_id(),
+                                         self._on_cancel_response)
+        except ConnectionShutdown:
+            log.debug("Failed to cancel session %s from %s, connection is shutdown",
+                      self.stream_id, self.connection.host)
+
+        with self._condition:
+            self._stop = True
+            self._condition.notify()
+
+    def _on_cancel_response(self, response):
+        if isinstance(response, ResultMessage):
+            log.debug("Paging session %s canceled.", self.stream_id)
+        else:
+            log.error("Failed canceling streaming session %s from %s: %s", self.stream_id, self.connection.host,
+                      response.to_exception() if hasattr(response, 'to_exception') else response)
+        self.released = True
+
+
+def defunct_on_error(f):
+
+    @wraps(f)
+    def wrapper(self, *args, **kwargs):
+        try:
+            return f(self, *args, **kwargs)
+        except Exception as exc:
+            self.defunct(exc)
+    return wrapper
+
+
+DEFAULT_CQL_VERSION = '3.0.0'
+
+
+class _ConnectionIOBuffer(object):
+    """
+    Abstraction class to ease the use of the different connection io buffers. With
+    protocol V5 and checksumming, the data is read, validated and copied to another
+    cql frame buffer.
+    """
+    _io_buffer = None
+    _cql_frame_buffer = None
+    _connection = None
+    _segment_consumed = False
+
+    def __init__(self, connection):
+        self._io_buffer = io.BytesIO()
+        self._connection = weakref.proxy(connection)
+
+    @property
+    def io_buffer(self):
+        return self._io_buffer
+
+    @property
+    def cql_frame_buffer(self):
+        return self._cql_frame_buffer if self.is_checksumming_enabled else \
+            self._io_buffer
+
+    def set_checksumming_buffer(self):
+        self.reset_io_buffer()
+        self._cql_frame_buffer = io.BytesIO()
+
+    @property
+    def is_checksumming_enabled(self):
+        return self._connection._is_checksumming_enabled
+
+    @property
+    def has_consumed_segment(self):
+        return self._segment_consumed;
+
+    def readable_io_bytes(self):
+        return self.io_buffer.tell()
+
+    def readable_cql_frame_bytes(self):
+        return self.cql_frame_buffer.tell()
+
+    def reset_io_buffer(self):
+        self._io_buffer = io.BytesIO(self._io_buffer.read())
+        self._io_buffer.seek(0, 2)  # 2 == SEEK_END
+
+    def reset_cql_frame_buffer(self):
+        if self.is_checksumming_enabled:
+            self._cql_frame_buffer = io.BytesIO(self._cql_frame_buffer.read())
+            self._cql_frame_buffer.seek(0, 2)  # 2 == SEEK_END
+        else:
+            self.reset_io_buffer()
+
+
+class Connection(object):
+
+    CALLBACK_ERR_THREAD_THRESHOLD = 100
+
+    in_buffer_size = 4096
+    out_buffer_size = 4096
+
+    cql_version = None
+    no_compact = False
+    protocol_version = ProtocolVersion.MAX_SUPPORTED
+
+    keyspace = None
+    compression = True
+    _compression_type = None
+    compressor = None
+    decompressor = None
+
+    endpoint = None
+    ssl_options = None
+    ssl_context = None
+    last_error = None
+
+    # The current number of operations that are in flight. More precisely,
+    # the number of request IDs that are currently in use.
+    # This includes orphaned requests.
+    in_flight = 0
+
+    # Max concurrent requests allowed per connection. This is set optimistically high, allowing
+    # all request ids to be used in protocol version 3+. Normally concurrency would be controlled
+    # at a higher level by the application or concurrent.execute_concurrent. This attribute
+    # is for lower-level integrations that want some upper bound without reimplementing.
+    max_in_flight = 2 ** 15
+
+    # A set of available request IDs.  When using the v3 protocol or higher,
+    # this will not initially include all request IDs in order to save memory,
+    # but the set will grow if it is exhausted.
+    request_ids = None
+
+    # Tracks the highest used request ID in order to help with growing the
+    # request_ids set
+    highest_request_id = 0
+
+    # Tracks the request IDs which are no longer waited on (timed out), but
+    # cannot be reused yet because the node might still send a response
+    # on this stream
+    orphaned_request_ids = None
+
+    # Set to true if the orphaned stream ID count cross configured threshold
+    # and the connection will be replaced
+    orphaned_threshold_reached = False
+
+    # If the number of orphaned streams reaches this threshold, this connection
+    # will become marked and will be replaced with a new connection by the
+    # owning pool (currently, only HostConnection supports this)
+    orphaned_threshold = 3  * max_in_flight // 4
+
+    is_defunct = False
+    is_closed = False
+    lock = None
+    user_type_map = None
+
+    msg_received = False
+
+    is_unsupported_proto_version = False
+
+    is_control_connection = False
+    signaled_error = False  # used for flagging at the pool level
+
+    allow_beta_protocol_version = False
+
+    _current_frame = None
+
+    _socket = None
+
+    _socket_impl = socket
+
+    _check_hostname = False
+    _product_type = None
+
+    _is_checksumming_enabled = False
+
+    _on_orphaned_stream_released = None
+
+    @property
+    def _iobuf(self):
+        # backward compatibility, to avoid any change in the reactors
+        return self._io_buffer.io_buffer
+
+    def __init__(self, host='127.0.0.1', port=9042, authenticator=None,
+                 ssl_options=None, sockopts=None, compression=True,
+                 cql_version=None, protocol_version=ProtocolVersion.MAX_SUPPORTED, is_control_connection=False,
+                 user_type_map=None, connect_timeout=None, allow_beta_protocol_version=False, no_compact=False,
+                 ssl_context=None, on_orphaned_stream_released=None):
+
+        # TODO next major rename host to endpoint and remove port kwarg.
+        self.endpoint = host if isinstance(host, EndPoint) else DefaultEndPoint(host, port)
+
+        self.authenticator = authenticator
+        self.ssl_options = ssl_options.copy() if ssl_options else {}
+        self.ssl_context = ssl_context
+        self.sockopts = sockopts
+        self.compression = compression
+        self.cql_version = cql_version
+        self.protocol_version = protocol_version
+        self.is_control_connection = is_control_connection
+        self.user_type_map = user_type_map
+        self.connect_timeout = connect_timeout
+        self.allow_beta_protocol_version = allow_beta_protocol_version
+        self.no_compact = no_compact
+        self._push_watchers = defaultdict(set)
+        self._requests = {}
+        self._io_buffer = _ConnectionIOBuffer(self)
+        self._continuous_paging_sessions = {}
+        self._socket_writable = True
+        self.orphaned_request_ids = set()
+        self._on_orphaned_stream_released = on_orphaned_stream_released
+
+        if ssl_options:
+            self.ssl_options.update(self.endpoint.ssl_options or {})
+        elif self.endpoint.ssl_options:
+            self.ssl_options = self.endpoint.ssl_options
+
+        # PYTHON-1331
+        #
+        # We always use SSLContext.wrap_socket() now but legacy configs may have other params that were passed to ssl.wrap_socket()...
+        # and either could have 'check_hostname'.  Remove these params into a separate map and use them to build an SSLContext if
+        # we need to do so.
+        #
+        # Note the use of pop() here; we are very deliberately removing these params from ssl_options if they're present.  After this
+        # operation ssl_options should contain only args needed for the ssl_context.wrap_socket() call.
+        if not self.ssl_context and self.ssl_options:
+            self.ssl_context = self._build_ssl_context_from_options()
+
+        if protocol_version >= 3:
+            self.max_request_id = min(self.max_in_flight - 1, (2 ** 15) - 1)
+            # Don't fill the deque with 2**15 items right away. Start with some and add
+            # more if needed.
+            initial_size = min(300, self.max_in_flight)
+            self.request_ids = deque(range(initial_size))
+            self.highest_request_id = initial_size - 1
+        else:
+            self.max_request_id = min(self.max_in_flight, (2 ** 7) - 1)
+            self.request_ids = deque(range(self.max_request_id + 1))
+            self.highest_request_id = self.max_request_id
+
+        self.lock = RLock()
+        self.connected_event = Event()
+
+    @property
+    def host(self):
+        return self.endpoint.address
+
+    @property
+    def port(self):
+        return self.endpoint.port
+
+    @classmethod
+    def initialize_reactor(cls):
+        """
+        Called once by Cluster.connect().  This should be used by implementations
+        to set up any resources that will be shared across connections.
+        """
+        pass
+
+    @classmethod
+    def handle_fork(cls):
+        """
+        Called after a forking.  This should cleanup any remaining reactor state
+        from the parent process.
+        """
+        pass
+
+    @classmethod
+    def create_timer(cls, timeout, callback):
+        raise NotImplementedError()
+
+    @classmethod
+    def factory(cls, endpoint, timeout, *args, **kwargs):
+        """
+        A factory function which returns connections which have
+        succeeded in connecting and are ready for service (or
+        raises an exception otherwise).
+        """
+        start = time.time()
+        kwargs['connect_timeout'] = timeout
+        conn = cls(endpoint, *args, **kwargs)
+        elapsed = time.time() - start
+        conn.connected_event.wait(timeout - elapsed)
+        if conn.last_error:
+            if conn.is_unsupported_proto_version:
+                raise ProtocolVersionUnsupported(endpoint, conn.protocol_version)
+            raise conn.last_error
+        elif not conn.connected_event.is_set():
+            conn.close()
+            raise OperationTimedOut("Timed out creating connection (%s seconds)" % timeout)
+        else:
+            return conn
+
+    def _build_ssl_context_from_options(self):
+
+        # Extract a subset of names from self.ssl_options which apply to SSLContext creation
+        ssl_context_opt_names = ['ssl_version', 'cert_reqs', 'check_hostname', 'keyfile', 'certfile', 'ca_certs', 'ciphers']
+        opts = {k:self.ssl_options.get(k, None) for k in ssl_context_opt_names if k in self.ssl_options}
+
+        # Python >= 3.10 requires either PROTOCOL_TLS_CLIENT or PROTOCOL_TLS_SERVER so we'll get ahead of things by always
+        # being explicit
+        ssl_version = opts.get('ssl_version', None) or ssl.PROTOCOL_TLS_CLIENT
+        cert_reqs = opts.get('cert_reqs', None) or ssl.CERT_REQUIRED
+        rv = ssl.SSLContext(protocol=int(ssl_version))
+        rv.check_hostname = bool(opts.get('check_hostname', False))
+        rv.options = int(cert_reqs)
+
+        certfile = opts.get('certfile', None)
+        keyfile = opts.get('keyfile', None)
+        if certfile:
+            rv.load_cert_chain(certfile, keyfile)
+        ca_certs = opts.get('ca_certs', None)
+        if ca_certs:
+            rv.load_verify_locations(ca_certs)
+        ciphers = opts.get('ciphers', None)
+        if ciphers:
+            rv.set_ciphers(ciphers)
+
+        return rv
+
+    def _wrap_socket_from_context(self):
+
+        # Extract a subset of names from self.ssl_options which apply to SSLContext.wrap_socket (or at least the parts
+        # of it that don't involve building an SSLContext under the covers)
+        wrap_socket_opt_names = ['server_side', 'do_handshake_on_connect', 'suppress_ragged_eofs', 'server_hostname']
+        opts = {k:self.ssl_options.get(k, None) for k in wrap_socket_opt_names if k in self.ssl_options}
+
+        # PYTHON-1186: set the server_hostname only if the SSLContext has
+        # check_hostname enabled and it is not already provided by the EndPoint ssl options
+        #opts['server_hostname'] = self.endpoint.address
+        if (self.ssl_context.check_hostname and 'server_hostname' not in opts):
+            server_hostname = self.endpoint.address
+            opts['server_hostname'] = server_hostname
+
+        return self.ssl_context.wrap_socket(self._socket, **opts)
+
+    def _initiate_connection(self, sockaddr):
+        self._socket.connect(sockaddr)
+
+    # PYTHON-1331
+    #
+    # Allow implementations specific to an event loop to add additional behaviours
+    def _validate_hostname(self):
+        pass
+
+    def _get_socket_addresses(self):
+        address, port = self.endpoint.resolve()
+
+        if hasattr(socket, 'AF_UNIX') and self.endpoint.socket_family == socket.AF_UNIX:
+            return [(socket.AF_UNIX, socket.SOCK_STREAM, 0, None, address)]
+
+        addresses = socket.getaddrinfo(address, port, self.endpoint.socket_family, socket.SOCK_STREAM)
+        if not addresses:
+            raise ConnectionException("getaddrinfo returned empty list for %s" % (self.endpoint,))
+
+        return addresses
+
+    def _connect_socket(self):
+        sockerr = None
+        addresses = self._get_socket_addresses()
+        for (af, socktype, proto, _, sockaddr) in addresses:
+            try:
+                self._socket = self._socket_impl.socket(af, socktype, proto)
+                if self.ssl_context:
+                    self._socket = self._wrap_socket_from_context()
+                self._socket.settimeout(self.connect_timeout)
+                self._initiate_connection(sockaddr)
+                self._socket.settimeout(None)
+
+                # PYTHON-1331
+                #
+                # Most checking is done via the check_hostname param on the SSLContext.
+                # Subclasses can add additional behaviours via _validate_hostname() so
+                # run that here.
+                if self._check_hostname:
+                    self._validate_hostname()
+                sockerr = None
+                break
+            except socket.error as err:
+                if self._socket:
+                    self._socket.close()
+                    self._socket = None
+                sockerr = err
+
+        if sockerr:
+            raise socket.error(sockerr.errno, "Tried connecting to %s. Last error: %s" %
+                               ([a[4] for a in addresses], sockerr.strerror or sockerr))
+
+        if self.sockopts:
+            for args in self.sockopts:
+                self._socket.setsockopt(*args)
+
+    def _enable_compression(self):
+        if self._compressor:
+            self.compressor = self._compressor
+
+    def _enable_checksumming(self):
+        self._io_buffer.set_checksumming_buffer()
+        self._is_checksumming_enabled = True
+        self._segment_codec = segment_codec_lz4 if self.compressor else segment_codec_no_compression
+        log.debug("Enabling protocol checksumming on connection (%s).", id(self))
+
+    def close(self):
+        raise NotImplementedError()
+
+    def defunct(self, exc):
+        with self.lock:
+            if self.is_defunct or self.is_closed:
+                return
+            self.is_defunct = True
+
+        exc_info = sys.exc_info()
+        # if we are not handling an exception, just use the passed exception, and don't try to format exc_info with the message
+        if any(exc_info):
+            log.debug("Defuncting connection (%s) to %s:",
+                      id(self), self.endpoint, exc_info=exc_info)
+        else:
+            log.debug("Defuncting connection (%s) to %s: %s",
+                      id(self), self.endpoint, exc)
+
+        self.last_error = exc
+        self.close()
+        self.error_all_cp_sessions(exc)
+        self.error_all_requests(exc)
+        self.connected_event.set()
+        return exc
+
+    def error_all_cp_sessions(self, exc):
+        stream_ids = list(self._continuous_paging_sessions.keys())
+        for stream_id in stream_ids:
+            self._continuous_paging_sessions[stream_id].on_error(exc)
+
+    def error_all_requests(self, exc):
+        with self.lock:
+            requests = self._requests
+            self._requests = {}
+
+        if not requests:
+            return
+
+        new_exc = ConnectionShutdown(str(exc))
+
+        def try_callback(cb):
+            try:
+                cb(new_exc)
+            except Exception:
+                log.warning("Ignoring unhandled exception while erroring requests for a "
+                            "failed connection (%s) to host %s:",
+                            id(self), self.endpoint, exc_info=True)
+
+        # run first callback from this thread to ensure pool state before leaving
+        cb, _, _ = requests.popitem()[1]
+        try_callback(cb)
+
+        if not requests:
+            return
+
+        # additional requests are optionally errored from a separate thread
+        # The default callback and retry logic is fairly expensive -- we don't
+        # want to tie up the event thread when there are many requests
+        def err_all_callbacks():
+            for cb, _, _ in requests.values():
+                try_callback(cb)
+        if len(requests) < Connection.CALLBACK_ERR_THREAD_THRESHOLD:
+            err_all_callbacks()
+        else:
+            # daemon thread here because we want to stay decoupled from the cluster TPE
+            # TODO: would it make sense to just have a driver-global TPE?
+            t = Thread(target=err_all_callbacks)
+            t.daemon = True
+            t.start()
+
+    def get_request_id(self):
+        """
+        This must be called while self.lock is held.
+        """
+        try:
+            return self.request_ids.popleft()
+        except IndexError:
+            new_request_id = self.highest_request_id + 1
+            # in_flight checks should guarantee this
+            assert new_request_id <= self.max_request_id
+            self.highest_request_id = new_request_id
+            return self.highest_request_id
+
+    def handle_pushed(self, response):
+        log.debug("Message pushed from server: %r", response)
+        for cb in self._push_watchers.get(response.event_type, []):
+            try:
+                cb(response.event_args)
+            except Exception:
+                log.exception("Pushed event handler errored, ignoring:")
+
+    def send_msg(self, msg, request_id, cb, encoder=ProtocolHandler.encode_message, decoder=ProtocolHandler.decode_message, result_metadata=None):
+        if self.is_defunct:
+            raise ConnectionShutdown("Connection to %s is defunct" % self.endpoint)
+        elif self.is_closed:
+            raise ConnectionShutdown("Connection to %s is closed" % self.endpoint)
+        elif not self._socket_writable:
+            raise ConnectionBusy("Connection %s is overloaded" % self.endpoint)
+
+        # queue the decoder function with the request
+        # this allows us to inject custom functions per request to encode, decode messages
+        self._requests[request_id] = (cb, decoder, result_metadata)
+        msg = encoder(msg, request_id, self.protocol_version, compressor=self.compressor,
+                      allow_beta_protocol_version=self.allow_beta_protocol_version)
+
+        if self._is_checksumming_enabled:
+            buffer = io.BytesIO()
+            self._segment_codec.encode(buffer, msg)
+            msg = buffer.getvalue()
+
+        self.push(msg)
+        return len(msg)
+
+    def wait_for_response(self, msg, timeout=None, **kwargs):
+        return self.wait_for_responses(msg, timeout=timeout, **kwargs)[0]
+
+    def wait_for_responses(self, *msgs, **kwargs):
+        """
+        Returns a list of (success, response) tuples.  If success
+        is False, response will be an Exception.  Otherwise, response
+        will be the normal query response.
+
+        If fail_on_error was left as True and one of the requests
+        failed, the corresponding Exception will be raised.
+        """
+        if self.is_closed or self.is_defunct:
+            raise ConnectionShutdown("Connection %s is already closed" % (self, ))
+        timeout = kwargs.get('timeout')
+        fail_on_error = kwargs.get('fail_on_error', True)
+        waiter = ResponseWaiter(self, len(msgs), fail_on_error)
+
+        # busy wait for sufficient space on the connection
+        messages_sent = 0
+        while True:
+            needed = len(msgs) - messages_sent
+            with self.lock:
+                available = min(needed, self.max_request_id - self.in_flight + 1)
+                request_ids = [self.get_request_id() for _ in range(available)]
+                self.in_flight += available
+
+            for i, request_id in enumerate(request_ids):
+                self.send_msg(msgs[messages_sent + i],
+                              request_id,
+                              partial(waiter.got_response, index=messages_sent + i))
+            messages_sent += available
+
+            if messages_sent == len(msgs):
+                break
+            else:
+                if timeout is not None:
+                    timeout -= 0.01
+                    if timeout <= 0.0:
+                        raise OperationTimedOut()
+                time.sleep(0.01)
+
+        try:
+            return waiter.deliver(timeout)
+        except OperationTimedOut:
+            raise
+        except Exception as exc:
+            self.defunct(exc)
+            raise
+
+    def register_watcher(self, event_type, callback, register_timeout=None):
+        """
+        Register a callback for a given event type.
+        """
+        self._push_watchers[event_type].add(callback)
+        self.wait_for_response(
+            RegisterMessage(event_list=[event_type]),
+            timeout=register_timeout)
+
+    def register_watchers(self, type_callback_dict, register_timeout=None):
+        """
+        Register multiple callback/event type pairs, expressed as a dict.
+        """
+        for event_type, callback in type_callback_dict.items():
+            self._push_watchers[event_type].add(callback)
+        self.wait_for_response(
+            RegisterMessage(event_list=type_callback_dict.keys()),
+            timeout=register_timeout)
+
+    def control_conn_disposed(self):
+        self.is_control_connection = False
+        self._push_watchers = {}
+
+    @defunct_on_error
+    def _read_frame_header(self):
+        buf = self._io_buffer.cql_frame_buffer.getvalue()
+        pos = len(buf)
+        if pos:
+            version = buf[0] & PROTOCOL_VERSION_MASK
+            if version not in ProtocolVersion.SUPPORTED_VERSIONS:
+                raise ProtocolError("This version of the driver does not support protocol version %d" % version)
+            frame_header = frame_header_v3 if version >= 3 else frame_header_v1_v2
+            # this frame header struct is everything after the version byte
+            header_size = frame_header.size + 1
+            if pos >= header_size:
+                flags, stream, op, body_len = frame_header.unpack_from(buf, 1)
+                if body_len < 0:
+                    raise ProtocolError("Received negative body length: %r" % body_len)
+                self._current_frame = _Frame(version, flags, stream, op, header_size, body_len + header_size)
+        return pos
+
+    @defunct_on_error
+    def _process_segment_buffer(self):
+        readable_bytes = self._io_buffer.readable_io_bytes()
+        if readable_bytes >= self._segment_codec.header_length_with_crc:
+            try:
+                self._io_buffer.io_buffer.seek(0)
+                segment_header = self._segment_codec.decode_header(self._io_buffer.io_buffer)
+
+                if readable_bytes >= segment_header.segment_length:
+                    segment = self._segment_codec.decode(self._iobuf, segment_header)
+                    self._io_buffer._segment_consumed = True
+                    self._io_buffer.cql_frame_buffer.write(segment.payload)
+                else:
+                    # not enough data to read the segment. reset the buffer pointer at the
+                    # beginning to not lose what we previously read (header).
+                    self._io_buffer._segment_consumed = False
+                    self._io_buffer.io_buffer.seek(0)
+            except CrcException as exc:
+                # re-raise an exception that inherits from ConnectionException
+                raise CrcMismatchException(str(exc), self.endpoint)
+        else:
+            self._io_buffer._segment_consumed = False
+
+    def process_io_buffer(self):
+        while True:
+            if self._is_checksumming_enabled and self._io_buffer.readable_io_bytes():
+                self._process_segment_buffer()
+                self._io_buffer.reset_io_buffer()
+
+            if self._is_checksumming_enabled and not self._io_buffer.has_consumed_segment:
+                # We couldn't read an entire segment from the io buffer, so return
+                # control to allow more bytes to be read off the wire
+                return
+
+            if not self._current_frame:
+                pos = self._read_frame_header()
+            else:
+                pos = self._io_buffer.readable_cql_frame_bytes()
+
+            if not self._current_frame or pos < self._current_frame.end_pos:
+                if self._is_checksumming_enabled and self._io_buffer.readable_io_bytes():
+                    # We have a multi-segments message and we need to read more
+                    # data to complete the current cql frame
+                    continue
+
+                # we don't have a complete header yet or we
+                # already saw a header, but we don't have a
+                # complete message yet
+                return
+            else:
+                frame = self._current_frame
+                self._io_buffer.cql_frame_buffer.seek(frame.body_offset)
+                msg = self._io_buffer.cql_frame_buffer.read(frame.end_pos - frame.body_offset)
+                self.process_msg(frame, msg)
+                self._io_buffer.reset_cql_frame_buffer()
+                self._current_frame = None
+
+    @defunct_on_error
+    def process_msg(self, header, body):
+        self.msg_received = True
+        stream_id = header.stream
+        if stream_id < 0:
+            callback = None
+            decoder = ProtocolHandler.decode_message
+            result_metadata = None
+        else:
+            if stream_id in self._continuous_paging_sessions:
+                paging_session = self._continuous_paging_sessions[stream_id]
+                callback = paging_session.on_message
+                decoder = paging_session.decoder
+                result_metadata = None
+            else:
+                need_notify_of_release = False
+                with self.lock:
+                    if stream_id in self.orphaned_request_ids:
+                        self.in_flight -= 1
+                        self.orphaned_request_ids.remove(stream_id)
+                        need_notify_of_release = True
+                if need_notify_of_release and self._on_orphaned_stream_released:
+                    self._on_orphaned_stream_released()
+
+                try:
+                    callback, decoder, result_metadata = self._requests.pop(stream_id)
+                # This can only happen if the stream_id was
+                # removed due to an OperationTimedOut
+                except KeyError:
+                    with self.lock:
+                        self.request_ids.append(stream_id)
+                    return
+
+        try:
+            response = decoder(header.version, self.user_type_map, stream_id,
+                               header.flags, header.opcode, body, self.decompressor, result_metadata)
+        except Exception as exc:
+            log.exception("Error decoding response from Cassandra. "
+                          "%s; buffer: %r", header, self._iobuf.getvalue())
+            if callback is not None:
+                callback(exc)
+            self.defunct(exc)
+            return
+
+        try:
+            if stream_id >= 0:
+                if isinstance(response, ProtocolException):
+                    if 'unsupported protocol version' in response.message:
+                        self.is_unsupported_proto_version = True
+                    else:
+                        log.error("Closing connection %s due to protocol error: %s", self, response.summary_msg())
+                    self.defunct(response)
+                if callback is not None:
+                    callback(response)
+            else:
+                self.handle_pushed(response)
+        except Exception:
+            log.exception("Callback handler errored, ignoring:")
+
+        # done after callback because the callback might signal this as a paging session
+        if stream_id >= 0:
+            if stream_id in self._continuous_paging_sessions:
+                if self._continuous_paging_sessions[stream_id].released:
+                    self.remove_continuous_paging_session(stream_id)
+            else:
+                with self.lock:
+                    self.request_ids.append(stream_id)
+
+    def new_continuous_paging_session(self, stream_id, decoder, row_factory, state):
+        session = ContinuousPagingSession(stream_id, decoder, row_factory, self, state)
+        self._continuous_paging_sessions[stream_id] = session
+        return session
+
+    def remove_continuous_paging_session(self, stream_id):
+        try:
+            self._continuous_paging_sessions.pop(stream_id)
+            with self.lock:
+                log.debug("Returning cp session stream id %s", stream_id)
+                self.request_ids.append(stream_id)
+        except KeyError:
+            pass
+
+    @defunct_on_error
+    def _send_options_message(self):
+        log.debug("Sending initial options message for new connection (%s) to %s", id(self), self.endpoint)
+        self.send_msg(OptionsMessage(), self.get_request_id(), self._handle_options_response)
+
+    @defunct_on_error
+    def _handle_options_response(self, options_response):
+        if self.is_defunct:
+            return
+
+        if not isinstance(options_response, SupportedMessage):
+            if isinstance(options_response, ConnectionException):
+                raise options_response
+            else:
+                log.error("Did not get expected SupportedMessage response; "
+                          "instead, got: %s", options_response)
+                raise ConnectionException("Did not get expected SupportedMessage "
+                                          "response; instead, got: %s"
+                                          % (options_response,))
+
+        log.debug("Received options response on new connection (%s) from %s",
+                  id(self), self.endpoint)
+        supported_cql_versions = options_response.cql_versions
+        remote_supported_compressions = options_response.options['COMPRESSION']
+        self._product_type = options_response.options.get('PRODUCT_TYPE', [None])[0]
+
+        if self.cql_version:
+            if self.cql_version not in supported_cql_versions:
+                raise ProtocolError(
+                    "cql_version %r is not supported by remote (w/ native "
+                    "protocol). Supported versions: %r"
+                    % (self.cql_version, supported_cql_versions))
+        else:
+            self.cql_version = supported_cql_versions[0]
+
+        self._compressor = None
+        compression_type = None
+        if self.compression:
+            overlap = (set(locally_supported_compressions.keys()) &
+                       set(remote_supported_compressions))
+            if len(overlap) == 0:
+                log.debug("No available compression types supported on both ends."
+                          " locally supported: %r. remotely supported: %r",
+                          locally_supported_compressions.keys(),
+                          remote_supported_compressions)
+            else:
+                compression_type = None
+                if isinstance(self.compression, str):
+                    # the user picked a specific compression type ('snappy' or 'lz4')
+                    if self.compression not in remote_supported_compressions:
+                        raise ProtocolError(
+                            "The requested compression type (%s) is not supported by the Cassandra server at %s"
+                            % (self.compression, self.endpoint))
+                    compression_type = self.compression
+                else:
+                    # our locally supported compressions are ordered to prefer
+                    # lz4, if available
+                    for k in locally_supported_compressions.keys():
+                        if k in overlap:
+                            compression_type = k
+                            break
+
+                # If snappy compression is selected with v5+checksumming, the connection
+                # will fail with OTO. Only lz4 is supported
+                if (compression_type == 'snappy' and
+                        ProtocolVersion.has_checksumming_support(self.protocol_version)):
+                    log.debug("Snappy compression is not supported with protocol version %s and "
+                              "checksumming. Consider installing lz4. Disabling compression.", self.protocol_version)
+                    compression_type = None
+                else:
+                    # set the decompressor here, but set the compressor only after
+                    # a successful Ready message
+                    self._compression_type = compression_type
+                    self._compressor, self.decompressor = \
+                        locally_supported_compressions[compression_type]
+
+        self._send_startup_message(compression_type, no_compact=self.no_compact)
+
+    @defunct_on_error
+    def _send_startup_message(self, compression=None, no_compact=False):
+        log.debug("Sending StartupMessage on %s", self)
+        opts = {'DRIVER_NAME': DRIVER_NAME,
+                'DRIVER_VERSION': DRIVER_VERSION}
+        if compression:
+            opts['COMPRESSION'] = compression
+        if no_compact:
+            opts['NO_COMPACT'] = 'true'
+        sm = StartupMessage(cqlversion=self.cql_version, options=opts)
+        self.send_msg(sm, self.get_request_id(), cb=self._handle_startup_response)
+        log.debug("Sent StartupMessage on %s", self)
+
+    @defunct_on_error
+    def _handle_startup_response(self, startup_response, did_authenticate=False):
+        if self.is_defunct:
+            return
+
+        if isinstance(startup_response, ReadyMessage):
+            if self.authenticator:
+                log.warning("An authentication challenge was not sent, "
+                            "this is suspicious because the driver expects "
+                            "authentication (configured authenticator = %s)",
+                            self.authenticator.__class__.__name__)
+
+            log.debug("Got ReadyMessage on new connection (%s) from %s", id(self), self.endpoint)
+            self._enable_compression()
+
+            if ProtocolVersion.has_checksumming_support(self.protocol_version):
+                self._enable_checksumming()
+
+            self.connected_event.set()
+        elif isinstance(startup_response, AuthenticateMessage):
+            log.debug("Got AuthenticateMessage on new connection (%s) from %s: %s",
+                      id(self), self.endpoint, startup_response.authenticator)
+
+            if self.authenticator is None:
+                log.error("Failed to authenticate to %s. If you are trying to connect to a DSE cluster, "
+                          "consider using TransitionalModePlainTextAuthProvider "
+                          "if DSE authentication is configured with transitional mode" % (self.host,))
+                raise AuthenticationFailed('Remote end requires authentication')
+
+            self._enable_compression()
+            if ProtocolVersion.has_checksumming_support(self.protocol_version):
+                self._enable_checksumming()
+
+            if isinstance(self.authenticator, dict):
+                log.debug("Sending credentials-based auth response on %s", self)
+                cm = CredentialsMessage(creds=self.authenticator)
+                callback = partial(self._handle_startup_response, did_authenticate=True)
+                self.send_msg(cm, self.get_request_id(), cb=callback)
+            else:
+                log.debug("Sending SASL-based auth response on %s", self)
+                self.authenticator.server_authenticator_class = startup_response.authenticator
+                initial_response = self.authenticator.initial_response()
+                initial_response = "" if initial_response is None else initial_response
+                self.send_msg(AuthResponseMessage(initial_response), self.get_request_id(),
+                              self._handle_auth_response)
+        elif isinstance(startup_response, ErrorMessage):
+            log.debug("Received ErrorMessage on new connection (%s) from %s: %s",
+                      id(self), self.endpoint, startup_response.summary_msg())
+            if did_authenticate:
+                raise AuthenticationFailed(
+                    "Failed to authenticate to %s: %s" %
+                    (self.endpoint, startup_response.summary_msg()))
+            else:
+                raise ConnectionException(
+                    "Failed to initialize new connection to %s: %s"
+                    % (self.endpoint, startup_response.summary_msg()))
+        elif isinstance(startup_response, ConnectionShutdown):
+            log.debug("Connection to %s was closed during the startup handshake", (self.endpoint))
+            raise startup_response
+        else:
+            msg = "Unexpected response during Connection setup: %r"
+            log.error(msg, startup_response)
+            raise ProtocolError(msg % (startup_response,))
+
+    @defunct_on_error
+    def _handle_auth_response(self, auth_response):
+        if self.is_defunct:
+            return
+
+        if isinstance(auth_response, AuthSuccessMessage):
+            log.debug("Connection %s successfully authenticated", self)
+            self.authenticator.on_authentication_success(auth_response.token)
+            if self._compressor:
+                self.compressor = self._compressor
+            self.connected_event.set()
+        elif isinstance(auth_response, AuthChallengeMessage):
+            response = self.authenticator.evaluate_challenge(auth_response.challenge)
+            msg = AuthResponseMessage("" if response is None else response)
+            log.debug("Responding to auth challenge on %s", self)
+            self.send_msg(msg, self.get_request_id(), self._handle_auth_response)
+        elif isinstance(auth_response, ErrorMessage):
+            log.debug("Received ErrorMessage on new connection (%s) from %s: %s",
+                      id(self), self.endpoint, auth_response.summary_msg())
+            raise AuthenticationFailed(
+                "Failed to authenticate to %s: %s" %
+                (self.endpoint, auth_response.summary_msg()))
+        elif isinstance(auth_response, ConnectionShutdown):
+            log.debug("Connection to %s was closed during the authentication process", self.endpoint)
+            raise auth_response
+        else:
+            msg = "Unexpected response during Connection authentication to %s: %r"
+            log.error(msg, self.endpoint, auth_response)
+            raise ProtocolError(msg % (self.endpoint, auth_response))
+
+    def set_keyspace_blocking(self, keyspace):
+        if not keyspace or keyspace == self.keyspace:
+            return
+
+        query = QueryMessage(query='USE "%s"' % (keyspace,),
+                             consistency_level=ConsistencyLevel.ONE)
+        try:
+            result = self.wait_for_response(query)
+        except InvalidRequestException as ire:
+            # the keyspace probably doesn't exist
+            raise ire.to_exception()
+        except Exception as exc:
+            conn_exc = ConnectionException(
+                "Problem while setting keyspace: %r" % (exc,), self.endpoint)
+            self.defunct(conn_exc)
+            raise conn_exc
+
+        if isinstance(result, ResultMessage):
+            self.keyspace = keyspace
+        else:
+            conn_exc = ConnectionException(
+                "Problem while setting keyspace: %r" % (result,), self.endpoint)
+            self.defunct(conn_exc)
+            raise conn_exc
+
+    def set_keyspace_async(self, keyspace, callback):
+        """
+        Use this in order to avoid deadlocking the event loop thread.
+        When the operation completes, `callback` will be called with
+        two arguments: this connection and an Exception if an error
+        occurred, otherwise :const:`None`.
+
+        This method will always increment :attr:`.in_flight` attribute, even if
+        it doesn't need to make a request, just to maintain an
+        ":attr:`.in_flight` is incremented" invariant.
+        """
+        # Here we increment in_flight unconditionally, whether we need to issue
+        # a request or not. This is bad, but allows callers -- specifically
+        # _set_keyspace_for_all_conns -- to assume that we increment
+        # self.in_flight during this call. This allows the passed callback to
+        # safely call HostConnection{Pool,}.return_connection on this
+        # Connection.
+        #
+        # We use a busy wait on the lock here because:
+        # - we'll only spin if the connection is at max capacity, which is very
+        #   unlikely for a set_keyspace call
+        # - it allows us to avoid signaling a condition every time a request completes
+        while True:
+            with self.lock:
+                if self.in_flight < self.max_request_id:
+                    self.in_flight += 1
+                    break
+            time.sleep(0.001)
+
+        if not keyspace or keyspace == self.keyspace:
+            callback(self, None)
+            return
+
+        query = QueryMessage(query='USE "%s"' % (keyspace,),
+                             consistency_level=ConsistencyLevel.ONE)
+
+        def process_result(result):
+            if isinstance(result, ResultMessage):
+                self.keyspace = keyspace
+                callback(self, None)
+            elif isinstance(result, InvalidRequestException):
+                callback(self, result.to_exception())
+            else:
+                callback(self, self.defunct(ConnectionException(
+                    "Problem while setting keyspace: %r" % (result,), self.endpoint)))
+
+        # We've incremented self.in_flight above, so we "have permission" to
+        # acquire a new request id
+        request_id = self.get_request_id()
+
+        self.send_msg(query, request_id, process_result)
+
+    @property
+    def is_idle(self):
+        return not self.msg_received
+
+    def reset_idle(self):
+        self.msg_received = False
+
+    def __str__(self):
+        status = ""
+        if self.is_defunct:
+            status = " (defunct)"
+        elif self.is_closed:
+            status = " (closed)"
+
+        return "<%s(%r) %s%s>" % (self.__class__.__name__, id(self), self.endpoint, status)
+    __repr__ = __str__
+
+
+class ResponseWaiter(object):
+
+    def __init__(self, connection, num_responses, fail_on_error):
+        self.connection = connection
+        self.pending = num_responses
+        self.fail_on_error = fail_on_error
+        self.error = None
+        self.responses = [None] * num_responses
+        self.event = Event()
+
+    def got_response(self, response, index):
+        with self.connection.lock:
+            self.connection.in_flight -= 1
+        if isinstance(response, Exception):
+            if hasattr(response, 'to_exception'):
+                response = response.to_exception()
+            if self.fail_on_error:
+                self.error = response
+                self.event.set()
+            else:
+                self.responses[index] = (False, response)
+        else:
+            if not self.fail_on_error:
+                self.responses[index] = (True, response)
+            else:
+                self.responses[index] = response
+
+        self.pending -= 1
+        if not self.pending:
+            self.event.set()
+
+    def deliver(self, timeout=None):
+        """
+        If fail_on_error was set to False, a list of (success, response)
+        tuples will be returned.  If success is False, response will be
+        an Exception.  Otherwise, response will be the normal query response.
+
+        If fail_on_error was left as True and one of the requests
+        failed, the corresponding Exception will be raised. Otherwise,
+        the normal response will be returned.
+        """
+        self.event.wait(timeout)
+        if self.error:
+            raise self.error
+        elif not self.event.is_set():
+            raise OperationTimedOut()
+        else:
+            return self.responses
+
+
+class HeartbeatFuture(object):
+    def __init__(self, connection, owner):
+        self._exception = None
+        self._event = Event()
+        self.connection = connection
+        self.owner = owner
+        log.debug("Sending options message heartbeat on idle connection (%s) %s",
+                  id(connection), connection.endpoint)
+        with connection.lock:
+            if connection.in_flight < connection.max_request_id:
+                connection.in_flight += 1
+                connection.send_msg(OptionsMessage(), connection.get_request_id(), self._options_callback)
+            else:
+                self._exception = Exception("Failed to send heartbeat because connection 'in_flight' exceeds threshold")
+                self._event.set()
+
+    def wait(self, timeout):
+        self._event.wait(timeout)
+        if self._event.is_set():
+            if self._exception:
+                raise self._exception
+        else:
+            raise OperationTimedOut("Connection heartbeat timeout after %s seconds" % (timeout,), self.connection.endpoint)
+
+    def _options_callback(self, response):
+        if isinstance(response, SupportedMessage):
+            log.debug("Received options response on connection (%s) from %s",
+                      id(self.connection), self.connection.endpoint)
+        else:
+            if isinstance(response, ConnectionException):
+                self._exception = response
+            else:
+                self._exception = ConnectionException("Received unexpected response to OptionsMessage: %s"
+                                                      % (response,))
+        self._event.set()
+
+
+class ConnectionHeartbeat(Thread):
+
+    def __init__(self, interval_sec, get_connection_holders, timeout):
+        Thread.__init__(self, name="Connection heartbeat")
+        self._interval = interval_sec
+        self._timeout = timeout
+        self._get_connection_holders = get_connection_holders
+        self._shutdown_event = Event()
+        self.daemon = True
+        self.start()
+
+    class ShutdownException(Exception):
+        pass
+
+    def run(self):
+        self._shutdown_event.wait(self._interval)
+        while not self._shutdown_event.is_set():
+            start_time = time.time()
+
+            futures = []
+            failed_connections = []
+            try:
+                for connections, owner in [(o.get_connections(), o) for o in self._get_connection_holders()]:
+                    for connection in connections:
+                        self._raise_if_stopped()
+                        if not (connection.is_defunct or connection.is_closed):
+                            if connection.is_idle:
+                                try:
+                                    futures.append(HeartbeatFuture(connection, owner))
+                                except Exception as e:
+                                    log.warning("Failed sending heartbeat message on connection (%s) to %s",
+                                                id(connection), connection.endpoint)
+                                    failed_connections.append((connection, owner, e))
+                            else:
+                                connection.reset_idle()
+                        else:
+                            log.debug("Cannot send heartbeat message on connection (%s) to %s",
+                                      id(connection), connection.endpoint)
+                            # make sure the owner sees this defunt/closed connection
+                            owner.return_connection(connection)
+                    self._raise_if_stopped()
+
+                # Wait max `self._timeout` seconds for all HeartbeatFutures to complete
+                timeout = self._timeout
+                start_time = time.time()
+                for f in futures:
+                    self._raise_if_stopped()
+                    connection = f.connection
+                    try:
+                        f.wait(timeout)
+                        # TODO: move this, along with connection locks in pool, down into Connection
+                        with connection.lock:
+                            connection.in_flight -= 1
+                        connection.reset_idle()
+                    except Exception as e:
+                        log.warning("Heartbeat failed for connection (%s) to %s",
+                                    id(connection), connection.endpoint)
+                        failed_connections.append((f.connection, f.owner, e))
+
+                    timeout = self._timeout - (time.time() - start_time)
+
+                for connection, owner, exc in failed_connections:
+                    self._raise_if_stopped()
+                    if not connection.is_control_connection:
+                        # Only HostConnection supports shutdown_on_error
+                        owner.shutdown_on_error = True
+                    connection.defunct(exc)
+                    owner.return_connection(connection)
+            except self.ShutdownException:
+                pass
+            except Exception:
+                log.error("Failed connection heartbeat", exc_info=True)
+
+            elapsed = time.time() - start_time
+            self._shutdown_event.wait(max(self._interval - elapsed, 0.01))
+
+    def stop(self):
+        self._shutdown_event.set()
+        self.join()
+
+    def _raise_if_stopped(self):
+        if self._shutdown_event.is_set():
+            raise self.ShutdownException()
+
+
+class Timer(object):
+
+    canceled = False
+
+    def __init__(self, timeout, callback):
+        self.end = time.time() + timeout
+        self.callback = callback
+
+    def __lt__(self, other):
+        return self.end < other.end
+
+    def cancel(self):
+        self.canceled = True
+
+    def finish(self, time_now):
+        if self.canceled:
+            return True
+
+        if time_now >= self.end:
+            self.callback()
+            return True
+
+        return False
+
+
+class TimerManager(object):
+
+    def __init__(self):
+        self._queue = []
+        self._new_timers = []
+
+    def add_timer(self, timer):
+        """
+        called from client thread with a Timer object
+        """
+        self._new_timers.append((timer.end, timer))
+
+    def service_timeouts(self):
+        """
+        run callbacks on all expired timers
+        Called from the event thread
+        :return: next end time, or None
+        """
+        queue = self._queue
+        if self._new_timers:
+            new_timers = self._new_timers
+            while new_timers:
+                heappush(queue, new_timers.pop())
+
+        if queue:
+            now = time.time()
+            while queue:
+                try:
+                    timer = queue[0][1]
+                    if timer.finish(now):
+                        heappop(queue)
+                    else:
+                        return timer.end
+                except Exception:
+                    log.exception("Exception while servicing timeout callback: ")
+
+    @property
+    def next_timeout(self):
+        try:
+            return self._queue[0][0]
+        except IndexError:
+            pass
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/__init__.py b/llm/Lib/site-packages/cassandra/cqlengine/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f973fc5f4d4870000d1759b2c8eca306a429a923
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cqlengine/__init__.py
@@ -0,0 +1,31 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Caching constants.
+CACHING_ALL = "ALL"
+CACHING_KEYS_ONLY = "KEYS_ONLY"
+CACHING_ROWS_ONLY = "ROWS_ONLY"
+CACHING_NONE = "NONE"
+
+
+class CQLEngineException(Exception):
+    pass
+
+
+class ValidationError(CQLEngineException):
+    pass
+
+
+class UnicodeMixin(object):
+    __str__ = lambda x: x.__unicode__()
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..521b2647db0275a3a870b67d7bcb6b4e9e6be8f2
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/columns.cpython-311.pyc b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/columns.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..95f53edc8f4883cd8670af25180b05cf632367fd
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/columns.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/connection.cpython-311.pyc b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/connection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4a073cad63e8921bcf4e658036ac37bd8e119b9d
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/connection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/functions.cpython-311.pyc b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7790e79b3309016c678cd1418e9557eecb462241
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/management.cpython-311.pyc b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/management.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5a4ddadeaa42e1c03c357396cb5cd6820075bb58
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/management.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/models.cpython-311.pyc b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/models.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fd23c52351c8006af6b42faa9d7f71a3542eff23
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/models.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/named.cpython-311.pyc b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/named.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e279358b2bbb9acc8b54bb7cabb85fdae699b8c2
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/named.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/operators.cpython-311.pyc b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/operators.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5f5373f7bebae2355d96fb2a5e1fa359e24719c8
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/operators.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/query.cpython-311.pyc b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/query.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eb919bd91f1d84e8f9cc2018a8708142e80dce0b
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/query.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/statements.cpython-311.pyc b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/statements.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aded2aec33d40d0065927e44d9691968cadb7ac1
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/statements.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/usertype.cpython-311.pyc b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/usertype.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..930967d89a9f85a2cd7ceba5c0b083bc5d9702e5
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cqlengine/__pycache__/usertype.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/columns.py b/llm/Lib/site-packages/cassandra/cqlengine/columns.py
new file mode 100644
index 0000000000000000000000000000000000000000..30b446ceefeacfb1ef9e035c5eaf0de5461e5824
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cqlengine/columns.py
@@ -0,0 +1,1078 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from copy import deepcopy, copy
+from datetime import date, datetime, timedelta
+import logging
+from uuid import UUID as _UUID
+
+from cassandra import util
+from cassandra.cqltypes import SimpleDateType, _cqltypes, UserType
+from cassandra.cqlengine import ValidationError
+from cassandra.cqlengine.functions import get_total_seconds
+from cassandra.util import Duration as _Duration
+
+log = logging.getLogger(__name__)
+
+
+class BaseValueManager(object):
+
+    def __init__(self, instance, column, value):
+        self.instance = instance
+        self.column = column
+        self.value = value
+        self.previous_value = None
+        self.explicit = False
+
+    @property
+    def deleted(self):
+        return self.column._val_is_null(self.value) and (self.explicit or not self.column._val_is_null(self.previous_value))
+
+    @property
+    def changed(self):
+        """
+        Indicates whether or not this value has changed.
+
+        :rtype: boolean
+
+        """
+        if self.explicit:
+            return self.value != self.previous_value
+
+        if isinstance(self.column, BaseContainerColumn):
+            default_value = self.column.get_default()
+            if self.column._val_is_null(default_value):
+                return not self.column._val_is_null(self.value) and self.value != self.previous_value
+            elif self.previous_value is None:
+                return self.value != default_value
+
+            return self.value != self.previous_value
+
+        return False
+
+    def reset_previous_value(self):
+        self.previous_value = deepcopy(self.value)
+
+    def getval(self):
+        return self.value
+
+    def setval(self, val):
+        self.value = val
+        self.explicit = True
+
+    def delval(self):
+        self.value = None
+
+    def get_property(self):
+        _get = lambda slf: self.getval()
+        _set = lambda slf, val: self.setval(val)
+        _del = lambda slf: self.delval()
+
+        if self.column.can_delete:
+            return property(_get, _set, _del)
+        else:
+            return property(_get, _set)
+
+
+class Column(object):
+
+    # the cassandra type this column maps to
+    db_type = None
+    value_manager = BaseValueManager
+
+    instance_counter = 0
+
+    _python_type_hashable = True
+
+    primary_key = False
+    """
+    bool flag, indicates this column is a primary key. The first primary key defined
+    on a model is the partition key (unless partition keys are set), all others are cluster keys
+    """
+
+    partition_key = False
+
+    """
+    indicates that this column should be the partition key, defining
+    more than one partition key column creates a compound partition key
+    """
+
+    index = False
+    """
+    bool flag, indicates an index should be created for this column
+    """
+
+    custom_index = False
+    """
+    bool flag, indicates an index is managed outside of cqlengine. This is
+    useful if you want to do filter queries on fields that have custom
+    indexes.
+    """
+
+    db_field = None
+    """
+    the fieldname this field will map to in the database
+    """
+
+    default = None
+    """
+    the default value, can be a value or a callable (no args)
+    """
+
+    required = False
+    """
+    boolean, is the field required? Model validation will raise and
+    exception if required is set to True and there is a None value assigned
+    """
+
+    clustering_order = None
+    """
+    only applicable on clustering keys (primary keys that are not partition keys)
+    determines the order that the clustering keys are sorted on disk
+    """
+
+    discriminator_column = False
+    """
+    boolean, if set to True, this column will be used for discriminating records
+    of inherited models.
+
+    Should only be set on a column of an abstract model being used for inheritance.
+
+    There may only be one discriminator column per model. See :attr:`~.__discriminator_value__`
+    for how to specify the value of this column on specialized models.
+    """
+
+    static = False
+    """
+    boolean, if set to True, this is a static column, with a single value per partition
+    """
+
+    def __init__(self,
+                 primary_key=False,
+                 partition_key=False,
+                 index=False,
+                 db_field=None,
+                 default=None,
+                 required=False,
+                 clustering_order=None,
+                 discriminator_column=False,
+                 static=False,
+                 custom_index=False):
+        self.partition_key = partition_key
+        self.primary_key = partition_key or primary_key
+        self.index = index
+        self.custom_index = custom_index
+        self.db_field = db_field
+        self.default = default
+        self.required = required
+        self.clustering_order = clustering_order
+        self.discriminator_column = discriminator_column
+
+        # the column name in the model definition
+        self.column_name = None
+        self._partition_key_index = None
+        self.static = static
+
+        self.value = None
+
+        # keep track of instantiation order
+        self.position = Column.instance_counter
+        Column.instance_counter += 1
+
+    def __ne__(self, other):
+        if isinstance(other, Column):
+            return self.position != other.position
+        return NotImplemented
+
+    def __eq__(self, other):
+        if isinstance(other, Column):
+            return self.position == other.position
+        return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, Column):
+            return self.position < other.position
+        return NotImplemented
+
+    def __le__(self, other):
+        if isinstance(other, Column):
+            return self.position <= other.position
+        return NotImplemented
+
+    def __gt__(self, other):
+        if isinstance(other, Column):
+            return self.position > other.position
+        return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, Column):
+            return self.position >= other.position
+        return NotImplemented
+
+    def __hash__(self):
+        return id(self)
+
+    def validate(self, value):
+        """
+        Returns a cleaned and validated value. Raises a ValidationError
+        if there's a problem
+        """
+        if value is None:
+            if self.required:
+                raise ValidationError('{0} - None values are not allowed'.format(self.column_name or self.db_field))
+        return value
+
+    def to_python(self, value):
+        """
+        Converts data from the database into python values
+        raises a ValidationError if the value can't be converted
+        """
+        return value
+
+    def to_database(self, value):
+        """
+        Converts python value into database value
+        """
+        return value
+
+    @property
+    def has_default(self):
+        return self.default is not None
+
+    @property
+    def is_primary_key(self):
+        return self.primary_key
+
+    @property
+    def can_delete(self):
+        return not self.primary_key
+
+    def get_default(self):
+        if self.has_default:
+            if callable(self.default):
+                return self.default()
+            else:
+                return self.default
+
+    def get_column_def(self):
+        """
+        Returns a column definition for CQL table definition
+        """
+        static = "static" if self.static else ""
+        return '{0} {1} {2}'.format(self.cql, self.db_type, static)
+
+    # TODO: make columns use cqltypes under the hood
+    # until then, this bridges the gap in using types along with cassandra.metadata for CQL generation
+    def cql_parameterized_type(self):
+        return self.db_type
+
+    def set_column_name(self, name):
+        """
+        Sets the column name during document class construction
+        This value will be ignored if db_field is set in __init__
+        """
+        self.column_name = name
+
+    @property
+    def db_field_name(self):
+        """ Returns the name of the cql name of this column """
+        return self.db_field if self.db_field is not None else self.column_name
+
+    @property
+    def db_index_name(self):
+        """ Returns the name of the cql index """
+        return 'index_{0}'.format(self.db_field_name)
+
+    @property
+    def has_index(self):
+        return self.index or self.custom_index
+
+    @property
+    def cql(self):
+        return self.get_cql()
+
+    def get_cql(self):
+        return '"{0}"'.format(self.db_field_name)
+
+    def _val_is_null(self, val):
+        """ determines if the given value equates to a null value for the given column type """
+        return val is None
+
+    @property
+    def sub_types(self):
+        return []
+
+    @property
+    def cql_type(self):
+        return _cqltypes[self.db_type]
+
+
+class Blob(Column):
+    """
+    Stores a raw binary value
+    """
+    db_type = 'blob'
+
+    def to_database(self, value):
+
+        if not isinstance(value, (bytes, bytearray)):
+            raise Exception("expecting a binary, got a %s" % type(value))
+
+        val = super(Bytes, self).to_database(value)
+        return bytearray(val)
+
+
+Bytes = Blob
+
+
+class Inet(Column):
+    """
+    Stores an IP address in IPv4 or IPv6 format
+    """
+    db_type = 'inet'
+
+
+class Text(Column):
+    """
+    Stores a UTF-8 encoded string
+    """
+    db_type = 'text'
+
+    def __init__(self, min_length=None, max_length=None, **kwargs):
+        """
+        :param int min_length: Sets the minimum length of this string, for validation purposes.
+            Defaults to 1 if this is a ``required`` column. Otherwise, None.
+        :param int max_length: Sets the maximum length of this string, for validation purposes.
+        """
+        self.min_length = (
+            1 if min_length is None and kwargs.get('required', False)
+            else min_length)
+        self.max_length = max_length
+
+        if self.min_length is not None:
+            if self.min_length < 0:
+                raise ValueError(
+                    'Minimum length is not allowed to be negative.')
+
+        if self.max_length is not None:
+            if self.max_length < 0:
+                raise ValueError(
+                    'Maximum length is not allowed to be negative.')
+
+        if self.min_length is not None and self.max_length is not None:
+            if self.max_length < self.min_length:
+                raise ValueError(
+                    'Maximum length must be greater or equal '
+                    'to minimum length.')
+
+        super(Text, self).__init__(**kwargs)
+
+    def validate(self, value):
+        value = super(Text, self).validate(value)
+        if not isinstance(value, (str, bytearray)) and value is not None:
+            raise ValidationError('{0} {1} is not a string'.format(self.column_name, type(value)))
+        if self.max_length is not None:
+            if value and len(value) > self.max_length:
+                raise ValidationError('{0} is longer than {1} characters'.format(self.column_name, self.max_length))
+        if self.min_length:
+            if (self.min_length and not value) or len(value) < self.min_length:
+                raise ValidationError('{0} is shorter than {1} characters'.format(self.column_name, self.min_length))
+        return value
+
+
+class Ascii(Text):
+    """
+    Stores a US-ASCII character string
+    """
+    db_type = 'ascii'
+
+    def validate(self, value):
+        """ Only allow ASCII and None values.
+
+        Check against US-ASCII, a.k.a. 7-bit ASCII, a.k.a. ISO646-US, a.k.a.
+        the Basic Latin block of the Unicode character set.
+
+        Source: https://github.com/apache/cassandra/blob
+        /3dcbe90e02440e6ee534f643c7603d50ca08482b/src/java/org/apache/cassandra
+        /serializers/AsciiSerializer.java#L29
+        """
+        value = super(Ascii, self).validate(value)
+        if value:
+            charset = value if isinstance(
+                value, (bytearray, )) else map(ord, value)
+            if not set(range(128)).issuperset(charset):
+                raise ValidationError(
+                    '{!r} is not an ASCII string.'.format(value))
+        return value
+
+
+class Integer(Column):
+    """
+    Stores a 32-bit signed integer value
+    """
+
+    db_type = 'int'
+
+    def validate(self, value):
+        val = super(Integer, self).validate(value)
+        if val is None:
+            return
+        try:
+            return int(val)
+        except (TypeError, ValueError):
+            raise ValidationError("{0} {1} can't be converted to integral value".format(self.column_name, value))
+
+    def to_python(self, value):
+        return self.validate(value)
+
+    def to_database(self, value):
+        return self.validate(value)
+
+
+class TinyInt(Integer):
+    """
+    Stores an 8-bit signed integer value
+
+    .. versionadded:: 2.6.0
+
+    requires C* 2.2+ and protocol v4+
+    """
+    db_type = 'tinyint'
+
+
+class SmallInt(Integer):
+    """
+    Stores a 16-bit signed integer value
+
+    .. versionadded:: 2.6.0
+
+    requires C* 2.2+ and protocol v4+
+    """
+    db_type = 'smallint'
+
+
+class BigInt(Integer):
+    """
+    Stores a 64-bit signed integer value
+    """
+    db_type = 'bigint'
+
+
+class VarInt(Column):
+    """
+    Stores an arbitrary-precision integer
+    """
+    db_type = 'varint'
+
+    def validate(self, value):
+        val = super(VarInt, self).validate(value)
+        if val is None:
+            return
+        try:
+            return int(val)
+        except (TypeError, ValueError):
+            raise ValidationError(
+                "{0} {1} can't be converted to integral value".format(self.column_name, value))
+
+    def to_python(self, value):
+        return self.validate(value)
+
+    def to_database(self, value):
+        return self.validate(value)
+
+
+class CounterValueManager(BaseValueManager):
+    def __init__(self, instance, column, value):
+        super(CounterValueManager, self).__init__(instance, column, value)
+        self.value = self.value or 0
+        self.previous_value = self.previous_value or 0
+
+
+class Counter(Integer):
+    """
+    Stores a counter that can be incremented and decremented
+    """
+    db_type = 'counter'
+
+    value_manager = CounterValueManager
+
+    def __init__(self,
+                 index=False,
+                 db_field=None,
+                 required=False):
+        super(Counter, self).__init__(
+            primary_key=False,
+            partition_key=False,
+            index=index,
+            db_field=db_field,
+            default=0,
+            required=required,
+        )
+
+
+class DateTime(Column):
+    """
+    Stores a datetime value
+    """
+    db_type = 'timestamp'
+
+    truncate_microseconds = False
+    """
+    Set this ``True`` to have model instances truncate the date, quantizing it in the same way it will be in the database.
+    This allows equality comparison between assigned values and values read back from the database::
+
+        DateTime.truncate_microseconds = True
+        assert Model.create(id=0, d=datetime.utcnow()) == Model.objects(id=0).first()
+
+    Defaults to ``False`` to preserve legacy behavior. May change in the future.
+    """
+
+    def to_python(self, value):
+        if value is None:
+            return
+        if isinstance(value, datetime):
+            if DateTime.truncate_microseconds:
+                us = value.microsecond
+                truncated_us = us // 1000 * 1000
+                return value - timedelta(microseconds=us - truncated_us)
+            else:
+                return value
+        elif isinstance(value, date):
+            return datetime(*(value.timetuple()[:6]))
+
+        return datetime.utcfromtimestamp(value)
+
+    def to_database(self, value):
+        value = super(DateTime, self).to_database(value)
+        if value is None:
+            return
+        if not isinstance(value, datetime):
+            if isinstance(value, date):
+                value = datetime(value.year, value.month, value.day)
+            else:
+                raise ValidationError("{0} '{1}' is not a datetime object".format(self.column_name, value))
+        epoch = datetime(1970, 1, 1, tzinfo=value.tzinfo)
+        offset = get_total_seconds(epoch.tzinfo.utcoffset(epoch)) if epoch.tzinfo else 0
+
+        return int((get_total_seconds(value - epoch) - offset) * 1000)
+
+
+class Date(Column):
+    """
+    Stores a simple date, with no time-of-day
+
+    .. versionchanged:: 2.6.0
+
+        removed overload of Date and DateTime. DateTime is a drop-in replacement for legacy models
+
+    requires C* 2.2+ and protocol v4+
+    """
+    db_type = 'date'
+
+    def to_database(self, value):
+        if value is None:
+            return
+
+        # need to translate to int version because some dates are not representable in
+        # string form (datetime limitation)
+        d = value if isinstance(value, util.Date) else util.Date(value)
+        return d.days_from_epoch + SimpleDateType.EPOCH_OFFSET_DAYS
+
+    def to_python(self, value):
+        if value is None:
+            return
+        if isinstance(value, util.Date):
+            return value
+        if isinstance(value, datetime):
+            value = value.date()
+        return util.Date(value)
+
+class Time(Column):
+    """
+    Stores a timezone-naive time-of-day, with nanosecond precision
+
+    .. versionadded:: 2.6.0
+
+    requires C* 2.2+ and protocol v4+
+    """
+    db_type = 'time'
+
+    def to_database(self, value):
+        value = super(Time, self).to_database(value)
+        if value is None:
+            return
+        # str(util.Time) yields desired CQL encoding
+        return value if isinstance(value, util.Time) else util.Time(value)
+
+    def to_python(self, value):
+        value = super(Time, self).to_database(value)
+        if value is None:
+            return
+        if isinstance(value, util.Time):
+            return value
+        return util.Time(value)
+
+class Duration(Column):
+    """
+    Stores a duration (months, days, nanoseconds)
+
+    .. versionadded:: 3.10.0
+
+    requires C* 3.10+ and protocol v4+
+    """
+    db_type = 'duration'
+
+    def validate(self, value):
+        val = super(Duration, self).validate(value)
+        if val is None:
+            return
+        if not isinstance(val, _Duration):
+            raise TypeError('{0} {1} is not a valid Duration.'.format(self.column_name, value))
+        return val
+
+
+class UUID(Column):
+    """
+    Stores a type 1 or 4 UUID
+    """
+    db_type = 'uuid'
+
+    def validate(self, value):
+        val = super(UUID, self).validate(value)
+        if val is None:
+            return
+        if isinstance(val, _UUID):
+            return val
+        if isinstance(val, str):
+            try:
+                return _UUID(val)
+            except ValueError:
+                # fall-through to error
+                pass
+        raise ValidationError("{0} {1} is not a valid uuid".format(
+            self.column_name, value))
+
+    def to_python(self, value):
+        return self.validate(value)
+
+    def to_database(self, value):
+        return self.validate(value)
+
+
+class TimeUUID(UUID):
+    """
+    UUID containing timestamp
+    """
+
+    db_type = 'timeuuid'
+
+
+class Boolean(Column):
+    """
+    Stores a boolean True or False value
+    """
+    db_type = 'boolean'
+
+    def validate(self, value):
+        """ Always returns a Python boolean. """
+        value = super(Boolean, self).validate(value)
+
+        if value is not None:
+            value = bool(value)
+
+        return value
+
+    def to_python(self, value):
+        return self.validate(value)
+
+
+class BaseFloat(Column):
+    def validate(self, value):
+        value = super(BaseFloat, self).validate(value)
+        if value is None:
+            return
+        try:
+            return float(value)
+        except (TypeError, ValueError):
+            raise ValidationError("{0} {1} is not a valid float".format(self.column_name, value))
+
+    def to_python(self, value):
+        return self.validate(value)
+
+    def to_database(self, value):
+        return self.validate(value)
+
+
+class Float(BaseFloat):
+    """
+    Stores a single-precision floating-point value
+    """
+    db_type = 'float'
+
+
+class Double(BaseFloat):
+    """
+    Stores a double-precision floating-point value
+    """
+    db_type = 'double'
+
+
+class Decimal(Column):
+    """
+    Stores a variable precision decimal value
+    """
+    db_type = 'decimal'
+
+    def validate(self, value):
+        from decimal import Decimal as _Decimal
+        from decimal import InvalidOperation
+        val = super(Decimal, self).validate(value)
+        if val is None:
+            return
+        try:
+            return _Decimal(repr(val)) if isinstance(val, float) else _Decimal(val)
+        except InvalidOperation:
+            raise ValidationError("{0} '{1}' can't be coerced to decimal".format(self.column_name, val))
+
+    def to_python(self, value):
+        return self.validate(value)
+
+    def to_database(self, value):
+        return self.validate(value)
+
+
+class BaseCollectionColumn(Column):
+    """
+    Base Container type for collection-like columns.
+
+    http://cassandra.apache.org/doc/cql3/CQL-3.0.html#collections
+    """
+    def __init__(self, types, **kwargs):
+        """
+        :param types: a sequence of sub types in this collection
+        """
+        instances = []
+        for t in types:
+            inheritance_comparator = issubclass if isinstance(t, type) else isinstance
+            if not inheritance_comparator(t, Column):
+                raise ValidationError("%s is not a column class" % (t,))
+            if t.db_type is None:
+                raise ValidationError("%s is an abstract type" % (t,))
+            inst = t() if isinstance(t, type) else t
+            if isinstance(t, BaseCollectionColumn):
+                inst._freeze_db_type()
+            instances.append(inst)
+
+        self.types = instances
+        super(BaseCollectionColumn, self).__init__(**kwargs)
+
+    def validate(self, value):
+        value = super(BaseCollectionColumn, self).validate(value)
+        # It is dangerous to let collections have more than 65535.
+        # See: https://issues.apache.org/jira/browse/CASSANDRA-5428
+        if value is not None and len(value) > 65535:
+            raise ValidationError("{0} Collection can't have more than 65535 elements.".format(self.column_name))
+        return value
+
+    def _val_is_null(self, val):
+        return not val
+
+    def _freeze_db_type(self):
+        if not self.db_type.startswith('frozen'):
+            self.db_type = "frozen<%s>" % (self.db_type,)
+
+    @property
+    def sub_types(self):
+        return self.types
+
+    @property
+    def cql_type(self):
+        return _cqltypes[self.__class__.__name__.lower()].apply_parameters([c.cql_type for c in self.types])
+
+
+class Tuple(BaseCollectionColumn):
+    """
+    Stores a fixed-length set of positional values
+
+    http://docs.datastax.com/en/cql/3.1/cql/cql_reference/tupleType.html
+    """
+    def __init__(self, *args, **kwargs):
+        """
+        :param args: column types representing tuple composition
+        """
+        if not args:
+            raise ValueError("Tuple must specify at least one inner type")
+        super(Tuple, self).__init__(args, **kwargs)
+        self.db_type = 'tuple<{0}>'.format(', '.join(typ.db_type for typ in self.types))
+
+    def validate(self, value):
+        val = super(Tuple, self).validate(value)
+        if val is None:
+            return
+        if len(val) > len(self.types):
+            raise ValidationError("Value %r has more fields than tuple definition (%s)" %
+                                  (val, ', '.join(t for t in self.types)))
+        return tuple(t.validate(v) for t, v in zip(self.types, val))
+
+    def to_python(self, value):
+        if value is None:
+            return tuple()
+        return tuple(t.to_python(v) for t, v in zip(self.types, value))
+
+    def to_database(self, value):
+        if value is None:
+            return
+        return tuple(t.to_database(v) for t, v in zip(self.types, value))
+
+
+class BaseContainerColumn(BaseCollectionColumn):
+    pass
+
+
+class Set(BaseContainerColumn):
+    """
+    Stores a set of unordered, unique values
+
+    http://www.datastax.com/documentation/cql/3.1/cql/cql_using/use_set_t.html
+    """
+
+    _python_type_hashable = False
+
+    def __init__(self, value_type, strict=True, default=set, **kwargs):
+        """
+        :param value_type: a column class indicating the types of the value
+        :param strict: sets whether non set values will be coerced to set
+            type on validation, or raise a validation error, defaults to True
+        """
+        self.strict = strict
+        super(Set, self).__init__((value_type,), default=default, **kwargs)
+        self.value_col = self.types[0]
+        if not self.value_col._python_type_hashable:
+            raise ValidationError("Cannot create a Set with unhashable value type (see PYTHON-494)")
+        self.db_type = 'set<{0}>'.format(self.value_col.db_type)
+
+    def validate(self, value):
+        val = super(Set, self).validate(value)
+        if val is None:
+            return
+        types = (set, util.SortedSet) if self.strict else (set, util.SortedSet, list, tuple)
+        if not isinstance(val, types):
+            if self.strict:
+                raise ValidationError('{0} {1} is not a set object'.format(self.column_name, val))
+            else:
+                raise ValidationError('{0} {1} cannot be coerced to a set object'.format(self.column_name, val))
+
+        if None in val:
+            raise ValidationError("{0} None not allowed in a set".format(self.column_name))
+        # TODO: stop doing this conversion because it doesn't support non-hashable collections as keys (cassandra does)
+        # will need to start using the cassandra.util types in the next major rev (PYTHON-494)
+        return set(self.value_col.validate(v) for v in val)
+
+    def to_python(self, value):
+        if value is None:
+            return set()
+        return set(self.value_col.to_python(v) for v in value)
+
+    def to_database(self, value):
+        if value is None:
+            return None
+        return set(self.value_col.to_database(v) for v in value)
+
+
+class List(BaseContainerColumn):
+    """
+    Stores a list of ordered values
+
+    http://www.datastax.com/documentation/cql/3.1/cql/cql_using/use_list_t.html
+    """
+
+    _python_type_hashable = False
+
+    def __init__(self, value_type, default=list, **kwargs):
+        """
+        :param value_type: a column class indicating the types of the value
+        """
+        super(List, self).__init__((value_type,), default=default, **kwargs)
+        self.value_col = self.types[0]
+        self.db_type = 'list<{0}>'.format(self.value_col.db_type)
+
+    def validate(self, value):
+        val = super(List, self).validate(value)
+        if val is None:
+            return
+        if not isinstance(val, (set, list, tuple)):
+            raise ValidationError('{0} {1} is not a list object'.format(self.column_name, val))
+        if None in val:
+            raise ValidationError("{0} None is not allowed in a list".format(self.column_name))
+        return [self.value_col.validate(v) for v in val]
+
+    def to_python(self, value):
+        if value is None:
+            return []
+        return [self.value_col.to_python(v) for v in value]
+
+    def to_database(self, value):
+        if value is None:
+            return None
+        return [self.value_col.to_database(v) for v in value]
+
+
+class Map(BaseContainerColumn):
+    """
+    Stores a key -> value map (dictionary)
+
+    https://docs.datastax.com/en/dse/6.7/cql/cql/cql_using/useMap.html
+    """
+
+    _python_type_hashable = False
+
+    def __init__(self, key_type, value_type, default=dict, **kwargs):
+        """
+        :param key_type: a column class indicating the types of the key
+        :param value_type: a column class indicating the types of the value
+        """
+        super(Map, self).__init__((key_type, value_type), default=default, **kwargs)
+        self.key_col = self.types[0]
+        self.value_col = self.types[1]
+
+        if not self.key_col._python_type_hashable:
+            raise ValidationError("Cannot create a Map with unhashable key type (see PYTHON-494)")
+
+        self.db_type = 'map<{0}, {1}>'.format(self.key_col.db_type, self.value_col.db_type)
+
+    def validate(self, value):
+        val = super(Map, self).validate(value)
+        if val is None:
+            return
+        if not isinstance(val, (dict, util.OrderedMap)):
+            raise ValidationError('{0} {1} is not a dict object'.format(self.column_name, val))
+        if None in val:
+            raise ValidationError("{0} None is not allowed in a map".format(self.column_name))
+        # TODO: stop doing this conversion because it doesn't support non-hashable collections as keys (cassandra does)
+        # will need to start using the cassandra.util types in the next major rev (PYTHON-494)
+        return dict((self.key_col.validate(k), self.value_col.validate(v)) for k, v in val.items())
+
+    def to_python(self, value):
+        if value is None:
+            return {}
+        if value is not None:
+            return dict((self.key_col.to_python(k), self.value_col.to_python(v)) for k, v in value.items())
+
+    def to_database(self, value):
+        if value is None:
+            return None
+        return dict((self.key_col.to_database(k), self.value_col.to_database(v)) for k, v in value.items())
+
+
+class UDTValueManager(BaseValueManager):
+    @property
+    def changed(self):
+        if self.explicit:
+            return self.value != self.previous_value
+
+        default_value = self.column.get_default()
+        if not self.column._val_is_null(default_value):
+            return self.value != default_value
+        elif self.previous_value is None:
+            return not self.column._val_is_null(self.value) and self.value.has_changed_fields()
+
+        return False
+
+    def reset_previous_value(self):
+        if self.value is not None:
+            self.value.reset_changed_fields()
+        self.previous_value = copy(self.value)
+
+
+class UserDefinedType(Column):
+    """
+    User Defined Type column
+
+    http://www.datastax.com/documentation/cql/3.1/cql/cql_using/cqlUseUDT.html
+
+    These columns are represented by a specialization of :class:`cassandra.cqlengine.usertype.UserType`.
+
+    Please see :ref:`user_types` for examples and discussion.
+    """
+
+    value_manager = UDTValueManager
+
+    def __init__(self, user_type, **kwargs):
+        """
+        :param type user_type: specifies the :class:`~.cqlengine.usertype.UserType` model of the column
+        """
+        self.user_type = user_type
+        self.db_type = "frozen<%s>" % user_type.type_name()
+        super(UserDefinedType, self).__init__(**kwargs)
+
+    @property
+    def sub_types(self):
+        return list(self.user_type._fields.values())
+
+    @property
+    def cql_type(self):
+        return UserType.make_udt_class(keyspace='', udt_name=self.user_type.type_name(),
+                                       field_names=[c.db_field_name for c in self.user_type._fields.values()],
+                                       field_types=[c.cql_type for c in self.user_type._fields.values()])
+
+    def validate(self, value):
+        val = super(UserDefinedType, self).validate(value)
+        if val is None:
+            return
+        val.validate()
+        return val
+
+    def to_python(self, value):
+        if value is None:
+            return
+
+        copied_value = deepcopy(value)
+        for name, field in self.user_type._fields.items():
+            if copied_value[name] is not None or isinstance(field, BaseContainerColumn):
+                copied_value[name] = field.to_python(copied_value[name])
+
+        return copied_value
+
+    def to_database(self, value):
+        if value is None:
+            return
+
+        copied_value = deepcopy(value)
+        for name, field in self.user_type._fields.items():
+            if copied_value[name] is not None or isinstance(field, BaseContainerColumn):
+                copied_value[name] = field.to_database(copied_value[name])
+
+        return copied_value
+
+
+def resolve_udts(col_def, out_list):
+    for col in col_def.sub_types:
+        resolve_udts(col, out_list)
+    if isinstance(col_def, UserDefinedType):
+        out_list.append(col_def.user_type)
+
+
+class _PartitionKeysToken(Column):
+    """
+    virtual column representing token of partition columns.
+    Used by filter(pk__token=Token(...)) filters
+    """
+
+    def __init__(self, model):
+        self.partition_columns = list(model._partition_keys.values())
+        super(_PartitionKeysToken, self).__init__(partition_key=True)
+
+    @property
+    def db_field_name(self):
+        return 'token({0})'.format(', '.join(['"{0}"'.format(c.db_field_name) for c in self.partition_columns]))
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/connection.py b/llm/Lib/site-packages/cassandra/cqlengine/connection.py
new file mode 100644
index 0000000000000000000000000000000000000000..8a6b5cf0057669214911442276454a7d3d23fe29
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cqlengine/connection.py
@@ -0,0 +1,391 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from collections import defaultdict
+import logging
+import threading
+
+from cassandra.cluster import Cluster, _ConfigMode, _NOT_SET, NoHostAvailable, UserTypeDoesNotExist, ConsistencyLevel
+from cassandra.query import SimpleStatement, dict_factory
+
+from cassandra.cqlengine import CQLEngineException
+from cassandra.cqlengine.statements import BaseCQLStatement
+
+
+log = logging.getLogger(__name__)
+
+NOT_SET = _NOT_SET  # required for passing timeout to Session.execute
+
+cluster = None
+session = None
+
+# connections registry
+DEFAULT_CONNECTION = object()
+_connections = {}
+
+# Because type models may be registered before a connection is present,
+# and because sessions may be replaced, we must register UDTs here, in order
+# to have them registered when a new session is established.
+udt_by_keyspace = defaultdict(dict)
+
+
+def format_log_context(msg, connection=None, keyspace=None):
+    """Format log message to add keyspace and connection context"""
+    connection_info = connection or 'DEFAULT_CONNECTION'
+
+    if keyspace:
+        msg = '[Connection: {0}, Keyspace: {1}] {2}'.format(connection_info, keyspace, msg)
+    else:
+        msg = '[Connection: {0}] {1}'.format(connection_info, msg)
+    return msg
+
+
+class UndefinedKeyspaceException(CQLEngineException):
+    pass
+
+
+class Connection(object):
+    """CQLEngine Connection"""
+
+    name = None
+    hosts = None
+
+    consistency = None
+    retry_connect = False
+    lazy_connect = False
+    lazy_connect_lock = None
+    cluster_options = None
+
+    cluster = None
+    session = None
+
+    def __init__(self, name, hosts, consistency=None,
+                 lazy_connect=False, retry_connect=False, cluster_options=None):
+        self.hosts = hosts
+        self.name = name
+        self.consistency = consistency
+        self.lazy_connect = lazy_connect
+        self.retry_connect = retry_connect
+        self.cluster_options = cluster_options if cluster_options else {}
+        self.lazy_connect_lock = threading.RLock()
+
+    @classmethod
+    def from_session(cls, name, session):
+        instance = cls(name=name, hosts=session.hosts)
+        instance.cluster, instance.session = session.cluster, session
+        instance.setup_session()
+        return instance
+
+    def setup(self):
+        """Setup the connection"""
+        global cluster, session
+
+        if 'username' in self.cluster_options or 'password' in self.cluster_options:
+            raise CQLEngineException("Username & Password are now handled by using the native driver's auth_provider")
+
+        if self.lazy_connect:
+            return
+
+        if 'cloud' in self.cluster_options:
+            if self.hosts:
+                log.warning("Ignoring hosts %s because a cloud config was provided.", self.hosts)
+            self.cluster = Cluster(**self.cluster_options)
+        else:
+            self.cluster = Cluster(self.hosts, **self.cluster_options)
+
+        try:
+            self.session = self.cluster.connect()
+            log.debug(format_log_context("connection initialized with internally created session", connection=self.name))
+        except NoHostAvailable:
+            if self.retry_connect:
+                log.warning(format_log_context("connect failed, setting up for re-attempt on first use", connection=self.name))
+                self.lazy_connect = True
+            raise
+
+        if DEFAULT_CONNECTION in _connections and _connections[DEFAULT_CONNECTION] == self:
+            cluster = _connections[DEFAULT_CONNECTION].cluster
+            session = _connections[DEFAULT_CONNECTION].session
+
+        self.setup_session()
+
+    def setup_session(self):
+        if self.cluster._config_mode == _ConfigMode.PROFILES:
+            self.cluster.profile_manager.default.row_factory = dict_factory
+            if self.consistency is not None:
+                self.cluster.profile_manager.default.consistency_level = self.consistency
+        else:
+            self.session.row_factory = dict_factory
+            if self.consistency is not None:
+                self.session.default_consistency_level = self.consistency
+        enc = self.session.encoder
+        enc.mapping[tuple] = enc.cql_encode_tuple
+        _register_known_types(self.session.cluster)
+
+    def handle_lazy_connect(self):
+
+        # if lazy_connect is False, it means the cluster is setup and ready
+        # No need to acquire the lock
+        if not self.lazy_connect:
+            return
+
+        with self.lazy_connect_lock:
+            # lazy_connect might have been set to False by another thread while waiting the lock
+            # In this case, do nothing.
+            if self.lazy_connect:
+                log.debug(format_log_context("Lazy connect enabled", connection=self.name))
+                self.lazy_connect = False
+                self.setup()
+
+
+def register_connection(name, hosts=None, consistency=None, lazy_connect=False,
+                        retry_connect=False, cluster_options=None, default=False,
+                        session=None):
+    """
+    Add a connection to the connection registry. ``hosts`` and ``session`` are
+    mutually exclusive, and ``consistency``, ``lazy_connect``,
+    ``retry_connect``, and ``cluster_options`` only work with ``hosts``. Using
+    ``hosts`` will create a new :class:`cassandra.cluster.Cluster` and
+    :class:`cassandra.cluster.Session`.
+
+    :param list hosts: list of hosts, (``contact_points`` for :class:`cassandra.cluster.Cluster`).
+    :param int consistency: The default :class:`~.ConsistencyLevel` for the
+        registered connection's new session. Default is the same as
+        :attr:`.Session.default_consistency_level`. For use with ``hosts`` only;
+        will fail when used with ``session``.
+    :param bool lazy_connect: True if should not connect until first use. For
+        use with ``hosts`` only; will fail when used with ``session``.
+    :param bool retry_connect: True if we should retry to connect even if there
+        was a connection failure initially. For use with ``hosts`` only; will
+        fail when used with ``session``.
+    :param dict cluster_options: A dict of options to be used as keyword
+        arguments to :class:`cassandra.cluster.Cluster`. For use with ``hosts``
+        only; will fail when used with ``session``.
+    :param bool default: If True, set the new connection as the cqlengine
+        default
+    :param Session session: A :class:`cassandra.cluster.Session` to be used in
+        the created connection.
+    """
+
+    if name in _connections:
+        log.warning("Registering connection '{0}' when it already exists.".format(name))
+
+    if session is not None:
+        invalid_config_args = (hosts is not None or
+                               consistency is not None or
+                               lazy_connect is not False or
+                               retry_connect is not False or
+                               cluster_options is not None)
+        if invalid_config_args:
+            raise CQLEngineException(
+                "Session configuration arguments and 'session' argument are mutually exclusive"
+            )
+        conn = Connection.from_session(name, session=session)
+    else:  # use hosts argument
+        conn = Connection(
+            name, hosts=hosts,
+            consistency=consistency, lazy_connect=lazy_connect,
+            retry_connect=retry_connect, cluster_options=cluster_options
+        )
+        conn.setup()
+
+    _connections[name] = conn
+
+    if default:
+        set_default_connection(name)
+
+    return conn
+
+
+def unregister_connection(name):
+    global cluster, session
+
+    if name not in _connections:
+        return
+
+    if DEFAULT_CONNECTION in _connections and _connections[name] == _connections[DEFAULT_CONNECTION]:
+        del _connections[DEFAULT_CONNECTION]
+        cluster = None
+        session = None
+
+    conn = _connections[name]
+    if conn.cluster:
+        conn.cluster.shutdown()
+    del _connections[name]
+    log.debug("Connection '{0}' has been removed from the registry.".format(name))
+
+
+def set_default_connection(name):
+    global cluster, session
+
+    if name not in _connections:
+        raise CQLEngineException("Connection '{0}' doesn't exist.".format(name))
+
+    log.debug("Connection '{0}' has been set as default.".format(name))
+    _connections[DEFAULT_CONNECTION] = _connections[name]
+    cluster = _connections[name].cluster
+    session = _connections[name].session
+
+
+def get_connection(name=None):
+
+    if not name:
+        name = DEFAULT_CONNECTION
+
+    if name not in _connections:
+        raise CQLEngineException("Connection name '{0}' doesn't exist in the registry.".format(name))
+
+    conn = _connections[name]
+    conn.handle_lazy_connect()
+
+    return conn
+
+
+def default():
+    """
+    Configures the default connection to localhost, using the driver defaults
+    (except for row_factory)
+    """
+
+    try:
+        conn = get_connection()
+        if conn.session:
+            log.warning("configuring new default connection for cqlengine when one was already set")
+    except:
+        pass
+
+    register_connection('default', hosts=None, default=True)
+
+    log.debug("cqlengine connection initialized with default session to localhost")
+
+
+def set_session(s):
+    """
+    Configures the default connection with a preexisting :class:`cassandra.cluster.Session`
+
+    Note: the mapper presently requires a Session :attr:`~.row_factory` set to ``dict_factory``.
+    This may be relaxed in the future
+    """
+
+    try:
+        conn = get_connection()
+    except CQLEngineException:
+        # no default connection set; initalize one
+        register_connection('default', session=s, default=True)
+        conn = get_connection()
+    else:
+        if conn.session:
+            log.warning("configuring new default session for cqlengine when one was already set")
+
+    if not any([
+        s.cluster.profile_manager.default.row_factory is dict_factory and s.cluster._config_mode in [_ConfigMode.PROFILES, _ConfigMode.UNCOMMITTED],
+        s.row_factory is dict_factory and s.cluster._config_mode in [_ConfigMode.LEGACY, _ConfigMode.UNCOMMITTED],
+    ]):
+        raise CQLEngineException("Failed to initialize: row_factory must be 'dict_factory'")
+
+    conn.session = s
+    conn.cluster = s.cluster
+
+    # Set default keyspace from given session's keyspace
+    if conn.session.keyspace:
+        from cassandra.cqlengine import models
+        models.DEFAULT_KEYSPACE = conn.session.keyspace
+
+    conn.setup_session()
+
+    log.debug("cqlengine default connection initialized with %s", s)
+
+
+# TODO next major: if a cloud config is specified in kwargs, hosts will be ignored.
+# This function should be refactored to reflect this change. PYTHON-1265
+def setup(
+        hosts,
+        default_keyspace,
+        consistency=None,
+        lazy_connect=False,
+        retry_connect=False,
+        **kwargs):
+    """
+    Setup a the driver connection used by the mapper
+
+    :param list hosts: list of hosts, (``contact_points`` for :class:`cassandra.cluster.Cluster`)
+    :param str default_keyspace: The default keyspace to use
+    :param int consistency: The global default :class:`~.ConsistencyLevel` - default is the same as :attr:`.Session.default_consistency_level`
+    :param bool lazy_connect: True if should not connect until first use
+    :param bool retry_connect: True if we should retry to connect even if there was a connection failure initially
+    :param \*\*kwargs: Pass-through keyword arguments for :class:`cassandra.cluster.Cluster`
+    """
+
+    from cassandra.cqlengine import models
+    models.DEFAULT_KEYSPACE = default_keyspace
+
+    register_connection('default', hosts=hosts, consistency=consistency, lazy_connect=lazy_connect,
+                        retry_connect=retry_connect, cluster_options=kwargs, default=True)
+
+
+def execute(query, params=None, consistency_level=None, timeout=NOT_SET, connection=None):
+
+    conn = get_connection(connection)
+
+    if not conn.session:
+        raise CQLEngineException("It is required to setup() cqlengine before executing queries")
+
+    if isinstance(query, SimpleStatement):
+        pass  #
+    elif isinstance(query, BaseCQLStatement):
+        params = query.get_context()
+        query = SimpleStatement(str(query), consistency_level=consistency_level, fetch_size=query.fetch_size)
+    elif isinstance(query, str):
+        query = SimpleStatement(query, consistency_level=consistency_level)
+    log.debug(format_log_context('Query: {}, Params: {}'.format(query.query_string, params), connection=connection))
+
+    result = conn.session.execute(query, params, timeout=timeout)
+
+    return result
+
+
+def get_session(connection=None):
+    conn = get_connection(connection)
+    return conn.session
+
+
+def get_cluster(connection=None):
+    conn = get_connection(connection)
+    if not conn.cluster:
+        raise CQLEngineException("%s.cluster is not configured. Call one of the setup or default functions first." % __name__)
+    return conn.cluster
+
+
+def register_udt(keyspace, type_name, klass, connection=None):
+    udt_by_keyspace[keyspace][type_name] = klass
+
+    try:
+        cluster = get_cluster(connection)
+    except CQLEngineException:
+        cluster = None
+
+    if cluster:
+        try:
+            cluster.register_user_type(keyspace, type_name, klass)
+        except UserTypeDoesNotExist:
+            pass  # new types are covered in management sync functions
+
+
+def _register_known_types(cluster):
+    from cassandra.cqlengine import models
+    for ks_name, name_type_map in udt_by_keyspace.items():
+        for type_name, klass in name_type_map.items():
+            try:
+                cluster.register_user_type(ks_name or models.DEFAULT_KEYSPACE, type_name, klass)
+            except UserTypeDoesNotExist:
+                pass  # new types are covered in management sync functions
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/functions.py b/llm/Lib/site-packages/cassandra/cqlengine/functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..c7a5adaeca094b4bd2d39bc22577c816cd950f07
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cqlengine/functions.py
@@ -0,0 +1,127 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import division
+from datetime import datetime
+
+from cassandra.cqlengine import UnicodeMixin, ValidationError
+
+import sys
+
+if sys.version_info >= (2, 7):
+    def get_total_seconds(td):
+        return td.total_seconds()
+else:
+    def get_total_seconds(td):
+        # integer division used here to emulate built-in total_seconds
+        return ((86400 * td.days + td.seconds) * 10 ** 6 + td.microseconds) / 10 ** 6
+
+
+class QueryValue(UnicodeMixin):
+    """
+    Base class for query filter values. Subclasses of these classes can
+    be passed into .filter() keyword args
+    """
+
+    format_string = '%({0})s'
+
+    def __init__(self, value):
+        self.value = value
+        self.context_id = None
+
+    def __unicode__(self):
+        return self.format_string.format(self.context_id)
+
+    def set_context_id(self, ctx_id):
+        self.context_id = ctx_id
+
+    def get_context_size(self):
+        return 1
+
+    def update_context(self, ctx):
+        ctx[str(self.context_id)] = self.value
+
+
+class BaseQueryFunction(QueryValue):
+    """
+    Base class for filtering functions. Subclasses of these classes can
+    be passed into .filter() and will be translated into CQL functions in
+    the resulting query
+    """
+    pass
+
+
+class TimeUUIDQueryFunction(BaseQueryFunction):
+
+    def __init__(self, value):
+        """
+        :param value: the time to create bounding time uuid from
+        :type value: datetime
+        """
+        if not isinstance(value, datetime):
+            raise ValidationError('datetime instance is required')
+        super(TimeUUIDQueryFunction, self).__init__(value)
+
+    def to_database(self, val):
+        epoch = datetime(1970, 1, 1, tzinfo=val.tzinfo)
+        offset = get_total_seconds(epoch.tzinfo.utcoffset(epoch)) if epoch.tzinfo else 0
+        return int((get_total_seconds(val - epoch) - offset) * 1000)
+
+    def update_context(self, ctx):
+        ctx[str(self.context_id)] = self.to_database(self.value)
+
+
+class MinTimeUUID(TimeUUIDQueryFunction):
+    """
+    return a fake timeuuid corresponding to the smallest possible timeuuid for the given timestamp
+
+    http://cassandra.apache.org/doc/cql3/CQL-3.0.html#timeuuidFun
+    """
+    format_string = 'MinTimeUUID(%({0})s)'
+
+
+class MaxTimeUUID(TimeUUIDQueryFunction):
+    """
+    return a fake timeuuid corresponding to the largest possible timeuuid for the given timestamp
+
+    http://cassandra.apache.org/doc/cql3/CQL-3.0.html#timeuuidFun
+    """
+    format_string = 'MaxTimeUUID(%({0})s)'
+
+
+class Token(BaseQueryFunction):
+    """
+    compute the token for a given partition key
+
+    http://cassandra.apache.org/doc/cql3/CQL-3.0.html#tokenFun
+    """
+    def __init__(self, *values):
+        if len(values) == 1 and isinstance(values[0], (list, tuple)):
+            values = values[0]
+        super(Token, self).__init__(values)
+        self._columns = None
+
+    def set_columns(self, columns):
+        self._columns = columns
+
+    def get_context_size(self):
+        return len(self.value)
+
+    def __unicode__(self):
+        token_args = ', '.join('%({0})s'.format(self.context_id + i) for i in range(self.get_context_size()))
+        return "token({0})".format(token_args)
+
+    def update_context(self, ctx):
+        for i, (col, val) in enumerate(zip(self._columns, self.value)):
+            ctx[str(self.context_id + i)] = col.to_database(val)
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/management.py b/llm/Lib/site-packages/cassandra/cqlengine/management.py
new file mode 100644
index 0000000000000000000000000000000000000000..24395f5a315f0f53c222549eb06d0c900799a51a
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cqlengine/management.py
@@ -0,0 +1,547 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from collections import namedtuple
+import json
+import logging
+import os
+import warnings
+from itertools import product
+
+from cassandra import metadata
+from cassandra.cqlengine import CQLEngineException
+from cassandra.cqlengine import columns, query
+from cassandra.cqlengine.connection import execute, get_cluster, format_log_context
+from cassandra.cqlengine.models import Model
+from cassandra.cqlengine.named import NamedTable
+from cassandra.cqlengine.usertype import UserType
+
+CQLENG_ALLOW_SCHEMA_MANAGEMENT = 'CQLENG_ALLOW_SCHEMA_MANAGEMENT'
+
+Field = namedtuple('Field', ['name', 'type'])
+
+log = logging.getLogger(__name__)
+
+# system keyspaces
+schema_columnfamilies = NamedTable('system', 'schema_columnfamilies')
+
+
+def _get_context(keyspaces, connections):
+    """Return all the execution contexts"""
+
+    if keyspaces:
+        if not isinstance(keyspaces, (list, tuple)):
+            raise ValueError('keyspaces must be a list or a tuple.')
+
+    if connections:
+        if not isinstance(connections, (list, tuple)):
+            raise ValueError('connections must be a list or a tuple.')
+
+    keyspaces = keyspaces if keyspaces else [None]
+    connections = connections if connections else [None]
+
+    return product(connections, keyspaces)
+
+
+def create_keyspace_simple(name, replication_factor, durable_writes=True, connections=None):
+    """
+    Creates a keyspace with SimpleStrategy for replica placement
+
+    If the keyspace already exists, it will not be modified.
+
+    **This function should be used with caution, especially in production environments.
+    Take care to execute schema modifications in a single context (i.e. not concurrently with other clients).**
+
+    *There are plans to guard schema-modifying functions with an environment-driven conditional.*
+
+    :param str name: name of keyspace to create
+    :param int replication_factor: keyspace replication factor, used with :attr:`~.SimpleStrategy`
+    :param bool durable_writes: Write log is bypassed if set to False
+    :param list connections: List of connection names
+    """
+    _create_keyspace(name, durable_writes, 'SimpleStrategy',
+                     {'replication_factor': replication_factor}, connections=connections)
+
+
+def create_keyspace_network_topology(name, dc_replication_map, durable_writes=True, connections=None):
+    """
+    Creates a keyspace with NetworkTopologyStrategy for replica placement
+
+    If the keyspace already exists, it will not be modified.
+
+    **This function should be used with caution, especially in production environments.
+    Take care to execute schema modifications in a single context (i.e. not concurrently with other clients).**
+
+    *There are plans to guard schema-modifying functions with an environment-driven conditional.*
+
+    :param str name: name of keyspace to create
+    :param dict dc_replication_map: map of dc_names: replication_factor
+    :param bool durable_writes: Write log is bypassed if set to False
+    :param list connections: List of connection names
+    """
+    _create_keyspace(name, durable_writes, 'NetworkTopologyStrategy', dc_replication_map, connections=connections)
+
+
+def _create_keyspace(name, durable_writes, strategy_class, strategy_options, connections=None):
+    if not _allow_schema_modification():
+        return
+
+    if connections:
+        if not isinstance(connections, (list, tuple)):
+            raise ValueError('Connections must be a list or a tuple.')
+
+    def __create_keyspace(name, durable_writes, strategy_class, strategy_options, connection=None):
+        cluster = get_cluster(connection)
+
+        if name not in cluster.metadata.keyspaces:
+            log.info(format_log_context("Creating keyspace %s", connection=connection), name)
+            ks_meta = metadata.KeyspaceMetadata(name, durable_writes, strategy_class, strategy_options)
+            execute(ks_meta.as_cql_query(), connection=connection)
+        else:
+            log.info(format_log_context("Not creating keyspace %s because it already exists", connection=connection), name)
+
+    if connections:
+        for connection in connections:
+            __create_keyspace(name, durable_writes, strategy_class, strategy_options, connection=connection)
+    else:
+        __create_keyspace(name, durable_writes, strategy_class, strategy_options)
+
+
+def drop_keyspace(name, connections=None):
+    """
+    Drops a keyspace, if it exists.
+
+    *There are plans to guard schema-modifying functions with an environment-driven conditional.*
+
+    **This function should be used with caution, especially in production environments.
+    Take care to execute schema modifications in a single context (i.e. not concurrently with other clients).**
+
+    :param str name: name of keyspace to drop
+    :param list connections: List of connection names
+    """
+    if not _allow_schema_modification():
+        return
+
+    if connections:
+        if not isinstance(connections, (list, tuple)):
+            raise ValueError('Connections must be a list or a tuple.')
+
+    def _drop_keyspace(name, connection=None):
+        cluster = get_cluster(connection)
+        if name in cluster.metadata.keyspaces:
+            execute("DROP KEYSPACE {0}".format(metadata.protect_name(name)), connection=connection)
+
+    if connections:
+        for connection in connections:
+            _drop_keyspace(name, connection)
+    else:
+        _drop_keyspace(name)
+
+def _get_index_name_by_column(table, column_name):
+    """
+    Find the index name for a given table and column.
+    """
+    protected_name = metadata.protect_name(column_name)
+    possible_index_values = [protected_name, "values(%s)" % protected_name]
+    for index_metadata in table.indexes.values():
+        options = dict(index_metadata.index_options)
+        if options.get('target') in possible_index_values:
+            return index_metadata.name
+
+
+def sync_table(model, keyspaces=None, connections=None):
+    """
+    Inspects the model and creates / updates the corresponding table and columns.
+
+    If `keyspaces` is specified, the table will be synched for all specified keyspaces.
+    Note that the `Model.__keyspace__` is ignored in that case.
+
+    If `connections` is specified, the table will be synched for all specified connections. Note that the `Model.__connection__` is ignored in that case.
+    If not specified, it will try to get the connection from the Model.
+
+    Any User Defined Types used in the table are implicitly synchronized.
+
+    This function can only add fields that are not part of the primary key.
+
+    Note that the attributes removed from the model are not deleted on the database.
+    They become effectively ignored by (will not show up on) the model.
+
+    **This function should be used with caution, especially in production environments.
+    Take care to execute schema modifications in a single context (i.e. not concurrently with other clients).**
+
+    *There are plans to guard schema-modifying functions with an environment-driven conditional.*
+    """
+
+    context = _get_context(keyspaces, connections)
+    for connection, keyspace in context:
+        with query.ContextQuery(model, keyspace=keyspace) as m:
+            _sync_table(m, connection=connection)
+
+
+def _sync_table(model, connection=None):
+    if not _allow_schema_modification():
+        return
+
+    if not issubclass(model, Model):
+        raise CQLEngineException("Models must be derived from base Model.")
+
+    if model.__abstract__:
+        raise CQLEngineException("cannot create table from abstract model")
+
+    cf_name = model.column_family_name()
+    raw_cf_name = model._raw_column_family_name()
+
+    ks_name = model._get_keyspace()
+    connection = connection or model._get_connection()
+
+    cluster = get_cluster(connection)
+
+    try:
+        keyspace = cluster.metadata.keyspaces[ks_name]
+    except KeyError:
+        msg = format_log_context("Keyspace '{0}' for model {1} does not exist.", connection=connection)
+        raise CQLEngineException(msg.format(ks_name, model))
+
+    tables = keyspace.tables
+
+    syncd_types = set()
+    for col in model._columns.values():
+        udts = []
+        columns.resolve_udts(col, udts)
+        for udt in [u for u in udts if u not in syncd_types]:
+            _sync_type(ks_name, udt, syncd_types, connection=connection)
+
+    if raw_cf_name not in tables:
+        log.debug(format_log_context("sync_table creating new table %s", keyspace=ks_name, connection=connection), cf_name)
+        qs = _get_create_table(model)
+
+        try:
+            execute(qs, connection=connection)
+        except CQLEngineException as ex:
+            # 1.2 doesn't return cf names, so we have to examine the exception
+            # and ignore if it says the column family already exists
+            if "Cannot add already existing column family" not in str(ex):
+                raise
+    else:
+        log.debug(format_log_context("sync_table checking existing table %s", keyspace=ks_name, connection=connection), cf_name)
+        table_meta = tables[raw_cf_name]
+
+        _validate_pk(model, table_meta)
+
+        table_columns = table_meta.columns
+        model_fields = set()
+
+        for model_name, col in model._columns.items():
+            db_name = col.db_field_name
+            model_fields.add(db_name)
+            if db_name in table_columns:
+                col_meta = table_columns[db_name]
+                if col_meta.cql_type != col.db_type:
+                    msg = format_log_context('Existing table {0} has column "{1}" with a type ({2}) differing from the model type ({3}).'
+                                  ' Model should be updated.', keyspace=ks_name, connection=connection)
+                    msg = msg.format(cf_name, db_name, col_meta.cql_type, col.db_type)
+                    warnings.warn(msg)
+                    log.warning(msg)
+
+                continue
+
+            if col.primary_key or col.primary_key:
+                msg = format_log_context("Cannot add primary key '{0}' (with db_field '{1}') to existing table {2}", keyspace=ks_name, connection=connection)
+                raise CQLEngineException(msg.format(model_name, db_name, cf_name))
+
+            query = "ALTER TABLE {0} add {1}".format(cf_name, col.get_column_def())
+            execute(query, connection=connection)
+
+        db_fields_not_in_model = model_fields.symmetric_difference(table_columns)
+        if db_fields_not_in_model:
+            msg = format_log_context("Table {0} has fields not referenced by model: {1}", keyspace=ks_name, connection=connection)
+            log.info(msg.format(cf_name, db_fields_not_in_model))
+
+        _update_options(model, connection=connection)
+
+    table = cluster.metadata.keyspaces[ks_name].tables[raw_cf_name]
+
+    indexes = [c for n, c in model._columns.items() if c.index]
+
+    # TODO: support multiple indexes in C* 3.0+
+    for column in indexes:
+        index_name = _get_index_name_by_column(table, column.db_field_name)
+        if index_name:
+            continue
+
+        qs = ['CREATE INDEX']
+        qs += ['ON {0}'.format(cf_name)]
+        qs += ['("{0}")'.format(column.db_field_name)]
+        qs = ' '.join(qs)
+        execute(qs, connection=connection)
+
+
+def _validate_pk(model, table_meta):
+    model_partition = [c.db_field_name for c in model._partition_keys.values()]
+    meta_partition = [c.name for c in table_meta.partition_key]
+    model_clustering = [c.db_field_name for c in model._clustering_keys.values()]
+    meta_clustering = [c.name for c in table_meta.clustering_key]
+
+    if model_partition != meta_partition or model_clustering != meta_clustering:
+        def _pk_string(partition, clustering):
+            return "PRIMARY KEY (({0}){1})".format(', '.join(partition), ', ' + ', '.join(clustering) if clustering else '')
+        raise CQLEngineException("Model {0} PRIMARY KEY composition does not match existing table {1}. "
+                                 "Model: {2}; Table: {3}. "
+                                 "Update model or drop the table.".format(model, model.column_family_name(),
+                                                                          _pk_string(model_partition, model_clustering),
+                                                                          _pk_string(meta_partition, meta_clustering)))
+
+
+def sync_type(ks_name, type_model, connection=None):
+    """
+    Inspects the type_model and creates / updates the corresponding type.
+
+    Note that the attributes removed from the type_model are not deleted on the database (this operation is not supported).
+    They become effectively ignored by (will not show up on) the type_model.
+
+    **This function should be used with caution, especially in production environments.
+    Take care to execute schema modifications in a single context (i.e. not concurrently with other clients).**
+
+    *There are plans to guard schema-modifying functions with an environment-driven conditional.*
+    """
+    if not _allow_schema_modification():
+        return
+
+    if not issubclass(type_model, UserType):
+        raise CQLEngineException("Types must be derived from base UserType.")
+
+    _sync_type(ks_name, type_model, connection=connection)
+
+
+def _sync_type(ks_name, type_model, omit_subtypes=None, connection=None):
+
+    syncd_sub_types = omit_subtypes or set()
+    for field in type_model._fields.values():
+        udts = []
+        columns.resolve_udts(field, udts)
+        for udt in [u for u in udts if u not in syncd_sub_types]:
+            _sync_type(ks_name, udt, syncd_sub_types, connection=connection)
+            syncd_sub_types.add(udt)
+
+    type_name = type_model.type_name()
+    type_name_qualified = "%s.%s" % (ks_name, type_name)
+
+    cluster = get_cluster(connection)
+
+    keyspace = cluster.metadata.keyspaces[ks_name]
+    defined_types = keyspace.user_types
+
+    if type_name not in defined_types:
+        log.debug(format_log_context("sync_type creating new type %s", keyspace=ks_name, connection=connection), type_name_qualified)
+        cql = get_create_type(type_model, ks_name)
+        execute(cql, connection=connection)
+        cluster.refresh_user_type_metadata(ks_name, type_name)
+        type_model.register_for_keyspace(ks_name, connection=connection)
+    else:
+        type_meta = defined_types[type_name]
+        defined_fields = type_meta.field_names
+        model_fields = set()
+        for field in type_model._fields.values():
+            model_fields.add(field.db_field_name)
+            if field.db_field_name not in defined_fields:
+                execute("ALTER TYPE {0} ADD {1}".format(type_name_qualified, field.get_column_def()), connection=connection)
+            else:
+                field_type = type_meta.field_types[defined_fields.index(field.db_field_name)]
+                if field_type != field.db_type:
+                    msg = format_log_context('Existing user type {0} has field "{1}" with a type ({2}) differing from the model user type ({3}).'
+                                  ' UserType should be updated.', keyspace=ks_name, connection=connection)
+                    msg = msg.format(type_name_qualified, field.db_field_name, field_type, field.db_type)
+                    warnings.warn(msg)
+                    log.warning(msg)
+
+        type_model.register_for_keyspace(ks_name, connection=connection)
+
+        if len(defined_fields) == len(model_fields):
+            log.info(format_log_context("Type %s did not require synchronization", keyspace=ks_name, connection=connection), type_name_qualified)
+            return
+
+        db_fields_not_in_model = model_fields.symmetric_difference(defined_fields)
+        if db_fields_not_in_model:
+            msg = format_log_context("Type %s has fields not referenced by model: %s", keyspace=ks_name, connection=connection)
+            log.info(msg, type_name_qualified, db_fields_not_in_model)
+
+
+def get_create_type(type_model, keyspace):
+    type_meta = metadata.UserType(keyspace,
+                                  type_model.type_name(),
+                                  (f.db_field_name for f in type_model._fields.values()),
+                                  (v.db_type for v in type_model._fields.values()))
+    return type_meta.as_cql_query()
+
+
+def _get_create_table(model):
+    ks_table_name = model.column_family_name()
+    query_strings = ['CREATE TABLE {0}'.format(ks_table_name)]
+
+    # add column types
+    pkeys = []  # primary keys
+    ckeys = []  # clustering keys
+    qtypes = []  # field types
+
+    def add_column(col):
+        s = col.get_column_def()
+        if col.primary_key:
+            keys = (pkeys if col.partition_key else ckeys)
+            keys.append('"{0}"'.format(col.db_field_name))
+        qtypes.append(s)
+
+    for name, col in model._columns.items():
+        add_column(col)
+
+    qtypes.append('PRIMARY KEY (({0}){1})'.format(', '.join(pkeys), ckeys and ', ' + ', '.join(ckeys) or ''))
+
+    query_strings += ['({0})'.format(', '.join(qtypes))]
+
+    property_strings = []
+
+    _order = ['"{0}" {1}'.format(c.db_field_name, c.clustering_order or 'ASC') for c in model._clustering_keys.values()]
+    if _order:
+        property_strings.append('CLUSTERING ORDER BY ({0})'.format(', '.join(_order)))
+
+    # options strings use the V3 format, which matches CQL more closely and does not require mapping
+    property_strings += metadata.TableMetadataV3._make_option_strings(model.__options__ or {})
+
+    if property_strings:
+        query_strings += ['WITH {0}'.format(' AND '.join(property_strings))]
+
+    return ' '.join(query_strings)
+
+
+def _get_table_metadata(model, connection=None):
+    # returns the table as provided by the native driver for a given model
+    cluster = get_cluster(connection)
+    ks = model._get_keyspace()
+    table = model._raw_column_family_name()
+    table = cluster.metadata.keyspaces[ks].tables[table]
+    return table
+
+
+def _options_map_from_strings(option_strings):
+    # converts options strings to a mapping to strings or dict
+    options = {}
+    for option in option_strings:
+        name, value = option.split('=')
+        i = value.find('{')
+        if i >= 0:
+            value = value[i:value.rfind('}') + 1].replace("'", '"')  # from cql single quotes to json double; not aware of any values that would be escaped right now
+            value = json.loads(value)
+        else:
+            value = value.strip()
+        options[name.strip()] = value
+    return options
+
+
+def _update_options(model, connection=None):
+    """Updates the table options for the given model if necessary.
+
+    :param model: The model to update.
+    :param connection: Name of the connection to use
+
+    :return: `True`, if the options were modified in Cassandra,
+        `False` otherwise.
+    :rtype: bool
+    """
+    ks_name = model._get_keyspace()
+    msg = format_log_context("Checking %s for option differences", keyspace=ks_name, connection=connection)
+    log.debug(msg, model)
+    model_options = model.__options__ or {}
+
+    table_meta = _get_table_metadata(model, connection=connection)
+    # go to CQL string first to normalize meta from different versions
+    existing_option_strings = set(table_meta._make_option_strings(table_meta.options))
+    existing_options = _options_map_from_strings(existing_option_strings)
+    model_option_strings = metadata.TableMetadataV3._make_option_strings(model_options)
+    model_options = _options_map_from_strings(model_option_strings)
+
+    update_options = {}
+    for name, value in model_options.items():
+        try:
+            existing_value = existing_options[name]
+        except KeyError:
+            msg = format_log_context("Invalid table option: '%s'; known options: %s", keyspace=ks_name, connection=connection)
+            raise KeyError(msg % (name, existing_options.keys()))
+        if isinstance(existing_value, str):
+            if value != existing_value:
+                update_options[name] = value
+        else:
+            try:
+                for k, v in value.items():
+                    if existing_value[k] != v:
+                        update_options[name] = value
+                        break
+            except KeyError:
+                update_options[name] = value
+
+    if update_options:
+        options = ' AND '.join(metadata.TableMetadataV3._make_option_strings(update_options))
+        query = "ALTER TABLE {0} WITH {1}".format(model.column_family_name(), options)
+        execute(query, connection=connection)
+        return True
+
+    return False
+
+
+def drop_table(model, keyspaces=None, connections=None):
+    """
+    Drops the table indicated by the model, if it exists.
+
+    If `keyspaces` is specified, the table will be dropped for all specified keyspaces. Note that the `Model.__keyspace__` is ignored in that case.
+
+    If `connections` is specified, the table will be synched for all specified connections. Note that the `Model.__connection__` is ignored in that case.
+    If not specified, it will try to get the connection from the Model.
+
+
+    **This function should be used with caution, especially in production environments.
+    Take care to execute schema modifications in a single context (i.e. not concurrently with other clients).**
+
+    *There are plans to guard schema-modifying functions with an environment-driven conditional.*
+    """
+
+    context = _get_context(keyspaces, connections)
+    for connection, keyspace in context:
+        with query.ContextQuery(model, keyspace=keyspace) as m:
+            _drop_table(m, connection=connection)
+
+
+def _drop_table(model, connection=None):
+    if not _allow_schema_modification():
+        return
+
+    connection = connection or model._get_connection()
+
+    # don't try to delete non existant tables
+    meta = get_cluster(connection).metadata
+
+    ks_name = model._get_keyspace()
+    raw_cf_name = model._raw_column_family_name()
+
+    try:
+        meta.keyspaces[ks_name].tables[raw_cf_name]
+        execute('DROP TABLE {0};'.format(model.column_family_name()), connection=connection)
+    except KeyError:
+        pass
+
+
+def _allow_schema_modification():
+    if not os.getenv(CQLENG_ALLOW_SCHEMA_MANAGEMENT):
+        msg = CQLENG_ALLOW_SCHEMA_MANAGEMENT + " environment variable is not set. Future versions of this package will require this variable to enable management functions."
+        warnings.warn(msg)
+        log.warning(msg)
+
+    return True
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/models.py b/llm/Lib/site-packages/cassandra/cqlengine/models.py
new file mode 100644
index 0000000000000000000000000000000000000000..3f43489f4806a222dbef3dbc93f1df789ecb5779
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cqlengine/models.py
@@ -0,0 +1,1086 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import re
+from warnings import warn
+
+from cassandra.cqlengine import CQLEngineException, ValidationError
+from cassandra.cqlengine import columns
+from cassandra.cqlengine import connection
+from cassandra.cqlengine import query
+from cassandra.cqlengine.query import DoesNotExist as _DoesNotExist
+from cassandra.cqlengine.query import MultipleObjectsReturned as _MultipleObjectsReturned
+from cassandra.metadata import protect_name
+from cassandra.util import OrderedDict
+
+log = logging.getLogger(__name__)
+
+
+def _clone_model_class(model, attrs):
+    new_type = type(model.__name__, (model,), attrs)
+    try:
+        new_type.__abstract__ = model.__abstract__
+        new_type.__discriminator_value__ = model.__discriminator_value__
+        new_type.__default_ttl__ = model.__default_ttl__
+    except AttributeError:
+        pass
+    return new_type
+
+
+class ModelException(CQLEngineException):
+    pass
+
+
+class ModelDefinitionException(ModelException):
+    pass
+
+
+class PolymorphicModelException(ModelException):
+    pass
+
+
+class UndefinedKeyspaceWarning(Warning):
+    pass
+
+DEFAULT_KEYSPACE = None
+
+
+class hybrid_classmethod(object):
+    """
+    Allows a method to behave as both a class method and
+    normal instance method depending on how it's called
+    """
+    def __init__(self, clsmethod, instmethod):
+        self.clsmethod = clsmethod
+        self.instmethod = instmethod
+
+    def __get__(self, instance, owner):
+        if instance is None:
+            return self.clsmethod.__get__(owner, owner)
+        else:
+            return self.instmethod.__get__(instance, owner)
+
+    def __call__(self, *args, **kwargs):
+        """
+        Just a hint to IDEs that it's ok to call this
+        """
+        raise NotImplementedError
+
+
+class QuerySetDescriptor(object):
+    """
+    returns a fresh queryset for the given model
+    it's declared on everytime it's accessed
+    """
+
+    def __get__(self, obj, model):
+        """ :rtype: ModelQuerySet """
+        if model.__abstract__:
+            raise CQLEngineException('cannot execute queries against abstract models')
+        queryset = model.__queryset__(model)
+
+        # if this is a concrete polymorphic model, and the discriminator
+        # key is an indexed column, add a filter clause to only return
+        # logical rows of the proper type
+        if model._is_polymorphic and not model._is_polymorphic_base:
+            name, column = model._discriminator_column_name, model._discriminator_column
+            if column.partition_key or column.index:
+                # look for existing poly types
+                return queryset.filter(**{name: model.__discriminator_value__})
+
+        return queryset
+
+    def __call__(self, *args, **kwargs):
+        """
+        Just a hint to IDEs that it's ok to call this
+
+        :rtype: ModelQuerySet
+        """
+        raise NotImplementedError
+
+
+class ConditionalDescriptor(object):
+    """
+    returns a query set descriptor
+    """
+    def __get__(self, instance, model):
+        if instance:
+            def conditional_setter(*prepared_conditional, **unprepared_conditionals):
+                if len(prepared_conditional) > 0:
+                    conditionals = prepared_conditional[0]
+                else:
+                    conditionals = instance.objects.iff(**unprepared_conditionals)._conditional
+                instance._conditional = conditionals
+                return instance
+
+            return conditional_setter
+        qs = model.__queryset__(model)
+
+        def conditional_setter(**unprepared_conditionals):
+            conditionals = model.objects.iff(**unprepared_conditionals)._conditional
+            qs._conditional = conditionals
+            return qs
+        return conditional_setter
+
+    def __call__(self, *args, **kwargs):
+        raise NotImplementedError
+
+
+class TTLDescriptor(object):
+    """
+    returns a query set descriptor
+    """
+    def __get__(self, instance, model):
+        if instance:
+            # instance = copy.deepcopy(instance)
+            # instance method
+            def ttl_setter(ts):
+                instance._ttl = ts
+                return instance
+            return ttl_setter
+
+        qs = model.__queryset__(model)
+
+        def ttl_setter(ts):
+            qs._ttl = ts
+            return qs
+
+        return ttl_setter
+
+    def __call__(self, *args, **kwargs):
+        raise NotImplementedError
+
+
+class TimestampDescriptor(object):
+    """
+    returns a query set descriptor with a timestamp specified
+    """
+    def __get__(self, instance, model):
+        if instance:
+            # instance method
+            def timestamp_setter(ts):
+                instance._timestamp = ts
+                return instance
+            return timestamp_setter
+
+        return model.objects.timestamp
+
+    def __call__(self, *args, **kwargs):
+        raise NotImplementedError
+
+
+class IfNotExistsDescriptor(object):
+    """
+    return a query set descriptor with a if_not_exists flag specified
+    """
+    def __get__(self, instance, model):
+        if instance:
+            # instance method
+            def ifnotexists_setter(ife=True):
+                instance._if_not_exists = ife
+                return instance
+            return ifnotexists_setter
+
+        return model.objects.if_not_exists
+
+    def __call__(self, *args, **kwargs):
+        raise NotImplementedError
+
+
+class IfExistsDescriptor(object):
+    """
+    return a query set descriptor with a if_exists flag specified
+    """
+    def __get__(self, instance, model):
+        if instance:
+            # instance method
+            def ifexists_setter(ife=True):
+                instance._if_exists = ife
+                return instance
+            return ifexists_setter
+
+        return model.objects.if_exists
+
+    def __call__(self, *args, **kwargs):
+        raise NotImplementedError
+
+
+class ConsistencyDescriptor(object):
+    """
+    returns a query set descriptor if called on Class, instance if it was an instance call
+    """
+    def __get__(self, instance, model):
+        if instance:
+            # instance = copy.deepcopy(instance)
+            def consistency_setter(consistency):
+                instance.__consistency__ = consistency
+                return instance
+            return consistency_setter
+
+        qs = model.__queryset__(model)
+
+        def consistency_setter(consistency):
+            qs._consistency = consistency
+            return qs
+
+        return consistency_setter
+
+    def __call__(self, *args, **kwargs):
+        raise NotImplementedError
+
+
+class UsingDescriptor(object):
+    """
+    return a query set descriptor with a connection context specified
+    """
+    def __get__(self, instance, model):
+        if instance:
+            # instance method
+            def using_setter(connection=None):
+                if connection:
+                    instance._connection = connection
+                return instance
+            return using_setter
+
+        return model.objects.using
+
+    def __call__(self, *args, **kwargs):
+        raise NotImplementedError
+
+
+class ColumnQueryEvaluator(query.AbstractQueryableColumn):
+    """
+    Wraps a column and allows it to be used in comparator
+    expressions, returning query operators
+
+    ie:
+    Model.column == 5
+    """
+
+    def __init__(self, column):
+        self.column = column
+
+    def __unicode__(self):
+        return self.column.db_field_name
+
+    def _get_column(self):
+        return self.column
+
+
+class ColumnDescriptor(object):
+    """
+    Handles the reading and writing of column values to and from
+    a model instance's value manager, as well as creating
+    comparator queries
+    """
+
+    def __init__(self, column):
+        """
+        :param column:
+        :type column: columns.Column
+        :return:
+        """
+        self.column = column
+        self.query_evaluator = ColumnQueryEvaluator(self.column)
+
+    def __get__(self, instance, owner):
+        """
+        Returns either the value or column, depending
+        on if an instance is provided or not
+
+        :param instance: the model instance
+        :type instance: Model
+        """
+        try:
+            return instance._values[self.column.column_name].getval()
+        except AttributeError:
+            return self.query_evaluator
+
+    def __set__(self, instance, value):
+        """
+        Sets the value on an instance, raises an exception with classes
+        TODO: use None instance to create update statements
+        """
+        if instance:
+            return instance._values[self.column.column_name].setval(value)
+        else:
+            raise AttributeError('cannot reassign column values')
+
+    def __delete__(self, instance):
+        """
+        Sets the column value to None, if possible
+        """
+        if instance:
+            if self.column.can_delete:
+                instance._values[self.column.column_name].delval()
+            else:
+                raise AttributeError('cannot delete {0} columns'.format(self.column.column_name))
+
+
+class BaseModel(object):
+    """
+    The base model class, don't inherit from this, inherit from Model, defined below
+    """
+
+    class DoesNotExist(_DoesNotExist):
+        pass
+
+    class MultipleObjectsReturned(_MultipleObjectsReturned):
+        pass
+
+    objects = QuerySetDescriptor()
+    ttl = TTLDescriptor()
+    consistency = ConsistencyDescriptor()
+    iff = ConditionalDescriptor()
+
+    # custom timestamps, see USING TIMESTAMP X
+    timestamp = TimestampDescriptor()
+
+    if_not_exists = IfNotExistsDescriptor()
+
+    if_exists = IfExistsDescriptor()
+
+    using = UsingDescriptor()
+
+    # _len is lazily created by __len__
+
+    __table_name__ = None
+
+    __table_name_case_sensitive__ = False
+
+    __keyspace__ = None
+
+    __connection__ = None
+
+    __discriminator_value__ = None
+
+    __options__ = None
+
+    __compute_routing_key__ = True
+
+    # the queryset class used for this class
+    __queryset__ = query.ModelQuerySet
+    __dmlquery__ = query.DMLQuery
+
+    __consistency__ = None  # can be set per query
+
+    _timestamp = None  # optional timestamp to include with the operation (USING TIMESTAMP)
+
+    _if_not_exists = False  # optional if_not_exists flag to check existence before insertion
+
+    _if_exists = False  # optional if_exists flag to check existence before update
+
+    _table_name = None  # used internally to cache a derived table name
+
+    _connection = None
+
+    def __init__(self, **values):
+        self._ttl = None
+        self._timestamp = None
+        self._conditional = None
+        self._batch = None
+        self._timeout = connection.NOT_SET
+        self._is_persisted = False
+        self._connection = None
+
+        self._values = {}
+        for name, column in self._columns.items():
+            # Set default values on instantiation. Thanks to this, we don't have
+            # to wait anylonger for a call to validate() to have CQLengine set
+            # default columns values.
+            column_default = column.get_default() if column.has_default else None
+            value = values.get(name, column_default)
+            if value is not None or isinstance(column, columns.BaseContainerColumn):
+                value = column.to_python(value)
+            value_mngr = column.value_manager(self, column, value)
+            value_mngr.explicit = name in values
+            self._values[name] = value_mngr
+
+    def __repr__(self):
+        return '{0}({1})'.format(self.__class__.__name__,
+                               ', '.join('{0}={1!r}'.format(k, getattr(self, k))
+                                         for k in self._defined_columns.keys()
+                                         if k != self._discriminator_column_name))
+
+    def __str__(self):
+        """
+        Pretty printing of models by their primary key
+        """
+        return '{0} <{1}>'.format(self.__class__.__name__,
+                                ', '.join('{0}={1}'.format(k, getattr(self, k)) for k in self._primary_keys.keys()))
+
+    @classmethod
+    def _routing_key_from_values(cls, pk_values, protocol_version):
+        return cls._key_serializer(pk_values, protocol_version)
+
+    @classmethod
+    def _discover_polymorphic_submodels(cls):
+        if not cls._is_polymorphic_base:
+            raise ModelException('_discover_polymorphic_submodels can only be called on polymorphic base classes')
+
+        def _discover(klass):
+            if not klass._is_polymorphic_base and klass.__discriminator_value__ is not None:
+                cls._discriminator_map[klass.__discriminator_value__] = klass
+            for subklass in klass.__subclasses__():
+                _discover(subklass)
+        _discover(cls)
+
+    @classmethod
+    def _get_model_by_discriminator_value(cls, key):
+        if not cls._is_polymorphic_base:
+            raise ModelException('_get_model_by_discriminator_value can only be called on polymorphic base classes')
+        return cls._discriminator_map.get(key)
+
+    @classmethod
+    def _construct_instance(cls, values):
+        """
+        method used to construct instances from query results
+        this is where polymorphic deserialization occurs
+        """
+        # we're going to take the values, which is from the DB as a dict
+        # and translate that into our local fields
+        # the db_map is a db_field -> model field map
+        if cls._db_map:
+            values = dict((cls._db_map.get(k, k), v) for k, v in values.items())
+
+        if cls._is_polymorphic:
+            disc_key = values.get(cls._discriminator_column_name)
+
+            if disc_key is None:
+                raise PolymorphicModelException('discriminator value was not found in values')
+
+            poly_base = cls if cls._is_polymorphic_base else cls._polymorphic_base
+
+            klass = poly_base._get_model_by_discriminator_value(disc_key)
+            if klass is None:
+                poly_base._discover_polymorphic_submodels()
+                klass = poly_base._get_model_by_discriminator_value(disc_key)
+                if klass is None:
+                    raise PolymorphicModelException(
+                        'unrecognized discriminator column {0} for class {1}'.format(disc_key, poly_base.__name__)
+                    )
+
+            if not issubclass(klass, cls):
+                raise PolymorphicModelException(
+                    '{0} is not a subclass of {1}'.format(klass.__name__, cls.__name__)
+                )
+
+            values = dict((k, v) for k, v in values.items() if k in klass._columns.keys())
+
+        else:
+            klass = cls
+
+        instance = klass(**values)
+        instance._set_persisted(force=True)
+        return instance
+
+    def _set_persisted(self, force=False):
+        # ensure we don't modify to any values not affected by the last save/update
+        for v in [v for v in self._values.values() if v.changed or force]:
+            v.reset_previous_value()
+            v.explicit = False
+        self._is_persisted = True
+
+    def _can_update(self):
+        """
+        Called by the save function to check if this should be
+        persisted with update or insert
+
+        :return:
+        """
+        if not self._is_persisted:
+            return False
+
+        return all([not self._values[k].changed for k in self._primary_keys])
+
+    @classmethod
+    def _get_keyspace(cls):
+        """
+        Returns the manual keyspace, if set, otherwise the default keyspace
+        """
+        return cls.__keyspace__ or DEFAULT_KEYSPACE
+
+    @classmethod
+    def _get_column(cls, name):
+        """
+        Returns the column matching the given name, raising a key error if
+        it doesn't exist
+
+        :param name: the name of the column to return
+        :rtype: Column
+        """
+        return cls._columns[name]
+
+    @classmethod
+    def _get_column_by_db_name(cls, name):
+        """
+        Returns the column, mapped by db_field name
+        """
+        return cls._columns.get(cls._db_map.get(name, name))
+
+    def __eq__(self, other):
+        if self.__class__ != other.__class__:
+            return False
+
+        # check attribute keys
+        keys = set(self._columns.keys())
+        other_keys = set(other._columns.keys())
+        if keys != other_keys:
+            return False
+
+        return all(getattr(self, key, None) == getattr(other, key, None) for key in other_keys)
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    @classmethod
+    def column_family_name(cls, include_keyspace=True):
+        """
+        Returns the column family name if it's been defined
+        otherwise, it creates it from the module and class name
+        """
+        cf_name = protect_name(cls._raw_column_family_name())
+        if include_keyspace:
+            keyspace = cls._get_keyspace()
+            if not keyspace:
+                raise CQLEngineException("Model keyspace is not set and no default is available. Set model keyspace or setup connection before attempting to generate a query.")
+            return '{0}.{1}'.format(protect_name(keyspace), cf_name)
+
+        return cf_name
+
+
+    @classmethod
+    def _raw_column_family_name(cls):
+        if not cls._table_name:
+            if cls.__table_name__:
+                if cls.__table_name_case_sensitive__:
+                    warn("Model __table_name_case_sensitive__ will be removed in 4.0.", PendingDeprecationWarning)
+                    cls._table_name = cls.__table_name__
+                else:
+                    table_name = cls.__table_name__.lower()
+                    if cls.__table_name__ != table_name:
+                        warn(("Model __table_name__ will be case sensitive by default in 4.0. "
+                        "You should fix the __table_name__ value of the '{0}' model.").format(cls.__name__))
+                    cls._table_name = table_name
+            else:
+                if cls._is_polymorphic and not cls._is_polymorphic_base:
+                    cls._table_name = cls._polymorphic_base._raw_column_family_name()
+                else:
+                    camelcase = re.compile(r'([a-z])([A-Z])')
+                    ccase = lambda s: camelcase.sub(lambda v: '{0}_{1}'.format(v.group(1), v.group(2).lower()), s)
+
+                    cf_name = ccase(cls.__name__)
+                    # trim to less than 48 characters or cassandra will complain
+                    cf_name = cf_name[-48:]
+                    cf_name = cf_name.lower()
+                    cf_name = re.sub(r'^_+', '', cf_name)
+                    cls._table_name = cf_name
+
+        return cls._table_name
+
+    def _set_column_value(self, name, value):
+        """Function to change a column value without changing the value manager states"""
+        self._values[name].value = value  # internal assignement, skip the main setter
+
+    def validate(self):
+        """
+        Cleans and validates the field values
+        """
+        for name, col in self._columns.items():
+            v = getattr(self, name)
+            if v is None and not self._values[name].explicit and col.has_default:
+                v = col.get_default()
+            val = col.validate(v)
+            self._set_column_value(name, val)
+
+    # Let an instance be used like a dict of its columns keys/values
+    def __iter__(self):
+        """ Iterate over column ids. """
+        for column_id in self._columns.keys():
+            yield column_id
+
+    def __getitem__(self, key):
+        """ Returns column's value. """
+        if not isinstance(key, str):
+            raise TypeError
+        if key not in self._columns.keys():
+            raise KeyError
+        return getattr(self, key)
+
+    def __setitem__(self, key, val):
+        """ Sets a column's value. """
+        if not isinstance(key, str):
+            raise TypeError
+        if key not in self._columns.keys():
+            raise KeyError
+        return setattr(self, key, val)
+
+    def __len__(self):
+        """
+        Returns the number of columns defined on that model.
+        """
+        try:
+            return self._len
+        except:
+            self._len = len(self._columns.keys())
+            return self._len
+
+    def keys(self):
+        """ Returns a list of column IDs. """
+        return [k for k in self]
+
+    def values(self):
+        """ Returns list of column values. """
+        return [self[k] for k in self]
+
+    def items(self):
+        """ Returns a list of column ID/value tuples. """
+        return [(k, self[k]) for k in self]
+
+    def _as_dict(self):
+        """ Returns a map of column names to cleaned values """
+        values = self._dynamic_columns or {}
+        for name, col in self._columns.items():
+            values[name] = col.to_database(getattr(self, name, None))
+        return values
+
+    @classmethod
+    def create(cls, **kwargs):
+        """
+        Create an instance of this model in the database.
+
+        Takes the model column values as keyword arguments. Setting a value to
+        `None` is equivalent to running a CQL `DELETE` on that column.
+
+        Returns the instance.
+        """
+        extra_columns = set(kwargs.keys()) - set(cls._columns.keys())
+        if extra_columns:
+            raise ValidationError("Incorrect columns passed: {0}".format(extra_columns))
+        return cls.objects.create(**kwargs)
+
+    @classmethod
+    def all(cls):
+        """
+        Returns a queryset representing all stored objects
+
+        This is a pass-through to the model objects().all()
+        """
+        return cls.objects.all()
+
+    @classmethod
+    def filter(cls, *args, **kwargs):
+        """
+        Returns a queryset based on filter parameters.
+
+        This is a pass-through to the model objects().:method:`~cqlengine.queries.filter`.
+        """
+        return cls.objects.filter(*args, **kwargs)
+
+    @classmethod
+    def get(cls, *args, **kwargs):
+        """
+        Returns a single object based on the passed filter constraints.
+
+        This is a pass-through to the model objects().:method:`~cqlengine.queries.get`.
+        """
+        return cls.objects.get(*args, **kwargs)
+
+    def timeout(self, timeout):
+        """
+        Sets a timeout for use in :meth:`~.save`, :meth:`~.update`, and :meth:`~.delete`
+        operations
+        """
+        assert self._batch is None, 'Setting both timeout and batch is not supported'
+        self._timeout = timeout
+        return self
+
+    def save(self):
+        """
+        Saves an object to the database.
+
+        .. code-block:: python
+
+            #create a person instance
+            person = Person(first_name='Kimberly', last_name='Eggleston')
+            #saves it to Cassandra
+            person.save()
+        """
+
+        # handle polymorphic models
+        if self._is_polymorphic:
+            if self._is_polymorphic_base:
+                raise PolymorphicModelException('cannot save polymorphic base model')
+            else:
+                setattr(self, self._discriminator_column_name, self.__discriminator_value__)
+
+        self.validate()
+        self.__dmlquery__(self.__class__, self,
+                          batch=self._batch,
+                          ttl=self._ttl,
+                          timestamp=self._timestamp,
+                          consistency=self.__consistency__,
+                          if_not_exists=self._if_not_exists,
+                          conditional=self._conditional,
+                          timeout=self._timeout,
+                          if_exists=self._if_exists).save()
+
+        self._set_persisted()
+
+        self._timestamp = None
+
+        return self
+
+    def update(self, **values):
+        """
+        Performs an update on the model instance. You can pass in values to set on the model
+        for updating, or you can call without values to execute an update against any modified
+        fields. If no fields on the model have been modified since loading, no query will be
+        performed. Model validation is performed normally. Setting a value to `None` is
+        equivalent to running a CQL `DELETE` on that column.
+
+        It is possible to do a blind update, that is, to update a field without having first selected the object out of the database.
+        See :ref:`Blind Updates <blind_updates>`
+        """
+        for column_id, v in values.items():
+            col = self._columns.get(column_id)
+
+            # check for nonexistant columns
+            if col is None:
+                raise ValidationError(
+                    "{0}.{1} has no column named: {2}".format(
+                        self.__module__, self.__class__.__name__, column_id))
+
+            # check for primary key update attempts
+            if col.is_primary_key:
+                current_value = getattr(self, column_id)
+                if v != current_value:
+                    raise ValidationError(
+                        "Cannot apply update to primary key '{0}' for {1}.{2}".format(
+                            column_id, self.__module__, self.__class__.__name__))
+
+            setattr(self, column_id, v)
+
+        # handle polymorphic models
+        if self._is_polymorphic:
+            if self._is_polymorphic_base:
+                raise PolymorphicModelException('cannot update polymorphic base model')
+            else:
+                setattr(self, self._discriminator_column_name, self.__discriminator_value__)
+
+        self.validate()
+        self.__dmlquery__(self.__class__, self,
+                          batch=self._batch,
+                          ttl=self._ttl,
+                          timestamp=self._timestamp,
+                          consistency=self.__consistency__,
+                          conditional=self._conditional,
+                          timeout=self._timeout,
+                          if_exists=self._if_exists).update()
+
+        self._set_persisted()
+
+        self._timestamp = None
+
+        return self
+
+    def delete(self):
+        """
+        Deletes the object from the database
+        """
+        self.__dmlquery__(self.__class__, self,
+                          batch=self._batch,
+                          timestamp=self._timestamp,
+                          consistency=self.__consistency__,
+                          timeout=self._timeout,
+                          conditional=self._conditional,
+                          if_exists=self._if_exists).delete()
+
+    def get_changed_columns(self):
+        """
+        Returns a list of the columns that have been updated since instantiation or save
+        """
+        return [k for k, v in self._values.items() if v.changed]
+
+    @classmethod
+    def _class_batch(cls, batch):
+        return cls.objects.batch(batch)
+
+    def _inst_batch(self, batch):
+        assert self._timeout is connection.NOT_SET, 'Setting both timeout and batch is not supported'
+        if self._connection:
+            raise CQLEngineException("Cannot specify a connection on model in batch mode.")
+        self._batch = batch
+        return self
+
+    batch = hybrid_classmethod(_class_batch, _inst_batch)
+
+    @classmethod
+    def _class_get_connection(cls):
+        return cls.__connection__
+
+    def _inst_get_connection(self):
+        return self._connection or self.__connection__
+
+    _get_connection = hybrid_classmethod(_class_get_connection, _inst_get_connection)
+
+
+class ModelMetaClass(type):
+
+    def __new__(cls, name, bases, attrs):
+        # move column definitions into columns dict
+        # and set default column names
+        column_dict = OrderedDict()
+        primary_keys = OrderedDict()
+        pk_name = None
+
+        # get inherited properties
+        inherited_columns = OrderedDict()
+        for base in bases:
+            for k, v in getattr(base, '_defined_columns', {}).items():
+                inherited_columns.setdefault(k, v)
+
+        # short circuit __abstract__ inheritance
+        is_abstract = attrs['__abstract__'] = attrs.get('__abstract__', False)
+
+        # short circuit __discriminator_value__ inheritance
+        attrs['__discriminator_value__'] = attrs.get('__discriminator_value__')
+
+        # TODO __default__ttl__ should be removed in the next major release
+        options = attrs.get('__options__') or {}
+        attrs['__default_ttl__'] = options.get('default_time_to_live')
+
+        column_definitions = [(k, v) for k, v in attrs.items() if isinstance(v, columns.Column)]
+        column_definitions = sorted(column_definitions, key=lambda x: x[1].position)
+
+        is_polymorphic_base = any([c[1].discriminator_column for c in column_definitions])
+
+        column_definitions = [x for x in inherited_columns.items()] + column_definitions
+        discriminator_columns = [c for c in column_definitions if c[1].discriminator_column]
+        is_polymorphic = len(discriminator_columns) > 0
+        if len(discriminator_columns) > 1:
+            raise ModelDefinitionException('only one discriminator_column can be defined in a model, {0} found'.format(len(discriminator_columns)))
+
+        if attrs['__discriminator_value__'] and not is_polymorphic:
+            raise ModelDefinitionException('__discriminator_value__ specified, but no base columns defined with discriminator_column=True')
+
+        discriminator_column_name, discriminator_column = discriminator_columns[0] if discriminator_columns else (None, None)
+
+        if isinstance(discriminator_column, (columns.BaseContainerColumn, columns.Counter)):
+            raise ModelDefinitionException('counter and container columns cannot be used as discriminator columns')
+
+        # find polymorphic base class
+        polymorphic_base = None
+        if is_polymorphic and not is_polymorphic_base:
+            def _get_polymorphic_base(bases):
+                for base in bases:
+                    if getattr(base, '_is_polymorphic_base', False):
+                        return base
+                    klass = _get_polymorphic_base(base.__bases__)
+                    if klass:
+                        return klass
+            polymorphic_base = _get_polymorphic_base(bases)
+
+        defined_columns = OrderedDict(column_definitions)
+
+        # check for primary key
+        if not is_abstract and not any([v.primary_key for k, v in column_definitions]):
+            raise ModelDefinitionException("At least 1 primary key is required.")
+
+        counter_columns = [c for c in defined_columns.values() if isinstance(c, columns.Counter)]
+        data_columns = [c for c in defined_columns.values() if not c.primary_key and not isinstance(c, columns.Counter)]
+        if counter_columns and data_columns:
+            raise ModelDefinitionException('counter models may not have data columns')
+
+        has_partition_keys = any(v.partition_key for (k, v) in column_definitions)
+
+        def _transform_column(col_name, col_obj):
+            column_dict[col_name] = col_obj
+            if col_obj.primary_key:
+                primary_keys[col_name] = col_obj
+            col_obj.set_column_name(col_name)
+            # set properties
+            attrs[col_name] = ColumnDescriptor(col_obj)
+
+        partition_key_index = 0
+        # transform column definitions
+        for k, v in column_definitions:
+            # don't allow a column with the same name as a built-in attribute or method
+            if k in BaseModel.__dict__:
+                raise ModelDefinitionException("column '{0}' conflicts with built-in attribute/method".format(k))
+
+            # counter column primary keys are not allowed
+            if (v.primary_key or v.partition_key) and isinstance(v, columns.Counter):
+                raise ModelDefinitionException('counter columns cannot be used as primary keys')
+
+            # this will mark the first primary key column as a partition
+            # key, if one hasn't been set already
+            if not has_partition_keys and v.primary_key:
+                v.partition_key = True
+                has_partition_keys = True
+            if v.partition_key:
+                v._partition_key_index = partition_key_index
+                partition_key_index += 1
+
+            overriding = column_dict.get(k)
+            if overriding:
+                v.position = overriding.position
+                v.partition_key = overriding.partition_key
+                v._partition_key_index = overriding._partition_key_index
+            _transform_column(k, v)
+
+        partition_keys = OrderedDict(k for k in primary_keys.items() if k[1].partition_key)
+        clustering_keys = OrderedDict(k for k in primary_keys.items() if not k[1].partition_key)
+
+        if attrs.get('__compute_routing_key__', True):
+            key_cols = [c for c in partition_keys.values()]
+            partition_key_index = dict((col.db_field_name, col._partition_key_index) for col in key_cols)
+            key_cql_types = [c.cql_type for c in key_cols]
+            key_serializer = staticmethod(lambda parts, proto_version: [t.to_binary(p, proto_version) for t, p in zip(key_cql_types, parts)])
+        else:
+            partition_key_index = {}
+            key_serializer = staticmethod(lambda parts, proto_version: None)
+
+        # setup partition key shortcut
+        if len(partition_keys) == 0:
+            if not is_abstract:
+                raise ModelException("at least one partition key must be defined")
+        if len(partition_keys) == 1:
+            pk_name = [x for x in partition_keys.keys()][0]
+            attrs['pk'] = attrs[pk_name]
+        else:
+            # composite partition key case, get/set a tuple of values
+            _get = lambda self: tuple(self._values[c].getval() for c in partition_keys.keys())
+            _set = lambda self, val: tuple(self._values[c].setval(v) for (c, v) in zip(partition_keys.keys(), val))
+            attrs['pk'] = property(_get, _set)
+
+        # some validation
+        col_names = set()
+        for v in column_dict.values():
+            # check for duplicate column names
+            if v.db_field_name in col_names:
+                raise ModelException("{0} defines the column '{1}' more than once".format(name, v.db_field_name))
+            if v.clustering_order and not (v.primary_key and not v.partition_key):
+                raise ModelException("clustering_order may be specified only for clustering primary keys")
+            if v.clustering_order and v.clustering_order.lower() not in ('asc', 'desc'):
+                raise ModelException("invalid clustering order '{0}' for column '{1}'".format(repr(v.clustering_order), v.db_field_name))
+            col_names.add(v.db_field_name)
+
+        # create db_name -> model name map for loading
+        db_map = {}
+        for col_name, field in column_dict.items():
+            db_field = field.db_field_name
+            if db_field != col_name:
+                db_map[db_field] = col_name
+
+        # add management members to the class
+        attrs['_columns'] = column_dict
+        attrs['_primary_keys'] = primary_keys
+        attrs['_defined_columns'] = defined_columns
+
+        # maps the database field to the models key
+        attrs['_db_map'] = db_map
+        attrs['_pk_name'] = pk_name
+        attrs['_dynamic_columns'] = {}
+
+        attrs['_partition_keys'] = partition_keys
+        attrs['_partition_key_index'] = partition_key_index
+        attrs['_key_serializer'] = key_serializer
+        attrs['_clustering_keys'] = clustering_keys
+        attrs['_has_counter'] = len(counter_columns) > 0
+
+        # add polymorphic management attributes
+        attrs['_is_polymorphic_base'] = is_polymorphic_base
+        attrs['_is_polymorphic'] = is_polymorphic
+        attrs['_polymorphic_base'] = polymorphic_base
+        attrs['_discriminator_column'] = discriminator_column
+        attrs['_discriminator_column_name'] = discriminator_column_name
+        attrs['_discriminator_map'] = {} if is_polymorphic_base else None
+
+        # setup class exceptions
+        DoesNotExistBase = None
+        for base in bases:
+            DoesNotExistBase = getattr(base, 'DoesNotExist', None)
+            if DoesNotExistBase is not None:
+                break
+
+        DoesNotExistBase = DoesNotExistBase or attrs.pop('DoesNotExist', BaseModel.DoesNotExist)
+        attrs['DoesNotExist'] = type('DoesNotExist', (DoesNotExistBase,), {})
+
+        MultipleObjectsReturnedBase = None
+        for base in bases:
+            MultipleObjectsReturnedBase = getattr(base, 'MultipleObjectsReturned', None)
+            if MultipleObjectsReturnedBase is not None:
+                break
+
+        MultipleObjectsReturnedBase = MultipleObjectsReturnedBase or attrs.pop('MultipleObjectsReturned', BaseModel.MultipleObjectsReturned)
+        attrs['MultipleObjectsReturned'] = type('MultipleObjectsReturned', (MultipleObjectsReturnedBase,), {})
+
+        # create the class and add a QuerySet to it
+        klass = super(ModelMetaClass, cls).__new__(cls, name, bases, attrs)
+
+        udts = []
+        for col in column_dict.values():
+            columns.resolve_udts(col, udts)
+
+        for user_type in set(udts):
+            user_type.register_for_keyspace(klass._get_keyspace())
+
+        return klass
+
+
+class Model(BaseModel, metaclass=ModelMetaClass):
+    __abstract__ = True
+    """
+    *Optional.* Indicates that this model is only intended to be used as a base class for other models.
+    You can't create tables for abstract models, but checks around schema validity are skipped during class construction.
+    """
+
+    __table_name__ = None
+    """
+    *Optional.* Sets the name of the CQL table for this model. If left blank, the table name will be the name of the model, with it's module name as it's prefix. Manually defined table names are not inherited.
+    """
+
+    __table_name_case_sensitive__ = False
+    """
+    *Optional.* By default, __table_name__ is case insensitive. Set this to True if you want to preserve the case sensitivity.
+    """
+
+    __keyspace__ = None
+    """
+    Sets the name of the keyspace used by this model.
+    """
+
+    __connection__ = None
+    """
+    Sets the name of the default connection used by this model.
+    """
+
+    __options__ = None
+    """
+    *Optional* Table options applied with this model
+
+    (e.g. compaction, default ttl, cache settings, tec.)
+    """
+
+    __discriminator_value__ = None
+    """
+    *Optional* Specifies a value for the discriminator column when using model inheritance.
+    """
+
+    __compute_routing_key__ = True
+    """
+    *Optional* Setting False disables computing the routing key for TokenAwareRouting
+    """
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/named.py b/llm/Lib/site-packages/cassandra/cqlengine/named.py
new file mode 100644
index 0000000000000000000000000000000000000000..751893a7743e878cfb258eda9563e00ac2e032e4
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cqlengine/named.py
@@ -0,0 +1,169 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from cassandra.util import OrderedDict
+
+from cassandra.cqlengine import CQLEngineException
+from cassandra.cqlengine.columns import Column
+from cassandra.cqlengine.connection import get_cluster
+from cassandra.cqlengine.models import UsingDescriptor, BaseModel
+from cassandra.cqlengine.query import AbstractQueryableColumn, SimpleQuerySet
+from cassandra.cqlengine.query import DoesNotExist as _DoesNotExist
+from cassandra.cqlengine.query import MultipleObjectsReturned as _MultipleObjectsReturned
+
+
+class QuerySetDescriptor(object):
+    """
+    returns a fresh queryset for the given model
+    it's declared on everytime it's accessed
+    """
+
+    def __get__(self, obj, model):
+        """ :rtype: ModelQuerySet """
+        if model.__abstract__:
+            raise CQLEngineException('cannot execute queries against abstract models')
+        return SimpleQuerySet(obj)
+
+    def __call__(self, *args, **kwargs):
+        """
+        Just a hint to IDEs that it's ok to call this
+
+        :rtype: ModelQuerySet
+        """
+        raise NotImplementedError
+
+
+class NamedColumn(AbstractQueryableColumn):
+    """
+    A column that is not coupled to a model class, or type
+    """
+
+    def __init__(self, name):
+        self.name = name
+
+    def __unicode__(self):
+        return self.name
+
+    def _get_column(self):
+        """ :rtype: NamedColumn """
+        return self
+
+    @property
+    def db_field_name(self):
+        return self.name
+
+    @property
+    def cql(self):
+        return self.get_cql()
+
+    def get_cql(self):
+        return '"{0}"'.format(self.name)
+
+    def to_database(self, val):
+        return val
+
+
+class NamedTable(object):
+    """
+    A Table that is not coupled to a model class
+    """
+
+    __abstract__ = False
+
+    objects = QuerySetDescriptor()
+
+    __partition_keys = None
+
+    _partition_key_index = None
+
+    __connection__ = None
+    _connection = None
+
+    using = UsingDescriptor()
+
+    _get_connection = BaseModel._get_connection
+
+    class DoesNotExist(_DoesNotExist):
+        pass
+
+    class MultipleObjectsReturned(_MultipleObjectsReturned):
+        pass
+
+    def __init__(self, keyspace, name):
+        self.keyspace = keyspace
+        self.name = name
+        self._connection = None
+
+    @property
+    def _partition_keys(self):
+        if not self.__partition_keys:
+            self._get_partition_keys()
+        return self.__partition_keys
+
+    def _get_partition_keys(self):
+        try:
+            table_meta = get_cluster(self._get_connection()).metadata.keyspaces[self.keyspace].tables[self.name]
+            self.__partition_keys = OrderedDict((pk.name, Column(primary_key=True, partition_key=True, db_field=pk.name)) for pk in table_meta.partition_key)
+        except Exception as e:
+            raise CQLEngineException("Failed inspecting partition keys for {0}."
+                                     "Ensure cqlengine is connected before attempting this with NamedTable.".format(self.column_family_name()))
+
+    def column(self, name):
+        return NamedColumn(name)
+
+    def column_family_name(self, include_keyspace=True):
+        """
+        Returns the column family name if it's been defined
+        otherwise, it creates it from the module and class name
+        """
+        if include_keyspace:
+            return '{0}.{1}'.format(self.keyspace, self.name)
+        else:
+            return self.name
+
+    def _get_column(self, name):
+        """
+        Returns the column matching the given name
+
+        :rtype: Column
+        """
+        return self.column(name)
+
+    # def create(self, **kwargs):
+    #     return self.objects.create(**kwargs)
+
+    def all(self):
+        return self.objects.all()
+
+    def filter(self, *args, **kwargs):
+        return self.objects.filter(*args, **kwargs)
+
+    def get(self, *args, **kwargs):
+        return self.objects.get(*args, **kwargs)
+
+
+class NamedKeyspace(object):
+    """
+    A keyspace
+    """
+
+    def __init__(self, name):
+        self.name = name
+
+    def table(self, name):
+        """
+        returns a table descriptor with the given
+        name that belongs to this keyspace
+        """
+        return NamedTable(self.name, name)
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/operators.py b/llm/Lib/site-packages/cassandra/cqlengine/operators.py
new file mode 100644
index 0000000000000000000000000000000000000000..5d4d942692c033754001e82a7924fcef39fd2de0
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cqlengine/operators.py
@@ -0,0 +1,103 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from cassandra.cqlengine import UnicodeMixin
+
+
+class QueryOperatorException(Exception):
+    pass
+
+
+class BaseQueryOperator(UnicodeMixin):
+    # The symbol that identifies this operator in kwargs
+    # ie: colname__<symbol>
+    symbol = None
+
+    # The comparator symbol this operator uses in cql
+    cql_symbol = None
+
+    def __unicode__(self):
+        if self.cql_symbol is None:
+            raise QueryOperatorException("cql symbol is None")
+        return self.cql_symbol
+
+
+class OpMapMeta(type):
+
+    def __init__(cls, name, bases, dct):
+        if not hasattr(cls, 'opmap'):
+            cls.opmap = {}
+        else:
+            cls.opmap[cls.symbol] = cls
+        super(OpMapMeta, cls).__init__(name, bases, dct)
+
+
+class BaseWhereOperator(BaseQueryOperator, metaclass=OpMapMeta):
+    """ base operator used for where clauses """
+    @classmethod
+    def get_operator(cls, symbol):
+        try:
+            return cls.opmap[symbol.upper()]
+        except KeyError:
+            raise QueryOperatorException("{0} doesn't map to a QueryOperator".format(symbol))
+
+
+class EqualsOperator(BaseWhereOperator):
+    symbol = 'EQ'
+    cql_symbol = '='
+
+
+class NotEqualsOperator(BaseWhereOperator):
+    symbol = 'NE'
+    cql_symbol = '!='
+
+
+class InOperator(EqualsOperator):
+    symbol = 'IN'
+    cql_symbol = 'IN'
+
+
+class GreaterThanOperator(BaseWhereOperator):
+    symbol = "GT"
+    cql_symbol = '>'
+
+
+class GreaterThanOrEqualOperator(BaseWhereOperator):
+    symbol = "GTE"
+    cql_symbol = '>='
+
+
+class LessThanOperator(BaseWhereOperator):
+    symbol = "LT"
+    cql_symbol = '<'
+
+
+class LessThanOrEqualOperator(BaseWhereOperator):
+    symbol = "LTE"
+    cql_symbol = '<='
+
+
+class ContainsOperator(EqualsOperator):
+    symbol = "CONTAINS"
+    cql_symbol = 'CONTAINS'
+
+
+class LikeOperator(EqualsOperator):
+    symbol = "LIKE"
+    cql_symbol = 'LIKE'
+
+
+class IsNotNullOperator(EqualsOperator):
+    symbol = "IS NOT NULL"
+    cql_symbol = 'IS NOT NULL'
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/query.py b/llm/Lib/site-packages/cassandra/cqlengine/query.py
new file mode 100644
index 0000000000000000000000000000000000000000..6499141ad17325793733f754e9946c87a8510e78
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cqlengine/query.py
@@ -0,0 +1,1530 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import copy
+from datetime import datetime, timedelta
+from functools import partial
+import time
+from warnings import warn
+
+from cassandra.query import SimpleStatement, BatchType as CBatchType, BatchStatement
+from cassandra.cqlengine import columns, CQLEngineException, ValidationError, UnicodeMixin
+from cassandra.cqlengine import connection as conn
+from cassandra.cqlengine.functions import Token, BaseQueryFunction, QueryValue
+from cassandra.cqlengine.operators import (InOperator, EqualsOperator, GreaterThanOperator,
+                                           GreaterThanOrEqualOperator, LessThanOperator,
+                                           LessThanOrEqualOperator, ContainsOperator, BaseWhereOperator)
+from cassandra.cqlengine.statements import (WhereClause, SelectStatement, DeleteStatement,
+                                            UpdateStatement, InsertStatement,
+                                            BaseCQLStatement, MapDeleteClause, ConditionalClause)
+
+
+class QueryException(CQLEngineException):
+    pass
+
+
+class IfNotExistsWithCounterColumn(CQLEngineException):
+    pass
+
+
+class IfExistsWithCounterColumn(CQLEngineException):
+    pass
+
+
+class LWTException(CQLEngineException):
+    """Lightweight conditional exception.
+
+    This exception will be raised when a write using an `IF` clause could not be
+    applied due to existing data violating the condition. The existing data is
+    available through the ``existing`` attribute.
+
+    :param existing: The current state of the data which prevented the write.
+    """
+    def __init__(self, existing):
+        super(LWTException, self).__init__("LWT Query was not applied")
+        self.existing = existing
+
+
+class DoesNotExist(QueryException):
+    pass
+
+
+class MultipleObjectsReturned(QueryException):
+    pass
+
+
+def check_applied(result):
+    """
+    Raises LWTException if it looks like a failed LWT request. A LWTException
+    won't be raised in the special case in which there are several failed LWT
+    in a  :class:`~cqlengine.query.BatchQuery`.
+    """
+    try:
+        applied = result.was_applied
+    except Exception:
+        applied = True  # result was not LWT form
+    if not applied:
+        raise LWTException(result.one())
+
+
+class AbstractQueryableColumn(UnicodeMixin):
+    """
+    exposes cql query operators through pythons
+    builtin comparator symbols
+    """
+
+    def _get_column(self):
+        raise NotImplementedError
+
+    def __unicode__(self):
+        raise NotImplementedError
+
+    def _to_database(self, val):
+        if isinstance(val, QueryValue):
+            return val
+        else:
+            return self._get_column().to_database(val)
+
+    def in_(self, item):
+        """
+        Returns an in operator
+
+        used where you'd typically want to use python's `in` operator
+        """
+        return WhereClause(str(self), InOperator(), item)
+
+    def contains_(self, item):
+        """
+        Returns a CONTAINS operator
+        """
+        return WhereClause(str(self), ContainsOperator(), item)
+
+
+    def __eq__(self, other):
+        return WhereClause(str(self), EqualsOperator(), self._to_database(other))
+
+    def __gt__(self, other):
+        return WhereClause(str(self), GreaterThanOperator(), self._to_database(other))
+
+    def __ge__(self, other):
+        return WhereClause(str(self), GreaterThanOrEqualOperator(), self._to_database(other))
+
+    def __lt__(self, other):
+        return WhereClause(str(self), LessThanOperator(), self._to_database(other))
+
+    def __le__(self, other):
+        return WhereClause(str(self), LessThanOrEqualOperator(), self._to_database(other))
+
+
+class BatchType(object):
+    Unlogged = 'UNLOGGED'
+    Counter = 'COUNTER'
+
+
+class BatchQuery(object):
+    """
+    Handles the batching of queries
+
+    http://docs.datastax.com/en/cql/3.0/cql/cql_reference/batch_r.html
+
+    See :doc:`/cqlengine/batches` for more details.
+    """
+    warn_multiple_exec = True
+
+    _consistency = None
+
+    _connection = None
+    _connection_explicit = False
+
+
+    def __init__(self, batch_type=None, timestamp=None, consistency=None, execute_on_exception=False,
+                 timeout=conn.NOT_SET, connection=None):
+        """
+        :param batch_type: (optional) One of batch type values available through BatchType enum
+        :type batch_type: BatchType, str or None
+        :param timestamp: (optional) A datetime or timedelta object with desired timestamp to be applied
+            to the batch conditional.
+        :type timestamp: datetime or timedelta or None
+        :param consistency: (optional) One of consistency values ("ANY", "ONE", "QUORUM" etc)
+        :type consistency: The :class:`.ConsistencyLevel` to be used for the batch query, or None.
+        :param execute_on_exception: (Defaults to False) Indicates that when the BatchQuery instance is used
+            as a context manager the queries accumulated within the context must be executed despite
+            encountering an error within the context. By default, any exception raised from within
+            the context scope will cause the batched queries not to be executed.
+        :type execute_on_exception: bool
+        :param timeout: (optional) Timeout for the entire batch (in seconds), if not specified fallback
+            to default session timeout
+        :type timeout: float or None
+        :param str connection: Connection name to use for the batch execution
+        """
+        self.queries = []
+        self.batch_type = batch_type
+        if timestamp is not None and not isinstance(timestamp, (datetime, timedelta)):
+            raise CQLEngineException('timestamp object must be an instance of datetime')
+        self.timestamp = timestamp
+        self._consistency = consistency
+        self._execute_on_exception = execute_on_exception
+        self._timeout = timeout
+        self._callbacks = []
+        self._executed = False
+        self._context_entered = False
+        self._connection = connection
+        if connection:
+            self._connection_explicit = True
+
+    def add_query(self, query):
+        if not isinstance(query, BaseCQLStatement):
+            raise CQLEngineException('only BaseCQLStatements can be added to a batch query')
+        self.queries.append(query)
+
+    def consistency(self, consistency):
+        self._consistency = consistency
+
+    def _execute_callbacks(self):
+        for callback, args, kwargs in self._callbacks:
+            callback(*args, **kwargs)
+
+    def add_callback(self, fn, *args, **kwargs):
+        """Add a function and arguments to be passed to it to be executed after the batch executes.
+
+        A batch can support multiple callbacks.
+
+        Note, that if the batch does not execute, the callbacks are not executed.
+        A callback, thus, is an "on batch success" handler.
+
+        :param fn: Callable object
+        :type fn: callable
+        :param \*args: Positional arguments to be passed to the callback at the time of execution
+        :param \*\*kwargs: Named arguments to be passed to the callback at the time of execution
+        """
+        if not callable(fn):
+            raise ValueError("Value for argument 'fn' is {0} and is not a callable object.".format(type(fn)))
+        self._callbacks.append((fn, args, kwargs))
+
+    def execute(self):
+        if self._executed and self.warn_multiple_exec:
+            msg = "Batch executed multiple times."
+            if self._context_entered:
+                msg += " If using the batch as a context manager, there is no need to call execute directly."
+            warn(msg)
+        self._executed = True
+
+        if len(self.queries) == 0:
+            # Empty batch is a no-op
+            # except for callbacks
+            self._execute_callbacks()
+            return
+
+        batch_type = None if self.batch_type is CBatchType.LOGGED else self.batch_type
+        opener = 'BEGIN ' + (str(batch_type) + ' ' if batch_type else '') + ' BATCH'
+        if self.timestamp:
+
+            if isinstance(self.timestamp, int):
+                ts = self.timestamp
+            elif isinstance(self.timestamp, (datetime, timedelta)):
+                ts = self.timestamp
+                if isinstance(self.timestamp, timedelta):
+                    ts += datetime.now()  # Apply timedelta
+                ts = int(time.mktime(ts.timetuple()) * 1e+6 + ts.microsecond)
+            else:
+                raise ValueError("Batch expects a long, a timedelta, or a datetime")
+
+            opener += ' USING TIMESTAMP {0}'.format(ts)
+
+        query_list = [opener]
+        parameters = {}
+        ctx_counter = 0
+        for query in self.queries:
+            query.update_context_id(ctx_counter)
+            ctx = query.get_context()
+            ctx_counter += len(ctx)
+            query_list.append('  ' + str(query))
+            parameters.update(ctx)
+
+        query_list.append('APPLY BATCH;')
+
+        tmp = conn.execute('\n'.join(query_list), parameters, self._consistency, self._timeout, connection=self._connection)
+        check_applied(tmp)
+
+        self.queries = []
+        self._execute_callbacks()
+
+    def __enter__(self):
+        self._context_entered = True
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        # don't execute if there was an exception by default
+        if exc_type is not None and not self._execute_on_exception:
+            return
+        self.execute()
+
+
+class ContextQuery(object):
+    """
+    A Context manager to allow a Model to switch context easily. Presently, the context only
+    specifies a keyspace for model IO.
+
+    :param \*args: One or more models. A model should be a class type, not an instance.
+    :param \*\*kwargs: (optional) Context parameters: can be *keyspace* or *connection*
+
+    For example:
+
+    .. code-block:: python
+
+            with ContextQuery(Automobile, keyspace='test2') as A:
+                A.objects.create(manufacturer='honda', year=2008, model='civic')
+                print(len(A.objects.all()))  # 1 result
+
+            with ContextQuery(Automobile, keyspace='test4') as A:
+                print(len(A.objects.all()))  # 0 result
+
+            # Multiple models
+            with ContextQuery(Automobile, Automobile2, connection='cluster2') as (A, A2):
+                print(len(A.objects.all()))
+                print(len(A2.objects.all()))
+
+    """
+
+    def __init__(self, *args, **kwargs):
+        from cassandra.cqlengine import models
+
+        self.models = []
+
+        if len(args) < 1:
+            raise ValueError("No model provided.")
+
+        keyspace = kwargs.pop('keyspace', None)
+        connection = kwargs.pop('connection', None)
+
+        if kwargs:
+            raise ValueError("Unknown keyword argument(s): {0}".format(
+                ','.join(kwargs.keys())))
+
+        for model in args:
+            try:
+                issubclass(model, models.Model)
+            except TypeError:
+                raise ValueError("Models must be derived from base Model.")
+
+            m = models._clone_model_class(model, {})
+
+            if keyspace:
+                m.__keyspace__ = keyspace
+            if connection:
+                m.__connection__ = connection
+
+            self.models.append(m)
+
+    def __enter__(self):
+        if len(self.models) > 1:
+            return tuple(self.models)
+        return self.models[0]
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        return
+
+
+class AbstractQuerySet(object):
+
+    def __init__(self, model):
+        super(AbstractQuerySet, self).__init__()
+        self.model = model
+
+        # Where clause filters
+        self._where = []
+
+        # Conditional clause filters
+        self._conditional = []
+
+        # ordering arguments
+        self._order = []
+
+        self._allow_filtering = False
+
+        # CQL has a default limit of 10000, it's defined here
+        # because explicit is better than implicit
+        self._limit = 10000
+
+        # We store the fields for which we use the Equal operator
+        # in a query, so we don't select it from the DB. _defer_fields
+        # will contain the names of the fields in the DB, not the names
+        # of the variables used by the mapper
+        self._defer_fields = set()
+        self._deferred_values = {}
+
+        # This variable will hold the names in the database of the fields
+        # for which we want to query
+        self._only_fields = []
+
+        self._values_list = False
+        self._flat_values_list = False
+
+        # results cache
+        self._result_cache = None
+        self._result_idx = None
+        self._result_generator = None
+        self._materialize_results = True
+
+        self._distinct_fields = None
+
+        self._count = None
+
+        self._batch = None
+        self._ttl =  None
+        self._consistency = None
+        self._timestamp = None
+        self._if_not_exists = False
+        self._timeout = conn.NOT_SET
+        self._if_exists = False
+        self._fetch_size = None
+        self._connection = None
+
+    @property
+    def column_family_name(self):
+        return self.model.column_family_name()
+
+    def _execute(self, statement):
+        if self._batch:
+            return self._batch.add_query(statement)
+        else:
+            connection = self._connection or self.model._get_connection()
+            result = _execute_statement(self.model, statement, self._consistency, self._timeout, connection=connection)
+            if self._if_not_exists or self._if_exists or self._conditional:
+                check_applied(result)
+            return result
+
+    def __unicode__(self):
+        return str(self._select_query())
+
+    def __str__(self):
+        return str(self.__unicode__())
+
+    def __call__(self, *args, **kwargs):
+        return self.filter(*args, **kwargs)
+
+    def __deepcopy__(self, memo):
+        clone = self.__class__(self.model)
+        for k, v in self.__dict__.items():
+            if k in ['_con', '_cur', '_result_cache', '_result_idx', '_result_generator', '_construct_result']:  # don't clone these, which are per-request-execution
+                clone.__dict__[k] = None
+            elif k == '_batch':
+                # we need to keep the same batch instance across
+                # all queryset clones, otherwise the batched queries
+                # fly off into other batch instances which are never
+                # executed, thx @dokai
+                clone.__dict__[k] = self._batch
+            elif k == '_timeout':
+                clone.__dict__[k] = self._timeout
+            else:
+                clone.__dict__[k] = copy.deepcopy(v, memo)
+
+        return clone
+
+    def __len__(self):
+        self._execute_query()
+        return self.count()
+
+    # ----query generation / execution----
+
+    def _select_fields(self):
+        """ returns the fields to select """
+        return []
+
+    def _validate_select_where(self):
+        """ put select query validation here """
+
+    def _select_query(self):
+        """
+        Returns a select clause based on the given filter args
+        """
+        if self._where:
+            self._validate_select_where()
+        return SelectStatement(
+            self.column_family_name,
+            fields=self._select_fields(),
+            where=self._where,
+            order_by=self._order,
+            limit=self._limit,
+            allow_filtering=self._allow_filtering,
+            distinct_fields=self._distinct_fields,
+            fetch_size=self._fetch_size
+        )
+
+    # ----Reads------
+
+    def _execute_query(self):
+        if self._batch:
+            raise CQLEngineException("Only inserts, updates, and deletes are available in batch mode")
+        if self._result_cache is None:
+            self._result_generator = (i for i in self._execute(self._select_query()))
+            self._result_cache = []
+            self._construct_result = self._maybe_inject_deferred(self._get_result_constructor())
+
+            # "DISTINCT COUNT()" is not supported in C* < 2.2, so we need to materialize all results to get
+            # len() and count() working with DISTINCT queries
+            if self._materialize_results or self._distinct_fields:
+                self._fill_result_cache()
+
+    def _fill_result_cache(self):
+        """
+        Fill the result cache with all results.
+        """
+
+        idx = 0
+        try:
+            while True:
+                idx += 1000
+                self._fill_result_cache_to_idx(idx)
+        except StopIteration:
+            pass
+
+        self._count = len(self._result_cache)
+
+    def _fill_result_cache_to_idx(self, idx):
+        self._execute_query()
+        if self._result_idx is None:
+            self._result_idx = -1
+
+        qty = idx - self._result_idx
+        if qty < 1:
+            return
+        else:
+            for idx in range(qty):
+                self._result_idx += 1
+                while True:
+                    try:
+                        self._result_cache[self._result_idx] = self._construct_result(self._result_cache[self._result_idx])
+                        break
+                    except IndexError:
+                        self._result_cache.append(next(self._result_generator))
+
+    def __iter__(self):
+        self._execute_query()
+
+        idx = 0
+        while True:
+            if len(self._result_cache) <= idx:
+                try:
+                    self._result_cache.append(next(self._result_generator))
+                except StopIteration:
+                    break
+
+            instance = self._result_cache[idx]
+            if isinstance(instance, dict):
+                self._fill_result_cache_to_idx(idx)
+            yield self._result_cache[idx]
+
+            idx += 1
+
+    def __getitem__(self, s):
+        self._execute_query()
+
+        if isinstance(s, slice):
+            start = s.start if s.start else 0
+
+            if start < 0 or (s.stop is not None and s.stop < 0):
+                warn("ModelQuerySet slicing with negative indices support will be removed in 4.0.",
+                     DeprecationWarning)
+
+            # calculate the amount of results that need to be loaded
+            end = s.stop
+            if start < 0 or s.stop is None or s.stop < 0:
+                end = self.count()
+
+            try:
+                self._fill_result_cache_to_idx(end)
+            except StopIteration:
+                pass
+
+            return self._result_cache[start:s.stop:s.step]
+        else:
+            try:
+                s = int(s)
+            except (ValueError, TypeError):
+                raise TypeError('QuerySet indices must be integers')
+
+            if s < 0:
+                warn("ModelQuerySet indexing with negative indices support will be removed in 4.0.",
+                     DeprecationWarning)
+
+            # Using negative indexing is costly since we have to execute a count()
+            if s < 0:
+                num_results = self.count()
+                s += num_results
+
+            try:
+                self._fill_result_cache_to_idx(s)
+            except StopIteration:
+                raise IndexError
+
+            return self._result_cache[s]
+
+    def _get_result_constructor(self):
+        """
+        Returns a function that will be used to instantiate query results
+        """
+        raise NotImplementedError
+
+    @staticmethod
+    def _construct_with_deferred(f, deferred, row):
+        row.update(deferred)
+        return f(row)
+
+    def _maybe_inject_deferred(self, constructor):
+        return partial(self._construct_with_deferred, constructor, self._deferred_values)\
+            if self._deferred_values else constructor
+
+    def batch(self, batch_obj):
+        """
+        Set a batch object to run the query on.
+
+        Note: running a select query with a batch object will raise an exception
+        """
+        if self._connection:
+            raise CQLEngineException("Cannot specify the connection on model in batch mode.")
+
+        if batch_obj is not None and not isinstance(batch_obj, BatchQuery):
+            raise CQLEngineException('batch_obj must be a BatchQuery instance or None')
+        clone = copy.deepcopy(self)
+        clone._batch = batch_obj
+        return clone
+
+    def first(self):
+        try:
+            return next(iter(self))
+        except StopIteration:
+            return None
+
+    def all(self):
+        """
+        Returns a queryset matching all rows
+
+        .. code-block:: python
+
+            for user in User.objects().all():
+                print(user)
+        """
+        return copy.deepcopy(self)
+
+    def consistency(self, consistency):
+        """
+        Sets the consistency level for the operation. See :class:`.ConsistencyLevel`.
+
+        .. code-block:: python
+
+            for user in User.objects(id=3).consistency(CL.ONE):
+                print(user)
+        """
+        clone = copy.deepcopy(self)
+        clone._consistency = consistency
+        return clone
+
+    def _parse_filter_arg(self, arg):
+        """
+        Parses a filter arg in the format:
+        <colname>__<op>
+        :returns: colname, op tuple
+        """
+        statement = arg.rsplit('__', 1)
+        if len(statement) == 1:
+            return arg, None
+        elif len(statement) == 2:
+            return (statement[0], statement[1]) if arg != 'pk__token' else (arg, None)
+        else:
+            raise QueryException("Can't parse '{0}'".format(arg))
+
+    def iff(self, *args, **kwargs):
+        """Adds IF statements to queryset"""
+        if len([x for x in kwargs.values() if x is None]):
+            raise CQLEngineException("None values on iff are not allowed")
+
+        clone = copy.deepcopy(self)
+        for operator in args:
+            if not isinstance(operator, ConditionalClause):
+                raise QueryException('{0} is not a valid query operator'.format(operator))
+            clone._conditional.append(operator)
+
+        for arg, val in kwargs.items():
+            if isinstance(val, Token):
+                raise QueryException("Token() values are not valid in conditionals")
+
+            col_name, col_op = self._parse_filter_arg(arg)
+            try:
+                column = self.model._get_column(col_name)
+            except KeyError:
+                raise QueryException("Can't resolve column name: '{0}'".format(col_name))
+
+            if isinstance(val, BaseQueryFunction):
+                query_val = val
+            else:
+                query_val = column.to_database(val)
+
+            operator_class = BaseWhereOperator.get_operator(col_op or 'EQ')
+            operator = operator_class()
+            clone._conditional.append(WhereClause(column.db_field_name, operator, query_val))
+
+        return clone
+
+    def filter(self, *args, **kwargs):
+        """
+        Adds WHERE arguments to the queryset, returning a new queryset
+
+        See :ref:`retrieving-objects-with-filters`
+
+        Returns a QuerySet filtered on the keyword arguments
+        """
+        # add arguments to the where clause filters
+        if len([x for x in kwargs.values() if x is None]):
+            raise CQLEngineException("None values on filter are not allowed")
+
+        clone = copy.deepcopy(self)
+        for operator in args:
+            if not isinstance(operator, WhereClause):
+                raise QueryException('{0} is not a valid query operator'.format(operator))
+            clone._where.append(operator)
+
+        for arg, val in kwargs.items():
+            col_name, col_op = self._parse_filter_arg(arg)
+            quote_field = True
+
+            if not isinstance(val, Token):
+                try:
+                    column = self.model._get_column(col_name)
+                except KeyError:
+                    raise QueryException("Can't resolve column name: '{0}'".format(col_name))
+            else:
+                if col_name != 'pk__token':
+                    raise QueryException("Token() values may only be compared to the 'pk__token' virtual column")
+
+                column = columns._PartitionKeysToken(self.model)
+                quote_field = False
+
+                partition_columns = column.partition_columns
+                if len(partition_columns) != len(val.value):
+                    raise QueryException(
+                        'Token() received {0} arguments but model has {1} partition keys'.format(
+                            len(val.value), len(partition_columns)))
+                val.set_columns(partition_columns)
+
+            # get query operator, or use equals if not supplied
+            operator_class = BaseWhereOperator.get_operator(col_op or 'EQ')
+            operator = operator_class()
+
+            if isinstance(operator, InOperator):
+                if not isinstance(val, (list, tuple)):
+                    raise QueryException('IN queries must use a list/tuple value')
+                query_val = [column.to_database(v) for v in val]
+            elif isinstance(val, BaseQueryFunction):
+                query_val = val
+            elif (isinstance(operator, ContainsOperator) and
+                  isinstance(column, (columns.List, columns.Set, columns.Map))):
+                # For ContainsOperator and collections, we query using the value, not the container
+                query_val = val
+            else:
+                query_val = column.to_database(val)
+                if not col_op:  # only equal values should be deferred
+                    clone._defer_fields.add(column.db_field_name)
+                    clone._deferred_values[column.db_field_name] = val  # map by db field name for substitution in results
+
+            clone._where.append(WhereClause(column.db_field_name, operator, query_val, quote_field=quote_field))
+
+        return clone
+
+    def get(self, *args, **kwargs):
+        """
+        Returns a single instance matching this query, optionally with additional filter kwargs.
+
+        See :ref:`retrieving-objects-with-filters`
+
+        Returns a single object matching the QuerySet.
+
+        .. code-block:: python
+
+            user = User.get(id=1)
+
+        If no objects are matched, a :class:`~.DoesNotExist` exception is raised.
+
+        If more than one object is found, a :class:`~.MultipleObjectsReturned` exception is raised.
+        """
+        if args or kwargs:
+            return self.filter(*args, **kwargs).get()
+
+        self._execute_query()
+
+        # Check that the resultset only contains one element, avoiding sending a COUNT query
+        try:
+            self[1]
+            raise self.model.MultipleObjectsReturned('Multiple objects found')
+        except IndexError:
+            pass
+
+        try:
+            obj = self[0]
+        except IndexError:
+            raise self.model.DoesNotExist
+
+        return obj
+
+    def _get_ordering_condition(self, colname):
+        order_type = 'DESC' if colname.startswith('-') else 'ASC'
+        colname = colname.replace('-', '')
+
+        return colname, order_type
+
+    def order_by(self, *colnames):
+        """
+        Sets the column(s) to be used for ordering
+
+        Default order is ascending, prepend a '-' to any column name for descending
+
+        *Note: column names must be a clustering key*
+
+        .. code-block:: python
+
+            from uuid import uuid1,uuid4
+
+            class Comment(Model):
+                photo_id = UUID(primary_key=True)
+                comment_id = TimeUUID(primary_key=True, default=uuid1) # second primary key component is a clustering key
+                comment = Text()
+
+            sync_table(Comment)
+
+            u = uuid4()
+            for x in range(5):
+                Comment.create(photo_id=u, comment="test %d" % x)
+
+            print("Normal")
+            for comment in Comment.objects(photo_id=u):
+                print(comment.comment_id)
+
+            print("Reversed")
+            for comment in Comment.objects(photo_id=u).order_by("-comment_id"):
+                print(comment.comment_id)
+        """
+        if len(colnames) == 0:
+            clone = copy.deepcopy(self)
+            clone._order = []
+            return clone
+
+        conditions = []
+        for colname in colnames:
+            conditions.append('"{0}" {1}'.format(*self._get_ordering_condition(colname)))
+
+        clone = copy.deepcopy(self)
+        clone._order.extend(conditions)
+        return clone
+
+    def count(self):
+        """
+        Returns the number of rows matched by this query.
+
+        *Note: This function executes a SELECT COUNT() and has a performance cost on large datasets*
+        """
+        if self._batch:
+            raise CQLEngineException("Only inserts, updates, and deletes are available in batch mode")
+
+        if self._count is None:
+            query = self._select_query()
+            query.count = True
+            result = self._execute(query)
+            count_row = result.one().popitem()
+            self._count = count_row[1]
+        return self._count
+
+    def distinct(self, distinct_fields=None):
+        """
+        Returns the DISTINCT rows matched by this query.
+
+        distinct_fields default to the partition key fields if not specified.
+
+        *Note: distinct_fields must be a partition key or a static column*
+
+        .. code-block:: python
+
+            class Automobile(Model):
+                manufacturer = columns.Text(partition_key=True)
+                year = columns.Integer(primary_key=True)
+                model = columns.Text(primary_key=True)
+                price = columns.Decimal()
+
+            sync_table(Automobile)
+
+            # create rows
+
+            Automobile.objects.distinct()
+
+            # or
+
+            Automobile.objects.distinct(['manufacturer'])
+
+        """
+
+        clone = copy.deepcopy(self)
+        if distinct_fields:
+            clone._distinct_fields = distinct_fields
+        else:
+            clone._distinct_fields = [x.column_name for x in self.model._partition_keys.values()]
+
+        return clone
+
+    def limit(self, v):
+        """
+        Limits the number of results returned by Cassandra. Use *0* or *None* to disable.
+
+        *Note that CQL's default limit is 10,000, so all queries without a limit set explicitly will have an implicit limit of 10,000*
+
+        .. code-block:: python
+
+            # Fetch 100 users
+            for user in User.objects().limit(100):
+                print(user)
+
+            # Fetch all users
+            for user in User.objects().limit(None):
+                print(user)
+        """
+
+        if v is None:
+            v = 0
+
+        if not isinstance(v, int):
+            raise TypeError
+        if v == self._limit:
+            return self
+
+        if v < 0:
+            raise QueryException("Negative limit is not allowed")
+
+        clone = copy.deepcopy(self)
+        clone._limit = v
+        return clone
+
+    def fetch_size(self, v):
+        """
+        Sets the number of rows that are fetched at a time.
+
+        *Note that driver's default fetch size is 5000.*
+
+        .. code-block:: python
+
+            for user in User.objects().fetch_size(500):
+                print(user)
+        """
+
+        if not isinstance(v, int):
+            raise TypeError
+        if v == self._fetch_size:
+            return self
+
+        if v < 1:
+            raise QueryException("fetch size less than 1 is not allowed")
+
+        clone = copy.deepcopy(self)
+        clone._fetch_size = v
+        return clone
+
+    def allow_filtering(self):
+        """
+        Enables the (usually) unwise practive of querying on a clustering key without also defining a partition key
+        """
+        clone = copy.deepcopy(self)
+        clone._allow_filtering = True
+        return clone
+
+    def _only_or_defer(self, action, fields):
+        if action == 'only' and self._only_fields:
+            raise QueryException("QuerySet already has 'only' fields defined")
+
+        clone = copy.deepcopy(self)
+
+        # check for strange fields
+        missing_fields = [f for f in fields if f not in self.model._columns.keys()]
+        if missing_fields:
+            raise QueryException(
+                "Can't resolve fields {0} in {1}".format(
+                    ', '.join(missing_fields), self.model.__name__))
+
+        fields = [self.model._columns[field].db_field_name for field in fields]
+
+        if action == 'defer':
+            clone._defer_fields.update(fields)
+        elif action == 'only':
+            clone._only_fields = fields
+        else:
+            raise ValueError
+
+        return clone
+
+    def only(self, fields):
+        """ Load only these fields for the returned query """
+        return self._only_or_defer('only', fields)
+
+    def defer(self, fields):
+        """ Don't load these fields for the returned query """
+        return self._only_or_defer('defer', fields)
+
+    def create(self, **kwargs):
+        return self.model(**kwargs) \
+            .batch(self._batch) \
+            .ttl(self._ttl) \
+            .consistency(self._consistency) \
+            .if_not_exists(self._if_not_exists) \
+            .timestamp(self._timestamp) \
+            .if_exists(self._if_exists) \
+            .using(connection=self._connection) \
+            .save()
+
+    def delete(self):
+        """
+        Deletes the contents of a query
+        """
+        # validate where clause
+        partition_keys = set(x.db_field_name for x in self.model._partition_keys.values())
+        if partition_keys - set(c.field for c in self._where):
+            raise QueryException("The partition key must be defined on delete queries")
+
+        dq = DeleteStatement(
+            self.column_family_name,
+            where=self._where,
+            timestamp=self._timestamp,
+            conditionals=self._conditional,
+            if_exists=self._if_exists
+        )
+        self._execute(dq)
+
+    def __eq__(self, q):
+        if len(self._where) == len(q._where):
+            return all([w in q._where for w in self._where])
+        return False
+
+    def __ne__(self, q):
+        return not (self != q)
+
+    def timeout(self, timeout):
+        """
+        :param timeout: Timeout for the query (in seconds)
+        :type timeout: float or None
+        """
+        clone = copy.deepcopy(self)
+        clone._timeout = timeout
+        return clone
+
+    def using(self, keyspace=None, connection=None):
+        """
+        Change the context on-the-fly of the Model class (keyspace, connection)
+        """
+
+        if connection and self._batch:
+            raise CQLEngineException("Cannot specify a connection on model in batch mode.")
+
+        clone = copy.deepcopy(self)
+        if keyspace:
+            from cassandra.cqlengine.models import _clone_model_class
+            clone.model = _clone_model_class(self.model, {'__keyspace__': keyspace})
+
+        if connection:
+            clone._connection = connection
+
+        return clone
+
+
+class ResultObject(dict):
+    """
+    adds attribute access to a dictionary
+    """
+
+    def __getattr__(self, item):
+        try:
+            return self[item]
+        except KeyError:
+            raise AttributeError
+
+
+class SimpleQuerySet(AbstractQuerySet):
+    """
+    Overrides _get_result_constructor for querysets that do not define a model (e.g. NamedTable queries)
+    """
+
+    def _get_result_constructor(self):
+        """
+        Returns a function that will be used to instantiate query results
+        """
+        return ResultObject
+
+
+class ModelQuerySet(AbstractQuerySet):
+    """
+    """
+    def _validate_select_where(self):
+        """ Checks that a filterset will not create invalid select statement """
+        # check that there's either a =, a IN or a CONTAINS (collection)
+        # relationship with a primary key or indexed field. We also allow
+        # custom indexes to be queried with any operator (a difference
+        # between a secondary index)
+        equal_ops = [self.model._get_column_by_db_name(w.field) \
+                     for w in self._where if not isinstance(w.value, Token)
+                     and (isinstance(w.operator, EqualsOperator)
+                          or self.model._get_column_by_db_name(w.field).custom_index)]
+        token_comparison = any([w for w in self._where if isinstance(w.value, Token)])
+        if not any(w.primary_key or w.has_index for w in equal_ops) and not token_comparison and not self._allow_filtering:
+            raise QueryException(
+                ('Where clauses require either  =, a IN or a CONTAINS '
+                 '(collection) comparison with either a primary key or '
+                 'indexed field. You might want to consider setting '
+                 'custom_index on fields that you manage index outside '
+                 'cqlengine.'))
+
+        if not self._allow_filtering:
+            # if the query is not on an indexed field
+            if not any(w.has_index for w in equal_ops):
+                if not any([w.partition_key for w in equal_ops]) and not token_comparison:
+                    raise QueryException(
+                        ('Filtering on a clustering key without a partition '
+                         'key is not allowed unless allow_filtering() is '
+                         'called on the queryset. You might want to consider '
+                         'setting custom_index on fields that you manage '
+                         'index outside cqlengine.'))
+
+    def _select_fields(self):
+        if self._defer_fields or self._only_fields:
+            fields = [columns.db_field_name for columns in self.model._columns.values()]
+            if self._defer_fields:
+                fields = [f for f in fields if f not in self._defer_fields]
+                # select the partition keys if all model fields are set defer
+                if not fields:
+                    fields = [columns.db_field_name for columns in self.model._partition_keys.values()]
+            if self._only_fields:
+                fields = [f for f in fields if f in self._only_fields]
+            if not fields:
+                raise QueryException('No fields in select query. Only fields: "{0}", defer fields: "{1}"'.format(
+                    ','.join(self._only_fields), ','.join(self._defer_fields)))
+            return fields
+        return super(ModelQuerySet, self)._select_fields()
+
+    def _get_result_constructor(self):
+        """ Returns a function that will be used to instantiate query results """
+        if not self._values_list:  # we want models
+            return self.model._construct_instance
+        elif self._flat_values_list:  # the user has requested flattened list (1 value per row)
+            key = self._only_fields[0]
+            return lambda row: row[key]
+        else:
+            return lambda row: [row[f] for f in self._only_fields]
+
+    def _get_ordering_condition(self, colname):
+        colname, order_type = super(ModelQuerySet, self)._get_ordering_condition(colname)
+
+        column = self.model._columns.get(colname)
+        if column is None:
+            raise QueryException("Can't resolve the column name: '{0}'".format(colname))
+
+        # validate the column selection
+        if not column.primary_key:
+            raise QueryException(
+                "Can't order on '{0}', can only order on (clustered) primary keys".format(colname))
+
+        pks = [v for k, v in self.model._columns.items() if v.primary_key]
+        if column == pks[0]:
+            raise QueryException(
+                "Can't order by the first primary key (partition key), clustering (secondary) keys only")
+
+        return column.db_field_name, order_type
+
+    def values_list(self, *fields, **kwargs):
+        """ Instructs the query set to return tuples, not model instance """
+        flat = kwargs.pop('flat', False)
+        if kwargs:
+            raise TypeError('Unexpected keyword arguments to values_list: %s'
+                            % (kwargs.keys(),))
+        if flat and len(fields) > 1:
+            raise TypeError("'flat' is not valid when values_list is called with more than one field.")
+        clone = self.only(fields)
+        clone._values_list = True
+        clone._flat_values_list = flat
+        return clone
+
+    def ttl(self, ttl):
+        """
+        Sets the ttl (in seconds) for modified data.
+
+        *Note that running a select query with a ttl value will raise an exception*
+        """
+        clone = copy.deepcopy(self)
+        clone._ttl = ttl
+        return clone
+
+    def timestamp(self, timestamp):
+        """
+        Allows for custom timestamps to be saved with the record.
+        """
+        clone = copy.deepcopy(self)
+        clone._timestamp = timestamp
+        return clone
+
+    def if_not_exists(self):
+        """
+        Check the existence of an object before insertion.
+
+        If the insertion isn't applied, a LWTException is raised.
+        """
+        if self.model._has_counter:
+            raise IfNotExistsWithCounterColumn('if_not_exists cannot be used with tables containing counter columns')
+        clone = copy.deepcopy(self)
+        clone._if_not_exists = True
+        return clone
+
+    def if_exists(self):
+        """
+        Check the existence of an object before an update or delete.
+
+        If the update or delete isn't applied, a LWTException is raised.
+        """
+        if self.model._has_counter:
+            raise IfExistsWithCounterColumn('if_exists cannot be used with tables containing counter columns')
+        clone = copy.deepcopy(self)
+        clone._if_exists = True
+        return clone
+
+    def update(self, **values):
+        """
+        Performs an update on the row selected by the queryset. Include values to update in the
+        update like so:
+
+        .. code-block:: python
+
+            Model.objects(key=n).update(value='x')
+
+        Passing in updates for columns which are not part of the model will raise a ValidationError.
+
+        Per column validation will be performed, but instance level validation will not
+        (i.e., `Model.validate` is not called).  This is sometimes referred to as a blind update.
+
+        For example:
+
+        .. code-block:: python
+
+            class User(Model):
+                id = Integer(primary_key=True)
+                name = Text()
+
+            setup(["localhost"], "test")
+            sync_table(User)
+
+            u = User.create(id=1, name="jon")
+
+            User.objects(id=1).update(name="Steve")
+
+            # sets name to null
+            User.objects(id=1).update(name=None)
+
+
+        Also supported is blindly adding and removing elements from container columns,
+        without loading a model instance from Cassandra.
+
+        Using the syntax `.update(column_name={x, y, z})` will overwrite the contents of the container, like updating a
+        non container column. However, adding `__<operation>` to the end of the keyword arg, makes the update call add
+        or remove items from the collection, without overwriting then entire column.
+
+        Given the model below, here are the operations that can be performed on the different container columns:
+
+        .. code-block:: python
+
+            class Row(Model):
+                row_id      = columns.Integer(primary_key=True)
+                set_column  = columns.Set(Integer)
+                list_column = columns.List(Integer)
+                map_column  = columns.Map(Integer, Integer)
+
+        :class:`~cqlengine.columns.Set`
+
+        - `add`: adds the elements of the given set to the column
+        - `remove`: removes the elements of the given set to the column
+
+
+        .. code-block:: python
+
+            # add elements to a set
+            Row.objects(row_id=5).update(set_column__add={6})
+
+            # remove elements to a set
+            Row.objects(row_id=5).update(set_column__remove={4})
+
+        :class:`~cqlengine.columns.List`
+
+        - `append`: appends the elements of the given list to the end of the column
+        - `prepend`: prepends the elements of the given list to the beginning of the column
+
+        .. code-block:: python
+
+            # append items to a list
+            Row.objects(row_id=5).update(list_column__append=[6, 7])
+
+            # prepend items to a list
+            Row.objects(row_id=5).update(list_column__prepend=[1, 2])
+
+
+        :class:`~cqlengine.columns.Map`
+
+        - `update`: adds the given keys/values to the columns, creating new entries if they didn't exist, and overwriting old ones if they did
+
+        .. code-block:: python
+
+            # add items to a map
+            Row.objects(row_id=5).update(map_column__update={1: 2, 3: 4})
+
+            # remove items from a map
+            Row.objects(row_id=5).update(map_column__remove={1, 2})
+        """
+        if not values:
+            return
+
+        nulled_columns = set()
+        updated_columns = set()
+        us = UpdateStatement(self.column_family_name, where=self._where, ttl=self._ttl,
+                             timestamp=self._timestamp, conditionals=self._conditional, if_exists=self._if_exists)
+        for name, val in values.items():
+            col_name, col_op = self._parse_filter_arg(name)
+            col = self.model._columns.get(col_name)
+            # check for nonexistant columns
+            if col is None:
+                raise ValidationError("{0}.{1} has no column named: {2}".format(self.__module__, self.model.__name__, col_name))
+            # check for primary key update attempts
+            if col.is_primary_key:
+                raise ValidationError("Cannot apply update to primary key '{0}' for {1}.{2}".format(col_name, self.__module__, self.model.__name__))
+
+            if col_op == 'remove' and isinstance(col, columns.Map):
+                if not isinstance(val, set):
+                    raise ValidationError(
+                        "Cannot apply update operation '{0}' on column '{1}' with value '{2}'. A set is required.".format(col_op, col_name, val))
+                val = {v: None for v in val}
+            else:
+                # we should not provide default values in this use case.
+                val = col.validate(val)
+
+            if val is None:
+                nulled_columns.add(col_name)
+                continue
+
+            us.add_update(col, val, operation=col_op)
+            updated_columns.add(col_name)
+
+        if us.assignments:
+            self._execute(us)
+
+        if nulled_columns:
+            delete_conditional = [condition for condition in self._conditional
+                                  if condition.field not in updated_columns] if self._conditional else None
+            ds = DeleteStatement(self.column_family_name, fields=nulled_columns,
+                                 where=self._where, conditionals=delete_conditional, if_exists=self._if_exists)
+            self._execute(ds)
+
+
+class DMLQuery(object):
+    """
+    A query object used for queries performing inserts, updates, or deletes
+
+    this is usually instantiated by the model instance to be modified
+
+    unlike the read query object, this is mutable
+    """
+    _ttl = None
+    _consistency = None
+    _timestamp = None
+    _if_not_exists = False
+    _if_exists = False
+
+    def __init__(self, model, instance=None, batch=None, ttl=None, consistency=None, timestamp=None,
+                 if_not_exists=False, conditional=None, timeout=conn.NOT_SET, if_exists=False):
+        self.model = model
+        self.column_family_name = self.model.column_family_name()
+        self.instance = instance
+        self._batch = batch
+        self._ttl = ttl
+        self._consistency = consistency
+        self._timestamp = timestamp
+        self._if_not_exists = if_not_exists
+        self._if_exists = if_exists
+        self._conditional = conditional
+        self._timeout = timeout
+
+    def _execute(self, statement):
+        connection = self.instance._get_connection() if self.instance else self.model._get_connection()
+        if self._batch:
+            if self._batch._connection:
+                if not self._batch._connection_explicit and connection and \
+                        connection != self._batch._connection:
+                            raise CQLEngineException('BatchQuery queries must be executed on the same connection')
+            else:
+                # set the BatchQuery connection from the model
+                self._batch._connection = connection
+            return self._batch.add_query(statement)
+        else:
+            results = _execute_statement(self.model, statement, self._consistency, self._timeout, connection=connection)
+            if self._if_not_exists or self._if_exists or self._conditional:
+                check_applied(results)
+            return results
+
+    def batch(self, batch_obj):
+        if batch_obj is not None and not isinstance(batch_obj, BatchQuery):
+            raise CQLEngineException('batch_obj must be a BatchQuery instance or None')
+        self._batch = batch_obj
+        return self
+
+    def _delete_null_columns(self, conditionals=None):
+        """
+        executes a delete query to remove columns that have changed to null
+        """
+        ds = DeleteStatement(self.column_family_name, conditionals=conditionals, if_exists=self._if_exists)
+        deleted_fields = False
+        static_only = True
+        for _, v in self.instance._values.items():
+            col = v.column
+            if v.deleted:
+                ds.add_field(col.db_field_name)
+                deleted_fields = True
+                static_only &= col.static
+            elif isinstance(col, columns.Map):
+                uc = MapDeleteClause(col.db_field_name, v.value, v.previous_value)
+                if uc.get_context_size() > 0:
+                    ds.add_field(uc)
+                    deleted_fields = True
+                    static_only |= col.static
+
+        if deleted_fields:
+            keys = self.model._partition_keys if static_only else self.model._primary_keys
+            for name, col in keys.items():
+                ds.add_where(col, EqualsOperator(), getattr(self.instance, name))
+            self._execute(ds)
+
+    def update(self):
+        """
+        updates a row.
+        This is a blind update call.
+        All validation and cleaning needs to happen
+        prior to calling this.
+        """
+        if self.instance is None:
+            raise CQLEngineException("DML Query intance attribute is None")
+        assert type(self.instance) == self.model
+        null_clustering_key = False if len(self.instance._clustering_keys) == 0 else True
+        static_changed_only = True
+        statement = UpdateStatement(self.column_family_name, ttl=self._ttl, timestamp=self._timestamp,
+                                    conditionals=self._conditional, if_exists=self._if_exists)
+        for name, col in self.instance._clustering_keys.items():
+            null_clustering_key = null_clustering_key and col._val_is_null(getattr(self.instance, name, None))
+
+        updated_columns = set()
+        # get defined fields and their column names
+        for name, col in self.model._columns.items():
+            # if clustering key is null, don't include non static columns
+            if null_clustering_key and not col.static and not col.partition_key:
+                continue
+            if not col.is_primary_key:
+                val = getattr(self.instance, name, None)
+                val_mgr = self.instance._values[name]
+
+                if val is None:
+                    continue
+
+                if not val_mgr.changed and not isinstance(col, columns.Counter):
+                    continue
+
+                static_changed_only = static_changed_only and col.static
+                statement.add_update(col, val, previous=val_mgr.previous_value)
+                updated_columns.add(col.db_field_name)
+
+        if statement.assignments:
+            for name, col in self.model._primary_keys.items():
+                # only include clustering key if clustering key is not null, and non static columns are changed to avoid cql error
+                if (null_clustering_key or static_changed_only) and (not col.partition_key):
+                    continue
+                statement.add_where(col, EqualsOperator(), getattr(self.instance, name))
+            self._execute(statement)
+
+        if not null_clustering_key:
+            # remove conditions on fields that have been updated
+            delete_conditionals = [condition for condition in self._conditional
+                                   if condition.field not in updated_columns] if self._conditional else None
+            self._delete_null_columns(delete_conditionals)
+
+    def save(self):
+        """
+        Creates / updates a row.
+        This is a blind insert call.
+        All validation and cleaning needs to happen
+        prior to calling this.
+        """
+        if self.instance is None:
+            raise CQLEngineException("DML Query intance attribute is None")
+        assert type(self.instance) == self.model
+
+        nulled_fields = set()
+        if self.instance._has_counter or self.instance._can_update():
+            if self.instance._has_counter:
+                warn("'create' and 'save' actions on Counters are deprecated. It will be disallowed in 4.0. "
+                    "Use the 'update' mechanism instead.", DeprecationWarning)
+            return self.update()
+        else:
+            insert = InsertStatement(self.column_family_name, ttl=self._ttl, timestamp=self._timestamp, if_not_exists=self._if_not_exists)
+            static_save_only = False if len(self.instance._clustering_keys) == 0 else True
+            for name, col in self.instance._clustering_keys.items():
+                static_save_only = static_save_only and col._val_is_null(getattr(self.instance, name, None))
+            for name, col in self.instance._columns.items():
+                if static_save_only and not col.static and not col.partition_key:
+                    continue
+                val = getattr(self.instance, name, None)
+                if col._val_is_null(val):
+                    if self.instance._values[name].changed:
+                        nulled_fields.add(col.db_field_name)
+                    continue
+                if col.has_default and not self.instance._values[name].changed:
+                    # Ensure default columns included in a save() are marked as explicit, to get them *persisted* properly
+                    self.instance._values[name].explicit = True
+                insert.add_assignment(col, getattr(self.instance, name, None))
+
+        # skip query execution if it's empty
+        # caused by pointless update queries
+        if not insert.is_empty:
+            self._execute(insert)
+        # delete any nulled columns
+        if not static_save_only:
+            self._delete_null_columns()
+
+    def delete(self):
+        """ Deletes one instance """
+        if self.instance is None:
+            raise CQLEngineException("DML Query instance attribute is None")
+
+        ds = DeleteStatement(self.column_family_name, timestamp=self._timestamp, conditionals=self._conditional, if_exists=self._if_exists)
+        for name, col in self.model._primary_keys.items():
+            val = getattr(self.instance, name)
+            if val is None and not col.partition_key:
+                continue
+            ds.add_where(col, EqualsOperator(), val)
+        self._execute(ds)
+
+
+def _execute_statement(model, statement, consistency_level, timeout, connection=None):
+    params = statement.get_context()
+    s = SimpleStatement(str(statement), consistency_level=consistency_level, fetch_size=statement.fetch_size)
+    if model._partition_key_index:
+        key_values = statement.partition_key_values(model._partition_key_index)
+        if not any(v is None for v in key_values):
+            parts = model._routing_key_from_values(key_values, conn.get_cluster(connection).protocol_version)
+            s.routing_key = parts
+            s.keyspace = model._get_keyspace()
+    connection = connection or model._get_connection()
+    return conn.execute(s, params, timeout=timeout, connection=connection)
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/statements.py b/llm/Lib/site-packages/cassandra/cqlengine/statements.py
new file mode 100644
index 0000000000000000000000000000000000000000..a886e63fb999d4d5ecb60f0d701d39b2e3d8d8e5
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cqlengine/statements.py
@@ -0,0 +1,905 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from datetime import datetime, timedelta
+import time
+
+from cassandra.query import FETCH_SIZE_UNSET
+from cassandra.cqlengine import columns
+from cassandra.cqlengine import UnicodeMixin
+from cassandra.cqlengine.functions import QueryValue
+from cassandra.cqlengine.operators import BaseWhereOperator, InOperator, EqualsOperator, IsNotNullOperator
+
+
+class StatementException(Exception):
+    pass
+
+
+class ValueQuoter(UnicodeMixin):
+
+    def __init__(self, value):
+        self.value = value
+
+    def __unicode__(self):
+        from cassandra.encoder import cql_quote
+        if isinstance(self.value, (list, tuple)):
+            return '[' + ', '.join([cql_quote(v) for v in self.value]) + ']'
+        elif isinstance(self.value, dict):
+            return '{' + ', '.join([cql_quote(k) + ':' + cql_quote(v) for k, v in self.value.items()]) + '}'
+        elif isinstance(self.value, set):
+            return '{' + ', '.join([cql_quote(v) for v in self.value]) + '}'
+        return cql_quote(self.value)
+
+    def __eq__(self, other):
+        if isinstance(other, self.__class__):
+            return self.value == other.value
+        return False
+
+
+class InQuoter(ValueQuoter):
+
+    def __unicode__(self):
+        from cassandra.encoder import cql_quote
+        return '(' + ', '.join([cql_quote(v) for v in self.value]) + ')'
+
+
+class BaseClause(UnicodeMixin):
+
+    def __init__(self, field, value):
+        self.field = field
+        self.value = value
+        self.context_id = None
+
+    def __unicode__(self):
+        raise NotImplementedError
+
+    def __hash__(self):
+        return hash(self.field) ^ hash(self.value)
+
+    def __eq__(self, other):
+        if isinstance(other, self.__class__):
+            return self.field == other.field and self.value == other.value
+        return False
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def get_context_size(self):
+        """ returns the number of entries this clause will add to the query context """
+        return 1
+
+    def set_context_id(self, i):
+        """ sets the value placeholder that will be used in the query """
+        self.context_id = i
+
+    def update_context(self, ctx):
+        """ updates the query context with this clauses values """
+        assert isinstance(ctx, dict)
+        ctx[str(self.context_id)] = self.value
+
+
+class WhereClause(BaseClause):
+    """ a single where statement used in queries """
+
+    def __init__(self, field, operator, value, quote_field=True):
+        """
+
+        :param field:
+        :param operator:
+        :param value:
+        :param quote_field: hack to get the token function rendering properly
+        :return:
+        """
+        if not isinstance(operator, BaseWhereOperator):
+            raise StatementException(
+                "operator must be of type {0}, got {1}".format(BaseWhereOperator, type(operator))
+            )
+        super(WhereClause, self).__init__(field, value)
+        self.operator = operator
+        self.query_value = self.value if isinstance(self.value, QueryValue) else QueryValue(self.value)
+        self.quote_field = quote_field
+
+    def __unicode__(self):
+        field = ('"{0}"' if self.quote_field else '{0}').format(self.field)
+        return u'{0} {1} {2}'.format(field, self.operator, str(self.query_value))
+
+    def __hash__(self):
+        return super(WhereClause, self).__hash__() ^ hash(self.operator)
+
+    def __eq__(self, other):
+        if super(WhereClause, self).__eq__(other):
+            return self.operator.__class__ == other.operator.__class__
+        return False
+
+    def get_context_size(self):
+        return self.query_value.get_context_size()
+
+    def set_context_id(self, i):
+        super(WhereClause, self).set_context_id(i)
+        self.query_value.set_context_id(i)
+
+    def update_context(self, ctx):
+        if isinstance(self.operator, InOperator):
+            ctx[str(self.context_id)] = InQuoter(self.value)
+        else:
+            self.query_value.update_context(ctx)
+
+
+class IsNotNullClause(WhereClause):
+    def __init__(self, field):
+        super(IsNotNullClause, self).__init__(field, IsNotNullOperator(), '')
+
+    def __unicode__(self):
+        field = ('"{0}"' if self.quote_field else '{0}').format(self.field)
+        return u'{0} {1}'.format(field, self.operator)
+
+    def update_context(self, ctx):
+        pass
+
+    def get_context_size(self):
+        return 0
+
+# alias for convenience
+IsNotNull = IsNotNullClause
+
+
+class AssignmentClause(BaseClause):
+    """ a single variable st statement """
+
+    def __unicode__(self):
+        return u'"{0}" = %({1})s'.format(self.field, self.context_id)
+
+    def insert_tuple(self):
+        return self.field, self.context_id
+
+
+class ConditionalClause(BaseClause):
+    """ A single variable iff statement """
+
+    def __unicode__(self):
+        return u'"{0}" = %({1})s'.format(self.field, self.context_id)
+
+    def insert_tuple(self):
+        return self.field, self.context_id
+
+
+class ContainerUpdateTypeMapMeta(type):
+
+    def __init__(cls, name, bases, dct):
+        if not hasattr(cls, 'type_map'):
+            cls.type_map = {}
+        else:
+            cls.type_map[cls.col_type] = cls
+        super(ContainerUpdateTypeMapMeta, cls).__init__(name, bases, dct)
+
+
+class ContainerUpdateClause(AssignmentClause, metaclass=ContainerUpdateTypeMapMeta):
+
+    def __init__(self, field, value, operation=None, previous=None):
+        super(ContainerUpdateClause, self).__init__(field, value)
+        self.previous = previous
+        self._assignments = None
+        self._operation = operation
+        self._analyzed = False
+
+    def _analyze(self):
+        raise NotImplementedError
+
+    def get_context_size(self):
+        raise NotImplementedError
+
+    def update_context(self, ctx):
+        raise NotImplementedError
+
+
+class SetUpdateClause(ContainerUpdateClause):
+    """ updates a set collection """
+
+    col_type = columns.Set
+
+    _additions = None
+    _removals = None
+
+    def __unicode__(self):
+        qs = []
+        ctx_id = self.context_id
+        if (self.previous is None and
+                self._assignments is None and
+                self._additions is None and
+                self._removals is None):
+            qs += ['"{0}" = %({1})s'.format(self.field, ctx_id)]
+        if self._assignments is not None:
+            qs += ['"{0}" = %({1})s'.format(self.field, ctx_id)]
+            ctx_id += 1
+        if self._additions is not None:
+            qs += ['"{0}" = "{0}" + %({1})s'.format(self.field, ctx_id)]
+            ctx_id += 1
+        if self._removals is not None:
+            qs += ['"{0}" = "{0}" - %({1})s'.format(self.field, ctx_id)]
+
+        return ', '.join(qs)
+
+    def _analyze(self):
+        """ works out the updates to be performed """
+        if self.value is None or self.value == self.previous:
+            pass
+        elif self._operation == "add":
+            self._additions = self.value
+        elif self._operation == "remove":
+            self._removals = self.value
+        elif self.previous is None:
+            self._assignments = self.value
+        else:
+            # partial update time
+            self._additions = (self.value - self.previous) or None
+            self._removals = (self.previous - self.value) or None
+        self._analyzed = True
+
+    def get_context_size(self):
+        if not self._analyzed:
+            self._analyze()
+        if (self.previous is None and
+                not self._assignments and
+                self._additions is None and
+                self._removals is None):
+            return 1
+        return int(bool(self._assignments)) + int(bool(self._additions)) + int(bool(self._removals))
+
+    def update_context(self, ctx):
+        if not self._analyzed:
+            self._analyze()
+        ctx_id = self.context_id
+        if (self.previous is None and
+                self._assignments is None and
+                self._additions is None and
+                self._removals is None):
+            ctx[str(ctx_id)] = set()
+        if self._assignments is not None:
+            ctx[str(ctx_id)] = self._assignments
+            ctx_id += 1
+        if self._additions is not None:
+            ctx[str(ctx_id)] = self._additions
+            ctx_id += 1
+        if self._removals is not None:
+            ctx[str(ctx_id)] = self._removals
+
+
+class ListUpdateClause(ContainerUpdateClause):
+    """ updates a list collection """
+
+    col_type = columns.List
+
+    _append = None
+    _prepend = None
+
+    def __unicode__(self):
+        if not self._analyzed:
+            self._analyze()
+        qs = []
+        ctx_id = self.context_id
+        if self._assignments is not None:
+            qs += ['"{0}" = %({1})s'.format(self.field, ctx_id)]
+            ctx_id += 1
+
+        if self._prepend is not None:
+            qs += ['"{0}" = %({1})s + "{0}"'.format(self.field, ctx_id)]
+            ctx_id += 1
+
+        if self._append is not None:
+            qs += ['"{0}" = "{0}" + %({1})s'.format(self.field, ctx_id)]
+
+        return ', '.join(qs)
+
+    def get_context_size(self):
+        if not self._analyzed:
+            self._analyze()
+        return int(self._assignments is not None) + int(bool(self._append)) + int(bool(self._prepend))
+
+    def update_context(self, ctx):
+        if not self._analyzed:
+            self._analyze()
+        ctx_id = self.context_id
+        if self._assignments is not None:
+            ctx[str(ctx_id)] = self._assignments
+            ctx_id += 1
+        if self._prepend is not None:
+            ctx[str(ctx_id)] = self._prepend
+            ctx_id += 1
+        if self._append is not None:
+            ctx[str(ctx_id)] = self._append
+
+    def _analyze(self):
+        """ works out the updates to be performed """
+        if self.value is None or self.value == self.previous:
+            pass
+
+        elif self._operation == "append":
+            self._append = self.value
+
+        elif self._operation == "prepend":
+            self._prepend = self.value
+
+        elif self.previous is None:
+            self._assignments = self.value
+
+        elif len(self.value) < len(self.previous):
+            # if elements have been removed,
+            # rewrite the whole list
+            self._assignments = self.value
+
+        elif len(self.previous) == 0:
+            # if we're updating from an empty
+            # list, do a complete insert
+            self._assignments = self.value
+        else:
+
+            # the max start idx we want to compare
+            search_space = len(self.value) - max(0, len(self.previous) - 1)
+
+            # the size of the sub lists we want to look at
+            search_size = len(self.previous)
+
+            for i in range(search_space):
+                # slice boundary
+                j = i + search_size
+                sub = self.value[i:j]
+                idx_cmp = lambda idx: self.previous[idx] == sub[idx]
+                if idx_cmp(0) and idx_cmp(-1) and self.previous == sub:
+                    self._prepend = self.value[:i] or None
+                    self._append = self.value[j:] or None
+                    break
+
+            # if both append and prepend are still None after looking
+            # at both lists, an insert statement will be created
+            if self._prepend is self._append is None:
+                self._assignments = self.value
+
+        self._analyzed = True
+
+
+class MapUpdateClause(ContainerUpdateClause):
+    """ updates a map collection """
+
+    col_type = columns.Map
+
+    _updates = None
+    _removals = None
+
+    def _analyze(self):
+        if self._operation == "update":
+            self._updates = self.value.keys()
+        elif self._operation == "remove":
+            self._removals = {v for v in self.value.keys()}
+        else:
+            if self.previous is None:
+                self._updates = sorted([k for k, v in self.value.items()])
+            else:
+                self._updates = sorted([k for k, v in self.value.items() if v != self.previous.get(k)]) or None
+        self._analyzed = True
+
+    def get_context_size(self):
+        if self.is_assignment:
+            return 1
+        return int((len(self._updates or []) * 2) + int(bool(self._removals)))
+
+    def update_context(self, ctx):
+        ctx_id = self.context_id
+        if self.is_assignment:
+            ctx[str(ctx_id)] = {}
+        elif self._removals is not None:
+            ctx[str(ctx_id)] = self._removals
+        else:
+            for key in self._updates or []:
+                val = self.value.get(key)
+                ctx[str(ctx_id)] = key
+                ctx[str(ctx_id + 1)] = val
+                ctx_id += 2
+
+    @property
+    def is_assignment(self):
+        if not self._analyzed:
+            self._analyze()
+        return self.previous is None and not self._updates and not self._removals
+
+    def __unicode__(self):
+        qs = []
+
+        ctx_id = self.context_id
+        if self.is_assignment:
+            qs += ['"{0}" = %({1})s'.format(self.field, ctx_id)]
+        elif self._removals is not None:
+            qs += ['"{0}" = "{0}" - %({1})s'.format(self.field, ctx_id)]
+            ctx_id += 1
+        else:
+            for _ in self._updates or []:
+                qs += ['"{0}"[%({1})s] = %({2})s'.format(self.field, ctx_id, ctx_id + 1)]
+                ctx_id += 2
+
+        return ', '.join(qs)
+
+
+class CounterUpdateClause(AssignmentClause):
+
+    col_type = columns.Counter
+
+    def __init__(self, field, value, previous=None):
+        super(CounterUpdateClause, self).__init__(field, value)
+        self.previous = previous or 0
+
+    def get_context_size(self):
+        return 1
+
+    def update_context(self, ctx):
+        ctx[str(self.context_id)] = abs(self.value - self.previous)
+
+    def __unicode__(self):
+        delta = self.value - self.previous
+        sign = '-' if delta < 0 else '+'
+        return '"{0}" = "{0}" {1} %({2})s'.format(self.field, sign, self.context_id)
+
+
+class BaseDeleteClause(BaseClause):
+    pass
+
+
+class FieldDeleteClause(BaseDeleteClause):
+    """ deletes a field from a row """
+
+    def __init__(self, field):
+        super(FieldDeleteClause, self).__init__(field, None)
+
+    def __unicode__(self):
+        return '"{0}"'.format(self.field)
+
+    def update_context(self, ctx):
+        pass
+
+    def get_context_size(self):
+        return 0
+
+
+class MapDeleteClause(BaseDeleteClause):
+    """ removes keys from a map """
+
+    def __init__(self, field, value, previous=None):
+        super(MapDeleteClause, self).__init__(field, value)
+        self.value = self.value or {}
+        self.previous = previous or {}
+        self._analyzed = False
+        self._removals = None
+
+    def _analyze(self):
+        self._removals = sorted([k for k in self.previous if k not in self.value])
+        self._analyzed = True
+
+    def update_context(self, ctx):
+        if not self._analyzed:
+            self._analyze()
+        for idx, key in enumerate(self._removals):
+            ctx[str(self.context_id + idx)] = key
+
+    def get_context_size(self):
+        if not self._analyzed:
+            self._analyze()
+        return len(self._removals)
+
+    def __unicode__(self):
+        if not self._analyzed:
+            self._analyze()
+        return ', '.join(['"{0}"[%({1})s]'.format(self.field, self.context_id + i) for i in range(len(self._removals))])
+
+
+class BaseCQLStatement(UnicodeMixin):
+    """ The base cql statement class """
+
+    def __init__(self, table, timestamp=None, where=None, fetch_size=None, conditionals=None):
+        super(BaseCQLStatement, self).__init__()
+        self.table = table
+        self.context_id = 0
+        self.context_counter = self.context_id
+        self.timestamp = timestamp
+        self.fetch_size = fetch_size if fetch_size else FETCH_SIZE_UNSET
+
+        self.where_clauses = []
+        for clause in where or []:
+            self._add_where_clause(clause)
+
+        self.conditionals = []
+        for conditional in conditionals or []:
+            self.add_conditional_clause(conditional)
+
+    def _update_part_key_values(self, field_index_map, clauses, parts):
+        for clause in filter(lambda c: c.field in field_index_map, clauses):
+            parts[field_index_map[clause.field]] = clause.value
+
+    def partition_key_values(self, field_index_map):
+        parts = [None] * len(field_index_map)
+        self._update_part_key_values(field_index_map, (w for w in self.where_clauses if w.operator.__class__ == EqualsOperator), parts)
+        return parts
+
+    def add_where(self, column, operator, value, quote_field=True):
+        value = column.to_database(value)
+        clause = WhereClause(column.db_field_name, operator, value, quote_field)
+        self._add_where_clause(clause)
+
+    def _add_where_clause(self, clause):
+        clause.set_context_id(self.context_counter)
+        self.context_counter += clause.get_context_size()
+        self.where_clauses.append(clause)
+
+    def get_context(self):
+        """
+        returns the context dict for this statement
+        :rtype: dict
+        """
+        ctx = {}
+        for clause in self.where_clauses or []:
+            clause.update_context(ctx)
+        return ctx
+
+    def add_conditional_clause(self, clause):
+        """
+        Adds a iff clause to this statement
+
+        :param clause: The clause that will be added to the iff statement
+        :type clause: ConditionalClause
+        """
+        clause.set_context_id(self.context_counter)
+        self.context_counter += clause.get_context_size()
+        self.conditionals.append(clause)
+
+    def _get_conditionals(self):
+        return 'IF {0}'.format(' AND '.join([str(c) for c in self.conditionals]))
+
+    def get_context_size(self):
+        return len(self.get_context())
+
+    def update_context_id(self, i):
+        self.context_id = i
+        self.context_counter = self.context_id
+        for clause in self.where_clauses:
+            clause.set_context_id(self.context_counter)
+            self.context_counter += clause.get_context_size()
+
+    @property
+    def timestamp_normalized(self):
+        """
+        we're expecting self.timestamp to be either a long, int, a datetime, or a timedelta
+        :return:
+        """
+        if not self.timestamp:
+            return None
+
+        if isinstance(self.timestamp, int):
+            return self.timestamp
+
+        if isinstance(self.timestamp, timedelta):
+            tmp = datetime.now() + self.timestamp
+        else:
+            tmp = self.timestamp
+
+        return int(time.mktime(tmp.timetuple()) * 1e+6 + tmp.microsecond)
+
+    def __unicode__(self):
+        raise NotImplementedError
+
+    def __repr__(self):
+        return self.__unicode__()
+
+    @property
+    def _where(self):
+        return 'WHERE {0}'.format(' AND '.join([str(c) for c in self.where_clauses]))
+
+
+class SelectStatement(BaseCQLStatement):
+    """ a cql select statement """
+
+    def __init__(self,
+                 table,
+                 fields=None,
+                 count=False,
+                 where=None,
+                 order_by=None,
+                 limit=None,
+                 allow_filtering=False,
+                 distinct_fields=None,
+                 fetch_size=None):
+
+        """
+        :param where
+        :type where list of cqlengine.statements.WhereClause
+        """
+        super(SelectStatement, self).__init__(
+            table,
+            where=where,
+            fetch_size=fetch_size
+        )
+
+        self.fields = [fields] if isinstance(fields, str) else (fields or [])
+        self.distinct_fields = distinct_fields
+        self.count = count
+        self.order_by = [order_by] if isinstance(order_by, str) else order_by
+        self.limit = limit
+        self.allow_filtering = allow_filtering
+
+    def __unicode__(self):
+        qs = ['SELECT']
+        if self.distinct_fields:
+            if self.count:
+                qs += ['DISTINCT COUNT({0})'.format(', '.join(['"{0}"'.format(f) for f in self.distinct_fields]))]
+            else:
+                qs += ['DISTINCT {0}'.format(', '.join(['"{0}"'.format(f) for f in self.distinct_fields]))]
+        elif self.count:
+            qs += ['COUNT(*)']
+        else:
+            qs += [', '.join(['"{0}"'.format(f) for f in self.fields]) if self.fields else '*']
+        qs += ['FROM', self.table]
+
+        if self.where_clauses:
+            qs += [self._where]
+
+        if self.order_by and not self.count:
+            qs += ['ORDER BY {0}'.format(', '.join(str(o) for o in self.order_by))]
+
+        if self.limit:
+            qs += ['LIMIT {0}'.format(self.limit)]
+
+        if self.allow_filtering:
+            qs += ['ALLOW FILTERING']
+
+        return ' '.join(qs)
+
+
+class AssignmentStatement(BaseCQLStatement):
+    """ value assignment statements """
+
+    def __init__(self,
+                 table,
+                 assignments=None,
+                 where=None,
+                 ttl=None,
+                 timestamp=None,
+                 conditionals=None):
+        super(AssignmentStatement, self).__init__(
+            table,
+            where=where,
+            conditionals=conditionals
+        )
+        self.ttl = ttl
+        self.timestamp = timestamp
+
+        # add assignments
+        self.assignments = []
+        for assignment in assignments or []:
+            self._add_assignment_clause(assignment)
+
+    def update_context_id(self, i):
+        super(AssignmentStatement, self).update_context_id(i)
+        for assignment in self.assignments:
+            assignment.set_context_id(self.context_counter)
+            self.context_counter += assignment.get_context_size()
+
+    def partition_key_values(self, field_index_map):
+        parts = super(AssignmentStatement, self).partition_key_values(field_index_map)
+        self._update_part_key_values(field_index_map, self.assignments, parts)
+        return parts
+
+    def add_assignment(self, column, value):
+        value = column.to_database(value)
+        clause = AssignmentClause(column.db_field_name, value)
+        self._add_assignment_clause(clause)
+
+    def _add_assignment_clause(self, clause):
+        clause.set_context_id(self.context_counter)
+        self.context_counter += clause.get_context_size()
+        self.assignments.append(clause)
+
+    @property
+    def is_empty(self):
+        return len(self.assignments) == 0
+
+    def get_context(self):
+        ctx = super(AssignmentStatement, self).get_context()
+        for clause in self.assignments:
+            clause.update_context(ctx)
+        return ctx
+
+
+class InsertStatement(AssignmentStatement):
+    """ an cql insert statement """
+
+    def __init__(self,
+                 table,
+                 assignments=None,
+                 where=None,
+                 ttl=None,
+                 timestamp=None,
+                 if_not_exists=False):
+        super(InsertStatement, self).__init__(table,
+                                              assignments=assignments,
+                                              where=where,
+                                              ttl=ttl,
+                                              timestamp=timestamp)
+
+        self.if_not_exists = if_not_exists
+
+    def __unicode__(self):
+        qs = ['INSERT INTO {0}'.format(self.table)]
+
+        # get column names and context placeholders
+        fields = [a.insert_tuple() for a in self.assignments]
+        columns, values = zip(*fields)
+
+        qs += ["({0})".format(', '.join(['"{0}"'.format(c) for c in columns]))]
+        qs += ['VALUES']
+        qs += ["({0})".format(', '.join(['%({0})s'.format(v) for v in values]))]
+
+        if self.if_not_exists:
+            qs += ["IF NOT EXISTS"]
+
+        using_options = []
+        if self.ttl:
+            using_options += ["TTL {}".format(self.ttl)]
+
+        if self.timestamp:
+            using_options += ["TIMESTAMP {}".format(self.timestamp_normalized)]
+
+        if using_options:
+            qs += ["USING {}".format(" AND ".join(using_options))]
+        return ' '.join(qs)
+
+
+class UpdateStatement(AssignmentStatement):
+    """ an cql update select statement """
+
+    def __init__(self,
+                 table,
+                 assignments=None,
+                 where=None,
+                 ttl=None,
+                 timestamp=None,
+                 conditionals=None,
+                 if_exists=False):
+        super(UpdateStatement, self). __init__(table,
+                                               assignments=assignments,
+                                               where=where,
+                                               ttl=ttl,
+                                               timestamp=timestamp,
+                                               conditionals=conditionals)
+
+        self.if_exists = if_exists
+
+    def __unicode__(self):
+        qs = ['UPDATE', self.table]
+
+        using_options = []
+
+        if self.ttl:
+            using_options += ["TTL {0}".format(self.ttl)]
+
+        if self.timestamp:
+            using_options += ["TIMESTAMP {0}".format(self.timestamp_normalized)]
+
+        if using_options:
+            qs += ["USING {0}".format(" AND ".join(using_options))]
+
+        qs += ['SET']
+        qs += [', '.join([str(c) for c in self.assignments])]
+
+        if self.where_clauses:
+            qs += [self._where]
+
+        if len(self.conditionals) > 0:
+            qs += [self._get_conditionals()]
+
+        if self.if_exists:
+            qs += ["IF EXISTS"]
+
+        return ' '.join(qs)
+
+    def get_context(self):
+        ctx = super(UpdateStatement, self).get_context()
+        for clause in self.conditionals:
+            clause.update_context(ctx)
+        return ctx
+
+    def update_context_id(self, i):
+        super(UpdateStatement, self).update_context_id(i)
+        for conditional in self.conditionals:
+            conditional.set_context_id(self.context_counter)
+            self.context_counter += conditional.get_context_size()
+
+    def add_update(self, column, value, operation=None, previous=None):
+        value = column.to_database(value)
+        col_type = type(column)
+        container_update_type = ContainerUpdateClause.type_map.get(col_type)
+        if container_update_type:
+            previous = column.to_database(previous)
+            clause = container_update_type(column.db_field_name, value, operation, previous)
+        elif col_type == columns.Counter:
+            clause = CounterUpdateClause(column.db_field_name, value, previous)
+        else:
+            clause = AssignmentClause(column.db_field_name, value)
+        if clause.get_context_size():  # this is to exclude map removals from updates. Can go away if we drop support for C* < 1.2.4 and remove two-phase updates
+            self._add_assignment_clause(clause)
+
+
+class DeleteStatement(BaseCQLStatement):
+    """ a cql delete statement """
+
+    def __init__(self, table, fields=None, where=None, timestamp=None, conditionals=None, if_exists=False):
+        super(DeleteStatement, self).__init__(
+            table,
+            where=where,
+            timestamp=timestamp,
+            conditionals=conditionals
+        )
+        self.fields = []
+        if isinstance(fields, str):
+            fields = [fields]
+        for field in fields or []:
+            self.add_field(field)
+
+        self.if_exists = if_exists
+
+    def update_context_id(self, i):
+        super(DeleteStatement, self).update_context_id(i)
+        for field in self.fields:
+            field.set_context_id(self.context_counter)
+            self.context_counter += field.get_context_size()
+        for t in self.conditionals:
+            t.set_context_id(self.context_counter)
+            self.context_counter += t.get_context_size()
+
+    def get_context(self):
+        ctx = super(DeleteStatement, self).get_context()
+        for field in self.fields:
+            field.update_context(ctx)
+        for clause in self.conditionals:
+            clause.update_context(ctx)
+        return ctx
+
+    def add_field(self, field):
+        if isinstance(field, str):
+            field = FieldDeleteClause(field)
+        if not isinstance(field, BaseClause):
+            raise StatementException("only instances of AssignmentClause can be added to statements")
+        field.set_context_id(self.context_counter)
+        self.context_counter += field.get_context_size()
+        self.fields.append(field)
+
+    def __unicode__(self):
+        qs = ['DELETE']
+        if self.fields:
+            qs += [', '.join(['{0}'.format(f) for f in self.fields])]
+        qs += ['FROM', self.table]
+
+        delete_option = []
+
+        if self.timestamp:
+            delete_option += ["TIMESTAMP {0}".format(self.timestamp_normalized)]
+
+        if delete_option:
+            qs += [" USING {0} ".format(" AND ".join(delete_option))]
+
+        if self.where_clauses:
+            qs += [self._where]
+
+        if self.conditionals:
+            qs += [self._get_conditionals()]
+
+        if self.if_exists:
+            qs += ["IF EXISTS"]
+
+        return ' '.join(qs)
diff --git a/llm/Lib/site-packages/cassandra/cqlengine/usertype.py b/llm/Lib/site-packages/cassandra/cqlengine/usertype.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ab6fef5c1f77b81cdf410e0158be2683c759a34
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cqlengine/usertype.py
@@ -0,0 +1,227 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import re
+
+from cassandra.util import OrderedDict
+from cassandra.cqlengine import CQLEngineException
+from cassandra.cqlengine import columns
+from cassandra.cqlengine import connection as conn
+from cassandra.cqlengine import models
+
+
+class UserTypeException(CQLEngineException):
+    pass
+
+
+class UserTypeDefinitionException(UserTypeException):
+    pass
+
+
+class BaseUserType(object):
+    """
+    The base type class; don't inherit from this, inherit from UserType, defined below
+    """
+    __type_name__ = None
+
+    _fields = None
+    _db_map = None
+
+    def __init__(self, **values):
+        self._values = {}
+        if self._db_map:
+            values = dict((self._db_map.get(k, k), v) for k, v in values.items())
+
+        for name, field in self._fields.items():
+            field_default = field.get_default() if field.has_default else None
+            value = values.get(name, field_default)
+            if value is not None or isinstance(field, columns.BaseContainerColumn):
+                value = field.to_python(value)
+            value_mngr = field.value_manager(self, field, value)
+            value_mngr.explicit = name in values
+            self._values[name] = value_mngr
+
+    def __eq__(self, other):
+        if self.__class__ != other.__class__:
+            return False
+
+        keys = set(self._fields.keys())
+        other_keys = set(other._fields.keys())
+        if keys != other_keys:
+            return False
+
+        for key in other_keys:
+            if getattr(self, key, None) != getattr(other, key, None):
+                return False
+
+        return True
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __str__(self):
+        return "{{{0}}}".format(', '.join("'{0}': {1}".format(k, getattr(self, k)) for k, v in self._values.items()))
+
+    def has_changed_fields(self):
+        return any(v.changed for v in self._values.values())
+
+    def reset_changed_fields(self):
+        for v in self._values.values():
+            v.reset_previous_value()
+
+    def __iter__(self):
+        for field in self._fields.keys():
+            yield field
+
+    def __getattr__(self, attr):
+        # provides the mapping from db_field to fields
+        try:
+            return getattr(self, self._db_map[attr])
+        except KeyError:
+            raise AttributeError(attr)
+
+    def __getitem__(self, key):
+        if not isinstance(key, str):
+            raise TypeError
+        if key not in self._fields.keys():
+            raise KeyError
+        return getattr(self, key)
+
+    def __setitem__(self, key, val):
+        if not isinstance(key, str):
+            raise TypeError
+        if key not in self._fields.keys():
+            raise KeyError
+        return setattr(self, key, val)
+
+    def __len__(self):
+        try:
+            return self._len
+        except:
+            self._len = len(self._fields.keys())
+            return self._len
+
+    def keys(self):
+        """ Returns a list of column IDs. """
+        return [k for k in self]
+
+    def values(self):
+        """ Returns list of column values. """
+        return [self[k] for k in self]
+
+    def items(self):
+        """ Returns a list of column ID/value tuples. """
+        return [(k, self[k]) for k in self]
+
+    @classmethod
+    def register_for_keyspace(cls, keyspace, connection=None):
+        conn.register_udt(keyspace, cls.type_name(), cls, connection=connection)
+
+    @classmethod
+    def type_name(cls):
+        """
+        Returns the type name if it's been defined
+        otherwise, it creates it from the class name
+        """
+        if cls.__type_name__:
+            type_name = cls.__type_name__.lower()
+        else:
+            camelcase = re.compile(r'([a-z])([A-Z])')
+            ccase = lambda s: camelcase.sub(lambda v: '{0}_{1}'.format(v.group(1), v.group(2)), s)
+
+            type_name = ccase(cls.__name__)
+            # trim to less than 48 characters or cassandra will complain
+            type_name = type_name[-48:]
+            type_name = type_name.lower()
+            type_name = re.sub(r'^_+', '', type_name)
+            cls.__type_name__ = type_name
+
+        return type_name
+
+    def validate(self):
+        """
+        Cleans and validates the field values
+        """
+        for name, field in self._fields.items():
+            v = getattr(self, name)
+            if v is None and not self._values[name].explicit and field.has_default:
+                v = field.get_default()
+            val = field.validate(v)
+            setattr(self, name, val)
+
+
+class UserTypeMetaClass(type):
+
+    def __new__(cls, name, bases, attrs):
+        field_dict = OrderedDict()
+
+        field_defs = [(k, v) for k, v in attrs.items() if isinstance(v, columns.Column)]
+        field_defs = sorted(field_defs, key=lambda x: x[1].position)
+
+        def _transform_column(field_name, field_obj):
+            field_dict[field_name] = field_obj
+            field_obj.set_column_name(field_name)
+            attrs[field_name] = models.ColumnDescriptor(field_obj)
+
+        # transform field definitions
+        for k, v in field_defs:
+            # don't allow a field with the same name as a built-in attribute or method
+            if k in BaseUserType.__dict__:
+                raise UserTypeDefinitionException("field '{0}' conflicts with built-in attribute/method".format(k))
+            _transform_column(k, v)
+
+        attrs['_fields'] = field_dict
+
+        db_map = {}
+        for field_name, field in field_dict.items():
+            db_field = field.db_field_name
+            if db_field != field_name:
+                if db_field in field_dict:
+                    raise UserTypeDefinitionException("db_field '{0}' for field '{1}' conflicts with another attribute name".format(db_field, field_name))
+                db_map[db_field] = field_name
+        attrs['_db_map'] = db_map
+
+        klass = super(UserTypeMetaClass, cls).__new__(cls, name, bases, attrs)
+
+        return klass
+
+
+class UserType(BaseUserType, metaclass=UserTypeMetaClass):
+    """
+    This class is used to model User Defined Types. To define a type, declare a class inheriting from this,
+    and assign field types as class attributes:
+
+    .. code-block:: python
+
+        # connect with default keyspace ...
+
+        from cassandra.cqlengine.columns import Text, Integer
+        from cassandra.cqlengine.usertype import UserType
+
+        class address(UserType):
+            street = Text()
+            zipcode = Integer()
+
+        from cassandra.cqlengine import management
+        management.sync_type(address)
+
+    Please see :ref:`user_types` for a complete example and discussion.
+    """
+
+    __type_name__ = None
+    """
+    *Optional.* Sets the name of the CQL type for this type.
+
+    If not specified, the type name will be the name of the class, with it's module name as it's prefix.
+    """
diff --git a/llm/Lib/site-packages/cassandra/cqltypes.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/cqltypes.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..1e47f30967a8ba37791aa8ffbc308ced99f97c35
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cqltypes.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/cqltypes.py b/llm/Lib/site-packages/cassandra/cqltypes.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a6cda3d66db6ab7ec73505ba560e0516cb1ad62
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cqltypes.py
@@ -0,0 +1,1437 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Representation of Cassandra data types. These classes should make it simple for
+the library (and caller software) to deal with Cassandra-style Java class type
+names and CQL type specifiers, and convert between them cleanly. Parameterized
+types are fully supported in both flavors. Once you have the right Type object
+for the type you want, you can use it to serialize, deserialize, or retrieve
+the corresponding CQL or Cassandra type strings.
+"""
+
+# NOTE:
+# If/when the need arises for interpret types from CQL string literals in
+# different ways (for https://issues.apache.org/jira/browse/CASSANDRA-3799,
+# for example), these classes would be a good place to tack on
+# .from_cql_literal() and .as_cql_literal() classmethods (or whatever).
+
+from __future__ import absolute_import  # to enable import io from stdlib
+import ast
+from binascii import unhexlify
+import calendar
+from collections import namedtuple
+from decimal import Decimal
+import io
+from itertools import chain
+import logging
+import re
+import socket
+import time
+import struct
+import sys
+from uuid import UUID
+
+from cassandra.marshal import (int8_pack, int8_unpack, int16_pack, int16_unpack,
+                               uint16_pack, uint16_unpack, uint32_pack, uint32_unpack,
+                               int32_pack, int32_unpack, int64_pack, int64_unpack,
+                               float_pack, float_unpack, double_pack, double_unpack,
+                               varint_pack, varint_unpack, point_be, point_le,
+                               vints_pack, vints_unpack)
+from cassandra import util, VectorDeserializationFailure
+
+_little_endian_flag = 1  # we always serialize LE
+import ipaddress
+
+apache_cassandra_type_prefix = 'org.apache.cassandra.db.marshal.'
+
+cassandra_empty_type = 'org.apache.cassandra.db.marshal.EmptyType'
+cql_empty_type = 'empty'
+
+log = logging.getLogger(__name__)
+
+_number_types = frozenset((int, float))
+
+
+def _name_from_hex_string(encoded_name):
+    bin_str = unhexlify(encoded_name)
+    return bin_str.decode('ascii')
+
+
+def trim_if_startswith(s, prefix):
+    if s.startswith(prefix):
+        return s[len(prefix):]
+    return s
+
+
+_casstypes = {}
+_cqltypes = {}
+
+
+cql_type_scanner = re.Scanner((
+    ('frozen', None),
+    (r'[a-zA-Z0-9_]+', lambda s, t: t),
+    (r'[\s,<>]', None),
+))
+
+
+def cql_types_from_string(cql_type):
+    return cql_type_scanner.scan(cql_type)[0]
+
+
+class CassandraTypeType(type):
+    """
+    The CassandraType objects in this module will normally be used directly,
+    rather than through instances of those types. They can be instantiated,
+    of course, but the type information is what this driver mainly needs.
+
+    This metaclass registers CassandraType classes in the global
+    by-cassandra-typename and by-cql-typename registries, unless their class
+    name starts with an underscore.
+    """
+
+    def __new__(metacls, name, bases, dct):
+        dct.setdefault('cassname', name)
+        cls = type.__new__(metacls, name, bases, dct)
+        if not name.startswith('_'):
+            _casstypes[name] = cls
+            if not cls.typename.startswith(apache_cassandra_type_prefix):
+                _cqltypes[cls.typename] = cls
+        return cls
+
+
+casstype_scanner = re.Scanner((
+    (r'[()]', lambda s, t: t),
+    (r'[a-zA-Z0-9_.:=>]+', lambda s, t: t),
+    (r'[\s,]', None),
+))
+
+
+def cqltype_to_python(cql_string):
+    """
+    Given a cql type string, creates a list that can be manipulated in python
+    Example:
+        int -> ['int']
+        frozen<tuple<text, int>> -> ['frozen', ['tuple', ['text', 'int']]]
+    """
+    scanner = re.Scanner((
+        (r'[a-zA-Z0-9_]+', lambda s, t: "'{}'".format(t)),
+        (r'<', lambda s, t: ', ['),
+        (r'>', lambda s, t: ']'),
+        (r'[, ]', lambda s, t: t),
+        (r'".*?"', lambda s, t: "'{}'".format(t)),
+    ))
+
+    scanned_tokens = scanner.scan(cql_string)[0]
+    hierarchy = ast.literal_eval(''.join(scanned_tokens))
+    return [hierarchy] if isinstance(hierarchy, str) else list(hierarchy)
+
+
+def python_to_cqltype(types):
+    """
+    Opposite of the `cql_to_python` function. Given a python list, creates a cql type string from the representation
+    Example:
+        ['int'] -> int
+        ['frozen', ['tuple', ['text', 'int']]] -> frozen<tuple<text, int>>
+    """
+    scanner = re.Scanner((
+        (r"'[a-zA-Z0-9_]+'", lambda s, t: t[1:-1]),
+        (r'^\[', lambda s, t: None),
+        (r'\]$', lambda s, t: None),
+        (r',\s*\[', lambda s, t: '<'),
+        (r'\]', lambda s, t: '>'),
+        (r'[, ]', lambda s, t: t),
+        (r'\'".*?"\'', lambda s, t: t[1:-1]),
+    ))
+
+    scanned_tokens = scanner.scan(repr(types))[0]
+    cql = ''.join(scanned_tokens).replace('\\\\', '\\')
+    return cql
+
+
+def _strip_frozen_from_python(types):
+    """
+    Given a python list representing a cql type, removes 'frozen'
+    Example:
+        ['frozen', ['tuple', ['text', 'int']]] -> ['tuple', ['text', 'int']]
+    """
+    while 'frozen' in types:
+        index = types.index('frozen')
+        types = types[:index] + types[index + 1] + types[index + 2:]
+    new_types = [_strip_frozen_from_python(item) if isinstance(item, list) else item for item in types]
+    return new_types
+
+
+def strip_frozen(cql):
+    """
+    Given a cql type string, and removes frozen
+    Example:
+        frozen<tuple<int>> -> tuple<int>
+    """
+    types = cqltype_to_python(cql)
+    types_without_frozen = _strip_frozen_from_python(types)
+    cql = python_to_cqltype(types_without_frozen)
+    return cql
+
+
+def lookup_casstype_simple(casstype):
+    """
+    Given a Cassandra type name (either fully distinguished or not), hand
+    back the CassandraType class responsible for it. If a name is not
+    recognized, a custom _UnrecognizedType subclass will be created for it.
+
+    This function does not handle complex types (so no type parameters--
+    nothing with parentheses). Use lookup_casstype() instead if you might need
+    that.
+    """
+    shortname = trim_if_startswith(casstype, apache_cassandra_type_prefix)
+    try:
+        typeclass = _casstypes[shortname]
+    except KeyError:
+        typeclass = mkUnrecognizedType(casstype)
+    return typeclass
+
+
+def parse_casstype_args(typestring):
+    tokens, remainder = casstype_scanner.scan(typestring)
+    if remainder:
+        raise ValueError("weird characters %r at end" % remainder)
+
+    # use a stack of (types, names) lists
+    args = [([], [])]
+    for tok in tokens:
+        if tok == '(':
+            args.append(([], []))
+        elif tok == ')':
+            types, names = args.pop()
+            prev_types, prev_names = args[-1]
+            prev_types[-1] = prev_types[-1].apply_parameters(types, names)
+        else:
+            types, names = args[-1]
+            parts = re.split(':|=>', tok)
+            tok = parts.pop()
+            if parts:
+                names.append(parts[0])
+            else:
+                names.append(None)
+
+            try:
+                ctype = int(tok)
+            except ValueError:
+                ctype = lookup_casstype_simple(tok)
+            types.append(ctype)
+
+    # return the first (outer) type, which will have all parameters applied
+    return args[0][0][0]
+
+def lookup_casstype(casstype):
+    """
+    Given a Cassandra type as a string (possibly including parameters), hand
+    back the CassandraType class responsible for it. If a name is not
+    recognized, a custom _UnrecognizedType subclass will be created for it.
+
+    Example:
+
+        >>> lookup_casstype('org.apache.cassandra.db.marshal.MapType(org.apache.cassandra.db.marshal.UTF8Type,org.apache.cassandra.db.marshal.Int32Type)')
+        <class 'cassandra.cqltypes.MapType(UTF8Type, Int32Type)'>
+
+    """
+    if isinstance(casstype, (CassandraType, CassandraTypeType)):
+        return casstype
+    try:
+        return parse_casstype_args(casstype)
+    except (ValueError, AssertionError, IndexError) as e:
+        log.debug("Exception in parse_casstype_args: %s" % e)
+        raise ValueError("Don't know how to parse type string %r: %s" % (casstype, e))
+
+
+def is_reversed_casstype(data_type):
+    return issubclass(data_type, ReversedType)
+
+
+class EmptyValue(object):
+    """ See _CassandraType.support_empty_values """
+
+    def __str__(self):
+        return "EMPTY"
+    __repr__ = __str__
+
+EMPTY = EmptyValue()
+
+
+class _CassandraType(object, metaclass=CassandraTypeType):
+    subtypes = ()
+    num_subtypes = 0
+    empty_binary_ok = False
+
+    support_empty_values = False
+    """
+    Back in the Thrift days, empty strings were used for "null" values of
+    all types, including non-string types.  For most users, an empty
+    string value in an int column is the same as being null/not present,
+    so the driver normally returns None in this case.  (For string-like
+    types, it *will* return an empty string by default instead of None.)
+
+    To avoid this behavior, set this to :const:`True`. Instead of returning
+    None for empty string values, the EMPTY singleton (an instance
+    of EmptyValue) will be returned.
+    """
+
+    def __repr__(self):
+        return '<%s>' % (self.cql_parameterized_type())
+
+    @classmethod
+    def from_binary(cls, byts, protocol_version):
+        """
+        Deserialize a bytestring into a value. See the deserialize() method
+        for more information. This method differs in that if None or the empty
+        string is passed in, None may be returned.
+        """
+        if byts is None:
+            return None
+        elif len(byts) == 0 and not cls.empty_binary_ok:
+            return EMPTY if cls.support_empty_values else None
+        return cls.deserialize(byts, protocol_version)
+
+    @classmethod
+    def to_binary(cls, val, protocol_version):
+        """
+        Serialize a value into a bytestring. See the serialize() method for
+        more information. This method differs in that if None is passed in,
+        the result is the empty string.
+        """
+        return b'' if val is None else cls.serialize(val, protocol_version)
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        """
+        Given a bytestring, deserialize into a value according to the protocol
+        for this type. Note that this does not create a new instance of this
+        class; it merely gives back a value that would be appropriate to go
+        inside an instance of this class.
+        """
+        return byts
+
+    @staticmethod
+    def serialize(val, protocol_version):
+        """
+        Given a value appropriate for this class, serialize it according to the
+        protocol for this type and return the corresponding bytestring.
+        """
+        return val
+
+    @classmethod
+    def cass_parameterized_type_with(cls, subtypes, full=False):
+        """
+        Return the name of this type as it would be expressed by Cassandra,
+        optionally fully qualified. If subtypes is not None, it is expected
+        to be a list of other CassandraType subclasses, and the output
+        string includes the Cassandra names for those subclasses as well,
+        as parameters to this one.
+
+        Example:
+
+            >>> LongType.cass_parameterized_type_with(())
+            'LongType'
+            >>> LongType.cass_parameterized_type_with((), full=True)
+            'org.apache.cassandra.db.marshal.LongType'
+            >>> SetType.cass_parameterized_type_with([DecimalType], full=True)
+            'org.apache.cassandra.db.marshal.SetType(org.apache.cassandra.db.marshal.DecimalType)'
+        """
+        cname = cls.cassname
+        if full and '.' not in cname:
+            cname = apache_cassandra_type_prefix + cname
+        if not subtypes:
+            return cname
+        sublist = ', '.join(styp.cass_parameterized_type(full=full) for styp in subtypes)
+        return '%s(%s)' % (cname, sublist)
+
+    @classmethod
+    def apply_parameters(cls, subtypes, names=None):
+        """
+        Given a set of other CassandraTypes, create a new subtype of this type
+        using them as parameters. This is how composite types are constructed.
+
+            >>> MapType.apply_parameters([DateType, BooleanType])
+            <class 'cassandra.cqltypes.MapType(DateType, BooleanType)'>
+
+        `subtypes` will be a sequence of CassandraTypes.  If provided, `names`
+        will be an equally long sequence of column names or Nones.
+        """
+        if cls.num_subtypes != 'UNKNOWN' and len(subtypes) != cls.num_subtypes:
+            raise ValueError("%s types require %d subtypes (%d given)"
+                             % (cls.typename, cls.num_subtypes, len(subtypes)))
+        newname = cls.cass_parameterized_type_with(subtypes)
+        return type(newname, (cls,), {'subtypes': subtypes, 'cassname': cls.cassname, 'fieldnames': names})
+
+    @classmethod
+    def cql_parameterized_type(cls):
+        """
+        Return a CQL type specifier for this type. If this type has parameters,
+        they are included in standard CQL <> notation.
+        """
+        if not cls.subtypes:
+            return cls.typename
+        return '%s<%s>' % (cls.typename, ', '.join(styp.cql_parameterized_type() for styp in cls.subtypes))
+
+    @classmethod
+    def cass_parameterized_type(cls, full=False):
+        """
+        Return a Cassandra type specifier for this type. If this type has
+        parameters, they are included in the standard () notation.
+        """
+        return cls.cass_parameterized_type_with(cls.subtypes, full=full)
+
+
+# it's initially named with a _ to avoid registering it as a real type, but
+# client programs may want to use the name still for isinstance(), etc
+CassandraType = _CassandraType
+
+
+class _UnrecognizedType(_CassandraType):
+    num_subtypes = 'UNKNOWN'
+
+
+def mkUnrecognizedType(casstypename):
+    return CassandraTypeType(casstypename,
+                             (_UnrecognizedType,),
+                             {'typename': "'%s'" % casstypename})
+
+
+class BytesType(_CassandraType):
+    typename = 'blob'
+    empty_binary_ok = True
+
+    @staticmethod
+    def serialize(val, protocol_version):
+        return bytes(val)
+
+
+class DecimalType(_CassandraType):
+    typename = 'decimal'
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        scale = int32_unpack(byts[:4])
+        unscaled = varint_unpack(byts[4:])
+        return Decimal('%de%d' % (unscaled, -scale))
+
+    @staticmethod
+    def serialize(dec, protocol_version):
+        try:
+            sign, digits, exponent = dec.as_tuple()
+        except AttributeError:
+            try:
+                sign, digits, exponent = Decimal(dec).as_tuple()
+            except Exception:
+                raise TypeError("Invalid type for Decimal value: %r", dec)
+        unscaled = int(''.join([str(digit) for digit in digits]))
+        if sign:
+            unscaled *= -1
+        scale = int32_pack(-exponent)
+        unscaled = varint_pack(unscaled)
+        return scale + unscaled
+
+
+class UUIDType(_CassandraType):
+    typename = 'uuid'
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        return UUID(bytes=byts)
+
+    @staticmethod
+    def serialize(uuid, protocol_version):
+        try:
+            return uuid.bytes
+        except AttributeError:
+            raise TypeError("Got a non-UUID object for a UUID value")
+
+
+class BooleanType(_CassandraType):
+    typename = 'boolean'
+    serial_size = 1
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        return bool(int8_unpack(byts))
+
+    @staticmethod
+    def serialize(truth, protocol_version):
+        return int8_pack(truth)
+
+class ByteType(_CassandraType):
+    typename = 'tinyint'
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        return int8_unpack(byts)
+
+    @staticmethod
+    def serialize(byts, protocol_version):
+        return int8_pack(byts)
+
+
+class AsciiType(_CassandraType):
+    typename = 'ascii'
+    empty_binary_ok = True
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        return byts.decode('ascii')
+
+    @staticmethod
+    def serialize(var, protocol_version):
+        try:
+            return var.encode('ascii')
+        except UnicodeDecodeError:
+            return var
+
+
+class FloatType(_CassandraType):
+    typename = 'float'
+    serial_size = 4
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        return float_unpack(byts)
+
+    @staticmethod
+    def serialize(byts, protocol_version):
+        return float_pack(byts)
+
+
+class DoubleType(_CassandraType):
+    typename = 'double'
+    serial_size = 8
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        return double_unpack(byts)
+
+    @staticmethod
+    def serialize(byts, protocol_version):
+        return double_pack(byts)
+
+
+class LongType(_CassandraType):
+    typename = 'bigint'
+    serial_size = 8
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        return int64_unpack(byts)
+
+    @staticmethod
+    def serialize(byts, protocol_version):
+        return int64_pack(byts)
+
+
+class Int32Type(_CassandraType):
+    typename = 'int'
+    serial_size = 4
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        return int32_unpack(byts)
+
+    @staticmethod
+    def serialize(byts, protocol_version):
+        return int32_pack(byts)
+
+
+class IntegerType(_CassandraType):
+    typename = 'varint'
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        return varint_unpack(byts)
+
+    @staticmethod
+    def serialize(byts, protocol_version):
+        return varint_pack(byts)
+
+
+class InetAddressType(_CassandraType):
+    typename = 'inet'
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        if len(byts) == 16:
+            return util.inet_ntop(socket.AF_INET6, byts)
+        else:
+            # util.inet_pton could also handle, but this is faster
+            # since we've already determined the AF
+            return socket.inet_ntoa(byts)
+
+    @staticmethod
+    def serialize(addr, protocol_version):
+        try:
+            if ':' in addr:
+                return util.inet_pton(socket.AF_INET6, addr)
+            else:
+                # util.inet_pton could also handle, but this is faster
+                # since we've already determined the AF
+                return socket.inet_aton(addr)
+        except:
+            if isinstance(addr, (ipaddress.IPv4Address, ipaddress.IPv6Address)):
+                return addr.packed
+            raise ValueError("can't interpret %r as an inet address" % (addr,))
+
+
+class CounterColumnType(LongType):
+    typename = 'counter'
+
+cql_timestamp_formats = (
+    '%Y-%m-%d %H:%M',
+    '%Y-%m-%d %H:%M:%S',
+    '%Y-%m-%dT%H:%M',
+    '%Y-%m-%dT%H:%M:%S',
+    '%Y-%m-%d'
+)
+
+_have_warned_about_timestamps = False
+
+
+class DateType(_CassandraType):
+    typename = 'timestamp'
+
+    @staticmethod
+    def interpret_datestring(val):
+        if val[-5] in ('+', '-'):
+            offset = (int(val[-4:-2]) * 3600 + int(val[-2:]) * 60) * int(val[-5] + '1')
+            val = val[:-5]
+        else:
+            offset = -time.timezone
+        for tformat in cql_timestamp_formats:
+            try:
+                tval = time.strptime(val, tformat)
+            except ValueError:
+                continue
+            # scale seconds to millis for the raw value
+            return (calendar.timegm(tval) + offset) * 1e3
+        else:
+            raise ValueError("can't interpret %r as a date" % (val,))
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        timestamp = int64_unpack(byts) / 1000.0
+        return util.datetime_from_timestamp(timestamp)
+
+    @staticmethod
+    def serialize(v, protocol_version):
+        try:
+            # v is datetime
+            timestamp_seconds = calendar.timegm(v.utctimetuple())
+            timestamp = timestamp_seconds * 1e3 + getattr(v, 'microsecond', 0) / 1e3
+        except AttributeError:
+            try:
+                timestamp = calendar.timegm(v.timetuple()) * 1e3
+            except AttributeError:
+                # Ints and floats are valid timestamps too
+                if type(v) not in _number_types:
+                    raise TypeError('DateType arguments must be a datetime, date, or timestamp')
+                timestamp = v
+
+        return int64_pack(int(timestamp))
+
+
+class TimestampType(DateType):
+    pass
+
+
+class TimeUUIDType(DateType):
+    typename = 'timeuuid'
+    serial_size = 16
+
+    def my_timestamp(self):
+        return util.unix_time_from_uuid1(self.val)
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        return UUID(bytes=byts)
+
+    @staticmethod
+    def serialize(timeuuid, protocol_version):
+        try:
+            return timeuuid.bytes
+        except AttributeError:
+            raise TypeError("Got a non-UUID object for a UUID value")
+
+
+class SimpleDateType(_CassandraType):
+    typename = 'date'
+    date_format = "%Y-%m-%d"
+
+    # Values of the 'date'` type are encoded as 32-bit unsigned integers
+    # representing a number of days with epoch (January 1st, 1970) at the center of the
+    # range (2^31).
+    EPOCH_OFFSET_DAYS = 2 ** 31
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        days = uint32_unpack(byts) - SimpleDateType.EPOCH_OFFSET_DAYS
+        return util.Date(days)
+
+    @staticmethod
+    def serialize(val, protocol_version):
+        try:
+            days = val.days_from_epoch
+        except AttributeError:
+            if isinstance(val, int):
+                # the DB wants offset int values, but util.Date init takes days from epoch
+                # here we assume int values are offset, as they would appear in CQL
+                # short circuit to avoid subtracting just to add offset
+                return uint32_pack(val)
+            days = util.Date(val).days_from_epoch
+        return uint32_pack(days + SimpleDateType.EPOCH_OFFSET_DAYS)
+
+
+class ShortType(_CassandraType):
+    typename = 'smallint'
+    serial_size = 2
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        return int16_unpack(byts)
+
+    @staticmethod
+    def serialize(byts, protocol_version):
+        return int16_pack(byts)
+
+
+class TimeType(_CassandraType):
+    typename = 'time'
+    serial_size = 8
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        return util.Time(int64_unpack(byts))
+
+    @staticmethod
+    def serialize(val, protocol_version):
+        try:
+            nano = val.nanosecond_time
+        except AttributeError:
+            nano = util.Time(val).nanosecond_time
+        return int64_pack(nano)
+
+
+class DurationType(_CassandraType):
+    typename = 'duration'
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        months, days, nanoseconds = vints_unpack(byts)
+        return util.Duration(months, days, nanoseconds)
+
+    @staticmethod
+    def serialize(duration, protocol_version):
+        try:
+            m, d, n = duration.months, duration.days, duration.nanoseconds
+        except AttributeError:
+            raise TypeError('DurationType arguments must be a Duration.')
+        return vints_pack([m, d, n])
+
+
+class UTF8Type(_CassandraType):
+    typename = 'text'
+    empty_binary_ok = True
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        return byts.decode('utf8')
+
+    @staticmethod
+    def serialize(ustr, protocol_version):
+        try:
+            return ustr.encode('utf-8')
+        except UnicodeDecodeError:
+            # already utf-8
+            return ustr
+
+
+class VarcharType(UTF8Type):
+    typename = 'varchar'
+
+
+class _ParameterizedType(_CassandraType):
+    num_subtypes = 'UNKNOWN'
+
+    @classmethod
+    def deserialize(cls, byts, protocol_version):
+        if not cls.subtypes:
+            raise NotImplementedError("can't deserialize unparameterized %s"
+                                      % cls.typename)
+        return cls.deserialize_safe(byts, protocol_version)
+
+    @classmethod
+    def serialize(cls, val, protocol_version):
+        if not cls.subtypes:
+            raise NotImplementedError("can't serialize unparameterized %s"
+                                      % cls.typename)
+        return cls.serialize_safe(val, protocol_version)
+
+
+class _SimpleParameterizedType(_ParameterizedType):
+    @classmethod
+    def deserialize_safe(cls, byts, protocol_version):
+        subtype, = cls.subtypes
+        if protocol_version >= 3:
+            unpack = int32_unpack
+            length = 4
+        else:
+            unpack = uint16_unpack
+            length = 2
+        numelements = unpack(byts[:length])
+        p = length
+        result = []
+        inner_proto = max(3, protocol_version)
+        for _ in range(numelements):
+            itemlen = unpack(byts[p:p + length])
+            p += length
+            if itemlen < 0:
+                result.append(None)
+            else:
+                item = byts[p:p + itemlen]
+                p += itemlen
+                result.append(subtype.from_binary(item, inner_proto))
+        return cls.adapter(result)
+
+    @classmethod
+    def serialize_safe(cls, items, protocol_version):
+        if isinstance(items, str):
+            raise TypeError("Received a string for a type that expects a sequence")
+
+        subtype, = cls.subtypes
+        pack = int32_pack if protocol_version >= 3 else uint16_pack
+        buf = io.BytesIO()
+        buf.write(pack(len(items)))
+        inner_proto = max(3, protocol_version)
+        for item in items:
+            itembytes = subtype.to_binary(item, inner_proto)
+            buf.write(pack(len(itembytes)))
+            buf.write(itembytes)
+        return buf.getvalue()
+
+
+class ListType(_SimpleParameterizedType):
+    typename = 'list'
+    num_subtypes = 1
+    adapter = list
+
+
+class SetType(_SimpleParameterizedType):
+    typename = 'set'
+    num_subtypes = 1
+    adapter = util.sortedset
+
+
+class MapType(_ParameterizedType):
+    typename = 'map'
+    num_subtypes = 2
+
+    @classmethod
+    def deserialize_safe(cls, byts, protocol_version):
+        key_type, value_type = cls.subtypes
+        if protocol_version >= 3:
+            unpack = int32_unpack
+            length = 4
+        else:
+            unpack = uint16_unpack
+            length = 2
+        numelements = unpack(byts[:length])
+        p = length
+        themap = util.OrderedMapSerializedKey(key_type, protocol_version)
+        inner_proto = max(3, protocol_version)
+        for _ in range(numelements):
+            key_len = unpack(byts[p:p + length])
+            p += length
+            if key_len < 0:
+                keybytes = None
+                key = None
+            else:
+                keybytes = byts[p:p + key_len]
+                p += key_len
+                key = key_type.from_binary(keybytes, inner_proto)
+
+            val_len = unpack(byts[p:p + length])
+            p += length
+            if val_len < 0:
+                val = None
+            else:
+                valbytes = byts[p:p + val_len]
+                p += val_len
+                val = value_type.from_binary(valbytes, inner_proto)
+
+            themap._insert_unchecked(key, keybytes, val)
+        return themap
+
+    @classmethod
+    def serialize_safe(cls, themap, protocol_version):
+        key_type, value_type = cls.subtypes
+        pack = int32_pack if protocol_version >= 3 else uint16_pack
+        buf = io.BytesIO()
+        buf.write(pack(len(themap)))
+        try:
+            items = themap.items()
+        except AttributeError:
+            raise TypeError("Got a non-map object for a map value")
+        inner_proto = max(3, protocol_version)
+        for key, val in items:
+            keybytes = key_type.to_binary(key, inner_proto)
+            valbytes = value_type.to_binary(val, inner_proto)
+            buf.write(pack(len(keybytes)))
+            buf.write(keybytes)
+            buf.write(pack(len(valbytes)))
+            buf.write(valbytes)
+        return buf.getvalue()
+
+
+class TupleType(_ParameterizedType):
+    typename = 'tuple'
+
+    @classmethod
+    def deserialize_safe(cls, byts, protocol_version):
+        proto_version = max(3, protocol_version)
+        p = 0
+        values = []
+        for col_type in cls.subtypes:
+            if p == len(byts):
+                break
+            itemlen = int32_unpack(byts[p:p + 4])
+            p += 4
+            if itemlen >= 0:
+                item = byts[p:p + itemlen]
+                p += itemlen
+            else:
+                item = None
+            # collections inside UDTs are always encoded with at least the
+            # version 3 format
+            values.append(col_type.from_binary(item, proto_version))
+
+        if len(values) < len(cls.subtypes):
+            nones = [None] * (len(cls.subtypes) - len(values))
+            values = values + nones
+
+        return tuple(values)
+
+    @classmethod
+    def serialize_safe(cls, val, protocol_version):
+        if len(val) > len(cls.subtypes):
+            raise ValueError("Expected %d items in a tuple, but got %d: %s" %
+                             (len(cls.subtypes), len(val), val))
+
+        proto_version = max(3, protocol_version)
+        buf = io.BytesIO()
+        for item, subtype in zip(val, cls.subtypes):
+            if item is not None:
+                packed_item = subtype.to_binary(item, proto_version)
+                buf.write(int32_pack(len(packed_item)))
+                buf.write(packed_item)
+            else:
+                buf.write(int32_pack(-1))
+        return buf.getvalue()
+
+    @classmethod
+    def cql_parameterized_type(cls):
+        subtypes_string = ', '.join(sub.cql_parameterized_type() for sub in cls.subtypes)
+        return 'frozen<tuple<%s>>' % (subtypes_string,)
+
+
+class UserType(TupleType):
+    typename = "org.apache.cassandra.db.marshal.UserType"
+
+    _cache = {}
+    _module = sys.modules[__name__]
+
+    @classmethod
+    def make_udt_class(cls, keyspace, udt_name, field_names, field_types):
+        assert len(field_names) == len(field_types)
+
+        instance = cls._cache.get((keyspace, udt_name))
+        if not instance or instance.fieldnames != field_names or instance.subtypes != field_types:
+            instance = type(udt_name, (cls,), {'subtypes': field_types,
+                                               'cassname': cls.cassname,
+                                               'typename': udt_name,
+                                               'fieldnames': field_names,
+                                               'keyspace': keyspace,
+                                               'mapped_class': None,
+                                               'tuple_type': cls._make_registered_udt_namedtuple(keyspace, udt_name, field_names)})
+            cls._cache[(keyspace, udt_name)] = instance
+        return instance
+
+    @classmethod
+    def evict_udt_class(cls, keyspace, udt_name):
+        try:
+            del cls._cache[(keyspace, udt_name)]
+        except KeyError:
+            pass
+
+    @classmethod
+    def apply_parameters(cls, subtypes, names):
+        keyspace = subtypes[0].cass_parameterized_type()  # when parsed from cassandra type, the keyspace is created as an unrecognized cass type; This gets the name back
+        udt_name = _name_from_hex_string(subtypes[1].cassname)
+        field_names = tuple(_name_from_hex_string(encoded_name) for encoded_name in names[2:])  # using tuple here to match what comes into make_udt_class from other sources (for caching equality test)
+        return cls.make_udt_class(keyspace, udt_name, field_names, tuple(subtypes[2:]))
+
+    @classmethod
+    def cql_parameterized_type(cls):
+        return "frozen<%s>" % (cls.typename,)
+
+    @classmethod
+    def deserialize_safe(cls, byts, protocol_version):
+        values = super(UserType, cls).deserialize_safe(byts, protocol_version)
+        if cls.mapped_class:
+            return cls.mapped_class(**dict(zip(cls.fieldnames, values)))
+        elif cls.tuple_type:
+            return cls.tuple_type(*values)
+        else:
+            return tuple(values)
+
+    @classmethod
+    def serialize_safe(cls, val, protocol_version):
+        proto_version = max(3, protocol_version)
+        buf = io.BytesIO()
+        for i, (fieldname, subtype) in enumerate(zip(cls.fieldnames, cls.subtypes)):
+            # first treat as a tuple, else by custom type
+            try:
+                item = val[i]
+            except TypeError:
+                item = getattr(val, fieldname, None)
+                if item is None and not hasattr(val, fieldname):
+                    log.warning(f"field {fieldname} is part of the UDT {cls.typename} but is not present in the value {val}")
+
+            if item is not None:
+                packed_item = subtype.to_binary(item, proto_version)
+                buf.write(int32_pack(len(packed_item)))
+                buf.write(packed_item)
+            else:
+                buf.write(int32_pack(-1))
+        return buf.getvalue()
+
+    @classmethod
+    def _make_registered_udt_namedtuple(cls, keyspace, name, field_names):
+        # this is required to make the type resolvable via this module...
+        # required when unregistered udts are pickled for use as keys in
+        # util.OrderedMap
+        t = cls._make_udt_tuple_type(name, field_names)
+        if t:
+            qualified_name = "%s_%s" % (keyspace, name)
+            setattr(cls._module, qualified_name, t)
+        return t
+
+    @classmethod
+    def _make_udt_tuple_type(cls, name, field_names):
+        # fallback to positional named, then unnamed tuples
+        # for CQL identifiers that aren't valid in Python,
+        try:
+            t = namedtuple(name, field_names)
+        except ValueError:
+            try:
+                t = namedtuple(name, util._positional_rename_invalid_identifiers(field_names))
+                log.warning("could not create a namedtuple for '%s' because one or more "
+                            "field names are not valid Python identifiers (%s); "
+                            "returning positionally-named fields" % (name, field_names))
+            except ValueError:
+                t = None
+                log.warning("could not create a namedtuple for '%s' because the name is "
+                            "not a valid Python identifier; will return tuples in "
+                            "its place" % (name,))
+        return t
+
+
+class CompositeType(_ParameterizedType):
+    typename = "org.apache.cassandra.db.marshal.CompositeType"
+
+    @classmethod
+    def cql_parameterized_type(cls):
+        """
+        There is no CQL notation for Composites, so we override this.
+        """
+        typestring = cls.cass_parameterized_type(full=True)
+        return "'%s'" % (typestring,)
+
+    @classmethod
+    def deserialize_safe(cls, byts, protocol_version):
+        result = []
+        for subtype in cls.subtypes:
+            if not byts:
+                # CompositeType can have missing elements at the end
+                break
+
+            element_length = uint16_unpack(byts[:2])
+            element = byts[2:2 + element_length]
+
+            # skip element length, element, and the EOC (one byte)
+            byts = byts[2 + element_length + 1:]
+            result.append(subtype.from_binary(element, protocol_version))
+
+        return tuple(result)
+
+
+class DynamicCompositeType(_ParameterizedType):
+    typename = "org.apache.cassandra.db.marshal.DynamicCompositeType"
+
+    @classmethod
+    def cql_parameterized_type(cls):
+        sublist = ', '.join('%s=>%s' % (alias, typ.cass_parameterized_type(full=True)) for alias, typ in zip(cls.fieldnames, cls.subtypes))
+        return "'%s(%s)'" % (cls.typename, sublist)
+
+
+class ColumnToCollectionType(_ParameterizedType):
+    """
+    This class only really exists so that we can cleanly evaluate types when
+    Cassandra includes this. We don't actually need or want the extra
+    information.
+    """
+    typename = "org.apache.cassandra.db.marshal.ColumnToCollectionType"
+
+
+class ReversedType(_ParameterizedType):
+    typename = "org.apache.cassandra.db.marshal.ReversedType"
+    num_subtypes = 1
+
+    @classmethod
+    def deserialize_safe(cls, byts, protocol_version):
+        subtype, = cls.subtypes
+        return subtype.from_binary(byts, protocol_version)
+
+    @classmethod
+    def serialize_safe(cls, val, protocol_version):
+        subtype, = cls.subtypes
+        return subtype.to_binary(val, protocol_version)
+
+
+class FrozenType(_ParameterizedType):
+    typename = "frozen"
+    num_subtypes = 1
+
+    @classmethod
+    def deserialize_safe(cls, byts, protocol_version):
+        subtype, = cls.subtypes
+        return subtype.from_binary(byts, protocol_version)
+
+    @classmethod
+    def serialize_safe(cls, val, protocol_version):
+        subtype, = cls.subtypes
+        return subtype.to_binary(val, protocol_version)
+
+
+def is_counter_type(t):
+    if isinstance(t, str):
+        t = lookup_casstype(t)
+    return issubclass(t, CounterColumnType)
+
+
+def cql_typename(casstypename):
+    """
+    Translate a Cassandra-style type specifier (optionally-fully-distinguished
+    Java class names for data types, along with optional parameters) into a
+    CQL-style type specifier.
+
+        >>> cql_typename('DateType')
+        'timestamp'
+        >>> cql_typename('org.apache.cassandra.db.marshal.ListType(IntegerType)')
+        'list<varint>'
+    """
+    return lookup_casstype(casstypename).cql_parameterized_type()
+
+
+class WKBGeometryType(object):
+    POINT = 1
+    LINESTRING = 2
+    POLYGON = 3
+
+
+class PointType(CassandraType):
+    typename = 'PointType'
+
+    _type = struct.pack('<BI', _little_endian_flag, WKBGeometryType.POINT)
+
+    @staticmethod
+    def serialize(val, protocol_version):
+        return PointType._type + point_le.pack(val.x, val.y)
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        is_little_endian = bool(byts[0])
+        point = point_le if is_little_endian else point_be
+        return util.Point(*point.unpack_from(byts, 5))  # ofs = endian byte + int type
+
+
+class LineStringType(CassandraType):
+    typename = 'LineStringType'
+
+    _type = struct.pack('<BI', _little_endian_flag, WKBGeometryType.LINESTRING)
+
+    @staticmethod
+    def serialize(val, protocol_version):
+        num_points = len(val.coords)
+        return LineStringType._type + struct.pack('<I' + 'dd' * num_points, num_points, *(d for coords in val.coords for d in coords))
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        is_little_endian = bool(byts[0])
+        point = point_le if is_little_endian else point_be
+        coords = ((point.unpack_from(byts, offset) for offset in range(1 + 4 + 4, len(byts), point.size)))  # start = endian + int type + int count
+        return util.LineString(coords)
+
+
+class PolygonType(CassandraType):
+    typename = 'PolygonType'
+
+    _type = struct.pack('<BI', _little_endian_flag, WKBGeometryType.POLYGON)
+    _ring_count = struct.Struct('<I').pack
+
+    @staticmethod
+    def serialize(val, protocol_version):
+        buf = io.BytesIO(PolygonType._type)
+        buf.seek(0, 2)
+
+        if val.exterior.coords:
+            num_rings = 1 + len(val.interiors)
+            buf.write(PolygonType._ring_count(num_rings))
+            for ring in chain((val.exterior,), val.interiors):
+                num_points = len(ring.coords)
+                buf.write(struct.pack('<I' + 'dd' * num_points, num_points, *(d for coord in ring.coords for d in coord)))
+        else:
+            buf.write(PolygonType._ring_count(0))
+        return buf.getvalue()
+
+    @staticmethod
+    def deserialize(byts, protocol_version):
+        is_little_endian = bool(byts[0])
+        if is_little_endian:
+            int_fmt = '<i'
+            point = point_le
+        else:
+            int_fmt = '>i'
+            point = point_be
+        p = 5
+        ring_count = struct.unpack_from(int_fmt, byts, p)[0]
+        p += 4
+        rings = []
+        for _ in range(ring_count):
+            point_count = struct.unpack_from(int_fmt, byts, p)[0]
+            p += 4
+            end = p + point_count * point.size
+            rings.append([point.unpack_from(byts, offset) for offset in range(p, end, point.size)])
+            p = end
+        return util.Polygon(exterior=rings[0], interiors=rings[1:]) if rings else util.Polygon()
+
+
+class BoundKind(object):
+    """
+    "Enum" representing the 6 possible DateRangeTypes
+    """
+    SINGLE_DATE = 'SINGLE_DATE'
+    CLOSED_RANGE = 'CLOSED_RANGE'
+    OPEN_RANGE_HIGH = 'OPEN_RANGE_HIGH'
+    OPEN_RANGE_LOW = 'OPEN_RANGE_LOW'
+    BOTH_OPEN_RANGE = 'BOTH_OPEN_RANGE'
+    SINGLE_DATE_OPEN = 'SINGLE_DATE_OPEN'
+
+    VALID_RANGE_BOUNDS = (SINGLE_DATE, CLOSED_RANGE, OPEN_RANGE_HIGH,
+                          OPEN_RANGE_LOW, BOTH_OPEN_RANGE,
+                          SINGLE_DATE_OPEN)
+
+    _bound_str_to_int_map = {
+        'SINGLE_DATE': 0,
+        'CLOSED_RANGE': 1,
+        'OPEN_RANGE_HIGH': 2,
+        'OPEN_RANGE_LOW': 3,
+        'BOTH_OPEN_RANGE': 4,
+        'SINGLE_DATE_OPEN': 5,
+    }
+    _bound_int_to_str_map = {i: s for i, s in _bound_str_to_int_map.items()}
+
+    @classmethod
+    def to_int(cls, bound_str):
+        """
+        Encode a string as an int for serialization.
+        """
+        return cls._bound_str_to_int_map[bound_str.upper()]
+
+    @classmethod
+    def to_str(cls, bound_int):
+        """
+        Decode an int to a string for deserialization.
+        """
+        return cls._bound_int_to_str_map[bound_int.upper()]
+
+
+class DateRangeType(CassandraType):
+    typename = 'daterange'
+
+    _precision_str_to_int_map = {
+        'YEAR': 0,
+        'MONTH': 1,
+        'DAY': 2,
+        'HOUR': 3,
+        'MINUTE': 4,
+        'SECOND': 5,
+        'MILLISECOND': 6
+    }
+    _precision_int_to_str_map = {s: i for i, s in _precision_str_to_int_map.items()}
+
+    @classmethod
+    def _encode_precision(cls, precision_str):
+        normalized_str = precision_str.upper()
+        if normalized_str not in cls._precision_str_to_int_map:
+            raise ValueError(
+                '%s is not a valid DateRange precision string. Valid values: %s' %
+                (repr(precision_str), ', '.join(list(cls._precision_str_to_int_map)))
+            )
+
+        return cls._precision_str_to_int_map[normalized_str]
+
+    @classmethod
+    def _decode_precision(cls, precision_int):
+        if precision_int not in cls._precision_int_to_str_map:
+            raise ValueError(
+                '%s not a valid DateRange precision int. Valid values: %s' %
+                (precision_int, ', '.join([str(i) for i in cls._precision_int_to_str_map]))
+            )
+
+        return cls._precision_int_to_str_map[precision_int]
+
+    @classmethod
+    def deserialize(cls, byts, protocol_version):
+        # <type>[<time0><precision0>[<time1><precision1>]]
+        type_ = int8_unpack(byts[0:1])
+
+        if type_ in (BoundKind.to_int(BoundKind.BOTH_OPEN_RANGE),
+                     BoundKind.to_int(BoundKind.SINGLE_DATE_OPEN)):
+            time0 = precision0 = None
+        else:
+            time0 = int64_unpack(byts[1:9])
+            precision0 = int8_unpack(byts[9:10])
+
+        if type_ == BoundKind.to_int(BoundKind.CLOSED_RANGE):
+            time1 = int64_unpack(byts[10:18])
+            precision1 = int8_unpack(byts[18:19])
+        else:
+            time1 = precision1 = None
+
+        if time0 is not None:
+            date_range_bound0 = util.DateRangeBound(
+                time0,
+                cls._decode_precision(precision0)
+            )
+        if time1 is not None:
+            date_range_bound1 = util.DateRangeBound(
+                time1,
+                cls._decode_precision(precision1)
+            )
+
+        if type_ == BoundKind.to_int(BoundKind.SINGLE_DATE):
+            return util.DateRange(value=date_range_bound0)
+        if type_ == BoundKind.to_int(BoundKind.CLOSED_RANGE):
+            return util.DateRange(lower_bound=date_range_bound0,
+                                  upper_bound=date_range_bound1)
+        if type_ == BoundKind.to_int(BoundKind.OPEN_RANGE_HIGH):
+            return util.DateRange(lower_bound=date_range_bound0,
+                                  upper_bound=util.OPEN_BOUND)
+        if type_ == BoundKind.to_int(BoundKind.OPEN_RANGE_LOW):
+            return util.DateRange(lower_bound=util.OPEN_BOUND,
+                                  upper_bound=date_range_bound0)
+        if type_ == BoundKind.to_int(BoundKind.BOTH_OPEN_RANGE):
+            return util.DateRange(lower_bound=util.OPEN_BOUND,
+                                  upper_bound=util.OPEN_BOUND)
+        if type_ == BoundKind.to_int(BoundKind.SINGLE_DATE_OPEN):
+            return util.DateRange(value=util.OPEN_BOUND)
+        raise ValueError('Could not deserialize %r' % (byts,))
+
+    @classmethod
+    def serialize(cls, v, protocol_version):
+        buf = io.BytesIO()
+        bound_kind, bounds = None, ()
+
+        try:
+            value = v.value
+        except AttributeError:
+            raise ValueError(
+                '%s.serialize expects an object with a value attribute; got'
+                '%r' % (cls.__name__, v)
+            )
+
+        if value is None:
+            try:
+                lower_bound, upper_bound = v.lower_bound, v.upper_bound
+            except AttributeError:
+                raise ValueError(
+                    '%s.serialize expects an object with lower_bound and '
+                    'upper_bound attributes; got %r' % (cls.__name__, v)
+                )
+            if lower_bound == util.OPEN_BOUND and upper_bound == util.OPEN_BOUND:
+                bound_kind = BoundKind.BOTH_OPEN_RANGE
+            elif lower_bound == util.OPEN_BOUND:
+                bound_kind = BoundKind.OPEN_RANGE_LOW
+                bounds = (upper_bound,)
+            elif upper_bound == util.OPEN_BOUND:
+                bound_kind = BoundKind.OPEN_RANGE_HIGH
+                bounds = (lower_bound,)
+            else:
+                bound_kind = BoundKind.CLOSED_RANGE
+                bounds = lower_bound, upper_bound
+        else:  # value is not None
+            if value == util.OPEN_BOUND:
+                bound_kind = BoundKind.SINGLE_DATE_OPEN
+            else:
+                bound_kind = BoundKind.SINGLE_DATE
+                bounds = (value,)
+
+        if bound_kind is None:
+            raise ValueError(
+                'Cannot serialize %r; could not find bound kind' % (v,)
+            )
+
+        buf.write(int8_pack(BoundKind.to_int(bound_kind)))
+        for bound in bounds:
+            buf.write(int64_pack(bound.milliseconds))
+            buf.write(int8_pack(cls._encode_precision(bound.precision)))
+
+        return buf.getvalue()
+
+class VectorType(_CassandraType):
+    typename = 'org.apache.cassandra.db.marshal.VectorType'
+    vector_size = 0
+    subtype = None
+
+    @classmethod
+    def apply_parameters(cls, params, names):
+        assert len(params) == 2
+        subtype = lookup_casstype(params[0])
+        vsize = params[1]
+        return type('%s(%s)' % (cls.cass_parameterized_type_with([]), vsize), (cls,), {'vector_size': vsize, 'subtype': subtype})
+
+    @classmethod
+    def deserialize(cls, byts, protocol_version):
+        serialized_size = getattr(cls.subtype, "serial_size", None)
+        if not serialized_size:
+            raise VectorDeserializationFailure("Cannot determine serialized size for vector with subtype %s" % cls.subtype.__name__)
+        indexes = (serialized_size * x for x in range(0, cls.vector_size))
+        return [cls.subtype.deserialize(byts[idx:idx + serialized_size], protocol_version) for idx in indexes]
+
+    @classmethod
+    def serialize(cls, v, protocol_version):
+        buf = io.BytesIO()
+        for item in v:
+            buf.write(cls.subtype.serialize(item, protocol_version))
+        return buf.getvalue()
+
+    @classmethod
+    def cql_parameterized_type(cls):
+        return "%s<%s, %s>" % (cls.typename, cls.subtype.typename, cls.vector_size)
diff --git a/llm/Lib/site-packages/cassandra/cython_deps.py b/llm/Lib/site-packages/cassandra/cython_deps.py
new file mode 100644
index 0000000000000000000000000000000000000000..2c708fd1890d882acb37d1fdb523360f1cfb0413
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cython_deps.py
@@ -0,0 +1,11 @@
+try:
+    from cassandra.row_parser import make_recv_results_rows
+    HAVE_CYTHON = True
+except ImportError:
+    HAVE_CYTHON = False
+
+try:
+    import numpy
+    HAVE_NUMPY = True
+except ImportError:
+    HAVE_NUMPY = False
diff --git a/llm/Lib/site-packages/cassandra/cython_marshal.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/cython_marshal.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..17125aa8a0b85d9803c30f1dbf3e87a4f1e6378a
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cython_marshal.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/cython_marshal.pyx b/llm/Lib/site-packages/cassandra/cython_marshal.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..1c9599ceb3c2d78d301e90ec570e729b2c99e87c
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cython_marshal.pyx
@@ -0,0 +1,70 @@
+# -- cython: profile=True
+#
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from libc.stdint cimport (int8_t, int16_t, int32_t, int64_t,
+                          uint8_t, uint16_t, uint32_t, uint64_t)
+from libc.string cimport memcpy
+from cassandra.buffer cimport Buffer, buf_read, to_bytes
+
+cdef bint is_little_endian
+from cassandra.util import is_little_endian
+
+ctypedef fused num_t:
+    int64_t
+    int32_t
+    int16_t
+    int8_t
+    uint64_t
+    uint32_t
+    uint16_t
+    uint8_t
+    double
+    float
+
+cdef inline num_t unpack_num(Buffer *buf, num_t *dummy=NULL): # dummy pointer because cython wants the fused type as an arg
+    """
+    Copy to aligned destination, conditionally swapping to native byte order
+    """
+    cdef Py_ssize_t start, end, i
+    cdef char *src = buf_read(buf, sizeof(num_t))
+    cdef num_t ret = 0
+    cdef char *out = <char*> &ret
+
+    if is_little_endian:
+        for i in range(sizeof(num_t)):
+            out[sizeof(num_t) - i - 1] = src[i]
+    else:
+        memcpy(out, src, sizeof(num_t))
+
+    return ret
+
+cdef varint_unpack(Buffer *term):
+    """Unpack a variable-sized integer"""
+    return varint_unpack_py3(to_bytes(term))
+
+# TODO: Optimize these two functions
+cdef varint_unpack_py3(bytes term):
+    val = int(''.join(["%02x" % i for i in term]), 16)
+    if (term[0] & 128) != 0:
+        shift = len(term) * 8  # * Note below
+        val -= 1 << shift
+    return val
+
+# * Note *
+# '1 << (len(term) * 8)' Cython tries to do native
+# integer shifts, which overflows. We need this to
+# emulate Python shifting, which will expand the long
+# to accommodate
diff --git a/llm/Lib/site-packages/cassandra/cython_utils.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/cython_utils.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..5655c4d42e62e3176e4cfc5813b081054e8f0361
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/cython_utils.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/cython_utils.pxd b/llm/Lib/site-packages/cassandra/cython_utils.pxd
new file mode 100644
index 0000000000000000000000000000000000000000..0c2e2b387e747f6e5e70c4bb86f01aa152b7696d
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cython_utils.pxd
@@ -0,0 +1,2 @@
+from libc.stdint cimport int64_t
+cdef datetime_from_timestamp(double timestamp)
diff --git a/llm/Lib/site-packages/cassandra/cython_utils.pyx b/llm/Lib/site-packages/cassandra/cython_utils.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..871e6c6d56fa315685eb33de03254b9d5821eded
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/cython_utils.pyx
@@ -0,0 +1,62 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Duplicate module of util.py, with some accelerated functions
+used for deserialization.
+"""
+
+from libc.math cimport modf, round, fabs
+
+from cpython.datetime cimport (
+    timedelta_new,
+        # cdef inline object timedelta_new(int days, int seconds, int useconds)
+        # Create timedelta object using DateTime CAPI factory function.
+        # Note, there are no range checks for any of the arguments.
+    import_datetime,
+        # Datetime C API initialization function.
+        # You have to call it before any usage of DateTime CAPI functions.
+    )
+
+import datetime
+import sys
+
+cdef bint is_little_endian
+from cassandra.util import is_little_endian
+
+import_datetime()
+
+DEF DAY_IN_SECONDS = 86400
+
+DATETIME_EPOC = datetime.datetime(1970, 1, 1)
+
+
+cdef datetime_from_timestamp(double timestamp):
+    cdef int days = <int> (timestamp / DAY_IN_SECONDS)
+    cdef int64_t days_in_seconds = (<int64_t> days) * DAY_IN_SECONDS
+    cdef int seconds = <int> (timestamp - days_in_seconds)
+    cdef double tmp
+    cdef double micros_left = modf(timestamp, &tmp) * 1000000.
+    micros_left = modf(micros_left, &tmp)
+    cdef int microseconds = <int> tmp
+
+    # rounding to emulate fp math in delta_new
+    cdef int x_odd
+    tmp = round(micros_left)
+    if fabs(tmp - micros_left) == 0.5:
+        x_odd = microseconds & 1
+        tmp = 2.0 * round((micros_left + x_odd) * 0.5) - x_odd
+    microseconds += <int>tmp
+
+    return DATETIME_EPOC + timedelta_new(days, seconds, microseconds)
diff --git a/llm/Lib/site-packages/cassandra/datastax/__init__.py b/llm/Lib/site-packages/cassandra/datastax/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b3d6d167181818d089d968c8a98883c59f98c074
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/__init__.py
@@ -0,0 +1,13 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/llm/Lib/site-packages/cassandra/datastax/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3e14cd6ddd5e5e4cc8d9c7e5ce24b32d8992e9a2
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/cloud/__init__.py b/llm/Lib/site-packages/cassandra/datastax/cloud/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a186251dcab1856a6337f1f1d501c94e736a7bca
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/cloud/__init__.py
@@ -0,0 +1,193 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import logging
+import json
+import sys
+import tempfile
+import shutil
+from urllib.request import urlopen
+
+_HAS_SSL = True
+try:
+    from ssl import SSLContext, PROTOCOL_TLS, CERT_REQUIRED
+except:
+    _HAS_SSL = False
+
+from zipfile import ZipFile
+
+# 2.7 vs 3.x
+try:
+    from zipfile import BadZipFile
+except:
+    from zipfile import BadZipfile as BadZipFile
+
+from cassandra import DriverException
+
+log = logging.getLogger(__name__)
+
+__all__ = ['get_cloud_config']
+
+DATASTAX_CLOUD_PRODUCT_TYPE = "DATASTAX_APOLLO"
+
+
+class CloudConfig(object):
+
+    username = None
+    password = None
+    host = None
+    port = None
+    keyspace = None
+    local_dc = None
+    ssl_context = None
+
+    sni_host = None
+    sni_port = None
+    host_ids = None
+
+    @classmethod
+    def from_dict(cls, d):
+        c = cls()
+
+        c.port = d.get('port', None)
+        try:
+            c.port = int(d['port'])
+        except:
+            pass
+
+        c.username = d.get('username', None)
+        c.password = d.get('password', None)
+        c.host = d.get('host', None)
+        c.keyspace = d.get('keyspace', None)
+        c.local_dc = d.get('localDC', None)
+
+        return c
+
+
+def get_cloud_config(cloud_config, create_pyopenssl_context=False):
+    if not _HAS_SSL:
+        raise DriverException("A Python installation with SSL is required to connect to a cloud cluster.")
+
+    if 'secure_connect_bundle' not in cloud_config:
+        raise ValueError("The cloud config doesn't have a secure_connect_bundle specified.")
+
+    try:
+        config = read_cloud_config_from_zip(cloud_config, create_pyopenssl_context)
+    except BadZipFile:
+        raise ValueError("Unable to open the zip file for the cloud config. Check your secure connect bundle.")
+
+    config = read_metadata_info(config, cloud_config)
+    if create_pyopenssl_context:
+        config.ssl_context = config.pyopenssl_context
+    return config
+
+
+def read_cloud_config_from_zip(cloud_config, create_pyopenssl_context):
+    secure_bundle = cloud_config['secure_connect_bundle']
+    use_default_tempdir = cloud_config.get('use_default_tempdir', None)
+    with ZipFile(secure_bundle) as zipfile:
+        base_dir = tempfile.gettempdir() if use_default_tempdir else os.path.dirname(secure_bundle)
+        tmp_dir = tempfile.mkdtemp(dir=base_dir)
+        try:
+            zipfile.extractall(path=tmp_dir)
+            return parse_cloud_config(os.path.join(tmp_dir, 'config.json'), cloud_config, create_pyopenssl_context)
+        finally:
+            shutil.rmtree(tmp_dir)
+
+
+def parse_cloud_config(path, cloud_config, create_pyopenssl_context):
+    with open(path, 'r') as stream:
+        data = json.load(stream)
+
+    config = CloudConfig.from_dict(data)
+    config_dir = os.path.dirname(path)
+
+    if 'ssl_context' in cloud_config:
+        config.ssl_context = cloud_config['ssl_context']
+    else:
+        # Load the ssl_context before we delete the temporary directory
+        ca_cert_location = os.path.join(config_dir, 'ca.crt')
+        cert_location = os.path.join(config_dir, 'cert')
+        key_location = os.path.join(config_dir, 'key')
+        # Regardless of if we create a pyopenssl context, we still need the builtin one
+        # to connect to the metadata service
+        config.ssl_context = _ssl_context_from_cert(ca_cert_location, cert_location, key_location)
+        if create_pyopenssl_context:
+            config.pyopenssl_context = _pyopenssl_context_from_cert(ca_cert_location, cert_location, key_location)
+
+    return config
+
+
+def read_metadata_info(config, cloud_config):
+    url = "https://{}:{}/metadata".format(config.host, config.port)
+    timeout = cloud_config['connect_timeout'] if 'connect_timeout' in cloud_config else 5
+    try:
+        response = urlopen(url, context=config.ssl_context, timeout=timeout)
+    except Exception as e:
+        log.exception(e)
+        raise DriverException("Unable to connect to the metadata service at %s. "
+                              "Check the cluster status in the cloud console. " % url)
+
+    if response.code != 200:
+        raise DriverException(("Error while fetching the metadata at: %s. "
+                               "The service returned error code %d." % (url, response.code)))
+    return parse_metadata_info(config, response.read().decode('utf-8'))
+
+
+def parse_metadata_info(config, http_data):
+    try:
+        data = json.loads(http_data)
+    except:
+        msg = "Failed to load cluster metadata"
+        raise DriverException(msg)
+
+    contact_info = data['contact_info']
+    config.local_dc = contact_info['local_dc']
+
+    proxy_info = contact_info['sni_proxy_address'].split(':')
+    config.sni_host = proxy_info[0]
+    try:
+        config.sni_port = int(proxy_info[1])
+    except:
+        config.sni_port = 9042
+
+    config.host_ids = [host_id for host_id in contact_info['contact_points']]
+
+    return config
+
+
+def _ssl_context_from_cert(ca_cert_location, cert_location, key_location):
+    ssl_context = SSLContext(PROTOCOL_TLS)
+    ssl_context.load_verify_locations(ca_cert_location)
+    ssl_context.verify_mode = CERT_REQUIRED
+    ssl_context.load_cert_chain(certfile=cert_location, keyfile=key_location)
+
+    return ssl_context
+
+
+def _pyopenssl_context_from_cert(ca_cert_location, cert_location, key_location):
+    try:
+        from OpenSSL import SSL
+    except ImportError as e:
+        raise ImportError(
+            "PyOpenSSL must be installed to connect to Astra with the Eventlet or Twisted event loops")\
+            .with_traceback(e.__traceback__)
+    ssl_context = SSL.Context(SSL.TLSv1_METHOD)
+    ssl_context.set_verify(SSL.VERIFY_PEER, callback=lambda _1, _2, _3, _4, ok: ok)
+    ssl_context.use_certificate_file(cert_location)
+    ssl_context.use_privatekey_file(key_location)
+    ssl_context.load_verify_locations(ca_cert_location)
+
+    return ssl_context
\ No newline at end of file
diff --git a/llm/Lib/site-packages/cassandra/datastax/cloud/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/cloud/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..638a37e34b888df42cc3da2bdc27f375d580b128
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/cloud/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/__init__.py b/llm/Lib/site-packages/cassandra/datastax/graph/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..28ceb98a84ac50d1dd353dd8d1d45e7d0db80f22
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/graph/__init__.py
@@ -0,0 +1,23 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from cassandra.datastax.graph.types import Element, Vertex, VertexProperty, Edge, Path, T
+from cassandra.datastax.graph.query import (
+    GraphOptions, GraphProtocol, GraphStatement, SimpleGraphStatement, Result,
+    graph_object_row_factory, single_object_row_factory,
+    graph_result_row_factory, graph_graphson2_row_factory,
+    graph_graphson3_row_factory
+)
+from cassandra.datastax.graph.graphson import *
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/graph/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..79a5186051ae3545e757a13f7c46443294db8287
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/graph/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/__pycache__/graphson.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/graph/__pycache__/graphson.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4af79a0ed11afa4ac356fd32fc0cbcd66a88ebe0
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/graph/__pycache__/graphson.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/__pycache__/query.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/graph/__pycache__/query.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e10de56440d30ca14613443f4e5cb9a9a20e5337
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/graph/__pycache__/query.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/__pycache__/types.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/graph/__pycache__/types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1b25ca79c12a274fe00cacfa0d5a7bd9d1ad36f7
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/graph/__pycache__/types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__init__.py b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d16254a675910b0f3648be09c8a0dbf6b15873bf
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__init__.py
@@ -0,0 +1,303 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import copy
+
+from concurrent.futures import Future
+
+HAVE_GREMLIN = False
+try:
+    import gremlin_python
+    HAVE_GREMLIN = True
+except ImportError:
+    # gremlinpython is not installed.
+    pass
+
+if HAVE_GREMLIN:
+    from gremlin_python.structure.graph import Graph
+    from gremlin_python.driver.remote_connection import RemoteConnection, RemoteTraversal
+    from gremlin_python.process.traversal import Traverser, TraversalSideEffects
+    from gremlin_python.process.graph_traversal import GraphTraversal
+
+    from cassandra.cluster import Session, GraphExecutionProfile, EXEC_PROFILE_GRAPH_DEFAULT
+    from cassandra.datastax.graph import GraphOptions, GraphProtocol
+    from cassandra.datastax.graph.query import _GraphSONContextRowFactory
+
+    from cassandra.datastax.graph.fluent.serializers import (
+        GremlinGraphSONReaderV2,
+        GremlinGraphSONReaderV3,
+        dse_graphson2_deserializers,
+        gremlin_graphson2_deserializers,
+        dse_graphson3_deserializers,
+        gremlin_graphson3_deserializers
+    )
+    from cassandra.datastax.graph.fluent.query import _DefaultTraversalBatch, _query_from_traversal
+
+    log = logging.getLogger(__name__)
+
+    __all__ = ['BaseGraphRowFactory', 'graph_traversal_row_factory',
+               'graph_traversal_dse_object_row_factory', 'DSESessionRemoteGraphConnection', 'DseGraph']
+
+    # Traversal result keys
+    _bulk_key = 'bulk'
+    _result_key = 'result'
+
+
+    class BaseGraphRowFactory(_GraphSONContextRowFactory):
+        """
+        Base row factory for graph traversal. This class basically wraps a
+        graphson reader function to handle additional features of Gremlin/DSE
+        and is callable as a normal row factory.
+
+        Currently supported:
+          - bulk results
+        """
+
+        def __call__(self, column_names, rows):
+            for row in rows:
+                parsed_row = self.graphson_reader.readObject(row[0])
+                yield parsed_row[_result_key]
+                bulk = parsed_row.get(_bulk_key, 1)
+                for _ in range(bulk - 1):
+                    yield copy.deepcopy(parsed_row[_result_key])
+
+
+    class _GremlinGraphSON2RowFactory(BaseGraphRowFactory):
+        """Row Factory that returns the decoded graphson2."""
+        graphson_reader_class = GremlinGraphSONReaderV2
+        graphson_reader_kwargs = {'deserializer_map': gremlin_graphson2_deserializers}
+
+
+    class _DseGraphSON2RowFactory(BaseGraphRowFactory):
+        """Row Factory that returns the decoded graphson2 as DSE types."""
+        graphson_reader_class = GremlinGraphSONReaderV2
+        graphson_reader_kwargs = {'deserializer_map': dse_graphson2_deserializers}
+
+    gremlin_graphson2_traversal_row_factory = _GremlinGraphSON2RowFactory
+    # TODO remove in next major
+    graph_traversal_row_factory = gremlin_graphson2_traversal_row_factory
+
+    dse_graphson2_traversal_row_factory = _DseGraphSON2RowFactory
+    # TODO remove in next major
+    graph_traversal_dse_object_row_factory = dse_graphson2_traversal_row_factory
+
+
+    class _GremlinGraphSON3RowFactory(BaseGraphRowFactory):
+        """Row Factory that returns the decoded graphson2."""
+        graphson_reader_class = GremlinGraphSONReaderV3
+        graphson_reader_kwargs = {'deserializer_map': gremlin_graphson3_deserializers}
+
+
+    class _DseGraphSON3RowFactory(BaseGraphRowFactory):
+        """Row Factory that returns the decoded graphson3 as DSE types."""
+        graphson_reader_class = GremlinGraphSONReaderV3
+        graphson_reader_kwargs = {'deserializer_map': dse_graphson3_deserializers}
+
+
+    gremlin_graphson3_traversal_row_factory = _GremlinGraphSON3RowFactory
+    dse_graphson3_traversal_row_factory = _DseGraphSON3RowFactory
+
+
+    class DSESessionRemoteGraphConnection(RemoteConnection):
+        """
+        A Tinkerpop RemoteConnection to execute traversal queries on DSE.
+
+        :param session: A DSE session
+        :param graph_name: (Optional) DSE Graph name.
+        :param execution_profile: (Optional) Execution profile for traversal queries. Default is set to `EXEC_PROFILE_GRAPH_DEFAULT`.
+        """
+
+        session = None
+        graph_name = None
+        execution_profile = None
+
+        def __init__(self, session, graph_name=None, execution_profile=EXEC_PROFILE_GRAPH_DEFAULT):
+            super(DSESessionRemoteGraphConnection, self).__init__(None, None)
+
+            if not isinstance(session, Session):
+                raise ValueError('A DSE Session must be provided to execute graph traversal queries.')
+
+            self.session = session
+            self.graph_name = graph_name
+            self.execution_profile = execution_profile
+
+        @staticmethod
+        def _traversers_generator(traversers):
+            for t in traversers:
+                yield Traverser(t)
+
+        def _prepare_query(self, bytecode):
+            ep = self.session.execution_profile_clone_update(self.execution_profile)
+            graph_options = ep.graph_options
+            graph_options.graph_name = self.graph_name or graph_options.graph_name
+            graph_options.graph_language = DseGraph.DSE_GRAPH_QUERY_LANGUAGE
+            # We resolve the execution profile options here , to know how what gremlin factory to set
+            self.session._resolve_execution_profile_options(ep)
+
+            context = None
+            if graph_options.graph_protocol == GraphProtocol.GRAPHSON_2_0:
+                row_factory = gremlin_graphson2_traversal_row_factory
+            elif graph_options.graph_protocol == GraphProtocol.GRAPHSON_3_0:
+                row_factory = gremlin_graphson3_traversal_row_factory
+                context = {
+                    'cluster': self.session.cluster,
+                    'graph_name': graph_options.graph_name.decode('utf-8')
+                }
+            else:
+                raise ValueError('Unknown graph protocol: {}'.format(graph_options.graph_protocol))
+
+            ep.row_factory = row_factory
+            query = DseGraph.query_from_traversal(bytecode, graph_options.graph_protocol, context)
+
+            return query, ep
+
+        @staticmethod
+        def _handle_query_results(result_set, gremlin_future):
+            try:
+                gremlin_future.set_result(
+                    RemoteTraversal(DSESessionRemoteGraphConnection._traversers_generator(result_set), TraversalSideEffects())
+                )
+            except Exception as e:
+                gremlin_future.set_exception(e)
+
+        @staticmethod
+        def _handle_query_error(response, gremlin_future):
+            gremlin_future.set_exception(response)
+
+        def submit(self, bytecode):
+            # the only reason I don't use submitAsync here
+            # is to avoid an unuseful future wrap
+            query, ep = self._prepare_query(bytecode)
+
+            traversers = self.session.execute_graph(query, execution_profile=ep)
+            return RemoteTraversal(self._traversers_generator(traversers), TraversalSideEffects())
+
+        def submitAsync(self, bytecode):
+            query, ep = self._prepare_query(bytecode)
+
+            # to be compatible with gremlinpython, we need to return a concurrent.futures.Future
+            gremlin_future = Future()
+            response_future = self.session.execute_graph_async(query, execution_profile=ep)
+            response_future.add_callback(self._handle_query_results, gremlin_future)
+            response_future.add_errback(self._handle_query_error, gremlin_future)
+
+            return gremlin_future
+
+        def __str__(self):
+            return "<DSESessionRemoteGraphConnection: graph_name='{0}'>".format(self.graph_name)
+
+        __repr__ = __str__
+
+
+    class DseGraph(object):
+        """
+        Dse Graph utility class for GraphTraversal construction and execution.
+        """
+
+        DSE_GRAPH_QUERY_LANGUAGE = 'bytecode-json'
+        """
+        Graph query language, Default is 'bytecode-json' (GraphSON).
+        """
+
+        DSE_GRAPH_QUERY_PROTOCOL = GraphProtocol.GRAPHSON_2_0
+        """
+        Graph query language, Default is GraphProtocol.GRAPHSON_2_0.
+        """
+
+        @staticmethod
+        def query_from_traversal(traversal, graph_protocol=DSE_GRAPH_QUERY_PROTOCOL, context=None):
+            """
+            From a GraphTraversal, return a query string based on the language specified in `DseGraph.DSE_GRAPH_QUERY_LANGUAGE`.
+
+            :param traversal: The GraphTraversal object
+            :param graph_protocol: The graph protocol. Default is `DseGraph.DSE_GRAPH_QUERY_PROTOCOL`.
+            :param context: The dict of the serialization context, needed for GraphSON3 (tuple, udt).
+                            e.g: {'cluster': cluster, 'graph_name': name}
+            """
+
+            if isinstance(traversal, GraphTraversal):
+                for strategy in traversal.traversal_strategies.traversal_strategies:
+                    rc = strategy.remote_connection
+                    if (isinstance(rc, DSESessionRemoteGraphConnection) and
+                            rc.session or rc.graph_name or rc.execution_profile):
+                        log.warning("GraphTraversal session, graph_name and execution_profile are "
+                                    "only taken into account when executed with TinkerPop.")
+
+            return _query_from_traversal(traversal, graph_protocol, context)
+
+        @staticmethod
+        def traversal_source(session=None, graph_name=None, execution_profile=EXEC_PROFILE_GRAPH_DEFAULT,
+                             traversal_class=None):
+            """
+            Returns a TinkerPop GraphTraversalSource binded to the session and graph_name if provided.
+
+            :param session: (Optional) A DSE session
+            :param graph_name: (Optional) DSE Graph name
+            :param execution_profile: (Optional) Execution profile for traversal queries. Default is set to `EXEC_PROFILE_GRAPH_DEFAULT`.
+            :param traversal_class: (Optional) The GraphTraversalSource class to use (DSL).
+
+            .. code-block:: python
+
+                from cassandra.cluster import Cluster
+                from cassandra.datastax.graph.fluent import DseGraph
+
+                c = Cluster()
+                session = c.connect()
+
+                g = DseGraph.traversal_source(session, 'my_graph')
+                print(g.V().valueMap().toList())
+
+            """
+
+            graph = Graph()
+            traversal_source = graph.traversal(traversal_class)
+
+            if session:
+                traversal_source = traversal_source.withRemote(
+                    DSESessionRemoteGraphConnection(session, graph_name, execution_profile))
+
+            return traversal_source
+
+        @staticmethod
+        def create_execution_profile(graph_name, graph_protocol=DSE_GRAPH_QUERY_PROTOCOL, **kwargs):
+            """
+            Creates an ExecutionProfile for GraphTraversal execution. You need to register that execution profile to the
+            cluster by using `cluster.add_execution_profile`.
+
+            :param graph_name: The graph name
+            :param graph_protocol: (Optional) The graph protocol, default is `DSE_GRAPH_QUERY_PROTOCOL`.
+            """
+
+            if graph_protocol == GraphProtocol.GRAPHSON_2_0:
+                row_factory = dse_graphson2_traversal_row_factory
+            elif graph_protocol == GraphProtocol.GRAPHSON_3_0:
+                row_factory = dse_graphson3_traversal_row_factory
+            else:
+                raise ValueError('Unknown graph protocol: {}'.format(graph_protocol))
+
+            ep = GraphExecutionProfile(row_factory=row_factory,
+                                       graph_options=GraphOptions(graph_name=graph_name,
+                                                                  graph_language=DseGraph.DSE_GRAPH_QUERY_LANGUAGE,
+                                                                  graph_protocol=graph_protocol),
+                                       **kwargs)
+            return ep
+
+        @staticmethod
+        def batch(*args, **kwargs):
+            """
+            Returns the :class:`cassandra.datastax.graph.fluent.query.TraversalBatch` object allowing to
+            execute multiple traversals in the same transaction.
+            """
+            return _DefaultTraversalBatch(*args, **kwargs)
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..63a049fc2f2f0f608438845a2b0afcd6a7d1b4c9
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/_predicates.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/_predicates.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..03f9bbf2c980d817f377c5dc4bc7dbf76387ce02
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/_predicates.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/_query.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/_query.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ff612401764ea7a7377ecc09ad2152bc813a757d
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/_query.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/_serializers.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/_serializers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..401e2c9232d287783f3a6421f05ce0c7d906807c
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/_serializers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/predicates.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/predicates.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7c0ae1104b8c04656381ab75dfe8aedd67337197
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/predicates.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/query.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/query.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3d0c8dafcb0ea029afa3b15adc44b077948bee0e
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/query.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/serializers.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/serializers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7a5fe852b3c0b18b23fc9c668c74b711a57ed052
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/__pycache__/serializers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/_predicates.py b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/_predicates.py
new file mode 100644
index 0000000000000000000000000000000000000000..871c188dc0840ef901f331257de79856dafc213a
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/_predicates.py
@@ -0,0 +1,202 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import math
+
+from gremlin_python.process.traversal import P
+
+from cassandra.util import Distance
+
+__all__ = ['GeoP', 'TextDistanceP', 'Search', 'GeoUnit', 'Geo', 'CqlCollection']
+
+
+class GeoP(object):
+
+    def __init__(self, operator, value, other=None):
+        self.operator = operator
+        self.value = value
+        self.other = other
+
+    @staticmethod
+    def inside(*args, **kwargs):
+        return GeoP("inside", *args, **kwargs)
+
+    def __eq__(self, other):
+        return isinstance(other,
+                          self.__class__) and self.operator == other.operator and self.value == other.value and self.other == other.other
+
+    def __repr__(self):
+        return self.operator + "(" + str(self.value) + ")" if self.other is None else self.operator + "(" + str(
+            self.value) + "," + str(self.other) + ")"
+
+
+class TextDistanceP(object):
+
+    def __init__(self, operator, value, distance):
+        self.operator = operator
+        self.value = value
+        self.distance = distance
+
+    @staticmethod
+    def fuzzy(*args):
+        return TextDistanceP("fuzzy", *args)
+
+    @staticmethod
+    def token_fuzzy(*args):
+        return TextDistanceP("tokenFuzzy", *args)
+
+    @staticmethod
+    def phrase(*args):
+        return TextDistanceP("phrase", *args)
+
+    def __eq__(self, other):
+        return isinstance(other,
+                          self.__class__) and self.operator == other.operator and self.value == other.value and self.distance == other.distance
+
+    def __repr__(self):
+        return self.operator + "(" + str(self.value) + "," + str(self.distance) + ")"
+
+
+class Search(object):
+
+    @staticmethod
+    def token(value):
+        """
+        Search any instance of a certain token within the text property targeted.
+        :param value: the value to look for.
+        """
+        return P('token', value)
+
+    @staticmethod
+    def token_prefix(value):
+        """
+        Search any instance of a certain token prefix withing the text property targeted.
+        :param value: the value to look for.
+        """
+        return P('tokenPrefix', value)
+
+    @staticmethod
+    def token_regex(value):
+        """
+        Search any instance of the provided regular expression for the targeted property.
+        :param value: the value to look for.
+        """
+        return P('tokenRegex', value)
+
+    @staticmethod
+    def prefix(value):
+        """
+        Search for a specific prefix at the beginning of the text property targeted.
+        :param value: the value to look for.
+        """
+        return P('prefix', value)
+
+    @staticmethod
+    def regex(value):
+        """
+        Search for this regular expression inside the text property targeted.
+        :param value: the value to look for.
+        """
+        return P('regex', value)
+
+    @staticmethod
+    def fuzzy(value, distance):
+        """
+        Search for a fuzzy string inside the text property targeted.
+        :param value: the value to look for.
+        :param distance: The distance for the fuzzy search. ie. 1, to allow a one-letter misspellings.
+        """
+        return TextDistanceP.fuzzy(value, distance)
+
+    @staticmethod
+    def token_fuzzy(value, distance):
+        """
+        Search for a token fuzzy inside the text property targeted.
+        :param value: the value to look for.
+        :param distance: The distance for the token fuzzy search. ie. 1, to allow a one-letter misspellings.
+        """
+        return TextDistanceP.token_fuzzy(value, distance)
+
+    @staticmethod
+    def phrase(value, proximity):
+        """
+        Search for a phrase inside the text property targeted.
+        :param value: the value to look for.
+        :param proximity: The proximity for the phrase search. ie. phrase('David Felcey', 2).. to find 'David Felcey' with up to two middle names.
+        """
+        return TextDistanceP.phrase(value, proximity)
+
+
+class CqlCollection(object):
+
+    @staticmethod
+    def contains(value):
+        """
+        Search for a value inside a cql list/set column.
+        :param value: the value to look for.
+        """
+        return P('contains', value)
+
+    @staticmethod
+    def contains_value(value):
+        """
+        Search for a map value.
+        :param value: the value to look for.
+        """
+        return P('containsValue', value)
+
+    @staticmethod
+    def contains_key(value):
+        """
+        Search for a map key.
+        :param value: the value to look for.
+        """
+        return P('containsKey', value)
+
+    @staticmethod
+    def entry_eq(value):
+        """
+        Search for a map entry.
+        :param value: the value to look for.
+        """
+        return P('entryEq', value)
+
+
+class GeoUnit(object):
+    _EARTH_MEAN_RADIUS_KM = 6371.0087714
+    _DEGREES_TO_RADIANS = math.pi / 180
+    _DEG_TO_KM = _DEGREES_TO_RADIANS * _EARTH_MEAN_RADIUS_KM
+    _KM_TO_DEG = 1 / _DEG_TO_KM
+    _MILES_TO_KM = 1.609344001
+
+    MILES = _MILES_TO_KM * _KM_TO_DEG
+    KILOMETERS = _KM_TO_DEG
+    METERS = _KM_TO_DEG / 1000.0
+    DEGREES = 1
+
+
+class Geo(object):
+
+    @staticmethod
+    def inside(value, units=GeoUnit.DEGREES):
+        """
+        Search any instance of geometry inside the Distance targeted.
+        :param value: A Distance to look for.
+        :param units: The units for ``value``. See GeoUnit enum. (Can also
+            provide an integer to use as a multiplier to convert ``value`` to
+            degrees.)
+        """
+        return GeoP.inside(
+            value=Distance(x=value.x, y=value.y, radius=value.radius * units)
+        )
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/_query.py b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/_query.py
new file mode 100644
index 0000000000000000000000000000000000000000..14d65ddac5318d02c82a48156a3cebcbe908cae4
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/_query.py
@@ -0,0 +1,228 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+
+from cassandra.graph import SimpleGraphStatement, GraphProtocol
+from cassandra.cluster import EXEC_PROFILE_GRAPH_DEFAULT
+
+from gremlin_python.process.graph_traversal import GraphTraversal
+from gremlin_python.structure.io.graphsonV2d0 import GraphSONWriter as GraphSONWriterV2
+from gremlin_python.structure.io.graphsonV3d0 import GraphSONWriter as GraphSONWriterV3
+
+from cassandra.datastax.graph.fluent.serializers import GremlinUserTypeIO, \
+    dse_graphson2_serializers, dse_graphson3_serializers
+
+log = logging.getLogger(__name__)
+
+
+__all__ = ['TraversalBatch', '_query_from_traversal', '_DefaultTraversalBatch']
+
+
+class _GremlinGraphSONWriterAdapter(object):
+
+    def __init__(self, context, **kwargs):
+        super(_GremlinGraphSONWriterAdapter, self).__init__(**kwargs)
+        self.context = context
+        self.user_types = None
+
+    def serialize(self, value, _):
+        return self.toDict(value)
+
+    def get_serializer(self, value):
+        serializer = None
+        try:
+            serializer = self.serializers[type(value)]
+        except KeyError:
+            for key, ser in self.serializers.items():
+                if isinstance(value, key):
+                    serializer = ser
+
+        if self.context:
+            # Check if UDT
+            if self.user_types is None:
+                try:
+                    user_types = self.context['cluster']._user_types[self.context['graph_name']]
+                    self.user_types = dict(map(reversed, user_types.items()))
+                except KeyError:
+                    self.user_types = {}
+
+            # Custom detection to map a namedtuple to udt
+            if (tuple in self.serializers and serializer is self.serializers[tuple] and hasattr(value, '_fields') or
+                (not serializer and type(value) in self.user_types)):
+                serializer = GremlinUserTypeIO
+
+        if serializer:
+            try:
+                # A serializer can have specialized serializers (e.g for Int32 and Int64, so value dependant)
+                serializer = serializer.get_specialized_serializer(value)
+            except AttributeError:
+                pass
+
+        return serializer
+
+    def toDict(self, obj):
+        serializer = self.get_serializer(obj)
+        return serializer.dictify(obj, self) if serializer else obj
+
+    def definition(self, value):
+        serializer = self.get_serializer(value)
+        return serializer.definition(value, self)
+
+
+class GremlinGraphSON2Writer(_GremlinGraphSONWriterAdapter, GraphSONWriterV2):
+    pass
+
+
+class GremlinGraphSON3Writer(_GremlinGraphSONWriterAdapter, GraphSONWriterV3):
+    pass
+
+
+graphson2_writer = GremlinGraphSON2Writer
+graphson3_writer = GremlinGraphSON3Writer
+
+
+def _query_from_traversal(traversal, graph_protocol, context=None):
+    """
+    From a GraphTraversal, return a query string.
+
+    :param traversal: The GraphTraversal object
+    :param graphson_protocol: The graph protocol to determine the output format.
+    """
+    if graph_protocol == GraphProtocol.GRAPHSON_2_0:
+        graphson_writer = graphson2_writer(context, serializer_map=dse_graphson2_serializers)
+    elif graph_protocol == GraphProtocol.GRAPHSON_3_0:
+        if context is None:
+            raise ValueError('Missing context for GraphSON3 serialization requires.')
+        graphson_writer = graphson3_writer(context, serializer_map=dse_graphson3_serializers)
+    else:
+        raise ValueError('Unknown graph protocol: {}'.format(graph_protocol))
+
+    try:
+        query = graphson_writer.writeObject(traversal)
+    except Exception:
+        log.exception("Error preparing graphson traversal query:")
+        raise
+
+    return query
+
+
+class TraversalBatch(object):
+    """
+    A `TraversalBatch` is used to execute multiple graph traversals in a
+    single transaction. If any traversal in the batch fails, the entire
+    batch will fail to apply.
+
+    If a TraversalBatch is bounded to a DSE session, it can be executed using
+    `traversal_batch.execute()`.
+    """
+
+    _session = None
+    _execution_profile = None
+
+    def __init__(self, session=None, execution_profile=None):
+        """
+        :param session: (Optional) A DSE session
+        :param execution_profile: (Optional) The execution profile to use for the batch execution
+        """
+        self._session = session
+        self._execution_profile = execution_profile
+
+    def add(self, traversal):
+        """
+        Add a traversal to the batch.
+
+        :param traversal: A gremlin GraphTraversal
+        """
+        raise NotImplementedError()
+
+    def add_all(self, traversals):
+        """
+        Adds a sequence of traversals to the batch.
+
+        :param traversals: A sequence of gremlin GraphTraversal
+        """
+        raise NotImplementedError()
+
+    def execute(self):
+        """
+        Execute the traversal batch if bounded to a `DSE Session`.
+        """
+        raise NotImplementedError()
+
+    def as_graph_statement(self, graph_protocol=GraphProtocol.GRAPHSON_2_0):
+        """
+        Return the traversal batch as GraphStatement.
+
+        :param graph_protocol: The graph protocol for the GraphSONWriter. Default is GraphProtocol.GRAPHSON_2_0.
+        """
+        raise NotImplementedError()
+
+    def clear(self):
+        """
+        Clear a traversal batch for reuse.
+        """
+        raise NotImplementedError()
+
+    def __len__(self):
+        raise NotImplementedError()
+
+    def __str__(self):
+        return u'<TraversalBatch traversals={0}>'.format(len(self))
+    __repr__ = __str__
+
+
+class _DefaultTraversalBatch(TraversalBatch):
+
+    _traversals = None
+
+    def __init__(self, *args, **kwargs):
+        super(_DefaultTraversalBatch, self).__init__(*args, **kwargs)
+        self._traversals = []
+
+    def add(self, traversal):
+        if not isinstance(traversal, GraphTraversal):
+            raise ValueError('traversal should be a gremlin GraphTraversal')
+
+        self._traversals.append(traversal)
+        return self
+
+    def add_all(self, traversals):
+        for traversal in traversals:
+            self.add(traversal)
+
+    def as_graph_statement(self, graph_protocol=GraphProtocol.GRAPHSON_2_0, context=None):
+        statements = [_query_from_traversal(t, graph_protocol, context) for t in self._traversals]
+        query = u"[{0}]".format(','.join(statements))
+        return SimpleGraphStatement(query)
+
+    def execute(self):
+        if self._session is None:
+            raise ValueError('A DSE Session must be provided to execute the traversal batch.')
+
+        execution_profile = self._execution_profile if self._execution_profile else EXEC_PROFILE_GRAPH_DEFAULT
+        graph_options = self._session.get_execution_profile(execution_profile).graph_options
+        context = {
+            'cluster': self._session.cluster,
+            'graph_name': graph_options.graph_name
+        }
+        statement = self.as_graph_statement(graph_options.graph_protocol, context=context) \
+            if graph_options.graph_protocol else self.as_graph_statement(context=context)
+        return self._session.execute_graph(statement, execution_profile=execution_profile)
+
+    def clear(self):
+        del self._traversals[:]
+
+    def __len__(self):
+        return len(self._traversals)
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/_serializers.py b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/_serializers.py
new file mode 100644
index 0000000000000000000000000000000000000000..05cb176a72c2e101a987863a071acee8d71a9645
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/_serializers.py
@@ -0,0 +1,260 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from collections import OrderedDict
+
+from gremlin_python.structure.io.graphsonV2d0 import (
+    GraphSONReader as GraphSONReaderV2,
+    GraphSONUtil as GraphSONUtil,  # no difference between v2 and v3
+    VertexDeserializer as VertexDeserializerV2,
+    VertexPropertyDeserializer as VertexPropertyDeserializerV2,
+    PropertyDeserializer as PropertyDeserializerV2,
+    EdgeDeserializer as EdgeDeserializerV2,
+    PathDeserializer as PathDeserializerV2
+)
+
+from gremlin_python.structure.io.graphsonV3d0 import (
+    GraphSONReader as GraphSONReaderV3,
+    VertexDeserializer as VertexDeserializerV3,
+    VertexPropertyDeserializer as VertexPropertyDeserializerV3,
+    PropertyDeserializer as PropertyDeserializerV3,
+    EdgeDeserializer as EdgeDeserializerV3,
+    PathDeserializer as PathDeserializerV3
+)
+
+try:
+    from gremlin_python.structure.io.graphsonV2d0 import (
+        TraversalMetricsDeserializer as TraversalMetricsDeserializerV2,
+        MetricsDeserializer as MetricsDeserializerV2
+    )
+    from gremlin_python.structure.io.graphsonV3d0 import (
+        TraversalMetricsDeserializer as TraversalMetricsDeserializerV3,
+        MetricsDeserializer as MetricsDeserializerV3
+    )
+except ImportError:
+    TraversalMetricsDeserializerV2 = MetricsDeserializerV2 = None
+    TraversalMetricsDeserializerV3 = MetricsDeserializerV3 = None
+
+from cassandra.graph import (
+    GraphSON2Serializer,
+    GraphSON2Deserializer,
+    GraphSON3Serializer,
+    GraphSON3Deserializer
+)
+from cassandra.graph.graphson import UserTypeIO, TypeWrapperTypeIO
+from cassandra.datastax.graph.fluent.predicates import GeoP, TextDistanceP
+from cassandra.util import Distance
+
+
+__all__ = ['GremlinGraphSONReader', 'GeoPSerializer', 'TextDistancePSerializer',
+           'DistanceIO', 'gremlin_deserializers', 'deserializers', 'serializers',
+           'GremlinGraphSONReaderV2', 'GremlinGraphSONReaderV3', 'dse_graphson2_serializers',
+           'dse_graphson2_deserializers', 'dse_graphson3_serializers', 'dse_graphson3_deserializers',
+           'gremlin_graphson2_deserializers', 'gremlin_graphson3_deserializers', 'GremlinUserTypeIO']
+
+
+class _GremlinGraphSONTypeSerializer(object):
+    TYPE_KEY = "@type"
+    VALUE_KEY = "@value"
+    serializer = None
+
+    def __init__(self, serializer):
+        self.serializer = serializer
+
+    def dictify(self, v, writer):
+        value = self.serializer.serialize(v, writer)
+        if self.serializer is TypeWrapperTypeIO:
+            graphson_base_type = v.type_io.graphson_base_type
+            graphson_type = v.type_io.graphson_type
+        else:
+            graphson_base_type = self.serializer.graphson_base_type
+            graphson_type = self.serializer.graphson_type
+
+        if graphson_base_type is None:
+            out = value
+        else:
+            out = {self.TYPE_KEY: graphson_type}
+            if value is not None:
+                out[self.VALUE_KEY] = value
+
+        return out
+
+    def definition(self, value, writer=None):
+        return self.serializer.definition(value, writer)
+
+    def get_specialized_serializer(self, value):
+        ser = self.serializer.get_specialized_serializer(value)
+        if ser is not self.serializer:
+            return _GremlinGraphSONTypeSerializer(ser)
+        return self
+
+
+class _GremlinGraphSONTypeDeserializer(object):
+
+    deserializer = None
+
+    def __init__(self, deserializer):
+        self.deserializer = deserializer
+
+    def objectify(self, v, reader):
+        return self.deserializer.deserialize(v, reader)
+
+
+def _make_gremlin_graphson2_deserializer(graphson_type):
+    return _GremlinGraphSONTypeDeserializer(
+        GraphSON2Deserializer.get_deserializer(graphson_type.graphson_type)
+    )
+
+
+def _make_gremlin_graphson3_deserializer(graphson_type):
+    return _GremlinGraphSONTypeDeserializer(
+        GraphSON3Deserializer.get_deserializer(graphson_type.graphson_type)
+    )
+
+
+class _GremlinGraphSONReader(object):
+    """Gremlin GraphSONReader Adapter, required to use gremlin types"""
+
+    context = None
+
+    def __init__(self, context, deserializer_map=None):
+        self.context = context
+        super(_GremlinGraphSONReader, self).__init__(deserializer_map)
+
+    def deserialize(self, obj):
+        return self.toObject(obj)
+
+
+class GremlinGraphSONReaderV2(_GremlinGraphSONReader, GraphSONReaderV2):
+    pass
+
+# TODO remove next major
+GremlinGraphSONReader = GremlinGraphSONReaderV2
+
+class GremlinGraphSONReaderV3(_GremlinGraphSONReader, GraphSONReaderV3):
+    pass
+
+
+class GeoPSerializer(object):
+    @classmethod
+    def dictify(cls, p, writer):
+        out = {
+            "predicateType": "Geo",
+            "predicate": p.operator,
+            "value": [writer.toDict(p.value), writer.toDict(p.other)] if p.other is not None else writer.toDict(p.value)
+        }
+        return GraphSONUtil.typedValue("P", out, prefix='dse')
+
+
+class TextDistancePSerializer(object):
+    @classmethod
+    def dictify(cls, p, writer):
+        out = {
+            "predicate": p.operator,
+            "value": {
+                'query': writer.toDict(p.value),
+                'distance': writer.toDict(p.distance)
+            }
+        }
+        return GraphSONUtil.typedValue("P", out)
+
+
+class DistanceIO(object):
+    @classmethod
+    def dictify(cls, v, _):
+        return GraphSONUtil.typedValue('Distance', str(v), prefix='dse')
+
+
+GremlinUserTypeIO = _GremlinGraphSONTypeSerializer(UserTypeIO)
+
+# GraphSON2
+dse_graphson2_serializers = OrderedDict([
+    (t, _GremlinGraphSONTypeSerializer(s))
+    for t, s in GraphSON2Serializer.get_type_definitions().items()
+])
+
+dse_graphson2_serializers.update(OrderedDict([
+    (Distance, DistanceIO),
+    (GeoP, GeoPSerializer),
+    (TextDistanceP, TextDistancePSerializer)
+]))
+
+# TODO remove next major, this is just in case someone was using it
+serializers = dse_graphson2_serializers
+
+dse_graphson2_deserializers = {
+    k: _make_gremlin_graphson2_deserializer(v)
+    for k, v in GraphSON2Deserializer.get_type_definitions().items()
+}
+
+dse_graphson2_deserializers.update({
+    "dse:Distance": DistanceIO,
+})
+
+# TODO remove next major, this is just in case someone was using it
+deserializers = dse_graphson2_deserializers
+
+gremlin_graphson2_deserializers = dse_graphson2_deserializers.copy()
+gremlin_graphson2_deserializers.update({
+    'g:Vertex': VertexDeserializerV2,
+    'g:VertexProperty': VertexPropertyDeserializerV2,
+    'g:Edge': EdgeDeserializerV2,
+    'g:Property': PropertyDeserializerV2,
+    'g:Path': PathDeserializerV2
+})
+
+if TraversalMetricsDeserializerV2:
+    gremlin_graphson2_deserializers.update({
+        'g:TraversalMetrics': TraversalMetricsDeserializerV2,
+        'g:lMetrics': MetricsDeserializerV2
+    })
+
+# TODO remove next major, this is just in case someone was using it
+gremlin_deserializers = gremlin_graphson2_deserializers
+
+# GraphSON3
+dse_graphson3_serializers = OrderedDict([
+    (t, _GremlinGraphSONTypeSerializer(s))
+    for t, s in GraphSON3Serializer.get_type_definitions().items()
+])
+
+dse_graphson3_serializers.update(OrderedDict([
+    (Distance, DistanceIO),
+    (GeoP, GeoPSerializer),
+    (TextDistanceP, TextDistancePSerializer)
+]))
+
+dse_graphson3_deserializers = {
+    k: _make_gremlin_graphson3_deserializer(v)
+    for k, v in GraphSON3Deserializer.get_type_definitions().items()
+}
+
+dse_graphson3_deserializers.update({
+    "dse:Distance": DistanceIO
+})
+
+gremlin_graphson3_deserializers = dse_graphson3_deserializers.copy()
+gremlin_graphson3_deserializers.update({
+    'g:Vertex': VertexDeserializerV3,
+    'g:VertexProperty': VertexPropertyDeserializerV3,
+    'g:Edge': EdgeDeserializerV3,
+    'g:Property': PropertyDeserializerV3,
+    'g:Path': PathDeserializerV3
+})
+
+if TraversalMetricsDeserializerV3:
+    gremlin_graphson3_deserializers.update({
+        'g:TraversalMetrics': TraversalMetricsDeserializerV3,
+        'g:Metrics': MetricsDeserializerV3
+    })
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/predicates.py b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/predicates.py
new file mode 100644
index 0000000000000000000000000000000000000000..0277822dc5fb7086e0a71d423e8dfd6de4436c69
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/predicates.py
@@ -0,0 +1,20 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import gremlin_python
+    from cassandra.datastax.graph.fluent._predicates import *
+except ImportError:
+    # gremlinpython is not installed.
+    pass
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/query.py b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/query.py
new file mode 100644
index 0000000000000000000000000000000000000000..73cbd70beccc59f5c90d5367872e1dbbaf3be6ed
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/query.py
@@ -0,0 +1,20 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import gremlin_python
+    from cassandra.datastax.graph.fluent._query import *
+except ImportError:
+    # gremlinpython is not installed.
+    pass
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/fluent/serializers.py b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/serializers.py
new file mode 100644
index 0000000000000000000000000000000000000000..1c62f4cd2c0ccf4ff20b4842f97618c230fe6a59
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/graph/fluent/serializers.py
@@ -0,0 +1,20 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import gremlin_python
+    from cassandra.datastax.graph.fluent._serializers import *
+except ImportError:
+    # gremlinpython is not installed.
+    pass
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/graphson.py b/llm/Lib/site-packages/cassandra/datastax/graph/graphson.py
new file mode 100644
index 0000000000000000000000000000000000000000..ae84384f7b9cb74caea61334cb4780aa18b39bbb
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/graph/graphson.py
@@ -0,0 +1,1132 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import base64
+import uuid
+import re
+import json
+from decimal import Decimal
+from collections import OrderedDict
+import logging
+import itertools
+from functools import partial
+
+import ipaddress
+
+
+from cassandra.cqltypes import cql_types_from_string
+from cassandra.metadata import UserType
+from cassandra.util import Polygon, Point, LineString, Duration
+from cassandra.datastax.graph.types import Vertex, VertexProperty, Edge, Path, T
+
+__all__ = ['GraphSON1Serializer', 'GraphSON1Deserializer', 'GraphSON1TypeDeserializer',
+           'GraphSON2Serializer', 'GraphSON2Deserializer', 'GraphSON2Reader',
+           'GraphSON3Serializer', 'GraphSON3Deserializer', 'GraphSON3Reader',
+           'to_bigint', 'to_int', 'to_double', 'to_float', 'to_smallint',
+           'BooleanTypeIO', 'Int16TypeIO', 'Int32TypeIO', 'DoubleTypeIO',
+           'FloatTypeIO', 'UUIDTypeIO', 'BigDecimalTypeIO', 'DurationTypeIO', 'InetTypeIO',
+           'InstantTypeIO', 'LocalDateTypeIO', 'LocalTimeTypeIO', 'Int64TypeIO', 'BigIntegerTypeIO',
+           'LocalDateTypeIO', 'PolygonTypeIO', 'PointTypeIO', 'LineStringTypeIO', 'BlobTypeIO',
+           'GraphSON3Serializer', 'GraphSON3Deserializer', 'UserTypeIO', 'TypeWrapperTypeIO']
+
+"""
+Supported types:
+
+DSE Graph      GraphSON 2.0     GraphSON 3.0   |  Python Driver
+------------ | -------------- | -------------- | ------------
+text         | string         | string         | str
+boolean      |                |                | bool
+bigint       | g:Int64        | g:Int64        | long
+int          | g:Int32        | g:Int32        | int
+double       | g:Double       | g:Double       | float
+float        | g:Float        | g:Float        | float
+uuid         | g:UUID         | g:UUID         | UUID
+bigdecimal   | gx:BigDecimal  | gx:BigDecimal  | Decimal
+duration     | gx:Duration    | N/A            | timedelta              (Classic graph only)
+DSE Duration | N/A            | dse:Duration   | Duration               (Core graph only)
+inet         | gx:InetAddress | gx:InetAddress | str (unicode), IPV4Address/IPV6Address (PY3)
+timestamp    | gx:Instant     | gx:Instant     | datetime.datetime
+date         | gx:LocalDate   | gx:LocalDate   | datetime.date
+time         | gx:LocalTime   | gx:LocalTime   | datetime.time
+smallint     | gx:Int16       | gx:Int16       | int
+varint       | gx:BigInteger  | gx:BigInteger  | long
+date         | gx:LocalDate   | gx:LocalDate   | Date
+polygon      | dse:Polygon    | dse:Polygon    | Polygon
+point        | dse:Point      | dse:Point      | Point
+linestring   | dse:Linestring | dse:LineString | LineString
+blob         | dse:Blob       | dse:Blob       | bytearray, buffer (PY2), memoryview (PY3), bytes (PY3)
+blob         | gx:ByteBuffer  | gx:ByteBuffer  | bytearray, buffer (PY2), memoryview (PY3), bytes (PY3)
+list         | N/A            | g:List         | list                   (Core graph only)
+map          | N/A            | g:Map          | dict                   (Core graph only)
+set          | N/A            | g:Set          | set or list            (Core graph only)
+                                                 Can return a list due to numerical values returned by Java
+tuple        | N/A            | dse:Tuple      | tuple                  (Core graph only)
+udt          | N/A            | dse:UDT        | class or namedtuple    (Core graph only)
+"""
+
+MAX_INT32 = 2 ** 32 - 1
+MIN_INT32 = -2 ** 31
+
+log = logging.getLogger(__name__)
+
+
+class _GraphSONTypeType(type):
+    """GraphSONType metaclass, required to create a class property."""
+
+    @property
+    def graphson_type(cls):
+        return "{0}:{1}".format(cls.prefix, cls.graphson_base_type)
+
+
+class GraphSONTypeIO(object, metaclass=_GraphSONTypeType):
+    """Represent a serializable GraphSON type"""
+
+    prefix = 'g'
+    graphson_base_type = None
+    cql_type = None
+
+    @classmethod
+    def definition(cls, value, writer=None):
+        return {'cqlType': cls.cql_type}
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        return str(value)
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return value
+
+    @classmethod
+    def get_specialized_serializer(cls, value):
+        return cls
+
+
+class TextTypeIO(GraphSONTypeIO):
+    cql_type = 'text'
+
+
+class BooleanTypeIO(GraphSONTypeIO):
+    graphson_base_type = None
+    cql_type = 'boolean'
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        return bool(value)
+
+
+class IntegerTypeIO(GraphSONTypeIO):
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        return value
+
+    @classmethod
+    def get_specialized_serializer(cls, value):
+        if type(value) is int and (value > MAX_INT32 or value < MIN_INT32):
+            return Int64TypeIO
+
+        return Int32TypeIO
+
+
+class Int16TypeIO(IntegerTypeIO):
+    prefix = 'gx'
+    graphson_base_type = 'Int16'
+    cql_type = 'smallint'
+
+
+class Int32TypeIO(IntegerTypeIO):
+    graphson_base_type = 'Int32'
+    cql_type = 'int'
+
+
+class Int64TypeIO(IntegerTypeIO):
+    graphson_base_type = 'Int64'
+    cql_type = 'bigint'
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return value
+
+
+class FloatTypeIO(GraphSONTypeIO):
+    graphson_base_type = 'Float'
+    cql_type = 'float'
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        return value
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return float(value)
+
+
+class DoubleTypeIO(FloatTypeIO):
+    graphson_base_type = 'Double'
+    cql_type = 'double'
+
+
+class BigIntegerTypeIO(IntegerTypeIO):
+    prefix = 'gx'
+    graphson_base_type = 'BigInteger'
+
+
+class LocalDateTypeIO(GraphSONTypeIO):
+    FORMAT = '%Y-%m-%d'
+
+    prefix = 'gx'
+    graphson_base_type = 'LocalDate'
+    cql_type = 'date'
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        return value.isoformat()
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        try:
+            return datetime.datetime.strptime(value, cls.FORMAT).date()
+        except ValueError:
+            # negative date
+            return value
+
+
+class InstantTypeIO(GraphSONTypeIO):
+    prefix = 'gx'
+    graphson_base_type = 'Instant'
+    cql_type = 'timestamp'
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        if isinstance(value, datetime.datetime):
+            value = datetime.datetime(*value.utctimetuple()[:6]).replace(microsecond=value.microsecond)
+        else:
+            value = datetime.datetime.combine(value, datetime.datetime.min.time())
+
+        return "{0}Z".format(value.isoformat())
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        try:
+            d = datetime.datetime.strptime(value, '%Y-%m-%dT%H:%M:%S.%fZ')
+        except ValueError:
+            d = datetime.datetime.strptime(value, '%Y-%m-%dT%H:%M:%SZ')
+        return d
+
+
+class LocalTimeTypeIO(GraphSONTypeIO):
+    FORMATS = [
+        '%H:%M',
+        '%H:%M:%S',
+        '%H:%M:%S.%f'
+    ]
+
+    prefix = 'gx'
+    graphson_base_type = 'LocalTime'
+    cql_type = 'time'
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        return value.strftime(cls.FORMATS[2])
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        dt = None
+        for f in cls.FORMATS:
+            try:
+                dt = datetime.datetime.strptime(value, f)
+                break
+            except ValueError:
+                continue
+
+        if dt is None:
+            raise ValueError('Unable to decode LocalTime: {0}'.format(value))
+
+        return dt.time()
+
+
+class BlobTypeIO(GraphSONTypeIO):
+    prefix = 'dse'
+    graphson_base_type = 'Blob'
+    cql_type = 'blob'
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        value = base64.b64encode(value)
+        value = value.decode('utf-8')
+        return value
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return bytearray(base64.b64decode(value))
+
+
+class ByteBufferTypeIO(BlobTypeIO):
+    prefix = 'gx'
+    graphson_base_type = 'ByteBuffer'
+
+
+class UUIDTypeIO(GraphSONTypeIO):
+    graphson_base_type = 'UUID'
+    cql_type = 'uuid'
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return uuid.UUID(value)
+
+
+class BigDecimalTypeIO(GraphSONTypeIO):
+    prefix = 'gx'
+    graphson_base_type = 'BigDecimal'
+    cql_type = 'bigdecimal'
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return Decimal(value)
+
+
+class DurationTypeIO(GraphSONTypeIO):
+    prefix = 'gx'
+    graphson_base_type = 'Duration'
+    cql_type = 'duration'
+
+    _duration_regex = re.compile(r"""
+        ^P((?P<days>\d+)D)?
+        T((?P<hours>\d+)H)?
+        ((?P<minutes>\d+)M)?
+        ((?P<seconds>[0-9.]+)S)?$
+    """, re.VERBOSE)
+    _duration_format = "P{days}DT{hours}H{minutes}M{seconds}S"
+
+    _seconds_in_minute = 60
+    _seconds_in_hour = 60 * _seconds_in_minute
+    _seconds_in_day = 24 * _seconds_in_hour
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        total_seconds = int(value.total_seconds())
+        days, total_seconds = divmod(total_seconds, cls._seconds_in_day)
+        hours, total_seconds = divmod(total_seconds, cls._seconds_in_hour)
+        minutes, total_seconds = divmod(total_seconds, cls._seconds_in_minute)
+        total_seconds += value.microseconds / 1e6
+
+        return cls._duration_format.format(
+            days=int(days), hours=int(hours), minutes=int(minutes), seconds=total_seconds
+        )
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        duration = cls._duration_regex.match(value)
+        if duration is None:
+            raise ValueError('Invalid duration: {0}'.format(value))
+
+        duration = {k: float(v) if v is not None else 0
+                    for k, v in duration.groupdict().items()}
+        return datetime.timedelta(days=duration['days'], hours=duration['hours'],
+                                  minutes=duration['minutes'], seconds=duration['seconds'])
+
+
+class DseDurationTypeIO(GraphSONTypeIO):
+    prefix = 'dse'
+    graphson_base_type = 'Duration'
+    cql_type = 'duration'
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        return {
+            'months': value.months,
+            'days': value.days,
+            'nanos': value.nanoseconds
+        }
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return Duration(
+            reader.deserialize(value['months']),
+            reader.deserialize(value['days']),
+            reader.deserialize(value['nanos'])
+        )
+
+
+class TypeWrapperTypeIO(GraphSONTypeIO):
+
+    @classmethod
+    def definition(cls, value, writer=None):
+        return {'cqlType': value.type_io.cql_type}
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        return value.type_io.serialize(value.value)
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return value.type_io.deserialize(value.value)
+
+
+class PointTypeIO(GraphSONTypeIO):
+    prefix = 'dse'
+    graphson_base_type = 'Point'
+    cql_type = "org.apache.cassandra.db.marshal.PointType"
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return Point.from_wkt(value)
+
+
+class LineStringTypeIO(GraphSONTypeIO):
+    prefix = 'dse'
+    graphson_base_type = 'LineString'
+    cql_type = "org.apache.cassandra.db.marshal.LineStringType"
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return LineString.from_wkt(value)
+
+
+class PolygonTypeIO(GraphSONTypeIO):
+    prefix = 'dse'
+    graphson_base_type = 'Polygon'
+    cql_type = "org.apache.cassandra.db.marshal.PolygonType"
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return Polygon.from_wkt(value)
+
+
+class InetTypeIO(GraphSONTypeIO):
+    prefix = 'gx'
+    graphson_base_type = 'InetAddress'
+    cql_type = 'inet'
+
+
+class VertexTypeIO(GraphSONTypeIO):
+    graphson_base_type = 'Vertex'
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        vertex = Vertex(id=reader.deserialize(value["id"]),
+                        label=value["label"] if "label" in value else "vertex",
+                        type='vertex',
+                        properties={})
+        # avoid the properties processing in Vertex.__init__
+        vertex.properties = reader.deserialize(value.get('properties', {}))
+        return vertex
+
+
+class VertexPropertyTypeIO(GraphSONTypeIO):
+    graphson_base_type = 'VertexProperty'
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return VertexProperty(label=value['label'],
+                              value=reader.deserialize(value["value"]),
+                              properties=reader.deserialize(value.get('properties', {})))
+
+
+class EdgeTypeIO(GraphSONTypeIO):
+    graphson_base_type = 'Edge'
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        in_vertex = Vertex(id=reader.deserialize(value["inV"]),
+                           label=value['inVLabel'],
+                           type='vertex',
+                           properties={})
+        out_vertex = Vertex(id=reader.deserialize(value["outV"]),
+                            label=value['outVLabel'],
+                            type='vertex',
+                            properties={})
+        return Edge(
+            id=reader.deserialize(value["id"]),
+            label=value["label"] if "label" in value else "vertex",
+            type='edge',
+            properties=reader.deserialize(value.get("properties", {})),
+            inV=in_vertex,
+            inVLabel=value['inVLabel'],
+            outV=out_vertex,
+            outVLabel=value['outVLabel']
+        )
+
+
+class PropertyTypeIO(GraphSONTypeIO):
+    graphson_base_type = 'Property'
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return {value["key"]: reader.deserialize(value["value"])}
+
+
+class PathTypeIO(GraphSONTypeIO):
+    graphson_base_type = 'Path'
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        labels = [set(label) for label in reader.deserialize(value['labels'])]
+        objects = [obj for obj in reader.deserialize(value['objects'])]
+        p = Path(labels, [])
+        p.objects = objects  # avoid the object processing in Path.__init__
+        return p
+
+
+class TraversalMetricsTypeIO(GraphSONTypeIO):
+    graphson_base_type = 'TraversalMetrics'
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return reader.deserialize(value)
+
+
+class MetricsTypeIO(GraphSONTypeIO):
+    graphson_base_type = 'Metrics'
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return reader.deserialize(value)
+
+
+class JsonMapTypeIO(GraphSONTypeIO):
+    """In GraphSON2, dict are simply serialized as json map"""
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        out = {}
+        for k, v in value.items():
+            out[k] = writer.serialize(v, writer)
+
+        return out
+
+
+class MapTypeIO(GraphSONTypeIO):
+    """In GraphSON3, dict has its own type"""
+
+    graphson_base_type = 'Map'
+    cql_type = 'map'
+
+    @classmethod
+    def definition(cls, value, writer=None):
+        out = OrderedDict([('cqlType', cls.cql_type)])
+        out['definition'] = []
+        for k, v in value.items():
+            # we just need the first pair to write the def
+            out['definition'].append(writer.definition(k))
+            out['definition'].append(writer.definition(v))
+            break
+        return out
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        out = []
+        for k, v in value.items():
+            out.append(writer.serialize(k, writer))
+            out.append(writer.serialize(v, writer))
+
+        return out
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        out = {}
+        a, b = itertools.tee(value)
+        for key, val in zip(
+            itertools.islice(a, 0, None, 2),
+            itertools.islice(b, 1, None, 2)
+        ):
+            out[reader.deserialize(key)] = reader.deserialize(val)
+        return out
+
+
+class ListTypeIO(GraphSONTypeIO):
+    """In GraphSON3, list has its own type"""
+
+    graphson_base_type = 'List'
+    cql_type = 'list'
+
+    @classmethod
+    def definition(cls, value, writer=None):
+        out = OrderedDict([('cqlType', cls.cql_type)])
+        out['definition'] = []
+        if value:
+            out['definition'].append(writer.definition(value[0]))
+        return out
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        return [writer.serialize(v, writer) for v in value]
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return [reader.deserialize(obj) for obj in value]
+
+
+class SetTypeIO(GraphSONTypeIO):
+    """In GraphSON3, set has its own type"""
+
+    graphson_base_type = 'Set'
+    cql_type = 'set'
+
+    @classmethod
+    def definition(cls, value, writer=None):
+        out = OrderedDict([('cqlType', cls.cql_type)])
+        out['definition'] = []
+        for v in value:
+            # we only take into account the first value for the definition
+            out['definition'].append(writer.definition(v))
+            break
+        return out
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        return [writer.serialize(v, writer) for v in value]
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        lst = [reader.deserialize(obj) for obj in value]
+
+        s = set(lst)
+        if len(s) != len(lst):
+            log.warning("Coercing g:Set to list due to numerical values returned by Java. "
+                        "See TINKERPOP-1844 for details.")
+            return lst
+
+        return s
+
+
+class BulkSetTypeIO(GraphSONTypeIO):
+    graphson_base_type = "BulkSet"
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        out = []
+
+        a, b = itertools.tee(value)
+        for val, bulk in zip(
+            itertools.islice(a, 0, None, 2),
+            itertools.islice(b, 1, None, 2)
+        ):
+            val = reader.deserialize(val)
+            bulk = reader.deserialize(bulk)
+            for n in range(bulk):
+                out.append(val)
+
+        return out
+
+
+class TupleTypeIO(GraphSONTypeIO):
+    prefix = 'dse'
+    graphson_base_type = 'Tuple'
+    cql_type = 'tuple'
+
+    @classmethod
+    def definition(cls, value, writer=None):
+        out = OrderedDict()
+        out['cqlType'] = cls.cql_type
+        serializers = [writer.get_serializer(s) for s in value]
+        out['definition'] = [s.definition(v, writer) for v, s in zip(value, serializers)]
+        return out
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        out = cls.definition(value, writer)
+        out['value'] = [writer.serialize(v, writer) for v in value]
+        return out
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return tuple(reader.deserialize(obj) for obj in value['value'])
+
+
+class UserTypeIO(GraphSONTypeIO):
+    prefix = 'dse'
+    graphson_base_type = 'UDT'
+    cql_type = 'udt'
+
+    FROZEN_REMOVAL_REGEX = re.compile(r'frozen<"*([^"]+)"*>')
+
+    @classmethod
+    def cql_types_from_string(cls, typ):
+        # sanitizing: remove frozen references and double quotes...
+        return cql_types_from_string(
+            re.sub(cls.FROZEN_REMOVAL_REGEX, r'\1', typ)
+        )
+
+    @classmethod
+    def get_udt_definition(cls, value, writer):
+        user_type_name = writer.user_types[type(value)]
+        keyspace = writer.context['graph_name']
+        return writer.context['cluster'].metadata.keyspaces[keyspace].user_types[user_type_name]
+
+    @classmethod
+    def is_collection(cls, typ):
+        return typ in ['list', 'tuple', 'map', 'set']
+
+    @classmethod
+    def is_udt(cls, typ, writer):
+        keyspace = writer.context['graph_name']
+        if keyspace in writer.context['cluster'].metadata.keyspaces:
+            return typ in writer.context['cluster'].metadata.keyspaces[keyspace].user_types
+        return False
+
+    @classmethod
+    def field_definition(cls, types, writer, name=None):
+        """
+        Build the udt field definition. This is required when we have a complex udt type.
+        """
+        index = -1
+        out = [OrderedDict() if name is None else OrderedDict([('fieldName', name)])]
+
+        while types:
+            index += 1
+            typ = types.pop(0)
+            if index > 0:
+                out.append(OrderedDict())
+
+            if cls.is_udt(typ, writer):
+                keyspace = writer.context['graph_name']
+                udt = writer.context['cluster'].metadata.keyspaces[keyspace].user_types[typ]
+                out[index].update(cls.definition(udt, writer))
+            elif cls.is_collection(typ):
+                out[index]['cqlType'] = typ
+                definition = cls.field_definition(types, writer)
+                out[index]['definition'] = definition if isinstance(definition, list) else [definition]
+            else:
+                out[index]['cqlType'] = typ
+
+        return out if len(out) > 1 else out[0]
+
+    @classmethod
+    def definition(cls, value, writer=None):
+        udt = value if isinstance(value, UserType) else cls.get_udt_definition(value, writer)
+        return OrderedDict([
+            ('cqlType', cls.cql_type),
+            ('keyspace', udt.keyspace),
+            ('name', udt.name),
+            ('definition', [
+                cls.field_definition(cls.cql_types_from_string(typ), writer, name=name)
+                for name, typ in zip(udt.field_names, udt.field_types)])
+        ])
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        udt = cls.get_udt_definition(value, writer)
+        out = cls.definition(value, writer)
+        out['value'] = []
+        for name, typ in zip(udt.field_names, udt.field_types):
+            out['value'].append(writer.serialize(getattr(value, name), writer))
+        return out
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        udt_class = reader.context['cluster']._user_types[value['keyspace']][value['name']]
+        kwargs = zip(
+            list(map(lambda v: v['fieldName'], value['definition'])),
+            [reader.deserialize(v) for v in value['value']]
+        )
+        return udt_class(**dict(kwargs))
+
+
+class TTypeIO(GraphSONTypeIO):
+    prefix = 'g'
+    graphson_base_type = 'T'
+
+    @classmethod
+    def deserialize(cls, value, reader=None):
+        return T.name_to_value[value]
+
+
+class _BaseGraphSONSerializer(object):
+
+    _serializers = OrderedDict()
+
+    @classmethod
+    def register(cls, type, serializer):
+        cls._serializers[type] = serializer
+
+    @classmethod
+    def get_type_definitions(cls):
+        return cls._serializers.copy()
+
+    @classmethod
+    def get_serializer(cls, value):
+        """
+        Get the serializer for a python object.
+
+        :param value: The python object.
+        """
+
+        # The serializer matching logic is as follow:
+        # 1. Try to find the python type by direct access.
+        # 2. Try to find the first serializer by class inheritance.
+        # 3. If no serializer found, return the raw value.
+
+        # Note that when trying to find the serializer by class inheritance,
+        # the order that serializers are registered is important. The use of
+        # an OrderedDict is to avoid the difference between executions.
+        serializer = None
+        try:
+            serializer = cls._serializers[type(value)]
+        except KeyError:
+            for key, serializer_ in cls._serializers.items():
+                if isinstance(value, key):
+                    serializer = serializer_
+                    break
+
+        if serializer:
+            # A serializer can have specialized serializers (e.g for Int32 and Int64, so value dependant)
+            serializer = serializer.get_specialized_serializer(value)
+
+        return serializer
+
+    @classmethod
+    def serialize(cls, value, writer=None):
+        """
+        Serialize a python object to GraphSON.
+
+        e.g 'P42DT10H5M37S'
+        e.g. {'key': value}
+
+        :param value: The python object to serialize.
+        :param writer: A graphson serializer for recursive types (Optional)
+        """
+        serializer = cls.get_serializer(value)
+        if serializer:
+            return serializer.serialize(value, writer or cls)
+
+        return value
+
+
+class GraphSON1Serializer(_BaseGraphSONSerializer):
+    """
+    Serialize python objects to graphson types.
+    """
+
+    # When we fall back to a superclass's serializer, we iterate over this map.
+    # We want that iteration order to be consistent, so we use an OrderedDict,
+    # not a dict.
+    _serializers = OrderedDict([
+        (str, TextTypeIO),
+        (bool, BooleanTypeIO),
+        (bytearray, ByteBufferTypeIO),
+        (Decimal, BigDecimalTypeIO),
+        (datetime.date, LocalDateTypeIO),
+        (datetime.time, LocalTimeTypeIO),
+        (datetime.timedelta, DurationTypeIO),
+        (datetime.datetime, InstantTypeIO),
+        (uuid.UUID, UUIDTypeIO),
+        (Polygon, PolygonTypeIO),
+        (Point, PointTypeIO),
+        (LineString, LineStringTypeIO),
+        (dict, JsonMapTypeIO),
+        (float, FloatTypeIO)
+    ])
+
+
+GraphSON1Serializer.register(ipaddress.IPv4Address, InetTypeIO)
+GraphSON1Serializer.register(ipaddress.IPv6Address, InetTypeIO)
+GraphSON1Serializer.register(memoryview, ByteBufferTypeIO)
+GraphSON1Serializer.register(bytes, ByteBufferTypeIO)
+
+
+class _BaseGraphSONDeserializer(object):
+
+    _deserializers = {}
+
+    @classmethod
+    def get_type_definitions(cls):
+        return cls._deserializers.copy()
+
+    @classmethod
+    def register(cls, graphson_type, serializer):
+        cls._deserializers[graphson_type] = serializer
+
+    @classmethod
+    def get_deserializer(cls, graphson_type):
+        try:
+            return cls._deserializers[graphson_type]
+        except KeyError:
+            raise ValueError('Invalid `graphson_type` specified: {}'.format(graphson_type))
+
+    @classmethod
+    def deserialize(cls, graphson_type, value):
+        """
+        Deserialize a `graphson_type` value to a python object.
+
+        :param graphson_base_type: The graphson graphson_type. e.g. 'gx:Instant'
+        :param value: The graphson value to deserialize.
+        """
+        return cls.get_deserializer(graphson_type).deserialize(value)
+
+
+class GraphSON1Deserializer(_BaseGraphSONDeserializer):
+    """
+    Deserialize graphson1 types to python objects.
+    """
+    _TYPES = [UUIDTypeIO, BigDecimalTypeIO, InstantTypeIO, BlobTypeIO, ByteBufferTypeIO,
+              PointTypeIO, LineStringTypeIO, PolygonTypeIO, LocalDateTypeIO,
+              LocalTimeTypeIO, DurationTypeIO, InetTypeIO]
+
+    _deserializers = {
+        t.graphson_type: t
+        for t in _TYPES
+    }
+
+    @classmethod
+    def deserialize_date(cls, value):
+        return cls._deserializers[LocalDateTypeIO.graphson_type].deserialize(value)
+
+    @classmethod
+    def deserialize_time(cls, value):
+        return cls._deserializers[LocalTimeTypeIO.graphson_type].deserialize(value)
+
+    @classmethod
+    def deserialize_timestamp(cls, value):
+        return cls._deserializers[InstantTypeIO.graphson_type].deserialize(value)
+
+    @classmethod
+    def deserialize_duration(cls, value):
+        return cls._deserializers[DurationTypeIO.graphson_type].deserialize(value)
+
+    @classmethod
+    def deserialize_int(cls, value):
+        return int(value)
+
+    deserialize_smallint = deserialize_int
+
+    deserialize_varint = deserialize_int
+
+    @classmethod
+    def deserialize_bigint(cls, value):
+        return cls.deserialize_int(value)
+
+    @classmethod
+    def deserialize_double(cls, value):
+        return float(value)
+
+    deserialize_float = deserialize_double
+
+    @classmethod
+    def deserialize_uuid(cls, value):
+        return cls._deserializers[UUIDTypeIO.graphson_type].deserialize(value)
+
+    @classmethod
+    def deserialize_decimal(cls, value):
+        return cls._deserializers[BigDecimalTypeIO.graphson_type].deserialize(value)
+
+    @classmethod
+    def deserialize_blob(cls, value):
+        return cls._deserializers[ByteBufferTypeIO.graphson_type].deserialize(value)
+
+    @classmethod
+    def deserialize_point(cls, value):
+        return cls._deserializers[PointTypeIO.graphson_type].deserialize(value)
+
+    @classmethod
+    def deserialize_linestring(cls, value):
+        return cls._deserializers[LineStringTypeIO.graphson_type].deserialize(value)
+
+    @classmethod
+    def deserialize_polygon(cls, value):
+        return cls._deserializers[PolygonTypeIO.graphson_type].deserialize(value)
+
+    @classmethod
+    def deserialize_inet(cls, value):
+        return value
+
+    @classmethod
+    def deserialize_boolean(cls, value):
+        return value
+
+
+# TODO Remove in the next major
+GraphSON1TypeDeserializer = GraphSON1Deserializer
+GraphSON1TypeSerializer = GraphSON1Serializer
+
+
+class GraphSON2Serializer(_BaseGraphSONSerializer):
+    TYPE_KEY = "@type"
+    VALUE_KEY = "@value"
+
+    _serializers = GraphSON1Serializer.get_type_definitions()
+
+    def serialize(self, value, writer=None):
+        """
+        Serialize a type to GraphSON2.
+
+        e.g {'@type': 'gx:Duration', '@value': 'P2DT4H'}
+
+        :param value: The python object to serialize.
+        """
+        serializer = self.get_serializer(value)
+        if not serializer:
+            raise ValueError("Unable to find a serializer for value of type: ".format(type(value)))
+
+        val = serializer.serialize(value, writer or self)
+        if serializer is TypeWrapperTypeIO:
+            graphson_base_type = value.type_io.graphson_base_type
+            graphson_type = value.type_io.graphson_type
+        else:
+            graphson_base_type = serializer.graphson_base_type
+            graphson_type = serializer.graphson_type
+
+        if graphson_base_type is None:
+            out = val
+        else:
+            out = {self.TYPE_KEY: graphson_type}
+            if val is not None:
+                out[self.VALUE_KEY] = val
+
+        return out
+
+
+GraphSON2Serializer.register(int, IntegerTypeIO)
+
+
+class GraphSON2Deserializer(_BaseGraphSONDeserializer):
+
+    _TYPES = GraphSON1Deserializer._TYPES + [
+        Int16TypeIO, Int32TypeIO, Int64TypeIO, DoubleTypeIO, FloatTypeIO,
+        BigIntegerTypeIO, VertexTypeIO, VertexPropertyTypeIO, EdgeTypeIO,
+        PathTypeIO, PropertyTypeIO, TraversalMetricsTypeIO, MetricsTypeIO]
+
+    _deserializers = {
+        t.graphson_type: t
+        for t in _TYPES
+    }
+
+
+class GraphSON2Reader(object):
+    """
+    GraphSON2 Reader that parse json and deserialize to python objects.
+    """
+
+    def __init__(self, context, extra_deserializer_map=None):
+        """
+        :param extra_deserializer_map: map from GraphSON type tag to deserializer instance implementing `deserialize`
+        """
+        self.context = context
+        self.deserializers = GraphSON2Deserializer.get_type_definitions()
+        if extra_deserializer_map:
+            self.deserializers.update(extra_deserializer_map)
+
+    def read(self, json_data):
+        """
+        Read and deserialize ``json_data``.
+        """
+        return self.deserialize(json.loads(json_data))
+
+    def deserialize(self, obj):
+        """
+        Deserialize GraphSON type-tagged dict values into objects mapped in self.deserializers
+        """
+        if isinstance(obj, dict):
+            try:
+                des = self.deserializers[obj[GraphSON2Serializer.TYPE_KEY]]
+                return des.deserialize(obj[GraphSON2Serializer.VALUE_KEY], self)
+            except KeyError:
+                pass
+            # list and map are treated as normal json objs (could be isolated deserializers)
+            return {self.deserialize(k): self.deserialize(v) for k, v in obj.items()}
+        elif isinstance(obj, list):
+            return [self.deserialize(o) for o in obj]
+        else:
+            return obj
+
+
+class TypeIOWrapper(object):
+    """Used to force a graphson type during serialization"""
+
+    type_io = None
+    value = None
+
+    def __init__(self, type_io, value):
+        self.type_io = type_io
+        self.value = value
+
+
+def _wrap_value(type_io, value):
+    return TypeIOWrapper(type_io, value)
+
+
+to_bigint = partial(_wrap_value, Int64TypeIO)
+to_int = partial(_wrap_value, Int32TypeIO)
+to_smallint = partial(_wrap_value, Int16TypeIO)
+to_double = partial(_wrap_value, DoubleTypeIO)
+to_float = partial(_wrap_value, FloatTypeIO)
+
+
+class GraphSON3Serializer(GraphSON2Serializer):
+
+    _serializers = GraphSON2Serializer.get_type_definitions()
+
+    context = None
+    """A dict of the serialization context"""
+
+    def __init__(self, context):
+        self.context = context
+        self.user_types = None
+
+    def definition(self, value):
+        serializer = self.get_serializer(value)
+        return serializer.definition(value, self)
+
+    def get_serializer(self, value):
+        """Custom get_serializer to support UDT/Tuple"""
+
+        serializer = super(GraphSON3Serializer, self).get_serializer(value)
+        is_namedtuple_udt = serializer is TupleTypeIO and hasattr(value, '_fields')
+        if not serializer or is_namedtuple_udt:
+            # Check if UDT
+            if self.user_types is None:
+                try:
+                    user_types = self.context['cluster']._user_types[self.context['graph_name']]
+                    self.user_types = dict(map(reversed, user_types.items()))
+                except KeyError:
+                    self.user_types = {}
+
+            serializer = UserTypeIO if (is_namedtuple_udt or (type(value) in self.user_types)) else serializer
+
+        return serializer
+
+
+GraphSON3Serializer.register(dict, MapTypeIO)
+GraphSON3Serializer.register(list, ListTypeIO)
+GraphSON3Serializer.register(set, SetTypeIO)
+GraphSON3Serializer.register(tuple, TupleTypeIO)
+GraphSON3Serializer.register(Duration, DseDurationTypeIO)
+GraphSON3Serializer.register(TypeIOWrapper, TypeWrapperTypeIO)
+
+
+class GraphSON3Deserializer(GraphSON2Deserializer):
+    _TYPES = GraphSON2Deserializer._TYPES + [MapTypeIO, ListTypeIO,
+                                             SetTypeIO, TupleTypeIO,
+                                             UserTypeIO, DseDurationTypeIO,
+                                             TTypeIO, BulkSetTypeIO]
+
+    _deserializers = {t.graphson_type: t for t in _TYPES}
+
+
+class GraphSON3Reader(GraphSON2Reader):
+    """
+    GraphSON3 Reader that parse json and deserialize to python objects.
+    """
+
+    def __init__(self, context, extra_deserializer_map=None):
+        """
+        :param context: A dict of the context, mostly used as context for udt deserialization.
+        :param extra_deserializer_map: map from GraphSON type tag to deserializer instance implementing `deserialize`
+        """
+        self.context = context
+        self.deserializers = GraphSON3Deserializer.get_type_definitions()
+        if extra_deserializer_map:
+            self.deserializers.update(extra_deserializer_map)
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/query.py b/llm/Lib/site-packages/cassandra/datastax/graph/query.py
new file mode 100644
index 0000000000000000000000000000000000000000..7fbe3210c38a9760d844e0628c12ae3bc45c5c8c
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/graph/query.py
@@ -0,0 +1,330 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+from warnings import warn
+
+from cassandra import ConsistencyLevel
+from cassandra.query import Statement, SimpleStatement
+from cassandra.datastax.graph.types import Vertex, Edge, Path, VertexProperty
+from cassandra.datastax.graph.graphson import GraphSON2Reader, GraphSON3Reader
+
+
+__all__ = [
+    'GraphProtocol', 'GraphOptions', 'GraphStatement', 'SimpleGraphStatement',
+    'single_object_row_factory', 'graph_result_row_factory', 'graph_object_row_factory',
+    'graph_graphson2_row_factory', 'Result', 'graph_graphson3_row_factory'
+]
+
+# (attr, description, server option)
+_graph_options = (
+    ('graph_name', 'name of the targeted graph.', 'graph-name'),
+    ('graph_source', 'choose the graph traversal source, configured on the server side.', 'graph-source'),
+    ('graph_language', 'the language used in the queries (default "gremlin-groovy")', 'graph-language'),
+    ('graph_protocol', 'the graph protocol that the server should use for query results (default "graphson-1-0")', 'graph-results'),
+    ('graph_read_consistency_level', '''read `cassandra.ConsistencyLevel <http://docs.datastax.com/en/developer/python-driver/latest/api/cassandra/#cassandra.ConsistencyLevel>`_ for graph queries (if distinct from session default).
+Setting this overrides the native `Statement.consistency_level <http://docs.datastax.com/en/developer/python-driver/latest/api/cassandra/query/#cassandra.query.Statement.consistency_level>`_ for read operations from Cassandra persistence''', 'graph-read-consistency'),
+    ('graph_write_consistency_level', '''write `cassandra.ConsistencyLevel <http://docs.datastax.com/en/developer/python-driver/latest/api/cassandra/#cassandra.ConsistencyLevel>`_ for graph queries (if distinct from session default).
+Setting this overrides the native `Statement.consistency_level <http://docs.datastax.com/en/developer/python-driver/latest/api/cassandra/query/#cassandra.query.Statement.consistency_level>`_ for write operations to Cassandra persistence.''', 'graph-write-consistency')
+)
+_graph_option_names = tuple(option[0] for option in _graph_options)
+
+# this is defined by the execution profile attribute, not in graph options
+_request_timeout_key = 'request-timeout'
+
+
+class GraphProtocol(object):
+
+    GRAPHSON_1_0 = b'graphson-1.0'
+    """
+    GraphSON1
+    """
+
+    GRAPHSON_2_0 = b'graphson-2.0'
+    """
+    GraphSON2
+    """
+
+    GRAPHSON_3_0 = b'graphson-3.0'
+    """
+    GraphSON3
+    """
+
+
+class GraphOptions(object):
+    """
+    Options for DSE Graph Query handler.
+    """
+    # See _graph_options map above for notes on valid options
+
+    DEFAULT_GRAPH_PROTOCOL = GraphProtocol.GRAPHSON_1_0
+    DEFAULT_GRAPH_LANGUAGE = b'gremlin-groovy'
+
+    def __init__(self, **kwargs):
+        self._graph_options = {}
+        kwargs.setdefault('graph_source', 'g')
+        kwargs.setdefault('graph_language', GraphOptions.DEFAULT_GRAPH_LANGUAGE)
+        for attr, value in kwargs.items():
+            if attr not in _graph_option_names:
+                warn("Unknown keyword argument received for GraphOptions: {0}".format(attr))
+            setattr(self, attr, value)
+
+    def copy(self):
+        new_options = GraphOptions()
+        new_options._graph_options = self._graph_options.copy()
+        return new_options
+
+    def update(self, options):
+        self._graph_options.update(options._graph_options)
+
+    def get_options_map(self, other_options=None):
+        """
+        Returns a map for these options updated with other options,
+        and mapped to graph payload types.
+        """
+        options = self._graph_options.copy()
+        if other_options:
+            options.update(other_options._graph_options)
+
+        # cls are special-cased so they can be enums in the API, and names in the protocol
+        for cl in ('graph-write-consistency', 'graph-read-consistency'):
+            cl_enum = options.get(cl)
+            if cl_enum is not None:
+                options[cl] = ConsistencyLevel.value_to_name[cl_enum].encode()
+        return options
+
+    def set_source_default(self):
+        """
+        Sets ``graph_source`` to the server-defined default traversal source ('default')
+        """
+        self.graph_source = 'default'
+
+    def set_source_analytics(self):
+        """
+        Sets ``graph_source`` to the server-defined analytic traversal source ('a')
+        """
+        self.graph_source = 'a'
+
+    def set_source_graph(self):
+        """
+        Sets ``graph_source`` to the server-defined graph traversal source ('g')
+        """
+        self.graph_source = 'g'
+
+    def set_graph_protocol(self, protocol):
+        """
+        Sets ``graph_protocol`` as server graph results format (See :class:`cassandra.datastax.graph.GraphProtocol`)
+        """
+        self.graph_protocol = protocol
+
+    @property
+    def is_default_source(self):
+        return self.graph_source in (b'default', None)
+
+    @property
+    def is_analytics_source(self):
+        """
+        True if ``graph_source`` is set to the server-defined analytics traversal source ('a')
+        """
+        return self.graph_source == b'a'
+
+    @property
+    def is_graph_source(self):
+        """
+        True if ``graph_source`` is set to the server-defined graph traversal source ('g')
+        """
+        return self.graph_source == b'g'
+
+
+for opt in _graph_options:
+
+    def get(self, key=opt[2]):
+        return self._graph_options.get(key)
+
+    def set(self, value, key=opt[2]):
+        if value is not None:
+            # normalize text here so it doesn't have to be done every time we get options map
+            if isinstance(value, str):
+                value = value.encode()
+            self._graph_options[key] = value
+        else:
+            self._graph_options.pop(key, None)
+
+    def delete(self, key=opt[2]):
+        self._graph_options.pop(key, None)
+
+    setattr(GraphOptions, opt[0], property(get, set, delete, opt[1]))
+
+
+class GraphStatement(Statement):
+    """ An abstract class representing a graph query."""
+
+    @property
+    def query(self):
+        raise NotImplementedError()
+
+    def __str__(self):
+        return u'<GraphStatement query="{0}">'.format(self.query)
+    __repr__ = __str__
+
+
+class SimpleGraphStatement(GraphStatement, SimpleStatement):
+    """
+    Simple graph statement for :meth:`.Session.execute_graph`.
+    Takes the same parameters as :class:`.SimpleStatement`.
+    """
+    @property
+    def query(self):
+        return self._query_string
+
+
+def single_object_row_factory(column_names, rows):
+    """
+    returns the JSON string value of graph results
+    """
+    return [row[0] for row in rows]
+
+
+def graph_result_row_factory(column_names, rows):
+    """
+    Returns a :class:`Result <cassandra.datastax.graph.Result>` object that can load graph results and produce specific types.
+    The Result JSON is deserialized and unpacked from the top-level 'result' dict.
+    """
+    return [Result(json.loads(row[0])['result']) for row in rows]
+
+
+def graph_object_row_factory(column_names, rows):
+    """
+    Like :func:`~.graph_result_row_factory`, except known element types (:class:`~.Vertex`, :class:`~.Edge`) are
+    converted to their simplified objects. Some low-level metadata is shed in this conversion. Unknown result types are
+    still returned as :class:`Result <cassandra.datastax.graph.Result>`.
+    """
+    return _graph_object_sequence(json.loads(row[0])['result'] for row in rows)
+
+
+def _graph_object_sequence(objects):
+    for o in objects:
+        res = Result(o)
+        if isinstance(o, dict):
+            typ = res.value.get('type')
+            if typ == 'vertex':
+                res = res.as_vertex()
+            elif typ == 'edge':
+                res = res.as_edge()
+        yield res
+
+
+class _GraphSONContextRowFactory(object):
+    graphson_reader_class = None
+    graphson_reader_kwargs = None
+
+    def __init__(self, cluster):
+        context = {'cluster': cluster}
+        kwargs = self.graphson_reader_kwargs or {}
+        self.graphson_reader = self.graphson_reader_class(context, **kwargs)
+
+    def __call__(self, column_names, rows):
+        return [self.graphson_reader.read(row[0])['result'] for row in rows]
+
+
+class _GraphSON2RowFactory(_GraphSONContextRowFactory):
+    """Row factory to deserialize GraphSON2 results."""
+    graphson_reader_class = GraphSON2Reader
+
+
+class _GraphSON3RowFactory(_GraphSONContextRowFactory):
+    """Row factory to deserialize GraphSON3 results."""
+    graphson_reader_class = GraphSON3Reader
+
+
+graph_graphson2_row_factory = _GraphSON2RowFactory
+graph_graphson3_row_factory = _GraphSON3RowFactory
+
+
+class Result(object):
+    """
+    Represents deserialized graph results.
+    Property and item getters are provided for convenience.
+    """
+
+    value = None
+    """
+    Deserialized value from the result
+    """
+
+    def __init__(self, value):
+        self.value = value
+
+    def __getattr__(self, attr):
+        if not isinstance(self.value, dict):
+            raise ValueError("Value cannot be accessed as a dict")
+
+        if attr in self.value:
+            return self.value[attr]
+
+        raise AttributeError("Result has no top-level attribute %r" % (attr,))
+
+    def __getitem__(self, item):
+        if isinstance(self.value, dict) and isinstance(item, str):
+            return self.value[item]
+        elif isinstance(self.value, list) and isinstance(item, int):
+            return self.value[item]
+        else:
+            raise ValueError("Result cannot be indexed by %r" % (item,))
+
+    def __str__(self):
+        return str(self.value)
+
+    def __repr__(self):
+        return "%s(%r)" % (Result.__name__, self.value)
+
+    def __eq__(self, other):
+        return self.value == other.value
+
+    def as_vertex(self):
+        """
+        Return a :class:`Vertex` parsed from this result
+
+        Raises TypeError if parsing fails (i.e. the result structure is not valid).
+        """
+        try:
+            return Vertex(self.id, self.label, self.type, self.value.get('properties', {}))
+        except (AttributeError, ValueError, TypeError):
+            raise TypeError("Could not create Vertex from %r" % (self,))
+
+    def as_edge(self):
+        """
+        Return a :class:`Edge` parsed from this result
+
+        Raises TypeError if parsing fails (i.e. the result structure is not valid).
+        """
+        try:
+            return Edge(self.id, self.label, self.type, self.value.get('properties', {}),
+                        self.inV, self.inVLabel, self.outV, self.outVLabel)
+        except (AttributeError, ValueError, TypeError):
+            raise TypeError("Could not create Edge from %r" % (self,))
+
+    def as_path(self):
+        """
+        Return a :class:`Path` parsed from this result
+
+        Raises TypeError if parsing fails (i.e. the result structure is not valid).
+        """
+        try:
+            return Path(self.labels, self.objects)
+        except (AttributeError, ValueError, TypeError):
+            raise TypeError("Could not create Path from %r" % (self,))
+
+    def as_vertex_property(self):
+        return VertexProperty(self.value.get('label'), self.value.get('value'), self.value.get('properties', {}))
diff --git a/llm/Lib/site-packages/cassandra/datastax/graph/types.py b/llm/Lib/site-packages/cassandra/datastax/graph/types.py
new file mode 100644
index 0000000000000000000000000000000000000000..07016c01e471df6645ad03a864ade58b8fd57b94
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/graph/types.py
@@ -0,0 +1,210 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__all__ = ['Element', 'Vertex', 'Edge', 'VertexProperty', 'Path', 'T']
+
+
+class Element(object):
+
+    element_type = None
+
+    _attrs = ('id', 'label', 'type', 'properties')
+
+    def __init__(self, id, label, type, properties):
+        if type != self.element_type:
+            raise TypeError("Attempted to create %s from %s element", (type, self.element_type))
+
+        self.id = id
+        self.label = label
+        self.type = type
+        self.properties = self._extract_properties(properties)
+
+    @staticmethod
+    def _extract_properties(properties):
+        return dict(properties)
+
+    def __eq__(self, other):
+        return all(getattr(self, attr) == getattr(other, attr) for attr in self._attrs)
+
+    def __str__(self):
+        return str(dict((k, getattr(self, k)) for k in self._attrs))
+
+
+class Vertex(Element):
+    """
+    Represents a Vertex element from a graph query.
+
+    Vertex ``properties`` are extracted into a ``dict`` of property names to list of :class:`~VertexProperty` (list
+    because they are always encoded that way, and sometimes have multiple cardinality; VertexProperty because sometimes
+    the properties themselves have property maps).
+    """
+
+    element_type = 'vertex'
+
+    @staticmethod
+    def _extract_properties(properties):
+        # vertex properties are always encoded as a list, regardless of Cardinality
+        return dict((k, [VertexProperty(k, p['value'], p.get('properties')) for p in v]) for k, v in properties.items())
+
+    def __repr__(self):
+        properties = dict((name, [{'label': prop.label, 'value': prop.value, 'properties': prop.properties} for prop in prop_list])
+                          for name, prop_list in self.properties.items())
+        return "%s(%r, %r, %r, %r)" % (self.__class__.__name__,
+                                       self.id, self.label,
+                                       self.type, properties)
+
+
+class VertexProperty(object):
+    """
+    Vertex properties have a top-level value and an optional ``dict`` of properties.
+    """
+
+    label = None
+    """
+    label of the property
+    """
+
+    value = None
+    """
+    Value of the property
+    """
+
+    properties = None
+    """
+    dict of properties attached to the property
+    """
+
+    def __init__(self, label, value, properties=None):
+        self.label = label
+        self.value = value
+        self.properties = properties or {}
+
+    def __eq__(self, other):
+        return isinstance(other, VertexProperty) and self.label == other.label and self.value == other.value and self.properties == other.properties
+
+    def __repr__(self):
+        return "%s(%r, %r, %r)" % (self.__class__.__name__, self.label, self.value, self.properties)
+
+
+class Edge(Element):
+    """
+    Represents an Edge element from a graph query.
+
+    Attributes match initializer parameters.
+    """
+
+    element_type = 'edge'
+
+    _attrs = Element._attrs + ('inV', 'inVLabel', 'outV', 'outVLabel')
+
+    def __init__(self, id, label, type, properties,
+                 inV, inVLabel, outV, outVLabel):
+        super(Edge, self).__init__(id, label, type, properties)
+        self.inV = inV
+        self.inVLabel = inVLabel
+        self.outV = outV
+        self.outVLabel = outVLabel
+
+    def __repr__(self):
+        return "%s(%r, %r, %r, %r, %r, %r, %r, %r)" %\
+               (self.__class__.__name__,
+                self.id, self.label,
+                self.type, self.properties,
+                self.inV, self.inVLabel,
+                self.outV, self.outVLabel)
+
+
+class Path(object):
+    """
+    Represents a graph path.
+
+    Labels list is taken verbatim from the results.
+
+    Objects are either :class:`~.Result` or :class:`~.Vertex`/:class:`~.Edge` for recognized types
+    """
+
+    labels = None
+    """
+    List of labels in the path
+    """
+
+    objects = None
+    """
+    List of objects in the path
+    """
+
+    def __init__(self, labels, objects):
+        # TODO fix next major
+        # The Path class should not do any deserialization by itself. To fix in the next major.
+        from cassandra.datastax.graph.query import _graph_object_sequence
+        self.labels = labels
+        self.objects = list(_graph_object_sequence(objects))
+
+    def __eq__(self, other):
+        return self.labels == other.labels and self.objects == other.objects
+
+    def __str__(self):
+        return str({'labels': self.labels, 'objects': self.objects})
+
+    def __repr__(self):
+        return "%s(%r, %r)" % (self.__class__.__name__, self.labels, [o.value for o in self.objects])
+
+
+class T(object):
+    """
+    Represents a collection of tokens for more concise Traversal definitions.
+    """
+
+    name = None
+    val = None
+
+    # class attributes
+    id = None
+    """
+    """
+
+    key = None
+    """
+    """
+    label = None
+    """
+    """
+    value = None
+    """
+    """
+
+    def __init__(self, name, val):
+        self.name = name
+        self.val = val
+
+    def __str__(self):
+        return self.name
+
+    def __repr__(self):
+        return "T.%s" % (self.name, )
+
+
+T.id = T("id", 1)
+T.id_ = T("id_", 2)
+T.key = T("key", 3)
+T.label = T("label", 4)
+T.value = T("value", 5)
+
+T.name_to_value = {
+    'id': T.id,
+    'id_': T.id_,
+    'key': T.key,
+    'label': T.label,
+    'value': T.value
+}
diff --git a/llm/Lib/site-packages/cassandra/datastax/insights/__init__.py b/llm/Lib/site-packages/cassandra/datastax/insights/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b3d6d167181818d089d968c8a98883c59f98c074
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/insights/__init__.py
@@ -0,0 +1,13 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4f3b7536268697de6094a911cb69a3bdf1e30410
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/registry.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/registry.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1c01472466601085f4b82a394a6bc12f776cc62a
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/registry.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/reporter.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/reporter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..920dd3e06dae0e6da24abc0b2e607b8dd5dcd5f8
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/reporter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/serializers.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/serializers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c7dc36b64921c893e0f299ad5e74a63751a38add
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/serializers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/util.cpython-311.pyc b/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/util.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..89f734de0cb18d33c1eee80ab726f92eaa126fe5
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/datastax/insights/__pycache__/util.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/datastax/insights/registry.py b/llm/Lib/site-packages/cassandra/datastax/insights/registry.py
new file mode 100644
index 0000000000000000000000000000000000000000..d420eed915cece62858c7428f5892bf136c97d2a
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/insights/registry.py
@@ -0,0 +1,122 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from collections import OrderedDict
+from warnings import warn
+
+from cassandra.datastax.insights.util import namespace
+
+_NOT_SET = object()
+
+
+def _default_serializer_for_object(obj, policy):
+    # the insights server expects an 'options' dict for policy
+    # objects, but not for other objects
+    if policy:
+        return {'type': obj.__class__.__name__,
+                'namespace': namespace(obj.__class__),
+                'options': {}}
+    else:
+        return {'type': obj.__class__.__name__,
+                'namespace': namespace(obj.__class__)}
+
+
+class InsightsSerializerRegistry(object):
+
+    initialized = False
+
+    def __init__(self, mapping_dict=None):
+        mapping_dict = mapping_dict or {}
+        class_order = self._class_topological_sort(mapping_dict)
+        self._mapping_dict = OrderedDict(
+            ((cls, mapping_dict[cls]) for cls in class_order)
+        )
+
+    def serialize(self, obj, policy=False, default=_NOT_SET, cls=None):
+        try:
+            return self._get_serializer(cls if cls is not None else obj.__class__)(obj)
+        except Exception:
+            if default is _NOT_SET:
+                result = _default_serializer_for_object(obj, policy)
+            else:
+                result = default
+
+            return result
+
+    def _get_serializer(self, cls):
+        try:
+            return self._mapping_dict[cls]
+        except KeyError:
+            for registered_cls, serializer in self._mapping_dict.items():
+                if issubclass(cls, registered_cls):
+                    return self._mapping_dict[registered_cls]
+        raise ValueError
+
+    def register(self, cls, serializer):
+        self._mapping_dict[cls] = serializer
+        self._mapping_dict = OrderedDict(
+            ((cls, self._mapping_dict[cls])
+             for cls in self._class_topological_sort(self._mapping_dict))
+        )
+
+    def register_serializer_for(self, cls):
+        """
+        Parameterized registration helper decorator. Given a class `cls`,
+        produces a function that registers the decorated function as a
+        serializer for it.
+        """
+        def decorator(serializer):
+            self.register(cls, serializer)
+            return serializer
+
+        return decorator
+
+    @staticmethod
+    def _class_topological_sort(classes):
+        """
+        A simple topological sort for classes. Takes an iterable of class objects
+        and returns a list A of those classes, ordered such that A[X] is never a
+        superclass of A[Y] for X < Y.
+
+        This is an inefficient sort, but that's ok because classes are infrequently
+        registered. It's more important that this be maintainable than fast.
+
+        We can't use `.sort()` or `sorted()` with a custom `key` -- those assume
+        a total ordering, which we don't have.
+        """
+        unsorted, sorted_ = list(classes), []
+        while unsorted:
+            head, tail = unsorted[0], unsorted[1:]
+
+            # if head has no subclasses remaining, it can safely go in the list
+            if not any(issubclass(x, head) for x in tail):
+                sorted_.append(head)
+            else:
+                # move to the back -- head has to wait until all its subclasses
+                # are sorted into the list
+                tail.append(head)
+
+            unsorted = tail
+
+        # check that sort is valid
+        for i, head in enumerate(sorted_):
+            for after_head_value in sorted_[(i + 1):]:
+                if issubclass(after_head_value, head):
+                    warn('Sorting classes produced an invalid ordering.\n'
+                         'In:  {classes}\n'
+                         'Out: {sorted_}'.format(classes=classes, sorted_=sorted_))
+        return sorted_
+
+
+insights_registry = InsightsSerializerRegistry()
diff --git a/llm/Lib/site-packages/cassandra/datastax/insights/reporter.py b/llm/Lib/site-packages/cassandra/datastax/insights/reporter.py
new file mode 100644
index 0000000000000000000000000000000000000000..b59422b110b25257593c15bd3e57298e92951168
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/insights/reporter.py
@@ -0,0 +1,221 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from collections import Counter
+import datetime
+import json
+import logging
+import multiprocessing
+import random
+import platform
+import socket
+import ssl
+import sys
+from threading import Event, Thread
+import time
+
+from cassandra.policies import HostDistance
+from cassandra.util import ms_timestamp_from_datetime
+from cassandra.datastax.insights.registry import insights_registry
+from cassandra.datastax.insights.serializers  import initialize_registry
+
+log = logging.getLogger(__name__)
+
+
+class MonitorReporter(Thread):
+
+    def __init__(self, interval_sec, session):
+        """
+        takes an int indicating interval between requests, a function returning
+        the connection to be used, and the timeout per request
+        """
+        # Thread is an old-style class so we can't super()
+        Thread.__init__(self, name='monitor_reporter')
+
+        initialize_registry(insights_registry)
+
+        self._interval, self._session = interval_sec, session
+
+        self._shutdown_event = Event()
+        self.daemon = True
+        self.start()
+
+    def run(self):
+        self._send_via_rpc(self._get_startup_data())
+
+        # introduce some jitter -- send up to 1/10 of _interval early
+        self._shutdown_event.wait(self._interval * random.uniform(.9, 1))
+
+        while not self._shutdown_event.is_set():
+            start_time = time.time()
+
+            self._send_via_rpc(self._get_status_data())
+
+            elapsed = time.time() - start_time
+            self._shutdown_event.wait(max(self._interval - elapsed, 0.01))
+
+    # TODO: redundant with ConnectionHeartbeat.ShutdownException
+    class ShutDownException(Exception):
+        pass
+
+    def _send_via_rpc(self, data):
+        try:
+            self._session.execute(
+                "CALL InsightsRpc.reportInsight(%s)", (json.dumps(data),)
+            )
+            log.debug('Insights RPC data: {}'.format(data))
+        except Exception as e:
+            log.debug('Insights RPC send failed with {}'.format(e))
+            log.debug('Insights RPC data: {}'.format(data))
+
+    def _get_status_data(self):
+        cc = self._session.cluster.control_connection
+
+        connected_nodes = {
+            host.address: {
+                'connections': state['open_count'],
+                'inFlightQueries': state['in_flights']
+            }
+            for (host, state) in self._session.get_pool_state().items()
+        }
+
+        return {
+            'metadata': {
+                # shared across drivers; never change
+                'name': 'driver.status',
+                # format version
+                'insightMappingId': 'v1',
+                'insightType': 'EVENT',
+                # since epoch
+                'timestamp': ms_timestamp_from_datetime(datetime.datetime.utcnow()),
+                'tags': {
+                    'language': 'python'
+                }
+            },
+            # // 'clientId', 'sessionId' and 'controlConnection' are mandatory
+            # // the rest of the properties are optional
+            'data': {
+                # // 'clientId' must be the same as the one provided in the startup message
+                'clientId': str(self._session.cluster.client_id),
+                # // 'sessionId' must be the same as the one provided in the startup message
+                'sessionId': str(self._session.session_id),
+                'controlConnection': cc._connection.host if cc._connection else None,
+                'connectedNodes': connected_nodes
+            }
+        }
+
+    def _get_startup_data(self):
+        cc = self._session.cluster.control_connection
+        try:
+            local_ipaddr = cc._connection._socket.getsockname()[0]
+        except Exception as e:
+            local_ipaddr = None
+            log.debug('Unable to get local socket addr from {}: {}'.format(cc._connection, e))
+        hostname = socket.getfqdn()
+
+        host_distances_counter = Counter(
+            self._session.cluster.profile_manager.distance(host)
+            for host in self._session.hosts
+        )
+        host_distances_dict = {
+            'local': host_distances_counter[HostDistance.LOCAL],
+            'remote': host_distances_counter[HostDistance.REMOTE],
+            'ignored': host_distances_counter[HostDistance.IGNORED]
+        }
+
+        try:
+            compression_type = cc._connection._compression_type
+        except AttributeError:
+            compression_type = 'NONE'
+
+        cert_validation = None
+        try:
+            if self._session.cluster.ssl_context:
+                if isinstance(self._session.cluster.ssl_context, ssl.SSLContext):
+                    cert_validation = self._session.cluster.ssl_context.verify_mode == ssl.CERT_REQUIRED
+                else:  # pyopenssl
+                    from OpenSSL import SSL
+                    cert_validation = self._session.cluster.ssl_context.get_verify_mode() != SSL.VERIFY_NONE
+            elif self._session.cluster.ssl_options:
+                cert_validation = self._session.cluster.ssl_options.get('cert_reqs') == ssl.CERT_REQUIRED
+        except Exception as e:
+            log.debug('Unable to get the cert validation: {}'.format(e))
+
+        uname_info = platform.uname()
+
+        return {
+            'metadata': {
+                'name': 'driver.startup',
+                'insightMappingId': 'v1',
+                'insightType': 'EVENT',
+                'timestamp': ms_timestamp_from_datetime(datetime.datetime.utcnow()),
+                'tags': {
+                    'language': 'python'
+                },
+            },
+            'data': {
+                'driverName': 'DataStax Python Driver',
+                'driverVersion': sys.modules['cassandra'].__version__,
+                'clientId': str(self._session.cluster.client_id),
+                'sessionId': str(self._session.session_id),
+                'applicationName': self._session.cluster.application_name or 'python',
+                'applicationNameWasGenerated': not self._session.cluster.application_name,
+                'applicationVersion': self._session.cluster.application_version,
+                'contactPoints': self._session.cluster._endpoint_map_for_insights,
+                'dataCenters': list(set(h.datacenter for h in self._session.cluster.metadata.all_hosts()
+                                        if (h.datacenter and
+                                            self._session.cluster.profile_manager.distance(h) == HostDistance.LOCAL))),
+                'initialControlConnection': cc._connection.host if cc._connection else None,
+                'protocolVersion': self._session.cluster.protocol_version,
+                'localAddress': local_ipaddr,
+                'hostName': hostname,
+                'executionProfiles': insights_registry.serialize(self._session.cluster.profile_manager),
+                'configuredConnectionLength': host_distances_dict,
+                'heartbeatInterval': self._session.cluster.idle_heartbeat_interval,
+                'compression': compression_type.upper() if compression_type else 'NONE',
+                'reconnectionPolicy': insights_registry.serialize(self._session.cluster.reconnection_policy),
+                'sslConfigured': {
+                    'enabled': bool(self._session.cluster.ssl_options or self._session.cluster.ssl_context),
+                    'certValidation': cert_validation
+                },
+                'authProvider': {
+                    'type': (self._session.cluster.auth_provider.__class__.__name__
+                             if self._session.cluster.auth_provider else
+                             None)
+                },
+                'otherOptions': {
+                },
+                'platformInfo': {
+                    'os': {
+                        'name': uname_info.system,
+                        'version': uname_info.release,
+                        'arch': uname_info.machine
+                    },
+                    'cpus': {
+                        'length': multiprocessing.cpu_count(),
+                        'model': platform.processor()
+                    },
+                    'runtime': {
+                        'python': sys.version,
+                        'event_loop': self._session.cluster.connection_class.__name__
+                    }
+                },
+                'periodicStatusInterval': self._interval
+            }
+        }
+
+    def stop(self):
+        log.debug("Shutting down Monitor Reporter")
+        self._shutdown_event.set()
+        self.join()
diff --git a/llm/Lib/site-packages/cassandra/datastax/insights/serializers.py b/llm/Lib/site-packages/cassandra/datastax/insights/serializers.py
new file mode 100644
index 0000000000000000000000000000000000000000..f65e9b5c9e3cd958c83473d40eb2a0320812f509
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/insights/serializers.py
@@ -0,0 +1,219 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def initialize_registry(insights_registry):
+    # This will be called from the cluster module, so we put all this behavior
+    # in a function to avoid circular imports
+
+    if insights_registry.initialized:
+        return False
+
+    from cassandra import ConsistencyLevel
+    from cassandra.cluster import (
+        ExecutionProfile, GraphExecutionProfile,
+        ProfileManager, ContinuousPagingOptions,
+        EXEC_PROFILE_DEFAULT, EXEC_PROFILE_GRAPH_DEFAULT,
+        EXEC_PROFILE_GRAPH_ANALYTICS_DEFAULT,
+        EXEC_PROFILE_GRAPH_SYSTEM_DEFAULT,
+        _NOT_SET
+    )
+    from cassandra.datastax.graph import GraphOptions
+    from cassandra.datastax.insights.registry import insights_registry
+    from cassandra.datastax.insights.util import namespace
+    from cassandra.policies import (
+        RoundRobinPolicy,
+        DCAwareRoundRobinPolicy,
+        TokenAwarePolicy,
+        WhiteListRoundRobinPolicy,
+        HostFilterPolicy,
+        ConstantReconnectionPolicy,
+        ExponentialReconnectionPolicy,
+        RetryPolicy,
+        SpeculativeExecutionPolicy,
+        ConstantSpeculativeExecutionPolicy,
+        WrapperPolicy
+    )
+
+    import logging
+
+    log = logging.getLogger(__name__)
+
+    @insights_registry.register_serializer_for(RoundRobinPolicy)
+    def round_robin_policy_insights_serializer(policy):
+        return {'type': policy.__class__.__name__,
+                'namespace': namespace(policy.__class__),
+                'options': {}}
+
+    @insights_registry.register_serializer_for(DCAwareRoundRobinPolicy)
+    def dc_aware_round_robin_policy_insights_serializer(policy):
+        return {'type': policy.__class__.__name__,
+                'namespace': namespace(policy.__class__),
+                'options': {'local_dc': policy.local_dc,
+                            'used_hosts_per_remote_dc': policy.used_hosts_per_remote_dc}
+                }
+
+    @insights_registry.register_serializer_for(TokenAwarePolicy)
+    def token_aware_policy_insights_serializer(policy):
+        return {'type': policy.__class__.__name__,
+                'namespace': namespace(policy.__class__),
+                'options': {'child_policy': insights_registry.serialize(policy._child_policy,
+                                                                        policy=True),
+                            'shuffle_replicas': policy.shuffle_replicas}
+                }
+
+    @insights_registry.register_serializer_for(WhiteListRoundRobinPolicy)
+    def whitelist_round_robin_policy_insights_serializer(policy):
+        return {'type': policy.__class__.__name__,
+                'namespace': namespace(policy.__class__),
+                'options': {'allowed_hosts': policy._allowed_hosts}
+                }
+
+    @insights_registry.register_serializer_for(HostFilterPolicy)
+    def host_filter_policy_insights_serializer(policy):
+        return {
+            'type': policy.__class__.__name__,
+            'namespace': namespace(policy.__class__),
+            'options': {'child_policy': insights_registry.serialize(policy._child_policy,
+                                                                    policy=True),
+                        'predicate': policy.predicate.__name__}
+        }
+
+    @insights_registry.register_serializer_for(ConstantReconnectionPolicy)
+    def constant_reconnection_policy_insights_serializer(policy):
+        return {'type': policy.__class__.__name__,
+                'namespace': namespace(policy.__class__),
+                'options': {'delay': policy.delay,
+                            'max_attempts': policy.max_attempts}
+                }
+
+    @insights_registry.register_serializer_for(ExponentialReconnectionPolicy)
+    def exponential_reconnection_policy_insights_serializer(policy):
+        return {'type': policy.__class__.__name__,
+                'namespace': namespace(policy.__class__),
+                'options': {'base_delay': policy.base_delay,
+                            'max_delay': policy.max_delay,
+                            'max_attempts': policy.max_attempts}
+                }
+
+    @insights_registry.register_serializer_for(RetryPolicy)
+    def retry_policy_insights_serializer(policy):
+        return {'type': policy.__class__.__name__,
+                'namespace': namespace(policy.__class__),
+                'options': {}}
+
+    @insights_registry.register_serializer_for(SpeculativeExecutionPolicy)
+    def speculative_execution_policy_insights_serializer(policy):
+        return {'type': policy.__class__.__name__,
+                'namespace': namespace(policy.__class__),
+                'options': {}}
+
+    @insights_registry.register_serializer_for(ConstantSpeculativeExecutionPolicy)
+    def constant_speculative_execution_policy_insights_serializer(policy):
+        return {'type': policy.__class__.__name__,
+                'namespace': namespace(policy.__class__),
+                    'options': {'delay': policy.delay,
+                                'max_attempts': policy.max_attempts}
+                }
+
+    @insights_registry.register_serializer_for(WrapperPolicy)
+    def wrapper_policy_insights_serializer(policy):
+        return {'type': policy.__class__.__name__,
+                'namespace': namespace(policy.__class__),
+                'options': {
+                    'child_policy': insights_registry.serialize(policy._child_policy,
+                                                                policy=True)
+                }}
+
+    @insights_registry.register_serializer_for(ExecutionProfile)
+    def execution_profile_insights_serializer(profile):
+        return {
+            'loadBalancing': insights_registry.serialize(profile.load_balancing_policy,
+                                                         policy=True),
+            'retry': insights_registry.serialize(profile.retry_policy,
+                                                 policy=True),
+            'readTimeout': profile.request_timeout,
+            'consistency': ConsistencyLevel.value_to_name.get(profile.consistency_level, None),
+            'serialConsistency': ConsistencyLevel.value_to_name.get(profile.serial_consistency_level, None),
+            'continuousPagingOptions': (insights_registry.serialize(profile.continuous_paging_options)
+                                        if (profile.continuous_paging_options is not None and
+                                           profile.continuous_paging_options is not _NOT_SET) else
+                                        None),
+            'speculativeExecution': insights_registry.serialize(profile.speculative_execution_policy),
+            'graphOptions': None
+        }
+
+    @insights_registry.register_serializer_for(GraphExecutionProfile)
+    def graph_execution_profile_insights_serializer(profile):
+        rv = insights_registry.serialize(profile, cls=ExecutionProfile)
+        rv['graphOptions'] = insights_registry.serialize(profile.graph_options)
+        return rv
+
+    _EXEC_PROFILE_DEFAULT_KEYS = (EXEC_PROFILE_DEFAULT,
+                                  EXEC_PROFILE_GRAPH_DEFAULT,
+                                  EXEC_PROFILE_GRAPH_SYSTEM_DEFAULT,
+                                  EXEC_PROFILE_GRAPH_ANALYTICS_DEFAULT)
+
+    @insights_registry.register_serializer_for(ProfileManager)
+    def profile_manager_insights_serializer(manager):
+        defaults = {
+            # Insights's expected default
+            'default': insights_registry.serialize(manager.profiles[EXEC_PROFILE_DEFAULT]),
+            # remaining named defaults for driver's defaults, including duplicated default
+            'EXEC_PROFILE_DEFAULT': insights_registry.serialize(manager.profiles[EXEC_PROFILE_DEFAULT]),
+            'EXEC_PROFILE_GRAPH_DEFAULT': insights_registry.serialize(manager.profiles[EXEC_PROFILE_GRAPH_DEFAULT]),
+            'EXEC_PROFILE_GRAPH_SYSTEM_DEFAULT': insights_registry.serialize(
+                manager.profiles[EXEC_PROFILE_GRAPH_SYSTEM_DEFAULT]
+            ),
+            'EXEC_PROFILE_GRAPH_ANALYTICS_DEFAULT': insights_registry.serialize(
+                manager.profiles[EXEC_PROFILE_GRAPH_ANALYTICS_DEFAULT]
+            )
+        }
+        other = {
+            key: insights_registry.serialize(value)
+            for key, value in manager.profiles.items()
+            if key not in _EXEC_PROFILE_DEFAULT_KEYS
+        }
+        overlapping_keys = set(defaults) & set(other)
+        if overlapping_keys:
+            log.debug('The following key names overlap default key sentinel keys '
+                      'and these non-default EPs will not be displayed in Insights '
+                      ': {}'.format(list(overlapping_keys)))
+
+        other.update(defaults)
+        return other
+
+    @insights_registry.register_serializer_for(GraphOptions)
+    def graph_options_insights_serializer(options):
+        rv = {
+            'source': options.graph_source,
+            'language': options.graph_language,
+            'graphProtocol': options.graph_protocol
+        }
+        updates = {k: v.decode('utf-8') for k, v in rv.items()
+                   if isinstance(v, bytes)}
+        rv.update(updates)
+        return rv
+
+    @insights_registry.register_serializer_for(ContinuousPagingOptions)
+    def continuous_paging_options_insights_serializer(paging_options):
+        return {
+                'page_unit': paging_options.page_unit,
+                'max_pages': paging_options.max_pages,
+                'max_pages_per_second': paging_options.max_pages_per_second,
+                'max_queue_size': paging_options.max_queue_size
+        }
+
+    insights_registry.initialized = True
+    return True
diff --git a/llm/Lib/site-packages/cassandra/datastax/insights/util.py b/llm/Lib/site-packages/cassandra/datastax/insights/util.py
new file mode 100644
index 0000000000000000000000000000000000000000..6cc396e1261f66badfbfa1a38f5c868de2d930fc
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/datastax/insights/util.py
@@ -0,0 +1,75 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import traceback
+from warnings import warn
+
+from cassandra.util import Version
+
+
+DSE_60 = Version('6.0.0')
+DSE_51_MIN_SUPPORTED = Version('5.1.13')
+DSE_60_MIN_SUPPORTED = Version('6.0.5')
+
+
+log = logging.getLogger(__name__)
+
+
+def namespace(cls):
+    """
+    Best-effort method for getting the namespace in which a class is defined.
+    """
+    try:
+        # __module__ can be None
+        module = cls.__module__ or ''
+    except Exception:
+        warn("Unable to obtain namespace for {cls} for Insights, returning ''. "
+             "Exception: \n{e}".format(e=traceback.format_exc(), cls=cls))
+        module = ''
+
+    module_internal_namespace = _module_internal_namespace_or_emtpy_string(cls)
+    if module_internal_namespace:
+        return '.'.join((module, module_internal_namespace))
+    return module
+
+
+def _module_internal_namespace_or_emtpy_string(cls):
+    """
+    Best-effort method for getting the module-internal namespace in which a
+    class is defined -- i.e. the namespace _inside_ the module.
+    """
+    try:
+        qualname = cls.__qualname__
+    except AttributeError:
+        return ''
+
+    return '.'.join(
+        # the last segment is the name of the class -- use everything else
+        qualname.split('.')[:-1]
+    )
+
+
+def version_supports_insights(dse_version):
+    if dse_version:
+        try:
+            dse_version = Version(dse_version)
+            return (DSE_51_MIN_SUPPORTED <= dse_version < DSE_60
+                    or
+                    DSE_60_MIN_SUPPORTED <= dse_version)
+        except Exception:
+            warn("Unable to check version {v} for Insights compatibility, returning False. "
+                 "Exception: \n{e}".format(e=traceback.format_exc(), v=dse_version))
+
+    return False
diff --git a/llm/Lib/site-packages/cassandra/deserializers.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/deserializers.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..cbaa30706126fd5fd324277e21476be3969708f0
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/deserializers.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/deserializers.pxd b/llm/Lib/site-packages/cassandra/deserializers.pxd
new file mode 100644
index 0000000000000000000000000000000000000000..73adad138bb66d8f32527c3f5c74ca013daab71a
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/deserializers.pxd
@@ -0,0 +1,43 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from cassandra.buffer cimport Buffer
+
+cdef class Deserializer:
+    # The cqltypes._CassandraType corresponding to this deserializer
+    cdef object cqltype
+
+    # String may be empty, whereas other values may not be.
+    # Other values may be NULL, in which case the integer length
+    # of the binary data is negative. However, non-string types
+    # may also return a zero length for legacy reasons
+    # (see http://code.metager.de/source/xref/apache/cassandra/doc/native_protocol_v3.spec
+    # paragraph 6)
+    cdef bint empty_binary_ok
+
+    cdef deserialize(self, Buffer *buf, int protocol_version)
+    # cdef deserialize(self, CString byts, protocol_version)
+
+
+cdef inline object from_binary(Deserializer deserializer,
+                               Buffer *buf,
+                               int protocol_version):
+    if buf.size < 0:
+        return None
+    elif buf.size == 0 and not deserializer.empty_binary_ok:
+        return _ret_empty(deserializer, buf.size)
+    else:
+        return deserializer.deserialize(buf, protocol_version)
+
+cdef _ret_empty(Deserializer deserializer, Py_ssize_t buf_size)
diff --git a/llm/Lib/site-packages/cassandra/deserializers.pyx b/llm/Lib/site-packages/cassandra/deserializers.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..cb1d44b4c458628bfc14f1f89355d62a01ed9a61
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/deserializers.pyx
@@ -0,0 +1,517 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from libc.stdint cimport int32_t, uint16_t
+
+include 'cython_marshal.pyx'
+from cassandra.buffer cimport Buffer, to_bytes, slice_buffer
+from cassandra.cython_utils cimport datetime_from_timestamp
+
+from cython.view cimport array as cython_array
+from cassandra.tuple cimport tuple_new, tuple_set
+
+import socket
+from decimal import Decimal
+from uuid import UUID
+
+from cassandra import cqltypes
+from cassandra import util
+
+cdef class Deserializer:
+    """Cython-based deserializer class for a cqltype"""
+
+    def __init__(self, cqltype):
+        self.cqltype = cqltype
+        self.empty_binary_ok = cqltype.empty_binary_ok
+
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        raise NotImplementedError
+
+
+cdef class DesBytesType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        if buf.size == 0:
+            return b""
+        return to_bytes(buf)
+
+# this is to facilitate cqlsh integration, which requires bytearrays for BytesType
+# It is switched in by simply overwriting DesBytesType:
+# deserializers.DesBytesType = deserializers.DesBytesTypeByteArray
+cdef class DesBytesTypeByteArray(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        if buf.size == 0:
+            return bytearray()
+        return bytearray(buf.ptr[:buf.size])
+
+# TODO: Use libmpdec: http://www.bytereef.org/mpdecimal/index.html
+cdef class DesDecimalType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        cdef Buffer varint_buf
+        slice_buffer(buf, &varint_buf, 4, buf.size - 4)
+
+        cdef int32_t scale = unpack_num[int32_t](buf)
+        unscaled = varint_unpack(&varint_buf)
+
+        return Decimal('%de%d' % (unscaled, -scale))
+
+
+cdef class DesUUIDType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return UUID(bytes=to_bytes(buf))
+
+
+cdef class DesBooleanType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        if unpack_num[int8_t](buf):
+            return True
+        return False
+
+
+cdef class DesByteType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return unpack_num[int8_t](buf)
+
+
+cdef class DesAsciiType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        if buf.size == 0:
+            return ""
+        return to_bytes(buf).decode('ascii')
+
+
+cdef class DesFloatType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return unpack_num[float](buf)
+
+
+cdef class DesDoubleType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return unpack_num[double](buf)
+
+
+cdef class DesLongType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return unpack_num[int64_t](buf)
+
+
+cdef class DesInt32Type(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return unpack_num[int32_t](buf)
+
+
+cdef class DesIntegerType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return varint_unpack(buf)
+
+
+cdef class DesInetAddressType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        cdef bytes byts = to_bytes(buf)
+
+        # TODO: optimize inet_ntop, inet_ntoa
+        if buf.size == 16:
+            return util.inet_ntop(socket.AF_INET6, byts)
+        else:
+            # util.inet_pton could also handle, but this is faster
+            # since we've already determined the AF
+            return socket.inet_ntoa(byts)
+
+
+cdef class DesCounterColumnType(DesLongType):
+    pass
+
+
+cdef class DesDateType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        cdef double timestamp = unpack_num[int64_t](buf) / 1000.0
+        return datetime_from_timestamp(timestamp)
+
+
+cdef class TimestampType(DesDateType):
+    pass
+
+
+cdef class TimeUUIDType(DesDateType):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return UUID(bytes=to_bytes(buf))
+
+
+# Values of the 'date'` type are encoded as 32-bit unsigned integers
+# representing a number of days with epoch (January 1st, 1970) at the center of the
+# range (2^31).
+EPOCH_OFFSET_DAYS = 2 ** 31
+
+cdef class DesSimpleDateType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        days = unpack_num[uint32_t](buf) - EPOCH_OFFSET_DAYS
+        return util.Date(days)
+
+
+cdef class DesShortType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return unpack_num[int16_t](buf)
+
+
+cdef class DesTimeType(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return util.Time(unpack_num[int64_t](buf))
+
+
+cdef class DesUTF8Type(Deserializer):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        if buf.size == 0:
+            return ""
+        cdef val = to_bytes(buf)
+        return val.decode('utf8')
+
+
+cdef class DesVarcharType(DesUTF8Type):
+    pass
+
+
+cdef class _DesParameterizedType(Deserializer):
+
+    cdef object subtypes
+    cdef Deserializer[::1] deserializers
+    cdef Py_ssize_t subtypes_len
+
+    def __init__(self, cqltype):
+        super().__init__(cqltype)
+        self.subtypes = cqltype.subtypes
+        self.deserializers = make_deserializers(cqltype.subtypes)
+        self.subtypes_len = len(self.subtypes)
+
+
+cdef class _DesSingleParamType(_DesParameterizedType):
+    cdef Deserializer deserializer
+
+    def __init__(self, cqltype):
+        assert cqltype.subtypes and len(cqltype.subtypes) == 1, cqltype.subtypes
+        super().__init__(cqltype)
+        self.deserializer = self.deserializers[0]
+
+
+#--------------------------------------------------------------------------
+# List and set deserialization
+
+cdef class DesListType(_DesSingleParamType):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        cdef uint16_t v2_and_below = 2
+        cdef int32_t v3_and_above = 3
+
+        if protocol_version >= 3:
+            result = _deserialize_list_or_set[int32_t](
+                v3_and_above, buf, protocol_version, self.deserializer)
+        else:
+            result = _deserialize_list_or_set[uint16_t](
+                v2_and_below, buf, protocol_version, self.deserializer)
+
+        return result
+
+cdef class DesSetType(DesListType):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return util.sortedset(DesListType.deserialize(self, buf, protocol_version))
+
+
+ctypedef fused itemlen_t:
+    uint16_t # protocol <= v2
+    int32_t  # protocol >= v3
+
+cdef list _deserialize_list_or_set(itemlen_t dummy_version,
+                                   Buffer *buf, int protocol_version,
+                                   Deserializer deserializer):
+    """
+    Deserialize a list or set.
+
+    The 'dummy' parameter is needed to make fused types work, so that
+    we can specialize on the protocol version.
+    """
+    cdef Buffer itemlen_buf
+    cdef Buffer elem_buf
+
+    cdef itemlen_t numelements
+    cdef int offset
+    cdef list result = []
+
+    _unpack_len[itemlen_t](buf, 0, &numelements)
+    offset = sizeof(itemlen_t)
+    protocol_version = max(3, protocol_version)
+    for _ in range(numelements):
+        subelem[itemlen_t](buf, &elem_buf, &offset, dummy_version)
+        result.append(from_binary(deserializer, &elem_buf, protocol_version))
+
+    return result
+
+
+cdef inline int subelem(
+        Buffer *buf, Buffer *elem_buf, int* offset, itemlen_t dummy) except -1:
+    """
+    Read the next element from the buffer: first read the size (in bytes) of the
+    element, then fill elem_buf with a newly sliced buffer of this size (and the
+    right offset).
+    """
+    cdef itemlen_t elemlen
+
+    _unpack_len[itemlen_t](buf, offset[0], &elemlen)
+    offset[0] += sizeof(itemlen_t)
+    slice_buffer(buf, elem_buf, offset[0], elemlen)
+    offset[0] += elemlen
+    return 0
+
+
+cdef int _unpack_len(Buffer *buf, int offset, itemlen_t *output) except -1:
+    cdef Buffer itemlen_buf
+    slice_buffer(buf, &itemlen_buf, offset, sizeof(itemlen_t))
+
+    if itemlen_t is uint16_t:
+        output[0] = unpack_num[uint16_t](&itemlen_buf)
+    else:
+        output[0] = unpack_num[int32_t](&itemlen_buf)
+
+    return 0
+
+#--------------------------------------------------------------------------
+# Map deserialization
+
+cdef class DesMapType(_DesParameterizedType):
+
+    cdef Deserializer key_deserializer, val_deserializer
+
+    def __init__(self, cqltype):
+        super().__init__(cqltype)
+        self.key_deserializer = self.deserializers[0]
+        self.val_deserializer = self.deserializers[1]
+
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        cdef uint16_t v2_and_below = 0
+        cdef int32_t v3_and_above = 0
+        key_type, val_type = self.cqltype.subtypes
+
+        if protocol_version >= 3:
+            result = _deserialize_map[int32_t](
+                v3_and_above, buf, protocol_version,
+                self.key_deserializer, self.val_deserializer,
+                key_type, val_type)
+        else:
+            result = _deserialize_map[uint16_t](
+                v2_and_below, buf, protocol_version,
+                self.key_deserializer, self.val_deserializer,
+                key_type, val_type)
+
+        return result
+
+
+cdef _deserialize_map(itemlen_t dummy_version,
+                      Buffer *buf, int protocol_version,
+                      Deserializer key_deserializer, Deserializer val_deserializer,
+                      key_type, val_type):
+    cdef Buffer key_buf, val_buf
+    cdef Buffer itemlen_buf
+
+    cdef itemlen_t numelements
+    cdef int offset
+    cdef list result = []
+
+    _unpack_len[itemlen_t](buf, 0, &numelements)
+    offset = sizeof(itemlen_t)
+    themap = util.OrderedMapSerializedKey(key_type, protocol_version)
+    protocol_version = max(3, protocol_version)
+    for _ in range(numelements):
+        subelem[itemlen_t](buf, &key_buf, &offset, dummy_version)
+        subelem[itemlen_t](buf, &val_buf, &offset, numelements)
+        key = from_binary(key_deserializer, &key_buf, protocol_version)
+        val = from_binary(val_deserializer, &val_buf, protocol_version)
+        themap._insert_unchecked(key, to_bytes(&key_buf), val)
+
+    return themap
+
+#--------------------------------------------------------------------------
+
+cdef class DesTupleType(_DesParameterizedType):
+
+    # TODO: Use TupleRowParser to parse these tuples
+
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        cdef Py_ssize_t i, p
+        cdef int32_t itemlen
+        cdef tuple res = tuple_new(self.subtypes_len)
+        cdef Buffer item_buf
+        cdef Buffer itemlen_buf
+        cdef Deserializer deserializer
+
+        # collections inside UDTs are always encoded with at least the
+        # version 3 format
+        protocol_version = max(3, protocol_version)
+
+        p = 0
+        values = []
+        for i in range(self.subtypes_len):
+            item = None
+            if p < buf.size:
+                slice_buffer(buf, &itemlen_buf, p, 4)
+                itemlen = unpack_num[int32_t](&itemlen_buf)
+                p += 4
+                if itemlen >= 0:
+                    slice_buffer(buf, &item_buf, p, itemlen)
+                    p += itemlen
+
+                    deserializer = self.deserializers[i]
+                    item = from_binary(deserializer, &item_buf, protocol_version)
+
+            tuple_set(res, i, item)
+
+        return res
+
+
+cdef class DesUserType(DesTupleType):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        typ = self.cqltype
+        values = DesTupleType.deserialize(self, buf, protocol_version)
+        if typ.mapped_class:
+            return typ.mapped_class(**dict(zip(typ.fieldnames, values)))
+        elif typ.tuple_type:
+            return typ.tuple_type(*values)
+        else:
+            return tuple(values)
+
+
+cdef class DesCompositeType(_DesParameterizedType):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        cdef Py_ssize_t i, idx, start
+        cdef Buffer elem_buf
+        cdef int16_t element_length
+        cdef Deserializer deserializer
+        cdef tuple res = tuple_new(self.subtypes_len)
+
+        idx = 0
+        for i in range(self.subtypes_len):
+            if not buf.size:
+                # CompositeType can have missing elements at the end
+
+                # Fill the tuple with None values and slice it
+                #
+                # (I'm not sure a tuple needs to be fully initialized before
+                #  it can be destroyed, so play it safe)
+                for j in range(i, self.subtypes_len):
+                    tuple_set(res, j, None)
+                res = res[:i]
+                break
+
+            element_length = unpack_num[uint16_t](buf)
+            slice_buffer(buf, &elem_buf, 2, element_length)
+
+            deserializer = self.deserializers[i]
+            item = from_binary(deserializer, &elem_buf, protocol_version)
+            tuple_set(res, i, item)
+
+            # skip element length, element, and the EOC (one byte)
+            start = 2 + element_length + 1
+            slice_buffer(buf, buf, start, buf.size - start)
+
+        return res
+
+
+DesDynamicCompositeType = DesCompositeType
+
+
+cdef class DesReversedType(_DesSingleParamType):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return from_binary(self.deserializer, buf, protocol_version)
+
+
+cdef class DesFrozenType(_DesSingleParamType):
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return from_binary(self.deserializer, buf, protocol_version)
+
+#--------------------------------------------------------------------------
+
+cdef _ret_empty(Deserializer deserializer, Py_ssize_t buf_size):
+    """
+    Decide whether to return None or EMPTY when a buffer size is
+    zero or negative. This is used by from_binary in deserializers.pxd.
+    """
+    if buf_size < 0:
+        return None
+    elif deserializer.cqltype.support_empty_values:
+        return cqltypes.EMPTY
+    else:
+        return None
+
+#--------------------------------------------------------------------------
+# Generic deserialization
+
+cdef class GenericDeserializer(Deserializer):
+    """
+    Wrap a generic datatype for deserialization
+    """
+
+    cdef deserialize(self, Buffer *buf, int protocol_version):
+        return self.cqltype.deserialize(to_bytes(buf), protocol_version)
+
+    def __repr__(self):
+        return "GenericDeserializer(%s)" % (self.cqltype,)
+
+#--------------------------------------------------------------------------
+# Helper utilities
+
+def make_deserializers(cqltypes):
+    """Create an array of Deserializers for each given cqltype in cqltypes"""
+    cdef Deserializer[::1] deserializers
+    return obj_array([find_deserializer(ct) for ct in cqltypes])
+
+
+cdef dict classes = globals()
+
+cpdef Deserializer find_deserializer(cqltype):
+    """Find a deserializer for a cqltype"""
+    name = 'Des' + cqltype.__name__
+
+    if name in globals():
+        cls = classes[name]
+    elif issubclass(cqltype, cqltypes.ListType):
+        cls = DesListType
+    elif issubclass(cqltype, cqltypes.SetType):
+        cls = DesSetType
+    elif issubclass(cqltype, cqltypes.MapType):
+        cls = DesMapType
+    elif issubclass(cqltype, cqltypes.UserType):
+        # UserType is a subclass of TupleType, so should precede it
+        cls = DesUserType
+    elif issubclass(cqltype, cqltypes.TupleType):
+        cls = DesTupleType
+    elif issubclass(cqltype, cqltypes.DynamicCompositeType):
+        # DynamicCompositeType is a subclass of CompositeType, so should precede it
+        cls = DesDynamicCompositeType
+    elif issubclass(cqltype, cqltypes.CompositeType):
+        cls = DesCompositeType
+    elif issubclass(cqltype, cqltypes.ReversedType):
+        cls = DesReversedType
+    elif issubclass(cqltype, cqltypes.FrozenType):
+        cls = DesFrozenType
+    else:
+        cls = GenericDeserializer
+
+    return cls(cqltype)
+
+
+def obj_array(list objs):
+    """Create a (Cython) array of objects given a list of objects"""
+    cdef object[:] arr
+    cdef Py_ssize_t i
+    arr = cython_array(shape=(len(objs),), itemsize=sizeof(void *), format="O")
+    # arr[:] = objs # This does not work (segmentation faults)
+    for i, obj in enumerate(objs):
+        arr[i] = obj
+    return arr
diff --git a/llm/Lib/site-packages/cassandra/encoder.py b/llm/Lib/site-packages/cassandra/encoder.py
new file mode 100644
index 0000000000000000000000000000000000000000..2b799149ff894a606972b881619f05c65b368db5
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/encoder.py
@@ -0,0 +1,219 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""
+These functions are used to convert Python objects into CQL strings.
+When non-prepared statements are executed, these encoder functions are
+called on each query parameter.
+"""
+
+import logging
+log = logging.getLogger(__name__)
+
+from binascii import hexlify
+import calendar
+import datetime
+import math
+import sys
+import types
+from uuid import UUID
+import ipaddress
+
+from cassandra.util import (OrderedDict, OrderedMap, OrderedMapSerializedKey,
+                            sortedset, Time, Date, Point, LineString, Polygon)
+
+
+def cql_quote(term):
+    if isinstance(term, str):
+        return "'%s'" % str(term).replace("'", "''")
+    else:
+        return str(term)
+
+
+class ValueSequence(list):
+    pass
+
+
+class Encoder(object):
+    """
+    A container for mapping python types to CQL string literals when working
+    with non-prepared statements.  The type :attr:`~.Encoder.mapping` can be
+    directly customized by users.
+    """
+
+    mapping = None
+    """
+    A map of python types to encoder functions.
+    """
+
+    def __init__(self):
+        self.mapping = {
+            float: self.cql_encode_float,
+            bytearray: self.cql_encode_bytes,
+            str: self.cql_encode_str,
+            int: self.cql_encode_object,
+            UUID: self.cql_encode_object,
+            datetime.datetime: self.cql_encode_datetime,
+            datetime.date: self.cql_encode_date,
+            datetime.time: self.cql_encode_time,
+            Date: self.cql_encode_date_ext,
+            Time: self.cql_encode_time,
+            dict: self.cql_encode_map_collection,
+            OrderedDict: self.cql_encode_map_collection,
+            OrderedMap: self.cql_encode_map_collection,
+            OrderedMapSerializedKey: self.cql_encode_map_collection,
+            list: self.cql_encode_list_collection,
+            tuple: self.cql_encode_list_collection,  # TODO: change to tuple in next major
+            set: self.cql_encode_set_collection,
+            sortedset: self.cql_encode_set_collection,
+            frozenset: self.cql_encode_set_collection,
+            types.GeneratorType: self.cql_encode_list_collection,
+            ValueSequence: self.cql_encode_sequence,
+            Point: self.cql_encode_str_quoted,
+            LineString: self.cql_encode_str_quoted,
+            Polygon: self.cql_encode_str_quoted
+        }
+
+        self.mapping.update({
+            memoryview: self.cql_encode_bytes,
+            bytes: self.cql_encode_bytes,
+            type(None): self.cql_encode_none,
+            ipaddress.IPv4Address: self.cql_encode_ipaddress,
+            ipaddress.IPv6Address: self.cql_encode_ipaddress
+        })
+
+    def cql_encode_none(self, val):
+        """
+        Converts :const:`None` to the string 'NULL'.
+        """
+        return 'NULL'
+
+    def cql_encode_unicode(self, val):
+        """
+        Converts :class:`unicode` objects to UTF-8 encoded strings with quote escaping.
+        """
+        return cql_quote(val.encode('utf-8'))
+
+    def cql_encode_str(self, val):
+        """
+        Escapes quotes in :class:`str` objects.
+        """
+        return cql_quote(val)
+
+    def cql_encode_str_quoted(self, val):
+        return "'%s'" % val
+
+    def cql_encode_bytes(self, val):
+        return (b'0x' + hexlify(val)).decode('utf-8')
+
+    def cql_encode_object(self, val):
+        """
+        Default encoder for all objects that do not have a specific encoder function
+        registered. This function simply calls :meth:`str()` on the object.
+        """
+        return str(val)
+
+    def cql_encode_float(self, val):
+        """
+        Encode floats using repr to preserve precision
+        """
+        if math.isinf(val):
+            return 'Infinity' if val > 0 else '-Infinity'
+        elif math.isnan(val):
+            return 'NaN'
+        else:
+            return repr(val)
+
+    def cql_encode_datetime(self, val):
+        """
+        Converts a :class:`datetime.datetime` object to a (string) integer timestamp
+        with millisecond precision.
+        """
+        timestamp = calendar.timegm(val.utctimetuple())
+        return str(int(timestamp * 1e3 + getattr(val, 'microsecond', 0) / 1e3))
+
+    def cql_encode_date(self, val):
+        """
+        Converts a :class:`datetime.date` object to a string with format
+        ``YYYY-MM-DD``.
+        """
+        return "'%s'" % val.strftime('%Y-%m-%d')
+
+    def cql_encode_time(self, val):
+        """
+        Converts a :class:`cassandra.util.Time` object to a string with format
+        ``HH:MM:SS.mmmuuunnn``.
+        """
+        return "'%s'" % val
+
+    def cql_encode_date_ext(self, val):
+        """
+        Encodes a :class:`cassandra.util.Date` object as an integer
+        """
+        # using the int form in case the Date exceeds datetime.[MIN|MAX]YEAR
+        return str(val.days_from_epoch + 2 ** 31)
+
+    def cql_encode_sequence(self, val):
+        """
+        Converts a sequence to a string of the form ``(item1, item2, ...)``.  This
+        is suitable for ``IN`` value lists.
+        """
+        return '(%s)' % ', '.join(self.mapping.get(type(v), self.cql_encode_object)(v)
+                                     for v in val)
+
+    cql_encode_tuple = cql_encode_sequence
+    """
+    Converts a sequence to a string of the form ``(item1, item2, ...)``.  This
+    is suitable for ``tuple`` type columns.
+    """
+
+    def cql_encode_map_collection(self, val):
+        """
+        Converts a dict into a string of the form ``{key1: val1, key2: val2, ...}``.
+        This is suitable for ``map`` type columns.
+        """
+        return '{%s}' % ', '.join('%s: %s' % (
+            self.mapping.get(type(k), self.cql_encode_object)(k),
+            self.mapping.get(type(v), self.cql_encode_object)(v)
+        ) for k, v in val.items())
+
+    def cql_encode_list_collection(self, val):
+        """
+        Converts a sequence to a string of the form ``[item1, item2, ...]``.  This
+        is suitable for ``list`` type columns.
+        """
+        return '[%s]' % ', '.join(self.mapping.get(type(v), self.cql_encode_object)(v) for v in val)
+
+    def cql_encode_set_collection(self, val):
+        """
+        Converts a sequence to a string of the form ``{item1, item2, ...}``.  This
+        is suitable for ``set`` type columns.
+        """
+        return '{%s}' % ', '.join(self.mapping.get(type(v), self.cql_encode_object)(v) for v in val)
+
+    def cql_encode_all_types(self, val, as_text_type=False):
+        """
+        Converts any type into a CQL string, defaulting to ``cql_encode_object``
+        if :attr:`~Encoder.mapping` does not contain an entry for the type.
+        """
+        encoded = self.mapping.get(type(val), self.cql_encode_object)(val)
+        if as_text_type and not isinstance(encoded, str):
+            return encoded.decode('utf-8')
+        return encoded
+
+    def cql_encode_ipaddress(self, val):
+        """
+        Converts an ipaddress (IPV4Address, IPV6Address) to a CQL string. This
+        is suitable for ``inet`` type columns.
+        """
+        return "'%s'" % val.compressed
diff --git a/llm/Lib/site-packages/cassandra/graph/__init__.py b/llm/Lib/site-packages/cassandra/graph/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..74e4aaac7cc07f4a5cbe5c745dd06efd2e11be86
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/graph/__init__.py
@@ -0,0 +1,16 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This is only for backward compatibility when migrating from dse-driver.
+from cassandra.datastax.graph import *
\ No newline at end of file
diff --git a/llm/Lib/site-packages/cassandra/graph/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassandra/graph/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bf5aab2832a8204015370c46ef2e9cb30e800d43
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/graph/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/graph/__pycache__/graphson.cpython-311.pyc b/llm/Lib/site-packages/cassandra/graph/__pycache__/graphson.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..888b1a8903311d08821c0c693acbe755b64a5603
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/graph/__pycache__/graphson.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/graph/__pycache__/query.cpython-311.pyc b/llm/Lib/site-packages/cassandra/graph/__pycache__/query.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8a11b450f13849a61b5fa7d3e6efe049350caffa
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/graph/__pycache__/query.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/graph/__pycache__/types.cpython-311.pyc b/llm/Lib/site-packages/cassandra/graph/__pycache__/types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3884a2d171f5885e1fa8635a90a1bb426561df70
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/graph/__pycache__/types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/graph/graphson.py b/llm/Lib/site-packages/cassandra/graph/graphson.py
new file mode 100644
index 0000000000000000000000000000000000000000..00ba469950c225e762895c74c20d0108a4feae75
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/graph/graphson.py
@@ -0,0 +1,16 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This is only for backward compatibility when migrating from dse-driver.
+from cassandra.datastax.graph.graphson import *
diff --git a/llm/Lib/site-packages/cassandra/graph/query.py b/llm/Lib/site-packages/cassandra/graph/query.py
new file mode 100644
index 0000000000000000000000000000000000000000..d4207f05b4e00287c3940af3a3a7cc0da2010bf0
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/graph/query.py
@@ -0,0 +1,16 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This is only for backward compatibility when migrating from dse-driver.
+from cassandra.datastax.graph.query import *
diff --git a/llm/Lib/site-packages/cassandra/graph/types.py b/llm/Lib/site-packages/cassandra/graph/types.py
new file mode 100644
index 0000000000000000000000000000000000000000..847a6c6e1b532f6f6db5dd8a70e422e69c1282fc
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/graph/types.py
@@ -0,0 +1,16 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This is only for backward compatibility when migrating from dse-driver.
+from cassandra.datastax.graph.types import *
diff --git a/llm/Lib/site-packages/cassandra/io/__init__.py b/llm/Lib/site-packages/cassandra/io/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..15ef495f28f8576c0e79e786ae6bc9aa5b2e594d
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/io/__init__.py
@@ -0,0 +1,14 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
diff --git a/llm/Lib/site-packages/cassandra/io/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassandra/io/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..279393bbb2945b99315539f6954c09d76ea68b78
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/io/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/io/__pycache__/asyncioreactor.cpython-311.pyc b/llm/Lib/site-packages/cassandra/io/__pycache__/asyncioreactor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d82e4f219766d945be2600d8b95a54751a21fda3
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/io/__pycache__/asyncioreactor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/io/__pycache__/asyncorereactor.cpython-311.pyc b/llm/Lib/site-packages/cassandra/io/__pycache__/asyncorereactor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..52601669beed0540c188efdec84fc79233565b6a
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/io/__pycache__/asyncorereactor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/io/__pycache__/eventletreactor.cpython-311.pyc b/llm/Lib/site-packages/cassandra/io/__pycache__/eventletreactor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ad7dfa93d304d0101cdc2127a2f9fd1fda245ec0
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/io/__pycache__/eventletreactor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/io/__pycache__/geventreactor.cpython-311.pyc b/llm/Lib/site-packages/cassandra/io/__pycache__/geventreactor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..139e45990923b8e3198ec755c09b212f85ba04eb
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/io/__pycache__/geventreactor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/io/__pycache__/libevreactor.cpython-311.pyc b/llm/Lib/site-packages/cassandra/io/__pycache__/libevreactor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2cf0b2c9747d4d38dbc7a71b562f66fcbef4b3d5
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/io/__pycache__/libevreactor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/io/__pycache__/twistedreactor.cpython-311.pyc b/llm/Lib/site-packages/cassandra/io/__pycache__/twistedreactor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..140db83737e5e5f83b8ebe3431dd13a4bd094ecd
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/io/__pycache__/twistedreactor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassandra/io/asyncioreactor.py b/llm/Lib/site-packages/cassandra/io/asyncioreactor.py
new file mode 100644
index 0000000000000000000000000000000000000000..e860f7dd76755e54bb55345ddb7ffc42884b36c1
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/io/asyncioreactor.py
@@ -0,0 +1,221 @@
+from cassandra.connection import Connection, ConnectionShutdown
+
+import asyncio
+import logging
+import os
+import socket
+import ssl
+from threading import Lock, Thread, get_ident
+
+
+log = logging.getLogger(__name__)
+
+
+# This module uses ``yield from`` and ``@asyncio.coroutine`` over ``await`` and
+# ``async def`` for pre-Python-3.5 compatibility, so keep in mind that the
+# managed coroutines are generator-based, not native coroutines. See PEP 492:
+# https://www.python.org/dev/peps/pep-0492/#coroutine-objects
+
+
+try:
+    asyncio.run_coroutine_threadsafe
+except AttributeError:
+    raise ImportError(
+        'Cannot use asyncioreactor without access to '
+        'asyncio.run_coroutine_threadsafe (added in 3.4.6 and 3.5.1)'
+    )
+
+
+class AsyncioTimer(object):
+    """
+    An ``asyncioreactor``-specific Timer. Similar to :class:`.connection.Timer,
+    but with a slightly different API due to limitations in the underlying
+    ``call_later`` interface. Not meant to be used with a
+    :class:`.connection.TimerManager`.
+    """
+
+    @property
+    def end(self):
+        raise NotImplementedError('{} is not compatible with TimerManager and '
+                                  'does not implement .end()')
+
+    def __init__(self, timeout, callback, loop):
+        delayed = self._call_delayed_coro(timeout=timeout,
+                                          callback=callback)
+        self._handle = asyncio.run_coroutine_threadsafe(delayed, loop=loop)
+
+    @staticmethod
+    async def _call_delayed_coro(timeout, callback):
+        await asyncio.sleep(timeout)
+        return callback()
+
+    def __lt__(self, other):
+        try:
+            return self._handle < other._handle
+        except AttributeError:
+            raise NotImplemented
+
+    def cancel(self):
+        self._handle.cancel()
+
+    def finish(self):
+        # connection.Timer method not implemented here because we can't inspect
+        # the Handle returned from call_later
+        raise NotImplementedError('{} is not compatible with TimerManager and '
+                                  'does not implement .finish()')
+
+
+class AsyncioConnection(Connection):
+    """
+    An experimental implementation of :class:`.Connection` that uses the
+    ``asyncio`` module in the Python standard library for its event loop.
+
+    Note that it requires ``asyncio`` features that were only introduced in the
+    3.4 line in 3.4.6, and in the 3.5 line in 3.5.1.
+    """
+
+    _loop = None
+    _pid = os.getpid()
+
+    _lock = Lock()
+    _loop_thread = None
+
+    _write_queue = None
+    _write_queue_lock = None
+
+    def __init__(self, *args, **kwargs):
+        Connection.__init__(self, *args, **kwargs)
+
+        self._connect_socket()
+        self._socket.setblocking(0)
+
+        self._write_queue = asyncio.Queue()
+        self._write_queue_lock = asyncio.Lock()
+
+        # see initialize_reactor -- loop is running in a separate thread, so we
+        # have to use a threadsafe call
+        self._read_watcher = asyncio.run_coroutine_threadsafe(
+            self.handle_read(), loop=self._loop
+        )
+        self._write_watcher = asyncio.run_coroutine_threadsafe(
+            self.handle_write(), loop=self._loop
+        )
+        self._send_options_message()
+
+    @classmethod
+    def initialize_reactor(cls):
+        with cls._lock:
+            if cls._pid != os.getpid():
+                cls._loop = None
+            if cls._loop is None:
+                cls._loop = asyncio.new_event_loop()
+                asyncio.set_event_loop(cls._loop)
+
+            if not cls._loop_thread:
+                # daemonize so the loop will be shut down on interpreter
+                # shutdown
+                cls._loop_thread = Thread(target=cls._loop.run_forever,
+                                          daemon=True, name="asyncio_thread")
+                cls._loop_thread.start()
+
+    @classmethod
+    def create_timer(cls, timeout, callback):
+        return AsyncioTimer(timeout, callback, loop=cls._loop)
+
+    def close(self):
+        with self.lock:
+            if self.is_closed:
+                return
+            self.is_closed = True
+
+        # close from the loop thread to avoid races when removing file
+        # descriptors
+        asyncio.run_coroutine_threadsafe(
+            self._close(), loop=self._loop
+        )
+
+    async def _close(self):
+        log.debug("Closing connection (%s) to %s" % (id(self), self.endpoint))
+        if self._write_watcher:
+            self._write_watcher.cancel()
+        if self._read_watcher:
+            self._read_watcher.cancel()
+        if self._socket:
+            self._loop.remove_writer(self._socket.fileno())
+            self._loop.remove_reader(self._socket.fileno())
+            self._socket.close()
+
+        log.debug("Closed socket to %s" % (self.endpoint,))
+
+        if not self.is_defunct:
+            self.error_all_requests(
+                ConnectionShutdown("Connection to %s was closed" % self.endpoint))
+            # don't leave in-progress operations hanging
+            self.connected_event.set()
+
+    def push(self, data):
+        buff_size = self.out_buffer_size
+        if len(data) > buff_size:
+            chunks = []
+            for i in range(0, len(data), buff_size):
+                chunks.append(data[i:i + buff_size])
+        else:
+            chunks = [data]
+
+        if self._loop_thread.ident != get_ident():
+            asyncio.run_coroutine_threadsafe(
+                self._push_msg(chunks),
+                loop=self._loop
+            )
+        else:
+            # avoid races/hangs by just scheduling this, not using threadsafe
+            self._loop.create_task(self._push_msg(chunks))
+
+    async def _push_msg(self, chunks):
+        # This lock ensures all chunks of a message are sequential in the Queue
+        with await self._write_queue_lock:
+            for chunk in chunks:
+                self._write_queue.put_nowait(chunk)
+
+
+    async def handle_write(self):
+        while True:
+            try:
+                next_msg = await self._write_queue.get()
+                if next_msg:
+                    await self._loop.sock_sendall(self._socket, next_msg)
+            except socket.error as err:
+                log.debug("Exception in send for %s: %s", self, err)
+                self.defunct(err)
+                return
+            except asyncio.CancelledError:
+                return
+
+    async def handle_read(self):
+        while True:
+            try:
+                buf = await self._loop.sock_recv(self._socket, self.in_buffer_size)
+                self._iobuf.write(buf)
+            # sock_recv expects EWOULDBLOCK if socket provides no data, but
+            # nonblocking ssl sockets raise these instead, so we handle them
+            # ourselves by yielding to the event loop, where the socket will
+            # get the reading/writing it "wants" before retrying
+            except (ssl.SSLWantWriteError, ssl.SSLWantReadError):
+                # Apparently the preferred way to yield to the event loop from within
+                # a native coroutine based on https://github.com/python/asyncio/issues/284
+                await asyncio.sleep(0)
+                continue
+            except socket.error as err:
+                log.debug("Exception during socket recv for %s: %s",
+                          self, err)
+                self.defunct(err)
+                return  # leave the read loop
+            except asyncio.CancelledError:
+                return
+
+            if buf and self._iobuf.tell():
+                self.process_io_buffer()
+            else:
+                log.debug("Connection %s closed by server", self)
+                self.close()
+                return
diff --git a/llm/Lib/site-packages/cassandra/io/asyncorereactor.py b/llm/Lib/site-packages/cassandra/io/asyncorereactor.py
new file mode 100644
index 0000000000000000000000000000000000000000..ef7698a53e944197b9928534065bc20e6ba239b3
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/io/asyncorereactor.py
@@ -0,0 +1,477 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import atexit
+from collections import deque
+from functools import partial
+import logging
+import os
+import socket
+import sys
+from threading import Lock, Thread, Event
+import time
+import weakref
+import sys
+import ssl
+
+
+try:
+    from weakref import WeakSet
+except ImportError:
+    from cassandra.util import WeakSet  # noqa
+
+from cassandra import DependencyException
+try:
+    import asyncore
+except ModuleNotFoundError:
+    raise DependencyException(
+        "Unable to import asyncore module.  Note that this module has been removed in Python 3.12 "
+        "so when using the driver with this version (or anything newer) you will need to use one of the "
+        "other event loop implementations."
+    )
+
+from cassandra.connection import Connection, ConnectionShutdown, NONBLOCKING, Timer, TimerManager
+
+
+log = logging.getLogger(__name__)
+
+_dispatcher_map = {}
+
+def _cleanup(loop):
+    if loop:
+        loop._cleanup()
+
+
+class WaitableTimer(Timer):
+    def __init__(self, timeout, callback):
+        Timer.__init__(self, timeout, callback)
+        self.callback = callback
+        self.event = Event()
+
+        self.final_exception = None
+
+    def finish(self, time_now):
+        try:
+            finished = Timer.finish(self, time_now)
+            if finished:
+                self.event.set()
+                return True
+            return False
+
+        except Exception as e:
+            self.final_exception = e
+            self.event.set()
+            return True
+
+    def wait(self, timeout=None):
+        self.event.wait(timeout)
+        if self.final_exception:
+            raise self.final_exception
+
+
+class _PipeWrapper(object):
+
+    def __init__(self, fd):
+        self.fd = fd
+
+    def fileno(self):
+        return self.fd
+
+    def close(self):
+        os.close(self.fd)
+
+    def getsockopt(self, level, optname, buflen=None):
+        # act like an unerrored socket for the asyncore error handling
+        if level == socket.SOL_SOCKET and optname == socket.SO_ERROR and not buflen:
+            return 0
+        raise NotImplementedError()
+
+
+class _AsyncoreDispatcher(asyncore.dispatcher):
+
+    def __init__(self, socket):
+        asyncore.dispatcher.__init__(self, map=_dispatcher_map)
+        # inject after to avoid base class validation
+        self.set_socket(socket)
+        self._notified = False
+
+    def writable(self):
+        return False
+
+    def validate(self):
+        assert not self._notified
+        self.notify_loop()
+        assert self._notified
+        self.loop(0.1)
+        assert not self._notified
+
+    def loop(self, timeout):
+        asyncore.loop(timeout=timeout, use_poll=True, map=_dispatcher_map, count=1)
+
+
+class _AsyncorePipeDispatcher(_AsyncoreDispatcher):
+
+    def __init__(self):
+        self.read_fd, self.write_fd = os.pipe()
+        _AsyncoreDispatcher.__init__(self, _PipeWrapper(self.read_fd))
+
+    def writable(self):
+        return False
+
+    def handle_read(self):
+        while len(os.read(self.read_fd, 4096)) == 4096:
+            pass
+        self._notified = False
+
+    def notify_loop(self):
+        if not self._notified:
+            self._notified = True
+            os.write(self.write_fd, b'x')
+
+
+class _AsyncoreUDPDispatcher(_AsyncoreDispatcher):
+    """
+    Experimental alternate dispatcher for avoiding busy wait in the asyncore loop. It is not used by default because
+    it relies on local port binding.
+    Port scanning is not implemented, so multiple clients on one host will collide. This address would need to be set per
+    instance, or this could be specialized to scan until an address is found.
+
+    To use::
+
+        from cassandra.io.asyncorereactor import _AsyncoreUDPDispatcher, AsyncoreLoop
+        AsyncoreLoop._loop_dispatch_class = _AsyncoreUDPDispatcher
+
+    """
+    bind_address = ('localhost', 10000)
+
+    def __init__(self):
+        self._socket = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        self._socket.bind(self.bind_address)
+        self._socket.setblocking(0)
+        _AsyncoreDispatcher.__init__(self, self._socket)
+
+    def handle_read(self):
+        try:
+            d = self._socket.recvfrom(1)
+            while d and d[1]:
+                d = self._socket.recvfrom(1)
+        except socket.error as e:
+            pass
+        self._notified = False
+
+    def notify_loop(self):
+        if not self._notified:
+            self._notified = True
+            self._socket.sendto(b'', self.bind_address)
+
+    def loop(self, timeout):
+        asyncore.loop(timeout=timeout, use_poll=False, map=_dispatcher_map, count=1)
+
+
+class _BusyWaitDispatcher(object):
+
+    max_write_latency = 0.001
+    """
+    Timeout pushed down to asyncore select/poll. Dictates the amount of time it will sleep before coming back to check
+    if anything is writable.
+    """
+
+    def notify_loop(self):
+        pass
+
+    def loop(self, timeout):
+        if not _dispatcher_map:
+            time.sleep(0.005)
+        count = timeout // self.max_write_latency
+        asyncore.loop(timeout=self.max_write_latency, use_poll=True, map=_dispatcher_map, count=count)
+
+    def validate(self):
+        pass
+
+    def close(self):
+        pass
+
+
+class AsyncoreLoop(object):
+
+    timer_resolution = 0.1  # used as the max interval to be in the io loop before returning to service timeouts
+
+    _loop_dispatch_class = _AsyncorePipeDispatcher if os.name != 'nt' else _BusyWaitDispatcher
+
+    def __init__(self):
+        self._pid = os.getpid()
+        self._loop_lock = Lock()
+        self._started = False
+        self._shutdown = False
+
+        self._thread = None
+
+        self._timers = TimerManager()
+
+        try:
+            dispatcher = self._loop_dispatch_class()
+            dispatcher.validate()
+            log.debug("Validated loop dispatch with %s", self._loop_dispatch_class)
+        except Exception:
+            log.exception("Failed validating loop dispatch with %s. Using busy wait execution instead.", self._loop_dispatch_class)
+            dispatcher.close()
+            dispatcher = _BusyWaitDispatcher()
+        self._loop_dispatcher = dispatcher
+
+    def maybe_start(self):
+        should_start = False
+        did_acquire = False
+        try:
+            did_acquire = self._loop_lock.acquire(False)
+            if did_acquire and not self._started:
+                self._started = True
+                should_start = True
+        finally:
+            if did_acquire:
+                self._loop_lock.release()
+
+        if should_start:
+            self._thread = Thread(target=self._run_loop, name="asyncore_cassandra_driver_event_loop")
+            self._thread.daemon = True
+            self._thread.start()
+
+    def wake_loop(self):
+        self._loop_dispatcher.notify_loop()
+
+    def _run_loop(self):
+        log.debug("Starting asyncore event loop")
+        with self._loop_lock:
+            while not self._shutdown:
+                try:
+                    self._loop_dispatcher.loop(self.timer_resolution)
+                    self._timers.service_timeouts()
+                except Exception as exc:
+                    self._maybe_log_debug("Asyncore event loop stopped unexpectedly", exc_info=exc)
+                    break
+            self._started = False
+
+        self._maybe_log_debug("Asyncore event loop ended")
+
+    def _maybe_log_debug(self, *args, **kwargs):
+        try:
+            log.debug(*args, **kwargs)
+        except Exception:
+            # TODO: Remove when Python 2 support is removed
+            # PYTHON-1266. If our logger has disappeared, there's nothing we
+            # can do, so just log nothing.
+            pass
+
+    def add_timer(self, timer):
+        self._timers.add_timer(timer)
+
+        # This function is called from a different thread than the event loop
+        # thread, so for this call to be thread safe, we must wake up the loop
+        # in case it's stuck at a select
+        self.wake_loop()
+
+    def _cleanup(self):
+        global _dispatcher_map
+
+        self._shutdown = True
+        if not self._thread:
+            return
+
+        log.debug("Waiting for event loop thread to join...")
+        self._thread.join(timeout=1.0)
+        if self._thread.is_alive():
+            log.warning(
+                "Event loop thread could not be joined, so shutdown may not be clean. "
+                "Please call Cluster.shutdown() to avoid this.")
+
+        log.debug("Event loop thread was joined")
+
+        # Ensure all connections are closed and in-flight requests cancelled
+        for conn in tuple(_dispatcher_map.values()):
+            if conn is not self._loop_dispatcher:
+                conn.close()
+        self._timers.service_timeouts()
+        # Once all the connections are closed, close the dispatcher
+        self._loop_dispatcher.close()
+
+        log.debug("Dispatchers were closed")
+
+
+_global_loop = None
+atexit.register(partial(_cleanup, _global_loop))
+
+
+class AsyncoreConnection(Connection, asyncore.dispatcher):
+    """
+    An implementation of :class:`.Connection` that uses the ``asyncore``
+    module in the Python standard library for its event loop.
+    """
+
+    _writable = False
+    _readable = False
+
+    @classmethod
+    def initialize_reactor(cls):
+        global _global_loop
+        if not _global_loop:
+            _global_loop = AsyncoreLoop()
+        else:
+            current_pid = os.getpid()
+            if _global_loop._pid != current_pid:
+                log.debug("Detected fork, clearing and reinitializing reactor state")
+                cls.handle_fork()
+                _global_loop = AsyncoreLoop()
+
+    @classmethod
+    def handle_fork(cls):
+        global _dispatcher_map, _global_loop
+        _dispatcher_map = {}
+        if _global_loop:
+            _global_loop._cleanup()
+            _global_loop = None
+
+    @classmethod
+    def create_timer(cls, timeout, callback):
+        timer = Timer(timeout, callback)
+        _global_loop.add_timer(timer)
+        return timer
+
+    def __init__(self, *args, **kwargs):
+        Connection.__init__(self, *args, **kwargs)
+
+        self.deque = deque()
+        self.deque_lock = Lock()
+
+        self._connect_socket()
+
+        # start the event loop if needed
+        _global_loop.maybe_start()
+
+        init_handler = WaitableTimer(
+            timeout=0,
+            callback=partial(asyncore.dispatcher.__init__,
+                             self, self._socket, _dispatcher_map)
+        )
+        _global_loop.add_timer(init_handler)
+        init_handler.wait(kwargs["connect_timeout"])
+
+        self._writable = True
+        self._readable = True
+
+        self._send_options_message()
+
+    def close(self):
+        with self.lock:
+            if self.is_closed:
+                return
+            self.is_closed = True
+
+        log.debug("Closing connection (%s) to %s", id(self), self.endpoint)
+        self._writable = False
+        self._readable = False
+
+        # We don't have to wait for this to be closed, we can just schedule it
+        self.create_timer(0, partial(asyncore.dispatcher.close, self))
+
+        log.debug("Closed socket to %s", self.endpoint)
+
+        if not self.is_defunct:
+            self.error_all_requests(
+                ConnectionShutdown("Connection to %s was closed" % self.endpoint))
+
+            #This happens when the connection is shutdown while waiting for the ReadyMessage
+            if not self.connected_event.is_set():
+                self.last_error = ConnectionShutdown("Connection to %s was closed" % self.endpoint)
+
+            # don't leave in-progress operations hanging
+            self.connected_event.set()
+
+    def handle_error(self):
+        self.defunct(sys.exc_info()[1])
+
+    def handle_close(self):
+        log.debug("Connection %s closed by server", self)
+        self.close()
+
+    def handle_write(self):
+        while True:
+            with self.deque_lock:
+                try:
+                    next_msg = self.deque.popleft()
+                except IndexError:
+                    self._writable = False
+                    return
+
+            try:
+                sent = self.send(next_msg)
+                self._readable = True
+            except socket.error as err:
+                if (err.args[0] in NONBLOCKING or
+                        err.args[0] in (ssl.SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE)):
+                    with self.deque_lock:
+                        self.deque.appendleft(next_msg)
+                else:
+                    self.defunct(err)
+                return
+            else:
+                if sent < len(next_msg):
+                    with self.deque_lock:
+                        self.deque.appendleft(next_msg[sent:])
+                    if sent == 0:
+                        return
+
+    def handle_read(self):
+        try:
+            while True:
+                buf = self.recv(self.in_buffer_size)
+                self._iobuf.write(buf)
+                if len(buf) < self.in_buffer_size:
+                    break
+        except socket.error as err:
+            if isinstance(err, ssl.SSLError):
+                if err.args[0] in (ssl.SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE):
+                    if not self._iobuf.tell():
+                        return
+                else:
+                    self.defunct(err)
+                    return
+            elif err.args[0] in NONBLOCKING:
+                if not self._iobuf.tell():
+                    return
+            else:
+                self.defunct(err)
+                return
+
+        if self._iobuf.tell():
+            self.process_io_buffer()
+            if not self._requests and not self.is_control_connection:
+                self._readable = False
+
+    def push(self, data):
+        sabs = self.out_buffer_size
+        if len(data) > sabs:
+            chunks = []
+            for i in range(0, len(data), sabs):
+                chunks.append(data[i:i + sabs])
+        else:
+            chunks = [data]
+
+        with self.deque_lock:
+            self.deque.extend(chunks)
+            self._writable = True
+        _global_loop.wake_loop()
+
+    def writable(self):
+        return self._writable
+
+    def readable(self):
+        return self._readable or ((self.is_control_connection or self._continuous_paging_sessions) and not (self.is_defunct or self.is_closed))
diff --git a/llm/Lib/site-packages/cassandra/io/eventletreactor.py b/llm/Lib/site-packages/cassandra/io/eventletreactor.py
new file mode 100644
index 0000000000000000000000000000000000000000..9980cec3b4f0c46c044e5a235024abe538e600b0
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/io/eventletreactor.py
@@ -0,0 +1,191 @@
+# Copyright 2014 Symantec Corporation
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Originally derived from MagnetoDB source:
+#   https://github.com/stackforge/magnetodb/blob/2015.1.0b1/magnetodb/common/cassandra/io/eventletreactor.py
+import eventlet
+from eventlet.green import socket
+from eventlet.queue import Queue
+from greenlet import GreenletExit
+import logging
+from threading import Event
+import time
+
+from cassandra.connection import Connection, ConnectionShutdown, Timer, TimerManager
+try:
+    from eventlet.green.OpenSSL import SSL
+    _PYOPENSSL = True
+except ImportError as e:
+    _PYOPENSSL = False
+    no_pyopenssl_error = e
+
+
+log = logging.getLogger(__name__)
+
+
+def _check_pyopenssl():
+    if not _PYOPENSSL:
+        raise ImportError(
+            "{}, pyOpenSSL must be installed to enable "
+            "SSL support with the Eventlet event loop".format(str(no_pyopenssl_error))
+        )
+
+
+class EventletConnection(Connection):
+    """
+    An implementation of :class:`.Connection` that utilizes ``eventlet``.
+
+    This implementation assumes all eventlet monkey patching is active. It is not tested with partial patching.
+    """
+
+    _read_watcher = None
+    _write_watcher = None
+
+    _socket_impl = eventlet.green.socket
+    _ssl_impl = eventlet.green.ssl
+
+    _timers = None
+    _timeout_watcher = None
+    _new_timer = None
+
+    @classmethod
+    def initialize_reactor(cls):
+        eventlet.monkey_patch()
+        if not cls._timers:
+            cls._timers = TimerManager()
+            cls._timeout_watcher = eventlet.spawn(cls.service_timeouts)
+            cls._new_timer = Event()
+
+    @classmethod
+    def create_timer(cls, timeout, callback):
+        timer = Timer(timeout, callback)
+        cls._timers.add_timer(timer)
+        cls._new_timer.set()
+        return timer
+
+    @classmethod
+    def service_timeouts(cls):
+        """
+        cls._timeout_watcher runs in this loop forever.
+        It is usually waiting for the next timeout on the cls._new_timer Event.
+        When new timers are added, that event is set so that the watcher can
+        wake up and possibly set an earlier timeout.
+        """
+        timer_manager = cls._timers
+        while True:
+            next_end = timer_manager.service_timeouts()
+            sleep_time = max(next_end - time.time(), 0) if next_end else 10000
+            cls._new_timer.wait(sleep_time)
+            cls._new_timer.clear()
+
+    def __init__(self, *args, **kwargs):
+        Connection.__init__(self, *args, **kwargs)
+        self.uses_legacy_ssl_options = self.ssl_options and not self.ssl_context
+        self._write_queue = Queue()
+
+        self._connect_socket()
+
+        self._read_watcher = eventlet.spawn(lambda: self.handle_read())
+        self._write_watcher = eventlet.spawn(lambda: self.handle_write())
+        self._send_options_message()
+
+    def _wrap_socket_from_context(self):
+        _check_pyopenssl()
+        rv = SSL.Connection(self.ssl_context, self._socket)
+        rv.set_connect_state()
+        if self.ssl_options and 'server_hostname' in self.ssl_options:
+            # This is necessary for SNI
+            rv.set_tlsext_host_name(self.ssl_options['server_hostname'].encode('ascii'))
+        return rv
+
+    def _initiate_connection(self, sockaddr):
+        if self.uses_legacy_ssl_options:
+            super(EventletConnection, self)._initiate_connection(sockaddr)
+        else:
+            self._socket.connect(sockaddr)
+            if self.ssl_context or self.ssl_options:
+                self._socket.do_handshake()
+
+    def _validate_hostname(self):
+        if not self.uses_legacy_ssl_options:
+            cert_name = self._socket.get_peer_certificate().get_subject().commonName
+            if cert_name != self.endpoint.address:
+                raise Exception("Hostname verification failed! Certificate name '{}' "
+                                "doesn't match endpoint '{}'".format(cert_name, self.endpoint.address))
+
+    def close(self):
+        with self.lock:
+            if self.is_closed:
+                return
+            self.is_closed = True
+
+        log.debug("Closing connection (%s) to %s" % (id(self), self.endpoint))
+
+        cur_gthread = eventlet.getcurrent()
+
+        if self._read_watcher and self._read_watcher != cur_gthread:
+            self._read_watcher.kill()
+        if self._write_watcher and self._write_watcher != cur_gthread:
+            self._write_watcher.kill()
+        if self._socket:
+            self._socket.close()
+        log.debug("Closed socket to %s" % (self.endpoint,))
+
+        if not self.is_defunct:
+            self.error_all_requests(
+                ConnectionShutdown("Connection to %s was closed" % self.endpoint))
+            # don't leave in-progress operations hanging
+            self.connected_event.set()
+
+    def handle_close(self):
+        log.debug("connection closed by server")
+        self.close()
+
+    def handle_write(self):
+        while True:
+            try:
+                next_msg = self._write_queue.get()
+                self._socket.sendall(next_msg)
+            except socket.error as err:
+                log.debug("Exception during socket send for %s: %s", self, err)
+                self.defunct(err)
+                return  # Leave the write loop
+            except GreenletExit:  # graceful greenthread exit
+                return
+
+    def handle_read(self):
+        while True:
+            try:
+                buf = self._socket.recv(self.in_buffer_size)
+                self._iobuf.write(buf)
+            except socket.error as err:
+                log.debug("Exception during socket recv for %s: %s",
+                          self, err)
+                self.defunct(err)
+                return  # leave the read loop
+            except GreenletExit:  # graceful greenthread exit
+                return
+
+            if buf and self._iobuf.tell():
+                self.process_io_buffer()
+            else:
+                log.debug("Connection %s closed by server", self)
+                self.close()
+                return
+
+    def push(self, data):
+        chunk_size = self.out_buffer_size
+        for i in range(0, len(data), chunk_size):
+            self._write_queue.put(data[i:i + chunk_size])
diff --git a/llm/Lib/site-packages/cassandra/io/geventreactor.py b/llm/Lib/site-packages/cassandra/io/geventreactor.py
new file mode 100644
index 0000000000000000000000000000000000000000..d9d85a8853b18a018f28e3aaaff0aa4191acfd44
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/io/geventreactor.py
@@ -0,0 +1,137 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import gevent
+import gevent.event
+from gevent.queue import Queue
+from gevent import socket
+import gevent.ssl
+
+import logging
+import time
+
+
+from cassandra.connection import Connection, ConnectionShutdown, Timer, TimerManager
+
+
+log = logging.getLogger(__name__)
+
+
+class GeventConnection(Connection):
+    """
+    An implementation of :class:`.Connection` that utilizes ``gevent``.
+
+    This implementation assumes all gevent monkey patching is active. It is not tested with partial patching.
+    """
+
+    _read_watcher = None
+    _write_watcher = None
+
+    _socket_impl = gevent.socket
+    _ssl_impl = gevent.ssl
+
+    _timers = None
+    _timeout_watcher = None
+    _new_timer = None
+
+    @classmethod
+    def initialize_reactor(cls):
+        if not cls._timers:
+            cls._timers = TimerManager()
+            cls._timeout_watcher = gevent.spawn(cls.service_timeouts)
+            cls._new_timer = gevent.event.Event()
+
+    @classmethod
+    def create_timer(cls, timeout, callback):
+        timer = Timer(timeout, callback)
+        cls._timers.add_timer(timer)
+        cls._new_timer.set()
+        return timer
+
+    @classmethod
+    def service_timeouts(cls):
+        timer_manager = cls._timers
+        timer_event = cls._new_timer
+        while True:
+            next_end = timer_manager.service_timeouts()
+            sleep_time = max(next_end - time.time(), 0) if next_end else 10000
+            timer_event.wait(sleep_time)
+            timer_event.clear()
+
+    def __init__(self, *args, **kwargs):
+        Connection.__init__(self, *args, **kwargs)
+
+        self._write_queue = Queue()
+
+        self._connect_socket()
+
+        self._read_watcher = gevent.spawn(self.handle_read)
+        self._write_watcher = gevent.spawn(self.handle_write)
+        self._send_options_message()
+
+    def close(self):
+        with self.lock:
+            if self.is_closed:
+                return
+            self.is_closed = True
+
+        log.debug("Closing connection (%s) to %s" % (id(self), self.endpoint))
+        if self._read_watcher:
+            self._read_watcher.kill(block=False)
+        if self._write_watcher:
+            self._write_watcher.kill(block=False)
+        if self._socket:
+            self._socket.close()
+        log.debug("Closed socket to %s" % (self.endpoint,))
+
+        if not self.is_defunct:
+            self.error_all_requests(
+                ConnectionShutdown("Connection to %s was closed" % self.endpoint))
+            # don't leave in-progress operations hanging
+            self.connected_event.set()
+
+    def handle_close(self):
+        log.debug("connection closed by server")
+        self.close()
+
+    def handle_write(self):
+        while True:
+            try:
+                next_msg = self._write_queue.get()
+                self._socket.sendall(next_msg)
+            except socket.error as err:
+                log.debug("Exception in send for %s: %s", self, err)
+                self.defunct(err)
+                return
+
+    def handle_read(self):
+        while True:
+            try:
+                buf = self._socket.recv(self.in_buffer_size)
+                self._iobuf.write(buf)
+            except socket.error as err:
+                log.debug("Exception in read for %s: %s", self, err)
+                self.defunct(err)
+                return  # leave the read loop
+
+            if buf and self._iobuf.tell():
+                self.process_io_buffer()
+            else:
+                log.debug("Connection %s closed by server", self)
+                self.close()
+                return
+
+    def push(self, data):
+        chunk_size = self.out_buffer_size
+        for i in range(0, len(data), chunk_size):
+            self._write_queue.put(data[i:i + chunk_size])
diff --git a/llm/Lib/site-packages/cassandra/io/libevreactor.py b/llm/Lib/site-packages/cassandra/io/libevreactor.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b2fd1cf763ebcfcb60b3db22c9dd311cc3497a5
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/io/libevreactor.py
@@ -0,0 +1,385 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import atexit
+from collections import deque
+from functools import partial
+import logging
+import os
+import socket
+import ssl
+from threading import Lock, Thread
+import time
+
+from cassandra import DependencyException
+from cassandra.connection import (Connection, ConnectionShutdown,
+                                  NONBLOCKING, Timer, TimerManager)
+try:
+    import cassandra.io.libevwrapper as libev
+except ImportError:
+    raise DependencyException(
+        "The C extension needed to use libev was not found.  This "
+        "probably means that you didn't have the required build dependencies "
+        "when installing the driver.  See "
+        "http://datastax.github.io/python-driver/installation.html#c-extensions "
+        "for instructions on installing build dependencies and building "
+        "the C extension.")
+
+
+log = logging.getLogger(__name__)
+
+
+def _cleanup(loop):
+    if loop:
+        loop._cleanup()
+
+
+class LibevLoop(object):
+
+    def __init__(self):
+        self._pid = os.getpid()
+        self._loop = libev.Loop()
+        self._notifier = libev.Async(self._loop)
+        self._notifier.start()
+
+        # prevent _notifier from keeping the loop from returning
+        self._loop.unref()
+
+        self._started = False
+        self._shutdown = False
+        self._lock = Lock()
+        self._lock_thread = Lock()
+
+        self._thread = None
+
+        # set of all connections; only replaced with a new copy
+        # while holding _conn_set_lock, never modified in place
+        self._live_conns = set()
+        # newly created connections that need their write/read watcher started
+        self._new_conns = set()
+        # recently closed connections that need their write/read watcher stopped
+        self._closed_conns = set()
+        self._conn_set_lock = Lock()
+
+        self._preparer = libev.Prepare(self._loop, self._loop_will_run)
+        # prevent _preparer from keeping the loop from returning
+        self._loop.unref()
+        self._preparer.start()
+
+        self._timers = TimerManager()
+        self._loop_timer = libev.Timer(self._loop, self._on_loop_timer)
+
+    def maybe_start(self):
+        should_start = False
+        with self._lock:
+            if not self._started:
+                log.debug("Starting libev event loop")
+                self._started = True
+                should_start = True
+
+        if should_start:
+            with self._lock_thread:
+                if not self._shutdown:
+                    self._thread = Thread(target=self._run_loop, name="event_loop")
+                    self._thread.daemon = True
+                    self._thread.start()
+
+        self._notifier.send()
+
+    def _run_loop(self):
+        while True:
+            self._loop.start()
+            # there are still active watchers, no deadlock
+            with self._lock:
+                if not self._shutdown and self._live_conns:
+                    log.debug("Restarting event loop")
+                    continue
+                else:
+                    # all Connections have been closed, no active watchers
+                    log.debug("All Connections currently closed, event loop ended")
+                    self._started = False
+                    break
+
+    def _cleanup(self):
+        self._shutdown = True
+        if not self._thread:
+            return
+
+        for conn in self._live_conns | self._new_conns | self._closed_conns:
+            conn.close()
+            for watcher in (conn._write_watcher, conn._read_watcher):
+                if watcher:
+                    watcher.stop()
+
+        self.notify()  # wake the timer watcher
+
+        # PYTHON-752 Thread might have just been created and not started
+        with self._lock_thread:
+            self._thread.join(timeout=1.0)
+
+        if self._thread.is_alive():
+            log.warning(
+                "Event loop thread could not be joined, so shutdown may not be clean. "
+                "Please call Cluster.shutdown() to avoid this.")
+
+        log.debug("Event loop thread was joined")
+
+    def add_timer(self, timer):
+        self._timers.add_timer(timer)
+        self._notifier.send()  # wake up in case this timer is earlier
+
+    def _update_timer(self):
+        if not self._shutdown:
+            next_end = self._timers.service_timeouts()
+            if next_end:
+                self._loop_timer.start(next_end - time.time())  # timer handles negative values
+        else:
+            self._loop_timer.stop()
+
+    def _on_loop_timer(self):
+        self._timers.service_timeouts()
+
+    def notify(self):
+        self._notifier.send()
+
+    def connection_created(self, conn):
+        with self._conn_set_lock:
+            new_live_conns = self._live_conns.copy()
+            new_live_conns.add(conn)
+            self._live_conns = new_live_conns
+
+            new_new_conns = self._new_conns.copy()
+            new_new_conns.add(conn)
+            self._new_conns = new_new_conns
+
+    def connection_destroyed(self, conn):
+        with self._conn_set_lock:
+            new_live_conns = self._live_conns.copy()
+            new_live_conns.discard(conn)
+            self._live_conns = new_live_conns
+
+            new_closed_conns = self._closed_conns.copy()
+            new_closed_conns.add(conn)
+            self._closed_conns = new_closed_conns
+
+        self._notifier.send()
+
+    def _loop_will_run(self, prepare):
+        changed = False
+        for conn in self._live_conns:
+            if not conn.deque and conn._write_watcher_is_active:
+                if conn._write_watcher:
+                    conn._write_watcher.stop()
+                conn._write_watcher_is_active = False
+                changed = True
+            elif conn.deque and not conn._write_watcher_is_active:
+                conn._write_watcher.start()
+                conn._write_watcher_is_active = True
+                changed = True
+
+        if self._new_conns:
+            with self._conn_set_lock:
+                to_start = self._new_conns
+                self._new_conns = set()
+
+            for conn in to_start:
+                conn._read_watcher.start()
+
+            changed = True
+
+        if self._closed_conns:
+            with self._conn_set_lock:
+                to_stop = self._closed_conns
+                self._closed_conns = set()
+
+            for conn in to_stop:
+                if conn._write_watcher:
+                    conn._write_watcher.stop()
+                    # clear reference cycles from IO callback
+                    del conn._write_watcher
+                if conn._read_watcher:
+                    conn._read_watcher.stop()
+                    # clear reference cycles from IO callback
+                    del conn._read_watcher
+
+            changed = True
+
+        # TODO: update to do connection management, timer updates through dedicated async 'notifier' callbacks
+        self._update_timer()
+
+        if changed:
+            self._notifier.send()
+
+
+_global_loop = None
+atexit.register(partial(_cleanup, _global_loop))
+
+
+class LibevConnection(Connection):
+    """
+    An implementation of :class:`.Connection` that uses libev for its event loop.
+    """
+    _write_watcher_is_active = False
+    _read_watcher = None
+    _write_watcher = None
+    _socket = None
+
+    @classmethod
+    def initialize_reactor(cls):
+        global _global_loop
+        if not _global_loop:
+            _global_loop = LibevLoop()
+        else:
+            if _global_loop._pid != os.getpid():
+                log.debug("Detected fork, clearing and reinitializing reactor state")
+                cls.handle_fork()
+                _global_loop = LibevLoop()
+
+    @classmethod
+    def handle_fork(cls):
+        global _global_loop
+        if _global_loop:
+            _global_loop._cleanup()
+            _global_loop = None
+
+    @classmethod
+    def create_timer(cls, timeout, callback):
+        timer = Timer(timeout, callback)
+        _global_loop.add_timer(timer)
+        return timer
+
+    def __init__(self, *args, **kwargs):
+        Connection.__init__(self, *args, **kwargs)
+
+        self.deque = deque()
+        self._deque_lock = Lock()
+        self._connect_socket()
+        self._socket.setblocking(0)
+
+        with _global_loop._lock:
+            self._read_watcher = libev.IO(self._socket.fileno(), libev.EV_READ, _global_loop._loop, self.handle_read)
+            self._write_watcher = libev.IO(self._socket.fileno(), libev.EV_WRITE, _global_loop._loop, self.handle_write)
+
+        self._send_options_message()
+
+        _global_loop.connection_created(self)
+
+        # start the global event loop if needed
+        _global_loop.maybe_start()
+
+    def close(self):
+        with self.lock:
+            if self.is_closed:
+                return
+            self.is_closed = True
+
+        log.debug("Closing connection (%s) to %s", id(self), self.endpoint)
+
+        _global_loop.connection_destroyed(self)
+        self._socket.close()
+        log.debug("Closed socket to %s", self.endpoint)
+
+        # don't leave in-progress operations hanging
+        if not self.is_defunct:
+            self.error_all_requests(
+                ConnectionShutdown("Connection to %s was closed" % self.endpoint))
+
+    def handle_write(self, watcher, revents, errno=None):
+        if revents & libev.EV_ERROR:
+            if errno:
+                exc = IOError(errno, os.strerror(errno))
+            else:
+                exc = Exception("libev reported an error")
+
+            self.defunct(exc)
+            return
+
+        while True:
+            try:
+                with self._deque_lock:
+                    next_msg = self.deque.popleft()
+            except IndexError:
+                if not self._socket_writable:
+                    self._socket_writable = True
+                return
+
+            try:
+                sent = self._socket.send(next_msg)
+            except socket.error as err:
+                if (err.args[0] in NONBLOCKING or
+                        err.args[0] in (ssl.SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE)):
+                    if err.args[0] in NONBLOCKING:
+                        self._socket_writable = False
+                    with self._deque_lock:
+                        self.deque.appendleft(next_msg)
+                else:
+                    self.defunct(err)
+                return
+            else:
+                if sent < len(next_msg):
+                    with self._deque_lock:
+                        self.deque.appendleft(next_msg[sent:])
+                    # we've seen some cases that 0 is returned instead of NONBLOCKING. But usually,
+                    # we don't expect this to happen. https://bugs.python.org/issue20951
+                    if sent == 0:
+                        self._socket_writable = False
+                        return
+
+    def handle_read(self, watcher, revents, errno=None):
+        if revents & libev.EV_ERROR:
+            if errno:
+                exc = IOError(errno, os.strerror(errno))
+            else:
+                exc = Exception("libev reported an error")
+
+            self.defunct(exc)
+            return
+        try:
+            while True:
+                buf = self._socket.recv(self.in_buffer_size)
+                self._iobuf.write(buf)
+                if len(buf) < self.in_buffer_size:
+                    break
+        except socket.error as err:
+            if isinstance(err, ssl.SSLError):
+                if err.args[0] in (ssl.SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE):
+                    if not self._iobuf.tell():
+                        return
+                else:
+                    self.defunct(err)
+                    return
+            elif err.args[0] in NONBLOCKING:
+                if not self._iobuf.tell():
+                    return
+            else:
+                self.defunct(err)
+                return
+
+        if self._iobuf.tell():
+            self.process_io_buffer()
+        else:
+            log.debug("Connection %s closed by server", self)
+            self.close()
+
+    def push(self, data):
+        sabs = self.out_buffer_size
+        if len(data) > sabs:
+            chunks = []
+            for i in range(0, len(data), sabs):
+                chunks.append(data[i:i + sabs])
+        else:
+            chunks = [data]
+
+        with self._deque_lock:
+            self.deque.extend(chunks)
+            _global_loop.notify()
diff --git a/llm/Lib/site-packages/cassandra/io/libevwrapper.c b/llm/Lib/site-packages/cassandra/io/libevwrapper.c
new file mode 100644
index 0000000000000000000000000000000000000000..ce5b98eb4967384edb8a738d4d93af53d116061a
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/io/libevwrapper.c
@@ -0,0 +1,675 @@
+#include <Python.h>
+#include <ev.h>
+
+typedef struct libevwrapper_Loop {
+    PyObject_HEAD
+    struct ev_loop *loop;
+} libevwrapper_Loop;
+
+static void
+Loop_dealloc(libevwrapper_Loop *self) {
+    ev_loop_destroy(self->loop);
+    Py_TYPE(self)->tp_free((PyObject *)self);
+};
+
+static PyObject*
+Loop_new(PyTypeObject *type, PyObject *args, PyObject *kwds) {
+    libevwrapper_Loop *self;
+
+    self = (libevwrapper_Loop *)type->tp_alloc(type, 0);
+    if (self != NULL) {
+        self->loop = ev_loop_new(EVBACKEND_SELECT);
+        if (!self->loop) {
+            PyErr_SetString(PyExc_Exception, "Error getting new ev loop");
+            Py_DECREF(self);
+            return NULL;
+        }
+    }
+    return (PyObject *)self;
+};
+
+static int
+Loop_init(libevwrapper_Loop *self, PyObject *args, PyObject *kwds) {
+    if (!PyArg_ParseTuple(args, "")) {
+        PyErr_SetString(PyExc_TypeError, "Loop.__init__() takes no arguments");
+        return -1;
+    }
+    return 0;
+};
+
+static PyObject *
+Loop_start(libevwrapper_Loop *self, PyObject *args) {
+    Py_BEGIN_ALLOW_THREADS
+    ev_run(self->loop, 0);
+    Py_END_ALLOW_THREADS
+    Py_RETURN_NONE;
+};
+
+static PyObject *
+Loop_unref(libevwrapper_Loop *self, PyObject *args) {
+    ev_unref(self->loop);
+    Py_RETURN_NONE;
+}
+
+static PyMethodDef Loop_methods[] = {
+    {"start", (PyCFunction)Loop_start, METH_NOARGS, "Start the event loop"},
+    {"unref", (PyCFunction)Loop_unref, METH_NOARGS, "Unrefrence the event loop"},
+    {NULL} /* Sentinel */
+};
+
+static
+PyTypeObject libevwrapper_LoopType = {
+    PyVarObject_HEAD_INIT(NULL, 0)
+    "cassandra.io.libevwrapper.Loop",/*tp_name*/
+    sizeof(libevwrapper_Loop),       /*tp_basicsize*/
+    0,                               /*tp_itemsize*/
+    (destructor)Loop_dealloc,        /*tp_dealloc*/
+    0,                               /*tp_print*/
+    0,                               /*tp_getattr*/
+    0,                               /*tp_setattr*/
+    0,                               /*tp_compare*/
+    0,                               /*tp_repr*/
+    0,                               /*tp_as_number*/
+    0,                               /*tp_as_sequence*/
+    0,                               /*tp_as_mapping*/
+    0,                               /*tp_hash */
+    0,                               /*tp_call*/
+    0,                               /*tp_str*/
+    0,                               /*tp_getattro*/
+    0,                               /*tp_setattro*/
+    0,                               /*tp_as_buffer*/
+    Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /*tp_flags*/
+    "Loop objects",                  /* tp_doc */
+    0,                               /* tp_traverse */
+    0,                               /* tp_clear */
+    0,                               /* tp_richcompare */
+    0,                               /* tp_weaklistoffset */
+    0,                               /* tp_iter */
+    0,                               /* tp_iternext */
+    Loop_methods,                    /* tp_methods */
+    0,                               /* tp_members */
+    0,                               /* tp_getset */
+    0,                               /* tp_base */
+    0,                               /* tp_dict */
+    0,                               /* tp_descr_get */
+    0,                               /* tp_descr_set */
+    0,                               /* tp_dictoffset */
+    (initproc)Loop_init,             /* tp_init */
+    0,                               /* tp_alloc */
+    Loop_new,                        /* tp_new */
+};
+
+typedef struct libevwrapper_IO {
+    PyObject_HEAD
+    struct ev_io io;
+    struct libevwrapper_Loop *loop;
+    PyObject *callback;
+} libevwrapper_IO;
+
+static void
+IO_dealloc(libevwrapper_IO *self) {
+    Py_XDECREF(self->loop);
+    Py_XDECREF(self->callback);
+    Py_TYPE(self)->tp_free((PyObject *)self);
+};
+
+static void io_callback(struct ev_loop *loop, ev_io *watcher, int revents) {
+    libevwrapper_IO *self = watcher->data;
+    PyObject *result;
+    PyGILState_STATE gstate = PyGILState_Ensure();
+    if (revents & EV_ERROR && errno) {
+        result = PyObject_CallFunction(self->callback, "Obi", self, revents, errno);
+    } else {
+        result = PyObject_CallFunction(self->callback, "Ob", self, revents);
+    }
+    if (!result) {
+        PyErr_WriteUnraisable(self->callback);
+    }
+    Py_XDECREF(result);
+    PyGILState_Release(gstate);
+};
+
+static int
+IO_init(libevwrapper_IO *self, PyObject *args, PyObject *kwds) {
+    PyObject *socket;
+    PyObject *callback;
+    PyObject *loop;
+    int io_flags = 0, fd = -1;
+    struct ev_io *io = NULL;
+
+    if (!PyArg_ParseTuple(args, "OiOO", &socket, &io_flags, &loop, &callback)) {
+        return -1;
+    }
+
+    if (loop) {
+        Py_INCREF(loop);
+        self->loop = (libevwrapper_Loop *)loop;
+    }
+
+    if (callback) {
+        if (!PyCallable_Check(callback)) {
+            PyErr_SetString(PyExc_TypeError, "callback parameter must be callable");
+            Py_XDECREF(loop);
+            return -1;
+        }
+        Py_INCREF(callback);
+        self->callback = callback;
+    }
+
+    fd = PyObject_AsFileDescriptor(socket);
+    if (fd == -1) {
+        PyErr_SetString(PyExc_TypeError, "unable to get file descriptor from socket");
+        Py_XDECREF(callback);
+        Py_XDECREF(loop);
+        return -1;
+    }
+    io = &(self->io);
+    ev_io_init(io, io_callback, fd, io_flags);
+    self->io.data = self;
+    return 0;
+}
+
+static PyObject*
+IO_start(libevwrapper_IO *self, PyObject *args) {
+    ev_io_start(self->loop->loop, &self->io);
+    Py_RETURN_NONE;
+}
+
+static PyObject*
+IO_stop(libevwrapper_IO *self, PyObject *args) {
+    ev_io_stop(self->loop->loop, &self->io);
+    Py_RETURN_NONE;
+}
+
+static PyObject*
+IO_is_active(libevwrapper_IO *self, PyObject *args) {
+    struct ev_io *io = &(self->io);
+    return PyBool_FromLong(ev_is_active(io));
+}
+
+static PyObject*
+IO_is_pending(libevwrapper_IO *self, PyObject *args) {
+    struct ev_io *io = &(self->io);
+    return PyBool_FromLong(ev_is_pending(io));
+}
+
+static PyMethodDef IO_methods[] = {
+    {"start", (PyCFunction)IO_start, METH_NOARGS, "Start the watcher"},
+    {"stop", (PyCFunction)IO_stop, METH_NOARGS, "Stop the watcher"},
+    {"is_active", (PyCFunction)IO_is_active, METH_NOARGS, "Is the watcher active?"},
+    {"is_pending", (PyCFunction)IO_is_pending, METH_NOARGS, "Is the watcher pending?"},
+    {NULL}  /* Sentinal */
+};
+
+static PyTypeObject libevwrapper_IOType = {
+    PyVarObject_HEAD_INIT(NULL, 0)
+    "cassandra.io.libevwrapper.IO",  /*tp_name*/
+    sizeof(libevwrapper_IO),         /*tp_basicsize*/
+    0,                               /*tp_itemsize*/
+    (destructor)IO_dealloc,          /*tp_dealloc*/
+    0,                               /*tp_print*/
+    0,                               /*tp_getattr*/
+    0,                               /*tp_setattr*/
+    0,                               /*tp_compare*/
+    0,                               /*tp_repr*/
+    0,                               /*tp_as_number*/
+    0,                               /*tp_as_sequence*/
+    0,                               /*tp_as_mapping*/
+    0,                               /*tp_hash */
+    0,                               /*tp_call*/
+    0,                               /*tp_str*/
+    0,                               /*tp_getattro*/
+    0,                               /*tp_setattro*/
+    0,                               /*tp_as_buffer*/
+    Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /*tp_flags*/
+    "IO objects",                    /* tp_doc */
+    0,                               /* tp_traverse */
+    0,                               /* tp_clear */
+    0,                               /* tp_richcompare */
+    0,                               /* tp_weaklistoffset */
+    0,                               /* tp_iter */
+    0,                               /* tp_iternext */
+    IO_methods,                      /* tp_methods */
+    0,                               /* tp_members */
+    0,                               /* tp_getset */
+    0,                               /* tp_base */
+    0,                               /* tp_dict */
+    0,                               /* tp_descr_get */
+    0,                               /* tp_descr_set */
+    0,                               /* tp_dictoffset */
+    (initproc)IO_init,               /* tp_init */
+};
+
+typedef struct libevwrapper_Async {
+    PyObject_HEAD
+    struct ev_async async;
+    struct libevwrapper_Loop *loop;
+} libevwrapper_Async;
+
+static void
+Async_dealloc(libevwrapper_Async *self) {
+    Py_XDECREF(self->loop);
+    Py_TYPE(self)->tp_free((PyObject *)self);
+};
+
+static void async_callback(EV_P_ ev_async *watcher, int revents) {};
+
+static int
+Async_init(libevwrapper_Async *self, PyObject *args, PyObject *kwds) {
+    PyObject *loop;
+    static char *kwlist[] = {"loop", NULL};
+    struct ev_async *async = NULL;
+
+    if (!PyArg_ParseTupleAndKeywords(args, kwds, "O", kwlist, &loop)) {
+        PyErr_SetString(PyExc_TypeError, "unable to get file descriptor from socket");
+        return -1;
+    }
+
+    if (loop) {
+        Py_INCREF(loop);
+        self->loop = (libevwrapper_Loop *)loop;
+    } else {
+        return -1;
+    }
+    async = &(self->async);
+    ev_async_init(async, async_callback);
+    return 0;
+};
+
+static PyObject *
+Async_start(libevwrapper_Async *self, PyObject *args) {
+    ev_async_start(self->loop->loop, &self->async);
+    Py_RETURN_NONE;
+}
+
+static PyObject *
+Async_send(libevwrapper_Async *self, PyObject *args) {
+    ev_async_send(self->loop->loop, &self->async);
+    Py_RETURN_NONE;
+};
+
+static PyMethodDef Async_methods[] = {
+    {"start", (PyCFunction)Async_start, METH_NOARGS, "Start the watcher"},
+    {"send", (PyCFunction)Async_send, METH_NOARGS, "Notify the event loop"},
+    {NULL} /* Sentinel */
+};
+
+static PyTypeObject libevwrapper_AsyncType = {
+    PyVarObject_HEAD_INIT(NULL, 0)
+    "cassandra.io.libevwrapper.Async", /*tp_name*/
+    sizeof(libevwrapper_Async),      /*tp_basicsize*/
+    0,                               /*tp_itemsize*/
+    (destructor)Async_dealloc,       /*tp_dealloc*/
+    0,                               /*tp_print*/
+    0,                               /*tp_getattr*/
+    0,                               /*tp_setattr*/
+    0,                               /*tp_compare*/
+    0,                               /*tp_repr*/
+    0,                               /*tp_as_number*/
+    0,                               /*tp_as_sequence*/
+    0,                               /*tp_as_mapping*/
+    0,                               /*tp_hash */
+    0,                               /*tp_call*/
+    0,                               /*tp_str*/
+    0,                               /*tp_getattro*/
+    0,                               /*tp_setattro*/
+    0,                               /*tp_as_buffer*/
+    Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /*tp_flags*/
+    "Async objects",                 /* tp_doc */
+    0,                               /* tp_traverse */
+    0,                               /* tp_clear */
+    0,                               /* tp_richcompare */
+    0,                               /* tp_weaklistoffset */
+    0,                               /* tp_iter */
+    0,                               /* tp_iternext */
+    Async_methods,                   /* tp_methods */
+    0,                               /* tp_members */
+    0,                               /* tp_getset */
+    0,                               /* tp_base */
+    0,                               /* tp_dict */
+    0,                               /* tp_descr_get */
+    0,                               /* tp_descr_set */
+    0,                               /* tp_dictoffset */
+    (initproc)Async_init,            /* tp_init */
+};
+
+typedef struct libevwrapper_Prepare {
+    PyObject_HEAD
+    struct ev_prepare prepare;
+    struct libevwrapper_Loop *loop;
+    PyObject *callback;
+} libevwrapper_Prepare;
+
+static void
+Prepare_dealloc(libevwrapper_Prepare *self) {
+    Py_XDECREF(self->loop);
+    Py_XDECREF(self->callback);
+    Py_TYPE(self)->tp_free((PyObject *)self);
+}
+
+static void prepare_callback(struct ev_loop *loop, ev_prepare *watcher, int revents) {
+    libevwrapper_Prepare *self = watcher->data;
+    PyObject *result = NULL;
+    PyGILState_STATE gstate;
+
+    gstate = PyGILState_Ensure();
+    result = PyObject_CallFunction(self->callback, "O", self);
+    if (!result) {
+        PyErr_WriteUnraisable(self->callback);
+    }
+    Py_XDECREF(result);
+
+    PyGILState_Release(gstate);
+}
+
+static int
+Prepare_init(libevwrapper_Prepare *self, PyObject *args, PyObject *kwds) {
+    PyObject *callback;
+    PyObject *loop;
+    struct ev_prepare *prepare = NULL;
+
+    if (!PyArg_ParseTuple(args, "OO", &loop, &callback)) {
+        return -1;
+    }
+
+    if (loop) {
+        Py_INCREF(loop);
+        self->loop = (libevwrapper_Loop *)loop;
+    } else {
+        return -1;
+    }
+
+    if (callback) {
+        if (!PyCallable_Check(callback)) {
+            PyErr_SetString(PyExc_TypeError, "callback parameter must be callable");
+            Py_XDECREF(loop);
+            return -1;
+        }
+        Py_INCREF(callback);
+        self->callback = callback;
+    }
+    prepare = &(self->prepare);
+    ev_prepare_init(prepare, prepare_callback);
+    self->prepare.data = self;
+    return 0;
+}
+
+static PyObject *
+Prepare_start(libevwrapper_Prepare *self, PyObject *args) {
+    ev_prepare_start(self->loop->loop, &self->prepare);
+    Py_RETURN_NONE;
+}
+
+static PyObject *
+Prepare_stop(libevwrapper_Prepare *self, PyObject *args) {
+    ev_prepare_stop(self->loop->loop, &self->prepare);
+    Py_RETURN_NONE;
+}
+
+static PyMethodDef Prepare_methods[] = {
+    {"start", (PyCFunction)Prepare_start, METH_NOARGS, "Start the Prepare watcher"},
+    {"stop", (PyCFunction)Prepare_stop, METH_NOARGS, "Stop the Prepare watcher"},
+    {NULL}  /* Sentinal */
+};
+
+static PyTypeObject libevwrapper_PrepareType = {
+    PyVarObject_HEAD_INIT(NULL, 0)
+    "cassandra.io.libevwrapper.Prepare",  /*tp_name*/
+    sizeof(libevwrapper_Prepare),    /*tp_basicsize*/
+    0,                               /*tp_itemsize*/
+    (destructor)Prepare_dealloc,     /*tp_dealloc*/
+    0,                               /*tp_print*/
+    0,                               /*tp_getattr*/
+    0,                               /*tp_setattr*/
+    0,                               /*tp_compare*/
+    0,                               /*tp_repr*/
+    0,                               /*tp_as_number*/
+    0,                               /*tp_as_sequence*/
+    0,                               /*tp_as_mapping*/
+    0,                               /*tp_hash */
+    0,                               /*tp_call*/
+    0,                               /*tp_str*/
+    0,                               /*tp_getattro*/
+    0,                               /*tp_setattro*/
+    0,                               /*tp_as_buffer*/
+    Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /*tp_flags*/
+    "Prepare objects",               /* tp_doc */
+    0,                               /* tp_traverse */
+    0,                               /* tp_clear */
+    0,                               /* tp_richcompare */
+    0,                               /* tp_weaklistoffset */
+    0,                               /* tp_iter */
+    0,                               /* tp_iternext */
+    Prepare_methods,                 /* tp_methods */
+    0,                               /* tp_members */
+    0,                               /* tp_getset */
+    0,                               /* tp_base */
+    0,                               /* tp_dict */
+    0,                               /* tp_descr_get */
+    0,                               /* tp_descr_set */
+    0,                               /* tp_dictoffset */
+    (initproc)Prepare_init,          /* tp_init */
+};
+
+typedef struct libevwrapper_Timer {
+    PyObject_HEAD
+    struct ev_timer timer;
+    struct libevwrapper_Loop *loop;
+    PyObject *callback;
+} libevwrapper_Timer;
+
+static void
+Timer_dealloc(libevwrapper_Timer *self) {
+    Py_XDECREF(self->loop);
+    Py_XDECREF(self->callback);
+    Py_TYPE(self)->tp_free((PyObject *)self);
+}
+
+static void timer_callback(struct ev_loop *loop, ev_timer *watcher, int revents) {
+    libevwrapper_Timer *self = watcher->data;
+
+    PyObject *result = NULL;
+    PyGILState_STATE gstate;
+
+    gstate = PyGILState_Ensure();
+    result = PyObject_CallFunction(self->callback, NULL);
+    if (!result) {
+        PyErr_WriteUnraisable(self->callback);
+    }
+    Py_XDECREF(result);
+
+    PyGILState_Release(gstate);
+}
+
+static int
+Timer_init(libevwrapper_Timer *self, PyObject *args, PyObject *kwds) {
+    PyObject *callback;
+    PyObject *loop;
+
+    if (!PyArg_ParseTuple(args, "OO", &loop, &callback)) {
+        return -1;
+    }
+
+    if (loop) {
+        Py_INCREF(loop);
+        self->loop = (libevwrapper_Loop *)loop;
+    } else {
+        return -1;
+    }
+
+    if (callback) {
+        if (!PyCallable_Check(callback)) {
+            PyErr_SetString(PyExc_TypeError, "callback parameter must be callable");
+            Py_XDECREF(loop);
+            return -1;
+        }
+        Py_INCREF(callback);
+        self->callback = callback;
+    }
+    ev_init(&self->timer, timer_callback);
+    self->timer.data = self;
+    return 0;
+}
+
+static PyObject *
+Timer_start(libevwrapper_Timer *self, PyObject *args) {
+    double timeout;
+    if (!PyArg_ParseTuple(args, "d", &timeout)) {
+        return NULL;
+    }
+    /* some tiny non-zero number to avoid zero, and
+     make it run immediately for negative timeouts */
+    self->timer.repeat = fmax(timeout, 0.000000001);
+    ev_timer_again(self->loop->loop, &self->timer);
+    Py_RETURN_NONE;
+}
+
+static PyObject *
+Timer_stop(libevwrapper_Timer *self, PyObject *args) {
+    ev_timer_stop(self->loop->loop, &self->timer);
+    Py_RETURN_NONE;
+}
+
+static PyMethodDef Timer_methods[] = {
+    {"start", (PyCFunction)Timer_start, METH_VARARGS, "Start the Timer watcher"},
+    {"stop", (PyCFunction)Timer_stop, METH_NOARGS, "Stop the Timer watcher"},
+    {NULL}  /* Sentinal */
+};
+
+static PyTypeObject libevwrapper_TimerType = {
+    PyVarObject_HEAD_INIT(NULL, 0)
+    "cassandra.io.libevwrapper.Timer",  /*tp_name*/
+    sizeof(libevwrapper_Timer),      /*tp_basicsize*/
+    0,                               /*tp_itemsize*/
+    (destructor)Timer_dealloc,       /*tp_dealloc*/
+    0,                               /*tp_print*/
+    0,                               /*tp_getattr*/
+    0,                               /*tp_setattr*/
+    0,                               /*tp_compare*/
+    0,                               /*tp_repr*/
+    0,                               /*tp_as_number*/
+    0,                               /*tp_as_sequence*/
+    0,                               /*tp_as_mapping*/
+    0,                               /*tp_hash */
+    0,                               /*tp_call*/
+    0,                               /*tp_str*/
+    0,                               /*tp_getattro*/
+    0,                               /*tp_setattro*/
+    0,                               /*tp_as_buffer*/
+    Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /*tp_flags*/
+    "Timer objects",                 /* tp_doc */
+    0,                               /* tp_traverse */
+    0,                               /* tp_clear */
+    0,                               /* tp_richcompare */
+    0,                               /* tp_weaklistoffset */
+    0,                               /* tp_iter */
+    0,                               /* tp_iternext */
+    Timer_methods,                   /* tp_methods */
+    0,                               /* tp_members */
+    0,                               /* tp_getset */
+    0,                               /* tp_base */
+    0,                               /* tp_dict */
+    0,                               /* tp_descr_get */
+    0,                               /* tp_descr_set */
+    0,                               /* tp_dictoffset */
+    (initproc)Timer_init,            /* tp_init */
+};
+
+
+static PyMethodDef module_methods[] = {
+    {NULL}  /* Sentinal */
+};
+
+PyDoc_STRVAR(module_doc,
+"libev wrapper methods");
+
+#if PY_MAJOR_VERSION >= 3
+static struct PyModuleDef moduledef = {
+    PyModuleDef_HEAD_INIT,
+    "libevwrapper",
+    module_doc,
+    -1,
+    module_methods,
+    NULL,
+    NULL,
+    NULL,
+    NULL
+};
+
+#define INITERROR return NULL
+
+PyObject *
+PyInit_libevwrapper(void)
+
+# else
+# define INITERROR return
+
+void
+initlibevwrapper(void)
+#endif
+{
+    PyObject *module = NULL;
+
+    if (PyType_Ready(&libevwrapper_LoopType) < 0)
+        INITERROR;
+
+    libevwrapper_IOType.tp_new = PyType_GenericNew;
+    if (PyType_Ready(&libevwrapper_IOType) < 0)
+        INITERROR;
+
+    libevwrapper_PrepareType.tp_new = PyType_GenericNew;
+    if (PyType_Ready(&libevwrapper_PrepareType) < 0)
+        INITERROR;
+
+    libevwrapper_AsyncType.tp_new = PyType_GenericNew;
+    if (PyType_Ready(&libevwrapper_AsyncType) < 0)
+        INITERROR;
+
+    libevwrapper_TimerType.tp_new = PyType_GenericNew;
+    if (PyType_Ready(&libevwrapper_TimerType) < 0)
+        INITERROR;
+
+# if PY_MAJOR_VERSION >= 3
+    module = PyModule_Create(&moduledef);
+# else
+    module = Py_InitModule3("libevwrapper", module_methods, module_doc);
+# endif
+
+    if (module == NULL)
+        INITERROR;
+
+    if (PyModule_AddIntConstant(module, "EV_READ", EV_READ) == -1)
+        INITERROR;
+    if (PyModule_AddIntConstant(module, "EV_WRITE", EV_WRITE) == -1)
+        INITERROR;
+    if (PyModule_AddIntConstant(module, "EV_ERROR", EV_ERROR) == -1)
+        INITERROR;
+
+    Py_INCREF(&libevwrapper_LoopType);
+    if (PyModule_AddObject(module, "Loop", (PyObject *)&libevwrapper_LoopType) == -1)
+        INITERROR;
+
+    Py_INCREF(&libevwrapper_IOType);
+    if (PyModule_AddObject(module, "IO", (PyObject *)&libevwrapper_IOType) == -1)
+        INITERROR;
+
+    Py_INCREF(&libevwrapper_PrepareType);
+    if (PyModule_AddObject(module, "Prepare", (PyObject *)&libevwrapper_PrepareType) == -1)
+        INITERROR;
+
+    Py_INCREF(&libevwrapper_AsyncType);
+    if (PyModule_AddObject(module, "Async", (PyObject *)&libevwrapper_AsyncType) == -1)
+        INITERROR;
+
+    Py_INCREF(&libevwrapper_TimerType);
+    if (PyModule_AddObject(module, "Timer", (PyObject *)&libevwrapper_TimerType) == -1)
+        INITERROR;
+
+    if (!PyEval_ThreadsInitialized()) {
+        PyEval_InitThreads();
+    }
+
+#if PY_MAJOR_VERSION >= 3
+    return module;
+#endif
+}
diff --git a/llm/Lib/site-packages/cassandra/io/twistedreactor.py b/llm/Lib/site-packages/cassandra/io/twistedreactor.py
new file mode 100644
index 0000000000000000000000000000000000000000..efe8dd6ba6e61b8036878e14e191041ab491fdd8
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/io/twistedreactor.py
@@ -0,0 +1,303 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""
+Module that implements an event loop based on twisted
+( https://twistedmatrix.com ).
+"""
+import atexit
+import logging
+import time
+from functools import partial
+from threading import Thread, Lock
+import weakref
+
+from twisted.internet import reactor, protocol
+from twisted.internet.endpoints import connectProtocol, TCP4ClientEndpoint, SSL4ClientEndpoint
+from twisted.internet.interfaces import IOpenSSLClientConnectionCreator
+from twisted.python.failure import Failure
+from zope.interface import implementer
+
+from cassandra.connection import Connection, ConnectionShutdown, Timer, TimerManager, ConnectionException
+
+try:
+    from OpenSSL import SSL
+    _HAS_SSL = True
+except ImportError as e:
+    _HAS_SSL = False
+    import_exception = e
+log = logging.getLogger(__name__)
+
+
+def _cleanup(cleanup_weakref):
+    try:
+        cleanup_weakref()._cleanup()
+    except ReferenceError:
+        return
+
+
+class TwistedConnectionProtocol(protocol.Protocol):
+    """
+    Twisted Protocol class for handling data received and connection
+    made events.
+    """
+
+    def __init__(self, connection):
+        self.connection = connection
+
+    def dataReceived(self, data):
+        """
+        Callback function that is called when data has been received
+        on the connection.
+
+        Reaches back to the Connection object and queues the data for
+        processing.
+        """
+        self.connection._iobuf.write(data)
+        self.connection.handle_read()
+
+    def connectionMade(self):
+        """
+        Callback function that is called when a connection has succeeded.
+
+        Reaches back to the Connection object and confirms that the connection
+        is ready.
+        """
+        self.connection.client_connection_made(self.transport)
+
+    def connectionLost(self, reason):
+        # reason is a Failure instance
+        log.debug("Connect lost: %s", reason)
+        self.connection.defunct(reason.value)
+
+
+class TwistedLoop(object):
+
+    _lock = None
+    _thread = None
+    _timeout_task = None
+    _timeout = None
+
+    def __init__(self):
+        self._lock = Lock()
+        self._timers = TimerManager()
+
+    def maybe_start(self):
+        with self._lock:
+            if not reactor.running:
+                self._thread = Thread(target=reactor.run,
+                                      name="cassandra_driver_twisted_event_loop",
+                                      kwargs={'installSignalHandlers': False})
+                self._thread.daemon = True
+                self._thread.start()
+                atexit.register(partial(_cleanup, weakref.ref(self)))
+
+    def _cleanup(self):
+        if self._thread:
+            reactor.callFromThread(reactor.stop)
+            self._thread.join(timeout=1.0)
+            if self._thread.is_alive():
+                log.warning("Event loop thread could not be joined, so "
+                            "shutdown may not be clean. Please call "
+                            "Cluster.shutdown() to avoid this.")
+            log.debug("Event loop thread was joined")
+
+    def add_timer(self, timer):
+        self._timers.add_timer(timer)
+        # callFromThread to schedule from the loop thread, where
+        # the timeout task can safely be modified
+        reactor.callFromThread(self._schedule_timeout, timer.end)
+
+    def _schedule_timeout(self, next_timeout):
+        if next_timeout:
+            delay = max(next_timeout - time.time(), 0)
+            if self._timeout_task and self._timeout_task.active():
+                if next_timeout < self._timeout:
+                    self._timeout_task.reset(delay)
+                    self._timeout = next_timeout
+            else:
+                self._timeout_task = reactor.callLater(delay, self._on_loop_timer)
+                self._timeout = next_timeout
+
+    def _on_loop_timer(self):
+        self._timers.service_timeouts()
+        self._schedule_timeout(self._timers.next_timeout)
+
+
+@implementer(IOpenSSLClientConnectionCreator)
+class _SSLCreator(object):
+    def __init__(self, endpoint, ssl_context, ssl_options, check_hostname, timeout):
+        self.endpoint = endpoint
+        self.ssl_options = ssl_options
+        self.check_hostname = check_hostname
+        self.timeout = timeout
+
+        if ssl_context:
+            self.context = ssl_context
+        else:
+            self.context = SSL.Context(SSL.TLSv1_METHOD)
+            if "certfile" in self.ssl_options:
+                self.context.use_certificate_file(self.ssl_options["certfile"])
+            if "keyfile" in self.ssl_options:
+                self.context.use_privatekey_file(self.ssl_options["keyfile"])
+            if "ca_certs" in self.ssl_options:
+                self.context.load_verify_locations(self.ssl_options["ca_certs"])
+            if "cert_reqs" in self.ssl_options:
+                self.context.set_verify(
+                    self.ssl_options["cert_reqs"],
+                    callback=self.verify_callback
+                )
+        self.context.set_info_callback(self.info_callback)
+
+    def verify_callback(self, connection, x509, errnum, errdepth, ok):
+        return ok
+
+    def info_callback(self, connection, where, ret):
+        if where & SSL.SSL_CB_HANDSHAKE_DONE:
+            if self.check_hostname and self.endpoint.address != connection.get_peer_certificate().get_subject().commonName:
+                transport = connection.get_app_data()
+                transport.failVerification(Failure(ConnectionException("Hostname verification failed", self.endpoint)))
+
+    def clientConnectionForTLS(self, tlsProtocol):
+        connection = SSL.Connection(self.context, None)
+        connection.set_app_data(tlsProtocol)
+        if self.ssl_options and "server_hostname" in self.ssl_options:
+            connection.set_tlsext_host_name(self.ssl_options['server_hostname'].encode('ascii'))
+        return connection
+
+
+class TwistedConnection(Connection):
+    """
+    An implementation of :class:`.Connection` that utilizes the
+    Twisted event loop.
+    """
+
+    _loop = None
+
+    @classmethod
+    def initialize_reactor(cls):
+        if not cls._loop:
+            cls._loop = TwistedLoop()
+
+    @classmethod
+    def create_timer(cls, timeout, callback):
+        timer = Timer(timeout, callback)
+        cls._loop.add_timer(timer)
+        return timer
+
+    def __init__(self, *args, **kwargs):
+        """
+        Initialization method.
+
+        Note that we can't call reactor methods directly here because
+        it's not thread-safe, so we schedule the reactor/connection
+        stuff to be run from the event loop thread when it gets the
+        chance.
+        """
+        Connection.__init__(self, *args, **kwargs)
+
+        self.is_closed = True
+        self.connector = None
+        self.transport = None
+
+        reactor.callFromThread(self.add_connection)
+        self._loop.maybe_start()
+
+    def _check_pyopenssl(self):
+        if self.ssl_context or self.ssl_options:
+            if not _HAS_SSL:
+                raise ImportError(
+                    str(import_exception) +
+                    ', pyOpenSSL must be installed to enable SSL support with the Twisted event loop'
+                )
+
+    def add_connection(self):
+        """
+        Convenience function to connect and store the resulting
+        connector.
+        """
+        host, port = self.endpoint.resolve()
+        if self.ssl_context or self.ssl_options:
+            # Can't use optionsForClientTLS here because it *forces* hostname verification.
+            # Cool they enforce strong security, but we have to be able to turn it off
+            self._check_pyopenssl()
+
+            ssl_connection_creator = _SSLCreator(
+                self.endpoint,
+                self.ssl_context if self.ssl_context else None,
+                self.ssl_options,
+                self._check_hostname,
+                self.connect_timeout,
+            )
+
+            endpoint = SSL4ClientEndpoint(
+                reactor,
+                host,
+                port,
+                sslContextFactory=ssl_connection_creator,
+                timeout=self.connect_timeout,
+            )
+        else:
+            endpoint = TCP4ClientEndpoint(
+                reactor,
+                host,
+                port,
+                timeout=self.connect_timeout
+            )
+        connectProtocol(endpoint, TwistedConnectionProtocol(self))
+
+    def client_connection_made(self, transport):
+        """
+        Called by twisted protocol when a connection attempt has
+        succeeded.
+        """
+        with self.lock:
+            self.is_closed = False
+        self.transport = transport
+        self._send_options_message()
+
+    def close(self):
+        """
+        Disconnect and error-out all requests.
+        """
+        with self.lock:
+            if self.is_closed:
+                return
+            self.is_closed = True
+
+        log.debug("Closing connection (%s) to %s", id(self), self.endpoint)
+        reactor.callFromThread(self.transport.connector.disconnect)
+        log.debug("Closed socket to %s", self.endpoint)
+
+        if not self.is_defunct:
+            self.error_all_requests(
+                ConnectionShutdown("Connection to %s was closed" % self.endpoint))
+            # don't leave in-progress operations hanging
+            self.connected_event.set()
+
+    def handle_read(self):
+        """
+        Process the incoming data buffer.
+        """
+        self.process_io_buffer()
+
+    def push(self, data):
+        """
+        This function is called when outgoing data should be queued
+        for sending.
+
+        Note that we can't call transport.write() directly because
+        it is not thread-safe, so we schedule it to run from within
+        the event loop when it gets the chance.
+        """
+        reactor.callFromThread(self.transport.write, data)
diff --git a/llm/Lib/site-packages/cassandra/ioutils.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/ioutils.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..74a36a8295c2c75ee39978e8576b8e316f00ab92
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/ioutils.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/ioutils.pyx b/llm/Lib/site-packages/cassandra/ioutils.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..2887990535a244698777b085f271ac436f6aa3fc
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/ioutils.pyx
@@ -0,0 +1,47 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+include 'cython_marshal.pyx'
+from cassandra.buffer cimport Buffer, from_ptr_and_size
+
+from libc.stdint cimport int32_t
+from cassandra.bytesio cimport BytesIOReader
+
+
+cdef inline int get_buf(BytesIOReader reader, Buffer *buf_out) except -1:
+    """
+    Get a pointer into the buffer provided by BytesIOReader for the
+    next data item in the stream of values.
+
+    BEWARE:
+        If the next item has a zero negative size, the pointer will be set to NULL.
+        A negative size happens when the value is NULL in the database, whereas a
+        zero size may happen either for legacy reasons, or for data types such as
+        strings (which may be empty).
+    """
+    cdef Py_ssize_t raw_val_size = read_int(reader)
+    cdef char *ptr
+    if raw_val_size <= 0:
+        ptr = NULL
+    else:
+        ptr = reader.read(raw_val_size)
+
+    from_ptr_and_size(ptr, raw_val_size, buf_out)
+    return 0
+
+cdef inline int32_t read_int(BytesIOReader reader) except ?0xDEAD:
+    cdef Buffer buf
+    buf.ptr = reader.read(4)
+    buf.size = 4
+    return unpack_num[int32_t](&buf)
diff --git a/llm/Lib/site-packages/cassandra/marshal.py b/llm/Lib/site-packages/cassandra/marshal.py
new file mode 100644
index 0000000000000000000000000000000000000000..f7cb0b7abe268288c40aa9e62b911d2b088c4414
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/marshal.py
@@ -0,0 +1,145 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import struct
+
+
+def _make_packer(format_string):
+    packer = struct.Struct(format_string)
+    pack = packer.pack
+    unpack = lambda s: packer.unpack(s)[0]
+    return pack, unpack
+
+int64_pack, int64_unpack = _make_packer('>q')
+int32_pack, int32_unpack = _make_packer('>i')
+int16_pack, int16_unpack = _make_packer('>h')
+int8_pack, int8_unpack = _make_packer('>b')
+uint64_pack, uint64_unpack = _make_packer('>Q')
+uint32_pack, uint32_unpack = _make_packer('>I')
+uint32_le_pack, uint32_le_unpack = _make_packer('<I')
+uint16_pack, uint16_unpack = _make_packer('>H')
+uint8_pack, uint8_unpack = _make_packer('>B')
+float_pack, float_unpack = _make_packer('>f')
+double_pack, double_unpack = _make_packer('>d')
+
+# Special case for cassandra header
+header_struct = struct.Struct('>BBbB')
+header_pack = header_struct.pack
+header_unpack = header_struct.unpack
+
+# in protocol version 3 and higher, the stream ID is two bytes
+v3_header_struct = struct.Struct('>BBhB')
+v3_header_pack = v3_header_struct.pack
+v3_header_unpack = v3_header_struct.unpack
+
+
+def varint_unpack(term):
+    val = int(''.join("%02x" % i for i in term), 16)
+    if (term[0] & 128) != 0:
+        len_term = len(term)  # pulling this out of the expression to avoid overflow in cython optimized code
+        val -= 1 << (len_term * 8)
+    return val
+
+
+def bit_length(n):
+    return int.bit_length(n)
+
+
+def varint_pack(big):
+    pos = True
+    if big == 0:
+        return b'\x00'
+    if big < 0:
+        bytelength = bit_length(abs(big) - 1) // 8 + 1
+        big = (1 << bytelength * 8) + big
+        pos = False
+    revbytes = bytearray()
+    while big > 0:
+        revbytes.append(big & 0xff)
+        big >>= 8
+    if pos and revbytes[-1] & 0x80:
+        revbytes.append(0)
+    revbytes.reverse()
+    return bytes(revbytes)
+
+
+point_be = struct.Struct('>dd')
+point_le = struct.Struct('<dd')
+
+circle_be = struct.Struct('>ddd')
+circle_le = struct.Struct('<ddd')
+
+
+def encode_zig_zag(n):
+    return (n << 1) ^ (n >> 63)
+
+
+def decode_zig_zag(n):
+    return (n >> 1) ^ -(n & 1)
+
+
+def vints_unpack(term):  # noqa
+    values = []
+    n = 0
+    while n < len(term):
+        first_byte = term[n]
+
+        if (first_byte & 128) == 0:
+            val = first_byte
+        else:
+            num_extra_bytes = 8 - (~first_byte & 0xff).bit_length()
+            val = first_byte & (0xff >> num_extra_bytes)
+            end = n + num_extra_bytes
+            while n < end:
+                n += 1
+                val <<= 8
+                val |= term[n] & 0xff
+
+        n += 1
+        values.append(decode_zig_zag(val))
+
+    return tuple(values)
+
+
+def vints_pack(values):
+    revbytes = bytearray()
+    values = [int(v) for v in values[::-1]]
+    for value in values:
+        v = encode_zig_zag(value)
+        if v < 128:
+            revbytes.append(v)
+        else:
+            num_extra_bytes = 0
+            num_bits = v.bit_length()
+            # We need to reserve (num_extra_bytes+1) bits in the first byte
+            # ie. with 1 extra byte, the first byte needs to be something like '10XXXXXX' # 2 bits reserved
+            # ie. with 8 extra bytes, the first byte needs to be '11111111'  # 8 bits reserved
+            reserved_bits = num_extra_bytes + 1
+            while num_bits > (8-(reserved_bits)):
+                num_extra_bytes += 1
+                num_bits -= 8
+                reserved_bits = min(num_extra_bytes + 1, 8)
+                revbytes.append(v & 0xff)
+                v >>= 8
+
+            if num_extra_bytes > 8:
+                raise ValueError('Value %d is too big and cannot be encoded as vint' % value)
+
+            # We can now store the last bits in the first byte
+            n = 8 - num_extra_bytes
+            v |= (0xff >> n << n)
+            revbytes.append(abs(v))
+
+    revbytes.reverse()
+    return bytes(revbytes)
diff --git a/llm/Lib/site-packages/cassandra/metadata.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/metadata.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..06b0acdb8ac517ba87dc4edf4f5ce7a105530ba2
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/metadata.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/metadata.py b/llm/Lib/site-packages/cassandra/metadata.py
new file mode 100644
index 0000000000000000000000000000000000000000..14e0899580078ad51c94480c0bb5f247cedae6f4
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/metadata.py
@@ -0,0 +1,3412 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from binascii import unhexlify
+from bisect import bisect_left
+from collections import defaultdict
+from collections.abc import Mapping
+from functools import total_ordering
+from hashlib import md5
+import json
+import logging
+import re
+import sys
+from threading import RLock
+import struct
+import random
+
+murmur3 = None
+try:
+    from cassandra.murmur3 import murmur3
+except ImportError as e:
+    pass
+
+from cassandra import SignatureDescriptor, ConsistencyLevel, InvalidRequest, Unauthorized
+import cassandra.cqltypes as types
+from cassandra.encoder import Encoder
+from cassandra.marshal import varint_unpack
+from cassandra.protocol import QueryMessage
+from cassandra.query import dict_factory, bind_params
+from cassandra.util import OrderedDict, Version
+from cassandra.pool import HostDistance
+from cassandra.connection import EndPoint
+
+log = logging.getLogger(__name__)
+
+cql_keywords = set((
+    'add', 'aggregate', 'all', 'allow', 'alter', 'and', 'apply', 'as', 'asc', 'ascii', 'authorize', 'batch', 'begin',
+    'bigint', 'blob', 'boolean', 'by', 'called', 'clustering', 'columnfamily', 'compact', 'contains', 'count',
+    'counter', 'create', 'custom', 'date', 'decimal', 'default', 'delete', 'desc', 'describe', 'deterministic', 'distinct', 'double', 'drop',
+    'entries', 'execute', 'exists', 'filtering', 'finalfunc', 'float', 'from', 'frozen', 'full', 'function',
+    'functions', 'grant', 'if', 'in', 'index', 'inet', 'infinity', 'initcond', 'input', 'insert', 'int', 'into', 'is', 'json',
+    'key', 'keys', 'keyspace', 'keyspaces', 'language', 'limit', 'list', 'login', 'map', 'materialized', 'mbean', 'mbeans', 'modify', 'monotonic',
+    'nan', 'nologin', 'norecursive', 'nosuperuser', 'not', 'null', 'of', 'on', 'options', 'or', 'order', 'password', 'permission',
+    'permissions', 'primary', 'rename', 'replace', 'returns', 'revoke', 'role', 'roles', 'schema', 'select', 'set',
+    'sfunc', 'smallint', 'static', 'storage', 'stype', 'superuser', 'table', 'text', 'time', 'timestamp', 'timeuuid',
+    'tinyint', 'to', 'token', 'trigger', 'truncate', 'ttl', 'tuple', 'type', 'unlogged', 'unset', 'update', 'use', 'user',
+    'users', 'using', 'uuid', 'values', 'varchar', 'varint', 'view', 'where', 'with', 'writetime',
+
+    # DSE specifics
+    "node", "nodes", "plan", "active", "application", "applications", "java", "executor", "executors", "std_out", "std_err",
+    "renew", "delegation", "no", "redact", "token", "lowercasestring", "cluster", "authentication", "schemes", "scheme",
+    "internal", "ldap", "kerberos", "remote", "object", "method", "call", "calls", "search", "schema", "config", "rows",
+    "columns", "profiles", "commit", "reload", "rebuild", "field", "workpool", "any", "submission", "indices",
+    "restrict", "unrestrict"
+))
+"""
+Set of keywords in CQL.
+
+Derived from .../cassandra/src/java/org/apache/cassandra/cql3/Cql.g
+"""
+
+cql_keywords_unreserved = set((
+    'aggregate', 'all', 'as', 'ascii', 'bigint', 'blob', 'boolean', 'called', 'clustering', 'compact', 'contains',
+    'count', 'counter', 'custom', 'date', 'decimal', 'deterministic', 'distinct', 'double', 'exists', 'filtering', 'finalfunc', 'float',
+    'frozen', 'function', 'functions', 'inet', 'initcond', 'input', 'int', 'json', 'key', 'keys', 'keyspaces',
+    'language', 'list', 'login', 'map', 'monotonic', 'nologin', 'nosuperuser', 'options', 'password', 'permission', 'permissions',
+    'returns', 'role', 'roles', 'sfunc', 'smallint', 'static', 'storage', 'stype', 'superuser', 'text', 'time',
+    'timestamp', 'timeuuid', 'tinyint', 'trigger', 'ttl', 'tuple', 'type', 'user', 'users', 'uuid', 'values', 'varchar',
+    'varint', 'writetime'
+))
+"""
+Set of unreserved keywords in CQL.
+
+Derived from .../cassandra/src/java/org/apache/cassandra/cql3/Cql.g
+"""
+
+cql_keywords_reserved = cql_keywords - cql_keywords_unreserved
+"""
+Set of reserved keywords in CQL.
+"""
+
+_encoder = Encoder()
+
+
+class Metadata(object):
+    """
+    Holds a representation of the cluster schema and topology.
+    """
+
+    cluster_name = None
+    """ The string name of the cluster. """
+
+    keyspaces = None
+    """
+    A map from keyspace names to matching :class:`~.KeyspaceMetadata` instances.
+    """
+
+    partitioner = None
+    """
+    The string name of the partitioner for the cluster.
+    """
+
+    token_map = None
+    """ A :class:`~.TokenMap` instance describing the ring topology. """
+
+    dbaas = False
+    """ A boolean indicating if connected to a DBaaS cluster """
+
+    def __init__(self):
+        self.keyspaces = {}
+        self.dbaas = False
+        self._hosts = {}
+        self._hosts_lock = RLock()
+
+    def export_schema_as_string(self):
+        """
+        Returns a string that can be executed as a query in order to recreate
+        the entire schema.  The string is formatted to be human readable.
+        """
+        return "\n\n".join(ks.export_as_string() for ks in self.keyspaces.values())
+
+    def refresh(self, connection, timeout, target_type=None, change_type=None, **kwargs):
+
+        server_version = self.get_host(connection.endpoint).release_version
+        dse_version = self.get_host(connection.endpoint).dse_version
+        parser = get_schema_parser(connection, server_version, dse_version, timeout)
+
+        if not target_type:
+            self._rebuild_all(parser)
+            return
+
+        tt_lower = target_type.lower()
+        try:
+            parse_method = getattr(parser, 'get_' + tt_lower)
+            meta = parse_method(self.keyspaces, **kwargs)
+            if meta:
+                update_method = getattr(self, '_update_' + tt_lower)
+                if tt_lower == 'keyspace' and connection.protocol_version < 3:
+                    # we didn't have 'type' target in legacy protocol versions, so we need to query those too
+                    user_types = parser.get_types_map(self.keyspaces, **kwargs)
+                    self._update_keyspace(meta, user_types)
+                else:
+                    update_method(meta)
+            else:
+                drop_method = getattr(self, '_drop_' + tt_lower)
+                drop_method(**kwargs)
+        except AttributeError:
+            raise ValueError("Unknown schema target_type: '%s'" % target_type)
+
+    def _rebuild_all(self, parser):
+        current_keyspaces = set()
+        for keyspace_meta in parser.get_all_keyspaces():
+            current_keyspaces.add(keyspace_meta.name)
+            old_keyspace_meta = self.keyspaces.get(keyspace_meta.name, None)
+            self.keyspaces[keyspace_meta.name] = keyspace_meta
+            if old_keyspace_meta:
+                self._keyspace_updated(keyspace_meta.name)
+            else:
+                self._keyspace_added(keyspace_meta.name)
+
+        # remove not-just-added keyspaces
+        removed_keyspaces = [name for name in self.keyspaces.keys()
+                             if name not in current_keyspaces]
+        self.keyspaces = dict((name, meta) for name, meta in self.keyspaces.items()
+                              if name in current_keyspaces)
+        for ksname in removed_keyspaces:
+            self._keyspace_removed(ksname)
+
+    def _update_keyspace(self, keyspace_meta, new_user_types=None):
+        ks_name = keyspace_meta.name
+        old_keyspace_meta = self.keyspaces.get(ks_name, None)
+        self.keyspaces[ks_name] = keyspace_meta
+        if old_keyspace_meta:
+            keyspace_meta.tables = old_keyspace_meta.tables
+            keyspace_meta.user_types = new_user_types if new_user_types is not None else old_keyspace_meta.user_types
+            keyspace_meta.indexes = old_keyspace_meta.indexes
+            keyspace_meta.functions = old_keyspace_meta.functions
+            keyspace_meta.aggregates = old_keyspace_meta.aggregates
+            keyspace_meta.views = old_keyspace_meta.views
+            if (keyspace_meta.replication_strategy != old_keyspace_meta.replication_strategy):
+                self._keyspace_updated(ks_name)
+        else:
+            self._keyspace_added(ks_name)
+
+    def _drop_keyspace(self, keyspace):
+        if self.keyspaces.pop(keyspace, None):
+            self._keyspace_removed(keyspace)
+
+    def _update_table(self, meta):
+        try:
+            keyspace_meta = self.keyspaces[meta.keyspace_name]
+            # this is unfortunate, but protocol v4 does not differentiate
+            # between events for tables and views. <parser>.get_table will
+            # return one or the other based on the query results.
+            # Here we deal with that.
+            if isinstance(meta, TableMetadata):
+                keyspace_meta._add_table_metadata(meta)
+            else:
+                keyspace_meta._add_view_metadata(meta)
+        except KeyError:
+            # can happen if keyspace disappears while processing async event
+            pass
+
+    def _drop_table(self, keyspace, table):
+        try:
+            keyspace_meta = self.keyspaces[keyspace]
+            keyspace_meta._drop_table_metadata(table)  # handles either table or view
+        except KeyError:
+            # can happen if keyspace disappears while processing async event
+            pass
+
+    def _update_type(self, type_meta):
+        try:
+            self.keyspaces[type_meta.keyspace].user_types[type_meta.name] = type_meta
+        except KeyError:
+            # can happen if keyspace disappears while processing async event
+            pass
+
+    def _drop_type(self, keyspace, type):
+        try:
+            self.keyspaces[keyspace].user_types.pop(type, None)
+        except KeyError:
+            # can happen if keyspace disappears while processing async event
+            pass
+
+    def _update_function(self, function_meta):
+        try:
+            self.keyspaces[function_meta.keyspace].functions[function_meta.signature] = function_meta
+        except KeyError:
+            # can happen if keyspace disappears while processing async event
+            pass
+
+    def _drop_function(self, keyspace, function):
+        try:
+            self.keyspaces[keyspace].functions.pop(function.signature, None)
+        except KeyError:
+            pass
+
+    def _update_aggregate(self, aggregate_meta):
+        try:
+            self.keyspaces[aggregate_meta.keyspace].aggregates[aggregate_meta.signature] = aggregate_meta
+        except KeyError:
+            pass
+
+    def _drop_aggregate(self, keyspace, aggregate):
+        try:
+            self.keyspaces[keyspace].aggregates.pop(aggregate.signature, None)
+        except KeyError:
+            pass
+
+    def _keyspace_added(self, ksname):
+        if self.token_map:
+            self.token_map.rebuild_keyspace(ksname, build_if_absent=False)
+
+    def _keyspace_updated(self, ksname):
+        if self.token_map:
+            self.token_map.rebuild_keyspace(ksname, build_if_absent=False)
+
+    def _keyspace_removed(self, ksname):
+        if self.token_map:
+            self.token_map.remove_keyspace(ksname)
+
+    def rebuild_token_map(self, partitioner, token_map):
+        """
+        Rebuild our view of the topology from fresh rows from the
+        system topology tables.
+        For internal use only.
+        """
+        self.partitioner = partitioner
+        if partitioner.endswith('RandomPartitioner'):
+            token_class = MD5Token
+        elif partitioner.endswith('Murmur3Partitioner'):
+            token_class = Murmur3Token
+        elif partitioner.endswith('ByteOrderedPartitioner'):
+            token_class = BytesToken
+        else:
+            self.token_map = None
+            return
+
+        token_to_host_owner = {}
+        ring = []
+        for host, token_strings in token_map.items():
+            for token_string in token_strings:
+                token = token_class.from_string(token_string)
+                ring.append(token)
+                token_to_host_owner[token] = host
+
+        all_tokens = sorted(ring)
+        self.token_map = TokenMap(
+            token_class, token_to_host_owner, all_tokens, self)
+
+    def get_replicas(self, keyspace, key):
+        """
+        Returns a list of :class:`.Host` instances that are replicas for a given
+        partition key.
+        """
+        t = self.token_map
+        if not t:
+            return []
+        try:
+            return t.get_replicas(keyspace, t.token_class.from_key(key))
+        except NoMurmur3:
+            return []
+
+    def can_support_partitioner(self):
+        if self.partitioner.endswith('Murmur3Partitioner') and murmur3 is None:
+            return False
+        else:
+            return True
+
+    def add_or_return_host(self, host):
+        """
+        Returns a tuple (host, new), where ``host`` is a Host
+        instance, and ``new`` is a bool indicating whether
+        the host was newly added.
+        """
+        with self._hosts_lock:
+            try:
+                return self._hosts[host.endpoint], False
+            except KeyError:
+                self._hosts[host.endpoint] = host
+                return host, True
+
+    def remove_host(self, host):
+        with self._hosts_lock:
+            return bool(self._hosts.pop(host.endpoint, False))
+
+    def get_host(self, endpoint_or_address, port=None):
+        """
+        Find a host in the metadata for a specific endpoint. If a string inet address and port are passed,
+        iterate all hosts to match the :attr:`~.pool.Host.broadcast_rpc_address` and
+        :attr:`~.pool.Host.broadcast_rpc_port`attributes.
+        """
+        if not isinstance(endpoint_or_address, EndPoint):
+            return self._get_host_by_address(endpoint_or_address, port)
+
+        return self._hosts.get(endpoint_or_address)
+
+    def _get_host_by_address(self, address, port=None):
+        for host in self._hosts.values():
+            if (host.broadcast_rpc_address == address and
+                    (port is None or host.broadcast_rpc_port is None or host.broadcast_rpc_port == port)):
+                return host
+
+        return None
+
+    def all_hosts(self):
+        """
+        Returns a list of all known :class:`.Host` instances in the cluster.
+        """
+        with self._hosts_lock:
+            return list(self._hosts.values())
+
+
+REPLICATION_STRATEGY_CLASS_PREFIX = "org.apache.cassandra.locator."
+
+
+def trim_if_startswith(s, prefix):
+    if s.startswith(prefix):
+        return s[len(prefix):]
+    return s
+
+
+_replication_strategies = {}
+
+
+class ReplicationStrategyTypeType(type):
+    def __new__(metacls, name, bases, dct):
+        dct.setdefault('name', name)
+        cls = type.__new__(metacls, name, bases, dct)
+        if not name.startswith('_'):
+            _replication_strategies[name] = cls
+        return cls
+
+
+
+class _ReplicationStrategy(object, metaclass=ReplicationStrategyTypeType):
+    options_map = None
+
+    @classmethod
+    def create(cls, strategy_class, options_map):
+        if not strategy_class:
+            return None
+
+        strategy_name = trim_if_startswith(strategy_class, REPLICATION_STRATEGY_CLASS_PREFIX)
+
+        rs_class = _replication_strategies.get(strategy_name, None)
+        if rs_class is None:
+            rs_class = _UnknownStrategyBuilder(strategy_name)
+            _replication_strategies[strategy_name] = rs_class
+
+        try:
+            rs_instance = rs_class(options_map)
+        except Exception as exc:
+            log.warning("Failed creating %s with options %s: %s", strategy_name, options_map, exc)
+            return None
+
+        return rs_instance
+
+    def make_token_replica_map(self, token_to_host_owner, ring):
+        raise NotImplementedError()
+
+    def export_for_schema(self):
+        raise NotImplementedError()
+
+
+ReplicationStrategy = _ReplicationStrategy
+
+
+class _UnknownStrategyBuilder(object):
+    def __init__(self, name):
+        self.name = name
+
+    def __call__(self, options_map):
+        strategy_instance = _UnknownStrategy(self.name, options_map)
+        return strategy_instance
+
+
+class _UnknownStrategy(ReplicationStrategy):
+    def __init__(self, name, options_map):
+        self.name = name
+        self.options_map = options_map.copy() if options_map is not None else dict()
+        self.options_map['class'] = self.name
+
+    def __eq__(self, other):
+        return (isinstance(other, _UnknownStrategy) and
+                self.name == other.name and
+                self.options_map == other.options_map)
+
+    def export_for_schema(self):
+        """
+        Returns a string version of these replication options which are
+        suitable for use in a CREATE KEYSPACE statement.
+        """
+        if self.options_map:
+            return dict((str(key), str(value)) for key, value in self.options_map.items())
+        return "{'class': '%s'}" % (self.name, )
+
+    def make_token_replica_map(self, token_to_host_owner, ring):
+        return {}
+
+
+class ReplicationFactor(object):
+    """
+    Represent the replication factor of a keyspace.
+    """
+
+    all_replicas = None
+    """
+    The number of total replicas.
+    """
+
+    full_replicas = None
+    """
+    The number of replicas that own a full copy of the data. This is the same
+    than `all_replicas` when transient replication is not enabled.
+    """
+
+    transient_replicas = None
+    """
+    The number of transient replicas.
+
+    Only set if the keyspace has transient replication enabled.
+    """
+
+    def __init__(self, all_replicas, transient_replicas=None):
+        self.all_replicas = all_replicas
+        self.transient_replicas = transient_replicas
+        self.full_replicas = (all_replicas - transient_replicas) if transient_replicas else all_replicas
+
+    @staticmethod
+    def create(rf):
+        """
+        Given the inputted replication factor string, parse and return the ReplicationFactor instance.
+        """
+        transient_replicas = None
+        try:
+            all_replicas = int(rf)
+        except ValueError:
+            try:
+                rf = rf.split('/')
+                all_replicas, transient_replicas = int(rf[0]), int(rf[1])
+            except Exception:
+                raise ValueError("Unable to determine replication factor from: {}".format(rf))
+
+        return ReplicationFactor(all_replicas, transient_replicas)
+
+    def __str__(self):
+        return ("%d/%d" % (self.all_replicas, self.transient_replicas) if self.transient_replicas
+                else "%d" % self.all_replicas)
+
+    def __eq__(self, other):
+        if not isinstance(other, ReplicationFactor):
+            return False
+
+        return self.all_replicas == other.all_replicas and self.full_replicas == other.full_replicas
+
+
+class SimpleStrategy(ReplicationStrategy):
+
+    replication_factor_info = None
+    """
+    A :class:`cassandra.metadata.ReplicationFactor` instance.
+    """
+
+    @property
+    def replication_factor(self):
+        """
+        The replication factor for this keyspace.
+
+        For backward compatibility, this returns the
+        :attr:`cassandra.metadata.ReplicationFactor.full_replicas` value of
+        :attr:`cassandra.metadata.SimpleStrategy.replication_factor_info`.
+        """
+        return self.replication_factor_info.full_replicas
+
+    def __init__(self, options_map):
+        self.replication_factor_info = ReplicationFactor.create(options_map['replication_factor'])
+
+    def make_token_replica_map(self, token_to_host_owner, ring):
+        replica_map = {}
+        for i in range(len(ring)):
+            j, hosts = 0, list()
+            while len(hosts) < self.replication_factor and j < len(ring):
+                token = ring[(i + j) % len(ring)]
+                host = token_to_host_owner[token]
+                if host not in hosts:
+                    hosts.append(host)
+                j += 1
+
+            replica_map[ring[i]] = hosts
+        return replica_map
+
+    def export_for_schema(self):
+        """
+        Returns a string version of these replication options which are
+        suitable for use in a CREATE KEYSPACE statement.
+        """
+        return "{'class': 'SimpleStrategy', 'replication_factor': '%s'}" \
+               % (str(self.replication_factor_info),)
+
+    def __eq__(self, other):
+        if not isinstance(other, SimpleStrategy):
+            return False
+
+        return str(self.replication_factor_info) == str(other.replication_factor_info)
+
+
+class NetworkTopologyStrategy(ReplicationStrategy):
+
+    dc_replication_factors_info = None
+    """
+    A map of datacenter names to the :class:`cassandra.metadata.ReplicationFactor` instance for that DC.
+    """
+
+    dc_replication_factors = None
+    """
+    A map of datacenter names to the replication factor for that DC.
+
+    For backward compatibility, this maps to the :attr:`cassandra.metadata.ReplicationFactor.full_replicas`
+    value of the :attr:`cassandra.metadata.NetworkTopologyStrategy.dc_replication_factors_info` dict.
+    """
+
+    def __init__(self, dc_replication_factors):
+        self.dc_replication_factors_info = dict(
+            (str(k), ReplicationFactor.create(v)) for k, v in dc_replication_factors.items())
+        self.dc_replication_factors = dict(
+            (dc, rf.full_replicas) for dc, rf in self.dc_replication_factors_info.items())
+
+    def make_token_replica_map(self, token_to_host_owner, ring):
+        dc_rf_map = dict(
+            (dc, full_replicas) for dc, full_replicas in self.dc_replication_factors.items()
+            if full_replicas > 0)
+
+        # build a map of DCs to lists of indexes into `ring` for tokens that
+        # belong to that DC
+        dc_to_token_offset = defaultdict(list)
+        dc_racks = defaultdict(set)
+        hosts_per_dc = defaultdict(set)
+        for i, token in enumerate(ring):
+            host = token_to_host_owner[token]
+            dc_to_token_offset[host.datacenter].append(i)
+            if host.datacenter and host.rack:
+                dc_racks[host.datacenter].add(host.rack)
+                hosts_per_dc[host.datacenter].add(host)
+
+        # A map of DCs to an index into the dc_to_token_offset value for that dc.
+        # This is how we keep track of advancing around the ring for each DC.
+        dc_to_current_index = defaultdict(int)
+
+        replica_map = defaultdict(list)
+        for i in range(len(ring)):
+            replicas = replica_map[ring[i]]
+
+            # go through each DC and find the replicas in that DC
+            for dc in dc_to_token_offset.keys():
+                if dc not in dc_rf_map:
+                    continue
+
+                # advance our per-DC index until we're up to at least the
+                # current token in the ring
+                token_offsets = dc_to_token_offset[dc]
+                index = dc_to_current_index[dc]
+                num_tokens = len(token_offsets)
+                while index < num_tokens and token_offsets[index] < i:
+                    index += 1
+                dc_to_current_index[dc] = index
+
+                replicas_remaining = dc_rf_map[dc]
+                replicas_this_dc = 0
+                skipped_hosts = []
+                racks_placed = set()
+                racks_this_dc = dc_racks[dc]
+                hosts_this_dc = len(hosts_per_dc[dc])
+
+                for token_offset_index in range(index, index+num_tokens):
+                    if token_offset_index >= len(token_offsets):
+                        token_offset_index = token_offset_index - len(token_offsets)
+
+                    token_offset = token_offsets[token_offset_index]
+                    host = token_to_host_owner[ring[token_offset]]
+                    if replicas_remaining == 0 or replicas_this_dc == hosts_this_dc:
+                        break
+
+                    if host in replicas:
+                        continue
+
+                    if host.rack in racks_placed and len(racks_placed) < len(racks_this_dc):
+                        skipped_hosts.append(host)
+                        continue
+
+                    replicas.append(host)
+                    replicas_this_dc += 1
+                    replicas_remaining -= 1
+                    racks_placed.add(host.rack)
+
+                    if len(racks_placed) == len(racks_this_dc):
+                        for host in skipped_hosts:
+                            if replicas_remaining == 0:
+                                break
+                            replicas.append(host)
+                            replicas_remaining -= 1
+                        del skipped_hosts[:]
+
+        return replica_map
+
+    def export_for_schema(self):
+        """
+        Returns a string version of these replication options which are
+        suitable for use in a CREATE KEYSPACE statement.
+        """
+        ret = "{'class': 'NetworkTopologyStrategy'"
+        for dc, rf in sorted(self.dc_replication_factors_info.items()):
+            ret += ", '%s': '%s'" % (dc, str(rf))
+        return ret + "}"
+
+    def __eq__(self, other):
+        if not isinstance(other, NetworkTopologyStrategy):
+            return False
+
+        return self.dc_replication_factors_info == other.dc_replication_factors_info
+
+
+class LocalStrategy(ReplicationStrategy):
+    def __init__(self, options_map):
+        pass
+
+    def make_token_replica_map(self, token_to_host_owner, ring):
+        return {}
+
+    def export_for_schema(self):
+        """
+        Returns a string version of these replication options which are
+        suitable for use in a CREATE KEYSPACE statement.
+        """
+        return "{'class': 'LocalStrategy'}"
+
+    def __eq__(self, other):
+        return isinstance(other, LocalStrategy)
+
+
+class KeyspaceMetadata(object):
+    """
+    A representation of the schema for a single keyspace.
+    """
+
+    name = None
+    """ The string name of the keyspace. """
+
+    durable_writes = True
+    """
+    A boolean indicating whether durable writes are enabled for this keyspace
+    or not.
+    """
+
+    replication_strategy = None
+    """
+    A :class:`.ReplicationStrategy` subclass object.
+    """
+
+    tables = None
+    """
+    A map from table names to instances of :class:`~.TableMetadata`.
+    """
+
+    indexes = None
+    """
+    A dict mapping index names to :class:`.IndexMetadata` instances.
+    """
+
+    user_types = None
+    """
+    A map from user-defined type names to instances of :class:`~cassandra.metadata.UserType`.
+
+    .. versionadded:: 2.1.0
+    """
+
+    functions = None
+    """
+    A map from user-defined function signatures to instances of :class:`~cassandra.metadata.Function`.
+
+    .. versionadded:: 2.6.0
+    """
+
+    aggregates = None
+    """
+    A map from user-defined aggregate signatures to instances of :class:`~cassandra.metadata.Aggregate`.
+
+    .. versionadded:: 2.6.0
+    """
+
+    views = None
+    """
+    A dict mapping view names to :class:`.MaterializedViewMetadata` instances.
+    """
+
+    virtual = False
+    """
+    A boolean indicating if this is a virtual keyspace or not. Always ``False``
+    for clusters running Cassandra pre-4.0 and DSE pre-6.7 versions.
+
+    .. versionadded:: 3.15
+    """
+
+    graph_engine = None
+    """
+    A string indicating whether a graph engine is enabled for this keyspace (Core/Classic).
+    """
+
+    _exc_info = None
+    """ set if metadata parsing failed """
+
+    def __init__(self, name, durable_writes, strategy_class, strategy_options, graph_engine=None):
+        self.name = name
+        self.durable_writes = durable_writes
+        self.replication_strategy = ReplicationStrategy.create(strategy_class, strategy_options)
+        self.tables = {}
+        self.indexes = {}
+        self.user_types = {}
+        self.functions = {}
+        self.aggregates = {}
+        self.views = {}
+        self.graph_engine = graph_engine
+
+    @property
+    def is_graph_enabled(self):
+        return self.graph_engine is not None
+
+    def export_as_string(self):
+        """
+        Returns a CQL query string that can be used to recreate the entire keyspace,
+        including user-defined types and tables.
+        """
+        # Make sure tables with vertex are exported before tables with edges
+        tables_with_vertex = [t for t in self.tables.values() if hasattr(t, 'vertex') and t.vertex]
+        other_tables = [t for t in self.tables.values() if t not in tables_with_vertex]
+
+        cql = "\n\n".join(
+            [self.as_cql_query() + ';'] +
+            self.user_type_strings() +
+            [f.export_as_string() for f in self.functions.values()] +
+            [a.export_as_string() for a in self.aggregates.values()] +
+            [t.export_as_string() for t in tables_with_vertex + other_tables])
+
+        if self._exc_info:
+            import traceback
+            ret = "/*\nWarning: Keyspace %s is incomplete because of an error processing metadata.\n" % \
+                  (self.name)
+            for line in traceback.format_exception(*self._exc_info):
+                ret += line
+            ret += "\nApproximate structure, for reference:\n(this should not be used to reproduce this schema)\n\n%s\n*/" % cql
+            return ret
+        if self.virtual:
+            return ("/*\nWarning: Keyspace {ks} is a virtual keyspace and cannot be recreated with CQL.\n"
+                    "Structure, for reference:*/\n"
+                    "{cql}\n"
+                    "").format(ks=self.name, cql=cql)
+        return cql
+
+    def as_cql_query(self):
+        """
+        Returns a CQL query string that can be used to recreate just this keyspace,
+        not including user-defined types and tables.
+        """
+        if self.virtual:
+            return "// VIRTUAL KEYSPACE {}".format(protect_name(self.name))
+        ret = "CREATE KEYSPACE %s WITH replication = %s " % (
+            protect_name(self.name),
+            self.replication_strategy.export_for_schema())
+        ret = ret + (' AND durable_writes = %s' % ("true" if self.durable_writes else "false"))
+        if self.graph_engine is not None:
+            ret = ret + (" AND graph_engine = '%s'" % self.graph_engine)
+        return ret
+
+    def user_type_strings(self):
+        user_type_strings = []
+        user_types = self.user_types.copy()
+        keys = sorted(user_types.keys())
+        for k in keys:
+            if k in user_types:
+                self.resolve_user_types(k, user_types, user_type_strings)
+        return user_type_strings
+
+    def resolve_user_types(self, key, user_types, user_type_strings):
+        user_type = user_types.pop(key)
+        for type_name in user_type.field_types:
+            for sub_type in types.cql_types_from_string(type_name):
+                if sub_type in user_types:
+                    self.resolve_user_types(sub_type, user_types, user_type_strings)
+        user_type_strings.append(user_type.export_as_string())
+
+    def _add_table_metadata(self, table_metadata):
+        old_indexes = {}
+        old_meta = self.tables.get(table_metadata.name, None)
+        if old_meta:
+            # views are not queried with table, so they must be transferred to new
+            table_metadata.views = old_meta.views
+            # indexes will be updated with what is on the new metadata
+            old_indexes = old_meta.indexes
+
+        # note the intentional order of add before remove
+        # this makes sure the maps are never absent something that existed before this update
+        for index_name, index_metadata in table_metadata.indexes.items():
+            self.indexes[index_name] = index_metadata
+
+        for index_name in (n for n in old_indexes if n not in table_metadata.indexes):
+            self.indexes.pop(index_name, None)
+
+        self.tables[table_metadata.name] = table_metadata
+
+    def _drop_table_metadata(self, table_name):
+        table_meta = self.tables.pop(table_name, None)
+        if table_meta:
+            for index_name in table_meta.indexes:
+                self.indexes.pop(index_name, None)
+            for view_name in table_meta.views:
+                self.views.pop(view_name, None)
+            return
+        # we can't tell table drops from views, so drop both
+        # (name is unique among them, within a keyspace)
+        view_meta = self.views.pop(table_name, None)
+        if view_meta:
+            try:
+                self.tables[view_meta.base_table_name].views.pop(table_name, None)
+            except KeyError:
+                pass
+
+    def _add_view_metadata(self, view_metadata):
+        try:
+            self.tables[view_metadata.base_table_name].views[view_metadata.name] = view_metadata
+            self.views[view_metadata.name] = view_metadata
+        except KeyError:
+            pass
+
+
+class UserType(object):
+    """
+    A user defined type, as created by ``CREATE TYPE`` statements.
+
+    User-defined types were introduced in Cassandra 2.1.
+
+    .. versionadded:: 2.1.0
+    """
+
+    keyspace = None
+    """
+    The string name of the keyspace in which this type is defined.
+    """
+
+    name = None
+    """
+    The name of this type.
+    """
+
+    field_names = None
+    """
+    An ordered list of the names for each field in this user-defined type.
+    """
+
+    field_types = None
+    """
+    An ordered list of the types for each field in this user-defined type.
+    """
+
+    def __init__(self, keyspace, name, field_names, field_types):
+        self.keyspace = keyspace
+        self.name = name
+        # non-frozen collections can return None
+        self.field_names = field_names or []
+        self.field_types = field_types or []
+
+    def as_cql_query(self, formatted=False):
+        """
+        Returns a CQL query that can be used to recreate this type.
+        If `formatted` is set to :const:`True`, extra whitespace will
+        be added to make the query more readable.
+        """
+        ret = "CREATE TYPE %s.%s (%s" % (
+            protect_name(self.keyspace),
+            protect_name(self.name),
+            "\n" if formatted else "")
+
+        if formatted:
+            field_join = ",\n"
+            padding = "    "
+        else:
+            field_join = ", "
+            padding = ""
+
+        fields = []
+        for field_name, field_type in zip(self.field_names, self.field_types):
+            fields.append("%s %s" % (protect_name(field_name), field_type))
+
+        ret += field_join.join("%s%s" % (padding, field) for field in fields)
+        ret += "\n)" if formatted else ")"
+        return ret
+
+    def export_as_string(self):
+        return self.as_cql_query(formatted=True) + ';'
+
+
+class Aggregate(object):
+    """
+    A user defined aggregate function, as created by ``CREATE AGGREGATE`` statements.
+
+    Aggregate functions were introduced in Cassandra 2.2
+
+    .. versionadded:: 2.6.0
+    """
+
+    keyspace = None
+    """
+    The string name of the keyspace in which this aggregate is defined
+    """
+
+    name = None
+    """
+    The name of this aggregate
+    """
+
+    argument_types = None
+    """
+    An ordered list of the types for each argument to the aggregate
+    """
+
+    final_func = None
+    """
+    Name of a final function
+    """
+
+    initial_condition = None
+    """
+    Initial condition of the aggregate
+    """
+
+    return_type = None
+    """
+    Return type of the aggregate
+    """
+
+    state_func = None
+    """
+    Name of a state function
+    """
+
+    state_type = None
+    """
+    Type of the aggregate state
+    """
+
+    deterministic = None
+    """
+    Flag indicating if this function is guaranteed to produce the same result
+    for a particular input and state. This is available only with DSE >=6.0.
+    """
+
+    def __init__(self, keyspace, name, argument_types, state_func,
+                 state_type, final_func, initial_condition, return_type,
+                 deterministic):
+        self.keyspace = keyspace
+        self.name = name
+        self.argument_types = argument_types
+        self.state_func = state_func
+        self.state_type = state_type
+        self.final_func = final_func
+        self.initial_condition = initial_condition
+        self.return_type = return_type
+        self.deterministic = deterministic
+
+    def as_cql_query(self, formatted=False):
+        """
+        Returns a CQL query that can be used to recreate this aggregate.
+        If `formatted` is set to :const:`True`, extra whitespace will
+        be added to make the query more readable.
+        """
+        sep = '\n    ' if formatted else ' '
+        keyspace = protect_name(self.keyspace)
+        name = protect_name(self.name)
+        type_list = ', '.join([types.strip_frozen(arg_type) for arg_type in self.argument_types])
+        state_func = protect_name(self.state_func)
+        state_type = types.strip_frozen(self.state_type)
+
+        ret = "CREATE AGGREGATE %(keyspace)s.%(name)s(%(type_list)s)%(sep)s" \
+              "SFUNC %(state_func)s%(sep)s" \
+              "STYPE %(state_type)s" % locals()
+
+        ret += ''.join((sep, 'FINALFUNC ', protect_name(self.final_func))) if self.final_func else ''
+        ret += ''.join((sep, 'INITCOND ', self.initial_condition)) if self.initial_condition is not None else ''
+        ret += '{}DETERMINISTIC'.format(sep) if self.deterministic else ''
+
+        return ret
+
+    def export_as_string(self):
+        return self.as_cql_query(formatted=True) + ';'
+
+    @property
+    def signature(self):
+        return SignatureDescriptor.format_signature(self.name, self.argument_types)
+
+
+class Function(object):
+    """
+    A user defined function, as created by ``CREATE FUNCTION`` statements.
+
+    User-defined functions were introduced in Cassandra 2.2
+
+    .. versionadded:: 2.6.0
+    """
+
+    keyspace = None
+    """
+    The string name of the keyspace in which this function is defined
+    """
+
+    name = None
+    """
+    The name of this function
+    """
+
+    argument_types = None
+    """
+    An ordered list of the types for each argument to the function
+    """
+
+    argument_names = None
+    """
+    An ordered list of the names of each argument to the function
+    """
+
+    return_type = None
+    """
+    Return type of the function
+    """
+
+    language = None
+    """
+    Language of the function body
+    """
+
+    body = None
+    """
+    Function body string
+    """
+
+    called_on_null_input = None
+    """
+    Flag indicating whether this function should be called for rows with null values
+    (convenience function to avoid handling nulls explicitly if the result will just be null)
+    """
+
+    deterministic = None
+    """
+    Flag indicating if this function is guaranteed to produce the same result
+    for a particular input. This is available only for DSE >=6.0.
+    """
+
+    monotonic = None
+    """
+    Flag indicating if this function is guaranteed to increase or decrease
+    monotonically on any of its arguments. This is available only for DSE >=6.0.
+    """
+
+    monotonic_on = None
+    """
+    A list containing the argument or arguments over which this function is
+    monotonic. This is available only for DSE >=6.0.
+    """
+
+    def __init__(self, keyspace, name, argument_types, argument_names,
+                 return_type, language, body, called_on_null_input,
+                 deterministic, monotonic, monotonic_on):
+        self.keyspace = keyspace
+        self.name = name
+        self.argument_types = argument_types
+        # argument_types (frozen<list<>>) will always be a list
+        # argument_name is not frozen in C* < 3.0 and may return None
+        self.argument_names = argument_names or []
+        self.return_type = return_type
+        self.language = language
+        self.body = body
+        self.called_on_null_input = called_on_null_input
+        self.deterministic = deterministic
+        self.monotonic = monotonic
+        self.monotonic_on = monotonic_on
+
+    def as_cql_query(self, formatted=False):
+        """
+        Returns a CQL query that can be used to recreate this function.
+        If `formatted` is set to :const:`True`, extra whitespace will
+        be added to make the query more readable.
+        """
+        sep = '\n    ' if formatted else ' '
+        keyspace = protect_name(self.keyspace)
+        name = protect_name(self.name)
+        arg_list = ', '.join(["%s %s" % (protect_name(n), types.strip_frozen(t))
+                             for n, t in zip(self.argument_names, self.argument_types)])
+        typ = self.return_type
+        lang = self.language
+        body = self.body
+        on_null = "CALLED" if self.called_on_null_input else "RETURNS NULL"
+        deterministic_token = ('DETERMINISTIC{}'.format(sep)
+                               if self.deterministic else
+                               '')
+        monotonic_tokens = ''  # default for nonmonotonic function
+        if self.monotonic:
+            # monotonic on all arguments; ignore self.monotonic_on
+            monotonic_tokens = 'MONOTONIC{}'.format(sep)
+        elif self.monotonic_on:
+            # if monotonic == False and monotonic_on is nonempty, we know that
+            # monotonicity was specified with MONOTONIC ON <arg>, so there's
+            # exactly 1 value there
+            monotonic_tokens = 'MONOTONIC ON {}{}'.format(self.monotonic_on[0],
+                                                          sep)
+
+        return "CREATE FUNCTION %(keyspace)s.%(name)s(%(arg_list)s)%(sep)s" \
+               "%(on_null)s ON NULL INPUT%(sep)s" \
+               "RETURNS %(typ)s%(sep)s" \
+               "%(deterministic_token)s" \
+               "%(monotonic_tokens)s" \
+               "LANGUAGE %(lang)s%(sep)s" \
+               "AS $$%(body)s$$" % locals()
+
+    def export_as_string(self):
+        return self.as_cql_query(formatted=True) + ';'
+
+    @property
+    def signature(self):
+        return SignatureDescriptor.format_signature(self.name, self.argument_types)
+
+
+class TableMetadata(object):
+    """
+    A representation of the schema for a single table.
+    """
+
+    keyspace_name = None
+    """ String name of this Table's keyspace """
+
+    name = None
+    """ The string name of the table. """
+
+    partition_key = None
+    """
+    A list of :class:`.ColumnMetadata` instances representing the columns in
+    the partition key for this table.  This will always hold at least one
+    column.
+    """
+
+    clustering_key = None
+    """
+    A list of :class:`.ColumnMetadata` instances representing the columns
+    in the clustering key for this table.  These are all of the
+    :attr:`.primary_key` columns that are not in the :attr:`.partition_key`.
+
+    Note that a table may have no clustering keys, in which case this will
+    be an empty list.
+    """
+
+    @property
+    def primary_key(self):
+        """
+        A list of :class:`.ColumnMetadata` representing the components of
+        the primary key for this table.
+        """
+        return self.partition_key + self.clustering_key
+
+    columns = None
+    """
+    A dict mapping column names to :class:`.ColumnMetadata` instances.
+    """
+
+    indexes = None
+    """
+    A dict mapping index names to :class:`.IndexMetadata` instances.
+    """
+
+    is_compact_storage = False
+
+    options = None
+    """
+    A dict mapping table option names to their specific settings for this
+    table.
+    """
+
+    compaction_options = {
+        "min_compaction_threshold": "min_threshold",
+        "max_compaction_threshold": "max_threshold",
+        "compaction_strategy_class": "class"}
+
+    triggers = None
+    """
+    A dict mapping trigger names to :class:`.TriggerMetadata` instances.
+    """
+
+    views = None
+    """
+    A dict mapping view names to :class:`.MaterializedViewMetadata` instances.
+    """
+
+    _exc_info = None
+    """ set if metadata parsing failed """
+
+    virtual = False
+    """
+    A boolean indicating if this is a virtual table or not. Always ``False``
+    for clusters running Cassandra pre-4.0 and DSE pre-6.7 versions.
+
+    .. versionadded:: 3.15
+    """
+
+    @property
+    def is_cql_compatible(self):
+        """
+        A boolean indicating if this table can be represented as CQL in export
+        """
+        if self.virtual:
+            return False
+        comparator = getattr(self, 'comparator', None)
+        if comparator:
+            # no compact storage with more than one column beyond PK if there
+            # are clustering columns
+            incompatible = (self.is_compact_storage and
+                            len(self.columns) > len(self.primary_key) + 1 and
+                            len(self.clustering_key) >= 1)
+
+            return not incompatible
+        return True
+
+    extensions = None
+    """
+    Metadata describing configuration for table extensions
+    """
+
+    def __init__(self, keyspace_name, name, partition_key=None, clustering_key=None, columns=None, triggers=None, options=None, virtual=False):
+        self.keyspace_name = keyspace_name
+        self.name = name
+        self.partition_key = [] if partition_key is None else partition_key
+        self.clustering_key = [] if clustering_key is None else clustering_key
+        self.columns = OrderedDict() if columns is None else columns
+        self.indexes = {}
+        self.options = {} if options is None else options
+        self.comparator = None
+        self.triggers = OrderedDict() if triggers is None else triggers
+        self.views = {}
+        self.virtual = virtual
+
+    def export_as_string(self):
+        """
+        Returns a string of CQL queries that can be used to recreate this table
+        along with all indexes on it.  The returned string is formatted to
+        be human readable.
+        """
+        if self._exc_info:
+            import traceback
+            ret = "/*\nWarning: Table %s.%s is incomplete because of an error processing metadata.\n" % \
+                  (self.keyspace_name, self.name)
+            for line in traceback.format_exception(*self._exc_info):
+                ret += line
+            ret += "\nApproximate structure, for reference:\n(this should not be used to reproduce this schema)\n\n%s\n*/" % self._all_as_cql()
+        elif not self.is_cql_compatible:
+            # If we can't produce this table with CQL, comment inline
+            ret = "/*\nWarning: Table %s.%s omitted because it has constructs not compatible with CQL (was created via legacy API).\n" % \
+                  (self.keyspace_name, self.name)
+            ret += "\nApproximate structure, for reference:\n(this should not be used to reproduce this schema)\n\n%s\n*/" % self._all_as_cql()
+        elif self.virtual:
+            ret = ('/*\nWarning: Table {ks}.{tab} is a virtual table and cannot be recreated with CQL.\n'
+                   'Structure, for reference:\n'
+                   '{cql}\n*/').format(ks=self.keyspace_name, tab=self.name, cql=self._all_as_cql())
+
+        else:
+            ret = self._all_as_cql()
+
+        return ret
+
+    def _all_as_cql(self):
+        ret = self.as_cql_query(formatted=True)
+        ret += ";"
+
+        for index in self.indexes.values():
+            ret += "\n%s;" % index.as_cql_query()
+
+        for trigger_meta in self.triggers.values():
+            ret += "\n%s;" % (trigger_meta.as_cql_query(),)
+
+        for view_meta in self.views.values():
+            ret += "\n\n%s;" % (view_meta.as_cql_query(formatted=True),)
+
+        if self.extensions:
+            registry = _RegisteredExtensionType._extension_registry
+            for k in registry.keys() & self.extensions:  # no viewkeys on OrderedMapSerializeKey
+                ext = registry[k]
+                cql = ext.after_table_cql(self, k, self.extensions[k])
+                if cql:
+                    ret += "\n\n%s" % (cql,)
+
+        return ret
+
+    def as_cql_query(self, formatted=False):
+        """
+        Returns a CQL query that can be used to recreate this table (index
+        creations are not included).  If `formatted` is set to :const:`True`,
+        extra whitespace will be added to make the query human readable.
+        """
+        ret = "%s TABLE %s.%s (%s" % (
+            ('VIRTUAL' if self.virtual else 'CREATE'),
+            protect_name(self.keyspace_name),
+            protect_name(self.name),
+            "\n" if formatted else "")
+
+        if formatted:
+            column_join = ",\n"
+            padding = "    "
+        else:
+            column_join = ", "
+            padding = ""
+
+        columns = []
+        for col in self.columns.values():
+            columns.append("%s %s%s" % (protect_name(col.name), col.cql_type, ' static' if col.is_static else ''))
+
+        if len(self.partition_key) == 1 and not self.clustering_key:
+            columns[0] += " PRIMARY KEY"
+
+        ret += column_join.join("%s%s" % (padding, col) for col in columns)
+
+        # primary key
+        if len(self.partition_key) > 1 or self.clustering_key:
+            ret += "%s%sPRIMARY KEY (" % (column_join, padding)
+
+            if len(self.partition_key) > 1:
+                ret += "(%s)" % ", ".join(protect_name(col.name) for col in self.partition_key)
+            else:
+                ret += protect_name(self.partition_key[0].name)
+
+            if self.clustering_key:
+                ret += ", %s" % ", ".join(protect_name(col.name) for col in self.clustering_key)
+
+            ret += ")"
+
+        # properties
+        ret += "%s) WITH " % ("\n" if formatted else "")
+        ret += self._property_string(formatted, self.clustering_key, self.options, self.is_compact_storage)
+
+        return ret
+
+    @classmethod
+    def _property_string(cls, formatted, clustering_key, options_map, is_compact_storage=False):
+        properties = []
+        if is_compact_storage:
+            properties.append("COMPACT STORAGE")
+
+        if clustering_key:
+            cluster_str = "CLUSTERING ORDER BY "
+
+            inner = []
+            for col in clustering_key:
+                ordering = "DESC" if col.is_reversed else "ASC"
+                inner.append("%s %s" % (protect_name(col.name), ordering))
+
+            cluster_str += "(%s)" % ", ".join(inner)
+            properties.append(cluster_str)
+
+        properties.extend(cls._make_option_strings(options_map))
+
+        join_str = "\n    AND " if formatted else " AND "
+        return join_str.join(properties)
+
+    @classmethod
+    def _make_option_strings(cls, options_map):
+        ret = []
+        options_copy = dict(options_map.items())
+
+        actual_options = json.loads(options_copy.pop('compaction_strategy_options', '{}'))
+        value = options_copy.pop("compaction_strategy_class", None)
+        actual_options.setdefault("class", value)
+
+        compaction_option_strings = ["'%s': '%s'" % (k, v) for k, v in actual_options.items()]
+        ret.append('compaction = {%s}' % ', '.join(compaction_option_strings))
+
+        for system_table_name in cls.compaction_options.keys():
+            options_copy.pop(system_table_name, None)  # delete if present
+        options_copy.pop('compaction_strategy_option', None)
+
+        if not options_copy.get('compression'):
+            params = json.loads(options_copy.pop('compression_parameters', '{}'))
+            param_strings = ["'%s': '%s'" % (k, v) for k, v in params.items()]
+            ret.append('compression = {%s}' % ', '.join(param_strings))
+
+        for name, value in options_copy.items():
+            if value is not None:
+                if name == "comment":
+                    value = value or ""
+                ret.append("%s = %s" % (name, protect_value(value)))
+
+        return list(sorted(ret))
+
+
+class TableMetadataV3(TableMetadata):
+    """
+    For C* 3.0+. `option_maps` take a superset of map names, so if  nothing
+    changes structurally, new option maps can just be appended to the list.
+    """
+    compaction_options = {}
+
+    option_maps = [
+        'compaction', 'compression', 'caching',
+        'nodesync'  # added DSE 6.0
+    ]
+
+    @property
+    def is_cql_compatible(self):
+        return True
+
+    @classmethod
+    def _make_option_strings(cls, options_map):
+        ret = []
+        options_copy = dict(options_map.items())
+
+        for option in cls.option_maps:
+            value = options_copy.get(option)
+            if isinstance(value, Mapping):
+                del options_copy[option]
+                params = ("'%s': '%s'" % (k, v) for k, v in value.items())
+                ret.append("%s = {%s}" % (option, ', '.join(params)))
+
+        for name, value in options_copy.items():
+            if value is not None:
+                if name == "comment":
+                    value = value or ""
+                ret.append("%s = %s" % (name, protect_value(value)))
+
+        return list(sorted(ret))
+
+
+class TableMetadataDSE68(TableMetadataV3):
+
+    vertex = None
+    """A :class:`.VertexMetadata` instance, if graph enabled"""
+
+    edge = None
+    """A :class:`.EdgeMetadata` instance, if graph enabled"""
+
+    def as_cql_query(self, formatted=False):
+        ret = super(TableMetadataDSE68, self).as_cql_query(formatted)
+
+        if self.vertex:
+            ret += " AND VERTEX LABEL %s" % protect_name(self.vertex.label_name)
+
+        if self.edge:
+            ret += " AND EDGE LABEL %s" % protect_name(self.edge.label_name)
+
+            ret += self._export_edge_as_cql(
+                self.edge.from_label,
+                self.edge.from_partition_key_columns,
+                self.edge.from_clustering_columns, "FROM")
+
+            ret += self._export_edge_as_cql(
+                self.edge.to_label,
+                self.edge.to_partition_key_columns,
+                self.edge.to_clustering_columns, "TO")
+
+        return ret
+
+    @staticmethod
+    def _export_edge_as_cql(label_name, partition_keys,
+                            clustering_columns, keyword):
+        ret = " %s %s(" % (keyword, protect_name(label_name))
+
+        if len(partition_keys) == 1:
+            ret += protect_name(partition_keys[0])
+        else:
+            ret += "(%s)" % ", ".join([protect_name(k) for k in partition_keys])
+
+        if clustering_columns:
+            ret += ", %s" % ", ".join([protect_name(k) for k in clustering_columns])
+        ret += ")"
+
+        return ret
+
+
+class TableExtensionInterface(object):
+    """
+    Defines CQL/DDL for Cassandra table extensions.
+    """
+    # limited API for now. Could be expanded as new extension types materialize -- "extend_option_strings", for example
+    @classmethod
+    def after_table_cql(cls, ext_key, ext_blob):
+        """
+        Called to produce CQL/DDL to follow the table definition.
+        Should contain requisite terminating semicolon(s).
+        """
+        pass
+
+
+class _RegisteredExtensionType(type):
+
+    _extension_registry = {}
+
+    def __new__(mcs, name, bases, dct):
+        cls = super(_RegisteredExtensionType, mcs).__new__(mcs, name, bases, dct)
+        if name != 'RegisteredTableExtension':
+            mcs._extension_registry[cls.name] = cls
+        return cls
+
+
+class RegisteredTableExtension(TableExtensionInterface, metaclass=_RegisteredExtensionType):
+    """
+    Extending this class registers it by name (associated by key in the `system_schema.tables.extensions` map).
+    """
+    name = None
+    """
+    Name of the extension (key in the map)
+    """
+
+
+def protect_name(name):
+    return maybe_escape_name(name)
+
+
+def protect_names(names):
+    return [protect_name(n) for n in names]
+
+
+def protect_value(value):
+    if value is None:
+        return 'NULL'
+    if isinstance(value, (int, float, bool)):
+        return str(value).lower()
+    return "'%s'" % value.replace("'", "''")
+
+
+valid_cql3_word_re = re.compile(r'^[a-z][0-9a-z_]*$')
+
+
+def is_valid_name(name):
+    if name is None:
+        return False
+    if name.lower() in cql_keywords_reserved:
+        return False
+    return valid_cql3_word_re.match(name) is not None
+
+
+def maybe_escape_name(name):
+    if is_valid_name(name):
+        return name
+    return escape_name(name)
+
+
+def escape_name(name):
+    return '"%s"' % (name.replace('"', '""'),)
+
+
+class ColumnMetadata(object):
+    """
+    A representation of a single column in a table.
+    """
+
+    table = None
+    """ The :class:`.TableMetadata` this column belongs to. """
+
+    name = None
+    """ The string name of this column. """
+
+    cql_type = None
+    """
+    The CQL type for the column.
+    """
+
+    is_static = False
+    """
+    If this column is static (available in Cassandra 2.1+), this will
+    be :const:`True`, otherwise :const:`False`.
+    """
+
+    is_reversed = False
+    """
+    If this column is reversed (DESC) as in clustering order
+    """
+
+    _cass_type = None
+
+    def __init__(self, table_metadata, column_name, cql_type, is_static=False, is_reversed=False):
+        self.table = table_metadata
+        self.name = column_name
+        self.cql_type = cql_type
+        self.is_static = is_static
+        self.is_reversed = is_reversed
+
+    def __str__(self):
+        return "%s %s" % (self.name, self.cql_type)
+
+
+class IndexMetadata(object):
+    """
+    A representation of a secondary index on a column.
+    """
+    keyspace_name = None
+    """ A string name of the keyspace. """
+
+    table_name = None
+    """ A string name of the table this index is on. """
+
+    name = None
+    """ A string name for the index. """
+
+    kind = None
+    """ A string representing the kind of index (COMPOSITE, CUSTOM,...). """
+
+    index_options = {}
+    """ A dict of index options. """
+
+    def __init__(self, keyspace_name, table_name, index_name, kind, index_options):
+        self.keyspace_name = keyspace_name
+        self.table_name = table_name
+        self.name = index_name
+        self.kind = kind
+        self.index_options = index_options
+
+    def as_cql_query(self):
+        """
+        Returns a CQL query that can be used to recreate this index.
+        """
+        options = dict(self.index_options)
+        index_target = options.pop("target")
+        if self.kind != "CUSTOM":
+            return "CREATE INDEX %s ON %s.%s (%s)" % (
+                protect_name(self.name),
+                protect_name(self.keyspace_name),
+                protect_name(self.table_name),
+                index_target)
+        else:
+            class_name = options.pop("class_name")
+            ret = "CREATE CUSTOM INDEX %s ON %s.%s (%s) USING '%s'" % (
+                protect_name(self.name),
+                protect_name(self.keyspace_name),
+                protect_name(self.table_name),
+                index_target,
+                class_name)
+            if options:
+                # PYTHON-1008: `ret` will always be a unicode
+                opts_cql_encoded = _encoder.cql_encode_all_types(options, as_text_type=True)
+                ret += " WITH OPTIONS = %s" % opts_cql_encoded
+            return ret
+
+    def export_as_string(self):
+        """
+        Returns a CQL query string that can be used to recreate this index.
+        """
+        return self.as_cql_query() + ';'
+
+
+class TokenMap(object):
+    """
+    Information about the layout of the ring.
+    """
+
+    token_class = None
+    """
+    A subclass of :class:`.Token`, depending on what partitioner the cluster uses.
+    """
+
+    token_to_host_owner = None
+    """
+    A map of :class:`.Token` objects to the :class:`.Host` that owns that token.
+    """
+
+    tokens_to_hosts_by_ks = None
+    """
+    A map of keyspace names to a nested map of :class:`.Token` objects to
+    sets of :class:`.Host` objects.
+    """
+
+    ring = None
+    """
+    An ordered list of :class:`.Token` instances in the ring.
+    """
+
+    _metadata = None
+
+    def __init__(self, token_class, token_to_host_owner, all_tokens, metadata):
+        self.token_class = token_class
+        self.ring = all_tokens
+        self.token_to_host_owner = token_to_host_owner
+
+        self.tokens_to_hosts_by_ks = {}
+        self._metadata = metadata
+        self._rebuild_lock = RLock()
+
+    def rebuild_keyspace(self, keyspace, build_if_absent=False):
+        with self._rebuild_lock:
+            try:
+                current = self.tokens_to_hosts_by_ks.get(keyspace, None)
+                if (build_if_absent and current is None) or (not build_if_absent and current is not None):
+                    ks_meta = self._metadata.keyspaces.get(keyspace)
+                    if ks_meta:
+                        replica_map = self.replica_map_for_keyspace(self._metadata.keyspaces[keyspace])
+                        self.tokens_to_hosts_by_ks[keyspace] = replica_map
+            except Exception:
+                # should not happen normally, but we don't want to blow up queries because of unexpected meta state
+                # bypass until new map is generated
+                self.tokens_to_hosts_by_ks[keyspace] = {}
+                log.exception("Failed creating a token map for keyspace '%s' with %s. PLEASE REPORT THIS: https://datastax-oss.atlassian.net/projects/PYTHON", keyspace, self.token_to_host_owner)
+
+    def replica_map_for_keyspace(self, ks_metadata):
+        strategy = ks_metadata.replication_strategy
+        if strategy:
+            return strategy.make_token_replica_map(self.token_to_host_owner, self.ring)
+        else:
+            return None
+
+    def remove_keyspace(self, keyspace):
+        self.tokens_to_hosts_by_ks.pop(keyspace, None)
+
+    def get_replicas(self, keyspace, token):
+        """
+        Get  a set of :class:`.Host` instances representing all of the
+        replica nodes for a given :class:`.Token`.
+        """
+        tokens_to_hosts = self.tokens_to_hosts_by_ks.get(keyspace, None)
+        if tokens_to_hosts is None:
+            self.rebuild_keyspace(keyspace, build_if_absent=True)
+            tokens_to_hosts = self.tokens_to_hosts_by_ks.get(keyspace, None)
+
+        if tokens_to_hosts:
+            # The values in self.ring correspond to the end of the
+            # token range up to and including the value listed.
+            point = bisect_left(self.ring, token)
+            if point == len(self.ring):
+                return tokens_to_hosts[self.ring[0]]
+            else:
+                return tokens_to_hosts[self.ring[point]]
+        return []
+
+
+@total_ordering
+class Token(object):
+    """
+    Abstract class representing a token.
+    """
+
+    def __init__(self, token):
+        self.value = token
+
+    @classmethod
+    def hash_fn(cls, key):
+        return key
+
+    @classmethod
+    def from_key(cls, key):
+        return cls(cls.hash_fn(key))
+
+    @classmethod
+    def from_string(cls, token_string):
+        raise NotImplementedError()
+
+    def __eq__(self, other):
+        return self.value == other.value
+
+    def __lt__(self, other):
+        return self.value < other.value
+
+    def __hash__(self):
+        return hash(self.value)
+
+    def __repr__(self):
+        return "<%s: %s>" % (self.__class__.__name__, self.value)
+    __str__ = __repr__
+
+
+MIN_LONG = -(2 ** 63)
+MAX_LONG = (2 ** 63) - 1
+
+
+class NoMurmur3(Exception):
+    pass
+
+
+class HashToken(Token):
+
+    @classmethod
+    def from_string(cls, token_string):
+        """ `token_string` should be the string representation from the server. """
+        # The hash partitioners just store the deciman value
+        return cls(int(token_string))
+
+
+class Murmur3Token(HashToken):
+    """
+    A token for ``Murmur3Partitioner``.
+    """
+
+    @classmethod
+    def hash_fn(cls, key):
+        if murmur3 is not None:
+            h = int(murmur3(key))
+            return h if h != MIN_LONG else MAX_LONG
+        else:
+            raise NoMurmur3()
+
+    def __init__(self, token):
+        """ `token` is an int or string representing the token. """
+        self.value = int(token)
+
+
+class MD5Token(HashToken):
+    """
+    A token for ``RandomPartitioner``.
+    """
+
+    @classmethod
+    def hash_fn(cls, key):
+        if isinstance(key, str):
+            key = key.encode('UTF-8')
+        return abs(varint_unpack(md5(key).digest()))
+
+
+class BytesToken(Token):
+    """
+    A token for ``ByteOrderedPartitioner``.
+    """
+
+    @classmethod
+    def from_string(cls, token_string):
+        """ `token_string` should be the string representation from the server. """
+        # unhexlify works fine with unicode input in everythin but pypy3, where it Raises "TypeError: 'str' does not support the buffer interface"
+        if isinstance(token_string, str):
+            token_string = token_string.encode('ascii')
+        # The BOP stores a hex string
+        return cls(unhexlify(token_string))
+
+
+class TriggerMetadata(object):
+    """
+    A representation of a trigger for a table.
+    """
+
+    table = None
+    """ The :class:`.TableMetadata` this trigger belongs to. """
+
+    name = None
+    """ The string name of this trigger. """
+
+    options = None
+    """
+    A dict mapping trigger option names to their specific settings for this
+    table.
+    """
+    def __init__(self, table_metadata, trigger_name, options=None):
+        self.table = table_metadata
+        self.name = trigger_name
+        self.options = options
+
+    def as_cql_query(self):
+        ret = "CREATE TRIGGER %s ON %s.%s USING %s" % (
+            protect_name(self.name),
+            protect_name(self.table.keyspace_name),
+            protect_name(self.table.name),
+            protect_value(self.options['class'])
+        )
+        return ret
+
+    def export_as_string(self):
+        return self.as_cql_query() + ';'
+
+
+class _SchemaParser(object):
+
+    def __init__(self, connection, timeout):
+        self.connection = connection
+        self.timeout = timeout
+
+    def _handle_results(self, success, result, expected_failures=tuple()):
+        """
+        Given a bool and a ResultSet (the form returned per result from
+        Connection.wait_for_responses), return a dictionary containing the
+        results. Used to process results from asynchronous queries to system
+        tables.
+
+        ``expected_failures`` will usually be used to allow callers to ignore
+        ``InvalidRequest`` errors caused by a missing system keyspace. For
+        example, some DSE versions report a 4.X server version, but do not have
+        virtual tables. Thus, running against 4.X servers, SchemaParserV4 uses
+        expected_failures to make a best-effort attempt to read those
+        keyspaces, but treat them as empty if they're not found.
+
+        :param success: A boolean representing whether or not the query
+        succeeded
+        :param result: The resultset in question.
+        :expected_failures: An Exception class or an iterable thereof. If the
+        query failed, but raised an instance of an expected failure class, this
+        will ignore the failure and return an empty list.
+        """
+        if not success and isinstance(result, expected_failures):
+            return []
+        elif success:
+            return dict_factory(result.column_names, result.parsed_rows) if result else []
+        else:
+            raise result
+
+    def _query_build_row(self, query_string, build_func):
+        result = self._query_build_rows(query_string, build_func)
+        return result[0] if result else None
+
+    def _query_build_rows(self, query_string, build_func):
+        query = QueryMessage(query=query_string, consistency_level=ConsistencyLevel.ONE)
+        responses = self.connection.wait_for_responses((query), timeout=self.timeout, fail_on_error=False)
+        (success, response) = responses[0]
+        if success:
+            result = dict_factory(response.column_names, response.parsed_rows)
+            return [build_func(row) for row in result]
+        elif isinstance(response, InvalidRequest):
+            log.debug("user types table not found")
+            return []
+        else:
+            raise response
+
+
+class SchemaParserV22(_SchemaParser):
+    """
+    For C* 2.2+
+    """
+    _SELECT_KEYSPACES = "SELECT * FROM system.schema_keyspaces"
+    _SELECT_COLUMN_FAMILIES = "SELECT * FROM system.schema_columnfamilies"
+    _SELECT_COLUMNS = "SELECT * FROM system.schema_columns"
+    _SELECT_TRIGGERS = "SELECT * FROM system.schema_triggers"
+    _SELECT_TYPES = "SELECT * FROM system.schema_usertypes"
+    _SELECT_FUNCTIONS = "SELECT * FROM system.schema_functions"
+    _SELECT_AGGREGATES = "SELECT * FROM system.schema_aggregates"
+
+    _table_name_col = 'columnfamily_name'
+
+    _function_agg_arument_type_col = 'signature'
+
+    recognized_table_options = (
+        "comment",
+        "read_repair_chance",
+        "dclocal_read_repair_chance",  # kept to be safe, but see _build_table_options()
+        "local_read_repair_chance",
+        "replicate_on_write",
+        "gc_grace_seconds",
+        "bloom_filter_fp_chance",
+        "caching",
+        "compaction_strategy_class",
+        "compaction_strategy_options",
+        "min_compaction_threshold",
+        "max_compaction_threshold",
+        "compression_parameters",
+        "min_index_interval",
+        "max_index_interval",
+        "index_interval",
+        "speculative_retry",
+        "rows_per_partition_to_cache",
+        "memtable_flush_period_in_ms",
+        "populate_io_cache_on_flush",
+        "compression",
+        "default_time_to_live")
+
+    def __init__(self, connection, timeout):
+        super(SchemaParserV22, self).__init__(connection, timeout)
+        self.keyspaces_result = []
+        self.tables_result = []
+        self.columns_result = []
+        self.triggers_result = []
+        self.types_result = []
+        self.functions_result = []
+        self.aggregates_result = []
+
+        self.keyspace_table_rows = defaultdict(list)
+        self.keyspace_table_col_rows = defaultdict(lambda: defaultdict(list))
+        self.keyspace_type_rows = defaultdict(list)
+        self.keyspace_func_rows = defaultdict(list)
+        self.keyspace_agg_rows = defaultdict(list)
+        self.keyspace_table_trigger_rows = defaultdict(lambda: defaultdict(list))
+
+    def get_all_keyspaces(self):
+        self._query_all()
+
+        for row in self.keyspaces_result:
+            keyspace_meta = self._build_keyspace_metadata(row)
+
+            try:
+                for table_row in self.keyspace_table_rows.get(keyspace_meta.name, []):
+                    table_meta = self._build_table_metadata(table_row)
+                    keyspace_meta._add_table_metadata(table_meta)
+
+                for usertype_row in self.keyspace_type_rows.get(keyspace_meta.name, []):
+                    usertype = self._build_user_type(usertype_row)
+                    keyspace_meta.user_types[usertype.name] = usertype
+
+                for fn_row in self.keyspace_func_rows.get(keyspace_meta.name, []):
+                    fn = self._build_function(fn_row)
+                    keyspace_meta.functions[fn.signature] = fn
+
+                for agg_row in self.keyspace_agg_rows.get(keyspace_meta.name, []):
+                    agg = self._build_aggregate(agg_row)
+                    keyspace_meta.aggregates[agg.signature] = agg
+            except Exception:
+                log.exception("Error while parsing metadata for keyspace %s. Metadata model will be incomplete.", keyspace_meta.name)
+                keyspace_meta._exc_info = sys.exc_info()
+
+            yield keyspace_meta
+
+    def get_table(self, keyspaces, keyspace, table):
+        cl = ConsistencyLevel.ONE
+        where_clause = bind_params(" WHERE keyspace_name = %%s AND %s = %%s" % (self._table_name_col,), (keyspace, table), _encoder)
+        cf_query = QueryMessage(query=self._SELECT_COLUMN_FAMILIES + where_clause, consistency_level=cl)
+        col_query = QueryMessage(query=self._SELECT_COLUMNS + where_clause, consistency_level=cl)
+        triggers_query = QueryMessage(query=self._SELECT_TRIGGERS + where_clause, consistency_level=cl)
+        (cf_success, cf_result), (col_success, col_result), (triggers_success, triggers_result) \
+            = self.connection.wait_for_responses(cf_query, col_query, triggers_query, timeout=self.timeout, fail_on_error=False)
+        table_result = self._handle_results(cf_success, cf_result)
+        col_result = self._handle_results(col_success, col_result)
+
+        # the triggers table doesn't exist in C* 1.2
+        triggers_result = self._handle_results(triggers_success, triggers_result,
+                                               expected_failures=InvalidRequest)
+
+        if table_result:
+            return self._build_table_metadata(table_result[0], col_result, triggers_result)
+
+    def get_type(self, keyspaces, keyspace, type):
+        where_clause = bind_params(" WHERE keyspace_name = %s AND type_name = %s", (keyspace, type), _encoder)
+        return self._query_build_row(self._SELECT_TYPES + where_clause, self._build_user_type)
+
+    def get_types_map(self, keyspaces, keyspace):
+        where_clause = bind_params(" WHERE keyspace_name = %s", (keyspace,), _encoder)
+        types = self._query_build_rows(self._SELECT_TYPES + where_clause, self._build_user_type)
+        return dict((t.name, t) for t in types)
+
+    def get_function(self, keyspaces, keyspace, function):
+        where_clause = bind_params(" WHERE keyspace_name = %%s AND function_name = %%s AND %s = %%s" % (self._function_agg_arument_type_col,),
+                                   (keyspace, function.name, function.argument_types), _encoder)
+        return self._query_build_row(self._SELECT_FUNCTIONS + where_clause, self._build_function)
+
+    def get_aggregate(self, keyspaces, keyspace, aggregate):
+        where_clause = bind_params(" WHERE keyspace_name = %%s AND aggregate_name = %%s AND %s = %%s" % (self._function_agg_arument_type_col,),
+                                   (keyspace, aggregate.name, aggregate.argument_types), _encoder)
+
+        return self._query_build_row(self._SELECT_AGGREGATES + where_clause, self._build_aggregate)
+
+    def get_keyspace(self, keyspaces, keyspace):
+        where_clause = bind_params(" WHERE keyspace_name = %s", (keyspace,), _encoder)
+        return self._query_build_row(self._SELECT_KEYSPACES + where_clause, self._build_keyspace_metadata)
+
+    @classmethod
+    def _build_keyspace_metadata(cls, row):
+        try:
+            ksm = cls._build_keyspace_metadata_internal(row)
+        except Exception:
+            name = row["keyspace_name"]
+            ksm = KeyspaceMetadata(name, False, 'UNKNOWN', {})
+            ksm._exc_info = sys.exc_info()  # capture exc_info before log because nose (test) logging clears it in certain circumstances
+            log.exception("Error while parsing metadata for keyspace %s row(%s)", name, row)
+        return ksm
+
+    @staticmethod
+    def _build_keyspace_metadata_internal(row):
+        name = row["keyspace_name"]
+        durable_writes = row["durable_writes"]
+        strategy_class = row["strategy_class"]
+        strategy_options = json.loads(row["strategy_options"])
+        return KeyspaceMetadata(name, durable_writes, strategy_class, strategy_options)
+
+    @classmethod
+    def _build_user_type(cls, usertype_row):
+        field_types = list(map(cls._schema_type_to_cql, usertype_row['field_types']))
+        return UserType(usertype_row['keyspace_name'], usertype_row['type_name'],
+                        usertype_row['field_names'], field_types)
+
+    @classmethod
+    def _build_function(cls, function_row):
+        return_type = cls._schema_type_to_cql(function_row['return_type'])
+        deterministic = function_row.get('deterministic', False)
+        monotonic = function_row.get('monotonic', False)
+        monotonic_on = function_row.get('monotonic_on', ())
+        return Function(function_row['keyspace_name'], function_row['function_name'],
+                        function_row[cls._function_agg_arument_type_col], function_row['argument_names'],
+                        return_type, function_row['language'], function_row['body'],
+                        function_row['called_on_null_input'],
+                        deterministic, monotonic, monotonic_on)
+
+    @classmethod
+    def _build_aggregate(cls, aggregate_row):
+        cass_state_type = types.lookup_casstype(aggregate_row['state_type'])
+        initial_condition = aggregate_row['initcond']
+        if initial_condition is not None:
+            initial_condition = _encoder.cql_encode_all_types(cass_state_type.deserialize(initial_condition, 3))
+        state_type = _cql_from_cass_type(cass_state_type)
+        return_type = cls._schema_type_to_cql(aggregate_row['return_type'])
+        return Aggregate(aggregate_row['keyspace_name'], aggregate_row['aggregate_name'],
+                         aggregate_row['signature'], aggregate_row['state_func'], state_type,
+                         aggregate_row['final_func'], initial_condition, return_type,
+                         aggregate_row.get('deterministic', False))
+
+    def _build_table_metadata(self, row, col_rows=None, trigger_rows=None):
+        keyspace_name = row["keyspace_name"]
+        cfname = row[self._table_name_col]
+
+        col_rows = col_rows or self.keyspace_table_col_rows[keyspace_name][cfname]
+        trigger_rows = trigger_rows or self.keyspace_table_trigger_rows[keyspace_name][cfname]
+
+        if not col_rows:  # CASSANDRA-8487
+            log.warning("Building table metadata with no column meta for %s.%s",
+                        keyspace_name, cfname)
+
+        table_meta = TableMetadata(keyspace_name, cfname)
+
+        try:
+            comparator = types.lookup_casstype(row["comparator"])
+            table_meta.comparator = comparator
+
+            is_dct_comparator = issubclass(comparator, types.DynamicCompositeType)
+            is_composite_comparator = issubclass(comparator, types.CompositeType)
+            column_name_types = comparator.subtypes if is_composite_comparator else (comparator,)
+
+            num_column_name_components = len(column_name_types)
+            last_col = column_name_types[-1]
+
+            column_aliases = row.get("column_aliases", None)
+
+            clustering_rows = [r for r in col_rows
+                               if r.get('type', None) == "clustering_key"]
+            if len(clustering_rows) > 1:
+                clustering_rows = sorted(clustering_rows, key=lambda row: row.get('component_index'))
+
+            if column_aliases is not None:
+                column_aliases = json.loads(column_aliases)
+
+            if not column_aliases:  # json load failed or column_aliases empty PYTHON-562
+                column_aliases = [r.get('column_name') for r in clustering_rows]
+
+            if is_composite_comparator:
+                if issubclass(last_col, types.ColumnToCollectionType):
+                    # collections
+                    is_compact = False
+                    has_value = False
+                    clustering_size = num_column_name_components - 2
+                elif (len(column_aliases) == num_column_name_components - 1 and
+                      issubclass(last_col, types.UTF8Type)):
+                    # aliases?
+                    is_compact = False
+                    has_value = False
+                    clustering_size = num_column_name_components - 1
+                else:
+                    # compact table
+                    is_compact = True
+                    has_value = column_aliases or not col_rows
+                    clustering_size = num_column_name_components
+
+                    # Some thrift tables define names in composite types (see PYTHON-192)
+                    if not column_aliases and hasattr(comparator, 'fieldnames'):
+                        column_aliases = filter(None, comparator.fieldnames)
+            else:
+                is_compact = True
+                if column_aliases or not col_rows or is_dct_comparator:
+                    has_value = True
+                    clustering_size = num_column_name_components
+                else:
+                    has_value = False
+                    clustering_size = 0
+
+            # partition key
+            partition_rows = [r for r in col_rows
+                              if r.get('type', None) == "partition_key"]
+
+            if len(partition_rows) > 1:
+                partition_rows = sorted(partition_rows, key=lambda row: row.get('component_index'))
+
+            key_aliases = row.get("key_aliases")
+            if key_aliases is not None:
+                key_aliases = json.loads(key_aliases) if key_aliases else []
+            else:
+                # In 2.0+, we can use the 'type' column. In 3.0+, we have to use it.
+                key_aliases = [r.get('column_name') for r in partition_rows]
+
+            key_validator = row.get("key_validator")
+            if key_validator is not None:
+                key_type = types.lookup_casstype(key_validator)
+                key_types = key_type.subtypes if issubclass(key_type, types.CompositeType) else [key_type]
+            else:
+                key_types = [types.lookup_casstype(r.get('validator')) for r in partition_rows]
+
+            for i, col_type in enumerate(key_types):
+                if len(key_aliases) > i:
+                    column_name = key_aliases[i]
+                elif i == 0:
+                    column_name = "key"
+                else:
+                    column_name = "key%d" % i
+
+                col = ColumnMetadata(table_meta, column_name, col_type.cql_parameterized_type())
+                table_meta.columns[column_name] = col
+                table_meta.partition_key.append(col)
+
+            # clustering key
+            for i in range(clustering_size):
+                if len(column_aliases) > i:
+                    column_name = column_aliases[i]
+                else:
+                    column_name = "column%d" % (i + 1)
+
+                data_type = column_name_types[i]
+                cql_type = _cql_from_cass_type(data_type)
+                is_reversed = types.is_reversed_casstype(data_type)
+                col = ColumnMetadata(table_meta, column_name, cql_type, is_reversed=is_reversed)
+                table_meta.columns[column_name] = col
+                table_meta.clustering_key.append(col)
+
+            # value alias (if present)
+            if has_value:
+                value_alias_rows = [r for r in col_rows
+                                    if r.get('type', None) == "compact_value"]
+
+                if not key_aliases:  # TODO are we checking the right thing here?
+                    value_alias = "value"
+                else:
+                    value_alias = row.get("value_alias", None)
+                    if value_alias is None and value_alias_rows:  # CASSANDRA-8487
+                        # In 2.0+, we can use the 'type' column. In 3.0+, we have to use it.
+                        value_alias = value_alias_rows[0].get('column_name')
+
+                default_validator = row.get("default_validator")
+                if default_validator:
+                    validator = types.lookup_casstype(default_validator)
+                else:
+                    if value_alias_rows:  # CASSANDRA-8487
+                        validator = types.lookup_casstype(value_alias_rows[0].get('validator'))
+
+                cql_type = _cql_from_cass_type(validator)
+                col = ColumnMetadata(table_meta, value_alias, cql_type)
+                if value_alias:  # CASSANDRA-8487
+                    table_meta.columns[value_alias] = col
+
+            # other normal columns
+            for col_row in col_rows:
+                column_meta = self._build_column_metadata(table_meta, col_row)
+                if column_meta.name is not None:
+                    table_meta.columns[column_meta.name] = column_meta
+                    index_meta = self._build_index_metadata(column_meta, col_row)
+                    if index_meta:
+                        table_meta.indexes[index_meta.name] = index_meta
+
+            for trigger_row in trigger_rows:
+                trigger_meta = self._build_trigger_metadata(table_meta, trigger_row)
+                table_meta.triggers[trigger_meta.name] = trigger_meta
+
+            table_meta.options = self._build_table_options(row)
+            table_meta.is_compact_storage = is_compact
+        except Exception:
+            table_meta._exc_info = sys.exc_info()
+            log.exception("Error while parsing metadata for table %s.%s row(%s) columns(%s)", keyspace_name, cfname, row, col_rows)
+
+        return table_meta
+
+    def _build_table_options(self, row):
+        """ Setup the mostly-non-schema table options, like caching settings """
+        options = dict((o, row.get(o)) for o in self.recognized_table_options if o in row)
+
+        # the option name when creating tables is "dclocal_read_repair_chance",
+        # but the column name in system.schema_columnfamilies is
+        # "local_read_repair_chance".  We'll store this as dclocal_read_repair_chance,
+        # since that's probably what users are expecting (and we need it for the
+        # CREATE TABLE statement anyway).
+        if "local_read_repair_chance" in options:
+            val = options.pop("local_read_repair_chance")
+            options["dclocal_read_repair_chance"] = val
+
+        return options
+
+    @classmethod
+    def _build_column_metadata(cls, table_metadata, row):
+        name = row["column_name"]
+        type_string = row["validator"]
+        data_type = types.lookup_casstype(type_string)
+        cql_type = _cql_from_cass_type(data_type)
+        is_static = row.get("type", None) == "static"
+        is_reversed = types.is_reversed_casstype(data_type)
+        column_meta = ColumnMetadata(table_metadata, name, cql_type, is_static, is_reversed)
+        column_meta._cass_type = data_type
+        return column_meta
+
+    @staticmethod
+    def _build_index_metadata(column_metadata, row):
+        index_name = row.get("index_name")
+        kind = row.get("index_type")
+        if index_name or kind:
+            options = row.get("index_options")
+            options = json.loads(options) if options else {}
+            options = options or {}  # if the json parsed to None, init empty dict
+
+            # generate a CQL index identity string
+            target = protect_name(column_metadata.name)
+            if kind != "CUSTOM":
+                if "index_keys" in options:
+                    target = 'keys(%s)' % (target,)
+                elif "index_values" in options:
+                    # don't use any "function" for collection values
+                    pass
+                else:
+                    # it might be a "full" index on a frozen collection, but
+                    # we need to check the data type to verify that, because
+                    # there is no special index option for full-collection
+                    # indexes.
+                    data_type = column_metadata._cass_type
+                    collection_types = ('map', 'set', 'list')
+                    if data_type.typename == "frozen" and data_type.subtypes[0].typename in collection_types:
+                        # no index option for full-collection index
+                        target = 'full(%s)' % (target,)
+            options['target'] = target
+            return IndexMetadata(column_metadata.table.keyspace_name, column_metadata.table.name, index_name, kind, options)
+
+    @staticmethod
+    def _build_trigger_metadata(table_metadata, row):
+        name = row["trigger_name"]
+        options = row["trigger_options"]
+        trigger_meta = TriggerMetadata(table_metadata, name, options)
+        return trigger_meta
+
+    def _query_all(self):
+        cl = ConsistencyLevel.ONE
+        queries = [
+            QueryMessage(query=self._SELECT_KEYSPACES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_COLUMN_FAMILIES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_COLUMNS, consistency_level=cl),
+            QueryMessage(query=self._SELECT_TYPES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_FUNCTIONS, consistency_level=cl),
+            QueryMessage(query=self._SELECT_AGGREGATES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_TRIGGERS, consistency_level=cl)
+        ]
+
+        ((ks_success, ks_result),
+         (table_success, table_result),
+         (col_success, col_result),
+         (types_success, types_result),
+         (functions_success, functions_result),
+         (aggregates_success, aggregates_result),
+         (triggers_success, triggers_result)) = (
+             self.connection.wait_for_responses(*queries, timeout=self.timeout,
+                                                fail_on_error=False)
+        )
+
+        self.keyspaces_result = self._handle_results(ks_success, ks_result)
+        self.tables_result = self._handle_results(table_success, table_result)
+        self.columns_result = self._handle_results(col_success, col_result)
+
+        # if we're connected to Cassandra < 2.0, the triggers table will not exist
+        if triggers_success:
+            self.triggers_result = dict_factory(triggers_result.column_names, triggers_result.parsed_rows)
+        else:
+            if isinstance(triggers_result, InvalidRequest):
+                log.debug("triggers table not found")
+            elif isinstance(triggers_result, Unauthorized):
+                log.warning("this version of Cassandra does not allow access to schema_triggers metadata with authorization enabled (CASSANDRA-7967); "
+                            "The driver will operate normally, but will not reflect triggers in the local metadata model, or schema strings.")
+            else:
+                raise triggers_result
+
+        # if we're connected to Cassandra < 2.1, the usertypes table will not exist
+        if types_success:
+            self.types_result = dict_factory(types_result.column_names, types_result.parsed_rows)
+        else:
+            if isinstance(types_result, InvalidRequest):
+                log.debug("user types table not found")
+                self.types_result = {}
+            else:
+                raise types_result
+
+        # functions were introduced in Cassandra 2.2
+        if functions_success:
+            self.functions_result = dict_factory(functions_result.column_names, functions_result.parsed_rows)
+        else:
+            if isinstance(functions_result, InvalidRequest):
+                log.debug("user functions table not found")
+            else:
+                raise functions_result
+
+        # aggregates were introduced in Cassandra 2.2
+        if aggregates_success:
+            self.aggregates_result = dict_factory(aggregates_result.column_names, aggregates_result.parsed_rows)
+        else:
+            if isinstance(aggregates_result, InvalidRequest):
+                log.debug("user aggregates table not found")
+            else:
+                raise aggregates_result
+
+        self._aggregate_results()
+
+    def _aggregate_results(self):
+        m = self.keyspace_table_rows
+        for row in self.tables_result:
+            m[row["keyspace_name"]].append(row)
+
+        m = self.keyspace_table_col_rows
+        for row in self.columns_result:
+            ksname = row["keyspace_name"]
+            cfname = row[self._table_name_col]
+            m[ksname][cfname].append(row)
+
+        m = self.keyspace_type_rows
+        for row in self.types_result:
+            m[row["keyspace_name"]].append(row)
+
+        m = self.keyspace_func_rows
+        for row in self.functions_result:
+            m[row["keyspace_name"]].append(row)
+
+        m = self.keyspace_agg_rows
+        for row in self.aggregates_result:
+            m[row["keyspace_name"]].append(row)
+
+        m = self.keyspace_table_trigger_rows
+        for row in self.triggers_result:
+            ksname = row["keyspace_name"]
+            cfname = row[self._table_name_col]
+            m[ksname][cfname].append(row)
+
+    @staticmethod
+    def _schema_type_to_cql(type_string):
+        cass_type = types.lookup_casstype(type_string)
+        return _cql_from_cass_type(cass_type)
+
+
+class SchemaParserV3(SchemaParserV22):
+    """
+    For C* 3.0+
+    """
+    _SELECT_KEYSPACES = "SELECT * FROM system_schema.keyspaces"
+    _SELECT_TABLES = "SELECT * FROM system_schema.tables"
+    _SELECT_COLUMNS = "SELECT * FROM system_schema.columns"
+    _SELECT_INDEXES = "SELECT * FROM system_schema.indexes"
+    _SELECT_TRIGGERS = "SELECT * FROM system_schema.triggers"
+    _SELECT_TYPES = "SELECT * FROM system_schema.types"
+    _SELECT_FUNCTIONS = "SELECT * FROM system_schema.functions"
+    _SELECT_AGGREGATES = "SELECT * FROM system_schema.aggregates"
+    _SELECT_VIEWS = "SELECT * FROM system_schema.views"
+
+    _table_name_col = 'table_name'
+
+    _function_agg_arument_type_col = 'argument_types'
+
+    _table_metadata_class = TableMetadataV3
+
+    recognized_table_options = (
+        'bloom_filter_fp_chance',
+        'caching',
+        'cdc',
+        'comment',
+        'compaction',
+        'compression',
+        'crc_check_chance',
+        'dclocal_read_repair_chance',
+        'default_time_to_live',
+        'gc_grace_seconds',
+        'max_index_interval',
+        'memtable_flush_period_in_ms',
+        'min_index_interval',
+        'read_repair_chance',
+        'speculative_retry')
+
+    def __init__(self, connection, timeout):
+        super(SchemaParserV3, self).__init__(connection, timeout)
+        self.indexes_result = []
+        self.keyspace_table_index_rows = defaultdict(lambda: defaultdict(list))
+        self.keyspace_view_rows = defaultdict(list)
+
+    def get_all_keyspaces(self):
+        for keyspace_meta in super(SchemaParserV3, self).get_all_keyspaces():
+            for row in self.keyspace_view_rows[keyspace_meta.name]:
+                view_meta = self._build_view_metadata(row)
+                keyspace_meta._add_view_metadata(view_meta)
+            yield keyspace_meta
+
+    def get_table(self, keyspaces, keyspace, table):
+        cl = ConsistencyLevel.ONE
+        where_clause = bind_params(" WHERE keyspace_name = %%s AND %s = %%s" % (self._table_name_col), (keyspace, table), _encoder)
+        cf_query = QueryMessage(query=self._SELECT_TABLES + where_clause, consistency_level=cl)
+        col_query = QueryMessage(query=self._SELECT_COLUMNS + where_clause, consistency_level=cl)
+        indexes_query = QueryMessage(query=self._SELECT_INDEXES + where_clause, consistency_level=cl)
+        triggers_query = QueryMessage(query=self._SELECT_TRIGGERS + where_clause, consistency_level=cl)
+
+        # in protocol v4 we don't know if this event is a view or a table, so we look for both
+        where_clause = bind_params(" WHERE keyspace_name = %s AND view_name = %s", (keyspace, table), _encoder)
+        view_query = QueryMessage(query=self._SELECT_VIEWS + where_clause,
+                                  consistency_level=cl)
+        ((cf_success, cf_result), (col_success, col_result),
+         (indexes_sucess, indexes_result), (triggers_success, triggers_result),
+         (view_success, view_result)) = (
+             self.connection.wait_for_responses(
+                 cf_query, col_query, indexes_query, triggers_query,
+                 view_query, timeout=self.timeout, fail_on_error=False)
+        )
+        table_result = self._handle_results(cf_success, cf_result)
+        col_result = self._handle_results(col_success, col_result)
+        if table_result:
+            indexes_result = self._handle_results(indexes_sucess, indexes_result)
+            triggers_result = self._handle_results(triggers_success, triggers_result)
+            return self._build_table_metadata(table_result[0], col_result, triggers_result, indexes_result)
+
+        view_result = self._handle_results(view_success, view_result)
+        if view_result:
+            return self._build_view_metadata(view_result[0], col_result)
+
+    @staticmethod
+    def _build_keyspace_metadata_internal(row):
+        name = row["keyspace_name"]
+        durable_writes = row["durable_writes"]
+        strategy_options = dict(row["replication"])
+        strategy_class = strategy_options.pop("class")
+        return KeyspaceMetadata(name, durable_writes, strategy_class, strategy_options)
+
+    @staticmethod
+    def _build_aggregate(aggregate_row):
+        return Aggregate(aggregate_row['keyspace_name'], aggregate_row['aggregate_name'],
+                         aggregate_row['argument_types'], aggregate_row['state_func'], aggregate_row['state_type'],
+                         aggregate_row['final_func'], aggregate_row['initcond'], aggregate_row['return_type'],
+                         aggregate_row.get('deterministic', False))
+
+    def _build_table_metadata(self, row, col_rows=None, trigger_rows=None, index_rows=None, virtual=False):
+        keyspace_name = row["keyspace_name"]
+        table_name = row[self._table_name_col]
+
+        col_rows = col_rows or self.keyspace_table_col_rows[keyspace_name][table_name]
+        trigger_rows = trigger_rows or self.keyspace_table_trigger_rows[keyspace_name][table_name]
+        index_rows = index_rows or self.keyspace_table_index_rows[keyspace_name][table_name]
+
+        table_meta = self._table_metadata_class(keyspace_name, table_name, virtual=virtual)
+        try:
+            table_meta.options = self._build_table_options(row)
+            flags = row.get('flags', set())
+            if flags:
+                is_dense = 'dense' in flags
+                compact_static = not is_dense and 'super' not in flags and 'compound' not in flags
+                table_meta.is_compact_storage = is_dense or 'super' in flags or 'compound' not in flags
+            elif virtual:
+                compact_static = False
+                table_meta.is_compact_storage = False
+                is_dense = False
+            else:
+                compact_static = True
+                table_meta.is_compact_storage = True
+                is_dense = False
+
+            self._build_table_columns(table_meta, col_rows, compact_static, is_dense, virtual)
+
+            for trigger_row in trigger_rows:
+                trigger_meta = self._build_trigger_metadata(table_meta, trigger_row)
+                table_meta.triggers[trigger_meta.name] = trigger_meta
+
+            for index_row in index_rows:
+                index_meta = self._build_index_metadata(table_meta, index_row)
+                if index_meta:
+                    table_meta.indexes[index_meta.name] = index_meta
+
+            table_meta.extensions = row.get('extensions', {})
+        except Exception:
+            table_meta._exc_info = sys.exc_info()
+            log.exception("Error while parsing metadata for table %s.%s row(%s) columns(%s)", keyspace_name, table_name, row, col_rows)
+
+        return table_meta
+
+    def _build_table_options(self, row):
+        """ Setup the mostly-non-schema table options, like caching settings """
+        return dict((o, row.get(o)) for o in self.recognized_table_options if o in row)
+
+    def _build_table_columns(self, meta, col_rows, compact_static=False, is_dense=False, virtual=False):
+        # partition key
+        partition_rows = [r for r in col_rows
+                          if r.get('kind', None) == "partition_key"]
+        if len(partition_rows) > 1:
+            partition_rows = sorted(partition_rows, key=lambda row: row.get('position'))
+        for r in partition_rows:
+            # we have to add meta here (and not in the later loop) because TableMetadata.columns is an
+            # OrderedDict, and it assumes keys are inserted first, in order, when exporting CQL
+            column_meta = self._build_column_metadata(meta, r)
+            meta.columns[column_meta.name] = column_meta
+            meta.partition_key.append(meta.columns[r.get('column_name')])
+
+        # clustering key
+        if not compact_static:
+            clustering_rows = [r for r in col_rows
+                               if r.get('kind', None) == "clustering"]
+            if len(clustering_rows) > 1:
+                clustering_rows = sorted(clustering_rows, key=lambda row: row.get('position'))
+            for r in clustering_rows:
+                column_meta = self._build_column_metadata(meta, r)
+                meta.columns[column_meta.name] = column_meta
+                meta.clustering_key.append(meta.columns[r.get('column_name')])
+
+        for col_row in (r for r in col_rows
+                        if r.get('kind', None) not in ('partition_key', 'clustering_key')):
+            column_meta = self._build_column_metadata(meta, col_row)
+            if is_dense and column_meta.cql_type == types.cql_empty_type:
+                continue
+            if compact_static and not column_meta.is_static:
+                # for compact static tables, we omit the clustering key and value, and only add the logical columns.
+                # They are marked not static so that it generates appropriate CQL
+                continue
+            if compact_static:
+                column_meta.is_static = False
+            meta.columns[column_meta.name] = column_meta
+
+    def _build_view_metadata(self, row, col_rows=None):
+        keyspace_name = row["keyspace_name"]
+        view_name = row["view_name"]
+        base_table_name = row["base_table_name"]
+        include_all_columns = row["include_all_columns"]
+        where_clause = row["where_clause"]
+        col_rows = col_rows or self.keyspace_table_col_rows[keyspace_name][view_name]
+        view_meta = MaterializedViewMetadata(keyspace_name, view_name, base_table_name,
+                                             include_all_columns, where_clause, self._build_table_options(row))
+        self._build_table_columns(view_meta, col_rows)
+        view_meta.extensions = row.get('extensions', {})
+
+        return view_meta
+
+    @staticmethod
+    def _build_column_metadata(table_metadata, row):
+        name = row["column_name"]
+        cql_type = row["type"]
+        is_static = row.get("kind", None) == "static"
+        is_reversed = row["clustering_order"].upper() == "DESC"
+        column_meta = ColumnMetadata(table_metadata, name, cql_type, is_static, is_reversed)
+        return column_meta
+
+    @staticmethod
+    def _build_index_metadata(table_metadata, row):
+        index_name = row.get("index_name")
+        kind = row.get("kind")
+        if index_name or kind:
+            index_options = row.get("options")
+            return IndexMetadata(table_metadata.keyspace_name, table_metadata.name, index_name, kind, index_options)
+        else:
+            return None
+
+    @staticmethod
+    def _build_trigger_metadata(table_metadata, row):
+        name = row["trigger_name"]
+        options = row["options"]
+        trigger_meta = TriggerMetadata(table_metadata, name, options)
+        return trigger_meta
+
+    def _query_all(self):
+        cl = ConsistencyLevel.ONE
+        queries = [
+            QueryMessage(query=self._SELECT_KEYSPACES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_TABLES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_COLUMNS, consistency_level=cl),
+            QueryMessage(query=self._SELECT_TYPES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_FUNCTIONS, consistency_level=cl),
+            QueryMessage(query=self._SELECT_AGGREGATES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_TRIGGERS, consistency_level=cl),
+            QueryMessage(query=self._SELECT_INDEXES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_VIEWS, consistency_level=cl)
+        ]
+
+        ((ks_success, ks_result),
+         (table_success, table_result),
+         (col_success, col_result),
+         (types_success, types_result),
+         (functions_success, functions_result),
+         (aggregates_success, aggregates_result),
+         (triggers_success, triggers_result),
+         (indexes_success, indexes_result),
+         (views_success, views_result)) = self.connection.wait_for_responses(
+             *queries, timeout=self.timeout, fail_on_error=False
+        )
+
+        self.keyspaces_result = self._handle_results(ks_success, ks_result)
+        self.tables_result = self._handle_results(table_success, table_result)
+        self.columns_result = self._handle_results(col_success, col_result)
+        self.triggers_result = self._handle_results(triggers_success, triggers_result)
+        self.types_result = self._handle_results(types_success, types_result)
+        self.functions_result = self._handle_results(functions_success, functions_result)
+        self.aggregates_result = self._handle_results(aggregates_success, aggregates_result)
+        self.indexes_result = self._handle_results(indexes_success, indexes_result)
+        self.views_result = self._handle_results(views_success, views_result)
+
+        self._aggregate_results()
+
+    def _aggregate_results(self):
+        super(SchemaParserV3, self)._aggregate_results()
+
+        m = self.keyspace_table_index_rows
+        for row in self.indexes_result:
+            ksname = row["keyspace_name"]
+            cfname = row[self._table_name_col]
+            m[ksname][cfname].append(row)
+
+        m = self.keyspace_view_rows
+        for row in self.views_result:
+            m[row["keyspace_name"]].append(row)
+
+    @staticmethod
+    def _schema_type_to_cql(type_string):
+        return type_string
+
+
+class SchemaParserDSE60(SchemaParserV3):
+    """
+    For DSE 6.0+
+    """
+    recognized_table_options = (SchemaParserV3.recognized_table_options +
+                                ("nodesync",))
+
+
+class SchemaParserV4(SchemaParserV3):
+
+    recognized_table_options = (
+        'additional_write_policy',
+        'bloom_filter_fp_chance',
+        'caching',
+        'cdc',
+        'comment',
+        'compaction',
+        'compression',
+        'crc_check_chance',
+        'default_time_to_live',
+        'gc_grace_seconds',
+        'max_index_interval',
+        'memtable_flush_period_in_ms',
+        'min_index_interval',
+        'read_repair',
+        'speculative_retry')
+
+    _SELECT_VIRTUAL_KEYSPACES = 'SELECT * from system_virtual_schema.keyspaces'
+    _SELECT_VIRTUAL_TABLES = 'SELECT * from system_virtual_schema.tables'
+    _SELECT_VIRTUAL_COLUMNS = 'SELECT * from system_virtual_schema.columns'
+
+    def __init__(self, connection, timeout):
+        super(SchemaParserV4, self).__init__(connection, timeout)
+        self.virtual_keyspaces_rows = defaultdict(list)
+        self.virtual_tables_rows = defaultdict(list)
+        self.virtual_columns_rows = defaultdict(lambda: defaultdict(list))
+
+    def _query_all(self):
+        cl = ConsistencyLevel.ONE
+        # todo: this duplicates V3; we should find a way for _query_all methods
+        # to extend each other.
+        queries = [
+            # copied from V3
+            QueryMessage(query=self._SELECT_KEYSPACES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_TABLES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_COLUMNS, consistency_level=cl),
+            QueryMessage(query=self._SELECT_TYPES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_FUNCTIONS, consistency_level=cl),
+            QueryMessage(query=self._SELECT_AGGREGATES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_TRIGGERS, consistency_level=cl),
+            QueryMessage(query=self._SELECT_INDEXES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_VIEWS, consistency_level=cl),
+            # V4-only queries
+            QueryMessage(query=self._SELECT_VIRTUAL_KEYSPACES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_VIRTUAL_TABLES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_VIRTUAL_COLUMNS, consistency_level=cl)
+        ]
+
+        responses = self.connection.wait_for_responses(
+            *queries, timeout=self.timeout, fail_on_error=False)
+        (
+            # copied from V3
+            (ks_success, ks_result),
+            (table_success, table_result),
+            (col_success, col_result),
+            (types_success, types_result),
+            (functions_success, functions_result),
+            (aggregates_success, aggregates_result),
+            (triggers_success, triggers_result),
+            (indexes_success, indexes_result),
+            (views_success, views_result),
+            # V4-only responses
+            (virtual_ks_success, virtual_ks_result),
+            (virtual_table_success, virtual_table_result),
+            (virtual_column_success, virtual_column_result)
+        ) = responses
+
+        # copied from V3
+        self.keyspaces_result = self._handle_results(ks_success, ks_result)
+        self.tables_result = self._handle_results(table_success, table_result)
+        self.columns_result = self._handle_results(col_success, col_result)
+        self.triggers_result = self._handle_results(triggers_success, triggers_result)
+        self.types_result = self._handle_results(types_success, types_result)
+        self.functions_result = self._handle_results(functions_success, functions_result)
+        self.aggregates_result = self._handle_results(aggregates_success, aggregates_result)
+        self.indexes_result = self._handle_results(indexes_success, indexes_result)
+        self.views_result = self._handle_results(views_success, views_result)
+        # V4-only results
+        # These tables don't exist in some DSE versions reporting 4.X so we can
+        # ignore them if we got an error
+        self.virtual_keyspaces_result = self._handle_results(
+            virtual_ks_success, virtual_ks_result,
+            expected_failures=(InvalidRequest,)
+        )
+        self.virtual_tables_result = self._handle_results(
+            virtual_table_success, virtual_table_result,
+            expected_failures=(InvalidRequest,)
+        )
+        self.virtual_columns_result = self._handle_results(
+            virtual_column_success, virtual_column_result,
+            expected_failures=(InvalidRequest,)
+        )
+
+        self._aggregate_results()
+
+    def _aggregate_results(self):
+        super(SchemaParserV4, self)._aggregate_results()
+
+        m = self.virtual_tables_rows
+        for row in self.virtual_tables_result:
+            m[row["keyspace_name"]].append(row)
+
+        m = self.virtual_columns_rows
+        for row in self.virtual_columns_result:
+            ks_name = row['keyspace_name']
+            tab_name = row[self._table_name_col]
+            m[ks_name][tab_name].append(row)
+
+    def get_all_keyspaces(self):
+        for x in super(SchemaParserV4, self).get_all_keyspaces():
+            yield x
+
+        for row in self.virtual_keyspaces_result:
+            ks_name = row['keyspace_name']
+            keyspace_meta = self._build_keyspace_metadata(row)
+            keyspace_meta.virtual = True
+
+            for table_row in self.virtual_tables_rows.get(ks_name, []):
+                table_name = table_row[self._table_name_col]
+
+                col_rows = self.virtual_columns_rows[ks_name][table_name]
+                keyspace_meta._add_table_metadata(
+                    self._build_table_metadata(table_row,
+                                               col_rows=col_rows,
+                                               virtual=True)
+                )
+            yield keyspace_meta
+
+    @staticmethod
+    def _build_keyspace_metadata_internal(row):
+        # necessary fields that aren't int virtual ks
+        row["durable_writes"] = row.get("durable_writes", None)
+        row["replication"] = row.get("replication", {})
+        row["replication"]["class"] = row["replication"].get("class", None)
+        return super(SchemaParserV4, SchemaParserV4)._build_keyspace_metadata_internal(row)
+
+
+class SchemaParserDSE67(SchemaParserV4):
+    """
+    For DSE 6.7+
+    """
+    recognized_table_options = (SchemaParserV4.recognized_table_options +
+                                ("nodesync",))
+
+
+class SchemaParserDSE68(SchemaParserDSE67):
+    """
+    For DSE 6.8+
+    """
+
+    _SELECT_VERTICES = "SELECT * FROM system_schema.vertices"
+    _SELECT_EDGES = "SELECT * FROM system_schema.edges"
+
+    _table_metadata_class = TableMetadataDSE68
+
+    def __init__(self, connection, timeout):
+        super(SchemaParserDSE68, self).__init__(connection, timeout)
+        self.keyspace_table_vertex_rows = defaultdict(lambda: defaultdict(list))
+        self.keyspace_table_edge_rows = defaultdict(lambda: defaultdict(list))
+
+    def get_all_keyspaces(self):
+        for keyspace_meta in super(SchemaParserDSE68, self).get_all_keyspaces():
+            self._build_graph_metadata(keyspace_meta)
+            yield keyspace_meta
+
+    def get_table(self, keyspaces, keyspace, table):
+        table_meta = super(SchemaParserDSE68, self).get_table(keyspaces, keyspace, table)
+        cl = ConsistencyLevel.ONE
+        where_clause = bind_params(" WHERE keyspace_name = %%s AND %s = %%s" % (self._table_name_col), (keyspace, table), _encoder)
+        vertices_query = QueryMessage(query=self._SELECT_VERTICES + where_clause, consistency_level=cl)
+        edges_query = QueryMessage(query=self._SELECT_EDGES + where_clause, consistency_level=cl)
+
+        (vertices_success, vertices_result), (edges_success, edges_result) \
+            = self.connection.wait_for_responses(vertices_query, edges_query, timeout=self.timeout, fail_on_error=False)
+        vertices_result = self._handle_results(vertices_success, vertices_result)
+        edges_result = self._handle_results(edges_success, edges_result)
+
+        try:
+            if vertices_result:
+                table_meta.vertex = self._build_table_vertex_metadata(vertices_result[0])
+            elif edges_result:
+                table_meta.edge = self._build_table_edge_metadata(keyspaces[keyspace], edges_result[0])
+        except Exception:
+            table_meta.vertex = None
+            table_meta.edge = None
+            table_meta._exc_info = sys.exc_info()
+            log.exception("Error while parsing graph metadata for table %s.%s.", keyspace, table)
+
+        return table_meta
+
+    @staticmethod
+    def _build_keyspace_metadata_internal(row):
+        name = row["keyspace_name"]
+        durable_writes = row.get("durable_writes", None)
+        replication = dict(row.get("replication")) if 'replication' in row else {}
+        replication_class = replication.pop("class") if 'class' in replication else None
+        graph_engine = row.get("graph_engine", None)
+        return KeyspaceMetadata(name, durable_writes, replication_class, replication, graph_engine)
+
+    def _build_graph_metadata(self, keyspace_meta):
+
+        def _build_table_graph_metadata(table_meta):
+            for row in self.keyspace_table_vertex_rows[keyspace_meta.name][table_meta.name]:
+                table_meta.vertex = self._build_table_vertex_metadata(row)
+
+            for row in self.keyspace_table_edge_rows[keyspace_meta.name][table_meta.name]:
+                table_meta.edge = self._build_table_edge_metadata(keyspace_meta, row)
+
+        try:
+            # Make sure we process vertices before edges
+            for table_meta in [t for t in keyspace_meta.tables.values()
+                               if t.name in self.keyspace_table_vertex_rows[keyspace_meta.name]]:
+                _build_table_graph_metadata(table_meta)
+
+            # all other tables...
+            for table_meta in [t for t in keyspace_meta.tables.values()
+                               if t.name not in self.keyspace_table_vertex_rows[keyspace_meta.name]]:
+                _build_table_graph_metadata(table_meta)
+        except Exception:
+            # schema error, remove all graph metadata for this keyspace
+            for t in keyspace_meta.tables.values():
+                t.edge = t.vertex = None
+            keyspace_meta._exc_info = sys.exc_info()
+            log.exception("Error while parsing graph metadata for keyspace %s", keyspace_meta.name)
+
+    @staticmethod
+    def _build_table_vertex_metadata(row):
+        return VertexMetadata(row.get("keyspace_name"), row.get("table_name"),
+                              row.get("label_name"))
+
+    @staticmethod
+    def _build_table_edge_metadata(keyspace_meta, row):
+        from_table = row.get("from_table")
+        from_table_meta = keyspace_meta.tables.get(from_table)
+        from_label = from_table_meta.vertex.label_name
+        to_table = row.get("to_table")
+        to_table_meta = keyspace_meta.tables.get(to_table)
+        to_label = to_table_meta.vertex.label_name
+
+        return EdgeMetadata(
+            row.get("keyspace_name"), row.get("table_name"),
+            row.get("label_name"), from_table, from_label,
+            row.get("from_partition_key_columns"),
+            row.get("from_clustering_columns"), to_table, to_label,
+            row.get("to_partition_key_columns"),
+            row.get("to_clustering_columns"))
+
+    def _query_all(self):
+        cl = ConsistencyLevel.ONE
+        queries = [
+            # copied from v4
+            QueryMessage(query=self._SELECT_KEYSPACES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_TABLES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_COLUMNS, consistency_level=cl),
+            QueryMessage(query=self._SELECT_TYPES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_FUNCTIONS, consistency_level=cl),
+            QueryMessage(query=self._SELECT_AGGREGATES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_TRIGGERS, consistency_level=cl),
+            QueryMessage(query=self._SELECT_INDEXES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_VIEWS, consistency_level=cl),
+            QueryMessage(query=self._SELECT_VIRTUAL_KEYSPACES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_VIRTUAL_TABLES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_VIRTUAL_COLUMNS, consistency_level=cl),
+            # dse6.8 only
+            QueryMessage(query=self._SELECT_VERTICES, consistency_level=cl),
+            QueryMessage(query=self._SELECT_EDGES, consistency_level=cl)
+        ]
+
+        responses = self.connection.wait_for_responses(
+            *queries, timeout=self.timeout, fail_on_error=False)
+        (
+            # copied from V4
+            (ks_success, ks_result),
+            (table_success, table_result),
+            (col_success, col_result),
+            (types_success, types_result),
+            (functions_success, functions_result),
+            (aggregates_success, aggregates_result),
+            (triggers_success, triggers_result),
+            (indexes_success, indexes_result),
+            (views_success, views_result),
+            (virtual_ks_success, virtual_ks_result),
+            (virtual_table_success, virtual_table_result),
+            (virtual_column_success, virtual_column_result),
+            # dse6.8 responses
+            (vertices_success, vertices_result),
+            (edges_success, edges_result)
+        ) = responses
+
+        # copied from V4
+        self.keyspaces_result = self._handle_results(ks_success, ks_result)
+        self.tables_result = self._handle_results(table_success, table_result)
+        self.columns_result = self._handle_results(col_success, col_result)
+        self.triggers_result = self._handle_results(triggers_success, triggers_result)
+        self.types_result = self._handle_results(types_success, types_result)
+        self.functions_result = self._handle_results(functions_success, functions_result)
+        self.aggregates_result = self._handle_results(aggregates_success, aggregates_result)
+        self.indexes_result = self._handle_results(indexes_success, indexes_result)
+        self.views_result = self._handle_results(views_success, views_result)
+
+        # These tables don't exist in some DSE versions reporting 4.X so we can
+        # ignore them if we got an error
+        self.virtual_keyspaces_result = self._handle_results(
+            virtual_ks_success, virtual_ks_result,
+            expected_failures=(InvalidRequest,)
+        )
+        self.virtual_tables_result = self._handle_results(
+            virtual_table_success, virtual_table_result,
+            expected_failures=(InvalidRequest,)
+        )
+        self.virtual_columns_result = self._handle_results(
+            virtual_column_success, virtual_column_result,
+            expected_failures=(InvalidRequest,)
+        )
+
+        # dse6.8-only results
+        self.vertices_result = self._handle_results(vertices_success, vertices_result)
+        self.edges_result = self._handle_results(edges_success, edges_result)
+
+        self._aggregate_results()
+
+    def _aggregate_results(self):
+        super(SchemaParserDSE68, self)._aggregate_results()
+
+        m = self.keyspace_table_vertex_rows
+        for row in self.vertices_result:
+            ksname = row["keyspace_name"]
+            cfname = row['table_name']
+            m[ksname][cfname].append(row)
+
+        m = self.keyspace_table_edge_rows
+        for row in self.edges_result:
+            ksname = row["keyspace_name"]
+            cfname = row['table_name']
+            m[ksname][cfname].append(row)
+
+
+class MaterializedViewMetadata(object):
+    """
+    A representation of a materialized view on a table
+    """
+
+    keyspace_name = None
+    """ A string name of the keyspace of this view."""
+
+    name = None
+    """ A string name of the view."""
+
+    base_table_name = None
+    """ A string name of the base table for this view."""
+
+    partition_key = None
+    """
+    A list of :class:`.ColumnMetadata` instances representing the columns in
+    the partition key for this view.  This will always hold at least one
+    column.
+    """
+
+    clustering_key = None
+    """
+    A list of :class:`.ColumnMetadata` instances representing the columns
+    in the clustering key for this view.
+
+    Note that a table may have no clustering keys, in which case this will
+    be an empty list.
+    """
+
+    columns = None
+    """
+    A dict mapping column names to :class:`.ColumnMetadata` instances.
+    """
+
+    include_all_columns = None
+    """ A flag indicating whether the view was created AS SELECT * """
+
+    where_clause = None
+    """ String WHERE clause for the view select statement. From server metadata """
+
+    options = None
+    """
+    A dict mapping table option names to their specific settings for this
+    view.
+    """
+
+    extensions = None
+    """
+    Metadata describing configuration for table extensions
+    """
+
+    def __init__(self, keyspace_name, view_name, base_table_name, include_all_columns, where_clause, options):
+        self.keyspace_name = keyspace_name
+        self.name = view_name
+        self.base_table_name = base_table_name
+        self.partition_key = []
+        self.clustering_key = []
+        self.columns = OrderedDict()
+        self.include_all_columns = include_all_columns
+        self.where_clause = where_clause
+        self.options = options or {}
+
+    def as_cql_query(self, formatted=False):
+        """
+        Returns a CQL query that can be used to recreate this function.
+        If `formatted` is set to :const:`True`, extra whitespace will
+        be added to make the query more readable.
+        """
+        sep = '\n    ' if formatted else ' '
+        keyspace = protect_name(self.keyspace_name)
+        name = protect_name(self.name)
+
+        selected_cols = '*' if self.include_all_columns else ', '.join(protect_name(col.name) for col in self.columns.values())
+        base_table = protect_name(self.base_table_name)
+        where_clause = self.where_clause
+
+        part_key = ', '.join(protect_name(col.name) for col in self.partition_key)
+        if len(self.partition_key) > 1:
+            pk = "((%s)" % part_key
+        else:
+            pk = "(%s" % part_key
+        if self.clustering_key:
+            pk += ", %s" % ', '.join(protect_name(col.name) for col in self.clustering_key)
+        pk += ")"
+
+        properties = TableMetadataV3._property_string(formatted, self.clustering_key, self.options)
+
+        ret = ("CREATE MATERIALIZED VIEW %(keyspace)s.%(name)s AS%(sep)s"
+               "SELECT %(selected_cols)s%(sep)s"
+               "FROM %(keyspace)s.%(base_table)s%(sep)s"
+               "WHERE %(where_clause)s%(sep)s"
+               "PRIMARY KEY %(pk)s%(sep)s"
+               "WITH %(properties)s") % locals()
+
+        if self.extensions:
+            registry = _RegisteredExtensionType._extension_registry
+            for k in registry.keys() & self.extensions:  # no viewkeys on OrderedMapSerializeKey
+                ext = registry[k]
+                cql = ext.after_table_cql(self, k, self.extensions[k])
+                if cql:
+                    ret += "\n\n%s" % (cql,)
+        return ret
+
+    def export_as_string(self):
+        return self.as_cql_query(formatted=True) + ";"
+
+
+class VertexMetadata(object):
+    """
+    A representation of a vertex on a table
+    """
+
+    keyspace_name = None
+    """ A string name of the keyspace. """
+
+    table_name = None
+    """ A string name of the table this vertex is on. """
+
+    label_name = None
+    """ A string name of the label of this vertex."""
+
+    def __init__(self, keyspace_name, table_name, label_name):
+        self.keyspace_name = keyspace_name
+        self.table_name = table_name
+        self.label_name = label_name
+
+
+class EdgeMetadata(object):
+    """
+    A representation of an edge on a table
+    """
+
+    keyspace_name = None
+    """A string name of the keyspace """
+
+    table_name = None
+    """A string name of the table this edge is on"""
+
+    label_name = None
+    """A string name of the label of this edge"""
+
+    from_table = None
+    """A string name of the from table of this edge (incoming vertex)"""
+
+    from_label = None
+    """A string name of the from table label of this edge (incoming vertex)"""
+
+    from_partition_key_columns = None
+    """The columns that match the partition key of the incoming vertex table."""
+
+    from_clustering_columns = None
+    """The columns that match the clustering columns of the incoming vertex table."""
+
+    to_table = None
+    """A string name of the to table of this edge (outgoing vertex)"""
+
+    to_label = None
+    """A string name of the to table label of this edge (outgoing vertex)"""
+
+    to_partition_key_columns = None
+    """The columns that match the partition key of the outgoing vertex table."""
+
+    to_clustering_columns = None
+    """The columns that match the clustering columns of the outgoing vertex table."""
+
+    def __init__(
+            self, keyspace_name, table_name, label_name, from_table,
+            from_label, from_partition_key_columns, from_clustering_columns,
+            to_table, to_label, to_partition_key_columns,
+            to_clustering_columns):
+        self.keyspace_name = keyspace_name
+        self.table_name = table_name
+        self.label_name = label_name
+        self.from_table = from_table
+        self.from_label = from_label
+        self.from_partition_key_columns = from_partition_key_columns
+        self.from_clustering_columns = from_clustering_columns
+        self.to_table = to_table
+        self.to_label = to_label
+        self.to_partition_key_columns = to_partition_key_columns
+        self.to_clustering_columns = to_clustering_columns
+
+
+def get_schema_parser(connection, server_version, dse_version, timeout):
+    version = Version(server_version)
+    if dse_version:
+        v = Version(dse_version)
+        if v >= Version('6.8.0'):
+            return SchemaParserDSE68(connection, timeout)
+        elif v >= Version('6.7.0'):
+            return SchemaParserDSE67(connection, timeout)
+        elif v >= Version('6.0.0'):
+            return SchemaParserDSE60(connection, timeout)
+
+    if version >= Version('4-a'):
+        return SchemaParserV4(connection, timeout)
+    elif version >= Version('3.0.0'):
+        return SchemaParserV3(connection, timeout)
+    else:
+        # we could further specialize by version. Right now just refactoring the
+        # multi-version parser we have as of C* 2.2.0rc1.
+        return SchemaParserV22(connection, timeout)
+
+
+def _cql_from_cass_type(cass_type):
+    """
+    A string representation of the type for this column, such as "varchar"
+    or "map<string, int>".
+    """
+    if issubclass(cass_type, types.ReversedType):
+        return cass_type.subtypes[0].cql_parameterized_type()
+    else:
+        return cass_type.cql_parameterized_type()
+
+
+class RLACTableExtension(RegisteredTableExtension):
+    name = "DSE_RLACA"
+
+    @classmethod
+    def after_table_cql(cls, table_meta, ext_key, ext_blob):
+        return "RESTRICT ROWS ON %s.%s USING %s;" % (protect_name(table_meta.keyspace_name),
+                                                     protect_name(table_meta.name),
+                                                     protect_name(ext_blob.decode('utf-8')))
+NO_VALID_REPLICA = object()
+
+
+def group_keys_by_replica(session, keyspace, table, keys):
+    """
+    Returns a :class:`dict` with the keys grouped per host. This can be
+    used to more accurately group by IN clause or to batch the keys per host.
+
+    If a valid replica is not found for a particular key it will be grouped under
+    :class:`~.NO_VALID_REPLICA`
+
+    Example usage::
+        result = group_keys_by_replica(
+                     session, "system", "peers",
+                     (("127.0.0.1", ), ("127.0.0.2", ))
+                 )
+    """
+    cluster = session.cluster
+
+    partition_keys = cluster.metadata.keyspaces[keyspace].tables[table].partition_key
+
+    serializers = list(types._cqltypes[partition_key.cql_type] for partition_key in partition_keys)
+    keys_per_host = defaultdict(list)
+    distance = cluster._default_load_balancing_policy.distance
+
+    for key in keys:
+        serialized_key = [serializer.serialize(pk, cluster.protocol_version)
+                          for serializer, pk in zip(serializers, key)]
+        if len(serialized_key) == 1:
+            routing_key = serialized_key[0]
+        else:
+            routing_key = b"".join(struct.pack(">H%dsB" % len(p), len(p), p, 0) for p in serialized_key)
+        all_replicas = cluster.metadata.get_replicas(keyspace, routing_key)
+        # First check if there are local replicas
+        valid_replicas = [host for host in all_replicas if
+                          host.is_up and distance(host) == HostDistance.LOCAL]
+        if not valid_replicas:
+            valid_replicas = [host for host in all_replicas if host.is_up]
+
+        if valid_replicas:
+            keys_per_host[random.choice(valid_replicas)].append(key)
+        else:
+            # We will group under this statement all the keys for which
+            # we haven't found a valid replica
+            keys_per_host[NO_VALID_REPLICA].append(key)
+
+    return dict(keys_per_host)
+
+
+# TODO next major reorg
+class _NodeInfo(object):
+    """
+    Internal utility functions to determine the different host addresses/ports
+    from a local or peers row.
+    """
+
+    @staticmethod
+    def get_broadcast_rpc_address(row):
+        # TODO next major, change the parsing logic to avoid any
+        #  overriding of a non-null value
+        addr = row.get("rpc_address")
+        if "native_address" in row:
+            addr = row.get("native_address")
+        if "native_transport_address" in row:
+            addr = row.get("native_transport_address")
+        if not addr or addr in ["0.0.0.0", "::"]:
+            addr = row.get("peer")
+
+        return addr
+
+    @staticmethod
+    def get_broadcast_rpc_port(row):
+        port = row.get("rpc_port")
+        if port is None or port == 0:
+            port = row.get("native_port")
+
+        return port if port and port > 0 else None
+
+    @staticmethod
+    def get_broadcast_address(row):
+        addr = row.get("broadcast_address")
+        if addr is None:
+            addr = row.get("peer")
+
+        return addr
+
+    @staticmethod
+    def get_broadcast_port(row):
+        port = row.get("broadcast_port")
+        if port is None or port == 0:
+            port = row.get("peer_port")
+
+        return port if port and port > 0 else None
diff --git a/llm/Lib/site-packages/cassandra/metrics.py b/llm/Lib/site-packages/cassandra/metrics.py
new file mode 100644
index 0000000000000000000000000000000000000000..04c37bc91e7b60b07a4c6ad23136a5c897c6f39a
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/metrics.py
@@ -0,0 +1,201 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from itertools import chain
+import logging
+
+try:
+    from greplin import scales
+except ImportError:
+    raise ImportError(
+        "The scales library is required for metrics support: "
+        "https://pypi.org/project/scales/")
+
+log = logging.getLogger(__name__)
+
+
+class Metrics(object):
+    """
+    A collection of timers and counters for various performance metrics.
+
+    Timer metrics are represented as floating point seconds.
+    """
+
+    request_timer = None
+    """
+    A :class:`greplin.scales.PmfStat` timer for requests. This is a dict-like
+    object with the following keys:
+
+    * count - number of requests that have been timed
+    * min - min latency
+    * max - max latency
+    * mean - mean latency
+    * stddev - standard deviation for latencies
+    * median - median latency
+    * 75percentile - 75th percentile latencies
+    * 95percentile - 95th percentile latencies
+    * 98percentile - 98th percentile latencies
+    * 99percentile - 99th percentile latencies
+    * 999percentile - 99.9th percentile latencies
+    """
+
+    connection_errors = None
+    """
+    A :class:`greplin.scales.IntStat` count of the number of times that a
+    request to a Cassandra node has failed due to a connection problem.
+    """
+
+    write_timeouts = None
+    """
+    A :class:`greplin.scales.IntStat` count of write requests that resulted
+    in a timeout.
+    """
+
+    read_timeouts = None
+    """
+    A :class:`greplin.scales.IntStat` count of read requests that resulted
+    in a timeout.
+    """
+
+    unavailables = None
+    """
+    A :class:`greplin.scales.IntStat` count of write or read requests that
+    failed due to an insufficient number of replicas being alive to meet
+    the requested :class:`.ConsistencyLevel`.
+    """
+
+    other_errors = None
+    """
+    A :class:`greplin.scales.IntStat` count of all other request failures,
+    including failures caused by invalid requests, bootstrapping nodes,
+    overloaded nodes, etc.
+    """
+
+    retries = None
+    """
+    A :class:`greplin.scales.IntStat` count of the number of times a
+    request was retried based on the :class:`.RetryPolicy` decision.
+    """
+
+    ignores = None
+    """
+    A :class:`greplin.scales.IntStat` count of the number of times a
+    failed request was ignored based on the :class:`.RetryPolicy` decision.
+    """
+
+    known_hosts = None
+    """
+    A :class:`greplin.scales.IntStat` count of the number of nodes in
+    the cluster that the driver is aware of, regardless of whether any
+    connections are opened to those nodes.
+    """
+
+    connected_to = None
+    """
+    A :class:`greplin.scales.IntStat` count of the number of nodes that
+    the driver currently has at least one connection open to.
+    """
+
+    open_connections = None
+    """
+    A :class:`greplin.scales.IntStat` count of the number connections
+    the driver currently has open.
+    """
+
+    _stats_counter = 0
+
+    def __init__(self, cluster_proxy):
+        log.debug("Starting metric capture")
+
+        self.stats_name = 'cassandra-{0}'.format(str(self._stats_counter))
+        Metrics._stats_counter += 1
+        self.stats = scales.collection(self.stats_name,
+            scales.PmfStat('request_timer'),
+            scales.IntStat('connection_errors'),
+            scales.IntStat('write_timeouts'),
+            scales.IntStat('read_timeouts'),
+            scales.IntStat('unavailables'),
+            scales.IntStat('other_errors'),
+            scales.IntStat('retries'),
+            scales.IntStat('ignores'),
+
+            # gauges
+            scales.Stat('known_hosts',
+                lambda: len(cluster_proxy.metadata.all_hosts())),
+            scales.Stat('connected_to',
+                lambda: len(set(chain.from_iterable(s._pools.keys() for s in cluster_proxy.sessions)))),
+            scales.Stat('open_connections',
+                lambda: sum(sum(p.open_count for p in s._pools.values()) for s in cluster_proxy.sessions)))
+
+        # TODO, to be removed in 4.0
+        # /cassandra contains the metrics of the first cluster registered
+        if 'cassandra' not in scales._Stats.stats:
+            scales._Stats.stats['cassandra'] = scales._Stats.stats[self.stats_name]
+
+        self.request_timer = self.stats.request_timer
+        self.connection_errors = self.stats.connection_errors
+        self.write_timeouts = self.stats.write_timeouts
+        self.read_timeouts = self.stats.read_timeouts
+        self.unavailables = self.stats.unavailables
+        self.other_errors = self.stats.other_errors
+        self.retries = self.stats.retries
+        self.ignores = self.stats.ignores
+        self.known_hosts = self.stats.known_hosts
+        self.connected_to = self.stats.connected_to
+        self.open_connections = self.stats.open_connections
+
+    def on_connection_error(self):
+        self.stats.connection_errors += 1
+
+    def on_write_timeout(self):
+        self.stats.write_timeouts += 1
+
+    def on_read_timeout(self):
+        self.stats.read_timeouts += 1
+
+    def on_unavailable(self):
+        self.stats.unavailables += 1
+
+    def on_other_error(self):
+        self.stats.other_errors += 1
+
+    def on_ignore(self):
+        self.stats.ignores += 1
+
+    def on_retry(self):
+        self.stats.retries += 1
+
+    def get_stats(self):
+        """
+        Returns the metrics for the registered cluster instance.
+        """
+        return scales.getStats()[self.stats_name]
+
+    def set_stats_name(self, stats_name):
+        """
+        Set the metrics stats name.
+        The stats_name is a string used to access the metris through scales: scales.getStats()[<stats_name>]
+        Default is 'cassandra-<num>'.
+        """
+
+        if self.stats_name == stats_name:
+            return
+
+        if stats_name in scales._Stats.stats:
+            raise ValueError('"{0}" already exists in stats.'.format(stats_name))
+
+        stats = scales._Stats.stats[self.stats_name]
+        del scales._Stats.stats[self.stats_name]
+        self.stats_name = stats_name
+        scales._Stats.stats[self.stats_name] = stats
diff --git a/llm/Lib/site-packages/cassandra/murmur3.py b/llm/Lib/site-packages/cassandra/murmur3.py
new file mode 100644
index 0000000000000000000000000000000000000000..6b7a883567d3e24f23613743f4ca90ffbedc58d2
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/murmur3.py
@@ -0,0 +1,114 @@
+import struct
+
+
+def body_and_tail(data):
+    l = len(data)
+    nblocks = l // 16
+    tail = l % 16
+    if nblocks:
+        # we use '<', specifying little-endian byte order for data bigger than
+        # a byte so behavior is the same on little- and big-endian platforms
+        return struct.unpack_from('<' + ('qq' * nblocks), data), struct.unpack_from('b' * tail, data, -tail), l
+    else:
+        return tuple(), struct.unpack_from('b' * tail, data, -tail), l
+
+
+def rotl64(x, r):
+    # note: not a general-purpose function because it leaves the high-order bits intact
+    # suitable for this use case without wasting cycles
+    mask = 2 ** r - 1
+    rotated = (x << r) | ((x >> 64 - r) & mask)
+    return rotated
+
+
+def fmix(k):
+    # masking off the 31s bits that would be leftover after >> 33 a 64-bit number
+    k ^= (k >> 33) & 0x7fffffff
+    k *= 0xff51afd7ed558ccd
+    k ^= (k >> 33) & 0x7fffffff
+    k *= 0xc4ceb9fe1a85ec53
+    k ^= (k >> 33) & 0x7fffffff
+    return k
+
+
+INT64_MAX = int(2 ** 63 - 1)
+INT64_MIN = -INT64_MAX - 1
+INT64_OVF_OFFSET = INT64_MAX + 1
+INT64_OVF_DIV = 2 * INT64_OVF_OFFSET
+
+
+def truncate_int64(x):
+    if not INT64_MIN <= x <= INT64_MAX:
+        x = (x + INT64_OVF_OFFSET) % INT64_OVF_DIV - INT64_OVF_OFFSET
+    return x
+
+
+def _murmur3(data):
+
+    h1 = h2 = 0
+
+    c1 = -8663945395140668459  # 0x87c37b91114253d5
+    c2 = 0x4cf5ad432745937f
+
+    body, tail, total_len = body_and_tail(data)
+
+    # body
+    for i in range(0, len(body), 2):
+        k1 = body[i]
+        k2 = body[i + 1]
+
+        k1 *= c1
+        k1 = rotl64(k1, 31)
+        k1 *= c2
+        h1 ^= k1
+
+        h1 = rotl64(h1, 27)
+        h1 += h2
+        h1 = h1 * 5 + 0x52dce729
+
+        k2 *= c2
+        k2 = rotl64(k2, 33)
+        k2 *= c1
+        h2 ^= k2
+
+        h2 = rotl64(h2, 31)
+        h2 += h1
+        h2 = h2 * 5 + 0x38495ab5
+
+    # tail
+    k1 = k2 = 0
+    len_tail = len(tail)
+    if len_tail > 8:
+        for i in range(len_tail - 1, 7, -1):
+            k2 ^= tail[i] << (i - 8) * 8
+        k2 *= c2
+        k2 = rotl64(k2, 33)
+        k2 *= c1
+        h2 ^= k2
+
+    if len_tail:
+        for i in range(min(7, len_tail - 1), -1, -1):
+            k1 ^= tail[i] << i * 8
+        k1 *= c1
+        k1 = rotl64(k1, 31)
+        k1 *= c2
+        h1 ^= k1
+
+    # finalization
+    h1 ^= total_len
+    h2 ^= total_len
+
+    h1 += h2
+    h2 += h1
+
+    h1 = fmix(h1)
+    h2 = fmix(h2)
+
+    h1 += h2
+
+    return truncate_int64(h1)
+
+try:
+    from cassandra.cmurmur3 import murmur3
+except ImportError:
+    murmur3 = _murmur3
diff --git a/llm/Lib/site-packages/cassandra/numpyFlags.h b/llm/Lib/site-packages/cassandra/numpyFlags.h
new file mode 100644
index 0000000000000000000000000000000000000000..640967e3868599332ba94dc879db8fe5368de6a7
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/numpyFlags.h
@@ -0,0 +1 @@
+#define NPY_NO_DEPRECATED_API NPY_1_7_API_VERSION
diff --git a/llm/Lib/site-packages/cassandra/numpy_parser.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/numpy_parser.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..f014544fde2e91d163f782433eee83c6bbe1f3a1
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/numpy_parser.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/numpy_parser.pyx b/llm/Lib/site-packages/cassandra/numpy_parser.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..e8f3d81687ae75ac09544e6e801776cdf55950d3
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/numpy_parser.pyx
@@ -0,0 +1,185 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+This module provides an optional protocol parser that returns
+NumPy arrays.
+
+=============================================================================
+This module should not be imported by any of the main python-driver modules,
+as numpy is an optional dependency.
+=============================================================================
+"""
+
+include "ioutils.pyx"
+
+cimport cython
+from libc.stdint cimport uint64_t, uint8_t
+from cpython.ref cimport Py_INCREF, PyObject
+
+from cassandra.bytesio cimport BytesIOReader
+from cassandra.deserializers cimport Deserializer, from_binary
+from cassandra.parsing cimport ParseDesc, ColumnParser, RowParser
+from cassandra import cqltypes
+from cassandra.util import is_little_endian
+
+import numpy as np
+
+cdef extern from "numpyFlags.h":
+    # Include 'numpyFlags.h' into the generated C code to disable the
+    # deprecated NumPy API
+    pass
+
+cdef extern from "Python.h":
+    # An integer type large enough to hold a pointer
+    ctypedef uint64_t Py_uintptr_t
+
+
+# Simple array descriptor, useful to parse rows into a NumPy array
+ctypedef struct ArrDesc:
+    Py_uintptr_t buf_ptr
+    int stride # should be large enough as we allocate contiguous arrays
+    int is_object
+    Py_uintptr_t mask_ptr
+
+arrDescDtype = np.dtype(
+    [ ('buf_ptr', np.uintp)
+    , ('stride', np.dtype('i'))
+    , ('is_object', np.dtype('i'))
+    , ('mask_ptr', np.uintp)
+    ], align=True)
+
+_cqltype_to_numpy = {
+    cqltypes.LongType:          np.dtype('>i8'),
+    cqltypes.CounterColumnType: np.dtype('>i8'),
+    cqltypes.Int32Type:         np.dtype('>i4'),
+    cqltypes.ShortType:         np.dtype('>i2'),
+    cqltypes.FloatType:         np.dtype('>f4'),
+    cqltypes.DoubleType:        np.dtype('>f8'),
+}
+
+obj_dtype = np.dtype('O')
+
+cdef uint8_t mask_true = 0x01
+
+cdef class NumpyParser(ColumnParser):
+    """Decode a ResultMessage into a bunch of NumPy arrays"""
+
+    cpdef parse_rows(self, BytesIOReader reader, ParseDesc desc):
+        cdef Py_ssize_t rowcount
+        cdef ArrDesc[::1] array_descs
+        cdef ArrDesc *arrs
+
+        rowcount = read_int(reader)
+        array_descs, arrays = make_arrays(desc, rowcount)
+        arrs = &array_descs[0]
+
+        _parse_rows(reader, desc, arrs, rowcount)
+
+        arrays = [make_native_byteorder(arr) for arr in arrays]
+        result = dict(zip(desc.colnames, arrays))
+        return result
+
+
+cdef _parse_rows(BytesIOReader reader, ParseDesc desc,
+                 ArrDesc *arrs, Py_ssize_t rowcount):
+    cdef Py_ssize_t i
+
+    for i in range(rowcount):
+        unpack_row(reader, desc, arrs)
+
+
+### Helper functions to create NumPy arrays and array descriptors
+
+def make_arrays(ParseDesc desc, array_size):
+    """
+    Allocate arrays for each result column.
+
+    returns a tuple of (array_descs, arrays), where
+        'array_descs' describe the arrays for NativeRowParser and
+        'arrays' is a dict mapping column names to arrays
+            (e.g. this can be fed into pandas.DataFrame)
+    """
+    array_descs = np.empty((desc.rowsize,), arrDescDtype)
+    arrays = []
+
+    for i, coltype in enumerate(desc.coltypes):
+        arr = make_array(coltype, array_size)
+        array_descs[i]['buf_ptr'] = arr.ctypes.data
+        array_descs[i]['stride'] = arr.strides[0]
+        array_descs[i]['is_object'] = arr.dtype is obj_dtype
+        try:
+            array_descs[i]['mask_ptr'] = arr.mask.ctypes.data
+        except AttributeError:
+            array_descs[i]['mask_ptr'] = 0
+        arrays.append(arr)
+
+    return array_descs, arrays
+
+
+def make_array(coltype, array_size):
+    """
+    Allocate a new NumPy array of the given column type and size.
+    """
+    try:
+        a = np.ma.empty((array_size,), dtype=_cqltype_to_numpy[coltype])
+        a.mask = np.zeros((array_size,), dtype=np.bool)
+    except KeyError:
+        a = np.empty((array_size,), dtype=obj_dtype)
+    return a
+
+
+#### Parse rows into NumPy arrays
+
+@cython.boundscheck(False)
+@cython.wraparound(False)
+cdef inline int unpack_row(
+        BytesIOReader reader, ParseDesc desc, ArrDesc *arrays) except -1:
+    cdef Buffer buf
+    cdef Py_ssize_t i, rowsize = desc.rowsize
+    cdef ArrDesc arr
+    cdef Deserializer deserializer
+    for i in range(rowsize):
+        get_buf(reader, &buf)
+        arr = arrays[i]
+
+        if arr.is_object:
+            deserializer = desc.deserializers[i]
+            val = from_binary(deserializer, &buf, desc.protocol_version)
+            Py_INCREF(val)
+            (<PyObject **> arr.buf_ptr)[0] = <PyObject *> val
+        elif buf.size >= 0:
+            memcpy(<char *> arr.buf_ptr, buf.ptr, buf.size)
+        else:
+            memcpy(<char *>arr.mask_ptr, &mask_true, 1)
+
+        # Update the pointer into the array for the next time
+        arrays[i].buf_ptr += arr.stride
+        arrays[i].mask_ptr += 1
+
+    return 0
+
+
+def make_native_byteorder(arr):
+    """
+    Make sure all values have a native endian in the NumPy arrays.
+    """
+    if is_little_endian and not arr.dtype.kind == 'O':
+        # We have arrays in big-endian order. First swap the bytes
+        # into little endian order, and then update the numpy dtype
+        # accordingly (e.g. from '>i8' to '<i8')
+        #
+        # Ignore any object arrays of dtype('O')
+        return arr.byteswap().newbyteorder()
+    return arr
diff --git a/llm/Lib/site-packages/cassandra/obj_parser.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/obj_parser.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..ca51c1bd4b63469103392cb04c1324d1189421d3
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/obj_parser.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/obj_parser.pyx b/llm/Lib/site-packages/cassandra/obj_parser.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..8e533b320cf8b84d83553fb8f36f4d35f84c1f46
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/obj_parser.pyx
@@ -0,0 +1,94 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+include "ioutils.pyx"
+
+from cassandra import DriverException
+from cassandra.bytesio cimport BytesIOReader
+from cassandra.deserializers cimport Deserializer, from_binary
+from cassandra.deserializers import find_deserializer
+from cassandra.parsing cimport ParseDesc, ColumnParser, RowParser
+from cassandra.tuple cimport tuple_new, tuple_set
+
+from cpython.bytes cimport PyBytes_AsStringAndSize
+
+
+cdef class ListParser(ColumnParser):
+    """Decode a ResultMessage into a list of tuples (or other objects)"""
+
+    cpdef parse_rows(self, BytesIOReader reader, ParseDesc desc):
+        cdef Py_ssize_t i, rowcount
+        rowcount = read_int(reader)
+        cdef RowParser rowparser = TupleRowParser()
+        return [rowparser.unpack_row(reader, desc) for i in range(rowcount)]
+
+
+cdef class LazyParser(ColumnParser):
+    """Decode a ResultMessage lazily using a generator"""
+
+    cpdef parse_rows(self, BytesIOReader reader, ParseDesc desc):
+        # Use a little helper function as closures (generators) are not
+        # supported in cpdef methods
+        return parse_rows_lazy(reader, desc)
+
+
+def parse_rows_lazy(BytesIOReader reader, ParseDesc desc):
+    cdef Py_ssize_t i, rowcount
+    rowcount = read_int(reader)
+    cdef RowParser rowparser = TupleRowParser()
+    return (rowparser.unpack_row(reader, desc) for i in range(rowcount))
+
+
+cdef class TupleRowParser(RowParser):
+    """
+    Parse a single returned row into a tuple of objects:
+
+        (obj1, ..., objN)
+    """
+
+    cpdef unpack_row(self, BytesIOReader reader, ParseDesc desc):
+        assert desc.rowsize >= 0
+
+        cdef Buffer buf
+        cdef Buffer newbuf
+        cdef Py_ssize_t i, rowsize = desc.rowsize
+        cdef Deserializer deserializer
+        cdef tuple res = tuple_new(desc.rowsize)
+
+        ce_policy = desc.column_encryption_policy
+        for i in range(rowsize):
+            # Read the next few bytes
+            get_buf(reader, &buf)
+
+            # Deserialize bytes to python object
+            deserializer = desc.deserializers[i]
+            coldesc = desc.coldescs[i]
+            uses_ce = ce_policy and ce_policy.contains_column(coldesc)
+            try:
+                if uses_ce:
+                    col_type = ce_policy.column_type(coldesc)
+                    decrypted_bytes = ce_policy.decrypt(coldesc, to_bytes(&buf))
+                    PyBytes_AsStringAndSize(decrypted_bytes, &newbuf.ptr, &newbuf.size)
+                    deserializer = find_deserializer(ce_policy.column_type(coldesc))
+                    val = from_binary(deserializer, &newbuf, desc.protocol_version)
+                else:
+                    val = from_binary(deserializer, &buf, desc.protocol_version)
+            except Exception as e:
+                raise DriverException('Failed decoding result column "%s" of type %s: %s' % (desc.colnames[i],
+                                                                                             desc.coltypes[i].cql_parameterized_type(),
+                                                                                             str(e)))
+            # Insert new object into tuple
+            tuple_set(res, i, val)
+
+        return res
diff --git a/llm/Lib/site-packages/cassandra/parsing.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/parsing.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..83c52c782db2c772989957d481bfd3f8269f7d81
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/parsing.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/parsing.pxd b/llm/Lib/site-packages/cassandra/parsing.pxd
new file mode 100644
index 0000000000000000000000000000000000000000..3f76060946fd66a17d9bf1a6c71cc1df87384f53
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/parsing.pxd
@@ -0,0 +1,32 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from cassandra.bytesio cimport BytesIOReader
+from cassandra.deserializers cimport Deserializer
+
+cdef class ParseDesc:
+    cdef public object colnames
+    cdef public object coltypes
+    cdef public object column_encryption_policy
+    cdef public list coldescs
+    cdef Deserializer[::1] deserializers
+    cdef public int protocol_version
+    cdef Py_ssize_t rowsize
+
+cdef class ColumnParser:
+    cpdef parse_rows(self, BytesIOReader reader, ParseDesc desc)
+
+cdef class RowParser:
+    cpdef unpack_row(self, BytesIOReader reader, ParseDesc desc)
+
diff --git a/llm/Lib/site-packages/cassandra/parsing.pyx b/llm/Lib/site-packages/cassandra/parsing.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..2e36bfa48f6e26df6e23432eed3aa62c4df2a82f
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/parsing.pyx
@@ -0,0 +1,46 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Module containing the definitions and declarations (parsing.pxd) for parsers.
+"""
+
+cdef class ParseDesc:
+    """Description of what structure to parse"""
+
+    def __init__(self, colnames, coltypes, column_encryption_policy, coldescs, deserializers, protocol_version):
+        self.colnames = colnames
+        self.coltypes = coltypes
+        self.column_encryption_policy = column_encryption_policy
+        self.coldescs = coldescs
+        self.deserializers = deserializers
+        self.protocol_version = protocol_version
+        self.rowsize = len(colnames)
+
+
+cdef class ColumnParser:
+    """Decode a ResultMessage into a set of columns"""
+
+    cpdef parse_rows(self, BytesIOReader reader, ParseDesc desc):
+        raise NotImplementedError
+
+
+cdef class RowParser:
+    """Parser for a single row"""
+
+    cpdef unpack_row(self, BytesIOReader reader, ParseDesc desc):
+        """
+        Unpack a single row of data in a ResultMessage.
+        """
+        raise NotImplementedError
diff --git a/llm/Lib/site-packages/cassandra/policies.py b/llm/Lib/site-packages/cassandra/policies.py
new file mode 100644
index 0000000000000000000000000000000000000000..724dce4469120103722b23b2d40ab68089d923df
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/policies.py
@@ -0,0 +1,1242 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from collections import namedtuple
+from functools import lru_cache
+from itertools import islice, cycle, groupby, repeat
+import logging
+from random import randint, shuffle
+from threading import Lock
+import socket
+import warnings
+
+log = logging.getLogger(__name__)
+
+from cassandra import WriteType as WT
+
+# This is done this way because WriteType was originally
+# defined here and in order not to break the API.
+# It may removed in the next mayor.
+WriteType = WT
+
+from cassandra import ConsistencyLevel, OperationTimedOut
+
+class HostDistance(object):
+    """
+    A measure of how "distant" a node is from the client, which
+    may influence how the load balancer distributes requests
+    and how many connections are opened to the node.
+    """
+
+    IGNORED = -1
+    """
+    A node with this distance should never be queried or have
+    connections opened to it.
+    """
+
+    LOCAL = 0
+    """
+    Nodes with ``LOCAL`` distance will be preferred for operations
+    under some load balancing policies (such as :class:`.DCAwareRoundRobinPolicy`)
+    and will have a greater number of connections opened against
+    them by default.
+
+    This distance is typically used for nodes within the same
+    datacenter as the client.
+    """
+
+    REMOTE = 1
+    """
+    Nodes with ``REMOTE`` distance will be treated as a last resort
+    by some load balancing policies (such as :class:`.DCAwareRoundRobinPolicy`)
+    and will have a smaller number of connections opened against
+    them by default.
+
+    This distance is typically used for nodes outside of the
+    datacenter that the client is running in.
+    """
+
+
+class HostStateListener(object):
+
+    def on_up(self, host):
+        """ Called when a node is marked up. """
+        raise NotImplementedError()
+
+    def on_down(self, host):
+        """ Called when a node is marked down. """
+        raise NotImplementedError()
+
+    def on_add(self, host):
+        """
+        Called when a node is added to the cluster.  The newly added node
+        should be considered up.
+        """
+        raise NotImplementedError()
+
+    def on_remove(self, host):
+        """ Called when a node is removed from the cluster. """
+        raise NotImplementedError()
+
+
+class LoadBalancingPolicy(HostStateListener):
+    """
+    Load balancing policies are used to decide how to distribute
+    requests among all possible coordinator nodes in the cluster.
+
+    In particular, they may focus on querying "near" nodes (those
+    in a local datacenter) or on querying nodes who happen to
+    be replicas for the requested data.
+
+    You may also use subclasses of :class:`.LoadBalancingPolicy` for
+    custom behavior.
+    """
+
+    _hosts_lock = None
+
+    def __init__(self):
+        self._hosts_lock = Lock()
+
+    def distance(self, host):
+        """
+        Returns a measure of how remote a :class:`~.pool.Host` is in
+        terms of the :class:`.HostDistance` enums.
+        """
+        raise NotImplementedError()
+
+    def populate(self, cluster, hosts):
+        """
+        This method is called to initialize the load balancing
+        policy with a set of :class:`.Host` instances before its
+        first use.  The `cluster` parameter is an instance of
+        :class:`.Cluster`.
+        """
+        raise NotImplementedError()
+
+    def make_query_plan(self, working_keyspace=None, query=None):
+        """
+        Given a :class:`~.query.Statement` instance, return a iterable
+        of :class:`.Host` instances which should be queried in that
+        order.  A generator may work well for custom implementations
+        of this method.
+
+        Note that the `query` argument may be :const:`None` when preparing
+        statements.
+
+        `working_keyspace` should be the string name of the current keyspace,
+        as set through :meth:`.Session.set_keyspace()` or with a ``USE``
+        statement.
+        """
+        raise NotImplementedError()
+
+    def check_supported(self):
+        """
+        This will be called after the cluster Metadata has been initialized.
+        If the load balancing policy implementation cannot be supported for
+        some reason (such as a missing C extension), this is the point at
+        which it should raise an exception.
+        """
+        pass
+
+
+class RoundRobinPolicy(LoadBalancingPolicy):
+    """
+    A subclass of :class:`.LoadBalancingPolicy` which evenly
+    distributes queries across all nodes in the cluster,
+    regardless of what datacenter the nodes may be in.
+    """
+    _live_hosts = frozenset(())
+    _position = 0
+
+    def populate(self, cluster, hosts):
+        self._live_hosts = frozenset(hosts)
+        if len(hosts) > 1:
+            self._position = randint(0, len(hosts) - 1)
+
+    def distance(self, host):
+        return HostDistance.LOCAL
+
+    def make_query_plan(self, working_keyspace=None, query=None):
+        # not thread-safe, but we don't care much about lost increments
+        # for the purposes of load balancing
+        pos = self._position
+        self._position += 1
+
+        hosts = self._live_hosts
+        length = len(hosts)
+        if length:
+            pos %= length
+            return islice(cycle(hosts), pos, pos + length)
+        else:
+            return []
+
+    def on_up(self, host):
+        with self._hosts_lock:
+            self._live_hosts = self._live_hosts.union((host, ))
+
+    def on_down(self, host):
+        with self._hosts_lock:
+            self._live_hosts = self._live_hosts.difference((host, ))
+
+    def on_add(self, host):
+        with self._hosts_lock:
+            self._live_hosts = self._live_hosts.union((host, ))
+
+    def on_remove(self, host):
+        with self._hosts_lock:
+            self._live_hosts = self._live_hosts.difference((host, ))
+
+
+class DCAwareRoundRobinPolicy(LoadBalancingPolicy):
+    """
+    Similar to :class:`.RoundRobinPolicy`, but prefers hosts
+    in the local datacenter and only uses nodes in remote
+    datacenters as a last resort.
+    """
+
+    local_dc = None
+    used_hosts_per_remote_dc = 0
+
+    def __init__(self, local_dc='', used_hosts_per_remote_dc=0):
+        """
+        The `local_dc` parameter should be the name of the datacenter
+        (such as is reported by ``nodetool ring``) that should
+        be considered local. If not specified, the driver will choose
+        a local_dc based on the first host among :attr:`.Cluster.contact_points`
+        having a valid DC. If relying on this mechanism, all specified
+        contact points should be nodes in a single, local DC.
+
+        `used_hosts_per_remote_dc` controls how many nodes in
+        each remote datacenter will have connections opened
+        against them. In other words, `used_hosts_per_remote_dc` hosts
+        will be considered :attr:`~.HostDistance.REMOTE` and the
+        rest will be considered :attr:`~.HostDistance.IGNORED`.
+        By default, all remote hosts are ignored.
+        """
+        self.local_dc = local_dc
+        self.used_hosts_per_remote_dc = used_hosts_per_remote_dc
+        self._dc_live_hosts = {}
+        self._position = 0
+        self._endpoints = []
+        LoadBalancingPolicy.__init__(self)
+
+    def _dc(self, host):
+        return host.datacenter or self.local_dc
+
+    def populate(self, cluster, hosts):
+        for dc, dc_hosts in groupby(hosts, lambda h: self._dc(h)):
+            self._dc_live_hosts[dc] = tuple(set(dc_hosts))
+
+        if not self.local_dc:
+            self._endpoints = [
+                endpoint
+                for endpoint in cluster.endpoints_resolved]
+
+        self._position = randint(0, len(hosts) - 1) if hosts else 0
+
+    def distance(self, host):
+        dc = self._dc(host)
+        if dc == self.local_dc:
+            return HostDistance.LOCAL
+
+        if not self.used_hosts_per_remote_dc:
+            return HostDistance.IGNORED
+        else:
+            dc_hosts = self._dc_live_hosts.get(dc)
+            if not dc_hosts:
+                return HostDistance.IGNORED
+
+            if host in list(dc_hosts)[:self.used_hosts_per_remote_dc]:
+                return HostDistance.REMOTE
+            else:
+                return HostDistance.IGNORED
+
+    def make_query_plan(self, working_keyspace=None, query=None):
+        # not thread-safe, but we don't care much about lost increments
+        # for the purposes of load balancing
+        pos = self._position
+        self._position += 1
+
+        local_live = self._dc_live_hosts.get(self.local_dc, ())
+        pos = (pos % len(local_live)) if local_live else 0
+        for host in islice(cycle(local_live), pos, pos + len(local_live)):
+            yield host
+
+        # the dict can change, so get candidate DCs iterating over keys of a copy
+        other_dcs = [dc for dc in self._dc_live_hosts.copy().keys() if dc != self.local_dc]
+        for dc in other_dcs:
+            remote_live = self._dc_live_hosts.get(dc, ())
+            for host in remote_live[:self.used_hosts_per_remote_dc]:
+                yield host
+
+    def on_up(self, host):
+        # not worrying about threads because this will happen during
+        # control connection startup/refresh
+        if not self.local_dc and host.datacenter:
+            if host.endpoint in self._endpoints:
+                self.local_dc = host.datacenter
+                log.info("Using datacenter '%s' for DCAwareRoundRobinPolicy (via host '%s'); "
+                         "if incorrect, please specify a local_dc to the constructor, "
+                         "or limit contact points to local cluster nodes" %
+                         (self.local_dc, host.endpoint))
+                del self._endpoints
+
+        dc = self._dc(host)
+        with self._hosts_lock:
+            current_hosts = self._dc_live_hosts.get(dc, ())
+            if host not in current_hosts:
+                self._dc_live_hosts[dc] = current_hosts + (host, )
+
+    def on_down(self, host):
+        dc = self._dc(host)
+        with self._hosts_lock:
+            current_hosts = self._dc_live_hosts.get(dc, ())
+            if host in current_hosts:
+                hosts = tuple(h for h in current_hosts if h != host)
+                if hosts:
+                    self._dc_live_hosts[dc] = hosts
+                else:
+                    del self._dc_live_hosts[dc]
+
+    def on_add(self, host):
+        self.on_up(host)
+
+    def on_remove(self, host):
+        self.on_down(host)
+
+
+class TokenAwarePolicy(LoadBalancingPolicy):
+    """
+    A :class:`.LoadBalancingPolicy` wrapper that adds token awareness to
+    a child policy.
+
+    This alters the child policy's behavior so that it first attempts to
+    send queries to :attr:`~.HostDistance.LOCAL` replicas (as determined
+    by the child policy) based on the :class:`.Statement`'s
+    :attr:`~.Statement.routing_key`. If :attr:`.shuffle_replicas` is
+    truthy, these replicas will be yielded in a random order. Once those
+    hosts are exhausted, the remaining hosts in the child policy's query
+    plan will be used in the order provided by the child policy.
+
+    If no :attr:`~.Statement.routing_key` is set on the query, the child
+    policy's query plan will be used as is.
+    """
+
+    _child_policy = None
+    _cluster_metadata = None
+    shuffle_replicas = False
+    """
+    Yield local replicas in a random order.
+    """
+
+    def __init__(self, child_policy, shuffle_replicas=False):
+        self._child_policy = child_policy
+        self.shuffle_replicas = shuffle_replicas
+
+    def populate(self, cluster, hosts):
+        self._cluster_metadata = cluster.metadata
+        self._child_policy.populate(cluster, hosts)
+
+    def check_supported(self):
+        if not self._cluster_metadata.can_support_partitioner():
+            raise RuntimeError(
+                '%s cannot be used with the cluster partitioner (%s) because '
+                'the relevant C extension for this driver was not compiled. '
+                'See the installation instructions for details on building '
+                'and installing the C extensions.' %
+                (self.__class__.__name__, self._cluster_metadata.partitioner))
+
+    def distance(self, *args, **kwargs):
+        return self._child_policy.distance(*args, **kwargs)
+
+    def make_query_plan(self, working_keyspace=None, query=None):
+        if query and query.keyspace:
+            keyspace = query.keyspace
+        else:
+            keyspace = working_keyspace
+
+        child = self._child_policy
+        if query is None:
+            for host in child.make_query_plan(keyspace, query):
+                yield host
+        else:
+            routing_key = query.routing_key
+            if routing_key is None or keyspace is None:
+                for host in child.make_query_plan(keyspace, query):
+                    yield host
+            else:
+                replicas = self._cluster_metadata.get_replicas(keyspace, routing_key)
+                if self.shuffle_replicas:
+                    shuffle(replicas)
+                for replica in replicas:
+                    if replica.is_up and \
+                            child.distance(replica) == HostDistance.LOCAL:
+                        yield replica
+
+                for host in child.make_query_plan(keyspace, query):
+                    # skip if we've already listed this host
+                    if host not in replicas or \
+                            child.distance(host) == HostDistance.REMOTE:
+                        yield host
+
+    def on_up(self, *args, **kwargs):
+        return self._child_policy.on_up(*args, **kwargs)
+
+    def on_down(self, *args, **kwargs):
+        return self._child_policy.on_down(*args, **kwargs)
+
+    def on_add(self, *args, **kwargs):
+        return self._child_policy.on_add(*args, **kwargs)
+
+    def on_remove(self, *args, **kwargs):
+        return self._child_policy.on_remove(*args, **kwargs)
+
+
+class WhiteListRoundRobinPolicy(RoundRobinPolicy):
+    """
+    A subclass of :class:`.RoundRobinPolicy` which evenly
+    distributes queries across all nodes in the cluster,
+    regardless of what datacenter the nodes may be in, but
+    only if that node exists in the list of allowed nodes
+
+    This policy is addresses the issue described in
+    https://datastax-oss.atlassian.net/browse/JAVA-145
+    Where connection errors occur when connection
+    attempts are made to private IP addresses remotely
+    """
+
+    def __init__(self, hosts):
+        """
+        The `hosts` parameter should be a sequence of hosts to permit
+        connections to.
+        """
+        self._allowed_hosts = tuple(hosts)
+        self._allowed_hosts_resolved = [endpoint[4][0] for a in self._allowed_hosts
+                                        for endpoint in socket.getaddrinfo(a, None, socket.AF_UNSPEC, socket.SOCK_STREAM)]
+
+        RoundRobinPolicy.__init__(self)
+
+    def populate(self, cluster, hosts):
+        self._live_hosts = frozenset(h for h in hosts if h.address in self._allowed_hosts_resolved)
+
+        if len(hosts) <= 1:
+            self._position = 0
+        else:
+            self._position = randint(0, len(hosts) - 1)
+
+    def distance(self, host):
+        if host.address in self._allowed_hosts_resolved:
+            return HostDistance.LOCAL
+        else:
+            return HostDistance.IGNORED
+
+    def on_up(self, host):
+        if host.address in self._allowed_hosts_resolved:
+            RoundRobinPolicy.on_up(self, host)
+
+    def on_add(self, host):
+        if host.address in self._allowed_hosts_resolved:
+            RoundRobinPolicy.on_add(self, host)
+
+
+class HostFilterPolicy(LoadBalancingPolicy):
+    """
+    A :class:`.LoadBalancingPolicy` subclass configured with a child policy,
+    and a single-argument predicate. This policy defers to the child policy for
+    hosts where ``predicate(host)`` is truthy. Hosts for which
+    ``predicate(host)`` is falsy will be considered :attr:`.IGNORED`, and will
+    not be used in a query plan.
+
+    This can be used in the cases where you need a whitelist or blacklist
+    policy, e.g. to prepare for decommissioning nodes or for testing:
+
+    .. code-block:: python
+
+        def address_is_ignored(host):
+            return host.address in [ignored_address0, ignored_address1]
+
+        blacklist_filter_policy = HostFilterPolicy(
+            child_policy=RoundRobinPolicy(),
+            predicate=address_is_ignored
+        )
+
+        cluster = Cluster(
+            primary_host,
+            load_balancing_policy=blacklist_filter_policy,
+        )
+
+    See the note in the :meth:`.make_query_plan` documentation for a caveat on
+    how wrapping ordering polices (e.g. :class:`.RoundRobinPolicy`) may break
+    desirable properties of the wrapped policy.
+
+    Please note that whitelist and blacklist policies are not recommended for
+    general, day-to-day use. You probably want something like
+    :class:`.DCAwareRoundRobinPolicy`, which prefers a local DC but has
+    fallbacks, over a brute-force method like whitelisting or blacklisting.
+    """
+
+    def __init__(self, child_policy, predicate):
+        """
+        :param child_policy: an instantiated :class:`.LoadBalancingPolicy`
+                             that this one will defer to.
+        :param predicate: a one-parameter function that takes a :class:`.Host`.
+                          If it returns a falsy value, the :class:`.Host` will
+                          be :attr:`.IGNORED` and not returned in query plans.
+        """
+        super(HostFilterPolicy, self).__init__()
+        self._child_policy = child_policy
+        self._predicate = predicate
+
+    def on_up(self, host, *args, **kwargs):
+        return self._child_policy.on_up(host, *args, **kwargs)
+
+    def on_down(self, host, *args, **kwargs):
+        return self._child_policy.on_down(host, *args, **kwargs)
+
+    def on_add(self, host, *args, **kwargs):
+        return self._child_policy.on_add(host, *args, **kwargs)
+
+    def on_remove(self, host, *args, **kwargs):
+        return self._child_policy.on_remove(host, *args, **kwargs)
+
+    @property
+    def predicate(self):
+        """
+        A predicate, set on object initialization, that takes a :class:`.Host`
+        and returns a value. If the value is falsy, the :class:`.Host` is
+        :class:`~HostDistance.IGNORED`. If the value is truthy,
+        :class:`.HostFilterPolicy` defers to the child policy to determine the
+        host's distance.
+
+        This is a read-only value set in ``__init__``, implemented as a
+        ``property``.
+        """
+        return self._predicate
+
+    def distance(self, host):
+        """
+        Checks if ``predicate(host)``, then returns
+        :attr:`~HostDistance.IGNORED` if falsy, and defers to the child policy
+        otherwise.
+        """
+        if self.predicate(host):
+            return self._child_policy.distance(host)
+        else:
+            return HostDistance.IGNORED
+
+    def populate(self, cluster, hosts):
+        self._child_policy.populate(cluster=cluster, hosts=hosts)
+
+    def make_query_plan(self, working_keyspace=None, query=None):
+        """
+        Defers to the child policy's
+        :meth:`.LoadBalancingPolicy.make_query_plan` and filters the results.
+
+        Note that this filtering may break desirable properties of the wrapped
+        policy in some cases. For instance, imagine if you configure this
+        policy to filter out ``host2``, and to wrap a round-robin policy that
+        rotates through three hosts in the order ``host1, host2, host3``,
+        ``host2, host3, host1``, ``host3, host1, host2``, repeating. This
+        policy will yield ``host1, host3``, ``host3, host1``, ``host3, host1``,
+        disproportionately favoring ``host3``.
+        """
+        child_qp = self._child_policy.make_query_plan(
+            working_keyspace=working_keyspace, query=query
+        )
+        for host in child_qp:
+            if self.predicate(host):
+                yield host
+
+    def check_supported(self):
+        return self._child_policy.check_supported()
+
+
+class ConvictionPolicy(object):
+    """
+    A policy which decides when hosts should be considered down
+    based on the types of failures and the number of failures.
+
+    If custom behavior is needed, this class may be subclassed.
+    """
+
+    def __init__(self, host):
+        """
+        `host` is an instance of :class:`.Host`.
+        """
+        self.host = host
+
+    def add_failure(self, connection_exc):
+        """
+        Implementations should return :const:`True` if the host should be
+        convicted, :const:`False` otherwise.
+        """
+        raise NotImplementedError()
+
+    def reset(self):
+        """
+        Implementations should clear out any convictions or state regarding
+        the host.
+        """
+        raise NotImplementedError()
+
+
+class SimpleConvictionPolicy(ConvictionPolicy):
+    """
+    The default implementation of :class:`ConvictionPolicy`,
+    which simply marks a host as down after the first failure
+    of any kind.
+    """
+
+    def add_failure(self, connection_exc):
+        return not isinstance(connection_exc, OperationTimedOut)
+
+    def reset(self):
+        pass
+
+
+class ReconnectionPolicy(object):
+    """
+    This class and its subclasses govern how frequently an attempt is made
+    to reconnect to nodes that are marked as dead.
+
+    If custom behavior is needed, this class may be subclassed.
+    """
+
+    def new_schedule(self):
+        """
+        This should return a finite or infinite iterable of delays (each as a
+        floating point number of seconds) in-between each failed reconnection
+        attempt.  Note that if the iterable is finite, reconnection attempts
+        will cease once the iterable is exhausted.
+        """
+        raise NotImplementedError()
+
+
+class ConstantReconnectionPolicy(ReconnectionPolicy):
+    """
+    A :class:`.ReconnectionPolicy` subclass which sleeps for a fixed delay
+    in-between each reconnection attempt.
+    """
+
+    def __init__(self, delay, max_attempts=64):
+        """
+        `delay` should be a floating point number of seconds to wait in-between
+        each attempt.
+
+        `max_attempts` should be a total number of attempts to be made before
+        giving up, or :const:`None` to continue reconnection attempts forever.
+        The default is 64.
+        """
+        if delay < 0:
+            raise ValueError("delay must not be negative")
+        if max_attempts is not None and max_attempts < 0:
+            raise ValueError("max_attempts must not be negative")
+
+        self.delay = delay
+        self.max_attempts = max_attempts
+
+    def new_schedule(self):
+        if self.max_attempts:
+            return repeat(self.delay, self.max_attempts)
+        return repeat(self.delay)
+
+
+class ExponentialReconnectionPolicy(ReconnectionPolicy):
+    """
+    A :class:`.ReconnectionPolicy` subclass which exponentially increases
+    the length of the delay in-between each reconnection attempt up to
+    a set maximum delay.
+
+    A random amount of jitter (+/- 15%) will be added to the pure exponential
+    delay value to avoid the situations where many reconnection handlers are
+    trying to reconnect at exactly the same time.
+    """
+
+    # TODO: max_attempts is 64 to preserve legacy default behavior
+    # consider changing to None in major release to prevent the policy
+    # giving up forever
+    def __init__(self, base_delay, max_delay, max_attempts=64):
+        """
+        `base_delay` and `max_delay` should be in floating point units of
+        seconds.
+
+        `max_attempts` should be a total number of attempts to be made before
+        giving up, or :const:`None` to continue reconnection attempts forever.
+        The default is 64.
+        """
+        if base_delay < 0 or max_delay < 0:
+            raise ValueError("Delays may not be negative")
+
+        if max_delay < base_delay:
+            raise ValueError("Max delay must be greater than base delay")
+
+        if max_attempts is not None and max_attempts < 0:
+            raise ValueError("max_attempts must not be negative")
+
+        self.base_delay = base_delay
+        self.max_delay = max_delay
+        self.max_attempts = max_attempts
+
+    def new_schedule(self):
+        i, overflowed = 0, False
+        while self.max_attempts is None or i < self.max_attempts:
+            if overflowed:
+                yield self.max_delay
+            else:
+                try:
+                    yield self._add_jitter(min(self.base_delay * (2 ** i), self.max_delay))
+                except OverflowError:
+                    overflowed = True
+                    yield self.max_delay
+
+            i += 1
+
+    # Adds -+ 15% to the delay provided
+    def _add_jitter(self, value):
+        jitter = randint(85, 115)
+        delay = (jitter * value) / 100
+        return min(max(self.base_delay, delay), self.max_delay)
+
+
+class RetryPolicy(object):
+    """
+    A policy that describes whether to retry, rethrow, or ignore coordinator
+    timeout and unavailable failures. These are failures reported from the
+    server side. Timeouts are configured by
+    `settings in cassandra.yaml <https://github.com/apache/cassandra/blob/cassandra-2.1.4/conf/cassandra.yaml#L568-L584>`_.
+    Unavailable failures occur when the coordinator cannot achieve the consistency
+    level for a request. For further information see the method descriptions
+    below.
+
+    To specify a default retry policy, set the
+    :attr:`.Cluster.default_retry_policy` attribute to an instance of this
+    class or one of its subclasses.
+
+    To specify a retry policy per query, set the :attr:`.Statement.retry_policy`
+    attribute to an instance of this class or one of its subclasses.
+
+    If custom behavior is needed for retrying certain operations,
+    this class may be subclassed.
+    """
+
+    RETRY = 0
+    """
+    This should be returned from the below methods if the operation
+    should be retried on the same connection.
+    """
+
+    RETHROW = 1
+    """
+    This should be returned from the below methods if the failure
+    should be propagated and no more retries attempted.
+    """
+
+    IGNORE = 2
+    """
+    This should be returned from the below methods if the failure
+    should be ignored but no more retries should be attempted.
+    """
+
+    RETRY_NEXT_HOST = 3
+    """
+    This should be returned from the below methods if the operation
+    should be retried on another connection.
+    """
+
+    def on_read_timeout(self, query, consistency, required_responses,
+                        received_responses, data_retrieved, retry_num):
+        """
+        This is called when a read operation times out from the coordinator's
+        perspective (i.e. a replica did not respond to the coordinator in time).
+        It should return a tuple with two items: one of the class enums (such
+        as :attr:`.RETRY`) and a :class:`.ConsistencyLevel` to retry the
+        operation at or :const:`None` to keep the same consistency level.
+
+        `query` is the :class:`.Statement` that timed out.
+
+        `consistency` is the :class:`.ConsistencyLevel` that the operation was
+        attempted at.
+
+        The `required_responses` and `received_responses` parameters describe
+        how many replicas needed to respond to meet the requested consistency
+        level and how many actually did respond before the coordinator timed
+        out the request. `data_retrieved` is a boolean indicating whether
+        any of those responses contained data (as opposed to just a digest).
+
+        `retry_num` counts how many times the operation has been retried, so
+        the first time this method is called, `retry_num` will be 0.
+
+        By default, operations will be retried at most once, and only if
+        a sufficient number of replicas responded (with data digests).
+        """
+        if retry_num != 0:
+            return self.RETHROW, None
+        elif received_responses >= required_responses and not data_retrieved:
+            return self.RETRY, consistency
+        else:
+            return self.RETHROW, None
+
+    def on_write_timeout(self, query, consistency, write_type,
+                         required_responses, received_responses, retry_num):
+        """
+        This is called when a write operation times out from the coordinator's
+        perspective (i.e. a replica did not respond to the coordinator in time).
+
+        `query` is the :class:`.Statement` that timed out.
+
+        `consistency` is the :class:`.ConsistencyLevel` that the operation was
+        attempted at.
+
+        `write_type` is one of the :class:`.WriteType` enums describing the
+        type of write operation.
+
+        The `required_responses` and `received_responses` parameters describe
+        how many replicas needed to acknowledge the write to meet the requested
+        consistency level and how many replicas actually did acknowledge the
+        write before the coordinator timed out the request.
+
+        `retry_num` counts how many times the operation has been retried, so
+        the first time this method is called, `retry_num` will be 0.
+
+        By default, failed write operations will retried at most once, and
+        they will only be retried if the `write_type` was
+        :attr:`~.WriteType.BATCH_LOG`.
+        """
+        if retry_num != 0:
+            return self.RETHROW, None
+        elif write_type == WriteType.BATCH_LOG:
+            return self.RETRY, consistency
+        else:
+            return self.RETHROW, None
+
+    def on_unavailable(self, query, consistency, required_replicas, alive_replicas, retry_num):
+        """
+        This is called when the coordinator node determines that a read or
+        write operation cannot be successful because the number of live
+        replicas are too low to meet the requested :class:`.ConsistencyLevel`.
+        This means that the read or write operation was never forwarded to
+        any replicas.
+
+        `query` is the :class:`.Statement` that failed.
+
+        `consistency` is the :class:`.ConsistencyLevel` that the operation was
+        attempted at.
+
+        `required_replicas` is the number of replicas that would have needed to
+        acknowledge the operation to meet the requested consistency level.
+        `alive_replicas` is the number of replicas that the coordinator
+        considered alive at the time of the request.
+
+        `retry_num` counts how many times the operation has been retried, so
+        the first time this method is called, `retry_num` will be 0.
+
+        By default, if this is the first retry, it triggers a retry on the next
+        host in the query plan with the same consistency level. If this is not the
+        first retry, no retries will be attempted and the error will be re-raised.
+        """
+        return (self.RETRY_NEXT_HOST, None) if retry_num == 0 else (self.RETHROW, None)
+
+    def on_request_error(self, query, consistency, error, retry_num):
+        """
+        This is called when an unexpected error happens. This can be in the
+        following situations:
+
+        * On a connection error
+        * On server errors: overloaded, isBootstrapping, serverError, etc.
+
+        `query` is the :class:`.Statement` that timed out.
+
+        `consistency` is the :class:`.ConsistencyLevel` that the operation was
+        attempted at.
+
+        `error` the instance of the exception.
+
+        `retry_num` counts how many times the operation has been retried, so
+        the first time this method is called, `retry_num` will be 0.
+
+        By default, it triggers a retry on the next host in the query plan
+        with the same consistency level.
+        """
+        # TODO revisit this for the next major
+        # To preserve the same behavior than before, we don't take retry_num into account
+        return self.RETRY_NEXT_HOST, None
+
+
+class FallthroughRetryPolicy(RetryPolicy):
+    """
+    A retry policy that never retries and always propagates failures to
+    the application.
+    """
+
+    def on_read_timeout(self, *args, **kwargs):
+        return self.RETHROW, None
+
+    def on_write_timeout(self, *args, **kwargs):
+        return self.RETHROW, None
+
+    def on_unavailable(self, *args, **kwargs):
+        return self.RETHROW, None
+
+    def on_request_error(self, *args, **kwargs):
+        return self.RETHROW, None
+
+
+class DowngradingConsistencyRetryPolicy(RetryPolicy):
+    """
+    *Deprecated:* This retry policy will be removed in the next major release.
+
+    A retry policy that sometimes retries with a lower consistency level than
+    the one initially requested.
+
+    **BEWARE**: This policy may retry queries using a lower consistency
+    level than the one initially requested. By doing so, it may break
+    consistency guarantees. In other words, if you use this retry policy,
+    there are cases (documented below) where a read at :attr:`~.QUORUM`
+    *may not* see a preceding write at :attr:`~.QUORUM`. Do not use this
+    policy unless you have understood the cases where this can happen and
+    are ok with that. It is also recommended to subclass this class so
+    that queries that required a consistency level downgrade can be
+    recorded (so that repairs can be made later, etc).
+
+    This policy implements the same retries as :class:`.RetryPolicy`,
+    but on top of that, it also retries in the following cases:
+
+    * On a read timeout: if the number of replicas that responded is
+      greater than one but lower than is required by the requested
+      consistency level, the operation is retried at a lower consistency
+      level.
+    * On a write timeout: if the operation is an :attr:`~.UNLOGGED_BATCH`
+      and at least one replica acknowledged the write, the operation is
+      retried at a lower consistency level.  Furthermore, for other
+      write types, if at least one replica acknowledged the write, the
+      timeout is ignored.
+    * On an unavailable exception: if at least one replica is alive, the
+      operation is retried at a lower consistency level.
+
+    The reasoning behind this retry policy is as follows: if, based
+    on the information the Cassandra coordinator node returns, retrying the
+    operation with the initially requested consistency has a chance to
+    succeed, do it. Otherwise, if based on that information we know the
+    initially requested consistency level cannot be achieved currently, then:
+
+    * For writes, ignore the exception (thus silently failing the
+      consistency requirement) if we know the write has been persisted on at
+      least one replica.
+    * For reads, try reading at a lower consistency level (thus silently
+      failing the consistency requirement).
+
+    In other words, this policy implements the idea that if the requested
+    consistency level cannot be achieved, the next best thing for writes is
+    to make sure the data is persisted, and that reading something is better
+    than reading nothing, even if there is a risk of reading stale data.
+    """
+    def __init__(self, *args, **kwargs):
+        super(DowngradingConsistencyRetryPolicy, self).__init__(*args, **kwargs)
+        warnings.warn('DowngradingConsistencyRetryPolicy is deprecated '
+                      'and will be removed in the next major release.',
+                      DeprecationWarning)
+
+    def _pick_consistency(self, num_responses):
+        if num_responses >= 3:
+            return self.RETRY, ConsistencyLevel.THREE
+        elif num_responses >= 2:
+            return self.RETRY, ConsistencyLevel.TWO
+        elif num_responses >= 1:
+            return self.RETRY, ConsistencyLevel.ONE
+        else:
+            return self.RETHROW, None
+
+    def on_read_timeout(self, query, consistency, required_responses,
+                        received_responses, data_retrieved, retry_num):
+        if retry_num != 0:
+            return self.RETHROW, None
+        elif ConsistencyLevel.is_serial(consistency):
+            # Downgrading does not make sense for a CAS read query
+            return self.RETHROW, None
+        elif received_responses < required_responses:
+            return self._pick_consistency(received_responses)
+        elif not data_retrieved:
+            return self.RETRY, consistency
+        else:
+            return self.RETHROW, None
+
+    def on_write_timeout(self, query, consistency, write_type,
+                         required_responses, received_responses, retry_num):
+        if retry_num != 0:
+            return self.RETHROW, None
+
+        if write_type in (WriteType.SIMPLE, WriteType.BATCH, WriteType.COUNTER):
+            if received_responses > 0:
+                # persisted on at least one replica
+                return self.IGNORE, None
+            else:
+                return self.RETHROW, None
+        elif write_type == WriteType.UNLOGGED_BATCH:
+            return self._pick_consistency(received_responses)
+        elif write_type == WriteType.BATCH_LOG:
+            return self.RETRY, consistency
+
+        return self.RETHROW, None
+
+    def on_unavailable(self, query, consistency, required_replicas, alive_replicas, retry_num):
+        if retry_num != 0:
+            return self.RETHROW, None
+        elif ConsistencyLevel.is_serial(consistency):
+            # failed at the paxos phase of a LWT, retry on the next host
+            return self.RETRY_NEXT_HOST, None
+        else:
+            return self._pick_consistency(alive_replicas)
+
+
+class AddressTranslator(object):
+    """
+    Interface for translating cluster-defined endpoints.
+
+    The driver discovers nodes using server metadata and topology change events. Normally,
+    the endpoint defined by the server is the right way to connect to a node. In some environments,
+    these addresses may not be reachable, or not preferred (public vs. private IPs in cloud environments,
+    suboptimal routing, etc). This interface allows for translating from server defined endpoints to
+    preferred addresses for driver connections.
+
+    *Note:* :attr:`~Cluster.contact_points` provided while creating the :class:`~.Cluster` instance are not
+    translated using this mechanism -- only addresses received from Cassandra nodes are.
+    """
+    def translate(self, addr):
+        """
+        Accepts the node ip address, and returns a translated address to be used connecting to this node.
+        """
+        raise NotImplementedError()
+
+
+class IdentityTranslator(AddressTranslator):
+    """
+    Returns the endpoint with no translation
+    """
+    def translate(self, addr):
+        return addr
+
+
+class EC2MultiRegionTranslator(AddressTranslator):
+    """
+    Resolves private ips of the hosts in the same datacenter as the client, and public ips of hosts in other datacenters.
+    """
+    def translate(self, addr):
+        """
+        Reverse DNS the public broadcast_address, then lookup that hostname to get the AWS-resolved IP, which
+        will point to the private IP address within the same datacenter.
+        """
+        # get family of this address so we translate to the same
+        family = socket.getaddrinfo(addr, 0, socket.AF_UNSPEC, socket.SOCK_STREAM)[0][0]
+        host = socket.getfqdn(addr)
+        for a in socket.getaddrinfo(host, 0, family, socket.SOCK_STREAM):
+            try:
+                return a[4][0]
+            except Exception:
+                pass
+        return addr
+
+
+class SpeculativeExecutionPolicy(object):
+    """
+    Interface for specifying speculative execution plans
+    """
+
+    def new_plan(self, keyspace, statement):
+        """
+        Returns
+
+        :param keyspace:
+        :param statement:
+        :return:
+        """
+        raise NotImplementedError()
+
+
+class SpeculativeExecutionPlan(object):
+    def next_execution(self, host):
+        raise NotImplementedError()
+
+
+class NoSpeculativeExecutionPlan(SpeculativeExecutionPlan):
+    def next_execution(self, host):
+        return -1
+
+
+class NoSpeculativeExecutionPolicy(SpeculativeExecutionPolicy):
+
+    def new_plan(self, keyspace, statement):
+        return NoSpeculativeExecutionPlan()
+
+
+class ConstantSpeculativeExecutionPolicy(SpeculativeExecutionPolicy):
+    """
+    A speculative execution policy that sends a new query every X seconds (**delay**) for a maximum of Y attempts (**max_attempts**).
+    """
+
+    def __init__(self, delay, max_attempts):
+        self.delay = delay
+        self.max_attempts = max_attempts
+
+    class ConstantSpeculativeExecutionPlan(SpeculativeExecutionPlan):
+        def __init__(self, delay, max_attempts):
+            self.delay = delay
+            self.remaining = max_attempts
+
+        def next_execution(self, host):
+            if self.remaining > 0:
+                self.remaining -= 1
+                return self.delay
+            else:
+                return -1
+
+    def new_plan(self, keyspace, statement):
+        return self.ConstantSpeculativeExecutionPlan(self.delay, self.max_attempts)
+
+
+class WrapperPolicy(LoadBalancingPolicy):
+
+    def __init__(self, child_policy):
+        self._child_policy = child_policy
+
+    def distance(self, *args, **kwargs):
+        return self._child_policy.distance(*args, **kwargs)
+
+    def populate(self, cluster, hosts):
+        self._child_policy.populate(cluster, hosts)
+
+    def on_up(self, *args, **kwargs):
+        return self._child_policy.on_up(*args, **kwargs)
+
+    def on_down(self, *args, **kwargs):
+        return self._child_policy.on_down(*args, **kwargs)
+
+    def on_add(self, *args, **kwargs):
+        return self._child_policy.on_add(*args, **kwargs)
+
+    def on_remove(self, *args, **kwargs):
+        return self._child_policy.on_remove(*args, **kwargs)
+
+
+class DefaultLoadBalancingPolicy(WrapperPolicy):
+    """
+    A :class:`.LoadBalancingPolicy` wrapper that adds the ability to target a specific host first.
+
+    If no host is set on the query, the child policy's query plan will be used as is.
+    """
+
+    _cluster_metadata = None
+
+    def populate(self, cluster, hosts):
+        self._cluster_metadata = cluster.metadata
+        self._child_policy.populate(cluster, hosts)
+
+    def make_query_plan(self, working_keyspace=None, query=None):
+        if query and query.keyspace:
+            keyspace = query.keyspace
+        else:
+            keyspace = working_keyspace
+
+        # TODO remove next major since execute(..., host=XXX) is now available
+        addr = getattr(query, 'target_host', None) if query else None
+        target_host = self._cluster_metadata.get_host(addr)
+
+        child = self._child_policy
+        if target_host and target_host.is_up:
+            yield target_host
+            for h in child.make_query_plan(keyspace, query):
+                if h != target_host:
+                    yield h
+        else:
+            for h in child.make_query_plan(keyspace, query):
+                yield h
+
+
+# TODO for backward compatibility, remove in next major
+class DSELoadBalancingPolicy(DefaultLoadBalancingPolicy):
+    """
+    *Deprecated:* This will be removed in the next major release,
+    consider using :class:`.DefaultLoadBalancingPolicy`.
+    """
+    def __init__(self, *args, **kwargs):
+        super(DSELoadBalancingPolicy, self).__init__(*args, **kwargs)
+        warnings.warn("DSELoadBalancingPolicy will be removed in 4.0. Consider using "
+                      "DefaultLoadBalancingPolicy.", DeprecationWarning)
+
+
+class NeverRetryPolicy(RetryPolicy):
+    def _rethrow(self, *args, **kwargs):
+        return self.RETHROW, None
+
+    on_read_timeout = _rethrow
+    on_write_timeout = _rethrow
+    on_unavailable = _rethrow
+
+
+ColDesc = namedtuple('ColDesc', ['ks', 'table', 'col'])
+
+class ColumnEncryptionPolicy(object):
+    """
+    A policy enabling (mostly) transparent encryption and decryption of data before it is
+    sent to the cluster.
+
+    Key materials and other configurations are specified on a per-column basis.  This policy can
+    then be used by driver structures which are aware of the underlying columns involved in their
+    work.  In practice this includes the following cases:
+
+    * Prepared statements - data for columns specified by the cluster's policy will be transparently
+      encrypted before they are sent
+    * Rows returned from any query - data for columns specified by the cluster's policy will be
+      transparently decrypted before they are returned to the user
+
+    To enable this functionality, create an instance of this class (or more likely a subclass)
+    before creating a cluster.  This policy should then be configured and supplied to the Cluster
+    at creation time via the :attr:`.Cluster.column_encryption_policy` attribute.
+    """
+
+    def encrypt(self, coldesc, obj_bytes):
+        """
+        Encrypt the specified bytes using the cryptography materials for the specified column.
+        Largely used internally, although this could also be used to encrypt values supplied
+        to non-prepared statements in a way that is consistent with this policy.
+        """
+        raise NotImplementedError()
+
+    def decrypt(self, coldesc, encrypted_bytes):
+        """
+        Decrypt the specified (encrypted) bytes using the cryptography materials for the
+        specified column.  Used internally; could be used externally as well but there's
+        not currently an obvious use case.
+        """
+        raise NotImplementedError()
+
+    def add_column(self, coldesc, key):
+        """
+        Provide cryptography materials to be used when encrypted and/or decrypting data
+        for the specified column.
+        """
+        raise NotImplementedError()
+
+    def contains_column(self, coldesc):
+        """
+        Predicate to determine if a specific column is supported by this policy.
+        Currently only used internally.
+        """
+        raise NotImplementedError()
+
+    def encode_and_encrypt(self, coldesc, obj):
+        """
+        Helper function to enable use of this policy on simple (i.e. non-prepared)
+        statements.
+        """
+        raise NotImplementedError()
diff --git a/llm/Lib/site-packages/cassandra/pool.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/pool.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..7a6147f4e67bf8ea4dbb181e5f358466a48691ec
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/pool.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/pool.py b/llm/Lib/site-packages/cassandra/pool.py
new file mode 100644
index 0000000000000000000000000000000000000000..4270848b9e861b1cb450e847a19aa306533b24df
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/pool.py
@@ -0,0 +1,933 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Connection pooling and host management.
+"""
+
+from functools import total_ordering
+import logging
+import socket
+import time
+from threading import Lock, RLock, Condition
+import weakref
+try:
+    from weakref import WeakSet
+except ImportError:
+    from cassandra.util import WeakSet  # NOQA
+
+from cassandra import AuthenticationFailed
+from cassandra.connection import ConnectionException, EndPoint, DefaultEndPoint
+from cassandra.policies import HostDistance
+
+log = logging.getLogger(__name__)
+
+
+class NoConnectionsAvailable(Exception):
+    """
+    All existing connections to a given host are busy, or there are
+    no open connections.
+    """
+    pass
+
+
+@total_ordering
+class Host(object):
+    """
+    Represents a single Cassandra node.
+    """
+
+    endpoint = None
+    """
+    The :class:`~.connection.EndPoint` to connect to the node.
+    """
+
+    broadcast_address = None
+    """
+    broadcast address configured for the node, *if available*:
+
+    'system.local.broadcast_address' or 'system.peers.peer' (Cassandra 2-3)
+    'system.local.broadcast_address' or 'system.peers_v2.peer' (Cassandra 4)
+
+    This is not present in the ``system.local`` table for older versions of Cassandra. It
+    is also not queried if :attr:`~.Cluster.token_metadata_enabled` is ``False``.
+    """
+
+    broadcast_port = None
+    """
+    broadcast port configured for the node, *if available*:
+
+    'system.local.broadcast_port' or 'system.peers_v2.peer_port' (Cassandra 4)
+
+    It is also not queried if :attr:`~.Cluster.token_metadata_enabled` is ``False``.
+    """
+
+    broadcast_rpc_address = None
+    """
+    The broadcast rpc address of the node:
+
+    'system.local.rpc_address' or 'system.peers.rpc_address' (Cassandra 3)
+    'system.local.rpc_address' or 'system.peers.native_transport_address (DSE  6+)'
+    'system.local.rpc_address' or 'system.peers_v2.native_address (Cassandra 4)'
+    """
+
+    broadcast_rpc_port = None
+    """
+    The broadcast rpc port of the node, *if available*:
+    
+    'system.local.rpc_port' or 'system.peers.native_transport_port' (DSE 6+)
+    'system.local.rpc_port' or 'system.peers_v2.native_port' (Cassandra 4)
+    """
+
+    listen_address = None
+    """
+    listen address configured for the node, *if available*:
+
+    'system.local.listen_address'
+
+    This is only available in the ``system.local`` table for newer versions of Cassandra. It is also not
+    queried if :attr:`~.Cluster.token_metadata_enabled` is ``False``. Usually the same as ``broadcast_address``
+    unless configured differently in cassandra.yaml.
+    """
+
+    listen_port = None
+    """
+    listen port configured for the node, *if available*:
+
+    'system.local.listen_port'
+
+    This is only available in the ``system.local`` table for newer versions of Cassandra. It is also not
+    queried if :attr:`~.Cluster.token_metadata_enabled` is ``False``.
+    """
+
+    conviction_policy = None
+    """
+    A :class:`~.ConvictionPolicy` instance for determining when this node should
+    be marked up or down.
+    """
+
+    is_up = None
+    """
+    :const:`True` if the node is considered up, :const:`False` if it is
+    considered down, and :const:`None` if it is not known if the node is
+    up or down.
+    """
+
+    release_version = None
+    """
+    release_version as queried from the control connection system tables
+    """
+
+    host_id = None
+    """
+    The unique identifier of the cassandra node
+    """
+
+    dse_version = None
+    """
+    dse_version as queried from the control connection system tables. Only populated when connecting to
+    DSE with this property available. Not queried if :attr:`~.Cluster.token_metadata_enabled` is ``False``.
+    """
+
+    dse_workload = None
+    """
+    DSE workload queried from the control connection system tables. Only populated when connecting to
+    DSE with this property available. Not queried if :attr:`~.Cluster.token_metadata_enabled` is ``False``.
+    This is a legacy attribute that does not portray multiple workloads in a uniform fashion.
+    See also :attr:`~.Host.dse_workloads`.
+    """
+
+    dse_workloads = None
+    """
+    DSE workloads set, queried from the control connection system tables. Only populated when connecting to
+    DSE with this property available (added in DSE 5.1).
+    Not queried if :attr:`~.Cluster.token_metadata_enabled` is ``False``.
+    """
+
+    _datacenter = None
+    _rack = None
+    _reconnection_handler = None
+    lock = None
+
+    _currently_handling_node_up = False
+
+    def __init__(self, endpoint, conviction_policy_factory, datacenter=None, rack=None, host_id=None):
+        if endpoint is None:
+            raise ValueError("endpoint may not be None")
+        if conviction_policy_factory is None:
+            raise ValueError("conviction_policy_factory may not be None")
+
+        self.endpoint = endpoint if isinstance(endpoint, EndPoint) else DefaultEndPoint(endpoint)
+        self.conviction_policy = conviction_policy_factory(self)
+        self.host_id = host_id
+        self.set_location_info(datacenter, rack)
+        self.lock = RLock()
+
+    @property
+    def address(self):
+        """
+        The IP address of the endpoint. This is the RPC address the driver uses when connecting to the node.
+        """
+        # backward compatibility
+        return self.endpoint.address
+
+    @property
+    def datacenter(self):
+        """ The datacenter the node is in.  """
+        return self._datacenter
+
+    @property
+    def rack(self):
+        """ The rack the node is in.  """
+        return self._rack
+
+    def set_location_info(self, datacenter, rack):
+        """
+        Sets the datacenter and rack for this node. Intended for internal
+        use (by the control connection, which periodically checks the
+        ring topology) only.
+        """
+        self._datacenter = datacenter
+        self._rack = rack
+
+    def set_up(self):
+        if not self.is_up:
+            log.debug("Host %s is now marked up", self.endpoint)
+        self.conviction_policy.reset()
+        self.is_up = True
+
+    def set_down(self):
+        self.is_up = False
+
+    def signal_connection_failure(self, connection_exc):
+        return self.conviction_policy.add_failure(connection_exc)
+
+    def is_currently_reconnecting(self):
+        return self._reconnection_handler is not None
+
+    def get_and_set_reconnection_handler(self, new_handler):
+        """
+        Atomically replaces the reconnection handler for this
+        host.  Intended for internal use only.
+        """
+        with self.lock:
+            old = self._reconnection_handler
+            self._reconnection_handler = new_handler
+            return old
+
+    def __eq__(self, other):
+        if isinstance(other, Host):
+            return self.endpoint == other.endpoint
+        else:  # TODO Backward compatibility, remove next major
+            return self.endpoint.address == other
+
+    def __hash__(self):
+        return hash(self.endpoint)
+
+    def __lt__(self, other):
+        return self.endpoint < other.endpoint
+
+    def __str__(self):
+        return str(self.endpoint)
+
+    def __repr__(self):
+        dc = (" %s" % (self._datacenter,)) if self._datacenter else ""
+        return "<%s: %s%s>" % (self.__class__.__name__, self.endpoint, dc)
+
+
+class _ReconnectionHandler(object):
+    """
+    Abstract class for attempting reconnections with a given
+    schedule and scheduler.
+    """
+
+    _cancelled = False
+
+    def __init__(self, scheduler, schedule, callback, *callback_args, **callback_kwargs):
+        self.scheduler = scheduler
+        self.schedule = schedule
+        self.callback = callback
+        self.callback_args = callback_args
+        self.callback_kwargs = callback_kwargs
+
+    def start(self):
+        if self._cancelled:
+            log.debug("Reconnection handler was cancelled before starting")
+            return
+
+        first_delay = next(self.schedule)
+        self.scheduler.schedule(first_delay, self.run)
+
+    def run(self):
+        if self._cancelled:
+            return
+
+        conn = None
+        try:
+            conn = self.try_reconnect()
+        except Exception as exc:
+            try:
+                next_delay = next(self.schedule)
+            except StopIteration:
+                # the schedule has been exhausted
+                next_delay = None
+
+            # call on_exception for logging purposes even if next_delay is None
+            if self.on_exception(exc, next_delay):
+                if next_delay is None:
+                    log.warning(
+                        "Will not continue to retry reconnection attempts "
+                        "due to an exhausted retry schedule")
+                else:
+                    self.scheduler.schedule(next_delay, self.run)
+        else:
+            if not self._cancelled:
+                self.on_reconnection(conn)
+                self.callback(*(self.callback_args), **(self.callback_kwargs))
+        finally:
+            if conn:
+                conn.close()
+
+    def cancel(self):
+        self._cancelled = True
+
+    def try_reconnect(self):
+        """
+        Subclasses must implement this method.  It should attempt to
+        open a new Connection and return it; if a failure occurs, an
+        Exception should be raised.
+        """
+        raise NotImplementedError()
+
+    def on_reconnection(self, connection):
+        """
+        Called when a new Connection is successfully opened.  Nothing is
+        done by default.
+        """
+        pass
+
+    def on_exception(self, exc, next_delay):
+        """
+        Called when an Exception is raised when trying to connect.
+        `exc` is the Exception that was raised and `next_delay` is the
+        number of seconds (as a float) that the handler will wait before
+        attempting to connect again.
+
+        Subclasses should return :const:`False` if no more attempts to
+        connection should be made, :const:`True` otherwise.  The default
+        behavior is to always retry unless the error is an
+        :exc:`.AuthenticationFailed` instance.
+        """
+        if isinstance(exc, AuthenticationFailed):
+            return False
+        else:
+            return True
+
+
+class _HostReconnectionHandler(_ReconnectionHandler):
+
+    def __init__(self, host, connection_factory, is_host_addition, on_add, on_up, *args, **kwargs):
+        _ReconnectionHandler.__init__(self, *args, **kwargs)
+        self.is_host_addition = is_host_addition
+        self.on_add = on_add
+        self.on_up = on_up
+        self.host = host
+        self.connection_factory = connection_factory
+
+    def try_reconnect(self):
+        return self.connection_factory()
+
+    def on_reconnection(self, connection):
+        log.info("Successful reconnection to %s, marking node up if it isn't already", self.host)
+        if self.is_host_addition:
+            self.on_add(self.host)
+        else:
+            self.on_up(self.host)
+
+    def on_exception(self, exc, next_delay):
+        if isinstance(exc, AuthenticationFailed):
+            return False
+        else:
+            log.warning("Error attempting to reconnect to %s, scheduling retry in %s seconds: %s",
+                        self.host, next_delay, exc)
+            log.debug("Reconnection error details", exc_info=True)
+            return True
+
+
+class HostConnection(object):
+    """
+    When using v3 of the native protocol, this is used instead of a connection
+    pool per host (HostConnectionPool) due to the increased in-flight capacity
+    of individual connections.
+    """
+
+    host = None
+    host_distance = None
+    is_shutdown = False
+    shutdown_on_error = False
+
+    _session = None
+    _connection = None
+    _lock = None
+    _keyspace = None
+
+    def __init__(self, host, host_distance, session):
+        self.host = host
+        self.host_distance = host_distance
+        self._session = weakref.proxy(session)
+        self._lock = Lock()
+        # this is used in conjunction with the connection streams. Not using the connection lock because the connection can be replaced in the lifetime of the pool.
+        self._stream_available_condition = Condition(self._lock)
+        self._is_replacing = False
+        # Contains connections which shouldn't be used anymore
+        # and are waiting until all requests time out or complete
+        # so that we can dispose of them.
+        self._trash = set()
+
+        if host_distance == HostDistance.IGNORED:
+            log.debug("Not opening connection to ignored host %s", self.host)
+            return
+        elif host_distance == HostDistance.REMOTE and not session.cluster.connect_to_remote_hosts:
+            log.debug("Not opening connection to remote host %s", self.host)
+            return
+
+        log.debug("Initializing connection for host %s", self.host)
+        self._connection = session.cluster.connection_factory(host.endpoint, on_orphaned_stream_released=self.on_orphaned_stream_released)
+        self._keyspace = session.keyspace
+        if self._keyspace:
+            self._connection.set_keyspace_blocking(self._keyspace)
+        log.debug("Finished initializing connection for host %s", self.host)
+
+    def _get_connection(self):
+        if self.is_shutdown:
+            raise ConnectionException(
+                "Pool for %s is shutdown" % (self.host,), self.host)
+
+        conn = self._connection
+        if not conn:
+            raise NoConnectionsAvailable()
+        return conn
+
+    def borrow_connection(self, timeout):
+        conn = self._get_connection()
+        if conn.orphaned_threshold_reached:
+            with self._lock:
+                if not self._is_replacing:
+                    self._is_replacing = True
+                    self._session.submit(self._replace, conn)
+                    log.debug(
+                        "Connection to host %s reached orphaned stream limit, replacing...",
+                        self.host
+                    )
+
+        start = time.time()
+        remaining = timeout
+        while True:
+            with conn.lock:
+                if not (conn.orphaned_threshold_reached and conn.is_closed) and conn.in_flight < conn.max_request_id:
+                    conn.in_flight += 1
+                    return conn, conn.get_request_id()
+            if timeout is not None:
+                remaining = timeout - time.time() + start
+                if remaining < 0:
+                    break
+            with self._stream_available_condition:
+                if conn.orphaned_threshold_reached and conn.is_closed:
+                    conn = self._get_connection()
+                else:
+                    self._stream_available_condition.wait(remaining)
+
+        raise NoConnectionsAvailable("All request IDs are currently in use")
+
+    def return_connection(self, connection, stream_was_orphaned=False):
+        if not stream_was_orphaned:
+            with connection.lock:
+                connection.in_flight -= 1
+            with self._stream_available_condition:
+                self._stream_available_condition.notify()
+
+        if connection.is_defunct or connection.is_closed:
+            if connection.signaled_error and not self.shutdown_on_error:
+                return
+
+            is_down = False
+            if not connection.signaled_error:
+                log.debug("Defunct or closed connection (%s) returned to pool, potentially "
+                          "marking host %s as down", id(connection), self.host)
+                is_down = self._session.cluster.signal_connection_failure(
+                    self.host, connection.last_error, is_host_addition=False)
+                connection.signaled_error = True
+
+            if self.shutdown_on_error and not is_down:
+                is_down = True
+                self._session.cluster.on_down(self.host, is_host_addition=False)
+
+            if is_down:
+                self.shutdown()
+            else:
+                self._connection = None
+                with self._lock:
+                    if self._is_replacing:
+                        return
+                    self._is_replacing = True
+                    self._session.submit(self._replace, connection)
+        else:
+            if connection in self._trash:
+                with connection.lock:
+                    if connection.in_flight == len(connection.orphaned_request_ids):
+                        with self._lock:
+                            if connection in self._trash:
+                                self._trash.remove(connection)
+                                log.debug("Closing trashed connection (%s) to %s", id(connection), self.host)
+                                connection.close()
+                return
+
+    def on_orphaned_stream_released(self):
+        """
+        Called when a response for an orphaned stream (timed out on the client
+        side) was received.
+        """
+        with self._stream_available_condition:
+            self._stream_available_condition.notify()
+
+    def _replace(self, connection):
+        with self._lock:
+            if self.is_shutdown:
+                return
+
+        log.debug("Replacing connection (%s) to %s", id(connection), self.host)
+        try:
+            conn = self._session.cluster.connection_factory(self.host.endpoint, on_orphaned_stream_released=self.on_orphaned_stream_released)
+            if self._keyspace:
+                conn.set_keyspace_blocking(self._keyspace)
+            self._connection = conn
+        except Exception:
+            log.warning("Failed reconnecting %s. Retrying." % (self.host.endpoint,))
+            self._session.submit(self._replace, connection)
+        else:
+            with connection.lock:
+                with self._lock:
+                    if connection.orphaned_threshold_reached:
+                        if connection.in_flight == len(connection.orphaned_request_ids):
+                            connection.close()
+                        else:
+                            self._trash.add(connection)
+                    self._is_replacing = False
+                    self._stream_available_condition.notify()
+
+    def shutdown(self):
+        with self._lock:
+            if self.is_shutdown:
+                return
+            else:
+                self.is_shutdown = True
+            self._stream_available_condition.notify_all()
+
+        if self._connection:
+            self._connection.close()
+            self._connection = None
+
+        trash_conns = None
+        with self._lock:
+            if self._trash:
+                trash_conns = self._trash
+                self._trash = set()
+
+        if trash_conns is not None:
+            for conn in self._trash:
+                conn.close()
+
+    def _set_keyspace_for_all_conns(self, keyspace, callback):
+        if self.is_shutdown or not self._connection:
+            return
+
+        def connection_finished_setting_keyspace(conn, error):
+            self.return_connection(conn)
+            errors = [] if not error else [error]
+            callback(self, errors)
+
+        self._keyspace = keyspace
+        self._connection.set_keyspace_async(keyspace, connection_finished_setting_keyspace)
+
+    def get_connections(self):
+        c = self._connection
+        return [c] if c else []
+
+    def get_state(self):
+        connection = self._connection
+        open_count = 1 if connection and not (connection.is_closed or connection.is_defunct) else 0
+        in_flights = [connection.in_flight] if connection else []
+        orphan_requests = [connection.orphaned_request_ids] if connection else []
+        return {'shutdown': self.is_shutdown, 'open_count': open_count, \
+            'in_flights': in_flights, 'orphan_requests': orphan_requests}
+
+    @property
+    def open_count(self):
+        connection = self._connection
+        return 1 if connection and not (connection.is_closed or connection.is_defunct) else 0
+
+_MAX_SIMULTANEOUS_CREATION = 1
+_MIN_TRASH_INTERVAL = 10
+
+
+class HostConnectionPool(object):
+    """
+    Used to pool connections to a host for v1 and v2 native protocol.
+    """
+
+    host = None
+    host_distance = None
+
+    is_shutdown = False
+    open_count = 0
+    _scheduled_for_creation = 0
+    _next_trash_allowed_at = 0
+    _keyspace = None
+
+    def __init__(self, host, host_distance, session):
+        self.host = host
+        self.host_distance = host_distance
+
+        self._session = weakref.proxy(session)
+        self._lock = RLock()
+        self._conn_available_condition = Condition()
+
+        log.debug("Initializing new connection pool for host %s", self.host)
+        core_conns = session.cluster.get_core_connections_per_host(host_distance)
+        self._connections = [session.cluster.connection_factory(host.endpoint, on_orphaned_stream_released=self.on_orphaned_stream_released)
+                             for i in range(core_conns)]
+
+        self._keyspace = session.keyspace
+        if self._keyspace:
+            for conn in self._connections:
+                conn.set_keyspace_blocking(self._keyspace)
+
+        self._trash = set()
+        self._next_trash_allowed_at = time.time()
+        self.open_count = core_conns
+        log.debug("Finished initializing new connection pool for host %s", self.host)
+
+    def borrow_connection(self, timeout):
+        if self.is_shutdown:
+            raise ConnectionException(
+                "Pool for %s is shutdown" % (self.host,), self.host)
+
+        conns = self._connections
+        if not conns:
+            # handled specially just for simpler code
+            log.debug("Detected empty pool, opening core conns to %s", self.host)
+            core_conns = self._session.cluster.get_core_connections_per_host(self.host_distance)
+            with self._lock:
+                # we check the length of self._connections again
+                # along with self._scheduled_for_creation while holding the lock
+                # in case multiple threads hit this condition at the same time
+                to_create = core_conns - (len(self._connections) + self._scheduled_for_creation)
+                for i in range(to_create):
+                    self._scheduled_for_creation += 1
+                    self._session.submit(self._create_new_connection)
+
+            # in_flight is incremented by wait_for_conn
+            conn = self._wait_for_conn(timeout)
+            return conn
+        else:
+            # note: it would be nice to push changes to these config settings
+            # to pools instead of doing a new lookup on every
+            # borrow_connection() call
+            max_reqs = self._session.cluster.get_max_requests_per_connection(self.host_distance)
+            max_conns = self._session.cluster.get_max_connections_per_host(self.host_distance)
+
+            least_busy = min(conns, key=lambda c: c.in_flight)
+            request_id = None
+            # to avoid another thread closing this connection while
+            # trashing it (through the return_connection process), hold
+            # the connection lock from this point until we've incremented
+            # its in_flight count
+            need_to_wait = False
+            with least_busy.lock:
+                if least_busy.in_flight < least_busy.max_request_id:
+                    least_busy.in_flight += 1
+                    request_id = least_busy.get_request_id()
+                else:
+                    # once we release the lock, wait for another connection
+                    need_to_wait = True
+
+            if need_to_wait:
+                # wait_for_conn will increment in_flight on the conn
+                least_busy, request_id = self._wait_for_conn(timeout)
+
+            # if we have too many requests on this connection but we still
+            # have space to open a new connection against this host, go ahead
+            # and schedule the creation of a new connection
+            if least_busy.in_flight >= max_reqs and len(self._connections) < max_conns:
+                self._maybe_spawn_new_connection()
+
+            return least_busy, request_id
+
+    def _maybe_spawn_new_connection(self):
+        with self._lock:
+            if self._scheduled_for_creation >= _MAX_SIMULTANEOUS_CREATION:
+                return
+            if self.open_count >= self._session.cluster.get_max_connections_per_host(self.host_distance):
+                return
+            self._scheduled_for_creation += 1
+
+        log.debug("Submitting task for creation of new Connection to %s", self.host)
+        self._session.submit(self._create_new_connection)
+
+    def _create_new_connection(self):
+        try:
+            self._add_conn_if_under_max()
+        except (ConnectionException, socket.error) as exc:
+            log.warning("Failed to create new connection to %s: %s", self.host, exc)
+        except Exception:
+            log.exception("Unexpectedly failed to create new connection")
+        finally:
+            with self._lock:
+                self._scheduled_for_creation -= 1
+
+    def _add_conn_if_under_max(self):
+        max_conns = self._session.cluster.get_max_connections_per_host(self.host_distance)
+        with self._lock:
+            if self.is_shutdown:
+                return True
+
+            if self.open_count >= max_conns:
+                return True
+
+            self.open_count += 1
+
+        log.debug("Going to open new connection to host %s", self.host)
+        try:
+            conn = self._session.cluster.connection_factory(self.host.endpoint, on_orphaned_stream_released=self.on_orphaned_stream_released)
+            if self._keyspace:
+                conn.set_keyspace_blocking(self._session.keyspace)
+            self._next_trash_allowed_at = time.time() + _MIN_TRASH_INTERVAL
+            with self._lock:
+                new_connections = self._connections[:] + [conn]
+                self._connections = new_connections
+            log.debug("Added new connection (%s) to pool for host %s, signaling availablility",
+                      id(conn), self.host)
+            self._signal_available_conn()
+            return True
+        except (ConnectionException, socket.error) as exc:
+            log.warning("Failed to add new connection to pool for host %s: %s", self.host, exc)
+            with self._lock:
+                self.open_count -= 1
+            if self._session.cluster.signal_connection_failure(self.host, exc, is_host_addition=False):
+                self.shutdown()
+            return False
+        except AuthenticationFailed:
+            with self._lock:
+                self.open_count -= 1
+            return False
+
+    def _await_available_conn(self, timeout):
+        with self._conn_available_condition:
+            self._conn_available_condition.wait(timeout)
+
+    def _signal_available_conn(self):
+        with self._conn_available_condition:
+            self._conn_available_condition.notify()
+
+    def _signal_all_available_conn(self):
+        with self._conn_available_condition:
+            self._conn_available_condition.notify_all()
+
+    def _wait_for_conn(self, timeout):
+        start = time.time()
+        remaining = timeout
+
+        while remaining > 0:
+            # wait on our condition for the possibility that a connection
+            # is useable
+            self._await_available_conn(remaining)
+
+            # self.shutdown() may trigger the above Condition
+            if self.is_shutdown:
+                raise ConnectionException("Pool is shutdown")
+
+            conns = self._connections
+            if conns:
+                least_busy = min(conns, key=lambda c: c.in_flight)
+                with least_busy.lock:
+                    if least_busy.in_flight < least_busy.max_request_id:
+                        least_busy.in_flight += 1
+                        return least_busy, least_busy.get_request_id()
+
+            remaining = timeout - (time.time() - start)
+
+        raise NoConnectionsAvailable()
+
+    def return_connection(self, connection, stream_was_orphaned=False):
+        with connection.lock:
+            if not stream_was_orphaned:
+                connection.in_flight -= 1
+            in_flight = connection.in_flight
+
+        if connection.is_defunct or connection.is_closed:
+            if not connection.signaled_error:
+                log.debug("Defunct or closed connection (%s) returned to pool, potentially "
+                          "marking host %s as down", id(connection), self.host)
+                is_down = self._session.cluster.signal_connection_failure(
+                    self.host, connection.last_error, is_host_addition=False)
+                connection.signaled_error = True
+                if is_down:
+                    self.shutdown()
+                else:
+                    self._replace(connection)
+        else:
+            if connection in self._trash:
+                with connection.lock:
+                    if connection.in_flight == 0:
+                        with self._lock:
+                            if connection in self._trash:
+                                self._trash.remove(connection)
+                        log.debug("Closing trashed connection (%s) to %s", id(connection), self.host)
+                        connection.close()
+                return
+
+            core_conns = self._session.cluster.get_core_connections_per_host(self.host_distance)
+            min_reqs = self._session.cluster.get_min_requests_per_connection(self.host_distance)
+            # we can use in_flight here without holding the connection lock
+            # because the fact that in_flight dipped below the min at some
+            # point is enough to start the trashing procedure
+            if len(self._connections) > core_conns and in_flight <= min_reqs and \
+                    time.time() >= self._next_trash_allowed_at:
+                self._maybe_trash_connection(connection)
+            else:
+                self._signal_available_conn()
+
+    def on_orphaned_stream_released(self):
+        """
+        Called when a response for an orphaned stream (timed out on the client
+        side) was received.
+        """
+        self._signal_available_conn()
+
+    def _maybe_trash_connection(self, connection):
+        core_conns = self._session.cluster.get_core_connections_per_host(self.host_distance)
+        did_trash = False
+        with self._lock:
+            if connection not in self._connections:
+                return
+
+            if self.open_count > core_conns:
+                did_trash = True
+                self.open_count -= 1
+                new_connections = self._connections[:]
+                new_connections.remove(connection)
+                self._connections = new_connections
+
+                with connection.lock:
+                    if connection.in_flight == 0:
+                        log.debug("Skipping trash and closing unused connection (%s) to %s", id(connection), self.host)
+                        connection.close()
+
+                        # skip adding it to the trash if we're already closing it
+                        return
+
+                self._trash.add(connection)
+
+        if did_trash:
+            self._next_trash_allowed_at = time.time() + _MIN_TRASH_INTERVAL
+            log.debug("Trashed connection (%s) to %s", id(connection), self.host)
+
+    def _replace(self, connection):
+        should_replace = False
+        with self._lock:
+            if connection in self._connections:
+                new_connections = self._connections[:]
+                new_connections.remove(connection)
+                self._connections = new_connections
+                self.open_count -= 1
+                should_replace = True
+
+        if should_replace:
+            log.debug("Replacing connection (%s) to %s", id(connection), self.host)
+            connection.close()
+            self._session.submit(self._retrying_replace)
+        else:
+            log.debug("Closing connection (%s) to %s", id(connection), self.host)
+            connection.close()
+
+    def _retrying_replace(self):
+        replaced = False
+        try:
+            replaced = self._add_conn_if_under_max()
+        except Exception:
+            log.exception("Failed replacing connection to %s", self.host)
+        if not replaced:
+            log.debug("Failed replacing connection to %s. Retrying.", self.host)
+            self._session.submit(self._retrying_replace)
+
+    def shutdown(self):
+        with self._lock:
+            if self.is_shutdown:
+                return
+            else:
+                self.is_shutdown = True
+
+        self._signal_all_available_conn()
+        for conn in self._connections:
+            conn.close()
+            self.open_count -= 1
+
+        for conn in self._trash:
+            conn.close()
+
+    def ensure_core_connections(self):
+        if self.is_shutdown:
+            return
+
+        core_conns = self._session.cluster.get_core_connections_per_host(self.host_distance)
+        with self._lock:
+            to_create = core_conns - (len(self._connections) + self._scheduled_for_creation)
+            for i in range(to_create):
+                self._scheduled_for_creation += 1
+                self._session.submit(self._create_new_connection)
+
+    def _set_keyspace_for_all_conns(self, keyspace, callback):
+        """
+        Asynchronously sets the keyspace for all connections.  When all
+        connections have been set, `callback` will be called with two
+        arguments: this pool, and a list of any errors that occurred.
+        """
+        remaining_callbacks = set(self._connections)
+        errors = []
+
+        if not remaining_callbacks:
+            callback(self, errors)
+            return
+
+        def connection_finished_setting_keyspace(conn, error):
+            self.return_connection(conn)
+            remaining_callbacks.remove(conn)
+            if error:
+                errors.append(error)
+
+            if not remaining_callbacks:
+                callback(self, errors)
+
+        self._keyspace = keyspace
+        for conn in self._connections:
+            conn.set_keyspace_async(keyspace, connection_finished_setting_keyspace)
+
+    def get_connections(self):
+        return self._connections
+
+    def get_state(self):
+        in_flights = [c.in_flight for c in self._connections]
+        orphan_requests = [c.orphaned_request_ids for c in self._connections]
+        return {'shutdown': self.is_shutdown, 'open_count': self.open_count, \
+            'in_flights': in_flights, 'orphan_requests': orphan_requests}
diff --git a/llm/Lib/site-packages/cassandra/protocol.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/protocol.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..9413e9b948fb2a5235562d07118ebec7ace17be3
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/protocol.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/protocol.py b/llm/Lib/site-packages/cassandra/protocol.py
new file mode 100644
index 0000000000000000000000000000000000000000..177ef7e2ff3e3977165e4bbf90dca7a81f6fca22
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/protocol.py
@@ -0,0 +1,1490 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import  # to enable import io from stdlib
+from collections import namedtuple
+import logging
+import socket
+from uuid import UUID
+
+import io
+
+from cassandra import ProtocolVersion
+from cassandra import type_codes, DriverException
+from cassandra import (Unavailable, WriteTimeout, ReadTimeout,
+                       WriteFailure, ReadFailure, FunctionFailure,
+                       AlreadyExists, InvalidRequest, Unauthorized,
+                       UnsupportedOperation, UserFunctionDescriptor,
+                       UserAggregateDescriptor, SchemaTargetType)
+from cassandra.cqltypes import (AsciiType, BytesType, BooleanType,
+                                CounterColumnType, DateType, DecimalType,
+                                DoubleType, FloatType, Int32Type,
+                                InetAddressType, IntegerType, ListType,
+                                LongType, MapType, SetType, TimeUUIDType,
+                                UTF8Type, VarcharType, UUIDType, UserType,
+                                TupleType, lookup_casstype, SimpleDateType,
+                                TimeType, ByteType, ShortType, DurationType)
+from cassandra.marshal import (int32_pack, int32_unpack, uint16_pack, uint16_unpack,
+                               uint8_pack, int8_unpack, uint64_pack, header_pack,
+                               v3_header_pack, uint32_pack, uint32_le_unpack, uint32_le_pack)
+from cassandra.policies import ColDesc
+from cassandra import WriteType
+from cassandra.cython_deps import HAVE_CYTHON, HAVE_NUMPY
+from cassandra import util
+
+log = logging.getLogger(__name__)
+
+
+class NotSupportedError(Exception):
+    pass
+
+
+class InternalError(Exception):
+    pass
+
+ColumnMetadata = namedtuple("ColumnMetadata", ['keyspace_name', 'table_name', 'name', 'type'])
+
+HEADER_DIRECTION_TO_CLIENT = 0x80
+HEADER_DIRECTION_MASK = 0x80
+
+COMPRESSED_FLAG = 0x01
+TRACING_FLAG = 0x02
+CUSTOM_PAYLOAD_FLAG = 0x04
+WARNING_FLAG = 0x08
+USE_BETA_FLAG = 0x10
+USE_BETA_MASK = ~USE_BETA_FLAG
+
+_message_types_by_opcode = {}
+
+_UNSET_VALUE = object()
+
+
+def register_class(cls):
+    _message_types_by_opcode[cls.opcode] = cls
+
+
+def get_registered_classes():
+    return _message_types_by_opcode.copy()
+
+
+class _RegisterMessageType(type):
+    def __init__(cls, name, bases, dct):
+        if not name.startswith('_'):
+            register_class(cls)
+
+
+class _MessageType(object, metaclass=_RegisterMessageType):
+
+    tracing = False
+    custom_payload = None
+    warnings = None
+
+    def update_custom_payload(self, other):
+        if other:
+            if not self.custom_payload:
+                self.custom_payload = {}
+            self.custom_payload.update(other)
+            if len(self.custom_payload) > 65535:
+                raise ValueError("Custom payload map exceeds max count allowed by protocol (65535)")
+
+    def __repr__(self):
+        return '<%s(%s)>' % (self.__class__.__name__, ', '.join('%s=%r' % i for i in _get_params(self)))
+
+
+def _get_params(message_obj):
+    base_attrs = dir(_MessageType)
+    return (
+        (n, a) for n, a in message_obj.__dict__.items()
+        if n not in base_attrs and not n.startswith('_') and not callable(a)
+    )
+
+
+error_classes = {}
+
+
+class ErrorMessage(_MessageType, Exception):
+    opcode = 0x00
+    name = 'ERROR'
+    summary = 'Unknown'
+
+    def __init__(self, code, message, info):
+        self.code = code
+        self.message = message
+        self.info = info
+
+    @classmethod
+    def recv_body(cls, f, protocol_version, *args):
+        code = read_int(f)
+        msg = read_string(f)
+        subcls = error_classes.get(code, cls)
+        extra_info = subcls.recv_error_info(f, protocol_version)
+        return subcls(code=code, message=msg, info=extra_info)
+
+    def summary_msg(self):
+        msg = 'Error from server: code=%04x [%s] message="%s"' \
+              % (self.code, self.summary, self.message)
+        return msg
+
+    def __str__(self):
+        return '<%s>' % self.summary_msg()
+    __repr__ = __str__
+
+    @staticmethod
+    def recv_error_info(f, protocol_version):
+        pass
+
+    def to_exception(self):
+        return self
+
+
+class ErrorMessageSubclass(_RegisterMessageType):
+    def __init__(cls, name, bases, dct):
+        if cls.error_code is not None:  # Server has an error code of 0.
+            error_classes[cls.error_code] = cls
+
+
+class ErrorMessageSub(ErrorMessage, metaclass=ErrorMessageSubclass):
+    error_code = None
+
+
+class RequestExecutionException(ErrorMessageSub):
+    pass
+
+
+class RequestValidationException(ErrorMessageSub):
+    pass
+
+
+class ServerError(ErrorMessageSub):
+    summary = 'Server error'
+    error_code = 0x0000
+
+
+class ProtocolException(ErrorMessageSub):
+    summary = 'Protocol error'
+    error_code = 0x000A
+
+    @property
+    def is_beta_protocol_error(self):
+        return 'USE_BETA flag is unset' in str(self)
+
+
+class BadCredentials(ErrorMessageSub):
+    summary = 'Bad credentials'
+    error_code = 0x0100
+
+
+class UnavailableErrorMessage(RequestExecutionException):
+    summary = 'Unavailable exception'
+    error_code = 0x1000
+
+    @staticmethod
+    def recv_error_info(f, protocol_version):
+        return {
+            'consistency': read_consistency_level(f),
+            'required_replicas': read_int(f),
+            'alive_replicas': read_int(f),
+        }
+
+    def to_exception(self):
+        return Unavailable(self.summary_msg(), **self.info)
+
+
+class OverloadedErrorMessage(RequestExecutionException):
+    summary = 'Coordinator node overloaded'
+    error_code = 0x1001
+
+
+class IsBootstrappingErrorMessage(RequestExecutionException):
+    summary = 'Coordinator node is bootstrapping'
+    error_code = 0x1002
+
+
+class TruncateError(RequestExecutionException):
+    summary = 'Error during truncate'
+    error_code = 0x1003
+
+
+class WriteTimeoutErrorMessage(RequestExecutionException):
+    summary = "Coordinator node timed out waiting for replica nodes' responses"
+    error_code = 0x1100
+
+    @staticmethod
+    def recv_error_info(f, protocol_version):
+        return {
+            'consistency': read_consistency_level(f),
+            'received_responses': read_int(f),
+            'required_responses': read_int(f),
+            'write_type': WriteType.name_to_value[read_string(f)],
+        }
+
+    def to_exception(self):
+        return WriteTimeout(self.summary_msg(), **self.info)
+
+
+class ReadTimeoutErrorMessage(RequestExecutionException):
+    summary = "Coordinator node timed out waiting for replica nodes' responses"
+    error_code = 0x1200
+
+    @staticmethod
+    def recv_error_info(f, protocol_version):
+        return {
+            'consistency': read_consistency_level(f),
+            'received_responses': read_int(f),
+            'required_responses': read_int(f),
+            'data_retrieved': bool(read_byte(f)),
+        }
+
+    def to_exception(self):
+        return ReadTimeout(self.summary_msg(), **self.info)
+
+
+class ReadFailureMessage(RequestExecutionException):
+    summary = "Replica(s) failed to execute read"
+    error_code = 0x1300
+
+    @staticmethod
+    def recv_error_info(f, protocol_version):
+        consistency = read_consistency_level(f)
+        received_responses = read_int(f)
+        required_responses = read_int(f)
+
+        if ProtocolVersion.uses_error_code_map(protocol_version):
+            error_code_map = read_error_code_map(f)
+            failures = len(error_code_map)
+        else:
+            error_code_map = None
+            failures = read_int(f)
+
+        data_retrieved = bool(read_byte(f))
+
+        return {
+            'consistency': consistency,
+            'received_responses': received_responses,
+            'required_responses': required_responses,
+            'failures': failures,
+            'error_code_map': error_code_map,
+            'data_retrieved': data_retrieved
+        }
+
+    def to_exception(self):
+        return ReadFailure(self.summary_msg(), **self.info)
+
+
+class FunctionFailureMessage(RequestExecutionException):
+    summary = "User Defined Function failure"
+    error_code = 0x1400
+
+    @staticmethod
+    def recv_error_info(f, protocol_version):
+        return {
+            'keyspace': read_string(f),
+            'function': read_string(f),
+            'arg_types': [read_string(f) for _ in range(read_short(f))],
+        }
+
+    def to_exception(self):
+        return FunctionFailure(self.summary_msg(), **self.info)
+
+
+class WriteFailureMessage(RequestExecutionException):
+    summary = "Replica(s) failed to execute write"
+    error_code = 0x1500
+
+    @staticmethod
+    def recv_error_info(f, protocol_version):
+        consistency = read_consistency_level(f)
+        received_responses = read_int(f)
+        required_responses = read_int(f)
+
+        if ProtocolVersion.uses_error_code_map(protocol_version):
+            error_code_map = read_error_code_map(f)
+            failures = len(error_code_map)
+        else:
+            error_code_map = None
+            failures = read_int(f)
+
+        write_type = WriteType.name_to_value[read_string(f)]
+
+        return {
+            'consistency': consistency,
+            'received_responses': received_responses,
+            'required_responses': required_responses,
+            'failures': failures,
+            'error_code_map': error_code_map,
+            'write_type': write_type
+        }
+
+    def to_exception(self):
+        return WriteFailure(self.summary_msg(), **self.info)
+
+
+class CDCWriteException(RequestExecutionException):
+    summary = 'Failed to execute write due to CDC space exhaustion.'
+    error_code = 0x1600
+
+
+class SyntaxException(RequestValidationException):
+    summary = 'Syntax error in CQL query'
+    error_code = 0x2000
+
+
+class UnauthorizedErrorMessage(RequestValidationException):
+    summary = 'Unauthorized'
+    error_code = 0x2100
+
+    def to_exception(self):
+        return Unauthorized(self.summary_msg())
+
+
+class InvalidRequestException(RequestValidationException):
+    summary = 'Invalid query'
+    error_code = 0x2200
+
+    def to_exception(self):
+        return InvalidRequest(self.summary_msg())
+
+
+class ConfigurationException(RequestValidationException):
+    summary = 'Query invalid because of configuration issue'
+    error_code = 0x2300
+
+
+class PreparedQueryNotFound(RequestValidationException):
+    summary = 'Matching prepared statement not found on this node'
+    error_code = 0x2500
+
+    @staticmethod
+    def recv_error_info(f, protocol_version):
+        # return the query ID
+        return read_binary_string(f)
+
+
+class AlreadyExistsException(ConfigurationException):
+    summary = 'Item already exists'
+    error_code = 0x2400
+
+    @staticmethod
+    def recv_error_info(f, protocol_version):
+        return {
+            'keyspace': read_string(f),
+            'table': read_string(f),
+        }
+
+    def to_exception(self):
+        return AlreadyExists(**self.info)
+
+
+class ClientWriteError(RequestExecutionException):
+    summary = 'Client write failure.'
+    error_code = 0x8000
+
+
+class StartupMessage(_MessageType):
+    opcode = 0x01
+    name = 'STARTUP'
+
+    KNOWN_OPTION_KEYS = set((
+        'CQL_VERSION',
+        'COMPRESSION',
+        'NO_COMPACT'
+    ))
+
+    def __init__(self, cqlversion, options):
+        self.cqlversion = cqlversion
+        self.options = options
+
+    def send_body(self, f, protocol_version):
+        optmap = self.options.copy()
+        optmap['CQL_VERSION'] = self.cqlversion
+        write_stringmap(f, optmap)
+
+
+class ReadyMessage(_MessageType):
+    opcode = 0x02
+    name = 'READY'
+
+    @classmethod
+    def recv_body(cls, *args):
+        return cls()
+
+
+class AuthenticateMessage(_MessageType):
+    opcode = 0x03
+    name = 'AUTHENTICATE'
+
+    def __init__(self, authenticator):
+        self.authenticator = authenticator
+
+    @classmethod
+    def recv_body(cls, f, *args):
+        authname = read_string(f)
+        return cls(authenticator=authname)
+
+
+class CredentialsMessage(_MessageType):
+    opcode = 0x04
+    name = 'CREDENTIALS'
+
+    def __init__(self, creds):
+        self.creds = creds
+
+    def send_body(self, f, protocol_version):
+        if protocol_version > 1:
+            raise UnsupportedOperation(
+                "Credentials-based authentication is not supported with "
+                "protocol version 2 or higher.  Use the SASL authentication "
+                "mechanism instead.")
+        write_short(f, len(self.creds))
+        for credkey, credval in self.creds.items():
+            write_string(f, credkey)
+            write_string(f, credval)
+
+
+class AuthChallengeMessage(_MessageType):
+    opcode = 0x0E
+    name = 'AUTH_CHALLENGE'
+
+    def __init__(self, challenge):
+        self.challenge = challenge
+
+    @classmethod
+    def recv_body(cls, f, *args):
+        return cls(read_binary_longstring(f))
+
+
+class AuthResponseMessage(_MessageType):
+    opcode = 0x0F
+    name = 'AUTH_RESPONSE'
+
+    def __init__(self, response):
+        self.response = response
+
+    def send_body(self, f, protocol_version):
+        write_longstring(f, self.response)
+
+
+class AuthSuccessMessage(_MessageType):
+    opcode = 0x10
+    name = 'AUTH_SUCCESS'
+
+    def __init__(self, token):
+        self.token = token
+
+    @classmethod
+    def recv_body(cls, f, *args):
+        return cls(read_longstring(f))
+
+
+class OptionsMessage(_MessageType):
+    opcode = 0x05
+    name = 'OPTIONS'
+
+    def send_body(self, f, protocol_version):
+        pass
+
+
+class SupportedMessage(_MessageType):
+    opcode = 0x06
+    name = 'SUPPORTED'
+
+    def __init__(self, cql_versions, options):
+        self.cql_versions = cql_versions
+        self.options = options
+
+    @classmethod
+    def recv_body(cls, f, *args):
+        options = read_stringmultimap(f)
+        cql_versions = options.pop('CQL_VERSION')
+        return cls(cql_versions=cql_versions, options=options)
+
+
+# used for QueryMessage and ExecuteMessage
+_VALUES_FLAG = 0x01
+_SKIP_METADATA_FLAG = 0x02
+_PAGE_SIZE_FLAG = 0x04
+_WITH_PAGING_STATE_FLAG = 0x08
+_WITH_SERIAL_CONSISTENCY_FLAG = 0x10
+_PROTOCOL_TIMESTAMP_FLAG = 0x20
+_NAMES_FOR_VALUES_FLAG = 0x40  # not used here
+_WITH_KEYSPACE_FLAG = 0x80
+_PREPARED_WITH_KEYSPACE_FLAG = 0x01
+_PAGE_SIZE_BYTES_FLAG = 0x40000000
+_PAGING_OPTIONS_FLAG = 0x80000000
+
+
+class _QueryMessage(_MessageType):
+
+    def __init__(self, query_params, consistency_level,
+                 serial_consistency_level=None, fetch_size=None,
+                 paging_state=None, timestamp=None, skip_meta=False,
+                 continuous_paging_options=None, keyspace=None):
+        self.query_params = query_params
+        self.consistency_level = consistency_level
+        self.serial_consistency_level = serial_consistency_level
+        self.fetch_size = fetch_size
+        self.paging_state = paging_state
+        self.timestamp = timestamp
+        self.skip_meta = skip_meta
+        self.continuous_paging_options = continuous_paging_options
+        self.keyspace = keyspace
+
+    def _write_query_params(self, f, protocol_version):
+        write_consistency_level(f, self.consistency_level)
+        flags = 0x00
+        if self.query_params is not None:
+            flags |= _VALUES_FLAG  # also v2+, but we're only setting params internally right now
+
+        if self.serial_consistency_level:
+            if protocol_version >= 2:
+                flags |= _WITH_SERIAL_CONSISTENCY_FLAG
+            else:
+                raise UnsupportedOperation(
+                    "Serial consistency levels require the use of protocol version "
+                    "2 or higher. Consider setting Cluster.protocol_version to 2 "
+                    "to support serial consistency levels.")
+
+        if self.fetch_size:
+            if protocol_version >= 2:
+                flags |= _PAGE_SIZE_FLAG
+            else:
+                raise UnsupportedOperation(
+                    "Automatic query paging may only be used with protocol version "
+                    "2 or higher. Consider setting Cluster.protocol_version to 2.")
+
+        if self.paging_state:
+            if protocol_version >= 2:
+                flags |= _WITH_PAGING_STATE_FLAG
+            else:
+                raise UnsupportedOperation(
+                    "Automatic query paging may only be used with protocol version "
+                    "2 or higher. Consider setting Cluster.protocol_version to 2.")
+
+        if self.timestamp is not None:
+            flags |= _PROTOCOL_TIMESTAMP_FLAG
+
+        if self.continuous_paging_options:
+            if ProtocolVersion.has_continuous_paging_support(protocol_version):
+                flags |= _PAGING_OPTIONS_FLAG
+            else:
+                raise UnsupportedOperation(
+                    "Continuous paging may only be used with protocol version "
+                    "ProtocolVersion.DSE_V1 or higher. Consider setting Cluster.protocol_version to ProtocolVersion.DSE_V1.")
+
+        if self.keyspace is not None:
+            if ProtocolVersion.uses_keyspace_flag(protocol_version):
+                flags |= _WITH_KEYSPACE_FLAG
+            else:
+                raise UnsupportedOperation(
+                    "Keyspaces may only be set on queries with protocol version "
+                    "5 or DSE_V2 or higher. Consider setting Cluster.protocol_version.")
+
+        if ProtocolVersion.uses_int_query_flags(protocol_version):
+            write_uint(f, flags)
+        else:
+            write_byte(f, flags)
+
+        if self.query_params is not None:
+            write_short(f, len(self.query_params))
+            for param in self.query_params:
+                write_value(f, param)
+        if self.fetch_size:
+            write_int(f, self.fetch_size)
+        if self.paging_state:
+            write_longstring(f, self.paging_state)
+        if self.serial_consistency_level:
+            write_consistency_level(f, self.serial_consistency_level)
+        if self.timestamp is not None:
+            write_long(f, self.timestamp)
+        if self.keyspace is not None:
+            write_string(f, self.keyspace)
+        if self.continuous_paging_options:
+            self._write_paging_options(f, self.continuous_paging_options, protocol_version)
+
+    def _write_paging_options(self, f, paging_options, protocol_version):
+        write_int(f, paging_options.max_pages)
+        write_int(f, paging_options.max_pages_per_second)
+        if ProtocolVersion.has_continuous_paging_next_pages(protocol_version):
+            write_int(f, paging_options.max_queue_size)
+
+
+class QueryMessage(_QueryMessage):
+    opcode = 0x07
+    name = 'QUERY'
+
+    def __init__(self, query, consistency_level, serial_consistency_level=None,
+                 fetch_size=None, paging_state=None, timestamp=None, continuous_paging_options=None, keyspace=None):
+        self.query = query
+        super(QueryMessage, self).__init__(None, consistency_level, serial_consistency_level, fetch_size,
+                                           paging_state, timestamp, False, continuous_paging_options, keyspace)
+
+    def send_body(self, f, protocol_version):
+        write_longstring(f, self.query)
+        self._write_query_params(f, protocol_version)
+
+
+class ExecuteMessage(_QueryMessage):
+    opcode = 0x0A
+    name = 'EXECUTE'
+
+    def __init__(self, query_id, query_params, consistency_level,
+                 serial_consistency_level=None, fetch_size=None,
+                 paging_state=None, timestamp=None, skip_meta=False,
+                 continuous_paging_options=None, result_metadata_id=None):
+        self.query_id = query_id
+        self.result_metadata_id = result_metadata_id
+        super(ExecuteMessage, self).__init__(query_params, consistency_level, serial_consistency_level, fetch_size,
+                                             paging_state, timestamp, skip_meta, continuous_paging_options)
+
+    def _write_query_params(self, f, protocol_version):
+        if protocol_version == 1:
+            if self.serial_consistency_level:
+                raise UnsupportedOperation(
+                    "Serial consistency levels require the use of protocol version "
+                    "2 or higher. Consider setting Cluster.protocol_version to 2 "
+                    "to support serial consistency levels.")
+            if self.fetch_size or self.paging_state:
+                raise UnsupportedOperation(
+                    "Automatic query paging may only be used with protocol version "
+                    "2 or higher. Consider setting Cluster.protocol_version to 2.")
+            write_short(f, len(self.query_params))
+            for param in self.query_params:
+                write_value(f, param)
+            write_consistency_level(f, self.consistency_level)
+        else:
+            super(ExecuteMessage, self)._write_query_params(f, protocol_version)
+
+    def send_body(self, f, protocol_version):
+        write_string(f, self.query_id)
+        if ProtocolVersion.uses_prepared_metadata(protocol_version):
+            write_string(f, self.result_metadata_id)
+        self._write_query_params(f, protocol_version)
+
+
+CUSTOM_TYPE = object()
+
+RESULT_KIND_VOID = 0x0001
+RESULT_KIND_ROWS = 0x0002
+RESULT_KIND_SET_KEYSPACE = 0x0003
+RESULT_KIND_PREPARED = 0x0004
+RESULT_KIND_SCHEMA_CHANGE = 0x0005
+
+
+class ResultMessage(_MessageType):
+    opcode = 0x08
+    name = 'RESULT'
+
+    kind = None
+    results = None
+    paging_state = None
+
+    # Names match type name in module scope. Most are imported from cassandra.cqltypes (except CUSTOM_TYPE)
+    type_codes = _cqltypes_by_code = dict((v, globals()[k]) for k, v in type_codes.__dict__.items() if not k.startswith('_'))
+
+    _FLAGS_GLOBAL_TABLES_SPEC = 0x0001
+    _HAS_MORE_PAGES_FLAG = 0x0002
+    _NO_METADATA_FLAG = 0x0004
+    _CONTINUOUS_PAGING_FLAG = 0x40000000
+    _CONTINUOUS_PAGING_LAST_FLAG = 0x80000000
+    _METADATA_ID_FLAG = 0x0008
+
+    kind = None
+
+    # These are all the things a result message might contain. They are populated according to 'kind'
+    column_names = None
+    column_types = None
+    parsed_rows = None
+    paging_state = None
+    continuous_paging_seq = None
+    continuous_paging_last = None
+    new_keyspace = None
+    column_metadata = None
+    query_id = None
+    bind_metadata = None
+    pk_indexes = None
+    schema_change_event = None
+
+    def __init__(self, kind):
+        self.kind = kind
+
+    def recv(self, f, protocol_version, user_type_map, result_metadata, column_encryption_policy):
+        if self.kind == RESULT_KIND_VOID:
+            return
+        elif self.kind == RESULT_KIND_ROWS:
+            self.recv_results_rows(f, protocol_version, user_type_map, result_metadata, column_encryption_policy)
+        elif self.kind == RESULT_KIND_SET_KEYSPACE:
+            self.new_keyspace = read_string(f)
+        elif self.kind == RESULT_KIND_PREPARED:
+            self.recv_results_prepared(f, protocol_version, user_type_map)
+        elif self.kind == RESULT_KIND_SCHEMA_CHANGE:
+            self.recv_results_schema_change(f, protocol_version)
+        else:
+            raise DriverException("Unknown RESULT kind: %d" % self.kind)
+
+    @classmethod
+    def recv_body(cls, f, protocol_version, user_type_map, result_metadata, column_encryption_policy):
+        kind = read_int(f)
+        msg = cls(kind)
+        msg.recv(f, protocol_version, user_type_map, result_metadata, column_encryption_policy)
+        return msg
+
+    def recv_results_rows(self, f, protocol_version, user_type_map, result_metadata, column_encryption_policy):
+        self.recv_results_metadata(f, user_type_map)
+        column_metadata = self.column_metadata or result_metadata
+        rowcount = read_int(f)
+        rows = [self.recv_row(f, len(column_metadata)) for _ in range(rowcount)]
+        self.column_names = [c[2] for c in column_metadata]
+        self.column_types = [c[3] for c in column_metadata]
+        col_descs = [ColDesc(md[0], md[1], md[2]) for md in column_metadata]
+
+        def decode_val(val, col_md, col_desc):
+            uses_ce = column_encryption_policy and column_encryption_policy.contains_column(col_desc)
+            col_type = column_encryption_policy.column_type(col_desc) if uses_ce else col_md[3]
+            raw_bytes = column_encryption_policy.decrypt(col_desc, val) if uses_ce else val
+            return col_type.from_binary(raw_bytes, protocol_version)
+
+        def decode_row(row):
+            return tuple(decode_val(val, col_md, col_desc) for val, col_md, col_desc in zip(row, column_metadata, col_descs))
+
+        try:
+            self.parsed_rows = [decode_row(row) for row in rows]
+        except Exception:
+            for row in rows:
+                for val, col_md, col_desc in zip(row, column_metadata, col_descs):
+                    try:
+                        decode_val(val, col_md, col_desc)
+                    except Exception as e:
+                        raise DriverException('Failed decoding result column "%s" of type %s: %s' % (col_md[2],
+                                                                                                     col_md[3].cql_parameterized_type(),
+                                                                                                     str(e)))
+
+    def recv_results_prepared(self, f, protocol_version, user_type_map):
+        self.query_id = read_binary_string(f)
+        if ProtocolVersion.uses_prepared_metadata(protocol_version):
+            self.result_metadata_id = read_binary_string(f)
+        else:
+            self.result_metadata_id = None
+        self.recv_prepared_metadata(f, protocol_version, user_type_map)
+
+    def recv_results_metadata(self, f, user_type_map):
+        flags = read_int(f)
+        colcount = read_int(f)
+
+        if flags & self._HAS_MORE_PAGES_FLAG:
+            self.paging_state = read_binary_longstring(f)
+
+        no_meta = bool(flags & self._NO_METADATA_FLAG)
+        if no_meta:
+            return
+
+        if flags & self._CONTINUOUS_PAGING_FLAG:
+            self.continuous_paging_seq = read_int(f)
+            self.continuous_paging_last = flags & self._CONTINUOUS_PAGING_LAST_FLAG
+
+        if flags & self._METADATA_ID_FLAG:
+            self.result_metadata_id = read_binary_string(f)
+
+        glob_tblspec = bool(flags & self._FLAGS_GLOBAL_TABLES_SPEC)
+        if glob_tblspec:
+            ksname = read_string(f)
+            cfname = read_string(f)
+        column_metadata = []
+        for _ in range(colcount):
+            if glob_tblspec:
+                colksname = ksname
+                colcfname = cfname
+            else:
+                colksname = read_string(f)
+                colcfname = read_string(f)
+            colname = read_string(f)
+            coltype = self.read_type(f, user_type_map)
+            column_metadata.append((colksname, colcfname, colname, coltype))
+
+        self.column_metadata = column_metadata
+
+    def recv_prepared_metadata(self, f, protocol_version, user_type_map):
+        flags = read_int(f)
+        colcount = read_int(f)
+        pk_indexes = None
+        if protocol_version >= 4:
+            num_pk_indexes = read_int(f)
+            pk_indexes = [read_short(f) for _ in range(num_pk_indexes)]
+
+        glob_tblspec = bool(flags & self._FLAGS_GLOBAL_TABLES_SPEC)
+        if glob_tblspec:
+            ksname = read_string(f)
+            cfname = read_string(f)
+        bind_metadata = []
+        for _ in range(colcount):
+            if glob_tblspec:
+                colksname = ksname
+                colcfname = cfname
+            else:
+                colksname = read_string(f)
+                colcfname = read_string(f)
+            colname = read_string(f)
+            coltype = self.read_type(f, user_type_map)
+            bind_metadata.append(ColumnMetadata(colksname, colcfname, colname, coltype))
+
+        if protocol_version >= 2:
+            self.recv_results_metadata(f, user_type_map)
+
+        self.bind_metadata = bind_metadata
+        self.pk_indexes = pk_indexes
+
+    def recv_results_schema_change(self, f, protocol_version):
+        self.schema_change_event = EventMessage.recv_schema_change(f, protocol_version)
+
+    @classmethod
+    def read_type(cls, f, user_type_map):
+        optid = read_short(f)
+        try:
+            typeclass = cls.type_codes[optid]
+        except KeyError:
+            raise NotSupportedError("Unknown data type code 0x%04x. Have to skip"
+                                    " entire result set." % (optid,))
+        if typeclass in (ListType, SetType):
+            subtype = cls.read_type(f, user_type_map)
+            typeclass = typeclass.apply_parameters((subtype,))
+        elif typeclass == MapType:
+            keysubtype = cls.read_type(f, user_type_map)
+            valsubtype = cls.read_type(f, user_type_map)
+            typeclass = typeclass.apply_parameters((keysubtype, valsubtype))
+        elif typeclass == TupleType:
+            num_items = read_short(f)
+            types = tuple(cls.read_type(f, user_type_map) for _ in range(num_items))
+            typeclass = typeclass.apply_parameters(types)
+        elif typeclass == UserType:
+            ks = read_string(f)
+            udt_name = read_string(f)
+            num_fields = read_short(f)
+            names, types = zip(*((read_string(f), cls.read_type(f, user_type_map))
+                                 for _ in range(num_fields)))
+            specialized_type = typeclass.make_udt_class(ks, udt_name, names, types)
+            specialized_type.mapped_class = user_type_map.get(ks, {}).get(udt_name)
+            typeclass = specialized_type
+        elif typeclass == CUSTOM_TYPE:
+            classname = read_string(f)
+            typeclass = lookup_casstype(classname)
+
+        return typeclass
+
+    @staticmethod
+    def recv_row(f, colcount):
+        return [read_value(f) for _ in range(colcount)]
+
+
+class PrepareMessage(_MessageType):
+    opcode = 0x09
+    name = 'PREPARE'
+
+    def __init__(self, query, keyspace=None):
+        self.query = query
+        self.keyspace = keyspace
+
+    def send_body(self, f, protocol_version):
+        write_longstring(f, self.query)
+
+        flags = 0x00
+
+        if self.keyspace is not None:
+            if ProtocolVersion.uses_keyspace_flag(protocol_version):
+                flags |= _PREPARED_WITH_KEYSPACE_FLAG
+            else:
+                raise UnsupportedOperation(
+                    "Keyspaces may only be set on queries with protocol version "
+                    "5 or DSE_V2 or higher. Consider setting Cluster.protocol_version.")
+
+        if ProtocolVersion.uses_prepare_flags(protocol_version):
+            write_uint(f, flags)
+        else:
+            # checks above should prevent this, but just to be safe...
+            if flags:
+                raise UnsupportedOperation(
+                    "Attempted to set flags with value {flags:0=#8x} on"
+                    "protocol version {pv}, which doesn't support flags"
+                    "in prepared statements."
+                    "Consider setting Cluster.protocol_version to 5 or DSE_V2."
+                    "".format(flags=flags, pv=protocol_version))
+
+        if ProtocolVersion.uses_keyspace_flag(protocol_version):
+            if self.keyspace:
+                write_string(f, self.keyspace)
+
+
+class BatchMessage(_MessageType):
+    opcode = 0x0D
+    name = 'BATCH'
+
+    def __init__(self, batch_type, queries, consistency_level,
+                 serial_consistency_level=None, timestamp=None,
+                 keyspace=None):
+        self.batch_type = batch_type
+        self.queries = queries
+        self.consistency_level = consistency_level
+        self.serial_consistency_level = serial_consistency_level
+        self.timestamp = timestamp
+        self.keyspace = keyspace
+
+    def send_body(self, f, protocol_version):
+        write_byte(f, self.batch_type.value)
+        write_short(f, len(self.queries))
+        for prepared, string_or_query_id, params in self.queries:
+            if not prepared:
+                write_byte(f, 0)
+                write_longstring(f, string_or_query_id)
+            else:
+                write_byte(f, 1)
+                write_short(f, len(string_or_query_id))
+                f.write(string_or_query_id)
+            write_short(f, len(params))
+            for param in params:
+                write_value(f, param)
+
+        write_consistency_level(f, self.consistency_level)
+        if protocol_version >= 3:
+            flags = 0
+            if self.serial_consistency_level:
+                flags |= _WITH_SERIAL_CONSISTENCY_FLAG
+            if self.timestamp is not None:
+                flags |= _PROTOCOL_TIMESTAMP_FLAG
+            if self.keyspace:
+                if ProtocolVersion.uses_keyspace_flag(protocol_version):
+                    flags |= _WITH_KEYSPACE_FLAG
+                else:
+                    raise UnsupportedOperation(
+                        "Keyspaces may only be set on queries with protocol version "
+                        "5 or higher. Consider setting Cluster.protocol_version to 5.")
+
+            if ProtocolVersion.uses_int_query_flags(protocol_version):
+                write_int(f, flags)
+            else:
+                write_byte(f, flags)
+
+            if self.serial_consistency_level:
+                write_consistency_level(f, self.serial_consistency_level)
+            if self.timestamp is not None:
+                write_long(f, self.timestamp)
+
+            if ProtocolVersion.uses_keyspace_flag(protocol_version):
+                if self.keyspace is not None:
+                    write_string(f, self.keyspace)
+
+
+known_event_types = frozenset((
+    'TOPOLOGY_CHANGE',
+    'STATUS_CHANGE',
+    'SCHEMA_CHANGE'
+))
+
+
+class RegisterMessage(_MessageType):
+    opcode = 0x0B
+    name = 'REGISTER'
+
+    def __init__(self, event_list):
+        self.event_list = event_list
+
+    def send_body(self, f, protocol_version):
+        write_stringlist(f, self.event_list)
+
+
+class EventMessage(_MessageType):
+    opcode = 0x0C
+    name = 'EVENT'
+
+    def __init__(self, event_type, event_args):
+        self.event_type = event_type
+        self.event_args = event_args
+
+    @classmethod
+    def recv_body(cls, f, protocol_version, *args):
+        event_type = read_string(f).upper()
+        if event_type in known_event_types:
+            read_method = getattr(cls, 'recv_' + event_type.lower())
+            return cls(event_type=event_type, event_args=read_method(f, protocol_version))
+        raise NotSupportedError('Unknown event type %r' % event_type)
+
+    @classmethod
+    def recv_topology_change(cls, f, protocol_version):
+        # "NEW_NODE" or "REMOVED_NODE"
+        change_type = read_string(f)
+        address = read_inet(f)
+        return dict(change_type=change_type, address=address)
+
+    @classmethod
+    def recv_status_change(cls, f, protocol_version):
+        # "UP" or "DOWN"
+        change_type = read_string(f)
+        address = read_inet(f)
+        return dict(change_type=change_type, address=address)
+
+    @classmethod
+    def recv_schema_change(cls, f, protocol_version):
+        # "CREATED", "DROPPED", or "UPDATED"
+        change_type = read_string(f)
+        if protocol_version >= 3:
+            target = read_string(f)
+            keyspace = read_string(f)
+            event = {'target_type': target, 'change_type': change_type, 'keyspace': keyspace}
+            if target != SchemaTargetType.KEYSPACE:
+                target_name = read_string(f)
+                if target == SchemaTargetType.FUNCTION:
+                    event['function'] = UserFunctionDescriptor(target_name, [read_string(f) for _ in range(read_short(f))])
+                elif target == SchemaTargetType.AGGREGATE:
+                    event['aggregate'] = UserAggregateDescriptor(target_name, [read_string(f) for _ in range(read_short(f))])
+                else:
+                    event[target.lower()] = target_name
+        else:
+            keyspace = read_string(f)
+            table = read_string(f)
+            if table:
+                event = {'target_type': SchemaTargetType.TABLE, 'change_type': change_type, 'keyspace': keyspace, 'table': table}
+            else:
+                event = {'target_type': SchemaTargetType.KEYSPACE, 'change_type': change_type, 'keyspace': keyspace}
+        return event
+
+
+class ReviseRequestMessage(_MessageType):
+
+    class RevisionType(object):
+        PAGING_CANCEL = 1
+        PAGING_BACKPRESSURE = 2
+
+    opcode = 0xFF
+    name = 'REVISE_REQUEST'
+
+    def __init__(self, op_type, op_id, next_pages=0):
+        self.op_type = op_type
+        self.op_id = op_id
+        self.next_pages = next_pages
+
+    def send_body(self, f, protocol_version):
+        write_int(f, self.op_type)
+        write_int(f, self.op_id)
+        if self.op_type == ReviseRequestMessage.RevisionType.PAGING_BACKPRESSURE:
+            if self.next_pages <= 0:
+                raise UnsupportedOperation("Continuous paging backpressure requires next_pages > 0")
+            elif not ProtocolVersion.has_continuous_paging_next_pages(protocol_version):
+                raise UnsupportedOperation(
+                    "Continuous paging backpressure may only be used with protocol version "
+                    "ProtocolVersion.DSE_V2 or higher. Consider setting Cluster.protocol_version to ProtocolVersion.DSE_V2.")
+            else:
+                write_int(f, self.next_pages)
+
+
+class _ProtocolHandler(object):
+    """
+    _ProtocolHander handles encoding and decoding messages.
+
+    This class can be specialized to compose Handlers which implement alternative
+    result decoding or type deserialization. Class definitions are passed to :class:`cassandra.cluster.Cluster`
+    on initialization.
+
+    Contracted class methods are :meth:`_ProtocolHandler.encode_message` and :meth:`_ProtocolHandler.decode_message`.
+    """
+
+    message_types_by_opcode = _message_types_by_opcode.copy()
+    """
+    Default mapping of opcode to Message implementation. The default ``decode_message`` implementation uses
+    this to instantiate a message and populate using ``recv_body``. This mapping can be updated to inject specialized
+    result decoding implementations.
+    """
+
+    column_encryption_policy = None
+    """Instance of :class:`cassandra.policies.ColumnEncryptionPolicy` in use by this handler"""
+
+    @classmethod
+    def encode_message(cls, msg, stream_id, protocol_version, compressor, allow_beta_protocol_version):
+        """
+        Encodes a message using the specified frame parameters, and compressor
+
+        :param msg: the message, typically of cassandra.protocol._MessageType, generated by the driver
+        :param stream_id: protocol stream id for the frame header
+        :param protocol_version: version for the frame header, and used encoding contents
+        :param compressor: optional compression function to be used on the body
+        """
+        flags = 0
+        body = io.BytesIO()
+        if msg.custom_payload:
+            if protocol_version < 4:
+                raise UnsupportedOperation("Custom key/value payloads can only be used with protocol version 4 or higher")
+            flags |= CUSTOM_PAYLOAD_FLAG
+            write_bytesmap(body, msg.custom_payload)
+        msg.send_body(body, protocol_version)
+        body = body.getvalue()
+
+        # With checksumming, the compression is done at the segment frame encoding
+        if (not ProtocolVersion.has_checksumming_support(protocol_version)
+                and compressor and len(body) > 0):
+            body = compressor(body)
+            flags |= COMPRESSED_FLAG
+
+        if msg.tracing:
+            flags |= TRACING_FLAG
+
+        if allow_beta_protocol_version:
+            flags |= USE_BETA_FLAG
+
+        buff = io.BytesIO()
+        cls._write_header(buff, protocol_version, flags, stream_id, msg.opcode, len(body))
+        buff.write(body)
+
+        return buff.getvalue()
+
+    @staticmethod
+    def _write_header(f, version, flags, stream_id, opcode, length):
+        """
+        Write a CQL protocol frame header.
+        """
+        pack = v3_header_pack if version >= 3 else header_pack
+        f.write(pack(version, flags, stream_id, opcode))
+        write_int(f, length)
+
+    @classmethod
+    def decode_message(cls, protocol_version, user_type_map, stream_id, flags, opcode, body,
+                       decompressor, result_metadata):
+        """
+        Decodes a native protocol message body
+
+        :param protocol_version: version to use decoding contents
+        :param user_type_map: map[keyspace name] = map[type name] = custom type to instantiate when deserializing this type
+        :param stream_id: native protocol stream id from the frame header
+        :param flags: native protocol flags bitmap from the header
+        :param opcode: native protocol opcode from the header
+        :param body: frame body
+        :param decompressor: optional decompression function to inflate the body
+        :return: a message decoded from the body and frame attributes
+        """
+        if (not ProtocolVersion.has_checksumming_support(protocol_version) and
+                flags & COMPRESSED_FLAG):
+            if decompressor is None:
+                raise RuntimeError("No de-compressor available for compressed frame!")
+            body = decompressor(body)
+            flags ^= COMPRESSED_FLAG
+
+        body = io.BytesIO(body)
+        if flags & TRACING_FLAG:
+            trace_id = UUID(bytes=body.read(16))
+            flags ^= TRACING_FLAG
+        else:
+            trace_id = None
+
+        if flags & WARNING_FLAG:
+            warnings = read_stringlist(body)
+            flags ^= WARNING_FLAG
+        else:
+            warnings = None
+
+        if flags & CUSTOM_PAYLOAD_FLAG:
+            custom_payload = read_bytesmap(body)
+            flags ^= CUSTOM_PAYLOAD_FLAG
+        else:
+            custom_payload = None
+
+        flags &= USE_BETA_MASK  # will only be set if we asserted it in connection estabishment
+
+        if flags:
+            log.warning("Unknown protocol flags set: %02x. May cause problems.", flags)
+
+        msg_class = cls.message_types_by_opcode[opcode]
+        msg = msg_class.recv_body(body, protocol_version, user_type_map, result_metadata, cls.column_encryption_policy)
+        msg.stream_id = stream_id
+        msg.trace_id = trace_id
+        msg.custom_payload = custom_payload
+        msg.warnings = warnings
+
+        if msg.warnings:
+            for w in msg.warnings:
+                log.warning("Server warning: %s", w)
+
+        return msg
+
+
+def cython_protocol_handler(colparser):
+    """
+    Given a column parser to deserialize ResultMessages, return a suitable
+    Cython-based protocol handler.
+
+    There are three Cython-based protocol handlers:
+
+        - obj_parser.ListParser
+            decodes result messages into a list of tuples
+
+        - obj_parser.LazyParser
+            decodes result messages lazily by returning an iterator
+
+        - numpy_parser.NumPyParser
+            decodes result messages into NumPy arrays
+
+    The default is to use obj_parser.ListParser
+    """
+    from cassandra.row_parser import make_recv_results_rows
+
+    class FastResultMessage(ResultMessage):
+        """
+        Cython version of Result Message that has a faster implementation of
+        recv_results_row.
+        """
+        # type_codes = ResultMessage.type_codes.copy()
+        code_to_type = dict((v, k) for k, v in ResultMessage.type_codes.items())
+        recv_results_rows = make_recv_results_rows(colparser)
+
+    class CythonProtocolHandler(_ProtocolHandler):
+        """
+        Use FastResultMessage to decode query result message messages.
+        """
+
+        my_opcodes = _ProtocolHandler.message_types_by_opcode.copy()
+        my_opcodes[FastResultMessage.opcode] = FastResultMessage
+        message_types_by_opcode = my_opcodes
+
+        col_parser = colparser
+
+    return CythonProtocolHandler
+
+
+if HAVE_CYTHON:
+    from cassandra.obj_parser import ListParser, LazyParser
+    ProtocolHandler = cython_protocol_handler(ListParser())
+    LazyProtocolHandler = cython_protocol_handler(LazyParser())
+else:
+    # Use Python-based ProtocolHandler
+    ProtocolHandler = _ProtocolHandler
+    LazyProtocolHandler = None
+
+
+if HAVE_CYTHON and HAVE_NUMPY:
+    from cassandra.numpy_parser import NumpyParser
+    NumpyProtocolHandler = cython_protocol_handler(NumpyParser())
+else:
+    NumpyProtocolHandler = None
+
+
+def read_byte(f):
+    return int8_unpack(f.read(1))
+
+
+def write_byte(f, b):
+    f.write(uint8_pack(b))
+
+
+def read_int(f):
+    return int32_unpack(f.read(4))
+
+
+def read_uint_le(f, size=4):
+    """
+    Read a sequence of little endian bytes and return an unsigned integer.
+    """
+
+    if size == 4:
+        value = uint32_le_unpack(f.read(4))
+    else:
+        value = 0
+        for i in range(size):
+            value |= (read_byte(f) & 0xFF) << 8 * i
+
+    return value
+
+
+def write_uint_le(f, i, size=4):
+    """
+    Write an unsigned integer on a sequence of little endian bytes.
+    """
+    if size == 4:
+        f.write(uint32_le_pack(i))
+    else:
+        for j in range(size):
+            shift = j * 8
+            write_byte(f, i >> shift & 0xFF)
+
+
+def write_int(f, i):
+    f.write(int32_pack(i))
+
+
+def write_uint(f, i):
+    f.write(uint32_pack(i))
+
+
+def write_long(f, i):
+    f.write(uint64_pack(i))
+
+
+def read_short(f):
+    return uint16_unpack(f.read(2))
+
+
+def write_short(f, s):
+    f.write(uint16_pack(s))
+
+
+def read_consistency_level(f):
+    return read_short(f)
+
+
+def write_consistency_level(f, cl):
+    write_short(f, cl)
+
+
+def read_string(f):
+    size = read_short(f)
+    contents = f.read(size)
+    return contents.decode('utf8')
+
+
+def read_binary_string(f):
+    size = read_short(f)
+    contents = f.read(size)
+    return contents
+
+
+def write_string(f, s):
+    if isinstance(s, str):
+        s = s.encode('utf8')
+    write_short(f, len(s))
+    f.write(s)
+
+
+def read_binary_longstring(f):
+    size = read_int(f)
+    contents = f.read(size)
+    return contents
+
+
+def read_longstring(f):
+    return read_binary_longstring(f).decode('utf8')
+
+
+def write_longstring(f, s):
+    if isinstance(s, str):
+        s = s.encode('utf8')
+    write_int(f, len(s))
+    f.write(s)
+
+
+def read_stringlist(f):
+    numstrs = read_short(f)
+    return [read_string(f) for _ in range(numstrs)]
+
+
+def write_stringlist(f, stringlist):
+    write_short(f, len(stringlist))
+    for s in stringlist:
+        write_string(f, s)
+
+
+def read_stringmap(f):
+    numpairs = read_short(f)
+    strmap = {}
+    for _ in range(numpairs):
+        k = read_string(f)
+        strmap[k] = read_string(f)
+    return strmap
+
+
+def write_stringmap(f, strmap):
+    write_short(f, len(strmap))
+    for k, v in strmap.items():
+        write_string(f, k)
+        write_string(f, v)
+
+
+def read_bytesmap(f):
+    numpairs = read_short(f)
+    bytesmap = {}
+    for _ in range(numpairs):
+        k = read_string(f)
+        bytesmap[k] = read_value(f)
+    return bytesmap
+
+
+def write_bytesmap(f, bytesmap):
+    write_short(f, len(bytesmap))
+    for k, v in bytesmap.items():
+        write_string(f, k)
+        write_value(f, v)
+
+
+def read_stringmultimap(f):
+    numkeys = read_short(f)
+    strmmap = {}
+    for _ in range(numkeys):
+        k = read_string(f)
+        strmmap[k] = read_stringlist(f)
+    return strmmap
+
+
+def write_stringmultimap(f, strmmap):
+    write_short(f, len(strmmap))
+    for k, v in strmmap.items():
+        write_string(f, k)
+        write_stringlist(f, v)
+
+
+def read_error_code_map(f):
+    numpairs = read_int(f)
+    error_code_map = {}
+    for _ in range(numpairs):
+        endpoint = read_inet_addr_only(f)
+        error_code_map[endpoint] = read_short(f)
+    return error_code_map
+
+
+def read_value(f):
+    size = read_int(f)
+    if size < 0:
+        return None
+    return f.read(size)
+
+
+def write_value(f, v):
+    if v is None:
+        write_int(f, -1)
+    elif v is _UNSET_VALUE:
+        write_int(f, -2)
+    else:
+        write_int(f, len(v))
+        f.write(v)
+
+
+def read_inet_addr_only(f):
+    size = read_byte(f)
+    addrbytes = f.read(size)
+    if size == 4:
+        addrfam = socket.AF_INET
+    elif size == 16:
+        addrfam = socket.AF_INET6
+    else:
+        raise InternalError("bad inet address: %r" % (addrbytes,))
+    return util.inet_ntop(addrfam, addrbytes)
+
+
+def read_inet(f):
+    addr = read_inet_addr_only(f)
+    port = read_int(f)
+    return (addr, port)
+
+
+def write_inet(f, addrtuple):
+    addr, port = addrtuple
+    if ':' in addr:
+        addrfam = socket.AF_INET6
+    else:
+        addrfam = socket.AF_INET
+    addrbytes = util.inet_pton(addrfam, addr)
+    write_byte(f, len(addrbytes))
+    f.write(addrbytes)
+    write_int(f, port)
diff --git a/llm/Lib/site-packages/cassandra/query.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/query.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..cc369b39325f5d245c4812032c06094dce8d9a22
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/query.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/query.py b/llm/Lib/site-packages/cassandra/query.py
new file mode 100644
index 0000000000000000000000000000000000000000..b37d9c12dd85951086b59494d459aa836e0cd3ac
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/query.py
@@ -0,0 +1,1111 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+This module holds classes for working with prepared statements and
+specifying consistency levels and retry policies for individual
+queries.
+"""
+
+from collections import namedtuple
+from datetime import datetime, timedelta
+import re
+import struct
+import time
+import warnings
+
+from cassandra import ConsistencyLevel, OperationTimedOut
+from cassandra.util import unix_time_from_uuid1
+from cassandra.encoder import Encoder
+import cassandra.encoder
+from cassandra.policies import ColDesc
+from cassandra.protocol import _UNSET_VALUE
+from cassandra.util import OrderedDict, _sanitize_identifiers
+
+import logging
+log = logging.getLogger(__name__)
+
+UNSET_VALUE = _UNSET_VALUE
+"""
+Specifies an unset value when binding a prepared statement.
+
+Unset values are ignored, allowing prepared statements to be used without specify
+
+See https://issues.apache.org/jira/browse/CASSANDRA-7304 for further details on semantics.
+
+.. versionadded:: 2.6.0
+
+Only valid when using native protocol v4+
+"""
+
+NON_ALPHA_REGEX = re.compile('[^a-zA-Z0-9]')
+START_BADCHAR_REGEX = re.compile('^[^a-zA-Z0-9]*')
+END_BADCHAR_REGEX = re.compile('[^a-zA-Z0-9_]*$')
+
+_clean_name_cache = {}
+
+
+def _clean_column_name(name):
+    try:
+        return _clean_name_cache[name]
+    except KeyError:
+        clean = NON_ALPHA_REGEX.sub("_", START_BADCHAR_REGEX.sub("", END_BADCHAR_REGEX.sub("", name)))
+        _clean_name_cache[name] = clean
+        return clean
+
+
+def tuple_factory(colnames, rows):
+    """
+    Returns each row as a tuple
+
+    Example::
+
+        >>> from cassandra.query import tuple_factory
+        >>> session = cluster.connect('mykeyspace')
+        >>> session.row_factory = tuple_factory
+        >>> rows = session.execute("SELECT name, age FROM users LIMIT 1")
+        >>> print(rows[0])
+        ('Bob', 42)
+
+    .. versionchanged:: 2.0.0
+        moved from ``cassandra.decoder`` to ``cassandra.query``
+    """
+    return rows
+
+class PseudoNamedTupleRow(object):
+    """
+    Helper class for pseudo_named_tuple_factory. These objects provide an
+    __iter__ interface, as well as index- and attribute-based access to values,
+    but otherwise do not attempt to implement the full namedtuple or iterable
+    interface.
+    """
+    def __init__(self, ordered_dict):
+        self._dict = ordered_dict
+        self._tuple = tuple(ordered_dict.values())
+
+    def __getattr__(self, name):
+        return self._dict[name]
+
+    def __getitem__(self, idx):
+        return self._tuple[idx]
+
+    def __iter__(self):
+        return iter(self._tuple)
+
+    def __repr__(self):
+        return '{t}({od})'.format(t=self.__class__.__name__,
+                                  od=self._dict)
+
+
+def pseudo_namedtuple_factory(colnames, rows):
+    """
+    Returns each row as a :class:`.PseudoNamedTupleRow`. This is the fallback
+    factory for cases where :meth:`.named_tuple_factory` fails to create rows.
+    """
+    return [PseudoNamedTupleRow(od)
+            for od in ordered_dict_factory(colnames, rows)]
+
+
+def named_tuple_factory(colnames, rows):
+    """
+    Returns each row as a `namedtuple <https://docs.python.org/2/library/collections.html#collections.namedtuple>`_.
+    This is the default row factory.
+
+    Example::
+
+        >>> from cassandra.query import named_tuple_factory
+        >>> session = cluster.connect('mykeyspace')
+        >>> session.row_factory = named_tuple_factory
+        >>> rows = session.execute("SELECT name, age FROM users LIMIT 1")
+        >>> user = rows[0]
+
+        >>> # you can access field by their name:
+        >>> print("name: %s, age: %d" % (user.name, user.age))
+        name: Bob, age: 42
+
+        >>> # or you can access fields by their position (like a tuple)
+        >>> name, age = user
+        >>> print("name: %s, age: %d" % (name, age))
+        name: Bob, age: 42
+        >>> name = user[0]
+        >>> age = user[1]
+        >>> print("name: %s, age: %d" % (name, age))
+        name: Bob, age: 42
+
+    .. versionchanged:: 2.0.0
+        moved from ``cassandra.decoder`` to ``cassandra.query``
+    """
+    clean_column_names = map(_clean_column_name, colnames)
+    try:
+        Row = namedtuple('Row', clean_column_names)
+    except SyntaxError:
+        warnings.warn(
+            "Failed creating namedtuple for a result because there were too "
+            "many columns. This is due to a Python limitation that affects "
+            "namedtuple in Python 3.0-3.6 (see issue18896). The row will be "
+            "created with {substitute_factory_name}, which lacks some namedtuple "
+            "features and is slower. To avoid slower performance accessing "
+            "values on row objects, Upgrade to Python 3.7, or use a different "
+            "row factory. (column names: {colnames})".format(
+                substitute_factory_name=pseudo_namedtuple_factory.__name__,
+                colnames=colnames
+            )
+        )
+        return pseudo_namedtuple_factory(colnames, rows)
+    except Exception:
+        clean_column_names = list(map(_clean_column_name, colnames))  # create list because py3 map object will be consumed by first attempt
+        log.warning("Failed creating named tuple for results with column names %s (cleaned: %s) "
+                    "(see Python 'namedtuple' documentation for details on name rules). "
+                    "Results will be returned with positional names. "
+                    "Avoid this by choosing different names, using SELECT \"<col name>\" AS aliases, "
+                    "or specifying a different row_factory on your Session" %
+                    (colnames, clean_column_names))
+        Row = namedtuple('Row', _sanitize_identifiers(clean_column_names))
+
+    return [Row(*row) for row in rows]
+
+
+def dict_factory(colnames, rows):
+    """
+    Returns each row as a dict.
+
+    Example::
+
+        >>> from cassandra.query import dict_factory
+        >>> session = cluster.connect('mykeyspace')
+        >>> session.row_factory = dict_factory
+        >>> rows = session.execute("SELECT name, age FROM users LIMIT 1")
+        >>> print(rows[0])
+        {u'age': 42, u'name': u'Bob'}
+
+    .. versionchanged:: 2.0.0
+        moved from ``cassandra.decoder`` to ``cassandra.query``
+    """
+    return [dict(zip(colnames, row)) for row in rows]
+
+
+def ordered_dict_factory(colnames, rows):
+    """
+    Like :meth:`~cassandra.query.dict_factory`, but returns each row as an OrderedDict,
+    so the order of the columns is preserved.
+
+    .. versionchanged:: 2.0.0
+        moved from ``cassandra.decoder`` to ``cassandra.query``
+    """
+    return [OrderedDict(zip(colnames, row)) for row in rows]
+
+
+FETCH_SIZE_UNSET = object()
+
+
+class Statement(object):
+    """
+    An abstract class representing a single query. There are three subclasses:
+    :class:`.SimpleStatement`, :class:`.BoundStatement`, and :class:`.BatchStatement`.
+    These can be passed to :meth:`.Session.execute()`.
+    """
+
+    retry_policy = None
+    """
+    An instance of a :class:`cassandra.policies.RetryPolicy` or one of its
+    subclasses.  This controls when a query will be retried and how it
+    will be retried.
+    """
+
+    consistency_level = None
+    """
+    The :class:`.ConsistencyLevel` to be used for this operation.  Defaults
+    to :const:`None`, which means that the default consistency level for
+    the Session this is executed in will be used.
+    """
+
+    fetch_size = FETCH_SIZE_UNSET
+    """
+    How many rows will be fetched at a time.  This overrides the default
+    of :attr:`.Session.default_fetch_size`
+
+    This only takes effect when protocol version 2 or higher is used.
+    See :attr:`.Cluster.protocol_version` for details.
+
+    .. versionadded:: 2.0.0
+    """
+
+    keyspace = None
+    """
+    The string name of the keyspace this query acts on. This is used when
+    :class:`~.TokenAwarePolicy` is configured in the profile load balancing policy.
+
+    It is set implicitly on :class:`.BoundStatement`, and :class:`.BatchStatement`,
+    but must be set explicitly on :class:`.SimpleStatement`.
+
+    .. versionadded:: 2.1.3
+    """
+
+    custom_payload = None
+    """
+    :ref:`custom_payload` to be passed to the server.
+
+    These are only allowed when using protocol version 4 or higher.
+
+    .. versionadded:: 2.6.0
+    """
+
+    is_idempotent = False
+    """
+    Flag indicating whether this statement is safe to run multiple times in speculative execution.
+    """
+
+    _serial_consistency_level = None
+    _routing_key = None
+
+    def __init__(self, retry_policy=None, consistency_level=None, routing_key=None,
+                 serial_consistency_level=None, fetch_size=FETCH_SIZE_UNSET, keyspace=None, custom_payload=None,
+                 is_idempotent=False):
+        if retry_policy and not hasattr(retry_policy, 'on_read_timeout'):  # just checking one method to detect positional parameter errors
+            raise ValueError('retry_policy should implement cassandra.policies.RetryPolicy')
+        if retry_policy is not None:
+            self.retry_policy = retry_policy
+        if consistency_level is not None:
+            self.consistency_level = consistency_level
+        self._routing_key = routing_key
+        if serial_consistency_level is not None:
+            self.serial_consistency_level = serial_consistency_level
+        if fetch_size is not FETCH_SIZE_UNSET:
+            self.fetch_size = fetch_size
+        if keyspace is not None:
+            self.keyspace = keyspace
+        if custom_payload is not None:
+            self.custom_payload = custom_payload
+        self.is_idempotent = is_idempotent
+
+    def _key_parts_packed(self, parts):
+        for p in parts:
+            l = len(p)
+            yield struct.pack(">H%dsB" % l, l, p, 0)
+
+    def _get_routing_key(self):
+        return self._routing_key
+
+    def _set_routing_key(self, key):
+        if isinstance(key, (list, tuple)):
+            if len(key) == 1:
+                self._routing_key = key[0]
+            else:
+                self._routing_key = b"".join(self._key_parts_packed(key))
+        else:
+            self._routing_key = key
+
+    def _del_routing_key(self):
+        self._routing_key = None
+
+    routing_key = property(
+        _get_routing_key,
+        _set_routing_key,
+        _del_routing_key,
+        """
+        The :attr:`~.TableMetadata.partition_key` portion of the primary key,
+        which can be used to determine which nodes are replicas for the query.
+
+        If the partition key is a composite, a list or tuple must be passed in.
+        Each key component should be in its packed (binary) format, so all
+        components should be strings.
+        """)
+
+    def _get_serial_consistency_level(self):
+        return self._serial_consistency_level
+
+    def _set_serial_consistency_level(self, serial_consistency_level):
+        if (serial_consistency_level is not None and
+                not ConsistencyLevel.is_serial(serial_consistency_level)):
+            raise ValueError(
+                "serial_consistency_level must be either ConsistencyLevel.SERIAL "
+                "or ConsistencyLevel.LOCAL_SERIAL")
+        self._serial_consistency_level = serial_consistency_level
+
+    def _del_serial_consistency_level(self):
+        self._serial_consistency_level = None
+
+    serial_consistency_level = property(
+        _get_serial_consistency_level,
+        _set_serial_consistency_level,
+        _del_serial_consistency_level,
+        """
+        The serial consistency level is only used by conditional updates
+        (``INSERT``, ``UPDATE`` and ``DELETE`` with an ``IF`` condition).  For
+        those, the ``serial_consistency_level`` defines the consistency level of
+        the serial phase (or "paxos" phase) while the normal
+        :attr:`~.consistency_level` defines the consistency for the "learn" phase,
+        i.e. what type of reads will be guaranteed to see the update right away.
+        For example, if a conditional write has a :attr:`~.consistency_level` of
+        :attr:`~.ConsistencyLevel.QUORUM` (and is successful), then a
+        :attr:`~.ConsistencyLevel.QUORUM` read is guaranteed to see that write.
+        But if the regular :attr:`~.consistency_level` of that write is
+        :attr:`~.ConsistencyLevel.ANY`, then only a read with a
+        :attr:`~.consistency_level` of :attr:`~.ConsistencyLevel.SERIAL` is
+        guaranteed to see it (even a read with consistency
+        :attr:`~.ConsistencyLevel.ALL` is not guaranteed to be enough).
+
+        The serial consistency can only be one of :attr:`~.ConsistencyLevel.SERIAL`
+        or :attr:`~.ConsistencyLevel.LOCAL_SERIAL`. While ``SERIAL`` guarantees full
+        linearizability (with other ``SERIAL`` updates), ``LOCAL_SERIAL`` only
+        guarantees it in the local data center.
+
+        The serial consistency level is ignored for any query that is not a
+        conditional update. Serial reads should use the regular
+        :attr:`consistency_level`.
+
+        Serial consistency levels may only be used against Cassandra 2.0+
+        and the :attr:`~.Cluster.protocol_version` must be set to 2 or higher.
+
+        See :doc:`/lwt` for a discussion on how to work with results returned from
+        conditional statements.
+
+        .. versionadded:: 2.0.0
+        """)
+
+
+class SimpleStatement(Statement):
+    """
+    A simple, un-prepared query.
+    """
+
+    def __init__(self, query_string, retry_policy=None, consistency_level=None, routing_key=None,
+                 serial_consistency_level=None, fetch_size=FETCH_SIZE_UNSET, keyspace=None,
+                 custom_payload=None, is_idempotent=False):
+        """
+        `query_string` should be a literal CQL statement with the exception
+        of parameter placeholders that will be filled through the
+        `parameters` argument of :meth:`.Session.execute()`.
+
+        See :class:`Statement` attributes for a description of the other parameters.
+        """
+        Statement.__init__(self, retry_policy, consistency_level, routing_key,
+                           serial_consistency_level, fetch_size, keyspace, custom_payload, is_idempotent)
+        self._query_string = query_string
+
+    @property
+    def query_string(self):
+        return self._query_string
+
+    def __str__(self):
+        consistency = ConsistencyLevel.value_to_name.get(self.consistency_level, 'Not Set')
+        return (u'<SimpleStatement query="%s", consistency=%s>' %
+                (self.query_string, consistency))
+    __repr__ = __str__
+
+
+class PreparedStatement(object):
+    """
+    A statement that has been prepared against at least one Cassandra node.
+    Instances of this class should not be created directly, but through
+    :meth:`.Session.prepare()`.
+
+    A :class:`.PreparedStatement` should be prepared only once. Re-preparing a statement
+    may affect performance (as the operation requires a network roundtrip).
+
+    |prepared_stmt_head|: Do not use ``*`` in prepared statements if you might
+    change the schema of the table being queried. The driver and server each
+    maintain a map between metadata for a schema and statements that were
+    prepared against that schema. When a user changes a schema, e.g. by adding
+    or removing a column, the server invalidates its mappings involving that
+    schema. However, there is currently no way to propagate that invalidation
+    to drivers. Thus, after a schema change, the driver will incorrectly
+    interpret the results of ``SELECT *`` queries prepared before the schema
+    change. This is currently being addressed in `CASSANDRA-10786
+    <https://issues.apache.org/jira/browse/CASSANDRA-10786>`_.
+
+    .. |prepared_stmt_head| raw:: html
+
+       <b>A note about <code>*</code> in prepared statements</b>
+    """
+
+    column_metadata = None  #TODO: make this bind_metadata in next major
+    retry_policy = None
+    consistency_level = None
+    custom_payload = None
+    fetch_size = FETCH_SIZE_UNSET
+    keyspace = None  # change to prepared_keyspace in major release
+    protocol_version = None
+    query_id = None
+    query_string = None
+    result_metadata = None
+    result_metadata_id = None
+    column_encryption_policy = None
+    routing_key_indexes = None
+    _routing_key_index_set = None
+    serial_consistency_level = None  # TODO never used?
+
+    def __init__(self, column_metadata, query_id, routing_key_indexes, query,
+                 keyspace, protocol_version, result_metadata, result_metadata_id,
+                 column_encryption_policy=None):
+        self.column_metadata = column_metadata
+        self.query_id = query_id
+        self.routing_key_indexes = routing_key_indexes
+        self.query_string = query
+        self.keyspace = keyspace
+        self.protocol_version = protocol_version
+        self.result_metadata = result_metadata
+        self.result_metadata_id = result_metadata_id
+        self.column_encryption_policy = column_encryption_policy
+        self.is_idempotent = False
+
+    @classmethod
+    def from_message(cls, query_id, column_metadata, pk_indexes, cluster_metadata,
+                     query, prepared_keyspace, protocol_version, result_metadata,
+                     result_metadata_id, column_encryption_policy=None):
+        if not column_metadata:
+            return PreparedStatement(column_metadata, query_id, None,
+                                     query, prepared_keyspace, protocol_version, result_metadata,
+                                     result_metadata_id, column_encryption_policy)
+
+        if pk_indexes:
+            routing_key_indexes = pk_indexes
+        else:
+            routing_key_indexes = None
+
+            first_col = column_metadata[0]
+            ks_meta = cluster_metadata.keyspaces.get(first_col.keyspace_name)
+            if ks_meta:
+                table_meta = ks_meta.tables.get(first_col.table_name)
+                if table_meta:
+                    partition_key_columns = table_meta.partition_key
+
+                    # make a map of {column_name: index} for each column in the statement
+                    statement_indexes = dict((c.name, i) for i, c in enumerate(column_metadata))
+
+                    # a list of which indexes in the statement correspond to partition key items
+                    try:
+                        routing_key_indexes = [statement_indexes[c.name]
+                                               for c in partition_key_columns]
+                    except KeyError:  # we're missing a partition key component in the prepared
+                        pass          # statement; just leave routing_key_indexes as None
+
+        return PreparedStatement(column_metadata, query_id, routing_key_indexes,
+                                 query, prepared_keyspace, protocol_version, result_metadata,
+                                 result_metadata_id, column_encryption_policy)
+
+    def bind(self, values):
+        """
+        Creates and returns a :class:`BoundStatement` instance using `values`.
+
+        See :meth:`BoundStatement.bind` for rules on input ``values``.
+        """
+        return BoundStatement(self).bind(values)
+
+    def is_routing_key_index(self, i):
+        if self._routing_key_index_set is None:
+            self._routing_key_index_set = set(self.routing_key_indexes) if self.routing_key_indexes else set()
+        return i in self._routing_key_index_set
+
+    def __str__(self):
+        consistency = ConsistencyLevel.value_to_name.get(self.consistency_level, 'Not Set')
+        return (u'<PreparedStatement query="%s", consistency=%s>' %
+                (self.query_string, consistency))
+    __repr__ = __str__
+
+
+class BoundStatement(Statement):
+    """
+    A prepared statement that has been bound to a particular set of values.
+    These may be created directly or through :meth:`.PreparedStatement.bind()`.
+    """
+
+    prepared_statement = None
+    """
+    The :class:`PreparedStatement` instance that this was created from.
+    """
+
+    values = None
+    """
+    The sequence of values that were bound to the prepared statement.
+    """
+
+    def __init__(self, prepared_statement, retry_policy=None, consistency_level=None, routing_key=None,
+                 serial_consistency_level=None, fetch_size=FETCH_SIZE_UNSET, keyspace=None,
+                 custom_payload=None):
+        """
+        `prepared_statement` should be an instance of :class:`PreparedStatement`.
+
+        See :class:`Statement` attributes for a description of the other parameters.
+        """
+        self.prepared_statement = prepared_statement
+
+        self.retry_policy = prepared_statement.retry_policy
+        self.consistency_level = prepared_statement.consistency_level
+        self.serial_consistency_level = prepared_statement.serial_consistency_level
+        self.fetch_size = prepared_statement.fetch_size
+        self.custom_payload = prepared_statement.custom_payload
+        self.is_idempotent = prepared_statement.is_idempotent
+        self.values = []
+
+        meta = prepared_statement.column_metadata
+        if meta:
+            self.keyspace = meta[0].keyspace_name
+
+        Statement.__init__(self, retry_policy, consistency_level, routing_key,
+                           serial_consistency_level, fetch_size, keyspace, custom_payload,
+                           prepared_statement.is_idempotent)
+
+    def bind(self, values):
+        """
+        Binds a sequence of values for the prepared statement parameters
+        and returns this instance.  Note that `values` *must* be:
+
+        * a sequence, even if you are only binding one value, or
+        * a dict that relates 1-to-1 between dict keys and columns
+
+        .. versionchanged:: 2.6.0
+
+            :data:`~.UNSET_VALUE` was introduced. These can be bound as positional parameters
+            in a sequence, or by name in a dict. Additionally, when using protocol v4+:
+
+            * short sequences will be extended to match bind parameters with UNSET_VALUE
+            * names may be omitted from a dict with UNSET_VALUE implied.
+
+        .. versionchanged:: 3.0.0
+
+            method will not throw if extra keys are present in bound dict (PYTHON-178)
+        """
+        if values is None:
+            values = ()
+        proto_version = self.prepared_statement.protocol_version
+        col_meta = self.prepared_statement.column_metadata
+        ce_policy = self.prepared_statement.column_encryption_policy
+
+        # special case for binding dicts
+        if isinstance(values, dict):
+            values_dict = values
+            values = []
+
+            # sort values accordingly
+            for col in col_meta:
+                try:
+                    values.append(values_dict[col.name])
+                except KeyError:
+                    if proto_version >= 4:
+                        values.append(UNSET_VALUE)
+                    else:
+                        raise KeyError(
+                            'Column name `%s` not found in bound dict.' %
+                            (col.name))
+
+        value_len = len(values)
+        col_meta_len = len(col_meta)
+
+        if value_len > col_meta_len:
+            raise ValueError(
+                "Too many arguments provided to bind() (got %d, expected %d)" %
+                (len(values), len(col_meta)))
+
+        # this is fail-fast for clarity pre-v4. When v4 can be assumed,
+        # the error will be better reported when UNSET_VALUE is implicitly added.
+        if proto_version < 4 and self.prepared_statement.routing_key_indexes and \
+           value_len < len(self.prepared_statement.routing_key_indexes):
+            raise ValueError(
+                "Too few arguments provided to bind() (got %d, required %d for routing key)" %
+                (value_len, len(self.prepared_statement.routing_key_indexes)))
+
+        self.raw_values = values
+        self.values = []
+        for value, col_spec in zip(values, col_meta):
+            if value is None:
+                self.values.append(None)
+            elif value is UNSET_VALUE:
+                if proto_version >= 4:
+                    self._append_unset_value()
+                else:
+                    raise ValueError("Attempt to bind UNSET_VALUE while using unsuitable protocol version (%d < 4)" % proto_version)
+            else:
+                try:
+                    col_desc = ColDesc(col_spec.keyspace_name, col_spec.table_name, col_spec.name)
+                    uses_ce = ce_policy and ce_policy.contains_column(col_desc)
+                    col_type = ce_policy.column_type(col_desc) if uses_ce else col_spec.type
+                    col_bytes = col_type.serialize(value, proto_version)
+                    if uses_ce:
+                        col_bytes = ce_policy.encrypt(col_desc, col_bytes)
+                    self.values.append(col_bytes)
+                except (TypeError, struct.error) as exc:
+                    actual_type = type(value)
+                    message = ('Received an argument of invalid type for column "%s". '
+                               'Expected: %s, Got: %s; (%s)' % (col_spec.name, col_spec.type, actual_type, exc))
+                    raise TypeError(message)
+
+        if proto_version >= 4:
+            diff = col_meta_len - len(self.values)
+            if diff:
+                for _ in range(diff):
+                    self._append_unset_value()
+
+        return self
+
+    def _append_unset_value(self):
+        next_index = len(self.values)
+        if self.prepared_statement.is_routing_key_index(next_index):
+            col_meta = self.prepared_statement.column_metadata[next_index]
+            raise ValueError("Cannot bind UNSET_VALUE as a part of the routing key '%s'" % col_meta.name)
+        self.values.append(UNSET_VALUE)
+
+    @property
+    def routing_key(self):
+        if not self.prepared_statement.routing_key_indexes:
+            return None
+
+        if self._routing_key is not None:
+            return self._routing_key
+
+        routing_indexes = self.prepared_statement.routing_key_indexes
+        if len(routing_indexes) == 1:
+            self._routing_key = self.values[routing_indexes[0]]
+        else:
+            self._routing_key = b"".join(self._key_parts_packed(self.values[i] for i in routing_indexes))
+
+        return self._routing_key
+
+    def __str__(self):
+        consistency = ConsistencyLevel.value_to_name.get(self.consistency_level, 'Not Set')
+        return (u'<BoundStatement query="%s", values=%s, consistency=%s>' %
+                (self.prepared_statement.query_string, self.raw_values, consistency))
+    __repr__ = __str__
+
+
+class BatchType(object):
+    """
+    A BatchType is used with :class:`.BatchStatement` instances to control
+    the atomicity of the batch operation.
+
+    .. versionadded:: 2.0.0
+    """
+
+    LOGGED = None
+    """
+    Atomic batch operation.
+    """
+
+    UNLOGGED = None
+    """
+    Non-atomic batch operation.
+    """
+
+    COUNTER = None
+    """
+    Batches of counter operations.
+    """
+
+    def __init__(self, name, value):
+        self.name = name
+        self.value = value
+
+    def __str__(self):
+        return self.name
+
+    def __repr__(self):
+        return "BatchType.%s" % (self.name, )
+
+
+BatchType.LOGGED = BatchType("LOGGED", 0)
+BatchType.UNLOGGED = BatchType("UNLOGGED", 1)
+BatchType.COUNTER = BatchType("COUNTER", 2)
+
+
+class BatchStatement(Statement):
+    """
+    A protocol-level batch of operations which are applied atomically
+    by default.
+
+    .. versionadded:: 2.0.0
+    """
+
+    batch_type = None
+    """
+    The :class:`.BatchType` for the batch operation.  Defaults to
+    :attr:`.BatchType.LOGGED`.
+    """
+
+    serial_consistency_level = None
+    """
+    The same as :attr:`.Statement.serial_consistency_level`, but is only
+    supported when using protocol version 3 or higher.
+    """
+
+    _statements_and_parameters = None
+    _session = None
+
+    def __init__(self, batch_type=BatchType.LOGGED, retry_policy=None,
+                 consistency_level=None, serial_consistency_level=None,
+                 session=None, custom_payload=None):
+        """
+        `batch_type` specifies The :class:`.BatchType` for the batch operation.
+        Defaults to :attr:`.BatchType.LOGGED`.
+
+        `retry_policy` should be a :class:`~.RetryPolicy` instance for
+        controlling retries on the operation.
+
+        `consistency_level` should be a :class:`~.ConsistencyLevel` value
+        to be used for all operations in the batch.
+
+        `custom_payload` is a :ref:`custom_payload` passed to the server.
+        Note: as Statement objects are added to the batch, this map is
+        updated with any values found in their custom payloads. These are
+        only allowed when using protocol version 4 or higher.
+
+        Example usage:
+
+        .. code-block:: python
+
+            insert_user = session.prepare("INSERT INTO users (name, age) VALUES (?, ?)")
+            batch = BatchStatement(consistency_level=ConsistencyLevel.QUORUM)
+
+            for (name, age) in users_to_insert:
+                batch.add(insert_user, (name, age))
+
+            session.execute(batch)
+
+        You can also mix different types of operations within a batch:
+
+        .. code-block:: python
+
+            batch = BatchStatement()
+            batch.add(SimpleStatement("INSERT INTO users (name, age) VALUES (%s, %s)"), (name, age))
+            batch.add(SimpleStatement("DELETE FROM pending_users WHERE name=%s"), (name,))
+            session.execute(batch)
+
+        .. versionadded:: 2.0.0
+
+        .. versionchanged:: 2.1.0
+            Added `serial_consistency_level` as a parameter
+
+        .. versionchanged:: 2.6.0
+            Added `custom_payload` as a parameter
+        """
+        self.batch_type = batch_type
+        self._statements_and_parameters = []
+        self._session = session
+        Statement.__init__(self, retry_policy=retry_policy, consistency_level=consistency_level,
+                           serial_consistency_level=serial_consistency_level, custom_payload=custom_payload)
+
+    def clear(self):
+        """
+        This is a convenience method to clear a batch statement for reuse.
+
+        *Note:* it should not be used concurrently with uncompleted execution futures executing the same
+        ``BatchStatement``.
+        """
+        del self._statements_and_parameters[:]
+        self.keyspace = None
+        self.routing_key = None
+        if self.custom_payload:
+            self.custom_payload.clear()
+
+    def add(self, statement, parameters=None):
+        """
+        Adds a :class:`.Statement` and optional sequence of parameters
+        to be used with the statement to the batch.
+
+        Like with other statements, parameters must be a sequence, even
+        if there is only one item.
+        """
+        if isinstance(statement, str):
+            if parameters:
+                encoder = Encoder() if self._session is None else self._session.encoder
+                statement = bind_params(statement, parameters, encoder)
+            self._add_statement_and_params(False, statement, ())
+        elif isinstance(statement, PreparedStatement):
+            query_id = statement.query_id
+            bound_statement = statement.bind(() if parameters is None else parameters)
+            self._update_state(bound_statement)
+            self._add_statement_and_params(True, query_id, bound_statement.values)
+        elif isinstance(statement, BoundStatement):
+            if parameters:
+                raise ValueError(
+                    "Parameters cannot be passed with a BoundStatement "
+                    "to BatchStatement.add()")
+            self._update_state(statement)
+            self._add_statement_and_params(True, statement.prepared_statement.query_id, statement.values)
+        else:
+            # it must be a SimpleStatement
+            query_string = statement.query_string
+            if parameters:
+                encoder = Encoder() if self._session is None else self._session.encoder
+                query_string = bind_params(query_string, parameters, encoder)
+            self._update_state(statement)
+            self._add_statement_and_params(False, query_string, ())
+        return self
+
+    def add_all(self, statements, parameters):
+        """
+        Adds a sequence of :class:`.Statement` objects and a matching sequence
+        of parameters to the batch. Statement and parameter sequences must be of equal length or
+        one will be truncated. :const:`None` can be used in the parameters position where are needed.
+        """
+        for statement, value in zip(statements, parameters):
+            self.add(statement, value)
+
+    def _add_statement_and_params(self, is_prepared, statement, parameters):
+        if len(self._statements_and_parameters) >= 0xFFFF:
+            raise ValueError("Batch statement cannot contain more than %d statements." % 0xFFFF)
+        self._statements_and_parameters.append((is_prepared, statement, parameters))
+
+    def _maybe_set_routing_attributes(self, statement):
+        if self.routing_key is None:
+            if statement.keyspace and statement.routing_key:
+                self.routing_key = statement.routing_key
+                self.keyspace = statement.keyspace
+
+    def _update_custom_payload(self, statement):
+        if statement.custom_payload:
+            if self.custom_payload is None:
+                self.custom_payload = {}
+            self.custom_payload.update(statement.custom_payload)
+
+    def _update_state(self, statement):
+        self._maybe_set_routing_attributes(statement)
+        self._update_custom_payload(statement)
+
+    def __len__(self):
+        return len(self._statements_and_parameters)
+
+    def __str__(self):
+        consistency = ConsistencyLevel.value_to_name.get(self.consistency_level, 'Not Set')
+        return (u'<BatchStatement type=%s, statements=%d, consistency=%s>' %
+                (self.batch_type, len(self), consistency))
+    __repr__ = __str__
+
+
+ValueSequence = cassandra.encoder.ValueSequence
+"""
+A wrapper class that is used to specify that a sequence of values should
+be treated as a CQL list of values instead of a single column collection when used
+as part of the `parameters` argument for :meth:`.Session.execute()`.
+
+This is typically needed when supplying a list of keys to select.
+For example::
+
+    >>> my_user_ids = ('alice', 'bob', 'charles')
+    >>> query = "SELECT * FROM users WHERE user_id IN %s"
+    >>> session.execute(query, parameters=[ValueSequence(my_user_ids)])
+
+"""
+
+
+def bind_params(query, params, encoder):
+    if isinstance(params, dict):
+        return query % dict((k, encoder.cql_encode_all_types(v)) for k, v in params.items())
+    else:
+        return query % tuple(encoder.cql_encode_all_types(v) for v in params)
+
+
+class TraceUnavailable(Exception):
+    """
+    Raised when complete trace details cannot be fetched from Cassandra.
+    """
+    pass
+
+
+class QueryTrace(object):
+    """
+    A trace of the duration and events that occurred when executing
+    an operation.
+    """
+
+    trace_id = None
+    """
+    :class:`uuid.UUID` unique identifier for this tracing session.  Matches
+    the ``session_id`` column in ``system_traces.sessions`` and
+    ``system_traces.events``.
+    """
+
+    request_type = None
+    """
+    A string that very generally describes the traced operation.
+    """
+
+    duration = None
+    """
+    A :class:`datetime.timedelta` measure of the duration of the query.
+    """
+
+    client = None
+    """
+    The IP address of the client that issued this request
+
+    This is only available when using Cassandra 2.2+
+    """
+
+    coordinator = None
+    """
+    The IP address of the host that acted as coordinator for this request.
+    """
+
+    parameters = None
+    """
+    A :class:`dict` of parameters for the traced operation, such as the
+    specific query string.
+    """
+
+    started_at = None
+    """
+    A UTC :class:`datetime.datetime` object describing when the operation
+    was started.
+    """
+
+    events = None
+    """
+    A chronologically sorted list of :class:`.TraceEvent` instances
+    representing the steps the traced operation went through.  This
+    corresponds to the rows in ``system_traces.events`` for this tracing
+    session.
+    """
+
+    _session = None
+
+    _SELECT_SESSIONS_FORMAT = "SELECT * FROM system_traces.sessions WHERE session_id = %s"
+    _SELECT_EVENTS_FORMAT = "SELECT * FROM system_traces.events WHERE session_id = %s"
+    _BASE_RETRY_SLEEP = 0.003
+
+    def __init__(self, trace_id, session):
+        self.trace_id = trace_id
+        self._session = session
+
+    def populate(self, max_wait=2.0, wait_for_complete=True, query_cl=None):
+        """
+        Retrieves the actual tracing details from Cassandra and populates the
+        attributes of this instance.  Because tracing details are stored
+        asynchronously by Cassandra, this may need to retry the session
+        detail fetch.  If the trace is still not available after `max_wait`
+        seconds, :exc:`.TraceUnavailable` will be raised; if `max_wait` is
+        :const:`None`, this will retry forever.
+
+        `wait_for_complete=False` bypasses the wait for duration to be populated.
+        This can be used to query events from partial sessions.
+
+        `query_cl` specifies a consistency level to use for polling the trace tables,
+        if it should be different than the session default.
+        """
+        attempt = 0
+        start = time.time()
+        while True:
+            time_spent = time.time() - start
+            if max_wait is not None and time_spent >= max_wait:
+                raise TraceUnavailable(
+                    "Trace information was not available within %f seconds. Consider raising Session.max_trace_wait." % (max_wait,))
+
+            log.debug("Attempting to fetch trace info for trace ID: %s", self.trace_id)
+            session_results = self._execute(
+                SimpleStatement(self._SELECT_SESSIONS_FORMAT, consistency_level=query_cl), (self.trace_id,), time_spent, max_wait)
+
+            # PYTHON-730: There is race condition that the duration mutation is written before started_at the for fast queries
+            session_row = session_results.one() if session_results else None
+            is_complete = session_row is not None and session_row.duration is not None and session_row.started_at is not None
+            if not session_results or (wait_for_complete and not is_complete):
+                time.sleep(self._BASE_RETRY_SLEEP * (2 ** attempt))
+                attempt += 1
+                continue
+            if is_complete:
+                log.debug("Fetched trace info for trace ID: %s", self.trace_id)
+            else:
+                log.debug("Fetching parital trace info for trace ID: %s", self.trace_id)
+
+            self.request_type = session_row.request
+            self.duration = timedelta(microseconds=session_row.duration) if is_complete else None
+            self.started_at = session_row.started_at
+            self.coordinator = session_row.coordinator
+            self.parameters = session_row.parameters
+            # since C* 2.2
+            self.client = getattr(session_row, 'client', None)
+
+            log.debug("Attempting to fetch trace events for trace ID: %s", self.trace_id)
+            time_spent = time.time() - start
+            event_results = self._execute(
+                SimpleStatement(self._SELECT_EVENTS_FORMAT, consistency_level=query_cl), (self.trace_id,), time_spent, max_wait)
+            log.debug("Fetched trace events for trace ID: %s", self.trace_id)
+            self.events = tuple(TraceEvent(r.activity, r.event_id, r.source, r.source_elapsed, r.thread)
+                                for r in event_results)
+            break
+
+    def _execute(self, query, parameters, time_spent, max_wait):
+        timeout = (max_wait - time_spent) if max_wait is not None else None
+        future = self._session._create_response_future(query, parameters, trace=False, custom_payload=None, timeout=timeout)
+        # in case the user switched the row factory, set it to namedtuple for this query
+        future.row_factory = named_tuple_factory
+        future.send_request()
+
+        try:
+            return future.result()
+        except OperationTimedOut:
+            raise TraceUnavailable("Trace information was not available within %f seconds" % (max_wait,))
+
+    def __str__(self):
+        return "%s [%s] coordinator: %s, started at: %s, duration: %s, parameters: %s" \
+               % (self.request_type, self.trace_id, self.coordinator, self.started_at,
+                  self.duration, self.parameters)
+
+
+class TraceEvent(object):
+    """
+    Representation of a single event within a query trace.
+    """
+
+    description = None
+    """
+    A brief description of the event.
+    """
+
+    datetime = None
+    """
+    A UTC :class:`datetime.datetime` marking when the event occurred.
+    """
+
+    source = None
+    """
+    The IP address of the node this event occurred on.
+    """
+
+    source_elapsed = None
+    """
+    A :class:`datetime.timedelta` measuring the amount of time until
+    this event occurred starting from when :attr:`.source` first
+    received the query.
+    """
+
+    thread_name = None
+    """
+    The name of the thread that this event occurred on.
+    """
+
+    def __init__(self, description, timeuuid, source, source_elapsed, thread_name):
+        self.description = description
+        self.datetime = datetime.utcfromtimestamp(unix_time_from_uuid1(timeuuid))
+        self.source = source
+        if source_elapsed is not None:
+            self.source_elapsed = timedelta(microseconds=source_elapsed)
+        else:
+            self.source_elapsed = None
+        self.thread_name = thread_name
+
+    def __str__(self):
+        return "%s on %s[%s] at %s" % (self.description, self.source, self.thread_name, self.datetime)
+
+
+# TODO remove next major since we can target using the `host` attribute of session.execute
+class HostTargetingStatement(object):
+    """
+    Wraps any query statement and attaches a target host, making
+    it usable in a targeted LBP without modifying the user's statement.
+    """
+    def __init__(self, inner_statement, target_host):
+            self.__class__ = type(inner_statement.__class__.__name__,
+                                  (self.__class__, inner_statement.__class__),
+                                  {})
+            self.__dict__ = inner_statement.__dict__
+            self.target_host = target_host
diff --git a/llm/Lib/site-packages/cassandra/row_parser.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/row_parser.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..94c1e0b3c798064a859702af7a141b8afdd88f6d
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/row_parser.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/row_parser.pyx b/llm/Lib/site-packages/cassandra/row_parser.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..3d09ace94628dccd797a30c3094ca56d38dd34f2
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/row_parser.pyx
@@ -0,0 +1,50 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from cassandra.parsing cimport ParseDesc, ColumnParser
+from cassandra.policies import ColDesc
+from cassandra.obj_parser import TupleRowParser
+from cassandra.deserializers import make_deserializers
+
+include "ioutils.pyx"
+
+def make_recv_results_rows(ColumnParser colparser):
+    def recv_results_rows(self, f, int protocol_version, user_type_map, result_metadata, column_encryption_policy):
+        """
+        Parse protocol data given as a BytesIO f into a set of columns (e.g. list of tuples)
+        This is used as the recv_results_rows method of (Fast)ResultMessage
+        """
+        self.recv_results_metadata(f, user_type_map)
+
+        column_metadata = self.column_metadata or result_metadata
+
+        self.column_names = [md[2] for md in column_metadata]
+        self.column_types = [md[3] for md in column_metadata]
+
+        desc = ParseDesc(self.column_names, self.column_types, column_encryption_policy,
+                        [ColDesc(md[0], md[1], md[2]) for md in column_metadata],
+                        make_deserializers(self.column_types), protocol_version)
+        reader = BytesIOReader(f.read())
+        try:
+            self.parsed_rows = colparser.parse_rows(reader, desc)
+        except Exception as e:
+            # Use explicitly the TupleRowParser to display better error messages for column decoding failures
+            rowparser = TupleRowParser()
+            reader.buf_ptr = reader.buf
+            reader.pos = 0
+            rowcount = read_int(reader)
+            for i in range(rowcount):
+                rowparser.unpack_row(reader, desc)
+
+    return recv_results_rows
diff --git a/llm/Lib/site-packages/cassandra/segment.py b/llm/Lib/site-packages/cassandra/segment.py
new file mode 100644
index 0000000000000000000000000000000000000000..281329b3111f37c0df42b94532bea89b790b1d62
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/segment.py
@@ -0,0 +1,220 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import zlib
+
+from cassandra import DriverException
+from cassandra.marshal import int32_pack
+from cassandra.protocol import write_uint_le, read_uint_le
+
+CRC24_INIT = 0x875060
+CRC24_POLY = 0x1974F0B
+CRC24_LENGTH = 3
+CRC32_LENGTH = 4
+CRC32_INITIAL = zlib.crc32(b"\xfa\x2d\x55\xca")
+
+
+class CrcException(Exception):
+    """
+    CRC mismatch error.
+
+    TODO: here to avoid import cycles with cassandra.connection. In the next
+          major, the exceptions should be declared in a separated exceptions.py
+          file.
+    """
+    pass
+
+
+def compute_crc24(data, length):
+    crc = CRC24_INIT
+
+    for _ in range(length):
+        crc ^= (data & 0xff) << 16
+        data >>= 8
+
+        for i in range(8):
+            crc <<= 1
+            if crc & 0x1000000 != 0:
+                crc ^= CRC24_POLY
+
+    return crc
+
+
+def compute_crc32(data, value):
+    crc32 = zlib.crc32(data, value)
+    return crc32
+
+
+class SegmentHeader(object):
+
+    payload_length = None
+    uncompressed_payload_length = None
+    is_self_contained = None
+
+    def __init__(self, payload_length, uncompressed_payload_length, is_self_contained):
+        self.payload_length = payload_length
+        self.uncompressed_payload_length = uncompressed_payload_length
+        self.is_self_contained = is_self_contained
+
+    @property
+    def segment_length(self):
+        """
+        Return the total length of the segment, including the CRC.
+        """
+        hl = SegmentCodec.UNCOMPRESSED_HEADER_LENGTH if self.uncompressed_payload_length < 1 \
+            else SegmentCodec.COMPRESSED_HEADER_LENGTH
+        return hl + CRC24_LENGTH + self.payload_length + CRC32_LENGTH
+
+
+class Segment(object):
+
+    MAX_PAYLOAD_LENGTH = 128 * 1024 - 1
+
+    payload = None
+    is_self_contained = None
+
+    def __init__(self, payload, is_self_contained):
+        self.payload = payload
+        self.is_self_contained = is_self_contained
+
+
+class SegmentCodec(object):
+
+    COMPRESSED_HEADER_LENGTH = 5
+    UNCOMPRESSED_HEADER_LENGTH = 3
+    FLAG_OFFSET = 17
+
+    compressor = None
+    decompressor = None
+
+    def __init__(self, compressor=None, decompressor=None):
+        self.compressor = compressor
+        self.decompressor = decompressor
+
+    @property
+    def header_length(self):
+        return self.COMPRESSED_HEADER_LENGTH if self.compression \
+            else self.UNCOMPRESSED_HEADER_LENGTH
+
+    @property
+    def header_length_with_crc(self):
+        return (self.COMPRESSED_HEADER_LENGTH if self.compression
+                else self.UNCOMPRESSED_HEADER_LENGTH) + CRC24_LENGTH
+
+    @property
+    def compression(self):
+        return self.compressor and self.decompressor
+
+    def compress(self, data):
+        # the uncompressed length is already encoded in the header, so
+        # we remove it here
+        return self.compressor(data)[4:]
+
+    def decompress(self, encoded_data, uncompressed_length):
+        return self.decompressor(int32_pack(uncompressed_length) + encoded_data)
+
+    def encode_header(self, buffer, payload_length, uncompressed_length, is_self_contained):
+        if payload_length > Segment.MAX_PAYLOAD_LENGTH:
+            raise DriverException('Payload length exceed Segment.MAX_PAYLOAD_LENGTH')
+
+        header_data = payload_length
+
+        flag_offset = self.FLAG_OFFSET
+        if self.compression:
+            header_data |= uncompressed_length << flag_offset
+            flag_offset += 17
+
+        if is_self_contained:
+            header_data |= 1 << flag_offset
+
+        write_uint_le(buffer, header_data, size=self.header_length)
+        header_crc = compute_crc24(header_data, self.header_length)
+        write_uint_le(buffer, header_crc, size=CRC24_LENGTH)
+
+    def _encode_segment(self, buffer, payload, is_self_contained):
+        """
+        Encode a message to a single segment.
+        """
+        uncompressed_payload = payload
+        uncompressed_payload_length = len(payload)
+
+        if self.compression:
+            compressed_payload = self.compress(uncompressed_payload)
+            if len(compressed_payload) >= uncompressed_payload_length:
+                encoded_payload = uncompressed_payload
+                uncompressed_payload_length = 0
+            else:
+                encoded_payload = compressed_payload
+        else:
+            encoded_payload = uncompressed_payload
+
+        payload_length = len(encoded_payload)
+        self.encode_header(buffer, payload_length, uncompressed_payload_length, is_self_contained)
+        payload_crc = compute_crc32(encoded_payload, CRC32_INITIAL)
+        buffer.write(encoded_payload)
+        write_uint_le(buffer, payload_crc)
+
+    def encode(self, buffer, msg):
+        """
+        Encode a message to one of more segments.
+        """
+        msg_length = len(msg)
+
+        if msg_length > Segment.MAX_PAYLOAD_LENGTH:
+            payloads = []
+            for i in range(0, msg_length, Segment.MAX_PAYLOAD_LENGTH):
+                payloads.append(msg[i:i + Segment.MAX_PAYLOAD_LENGTH])
+        else:
+            payloads = [msg]
+
+        is_self_contained = len(payloads) == 1
+        for payload in payloads:
+            self._encode_segment(buffer, payload, is_self_contained)
+
+    def decode_header(self, buffer):
+        header_data = read_uint_le(buffer, self.header_length)
+
+        expected_header_crc = read_uint_le(buffer, CRC24_LENGTH)
+        actual_header_crc = compute_crc24(header_data, self.header_length)
+        if actual_header_crc != expected_header_crc:
+            raise CrcException('CRC mismatch on header {:x}. Received {:x}", computed {:x}.'.format(
+                header_data, expected_header_crc, actual_header_crc))
+
+        payload_length = header_data & Segment.MAX_PAYLOAD_LENGTH
+        header_data >>= 17
+
+        if self.compression:
+            uncompressed_payload_length = header_data & Segment.MAX_PAYLOAD_LENGTH
+            header_data >>= 17
+        else:
+            uncompressed_payload_length = -1
+
+        is_self_contained = (header_data & 1) == 1
+
+        return SegmentHeader(payload_length, uncompressed_payload_length, is_self_contained)
+
+    def decode(self, buffer, header):
+        encoded_payload = buffer.read(header.payload_length)
+        expected_payload_crc = read_uint_le(buffer)
+
+        actual_payload_crc = compute_crc32(encoded_payload, CRC32_INITIAL)
+        if actual_payload_crc != expected_payload_crc:
+            raise CrcException('CRC mismatch on payload. Received {:x}", computed {:x}.'.format(
+                expected_payload_crc, actual_payload_crc))
+
+        payload = encoded_payload
+        if self.compression and header.uncompressed_payload_length > 0:
+            payload = self.decompress(encoded_payload, header.uncompressed_payload_length)
+
+        return Segment(payload, header.is_self_contained)
diff --git a/llm/Lib/site-packages/cassandra/timestamps.py b/llm/Lib/site-packages/cassandra/timestamps.py
new file mode 100644
index 0000000000000000000000000000000000000000..fc5819b31d9f9d5502c344090548a830c397aed5
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/timestamps.py
@@ -0,0 +1,109 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+This module contains utilities for generating timestamps for client-side
+timestamp specification.
+"""
+
+import logging
+import time
+from threading import Lock
+
+log = logging.getLogger(__name__)
+
+class MonotonicTimestampGenerator(object):
+    """
+    An object that, when called, returns ``int(time.time() * 1e6)`` when
+    possible, but, if the value returned by ``time.time`` doesn't increase,
+    drifts into the future and logs warnings.
+    Exposed configuration attributes can be configured with arguments to
+    ``__init__`` or by changing attributes on an initialized object.
+
+    .. versionadded:: 3.8.0
+    """
+
+    warn_on_drift = True
+    """
+    If true, log warnings when timestamps drift into the future as allowed by
+    :attr:`warning_threshold` and :attr:`warning_interval`.
+    """
+
+    warning_threshold = 1
+    """
+    This object will only issue warnings when the returned timestamp drifts
+    more than ``warning_threshold`` seconds into the future.
+    Defaults to 1 second.
+    """
+
+    warning_interval = 1
+    """
+    This object will only issue warnings every ``warning_interval`` seconds.
+    Defaults to 1 second.
+    """
+
+    def __init__(self, warn_on_drift=True, warning_threshold=1, warning_interval=1):
+        self.lock = Lock()
+        with self.lock:
+            self.last = 0
+            self._last_warn = 0
+        self.warn_on_drift = warn_on_drift
+        self.warning_threshold = warning_threshold
+        self.warning_interval = warning_interval
+
+    def _next_timestamp(self, now, last):
+        """
+        Returns the timestamp that should be used if ``now`` is the current
+        time and ``last`` is the last timestamp returned by this object.
+        Intended for internal and testing use only; to generate timestamps,
+        call an instantiated ``MonotonicTimestampGenerator`` object.
+
+        :param int now: an integer to be used as the current time, typically
+            representing the current time in microseconds since the UNIX epoch
+        :param int last: an integer representing the last timestamp returned by
+            this object
+        """
+        if now > last:
+            self.last = now
+            return now
+        else:
+            self._maybe_warn(now=now)
+            self.last = last + 1
+            return self.last
+
+    def __call__(self):
+        """
+        Makes ``MonotonicTimestampGenerator`` objects callable; defers
+        internally to _next_timestamp.
+        """
+        with self.lock:
+            return self._next_timestamp(now=int(time.time() * 1e6),
+                                        last=self.last)
+
+    def _maybe_warn(self, now):
+        # should be called from inside the self.lock.
+        diff = self.last - now
+        since_last_warn = now - self._last_warn
+
+        warn = (self.warn_on_drift and
+                (diff >= self.warning_threshold * 1e6) and
+                (since_last_warn >= self.warning_interval * 1e6))
+        if warn:
+            log.warning(
+                "Clock skew detected: current tick ({now}) was {diff} "
+                "microseconds behind the last generated timestamp "
+                "({last}), returned timestamps will be artificially "
+                "incremented to guarantee monotonicity.".format(
+                    now=now, diff=diff, last=self.last))
+            self._last_warn = now
diff --git a/llm/Lib/site-packages/cassandra/tuple.pxd b/llm/Lib/site-packages/cassandra/tuple.pxd
new file mode 100644
index 0000000000000000000000000000000000000000..3cc54d5beed32fb0e07734d64f46f541c3af59e7
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/tuple.pxd
@@ -0,0 +1,41 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from cpython.tuple cimport (
+        PyTuple_New,
+        # Return value: New reference.
+        # Return a new tuple object of size len, or NULL on failure.
+        PyTuple_SET_ITEM,
+        # Like PyTuple_SetItem(), but does no error checking, and should
+        # only be used to fill in brand new tuples. Note: This function
+        # ``steals'' a reference to o.
+        )
+
+from cpython.ref cimport (
+        Py_INCREF
+        # void Py_INCREF(object o)
+        #     Increment the reference count for object o. The object must not
+        #     be NULL; if you aren't sure that it isn't NULL, use
+        #     Py_XINCREF().
+        )
+
+cdef inline tuple tuple_new(Py_ssize_t n):
+    """Allocate a new tuple object"""
+    return PyTuple_New(n)
+
+cdef inline void tuple_set(tuple tup, Py_ssize_t idx, object item):
+    """Insert new object into tuple. No item must have been set yet."""
+    # PyTuple_SET_ITEM steals a reference, so we need to INCREF
+    Py_INCREF(item)
+    PyTuple_SET_ITEM(tup, idx, item)
diff --git a/llm/Lib/site-packages/cassandra/type_codes.pxd b/llm/Lib/site-packages/cassandra/type_codes.pxd
new file mode 100644
index 0000000000000000000000000000000000000000..c78cd07c1a58b824d120a53ae76feda6d1b10dc6
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/type_codes.pxd
@@ -0,0 +1,42 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+cdef enum:
+    CUSTOM_TYPE
+    AsciiType
+    LongType
+    BytesType
+    BooleanType
+    CounterColumnType
+    DecimalType
+    DoubleType
+    FloatType
+    Int32Type
+    UTF8Type
+    DateType
+    UUIDType
+    VarcharType
+    IntegerType
+    TimeUUIDType
+    InetAddressType
+    SimpleDateType
+    TimeType
+    ShortType
+    ByteType
+    ListType
+    MapType
+    SetType
+    UserType
+    TupleType
+
diff --git a/llm/Lib/site-packages/cassandra/type_codes.py b/llm/Lib/site-packages/cassandra/type_codes.py
new file mode 100644
index 0000000000000000000000000000000000000000..b63248d68e28780d270ae33e4844e30755f6ec05
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/type_codes.py
@@ -0,0 +1,67 @@
+"""
+Module with constants for Cassandra type codes.
+
+These constants are useful for
+
+    a) mapping messages to cqltypes                (cassandra/cqltypes.py)
+    b) optimized dispatching for (de)serialization (cassandra/encoding.py)
+
+Type codes are repeated here from the Cassandra binary protocol specification:
+
+            0x0000    Custom: the value is a [string], see above.
+            0x0001    Ascii
+            0x0002    Bigint
+            0x0003    Blob
+            0x0004    Boolean
+            0x0005    Counter
+            0x0006    Decimal
+            0x0007    Double
+            0x0008    Float
+            0x0009    Int
+            0x000A    Text
+            0x000B    Timestamp
+            0x000C    Uuid
+            0x000D    Varchar
+            0x000E    Varint
+            0x000F    Timeuuid
+            0x0010    Inet
+            0x0011    SimpleDateType
+            0x0012    TimeType
+            0x0013    ShortType
+            0x0014    ByteType
+            0x0015    DurationType
+            0x0020    List: the value is an [option], representing the type
+                            of the elements of the list.
+            0x0021    Map: the value is two [option], representing the types of the
+                           keys and values of the map
+            0x0022    Set: the value is an [option], representing the type
+                            of the elements of the set
+"""
+
+CUSTOM_TYPE = 0x0000
+AsciiType = 0x0001
+LongType = 0x0002
+BytesType = 0x0003
+BooleanType = 0x0004
+CounterColumnType = 0x0005
+DecimalType = 0x0006
+DoubleType = 0x0007
+FloatType = 0x0008
+Int32Type = 0x0009
+UTF8Type = 0x000A
+DateType = 0x000B
+UUIDType = 0x000C
+VarcharType = 0x000D
+IntegerType = 0x000E
+TimeUUIDType = 0x000F
+InetAddressType = 0x0010
+SimpleDateType = 0x0011
+TimeType = 0x0012
+ShortType = 0x0013
+ByteType = 0x0014
+DurationType = 0x0015
+ListType = 0x0020
+MapType = 0x0021
+SetType = 0x0022
+UserType = 0x0030
+TupleType = 0x0031
diff --git a/llm/Lib/site-packages/cassandra/util.cp311-win_amd64.pyd b/llm/Lib/site-packages/cassandra/util.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..22dc94e7e72ac606e6b14f024604e657ba740895
Binary files /dev/null and b/llm/Lib/site-packages/cassandra/util.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/cassandra/util.py b/llm/Lib/site-packages/cassandra/util.py
new file mode 100644
index 0000000000000000000000000000000000000000..cc35e0b6578c2822fe4ec03d372f0fa9a9a20fb0
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra/util.py
@@ -0,0 +1,1803 @@
+# Copyright DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import with_statement
+from _weakref import ref
+import calendar
+from collections import OrderedDict
+from collections.abc import Mapping
+import datetime
+from functools import total_ordering
+from itertools import chain
+import keyword
+import logging
+import pickle
+import random
+import re
+import socket
+import sys
+import time
+import uuid
+
+_HAS_GEOMET = True
+try:
+    from geomet import wkt
+except:
+    _HAS_GEOMET = False
+
+
+from cassandra import DriverException
+
+DATETIME_EPOC = datetime.datetime(1970, 1, 1)
+UTC_DATETIME_EPOC = datetime.datetime.utcfromtimestamp(0)
+
+_nan = float('nan')
+
+log = logging.getLogger(__name__)
+
+assert sys.byteorder in ('little', 'big')
+is_little_endian = sys.byteorder == 'little'
+
+
+def datetime_from_timestamp(timestamp):
+    """
+    Creates a timezone-agnostic datetime from timestamp (in seconds) in a consistent manner.
+    Works around a Windows issue with large negative timestamps (PYTHON-119),
+    and rounding differences in Python 3.4 (PYTHON-340).
+
+    :param timestamp: a unix timestamp, in seconds
+    """
+    dt = DATETIME_EPOC + datetime.timedelta(seconds=timestamp)
+    return dt
+
+
+def utc_datetime_from_ms_timestamp(timestamp):
+    """
+    Creates a UTC datetime from a timestamp in milliseconds. See
+    :meth:`datetime_from_timestamp`.
+
+    Raises an `OverflowError` if the timestamp is out of range for
+    :class:`~datetime.datetime`.
+
+    :param timestamp: timestamp, in milliseconds
+    """
+    return UTC_DATETIME_EPOC + datetime.timedelta(milliseconds=timestamp)
+
+
+def ms_timestamp_from_datetime(dt):
+    """
+    Converts a datetime to a timestamp expressed in milliseconds.
+
+    :param dt: a :class:`datetime.datetime`
+    """
+    return int(round((dt - UTC_DATETIME_EPOC).total_seconds() * 1000))
+
+
+def unix_time_from_uuid1(uuid_arg):
+    """
+    Converts a version 1 :class:`uuid.UUID` to a timestamp with the same precision
+    as :meth:`time.time()` returns.  This is useful for examining the
+    results of queries returning a v1 :class:`~uuid.UUID`.
+
+    :param uuid_arg: a version 1 :class:`~uuid.UUID`
+    """
+    return (uuid_arg.time - 0x01B21DD213814000) / 1e7
+
+
+def datetime_from_uuid1(uuid_arg):
+    """
+    Creates a timezone-agnostic datetime from the timestamp in the
+    specified type-1 UUID.
+
+    :param uuid_arg: a version 1 :class:`~uuid.UUID`
+    """
+    return datetime_from_timestamp(unix_time_from_uuid1(uuid_arg))
+
+
+def min_uuid_from_time(timestamp):
+    """
+    Generates the minimum TimeUUID (type 1) for a given timestamp, as compared by Cassandra.
+
+    See :func:`uuid_from_time` for argument and return types.
+    """
+    return uuid_from_time(timestamp, 0x808080808080, 0x80)  # Cassandra does byte-wise comparison; fill with min signed bytes (0x80 = -128)
+
+
+def max_uuid_from_time(timestamp):
+    """
+    Generates the maximum TimeUUID (type 1) for a given timestamp, as compared by Cassandra.
+
+    See :func:`uuid_from_time` for argument and return types.
+    """
+    return uuid_from_time(timestamp, 0x7f7f7f7f7f7f, 0x3f7f)  # Max signed bytes (0x7f = 127)
+
+
+def uuid_from_time(time_arg, node=None, clock_seq=None):
+    """
+    Converts a datetime or timestamp to a type 1 :class:`uuid.UUID`.
+
+    :param time_arg:
+      The time to use for the timestamp portion of the UUID.
+      This can either be a :class:`datetime` object or a timestamp
+      in seconds (as returned from :meth:`time.time()`).
+    :type datetime: :class:`datetime` or timestamp
+
+    :param node:
+      None integer for the UUID (up to 48 bits). If not specified, this
+      field is randomized.
+    :type node: long
+
+    :param clock_seq:
+      Clock sequence field for the UUID (up to 14 bits). If not specified,
+      a random sequence is generated.
+    :type clock_seq: int
+
+    :rtype: :class:`uuid.UUID`
+
+    """
+    if hasattr(time_arg, 'utctimetuple'):
+        seconds = int(calendar.timegm(time_arg.utctimetuple()))
+        microseconds = (seconds * 1e6) + time_arg.time().microsecond
+    else:
+        microseconds = int(time_arg * 1e6)
+
+    # 0x01b21dd213814000 is the number of 100-ns intervals between the
+    # UUID epoch 1582-10-15 00:00:00 and the Unix epoch 1970-01-01 00:00:00.
+    intervals = int(microseconds * 10) + 0x01b21dd213814000
+
+    time_low = intervals & 0xffffffff
+    time_mid = (intervals >> 32) & 0xffff
+    time_hi_version = (intervals >> 48) & 0x0fff
+
+    if clock_seq is None:
+        clock_seq = random.getrandbits(14)
+    else:
+        if clock_seq > 0x3fff:
+            raise ValueError('clock_seq is out of range (need a 14-bit value)')
+
+    clock_seq_low = clock_seq & 0xff
+    clock_seq_hi_variant = 0x80 | ((clock_seq >> 8) & 0x3f)
+
+    if node is None:
+        node = random.getrandbits(48)
+
+    return uuid.UUID(fields=(time_low, time_mid, time_hi_version,
+                             clock_seq_hi_variant, clock_seq_low, node), version=1)
+
+LOWEST_TIME_UUID = uuid.UUID('00000000-0000-1000-8080-808080808080')
+""" The lowest possible TimeUUID, as sorted by Cassandra. """
+
+HIGHEST_TIME_UUID = uuid.UUID('ffffffff-ffff-1fff-bf7f-7f7f7f7f7f7f')
+""" The highest possible TimeUUID, as sorted by Cassandra. """
+
+
+def _addrinfo_or_none(contact_point, port):
+    """
+    A helper function that wraps socket.getaddrinfo and returns None
+    when it fails to, e.g. resolve one of the hostnames. Used to address
+    PYTHON-895.
+    """
+    try:
+        value = socket.getaddrinfo(contact_point, port,
+                                  socket.AF_UNSPEC, socket.SOCK_STREAM)
+        return value
+    except socket.gaierror:
+        log.debug('Could not resolve hostname "{}" '
+                  'with port {}'.format(contact_point, port))
+        return None
+
+
+def _addrinfo_to_ip_strings(addrinfo):
+    """
+    Helper function that consumes the data output by socket.getaddrinfo and
+    extracts the IP address from the sockaddr portion of the result.
+
+    Since this is meant to be used in conjunction with _addrinfo_or_none,
+    this will pass None and EndPoint instances through unaffected.
+    """
+    if addrinfo is None:
+        return None
+    return [(entry[4][0], entry[4][1]) for entry in addrinfo]
+
+
+def _resolve_contact_points_to_string_map(contact_points):
+    return OrderedDict(
+        ('{cp}:{port}'.format(cp=cp, port=port), _addrinfo_to_ip_strings(_addrinfo_or_none(cp, port)))
+        for cp, port in contact_points
+    )
+
+
+class _IterationGuard(object):
+    # This context manager registers itself in the current iterators of the
+    # weak container, such as to delay all removals until the context manager
+    # exits.
+    # This technique should be relatively thread-safe (since sets are).
+
+    def __init__(self, weakcontainer):
+        # Don't create cycles
+        self.weakcontainer = ref(weakcontainer)
+
+    def __enter__(self):
+        w = self.weakcontainer()
+        if w is not None:
+            w._iterating.add(self)
+        return self
+
+    def __exit__(self, e, t, b):
+        w = self.weakcontainer()
+        if w is not None:
+            s = w._iterating
+            s.remove(self)
+            if not s:
+                w._commit_removals()
+
+
+class WeakSet(object):
+    def __init__(self, data=None):
+        self.data = set()
+
+        def _remove(item, selfref=ref(self)):
+            self = selfref()
+            if self is not None:
+                if self._iterating:
+                    self._pending_removals.append(item)
+                else:
+                    self.data.discard(item)
+
+        self._remove = _remove
+        # A list of keys to be removed
+        self._pending_removals = []
+        self._iterating = set()
+        if data is not None:
+            self.update(data)
+
+    def _commit_removals(self):
+        l = self._pending_removals
+        discard = self.data.discard
+        while l:
+            discard(l.pop())
+
+    def __iter__(self):
+        with _IterationGuard(self):
+            for itemref in self.data:
+                item = itemref()
+                if item is not None:
+                    yield item
+
+    def __len__(self):
+        return sum(x() is not None for x in self.data)
+
+    def __contains__(self, item):
+        return ref(item) in self.data
+
+    def __reduce__(self):
+        return (self.__class__, (list(self),),
+                getattr(self, '__dict__', None))
+
+    __hash__ = None
+
+    def add(self, item):
+        if self._pending_removals:
+            self._commit_removals()
+        self.data.add(ref(item, self._remove))
+
+    def clear(self):
+        if self._pending_removals:
+            self._commit_removals()
+        self.data.clear()
+
+    def copy(self):
+        return self.__class__(self)
+
+    def pop(self):
+        if self._pending_removals:
+            self._commit_removals()
+        while True:
+            try:
+                itemref = self.data.pop()
+            except KeyError:
+                raise KeyError('pop from empty WeakSet')
+            item = itemref()
+            if item is not None:
+                return item
+
+    def remove(self, item):
+        if self._pending_removals:
+            self._commit_removals()
+        self.data.remove(ref(item))
+
+    def discard(self, item):
+        if self._pending_removals:
+            self._commit_removals()
+        self.data.discard(ref(item))
+
+    def update(self, other):
+        if self._pending_removals:
+            self._commit_removals()
+        if isinstance(other, self.__class__):
+            self.data.update(other.data)
+        else:
+            for element in other:
+                self.add(element)
+
+    def __ior__(self, other):
+        self.update(other)
+        return self
+
+    # Helper functions for simple delegating methods.
+    def _apply(self, other, method):
+        if not isinstance(other, self.__class__):
+            other = self.__class__(other)
+        newdata = method(other.data)
+        newset = self.__class__()
+        newset.data = newdata
+        return newset
+
+    def difference(self, other):
+        return self._apply(other, self.data.difference)
+    __sub__ = difference
+
+    def difference_update(self, other):
+        if self._pending_removals:
+            self._commit_removals()
+        if self is other:
+            self.data.clear()
+        else:
+            self.data.difference_update(ref(item) for item in other)
+
+    def __isub__(self, other):
+        if self._pending_removals:
+            self._commit_removals()
+        if self is other:
+            self.data.clear()
+        else:
+            self.data.difference_update(ref(item) for item in other)
+        return self
+
+    def intersection(self, other):
+        return self._apply(other, self.data.intersection)
+    __and__ = intersection
+
+    def intersection_update(self, other):
+        if self._pending_removals:
+            self._commit_removals()
+        self.data.intersection_update(ref(item) for item in other)
+
+    def __iand__(self, other):
+        if self._pending_removals:
+            self._commit_removals()
+        self.data.intersection_update(ref(item) for item in other)
+        return self
+
+    def issubset(self, other):
+        return self.data.issubset(ref(item) for item in other)
+    __lt__ = issubset
+
+    def __le__(self, other):
+        return self.data <= set(ref(item) for item in other)
+
+    def issuperset(self, other):
+        return self.data.issuperset(ref(item) for item in other)
+    __gt__ = issuperset
+
+    def __ge__(self, other):
+        return self.data >= set(ref(item) for item in other)
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self.data == set(ref(item) for item in other)
+
+    def symmetric_difference(self, other):
+        return self._apply(other, self.data.symmetric_difference)
+    __xor__ = symmetric_difference
+
+    def symmetric_difference_update(self, other):
+        if self._pending_removals:
+            self._commit_removals()
+        if self is other:
+            self.data.clear()
+        else:
+            self.data.symmetric_difference_update(ref(item) for item in other)
+
+    def __ixor__(self, other):
+        if self._pending_removals:
+            self._commit_removals()
+        if self is other:
+            self.data.clear()
+        else:
+            self.data.symmetric_difference_update(ref(item) for item in other)
+        return self
+
+    def union(self, other):
+        return self._apply(other, self.data.union)
+    __or__ = union
+
+    def isdisjoint(self, other):
+        return len(self.intersection(other)) == 0
+
+
+class SortedSet(object):
+    '''
+    A sorted set based on sorted list
+
+    A sorted set implementation is used in this case because it does not
+    require its elements to be immutable/hashable.
+
+    #Not implemented: update functions, inplace operators
+    '''
+
+    def __init__(self, iterable=()):
+        self._items = []
+        self.update(iterable)
+
+    def __len__(self):
+        return len(self._items)
+
+    def __getitem__(self, i):
+        return self._items[i]
+
+    def __iter__(self):
+        return iter(self._items)
+
+    def __reversed__(self):
+        return reversed(self._items)
+
+    def __repr__(self):
+        return '%s(%r)' % (
+            self.__class__.__name__,
+            self._items)
+
+    def __reduce__(self):
+        return self.__class__, (self._items,)
+
+    def __eq__(self, other):
+        if isinstance(other, self.__class__):
+            return self._items == other._items
+        else:
+            try:
+                return len(other) == len(self._items) and all(item in self for item in other)
+            except TypeError:
+                return NotImplemented
+
+    def __ne__(self, other):
+        if isinstance(other, self.__class__):
+            return self._items != other._items
+        else:
+            try:
+                return len(other) != len(self._items) or any(item not in self for item in other)
+            except TypeError:
+                return NotImplemented
+
+    def __le__(self, other):
+        return self.issubset(other)
+
+    def __lt__(self, other):
+        return len(other) > len(self._items) and self.issubset(other)
+
+    def __ge__(self, other):
+        return self.issuperset(other)
+
+    def __gt__(self, other):
+        return len(self._items) > len(other) and self.issuperset(other)
+
+    def __and__(self, other):
+        return self._intersect(other)
+    __rand__ = __and__
+
+    def __iand__(self, other):
+        isect = self._intersect(other)
+        self._items = isect._items
+        return self
+
+    def __or__(self, other):
+        return self.union(other)
+    __ror__ = __or__
+
+    def __ior__(self, other):
+        union = self.union(other)
+        self._items = union._items
+        return self
+
+    def __sub__(self, other):
+        return self._diff(other)
+
+    def __rsub__(self, other):
+        return sortedset(other) - self
+
+    def __isub__(self, other):
+        diff = self._diff(other)
+        self._items = diff._items
+        return self
+
+    def __xor__(self, other):
+        return self.symmetric_difference(other)
+    __rxor__ = __xor__
+
+    def __ixor__(self, other):
+        sym_diff = self.symmetric_difference(other)
+        self._items = sym_diff._items
+        return self
+
+    def __contains__(self, item):
+        i = self._find_insertion(item)
+        return i < len(self._items) and self._items[i] == item
+
+    def __delitem__(self, i):
+        del self._items[i]
+
+    def __delslice__(self, i, j):
+        del self._items[i:j]
+
+    def add(self, item):
+        i = self._find_insertion(item)
+        if i < len(self._items):
+            if self._items[i] != item:
+                self._items.insert(i, item)
+        else:
+            self._items.append(item)
+
+    def update(self, iterable):
+        for i in iterable:
+            self.add(i)
+
+    def clear(self):
+        del self._items[:]
+
+    def copy(self):
+        new = sortedset()
+        new._items = list(self._items)
+        return new
+
+    def isdisjoint(self, other):
+        return len(self._intersect(other)) == 0
+
+    def issubset(self, other):
+        return len(self._intersect(other)) == len(self._items)
+
+    def issuperset(self, other):
+        return len(self._intersect(other)) == len(other)
+
+    def pop(self):
+        if not self._items:
+            raise KeyError("pop from empty set")
+        return self._items.pop()
+
+    def remove(self, item):
+        i = self._find_insertion(item)
+        if i < len(self._items):
+            if self._items[i] == item:
+                self._items.pop(i)
+                return
+        raise KeyError('%r' % item)
+
+    def union(self, *others):
+        union = sortedset()
+        union._items = list(self._items)
+        for other in others:
+            for item in other:
+                union.add(item)
+        return union
+
+    def intersection(self, *others):
+        isect = self.copy()
+        for other in others:
+            isect = isect._intersect(other)
+            if not isect:
+                break
+        return isect
+
+    def difference(self, *others):
+        diff = self.copy()
+        for other in others:
+            diff = diff._diff(other)
+            if not diff:
+                break
+        return diff
+
+    def symmetric_difference(self, other):
+        diff_self_other = self._diff(other)
+        diff_other_self = other.difference(self)
+        return diff_self_other.union(diff_other_self)
+
+    def _diff(self, other):
+        diff = sortedset()
+        for item in self._items:
+            if item not in other:
+                diff.add(item)
+        return diff
+
+    def _intersect(self, other):
+        isect = sortedset()
+        for item in self._items:
+            if item in other:
+                isect.add(item)
+        return isect
+
+    def _find_insertion(self, x):
+        # this uses bisect_left algorithm unless it has elements it can't compare,
+        # in which case it defaults to grouping non-comparable items at the beginning or end,
+        # and scanning sequentially to find an insertion point
+        a = self._items
+        lo = 0
+        hi = len(a)
+        try:
+            while lo < hi:
+                mid = (lo + hi) // 2
+                if a[mid] < x: lo = mid + 1
+                else: hi = mid
+        except TypeError:
+            # could not compare a[mid] with x
+            # start scanning to find insertion point while swallowing type errors
+            lo = 0
+            compared_one = False  # flag is used to determine whether uncomparables are grouped at the front or back
+            while lo < hi:
+                try:
+                    if a[lo] == x or a[lo] >= x: break
+                    compared_one = True
+                except TypeError:
+                    if compared_one: break
+                lo += 1
+        return lo
+
+sortedset = SortedSet  # backwards-compatibility
+
+
+class OrderedMap(Mapping):
+    '''
+    An ordered map that accepts non-hashable types for keys. It also maintains the
+    insertion order of items, behaving as OrderedDict in that regard. These maps
+    are constructed and read just as normal mapping types, except that they may
+    contain arbitrary collections and other non-hashable items as keys::
+
+        >>> od = OrderedMap([({'one': 1, 'two': 2}, 'value'),
+        ...                  ({'three': 3, 'four': 4}, 'value2')])
+        >>> list(od.keys())
+        [{'two': 2, 'one': 1}, {'three': 3, 'four': 4}]
+        >>> list(od.values())
+        ['value', 'value2']
+
+    These constructs are needed to support nested collections in Cassandra 2.1.3+,
+    where frozen collections can be specified as parameters to others::
+
+        CREATE TABLE example (
+            ...
+            value map<frozen<map<int, int>>, double>
+            ...
+        )
+
+    This class derives from the (immutable) Mapping API. Objects in these maps
+    are not intended be modified.
+    '''
+
+    def __init__(self, *args, **kwargs):
+        if len(args) > 1:
+            raise TypeError('expected at most 1 arguments, got %d' % len(args))
+
+        self._items = []
+        self._index = {}
+        if args:
+            e = args[0]
+            if callable(getattr(e, 'keys', None)):
+                for k in e.keys():
+                    self._insert(k, e[k])
+            else:
+                for k, v in e:
+                    self._insert(k, v)
+
+        for k, v in kwargs.items():
+            self._insert(k, v)
+
+    def _insert(self, key, value):
+        flat_key = self._serialize_key(key)
+        i = self._index.get(flat_key, -1)
+        if i >= 0:
+            self._items[i] = (key, value)
+        else:
+            self._items.append((key, value))
+            self._index[flat_key] = len(self._items) - 1
+
+    __setitem__ = _insert
+
+    def __getitem__(self, key):
+        try:
+            index = self._index[self._serialize_key(key)]
+            return self._items[index][1]
+        except KeyError:
+            raise KeyError(str(key))
+
+    def __delitem__(self, key):
+        # not efficient -- for convenience only
+        try:
+            index = self._index.pop(self._serialize_key(key))
+            self._index = dict((k, i if i < index else i - 1) for k, i in self._index.items())
+            self._items.pop(index)
+        except KeyError:
+            raise KeyError(str(key))
+
+    def __iter__(self):
+        for i in self._items:
+            yield i[0]
+
+    def __len__(self):
+        return len(self._items)
+
+    def __eq__(self, other):
+        if isinstance(other, OrderedMap):
+            return self._items == other._items
+        try:
+            d = dict(other)
+            return len(d) == len(self._items) and all(i[1] == d[i[0]] for i in self._items)
+        except KeyError:
+            return False
+        except TypeError:
+            pass
+        return NotImplemented
+
+    def __repr__(self):
+        return '%s([%s])' % (
+            self.__class__.__name__,
+            ', '.join("(%r, %r)" % (k, v) for k, v in self._items))
+
+    def __str__(self):
+        return '{%s}' % ', '.join("%r: %r" % (k, v) for k, v in self._items)
+
+    def popitem(self):
+        try:
+            kv = self._items.pop()
+            del self._index[self._serialize_key(kv[0])]
+            return kv
+        except IndexError:
+            raise KeyError()
+
+    def _serialize_key(self, key):
+        return pickle.dumps(key)
+
+
+class OrderedMapSerializedKey(OrderedMap):
+
+    def __init__(self, cass_type, protocol_version):
+        super(OrderedMapSerializedKey, self).__init__()
+        self.cass_key_type = cass_type
+        self.protocol_version = protocol_version
+
+    def _insert_unchecked(self, key, flat_key, value):
+        self._items.append((key, value))
+        self._index[flat_key] = len(self._items) - 1
+
+    def _serialize_key(self, key):
+        return self.cass_key_type.serialize(key, self.protocol_version)
+
+
+@total_ordering
+class Time(object):
+    '''
+    Idealized time, independent of day.
+
+    Up to nanosecond resolution
+    '''
+
+    MICRO = 1000
+    MILLI = 1000 * MICRO
+    SECOND = 1000 * MILLI
+    MINUTE = 60 * SECOND
+    HOUR = 60 * MINUTE
+    DAY = 24 * HOUR
+
+    nanosecond_time = 0
+
+    def __init__(self, value):
+        """
+        Initializer value can be:
+
+        - integer_type: absolute nanoseconds in the day
+        - datetime.time: built-in time
+        - string_type: a string time of the form "HH:MM:SS[.mmmuuunnn]"
+        """
+        if isinstance(value, int):
+            self._from_timestamp(value)
+        elif isinstance(value, datetime.time):
+            self._from_time(value)
+        elif isinstance(value, str):
+            self._from_timestring(value)
+        else:
+            raise TypeError('Time arguments must be a whole number, datetime.time, or string')
+
+    @property
+    def hour(self):
+        """
+        The hour component of this time (0-23)
+        """
+        return self.nanosecond_time // Time.HOUR
+
+    @property
+    def minute(self):
+        """
+        The minute component of this time (0-59)
+        """
+        minutes = self.nanosecond_time // Time.MINUTE
+        return minutes % 60
+
+    @property
+    def second(self):
+        """
+        The second component of this time (0-59)
+        """
+        seconds = self.nanosecond_time // Time.SECOND
+        return seconds % 60
+
+    @property
+    def nanosecond(self):
+        """
+        The fractional seconds component of the time, in nanoseconds
+        """
+        return self.nanosecond_time % Time.SECOND
+
+    def time(self):
+        """
+        Return a built-in datetime.time (nanosecond precision truncated to micros).
+        """
+        return datetime.time(hour=self.hour, minute=self.minute, second=self.second,
+                             microsecond=self.nanosecond // Time.MICRO)
+
+    def _from_timestamp(self, t):
+        if t >= Time.DAY:
+            raise ValueError("value must be less than number of nanoseconds in a day (%d)" % Time.DAY)
+        self.nanosecond_time = t
+
+    def _from_timestring(self, s):
+        try:
+            parts = s.split('.')
+            base_time = time.strptime(parts[0], "%H:%M:%S")
+            self.nanosecond_time = (base_time.tm_hour * Time.HOUR +
+                                    base_time.tm_min * Time.MINUTE +
+                                    base_time.tm_sec * Time.SECOND)
+
+            if len(parts) > 1:
+                # right pad to 9 digits
+                nano_time_str = parts[1] + "0" * (9 - len(parts[1]))
+                self.nanosecond_time += int(nano_time_str)
+
+        except ValueError:
+            raise ValueError("can't interpret %r as a time" % (s,))
+
+    def _from_time(self, t):
+        self.nanosecond_time = (t.hour * Time.HOUR +
+                                t.minute * Time.MINUTE +
+                                t.second * Time.SECOND +
+                                t.microsecond * Time.MICRO)
+
+    def __hash__(self):
+        return self.nanosecond_time
+
+    def __eq__(self, other):
+        if isinstance(other, Time):
+            return self.nanosecond_time == other.nanosecond_time
+
+        if isinstance(other, int):
+            return self.nanosecond_time == other
+
+        return self.nanosecond_time % Time.MICRO == 0 and \
+            datetime.time(hour=self.hour, minute=self.minute, second=self.second,
+                          microsecond=self.nanosecond // Time.MICRO) == other
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __lt__(self, other):
+        if not isinstance(other, Time):
+            return NotImplemented
+        return self.nanosecond_time < other.nanosecond_time
+
+    def __repr__(self):
+        return "Time(%s)" % self.nanosecond_time
+
+    def __str__(self):
+        return "%02d:%02d:%02d.%09d" % (self.hour, self.minute,
+                                        self.second, self.nanosecond)
+
+
+@total_ordering
+class Date(object):
+    '''
+    Idealized date: year, month, day
+
+    Offers wider year range than datetime.date. For Dates that cannot be represented
+    as a datetime.date (because datetime.MINYEAR, datetime.MAXYEAR), this type falls back
+    to printing days_from_epoch offset.
+    '''
+
+    MINUTE = 60
+    HOUR = 60 * MINUTE
+    DAY = 24 * HOUR
+
+    date_format = "%Y-%m-%d"
+
+    days_from_epoch = 0
+
+    def __init__(self, value):
+        """
+        Initializer value can be:
+
+        - integer_type: absolute days from epoch (1970, 1, 1). Can be negative.
+        - datetime.date: built-in date
+        - string_type: a string time of the form "yyyy-mm-dd"
+        """
+        if isinstance(value, int):
+            self.days_from_epoch = value
+        elif isinstance(value, (datetime.date, datetime.datetime)):
+            self._from_timetuple(value.timetuple())
+        elif isinstance(value, str):
+            self._from_datestring(value)
+        else:
+            raise TypeError('Date arguments must be a whole number, datetime.date, or string')
+
+    @property
+    def seconds(self):
+        """
+        Absolute seconds from epoch (can be negative)
+        """
+        return self.days_from_epoch * Date.DAY
+
+    def date(self):
+        """
+        Return a built-in datetime.date for Dates falling in the years [datetime.MINYEAR, datetime.MAXYEAR]
+
+        ValueError is raised for Dates outside this range.
+        """
+        try:
+            dt = datetime_from_timestamp(self.seconds)
+            return datetime.date(dt.year, dt.month, dt.day)
+        except Exception:
+            raise ValueError("%r exceeds ranges for built-in datetime.date" % self)
+
+    def _from_timetuple(self, t):
+        self.days_from_epoch = calendar.timegm(t) // Date.DAY
+
+    def _from_datestring(self, s):
+        if s[0] == '+':
+            s = s[1:]
+        dt = datetime.datetime.strptime(s, self.date_format)
+        self._from_timetuple(dt.timetuple())
+
+    def __hash__(self):
+        return self.days_from_epoch
+
+    def __eq__(self, other):
+        if isinstance(other, Date):
+            return self.days_from_epoch == other.days_from_epoch
+
+        if isinstance(other, int):
+            return self.days_from_epoch == other
+
+        try:
+            return self.date() == other
+        except Exception:
+            return False
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __lt__(self, other):
+        if not isinstance(other, Date):
+            return NotImplemented
+        return self.days_from_epoch < other.days_from_epoch
+
+    def __repr__(self):
+        return "Date(%s)" % self.days_from_epoch
+
+    def __str__(self):
+        try:
+            dt = datetime_from_timestamp(self.seconds)
+            return "%04d-%02d-%02d" % (dt.year, dt.month, dt.day)
+        except:
+            # If we overflow datetime.[MIN|MAX]
+            return str(self.days_from_epoch)
+
+
+inet_pton = socket.inet_pton
+inet_ntop = socket.inet_ntop
+
+
+# similar to collections.namedtuple, reproduced here because Python 2.6 did not have the rename logic
+def _positional_rename_invalid_identifiers(field_names):
+    names_out = list(field_names)
+    for index, name in enumerate(field_names):
+        if (not all(c.isalnum() or c == '_' for c in name)
+            or keyword.iskeyword(name)
+            or not name
+            or name[0].isdigit()
+            or name.startswith('_')):
+            names_out[index] = 'field_%d_' % index
+    return names_out
+
+
+def _sanitize_identifiers(field_names):
+    names_out = _positional_rename_invalid_identifiers(field_names)
+    if len(names_out) != len(set(names_out)):
+        observed_names = set()
+        for index, name in enumerate(names_out):
+            while names_out[index] in observed_names:
+                names_out[index] = "%s_" % (names_out[index],)
+            observed_names.add(names_out[index])
+    return names_out
+
+
+def list_contents_to_tuple(to_convert):
+    if isinstance(to_convert, list):
+        for n, i in enumerate(to_convert):
+            if isinstance(to_convert[n], list):
+                to_convert[n] = tuple(to_convert[n])
+        return tuple(to_convert)
+    else:
+        return to_convert
+
+
+class Point(object):
+    """
+    Represents a point geometry for DSE
+    """
+
+    x = None
+    """
+    x coordinate of the point
+    """
+
+    y = None
+    """
+    y coordinate of the point
+    """
+
+    def __init__(self, x=_nan, y=_nan):
+        self.x = x
+        self.y = y
+
+    def __eq__(self, other):
+        return isinstance(other, Point) and self.x == other.x and self.y == other.y
+
+    def __hash__(self):
+        return hash((self.x, self.y))
+
+    def __str__(self):
+        """
+        Well-known text representation of the point
+        """
+        return "POINT (%r %r)" % (self.x, self.y)
+
+    def __repr__(self):
+        return "%s(%r, %r)" % (self.__class__.__name__, self.x, self.y)
+
+    @staticmethod
+    def from_wkt(s):
+        """
+        Parse a Point geometry from a wkt string and return a new Point object.
+        """
+        if not _HAS_GEOMET:
+            raise DriverException("Geomet is required to deserialize a wkt geometry.")
+
+        try:
+            geom = wkt.loads(s)
+        except ValueError:
+            raise ValueError("Invalid WKT geometry: '{0}'".format(s))
+
+        if geom['type'] != 'Point':
+            raise ValueError("Invalid WKT geometry type. Expected 'Point', got '{0}': '{1}'".format(geom['type'], s))
+
+        coords = geom['coordinates']
+        if len(coords) < 2:
+            x = y = _nan
+        else:
+            x = coords[0]
+            y = coords[1]
+
+        return Point(x=x, y=y)
+
+
+class LineString(object):
+    """
+    Represents a linestring geometry for DSE
+    """
+
+    coords = None
+    """
+    Tuple of (x, y) coordinates in the linestring
+    """
+    def __init__(self, coords=tuple()):
+        """
+        'coords`: a sequence of (x, y) coordinates of points in the linestring
+        """
+        self.coords = tuple(coords)
+
+    def __eq__(self, other):
+        return isinstance(other, LineString) and self.coords == other.coords
+
+    def __hash__(self):
+        return hash(self.coords)
+
+    def __str__(self):
+        """
+        Well-known text representation of the LineString
+        """
+        if not self.coords:
+            return "LINESTRING EMPTY"
+        return "LINESTRING (%s)" % ', '.join("%r %r" % (x, y) for x, y in self.coords)
+
+    def __repr__(self):
+        return "%s(%r)" % (self.__class__.__name__, self.coords)
+
+    @staticmethod
+    def from_wkt(s):
+        """
+        Parse a LineString geometry from a wkt string and return a new LineString object.
+        """
+        if not _HAS_GEOMET:
+            raise DriverException("Geomet is required to deserialize a wkt geometry.")
+
+        try:
+            geom = wkt.loads(s)
+        except ValueError:
+            raise ValueError("Invalid WKT geometry: '{0}'".format(s))
+
+        if geom['type'] != 'LineString':
+            raise ValueError("Invalid WKT geometry type. Expected 'LineString', got '{0}': '{1}'".format(geom['type'], s))
+
+        geom['coordinates'] = list_contents_to_tuple(geom['coordinates'])
+
+        return LineString(coords=geom['coordinates'])
+
+
+class _LinearRing(object):
+    # no validation, no implicit closing; just used for poly composition, to
+    # mimic that of shapely.geometry.Polygon
+    def __init__(self, coords=tuple()):
+        self.coords = list_contents_to_tuple(coords)
+
+    def __eq__(self, other):
+        return isinstance(other, _LinearRing) and self.coords == other.coords
+
+    def __hash__(self):
+        return hash(self.coords)
+
+    def __str__(self):
+        if not self.coords:
+            return "LINEARRING EMPTY"
+        return "LINEARRING (%s)" % ', '.join("%r %r" % (x, y) for x, y in self.coords)
+
+    def __repr__(self):
+        return "%s(%r)" % (self.__class__.__name__, self.coords)
+
+
+class Polygon(object):
+    """
+    Represents a polygon geometry for DSE
+    """
+
+    exterior = None
+    """
+    _LinearRing representing the exterior of the polygon
+    """
+
+    interiors = None
+    """
+    Tuple of _LinearRings representing interior holes in the polygon
+    """
+
+    def __init__(self, exterior=tuple(), interiors=None):
+        """
+        'exterior`: a sequence of (x, y) coordinates of points in the linestring
+        `interiors`: None, or a sequence of sequences or (x, y) coordinates of points describing interior linear rings
+        """
+        self.exterior = _LinearRing(exterior)
+        self.interiors = tuple(_LinearRing(e) for e in interiors) if interiors else tuple()
+
+    def __eq__(self, other):
+        return isinstance(other, Polygon) and self.exterior == other.exterior and self.interiors == other.interiors
+
+    def __hash__(self):
+        return hash((self.exterior, self.interiors))
+
+    def __str__(self):
+        """
+        Well-known text representation of the polygon
+        """
+        if not self.exterior.coords:
+            return "POLYGON EMPTY"
+        rings = [ring.coords for ring in chain((self.exterior,), self.interiors)]
+        rings = ["(%s)" % ', '.join("%r %r" % (x, y) for x, y in ring) for ring in rings]
+        return "POLYGON (%s)" % ', '.join(rings)
+
+    def __repr__(self):
+        return "%s(%r, %r)" % (self.__class__.__name__, self.exterior.coords, [ring.coords for ring in self.interiors])
+
+    @staticmethod
+    def from_wkt(s):
+        """
+        Parse a Polygon geometry from a wkt string and return a new Polygon object.
+        """
+        if not _HAS_GEOMET:
+            raise DriverException("Geomet is required to deserialize a wkt geometry.")
+
+        try:
+            geom = wkt.loads(s)
+        except ValueError:
+            raise ValueError("Invalid WKT geometry: '{0}'".format(s))
+
+        if geom['type'] != 'Polygon':
+            raise ValueError("Invalid WKT geometry type. Expected 'Polygon', got '{0}': '{1}'".format(geom['type'], s))
+
+        coords = geom['coordinates']
+        exterior = coords[0] if len(coords) > 0 else tuple()
+        interiors = coords[1:] if len(coords) > 1 else None
+
+        return Polygon(exterior=exterior, interiors=interiors)
+
+
+_distance_wkt_pattern = re.compile("distance *\\( *\\( *([\\d\\.-]+) *([\\d+\\.-]+) *\\) *([\\d+\\.-]+) *\\) *$", re.IGNORECASE)
+
+
+class Distance(object):
+    """
+    Represents a Distance geometry for DSE
+    """
+
+    x = None
+    """
+    x coordinate of the center point
+    """
+
+    y = None
+    """
+    y coordinate of the center point
+    """
+
+    radius = None
+    """
+    radius to represent the distance from the center point
+    """
+
+    def __init__(self, x=_nan, y=_nan, radius=_nan):
+        self.x = x
+        self.y = y
+        self.radius = radius
+
+    def __eq__(self, other):
+        return isinstance(other, Distance) and self.x == other.x and self.y == other.y and self.radius == other.radius
+
+    def __hash__(self):
+        return hash((self.x, self.y, self.radius))
+
+    def __str__(self):
+        """
+        Well-known text representation of the point
+        """
+        return "DISTANCE ((%r %r) %r)" % (self.x, self.y, self.radius)
+
+    def __repr__(self):
+        return "%s(%r, %r, %r)" % (self.__class__.__name__, self.x, self.y, self.radius)
+
+    @staticmethod
+    def from_wkt(s):
+        """
+        Parse a Distance geometry from a wkt string and return a new Distance object.
+        """
+
+        distance_match = _distance_wkt_pattern.match(s)
+
+        if distance_match is None:
+            raise ValueError("Invalid WKT geometry: '{0}'".format(s))
+
+        x, y, radius = distance_match.groups()
+        return Distance(x, y, radius)
+
+
+class Duration(object):
+    """
+    Cassandra Duration Type
+    """
+
+    months = 0
+    ""
+    days = 0
+    ""
+    nanoseconds = 0
+    ""
+
+    def __init__(self, months=0, days=0, nanoseconds=0):
+        self.months = months
+        self.days = days
+        self.nanoseconds = nanoseconds
+
+    def __eq__(self, other):
+        return isinstance(other, self.__class__) and self.months == other.months and self.days == other.days and self.nanoseconds == other.nanoseconds
+
+    def __repr__(self):
+        return "Duration({0}, {1}, {2})".format(self.months, self.days, self.nanoseconds)
+
+    def __str__(self):
+        has_negative_values = self.months < 0 or self.days < 0 or self.nanoseconds < 0
+        return '%s%dmo%dd%dns' % (
+            '-' if has_negative_values else '',
+            abs(self.months),
+            abs(self.days),
+            abs(self.nanoseconds)
+        )
+
+
+class DateRangePrecision(object):
+    """
+    An "enum" representing the valid values for :attr:`DateRange.precision`.
+    """
+    YEAR = 'YEAR'
+    """
+    """
+
+    MONTH = 'MONTH'
+    """
+    """
+
+    DAY = 'DAY'
+    """
+    """
+
+    HOUR = 'HOUR'
+    """
+    """
+
+    MINUTE = 'MINUTE'
+    """
+    """
+
+    SECOND = 'SECOND'
+    """
+    """
+
+    MILLISECOND = 'MILLISECOND'
+    """
+    """
+
+    PRECISIONS = (YEAR, MONTH, DAY, HOUR,
+                  MINUTE, SECOND, MILLISECOND)
+    """
+    """
+
+    @classmethod
+    def _to_int(cls, precision):
+        return cls.PRECISIONS.index(precision.upper())
+
+    @classmethod
+    def _round_to_precision(cls, ms, precision, default_dt):
+        try:
+            dt = utc_datetime_from_ms_timestamp(ms)
+        except OverflowError:
+            return ms
+        precision_idx = cls._to_int(precision)
+        replace_kwargs = {}
+        if precision_idx <= cls._to_int(DateRangePrecision.YEAR):
+            replace_kwargs['month'] = default_dt.month
+        if precision_idx <= cls._to_int(DateRangePrecision.MONTH):
+            replace_kwargs['day'] = default_dt.day
+        if precision_idx <= cls._to_int(DateRangePrecision.DAY):
+            replace_kwargs['hour'] = default_dt.hour
+        if precision_idx <= cls._to_int(DateRangePrecision.HOUR):
+            replace_kwargs['minute'] = default_dt.minute
+        if precision_idx <= cls._to_int(DateRangePrecision.MINUTE):
+            replace_kwargs['second'] = default_dt.second
+        if precision_idx <= cls._to_int(DateRangePrecision.SECOND):
+            # truncate to nearest 1000 so we deal in ms, not us
+            replace_kwargs['microsecond'] = (default_dt.microsecond // 1000) * 1000
+        if precision_idx == cls._to_int(DateRangePrecision.MILLISECOND):
+            replace_kwargs['microsecond'] = int(round(dt.microsecond, -3))
+        return ms_timestamp_from_datetime(dt.replace(**replace_kwargs))
+
+    @classmethod
+    def round_up_to_precision(cls, ms, precision):
+        # PYTHON-912: this is the only case in which we can't take as upper bound
+        # datetime.datetime.max because the month from ms may be February and we'd
+        # be setting 31 as the month day
+        if precision == cls.MONTH:
+            date_ms = utc_datetime_from_ms_timestamp(ms)
+            upper_date = datetime.datetime.max.replace(year=date_ms.year, month=date_ms.month,
+                                                       day=calendar.monthrange(date_ms.year, date_ms.month)[1])
+        else:
+            upper_date = datetime.datetime.max
+        return cls._round_to_precision(ms, precision, upper_date)
+
+    @classmethod
+    def round_down_to_precision(cls, ms, precision):
+        return cls._round_to_precision(ms, precision, datetime.datetime.min)
+
+
+@total_ordering
+class DateRangeBound(object):
+    """DateRangeBound(value, precision)
+    Represents a single date value and its precision for :class:`DateRange`.
+
+    .. attribute:: milliseconds
+
+        Integer representing milliseconds since the UNIX epoch. May be negative.
+
+    .. attribute:: precision
+
+        String representing the precision of a bound. Must be a valid
+        :class:`DateRangePrecision` member.
+
+    :class:`DateRangeBound` uses a millisecond offset from the UNIX epoch to
+    allow :class:`DateRange` to represent values `datetime.datetime` cannot.
+    For such values, string representions will show this offset rather than the
+    CQL representation.
+    """
+    milliseconds = None
+    precision = None
+
+    def __init__(self, value, precision):
+        """
+        :param value: a value representing ms since the epoch. Accepts an
+            integer or a datetime.
+        :param precision: a string representing precision
+        """
+        if precision is not None:
+            try:
+                self.precision = precision.upper()
+            except AttributeError:
+                raise TypeError('precision must be a string; got %r' % precision)
+
+        if value is None:
+            milliseconds = None
+        elif isinstance(value, int):
+            milliseconds = value
+        elif isinstance(value, datetime.datetime):
+            value = value.replace(
+                microsecond=int(round(value.microsecond, -3))
+            )
+            milliseconds = ms_timestamp_from_datetime(value)
+        else:
+            raise ValueError('%r is not a valid value for DateRangeBound' % value)
+
+        self.milliseconds = milliseconds
+        self.validate()
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return (self.milliseconds == other.milliseconds and
+                self.precision == other.precision)
+
+    def __lt__(self, other):
+        return ((str(self.milliseconds), str(self.precision)) <
+                (str(other.milliseconds), str(other.precision)))
+
+    def datetime(self):
+        """
+        Return :attr:`milliseconds` as a :class:`datetime.datetime` if possible.
+        Raises an `OverflowError` if the value is out of range.
+        """
+        return utc_datetime_from_ms_timestamp(self.milliseconds)
+
+    def validate(self):
+        attrs = self.milliseconds, self.precision
+        if attrs == (None, None):
+            return
+        if None in attrs:
+            raise TypeError(
+                ("%s.datetime and %s.precision must not be None unless both "
+                 "are None; Got: %r") % (self.__class__.__name__,
+                                         self.__class__.__name__,
+                                         self)
+            )
+        if self.precision not in DateRangePrecision.PRECISIONS:
+            raise ValueError(
+                "%s.precision: expected value in %r; got %r" % (
+                    self.__class__.__name__,
+                    DateRangePrecision.PRECISIONS,
+                    self.precision
+                )
+            )
+
+    @classmethod
+    def from_value(cls, value):
+        """
+        Construct a new :class:`DateRangeBound` from a given value. If
+        possible, use the `value['milliseconds']` and `value['precision']` keys
+        of the argument. Otherwise, use the argument as a `(milliseconds,
+        precision)` iterable.
+
+        :param value: a dictlike or iterable object
+        """
+        if isinstance(value, cls):
+            return value
+
+        # if possible, use as a mapping
+        try:
+            milliseconds, precision = value.get('milliseconds'), value.get('precision')
+        except AttributeError:
+            milliseconds = precision = None
+        if milliseconds is not None and precision is not None:
+            return DateRangeBound(value=milliseconds, precision=precision)
+
+        # otherwise, use as an iterable
+        return DateRangeBound(*value)
+
+    def round_up(self):
+        if self.milliseconds is None or self.precision is None:
+            return self
+        self.milliseconds = DateRangePrecision.round_up_to_precision(
+            self.milliseconds, self.precision
+        )
+        return self
+
+    def round_down(self):
+        if self.milliseconds is None or self.precision is None:
+            return self
+        self.milliseconds = DateRangePrecision.round_down_to_precision(
+            self.milliseconds, self.precision
+        )
+        return self
+
+    _formatter_map = {
+        DateRangePrecision.YEAR: '%Y',
+        DateRangePrecision.MONTH: '%Y-%m',
+        DateRangePrecision.DAY: '%Y-%m-%d',
+        DateRangePrecision.HOUR: '%Y-%m-%dT%HZ',
+        DateRangePrecision.MINUTE: '%Y-%m-%dT%H:%MZ',
+        DateRangePrecision.SECOND: '%Y-%m-%dT%H:%M:%SZ',
+        DateRangePrecision.MILLISECOND: '%Y-%m-%dT%H:%M:%S',
+    }
+
+    def __str__(self):
+        if self == OPEN_BOUND:
+            return '*'
+
+        try:
+            dt = self.datetime()
+        except OverflowError:
+            return '%sms' % (self.milliseconds,)
+
+        formatted = dt.strftime(self._formatter_map[self.precision])
+
+        if self.precision == DateRangePrecision.MILLISECOND:
+            # we'd like to just format with '%Y-%m-%dT%H:%M:%S.%fZ', but %f
+            # gives us more precision than we want, so we strftime up to %S and
+            # do the rest ourselves
+            return '%s.%03dZ' % (formatted, dt.microsecond / 1000)
+
+        return formatted
+
+    def __repr__(self):
+        return '%s(milliseconds=%r, precision=%r)' % (
+            self.__class__.__name__, self.milliseconds, self.precision
+        )
+
+
+OPEN_BOUND = DateRangeBound(value=None, precision=None)
+"""
+Represents `*`, an open value or bound for :class:`DateRange`.
+"""
+
+
+@total_ordering
+class DateRange(object):
+    """DateRange(lower_bound=None, upper_bound=None, value=None)
+    DSE DateRange Type
+
+    .. attribute:: lower_bound
+
+        :class:`~DateRangeBound` representing the lower bound of a bounded range.
+
+    .. attribute:: upper_bound
+
+        :class:`~DateRangeBound` representing the upper bound of a bounded range.
+
+    .. attribute:: value
+
+        :class:`~DateRangeBound` representing the value of a single-value range.
+
+    As noted in its documentation, :class:`DateRangeBound` uses a millisecond
+    offset from the UNIX epoch to allow :class:`DateRange` to represent values
+    `datetime.datetime` cannot. For such values, string representions will show
+    this offset rather than the CQL representation.
+    """
+    lower_bound = None
+    upper_bound = None
+    value = None
+
+    def __init__(self, lower_bound=None, upper_bound=None, value=None):
+        """
+        :param lower_bound: a :class:`DateRangeBound` or object accepted by
+            :meth:`DateRangeBound.from_value` to be used as a
+            :attr:`lower_bound`. Mutually exclusive with `value`. If
+            `upper_bound` is specified and this is not, the :attr:`lower_bound`
+            will be open.
+        :param upper_bound: a :class:`DateRangeBound` or object accepted by
+            :meth:`DateRangeBound.from_value` to be used as a
+            :attr:`upper_bound`. Mutually exclusive with `value`. If
+            `lower_bound` is specified and this is not, the :attr:`upper_bound`
+            will be open.
+        :param value: a :class:`DateRangeBound` or object accepted by
+            :meth:`DateRangeBound.from_value` to be used as :attr:`value`. Mutually
+            exclusive with `lower_bound` and `lower_bound`.
+        """
+
+        # if necessary, transform non-None args to DateRangeBounds
+        lower_bound = (DateRangeBound.from_value(lower_bound).round_down()
+                       if lower_bound else lower_bound)
+        upper_bound = (DateRangeBound.from_value(upper_bound).round_up()
+                       if upper_bound else upper_bound)
+        value = (DateRangeBound.from_value(value).round_down()
+                 if value else value)
+
+        # if we're using a 2-ended range but one bound isn't specified, specify
+        # an open bound
+        if lower_bound is None and upper_bound is not None:
+            lower_bound = OPEN_BOUND
+        if upper_bound is None and lower_bound is not None:
+            upper_bound = OPEN_BOUND
+
+        self.lower_bound, self.upper_bound, self.value = (
+            lower_bound, upper_bound, value
+        )
+        self.validate()
+
+    def validate(self):
+        if self.value is None:
+            if self.lower_bound is None or self.upper_bound is None:
+                raise ValueError(
+                    '%s instances where value attribute is None must set '
+                    'lower_bound or upper_bound; got %r' % (
+                        self.__class__.__name__,
+                        self
+                    )
+                )
+        else:  # self.value is not None
+            if self.lower_bound is not None or self.upper_bound is not None:
+                raise ValueError(
+                    '%s instances where value attribute is not None must not '
+                    'set lower_bound or upper_bound; got %r' % (
+                        self.__class__.__name__,
+                        self
+                    )
+                )
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return (self.lower_bound == other.lower_bound and
+                self.upper_bound == other.upper_bound and
+                self.value == other.value)
+
+    def __lt__(self, other):
+        return ((str(self.lower_bound), str(self.upper_bound), str(self.value)) <
+                (str(other.lower_bound), str(other.upper_bound), str(other.value)))
+
+    def __str__(self):
+        if self.value:
+            return str(self.value)
+        else:
+            return '[%s TO %s]' % (self.lower_bound, self.upper_bound)
+
+    def __repr__(self):
+        return '%s(lower_bound=%r, upper_bound=%r, value=%r)' % (
+            self.__class__.__name__,
+            self.lower_bound, self.upper_bound, self.value
+        )
+
+
+@total_ordering
+class Version(object):
+    """
+    Internal minimalist class to compare versions.
+    A valid version is: <int>.<int>.<int>.<int or str>.
+
+    TODO: when python2 support is removed, use packaging.version.
+    """
+
+    _version = None
+    major = None
+    minor = 0
+    patch = 0
+    build = 0
+    prerelease = 0
+
+    def __init__(self, version):
+        self._version = version
+        if '-' in version:
+            version_without_prerelease, self.prerelease = version.split('-', 1)
+        else:
+            version_without_prerelease = version
+        parts = list(reversed(version_without_prerelease.split('.')))
+        if len(parts) > 4:
+            prerelease_string = "-{}".format(self.prerelease) if self.prerelease else ""
+            log.warning("Unrecognized version: {}. Only 4 components plus prerelease are supported. "
+                        "Assuming version as {}{}".format(version, '.'.join(parts[:-5:-1]), prerelease_string))
+
+        try:
+            self.major = int(parts.pop())
+        except ValueError as e:
+            raise ValueError(
+                "Couldn't parse version {}. Version should start with a number".format(version))\
+                .with_traceback(e.__traceback__)
+        try:
+            self.minor = int(parts.pop()) if parts else 0
+            self.patch = int(parts.pop()) if parts else 0
+
+            if parts:  # we have a build version
+                build = parts.pop()
+                try:
+                    self.build = int(build)
+                except ValueError:
+                    self.build = build
+        except ValueError:
+            assumed_version = "{}.{}.{}.{}-{}".format(self.major, self.minor, self.patch, self.build, self.prerelease)
+            log.warning("Unrecognized version {}. Assuming version as {}".format(version, assumed_version))
+
+    def __hash__(self):
+        return self._version
+
+    def __repr__(self):
+        version_string = "Version({0}, {1}, {2}".format(self.major, self.minor, self.patch)
+        if self.build:
+            version_string += ", {}".format(self.build)
+        if self.prerelease:
+            version_string += ", {}".format(self.prerelease)
+        version_string += ")"
+
+        return version_string
+
+    def __str__(self):
+        return self._version
+
+    @staticmethod
+    def _compare_version_part(version, other_version, cmp):
+        if not (isinstance(version, int) and
+                isinstance(other_version, int)):
+            version = str(version)
+            other_version = str(other_version)
+
+        return cmp(version, other_version)
+
+    def __eq__(self, other):
+        if not isinstance(other, Version):
+            return NotImplemented
+
+        return (self.major == other.major and
+                self.minor == other.minor and
+                self.patch == other.patch and
+                self._compare_version_part(self.build, other.build, lambda s, o: s == o) and
+                self._compare_version_part(self.prerelease, other.prerelease, lambda s, o: s == o)
+                )
+
+    def __gt__(self, other):
+        if not isinstance(other, Version):
+            return NotImplemented
+
+        is_major_ge = self.major >= other.major
+        is_minor_ge = self.minor >= other.minor
+        is_patch_ge = self.patch >= other.patch
+        is_build_gt = self._compare_version_part(self.build, other.build, lambda s, o: s > o)
+        is_build_ge = self._compare_version_part(self.build, other.build, lambda s, o: s >= o)
+
+        # By definition, a prerelease comes BEFORE the actual release, so if a version
+        # doesn't have a prerelease, it's automatically greater than anything that does
+        if self.prerelease and not other.prerelease:
+            is_prerelease_gt = False
+        elif other.prerelease and not self.prerelease:
+            is_prerelease_gt = True
+        else:
+            is_prerelease_gt = self._compare_version_part(self.prerelease, other.prerelease, lambda s, o: s > o) \
+
+        return (self.major > other.major or
+                (is_major_ge and self.minor > other.minor) or
+                (is_major_ge and is_minor_ge and self.patch > other.patch) or
+                (is_major_ge and is_minor_ge and is_patch_ge and is_build_gt) or
+                (is_major_ge and is_minor_ge and is_patch_ge and is_build_ge and is_prerelease_gt)
+                )
diff --git a/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/INSTALLER b/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/LICENSE b/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..ade750b16ba50a06c955c07a75f5f82bdd3c5331
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/LICENSE
@@ -0,0 +1,177 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
diff --git a/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/METADATA b/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..47b2251aa5b9915f99cc3abfe3ee1ad6d013614e
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/METADATA
@@ -0,0 +1,123 @@
+Metadata-Version: 2.1
+Name: cassandra-driver
+Version: 3.29.1
+Summary: DataStax Driver for Apache Cassandra
+Home-page: http://github.com/datastax/python-driver
+Author: DataStax
+Project-URL: Documentation, https://docs.datastax.com/en/developer/python-driver/latest/
+Project-URL: Source, https://github.com/datastax/python-driver/
+Project-URL: Issues, https://datastax-oss.atlassian.net/browse/PYTHON
+Keywords: cassandra,cql,orm,dse,graph
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: geomet <0.3,>=0.1
+Provides-Extra: cle
+Requires-Dist: cryptography >=35.0 ; extra == 'cle'
+Provides-Extra: graph
+Requires-Dist: gremlinpython ==3.4.6 ; extra == 'graph'
+
+DataStax Driver for Apache Cassandra
+====================================
+
+.. image:: https://travis-ci.com/datastax/python-driver.png?branch=master
+   :target: https://travis-ci.com/github/datastax/python-driver
+
+A modern, `feature-rich <https://github.com/datastax/python-driver#features>`_ and highly-tunable Python client library for Apache Cassandra (2.1+) and
+DataStax Enterprise (4.7+) using exclusively Cassandra's binary protocol and Cassandra Query Language v3.
+
+The driver supports Python 3.8 through 3.12.
+
+**Note:** DataStax products do not support big-endian systems.
+
+Features
+--------
+* `Synchronous <http://datastax.github.io/python-driver/api/cassandra/cluster.html#cassandra.cluster.Session.execute>`_ and `Asynchronous <http://datastax.github.io/python-driver/api/cassandra/cluster.html#cassandra.cluster.Session.execute_async>`_ APIs
+* `Simple, Prepared, and Batch statements <http://datastax.github.io/python-driver/api/cassandra/query.html#cassandra.query.Statement>`_
+* Asynchronous IO, parallel execution, request pipelining
+* `Connection pooling <http://datastax.github.io/python-driver/api/cassandra/cluster.html#cassandra.cluster.Cluster.get_core_connections_per_host>`_
+* Automatic node discovery
+* `Automatic reconnection <http://datastax.github.io/python-driver/api/cassandra/policies.html#reconnecting-to-dead-hosts>`_
+* Configurable `load balancing <http://datastax.github.io/python-driver/api/cassandra/policies.html#load-balancing>`_ and `retry policies <http://datastax.github.io/python-driver/api/cassandra/policies.html#retrying-failed-operations>`_
+* `Concurrent execution utilities <http://datastax.github.io/python-driver/api/cassandra/concurrent.html>`_
+* `Object mapper <http://datastax.github.io/python-driver/object_mapper.html>`_
+* `Connecting to DataStax Astra database (cloud) <https://docs.datastax.com/en/developer/python-driver/latest/cloud/>`_
+* DSE Graph execution API
+* DSE Geometric type serialization
+* DSE PlainText and GSSAPI authentication
+
+Installation
+------------
+Installation through pip is recommended::
+
+    $ pip install cassandra-driver
+
+For more complete installation instructions, see the
+`installation guide <http://datastax.github.io/python-driver/installation.html>`_.
+
+Documentation
+-------------
+The documentation can be found online `here <http://datastax.github.io/python-driver/index.html>`_.
+
+A couple of links for getting up to speed:
+
+* `Installation <http://datastax.github.io/python-driver/installation.html>`_
+* `Getting started guide <http://datastax.github.io/python-driver/getting_started.html>`_
+* `API docs <http://datastax.github.io/python-driver/api/index.html>`_
+* `Performance tips <http://datastax.github.io/python-driver/performance.html>`_
+
+Object Mapper
+-------------
+cqlengine (originally developed by Blake Eggleston and Jon Haddad, with contributions from the
+community) is now maintained as an integral part of this package. Refer to
+`documentation here <http://datastax.github.io/python-driver/object_mapper.html>`_.
+
+Contributing
+------------
+See `CONTRIBUTING.md <https://github.com/datastax/python-driver/blob/master/CONTRIBUTING.rst>`_.
+
+Error Handling
+--------------
+While originally written for the Java driver, users may reference the `Cassandra error handling done right blog <https://www.datastax.com/blog/cassandra-error-handling-done-right>`_ for resolving error handling scenarios with Apache Cassandra.
+
+Reporting Problems
+------------------
+Please report any bugs and make any feature requests on the
+`JIRA <https://datastax-oss.atlassian.net/browse/PYTHON>`_ issue tracker.
+
+If you would like to contribute, please feel free to open a pull request.
+
+Getting Help
+------------
+Your best options for getting help with the driver are the
+`mailing list <https://groups.google.com/a/lists.datastax.com/forum/#!forum/python-driver-user>`_
+and the `DataStax Community <https://community.datastax.com>`_.
+
+License
+-------
+Copyright DataStax, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
diff --git a/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/RECORD b/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..94f2a0ab223e13641cb6e46d3abee1a9d70638da
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/RECORD
@@ -0,0 +1,169 @@
+cassandra/__init__.py,sha256=B_qZB5PiN3eKfKheKc4biwBNu8tN8lsP2l0NLiE0_34,21020
+cassandra/__pycache__/__init__.cpython-311.pyc,,
+cassandra/__pycache__/auth.cpython-311.pyc,,
+cassandra/__pycache__/cluster.cpython-311.pyc,,
+cassandra/__pycache__/concurrent.cpython-311.pyc,,
+cassandra/__pycache__/connection.cpython-311.pyc,,
+cassandra/__pycache__/cqltypes.cpython-311.pyc,,
+cassandra/__pycache__/cython_deps.cpython-311.pyc,,
+cassandra/__pycache__/encoder.cpython-311.pyc,,
+cassandra/__pycache__/marshal.cpython-311.pyc,,
+cassandra/__pycache__/metadata.cpython-311.pyc,,
+cassandra/__pycache__/metrics.cpython-311.pyc,,
+cassandra/__pycache__/murmur3.cpython-311.pyc,,
+cassandra/__pycache__/policies.cpython-311.pyc,,
+cassandra/__pycache__/pool.cpython-311.pyc,,
+cassandra/__pycache__/protocol.cpython-311.pyc,,
+cassandra/__pycache__/query.cpython-311.pyc,,
+cassandra/__pycache__/segment.cpython-311.pyc,,
+cassandra/__pycache__/timestamps.cpython-311.pyc,,
+cassandra/__pycache__/type_codes.cpython-311.pyc,,
+cassandra/__pycache__/util.cpython-311.pyc,,
+cassandra/auth.py,sha256=LlmiMFDHg1qP-s_k7uuoka285qnK8kfWqESk46u71p8,11021
+cassandra/buffer.pxd,sha256=oYlXKicOlCLD3Hg-jiP83YSgiGE3Hqn1DYREXu5k4SI,1867
+cassandra/bytesio.cp311-win_amd64.pyd,sha256=FA0aErhMX9N7UoyvVnjgUQeAOMjdj3adlVCagb2b2wE,35328
+cassandra/bytesio.pxd,sha256=EEnltJzOw-P-kzN4xra89Jwx-oxNoSTHLDLmkEpdJ28,763
+cassandra/bytesio.pyx,sha256=grF-RY0Gmo8_vv1HMLUioMUeuZnsiv7vZ7CT_-Xtt0g,1745
+cassandra/cluster.cp311-win_amd64.pyd,sha256=cTxu_ZjdtYCk7Vb2kVPiPwPO0ulOrVNkj3Hj70IxERY,1199616
+cassandra/cluster.py,sha256=DXKw6y5Rjbra8HGyTKKV0uzhiIND8I_cOy14xMOCNW8,234204
+cassandra/cmurmur3.c,sha256=WHJQq1nszZTMamSMFXGk3uvVDZXTAHgd8sxKdf0e2WU,6791
+cassandra/cmurmur3.cp311-win_amd64.pyd,sha256=JpKh9egK8q8tKuUbMqezkMkQxN9SAnrnJP6kpo0xF6k,11776
+cassandra/column_encryption/__pycache__/_policies.cpython-311.pyc,,
+cassandra/column_encryption/__pycache__/policies.cpython-311.pyc,,
+cassandra/column_encryption/_policies.py,sha256=GUywaB1bdoxBOA_MSHbw_cw-peWcaI9YZonZtqW710M,5970
+cassandra/column_encryption/policies.py,sha256=0rE8yl_S0zJrHZ57TMM3w07c5nhM3dUe3MOg_lUznNg,740
+cassandra/concurrent.cp311-win_amd64.pyd,sha256=JKNhGomym2TFdKkARzTIXCQeMBNbYVdF5MCXntfBAwY,104960
+cassandra/concurrent.py,sha256=wKLRD2tqj3B_XLTZZGcnLyTusEc53d6ZBDDBADTTLuw,9725
+cassandra/connection.cp311-win_amd64.pyd,sha256=rbQe3eljMnkFVf7I-RGwRnWe1ZGJge4eR3Vk4_GHe-Q,545280
+cassandra/connection.py,sha256=KaHcgr7SZqFi47IzVMwnTOfFRJSM3YFVunfOkm0JgGE,71683
+cassandra/cqlengine/__init__.py,sha256=3YuoU3LsVn0wQBGe2RYClSVuERPEm6qoaFgUayOmpr8,900
+cassandra/cqlengine/__pycache__/__init__.cpython-311.pyc,,
+cassandra/cqlengine/__pycache__/columns.cpython-311.pyc,,
+cassandra/cqlengine/__pycache__/connection.cpython-311.pyc,,
+cassandra/cqlengine/__pycache__/functions.cpython-311.pyc,,
+cassandra/cqlengine/__pycache__/management.cpython-311.pyc,,
+cassandra/cqlengine/__pycache__/models.cpython-311.pyc,,
+cassandra/cqlengine/__pycache__/named.cpython-311.pyc,,
+cassandra/cqlengine/__pycache__/operators.cpython-311.pyc,,
+cassandra/cqlengine/__pycache__/query.cpython-311.pyc,,
+cassandra/cqlengine/__pycache__/statements.cpython-311.pyc,,
+cassandra/cqlengine/__pycache__/usertype.cpython-311.pyc,,
+cassandra/cqlengine/columns.py,sha256=otZX4opBJmswKuOkHABs67L4VvIVBsAlGP9d214Ho_s,34204
+cassandra/cqlengine/connection.py,sha256=3kwci-8DZm7danJxYwRmuEJXx_wXsShIN3p9VOz6518,14715
+cassandra/cqlengine/functions.py,sha256=xsSU_O9H7C9Z9cHqf-iaXGiSBNf5Zx40IJHIkcLe87o,4051
+cassandra/cqlengine/management.py,sha256=C-3PgdN93a47T_14evVe5MtPU7LcIB69Dh3BIJyI900,23351
+cassandra/cqlengine/models.py,sha256=kj8DRXtxeEUteF1HuWv9Xi67W9EInYISIBfBJFuyX_0,39890
+cassandra/cqlengine/named.py,sha256=K81--f_4bw-yI_9gFWbvPsm0CRvcnu9_AVAALmDhm98,4886
+cassandra/cqlengine/operators.py,sha256=XpXnsCM0fgfYGzfReRKLkMV8CkvdDh1eJJ_y9w3jofo,2618
+cassandra/cqlengine/query.py,sha256=U3fI39PO9A12V8smpZDp33uo9CzVBkfqpjPg6cVVEoE,57768
+cassandra/cqlengine/statements.py,sha256=YWyCY2ePBiSWc2NIIVJalb92n6hWtCYNQtOEXs3Zf7E,30282
+cassandra/cqlengine/usertype.py,sha256=m2TNzSN2RSPrp-x52qwBo2U21pplYIaUeQuJU7u2c0I,7606
+cassandra/cqltypes.cp311-win_amd64.pyd,sha256=-LwiAf2RL77CAg6m6BYw7meH9Uck0s3nudhRqu214jk,477184
+cassandra/cqltypes.py,sha256=u1rr7qB2iAwRFrzcLcN_oWjPJNo_vQwL1gEg7ihFZRQ,49511
+cassandra/cython_deps.py,sha256=PW6g5t2QqI-tjinSIG5ZoYyKyVaEu3yEO1BBmQlzL2U,231
+cassandra/cython_marshal.cp311-win_amd64.pyd,sha256=dMg68E0ss_19KZACNsMTF9gjW0fkDFn7XC44tN7wEGs,19968
+cassandra/cython_marshal.pyx,sha256=4403vB3lkoQlOxh-08p7bMgcoUU9u2vfpjkn-ISwFVo,2187
+cassandra/cython_utils.cp311-win_amd64.pyd,sha256=_96I9LiOexSyeUEtOlu1_BhWe-nb4kEp8avgyP8PoYc,22016
+cassandra/cython_utils.pxd,sha256=OvLt7F3OjdfVeOBzDt0xMfdGWVpNomhot5lKSX9xrx4,82
+cassandra/cython_utils.pyx,sha256=vMbXttq1TmZcPeaY_nYiXQKc69WZbMDiKYE1w_ByUQQ,2114
+cassandra/datastax/__init__.py,sha256=VOJIuZ1gUMKTasiqd-aI3ADKMfqL4JmvKnL6f4V-YrU,582
+cassandra/datastax/__pycache__/__init__.cpython-311.pyc,,
+cassandra/datastax/cloud/__init__.py,sha256=3DhcjY6s55-egOzepnUeI63OxqVbCMq9EqNCg5cqjRQ,6577
+cassandra/datastax/cloud/__pycache__/__init__.cpython-311.pyc,,
+cassandra/datastax/graph/__init__.py,sha256=-5ev_qBhvfTdSHW6Fn8O4vFSSFZlXd7sVZtTCNpX2RA,1006
+cassandra/datastax/graph/__pycache__/__init__.cpython-311.pyc,,
+cassandra/datastax/graph/__pycache__/graphson.cpython-311.pyc,,
+cassandra/datastax/graph/__pycache__/query.cpython-311.pyc,,
+cassandra/datastax/graph/__pycache__/types.cpython-311.pyc,,
+cassandra/datastax/graph/fluent/__init__.py,sha256=QEqyo1-yX0AJx2nJxOQR2gTIVTOmuvUSoKo6bx6l6hw,13115
+cassandra/datastax/graph/fluent/__pycache__/__init__.cpython-311.pyc,,
+cassandra/datastax/graph/fluent/__pycache__/_predicates.cpython-311.pyc,,
+cassandra/datastax/graph/fluent/__pycache__/_query.cpython-311.pyc,,
+cassandra/datastax/graph/fluent/__pycache__/_serializers.cpython-311.pyc,,
+cassandra/datastax/graph/fluent/__pycache__/predicates.cpython-311.pyc,,
+cassandra/datastax/graph/fluent/__pycache__/query.cpython-311.pyc,,
+cassandra/datastax/graph/fluent/__pycache__/serializers.cpython-311.pyc,,
+cassandra/datastax/graph/fluent/_predicates.py,sha256=kWS2-4c1Aczuc6Xlo2mFn0tKUsCrI8OxuL2TMjLn_k8,6310
+cassandra/datastax/graph/fluent/_query.py,sha256=5zTsRUBowFlGrlXfweXRy5-sVIGaQxbYwfN2-P-Ga9s,8030
+cassandra/datastax/graph/fluent/_serializers.py,sha256=7ZH3ZJtwOI63FyzHUcibKWmQJBPFszeg4iNk6TL2d5M,8679
+cassandra/datastax/graph/fluent/predicates.py,sha256=9HrCfANWe69UHaMx-YJs112fqhBfZNGNlCUkmuitbyY,750
+cassandra/datastax/graph/fluent/query.py,sha256=ykkOMZA7NY4poTnwPi7FTktaJJREg2PchK7sT5dTEdQ,745
+cassandra/datastax/graph/fluent/serializers.py,sha256=Pmbe9NcLMwrrck9tjWeJu_LA7tAoJp9QiQ3Tw3PD7vg,751
+cassandra/datastax/graph/graphson.py,sha256=ZA0_Wq1tnInXjOiN6JwEioC8PS6s9BHDUu1QH3QCEng,36451
+cassandra/datastax/graph/query.py,sha256=ojy__DsUMeEvQub3RABcM4VxYKcZ_cL-CUqKcBNOwn4,12000
+cassandra/datastax/graph/types.py,sha256=JMlR_WYMrSEmNqnglNI8JWnmF8qfweaYau83s_W3eAA,6008
+cassandra/datastax/insights/__init__.py,sha256=VOJIuZ1gUMKTasiqd-aI3ADKMfqL4JmvKnL6f4V-YrU,582
+cassandra/datastax/insights/__pycache__/__init__.cpython-311.pyc,,
+cassandra/datastax/insights/__pycache__/registry.cpython-311.pyc,,
+cassandra/datastax/insights/__pycache__/reporter.cpython-311.pyc,,
+cassandra/datastax/insights/__pycache__/serializers.cpython-311.pyc,,
+cassandra/datastax/insights/__pycache__/util.cpython-311.pyc,,
+cassandra/datastax/insights/registry.py,sha256=n3R3rVIjeT5z486q5cJa1Jq2BuhQDyUe7tiEyObM6BE,4473
+cassandra/datastax/insights/reporter.py,sha256=ReufeNnY4cWAMAXGuGAJVgax2dk1Ii_QR5y0PlNVpSo,9269
+cassandra/datastax/insights/serializers.py,sha256=Hc4DeKDc0k2xKm7Nd3hBK4BG4FQRj6LHG1J4KnICYnQ,10349
+cassandra/datastax/insights/util.py,sha256=_VA51HJmjwKx_1sUeGw1LOiXYnxqDJ4GwKazigqg4Tw,2402
+cassandra/deserializers.cp311-win_amd64.pyd,sha256=7tjKsylR6VN9Ph0eKKfNKVYkEdCnw9TymSf8D45zLtU,384512
+cassandra/deserializers.pxd,sha256=K_lVARGeDs09icX5rjlw9UkAksOR2ZxEXkVKIzcid_0,1726
+cassandra/deserializers.pyx,sha256=ZEVUX7nJtDWjIiRfoRGJdOHOeboTuB9heb0v9LTS8jM,17360
+cassandra/encoder.py,sha256=WM-tK3QdXN-XQ7Zvf3YMMFOUKyvc3qWUfKuyBQwQotU,7795
+cassandra/graph/__init__.py,sha256=dVguSpEuKBxzmCfrAY5utbYk41pdMJ51bW1NIl4e2pE,697
+cassandra/graph/__pycache__/__init__.cpython-311.pyc,,
+cassandra/graph/__pycache__/graphson.cpython-311.pyc,,
+cassandra/graph/__pycache__/query.cpython-311.pyc,,
+cassandra/graph/__pycache__/types.cpython-311.pyc,,
+cassandra/graph/graphson.py,sha256=D2ITYia_AK_9mut-OeG5o9NCn8SBks9LjcV923Nw7ic,708
+cassandra/graph/query.py,sha256=kUGvVEeWkqzflFAuy_JgTxPJLE47pgXGQYjWflO9EZc,705
+cassandra/graph/types.py,sha256=BfiaEQonXx7COmv07s_zh8UV4D_fkH6GXE7ZfJUGbbc,705
+cassandra/io/__init__.py,sha256=smbJec9rxrMDelC5Ehw4zUaBXFG2M_t7bjvwBMpCXKQ,584
+cassandra/io/__pycache__/__init__.cpython-311.pyc,,
+cassandra/io/__pycache__/asyncioreactor.cpython-311.pyc,,
+cassandra/io/__pycache__/asyncorereactor.cpython-311.pyc,,
+cassandra/io/__pycache__/eventletreactor.cpython-311.pyc,,
+cassandra/io/__pycache__/geventreactor.cpython-311.pyc,,
+cassandra/io/__pycache__/libevreactor.cpython-311.pyc,,
+cassandra/io/__pycache__/twistedreactor.cpython-311.pyc,,
+cassandra/io/asyncioreactor.py,sha256=B5ZsbcDnV5Zb02Q1icjPzbSPAbHEx9lJQPfTm2CGwfk,7876
+cassandra/io/asyncorereactor.py,sha256=2CYMYNMOwtdarbzo2Ltlk4OawYlAYAguS2Om3ClPw2I,15232
+cassandra/io/eventletreactor.py,sha256=3uWoBd_ZBfCcLzabFipa_ssuQczH3yPN8d4gvTBV6Ow,6920
+cassandra/io/geventreactor.py,sha256=bltFaUQrHRp9KQFF3mSgBw1LVhUe_Ja3PaXg4BxnWRI,4414
+cassandra/io/libevreactor.py,sha256=1d73pcW8y9cg1s9QYnT6pc5aWD1-z5yesrz9vaWhINM,13232
+cassandra/io/libevwrapper.c,sha256=KInPW5DOAA0H7hoNR0WhZBBxHc0sTt_ai9wBwXBd78o,23023
+cassandra/io/twistedreactor.py,sha256=DGN1fUYKAa87gNo9QSwa3BHfF8I-ZsIFqevYQCX5Tak,10636
+cassandra/ioutils.cp311-win_amd64.pyd,sha256=EeqfgtFB2BeZyubVjGT3qn8g0GqH0R_liCSSACT8V6c,19968
+cassandra/ioutils.pyx,sha256=3JQZUn0nPpqZ0G0HGhHhyQEoa0ACkXHPw15dg1g1wAI,1685
+cassandra/marshal.py,sha256=7O2fpBIHY-bc6yI67ihml0c9_hi3jCsgu4Z8MYxC0gk,4512
+cassandra/metadata.cp311-win_amd64.pyd,sha256=z-ZhJblAqg7U9K_IrDVx3xxfCpN0pLxNWGITl8pzETo,926208
+cassandra/metadata.py,sha256=tiel-PQW9e2MsOSB3HK2fWoUmjtQN8KlNPzWpLfatLc,134663
+cassandra/metrics.py,sha256=XoJZ-8D1zOOQzDuAbE5JH6ZwJMIBk82v6pgCx_KnfYQ,6777
+cassandra/murmur3.py,sha256=iyIcE_185tTN4sN8uX77lc3cTZgY48Zm0tJ9kISEDOg,2637
+cassandra/numpyFlags.h,sha256=TmmovMeNd0r0YAaACxZAtOaXpFmznqpAF_G6YVPrwBk,51
+cassandra/numpy_parser.cp311-win_amd64.pyd,sha256=05GVAlDI0fA2IAtFl-Bo57ykVRNjgHIuIJASV-7wRUw,155136
+cassandra/numpy_parser.pyx,sha256=31VJKV73owIlbHvHLJslzNVHdBXhJQ08ezIUmmTJmG0,6040
+cassandra/obj_parser.cp311-win_amd64.pyd,sha256=siJ1_oLSu5DWikYM_Tb0fsDunnKF-PSjWPzjpojmO_Q,150528
+cassandra/obj_parser.pyx,sha256=crusUv-6f2XnvuBZuRZORw4HdHg_a-WvqwbcnmvMbFI,3825
+cassandra/parsing.cp311-win_amd64.pyd,sha256=ESziSp52h2mGPF4iP91zA43Oaa_owXfcHUOkc7Ve7HI,146432
+cassandra/parsing.pxd,sha256=MXlPvPmsYMcmsth4_MAY9zr1KCxVvdFmAhZ4l8m3Igc,1148
+cassandra/parsing.pyx,sha256=E2QnReEoq8z8f_jAas4Tn9ALNN5UGBdwoARXrRiTSOU,1603
+cassandra/policies.py,sha256=BNg8axPW_pBYsoSfeEiWQc6oFZrDKBbupoRxJmel7fA,47429
+cassandra/pool.cp311-win_amd64.pyd,sha256=wm3SGt1IdQdopCaKyZJ2LDfwfiiFfu-rJFpSjgn4zeo,268800
+cassandra/pool.py,sha256=k0jVvIzBhPPcE8YTxWgTtyCqfAtT7GvobSUcQGBDiVc,35733
+cassandra/protocol.cp311-win_amd64.pyd,sha256=dVxt7WhVH3_8yXItuN6TFoBvtgICgppT9Mp8Tjbe7hc,496128
+cassandra/protocol.py,sha256=K1VyqbFFe5QWSnHpTkdqI5ssIppfxR1_GguCkTCC4p0,50337
+cassandra/query.cp311-win_amd64.pyd,sha256=60_MxOjyntknWfFF2S0MfbHE77P3Mii4uUlqJpXdv4A,256512
+cassandra/query.py,sha256=IxlqWVC0o3f4yMAjTrUbQIC8iZXV54M5YKplsn8NmbI,43860
+cassandra/row_parser.cp311-win_amd64.pyd,sha256=4xp9uLsOCUF91mjM8yjn7kf65Nfrqt2p3zoKqy5eFZs,122368
+cassandra/row_parser.pyx,sha256=TsePu9bJPyXimiLwnS7OkOxzSrRMT4K_UeZEf0K1wLM,2228
+cassandra/segment.py,sha256=8rc2KhhLZEosyea1NRzvL5O7ejNEm5ON8yQ-becOQPk,7538
+cassandra/timestamps.py,sha256=xaJZjdMihqdIUGpK7KUHWCP_1CwvG9RL-QYosPbOiHs,4026
+cassandra/tuple.pxd,sha256=ft7qF3cqhzRBNDIeeM2TPX27rEVWwuEf9vCm2DaM2sk,1622
+cassandra/type_codes.pxd,sha256=RrOd1xNWP4GySLOZXQ4OeX_dhIV87kEMWWR4HESValA,1009
+cassandra/type_codes.py,sha256=Xz1v0ptvwrwRjv5nICc8ClipZnPYW10GfwyE0vmIiVA,2018
+cassandra/util.cp311-win_amd64.pyd,sha256=ML6ilo-nvihi-6srf01tBTKvkuHU0uroXGlLoLiu4CQ,586240
+cassandra/util.py,sha256=r7tbN6uC2_NTG2q7ASlO0fn-1DcX72g8uIg9yja00dQ,58822
+cassandra_driver-3.29.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+cassandra_driver-3.29.1.dist-info/LICENSE,sha256=6z17VIVGasvYHytJb1latjfSeS4mggayfZnnk722dUk,10351
+cassandra_driver-3.29.1.dist-info/METADATA,sha256=ZV_pnDV30z0iDaPSXIW2L6LCnl6-DEVs4yFcRLPjKXc,6039
+cassandra_driver-3.29.1.dist-info/RECORD,,
+cassandra_driver-3.29.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cassandra_driver-3.29.1.dist-info/WHEEL,sha256=badvNS-y9fEq0X-qzdZYvql_JFjI7Xfw-wR8FsjoK0I,102
+cassandra_driver-3.29.1.dist-info/top_level.txt,sha256=fJ1cvfsEl8M8b-BCx_TDhkk7FmWx0S1Bli-H7iM0Jbw,16
diff --git a/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/REQUESTED b/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/REQUESTED
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/WHEEL b/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..6d160455a81f006d13b4485d8d1d7c5d50dc3a04
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.41.2)
+Root-Is-Purelib: false
+Tag: cp311-cp311-win_amd64
+
diff --git a/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/top_level.txt b/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..e26dc8144620e56755f13744e81c6e13bf31a9da
--- /dev/null
+++ b/llm/Lib/site-packages/cassandra_driver-3.29.1.dist-info/top_level.txt
@@ -0,0 +1,2 @@
+DUMMY
+cassandra
diff --git a/llm/Lib/site-packages/cassio-0.1.7.dist-info/INSTALLER b/llm/Lib/site-packages/cassio-0.1.7.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/cassio-0.1.7.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/cassio-0.1.7.dist-info/LICENSE b/llm/Lib/site-packages/cassio-0.1.7.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..261eeb9e9f8b2b4b0d119366dda99c6fd7d35c64
--- /dev/null
+++ b/llm/Lib/site-packages/cassio-0.1.7.dist-info/LICENSE
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/llm/Lib/site-packages/cassio-0.1.7.dist-info/METADATA b/llm/Lib/site-packages/cassio-0.1.7.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..a86b93cccc9d703c9ef7b0d2c0fadaef0d708691
--- /dev/null
+++ b/llm/Lib/site-packages/cassio-0.1.7.dist-info/METADATA
@@ -0,0 +1,147 @@
+Metadata-Version: 2.1
+Name: cassio
+Version: 0.1.7
+Summary: A framework-agnostic Python library to seamlessly integrate Apache Cassandra(R) with ML/LLM/genAI workloads.
+Home-page: https://cassio.org
+License: Apache-2.0
+Keywords: cassandra,ai,llm,genai,astradb
+Author: Stefano Lottini
+Author-email: stefano.lottini@datastax.com
+Requires-Python: >=3.8,<4.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Dist: cassandra-driver (>=3.28.0,<4.0.0)
+Requires-Dist: numpy (>=1.0)
+Requires-Dist: requests (>=2.31.0,<3.0.0)
+Project-URL: Repository, https://github.com/CassioML/cassio
+Description-Content-Type: text/markdown
+
+# cassIO
+
+A framework-agnostic Python library to seamlessly integrate Apache Cassandra with ML/LLM/genAI workloads.
+
+**Note**: this is currently an alpha release.
+
+## Users
+
+Installation is as simple as:
+
+```
+pip install cassio
+```
+
+For example usages and integration with higher-level LLM frameworks
+such as LangChain, please visit [cassio.org](https://cassio.org).
+
+## CassIO developers
+
+### Setup
+
+To develop `cassio`, we use poetry
+
+```shell
+pip install poetry
+```
+
+Use poetry to install dependencies
+
+```shell
+poetry install
+```
+
+#### Use cassio current code in other Poetry base projects
+
+If the integration is Poetry-based (e.g. LangChain itself), you should get this
+in your `pyproject.toml`:
+
+```
+cassio = {path = "../../cassio", develop = true}
+```
+
+Then you do
+
+```
+poetry remove cassio                                      # if necessary
+poetry lock --no-update
+poetry install -E all --with dev --with test_integration  # or similar, this is for langchain
+```
+
+[Inspired from this](https://github.com/orgs/python-poetry/discussions/1135).
+You also need a recent Poetry for this to work.
+
+#### Versioning
+
+We are still at `0.*`. Occasional breaking changes are to be expected,
+but please think carefully. Later, a stronger versioning model will be adopted.
+
+### Style and typing
+
+Style is enforced through `black`, linting with `ruff`,
+and typechecking with `mypy`.
+The code should run through `make format` without issues.
+
+### Python version coverage
+
+At the moment we try to run tests under Python3.8 and Python3.10 to try and
+catch versions-specific issues
+(such as the newer `typing` syntax such as `typeA | typeB`, illegal on 3.8).
+
+### Publishing
+
+- Bump version in pyproject.toml
+- Add to `CHANGES.txt`
+- Commit the very code that will be built:
+- `git tag v<x.y.z>; git push origin v<x.y.z>`
+
+```
+make build
+poetry publish  # (login to PyPI ...)
+```
+
+### Testing
+
+Please run tests (and add some coverage for new features). This is not
+enforced other than to your conscience. Type `make` for the available tests.
+
+To run the full tests (except specific tests targeting Cassandra),
+there's `make test-all`.
+
+#### Unit testing
+
+```
+make test-unit
+```
+
+#### Integration with the DB
+
+Ensure the required environment variables are set (see for instance
+the provided `TEMPLATE.testing.env`).
+You need at least one of either Astra DB or a
+Cassandra (5+) cluster to use.
+
+Launch the tests with either of:
+
+```
+make test-integration
+
+make test-astra-integration
+make test-cassandra-integration
+make test-testcontainerscassandra-integration
+```
+
+The last three above specify `TEST_DB_MODE` as either `LOCAL_CASSANDRA`, `TESTCONTAINERS_CASSANDRA` or
+`ASTRA_DB`. Refer to `TEMPLATE.testing.env` for required environment variables in the specific cases.
+
+_Note: Ideally you should test with both Astra DB and one Cassandra, since some tests are
+skipped in either case._
+
diff --git a/llm/Lib/site-packages/cassio-0.1.7.dist-info/RECORD b/llm/Lib/site-packages/cassio-0.1.7.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..e1d5f25eb6dda43c4991a43a5e36342f54cad7c5
--- /dev/null
+++ b/llm/Lib/site-packages/cassio-0.1.7.dist-info/RECORD
@@ -0,0 +1,68 @@
+../../Scripts/cassio-create-init-string.exe,sha256=iQqGq7kb8khpAd6MYFe8hr_Kj63tmuwT1hqedA7QNNM,108442
+cassio-0.1.7.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+cassio-0.1.7.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+cassio-0.1.7.dist-info/METADATA,sha256=Abt61ltroWpqxYlfsI3ufZy6UiWCoAg-9DZ18qKwFUo,4088
+cassio-0.1.7.dist-info/RECORD,,
+cassio-0.1.7.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+cassio-0.1.7.dist-info/entry_points.txt,sha256=IYUXenExiHDqe2jyweMdaCkI37P-bTPSyyz1Bbq6QhU,104
+cassio/__init__.py,sha256=U1fUsaVov2CjSKzz6qpuE0M8_BKOV9RTodZwGw_3Dgs,58
+cassio/__pycache__/__init__.cpython-311.pyc,,
+cassio/config/__init__.py,sha256=kkCYWOCumS8mg8VpQntA8abea97YFAeHYCd7syIume8,14765
+cassio/config/__pycache__/__init__.cpython-311.pyc,,
+cassio/config/__pycache__/bundle_download.cpython-311.pyc,,
+cassio/config/__pycache__/bundle_management.cpython-311.pyc,,
+cassio/config/bundle_download.py,sha256=SquOQLGlkL1rXjoafZom9NOJXtNMqhwhE8o92Ff_3JU,2513
+cassio/config/bundle_management.py,sha256=v07CL8LV5sGi5Oi3Sbs-gAvVgizzBJh53qLayCF4-is,5631
+cassio/db_reader/__init__.py,sha256=qAaRlT3UPA8BwQ0Pl4Jxji1yJDbOVJhQZve3wAmVzW4,132
+cassio/db_reader/__pycache__/__init__.cpython-311.pyc,,
+cassio/db_reader/__pycache__/multi_table_cassandra_reader.cpython-311.pyc,,
+cassio/db_reader/multi_table_cassandra_reader.py,sha256=tcep2NnSejp7WdiWobSyjA8vsAM3lsdHJmsAAi_rKmc,9936
+cassio/history/__init__.py,sha256=SLnQkxTyVRoCWTvIxQMWE3-ExEY5gZ3UEHCMXWedxt0,98
+cassio/history/__pycache__/__init__.cpython-311.pyc,,
+cassio/history/__pycache__/stored_blob_history.cpython-311.pyc,,
+cassio/history/stored_blob_history.py,sha256=3KcGe1a7BySm8-e-87WRpHOX2pEGyq4QHtz1A8w9fNA,2394
+cassio/keyvalue/__init__.py,sha256=KsbwIxgFBtvvZkneubEEI-vu_j_fVhzLIBfj8U1zlco,69
+cassio/keyvalue/__pycache__/__init__.cpython-311.pyc,,
+cassio/keyvalue/__pycache__/k_v_cache.cpython-311.pyc,,
+cassio/keyvalue/k_v_cache.py,sha256=PUbyohj-d-r2sfqixQxayE--SnBhHEjR_xIPDQvugVU,2267
+cassio/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cassio/table/__init__.py,sha256=N4RmCFgat3AUWkIwHXL6sEW3dVxKF0XtCVaylp-4YQk,1842
+cassio/table/__pycache__/__init__.cpython-311.pyc,,
+cassio/table/__pycache__/base_table.cpython-311.pyc,,
+cassio/table/__pycache__/cql.cpython-311.pyc,,
+cassio/table/__pycache__/query.cpython-311.pyc,,
+cassio/table/__pycache__/table_types.cpython-311.pyc,,
+cassio/table/__pycache__/tables.cpython-311.pyc,,
+cassio/table/__pycache__/utils.cpython-311.pyc,,
+cassio/table/base_table.py,sha256=MYLLlXYCS9uTQqW_NAxqjHwUWaDvd-2bPsdtNGm8ngk,22286
+cassio/table/cql.py,sha256=sn7gNwPk1JE0LNwosezZnHqkO1aPbxyAn0_f1yc1gI4,5392
+cassio/table/mixins/__init__.py,sha256=wgNkyzk3GYwIoz1UP0PXdRA6A069Es37n0YhdEdnPz4,433
+cassio/table/mixins/__pycache__/__init__.cpython-311.pyc,,
+cassio/table/mixins/__pycache__/base_table.cpython-311.pyc,,
+cassio/table/mixins/__pycache__/clustered.cpython-311.pyc,,
+cassio/table/mixins/__pycache__/elastic_key.cpython-311.pyc,,
+cassio/table/mixins/__pycache__/metadata.cpython-311.pyc,,
+cassio/table/mixins/__pycache__/type_normalizer.cpython-311.pyc,,
+cassio/table/mixins/__pycache__/vector.cpython-311.pyc,,
+cassio/table/mixins/base_table.py,sha256=OIxjUKaSKILQ45kJNoYelpm7ddt0dckqQXHX6LgKI3Q,138
+cassio/table/mixins/clustered.py,sha256=n7BT-Gi77p-8cXGoTgbtX_qDeHRYeM5WywGSgrR6C3I,7546
+cassio/table/mixins/elastic_key.py,sha256=BpATEnNPYIZJcDZkf7hnjXlaLgyEolx0Pg3PwGZrDOI,2830
+cassio/table/mixins/metadata.py,sha256=jlLsAYDuNF5lYTDzlrwcSoMWlE8ULz712xjw9g4e4bQ,14451
+cassio/table/mixins/type_normalizer.py,sha256=FsP6tBTwmiHTV1JSnYzfWEM62TJdlAli7yF7jN8I40A,1440
+cassio/table/mixins/vector.py,sha256=KGAVwyAqmnOOgC0VvAlG1hT1VupE9uLyUWKIzBpH9l4,8610
+cassio/table/query.py,sha256=A8o-q5lD-sLKjyq9aYPewOKsgCnhJqDCE5jJZicUumE,677
+cassio/table/table_types.py,sha256=w8u9-5wbjWeXwhM9e42LSmsbc7wG1GfWUYBwlv_lJHE,2181
+cassio/table/tables.py,sha256=xa5v_FF-AMCIezg5heShNNAm-auIawKgV-UaA4i1EdU,2496
+cassio/table/utils.py,sha256=gSGIhIN2J7mQ48WDDF6-MVrJc8XcofnuIiSgcu8tmlM,3026
+cassio/utils/__init__.py,sha256=07-17qhxv9VxS1VJ9uptGvnBqtUrFZW1aIDJ0QYVayk,98
+cassio/utils/__pycache__/__init__.cpython-311.pyc,,
+cassio/utils/db_inspection/__init__.py,sha256=U32NEnQ9BIRN853Raj_GPJlPe0fjBQgAGnjIfRJJ4NI,1008
+cassio/utils/db_inspection/__pycache__/__init__.cpython-311.pyc,,
+cassio/utils/vector/__init__.py,sha256=39Z2WbqBdeMh6ELQHVwm7ZR5p8IrAZ53MbSo5Tbodcs,80
+cassio/utils/vector/__pycache__/__init__.cpython-311.pyc,,
+cassio/utils/vector/__pycache__/distance_metrics.cpython-311.pyc,,
+cassio/utils/vector/distance_metrics.py,sha256=s7YenyEPW-b3PIrWNf-KtKzBsUsXOmdDrF8cz0ESVSM,2664
+cassio/vector/__init__.py,sha256=piegcn0eiDT-UunXoqqgALqsPitGZaA7P5aV23DH9Bo,78
+cassio/vector/__pycache__/__init__.cpython-311.pyc,,
+cassio/vector/__pycache__/vector_table.cpython-311.pyc,,
+cassio/vector/vector_table.py,sha256=LgebwIalDlTKPo5f_w8qC0WKXZdKuyUItjRfEuOXAZc,4356
diff --git a/llm/Lib/site-packages/cassio-0.1.7.dist-info/WHEEL b/llm/Lib/site-packages/cassio-0.1.7.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..258a6ff36f44a40ff24d2bbd6d4c934481da1402
--- /dev/null
+++ b/llm/Lib/site-packages/cassio-0.1.7.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 1.6.1
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/cassio-0.1.7.dist-info/entry_points.txt b/llm/Lib/site-packages/cassio-0.1.7.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..73fb6ef9327bd5799b51f92452d2596c2269c8db
--- /dev/null
+++ b/llm/Lib/site-packages/cassio-0.1.7.dist-info/entry_points.txt
@@ -0,0 +1,3 @@
+[console_scripts]
+cassio-create-init-string=cassio.config.bundle_management:create_init_string_utility
+
diff --git a/llm/Lib/site-packages/cassio/__init__.py b/llm/Lib/site-packages/cassio/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..929c8ae7c3dad89528ef2bb7c12643d7d75e5128
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/__init__.py
@@ -0,0 +1,5 @@
+from cassio.config import init
+
+__all__ = [
+    "init",
+]
diff --git a/llm/Lib/site-packages/cassio/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassio/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..52209d7794cd9f006441f5fc17e2440947b5ca29
Binary files /dev/null and b/llm/Lib/site-packages/cassio/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/config/__init__.py b/llm/Lib/site-packages/cassio/config/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f5688dce3762bcb84ecbd0c573a008b1a0e9454c
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/config/__init__.py
@@ -0,0 +1,355 @@
+import os
+import shutil
+import tempfile
+from typing import Any, Dict, List, Optional, Union
+
+from cassandra.auth import PlainTextAuthProvider
+from cassandra.cluster import Cluster, Session
+
+from cassio.config.bundle_download import download_astra_bundle_url
+from cassio.config.bundle_management import (
+    infer_keyspace_from_bundle,
+    init_string_to_bundle_path_and_options,
+)
+
+ASTRA_CLOUD_AUTH_USERNAME = "token"
+DOWNLOADED_BUNDLE_FILE_NAME = "secure-connect-bundle_devopsapi.zip"
+
+default_session: Optional[Session] = None
+default_keyspace: Optional[str] = None
+
+
+def init(
+    auto: bool = False,
+    session: Optional[Session] = None,
+    secure_connect_bundle: Optional[str] = None,
+    init_string: Optional[str] = None,
+    token: Optional[str] = None,
+    database_id: Optional[str] = None,
+    keyspace: Optional[str] = None,
+    contact_points: Optional[Union[str, List[str]]] = None,
+    username: Optional[str] = None,
+    password: Optional[str] = None,
+    cluster_kwargs: Optional[Dict[str, Any]] = None,
+    tempfile_basedir: Optional[str] = None,
+    bundle_url_template: Optional[str] = None,
+    cloud_kwargs: Optional[Dict[str, Any]] = None,
+) -> None:
+    """
+    Globally set the default Cassandra connection (/keyspace) for CassIO.
+    This default will be used by all other db-requiring CassIO instantiations,
+    unless passed to the respective classes' __init__.
+
+    There are various ways to achieve this, depending on the passed parameters.
+    Broadly speaking, this method allows to pass one's own ready Session,
+    or to have it created in the method. For this second case, both Astra DB
+    and a regular Cassandra cluster can be targeted.
+    One can also simply call cassio.init(auto=True) and let it figure out
+    what to do based on standard environment variables.
+
+    CASSANDRA
+    If one passes `contact_points`, it is assumed that this is Cassandra.
+    In that case, only the following arguments will be used:
+    `contact_points`, `keyspace`, `username`, `password`, `cluster_kwargs`
+    Note that when passing a `session` all other parameters are ignored.
+
+    ASTRA DB:
+    If `contact_points` is not passed, one of several methods to connect to
+    Astra should be supplied for the connection to Astra. These overlap:
+    see below for their precedence.
+    Note that when passing a `session` all other parameters are ignored.
+
+    AUTO:
+    If passing auto=True, no other parameter is allowed except for
+    `tempfile_basedir`. The rest, including choosing Astra DB / Cassandra,
+    is autofilled by inspecting the following environment variables:
+        CASSANDRA_CONTACT_POINTS
+        CASSANDRA_USERNAME
+        CASSANDRA_PASSWORD
+        CASSANDRA_KEYSPACE
+        ASTRA_DB_APPLICATION_TOKEN
+        ASTRA_DB_INIT_STRING
+        ASTRA_DB_SECURE_BUNDLE_PATH
+        ASTRA_DB_KEYSPACE
+        ASTRA_DB_DATABASE_ID
+
+    PARAMETERS:
+        `auto`: (bool = False), whether to auto-guess all connection params.
+        `session` (optional cassandra.cluster.Session), an established connection.
+        `secure_connect_bundle` (optional str), full path to a Secure Bundle.
+        `init_string` (optional str), a stand-alone "db init string" credential
+            (which can optionally contain keyspace and/or token).
+        `token` (optional str), the Astra DB "AstraCS:..." token.
+        `database_id` (optional str), the Astra DB ID. Used only for Astra
+            connections with no `secure_connect_bundle` parameter passed.
+        `keyspace` (optional str), the keyspace to work.
+        `contact_points` (optional List[str]), for Cassandra connection
+        `username` (optional str), username for Cassandra connection
+        `password` (optional str), password for Cassandra connection
+        `cluster_kwargs` (optional dict), additional arguments to `Cluster(...)`.
+        `tempfile_basedir` (optional str), where to create temporary work directories.
+        `bundle_url_template` (optional str), url template for getting the database
+            secure bundle. The "databaseId" variable is resolved with the actual value.
+            Default (for Astra DB):
+                "https://api.astra.datastax.com/v2/databases/{database_id}/secureBundleURL"
+        `cloud_kwargs` (optional dict), additional arguments to `Cluster(cloud={...})`
+            (i.e. additional key-value pairs within the passed `cloud` dict).
+
+    ASTRA DB:
+    The Astra-related parameters are arranged in a chain of fallbacks.
+    In case redundant information is supplied, these are the precedences:
+        session > secure_connect_bundle > init_string
+        token > (from init_string if any)
+        keyspace > (from init_string if any) > (from bundle if any)
+    If a secure-connect-bundle is needed and not passed, it will be downloaded:
+        this requires `database_id` to be passed, suitable token permissions.
+    Constraints and caveats:
+        `secure_connect_bundle` requires `token`.
+        `session` does not make use of `cluster_kwargs` and will ignore it.
+
+    The Session is created at `init` time and kept around, available to any
+    subsequent table creation. If calling `init` a second time, a new Session
+    will be made available replacing the previous one.
+    """
+    global default_session
+    global default_keyspace
+    temp_dir_created: bool = False
+    temp_dir: Optional[str] = None
+    direct_session: Optional[Session] = None
+    bundle_from_is: Optional[str] = None
+    bundle_from_arg: Optional[str] = None
+    bundle_from_download: Optional[str] = None
+    keyspace_from_is: Optional[str] = None
+    keyspace_from_bundle: Optional[str] = None
+    keyspace_from_arg: Optional[str] = None
+    token_from_is: Optional[str] = None
+    token_from_arg: Optional[str] = None
+    #
+    if auto:
+        if any(
+            v is not None
+            for v in (
+                session,
+                secure_connect_bundle,
+                init_string,
+                token,
+                database_id,
+                keyspace,
+                contact_points,
+                username,
+                password,
+                # cluster_kwargs is allowed
+                # tempfile_basedir is allowed
+                bundle_url_template,
+                cloud_kwargs,
+            )
+        ):
+            raise ValueError(
+                "When auto=True, no arguments can be passed other than "
+                "tempfile_basedir and cluster_kwargs."
+            )
+        # setting some arguments from environment variables
+        if "CASSANDRA_CONTACT_POINTS" in os.environ:
+            contact_points = os.environ["CASSANDRA_CONTACT_POINTS"]
+            username = os.environ.get("CASSANDRA_USERNAME")
+            password = os.environ.get("CASSANDRA_PASSWORD")
+            keyspace = os.environ.get("CASSANDRA_KEYSPACE")
+        elif any(
+            avar in os.environ
+            for avar in [
+                "ASTRA_DB_APPLICATION_TOKEN",
+                "ASTRA_DB_INIT_STRING",
+            ]
+        ):
+            token = os.environ.get("ASTRA_DB_APPLICATION_TOKEN")
+            init_string = os.environ.get("ASTRA_DB_INIT_STRING")
+            secure_connect_bundle = os.environ.get("ASTRA_DB_SECURE_BUNDLE_PATH")
+            keyspace = os.environ.get("ASTRA_DB_KEYSPACE")
+            database_id = os.environ.get("ASTRA_DB_DATABASE_ID")
+    #
+    try:
+        # process init_string
+        base_dir = tempfile_basedir if tempfile_basedir else tempfile.gettempdir()
+        if init_string:
+            temp_dir = tempfile.mkdtemp(dir=base_dir)
+            temp_dir_created = True
+            bundle_from_is, options_from_is = init_string_to_bundle_path_and_options(
+                init_string,
+                target_dir=temp_dir,
+            )
+            keyspace_from_is = options_from_is.get("keyspace")
+            token_from_is = options_from_is.get("token")
+        # for the session
+        if session:
+            direct_session = session
+        if secure_connect_bundle:
+            if not token:
+                raise ValueError(
+                    "`token` is required if `secure_connect_bundle` is passed"
+                )
+        # params from arguments:
+        bundle_from_arg = secure_connect_bundle
+        token_from_arg = token
+        keyspace_from_arg = keyspace
+        can_be_astra = any(
+            [
+                secure_connect_bundle is not None,
+                init_string is not None,
+                token is not None,
+            ]
+        )
+        # resolution of priority among args
+        if direct_session:
+            default_session = direct_session
+        else:
+            # first determine if Cassandra or Astra
+            is_cassandra = all(
+                [
+                    secure_connect_bundle is None,
+                    init_string is None,
+                    token is None,
+                    contact_points is not None,
+                ]
+            )
+            if is_cassandra:
+                is_astra_db = False
+            else:
+                # determine if Astra DB
+                is_astra_db = can_be_astra
+            #
+            if is_cassandra:
+                # need to take care of:
+                #   contact_points, username, password, cluster_kwargs
+                chosen_contact_points: Union[List[str], None]
+                if contact_points:
+                    if isinstance(contact_points, str):
+                        chosen_contact_points = [
+                            cp.strip() for cp in contact_points.split(",") if cp.strip()
+                        ]
+                    else:
+                        # assume it's a list already
+                        chosen_contact_points = contact_points
+                else:
+                    # normalize "" to None for later `Cluster(...)` call
+                    chosen_contact_points = None
+                #
+                if username is not None and password is not None:
+                    chosen_auth_provider = PlainTextAuthProvider(
+                        username,
+                        password,
+                    )
+                else:
+                    if username is not None or password is not None:
+                        raise ValueError(
+                            "Please provide both usename/password or none."
+                        )
+                    else:
+                        chosen_auth_provider = None
+                #
+                if chosen_contact_points is None:
+                    cluster = Cluster(
+                        auth_provider=chosen_auth_provider,
+                        **(cluster_kwargs if cluster_kwargs is not None else {}),
+                    )
+                else:
+                    cluster = Cluster(
+                        contact_points=chosen_contact_points,
+                        auth_provider=chosen_auth_provider,
+                        **(cluster_kwargs if cluster_kwargs is not None else {}),
+                    )
+                default_session = cluster.connect()
+            elif is_astra_db:
+                # Astra DB
+                chosen_token = _first_valid(token_from_arg, token_from_is)
+                if chosen_token is None:
+                    raise ValueError(
+                        "A token must be supplied if connection is to be established."
+                    )
+                chosen_bundle_pre_token = _first_valid(bundle_from_arg, bundle_from_is)
+                # Try to get the bundle from the token if not supplied otherwise
+                if chosen_bundle_pre_token is None:
+                    if database_id is None:
+                        raise ValueError(
+                            "A database_id must be supplied if no "
+                            "secure_connect_bundle is provided."
+                        )
+                    if not temp_dir_created:
+                        temp_dir = tempfile.mkdtemp(dir=base_dir)
+                        temp_dir_created = True
+                    bundle_from_download = os.path.join(
+                        temp_dir or "", DOWNLOADED_BUNDLE_FILE_NAME
+                    )
+                    download_astra_bundle_url(
+                        database_id,
+                        chosen_token,
+                        bundle_from_download,
+                        bundle_url_template,
+                    )
+                # After the devops-api part, re-evaluate chosen_bundle:
+                chosen_bundle = _first_valid(
+                    bundle_from_download, chosen_bundle_pre_token
+                )
+                #
+                if chosen_bundle:
+                    keyspace_from_bundle = infer_keyspace_from_bundle(chosen_bundle)
+                    cluster = Cluster(
+                        cloud={
+                            "secure_connect_bundle": chosen_bundle,
+                            **(cloud_kwargs if cloud_kwargs is not None else {}),
+                        },
+                        auth_provider=PlainTextAuthProvider(
+                            ASTRA_CLOUD_AUTH_USERNAME,
+                            chosen_token,
+                        ),
+                        **(cluster_kwargs if cluster_kwargs is not None else {}),
+                    )
+                    default_session = cluster.connect()
+                else:
+                    raise ValueError("No secure-connect-bundle was available.")
+        # keyspace to be resolved in any case
+        chosen_keyspace = _first_valid(
+            keyspace_from_arg, keyspace_from_is, keyspace_from_bundle
+        )
+        default_keyspace = chosen_keyspace
+    finally:
+        if temp_dir_created and temp_dir is not None:
+            shutil.rmtree(temp_dir)
+
+
+def resolve_session(arg_session: Optional[Session] = None) -> Optional[Session]:
+    """Utility to fall back to the global defaults when null args are passed."""
+    if arg_session is not None:
+        return arg_session
+    else:
+        return default_session
+
+
+def check_resolve_session(arg_session: Optional[Session] = None) -> Session:
+    s = resolve_session(arg_session)
+    if s is None:
+        raise ValueError("DB session not set.")
+    else:
+        return s
+
+
+def resolve_keyspace(arg_keyspace: Optional[str] = None) -> Optional[str]:
+    """Utility to fall back to the global defaults when null args are passed."""
+    if arg_keyspace is not None:
+        return arg_keyspace
+    else:
+        return default_keyspace
+
+
+def check_resolve_keyspace(arg_keyspace: Optional[str] = None) -> str:
+    s = resolve_keyspace(arg_keyspace)
+    if s is None:
+        raise ValueError("DB keyspace not set.")
+    else:
+        return s
+
+
+def _first_valid(*pargs: Any) -> Union[Any, None]:
+    for entry in pargs:
+        if entry is not None:
+            return entry
+    return None
diff --git a/llm/Lib/site-packages/cassio/config/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassio/config/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e0ec3ecf0bfcf85431ac23444c5bf458bd67fe2
Binary files /dev/null and b/llm/Lib/site-packages/cassio/config/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/config/__pycache__/bundle_download.cpython-311.pyc b/llm/Lib/site-packages/cassio/config/__pycache__/bundle_download.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c4c706ffc0fc06f3071aa903de113c0ada8a63df
Binary files /dev/null and b/llm/Lib/site-packages/cassio/config/__pycache__/bundle_download.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/config/__pycache__/bundle_management.cpython-311.pyc b/llm/Lib/site-packages/cassio/config/__pycache__/bundle_management.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..343659a9ab86c6f92c61e31e5fd6aca0e968b08c
Binary files /dev/null and b/llm/Lib/site-packages/cassio/config/__pycache__/bundle_management.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/config/bundle_download.py b/llm/Lib/site-packages/cassio/config/bundle_download.py
new file mode 100644
index 0000000000000000000000000000000000000000..5a57cdd32d5e8e6afd76eb8d937e9c80b6fed0a7
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/config/bundle_download.py
@@ -0,0 +1,79 @@
+"""
+Facilities to manage the download of a secure-connect-bundle from an Astra DB
+token.
+"""
+import logging
+from typing import Optional
+
+import requests
+
+DEFAULT_GET_BUNDLE_URL_TEMPLATE = (
+    "https://api.astra.datastax.com/v2/databases/{database_id}/secureBundleURL"
+)
+
+
+logger = logging.getLogger(__name__)
+
+
+def get_astra_bundle_url(
+    database_id: str, token: str, bundle_url_template: Optional[str] = None
+) -> str:
+    """
+    Given a database ID and a token, provide a (temporarily-valid)
+    URL for downloading the secure-connect-bundle.
+
+    Courtesy of @phact (thank you!).
+    """
+    if not bundle_url_template:
+        bundle_url_template = DEFAULT_GET_BUNDLE_URL_TEMPLATE
+    url = bundle_url_template.format(database_id=database_id)
+    headers = {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
+
+    logger.debug(f"Obtaining SCB URL from: {url}")
+    response = requests.post(url, headers=headers)
+    logger.debug(f"SCB URL response: {response.text}")
+
+    response_json = response.json()
+    # Print the response
+    if response_json is not None:
+        if "errors" in response_json:
+            # Handle the errors
+            errors = response_json["errors"]
+            if any(
+                "jwt not valid" in (err.get("message") or "").lower() for err in errors
+            ):
+                raise ValueError("Invalid or insufficient token.")
+            elif any(
+                "malformed" in (err.get("message") or "").lower() for err in errors
+            ):
+                raise ValueError("Invalid or insufficient token.")
+            else:
+                raise ValueError(
+                    "Generic error when fetching the URL to the secure-bundle."
+                )
+        else:
+            return str(response_json["downloadURL"])
+    else:
+        raise ValueError(
+            "Cannot get the secure-bundle URL. "
+            "Check the provided database_id and token."
+        )
+
+
+def download_astra_bundle_url(
+    database_id: str,
+    token: str,
+    out_file_path: str,
+    bundle_url_template: Optional[str] = None,
+) -> None:
+    """
+    Obtain the secure-connect-bundle and save it to a specified file.
+    """
+    bundle_url = get_astra_bundle_url(
+        database_id=database_id, token=token, bundle_url_template=bundle_url_template
+    )
+    logger.debug(f"Downloading SCB from: {bundle_url}")
+    bundle_data = requests.get(bundle_url)
+    with open(out_file_path, "wb") as f:
+        f.write(bundle_data.content)
+    return
diff --git a/llm/Lib/site-packages/cassio/config/bundle_management.py b/llm/Lib/site-packages/cassio/config/bundle_management.py
new file mode 100644
index 0000000000000000000000000000000000000000..4981a2d6d70a39132d5bf91d6f40260191e6de5f
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/config/bundle_management.py
@@ -0,0 +1,169 @@
+"""
+Facilities to manage the conversion between secure-connect-bundle (plus
+additional info) and the "init string".
+"""
+import base64
+import json
+import os
+import shutil
+import tempfile
+from typing import Any, Dict, Optional, Tuple
+from zipfile import ZipFile
+
+CONFIG_FILE_NAME = "config.json"
+USED_CONFIG_KEYS_AND_DEFAULTS = {
+    "caCertLocation": "./ca.crt",
+    "keyLocation": "./key",
+    "certLocation": "./cert",
+}
+
+
+def encode_str(sng: str) -> str:
+    return base64.b64encode(sng.encode()).decode()
+
+
+def decode_str(b64: str) -> str:
+    return base64.b64decode(b64).decode()
+
+
+def _encode_from_string(s: str) -> str:
+    return encode_str(s)
+
+
+def _encode_from_file(file_dir: str, file_title: str) -> str:
+    file_path = os.path.join(file_dir, file_title)
+    with open(file_path) as o_file:
+        return o_file.read()
+
+
+def _clean_filename(fn: str) -> str:
+    if fn[:2] == "./":
+        return fn[2:]
+    else:
+        return fn
+
+
+def infer_keyspace_from_bundle(bundle_path: Optional[str]) -> Optional[str]:
+    """
+    Given a bundle zipfile path, try to peek at its config.json
+    and extract a default keyspace name on it.
+    Do not raise errors: rather, silently return None instead.
+    """
+    if bundle_path:
+        try:
+            bundle_zip = ZipFile(bundle_path)
+            open_config = bundle_zip.open("config.json")
+            ascii_lines = [line.decode() for line in open_config.readlines()]
+            config = json.loads("".join(ascii_lines))
+            return str(config["keyspace"]) if "keyspace" in config else None
+        except Exception:
+            return None
+    else:
+        return None
+
+
+def bundle_path_to_init_string(
+    secure_bundle: str,
+    keyspace: Optional[str] = None,
+    token: Optional[str] = None,
+    tempfile_basedir: Optional[str] = None,
+) -> str:
+    """
+    Utility function. Make the provided bundle zip into a "init string".
+
+    1. Unzip the provided bundle to a temp dir
+    2. Read and acquire (selected) contents of the zip
+    3. prepare the big json bundle description
+    4. make the latter into a big "init string"
+    5. delete the temporary dir
+    """
+    with ZipFile(secure_bundle) as zipfile:
+        base_dir = tempfile_basedir if tempfile_basedir else tempfile.gettempdir()
+        temp_dir = tempfile.mkdtemp(dir=base_dir)
+        try:
+            # read config.json and find the filenames to get
+            zipfile.extract(CONFIG_FILE_NAME, path=temp_dir)
+            filenames = [CONFIG_FILE_NAME]
+            config = json.load(open(os.path.join(temp_dir, CONFIG_FILE_NAME)))
+            filenames += [
+                _clean_filename(config.get(cfg_k, default))
+                for cfg_k, default in USED_CONFIG_KEYS_AND_DEFAULTS.items()
+            ]
+            for filename in filenames:
+                zipfile.extract(filename, path=temp_dir)
+            #
+            bundle_data = {
+                filename: _encode_from_file(temp_dir, filename)
+                for filename in filenames
+            }
+            #
+            bundle_description = {
+                "bundle_data": bundle_data,
+                "options": {
+                    "version": "1",
+                    "bundle_file_name": os.path.split(secure_bundle)[1],
+                    "keyspace": keyspace,
+                    "token": token,
+                },
+            }
+            #
+            init_string = encode_str(
+                json.dumps(
+                    bundle_description,
+                    separators=(",", ":"),
+                )
+            )
+            return init_string
+        finally:
+            shutil.rmtree(temp_dir)
+
+
+def init_string_to_bundle_path_and_options(
+    init_string: str, target_dir: str
+) -> Tuple[str, Dict[str, Any]]:
+    """
+    Make an init string back into a usable secure-connect-bundle.
+    Return
+        (bundle_path, options_dict)
+    where options_dict is any additional info found in the init string
+    beyond the bundle contents.
+    """
+    bundle_description = json.loads(decode_str(init_string))
+    options_dict = bundle_description.get("options", {})
+    version = options_dict.get("version")
+    if version == "1":
+        bundle_data = bundle_description["bundle_data"]
+        bundle_file_name = options_dict.get(
+            "bundle_file_name", "secure-connect-bundle.zip"
+        )
+        bundle_filepath = os.path.join(target_dir, bundle_file_name)
+        with ZipFile(bundle_filepath, "w") as bundle_zip_file:
+            for f_name, f_contents in bundle_data.items():
+                bundle_zip_file.writestr(f_name, data=f_contents)
+        return bundle_filepath, options_dict
+    else:
+        raise ValueError(f"Init string has unsupported or unknown version {version}.")
+
+
+def create_init_string_utility() -> None:
+    # Utility command-line: converts the full bundle path (argument)
+    # to an "init string" and prints it as an export line
+    import sys
+
+    if sys.argv[1:] == [] or len(sys.argv) > 4:
+        cmd = sys.argv[0]
+        print(f"Usage: {cmd} bundle_path [keyspace [token]]")
+    else:
+        bundle_path = sys.argv[1]
+        keyspace = None if len(sys.argv) < 3 else sys.argv[2]
+        token = None if len(sys.argv) < 4 else sys.argv[3]
+        print(f'- Input bundle path: "{bundle_path}".')
+        print(f"- Keyspace={'Y' if keyspace else 'N'}.")
+        print(f"- Token={'Y' if token else 'N'}.")
+        this_init_string = bundle_path_to_init_string(bundle_path, keyspace, token)
+        print("=> Export command:")
+        print(f'export ASTRA_DB_INIT_STRING="{this_init_string}"')
+
+
+if __name__ == "__main__":
+    create_init_string_utility()
diff --git a/llm/Lib/site-packages/cassio/db_reader/__init__.py b/llm/Lib/site-packages/cassio/db_reader/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5c919ee314576aebce6b15511c33ecd65ee1eae2
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/db_reader/__init__.py
@@ -0,0 +1,5 @@
+from cassio.db_reader.multi_table_cassandra_reader import MultiTableCassandraReader
+
+__all__ = [
+    "MultiTableCassandraReader",
+]
diff --git a/llm/Lib/site-packages/cassio/db_reader/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassio/db_reader/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f0525a776802765f92dc839e91611da71a7842e0
Binary files /dev/null and b/llm/Lib/site-packages/cassio/db_reader/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/db_reader/__pycache__/multi_table_cassandra_reader.cpython-311.pyc b/llm/Lib/site-packages/cassio/db_reader/__pycache__/multi_table_cassandra_reader.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..468cab81efb1e36b2845086dfea280c2f79f4ab2
Binary files /dev/null and b/llm/Lib/site-packages/cassio/db_reader/__pycache__/multi_table_cassandra_reader.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/db_reader/multi_table_cassandra_reader.py b/llm/Lib/site-packages/cassio/db_reader/multi_table_cassandra_reader.py
new file mode 100644
index 0000000000000000000000000000000000000000..831ca9cf70a5efe172cc20f7cec0edbeed721676
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/db_reader/multi_table_cassandra_reader.py
@@ -0,0 +1,272 @@
+"""
+A reader able to resolve single-row lookups from several Cassandra tables
+in a given keyspace, with a fair amount of metadata inspection.
+"""
+
+from functools import reduce
+from itertools import groupby
+from operator import itemgetter
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    Optional,
+    Set,
+    Tuple,
+    TypeVar,
+    Union,
+    cast,
+)
+
+from cassandra.concurrent import ExecutionResult, execute_concurrent
+from cassandra.query import PreparedStatement
+
+from cassio.config import check_resolve_keyspace, check_resolve_session
+from cassio.table.cql import SELECT_CQL_TEMPLATE
+from cassio.table.table_types import SessionType
+from cassio.utils.db_inspection import table_partitionkey
+
+C = TypeVar("C")
+ColumnOrFunctionType = Union[str, Callable[[Dict[str, Any]], C]]
+
+
+def _ensure_full_extraction_tuple(
+    tpl: Tuple[Any, ...], admit_nulls: bool
+) -> Tuple[Any, ...]:
+    """
+    Normalize a tuple, used to describe how to extract a value from a table,
+    into the full form (table, column_or_function, admit_nulls, default).
+    The input tuple can be shorter to an extent.
+    """
+    if len(tpl) < 2:
+        raise ValueError(
+            "At least table and column names are required in the field_mapper."
+        )
+    elif len(tpl) == 2:
+        return tuple(list(tpl) + [admit_nulls, None])
+    elif len(tpl) == 3:
+        return tuple(list(tpl) + [None])
+    elif len(tpl) == 4:
+        return tpl
+    else:
+        raise ValueError(
+            "Cannot specify more than (table, column_or_function, "
+            "admit_nulls, default) in the field_mapper."
+        )
+
+
+def _extract_first_row(e_r: ExecutionResult) -> Union[None, Dict[str, Any]]:
+    """
+    Given an "ExecutionResult" as those in the list returned by
+    `execute_concurrent`, make sure the row is made into a dict (or None)
+    """
+    if not e_r[0]:
+        raise ValueError(f"Error reading from DB: {e_r[1]}")
+    else:
+        row = e_r[1].one()
+        if row:
+            if isinstance(row, dict):
+                return row
+            else:
+                return cast(Dict[str, Any], row._asdict())
+        else:
+            return None
+
+
+def _pick_value(
+    field_name: str,
+    row_dict: Optional[Dict[str, Any]],
+    column_or_function: ColumnOrFunctionType[C],
+    admit_nulls: bool,
+    default: C,
+) -> Union[C, None]:
+    """
+    Apply a full prescription to extract a value to the dict of a row
+    and end up with (either raising an exception or) the required value.
+    """
+    if row_dict is None:
+        _v = None
+    else:
+        if callable(column_or_function):
+            _v = column_or_function(row_dict)
+        else:
+            _v = cast(C, row_dict[column_or_function])
+    #
+    if _v is None:
+        if admit_nulls:
+            return default
+        else:
+            raise ValueError('Null data found for "%s"' % field_name)
+    else:
+        return _v
+
+
+class MultiTableCassandraReader:
+    """
+    A DB-bound reader able to run lookup(s) on Cassandra table(s)
+    and come up with the required value found on DB when provided
+    with the required fields forming the (union of the) primary key(s).
+
+    When instantiated, this will do some schema inspection and come up
+    with a set of queries. When being __call__'ed, these queries are run
+    and the rows that are found are made into a final (dict) answer.
+
+    This can work on multiple tables and requires the full primary
+    key fields to single out up to a single row in each table
+    (i.e. there is no concept of multiple rows for a given query).
+
+    Fallback behaviour when rows are not found can be configured.
+    """
+
+    def __init__(
+        self,
+        field_mapper: Dict[str, Tuple[Any, ...]],
+        admit_nulls: bool,
+        session: Optional[SessionType] = None,
+        keyspace: Optional[str] = None,
+    ):
+        """
+        Creates a MultiTableCassandraReader ready to do lookups from some tables.
+        The reader, when invoked, returns a map {field_name: field_value}, where
+        the field names are not necessarily related to column names on DB.
+
+        Parameters:
+            `field_mapper`: this is a map {field_name: prescription} detailing
+                how each field is obtained. The `prescription` can have the
+                following shapes:
+                    (table_name, column_spec)
+                    (table_name, column_spec, admit_nulls)
+                    (table_name, column_spec, admit_nulls, default)
+                where the defaults for the last two are the class-level
+                `admit_nulls` and None respectively.
+                The table_name is a string, while column_spec can be
+                    - a string, the column name
+                    - a callable, a user-supplied function row_as_dict -> value
+            `admit_nulls` (boolean): whether to quietly return None if rows
+                are not found, or raise an error. This is overridden by per-field
+                settings, if provided.
+            `session` (optional Session): defaults to global setting if available
+            `keyspace` (optional str): defaults to global setting if available
+        """
+        self.session = check_resolve_session(session)
+        self.keyspace = check_resolve_keyspace(keyspace)
+        #
+        _field_mapper = {
+            k: _ensure_full_extraction_tuple(v, admit_nulls)
+            for k, v in field_mapper.items()
+        }
+        self.field_mapper = _field_mapper
+        # Survey what columns (or '*') to query from which tables
+        by_table = groupby(self.field_mapper.values(), itemgetter(0))
+        _columns_by_table = {
+            table_name: {
+                col_name if not callable(col_name) else "*"
+                for (_, col_name, _, _) in table_group
+            }
+            for table_name, table_group in by_table
+        }
+        self.columns_by_table = {
+            table_name: sorted(column_name_set if "*" not in column_name_set else {"*"})
+            for table_name, column_name_set in _columns_by_table.items()
+        }
+        # Prepare map of primary key columns needed per table
+        self.table_names = sorted(self.columns_by_table.keys())
+        self.primary_key_map = {
+            table: sorted(
+                [
+                    col_name
+                    for col_name, _ in table_partitionkey(
+                        self.session,
+                        self.keyspace,
+                        table,
+                    )
+                ]
+            )
+            for table in self.table_names
+        }
+        # Prepare queries in a table_name -> statement map
+        query_cql_map: Dict[str, str] = {
+            table_name: SELECT_CQL_TEMPLATE.format(
+                columns_desc=", ".join(sorted(column_name_set)),
+                where_clause="WHERE "
+                + " AND ".join(
+                    f"{primary_key_col_name} = ?"
+                    for primary_key_col_name in self.primary_key_map[table_name]
+                ),
+                limit_clause="LIMIT 1",
+            ).format(table_fqname=f"{self.keyspace}.{table_name}")
+            for table_name, column_name_set in self.columns_by_table.items()
+        }
+        self.query_statements: Dict[str, PreparedStatement] = {
+            table_name: self.session.prepare(cql_statement)
+            for table_name, cql_statement in query_cql_map.items()
+        }
+
+        # reduction across all tables to all primary-key values needed
+        # (this merger function makes the type checker happy over a lambda)
+        def _set_merger(s1: Iterable[str], s2: Iterable[str]) -> Set[str]:
+            return {itm for s in (s1, s2) for itm in s}
+
+        self.input_parameters: Set[str] = reduce(
+            _set_merger,
+            self.primary_key_map.values(),
+            cast(Set[str], set()),
+        )
+        self.output_parameters = set(field_mapper.keys())
+
+    def dictionary_based_call(self, args_dict: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Turn the __call__ signature
+            a, b, c => fields_map
+        into a dict-based form
+            {'a': a, 'b': b, 'c': c} => fields_map
+        """
+        return self(**args_dict)
+
+    def __call__(self, **kwargs: Any) -> Dict[str, Any]:
+        """
+        Given the union of all the primary key fields from all tables involved,
+        run the necessary lookups, extracts the requested columns (or values,
+        in general) and return a dictionary {field_name: field_value}.
+
+        Note: in a given lookup step, one cannot request different values for
+        a same-named primary-key column on different tables.
+        """
+        # prepare value tuples for the queries
+        values_map = {
+            table_name: tuple(kwargs[primary_key] for primary_key in primary_keys)
+            for table_name, primary_keys in self.primary_key_map.items()
+        }
+        # launch the queries
+        results0 = execute_concurrent(
+            self.session,
+            [
+                (self.query_statements[table_name], values_map[table_name])
+                for table_name in self.table_names
+            ],
+            raise_on_first_error=True,
+            results_generator=False,
+        )
+        # normalize the results
+        query_result_map = {
+            table_name: _extract_first_row(exc_result)
+            for table_name, exc_result in zip(self.table_names, results0)
+        }
+        # finalize as requested in the field mapper
+        results = {
+            output_field: _pick_value(
+                output_field,
+                query_result_map[table_name],
+                column_or_function,
+                admit_nulls,
+                default,
+            )
+            for output_field, (
+                table_name,
+                column_or_function,
+                admit_nulls,
+                default,
+            ) in self.field_mapper.items()
+        }
+        return results
diff --git a/llm/Lib/site-packages/cassio/history/__init__.py b/llm/Lib/site-packages/cassio/history/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..932b3ca7f96bb1e3864e2a3f48e9ad33ad684d0e
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/history/__init__.py
@@ -0,0 +1,3 @@
+from cassio.history.stored_blob_history import StoredBlobHistory
+
+__all__ = ["StoredBlobHistory"]
diff --git a/llm/Lib/site-packages/cassio/history/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassio/history/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4fd739a24d52b3ff331cdd2772952ba1b72a81fa
Binary files /dev/null and b/llm/Lib/site-packages/cassio/history/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/history/__pycache__/stored_blob_history.cpython-311.pyc b/llm/Lib/site-packages/cassio/history/__pycache__/stored_blob_history.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4c4814dc52f31b6beafa2a1cd9a7a6cd94faa226
Binary files /dev/null and b/llm/Lib/site-packages/cassio/history/__pycache__/stored_blob_history.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/history/stored_blob_history.py b/llm/Lib/site-packages/cassio/history/stored_blob_history.py
new file mode 100644
index 0000000000000000000000000000000000000000..c6988a69e7b4b5b6dd878c585b434a54030e2db7
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/history/stored_blob_history.py
@@ -0,0 +1,75 @@
+"""
+management of "history" of stored blobs, grouped
+by some 'session id'. Overwrites are not supported by design.
+"""
+
+import uuid
+from typing import Any, Iterable, Optional
+from warnings import warn
+
+from cassandra.cluster import Session
+
+from cassio.table.tables import ClusteredCassandraTable
+
+
+class StoredBlobHistory:
+    """
+    This class is a rewriting of the StoredBlobHistory created for use in LangChain
+    integration, this time relying on the class-table-hierarchy (cassio.table.*).
+
+    It mostly provides a translation layer between parameters and key names,
+    using a clustered table class internally.
+
+    Additional kwargs, for use in this new table class, are passed as they are
+    in order to enable their usage already before adapting the LangChain
+    integration code.
+    """
+
+    DEPRECATION_MESSAGE = (
+        "Class `StoredBlobHistory` is a legacy construct and "
+        "will be deprecated in future versions of CassIO."
+    )
+
+    def __init__(self, session: Session, keyspace: str, table_name: str, **kwargs: Any):
+        #
+        warn(self.DEPRECATION_MESSAGE, DeprecationWarning, stacklevel=2)
+        # specifications are added such as the type of the row_id
+        full_kwargs = {
+            **kwargs,
+            **{
+                "primary_key_type": ["TEXT", "TIMEUUID"],
+                # latest entries are returned first
+                "ordering_in_partition": "DESC",
+            },
+        }
+        self.table = ClusteredCassandraTable(
+            session=session,
+            keyspace=keyspace,
+            table=table_name,
+            **full_kwargs,
+        )
+
+    def store(self, session_id: str, blob: str, ttl_seconds: Optional[int]) -> None:
+        this_row_id = uuid.uuid1()
+        self.table.put(
+            partition_id=session_id,
+            row_id=this_row_id,
+            body_blob=blob,
+            ttl_seconds=ttl_seconds,
+        )
+
+    def retrieve(
+        self, session_id: str, max_count: Optional[int] = None
+    ) -> Iterable[str]:
+        # The latest are returned, in chronological order
+        return [
+            row["body_blob"]
+            for row in self.table.get_partition(
+                partition_id=session_id,
+                n=max_count,
+            )
+        ][::-1]
+
+    def clear_session_id(self, session_id: str) -> None:
+        self.table.delete_partition(session_id)
+        return None
diff --git a/llm/Lib/site-packages/cassio/keyvalue/__init__.py b/llm/Lib/site-packages/cassio/keyvalue/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d0ac38f7a36ddf0a3956228a7620ec305934320
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/keyvalue/__init__.py
@@ -0,0 +1,3 @@
+from cassio.keyvalue.k_v_cache import KVCache
+
+__all__ = ["KVCache"]
diff --git a/llm/Lib/site-packages/cassio/keyvalue/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassio/keyvalue/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a3ff8b69c748242eaf5fb758b012c3384c169a52
Binary files /dev/null and b/llm/Lib/site-packages/cassio/keyvalue/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/keyvalue/__pycache__/k_v_cache.cpython-311.pyc b/llm/Lib/site-packages/cassio/keyvalue/__pycache__/k_v_cache.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e16bc6049f8e64342ae1234d6a3ff5fd0bcb7ac2
Binary files /dev/null and b/llm/Lib/site-packages/cassio/keyvalue/__pycache__/k_v_cache.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/keyvalue/k_v_cache.py b/llm/Lib/site-packages/cassio/keyvalue/k_v_cache.py
new file mode 100644
index 0000000000000000000000000000000000000000..f4a80f9139e97267b9e21c04770ba94a428338a3
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/keyvalue/k_v_cache.py
@@ -0,0 +1,76 @@
+"""
+handling of key-value storage on a Cassandra table.
+One row per partition, serializes a multiple partition key into a string
+"""
+
+from typing import Any, Dict, List, Optional, cast
+from warnings import warn
+
+from cassandra.cluster import Session
+
+from cassio.table.tables import ElasticCassandraTable
+
+
+class KVCache:
+    """
+    This class is a rewriting of the KVCache created for use in LangChain
+    integration, this time relying on the class-table-hierarchy (cassio.table.*).
+
+    It mostly provides a translation layer between parameters and key names,
+    using a clustered table class internally.
+
+    Additional kwargs, for use in this new table class, are passed as they are
+    in order to enable their usage already before adapting the LangChain
+    integration code.
+    """
+
+    DEPRECATION_MESSAGE = (
+        "Class `KVCache` is a legacy construct and "
+        "will be deprecated in future versions of CassIO."
+    )
+
+    def __init__(
+        self,
+        table: str,
+        keys: List[Any],
+        session: Optional[Session] = None,
+        keyspace: Optional[str] = None,
+    ):
+        #
+        warn(self.DEPRECATION_MESSAGE, DeprecationWarning, stacklevel=2)
+        # for LangChain this is what we expect - no other uses are planned:
+        assert all(isinstance(k, str) for k in keys)
+        p_k_type = ["TEXT"] * len(keys)
+        #
+        self.table = ElasticCassandraTable(
+            session,
+            keyspace,
+            table,
+            keys=keys,
+            primary_key_type=p_k_type,
+        )
+
+    def clear(self) -> None:
+        self.table.clear()
+        return None
+
+    def put(
+        self,
+        key_dict: Dict[str, str],
+        cache_value: str,
+        ttl_seconds: Optional[int] = None,
+    ) -> None:
+        self.table.put(body_blob=cache_value, ttl_seconds=ttl_seconds, **key_dict)
+        return None
+
+    def get(self, key_dict: Dict[str, Any]) -> Optional[str]:
+        entry = self.table.get(**key_dict)
+        if entry is None:
+            return None
+        else:
+            return cast(str, entry["body_blob"])
+
+    def delete(self, key_dict: Dict[str, Any]) -> None:
+        """Will not complain if the row does not exist."""
+        self.table.delete(**key_dict)
+        return None
diff --git a/llm/Lib/site-packages/cassio/py.typed b/llm/Lib/site-packages/cassio/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/cassio/table/__init__.py b/llm/Lib/site-packages/cassio/table/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce99faed3c4287963522b08f733783de281d6efd
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/__init__.py
@@ -0,0 +1,37 @@
+from cassio.table.tables import ClusteredCassandraTable  # noqa: F401
+from cassio.table.tables import ClusteredElasticCassandraTable  # noqa: F401
+from cassio.table.tables import ClusteredElasticMetadataCassandraTable  # noqa: F401
+from cassio.table.tables import ClusteredElasticVectorCassandraTable  # noqa: F401
+from cassio.table.tables import ClusteredMetadataCassandraTable  # noqa: F401
+from cassio.table.tables import ClusteredMetadataVectorCassandraTable  # noqa: F401
+from cassio.table.tables import ClusteredVectorCassandraTable  # noqa: F401
+from cassio.table.tables import ElasticCassandraTable  # noqa: F401
+from cassio.table.tables import ElasticMetadataCassandraTable  # noqa: F401
+from cassio.table.tables import ElasticMetadataVectorCassandraTable  # noqa: F401
+from cassio.table.tables import ElasticVectorCassandraTable  # noqa: F401
+from cassio.table.tables import MetadataCassandraTable  # noqa: F401
+from cassio.table.tables import MetadataVectorCassandraTable  # noqa: F401
+from cassio.table.tables import PlainCassandraTable  # noqa: F401
+from cassio.table.tables import VectorCassandraTable  # noqa: F401
+from cassio.table.tables import (  # noqa: F401
+    ClusteredElasticMetadataVectorCassandraTable,
+)
+
+__all__ = [
+    "PlainCassandraTable",
+    "ClusteredCassandraTable",
+    "ClusteredMetadataCassandraTable",
+    "MetadataCassandraTable",
+    "VectorCassandraTable",
+    "ClusteredVectorCassandraTable",
+    "ClusteredMetadataVectorCassandraTable",
+    "MetadataVectorCassandraTable",
+    "ElasticCassandraTable",
+    "ClusteredElasticCassandraTable",
+    "ClusteredElasticMetadataCassandraTable",
+    "ElasticMetadataCassandraTable",
+    "ElasticVectorCassandraTable",
+    "ClusteredElasticVectorCassandraTable",
+    "ClusteredElasticMetadataVectorCassandraTable",
+    "ElasticMetadataVectorCassandraTable",
+]
diff --git a/llm/Lib/site-packages/cassio/table/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b6624196499a5c7c4651fef7acc02a295862ffec
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/__pycache__/base_table.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/__pycache__/base_table.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..60086ace9d0f50a991b3668c408bfdf74eb9dd10
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/__pycache__/base_table.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/__pycache__/cql.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/__pycache__/cql.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..760ebc2e40380286ae3cd70eff0c62fa53f699df
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/__pycache__/cql.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/__pycache__/query.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/__pycache__/query.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7ee41ce03c0ea32706d7881816937782b5efba2c
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/__pycache__/query.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/__pycache__/table_types.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/__pycache__/table_types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b55efd41ac34f0791a8654cf8d2245d674b1273a
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/__pycache__/table_types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/__pycache__/tables.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/__pycache__/tables.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a56934b1c40178116aa2093407fcf1fd6a3522e8
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/__pycache__/tables.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6ea4f7f8d74bfd9669620e4f0223dd5e77c83fc0
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/base_table.py b/llm/Lib/site-packages/cassio/table/base_table.py
new file mode 100644
index 0000000000000000000000000000000000000000..30ad78b84e2025e640d38efce6a16bb9cdd31701
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/base_table.py
@@ -0,0 +1,603 @@
+import asyncio
+import json
+import logging
+from asyncio import InvalidStateError, Task
+from typing import Any, Dict, Iterable, List, Optional, Set, Tuple, Union, cast
+
+from cassandra.cluster import ResponseFuture, ResultSet
+from cassandra.query import PreparedStatement, SimpleStatement
+
+from cassio.config import check_resolve_keyspace, check_resolve_session
+from cassio.table.cql import (
+    CREATE_INDEX_CQL_TEMPLATE,
+    CREATE_TABLE_CQL_TEMPLATE,
+    DELETE_CQL_TEMPLATE,
+    INSERT_ROW_CQL_TEMPLATE,
+    SELECT_CQL_TEMPLATE,
+    TRUNCATE_TABLE_CQL_TEMPLATE,
+    CQLOpType,
+)
+from cassio.table.query import Predicate
+from cassio.table.table_types import (
+    ColumnSpecType,
+    RowType,
+    SessionType,
+    normalize_type_desc,
+)
+from cassio.table.utils import (
+    call_wrapped_async,
+    handle_multicolumn_packing,
+    handle_multicolumn_unpacking,
+)
+
+
+class CustomLogger(logging.Logger):
+    def trace(self, msg: str, *args: Any, **kwargs: Any) -> None:
+        if self.isEnabledFor(5):
+            self._log(5, msg, args, **kwargs)
+
+
+logging.addLevelName(5, "TRACE")
+
+
+logging.setLoggerClass(CustomLogger)
+
+
+logger = logging.getLogger(__name__)
+
+
+class BaseTable:
+    ordering_in_partition: Optional[Union[str, List[str]]] = None
+
+    def __init__(
+        self,
+        table: str,
+        session: Optional[SessionType] = None,
+        keyspace: Optional[str] = None,
+        ttl_seconds: Optional[int] = None,
+        row_id_type: Union[str, List[str]] = ["TEXT"],
+        skip_provisioning: bool = False,
+        async_setup: bool = False,
+        body_index_options: Optional[List[Tuple[str, Any]]] = None,
+    ) -> None:
+        self.session = check_resolve_session(session)
+        self.keyspace = check_resolve_keyspace(keyspace)
+        self.table = table
+        self.ttl_seconds = ttl_seconds
+        self.row_id_type = normalize_type_desc(row_id_type)
+        self.skip_provisioning = skip_provisioning
+        self._prepared_statements: Dict[str, PreparedStatement] = {}
+        self._body_index_options = body_index_options
+        self.db_setup_task: Optional[Task[None]] = None
+        if async_setup:
+            self.db_setup_task = asyncio.create_task(self.adb_setup())
+        else:
+            self.db_setup()
+
+    def _schema_row_id(self) -> List[ColumnSpecType]:
+        if len(self.row_id_type) == 1:
+            return [
+                ("row_id", self.row_id_type[0]),
+            ]
+        else:
+            return [
+                (f"row_id_{row_i}", row_typ)
+                for row_i, row_typ in enumerate(self.row_id_type)
+            ]
+
+    def _schema_pk(self) -> List[ColumnSpecType]:
+        return self._schema_row_id()
+
+    def _schema_cc(self) -> List[ColumnSpecType]:
+        return []
+
+    def _schema_da(self) -> List[ColumnSpecType]:
+        return [
+            ("body_blob", "TEXT"),
+        ]
+
+    async def _aschema_da(self) -> List[ColumnSpecType]:
+        return self._schema_da()
+
+    def _schema(self) -> Dict[str, List[ColumnSpecType]]:
+        return {
+            "pk": self._schema_pk(),
+            "cc": self._schema_cc(),
+            "da": self._schema_da(),
+        }
+
+    async def _aschema(self) -> Dict[str, List[ColumnSpecType]]:
+        return {
+            "pk": self._schema_pk(),
+            "cc": self._schema_cc(),
+            "da": await self._aschema_da(),
+        }
+
+    def _schema_primary_key(self) -> List[ColumnSpecType]:
+        return self._schema_pk() + self._schema_cc()
+
+    def _schema_collist(self) -> List[ColumnSpecType]:
+        full_list = self._schema_da() + self._schema_cc() + self._schema_pk()
+        return full_list
+
+    def _schema_colnameset(self) -> Set[str]:
+        full_list = self._schema_collist()
+        full_set = set(col for col, _ in full_list)
+        assert len(full_list) == len(full_set)
+        return full_set
+
+    def _desc_table(self) -> str:
+        columns = self._schema()
+        col_str = (
+            "[("
+            + ", ".join("%s(%s)" % colspec for colspec in columns["pk"])
+            + ") "
+            + ", ".join("%s(%s)" % colspec for colspec in columns["cc"])
+            + "] "
+            + ", ".join("%s(%s)" % colspec for colspec in columns["da"])
+        )
+        return col_str
+
+    def _extract_where_clause_blocks(
+        self, args_dict: Any
+    ) -> Tuple[Any, List[str], Tuple[Any, ...]]:
+        # Removes some of the passed kwargs and returns the remaining,
+        # plus the pieces for a WHERE
+        _allowed_colspecs = self._schema_collist()
+        passed_columns = sorted(
+            [col for col, _ in _allowed_colspecs if col in args_dict]
+        )
+        residual_args = {k: v for k, v in args_dict.items() if k not in passed_columns}
+
+        where_clause_blocks = []
+        where_clause_vals = []
+        for col in passed_columns:
+            value = args_dict[col]
+            if isinstance(value, Predicate):
+                pred_op_name, pred_value = value.render()
+                where_clause_blocks.append(f"{col} {pred_op_name} %s")
+                where_clause_vals.append(pred_value)
+            else:
+                where_clause_blocks.append(f"{col} = %s")
+                where_clause_vals.append(value)
+
+        return (
+            residual_args,
+            where_clause_blocks,
+            tuple(where_clause_vals),
+        )
+
+    def _normalize_kwargs(self, args_dict: Dict[str, Any]) -> Dict[str, Any]:
+        new_args_dict = handle_multicolumn_unpacking(
+            args_dict,
+            "row_id",
+            [col for col, _ in self._schema_row_id()],
+        )
+        return new_args_dict
+
+    def _normalize_row(self, raw_row: Any) -> Dict[str, Any]:
+        if isinstance(raw_row, dict):
+            dict_row = raw_row
+        else:
+            dict_row = raw_row._asdict()
+        #
+        repacked_row = handle_multicolumn_packing(
+            unpacked_row=dict_row,
+            key_name="row_id",
+            unpacked_keys=[col for col, _ in self._schema_row_id()],
+        )
+        return repacked_row
+
+    def _delete(self, is_async: bool, **kwargs: Any) -> Union[None, ResponseFuture]:
+        n_kwargs = self._normalize_kwargs(kwargs)
+        (
+            rest_kwargs,
+            where_clause_blocks,
+            delete_cql_vals,
+        ) = self._extract_where_clause_blocks(n_kwargs)
+        assert rest_kwargs == {}
+        where_clause = "WHERE " + " AND ".join(where_clause_blocks)
+        delete_cql = DELETE_CQL_TEMPLATE.format(
+            where_clause=where_clause,
+        )
+        if is_async:
+            return self.execute_cql_async(
+                delete_cql, args=delete_cql_vals, op_type=CQLOpType.WRITE
+            )
+        else:
+            self.execute_cql(delete_cql, args=delete_cql_vals, op_type=CQLOpType.WRITE)
+            return None
+
+    def delete(self, **kwargs: Any) -> None:
+        self._ensure_db_setup()
+        self._delete(is_async=False, **kwargs)
+        return None
+
+    def delete_async(self, **kwargs: Any) -> ResponseFuture:
+        self._ensure_db_setup()
+        return self._delete(is_async=True, **kwargs)
+
+    async def adelete(self, **kwargs: Any) -> None:
+        await self._aensure_db_setup()
+        await call_wrapped_async(self.delete_async, **kwargs)
+
+    def _clear(self, is_async: bool) -> Union[None, ResponseFuture]:
+        truncate_table_cql = TRUNCATE_TABLE_CQL_TEMPLATE.format()
+        if is_async:
+            return self.execute_cql_async(
+                truncate_table_cql, args=tuple(), op_type=CQLOpType.WRITE
+            )
+        else:
+            self.execute_cql(truncate_table_cql, args=tuple(), op_type=CQLOpType.WRITE)
+            return None
+
+    def clear(self) -> None:
+        self._ensure_db_setup()
+        self._clear(is_async=False)
+        return None
+
+    def clear_async(self) -> ResponseFuture:
+        self._ensure_db_setup()
+        return self._clear(is_async=True)
+
+    async def aclear(self) -> None:
+        await self._aensure_db_setup()
+        await call_wrapped_async(self.clear_async)
+
+    def _has_index_analyzers(self) -> bool:
+        if not self._body_index_options:
+            return False
+        for option in self._body_index_options:
+            if option[0] == "index_analyzer":
+                return True
+        return False
+
+    def _extract_index_analyzers(
+        self, args_dict: Any
+    ) -> Tuple[Any, List[str], Tuple[Any, ...]]:
+        rest_args = args_dict.copy()
+        where_clause_blocks: List[str] = []
+        where_clause_vals: List[Any] = []
+        if "body_search" in args_dict:
+            if not self._has_index_analyzers():
+                raise ValueError(
+                    "Cannot do body search because no index analyzer "
+                    "was configured on the table"
+                )
+            body_search_texts = rest_args.pop("body_search")
+            if not isinstance(body_search_texts, list):
+                body_search_texts = [body_search_texts]
+            for text in body_search_texts:
+                where_clause_blocks.append("body_blob : %s")
+                where_clause_vals.append(text)
+        return rest_args, where_clause_blocks, tuple(where_clause_vals)
+
+    def _parse_select_core_params(
+        self, **kwargs: Any
+    ) -> Tuple[str, str, Tuple[Any, ...]]:
+        n_kwargs = self._normalize_kwargs(kwargs)
+        # TODO: work on a columns: Optional[List[str]] = None
+        # (but with nuanced handling of the column-magic we have here)
+        columns = None
+        if columns is None:
+            columns_desc = "*"
+        else:
+            # TODO: handle translations here?
+            # columns_desc = ", ".join(columns)
+            raise NotImplementedError("Column selection is not implemented.")
+        #
+        (
+            rest_kwargs,
+            where_clause_blocks,
+            select_cql_vals,
+        ) = self._extract_where_clause_blocks(n_kwargs)
+
+        (
+            rest_kwargs,
+            analyzer_clause_blocks,
+            analyzer_cql_vals,
+        ) = self._extract_index_analyzers(rest_kwargs)
+
+        assert rest_kwargs == {}
+
+        all_where_clauses = where_clause_blocks + analyzer_clause_blocks
+        if not all_where_clauses:
+            where_clause = ""
+        else:
+            where_clause = "WHERE " + " AND ".join(all_where_clauses)
+        return columns_desc, where_clause, select_cql_vals + analyzer_cql_vals
+
+    def _get_select_cql(self, **kwargs: Any) -> Tuple[str, Tuple[Any, ...]]:
+        columns_desc, where_clause, get_cql_vals = self._parse_select_core_params(
+            **kwargs
+        )
+        limit_clause = ""
+        limit_cql_vals: List[Any] = []
+        select_vals = tuple(list(get_cql_vals) + limit_cql_vals)
+        #
+        select_cql = SELECT_CQL_TEMPLATE.format(
+            columns_desc=columns_desc,
+            where_clause=where_clause,
+            limit_clause=limit_clause,
+        )
+        return select_cql, select_vals
+
+    def _normalize_result_set(
+        self, result_set: Iterable[RowType]
+    ) -> Optional[Dict[str, Any]]:
+        if isinstance(result_set, ResultSet):
+            result = result_set.one()
+        else:
+            result = None
+        #
+        if result is None:
+            return result
+        else:
+            return self._normalize_row(result)
+
+    def get(self, **kwargs: Any) -> Optional[RowType]:
+        self._ensure_db_setup()
+        select_cql, select_vals = self._get_select_cql(**kwargs)
+        # dancing around the result set (to comply with type checking):
+        result_set = self.execute_cql(
+            select_cql, args=select_vals, op_type=CQLOpType.READ
+        )
+        return self._normalize_result_set(result_set)
+
+    def get_async(self, **kwargs: Any) -> ResponseFuture:
+        raise NotImplementedError("Asynchronous reads are not supported.")
+
+    async def aget(self, **kwargs: Any) -> Optional[RowType]:
+        await self._aensure_db_setup()
+        select_cql, select_vals = self._get_select_cql(**kwargs)
+        # dancing around the result set (to comply with type checking):
+        result_set = await self.aexecute_cql(
+            select_cql, args=select_vals, op_type=CQLOpType.READ
+        )
+        return self._normalize_result_set(result_set)
+
+    def _put(self, is_async: bool, **kwargs: Any) -> Union[None, ResponseFuture]:
+        n_kwargs = self._normalize_kwargs(kwargs)
+        primary_key = self._schema_primary_key()
+        assert set(col for col, _ in primary_key) - set(n_kwargs.keys()) == set()
+        columns = [col for col, _ in self._schema_collist() if col in n_kwargs]
+        columns_desc = ", ".join(columns)
+        insert_cql_vals = [n_kwargs[col] for col in columns]
+        value_placeholders = ", ".join("%s" for _ in columns)
+        #
+        ttl_seconds = (
+            n_kwargs["ttl_seconds"] if "ttl_seconds" in n_kwargs else self.ttl_seconds
+        )
+        if ttl_seconds is not None:
+            ttl_spec = "USING TTL %s"
+            ttl_vals = [ttl_seconds]
+        else:
+            ttl_spec = ""
+            ttl_vals = []
+        #
+        insert_cql_args = tuple(insert_cql_vals + ttl_vals)
+        insert_cql = INSERT_ROW_CQL_TEMPLATE.format(
+            columns_desc=columns_desc,
+            value_placeholders=value_placeholders,
+            ttl_spec=ttl_spec,
+        )
+        #
+        if is_async:
+            return self.execute_cql_async(
+                insert_cql, args=insert_cql_args, op_type=CQLOpType.WRITE
+            )
+        else:
+            self.execute_cql(insert_cql, args=insert_cql_args, op_type=CQLOpType.WRITE)
+            return None
+
+    def put(self, **kwargs: Any) -> None:
+        self._ensure_db_setup()
+        self._put(is_async=False, **kwargs)
+        return None
+
+    def put_async(self, **kwargs: Any) -> ResponseFuture:
+        self._ensure_db_setup()
+        return self._put(is_async=True, **kwargs)
+
+    async def aput(self, **kwargs: Any) -> None:
+        await self._aensure_db_setup()
+        await call_wrapped_async(self.put_async, **kwargs)
+
+    def _get_db_setup_cql(self, schema: Dict[str, List[ColumnSpecType]]) -> str:
+        column_specs = [
+            f"{col_spec[0]} {col_spec[1]}"
+            for _schema_grp in ["pk", "cc", "da"]
+            for col_spec in schema[_schema_grp]
+        ]
+        pk_spec = ", ".join(col for col, _ in schema["pk"])
+        cc_spec = ", ".join(col for col, _ in schema["cc"])
+        primkey_spec = f"( ( {pk_spec} ) {',' if schema['cc'] else ''} {cc_spec} )"
+
+        table_options = []
+
+        if schema["cc"]:
+            if self.ordering_in_partition is None:
+                raise ValueError("Unspecified ordering for clustering column(s)")
+            if isinstance(self.ordering_in_partition, str):
+                _cc_orderings = [self.ordering_in_partition for _ in schema["cc"]]
+            else:
+                # must be a list
+                assert len(self.ordering_in_partition) == len(schema["cc"])
+                _cc_orderings = self.ordering_in_partition
+            clu_core = ", ".join(
+                f"{col} {ordering}"
+                for (col, _), ordering in zip(schema["cc"], _cc_orderings)
+            )
+            table_options.append(f"CLUSTERING ORDER BY ({clu_core})")
+
+        if len(table_options) > 0:
+            options_clause = "WITH " + " AND ".join(table_options)
+        else:
+            options_clause = ""
+
+        create_table_cql = CREATE_TABLE_CQL_TEMPLATE.format(
+            columns_spec=" ".join(f"  {cs}," for cs in column_specs),
+            primkey_spec=primkey_spec,
+            options_clause=options_clause,
+        )
+        return create_table_cql
+
+    @staticmethod
+    def _get_create_index_cql(
+        index_name: str, index_column: str, index_options: List[Tuple[str, Any]]
+    ) -> str:
+        options_clause = ""
+        if len(index_options) > 0:
+            formatted_options = []
+            for option in index_options:
+                key, value = option
+                if isinstance(value, dict):
+                    formatted_options.append(f"'{key}': '{json.dumps(value)}'")
+                elif isinstance(value, str):
+                    formatted_options.append(f"'{key}': '{value}'")
+                elif isinstance(value, bool):
+                    if value:
+                        formatted_options.append(f"'{key}': true")
+                    else:
+                        formatted_options.append(f"'{key}': false")
+                else:
+                    raise ValueError("Unsupported index_option format")
+
+            formatted_options.sort()
+
+            options_text = ", ".join(formatted_options)
+
+            # this is double escaped because the cql will go through
+            # another format method before being executed
+            options_clause = f"WITH OPTIONS = {{{{ {options_text} }}}}"
+
+        return CREATE_INDEX_CQL_TEMPLATE.format(
+            index_name=index_name,
+            index_column=index_column,
+            options_clause=options_clause,
+        )
+
+    @staticmethod
+    def _get_create_analyzer_index_cql(index_options: List[Tuple[str, Any]]) -> str:
+        index_name = "idx_body"
+        index_column = "body_blob"
+        return BaseTable._get_create_index_cql(
+            index_name=index_name,
+            index_column=index_column,
+            index_options=index_options,
+        )
+
+    def db_setup(self) -> None:
+        create_table_cql = self._get_db_setup_cql(self._schema())
+        self.execute_cql(create_table_cql, op_type=CQLOpType.SCHEMA)
+        if self._body_index_options:
+            self.execute_cql(
+                self._get_create_analyzer_index_cql(self._body_index_options),
+                op_type=CQLOpType.SCHEMA,
+            )
+
+    async def adb_setup(self) -> None:
+        schema = await self._aschema()
+        create_table_cql = self._get_db_setup_cql(schema)
+        await self.aexecute_cql(create_table_cql, op_type=CQLOpType.SCHEMA)
+        if self._body_index_options:
+            await self.aexecute_cql(
+                self._get_create_analyzer_index_cql(self._body_index_options),
+                op_type=CQLOpType.SCHEMA,
+            )
+
+    def _ensure_db_setup(self) -> None:
+        if self.db_setup_task:
+            try:
+                self.db_setup_task.result()
+            except InvalidStateError:
+                raise ValueError(
+                    "Asynchronous setup of the DB not finished. "
+                    "NB: Table sync methods shouldn't be called from the "
+                    "event loop. Consider using their async equivalents."
+                )
+
+    async def _aensure_db_setup(self) -> None:
+        if self.db_setup_task:
+            await self.db_setup_task
+
+    def _finalize_cql_semitemplate(self, cql_semitemplate: str) -> str:
+        table_fqname = f"{self.keyspace}.{self.table}"
+        table_name = self.table
+        final_cql = cql_semitemplate.format(
+            table_fqname=table_fqname, table_name=table_name
+        )
+        return final_cql
+
+    def _obtain_prepared_statement(self, final_cql: str) -> PreparedStatement:
+        # TODO: improve this placeholder handling
+        _preparable_cql = final_cql.replace("%s", "?")
+        # handle the cache of prepared statements
+        if _preparable_cql not in self._prepared_statements:
+            logger.debug(f'Preparing statement "{_preparable_cql}"')
+            self._prepared_statements[_preparable_cql] = self.session.prepare(
+                _preparable_cql
+            )
+        return self._prepared_statements[_preparable_cql]
+
+    def execute_cql(
+        self,
+        cql_semitemplate: str,
+        op_type: CQLOpType,
+        args: Tuple[Any, ...] = tuple(),
+    ) -> Iterable[RowType]:
+        final_cql = self._finalize_cql_semitemplate(cql_semitemplate)
+        #
+        if op_type == CQLOpType.SCHEMA and self.skip_provisioning:
+            # these operations are not executed for this instance:
+            logger.debug(f'Not executing statement "{final_cql}"')
+            return []
+        if op_type == CQLOpType.SCHEMA:
+            # schema operations are not to be 'prepared'
+            statement = SimpleStatement(final_cql)
+            logger.debug(f'Executing statement "{final_cql}" as simple (unprepared)')
+        else:
+            statement = self._obtain_prepared_statement(final_cql)
+            logger.debug(f'Executing statement "{final_cql}" as prepared')
+        logger.trace(f'Statement "{final_cql}" has args: "{str(args)}"')  # type: ignore
+        return cast(Iterable[RowType], self.session.execute(statement, args))
+
+    def execute_cql_async(
+        self,
+        cql_semitemplate: str,
+        op_type: CQLOpType,
+        args: Tuple[Any, ...] = tuple(),
+    ) -> ResponseFuture:
+        final_cql = self._finalize_cql_semitemplate(cql_semitemplate)
+        #
+        if op_type == CQLOpType.SCHEMA:
+            raise RuntimeError("Schema operations cannot be asynchronous")
+        statement = self._obtain_prepared_statement(final_cql)
+        logger.debug(f'Executing_async statement "{final_cql}" as prepared')
+        logger.trace(f'Statement "{final_cql}" has args: "{str(args)}"')  # type: ignore
+        return self.session.execute_async(statement, args)
+
+    async def aexecute_cql(
+        self,
+        cql_semitemplate: str,
+        op_type: CQLOpType,
+        args: Tuple[Any, ...] = tuple(),
+    ) -> Iterable[RowType]:
+        final_cql = self._finalize_cql_semitemplate(cql_semitemplate)
+        #
+        if op_type == CQLOpType.SCHEMA and self.skip_provisioning:
+            # these operations are not executed for this instance:
+            logger.debug(f'Not aexecuting statement "{final_cql}"')
+            return []
+        if op_type == CQLOpType.SCHEMA:
+            # schema operations are not to be 'prepared'
+            statement = SimpleStatement(final_cql)
+            logger.debug(f'aExecuting statement "{final_cql}" as simple (unprepared)')
+        else:
+            statement = self._obtain_prepared_statement(final_cql)
+            logger.debug(f'aExecuting statement "{final_cql}" as prepared')
+        logger.trace(f'Statement "{final_cql}" has args: "{str(args)}"')  # type: ignore
+        return cast(
+            Iterable[RowType],
+            await call_wrapped_async(self.session.execute_async, statement, args),
+        )
diff --git a/llm/Lib/site-packages/cassio/table/cql.py b/llm/Lib/site-packages/cassio/table/cql.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d7d7f716294c0c3f57d1ea95fc85f18d8fcf705
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/cql.py
@@ -0,0 +1,149 @@
+from enum import Enum
+from typing import Any, List, Tuple, Union
+
+from cassandra.query import PreparedStatement, SimpleStatement
+
+
+class CQLOpType(Enum):
+    SCHEMA = 1
+    WRITE = 2
+    READ = 3
+
+
+CREATE_TABLE_CQL_TEMPLATE = """CREATE TABLE IF NOT EXISTS {{table_fqname}} ({columns_spec} PRIMARY KEY {primkey_spec}) {options_clause};"""  # noqa: E501
+
+TRUNCATE_TABLE_CQL_TEMPLATE = """TRUNCATE TABLE {{table_fqname}};"""
+
+DELETE_CQL_TEMPLATE = """DELETE FROM {{table_fqname}} {where_clause};"""
+
+SELECT_CQL_TEMPLATE = (
+    """SELECT {columns_desc} FROM {{table_fqname}} {where_clause} {limit_clause};"""
+)
+
+INSERT_ROW_CQL_TEMPLATE = """INSERT INTO {{table_fqname}} ({columns_desc}) VALUES ({value_placeholders}) {ttl_spec} ;"""  # noqa: E501
+
+CREATE_INDEX_CQL_PREFIX = "CREATE CUSTOM INDEX IF NOT EXISTS {index_name}_{{table_name}} ON {{table_fqname}} "  # noqa: E501
+
+CREATE_INDEX_CQL_TEMPLATE = (
+    CREATE_INDEX_CQL_PREFIX
+    + "({index_column}) USING 'org.apache.cassandra.index.sai.StorageAttachedIndex' {options_clause};"  # noqa: E501
+)
+
+CREATE_KEYS_INDEX_CQL_TEMPLATE = (
+    CREATE_INDEX_CQL_PREFIX
+    + "(KEYS({index_column})) USING 'org.apache.cassandra.index.sai.StorageAttachedIndex';"  # noqa: E501
+)
+
+CREATE_ENTRIES_INDEX_CQL_TEMPLATE = (
+    CREATE_INDEX_CQL_PREFIX
+    + "(ENTRIES({index_column})) USING 'org.apache.cassandra.index.sai.StorageAttachedIndex';"  # noqa: E501
+    ""
+)
+
+SELECT_ANN_CQL_TEMPLATE = """SELECT {columns_desc} FROM {{table_fqname}} {where_clause} ORDER BY {vector_column} ANN OF %s {limit_clause};"""  # noqa: E501
+
+CQLStatementType = Union[str, SimpleStatement, PreparedStatement]
+StatementWithArgs = Tuple[CQLStatementType, Tuple[Any, ...]]
+StatementStrWithArgs = Tuple[str, Tuple[Any, ...]]
+
+
+# Mock DB session
+class MockDBSession:
+    def __init__(self, verbose: bool = False):
+        self.verbose = verbose
+        self.statements: List[StatementWithArgs] = []
+
+    @staticmethod
+    def get_statement_body(statement: CQLStatementType) -> str:
+        if isinstance(statement, str):
+            _statement = statement
+        elif isinstance(statement, SimpleStatement):
+            _statement = statement.query_string
+        elif isinstance(statement, PreparedStatement):
+            _statement = statement.query_string
+        else:
+            raise ValueError()
+        return _statement
+
+    @staticmethod
+    def normalize_cql_statement(statement: CQLStatementType) -> str:
+        _statement = MockDBSession.get_statement_body(statement)
+        _s = (
+            _statement.replace(";", " ")
+            .replace("%s", " %s ")
+            .replace("?", " ? ")
+            .replace("=", " = ")
+            .replace(")", " ) ")
+            .replace("(", " ( ")
+            .replace("\n", " ")
+        )
+        return " ".join(
+            tok.lower() for tok in (_t.strip() for _t in _s.split(" ") if _t.strip())
+        )
+
+    @staticmethod
+    def prepare(statement: str) -> PreparedStatement:
+        # A very unusable 'prepared statement' just for tracing/debugging:
+        return PreparedStatement(None, 0, 0, statement, "keyspace", None, None, None)
+
+    def execute(
+        self, statement: CQLStatementType, arguments: Tuple[Any, ...] = tuple()
+    ) -> List[Any]:
+        if self.verbose:
+            #
+            st_body = self.get_statement_body(statement)
+            if isinstance(statement, str):
+                st_type = "STR"
+                placeholder_count = st_body.count("%s")
+                assert "?" not in st_body
+            elif isinstance(statement, SimpleStatement):
+                st_type = "SIM"
+                placeholder_count = st_body.count("%s")
+                assert "?" not in st_body
+            elif isinstance(statement, PreparedStatement):
+                st_type = "PRE"
+                placeholder_count = st_body.count("?")
+                assert "%s" not in st_body
+            #
+            assert placeholder_count == len(arguments)
+            #
+            print(f"CQL_EXECUTE [{st_type}]:")
+            print(f"    {st_body}")
+            if arguments:
+                print(f"    {str(arguments)}")
+        self.statements.append((statement, arguments))
+        return []
+
+    def last_raw(self, n: int) -> List[StatementWithArgs]:
+        if n <= 0:
+            return []
+        else:
+            return self.statements[-n:]
+
+    def last(self, n: int) -> List[StatementStrWithArgs]:
+        return [
+            (
+                self.normalize_cql_statement(stmt),
+                data,
+            )
+            for stmt, data in self.last_raw(n)
+        ]
+
+    def assert_last_equal(
+        self, expected_statements: List[StatementStrWithArgs]
+    ) -> None:
+        # used for testing
+        last_executed = self.last(len(expected_statements))
+        assert len(last_executed) == len(expected_statements)
+        for s_exe, s_expe in zip(last_executed, expected_statements):
+            assert s_exe[1] == s_expe[1], f"EXE#{str(s_exe[1])}# != EXPE#{s_expe[1]}#"
+            exe_cql = self.normalize_cql_statement(s_exe[0])
+            expe_cql = self.normalize_cql_statement(s_expe[0])
+            assert exe_cql == expe_cql, f"EXE#{exe_cql}# != EXPE#{expe_cql}#"
+        return None
+
+
+STANDARD_ANALYZER = ("index_analyzer", "STANDARD")
+LOWER_CASE_ANALYZER = ("case_sensitive", False)
+NORMALIZE_ANALYZER = ("normalize", True)
+ASCII_ANALYZER = ("ascii", True)
diff --git a/llm/Lib/site-packages/cassio/table/mixins/__init__.py b/llm/Lib/site-packages/cassio/table/mixins/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd1077ecf4410b8cf0315c8a31c3dc18e4432fe0
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/mixins/__init__.py
@@ -0,0 +1,6 @@
+from cassio.table.mixins.base_table import BaseTableMixin  # noqa: F401
+from cassio.table.mixins.clustered import ClusteredMixin  # noqa: F401
+from cassio.table.mixins.elastic_key import ElasticKeyMixin  # noqa: F401
+from cassio.table.mixins.metadata import MetadataMixin  # noqa: F401
+from cassio.table.mixins.type_normalizer import TypeNormalizerMixin  # noqa: F401
+from cassio.table.mixins.vector import VectorMixin  # noqa: F401
diff --git a/llm/Lib/site-packages/cassio/table/mixins/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e6d0657e03ad3fb8817130e65571bafe242793d6
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/mixins/__pycache__/base_table.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/base_table.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f0c23a704c5f5c629071d4d167ab453373408d10
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/base_table.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/mixins/__pycache__/clustered.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/clustered.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..32c6dcd25a0aa8a19e41278519b513eb68089e0c
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/clustered.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/mixins/__pycache__/elastic_key.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/elastic_key.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3271fb09a67c4208ef1d969e5a67c85584e52e54
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/elastic_key.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/mixins/__pycache__/metadata.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/metadata.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f5d42d7f6ab40ab770fed2cbccbba2742173c21c
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/metadata.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/mixins/__pycache__/type_normalizer.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/type_normalizer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..effef6a29d5adc88df543e1711b64b08b4ace1be
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/type_normalizer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/mixins/__pycache__/vector.cpython-311.pyc b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/vector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6c38a9aa2a58e1154b9251fc2e02d92a40072f34
Binary files /dev/null and b/llm/Lib/site-packages/cassio/table/mixins/__pycache__/vector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/table/mixins/base_table.py b/llm/Lib/site-packages/cassio/table/mixins/base_table.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a0bb058eb319a802dc56b36af0940774c8b278f
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/mixins/base_table.py
@@ -0,0 +1,5 @@
+from cassio.table.base_table import BaseTable
+
+
+class BaseTableMixin(BaseTable):
+    """All other mixins should inherit from this one."""
diff --git a/llm/Lib/site-packages/cassio/table/mixins/clustered.py b/llm/Lib/site-packages/cassio/table/mixins/clustered.py
new file mode 100644
index 0000000000000000000000000000000000000000..b450ec24524d6d0404469b1bc01f0bf48c792a8b
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/mixins/clustered.py
@@ -0,0 +1,215 @@
+from typing import Any, Dict, Iterable, List, Optional, Tuple, Union
+
+from cassandra.cluster import ResponseFuture
+
+from cassio.table.cql import DELETE_CQL_TEMPLATE, SELECT_CQL_TEMPLATE, CQLOpType
+from cassio.table.table_types import ColumnSpecType, RowType, normalize_type_desc
+from cassio.table.utils import (
+    call_wrapped_async,
+    handle_multicolumn_packing,
+    handle_multicolumn_unpacking,
+)
+
+from .base_table import BaseTableMixin
+
+PARTITION_ID_TYPE = Union[Any, Tuple[Any]]
+
+
+class ClusteredMixin(BaseTableMixin):
+    def __init__(
+        self,
+        *pargs: Any,
+        partition_id_type: Union[str, List[str]] = ["TEXT"],
+        partition_id: Optional[PARTITION_ID_TYPE] = None,
+        ordering_in_partition: Union[str, List[str]] = "ASC",
+        **kwargs: Any,
+    ) -> None:
+        self.partition_id_type = normalize_type_desc(partition_id_type)
+        self.partition_id = partition_id
+        if isinstance(ordering_in_partition, str):
+            self.ordering_in_partition = ordering_in_partition.upper()
+        else:
+            self.ordering_in_partition = [
+                ordering.upper() for ordering in ordering_in_partition
+            ]
+        super().__init__(*pargs, **kwargs)
+
+    def _schema_pk(self) -> List[ColumnSpecType]:
+        if len(self.partition_id_type) == 1:
+            return [
+                ("partition_id", self.partition_id_type[0]),
+            ]
+        else:
+            return [
+                (f"partition_id_{pk_i}", pk_typ)
+                for pk_i, pk_typ in enumerate(self.partition_id_type)
+            ]
+
+    def _schema_cc(self) -> List[ColumnSpecType]:
+        return self._schema_row_id()
+
+    def _delete_partition(
+        self, is_async: bool, partition_id: Optional[PARTITION_ID_TYPE] = None
+    ) -> Union[None, ResponseFuture]:
+        _partition_id = self.partition_id if partition_id is None else partition_id
+        #
+        _pid_dict = handle_multicolumn_unpacking(
+            {"partition_id": _partition_id},
+            "partition_id",
+            [col for col, _ in self._schema_pk()],
+        )
+        (
+            rest_kwargs,
+            where_clause_blocks,
+            delete_cql_vals,
+        ) = self._extract_where_clause_blocks(_pid_dict)
+        assert rest_kwargs == {}
+        where_clause = "WHERE " + " AND ".join(where_clause_blocks)
+        delete_cql = DELETE_CQL_TEMPLATE.format(
+            where_clause=where_clause,
+        )
+        if is_async:
+            return self.execute_cql_async(
+                delete_cql, args=delete_cql_vals, op_type=CQLOpType.WRITE
+            )
+        else:
+            self.execute_cql(delete_cql, args=delete_cql_vals, op_type=CQLOpType.WRITE)
+            return None
+
+    def delete_partition(
+        self, partition_id: Optional[PARTITION_ID_TYPE] = None
+    ) -> None:
+        self._delete_partition(is_async=False, partition_id=partition_id)
+        return None
+
+    def delete_partition_async(
+        self, partition_id: Optional[PARTITION_ID_TYPE] = None
+    ) -> ResponseFuture:
+        return self._delete_partition(is_async=True, partition_id=partition_id)
+
+    async def adelete_partition(
+        self, partition_id: Optional[PARTITION_ID_TYPE] = None
+    ) -> None:
+        await call_wrapped_async(self.delete_partition_async, partition_id=partition_id)
+
+    def _normalize_kwargs(self, args_dict: Dict[str, Any]) -> Dict[str, Any]:
+        # if partition id provided in call, takes precedence over instance value
+        arg_pid = args_dict.get("partition_id")
+        instance_pid = self.partition_id
+        _partition_id = instance_pid if arg_pid is None else arg_pid
+        new_args_dict0 = {
+            **{"partition_id": _partition_id},
+            **args_dict,
+        }
+        # in case of multicolumn-key schema, do the tuple unpacking:
+        new_args_dict = handle_multicolumn_unpacking(
+            new_args_dict0,
+            "partition_id",
+            [col for col, _ in self._schema_pk()],
+        )
+
+        return super()._normalize_kwargs(new_args_dict)
+
+    def _normalize_row(self, raw_row: Any) -> Dict[str, Any]:
+        pre_normalized = super()._normalize_row(raw_row)
+        repacked_row = handle_multicolumn_packing(
+            unpacked_row=pre_normalized,
+            key_name="partition_id",
+            unpacked_keys=[col for col, _ in self._schema_pk()],
+        )
+        return repacked_row
+
+    def _get_get_partition_cql(
+        self,
+        partition_id: Optional[PARTITION_ID_TYPE] = None,
+        n: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Tuple[str, Tuple[Any, ...]]:
+        _partition_id = self.partition_id if partition_id is None else partition_id
+        #
+        # TODO: work on a columns: Optional[List[str]] = None
+        # (but with nuanced handling of the column-magic we have here)
+        columns = None
+        if columns is None:
+            columns_desc = "*"
+        else:
+            # TODO: handle translations here?
+            # columns_desc = ", ".join(columns)
+            raise NotImplementedError("Column selection is not implemented.")
+        # WHERE can admit other sources (e.g. medata if the corresponding mixin)
+        # so we escalate to standard WHERE-creation route and reinject the partition
+        n_kwargs = self._normalize_kwargs(
+            {
+                **{"partition_id": _partition_id},
+                **kwargs,
+            }
+        )
+        (
+            rest_kwargs,
+            where_clause_blocks,
+            select_cql_vals,
+        ) = self._extract_where_clause_blocks(n_kwargs)
+
+        # check for exhaustion:
+        assert rest_kwargs == {}
+        where_clause = "WHERE " + " AND ".join(where_clause_blocks)
+        where_cql_vals = list(select_cql_vals)
+        #
+        if n is None:
+            limit_clause = ""
+            limit_cql_vals = []
+        else:
+            limit_clause = "LIMIT %s"
+            limit_cql_vals = [n]
+        #
+        select_cql = SELECT_CQL_TEMPLATE.format(
+            columns_desc=columns_desc,
+            where_clause=where_clause,
+            limit_clause=limit_clause,
+        )
+        get_p_cql_vals = tuple(where_cql_vals + limit_cql_vals)
+        return select_cql, get_p_cql_vals
+
+    def get_partition(
+        self,
+        partition_id: Optional[PARTITION_ID_TYPE] = None,
+        n: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Iterable[RowType]:
+        select_cql, get_p_cql_vals = self._get_get_partition_cql(
+            partition_id, n, **kwargs
+        )
+        return (
+            self._normalize_row(raw_row)
+            for raw_row in self.execute_cql(
+                select_cql,
+                args=get_p_cql_vals,
+                op_type=CQLOpType.READ,
+            )
+        )
+
+    def get_partition_async(
+        self,
+        partition_id: Optional[PARTITION_ID_TYPE] = None,
+        n: Optional[int] = None,
+        **kwargs: Any,
+    ) -> ResponseFuture:
+        raise NotImplementedError("Asynchronous reads are not supported.")
+
+    async def aget_partition(
+        self,
+        partition_id: Optional[PARTITION_ID_TYPE] = None,
+        n: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Iterable[RowType]:
+        select_cql, get_p_cql_vals = self._get_get_partition_cql(
+            partition_id, n, **kwargs
+        )
+        return (
+            self._normalize_row(raw_row)
+            for raw_row in await self.aexecute_cql(
+                select_cql,
+                args=get_p_cql_vals,
+                op_type=CQLOpType.READ,
+            )
+        )
diff --git a/llm/Lib/site-packages/cassio/table/mixins/elastic_key.py b/llm/Lib/site-packages/cassio/table/mixins/elastic_key.py
new file mode 100644
index 0000000000000000000000000000000000000000..6da5c2c1ef606de4a2f1abdfcb6777429fbfb16d
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/mixins/elastic_key.py
@@ -0,0 +1,76 @@
+import json
+from typing import Any, Dict, List, cast
+
+from cassio.table.table_types import ColumnSpecType
+
+from .base_table import BaseTableMixin
+
+
+class ElasticKeyMixin(BaseTableMixin):
+    def __init__(self, *pargs: Any, keys: List[str], **kwargs: Any) -> None:
+        if "row_id_type" in kwargs:
+            raise ValueError("'row_id_type' not allowed for elastic tables.")
+        self.keys = keys
+        self.key_desc = self._serialize_key_list(self.keys)
+        row_id_type = ["TEXT", "TEXT"]
+        new_kwargs = {
+            **{"row_id_type": row_id_type},
+            **kwargs,
+        }
+        super().__init__(*pargs, **new_kwargs)
+
+    @staticmethod
+    def _serialize_key_list(key_vals: List[Any]) -> str:
+        return json.dumps(key_vals, separators=(",", ":"), sort_keys=True)
+
+    @staticmethod
+    def _deserialize_key_list(keys_str: str) -> List[Any]:
+        return cast(List[Any], json.loads(keys_str))
+
+    def _normalize_row(self, raw_row: Any) -> Dict[str, Any]:
+        pre_normalized = super()._normalize_row(raw_row)
+        # after BaseTable unpacks this, pre_normalized contains
+        # {"row_id": (serialized_keys, serialized_values), ...}
+        if "row_id" in pre_normalized:
+            keys_s, vals_s = pre_normalized["row_id"]
+            keys = self._deserialize_key_list(keys_s)
+            vals = self._deserialize_key_list(vals_s)
+            assert keys == self.keys
+            assert len(keys) == len(vals)
+            restored_keys = {k: v for k, v in zip(keys, vals)}
+            return {
+                **restored_keys,
+                **{k: v for k, v in pre_normalized.items() if k != "row_id"},
+            }
+        else:
+            return pre_normalized
+
+    def _normalize_kwargs(self, args_dict: Dict[str, Any]) -> Dict[str, Any]:
+        # transform provided "keys" into the elastic-representation two-val form
+        key_args = {k: v for k, v in args_dict.items() if k in self.keys}
+        # the "key" is passed all-or-nothing:
+        assert set(key_args.keys()) == set(self.keys) or key_args == {}
+        if key_args != {}:
+            key_vals = self._serialize_key_list(
+                [key_args[key_col] for key_col in self.keys]
+            )
+            #
+            key_args_dict = {
+                "key_vals": key_vals,
+                "key_desc": self.key_desc,
+            }
+            other_args_dict = {k: v for k, v in args_dict.items() if k not in self.keys}
+            new_args_dict = {
+                **key_args_dict,
+                **other_args_dict,
+            }
+        else:
+            new_args_dict = args_dict
+        return super()._normalize_kwargs(new_args_dict)
+
+    @staticmethod
+    def _schema_row_id() -> List[ColumnSpecType]:
+        return [
+            ("key_desc", "TEXT"),
+            ("key_vals", "TEXT"),
+        ]
diff --git a/llm/Lib/site-packages/cassio/table/mixins/metadata.py b/llm/Lib/site-packages/cassio/table/mixins/metadata.py
new file mode 100644
index 0000000000000000000000000000000000000000..0f3d7a2dd4b0191135c1a8013b54a661f66b236d
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/mixins/metadata.py
@@ -0,0 +1,385 @@
+import asyncio
+import json
+from typing import Any, Dict, Iterable, List, Optional, Set, Tuple, Union, cast
+
+from cassandra.cluster import ResponseFuture
+
+from cassio.table.cql import (
+    CREATE_ENTRIES_INDEX_CQL_TEMPLATE,
+    SELECT_CQL_TEMPLATE,
+    CQLOpType,
+)
+from cassio.table.table_types import (
+    ColumnSpecType,
+    MetadataIndexingMode,
+    MetadataIndexingPolicy,
+    RowType,
+    is_metadata_field_indexed,
+)
+
+from .base_table import BaseTableMixin
+
+
+class MetadataMixin(BaseTableMixin):
+    def __init__(
+        self,
+        *pargs: Any,
+        metadata_indexing: Union[Tuple[str, Iterable[str]], str] = "all",
+        **kwargs: Any,
+    ) -> None:
+        self.metadata_indexing_policy = self._normalize_metadata_indexing_policy(
+            metadata_indexing
+        )
+        super().__init__(*pargs, **kwargs)
+
+    @staticmethod
+    def _normalize_metadata_indexing_policy(
+        metadata_indexing: Union[Tuple[str, Iterable[str]], str]
+    ) -> MetadataIndexingPolicy:
+        mode: MetadataIndexingMode
+        fields: Set[str]
+        # metadata indexing policy normalization:
+        if isinstance(metadata_indexing, str):
+            if metadata_indexing.lower() == "all":
+                mode, fields = (MetadataIndexingMode.DEFAULT_TO_SEARCHABLE, set())
+            elif metadata_indexing.lower() == "none":
+                mode, fields = (MetadataIndexingMode.DEFAULT_TO_UNSEARCHABLE, set())
+            else:
+                raise ValueError(
+                    f"Unsupported metadata_indexing value '{metadata_indexing}'"
+                )
+        else:
+            assert len(metadata_indexing) == 2
+            # it's a 2-tuple (mode, fields) still to normalize
+            _mode, _field_spec = metadata_indexing
+            fields = {_field_spec} if isinstance(_field_spec, str) else set(_field_spec)
+            if _mode.lower() in {
+                "default_to_unsearchable",
+                "allowlist",
+                "allow",
+                "allow_list",
+            }:
+                mode = MetadataIndexingMode.DEFAULT_TO_UNSEARCHABLE
+            elif _mode.lower() in {
+                "default_to_searchable",
+                "denylist",
+                "deny",
+                "deny_list",
+            }:
+                mode = MetadataIndexingMode.DEFAULT_TO_SEARCHABLE
+            else:
+                raise ValueError(
+                    f"Unsupported metadata indexing mode specification '{_mode}'"
+                )
+        return (mode, fields)
+
+    def _schema_da(self) -> List[ColumnSpecType]:
+        return super()._schema_da() + [
+            ("attributes_blob", "TEXT"),
+            ("metadata_s", "MAP<TEXT,TEXT>"),
+        ]
+
+    @staticmethod
+    def _get_create_entries_index_cql(entries_index_column: str) -> str:
+        index_name = f"eidx_{entries_index_column}"
+        index_column = f"{entries_index_column}"
+        create_index_cql = CREATE_ENTRIES_INDEX_CQL_TEMPLATE.format(
+            index_name=index_name,
+            index_column=index_column,
+        )
+        return create_index_cql
+
+    def db_setup(self) -> None:
+        # Currently: an 'entries' index on the metadata_s column
+        super().db_setup()
+        #
+        for entries_index_column in ["metadata_s"]:
+            create_index_cql = self._get_create_entries_index_cql(entries_index_column)
+            self.execute_cql(create_index_cql, op_type=CQLOpType.SCHEMA)
+
+    async def adb_setup(self) -> None:
+        # Currently: an 'entries' index on the metadata_s column
+        await super().adb_setup()
+        #
+        for entries_index_column in ["metadata_s"]:
+            create_index_cql = self._get_create_entries_index_cql(entries_index_column)
+            await self.aexecute_cql(create_index_cql, op_type=CQLOpType.SCHEMA)
+
+    @staticmethod
+    def _serialize_md_dict(md_dict: Dict[str, Any]) -> str:
+        return json.dumps(md_dict, separators=(",", ":"), sort_keys=True)
+
+    @staticmethod
+    def _deserialize_md_dict(md_string: str) -> Dict[str, Any]:
+        return cast(Dict[str, Any], json.loads(md_string))
+
+    @staticmethod
+    def _coerce_string(value: Any) -> str:
+        if isinstance(value, str):
+            return value
+        elif isinstance(value, bool):
+            # bool MUST come before int in this chain of ifs!
+            return json.dumps(value)
+        elif isinstance(value, int):
+            # we don't want to store '1' and '1.0' differently
+            # for the sake of metadata-filtered retrieval:
+            return json.dumps(float(value))
+        elif isinstance(value, float):
+            return json.dumps(value)
+        elif value is None:
+            return json.dumps(value)
+        else:
+            # when all else fails ...
+            return str(value)
+
+    def _split_metadata_fields(self, md_dict: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Split the *indexed* part of the metadata in separate parts,
+        one per Cassandra column.
+
+        Currently: everything gets cast to a string and goes to a single table
+        column. This means:
+            - strings are fine
+            - floats and integers v: they are cast to str(v)
+            - booleans: 'true'/'false' (JSON style)
+            - None => 'null' (JSON style)
+            - anything else v => str(v), no questions asked
+
+        Caveat: one gets strings back when reading metadata
+        """
+
+        # TODO: more care about types here
+        stringy_part = {k: self._coerce_string(v) for k, v in md_dict.items()}
+        return {
+            "metadata_s": stringy_part,
+        }
+
+    def _normalize_row(self, raw_row: Any) -> Dict[str, Any]:
+        md_columns_defaults: Dict[str, Any] = {
+            "metadata_s": {},
+        }
+        pre_normalized = super()._normalize_row(raw_row)
+        #
+        row_rest = {
+            k: v
+            for k, v in pre_normalized.items()
+            if k not in md_columns_defaults
+            if k != "attributes_blob"
+        }
+        mergee_md_fields = {
+            k: v for k, v in pre_normalized.items() if k in md_columns_defaults
+        }
+        normalized_mergee_md_fields = {
+            k: v if v is not None else md_columns_defaults[k]
+            for k, v in mergee_md_fields.items()
+        }
+        r_md_from_s = {
+            k: v for k, v in normalized_mergee_md_fields["metadata_s"].items()
+        }
+        #
+        raw_attr_blob = pre_normalized.get("attributes_blob")
+        if raw_attr_blob is not None:
+            r_attrs = self._deserialize_md_dict(raw_attr_blob)
+        else:
+            r_attrs = {}
+        #
+        row_metadata = {
+            "metadata": {
+                **r_attrs,
+                **r_md_from_s,
+            },
+        }
+        #
+        normalized = {
+            **row_metadata,
+            **row_rest,
+        }
+        return normalized
+
+    def _normalize_kwargs(self, args_dict: Dict[str, Any]) -> Dict[str, Any]:
+        _metadata_input_dict = args_dict.get("metadata", {})
+        # separate indexed and non-indexed (=attributes) as per indexing policy
+        metadata_indexed_dict = {
+            k: v
+            for k, v in _metadata_input_dict.items()
+            if is_metadata_field_indexed(k, self.metadata_indexing_policy)
+        }
+        attributes_dict = {
+            k: self._coerce_string(v)
+            for k, v in _metadata_input_dict.items()
+            if not is_metadata_field_indexed(k, self.metadata_indexing_policy)
+        }
+        #
+        if attributes_dict != {}:
+            attributes_fields = {
+                "attributes_blob": self._serialize_md_dict(attributes_dict)
+            }
+        else:
+            attributes_fields = {}
+        #
+        new_metadata_fields = {
+            k: v
+            for k, v in self._split_metadata_fields(metadata_indexed_dict).items()
+            if v != {} and v != set()
+        }
+        #
+        new_args_dict = {
+            **{k: v for k, v in args_dict.items() if k != "metadata"},
+            **attributes_fields,
+            **new_metadata_fields,
+        }
+        return super()._normalize_kwargs(new_args_dict)
+
+    def _extract_where_clause_blocks(
+        self, args_dict: Any
+    ) -> Tuple[Any, List[str], Tuple[Any, ...]]:
+        # This always happens after a corresponding _normalize_kwargs,
+        # so the metadata, if present, appears as split-fields.
+        assert "metadata" not in args_dict
+        if "attributes_blob" in args_dict:
+            raise ValueError("Non-indexed metadata fields cannot be used in queries.")
+        md_keys = {"metadata_s"}
+        new_args_dict = {k: v for k, v in args_dict.items() if k not in md_keys}
+        # Here the "metadata" entry is made into specific where clauses
+        split_metadata = {k: v for k, v in args_dict.items() if k in md_keys}
+        these_wc_blocks: List[str] = []
+        these_wc_vals_list: List[Any] = []
+        # WHERE creation:
+        for k, v in sorted(split_metadata.get("metadata_s", {}).items()):
+            these_wc_blocks.append(f"metadata_s['{k}'] = %s")
+            these_wc_vals_list.append(v)
+        # no new kwargs keys are created, all goes to WHERE
+        this_args_dict: Dict[str, Any] = {}
+        these_wc_vals = tuple(these_wc_vals_list)
+        # ready to defer to superclass(es), then collate-and-return
+        (s_args_dict, s_wc_blocks, s_wc_vals) = super()._extract_where_clause_blocks(
+            new_args_dict
+        )
+        return (
+            {**this_args_dict, **s_args_dict},
+            these_wc_blocks + s_wc_blocks,
+            tuple(list(these_wc_vals) + list(s_wc_vals)),
+        )
+
+    def _get_find_entries_cql(
+        self, n: int, **kwargs: Any
+    ) -> Tuple[str, Tuple[Any, ...]]:
+        columns_desc, where_clause, get_cql_vals = self._parse_select_core_params(
+            **kwargs
+        )
+        limit_clause = "LIMIT %s"
+        limit_cql_vals = [n]
+        select_vals = tuple(list(get_cql_vals) + limit_cql_vals)
+        #
+        select_cql = SELECT_CQL_TEMPLATE.format(
+            columns_desc=columns_desc,
+            where_clause=where_clause,
+            limit_clause=limit_clause,
+        )
+        return select_cql, select_vals
+
+    def find_entries(self, n: int, **kwargs: Any) -> Iterable[RowType]:
+        select_cql, select_vals = self._get_find_entries_cql(n, **kwargs)
+        result_set = self.execute_cql(
+            select_cql, args=select_vals, op_type=CQLOpType.READ
+        )
+        return (self._normalize_row(result) for result in result_set)
+
+    def find_entries_async(self, n: int, **kwargs: Any) -> ResponseFuture:
+        raise NotImplementedError("Asynchronous reads are not supported.")
+
+    async def afind_entries(self, n: int, **kwargs: Any) -> Iterable[RowType]:
+        select_cql, select_vals = self._get_find_entries_cql(n, **kwargs)
+        result_set = await self.aexecute_cql(
+            select_cql, args=select_vals, op_type=CQLOpType.READ
+        )
+        return (self._normalize_row(result) for result in result_set)
+
+    @staticmethod
+    def _get_to_delete_and_visited(
+        n: Optional[int],
+        batch_size: int,
+        visited_tuples: Set[Tuple[Any, ...]],
+        del_pkargs: Optional[List[Any]] = None,
+    ) -> Tuple[int, Set[Tuple[Any, ...]]]:
+        if del_pkargs is not None:
+            visited_tuples.update(tuple(del_pkarg) for del_pkarg in del_pkargs)
+        if n is not None:
+            to_delete = min(batch_size, n - len(visited_tuples))
+        else:
+            to_delete = batch_size
+        return to_delete, visited_tuples
+
+    def find_and_delete_entries(
+        self, n: Optional[int] = None, batch_size: int = 20, **kwargs: Any
+    ) -> int:
+        # Use `find_entries` to delete entries based
+        # on queries with metadata, etc. Suitable when `find_entries` is a fit.
+        # Returns the number of rows supposedly deleted.
+        # Warning: reads before writing. Not very efficient (nor Cassandraic).
+        #
+        # TODO: Use the 'columns' for a narrowed projection
+        # TODO: decouple finding and deleting (streaming) for faster performance
+        primary_key_cols = [col for col, _ in self._schema_primary_key()]
+        #
+        batch_size = 20
+        to_delete, visited_tuples = self._get_to_delete_and_visited(
+            n, batch_size, set()
+        )
+        while to_delete > 0:
+            del_pkargs = [
+                [found_row[pkc] for pkc in primary_key_cols]
+                for found_row in self.find_entries(n=to_delete, **kwargs)
+            ]
+            if del_pkargs == []:
+                break
+            d_futures = [
+                self.delete_async(
+                    **{pkc: pkv for pkc, pkv in zip(primary_key_cols, del_pkarg)}
+                )
+                for del_pkarg in del_pkargs
+                if tuple(del_pkarg) not in visited_tuples
+            ]
+            if d_futures == []:
+                break
+            for d_future in d_futures:
+                _ = d_future.result()
+            to_delete, visited_tuples = self._get_to_delete_and_visited(
+                n, batch_size, visited_tuples, del_pkargs
+            )
+        #
+        return len(visited_tuples)
+
+    def find_and_delete_entries_async(self, **kwargs: Any) -> ResponseFuture:
+        raise NotImplementedError("Asynchronous reads are not supported.")
+
+    async def afind_and_delete_entries(
+        self, n: Optional[int] = None, batch_size: int = 20, **kwargs: Any
+    ) -> int:
+        primary_key_cols = [col for col, _ in self._schema_primary_key()]
+        #
+        batch_size = 20
+        to_delete, visited_tuples = self._get_to_delete_and_visited(
+            n, batch_size, set()
+        )
+        while to_delete > 0:
+            del_pkargs = [
+                [found_row[pkc] for pkc in primary_key_cols]
+                for found_row in await self.afind_entries(n=to_delete, **kwargs)
+            ]
+            delete_coros = [
+                self.adelete(
+                    **{pkc: pkv for pkc, pkv in zip(primary_key_cols, del_pkarg)}
+                )
+                for del_pkarg in del_pkargs
+                if tuple(del_pkarg) not in visited_tuples
+            ]
+            if not delete_coros:
+                break
+            await asyncio.gather(*delete_coros)
+
+            to_delete, visited_tuples = self._get_to_delete_and_visited(
+                n, batch_size, visited_tuples, del_pkargs
+            )
+        #
+        return len(visited_tuples)
diff --git a/llm/Lib/site-packages/cassio/table/mixins/type_normalizer.py b/llm/Lib/site-packages/cassio/table/mixins/type_normalizer.py
new file mode 100644
index 0000000000000000000000000000000000000000..b74e9b1728e992cb44e93fc5965820f10a743640
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/mixins/type_normalizer.py
@@ -0,0 +1,39 @@
+from typing import Any
+
+from cassio.table.table_types import rearrange_pk_type
+
+from .base_table import BaseTableMixin
+
+
+class TypeNormalizerMixin(BaseTableMixin):
+    clustered: bool = False
+    elastic: bool = False
+
+    def __init__(self, *pargs: Any, **kwargs: Any) -> None:
+        if "primary_key_type" in kwargs:
+            if "row_id_type" in kwargs:
+                raise ValueError(
+                    "Use of 'row_id_type' not allowed with 'primary_key_type'. "
+                    "Please pass 'partition_id_type' instead of 'primary_key_type', "
+                    "or specify 'num_partition_keys' to cut the primary key."
+                )
+            pk_arg = kwargs["primary_key_type"]
+            num_elastic_keys = len(kwargs["keys"]) if self.elastic else None
+            num_partition_keys = kwargs.get("num_partition_keys")
+            col_type_map = rearrange_pk_type(
+                pk_type=pk_arg,
+                clustered=self.clustered,
+                num_partition_keys=num_partition_keys,
+                num_elastic_keys=num_elastic_keys,
+            )
+            new_kwargs = {
+                **col_type_map,
+                **{
+                    k: v
+                    for k, v in kwargs.items()
+                    if k not in {"num_partition_keys", "primary_key_type"}
+                },
+            }
+        else:
+            new_kwargs = kwargs
+        super().__init__(*pargs, **new_kwargs)
diff --git a/llm/Lib/site-packages/cassio/table/mixins/vector.py b/llm/Lib/site-packages/cassio/table/mixins/vector.py
new file mode 100644
index 0000000000000000000000000000000000000000..0f2cb53b15d17c7b5aef5395abca9e5d41e2dd39
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/mixins/vector.py
@@ -0,0 +1,242 @@
+import inspect
+from operator import itemgetter
+from typing import Any, Awaitable, Iterable, List, Optional, Tuple, Union
+
+from cassandra.cluster import ResponseFuture
+
+from cassio.table.base_table import BaseTable
+from cassio.table.cql import SELECT_ANN_CQL_TEMPLATE, CQLOpType
+from cassio.table.table_types import ColumnSpecType, RowType, RowWithDistanceType
+from cassio.utils.vector.distance_metrics import distance_metrics
+
+from .base_table import BaseTableMixin
+
+
+class VectorMixin(BaseTableMixin):
+    def __init__(
+        self,
+        *pargs: Any,
+        vector_dimension: Union[int, Awaitable[int]],
+        vector_similarity_function: Optional[str] = None,
+        vector_source_model: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        if inspect.isawaitable(vector_dimension) and not kwargs.get(
+            "async_setup", False
+        ):
+            raise ValueError(
+                "Cannot use an awaitable embedding_dimension "
+                "with async_setup set to False"
+            )
+        self.vector_dimension = vector_dimension
+        self.vector_index_options = []
+        if vector_similarity_function is not None:
+            self.vector_index_options.append(
+                ("similarity_function", vector_similarity_function)
+            )
+        if vector_source_model is not None:
+            self.vector_index_options.append(("source_model", vector_source_model))
+        super().__init__(*pargs, **kwargs)
+
+    def _schema_da(self) -> List[ColumnSpecType]:
+        return super()._schema_da() + [
+            ("vector", f"VECTOR<FLOAT,{self.vector_dimension}>")
+        ]
+
+    async def _aschema_da(self) -> List[ColumnSpecType]:
+        if inspect.isawaitable(self.vector_dimension):
+            self.vector_dimension = await self.vector_dimension
+        return self._schema_da()
+
+    @staticmethod
+    def _get_create_vector_index_cql(
+        vector_index_options: List[Tuple[str, Any]]
+    ) -> str:
+        index_name = "idx_vector"
+        index_column = "vector"
+        return BaseTable._get_create_index_cql(
+            index_name=index_name,
+            index_column=index_column,
+            index_options=vector_index_options,
+        )
+
+    def db_setup(self) -> None:
+        super().db_setup()
+        # index on the vector column:
+        create_index_cql = self._get_create_vector_index_cql(self.vector_index_options)
+        self.execute_cql(create_index_cql, op_type=CQLOpType.SCHEMA)
+
+    async def adb_setup(self) -> None:
+        await super().adb_setup()
+        # index on the vector column:
+        create_index_cql = self._get_create_vector_index_cql(self.vector_index_options)
+        await self.aexecute_cql(create_index_cql, op_type=CQLOpType.SCHEMA)
+
+    def _get_ann_search_cql(
+        self, vector: List[float], n: int, **kwargs: Any
+    ) -> Tuple[str, Tuple[Any, ...]]:
+        n_kwargs = self._normalize_kwargs(kwargs)
+        # TODO: work on a columns: Optional[List[str]] = None
+        # (but with nuanced handling of the column-magic we have here)
+        columns = None
+        if columns is None:
+            columns_desc = "*"
+        else:
+            # TODO: handle translations here?
+            # columns_desc = ", ".join(columns)
+            raise NotImplementedError("Column selection is not implemented.")
+        #
+        if all(x == 0 for x in vector):
+            # TODO: lift/relax this constraint when non-cosine metrics are there.
+            raise ValueError("Cannot use identically-zero vectors in cos/ANN search.")
+        #
+        vector_column = "vector"
+        vector_cql_vals = (vector,)
+        #
+        (
+            rest_kwargs,
+            where_clause_blocks,
+            where_cql_vals,
+        ) = self._extract_where_clause_blocks(n_kwargs)
+
+        (
+            rest_kwargs,
+            analyzer_clause_blocks,
+            analyzer_cql_vals,
+        ) = self._extract_index_analyzers(rest_kwargs)
+
+        assert rest_kwargs == {}
+
+        all_where_clauses = where_clause_blocks + analyzer_clause_blocks
+        if not all_where_clauses:
+            where_clause = ""
+        else:
+            where_clause = "WHERE " + " AND ".join(all_where_clauses)
+        #
+        limit_clause = "LIMIT %s"
+        limit_cql_vals = (n,)
+        #
+        select_ann_cql = SELECT_ANN_CQL_TEMPLATE.format(
+            columns_desc=columns_desc,
+            vector_column=vector_column,
+            where_clause=where_clause,
+            limit_clause=limit_clause,
+        )
+        #
+        select_ann_cql_vals = (
+            where_cql_vals + analyzer_cql_vals + vector_cql_vals + limit_cql_vals
+        )
+
+        return select_ann_cql, select_ann_cql_vals
+
+    def ann_search(
+        self, vector: List[float], n: int, **kwargs: Any
+    ) -> Iterable[RowType]:
+        select_ann_cql, select_ann_cql_vals = self._get_ann_search_cql(
+            vector, n, **kwargs
+        )
+        result_set = self.execute_cql(
+            select_ann_cql, args=select_ann_cql_vals, op_type=CQLOpType.READ
+        )
+        return (self._normalize_row(result) for result in result_set)
+
+    def ann_search_async(
+        self, vector: List[float], n: int, **kwargs: Any
+    ) -> ResponseFuture:
+        raise NotImplementedError("Asynchronous reads are not supported.")
+
+    async def aann_search(
+        self, vector: List[float], n: int, **kwargs: Any
+    ) -> Iterable[RowType]:
+        select_ann_cql, select_ann_cql_vals = self._get_ann_search_cql(
+            vector, n, **kwargs
+        )
+        result_set = await self.aexecute_cql(
+            select_ann_cql, args=select_ann_cql_vals, op_type=CQLOpType.READ
+        )
+        return (self._normalize_row(result) for result in result_set)
+
+    @staticmethod
+    def _get_rows_with_distance(
+        rows: Iterable[RowType],
+        vector: List[float],
+        metric: str,
+        metric_threshold: Optional[float] = None,
+    ) -> Iterable[RowWithDistanceType]:
+        if rows == []:
+            return []
+        else:
+            # sort, cut, validate and prepare for returning
+            # evaluate metric
+            distance_function, distance_reversed = distance_metrics[metric]
+            row_vectors = [row["vector"] for row in rows]
+            # enrich with their metric score
+            rows_with_metric = list(
+                zip(
+                    distance_function(row_vectors, vector),
+                    rows,
+                )
+            )
+            # sort rows by metric score. First handle metric/threshold
+            if metric_threshold is not None:
+                _used_thr = metric_threshold
+                if distance_reversed:
+
+                    def _thresholder(mtx: float, thr: float) -> bool:
+                        return mtx >= thr
+
+                else:
+
+                    def _thresholder(mtx: float, thr: float) -> bool:
+                        return mtx <= thr
+
+            else:
+                # this to satisfy the type checker
+                _used_thr = 0.0
+
+                # no hits are discarded
+                def _thresholder(mtx: float, thr: float) -> bool:
+                    return True
+
+            #
+            sorted_passing_rows = sorted(
+                (pair for pair in rows_with_metric if _thresholder(pair[0], _used_thr)),
+                key=itemgetter(0),
+                reverse=distance_reversed,
+            )
+            # return a list of hits with their distance (as JSON)
+            enriched_hits = (
+                {
+                    **hit,
+                    **{"distance": distance},
+                }
+                for distance, hit in sorted_passing_rows
+            )
+            return enriched_hits
+
+    def metric_ann_search(
+        self,
+        vector: List[float],
+        n: int,
+        metric: str,
+        metric_threshold: Optional[float] = None,
+        **kwargs: Any,
+    ) -> Iterable[RowWithDistanceType]:
+        rows = list(self.ann_search(vector, n, **kwargs))
+        return self._get_rows_with_distance(rows, vector, metric, metric_threshold)
+
+    def metric_ann_search_async(
+        self, vector: List[float], n: int, **kwargs: Any
+    ) -> ResponseFuture:
+        raise NotImplementedError("Asynchronous reads are not supported.")
+
+    async def ametric_ann_search(
+        self,
+        vector: List[float],
+        n: int,
+        metric: str,
+        metric_threshold: Optional[float] = None,
+        **kwargs: Any,
+    ) -> Iterable[RowWithDistanceType]:
+        rows = list(await self.aann_search(vector, n, **kwargs))
+        return self._get_rows_with_distance(rows, vector, metric, metric_threshold)
diff --git a/llm/Lib/site-packages/cassio/table/query.py b/llm/Lib/site-packages/cassio/table/query.py
new file mode 100644
index 0000000000000000000000000000000000000000..2192a904af89b3cfbdf7f9785925d0269187da57
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/query.py
@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from enum import Enum
+from typing import Any, Tuple, Union
+
+
+class PredicateOperator(Enum):
+    EQ = "="
+    LT = "<"
+    LTE = "<="
+    GT = ">"
+    GTE = ">="
+
+
+class Predicate:
+    operator: PredicateOperator
+    value: Any
+
+    def __init__(self, operator: Union[str, PredicateOperator], value: Any) -> None:
+        if isinstance(operator, str):
+            _operator = PredicateOperator(operator)
+        else:
+            _operator = operator
+        self._operator = _operator
+        self._value = value
+
+    def render(self) -> Tuple[str, Any]:
+        return (
+            self._operator.value,
+            self._value,
+        )
diff --git a/llm/Lib/site-packages/cassio/table/table_types.py b/llm/Lib/site-packages/cassio/table/table_types.py
new file mode 100644
index 0000000000000000000000000000000000000000..03b2cf27bd9a6dbe4c72c59aa5d9142bfb605e87
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/table_types.py
@@ -0,0 +1,72 @@
+from enum import Enum
+from typing import Any, Dict, List, Optional, Set, Tuple, Union
+
+ColumnSpecType = Tuple[str, str]
+RowType = Dict[str, Any]
+RowWithDistanceType = Dict[str, Any]
+SessionType = Any
+
+
+class MetadataIndexingMode(Enum):
+    DEFAULT_TO_UNSEARCHABLE = 1
+    DEFAULT_TO_SEARCHABLE = 2
+
+
+MetadataIndexingPolicy = Tuple[MetadataIndexingMode, Set[str]]
+
+
+def is_metadata_field_indexed(field_name: str, policy: MetadataIndexingPolicy) -> bool:
+    p_mode, p_fields = policy
+    if p_mode == MetadataIndexingMode.DEFAULT_TO_UNSEARCHABLE:
+        return field_name in p_fields
+    elif p_mode == MetadataIndexingMode.DEFAULT_TO_SEARCHABLE:
+        return field_name not in p_fields
+    else:
+        raise ValueError(f"Unexpected metadata indexing mode {p_mode}")
+
+
+def normalize_type_desc(type_desc: Union[str, List[str]]) -> List[str]:
+    if isinstance(type_desc, str):
+        return [type_desc]
+    else:
+        return type_desc
+
+
+def rearrange_pk_type(
+    pk_type: Union[str, List[str]],
+    clustered: bool,
+    num_partition_keys: Optional[int],
+    num_elastic_keys: Optional[int],
+) -> Dict[str, List[str]]:
+    """A compatibility layer with the 'primary_key_type' specifier on init."""
+    _pk_type = normalize_type_desc(pk_type)
+    if clustered:
+        _num_partition_keys = (
+            num_partition_keys if num_partition_keys is not None else 1
+        )
+        pk_type, rest_type = (
+            _pk_type[0:_num_partition_keys],
+            _pk_type[_num_partition_keys:],
+        )
+        if num_elastic_keys:
+            assert len(rest_type) == num_elastic_keys
+            return {
+                "partition_id_type": pk_type,
+            }
+        else:
+            return {
+                "row_id_type": rest_type,
+                "partition_id_type": pk_type,
+            }
+    else:
+        if num_partition_keys is not None:
+            raise ValueError(
+                "Cannot specify `num_partition_keys` unless Clustered table"
+            )
+        if num_elastic_keys:
+            assert len(_pk_type) == num_elastic_keys
+            return {}
+        else:
+            return {
+                "row_id_type": _pk_type,
+            }
diff --git a/llm/Lib/site-packages/cassio/table/tables.py b/llm/Lib/site-packages/cassio/table/tables.py
new file mode 100644
index 0000000000000000000000000000000000000000..ea00730062adbc836b2c3ec4e91f990a6fecc6af
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/tables.py
@@ -0,0 +1,113 @@
+from cassio.table.base_table import BaseTable
+from cassio.table.mixins.clustered import ClusteredMixin
+from cassio.table.mixins.elastic_key import ElasticKeyMixin
+from cassio.table.mixins.metadata import MetadataMixin
+from cassio.table.mixins.type_normalizer import TypeNormalizerMixin
+from cassio.table.mixins.vector import VectorMixin
+
+
+class PlainCassandraTable(TypeNormalizerMixin, BaseTable):
+    pass
+
+
+class ClusteredCassandraTable(TypeNormalizerMixin, ClusteredMixin, BaseTable):
+    clustered = True
+    pass
+
+
+class ClusteredMetadataCassandraTable(
+    TypeNormalizerMixin, MetadataMixin, ClusteredMixin, BaseTable
+):
+    clustered = True
+    pass
+
+
+class MetadataCassandraTable(TypeNormalizerMixin, MetadataMixin, BaseTable):
+    pass
+
+
+class VectorCassandraTable(TypeNormalizerMixin, VectorMixin, BaseTable):
+    pass
+
+
+class ClusteredVectorCassandraTable(
+    TypeNormalizerMixin, VectorMixin, ClusteredMixin, BaseTable
+):
+    clustered = True
+    pass
+
+
+class ClusteredMetadataVectorCassandraTable(
+    TypeNormalizerMixin, MetadataMixin, ClusteredMixin, VectorMixin, BaseTable
+):
+    clustered = True
+    pass
+
+
+class MetadataVectorCassandraTable(
+    TypeNormalizerMixin, MetadataMixin, VectorMixin, BaseTable
+):
+    pass
+
+
+class ElasticCassandraTable(TypeNormalizerMixin, ElasticKeyMixin, BaseTable):
+    elastic = True
+    pass
+
+
+class ClusteredElasticCassandraTable(
+    TypeNormalizerMixin, ClusteredMixin, ElasticKeyMixin, BaseTable
+):
+    clustered = True
+    elastic = True
+    pass
+
+
+class ClusteredElasticMetadataCassandraTable(
+    TypeNormalizerMixin, MetadataMixin, ElasticKeyMixin, ClusteredMixin, BaseTable
+):
+    clustered = True
+    elastic = True
+    pass
+
+
+class ElasticMetadataCassandraTable(
+    TypeNormalizerMixin, MetadataMixin, ElasticKeyMixin, BaseTable
+):
+    elastic = True
+    pass
+
+
+class ElasticVectorCassandraTable(
+    TypeNormalizerMixin, VectorMixin, ElasticKeyMixin, BaseTable
+):
+    elastic = True
+    pass
+
+
+class ClusteredElasticVectorCassandraTable(
+    TypeNormalizerMixin, ClusteredMixin, ElasticKeyMixin, VectorMixin, BaseTable
+):
+    clustered = True
+    elastic = True
+    pass
+
+
+class ClusteredElasticMetadataVectorCassandraTable(
+    TypeNormalizerMixin,
+    MetadataMixin,
+    ElasticKeyMixin,
+    ClusteredMixin,
+    VectorMixin,
+    BaseTable,
+):
+    clustered = True
+    elastic = True
+    pass
+
+
+class ElasticMetadataVectorCassandraTable(
+    MetadataMixin, ElasticKeyMixin, VectorMixin, BaseTable
+):
+    elastic = True
+    pass
diff --git a/llm/Lib/site-packages/cassio/table/utils.py b/llm/Lib/site-packages/cassio/table/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..5acf430787686df3ef2046f727a0776c53e10803
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/table/utils.py
@@ -0,0 +1,97 @@
+import asyncio
+from typing import Any, Callable, Dict, Iterable
+
+from cassandra.cluster import ResponseFuture
+
+
+async def call_wrapped_async(
+    func: Callable[..., ResponseFuture], *args: Any, **kwargs: Any
+) -> Any:
+    loop = asyncio.get_event_loop()
+    asyncio_future = loop.create_future()
+    response_future = func(*args, **kwargs)
+
+    def success_handler(_: Any) -> None:
+        loop.call_soon_threadsafe(asyncio_future.set_result, response_future.result())
+
+    def error_handler(exc: BaseException) -> None:
+        loop.call_soon_threadsafe(asyncio_future.set_exception, exc)
+
+    response_future.add_callbacks(success_handler, error_handler)
+    return await asyncio_future
+
+
+def handle_multicolumn_unpacking(
+    args_dict: Dict[str, Any],
+    key_name: str,
+    unpacked_keys: Iterable[str],
+) -> Dict[str, Any]:
+    """
+    Given a dictionary of "args", handle if necessary the replacement of one of its items
+    with corresponding split-tuple version if the type structure requires it.
+    So if unpacked_keys is == [key_name], do nothing.
+    If the key_name is None, remove it from the mapping altogether.
+    Returns the modified dictionary.
+
+    Example:
+        args_dict = {"k": (1, 20), "x": "..."}
+        key_name = "k"
+        unpacked_keys = ["k_0", "k_1"]
+    results in
+        {"k_0": 1, "k_1": 20, "x": "..."}
+
+    Example:
+        args_dict = {"k": "k_val", "x": "..."}
+        key_name = "k"
+        unpacked_keys = ["k"]
+    results in (unchanged)
+        {"k": "k_val", "x": "..."}
+
+    Example:
+        args_dict = {"x": "..."}
+        args_dict = {"k": None, "x": "..."}
+    both result in
+        {"x": "..."}
+    """
+    _unp_keys = list(unpacked_keys)
+    if args_dict.get(key_name) is not None:
+        if _unp_keys != [key_name]:
+            # passing a longer tuple than the keys is meaningless:
+            assert len(_unp_keys) >= len(args_dict[key_name])
+            # unpack the tuple
+            split_part = {
+                unp_k: tuple_v for unp_k, tuple_v in zip(_unp_keys, args_dict[key_name])
+            }
+        else:
+            split_part = {key_name: args_dict[key_name]}
+    else:
+        split_part = {}
+
+    new_args_dict = {
+        **split_part,
+        **{k: v for k, v in args_dict.items() if k != key_name},
+    }
+    return new_args_dict
+
+
+def handle_multicolumn_packing(
+    unpacked_row: Dict[str, Any],
+    key_name: str,
+    unpacked_keys: Iterable[str],
+) -> Dict[str, Any]:
+    _unp_keys = list(unpacked_keys)
+    if _unp_keys != [key_name]:
+        packed_keys = {k: v for k, v in unpacked_row.items() if k in _unp_keys}
+        if packed_keys == {}:
+            return unpacked_row
+        else:
+            pk_tuple = tuple(packed_keys[pk_k] for pk_k in _unp_keys)
+            packed_row_portion = {
+                key_name: pk_tuple,
+            }
+            return {
+                **packed_row_portion,
+                **{k: v for k, v in unpacked_row.items() if k not in _unp_keys},
+            }
+    else:
+        return unpacked_row
diff --git a/llm/Lib/site-packages/cassio/utils/__init__.py b/llm/Lib/site-packages/cassio/utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6e213304ca41ad6cb10cdb0d32b63000e34fb1d3
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/utils/__init__.py
@@ -0,0 +1,3 @@
+from cassio.utils.vector.distance_metrics import distance_metrics
+
+__all__ = ["distance_metrics"]
diff --git a/llm/Lib/site-packages/cassio/utils/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassio/utils/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fff08c66741f8597a126c28da024230bfc4a2c85
Binary files /dev/null and b/llm/Lib/site-packages/cassio/utils/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/utils/db_inspection/__init__.py b/llm/Lib/site-packages/cassio/utils/db_inspection/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..23857bda06f2f603bbfb65adb4e557e9d0b58a09
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/utils/db_inspection/__init__.py
@@ -0,0 +1,36 @@
+"""
+Inspection of a keyspace and its tables through metadata in the Session object.
+"""
+
+from typing import Iterable, Tuple
+
+from cassandra.cluster import Session
+
+ColumnType = Tuple[str, str]
+
+
+def table_primarykey(
+    session: Session, keyspace: str, table: str
+) -> Iterable[ColumnType]:
+    table_obj = session.cluster.metadata.keyspaces[keyspace].tables[table]
+    return ((col.name, col.cql_type) for col in table_obj.partition_key)
+
+
+def table_clusteringcolumns(
+    session: Session, keyspace: str, table: str
+) -> Iterable[ColumnType]:
+    table_obj = session.cluster.metadata.keyspaces[keyspace].tables[table]
+    return ((col.name, col.cql_type) for col in table_obj.clustering_key)
+
+
+def table_partitionkey(
+    session: Session, keyspace: str, table: str
+) -> Iterable[ColumnType]:
+    return (
+        col
+        for col_src in (
+            table_primarykey(session, keyspace, table),
+            table_clusteringcolumns(session, keyspace, table),
+        )
+        for col in col_src
+    )
diff --git a/llm/Lib/site-packages/cassio/utils/db_inspection/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassio/utils/db_inspection/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1a947c174f9ff28126d4254210425c3a63c9b440
Binary files /dev/null and b/llm/Lib/site-packages/cassio/utils/db_inspection/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/utils/vector/__init__.py b/llm/Lib/site-packages/cassio/utils/vector/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..89ae302985acb05e50a849d2eb5dcee4da4388d1
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/utils/vector/__init__.py
@@ -0,0 +1 @@
+from cassio.utils.vector.distance_metrics import distance_metrics  # noqa: F401
diff --git a/llm/Lib/site-packages/cassio/utils/vector/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassio/utils/vector/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..12f86b4941e9d45d8874a51e881e3cbd3daa7d2e
Binary files /dev/null and b/llm/Lib/site-packages/cassio/utils/vector/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/utils/vector/__pycache__/distance_metrics.cpython-311.pyc b/llm/Lib/site-packages/cassio/utils/vector/__pycache__/distance_metrics.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..990e2b4a533e18890e1d321d195ce4e31128c09a
Binary files /dev/null and b/llm/Lib/site-packages/cassio/utils/vector/__pycache__/distance_metrics.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/utils/vector/distance_metrics.py b/llm/Lib/site-packages/cassio/utils/vector/distance_metrics.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc86212a1794e3081a26ee0b0f45118917ac7582
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/utils/vector/distance_metrics.py
@@ -0,0 +1,100 @@
+from typing import Callable, Dict, List, Tuple
+
+import numpy as np
+
+VectorType = List[float]
+
+
+# distance definitions. These all work batched in the first argument.
+def distance_dot_product(
+    embedding_vectors: List[VectorType], reference_embedding_vector: VectorType
+) -> List[float]:
+    """
+    Given a list [emb_i] and a reference rEmb vector,
+    return a list [distance_i] where each distance is
+        distance_i = distance(emb_i, rEmb)
+    At the moment only the dot product is supported
+    (which for unitary vectors is the cosine difference).
+
+    Not particularly optimized.
+    """
+    v1s = np.array(embedding_vectors, dtype=float)
+    v2 = np.array(reference_embedding_vector, dtype=float)
+    return list(
+        np.dot(
+            v1s,
+            v2.T,
+        )
+    )
+
+
+def distance_cos_difference(
+    embedding_vectors: List[VectorType], reference_embedding_vector: VectorType
+) -> List[float]:
+    v1s = np.array(embedding_vectors, dtype=float)
+    v2 = np.array(reference_embedding_vector, dtype=float)
+    return list(
+        np.dot(
+            v1s,
+            v2.T,
+        )
+        / (np.linalg.norm(v1s, axis=1) * np.linalg.norm(v2))
+    )
+
+
+def distance_l1(
+    embedding_vectors: List[VectorType], reference_embedding_vector: VectorType
+) -> List[float]:
+    v1s = np.array(embedding_vectors, dtype=float)
+    v2 = np.array(reference_embedding_vector, dtype=float)
+    return list(np.linalg.norm(v1s - v2, axis=1, ord=1))
+
+
+def distance_l2(
+    embedding_vectors: List[VectorType], reference_embedding_vector: VectorType
+) -> List[float]:
+    v1s = np.array(embedding_vectors, dtype=float)
+    v2 = np.array(reference_embedding_vector, dtype=float)
+    return list(np.linalg.norm(v1s - v2, axis=1, ord=2))
+
+
+def distance_max(
+    embedding_vectors: List[VectorType], reference_embedding_vector: VectorType
+) -> List[float]:
+    v1s = np.array(embedding_vectors, dtype=float)
+    v2 = np.array(reference_embedding_vector, dtype=float)
+    return list(np.linalg.norm(v1s - v2, axis=1, ord=np.inf))
+
+
+# The tuple is:
+#   (
+#       function,
+#       sorting 'reverse' argument, nearest-to-farthest
+#   )
+# (i.e. True means that:
+#     - in that metric higher is closer and that
+#     - cutoff should be metric > threshold)
+distance_metrics: Dict[
+    str, Tuple[Callable[[List[VectorType], VectorType], List[float]], bool]
+] = {
+    "cos": (
+        distance_cos_difference,
+        True,
+    ),
+    "dot": (
+        distance_dot_product,
+        True,
+    ),
+    "l1": (
+        distance_l1,
+        False,
+    ),
+    "l2": (
+        distance_l2,
+        False,
+    ),
+    "max": (
+        distance_max,
+        False,
+    ),
+}
diff --git a/llm/Lib/site-packages/cassio/vector/__init__.py b/llm/Lib/site-packages/cassio/vector/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c25b2d666196821dfe11390b8565008ff78af68c
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/vector/__init__.py
@@ -0,0 +1,3 @@
+from cassio.vector.vector_table import VectorTable
+
+__all__ = ["VectorTable"]
diff --git a/llm/Lib/site-packages/cassio/vector/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cassio/vector/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0d6c3e00048a69a73a325e31c0b9bee7c06cfe1a
Binary files /dev/null and b/llm/Lib/site-packages/cassio/vector/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/vector/__pycache__/vector_table.cpython-311.pyc b/llm/Lib/site-packages/cassio/vector/__pycache__/vector_table.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..72621ee9461a8ad8ee5f9459c2eddf89db214390
Binary files /dev/null and b/llm/Lib/site-packages/cassio/vector/__pycache__/vector_table.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cassio/vector/vector_table.py b/llm/Lib/site-packages/cassio/vector/vector_table.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d1638541aab205c19fceeb9a0d7ac051b1a44a4
--- /dev/null
+++ b/llm/Lib/site-packages/cassio/vector/vector_table.py
@@ -0,0 +1,140 @@
+"""
+Compatibility layer for legacy VectorTable (used by LangChain integration
+(as of August 2023).
+
+Note: This is to be replaced by direct usage of the table-class-hierarchy classes.
+"""
+
+from typing import Any, Dict, List, Optional
+from warnings import warn
+
+from cassandra.cluster import ResponseFuture
+
+from cassio.table.table_types import RowType
+from cassio.table.tables import MetadataVectorCassandraTable
+
+new_columns_to_legacy = {
+    "row_id": "document_id",
+    "body_blob": "document",
+    "vector": "embedding_vector",
+}
+legacy_columns_to_new = {v: k for k, v in new_columns_to_legacy.items()}
+
+
+class VectorTable:
+    """
+    This class is a rewriting of the VectorTable created for use in LangChain
+    integration, this time relying on the class-table-hierarchy (cassio.table.*).
+
+    It mostly provides a translation layer between parameters and key names,
+    using a metadata+vector table class internally.
+
+    Additional kwargs, for use in this new table class, are passed as they are
+    in order to enable their usage already before adapting the LangChain
+    integration code.
+    """
+
+    DEPRECATION_MESSAGE = (
+        "Class `VectorTable` is a legacy construct and "
+        "will be deprecated in future versions of CassIO."
+    )
+
+    def __init__(self, *pargs: Any, **kwargs: Any):
+        #
+        warn(self.DEPRECATION_MESSAGE, DeprecationWarning, stacklevel=2)
+        #
+        if "embedding_dimension" in kwargs:
+            vector_dimension = kwargs["embedding_dimension"]
+            new_kwargs = {
+                **{
+                    k: v
+                    for k, v in kwargs.items()
+                    if k != "embedding_dimension"
+                    # let's get rid of the infamous 'auto_id' here:
+                    if k != "auto_id"
+                },
+                **{"vector_dimension": vector_dimension},
+            }
+        else:
+            new_kwargs = kwargs
+        # this legacy VectorTable will have everything indexed for search:
+        md_kwargs = {
+            **{"metadata_indexing": "all"},
+            **new_kwargs,
+        }
+        #
+        self.table = MetadataVectorCassandraTable(*pargs, **md_kwargs)
+
+    def search(
+        self,
+        embedding_vector: List[float],
+        top_k: int,
+        metric: str = "cos",
+        metric_threshold: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[RowType]:
+        # get rows by ANN
+        enriched_hits = self.table.metric_ann_search(
+            vector=embedding_vector,
+            n=top_k,
+            metric=metric,
+            metric_threshold=metric_threshold,
+            **kwargs,
+        )
+        #
+        return [self._make_dict_legacy(rich_hit) for rich_hit in enriched_hits]
+
+    def put(
+        self,
+        document: str,
+        embedding_vector: List[float],
+        document_id: Any,
+        metadata: Optional[Dict[str, Any]] = None,
+        ttl_seconds: Optional[int] = None,
+        **kwargs: Any,
+    ) -> None:
+        self.table.put(
+            row_id=document_id,
+            body_blob=document,
+            vector=embedding_vector,
+            metadata=metadata or {},
+            ttl_seconds=ttl_seconds,
+            **kwargs,
+        )
+
+    def put_async(
+        self,
+        document: str,
+        embedding_vector: List[float],
+        document_id: Any,
+        metadata: Optional[Dict[str, Any]] = None,
+        ttl_seconds: Optional[int] = None,
+        **kwargs: Any,
+    ) -> ResponseFuture:
+        return self.table.put_async(
+            row_id=document_id,
+            body_blob=document,
+            vector=embedding_vector,
+            metadata=metadata or {},
+            ttl_seconds=ttl_seconds,
+            **kwargs,
+        )
+
+    def get(self, document_id: Any, **kwargs: Any) -> Optional[RowType]:
+        row_or_none = self.table.get(row_id=document_id, **kwargs)
+        if row_or_none:
+            return self._make_dict_legacy(row_or_none)
+        else:
+            return row_or_none
+
+    def delete(self, document_id: Any, **kwargs: Any) -> None:
+        self.table.delete(row_id=document_id, **kwargs)
+        return None
+
+    def clear(self) -> None:
+        self.table.clear()
+        return None
+
+    @staticmethod
+    def _make_dict_legacy(new_dict: RowType) -> RowType:
+        return {new_columns_to_legacy.get(k, k): v for k, v in new_dict.items()}
diff --git a/llm/Lib/site-packages/certifi-2024.2.2.dist-info/INSTALLER b/llm/Lib/site-packages/certifi-2024.2.2.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/certifi-2024.2.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/certifi-2024.2.2.dist-info/LICENSE b/llm/Lib/site-packages/certifi-2024.2.2.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..62b076cdee58ec8f34034141ba0befd9015b0c7e
--- /dev/null
+++ b/llm/Lib/site-packages/certifi-2024.2.2.dist-info/LICENSE
@@ -0,0 +1,20 @@
+This package contains a modified version of ca-bundle.crt:
+
+ca-bundle.crt -- Bundle of CA Root Certificates
+
+This is a bundle of X.509 certificates of public Certificate Authorities
+(CA). These were automatically extracted from Mozilla's root certificates
+file (certdata.txt).  This file can be found in the mozilla source tree:
+https://hg.mozilla.org/mozilla-central/file/tip/security/nss/lib/ckfw/builtins/certdata.txt
+It contains the certificates in PEM format and therefore
+can be directly used with curl / libcurl / php_curl, or with
+an Apache+mod_ssl webserver for SSL client authentication.
+Just configure this file as the SSLCACertificateFile.#
+
+***** BEGIN LICENSE BLOCK *****
+This Source Code Form is subject to the terms of the Mozilla Public License,
+v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain
+one at http://mozilla.org/MPL/2.0/.
+
+***** END LICENSE BLOCK *****
+@(#) $RCSfile: certdata.txt,v $ $Revision: 1.80 $ $Date: 2011/11/03 15:11:58 $
diff --git a/llm/Lib/site-packages/certifi-2024.2.2.dist-info/METADATA b/llm/Lib/site-packages/certifi-2024.2.2.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..c688a62848560861b62738ef0b70d373c4980baf
--- /dev/null
+++ b/llm/Lib/site-packages/certifi-2024.2.2.dist-info/METADATA
@@ -0,0 +1,66 @@
+Metadata-Version: 2.1
+Name: certifi
+Version: 2024.2.2
+Summary: Python package for providing Mozilla's CA Bundle.
+Home-page: https://github.com/certifi/python-certifi
+Author: Kenneth Reitz
+Author-email: me@kennethreitz.com
+License: MPL-2.0
+Project-URL: Source, https://github.com/certifi/python-certifi
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.6
+License-File: LICENSE
+
+Certifi: Python SSL Certificates
+================================
+
+Certifi provides Mozilla's carefully curated collection of Root Certificates for
+validating the trustworthiness of SSL certificates while verifying the identity
+of TLS hosts. It has been extracted from the `Requests`_ project.
+
+Installation
+------------
+
+``certifi`` is available on PyPI. Simply install it with ``pip``::
+
+    $ pip install certifi
+
+Usage
+-----
+
+To reference the installed certificate authority (CA) bundle, you can use the
+built-in function::
+
+    >>> import certifi
+
+    >>> certifi.where()
+    '/usr/local/lib/python3.7/site-packages/certifi/cacert.pem'
+
+Or from the command line::
+
+    $ python -m certifi
+    /usr/local/lib/python3.7/site-packages/certifi/cacert.pem
+
+Enjoy!
+
+.. _`Requests`: https://requests.readthedocs.io/en/master/
+
+Addition/Removal of Certificates
+--------------------------------
+
+Certifi does not support any addition/removal or other modification of the
+CA trust store content. This project is intended to provide a reliable and
+highly portable root of trust to python deployments. Look to upstream projects
+for methods to use alternate trust.
diff --git a/llm/Lib/site-packages/certifi-2024.2.2.dist-info/RECORD b/llm/Lib/site-packages/certifi-2024.2.2.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..716f0bbb4cfb2e96d225ef68711386fab8d65fa9
--- /dev/null
+++ b/llm/Lib/site-packages/certifi-2024.2.2.dist-info/RECORD
@@ -0,0 +1,14 @@
+certifi-2024.2.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+certifi-2024.2.2.dist-info/LICENSE,sha256=6TcW2mucDVpKHfYP5pWzcPBpVgPSH2-D8FPkLPwQyvc,989
+certifi-2024.2.2.dist-info/METADATA,sha256=1noreLRChpOgeSj0uJT1mehiBl8ngh33Guc7KdvzYYM,2170
+certifi-2024.2.2.dist-info/RECORD,,
+certifi-2024.2.2.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+certifi-2024.2.2.dist-info/top_level.txt,sha256=KMu4vUCfsjLrkPbSNdgdekS-pVJzBAJFO__nI8NF6-U,8
+certifi/__init__.py,sha256=ljtEx-EmmPpTe2SOd5Kzsujm_lUD0fKJVnE9gzce320,94
+certifi/__main__.py,sha256=xBBoj905TUWBLRGANOcf7oi6e-3dMP4cEoG9OyMs11g,243
+certifi/__pycache__/__init__.cpython-311.pyc,,
+certifi/__pycache__/__main__.cpython-311.pyc,,
+certifi/__pycache__/core.cpython-311.pyc,,
+certifi/cacert.pem,sha256=ejR8qP724p-CtuR4U1WmY1wX-nVeCUD2XxWqj8e9f5I,292541
+certifi/core.py,sha256=qRDDFyXVJwTB_EmoGppaXU_R9qCZvhl-EzxPMuV3nTA,4426
+certifi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
diff --git a/llm/Lib/site-packages/certifi-2024.2.2.dist-info/WHEEL b/llm/Lib/site-packages/certifi-2024.2.2.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..98c0d20b7a64f4f998d7913e1d38a05dba20916c
--- /dev/null
+++ b/llm/Lib/site-packages/certifi-2024.2.2.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.42.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/certifi-2024.2.2.dist-info/top_level.txt b/llm/Lib/site-packages/certifi-2024.2.2.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..963eac530b9bc28d704d1bc410299c68e3216d4d
--- /dev/null
+++ b/llm/Lib/site-packages/certifi-2024.2.2.dist-info/top_level.txt
@@ -0,0 +1 @@
+certifi
diff --git a/llm/Lib/site-packages/certifi/__init__.py b/llm/Lib/site-packages/certifi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1c91f3ec932d465dece996df658b92880772a077
--- /dev/null
+++ b/llm/Lib/site-packages/certifi/__init__.py
@@ -0,0 +1,4 @@
+from .core import contents, where
+
+__all__ = ["contents", "where"]
+__version__ = "2024.02.02"
diff --git a/llm/Lib/site-packages/certifi/__main__.py b/llm/Lib/site-packages/certifi/__main__.py
new file mode 100644
index 0000000000000000000000000000000000000000..8945b5da857f4a7dec2b84f1225f012f6098418c
--- /dev/null
+++ b/llm/Lib/site-packages/certifi/__main__.py
@@ -0,0 +1,12 @@
+import argparse
+
+from certifi import contents, where
+
+parser = argparse.ArgumentParser()
+parser.add_argument("-c", "--contents", action="store_true")
+args = parser.parse_args()
+
+if args.contents:
+    print(contents())
+else:
+    print(where())
diff --git a/llm/Lib/site-packages/certifi/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/certifi/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b227c6ca737c5dfd7476d34d775c134635023f0f
Binary files /dev/null and b/llm/Lib/site-packages/certifi/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/certifi/__pycache__/__main__.cpython-311.pyc b/llm/Lib/site-packages/certifi/__pycache__/__main__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..27f13b8ccae20c82c48335fe5b1a8be05503f8cf
Binary files /dev/null and b/llm/Lib/site-packages/certifi/__pycache__/__main__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/certifi/__pycache__/core.cpython-311.pyc b/llm/Lib/site-packages/certifi/__pycache__/core.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bb7496dbffd5f368d8543625132ba43c448d6885
Binary files /dev/null and b/llm/Lib/site-packages/certifi/__pycache__/core.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/certifi/cacert.pem b/llm/Lib/site-packages/certifi/cacert.pem
new file mode 100644
index 0000000000000000000000000000000000000000..fac3c31909bf46d527df7c89352e2a4e9d31c906
--- /dev/null
+++ b/llm/Lib/site-packages/certifi/cacert.pem
@@ -0,0 +1,4814 @@
+
+# Issuer: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA
+# Subject: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA
+# Label: "GlobalSign Root CA"
+# Serial: 4835703278459707669005204
+# MD5 Fingerprint: 3e:45:52:15:09:51:92:e1:b7:5d:37:9f:b1:87:29:8a
+# SHA1 Fingerprint: b1:bc:96:8b:d4:f4:9d:62:2a:a8:9a:81:f2:15:01:52:a4:1d:82:9c
+# SHA256 Fingerprint: eb:d4:10:40:e4:bb:3e:c7:42:c9:e3:81:d3:1e:f2:a4:1a:48:b6:68:5c:96:e7:ce:f3:c1:df:6c:d4:33:1c:99
+-----BEGIN CERTIFICATE-----
+MIIDdTCCAl2gAwIBAgILBAAAAAABFUtaw5QwDQYJKoZIhvcNAQEFBQAwVzELMAkG
+A1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExEDAOBgNVBAsTB1Jv
+b3QgQ0ExGzAZBgNVBAMTEkdsb2JhbFNpZ24gUm9vdCBDQTAeFw05ODA5MDExMjAw
+MDBaFw0yODAxMjgxMjAwMDBaMFcxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9i
+YWxTaWduIG52LXNhMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJHbG9iYWxT
+aWduIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDaDuaZ
+jc6j40+Kfvvxi4Mla+pIH/EqsLmVEQS98GPR4mdmzxzdzxtIK+6NiY6arymAZavp
+xy0Sy6scTHAHoT0KMM0VjU/43dSMUBUc71DuxC73/OlS8pF94G3VNTCOXkNz8kHp
+1Wrjsok6Vjk4bwY8iGlbKk3Fp1S4bInMm/k8yuX9ifUSPJJ4ltbcdG6TRGHRjcdG
+snUOhugZitVtbNV4FpWi6cgKOOvyJBNPc1STE4U6G7weNLWLBYy5d4ux2x8gkasJ
+U26Qzns3dLlwR5EiUWMWea6xrkEmCMgZK9FGqkjWZCrXgzT/LCrBbBlDSgeF59N8
+9iFo7+ryUp9/k5DPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8E
+BTADAQH/MB0GA1UdDgQWBBRge2YaRQ2XyolQL30EzTSo//z9SzANBgkqhkiG9w0B
+AQUFAAOCAQEA1nPnfE920I2/7LqivjTFKDK1fPxsnCwrvQmeU79rXqoRSLblCKOz
+yj1hTdNGCbM+w6DjY1Ub8rrvrTnhQ7k4o+YviiY776BQVvnGCv04zcQLcFGUl5gE
+38NflNUVyRRBnMRddWQVDf9VMOyGj/8N7yy5Y0b2qvzfvGn9LhJIZJrglfCm7ymP
+AbEVtQwdpf5pLGkkeB6zpxxxYu7KyJesF12KwvhHhm4qxFYxldBniYUr+WymXUad
+DKqC5JlR3XC321Y9YeRq4VzW9v493kHMB65jUr9TU/Qr6cf9tveCX4XSQRjbgbME
+HMUfpIBvFSDJ3gyICh3WZlXi/EjJKSZp4A==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited
+# Subject: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited
+# Label: "Entrust.net Premium 2048 Secure Server CA"
+# Serial: 946069240
+# MD5 Fingerprint: ee:29:31:bc:32:7e:9a:e6:e8:b5:f7:51:b4:34:71:90
+# SHA1 Fingerprint: 50:30:06:09:1d:97:d4:f5:ae:39:f7:cb:e7:92:7d:7d:65:2d:34:31
+# SHA256 Fingerprint: 6d:c4:71:72:e0:1c:bc:b0:bf:62:58:0d:89:5f:e2:b8:ac:9a:d4:f8:73:80:1e:0c:10:b9:c8:37:d2:1e:b1:77
+-----BEGIN CERTIFICATE-----
+MIIEKjCCAxKgAwIBAgIEOGPe+DANBgkqhkiG9w0BAQUFADCBtDEUMBIGA1UEChML
+RW50cnVzdC5uZXQxQDA+BgNVBAsUN3d3dy5lbnRydXN0Lm5ldC9DUFNfMjA0OCBp
+bmNvcnAuIGJ5IHJlZi4gKGxpbWl0cyBsaWFiLikxJTAjBgNVBAsTHChjKSAxOTk5
+IEVudHJ1c3QubmV0IExpbWl0ZWQxMzAxBgNVBAMTKkVudHJ1c3QubmV0IENlcnRp
+ZmljYXRpb24gQXV0aG9yaXR5ICgyMDQ4KTAeFw05OTEyMjQxNzUwNTFaFw0yOTA3
+MjQxNDE1MTJaMIG0MRQwEgYDVQQKEwtFbnRydXN0Lm5ldDFAMD4GA1UECxQ3d3d3
+LmVudHJ1c3QubmV0L0NQU18yMDQ4IGluY29ycC4gYnkgcmVmLiAobGltaXRzIGxp
+YWIuKTElMCMGA1UECxMcKGMpIDE5OTkgRW50cnVzdC5uZXQgTGltaXRlZDEzMDEG
+A1UEAxMqRW50cnVzdC5uZXQgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgKDIwNDgp
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArU1LqRKGsuqjIAcVFmQq
+K0vRvwtKTY7tgHalZ7d4QMBzQshowNtTK91euHaYNZOLGp18EzoOH1u3Hs/lJBQe
+sYGpjX24zGtLA/ECDNyrpUAkAH90lKGdCCmziAv1h3edVc3kw37XamSrhRSGlVuX
+MlBvPci6Zgzj/L24ScF2iUkZ/cCovYmjZy/Gn7xxGWC4LeksyZB2ZnuU4q941mVT
+XTzWnLLPKQP5L6RQstRIzgUyVYr9smRMDuSYB3Xbf9+5CFVghTAp+XtIpGmG4zU/
+HoZdenoVve8AjhUiVBcAkCaTvA5JaJG/+EfTnZVCwQ5N328mz8MYIWJmQ3DW1cAH
+4QIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
+HQ4EFgQUVeSB0RGAvtiJuQijMfmhJAkWuXAwDQYJKoZIhvcNAQEFBQADggEBADub
+j1abMOdTmXx6eadNl9cZlZD7Bh/KM3xGY4+WZiT6QBshJ8rmcnPyT/4xmf3IDExo
+U8aAghOY+rat2l098c5u9hURlIIM7j+VrxGrD9cv3h8Dj1csHsm7mhpElesYT6Yf
+zX1XEC+bBAlahLVu2B064dae0Wx5XnkcFMXj0EyTO2U87d89vqbllRrDtRnDvV5b
+u/8j72gZyxKTJ1wDLW8w0B62GqzeWvfRqqgnpv55gcR5mTNXuhKwqeBCbJPKVt7+
+bYQLCIt+jerXmCHG8+c8eS9enNFMFY3h7CI3zJpDC5fcgJCNs2ebb0gIFVbPv/Er
+fF6adulZkMV8gzURZVE=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust
+# Subject: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust
+# Label: "Baltimore CyberTrust Root"
+# Serial: 33554617
+# MD5 Fingerprint: ac:b6:94:a5:9c:17:e0:d7:91:52:9b:b1:97:06:a6:e4
+# SHA1 Fingerprint: d4:de:20:d0:5e:66:fc:53:fe:1a:50:88:2c:78:db:28:52:ca:e4:74
+# SHA256 Fingerprint: 16:af:57:a9:f6:76:b0:ab:12:60:95:aa:5e:ba:de:f2:2a:b3:11:19:d6:44:ac:95:cd:4b:93:db:f3:f2:6a:eb
+-----BEGIN CERTIFICATE-----
+MIIDdzCCAl+gAwIBAgIEAgAAuTANBgkqhkiG9w0BAQUFADBaMQswCQYDVQQGEwJJ
+RTESMBAGA1UEChMJQmFsdGltb3JlMRMwEQYDVQQLEwpDeWJlclRydXN0MSIwIAYD
+VQQDExlCYWx0aW1vcmUgQ3liZXJUcnVzdCBSb290MB4XDTAwMDUxMjE4NDYwMFoX
+DTI1MDUxMjIzNTkwMFowWjELMAkGA1UEBhMCSUUxEjAQBgNVBAoTCUJhbHRpbW9y
+ZTETMBEGA1UECxMKQ3liZXJUcnVzdDEiMCAGA1UEAxMZQmFsdGltb3JlIEN5YmVy
+VHJ1c3QgUm9vdDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKMEuyKr
+mD1X6CZymrV51Cni4eiVgLGw41uOKymaZN+hXe2wCQVt2yguzmKiYv60iNoS6zjr
+IZ3AQSsBUnuId9Mcj8e6uYi1agnnc+gRQKfRzMpijS3ljwumUNKoUMMo6vWrJYeK
+mpYcqWe4PwzV9/lSEy/CG9VwcPCPwBLKBsua4dnKM3p31vjsufFoREJIE9LAwqSu
+XmD+tqYF/LTdB1kC1FkYmGP1pWPgkAx9XbIGevOF6uvUA65ehD5f/xXtabz5OTZy
+dc93Uk3zyZAsuT3lySNTPx8kmCFcB5kpvcY67Oduhjprl3RjM71oGDHweI12v/ye
+jl0qhqdNkNwnGjkCAwEAAaNFMEMwHQYDVR0OBBYEFOWdWTCCR1jMrPoIVDaGezq1
+BE3wMBIGA1UdEwEB/wQIMAYBAf8CAQMwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3
+DQEBBQUAA4IBAQCFDF2O5G9RaEIFoN27TyclhAO992T9Ldcw46QQF+vaKSm2eT92
+9hkTI7gQCvlYpNRhcL0EYWoSihfVCr3FvDB81ukMJY2GQE/szKN+OMY3EU/t3Wgx
+jkzSswF07r51XgdIGn9w/xZchMB5hbgF/X++ZRGjD8ACtPhSNzkE1akxehi/oCr0
+Epn3o0WC4zxe9Z2etciefC7IpJ5OCBRLbf1wbWsaY71k5h+3zvDyny67G7fyUIhz
+ksLi4xaNmjICq44Y3ekQEe5+NauQrz4wlHrQMz2nZQ/1/I6eYs9HRCwBXbsdtTLS
+R9I4LtD+gdwyah617jzV/OeBHRnDJELqYzmp
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc.
+# Subject: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc.
+# Label: "Entrust Root Certification Authority"
+# Serial: 1164660820
+# MD5 Fingerprint: d6:a5:c3:ed:5d:dd:3e:00:c1:3d:87:92:1f:1d:3f:e4
+# SHA1 Fingerprint: b3:1e:b1:b7:40:e3:6c:84:02:da:dc:37:d4:4d:f5:d4:67:49:52:f9
+# SHA256 Fingerprint: 73:c1:76:43:4f:1b:c6:d5:ad:f4:5b:0e:76:e7:27:28:7c:8d:e5:76:16:c1:e6:e6:14:1a:2b:2c:bc:7d:8e:4c
+-----BEGIN CERTIFICATE-----
+MIIEkTCCA3mgAwIBAgIERWtQVDANBgkqhkiG9w0BAQUFADCBsDELMAkGA1UEBhMC
+VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xOTA3BgNVBAsTMHd3dy5lbnRydXN0
+Lm5ldC9DUFMgaXMgaW5jb3Jwb3JhdGVkIGJ5IHJlZmVyZW5jZTEfMB0GA1UECxMW
+KGMpIDIwMDYgRW50cnVzdCwgSW5jLjEtMCsGA1UEAxMkRW50cnVzdCBSb290IENl
+cnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA2MTEyNzIwMjM0MloXDTI2MTEyNzIw
+NTM0MlowgbAxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMTkw
+NwYDVQQLEzB3d3cuZW50cnVzdC5uZXQvQ1BTIGlzIGluY29ycG9yYXRlZCBieSBy
+ZWZlcmVuY2UxHzAdBgNVBAsTFihjKSAyMDA2IEVudHJ1c3QsIEluYy4xLTArBgNV
+BAMTJEVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASIwDQYJ
+KoZIhvcNAQEBBQADggEPADCCAQoCggEBALaVtkNC+sZtKm9I35RMOVcF7sN5EUFo
+Nu3s/poBj6E4KPz3EEZmLk0eGrEaTsbRwJWIsMn/MYszA9u3g3s+IIRe7bJWKKf4
+4LlAcTfFy0cOlypowCKVYhXbR9n10Cv/gkvJrT7eTNuQgFA/CYqEAOwwCj0Yzfv9
+KlmaI5UXLEWeH25DeW0MXJj+SKfFI0dcXv1u5x609mhF0YaDW6KKjbHjKYD+JXGI
+rb68j6xSlkuqUY3kEzEZ6E5Nn9uss2rVvDlUccp6en+Q3X0dgNmBu1kmwhH+5pPi
+94DkZfs0Nw4pgHBNrziGLp5/V6+eF67rHMsoIV+2HNjnogQi+dPa2MsCAwEAAaOB
+sDCBrTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zArBgNVHRAEJDAi
+gA8yMDA2MTEyNzIwMjM0MlqBDzIwMjYxMTI3MjA1MzQyWjAfBgNVHSMEGDAWgBRo
+kORnpKZTgMeGZqTx90tD+4S9bTAdBgNVHQ4EFgQUaJDkZ6SmU4DHhmak8fdLQ/uE
+vW0wHQYJKoZIhvZ9B0EABBAwDhsIVjcuMTo0LjADAgSQMA0GCSqGSIb3DQEBBQUA
+A4IBAQCT1DCw1wMgKtD5Y+iRDAUgqV8ZyntyTtSx29CW+1RaGSwMCPeyvIWonX9t
+O1KzKtvn1ISMY/YPyyYBkVBs9F8U4pN0wBOeMDpQ47RgxRzwIkSNcUesyBrJ6Zua
+AGAT/3B+XxFNSRuzFVJ7yVTav52Vr2ua2J7p8eRDjeIRRDq/r72DQnNSi6q7pynP
+9WQcCk3RvKqsnyrQ/39/2n3qse0wJcGE2jTSW3iDVuycNsMm4hH2Z0kdkquM++v/
+eu6FSqdQgPCnXEqULl8FmTxSQeDNtGPPAUO6nIPcj2A781q0tHuu2guQOHXvgR1m
+0vdXcDazv/wor3ElhVsT/h5/WrQ8
+-----END CERTIFICATE-----
+
+# Issuer: CN=AAA Certificate Services O=Comodo CA Limited
+# Subject: CN=AAA Certificate Services O=Comodo CA Limited
+# Label: "Comodo AAA Services root"
+# Serial: 1
+# MD5 Fingerprint: 49:79:04:b0:eb:87:19:ac:47:b0:bc:11:51:9b:74:d0
+# SHA1 Fingerprint: d1:eb:23:a4:6d:17:d6:8f:d9:25:64:c2:f1:f1:60:17:64:d8:e3:49
+# SHA256 Fingerprint: d7:a7:a0:fb:5d:7e:27:31:d7:71:e9:48:4e:bc:de:f7:1d:5f:0c:3e:0a:29:48:78:2b:c8:3e:e0:ea:69:9e:f4
+-----BEGIN CERTIFICATE-----
+MIIEMjCCAxqgAwIBAgIBATANBgkqhkiG9w0BAQUFADB7MQswCQYDVQQGEwJHQjEb
+MBkGA1UECAwSR3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHDAdTYWxmb3JkMRow
+GAYDVQQKDBFDb21vZG8gQ0EgTGltaXRlZDEhMB8GA1UEAwwYQUFBIENlcnRpZmlj
+YXRlIFNlcnZpY2VzMB4XDTA0MDEwMTAwMDAwMFoXDTI4MTIzMTIzNTk1OVowezEL
+MAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE
+BwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQxITAfBgNVBAMM
+GEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczCCASIwDQYJKoZIhvcNAQEBBQADggEP
+ADCCAQoCggEBAL5AnfRu4ep2hxxNRUSOvkbIgwadwSr+GB+O5AL686tdUIoWMQua
+BtDFcCLNSS1UY8y2bmhGC1Pqy0wkwLxyTurxFa70VJoSCsN6sjNg4tqJVfMiWPPe
+3M/vg4aijJRPn2jymJBGhCfHdr/jzDUsi14HZGWCwEiwqJH5YZ92IFCokcdmtet4
+YgNW8IoaE+oxox6gmf049vYnMlhvB/VruPsUK6+3qszWY19zjNoFmag4qMsXeDZR
+rOme9Hg6jc8P2ULimAyrL58OAd7vn5lJ8S3frHRNG5i1R8XlKdH5kBjHYpy+g8cm
+ez6KJcfA3Z3mNWgQIJ2P2N7Sw4ScDV7oL8kCAwEAAaOBwDCBvTAdBgNVHQ4EFgQU
+oBEKIz6W8Qfs4q8p74Klf9AwpLQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQF
+MAMBAf8wewYDVR0fBHQwcjA4oDagNIYyaHR0cDovL2NybC5jb21vZG9jYS5jb20v
+QUFBQ2VydGlmaWNhdGVTZXJ2aWNlcy5jcmwwNqA0oDKGMGh0dHA6Ly9jcmwuY29t
+b2RvLm5ldC9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2VzLmNybDANBgkqhkiG9w0BAQUF
+AAOCAQEACFb8AvCb6P+k+tZ7xkSAzk/ExfYAWMymtrwUSWgEdujm7l3sAg9g1o1Q
+GE8mTgHj5rCl7r+8dFRBv/38ErjHT1r0iWAFf2C3BUrz9vHCv8S5dIa2LX1rzNLz
+Rt0vxuBqw8M0Ayx9lt1awg6nCpnBBYurDC/zXDrPbDdVCYfeU0BsWO/8tqtlbgT2
+G9w84FoVxp7Z8VlIMCFlA2zs6SFz7JsDoeA3raAVGI/6ugLOpyypEBMs1OUIJqsi
+l2D4kF501KKaU73yqWjgom7C12yxow+ev+to51byrvLjKzg6CYG1a4XXvi3tPxq3
+smPi9WIsgtRqAEFQ8TmDn5XpNpaYbg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 2 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 2 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 2"
+# Serial: 1289
+# MD5 Fingerprint: 5e:39:7b:dd:f8:ba:ec:82:e9:ac:62:ba:0c:54:00:2b
+# SHA1 Fingerprint: ca:3a:fb:cf:12:40:36:4b:44:b2:16:20:88:80:48:39:19:93:7c:f7
+# SHA256 Fingerprint: 85:a0:dd:7d:d7:20:ad:b7:ff:05:f8:3d:54:2b:20:9d:c7:ff:45:28:f7:d6:77:b1:83:89:fe:a5:e5:c4:9e:86
+-----BEGIN CERTIFICATE-----
+MIIFtzCCA5+gAwIBAgICBQkwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x
+GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv
+b3QgQ0EgMjAeFw0wNjExMjQxODI3MDBaFw0zMTExMjQxODIzMzNaMEUxCzAJBgNV
+BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W
+YWRpcyBSb290IENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCa
+GMpLlA0ALa8DKYrwD4HIrkwZhR0In6spRIXzL4GtMh6QRr+jhiYaHv5+HBg6XJxg
+Fyo6dIMzMH1hVBHL7avg5tKifvVrbxi3Cgst/ek+7wrGsxDp3MJGF/hd/aTa/55J
+WpzmM+Yklvc/ulsrHHo1wtZn/qtmUIttKGAr79dgw8eTvI02kfN/+NsRE8Scd3bB
+rrcCaoF6qUWD4gXmuVbBlDePSHFjIuwXZQeVikvfj8ZaCuWw419eaxGrDPmF60Tp
++ARz8un+XJiM9XOva7R+zdRcAitMOeGylZUtQofX1bOQQ7dsE/He3fbE+Ik/0XX1
+ksOR1YqI0JDs3G3eicJlcZaLDQP9nL9bFqyS2+r+eXyt66/3FsvbzSUr5R/7mp/i
+Ucw6UwxI5g69ybR2BlLmEROFcmMDBOAENisgGQLodKcftslWZvB1JdxnwQ5hYIiz
+PtGo/KPaHbDRsSNU30R2be1B2MGyIrZTHN81Hdyhdyox5C315eXbyOD/5YDXC2Og
+/zOhD7osFRXql7PSorW+8oyWHhqPHWykYTe5hnMz15eWniN9gqRMgeKh0bpnX5UH
+oycR7hYQe7xFSkyyBNKr79X9DFHOUGoIMfmR2gyPZFwDwzqLID9ujWc9Otb+fVuI
+yV77zGHcizN300QyNQliBJIWENieJ0f7OyHj+OsdWwIDAQABo4GwMIGtMA8GA1Ud
+EwEB/wQFMAMBAf8wCwYDVR0PBAQDAgEGMB0GA1UdDgQWBBQahGK8SEwzJQTU7tD2
+A8QZRtGUazBuBgNVHSMEZzBlgBQahGK8SEwzJQTU7tD2A8QZRtGUa6FJpEcwRTEL
+MAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMT
+ElF1b1ZhZGlzIFJvb3QgQ0EgMoICBQkwDQYJKoZIhvcNAQEFBQADggIBAD4KFk2f
+BluornFdLwUvZ+YTRYPENvbzwCYMDbVHZF34tHLJRqUDGCdViXh9duqWNIAXINzn
+g/iN/Ae42l9NLmeyhP3ZRPx3UIHmfLTJDQtyU/h2BwdBR5YM++CCJpNVjP4iH2Bl
+fF/nJrP3MpCYUNQ3cVX2kiF495V5+vgtJodmVjB3pjd4M1IQWK4/YY7yarHvGH5K
+WWPKjaJW1acvvFYfzznB4vsKqBUsfU16Y8Zsl0Q80m/DShcK+JDSV6IZUaUtl0Ha
+B0+pUNqQjZRG4T7wlP0QADj1O+hA4bRuVhogzG9Yje0uRY/W6ZM/57Es3zrWIozc
+hLsib9D45MY56QSIPMO661V6bYCZJPVsAfv4l7CUW+v90m/xd2gNNWQjrLhVoQPR
+TUIZ3Ph1WVaj+ahJefivDrkRoHy3au000LYmYjgahwz46P0u05B/B5EqHdZ+XIWD
+mbA4CD/pXvk1B+TJYm5Xf6dQlfe6yJvmjqIBxdZmv3lh8zwc4bmCXF2gw+nYSL0Z
+ohEUGW6yhhtoPkg3Goi3XZZenMfvJ2II4pEZXNLxId26F0KCl3GBUzGpn/Z9Yr9y
+4aOTHcyKJloJONDO1w2AFrR4pTqHTI2KpdVGl/IsELm8VCLAAVBpQ570su9t+Oza
+8eOx79+Rj1QqCyXBJhnEUhAFZdWCEOrCMc0u
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 3 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 3 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 3"
+# Serial: 1478
+# MD5 Fingerprint: 31:85:3c:62:94:97:63:b9:aa:fd:89:4e:af:6f:e0:cf
+# SHA1 Fingerprint: 1f:49:14:f7:d8:74:95:1d:dd:ae:02:c0:be:fd:3a:2d:82:75:51:85
+# SHA256 Fingerprint: 18:f1:fc:7f:20:5d:f8:ad:dd:eb:7f:e0:07:dd:57:e3:af:37:5a:9c:4d:8d:73:54:6b:f4:f1:fe:d1:e1:8d:35
+-----BEGIN CERTIFICATE-----
+MIIGnTCCBIWgAwIBAgICBcYwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x
+GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv
+b3QgQ0EgMzAeFw0wNjExMjQxOTExMjNaFw0zMTExMjQxOTA2NDRaMEUxCzAJBgNV
+BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W
+YWRpcyBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDM
+V0IWVJzmmNPTTe7+7cefQzlKZbPoFog02w1ZkXTPkrgEQK0CSzGrvI2RaNggDhoB
+4hp7Thdd4oq3P5kazethq8Jlph+3t723j/z9cI8LoGe+AaJZz3HmDyl2/7FWeUUr
+H556VOijKTVopAFPD6QuN+8bv+OPEKhyq1hX51SGyMnzW9os2l2ObjyjPtr7guXd
+8lyyBTNvijbO0BNO/79KDDRMpsMhvVAEVeuxu537RR5kFd5VAYwCdrXLoT9Cabwv
+vWhDFlaJKjdhkf2mrk7AyxRllDdLkgbvBNDInIjbC3uBr7E9KsRlOni27tyAsdLT
+mZw67mtaa7ONt9XOnMK+pUsvFrGeaDsGb659n/je7Mwpp5ijJUMv7/FfJuGITfhe
+btfZFG4ZM2mnO4SJk8RTVROhUXhA+LjJou57ulJCg54U7QVSWllWp5f8nT8KKdjc
+T5EOE7zelaTfi5m+rJsziO+1ga8bxiJTyPbH7pcUsMV8eFLI8M5ud2CEpukqdiDt
+WAEXMJPpGovgc2PZapKUSU60rUqFxKMiMPwJ7Wgic6aIDFUhWMXhOp8q3crhkODZ
+c6tsgLjoC2SToJyMGf+z0gzskSaHirOi4XCPLArlzW1oUevaPwV/izLmE1xr/l9A
+4iLItLRkT9a6fUg+qGkM17uGcclzuD87nSVL2v9A6wIDAQABo4IBlTCCAZEwDwYD
+VR0TAQH/BAUwAwEB/zCB4QYDVR0gBIHZMIHWMIHTBgkrBgEEAb5YAAMwgcUwgZMG
+CCsGAQUFBwICMIGGGoGDQW55IHVzZSBvZiB0aGlzIENlcnRpZmljYXRlIGNvbnN0
+aXR1dGVzIGFjY2VwdGFuY2Ugb2YgdGhlIFF1b1ZhZGlzIFJvb3QgQ0EgMyBDZXJ0
+aWZpY2F0ZSBQb2xpY3kgLyBDZXJ0aWZpY2F0aW9uIFByYWN0aWNlIFN0YXRlbWVu
+dC4wLQYIKwYBBQUHAgEWIWh0dHA6Ly93d3cucXVvdmFkaXNnbG9iYWwuY29tL2Nw
+czALBgNVHQ8EBAMCAQYwHQYDVR0OBBYEFPLAE+CCQz777i9nMpY1XNu4ywLQMG4G
+A1UdIwRnMGWAFPLAE+CCQz777i9nMpY1XNu4ywLQoUmkRzBFMQswCQYDVQQGEwJC
+TTEZMBcGA1UEChMQUXVvVmFkaXMgTGltaXRlZDEbMBkGA1UEAxMSUXVvVmFkaXMg
+Um9vdCBDQSAzggIFxjANBgkqhkiG9w0BAQUFAAOCAgEAT62gLEz6wPJv92ZVqyM0
+7ucp2sNbtrCD2dDQ4iH782CnO11gUyeim/YIIirnv6By5ZwkajGxkHon24QRiSem
+d1o417+shvzuXYO8BsbRd2sPbSQvS3pspweWyuOEn62Iix2rFo1bZhfZFvSLgNLd
++LJ2w/w4E6oM3kJpK27zPOuAJ9v1pkQNn1pVWQvVDVJIxa6f8i+AxeoyUDUSly7B
+4f/xI4hROJ/yZlZ25w9Rl6VSDE1JUZU2Pb+iSwwQHYaZTKrzchGT5Or2m9qoXadN
+t54CrnMAyNojA+j56hl0YgCUyyIgvpSnWbWCar6ZeXqp8kokUvd0/bpO5qgdAm6x
+DYBEwa7TIzdfu4V8K5Iu6H6li92Z4b8nby1dqnuH/grdS/yO9SbkbnBCbjPsMZ57
+k8HkyWkaPcBrTiJt7qtYTcbQQcEr6k8Sh17rRdhs9ZgC06DYVYoGmRmioHfRMJ6s
+zHXug/WwYjnPbFfiTNKRCw51KBuav/0aQ/HKd/s7j2G4aSgWQgRecCocIdiP4b0j
+Wy10QJLZYxkNc91pvGJHvOB0K7Lrfb5BG7XARsWhIstfTsEokt4YutUqKLsRixeT
+mJlglFwjz1onl14LBQaTNx47aTbrqZ5hHY8y2o4M1nQ+ewkk2gF3R8Q7zTSMmfXK
+4SVhM7JZG+Ju1zdXtg2pEto=
+-----END CERTIFICATE-----
+
+# Issuer: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com
+# Subject: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com
+# Label: "XRamp Global CA Root"
+# Serial: 107108908803651509692980124233745014957
+# MD5 Fingerprint: a1:0b:44:b3:ca:10:d8:00:6e:9d:0f:d8:0f:92:0a:d1
+# SHA1 Fingerprint: b8:01:86:d1:eb:9c:86:a5:41:04:cf:30:54:f3:4c:52:b7:e5:58:c6
+# SHA256 Fingerprint: ce:cd:dc:90:50:99:d8:da:df:c5:b1:d2:09:b7:37:cb:e2:c1:8c:fb:2c:10:c0:ff:0b:cf:0d:32:86:fc:1a:a2
+-----BEGIN CERTIFICATE-----
+MIIEMDCCAxigAwIBAgIQUJRs7Bjq1ZxN1ZfvdY+grTANBgkqhkiG9w0BAQUFADCB
+gjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3dy54cmFtcHNlY3VyaXR5LmNvbTEk
+MCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2VydmljZXMgSW5jMS0wKwYDVQQDEyRY
+UmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQxMTAxMTcx
+NDA0WhcNMzUwMTAxMDUzNzE5WjCBgjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3
+dy54cmFtcHNlY3VyaXR5LmNvbTEkMCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2Vy
+dmljZXMgSW5jMS0wKwYDVQQDEyRYUmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBB
+dXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCYJB69FbS6
+38eMpSe2OAtp87ZOqCwuIR1cRN8hXX4jdP5efrRKt6atH67gBhbim1vZZ3RrXYCP
+KZ2GG9mcDZhtdhAoWORlsH9KmHmf4MMxfoArtYzAQDsRhtDLooY2YKTVMIJt2W7Q
+DxIEM5dfT2Fa8OT5kavnHTu86M/0ay00fOJIYRyO82FEzG+gSqmUsE3a56k0enI4
+qEHMPJQRfevIpoy3hsvKMzvZPTeL+3o+hiznc9cKV6xkmxnr9A8ECIqsAxcZZPRa
+JSKNNCyy9mgdEm3Tih4U2sSPpuIjhdV6Db1q4Ons7Be7QhtnqiXtRYMh/MHJfNVi
+PvryxS3T/dRlAgMBAAGjgZ8wgZwwEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0P
+BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMZPoj0GY4QJnM5i5ASs
+jVy16bYbMDYGA1UdHwQvMC0wK6ApoCeGJWh0dHA6Ly9jcmwueHJhbXBzZWN1cml0
+eS5jb20vWEdDQS5jcmwwEAYJKwYBBAGCNxUBBAMCAQEwDQYJKoZIhvcNAQEFBQAD
+ggEBAJEVOQMBG2f7Shz5CmBbodpNl2L5JFMn14JkTpAuw0kbK5rc/Kh4ZzXxHfAR
+vbdI4xD2Dd8/0sm2qlWkSLoC295ZLhVbO50WfUfXN+pfTXYSNrsf16GBBEYgoyxt
+qZ4Bfj8pzgCT3/3JknOJiWSe5yvkHJEs0rnOfc5vMZnT5r7SHpDwCRR5XCOrTdLa
+IR9NmXmd4c8nnxCbHIgNsIpkQTG4DmyQJKSbXHGPurt+HBvbaoAPIbzp26a3QPSy
+i6mx5O+aGtA9aZnuqCij4Tyz8LIRnM98QObd50N9otg6tamN8jSZxNQQ4Qb9CYQQ
+O+7ETPTsJ3xCwnR8gooJybQDJbw=
+-----END CERTIFICATE-----
+
+# Issuer: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority
+# Subject: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority
+# Label: "Go Daddy Class 2 CA"
+# Serial: 0
+# MD5 Fingerprint: 91:de:06:25:ab:da:fd:32:17:0c:bb:25:17:2a:84:67
+# SHA1 Fingerprint: 27:96:ba:e6:3f:18:01:e2:77:26:1b:a0:d7:77:70:02:8f:20:ee:e4
+# SHA256 Fingerprint: c3:84:6b:f2:4b:9e:93:ca:64:27:4c:0e:c6:7c:1e:cc:5e:02:4f:fc:ac:d2:d7:40:19:35:0e:81:fe:54:6a:e4
+-----BEGIN CERTIFICATE-----
+MIIEADCCAuigAwIBAgIBADANBgkqhkiG9w0BAQUFADBjMQswCQYDVQQGEwJVUzEh
+MB8GA1UEChMYVGhlIEdvIERhZGR5IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBE
+YWRkeSBDbGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA0MDYyOTE3
+MDYyMFoXDTM0MDYyOTE3MDYyMFowYzELMAkGA1UEBhMCVVMxITAfBgNVBAoTGFRo
+ZSBHbyBEYWRkeSBHcm91cCwgSW5jLjExMC8GA1UECxMoR28gRGFkZHkgQ2xhc3Mg
+MiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASAwDQYJKoZIhvcNAQEBBQADggEN
+ADCCAQgCggEBAN6d1+pXGEmhW+vXX0iG6r7d/+TvZxz0ZWizV3GgXne77ZtJ6XCA
+PVYYYwhv2vLM0D9/AlQiVBDYsoHUwHU9S3/Hd8M+eKsaA7Ugay9qK7HFiH7Eux6w
+wdhFJ2+qN1j3hybX2C32qRe3H3I2TqYXP2WYktsqbl2i/ojgC95/5Y0V4evLOtXi
+EqITLdiOr18SPaAIBQi2XKVlOARFmR6jYGB0xUGlcmIbYsUfb18aQr4CUWWoriMY
+avx4A6lNf4DD+qta/KFApMoZFv6yyO9ecw3ud72a9nmYvLEHZ6IVDd2gWMZEewo+
+YihfukEHU1jPEX44dMX4/7VpkI+EdOqXG68CAQOjgcAwgb0wHQYDVR0OBBYEFNLE
+sNKR1EwRcbNhyz2h/t2oatTjMIGNBgNVHSMEgYUwgYKAFNLEsNKR1EwRcbNhyz2h
+/t2oatTjoWekZTBjMQswCQYDVQQGEwJVUzEhMB8GA1UEChMYVGhlIEdvIERhZGR5
+IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBEYWRkeSBDbGFzcyAyIENlcnRpZmlj
+YXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQAD
+ggEBADJL87LKPpH8EsahB4yOd6AzBhRckB4Y9wimPQoZ+YeAEW5p5JYXMP80kWNy
+OO7MHAGjHZQopDH2esRU1/blMVgDoszOYtuURXO1v0XJJLXVggKtI3lpjbi2Tc7P
+TMozI+gciKqdi0FuFskg5YmezTvacPd+mSYgFFQlq25zheabIZ0KbIIOqPjCDPoQ
+HmyW74cNxA9hi63ugyuV+I6ShHI56yDqg+2DzZduCLzrTia2cyvk0/ZM/iZx4mER
+dEr/VxqHD3VILs9RaRegAhJhldXRQLIQTO7ErBBDpqWeCtWVYpoNz4iCxTIM5Cuf
+ReYNnyicsbkqWletNw+vHX/bvZ8=
+-----END CERTIFICATE-----
+
+# Issuer: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority
+# Subject: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority
+# Label: "Starfield Class 2 CA"
+# Serial: 0
+# MD5 Fingerprint: 32:4a:4b:bb:c8:63:69:9b:be:74:9a:c6:dd:1d:46:24
+# SHA1 Fingerprint: ad:7e:1c:28:b0:64:ef:8f:60:03:40:20:14:c3:d0:e3:37:0e:b5:8a
+# SHA256 Fingerprint: 14:65:fa:20:53:97:b8:76:fa:a6:f0:a9:95:8e:55:90:e4:0f:cc:7f:aa:4f:b7:c2:c8:67:75:21:fb:5f:b6:58
+-----BEGIN CERTIFICATE-----
+MIIEDzCCAvegAwIBAgIBADANBgkqhkiG9w0BAQUFADBoMQswCQYDVQQGEwJVUzEl
+MCMGA1UEChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMp
+U3RhcmZpZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQw
+NjI5MTczOTE2WhcNMzQwNjI5MTczOTE2WjBoMQswCQYDVQQGEwJVUzElMCMGA1UE
+ChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMpU3RhcmZp
+ZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEgMA0GCSqGSIb3
+DQEBAQUAA4IBDQAwggEIAoIBAQC3Msj+6XGmBIWtDBFk385N78gDGIc/oav7PKaf
+8MOh2tTYbitTkPskpD6E8J7oX+zlJ0T1KKY/e97gKvDIr1MvnsoFAZMej2YcOadN
++lq2cwQlZut3f+dZxkqZJRRU6ybH838Z1TBwj6+wRir/resp7defqgSHo9T5iaU0
+X9tDkYI22WY8sbi5gv2cOj4QyDvvBmVmepsZGD3/cVE8MC5fvj13c7JdBmzDI1aa
+K4UmkhynArPkPw2vCHmCuDY96pzTNbO8acr1zJ3o/WSNF4Azbl5KXZnJHoe0nRrA
+1W4TNSNe35tfPe/W93bC6j67eA0cQmdrBNj41tpvi/JEoAGrAgEDo4HFMIHCMB0G
+A1UdDgQWBBS/X7fRzt0fhvRbVazc1xDCDqmI5zCBkgYDVR0jBIGKMIGHgBS/X7fR
+zt0fhvRbVazc1xDCDqmI56FspGowaDELMAkGA1UEBhMCVVMxJTAjBgNVBAoTHFN0
+YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAsTKVN0YXJmaWVsZCBD
+bGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8w
+DQYJKoZIhvcNAQEFBQADggEBAAWdP4id0ckaVaGsafPzWdqbAYcaT1epoXkJKtv3
+L7IezMdeatiDh6GX70k1PncGQVhiv45YuApnP+yz3SFmH8lU+nLMPUxA2IGvd56D
+eruix/U0F47ZEUD0/CwqTRV/p2JdLiXTAAsgGh1o+Re49L2L7ShZ3U0WixeDyLJl
+xy16paq8U4Zt3VekyvggQQto8PT7dL5WXXp59fkdheMtlb71cZBDzI0fmgAKhynp
+VSJYACPq4xJDKVtHCN2MQWplBqjlIapBtJUhlbl90TSrE9atvNziPTnNvT51cKEY
+WQPJIrSPnNVeKtelttQKbfi3QBFGmh95DmK/D5fs4C8fF5Q=
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Assured ID Root CA"
+# Serial: 17154717934120587862167794914071425081
+# MD5 Fingerprint: 87:ce:0b:7b:2a:0e:49:00:e1:58:71:9b:37:a8:93:72
+# SHA1 Fingerprint: 05:63:b8:63:0d:62:d7:5a:bb:c8:ab:1e:4b:df:b5:a8:99:b2:4d:43
+# SHA256 Fingerprint: 3e:90:99:b5:01:5e:8f:48:6c:00:bc:ea:9d:11:1e:e7:21:fa:ba:35:5a:89:bc:f1:df:69:56:1e:3d:c6:32:5c
+-----BEGIN CERTIFICATE-----
+MIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0BAQUFADBl
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv
+b3QgQ0EwHhcNMDYxMTEwMDAwMDAwWhcNMzExMTEwMDAwMDAwWjBlMQswCQYDVQQG
+EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl
+cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0EwggEi
+MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCtDhXO5EOAXLGH87dg+XESpa7c
+JpSIqvTO9SA5KFhgDPiA2qkVlTJhPLWxKISKityfCgyDF3qPkKyK53lTXDGEKvYP
+mDI2dsze3Tyoou9q+yHyUmHfnyDXH+Kx2f4YZNISW1/5WBg1vEfNoTb5a3/UsDg+
+wRvDjDPZ2C8Y/igPs6eD1sNuRMBhNZYW/lmci3Zt1/GiSw0r/wty2p5g0I6QNcZ4
+VYcgoc/lbQrISXwxmDNsIumH0DJaoroTghHtORedmTpyoeb6pNnVFzF1roV9Iq4/
+AUaG9ih5yLHa5FcXxH4cDrC0kqZWs72yl+2qp/C3xag/lRbQ/6GW6whfGHdPAgMB
+AAGjYzBhMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW
+BBRF66Kv9JLLgjEtUYunpyGd823IDzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYun
+pyGd823IDzANBgkqhkiG9w0BAQUFAAOCAQEAog683+Lt8ONyc3pklL/3cmbYMuRC
+dWKuh+vy1dneVrOfzM4UKLkNl2BcEkxY5NM9g0lFWJc1aRqoR+pWxnmrEthngYTf
+fwk8lOa4JiwgvT2zKIn3X/8i4peEH+ll74fg38FnSbNd67IJKusm7Xi+fT8r87cm
+NW1fiQG2SVufAQWbqz0lwcy2f8Lxb4bG+mRo64EtlOtCt/qMHt1i8b5QZ7dsvfPx
+H2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu838fYxAe
++o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw8g==
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Global Root CA"
+# Serial: 10944719598952040374951832963794454346
+# MD5 Fingerprint: 79:e4:a9:84:0d:7d:3a:96:d7:c0:4f:e2:43:4c:89:2e
+# SHA1 Fingerprint: a8:98:5d:3a:65:e5:e5:c4:b2:d7:d6:6d:40:c6:dd:2f:b1:9c:54:36
+# SHA256 Fingerprint: 43:48:a0:e9:44:4c:78:cb:26:5e:05:8d:5e:89:44:b4:d8:4f:96:62:bd:26:db:25:7f:89:34:a4:43:c7:01:61
+-----BEGIN CERTIFICATE-----
+MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD
+QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT
+MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j
+b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG
+9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB
+CSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97
+nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt
+43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P
+T19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4
+gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO
+BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR
+TLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw
+DQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr
+hMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg
+06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF
+PnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls
+YSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk
+CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4=
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert High Assurance EV Root CA"
+# Serial: 3553400076410547919724730734378100087
+# MD5 Fingerprint: d4:74:de:57:5c:39:b2:d3:9c:85:83:c5:c0:65:49:8a
+# SHA1 Fingerprint: 5f:b7:ee:06:33:e2:59:db:ad:0c:4c:9a:e6:d3:8f:1a:61:c7:dc:25
+# SHA256 Fingerprint: 74:31:e5:f4:c3:c1:ce:46:90:77:4f:0b:61:e0:54:40:88:3b:a9:a0:1e:d0:0b:a6:ab:d7:80:6e:d3:b1:18:cf
+-----BEGIN CERTIFICATE-----
+MIIDxTCCAq2gAwIBAgIQAqxcJmoLQJuPC3nyrkYldzANBgkqhkiG9w0BAQUFADBs
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSswKQYDVQQDEyJEaWdpQ2VydCBIaWdoIEFzc3VyYW5j
+ZSBFViBSb290IENBMB4XDTA2MTExMDAwMDAwMFoXDTMxMTExMDAwMDAwMFowbDEL
+MAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3
+LmRpZ2ljZXJ0LmNvbTErMCkGA1UEAxMiRGlnaUNlcnQgSGlnaCBBc3N1cmFuY2Ug
+RVYgUm9vdCBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMbM5XPm
++9S75S0tMqbf5YE/yc0lSbZxKsPVlDRnogocsF9ppkCxxLeyj9CYpKlBWTrT3JTW
+PNt0OKRKzE0lgvdKpVMSOO7zSW1xkX5jtqumX8OkhPhPYlG++MXs2ziS4wblCJEM
+xChBVfvLWokVfnHoNb9Ncgk9vjo4UFt3MRuNs8ckRZqnrG0AFFoEt7oT61EKmEFB
+Ik5lYYeBQVCmeVyJ3hlKV9Uu5l0cUyx+mM0aBhakaHPQNAQTXKFx01p8VdteZOE3
+hzBWBOURtCmAEvF5OYiiAhF8J2a3iLd48soKqDirCmTCv2ZdlYTBoSUeh10aUAsg
+EsxBu24LUTi4S8sCAwEAAaNjMGEwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQF
+MAMBAf8wHQYDVR0OBBYEFLE+w2kD+L9HAdSYJhoIAu9jZCvDMB8GA1UdIwQYMBaA
+FLE+w2kD+L9HAdSYJhoIAu9jZCvDMA0GCSqGSIb3DQEBBQUAA4IBAQAcGgaX3Nec
+nzyIZgYIVyHbIUf4KmeqvxgydkAQV8GK83rZEWWONfqe/EW1ntlMMUu4kehDLI6z
+eM7b41N5cdblIZQB2lWHmiRk9opmzN6cN82oNLFpmyPInngiK3BD41VHMWEZ71jF
+hS9OMPagMRYjyOfiZRYzy78aG6A9+MpeizGLYAiJLQwGXFK3xPkKmNEVX58Svnw2
+Yzi9RKR/5CYrCsSXaQ3pjOLAEFe4yHYSkVXySGnYvCoCWw9E1CAx2/S6cCZdkGCe
+vEsXCS+0yx5DaMkHJ8HSXPfqIbloEpw8nL+e/IBcm2PN7EeqJSdnoDfzAIJ9VNep
++OkuE6N36B9K
+-----END CERTIFICATE-----
+
+# Issuer: CN=SwissSign Gold CA - G2 O=SwissSign AG
+# Subject: CN=SwissSign Gold CA - G2 O=SwissSign AG
+# Label: "SwissSign Gold CA - G2"
+# Serial: 13492815561806991280
+# MD5 Fingerprint: 24:77:d9:a8:91:d1:3b:fa:88:2d:c2:ff:f8:cd:33:93
+# SHA1 Fingerprint: d8:c5:38:8a:b7:30:1b:1b:6e:d4:7a:e6:45:25:3a:6f:9f:1a:27:61
+# SHA256 Fingerprint: 62:dd:0b:e9:b9:f5:0a:16:3e:a0:f8:e7:5c:05:3b:1e:ca:57:ea:55:c8:68:8f:64:7c:68:81:f2:c8:35:7b:95
+-----BEGIN CERTIFICATE-----
+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
+-----END CERTIFICATE-----
+
+# Issuer: CN=SwissSign Silver CA - G2 O=SwissSign AG
+# Subject: CN=SwissSign Silver CA - G2 O=SwissSign AG
+# Label: "SwissSign Silver CA - G2"
+# Serial: 5700383053117599563
+# MD5 Fingerprint: e0:06:a1:c9:7d:cf:c9:fc:0d:c0:56:75:96:d8:62:13
+# SHA1 Fingerprint: 9b:aa:e5:9f:56:ee:21:cb:43:5a:be:25:93:df:a7:f0:40:d1:1d:cb
+# SHA256 Fingerprint: be:6c:4d:a2:bb:b9:ba:59:b6:f3:93:97:68:37:42:46:c3:c0:05:99:3f:a9:8f:02:0d:1d:ed:be:d4:8a:81:d5
+-----BEGIN CERTIFICATE-----
+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
+-----END CERTIFICATE-----
+
+# Issuer: CN=SecureTrust CA O=SecureTrust Corporation
+# Subject: CN=SecureTrust CA O=SecureTrust Corporation
+# Label: "SecureTrust CA"
+# Serial: 17199774589125277788362757014266862032
+# MD5 Fingerprint: dc:32:c3:a7:6d:25:57:c7:68:09:9d:ea:2d:a9:a2:d1
+# SHA1 Fingerprint: 87:82:c6:c3:04:35:3b:cf:d2:96:92:d2:59:3e:7d:44:d9:34:ff:11
+# SHA256 Fingerprint: f1:c1:b5:0a:e5:a2:0d:d8:03:0e:c9:f6:bc:24:82:3d:d3:67:b5:25:57:59:b4:e7:1b:61:fc:e9:f7:37:5d:73
+-----BEGIN CERTIFICATE-----
+MIIDuDCCAqCgAwIBAgIQDPCOXAgWpa1Cf/DrJxhZ0DANBgkqhkiG9w0BAQUFADBI
+MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x
+FzAVBgNVBAMTDlNlY3VyZVRydXN0IENBMB4XDTA2MTEwNzE5MzExOFoXDTI5MTIz
+MTE5NDA1NVowSDELMAkGA1UEBhMCVVMxIDAeBgNVBAoTF1NlY3VyZVRydXN0IENv
+cnBvcmF0aW9uMRcwFQYDVQQDEw5TZWN1cmVUcnVzdCBDQTCCASIwDQYJKoZIhvcN
+AQEBBQADggEPADCCAQoCggEBAKukgeWVzfX2FI7CT8rU4niVWJxB4Q2ZQCQXOZEz
+Zum+4YOvYlyJ0fwkW2Gz4BERQRwdbvC4u/jep4G6pkjGnx29vo6pQT64lO0pGtSO
+0gMdA+9tDWccV9cGrcrI9f4Or2YlSASWC12juhbDCE/RRvgUXPLIXgGZbf2IzIao
+wW8xQmxSPmjL8xk037uHGFaAJsTQ3MBv396gwpEWoGQRS0S8Hvbn+mPeZqx2pHGj
+7DaUaHp3pLHnDi+BeuK1cobvomuL8A/b01k/unK8RCSc43Oz969XL0Imnal0ugBS
+8kvNU3xHCzaFDmapCJcWNFfBZveA4+1wVMeT4C4oFVmHursCAwEAAaOBnTCBmjAT
+BgkrBgEEAYI3FAIEBh4EAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB
+/zAdBgNVHQ4EFgQUQjK2FvoE/f5dS3rD/fdMQB1aQ68wNAYDVR0fBC0wKzApoCeg
+JYYjaHR0cDovL2NybC5zZWN1cmV0cnVzdC5jb20vU1RDQS5jcmwwEAYJKwYBBAGC
+NxUBBAMCAQAwDQYJKoZIhvcNAQEFBQADggEBADDtT0rhWDpSclu1pqNlGKa7UTt3
+6Z3q059c4EVlew3KW+JwULKUBRSuSceNQQcSc5R+DCMh/bwQf2AQWnL1mA6s7Ll/
+3XpvXdMc9P+IBWlCqQVxyLesJugutIxq/3HcuLHfmbx8IVQr5Fiiu1cprp6poxkm
+D5kuCLDv/WnPmRoJjeOnnyvJNjR7JLN4TJUXpAYmHrZkUjZfYGfZnMUFdAvnZyPS
+CPyI6a6Lf+Ew9Dd+/cYy2i2eRDAwbO4H3tI0/NL/QPZL9GZGBlSm8jIKYyYwa5vR
+3ItHuuG51WLQoqD0ZwV4KWMabwTW+MZMo5qxN7SN5ShLHZ4swrhovO0C7jE=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Secure Global CA O=SecureTrust Corporation
+# Subject: CN=Secure Global CA O=SecureTrust Corporation
+# Label: "Secure Global CA"
+# Serial: 9751836167731051554232119481456978597
+# MD5 Fingerprint: cf:f4:27:0d:d4:ed:dc:65:16:49:6d:3d:da:bf:6e:de
+# SHA1 Fingerprint: 3a:44:73:5a:e5:81:90:1f:24:86:61:46:1e:3b:9c:c4:5f:f5:3a:1b
+# SHA256 Fingerprint: 42:00:f5:04:3a:c8:59:0e:bb:52:7d:20:9e:d1:50:30:29:fb:cb:d4:1c:a1:b5:06:ec:27:f1:5a:de:7d:ac:69
+-----BEGIN CERTIFICATE-----
+MIIDvDCCAqSgAwIBAgIQB1YipOjUiolN9BPI8PjqpTANBgkqhkiG9w0BAQUFADBK
+MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x
+GTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwHhcNMDYxMTA3MTk0MjI4WhcNMjkx
+MjMxMTk1MjA2WjBKMQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3Qg
+Q29ycG9yYXRpb24xGTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwggEiMA0GCSqG
+SIb3DQEBAQUAA4IBDwAwggEKAoIBAQCvNS7YrGxVaQZx5RNoJLNP2MwhR/jxYDiJ
+iQPpvepeRlMJ3Fz1Wuj3RSoC6zFh1ykzTM7HfAo3fg+6MpjhHZevj8fcyTiW89sa
+/FHtaMbQbqR8JNGuQsiWUGMu4P51/pinX0kuleM5M2SOHqRfkNJnPLLZ/kG5VacJ
+jnIFHovdRIWCQtBJwB1g8NEXLJXr9qXBkqPFwqcIYA1gBBCWeZ4WNOaptvolRTnI
+HmX5k/Wq8VLcmZg9pYYaDDUz+kulBAYVHDGA76oYa8J719rO+TMg1fW9ajMtgQT7
+sFzUnKPiXB3jqUJ1XnvUd+85VLrJChgbEplJL4hL/VBi0XPnj3pDAgMBAAGjgZ0w
+gZowEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQF
+MAMBAf8wHQYDVR0OBBYEFK9EBMJBfkiD2045AuzshHrmzsmkMDQGA1UdHwQtMCsw
+KaAnoCWGI2h0dHA6Ly9jcmwuc2VjdXJldHJ1c3QuY29tL1NHQ0EuY3JsMBAGCSsG
+AQQBgjcVAQQDAgEAMA0GCSqGSIb3DQEBBQUAA4IBAQBjGghAfaReUw132HquHw0L
+URYD7xh8yOOvaliTFGCRsoTciE6+OYo68+aCiV0BN7OrJKQVDpI1WkpEXk5X+nXO
+H0jOZvQ8QCaSmGwb7iRGDBezUqXbpZGRzzfTb+cnCDpOGR86p1hcF895P4vkp9Mm
+I50mD1hp/Ed+stCNi5O/KU9DaXR2Z0vPB4zmAve14bRDtUstFJ/53CYNv6ZHdAbY
+iNE6KTCEztI5gGIbqMdXSbxqVVFnFUq+NQfk1XWYN3kwFNspnWzFacxHVaIw98xc
+f8LDmBxrThaA63p4ZUWiABqvDA1VZDRIuJK58bRQKfJPIx/abKwfROHdI3hRW8cW
+-----END CERTIFICATE-----
+
+# Issuer: CN=COMODO Certification Authority O=COMODO CA Limited
+# Subject: CN=COMODO Certification Authority O=COMODO CA Limited
+# Label: "COMODO Certification Authority"
+# Serial: 104350513648249232941998508985834464573
+# MD5 Fingerprint: 5c:48:dc:f7:42:72:ec:56:94:6d:1c:cc:71:35:80:75
+# SHA1 Fingerprint: 66:31:bf:9e:f7:4f:9e:b6:c9:d5:a6:0c:ba:6a:be:d1:f7:bd:ef:7b
+# SHA256 Fingerprint: 0c:2c:d6:3d:f7:80:6f:a3:99:ed:e8:09:11:6b:57:5b:f8:79:89:f0:65:18:f9:80:8c:86:05:03:17:8b:af:66
+-----BEGIN CERTIFICATE-----
+MIIEHTCCAwWgAwIBAgIQToEtioJl4AsC7j41AkblPTANBgkqhkiG9w0BAQUFADCB
+gTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G
+A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxJzAlBgNV
+BAMTHkNPTU9ETyBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wNjEyMDEwMDAw
+MDBaFw0yOTEyMzEyMzU5NTlaMIGBMQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3Jl
+YXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRowGAYDVQQKExFDT01P
+RE8gQ0EgTGltaXRlZDEnMCUGA1UEAxMeQ09NT0RPIENlcnRpZmljYXRpb24gQXV0
+aG9yaXR5MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0ECLi3LjkRv3
+UcEbVASY06m/weaKXTuH+7uIzg3jLz8GlvCiKVCZrts7oVewdFFxze1CkU1B/qnI
+2GqGd0S7WWaXUF601CxwRM/aN5VCaTwwxHGzUvAhTaHYujl8HJ6jJJ3ygxaYqhZ8
+Q5sVW7euNJH+1GImGEaaP+vB+fGQV+useg2L23IwambV4EajcNxo2f8ESIl33rXp
++2dtQem8Ob0y2WIC8bGoPW43nOIv4tOiJovGuFVDiOEjPqXSJDlqR6sA1KGzqSX+
+DT+nHbrTUcELpNqsOO9VUCQFZUaTNE8tja3G1CEZ0o7KBWFxB3NH5YoZEr0ETc5O
+nKVIrLsm9wIDAQABo4GOMIGLMB0GA1UdDgQWBBQLWOWLxkwVN6RAqTCpIb5HNlpW
+/zAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zBJBgNVHR8EQjBAMD6g
+PKA6hjhodHRwOi8vY3JsLmNvbW9kb2NhLmNvbS9DT01PRE9DZXJ0aWZpY2F0aW9u
+QXV0aG9yaXR5LmNybDANBgkqhkiG9w0BAQUFAAOCAQEAPpiem/Yb6dc5t3iuHXIY
+SdOH5EOC6z/JqvWote9VfCFSZfnVDeFs9D6Mk3ORLgLETgdxb8CPOGEIqB6BCsAv
+IC9Bi5HcSEW88cbeunZrM8gALTFGTO3nnc+IlP8zwFboJIYmuNg4ON8qa90SzMc/
+RxdMosIGlgnW2/4/PEZB31jiVg88O8EckzXZOFKs7sjsLjBOlDW0JB9LeGna8gI4
+zJVSk/BwJVmcIGfE7vmLV2H0knZ9P4SNVbfo5azV8fUZVqZa+5Acr5Pr5RzUZ5dd
+BA6+C4OmF4O5MBKgxTMVBbkN+8cFduPYSo38NBejxiEovjBFMR7HeL5YYTisO+IB
+ZQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=COMODO ECC Certification Authority O=COMODO CA Limited
+# Subject: CN=COMODO ECC Certification Authority O=COMODO CA Limited
+# Label: "COMODO ECC Certification Authority"
+# Serial: 41578283867086692638256921589707938090
+# MD5 Fingerprint: 7c:62:ff:74:9d:31:53:5e:68:4a:d5:78:aa:1e:bf:23
+# SHA1 Fingerprint: 9f:74:4e:9f:2b:4d:ba:ec:0f:31:2c:50:b6:56:3b:8e:2d:93:c3:11
+# SHA256 Fingerprint: 17:93:92:7a:06:14:54:97:89:ad:ce:2f:8f:34:f7:f0:b6:6d:0f:3a:e3:a3:b8:4d:21:ec:15:db:ba:4f:ad:c7
+-----BEGIN CERTIFICATE-----
+MIICiTCCAg+gAwIBAgIQH0evqmIAcFBUTAGem2OZKjAKBggqhkjOPQQDAzCBhTEL
+MAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE
+BxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMT
+IkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwMzA2MDAw
+MDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdy
+ZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09N
+T0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlv
+biBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQDR3svdcmCFYX7deSR
+FtSrYpn1PlILBs5BAH+X4QokPB0BBO490o0JlwzgdeT6+3eKKvUDYEs2ixYjFq0J
+cfRK9ChQtP6IHG4/bC8vCVlbpVsLM5niwz2J+Wos77LTBumjQjBAMB0GA1UdDgQW
+BBR1cacZSBm8nZ3qQUfflMRId5nTeTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/
+BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjEA7wNbeqy3eApyt4jf/7VGFAkK+qDm
+fQjGGoe9GKhzvSbKYAydzpmfz1wPMOG+FDHqAjAU9JM8SaczepBGR7NjfRObTrdv
+GDeAU/7dIOA1mjbRxwG55tzd8/8dLDoWV9mSOdY=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certigna O=Dhimyotis
+# Subject: CN=Certigna O=Dhimyotis
+# Label: "Certigna"
+# Serial: 18364802974209362175
+# MD5 Fingerprint: ab:57:a6:5b:7d:42:82:19:b5:d8:58:26:28:5e:fd:ff
+# SHA1 Fingerprint: b1:2e:13:63:45:86:a4:6f:1a:b2:60:68:37:58:2d:c4:ac:fd:94:97
+# SHA256 Fingerprint: e3:b6:a2:db:2e:d7:ce:48:84:2f:7a:c5:32:41:c7:b7:1d:54:14:4b:fb:40:c1:1f:3f:1d:0b:42:f5:ee:a1:2d
+-----BEGIN CERTIFICATE-----
+MIIDqDCCApCgAwIBAgIJAP7c4wEPyUj/MA0GCSqGSIb3DQEBBQUAMDQxCzAJBgNV
+BAYTAkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hMB4X
+DTA3MDYyOTE1MTMwNVoXDTI3MDYyOTE1MTMwNVowNDELMAkGA1UEBhMCRlIxEjAQ
+BgNVBAoMCURoaW15b3RpczERMA8GA1UEAwwIQ2VydGlnbmEwggEiMA0GCSqGSIb3
+DQEBAQUAA4IBDwAwggEKAoIBAQDIaPHJ1tazNHUmgh7stL7qXOEm7RFHYeGifBZ4
+QCHkYJ5ayGPhxLGWkv8YbWkj4Sti993iNi+RB7lIzw7sebYs5zRLcAglozyHGxny
+gQcPOJAZ0xH+hrTy0V4eHpbNgGzOOzGTtvKg0KmVEn2lmsxryIRWijOp5yIVUxbw
+zBfsV1/pogqYCd7jX5xv3EjjhQsVWqa6n6xI4wmy9/Qy3l40vhx4XUJbzg4ij02Q
+130yGLMLLGq/jj8UEYkgDncUtT2UCIf3JR7VsmAA7G8qKCVuKj4YYxclPz5EIBb2
+JsglrgVKtOdjLPOMFlN+XPsRGgjBRmKfIrjxwo1p3Po6WAbfAgMBAAGjgbwwgbkw
+DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUGu3+QTmQtCRZvgHyUtVF9lo53BEw
+ZAYDVR0jBF0wW4AUGu3+QTmQtCRZvgHyUtVF9lo53BGhOKQ2MDQxCzAJBgNVBAYT
+AkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hggkA/tzj
+AQ/JSP8wDgYDVR0PAQH/BAQDAgEGMBEGCWCGSAGG+EIBAQQEAwIABzANBgkqhkiG
+9w0BAQUFAAOCAQEAhQMeknH2Qq/ho2Ge6/PAD/Kl1NqV5ta+aDY9fm4fTIrv0Q8h
+bV6lUmPOEvjvKtpv6zf+EwLHyzs+ImvaYS5/1HI93TDhHkxAGYwP15zRgzB7mFnc
+fca5DClMoTOi62c6ZYTTluLtdkVwj7Ur3vkj1kluPBS1xp81HlDQwY9qcEQCYsuu
+HWhBp6pX6FOqB9IG9tUUBguRA3UsbHK1YZWaDYu5Def131TN3ubY1gkIl2PlwS6w
+t0QmwCbAr1UwnjvVNioZBPRcHv/PLLf/0P2HQBHVESO7SMAhqaQoLf0V+LBOK/Qw
+WyH8EZE0vkHve52Xdf+XlcCWWC/qu0bXu+TZLg==
+-----END CERTIFICATE-----
+
+# Issuer: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority
+# Subject: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority
+# Label: "ePKI Root Certification Authority"
+# Serial: 28956088682735189655030529057352760477
+# MD5 Fingerprint: 1b:2e:00:ca:26:06:90:3d:ad:fe:6f:15:68:d3:6b:b3
+# SHA1 Fingerprint: 67:65:0d:f1:7e:8e:7e:5b:82:40:a4:f4:56:4b:cf:e2:3d:69:c6:f0
+# SHA256 Fingerprint: c0:a6:f4:dc:63:a2:4b:fd:cf:54:ef:2a:6a:08:2a:0a:72:de:35:80:3e:2f:f5:ff:52:7a:e5:d8:72:06:df:d5
+-----BEGIN CERTIFICATE-----
+MIIFsDCCA5igAwIBAgIQFci9ZUdcr7iXAF7kBtK8nTANBgkqhkiG9w0BAQUFADBe
+MQswCQYDVQQGEwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0
+ZC4xKjAoBgNVBAsMIWVQS0kgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAe
+Fw0wNDEyMjAwMjMxMjdaFw0zNDEyMjAwMjMxMjdaMF4xCzAJBgNVBAYTAlRXMSMw
+IQYDVQQKDBpDaHVuZ2h3YSBUZWxlY29tIENvLiwgTHRkLjEqMCgGA1UECwwhZVBL
+SSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIICIjANBgkqhkiG9w0BAQEF
+AAOCAg8AMIICCgKCAgEA4SUP7o3biDN1Z82tH306Tm2d0y8U82N0ywEhajfqhFAH
+SyZbCUNsIZ5qyNUD9WBpj8zwIuQf5/dqIjG3LBXy4P4AakP/h2XGtRrBp0xtInAh
+ijHyl3SJCRImHJ7K2RKilTza6We/CKBk49ZCt0Xvl/T29de1ShUCWH2YWEtgvM3X
+DZoTM1PRYfl61dd4s5oz9wCGzh1NlDivqOx4UXCKXBCDUSH3ET00hl7lSM2XgYI1
+TBnsZfZrxQWh7kcT1rMhJ5QQCtkkO7q+RBNGMD+XPNjX12ruOzjjK9SXDrkb5wdJ
+fzcq+Xd4z1TtW0ado4AOkUPB1ltfFLqfpo0kR0BZv3I4sjZsN/+Z0V0OWQqraffA
+sgRFelQArr5T9rXn4fg8ozHSqf4hUmTFpmfwdQcGlBSBVcYn5AGPF8Fqcde+S/uU
+WH1+ETOxQvdibBjWzwloPn9s9h6PYq2lY9sJpx8iQkEeb5mKPtf5P0B6ebClAZLS
+nT0IFaUQAS2zMnaolQ2zepr7BxB4EW/hj8e6DyUadCrlHJhBmd8hh+iVBmoKs2pH
+dmX2Os+PYhcZewoozRrSgx4hxyy/vv9haLdnG7t4TY3OZ+XkwY63I2binZB1NJip
+NiuKmpS5nezMirH4JYlcWrYvjB9teSSnUmjDhDXiZo1jDiVN1Rmy5nk3pyKdVDEC
+AwEAAaNqMGgwHQYDVR0OBBYEFB4M97Zn8uGSJglFwFU5Lnc/QkqiMAwGA1UdEwQF
+MAMBAf8wOQYEZyoHAAQxMC8wLQIBADAJBgUrDgMCGgUAMAcGBWcqAwAABBRFsMLH
+ClZ87lt4DJX5GFPBphzYEDANBgkqhkiG9w0BAQUFAAOCAgEACbODU1kBPpVJufGB
+uvl2ICO1J2B01GqZNF5sAFPZn/KmsSQHRGoqxqWOeBLoR9lYGxMqXnmbnwoqZ6Yl
+PwZpVnPDimZI+ymBV3QGypzqKOg4ZyYr8dW1P2WT+DZdjo2NQCCHGervJ8A9tDkP
+JXtoUHRVnAxZfVo9QZQlUgjgRywVMRnVvwdVxrsStZf0X4OFunHB2WyBEXYKCrC/
+gpf36j36+uwtqSiUO1bd0lEursC9CBWMd1I0ltabrNMdjmEPNXubrjlpC2JgQCA2
+j6/7Nu4tCEoduL+bXPjqpRugc6bY+G7gMwRfaKonh+3ZwZCc7b3jajWvY9+rGNm6
+5ulK6lCKD2GTHuItGeIwlDWSXQ62B68ZgI9HkFFLLk3dheLSClIKF5r8GrBQAuUB
+o2M3IUxExJtRmREOc5wGj1QupyheRDmHVi03vYVElOEMSyycw5KFNGHLD7ibSkNS
+/jQ6fbjpKdx2qcgw+BRxgMYeNkh0IkFch4LoGHGLQYlE535YW6i4jRPpp2zDR+2z
+Gp1iro2C6pSe3VkQw63d4k3jMdXH7OjysP6SHhYKGvzZ8/gntsm+HbRsZJB/9OTE
+W9c3rkIO3aQab3yIVMUWbuF6aC74Or8NpDyJO3inTmODBCEIZ43ygknQW/2xzQ+D
+hNQ+IIX3Sj0rnP0qCglN6oH4EZw=
+-----END CERTIFICATE-----
+
+# Issuer: O=certSIGN OU=certSIGN ROOT CA
+# Subject: O=certSIGN OU=certSIGN ROOT CA
+# Label: "certSIGN ROOT CA"
+# Serial: 35210227249154
+# MD5 Fingerprint: 18:98:c0:d6:e9:3a:fc:f9:b0:f5:0c:f7:4b:01:44:17
+# SHA1 Fingerprint: fa:b7:ee:36:97:26:62:fb:2d:b0:2a:f6:bf:03:fd:e8:7c:4b:2f:9b
+# SHA256 Fingerprint: ea:a9:62:c4:fa:4a:6b:af:eb:e4:15:19:6d:35:1c:cd:88:8d:4f:53:f3:fa:8a:e6:d7:c4:66:a9:4e:60:42:bb
+-----BEGIN CERTIFICATE-----
+MIIDODCCAiCgAwIBAgIGIAYFFnACMA0GCSqGSIb3DQEBBQUAMDsxCzAJBgNVBAYT
+AlJPMREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBD
+QTAeFw0wNjA3MDQxNzIwMDRaFw0zMTA3MDQxNzIwMDRaMDsxCzAJBgNVBAYTAlJP
+MREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBDQTCC
+ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALczuX7IJUqOtdu0KBuqV5Do
+0SLTZLrTk+jUrIZhQGpgV2hUhE28alQCBf/fm5oqrl0Hj0rDKH/v+yv6efHHrfAQ
+UySQi2bJqIirr1qjAOm+ukbuW3N7LBeCgV5iLKECZbO9xSsAfsT8AzNXDe3i+s5d
+RdY4zTW2ssHQnIFKquSyAVwdj1+ZxLGt24gh65AIgoDzMKND5pCCrlUoSe1b16kQ
+OA7+j0xbm0bqQfWwCHTD0IgztnzXdN/chNFDDnU5oSVAKOp4yw4sLjmdjItuFhwv
+JoIQ4uNllAoEwF73XVv4EOLQunpL+943AAAaWyjj0pxzPjKHmKHJUS/X3qwzs08C
+AwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAcYwHQYDVR0O
+BBYEFOCMm9slSbPxfIbWskKHC9BroNnkMA0GCSqGSIb3DQEBBQUAA4IBAQA+0hyJ
+LjX8+HXd5n9liPRyTMks1zJO890ZeUe9jjtbkw9QSSQTaxQGcu8J06Gh40CEyecY
+MnQ8SG4Pn0vU9x7Tk4ZkVJdjclDVVc/6IJMCopvDI5NOFlV2oHB5bc0hH88vLbwZ
+44gx+FkagQnIl6Z0x2DEW8xXjrJ1/RsCCdtZb3KTafcxQdaIOL+Hsr0Wefmq5L6I
+Jd1hJyMctTEHBDa0GpC9oHRxUIltvBTjD4au8as+x6AJzKNI0eDbZOeStc+vckNw
+i/nDhDwTqn6Sm1dTk/pwwpEOMfmbZ13pljheX7NzTogVZ96edhBiIL5VaZVDADlN
+9u6wWk5JRFRYX0KD
+-----END CERTIFICATE-----
+
+# Issuer: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services)
+# Subject: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services)
+# Label: "NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny"
+# Serial: 80544274841616
+# MD5 Fingerprint: c5:a1:b7:ff:73:dd:d6:d7:34:32:18:df:fc:3c:ad:88
+# SHA1 Fingerprint: 06:08:3f:59:3f:15:a1:04:a0:69:a4:6b:a9:03:d0:06:b7:97:09:91
+# SHA256 Fingerprint: 6c:61:da:c3:a2:de:f0:31:50:6b:e0:36:d2:a6:fe:40:19:94:fb:d1:3d:f9:c8:d4:66:59:92:74:c4:46:ec:98
+-----BEGIN CERTIFICATE-----
+MIIEFTCCAv2gAwIBAgIGSUEs5AAQMA0GCSqGSIb3DQEBCwUAMIGnMQswCQYDVQQG
+EwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFTATBgNVBAoMDE5ldExvY2sgS2Z0LjE3
+MDUGA1UECwwuVGFuw7pzw610dsOhbnlraWFkw7NrIChDZXJ0aWZpY2F0aW9uIFNl
+cnZpY2VzKTE1MDMGA1UEAwwsTmV0TG9jayBBcmFueSAoQ2xhc3MgR29sZCkgRsWR
+dGFuw7pzw610dsOhbnkwHhcNMDgxMjExMTUwODIxWhcNMjgxMjA2MTUwODIxWjCB
+pzELMAkGA1UEBhMCSFUxETAPBgNVBAcMCEJ1ZGFwZXN0MRUwEwYDVQQKDAxOZXRM
+b2NrIEtmdC4xNzA1BgNVBAsMLlRhbsO6c8OtdHbDoW55a2lhZMOzayAoQ2VydGlm
+aWNhdGlvbiBTZXJ2aWNlcykxNTAzBgNVBAMMLE5ldExvY2sgQXJhbnkgKENsYXNz
+IEdvbGQpIEbFkXRhbsO6c8OtdHbDoW55MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A
+MIIBCgKCAQEAxCRec75LbRTDofTjl5Bu0jBFHjzuZ9lk4BqKf8owyoPjIMHj9DrT
+lF8afFttvzBPhCf2nx9JvMaZCpDyD/V/Q4Q3Y1GLeqVw/HpYzY6b7cNGbIRwXdrz
+AZAj/E4wqX7hJ2Pn7WQ8oLjJM2P+FpD/sLj916jAwJRDC7bVWaaeVtAkH3B5r9s5
+VA1lddkVQZQBr17s9o3x/61k/iCa11zr/qYfCGSji3ZVrR47KGAuhyXoqq8fxmRG
+ILdwfzzeSNuWU7c5d+Qa4scWhHaXWy+7GRWF+GmF9ZmnqfI0p6m2pgP8b4Y9VHx2
+BJtr+UBdADTHLpl1neWIA6pN+APSQnbAGwIDAKiLo0UwQzASBgNVHRMBAf8ECDAG
+AQH/AgEEMA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUzPpnk/C2uNClwB7zU/2M
+U9+D15YwDQYJKoZIhvcNAQELBQADggEBAKt/7hwWqZw8UQCgwBEIBaeZ5m8BiFRh
+bvG5GK1Krf6BQCOUL/t1fC8oS2IkgYIL9WHxHG64YTjrgfpioTtaYtOUZcTh5m2C
++C8lcLIhJsFyUR+MLMOEkMNaj7rP9KdlpeuY0fsFskZ1FSNqb4VjMIDw1Z4fKRzC
+bLBQWV2QWzuoDTDPv31/zvGdg73JRm4gpvlhUbohL3u+pRVjodSVh/GeufOJ8z2F
+uLjbvrW5KfnaNwUASZQDhETnv0Mxz3WLJdH0pmT1kvarBes96aULNmLazAZfNou2
+XjG4Kvte9nHfRCaexOYNkbQudZWAUWpLMKawYqGT8ZvYzsRjdT9ZR7E=
+-----END CERTIFICATE-----
+
+# Issuer: CN=SecureSign RootCA11 O=Japan Certification Services, Inc.
+# Subject: CN=SecureSign RootCA11 O=Japan Certification Services, Inc.
+# Label: "SecureSign RootCA11"
+# Serial: 1
+# MD5 Fingerprint: b7:52:74:e2:92:b4:80:93:f2:75:e4:cc:d7:f2:ea:26
+# SHA1 Fingerprint: 3b:c4:9f:48:f8:f3:73:a0:9c:1e:bd:f8:5b:b1:c3:65:c7:d8:11:b3
+# SHA256 Fingerprint: bf:0f:ee:fb:9e:3a:58:1a:d5:f9:e9:db:75:89:98:57:43:d2:61:08:5c:4d:31:4f:6f:5d:72:59:aa:42:16:12
+-----BEGIN CERTIFICATE-----
+MIIDbTCCAlWgAwIBAgIBATANBgkqhkiG9w0BAQUFADBYMQswCQYDVQQGEwJKUDEr
+MCkGA1UEChMiSmFwYW4gQ2VydGlmaWNhdGlvbiBTZXJ2aWNlcywgSW5jLjEcMBoG
+A1UEAxMTU2VjdXJlU2lnbiBSb290Q0ExMTAeFw0wOTA0MDgwNDU2NDdaFw0yOTA0
+MDgwNDU2NDdaMFgxCzAJBgNVBAYTAkpQMSswKQYDVQQKEyJKYXBhbiBDZXJ0aWZp
+Y2F0aW9uIFNlcnZpY2VzLCBJbmMuMRwwGgYDVQQDExNTZWN1cmVTaWduIFJvb3RD
+QTExMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA/XeqpRyQBTvLTJsz
+i1oURaTnkBbR31fSIRCkF/3frNYfp+TbfPfs37gD2pRY/V1yfIw/XwFndBWW4wI8
+h9uuywGOwvNmxoVF9ALGOrVisq/6nL+k5tSAMJjzDbaTj6nU2DbysPyKyiyhFTOV
+MdrAG/LuYpmGYz+/3ZMqg6h2uRMft85OQoWPIucuGvKVCbIFtUROd6EgvanyTgp9
+UK31BQ1FT0Zx/Sg+U/sE2C3XZR1KG/rPO7AxmjVuyIsG0wCR8pQIZUyxNAYAeoni
+8McDWc/V1uinMrPmmECGxc0nEovMe863ETxiYAcjPitAbpSACW22s293bzUIUPsC
+h8U+iQIDAQABo0IwQDAdBgNVHQ4EFgQUW/hNT7KlhtQ60vFjmqC+CfZXt94wDgYD
+VR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEB
+AKChOBZmLqdWHyGcBvod7bkixTgm2E5P7KN/ed5GIaGHd48HCJqypMWvDzKYC3xm
+KbabfSVSSUOrTC4rbnpwrxYO4wJs+0LmGJ1F2FXI6Dvd5+H0LgscNFxsWEr7jIhQ
+X5Ucv+2rIrVls4W6ng+4reV6G4pQOh29Dbx7VFALuUKvVaAYga1lme++5Jy/xIWr
+QbJUb9wlze144o4MjQlJ3WN7WmmWAiGovVJZ6X01y8hSyn+B/tlr0/cR7SXf+Of5
+pPpyl4RTDaXQMhhRdlkUbA/r7F+AjHVDg8OFmP9Mni0N5HeDk061lgeLKBObjBmN
+QSdJQO7e5iNEOdyhIta6A/I=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd.
+# Subject: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd.
+# Label: "Microsec e-Szigno Root CA 2009"
+# Serial: 14014712776195784473
+# MD5 Fingerprint: f8:49:f4:03:bc:44:2d:83:be:48:69:7d:29:64:fc:b1
+# SHA1 Fingerprint: 89:df:74:fe:5c:f4:0f:4a:80:f9:e3:37:7d:54:da:91:e1:01:31:8e
+# SHA256 Fingerprint: 3c:5f:81:fe:a5:fa:b8:2c:64:bf:a2:ea:ec:af:cd:e8:e0:77:fc:86:20:a7:ca:e5:37:16:3d:f3:6e:db:f3:78
+-----BEGIN CERTIFICATE-----
+MIIECjCCAvKgAwIBAgIJAMJ+QwRORz8ZMA0GCSqGSIb3DQEBCwUAMIGCMQswCQYD
+VQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFjAUBgNVBAoMDU1pY3Jvc2VjIEx0
+ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3ppZ25vIFJvb3QgQ0EgMjAwOTEfMB0G
+CSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5odTAeFw0wOTA2MTYxMTMwMThaFw0y
+OTEyMzAxMTMwMThaMIGCMQswCQYDVQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3Qx
+FjAUBgNVBAoMDU1pY3Jvc2VjIEx0ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3pp
+Z25vIFJvb3QgQ0EgMjAwOTEfMB0GCSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5o
+dTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAOn4j/NjrdqG2KfgQvvP
+kd6mJviZpWNwrZuuyjNAfW2WbqEORO7hE52UQlKavXWFdCyoDh2Tthi3jCyoz/tc
+cbna7P7ofo/kLx2yqHWH2Leh5TvPmUpG0IMZfcChEhyVbUr02MelTTMuhTlAdX4U
+fIASmFDHQWe4oIBhVKZsTh/gnQ4H6cm6M+f+wFUoLAKApxn1ntxVUwOXewdI/5n7
+N4okxFnMUBBjjqqpGrCEGob5X7uxUG6k0QrM1XF+H6cbfPVTbiJfyyvm1HxdrtbC
+xkzlBQHZ7Vf8wSN5/PrIJIOV87VqUQHQd9bpEqH5GoP7ghu5sJf0dgYzQ0mg/wu1
++rUCAwEAAaOBgDB+MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G
+A1UdDgQWBBTLD8bfQkPMPcu1SCOhGnqmKrs0aDAfBgNVHSMEGDAWgBTLD8bfQkPM
+Pcu1SCOhGnqmKrs0aDAbBgNVHREEFDASgRBpbmZvQGUtc3ppZ25vLmh1MA0GCSqG
+SIb3DQEBCwUAA4IBAQDJ0Q5eLtXMs3w+y/w9/w0olZMEyL/azXm4Q5DwpL7v8u8h
+mLzU1F0G9u5C7DBsoKqpyvGvivo/C3NqPuouQH4frlRheesuCDfXI/OMn74dseGk
+ddug4lQUsbocKaQY9hK6ohQU4zE1yED/t+AFdlfBHFny+L/k7SViXITwfn4fs775
+tyERzAMBVnCnEJIeGzSBHq2cGsMEPO0CYdYeBvNfOofyK/FFh+U9rNHHV4S9a67c
+2Pm2G2JwCz02yULyMtd6YebS2z3PyKnJm9zbWETXbzivf3jTo60adbocwTZ8jx5t
+HMN1Rq41Bab2XD0h7lbwyYIiLXpUq3DDfSJlgnCW
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3
+# Label: "GlobalSign Root CA - R3"
+# Serial: 4835703278459759426209954
+# MD5 Fingerprint: c5:df:b8:49:ca:05:13:55:ee:2d:ba:1a:c3:3e:b0:28
+# SHA1 Fingerprint: d6:9b:56:11:48:f0:1c:77:c5:45:78:c1:09:26:df:5b:85:69:76:ad
+# SHA256 Fingerprint: cb:b5:22:d7:b7:f1:27:ad:6a:01:13:86:5b:df:1c:d4:10:2e:7d:07:59:af:63:5a:7c:f4:72:0d:c9:63:c5:3b
+-----BEGIN CERTIFICATE-----
+MIIDXzCCAkegAwIBAgILBAAAAAABIVhTCKIwDQYJKoZIhvcNAQELBQAwTDEgMB4G
+A1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjMxEzARBgNVBAoTCkdsb2JhbFNp
+Z24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDkwMzE4MTAwMDAwWhcNMjkwMzE4
+MTAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMzETMBEG
+A1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI
+hvcNAQEBBQADggEPADCCAQoCggEBAMwldpB5BngiFvXAg7aEyiie/QV2EcWtiHL8
+RgJDx7KKnQRfJMsuS+FggkbhUqsMgUdwbN1k0ev1LKMPgj0MK66X17YUhhB5uzsT
+gHeMCOFJ0mpiLx9e+pZo34knlTifBtc+ycsmWQ1z3rDI6SYOgxXG71uL0gRgykmm
+KPZpO/bLyCiR5Z2KYVc3rHQU3HTgOu5yLy6c+9C7v/U9AOEGM+iCK65TpjoWc4zd
+QQ4gOsC0p6Hpsk+QLjJg6VfLuQSSaGjlOCZgdbKfd/+RFO+uIEn8rUAVSNECMWEZ
+XriX7613t2Saer9fwRPvm2L7DWzgVGkWqQPabumDk3F2xmmFghcCAwEAAaNCMEAw
+DgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI/wS3+o
+LkUkrk1Q+mOai97i3Ru8MA0GCSqGSIb3DQEBCwUAA4IBAQBLQNvAUKr+yAzv95ZU
+RUm7lgAJQayzE4aGKAczymvmdLm6AC2upArT9fHxD4q/c2dKg8dEe3jgr25sbwMp
+jjM5RcOO5LlXbKr8EpbsU8Yt5CRsuZRj+9xTaGdWPoO4zzUhw8lo/s7awlOqzJCK
+6fBdRoyV3XpYKBovHd7NADdBj+1EbddTKJd+82cEHhXXipa0095MJ6RMG3NzdvQX
+mcIfeg7jLQitChws/zyrVQ4PkX4268NXSb7hLi18YIvDQVETI53O9zJrlAGomecs
+Mx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7rkpeDMdmztcpH
+WD9f
+-----END CERTIFICATE-----
+
+# Issuer: CN=Izenpe.com O=IZENPE S.A.
+# Subject: CN=Izenpe.com O=IZENPE S.A.
+# Label: "Izenpe.com"
+# Serial: 917563065490389241595536686991402621
+# MD5 Fingerprint: a6:b0:cd:85:80:da:5c:50:34:a3:39:90:2f:55:67:73
+# SHA1 Fingerprint: 2f:78:3d:25:52:18:a7:4a:65:39:71:b5:2c:a2:9c:45:15:6f:e9:19
+# SHA256 Fingerprint: 25:30:cc:8e:98:32:15:02:ba:d9:6f:9b:1f:ba:1b:09:9e:2d:29:9e:0f:45:48:bb:91:4f:36:3b:c0:d4:53:1f
+-----BEGIN CERTIFICATE-----
+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
+-----END CERTIFICATE-----
+
+# Issuer: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc.
+# Subject: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc.
+# Label: "Go Daddy Root Certificate Authority - G2"
+# Serial: 0
+# MD5 Fingerprint: 80:3a:bc:22:c1:e6:fb:8d:9b:3b:27:4a:32:1b:9a:01
+# SHA1 Fingerprint: 47:be:ab:c9:22:ea:e8:0e:78:78:34:62:a7:9f:45:c2:54:fd:e6:8b
+# SHA256 Fingerprint: 45:14:0b:32:47:eb:9c:c8:c5:b4:f0:d7:b5:30:91:f7:32:92:08:9e:6e:5a:63:e2:74:9d:d3:ac:a9:19:8e:da
+-----BEGIN CERTIFICATE-----
+MIIDxTCCAq2gAwIBAgIBADANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMCVVMx
+EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxGjAYBgNVBAoT
+EUdvRGFkZHkuY29tLCBJbmMuMTEwLwYDVQQDEyhHbyBEYWRkeSBSb290IENlcnRp
+ZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAwMFoXDTM3MTIzMTIz
+NTk1OVowgYMxCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6b25hMRMwEQYDVQQH
+EwpTY290dHNkYWxlMRowGAYDVQQKExFHb0RhZGR5LmNvbSwgSW5jLjExMC8GA1UE
+AxMoR28gRGFkZHkgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIw
+DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL9xYgjx+lk09xvJGKP3gElY6SKD
+E6bFIEMBO4Tx5oVJnyfq9oQbTqC023CYxzIBsQU+B07u9PpPL1kwIuerGVZr4oAH
+/PMWdYA5UXvl+TW2dE6pjYIT5LY/qQOD+qK+ihVqf94Lw7YZFAXK6sOoBJQ7Rnwy
+DfMAZiLIjWltNowRGLfTshxgtDj6AozO091GB94KPutdfMh8+7ArU6SSYmlRJQVh
+GkSBjCypQ5Yj36w6gZoOKcUcqeldHraenjAKOc7xiID7S13MMuyFYkMlNAJWJwGR
+tDtwKj9useiciAF9n9T521NtYJ2/LOdYq7hfRvzOxBsDPAnrSTFcaUaz4EcCAwEA
+AaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE
+FDqahQcQZyi27/a9BUFuIMGU2g/eMA0GCSqGSIb3DQEBCwUAA4IBAQCZ21151fmX
+WWcDYfF+OwYxdS2hII5PZYe096acvNjpL9DbWu7PdIxztDhC2gV7+AJ1uP2lsdeu
+9tfeE8tTEH6KRtGX+rcuKxGrkLAngPnon1rpN5+r5N9ss4UXnT3ZJE95kTXWXwTr
+gIOrmgIttRD02JDHBHNA7XIloKmf7J6raBKZV8aPEjoJpL1E/QYVN8Gb5DKj7Tjo
+2GTzLH4U/ALqn83/B2gX2yKQOC16jdFU8WnjXzPKej17CuPKf1855eJ1usV2GDPO
+LPAvTK33sefOT6jEm0pUBsV/fdUID+Ic/n4XuKxe9tQWskMJDE32p2u0mYRlynqI
+4uJEvlz36hz1
+-----END CERTIFICATE-----
+
+# Issuer: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc.
+# Subject: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc.
+# Label: "Starfield Root Certificate Authority - G2"
+# Serial: 0
+# MD5 Fingerprint: d6:39:81:c6:52:7e:96:69:fc:fc:ca:66:ed:05:f2:96
+# SHA1 Fingerprint: b5:1c:06:7c:ee:2b:0c:3d:f8:55:ab:2d:92:f4:fe:39:d4:e7:0f:0e
+# SHA256 Fingerprint: 2c:e1:cb:0b:f9:d2:f9:e1:02:99:3f:be:21:51:52:c3:b2:dd:0c:ab:de:1c:68:e5:31:9b:83:91:54:db:b7:f5
+-----BEGIN CERTIFICATE-----
+MIID3TCCAsWgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBjzELMAkGA1UEBhMCVVMx
+EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT
+HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAMTKVN0YXJmaWVs
+ZCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAw
+MFoXDTM3MTIzMTIzNTk1OVowgY8xCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6
+b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFyZmllbGQgVGVj
+aG5vbG9naWVzLCBJbmMuMTIwMAYDVQQDEylTdGFyZmllbGQgUm9vdCBDZXJ0aWZp
+Y2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC
+ggEBAL3twQP89o/8ArFvW59I2Z154qK3A2FWGMNHttfKPTUuiUP3oWmb3ooa/RMg
+nLRJdzIpVv257IzdIvpy3Cdhl+72WoTsbhm5iSzchFvVdPtrX8WJpRBSiUZV9Lh1
+HOZ/5FSuS/hVclcCGfgXcVnrHigHdMWdSL5stPSksPNkN3mSwOxGXn/hbVNMYq/N
+Hwtjuzqd+/x5AJhhdM8mgkBj87JyahkNmcrUDnXMN/uLicFZ8WJ/X7NfZTD4p7dN
+dloedl40wOiWVpmKs/B/pM293DIxfJHP4F8R+GuqSVzRmZTRouNjWwl2tVZi4Ut0
+HZbUJtQIBFnQmA4O5t78w+wfkPECAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAO
+BgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFHwMMh+n2TB/xH1oo2Kooc6rB1snMA0G
+CSqGSIb3DQEBCwUAA4IBAQARWfolTwNvlJk7mh+ChTnUdgWUXuEok21iXQnCoKjU
+sHU48TRqneSfioYmUeYs0cYtbpUgSpIB7LiKZ3sx4mcujJUDJi5DnUox9g61DLu3
+4jd/IroAow57UvtruzvE03lRTs2Q9GcHGcg8RnoNAX3FWOdt5oUwF5okxBDgBPfg
+8n/Uqgr/Qh037ZTlZFkSIHc40zI+OIF1lnP6aI+xy84fxez6nH7PfrHxBy22/L/K
+pL/QlwVKvOoYKAKQvVR4CSFx09F9HdkWsKlhPdAKACL8x3vLCWRFCztAgfd9fDL1
+mMpYjn0q7pBZc2T5NnReJaH1ZgUufzkVqSr7UIuOhWn0
+-----END CERTIFICATE-----
+
+# Issuer: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc.
+# Subject: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc.
+# Label: "Starfield Services Root Certificate Authority - G2"
+# Serial: 0
+# MD5 Fingerprint: 17:35:74:af:7b:61:1c:eb:f4:f9:3c:e2:ee:40:f9:a2
+# SHA1 Fingerprint: 92:5a:8f:8d:2c:6d:04:e0:66:5f:59:6a:ff:22:d8:63:e8:25:6f:3f
+# SHA256 Fingerprint: 56:8d:69:05:a2:c8:87:08:a4:b3:02:51:90:ed:cf:ed:b1:97:4a:60:6a:13:c6:e5:29:0f:cb:2a:e6:3e:da:b5
+-----BEGIN CERTIFICATE-----
+MIID7zCCAtegAwIBAgIBADANBgkqhkiG9w0BAQsFADCBmDELMAkGA1UEBhMCVVMx
+EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT
+HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xOzA5BgNVBAMTMlN0YXJmaWVs
+ZCBTZXJ2aWNlcyBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5
+MDkwMTAwMDAwMFoXDTM3MTIzMTIzNTk1OVowgZgxCzAJBgNVBAYTAlVTMRAwDgYD
+VQQIEwdBcml6b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFy
+ZmllbGQgVGVjaG5vbG9naWVzLCBJbmMuMTswOQYDVQQDEzJTdGFyZmllbGQgU2Vy
+dmljZXMgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZI
+hvcNAQEBBQADggEPADCCAQoCggEBANUMOsQq+U7i9b4Zl1+OiFOxHz/Lz58gE20p
+OsgPfTz3a3Y4Y9k2YKibXlwAgLIvWX/2h/klQ4bnaRtSmpDhcePYLQ1Ob/bISdm2
+8xpWriu2dBTrz/sm4xq6HZYuajtYlIlHVv8loJNwU4PahHQUw2eeBGg6345AWh1K
+Ts9DkTvnVtYAcMtS7nt9rjrnvDH5RfbCYM8TWQIrgMw0R9+53pBlbQLPLJGmpufe
+hRhJfGZOozptqbXuNC66DQO4M99H67FrjSXZm86B0UVGMpZwh94CDklDhbZsc7tk
+6mFBrMnUVN+HL8cisibMn1lUaJ/8viovxFUcdUBgF4UCVTmLfwUCAwEAAaNCMEAw
+DwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFJxfAN+q
+AdcwKziIorhtSpzyEZGDMA0GCSqGSIb3DQEBCwUAA4IBAQBLNqaEd2ndOxmfZyMI
+bw5hyf2E3F/YNoHN2BtBLZ9g3ccaaNnRbobhiCPPE95Dz+I0swSdHynVv/heyNXB
+ve6SbzJ08pGCL72CQnqtKrcgfU28elUSwhXqvfdqlS5sdJ/PHLTyxQGjhdByPq1z
+qwubdQxtRbeOlKyWN7Wg0I8VRw7j6IPdj/3vQQF3zCepYoUz8jcI73HPdwbeyBkd
+iEDPfUYd/x7H4c7/I9vG+o1VTqkC50cRRj70/b17KSa7qWFiNyi2LSr2EIZkyXCn
+0q23KXB56jzaYyWf/Wi3MOxw+3WKt21gZ7IeyLnp2KhvAotnDU0mV3HaIPzBSlCN
+sSi6
+-----END CERTIFICATE-----
+
+# Issuer: CN=AffirmTrust Commercial O=AffirmTrust
+# Subject: CN=AffirmTrust Commercial O=AffirmTrust
+# Label: "AffirmTrust Commercial"
+# Serial: 8608355977964138876
+# MD5 Fingerprint: 82:92:ba:5b:ef:cd:8a:6f:a6:3d:55:f9:84:f6:d6:b7
+# SHA1 Fingerprint: f9:b5:b6:32:45:5f:9c:be:ec:57:5f:80:dc:e9:6e:2c:c7:b2:78:b7
+# SHA256 Fingerprint: 03:76:ab:1d:54:c5:f9:80:3c:e4:b2:e2:01:a0:ee:7e:ef:7b:57:b6:36:e8:a9:3c:9b:8d:48:60:c9:6f:5f:a7
+-----BEGIN CERTIFICATE-----
+MIIDTDCCAjSgAwIBAgIId3cGJyapsXwwDQYJKoZIhvcNAQELBQAwRDELMAkGA1UE
+BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz
+dCBDb21tZXJjaWFsMB4XDTEwMDEyOTE0MDYwNloXDTMwMTIzMTE0MDYwNlowRDEL
+MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp
+cm1UcnVzdCBDb21tZXJjaWFsMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
+AQEA9htPZwcroRX1BiLLHwGy43NFBkRJLLtJJRTWzsO3qyxPxkEylFf6EqdbDuKP
+Hx6GGaeqtS25Xw2Kwq+FNXkyLbscYjfysVtKPcrNcV/pQr6U6Mje+SJIZMblq8Yr
+ba0F8PrVC8+a5fBQpIs7R6UjW3p6+DM/uO+Zl+MgwdYoic+U+7lF7eNAFxHUdPAL
+MeIrJmqbTFeurCA+ukV6BfO9m2kVrn1OIGPENXY6BwLJN/3HR+7o8XYdcxXyl6S1
+yHp52UKqK39c/s4mT6NmgTWvRLpUHhwwMmWd5jyTXlBOeuM61G7MGvv50jeuJCqr
+VwMiKA1JdX+3KNp1v47j3A55MQIDAQABo0IwQDAdBgNVHQ4EFgQUnZPGU4teyq8/
+nx4P5ZmVvCT2lI8wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ
+KoZIhvcNAQELBQADggEBAFis9AQOzcAN/wr91LoWXym9e2iZWEnStB03TX8nfUYG
+XUPGhi4+c7ImfU+TqbbEKpqrIZcUsd6M06uJFdhrJNTxFq7YpFzUf1GO7RgBsZNj
+vbz4YYCanrHOQnDiqX0GJX0nof5v7LMeJNrjS1UaADs1tDvZ110w/YETifLCBivt
+Z8SOyUOyXGsViQK8YvxO8rUzqrJv0wqiUOP2O+guRMLbZjipM1ZI8W0bM40NjD9g
+N53Tym1+NH4Nn3J2ixufcv1SNUFFApYvHLKac0khsUlHRUe072o0EclNmsxZt9YC
+nlpOZbWUrhvfKbAW8b8Angc6F2S1BLUjIZkKlTuXfO8=
+-----END CERTIFICATE-----
+
+# Issuer: CN=AffirmTrust Networking O=AffirmTrust
+# Subject: CN=AffirmTrust Networking O=AffirmTrust
+# Label: "AffirmTrust Networking"
+# Serial: 8957382827206547757
+# MD5 Fingerprint: 42:65:ca:be:01:9a:9a:4c:a9:8c:41:49:cd:c0:d5:7f
+# SHA1 Fingerprint: 29:36:21:02:8b:20:ed:02:f5:66:c5:32:d1:d6:ed:90:9f:45:00:2f
+# SHA256 Fingerprint: 0a:81:ec:5a:92:97:77:f1:45:90:4a:f3:8d:5d:50:9f:66:b5:e2:c5:8f:cd:b5:31:05:8b:0e:17:f3:f0:b4:1b
+-----BEGIN CERTIFICATE-----
+MIIDTDCCAjSgAwIBAgIIfE8EORzUmS0wDQYJKoZIhvcNAQEFBQAwRDELMAkGA1UE
+BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz
+dCBOZXR3b3JraW5nMB4XDTEwMDEyOTE0MDgyNFoXDTMwMTIzMTE0MDgyNFowRDEL
+MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp
+cm1UcnVzdCBOZXR3b3JraW5nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
+AQEAtITMMxcua5Rsa2FSoOujz3mUTOWUgJnLVWREZY9nZOIG41w3SfYvm4SEHi3y
+YJ0wTsyEheIszx6e/jarM3c1RNg1lho9Nuh6DtjVR6FqaYvZ/Ls6rnla1fTWcbua
+kCNrmreIdIcMHl+5ni36q1Mr3Lt2PpNMCAiMHqIjHNRqrSK6mQEubWXLviRmVSRL
+QESxG9fhwoXA3hA/Pe24/PHxI1Pcv2WXb9n5QHGNfb2V1M6+oF4nI979ptAmDgAp
+6zxG8D1gvz9Q0twmQVGeFDdCBKNwV6gbh+0t+nvujArjqWaJGctB+d1ENmHP4ndG
+yH329JKBNv3bNPFyfvMMFr20FQIDAQABo0IwQDAdBgNVHQ4EFgQUBx/S55zawm6i
+QLSwelAQUHTEyL0wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ
+KoZIhvcNAQEFBQADggEBAIlXshZ6qML91tmbmzTCnLQyFE2npN/svqe++EPbkTfO
+tDIuUFUaNU52Q3Eg75N3ThVwLofDwR1t3Mu1J9QsVtFSUzpE0nPIxBsFZVpikpzu
+QY0x2+c06lkh1QF612S4ZDnNye2v7UsDSKegmQGA3GWjNq5lWUhPgkvIZfFXHeVZ
+Lgo/bNjR9eUJtGxUAArgFU2HdW23WJZa3W3SAKD0m0i+wzekujbgfIeFlxoVot4u
+olu9rxj5kFDNcFn4J2dHy8egBzp90SxdbBk6ZrV9/ZFvgrG+CJPbFEfxojfHRZ48
+x3evZKiT3/Zpg4Jg8klCNO1aAFSFHBY2kgxc+qatv9s=
+-----END CERTIFICATE-----
+
+# Issuer: CN=AffirmTrust Premium O=AffirmTrust
+# Subject: CN=AffirmTrust Premium O=AffirmTrust
+# Label: "AffirmTrust Premium"
+# Serial: 7893706540734352110
+# MD5 Fingerprint: c4:5d:0e:48:b6:ac:28:30:4e:0a:bc:f9:38:16:87:57
+# SHA1 Fingerprint: d8:a6:33:2c:e0:03:6f:b1:85:f6:63:4f:7d:6a:06:65:26:32:28:27
+# SHA256 Fingerprint: 70:a7:3f:7f:37:6b:60:07:42:48:90:45:34:b1:14:82:d5:bf:0e:69:8e:cc:49:8d:f5:25:77:eb:f2:e9:3b:9a
+-----BEGIN CERTIFICATE-----
+MIIFRjCCAy6gAwIBAgIIbYwURrGmCu4wDQYJKoZIhvcNAQEMBQAwQTELMAkGA1UE
+BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1UcnVz
+dCBQcmVtaXVtMB4XDTEwMDEyOTE0MTAzNloXDTQwMTIzMTE0MTAzNlowQTELMAkG
+A1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1U
+cnVzdCBQcmVtaXVtMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxBLf
+qV/+Qd3d9Z+K4/as4Tx4mrzY8H96oDMq3I0gW64tb+eT2TZwamjPjlGjhVtnBKAQ
+JG9dKILBl1fYSCkTtuG+kU3fhQxTGJoeJKJPj/CihQvL9Cl/0qRY7iZNyaqoe5rZ
++jjeRFcV5fiMyNlI4g0WJx0eyIOFJbe6qlVBzAMiSy2RjYvmia9mx+n/K+k8rNrS
+s8PhaJyJ+HoAVt70VZVs+7pk3WKL3wt3MutizCaam7uqYoNMtAZ6MMgpv+0GTZe5
+HMQxK9VfvFMSF5yZVylmd2EhMQcuJUmdGPLu8ytxjLW6OQdJd/zvLpKQBY0tL3d7
+70O/Nbua2Plzpyzy0FfuKE4mX4+QaAkvuPjcBukumj5Rp9EixAqnOEhss/n/fauG
+V+O61oV4d7pD6kh/9ti+I20ev9E2bFhc8e6kGVQa9QPSdubhjL08s9NIS+LI+H+S
+qHZGnEJlPqQewQcDWkYtuJfzt9WyVSHvutxMAJf7FJUnM7/oQ0dG0giZFmA7mn7S
+5u046uwBHjxIVkkJx0w3AJ6IDsBz4W9m6XJHMD4Q5QsDyZpCAGzFlH5hxIrff4Ia
+C1nEWTJ3s7xgaVY5/bQGeyzWZDbZvUjthB9+pSKPKrhC9IK31FOQeE4tGv2Bb0TX
+OwF0lkLgAOIua+rF7nKsu7/+6qqo+Nz2snmKtmcCAwEAAaNCMEAwHQYDVR0OBBYE
+FJ3AZ6YMItkm9UWrpmVSESfYRaxjMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/
+BAQDAgEGMA0GCSqGSIb3DQEBDAUAA4ICAQCzV00QYk465KzquByvMiPIs0laUZx2
+KI15qldGF9X1Uva3ROgIRL8YhNILgM3FEv0AVQVhh0HctSSePMTYyPtwni94loMg
+Nt58D2kTiKV1NpgIpsbfrM7jWNa3Pt668+s0QNiigfV4Py/VpfzZotReBA4Xrf5B
+8OWycvpEgjNC6C1Y91aMYj+6QrCcDFx+LmUmXFNPALJ4fqENmS2NuB2OosSw/WDQ
+MKSOyARiqcTtNd56l+0OOF6SL5Nwpamcb6d9Ex1+xghIsV5n61EIJenmJWtSKZGc
+0jlzCFfemQa0W50QBuHCAKi4HEoCChTQwUHK+4w1IX2COPKpVJEZNZOUbWo6xbLQ
+u4mGk+ibyQ86p3q4ofB4Rvr8Ny/lioTz3/4E2aFooC8k4gmVBtWVyuEklut89pMF
+u+1z6S3RdTnX5yTb2E5fQ4+e0BQ5v1VwSJlXMbSc7kqYA5YwH2AG7hsj/oFgIxpH
+YoWlzBk0gG+zrBrjn/B7SK3VAdlntqlyk+otZrWyuOQ9PLLvTIzq6we/qzWaVYa8
+GKa1qF60g2xraUDTn9zxw2lrueFtCfTxqlB2Cnp9ehehVZZCmTEJ3WARjQUwfuaO
+RtGdFNrHF+QFlozEJLUbzxQHskD4o55BhrwE0GuWyCqANP2/7waj3VjFhT0+j/6e
+KeC2uAloGRwYQw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=AffirmTrust Premium ECC O=AffirmTrust
+# Subject: CN=AffirmTrust Premium ECC O=AffirmTrust
+# Label: "AffirmTrust Premium ECC"
+# Serial: 8401224907861490260
+# MD5 Fingerprint: 64:b0:09:55:cf:b1:d5:99:e2:be:13:ab:a6:5d:ea:4d
+# SHA1 Fingerprint: b8:23:6b:00:2f:1d:16:86:53:01:55:6c:11:a4:37:ca:eb:ff:c3:bb
+# SHA256 Fingerprint: bd:71:fd:f6:da:97:e4:cf:62:d1:64:7a:dd:25:81:b0:7d:79:ad:f8:39:7e:b4:ec:ba:9c:5e:84:88:82:14:23
+-----BEGIN CERTIFICATE-----
+MIIB/jCCAYWgAwIBAgIIdJclisc/elQwCgYIKoZIzj0EAwMwRTELMAkGA1UEBhMC
+VVMxFDASBgNVBAoMC0FmZmlybVRydXN0MSAwHgYDVQQDDBdBZmZpcm1UcnVzdCBQ
+cmVtaXVtIEVDQzAeFw0xMDAxMjkxNDIwMjRaFw00MDEyMzExNDIwMjRaMEUxCzAJ
+BgNVBAYTAlVTMRQwEgYDVQQKDAtBZmZpcm1UcnVzdDEgMB4GA1UEAwwXQWZmaXJt
+VHJ1c3QgUHJlbWl1bSBFQ0MwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQNMF4bFZ0D
+0KF5Nbc6PJJ6yhUczWLznCZcBz3lVPqj1swS6vQUX+iOGasvLkjmrBhDeKzQN8O9
+ss0s5kfiGuZjuD0uL3jET9v0D6RoTFVya5UdThhClXjMNzyR4ptlKymjQjBAMB0G
+A1UdDgQWBBSaryl6wBE1NSZRMADDav5A1a7WPDAPBgNVHRMBAf8EBTADAQH/MA4G
+A1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNnADBkAjAXCfOHiFBar8jAQr9HX/Vs
+aobgxCd05DhT1wV/GzTjxi+zygk8N53X57hG8f2h4nECMEJZh0PUUd+60wkyWs6I
+flc9nF9Ca/UHLbXwgpP5WW+uZPpY5Yse42O+tYHNbwKMeQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority
+# Subject: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority
+# Label: "Certum Trusted Network CA"
+# Serial: 279744
+# MD5 Fingerprint: d5:e9:81:40:c5:18:69:fc:46:2c:89:75:62:0f:aa:78
+# SHA1 Fingerprint: 07:e0:32:e0:20:b7:2c:3f:19:2f:06:28:a2:59:3a:19:a7:0f:06:9e
+# SHA256 Fingerprint: 5c:58:46:8d:55:f5:8e:49:7e:74:39:82:d2:b5:00:10:b6:d1:65:37:4a:cf:83:a7:d4:a3:2d:b7:68:c4:40:8e
+-----BEGIN CERTIFICATE-----
+MIIDuzCCAqOgAwIBAgIDBETAMA0GCSqGSIb3DQEBBQUAMH4xCzAJBgNVBAYTAlBM
+MSIwIAYDVQQKExlVbml6ZXRvIFRlY2hub2xvZ2llcyBTLkEuMScwJQYDVQQLEx5D
+ZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxIjAgBgNVBAMTGUNlcnR1bSBU
+cnVzdGVkIE5ldHdvcmsgQ0EwHhcNMDgxMDIyMTIwNzM3WhcNMjkxMjMxMTIwNzM3
+WjB+MQswCQYDVQQGEwJQTDEiMCAGA1UEChMZVW5pemV0byBUZWNobm9sb2dpZXMg
+Uy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MSIw
+IAYDVQQDExlDZXJ0dW0gVHJ1c3RlZCBOZXR3b3JrIENBMIIBIjANBgkqhkiG9w0B
+AQEFAAOCAQ8AMIIBCgKCAQEA4/t9o3K6wvDJFIf1awFO4W5AB7ptJ11/91sts1rH
+UV+rpDKmYYe2bg+G0jACl/jXaVehGDldamR5xgFZrDwxSjh80gTSSyjoIF87B6LM
+TXPb865Px1bVWqeWifrzq2jUI4ZZJ88JJ7ysbnKDHDBy3+Ci6dLhdHUZvSqeexVU
+BBvXQzmtVSjF4hq79MDkrjhJM8x2hZ85RdKknvISjFH4fOQtf/WsX+sWn7Et0brM
+kUJ3TCXJkDhv2/DM+44el1k+1WBO5gUo7Ul5E0u6SNsv+XLTOcr+H9g0cvW0QM8x
+AcPs3hEtF10fuFDRXhmnad4HMyjKUJX5p1TLVIZQRan5SQIDAQABo0IwQDAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBQIds3LB/8k9sXN7buQvOKEN0Z19zAOBgNV
+HQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQEFBQADggEBAKaorSLOAT2mo/9i0Eidi15y
+sHhE49wcrwn9I0j6vSrEuVUEtRCjjSfeC4Jj0O7eDDd5QVsisrCaQVymcODU0HfL
+I9MA4GxWL+FpDQ3Zqr8hgVDZBqWo/5U30Kr+4rP1mS1FhIrlQgnXdAIv94nYmem8
+J9RHjboNRhx3zxSkHLmkMcScKHQDNP8zGSal6Q10tz6XxnboJ5ajZt3hrvJBW8qY
+VoNzcOSGGtIxQbovvi0TWnZvTuhOgQ4/WwMioBK+ZlgRSssDxLQqKi2WF+A5VLxI
+03YnnZotBqbJ7DnSq9ufmgsnAjUpsUCV5/nonFWIGUbWtzT1fs45mtk48VH3Tyw=
+-----END CERTIFICATE-----
+
+# Issuer: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA
+# Subject: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA
+# Label: "TWCA Root Certification Authority"
+# Serial: 1
+# MD5 Fingerprint: aa:08:8f:f6:f9:7b:b7:f2:b1:a7:1e:9b:ea:ea:bd:79
+# SHA1 Fingerprint: cf:9e:87:6d:d3:eb:fc:42:26:97:a3:b5:a3:7a:a0:76:a9:06:23:48
+# SHA256 Fingerprint: bf:d8:8f:e1:10:1c:41:ae:3e:80:1b:f8:be:56:35:0e:e9:ba:d1:a6:b9:bd:51:5e:dc:5c:6d:5b:87:11:ac:44
+-----BEGIN CERTIFICATE-----
+MIIDezCCAmOgAwIBAgIBATANBgkqhkiG9w0BAQUFADBfMQswCQYDVQQGEwJUVzES
+MBAGA1UECgwJVEFJV0FOLUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFU
+V0NBIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwODI4MDcyNDMz
+WhcNMzAxMjMxMTU1OTU5WjBfMQswCQYDVQQGEwJUVzESMBAGA1UECgwJVEFJV0FO
+LUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFUV0NBIFJvb3QgQ2VydGlm
+aWNhdGlvbiBBdXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB
+AQCwfnK4pAOU5qfeCTiRShFAh6d8WWQUe7UREN3+v9XAu1bihSX0NXIP+FPQQeFE
+AcK0HMMxQhZHhTMidrIKbw/lJVBPhYa+v5guEGcevhEFhgWQxFnQfHgQsIBct+HH
+K3XLfJ+utdGdIzdjp9xCoi2SBBtQwXu4PhvJVgSLL1KbralW6cH/ralYhzC2gfeX
+RfwZVzsrb+RH9JlF/h3x+JejiB03HFyP4HYlmlD4oFT/RJB2I9IyxsOrBr/8+7/z
+rX2SYgJbKdM1o5OaQ2RgXbL6Mv87BK9NQGr5x+PvI/1ry+UPizgN7gr8/g+YnzAx
+3WxSZfmLgb4i4RxYA7qRG4kHAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqOFsmjd6LWvJPelSDGRjjCDWmujANBgkq
+hkiG9w0BAQUFAAOCAQEAPNV3PdrfibqHDAhUaiBQkr6wQT25JmSDCi/oQMCXKCeC
+MErJk/9q56YAf4lCmtYR5VPOL8zy2gXE/uJQxDqGfczafhAJO5I1KlOy/usrBdls
+XebQ79NqZp4VKIV66IIArB6nCWlWQtNoURi+VJq/REG6Sb4gumlc7rh3zc5sH62D
+lhh9DrUUOYTxKOkto557HnpyWoOzeW/vtPzQCqVYT0bf+215WfKEIlKuD8z7fDvn
+aspHYcN6+NOSBB+4IIThNlQWx0DeO4pz3N/GCUzf7Nr/1FNCocnyYh0igzyXxfkZ
+YiesZSLX0zzG5Y6yU8xJzrww/nsOM5D77dIUkR8Hrw==
+-----END CERTIFICATE-----
+
+# Issuer: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2
+# Subject: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2
+# Label: "Security Communication RootCA2"
+# Serial: 0
+# MD5 Fingerprint: 6c:39:7d:a4:0e:55:59:b2:3f:d6:41:b1:12:50:de:43
+# SHA1 Fingerprint: 5f:3b:8c:f2:f8:10:b3:7d:78:b4:ce:ec:19:19:c3:73:34:b9:c7:74
+# SHA256 Fingerprint: 51:3b:2c:ec:b8:10:d4:cd:e5:dd:85:39:1a:df:c6:c2:dd:60:d8:7b:b7:36:d2:b5:21:48:4a:a4:7a:0e:be:f6
+-----BEGIN CERTIFICATE-----
+MIIDdzCCAl+gAwIBAgIBADANBgkqhkiG9w0BAQsFADBdMQswCQYDVQQGEwJKUDEl
+MCMGA1UEChMcU0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UECxMe
+U2VjdXJpdHkgQ29tbXVuaWNhdGlvbiBSb290Q0EyMB4XDTA5MDUyOTA1MDAzOVoX
+DTI5MDUyOTA1MDAzOVowXTELMAkGA1UEBhMCSlAxJTAjBgNVBAoTHFNFQ09NIFRy
+dXN0IFN5c3RlbXMgQ08uLExURC4xJzAlBgNVBAsTHlNlY3VyaXR5IENvbW11bmlj
+YXRpb24gUm9vdENBMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANAV
+OVKxUrO6xVmCxF1SrjpDZYBLx/KWvNs2l9amZIyoXvDjChz335c9S672XewhtUGr
+zbl+dp+++T42NKA7wfYxEUV0kz1XgMX5iZnK5atq1LXaQZAQwdbWQonCv/Q4EpVM
+VAX3NuRFg3sUZdbcDE3R3n4MqzvEFb46VqZab3ZpUql6ucjrappdUtAtCms1FgkQ
+hNBqyjoGADdH5H5XTz+L62e4iKrFvlNVspHEfbmwhRkGeC7bYRr6hfVKkaHnFtWO
+ojnflLhwHyg/i/xAXmODPIMqGplrz95Zajv8bxbXH/1KEOtOghY6rCcMU/Gt1SSw
+awNQwS08Ft1ENCcadfsCAwEAAaNCMEAwHQYDVR0OBBYEFAqFqXdlBZh8QIH4D5cs
+OPEK7DzPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3
+DQEBCwUAA4IBAQBMOqNErLlFsceTfsgLCkLfZOoc7llsCLqJX2rKSpWeeo8HxdpF
+coJxDjrSzG+ntKEju/Ykn8sX/oymzsLS28yN/HH8AynBbF0zX2S2ZTuJbxh2ePXc
+okgfGT+Ok+vx+hfuzU7jBBJV1uXk3fs+BXziHV7Gp7yXT2g69ekuCkO2r1dcYmh8
+t/2jioSgrGK+KwmHNPBqAbubKVY8/gA3zyNs8U6qtnRGEmyR7jTV7JqR50S+kDFy
+1UkC9gLl9B/rfNmWVan/7Ir5mUf/NVoCqgTLiluHcSmRvaS0eg29mvVXIwAHIRc/
+SjnRBUkLp7Y3gaVdjKozXoEofKd9J+sAro03
+-----END CERTIFICATE-----
+
+# Issuer: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967
+# Subject: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967
+# Label: "Actalis Authentication Root CA"
+# Serial: 6271844772424770508
+# MD5 Fingerprint: 69:c1:0d:4f:07:a3:1b:c3:fe:56:3d:04:bc:11:f6:a6
+# SHA1 Fingerprint: f3:73:b3:87:06:5a:28:84:8a:f2:f3:4a:ce:19:2b:dd:c7:8e:9c:ac
+# SHA256 Fingerprint: 55:92:60:84:ec:96:3a:64:b9:6e:2a:be:01:ce:0b:a8:6a:64:fb:fe:bc:c7:aa:b5:af:c1:55:b3:7f:d7:60:66
+-----BEGIN CERTIFICATE-----
+MIIFuzCCA6OgAwIBAgIIVwoRl0LE48wwDQYJKoZIhvcNAQELBQAwazELMAkGA1UE
+BhMCSVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8w
+MzM1ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290
+IENBMB4XDTExMDkyMjExMjIwMloXDTMwMDkyMjExMjIwMlowazELMAkGA1UEBhMC
+SVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8wMzM1
+ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290IENB
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAp8bEpSmkLO/lGMWwUKNv
+UTufClrJwkg4CsIcoBh/kbWHuUA/3R1oHwiD1S0eiKD4j1aPbZkCkpAW1V8IbInX
+4ay8IMKx4INRimlNAJZaby/ARH6jDuSRzVju3PvHHkVH3Se5CAGfpiEd9UEtL0z9
+KK3giq0itFZljoZUj5NDKd45RnijMCO6zfB9E1fAXdKDa0hMxKufgFpbOr3JpyI/
+gCczWw63igxdBzcIy2zSekciRDXFzMwujt0q7bd9Zg1fYVEiVRvjRuPjPdA1Yprb
+rxTIW6HMiRvhMCb8oJsfgadHHwTrozmSBp+Z07/T6k9QnBn+locePGX2oxgkg4YQ
+51Q+qDp2JE+BIcXjDwL4k5RHILv+1A7TaLndxHqEguNTVHnd25zS8gebLra8Pu2F
+be8lEfKXGkJh90qX6IuxEAf6ZYGyojnP9zz/GPvG8VqLWeICrHuS0E4UT1lF9gxe
+KF+w6D9Fz8+vm2/7hNN3WpVvrJSEnu68wEqPSpP4RCHiMUVhUE4Q2OM1fEwZtN4F
+v6MGn8i1zeQf1xcGDXqVdFUNaBr8EBtiZJ1t4JWgw5QHVw0U5r0F+7if5t+L4sbn
+fpb2U8WANFAoWPASUHEXMLrmeGO89LKtmyuy/uE5jF66CyCU3nuDuP/jVo23Eek7
+jPKxwV2dpAtMK9myGPW1n0sCAwEAAaNjMGEwHQYDVR0OBBYEFFLYiDrIn3hm7Ynz
+ezhwlMkCAjbQMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUUtiIOsifeGbt
+ifN7OHCUyQICNtAwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBCwUAA4ICAQAL
+e3KHwGCmSUyIWOYdiPcUZEim2FgKDk8TNd81HdTtBjHIgT5q1d07GjLukD0R0i70
+jsNjLiNmsGe+b7bAEzlgqqI0JZN1Ut6nna0Oh4lScWoWPBkdg/iaKWW+9D+a2fDz
+WochcYBNy+A4mz+7+uAwTc+G02UQGRjRlwKxK3JCaKygvU5a2hi/a5iB0P2avl4V
+SM0RFbnAKVy06Ij3Pjaut2L9HmLecHgQHEhb2rykOLpn7VU+Xlff1ANATIGk0k9j
+pwlCCRT8AKnCgHNPLsBA2RF7SOp6AsDT6ygBJlh0wcBzIm2Tlf05fbsq4/aC4yyX
+X04fkZT6/iyj2HYauE2yOE+b+h1IYHkm4vP9qdCa6HCPSXrW5b0KDtst842/6+Ok
+fcvHlXHo2qN8xcL4dJIEG4aspCJTQLas/kx2z/uUMsA1n3Y/buWQbqCmJqK4LL7R
+K4X9p2jIugErsWx0Hbhzlefut8cl8ABMALJ+tguLHPPAUJ4lueAI3jZm/zel0btU
+ZCzJJ7VLkn5l/9Mt4blOvH+kQSGQQXemOR/qnuOf0GZvBeyqdn6/axag67XH/JJU
+LysRJyU3eExRarDzzFhdFPFqSBX/wge2sY0PjlxQRrM9vwGYT7JZVEc+NHt4bVaT
+LnPqZih4zR0Uv6CPLy64Lo7yFIrM6bV8+2ydDKXhlg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Buypass Class 2 Root CA O=Buypass AS-983163327
+# Subject: CN=Buypass Class 2 Root CA O=Buypass AS-983163327
+# Label: "Buypass Class 2 Root CA"
+# Serial: 2
+# MD5 Fingerprint: 46:a7:d2:fe:45:fb:64:5a:a8:59:90:9b:78:44:9b:29
+# SHA1 Fingerprint: 49:0a:75:74:de:87:0a:47:fe:58:ee:f6:c7:6b:eb:c6:0b:12:40:99
+# SHA256 Fingerprint: 9a:11:40:25:19:7c:5b:b9:5d:94:e6:3d:55:cd:43:79:08:47:b6:46:b2:3c:df:11:ad:a4:a0:0e:ff:15:fb:48
+-----BEGIN CERTIFICATE-----
+MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd
+MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg
+Q2xhc3MgMiBSb290IENBMB4XDTEwMTAyNjA4MzgwM1oXDTQwMTAyNjA4MzgwM1ow
+TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw
+HgYDVQQDDBdCdXlwYXNzIENsYXNzIDIgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB
+BQADggIPADCCAgoCggIBANfHXvfBB9R3+0Mh9PT1aeTuMgHbo4Yf5FkNuud1g1Lr
+6hxhFUi7HQfKjK6w3Jad6sNgkoaCKHOcVgb/S2TwDCo3SbXlzwx87vFKu3MwZfPV
+L4O2fuPn9Z6rYPnT8Z2SdIrkHJasW4DptfQxh6NR/Md+oW+OU3fUl8FVM5I+GC91
+1K2GScuVr1QGbNgGE41b/+EmGVnAJLqBcXmQRFBoJJRfuLMR8SlBYaNByyM21cHx
+MlAQTn/0hpPshNOOvEu/XAFOBz3cFIqUCqTqc/sLUegTBxj6DvEr0VQVfTzh97QZ
+QmdiXnfgolXsttlpF9U6r0TtSsWe5HonfOV116rLJeffawrbD02TTqigzXsu8lkB
+arcNuAeBfos4GzjmCleZPe4h6KP1DBbdi+w0jpwqHAAVF41og9JwnxgIzRFo1clr
+Us3ERo/ctfPYV3Me6ZQ5BL/T3jjetFPsaRyifsSP5BtwrfKi+fv3FmRmaZ9JUaLi
+FRhnBkp/1Wy1TbMz4GHrXb7pmA8y1x1LPC5aAVKRCfLf6o3YBkBjqhHk/sM3nhRS
+P/TizPJhk9H9Z2vXUq6/aKtAQ6BXNVN48FP4YUIHZMbXb5tMOA1jrGKvNouicwoN
+9SG9dKpN6nIDSdvHXx1iY8f93ZHsM+71bbRuMGjeyNYmsHVee7QHIJihdjK4TWxP
+AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMmAd+BikoL1Rpzz
+uvdMw964o605MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAU18h
+9bqwOlI5LJKwbADJ784g7wbylp7ppHR/ehb8t/W2+xUbP6umwHJdELFx7rxP462s
+A20ucS6vxOOto70MEae0/0qyexAQH6dXQbLArvQsWdZHEIjzIVEpMMpghq9Gqx3t
+OluwlN5E40EIosHsHdb9T7bWR9AUC8rmyrV7d35BH16Dx7aMOZawP5aBQW9gkOLo
++fsicdl9sz1Gv7SEr5AcD48Saq/v7h56rgJKihcrdv6sVIkkLE8/trKnToyokZf7
+KcZ7XC25y2a2t6hbElGFtQl+Ynhw/qlqYLYdDnkM/crqJIByw5c/8nerQyIKx+u2
+DISCLIBrQYoIwOula9+ZEsuK1V6ADJHgJgg2SMX6OBE1/yWDLfJ6v9r9jv6ly0Us
+H8SIU653DtmadsWOLB2jutXsMq7Aqqz30XpN69QH4kj3Io6wpJ9qzo6ysmD0oyLQ
+I+uUWnpp3Q+/QFesa1lQ2aOZ4W7+jQF5JyMV3pKdewlNWudLSDBaGOYKbeaP4NK7
+5t98biGCwWg5TbSYWGZizEqQXsP6JwSxeRV0mcy+rSDeJmAc61ZRpqPq5KM/p/9h
+3PFaTWwyI0PurKju7koSCTxdccK+efrCh2gdC/1cacwG0Jp9VJkqyTkaGa9LKkPz
+Y11aWOIv4x3kqdbQCtCev9eBCfHJxyYNrJgWVqA=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Buypass Class 3 Root CA O=Buypass AS-983163327
+# Subject: CN=Buypass Class 3 Root CA O=Buypass AS-983163327
+# Label: "Buypass Class 3 Root CA"
+# Serial: 2
+# MD5 Fingerprint: 3d:3b:18:9e:2c:64:5a:e8:d5:88:ce:0e:f9:37:c2:ec
+# SHA1 Fingerprint: da:fa:f7:fa:66:84:ec:06:8f:14:50:bd:c7:c2:81:a5:bc:a9:64:57
+# SHA256 Fingerprint: ed:f7:eb:bc:a2:7a:2a:38:4d:38:7b:7d:40:10:c6:66:e2:ed:b4:84:3e:4c:29:b4:ae:1d:5b:93:32:e6:b2:4d
+-----BEGIN CERTIFICATE-----
+MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd
+MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg
+Q2xhc3MgMyBSb290IENBMB4XDTEwMTAyNjA4Mjg1OFoXDTQwMTAyNjA4Mjg1OFow
+TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw
+HgYDVQQDDBdCdXlwYXNzIENsYXNzIDMgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB
+BQADggIPADCCAgoCggIBAKXaCpUWUOOV8l6ddjEGMnqb8RB2uACatVI2zSRHsJ8Y
+ZLya9vrVediQYkwiL944PdbgqOkcLNt4EemOaFEVcsfzM4fkoF0LXOBXByow9c3E
+N3coTRiR5r/VUv1xLXA+58bEiuPwKAv0dpihi4dVsjoT/Lc+JzeOIuOoTyrvYLs9
+tznDDgFHmV0ST9tD+leh7fmdvhFHJlsTmKtdFoqwNxxXnUX/iJY2v7vKB3tvh2PX
+0DJq1l1sDPGzbjniazEuOQAnFN44wOwZZoYS6J1yFhNkUsepNxz9gjDthBgd9K5c
+/3ATAOux9TN6S9ZV+AWNS2mw9bMoNlwUxFFzTWsL8TQH2xc519woe2v1n/MuwU8X
+KhDzzMro6/1rqy6any2CbgTUUgGTLT2G/H783+9CHaZr77kgxve9oKeV/afmiSTY
+zIw0bOIjL9kSGiG5VZFvC5F5GQytQIgLcOJ60g7YaEi7ghM5EFjp2CoHxhLbWNvS
+O1UQRwUVZ2J+GGOmRj8JDlQyXr8NYnon74Do29lLBlo3WiXQCBJ31G8JUJc9yB3D
+34xFMFbG02SrZvPAXpacw8Tvw3xrizp5f7NJzz3iiZ+gMEuFuZyUJHmPfWupRWgP
+K9Dx2hzLabjKSWJtyNBjYt1gD1iqj6G8BaVmos8bdrKEZLFMOVLAMLrwjEsCsLa3
+AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFEe4zf/lb+74suwv
+Tg75JbCOPGvDMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAACAj
+QTUEkMJAYmDv4jVM1z+s4jSQuKFvdvoWFqRINyzpkMLyPPgKn9iB5btb2iUspKdV
+cSQy9sgL8rxq+JOssgfCX5/bzMiKqr5qb+FJEMwx14C7u8jYog5kV+qi9cKpMRXS
+IGrs/CIBKM+GuIAeqcwRpTzyFrNHnfzSgCHEy9BHcEGhyoMZCCxt8l13nIoUE9Q2
+HJLw5QY33KbmkJs4j1xrG0aGQ0JfPgEHU1RdZX33inOhmlRaHylDFCfChQ+1iHsa
+O5S3HWCntZznKWlXWpuTekMwGwPXYshApqr8ZORK15FTAaggiG6cX0S5y2CBNOxv
+033aSF/rtJC8LakcC6wc1aJoIIAE1vyxjy+7SjENSoYc6+I2KSb12tjE8nVhz36u
+dmNKekBlk4f4HoCMhuWG1o8O/FMsYOgWYRqiPkN7zTlgVGr18okmAWiDSKIz6MkE
+kbIRNBE+6tBDGR8Dk5AM/1E9V/RBbuHLoL7ryWPNbczk+DaqaJ3tvV2XcEQNtg41
+3OEMXbugUZTLfhbrES+jkkXITHHZvMmZUldGL1DPvTVp9D0VzgalLA8+9oG6lLvD
+u79leNKGef9JOxqDDPDeeOzI8k1MGt6CKfjBWtrt7uYnXuhF0J0cUahoq0Tj0Itq
+4/g7u9xN12TyUb7mqqta6THuBrxzvxNiCp/HuZc=
+-----END CERTIFICATE-----
+
+# Issuer: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
+# Subject: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
+# Label: "T-TeleSec GlobalRoot Class 3"
+# Serial: 1
+# MD5 Fingerprint: ca:fb:40:a8:4e:39:92:8a:1d:fe:8e:2f:c4:27:ea:ef
+# SHA1 Fingerprint: 55:a6:72:3e:cb:f2:ec:cd:c3:23:74:70:19:9d:2a:be:11:e3:81:d1
+# SHA256 Fingerprint: fd:73:da:d3:1c:64:4f:f1:b4:3b:ef:0c:cd:da:96:71:0b:9c:d9:87:5e:ca:7e:31:70:7a:f3:e9:6d:52:2b:bd
+-----BEGIN CERTIFICATE-----
+MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx
+KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd
+BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl
+YyBHbG9iYWxSb290IENsYXNzIDMwHhcNMDgxMDAxMTAyOTU2WhcNMzMxMDAxMjM1
+OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy
+aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50
+ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDMwggEiMA0G
+CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC9dZPwYiJvJK7genasfb3ZJNW4t/zN
+8ELg63iIVl6bmlQdTQyK9tPPcPRStdiTBONGhnFBSivwKixVA9ZIw+A5OO3yXDw/
+RLyTPWGrTs0NvvAgJ1gORH8EGoel15YUNpDQSXuhdfsaa3Ox+M6pCSzyU9XDFES4
+hqX2iys52qMzVNn6chr3IhUciJFrf2blw2qAsCTz34ZFiP0Zf3WHHx+xGwpzJFu5
+ZeAsVMhg02YXP+HMVDNzkQI6pn97djmiH5a2OK61yJN0HZ65tOVgnS9W0eDrXltM
+EnAMbEQgqxHY9Bn20pxSN+f6tsIxO0rUFJmtxxr1XV/6B7h8DR/Wgx6zAgMBAAGj
+QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS1
+A/d2O2GCahKqGFPrAyGUv/7OyjANBgkqhkiG9w0BAQsFAAOCAQEAVj3vlNW92nOy
+WL6ukK2YJ5f+AbGwUgC4TeQbIXQbfsDuXmkqJa9c1h3a0nnJ85cp4IaH3gRZD/FZ
+1GSFS5mvJQQeyUapl96Cshtwn5z2r3Ex3XsFpSzTucpH9sry9uetuUg/vBa3wW30
+6gmv7PO15wWeph6KU1HWk4HMdJP2udqmJQV0eVp+QD6CSyYRMG7hP0HHRwA11fXT
+91Q+gT3aSWqas+8QPebrb9HIIkfLzM8BMZLZGOMivgkeGj5asuRrDFR6fUNOuIml
+e9eiPZaGzPImNC1qkp2aGtAw4l1OBLBfiyB+d8E9lYLRRpo7PHi4b6HQDWSieB4p
+TpPDpFQUWw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH
+# Subject: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH
+# Label: "D-TRUST Root Class 3 CA 2 2009"
+# Serial: 623603
+# MD5 Fingerprint: cd:e0:25:69:8d:47:ac:9c:89:35:90:f7:fd:51:3d:2f
+# SHA1 Fingerprint: 58:e8:ab:b0:36:15:33:fb:80:f7:9b:1b:6d:29:d3:ff:8d:5f:00:f0
+# SHA256 Fingerprint: 49:e7:a4:42:ac:f0:ea:62:87:05:00:54:b5:25:64:b6:50:e4:f4:9e:42:e3:48:d6:aa:38:e0:39:e9:57:b1:c1
+-----BEGIN CERTIFICATE-----
+MIIEMzCCAxugAwIBAgIDCYPzMA0GCSqGSIb3DQEBCwUAME0xCzAJBgNVBAYTAkRF
+MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMMHkQtVFJVU1QgUm9vdCBD
+bGFzcyAzIENBIDIgMjAwOTAeFw0wOTExMDUwODM1NThaFw0yOTExMDUwODM1NTha
+ME0xCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMM
+HkQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgMjAwOTCCASIwDQYJKoZIhvcNAQEB
+BQADggEPADCCAQoCggEBANOySs96R+91myP6Oi/WUEWJNTrGa9v+2wBoqOADER03
+UAifTUpolDWzU9GUY6cgVq/eUXjsKj3zSEhQPgrfRlWLJ23DEE0NkVJD2IfgXU42
+tSHKXzlABF9bfsyjxiupQB7ZNoTWSPOSHjRGICTBpFGOShrvUD9pXRl/RcPHAY9R
+ySPocq60vFYJfxLLHLGvKZAKyVXMD9O0Gu1HNVpK7ZxzBCHQqr0ME7UAyiZsxGsM
+lFqVlNpQmvH/pStmMaTJOKDfHR+4CS7zp+hnUquVH+BGPtikw8paxTGA6Eian5Rp
+/hnd2HN8gcqW3o7tszIFZYQ05ub9VxC1X3a/L7AQDcUCAwEAAaOCARowggEWMA8G
+A1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFP3aFMSfMN4hvR5COfyrYyNJ4PGEMA4G
+A1UdDwEB/wQEAwIBBjCB0wYDVR0fBIHLMIHIMIGAoH6gfIZ6bGRhcDovL2RpcmVj
+dG9yeS5kLXRydXN0Lm5ldC9DTj1ELVRSVVNUJTIwUm9vdCUyMENsYXNzJTIwMyUy
+MENBJTIwMiUyMDIwMDksTz1ELVRydXN0JTIwR21iSCxDPURFP2NlcnRpZmljYXRl
+cmV2b2NhdGlvbmxpc3QwQ6BBoD+GPWh0dHA6Ly93d3cuZC10cnVzdC5uZXQvY3Js
+L2QtdHJ1c3Rfcm9vdF9jbGFzc18zX2NhXzJfMjAwOS5jcmwwDQYJKoZIhvcNAQEL
+BQADggEBAH+X2zDI36ScfSF6gHDOFBJpiBSVYEQBrLLpME+bUMJm2H6NMLVwMeni
+acfzcNsgFYbQDfC+rAF1hM5+n02/t2A7nPPKHeJeaNijnZflQGDSNiH+0LS4F9p0
+o3/U37CYAqxva2ssJSRyoWXuJVrl5jLn8t+rSfrzkGkj2wTZ51xY/GXUl77M/C4K
+zCUqNQT4YJEVdT1B/yMfGchs64JTBKbkTCJNjYy6zltz7GRUUG3RnFX7acM2w4y8
+PIWmawomDeCTmGCufsYkl4phX5GOZpIJhzbNi5stPvZR1FDUWSi9g/LMKHtThm3Y
+Johw1+qRzT65ysCQblrGXnRl11z+o+I=
+-----END CERTIFICATE-----
+
+# Issuer: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH
+# Subject: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH
+# Label: "D-TRUST Root Class 3 CA 2 EV 2009"
+# Serial: 623604
+# MD5 Fingerprint: aa:c6:43:2c:5e:2d:cd:c4:34:c0:50:4f:11:02:4f:b6
+# SHA1 Fingerprint: 96:c9:1b:0b:95:b4:10:98:42:fa:d0:d8:22:79:fe:60:fa:b9:16:83
+# SHA256 Fingerprint: ee:c5:49:6b:98:8c:e9:86:25:b9:34:09:2e:ec:29:08:be:d0:b0:f3:16:c2:d4:73:0c:84:ea:f1:f3:d3:48:81
+-----BEGIN CERTIFICATE-----
+MIIEQzCCAyugAwIBAgIDCYP0MA0GCSqGSIb3DQEBCwUAMFAxCzAJBgNVBAYTAkRF
+MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNVBAMMIUQtVFJVU1QgUm9vdCBD
+bGFzcyAzIENBIDIgRVYgMjAwOTAeFw0wOTExMDUwODUwNDZaFw0yOTExMDUwODUw
+NDZaMFAxCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNV
+BAMMIUQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgRVYgMjAwOTCCASIwDQYJKoZI
+hvcNAQEBBQADggEPADCCAQoCggEBAJnxhDRwui+3MKCOvXwEz75ivJn9gpfSegpn
+ljgJ9hBOlSJzmY3aFS3nBfwZcyK3jpgAvDw9rKFs+9Z5JUut8Mxk2og+KbgPCdM0
+3TP1YtHhzRnp7hhPTFiu4h7WDFsVWtg6uMQYZB7jM7K1iXdODL/ZlGsTl28So/6Z
+qQTMFexgaDbtCHu39b+T7WYxg4zGcTSHThfqr4uRjRxWQa4iN1438h3Z0S0NL2lR
+p75mpoo6Kr3HGrHhFPC+Oh25z1uxav60sUYgovseO3Dvk5h9jHOW8sXvhXCtKSb8
+HgQ+HKDYD8tSg2J87otTlZCpV6LqYQXY+U3EJ/pure3511H3a6UCAwEAAaOCASQw
+ggEgMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFNOUikxiEyoZLsyvcop9Ntea
+HNxnMA4GA1UdDwEB/wQEAwIBBjCB3QYDVR0fBIHVMIHSMIGHoIGEoIGBhn9sZGFw
+Oi8vZGlyZWN0b3J5LmQtdHJ1c3QubmV0L0NOPUQtVFJVU1QlMjBSb290JTIwQ2xh
+c3MlMjAzJTIwQ0ElMjAyJTIwRVYlMjAyMDA5LE89RC1UcnVzdCUyMEdtYkgsQz1E
+RT9jZXJ0aWZpY2F0ZXJldm9jYXRpb25saXN0MEagRKBChkBodHRwOi8vd3d3LmQt
+dHJ1c3QubmV0L2NybC9kLXRydXN0X3Jvb3RfY2xhc3NfM19jYV8yX2V2XzIwMDku
+Y3JsMA0GCSqGSIb3DQEBCwUAA4IBAQA07XtaPKSUiO8aEXUHL7P+PPoeUSbrh/Yp
+3uDx1MYkCenBz1UbtDDZzhr+BlGmFaQt77JLvyAoJUnRpjZ3NOhk31KxEcdzes05
+nsKtjHEh8lprr988TlWvsoRlFIm5d8sqMb7Po23Pb0iUMkZv53GMoKaEGTcH8gNF
+CSuGdXzfX2lXANtu2KZyIktQ1HWYVt+3GP9DQ1CuekR78HlR10M9p9OB0/DJT7na
+xpeG0ILD5EJt/rDiZE4OJudANCa1CInXCGNjOCd1HjPqbqjdn5lPdE2BiYBL3ZqX
+KVwvvoFBuYz/6n1gBp7N1z3TLqMVvKjmJuVvw9y4AyHqnxbxLFS1
+-----END CERTIFICATE-----
+
+# Issuer: CN=CA Disig Root R2 O=Disig a.s.
+# Subject: CN=CA Disig Root R2 O=Disig a.s.
+# Label: "CA Disig Root R2"
+# Serial: 10572350602393338211
+# MD5 Fingerprint: 26:01:fb:d8:27:a7:17:9a:45:54:38:1a:43:01:3b:03
+# SHA1 Fingerprint: b5:61:eb:ea:a4:de:e4:25:4b:69:1a:98:a5:57:47:c2:34:c7:d9:71
+# SHA256 Fingerprint: e2:3d:4a:03:6d:7b:70:e9:f5:95:b1:42:20:79:d2:b9:1e:df:bb:1f:b6:51:a0:63:3e:aa:8a:9d:c5:f8:07:03
+-----BEGIN CERTIFICATE-----
+MIIFaTCCA1GgAwIBAgIJAJK4iNuwisFjMA0GCSqGSIb3DQEBCwUAMFIxCzAJBgNV
+BAYTAlNLMRMwEQYDVQQHEwpCcmF0aXNsYXZhMRMwEQYDVQQKEwpEaXNpZyBhLnMu
+MRkwFwYDVQQDExBDQSBEaXNpZyBSb290IFIyMB4XDTEyMDcxOTA5MTUzMFoXDTQy
+MDcxOTA5MTUzMFowUjELMAkGA1UEBhMCU0sxEzARBgNVBAcTCkJyYXRpc2xhdmEx
+EzARBgNVBAoTCkRpc2lnIGEucy4xGTAXBgNVBAMTEENBIERpc2lnIFJvb3QgUjIw
+ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCio8QACdaFXS1tFPbCw3Oe
+NcJxVX6B+6tGUODBfEl45qt5WDza/3wcn9iXAng+a0EE6UG9vgMsRfYvZNSrXaNH
+PWSb6WiaxswbP7q+sos0Ai6YVRn8jG+qX9pMzk0DIaPY0jSTVpbLTAwAFjxfGs3I
+x2ymrdMxp7zo5eFm1tL7A7RBZckQrg4FY8aAamkw/dLukO8NJ9+flXP04SXabBbe
+QTg06ov80egEFGEtQX6sx3dOy1FU+16SGBsEWmjGycT6txOgmLcRK7fWV8x8nhfR
+yyX+hk4kLlYMeE2eARKmK6cBZW58Yh2EhN/qwGu1pSqVg8NTEQxzHQuyRpDRQjrO
+QG6Vrf/GlK1ul4SOfW+eioANSW1z4nuSHsPzwfPrLgVv2RvPN3YEyLRa5Beny912
+H9AZdugsBbPWnDTYltxhh5EF5EQIM8HauQhl1K6yNg3ruji6DOWbnuuNZt2Zz9aJ
+QfYEkoopKW1rOhzndX0CcQ7zwOe9yxndnWCywmZgtrEE7snmhrmaZkCo5xHtgUUD
+i/ZnWejBBhG93c+AAk9lQHhcR1DIm+YfgXvkRKhbhZri3lrVx/k6RGZL5DJUfORs
+nLMOPReisjQS1n6yqEm70XooQL6iFh/f5DcfEXP7kAplQ6INfPgGAVUzfbANuPT1
+rqVCV3w2EYx7XsQDnYx5nQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1Ud
+DwEB/wQEAwIBBjAdBgNVHQ4EFgQUtZn4r7CU9eMg1gqtzk5WpC5uQu0wDQYJKoZI
+hvcNAQELBQADggIBACYGXnDnZTPIgm7ZnBc6G3pmsgH2eDtpXi/q/075KMOYKmFM
+tCQSin1tERT3nLXK5ryeJ45MGcipvXrA1zYObYVybqjGom32+nNjf7xueQgcnYqf
+GopTpti72TVVsRHFqQOzVju5hJMiXn7B9hJSi+osZ7z+Nkz1uM/Rs0mSO9MpDpkb
+lvdhuDvEK7Z4bLQjb/D907JedR+Zlais9trhxTF7+9FGs9K8Z7RiVLoJ92Owk6Ka
++elSLotgEqv89WBW7xBci8QaQtyDW2QOy7W81k/BfDxujRNt+3vrMNDcTa/F1bal
+TFtxyegxvug4BkihGuLq0t4SOVga/4AOgnXmt8kHbA7v/zjxmHHEt38OFdAlab0i
+nSvtBfZGR6ztwPDUO+Ls7pZbkBNOHlY667DvlruWIxG68kOGdGSVyCh13x01utI3
+gzhTODY7z2zp+WsO0PsE6E9312UBeIYMej4hYvF/Y3EMyZ9E26gnonW+boE+18Dr
+G5gPcFw0sorMwIUY6256s/daoQe/qUKS82Ail+QUoQebTnbAjn39pCXHR+3/H3Os
+zMOl6W8KjptlwlCFtaOgUxLMVYdh84GuEEZhvUQhuMI9dM9+JDX6HAcOmz0iyu8x
+L4ysEr3vQCj8KWefshNPZiTEUxnpHikV7+ZtsH8tZ/3zbBt1RqPlShfppNcL
+-----END CERTIFICATE-----
+
+# Issuer: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV
+# Subject: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV
+# Label: "ACCVRAIZ1"
+# Serial: 6828503384748696800
+# MD5 Fingerprint: d0:a0:5a:ee:05:b6:09:94:21:a1:7d:f1:b2:29:82:02
+# SHA1 Fingerprint: 93:05:7a:88:15:c6:4f:ce:88:2f:fa:91:16:52:28:78:bc:53:64:17
+# SHA256 Fingerprint: 9a:6e:c0:12:e1:a7:da:9d:be:34:19:4d:47:8a:d7:c0:db:18:22:fb:07:1d:f1:29:81:49:6e:d1:04:38:41:13
+-----BEGIN CERTIFICATE-----
+MIIH0zCCBbugAwIBAgIIXsO3pkN/pOAwDQYJKoZIhvcNAQEFBQAwQjESMBAGA1UE
+AwwJQUNDVlJBSVoxMRAwDgYDVQQLDAdQS0lBQ0NWMQ0wCwYDVQQKDARBQ0NWMQsw
+CQYDVQQGEwJFUzAeFw0xMTA1MDUwOTM3MzdaFw0zMDEyMzEwOTM3MzdaMEIxEjAQ
+BgNVBAMMCUFDQ1ZSQUlaMTEQMA4GA1UECwwHUEtJQUNDVjENMAsGA1UECgwEQUND
+VjELMAkGA1UEBhMCRVMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCb
+qau/YUqXry+XZpp0X9DZlv3P4uRm7x8fRzPCRKPfmt4ftVTdFXxpNRFvu8gMjmoY
+HtiP2Ra8EEg2XPBjs5BaXCQ316PWywlxufEBcoSwfdtNgM3802/J+Nq2DoLSRYWo
+G2ioPej0RGy9ocLLA76MPhMAhN9KSMDjIgro6TenGEyxCQ0jVn8ETdkXhBilyNpA
+lHPrzg5XPAOBOp0KoVdDaaxXbXmQeOW1tDvYvEyNKKGno6e6Ak4l0Squ7a4DIrhr
+IA8wKFSVf+DuzgpmndFALW4ir50awQUZ0m/A8p/4e7MCQvtQqR0tkw8jq8bBD5L/
+0KIV9VMJcRz/RROE5iZe+OCIHAr8Fraocwa48GOEAqDGWuzndN9wrqODJerWx5eH
+k6fGioozl2A3ED6XPm4pFdahD9GILBKfb6qkxkLrQaLjlUPTAYVtjrs78yM2x/47
+4KElB0iryYl0/wiPgL/AlmXz7uxLaL2diMMxs0Dx6M/2OLuc5NF/1OVYm3z61PMO
+m3WR5LpSLhl+0fXNWhn8ugb2+1KoS5kE3fj5tItQo05iifCHJPqDQsGH+tUtKSpa
+cXpkatcnYGMN285J9Y0fkIkyF/hzQ7jSWpOGYdbhdQrqeWZ2iE9x6wQl1gpaepPl
+uUsXQA+xtrn13k/c4LOsOxFwYIRKQ26ZIMApcQrAZQIDAQABo4ICyzCCAscwfQYI
+KwYBBQUHAQEEcTBvMEwGCCsGAQUFBzAChkBodHRwOi8vd3d3LmFjY3YuZXMvZmls
+ZWFkbWluL0FyY2hpdm9zL2NlcnRpZmljYWRvcy9yYWl6YWNjdjEuY3J0MB8GCCsG
+AQUFBzABhhNodHRwOi8vb2NzcC5hY2N2LmVzMB0GA1UdDgQWBBTSh7Tj3zcnk1X2
+VuqB5TbMjB4/vTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNKHtOPfNyeT
+VfZW6oHlNsyMHj+9MIIBcwYDVR0gBIIBajCCAWYwggFiBgRVHSAAMIIBWDCCASIG
+CCsGAQUFBwICMIIBFB6CARAAQQB1AHQAbwByAGkAZABhAGQAIABkAGUAIABDAGUA
+cgB0AGkAZgBpAGMAYQBjAGkA8wBuACAAUgBhAO0AegAgAGQAZQAgAGwAYQAgAEEA
+QwBDAFYAIAAoAEEAZwBlAG4AYwBpAGEAIABkAGUAIABUAGUAYwBuAG8AbABvAGcA
+7QBhACAAeQAgAEMAZQByAHQAaQBmAGkAYwBhAGMAaQDzAG4AIABFAGwAZQBjAHQA
+cgDzAG4AaQBjAGEALAAgAEMASQBGACAAUQA0ADYAMAAxADEANQA2AEUAKQAuACAA
+QwBQAFMAIABlAG4AIABoAHQAdABwADoALwAvAHcAdwB3AC4AYQBjAGMAdgAuAGUA
+czAwBggrBgEFBQcCARYkaHR0cDovL3d3dy5hY2N2LmVzL2xlZ2lzbGFjaW9uX2Mu
+aHRtMFUGA1UdHwROMEwwSqBIoEaGRGh0dHA6Ly93d3cuYWNjdi5lcy9maWxlYWRt
+aW4vQXJjaGl2b3MvY2VydGlmaWNhZG9zL3JhaXphY2N2MV9kZXIuY3JsMA4GA1Ud
+DwEB/wQEAwIBBjAXBgNVHREEEDAOgQxhY2N2QGFjY3YuZXMwDQYJKoZIhvcNAQEF
+BQADggIBAJcxAp/n/UNnSEQU5CmH7UwoZtCPNdpNYbdKl02125DgBS4OxnnQ8pdp
+D70ER9m+27Up2pvZrqmZ1dM8MJP1jaGo/AaNRPTKFpV8M9xii6g3+CfYCS0b78gU
+JyCpZET/LtZ1qmxNYEAZSUNUY9rizLpm5U9EelvZaoErQNV/+QEnWCzI7UiRfD+m
+AM/EKXMRNt6GGT6d7hmKG9Ww7Y49nCrADdg9ZuM8Db3VlFzi4qc1GwQA9j9ajepD
+vV+JHanBsMyZ4k0ACtrJJ1vnE5Bc5PUzolVt3OAJTS+xJlsndQAJxGJ3KQhfnlms
+tn6tn1QwIgPBHnFk/vk4CpYY3QIUrCPLBhwepH2NDd4nQeit2hW3sCPdK6jT2iWH
+7ehVRE2I9DZ+hJp4rPcOVkkO1jMl1oRQQmwgEh0q1b688nCBpHBgvgW1m54ERL5h
+I6zppSSMEYCUWqKiuUnSwdzRp+0xESyeGabu4VXhwOrPDYTkF7eifKXeVSUG7szA
+h1xA2syVP1XgNce4hL60Xc16gwFy7ofmXx2utYXGJt/mwZrpHgJHnyqobalbz+xF
+d3+YJ5oyXSrjhO7FmGYvliAd3djDJ9ew+f7Zfc3Qn48LFFhRny+Lwzgt3uiP1o2H
+pPVWQxaZLPSkVrQ0uGE3ycJYgBugl6H8WY3pEfbRD0tVNEYqi4Y7
+-----END CERTIFICATE-----
+
+# Issuer: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA
+# Subject: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA
+# Label: "TWCA Global Root CA"
+# Serial: 3262
+# MD5 Fingerprint: f9:03:7e:cf:e6:9e:3c:73:7a:2a:90:07:69:ff:2b:96
+# SHA1 Fingerprint: 9c:bb:48:53:f6:a4:f6:d3:52:a4:e8:32:52:55:60:13:f5:ad:af:65
+# SHA256 Fingerprint: 59:76:90:07:f7:68:5d:0f:cd:50:87:2f:9f:95:d5:75:5a:5b:2b:45:7d:81:f3:69:2b:61:0a:98:67:2f:0e:1b
+-----BEGIN CERTIFICATE-----
+MIIFQTCCAymgAwIBAgICDL4wDQYJKoZIhvcNAQELBQAwUTELMAkGA1UEBhMCVFcx
+EjAQBgNVBAoTCVRBSVdBTi1DQTEQMA4GA1UECxMHUm9vdCBDQTEcMBoGA1UEAxMT
+VFdDQSBHbG9iYWwgUm9vdCBDQTAeFw0xMjA2MjcwNjI4MzNaFw0zMDEyMzExNTU5
+NTlaMFExCzAJBgNVBAYTAlRXMRIwEAYDVQQKEwlUQUlXQU4tQ0ExEDAOBgNVBAsT
+B1Jvb3QgQ0ExHDAaBgNVBAMTE1RXQ0EgR2xvYmFsIFJvb3QgQ0EwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQCwBdvI64zEbooh745NnHEKH1Jw7W2CnJfF
+10xORUnLQEK1EjRsGcJ0pDFfhQKX7EMzClPSnIyOt7h52yvVavKOZsTuKwEHktSz
+0ALfUPZVr2YOy+BHYC8rMjk1Ujoog/h7FsYYuGLWRyWRzvAZEk2tY/XTP3VfKfCh
+MBwqoJimFb3u/Rk28OKRQ4/6ytYQJ0lM793B8YVwm8rqqFpD/G2Gb3PpN0Wp8DbH
+zIh1HrtsBv+baz4X7GGqcXzGHaL3SekVtTzWoWH1EfcFbx39Eb7QMAfCKbAJTibc
+46KokWofwpFFiFzlmLhxpRUZyXx1EcxwdE8tmx2RRP1WKKD+u4ZqyPpcC1jcxkt2
+yKsi2XMPpfRaAok/T54igu6idFMqPVMnaR1sjjIsZAAmY2E2TqNGtz99sy2sbZCi
+laLOz9qC5wc0GZbpuCGqKX6mOL6OKUohZnkfs8O1CWfe1tQHRvMq2uYiN2DLgbYP
+oA/pyJV/v1WRBXrPPRXAb94JlAGD1zQbzECl8LibZ9WYkTunhHiVJqRaCPgrdLQA
+BDzfuBSO6N+pjWxnkjMdwLfS7JLIvgm/LCkFbwJrnu+8vyq8W8BQj0FwcYeyTbcE
+qYSjMq+u7msXi7Kx/mzhkIyIqJdIzshNy/MGz19qCkKxHh53L46g5pIOBvwFItIm
+4TFRfTLcDwIDAQABoyMwITAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB
+/zANBgkqhkiG9w0BAQsFAAOCAgEAXzSBdu+WHdXltdkCY4QWwa6gcFGn90xHNcgL
+1yg9iXHZqjNB6hQbbCEAwGxCGX6faVsgQt+i0trEfJdLjbDorMjupWkEmQqSpqsn
+LhpNgb+E1HAerUf+/UqdM+DyucRFCCEK2mlpc3INvjT+lIutwx4116KD7+U4x6WF
+H6vPNOw/KP4M8VeGTslV9xzU2KV9Bnpv1d8Q34FOIWWxtuEXeZVFBs5fzNxGiWNo
+RI2T9GRwoD2dKAXDOXC4Ynsg/eTb6QihuJ49CcdP+yz4k3ZB3lLg4VfSnQO8d57+
+nile98FRYB/e2guyLXW3Q0iT5/Z5xoRdgFlglPx4mI88k1HtQJAH32RjJMtOcQWh
+15QaiDLxInQirqWm2BJpTGCjAu4r7NRjkgtevi92a6O2JryPA9gK8kxkRr05YuWW
+6zRjESjMlfGt7+/cgFhI6Uu46mWs6fyAtbXIRfmswZ/ZuepiiI7E8UuDEq3mi4TW
+nsLrgxifarsbJGAzcMzs9zLzXNl5fe+epP7JI8Mk7hWSsT2RTyaGvWZzJBPqpK5j
+wa19hAM8EHiGG3njxPPyBJUgriOCxLM6AGK/5jYk4Ve6xx6QddVfP5VhK8E7zeWz
+aGHQRiapIVJpLesux+t3zqY6tQMzT3bR51xUAV3LePTJDL/PEo4XLSNolOer/qmy
+KwbQBM0=
+-----END CERTIFICATE-----
+
+# Issuer: CN=TeliaSonera Root CA v1 O=TeliaSonera
+# Subject: CN=TeliaSonera Root CA v1 O=TeliaSonera
+# Label: "TeliaSonera Root CA v1"
+# Serial: 199041966741090107964904287217786801558
+# MD5 Fingerprint: 37:41:49:1b:18:56:9a:26:f5:ad:c2:66:fb:40:a5:4c
+# SHA1 Fingerprint: 43:13:bb:96:f1:d5:86:9b:c1:4e:6a:92:f6:cf:f6:34:69:87:82:37
+# SHA256 Fingerprint: dd:69:36:fe:21:f8:f0:77:c1:23:a1:a5:21:c1:22:24:f7:22:55:b7:3e:03:a7:26:06:93:e8:a2:4b:0f:a3:89
+-----BEGIN CERTIFICATE-----
+MIIFODCCAyCgAwIBAgIRAJW+FqD3LkbxezmCcvqLzZYwDQYJKoZIhvcNAQEFBQAw
+NzEUMBIGA1UECgwLVGVsaWFTb25lcmExHzAdBgNVBAMMFlRlbGlhU29uZXJhIFJv
+b3QgQ0EgdjEwHhcNMDcxMDE4MTIwMDUwWhcNMzIxMDE4MTIwMDUwWjA3MRQwEgYD
+VQQKDAtUZWxpYVNvbmVyYTEfMB0GA1UEAwwWVGVsaWFTb25lcmEgUm9vdCBDQSB2
+MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMK+6yfwIaPzaSZVfp3F
+VRaRXP3vIb9TgHot0pGMYzHw7CTww6XScnwQbfQ3t+XmfHnqjLWCi65ItqwA3GV1
+7CpNX8GH9SBlK4GoRz6JI5UwFpB/6FcHSOcZrr9FZ7E3GwYq/t75rH2D+1665I+X
+Z75Ljo1kB1c4VWk0Nj0TSO9P4tNmHqTPGrdeNjPUtAa9GAH9d4RQAEX1jF3oI7x+
+/jXh7VB7qTCNGdMJjmhnXb88lxhTuylixcpecsHHltTbLaC0H2kD7OriUPEMPPCs
+81Mt8Bz17Ww5OXOAFshSsCPN4D7c3TxHoLs1iuKYaIu+5b9y7tL6pe0S7fyYGKkm
+dtwoSxAgHNN/Fnct7W+A90m7UwW7XWjH1Mh1Fj+JWov3F0fUTPHSiXk+TT2YqGHe
+Oh7S+F4D4MHJHIzTjU3TlTazN19jY5szFPAtJmtTfImMMsJu7D0hADnJoWjiUIMu
+sDor8zagrC/kb2HCUQk5PotTubtn2txTuXZZNp1D5SDgPTJghSJRt8czu90VL6R4
+pgd7gUY2BIbdeTXHlSw7sKMXNeVzH7RcWe/a6hBle3rQf5+ztCo3O3CLm1u5K7fs
+slESl1MpWtTwEhDcTwK7EpIvYtQ/aUN8Ddb8WHUBiJ1YFkveupD/RwGJBmr2X7KQ
+arMCpgKIv7NHfirZ1fpoeDVNAgMBAAGjPzA9MA8GA1UdEwEB/wQFMAMBAf8wCwYD
+VR0PBAQDAgEGMB0GA1UdDgQWBBTwj1k4ALP1j5qWDNXr+nuqF+gTEjANBgkqhkiG
+9w0BAQUFAAOCAgEAvuRcYk4k9AwI//DTDGjkk0kiP0Qnb7tt3oNmzqjMDfz1mgbl
+dxSR651Be5kqhOX//CHBXfDkH1e3damhXwIm/9fH907eT/j3HEbAek9ALCI18Bmx
+0GtnLLCo4MBANzX2hFxc469CeP6nyQ1Q6g2EdvZR74NTxnr/DlZJLo961gzmJ1Tj
+TQpgcmLNkQfWpb/ImWvtxBnmq0wROMVvMeJuScg/doAmAyYp4Db29iBT4xdwNBed
+Y2gea+zDTYa4EzAvXUYNR0PVG6pZDrlcjQZIrXSHX8f8MVRBE+LHIQ6e4B4N4cB7
+Q4WQxYpYxmUKeFfyxiMPAdkgS94P+5KFdSpcc41teyWRyu5FrgZLAMzTsVlQ2jqI
+OylDRl6XK1TOU2+NSueW+r9xDkKLfP0ooNBIytrEgUy7onOTJsjrDNYmiLbAJM+7
+vVvrdX3pCI6GMyx5dwlppYn8s3CQh3aP0yK7Qs69cwsgJirQmz1wHiRszYd2qReW
+t88NkvuOGKmYSdGe/mBEciG5Ge3C9THxOUiIkCR1VBatzvT4aRRkOfujuLpwQMcn
+HL/EVlP6Y2XQ8xwOFvVrhlhNGNTkDY6lnVuR3HYkUD/GKvvZt5y11ubQ2egZixVx
+SK236thZiNSQvxaz2emsWWFUyBy6ysHK4bkgTI86k4mloMy/0/Z1pHWWbVY=
+-----END CERTIFICATE-----
+
+# Issuer: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
+# Subject: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
+# Label: "T-TeleSec GlobalRoot Class 2"
+# Serial: 1
+# MD5 Fingerprint: 2b:9b:9e:e4:7b:6c:1f:00:72:1a:cc:c1:77:79:df:6a
+# SHA1 Fingerprint: 59:0d:2d:7d:88:4f:40:2e:61:7e:a5:62:32:17:65:cf:17:d8:94:e9
+# SHA256 Fingerprint: 91:e2:f5:78:8d:58:10:eb:a7:ba:58:73:7d:e1:54:8a:8e:ca:cd:01:45:98:bc:0b:14:3e:04:1b:17:05:25:52
+-----BEGIN CERTIFICATE-----
+MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx
+KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd
+BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl
+YyBHbG9iYWxSb290IENsYXNzIDIwHhcNMDgxMDAxMTA0MDE0WhcNMzMxMDAxMjM1
+OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy
+aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50
+ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDIwggEiMA0G
+CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCqX9obX+hzkeXaXPSi5kfl82hVYAUd
+AqSzm1nzHoqvNK38DcLZSBnuaY/JIPwhqgcZ7bBcrGXHX+0CfHt8LRvWurmAwhiC
+FoT6ZrAIxlQjgeTNuUk/9k9uN0goOA/FvudocP05l03Sx5iRUKrERLMjfTlH6VJi
+1hKTXrcxlkIF+3anHqP1wvzpesVsqXFP6st4vGCvx9702cu+fjOlbpSD8DT6Iavq
+jnKgP6TeMFvvhk1qlVtDRKgQFRzlAVfFmPHmBiiRqiDFt1MmUUOyCxGVWOHAD3bZ
+wI18gfNycJ5v/hqO2V81xrJvNHy+SE/iWjnX2J14np+GPgNeGYtEotXHAgMBAAGj
+QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS/
+WSA2AHmgoCJrjNXyYdK4LMuCSjANBgkqhkiG9w0BAQsFAAOCAQEAMQOiYQsfdOhy
+NsZt+U2e+iKo4YFWz827n+qrkRk4r6p8FU3ztqONpfSO9kSpp+ghla0+AGIWiPAC
+uvxhI+YzmzB6azZie60EI4RYZeLbK4rnJVM3YlNfvNoBYimipidx5joifsFvHZVw
+IEoHNN/q/xWA5brXethbdXwFeilHfkCoMRN3zUA7tFFHei4R40cR3p1m0IvVVGb6
+g1XqfMIpiRvpb7PO4gWEyS8+eIVibslfwXhjdFjASBgMmTnrpMwatXlajRWc2BQN
+9noHV8cigwUtPJslJj0Ys6lDfMjIq2SPDqO/nBudMNva0Bkuqjzx+zOAduTNrRlP
+BSeOE6Fuwg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Atos TrustedRoot 2011 O=Atos
+# Subject: CN=Atos TrustedRoot 2011 O=Atos
+# Label: "Atos TrustedRoot 2011"
+# Serial: 6643877497813316402
+# MD5 Fingerprint: ae:b9:c4:32:4b:ac:7f:5d:66:cc:77:94:bb:2a:77:56
+# SHA1 Fingerprint: 2b:b1:f5:3e:55:0c:1d:c5:f1:d4:e6:b7:6a:46:4b:55:06:02:ac:21
+# SHA256 Fingerprint: f3:56:be:a2:44:b7:a9:1e:b3:5d:53:ca:9a:d7:86:4a:ce:01:8e:2d:35:d5:f8:f9:6d:df:68:a6:f4:1a:a4:74
+-----BEGIN CERTIFICATE-----
+MIIDdzCCAl+gAwIBAgIIXDPLYixfszIwDQYJKoZIhvcNAQELBQAwPDEeMBwGA1UE
+AwwVQXRvcyBUcnVzdGVkUm9vdCAyMDExMQ0wCwYDVQQKDARBdG9zMQswCQYDVQQG
+EwJERTAeFw0xMTA3MDcxNDU4MzBaFw0zMDEyMzEyMzU5NTlaMDwxHjAcBgNVBAMM
+FUF0b3MgVHJ1c3RlZFJvb3QgMjAxMTENMAsGA1UECgwEQXRvczELMAkGA1UEBhMC
+REUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCVhTuXbyo7LjvPpvMp
+Nb7PGKw+qtn4TaA+Gke5vJrf8v7MPkfoepbCJI419KkM/IL9bcFyYie96mvr54rM
+VD6QUM+A1JX76LWC1BTFtqlVJVfbsVD2sGBkWXppzwO3bw2+yj5vdHLqqjAqc2K+
+SZFhyBH+DgMq92og3AIVDV4VavzjgsG1xZ1kCWyjWZgHJ8cblithdHFsQ/H3NYkQ
+4J7sVaE3IqKHBAUsR320HLliKWYoyrfhk/WklAOZuXCFteZI6o1Q/NnezG8HDt0L
+cp2AMBYHlT8oDv3FdU9T1nSatCQujgKRz3bFmx5VdJx4IbHwLfELn8LVlhgf8FQi
+eowHAgMBAAGjfTB7MB0GA1UdDgQWBBSnpQaxLKYJYO7Rl+lwrrw7GWzbITAPBgNV
+HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFKelBrEspglg7tGX6XCuvDsZbNshMBgG
+A1UdIAQRMA8wDQYLKwYBBAGwLQMEAQEwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3
+DQEBCwUAA4IBAQAmdzTblEiGKkGdLD4GkGDEjKwLVLgfuXvTBznk+j57sj1O7Z8j
+vZfza1zv7v1Apt+hk6EKhqzvINB5Ab149xnYJDE0BAGmuhWawyfc2E8PzBhj/5kP
+DpFrdRbhIfzYJsdHt6bPWHJxfrrhTZVHO8mvbaG0weyJ9rQPOLXiZNwlz6bb65pc
+maHFCN795trV1lpFDMS3wrUU77QR/w4VtfX128a961qn8FYiqTxlVMYVqL2Gns2D
+lmh6cYGJ4Qvh6hEbaAjMaZ7snkGeRDImeuKHCnE96+RapNLbxc3G3mB/ufNPRJLv
+KrcYPqcZ2Qt9sTdBQrC6YB3y/gkRsPCHe6ed
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 1 G3"
+# Serial: 687049649626669250736271037606554624078720034195
+# MD5 Fingerprint: a4:bc:5b:3f:fe:37:9a:fa:64:f0:e2:fa:05:3d:0b:ab
+# SHA1 Fingerprint: 1b:8e:ea:57:96:29:1a:c9:39:ea:b8:0a:81:1a:73:73:c0:93:79:67
+# SHA256 Fingerprint: 8a:86:6f:d1:b2:76:b5:7e:57:8e:92:1c:65:82:8a:2b:ed:58:e9:f2:f2:88:05:41:34:b7:f1:f4:bf:c9:cc:74
+-----BEGIN CERTIFICATE-----
+MIIFYDCCA0igAwIBAgIUeFhfLq0sGUvjNwc1NBMotZbUZZMwDQYJKoZIhvcNAQEL
+BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc
+BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMSBHMzAeFw0xMjAxMTIxNzI3NDRaFw00
+MjAxMTIxNzI3NDRaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM
+aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDEgRzMwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQCgvlAQjunybEC0BJyFuTHK3C3kEakEPBtV
+wedYMB0ktMPvhd6MLOHBPd+C5k+tR4ds7FtJwUrVu4/sh6x/gpqG7D0DmVIB0jWe
+rNrwU8lmPNSsAgHaJNM7qAJGr6Qc4/hzWHa39g6QDbXwz8z6+cZM5cOGMAqNF341
+68Xfuw6cwI2H44g4hWf6Pser4BOcBRiYz5P1sZK0/CPTz9XEJ0ngnjybCKOLXSoh
+4Pw5qlPafX7PGglTvF0FBM+hSo+LdoINofjSxxR3W5A2B4GbPgb6Ul5jxaYA/qXp
+UhtStZI5cgMJYr2wYBZupt0lwgNm3fME0UDiTouG9G/lg6AnhF4EwfWQvTA9xO+o
+abw4m6SkltFi2mnAAZauy8RRNOoMqv8hjlmPSlzkYZqn0ukqeI1RPToV7qJZjqlc
+3sX5kCLliEVx3ZGZbHqfPT2YfF72vhZooF6uCyP8Wg+qInYtyaEQHeTTRCOQiJ/G
+KubX9ZqzWB4vMIkIG1SitZgj7Ah3HJVdYdHLiZxfokqRmu8hqkkWCKi9YSgxyXSt
+hfbZxbGL0eUQMk1fiyA6PEkfM4VZDdvLCXVDaXP7a3F98N/ETH3Goy7IlXnLc6KO
+Tk0k+17kBL5yG6YnLUlamXrXXAkgt3+UuU/xDRxeiEIbEbfnkduebPRq34wGmAOt
+zCjvpUfzUwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
+BjAdBgNVHQ4EFgQUo5fW816iEOGrRZ88F2Q87gFwnMwwDQYJKoZIhvcNAQELBQAD
+ggIBABj6W3X8PnrHX3fHyt/PX8MSxEBd1DKquGrX1RUVRpgjpeaQWxiZTOOtQqOC
+MTaIzen7xASWSIsBx40Bz1szBpZGZnQdT+3Btrm0DWHMY37XLneMlhwqI2hrhVd2
+cDMT/uFPpiN3GPoajOi9ZcnPP/TJF9zrx7zABC4tRi9pZsMbj/7sPtPKlL92CiUN
+qXsCHKnQO18LwIE6PWThv6ctTr1NxNgpxiIY0MWscgKCP6o6ojoilzHdCGPDdRS5
+YCgtW2jgFqlmgiNR9etT2DGbe+m3nUvriBbP+V04ikkwj+3x6xn0dxoxGE1nVGwv
+b2X52z3sIexe9PSLymBlVNFxZPT5pqOBMzYzcfCkeF9OrYMh3jRJjehZrJ3ydlo2
+8hP0r+AJx2EqbPfgna67hkooby7utHnNkDPDs3b69fBsnQGQ+p6Q9pxyz0fawx/k
+NSBT8lTR32GDpgLiJTjehTItXnOQUl1CxM49S+H5GYQd1aJQzEH7QRTDvdbJWqNj
+ZgKAvQU6O0ec7AAmTPWIUb+oI38YB7AL7YsmoWTTYUrrXJ/es69nA7Mf3W1daWhp
+q1467HxpvMc7hU6eFbm0FU/DlXpY18ls6Wy58yljXrQs8C097Vpl4KlbQMJImYFt
+nh8GKjwStIsPm6Ik8KaN1nrgS7ZklmOVhMJKzRwuJIczYOXD
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 2 G3"
+# Serial: 390156079458959257446133169266079962026824725800
+# MD5 Fingerprint: af:0c:86:6e:bf:40:2d:7f:0b:3e:12:50:ba:12:3d:06
+# SHA1 Fingerprint: 09:3c:61:f3:8b:8b:dc:7d:55:df:75:38:02:05:00:e1:25:f5:c8:36
+# SHA256 Fingerprint: 8f:e4:fb:0a:f9:3a:4d:0d:67:db:0b:eb:b2:3e:37:c7:1b:f3:25:dc:bc:dd:24:0e:a0:4d:af:58:b4:7e:18:40
+-----BEGIN CERTIFICATE-----
+MIIFYDCCA0igAwIBAgIURFc0JFuBiZs18s64KztbpybwdSgwDQYJKoZIhvcNAQEL
+BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc
+BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMiBHMzAeFw0xMjAxMTIxODU5MzJaFw00
+MjAxMTIxODU5MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM
+aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDIgRzMwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQChriWyARjcV4g/Ruv5r+LrI3HimtFhZiFf
+qq8nUeVuGxbULX1QsFN3vXg6YOJkApt8hpvWGo6t/x8Vf9WVHhLL5hSEBMHfNrMW
+n4rjyduYNM7YMxcoRvynyfDStNVNCXJJ+fKH46nafaF9a7I6JaltUkSs+L5u+9ym
+c5GQYaYDFCDy54ejiK2toIz/pgslUiXnFgHVy7g1gQyjO/Dh4fxaXc6AcW34Sas+
+O7q414AB+6XrW7PFXmAqMaCvN+ggOp+oMiwMzAkd056OXbxMmO7FGmh77FOm6RQ1
+o9/NgJ8MSPsc9PG/Srj61YxxSscfrf5BmrODXfKEVu+lV0POKa2Mq1W/xPtbAd0j
+IaFYAI7D0GoT7RPjEiuA3GfmlbLNHiJuKvhB1PLKFAeNilUSxmn1uIZoL1NesNKq
+IcGY5jDjZ1XHm26sGahVpkUG0CM62+tlXSoREfA7T8pt9DTEceT/AFr2XK4jYIVz
+8eQQsSWu1ZK7E8EM4DnatDlXtas1qnIhO4M15zHfeiFuuDIIfR0ykRVKYnLP43eh
+vNURG3YBZwjgQQvD6xVu+KQZ2aKrr+InUlYrAoosFCT5v0ICvybIxo/gbjh9Uy3l
+7ZizlWNof/k19N+IxWA1ksB8aRxhlRbQ694Lrz4EEEVlWFA4r0jyWbYW8jwNkALG
+cC4BrTwV1wIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
+BjAdBgNVHQ4EFgQU7edvdlq/YOxJW8ald7tyFnGbxD0wDQYJKoZIhvcNAQELBQAD
+ggIBAJHfgD9DCX5xwvfrs4iP4VGyvD11+ShdyLyZm3tdquXK4Qr36LLTn91nMX66
+AarHakE7kNQIXLJgapDwyM4DYvmL7ftuKtwGTTwpD4kWilhMSA/ohGHqPHKmd+RC
+roijQ1h5fq7KpVMNqT1wvSAZYaRsOPxDMuHBR//47PERIjKWnML2W2mWeyAMQ0Ga
+W/ZZGYjeVYg3UQt4XAoeo0L9x52ID8DyeAIkVJOviYeIyUqAHerQbj5hLja7NQ4n
+lv1mNDthcnPxFlxHBlRJAHpYErAK74X9sbgzdWqTHBLmYF5vHX/JHyPLhGGfHoJE
++V+tYlUkmlKY7VHnoX6XOuYvHxHaU4AshZ6rNRDbIl9qxV6XU/IyAgkwo1jwDQHV
+csaxfGl7w/U2Rcxhbl5MlMVerugOXou/983g7aEOGzPuVBj+D77vfoRrQ+NwmNtd
+dbINWQeFFSM51vHfqSYP1kjHs6Yi9TM3WpVHn3u6GBVv/9YUZINJ0gpnIdsPNWNg
+KCLjsZWDzYWm3S8P52dSbrsvhXz1SnPnxT7AvSESBT/8twNJAlvIJebiVDj1eYeM
+HVOyToV7BjjHLPj4sHKNJeV3UvQDHEimUF+IIDBu8oJDqz2XhOdT+yHBTw8imoa4
+WSr2Rz0ZiC3oheGe7IUIarFsNMkd7EgrO3jtZsSOeWmD3n+M
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 3 G3"
+# Serial: 268090761170461462463995952157327242137089239581
+# MD5 Fingerprint: df:7d:b9:ad:54:6f:68:a1:df:89:57:03:97:43:b0:d7
+# SHA1 Fingerprint: 48:12:bd:92:3c:a8:c4:39:06:e7:30:6d:27:96:e6:a4:cf:22:2e:7d
+# SHA256 Fingerprint: 88:ef:81:de:20:2e:b0:18:45:2e:43:f8:64:72:5c:ea:5f:bd:1f:c2:d9:d2:05:73:07:09:c5:d8:b8:69:0f:46
+-----BEGIN CERTIFICATE-----
+MIIFYDCCA0igAwIBAgIULvWbAiin23r/1aOp7r0DoM8Sah0wDQYJKoZIhvcNAQEL
+BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc
+BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMyBHMzAeFw0xMjAxMTIyMDI2MzJaFw00
+MjAxMTIyMDI2MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM
+aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDMgRzMwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQCzyw4QZ47qFJenMioKVjZ/aEzHs286IxSR
+/xl/pcqs7rN2nXrpixurazHb+gtTTK/FpRp5PIpM/6zfJd5O2YIyC0TeytuMrKNu
+FoM7pmRLMon7FhY4futD4tN0SsJiCnMK3UmzV9KwCoWdcTzeo8vAMvMBOSBDGzXR
+U7Ox7sWTaYI+FrUoRqHe6okJ7UO4BUaKhvVZR74bbwEhELn9qdIoyhA5CcoTNs+c
+ra1AdHkrAj80//ogaX3T7mH1urPnMNA3I4ZyYUUpSFlob3emLoG+B01vr87ERROR
+FHAGjx+f+IdpsQ7vw4kZ6+ocYfx6bIrc1gMLnia6Et3UVDmrJqMz6nWB2i3ND0/k
+A9HvFZcba5DFApCTZgIhsUfei5pKgLlVj7WiL8DWM2fafsSntARE60f75li59wzw
+eyuxwHApw0BiLTtIadwjPEjrewl5qW3aqDCYz4ByA4imW0aucnl8CAMhZa634Ryl
+sSqiMd5mBPfAdOhx3v89WcyWJhKLhZVXGqtrdQtEPREoPHtht+KPZ0/l7DxMYIBp
+VzgeAVuNVejH38DMdyM0SXV89pgR6y3e7UEuFAUCf+D+IOs15xGsIs5XPd7JMG0Q
+A4XN8f+MFrXBsj6IbGB/kE+V9/YtrQE5BwT6dYB9v0lQ7e/JxHwc64B+27bQ3RP+
+ydOc17KXqQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
+BjAdBgNVHQ4EFgQUxhfQvKjqAkPyGwaZXSuQILnXnOQwDQYJKoZIhvcNAQELBQAD
+ggIBADRh2Va1EodVTd2jNTFGu6QHcrxfYWLopfsLN7E8trP6KZ1/AvWkyaiTt3px
+KGmPc+FSkNrVvjrlt3ZqVoAh313m6Tqe5T72omnHKgqwGEfcIHB9UqM+WXzBusnI
+FUBhynLWcKzSt/Ac5IYp8M7vaGPQtSCKFWGafoaYtMnCdvvMujAWzKNhxnQT5Wvv
+oxXqA/4Ti2Tk08HS6IT7SdEQTXlm66r99I0xHnAUrdzeZxNMgRVhvLfZkXdxGYFg
+u/BYpbWcC/ePIlUnwEsBbTuZDdQdm2NnL9DuDcpmvJRPpq3t/O5jrFc/ZSXPsoaP
+0Aj/uHYUbt7lJ+yreLVTubY/6CD50qi+YUbKh4yE8/nxoGibIh6BJpsQBJFxwAYf
+3KDTuVan45gtf4Od34wrnDKOMpTwATwiKp9Dwi7DmDkHOHv8XgBCH/MyJnmDhPbl
+8MFREsALHgQjDFSlTC9JxUrRtm5gDWv8a4uFJGS3iQ6rJUdbPM9+Sb3H6QrG2vd+
+DhcI00iX0HGS8A85PjRqHH3Y8iKuu2n0M7SmSFXRDw4m6Oy2Cy2nhTXN/VnIn9HN
+PlopNLk9hM6xZdRZkZFWdSHBd575euFgndOtBBj0fOtek49TSiIp+EgrPk2GrFt/
+ywaZWWDYWGWVjUTR939+J399roD1B0y2PpxxVJkES/1Y+Zj0
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Assured ID Root G2"
+# Serial: 15385348160840213938643033620894905419
+# MD5 Fingerprint: 92:38:b9:f8:63:24:82:65:2c:57:33:e6:fe:81:8f:9d
+# SHA1 Fingerprint: a1:4b:48:d9:43:ee:0a:0e:40:90:4f:3c:e0:a4:c0:91:93:51:5d:3f
+# SHA256 Fingerprint: 7d:05:eb:b6:82:33:9f:8c:94:51:ee:09:4e:eb:fe:fa:79:53:a1:14:ed:b2:f4:49:49:45:2f:ab:7d:2f:c1:85
+-----BEGIN CERTIFICATE-----
+MIIDljCCAn6gAwIBAgIQC5McOtY5Z+pnI7/Dr5r0SzANBgkqhkiG9w0BAQsFADBl
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv
+b3QgRzIwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQG
+EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl
+cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzIwggEi
+MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDZ5ygvUj82ckmIkzTz+GoeMVSA
+n61UQbVH35ao1K+ALbkKz3X9iaV9JPrjIgwrvJUXCzO/GU1BBpAAvQxNEP4Htecc
+biJVMWWXvdMX0h5i89vqbFCMP4QMls+3ywPgym2hFEwbid3tALBSfK+RbLE4E9Hp
+EgjAALAcKxHad3A2m67OeYfcgnDmCXRwVWmvo2ifv922ebPynXApVfSr/5Vh88lA
+bx3RvpO704gqu52/clpWcTs/1PPRCv4o76Pu2ZmvA9OPYLfykqGxvYmJHzDNw6Yu
+YjOuFgJ3RFrngQo8p0Quebg/BLxcoIfhG69Rjs3sLPr4/m3wOnyqi+RnlTGNAgMB
+AAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQW
+BBTOw0q5mVXyuNtgv6l+vVa1lzan1jANBgkqhkiG9w0BAQsFAAOCAQEAyqVVjOPI
+QW5pJ6d1Ee88hjZv0p3GeDgdaZaikmkuOGybfQTUiaWxMTeKySHMq2zNixya1r9I
+0jJmwYrA8y8678Dj1JGG0VDjA9tzd29KOVPt3ibHtX2vK0LRdWLjSisCx1BL4Gni
+lmwORGYQRI+tBev4eaymG+g3NJ1TyWGqolKvSnAWhsI6yLETcDbYz+70CjTVW0z9
+B5yiutkBclzzTcHdDrEcDcRjvq30FPuJ7KJBDkzMyFdA0G4Dqs0MjomZmWzwPDCv
+ON9vvKO+KSAnq3T/EyJ43pdSVR6DtVQgA+6uwE9W3jfMw3+qBCe703e4YtsXfJwo
+IhNzbM8m9Yop5w==
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Assured ID Root G3"
+# Serial: 15459312981008553731928384953135426796
+# MD5 Fingerprint: 7c:7f:65:31:0c:81:df:8d:ba:3e:99:e2:5c:ad:6e:fb
+# SHA1 Fingerprint: f5:17:a2:4f:9a:48:c6:c9:f8:a2:00:26:9f:dc:0f:48:2c:ab:30:89
+# SHA256 Fingerprint: 7e:37:cb:8b:4c:47:09:0c:ab:36:55:1b:a6:f4:5d:b8:40:68:0f:ba:16:6a:95:2d:b1:00:71:7f:43:05:3f:c2
+-----BEGIN CERTIFICATE-----
+MIICRjCCAc2gAwIBAgIQC6Fa+h3foLVJRK/NJKBs7DAKBggqhkjOPQQDAzBlMQsw
+CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu
+ZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3Qg
+RzMwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQGEwJV
+UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu
+Y29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzMwdjAQBgcq
+hkjOPQIBBgUrgQQAIgNiAAQZ57ysRGXtzbg/WPuNsVepRC0FFfLvC/8QdJ+1YlJf
+Zn4f5dwbRXkLzMZTCp2NXQLZqVneAlr2lSoOjThKiknGvMYDOAdfVdp+CW7if17Q
+RSAPWXYQ1qAk8C3eNvJsKTmjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/
+BAQDAgGGMB0GA1UdDgQWBBTL0L2p4ZgFUaFNN6KDec6NHSrkhDAKBggqhkjOPQQD
+AwNnADBkAjAlpIFFAmsSS3V0T8gj43DydXLefInwz5FyYZ5eEJJZVrmDxxDnOOlY
+JjZ91eQ0hjkCMHw2U/Aw5WJjOpnitqM7mzT6HtoQknFekROn3aRukswy1vUhZscv
+6pZjamVFkpUBtA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Global Root G2"
+# Serial: 4293743540046975378534879503202253541
+# MD5 Fingerprint: e4:a6:8a:c8:54:ac:52:42:46:0a:fd:72:48:1b:2a:44
+# SHA1 Fingerprint: df:3c:24:f9:bf:d6:66:76:1b:26:80:73:fe:06:d1:cc:8d:4f:82:a4
+# SHA256 Fingerprint: cb:3c:cb:b7:60:31:e5:e0:13:8f:8d:d3:9a:23:f9:de:47:ff:c3:5e:43:c1:14:4c:ea:27:d4:6a:5a:b1:cb:5f
+-----BEGIN CERTIFICATE-----
+MIIDjjCCAnagAwIBAgIQAzrx5qcRqaC7KGSxHQn65TANBgkqhkiG9w0BAQsFADBh
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBH
+MjAeFw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVT
+MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j
+b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEcyMIIBIjANBgkqhkiG
+9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuzfNNNx7a8myaJCtSnX/RrohCgiN9RlUyfuI
+2/Ou8jqJkTx65qsGGmvPrC3oXgkkRLpimn7Wo6h+4FR1IAWsULecYxpsMNzaHxmx
+1x7e/dfgy5SDN67sH0NO3Xss0r0upS/kqbitOtSZpLYl6ZtrAGCSYP9PIUkY92eQ
+q2EGnI/yuum06ZIya7XzV+hdG82MHauVBJVJ8zUtluNJbd134/tJS7SsVQepj5Wz
+tCO7TG1F8PapspUwtP1MVYwnSlcUfIKdzXOS0xZKBgyMUNGPHgm+F6HmIcr9g+UQ
+vIOlCsRnKPZzFBQ9RnbDhxSJITRNrw9FDKZJobq7nMWxM4MphQIDAQABo0IwQDAP
+BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUTiJUIBiV
+5uNu5g/6+rkS7QYXjzkwDQYJKoZIhvcNAQELBQADggEBAGBnKJRvDkhj6zHd6mcY
+1Yl9PMWLSn/pvtsrF9+wX3N3KjITOYFnQoQj8kVnNeyIv/iPsGEMNKSuIEyExtv4
+NeF22d+mQrvHRAiGfzZ0JFrabA0UWTW98kndth/Jsw1HKj2ZL7tcu7XUIOGZX1NG
+Fdtom/DzMNU+MeKNhJ7jitralj41E6Vf8PlwUHBHQRFXGU7Aj64GxJUTFy8bJZ91
+8rGOmaFvE7FBcf6IKshPECBV1/MUReXgRPTqh5Uykw7+U0b6LJ3/iyK5S9kJRaTe
+pLiaWN0bfVKfjllDiIGknibVb63dDcY3fe0Dkhvld1927jyNxF1WW6LZZm6zNTfl
+MrY=
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Global Root G3"
+# Serial: 7089244469030293291760083333884364146
+# MD5 Fingerprint: f5:5d:a4:50:a5:fb:28:7e:1e:0f:0d:cc:96:57:56:ca
+# SHA1 Fingerprint: 7e:04:de:89:6a:3e:66:6d:00:e6:87:d3:3f:fa:d9:3b:e8:3d:34:9e
+# SHA256 Fingerprint: 31:ad:66:48:f8:10:41:38:c7:38:f3:9e:a4:32:01:33:39:3e:3a:18:cc:02:29:6e:f9:7c:2a:c9:ef:67:31:d0
+-----BEGIN CERTIFICATE-----
+MIICPzCCAcWgAwIBAgIQBVVWvPJepDU1w6QP1atFcjAKBggqhkjOPQQDAzBhMQsw
+CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu
+ZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBHMzAe
+Fw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVTMRUw
+EwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20x
+IDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEczMHYwEAYHKoZIzj0CAQYF
+K4EEACIDYgAE3afZu4q4C/sLfyHS8L6+c/MzXRq8NOrexpu80JX28MzQC7phW1FG
+fp4tn+6OYwwX7Adw9c+ELkCDnOg/QW07rdOkFFk2eJ0DQ+4QE2xy3q6Ip6FrtUPO
+Z9wj/wMco+I+o0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAd
+BgNVHQ4EFgQUs9tIpPmhxdiuNkHMEWNpYim8S8YwCgYIKoZIzj0EAwMDaAAwZQIx
+AK288mw/EkrRLTnDCgmXc/SINoyIJ7vmiI1Qhadj+Z4y3maTD/HMsQmP3Wyr+mt/
+oAIwOWZbwmSNuJ5Q3KjVSaLtx9zRSX8XAbjIho9OjIgrqJqpisXRAL34VOKa5Vt8
+sycX
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Trusted Root G4"
+# Serial: 7451500558977370777930084869016614236
+# MD5 Fingerprint: 78:f2:fc:aa:60:1f:2f:b4:eb:c9:37:ba:53:2e:75:49
+# SHA1 Fingerprint: dd:fb:16:cd:49:31:c9:73:a2:03:7d:3f:c8:3a:4d:7d:77:5d:05:e4
+# SHA256 Fingerprint: 55:2f:7b:dc:f1:a7:af:9e:6c:e6:72:01:7f:4f:12:ab:f7:72:40:c7:8e:76:1a:c2:03:d1:d9:d2:0a:c8:99:88
+-----BEGIN CERTIFICATE-----
+MIIFkDCCA3igAwIBAgIQBZsbV56OITLiOQe9p3d1XDANBgkqhkiG9w0BAQwFADBi
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3Qg
+RzQwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBiMQswCQYDVQQGEwJV
+UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu
+Y29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQC/5pBzaN675F1KPDAiMGkz7MKnJS7JIT3y
+ithZwuEppz1Yq3aaza57G4QNxDAf8xukOBbrVsaXbR2rsnnyyhHS5F/WBTxSD1If
+xp4VpX6+n6lXFllVcq9ok3DCsrp1mWpzMpTREEQQLt+C8weE5nQ7bXHiLQwb7iDV
+ySAdYyktzuxeTsiT+CFhmzTrBcZe7FsavOvJz82sNEBfsXpm7nfISKhmV1efVFiO
+DCu3T6cw2Vbuyntd463JT17lNecxy9qTXtyOj4DatpGYQJB5w3jHtrHEtWoYOAMQ
+jdjUN6QuBX2I9YI+EJFwq1WCQTLX2wRzKm6RAXwhTNS8rhsDdV14Ztk6MUSaM0C/
+CNdaSaTC5qmgZ92kJ7yhTzm1EVgX9yRcRo9k98FpiHaYdj1ZXUJ2h4mXaXpI8OCi
+EhtmmnTK3kse5w5jrubU75KSOp493ADkRSWJtppEGSt+wJS00mFt6zPZxd9LBADM
+fRyVw4/3IbKyEbe7f/LVjHAsQWCqsWMYRJUadmJ+9oCw++hkpjPRiQfhvbfmQ6QY
+uKZ3AeEPlAwhHbJUKSWJbOUOUlFHdL4mrLZBdd56rF+NP8m800ERElvlEFDrMcXK
+chYiCd98THU/Y+whX8QgUWtvsauGi0/C1kVfnSD8oR7FwI+isX4KJpn15GkvmB0t
+9dmpsh3lGwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
+hjAdBgNVHQ4EFgQU7NfjgtJxXWRM3y5nP+e6mK4cD08wDQYJKoZIhvcNAQEMBQAD
+ggIBALth2X2pbL4XxJEbw6GiAI3jZGgPVs93rnD5/ZpKmbnJeFwMDF/k5hQpVgs2
+SV1EY+CtnJYYZhsjDT156W1r1lT40jzBQ0CuHVD1UvyQO7uYmWlrx8GnqGikJ9yd
++SeuMIW59mdNOj6PWTkiU0TryF0Dyu1Qen1iIQqAyHNm0aAFYF/opbSnr6j3bTWc
+fFqK1qI4mfN4i/RN0iAL3gTujJtHgXINwBQy7zBZLq7gcfJW5GqXb5JQbZaNaHqa
+sjYUegbyJLkJEVDXCLG4iXqEI2FCKeWjzaIgQdfRnGTZ6iahixTXTBmyUEFxPT9N
+cCOGDErcgdLMMpSEDQgJlxxPwO5rIHQw0uA5NBCFIRUBCOhVMt5xSdkoF1BN5r5N
+0XWs0Mr7QbhDparTwwVETyw2m+L64kW4I1NsBm9nVX9GtUw/bihaeSbSpKhil9Ie
+4u1Ki7wb/UdKDd9nZn6yW0HQO+T0O/QEY+nvwlQAUaCKKsnOeMzV6ocEGLPOr0mI
+r/OSmbaz5mEP0oUA51Aa5BuVnRmhuZyxm7EAHu/QD09CbMkKvO5D+jpxpchNJqU1
+/YldvIViHTLSoCtU7ZpXwdv6EM8Zt4tKG48BtieVU+i2iW1bvGjUI+iLUaJW+fCm
+gKDWHrO8Dw9TdSmq6hN35N6MgSGtBxBHEa2HPQfRdbzP82Z+
+-----END CERTIFICATE-----
+
+# Issuer: CN=COMODO RSA Certification Authority O=COMODO CA Limited
+# Subject: CN=COMODO RSA Certification Authority O=COMODO CA Limited
+# Label: "COMODO RSA Certification Authority"
+# Serial: 101909084537582093308941363524873193117
+# MD5 Fingerprint: 1b:31:b0:71:40:36:cc:14:36:91:ad:c4:3e:fd:ec:18
+# SHA1 Fingerprint: af:e5:d2:44:a8:d1:19:42:30:ff:47:9f:e2:f8:97:bb:cd:7a:8c:b4
+# SHA256 Fingerprint: 52:f0:e1:c4:e5:8e:c6:29:29:1b:60:31:7f:07:46:71:b8:5d:7e:a8:0d:5b:07:27:34:63:53:4b:32:b4:02:34
+-----BEGIN CERTIFICATE-----
+MIIF2DCCA8CgAwIBAgIQTKr5yttjb+Af907YWwOGnTANBgkqhkiG9w0BAQwFADCB
+hTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G
+A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNV
+BAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMTE5
+MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgT
+EkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMR
+Q09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNh
+dGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCR
+6FSS0gpWsawNJN3Fz0RndJkrN6N9I3AAcbxT38T6KhKPS38QVr2fcHK3YX/JSw8X
+pz3jsARh7v8Rl8f0hj4K+j5c+ZPmNHrZFGvnnLOFoIJ6dq9xkNfs/Q36nGz637CC
+9BR++b7Epi9Pf5l/tfxnQ3K9DADWietrLNPtj5gcFKt+5eNu/Nio5JIk2kNrYrhV
+/erBvGy2i/MOjZrkm2xpmfh4SDBF1a3hDTxFYPwyllEnvGfDyi62a+pGx8cgoLEf
+Zd5ICLqkTqnyg0Y3hOvozIFIQ2dOciqbXL1MGyiKXCJ7tKuY2e7gUYPDCUZObT6Z
++pUX2nwzV0E8jVHtC7ZcryxjGt9XyD+86V3Em69FmeKjWiS0uqlWPc9vqv9JWL7w
+qP/0uK3pN/u6uPQLOvnoQ0IeidiEyxPx2bvhiWC4jChWrBQdnArncevPDt09qZah
+SL0896+1DSJMwBGB7FY79tOi4lu3sgQiUpWAk2nojkxl8ZEDLXB0AuqLZxUpaVIC
+u9ffUGpVRr+goyhhf3DQw6KqLCGqR84onAZFdr+CGCe01a60y1Dma/RMhnEw6abf
+Fobg2P9A3fvQQoh/ozM6LlweQRGBY84YcWsr7KaKtzFcOmpH4MN5WdYgGq/yapiq
+crxXStJLnbsQ/LBMQeXtHT1eKJ2czL+zUdqnR+WEUwIDAQABo0IwQDAdBgNVHQ4E
+FgQUu69+Aj36pvE8hI6t7jiY7NkyMtQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB
+/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAArx1UaEt65Ru2yyTUEUAJNMnMvl
+wFTPoCWOAvn9sKIN9SCYPBMtrFaisNZ+EZLpLrqeLppysb0ZRGxhNaKatBYSaVqM
+4dc+pBroLwP0rmEdEBsqpIt6xf4FpuHA1sj+nq6PK7o9mfjYcwlYRm6mnPTXJ9OV
+2jeDchzTc+CiR5kDOF3VSXkAKRzH7JsgHAckaVd4sjn8OoSgtZx8jb8uk2Intzna
+FxiuvTwJaP+EmzzV1gsD41eeFPfR60/IvYcjt7ZJQ3mFXLrrkguhxuhoqEwWsRqZ
+CuhTLJK7oQkYdQxlqHvLI7cawiiFwxv/0Cti76R7CZGYZ4wUAc1oBmpjIXUDgIiK
+boHGhfKppC3n9KUkEEeDys30jXlYsQab5xoq2Z0B15R97QNKyvDb6KkBPvVWmcke
+jkk9u+UJueBPSZI9FoJAzMxZxuY67RIuaTxslbH9qh17f4a+Hg4yRvv7E491f0yL
+S0Zj/gA0QHDBw7mh3aZw4gSzQbzpgJHqZJx64SIDqZxubw5lT2yHh17zbqD5daWb
+QOhTsiedSrnAdyGN/4fy3ryM7xfft0kL0fJuMAsaDk527RH89elWsn2/x20Kk4yl
+0MC2Hb46TpSi125sC8KKfPog88Tk5c0NqMuRkrF8hey1FGlmDoLnzc7ILaZRfyHB
+NVOFBkpdn627G190
+-----END CERTIFICATE-----
+
+# Issuer: CN=USERTrust RSA Certification Authority O=The USERTRUST Network
+# Subject: CN=USERTrust RSA Certification Authority O=The USERTRUST Network
+# Label: "USERTrust RSA Certification Authority"
+# Serial: 2645093764781058787591871645665788717
+# MD5 Fingerprint: 1b:fe:69:d1:91:b7:19:33:a3:72:a8:0f:e1:55:e5:b5
+# SHA1 Fingerprint: 2b:8f:1b:57:33:0d:bb:a2:d0:7a:6c:51:f7:0e:e9:0d:da:b9:ad:8e
+# SHA256 Fingerprint: e7:93:c9:b0:2f:d8:aa:13:e2:1c:31:22:8a:cc:b0:81:19:64:3b:74:9c:89:89:64:b1:74:6d:46:c3:d4:cb:d2
+-----BEGIN CERTIFICATE-----
+MIIF3jCCA8agAwIBAgIQAf1tMPyjylGoG7xkDjUDLTANBgkqhkiG9w0BAQwFADCB
+iDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0pl
+cnNleSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNV
+BAMTJVVTRVJUcnVzdCBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAw
+MjAxMDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNV
+BAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVU
+aGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBSU0EgQ2Vy
+dGlmaWNhdGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK
+AoICAQCAEmUXNg7D2wiz0KxXDXbtzSfTTK1Qg2HiqiBNCS1kCdzOiZ/MPans9s/B
+3PHTsdZ7NygRK0faOca8Ohm0X6a9fZ2jY0K2dvKpOyuR+OJv0OwWIJAJPuLodMkY
+tJHUYmTbf6MG8YgYapAiPLz+E/CHFHv25B+O1ORRxhFnRghRy4YUVD+8M/5+bJz/
+Fp0YvVGONaanZshyZ9shZrHUm3gDwFA66Mzw3LyeTP6vBZY1H1dat//O+T23LLb2
+VN3I5xI6Ta5MirdcmrS3ID3KfyI0rn47aGYBROcBTkZTmzNg95S+UzeQc0PzMsNT
+79uq/nROacdrjGCT3sTHDN/hMq7MkztReJVni+49Vv4M0GkPGw/zJSZrM233bkf6
+c0Plfg6lZrEpfDKEY1WJxA3Bk1QwGROs0303p+tdOmw1XNtB1xLaqUkL39iAigmT
+Yo61Zs8liM2EuLE/pDkP2QKe6xJMlXzzawWpXhaDzLhn4ugTncxbgtNMs+1b/97l
+c6wjOy0AvzVVdAlJ2ElYGn+SNuZRkg7zJn0cTRe8yexDJtC/QV9AqURE9JnnV4ee
+UB9XVKg+/XRjL7FQZQnmWEIuQxpMtPAlR1n6BB6T1CZGSlCBst6+eLf8ZxXhyVeE
+Hg9j1uliutZfVS7qXMYoCAQlObgOK6nyTJccBz8NUvXt7y+CDwIDAQABo0IwQDAd
+BgNVHQ4EFgQUU3m/WqorSs9UgOHYm8Cd8rIDZsswDgYDVR0PAQH/BAQDAgEGMA8G
+A1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAFzUfA3P9wF9QZllDHPF
+Up/L+M+ZBn8b2kMVn54CVVeWFPFSPCeHlCjtHzoBN6J2/FNQwISbxmtOuowhT6KO
+VWKR82kV2LyI48SqC/3vqOlLVSoGIG1VeCkZ7l8wXEskEVX/JJpuXior7gtNn3/3
+ATiUFJVDBwn7YKnuHKsSjKCaXqeYalltiz8I+8jRRa8YFWSQEg9zKC7F4iRO/Fjs
+8PRF/iKz6y+O0tlFYQXBl2+odnKPi4w2r78NBc5xjeambx9spnFixdjQg3IM8WcR
+iQycE0xyNN+81XHfqnHd4blsjDwSXWXavVcStkNr/+XeTWYRUc+ZruwXtuhxkYze
+Sf7dNXGiFSeUHM9h4ya7b6NnJSFd5t0dCy5oGzuCr+yDZ4XUmFF0sbmZgIn/f3gZ
+XHlKYC6SQK5MNyosycdiyA5d9zZbyuAlJQG03RoHnHcAP9Dc1ew91Pq7P8yF1m9/
+qS3fuQL39ZeatTXaw2ewh0qpKJ4jjv9cJ2vhsE/zB+4ALtRZh8tSQZXq9EfX7mRB
+VXyNWQKV3WKdwrnuWih0hKWbt5DHDAff9Yk2dDLWKMGwsAvgnEzDHNb842m1R0aB
+L6KCq9NjRHDEjf8tM7qtj3u1cIiuPhnPQCjY/MiQu12ZIvVS5ljFH4gxQ+6IHdfG
+jjxDah2nGN59PRbxYvnKkKj9
+-----END CERTIFICATE-----
+
+# Issuer: CN=USERTrust ECC Certification Authority O=The USERTRUST Network
+# Subject: CN=USERTrust ECC Certification Authority O=The USERTRUST Network
+# Label: "USERTrust ECC Certification Authority"
+# Serial: 123013823720199481456569720443997572134
+# MD5 Fingerprint: fa:68:bc:d9:b5:7f:ad:fd:c9:1d:06:83:28:cc:24:c1
+# SHA1 Fingerprint: d1:cb:ca:5d:b2:d5:2a:7f:69:3b:67:4d:e5:f0:5a:1d:0c:95:7d:f0
+# SHA256 Fingerprint: 4f:f4:60:d5:4b:9c:86:da:bf:bc:fc:57:12:e0:40:0d:2b:ed:3f:bc:4d:4f:bd:aa:86:e0:6a:dc:d2:a9:ad:7a
+-----BEGIN CERTIFICATE-----
+MIICjzCCAhWgAwIBAgIQXIuZxVqUxdJxVt7NiYDMJjAKBggqhkjOPQQDAzCBiDEL
+MAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNl
+eSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMT
+JVVTRVJUcnVzdCBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMjAx
+MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgT
+Ck5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVUaGUg
+VVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBFQ0MgQ2VydGlm
+aWNhdGlvbiBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQarFRaqflo
+I+d61SRvU8Za2EurxtW20eZzca7dnNYMYf3boIkDuAUU7FfO7l0/4iGzzvfUinng
+o4N+LZfQYcTxmdwlkWOrfzCjtHDix6EznPO/LlxTsV+zfTJ/ijTjeXmjQjBAMB0G
+A1UdDgQWBBQ64QmG1M8ZwpZ2dEl23OA1xmNjmjAOBgNVHQ8BAf8EBAMCAQYwDwYD
+VR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjA2Z6EWCNzklwBBHU6+4WMB
+zzuqQhFkoJ2UOQIReVx7Hfpkue4WQrO/isIJxOzksU0CMQDpKmFHjFJKS04YcPbW
+RNZu9YO6bVi9JNlWSOrvxKJGgYhqOkbRqZtNyWHa0V1Xahg=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5
+# Label: "GlobalSign ECC Root CA - R5"
+# Serial: 32785792099990507226680698011560947931244
+# MD5 Fingerprint: 9f:ad:3b:1c:02:1e:8a:ba:17:74:38:81:0c:a2:bc:08
+# SHA1 Fingerprint: 1f:24:c6:30:cd:a4:18:ef:20:69:ff:ad:4f:dd:5f:46:3a:1b:69:aa
+# SHA256 Fingerprint: 17:9f:bc:14:8a:3d:d0:0f:d2:4e:a1:34:58:cc:43:bf:a7:f5:9c:81:82:d7:83:a5:13:f6:eb:ec:10:0c:89:24
+-----BEGIN CERTIFICATE-----
+MIICHjCCAaSgAwIBAgIRYFlJ4CYuu1X5CneKcflK2GwwCgYIKoZIzj0EAwMwUDEk
+MCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI1MRMwEQYDVQQKEwpH
+bG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWduMB4XDTEyMTExMzAwMDAwMFoX
+DTM4MDExOTAzMTQwN1owUDEkMCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBD
+QSAtIFI1MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWdu
+MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAER0UOlvt9Xb/pOdEh+J8LttV7HpI6SFkc
+8GIxLcB6KP4ap1yztsyX50XUWPrRd21DosCHZTQKH3rd6zwzocWdTaRvQZU4f8ke
+hOvRnkmSh5SHDDqFSmafnVmTTZdhBoZKo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYD
+VR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUPeYpSJvqB8ohREom3m7e0oPQn1kwCgYI
+KoZIzj0EAwMDaAAwZQIxAOVpEslu28YxuglB4Zf4+/2a4n0Sye18ZNPLBSWLVtmg
+515dTguDnFt2KaAJJiFqYgIwcdK1j1zqO+F4CYWodZI7yFz9SO8NdCKoCOJuxUnO
+xwy8p2Fp8fc74SrL+SvzZpA3
+-----END CERTIFICATE-----
+
+# Issuer: CN=IdenTrust Commercial Root CA 1 O=IdenTrust
+# Subject: CN=IdenTrust Commercial Root CA 1 O=IdenTrust
+# Label: "IdenTrust Commercial Root CA 1"
+# Serial: 13298821034946342390520003877796839426
+# MD5 Fingerprint: b3:3e:77:73:75:ee:a0:d3:e3:7e:49:63:49:59:bb:c7
+# SHA1 Fingerprint: df:71:7e:aa:4a:d9:4e:c9:55:84:99:60:2d:48:de:5f:bc:f0:3a:25
+# SHA256 Fingerprint: 5d:56:49:9b:e4:d2:e0:8b:cf:ca:d0:8a:3e:38:72:3d:50:50:3b:de:70:69:48:e4:2f:55:60:30:19:e5:28:ae
+-----BEGIN CERTIFICATE-----
+MIIFYDCCA0igAwIBAgIQCgFCgAAAAUUjyES1AAAAAjANBgkqhkiG9w0BAQsFADBK
+MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScwJQYDVQQDEx5JZGVu
+VHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwHhcNMTQwMTE2MTgxMjIzWhcNMzQw
+MTE2MTgxMjIzWjBKMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScw
+JQYDVQQDEx5JZGVuVHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQCnUBneP5k91DNG8W9RYYKyqU+PZ4ldhNlT
+3Qwo2dfw/66VQ3KZ+bVdfIrBQuExUHTRgQ18zZshq0PirK1ehm7zCYofWjK9ouuU
++ehcCuz/mNKvcbO0U59Oh++SvL3sTzIwiEsXXlfEU8L2ApeN2WIrvyQfYo3fw7gp
+S0l4PJNgiCL8mdo2yMKi1CxUAGc1bnO/AljwpN3lsKImesrgNqUZFvX9t++uP0D1
+bVoE/c40yiTcdCMbXTMTEl3EASX2MN0CXZ/g1Ue9tOsbobtJSdifWwLziuQkkORi
+T0/Br4sOdBeo0XKIanoBScy0RnnGF7HamB4HWfp1IYVl3ZBWzvurpWCdxJ35UrCL
+vYf5jysjCiN2O/cz4ckA82n5S6LgTrx+kzmEB/dEcH7+B1rlsazRGMzyNeVJSQjK
+Vsk9+w8YfYs7wRPCTY/JTw436R+hDmrfYi7LNQZReSzIJTj0+kuniVyc0uMNOYZK
+dHzVWYfCP04MXFL0PfdSgvHqo6z9STQaKPNBiDoT7uje/5kdX7rL6B7yuVBgwDHT
+c+XvvqDtMwt0viAgxGds8AgDelWAf0ZOlqf0Hj7h9tgJ4TNkK2PXMl6f+cB7D3hv
+l7yTmvmcEpB4eoCHFddydJxVdHixuuFucAS6T6C6aMN7/zHwcz09lCqxC0EOoP5N
+iGVreTO01wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB
+/zAdBgNVHQ4EFgQU7UQZwNPwBovupHu+QucmVMiONnYwDQYJKoZIhvcNAQELBQAD
+ggIBAA2ukDL2pkt8RHYZYR4nKM1eVO8lvOMIkPkp165oCOGUAFjvLi5+U1KMtlwH
+6oi6mYtQlNeCgN9hCQCTrQ0U5s7B8jeUeLBfnLOic7iPBZM4zY0+sLj7wM+x8uwt
+LRvM7Kqas6pgghstO8OEPVeKlh6cdbjTMM1gCIOQ045U8U1mwF10A0Cj7oV+wh93
+nAbowacYXVKV7cndJZ5t+qntozo00Fl72u1Q8zW/7esUTTHHYPTa8Yec4kjixsU3
++wYQ+nVZZjFHKdp2mhzpgq7vmrlR94gjmmmVYjzlVYA211QC//G5Xc7UI2/YRYRK
+W2XviQzdFKcgyxilJbQN+QHwotL0AMh0jqEqSI5l2xPE4iUXfeu+h1sXIFRRk0pT
+AwvsXcoz7WL9RccvW9xYoIA55vrX/hMUpu09lEpCdNTDd1lzzY9GvlU47/rokTLq
+l1gEIt44w8y8bckzOmoKaT+gyOpyj4xjhiO9bTyWnpXgSUyqorkqG5w2gXjtw+hG
+4iZZRHUe2XWJUc0QhJ1hYMtd+ZciTY6Y5uN/9lu7rs3KSoFrXgvzUeF0K+l+J6fZ
+mUlO+KWA2yUPHGNiiskzZ2s8EIPGrd6ozRaOjfAHN3Gf8qv8QfXBi+wAN10J5U6A
+7/qxXDgGpRtK4dw4LTzcqx+QGtVKnO7RcGzM7vRX+Bi6hG6H
+-----END CERTIFICATE-----
+
+# Issuer: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust
+# Subject: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust
+# Label: "IdenTrust Public Sector Root CA 1"
+# Serial: 13298821034946342390521976156843933698
+# MD5 Fingerprint: 37:06:a5:b0:fc:89:9d:ba:f4:6b:8c:1a:64:cd:d5:ba
+# SHA1 Fingerprint: ba:29:41:60:77:98:3f:f4:f3:ef:f2:31:05:3b:2e:ea:6d:4d:45:fd
+# SHA256 Fingerprint: 30:d0:89:5a:9a:44:8a:26:20:91:63:55:22:d1:f5:20:10:b5:86:7a:ca:e1:2c:78:ef:95:8f:d4:f4:38:9f:2f
+-----BEGIN CERTIFICATE-----
+MIIFZjCCA06gAwIBAgIQCgFCgAAAAUUjz0Z8AAAAAjANBgkqhkiG9w0BAQsFADBN
+MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MSowKAYDVQQDEyFJZGVu
+VHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwHhcNMTQwMTE2MTc1MzMyWhcN
+MzQwMTE2MTc1MzMyWjBNMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0
+MSowKAYDVQQDEyFJZGVuVHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwggIi
+MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC2IpT8pEiv6EdrCvsnduTyP4o7
+ekosMSqMjbCpwzFrqHd2hCa2rIFCDQjrVVi7evi8ZX3yoG2LqEfpYnYeEe4IFNGy
+RBb06tD6Hi9e28tzQa68ALBKK0CyrOE7S8ItneShm+waOh7wCLPQ5CQ1B5+ctMlS
+bdsHyo+1W/CD80/HLaXIrcuVIKQxKFdYWuSNG5qrng0M8gozOSI5Cpcu81N3uURF
+/YTLNiCBWS2ab21ISGHKTN9T0a9SvESfqy9rg3LvdYDaBjMbXcjaY8ZNzaxmMc3R
+3j6HEDbhuaR672BQssvKplbgN6+rNBM5Jeg5ZuSYeqoSmJxZZoY+rfGwyj4GD3vw
+EUs3oERte8uojHH01bWRNszwFcYr3lEXsZdMUD2xlVl8BX0tIdUAvwFnol57plzy
+9yLxkA2T26pEUWbMfXYD62qoKjgZl3YNa4ph+bz27nb9cCvdKTz4Ch5bQhyLVi9V
+GxyhLrXHFub4qjySjmm2AcG1hp2JDws4lFTo6tyePSW8Uybt1as5qsVATFSrsrTZ
+2fjXctscvG29ZV/viDUqZi/u9rNl8DONfJhBaUYPQxxp+pu10GFqzcpL2UyQRqsV
+WaFHVCkugyhfHMKiq3IXAAaOReyL4jM9f9oZRORicsPfIsbyVtTdX5Vy7W1f90gD
+W/3FKqD2cyOEEBsB5wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/
+BAUwAwEB/zAdBgNVHQ4EFgQU43HgntinQtnbcZFrlJPrw6PRFKMwDQYJKoZIhvcN
+AQELBQADggIBAEf63QqwEZE4rU1d9+UOl1QZgkiHVIyqZJnYWv6IAcVYpZmxI1Qj
+t2odIFflAWJBF9MJ23XLblSQdf4an4EKwt3X9wnQW3IV5B4Jaj0z8yGa5hV+rVHV
+DRDtfULAj+7AmgjVQdZcDiFpboBhDhXAuM/FSRJSzL46zNQuOAXeNf0fb7iAaJg9
+TaDKQGXSc3z1i9kKlT/YPyNtGtEqJBnZhbMX73huqVjRI9PHE+1yJX9dsXNw0H8G
+lwmEKYBhHfpe/3OsoOOJuBxxFcbeMX8S3OFtm6/n6J91eEyrRjuazr8FGF1NFTwW
+mhlQBJqymm9li1JfPFgEKCXAZmExfrngdbkaqIHWchezxQMxNRF4eKLg6TCMf4Df
+WN88uieW4oA0beOY02QnrEh+KHdcxiVhJfiFDGX6xDIvpZgF5PgLZxYWxoK4Mhn5
++bl53B/N66+rDt0b20XkeucC4pVd/GnwU2lhlXV5C15V5jgclKlZM57IcXR5f1GJ
+tshquDDIajjDbp7hNxbqBWJMWxJH7ae0s1hWx0nzfxJoCTFx8G34Tkf71oXuxVhA
+GaQdp/lLQzfcaFpPz+vCZHTetBXZ9FRUGi8c15dxVJCO2SCdUyt/q4/i6jC8UDfv
+8Ue1fXwsBOxonbRJRBD0ckscZOf85muQ3Wl9af0AVqW3rLatt8o+Ae+c
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only
+# Subject: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only
+# Label: "Entrust Root Certification Authority - G2"
+# Serial: 1246989352
+# MD5 Fingerprint: 4b:e2:c9:91:96:65:0c:f4:0e:5a:93:92:a0:0a:fe:b2
+# SHA1 Fingerprint: 8c:f4:27:fd:79:0c:3a:d1:66:06:8d:e8:1e:57:ef:bb:93:22:72:d4
+# SHA256 Fingerprint: 43:df:57:74:b0:3e:7f:ef:5f:e4:0d:93:1a:7b:ed:f1:bb:2e:6b:42:73:8c:4e:6d:38:41:10:3d:3a:a7:f3:39
+-----BEGIN CERTIFICATE-----
+MIIEPjCCAyagAwIBAgIESlOMKDANBgkqhkiG9w0BAQsFADCBvjELMAkGA1UEBhMC
+VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50
+cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3Qs
+IEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVz
+dCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRzIwHhcNMDkwNzA3MTcy
+NTU0WhcNMzAxMjA3MTc1NTU0WjCBvjELMAkGA1UEBhMCVVMxFjAUBgNVBAoTDUVu
+dHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50cnVzdC5uZXQvbGVnYWwt
+dGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3QsIEluYy4gLSBmb3IgYXV0
+aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVzdCBSb290IENlcnRpZmlj
+YXRpb24gQXV0aG9yaXR5IC0gRzIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK
+AoIBAQC6hLZy254Ma+KZ6TABp3bqMriVQRrJ2mFOWHLP/vaCeb9zYQYKpSfYs1/T
+RU4cctZOMvJyig/3gxnQaoCAAEUesMfnmr8SVycco2gvCoe9amsOXmXzHHfV1IWN
+cCG0szLni6LVhjkCsbjSR87kyUnEO6fe+1R9V77w6G7CebI6C1XiUJgWMhNcL3hW
+wcKUs/Ja5CeanyTXxuzQmyWC48zCxEXFjJd6BmsqEZ+pCm5IO2/b1BEZQvePB7/1
+U1+cPvQXLOZprE4yTGJ36rfo5bs0vBmLrpxR57d+tVOxMyLlbc9wPBr64ptntoP0
+jaWvYkxN4FisZDQSA/i2jZRjJKRxAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAP
+BgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqciZ60B7vfec7aVHUbI2fkBJmqzAN
+BgkqhkiG9w0BAQsFAAOCAQEAeZ8dlsa2eT8ijYfThwMEYGprmi5ZiXMRrEPR9RP/
+jTkrwPK9T3CMqS/qF8QLVJ7UG5aYMzyorWKiAHarWWluBh1+xLlEjZivEtRh2woZ
+Rkfz6/djwUAFQKXSt/S1mja/qYh2iARVBCuch38aNzx+LaUa2NSJXsq9rD1s2G2v
+1fN2D807iDginWyTmsQ9v4IbZT+mD12q/OWyFcq1rca8PdCE6OoGcrBNOTJ4vz4R
+nAuknZoh8/CbCzB428Hch0P+vGOaysXCHMnHjf87ElgI5rY97HosTvuDls4MPGmH
+VHOkc8KT/1EQrBVUAdj8BbGJoX90g5pJ19xOe4pIb4tF9g==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only
+# Subject: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only
+# Label: "Entrust Root Certification Authority - EC1"
+# Serial: 51543124481930649114116133369
+# MD5 Fingerprint: b6:7e:1d:f0:58:c5:49:6c:24:3b:3d:ed:98:18:ed:bc
+# SHA1 Fingerprint: 20:d8:06:40:df:9b:25:f5:12:25:3a:11:ea:f7:59:8a:eb:14:b5:47
+# SHA256 Fingerprint: 02:ed:0e:b2:8c:14:da:45:16:5c:56:67:91:70:0d:64:51:d7:fb:56:f0:b2:ab:1d:3b:8e:b0:70:e5:6e:df:f5
+-----BEGIN CERTIFICATE-----
+MIIC+TCCAoCgAwIBAgINAKaLeSkAAAAAUNCR+TAKBggqhkjOPQQDAzCBvzELMAkG
+A1UEBhMCVVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3
+d3cuZW50cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDEyIEVu
+dHJ1c3QsIEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEzMDEGA1UEAxMq
+RW50cnVzdCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRUMxMB4XDTEy
+MTIxODE1MjUzNloXDTM3MTIxODE1NTUzNlowgb8xCzAJBgNVBAYTAlVTMRYwFAYD
+VQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1c3QubmV0
+L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxMiBFbnRydXN0LCBJbmMuIC0g
+Zm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMzAxBgNVBAMTKkVudHJ1c3QgUm9vdCBD
+ZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEVDMTB2MBAGByqGSM49AgEGBSuBBAAi
+A2IABIQTydC6bUF74mzQ61VfZgIaJPRbiWlH47jCffHyAsWfoPZb1YsGGYZPUxBt
+ByQnoaD41UcZYUx9ypMn6nQM72+WCf5j7HBdNq1nd67JnXxVRDqiY1Ef9eNi1KlH
+Bz7MIKNCMEAwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0O
+BBYEFLdj5xrdjekIplWDpOBqUEFlEUJJMAoGCCqGSM49BAMDA2cAMGQCMGF52OVC
+R98crlOZF7ZvHH3hvxGU0QOIdeSNiaSKd0bebWHvAvX7td/M/k7//qnmpwIwW5nX
+hTcGtXsI/esni0qU+eH6p44mCOh8kmhtc9hvJqwhAriZtyZBWyVgrtBIGu4G
+-----END CERTIFICATE-----
+
+# Issuer: CN=CFCA EV ROOT O=China Financial Certification Authority
+# Subject: CN=CFCA EV ROOT O=China Financial Certification Authority
+# Label: "CFCA EV ROOT"
+# Serial: 407555286
+# MD5 Fingerprint: 74:e1:b6:ed:26:7a:7a:44:30:33:94:ab:7b:27:81:30
+# SHA1 Fingerprint: e2:b8:29:4b:55:84:ab:6b:58:c2:90:46:6c:ac:3f:b8:39:8f:84:83
+# SHA256 Fingerprint: 5c:c3:d7:8e:4e:1d:5e:45:54:7a:04:e6:87:3e:64:f9:0c:f9:53:6d:1c:cc:2e:f8:00:f3:55:c4:c5:fd:70:fd
+-----BEGIN CERTIFICATE-----
+MIIFjTCCA3WgAwIBAgIEGErM1jANBgkqhkiG9w0BAQsFADBWMQswCQYDVQQGEwJD
+TjEwMC4GA1UECgwnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9y
+aXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJPT1QwHhcNMTIwODA4MDMwNzAxWhcNMjkx
+MjMxMDMwNzAxWjBWMQswCQYDVQQGEwJDTjEwMC4GA1UECgwnQ2hpbmEgRmluYW5j
+aWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJP
+T1QwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDXXWvNED8fBVnVBU03
+sQ7smCuOFR36k0sXgiFxEFLXUWRwFsJVaU2OFW2fvwwbwuCjZ9YMrM8irq93VCpL
+TIpTUnrD7i7es3ElweldPe6hL6P3KjzJIx1qqx2hp/Hz7KDVRM8Vz3IvHWOX6Jn5
+/ZOkVIBMUtRSqy5J35DNuF++P96hyk0g1CXohClTt7GIH//62pCfCqktQT+x8Rgp
+7hZZLDRJGqgG16iI0gNyejLi6mhNbiyWZXvKWfry4t3uMCz7zEasxGPrb382KzRz
+EpR/38wmnvFyXVBlWY9ps4deMm/DGIq1lY+wejfeWkU7xzbh72fROdOXW3NiGUgt
+hxwG+3SYIElz8AXSG7Ggo7cbcNOIabla1jj0Ytwli3i/+Oh+uFzJlU9fpy25IGvP
+a931DfSCt/SyZi4QKPaXWnuWFo8BGS1sbn85WAZkgwGDg8NNkt0yxoekN+kWzqot
+aK8KgWU6cMGbrU1tVMoqLUuFG7OA5nBFDWteNfB/O7ic5ARwiRIlk9oKmSJgamNg
+TnYGmE69g60dWIolhdLHZR4tjsbftsbhf4oEIRUpdPA+nJCdDC7xij5aqgwJHsfV
+PKPtl8MeNPo4+QgO48BdK4PRVmrJtqhUUy54Mmc9gn900PvhtgVguXDbjgv5E1hv
+cWAQUhC5wUEJ73IfZzF4/5YFjQIDAQABo2MwYTAfBgNVHSMEGDAWgBTj/i39KNAL
+tbq2osS/BqoFjJP7LzAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAd
+BgNVHQ4EFgQU4/4t/SjQC7W6tqLEvwaqBYyT+y8wDQYJKoZIhvcNAQELBQADggIB
+ACXGumvrh8vegjmWPfBEp2uEcwPenStPuiB/vHiyz5ewG5zz13ku9Ui20vsXiObT
+ej/tUxPQ4i9qecsAIyjmHjdXNYmEwnZPNDatZ8POQQaIxffu2Bq41gt/UP+TqhdL
+jOztUmCypAbqTuv0axn96/Ua4CUqmtzHQTb3yHQFhDmVOdYLO6Qn+gjYXB74BGBS
+ESgoA//vU2YApUo0FmZ8/Qmkrp5nGm9BC2sGE5uPhnEFtC+NiWYzKXZUmhH4J/qy
+P5Hgzg0b8zAarb8iXRvTvyUFTeGSGn+ZnzxEk8rUQElsgIfXBDrDMlI1Dlb4pd19
+xIsNER9Tyx6yF7Zod1rg1MvIB671Oi6ON7fQAUtDKXeMOZePglr4UeWJoBjnaH9d
+Ci77o0cOPaYjesYBx4/IXr9tgFa+iiS6M+qf4TIRnvHST4D2G0CvOJ4RUHlzEhLN
+5mydLIhyPDCBBpEi6lmt2hkuIsKNuYyH4Ga8cyNfIWRjgEj1oDwYPZTISEEdQLpe
+/v5WOaHIz16eGWRGENoXkbcFgKyLmZJ956LYBws2J+dIeWCKw9cTXPhyQN9Ky8+Z
+AAoACxGV2lZFA4gKn2fQ1XmxqI1AbQ3CekD6819kR5LLU7m7Wc5P/dAVUwHY3+vZ
+5nbv0CO7O6l5s9UCKc2Jo5YPSjXnTkLAdc0Hz+Ys63su
+-----END CERTIFICATE-----
+
+# Issuer: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed
+# Subject: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed
+# Label: "OISTE WISeKey Global Root GB CA"
+# Serial: 157768595616588414422159278966750757568
+# MD5 Fingerprint: a4:eb:b9:61:28:2e:b7:2f:98:b0:35:26:90:99:51:1d
+# SHA1 Fingerprint: 0f:f9:40:76:18:d3:d7:6a:4b:98:f0:a8:35:9e:0c:fd:27:ac:cc:ed
+# SHA256 Fingerprint: 6b:9c:08:e8:6e:b0:f7:67:cf:ad:65:cd:98:b6:21:49:e5:49:4a:67:f5:84:5e:7b:d1:ed:01:9f:27:b8:6b:d6
+-----BEGIN CERTIFICATE-----
+MIIDtTCCAp2gAwIBAgIQdrEgUnTwhYdGs/gjGvbCwDANBgkqhkiG9w0BAQsFADBt
+MQswCQYDVQQGEwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUg
+Rm91bmRhdGlvbiBFbmRvcnNlZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9i
+YWwgUm9vdCBHQiBDQTAeFw0xNDEyMDExNTAwMzJaFw0zOTEyMDExNTEwMzFaMG0x
+CzAJBgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQLExlPSVNURSBG
+b3VuZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2Jh
+bCBSb290IEdCIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2Be3
+HEokKtaXscriHvt9OO+Y9bI5mE4nuBFde9IllIiCFSZqGzG7qFshISvYD06fWvGx
+WuR51jIjK+FTzJlFXHtPrby/h0oLS5daqPZI7H17Dc0hBt+eFf1Biki3IPShehtX
+1F1Q/7pn2COZH8g/497/b1t3sWtuuMlk9+HKQUYOKXHQuSP8yYFfTvdv37+ErXNk
+u7dCjmn21HYdfp2nuFeKUWdy19SouJVUQHMD9ur06/4oQnc/nSMbsrY9gBQHTC5P
+99UKFg29ZkM3fiNDecNAhvVMKdqOmq0NpQSHiB6F4+lT1ZvIiwNjeOvgGUpuuy9r
+M2RYk61pv48b74JIxwIDAQABo1EwTzALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUw
+AwEB/zAdBgNVHQ4EFgQUNQ/INmNe4qPs+TtmFc5RUuORmj0wEAYJKwYBBAGCNxUB
+BAMCAQAwDQYJKoZIhvcNAQELBQADggEBAEBM+4eymYGQfp3FsLAmzYh7KzKNbrgh
+cViXfa43FK8+5/ea4n32cZiZBKpDdHij40lhPnOMTZTg+XHEthYOU3gf1qKHLwI5
+gSk8rxWYITD+KJAAjNHhy/peyP34EEY7onhCkRd0VQreUGdNZtGn//3ZwLWoo4rO
+ZvUPQ82nK1d7Y0Zqqi5S2PTt4W2tKZB4SLrhI6qjiey1q5bAtEuiHZeeevJuQHHf
+aPFlTc58Bd9TZaml8LGXBHAVRgOY1NK/VLSgWH1Sb9pWJmLU2NuJMW8c8CLC02Ic
+Nc1MaRVUGpCY3useX8p3x8uOPUNpnJpY0CQ73xtAln41rYHHTnG6iBM=
+-----END CERTIFICATE-----
+
+# Issuer: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A.
+# Subject: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A.
+# Label: "SZAFIR ROOT CA2"
+# Serial: 357043034767186914217277344587386743377558296292
+# MD5 Fingerprint: 11:64:c1:89:b0:24:b1:8c:b1:07:7e:89:9e:51:9e:99
+# SHA1 Fingerprint: e2:52:fa:95:3f:ed:db:24:60:bd:6e:28:f3:9c:cc:cf:5e:b3:3f:de
+# SHA256 Fingerprint: a1:33:9d:33:28:1a:0b:56:e5:57:d3:d3:2b:1c:e7:f9:36:7e:b0:94:bd:5f:a7:2a:7e:50:04:c8:de:d7:ca:fe
+-----BEGIN CERTIFICATE-----
+MIIDcjCCAlqgAwIBAgIUPopdB+xV0jLVt+O2XwHrLdzk1uQwDQYJKoZIhvcNAQEL
+BQAwUTELMAkGA1UEBhMCUEwxKDAmBgNVBAoMH0tyYWpvd2EgSXpiYSBSb3psaWN6
+ZW5pb3dhIFMuQS4xGDAWBgNVBAMMD1NaQUZJUiBST09UIENBMjAeFw0xNTEwMTkw
+NzQzMzBaFw0zNTEwMTkwNzQzMzBaMFExCzAJBgNVBAYTAlBMMSgwJgYDVQQKDB9L
+cmFqb3dhIEl6YmEgUm96bGljemVuaW93YSBTLkEuMRgwFgYDVQQDDA9TWkFGSVIg
+Uk9PVCBDQTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC3vD5QqEvN
+QLXOYeeWyrSh2gwisPq1e3YAd4wLz32ohswmUeQgPYUM1ljj5/QqGJ3a0a4m7utT
+3PSQ1hNKDJA8w/Ta0o4NkjrcsbH/ON7Dui1fgLkCvUqdGw+0w8LBZwPd3BucPbOw
+3gAeqDRHu5rr/gsUvTaE2g0gv/pby6kWIK05YO4vdbbnl5z5Pv1+TW9NL++IDWr6
+3fE9biCloBK0TXC5ztdyO4mTp4CEHCdJckm1/zuVnsHMyAHs6A6KCpbns6aH5db5
+BSsNl0BwPLqsdVqc1U2dAgrSS5tmS0YHF2Wtn2yIANwiieDhZNRnvDF5YTy7ykHN
+XGoAyDw4jlivAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD
+AgEGMB0GA1UdDgQWBBQuFqlKGLXLzPVvUPMjX/hd56zwyDANBgkqhkiG9w0BAQsF
+AAOCAQEAtXP4A9xZWx126aMqe5Aosk3AM0+qmrHUuOQn/6mWmc5G4G18TKI4pAZw
+8PRBEew/R40/cof5O/2kbytTAOD/OblqBw7rHRz2onKQy4I9EYKL0rufKq8h5mOG
+nXkZ7/e7DDWQw4rtTw/1zBLZpD67oPwglV9PJi8RI4NOdQcPv5vRtB3pEAT+ymCP
+oky4rc/hkA/NrgrHXXu3UNLUYfrVFdvXn4dRVOul4+vJhaAlIDf7js4MNIThPIGy
+d05DpYhfhmehPea0XGG2Ptv+tyjFogeutcrKjSoS75ftwjCkySp6+/NNIxuZMzSg
+LvWpCz/UXeHPhJ/iGcJfitYgHuNztw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority
+# Subject: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority
+# Label: "Certum Trusted Network CA 2"
+# Serial: 44979900017204383099463764357512596969
+# MD5 Fingerprint: 6d:46:9e:d9:25:6d:08:23:5b:5e:74:7d:1e:27:db:f2
+# SHA1 Fingerprint: d3:dd:48:3e:2b:bf:4c:05:e8:af:10:f5:fa:76:26:cf:d3:dc:30:92
+# SHA256 Fingerprint: b6:76:f2:ed:da:e8:77:5c:d3:6c:b0:f6:3c:d1:d4:60:39:61:f4:9e:62:65:ba:01:3a:2f:03:07:b6:d0:b8:04
+-----BEGIN CERTIFICATE-----
+MIIF0jCCA7qgAwIBAgIQIdbQSk8lD8kyN/yqXhKN6TANBgkqhkiG9w0BAQ0FADCB
+gDELMAkGA1UEBhMCUEwxIjAgBgNVBAoTGVVuaXpldG8gVGVjaG5vbG9naWVzIFMu
+QS4xJzAlBgNVBAsTHkNlcnR1bSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEkMCIG
+A1UEAxMbQ2VydHVtIFRydXN0ZWQgTmV0d29yayBDQSAyMCIYDzIwMTExMDA2MDgz
+OTU2WhgPMjA0NjEwMDYwODM5NTZaMIGAMQswCQYDVQQGEwJQTDEiMCAGA1UEChMZ
+VW5pemV0byBUZWNobm9sb2dpZXMgUy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRp
+ZmljYXRpb24gQXV0aG9yaXR5MSQwIgYDVQQDExtDZXJ0dW0gVHJ1c3RlZCBOZXR3
+b3JrIENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC9+Xj45tWA
+DGSdhhuWZGc/IjoedQF97/tcZ4zJzFxrqZHmuULlIEub2pt7uZld2ZuAS9eEQCsn
+0+i6MLs+CRqnSZXvK0AkwpfHp+6bJe+oCgCXhVqqndwpyeI1B+twTUrWwbNWuKFB
+OJvR+zF/j+Bf4bE/D44WSWDXBo0Y+aomEKsq09DRZ40bRr5HMNUuctHFY9rnY3lE
+fktjJImGLjQ/KUxSiyqnwOKRKIm5wFv5HdnnJ63/mgKXwcZQkpsCLL2puTRZCr+E
+Sv/f/rOf69me4Jgj7KZrdxYq28ytOxykh9xGc14ZYmhFV+SQgkK7QtbwYeDBoz1m
+o130GO6IyY0XRSmZMnUCMe4pJshrAua1YkV/NxVaI2iJ1D7eTiew8EAMvE0Xy02i
+sx7QBlrd9pPPV3WZ9fqGGmd4s7+W/jTcvedSVuWz5XV710GRBdxdaeOVDUO5/IOW
+OZV7bIBaTxNyxtd9KXpEulKkKtVBRgkg/iKgtlswjbyJDNXXcPiHUv3a76xRLgez
+Tv7QCdpw75j6VuZt27VXS9zlLCUVyJ4ueE742pyehizKV/Ma5ciSixqClnrDvFAS
+adgOWkaLOusm+iPJtrCBvkIApPjW/jAux9JG9uWOdf3yzLnQh1vMBhBgu4M1t15n
+3kfsmUjxpKEV/q2MYo45VU85FrmxY53/twIDAQABo0IwQDAPBgNVHRMBAf8EBTAD
+AQH/MB0GA1UdDgQWBBS2oVQ5AsOgP46KvPrU+Bym0ToO/TAOBgNVHQ8BAf8EBAMC
+AQYwDQYJKoZIhvcNAQENBQADggIBAHGlDs7k6b8/ONWJWsQCYftMxRQXLYtPU2sQ
+F/xlhMcQSZDe28cmk4gmb3DWAl45oPePq5a1pRNcgRRtDoGCERuKTsZPpd1iHkTf
+CVn0W3cLN+mLIMb4Ck4uWBzrM9DPhmDJ2vuAL55MYIR4PSFk1vtBHxgP58l1cb29
+XN40hz5BsA72udY/CROWFC/emh1auVbONTqwX3BNXuMp8SMoclm2q8KMZiYcdywm
+djWLKKdpoPk79SPdhRB0yZADVpHnr7pH1BKXESLjokmUbOe3lEu6LaTaM4tMpkT/
+WjzGHWTYtTHkpjx6qFcL2+1hGsvxznN3Y6SHb0xRONbkX8eftoEq5IVIeVheO/jb
+AoJnwTnbw3RLPTYe+SmTiGhbqEQZIfCn6IENLOiTNrQ3ssqwGyZ6miUfmpqAnksq
+P/ujmv5zMnHCnsZy4YpoJ/HkD7TETKVhk/iXEAcqMCWpuchxuO9ozC1+9eB+D4Ko
+b7a6bINDd82Kkhehnlt4Fj1F4jNy3eFmypnTycUm/Q1oBEauttmbjL4ZvrHG8hnj
+XALKLNhvSgfZyTXaQHXyxKcZb55CEJh15pWLYLztxRLXis7VmFxWlgPF7ncGNf/P
+5O4/E2Hu29othfDNrp2yGAlFw5Khchf8R7agCyzxxN5DaAhqXzvwdmP7zAYspsbi
+DrW5viSP
+-----END CERTIFICATE-----
+
+# Issuer: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
+# Subject: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
+# Label: "Hellenic Academic and Research Institutions RootCA 2015"
+# Serial: 0
+# MD5 Fingerprint: ca:ff:e2:db:03:d9:cb:4b:e9:0f:ad:84:fd:7b:18:ce
+# SHA1 Fingerprint: 01:0c:06:95:a6:98:19:14:ff:bf:5f:c6:b0:b6:95:ea:29:e9:12:a6
+# SHA256 Fingerprint: a0:40:92:9a:02:ce:53:b4:ac:f4:f2:ff:c6:98:1c:e4:49:6f:75:5e:6d:45:fe:0b:2a:69:2b:cd:52:52:3f:36
+-----BEGIN CERTIFICATE-----
+MIIGCzCCA/OgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBpjELMAkGA1UEBhMCR1Ix
+DzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5k
+IFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxQDA+BgNVBAMT
+N0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgUm9v
+dENBIDIwMTUwHhcNMTUwNzA3MTAxMTIxWhcNNDAwNjMwMTAxMTIxWjCBpjELMAkG
+A1UEBhMCR1IxDzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNh
+ZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkx
+QDA+BgNVBAMTN0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1
+dGlvbnMgUm9vdENBIDIwMTUwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC
+AQDC+Kk/G4n8PDwEXT2QNrCROnk8ZlrvbTkBSRq0t89/TSNTt5AA4xMqKKYx8ZEA
+4yjsriFBzh/a/X0SWwGDD7mwX5nh8hKDgE0GPt+sr+ehiGsxr/CL0BgzuNtFajT0
+AoAkKAoCFZVedioNmToUW/bLy1O8E00BiDeUJRtCvCLYjqOWXjrZMts+6PAQZe10
+4S+nfK8nNLspfZu2zwnI5dMK/IhlZXQK3HMcXM1AsRzUtoSMTFDPaI6oWa7CJ06C
+ojXdFPQf/7J31Ycvqm59JCfnxssm5uX+Zwdj2EUN3TpZZTlYepKZcj2chF6IIbjV
+9Cz82XBST3i4vTwri5WY9bPRaM8gFH5MXF/ni+X1NYEZN9cRCLdmvtNKzoNXADrD
+gfgXy5I2XdGj2HUb4Ysn6npIQf1FGQatJ5lOwXBH3bWfgVMS5bGMSF0xQxfjjMZ6
+Y5ZLKTBOhE5iGV48zpeQpX8B653g+IuJ3SWYPZK2fu/Z8VFRfS0myGlZYeCsargq
+NhEEelC9MoS+L9xy1dcdFkfkR2YgP/SWxa+OAXqlD3pk9Q0Yh9muiNX6hME6wGko
+LfINaFGq46V3xqSQDqE3izEjR8EJCOtu93ib14L8hCCZSRm2Ekax+0VVFqmjZayc
+Bw/qa9wfLgZy7IaIEuQt218FL+TwA9MmM+eAws1CoRc0CwIDAQABo0IwQDAPBgNV
+HRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUcRVnyMjJvXVd
+ctA4GGqd83EkVAswDQYJKoZIhvcNAQELBQADggIBAHW7bVRLqhBYRjTyYtcWNl0I
+XtVsyIe9tC5G8jH4fOpCtZMWVdyhDBKg2mF+D1hYc2Ryx+hFjtyp8iY/xnmMsVMI
+M4GwVhO+5lFc2JsKT0ucVlMC6U/2DWDqTUJV6HwbISHTGzrMd/K4kPFox/la/vot
+9L/J9UUbzjgQKjeKeaO04wlshYaT/4mWJ3iBj2fjRnRUjtkNaeJK9E10A/+yd+2V
+Z5fkscWrv2oj6NSU4kQoYsRL4vDY4ilrGnB+JGGTe08DMiUNRSQrlrRGar9KC/ea
+j8GsGsVn82800vpzY4zvFrCopEYq+OsS7HK07/grfoxSwIuEVPkvPuNVqNxmsdnh
+X9izjFk0WaSrT2y7HxjbdavYy5LNlDhhDgcGH0tGEPEVvo2FXDtKK4F5D7Rpn0lQ
+l033DlZdwJVqwjbDG2jJ9SrcR5q+ss7FJej6A7na+RZukYT1HCjI/CbM1xyQVqdf
+bzoEvM14iQuODy+jqk+iGxI9FghAD/FGTNeqewjBCvVtJ94Cj8rDtSvK6evIIVM4
+pcw72Hc3MKJP2W/R8kCtQXoXxdZKNYm3QdV8hn9VTYNKpXMgwDqvkPGaJI7ZjnHK
+e7iG2rKPmT4dEw0SEe7Uq/DpFXYC5ODfqiAeW2GFZECpkJcNrVPSWh2HagCXZWK0
+vm9qp/UsQu0yrbYhnr68
+-----END CERTIFICATE-----
+
+# Issuer: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
+# Subject: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
+# Label: "Hellenic Academic and Research Institutions ECC RootCA 2015"
+# Serial: 0
+# MD5 Fingerprint: 81:e5:b4:17:eb:c2:f5:e1:4b:0d:41:7b:49:92:fe:ef
+# SHA1 Fingerprint: 9f:f1:71:8d:92:d5:9a:f3:7d:74:97:b4:bc:6f:84:68:0b:ba:b6:66
+# SHA256 Fingerprint: 44:b5:45:aa:8a:25:e6:5a:73:ca:15:dc:27:fc:36:d2:4c:1c:b9:95:3a:06:65:39:b1:15:82:dc:48:7b:48:33
+-----BEGIN CERTIFICATE-----
+MIICwzCCAkqgAwIBAgIBADAKBggqhkjOPQQDAjCBqjELMAkGA1UEBhMCR1IxDzAN
+BgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl
+c2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxRDBCBgNVBAMTO0hl
+bGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgRUNDIFJv
+b3RDQSAyMDE1MB4XDTE1MDcwNzEwMzcxMloXDTQwMDYzMDEwMzcxMlowgaoxCzAJ
+BgNVBAYTAkdSMQ8wDQYDVQQHEwZBdGhlbnMxRDBCBgNVBAoTO0hlbGxlbmljIEFj
+YWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ2VydC4gQXV0aG9yaXR5
+MUQwQgYDVQQDEztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0
+dXRpb25zIEVDQyBSb290Q0EgMjAxNTB2MBAGByqGSM49AgEGBSuBBAAiA2IABJKg
+QehLgoRc4vgxEZmGZE4JJS+dQS8KrjVPdJWyUWRrjWvmP3CV8AVER6ZyOFB2lQJa
+jq4onvktTpnvLEhvTCUp6NFxW98dwXU3tNf6e3pCnGoKVlp8aQuqgAkkbH7BRqNC
+MEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFLQi
+C4KZJAEOnLvkDv2/+5cgk5kqMAoGCCqGSM49BAMCA2cAMGQCMGfOFmI4oqxiRaep
+lSTAGiecMjvAwNW6qef4BENThe5SId6d9SWDPp5YSy/XZxMOIQIwBeF1Ad5o7Sof
+TUwJCA3sS61kFyjndc5FZXIhF8siQQ6ME5g4mlRtm8rifOoCWCKR
+-----END CERTIFICATE-----
+
+# Issuer: CN=ISRG Root X1 O=Internet Security Research Group
+# Subject: CN=ISRG Root X1 O=Internet Security Research Group
+# Label: "ISRG Root X1"
+# Serial: 172886928669790476064670243504169061120
+# MD5 Fingerprint: 0c:d2:f9:e0:da:17:73:e9:ed:86:4d:a5:e3:70:e7:4e
+# SHA1 Fingerprint: ca:bd:2a:79:a1:07:6a:31:f2:1d:25:36:35:cb:03:9d:43:29:a5:e8
+# SHA256 Fingerprint: 96:bc:ec:06:26:49:76:f3:74:60:77:9a:cf:28:c5:a7:cf:e8:a3:c0:aa:e1:1a:8f:fc:ee:05:c0:bd:df:08:c6
+-----BEGIN CERTIFICATE-----
+MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
+TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
+cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
+WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu
+ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY
+MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc
+h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+
+0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U
+A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW
+T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH
+B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC
+B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv
+KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn
+OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn
+jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw
+qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI
+rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq
+hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
+ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ
+3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK
+NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5
+ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur
+TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC
+jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc
+oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq
+4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA
+mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d
+emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
+-----END CERTIFICATE-----
+
+# Issuer: O=FNMT-RCM OU=AC RAIZ FNMT-RCM
+# Subject: O=FNMT-RCM OU=AC RAIZ FNMT-RCM
+# Label: "AC RAIZ FNMT-RCM"
+# Serial: 485876308206448804701554682760554759
+# MD5 Fingerprint: e2:09:04:b4:d3:bd:d1:a0:14:fd:1a:d2:47:c4:57:1d
+# SHA1 Fingerprint: ec:50:35:07:b2:15:c4:95:62:19:e2:a8:9a:5b:42:99:2c:4c:2c:20
+# SHA256 Fingerprint: eb:c5:57:0c:29:01:8c:4d:67:b1:aa:12:7b:af:12:f7:03:b4:61:1e:bc:17:b7:da:b5:57:38:94:17:9b:93:fa
+-----BEGIN CERTIFICATE-----
+MIIFgzCCA2ugAwIBAgIPXZONMGc2yAYdGsdUhGkHMA0GCSqGSIb3DQEBCwUAMDsx
+CzAJBgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJ
+WiBGTk1ULVJDTTAeFw0wODEwMjkxNTU5NTZaFw0zMDAxMDEwMDAwMDBaMDsxCzAJ
+BgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJWiBG
+Tk1ULVJDTTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALpxgHpMhm5/
+yBNtwMZ9HACXjywMI7sQmkCpGreHiPibVmr75nuOi5KOpyVdWRHbNi63URcfqQgf
+BBckWKo3Shjf5TnUV/3XwSyRAZHiItQDwFj8d0fsjz50Q7qsNI1NOHZnjrDIbzAz
+WHFctPVrbtQBULgTfmxKo0nRIBnuvMApGGWn3v7v3QqQIecaZ5JCEJhfTzC8PhxF
+tBDXaEAUwED653cXeuYLj2VbPNmaUtu1vZ5Gzz3rkQUCwJaydkxNEJY7kvqcfw+Z
+374jNUUeAlz+taibmSXaXvMiwzn15Cou08YfxGyqxRxqAQVKL9LFwag0Jl1mpdIC
+IfkYtwb1TplvqKtMUejPUBjFd8g5CSxJkjKZqLsXF3mwWsXmo8RZZUc1g16p6DUL
+mbvkzSDGm0oGObVo/CK67lWMK07q87Hj/LaZmtVC+nFNCM+HHmpxffnTtOmlcYF7
+wk5HlqX2doWjKI/pgG6BU6VtX7hI+cL5NqYuSf+4lsKMB7ObiFj86xsc3i1w4peS
+MKGJ47xVqCfWS+2QrYv6YyVZLag13cqXM7zlzced0ezvXg5KkAYmY6252TUtB7p2
+ZSysV4999AeU14ECll2jB0nVetBX+RvnU0Z1qrB5QstocQjpYL05ac70r8NWQMet
+UqIJ5G+GR4of6ygnXYMgrwTJbFaai0b1AgMBAAGjgYMwgYAwDwYDVR0TAQH/BAUw
+AwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFPd9xf3E6Jobd2Sn9R2gzL+H
+YJptMD4GA1UdIAQ3MDUwMwYEVR0gADArMCkGCCsGAQUFBwIBFh1odHRwOi8vd3d3
+LmNlcnQuZm5tdC5lcy9kcGNzLzANBgkqhkiG9w0BAQsFAAOCAgEAB5BK3/MjTvDD
+nFFlm5wioooMhfNzKWtN/gHiqQxjAb8EZ6WdmF/9ARP67Jpi6Yb+tmLSbkyU+8B1
+RXxlDPiyN8+sD8+Nb/kZ94/sHvJwnvDKuO+3/3Y3dlv2bojzr2IyIpMNOmqOFGYM
+LVN0V2Ue1bLdI4E7pWYjJ2cJj+F3qkPNZVEI7VFY/uY5+ctHhKQV8Xa7pO6kO8Rf
+77IzlhEYt8llvhjho6Tc+hj507wTmzl6NLrTQfv6MooqtyuGC2mDOL7Nii4LcK2N
+JpLuHvUBKwrZ1pebbuCoGRw6IYsMHkCtA+fdZn71uSANA+iW+YJF1DngoABd15jm
+fZ5nc8OaKveri6E6FO80vFIOiZiaBECEHX5FaZNXzuvO+FB8TxxuBEOb+dY7Ixjp
+6o7RTUaN8Tvkasq6+yO3m/qZASlaWFot4/nUbQ4mrcFuNLwy+AwF+mWj2zs3gyLp
+1txyM/1d8iC9djwj2ij3+RvrWWTV3F9yfiD8zYm1kGdNYno/Tq0dwzn+evQoFt9B
+9kiABdcPUXmsEKvU7ANm5mqwujGSQkBqvjrTcuFqN1W8rB2Vt2lh8kORdOag0wok
+RqEIr9baRRmW1FMdW4R58MD3R++Lj8UGrp1MYp3/RgT408m2ECVAdf4WqslKYIYv
+uu8wd+RU4riEmViAqhOLUTpPSPaLtrM=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Amazon Root CA 1 O=Amazon
+# Subject: CN=Amazon Root CA 1 O=Amazon
+# Label: "Amazon Root CA 1"
+# Serial: 143266978916655856878034712317230054538369994
+# MD5 Fingerprint: 43:c6:bf:ae:ec:fe:ad:2f:18:c6:88:68:30:fc:c8:e6
+# SHA1 Fingerprint: 8d:a7:f9:65:ec:5e:fc:37:91:0f:1c:6e:59:fd:c1:cc:6a:6e:de:16
+# SHA256 Fingerprint: 8e:cd:e6:88:4f:3d:87:b1:12:5b:a3:1a:c3:fc:b1:3d:70:16:de:7f:57:cc:90:4f:e1:cb:97:c6:ae:98:19:6e
+-----BEGIN CERTIFICATE-----
+MIIDQTCCAimgAwIBAgITBmyfz5m/jAo54vB4ikPmljZbyjANBgkqhkiG9w0BAQsF
+ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6
+b24gUm9vdCBDQSAxMB4XDTE1MDUyNjAwMDAwMFoXDTM4MDExNzAwMDAwMFowOTEL
+MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv
+b3QgQ0EgMTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALJ4gHHKeNXj
+ca9HgFB0fW7Y14h29Jlo91ghYPl0hAEvrAIthtOgQ3pOsqTQNroBvo3bSMgHFzZM
+9O6II8c+6zf1tRn4SWiw3te5djgdYZ6k/oI2peVKVuRF4fn9tBb6dNqcmzU5L/qw
+IFAGbHrQgLKm+a/sRxmPUDgH3KKHOVj4utWp+UhnMJbulHheb4mjUcAwhmahRWa6
+VOujw5H5SNz/0egwLX0tdHA114gk957EWW67c4cX8jJGKLhD+rcdqsq08p8kDi1L
+93FcXmn/6pUCyziKrlA4b9v7LWIbxcceVOF34GfID5yHI9Y/QCB/IIDEgEw+OyQm
+jgSubJrIqg0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC
+AYYwHQYDVR0OBBYEFIQYzIU07LwMlJQuCFmcx7IQTgoIMA0GCSqGSIb3DQEBCwUA
+A4IBAQCY8jdaQZChGsV2USggNiMOruYou6r4lK5IpDB/G/wkjUu0yKGX9rbxenDI
+U5PMCCjjmCXPI6T53iHTfIUJrU6adTrCC2qJeHZERxhlbI1Bjjt/msv0tadQ1wUs
+N+gDS63pYaACbvXy8MWy7Vu33PqUXHeeE6V/Uq2V8viTO96LXFvKWlJbYK8U90vv
+o/ufQJVtMVT8QtPHRh8jrdkPSHCa2XV4cdFyQzR1bldZwgJcJmApzyMZFo6IQ6XU
+5MsI+yMRQ+hDKXJioaldXgjUkK642M4UwtBV8ob2xJNDd2ZhwLnoQdeXeGADbkpy
+rqXRfboQnoZsG4q5WTP468SQvvG5
+-----END CERTIFICATE-----
+
+# Issuer: CN=Amazon Root CA 2 O=Amazon
+# Subject: CN=Amazon Root CA 2 O=Amazon
+# Label: "Amazon Root CA 2"
+# Serial: 143266982885963551818349160658925006970653239
+# MD5 Fingerprint: c8:e5:8d:ce:a8:42:e2:7a:c0:2a:5c:7c:9e:26:bf:66
+# SHA1 Fingerprint: 5a:8c:ef:45:d7:a6:98:59:76:7a:8c:8b:44:96:b5:78:cf:47:4b:1a
+# SHA256 Fingerprint: 1b:a5:b2:aa:8c:65:40:1a:82:96:01:18:f8:0b:ec:4f:62:30:4d:83:ce:c4:71:3a:19:c3:9c:01:1e:a4:6d:b4
+-----BEGIN CERTIFICATE-----
+MIIFQTCCAymgAwIBAgITBmyf0pY1hp8KD+WGePhbJruKNzANBgkqhkiG9w0BAQwF
+ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6
+b24gUm9vdCBDQSAyMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTEL
+MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv
+b3QgQ0EgMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK2Wny2cSkxK
+gXlRmeyKy2tgURO8TW0G/LAIjd0ZEGrHJgw12MBvIITplLGbhQPDW9tK6Mj4kHbZ
+W0/jTOgGNk3Mmqw9DJArktQGGWCsN0R5hYGCrVo34A3MnaZMUnbqQ523BNFQ9lXg
+1dKmSYXpN+nKfq5clU1Imj+uIFptiJXZNLhSGkOQsL9sBbm2eLfq0OQ6PBJTYv9K
+8nu+NQWpEjTj82R0Yiw9AElaKP4yRLuH3WUnAnE72kr3H9rN9yFVkE8P7K6C4Z9r
+2UXTu/Bfh+08LDmG2j/e7HJV63mjrdvdfLC6HM783k81ds8P+HgfajZRRidhW+me
+z/CiVX18JYpvL7TFz4QuK/0NURBs+18bvBt+xa47mAExkv8LV/SasrlX6avvDXbR
+8O70zoan4G7ptGmh32n2M8ZpLpcTnqWHsFcQgTfJU7O7f/aS0ZzQGPSSbtqDT6Zj
+mUyl+17vIWR6IF9sZIUVyzfpYgwLKhbcAS4y2j5L9Z469hdAlO+ekQiG+r5jqFoz
+7Mt0Q5X5bGlSNscpb/xVA1wf+5+9R+vnSUeVC06JIglJ4PVhHvG/LopyboBZ/1c6
++XUyo05f7O0oYtlNc/LMgRdg7c3r3NunysV+Ar3yVAhU/bQtCSwXVEqY0VThUWcI
+0u1ufm8/0i2BWSlmy5A5lREedCf+3euvAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMB
+Af8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSwDPBMMPQFWAJI/TPlUq9LhONm
+UjANBgkqhkiG9w0BAQwFAAOCAgEAqqiAjw54o+Ci1M3m9Zh6O+oAA7CXDpO8Wqj2
+LIxyh6mx/H9z/WNxeKWHWc8w4Q0QshNabYL1auaAn6AFC2jkR2vHat+2/XcycuUY
++gn0oJMsXdKMdYV2ZZAMA3m3MSNjrXiDCYZohMr/+c8mmpJ5581LxedhpxfL86kS
+k5Nrp+gvU5LEYFiwzAJRGFuFjWJZY7attN6a+yb3ACfAXVU3dJnJUH/jWS5E4ywl
+7uxMMne0nxrpS10gxdr9HIcWxkPo1LsmmkVwXqkLN1PiRnsn/eBG8om3zEK2yygm
+btmlyTrIQRNg91CMFa6ybRoVGld45pIq2WWQgj9sAq+uEjonljYE1x2igGOpm/Hl
+urR8FLBOybEfdF849lHqm/osohHUqS0nGkWxr7JOcQ3AWEbWaQbLU8uz/mtBzUF+
+fUwPfHJ5elnNXkoOrJupmHN5fLT0zLm4BwyydFy4x2+IoZCn9Kr5v2c69BoVYh63
+n749sSmvZ6ES8lgQGVMDMBu4Gon2nL2XA46jCfMdiyHxtN/kHNGfZQIG6lzWE7OE
+76KlXIx3KadowGuuQNKotOrN8I1LOJwZmhsoVLiJkO/KdYE+HvJkJMcYr07/R54H
+9jVlpNMKVv/1F2Rs76giJUmTtt8AF9pYfl3uxRuw0dFfIRDH+fO6AgonB8Xx1sfT
+4PsJYGw=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Amazon Root CA 3 O=Amazon
+# Subject: CN=Amazon Root CA 3 O=Amazon
+# Label: "Amazon Root CA 3"
+# Serial: 143266986699090766294700635381230934788665930
+# MD5 Fingerprint: a0:d4:ef:0b:f7:b5:d8:49:95:2a:ec:f5:c4:fc:81:87
+# SHA1 Fingerprint: 0d:44:dd:8c:3c:8c:1a:1a:58:75:64:81:e9:0f:2e:2a:ff:b3:d2:6e
+# SHA256 Fingerprint: 18:ce:6c:fe:7b:f1:4e:60:b2:e3:47:b8:df:e8:68:cb:31:d0:2e:bb:3a:da:27:15:69:f5:03:43:b4:6d:b3:a4
+-----BEGIN CERTIFICATE-----
+MIIBtjCCAVugAwIBAgITBmyf1XSXNmY/Owua2eiedgPySjAKBggqhkjOPQQDAjA5
+MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g
+Um9vdCBDQSAzMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG
+A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg
+Q0EgMzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABCmXp8ZBf8ANm+gBG1bG8lKl
+ui2yEujSLtf6ycXYqm0fc4E7O5hrOXwzpcVOho6AF2hiRVd9RFgdszflZwjrZt6j
+QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSr
+ttvXBp43rDCGB5Fwx5zEGbF4wDAKBggqhkjOPQQDAgNJADBGAiEA4IWSoxe3jfkr
+BqWTrBqYaGFy+uGh0PsceGCmQ5nFuMQCIQCcAu/xlJyzlvnrxir4tiz+OpAUFteM
+YyRIHN8wfdVoOw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Amazon Root CA 4 O=Amazon
+# Subject: CN=Amazon Root CA 4 O=Amazon
+# Label: "Amazon Root CA 4"
+# Serial: 143266989758080763974105200630763877849284878
+# MD5 Fingerprint: 89:bc:27:d5:eb:17:8d:06:6a:69:d5:fd:89:47:b4:cd
+# SHA1 Fingerprint: f6:10:84:07:d6:f8:bb:67:98:0c:c2:e2:44:c2:eb:ae:1c:ef:63:be
+# SHA256 Fingerprint: e3:5d:28:41:9e:d0:20:25:cf:a6:90:38:cd:62:39:62:45:8d:a5:c6:95:fb:de:a3:c2:2b:0b:fb:25:89:70:92
+-----BEGIN CERTIFICATE-----
+MIIB8jCCAXigAwIBAgITBmyf18G7EEwpQ+Vxe3ssyBrBDjAKBggqhkjOPQQDAzA5
+MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g
+Um9vdCBDQSA0MB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG
+A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg
+Q0EgNDB2MBAGByqGSM49AgEGBSuBBAAiA2IABNKrijdPo1MN/sGKe0uoe0ZLY7Bi
+9i0b2whxIdIA6GO9mif78DluXeo9pcmBqqNbIJhFXRbb/egQbeOc4OO9X4Ri83Bk
+M6DLJC9wuoihKqB1+IGuYgbEgds5bimwHvouXKNCMEAwDwYDVR0TAQH/BAUwAwEB
+/zAOBgNVHQ8BAf8EBAMCAYYwHQYDVR0OBBYEFNPsxzplbszh2naaVvuc84ZtV+WB
+MAoGCCqGSM49BAMDA2gAMGUCMDqLIfG9fhGt0O9Yli/W651+kI0rz2ZVwyzjKKlw
+CkcO8DdZEv8tmZQoTipPNU0zWgIxAOp1AE47xDqUEpHJWEadIRNyp4iciuRMStuW
+1KyLa2tJElMzrdfkviT8tQp21KW8EA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM
+# Subject: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM
+# Label: "TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1"
+# Serial: 1
+# MD5 Fingerprint: dc:00:81:dc:69:2f:3e:2f:b0:3b:f6:3d:5a:91:8e:49
+# SHA1 Fingerprint: 31:43:64:9b:ec:ce:27:ec:ed:3a:3f:0b:8f:0d:e4:e8:91:dd:ee:ca
+# SHA256 Fingerprint: 46:ed:c3:68:90:46:d5:3a:45:3f:b3:10:4a:b8:0d:ca:ec:65:8b:26:60:ea:16:29:dd:7e:86:79:90:64:87:16
+-----BEGIN CERTIFICATE-----
+MIIEYzCCA0ugAwIBAgIBATANBgkqhkiG9w0BAQsFADCB0jELMAkGA1UEBhMCVFIx
+GDAWBgNVBAcTD0dlYnplIC0gS29jYWVsaTFCMEAGA1UEChM5VHVya2l5ZSBCaWxp
+bXNlbCB2ZSBUZWtub2xvamlrIEFyYXN0aXJtYSBLdXJ1bXUgLSBUVUJJVEFLMS0w
+KwYDVQQLEyRLYW11IFNlcnRpZmlrYXN5b24gTWVya2V6aSAtIEthbXUgU00xNjA0
+BgNVBAMTLVRVQklUQUsgS2FtdSBTTSBTU0wgS29rIFNlcnRpZmlrYXNpIC0gU3Vy
+dW0gMTAeFw0xMzExMjUwODI1NTVaFw00MzEwMjUwODI1NTVaMIHSMQswCQYDVQQG
+EwJUUjEYMBYGA1UEBxMPR2ViemUgLSBLb2NhZWxpMUIwQAYDVQQKEzlUdXJraXll
+IEJpbGltc2VsIHZlIFRla25vbG9qaWsgQXJhc3Rpcm1hIEt1cnVtdSAtIFRVQklU
+QUsxLTArBgNVBAsTJEthbXUgU2VydGlmaWthc3lvbiBNZXJrZXppIC0gS2FtdSBT
+TTE2MDQGA1UEAxMtVFVCSVRBSyBLYW11IFNNIFNTTCBLb2sgU2VydGlmaWthc2kg
+LSBTdXJ1bSAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAr3UwM6q7
+a9OZLBI3hNmNe5eA027n/5tQlT6QlVZC1xl8JoSNkvoBHToP4mQ4t4y86Ij5iySr
+LqP1N+RAjhgleYN1Hzv/bKjFxlb4tO2KRKOrbEz8HdDc72i9z+SqzvBV96I01INr
+N3wcwv61A+xXzry0tcXtAA9TNypN9E8Mg/uGz8v+jE69h/mniyFXnHrfA2eJLJ2X
+YacQuFWQfw4tJzh03+f92k4S400VIgLI4OD8D62K18lUUMw7D8oWgITQUVbDjlZ/
+iSIzL+aFCr2lqBs23tPcLG07xxO9WSMs5uWk99gL7eqQQESolbuT1dCANLZGeA4f
+AJNG4e7p+exPFwIDAQABo0IwQDAdBgNVHQ4EFgQUZT/HiobGPN08VFw1+DrtUgxH
+V8gwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL
+BQADggEBACo/4fEyjq7hmFxLXs9rHmoJ0iKpEsdeV31zVmSAhHqT5Am5EM2fKifh
+AHe+SMg1qIGf5LgsyX8OsNJLN13qudULXjS99HMpw+0mFZx+CFOKWI3QSyjfwbPf
+IPP54+M638yclNhOT8NrF7f3cuitZjO1JVOr4PhMqZ398g26rrnZqsZr+ZO7rqu4
+lzwDGrpDxpa5RXI4s6ehlj2Re37AIVNMh+3yC1SVUZPVIqUNivGTDj5UDrDYyU7c
+8jEyVupk+eq1nRZmQnLzf9OxMUP8pI4X8W0jq5Rm+K37DwhuJi1/FwcJsoz7UMCf
+lo3Ptv0AnVoUmr8CRPXBwp8iXqIPoeM=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD.
+# Subject: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD.
+# Label: "GDCA TrustAUTH R5 ROOT"
+# Serial: 9009899650740120186
+# MD5 Fingerprint: 63:cc:d9:3d:34:35:5c:6f:53:a3:e2:08:70:48:1f:b4
+# SHA1 Fingerprint: 0f:36:38:5b:81:1a:25:c3:9b:31:4e:83:ca:e9:34:66:70:cc:74:b4
+# SHA256 Fingerprint: bf:ff:8f:d0:44:33:48:7d:6a:8a:a6:0c:1a:29:76:7a:9f:c2:bb:b0:5e:42:0f:71:3a:13:b9:92:89:1d:38:93
+-----BEGIN CERTIFICATE-----
+MIIFiDCCA3CgAwIBAgIIfQmX/vBH6nowDQYJKoZIhvcNAQELBQAwYjELMAkGA1UE
+BhMCQ04xMjAwBgNVBAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZ
+IENPLixMVEQuMR8wHQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMB4XDTE0
+MTEyNjA1MTMxNVoXDTQwMTIzMTE1NTk1OVowYjELMAkGA1UEBhMCQ04xMjAwBgNV
+BAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZIENPLixMVEQuMR8w
+HQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMIICIjANBgkqhkiG9w0BAQEF
+AAOCAg8AMIICCgKCAgEA2aMW8Mh0dHeb7zMNOwZ+Vfy1YI92hhJCfVZmPoiC7XJj
+Dp6L3TQsAlFRwxn9WVSEyfFrs0yw6ehGXTjGoqcuEVe6ghWinI9tsJlKCvLriXBj
+TnnEt1u9ol2x8kECK62pOqPseQrsXzrj/e+APK00mxqriCZ7VqKChh/rNYmDf1+u
+KU49tm7srsHwJ5uu4/Ts765/94Y9cnrrpftZTqfrlYwiOXnhLQiPzLyRuEH3FMEj
+qcOtmkVEs7LXLM3GKeJQEK5cy4KOFxg2fZfmiJqwTTQJ9Cy5WmYqsBebnh52nUpm
+MUHfP/vFBu8btn4aRjb3ZGM74zkYI+dndRTVdVeSN72+ahsmUPI2JgaQxXABZG12
+ZuGR224HwGGALrIuL4xwp9E7PLOR5G62xDtw8mySlwnNR30YwPO7ng/Wi64HtloP
+zgsMR6flPri9fcebNaBhlzpBdRfMK5Z3KpIhHtmVdiBnaM8Nvd/WHwlqmuLMc3Gk
+L30SgLdTMEZeS1SZD2fJpcjyIMGC7J0R38IC+xo70e0gmu9lZJIQDSri3nDxGGeC
+jGHeuLzRL5z7D9Ar7Rt2ueQ5Vfj4oR24qoAATILnsn8JuLwwoC8N9VKejveSswoA
+HQBUlwbgsQfZxw9cZX08bVlX5O2ljelAU58VS6Bx9hoh49pwBiFYFIeFd3mqgnkC
+AwEAAaNCMEAwHQYDVR0OBBYEFOLJQJ9NzuiaoXzPDj9lxSmIahlRMA8GA1UdEwEB
+/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQDRSVfg
+p8xoWLoBDysZzY2wYUWsEe1jUGn4H3++Fo/9nesLqjJHdtJnJO29fDMylyrHBYZm
+DRd9FBUb1Ov9H5r2XpdptxolpAqzkT9fNqyL7FeoPueBihhXOYV0GkLH6VsTX4/5
+COmSdI31R9KrO9b7eGZONn356ZLpBN79SWP8bfsUcZNnL0dKt7n/HipzcEYwv1ry
+L3ml4Y0M2fmyYzeMN2WFcGpcWwlyua1jPLHd+PwyvzeG5LuOmCd+uh8W4XAR8gPf
+JWIyJyYYMoSf/wA6E7qaTfRPuBRwIrHKK5DOKcFw9C+df/KQHtZa37dG/OaG+svg
+IHZ6uqbL9XzeYqWxi+7egmaKTjowHz+Ay60nugxe19CxVsp3cbK1daFQqUBDF8Io
+2c9Si1vIY9RCPqAzekYu9wogRlR+ak8x8YF+QnQ4ZXMn7sZ8uI7XpTrXmKGcjBBV
+09tL7ECQ8s1uV9JiDnxXk7Gnbc2dg7sq5+W2O3FYrf3RRbxake5TFW/TRQl1brqQ
+XR4EzzffHqhmsYzmIGrv/EhOdJhCrylvLmrH+33RZjEizIYAfmaDDEL0vTSSwxrq
+T8p+ck0LcIymSLumoRT2+1hEmRSuqguTaaApJUqlyyvdimYHFngVV3Eb7PVHhPOe
+MTd61X8kreS8/f3MboPoDKi3QWwH3b08hpcv0g==
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com Root Certification Authority RSA O=SSL Corporation
+# Subject: CN=SSL.com Root Certification Authority RSA O=SSL Corporation
+# Label: "SSL.com Root Certification Authority RSA"
+# Serial: 8875640296558310041
+# MD5 Fingerprint: 86:69:12:c0:70:f1:ec:ac:ac:c2:d5:bc:a5:5b:a1:29
+# SHA1 Fingerprint: b7:ab:33:08:d1:ea:44:77:ba:14:80:12:5a:6f:bd:a9:36:49:0c:bb
+# SHA256 Fingerprint: 85:66:6a:56:2e:e0:be:5c:e9:25:c1:d8:89:0a:6f:76:a8:7e:c1:6d:4d:7d:5f:29:ea:74:19:cf:20:12:3b:69
+-----BEGIN CERTIFICATE-----
+MIIF3TCCA8WgAwIBAgIIeyyb0xaAMpkwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UE
+BhMCVVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQK
+DA9TU0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZp
+Y2F0aW9uIEF1dGhvcml0eSBSU0EwHhcNMTYwMjEyMTczOTM5WhcNNDEwMjEyMTcz
+OTM5WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv
+dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNv
+bSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTCCAiIwDQYJKoZIhvcN
+AQEBBQADggIPADCCAgoCggIBAPkP3aMrfcvQKv7sZ4Wm5y4bunfh4/WvpOz6Sl2R
+xFdHaxh3a3by/ZPkPQ/CFp4LZsNWlJ4Xg4XOVu/yFv0AYvUiCVToZRdOQbngT0aX
+qhvIuG5iXmmxX9sqAn78bMrzQdjt0Oj8P2FI7bADFB0QDksZ4LtO7IZl/zbzXmcC
+C52GVWH9ejjt/uIZALdvoVBidXQ8oPrIJZK0bnoix/geoeOy3ZExqysdBP+lSgQ3
+6YWkMyv94tZVNHwZpEpox7Ko07fKoZOI68GXvIz5HdkihCR0xwQ9aqkpk8zruFvh
+/l8lqjRYyMEjVJ0bmBHDOJx+PYZspQ9AhnwC9FwCTyjLrnGfDzrIM/4RJTXq/LrF
+YD3ZfBjVsqnTdXgDciLKOsMf7yzlLqn6niy2UUb9rwPW6mBo6oUWNmuF6R7As93E
+JNyAKoFBbZQ+yODJgUEAnl6/f8UImKIYLEJAs/lvOCdLToD0PYFH4Ih86hzOtXVc
+US4cK38acijnALXRdMbX5J+tB5O2UzU1/Dfkw/ZdFr4hc96SCvigY2q8lpJqPvi8
+ZVWb3vUNiSYE/CUapiVpy8JtynziWV+XrOvvLsi81xtZPCvM8hnIk2snYxnP/Okm
++Mpxm3+T/jRnhE6Z6/yzeAkzcLpmpnbtG3PrGqUNxCITIJRWCk4sbE6x/c+cCbqi
+M+2HAgMBAAGjYzBhMB0GA1UdDgQWBBTdBAkHovV6fVJTEpKV7jiAJQ2mWTAPBgNV
+HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFN0ECQei9Xp9UlMSkpXuOIAlDaZZMA4G
+A1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAIBgRlCn7Jp0cHh5wYfGV
+cpNxJK1ok1iOMq8bs3AD/CUrdIWQPXhq9LmLpZc7tRiRux6n+UBbkflVma8eEdBc
+Hadm47GUBwwyOabqG7B52B2ccETjit3E+ZUfijhDPwGFpUenPUayvOUiaPd7nNgs
+PgohyC0zrL/FgZkxdMF1ccW+sfAjRfSda/wZY52jvATGGAslu1OJD7OAUN5F7kR/
+q5R4ZJjT9ijdh9hwZXT7DrkT66cPYakylszeu+1jTBi7qUD3oFRuIIhxdRjqerQ0
+cuAjJ3dctpDqhiVAq+8zD8ufgr6iIPv2tS0a5sKFsXQP+8hlAqRSAUfdSSLBv9jr
+a6x+3uxjMxW3IwiPxg+NQVrdjsW5j+VFP3jbutIbQLH+cU0/4IGiul607BXgk90I
+H37hVZkLId6Tngr75qNJvTYw/ud3sqB1l7UtgYgXZSD32pAAn8lSzDLKNXz1PQ/Y
+K9f1JmzJBjSWFupwWRoyeXkLtoh/D1JIPb9s2KJELtFOt3JY04kTlf5Eq/jXixtu
+nLwsoFvVagCvXzfh1foQC5ichucmj87w7G6KVwuA406ywKBjYZC6VWg3dGq2ktuf
+oYYitmUnDuy2n0Jg5GfCtdpBC8TTi2EbvPofkSvXRAdeuims2cXp71NIWuuA8ShY
+Ic2wBlX7Jz9TkHCpBB5XJ7k=
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com Root Certification Authority ECC O=SSL Corporation
+# Subject: CN=SSL.com Root Certification Authority ECC O=SSL Corporation
+# Label: "SSL.com Root Certification Authority ECC"
+# Serial: 8495723813297216424
+# MD5 Fingerprint: 2e:da:e4:39:7f:9c:8f:37:d1:70:9f:26:17:51:3a:8e
+# SHA1 Fingerprint: c3:19:7c:39:24:e6:54:af:1b:c4:ab:20:95:7a:e2:c3:0e:13:02:6a
+# SHA256 Fingerprint: 34:17:bb:06:cc:60:07:da:1b:96:1c:92:0b:8a:b4:ce:3f:ad:82:0e:4a:a3:0b:9a:cb:c4:a7:4e:bd:ce:bc:65
+-----BEGIN CERTIFICATE-----
+MIICjTCCAhSgAwIBAgIIdebfy8FoW6gwCgYIKoZIzj0EAwIwfDELMAkGA1UEBhMC
+VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T
+U0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZpY2F0
+aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNDAzWhcNNDEwMjEyMTgxNDAz
+WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hvdXN0
+b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNvbSBS
+b290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49AgEGBSuB
+BAAiA2IABEVuqVDEpiM2nl8ojRfLliJkP9x6jh3MCLOicSS6jkm5BBtHllirLZXI
+7Z4INcgn64mMU1jrYor+8FsPazFSY0E7ic3s7LaNGdM0B9y7xgZ/wkWV7Mt/qCPg
+CemB+vNH06NjMGEwHQYDVR0OBBYEFILRhXMw5zUE044CkvvlpNHEIejNMA8GA1Ud
+EwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUgtGFczDnNQTTjgKS++Wk0cQh6M0wDgYD
+VR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2cAMGQCMG/n61kRpGDPYbCWe+0F+S8T
+kdzt5fxQaxFGRrMcIQBiu77D5+jNB5n5DQtdcj7EqgIwH7y6C+IwJPt8bYBVCpk+
+gA0z5Wajs6O7pdWLjwkspl1+4vAHCGht0nxpbl/f5Wpl
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation
+# Subject: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation
+# Label: "SSL.com EV Root Certification Authority RSA R2"
+# Serial: 6248227494352943350
+# MD5 Fingerprint: e1:1e:31:58:1a:ae:54:53:02:f6:17:6a:11:7b:4d:95
+# SHA1 Fingerprint: 74:3a:f0:52:9b:d0:32:a0:f4:4a:83:cd:d4:ba:a9:7b:7c:2e:c4:9a
+# SHA256 Fingerprint: 2e:7b:f1:6c:c2:24:85:a7:bb:e2:aa:86:96:75:07:61:b0:ae:39:be:3b:2f:e9:d0:cc:6d:4e:f7:34:91:42:5c
+-----BEGIN CERTIFICATE-----
+MIIF6zCCA9OgAwIBAgIIVrYpzTS8ePYwDQYJKoZIhvcNAQELBQAwgYIxCzAJBgNV
+BAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91c3RvbjEYMBYGA1UE
+CgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQDDC5TU0wuY29tIEVWIFJvb3QgQ2Vy
+dGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIyMB4XDTE3MDUzMTE4MTQzN1oXDTQy
+MDUzMDE4MTQzN1owgYIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4G
+A1UEBwwHSG91c3RvbjEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQD
+DC5TU0wuY29tIEVWIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIy
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAjzZlQOHWTcDXtOlG2mvq
+M0fNTPl9fb69LT3w23jhhqXZuglXaO1XPqDQCEGD5yhBJB/jchXQARr7XnAjssuf
+OePPxU7Gkm0mxnu7s9onnQqG6YE3Bf7wcXHswxzpY6IXFJ3vG2fThVUCAtZJycxa
+4bH3bzKfydQ7iEGonL3Lq9ttewkfokxykNorCPzPPFTOZw+oz12WGQvE43LrrdF9
+HSfvkusQv1vrO6/PgN3B0pYEW3p+pKk8OHakYo6gOV7qd89dAFmPZiw+B6KjBSYR
+aZfqhbcPlgtLyEDhULouisv3D5oi53+aNxPN8k0TayHRwMwi8qFG9kRpnMphNQcA
+b9ZhCBHqurj26bNg5U257J8UZslXWNvNh2n4ioYSA0e/ZhN2rHd9NCSFg83XqpyQ
+Gp8hLH94t2S42Oim9HizVcuE0jLEeK6jj2HdzghTreyI/BXkmg3mnxp3zkyPuBQV
+PWKchjgGAGYS5Fl2WlPAApiiECtoRHuOec4zSnaqW4EWG7WK2NAAe15itAnWhmMO
+pgWVSbooi4iTsjQc2KRVbrcc0N6ZVTsj9CLg+SlmJuwgUHfbSguPvuUCYHBBXtSu
+UDkiFCbLsjtzdFVHB3mBOagwE0TlBIqulhMlQg+5U8Sb/M3kHN48+qvWBkofZ6aY
+MBzdLNvcGJVXZsb/XItW9XcCAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNV
+HSMEGDAWgBT5YLvU49U09rj1BoAlp3PbRmmonjAdBgNVHQ4EFgQU+WC71OPVNPa4
+9QaAJadz20ZpqJ4wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQBW
+s47LCp1Jjr+kxJG7ZhcFUZh1++VQLHqe8RT6q9OKPv+RKY9ji9i0qVQBDb6Thi/5
+Sm3HXvVX+cpVHBK+Rw82xd9qt9t1wkclf7nxY/hoLVUE0fKNsKTPvDxeH3jnpaAg
+cLAExbf3cqfeIg29MyVGjGSSJuM+LmOW2puMPfgYCdcDzH2GguDKBAdRUNf/ktUM
+79qGn5nX67evaOI5JpS6aLe/g9Pqemc9YmeuJeVy6OLk7K4S9ksrPJ/psEDzOFSz
+/bdoyNrGj1E8svuR3Bznm53htw1yj+KkxKl4+esUrMZDBcJlOSgYAsOCsp0FvmXt
+ll9ldDz7CTUue5wT/RsPXcdtgTpWD8w74a8CLyKsRspGPKAcTNZEtF4uXBVmCeEm
+Kf7GUmG6sXP/wwyc5WxqlD8UykAWlYTzWamsX0xhk23RO8yilQwipmdnRC652dKK
+QbNmC1r7fSOl8hqw/96bg5Qu0T/fkreRrwU7ZcegbLHNYhLDkBvjJc40vG93drEQ
+w/cFGsDWr3RiSBd3kmmQYRzelYB0VI8YHMPzA9C/pEN1hlMYegouCRw2n5H9gooi
+S9EOUCXdywMMF8mDAAhONU2Ki+3wApRmLER/y5UnlhetCTCstnEXbosX9hwJ1C07
+mKVx01QT2WDz9UtmT/rx7iASjbSsV7FFY6GsdqnC+w==
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation
+# Subject: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation
+# Label: "SSL.com EV Root Certification Authority ECC"
+# Serial: 3182246526754555285
+# MD5 Fingerprint: 59:53:22:65:83:42:01:54:c0:ce:42:b9:5a:7c:f2:90
+# SHA1 Fingerprint: 4c:dd:51:a3:d1:f5:20:32:14:b0:c6:c5:32:23:03:91:c7:46:42:6d
+# SHA256 Fingerprint: 22:a2:c1:f7:bd:ed:70:4c:c1:e7:01:b5:f4:08:c3:10:88:0f:e9:56:b5:de:2a:4a:44:f9:9c:87:3a:25:a7:c8
+-----BEGIN CERTIFICATE-----
+MIIClDCCAhqgAwIBAgIILCmcWxbtBZUwCgYIKoZIzj0EAwIwfzELMAkGA1UEBhMC
+VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T
+U0wgQ29ycG9yYXRpb24xNDAyBgNVBAMMK1NTTC5jb20gRVYgUm9vdCBDZXJ0aWZp
+Y2F0aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNTIzWhcNNDEwMjEyMTgx
+NTIzWjB/MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv
+dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjE0MDIGA1UEAwwrU1NMLmNv
+bSBFViBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49
+AgEGBSuBBAAiA2IABKoSR5CYG/vvw0AHgyBO8TCCogbR8pKGYfL2IWjKAMTH6kMA
+VIbc/R/fALhBYlzccBYy3h+Z1MzFB8gIH2EWB1E9fVwHU+M1OIzfzZ/ZLg1Kthku
+WnBaBu2+8KGwytAJKaNjMGEwHQYDVR0OBBYEFFvKXuXe0oGqzagtZFG22XKbl+ZP
+MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUW8pe5d7SgarNqC1kUbbZcpuX
+5k8wDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2gAMGUCMQCK5kCJN+vp1RPZ
+ytRrJPOwPYdGWBrssd9v+1a6cGvHOMzosYxPD/fxZ3YOg9AeUY8CMD32IygmTMZg
+h5Mmm7I1HrrW9zzRHM76JTymGoEVW/MSD2zuZYrJh6j5B+BimoxcSg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R6
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R6
+# Label: "GlobalSign Root CA - R6"
+# Serial: 1417766617973444989252670301619537
+# MD5 Fingerprint: 4f:dd:07:e4:d4:22:64:39:1e:0c:37:42:ea:d1:c6:ae
+# SHA1 Fingerprint: 80:94:64:0e:b5:a7:a1:ca:11:9c:1f:dd:d5:9f:81:02:63:a7:fb:d1
+# SHA256 Fingerprint: 2c:ab:ea:fe:37:d0:6c:a2:2a:ba:73:91:c0:03:3d:25:98:29:52:c4:53:64:73:49:76:3a:3a:b5:ad:6c:cf:69
+-----BEGIN CERTIFICATE-----
+MIIFgzCCA2ugAwIBAgIORea7A4Mzw4VlSOb/RVEwDQYJKoZIhvcNAQEMBQAwTDEg
+MB4GA1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjYxEzARBgNVBAoTCkdsb2Jh
+bFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMTQxMjEwMDAwMDAwWhcNMzQx
+MjEwMDAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSNjET
+MBEGA1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCAiIwDQYJ
+KoZIhvcNAQEBBQADggIPADCCAgoCggIBAJUH6HPKZvnsFMp7PPcNCPG0RQssgrRI
+xutbPK6DuEGSMxSkb3/pKszGsIhrxbaJ0cay/xTOURQh7ErdG1rG1ofuTToVBu1k
+ZguSgMpE3nOUTvOniX9PeGMIyBJQbUJmL025eShNUhqKGoC3GYEOfsSKvGRMIRxD
+aNc9PIrFsmbVkJq3MQbFvuJtMgamHvm566qjuL++gmNQ0PAYid/kD3n16qIfKtJw
+LnvnvJO7bVPiSHyMEAc4/2ayd2F+4OqMPKq0pPbzlUoSB239jLKJz9CgYXfIWHSw
+1CM69106yqLbnQneXUQtkPGBzVeS+n68UARjNN9rkxi+azayOeSsJDa38O+2HBNX
+k7besvjihbdzorg1qkXy4J02oW9UivFyVm4uiMVRQkQVlO6jxTiWm05OWgtH8wY2
+SXcwvHE35absIQh1/OZhFj931dmRl4QKbNQCTXTAFO39OfuD8l4UoQSwC+n+7o/h
+bguyCLNhZglqsQY6ZZZZwPA1/cnaKI0aEYdwgQqomnUdnjqGBQCe24DWJfncBZ4n
+WUx2OVvq+aWh2IMP0f/fMBH5hc8zSPXKbWQULHpYT9NLCEnFlWQaYw55PfWzjMpY
+rZxCRXluDocZXFSxZba/jJvcE+kNb7gu3GduyYsRtYQUigAZcIN5kZeR1Bonvzce
+MgfYFGM8KEyvAgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTAD
+AQH/MB0GA1UdDgQWBBSubAWjkxPioufi1xzWx/B/yGdToDAfBgNVHSMEGDAWgBSu
+bAWjkxPioufi1xzWx/B/yGdToDANBgkqhkiG9w0BAQwFAAOCAgEAgyXt6NH9lVLN
+nsAEoJFp5lzQhN7craJP6Ed41mWYqVuoPId8AorRbrcWc+ZfwFSY1XS+wc3iEZGt
+Ixg93eFyRJa0lV7Ae46ZeBZDE1ZXs6KzO7V33EByrKPrmzU+sQghoefEQzd5Mr61
+55wsTLxDKZmOMNOsIeDjHfrYBzN2VAAiKrlNIC5waNrlU/yDXNOd8v9EDERm8tLj
+vUYAGm0CuiVdjaExUd1URhxN25mW7xocBFymFe944Hn+Xds+qkxV/ZoVqW/hpvvf
+cDDpw+5CRu3CkwWJ+n1jez/QcYF8AOiYrg54NMMl+68KnyBr3TsTjxKM4kEaSHpz
+oHdpx7Zcf4LIHv5YGygrqGytXm3ABdJ7t+uA/iU3/gKbaKxCXcPu9czc8FB10jZp
+nOZ7BN9uBmm23goJSFmH63sUYHpkqmlD75HHTOwY3WzvUy2MmeFe8nI+z1TIvWfs
+pA9MRf/TuTAjB0yPEL+GltmZWrSZVxykzLsViVO6LAUP5MSeGbEYNNVMnbrt9x+v
+JJUEeKgDu+6B5dpffItKoZB0JaezPkvILFa9x8jvOOJckvB595yEunQtYQEgfn7R
+8k8HWV+LLUNS60YMlOH1Zkd5d9VUWx+tJDfLRVpOoERIyNiwmcUVhAn21klJwGW4
+5hpxbqCo8YLoRT5s1gLXCmeDBVrJpBA=
+-----END CERTIFICATE-----
+
+# Issuer: CN=OISTE WISeKey Global Root GC CA O=WISeKey OU=OISTE Foundation Endorsed
+# Subject: CN=OISTE WISeKey Global Root GC CA O=WISeKey OU=OISTE Foundation Endorsed
+# Label: "OISTE WISeKey Global Root GC CA"
+# Serial: 44084345621038548146064804565436152554
+# MD5 Fingerprint: a9:d6:b9:2d:2f:93:64:f8:a5:69:ca:91:e9:68:07:23
+# SHA1 Fingerprint: e0:11:84:5e:34:de:be:88:81:b9:9c:f6:16:26:d1:96:1f:c3:b9:31
+# SHA256 Fingerprint: 85:60:f9:1c:36:24:da:ba:95:70:b5:fe:a0:db:e3:6f:f1:1a:83:23:be:94:86:85:4f:b3:f3:4a:55:71:19:8d
+-----BEGIN CERTIFICATE-----
+MIICaTCCAe+gAwIBAgIQISpWDK7aDKtARb8roi066jAKBggqhkjOPQQDAzBtMQsw
+CQYDVQQGEwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUgRm91
+bmRhdGlvbiBFbmRvcnNlZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9iYWwg
+Um9vdCBHQyBDQTAeFw0xNzA1MDkwOTQ4MzRaFw00MjA1MDkwOTU4MzNaMG0xCzAJ
+BgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQLExlPSVNURSBGb3Vu
+ZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2JhbCBS
+b290IEdDIENBMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAETOlQwMYPchi82PG6s4ni
+eUqjFqdrVCTbUf/q9Akkwwsin8tqJ4KBDdLArzHkdIJuyiXZjHWd8dvQmqJLIX4W
+p2OQ0jnUsYd4XxiWD1AbNTcPasbc2RNNpI6QN+a9WzGRo1QwUjAOBgNVHQ8BAf8E
+BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUSIcUrOPDnpBgOtfKie7T
+rYy0UGYwEAYJKwYBBAGCNxUBBAMCAQAwCgYIKoZIzj0EAwMDaAAwZQIwJsdpW9zV
+57LnyAyMjMPdeYwbY9XJUpROTYJKcx6ygISpJcBMWm1JKWB4E+J+SOtkAjEA2zQg
+Mgj/mkkCtojeFK9dbJlxjRo/i9fgojaGHAeCOnZT/cKi7e97sIBPWA9LUzm9
+-----END CERTIFICATE-----
+
+# Issuer: CN=UCA Global G2 Root O=UniTrust
+# Subject: CN=UCA Global G2 Root O=UniTrust
+# Label: "UCA Global G2 Root"
+# Serial: 124779693093741543919145257850076631279
+# MD5 Fingerprint: 80:fe:f0:c4:4a:f0:5c:62:32:9f:1c:ba:78:a9:50:f8
+# SHA1 Fingerprint: 28:f9:78:16:19:7a:ff:18:25:18:aa:44:fe:c1:a0:ce:5c:b6:4c:8a
+# SHA256 Fingerprint: 9b:ea:11:c9:76:fe:01:47:64:c1:be:56:a6:f9:14:b5:a5:60:31:7a:bd:99:88:39:33:82:e5:16:1a:a0:49:3c
+-----BEGIN CERTIFICATE-----
+MIIFRjCCAy6gAwIBAgIQXd+x2lqj7V2+WmUgZQOQ7zANBgkqhkiG9w0BAQsFADA9
+MQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxGzAZBgNVBAMMElVDQSBH
+bG9iYWwgRzIgUm9vdDAeFw0xNjAzMTEwMDAwMDBaFw00MDEyMzEwMDAwMDBaMD0x
+CzAJBgNVBAYTAkNOMREwDwYDVQQKDAhVbmlUcnVzdDEbMBkGA1UEAwwSVUNBIEds
+b2JhbCBHMiBSb290MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxeYr
+b3zvJgUno4Ek2m/LAfmZmqkywiKHYUGRO8vDaBsGxUypK8FnFyIdK+35KYmToni9
+kmugow2ifsqTs6bRjDXVdfkX9s9FxeV67HeToI8jrg4aA3++1NDtLnurRiNb/yzm
+VHqUwCoV8MmNsHo7JOHXaOIxPAYzRrZUEaalLyJUKlgNAQLx+hVRZ2zA+te2G3/R
+VogvGjqNO7uCEeBHANBSh6v7hn4PJGtAnTRnvI3HLYZveT6OqTwXS3+wmeOwcWDc
+C/Vkw85DvG1xudLeJ1uK6NjGruFZfc8oLTW4lVYa8bJYS7cSN8h8s+1LgOGN+jIj
+tm+3SJUIsUROhYw6AlQgL9+/V087OpAh18EmNVQg7Mc/R+zvWr9LesGtOxdQXGLY
+D0tK3Cv6brxzks3sx1DoQZbXqX5t2Okdj4q1uViSukqSKwxW/YDrCPBeKW4bHAyv
+j5OJrdu9o54hyokZ7N+1wxrrFv54NkzWbtA+FxyQF2smuvt6L78RHBgOLXMDj6Dl
+NaBa4kx1HXHhOThTeEDMg5PXCp6dW4+K5OXgSORIskfNTip1KnvyIvbJvgmRlld6
+iIis7nCs+dwp4wwcOxJORNanTrAmyPPZGpeRaOrvjUYG0lZFWJo8DA+DuAUlwznP
+O6Q0ibd5Ei9Hxeepl2n8pndntd978XplFeRhVmUCAwEAAaNCMEAwDgYDVR0PAQH/
+BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFIHEjMz15DD/pQwIX4wV
+ZyF0Ad/fMA0GCSqGSIb3DQEBCwUAA4ICAQATZSL1jiutROTL/7lo5sOASD0Ee/oj
+L3rtNtqyzm325p7lX1iPyzcyochltq44PTUbPrw7tgTQvPlJ9Zv3hcU2tsu8+Mg5
+1eRfB70VVJd0ysrtT7q6ZHafgbiERUlMjW+i67HM0cOU2kTC5uLqGOiiHycFutfl
+1qnN3e92mI0ADs0b+gO3joBYDic/UvuUospeZcnWhNq5NXHzJsBPd+aBJ9J3O5oU
+b3n09tDh05S60FdRvScFDcH9yBIw7m+NESsIndTUv4BFFJqIRNow6rSn4+7vW4LV
+PtateJLbXDzz2K36uGt/xDYotgIVilQsnLAXc47QN6MUPJiVAAwpBVueSUmxX8fj
+y88nZY41F7dXyDDZQVu5FLbowg+UMaeUmMxq67XhJ/UQqAHojhJi6IjMtX9Gl8Cb
+EGY4GjZGXyJoPd/JxhMnq1MGrKI8hgZlb7F+sSlEmqO6SWkoaY/X5V+tBIZkbxqg
+DMUIYs6Ao9Dz7GjevjPHF1t/gMRMTLGmhIrDO7gJzRSBuhjjVFc2/tsvfEehOjPI
++Vg7RE+xygKJBJYoaMVLuCaJu9YzL1DV/pqJuhgyklTGW+Cd+V7lDSKb9triyCGy
+YiGqhkCyLmTTX8jjfhFnRR8F/uOi77Oos/N9j/gMHyIfLXC0uAE0djAA5SN4p1bX
+UB+K+wb1whnw0A==
+-----END CERTIFICATE-----
+
+# Issuer: CN=UCA Extended Validation Root O=UniTrust
+# Subject: CN=UCA Extended Validation Root O=UniTrust
+# Label: "UCA Extended Validation Root"
+# Serial: 106100277556486529736699587978573607008
+# MD5 Fingerprint: a1:f3:5f:43:c6:34:9b:da:bf:8c:7e:05:53:ad:96:e2
+# SHA1 Fingerprint: a3:a1:b0:6f:24:61:23:4a:e3:36:a5:c2:37:fc:a6:ff:dd:f0:d7:3a
+# SHA256 Fingerprint: d4:3a:f9:b3:54:73:75:5c:96:84:fc:06:d7:d8:cb:70:ee:5c:28:e7:73:fb:29:4e:b4:1e:e7:17:22:92:4d:24
+-----BEGIN CERTIFICATE-----
+MIIFWjCCA0KgAwIBAgIQT9Irj/VkyDOeTzRYZiNwYDANBgkqhkiG9w0BAQsFADBH
+MQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNVBAMMHFVDQSBF
+eHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwHhcNMTUwMzEzMDAwMDAwWhcNMzgxMjMx
+MDAwMDAwWjBHMQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNV
+BAMMHFVDQSBFeHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwggIiMA0GCSqGSIb3DQEB
+AQUAA4ICDwAwggIKAoICAQCpCQcoEwKwmeBkqh5DFnpzsZGgdT6o+uM4AHrsiWog
+D4vFsJszA1qGxliG1cGFu0/GnEBNyr7uaZa4rYEwmnySBesFK5pI0Lh2PpbIILvS
+sPGP2KxFRv+qZ2C0d35qHzwaUnoEPQc8hQ2E0B92CvdqFN9y4zR8V05WAT558aop
+O2z6+I9tTcg1367r3CTueUWnhbYFiN6IXSV8l2RnCdm/WhUFhvMJHuxYMjMR83dk
+sHYf5BA1FxvyDrFspCqjc/wJHx4yGVMR59mzLC52LqGj3n5qiAno8geK+LLNEOfi
+c0CTuwjRP+H8C5SzJe98ptfRr5//lpr1kXuYC3fUfugH0mK1lTnj8/FtDw5lhIpj
+VMWAtuCeS31HJqcBCF3RiJ7XwzJE+oJKCmhUfzhTA8ykADNkUVkLo4KRel7sFsLz
+KuZi2irbWWIQJUoqgQtHB0MGcIfS+pMRKXpITeuUx3BNr2fVUbGAIAEBtHoIppB/
+TuDvB0GHr2qlXov7z1CymlSvw4m6WC31MJixNnI5fkkE/SmnTHnkBVfblLkWU41G
+sx2VYVdWf6/wFlthWG82UBEL2KwrlRYaDh8IzTY0ZRBiZtWAXxQgXy0MoHgKaNYs
+1+lvK9JKBZP8nm9rZ/+I8U6laUpSNwXqxhaN0sSZ0YIrO7o1dfdRUVjzyAfd5LQD
+fwIDAQABo0IwQDAdBgNVHQ4EFgQU2XQ65DA9DfcS3H5aBZ8eNJr34RQwDwYDVR0T
+AQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQELBQADggIBADaN
+l8xCFWQpN5smLNb7rhVpLGsaGvdftvkHTFnq88nIua7Mui563MD1sC3AO6+fcAUR
+ap8lTwEpcOPlDOHqWnzcSbvBHiqB9RZLcpHIojG5qtr8nR/zXUACE/xOHAbKsxSQ
+VBcZEhrxH9cMaVr2cXj0lH2RC47skFSOvG+hTKv8dGT9cZr4QQehzZHkPJrgmzI5
+c6sq1WnIeJEmMX3ixzDx/BR4dxIOE/TdFpS/S2d7cFOFyrC78zhNLJA5wA3CXWvp
+4uXViI3WLL+rG761KIcSF3Ru/H38j9CHJrAb+7lsq+KePRXBOy5nAliRn+/4Qh8s
+t2j1da3Ptfb/EX3C8CSlrdP6oDyp+l3cpaDvRKS+1ujl5BOWF3sGPjLtx7dCvHaj
+2GU4Kzg1USEODm8uNBNA4StnDG1KQTAYI1oyVZnJF+A83vbsea0rWBmirSwiGpWO
+vpaQXUJXxPkUAzUrHC1RVwinOt4/5Mi0A3PCwSaAuwtCH60NryZy2sy+s6ODWA2C
+xR9GUeOcGMyNm43sSet1UNWMKFnKdDTajAshqx7qG+XH/RU+wBeq+yNuJkbL+vmx
+cmtpzyKEC2IPrNkZAJSidjzULZrtBJ4tBmIQN1IchXIbJ+XMxjHsN+xjWZsLHXbM
+fjKaiJUINlK73nZfdklJrX+9ZSCyycErdhh2n1ax
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certigna Root CA O=Dhimyotis OU=0002 48146308100036
+# Subject: CN=Certigna Root CA O=Dhimyotis OU=0002 48146308100036
+# Label: "Certigna Root CA"
+# Serial: 269714418870597844693661054334862075617
+# MD5 Fingerprint: 0e:5c:30:62:27:eb:5b:bc:d7:ae:62:ba:e9:d5:df:77
+# SHA1 Fingerprint: 2d:0d:52:14:ff:9e:ad:99:24:01:74:20:47:6e:6c:85:27:27:f5:43
+# SHA256 Fingerprint: d4:8d:3d:23:ee:db:50:a4:59:e5:51:97:60:1c:27:77:4b:9d:7b:18:c9:4d:5a:05:95:11:a1:02:50:b9:31:68
+-----BEGIN CERTIFICATE-----
+MIIGWzCCBEOgAwIBAgIRAMrpG4nxVQMNo+ZBbcTjpuEwDQYJKoZIhvcNAQELBQAw
+WjELMAkGA1UEBhMCRlIxEjAQBgNVBAoMCURoaW15b3RpczEcMBoGA1UECwwTMDAw
+MiA0ODE0NjMwODEwMDAzNjEZMBcGA1UEAwwQQ2VydGlnbmEgUm9vdCBDQTAeFw0x
+MzEwMDEwODMyMjdaFw0zMzEwMDEwODMyMjdaMFoxCzAJBgNVBAYTAkZSMRIwEAYD
+VQQKDAlEaGlteW90aXMxHDAaBgNVBAsMEzAwMDIgNDgxNDYzMDgxMDAwMzYxGTAX
+BgNVBAMMEENlcnRpZ25hIFJvb3QgQ0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAw
+ggIKAoICAQDNGDllGlmx6mQWDoyUJJV8g9PFOSbcDO8WV43X2KyjQn+Cyu3NW9sO
+ty3tRQgXstmzy9YXUnIo245Onoq2C/mehJpNdt4iKVzSs9IGPjA5qXSjklYcoW9M
+CiBtnyN6tMbaLOQdLNyzKNAT8kxOAkmhVECe5uUFoC2EyP+YbNDrihqECB63aCPu
+I9Vwzm1RaRDuoXrC0SIxwoKF0vJVdlB8JXrJhFwLrN1CTivngqIkicuQstDuI7pm
+TLtipPlTWmR7fJj6o0ieD5Wupxj0auwuA0Wv8HT4Ks16XdG+RCYyKfHx9WzMfgIh
+C59vpD++nVPiz32pLHxYGpfhPTc3GGYo0kDFUYqMwy3OU4gkWGQwFsWq4NYKpkDf
+ePb1BHxpE4S80dGnBs8B92jAqFe7OmGtBIyT46388NtEbVncSVmurJqZNjBBe3Yz
+IoejwpKGbvlw7q6Hh5UbxHq9MfPU0uWZ/75I7HX1eBYdpnDBfzwboZL7z8g81sWT
+Co/1VTp2lc5ZmIoJlXcymoO6LAQ6l73UL77XbJuiyn1tJslV1c/DeVIICZkHJC1k
+JWumIWmbat10TWuXekG9qxf5kBdIjzb5LdXF2+6qhUVB+s06RbFo5jZMm5BX7CO5
+hwjCxAnxl4YqKE3idMDaxIzb3+KhF1nOJFl0Mdp//TBt2dzhauH8XwIDAQABo4IB
+GjCCARYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE
+FBiHVuBud+4kNTxOc5of1uHieX4rMB8GA1UdIwQYMBaAFBiHVuBud+4kNTxOc5of
+1uHieX4rMEQGA1UdIAQ9MDswOQYEVR0gADAxMC8GCCsGAQUFBwIBFiNodHRwczov
+L3d3d3cuY2VydGlnbmEuZnIvYXV0b3JpdGVzLzBtBgNVHR8EZjBkMC+gLaArhilo
+dHRwOi8vY3JsLmNlcnRpZ25hLmZyL2NlcnRpZ25hcm9vdGNhLmNybDAxoC+gLYYr
+aHR0cDovL2NybC5kaGlteW90aXMuY29tL2NlcnRpZ25hcm9vdGNhLmNybDANBgkq
+hkiG9w0BAQsFAAOCAgEAlLieT/DjlQgi581oQfccVdV8AOItOoldaDgvUSILSo3L
+6btdPrtcPbEo/uRTVRPPoZAbAh1fZkYJMyjhDSSXcNMQH+pkV5a7XdrnxIxPTGRG
+HVyH41neQtGbqH6mid2PHMkwgu07nM3A6RngatgCdTer9zQoKJHyBApPNeNgJgH6
+0BGM+RFq7q89w1DTj18zeTyGqHNFkIwgtnJzFyO+B2XleJINugHA64wcZr+shncB
+lA2c5uk5jR+mUYyZDDl34bSb+hxnV29qao6pK0xXeXpXIs/NX2NGjVxZOob4Mkdi
+o2cNGJHc+6Zr9UhhcyNZjgKnvETq9Emd8VRY+WCv2hikLyhF3HqgiIZd8zvn/yk1
+gPxkQ5Tm4xxvvq0OKmOZK8l+hfZx6AYDlf7ej0gcWtSS6Cvu5zHbugRqh5jnxV/v
+faci9wHYTfmJ0A6aBVmknpjZbyvKcL5kwlWj9Omvw5Ip3IgWJJk8jSaYtlu3zM63
+Nwf9JtmYhST/WSMDmu2dnajkXjjO11INb9I/bbEFa0nOipFGc/T2L/Coc3cOZayh
+jWZSaX5LaAzHHjcng6WMxwLkFM1JAbBzs/3GkDpv0mztO+7skb6iQ12LAEpmJURw
+3kAP+HwV96LOPNdeE4yBFxgX0b3xdxA61GU5wSesVywlVP+i2k+KYTlerj1KjL0=
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI
+# Subject: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI
+# Label: "emSign Root CA - G1"
+# Serial: 235931866688319308814040
+# MD5 Fingerprint: 9c:42:84:57:dd:cb:0b:a7:2e:95:ad:b6:f3:da:bc:ac
+# SHA1 Fingerprint: 8a:c7:ad:8f:73:ac:4e:c1:b5:75:4d:a5:40:f4:fc:cf:7c:b5:8e:8c
+# SHA256 Fingerprint: 40:f6:af:03:46:a9:9a:a1:cd:1d:55:5a:4e:9c:ce:62:c7:f9:63:46:03:ee:40:66:15:83:3d:c8:c8:d0:03:67
+-----BEGIN CERTIFICATE-----
+MIIDlDCCAnygAwIBAgIKMfXkYgxsWO3W2DANBgkqhkiG9w0BAQsFADBnMQswCQYD
+VQQGEwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBU
+ZWNobm9sb2dpZXMgTGltaXRlZDEcMBoGA1UEAxMTZW1TaWduIFJvb3QgQ0EgLSBH
+MTAeFw0xODAyMTgxODMwMDBaFw00MzAyMTgxODMwMDBaMGcxCzAJBgNVBAYTAklO
+MRMwEQYDVQQLEwplbVNpZ24gUEtJMSUwIwYDVQQKExxlTXVkaHJhIFRlY2hub2xv
+Z2llcyBMaW1pdGVkMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEcxMIIBIjAN
+BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAk0u76WaK7p1b1TST0Bsew+eeuGQz
+f2N4aLTNLnF115sgxk0pvLZoYIr3IZpWNVrzdr3YzZr/k1ZLpVkGoZM0Kd0WNHVO
+8oG0x5ZOrRkVUkr+PHB1cM2vK6sVmjM8qrOLqs1D/fXqcP/tzxE7lM5OMhbTI0Aq
+d7OvPAEsbO2ZLIvZTmmYsvePQbAyeGHWDV/D+qJAkh1cF+ZwPjXnorfCYuKrpDhM
+tTk1b+oDafo6VGiFbdbyL0NVHpENDtjVaqSW0RM8LHhQ6DqS0hdW5TUaQBw+jSzt
+Od9C4INBdN+jzcKGYEho42kLVACL5HZpIQ15TjQIXhTCzLG3rdd8cIrHhQIDAQAB
+o0IwQDAdBgNVHQ4EFgQU++8Nhp6w492pufEhF38+/PB3KxowDgYDVR0PAQH/BAQD
+AgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAFn/8oz1h31x
+PaOfG1vR2vjTnGs2vZupYeveFix0PZ7mddrXuqe8QhfnPZHr5X3dPpzxz5KsbEjM
+wiI/aTvFthUvozXGaCocV685743QNcMYDHsAVhzNixl03r4PEuDQqqE/AjSxcM6d
+GNYIAwlG7mDgfrbESQRRfXBgvKqy/3lyeqYdPV8q+Mri/Tm3R7nrft8EI6/6nAYH
+6ftjk4BAtcZsCjEozgyfz7MjNYBBjWzEN3uBL4ChQEKF6dk4jeihU80Bv2noWgby
+RQuQ+q7hv53yrlc8pa6yVvSLZUDp/TGBLPQ5Cdjua6e0ph0VpZj3AYHYhX3zUVxx
+iN66zB+Afko=
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI
+# Subject: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI
+# Label: "emSign ECC Root CA - G3"
+# Serial: 287880440101571086945156
+# MD5 Fingerprint: ce:0b:72:d1:9f:88:8e:d0:50:03:e8:e3:b8:8b:67:40
+# SHA1 Fingerprint: 30:43:fa:4f:f2:57:dc:a0:c3:80:ee:2e:58:ea:78:b2:3f:e6:bb:c1
+# SHA256 Fingerprint: 86:a1:ec:ba:08:9c:4a:8d:3b:be:27:34:c6:12:ba:34:1d:81:3e:04:3c:f9:e8:a8:62:cd:5c:57:a3:6b:be:6b
+-----BEGIN CERTIFICATE-----
+MIICTjCCAdOgAwIBAgIKPPYHqWhwDtqLhDAKBggqhkjOPQQDAzBrMQswCQYDVQQG
+EwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNo
+bm9sb2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0g
+RzMwHhcNMTgwMjE4MTgzMDAwWhcNNDMwMjE4MTgzMDAwWjBrMQswCQYDVQQGEwJJ
+TjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNobm9s
+b2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0gRzMw
+djAQBgcqhkjOPQIBBgUrgQQAIgNiAAQjpQy4LRL1KPOxst3iAhKAnjlfSU2fySU0
+WXTsuwYc58Byr+iuL+FBVIcUqEqy6HyC5ltqtdyzdc6LBtCGI79G1Y4PPwT01xyS
+fvalY8L1X44uT6EYGQIrMgqCZH0Wk9GjQjBAMB0GA1UdDgQWBBR8XQKEE9TMipuB
+zhccLikenEhjQjAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggq
+hkjOPQQDAwNpADBmAjEAvvNhzwIQHWSVB7gYboiFBS+DCBeQyh+KTOgNG3qxrdWB
+CUfvO6wIBHxcmbHtRwfSAjEAnbpV/KlK6O3t5nYBQnvI+GDZjVGLVTv7jHvrZQnD
++JbNR6iC8hZVdyR+EhCVBCyj
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI
+# Subject: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI
+# Label: "emSign Root CA - C1"
+# Serial: 825510296613316004955058
+# MD5 Fingerprint: d8:e3:5d:01:21:fa:78:5a:b0:df:ba:d2:ee:2a:5f:68
+# SHA1 Fingerprint: e7:2e:f1:df:fc:b2:09:28:cf:5d:d4:d5:67:37:b1:51:cb:86:4f:01
+# SHA256 Fingerprint: 12:56:09:aa:30:1d:a0:a2:49:b9:7a:82:39:cb:6a:34:21:6f:44:dc:ac:9f:39:54:b1:42:92:f2:e8:c8:60:8f
+-----BEGIN CERTIFICATE-----
+MIIDczCCAlugAwIBAgILAK7PALrEzzL4Q7IwDQYJKoZIhvcNAQELBQAwVjELMAkG
+A1UEBhMCVVMxEzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEg
+SW5jMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEMxMB4XDTE4MDIxODE4MzAw
+MFoXDTQzMDIxODE4MzAwMFowVjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln
+biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMRwwGgYDVQQDExNlbVNpZ24gUm9v
+dCBDQSAtIEMxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAz+upufGZ
+BczYKCFK83M0UYRWEPWgTywS4/oTmifQz/l5GnRfHXk5/Fv4cI7gklL35CX5VIPZ
+HdPIWoU/Xse2B+4+wM6ar6xWQio5JXDWv7V7Nq2s9nPczdcdioOl+yuQFTdrHCZH
+3DspVpNqs8FqOp099cGXOFgFixwR4+S0uF2FHYP+eF8LRWgYSKVGczQ7/g/IdrvH
+GPMF0Ybzhe3nudkyrVWIzqa2kbBPrH4VI5b2P/AgNBbeCsbEBEV5f6f9vtKppa+c
+xSMq9zwhbL2vj07FOrLzNBL834AaSaTUqZX3noleoomslMuoaJuvimUnzYnu3Yy1
+aylwQ6BpC+S5DwIDAQABo0IwQDAdBgNVHQ4EFgQU/qHgcB4qAzlSWkK+XJGFehiq
+TbUwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL
+BQADggEBAMJKVvoVIXsoounlHfv4LcQ5lkFMOycsxGwYFYDGrK9HWS8mC+M2sO87
+/kOXSTKZEhVb3xEp/6tT+LvBeA+snFOvV71ojD1pM/CjoCNjO2RnIkSt1XHLVip4
+kqNPEjE2NuLe/gDEo2APJ62gsIq1NnpSob0n9CAnYuhNlCQT5AoE6TyrLshDCUrG
+YQTlSTR+08TI9Q/Aqum6VF7zYytPT1DU/rl7mYw9wC68AivTxEDkigcxHpvOJpkT
++xHqmiIMERnHXhuBUDDIlhJu58tBf5E7oke3VIAb3ADMmpDqw8NQBmIMMMAVSKeo
+WXzhriKi4gp6D/piq1JM4fHfyr6DDUI=
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI
+# Subject: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI
+# Label: "emSign ECC Root CA - C3"
+# Serial: 582948710642506000014504
+# MD5 Fingerprint: 3e:53:b3:a3:81:ee:d7:10:f8:d3:b0:1d:17:92:f5:d5
+# SHA1 Fingerprint: b6:af:43:c2:9b:81:53:7d:f6:ef:6b:c3:1f:1f:60:15:0c:ee:48:66
+# SHA256 Fingerprint: bc:4d:80:9b:15:18:9d:78:db:3e:1d:8c:f4:f9:72:6a:79:5d:a1:64:3c:a5:f1:35:8e:1d:db:0e:dc:0d:7e:b3
+-----BEGIN CERTIFICATE-----
+MIICKzCCAbGgAwIBAgIKe3G2gla4EnycqDAKBggqhkjOPQQDAzBaMQswCQYDVQQG
+EwJVUzETMBEGA1UECxMKZW1TaWduIFBLSTEUMBIGA1UEChMLZU11ZGhyYSBJbmMx
+IDAeBgNVBAMTF2VtU2lnbiBFQ0MgUm9vdCBDQSAtIEMzMB4XDTE4MDIxODE4MzAw
+MFoXDTQzMDIxODE4MzAwMFowWjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln
+biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMSAwHgYDVQQDExdlbVNpZ24gRUND
+IFJvb3QgQ0EgLSBDMzB2MBAGByqGSM49AgEGBSuBBAAiA2IABP2lYa57JhAd6bci
+MK4G9IGzsUJxlTm801Ljr6/58pc1kjZGDoeVjbk5Wum739D+yAdBPLtVb4Ojavti
+sIGJAnB9SMVK4+kiVCJNk7tCDK93nCOmfddhEc5lx/h//vXyqaNCMEAwHQYDVR0O
+BBYEFPtaSNCAIEDyqOkAB2kZd6fmw/TPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMB
+Af8EBTADAQH/MAoGCCqGSM49BAMDA2gAMGUCMQC02C8Cif22TGK6Q04ThHK1rt0c
+3ta13FaPWEBaLd4gTCKDypOofu4SQMfWh0/434UCMBwUZOR8loMRnLDRWmFLpg9J
+0wD8ofzkpf9/rdcw0Md3f76BB1UwUCAU9Vc4CqgxUQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Hongkong Post Root CA 3 O=Hongkong Post
+# Subject: CN=Hongkong Post Root CA 3 O=Hongkong Post
+# Label: "Hongkong Post Root CA 3"
+# Serial: 46170865288971385588281144162979347873371282084
+# MD5 Fingerprint: 11:fc:9f:bd:73:30:02:8a:fd:3f:f3:58:b9:cb:20:f0
+# SHA1 Fingerprint: 58:a2:d0:ec:20:52:81:5b:c1:f3:f8:64:02:24:4e:c2:8e:02:4b:02
+# SHA256 Fingerprint: 5a:2f:c0:3f:0c:83:b0:90:bb:fa:40:60:4b:09:88:44:6c:76:36:18:3d:f9:84:6e:17:10:1a:44:7f:b8:ef:d6
+-----BEGIN CERTIFICATE-----
+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
+mpv0
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust Root Certification Authority - G4 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2015 Entrust, Inc. - for authorized use only
+# Subject: CN=Entrust Root Certification Authority - G4 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2015 Entrust, Inc. - for authorized use only
+# Label: "Entrust Root Certification Authority - G4"
+# Serial: 289383649854506086828220374796556676440
+# MD5 Fingerprint: 89:53:f1:83:23:b7:7c:8e:05:f1:8c:71:38:4e:1f:88
+# SHA1 Fingerprint: 14:88:4e:86:26:37:b0:26:af:59:62:5c:40:77:ec:35:29:ba:96:01
+# SHA256 Fingerprint: db:35:17:d1:f6:73:2a:2d:5a:b9:7c:53:3e:c7:07:79:ee:32:70:a6:2f:b4:ac:42:38:37:24:60:e6:f0:1e:88
+-----BEGIN CERTIFICATE-----
+MIIGSzCCBDOgAwIBAgIRANm1Q3+vqTkPAAAAAFVlrVgwDQYJKoZIhvcNAQELBQAw
+gb4xCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQL
+Ex9TZWUgd3d3LmVudHJ1c3QubmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykg
+MjAxNSBFbnRydXN0LCBJbmMuIC0gZm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMjAw
+BgNVBAMTKUVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEc0
+MB4XDTE1MDUyNzExMTExNloXDTM3MTIyNzExNDExNlowgb4xCzAJBgNVBAYTAlVT
+MRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1
+c3QubmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxNSBFbnRydXN0LCBJ
+bmMuIC0gZm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMjAwBgNVBAMTKUVudHJ1c3Qg
+Um9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEc0MIICIjANBgkqhkiG9w0B
+AQEFAAOCAg8AMIICCgKCAgEAsewsQu7i0TD/pZJH4i3DumSXbcr3DbVZwbPLqGgZ
+2K+EbTBwXX7zLtJTmeH+H17ZSK9dE43b/2MzTdMAArzE+NEGCJR5WIoV3imz/f3E
+T+iq4qA7ec2/a0My3dl0ELn39GjUu9CH1apLiipvKgS1sqbHoHrmSKvS0VnM1n4j
+5pds8ELl3FFLFUHtSUrJ3hCX1nbB76W1NhSXNdh4IjVS70O92yfbYVaCNNzLiGAM
+C1rlLAHGVK/XqsEQe9IFWrhAnoanw5CGAlZSCXqc0ieCU0plUmr1POeo8pyvi73T
+DtTUXm6Hnmo9RR3RXRv06QqsYJn7ibT/mCzPfB3pAqoEmh643IhuJbNsZvc8kPNX
+wbMv9W3y+8qh+CmdRouzavbmZwe+LGcKKh9asj5XxNMhIWNlUpEbsZmOeX7m640A
+2Vqq6nPopIICR5b+W45UYaPrL0swsIsjdXJ8ITzI9vF01Bx7owVV7rtNOzK+mndm
+nqxpkCIHH2E6lr7lmk/MBTwoWdPBDFSoWWG9yHJM6Nyfh3+9nEg2XpWjDrk4JFX8
+dWbrAuMINClKxuMrLzOg2qOGpRKX/YAr2hRC45K9PvJdXmd0LhyIRyk0X+IyqJwl
+N4y6mACXi0mWHv0liqzc2thddG5msP9E36EYxr5ILzeUePiVSj9/E15dWf10hkNj
+c0kCAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYD
+VR0OBBYEFJ84xFYjwznooHFs6FRM5Og6sb9nMA0GCSqGSIb3DQEBCwUAA4ICAQAS
+5UKme4sPDORGpbZgQIeMJX6tuGguW8ZAdjwD+MlZ9POrYs4QjbRaZIxowLByQzTS
+Gwv2LFPSypBLhmb8qoMi9IsabyZIrHZ3CL/FmFz0Jomee8O5ZDIBf9PD3Vht7LGr
+hFV0d4QEJ1JrhkzO3bll/9bGXp+aEJlLdWr+aumXIOTkdnrG0CSqkM0gkLpHZPt/
+B7NTeLUKYvJzQ85BK4FqLoUWlFPUa19yIqtRLULVAJyZv967lDtX/Zr1hstWO1uI
+AeV8KEsD+UmDfLJ/fOPtjqF/YFOOVZ1QNBIPt5d7bIdKROf1beyAN/BYGW5KaHbw
+H5Lk6rWS02FREAutp9lfx1/cH6NcjKF+m7ee01ZvZl4HliDtC3T7Zk6LERXpgUl+
+b7DUUH8i119lAg2m9IUe2K4GS0qn0jFmwvjO5QimpAKWRGhXxNUzzxkvFMSUHHuk
+2fCfDrGA4tGeEWSpiBE6doLlYsKA2KSD7ZPvfC+QsDJMlhVoSFLUmQjAJOgc47Ol
+IQ6SwJAfzyBfyjs4x7dtOvPmRLgOMWuIjnDrnBdSqEGULoe256YSxXXfW8AKbnuk
+5F6G+TaU33fD6Q3AOfF5u0aOq0NZJ7cguyPpVkAh7DE9ZapD8j3fcEThuk0mEDuY
+n/PIjhs4ViFqUZPTkcpG2om3PVODLAgfi49T3f+sHw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Microsoft ECC Root Certificate Authority 2017 O=Microsoft Corporation
+# Subject: CN=Microsoft ECC Root Certificate Authority 2017 O=Microsoft Corporation
+# Label: "Microsoft ECC Root Certificate Authority 2017"
+# Serial: 136839042543790627607696632466672567020
+# MD5 Fingerprint: dd:a1:03:e6:4a:93:10:d1:bf:f0:19:42:cb:fe:ed:67
+# SHA1 Fingerprint: 99:9a:64:c3:7f:f4:7d:9f:ab:95:f1:47:69:89:14:60:ee:c4:c3:c5
+# SHA256 Fingerprint: 35:8d:f3:9d:76:4a:f9:e1:b7:66:e9:c9:72:df:35:2e:e1:5c:fa:c2:27:af:6a:d1:d7:0e:8e:4a:6e:dc:ba:02
+-----BEGIN CERTIFICATE-----
+MIICWTCCAd+gAwIBAgIQZvI9r4fei7FK6gxXMQHC7DAKBggqhkjOPQQDAzBlMQsw
+CQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYD
+VQQDEy1NaWNyb3NvZnQgRUNDIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIw
+MTcwHhcNMTkxMjE4MjMwNjQ1WhcNNDIwNzE4MjMxNjA0WjBlMQswCQYDVQQGEwJV
+UzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1NaWNy
+b3NvZnQgRUNDIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwdjAQBgcq
+hkjOPQIBBgUrgQQAIgNiAATUvD0CQnVBEyPNgASGAlEvaqiBYgtlzPbKnR5vSmZR
+ogPZnZH6thaxjG7efM3beaYvzrvOcS/lpaso7GMEZpn4+vKTEAXhgShC48Zo9OYb
+hGBKia/teQ87zvH2RPUBeMCjVDBSMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8E
+BTADAQH/MB0GA1UdDgQWBBTIy5lycFIM+Oa+sgRXKSrPQhDtNTAQBgkrBgEEAYI3
+FQEEAwIBADAKBggqhkjOPQQDAwNoADBlAjBY8k3qDPlfXu5gKcs68tvWMoQZP3zV
+L8KxzJOuULsJMsbG7X7JNpQS5GiFBqIb0C8CMQCZ6Ra0DvpWSNSkMBaReNtUjGUB
+iudQZsIxtzm6uBoiB078a1QWIP8rtedMDE2mT3M=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Microsoft RSA Root Certificate Authority 2017 O=Microsoft Corporation
+# Subject: CN=Microsoft RSA Root Certificate Authority 2017 O=Microsoft Corporation
+# Label: "Microsoft RSA Root Certificate Authority 2017"
+# Serial: 40975477897264996090493496164228220339
+# MD5 Fingerprint: 10:ff:00:ff:cf:c9:f8:c7:7a:c0:ee:35:8e:c9:0f:47
+# SHA1 Fingerprint: 73:a5:e6:4a:3b:ff:83:16:ff:0e:dc:cc:61:8a:90:6e:4e:ae:4d:74
+# SHA256 Fingerprint: c7:41:f7:0f:4b:2a:8d:88:bf:2e:71:c1:41:22:ef:53:ef:10:eb:a0:cf:a5:e6:4c:fa:20:f4:18:85:30:73:e0
+-----BEGIN CERTIFICATE-----
+MIIFqDCCA5CgAwIBAgIQHtOXCV/YtLNHcB6qvn9FszANBgkqhkiG9w0BAQwFADBl
+MQswCQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYw
+NAYDVQQDEy1NaWNyb3NvZnQgUlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5
+IDIwMTcwHhcNMTkxMjE4MjI1MTIyWhcNNDIwNzE4MjMwMDIzWjBlMQswCQYDVQQG
+EwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1N
+aWNyb3NvZnQgUlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwggIi
+MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKW76UM4wplZEWCpW9R2LBifOZ
+Nt9GkMml7Xhqb0eRaPgnZ1AzHaGm++DlQ6OEAlcBXZxIQIJTELy/xztokLaCLeX0
+ZdDMbRnMlfl7rEqUrQ7eS0MdhweSE5CAg2Q1OQT85elss7YfUJQ4ZVBcF0a5toW1
+HLUX6NZFndiyJrDKxHBKrmCk3bPZ7Pw71VdyvD/IybLeS2v4I2wDwAW9lcfNcztm
+gGTjGqwu+UcF8ga2m3P1eDNbx6H7JyqhtJqRjJHTOoI+dkC0zVJhUXAoP8XFWvLJ
+jEm7FFtNyP9nTUwSlq31/niol4fX/V4ggNyhSyL71Imtus5Hl0dVe49FyGcohJUc
+aDDv70ngNXtk55iwlNpNhTs+VcQor1fznhPbRiefHqJeRIOkpcrVE7NLP8TjwuaG
+YaRSMLl6IE9vDzhTyzMMEyuP1pq9KsgtsRx9S1HKR9FIJ3Jdh+vVReZIZZ2vUpC6
+W6IYZVcSn2i51BVrlMRpIpj0M+Dt+VGOQVDJNE92kKz8OMHY4Xu54+OU4UZpyw4K
+UGsTuqwPN1q3ErWQgR5WrlcihtnJ0tHXUeOrO8ZV/R4O03QK0dqq6mm4lyiPSMQH
++FJDOvTKVTUssKZqwJz58oHhEmrARdlns87/I6KJClTUFLkqqNfs+avNJVgyeY+Q
+W5g5xAgGwax/Dj0ApQIDAQABo1QwUjAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/
+BAUwAwEB/zAdBgNVHQ4EFgQUCctZf4aycI8awznjwNnpv7tNsiMwEAYJKwYBBAGC
+NxUBBAMCAQAwDQYJKoZIhvcNAQEMBQADggIBAKyvPl3CEZaJjqPnktaXFbgToqZC
+LgLNFgVZJ8og6Lq46BrsTaiXVq5lQ7GPAJtSzVXNUzltYkyLDVt8LkS/gxCP81OC
+gMNPOsduET/m4xaRhPtthH80dK2Jp86519efhGSSvpWhrQlTM93uCupKUY5vVau6
+tZRGrox/2KJQJWVggEbbMwSubLWYdFQl3JPk+ONVFT24bcMKpBLBaYVu32TxU5nh
+SnUgnZUP5NbcA/FZGOhHibJXWpS2qdgXKxdJ5XbLwVaZOjex/2kskZGT4d9Mozd2
+TaGf+G0eHdP67Pv0RR0Tbc/3WeUiJ3IrhvNXuzDtJE3cfVa7o7P4NHmJweDyAmH3
+pvwPuxwXC65B2Xy9J6P9LjrRk5Sxcx0ki69bIImtt2dmefU6xqaWM/5TkshGsRGR
+xpl/j8nWZjEgQRCHLQzWwa80mMpkg/sTV9HB8Dx6jKXB/ZUhoHHBk2dxEuqPiApp
+GWSZI1b7rCoucL5mxAyE7+WL85MB+GqQk2dLsmijtWKP6T+MejteD+eMuMZ87zf9
+dOLITzNy4ZQ5bb0Sr74MTnB8G2+NszKTc0QWbej09+CVgI+WXTik9KveCjCHk9hN
+AHFiRSdLOkKEW39lt2c0Ui2cFmuqqNh7o0JMcccMyj6D5KbvtwEwXlGjefVwaaZB
+RA+GsCyRxj3qrg+E
+-----END CERTIFICATE-----
+
+# Issuer: CN=e-Szigno Root CA 2017 O=Microsec Ltd.
+# Subject: CN=e-Szigno Root CA 2017 O=Microsec Ltd.
+# Label: "e-Szigno Root CA 2017"
+# Serial: 411379200276854331539784714
+# MD5 Fingerprint: de:1f:f6:9e:84:ae:a7:b4:21:ce:1e:58:7d:d1:84:98
+# SHA1 Fingerprint: 89:d4:83:03:4f:9e:9a:48:80:5f:72:37:d4:a9:a6:ef:cb:7c:1f:d1
+# SHA256 Fingerprint: be:b0:0b:30:83:9b:9b:c3:2c:32:e4:44:79:05:95:06:41:f2:64:21:b1:5e:d0:89:19:8b:51:8a:e2:ea:1b:99
+-----BEGIN CERTIFICATE-----
+MIICQDCCAeWgAwIBAgIMAVRI7yH9l1kN9QQKMAoGCCqGSM49BAMCMHExCzAJBgNV
+BAYTAkhVMREwDwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UECgwNTWljcm9zZWMgTHRk
+LjEXMBUGA1UEYQwOVkFUSFUtMjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3ppZ25vIFJv
+b3QgQ0EgMjAxNzAeFw0xNzA4MjIxMjA3MDZaFw00MjA4MjIxMjA3MDZaMHExCzAJ
+BgNVBAYTAkhVMREwDwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UECgwNTWljcm9zZWMg
+THRkLjEXMBUGA1UEYQwOVkFUSFUtMjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3ppZ25v
+IFJvb3QgQ0EgMjAxNzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABJbcPYrYsHtv
+xie+RJCxs1YVe45DJH0ahFnuY2iyxl6H0BVIHqiQrb1TotreOpCmYF9oMrWGQd+H
+Wyx7xf58etqjYzBhMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G
+A1UdDgQWBBSHERUI0arBeAyxr87GyZDvvzAEwDAfBgNVHSMEGDAWgBSHERUI0arB
+eAyxr87GyZDvvzAEwDAKBggqhkjOPQQDAgNJADBGAiEAtVfd14pVCzbhhkT61Nlo
+jbjcI4qKDdQvfepz7L9NbKgCIQDLpbQS+ue16M9+k/zzNY9vTlp8tLxOsvxyqltZ
++efcMQ==
+-----END CERTIFICATE-----
+
+# Issuer: O=CERTSIGN SA OU=certSIGN ROOT CA G2
+# Subject: O=CERTSIGN SA OU=certSIGN ROOT CA G2
+# Label: "certSIGN Root CA G2"
+# Serial: 313609486401300475190
+# MD5 Fingerprint: 8c:f1:75:8a:c6:19:cf:94:b7:f7:65:20:87:c3:97:c7
+# SHA1 Fingerprint: 26:f9:93:b4:ed:3d:28:27:b0:b9:4b:a7:e9:15:1d:a3:8d:92:e5:32
+# SHA256 Fingerprint: 65:7c:fe:2f:a7:3f:aa:38:46:25:71:f3:32:a2:36:3a:46:fc:e7:02:09:51:71:07:02:cd:fb:b6:ee:da:33:05
+-----BEGIN CERTIFICATE-----
+MIIFRzCCAy+gAwIBAgIJEQA0tk7GNi02MA0GCSqGSIb3DQEBCwUAMEExCzAJBgNV
+BAYTAlJPMRQwEgYDVQQKEwtDRVJUU0lHTiBTQTEcMBoGA1UECxMTY2VydFNJR04g
+Uk9PVCBDQSBHMjAeFw0xNzAyMDYwOTI3MzVaFw00MjAyMDYwOTI3MzVaMEExCzAJ
+BgNVBAYTAlJPMRQwEgYDVQQKEwtDRVJUU0lHTiBTQTEcMBoGA1UECxMTY2VydFNJ
+R04gUk9PVCBDQSBHMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMDF
+dRmRfUR0dIf+DjuW3NgBFszuY5HnC2/OOwppGnzC46+CjobXXo9X69MhWf05N0Iw
+vlDqtg+piNguLWkh59E3GE59kdUWX2tbAMI5Qw02hVK5U2UPHULlj88F0+7cDBrZ
+uIt4ImfkabBoxTzkbFpG583H+u/E7Eu9aqSs/cwoUe+StCmrqzWaTOTECMYmzPhp
+n+Sc8CnTXPnGFiWeI8MgwT0PPzhAsP6CRDiqWhqKa2NYOLQV07YRaXseVO6MGiKs
+cpc/I1mbySKEwQdPzH/iV8oScLumZfNpdWO9lfsbl83kqK/20U6o2YpxJM02PbyW
+xPFsqa7lzw1uKA2wDrXKUXt4FMMgL3/7FFXhEZn91QqhngLjYl/rNUssuHLoPj1P
+rCy7Lobio3aP5ZMqz6WryFyNSwb/EkaseMsUBzXgqd+L6a8VTxaJW732jcZZroiF
+DsGJ6x9nxUWO/203Nit4ZoORUSs9/1F3dmKh7Gc+PoGD4FapUB8fepmrY7+EF3fx
+DTvf95xhszWYijqy7DwaNz9+j5LP2RIUZNoQAhVB/0/E6xyjyfqZ90bp4RjZsbgy
+LcsUDFDYg2WD7rlcz8sFWkz6GZdr1l0T08JcVLwyc6B49fFtHsufpaafItzRUZ6C
+eWRgKRM+o/1Pcmqr4tTluCRVLERLiohEnMqE0yo7AgMBAAGjQjBAMA8GA1UdEwEB
+/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBSCIS1mxteg4BXrzkwJ
+d8RgnlRuAzANBgkqhkiG9w0BAQsFAAOCAgEAYN4auOfyYILVAzOBywaK8SJJ6ejq
+kX/GM15oGQOGO0MBzwdw5AgeZYWR5hEit/UCI46uuR59H35s5r0l1ZUa8gWmr4UC
+b6741jH/JclKyMeKqdmfS0mbEVeZkkMR3rYzpMzXjWR91M08KCy0mpbqTfXERMQl
+qiCA2ClV9+BB/AYm/7k29UMUA2Z44RGx2iBfRgB4ACGlHgAoYXhvqAEBj500mv/0
+OJD7uNGzcgbJceaBxXntC6Z58hMLnPddDnskk7RI24Zf3lCGeOdA5jGokHZwYa+c
+NywRtYK3qq4kNFtyDGkNzVmf9nGvnAvRCjj5BiKDUyUM/FHE5r7iOZULJK2v0ZXk
+ltd0ZGtxTgI8qoXzIKNDOXZbbFD+mpwUHmUUihW9o4JFWklWatKcsWMy5WHgUyIO
+pwpJ6st+H6jiYoD2EEVSmAYY3qXNL3+q1Ok+CHLsIwMCPKaq2LxndD0UF/tUSxfj
+03k9bWtJySgOLnRQvwzZRjoQhsmnP+mg7H/rpXdYaXHmgwo38oZJar55CJD2AhZk
+PuXaTH4MNMn5X7azKFGnpyuqSfqNZSlO42sTp5SjLVFteAxEy9/eCG/Oo2Sr05WE
+1LlSVHJ7liXMvGnjSG4N0MedJ5qq+BOS3R7fY581qRY27Iy4g/Q9iY/NtBde17MX
+QRBdJ3NghVdJIgc=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Trustwave Global Certification Authority O=Trustwave Holdings, Inc.
+# Subject: CN=Trustwave Global Certification Authority O=Trustwave Holdings, Inc.
+# Label: "Trustwave Global Certification Authority"
+# Serial: 1846098327275375458322922162
+# MD5 Fingerprint: f8:1c:18:2d:2f:ba:5f:6d:a1:6c:bc:c7:ab:91:c7:0e
+# SHA1 Fingerprint: 2f:8f:36:4f:e1:58:97:44:21:59:87:a5:2a:9a:d0:69:95:26:7f:b5
+# SHA256 Fingerprint: 97:55:20:15:f5:dd:fc:3c:87:88:c0:06:94:45:55:40:88:94:45:00:84:f1:00:86:70:86:bc:1a:2b:b5:8d:c8
+-----BEGIN CERTIFICATE-----
+MIIF2jCCA8KgAwIBAgIMBfcOhtpJ80Y1LrqyMA0GCSqGSIb3DQEBCwUAMIGIMQsw
+CQYDVQQGEwJVUzERMA8GA1UECAwISWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28x
+ITAfBgNVBAoMGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1
+c3R3YXZlIEdsb2JhbCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0xNzA4MjMx
+OTM0MTJaFw00MjA4MjMxOTM0MTJaMIGIMQswCQYDVQQGEwJVUzERMA8GA1UECAwI
+SWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28xITAfBgNVBAoMGFRydXN0d2F2ZSBI
+b2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1c3R3YXZlIEdsb2JhbCBDZXJ0aWZp
+Y2F0aW9uIEF1dGhvcml0eTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIB
+ALldUShLPDeS0YLOvR29zd24q88KPuFd5dyqCblXAj7mY2Hf8g+CY66j96xz0Xzn
+swuvCAAJWX/NKSqIk4cXGIDtiLK0thAfLdZfVaITXdHG6wZWiYj+rDKd/VzDBcdu
+7oaJuogDnXIhhpCujwOl3J+IKMujkkkP7NAP4m1ET4BqstTnoApTAbqOl5F2brz8
+1Ws25kCI1nsvXwXoLG0R8+eyvpJETNKXpP7ScoFDB5zpET71ixpZfR9oWN0EACyW
+80OzfpgZdNmcc9kYvkHHNHnZ9GLCQ7mzJ7Aiy/k9UscwR7PJPrhq4ufogXBeQotP
+JqX+OsIgbrv4Fo7NDKm0G2x2EOFYeUY+VM6AqFcJNykbmROPDMjWLBz7BegIlT1l
+RtzuzWniTY+HKE40Cz7PFNm73bZQmq131BnW2hqIyE4bJ3XYsgjxroMwuREOzYfw
+hI0Vcnyh78zyiGG69Gm7DIwLdVcEuE4qFC49DxweMqZiNu5m4iK4BUBjECLzMx10
+coos9TkpoNPnG4CELcU9402x/RpvumUHO1jsQkUm+9jaJXLE9gCxInm943xZYkqc
+BW89zubWR2OZxiRvchLIrH+QtAuRcOi35hYQcRfO3gZPSEF9NUqjifLJS3tBEW1n
+twiYTOURGa5CgNz7kAXU+FDKvuStx8KU1xad5hePrzb7AgMBAAGjQjBAMA8GA1Ud
+EwEB/wQFMAMBAf8wHQYDVR0OBBYEFJngGWcNYtt2s9o9uFvo/ULSMQ6HMA4GA1Ud
+DwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAmHNw4rDT7TnsTGDZqRKGFx6W
+0OhUKDtkLSGm+J1WE2pIPU/HPinbbViDVD2HfSMF1OQc3Og4ZYbFdada2zUFvXfe
+uyk3QAUHw5RSn8pk3fEbK9xGChACMf1KaA0HZJDmHvUqoai7PF35owgLEQzxPy0Q
+lG/+4jSHg9bP5Rs1bdID4bANqKCqRieCNqcVtgimQlRXtpla4gt5kNdXElE1GYhB
+aCXUNxeEFfsBctyV3lImIJgm4nb1J2/6ADtKYdkNy1GTKv0WBpanI5ojSP5RvbbE
+sLFUzt5sQa0WZ37b/TjNuThOssFgy50X31ieemKyJo90lZvkWx3SD92YHJtZuSPT
+MaCm/zjdzyBP6VhWOmfD0faZmZ26NraAL4hHT4a/RDqA5Dccprrql5gR0IRiR2Qe
+qu5AvzSxnI9O4fKSTx+O856X3vOmeWqJcU9LJxdI/uz0UA9PSX3MReO9ekDFQdxh
+VicGaeVyQYHTtgGJoC86cnn+OjC/QezHYj6RS8fZMXZC+fc8Y+wmjHMMfRod6qh8
+h6jCJ3zhM0EPz8/8AKAigJ5Kp28AsEFFtyLKaEjFQqKu3R3y4G5OBVixwJAWKqQ9
+EEC+j2Jjg6mcgn0tAumDMHzLJ8n9HmYAsC7TIS+OMxZsmO0QqAfWzJPP29FpHOTK
+yeC2nOnOcXHebD8WpHk=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Trustwave Global ECC P256 Certification Authority O=Trustwave Holdings, Inc.
+# Subject: CN=Trustwave Global ECC P256 Certification Authority O=Trustwave Holdings, Inc.
+# Label: "Trustwave Global ECC P256 Certification Authority"
+# Serial: 4151900041497450638097112925
+# MD5 Fingerprint: 5b:44:e3:8d:5d:36:86:26:e8:0d:05:d2:59:a7:83:54
+# SHA1 Fingerprint: b4:90:82:dd:45:0c:be:8b:5b:b1:66:d3:e2:a4:08:26:cd:ed:42:cf
+# SHA256 Fingerprint: 94:5b:bc:82:5e:a5:54:f4:89:d1:fd:51:a7:3d:df:2e:a6:24:ac:70:19:a0:52:05:22:5c:22:a7:8c:cf:a8:b4
+-----BEGIN CERTIFICATE-----
+MIICYDCCAgegAwIBAgIMDWpfCD8oXD5Rld9dMAoGCCqGSM49BAMCMIGRMQswCQYD
+VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAf
+BgNVBAoTGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3
+YXZlIEdsb2JhbCBFQ0MgUDI1NiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0x
+NzA4MjMxOTM1MTBaFw00MjA4MjMxOTM1MTBaMIGRMQswCQYDVQQGEwJVUzERMA8G
+A1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0
+d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBF
+Q0MgUDI1NiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTBZMBMGByqGSM49AgEGCCqG
+SM49AwEHA0IABH77bOYj43MyCMpg5lOcunSNGLB4kFKA3TjASh3RqMyTpJcGOMoN
+FWLGjgEqZZ2q3zSRLoHB5DOSMcT9CTqmP62jQzBBMA8GA1UdEwEB/wQFMAMBAf8w
+DwYDVR0PAQH/BAUDAwcGADAdBgNVHQ4EFgQUo0EGrJBt0UrrdaVKEJmzsaGLSvcw
+CgYIKoZIzj0EAwIDRwAwRAIgB+ZU2g6gWrKuEZ+Hxbb/ad4lvvigtwjzRM4q3wgh
+DDcCIC0mA6AFvWvR9lz4ZcyGbbOcNEhjhAnFjXca4syc4XR7
+-----END CERTIFICATE-----
+
+# Issuer: CN=Trustwave Global ECC P384 Certification Authority O=Trustwave Holdings, Inc.
+# Subject: CN=Trustwave Global ECC P384 Certification Authority O=Trustwave Holdings, Inc.
+# Label: "Trustwave Global ECC P384 Certification Authority"
+# Serial: 2704997926503831671788816187
+# MD5 Fingerprint: ea:cf:60:c4:3b:b9:15:29:40:a1:97:ed:78:27:93:d6
+# SHA1 Fingerprint: e7:f3:a3:c8:cf:6f:c3:04:2e:6d:0e:67:32:c5:9e:68:95:0d:5e:d2
+# SHA256 Fingerprint: 55:90:38:59:c8:c0:c3:eb:b8:75:9e:ce:4e:25:57:22:5f:f5:75:8b:bd:38:eb:d4:82:76:60:1e:1b:d5:80:97
+-----BEGIN CERTIFICATE-----
+MIICnTCCAiSgAwIBAgIMCL2Fl2yZJ6SAaEc7MAoGCCqGSM49BAMDMIGRMQswCQYD
+VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAf
+BgNVBAoTGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3
+YXZlIEdsb2JhbCBFQ0MgUDM4NCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0x
+NzA4MjMxOTM2NDNaFw00MjA4MjMxOTM2NDNaMIGRMQswCQYDVQQGEwJVUzERMA8G
+A1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0
+d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBF
+Q0MgUDM4NCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTB2MBAGByqGSM49AgEGBSuB
+BAAiA2IABGvaDXU1CDFHBa5FmVXxERMuSvgQMSOjfoPTfygIOiYaOs+Xgh+AtycJ
+j9GOMMQKmw6sWASr9zZ9lCOkmwqKi6vr/TklZvFe/oyujUF5nQlgziip04pt89ZF
+1PKYhDhloKNDMEEwDwYDVR0TAQH/BAUwAwEB/zAPBgNVHQ8BAf8EBQMDBwYAMB0G
+A1UdDgQWBBRVqYSJ0sEyvRjLbKYHTsjnnb6CkDAKBggqhkjOPQQDAwNnADBkAjA3
+AZKXRRJ+oPM+rRk6ct30UJMDEr5E0k9BpIycnR+j9sKS50gU/k6bpZFXrsY3crsC
+MGclCrEMXu6pY5Jv5ZAL/mYiykf9ijH3g/56vxC+GCsej/YpHpRZ744hN8tRmKVu
+Sw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=NAVER Global Root Certification Authority O=NAVER BUSINESS PLATFORM Corp.
+# Subject: CN=NAVER Global Root Certification Authority O=NAVER BUSINESS PLATFORM Corp.
+# Label: "NAVER Global Root Certification Authority"
+# Serial: 9013692873798656336226253319739695165984492813
+# MD5 Fingerprint: c8:7e:41:f6:25:3b:f5:09:b3:17:e8:46:3d:bf:d0:9b
+# SHA1 Fingerprint: 8f:6b:f2:a9:27:4a:da:14:a0:c4:f4:8e:61:27:f9:c0:1e:78:5d:d1
+# SHA256 Fingerprint: 88:f4:38:dc:f8:ff:d1:fa:8f:42:91:15:ff:e5:f8:2a:e1:e0:6e:0c:70:c3:75:fa:ad:71:7b:34:a4:9e:72:65
+-----BEGIN CERTIFICATE-----
+MIIFojCCA4qgAwIBAgIUAZQwHqIL3fXFMyqxQ0Rx+NZQTQ0wDQYJKoZIhvcNAQEM
+BQAwaTELMAkGA1UEBhMCS1IxJjAkBgNVBAoMHU5BVkVSIEJVU0lORVNTIFBMQVRG
+T1JNIENvcnAuMTIwMAYDVQQDDClOQVZFUiBHbG9iYWwgUm9vdCBDZXJ0aWZpY2F0
+aW9uIEF1dGhvcml0eTAeFw0xNzA4MTgwODU4NDJaFw0zNzA4MTgyMzU5NTlaMGkx
+CzAJBgNVBAYTAktSMSYwJAYDVQQKDB1OQVZFUiBCVVNJTkVTUyBQTEFURk9STSBD
+b3JwLjEyMDAGA1UEAwwpTkFWRVIgR2xvYmFsIFJvb3QgQ2VydGlmaWNhdGlvbiBB
+dXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC21PGTXLVA
+iQqrDZBbUGOukJR0F0Vy1ntlWilLp1agS7gvQnXp2XskWjFlqxcX0TM62RHcQDaH
+38dq6SZeWYp34+hInDEW+j6RscrJo+KfziFTowI2MMtSAuXaMl3Dxeb57hHHi8lE
+HoSTGEq0n+USZGnQJoViAbbJAh2+g1G7XNr4rRVqmfeSVPc0W+m/6imBEtRTkZaz
+kVrd/pBzKPswRrXKCAfHcXLJZtM0l/aM9BhK4dA9WkW2aacp+yPOiNgSnABIqKYP
+szuSjXEOdMWLyEz59JuOuDxp7W87UC9Y7cSw0BwbagzivESq2M0UXZR4Yb8Obtoq
+vC8MC3GmsxY/nOb5zJ9TNeIDoKAYv7vxvvTWjIcNQvcGufFt7QSUqP620wbGQGHf
+nZ3zVHbOUzoBppJB7ASjjw2i1QnK1sua8e9DXcCrpUHPXFNwcMmIpi3Ua2FzUCaG
+YQ5fG8Ir4ozVu53BA0K6lNpfqbDKzE0K70dpAy8i+/Eozr9dUGWokG2zdLAIx6yo
+0es+nPxdGoMuK8u180SdOqcXYZaicdNwlhVNt0xz7hlcxVs+Qf6sdWA7G2POAN3a
+CJBitOUt7kinaxeZVL6HSuOpXgRM6xBtVNbv8ejyYhbLgGvtPe31HzClrkvJE+2K
+AQHJuFFYwGY6sWZLxNUxAmLpdIQM201GLQIDAQABo0IwQDAdBgNVHQ4EFgQU0p+I
+36HNLL3s9TsBAZMzJ7LrYEswDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMB
+Af8wDQYJKoZIhvcNAQEMBQADggIBADLKgLOdPVQG3dLSLvCkASELZ0jKbY7gyKoN
+qo0hV4/GPnrK21HUUrPUloSlWGB/5QuOH/XcChWB5Tu2tyIvCZwTFrFsDDUIbatj
+cu3cvuzHV+YwIHHW1xDBE1UBjCpD5EHxzzp6U5LOogMFDTjfArsQLtk70pt6wKGm
++LUx5vR1yblTmXVHIloUFcd4G7ad6Qz4G3bxhYTeodoS76TiEJd6eN4MUZeoIUCL
+hr0N8F5OSza7OyAfikJW4Qsav3vQIkMsRIz75Sq0bBwcupTgE34h5prCy8VCZLQe
+lHsIJchxzIdFV4XTnyliIoNRlwAYl3dqmJLJfGBs32x9SuRwTMKeuB330DTHD8z7
+p/8Dvq1wkNoL3chtl1+afwkyQf3NosxabUzyqkn+Zvjp2DXrDige7kgvOtB5CTh8
+piKCk5XQA76+AqAF3SAi428diDRgxuYKuQl1C/AH6GmWNcf7I4GOODm4RStDeKLR
+LBT/DShycpWbXgnbiUSYqqFJu3FS8r/2/yehNq+4tneI3TqkbZs0kNwUXTC/t+sX
+5Ie3cdCh13cV1ELX8vMxmV2b3RZtP+oGI/hGoiLtk/bdmuYqh7GYVPEi92tF4+KO
+dh2ajcQGjTa3FPOdVGm3jjzVpG2Tgbet9r1ke8LJaDmgkpzNNIaRkPpkUZ3+/uul
+9XXeifdy
+-----END CERTIFICATE-----
+
+# Issuer: CN=AC RAIZ FNMT-RCM SERVIDORES SEGUROS O=FNMT-RCM OU=Ceres
+# Subject: CN=AC RAIZ FNMT-RCM SERVIDORES SEGUROS O=FNMT-RCM OU=Ceres
+# Label: "AC RAIZ FNMT-RCM SERVIDORES SEGUROS"
+# Serial: 131542671362353147877283741781055151509
+# MD5 Fingerprint: 19:36:9c:52:03:2f:d2:d1:bb:23:cc:dd:1e:12:55:bb
+# SHA1 Fingerprint: 62:ff:d9:9e:c0:65:0d:03:ce:75:93:d2:ed:3f:2d:32:c9:e3:e5:4a
+# SHA256 Fingerprint: 55:41:53:b1:3d:2c:f9:dd:b7:53:bf:be:1a:4e:0a:e0:8d:0a:a4:18:70:58:fe:60:a2:b8:62:b2:e4:b8:7b:cb
+-----BEGIN CERTIFICATE-----
+MIICbjCCAfOgAwIBAgIQYvYybOXE42hcG2LdnC6dlTAKBggqhkjOPQQDAzB4MQsw
+CQYDVQQGEwJFUzERMA8GA1UECgwIRk5NVC1SQ00xDjAMBgNVBAsMBUNlcmVzMRgw
+FgYDVQRhDA9WQVRFUy1RMjgyNjAwNEoxLDAqBgNVBAMMI0FDIFJBSVogRk5NVC1S
+Q00gU0VSVklET1JFUyBTRUdVUk9TMB4XDTE4MTIyMDA5MzczM1oXDTQzMTIyMDA5
+MzczM1oweDELMAkGA1UEBhMCRVMxETAPBgNVBAoMCEZOTVQtUkNNMQ4wDAYDVQQL
+DAVDZXJlczEYMBYGA1UEYQwPVkFURVMtUTI4MjYwMDRKMSwwKgYDVQQDDCNBQyBS
+QUlaIEZOTVQtUkNNIFNFUlZJRE9SRVMgU0VHVVJPUzB2MBAGByqGSM49AgEGBSuB
+BAAiA2IABPa6V1PIyqvfNkpSIeSX0oNnnvBlUdBeh8dHsVnyV0ebAAKTRBdp20LH
+sbI6GA60XYyzZl2hNPk2LEnb80b8s0RpRBNm/dfF/a82Tc4DTQdxz69qBdKiQ1oK
+Um8BA06Oi6NCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYD
+VR0OBBYEFAG5L++/EYZg8k/QQW6rcx/n0m5JMAoGCCqGSM49BAMDA2kAMGYCMQCu
+SuMrQMN0EfKVrRYj3k4MGuZdpSRea0R7/DjiT8ucRRcRTBQnJlU5dUoDzBOQn5IC
+MQD6SmxgiHPz7riYYqnOK8LZiqZwMR2vsJRM60/G49HzYqc8/5MuB1xJAWdpEgJy
+v+c=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign Root R46 O=GlobalSign nv-sa
+# Subject: CN=GlobalSign Root R46 O=GlobalSign nv-sa
+# Label: "GlobalSign Root R46"
+# Serial: 1552617688466950547958867513931858518042577
+# MD5 Fingerprint: c4:14:30:e4:fa:66:43:94:2a:6a:1b:24:5f:19:d0:ef
+# SHA1 Fingerprint: 53:a2:b0:4b:ca:6b:d6:45:e6:39:8a:8e:c4:0d:d2:bf:77:c3:a2:90
+# SHA256 Fingerprint: 4f:a3:12:6d:8d:3a:11:d1:c4:85:5a:4f:80:7c:ba:d6:cf:91:9d:3a:5a:88:b0:3b:ea:2c:63:72:d9:3c:40:c9
+-----BEGIN CERTIFICATE-----
+MIIFWjCCA0KgAwIBAgISEdK7udcjGJ5AXwqdLdDfJWfRMA0GCSqGSIb3DQEBDAUA
+MEYxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYD
+VQQDExNHbG9iYWxTaWduIFJvb3QgUjQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMy
+MDAwMDAwMFowRjELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYt
+c2ExHDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEB
+AQUAA4ICDwAwggIKAoICAQCsrHQy6LNl5brtQyYdpokNRbopiLKkHWPd08EsCVeJ
+OaFV6Wc0dwxu5FUdUiXSE2te4R2pt32JMl8Nnp8semNgQB+msLZ4j5lUlghYruQG
+vGIFAha/r6gjA7aUD7xubMLL1aa7DOn2wQL7Id5m3RerdELv8HQvJfTqa1VbkNud
+316HCkD7rRlr+/fKYIje2sGP1q7Vf9Q8g+7XFkyDRTNrJ9CG0Bwta/OrffGFqfUo
+0q3v84RLHIf8E6M6cqJaESvWJ3En7YEtbWaBkoe0G1h6zD8K+kZPTXhc+CtI4wSE
+y132tGqzZfxCnlEmIyDLPRT5ge1lFgBPGmSXZgjPjHvjK8Cd+RTyG/FWaha/LIWF
+zXg4mutCagI0GIMXTpRW+LaCtfOW3T3zvn8gdz57GSNrLNRyc0NXfeD412lPFzYE
++cCQYDdF3uYM2HSNrpyibXRdQr4G9dlkbgIQrImwTDsHTUB+JMWKmIJ5jqSngiCN
+I/onccnfxkF0oE32kRbcRoxfKWMxWXEM2G/CtjJ9++ZdU6Z+Ffy7dXxd7Pj2Fxzs
+x2sZy/N78CsHpdlseVR2bJ0cpm4O6XkMqCNqo98bMDGfsVR7/mrLZqrcZdCinkqa
+ByFrgY/bxFn63iLABJzjqls2k+g9vXqhnQt2sQvHnf3PmKgGwvgqo6GDoLclcqUC
+4wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
+HQ4EFgQUA1yrc4GHqMywptWU4jaWSf8FmSwwDQYJKoZIhvcNAQEMBQADggIBAHx4
+7PYCLLtbfpIrXTncvtgdokIzTfnvpCo7RGkerNlFo048p9gkUbJUHJNOxO97k4Vg
+JuoJSOD1u8fpaNK7ajFxzHmuEajwmf3lH7wvqMxX63bEIaZHU1VNaL8FpO7XJqti
+2kM3S+LGteWygxk6x9PbTZ4IevPuzz5i+6zoYMzRx6Fcg0XERczzF2sUyQQCPtIk
+pnnpHs6i58FZFZ8d4kuaPp92CC1r2LpXFNqD6v6MVenQTqnMdzGxRBF6XLE+0xRF
+FRhiJBPSy03OXIPBNvIQtQ6IbbjhVp+J3pZmOUdkLG5NrmJ7v2B0GbhWrJKsFjLt
+rWhV/pi60zTe9Mlhww6G9kuEYO4Ne7UyWHmRVSyBQ7N0H3qqJZ4d16GLuc1CLgSk
+ZoNNiTW2bKg2SnkheCLQQrzRQDGQob4Ez8pn7fXwgNNgyYMqIgXQBztSvwyeqiv5
+u+YfjyW6hY0XHgL+XVAEV8/+LbzvXMAaq7afJMbfc2hIkCwU9D9SGuTSyxTDYWnP
+4vkYxboznxSjBF25cfe1lNj2M8FawTSLfJvdkzrnE6JwYZ+vj+vYxXX4M2bUdGc6
+N3ec592kD3ZDZopD8p/7DEJ4Y9HiD2971KE9dJeFt0g5QdYg/NA6s/rob8SKunE3
+vouXsXgxT7PntgMTzlSdriVZzH81Xwj3QEUxeCp6
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign Root E46 O=GlobalSign nv-sa
+# Subject: CN=GlobalSign Root E46 O=GlobalSign nv-sa
+# Label: "GlobalSign Root E46"
+# Serial: 1552617690338932563915843282459653771421763
+# MD5 Fingerprint: b5:b8:66:ed:de:08:83:e3:c9:e2:01:34:06:ac:51:6f
+# SHA1 Fingerprint: 39:b4:6c:d5:fe:80:06:eb:e2:2f:4a:bb:08:33:a0:af:db:b9:dd:84
+# SHA256 Fingerprint: cb:b9:c4:4d:84:b8:04:3e:10:50:ea:31:a6:9f:51:49:55:d7:bf:d2:e2:c6:b4:93:01:01:9a:d6:1d:9f:50:58
+-----BEGIN CERTIFICATE-----
+MIICCzCCAZGgAwIBAgISEdK7ujNu1LzmJGjFDYQdmOhDMAoGCCqGSM49BAMDMEYx
+CzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYDVQQD
+ExNHbG9iYWxTaWduIFJvb3QgRTQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMyMDAw
+MDAwMFowRjELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2Ex
+HDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBFNDYwdjAQBgcqhkjOPQIBBgUrgQQA
+IgNiAAScDrHPt+ieUnd1NPqlRqetMhkytAepJ8qUuwzSChDH2omwlwxwEwkBjtjq
+R+q+soArzfwoDdusvKSGN+1wCAB16pMLey5SnCNoIwZD7JIvU4Tb+0cUB+hflGdd
+yXqBPCCjQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud
+DgQWBBQxCpCPtsad0kRLgLWi5h+xEk8blTAKBggqhkjOPQQDAwNoADBlAjEA31SQ
+7Zvvi5QCkxeCmb6zniz2C5GMn0oUsfZkvLtoURMMA/cVi4RguYv/Uo7njLwcAjA8
++RHUjE7AwWHCFUyqqx0LMV87HOIAl0Qx5v5zli/altP+CAezNIm8BZ/3Hobui3A=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GLOBALTRUST 2020 O=e-commerce monitoring GmbH
+# Subject: CN=GLOBALTRUST 2020 O=e-commerce monitoring GmbH
+# Label: "GLOBALTRUST 2020"
+# Serial: 109160994242082918454945253
+# MD5 Fingerprint: 8a:c7:6f:cb:6d:e3:cc:a2:f1:7c:83:fa:0e:78:d7:e8
+# SHA1 Fingerprint: d0:67:c1:13:51:01:0c:aa:d0:c7:6a:65:37:31:16:26:4f:53:71:a2
+# SHA256 Fingerprint: 9a:29:6a:51:82:d1:d4:51:a2:e3:7f:43:9b:74:da:af:a2:67:52:33:29:f9:0f:9a:0d:20:07:c3:34:e2:3c:9a
+-----BEGIN CERTIFICATE-----
+MIIFgjCCA2qgAwIBAgILWku9WvtPilv6ZeUwDQYJKoZIhvcNAQELBQAwTTELMAkG
+A1UEBhMCQVQxIzAhBgNVBAoTGmUtY29tbWVyY2UgbW9uaXRvcmluZyBHbWJIMRkw
+FwYDVQQDExBHTE9CQUxUUlVTVCAyMDIwMB4XDTIwMDIxMDAwMDAwMFoXDTQwMDYx
+MDAwMDAwMFowTTELMAkGA1UEBhMCQVQxIzAhBgNVBAoTGmUtY29tbWVyY2UgbW9u
+aXRvcmluZyBHbWJIMRkwFwYDVQQDExBHTE9CQUxUUlVTVCAyMDIwMIICIjANBgkq
+hkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAri5WrRsc7/aVj6B3GyvTY4+ETUWiD59b
+RatZe1E0+eyLinjF3WuvvcTfk0Uev5E4C64OFudBc/jbu9G4UeDLgztzOG53ig9Z
+YybNpyrOVPu44sB8R85gfD+yc/LAGbaKkoc1DZAoouQVBGM+uq/ufF7MpotQsjj3
+QWPKzv9pj2gOlTblzLmMCcpL3TGQlsjMH/1WljTbjhzqLL6FLmPdqqmV0/0plRPw
+yJiT2S0WR5ARg6I6IqIoV6Lr/sCMKKCmfecqQjuCgGOlYx8ZzHyyZqjC0203b+J+
+BlHZRYQfEs4kUmSFC0iAToexIiIwquuuvuAC4EDosEKAA1GqtH6qRNdDYfOiaxaJ
+SaSjpCuKAsR49GiKweR6NrFvG5Ybd0mN1MkGco/PU+PcF4UgStyYJ9ORJitHHmkH
+r96i5OTUawuzXnzUJIBHKWk7buis/UDr2O1xcSvy6Fgd60GXIsUf1DnQJ4+H4xj0
+4KlGDfV0OoIu0G4skaMxXDtG6nsEEFZegB31pWXogvziB4xiRfUg3kZwhqG8k9Me
+dKZssCz3AwyIDMvUclOGvGBG85hqwvG/Q/lwIHfKN0F5VVJjjVsSn8VoxIidrPIw
+q7ejMZdnrY8XD2zHc+0klGvIg5rQmjdJBKuxFshsSUktq6HQjJLyQUp5ISXbY9e2
+nKd+Qmn7OmMCAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC
+AQYwHQYDVR0OBBYEFNwuH9FhN3nkq9XVsxJxaD1qaJwiMB8GA1UdIwQYMBaAFNwu
+H9FhN3nkq9XVsxJxaD1qaJwiMA0GCSqGSIb3DQEBCwUAA4ICAQCR8EICaEDuw2jA
+VC/f7GLDw56KoDEoqoOOpFaWEhCGVrqXctJUMHytGdUdaG/7FELYjQ7ztdGl4wJC
+XtzoRlgHNQIw4Lx0SsFDKv/bGtCwr2zD/cuz9X9tAy5ZVp0tLTWMstZDFyySCstd
+6IwPS3BD0IL/qMy/pJTAvoe9iuOTe8aPmxadJ2W8esVCgmxcB9CpwYhgROmYhRZf
++I/KARDOJcP5YBugxZfD0yyIMaK9MOzQ0MAS8cE54+X1+NZK3TTN+2/BT+MAi1bi
+kvcoskJ3ciNnxz8RFbLEAwW+uxF7Cr+obuf/WEPPm2eggAe2HcqtbepBEX4tdJP7
+wry+UUTF72glJ4DjyKDUEuzZpTcdN3y0kcra1LGWge9oXHYQSa9+pTeAsRxSvTOB
+TI/53WXZFM2KJVj04sWDpQmQ1GwUY7VA3+vA/MRYfg0UFodUJ25W5HCEuGwyEn6C
+MUO+1918oa2u1qsgEu8KwxCMSZY13At1XrFP1U80DhEgB3VDRemjEdqso5nCtnkn
+4rnvyOL2NSl6dPrFf4IFYqYK6miyeUcGbvJXqBUzxvd4Sj1Ce2t+/vdG6tHrju+I
+aFvowdlxfv1k7/9nR4hYJS8+hge9+6jlgqispdNpQ80xiEmEU5LAsTkbOYMBMMTy
+qfrQA71yN2BWHzZ8vTmR9W0Nv3vXkg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=ANF Secure Server Root CA O=ANF Autoridad de Certificacion OU=ANF CA Raiz
+# Subject: CN=ANF Secure Server Root CA O=ANF Autoridad de Certificacion OU=ANF CA Raiz
+# Label: "ANF Secure Server Root CA"
+# Serial: 996390341000653745
+# MD5 Fingerprint: 26:a6:44:5a:d9:af:4e:2f:b2:1d:b6:65:b0:4e:e8:96
+# SHA1 Fingerprint: 5b:6e:68:d0:cc:15:b6:a0:5f:1e:c1:5f:ae:02:fc:6b:2f:5d:6f:74
+# SHA256 Fingerprint: fb:8f:ec:75:91:69:b9:10:6b:1e:51:16:44:c6:18:c5:13:04:37:3f:6c:06:43:08:8d:8b:ef:fd:1b:99:75:99
+-----BEGIN CERTIFICATE-----
+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
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certum EC-384 CA O=Asseco Data Systems S.A. OU=Certum Certification Authority
+# Subject: CN=Certum EC-384 CA O=Asseco Data Systems S.A. OU=Certum Certification Authority
+# Label: "Certum EC-384 CA"
+# Serial: 160250656287871593594747141429395092468
+# MD5 Fingerprint: b6:65:b3:96:60:97:12:a1:ec:4e:e1:3d:a3:c6:c9:f1
+# SHA1 Fingerprint: f3:3e:78:3c:ac:df:f4:a2:cc:ac:67:55:69:56:d7:e5:16:3c:e1:ed
+# SHA256 Fingerprint: 6b:32:80:85:62:53:18:aa:50:d1:73:c9:8d:8b:da:09:d5:7e:27:41:3d:11:4c:f7:87:a0:f5:d0:6c:03:0c:f6
+-----BEGIN CERTIFICATE-----
+MIICZTCCAeugAwIBAgIQeI8nXIESUiClBNAt3bpz9DAKBggqhkjOPQQDAzB0MQsw
+CQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBTLkEuMScw
+JQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxGTAXBgNVBAMT
+EENlcnR1bSBFQy0zODQgQ0EwHhcNMTgwMzI2MDcyNDU0WhcNNDMwMzI2MDcyNDU0
+WjB0MQswCQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBT
+LkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxGTAX
+BgNVBAMTEENlcnR1bSBFQy0zODQgQ0EwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAATE
+KI6rGFtqvm5kN2PkzeyrOvfMobgOgknXhimfoZTy42B4mIF4Bk3y7JoOV2CDn7Tm
+Fy8as10CW4kjPMIRBSqniBMY81CE1700LCeJVf/OTOffph8oxPBUw7l8t1Ot68Kj
+QjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI0GZnQkdjrzife81r1HfS+8
+EF9LMA4GA1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNoADBlAjADVS2m5hjEfO/J
+UG7BJw+ch69u1RsIGL2SKcHvlJF40jocVYli5RsJHrpka/F2tNQCMQC0QoSZ/6vn
+nvuRlydd3LBbMHHOXjgaatkl5+r3YZJW+OraNsKHZZYuciUvf9/DE8k=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certum Trusted Root CA O=Asseco Data Systems S.A. OU=Certum Certification Authority
+# Subject: CN=Certum Trusted Root CA O=Asseco Data Systems S.A. OU=Certum Certification Authority
+# Label: "Certum Trusted Root CA"
+# Serial: 40870380103424195783807378461123655149
+# MD5 Fingerprint: 51:e1:c2:e7:fe:4c:84:af:59:0e:2f:f4:54:6f:ea:29
+# SHA1 Fingerprint: c8:83:44:c0:18:ae:9f:cc:f1:87:b7:8f:22:d1:c5:d7:45:84:ba:e5
+# SHA256 Fingerprint: fe:76:96:57:38:55:77:3e:37:a9:5e:7a:d4:d9:cc:96:c3:01:57:c1:5d:31:76:5b:a9:b1:57:04:e1:ae:78:fd
+-----BEGIN CERTIFICATE-----
+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
+-----END CERTIFICATE-----
+
+# Issuer: CN=TunTrust Root CA O=Agence Nationale de Certification Electronique
+# Subject: CN=TunTrust Root CA O=Agence Nationale de Certification Electronique
+# Label: "TunTrust Root CA"
+# Serial: 108534058042236574382096126452369648152337120275
+# MD5 Fingerprint: 85:13:b9:90:5b:36:5c:b6:5e:b8:5a:f8:e0:31:57:b4
+# SHA1 Fingerprint: cf:e9:70:84:0f:e0:73:0f:9d:f6:0c:7f:2c:4b:ee:20:46:34:9c:bb
+# SHA256 Fingerprint: 2e:44:10:2a:b5:8c:b8:54:19:45:1c:8e:19:d9:ac:f3:66:2c:af:bc:61:4b:6a:53:96:0a:30:f7:d0:e2:eb:41
+-----BEGIN CERTIFICATE-----
+MIIFszCCA5ugAwIBAgIUEwLV4kBMkkaGFmddtLu7sms+/BMwDQYJKoZIhvcNAQEL
+BQAwYTELMAkGA1UEBhMCVE4xNzA1BgNVBAoMLkFnZW5jZSBOYXRpb25hbGUgZGUg
+Q2VydGlmaWNhdGlvbiBFbGVjdHJvbmlxdWUxGTAXBgNVBAMMEFR1blRydXN0IFJv
+b3QgQ0EwHhcNMTkwNDI2MDg1NzU2WhcNNDQwNDI2MDg1NzU2WjBhMQswCQYDVQQG
+EwJUTjE3MDUGA1UECgwuQWdlbmNlIE5hdGlvbmFsZSBkZSBDZXJ0aWZpY2F0aW9u
+IEVsZWN0cm9uaXF1ZTEZMBcGA1UEAwwQVHVuVHJ1c3QgUm9vdCBDQTCCAiIwDQYJ
+KoZIhvcNAQEBBQADggIPADCCAgoCggIBAMPN0/y9BFPdDCA61YguBUtB9YOCfvdZ
+n56eY+hz2vYGqU8ftPkLHzmMmiDQfgbU7DTZhrx1W4eI8NLZ1KMKsmwb60ksPqxd
+2JQDoOw05TDENX37Jk0bbjBU2PWARZw5rZzJJQRNmpA+TkBuimvNKWfGzC3gdOgF
+VwpIUPp6Q9p+7FuaDmJ2/uqdHYVy7BG7NegfJ7/Boce7SBbdVtfMTqDhuazb1YMZ
+GoXRlJfXyqNlC/M4+QKu3fZnz8k/9YosRxqZbwUN/dAdgjH8KcwAWJeRTIAAHDOF
+li/LQcKLEITDCSSJH7UP2dl3RxiSlGBcx5kDPP73lad9UKGAwqmDrViWVSHbhlnU
+r8a83YFuB9tgYv7sEG7aaAH0gxupPqJbI9dkxt/con3YS7qC0lH4Zr8GRuR5KiY2
+eY8fTpkdso8MDhz/yV3A/ZAQprE38806JG60hZC/gLkMjNWb1sjxVj8agIl6qeIb
+MlEsPvLfe/ZdeikZjuXIvTZxi11Mwh0/rViizz1wTaZQmCXcI/m4WEEIcb9PuISg
+jwBUFfyRbVinljvrS5YnzWuioYasDXxU5mZMZl+QviGaAkYt5IPCgLnPSz7ofzwB
+7I9ezX/SKEIBlYrilz0QIX32nRzFNKHsLA4KUiwSVXAkPcvCFDVDXSdOvsC9qnyW
+5/yeYa1E0wCXAgMBAAGjYzBhMB0GA1UdDgQWBBQGmpsfU33x9aTI04Y+oXNZtPdE
+ITAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFAaamx9TffH1pMjThj6hc1m0
+90QhMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAqgVutt0Vyb+z
+xiD2BkewhpMl0425yAA/l/VSJ4hxyXT968pk21vvHl26v9Hr7lxpuhbI87mP0zYu
+QEkHDVneixCwSQXi/5E/S7fdAo74gShczNxtr18UnH1YeA32gAm56Q6XKRm4t+v4
+FstVEuTGfbvE7Pi1HE4+Z7/FXxttbUcoqgRYYdZ2vyJ/0Adqp2RT8JeNnYA/u8EH
+22Wv5psymsNUk8QcCMNE+3tjEUPRahphanltkE8pjkcFwRJpadbGNjHh/PqAulxP
+xOu3Mqz4dWEX1xAZufHSCe96Qp1bWgvUxpVOKs7/B9dPfhgGiPEZtdmYu65xxBzn
+dFlY7wyJz4sfdZMaBBSSSFCp61cpABbjNhzI+L/wM9VBD8TMPN3pM0MBkRArHtG5
+Xc0yGYuPjCB31yLEQtyEFpslbei0VXF/sHyz03FJuc9SpAQ/3D2gu68zngowYI7b
+nV2UqL1g52KAdoGDDIzMMEZJ4gzSqK/rYXHv5yJiqfdcZGyfFoxnNidF9Ql7v/YQ
+CvGwjVRDjAS6oz/v4jXH+XTgbzRB0L9zZVcg+ZtnemZoJE6AZb0QmQZZ8mWvuMZH
+u/2QeItBcy6vVR/cO5JyboTT0GFMDcx2V+IthSIVNg3rAZ3r2OvEhJn7wAzMMujj
+d9qDRIueVSjAi1jTkD5OGwDxFa2DK5o=
+-----END CERTIFICATE-----
+
+# Issuer: CN=HARICA TLS RSA Root CA 2021 O=Hellenic Academic and Research Institutions CA
+# Subject: CN=HARICA TLS RSA Root CA 2021 O=Hellenic Academic and Research Institutions CA
+# Label: "HARICA TLS RSA Root CA 2021"
+# Serial: 76817823531813593706434026085292783742
+# MD5 Fingerprint: 65:47:9b:58:86:dd:2c:f0:fc:a2:84:1f:1e:96:c4:91
+# SHA1 Fingerprint: 02:2d:05:82:fa:88:ce:14:0c:06:79:de:7f:14:10:e9:45:d7:a5:6d
+# SHA256 Fingerprint: d9:5d:0e:8e:da:79:52:5b:f9:be:b1:1b:14:d2:10:0d:32:94:98:5f:0c:62:d9:fa:bd:9c:d9:99:ec:cb:7b:1d
+-----BEGIN CERTIFICATE-----
+MIIFpDCCA4ygAwIBAgIQOcqTHO9D88aOk8f0ZIk4fjANBgkqhkiG9w0BAQsFADBs
+MQswCQYDVQQGEwJHUjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl
+c2VhcmNoIEluc3RpdHV0aW9ucyBDQTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBSU0Eg
+Um9vdCBDQSAyMDIxMB4XDTIxMDIxOTEwNTUzOFoXDTQ1MDIxMzEwNTUzN1owbDEL
+MAkGA1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNl
+YXJjaCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgUlNBIFJv
+b3QgQ0EgMjAyMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAIvC569l
+mwVnlskNJLnQDmT8zuIkGCyEf3dRywQRNrhe7Wlxp57kJQmXZ8FHws+RFjZiPTgE
+4VGC/6zStGndLuwRo0Xua2s7TL+MjaQenRG56Tj5eg4MmOIjHdFOY9TnuEFE+2uv
+a9of08WRiFukiZLRgeaMOVig1mlDqa2YUlhu2wr7a89o+uOkXjpFc5gH6l8Cct4M
+pbOfrqkdtx2z/IpZ525yZa31MJQjB/OCFks1mJxTuy/K5FrZx40d/JiZ+yykgmvw
+Kh+OC19xXFyuQnspiYHLA6OZyoieC0AJQTPb5lh6/a6ZcMBaD9YThnEvdmn8kN3b
+LW7R8pv1GmuebxWMevBLKKAiOIAkbDakO/IwkfN4E8/BPzWr8R0RI7VDIp4BkrcY
+AuUR0YLbFQDMYTfBKnya4dC6s1BG7oKsnTH4+yPiAwBIcKMJJnkVU2DzOFytOOqB
+AGMUuTNe3QvboEUHGjMJ+E20pwKmafTCWQWIZYVWrkvL4N48fS0ayOn7H6NhStYq
+E613TBoYm5EPWNgGVMWX+Ko/IIqmhaZ39qb8HOLubpQzKoNQhArlT4b4UEV4AIHr
+W2jjJo3Me1xR9BQsQL4aYB16cmEdH2MtiKrOokWQCPxrvrNQKlr9qEgYRtaQQJKQ
+CoReaDH46+0N0x3GfZkYVVYnZS6NRcUk7M7jAgMBAAGjQjBAMA8GA1UdEwEB/wQF
+MAMBAf8wHQYDVR0OBBYEFApII6ZgpJIKM+qTW8VX6iVNvRLuMA4GA1UdDwEB/wQE
+AwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAPpBIqm5iFSVmewzVjIuJndftTgfvnNAU
+X15QvWiWkKQUEapobQk1OUAJ2vQJLDSle1mESSmXdMgHHkdt8s4cUCbjnj1AUz/3
+f5Z2EMVGpdAgS1D0NTsY9FVqQRtHBmg8uwkIYtlfVUKqrFOFrJVWNlar5AWMxaja
+H6NpvVMPxP/cyuN+8kyIhkdGGvMA9YCRotxDQpSbIPDRzbLrLFPCU3hKTwSUQZqP
+JzLB5UkZv/HywouoCjkxKLR9YjYsTewfM7Z+d21+UPCfDtcRj88YxeMn/ibvBZ3P
+zzfF0HvaO7AWhAw6k9a+F9sPPg4ZeAnHqQJyIkv3N3a6dcSFA1pj1bF1BcK5vZSt
+jBWZp5N99sXzqnTPBIWUmAD04vnKJGW/4GKvyMX6ssmeVkjaef2WdhW+o45WxLM0
+/L5H9MG0qPzVMIho7suuyWPEdr6sOBjhXlzPrjoiUevRi7PzKzMHVIf6tLITe7pT
+BGIBnfHAT+7hOtSLIBD6Alfm78ELt5BGnBkpjNxvoEppaZS3JGWg/6w/zgH7IS79
+aPib8qXPMThcFarmlwDB31qlpzmq6YR/PFGoOtmUW4y/Twhx5duoXNTSpv4Ao8YW
+xw/ogM4cKGR0GQjTQuPOAF1/sdwTsOEFy9EgqoZ0njnnkf3/W9b3raYvAwtt41dU
+63ZTGI0RmLo=
+-----END CERTIFICATE-----
+
+# Issuer: CN=HARICA TLS ECC Root CA 2021 O=Hellenic Academic and Research Institutions CA
+# Subject: CN=HARICA TLS ECC Root CA 2021 O=Hellenic Academic and Research Institutions CA
+# Label: "HARICA TLS ECC Root CA 2021"
+# Serial: 137515985548005187474074462014555733966
+# MD5 Fingerprint: ae:f7:4c:e5:66:35:d1:b7:9b:8c:22:93:74:d3:4b:b0
+# SHA1 Fingerprint: bc:b0:c1:9d:e9:98:92:70:19:38:57:e9:8d:a7:b4:5d:6e:ee:01:48
+# SHA256 Fingerprint: 3f:99:cc:47:4a:cf:ce:4d:fe:d5:87:94:66:5e:47:8d:15:47:73:9f:2e:78:0f:1b:b4:ca:9b:13:30:97:d4:01
+-----BEGIN CERTIFICATE-----
+MIICVDCCAdugAwIBAgIQZ3SdjXfYO2rbIvT/WeK/zjAKBggqhkjOPQQDAzBsMQsw
+CQYDVQQGEwJHUjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2Vh
+cmNoIEluc3RpdHV0aW9ucyBDQTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBFQ0MgUm9v
+dCBDQSAyMDIxMB4XDTIxMDIxOTExMDExMFoXDTQ1MDIxMzExMDEwOVowbDELMAkG
+A1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJj
+aCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgRUNDIFJvb3Qg
+Q0EgMjAyMTB2MBAGByqGSM49AgEGBSuBBAAiA2IABDgI/rGgltJ6rK9JOtDA4MM7
+KKrxcm1lAEeIhPyaJmuqS7psBAqIXhfyVYf8MLA04jRYVxqEU+kw2anylnTDUR9Y
+STHMmE5gEYd103KUkE+bECUqqHgtvpBBWJAVcqeht6NCMEAwDwYDVR0TAQH/BAUw
+AwEB/zAdBgNVHQ4EFgQUyRtTgRL+BNUW0aq8mm+3oJUZbsowDgYDVR0PAQH/BAQD
+AgGGMAoGCCqGSM49BAMDA2cAMGQCMBHervjcToiwqfAircJRQO9gcS3ujwLEXQNw
+SaSS6sUUiHCm0w2wqsosQJz76YJumgIwK0eaB8bRwoF8yguWGEEbo/QwCZ61IygN
+nxS2PFOiTAZpffpskcYqSUXm7LcT4Tps
+-----END CERTIFICATE-----
+
+# Issuer: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068
+# Subject: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068
+# Label: "Autoridad de Certificacion Firmaprofesional CIF A62634068"
+# Serial: 1977337328857672817
+# MD5 Fingerprint: 4e:6e:9b:54:4c:ca:b7:fa:48:e4:90:b1:15:4b:1c:a3
+# SHA1 Fingerprint: 0b:be:c2:27:22:49:cb:39:aa:db:35:5c:53:e3:8c:ae:78:ff:b6:fe
+# SHA256 Fingerprint: 57:de:05:83:ef:d2:b2:6e:03:61:da:99:da:9d:f4:64:8d:ef:7e:e8:44:1c:3b:72:8a:fa:9b:cd:e0:f9:b2:6a
+-----BEGIN CERTIFICATE-----
+MIIGFDCCA/ygAwIBAgIIG3Dp0v+ubHEwDQYJKoZIhvcNAQELBQAwUTELMAkGA1UE
+BhMCRVMxQjBABgNVBAMMOUF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uIEZpcm1h
+cHJvZmVzaW9uYWwgQ0lGIEE2MjYzNDA2ODAeFw0xNDA5MjMxNTIyMDdaFw0zNjA1
+MDUxNTIyMDdaMFExCzAJBgNVBAYTAkVTMUIwQAYDVQQDDDlBdXRvcmlkYWQgZGUg
+Q2VydGlmaWNhY2lvbiBGaXJtYXByb2Zlc2lvbmFsIENJRiBBNjI2MzQwNjgwggIi
+MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKlmuO6vj78aI14H9M2uDDUtd9
+thDIAl6zQyrET2qyyhxdKJp4ERppWVevtSBC5IsP5t9bpgOSL/UR5GLXMnE42QQM
+cas9UX4PB99jBVzpv5RvwSmCwLTaUbDBPLutN0pcyvFLNg4kq7/DhHf9qFD0sefG
+L9ItWY16Ck6WaVICqjaY7Pz6FIMMNx/Jkjd/14Et5cS54D40/mf0PmbR0/RAz15i
+NA9wBj4gGFrO93IbJWyTdBSTo3OxDqqHECNZXyAFGUftaI6SEspd/NYrspI8IM/h
+X68gvqB2f3bl7BqGYTM+53u0P6APjqK5am+5hyZvQWyIplD9amML9ZMWGxmPsu2b
+m8mQ9QEM3xk9Dz44I8kvjwzRAv4bVdZO0I08r0+k8/6vKtMFnXkIoctXMbScyJCy
+Z/QYFpM6/EfY0XiWMR+6KwxfXZmtY4laJCB22N/9q06mIqqdXuYnin1oKaPnirja
+EbsXLZmdEyRG98Xi2J+Of8ePdG1asuhy9azuJBCtLxTa/y2aRnFHvkLfuwHb9H/T
+KI8xWVvTyQKmtFLKbpf7Q8UIJm+K9Lv9nyiqDdVF8xM6HdjAeI9BZzwelGSuewvF
+6NkBiDkal4ZkQdU7hwxu+g/GvUgUvzlN1J5Bto+WHWOWk9mVBngxaJ43BjuAiUVh
+OSPHG0SjFeUc+JIwuwIDAQABo4HvMIHsMB0GA1UdDgQWBBRlzeurNR4APn7VdMAc
+tHNHDhpkLzASBgNVHRMBAf8ECDAGAQH/AgEBMIGmBgNVHSAEgZ4wgZswgZgGBFUd
+IAAwgY8wLwYIKwYBBQUHAgEWI2h0dHA6Ly93d3cuZmlybWFwcm9mZXNpb25hbC5j
+b20vY3BzMFwGCCsGAQUFBwICMFAeTgBQAGEAcwBlAG8AIABkAGUAIABsAGEAIABC
+AG8AbgBhAG4AbwB2AGEAIAA0ADcAIABCAGEAcgBjAGUAbABvAG4AYQAgADAAOAAw
+ADEANzAOBgNVHQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQELBQADggIBAHSHKAIrdx9m
+iWTtj3QuRhy7qPj4Cx2Dtjqn6EWKB7fgPiDL4QjbEwj4KKE1soCzC1HA01aajTNF
+Sa9J8OA9B3pFE1r/yJfY0xgsfZb43aJlQ3CTkBW6kN/oGbDbLIpgD7dvlAceHabJ
+hfa9NPhAeGIQcDq+fUs5gakQ1JZBu/hfHAsdCPKxsIl68veg4MSPi3i1O1ilI45P
+Vf42O+AMt8oqMEEgtIDNrvx2ZnOorm7hfNoD6JQg5iKj0B+QXSBTFCZX2lSX3xZE
+EAEeiGaPcjiT3SC3NL7X8e5jjkd5KAb881lFJWAiMxujX6i6KtoaPc1A6ozuBRWV
+1aUsIC+nmCjuRfzxuIgALI9C2lHVnOUTaHFFQ4ueCyE8S1wF3BqfmI7avSKecs2t
+CsvMo2ebKHTEm9caPARYpoKdrcd7b/+Alun4jWq9GJAd/0kakFI3ky88Al2CdgtR
+5xbHV/g4+afNmyJU72OwFW1TZQNKXkqgsqeOSQBZONXH9IBk9W6VULgRfhVwOEqw
+f9DEMnDAGf/JOC0ULGb0QkTmVXYbgBVX/8Cnp6o5qtjTcNAuuuuUavpfNIbnYrX9
+ivAwhZTJryQCL2/W3Wf+47BVTwSYT6RBVuKT0Gro1vP7ZeDOdcQxWQzugsgMYDNK
+GbqEZycPvEJdvSRUDewdcAZfpLz6IHxV
+-----END CERTIFICATE-----
+
+# Issuer: CN=vTrus ECC Root CA O=iTrusChina Co.,Ltd.
+# Subject: CN=vTrus ECC Root CA O=iTrusChina Co.,Ltd.
+# Label: "vTrus ECC Root CA"
+# Serial: 630369271402956006249506845124680065938238527194
+# MD5 Fingerprint: de:4b:c1:f5:52:8c:9b:43:e1:3e:8f:55:54:17:8d:85
+# SHA1 Fingerprint: f6:9c:db:b0:fc:f6:02:13:b6:52:32:a6:a3:91:3f:16:70:da:c3:e1
+# SHA256 Fingerprint: 30:fb:ba:2c:32:23:8e:2a:98:54:7a:f9:79:31:e5:50:42:8b:9b:3f:1c:8e:eb:66:33:dc:fa:86:c5:b2:7d:d3
+-----BEGIN CERTIFICATE-----
+MIICDzCCAZWgAwIBAgIUbmq8WapTvpg5Z6LSa6Q75m0c1towCgYIKoZIzj0EAwMw
+RzELMAkGA1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4xGjAY
+BgNVBAMTEXZUcnVzIEVDQyBSb290IENBMB4XDTE4MDczMTA3MjY0NFoXDTQzMDcz
+MTA3MjY0NFowRzELMAkGA1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28u
+LEx0ZC4xGjAYBgNVBAMTEXZUcnVzIEVDQyBSb290IENBMHYwEAYHKoZIzj0CAQYF
+K4EEACIDYgAEZVBKrox5lkqqHAjDo6LN/llWQXf9JpRCux3NCNtzslt188+cToL0
+v/hhJoVs1oVbcnDS/dtitN9Ti72xRFhiQgnH+n9bEOf+QP3A2MMrMudwpremIFUd
+e4BdS49nTPEQo0IwQDAdBgNVHQ4EFgQUmDnNvtiyjPeyq+GtJK97fKHbH88wDwYD
+VR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwCgYIKoZIzj0EAwMDaAAwZQIw
+V53dVvHH4+m4SVBrm2nDb+zDfSXkV5UTQJtS0zvzQBm8JsctBp61ezaf9SXUY2sA
+AjEA6dPGnlaaKsyh2j/IZivTWJwghfqrkYpwcBE4YGQLYgmRWAD5Tfs0aNoJrSEG
+GJTO
+-----END CERTIFICATE-----
+
+# Issuer: CN=vTrus Root CA O=iTrusChina Co.,Ltd.
+# Subject: CN=vTrus Root CA O=iTrusChina Co.,Ltd.
+# Label: "vTrus Root CA"
+# Serial: 387574501246983434957692974888460947164905180485
+# MD5 Fingerprint: b8:c9:37:df:fa:6b:31:84:64:c5:ea:11:6a:1b:75:fc
+# SHA1 Fingerprint: 84:1a:69:fb:f5:cd:1a:25:34:13:3d:e3:f8:fc:b8:99:d0:c9:14:b7
+# SHA256 Fingerprint: 8a:71:de:65:59:33:6f:42:6c:26:e5:38:80:d0:0d:88:a1:8d:a4:c6:a9:1f:0d:cb:61:94:e2:06:c5:c9:63:87
+-----BEGIN CERTIFICATE-----
+MIIFVjCCAz6gAwIBAgIUQ+NxE9izWRRdt86M/TX9b7wFjUUwDQYJKoZIhvcNAQEL
+BQAwQzELMAkGA1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4x
+FjAUBgNVBAMTDXZUcnVzIFJvb3QgQ0EwHhcNMTgwNzMxMDcyNDA1WhcNNDMwNzMx
+MDcyNDA1WjBDMQswCQYDVQQGEwJDTjEcMBoGA1UEChMTaVRydXNDaGluYSBDby4s
+THRkLjEWMBQGA1UEAxMNdlRydXMgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEBBQAD
+ggIPADCCAgoCggIBAL1VfGHTuB0EYgWgrmy3cLRB6ksDXhA/kFocizuwZotsSKYc
+IrrVQJLuM7IjWcmOvFjai57QGfIvWcaMY1q6n6MLsLOaXLoRuBLpDLvPbmyAhykU
+AyyNJJrIZIO1aqwTLDPxn9wsYTwaP3BVm60AUn/PBLn+NvqcwBauYv6WTEN+VRS+
+GrPSbcKvdmaVayqwlHeFXgQPYh1jdfdr58tbmnDsPmcF8P4HCIDPKNsFxhQnL4Z9
+8Cfe/+Z+M0jnCx5Y0ScrUw5XSmXX+6KAYPxMvDVTAWqXcoKv8R1w6Jz1717CbMdH
+flqUhSZNO7rrTOiwCcJlwp2dCZtOtZcFrPUGoPc2BX70kLJrxLT5ZOrpGgrIDajt
+J8nU57O5q4IikCc9Kuh8kO+8T/3iCiSn3mUkpF3qwHYw03dQ+A0Em5Q2AXPKBlim
+0zvc+gRGE1WKyURHuFE5Gi7oNOJ5y1lKCn+8pu8fA2dqWSslYpPZUxlmPCdiKYZN
+pGvu/9ROutW04o5IWgAZCfEF2c6Rsffr6TlP9m8EQ5pV9T4FFL2/s1m02I4zhKOQ
+UqqzApVg+QxMaPnu1RcN+HFXtSXkKe5lXa/R7jwXC1pDxaWG6iSe4gUH3DRCEpHW
+OXSuTEGC2/KmSNGzm/MzqvOmwMVO9fSddmPmAsYiS8GVP1BkLFTltvA8Kc9XAgMB
+AAGjQjBAMB0GA1UdDgQWBBRUYnBj8XWEQ1iO0RYgscasGrz2iTAPBgNVHRMBAf8E
+BTADAQH/MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAKbqSSaet
+8PFww+SX8J+pJdVrnjT+5hpk9jprUrIQeBqfTNqK2uwcN1LgQkv7bHbKJAs5EhWd
+nxEt/Hlk3ODg9d3gV8mlsnZwUKT+twpw1aA08XXXTUm6EdGz2OyC/+sOxL9kLX1j
+bhd47F18iMjrjld22VkE+rxSH0Ws8HqA7Oxvdq6R2xCOBNyS36D25q5J08FsEhvM
+Kar5CKXiNxTKsbhm7xqC5PD48acWabfbqWE8n/Uxy+QARsIvdLGx14HuqCaVvIiv
+TDUHKgLKeBRtRytAVunLKmChZwOgzoy8sHJnxDHO2zTlJQNgJXtxmOTAGytfdELS
+S8VZCAeHvsXDf+eW2eHcKJfWjwXj9ZtOyh1QRwVTsMo554WgicEFOwE30z9J4nfr
+I8iIZjs9OXYhRvHsXyO466JmdXTBQPfYaJqT4i2pLr0cox7IdMakLXogqzu4sEb9
+b91fUlV1YvCXoHzXOP0l382gmxDPi7g4Xl7FtKYCNqEeXxzP4padKar9mK5S4fNB
+UvupLnKWnyfjqnN9+BojZns7q2WwMgFLFT49ok8MKzWixtlnEjUwzXYuFrOZnk1P
+Ti07NEPhmg4NpGaXutIcSkwsKouLgU9xGqndXHt7CMUADTdA43x7VF8vhV929ven
+sBxXVsFy6K2ir40zSbofitzmdHxghm+Hl3s=
+-----END CERTIFICATE-----
+
+# Issuer: CN=ISRG Root X2 O=Internet Security Research Group
+# Subject: CN=ISRG Root X2 O=Internet Security Research Group
+# Label: "ISRG Root X2"
+# Serial: 87493402998870891108772069816698636114
+# MD5 Fingerprint: d3:9e:c4:1e:23:3c:a6:df:cf:a3:7e:6d:e0:14:e6:e5
+# SHA1 Fingerprint: bd:b1:b9:3c:d5:97:8d:45:c6:26:14:55:f8:db:95:c7:5a:d1:53:af
+# SHA256 Fingerprint: 69:72:9b:8e:15:a8:6e:fc:17:7a:57:af:b7:17:1d:fc:64:ad:d2:8c:2f:ca:8c:f1:50:7e:34:45:3c:cb:14:70
+-----BEGIN CERTIFICATE-----
+MIICGzCCAaGgAwIBAgIQQdKd0XLq7qeAwSxs6S+HUjAKBggqhkjOPQQDAzBPMQsw
+CQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJuZXQgU2VjdXJpdHkgUmVzZWFyY2gg
+R3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBYMjAeFw0yMDA5MDQwMDAwMDBaFw00
+MDA5MTcxNjAwMDBaME8xCzAJBgNVBAYTAlVTMSkwJwYDVQQKEyBJbnRlcm5ldCBT
+ZWN1cml0eSBSZXNlYXJjaCBHcm91cDEVMBMGA1UEAxMMSVNSRyBSb290IFgyMHYw
+EAYHKoZIzj0CAQYFK4EEACIDYgAEzZvVn4CDCuwJSvMWSj5cz3es3mcFDR0HttwW
++1qLFNvicWDEukWVEYmO6gbf9yoWHKS5xcUy4APgHoIYOIvXRdgKam7mAHf7AlF9
+ItgKbppbd9/w+kHsOdx1ymgHDB/qo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0T
+AQH/BAUwAwEB/zAdBgNVHQ4EFgQUfEKWrt5LSDv6kviejM9ti6lyN5UwCgYIKoZI
+zj0EAwMDaAAwZQIwe3lORlCEwkSHRhtFcP9Ymd70/aTSVaYgLXTWNLxBo1BfASdW
+tL4ndQavEi51mI38AjEAi/V3bNTIZargCyzuFJ0nN6T5U6VR5CmD1/iQMVtCnwr1
+/q4AaOeMSQ+2b1tbFfLn
+-----END CERTIFICATE-----
+
+# Issuer: CN=HiPKI Root CA - G1 O=Chunghwa Telecom Co., Ltd.
+# Subject: CN=HiPKI Root CA - G1 O=Chunghwa Telecom Co., Ltd.
+# Label: "HiPKI Root CA - G1"
+# Serial: 60966262342023497858655262305426234976
+# MD5 Fingerprint: 69:45:df:16:65:4b:e8:68:9a:8f:76:5f:ff:80:9e:d3
+# SHA1 Fingerprint: 6a:92:e4:a8:ee:1b:ec:96:45:37:e3:29:57:49:cd:96:e3:e5:d2:60
+# SHA256 Fingerprint: f0:15:ce:3c:c2:39:bf:ef:06:4b:e9:f1:d2:c4:17:e1:a0:26:4a:0a:94:be:1f:0c:8d:12:18:64:eb:69:49:cc
+-----BEGIN CERTIFICATE-----
+MIIFajCCA1KgAwIBAgIQLd2szmKXlKFD6LDNdmpeYDANBgkqhkiG9w0BAQsFADBP
+MQswCQYDVQQGEwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0
+ZC4xGzAZBgNVBAMMEkhpUEtJIFJvb3QgQ0EgLSBHMTAeFw0xOTAyMjIwOTQ2MDRa
+Fw0zNzEyMzExNTU5NTlaME8xCzAJBgNVBAYTAlRXMSMwIQYDVQQKDBpDaHVuZ2h3
+YSBUZWxlY29tIENvLiwgTHRkLjEbMBkGA1UEAwwSSGlQS0kgUm9vdCBDQSAtIEcx
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA9B5/UnMyDHPkvRN0o9Qw
+qNCuS9i233VHZvR85zkEHmpwINJaR3JnVfSl6J3VHiGh8Ge6zCFovkRTv4354twv
+Vcg3Px+kwJyz5HdcoEb+d/oaoDjq7Zpy3iu9lFc6uux55199QmQ5eiY29yTw1S+6
+lZgRZq2XNdZ1AYDgr/SEYYwNHl98h5ZeQa/rh+r4XfEuiAU+TCK72h8q3VJGZDnz
+Qs7ZngyzsHeXZJzA9KMuH5UHsBffMNsAGJZMoYFL3QRtU6M9/Aes1MU3guvklQgZ
+KILSQjqj2FPseYlgSGDIcpJQ3AOPgz+yQlda22rpEZfdhSi8MEyr48KxRURHH+CK
+FgeW0iEPU8DtqX7UTuybCeyvQqww1r/REEXgphaypcXTT3OUM3ECoWqj1jOXTyFj
+HluP2cFeRXF3D4FdXyGarYPM+l7WjSNfGz1BryB1ZlpK9p/7qxj3ccC2HTHsOyDr
+y+K49a6SsvfhhEvyovKTmiKe0xRvNlS9H15ZFblzqMF8b3ti6RZsR1pl8w4Rm0bZ
+/W3c1pzAtH2lsN0/Vm+h+fbkEkj9Bn8SV7apI09bA8PgcSojt/ewsTu8mL3WmKgM
+a/aOEmem8rJY5AIJEzypuxC00jBF8ez3ABHfZfjcK0NVvxaXxA/VLGGEqnKG/uY6
+fsI/fe78LxQ+5oXdUG+3Se0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
+HQ4EFgQU8ncX+l6o/vY9cdVouslGDDjYr7AwDgYDVR0PAQH/BAQDAgGGMA0GCSqG
+SIb3DQEBCwUAA4ICAQBQUfB13HAE4/+qddRxosuej6ip0691x1TPOhwEmSKsxBHi
+7zNKpiMdDg1H2DfHb680f0+BazVP6XKlMeJ45/dOlBhbQH3PayFUhuaVevvGyuqc
+SE5XCV0vrPSltJczWNWseanMX/mF+lLFjfiRFOs6DRfQUsJ748JzjkZ4Bjgs6Fza
+ZsT0pPBWGTMpWmWSBUdGSquEwx4noR8RkpkndZMPvDY7l1ePJlsMu5wP1G4wB9Tc
+XzZoZjmDlicmisjEOf6aIW/Vcobpf2Lll07QJNBAsNB1CI69aO4I1258EHBGG3zg
+iLKecoaZAeO/n0kZtCW+VmWuF2PlHt/o/0elv+EmBYTksMCv5wiZqAxeJoBF1Pho
+L5aPruJKHJwWDBNvOIf2u8g0X5IDUXlwpt/L9ZlNec1OvFefQ05rLisY+GpzjLrF
+Ne85akEez3GoorKGB1s6yeHvP2UEgEcyRHCVTjFnanRbEEV16rCf0OY1/k6fi8wr
+kkVbbiVghUbN0aqwdmaTd5a+g744tiROJgvM7XpWGuDpWsZkrUx6AEhEL7lAuxM+
+vhV4nYWBSipX3tUZQ9rbyltHhoMLP7YNdnhzeSJesYAfz77RP1YQmCuVh6EfnWQU
+YDksswBVLuT1sw5XxJFBAJw/6KXf6vb/yPCtbVKoF6ubYfwSUTXkJf2vqmqGOQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4
+# Label: "GlobalSign ECC Root CA - R4"
+# Serial: 159662223612894884239637590694
+# MD5 Fingerprint: 26:29:f8:6d:e1:88:bf:a2:65:7f:aa:c4:cd:0f:7f:fc
+# SHA1 Fingerprint: 6b:a0:b0:98:e1:71:ef:5a:ad:fe:48:15:80:77:10:f4:bd:6f:0b:28
+# SHA256 Fingerprint: b0:85:d7:0b:96:4f:19:1a:73:e4:af:0d:54:ae:7a:0e:07:aa:fd:af:9b:71:dd:08:62:13:8a:b7:32:5a:24:a2
+-----BEGIN CERTIFICATE-----
+MIIB3DCCAYOgAwIBAgINAgPlfvU/k/2lCSGypjAKBggqhkjOPQQDAjBQMSQwIgYD
+VQQLExtHbG9iYWxTaWduIEVDQyBSb290IENBIC0gUjQxEzARBgNVBAoTCkdsb2Jh
+bFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMTIxMTEzMDAwMDAwWhcNMzgw
+MTE5MDMxNDA3WjBQMSQwIgYDVQQLExtHbG9iYWxTaWduIEVDQyBSb290IENBIC0g
+UjQxEzARBgNVBAoTCkdsb2JhbFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wWTAT
+BgcqhkjOPQIBBggqhkjOPQMBBwNCAAS4xnnTj2wlDp8uORkcA6SumuU5BwkWymOx
+uYb4ilfBV85C+nOh92VC/x7BALJucw7/xyHlGKSq2XE/qNS5zowdo0IwQDAOBgNV
+HQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUVLB7rUW44kB/
++wpu+74zyTyjhNUwCgYIKoZIzj0EAwIDRwAwRAIgIk90crlgr/HmnKAWBVBfw147
+bmF0774BxL4YSFlhgjICICadVGNA3jdgUM/I2O2dgq43mLyjj0xMqTQrbO/7lZsm
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R1 O=Google Trust Services LLC
+# Subject: CN=GTS Root R1 O=Google Trust Services LLC
+# Label: "GTS Root R1"
+# Serial: 159662320309726417404178440727
+# MD5 Fingerprint: 05:fe:d0:bf:71:a8:a3:76:63:da:01:e0:d8:52:dc:40
+# SHA1 Fingerprint: e5:8c:1c:c4:91:3b:38:63:4b:e9:10:6e:e3:ad:8e:6b:9d:d9:81:4a
+# SHA256 Fingerprint: d9:47:43:2a:bd:e7:b7:fa:90:fc:2e:6b:59:10:1b:12:80:e0:e1:c7:e4:e4:0f:a3:c6:88:7f:ff:57:a7:f4:cf
+-----BEGIN CERTIFICATE-----
+MIIFVzCCAz+gAwIBAgINAgPlk28xsBNJiGuiFzANBgkqhkiG9w0BAQwFADBHMQsw
+CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU
+MBIGA1UEAxMLR1RTIFJvb3QgUjEwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw
+MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp
+Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjEwggIiMA0GCSqGSIb3DQEBAQUA
+A4ICDwAwggIKAoICAQC2EQKLHuOhd5s73L+UPreVp0A8of2C+X0yBoJx9vaMf/vo
+27xqLpeXo4xL+Sv2sfnOhB2x+cWX3u+58qPpvBKJXqeqUqv4IyfLpLGcY9vXmX7w
+Cl7raKb0xlpHDU0QM+NOsROjyBhsS+z8CZDfnWQpJSMHobTSPS5g4M/SCYe7zUjw
+TcLCeoiKu7rPWRnWr4+wB7CeMfGCwcDfLqZtbBkOtdh+JhpFAz2weaSUKK0Pfybl
+qAj+lug8aJRT7oM6iCsVlgmy4HqMLnXWnOunVmSPlk9orj2XwoSPwLxAwAtcvfaH
+szVsrBhQf4TgTM2S0yDpM7xSma8ytSmzJSq0SPly4cpk9+aCEI3oncKKiPo4Zor8
+Y/kB+Xj9e1x3+naH+uzfsQ55lVe0vSbv1gHR6xYKu44LtcXFilWr06zqkUspzBmk
+MiVOKvFlRNACzqrOSbTqn3yDsEB750Orp2yjj32JgfpMpf/VjsPOS+C12LOORc92
+wO1AK/1TD7Cn1TsNsYqiA94xrcx36m97PtbfkSIS5r762DL8EGMUUXLeXdYWk70p
+aDPvOmbsB4om3xPXV2V4J95eSRQAogB/mqghtqmxlbCluQ0WEdrHbEg8QOB+DVrN
+VjzRlwW5y0vtOUucxD/SVRNuJLDWcfr0wbrM7Rv1/oFB2ACYPTrIrnqYNxgFlQID
+AQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4E
+FgQU5K8rJnEaK0gnhS9SZizv8IkTcT4wDQYJKoZIhvcNAQEMBQADggIBAJ+qQibb
+C5u+/x6Wki4+omVKapi6Ist9wTrYggoGxval3sBOh2Z5ofmmWJyq+bXmYOfg6LEe
+QkEzCzc9zolwFcq1JKjPa7XSQCGYzyI0zzvFIoTgxQ6KfF2I5DUkzps+GlQebtuy
+h6f88/qBVRRiClmpIgUxPoLW7ttXNLwzldMXG+gnoot7TiYaelpkttGsN/H9oPM4
+7HLwEXWdyzRSjeZ2axfG34arJ45JK3VmgRAhpuo+9K4l/3wV3s6MJT/KYnAK9y8J
+ZgfIPxz88NtFMN9iiMG1D53Dn0reWVlHxYciNuaCp+0KueIHoI17eko8cdLiA6Ef
+MgfdG+RCzgwARWGAtQsgWSl4vflVy2PFPEz0tv/bal8xa5meLMFrUKTX5hgUvYU/
+Z6tGn6D/Qqc6f1zLXbBwHSs09dR2CQzreExZBfMzQsNhFRAbd03OIozUhfJFfbdT
+6u9AWpQKXCBfTkBdYiJ23//OYb2MI3jSNwLgjt7RETeJ9r/tSQdirpLsQBqvFAnZ
+0E6yove+7u7Y/9waLd64NnHi/Hm3lCXRSHNboTXns5lndcEZOitHTtNCjv0xyBZm
+2tIMPNuzjsmhDYAPexZ3FL//2wmUspO8IFgV6dtxQ/PeEMMA3KgqlbbC1j+Qa3bb
+bP6MvPJwNQzcmRk13NfIRmPVNnGuV/u3gm3c
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R2 O=Google Trust Services LLC
+# Subject: CN=GTS Root R2 O=Google Trust Services LLC
+# Label: "GTS Root R2"
+# Serial: 159662449406622349769042896298
+# MD5 Fingerprint: 1e:39:c0:53:e6:1e:29:82:0b:ca:52:55:36:5d:57:dc
+# SHA1 Fingerprint: 9a:44:49:76:32:db:de:fa:d0:bc:fb:5a:7b:17:bd:9e:56:09:24:94
+# SHA256 Fingerprint: 8d:25:cd:97:22:9d:bf:70:35:6b:da:4e:b3:cc:73:40:31:e2:4c:f0:0f:af:cf:d3:2d:c7:6e:b5:84:1c:7e:a8
+-----BEGIN CERTIFICATE-----
+MIIFVzCCAz+gAwIBAgINAgPlrsWNBCUaqxElqjANBgkqhkiG9w0BAQwFADBHMQsw
+CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU
+MBIGA1UEAxMLR1RTIFJvb3QgUjIwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw
+MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp
+Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjIwggIiMA0GCSqGSIb3DQEBAQUA
+A4ICDwAwggIKAoICAQDO3v2m++zsFDQ8BwZabFn3GTXd98GdVarTzTukk3LvCvpt
+nfbwhYBboUhSnznFt+4orO/LdmgUud+tAWyZH8QiHZ/+cnfgLFuv5AS/T3KgGjSY
+6Dlo7JUle3ah5mm5hRm9iYz+re026nO8/4Piy33B0s5Ks40FnotJk9/BW9BuXvAu
+MC6C/Pq8tBcKSOWIm8Wba96wyrQD8Nr0kLhlZPdcTK3ofmZemde4wj7I0BOdre7k
+RXuJVfeKH2JShBKzwkCX44ofR5GmdFrS+LFjKBC4swm4VndAoiaYecb+3yXuPuWg
+f9RhD1FLPD+M2uFwdNjCaKH5wQzpoeJ/u1U8dgbuak7MkogwTZq9TwtImoS1mKPV
++3PBV2HdKFZ1E66HjucMUQkQdYhMvI35ezzUIkgfKtzra7tEscszcTJGr61K8Yzo
+dDqs5xoic4DSMPclQsciOzsSrZYuxsN2B6ogtzVJV+mSSeh2FnIxZyuWfoqjx5RW
+Ir9qS34BIbIjMt/kmkRtWVtd9QCgHJvGeJeNkP+byKq0rxFROV7Z+2et1VsRnTKa
+G73VululycslaVNVJ1zgyjbLiGH7HrfQy+4W+9OmTN6SpdTi3/UGVN4unUu0kzCq
+gc7dGtxRcw1PcOnlthYhGXmy5okLdWTK1au8CcEYof/UVKGFPP0UJAOyh9OktwID
+AQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4E
+FgQUu//KjiOfT5nK2+JopqUVJxce2Q4wDQYJKoZIhvcNAQEMBQADggIBAB/Kzt3H
+vqGf2SdMC9wXmBFqiN495nFWcrKeGk6c1SuYJF2ba3uwM4IJvd8lRuqYnrYb/oM8
+0mJhwQTtzuDFycgTE1XnqGOtjHsB/ncw4c5omwX4Eu55MaBBRTUoCnGkJE+M3DyC
+B19m3H0Q/gxhswWV7uGugQ+o+MePTagjAiZrHYNSVc61LwDKgEDg4XSsYPWHgJ2u
+NmSRXbBoGOqKYcl3qJfEycel/FVL8/B/uWU9J2jQzGv6U53hkRrJXRqWbTKH7QMg
+yALOWr7Z6v2yTcQvG99fevX4i8buMTolUVVnjWQye+mew4K6Ki3pHrTgSAai/Gev
+HyICc/sgCq+dVEuhzf9gR7A/Xe8bVr2XIZYtCtFenTgCR2y59PYjJbigapordwj6
+xLEokCZYCDzifqrXPW+6MYgKBesntaFJ7qBFVHvmJ2WZICGoo7z7GJa7Um8M7YNR
+TOlZ4iBgxcJlkoKM8xAfDoqXvneCbT+PHV28SSe9zE8P4c52hgQjxcCMElv924Sg
+JPFI/2R80L5cFtHvma3AH/vLrrw4IgYmZNralw4/KBVEqE8AyvCazM90arQ+POuV
+7LXTWtiBmelDGDfrs7vRWGJB82bSj6p4lVQgw1oudCvV0b4YacCs1aTPObpRhANl
+6WLAYv7YTVWW4tAR+kg0Eeye7QUd5MjWHYbL
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R3 O=Google Trust Services LLC
+# Subject: CN=GTS Root R3 O=Google Trust Services LLC
+# Label: "GTS Root R3"
+# Serial: 159662495401136852707857743206
+# MD5 Fingerprint: 3e:e7:9d:58:02:94:46:51:94:e5:e0:22:4a:8b:e7:73
+# SHA1 Fingerprint: ed:e5:71:80:2b:c8:92:b9:5b:83:3c:d2:32:68:3f:09:cd:a0:1e:46
+# SHA256 Fingerprint: 34:d8:a7:3e:e2:08:d9:bc:db:0d:95:65:20:93:4b:4e:40:e6:94:82:59:6e:8b:6f:73:c8:42:6b:01:0a:6f:48
+-----BEGIN CERTIFICATE-----
+MIICCTCCAY6gAwIBAgINAgPluILrIPglJ209ZjAKBggqhkjOPQQDAzBHMQswCQYD
+VQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIG
+A1UEAxMLR1RTIFJvb3QgUjMwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAw
+WjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2Vz
+IExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjMwdjAQBgcqhkjOPQIBBgUrgQQAIgNi
+AAQfTzOHMymKoYTey8chWEGJ6ladK0uFxh1MJ7x/JlFyb+Kf1qPKzEUURout736G
+jOyxfi//qXGdGIRFBEFVbivqJn+7kAHjSxm65FSWRQmx1WyRRK2EE46ajA2ADDL2
+4CejQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW
+BBTB8Sa6oC2uhYHP0/EqEr24Cmf9vDAKBggqhkjOPQQDAwNpADBmAjEA9uEglRR7
+VKOQFhG/hMjqb2sXnh5GmCCbn9MN2azTL818+FsuVbu/3ZL3pAzcMeGiAjEA/Jdm
+ZuVDFhOD3cffL74UOO0BzrEXGhF16b0DjyZ+hOXJYKaV11RZt+cRLInUue4X
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R4 O=Google Trust Services LLC
+# Subject: CN=GTS Root R4 O=Google Trust Services LLC
+# Label: "GTS Root R4"
+# Serial: 159662532700760215368942768210
+# MD5 Fingerprint: 43:96:83:77:19:4d:76:b3:9d:65:52:e4:1d:22:a5:e8
+# SHA1 Fingerprint: 77:d3:03:67:b5:e0:0c:15:f6:0c:38:61:df:7c:e1:3b:92:46:4d:47
+# SHA256 Fingerprint: 34:9d:fa:40:58:c5:e2:63:12:3b:39:8a:e7:95:57:3c:4e:13:13:c8:3f:e6:8f:93:55:6c:d5:e8:03:1b:3c:7d
+-----BEGIN CERTIFICATE-----
+MIICCTCCAY6gAwIBAgINAgPlwGjvYxqccpBQUjAKBggqhkjOPQQDAzBHMQswCQYD
+VQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIG
+A1UEAxMLR1RTIFJvb3QgUjQwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAw
+WjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2Vz
+IExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjQwdjAQBgcqhkjOPQIBBgUrgQQAIgNi
+AATzdHOnaItgrkO4NcWBMHtLSZ37wWHO5t5GvWvVYRg1rkDdc/eJkTBa6zzuhXyi
+QHY7qca4R9gq55KRanPpsXI5nymfopjTX15YhmUPoYRlBtHci8nHc8iMai/lxKvR
+HYqjQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW
+BBSATNbrdP9JNqPV2Py1PsVq8JQdjDAKBggqhkjOPQQDAwNpADBmAjEA6ED/g94D
+9J+uHXqnLrmvT/aDHQ4thQEd0dlq7A/Cr8deVl5c1RxYIigL9zC2L7F8AjEA8GE8
+p/SgguMh1YQdc4acLa/KNJvxn7kjNuK8YAOdgLOaVsjh4rsUecrNIdSUtUlD
+-----END CERTIFICATE-----
+
+# Issuer: CN=Telia Root CA v2 O=Telia Finland Oyj
+# Subject: CN=Telia Root CA v2 O=Telia Finland Oyj
+# Label: "Telia Root CA v2"
+# Serial: 7288924052977061235122729490515358
+# MD5 Fingerprint: 0e:8f:ac:aa:82:df:85:b1:f4:dc:10:1c:fc:99:d9:48
+# SHA1 Fingerprint: b9:99:cd:d1:73:50:8a:c4:47:05:08:9c:8c:88:fb:be:a0:2b:40:cd
+# SHA256 Fingerprint: 24:2b:69:74:2f:cb:1e:5b:2a:bf:98:89:8b:94:57:21:87:54:4e:5b:4d:99:11:78:65:73:62:1f:6a:74:b8:2c
+-----BEGIN CERTIFICATE-----
+MIIFdDCCA1ygAwIBAgIPAWdfJ9b+euPkrL4JWwWeMA0GCSqGSIb3DQEBCwUAMEQx
+CzAJBgNVBAYTAkZJMRowGAYDVQQKDBFUZWxpYSBGaW5sYW5kIE95ajEZMBcGA1UE
+AwwQVGVsaWEgUm9vdCBDQSB2MjAeFw0xODExMjkxMTU1NTRaFw00MzExMjkxMTU1
+NTRaMEQxCzAJBgNVBAYTAkZJMRowGAYDVQQKDBFUZWxpYSBGaW5sYW5kIE95ajEZ
+MBcGA1UEAwwQVGVsaWEgUm9vdCBDQSB2MjCCAiIwDQYJKoZIhvcNAQEBBQADggIP
+ADCCAgoCggIBALLQPwe84nvQa5n44ndp586dpAO8gm2h/oFlH0wnrI4AuhZ76zBq
+AMCzdGh+sq/H1WKzej9Qyow2RCRj0jbpDIX2Q3bVTKFgcmfiKDOlyzG4OiIjNLh9
+vVYiQJ3q9HsDrWj8soFPmNB06o3lfc1jw6P23pLCWBnglrvFxKk9pXSW/q/5iaq9
+lRdU2HhE8Qx3FZLgmEKnpNaqIJLNwaCzlrI6hEKNfdWV5Nbb6WLEWLN5xYzTNTOD
+n3WhUidhOPFZPY5Q4L15POdslv5e2QJltI5c0BE0312/UqeBAMN/mUWZFdUXyApT
+7GPzmX3MaRKGwhfwAZ6/hLzRUssbkmbOpFPlob/E2wnW5olWK8jjfN7j/4nlNW4o
+6GwLI1GpJQXrSPjdscr6bAhR77cYbETKJuFzxokGgeWKrLDiKca5JLNrRBH0pUPC
+TEPlcDaMtjNXepUugqD0XBCzYYP2AgWGLnwtbNwDRm41k9V6lS/eINhbfpSQBGq6
+WT0EBXWdN6IOLj3rwaRSg/7Qa9RmjtzG6RJOHSpXqhC8fF6CfaamyfItufUXJ63R
+DolUK5X6wK0dmBR4M0KGCqlztft0DbcbMBnEWg4cJ7faGND/isgFuvGqHKI3t+ZI
+pEYslOqodmJHixBTB0hXbOKSTbauBcvcwUpej6w9GU7C7WB1K9vBykLVAgMBAAGj
+YzBhMB8GA1UdIwQYMBaAFHKs5DN5qkWH9v2sHZ7Wxy+G2CQ5MB0GA1UdDgQWBBRy
+rOQzeapFh/b9rB2e1scvhtgkOTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUw
+AwEB/zANBgkqhkiG9w0BAQsFAAOCAgEAoDtZpwmUPjaE0n4vOaWWl/oRrfxn83EJ
+8rKJhGdEr7nv7ZbsnGTbMjBvZ5qsfl+yqwE2foH65IRe0qw24GtixX1LDoJt0nZi
+0f6X+J8wfBj5tFJ3gh1229MdqfDBmgC9bXXYfef6xzijnHDoRnkDry5023X4blMM
+A8iZGok1GTzTyVR8qPAs5m4HeW9q4ebqkYJpCh3DflminmtGFZhb069GHWLIzoBS
+SRE/yQQSwxN8PzuKlts8oB4KtItUsiRnDe+Cy748fdHif64W1lZYudogsYMVoe+K
+TTJvQS8TUoKU1xrBeKJR3Stwbbca+few4GeXVtt8YVMJAygCQMez2P2ccGrGKMOF
+6eLtGpOg3kuYooQ+BXcBlj37tCAPnHICehIv1aO6UXivKitEZU61/Qrowc15h2Er
+3oBXRb9n8ZuRXqWk7FlIEA04x7D6w0RtBPV4UBySllva9bguulvP5fBqnUsvWHMt
+Ty3EHD70sz+rFQ47GUGKpMFXEmZxTPpT41frYpUJnlTd0cI8Vzy9OK2YZLe4A5pT
+VmBds9hCG1xLEooc6+t9xnppxyd/pPiL8uSUZodL6ZQHCRJ5irLrdATczvREWeAW
+ysUsWNc8e89ihmpQfTU2Zqf7N+cox9jQraVplI/owd8k+BsHMYeB2F326CjYSlKA
+rBPuUBQemMc=
+-----END CERTIFICATE-----
+
+# Issuer: CN=D-TRUST BR Root CA 1 2020 O=D-Trust GmbH
+# Subject: CN=D-TRUST BR Root CA 1 2020 O=D-Trust GmbH
+# Label: "D-TRUST BR Root CA 1 2020"
+# Serial: 165870826978392376648679885835942448534
+# MD5 Fingerprint: b5:aa:4b:d5:ed:f7:e3:55:2e:8f:72:0a:f3:75:b8:ed
+# SHA1 Fingerprint: 1f:5b:98:f0:e3:b5:f7:74:3c:ed:e6:b0:36:7d:32:cd:f4:09:41:67
+# SHA256 Fingerprint: e5:9a:aa:81:60:09:c2:2b:ff:5b:25:ba:d3:7d:f3:06:f0:49:79:7c:1f:81:d8:5a:b0:89:e6:57:bd:8f:00:44
+-----BEGIN CERTIFICATE-----
+MIIC2zCCAmCgAwIBAgIQfMmPK4TX3+oPyWWa00tNljAKBggqhkjOPQQDAzBIMQsw
+CQYDVQQGEwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRS
+VVNUIEJSIFJvb3QgQ0EgMSAyMDIwMB4XDTIwMDIxMTA5NDUwMFoXDTM1MDIxMTA5
+NDQ1OVowSDELMAkGA1UEBhMCREUxFTATBgNVBAoTDEQtVHJ1c3QgR21iSDEiMCAG
+A1UEAxMZRC1UUlVTVCBCUiBSb290IENBIDEgMjAyMDB2MBAGByqGSM49AgEGBSuB
+BAAiA2IABMbLxyjR+4T1mu9CFCDhQ2tuda38KwOE1HaTJddZO0Flax7mNCq7dPYS
+zuht56vkPE4/RAiLzRZxy7+SmfSk1zxQVFKQhYN4lGdnoxwJGT11NIXe7WB9xwy0
+QVK5buXuQqOCAQ0wggEJMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFHOREKv/
+VbNafAkl1bK6CKBrqx9tMA4GA1UdDwEB/wQEAwIBBjCBxgYDVR0fBIG+MIG7MD6g
+PKA6hjhodHRwOi8vY3JsLmQtdHJ1c3QubmV0L2NybC9kLXRydXN0X2JyX3Jvb3Rf
+Y2FfMV8yMDIwLmNybDB5oHegdYZzbGRhcDovL2RpcmVjdG9yeS5kLXRydXN0Lm5l
+dC9DTj1ELVRSVVNUJTIwQlIlMjBSb290JTIwQ0ElMjAxJTIwMjAyMCxPPUQtVHJ1
+c3QlMjBHbWJILEM9REU/Y2VydGlmaWNhdGVyZXZvY2F0aW9ubGlzdDAKBggqhkjO
+PQQDAwNpADBmAjEAlJAtE/rhY/hhY+ithXhUkZy4kzg+GkHaQBZTQgjKL47xPoFW
+wKrY7RjEsK70PvomAjEA8yjixtsrmfu3Ubgko6SUeho/5jbiA1czijDLgsfWFBHV
+dWNbFJWcHwHP2NVypw87
+-----END CERTIFICATE-----
+
+# Issuer: CN=D-TRUST EV Root CA 1 2020 O=D-Trust GmbH
+# Subject: CN=D-TRUST EV Root CA 1 2020 O=D-Trust GmbH
+# Label: "D-TRUST EV Root CA 1 2020"
+# Serial: 126288379621884218666039612629459926992
+# MD5 Fingerprint: 8c:2d:9d:70:9f:48:99:11:06:11:fb:e9:cb:30:c0:6e
+# SHA1 Fingerprint: 61:db:8c:21:59:69:03:90:d8:7c:9c:12:86:54:cf:9d:3d:f4:dd:07
+# SHA256 Fingerprint: 08:17:0d:1a:a3:64:53:90:1a:2f:95:92:45:e3:47:db:0c:8d:37:ab:aa:bc:56:b8:1a:a1:00:dc:95:89:70:db
+-----BEGIN CERTIFICATE-----
+MIIC2zCCAmCgAwIBAgIQXwJB13qHfEwDo6yWjfv/0DAKBggqhkjOPQQDAzBIMQsw
+CQYDVQQGEwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRS
+VVNUIEVWIFJvb3QgQ0EgMSAyMDIwMB4XDTIwMDIxMTEwMDAwMFoXDTM1MDIxMTA5
+NTk1OVowSDELMAkGA1UEBhMCREUxFTATBgNVBAoTDEQtVHJ1c3QgR21iSDEiMCAG
+A1UEAxMZRC1UUlVTVCBFViBSb290IENBIDEgMjAyMDB2MBAGByqGSM49AgEGBSuB
+BAAiA2IABPEL3YZDIBnfl4XoIkqbz52Yv7QFJsnL46bSj8WeeHsxiamJrSc8ZRCC
+/N/DnU7wMyPE0jL1HLDfMxddxfCxivnvubcUyilKwg+pf3VlSSowZ/Rk99Yad9rD
+wpdhQntJraOCAQ0wggEJMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFH8QARY3
+OqQo5FD4pPfsazK2/umLMA4GA1UdDwEB/wQEAwIBBjCBxgYDVR0fBIG+MIG7MD6g
+PKA6hjhodHRwOi8vY3JsLmQtdHJ1c3QubmV0L2NybC9kLXRydXN0X2V2X3Jvb3Rf
+Y2FfMV8yMDIwLmNybDB5oHegdYZzbGRhcDovL2RpcmVjdG9yeS5kLXRydXN0Lm5l
+dC9DTj1ELVRSVVNUJTIwRVYlMjBSb290JTIwQ0ElMjAxJTIwMjAyMCxPPUQtVHJ1
+c3QlMjBHbWJILEM9REU/Y2VydGlmaWNhdGVyZXZvY2F0aW9ubGlzdDAKBggqhkjO
+PQQDAwNpADBmAjEAyjzGKnXCXnViOTYAYFqLwZOZzNnbQTs7h5kXO9XMT8oi96CA
+y/m0sRtW9XLS/BnRAjEAkfcwkz8QRitxpNA7RJvAKQIFskF3UfN5Wp6OFKBOQtJb
+gfM0agPnIjhQW+0ZT0MW
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert TLS ECC P384 Root G5 O=DigiCert, Inc.
+# Subject: CN=DigiCert TLS ECC P384 Root G5 O=DigiCert, Inc.
+# Label: "DigiCert TLS ECC P384 Root G5"
+# Serial: 13129116028163249804115411775095713523
+# MD5 Fingerprint: d3:71:04:6a:43:1c:db:a6:59:e1:a8:a3:aa:c5:71:ed
+# SHA1 Fingerprint: 17:f3:de:5e:9f:0f:19:e9:8e:f6:1f:32:26:6e:20:c4:07:ae:30:ee
+# SHA256 Fingerprint: 01:8e:13:f0:77:25:32:cf:80:9b:d1:b1:72:81:86:72:83:fc:48:c6:e1:3b:e9:c6:98:12:85:4a:49:0c:1b:05
+-----BEGIN CERTIFICATE-----
+MIICGTCCAZ+gAwIBAgIQCeCTZaz32ci5PhwLBCou8zAKBggqhkjOPQQDAzBOMQsw
+CQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJjAkBgNVBAMTHURp
+Z2lDZXJ0IFRMUyBFQ0MgUDM4NCBSb290IEc1MB4XDTIxMDExNTAwMDAwMFoXDTQ2
+MDExNDIzNTk1OVowTjELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJ
+bmMuMSYwJAYDVQQDEx1EaWdpQ2VydCBUTFMgRUNDIFAzODQgUm9vdCBHNTB2MBAG
+ByqGSM49AgEGBSuBBAAiA2IABMFEoc8Rl1Ca3iOCNQfN0MsYndLxf3c1TzvdlHJS
+7cI7+Oz6e2tYIOyZrsn8aLN1udsJ7MgT9U7GCh1mMEy7H0cKPGEQQil8pQgO4CLp
+0zVozptjn4S1mU1YoI71VOeVyaNCMEAwHQYDVR0OBBYEFMFRRVBZqz7nLFr6ICIS
+B4CIfBFqMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MAoGCCqGSM49
+BAMDA2gAMGUCMQCJao1H5+z8blUD2WdsJk6Dxv3J+ysTvLd6jLRl0mlpYxNjOyZQ
+LgGheQaRnUi/wr4CMEfDFXuxoJGZSZOoPHzoRgaLLPIxAJSdYsiJvRmEFOml+wG4
+DXZDjC5Ty3zfDBeWUA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert TLS RSA4096 Root G5 O=DigiCert, Inc.
+# Subject: CN=DigiCert TLS RSA4096 Root G5 O=DigiCert, Inc.
+# Label: "DigiCert TLS RSA4096 Root G5"
+# Serial: 11930366277458970227240571539258396554
+# MD5 Fingerprint: ac:fe:f7:34:96:a9:f2:b3:b4:12:4b:e4:27:41:6f:e1
+# SHA1 Fingerprint: a7:88:49:dc:5d:7c:75:8c:8c:de:39:98:56:b3:aa:d0:b2:a5:71:35
+# SHA256 Fingerprint: 37:1a:00:dc:05:33:b3:72:1a:7e:eb:40:e8:41:9e:70:79:9d:2b:0a:0f:2c:1d:80:69:31:65:f7:ce:c4:ad:75
+-----BEGIN CERTIFICATE-----
+MIIFZjCCA06gAwIBAgIQCPm0eKj6ftpqMzeJ3nzPijANBgkqhkiG9w0BAQwFADBN
+MQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJTAjBgNVBAMT
+HERpZ2lDZXJ0IFRMUyBSU0E0MDk2IFJvb3QgRzUwHhcNMjEwMTE1MDAwMDAwWhcN
+NDYwMTE0MjM1OTU5WjBNMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQs
+IEluYy4xJTAjBgNVBAMTHERpZ2lDZXJ0IFRMUyBSU0E0MDk2IFJvb3QgRzUwggIi
+MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCz0PTJeRGd/fxmgefM1eS87IE+
+ajWOLrfn3q/5B03PMJ3qCQuZvWxX2hhKuHisOjmopkisLnLlvevxGs3npAOpPxG0
+2C+JFvuUAT27L/gTBaF4HI4o4EXgg/RZG5Wzrn4DReW+wkL+7vI8toUTmDKdFqgp
+wgscONyfMXdcvyej/Cestyu9dJsXLfKB2l2w4SMXPohKEiPQ6s+d3gMXsUJKoBZM
+pG2T6T867jp8nVid9E6P/DsjyG244gXazOvswzH016cpVIDPRFtMbzCe88zdH5RD
+nU1/cHAN1DrRN/BsnZvAFJNY781BOHW8EwOVfH/jXOnVDdXifBBiqmvwPXbzP6Po
+sMH976pXTayGpxi0KcEsDr9kvimM2AItzVwv8n/vFfQMFawKsPHTDU9qTXeXAaDx
+Zre3zu/O7Oyldcqs4+Fj97ihBMi8ez9dLRYiVu1ISf6nL3kwJZu6ay0/nTvEF+cd
+Lvvyz6b84xQslpghjLSR6Rlgg/IwKwZzUNWYOwbpx4oMYIwo+FKbbuH2TbsGJJvX
+KyY//SovcfXWJL5/MZ4PbeiPT02jP/816t9JXkGPhvnxd3lLG7SjXi/7RgLQZhNe
+XoVPzthwiHvOAbWWl9fNff2C+MIkwcoBOU+NosEUQB+cZtUMCUbW8tDRSHZWOkPL
+tgoRObqME2wGtZ7P6wIDAQABo0IwQDAdBgNVHQ4EFgQUUTMc7TZArxfTJc1paPKv
+TiM+s0EwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcN
+AQEMBQADggIBAGCmr1tfV9qJ20tQqcQjNSH/0GEwhJG3PxDPJY7Jv0Y02cEhJhxw
+GXIeo8mH/qlDZJY6yFMECrZBu8RHANmfGBg7sg7zNOok992vIGCukihfNudd5N7H
+PNtQOa27PShNlnx2xlv0wdsUpasZYgcYQF+Xkdycx6u1UQ3maVNVzDl92sURVXLF
+O4uJ+DQtpBflF+aZfTCIITfNMBc9uPK8qHWgQ9w+iUuQrm0D4ByjoJYJu32jtyoQ
+REtGBzRj7TG5BO6jm5qu5jF49OokYTurWGT/u4cnYiWB39yhL/btp/96j1EuMPik
+AdKFOV8BmZZvWltwGUb+hmA+rYAQCd05JS9Yf7vSdPD3Rh9GOUrYU9DzLjtxpdRv
+/PNn5AeP3SYZ4Y1b+qOTEZvpyDrDVWiakuFSdjjo4bq9+0/V77PnSIMx8IIh47a+
+p6tv75/fTM8BuGJqIz3nCU2AG3swpMPdB380vqQmsvZB6Akd4yCYqjdP//fx4ilw
+MUc/dNAUFvohigLVigmUdy7yWSiLfFCSCmZ4OIN1xLVaqBHG5cGdZlXPU8Sv13WF
+qUITVuwhd4GTWgzqltlJyqEI8pc7bZsEGCREjnwB8twl2F6GmrE52/WRMmrRpnCK
+ovfepEWFJqgejF0pW8hL2JpqA15w8oVPbEtoL8pU9ozaMv7Da4M/OMZ+
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certainly Root R1 O=Certainly
+# Subject: CN=Certainly Root R1 O=Certainly
+# Label: "Certainly Root R1"
+# Serial: 188833316161142517227353805653483829216
+# MD5 Fingerprint: 07:70:d4:3e:82:87:a0:fa:33:36:13:f4:fa:33:e7:12
+# SHA1 Fingerprint: a0:50:ee:0f:28:71:f4:27:b2:12:6d:6f:50:96:25:ba:cc:86:42:af
+# SHA256 Fingerprint: 77:b8:2c:d8:64:4c:43:05:f7:ac:c5:cb:15:6b:45:67:50:04:03:3d:51:c6:0c:62:02:a8:e0:c3:34:67:d3:a0
+-----BEGIN CERTIFICATE-----
+MIIFRzCCAy+gAwIBAgIRAI4P+UuQcWhlM1T01EQ5t+AwDQYJKoZIhvcNAQELBQAw
+PTELMAkGA1UEBhMCVVMxEjAQBgNVBAoTCUNlcnRhaW5seTEaMBgGA1UEAxMRQ2Vy
+dGFpbmx5IFJvb3QgUjEwHhcNMjEwNDAxMDAwMDAwWhcNNDYwNDAxMDAwMDAwWjA9
+MQswCQYDVQQGEwJVUzESMBAGA1UEChMJQ2VydGFpbmx5MRowGAYDVQQDExFDZXJ0
+YWlubHkgUm9vdCBSMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANA2
+1B/q3avk0bbm+yLA3RMNansiExyXPGhjZjKcA7WNpIGD2ngwEc/csiu+kr+O5MQT
+vqRoTNoCaBZ0vrLdBORrKt03H2As2/X3oXyVtwxwhi7xOu9S98zTm/mLvg7fMbed
+aFySpvXl8wo0tf97ouSHocavFwDvA5HtqRxOcT3Si2yJ9HiG5mpJoM610rCrm/b0
+1C7jcvk2xusVtyWMOvwlDbMicyF0yEqWYZL1LwsYpfSt4u5BvQF5+paMjRcCMLT5
+r3gajLQ2EBAHBXDQ9DGQilHFhiZ5shGIXsXwClTNSaa/ApzSRKft43jvRl5tcdF5
+cBxGX1HpyTfcX35pe0HfNEXgO4T0oYoKNp43zGJS4YkNKPl6I7ENPT2a/Z2B7yyQ
+wHtETrtJ4A5KVpK8y7XdeReJkd5hiXSSqOMyhb5OhaRLWcsrxXiOcVTQAjeZjOVJ
+6uBUcqQRBi8LjMFbvrWhsFNunLhgkR9Za/kt9JQKl7XsxXYDVBtlUrpMklZRNaBA
+2CnbrlJ2Oy0wQJuK0EJWtLeIAaSHO1OWzaMWj/Nmqhexx2DgwUMFDO6bW2BvBlyH
+Wyf5QBGenDPBt+U1VwV/J84XIIwc/PH72jEpSe31C4SnT8H2TsIonPru4K8H+zMR
+eiFPCyEQtkA6qyI6BJyLm4SGcprSp6XEtHWRqSsjAgMBAAGjQjBAMA4GA1UdDwEB
+/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTgqj8ljZ9EXME66C6u
+d0yEPmcM9DANBgkqhkiG9w0BAQsFAAOCAgEAuVevuBLaV4OPaAszHQNTVfSVcOQr
+PbA56/qJYv331hgELyE03fFo8NWWWt7CgKPBjcZq91l3rhVkz1t5BXdm6ozTaw3d
+8VkswTOlMIAVRQdFGjEitpIAq5lNOo93r6kiyi9jyhXWx8bwPWz8HA2YEGGeEaIi
+1wrykXprOQ4vMMM2SZ/g6Q8CRFA3lFV96p/2O7qUpUzpvD5RtOjKkjZUbVwlKNrd
+rRT90+7iIgXr0PK3aBLXWopBGsaSpVo7Y0VPv+E6dyIvXL9G+VoDhRNCX8reU9di
+taY1BMJH/5n9hN9czulegChB8n3nHpDYT3Y+gjwN/KUD+nsa2UUeYNrEjvn8K8l7
+lcUq/6qJ34IxD3L/DCfXCh5WAFAeDJDBlrXYFIW7pw0WwfgHJBu6haEaBQmAupVj
+yTrsJZ9/nbqkRxWbRHDxakvWOF5D8xh+UG7pWijmZeZ3Gzr9Hb4DJqPb1OG7fpYn
+Kx3upPvaJVQTA945xsMfTZDsjxtK0hzthZU4UHlG1sGQUDGpXJpuHfUzVounmdLy
+yCwzk5Iwx06MZTMQZBf9JBeW0Y3COmor6xOLRPIh80oat3df1+2IpHLlOR+Vnb5n
+wXARPbv0+Em34yaXOp/SX3z7wJl8OSngex2/DaeP0ik0biQVy96QXr8axGbqwua6
+OV+KmalBWQewLK8=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certainly Root E1 O=Certainly
+# Subject: CN=Certainly Root E1 O=Certainly
+# Label: "Certainly Root E1"
+# Serial: 8168531406727139161245376702891150584
+# MD5 Fingerprint: 0a:9e:ca:cd:3e:52:50:c6:36:f3:4b:a3:ed:a7:53:e9
+# SHA1 Fingerprint: f9:e1:6d:dc:01:89:cf:d5:82:45:63:3e:c5:37:7d:c2:eb:93:6f:2b
+# SHA256 Fingerprint: b4:58:5f:22:e4:ac:75:6a:4e:86:12:a1:36:1c:5d:9d:03:1a:93:fd:84:fe:bb:77:8f:a3:06:8b:0f:c4:2d:c2
+-----BEGIN CERTIFICATE-----
+MIIB9zCCAX2gAwIBAgIQBiUzsUcDMydc+Y2aub/M+DAKBggqhkjOPQQDAzA9MQsw
+CQYDVQQGEwJVUzESMBAGA1UEChMJQ2VydGFpbmx5MRowGAYDVQQDExFDZXJ0YWlu
+bHkgUm9vdCBFMTAeFw0yMTA0MDEwMDAwMDBaFw00NjA0MDEwMDAwMDBaMD0xCzAJ
+BgNVBAYTAlVTMRIwEAYDVQQKEwlDZXJ0YWlubHkxGjAYBgNVBAMTEUNlcnRhaW5s
+eSBSb290IEUxMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAE3m/4fxzf7flHh4axpMCK
++IKXgOqPyEpeKn2IaKcBYhSRJHpcnqMXfYqGITQYUBsQ3tA3SybHGWCA6TS9YBk2
+QNYphwk8kXr2vBMj3VlOBF7PyAIcGFPBMdjaIOlEjeR2o0IwQDAOBgNVHQ8BAf8E
+BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU8ygYy2R17ikq6+2uI1g4
+hevIIgcwCgYIKoZIzj0EAwMDaAAwZQIxALGOWiDDshliTd6wT99u0nCK8Z9+aozm
+ut6Dacpps6kFtZaSF4fC0urQe87YQVt8rgIwRt7qy12a7DLCZRawTDBcMPPaTnOG
+BtjOiQRINzf43TNRnXCve1XYAS59BWQOhriR
+-----END CERTIFICATE-----
+
+# Issuer: CN=Security Communication RootCA3 O=SECOM Trust Systems CO.,LTD.
+# Subject: CN=Security Communication RootCA3 O=SECOM Trust Systems CO.,LTD.
+# Label: "Security Communication RootCA3"
+# Serial: 16247922307909811815
+# MD5 Fingerprint: 1c:9a:16:ff:9e:5c:e0:4d:8a:14:01:f4:35:5d:29:26
+# SHA1 Fingerprint: c3:03:c8:22:74:92:e5:61:a2:9c:5f:79:91:2b:1e:44:13:91:30:3a
+# SHA256 Fingerprint: 24:a5:5c:2a:b0:51:44:2d:06:17:76:65:41:23:9a:4a:d0:32:d7:c5:51:75:aa:34:ff:de:2f:bc:4f:5c:52:94
+-----BEGIN CERTIFICATE-----
+MIIFfzCCA2egAwIBAgIJAOF8N0D9G/5nMA0GCSqGSIb3DQEBDAUAMF0xCzAJBgNV
+BAYTAkpQMSUwIwYDVQQKExxTRUNPTSBUcnVzdCBTeXN0ZW1zIENPLixMVEQuMScw
+JQYDVQQDEx5TZWN1cml0eSBDb21tdW5pY2F0aW9uIFJvb3RDQTMwHhcNMTYwNjE2
+MDYxNzE2WhcNMzgwMTE4MDYxNzE2WjBdMQswCQYDVQQGEwJKUDElMCMGA1UEChMc
+U0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UEAxMeU2VjdXJpdHkg
+Q29tbXVuaWNhdGlvbiBSb290Q0EzMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
+CgKCAgEA48lySfcw3gl8qUCBWNO0Ot26YQ+TUG5pPDXC7ltzkBtnTCHsXzW7OT4r
+CmDvu20rhvtxosis5FaU+cmvsXLUIKx00rgVrVH+hXShuRD+BYD5UpOzQD11EKzA
+lrenfna84xtSGc4RHwsENPXY9Wk8d/Nk9A2qhd7gCVAEF5aEt8iKvE1y/By7z/MG
+TfmfZPd+pmaGNXHIEYBMwXFAWB6+oHP2/D5Q4eAvJj1+XCO1eXDe+uDRpdYMQXF7
+9+qMHIjH7Iv10S9VlkZ8WjtYO/u62C21Jdp6Ts9EriGmnpjKIG58u4iFW/vAEGK7
+8vknR+/RiTlDxN/e4UG/VHMgly1s2vPUB6PmudhvrvyMGS7TZ2crldtYXLVqAvO4
+g160a75BflcJdURQVc1aEWEhCmHCqYj9E7wtiS/NYeCVvsq1e+F7NGcLH7YMx3we
+GVPKp7FKFSBWFHA9K4IsD50VHUeAR/94mQ4xr28+j+2GaR57GIgUssL8gjMunEst
++3A7caoreyYn8xrC3PsXuKHqy6C0rtOUfnrQq8PsOC0RLoi/1D+tEjtCrI8Cbn3M
+0V9hvqG8OmpI6iZVIhZdXw3/JzOfGAN0iltSIEdrRU0id4xVJ/CvHozJgyJUt5rQ
+T9nO/NkuHJYosQLTA70lUhw0Zk8jq/R3gpYd0VcwCBEF/VfR2ccCAwEAAaNCMEAw
+HQYDVR0OBBYEFGQUfPxYchamCik0FW8qy7z8r6irMA4GA1UdDwEB/wQEAwIBBjAP
+BgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3DQEBDAUAA4ICAQDcAiMI4u8hOscNtybS
+YpOnpSNyByCCYN8Y11StaSWSntkUz5m5UoHPrmyKO1o5yGwBQ8IibQLwYs1OY0PA
+FNr0Y/Dq9HHuTofjcan0yVflLl8cebsjqodEV+m9NU1Bu0soo5iyG9kLFwfl9+qd
+9XbXv8S2gVj/yP9kaWJ5rW4OH3/uHWnlt3Jxs/6lATWUVCvAUm2PVcTJ0rjLyjQI
+UYWg9by0F1jqClx6vWPGOi//lkkZhOpn2ASxYfQAW0q3nHE3GYV5v4GwxxMOdnE+
+OoAGrgYWp421wsTL/0ClXI2lyTrtcoHKXJg80jQDdwj98ClZXSEIx2C/pHF7uNke
+gr4Jr2VvKKu/S7XuPghHJ6APbw+LP6yVGPO5DtxnVW5inkYO0QR4ynKudtml+LLf
+iAlhi+8kTtFZP1rUPcmTPCtk9YENFpb3ksP+MW/oKjJ0DvRMmEoYDjBU1cXrvMUV
+nuiZIesnKwkK2/HmcBhWuwzkvvnoEKQTkrgc4NtnHVMDpCKn3F2SEDzq//wbEBrD
+2NCcnWXL0CsnMQMeNuE9dnUM/0Umud1RvCPHX9jYhxBAEg09ODfnRDwYwFMJZI//
+1ZqmfHAuc1Uh6N//g7kdPjIe1qZ9LPFm6Vwdp6POXiUyK+OVrCoHzrQoeIY8Laad
+TdJ0MN1kURXbg4NR16/9M51NZg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Security Communication ECC RootCA1 O=SECOM Trust Systems CO.,LTD.
+# Subject: CN=Security Communication ECC RootCA1 O=SECOM Trust Systems CO.,LTD.
+# Label: "Security Communication ECC RootCA1"
+# Serial: 15446673492073852651
+# MD5 Fingerprint: 7e:43:b0:92:68:ec:05:43:4c:98:ab:5d:35:2e:7e:86
+# SHA1 Fingerprint: b8:0e:26:a9:bf:d2:b2:3b:c0:ef:46:c9:ba:c7:bb:f6:1d:0d:41:41
+# SHA256 Fingerprint: e7:4f:bd:a5:5b:d5:64:c4:73:a3:6b:44:1a:a7:99:c8:a6:8e:07:74:40:e8:28:8b:9f:a1:e5:0e:4b:ba:ca:11
+-----BEGIN CERTIFICATE-----
+MIICODCCAb6gAwIBAgIJANZdm7N4gS7rMAoGCCqGSM49BAMDMGExCzAJBgNVBAYT
+AkpQMSUwIwYDVQQKExxTRUNPTSBUcnVzdCBTeXN0ZW1zIENPLixMVEQuMSswKQYD
+VQQDEyJTZWN1cml0eSBDb21tdW5pY2F0aW9uIEVDQyBSb290Q0ExMB4XDTE2MDYx
+NjA1MTUyOFoXDTM4MDExODA1MTUyOFowYTELMAkGA1UEBhMCSlAxJTAjBgNVBAoT
+HFNFQ09NIFRydXN0IFN5c3RlbXMgQ08uLExURC4xKzApBgNVBAMTIlNlY3VyaXR5
+IENvbW11bmljYXRpb24gRUNDIFJvb3RDQTEwdjAQBgcqhkjOPQIBBgUrgQQAIgNi
+AASkpW9gAwPDvTH00xecK4R1rOX9PVdu12O/5gSJko6BnOPpR27KkBLIE+Cnnfdl
+dB9sELLo5OnvbYUymUSxXv3MdhDYW72ixvnWQuRXdtyQwjWpS4g8EkdtXP9JTxpK
+ULGjQjBAMB0GA1UdDgQWBBSGHOf+LaVKiwj+KBH6vqNm+GBZLzAOBgNVHQ8BAf8E
+BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjAVXUI9/Lbu
+9zuxNuie9sRGKEkz0FhDKmMpzE2xtHqiuQ04pV1IKv3LsnNdo4gIxwwCMQDAqy0O
+be0YottT6SXbVQjgUMzfRGEWgqtJsLKB7HOHeLRMsmIbEvoWTSVLY70eN9k=
+-----END CERTIFICATE-----
+
+# Issuer: CN=BJCA Global Root CA1 O=BEIJING CERTIFICATE AUTHORITY
+# Subject: CN=BJCA Global Root CA1 O=BEIJING CERTIFICATE AUTHORITY
+# Label: "BJCA Global Root CA1"
+# Serial: 113562791157148395269083148143378328608
+# MD5 Fingerprint: 42:32:99:76:43:33:36:24:35:07:82:9b:28:f9:d0:90
+# SHA1 Fingerprint: d5:ec:8d:7b:4c:ba:79:f4:e7:e8:cb:9d:6b:ae:77:83:10:03:21:6a
+# SHA256 Fingerprint: f3:89:6f:88:fe:7c:0a:88:27:66:a7:fa:6a:d2:74:9f:b5:7a:7f:3e:98:fb:76:9c:1f:a7:b0:9c:2c:44:d5:ae
+-----BEGIN CERTIFICATE-----
+MIIFdDCCA1ygAwIBAgIQVW9l47TZkGobCdFsPsBsIDANBgkqhkiG9w0BAQsFADBU
+MQswCQYDVQQGEwJDTjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRI
+T1JJVFkxHTAbBgNVBAMMFEJKQ0EgR2xvYmFsIFJvb3QgQ0ExMB4XDTE5MTIxOTAz
+MTYxN1oXDTQ0MTIxMjAzMTYxN1owVDELMAkGA1UEBhMCQ04xJjAkBgNVBAoMHUJF
+SUpJTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQDDBRCSkNBIEdsb2Jh
+bCBSb290IENBMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAPFmCL3Z
+xRVhy4QEQaVpN3cdwbB7+sN3SJATcmTRuHyQNZ0YeYjjlwE8R4HyDqKYDZ4/N+AZ
+spDyRhySsTphzvq3Rp4Dhtczbu33RYx2N95ulpH3134rhxfVizXuhJFyV9xgw8O5
+58dnJCNPYwpj9mZ9S1WnP3hkSWkSl+BMDdMJoDIwOvqfwPKcxRIqLhy1BDPapDgR
+at7GGPZHOiJBhyL8xIkoVNiMpTAK+BcWyqw3/XmnkRd4OJmtWO2y3syJfQOcs4ll
+5+M7sSKGjwZteAf9kRJ/sGsciQ35uMt0WwfCyPQ10WRjeulumijWML3mG90Vr4Tq
+nMfK9Q7q8l0ph49pczm+LiRvRSGsxdRpJQaDrXpIhRMsDQa4bHlW/KNnMoH1V6XK
+V0Jp6VwkYe/iMBhORJhVb3rCk9gZtt58R4oRTklH2yiUAguUSiz5EtBP6DF+bHq/
+pj+bOT0CFqMYs2esWz8sgytnOYFcuX6U1WTdno9uruh8W7TXakdI136z1C2OVnZO
+z2nxbkRs1CTqjSShGL+9V/6pmTW12xB3uD1IutbB5/EjPtffhZ0nPNRAvQoMvfXn
+jSXWgXSHRtQpdaJCbPdzied9v3pKH9MiyRVVz99vfFXQpIsHETdfg6YmV6YBW37+
+WGgHqel62bno/1Afq8K0wM7o6v0PvY1NuLxxAgMBAAGjQjBAMB0GA1UdDgQWBBTF
+7+3M2I0hxkjk49cULqcWk+WYATAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQE
+AwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAUoKsITQfI/Ki2Pm4rzc2IInRNwPWaZ+4
+YRC6ojGYWUfo0Q0lHhVBDOAqVdVXUsv45Mdpox1NcQJeXyFFYEhcCY5JEMEE3Kli
+awLwQ8hOnThJdMkycFRtwUf8jrQ2ntScvd0g1lPJGKm1Vrl2i5VnZu69mP6u775u
++2D2/VnGKhs/I0qUJDAnyIm860Qkmss9vk/Ves6OF8tiwdneHg56/0OGNFK8YT88
+X7vZdrRTvJez/opMEi4r89fO4aL/3Xtw+zuhTaRjAv04l5U/BXCga99igUOLtFkN
+SoxUnMW7gZ/NfaXvCyUeOiDbHPwfmGcCCtRzRBPbUYQaVQNW4AB+dAb/OMRyHdOo
+P2gxXdMJxy6MW2Pg6Nwe0uxhHvLe5e/2mXZgLR6UcnHGCyoyx5JO1UbXHfmpGQrI
++pXObSOYqgs4rZpWDW+N8TEAiMEXnM0ZNjX+VVOg4DwzX5Ze4jLp3zO7Bkqp2IRz
+znfSxqxx4VyjHQy7Ct9f4qNx2No3WqB4K/TUfet27fJhcKVlmtOJNBir+3I+17Q9
+eVzYH6Eze9mCUAyTF6ps3MKCuwJXNq+YJyo5UOGwifUll35HaBC07HPKs5fRJNz2
+YqAo07WjuGS3iGJCz51TzZm+ZGiPTx4SSPfSKcOYKMryMguTjClPPGAyzQWWYezy
+r/6zcCwupvI=
+-----END CERTIFICATE-----
+
+# Issuer: CN=BJCA Global Root CA2 O=BEIJING CERTIFICATE AUTHORITY
+# Subject: CN=BJCA Global Root CA2 O=BEIJING CERTIFICATE AUTHORITY
+# Label: "BJCA Global Root CA2"
+# Serial: 58605626836079930195615843123109055211
+# MD5 Fingerprint: 5e:0a:f6:47:5f:a6:14:e8:11:01:95:3f:4d:01:eb:3c
+# SHA1 Fingerprint: f4:27:86:eb:6e:b8:6d:88:31:67:02:fb:ba:66:a4:53:00:aa:7a:a6
+# SHA256 Fingerprint: 57:4d:f6:93:1e:27:80:39:66:7b:72:0a:fd:c1:60:0f:c2:7e:b6:6d:d3:09:29:79:fb:73:85:64:87:21:28:82
+-----BEGIN CERTIFICATE-----
+MIICJTCCAaugAwIBAgIQLBcIfWQqwP6FGFkGz7RK6zAKBggqhkjOPQQDAzBUMQsw
+CQYDVQQGEwJDTjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRIT1JJ
+VFkxHTAbBgNVBAMMFEJKQ0EgR2xvYmFsIFJvb3QgQ0EyMB4XDTE5MTIxOTAzMTgy
+MVoXDTQ0MTIxMjAzMTgyMVowVDELMAkGA1UEBhMCQ04xJjAkBgNVBAoMHUJFSUpJ
+TkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQDDBRCSkNBIEdsb2JhbCBS
+b290IENBMjB2MBAGByqGSM49AgEGBSuBBAAiA2IABJ3LgJGNU2e1uVCxA/jlSR9B
+IgmwUVJY1is0j8USRhTFiy8shP8sbqjV8QnjAyEUxEM9fMEsxEtqSs3ph+B99iK+
++kpRuDCK/eHeGBIK9ke35xe/J4rUQUyWPGCWwf0VHKNCMEAwHQYDVR0OBBYEFNJK
+sVF/BvDRgh9Obl+rg/xI1LCRMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD
+AgEGMAoGCCqGSM49BAMDA2gAMGUCMBq8W9f+qdJUDkpd0m2xQNz0Q9XSSpkZElaA
+94M04TVOSG0ED1cxMDAtsaqdAzjbBgIxAMvMh1PLet8gUXOQwKhbYdDFUDn9hf7B
+43j4ptZLvZuHjw/l1lOWqzzIQNph91Oj9w==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Sectigo Public Server Authentication Root E46 O=Sectigo Limited
+# Subject: CN=Sectigo Public Server Authentication Root E46 O=Sectigo Limited
+# Label: "Sectigo Public Server Authentication Root E46"
+# Serial: 88989738453351742415770396670917916916
+# MD5 Fingerprint: 28:23:f8:b2:98:5c:37:16:3b:3e:46:13:4e:b0:b3:01
+# SHA1 Fingerprint: ec:8a:39:6c:40:f0:2e:bc:42:75:d4:9f:ab:1c:1a:5b:67:be:d2:9a
+# SHA256 Fingerprint: c9:0f:26:f0:fb:1b:40:18:b2:22:27:51:9b:5c:a2:b5:3e:2c:a5:b3:be:5c:f1:8e:fe:1b:ef:47:38:0c:53:83
+-----BEGIN CERTIFICATE-----
+MIICOjCCAcGgAwIBAgIQQvLM2htpN0RfFf51KBC49DAKBggqhkjOPQQDAzBfMQsw
+CQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1T
+ZWN0aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwHhcN
+MjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1OTU5WjBfMQswCQYDVQQGEwJHQjEYMBYG
+A1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1YmxpYyBT
+ZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwdjAQBgcqhkjOPQIBBgUrgQQA
+IgNiAAR2+pmpbiDt+dd34wc7qNs9Xzjoq1WmVk/WSOrsfy2qw7LFeeyZYX8QeccC
+WvkEN/U0NSt3zn8gj1KjAIns1aeibVvjS5KToID1AZTc8GgHHs3u/iVStSBDHBv+
+6xnOQ6OjQjBAMB0GA1UdDgQWBBTRItpMWfFLXyY4qp3W7usNw/upYTAOBgNVHQ8B
+Af8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNnADBkAjAn7qRa
+qCG76UeXlImldCBteU/IvZNeWBj7LRoAasm4PdCkT0RHlAFWovgzJQxC36oCMB3q
+4S6ILuH5px0CMk7yn2xVdOOurvulGu7t0vzCAxHrRVxgED1cf5kDW21USAGKcw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Sectigo Public Server Authentication Root R46 O=Sectigo Limited
+# Subject: CN=Sectigo Public Server Authentication Root R46 O=Sectigo Limited
+# Label: "Sectigo Public Server Authentication Root R46"
+# Serial: 156256931880233212765902055439220583700
+# MD5 Fingerprint: 32:10:09:52:00:d5:7e:6c:43:df:15:c0:b1:16:93:e5
+# SHA1 Fingerprint: ad:98:f9:f3:e4:7d:75:3b:65:d4:82:b3:a4:52:17:bb:6e:f5:e4:38
+# SHA256 Fingerprint: 7b:b6:47:a6:2a:ee:ac:88:bf:25:7a:a5:22:d0:1f:fe:a3:95:e0:ab:45:c7:3f:93:f6:56:54:ec:38:f2:5a:06
+-----BEGIN CERTIFICATE-----
+MIIFijCCA3KgAwIBAgIQdY39i658BwD6qSWn4cetFDANBgkqhkiG9w0BAQwFADBf
+MQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQD
+Ey1TZWN0aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYw
+HhcNMjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1OTU5WjBfMQswCQYDVQQGEwJHQjEY
+MBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1Ymxp
+YyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEB
+AQUAA4ICDwAwggIKAoICAQCTvtU2UnXYASOgHEdCSe5jtrch/cSV1UgrJnwUUxDa
+ef0rty2k1Cz66jLdScK5vQ9IPXtamFSvnl0xdE8H/FAh3aTPaE8bEmNtJZlMKpnz
+SDBh+oF8HqcIStw+KxwfGExxqjWMrfhu6DtK2eWUAtaJhBOqbchPM8xQljeSM9xf
+iOefVNlI8JhD1mb9nxc4Q8UBUQvX4yMPFF1bFOdLvt30yNoDN9HWOaEhUTCDsG3X
+ME6WW5HwcCSrv0WBZEMNvSE6Lzzpng3LILVCJ8zab5vuZDCQOc2TZYEhMbUjUDM3
+IuM47fgxMMxF/mL50V0yeUKH32rMVhlATc6qu/m1dkmU8Sf4kaWD5QazYw6A3OAS
+VYCmO2a0OYctyPDQ0RTp5A1NDvZdV3LFOxxHVp3i1fuBYYzMTYCQNFu31xR13NgE
+SJ/AwSiItOkcyqex8Va3e0lMWeUgFaiEAin6OJRpmkkGj80feRQXEgyDet4fsZfu
++Zd4KKTIRJLpfSYFplhym3kT2BFfrsU4YjRosoYwjviQYZ4ybPUHNs2iTG7sijbt
+8uaZFURww3y8nDnAtOFr94MlI1fZEoDlSfB1D++N6xybVCi0ITz8fAr/73trdf+L
+HaAZBav6+CuBQug4urv7qv094PPK306Xlynt8xhW6aWWrL3DkJiy4Pmi1KZHQ3xt
+zwIDAQABo0IwQDAdBgNVHQ4EFgQUVnNYZJX5khqwEioEYnmhQBWIIUkwDgYDVR0P
+AQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAC9c
+mTz8Bl6MlC5w6tIyMY208FHVvArzZJ8HXtXBc2hkeqK5Duj5XYUtqDdFqij0lgVQ
+YKlJfp/imTYpE0RHap1VIDzYm/EDMrraQKFz6oOht0SmDpkBm+S8f74TlH7Kph52
+gDY9hAaLMyZlbcp+nv4fjFg4exqDsQ+8FxG75gbMY/qB8oFM2gsQa6H61SilzwZA
+Fv97fRheORKkU55+MkIQpiGRqRxOF3yEvJ+M0ejf5lG5Nkc/kLnHvALcWxxPDkjB
+JYOcCj+esQMzEhonrPcibCTRAUH4WAP+JWgiH5paPHxsnnVI84HxZmduTILA7rpX
+DhjvLpr3Etiga+kFpaHpaPi8TD8SHkXoUsCjvxInebnMMTzD9joiFgOgyY9mpFui
+TdaBJQbpdqQACj7LzTWb4OE4y2BThihCQRxEV+ioratF4yUQvNs+ZUH7G6aXD+u5
+dHn5HrwdVw1Hr8Mvn4dGp+smWg9WY7ViYG4A++MnESLn/pmPNPW56MORcr3Ywx65
+LvKRRFHQV80MNNVIIb/bE/FmJUNS0nAiNs2fxBx1IK1jcmMGDw4nztJqDby1ORrp
+0XZ60Vzk50lJLVU3aPAaOpg+VBeHVOmmJ1CJeyAvP/+/oYtKR5j/K3tJPsMpRmAY
+QqszKbrAKbkTidOIijlBO8n9pu0f9GBj39ItVQGL
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com TLS RSA Root CA 2022 O=SSL Corporation
+# Subject: CN=SSL.com TLS RSA Root CA 2022 O=SSL Corporation
+# Label: "SSL.com TLS RSA Root CA 2022"
+# Serial: 148535279242832292258835760425842727825
+# MD5 Fingerprint: d8:4e:c6:59:30:d8:fe:a0:d6:7a:5a:2c:2c:69:78:da
+# SHA1 Fingerprint: ec:2c:83:40:72:af:26:95:10:ff:0e:f2:03:ee:31:70:f6:78:9d:ca
+# SHA256 Fingerprint: 8f:af:7d:2e:2c:b4:70:9b:b8:e0:b3:36:66:bf:75:a5:dd:45:b5:de:48:0f:8e:a8:d4:bf:e6:be:bc:17:f2:ed
+-----BEGIN CERTIFICATE-----
+MIIFiTCCA3GgAwIBAgIQb77arXO9CEDii02+1PdbkTANBgkqhkiG9w0BAQsFADBO
+MQswCQYDVQQGEwJVUzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQD
+DBxTU0wuY29tIFRMUyBSU0EgUm9vdCBDQSAyMDIyMB4XDTIyMDgyNTE2MzQyMloX
+DTQ2MDgxOTE2MzQyMVowTjELMAkGA1UEBhMCVVMxGDAWBgNVBAoMD1NTTCBDb3Jw
+b3JhdGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgUlNBIFJvb3QgQ0EgMjAyMjCC
+AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANCkCXJPQIgSYT41I57u9nTP
+L3tYPc48DRAokC+X94xI2KDYJbFMsBFMF3NQ0CJKY7uB0ylu1bUJPiYYf7ISf5OY
+t6/wNr/y7hienDtSxUcZXXTzZGbVXcdotL8bHAajvI9AI7YexoS9UcQbOcGV0ins
+S657Lb85/bRi3pZ7QcacoOAGcvvwB5cJOYF0r/c0WRFXCsJbwST0MXMwgsadugL3
+PnxEX4MN8/HdIGkWCVDi1FW24IBydm5MR7d1VVm0U3TZlMZBrViKMWYPHqIbKUBO
+L9975hYsLfy/7PO0+r4Y9ptJ1O4Fbtk085zx7AGL0SDGD6C1vBdOSHtRwvzpXGk3
+R2azaPgVKPC506QVzFpPulJwoxJF3ca6TvvC0PeoUidtbnm1jPx7jMEWTO6Af77w
+dr5BUxIzrlo4QqvXDz5BjXYHMtWrifZOZ9mxQnUjbvPNQrL8VfVThxc7wDNY8VLS
++YCk8OjwO4s4zKTGkH8PnP2L0aPP2oOnaclQNtVcBdIKQXTbYxE3waWglksejBYS
+d66UNHsef8JmAOSqg+qKkK3ONkRN0VHpvB/zagX9wHQfJRlAUW7qglFA35u5CCoG
+AtUjHBPW6dvbxrB6y3snm/vg1UYk7RBLY0ulBY+6uB0rpvqR4pJSvezrZ5dtmi2f
+gTIFZzL7SAg/2SW4BCUvAgMBAAGjYzBhMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0j
+BBgwFoAU+y437uOEeicuzRk1sTN8/9REQrkwHQYDVR0OBBYEFPsuN+7jhHonLs0Z
+NbEzfP/UREK5MA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAjYlt
+hEUY8U+zoO9opMAdrDC8Z2awms22qyIZZtM7QbUQnRC6cm4pJCAcAZli05bg4vsM
+QtfhWsSWTVTNj8pDU/0quOr4ZcoBwq1gaAafORpR2eCNJvkLTqVTJXojpBzOCBvf
+R4iyrT7gJ4eLSYwfqUdYe5byiB0YrrPRpgqU+tvT5TgKa3kSM/tKWTcWQA673vWJ
+DPFs0/dRa1419dvAJuoSc06pkZCmF8NsLzjUo3KUQyxi4U5cMj29TH0ZR6LDSeeW
+P4+a0zvkEdiLA9z2tmBVGKaBUfPhqBVq6+AL8BQx1rmMRTqoENjwuSfr98t67wVy
+lrXEj5ZzxOhWc5y8aVFjvO9nHEMaX3cZHxj4HCUp+UmZKbaSPaKDN7EgkaibMOlq
+bLQjk2UEqxHzDh1TJElTHaE/nUiSEeJ9DU/1172iWD54nR4fK/4huxoTtrEoZP2w
+AgDHbICivRZQIA9ygV/MlP+7mea6kMvq+cYMwq7FGc4zoWtcu358NFcXrfA/rs3q
+r5nsLFR+jM4uElZI7xc7P0peYNLcdDa8pUNjyw9bowJWCZ4kLOGGgYz+qxcs+sji
+Mho6/4UIyYOf8kpIEFR3N+2ivEC+5BB09+Rbu7nzifmPQdjH5FCQNYA+HLhNkNPU
+98OwoX6EyneSMSy4kLGCenROmxMmtNVQZlR4rmA=
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com TLS ECC Root CA 2022 O=SSL Corporation
+# Subject: CN=SSL.com TLS ECC Root CA 2022 O=SSL Corporation
+# Label: "SSL.com TLS ECC Root CA 2022"
+# Serial: 26605119622390491762507526719404364228
+# MD5 Fingerprint: 99:d7:5c:f1:51:36:cc:e9:ce:d9:19:2e:77:71:56:c5
+# SHA1 Fingerprint: 9f:5f:d9:1a:54:6d:f5:0c:71:f0:ee:7a:bd:17:49:98:84:73:e2:39
+# SHA256 Fingerprint: c3:2f:fd:9f:46:f9:36:d1:6c:36:73:99:09:59:43:4b:9a:d6:0a:af:bb:9e:7c:f3:36:54:f1:44:cc:1b:a1:43
+-----BEGIN CERTIFICATE-----
+MIICOjCCAcCgAwIBAgIQFAP1q/s3ixdAW+JDsqXRxDAKBggqhkjOPQQDAzBOMQsw
+CQYDVQQGEwJVUzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQDDBxT
+U0wuY29tIFRMUyBFQ0MgUm9vdCBDQSAyMDIyMB4XDTIyMDgyNTE2MzM0OFoXDTQ2
+MDgxOTE2MzM0N1owTjELMAkGA1UEBhMCVVMxGDAWBgNVBAoMD1NTTCBDb3Jwb3Jh
+dGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgRUNDIFJvb3QgQ0EgMjAyMjB2MBAG
+ByqGSM49AgEGBSuBBAAiA2IABEUpNXP6wrgjzhR9qLFNoFs27iosU8NgCTWyJGYm
+acCzldZdkkAZDsalE3D07xJRKF3nzL35PIXBz5SQySvOkkJYWWf9lCcQZIxPBLFN
+SeR7T5v15wj4A4j3p8OSSxlUgaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSME
+GDAWgBSJjy+j6CugFFR781a4Jl9nOAuc0DAdBgNVHQ4EFgQUiY8vo+groBRUe/NW
+uCZfZzgLnNAwDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMDA2gAMGUCMFXjIlbp
+15IkWE8elDIPDAI2wv2sdDJO4fscgIijzPvX6yv/N33w7deedWo1dlJF4AIxAMeN
+b0Igj762TVntd00pxCAgRWSGOlDGxK0tk/UYfXLtqc/ErFc2KAhl3zx5Zn6g6g==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Atos TrustedRoot Root CA ECC TLS 2021 O=Atos
+# Subject: CN=Atos TrustedRoot Root CA ECC TLS 2021 O=Atos
+# Label: "Atos TrustedRoot Root CA ECC TLS 2021"
+# Serial: 81873346711060652204712539181482831616
+# MD5 Fingerprint: 16:9f:ad:f1:70:ad:79:d6:ed:29:b4:d1:c5:79:70:a8
+# SHA1 Fingerprint: 9e:bc:75:10:42:b3:02:f3:81:f4:f7:30:62:d4:8f:c3:a7:51:b2:dd
+# SHA256 Fingerprint: b2:fa:e5:3e:14:cc:d7:ab:92:12:06:47:01:ae:27:9c:1d:89:88:fa:cb:77:5f:a8:a0:08:91:4e:66:39:88:a8
+-----BEGIN CERTIFICATE-----
+MIICFTCCAZugAwIBAgIQPZg7pmY9kGP3fiZXOATvADAKBggqhkjOPQQDAzBMMS4w
+LAYDVQQDDCVBdG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgRUNDIFRMUyAyMDIxMQ0w
+CwYDVQQKDARBdG9zMQswCQYDVQQGEwJERTAeFw0yMTA0MjIwOTI2MjNaFw00MTA0
+MTcwOTI2MjJaMEwxLjAsBgNVBAMMJUF0b3MgVHJ1c3RlZFJvb3QgUm9vdCBDQSBF
+Q0MgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNVBAYTAkRFMHYwEAYHKoZI
+zj0CAQYFK4EEACIDYgAEloZYKDcKZ9Cg3iQZGeHkBQcfl+3oZIK59sRxUM6KDP/X
+tXa7oWyTbIOiaG6l2b4siJVBzV3dscqDY4PMwL502eCdpO5KTlbgmClBk1IQ1SQ4
+AjJn8ZQSb+/Xxd4u/RmAo0IwQDAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBR2
+KCXWfeBmmnoJsmo7jjPXNtNPojAOBgNVHQ8BAf8EBAMCAYYwCgYIKoZIzj0EAwMD
+aAAwZQIwW5kp85wxtolrbNa9d+F851F+uDrNozZffPc8dz7kUK2o59JZDCaOMDtu
+CCrCp1rIAjEAmeMM56PDr9NJLkaCI2ZdyQAUEv049OGYa3cpetskz2VAv9LcjBHo
+9H1/IISpQuQo
+-----END CERTIFICATE-----
+
+# Issuer: CN=Atos TrustedRoot Root CA RSA TLS 2021 O=Atos
+# Subject: CN=Atos TrustedRoot Root CA RSA TLS 2021 O=Atos
+# Label: "Atos TrustedRoot Root CA RSA TLS 2021"
+# Serial: 111436099570196163832749341232207667876
+# MD5 Fingerprint: d4:d3:46:b8:9a:c0:9c:76:5d:9e:3a:c3:b9:99:31:d2
+# SHA1 Fingerprint: 18:52:3b:0d:06:37:e4:d6:3a:df:23:e4:98:fb:5b:16:fb:86:74:48
+# SHA256 Fingerprint: 81:a9:08:8e:a5:9f:b3:64:c5:48:a6:f8:55:59:09:9b:6f:04:05:ef:bf:18:e5:32:4e:c9:f4:57:ba:00:11:2f
+-----BEGIN CERTIFICATE-----
+MIIFZDCCA0ygAwIBAgIQU9XP5hmTC/srBRLYwiqipDANBgkqhkiG9w0BAQwFADBM
+MS4wLAYDVQQDDCVBdG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgUlNBIFRMUyAyMDIx
+MQ0wCwYDVQQKDARBdG9zMQswCQYDVQQGEwJERTAeFw0yMTA0MjIwOTIxMTBaFw00
+MTA0MTcwOTIxMDlaMEwxLjAsBgNVBAMMJUF0b3MgVHJ1c3RlZFJvb3QgUm9vdCBD
+QSBSU0EgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNVBAYTAkRFMIICIjAN
+BgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAtoAOxHm9BYx9sKOdTSJNy/BBl01Z
+4NH+VoyX8te9j2y3I49f1cTYQcvyAh5x5en2XssIKl4w8i1mx4QbZFc4nXUtVsYv
+Ye+W/CBGvevUez8/fEc4BKkbqlLfEzfTFRVOvV98r61jx3ncCHvVoOX3W3WsgFWZ
+kmGbzSoXfduP9LVq6hdKZChmFSlsAvFr1bqjM9xaZ6cF4r9lthawEO3NUDPJcFDs
+GY6wx/J0W2tExn2WuZgIWWbeKQGb9Cpt0xU6kGpn8bRrZtkh68rZYnxGEFzedUln
+nkL5/nWpo63/dgpnQOPF943HhZpZnmKaau1Fh5hnstVKPNe0OwANwI8f4UDErmwh
+3El+fsqyjW22v5MvoVw+j8rtgI5Y4dtXz4U2OLJxpAmMkokIiEjxQGMYsluMWuPD
+0xeqqxmjLBvk1cbiZnrXghmmOxYsL3GHX0WelXOTwkKBIROW1527k2gV+p2kHYzy
+geBYBr3JtuP2iV2J+axEoctr+hbxx1A9JNr3w+SH1VbxT5Aw+kUJWdo0zuATHAR8
+ANSbhqRAvNncTFd+rrcztl524WWLZt+NyteYr842mIycg5kDcPOvdO3GDjbnvezB
+c6eUWsuSZIKmAMFwoW4sKeFYV+xafJlrJaSQOoD0IJ2azsct+bJLKZWD6TWNp0lI
+pw9MGZHQ9b8Q4HECAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU
+dEmZ0f+0emhFdcN+tNzMzjkz2ggwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEB
+DAUAA4ICAQAjQ1MkYlxt/T7Cz1UAbMVWiLkO3TriJQ2VSpfKgInuKs1l+NsW4AmS
+4BjHeJi78+xCUvuppILXTdiK/ORO/auQxDh1MoSf/7OwKwIzNsAQkG8dnK/haZPs
+o0UvFJ/1TCplQ3IM98P4lYsU84UgYt1UU90s3BiVaU+DR3BAM1h3Egyi61IxHkzJ
+qM7F78PRreBrAwA0JrRUITWXAdxfG/F851X6LWh3e9NpzNMOa7pNdkTWwhWaJuyw
+xfW70Xp0wmzNxbVe9kzmWy2B27O3Opee7c9GslA9hGCZcbUztVdF5kJHdWoOsAgM
+rr3e97sPWD2PAzHoPYJQyi9eDF20l74gNAf0xBLh7tew2VktafcxBPTy+av5EzH4
+AXcOPUIjJsyacmdRIXrMPIWo6iFqO9taPKU0nprALN+AnCng33eU0aKAQv9qTFsR
+0PXNor6uzFFcw9VUewyu1rkGd4Di7wcaaMxZUa1+XGdrudviB0JbuAEFWDlN5LuY
+o7Ey7Nmj1m+UI/87tyll5gfp77YZ6ufCOB0yiJA8EytuzO+rdwY0d4RPcuSBhPm5
+dDTedk+SKlOxJTnbPP/lPqYO5Wue/9vsL3SD3460s6neFE3/MaNFcyT6lSnMEpcE
+oji2jbDwN/zIIX8/syQbPYtuzE2wFg2WHYMfRsCbvUOZ58SWLs5fyQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=TrustAsia Global Root CA G3 O=TrustAsia Technologies, Inc.
+# Subject: CN=TrustAsia Global Root CA G3 O=TrustAsia Technologies, Inc.
+# Label: "TrustAsia Global Root CA G3"
+# Serial: 576386314500428537169965010905813481816650257167
+# MD5 Fingerprint: 30:42:1b:b7:bb:81:75:35:e4:16:4f:53:d2:94:de:04
+# SHA1 Fingerprint: 63:cf:b6:c1:27:2b:56:e4:88:8e:1c:23:9a:b6:2e:81:47:24:c3:c7
+# SHA256 Fingerprint: e0:d3:22:6a:eb:11:63:c2:e4:8f:f9:be:3b:50:b4:c6:43:1b:e7:bb:1e:ac:c5:c3:6b:5d:5e:c5:09:03:9a:08
+-----BEGIN CERTIFICATE-----
+MIIFpTCCA42gAwIBAgIUZPYOZXdhaqs7tOqFhLuxibhxkw8wDQYJKoZIhvcNAQEM
+BQAwWjELMAkGA1UEBhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dp
+ZXMsIEluYy4xJDAiBgNVBAMMG1RydXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHMzAe
+Fw0yMTA1MjAwMjEwMTlaFw00NjA1MTkwMjEwMTlaMFoxCzAJBgNVBAYTAkNOMSUw
+IwYDVQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMuMSQwIgYDVQQDDBtU
+cnVzdEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzMwggIiMA0GCSqGSIb3DQEBAQUAA4IC
+DwAwggIKAoICAQDAMYJhkuSUGwoqZdC+BqmHO1ES6nBBruL7dOoKjbmzTNyPtxNS
+T1QY4SxzlZHFZjtqz6xjbYdT8PfxObegQ2OwxANdV6nnRM7EoYNl9lA+sX4WuDqK
+AtCWHwDNBSHvBm3dIZwZQ0WhxeiAysKtQGIXBsaqvPPW5vxQfmZCHzyLpnl5hkA1
+nyDvP+uLRx+PjsXUjrYsyUQE49RDdT/VP68czH5GX6zfZBCK70bwkPAPLfSIC7Ep
+qq+FqklYqL9joDiR5rPmd2jE+SoZhLsO4fWvieylL1AgdB4SQXMeJNnKziyhWTXA
+yB1GJ2Faj/lN03J5Zh6fFZAhLf3ti1ZwA0pJPn9pMRJpxx5cynoTi+jm9WAPzJMs
+hH/x/Gr8m0ed262IPfN2dTPXS6TIi/n1Q1hPy8gDVI+lhXgEGvNz8teHHUGf59gX
+zhqcD0r83ERoVGjiQTz+LISGNzzNPy+i2+f3VANfWdP3kXjHi3dqFuVJhZBFcnAv
+kV34PmVACxmZySYgWmjBNb9Pp1Hx2BErW+Canig7CjoKH8GB5S7wprlppYiU5msT
+f9FkPz2ccEblooV7WIQn3MSAPmeamseaMQ4w7OYXQJXZRe0Blqq/DPNL0WP3E1jA
+uPP6Z92bfW1K/zJMtSU7/xxnD4UiWQWRkUF3gdCFTIcQcf+eQxuulXUtgQIDAQAB
+o2MwYTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFEDk5PIj7zjKsK5Xf/Ih
+MBY027ySMB0GA1UdDgQWBBRA5OTyI+84yrCuV3/yITAWNNu8kjAOBgNVHQ8BAf8E
+BAMCAQYwDQYJKoZIhvcNAQEMBQADggIBACY7UeFNOPMyGLS0XuFlXsSUT9SnYaP4
+wM8zAQLpw6o1D/GUE3d3NZ4tVlFEbuHGLige/9rsR82XRBf34EzC4Xx8MnpmyFq2
+XFNFV1pF1AWZLy4jVe5jaN/TG3inEpQGAHUNcoTpLrxaatXeL1nHo+zSh2bbt1S1
+JKv0Q3jbSwTEb93mPmY+KfJLaHEih6D4sTNjduMNhXJEIlU/HHzp/LgV6FL6qj6j
+ITk1dImmasI5+njPtqzn59ZW/yOSLlALqbUHM/Q4X6RJpstlcHboCoWASzY9M/eV
+VHUl2qzEc4Jl6VL1XP04lQJqaTDFHApXB64ipCz5xUG3uOyfT0gA+QEEVcys+TIx
+xHWVBqB/0Y0n3bOppHKH/lmLmnp0Ft0WpWIp6zqW3IunaFnT63eROfjXy9mPX1on
+AX1daBli2MjN9LdyR75bl87yraKZk62Uy5P2EgmVtqvXO9A/EcswFi55gORngS1d
+7XB4tmBZrOFdRWOPyN9yaFvqHbgB8X7754qz41SgOAngPN5C8sLtLpvzHzW2Ntjj
+gKGLzZlkD8Kqq7HK9W+eQ42EVJmzbsASZthwEPEGNTNDqJwuuhQxzhB/HIbjj9LV
++Hfsm6vxL2PZQl/gZ4FkkfGXL/xuJvYz+NO1+MRiqzFRJQJ6+N1rZdVtTTDIZbpo
+FGWsJwt0ivKH
+-----END CERTIFICATE-----
+
+# Issuer: CN=TrustAsia Global Root CA G4 O=TrustAsia Technologies, Inc.
+# Subject: CN=TrustAsia Global Root CA G4 O=TrustAsia Technologies, Inc.
+# Label: "TrustAsia Global Root CA G4"
+# Serial: 451799571007117016466790293371524403291602933463
+# MD5 Fingerprint: 54:dd:b2:d7:5f:d8:3e:ed:7c:e0:0b:2e:cc:ed:eb:eb
+# SHA1 Fingerprint: 57:73:a5:61:5d:80:b2:e6:ac:38:82:fc:68:07:31:ac:9f:b5:92:5a
+# SHA256 Fingerprint: be:4b:56:cb:50:56:c0:13:6a:52:6d:f4:44:50:8d:aa:36:a0:b5:4f:42:e4:ac:38:f7:2a:f4:70:e4:79:65:4c
+-----BEGIN CERTIFICATE-----
+MIICVTCCAdygAwIBAgIUTyNkuI6XY57GU4HBdk7LKnQV1tcwCgYIKoZIzj0EAwMw
+WjELMAkGA1UEBhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dpZXMs
+IEluYy4xJDAiBgNVBAMMG1RydXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHNDAeFw0y
+MTA1MjAwMjEwMjJaFw00NjA1MTkwMjEwMjJaMFoxCzAJBgNVBAYTAkNOMSUwIwYD
+VQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMuMSQwIgYDVQQDDBtUcnVz
+dEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzQwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAATx
+s8045CVD5d4ZCbuBeaIVXxVjAd7Cq92zphtnS4CDr5nLrBfbK5bKfFJV4hrhPVbw
+LxYI+hW8m7tH5j/uqOFMjPXTNvk4XatwmkcN4oFBButJ+bAp3TPsUKV/eSm4IJij
+YzBhMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUpbtKl86zK3+kMd6Xg1mD
+pm9xy94wHQYDVR0OBBYEFKW7SpfOsyt/pDHel4NZg6ZvccveMA4GA1UdDwEB/wQE
+AwIBBjAKBggqhkjOPQQDAwNnADBkAjBe8usGzEkxn0AAbbd+NvBNEU/zy4k6LHiR
+UKNbwMp1JvK/kF0LgoxgKJ/GcJpo5PECMFxYDlZ2z1jD1xCMuo6u47xkdUfFVZDj
+/bpV6wfEU6s3qe4hsiFbYI89MvHVI5TWWA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=CommScope Public Trust ECC Root-01 O=CommScope
+# Subject: CN=CommScope Public Trust ECC Root-01 O=CommScope
+# Label: "CommScope Public Trust ECC Root-01"
+# Serial: 385011430473757362783587124273108818652468453534
+# MD5 Fingerprint: 3a:40:a7:fc:03:8c:9c:38:79:2f:3a:a2:6c:b6:0a:16
+# SHA1 Fingerprint: 07:86:c0:d8:dd:8e:c0:80:98:06:98:d0:58:7a:ef:de:a6:cc:a2:5d
+# SHA256 Fingerprint: 11:43:7c:da:7b:b4:5e:41:36:5f:45:b3:9a:38:98:6b:0d:e0:0d:ef:34:8e:0c:7b:b0:87:36:33:80:0b:c3:8b
+-----BEGIN CERTIFICATE-----
+MIICHTCCAaOgAwIBAgIUQ3CCd89NXTTxyq4yLzf39H91oJ4wCgYIKoZIzj0EAwMw
+TjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29t
+bVNjb3BlIFB1YmxpYyBUcnVzdCBFQ0MgUm9vdC0wMTAeFw0yMTA0MjgxNzM1NDNa
+Fw00NjA0MjgxNzM1NDJaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21tU2Nv
+cGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgRUNDIFJvb3QtMDEw
+djAQBgcqhkjOPQIBBgUrgQQAIgNiAARLNumuV16ocNfQj3Rid8NeeqrltqLxeP0C
+flfdkXmcbLlSiFS8LwS+uM32ENEp7LXQoMPwiXAZu1FlxUOcw5tjnSCDPgYLpkJE
+hRGnSjot6dZoL0hOUysHP029uax3OVejQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYD
+VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBSOB2LAUN3GGQYARnQE9/OufXVNMDAKBggq
+hkjOPQQDAwNoADBlAjEAnDPfQeMjqEI2Jpc1XHvr20v4qotzVRVcrHgpD7oh2MSg
+2NED3W3ROT3Ek2DS43KyAjB8xX6I01D1HiXo+k515liWpDVfG2XqYZpwI7UNo5uS
+Um9poIyNStDuiw7LR47QjRE=
+-----END CERTIFICATE-----
+
+# Issuer: CN=CommScope Public Trust ECC Root-02 O=CommScope
+# Subject: CN=CommScope Public Trust ECC Root-02 O=CommScope
+# Label: "CommScope Public Trust ECC Root-02"
+# Serial: 234015080301808452132356021271193974922492992893
+# MD5 Fingerprint: 59:b0:44:d5:65:4d:b8:5c:55:19:92:02:b6:d1:94:b2
+# SHA1 Fingerprint: 3c:3f:ef:57:0f:fe:65:93:86:9e:a0:fe:b0:f6:ed:8e:d1:13:c7:e5
+# SHA256 Fingerprint: 2f:fb:7f:81:3b:bb:b3:c8:9a:b4:e8:16:2d:0f:16:d7:15:09:a8:30:cc:9d:73:c2:62:e5:14:08:75:d1:ad:4a
+-----BEGIN CERTIFICATE-----
+MIICHDCCAaOgAwIBAgIUKP2ZYEFHpgE6yhR7H+/5aAiDXX0wCgYIKoZIzj0EAwMw
+TjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29t
+bVNjb3BlIFB1YmxpYyBUcnVzdCBFQ0MgUm9vdC0wMjAeFw0yMTA0MjgxNzQ0NTRa
+Fw00NjA0MjgxNzQ0NTNaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21tU2Nv
+cGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgRUNDIFJvb3QtMDIw
+djAQBgcqhkjOPQIBBgUrgQQAIgNiAAR4MIHoYx7l63FRD/cHB8o5mXxO1Q/MMDAL
+j2aTPs+9xYa9+bG3tD60B8jzljHz7aRP+KNOjSkVWLjVb3/ubCK1sK9IRQq9qEmU
+v4RDsNuESgMjGWdqb8FuvAY5N9GIIvejQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYD
+VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBTmGHX/72DehKT1RsfeSlXjMjZ59TAKBggq
+hkjOPQQDAwNnADBkAjAmc0l6tqvmSfR9Uj/UQQSugEODZXW5hYA4O9Zv5JOGq4/n
+ich/m35rChJVYaoR4HkCMHfoMXGsPHED1oQmHhS48zs73u1Z/GtMMH9ZzkXpc2AV
+mkzw5l4lIhVtwodZ0LKOag==
+-----END CERTIFICATE-----
+
+# Issuer: CN=CommScope Public Trust RSA Root-01 O=CommScope
+# Subject: CN=CommScope Public Trust RSA Root-01 O=CommScope
+# Label: "CommScope Public Trust RSA Root-01"
+# Serial: 354030733275608256394402989253558293562031411421
+# MD5 Fingerprint: 0e:b4:15:bc:87:63:5d:5d:02:73:d4:26:38:68:73:d8
+# SHA1 Fingerprint: 6d:0a:5f:f7:b4:23:06:b4:85:b3:b7:97:64:fc:ac:75:f5:33:f2:93
+# SHA256 Fingerprint: 02:bd:f9:6e:2a:45:dd:9b:f1:8f:c7:e1:db:df:21:a0:37:9b:a3:c9:c2:61:03:44:cf:d8:d6:06:fe:c1:ed:81
+-----BEGIN CERTIFICATE-----
+MIIFbDCCA1SgAwIBAgIUPgNJgXUWdDGOTKvVxZAplsU5EN0wDQYJKoZIhvcNAQEL
+BQAwTjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwi
+Q29tbVNjb3BlIFB1YmxpYyBUcnVzdCBSU0EgUm9vdC0wMTAeFw0yMTA0MjgxNjQ1
+NTRaFw00NjA0MjgxNjQ1NTNaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21t
+U2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgUlNBIFJvb3Qt
+MDEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCwSGWjDR1C45FtnYSk
+YZYSwu3D2iM0GXb26v1VWvZVAVMP8syMl0+5UMuzAURWlv2bKOx7dAvnQmtVzslh
+suitQDy6uUEKBU8bJoWPQ7VAtYXR1HHcg0Hz9kXHgKKEUJdGzqAMxGBWBB0HW0al
+DrJLpA6lfO741GIDuZNqihS4cPgugkY4Iw50x2tBt9Apo52AsH53k2NC+zSDO3Oj
+WiE260f6GBfZumbCk6SP/F2krfxQapWsvCQz0b2If4b19bJzKo98rwjyGpg/qYFl
+P8GMicWWMJoKz/TUyDTtnS+8jTiGU+6Xn6myY5QXjQ/cZip8UlF1y5mO6D1cv547
+KI2DAg+pn3LiLCuz3GaXAEDQpFSOm117RTYm1nJD68/A6g3czhLmfTifBSeolz7p
+UcZsBSjBAg/pGG3svZwG1KdJ9FQFa2ww8esD1eo9anbCyxooSU1/ZOD6K9pzg4H/
+kQO9lLvkuI6cMmPNn7togbGEW682v3fuHX/3SZtS7NJ3Wn2RnU3COS3kuoL4b/JO
+Hg9O5j9ZpSPcPYeoKFgo0fEbNttPxP/hjFtyjMcmAyejOQoBqsCyMWCDIqFPEgkB
+Ea801M/XrmLTBQe0MXXgDW1XT2mH+VepuhX2yFJtocucH+X8eKg1mp9BFM6ltM6U
+CBwJrVbl2rZJmkrqYxhTnCwuwwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4G
+A1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUN12mmnQywsL5x6YVEFm45P3luG0wDQYJ
+KoZIhvcNAQELBQADggIBAK+nz97/4L1CjU3lIpbfaOp9TSp90K09FlxD533Ahuh6
+NWPxzIHIxgvoLlI1pKZJkGNRrDSsBTtXAOnTYtPZKdVUvhwQkZyybf5Z/Xn36lbQ
+nmhUQo8mUuJM3y+Xpi/SB5io82BdS5pYV4jvguX6r2yBS5KPQJqTRlnLX3gWsWc+
+QgvfKNmwrZggvkN80V4aCRckjXtdlemrwWCrWxhkgPut4AZ9HcpZuPN4KWfGVh2v
+trV0KnahP/t1MJ+UXjulYPPLXAziDslg+MkfFoom3ecnf+slpoq9uC02EJqxWE2a
+aE9gVOX2RhOOiKy8IUISrcZKiX2bwdgt6ZYD9KJ0DLwAHb/WNyVntHKLr4W96ioD
+j8z7PEQkguIBpQtZtjSNMgsSDesnwv1B10A8ckYpwIzqug/xBpMu95yo9GA+o/E4
+Xo4TwbM6l4c/ksp4qRyv0LAbJh6+cOx69TOY6lz/KwsETkPdY34Op054A5U+1C0w
+lREQKC6/oAI+/15Z0wUOlV9TRe9rh9VIzRamloPh37MG88EU26fsHItdkJANclHn
+YfkUyq+Dj7+vsQpZXdxc1+SWrVtgHdqul7I52Qb1dgAT+GhMIbA1xNxVssnBQVoc
+icCMb3SgazNNtQEo/a2tiRc7ppqEvOuM6sRxJKi6KfkIsidWNTJf6jn7MZrVGczw
+-----END CERTIFICATE-----
+
+# Issuer: CN=CommScope Public Trust RSA Root-02 O=CommScope
+# Subject: CN=CommScope Public Trust RSA Root-02 O=CommScope
+# Label: "CommScope Public Trust RSA Root-02"
+# Serial: 480062499834624527752716769107743131258796508494
+# MD5 Fingerprint: e1:29:f9:62:7b:76:e2:96:6d:f3:d4:d7:0f:ae:1f:aa
+# SHA1 Fingerprint: ea:b0:e2:52:1b:89:93:4c:11:68:f2:d8:9a:ac:22:4c:a3:8a:57:ae
+# SHA256 Fingerprint: ff:e9:43:d7:93:42:4b:4f:7c:44:0c:1c:3d:64:8d:53:63:f3:4b:82:dc:87:aa:7a:9f:11:8f:c5:de:e1:01:f1
+-----BEGIN CERTIFICATE-----
+MIIFbDCCA1SgAwIBAgIUVBa/O345lXGN0aoApYYNK496BU4wDQYJKoZIhvcNAQEL
+BQAwTjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwi
+Q29tbVNjb3BlIFB1YmxpYyBUcnVzdCBSU0EgUm9vdC0wMjAeFw0yMTA0MjgxNzE2
+NDNaFw00NjA0MjgxNzE2NDJaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21t
+U2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgUlNBIFJvb3Qt
+MDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDh+g77aAASyE3VrCLE
+NQE7xVTlWXZjpX/rwcRqmL0yjReA61260WI9JSMZNRTpf4mnG2I81lDnNJUDMrG0
+kyI9p+Kx7eZ7Ti6Hmw0zdQreqjXnfuU2mKKuJZ6VszKWpCtYHu8//mI0SFHRtI1C
+rWDaSWqVcN3SAOLMV2MCe5bdSZdbkk6V0/nLKR8YSvgBKtJjCW4k6YnS5cciTNxz
+hkcAqg2Ijq6FfUrpuzNPDlJwnZXjfG2WWy09X6GDRl224yW4fKcZgBzqZUPckXk2
+LHR88mcGyYnJ27/aaL8j7dxrrSiDeS/sOKUNNwFnJ5rpM9kzXzehxfCrPfp4sOcs
+n/Y+n2Dg70jpkEUeBVF4GiwSLFworA2iI540jwXmojPOEXcT1A6kHkIfhs1w/tku
+FT0du7jyU1fbzMZ0KZwYszZ1OC4PVKH4kh+Jlk+71O6d6Ts2QrUKOyrUZHk2EOH5
+kQMreyBUzQ0ZGshBMjTRsJnhkB4BQDa1t/qp5Xd1pCKBXbCL5CcSD1SIxtuFdOa3
+wNemKfrb3vOTlycEVS8KbzfFPROvCgCpLIscgSjX74Yxqa7ybrjKaixUR9gqiC6v
+wQcQeKwRoi9C8DfF8rhW3Q5iLc4tVn5V8qdE9isy9COoR+jUKgF4z2rDN6ieZdIs
+5fq6M8EGRPbmz6UNp2YINIos8wIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4G
+A1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUR9DnsSL/nSz12Vdgs7GxcJXvYXowDQYJ
+KoZIhvcNAQELBQADggIBAIZpsU0v6Z9PIpNojuQhmaPORVMbc0RTAIFhzTHjCLqB
+KCh6krm2qMhDnscTJk3C2OVVnJJdUNjCK9v+5qiXz1I6JMNlZFxHMaNlNRPDk7n3
++VGXu6TwYofF1gbTl4MgqX67tiHCpQ2EAOHyJxCDut0DgdXdaMNmEMjRdrSzbyme
+APnCKfWxkxlSaRosTKCL4BWaMS/TiJVZbuXEs1DIFAhKm4sTg7GkcrI7djNB3Nyq
+pgdvHSQSn8h2vS/ZjvQs7rfSOBAkNlEv41xdgSGn2rtO/+YHqP65DSdsu3BaVXoT
+6fEqSWnHX4dXTEN5bTpl6TBcQe7rd6VzEojov32u5cSoHw2OHG1QAk8mGEPej1WF
+sQs3BWDJVTkSBKEqz3EWnzZRSb9wO55nnPt7eck5HHisd5FUmrh1CoFSl+NmYWvt
+PjgelmFV4ZFUjO2MJB+ByRCac5krFk5yAD9UG/iNuovnFNa2RU9g7Jauwy8CTl2d
+lklyALKrdVwPaFsdZcJfMw8eD/A7hvWwTruc9+olBdytoptLFwG+Qt81IR2tq670
+v64fG9PiO/yzcnMcmyiQiRM9HcEARwmWmjgb3bHPDcK0RPOWlc4yOo80nOAXx17O
+rg3bhzjlP1v9mxnhMUF6cKojawHhRUzNlM47ni3niAIi9G7oyOzWPPO5std3eqx7
+-----END CERTIFICATE-----
+
+# Issuer: CN=Telekom Security TLS ECC Root 2020 O=Deutsche Telekom Security GmbH
+# Subject: CN=Telekom Security TLS ECC Root 2020 O=Deutsche Telekom Security GmbH
+# Label: "Telekom Security TLS ECC Root 2020"
+# Serial: 72082518505882327255703894282316633856
+# MD5 Fingerprint: c1:ab:fe:6a:10:2c:03:8d:bc:1c:22:32:c0:85:a7:fd
+# SHA1 Fingerprint: c0:f8:96:c5:a9:3b:01:06:21:07:da:18:42:48:bc:e9:9d:88:d5:ec
+# SHA256 Fingerprint: 57:8a:f4:de:d0:85:3f:4e:59:98:db:4a:ea:f9:cb:ea:8d:94:5f:60:b6:20:a3:8d:1a:3c:13:b2:bc:7b:a8:e1
+-----BEGIN CERTIFICATE-----
+MIICQjCCAcmgAwIBAgIQNjqWjMlcsljN0AFdxeVXADAKBggqhkjOPQQDAzBjMQsw
+CQYDVQQGEwJERTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0eSBH
+bWJIMSswKQYDVQQDDCJUZWxla29tIFNlY3VyaXR5IFRMUyBFQ0MgUm9vdCAyMDIw
+MB4XDTIwMDgyNTA3NDgyMFoXDTQ1MDgyNTIzNTk1OVowYzELMAkGA1UEBhMCREUx
+JzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJpdHkgR21iSDErMCkGA1UE
+AwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgRUNDIFJvb3QgMjAyMDB2MBAGByqGSM49
+AgEGBSuBBAAiA2IABM6//leov9Wq9xCazbzREaK9Z0LMkOsVGJDZos0MKiXrPk/O
+tdKPD/M12kOLAoC+b1EkHQ9rK8qfwm9QMuU3ILYg/4gND21Ju9sGpIeQkpT0CdDP
+f8iAC8GXs7s1J8nCG6NCMEAwHQYDVR0OBBYEFONyzG6VmUex5rNhTNHLq+O6zd6f
+MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMAoGCCqGSM49BAMDA2cA
+MGQCMHVSi7ekEE+uShCLsoRbQuHmKjYC2qBuGT8lv9pZMo7k+5Dck2TOrbRBR2Di
+z6fLHgIwN0GMZt9Ba9aDAEH9L1r3ULRn0SyocddDypwnJJGDSA3PzfdUga/sf+Rn
+27iQ7t0l
+-----END CERTIFICATE-----
+
+# Issuer: CN=Telekom Security TLS RSA Root 2023 O=Deutsche Telekom Security GmbH
+# Subject: CN=Telekom Security TLS RSA Root 2023 O=Deutsche Telekom Security GmbH
+# Label: "Telekom Security TLS RSA Root 2023"
+# Serial: 44676229530606711399881795178081572759
+# MD5 Fingerprint: bf:5b:eb:54:40:cd:48:71:c4:20:8d:7d:de:0a:42:f2
+# SHA1 Fingerprint: 54:d3:ac:b3:bd:57:56:f6:85:9d:ce:e5:c3:21:e2:d4:ad:83:d0:93
+# SHA256 Fingerprint: ef:c6:5c:ad:bb:59:ad:b6:ef:e8:4d:a2:23:11:b3:56:24:b7:1b:3b:1e:a0:da:8b:66:55:17:4e:c8:97:86:46
+-----BEGIN CERTIFICATE-----
+MIIFszCCA5ugAwIBAgIQIZxULej27HF3+k7ow3BXlzANBgkqhkiG9w0BAQwFADBj
+MQswCQYDVQQGEwJERTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0
+eSBHbWJIMSswKQYDVQQDDCJUZWxla29tIFNlY3VyaXR5IFRMUyBSU0EgUm9vdCAy
+MDIzMB4XDTIzMDMyODEyMTY0NVoXDTQ4MDMyNzIzNTk1OVowYzELMAkGA1UEBhMC
+REUxJzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJpdHkgR21iSDErMCkG
+A1UEAwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgUlNBIFJvb3QgMjAyMzCCAiIwDQYJ
+KoZIhvcNAQEBBQADggIPADCCAgoCggIBAO01oYGA88tKaVvC+1GDrib94W7zgRJ9
+cUD/h3VCKSHtgVIs3xLBGYSJwb3FKNXVS2xE1kzbB5ZKVXrKNoIENqil/Cf2SfHV
+cp6R+SPWcHu79ZvB7JPPGeplfohwoHP89v+1VmLhc2o0mD6CuKyVU/QBoCcHcqMA
+U6DksquDOFczJZSfvkgdmOGjup5czQRxUX11eKvzWarE4GC+j4NSuHUaQTXtvPM6
+Y+mpFEXX5lLRbtLevOP1Czvm4MS9Q2QTps70mDdsipWol8hHD/BeEIvnHRz+sTug
+BTNoBUGCwQMrAcjnj02r6LX2zWtEtefdi+zqJbQAIldNsLGyMcEWzv/9FIS3R/qy
+8XDe24tsNlikfLMR0cN3f1+2JeANxdKz+bi4d9s3cXFH42AYTyS2dTd4uaNir73J
+co4vzLuu2+QVUhkHM/tqty1LkCiCc/4YizWN26cEar7qwU02OxY2kTLvtkCJkUPg
+8qKrBC7m8kwOFjQgrIfBLX7JZkcXFBGk8/ehJImr2BrIoVyxo/eMbcgByU/J7MT8
+rFEz0ciD0cmfHdRHNCk+y7AO+oMLKFjlKdw/fKifybYKu6boRhYPluV75Gp6SG12
+mAWl3G0eQh5C2hrgUve1g8Aae3g1LDj1H/1Joy7SWWO/gLCMk3PLNaaZlSJhZQNg
++y+TS/qanIA7AgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUtqeX
+gj10hZv3PJ+TmpV5dVKMbUcwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBS2
+p5eCPXSFm/c8n5OalXl1UoxtRzANBgkqhkiG9w0BAQwFAAOCAgEAqMxhpr51nhVQ
+pGv7qHBFfLp+sVr8WyP6Cnf4mHGCDG3gXkaqk/QeoMPhk9tLrbKmXauw1GLLXrtm
+9S3ul0A8Yute1hTWjOKWi0FpkzXmuZlrYrShF2Y0pmtjxrlO8iLpWA1WQdH6DErw
+M807u20hOq6OcrXDSvvpfeWxm4bu4uB9tPcy/SKE8YXJN3nptT+/XOR0so8RYgDd
+GGah2XsjX/GO1WfoVNpbOms2b/mBsTNHM3dA+VKq3dSDz4V4mZqTuXNnQkYRIer+
+CqkbGmVps4+uFrb2S1ayLfmlyOw7YqPta9BO1UAJpB+Y1zqlklkg5LB9zVtzaL1t
+xKITDmcZuI1CfmwMmm6gJC3VRRvcxAIU/oVbZZfKTpBQCHpCNfnqwmbU+AGuHrS+
+w6jv/naaoqYfRvaE7fzbzsQCzndILIyy7MMAo+wsVRjBfhnu4S/yrYObnqsZ38aK
+L4x35bcF7DvB7L6Gs4a8wPfc5+pbrrLMtTWGS9DiP7bY+A4A7l3j941Y/8+LN+lj
+X273CXE2whJdV/LItM3z7gLfEdxquVeEHVlNjM7IDiPCtyaaEBRx/pOyiriA8A4Q
+ntOoUAw3gi/q4Iqd4Sw5/7W0cwDk90imc6y/st53BIe0o82bNSQ3+pCTE4FCxpgm
+dTdmQRCsu/WU48IxK63nI1bMNSWSs1A=
+-----END CERTIFICATE-----
diff --git a/llm/Lib/site-packages/certifi/core.py b/llm/Lib/site-packages/certifi/core.py
new file mode 100644
index 0000000000000000000000000000000000000000..91f538bb1fd2ce62632e475053dc000e7833d11b
--- /dev/null
+++ b/llm/Lib/site-packages/certifi/core.py
@@ -0,0 +1,114 @@
+"""
+certifi.py
+~~~~~~~~~~
+
+This module returns the installation location of cacert.pem or its contents.
+"""
+import sys
+import atexit
+
+def exit_cacert_ctx() -> None:
+    _CACERT_CTX.__exit__(None, None, None)  # type: ignore[union-attr]
+
+
+if sys.version_info >= (3, 11):
+
+    from importlib.resources import as_file, files
+
+    _CACERT_CTX = None
+    _CACERT_PATH = None
+
+    def where() -> str:
+        # This is slightly terrible, but we want to delay extracting the file
+        # in cases where we're inside of a zipimport situation until someone
+        # actually calls where(), but we don't want to re-extract the file
+        # on every call of where(), so we'll do it once then store it in a
+        # global variable.
+        global _CACERT_CTX
+        global _CACERT_PATH
+        if _CACERT_PATH is None:
+            # This is slightly janky, the importlib.resources API wants you to
+            # manage the cleanup of this file, so it doesn't actually return a
+            # path, it returns a context manager that will give you the path
+            # when you enter it and will do any cleanup when you leave it. In
+            # the common case of not needing a temporary file, it will just
+            # return the file system location and the __exit__() is a no-op.
+            #
+            # We also have to hold onto the actual context manager, because
+            # it will do the cleanup whenever it gets garbage collected, so
+            # we will also store that at the global level as well.
+            _CACERT_CTX = as_file(files("certifi").joinpath("cacert.pem"))
+            _CACERT_PATH = str(_CACERT_CTX.__enter__())
+            atexit.register(exit_cacert_ctx)
+
+        return _CACERT_PATH
+
+    def contents() -> str:
+        return files("certifi").joinpath("cacert.pem").read_text(encoding="ascii")
+
+elif sys.version_info >= (3, 7):
+
+    from importlib.resources import path as get_path, read_text
+
+    _CACERT_CTX = None
+    _CACERT_PATH = None
+
+    def where() -> str:
+        # This is slightly terrible, but we want to delay extracting the
+        # file in cases where we're inside of a zipimport situation until
+        # someone actually calls where(), but we don't want to re-extract
+        # the file on every call of where(), so we'll do it once then store
+        # it in a global variable.
+        global _CACERT_CTX
+        global _CACERT_PATH
+        if _CACERT_PATH is None:
+            # This is slightly janky, the importlib.resources API wants you
+            # to manage the cleanup of this file, so it doesn't actually
+            # return a path, it returns a context manager that will give
+            # you the path when you enter it and will do any cleanup when
+            # you leave it. In the common case of not needing a temporary
+            # file, it will just return the file system location and the
+            # __exit__() is a no-op.
+            #
+            # We also have to hold onto the actual context manager, because
+            # it will do the cleanup whenever it gets garbage collected, so
+            # we will also store that at the global level as well.
+            _CACERT_CTX = get_path("certifi", "cacert.pem")
+            _CACERT_PATH = str(_CACERT_CTX.__enter__())
+            atexit.register(exit_cacert_ctx)
+
+        return _CACERT_PATH
+
+    def contents() -> str:
+        return read_text("certifi", "cacert.pem", encoding="ascii")
+
+else:
+    import os
+    import types
+    from typing import Union
+
+    Package = Union[types.ModuleType, str]
+    Resource = Union[str, "os.PathLike"]
+
+    # This fallback will work for Python versions prior to 3.7 that lack the
+    # importlib.resources module but relies on the existing `where` function
+    # so won't address issues with environments like PyOxidizer that don't set
+    # __file__ on modules.
+    def read_text(
+        package: Package,
+        resource: Resource,
+        encoding: str = 'utf-8',
+        errors: str = 'strict'
+    ) -> str:
+        with open(where(), encoding=encoding) as data:
+            return data.read()
+
+    # If we don't have importlib.resources, then we will just do the old logic
+    # of assuming we're on the filesystem and munge the path directly.
+    def where() -> str:
+        f = os.path.dirname(__file__)
+
+        return os.path.join(f, "cacert.pem")
+
+    def contents() -> str:
+        return read_text("certifi", "cacert.pem", encoding="ascii")
diff --git a/llm/Lib/site-packages/certifi/py.typed b/llm/Lib/site-packages/certifi/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/INSTALLER b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/LICENSE b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..6da2297882e46bda0a983f57e49b46952c4f8c9e
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 TAHRI Ahmed R.
+
+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
+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.
\ No newline at end of file
diff --git a/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/METADATA b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..1da9ba95f23f97c92b3f7060daa46d8736881a35
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/METADATA
@@ -0,0 +1,683 @@
+Metadata-Version: 2.1
+Name: charset-normalizer
+Version: 3.3.2
+Summary: The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet.
+Home-page: https://github.com/Ousret/charset_normalizer
+Author: Ahmed TAHRI
+Author-email: ahmed.tahri@cloudnursery.dev
+License: MIT
+Project-URL: Bug Reports, https://github.com/Ousret/charset_normalizer/issues
+Project-URL: Documentation, https://charset-normalizer.readthedocs.io/en/latest
+Keywords: encoding,charset,charset-detector,detector,normalization,unicode,chardet,detect
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.7.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: unicode_backport
+
+<h1 align="center">Charset Detection, for Everyone 👋</h1>
+
+<p align="center">
+  <sup>The Real First Universal Charset Detector</sup><br>
+  <a href="https://pypi.org/project/charset-normalizer">
+    <img src="https://img.shields.io/pypi/pyversions/charset_normalizer.svg?orange=blue" />
+  </a>
+  <a href="https://pepy.tech/project/charset-normalizer/">
+    <img alt="Download Count Total" src="https://static.pepy.tech/badge/charset-normalizer/month" />
+  </a>
+  <a href="https://bestpractices.coreinfrastructure.org/projects/7297">
+    <img src="https://bestpractices.coreinfrastructure.org/projects/7297/badge">
+  </a>
+</p>
+<p align="center">
+  <sup><i>Featured Packages</i></sup><br>
+  <a href="https://github.com/jawah/niquests">
+   <img alt="Static Badge" src="https://img.shields.io/badge/Niquests-HTTP_1.1%2C%202%2C_and_3_Client-cyan">
+  </a>
+  <a href="https://github.com/jawah/wassima">
+   <img alt="Static Badge" src="https://img.shields.io/badge/Wassima-Certifi_Killer-cyan">
+  </a>
+</p>
+<p align="center">
+  <sup><i>In other language (unofficial port - by the community)</i></sup><br>
+  <a href="https://github.com/nickspring/charset-normalizer-rs">
+   <img alt="Static Badge" src="https://img.shields.io/badge/Rust-red">
+  </a>
+</p>
+
+> A library that helps you read text from an unknown charset encoding.<br /> Motivated by `chardet`,
+> I'm trying to resolve the issue by taking a new approach.
+> All IANA character set names for which the Python core library provides codecs are supported.
+
+<p align="center">
+  >>>>> <a href="https://charsetnormalizerweb.ousret.now.sh" target="_blank">👉 Try Me Online Now, Then Adopt Me 👈 </a> <<<<<
+</p>
+
+This project offers you an alternative to **Universal Charset Encoding Detector**, also known as **Chardet**.
+
+| Feature                                          | [Chardet](https://github.com/chardet/chardet) |                                         Charset Normalizer                                         | [cChardet](https://github.com/PyYoshi/cChardet) |
+|--------------------------------------------------|:---------------------------------------------:|:--------------------------------------------------------------------------------------------------:|:-----------------------------------------------:|
+| `Fast`                                           |                       ❌                       |                                                 ✅                                                  |                        ✅                        |
+| `Universal**`                                    |                       ❌                       |                                                 ✅                                                  |                        ❌                        |
+| `Reliable` **without** distinguishable standards |                       ❌                       |                                                 ✅                                                  |                        ✅                        |
+| `Reliable` **with** distinguishable standards    |                       ✅                       |                                                 ✅                                                  |                        ✅                        |
+| `License`                                        |           LGPL-2.1<br>_restrictive_           |                                                MIT                                                 |            MPL-1.1<br>_restrictive_             |
+| `Native Python`                                  |                       ✅                       |                                                 ✅                                                  |                        ❌                        |
+| `Detect spoken language`                         |                       ❌                       |                                                 ✅                                                  |                       N/A                       |
+| `UnicodeDecodeError Safety`                      |                       ❌                       |                                                 ✅                                                  |                        ❌                        |
+| `Whl Size (min)`                                 |                   193.6 kB                    |                                               42 kB                                                |                     ~200 kB                     |
+| `Supported Encoding`                             |                      33                       | 🎉 [99](https://charset-normalizer.readthedocs.io/en/latest/user/support.html#supported-encodings) |                       40                        |
+
+<p align="center">
+<img src="https://i.imgflip.com/373iay.gif" alt="Reading Normalized Text" width="226"/><img src="https://media.tenor.com/images/c0180f70732a18b4965448d33adba3d0/tenor.gif" alt="Cat Reading Text" width="200"/>
+</p>
+
+*\*\* : They are clearly using specific code for a specific encoding even if covering most of used one*<br> 
+Did you got there because of the logs? See [https://charset-normalizer.readthedocs.io/en/latest/user/miscellaneous.html](https://charset-normalizer.readthedocs.io/en/latest/user/miscellaneous.html)
+
+## ⚡ Performance
+
+This package offer better performance than its counterpart Chardet. Here are some numbers.
+
+| Package                                       | Accuracy | Mean per file (ms) | File per sec (est) |
+|-----------------------------------------------|:--------:|:------------------:|:------------------:|
+| [chardet](https://github.com/chardet/chardet) |   86 %   |       200 ms       |     5 file/sec     |
+| charset-normalizer                            | **98 %** |     **10 ms**      |    100 file/sec    |
+
+| Package                                       | 99th percentile | 95th percentile | 50th percentile |
+|-----------------------------------------------|:---------------:|:---------------:|:---------------:|
+| [chardet](https://github.com/chardet/chardet) |     1200 ms     |     287 ms      |      23 ms      |
+| charset-normalizer                            |     100 ms      |      50 ms      |      5 ms       |
+
+Chardet's performance on larger file (1MB+) are very poor. Expect huge difference on large payload.
+
+> Stats are generated using 400+ files using default parameters. More details on used files, see GHA workflows.
+> And yes, these results might change at any time. The dataset can be updated to include more files.
+> The actual delays heavily depends on your CPU capabilities. The factors should remain the same.
+> Keep in mind that the stats are generous and that Chardet accuracy vs our is measured using Chardet initial capability
+> (eg. Supported Encoding) Challenge-them if you want.
+
+## ✨ Installation
+
+Using pip:
+
+```sh
+pip install charset-normalizer -U
+```
+
+## 🚀 Basic Usage
+
+### CLI
+This package comes with a CLI.
+
+```
+usage: normalizer [-h] [-v] [-a] [-n] [-m] [-r] [-f] [-t THRESHOLD]
+                  file [file ...]
+
+The Real First Universal Charset Detector. Discover originating encoding used
+on text file. Normalize text to unicode.
+
+positional arguments:
+  files                 File(s) to be analysed
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -v, --verbose         Display complementary information about file if any.
+                        Stdout will contain logs about the detection process.
+  -a, --with-alternative
+                        Output complementary possibilities if any. Top-level
+                        JSON WILL be a list.
+  -n, --normalize       Permit to normalize input file. If not set, program
+                        does not write anything.
+  -m, --minimal         Only output the charset detected to STDOUT. Disabling
+                        JSON output.
+  -r, --replace         Replace file when trying to normalize it instead of
+                        creating a new one.
+  -f, --force           Replace file without asking if you are sure, use this
+                        flag with caution.
+  -t THRESHOLD, --threshold THRESHOLD
+                        Define a custom maximum amount of chaos allowed in
+                        decoded content. 0. <= chaos <= 1.
+  --version             Show version information and exit.
+```
+
+```bash
+normalizer ./data/sample.1.fr.srt
+```
+
+or
+
+```bash
+python -m charset_normalizer ./data/sample.1.fr.srt
+```
+
+🎉 Since version 1.4.0 the CLI produce easily usable stdout result in JSON format.
+
+```json
+{
+    "path": "/home/default/projects/charset_normalizer/data/sample.1.fr.srt",
+    "encoding": "cp1252",
+    "encoding_aliases": [
+        "1252",
+        "windows_1252"
+    ],
+    "alternative_encodings": [
+        "cp1254",
+        "cp1256",
+        "cp1258",
+        "iso8859_14",
+        "iso8859_15",
+        "iso8859_16",
+        "iso8859_3",
+        "iso8859_9",
+        "latin_1",
+        "mbcs"
+    ],
+    "language": "French",
+    "alphabets": [
+        "Basic Latin",
+        "Latin-1 Supplement"
+    ],
+    "has_sig_or_bom": false,
+    "chaos": 0.149,
+    "coherence": 97.152,
+    "unicode_path": null,
+    "is_preferred": true
+}
+```
+
+### Python
+*Just print out normalized text*
+```python
+from charset_normalizer import from_path
+
+results = from_path('./my_subtitle.srt')
+
+print(str(results.best()))
+```
+
+*Upgrade your code without effort*
+```python
+from charset_normalizer import detect
+```
+
+The above code will behave the same as **chardet**. We ensure that we offer the best (reasonable) BC result possible.
+
+See the docs for advanced usage : [readthedocs.io](https://charset-normalizer.readthedocs.io/en/latest/)
+
+## 😇 Why
+
+When I started using Chardet, I noticed that it was not suited to my expectations, and I wanted to propose a
+reliable alternative using a completely different method. Also! I never back down on a good challenge!
+
+I **don't care** about the **originating charset** encoding, because **two different tables** can
+produce **two identical rendered string.**
+What I want is to get readable text, the best I can. 
+
+In a way, **I'm brute forcing text decoding.** How cool is that ? 😎
+
+Don't confuse package **ftfy** with charset-normalizer or chardet. ftfy goal is to repair unicode string whereas charset-normalizer to convert raw file in unknown encoding to unicode.
+
+## 🍰 How
+
+  - Discard all charset encoding table that could not fit the binary content.
+  - Measure noise, or the mess once opened (by chunks) with a corresponding charset encoding.
+  - Extract matches with the lowest mess detected.
+  - Additionally, we measure coherence / probe for a language.
+
+**Wait a minute**, what is noise/mess and coherence according to **YOU ?**
+
+*Noise :* I opened hundred of text files, **written by humans**, with the wrong encoding table. **I observed**, then
+**I established** some ground rules about **what is obvious** when **it seems like** a mess.
+ I know that my interpretation of what is noise is probably incomplete, feel free to contribute in order to
+ improve or rewrite it.
+
+*Coherence :* For each language there is on earth, we have computed ranked letter appearance occurrences (the best we can). So I thought
+that intel is worth something here. So I use those records against decoded text to check if I can detect intelligent design.
+
+## ⚡ Known limitations
+
+  - Language detection is unreliable when text contains two or more languages sharing identical letters. (eg. HTML (english tags) + Turkish content (Sharing Latin characters))
+  - Every charset detector heavily depends on sufficient content. In common cases, do not bother run detection on very tiny content.
+
+## ⚠️ About Python EOLs
+
+**If you are running:**
+
+- Python >=2.7,<3.5: Unsupported
+- Python 3.5: charset-normalizer < 2.1
+- Python 3.6: charset-normalizer < 3.1
+- Python 3.7: charset-normalizer < 4.0
+
+Upgrade your Python interpreter as soon as possible.
+
+## 👤 Contributing
+
+Contributions, issues and feature requests are very much welcome.<br />
+Feel free to check [issues page](https://github.com/ousret/charset_normalizer/issues) if you want to contribute.
+
+## 📝 License
+
+Copyright © [Ahmed TAHRI @Ousret](https://github.com/Ousret).<br />
+This project is [MIT](https://github.com/Ousret/charset_normalizer/blob/master/LICENSE) licensed.
+
+Characters frequencies used in this project © 2012 [Denny Vrandečić](http://simia.net/letters/)
+
+## 💼 For Enterprise
+
+Professional support for charset-normalizer is available as part of the [Tidelift
+Subscription][1]. Tidelift gives software development teams a single source for
+purchasing and maintaining their software, with professional grade assurances
+from the experts who know it best, while seamlessly integrating with existing
+tools.
+
+[1]: https://tidelift.com/subscription/pkg/pypi-charset-normalizer?utm_source=pypi-charset-normalizer&utm_medium=readme
+
+# Changelog
+All notable changes to charset-normalizer will be documented in this file. This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## [3.3.2](https://github.com/Ousret/charset_normalizer/compare/3.3.1...3.3.2) (2023-10-31)
+
+### Fixed
+- Unintentional memory usage regression when using large payload that match several encoding (#376)
+- Regression on some detection case showcased in the documentation (#371)
+
+### Added
+- Noise (md) probe that identify malformed arabic representation due to the presence of letters in isolated form (credit to my wife)
+
+## [3.3.1](https://github.com/Ousret/charset_normalizer/compare/3.3.0...3.3.1) (2023-10-22)
+
+### Changed
+- Optional mypyc compilation upgraded to version 1.6.1 for Python >= 3.8
+- Improved the general detection reliability based on reports from the community
+
+## [3.3.0](https://github.com/Ousret/charset_normalizer/compare/3.2.0...3.3.0) (2023-09-30)
+
+### Added
+- Allow to execute the CLI (e.g. normalizer) through `python -m charset_normalizer.cli` or `python -m charset_normalizer`
+- Support for 9 forgotten encoding that are supported by Python but unlisted in `encoding.aliases` as they have no alias (#323)
+
+### Removed
+- (internal) Redundant utils.is_ascii function and unused function is_private_use_only
+- (internal) charset_normalizer.assets is moved inside charset_normalizer.constant
+
+### Changed
+- (internal) Unicode code blocks in constants are updated using the latest v15.0.0 definition to improve detection
+- Optional mypyc compilation upgraded to version 1.5.1 for Python >= 3.8
+
+### Fixed
+- Unable to properly sort CharsetMatch when both chaos/noise and coherence were close due to an unreachable condition in \_\_lt\_\_ (#350)
+
+## [3.2.0](https://github.com/Ousret/charset_normalizer/compare/3.1.0...3.2.0) (2023-06-07)
+
+### Changed
+- Typehint for function `from_path` no longer enforce `PathLike` as its first argument
+- Minor improvement over the global detection reliability
+
+### Added
+- Introduce function `is_binary` that relies on main capabilities, and optimized to detect binaries
+- Propagate `enable_fallback` argument throughout `from_bytes`, `from_path`, and `from_fp` that allow a deeper control over the detection (default True)
+- Explicit support for Python 3.12
+
+### Fixed
+- Edge case detection failure where a file would contain 'very-long' camel cased word (Issue #289)
+
+## [3.1.0](https://github.com/Ousret/charset_normalizer/compare/3.0.1...3.1.0) (2023-03-06)
+
+### Added
+- Argument `should_rename_legacy` for legacy function `detect` and disregard any new arguments without errors (PR #262)
+
+### Removed
+- Support for Python 3.6 (PR #260)
+
+### Changed
+- Optional speedup provided by mypy/c 1.0.1
+
+## [3.0.1](https://github.com/Ousret/charset_normalizer/compare/3.0.0...3.0.1) (2022-11-18)
+
+### Fixed
+- Multi-bytes cutter/chunk generator did not always cut correctly (PR #233)
+
+### Changed
+- Speedup provided by mypy/c 0.990 on Python >= 3.7
+
+## [3.0.0](https://github.com/Ousret/charset_normalizer/compare/2.1.1...3.0.0) (2022-10-20)
+
+### Added
+- Extend the capability of explain=True when cp_isolation contains at most two entries (min one), will log in details of the Mess-detector results
+- Support for alternative language frequency set in charset_normalizer.assets.FREQUENCIES
+- Add parameter `language_threshold` in `from_bytes`, `from_path` and `from_fp` to adjust the minimum expected coherence ratio
+- `normalizer --version` now specify if current version provide extra speedup (meaning mypyc compilation whl)
+
+### Changed
+- Build with static metadata using 'build' frontend
+- Make the language detection stricter
+- Optional: Module `md.py` can be compiled using Mypyc to provide an extra speedup up to 4x faster than v2.1
+
+### Fixed
+- CLI with opt --normalize fail when using full path for files
+- TooManyAccentuatedPlugin induce false positive on the mess detection when too few alpha character have been fed to it
+- Sphinx warnings when generating the documentation
+
+### Removed
+- Coherence detector no longer return 'Simple English' instead return 'English'
+- Coherence detector no longer return 'Classical Chinese' instead return 'Chinese'
+- Breaking: Method `first()` and `best()` from CharsetMatch
+- UTF-7 will no longer appear as "detected" without a recognized SIG/mark (is unreliable/conflict with ASCII)
+- Breaking: Class aliases CharsetDetector, CharsetDoctor, CharsetNormalizerMatch and CharsetNormalizerMatches
+- Breaking: Top-level function `normalize`
+- Breaking: Properties `chaos_secondary_pass`, `coherence_non_latin` and `w_counter` from CharsetMatch
+- Support for the backport `unicodedata2`
+
+## [3.0.0rc1](https://github.com/Ousret/charset_normalizer/compare/3.0.0b2...3.0.0rc1) (2022-10-18)
+
+### Added
+- Extend the capability of explain=True when cp_isolation contains at most two entries (min one), will log in details of the Mess-detector results
+- Support for alternative language frequency set in charset_normalizer.assets.FREQUENCIES
+- Add parameter `language_threshold` in `from_bytes`, `from_path` and `from_fp` to adjust the minimum expected coherence ratio
+
+### Changed
+- Build with static metadata using 'build' frontend
+- Make the language detection stricter
+
+### Fixed
+- CLI with opt --normalize fail when using full path for files
+- TooManyAccentuatedPlugin induce false positive on the mess detection when too few alpha character have been fed to it
+
+### Removed
+- Coherence detector no longer return 'Simple English' instead return 'English'
+- Coherence detector no longer return 'Classical Chinese' instead return 'Chinese'
+
+## [3.0.0b2](https://github.com/Ousret/charset_normalizer/compare/3.0.0b1...3.0.0b2) (2022-08-21)
+
+### Added
+- `normalizer --version` now specify if current version provide extra speedup (meaning mypyc compilation whl)
+
+### Removed
+- Breaking: Method `first()` and `best()` from CharsetMatch
+- UTF-7 will no longer appear as "detected" without a recognized SIG/mark (is unreliable/conflict with ASCII)
+
+### Fixed
+- Sphinx warnings when generating the documentation
+
+## [3.0.0b1](https://github.com/Ousret/charset_normalizer/compare/2.1.0...3.0.0b1) (2022-08-15)
+
+### Changed
+- Optional: Module `md.py` can be compiled using Mypyc to provide an extra speedup up to 4x faster than v2.1
+
+### Removed
+- Breaking: Class aliases CharsetDetector, CharsetDoctor, CharsetNormalizerMatch and CharsetNormalizerMatches
+- Breaking: Top-level function `normalize`
+- Breaking: Properties `chaos_secondary_pass`, `coherence_non_latin` and `w_counter` from CharsetMatch
+- Support for the backport `unicodedata2`
+
+## [2.1.1](https://github.com/Ousret/charset_normalizer/compare/2.1.0...2.1.1) (2022-08-19)
+
+### Deprecated
+- Function `normalize` scheduled for removal in 3.0
+
+### Changed
+- Removed useless call to decode in fn is_unprintable (#206)
+
+### Fixed
+- Third-party library (i18n xgettext) crashing not recognizing utf_8 (PEP 263) with underscore from [@aleksandernovikov](https://github.com/aleksandernovikov) (#204)
+
+## [2.1.0](https://github.com/Ousret/charset_normalizer/compare/2.0.12...2.1.0) (2022-06-19)
+
+### Added
+- Output the Unicode table version when running the CLI with `--version` (PR #194)
+
+### Changed
+- Re-use decoded buffer for single byte character sets from [@nijel](https://github.com/nijel) (PR #175)
+- Fixing some performance bottlenecks from [@deedy5](https://github.com/deedy5) (PR #183)
+
+### Fixed
+- Workaround potential bug in cpython with Zero Width No-Break Space located in Arabic Presentation Forms-B, Unicode 1.1 not acknowledged as space (PR #175)
+- CLI default threshold aligned with the API threshold from [@oleksandr-kuzmenko](https://github.com/oleksandr-kuzmenko) (PR #181)
+
+### Removed
+- Support for Python 3.5 (PR #192)
+
+### Deprecated
+- Use of backport unicodedata from `unicodedata2` as Python is quickly catching up, scheduled for removal in 3.0 (PR #194)
+
+## [2.0.12](https://github.com/Ousret/charset_normalizer/compare/2.0.11...2.0.12) (2022-02-12)
+
+### Fixed
+- ASCII miss-detection on rare cases (PR #170) 
+
+## [2.0.11](https://github.com/Ousret/charset_normalizer/compare/2.0.10...2.0.11) (2022-01-30)
+
+### Added
+- Explicit support for Python 3.11 (PR #164)
+
+### Changed
+- The logging behavior have been completely reviewed, now using only TRACE and DEBUG levels (PR #163 #165)
+
+## [2.0.10](https://github.com/Ousret/charset_normalizer/compare/2.0.9...2.0.10) (2022-01-04)
+
+### Fixed
+- Fallback match entries might lead to UnicodeDecodeError for large bytes sequence (PR #154)
+
+### Changed
+- Skipping the language-detection (CD) on ASCII (PR #155)
+
+## [2.0.9](https://github.com/Ousret/charset_normalizer/compare/2.0.8...2.0.9) (2021-12-03)
+
+### Changed
+- Moderating the logging impact (since 2.0.8) for specific environments (PR #147)
+
+### Fixed
+- Wrong logging level applied when setting kwarg `explain` to True (PR #146)
+
+## [2.0.8](https://github.com/Ousret/charset_normalizer/compare/2.0.7...2.0.8) (2021-11-24)
+### Changed
+- Improvement over Vietnamese detection (PR #126)
+- MD improvement on trailing data and long foreign (non-pure latin) data (PR #124)
+- Efficiency improvements in cd/alphabet_languages from [@adbar](https://github.com/adbar) (PR #122)
+- call sum() without an intermediary list following PEP 289 recommendations from [@adbar](https://github.com/adbar) (PR #129)
+- Code style as refactored by Sourcery-AI (PR #131) 
+- Minor adjustment on the MD around european words (PR #133)
+- Remove and replace SRTs from assets / tests (PR #139)
+- Initialize the library logger with a `NullHandler` by default from [@nmaynes](https://github.com/nmaynes) (PR #135)
+- Setting kwarg `explain` to True will add provisionally (bounded to function lifespan) a specific stream handler (PR #135)
+
+### Fixed
+- Fix large (misleading) sequence giving UnicodeDecodeError (PR #137)
+- Avoid using too insignificant chunk (PR #137)
+
+### Added
+- Add and expose function `set_logging_handler` to configure a specific StreamHandler from [@nmaynes](https://github.com/nmaynes) (PR #135)
+- Add `CHANGELOG.md` entries, format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) (PR #141)
+
+## [2.0.7](https://github.com/Ousret/charset_normalizer/compare/2.0.6...2.0.7) (2021-10-11)
+### Added
+- Add support for Kazakh (Cyrillic) language detection (PR #109)
+
+### Changed
+- Further, improve inferring the language from a given single-byte code page (PR #112)
+- Vainly trying to leverage PEP263 when PEP3120 is not supported (PR #116)
+- Refactoring for potential performance improvements in loops from [@adbar](https://github.com/adbar) (PR #113)
+- Various detection improvement (MD+CD) (PR #117)
+
+### Removed
+- Remove redundant logging entry about detected language(s) (PR #115)
+
+### Fixed
+- Fix a minor inconsistency between Python 3.5 and other versions regarding language detection (PR #117 #102)
+
+## [2.0.6](https://github.com/Ousret/charset_normalizer/compare/2.0.5...2.0.6) (2021-09-18)
+### Fixed
+- Unforeseen regression with the loss of the backward-compatibility with some older minor of Python 3.5.x (PR #100)
+- Fix CLI crash when using --minimal output in certain cases (PR #103)
+
+### Changed
+- Minor improvement to the detection efficiency (less than 1%) (PR #106 #101)
+
+## [2.0.5](https://github.com/Ousret/charset_normalizer/compare/2.0.4...2.0.5) (2021-09-14)
+### Changed
+- The project now comply with: flake8, mypy, isort and black to ensure a better overall quality (PR #81)
+- The BC-support with v1.x was improved, the old staticmethods are restored (PR #82)
+- The Unicode detection is slightly improved (PR #93)
+- Add syntax sugar \_\_bool\_\_ for results CharsetMatches list-container (PR #91)
+
+### Removed
+- The project no longer raise warning on tiny content given for detection, will be simply logged as warning instead (PR #92)
+
+### Fixed
+- In some rare case, the chunks extractor could cut in the middle of a multi-byte character and could mislead the mess detection (PR #95)
+- Some rare 'space' characters could trip up the UnprintablePlugin/Mess detection (PR #96)
+- The MANIFEST.in was not exhaustive (PR #78)
+
+## [2.0.4](https://github.com/Ousret/charset_normalizer/compare/2.0.3...2.0.4) (2021-07-30)
+### Fixed
+- The CLI no longer raise an unexpected exception when no encoding has been found (PR #70)
+- Fix accessing the 'alphabets' property when the payload contains surrogate characters (PR #68)
+- The logger could mislead (explain=True) on detected languages and the impact of one MBCS match (PR #72)
+- Submatch factoring could be wrong in rare edge cases (PR #72)
+- Multiple files given to the CLI were ignored when publishing results to STDOUT. (After the first path) (PR #72)
+- Fix line endings from CRLF to LF for certain project files (PR #67)
+
+### Changed
+- Adjust the MD to lower the sensitivity, thus improving the global detection reliability (PR #69 #76)
+- Allow fallback on specified encoding if any (PR #71)
+
+## [2.0.3](https://github.com/Ousret/charset_normalizer/compare/2.0.2...2.0.3) (2021-07-16)
+### Changed
+- Part of the detection mechanism has been improved to be less sensitive, resulting in more accurate detection results. Especially ASCII. (PR #63)
+- According to the community wishes, the detection will fall back on ASCII or UTF-8 in a last-resort case. (PR #64)
+
+## [2.0.2](https://github.com/Ousret/charset_normalizer/compare/2.0.1...2.0.2) (2021-07-15)
+### Fixed
+- Empty/Too small JSON payload miss-detection fixed. Report from [@tseaver](https://github.com/tseaver) (PR #59) 
+
+### Changed
+- Don't inject unicodedata2 into sys.modules from [@akx](https://github.com/akx) (PR #57)
+
+## [2.0.1](https://github.com/Ousret/charset_normalizer/compare/2.0.0...2.0.1) (2021-07-13)
+### Fixed
+- Make it work where there isn't a filesystem available, dropping assets frequencies.json. Report from [@sethmlarson](https://github.com/sethmlarson). (PR #55)
+- Using explain=False permanently disable the verbose output in the current runtime (PR #47)
+- One log entry (language target preemptive) was not show in logs when using explain=True (PR #47)
+- Fix undesired exception (ValueError) on getitem of instance CharsetMatches (PR #52)
+
+### Changed
+- Public function normalize default args values were not aligned with from_bytes (PR #53)
+
+### Added
+- You may now use charset aliases in cp_isolation and cp_exclusion arguments (PR #47)
+
+## [2.0.0](https://github.com/Ousret/charset_normalizer/compare/1.4.1...2.0.0) (2021-07-02)
+### Changed
+- 4x to 5 times faster than the previous 1.4.0 release. At least 2x faster than Chardet.
+- Accent has been made on UTF-8 detection, should perform rather instantaneous.
+- The backward compatibility with Chardet has been greatly improved. The legacy detect function returns an identical charset name whenever possible.
+- The detection mechanism has been slightly improved, now Turkish content is detected correctly (most of the time)
+- The program has been rewritten to ease the readability and maintainability. (+Using static typing)+
+- utf_7 detection has been reinstated.
+
+### Removed
+- This package no longer require anything when used with Python 3.5 (Dropped cached_property)
+- Removed support for these languages: Catalan, Esperanto, Kazakh, Baque, Volapük, Azeri, Galician, Nynorsk, Macedonian, and Serbocroatian.
+- The exception hook on UnicodeDecodeError has been removed.
+
+### Deprecated
+- Methods coherence_non_latin, w_counter, chaos_secondary_pass of the class CharsetMatch are now deprecated and scheduled for removal in v3.0
+
+### Fixed
+- The CLI output used the relative path of the file(s). Should be absolute.
+
+## [1.4.1](https://github.com/Ousret/charset_normalizer/compare/1.4.0...1.4.1) (2021-05-28)
+### Fixed
+- Logger configuration/usage no longer conflict with others (PR #44)
+
+## [1.4.0](https://github.com/Ousret/charset_normalizer/compare/1.3.9...1.4.0) (2021-05-21)
+### Removed
+- Using standard logging instead of using the package loguru.
+- Dropping nose test framework in favor of the maintained pytest.
+- Choose to not use dragonmapper package to help with gibberish Chinese/CJK text.
+- Require cached_property only for Python 3.5 due to constraint. Dropping for every other interpreter version.
+- Stop support for UTF-7 that does not contain a SIG.
+- Dropping PrettyTable, replaced with pure JSON output in CLI.
+
+### Fixed
+- BOM marker in a CharsetNormalizerMatch instance could be False in rare cases even if obviously present. Due to the sub-match factoring process.
+- Not searching properly for the BOM when trying utf32/16 parent codec.
+
+### Changed
+- Improving the package final size by compressing frequencies.json.
+- Huge improvement over the larges payload.
+
+### Added
+- CLI now produces JSON consumable output.
+- Return ASCII if given sequences fit. Given reasonable confidence.
+
+## [1.3.9](https://github.com/Ousret/charset_normalizer/compare/1.3.8...1.3.9) (2021-05-13)
+
+### Fixed
+- In some very rare cases, you may end up getting encode/decode errors due to a bad bytes payload (PR #40)
+
+## [1.3.8](https://github.com/Ousret/charset_normalizer/compare/1.3.7...1.3.8) (2021-05-12)
+
+### Fixed
+- Empty given payload for detection may cause an exception if trying to access the `alphabets` property. (PR #39)
+
+## [1.3.7](https://github.com/Ousret/charset_normalizer/compare/1.3.6...1.3.7) (2021-05-12)
+
+### Fixed
+- The legacy detect function should return UTF-8-SIG if sig is present in the payload. (PR #38)
+
+## [1.3.6](https://github.com/Ousret/charset_normalizer/compare/1.3.5...1.3.6) (2021-02-09)
+
+### Changed
+- Amend the previous release to allow prettytable 2.0 (PR #35)
+
+## [1.3.5](https://github.com/Ousret/charset_normalizer/compare/1.3.4...1.3.5) (2021-02-08)
+
+### Fixed
+- Fix error while using the package with a python pre-release interpreter (PR #33)
+
+### Changed
+- Dependencies refactoring, constraints revised.
+
+### Added
+- Add python 3.9 and 3.10 to the supported interpreters
+
+MIT License
+
+Copyright (c) 2019 TAHRI Ahmed R.
+
+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
+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.
diff --git a/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/RECORD b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..82733f2519b30df0df1fd13f10542d7b2f660eb5
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/RECORD
@@ -0,0 +1,35 @@
+../../Scripts/normalizer.exe,sha256=un_fQqkgznnEaGnxvsZz-FufMteZZTo30MwVWHotnrc,108401
+charset_normalizer-3.3.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+charset_normalizer-3.3.2.dist-info/LICENSE,sha256=znnj1Var_lZ-hzOvD5W50wcQDp9qls3SD2xIau88ufc,1090
+charset_normalizer-3.3.2.dist-info/METADATA,sha256=hHDqDpXmQH3f8XSn30NlqB3R3NuhJzXC0zABqFwA6Nk,34233
+charset_normalizer-3.3.2.dist-info/RECORD,,
+charset_normalizer-3.3.2.dist-info/WHEEL,sha256=badvNS-y9fEq0X-qzdZYvql_JFjI7Xfw-wR8FsjoK0I,102
+charset_normalizer-3.3.2.dist-info/entry_points.txt,sha256=ADSTKrkXZ3hhdOVFi6DcUEHQRS0xfxDIE_pEz4wLIXA,65
+charset_normalizer-3.3.2.dist-info/top_level.txt,sha256=7ASyzePr8_xuZWJsnqJjIBtyV8vhEo0wBCv1MPRRi3Q,19
+charset_normalizer/__init__.py,sha256=m1cUEsb9K5v831m9P_lv2JlUEKD7MhxL7fxw3hn75o4,1623
+charset_normalizer/__main__.py,sha256=nVnMo31hTPN2Yy045GJIvHj3dKDJz4dAQR3cUSdvYyc,77
+charset_normalizer/__pycache__/__init__.cpython-311.pyc,,
+charset_normalizer/__pycache__/__main__.cpython-311.pyc,,
+charset_normalizer/__pycache__/api.cpython-311.pyc,,
+charset_normalizer/__pycache__/cd.cpython-311.pyc,,
+charset_normalizer/__pycache__/constant.cpython-311.pyc,,
+charset_normalizer/__pycache__/legacy.cpython-311.pyc,,
+charset_normalizer/__pycache__/md.cpython-311.pyc,,
+charset_normalizer/__pycache__/models.cpython-311.pyc,,
+charset_normalizer/__pycache__/utils.cpython-311.pyc,,
+charset_normalizer/__pycache__/version.cpython-311.pyc,,
+charset_normalizer/api.py,sha256=qFL0frUrcfcYEJmGpqoJ4Af68ToVue3f5SK1gp8UC5Q,21723
+charset_normalizer/cd.py,sha256=Yfk3sbee0Xqo1-vmQYbOqM51-SajXPLzFVG89nTsZzc,12955
+charset_normalizer/cli/__init__.py,sha256=COwP8fK2qbuldMem2lL81JieY-PIA2G2GZ5IdAPMPFA,106
+charset_normalizer/cli/__main__.py,sha256=rs-cBipBzr7d0TAaUa0nG4qrjXhdddeCVB-f6Xt_wS0,10040
+charset_normalizer/cli/__pycache__/__init__.cpython-311.pyc,,
+charset_normalizer/cli/__pycache__/__main__.cpython-311.pyc,,
+charset_normalizer/constant.py,sha256=2tVrXQ9cvC8jt0b8gZzRXvXte1pVbRra0A5dOWDQSao,42476
+charset_normalizer/legacy.py,sha256=KbJxEpu7g6zE2uXSB3T-3178cgiSQdVJlJmY-gv3EAM,2125
+charset_normalizer/md.cp311-win_amd64.pyd,sha256=eQoRqicFI8LvpgIc5PmUw8Wmfo6qrwIHTVMIQgtovZQ,10752
+charset_normalizer/md.py,sha256=F7S001NdPgkAoma2w598Idx2clW9ljXlRIYKZQKsCQA,20239
+charset_normalizer/md__mypyc.cp311-win_amd64.pyd,sha256=PZiTqnnv0T2B_NYU6e9ftqrZBWm-7e1REt5e1aw891M,119296
+charset_normalizer/models.py,sha256=AlehuyGDE74jhryjg6TTkYh1MCntfxXFfGhTi0esu-Y,11964
+charset_normalizer/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+charset_normalizer/utils.py,sha256=jjvfSXHJD6QPgxcxIx4utsOFx3PxFssWef1IYxA3uKs,12315
+charset_normalizer/version.py,sha256=q3fF12xGlBuaub5kroTZt7lBPQLO3kFvMnkoEnt-6YA,85
diff --git a/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/WHEEL b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..6d160455a81f006d13b4485d8d1d7c5d50dc3a04
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.41.2)
+Root-Is-Purelib: false
+Tag: cp311-cp311-win_amd64
+
diff --git a/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/entry_points.txt b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..65619e73ec06c20c2a70c9507b872ad624d1a85c
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/entry_points.txt
@@ -0,0 +1,2 @@
+[console_scripts]
+normalizer = charset_normalizer.cli:cli_detect
diff --git a/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/top_level.txt b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..66958f0a069d7aea7939bed40b9197608e93b243
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer-3.3.2.dist-info/top_level.txt
@@ -0,0 +1 @@
+charset_normalizer
diff --git a/llm/Lib/site-packages/charset_normalizer/__init__.py b/llm/Lib/site-packages/charset_normalizer/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4077a449daef874df6dd2aa526edeb9a2713fa04
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer/__init__.py
@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+"""
+Charset-Normalizer
+~~~~~~~~~~~~~~
+The Real First Universal Charset Detector.
+A library that helps you read text from an unknown charset encoding.
+Motivated by chardet, This package is trying to resolve the issue by taking a new approach.
+All IANA character set names for which the Python core library provides codecs are supported.
+
+Basic usage:
+   >>> from charset_normalizer import from_bytes
+   >>> results = from_bytes('Bсеки човек има право на образование. Oбразованието!'.encode('utf_8'))
+   >>> best_guess = results.best()
+   >>> str(best_guess)
+   'Bсеки човек има право на образование. Oбразованието!'
+
+Others methods and usages are available - see the full documentation
+at <https://github.com/Ousret/charset_normalizer>.
+:copyright: (c) 2021 by Ahmed TAHRI
+:license: MIT, see LICENSE for more details.
+"""
+import logging
+
+from .api import from_bytes, from_fp, from_path, is_binary
+from .legacy import detect
+from .models import CharsetMatch, CharsetMatches
+from .utils import set_logging_handler
+from .version import VERSION, __version__
+
+__all__ = (
+    "from_fp",
+    "from_path",
+    "from_bytes",
+    "is_binary",
+    "detect",
+    "CharsetMatch",
+    "CharsetMatches",
+    "__version__",
+    "VERSION",
+    "set_logging_handler",
+)
+
+# Attach a NullHandler to the top level logger by default
+# https://docs.python.org/3.3/howto/logging.html#configuring-logging-for-a-library
+
+logging.getLogger("charset_normalizer").addHandler(logging.NullHandler())
diff --git a/llm/Lib/site-packages/charset_normalizer/__main__.py b/llm/Lib/site-packages/charset_normalizer/__main__.py
new file mode 100644
index 0000000000000000000000000000000000000000..acf70040482032eb4b601d07d6f57739cdaab126
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer/__main__.py
@@ -0,0 +1,4 @@
+from .cli import cli_detect
+
+if __name__ == "__main__":
+    cli_detect()
diff --git a/llm/Lib/site-packages/charset_normalizer/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/charset_normalizer/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d2ca89b5b8c5173ac65926c791fcba8b70968fcd
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/charset_normalizer/__pycache__/__main__.cpython-311.pyc b/llm/Lib/site-packages/charset_normalizer/__pycache__/__main__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e462febad1e371219a4673e040eb22ed08290a46
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/__pycache__/__main__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/charset_normalizer/__pycache__/api.cpython-311.pyc b/llm/Lib/site-packages/charset_normalizer/__pycache__/api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2d22cf6822e99ad8e0047fbce3921d9a943b1ddb
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/__pycache__/api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/charset_normalizer/__pycache__/cd.cpython-311.pyc b/llm/Lib/site-packages/charset_normalizer/__pycache__/cd.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3a52d0e8ca9801c24b9be9490e735b207283ebb3
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/__pycache__/cd.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/charset_normalizer/__pycache__/constant.cpython-311.pyc b/llm/Lib/site-packages/charset_normalizer/__pycache__/constant.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..34635b08caedff7dc01848cbc8a44339fbdfa37b
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/__pycache__/constant.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/charset_normalizer/__pycache__/legacy.cpython-311.pyc b/llm/Lib/site-packages/charset_normalizer/__pycache__/legacy.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c046b18fc83a14334b0f2e8f4d12865c2a5bf20c
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/__pycache__/legacy.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/charset_normalizer/__pycache__/md.cpython-311.pyc b/llm/Lib/site-packages/charset_normalizer/__pycache__/md.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e4263abfffd777fe2edb48f945ab2627d10da8b
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/__pycache__/md.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/charset_normalizer/__pycache__/models.cpython-311.pyc b/llm/Lib/site-packages/charset_normalizer/__pycache__/models.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..19016841047232b1acff59f9025997334cdbbd93
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/__pycache__/models.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/charset_normalizer/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/charset_normalizer/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..76e201cfdde608c831db8a817753221a2ac0729f
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/charset_normalizer/__pycache__/version.cpython-311.pyc b/llm/Lib/site-packages/charset_normalizer/__pycache__/version.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..87448365db22611dac5d0e4a47844b9053316e91
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/__pycache__/version.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/charset_normalizer/api.py b/llm/Lib/site-packages/charset_normalizer/api.py
new file mode 100644
index 0000000000000000000000000000000000000000..4472bf6c4ef1bd5dafe953179663dc84bd1c0554
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer/api.py
@@ -0,0 +1,626 @@
+import logging
+from os import PathLike
+from typing import BinaryIO, List, Optional, Set, Union
+
+from .cd import (
+    coherence_ratio,
+    encoding_languages,
+    mb_encoding_languages,
+    merge_coherence_ratios,
+)
+from .constant import IANA_SUPPORTED, TOO_BIG_SEQUENCE, TOO_SMALL_SEQUENCE, TRACE
+from .md import mess_ratio
+from .models import CharsetMatch, CharsetMatches
+from .utils import (
+    any_specified_encoding,
+    cut_sequence_chunks,
+    iana_name,
+    identify_sig_or_bom,
+    is_cp_similar,
+    is_multi_byte_encoding,
+    should_strip_sig_or_bom,
+)
+
+# Will most likely be controversial
+# logging.addLevelName(TRACE, "TRACE")
+logger = logging.getLogger("charset_normalizer")
+explain_handler = logging.StreamHandler()
+explain_handler.setFormatter(
+    logging.Formatter("%(asctime)s | %(levelname)s | %(message)s")
+)
+
+
+def from_bytes(
+    sequences: Union[bytes, bytearray],
+    steps: int = 5,
+    chunk_size: int = 512,
+    threshold: float = 0.2,
+    cp_isolation: Optional[List[str]] = None,
+    cp_exclusion: Optional[List[str]] = None,
+    preemptive_behaviour: bool = True,
+    explain: bool = False,
+    language_threshold: float = 0.1,
+    enable_fallback: bool = True,
+) -> CharsetMatches:
+    """
+    Given a raw bytes sequence, return the best possibles charset usable to render str objects.
+    If there is no results, it is a strong indicator that the source is binary/not text.
+    By default, the process will extract 5 blocks of 512o each to assess the mess and coherence of a given sequence.
+    And will give up a particular code page after 20% of measured mess. Those criteria are customizable at will.
+
+    The preemptive behavior DOES NOT replace the traditional detection workflow, it prioritize a particular code page
+    but never take it for granted. Can improve the performance.
+
+    You may want to focus your attention to some code page or/and not others, use cp_isolation and cp_exclusion for that
+    purpose.
+
+    This function will strip the SIG in the payload/sequence every time except on UTF-16, UTF-32.
+    By default the library does not setup any handler other than the NullHandler, if you choose to set the 'explain'
+    toggle to True it will alter the logger configuration to add a StreamHandler that is suitable for debugging.
+    Custom logging format and handler can be set manually.
+    """
+
+    if not isinstance(sequences, (bytearray, bytes)):
+        raise TypeError(
+            "Expected object of type bytes or bytearray, got: {0}".format(
+                type(sequences)
+            )
+        )
+
+    if explain:
+        previous_logger_level: int = logger.level
+        logger.addHandler(explain_handler)
+        logger.setLevel(TRACE)
+
+    length: int = len(sequences)
+
+    if length == 0:
+        logger.debug("Encoding detection on empty bytes, assuming utf_8 intention.")
+        if explain:
+            logger.removeHandler(explain_handler)
+            logger.setLevel(previous_logger_level or logging.WARNING)
+        return CharsetMatches([CharsetMatch(sequences, "utf_8", 0.0, False, [], "")])
+
+    if cp_isolation is not None:
+        logger.log(
+            TRACE,
+            "cp_isolation is set. use this flag for debugging purpose. "
+            "limited list of encoding allowed : %s.",
+            ", ".join(cp_isolation),
+        )
+        cp_isolation = [iana_name(cp, False) for cp in cp_isolation]
+    else:
+        cp_isolation = []
+
+    if cp_exclusion is not None:
+        logger.log(
+            TRACE,
+            "cp_exclusion is set. use this flag for debugging purpose. "
+            "limited list of encoding excluded : %s.",
+            ", ".join(cp_exclusion),
+        )
+        cp_exclusion = [iana_name(cp, False) for cp in cp_exclusion]
+    else:
+        cp_exclusion = []
+
+    if length <= (chunk_size * steps):
+        logger.log(
+            TRACE,
+            "override steps (%i) and chunk_size (%i) as content does not fit (%i byte(s) given) parameters.",
+            steps,
+            chunk_size,
+            length,
+        )
+        steps = 1
+        chunk_size = length
+
+    if steps > 1 and length / steps < chunk_size:
+        chunk_size = int(length / steps)
+
+    is_too_small_sequence: bool = len(sequences) < TOO_SMALL_SEQUENCE
+    is_too_large_sequence: bool = len(sequences) >= TOO_BIG_SEQUENCE
+
+    if is_too_small_sequence:
+        logger.log(
+            TRACE,
+            "Trying to detect encoding from a tiny portion of ({}) byte(s).".format(
+                length
+            ),
+        )
+    elif is_too_large_sequence:
+        logger.log(
+            TRACE,
+            "Using lazy str decoding because the payload is quite large, ({}) byte(s).".format(
+                length
+            ),
+        )
+
+    prioritized_encodings: List[str] = []
+
+    specified_encoding: Optional[str] = (
+        any_specified_encoding(sequences) if preemptive_behaviour else None
+    )
+
+    if specified_encoding is not None:
+        prioritized_encodings.append(specified_encoding)
+        logger.log(
+            TRACE,
+            "Detected declarative mark in sequence. Priority +1 given for %s.",
+            specified_encoding,
+        )
+
+    tested: Set[str] = set()
+    tested_but_hard_failure: List[str] = []
+    tested_but_soft_failure: List[str] = []
+
+    fallback_ascii: Optional[CharsetMatch] = None
+    fallback_u8: Optional[CharsetMatch] = None
+    fallback_specified: Optional[CharsetMatch] = None
+
+    results: CharsetMatches = CharsetMatches()
+
+    sig_encoding, sig_payload = identify_sig_or_bom(sequences)
+
+    if sig_encoding is not None:
+        prioritized_encodings.append(sig_encoding)
+        logger.log(
+            TRACE,
+            "Detected a SIG or BOM mark on first %i byte(s). Priority +1 given for %s.",
+            len(sig_payload),
+            sig_encoding,
+        )
+
+    prioritized_encodings.append("ascii")
+
+    if "utf_8" not in prioritized_encodings:
+        prioritized_encodings.append("utf_8")
+
+    for encoding_iana in prioritized_encodings + IANA_SUPPORTED:
+        if cp_isolation and encoding_iana not in cp_isolation:
+            continue
+
+        if cp_exclusion and encoding_iana in cp_exclusion:
+            continue
+
+        if encoding_iana in tested:
+            continue
+
+        tested.add(encoding_iana)
+
+        decoded_payload: Optional[str] = None
+        bom_or_sig_available: bool = sig_encoding == encoding_iana
+        strip_sig_or_bom: bool = bom_or_sig_available and should_strip_sig_or_bom(
+            encoding_iana
+        )
+
+        if encoding_iana in {"utf_16", "utf_32"} and not bom_or_sig_available:
+            logger.log(
+                TRACE,
+                "Encoding %s won't be tested as-is because it require a BOM. Will try some sub-encoder LE/BE.",
+                encoding_iana,
+            )
+            continue
+        if encoding_iana in {"utf_7"} and not bom_or_sig_available:
+            logger.log(
+                TRACE,
+                "Encoding %s won't be tested as-is because detection is unreliable without BOM/SIG.",
+                encoding_iana,
+            )
+            continue
+
+        try:
+            is_multi_byte_decoder: bool = is_multi_byte_encoding(encoding_iana)
+        except (ModuleNotFoundError, ImportError):
+            logger.log(
+                TRACE,
+                "Encoding %s does not provide an IncrementalDecoder",
+                encoding_iana,
+            )
+            continue
+
+        try:
+            if is_too_large_sequence and is_multi_byte_decoder is False:
+                str(
+                    sequences[: int(50e4)]
+                    if strip_sig_or_bom is False
+                    else sequences[len(sig_payload) : int(50e4)],
+                    encoding=encoding_iana,
+                )
+            else:
+                decoded_payload = str(
+                    sequences
+                    if strip_sig_or_bom is False
+                    else sequences[len(sig_payload) :],
+                    encoding=encoding_iana,
+                )
+        except (UnicodeDecodeError, LookupError) as e:
+            if not isinstance(e, LookupError):
+                logger.log(
+                    TRACE,
+                    "Code page %s does not fit given bytes sequence at ALL. %s",
+                    encoding_iana,
+                    str(e),
+                )
+            tested_but_hard_failure.append(encoding_iana)
+            continue
+
+        similar_soft_failure_test: bool = False
+
+        for encoding_soft_failed in tested_but_soft_failure:
+            if is_cp_similar(encoding_iana, encoding_soft_failed):
+                similar_soft_failure_test = True
+                break
+
+        if similar_soft_failure_test:
+            logger.log(
+                TRACE,
+                "%s is deemed too similar to code page %s and was consider unsuited already. Continuing!",
+                encoding_iana,
+                encoding_soft_failed,
+            )
+            continue
+
+        r_ = range(
+            0 if not bom_or_sig_available else len(sig_payload),
+            length,
+            int(length / steps),
+        )
+
+        multi_byte_bonus: bool = (
+            is_multi_byte_decoder
+            and decoded_payload is not None
+            and len(decoded_payload) < length
+        )
+
+        if multi_byte_bonus:
+            logger.log(
+                TRACE,
+                "Code page %s is a multi byte encoding table and it appear that at least one character "
+                "was encoded using n-bytes.",
+                encoding_iana,
+            )
+
+        max_chunk_gave_up: int = int(len(r_) / 4)
+
+        max_chunk_gave_up = max(max_chunk_gave_up, 2)
+        early_stop_count: int = 0
+        lazy_str_hard_failure = False
+
+        md_chunks: List[str] = []
+        md_ratios = []
+
+        try:
+            for chunk in cut_sequence_chunks(
+                sequences,
+                encoding_iana,
+                r_,
+                chunk_size,
+                bom_or_sig_available,
+                strip_sig_or_bom,
+                sig_payload,
+                is_multi_byte_decoder,
+                decoded_payload,
+            ):
+                md_chunks.append(chunk)
+
+                md_ratios.append(
+                    mess_ratio(
+                        chunk,
+                        threshold,
+                        explain is True and 1 <= len(cp_isolation) <= 2,
+                    )
+                )
+
+                if md_ratios[-1] >= threshold:
+                    early_stop_count += 1
+
+                if (early_stop_count >= max_chunk_gave_up) or (
+                    bom_or_sig_available and strip_sig_or_bom is False
+                ):
+                    break
+        except (
+            UnicodeDecodeError
+        ) as e:  # Lazy str loading may have missed something there
+            logger.log(
+                TRACE,
+                "LazyStr Loading: After MD chunk decode, code page %s does not fit given bytes sequence at ALL. %s",
+                encoding_iana,
+                str(e),
+            )
+            early_stop_count = max_chunk_gave_up
+            lazy_str_hard_failure = True
+
+        # We might want to check the sequence again with the whole content
+        # Only if initial MD tests passes
+        if (
+            not lazy_str_hard_failure
+            and is_too_large_sequence
+            and not is_multi_byte_decoder
+        ):
+            try:
+                sequences[int(50e3) :].decode(encoding_iana, errors="strict")
+            except UnicodeDecodeError as e:
+                logger.log(
+                    TRACE,
+                    "LazyStr Loading: After final lookup, code page %s does not fit given bytes sequence at ALL. %s",
+                    encoding_iana,
+                    str(e),
+                )
+                tested_but_hard_failure.append(encoding_iana)
+                continue
+
+        mean_mess_ratio: float = sum(md_ratios) / len(md_ratios) if md_ratios else 0.0
+        if mean_mess_ratio >= threshold or early_stop_count >= max_chunk_gave_up:
+            tested_but_soft_failure.append(encoding_iana)
+            logger.log(
+                TRACE,
+                "%s was excluded because of initial chaos probing. Gave up %i time(s). "
+                "Computed mean chaos is %f %%.",
+                encoding_iana,
+                early_stop_count,
+                round(mean_mess_ratio * 100, ndigits=3),
+            )
+            # Preparing those fallbacks in case we got nothing.
+            if (
+                enable_fallback
+                and encoding_iana in ["ascii", "utf_8", specified_encoding]
+                and not lazy_str_hard_failure
+            ):
+                fallback_entry = CharsetMatch(
+                    sequences, encoding_iana, threshold, False, [], decoded_payload
+                )
+                if encoding_iana == specified_encoding:
+                    fallback_specified = fallback_entry
+                elif encoding_iana == "ascii":
+                    fallback_ascii = fallback_entry
+                else:
+                    fallback_u8 = fallback_entry
+            continue
+
+        logger.log(
+            TRACE,
+            "%s passed initial chaos probing. Mean measured chaos is %f %%",
+            encoding_iana,
+            round(mean_mess_ratio * 100, ndigits=3),
+        )
+
+        if not is_multi_byte_decoder:
+            target_languages: List[str] = encoding_languages(encoding_iana)
+        else:
+            target_languages = mb_encoding_languages(encoding_iana)
+
+        if target_languages:
+            logger.log(
+                TRACE,
+                "{} should target any language(s) of {}".format(
+                    encoding_iana, str(target_languages)
+                ),
+            )
+
+        cd_ratios = []
+
+        # We shall skip the CD when its about ASCII
+        # Most of the time its not relevant to run "language-detection" on it.
+        if encoding_iana != "ascii":
+            for chunk in md_chunks:
+                chunk_languages = coherence_ratio(
+                    chunk,
+                    language_threshold,
+                    ",".join(target_languages) if target_languages else None,
+                )
+
+                cd_ratios.append(chunk_languages)
+
+        cd_ratios_merged = merge_coherence_ratios(cd_ratios)
+
+        if cd_ratios_merged:
+            logger.log(
+                TRACE,
+                "We detected language {} using {}".format(
+                    cd_ratios_merged, encoding_iana
+                ),
+            )
+
+        results.append(
+            CharsetMatch(
+                sequences,
+                encoding_iana,
+                mean_mess_ratio,
+                bom_or_sig_available,
+                cd_ratios_merged,
+                decoded_payload,
+            )
+        )
+
+        if (
+            encoding_iana in [specified_encoding, "ascii", "utf_8"]
+            and mean_mess_ratio < 0.1
+        ):
+            logger.debug(
+                "Encoding detection: %s is most likely the one.", encoding_iana
+            )
+            if explain:
+                logger.removeHandler(explain_handler)
+                logger.setLevel(previous_logger_level)
+            return CharsetMatches([results[encoding_iana]])
+
+        if encoding_iana == sig_encoding:
+            logger.debug(
+                "Encoding detection: %s is most likely the one as we detected a BOM or SIG within "
+                "the beginning of the sequence.",
+                encoding_iana,
+            )
+            if explain:
+                logger.removeHandler(explain_handler)
+                logger.setLevel(previous_logger_level)
+            return CharsetMatches([results[encoding_iana]])
+
+    if len(results) == 0:
+        if fallback_u8 or fallback_ascii or fallback_specified:
+            logger.log(
+                TRACE,
+                "Nothing got out of the detection process. Using ASCII/UTF-8/Specified fallback.",
+            )
+
+        if fallback_specified:
+            logger.debug(
+                "Encoding detection: %s will be used as a fallback match",
+                fallback_specified.encoding,
+            )
+            results.append(fallback_specified)
+        elif (
+            (fallback_u8 and fallback_ascii is None)
+            or (
+                fallback_u8
+                and fallback_ascii
+                and fallback_u8.fingerprint != fallback_ascii.fingerprint
+            )
+            or (fallback_u8 is not None)
+        ):
+            logger.debug("Encoding detection: utf_8 will be used as a fallback match")
+            results.append(fallback_u8)
+        elif fallback_ascii:
+            logger.debug("Encoding detection: ascii will be used as a fallback match")
+            results.append(fallback_ascii)
+
+    if results:
+        logger.debug(
+            "Encoding detection: Found %s as plausible (best-candidate) for content. With %i alternatives.",
+            results.best().encoding,  # type: ignore
+            len(results) - 1,
+        )
+    else:
+        logger.debug("Encoding detection: Unable to determine any suitable charset.")
+
+    if explain:
+        logger.removeHandler(explain_handler)
+        logger.setLevel(previous_logger_level)
+
+    return results
+
+
+def from_fp(
+    fp: BinaryIO,
+    steps: int = 5,
+    chunk_size: int = 512,
+    threshold: float = 0.20,
+    cp_isolation: Optional[List[str]] = None,
+    cp_exclusion: Optional[List[str]] = None,
+    preemptive_behaviour: bool = True,
+    explain: bool = False,
+    language_threshold: float = 0.1,
+    enable_fallback: bool = True,
+) -> CharsetMatches:
+    """
+    Same thing than the function from_bytes but using a file pointer that is already ready.
+    Will not close the file pointer.
+    """
+    return from_bytes(
+        fp.read(),
+        steps,
+        chunk_size,
+        threshold,
+        cp_isolation,
+        cp_exclusion,
+        preemptive_behaviour,
+        explain,
+        language_threshold,
+        enable_fallback,
+    )
+
+
+def from_path(
+    path: Union[str, bytes, PathLike],  # type: ignore[type-arg]
+    steps: int = 5,
+    chunk_size: int = 512,
+    threshold: float = 0.20,
+    cp_isolation: Optional[List[str]] = None,
+    cp_exclusion: Optional[List[str]] = None,
+    preemptive_behaviour: bool = True,
+    explain: bool = False,
+    language_threshold: float = 0.1,
+    enable_fallback: bool = True,
+) -> CharsetMatches:
+    """
+    Same thing than the function from_bytes but with one extra step. Opening and reading given file path in binary mode.
+    Can raise IOError.
+    """
+    with open(path, "rb") as fp:
+        return from_fp(
+            fp,
+            steps,
+            chunk_size,
+            threshold,
+            cp_isolation,
+            cp_exclusion,
+            preemptive_behaviour,
+            explain,
+            language_threshold,
+            enable_fallback,
+        )
+
+
+def is_binary(
+    fp_or_path_or_payload: Union[PathLike, str, BinaryIO, bytes],  # type: ignore[type-arg]
+    steps: int = 5,
+    chunk_size: int = 512,
+    threshold: float = 0.20,
+    cp_isolation: Optional[List[str]] = None,
+    cp_exclusion: Optional[List[str]] = None,
+    preemptive_behaviour: bool = True,
+    explain: bool = False,
+    language_threshold: float = 0.1,
+    enable_fallback: bool = False,
+) -> bool:
+    """
+    Detect if the given input (file, bytes, or path) points to a binary file. aka. not a string.
+    Based on the same main heuristic algorithms and default kwargs at the sole exception that fallbacks match
+    are disabled to be stricter around ASCII-compatible but unlikely to be a string.
+    """
+    if isinstance(fp_or_path_or_payload, (str, PathLike)):
+        guesses = from_path(
+            fp_or_path_or_payload,
+            steps=steps,
+            chunk_size=chunk_size,
+            threshold=threshold,
+            cp_isolation=cp_isolation,
+            cp_exclusion=cp_exclusion,
+            preemptive_behaviour=preemptive_behaviour,
+            explain=explain,
+            language_threshold=language_threshold,
+            enable_fallback=enable_fallback,
+        )
+    elif isinstance(
+        fp_or_path_or_payload,
+        (
+            bytes,
+            bytearray,
+        ),
+    ):
+        guesses = from_bytes(
+            fp_or_path_or_payload,
+            steps=steps,
+            chunk_size=chunk_size,
+            threshold=threshold,
+            cp_isolation=cp_isolation,
+            cp_exclusion=cp_exclusion,
+            preemptive_behaviour=preemptive_behaviour,
+            explain=explain,
+            language_threshold=language_threshold,
+            enable_fallback=enable_fallback,
+        )
+    else:
+        guesses = from_fp(
+            fp_or_path_or_payload,
+            steps=steps,
+            chunk_size=chunk_size,
+            threshold=threshold,
+            cp_isolation=cp_isolation,
+            cp_exclusion=cp_exclusion,
+            preemptive_behaviour=preemptive_behaviour,
+            explain=explain,
+            language_threshold=language_threshold,
+            enable_fallback=enable_fallback,
+        )
+
+    return not guesses
diff --git a/llm/Lib/site-packages/charset_normalizer/cd.py b/llm/Lib/site-packages/charset_normalizer/cd.py
new file mode 100644
index 0000000000000000000000000000000000000000..4e79a9210451cec5f55ec1653b0e5112ce539814
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer/cd.py
@@ -0,0 +1,395 @@
+import importlib
+from codecs import IncrementalDecoder
+from collections import Counter
+from functools import lru_cache
+from typing import Counter as TypeCounter, Dict, List, Optional, Tuple
+
+from .constant import (
+    FREQUENCIES,
+    KO_NAMES,
+    LANGUAGE_SUPPORTED_COUNT,
+    TOO_SMALL_SEQUENCE,
+    ZH_NAMES,
+)
+from .md import is_suspiciously_successive_range
+from .models import CoherenceMatches
+from .utils import (
+    is_accentuated,
+    is_latin,
+    is_multi_byte_encoding,
+    is_unicode_range_secondary,
+    unicode_range,
+)
+
+
+def encoding_unicode_range(iana_name: str) -> List[str]:
+    """
+    Return associated unicode ranges in a single byte code page.
+    """
+    if is_multi_byte_encoding(iana_name):
+        raise IOError("Function not supported on multi-byte code page")
+
+    decoder = importlib.import_module(
+        "encodings.{}".format(iana_name)
+    ).IncrementalDecoder
+
+    p: IncrementalDecoder = decoder(errors="ignore")
+    seen_ranges: Dict[str, int] = {}
+    character_count: int = 0
+
+    for i in range(0x40, 0xFF):
+        chunk: str = p.decode(bytes([i]))
+
+        if chunk:
+            character_range: Optional[str] = unicode_range(chunk)
+
+            if character_range is None:
+                continue
+
+            if is_unicode_range_secondary(character_range) is False:
+                if character_range not in seen_ranges:
+                    seen_ranges[character_range] = 0
+                seen_ranges[character_range] += 1
+                character_count += 1
+
+    return sorted(
+        [
+            character_range
+            for character_range in seen_ranges
+            if seen_ranges[character_range] / character_count >= 0.15
+        ]
+    )
+
+
+def unicode_range_languages(primary_range: str) -> List[str]:
+    """
+    Return inferred languages used with a unicode range.
+    """
+    languages: List[str] = []
+
+    for language, characters in FREQUENCIES.items():
+        for character in characters:
+            if unicode_range(character) == primary_range:
+                languages.append(language)
+                break
+
+    return languages
+
+
+@lru_cache()
+def encoding_languages(iana_name: str) -> List[str]:
+    """
+    Single-byte encoding language association. Some code page are heavily linked to particular language(s).
+    This function does the correspondence.
+    """
+    unicode_ranges: List[str] = encoding_unicode_range(iana_name)
+    primary_range: Optional[str] = None
+
+    for specified_range in unicode_ranges:
+        if "Latin" not in specified_range:
+            primary_range = specified_range
+            break
+
+    if primary_range is None:
+        return ["Latin Based"]
+
+    return unicode_range_languages(primary_range)
+
+
+@lru_cache()
+def mb_encoding_languages(iana_name: str) -> List[str]:
+    """
+    Multi-byte encoding language association. Some code page are heavily linked to particular language(s).
+    This function does the correspondence.
+    """
+    if (
+        iana_name.startswith("shift_")
+        or iana_name.startswith("iso2022_jp")
+        or iana_name.startswith("euc_j")
+        or iana_name == "cp932"
+    ):
+        return ["Japanese"]
+    if iana_name.startswith("gb") or iana_name in ZH_NAMES:
+        return ["Chinese"]
+    if iana_name.startswith("iso2022_kr") or iana_name in KO_NAMES:
+        return ["Korean"]
+
+    return []
+
+
+@lru_cache(maxsize=LANGUAGE_SUPPORTED_COUNT)
+def get_target_features(language: str) -> Tuple[bool, bool]:
+    """
+    Determine main aspects from a supported language if it contains accents and if is pure Latin.
+    """
+    target_have_accents: bool = False
+    target_pure_latin: bool = True
+
+    for character in FREQUENCIES[language]:
+        if not target_have_accents and is_accentuated(character):
+            target_have_accents = True
+        if target_pure_latin and is_latin(character) is False:
+            target_pure_latin = False
+
+    return target_have_accents, target_pure_latin
+
+
+def alphabet_languages(
+    characters: List[str], ignore_non_latin: bool = False
+) -> List[str]:
+    """
+    Return associated languages associated to given characters.
+    """
+    languages: List[Tuple[str, float]] = []
+
+    source_have_accents = any(is_accentuated(character) for character in characters)
+
+    for language, language_characters in FREQUENCIES.items():
+        target_have_accents, target_pure_latin = get_target_features(language)
+
+        if ignore_non_latin and target_pure_latin is False:
+            continue
+
+        if target_have_accents is False and source_have_accents:
+            continue
+
+        character_count: int = len(language_characters)
+
+        character_match_count: int = len(
+            [c for c in language_characters if c in characters]
+        )
+
+        ratio: float = character_match_count / character_count
+
+        if ratio >= 0.2:
+            languages.append((language, ratio))
+
+    languages = sorted(languages, key=lambda x: x[1], reverse=True)
+
+    return [compatible_language[0] for compatible_language in languages]
+
+
+def characters_popularity_compare(
+    language: str, ordered_characters: List[str]
+) -> float:
+    """
+    Determine if a ordered characters list (by occurrence from most appearance to rarest) match a particular language.
+    The result is a ratio between 0. (absolutely no correspondence) and 1. (near perfect fit).
+    Beware that is function is not strict on the match in order to ease the detection. (Meaning close match is 1.)
+    """
+    if language not in FREQUENCIES:
+        raise ValueError("{} not available".format(language))
+
+    character_approved_count: int = 0
+    FREQUENCIES_language_set = set(FREQUENCIES[language])
+
+    ordered_characters_count: int = len(ordered_characters)
+    target_language_characters_count: int = len(FREQUENCIES[language])
+
+    large_alphabet: bool = target_language_characters_count > 26
+
+    for character, character_rank in zip(
+        ordered_characters, range(0, ordered_characters_count)
+    ):
+        if character not in FREQUENCIES_language_set:
+            continue
+
+        character_rank_in_language: int = FREQUENCIES[language].index(character)
+        expected_projection_ratio: float = (
+            target_language_characters_count / ordered_characters_count
+        )
+        character_rank_projection: int = int(character_rank * expected_projection_ratio)
+
+        if (
+            large_alphabet is False
+            and abs(character_rank_projection - character_rank_in_language) > 4
+        ):
+            continue
+
+        if (
+            large_alphabet is True
+            and abs(character_rank_projection - character_rank_in_language)
+            < target_language_characters_count / 3
+        ):
+            character_approved_count += 1
+            continue
+
+        characters_before_source: List[str] = FREQUENCIES[language][
+            0:character_rank_in_language
+        ]
+        characters_after_source: List[str] = FREQUENCIES[language][
+            character_rank_in_language:
+        ]
+        characters_before: List[str] = ordered_characters[0:character_rank]
+        characters_after: List[str] = ordered_characters[character_rank:]
+
+        before_match_count: int = len(
+            set(characters_before) & set(characters_before_source)
+        )
+
+        after_match_count: int = len(
+            set(characters_after) & set(characters_after_source)
+        )
+
+        if len(characters_before_source) == 0 and before_match_count <= 4:
+            character_approved_count += 1
+            continue
+
+        if len(characters_after_source) == 0 and after_match_count <= 4:
+            character_approved_count += 1
+            continue
+
+        if (
+            before_match_count / len(characters_before_source) >= 0.4
+            or after_match_count / len(characters_after_source) >= 0.4
+        ):
+            character_approved_count += 1
+            continue
+
+    return character_approved_count / len(ordered_characters)
+
+
+def alpha_unicode_split(decoded_sequence: str) -> List[str]:
+    """
+    Given a decoded text sequence, return a list of str. Unicode range / alphabet separation.
+    Ex. a text containing English/Latin with a bit a Hebrew will return two items in the resulting list;
+    One containing the latin letters and the other hebrew.
+    """
+    layers: Dict[str, str] = {}
+
+    for character in decoded_sequence:
+        if character.isalpha() is False:
+            continue
+
+        character_range: Optional[str] = unicode_range(character)
+
+        if character_range is None:
+            continue
+
+        layer_target_range: Optional[str] = None
+
+        for discovered_range in layers:
+            if (
+                is_suspiciously_successive_range(discovered_range, character_range)
+                is False
+            ):
+                layer_target_range = discovered_range
+                break
+
+        if layer_target_range is None:
+            layer_target_range = character_range
+
+        if layer_target_range not in layers:
+            layers[layer_target_range] = character.lower()
+            continue
+
+        layers[layer_target_range] += character.lower()
+
+    return list(layers.values())
+
+
+def merge_coherence_ratios(results: List[CoherenceMatches]) -> CoherenceMatches:
+    """
+    This function merge results previously given by the function coherence_ratio.
+    The return type is the same as coherence_ratio.
+    """
+    per_language_ratios: Dict[str, List[float]] = {}
+    for result in results:
+        for sub_result in result:
+            language, ratio = sub_result
+            if language not in per_language_ratios:
+                per_language_ratios[language] = [ratio]
+                continue
+            per_language_ratios[language].append(ratio)
+
+    merge = [
+        (
+            language,
+            round(
+                sum(per_language_ratios[language]) / len(per_language_ratios[language]),
+                4,
+            ),
+        )
+        for language in per_language_ratios
+    ]
+
+    return sorted(merge, key=lambda x: x[1], reverse=True)
+
+
+def filter_alt_coherence_matches(results: CoherenceMatches) -> CoherenceMatches:
+    """
+    We shall NOT return "English—" in CoherenceMatches because it is an alternative
+    of "English". This function only keeps the best match and remove the em-dash in it.
+    """
+    index_results: Dict[str, List[float]] = dict()
+
+    for result in results:
+        language, ratio = result
+        no_em_name: str = language.replace("—", "")
+
+        if no_em_name not in index_results:
+            index_results[no_em_name] = []
+
+        index_results[no_em_name].append(ratio)
+
+    if any(len(index_results[e]) > 1 for e in index_results):
+        filtered_results: CoherenceMatches = []
+
+        for language in index_results:
+            filtered_results.append((language, max(index_results[language])))
+
+        return filtered_results
+
+    return results
+
+
+@lru_cache(maxsize=2048)
+def coherence_ratio(
+    decoded_sequence: str, threshold: float = 0.1, lg_inclusion: Optional[str] = None
+) -> CoherenceMatches:
+    """
+    Detect ANY language that can be identified in given sequence. The sequence will be analysed by layers.
+    A layer = Character extraction by alphabets/ranges.
+    """
+
+    results: List[Tuple[str, float]] = []
+    ignore_non_latin: bool = False
+
+    sufficient_match_count: int = 0
+
+    lg_inclusion_list = lg_inclusion.split(",") if lg_inclusion is not None else []
+    if "Latin Based" in lg_inclusion_list:
+        ignore_non_latin = True
+        lg_inclusion_list.remove("Latin Based")
+
+    for layer in alpha_unicode_split(decoded_sequence):
+        sequence_frequencies: TypeCounter[str] = Counter(layer)
+        most_common = sequence_frequencies.most_common()
+
+        character_count: int = sum(o for c, o in most_common)
+
+        if character_count <= TOO_SMALL_SEQUENCE:
+            continue
+
+        popular_character_ordered: List[str] = [c for c, o in most_common]
+
+        for language in lg_inclusion_list or alphabet_languages(
+            popular_character_ordered, ignore_non_latin
+        ):
+            ratio: float = characters_popularity_compare(
+                language, popular_character_ordered
+            )
+
+            if ratio < threshold:
+                continue
+            elif ratio >= 0.8:
+                sufficient_match_count += 1
+
+            results.append((language, round(ratio, 4)))
+
+            if sufficient_match_count >= 3:
+                break
+
+    return sorted(
+        filter_alt_coherence_matches(results), key=lambda x: x[1], reverse=True
+    )
diff --git a/llm/Lib/site-packages/charset_normalizer/cli/__init__.py b/llm/Lib/site-packages/charset_normalizer/cli/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..57460cc5c0be860d9fc09fba3e926d8f67a642b9
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer/cli/__init__.py
@@ -0,0 +1,6 @@
+from .__main__ import cli_detect, query_yes_no
+
+__all__ = (
+    "cli_detect",
+    "query_yes_no",
+)
diff --git a/llm/Lib/site-packages/charset_normalizer/cli/__main__.py b/llm/Lib/site-packages/charset_normalizer/cli/__main__.py
new file mode 100644
index 0000000000000000000000000000000000000000..28021223b86e13eb41b18e76fdee750b0421146e
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer/cli/__main__.py
@@ -0,0 +1,296 @@
+import argparse
+import sys
+from json import dumps
+from os.path import abspath, basename, dirname, join, realpath
+from platform import python_version
+from typing import List, Optional
+from unicodedata import unidata_version
+
+import charset_normalizer.md as md_module
+from charset_normalizer import from_fp
+from charset_normalizer.models import CliDetectionResult
+from charset_normalizer.version import __version__
+
+
+def query_yes_no(question: str, default: str = "yes") -> bool:
+    """Ask a yes/no question via input() and return their answer.
+
+    "question" is a string that is presented to the user.
+    "default" is the presumed answer if the user just hits <Enter>.
+        It must be "yes" (the default), "no" or None (meaning
+        an answer is required of the user).
+
+    The "answer" return value is True for "yes" or False for "no".
+
+    Credit goes to (c) https://stackoverflow.com/questions/3041986/apt-command-line-interface-like-yes-no-input
+    """
+    valid = {"yes": True, "y": True, "ye": True, "no": False, "n": False}
+    if default is None:
+        prompt = " [y/n] "
+    elif default == "yes":
+        prompt = " [Y/n] "
+    elif default == "no":
+        prompt = " [y/N] "
+    else:
+        raise ValueError("invalid default answer: '%s'" % default)
+
+    while True:
+        sys.stdout.write(question + prompt)
+        choice = input().lower()
+        if default is not None and choice == "":
+            return valid[default]
+        elif choice in valid:
+            return valid[choice]
+        else:
+            sys.stdout.write("Please respond with 'yes' or 'no' " "(or 'y' or 'n').\n")
+
+
+def cli_detect(argv: Optional[List[str]] = None) -> int:
+    """
+    CLI assistant using ARGV and ArgumentParser
+    :param argv:
+    :return: 0 if everything is fine, anything else equal trouble
+    """
+    parser = argparse.ArgumentParser(
+        description="The Real First Universal Charset Detector. "
+        "Discover originating encoding used on text file. "
+        "Normalize text to unicode."
+    )
+
+    parser.add_argument(
+        "files", type=argparse.FileType("rb"), nargs="+", help="File(s) to be analysed"
+    )
+    parser.add_argument(
+        "-v",
+        "--verbose",
+        action="store_true",
+        default=False,
+        dest="verbose",
+        help="Display complementary information about file if any. "
+        "Stdout will contain logs about the detection process.",
+    )
+    parser.add_argument(
+        "-a",
+        "--with-alternative",
+        action="store_true",
+        default=False,
+        dest="alternatives",
+        help="Output complementary possibilities if any. Top-level JSON WILL be a list.",
+    )
+    parser.add_argument(
+        "-n",
+        "--normalize",
+        action="store_true",
+        default=False,
+        dest="normalize",
+        help="Permit to normalize input file. If not set, program does not write anything.",
+    )
+    parser.add_argument(
+        "-m",
+        "--minimal",
+        action="store_true",
+        default=False,
+        dest="minimal",
+        help="Only output the charset detected to STDOUT. Disabling JSON output.",
+    )
+    parser.add_argument(
+        "-r",
+        "--replace",
+        action="store_true",
+        default=False,
+        dest="replace",
+        help="Replace file when trying to normalize it instead of creating a new one.",
+    )
+    parser.add_argument(
+        "-f",
+        "--force",
+        action="store_true",
+        default=False,
+        dest="force",
+        help="Replace file without asking if you are sure, use this flag with caution.",
+    )
+    parser.add_argument(
+        "-t",
+        "--threshold",
+        action="store",
+        default=0.2,
+        type=float,
+        dest="threshold",
+        help="Define a custom maximum amount of chaos allowed in decoded content. 0. <= chaos <= 1.",
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version="Charset-Normalizer {} - Python {} - Unicode {} - SpeedUp {}".format(
+            __version__,
+            python_version(),
+            unidata_version,
+            "OFF" if md_module.__file__.lower().endswith(".py") else "ON",
+        ),
+        help="Show version information and exit.",
+    )
+
+    args = parser.parse_args(argv)
+
+    if args.replace is True and args.normalize is False:
+        print("Use --replace in addition of --normalize only.", file=sys.stderr)
+        return 1
+
+    if args.force is True and args.replace is False:
+        print("Use --force in addition of --replace only.", file=sys.stderr)
+        return 1
+
+    if args.threshold < 0.0 or args.threshold > 1.0:
+        print("--threshold VALUE should be between 0. AND 1.", file=sys.stderr)
+        return 1
+
+    x_ = []
+
+    for my_file in args.files:
+        matches = from_fp(my_file, threshold=args.threshold, explain=args.verbose)
+
+        best_guess = matches.best()
+
+        if best_guess is None:
+            print(
+                'Unable to identify originating encoding for "{}". {}'.format(
+                    my_file.name,
+                    "Maybe try increasing maximum amount of chaos."
+                    if args.threshold < 1.0
+                    else "",
+                ),
+                file=sys.stderr,
+            )
+            x_.append(
+                CliDetectionResult(
+                    abspath(my_file.name),
+                    None,
+                    [],
+                    [],
+                    "Unknown",
+                    [],
+                    False,
+                    1.0,
+                    0.0,
+                    None,
+                    True,
+                )
+            )
+        else:
+            x_.append(
+                CliDetectionResult(
+                    abspath(my_file.name),
+                    best_guess.encoding,
+                    best_guess.encoding_aliases,
+                    [
+                        cp
+                        for cp in best_guess.could_be_from_charset
+                        if cp != best_guess.encoding
+                    ],
+                    best_guess.language,
+                    best_guess.alphabets,
+                    best_guess.bom,
+                    best_guess.percent_chaos,
+                    best_guess.percent_coherence,
+                    None,
+                    True,
+                )
+            )
+
+            if len(matches) > 1 and args.alternatives:
+                for el in matches:
+                    if el != best_guess:
+                        x_.append(
+                            CliDetectionResult(
+                                abspath(my_file.name),
+                                el.encoding,
+                                el.encoding_aliases,
+                                [
+                                    cp
+                                    for cp in el.could_be_from_charset
+                                    if cp != el.encoding
+                                ],
+                                el.language,
+                                el.alphabets,
+                                el.bom,
+                                el.percent_chaos,
+                                el.percent_coherence,
+                                None,
+                                False,
+                            )
+                        )
+
+            if args.normalize is True:
+                if best_guess.encoding.startswith("utf") is True:
+                    print(
+                        '"{}" file does not need to be normalized, as it already came from unicode.'.format(
+                            my_file.name
+                        ),
+                        file=sys.stderr,
+                    )
+                    if my_file.closed is False:
+                        my_file.close()
+                    continue
+
+                dir_path = dirname(realpath(my_file.name))
+                file_name = basename(realpath(my_file.name))
+
+                o_: List[str] = file_name.split(".")
+
+                if args.replace is False:
+                    o_.insert(-1, best_guess.encoding)
+                    if my_file.closed is False:
+                        my_file.close()
+                elif (
+                    args.force is False
+                    and query_yes_no(
+                        'Are you sure to normalize "{}" by replacing it ?'.format(
+                            my_file.name
+                        ),
+                        "no",
+                    )
+                    is False
+                ):
+                    if my_file.closed is False:
+                        my_file.close()
+                    continue
+
+                try:
+                    x_[0].unicode_path = join(dir_path, ".".join(o_))
+
+                    with open(x_[0].unicode_path, "w", encoding="utf-8") as fp:
+                        fp.write(str(best_guess))
+                except IOError as e:
+                    print(str(e), file=sys.stderr)
+                    if my_file.closed is False:
+                        my_file.close()
+                    return 2
+
+        if my_file.closed is False:
+            my_file.close()
+
+    if args.minimal is False:
+        print(
+            dumps(
+                [el.__dict__ for el in x_] if len(x_) > 1 else x_[0].__dict__,
+                ensure_ascii=True,
+                indent=4,
+            )
+        )
+    else:
+        for my_file in args.files:
+            print(
+                ", ".join(
+                    [
+                        el.encoding or "undefined"
+                        for el in x_
+                        if el.path == abspath(my_file.name)
+                    ]
+                )
+            )
+
+    return 0
+
+
+if __name__ == "__main__":
+    cli_detect()
diff --git a/llm/Lib/site-packages/charset_normalizer/cli/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/charset_normalizer/cli/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7a6b448775d598408bd865ead5ef7f77239f6ab5
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/cli/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/charset_normalizer/cli/__pycache__/__main__.cpython-311.pyc b/llm/Lib/site-packages/charset_normalizer/cli/__pycache__/__main__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ceb03b252cc21b2f615deb744cc358ce13a7895d
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/cli/__pycache__/__main__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/charset_normalizer/constant.py b/llm/Lib/site-packages/charset_normalizer/constant.py
new file mode 100644
index 0000000000000000000000000000000000000000..ac74ff1472487e0eabf773ace6b38d20b9bb6138
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer/constant.py
@@ -0,0 +1,1995 @@
+# -*- coding: utf-8 -*-
+from codecs import BOM_UTF8, BOM_UTF16_BE, BOM_UTF16_LE, BOM_UTF32_BE, BOM_UTF32_LE
+from encodings.aliases import aliases
+from re import IGNORECASE, compile as re_compile
+from typing import Dict, List, Set, Union
+
+# Contain for each eligible encoding a list of/item bytes SIG/BOM
+ENCODING_MARKS: Dict[str, Union[bytes, List[bytes]]] = {
+    "utf_8": BOM_UTF8,
+    "utf_7": [
+        b"\x2b\x2f\x76\x38",
+        b"\x2b\x2f\x76\x39",
+        b"\x2b\x2f\x76\x2b",
+        b"\x2b\x2f\x76\x2f",
+        b"\x2b\x2f\x76\x38\x2d",
+    ],
+    "gb18030": b"\x84\x31\x95\x33",
+    "utf_32": [BOM_UTF32_BE, BOM_UTF32_LE],
+    "utf_16": [BOM_UTF16_BE, BOM_UTF16_LE],
+}
+
+TOO_SMALL_SEQUENCE: int = 32
+TOO_BIG_SEQUENCE: int = int(10e6)
+
+UTF8_MAXIMAL_ALLOCATION: int = 1_112_064
+
+# Up-to-date Unicode ucd/15.0.0
+UNICODE_RANGES_COMBINED: Dict[str, range] = {
+    "Control character": range(32),
+    "Basic Latin": range(32, 128),
+    "Latin-1 Supplement": range(128, 256),
+    "Latin Extended-A": range(256, 384),
+    "Latin Extended-B": range(384, 592),
+    "IPA Extensions": range(592, 688),
+    "Spacing Modifier Letters": range(688, 768),
+    "Combining Diacritical Marks": range(768, 880),
+    "Greek and Coptic": range(880, 1024),
+    "Cyrillic": range(1024, 1280),
+    "Cyrillic Supplement": range(1280, 1328),
+    "Armenian": range(1328, 1424),
+    "Hebrew": range(1424, 1536),
+    "Arabic": range(1536, 1792),
+    "Syriac": range(1792, 1872),
+    "Arabic Supplement": range(1872, 1920),
+    "Thaana": range(1920, 1984),
+    "NKo": range(1984, 2048),
+    "Samaritan": range(2048, 2112),
+    "Mandaic": range(2112, 2144),
+    "Syriac Supplement": range(2144, 2160),
+    "Arabic Extended-B": range(2160, 2208),
+    "Arabic Extended-A": range(2208, 2304),
+    "Devanagari": range(2304, 2432),
+    "Bengali": range(2432, 2560),
+    "Gurmukhi": range(2560, 2688),
+    "Gujarati": range(2688, 2816),
+    "Oriya": range(2816, 2944),
+    "Tamil": range(2944, 3072),
+    "Telugu": range(3072, 3200),
+    "Kannada": range(3200, 3328),
+    "Malayalam": range(3328, 3456),
+    "Sinhala": range(3456, 3584),
+    "Thai": range(3584, 3712),
+    "Lao": range(3712, 3840),
+    "Tibetan": range(3840, 4096),
+    "Myanmar": range(4096, 4256),
+    "Georgian": range(4256, 4352),
+    "Hangul Jamo": range(4352, 4608),
+    "Ethiopic": range(4608, 4992),
+    "Ethiopic Supplement": range(4992, 5024),
+    "Cherokee": range(5024, 5120),
+    "Unified Canadian Aboriginal Syllabics": range(5120, 5760),
+    "Ogham": range(5760, 5792),
+    "Runic": range(5792, 5888),
+    "Tagalog": range(5888, 5920),
+    "Hanunoo": range(5920, 5952),
+    "Buhid": range(5952, 5984),
+    "Tagbanwa": range(5984, 6016),
+    "Khmer": range(6016, 6144),
+    "Mongolian": range(6144, 6320),
+    "Unified Canadian Aboriginal Syllabics Extended": range(6320, 6400),
+    "Limbu": range(6400, 6480),
+    "Tai Le": range(6480, 6528),
+    "New Tai Lue": range(6528, 6624),
+    "Khmer Symbols": range(6624, 6656),
+    "Buginese": range(6656, 6688),
+    "Tai Tham": range(6688, 6832),
+    "Combining Diacritical Marks Extended": range(6832, 6912),
+    "Balinese": range(6912, 7040),
+    "Sundanese": range(7040, 7104),
+    "Batak": range(7104, 7168),
+    "Lepcha": range(7168, 7248),
+    "Ol Chiki": range(7248, 7296),
+    "Cyrillic Extended-C": range(7296, 7312),
+    "Georgian Extended": range(7312, 7360),
+    "Sundanese Supplement": range(7360, 7376),
+    "Vedic Extensions": range(7376, 7424),
+    "Phonetic Extensions": range(7424, 7552),
+    "Phonetic Extensions Supplement": range(7552, 7616),
+    "Combining Diacritical Marks Supplement": range(7616, 7680),
+    "Latin Extended Additional": range(7680, 7936),
+    "Greek Extended": range(7936, 8192),
+    "General Punctuation": range(8192, 8304),
+    "Superscripts and Subscripts": range(8304, 8352),
+    "Currency Symbols": range(8352, 8400),
+    "Combining Diacritical Marks for Symbols": range(8400, 8448),
+    "Letterlike Symbols": range(8448, 8528),
+    "Number Forms": range(8528, 8592),
+    "Arrows": range(8592, 8704),
+    "Mathematical Operators": range(8704, 8960),
+    "Miscellaneous Technical": range(8960, 9216),
+    "Control Pictures": range(9216, 9280),
+    "Optical Character Recognition": range(9280, 9312),
+    "Enclosed Alphanumerics": range(9312, 9472),
+    "Box Drawing": range(9472, 9600),
+    "Block Elements": range(9600, 9632),
+    "Geometric Shapes": range(9632, 9728),
+    "Miscellaneous Symbols": range(9728, 9984),
+    "Dingbats": range(9984, 10176),
+    "Miscellaneous Mathematical Symbols-A": range(10176, 10224),
+    "Supplemental Arrows-A": range(10224, 10240),
+    "Braille Patterns": range(10240, 10496),
+    "Supplemental Arrows-B": range(10496, 10624),
+    "Miscellaneous Mathematical Symbols-B": range(10624, 10752),
+    "Supplemental Mathematical Operators": range(10752, 11008),
+    "Miscellaneous Symbols and Arrows": range(11008, 11264),
+    "Glagolitic": range(11264, 11360),
+    "Latin Extended-C": range(11360, 11392),
+    "Coptic": range(11392, 11520),
+    "Georgian Supplement": range(11520, 11568),
+    "Tifinagh": range(11568, 11648),
+    "Ethiopic Extended": range(11648, 11744),
+    "Cyrillic Extended-A": range(11744, 11776),
+    "Supplemental Punctuation": range(11776, 11904),
+    "CJK Radicals Supplement": range(11904, 12032),
+    "Kangxi Radicals": range(12032, 12256),
+    "Ideographic Description Characters": range(12272, 12288),
+    "CJK Symbols and Punctuation": range(12288, 12352),
+    "Hiragana": range(12352, 12448),
+    "Katakana": range(12448, 12544),
+    "Bopomofo": range(12544, 12592),
+    "Hangul Compatibility Jamo": range(12592, 12688),
+    "Kanbun": range(12688, 12704),
+    "Bopomofo Extended": range(12704, 12736),
+    "CJK Strokes": range(12736, 12784),
+    "Katakana Phonetic Extensions": range(12784, 12800),
+    "Enclosed CJK Letters and Months": range(12800, 13056),
+    "CJK Compatibility": range(13056, 13312),
+    "CJK Unified Ideographs Extension A": range(13312, 19904),
+    "Yijing Hexagram Symbols": range(19904, 19968),
+    "CJK Unified Ideographs": range(19968, 40960),
+    "Yi Syllables": range(40960, 42128),
+    "Yi Radicals": range(42128, 42192),
+    "Lisu": range(42192, 42240),
+    "Vai": range(42240, 42560),
+    "Cyrillic Extended-B": range(42560, 42656),
+    "Bamum": range(42656, 42752),
+    "Modifier Tone Letters": range(42752, 42784),
+    "Latin Extended-D": range(42784, 43008),
+    "Syloti Nagri": range(43008, 43056),
+    "Common Indic Number Forms": range(43056, 43072),
+    "Phags-pa": range(43072, 43136),
+    "Saurashtra": range(43136, 43232),
+    "Devanagari Extended": range(43232, 43264),
+    "Kayah Li": range(43264, 43312),
+    "Rejang": range(43312, 43360),
+    "Hangul Jamo Extended-A": range(43360, 43392),
+    "Javanese": range(43392, 43488),
+    "Myanmar Extended-B": range(43488, 43520),
+    "Cham": range(43520, 43616),
+    "Myanmar Extended-A": range(43616, 43648),
+    "Tai Viet": range(43648, 43744),
+    "Meetei Mayek Extensions": range(43744, 43776),
+    "Ethiopic Extended-A": range(43776, 43824),
+    "Latin Extended-E": range(43824, 43888),
+    "Cherokee Supplement": range(43888, 43968),
+    "Meetei Mayek": range(43968, 44032),
+    "Hangul Syllables": range(44032, 55216),
+    "Hangul Jamo Extended-B": range(55216, 55296),
+    "High Surrogates": range(55296, 56192),
+    "High Private Use Surrogates": range(56192, 56320),
+    "Low Surrogates": range(56320, 57344),
+    "Private Use Area": range(57344, 63744),
+    "CJK Compatibility Ideographs": range(63744, 64256),
+    "Alphabetic Presentation Forms": range(64256, 64336),
+    "Arabic Presentation Forms-A": range(64336, 65024),
+    "Variation Selectors": range(65024, 65040),
+    "Vertical Forms": range(65040, 65056),
+    "Combining Half Marks": range(65056, 65072),
+    "CJK Compatibility Forms": range(65072, 65104),
+    "Small Form Variants": range(65104, 65136),
+    "Arabic Presentation Forms-B": range(65136, 65280),
+    "Halfwidth and Fullwidth Forms": range(65280, 65520),
+    "Specials": range(65520, 65536),
+    "Linear B Syllabary": range(65536, 65664),
+    "Linear B Ideograms": range(65664, 65792),
+    "Aegean Numbers": range(65792, 65856),
+    "Ancient Greek Numbers": range(65856, 65936),
+    "Ancient Symbols": range(65936, 66000),
+    "Phaistos Disc": range(66000, 66048),
+    "Lycian": range(66176, 66208),
+    "Carian": range(66208, 66272),
+    "Coptic Epact Numbers": range(66272, 66304),
+    "Old Italic": range(66304, 66352),
+    "Gothic": range(66352, 66384),
+    "Old Permic": range(66384, 66432),
+    "Ugaritic": range(66432, 66464),
+    "Old Persian": range(66464, 66528),
+    "Deseret": range(66560, 66640),
+    "Shavian": range(66640, 66688),
+    "Osmanya": range(66688, 66736),
+    "Osage": range(66736, 66816),
+    "Elbasan": range(66816, 66864),
+    "Caucasian Albanian": range(66864, 66928),
+    "Vithkuqi": range(66928, 67008),
+    "Linear A": range(67072, 67456),
+    "Latin Extended-F": range(67456, 67520),
+    "Cypriot Syllabary": range(67584, 67648),
+    "Imperial Aramaic": range(67648, 67680),
+    "Palmyrene": range(67680, 67712),
+    "Nabataean": range(67712, 67760),
+    "Hatran": range(67808, 67840),
+    "Phoenician": range(67840, 67872),
+    "Lydian": range(67872, 67904),
+    "Meroitic Hieroglyphs": range(67968, 68000),
+    "Meroitic Cursive": range(68000, 68096),
+    "Kharoshthi": range(68096, 68192),
+    "Old South Arabian": range(68192, 68224),
+    "Old North Arabian": range(68224, 68256),
+    "Manichaean": range(68288, 68352),
+    "Avestan": range(68352, 68416),
+    "Inscriptional Parthian": range(68416, 68448),
+    "Inscriptional Pahlavi": range(68448, 68480),
+    "Psalter Pahlavi": range(68480, 68528),
+    "Old Turkic": range(68608, 68688),
+    "Old Hungarian": range(68736, 68864),
+    "Hanifi Rohingya": range(68864, 68928),
+    "Rumi Numeral Symbols": range(69216, 69248),
+    "Yezidi": range(69248, 69312),
+    "Arabic Extended-C": range(69312, 69376),
+    "Old Sogdian": range(69376, 69424),
+    "Sogdian": range(69424, 69488),
+    "Old Uyghur": range(69488, 69552),
+    "Chorasmian": range(69552, 69600),
+    "Elymaic": range(69600, 69632),
+    "Brahmi": range(69632, 69760),
+    "Kaithi": range(69760, 69840),
+    "Sora Sompeng": range(69840, 69888),
+    "Chakma": range(69888, 69968),
+    "Mahajani": range(69968, 70016),
+    "Sharada": range(70016, 70112),
+    "Sinhala Archaic Numbers": range(70112, 70144),
+    "Khojki": range(70144, 70224),
+    "Multani": range(70272, 70320),
+    "Khudawadi": range(70320, 70400),
+    "Grantha": range(70400, 70528),
+    "Newa": range(70656, 70784),
+    "Tirhuta": range(70784, 70880),
+    "Siddham": range(71040, 71168),
+    "Modi": range(71168, 71264),
+    "Mongolian Supplement": range(71264, 71296),
+    "Takri": range(71296, 71376),
+    "Ahom": range(71424, 71504),
+    "Dogra": range(71680, 71760),
+    "Warang Citi": range(71840, 71936),
+    "Dives Akuru": range(71936, 72032),
+    "Nandinagari": range(72096, 72192),
+    "Zanabazar Square": range(72192, 72272),
+    "Soyombo": range(72272, 72368),
+    "Unified Canadian Aboriginal Syllabics Extended-A": range(72368, 72384),
+    "Pau Cin Hau": range(72384, 72448),
+    "Devanagari Extended-A": range(72448, 72544),
+    "Bhaiksuki": range(72704, 72816),
+    "Marchen": range(72816, 72896),
+    "Masaram Gondi": range(72960, 73056),
+    "Gunjala Gondi": range(73056, 73136),
+    "Makasar": range(73440, 73472),
+    "Kawi": range(73472, 73568),
+    "Lisu Supplement": range(73648, 73664),
+    "Tamil Supplement": range(73664, 73728),
+    "Cuneiform": range(73728, 74752),
+    "Cuneiform Numbers and Punctuation": range(74752, 74880),
+    "Early Dynastic Cuneiform": range(74880, 75088),
+    "Cypro-Minoan": range(77712, 77824),
+    "Egyptian Hieroglyphs": range(77824, 78896),
+    "Egyptian Hieroglyph Format Controls": range(78896, 78944),
+    "Anatolian Hieroglyphs": range(82944, 83584),
+    "Bamum Supplement": range(92160, 92736),
+    "Mro": range(92736, 92784),
+    "Tangsa": range(92784, 92880),
+    "Bassa Vah": range(92880, 92928),
+    "Pahawh Hmong": range(92928, 93072),
+    "Medefaidrin": range(93760, 93856),
+    "Miao": range(93952, 94112),
+    "Ideographic Symbols and Punctuation": range(94176, 94208),
+    "Tangut": range(94208, 100352),
+    "Tangut Components": range(100352, 101120),
+    "Khitan Small Script": range(101120, 101632),
+    "Tangut Supplement": range(101632, 101760),
+    "Kana Extended-B": range(110576, 110592),
+    "Kana Supplement": range(110592, 110848),
+    "Kana Extended-A": range(110848, 110896),
+    "Small Kana Extension": range(110896, 110960),
+    "Nushu": range(110960, 111360),
+    "Duployan": range(113664, 113824),
+    "Shorthand Format Controls": range(113824, 113840),
+    "Znamenny Musical Notation": range(118528, 118736),
+    "Byzantine Musical Symbols": range(118784, 119040),
+    "Musical Symbols": range(119040, 119296),
+    "Ancient Greek Musical Notation": range(119296, 119376),
+    "Kaktovik Numerals": range(119488, 119520),
+    "Mayan Numerals": range(119520, 119552),
+    "Tai Xuan Jing Symbols": range(119552, 119648),
+    "Counting Rod Numerals": range(119648, 119680),
+    "Mathematical Alphanumeric Symbols": range(119808, 120832),
+    "Sutton SignWriting": range(120832, 121520),
+    "Latin Extended-G": range(122624, 122880),
+    "Glagolitic Supplement": range(122880, 122928),
+    "Cyrillic Extended-D": range(122928, 123024),
+    "Nyiakeng Puachue Hmong": range(123136, 123216),
+    "Toto": range(123536, 123584),
+    "Wancho": range(123584, 123648),
+    "Nag Mundari": range(124112, 124160),
+    "Ethiopic Extended-B": range(124896, 124928),
+    "Mende Kikakui": range(124928, 125152),
+    "Adlam": range(125184, 125280),
+    "Indic Siyaq Numbers": range(126064, 126144),
+    "Ottoman Siyaq Numbers": range(126208, 126288),
+    "Arabic Mathematical Alphabetic Symbols": range(126464, 126720),
+    "Mahjong Tiles": range(126976, 127024),
+    "Domino Tiles": range(127024, 127136),
+    "Playing Cards": range(127136, 127232),
+    "Enclosed Alphanumeric Supplement": range(127232, 127488),
+    "Enclosed Ideographic Supplement": range(127488, 127744),
+    "Miscellaneous Symbols and Pictographs": range(127744, 128512),
+    "Emoticons range(Emoji)": range(128512, 128592),
+    "Ornamental Dingbats": range(128592, 128640),
+    "Transport and Map Symbols": range(128640, 128768),
+    "Alchemical Symbols": range(128768, 128896),
+    "Geometric Shapes Extended": range(128896, 129024),
+    "Supplemental Arrows-C": range(129024, 129280),
+    "Supplemental Symbols and Pictographs": range(129280, 129536),
+    "Chess Symbols": range(129536, 129648),
+    "Symbols and Pictographs Extended-A": range(129648, 129792),
+    "Symbols for Legacy Computing": range(129792, 130048),
+    "CJK Unified Ideographs Extension B": range(131072, 173792),
+    "CJK Unified Ideographs Extension C": range(173824, 177984),
+    "CJK Unified Ideographs Extension D": range(177984, 178208),
+    "CJK Unified Ideographs Extension E": range(178208, 183984),
+    "CJK Unified Ideographs Extension F": range(183984, 191472),
+    "CJK Compatibility Ideographs Supplement": range(194560, 195104),
+    "CJK Unified Ideographs Extension G": range(196608, 201552),
+    "CJK Unified Ideographs Extension H": range(201552, 205744),
+    "Tags": range(917504, 917632),
+    "Variation Selectors Supplement": range(917760, 918000),
+    "Supplementary Private Use Area-A": range(983040, 1048576),
+    "Supplementary Private Use Area-B": range(1048576, 1114112),
+}
+
+
+UNICODE_SECONDARY_RANGE_KEYWORD: List[str] = [
+    "Supplement",
+    "Extended",
+    "Extensions",
+    "Modifier",
+    "Marks",
+    "Punctuation",
+    "Symbols",
+    "Forms",
+    "Operators",
+    "Miscellaneous",
+    "Drawing",
+    "Block",
+    "Shapes",
+    "Supplemental",
+    "Tags",
+]
+
+RE_POSSIBLE_ENCODING_INDICATION = re_compile(
+    r"(?:(?:encoding)|(?:charset)|(?:coding))(?:[\:= ]{1,10})(?:[\"\']?)([a-zA-Z0-9\-_]+)(?:[\"\']?)",
+    IGNORECASE,
+)
+
+IANA_NO_ALIASES = [
+    "cp720",
+    "cp737",
+    "cp856",
+    "cp874",
+    "cp875",
+    "cp1006",
+    "koi8_r",
+    "koi8_t",
+    "koi8_u",
+]
+
+IANA_SUPPORTED: List[str] = sorted(
+    filter(
+        lambda x: x.endswith("_codec") is False
+        and x not in {"rot_13", "tactis", "mbcs"},
+        list(set(aliases.values())) + IANA_NO_ALIASES,
+    )
+)
+
+IANA_SUPPORTED_COUNT: int = len(IANA_SUPPORTED)
+
+# pre-computed code page that are similar using the function cp_similarity.
+IANA_SUPPORTED_SIMILAR: Dict[str, List[str]] = {
+    "cp037": ["cp1026", "cp1140", "cp273", "cp500"],
+    "cp1026": ["cp037", "cp1140", "cp273", "cp500"],
+    "cp1125": ["cp866"],
+    "cp1140": ["cp037", "cp1026", "cp273", "cp500"],
+    "cp1250": ["iso8859_2"],
+    "cp1251": ["kz1048", "ptcp154"],
+    "cp1252": ["iso8859_15", "iso8859_9", "latin_1"],
+    "cp1253": ["iso8859_7"],
+    "cp1254": ["iso8859_15", "iso8859_9", "latin_1"],
+    "cp1257": ["iso8859_13"],
+    "cp273": ["cp037", "cp1026", "cp1140", "cp500"],
+    "cp437": ["cp850", "cp858", "cp860", "cp861", "cp862", "cp863", "cp865"],
+    "cp500": ["cp037", "cp1026", "cp1140", "cp273"],
+    "cp850": ["cp437", "cp857", "cp858", "cp865"],
+    "cp857": ["cp850", "cp858", "cp865"],
+    "cp858": ["cp437", "cp850", "cp857", "cp865"],
+    "cp860": ["cp437", "cp861", "cp862", "cp863", "cp865"],
+    "cp861": ["cp437", "cp860", "cp862", "cp863", "cp865"],
+    "cp862": ["cp437", "cp860", "cp861", "cp863", "cp865"],
+    "cp863": ["cp437", "cp860", "cp861", "cp862", "cp865"],
+    "cp865": ["cp437", "cp850", "cp857", "cp858", "cp860", "cp861", "cp862", "cp863"],
+    "cp866": ["cp1125"],
+    "iso8859_10": ["iso8859_14", "iso8859_15", "iso8859_4", "iso8859_9", "latin_1"],
+    "iso8859_11": ["tis_620"],
+    "iso8859_13": ["cp1257"],
+    "iso8859_14": [
+        "iso8859_10",
+        "iso8859_15",
+        "iso8859_16",
+        "iso8859_3",
+        "iso8859_9",
+        "latin_1",
+    ],
+    "iso8859_15": [
+        "cp1252",
+        "cp1254",
+        "iso8859_10",
+        "iso8859_14",
+        "iso8859_16",
+        "iso8859_3",
+        "iso8859_9",
+        "latin_1",
+    ],
+    "iso8859_16": [
+        "iso8859_14",
+        "iso8859_15",
+        "iso8859_2",
+        "iso8859_3",
+        "iso8859_9",
+        "latin_1",
+    ],
+    "iso8859_2": ["cp1250", "iso8859_16", "iso8859_4"],
+    "iso8859_3": ["iso8859_14", "iso8859_15", "iso8859_16", "iso8859_9", "latin_1"],
+    "iso8859_4": ["iso8859_10", "iso8859_2", "iso8859_9", "latin_1"],
+    "iso8859_7": ["cp1253"],
+    "iso8859_9": [
+        "cp1252",
+        "cp1254",
+        "cp1258",
+        "iso8859_10",
+        "iso8859_14",
+        "iso8859_15",
+        "iso8859_16",
+        "iso8859_3",
+        "iso8859_4",
+        "latin_1",
+    ],
+    "kz1048": ["cp1251", "ptcp154"],
+    "latin_1": [
+        "cp1252",
+        "cp1254",
+        "cp1258",
+        "iso8859_10",
+        "iso8859_14",
+        "iso8859_15",
+        "iso8859_16",
+        "iso8859_3",
+        "iso8859_4",
+        "iso8859_9",
+    ],
+    "mac_iceland": ["mac_roman", "mac_turkish"],
+    "mac_roman": ["mac_iceland", "mac_turkish"],
+    "mac_turkish": ["mac_iceland", "mac_roman"],
+    "ptcp154": ["cp1251", "kz1048"],
+    "tis_620": ["iso8859_11"],
+}
+
+
+CHARDET_CORRESPONDENCE: Dict[str, str] = {
+    "iso2022_kr": "ISO-2022-KR",
+    "iso2022_jp": "ISO-2022-JP",
+    "euc_kr": "EUC-KR",
+    "tis_620": "TIS-620",
+    "utf_32": "UTF-32",
+    "euc_jp": "EUC-JP",
+    "koi8_r": "KOI8-R",
+    "iso8859_1": "ISO-8859-1",
+    "iso8859_2": "ISO-8859-2",
+    "iso8859_5": "ISO-8859-5",
+    "iso8859_6": "ISO-8859-6",
+    "iso8859_7": "ISO-8859-7",
+    "iso8859_8": "ISO-8859-8",
+    "utf_16": "UTF-16",
+    "cp855": "IBM855",
+    "mac_cyrillic": "MacCyrillic",
+    "gb2312": "GB2312",
+    "gb18030": "GB18030",
+    "cp932": "CP932",
+    "cp866": "IBM866",
+    "utf_8": "utf-8",
+    "utf_8_sig": "UTF-8-SIG",
+    "shift_jis": "SHIFT_JIS",
+    "big5": "Big5",
+    "cp1250": "windows-1250",
+    "cp1251": "windows-1251",
+    "cp1252": "Windows-1252",
+    "cp1253": "windows-1253",
+    "cp1255": "windows-1255",
+    "cp1256": "windows-1256",
+    "cp1254": "Windows-1254",
+    "cp949": "CP949",
+}
+
+
+COMMON_SAFE_ASCII_CHARACTERS: Set[str] = {
+    "<",
+    ">",
+    "=",
+    ":",
+    "/",
+    "&",
+    ";",
+    "{",
+    "}",
+    "[",
+    "]",
+    ",",
+    "|",
+    '"',
+    "-",
+}
+
+
+KO_NAMES: Set[str] = {"johab", "cp949", "euc_kr"}
+ZH_NAMES: Set[str] = {"big5", "cp950", "big5hkscs", "hz"}
+
+# Logging LEVEL below DEBUG
+TRACE: int = 5
+
+
+# Language label that contain the em dash "—"
+# character are to be considered alternative seq to origin
+FREQUENCIES: Dict[str, List[str]] = {
+    "English": [
+        "e",
+        "a",
+        "t",
+        "i",
+        "o",
+        "n",
+        "s",
+        "r",
+        "h",
+        "l",
+        "d",
+        "c",
+        "u",
+        "m",
+        "f",
+        "p",
+        "g",
+        "w",
+        "y",
+        "b",
+        "v",
+        "k",
+        "x",
+        "j",
+        "z",
+        "q",
+    ],
+    "English—": [
+        "e",
+        "a",
+        "t",
+        "i",
+        "o",
+        "n",
+        "s",
+        "r",
+        "h",
+        "l",
+        "d",
+        "c",
+        "m",
+        "u",
+        "f",
+        "p",
+        "g",
+        "w",
+        "b",
+        "y",
+        "v",
+        "k",
+        "j",
+        "x",
+        "z",
+        "q",
+    ],
+    "German": [
+        "e",
+        "n",
+        "i",
+        "r",
+        "s",
+        "t",
+        "a",
+        "d",
+        "h",
+        "u",
+        "l",
+        "g",
+        "o",
+        "c",
+        "m",
+        "b",
+        "f",
+        "k",
+        "w",
+        "z",
+        "p",
+        "v",
+        "ü",
+        "ä",
+        "ö",
+        "j",
+    ],
+    "French": [
+        "e",
+        "a",
+        "s",
+        "n",
+        "i",
+        "t",
+        "r",
+        "l",
+        "u",
+        "o",
+        "d",
+        "c",
+        "p",
+        "m",
+        "é",
+        "v",
+        "g",
+        "f",
+        "b",
+        "h",
+        "q",
+        "à",
+        "x",
+        "è",
+        "y",
+        "j",
+    ],
+    "Dutch": [
+        "e",
+        "n",
+        "a",
+        "i",
+        "r",
+        "t",
+        "o",
+        "d",
+        "s",
+        "l",
+        "g",
+        "h",
+        "v",
+        "m",
+        "u",
+        "k",
+        "c",
+        "p",
+        "b",
+        "w",
+        "j",
+        "z",
+        "f",
+        "y",
+        "x",
+        "ë",
+    ],
+    "Italian": [
+        "e",
+        "i",
+        "a",
+        "o",
+        "n",
+        "l",
+        "t",
+        "r",
+        "s",
+        "c",
+        "d",
+        "u",
+        "p",
+        "m",
+        "g",
+        "v",
+        "f",
+        "b",
+        "z",
+        "h",
+        "q",
+        "è",
+        "à",
+        "k",
+        "y",
+        "ò",
+    ],
+    "Polish": [
+        "a",
+        "i",
+        "o",
+        "e",
+        "n",
+        "r",
+        "z",
+        "w",
+        "s",
+        "c",
+        "t",
+        "k",
+        "y",
+        "d",
+        "p",
+        "m",
+        "u",
+        "l",
+        "j",
+        "ł",
+        "g",
+        "b",
+        "h",
+        "ą",
+        "ę",
+        "ó",
+    ],
+    "Spanish": [
+        "e",
+        "a",
+        "o",
+        "n",
+        "s",
+        "r",
+        "i",
+        "l",
+        "d",
+        "t",
+        "c",
+        "u",
+        "m",
+        "p",
+        "b",
+        "g",
+        "v",
+        "f",
+        "y",
+        "ó",
+        "h",
+        "q",
+        "í",
+        "j",
+        "z",
+        "á",
+    ],
+    "Russian": [
+        "о",
+        "а",
+        "е",
+        "и",
+        "н",
+        "с",
+        "т",
+        "р",
+        "в",
+        "л",
+        "к",
+        "м",
+        "д",
+        "п",
+        "у",
+        "г",
+        "я",
+        "ы",
+        "з",
+        "б",
+        "й",
+        "ь",
+        "ч",
+        "х",
+        "ж",
+        "ц",
+    ],
+    # Jap-Kanji
+    "Japanese": [
+        "人",
+        "一",
+        "大",
+        "亅",
+        "丁",
+        "丨",
+        "竹",
+        "笑",
+        "口",
+        "日",
+        "今",
+        "二",
+        "彳",
+        "行",
+        "十",
+        "土",
+        "丶",
+        "寸",
+        "寺",
+        "時",
+        "乙",
+        "丿",
+        "乂",
+        "气",
+        "気",
+        "冂",
+        "巾",
+        "亠",
+        "市",
+        "目",
+        "儿",
+        "見",
+        "八",
+        "小",
+        "凵",
+        "県",
+        "月",
+        "彐",
+        "門",
+        "間",
+        "木",
+        "東",
+        "山",
+        "出",
+        "本",
+        "中",
+        "刀",
+        "分",
+        "耳",
+        "又",
+        "取",
+        "最",
+        "言",
+        "田",
+        "心",
+        "思",
+        "刂",
+        "前",
+        "京",
+        "尹",
+        "事",
+        "生",
+        "厶",
+        "云",
+        "会",
+        "未",
+        "来",
+        "白",
+        "冫",
+        "楽",
+        "灬",
+        "馬",
+        "尸",
+        "尺",
+        "駅",
+        "明",
+        "耂",
+        "者",
+        "了",
+        "阝",
+        "都",
+        "高",
+        "卜",
+        "占",
+        "厂",
+        "广",
+        "店",
+        "子",
+        "申",
+        "奄",
+        "亻",
+        "俺",
+        "上",
+        "方",
+        "冖",
+        "学",
+        "衣",
+        "艮",
+        "食",
+        "自",
+    ],
+    # Jap-Katakana
+    "Japanese—": [
+        "ー",
+        "ン",
+        "ス",
+        "・",
+        "ル",
+        "ト",
+        "リ",
+        "イ",
+        "ア",
+        "ラ",
+        "ッ",
+        "ク",
+        "ド",
+        "シ",
+        "レ",
+        "ジ",
+        "タ",
+        "フ",
+        "ロ",
+        "カ",
+        "テ",
+        "マ",
+        "ィ",
+        "グ",
+        "バ",
+        "ム",
+        "プ",
+        "オ",
+        "コ",
+        "デ",
+        "ニ",
+        "ウ",
+        "メ",
+        "サ",
+        "ビ",
+        "ナ",
+        "ブ",
+        "ャ",
+        "エ",
+        "ュ",
+        "チ",
+        "キ",
+        "ズ",
+        "ダ",
+        "パ",
+        "ミ",
+        "ェ",
+        "ョ",
+        "ハ",
+        "セ",
+        "ベ",
+        "ガ",
+        "モ",
+        "ツ",
+        "ネ",
+        "ボ",
+        "ソ",
+        "ノ",
+        "ァ",
+        "ヴ",
+        "ワ",
+        "ポ",
+        "ペ",
+        "ピ",
+        "ケ",
+        "ゴ",
+        "ギ",
+        "ザ",
+        "ホ",
+        "ゲ",
+        "ォ",
+        "ヤ",
+        "ヒ",
+        "ユ",
+        "ヨ",
+        "ヘ",
+        "ゼ",
+        "ヌ",
+        "ゥ",
+        "ゾ",
+        "ヶ",
+        "ヂ",
+        "ヲ",
+        "ヅ",
+        "ヵ",
+        "ヱ",
+        "ヰ",
+        "ヮ",
+        "ヽ",
+        "゠",
+        "ヾ",
+        "ヷ",
+        "ヿ",
+        "ヸ",
+        "ヹ",
+        "ヺ",
+    ],
+    # Jap-Hiragana
+    "Japanese——": [
+        "の",
+        "に",
+        "る",
+        "た",
+        "と",
+        "は",
+        "し",
+        "い",
+        "を",
+        "で",
+        "て",
+        "が",
+        "な",
+        "れ",
+        "か",
+        "ら",
+        "さ",
+        "っ",
+        "り",
+        "す",
+        "あ",
+        "も",
+        "こ",
+        "ま",
+        "う",
+        "く",
+        "よ",
+        "き",
+        "ん",
+        "め",
+        "お",
+        "け",
+        "そ",
+        "つ",
+        "だ",
+        "や",
+        "え",
+        "ど",
+        "わ",
+        "ち",
+        "み",
+        "せ",
+        "じ",
+        "ば",
+        "へ",
+        "び",
+        "ず",
+        "ろ",
+        "ほ",
+        "げ",
+        "む",
+        "べ",
+        "ひ",
+        "ょ",
+        "ゆ",
+        "ぶ",
+        "ご",
+        "ゃ",
+        "ね",
+        "ふ",
+        "ぐ",
+        "ぎ",
+        "ぼ",
+        "ゅ",
+        "づ",
+        "ざ",
+        "ぞ",
+        "ぬ",
+        "ぜ",
+        "ぱ",
+        "ぽ",
+        "ぷ",
+        "ぴ",
+        "ぃ",
+        "ぁ",
+        "ぇ",
+        "ぺ",
+        "ゞ",
+        "ぢ",
+        "ぉ",
+        "ぅ",
+        "ゐ",
+        "ゝ",
+        "ゑ",
+        "゛",
+        "゜",
+        "ゎ",
+        "ゔ",
+        "゚",
+        "ゟ",
+        "゙",
+        "ゕ",
+        "ゖ",
+    ],
+    "Portuguese": [
+        "a",
+        "e",
+        "o",
+        "s",
+        "i",
+        "r",
+        "d",
+        "n",
+        "t",
+        "m",
+        "u",
+        "c",
+        "l",
+        "p",
+        "g",
+        "v",
+        "b",
+        "f",
+        "h",
+        "ã",
+        "q",
+        "é",
+        "ç",
+        "á",
+        "z",
+        "í",
+    ],
+    "Swedish": [
+        "e",
+        "a",
+        "n",
+        "r",
+        "t",
+        "s",
+        "i",
+        "l",
+        "d",
+        "o",
+        "m",
+        "k",
+        "g",
+        "v",
+        "h",
+        "f",
+        "u",
+        "p",
+        "ä",
+        "c",
+        "b",
+        "ö",
+        "å",
+        "y",
+        "j",
+        "x",
+    ],
+    "Chinese": [
+        "的",
+        "一",
+        "是",
+        "不",
+        "了",
+        "在",
+        "人",
+        "有",
+        "我",
+        "他",
+        "这",
+        "个",
+        "们",
+        "中",
+        "来",
+        "上",
+        "大",
+        "为",
+        "和",
+        "国",
+        "地",
+        "到",
+        "以",
+        "说",
+        "时",
+        "要",
+        "就",
+        "出",
+        "会",
+        "可",
+        "也",
+        "你",
+        "对",
+        "生",
+        "能",
+        "而",
+        "子",
+        "那",
+        "得",
+        "于",
+        "着",
+        "下",
+        "自",
+        "之",
+        "年",
+        "过",
+        "发",
+        "后",
+        "作",
+        "里",
+        "用",
+        "道",
+        "行",
+        "所",
+        "然",
+        "家",
+        "种",
+        "事",
+        "成",
+        "方",
+        "多",
+        "经",
+        "么",
+        "去",
+        "法",
+        "学",
+        "如",
+        "都",
+        "同",
+        "现",
+        "当",
+        "没",
+        "动",
+        "面",
+        "起",
+        "看",
+        "定",
+        "天",
+        "分",
+        "还",
+        "进",
+        "好",
+        "小",
+        "部",
+        "其",
+        "些",
+        "主",
+        "样",
+        "理",
+        "心",
+        "她",
+        "本",
+        "前",
+        "开",
+        "但",
+        "因",
+        "只",
+        "从",
+        "想",
+        "实",
+    ],
+    "Ukrainian": [
+        "о",
+        "а",
+        "н",
+        "і",
+        "и",
+        "р",
+        "в",
+        "т",
+        "е",
+        "с",
+        "к",
+        "л",
+        "у",
+        "д",
+        "м",
+        "п",
+        "з",
+        "я",
+        "ь",
+        "б",
+        "г",
+        "й",
+        "ч",
+        "х",
+        "ц",
+        "ї",
+    ],
+    "Norwegian": [
+        "e",
+        "r",
+        "n",
+        "t",
+        "a",
+        "s",
+        "i",
+        "o",
+        "l",
+        "d",
+        "g",
+        "k",
+        "m",
+        "v",
+        "f",
+        "p",
+        "u",
+        "b",
+        "h",
+        "å",
+        "y",
+        "j",
+        "ø",
+        "c",
+        "æ",
+        "w",
+    ],
+    "Finnish": [
+        "a",
+        "i",
+        "n",
+        "t",
+        "e",
+        "s",
+        "l",
+        "o",
+        "u",
+        "k",
+        "ä",
+        "m",
+        "r",
+        "v",
+        "j",
+        "h",
+        "p",
+        "y",
+        "d",
+        "ö",
+        "g",
+        "c",
+        "b",
+        "f",
+        "w",
+        "z",
+    ],
+    "Vietnamese": [
+        "n",
+        "h",
+        "t",
+        "i",
+        "c",
+        "g",
+        "a",
+        "o",
+        "u",
+        "m",
+        "l",
+        "r",
+        "à",
+        "đ",
+        "s",
+        "e",
+        "v",
+        "p",
+        "b",
+        "y",
+        "ư",
+        "d",
+        "á",
+        "k",
+        "ộ",
+        "ế",
+    ],
+    "Czech": [
+        "o",
+        "e",
+        "a",
+        "n",
+        "t",
+        "s",
+        "i",
+        "l",
+        "v",
+        "r",
+        "k",
+        "d",
+        "u",
+        "m",
+        "p",
+        "í",
+        "c",
+        "h",
+        "z",
+        "á",
+        "y",
+        "j",
+        "b",
+        "ě",
+        "é",
+        "ř",
+    ],
+    "Hungarian": [
+        "e",
+        "a",
+        "t",
+        "l",
+        "s",
+        "n",
+        "k",
+        "r",
+        "i",
+        "o",
+        "z",
+        "á",
+        "é",
+        "g",
+        "m",
+        "b",
+        "y",
+        "v",
+        "d",
+        "h",
+        "u",
+        "p",
+        "j",
+        "ö",
+        "f",
+        "c",
+    ],
+    "Korean": [
+        "이",
+        "다",
+        "에",
+        "의",
+        "는",
+        "로",
+        "하",
+        "을",
+        "가",
+        "고",
+        "지",
+        "서",
+        "한",
+        "은",
+        "기",
+        "으",
+        "년",
+        "대",
+        "사",
+        "시",
+        "를",
+        "리",
+        "도",
+        "인",
+        "스",
+        "일",
+    ],
+    "Indonesian": [
+        "a",
+        "n",
+        "e",
+        "i",
+        "r",
+        "t",
+        "u",
+        "s",
+        "d",
+        "k",
+        "m",
+        "l",
+        "g",
+        "p",
+        "b",
+        "o",
+        "h",
+        "y",
+        "j",
+        "c",
+        "w",
+        "f",
+        "v",
+        "z",
+        "x",
+        "q",
+    ],
+    "Turkish": [
+        "a",
+        "e",
+        "i",
+        "n",
+        "r",
+        "l",
+        "ı",
+        "k",
+        "d",
+        "t",
+        "s",
+        "m",
+        "y",
+        "u",
+        "o",
+        "b",
+        "ü",
+        "ş",
+        "v",
+        "g",
+        "z",
+        "h",
+        "c",
+        "p",
+        "ç",
+        "ğ",
+    ],
+    "Romanian": [
+        "e",
+        "i",
+        "a",
+        "r",
+        "n",
+        "t",
+        "u",
+        "l",
+        "o",
+        "c",
+        "s",
+        "d",
+        "p",
+        "m",
+        "ă",
+        "f",
+        "v",
+        "î",
+        "g",
+        "b",
+        "ș",
+        "ț",
+        "z",
+        "h",
+        "â",
+        "j",
+    ],
+    "Farsi": [
+        "ا",
+        "ی",
+        "ر",
+        "د",
+        "ن",
+        "ه",
+        "و",
+        "م",
+        "ت",
+        "ب",
+        "س",
+        "ل",
+        "ک",
+        "ش",
+        "ز",
+        "ف",
+        "گ",
+        "ع",
+        "خ",
+        "ق",
+        "ج",
+        "آ",
+        "پ",
+        "ح",
+        "ط",
+        "ص",
+    ],
+    "Arabic": [
+        "ا",
+        "ل",
+        "ي",
+        "م",
+        "و",
+        "ن",
+        "ر",
+        "ت",
+        "ب",
+        "ة",
+        "ع",
+        "د",
+        "س",
+        "ف",
+        "ه",
+        "ك",
+        "ق",
+        "أ",
+        "ح",
+        "ج",
+        "ش",
+        "ط",
+        "ص",
+        "ى",
+        "خ",
+        "إ",
+    ],
+    "Danish": [
+        "e",
+        "r",
+        "n",
+        "t",
+        "a",
+        "i",
+        "s",
+        "d",
+        "l",
+        "o",
+        "g",
+        "m",
+        "k",
+        "f",
+        "v",
+        "u",
+        "b",
+        "h",
+        "p",
+        "å",
+        "y",
+        "ø",
+        "æ",
+        "c",
+        "j",
+        "w",
+    ],
+    "Serbian": [
+        "а",
+        "и",
+        "о",
+        "е",
+        "н",
+        "р",
+        "с",
+        "у",
+        "т",
+        "к",
+        "ј",
+        "в",
+        "д",
+        "м",
+        "п",
+        "л",
+        "г",
+        "з",
+        "б",
+        "a",
+        "i",
+        "e",
+        "o",
+        "n",
+        "ц",
+        "ш",
+    ],
+    "Lithuanian": [
+        "i",
+        "a",
+        "s",
+        "o",
+        "r",
+        "e",
+        "t",
+        "n",
+        "u",
+        "k",
+        "m",
+        "l",
+        "p",
+        "v",
+        "d",
+        "j",
+        "g",
+        "ė",
+        "b",
+        "y",
+        "ų",
+        "š",
+        "ž",
+        "c",
+        "ą",
+        "į",
+    ],
+    "Slovene": [
+        "e",
+        "a",
+        "i",
+        "o",
+        "n",
+        "r",
+        "s",
+        "l",
+        "t",
+        "j",
+        "v",
+        "k",
+        "d",
+        "p",
+        "m",
+        "u",
+        "z",
+        "b",
+        "g",
+        "h",
+        "č",
+        "c",
+        "š",
+        "ž",
+        "f",
+        "y",
+    ],
+    "Slovak": [
+        "o",
+        "a",
+        "e",
+        "n",
+        "i",
+        "r",
+        "v",
+        "t",
+        "s",
+        "l",
+        "k",
+        "d",
+        "m",
+        "p",
+        "u",
+        "c",
+        "h",
+        "j",
+        "b",
+        "z",
+        "á",
+        "y",
+        "ý",
+        "í",
+        "č",
+        "é",
+    ],
+    "Hebrew": [
+        "י",
+        "ו",
+        "ה",
+        "ל",
+        "ר",
+        "ב",
+        "ת",
+        "מ",
+        "א",
+        "ש",
+        "נ",
+        "ע",
+        "ם",
+        "ד",
+        "ק",
+        "ח",
+        "פ",
+        "ס",
+        "כ",
+        "ג",
+        "ט",
+        "צ",
+        "ן",
+        "ז",
+        "ך",
+    ],
+    "Bulgarian": [
+        "а",
+        "и",
+        "о",
+        "е",
+        "н",
+        "т",
+        "р",
+        "с",
+        "в",
+        "л",
+        "к",
+        "д",
+        "п",
+        "м",
+        "з",
+        "г",
+        "я",
+        "ъ",
+        "у",
+        "б",
+        "ч",
+        "ц",
+        "й",
+        "ж",
+        "щ",
+        "х",
+    ],
+    "Croatian": [
+        "a",
+        "i",
+        "o",
+        "e",
+        "n",
+        "r",
+        "j",
+        "s",
+        "t",
+        "u",
+        "k",
+        "l",
+        "v",
+        "d",
+        "m",
+        "p",
+        "g",
+        "z",
+        "b",
+        "c",
+        "č",
+        "h",
+        "š",
+        "ž",
+        "ć",
+        "f",
+    ],
+    "Hindi": [
+        "क",
+        "र",
+        "स",
+        "न",
+        "त",
+        "म",
+        "ह",
+        "प",
+        "य",
+        "ल",
+        "व",
+        "ज",
+        "द",
+        "ग",
+        "ब",
+        "श",
+        "ट",
+        "अ",
+        "ए",
+        "थ",
+        "भ",
+        "ड",
+        "च",
+        "ध",
+        "ष",
+        "इ",
+    ],
+    "Estonian": [
+        "a",
+        "i",
+        "e",
+        "s",
+        "t",
+        "l",
+        "u",
+        "n",
+        "o",
+        "k",
+        "r",
+        "d",
+        "m",
+        "v",
+        "g",
+        "p",
+        "j",
+        "h",
+        "ä",
+        "b",
+        "õ",
+        "ü",
+        "f",
+        "c",
+        "ö",
+        "y",
+    ],
+    "Thai": [
+        "า",
+        "น",
+        "ร",
+        "อ",
+        "ก",
+        "เ",
+        "ง",
+        "ม",
+        "ย",
+        "ล",
+        "ว",
+        "ด",
+        "ท",
+        "ส",
+        "ต",
+        "ะ",
+        "ป",
+        "บ",
+        "ค",
+        "ห",
+        "แ",
+        "จ",
+        "พ",
+        "ช",
+        "ข",
+        "ใ",
+    ],
+    "Greek": [
+        "α",
+        "τ",
+        "ο",
+        "ι",
+        "ε",
+        "ν",
+        "ρ",
+        "σ",
+        "κ",
+        "η",
+        "π",
+        "ς",
+        "υ",
+        "μ",
+        "λ",
+        "ί",
+        "ό",
+        "ά",
+        "γ",
+        "έ",
+        "δ",
+        "ή",
+        "ω",
+        "χ",
+        "θ",
+        "ύ",
+    ],
+    "Tamil": [
+        "க",
+        "த",
+        "ப",
+        "ட",
+        "ர",
+        "ம",
+        "ல",
+        "ன",
+        "வ",
+        "ற",
+        "ய",
+        "ள",
+        "ச",
+        "ந",
+        "இ",
+        "ண",
+        "அ",
+        "ஆ",
+        "ழ",
+        "ங",
+        "எ",
+        "உ",
+        "ஒ",
+        "ஸ",
+    ],
+    "Kazakh": [
+        "а",
+        "ы",
+        "е",
+        "н",
+        "т",
+        "р",
+        "л",
+        "і",
+        "д",
+        "с",
+        "м",
+        "қ",
+        "к",
+        "о",
+        "б",
+        "и",
+        "у",
+        "ғ",
+        "ж",
+        "ң",
+        "з",
+        "ш",
+        "й",
+        "п",
+        "г",
+        "ө",
+    ],
+}
+
+LANGUAGE_SUPPORTED_COUNT: int = len(FREQUENCIES)
diff --git a/llm/Lib/site-packages/charset_normalizer/legacy.py b/llm/Lib/site-packages/charset_normalizer/legacy.py
new file mode 100644
index 0000000000000000000000000000000000000000..a458e4916b8a79acb7f2953d9dded93039e53e5d
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer/legacy.py
@@ -0,0 +1,54 @@
+from typing import Any, Dict, Optional, Union
+from warnings import warn
+
+from .api import from_bytes
+from .constant import CHARDET_CORRESPONDENCE
+
+
+def detect(
+    byte_str: bytes, should_rename_legacy: bool = False, **kwargs: Any
+) -> Dict[str, Optional[Union[str, float]]]:
+    """
+    chardet legacy method
+    Detect the encoding of the given byte string. It should be mostly backward-compatible.
+    Encoding name will match Chardet own writing whenever possible. (Not on encoding name unsupported by it)
+    This function is deprecated and should be used to migrate your project easily, consult the documentation for
+    further information. Not planned for removal.
+
+    :param byte_str:     The byte sequence to examine.
+    :param should_rename_legacy:  Should we rename legacy encodings
+                                  to their more modern equivalents?
+    """
+    if len(kwargs):
+        warn(
+            f"charset-normalizer disregard arguments '{','.join(list(kwargs.keys()))}' in legacy function detect()"
+        )
+
+    if not isinstance(byte_str, (bytearray, bytes)):
+        raise TypeError(  # pragma: nocover
+            "Expected object of type bytes or bytearray, got: "
+            "{0}".format(type(byte_str))
+        )
+
+    if isinstance(byte_str, bytearray):
+        byte_str = bytes(byte_str)
+
+    r = from_bytes(byte_str).best()
+
+    encoding = r.encoding if r is not None else None
+    language = r.language if r is not None and r.language != "Unknown" else ""
+    confidence = 1.0 - r.chaos if r is not None else None
+
+    # Note: CharsetNormalizer does not return 'UTF-8-SIG' as the sig get stripped in the detection/normalization process
+    # but chardet does return 'utf-8-sig' and it is a valid codec name.
+    if r is not None and encoding == "utf_8" and r.bom:
+        encoding += "_sig"
+
+    if should_rename_legacy is False and encoding in CHARDET_CORRESPONDENCE:
+        encoding = CHARDET_CORRESPONDENCE[encoding]
+
+    return {
+        "encoding": encoding,
+        "language": language,
+        "confidence": confidence,
+    }
diff --git a/llm/Lib/site-packages/charset_normalizer/md.cp311-win_amd64.pyd b/llm/Lib/site-packages/charset_normalizer/md.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..a23541bf2f5e7a63e7ca286ec30a1d74ab6467fd
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/md.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/charset_normalizer/md.py b/llm/Lib/site-packages/charset_normalizer/md.py
new file mode 100644
index 0000000000000000000000000000000000000000..9cf6b519e7bc870086c7a8ecfd5bb45dfc22ce44
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer/md.py
@@ -0,0 +1,615 @@
+from functools import lru_cache
+from logging import getLogger
+from typing import List, Optional
+
+from .constant import (
+    COMMON_SAFE_ASCII_CHARACTERS,
+    TRACE,
+    UNICODE_SECONDARY_RANGE_KEYWORD,
+)
+from .utils import (
+    is_accentuated,
+    is_arabic,
+    is_arabic_isolated_form,
+    is_case_variable,
+    is_cjk,
+    is_emoticon,
+    is_hangul,
+    is_hiragana,
+    is_katakana,
+    is_latin,
+    is_punctuation,
+    is_separator,
+    is_symbol,
+    is_thai,
+    is_unprintable,
+    remove_accent,
+    unicode_range,
+)
+
+
+class MessDetectorPlugin:
+    """
+    Base abstract class used for mess detection plugins.
+    All detectors MUST extend and implement given methods.
+    """
+
+    def eligible(self, character: str) -> bool:
+        """
+        Determine if given character should be fed in.
+        """
+        raise NotImplementedError  # pragma: nocover
+
+    def feed(self, character: str) -> None:
+        """
+        The main routine to be executed upon character.
+        Insert the logic in witch the text would be considered chaotic.
+        """
+        raise NotImplementedError  # pragma: nocover
+
+    def reset(self) -> None:  # pragma: no cover
+        """
+        Permit to reset the plugin to the initial state.
+        """
+        raise NotImplementedError
+
+    @property
+    def ratio(self) -> float:
+        """
+        Compute the chaos ratio based on what your feed() has seen.
+        Must NOT be lower than 0.; No restriction gt 0.
+        """
+        raise NotImplementedError  # pragma: nocover
+
+
+class TooManySymbolOrPunctuationPlugin(MessDetectorPlugin):
+    def __init__(self) -> None:
+        self._punctuation_count: int = 0
+        self._symbol_count: int = 0
+        self._character_count: int = 0
+
+        self._last_printable_char: Optional[str] = None
+        self._frenzy_symbol_in_word: bool = False
+
+    def eligible(self, character: str) -> bool:
+        return character.isprintable()
+
+    def feed(self, character: str) -> None:
+        self._character_count += 1
+
+        if (
+            character != self._last_printable_char
+            and character not in COMMON_SAFE_ASCII_CHARACTERS
+        ):
+            if is_punctuation(character):
+                self._punctuation_count += 1
+            elif (
+                character.isdigit() is False
+                and is_symbol(character)
+                and is_emoticon(character) is False
+            ):
+                self._symbol_count += 2
+
+        self._last_printable_char = character
+
+    def reset(self) -> None:  # pragma: no cover
+        self._punctuation_count = 0
+        self._character_count = 0
+        self._symbol_count = 0
+
+    @property
+    def ratio(self) -> float:
+        if self._character_count == 0:
+            return 0.0
+
+        ratio_of_punctuation: float = (
+            self._punctuation_count + self._symbol_count
+        ) / self._character_count
+
+        return ratio_of_punctuation if ratio_of_punctuation >= 0.3 else 0.0
+
+
+class TooManyAccentuatedPlugin(MessDetectorPlugin):
+    def __init__(self) -> None:
+        self._character_count: int = 0
+        self._accentuated_count: int = 0
+
+    def eligible(self, character: str) -> bool:
+        return character.isalpha()
+
+    def feed(self, character: str) -> None:
+        self._character_count += 1
+
+        if is_accentuated(character):
+            self._accentuated_count += 1
+
+    def reset(self) -> None:  # pragma: no cover
+        self._character_count = 0
+        self._accentuated_count = 0
+
+    @property
+    def ratio(self) -> float:
+        if self._character_count < 8:
+            return 0.0
+
+        ratio_of_accentuation: float = self._accentuated_count / self._character_count
+        return ratio_of_accentuation if ratio_of_accentuation >= 0.35 else 0.0
+
+
+class UnprintablePlugin(MessDetectorPlugin):
+    def __init__(self) -> None:
+        self._unprintable_count: int = 0
+        self._character_count: int = 0
+
+    def eligible(self, character: str) -> bool:
+        return True
+
+    def feed(self, character: str) -> None:
+        if is_unprintable(character):
+            self._unprintable_count += 1
+        self._character_count += 1
+
+    def reset(self) -> None:  # pragma: no cover
+        self._unprintable_count = 0
+
+    @property
+    def ratio(self) -> float:
+        if self._character_count == 0:
+            return 0.0
+
+        return (self._unprintable_count * 8) / self._character_count
+
+
+class SuspiciousDuplicateAccentPlugin(MessDetectorPlugin):
+    def __init__(self) -> None:
+        self._successive_count: int = 0
+        self._character_count: int = 0
+
+        self._last_latin_character: Optional[str] = None
+
+    def eligible(self, character: str) -> bool:
+        return character.isalpha() and is_latin(character)
+
+    def feed(self, character: str) -> None:
+        self._character_count += 1
+        if (
+            self._last_latin_character is not None
+            and is_accentuated(character)
+            and is_accentuated(self._last_latin_character)
+        ):
+            if character.isupper() and self._last_latin_character.isupper():
+                self._successive_count += 1
+            # Worse if its the same char duplicated with different accent.
+            if remove_accent(character) == remove_accent(self._last_latin_character):
+                self._successive_count += 1
+        self._last_latin_character = character
+
+    def reset(self) -> None:  # pragma: no cover
+        self._successive_count = 0
+        self._character_count = 0
+        self._last_latin_character = None
+
+    @property
+    def ratio(self) -> float:
+        if self._character_count == 0:
+            return 0.0
+
+        return (self._successive_count * 2) / self._character_count
+
+
+class SuspiciousRange(MessDetectorPlugin):
+    def __init__(self) -> None:
+        self._suspicious_successive_range_count: int = 0
+        self._character_count: int = 0
+        self._last_printable_seen: Optional[str] = None
+
+    def eligible(self, character: str) -> bool:
+        return character.isprintable()
+
+    def feed(self, character: str) -> None:
+        self._character_count += 1
+
+        if (
+            character.isspace()
+            or is_punctuation(character)
+            or character in COMMON_SAFE_ASCII_CHARACTERS
+        ):
+            self._last_printable_seen = None
+            return
+
+        if self._last_printable_seen is None:
+            self._last_printable_seen = character
+            return
+
+        unicode_range_a: Optional[str] = unicode_range(self._last_printable_seen)
+        unicode_range_b: Optional[str] = unicode_range(character)
+
+        if is_suspiciously_successive_range(unicode_range_a, unicode_range_b):
+            self._suspicious_successive_range_count += 1
+
+        self._last_printable_seen = character
+
+    def reset(self) -> None:  # pragma: no cover
+        self._character_count = 0
+        self._suspicious_successive_range_count = 0
+        self._last_printable_seen = None
+
+    @property
+    def ratio(self) -> float:
+        if self._character_count <= 24:
+            return 0.0
+
+        ratio_of_suspicious_range_usage: float = (
+            self._suspicious_successive_range_count * 2
+        ) / self._character_count
+
+        return ratio_of_suspicious_range_usage
+
+
+class SuperWeirdWordPlugin(MessDetectorPlugin):
+    def __init__(self) -> None:
+        self._word_count: int = 0
+        self._bad_word_count: int = 0
+        self._foreign_long_count: int = 0
+
+        self._is_current_word_bad: bool = False
+        self._foreign_long_watch: bool = False
+
+        self._character_count: int = 0
+        self._bad_character_count: int = 0
+
+        self._buffer: str = ""
+        self._buffer_accent_count: int = 0
+
+    def eligible(self, character: str) -> bool:
+        return True
+
+    def feed(self, character: str) -> None:
+        if character.isalpha():
+            self._buffer += character
+            if is_accentuated(character):
+                self._buffer_accent_count += 1
+            if (
+                self._foreign_long_watch is False
+                and (is_latin(character) is False or is_accentuated(character))
+                and is_cjk(character) is False
+                and is_hangul(character) is False
+                and is_katakana(character) is False
+                and is_hiragana(character) is False
+                and is_thai(character) is False
+            ):
+                self._foreign_long_watch = True
+            return
+        if not self._buffer:
+            return
+        if (
+            character.isspace() or is_punctuation(character) or is_separator(character)
+        ) and self._buffer:
+            self._word_count += 1
+            buffer_length: int = len(self._buffer)
+
+            self._character_count += buffer_length
+
+            if buffer_length >= 4:
+                if self._buffer_accent_count / buffer_length > 0.34:
+                    self._is_current_word_bad = True
+                # Word/Buffer ending with an upper case accentuated letter are so rare,
+                # that we will consider them all as suspicious. Same weight as foreign_long suspicious.
+                if (
+                    is_accentuated(self._buffer[-1])
+                    and self._buffer[-1].isupper()
+                    and all(_.isupper() for _ in self._buffer) is False
+                ):
+                    self._foreign_long_count += 1
+                    self._is_current_word_bad = True
+            if buffer_length >= 24 and self._foreign_long_watch:
+                camel_case_dst = [
+                    i
+                    for c, i in zip(self._buffer, range(0, buffer_length))
+                    if c.isupper()
+                ]
+                probable_camel_cased: bool = False
+
+                if camel_case_dst and (len(camel_case_dst) / buffer_length <= 0.3):
+                    probable_camel_cased = True
+
+                if not probable_camel_cased:
+                    self._foreign_long_count += 1
+                    self._is_current_word_bad = True
+
+            if self._is_current_word_bad:
+                self._bad_word_count += 1
+                self._bad_character_count += len(self._buffer)
+                self._is_current_word_bad = False
+
+            self._foreign_long_watch = False
+            self._buffer = ""
+            self._buffer_accent_count = 0
+        elif (
+            character not in {"<", ">", "-", "=", "~", "|", "_"}
+            and character.isdigit() is False
+            and is_symbol(character)
+        ):
+            self._is_current_word_bad = True
+            self._buffer += character
+
+    def reset(self) -> None:  # pragma: no cover
+        self._buffer = ""
+        self._is_current_word_bad = False
+        self._foreign_long_watch = False
+        self._bad_word_count = 0
+        self._word_count = 0
+        self._character_count = 0
+        self._bad_character_count = 0
+        self._foreign_long_count = 0
+
+    @property
+    def ratio(self) -> float:
+        if self._word_count <= 10 and self._foreign_long_count == 0:
+            return 0.0
+
+        return self._bad_character_count / self._character_count
+
+
+class CjkInvalidStopPlugin(MessDetectorPlugin):
+    """
+    GB(Chinese) based encoding often render the stop incorrectly when the content does not fit and
+    can be easily detected. Searching for the overuse of '丅' and '丄'.
+    """
+
+    def __init__(self) -> None:
+        self._wrong_stop_count: int = 0
+        self._cjk_character_count: int = 0
+
+    def eligible(self, character: str) -> bool:
+        return True
+
+    def feed(self, character: str) -> None:
+        if character in {"丅", "丄"}:
+            self._wrong_stop_count += 1
+            return
+        if is_cjk(character):
+            self._cjk_character_count += 1
+
+    def reset(self) -> None:  # pragma: no cover
+        self._wrong_stop_count = 0
+        self._cjk_character_count = 0
+
+    @property
+    def ratio(self) -> float:
+        if self._cjk_character_count < 16:
+            return 0.0
+        return self._wrong_stop_count / self._cjk_character_count
+
+
+class ArchaicUpperLowerPlugin(MessDetectorPlugin):
+    def __init__(self) -> None:
+        self._buf: bool = False
+
+        self._character_count_since_last_sep: int = 0
+
+        self._successive_upper_lower_count: int = 0
+        self._successive_upper_lower_count_final: int = 0
+
+        self._character_count: int = 0
+
+        self._last_alpha_seen: Optional[str] = None
+        self._current_ascii_only: bool = True
+
+    def eligible(self, character: str) -> bool:
+        return True
+
+    def feed(self, character: str) -> None:
+        is_concerned = character.isalpha() and is_case_variable(character)
+        chunk_sep = is_concerned is False
+
+        if chunk_sep and self._character_count_since_last_sep > 0:
+            if (
+                self._character_count_since_last_sep <= 64
+                and character.isdigit() is False
+                and self._current_ascii_only is False
+            ):
+                self._successive_upper_lower_count_final += (
+                    self._successive_upper_lower_count
+                )
+
+            self._successive_upper_lower_count = 0
+            self._character_count_since_last_sep = 0
+            self._last_alpha_seen = None
+            self._buf = False
+            self._character_count += 1
+            self._current_ascii_only = True
+
+            return
+
+        if self._current_ascii_only is True and character.isascii() is False:
+            self._current_ascii_only = False
+
+        if self._last_alpha_seen is not None:
+            if (character.isupper() and self._last_alpha_seen.islower()) or (
+                character.islower() and self._last_alpha_seen.isupper()
+            ):
+                if self._buf is True:
+                    self._successive_upper_lower_count += 2
+                    self._buf = False
+                else:
+                    self._buf = True
+            else:
+                self._buf = False
+
+        self._character_count += 1
+        self._character_count_since_last_sep += 1
+        self._last_alpha_seen = character
+
+    def reset(self) -> None:  # pragma: no cover
+        self._character_count = 0
+        self._character_count_since_last_sep = 0
+        self._successive_upper_lower_count = 0
+        self._successive_upper_lower_count_final = 0
+        self._last_alpha_seen = None
+        self._buf = False
+        self._current_ascii_only = True
+
+    @property
+    def ratio(self) -> float:
+        if self._character_count == 0:
+            return 0.0
+
+        return self._successive_upper_lower_count_final / self._character_count
+
+
+class ArabicIsolatedFormPlugin(MessDetectorPlugin):
+    def __init__(self) -> None:
+        self._character_count: int = 0
+        self._isolated_form_count: int = 0
+
+    def reset(self) -> None:  # pragma: no cover
+        self._character_count = 0
+        self._isolated_form_count = 0
+
+    def eligible(self, character: str) -> bool:
+        return is_arabic(character)
+
+    def feed(self, character: str) -> None:
+        self._character_count += 1
+
+        if is_arabic_isolated_form(character):
+            self._isolated_form_count += 1
+
+    @property
+    def ratio(self) -> float:
+        if self._character_count < 8:
+            return 0.0
+
+        isolated_form_usage: float = self._isolated_form_count / self._character_count
+
+        return isolated_form_usage
+
+
+@lru_cache(maxsize=1024)
+def is_suspiciously_successive_range(
+    unicode_range_a: Optional[str], unicode_range_b: Optional[str]
+) -> bool:
+    """
+    Determine if two Unicode range seen next to each other can be considered as suspicious.
+    """
+    if unicode_range_a is None or unicode_range_b is None:
+        return True
+
+    if unicode_range_a == unicode_range_b:
+        return False
+
+    if "Latin" in unicode_range_a and "Latin" in unicode_range_b:
+        return False
+
+    if "Emoticons" in unicode_range_a or "Emoticons" in unicode_range_b:
+        return False
+
+    # Latin characters can be accompanied with a combining diacritical mark
+    # eg. Vietnamese.
+    if ("Latin" in unicode_range_a or "Latin" in unicode_range_b) and (
+        "Combining" in unicode_range_a or "Combining" in unicode_range_b
+    ):
+        return False
+
+    keywords_range_a, keywords_range_b = unicode_range_a.split(
+        " "
+    ), unicode_range_b.split(" ")
+
+    for el in keywords_range_a:
+        if el in UNICODE_SECONDARY_RANGE_KEYWORD:
+            continue
+        if el in keywords_range_b:
+            return False
+
+    # Japanese Exception
+    range_a_jp_chars, range_b_jp_chars = (
+        unicode_range_a
+        in (
+            "Hiragana",
+            "Katakana",
+        ),
+        unicode_range_b in ("Hiragana", "Katakana"),
+    )
+    if (range_a_jp_chars or range_b_jp_chars) and (
+        "CJK" in unicode_range_a or "CJK" in unicode_range_b
+    ):
+        return False
+    if range_a_jp_chars and range_b_jp_chars:
+        return False
+
+    if "Hangul" in unicode_range_a or "Hangul" in unicode_range_b:
+        if "CJK" in unicode_range_a or "CJK" in unicode_range_b:
+            return False
+        if unicode_range_a == "Basic Latin" or unicode_range_b == "Basic Latin":
+            return False
+
+    # Chinese/Japanese use dedicated range for punctuation and/or separators.
+    if ("CJK" in unicode_range_a or "CJK" in unicode_range_b) or (
+        unicode_range_a in ["Katakana", "Hiragana"]
+        and unicode_range_b in ["Katakana", "Hiragana"]
+    ):
+        if "Punctuation" in unicode_range_a or "Punctuation" in unicode_range_b:
+            return False
+        if "Forms" in unicode_range_a or "Forms" in unicode_range_b:
+            return False
+        if unicode_range_a == "Basic Latin" or unicode_range_b == "Basic Latin":
+            return False
+
+    return True
+
+
+@lru_cache(maxsize=2048)
+def mess_ratio(
+    decoded_sequence: str, maximum_threshold: float = 0.2, debug: bool = False
+) -> float:
+    """
+    Compute a mess ratio given a decoded bytes sequence. The maximum threshold does stop the computation earlier.
+    """
+
+    detectors: List[MessDetectorPlugin] = [
+        md_class() for md_class in MessDetectorPlugin.__subclasses__()
+    ]
+
+    length: int = len(decoded_sequence) + 1
+
+    mean_mess_ratio: float = 0.0
+
+    if length < 512:
+        intermediary_mean_mess_ratio_calc: int = 32
+    elif length <= 1024:
+        intermediary_mean_mess_ratio_calc = 64
+    else:
+        intermediary_mean_mess_ratio_calc = 128
+
+    for character, index in zip(decoded_sequence + "\n", range(length)):
+        for detector in detectors:
+            if detector.eligible(character):
+                detector.feed(character)
+
+        if (
+            index > 0 and index % intermediary_mean_mess_ratio_calc == 0
+        ) or index == length - 1:
+            mean_mess_ratio = sum(dt.ratio for dt in detectors)
+
+            if mean_mess_ratio >= maximum_threshold:
+                break
+
+    if debug:
+        logger = getLogger("charset_normalizer")
+
+        logger.log(
+            TRACE,
+            "Mess-detector extended-analysis start. "
+            f"intermediary_mean_mess_ratio_calc={intermediary_mean_mess_ratio_calc} mean_mess_ratio={mean_mess_ratio} "
+            f"maximum_threshold={maximum_threshold}",
+        )
+
+        if len(decoded_sequence) > 16:
+            logger.log(TRACE, f"Starting with: {decoded_sequence[:16]}")
+            logger.log(TRACE, f"Ending with: {decoded_sequence[-16::]}")
+
+        for dt in detectors:  # pragma: nocover
+            logger.log(TRACE, f"{dt.__class__}: {dt.ratio}")
+
+    return round(mean_mess_ratio, 3)
diff --git a/llm/Lib/site-packages/charset_normalizer/md__mypyc.cp311-win_amd64.pyd b/llm/Lib/site-packages/charset_normalizer/md__mypyc.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..22db98cc46d2bfae591a3d80b9f1a5653551962c
Binary files /dev/null and b/llm/Lib/site-packages/charset_normalizer/md__mypyc.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/charset_normalizer/models.py b/llm/Lib/site-packages/charset_normalizer/models.py
new file mode 100644
index 0000000000000000000000000000000000000000..bb76f8d281f8a07ac1859c28e352b1cc0d7cd238
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer/models.py
@@ -0,0 +1,340 @@
+from encodings.aliases import aliases
+from hashlib import sha256
+from json import dumps
+from typing import Any, Dict, Iterator, List, Optional, Tuple, Union
+
+from .constant import TOO_BIG_SEQUENCE
+from .utils import iana_name, is_multi_byte_encoding, unicode_range
+
+
+class CharsetMatch:
+    def __init__(
+        self,
+        payload: bytes,
+        guessed_encoding: str,
+        mean_mess_ratio: float,
+        has_sig_or_bom: bool,
+        languages: "CoherenceMatches",
+        decoded_payload: Optional[str] = None,
+    ):
+        self._payload: bytes = payload
+
+        self._encoding: str = guessed_encoding
+        self._mean_mess_ratio: float = mean_mess_ratio
+        self._languages: CoherenceMatches = languages
+        self._has_sig_or_bom: bool = has_sig_or_bom
+        self._unicode_ranges: Optional[List[str]] = None
+
+        self._leaves: List[CharsetMatch] = []
+        self._mean_coherence_ratio: float = 0.0
+
+        self._output_payload: Optional[bytes] = None
+        self._output_encoding: Optional[str] = None
+
+        self._string: Optional[str] = decoded_payload
+
+    def __eq__(self, other: object) -> bool:
+        if not isinstance(other, CharsetMatch):
+            raise TypeError(
+                "__eq__ cannot be invoked on {} and {}.".format(
+                    str(other.__class__), str(self.__class__)
+                )
+            )
+        return self.encoding == other.encoding and self.fingerprint == other.fingerprint
+
+    def __lt__(self, other: object) -> bool:
+        """
+        Implemented to make sorted available upon CharsetMatches items.
+        """
+        if not isinstance(other, CharsetMatch):
+            raise ValueError
+
+        chaos_difference: float = abs(self.chaos - other.chaos)
+        coherence_difference: float = abs(self.coherence - other.coherence)
+
+        # Below 1% difference --> Use Coherence
+        if chaos_difference < 0.01 and coherence_difference > 0.02:
+            return self.coherence > other.coherence
+        elif chaos_difference < 0.01 and coherence_difference <= 0.02:
+            # When having a difficult decision, use the result that decoded as many multi-byte as possible.
+            # preserve RAM usage!
+            if len(self._payload) >= TOO_BIG_SEQUENCE:
+                return self.chaos < other.chaos
+            return self.multi_byte_usage > other.multi_byte_usage
+
+        return self.chaos < other.chaos
+
+    @property
+    def multi_byte_usage(self) -> float:
+        return 1.0 - (len(str(self)) / len(self.raw))
+
+    def __str__(self) -> str:
+        # Lazy Str Loading
+        if self._string is None:
+            self._string = str(self._payload, self._encoding, "strict")
+        return self._string
+
+    def __repr__(self) -> str:
+        return "<CharsetMatch '{}' bytes({})>".format(self.encoding, self.fingerprint)
+
+    def add_submatch(self, other: "CharsetMatch") -> None:
+        if not isinstance(other, CharsetMatch) or other == self:
+            raise ValueError(
+                "Unable to add instance <{}> as a submatch of a CharsetMatch".format(
+                    other.__class__
+                )
+            )
+
+        other._string = None  # Unload RAM usage; dirty trick.
+        self._leaves.append(other)
+
+    @property
+    def encoding(self) -> str:
+        return self._encoding
+
+    @property
+    def encoding_aliases(self) -> List[str]:
+        """
+        Encoding name are known by many name, using this could help when searching for IBM855 when it's listed as CP855.
+        """
+        also_known_as: List[str] = []
+        for u, p in aliases.items():
+            if self.encoding == u:
+                also_known_as.append(p)
+            elif self.encoding == p:
+                also_known_as.append(u)
+        return also_known_as
+
+    @property
+    def bom(self) -> bool:
+        return self._has_sig_or_bom
+
+    @property
+    def byte_order_mark(self) -> bool:
+        return self._has_sig_or_bom
+
+    @property
+    def languages(self) -> List[str]:
+        """
+        Return the complete list of possible languages found in decoded sequence.
+        Usually not really useful. Returned list may be empty even if 'language' property return something != 'Unknown'.
+        """
+        return [e[0] for e in self._languages]
+
+    @property
+    def language(self) -> str:
+        """
+        Most probable language found in decoded sequence. If none were detected or inferred, the property will return
+        "Unknown".
+        """
+        if not self._languages:
+            # Trying to infer the language based on the given encoding
+            # Its either English or we should not pronounce ourselves in certain cases.
+            if "ascii" in self.could_be_from_charset:
+                return "English"
+
+            # doing it there to avoid circular import
+            from charset_normalizer.cd import encoding_languages, mb_encoding_languages
+
+            languages = (
+                mb_encoding_languages(self.encoding)
+                if is_multi_byte_encoding(self.encoding)
+                else encoding_languages(self.encoding)
+            )
+
+            if len(languages) == 0 or "Latin Based" in languages:
+                return "Unknown"
+
+            return languages[0]
+
+        return self._languages[0][0]
+
+    @property
+    def chaos(self) -> float:
+        return self._mean_mess_ratio
+
+    @property
+    def coherence(self) -> float:
+        if not self._languages:
+            return 0.0
+        return self._languages[0][1]
+
+    @property
+    def percent_chaos(self) -> float:
+        return round(self.chaos * 100, ndigits=3)
+
+    @property
+    def percent_coherence(self) -> float:
+        return round(self.coherence * 100, ndigits=3)
+
+    @property
+    def raw(self) -> bytes:
+        """
+        Original untouched bytes.
+        """
+        return self._payload
+
+    @property
+    def submatch(self) -> List["CharsetMatch"]:
+        return self._leaves
+
+    @property
+    def has_submatch(self) -> bool:
+        return len(self._leaves) > 0
+
+    @property
+    def alphabets(self) -> List[str]:
+        if self._unicode_ranges is not None:
+            return self._unicode_ranges
+        # list detected ranges
+        detected_ranges: List[Optional[str]] = [
+            unicode_range(char) for char in str(self)
+        ]
+        # filter and sort
+        self._unicode_ranges = sorted(list({r for r in detected_ranges if r}))
+        return self._unicode_ranges
+
+    @property
+    def could_be_from_charset(self) -> List[str]:
+        """
+        The complete list of encoding that output the exact SAME str result and therefore could be the originating
+        encoding.
+        This list does include the encoding available in property 'encoding'.
+        """
+        return [self._encoding] + [m.encoding for m in self._leaves]
+
+    def output(self, encoding: str = "utf_8") -> bytes:
+        """
+        Method to get re-encoded bytes payload using given target encoding. Default to UTF-8.
+        Any errors will be simply ignored by the encoder NOT replaced.
+        """
+        if self._output_encoding is None or self._output_encoding != encoding:
+            self._output_encoding = encoding
+            self._output_payload = str(self).encode(encoding, "replace")
+
+        return self._output_payload  # type: ignore
+
+    @property
+    def fingerprint(self) -> str:
+        """
+        Retrieve the unique SHA256 computed using the transformed (re-encoded) payload. Not the original one.
+        """
+        return sha256(self.output()).hexdigest()
+
+
+class CharsetMatches:
+    """
+    Container with every CharsetMatch items ordered by default from most probable to the less one.
+    Act like a list(iterable) but does not implements all related methods.
+    """
+
+    def __init__(self, results: Optional[List[CharsetMatch]] = None):
+        self._results: List[CharsetMatch] = sorted(results) if results else []
+
+    def __iter__(self) -> Iterator[CharsetMatch]:
+        yield from self._results
+
+    def __getitem__(self, item: Union[int, str]) -> CharsetMatch:
+        """
+        Retrieve a single item either by its position or encoding name (alias may be used here).
+        Raise KeyError upon invalid index or encoding not present in results.
+        """
+        if isinstance(item, int):
+            return self._results[item]
+        if isinstance(item, str):
+            item = iana_name(item, False)
+            for result in self._results:
+                if item in result.could_be_from_charset:
+                    return result
+        raise KeyError
+
+    def __len__(self) -> int:
+        return len(self._results)
+
+    def __bool__(self) -> bool:
+        return len(self._results) > 0
+
+    def append(self, item: CharsetMatch) -> None:
+        """
+        Insert a single match. Will be inserted accordingly to preserve sort.
+        Can be inserted as a submatch.
+        """
+        if not isinstance(item, CharsetMatch):
+            raise ValueError(
+                "Cannot append instance '{}' to CharsetMatches".format(
+                    str(item.__class__)
+                )
+            )
+        # We should disable the submatch factoring when the input file is too heavy (conserve RAM usage)
+        if len(item.raw) <= TOO_BIG_SEQUENCE:
+            for match in self._results:
+                if match.fingerprint == item.fingerprint and match.chaos == item.chaos:
+                    match.add_submatch(item)
+                    return
+        self._results.append(item)
+        self._results = sorted(self._results)
+
+    def best(self) -> Optional["CharsetMatch"]:
+        """
+        Simply return the first match. Strict equivalent to matches[0].
+        """
+        if not self._results:
+            return None
+        return self._results[0]
+
+    def first(self) -> Optional["CharsetMatch"]:
+        """
+        Redundant method, call the method best(). Kept for BC reasons.
+        """
+        return self.best()
+
+
+CoherenceMatch = Tuple[str, float]
+CoherenceMatches = List[CoherenceMatch]
+
+
+class CliDetectionResult:
+    def __init__(
+        self,
+        path: str,
+        encoding: Optional[str],
+        encoding_aliases: List[str],
+        alternative_encodings: List[str],
+        language: str,
+        alphabets: List[str],
+        has_sig_or_bom: bool,
+        chaos: float,
+        coherence: float,
+        unicode_path: Optional[str],
+        is_preferred: bool,
+    ):
+        self.path: str = path
+        self.unicode_path: Optional[str] = unicode_path
+        self.encoding: Optional[str] = encoding
+        self.encoding_aliases: List[str] = encoding_aliases
+        self.alternative_encodings: List[str] = alternative_encodings
+        self.language: str = language
+        self.alphabets: List[str] = alphabets
+        self.has_sig_or_bom: bool = has_sig_or_bom
+        self.chaos: float = chaos
+        self.coherence: float = coherence
+        self.is_preferred: bool = is_preferred
+
+    @property
+    def __dict__(self) -> Dict[str, Any]:  # type: ignore
+        return {
+            "path": self.path,
+            "encoding": self.encoding,
+            "encoding_aliases": self.encoding_aliases,
+            "alternative_encodings": self.alternative_encodings,
+            "language": self.language,
+            "alphabets": self.alphabets,
+            "has_sig_or_bom": self.has_sig_or_bom,
+            "chaos": self.chaos,
+            "coherence": self.coherence,
+            "unicode_path": self.unicode_path,
+            "is_preferred": self.is_preferred,
+        }
+
+    def to_json(self) -> str:
+        return dumps(self.__dict__, ensure_ascii=True, indent=4)
diff --git a/llm/Lib/site-packages/charset_normalizer/py.typed b/llm/Lib/site-packages/charset_normalizer/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/charset_normalizer/utils.py b/llm/Lib/site-packages/charset_normalizer/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..bfa6cffc33211b41d8d8f1735af9a223c1d64316
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer/utils.py
@@ -0,0 +1,421 @@
+import importlib
+import logging
+import unicodedata
+from codecs import IncrementalDecoder
+from encodings.aliases import aliases
+from functools import lru_cache
+from re import findall
+from typing import Generator, List, Optional, Set, Tuple, Union
+
+from _multibytecodec import MultibyteIncrementalDecoder
+
+from .constant import (
+    ENCODING_MARKS,
+    IANA_SUPPORTED_SIMILAR,
+    RE_POSSIBLE_ENCODING_INDICATION,
+    UNICODE_RANGES_COMBINED,
+    UNICODE_SECONDARY_RANGE_KEYWORD,
+    UTF8_MAXIMAL_ALLOCATION,
+)
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_accentuated(character: str) -> bool:
+    try:
+        description: str = unicodedata.name(character)
+    except ValueError:
+        return False
+    return (
+        "WITH GRAVE" in description
+        or "WITH ACUTE" in description
+        or "WITH CEDILLA" in description
+        or "WITH DIAERESIS" in description
+        or "WITH CIRCUMFLEX" in description
+        or "WITH TILDE" in description
+        or "WITH MACRON" in description
+        or "WITH RING ABOVE" in description
+    )
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def remove_accent(character: str) -> str:
+    decomposed: str = unicodedata.decomposition(character)
+    if not decomposed:
+        return character
+
+    codes: List[str] = decomposed.split(" ")
+
+    return chr(int(codes[0], 16))
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def unicode_range(character: str) -> Optional[str]:
+    """
+    Retrieve the Unicode range official name from a single character.
+    """
+    character_ord: int = ord(character)
+
+    for range_name, ord_range in UNICODE_RANGES_COMBINED.items():
+        if character_ord in ord_range:
+            return range_name
+
+    return None
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_latin(character: str) -> bool:
+    try:
+        description: str = unicodedata.name(character)
+    except ValueError:
+        return False
+    return "LATIN" in description
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_punctuation(character: str) -> bool:
+    character_category: str = unicodedata.category(character)
+
+    if "P" in character_category:
+        return True
+
+    character_range: Optional[str] = unicode_range(character)
+
+    if character_range is None:
+        return False
+
+    return "Punctuation" in character_range
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_symbol(character: str) -> bool:
+    character_category: str = unicodedata.category(character)
+
+    if "S" in character_category or "N" in character_category:
+        return True
+
+    character_range: Optional[str] = unicode_range(character)
+
+    if character_range is None:
+        return False
+
+    return "Forms" in character_range and character_category != "Lo"
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_emoticon(character: str) -> bool:
+    character_range: Optional[str] = unicode_range(character)
+
+    if character_range is None:
+        return False
+
+    return "Emoticons" in character_range or "Pictographs" in character_range
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_separator(character: str) -> bool:
+    if character.isspace() or character in {"｜", "+", "<", ">"}:
+        return True
+
+    character_category: str = unicodedata.category(character)
+
+    return "Z" in character_category or character_category in {"Po", "Pd", "Pc"}
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_case_variable(character: str) -> bool:
+    return character.islower() != character.isupper()
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_cjk(character: str) -> bool:
+    try:
+        character_name = unicodedata.name(character)
+    except ValueError:
+        return False
+
+    return "CJK" in character_name
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_hiragana(character: str) -> bool:
+    try:
+        character_name = unicodedata.name(character)
+    except ValueError:
+        return False
+
+    return "HIRAGANA" in character_name
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_katakana(character: str) -> bool:
+    try:
+        character_name = unicodedata.name(character)
+    except ValueError:
+        return False
+
+    return "KATAKANA" in character_name
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_hangul(character: str) -> bool:
+    try:
+        character_name = unicodedata.name(character)
+    except ValueError:
+        return False
+
+    return "HANGUL" in character_name
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_thai(character: str) -> bool:
+    try:
+        character_name = unicodedata.name(character)
+    except ValueError:
+        return False
+
+    return "THAI" in character_name
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_arabic(character: str) -> bool:
+    try:
+        character_name = unicodedata.name(character)
+    except ValueError:
+        return False
+
+    return "ARABIC" in character_name
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_arabic_isolated_form(character: str) -> bool:
+    try:
+        character_name = unicodedata.name(character)
+    except ValueError:
+        return False
+
+    return "ARABIC" in character_name and "ISOLATED FORM" in character_name
+
+
+@lru_cache(maxsize=len(UNICODE_RANGES_COMBINED))
+def is_unicode_range_secondary(range_name: str) -> bool:
+    return any(keyword in range_name for keyword in UNICODE_SECONDARY_RANGE_KEYWORD)
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_unprintable(character: str) -> bool:
+    return (
+        character.isspace() is False  # includes \n \t \r \v
+        and character.isprintable() is False
+        and character != "\x1A"  # Why? Its the ASCII substitute character.
+        and character != "\ufeff"  # bug discovered in Python,
+        # Zero Width No-Break Space located in 	Arabic Presentation Forms-B, Unicode 1.1 not acknowledged as space.
+    )
+
+
+def any_specified_encoding(sequence: bytes, search_zone: int = 8192) -> Optional[str]:
+    """
+    Extract using ASCII-only decoder any specified encoding in the first n-bytes.
+    """
+    if not isinstance(sequence, bytes):
+        raise TypeError
+
+    seq_len: int = len(sequence)
+
+    results: List[str] = findall(
+        RE_POSSIBLE_ENCODING_INDICATION,
+        sequence[: min(seq_len, search_zone)].decode("ascii", errors="ignore"),
+    )
+
+    if len(results) == 0:
+        return None
+
+    for specified_encoding in results:
+        specified_encoding = specified_encoding.lower().replace("-", "_")
+
+        encoding_alias: str
+        encoding_iana: str
+
+        for encoding_alias, encoding_iana in aliases.items():
+            if encoding_alias == specified_encoding:
+                return encoding_iana
+            if encoding_iana == specified_encoding:
+                return encoding_iana
+
+    return None
+
+
+@lru_cache(maxsize=128)
+def is_multi_byte_encoding(name: str) -> bool:
+    """
+    Verify is a specific encoding is a multi byte one based on it IANA name
+    """
+    return name in {
+        "utf_8",
+        "utf_8_sig",
+        "utf_16",
+        "utf_16_be",
+        "utf_16_le",
+        "utf_32",
+        "utf_32_le",
+        "utf_32_be",
+        "utf_7",
+    } or issubclass(
+        importlib.import_module("encodings.{}".format(name)).IncrementalDecoder,
+        MultibyteIncrementalDecoder,
+    )
+
+
+def identify_sig_or_bom(sequence: bytes) -> Tuple[Optional[str], bytes]:
+    """
+    Identify and extract SIG/BOM in given sequence.
+    """
+
+    for iana_encoding in ENCODING_MARKS:
+        marks: Union[bytes, List[bytes]] = ENCODING_MARKS[iana_encoding]
+
+        if isinstance(marks, bytes):
+            marks = [marks]
+
+        for mark in marks:
+            if sequence.startswith(mark):
+                return iana_encoding, mark
+
+    return None, b""
+
+
+def should_strip_sig_or_bom(iana_encoding: str) -> bool:
+    return iana_encoding not in {"utf_16", "utf_32"}
+
+
+def iana_name(cp_name: str, strict: bool = True) -> str:
+    cp_name = cp_name.lower().replace("-", "_")
+
+    encoding_alias: str
+    encoding_iana: str
+
+    for encoding_alias, encoding_iana in aliases.items():
+        if cp_name in [encoding_alias, encoding_iana]:
+            return encoding_iana
+
+    if strict:
+        raise ValueError("Unable to retrieve IANA for '{}'".format(cp_name))
+
+    return cp_name
+
+
+def range_scan(decoded_sequence: str) -> List[str]:
+    ranges: Set[str] = set()
+
+    for character in decoded_sequence:
+        character_range: Optional[str] = unicode_range(character)
+
+        if character_range is None:
+            continue
+
+        ranges.add(character_range)
+
+    return list(ranges)
+
+
+def cp_similarity(iana_name_a: str, iana_name_b: str) -> float:
+    if is_multi_byte_encoding(iana_name_a) or is_multi_byte_encoding(iana_name_b):
+        return 0.0
+
+    decoder_a = importlib.import_module(
+        "encodings.{}".format(iana_name_a)
+    ).IncrementalDecoder
+    decoder_b = importlib.import_module(
+        "encodings.{}".format(iana_name_b)
+    ).IncrementalDecoder
+
+    id_a: IncrementalDecoder = decoder_a(errors="ignore")
+    id_b: IncrementalDecoder = decoder_b(errors="ignore")
+
+    character_match_count: int = 0
+
+    for i in range(255):
+        to_be_decoded: bytes = bytes([i])
+        if id_a.decode(to_be_decoded) == id_b.decode(to_be_decoded):
+            character_match_count += 1
+
+    return character_match_count / 254
+
+
+def is_cp_similar(iana_name_a: str, iana_name_b: str) -> bool:
+    """
+    Determine if two code page are at least 80% similar. IANA_SUPPORTED_SIMILAR dict was generated using
+    the function cp_similarity.
+    """
+    return (
+        iana_name_a in IANA_SUPPORTED_SIMILAR
+        and iana_name_b in IANA_SUPPORTED_SIMILAR[iana_name_a]
+    )
+
+
+def set_logging_handler(
+    name: str = "charset_normalizer",
+    level: int = logging.INFO,
+    format_string: str = "%(asctime)s | %(levelname)s | %(message)s",
+) -> None:
+    logger = logging.getLogger(name)
+    logger.setLevel(level)
+
+    handler = logging.StreamHandler()
+    handler.setFormatter(logging.Formatter(format_string))
+    logger.addHandler(handler)
+
+
+def cut_sequence_chunks(
+    sequences: bytes,
+    encoding_iana: str,
+    offsets: range,
+    chunk_size: int,
+    bom_or_sig_available: bool,
+    strip_sig_or_bom: bool,
+    sig_payload: bytes,
+    is_multi_byte_decoder: bool,
+    decoded_payload: Optional[str] = None,
+) -> Generator[str, None, None]:
+    if decoded_payload and is_multi_byte_decoder is False:
+        for i in offsets:
+            chunk = decoded_payload[i : i + chunk_size]
+            if not chunk:
+                break
+            yield chunk
+    else:
+        for i in offsets:
+            chunk_end = i + chunk_size
+            if chunk_end > len(sequences) + 8:
+                continue
+
+            cut_sequence = sequences[i : i + chunk_size]
+
+            if bom_or_sig_available and strip_sig_or_bom is False:
+                cut_sequence = sig_payload + cut_sequence
+
+            chunk = cut_sequence.decode(
+                encoding_iana,
+                errors="ignore" if is_multi_byte_decoder else "strict",
+            )
+
+            # multi-byte bad cutting detector and adjustment
+            # not the cleanest way to perform that fix but clever enough for now.
+            if is_multi_byte_decoder and i > 0:
+                chunk_partial_size_chk: int = min(chunk_size, 16)
+
+                if (
+                    decoded_payload
+                    and chunk[:chunk_partial_size_chk] not in decoded_payload
+                ):
+                    for j in range(i, i - 4, -1):
+                        cut_sequence = sequences[j:chunk_end]
+
+                        if bom_or_sig_available and strip_sig_or_bom is False:
+                            cut_sequence = sig_payload + cut_sequence
+
+                        chunk = cut_sequence.decode(encoding_iana, errors="ignore")
+
+                        if chunk[:chunk_partial_size_chk] in decoded_payload:
+                            break
+
+            yield chunk
diff --git a/llm/Lib/site-packages/charset_normalizer/version.py b/llm/Lib/site-packages/charset_normalizer/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..25e1641af4810e1ec659fff13d8afce60946b0ec
--- /dev/null
+++ b/llm/Lib/site-packages/charset_normalizer/version.py
@@ -0,0 +1,6 @@
+"""
+Expose version
+"""
+
+__version__ = "3.3.2"
+VERSION = __version__.split(".")
diff --git a/llm/Lib/site-packages/click-8.1.7.dist-info/INSTALLER b/llm/Lib/site-packages/click-8.1.7.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/click-8.1.7.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/click-8.1.7.dist-info/LICENSE.rst b/llm/Lib/site-packages/click-8.1.7.dist-info/LICENSE.rst
new file mode 100644
index 0000000000000000000000000000000000000000..d12a849186982399c537c5b9a8fd77bf2edd5eab
--- /dev/null
+++ b/llm/Lib/site-packages/click-8.1.7.dist-info/LICENSE.rst
@@ -0,0 +1,28 @@
+Copyright 2014 Pallets
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1.  Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+2.  Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+
+3.  Neither the name of the copyright holder nor the names of its
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/llm/Lib/site-packages/click-8.1.7.dist-info/METADATA b/llm/Lib/site-packages/click-8.1.7.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..7a6bbb24b5f05575ac0263dd7fb24e0f0180d641
--- /dev/null
+++ b/llm/Lib/site-packages/click-8.1.7.dist-info/METADATA
@@ -0,0 +1,103 @@
+Metadata-Version: 2.1
+Name: click
+Version: 8.1.7
+Summary: Composable command line interface toolkit
+Home-page: https://palletsprojects.com/p/click/
+Maintainer: Pallets
+Maintainer-email: contact@palletsprojects.com
+License: BSD-3-Clause
+Project-URL: Donate, https://palletsprojects.com/donate
+Project-URL: Documentation, https://click.palletsprojects.com/
+Project-URL: Changes, https://click.palletsprojects.com/changes/
+Project-URL: Source Code, https://github.com/pallets/click/
+Project-URL: Issue Tracker, https://github.com/pallets/click/issues/
+Project-URL: Chat, https://discord.gg/pallets
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Requires-Python: >=3.7
+Description-Content-Type: text/x-rst
+License-File: LICENSE.rst
+Requires-Dist: colorama ; platform_system == "Windows"
+Requires-Dist: importlib-metadata ; python_version < "3.8"
+
+\$ click\_
+==========
+
+Click is a Python package for creating beautiful command line interfaces
+in a composable way with as little code as necessary. It's the "Command
+Line Interface Creation Kit". It's highly configurable but comes with
+sensible defaults out of the box.
+
+It aims to make the process of writing command line tools quick and fun
+while also preventing any frustration caused by the inability to
+implement an intended CLI API.
+
+Click in three points:
+
+-   Arbitrary nesting of commands
+-   Automatic help page generation
+-   Supports lazy loading of subcommands at runtime
+
+
+Installing
+----------
+
+Install and update using `pip`_:
+
+.. code-block:: text
+
+    $ pip install -U click
+
+.. _pip: https://pip.pypa.io/en/stable/getting-started/
+
+
+A Simple Example
+----------------
+
+.. code-block:: python
+
+    import click
+
+    @click.command()
+    @click.option("--count", default=1, help="Number of greetings.")
+    @click.option("--name", prompt="Your name", help="The person to greet.")
+    def hello(count, name):
+        """Simple program that greets NAME for a total of COUNT times."""
+        for _ in range(count):
+            click.echo(f"Hello, {name}!")
+
+    if __name__ == '__main__':
+        hello()
+
+.. code-block:: text
+
+    $ python hello.py --count=3
+    Your name: Click
+    Hello, Click!
+    Hello, Click!
+    Hello, Click!
+
+
+Donate
+------
+
+The Pallets organization develops and supports Click and other popular
+packages. In order to grow the community of contributors and users, and
+allow the maintainers to devote more time to the projects, `please
+donate today`_.
+
+.. _please donate today: https://palletsprojects.com/donate
+
+
+Links
+-----
+
+-   Documentation: https://click.palletsprojects.com/
+-   Changes: https://click.palletsprojects.com/changes/
+-   PyPI Releases: https://pypi.org/project/click/
+-   Source Code: https://github.com/pallets/click
+-   Issue Tracker: https://github.com/pallets/click/issues
+-   Chat: https://discord.gg/pallets
diff --git a/llm/Lib/site-packages/click-8.1.7.dist-info/RECORD b/llm/Lib/site-packages/click-8.1.7.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..fc0b7f5dd0e3c80f79a2fe2951c0d9a46fc17576
--- /dev/null
+++ b/llm/Lib/site-packages/click-8.1.7.dist-info/RECORD
@@ -0,0 +1,39 @@
+click-8.1.7.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+click-8.1.7.dist-info/LICENSE.rst,sha256=morRBqOU6FO_4h9C9OctWSgZoigF2ZG18ydQKSkrZY0,1475
+click-8.1.7.dist-info/METADATA,sha256=qIMevCxGA9yEmJOM_4WHuUJCwWpsIEVbCPOhs45YPN4,3014
+click-8.1.7.dist-info/RECORD,,
+click-8.1.7.dist-info/WHEEL,sha256=5sUXSg9e4bi7lTLOHcm6QEYwO5TIF1TNbTSVFVjcJcc,92
+click-8.1.7.dist-info/top_level.txt,sha256=J1ZQogalYS4pphY_lPECoNMfw0HzTSrZglC4Yfwo4xA,6
+click/__init__.py,sha256=YDDbjm406dTOA0V8bTtdGnhN7zj5j-_dFRewZF_pLvw,3138
+click/__pycache__/__init__.cpython-311.pyc,,
+click/__pycache__/_compat.cpython-311.pyc,,
+click/__pycache__/_termui_impl.cpython-311.pyc,,
+click/__pycache__/_textwrap.cpython-311.pyc,,
+click/__pycache__/_winconsole.cpython-311.pyc,,
+click/__pycache__/core.cpython-311.pyc,,
+click/__pycache__/decorators.cpython-311.pyc,,
+click/__pycache__/exceptions.cpython-311.pyc,,
+click/__pycache__/formatting.cpython-311.pyc,,
+click/__pycache__/globals.cpython-311.pyc,,
+click/__pycache__/parser.cpython-311.pyc,,
+click/__pycache__/shell_completion.cpython-311.pyc,,
+click/__pycache__/termui.cpython-311.pyc,,
+click/__pycache__/testing.cpython-311.pyc,,
+click/__pycache__/types.cpython-311.pyc,,
+click/__pycache__/utils.cpython-311.pyc,,
+click/_compat.py,sha256=5318agQpbt4kroKsbqDOYpTSWzL_YCZVUQiTT04yXmc,18744
+click/_termui_impl.py,sha256=3dFYv4445Nw-rFvZOTBMBPYwB1bxnmNk9Du6Dm_oBSU,24069
+click/_textwrap.py,sha256=10fQ64OcBUMuK7mFvh8363_uoOxPlRItZBmKzRJDgoY,1353
+click/_winconsole.py,sha256=5ju3jQkcZD0W27WEMGqmEP4y_crUVzPCqsX_FYb7BO0,7860
+click/core.py,sha256=j6oEWtGgGna8JarD6WxhXmNnxLnfRjwXglbBc-8jr7U,114086
+click/decorators.py,sha256=-ZlbGYgV-oI8jr_oH4RpuL1PFS-5QmeuEAsLDAYgxtw,18719
+click/exceptions.py,sha256=fyROO-47HWFDjt2qupo7A3J32VlpM-ovJnfowu92K3s,9273
+click/formatting.py,sha256=Frf0-5W33-loyY_i9qrwXR8-STnW3m5gvyxLVUdyxyk,9706
+click/globals.py,sha256=TP-qM88STzc7f127h35TD_v920FgfOD2EwzqA0oE8XU,1961
+click/parser.py,sha256=LKyYQE9ZLj5KgIDXkrcTHQRXIggfoivX14_UVIn56YA,19067
+click/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+click/shell_completion.py,sha256=Ty3VM_ts0sQhj6u7eFTiLwHPoTgcXTGEAUg2OpLqYKw,18460
+click/termui.py,sha256=H7Q8FpmPelhJ2ovOhfCRhjMtCpNyjFXryAMLZODqsdc,28324
+click/testing.py,sha256=1Qd4kS5bucn1hsNIRryd0WtTMuCpkA93grkWxT8POsU,16084
+click/types.py,sha256=TZvz3hKvBztf-Hpa2enOmP4eznSPLzijjig5b_0XMxE,36391
+click/utils.py,sha256=1476UduUNY6UePGU4m18uzVHLt1sKM2PP3yWsQhbItM,20298
diff --git a/llm/Lib/site-packages/click-8.1.7.dist-info/WHEEL b/llm/Lib/site-packages/click-8.1.7.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..2c08da084599354e5b2dbccb3ab716165e63d1a0
--- /dev/null
+++ b/llm/Lib/site-packages/click-8.1.7.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.41.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/click-8.1.7.dist-info/top_level.txt b/llm/Lib/site-packages/click-8.1.7.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..dca9a909647e3b066931de2909c2d1e65c78c995
--- /dev/null
+++ b/llm/Lib/site-packages/click-8.1.7.dist-info/top_level.txt
@@ -0,0 +1 @@
+click
diff --git a/llm/Lib/site-packages/click/__init__.py b/llm/Lib/site-packages/click/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a1dab048917edc420af440c73bd1d689de6b3fa
--- /dev/null
+++ b/llm/Lib/site-packages/click/__init__.py
@@ -0,0 +1,73 @@
+"""
+Click is a simple Python module inspired by the stdlib optparse to make
+writing command line scripts fun. Unlike other modules, it's based
+around a simple API that does not come with too much magic and is
+composable.
+"""
+from .core import Argument as Argument
+from .core import BaseCommand as BaseCommand
+from .core import Command as Command
+from .core import CommandCollection as CommandCollection
+from .core import Context as Context
+from .core import Group as Group
+from .core import MultiCommand as MultiCommand
+from .core import Option as Option
+from .core import Parameter as Parameter
+from .decorators import argument as argument
+from .decorators import command as command
+from .decorators import confirmation_option as confirmation_option
+from .decorators import group as group
+from .decorators import help_option as help_option
+from .decorators import make_pass_decorator as make_pass_decorator
+from .decorators import option as option
+from .decorators import pass_context as pass_context
+from .decorators import pass_obj as pass_obj
+from .decorators import password_option as password_option
+from .decorators import version_option as version_option
+from .exceptions import Abort as Abort
+from .exceptions import BadArgumentUsage as BadArgumentUsage
+from .exceptions import BadOptionUsage as BadOptionUsage
+from .exceptions import BadParameter as BadParameter
+from .exceptions import ClickException as ClickException
+from .exceptions import FileError as FileError
+from .exceptions import MissingParameter as MissingParameter
+from .exceptions import NoSuchOption as NoSuchOption
+from .exceptions import UsageError as UsageError
+from .formatting import HelpFormatter as HelpFormatter
+from .formatting import wrap_text as wrap_text
+from .globals import get_current_context as get_current_context
+from .parser import OptionParser as OptionParser
+from .termui import clear as clear
+from .termui import confirm as confirm
+from .termui import echo_via_pager as echo_via_pager
+from .termui import edit as edit
+from .termui import getchar as getchar
+from .termui import launch as launch
+from .termui import pause as pause
+from .termui import progressbar as progressbar
+from .termui import prompt as prompt
+from .termui import secho as secho
+from .termui import style as style
+from .termui import unstyle as unstyle
+from .types import BOOL as BOOL
+from .types import Choice as Choice
+from .types import DateTime as DateTime
+from .types import File as File
+from .types import FLOAT as FLOAT
+from .types import FloatRange as FloatRange
+from .types import INT as INT
+from .types import IntRange as IntRange
+from .types import ParamType as ParamType
+from .types import Path as Path
+from .types import STRING as STRING
+from .types import Tuple as Tuple
+from .types import UNPROCESSED as UNPROCESSED
+from .types import UUID as UUID
+from .utils import echo as echo
+from .utils import format_filename as format_filename
+from .utils import get_app_dir as get_app_dir
+from .utils import get_binary_stream as get_binary_stream
+from .utils import get_text_stream as get_text_stream
+from .utils import open_file as open_file
+
+__version__ = "8.1.7"
diff --git a/llm/Lib/site-packages/click/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f8e07a950051d2becf7e6d7e14a01cd62c928f23
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/_compat.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/_compat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4341abd82fd62c77a1b8db84f7f9f18277de2e73
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/_compat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/_termui_impl.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/_termui_impl.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aa0556a8016170269a708f4d7f53e74c51b5200e
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/_termui_impl.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/_textwrap.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/_textwrap.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..310bff48110a1bc2ce4e12d029469f1225dcae79
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/_textwrap.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/_winconsole.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/_winconsole.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b61551b42ab200f9c0fe090a27074c085ddbc501
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/_winconsole.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/core.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/core.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9c1c961bfc8f5b292eba1f5e2f30ffcab3d3ed62
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/core.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/decorators.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/decorators.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5f27c05b0f84e4abb71e70db673a41099f88a7aa
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/decorators.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e3a20cc64f4396aa870acb9ed3047a29f50a2235
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/formatting.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/formatting.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d0f0aba07b8bd4d89635aad4ad27b414faa41d01
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/formatting.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/globals.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/globals.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ca34d578356613306e389b902c2c3ee324df7462
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/globals.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/parser.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3a892e0534ad20fc7f458d17160b77fdbe79fe50
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/shell_completion.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/shell_completion.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..28003328d09f31870e4758db1728d496d564ecbf
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/shell_completion.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/termui.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/termui.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a78db4e1aae3a4ca380160689344b7242a092a6b
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/termui.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/testing.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/testing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7caa6eb104ea61161795b32a246d25765f9e19c8
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/testing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/types.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ef63cdcc93e3a0e5a0f3dbfaae6a69a0a3ebcf4b
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/click/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7870f0cd3fc7b1145d53ae1b53ce64cda091ad13
Binary files /dev/null and b/llm/Lib/site-packages/click/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/click/_compat.py b/llm/Lib/site-packages/click/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..23f8866598b4b4eb836b9d9b210ebd395fd0c557
--- /dev/null
+++ b/llm/Lib/site-packages/click/_compat.py
@@ -0,0 +1,623 @@
+import codecs
+import io
+import os
+import re
+import sys
+import typing as t
+from weakref import WeakKeyDictionary
+
+CYGWIN = sys.platform.startswith("cygwin")
+WIN = sys.platform.startswith("win")
+auto_wrap_for_ansi: t.Optional[t.Callable[[t.TextIO], t.TextIO]] = None
+_ansi_re = re.compile(r"\033\[[;?0-9]*[a-zA-Z]")
+
+
+def _make_text_stream(
+    stream: t.BinaryIO,
+    encoding: t.Optional[str],
+    errors: t.Optional[str],
+    force_readable: bool = False,
+    force_writable: bool = False,
+) -> t.TextIO:
+    if encoding is None:
+        encoding = get_best_encoding(stream)
+    if errors is None:
+        errors = "replace"
+    return _NonClosingTextIOWrapper(
+        stream,
+        encoding,
+        errors,
+        line_buffering=True,
+        force_readable=force_readable,
+        force_writable=force_writable,
+    )
+
+
+def is_ascii_encoding(encoding: str) -> bool:
+    """Checks if a given encoding is ascii."""
+    try:
+        return codecs.lookup(encoding).name == "ascii"
+    except LookupError:
+        return False
+
+
+def get_best_encoding(stream: t.IO[t.Any]) -> str:
+    """Returns the default stream encoding if not found."""
+    rv = getattr(stream, "encoding", None) or sys.getdefaultencoding()
+    if is_ascii_encoding(rv):
+        return "utf-8"
+    return rv
+
+
+class _NonClosingTextIOWrapper(io.TextIOWrapper):
+    def __init__(
+        self,
+        stream: t.BinaryIO,
+        encoding: t.Optional[str],
+        errors: t.Optional[str],
+        force_readable: bool = False,
+        force_writable: bool = False,
+        **extra: t.Any,
+    ) -> None:
+        self._stream = stream = t.cast(
+            t.BinaryIO, _FixupStream(stream, force_readable, force_writable)
+        )
+        super().__init__(stream, encoding, errors, **extra)
+
+    def __del__(self) -> None:
+        try:
+            self.detach()
+        except Exception:
+            pass
+
+    def isatty(self) -> bool:
+        # https://bitbucket.org/pypy/pypy/issue/1803
+        return self._stream.isatty()
+
+
+class _FixupStream:
+    """The new io interface needs more from streams than streams
+    traditionally implement.  As such, this fix-up code is necessary in
+    some circumstances.
+
+    The forcing of readable and writable flags are there because some tools
+    put badly patched objects on sys (one such offender are certain version
+    of jupyter notebook).
+    """
+
+    def __init__(
+        self,
+        stream: t.BinaryIO,
+        force_readable: bool = False,
+        force_writable: bool = False,
+    ):
+        self._stream = stream
+        self._force_readable = force_readable
+        self._force_writable = force_writable
+
+    def __getattr__(self, name: str) -> t.Any:
+        return getattr(self._stream, name)
+
+    def read1(self, size: int) -> bytes:
+        f = getattr(self._stream, "read1", None)
+
+        if f is not None:
+            return t.cast(bytes, f(size))
+
+        return self._stream.read(size)
+
+    def readable(self) -> bool:
+        if self._force_readable:
+            return True
+        x = getattr(self._stream, "readable", None)
+        if x is not None:
+            return t.cast(bool, x())
+        try:
+            self._stream.read(0)
+        except Exception:
+            return False
+        return True
+
+    def writable(self) -> bool:
+        if self._force_writable:
+            return True
+        x = getattr(self._stream, "writable", None)
+        if x is not None:
+            return t.cast(bool, x())
+        try:
+            self._stream.write("")  # type: ignore
+        except Exception:
+            try:
+                self._stream.write(b"")
+            except Exception:
+                return False
+        return True
+
+    def seekable(self) -> bool:
+        x = getattr(self._stream, "seekable", None)
+        if x is not None:
+            return t.cast(bool, x())
+        try:
+            self._stream.seek(self._stream.tell())
+        except Exception:
+            return False
+        return True
+
+
+def _is_binary_reader(stream: t.IO[t.Any], default: bool = False) -> bool:
+    try:
+        return isinstance(stream.read(0), bytes)
+    except Exception:
+        return default
+        # This happens in some cases where the stream was already
+        # closed.  In this case, we assume the default.
+
+
+def _is_binary_writer(stream: t.IO[t.Any], default: bool = False) -> bool:
+    try:
+        stream.write(b"")
+    except Exception:
+        try:
+            stream.write("")
+            return False
+        except Exception:
+            pass
+        return default
+    return True
+
+
+def _find_binary_reader(stream: t.IO[t.Any]) -> t.Optional[t.BinaryIO]:
+    # We need to figure out if the given stream is already binary.
+    # This can happen because the official docs recommend detaching
+    # the streams to get binary streams.  Some code might do this, so
+    # we need to deal with this case explicitly.
+    if _is_binary_reader(stream, False):
+        return t.cast(t.BinaryIO, stream)
+
+    buf = getattr(stream, "buffer", None)
+
+    # Same situation here; this time we assume that the buffer is
+    # actually binary in case it's closed.
+    if buf is not None and _is_binary_reader(buf, True):
+        return t.cast(t.BinaryIO, buf)
+
+    return None
+
+
+def _find_binary_writer(stream: t.IO[t.Any]) -> t.Optional[t.BinaryIO]:
+    # We need to figure out if the given stream is already binary.
+    # This can happen because the official docs recommend detaching
+    # the streams to get binary streams.  Some code might do this, so
+    # we need to deal with this case explicitly.
+    if _is_binary_writer(stream, False):
+        return t.cast(t.BinaryIO, stream)
+
+    buf = getattr(stream, "buffer", None)
+
+    # Same situation here; this time we assume that the buffer is
+    # actually binary in case it's closed.
+    if buf is not None and _is_binary_writer(buf, True):
+        return t.cast(t.BinaryIO, buf)
+
+    return None
+
+
+def _stream_is_misconfigured(stream: t.TextIO) -> bool:
+    """A stream is misconfigured if its encoding is ASCII."""
+    # If the stream does not have an encoding set, we assume it's set
+    # to ASCII.  This appears to happen in certain unittest
+    # environments.  It's not quite clear what the correct behavior is
+    # but this at least will force Click to recover somehow.
+    return is_ascii_encoding(getattr(stream, "encoding", None) or "ascii")
+
+
+def _is_compat_stream_attr(stream: t.TextIO, attr: str, value: t.Optional[str]) -> bool:
+    """A stream attribute is compatible if it is equal to the
+    desired value or the desired value is unset and the attribute
+    has a value.
+    """
+    stream_value = getattr(stream, attr, None)
+    return stream_value == value or (value is None and stream_value is not None)
+
+
+def _is_compatible_text_stream(
+    stream: t.TextIO, encoding: t.Optional[str], errors: t.Optional[str]
+) -> bool:
+    """Check if a stream's encoding and errors attributes are
+    compatible with the desired values.
+    """
+    return _is_compat_stream_attr(
+        stream, "encoding", encoding
+    ) and _is_compat_stream_attr(stream, "errors", errors)
+
+
+def _force_correct_text_stream(
+    text_stream: t.IO[t.Any],
+    encoding: t.Optional[str],
+    errors: t.Optional[str],
+    is_binary: t.Callable[[t.IO[t.Any], bool], bool],
+    find_binary: t.Callable[[t.IO[t.Any]], t.Optional[t.BinaryIO]],
+    force_readable: bool = False,
+    force_writable: bool = False,
+) -> t.TextIO:
+    if is_binary(text_stream, False):
+        binary_reader = t.cast(t.BinaryIO, text_stream)
+    else:
+        text_stream = t.cast(t.TextIO, text_stream)
+        # If the stream looks compatible, and won't default to a
+        # misconfigured ascii encoding, return it as-is.
+        if _is_compatible_text_stream(text_stream, encoding, errors) and not (
+            encoding is None and _stream_is_misconfigured(text_stream)
+        ):
+            return text_stream
+
+        # Otherwise, get the underlying binary reader.
+        possible_binary_reader = find_binary(text_stream)
+
+        # If that's not possible, silently use the original reader
+        # and get mojibake instead of exceptions.
+        if possible_binary_reader is None:
+            return text_stream
+
+        binary_reader = possible_binary_reader
+
+    # Default errors to replace instead of strict in order to get
+    # something that works.
+    if errors is None:
+        errors = "replace"
+
+    # Wrap the binary stream in a text stream with the correct
+    # encoding parameters.
+    return _make_text_stream(
+        binary_reader,
+        encoding,
+        errors,
+        force_readable=force_readable,
+        force_writable=force_writable,
+    )
+
+
+def _force_correct_text_reader(
+    text_reader: t.IO[t.Any],
+    encoding: t.Optional[str],
+    errors: t.Optional[str],
+    force_readable: bool = False,
+) -> t.TextIO:
+    return _force_correct_text_stream(
+        text_reader,
+        encoding,
+        errors,
+        _is_binary_reader,
+        _find_binary_reader,
+        force_readable=force_readable,
+    )
+
+
+def _force_correct_text_writer(
+    text_writer: t.IO[t.Any],
+    encoding: t.Optional[str],
+    errors: t.Optional[str],
+    force_writable: bool = False,
+) -> t.TextIO:
+    return _force_correct_text_stream(
+        text_writer,
+        encoding,
+        errors,
+        _is_binary_writer,
+        _find_binary_writer,
+        force_writable=force_writable,
+    )
+
+
+def get_binary_stdin() -> t.BinaryIO:
+    reader = _find_binary_reader(sys.stdin)
+    if reader is None:
+        raise RuntimeError("Was not able to determine binary stream for sys.stdin.")
+    return reader
+
+
+def get_binary_stdout() -> t.BinaryIO:
+    writer = _find_binary_writer(sys.stdout)
+    if writer is None:
+        raise RuntimeError("Was not able to determine binary stream for sys.stdout.")
+    return writer
+
+
+def get_binary_stderr() -> t.BinaryIO:
+    writer = _find_binary_writer(sys.stderr)
+    if writer is None:
+        raise RuntimeError("Was not able to determine binary stream for sys.stderr.")
+    return writer
+
+
+def get_text_stdin(
+    encoding: t.Optional[str] = None, errors: t.Optional[str] = None
+) -> t.TextIO:
+    rv = _get_windows_console_stream(sys.stdin, encoding, errors)
+    if rv is not None:
+        return rv
+    return _force_correct_text_reader(sys.stdin, encoding, errors, force_readable=True)
+
+
+def get_text_stdout(
+    encoding: t.Optional[str] = None, errors: t.Optional[str] = None
+) -> t.TextIO:
+    rv = _get_windows_console_stream(sys.stdout, encoding, errors)
+    if rv is not None:
+        return rv
+    return _force_correct_text_writer(sys.stdout, encoding, errors, force_writable=True)
+
+
+def get_text_stderr(
+    encoding: t.Optional[str] = None, errors: t.Optional[str] = None
+) -> t.TextIO:
+    rv = _get_windows_console_stream(sys.stderr, encoding, errors)
+    if rv is not None:
+        return rv
+    return _force_correct_text_writer(sys.stderr, encoding, errors, force_writable=True)
+
+
+def _wrap_io_open(
+    file: t.Union[str, "os.PathLike[str]", int],
+    mode: str,
+    encoding: t.Optional[str],
+    errors: t.Optional[str],
+) -> t.IO[t.Any]:
+    """Handles not passing ``encoding`` and ``errors`` in binary mode."""
+    if "b" in mode:
+        return open(file, mode)
+
+    return open(file, mode, encoding=encoding, errors=errors)
+
+
+def open_stream(
+    filename: "t.Union[str, os.PathLike[str]]",
+    mode: str = "r",
+    encoding: t.Optional[str] = None,
+    errors: t.Optional[str] = "strict",
+    atomic: bool = False,
+) -> t.Tuple[t.IO[t.Any], bool]:
+    binary = "b" in mode
+    filename = os.fspath(filename)
+
+    # Standard streams first. These are simple because they ignore the
+    # atomic flag. Use fsdecode to handle Path("-").
+    if os.fsdecode(filename) == "-":
+        if any(m in mode for m in ["w", "a", "x"]):
+            if binary:
+                return get_binary_stdout(), False
+            return get_text_stdout(encoding=encoding, errors=errors), False
+        if binary:
+            return get_binary_stdin(), False
+        return get_text_stdin(encoding=encoding, errors=errors), False
+
+    # Non-atomic writes directly go out through the regular open functions.
+    if not atomic:
+        return _wrap_io_open(filename, mode, encoding, errors), True
+
+    # Some usability stuff for atomic writes
+    if "a" in mode:
+        raise ValueError(
+            "Appending to an existing file is not supported, because that"
+            " would involve an expensive `copy`-operation to a temporary"
+            " file. Open the file in normal `w`-mode and copy explicitly"
+            " if that's what you're after."
+        )
+    if "x" in mode:
+        raise ValueError("Use the `overwrite`-parameter instead.")
+    if "w" not in mode:
+        raise ValueError("Atomic writes only make sense with `w`-mode.")
+
+    # Atomic writes are more complicated.  They work by opening a file
+    # as a proxy in the same folder and then using the fdopen
+    # functionality to wrap it in a Python file.  Then we wrap it in an
+    # atomic file that moves the file over on close.
+    import errno
+    import random
+
+    try:
+        perm: t.Optional[int] = os.stat(filename).st_mode
+    except OSError:
+        perm = None
+
+    flags = os.O_RDWR | os.O_CREAT | os.O_EXCL
+
+    if binary:
+        flags |= getattr(os, "O_BINARY", 0)
+
+    while True:
+        tmp_filename = os.path.join(
+            os.path.dirname(filename),
+            f".__atomic-write{random.randrange(1 << 32):08x}",
+        )
+        try:
+            fd = os.open(tmp_filename, flags, 0o666 if perm is None else perm)
+            break
+        except OSError as e:
+            if e.errno == errno.EEXIST or (
+                os.name == "nt"
+                and e.errno == errno.EACCES
+                and os.path.isdir(e.filename)
+                and os.access(e.filename, os.W_OK)
+            ):
+                continue
+            raise
+
+    if perm is not None:
+        os.chmod(tmp_filename, perm)  # in case perm includes bits in umask
+
+    f = _wrap_io_open(fd, mode, encoding, errors)
+    af = _AtomicFile(f, tmp_filename, os.path.realpath(filename))
+    return t.cast(t.IO[t.Any], af), True
+
+
+class _AtomicFile:
+    def __init__(self, f: t.IO[t.Any], tmp_filename: str, real_filename: str) -> None:
+        self._f = f
+        self._tmp_filename = tmp_filename
+        self._real_filename = real_filename
+        self.closed = False
+
+    @property
+    def name(self) -> str:
+        return self._real_filename
+
+    def close(self, delete: bool = False) -> None:
+        if self.closed:
+            return
+        self._f.close()
+        os.replace(self._tmp_filename, self._real_filename)
+        self.closed = True
+
+    def __getattr__(self, name: str) -> t.Any:
+        return getattr(self._f, name)
+
+    def __enter__(self) -> "_AtomicFile":
+        return self
+
+    def __exit__(self, exc_type: t.Optional[t.Type[BaseException]], *_: t.Any) -> None:
+        self.close(delete=exc_type is not None)
+
+    def __repr__(self) -> str:
+        return repr(self._f)
+
+
+def strip_ansi(value: str) -> str:
+    return _ansi_re.sub("", value)
+
+
+def _is_jupyter_kernel_output(stream: t.IO[t.Any]) -> bool:
+    while isinstance(stream, (_FixupStream, _NonClosingTextIOWrapper)):
+        stream = stream._stream
+
+    return stream.__class__.__module__.startswith("ipykernel.")
+
+
+def should_strip_ansi(
+    stream: t.Optional[t.IO[t.Any]] = None, color: t.Optional[bool] = None
+) -> bool:
+    if color is None:
+        if stream is None:
+            stream = sys.stdin
+        return not isatty(stream) and not _is_jupyter_kernel_output(stream)
+    return not color
+
+
+# On Windows, wrap the output streams with colorama to support ANSI
+# color codes.
+# NOTE: double check is needed so mypy does not analyze this on Linux
+if sys.platform.startswith("win") and WIN:
+    from ._winconsole import _get_windows_console_stream
+
+    def _get_argv_encoding() -> str:
+        import locale
+
+        return locale.getpreferredencoding()
+
+    _ansi_stream_wrappers: t.MutableMapping[t.TextIO, t.TextIO] = WeakKeyDictionary()
+
+    def auto_wrap_for_ansi(  # noqa: F811
+        stream: t.TextIO, color: t.Optional[bool] = None
+    ) -> t.TextIO:
+        """Support ANSI color and style codes on Windows by wrapping a
+        stream with colorama.
+        """
+        try:
+            cached = _ansi_stream_wrappers.get(stream)
+        except Exception:
+            cached = None
+
+        if cached is not None:
+            return cached
+
+        import colorama
+
+        strip = should_strip_ansi(stream, color)
+        ansi_wrapper = colorama.AnsiToWin32(stream, strip=strip)
+        rv = t.cast(t.TextIO, ansi_wrapper.stream)
+        _write = rv.write
+
+        def _safe_write(s):
+            try:
+                return _write(s)
+            except BaseException:
+                ansi_wrapper.reset_all()
+                raise
+
+        rv.write = _safe_write
+
+        try:
+            _ansi_stream_wrappers[stream] = rv
+        except Exception:
+            pass
+
+        return rv
+
+else:
+
+    def _get_argv_encoding() -> str:
+        return getattr(sys.stdin, "encoding", None) or sys.getfilesystemencoding()
+
+    def _get_windows_console_stream(
+        f: t.TextIO, encoding: t.Optional[str], errors: t.Optional[str]
+    ) -> t.Optional[t.TextIO]:
+        return None
+
+
+def term_len(x: str) -> int:
+    return len(strip_ansi(x))
+
+
+def isatty(stream: t.IO[t.Any]) -> bool:
+    try:
+        return stream.isatty()
+    except Exception:
+        return False
+
+
+def _make_cached_stream_func(
+    src_func: t.Callable[[], t.Optional[t.TextIO]],
+    wrapper_func: t.Callable[[], t.TextIO],
+) -> t.Callable[[], t.Optional[t.TextIO]]:
+    cache: t.MutableMapping[t.TextIO, t.TextIO] = WeakKeyDictionary()
+
+    def func() -> t.Optional[t.TextIO]:
+        stream = src_func()
+
+        if stream is None:
+            return None
+
+        try:
+            rv = cache.get(stream)
+        except Exception:
+            rv = None
+        if rv is not None:
+            return rv
+        rv = wrapper_func()
+        try:
+            cache[stream] = rv
+        except Exception:
+            pass
+        return rv
+
+    return func
+
+
+_default_text_stdin = _make_cached_stream_func(lambda: sys.stdin, get_text_stdin)
+_default_text_stdout = _make_cached_stream_func(lambda: sys.stdout, get_text_stdout)
+_default_text_stderr = _make_cached_stream_func(lambda: sys.stderr, get_text_stderr)
+
+
+binary_streams: t.Mapping[str, t.Callable[[], t.BinaryIO]] = {
+    "stdin": get_binary_stdin,
+    "stdout": get_binary_stdout,
+    "stderr": get_binary_stderr,
+}
+
+text_streams: t.Mapping[
+    str, t.Callable[[t.Optional[str], t.Optional[str]], t.TextIO]
+] = {
+    "stdin": get_text_stdin,
+    "stdout": get_text_stdout,
+    "stderr": get_text_stderr,
+}
diff --git a/llm/Lib/site-packages/click/_termui_impl.py b/llm/Lib/site-packages/click/_termui_impl.py
new file mode 100644
index 0000000000000000000000000000000000000000..f744657753caa6cdef1dcc41a4f0b5e3e9503ab8
--- /dev/null
+++ b/llm/Lib/site-packages/click/_termui_impl.py
@@ -0,0 +1,739 @@
+"""
+This module contains implementations for the termui module. To keep the
+import time of Click down, some infrequently used functionality is
+placed in this module and only imported as needed.
+"""
+import contextlib
+import math
+import os
+import sys
+import time
+import typing as t
+from gettext import gettext as _
+from io import StringIO
+from types import TracebackType
+
+from ._compat import _default_text_stdout
+from ._compat import CYGWIN
+from ._compat import get_best_encoding
+from ._compat import isatty
+from ._compat import open_stream
+from ._compat import strip_ansi
+from ._compat import term_len
+from ._compat import WIN
+from .exceptions import ClickException
+from .utils import echo
+
+V = t.TypeVar("V")
+
+if os.name == "nt":
+    BEFORE_BAR = "\r"
+    AFTER_BAR = "\n"
+else:
+    BEFORE_BAR = "\r\033[?25l"
+    AFTER_BAR = "\033[?25h\n"
+
+
+class ProgressBar(t.Generic[V]):
+    def __init__(
+        self,
+        iterable: t.Optional[t.Iterable[V]],
+        length: t.Optional[int] = None,
+        fill_char: str = "#",
+        empty_char: str = " ",
+        bar_template: str = "%(bar)s",
+        info_sep: str = "  ",
+        show_eta: bool = True,
+        show_percent: t.Optional[bool] = None,
+        show_pos: bool = False,
+        item_show_func: t.Optional[t.Callable[[t.Optional[V]], t.Optional[str]]] = None,
+        label: t.Optional[str] = None,
+        file: t.Optional[t.TextIO] = None,
+        color: t.Optional[bool] = None,
+        update_min_steps: int = 1,
+        width: int = 30,
+    ) -> None:
+        self.fill_char = fill_char
+        self.empty_char = empty_char
+        self.bar_template = bar_template
+        self.info_sep = info_sep
+        self.show_eta = show_eta
+        self.show_percent = show_percent
+        self.show_pos = show_pos
+        self.item_show_func = item_show_func
+        self.label: str = label or ""
+
+        if file is None:
+            file = _default_text_stdout()
+
+            # There are no standard streams attached to write to. For example,
+            # pythonw on Windows.
+            if file is None:
+                file = StringIO()
+
+        self.file = file
+        self.color = color
+        self.update_min_steps = update_min_steps
+        self._completed_intervals = 0
+        self.width: int = width
+        self.autowidth: bool = width == 0
+
+        if length is None:
+            from operator import length_hint
+
+            length = length_hint(iterable, -1)
+
+            if length == -1:
+                length = None
+        if iterable is None:
+            if length is None:
+                raise TypeError("iterable or length is required")
+            iterable = t.cast(t.Iterable[V], range(length))
+        self.iter: t.Iterable[V] = iter(iterable)
+        self.length = length
+        self.pos = 0
+        self.avg: t.List[float] = []
+        self.last_eta: float
+        self.start: float
+        self.start = self.last_eta = time.time()
+        self.eta_known: bool = False
+        self.finished: bool = False
+        self.max_width: t.Optional[int] = None
+        self.entered: bool = False
+        self.current_item: t.Optional[V] = None
+        self.is_hidden: bool = not isatty(self.file)
+        self._last_line: t.Optional[str] = None
+
+    def __enter__(self) -> "ProgressBar[V]":
+        self.entered = True
+        self.render_progress()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: t.Optional[t.Type[BaseException]],
+        exc_value: t.Optional[BaseException],
+        tb: t.Optional[TracebackType],
+    ) -> None:
+        self.render_finish()
+
+    def __iter__(self) -> t.Iterator[V]:
+        if not self.entered:
+            raise RuntimeError("You need to use progress bars in a with block.")
+        self.render_progress()
+        return self.generator()
+
+    def __next__(self) -> V:
+        # Iteration is defined in terms of a generator function,
+        # returned by iter(self); use that to define next(). This works
+        # because `self.iter` is an iterable consumed by that generator,
+        # so it is re-entry safe. Calling `next(self.generator())`
+        # twice works and does "what you want".
+        return next(iter(self))
+
+    def render_finish(self) -> None:
+        if self.is_hidden:
+            return
+        self.file.write(AFTER_BAR)
+        self.file.flush()
+
+    @property
+    def pct(self) -> float:
+        if self.finished:
+            return 1.0
+        return min(self.pos / (float(self.length or 1) or 1), 1.0)
+
+    @property
+    def time_per_iteration(self) -> float:
+        if not self.avg:
+            return 0.0
+        return sum(self.avg) / float(len(self.avg))
+
+    @property
+    def eta(self) -> float:
+        if self.length is not None and not self.finished:
+            return self.time_per_iteration * (self.length - self.pos)
+        return 0.0
+
+    def format_eta(self) -> str:
+        if self.eta_known:
+            t = int(self.eta)
+            seconds = t % 60
+            t //= 60
+            minutes = t % 60
+            t //= 60
+            hours = t % 24
+            t //= 24
+            if t > 0:
+                return f"{t}d {hours:02}:{minutes:02}:{seconds:02}"
+            else:
+                return f"{hours:02}:{minutes:02}:{seconds:02}"
+        return ""
+
+    def format_pos(self) -> str:
+        pos = str(self.pos)
+        if self.length is not None:
+            pos += f"/{self.length}"
+        return pos
+
+    def format_pct(self) -> str:
+        return f"{int(self.pct * 100): 4}%"[1:]
+
+    def format_bar(self) -> str:
+        if self.length is not None:
+            bar_length = int(self.pct * self.width)
+            bar = self.fill_char * bar_length
+            bar += self.empty_char * (self.width - bar_length)
+        elif self.finished:
+            bar = self.fill_char * self.width
+        else:
+            chars = list(self.empty_char * (self.width or 1))
+            if self.time_per_iteration != 0:
+                chars[
+                    int(
+                        (math.cos(self.pos * self.time_per_iteration) / 2.0 + 0.5)
+                        * self.width
+                    )
+                ] = self.fill_char
+            bar = "".join(chars)
+        return bar
+
+    def format_progress_line(self) -> str:
+        show_percent = self.show_percent
+
+        info_bits = []
+        if self.length is not None and show_percent is None:
+            show_percent = not self.show_pos
+
+        if self.show_pos:
+            info_bits.append(self.format_pos())
+        if show_percent:
+            info_bits.append(self.format_pct())
+        if self.show_eta and self.eta_known and not self.finished:
+            info_bits.append(self.format_eta())
+        if self.item_show_func is not None:
+            item_info = self.item_show_func(self.current_item)
+            if item_info is not None:
+                info_bits.append(item_info)
+
+        return (
+            self.bar_template
+            % {
+                "label": self.label,
+                "bar": self.format_bar(),
+                "info": self.info_sep.join(info_bits),
+            }
+        ).rstrip()
+
+    def render_progress(self) -> None:
+        import shutil
+
+        if self.is_hidden:
+            # Only output the label as it changes if the output is not a
+            # TTY. Use file=stderr if you expect to be piping stdout.
+            if self._last_line != self.label:
+                self._last_line = self.label
+                echo(self.label, file=self.file, color=self.color)
+
+            return
+
+        buf = []
+        # Update width in case the terminal has been resized
+        if self.autowidth:
+            old_width = self.width
+            self.width = 0
+            clutter_length = term_len(self.format_progress_line())
+            new_width = max(0, shutil.get_terminal_size().columns - clutter_length)
+            if new_width < old_width:
+                buf.append(BEFORE_BAR)
+                buf.append(" " * self.max_width)  # type: ignore
+                self.max_width = new_width
+            self.width = new_width
+
+        clear_width = self.width
+        if self.max_width is not None:
+            clear_width = self.max_width
+
+        buf.append(BEFORE_BAR)
+        line = self.format_progress_line()
+        line_len = term_len(line)
+        if self.max_width is None or self.max_width < line_len:
+            self.max_width = line_len
+
+        buf.append(line)
+        buf.append(" " * (clear_width - line_len))
+        line = "".join(buf)
+        # Render the line only if it changed.
+
+        if line != self._last_line:
+            self._last_line = line
+            echo(line, file=self.file, color=self.color, nl=False)
+            self.file.flush()
+
+    def make_step(self, n_steps: int) -> None:
+        self.pos += n_steps
+        if self.length is not None and self.pos >= self.length:
+            self.finished = True
+
+        if (time.time() - self.last_eta) < 1.0:
+            return
+
+        self.last_eta = time.time()
+
+        # self.avg is a rolling list of length <= 7 of steps where steps are
+        # defined as time elapsed divided by the total progress through
+        # self.length.
+        if self.pos:
+            step = (time.time() - self.start) / self.pos
+        else:
+            step = time.time() - self.start
+
+        self.avg = self.avg[-6:] + [step]
+
+        self.eta_known = self.length is not None
+
+    def update(self, n_steps: int, current_item: t.Optional[V] = None) -> None:
+        """Update the progress bar by advancing a specified number of
+        steps, and optionally set the ``current_item`` for this new
+        position.
+
+        :param n_steps: Number of steps to advance.
+        :param current_item: Optional item to set as ``current_item``
+            for the updated position.
+
+        .. versionchanged:: 8.0
+            Added the ``current_item`` optional parameter.
+
+        .. versionchanged:: 8.0
+            Only render when the number of steps meets the
+            ``update_min_steps`` threshold.
+        """
+        if current_item is not None:
+            self.current_item = current_item
+
+        self._completed_intervals += n_steps
+
+        if self._completed_intervals >= self.update_min_steps:
+            self.make_step(self._completed_intervals)
+            self.render_progress()
+            self._completed_intervals = 0
+
+    def finish(self) -> None:
+        self.eta_known = False
+        self.current_item = None
+        self.finished = True
+
+    def generator(self) -> t.Iterator[V]:
+        """Return a generator which yields the items added to the bar
+        during construction, and updates the progress bar *after* the
+        yielded block returns.
+        """
+        # WARNING: the iterator interface for `ProgressBar` relies on
+        # this and only works because this is a simple generator which
+        # doesn't create or manage additional state. If this function
+        # changes, the impact should be evaluated both against
+        # `iter(bar)` and `next(bar)`. `next()` in particular may call
+        # `self.generator()` repeatedly, and this must remain safe in
+        # order for that interface to work.
+        if not self.entered:
+            raise RuntimeError("You need to use progress bars in a with block.")
+
+        if self.is_hidden:
+            yield from self.iter
+        else:
+            for rv in self.iter:
+                self.current_item = rv
+
+                # This allows show_item_func to be updated before the
+                # item is processed. Only trigger at the beginning of
+                # the update interval.
+                if self._completed_intervals == 0:
+                    self.render_progress()
+
+                yield rv
+                self.update(1)
+
+            self.finish()
+            self.render_progress()
+
+
+def pager(generator: t.Iterable[str], color: t.Optional[bool] = None) -> None:
+    """Decide what method to use for paging through text."""
+    stdout = _default_text_stdout()
+
+    # There are no standard streams attached to write to. For example,
+    # pythonw on Windows.
+    if stdout is None:
+        stdout = StringIO()
+
+    if not isatty(sys.stdin) or not isatty(stdout):
+        return _nullpager(stdout, generator, color)
+    pager_cmd = (os.environ.get("PAGER", None) or "").strip()
+    if pager_cmd:
+        if WIN:
+            return _tempfilepager(generator, pager_cmd, color)
+        return _pipepager(generator, pager_cmd, color)
+    if os.environ.get("TERM") in ("dumb", "emacs"):
+        return _nullpager(stdout, generator, color)
+    if WIN or sys.platform.startswith("os2"):
+        return _tempfilepager(generator, "more <", color)
+    if hasattr(os, "system") and os.system("(less) 2>/dev/null") == 0:
+        return _pipepager(generator, "less", color)
+
+    import tempfile
+
+    fd, filename = tempfile.mkstemp()
+    os.close(fd)
+    try:
+        if hasattr(os, "system") and os.system(f'more "{filename}"') == 0:
+            return _pipepager(generator, "more", color)
+        return _nullpager(stdout, generator, color)
+    finally:
+        os.unlink(filename)
+
+
+def _pipepager(generator: t.Iterable[str], cmd: str, color: t.Optional[bool]) -> None:
+    """Page through text by feeding it to another program.  Invoking a
+    pager through this might support colors.
+    """
+    import subprocess
+
+    env = dict(os.environ)
+
+    # If we're piping to less we might support colors under the
+    # condition that
+    cmd_detail = cmd.rsplit("/", 1)[-1].split()
+    if color is None and cmd_detail[0] == "less":
+        less_flags = f"{os.environ.get('LESS', '')}{' '.join(cmd_detail[1:])}"
+        if not less_flags:
+            env["LESS"] = "-R"
+            color = True
+        elif "r" in less_flags or "R" in less_flags:
+            color = True
+
+    c = subprocess.Popen(cmd, shell=True, stdin=subprocess.PIPE, env=env)
+    stdin = t.cast(t.BinaryIO, c.stdin)
+    encoding = get_best_encoding(stdin)
+    try:
+        for text in generator:
+            if not color:
+                text = strip_ansi(text)
+
+            stdin.write(text.encode(encoding, "replace"))
+    except (OSError, KeyboardInterrupt):
+        pass
+    else:
+        stdin.close()
+
+    # Less doesn't respect ^C, but catches it for its own UI purposes (aborting
+    # search or other commands inside less).
+    #
+    # That means when the user hits ^C, the parent process (click) terminates,
+    # but less is still alive, paging the output and messing up the terminal.
+    #
+    # If the user wants to make the pager exit on ^C, they should set
+    # `LESS='-K'`. It's not our decision to make.
+    while True:
+        try:
+            c.wait()
+        except KeyboardInterrupt:
+            pass
+        else:
+            break
+
+
+def _tempfilepager(
+    generator: t.Iterable[str], cmd: str, color: t.Optional[bool]
+) -> None:
+    """Page through text by invoking a program on a temporary file."""
+    import tempfile
+
+    fd, filename = tempfile.mkstemp()
+    # TODO: This never terminates if the passed generator never terminates.
+    text = "".join(generator)
+    if not color:
+        text = strip_ansi(text)
+    encoding = get_best_encoding(sys.stdout)
+    with open_stream(filename, "wb")[0] as f:
+        f.write(text.encode(encoding))
+    try:
+        os.system(f'{cmd} "{filename}"')
+    finally:
+        os.close(fd)
+        os.unlink(filename)
+
+
+def _nullpager(
+    stream: t.TextIO, generator: t.Iterable[str], color: t.Optional[bool]
+) -> None:
+    """Simply print unformatted text.  This is the ultimate fallback."""
+    for text in generator:
+        if not color:
+            text = strip_ansi(text)
+        stream.write(text)
+
+
+class Editor:
+    def __init__(
+        self,
+        editor: t.Optional[str] = None,
+        env: t.Optional[t.Mapping[str, str]] = None,
+        require_save: bool = True,
+        extension: str = ".txt",
+    ) -> None:
+        self.editor = editor
+        self.env = env
+        self.require_save = require_save
+        self.extension = extension
+
+    def get_editor(self) -> str:
+        if self.editor is not None:
+            return self.editor
+        for key in "VISUAL", "EDITOR":
+            rv = os.environ.get(key)
+            if rv:
+                return rv
+        if WIN:
+            return "notepad"
+        for editor in "sensible-editor", "vim", "nano":
+            if os.system(f"which {editor} >/dev/null 2>&1") == 0:
+                return editor
+        return "vi"
+
+    def edit_file(self, filename: str) -> None:
+        import subprocess
+
+        editor = self.get_editor()
+        environ: t.Optional[t.Dict[str, str]] = None
+
+        if self.env:
+            environ = os.environ.copy()
+            environ.update(self.env)
+
+        try:
+            c = subprocess.Popen(f'{editor} "{filename}"', env=environ, shell=True)
+            exit_code = c.wait()
+            if exit_code != 0:
+                raise ClickException(
+                    _("{editor}: Editing failed").format(editor=editor)
+                )
+        except OSError as e:
+            raise ClickException(
+                _("{editor}: Editing failed: {e}").format(editor=editor, e=e)
+            ) from e
+
+    def edit(self, text: t.Optional[t.AnyStr]) -> t.Optional[t.AnyStr]:
+        import tempfile
+
+        if not text:
+            data = b""
+        elif isinstance(text, (bytes, bytearray)):
+            data = text
+        else:
+            if text and not text.endswith("\n"):
+                text += "\n"
+
+            if WIN:
+                data = text.replace("\n", "\r\n").encode("utf-8-sig")
+            else:
+                data = text.encode("utf-8")
+
+        fd, name = tempfile.mkstemp(prefix="editor-", suffix=self.extension)
+        f: t.BinaryIO
+
+        try:
+            with os.fdopen(fd, "wb") as f:
+                f.write(data)
+
+            # If the filesystem resolution is 1 second, like Mac OS
+            # 10.12 Extended, or 2 seconds, like FAT32, and the editor
+            # closes very fast, require_save can fail. Set the modified
+            # time to be 2 seconds in the past to work around this.
+            os.utime(name, (os.path.getatime(name), os.path.getmtime(name) - 2))
+            # Depending on the resolution, the exact value might not be
+            # recorded, so get the new recorded value.
+            timestamp = os.path.getmtime(name)
+
+            self.edit_file(name)
+
+            if self.require_save and os.path.getmtime(name) == timestamp:
+                return None
+
+            with open(name, "rb") as f:
+                rv = f.read()
+
+            if isinstance(text, (bytes, bytearray)):
+                return rv
+
+            return rv.decode("utf-8-sig").replace("\r\n", "\n")  # type: ignore
+        finally:
+            os.unlink(name)
+
+
+def open_url(url: str, wait: bool = False, locate: bool = False) -> int:
+    import subprocess
+
+    def _unquote_file(url: str) -> str:
+        from urllib.parse import unquote
+
+        if url.startswith("file://"):
+            url = unquote(url[7:])
+
+        return url
+
+    if sys.platform == "darwin":
+        args = ["open"]
+        if wait:
+            args.append("-W")
+        if locate:
+            args.append("-R")
+        args.append(_unquote_file(url))
+        null = open("/dev/null", "w")
+        try:
+            return subprocess.Popen(args, stderr=null).wait()
+        finally:
+            null.close()
+    elif WIN:
+        if locate:
+            url = _unquote_file(url.replace('"', ""))
+            args = f'explorer /select,"{url}"'
+        else:
+            url = url.replace('"', "")
+            wait_str = "/WAIT" if wait else ""
+            args = f'start {wait_str} "" "{url}"'
+        return os.system(args)
+    elif CYGWIN:
+        if locate:
+            url = os.path.dirname(_unquote_file(url).replace('"', ""))
+            args = f'cygstart "{url}"'
+        else:
+            url = url.replace('"', "")
+            wait_str = "-w" if wait else ""
+            args = f'cygstart {wait_str} "{url}"'
+        return os.system(args)
+
+    try:
+        if locate:
+            url = os.path.dirname(_unquote_file(url)) or "."
+        else:
+            url = _unquote_file(url)
+        c = subprocess.Popen(["xdg-open", url])
+        if wait:
+            return c.wait()
+        return 0
+    except OSError:
+        if url.startswith(("http://", "https://")) and not locate and not wait:
+            import webbrowser
+
+            webbrowser.open(url)
+            return 0
+        return 1
+
+
+def _translate_ch_to_exc(ch: str) -> t.Optional[BaseException]:
+    if ch == "\x03":
+        raise KeyboardInterrupt()
+
+    if ch == "\x04" and not WIN:  # Unix-like, Ctrl+D
+        raise EOFError()
+
+    if ch == "\x1a" and WIN:  # Windows, Ctrl+Z
+        raise EOFError()
+
+    return None
+
+
+if WIN:
+    import msvcrt
+
+    @contextlib.contextmanager
+    def raw_terminal() -> t.Iterator[int]:
+        yield -1
+
+    def getchar(echo: bool) -> str:
+        # The function `getch` will return a bytes object corresponding to
+        # the pressed character. Since Windows 10 build 1803, it will also
+        # return \x00 when called a second time after pressing a regular key.
+        #
+        # `getwch` does not share this probably-bugged behavior. Moreover, it
+        # returns a Unicode object by default, which is what we want.
+        #
+        # Either of these functions will return \x00 or \xe0 to indicate
+        # a special key, and you need to call the same function again to get
+        # the "rest" of the code. The fun part is that \u00e0 is
+        # "latin small letter a with grave", so if you type that on a French
+        # keyboard, you _also_ get a \xe0.
+        # E.g., consider the Up arrow. This returns \xe0 and then \x48. The
+        # resulting Unicode string reads as "a with grave" + "capital H".
+        # This is indistinguishable from when the user actually types
+        # "a with grave" and then "capital H".
+        #
+        # When \xe0 is returned, we assume it's part of a special-key sequence
+        # and call `getwch` again, but that means that when the user types
+        # the \u00e0 character, `getchar` doesn't return until a second
+        # character is typed.
+        # The alternative is returning immediately, but that would mess up
+        # cross-platform handling of arrow keys and others that start with
+        # \xe0. Another option is using `getch`, but then we can't reliably
+        # read non-ASCII characters, because return values of `getch` are
+        # limited to the current 8-bit codepage.
+        #
+        # Anyway, Click doesn't claim to do this Right(tm), and using `getwch`
+        # is doing the right thing in more situations than with `getch`.
+        func: t.Callable[[], str]
+
+        if echo:
+            func = msvcrt.getwche  # type: ignore
+        else:
+            func = msvcrt.getwch  # type: ignore
+
+        rv = func()
+
+        if rv in ("\x00", "\xe0"):
+            # \x00 and \xe0 are control characters that indicate special key,
+            # see above.
+            rv += func()
+
+        _translate_ch_to_exc(rv)
+        return rv
+
+else:
+    import tty
+    import termios
+
+    @contextlib.contextmanager
+    def raw_terminal() -> t.Iterator[int]:
+        f: t.Optional[t.TextIO]
+        fd: int
+
+        if not isatty(sys.stdin):
+            f = open("/dev/tty")
+            fd = f.fileno()
+        else:
+            fd = sys.stdin.fileno()
+            f = None
+
+        try:
+            old_settings = termios.tcgetattr(fd)
+
+            try:
+                tty.setraw(fd)
+                yield fd
+            finally:
+                termios.tcsetattr(fd, termios.TCSADRAIN, old_settings)
+                sys.stdout.flush()
+
+                if f is not None:
+                    f.close()
+        except termios.error:
+            pass
+
+    def getchar(echo: bool) -> str:
+        with raw_terminal() as fd:
+            ch = os.read(fd, 32).decode(get_best_encoding(sys.stdin), "replace")
+
+            if echo and isatty(sys.stdout):
+                sys.stdout.write(ch)
+
+            _translate_ch_to_exc(ch)
+            return ch
diff --git a/llm/Lib/site-packages/click/_textwrap.py b/llm/Lib/site-packages/click/_textwrap.py
new file mode 100644
index 0000000000000000000000000000000000000000..b47dcbd4264e86715adfae1c5124c288b67a983e
--- /dev/null
+++ b/llm/Lib/site-packages/click/_textwrap.py
@@ -0,0 +1,49 @@
+import textwrap
+import typing as t
+from contextlib import contextmanager
+
+
+class TextWrapper(textwrap.TextWrapper):
+    def _handle_long_word(
+        self,
+        reversed_chunks: t.List[str],
+        cur_line: t.List[str],
+        cur_len: int,
+        width: int,
+    ) -> None:
+        space_left = max(width - cur_len, 1)
+
+        if self.break_long_words:
+            last = reversed_chunks[-1]
+            cut = last[:space_left]
+            res = last[space_left:]
+            cur_line.append(cut)
+            reversed_chunks[-1] = res
+        elif not cur_line:
+            cur_line.append(reversed_chunks.pop())
+
+    @contextmanager
+    def extra_indent(self, indent: str) -> t.Iterator[None]:
+        old_initial_indent = self.initial_indent
+        old_subsequent_indent = self.subsequent_indent
+        self.initial_indent += indent
+        self.subsequent_indent += indent
+
+        try:
+            yield
+        finally:
+            self.initial_indent = old_initial_indent
+            self.subsequent_indent = old_subsequent_indent
+
+    def indent_only(self, text: str) -> str:
+        rv = []
+
+        for idx, line in enumerate(text.splitlines()):
+            indent = self.initial_indent
+
+            if idx > 0:
+                indent = self.subsequent_indent
+
+            rv.append(f"{indent}{line}")
+
+        return "\n".join(rv)
diff --git a/llm/Lib/site-packages/click/_winconsole.py b/llm/Lib/site-packages/click/_winconsole.py
new file mode 100644
index 0000000000000000000000000000000000000000..6b20df315b23ecd1e3d0ec32c11c0b5ced577efe
--- /dev/null
+++ b/llm/Lib/site-packages/click/_winconsole.py
@@ -0,0 +1,279 @@
+# This module is based on the excellent work by Adam Bartoš who
+# provided a lot of what went into the implementation here in
+# the discussion to issue1602 in the Python bug tracker.
+#
+# There are some general differences in regards to how this works
+# compared to the original patches as we do not need to patch
+# the entire interpreter but just work in our little world of
+# echo and prompt.
+import io
+import sys
+import time
+import typing as t
+from ctypes import byref
+from ctypes import c_char
+from ctypes import c_char_p
+from ctypes import c_int
+from ctypes import c_ssize_t
+from ctypes import c_ulong
+from ctypes import c_void_p
+from ctypes import POINTER
+from ctypes import py_object
+from ctypes import Structure
+from ctypes.wintypes import DWORD
+from ctypes.wintypes import HANDLE
+from ctypes.wintypes import LPCWSTR
+from ctypes.wintypes import LPWSTR
+
+from ._compat import _NonClosingTextIOWrapper
+
+assert sys.platform == "win32"
+import msvcrt  # noqa: E402
+from ctypes import windll  # noqa: E402
+from ctypes import WINFUNCTYPE  # noqa: E402
+
+c_ssize_p = POINTER(c_ssize_t)
+
+kernel32 = windll.kernel32
+GetStdHandle = kernel32.GetStdHandle
+ReadConsoleW = kernel32.ReadConsoleW
+WriteConsoleW = kernel32.WriteConsoleW
+GetConsoleMode = kernel32.GetConsoleMode
+GetLastError = kernel32.GetLastError
+GetCommandLineW = WINFUNCTYPE(LPWSTR)(("GetCommandLineW", windll.kernel32))
+CommandLineToArgvW = WINFUNCTYPE(POINTER(LPWSTR), LPCWSTR, POINTER(c_int))(
+    ("CommandLineToArgvW", windll.shell32)
+)
+LocalFree = WINFUNCTYPE(c_void_p, c_void_p)(("LocalFree", windll.kernel32))
+
+STDIN_HANDLE = GetStdHandle(-10)
+STDOUT_HANDLE = GetStdHandle(-11)
+STDERR_HANDLE = GetStdHandle(-12)
+
+PyBUF_SIMPLE = 0
+PyBUF_WRITABLE = 1
+
+ERROR_SUCCESS = 0
+ERROR_NOT_ENOUGH_MEMORY = 8
+ERROR_OPERATION_ABORTED = 995
+
+STDIN_FILENO = 0
+STDOUT_FILENO = 1
+STDERR_FILENO = 2
+
+EOF = b"\x1a"
+MAX_BYTES_WRITTEN = 32767
+
+try:
+    from ctypes import pythonapi
+except ImportError:
+    # On PyPy we cannot get buffers so our ability to operate here is
+    # severely limited.
+    get_buffer = None
+else:
+
+    class Py_buffer(Structure):
+        _fields_ = [
+            ("buf", c_void_p),
+            ("obj", py_object),
+            ("len", c_ssize_t),
+            ("itemsize", c_ssize_t),
+            ("readonly", c_int),
+            ("ndim", c_int),
+            ("format", c_char_p),
+            ("shape", c_ssize_p),
+            ("strides", c_ssize_p),
+            ("suboffsets", c_ssize_p),
+            ("internal", c_void_p),
+        ]
+
+    PyObject_GetBuffer = pythonapi.PyObject_GetBuffer
+    PyBuffer_Release = pythonapi.PyBuffer_Release
+
+    def get_buffer(obj, writable=False):
+        buf = Py_buffer()
+        flags = PyBUF_WRITABLE if writable else PyBUF_SIMPLE
+        PyObject_GetBuffer(py_object(obj), byref(buf), flags)
+
+        try:
+            buffer_type = c_char * buf.len
+            return buffer_type.from_address(buf.buf)
+        finally:
+            PyBuffer_Release(byref(buf))
+
+
+class _WindowsConsoleRawIOBase(io.RawIOBase):
+    def __init__(self, handle):
+        self.handle = handle
+
+    def isatty(self):
+        super().isatty()
+        return True
+
+
+class _WindowsConsoleReader(_WindowsConsoleRawIOBase):
+    def readable(self):
+        return True
+
+    def readinto(self, b):
+        bytes_to_be_read = len(b)
+        if not bytes_to_be_read:
+            return 0
+        elif bytes_to_be_read % 2:
+            raise ValueError(
+                "cannot read odd number of bytes from UTF-16-LE encoded console"
+            )
+
+        buffer = get_buffer(b, writable=True)
+        code_units_to_be_read = bytes_to_be_read // 2
+        code_units_read = c_ulong()
+
+        rv = ReadConsoleW(
+            HANDLE(self.handle),
+            buffer,
+            code_units_to_be_read,
+            byref(code_units_read),
+            None,
+        )
+        if GetLastError() == ERROR_OPERATION_ABORTED:
+            # wait for KeyboardInterrupt
+            time.sleep(0.1)
+        if not rv:
+            raise OSError(f"Windows error: {GetLastError()}")
+
+        if buffer[0] == EOF:
+            return 0
+        return 2 * code_units_read.value
+
+
+class _WindowsConsoleWriter(_WindowsConsoleRawIOBase):
+    def writable(self):
+        return True
+
+    @staticmethod
+    def _get_error_message(errno):
+        if errno == ERROR_SUCCESS:
+            return "ERROR_SUCCESS"
+        elif errno == ERROR_NOT_ENOUGH_MEMORY:
+            return "ERROR_NOT_ENOUGH_MEMORY"
+        return f"Windows error {errno}"
+
+    def write(self, b):
+        bytes_to_be_written = len(b)
+        buf = get_buffer(b)
+        code_units_to_be_written = min(bytes_to_be_written, MAX_BYTES_WRITTEN) // 2
+        code_units_written = c_ulong()
+
+        WriteConsoleW(
+            HANDLE(self.handle),
+            buf,
+            code_units_to_be_written,
+            byref(code_units_written),
+            None,
+        )
+        bytes_written = 2 * code_units_written.value
+
+        if bytes_written == 0 and bytes_to_be_written > 0:
+            raise OSError(self._get_error_message(GetLastError()))
+        return bytes_written
+
+
+class ConsoleStream:
+    def __init__(self, text_stream: t.TextIO, byte_stream: t.BinaryIO) -> None:
+        self._text_stream = text_stream
+        self.buffer = byte_stream
+
+    @property
+    def name(self) -> str:
+        return self.buffer.name
+
+    def write(self, x: t.AnyStr) -> int:
+        if isinstance(x, str):
+            return self._text_stream.write(x)
+        try:
+            self.flush()
+        except Exception:
+            pass
+        return self.buffer.write(x)
+
+    def writelines(self, lines: t.Iterable[t.AnyStr]) -> None:
+        for line in lines:
+            self.write(line)
+
+    def __getattr__(self, name: str) -> t.Any:
+        return getattr(self._text_stream, name)
+
+    def isatty(self) -> bool:
+        return self.buffer.isatty()
+
+    def __repr__(self):
+        return f"<ConsoleStream name={self.name!r} encoding={self.encoding!r}>"
+
+
+def _get_text_stdin(buffer_stream: t.BinaryIO) -> t.TextIO:
+    text_stream = _NonClosingTextIOWrapper(
+        io.BufferedReader(_WindowsConsoleReader(STDIN_HANDLE)),
+        "utf-16-le",
+        "strict",
+        line_buffering=True,
+    )
+    return t.cast(t.TextIO, ConsoleStream(text_stream, buffer_stream))
+
+
+def _get_text_stdout(buffer_stream: t.BinaryIO) -> t.TextIO:
+    text_stream = _NonClosingTextIOWrapper(
+        io.BufferedWriter(_WindowsConsoleWriter(STDOUT_HANDLE)),
+        "utf-16-le",
+        "strict",
+        line_buffering=True,
+    )
+    return t.cast(t.TextIO, ConsoleStream(text_stream, buffer_stream))
+
+
+def _get_text_stderr(buffer_stream: t.BinaryIO) -> t.TextIO:
+    text_stream = _NonClosingTextIOWrapper(
+        io.BufferedWriter(_WindowsConsoleWriter(STDERR_HANDLE)),
+        "utf-16-le",
+        "strict",
+        line_buffering=True,
+    )
+    return t.cast(t.TextIO, ConsoleStream(text_stream, buffer_stream))
+
+
+_stream_factories: t.Mapping[int, t.Callable[[t.BinaryIO], t.TextIO]] = {
+    0: _get_text_stdin,
+    1: _get_text_stdout,
+    2: _get_text_stderr,
+}
+
+
+def _is_console(f: t.TextIO) -> bool:
+    if not hasattr(f, "fileno"):
+        return False
+
+    try:
+        fileno = f.fileno()
+    except (OSError, io.UnsupportedOperation):
+        return False
+
+    handle = msvcrt.get_osfhandle(fileno)
+    return bool(GetConsoleMode(handle, byref(DWORD())))
+
+
+def _get_windows_console_stream(
+    f: t.TextIO, encoding: t.Optional[str], errors: t.Optional[str]
+) -> t.Optional[t.TextIO]:
+    if (
+        get_buffer is not None
+        and encoding in {"utf-16-le", None}
+        and errors in {"strict", None}
+        and _is_console(f)
+    ):
+        func = _stream_factories.get(f.fileno())
+        if func is not None:
+            b = getattr(f, "buffer", None)
+
+            if b is None:
+                return None
+
+            return func(b)
diff --git a/llm/Lib/site-packages/click/core.py b/llm/Lib/site-packages/click/core.py
new file mode 100644
index 0000000000000000000000000000000000000000..cc65e896bf2d754d74b54a84ac501b80127f83ca
--- /dev/null
+++ b/llm/Lib/site-packages/click/core.py
@@ -0,0 +1,3042 @@
+import enum
+import errno
+import inspect
+import os
+import sys
+import typing as t
+from collections import abc
+from contextlib import contextmanager
+from contextlib import ExitStack
+from functools import update_wrapper
+from gettext import gettext as _
+from gettext import ngettext
+from itertools import repeat
+from types import TracebackType
+
+from . import types
+from .exceptions import Abort
+from .exceptions import BadParameter
+from .exceptions import ClickException
+from .exceptions import Exit
+from .exceptions import MissingParameter
+from .exceptions import UsageError
+from .formatting import HelpFormatter
+from .formatting import join_options
+from .globals import pop_context
+from .globals import push_context
+from .parser import _flag_needs_value
+from .parser import OptionParser
+from .parser import split_opt
+from .termui import confirm
+from .termui import prompt
+from .termui import style
+from .utils import _detect_program_name
+from .utils import _expand_args
+from .utils import echo
+from .utils import make_default_short_help
+from .utils import make_str
+from .utils import PacifyFlushWrapper
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+    from .shell_completion import CompletionItem
+
+F = t.TypeVar("F", bound=t.Callable[..., t.Any])
+V = t.TypeVar("V")
+
+
+def _complete_visible_commands(
+    ctx: "Context", incomplete: str
+) -> t.Iterator[t.Tuple[str, "Command"]]:
+    """List all the subcommands of a group that start with the
+    incomplete value and aren't hidden.
+
+    :param ctx: Invocation context for the group.
+    :param incomplete: Value being completed. May be empty.
+    """
+    multi = t.cast(MultiCommand, ctx.command)
+
+    for name in multi.list_commands(ctx):
+        if name.startswith(incomplete):
+            command = multi.get_command(ctx, name)
+
+            if command is not None and not command.hidden:
+                yield name, command
+
+
+def _check_multicommand(
+    base_command: "MultiCommand", cmd_name: str, cmd: "Command", register: bool = False
+) -> None:
+    if not base_command.chain or not isinstance(cmd, MultiCommand):
+        return
+    if register:
+        hint = (
+            "It is not possible to add multi commands as children to"
+            " another multi command that is in chain mode."
+        )
+    else:
+        hint = (
+            "Found a multi command as subcommand to a multi command"
+            " that is in chain mode. This is not supported."
+        )
+    raise RuntimeError(
+        f"{hint}. Command {base_command.name!r} is set to chain and"
+        f" {cmd_name!r} was added as a subcommand but it in itself is a"
+        f" multi command. ({cmd_name!r} is a {type(cmd).__name__}"
+        f" within a chained {type(base_command).__name__} named"
+        f" {base_command.name!r})."
+    )
+
+
+def batch(iterable: t.Iterable[V], batch_size: int) -> t.List[t.Tuple[V, ...]]:
+    return list(zip(*repeat(iter(iterable), batch_size)))
+
+
+@contextmanager
+def augment_usage_errors(
+    ctx: "Context", param: t.Optional["Parameter"] = None
+) -> t.Iterator[None]:
+    """Context manager that attaches extra information to exceptions."""
+    try:
+        yield
+    except BadParameter as e:
+        if e.ctx is None:
+            e.ctx = ctx
+        if param is not None and e.param is None:
+            e.param = param
+        raise
+    except UsageError as e:
+        if e.ctx is None:
+            e.ctx = ctx
+        raise
+
+
+def iter_params_for_processing(
+    invocation_order: t.Sequence["Parameter"],
+    declaration_order: t.Sequence["Parameter"],
+) -> t.List["Parameter"]:
+    """Given a sequence of parameters in the order as should be considered
+    for processing and an iterable of parameters that exist, this returns
+    a list in the correct order as they should be processed.
+    """
+
+    def sort_key(item: "Parameter") -> t.Tuple[bool, float]:
+        try:
+            idx: float = invocation_order.index(item)
+        except ValueError:
+            idx = float("inf")
+
+        return not item.is_eager, idx
+
+    return sorted(declaration_order, key=sort_key)
+
+
+class ParameterSource(enum.Enum):
+    """This is an :class:`~enum.Enum` that indicates the source of a
+    parameter's value.
+
+    Use :meth:`click.Context.get_parameter_source` to get the
+    source for a parameter by name.
+
+    .. versionchanged:: 8.0
+        Use :class:`~enum.Enum` and drop the ``validate`` method.
+
+    .. versionchanged:: 8.0
+        Added the ``PROMPT`` value.
+    """
+
+    COMMANDLINE = enum.auto()
+    """The value was provided by the command line args."""
+    ENVIRONMENT = enum.auto()
+    """The value was provided with an environment variable."""
+    DEFAULT = enum.auto()
+    """Used the default specified by the parameter."""
+    DEFAULT_MAP = enum.auto()
+    """Used a default provided by :attr:`Context.default_map`."""
+    PROMPT = enum.auto()
+    """Used a prompt to confirm a default or provide a value."""
+
+
+class Context:
+    """The context is a special internal object that holds state relevant
+    for the script execution at every single level.  It's normally invisible
+    to commands unless they opt-in to getting access to it.
+
+    The context is useful as it can pass internal objects around and can
+    control special execution features such as reading data from
+    environment variables.
+
+    A context can be used as context manager in which case it will call
+    :meth:`close` on teardown.
+
+    :param command: the command class for this context.
+    :param parent: the parent context.
+    :param info_name: the info name for this invocation.  Generally this
+                      is the most descriptive name for the script or
+                      command.  For the toplevel script it is usually
+                      the name of the script, for commands below it it's
+                      the name of the script.
+    :param obj: an arbitrary object of user data.
+    :param auto_envvar_prefix: the prefix to use for automatic environment
+                               variables.  If this is `None` then reading
+                               from environment variables is disabled.  This
+                               does not affect manually set environment
+                               variables which are always read.
+    :param default_map: a dictionary (like object) with default values
+                        for parameters.
+    :param terminal_width: the width of the terminal.  The default is
+                           inherit from parent context.  If no context
+                           defines the terminal width then auto
+                           detection will be applied.
+    :param max_content_width: the maximum width for content rendered by
+                              Click (this currently only affects help
+                              pages).  This defaults to 80 characters if
+                              not overridden.  In other words: even if the
+                              terminal is larger than that, Click will not
+                              format things wider than 80 characters by
+                              default.  In addition to that, formatters might
+                              add some safety mapping on the right.
+    :param resilient_parsing: if this flag is enabled then Click will
+                              parse without any interactivity or callback
+                              invocation.  Default values will also be
+                              ignored.  This is useful for implementing
+                              things such as completion support.
+    :param allow_extra_args: if this is set to `True` then extra arguments
+                             at the end will not raise an error and will be
+                             kept on the context.  The default is to inherit
+                             from the command.
+    :param allow_interspersed_args: if this is set to `False` then options
+                                    and arguments cannot be mixed.  The
+                                    default is to inherit from the command.
+    :param ignore_unknown_options: instructs click to ignore options it does
+                                   not know and keeps them for later
+                                   processing.
+    :param help_option_names: optionally a list of strings that define how
+                              the default help parameter is named.  The
+                              default is ``['--help']``.
+    :param token_normalize_func: an optional function that is used to
+                                 normalize tokens (options, choices,
+                                 etc.).  This for instance can be used to
+                                 implement case insensitive behavior.
+    :param color: controls if the terminal supports ANSI colors or not.  The
+                  default is autodetection.  This is only needed if ANSI
+                  codes are used in texts that Click prints which is by
+                  default not the case.  This for instance would affect
+                  help output.
+    :param show_default: Show the default value for commands. If this
+        value is not set, it defaults to the value from the parent
+        context. ``Command.show_default`` overrides this default for the
+        specific command.
+
+    .. versionchanged:: 8.1
+        The ``show_default`` parameter is overridden by
+        ``Command.show_default``, instead of the other way around.
+
+    .. versionchanged:: 8.0
+        The ``show_default`` parameter defaults to the value from the
+        parent context.
+
+    .. versionchanged:: 7.1
+       Added the ``show_default`` parameter.
+
+    .. versionchanged:: 4.0
+        Added the ``color``, ``ignore_unknown_options``, and
+        ``max_content_width`` parameters.
+
+    .. versionchanged:: 3.0
+        Added the ``allow_extra_args`` and ``allow_interspersed_args``
+        parameters.
+
+    .. versionchanged:: 2.0
+        Added the ``resilient_parsing``, ``help_option_names``, and
+        ``token_normalize_func`` parameters.
+    """
+
+    #: The formatter class to create with :meth:`make_formatter`.
+    #:
+    #: .. versionadded:: 8.0
+    formatter_class: t.Type["HelpFormatter"] = HelpFormatter
+
+    def __init__(
+        self,
+        command: "Command",
+        parent: t.Optional["Context"] = None,
+        info_name: t.Optional[str] = None,
+        obj: t.Optional[t.Any] = None,
+        auto_envvar_prefix: t.Optional[str] = None,
+        default_map: t.Optional[t.MutableMapping[str, t.Any]] = None,
+        terminal_width: t.Optional[int] = None,
+        max_content_width: t.Optional[int] = None,
+        resilient_parsing: bool = False,
+        allow_extra_args: t.Optional[bool] = None,
+        allow_interspersed_args: t.Optional[bool] = None,
+        ignore_unknown_options: t.Optional[bool] = None,
+        help_option_names: t.Optional[t.List[str]] = None,
+        token_normalize_func: t.Optional[t.Callable[[str], str]] = None,
+        color: t.Optional[bool] = None,
+        show_default: t.Optional[bool] = None,
+    ) -> None:
+        #: the parent context or `None` if none exists.
+        self.parent = parent
+        #: the :class:`Command` for this context.
+        self.command = command
+        #: the descriptive information name
+        self.info_name = info_name
+        #: Map of parameter names to their parsed values. Parameters
+        #: with ``expose_value=False`` are not stored.
+        self.params: t.Dict[str, t.Any] = {}
+        #: the leftover arguments.
+        self.args: t.List[str] = []
+        #: protected arguments.  These are arguments that are prepended
+        #: to `args` when certain parsing scenarios are encountered but
+        #: must be never propagated to another arguments.  This is used
+        #: to implement nested parsing.
+        self.protected_args: t.List[str] = []
+        #: the collected prefixes of the command's options.
+        self._opt_prefixes: t.Set[str] = set(parent._opt_prefixes) if parent else set()
+
+        if obj is None and parent is not None:
+            obj = parent.obj
+
+        #: the user object stored.
+        self.obj: t.Any = obj
+        self._meta: t.Dict[str, t.Any] = getattr(parent, "meta", {})
+
+        #: A dictionary (-like object) with defaults for parameters.
+        if (
+            default_map is None
+            and info_name is not None
+            and parent is not None
+            and parent.default_map is not None
+        ):
+            default_map = parent.default_map.get(info_name)
+
+        self.default_map: t.Optional[t.MutableMapping[str, t.Any]] = default_map
+
+        #: This flag indicates if a subcommand is going to be executed. A
+        #: group callback can use this information to figure out if it's
+        #: being executed directly or because the execution flow passes
+        #: onwards to a subcommand. By default it's None, but it can be
+        #: the name of the subcommand to execute.
+        #:
+        #: If chaining is enabled this will be set to ``'*'`` in case
+        #: any commands are executed.  It is however not possible to
+        #: figure out which ones.  If you require this knowledge you
+        #: should use a :func:`result_callback`.
+        self.invoked_subcommand: t.Optional[str] = None
+
+        if terminal_width is None and parent is not None:
+            terminal_width = parent.terminal_width
+
+        #: The width of the terminal (None is autodetection).
+        self.terminal_width: t.Optional[int] = terminal_width
+
+        if max_content_width is None and parent is not None:
+            max_content_width = parent.max_content_width
+
+        #: The maximum width of formatted content (None implies a sensible
+        #: default which is 80 for most things).
+        self.max_content_width: t.Optional[int] = max_content_width
+
+        if allow_extra_args is None:
+            allow_extra_args = command.allow_extra_args
+
+        #: Indicates if the context allows extra args or if it should
+        #: fail on parsing.
+        #:
+        #: .. versionadded:: 3.0
+        self.allow_extra_args = allow_extra_args
+
+        if allow_interspersed_args is None:
+            allow_interspersed_args = command.allow_interspersed_args
+
+        #: Indicates if the context allows mixing of arguments and
+        #: options or not.
+        #:
+        #: .. versionadded:: 3.0
+        self.allow_interspersed_args: bool = allow_interspersed_args
+
+        if ignore_unknown_options is None:
+            ignore_unknown_options = command.ignore_unknown_options
+
+        #: Instructs click to ignore options that a command does not
+        #: understand and will store it on the context for later
+        #: processing.  This is primarily useful for situations where you
+        #: want to call into external programs.  Generally this pattern is
+        #: strongly discouraged because it's not possibly to losslessly
+        #: forward all arguments.
+        #:
+        #: .. versionadded:: 4.0
+        self.ignore_unknown_options: bool = ignore_unknown_options
+
+        if help_option_names is None:
+            if parent is not None:
+                help_option_names = parent.help_option_names
+            else:
+                help_option_names = ["--help"]
+
+        #: The names for the help options.
+        self.help_option_names: t.List[str] = help_option_names
+
+        if token_normalize_func is None and parent is not None:
+            token_normalize_func = parent.token_normalize_func
+
+        #: An optional normalization function for tokens.  This is
+        #: options, choices, commands etc.
+        self.token_normalize_func: t.Optional[
+            t.Callable[[str], str]
+        ] = token_normalize_func
+
+        #: Indicates if resilient parsing is enabled.  In that case Click
+        #: will do its best to not cause any failures and default values
+        #: will be ignored. Useful for completion.
+        self.resilient_parsing: bool = resilient_parsing
+
+        # If there is no envvar prefix yet, but the parent has one and
+        # the command on this level has a name, we can expand the envvar
+        # prefix automatically.
+        if auto_envvar_prefix is None:
+            if (
+                parent is not None
+                and parent.auto_envvar_prefix is not None
+                and self.info_name is not None
+            ):
+                auto_envvar_prefix = (
+                    f"{parent.auto_envvar_prefix}_{self.info_name.upper()}"
+                )
+        else:
+            auto_envvar_prefix = auto_envvar_prefix.upper()
+
+        if auto_envvar_prefix is not None:
+            auto_envvar_prefix = auto_envvar_prefix.replace("-", "_")
+
+        self.auto_envvar_prefix: t.Optional[str] = auto_envvar_prefix
+
+        if color is None and parent is not None:
+            color = parent.color
+
+        #: Controls if styling output is wanted or not.
+        self.color: t.Optional[bool] = color
+
+        if show_default is None and parent is not None:
+            show_default = parent.show_default
+
+        #: Show option default values when formatting help text.
+        self.show_default: t.Optional[bool] = show_default
+
+        self._close_callbacks: t.List[t.Callable[[], t.Any]] = []
+        self._depth = 0
+        self._parameter_source: t.Dict[str, ParameterSource] = {}
+        self._exit_stack = ExitStack()
+
+    def to_info_dict(self) -> t.Dict[str, t.Any]:
+        """Gather information that could be useful for a tool generating
+        user-facing documentation. This traverses the entire CLI
+        structure.
+
+        .. code-block:: python
+
+            with Context(cli) as ctx:
+                info = ctx.to_info_dict()
+
+        .. versionadded:: 8.0
+        """
+        return {
+            "command": self.command.to_info_dict(self),
+            "info_name": self.info_name,
+            "allow_extra_args": self.allow_extra_args,
+            "allow_interspersed_args": self.allow_interspersed_args,
+            "ignore_unknown_options": self.ignore_unknown_options,
+            "auto_envvar_prefix": self.auto_envvar_prefix,
+        }
+
+    def __enter__(self) -> "Context":
+        self._depth += 1
+        push_context(self)
+        return self
+
+    def __exit__(
+        self,
+        exc_type: t.Optional[t.Type[BaseException]],
+        exc_value: t.Optional[BaseException],
+        tb: t.Optional[TracebackType],
+    ) -> None:
+        self._depth -= 1
+        if self._depth == 0:
+            self.close()
+        pop_context()
+
+    @contextmanager
+    def scope(self, cleanup: bool = True) -> t.Iterator["Context"]:
+        """This helper method can be used with the context object to promote
+        it to the current thread local (see :func:`get_current_context`).
+        The default behavior of this is to invoke the cleanup functions which
+        can be disabled by setting `cleanup` to `False`.  The cleanup
+        functions are typically used for things such as closing file handles.
+
+        If the cleanup is intended the context object can also be directly
+        used as a context manager.
+
+        Example usage::
+
+            with ctx.scope():
+                assert get_current_context() is ctx
+
+        This is equivalent::
+
+            with ctx:
+                assert get_current_context() is ctx
+
+        .. versionadded:: 5.0
+
+        :param cleanup: controls if the cleanup functions should be run or
+                        not.  The default is to run these functions.  In
+                        some situations the context only wants to be
+                        temporarily pushed in which case this can be disabled.
+                        Nested pushes automatically defer the cleanup.
+        """
+        if not cleanup:
+            self._depth += 1
+        try:
+            with self as rv:
+                yield rv
+        finally:
+            if not cleanup:
+                self._depth -= 1
+
+    @property
+    def meta(self) -> t.Dict[str, t.Any]:
+        """This is a dictionary which is shared with all the contexts
+        that are nested.  It exists so that click utilities can store some
+        state here if they need to.  It is however the responsibility of
+        that code to manage this dictionary well.
+
+        The keys are supposed to be unique dotted strings.  For instance
+        module paths are a good choice for it.  What is stored in there is
+        irrelevant for the operation of click.  However what is important is
+        that code that places data here adheres to the general semantics of
+        the system.
+
+        Example usage::
+
+            LANG_KEY = f'{__name__}.lang'
+
+            def set_language(value):
+                ctx = get_current_context()
+                ctx.meta[LANG_KEY] = value
+
+            def get_language():
+                return get_current_context().meta.get(LANG_KEY, 'en_US')
+
+        .. versionadded:: 5.0
+        """
+        return self._meta
+
+    def make_formatter(self) -> HelpFormatter:
+        """Creates the :class:`~click.HelpFormatter` for the help and
+        usage output.
+
+        To quickly customize the formatter class used without overriding
+        this method, set the :attr:`formatter_class` attribute.
+
+        .. versionchanged:: 8.0
+            Added the :attr:`formatter_class` attribute.
+        """
+        return self.formatter_class(
+            width=self.terminal_width, max_width=self.max_content_width
+        )
+
+    def with_resource(self, context_manager: t.ContextManager[V]) -> V:
+        """Register a resource as if it were used in a ``with``
+        statement. The resource will be cleaned up when the context is
+        popped.
+
+        Uses :meth:`contextlib.ExitStack.enter_context`. It calls the
+        resource's ``__enter__()`` method and returns the result. When
+        the context is popped, it closes the stack, which calls the
+        resource's ``__exit__()`` method.
+
+        To register a cleanup function for something that isn't a
+        context manager, use :meth:`call_on_close`. Or use something
+        from :mod:`contextlib` to turn it into a context manager first.
+
+        .. code-block:: python
+
+            @click.group()
+            @click.option("--name")
+            @click.pass_context
+            def cli(ctx):
+                ctx.obj = ctx.with_resource(connect_db(name))
+
+        :param context_manager: The context manager to enter.
+        :return: Whatever ``context_manager.__enter__()`` returns.
+
+        .. versionadded:: 8.0
+        """
+        return self._exit_stack.enter_context(context_manager)
+
+    def call_on_close(self, f: t.Callable[..., t.Any]) -> t.Callable[..., t.Any]:
+        """Register a function to be called when the context tears down.
+
+        This can be used to close resources opened during the script
+        execution. Resources that support Python's context manager
+        protocol which would be used in a ``with`` statement should be
+        registered with :meth:`with_resource` instead.
+
+        :param f: The function to execute on teardown.
+        """
+        return self._exit_stack.callback(f)
+
+    def close(self) -> None:
+        """Invoke all close callbacks registered with
+        :meth:`call_on_close`, and exit all context managers entered
+        with :meth:`with_resource`.
+        """
+        self._exit_stack.close()
+        # In case the context is reused, create a new exit stack.
+        self._exit_stack = ExitStack()
+
+    @property
+    def command_path(self) -> str:
+        """The computed command path.  This is used for the ``usage``
+        information on the help page.  It's automatically created by
+        combining the info names of the chain of contexts to the root.
+        """
+        rv = ""
+        if self.info_name is not None:
+            rv = self.info_name
+        if self.parent is not None:
+            parent_command_path = [self.parent.command_path]
+
+            if isinstance(self.parent.command, Command):
+                for param in self.parent.command.get_params(self):
+                    parent_command_path.extend(param.get_usage_pieces(self))
+
+            rv = f"{' '.join(parent_command_path)} {rv}"
+        return rv.lstrip()
+
+    def find_root(self) -> "Context":
+        """Finds the outermost context."""
+        node = self
+        while node.parent is not None:
+            node = node.parent
+        return node
+
+    def find_object(self, object_type: t.Type[V]) -> t.Optional[V]:
+        """Finds the closest object of a given type."""
+        node: t.Optional["Context"] = self
+
+        while node is not None:
+            if isinstance(node.obj, object_type):
+                return node.obj
+
+            node = node.parent
+
+        return None
+
+    def ensure_object(self, object_type: t.Type[V]) -> V:
+        """Like :meth:`find_object` but sets the innermost object to a
+        new instance of `object_type` if it does not exist.
+        """
+        rv = self.find_object(object_type)
+        if rv is None:
+            self.obj = rv = object_type()
+        return rv
+
+    @t.overload
+    def lookup_default(
+        self, name: str, call: "te.Literal[True]" = True
+    ) -> t.Optional[t.Any]:
+        ...
+
+    @t.overload
+    def lookup_default(
+        self, name: str, call: "te.Literal[False]" = ...
+    ) -> t.Optional[t.Union[t.Any, t.Callable[[], t.Any]]]:
+        ...
+
+    def lookup_default(self, name: str, call: bool = True) -> t.Optional[t.Any]:
+        """Get the default for a parameter from :attr:`default_map`.
+
+        :param name: Name of the parameter.
+        :param call: If the default is a callable, call it. Disable to
+            return the callable instead.
+
+        .. versionchanged:: 8.0
+            Added the ``call`` parameter.
+        """
+        if self.default_map is not None:
+            value = self.default_map.get(name)
+
+            if call and callable(value):
+                return value()
+
+            return value
+
+        return None
+
+    def fail(self, message: str) -> "te.NoReturn":
+        """Aborts the execution of the program with a specific error
+        message.
+
+        :param message: the error message to fail with.
+        """
+        raise UsageError(message, self)
+
+    def abort(self) -> "te.NoReturn":
+        """Aborts the script."""
+        raise Abort()
+
+    def exit(self, code: int = 0) -> "te.NoReturn":
+        """Exits the application with a given exit code."""
+        raise Exit(code)
+
+    def get_usage(self) -> str:
+        """Helper method to get formatted usage string for the current
+        context and command.
+        """
+        return self.command.get_usage(self)
+
+    def get_help(self) -> str:
+        """Helper method to get formatted help page for the current
+        context and command.
+        """
+        return self.command.get_help(self)
+
+    def _make_sub_context(self, command: "Command") -> "Context":
+        """Create a new context of the same type as this context, but
+        for a new command.
+
+        :meta private:
+        """
+        return type(self)(command, info_name=command.name, parent=self)
+
+    @t.overload
+    def invoke(
+        __self,  # noqa: B902
+        __callback: "t.Callable[..., V]",
+        *args: t.Any,
+        **kwargs: t.Any,
+    ) -> V:
+        ...
+
+    @t.overload
+    def invoke(
+        __self,  # noqa: B902
+        __callback: "Command",
+        *args: t.Any,
+        **kwargs: t.Any,
+    ) -> t.Any:
+        ...
+
+    def invoke(
+        __self,  # noqa: B902
+        __callback: t.Union["Command", "t.Callable[..., V]"],
+        *args: t.Any,
+        **kwargs: t.Any,
+    ) -> t.Union[t.Any, V]:
+        """Invokes a command callback in exactly the way it expects.  There
+        are two ways to invoke this method:
+
+        1.  the first argument can be a callback and all other arguments and
+            keyword arguments are forwarded directly to the function.
+        2.  the first argument is a click command object.  In that case all
+            arguments are forwarded as well but proper click parameters
+            (options and click arguments) must be keyword arguments and Click
+            will fill in defaults.
+
+        Note that before Click 3.2 keyword arguments were not properly filled
+        in against the intention of this code and no context was created.  For
+        more information about this change and why it was done in a bugfix
+        release see :ref:`upgrade-to-3.2`.
+
+        .. versionchanged:: 8.0
+            All ``kwargs`` are tracked in :attr:`params` so they will be
+            passed if :meth:`forward` is called at multiple levels.
+        """
+        if isinstance(__callback, Command):
+            other_cmd = __callback
+
+            if other_cmd.callback is None:
+                raise TypeError(
+                    "The given command does not have a callback that can be invoked."
+                )
+            else:
+                __callback = t.cast("t.Callable[..., V]", other_cmd.callback)
+
+            ctx = __self._make_sub_context(other_cmd)
+
+            for param in other_cmd.params:
+                if param.name not in kwargs and param.expose_value:
+                    kwargs[param.name] = param.type_cast_value(  # type: ignore
+                        ctx, param.get_default(ctx)
+                    )
+
+            # Track all kwargs as params, so that forward() will pass
+            # them on in subsequent calls.
+            ctx.params.update(kwargs)
+        else:
+            ctx = __self
+
+        with augment_usage_errors(__self):
+            with ctx:
+                return __callback(*args, **kwargs)
+
+    def forward(
+        __self, __cmd: "Command", *args: t.Any, **kwargs: t.Any  # noqa: B902
+    ) -> t.Any:
+        """Similar to :meth:`invoke` but fills in default keyword
+        arguments from the current context if the other command expects
+        it.  This cannot invoke callbacks directly, only other commands.
+
+        .. versionchanged:: 8.0
+            All ``kwargs`` are tracked in :attr:`params` so they will be
+            passed if ``forward`` is called at multiple levels.
+        """
+        # Can only forward to other commands, not direct callbacks.
+        if not isinstance(__cmd, Command):
+            raise TypeError("Callback is not a command.")
+
+        for param in __self.params:
+            if param not in kwargs:
+                kwargs[param] = __self.params[param]
+
+        return __self.invoke(__cmd, *args, **kwargs)
+
+    def set_parameter_source(self, name: str, source: ParameterSource) -> None:
+        """Set the source of a parameter. This indicates the location
+        from which the value of the parameter was obtained.
+
+        :param name: The name of the parameter.
+        :param source: A member of :class:`~click.core.ParameterSource`.
+        """
+        self._parameter_source[name] = source
+
+    def get_parameter_source(self, name: str) -> t.Optional[ParameterSource]:
+        """Get the source of a parameter. This indicates the location
+        from which the value of the parameter was obtained.
+
+        This can be useful for determining when a user specified a value
+        on the command line that is the same as the default value. It
+        will be :attr:`~click.core.ParameterSource.DEFAULT` only if the
+        value was actually taken from the default.
+
+        :param name: The name of the parameter.
+        :rtype: ParameterSource
+
+        .. versionchanged:: 8.0
+            Returns ``None`` if the parameter was not provided from any
+            source.
+        """
+        return self._parameter_source.get(name)
+
+
+class BaseCommand:
+    """The base command implements the minimal API contract of commands.
+    Most code will never use this as it does not implement a lot of useful
+    functionality but it can act as the direct subclass of alternative
+    parsing methods that do not depend on the Click parser.
+
+    For instance, this can be used to bridge Click and other systems like
+    argparse or docopt.
+
+    Because base commands do not implement a lot of the API that other
+    parts of Click take for granted, they are not supported for all
+    operations.  For instance, they cannot be used with the decorators
+    usually and they have no built-in callback system.
+
+    .. versionchanged:: 2.0
+       Added the `context_settings` parameter.
+
+    :param name: the name of the command to use unless a group overrides it.
+    :param context_settings: an optional dictionary with defaults that are
+                             passed to the context object.
+    """
+
+    #: The context class to create with :meth:`make_context`.
+    #:
+    #: .. versionadded:: 8.0
+    context_class: t.Type[Context] = Context
+    #: the default for the :attr:`Context.allow_extra_args` flag.
+    allow_extra_args = False
+    #: the default for the :attr:`Context.allow_interspersed_args` flag.
+    allow_interspersed_args = True
+    #: the default for the :attr:`Context.ignore_unknown_options` flag.
+    ignore_unknown_options = False
+
+    def __init__(
+        self,
+        name: t.Optional[str],
+        context_settings: t.Optional[t.MutableMapping[str, t.Any]] = None,
+    ) -> None:
+        #: the name the command thinks it has.  Upon registering a command
+        #: on a :class:`Group` the group will default the command name
+        #: with this information.  You should instead use the
+        #: :class:`Context`\'s :attr:`~Context.info_name` attribute.
+        self.name = name
+
+        if context_settings is None:
+            context_settings = {}
+
+        #: an optional dictionary with defaults passed to the context.
+        self.context_settings: t.MutableMapping[str, t.Any] = context_settings
+
+    def to_info_dict(self, ctx: Context) -> t.Dict[str, t.Any]:
+        """Gather information that could be useful for a tool generating
+        user-facing documentation. This traverses the entire structure
+        below this command.
+
+        Use :meth:`click.Context.to_info_dict` to traverse the entire
+        CLI structure.
+
+        :param ctx: A :class:`Context` representing this command.
+
+        .. versionadded:: 8.0
+        """
+        return {"name": self.name}
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} {self.name}>"
+
+    def get_usage(self, ctx: Context) -> str:
+        raise NotImplementedError("Base commands cannot get usage")
+
+    def get_help(self, ctx: Context) -> str:
+        raise NotImplementedError("Base commands cannot get help")
+
+    def make_context(
+        self,
+        info_name: t.Optional[str],
+        args: t.List[str],
+        parent: t.Optional[Context] = None,
+        **extra: t.Any,
+    ) -> Context:
+        """This function when given an info name and arguments will kick
+        off the parsing and create a new :class:`Context`.  It does not
+        invoke the actual command callback though.
+
+        To quickly customize the context class used without overriding
+        this method, set the :attr:`context_class` attribute.
+
+        :param info_name: the info name for this invocation.  Generally this
+                          is the most descriptive name for the script or
+                          command.  For the toplevel script it's usually
+                          the name of the script, for commands below it's
+                          the name of the command.
+        :param args: the arguments to parse as list of strings.
+        :param parent: the parent context if available.
+        :param extra: extra keyword arguments forwarded to the context
+                      constructor.
+
+        .. versionchanged:: 8.0
+            Added the :attr:`context_class` attribute.
+        """
+        for key, value in self.context_settings.items():
+            if key not in extra:
+                extra[key] = value
+
+        ctx = self.context_class(
+            self, info_name=info_name, parent=parent, **extra  # type: ignore
+        )
+
+        with ctx.scope(cleanup=False):
+            self.parse_args(ctx, args)
+        return ctx
+
+    def parse_args(self, ctx: Context, args: t.List[str]) -> t.List[str]:
+        """Given a context and a list of arguments this creates the parser
+        and parses the arguments, then modifies the context as necessary.
+        This is automatically invoked by :meth:`make_context`.
+        """
+        raise NotImplementedError("Base commands do not know how to parse arguments.")
+
+    def invoke(self, ctx: Context) -> t.Any:
+        """Given a context, this invokes the command.  The default
+        implementation is raising a not implemented error.
+        """
+        raise NotImplementedError("Base commands are not invocable by default")
+
+    def shell_complete(self, ctx: Context, incomplete: str) -> t.List["CompletionItem"]:
+        """Return a list of completions for the incomplete value. Looks
+        at the names of chained multi-commands.
+
+        Any command could be part of a chained multi-command, so sibling
+        commands are valid at any point during command completion. Other
+        command classes will return more completions.
+
+        :param ctx: Invocation context for this command.
+        :param incomplete: Value being completed. May be empty.
+
+        .. versionadded:: 8.0
+        """
+        from click.shell_completion import CompletionItem
+
+        results: t.List["CompletionItem"] = []
+
+        while ctx.parent is not None:
+            ctx = ctx.parent
+
+            if isinstance(ctx.command, MultiCommand) and ctx.command.chain:
+                results.extend(
+                    CompletionItem(name, help=command.get_short_help_str())
+                    for name, command in _complete_visible_commands(ctx, incomplete)
+                    if name not in ctx.protected_args
+                )
+
+        return results
+
+    @t.overload
+    def main(
+        self,
+        args: t.Optional[t.Sequence[str]] = None,
+        prog_name: t.Optional[str] = None,
+        complete_var: t.Optional[str] = None,
+        standalone_mode: "te.Literal[True]" = True,
+        **extra: t.Any,
+    ) -> "te.NoReturn":
+        ...
+
+    @t.overload
+    def main(
+        self,
+        args: t.Optional[t.Sequence[str]] = None,
+        prog_name: t.Optional[str] = None,
+        complete_var: t.Optional[str] = None,
+        standalone_mode: bool = ...,
+        **extra: t.Any,
+    ) -> t.Any:
+        ...
+
+    def main(
+        self,
+        args: t.Optional[t.Sequence[str]] = None,
+        prog_name: t.Optional[str] = None,
+        complete_var: t.Optional[str] = None,
+        standalone_mode: bool = True,
+        windows_expand_args: bool = True,
+        **extra: t.Any,
+    ) -> t.Any:
+        """This is the way to invoke a script with all the bells and
+        whistles as a command line application.  This will always terminate
+        the application after a call.  If this is not wanted, ``SystemExit``
+        needs to be caught.
+
+        This method is also available by directly calling the instance of
+        a :class:`Command`.
+
+        :param args: the arguments that should be used for parsing.  If not
+                     provided, ``sys.argv[1:]`` is used.
+        :param prog_name: the program name that should be used.  By default
+                          the program name is constructed by taking the file
+                          name from ``sys.argv[0]``.
+        :param complete_var: the environment variable that controls the
+                             bash completion support.  The default is
+                             ``"_<prog_name>_COMPLETE"`` with prog_name in
+                             uppercase.
+        :param standalone_mode: the default behavior is to invoke the script
+                                in standalone mode.  Click will then
+                                handle exceptions and convert them into
+                                error messages and the function will never
+                                return but shut down the interpreter.  If
+                                this is set to `False` they will be
+                                propagated to the caller and the return
+                                value of this function is the return value
+                                of :meth:`invoke`.
+        :param windows_expand_args: Expand glob patterns, user dir, and
+            env vars in command line args on Windows.
+        :param extra: extra keyword arguments are forwarded to the context
+                      constructor.  See :class:`Context` for more information.
+
+        .. versionchanged:: 8.0.1
+            Added the ``windows_expand_args`` parameter to allow
+            disabling command line arg expansion on Windows.
+
+        .. versionchanged:: 8.0
+            When taking arguments from ``sys.argv`` on Windows, glob
+            patterns, user dir, and env vars are expanded.
+
+        .. versionchanged:: 3.0
+           Added the ``standalone_mode`` parameter.
+        """
+        if args is None:
+            args = sys.argv[1:]
+
+            if os.name == "nt" and windows_expand_args:
+                args = _expand_args(args)
+        else:
+            args = list(args)
+
+        if prog_name is None:
+            prog_name = _detect_program_name()
+
+        # Process shell completion requests and exit early.
+        self._main_shell_completion(extra, prog_name, complete_var)
+
+        try:
+            try:
+                with self.make_context(prog_name, args, **extra) as ctx:
+                    rv = self.invoke(ctx)
+                    if not standalone_mode:
+                        return rv
+                    # it's not safe to `ctx.exit(rv)` here!
+                    # note that `rv` may actually contain data like "1" which
+                    # has obvious effects
+                    # more subtle case: `rv=[None, None]` can come out of
+                    # chained commands which all returned `None` -- so it's not
+                    # even always obvious that `rv` indicates success/failure
+                    # by its truthiness/falsiness
+                    ctx.exit()
+            except (EOFError, KeyboardInterrupt) as e:
+                echo(file=sys.stderr)
+                raise Abort() from e
+            except ClickException as e:
+                if not standalone_mode:
+                    raise
+                e.show()
+                sys.exit(e.exit_code)
+            except OSError as e:
+                if e.errno == errno.EPIPE:
+                    sys.stdout = t.cast(t.TextIO, PacifyFlushWrapper(sys.stdout))
+                    sys.stderr = t.cast(t.TextIO, PacifyFlushWrapper(sys.stderr))
+                    sys.exit(1)
+                else:
+                    raise
+        except Exit as e:
+            if standalone_mode:
+                sys.exit(e.exit_code)
+            else:
+                # in non-standalone mode, return the exit code
+                # note that this is only reached if `self.invoke` above raises
+                # an Exit explicitly -- thus bypassing the check there which
+                # would return its result
+                # the results of non-standalone execution may therefore be
+                # somewhat ambiguous: if there are codepaths which lead to
+                # `ctx.exit(1)` and to `return 1`, the caller won't be able to
+                # tell the difference between the two
+                return e.exit_code
+        except Abort:
+            if not standalone_mode:
+                raise
+            echo(_("Aborted!"), file=sys.stderr)
+            sys.exit(1)
+
+    def _main_shell_completion(
+        self,
+        ctx_args: t.MutableMapping[str, t.Any],
+        prog_name: str,
+        complete_var: t.Optional[str] = None,
+    ) -> None:
+        """Check if the shell is asking for tab completion, process
+        that, then exit early. Called from :meth:`main` before the
+        program is invoked.
+
+        :param prog_name: Name of the executable in the shell.
+        :param complete_var: Name of the environment variable that holds
+            the completion instruction. Defaults to
+            ``_{PROG_NAME}_COMPLETE``.
+
+        .. versionchanged:: 8.2.0
+            Dots (``.``) in ``prog_name`` are replaced with underscores (``_``).
+        """
+        if complete_var is None:
+            complete_name = prog_name.replace("-", "_").replace(".", "_")
+            complete_var = f"_{complete_name}_COMPLETE".upper()
+
+        instruction = os.environ.get(complete_var)
+
+        if not instruction:
+            return
+
+        from .shell_completion import shell_complete
+
+        rv = shell_complete(self, ctx_args, prog_name, complete_var, instruction)
+        sys.exit(rv)
+
+    def __call__(self, *args: t.Any, **kwargs: t.Any) -> t.Any:
+        """Alias for :meth:`main`."""
+        return self.main(*args, **kwargs)
+
+
+class Command(BaseCommand):
+    """Commands are the basic building block of command line interfaces in
+    Click.  A basic command handles command line parsing and might dispatch
+    more parsing to commands nested below it.
+
+    :param name: the name of the command to use unless a group overrides it.
+    :param context_settings: an optional dictionary with defaults that are
+                             passed to the context object.
+    :param callback: the callback to invoke.  This is optional.
+    :param params: the parameters to register with this command.  This can
+                   be either :class:`Option` or :class:`Argument` objects.
+    :param help: the help string to use for this command.
+    :param epilog: like the help string but it's printed at the end of the
+                   help page after everything else.
+    :param short_help: the short help to use for this command.  This is
+                       shown on the command listing of the parent command.
+    :param add_help_option: by default each command registers a ``--help``
+                            option.  This can be disabled by this parameter.
+    :param no_args_is_help: this controls what happens if no arguments are
+                            provided.  This option is disabled by default.
+                            If enabled this will add ``--help`` as argument
+                            if no arguments are passed
+    :param hidden: hide this command from help outputs.
+
+    :param deprecated: issues a message indicating that
+                             the command is deprecated.
+
+    .. versionchanged:: 8.1
+        ``help``, ``epilog``, and ``short_help`` are stored unprocessed,
+        all formatting is done when outputting help text, not at init,
+        and is done even if not using the ``@command`` decorator.
+
+    .. versionchanged:: 8.0
+        Added a ``repr`` showing the command name.
+
+    .. versionchanged:: 7.1
+        Added the ``no_args_is_help`` parameter.
+
+    .. versionchanged:: 2.0
+        Added the ``context_settings`` parameter.
+    """
+
+    def __init__(
+        self,
+        name: t.Optional[str],
+        context_settings: t.Optional[t.MutableMapping[str, t.Any]] = None,
+        callback: t.Optional[t.Callable[..., t.Any]] = None,
+        params: t.Optional[t.List["Parameter"]] = None,
+        help: t.Optional[str] = None,
+        epilog: t.Optional[str] = None,
+        short_help: t.Optional[str] = None,
+        options_metavar: t.Optional[str] = "[OPTIONS]",
+        add_help_option: bool = True,
+        no_args_is_help: bool = False,
+        hidden: bool = False,
+        deprecated: bool = False,
+    ) -> None:
+        super().__init__(name, context_settings)
+        #: the callback to execute when the command fires.  This might be
+        #: `None` in which case nothing happens.
+        self.callback = callback
+        #: the list of parameters for this command in the order they
+        #: should show up in the help page and execute.  Eager parameters
+        #: will automatically be handled before non eager ones.
+        self.params: t.List["Parameter"] = params or []
+        self.help = help
+        self.epilog = epilog
+        self.options_metavar = options_metavar
+        self.short_help = short_help
+        self.add_help_option = add_help_option
+        self.no_args_is_help = no_args_is_help
+        self.hidden = hidden
+        self.deprecated = deprecated
+
+    def to_info_dict(self, ctx: Context) -> t.Dict[str, t.Any]:
+        info_dict = super().to_info_dict(ctx)
+        info_dict.update(
+            params=[param.to_info_dict() for param in self.get_params(ctx)],
+            help=self.help,
+            epilog=self.epilog,
+            short_help=self.short_help,
+            hidden=self.hidden,
+            deprecated=self.deprecated,
+        )
+        return info_dict
+
+    def get_usage(self, ctx: Context) -> str:
+        """Formats the usage line into a string and returns it.
+
+        Calls :meth:`format_usage` internally.
+        """
+        formatter = ctx.make_formatter()
+        self.format_usage(ctx, formatter)
+        return formatter.getvalue().rstrip("\n")
+
+    def get_params(self, ctx: Context) -> t.List["Parameter"]:
+        rv = self.params
+        help_option = self.get_help_option(ctx)
+
+        if help_option is not None:
+            rv = [*rv, help_option]
+
+        return rv
+
+    def format_usage(self, ctx: Context, formatter: HelpFormatter) -> None:
+        """Writes the usage line into the formatter.
+
+        This is a low-level method called by :meth:`get_usage`.
+        """
+        pieces = self.collect_usage_pieces(ctx)
+        formatter.write_usage(ctx.command_path, " ".join(pieces))
+
+    def collect_usage_pieces(self, ctx: Context) -> t.List[str]:
+        """Returns all the pieces that go into the usage line and returns
+        it as a list of strings.
+        """
+        rv = [self.options_metavar] if self.options_metavar else []
+
+        for param in self.get_params(ctx):
+            rv.extend(param.get_usage_pieces(ctx))
+
+        return rv
+
+    def get_help_option_names(self, ctx: Context) -> t.List[str]:
+        """Returns the names for the help option."""
+        all_names = set(ctx.help_option_names)
+        for param in self.params:
+            all_names.difference_update(param.opts)
+            all_names.difference_update(param.secondary_opts)
+        return list(all_names)
+
+    def get_help_option(self, ctx: Context) -> t.Optional["Option"]:
+        """Returns the help option object."""
+        help_options = self.get_help_option_names(ctx)
+
+        if not help_options or not self.add_help_option:
+            return None
+
+        def show_help(ctx: Context, param: "Parameter", value: str) -> None:
+            if value and not ctx.resilient_parsing:
+                echo(ctx.get_help(), color=ctx.color)
+                ctx.exit()
+
+        return Option(
+            help_options,
+            is_flag=True,
+            is_eager=True,
+            expose_value=False,
+            callback=show_help,
+            help=_("Show this message and exit."),
+        )
+
+    def make_parser(self, ctx: Context) -> OptionParser:
+        """Creates the underlying option parser for this command."""
+        parser = OptionParser(ctx)
+        for param in self.get_params(ctx):
+            param.add_to_parser(parser, ctx)
+        return parser
+
+    def get_help(self, ctx: Context) -> str:
+        """Formats the help into a string and returns it.
+
+        Calls :meth:`format_help` internally.
+        """
+        formatter = ctx.make_formatter()
+        self.format_help(ctx, formatter)
+        return formatter.getvalue().rstrip("\n")
+
+    def get_short_help_str(self, limit: int = 45) -> str:
+        """Gets short help for the command or makes it by shortening the
+        long help string.
+        """
+        if self.short_help:
+            text = inspect.cleandoc(self.short_help)
+        elif self.help:
+            text = make_default_short_help(self.help, limit)
+        else:
+            text = ""
+
+        if self.deprecated:
+            text = _("(Deprecated) {text}").format(text=text)
+
+        return text.strip()
+
+    def format_help(self, ctx: Context, formatter: HelpFormatter) -> None:
+        """Writes the help into the formatter if it exists.
+
+        This is a low-level method called by :meth:`get_help`.
+
+        This calls the following methods:
+
+        -   :meth:`format_usage`
+        -   :meth:`format_help_text`
+        -   :meth:`format_options`
+        -   :meth:`format_epilog`
+        """
+        self.format_usage(ctx, formatter)
+        self.format_help_text(ctx, formatter)
+        self.format_options(ctx, formatter)
+        self.format_epilog(ctx, formatter)
+
+    def format_help_text(self, ctx: Context, formatter: HelpFormatter) -> None:
+        """Writes the help text to the formatter if it exists."""
+        if self.help is not None:
+            # truncate the help text to the first form feed
+            text = inspect.cleandoc(self.help).partition("\f")[0]
+        else:
+            text = ""
+
+        if self.deprecated:
+            text = _("(Deprecated) {text}").format(text=text)
+
+        if text:
+            formatter.write_paragraph()
+
+            with formatter.indentation():
+                formatter.write_text(text)
+
+    def format_options(self, ctx: Context, formatter: HelpFormatter) -> None:
+        """Writes all the options into the formatter if they exist."""
+        opts = []
+        for param in self.get_params(ctx):
+            rv = param.get_help_record(ctx)
+            if rv is not None:
+                opts.append(rv)
+
+        if opts:
+            with formatter.section(_("Options")):
+                formatter.write_dl(opts)
+
+    def format_epilog(self, ctx: Context, formatter: HelpFormatter) -> None:
+        """Writes the epilog into the formatter if it exists."""
+        if self.epilog:
+            epilog = inspect.cleandoc(self.epilog)
+            formatter.write_paragraph()
+
+            with formatter.indentation():
+                formatter.write_text(epilog)
+
+    def parse_args(self, ctx: Context, args: t.List[str]) -> t.List[str]:
+        if not args and self.no_args_is_help and not ctx.resilient_parsing:
+            echo(ctx.get_help(), color=ctx.color)
+            ctx.exit()
+
+        parser = self.make_parser(ctx)
+        opts, args, param_order = parser.parse_args(args=args)
+
+        for param in iter_params_for_processing(param_order, self.get_params(ctx)):
+            value, args = param.handle_parse_result(ctx, opts, args)
+
+        if args and not ctx.allow_extra_args and not ctx.resilient_parsing:
+            ctx.fail(
+                ngettext(
+                    "Got unexpected extra argument ({args})",
+                    "Got unexpected extra arguments ({args})",
+                    len(args),
+                ).format(args=" ".join(map(str, args)))
+            )
+
+        ctx.args = args
+        ctx._opt_prefixes.update(parser._opt_prefixes)
+        return args
+
+    def invoke(self, ctx: Context) -> t.Any:
+        """Given a context, this invokes the attached callback (if it exists)
+        in the right way.
+        """
+        if self.deprecated:
+            message = _(
+                "DeprecationWarning: The command {name!r} is deprecated."
+            ).format(name=self.name)
+            echo(style(message, fg="red"), err=True)
+
+        if self.callback is not None:
+            return ctx.invoke(self.callback, **ctx.params)
+
+    def shell_complete(self, ctx: Context, incomplete: str) -> t.List["CompletionItem"]:
+        """Return a list of completions for the incomplete value. Looks
+        at the names of options and chained multi-commands.
+
+        :param ctx: Invocation context for this command.
+        :param incomplete: Value being completed. May be empty.
+
+        .. versionadded:: 8.0
+        """
+        from click.shell_completion import CompletionItem
+
+        results: t.List["CompletionItem"] = []
+
+        if incomplete and not incomplete[0].isalnum():
+            for param in self.get_params(ctx):
+                if (
+                    not isinstance(param, Option)
+                    or param.hidden
+                    or (
+                        not param.multiple
+                        and ctx.get_parameter_source(param.name)  # type: ignore
+                        is ParameterSource.COMMANDLINE
+                    )
+                ):
+                    continue
+
+                results.extend(
+                    CompletionItem(name, help=param.help)
+                    for name in [*param.opts, *param.secondary_opts]
+                    if name.startswith(incomplete)
+                )
+
+        results.extend(super().shell_complete(ctx, incomplete))
+        return results
+
+
+class MultiCommand(Command):
+    """A multi command is the basic implementation of a command that
+    dispatches to subcommands.  The most common version is the
+    :class:`Group`.
+
+    :param invoke_without_command: this controls how the multi command itself
+                                   is invoked.  By default it's only invoked
+                                   if a subcommand is provided.
+    :param no_args_is_help: this controls what happens if no arguments are
+                            provided.  This option is enabled by default if
+                            `invoke_without_command` is disabled or disabled
+                            if it's enabled.  If enabled this will add
+                            ``--help`` as argument if no arguments are
+                            passed.
+    :param subcommand_metavar: the string that is used in the documentation
+                               to indicate the subcommand place.
+    :param chain: if this is set to `True` chaining of multiple subcommands
+                  is enabled.  This restricts the form of commands in that
+                  they cannot have optional arguments but it allows
+                  multiple commands to be chained together.
+    :param result_callback: The result callback to attach to this multi
+        command. This can be set or changed later with the
+        :meth:`result_callback` decorator.
+    :param attrs: Other command arguments described in :class:`Command`.
+    """
+
+    allow_extra_args = True
+    allow_interspersed_args = False
+
+    def __init__(
+        self,
+        name: t.Optional[str] = None,
+        invoke_without_command: bool = False,
+        no_args_is_help: t.Optional[bool] = None,
+        subcommand_metavar: t.Optional[str] = None,
+        chain: bool = False,
+        result_callback: t.Optional[t.Callable[..., t.Any]] = None,
+        **attrs: t.Any,
+    ) -> None:
+        super().__init__(name, **attrs)
+
+        if no_args_is_help is None:
+            no_args_is_help = not invoke_without_command
+
+        self.no_args_is_help = no_args_is_help
+        self.invoke_without_command = invoke_without_command
+
+        if subcommand_metavar is None:
+            if chain:
+                subcommand_metavar = "COMMAND1 [ARGS]... [COMMAND2 [ARGS]...]..."
+            else:
+                subcommand_metavar = "COMMAND [ARGS]..."
+
+        self.subcommand_metavar = subcommand_metavar
+        self.chain = chain
+        # The result callback that is stored. This can be set or
+        # overridden with the :func:`result_callback` decorator.
+        self._result_callback = result_callback
+
+        if self.chain:
+            for param in self.params:
+                if isinstance(param, Argument) and not param.required:
+                    raise RuntimeError(
+                        "Multi commands in chain mode cannot have"
+                        " optional arguments."
+                    )
+
+    def to_info_dict(self, ctx: Context) -> t.Dict[str, t.Any]:
+        info_dict = super().to_info_dict(ctx)
+        commands = {}
+
+        for name in self.list_commands(ctx):
+            command = self.get_command(ctx, name)
+
+            if command is None:
+                continue
+
+            sub_ctx = ctx._make_sub_context(command)
+
+            with sub_ctx.scope(cleanup=False):
+                commands[name] = command.to_info_dict(sub_ctx)
+
+        info_dict.update(commands=commands, chain=self.chain)
+        return info_dict
+
+    def collect_usage_pieces(self, ctx: Context) -> t.List[str]:
+        rv = super().collect_usage_pieces(ctx)
+        rv.append(self.subcommand_metavar)
+        return rv
+
+    def format_options(self, ctx: Context, formatter: HelpFormatter) -> None:
+        super().format_options(ctx, formatter)
+        self.format_commands(ctx, formatter)
+
+    def result_callback(self, replace: bool = False) -> t.Callable[[F], F]:
+        """Adds a result callback to the command.  By default if a
+        result callback is already registered this will chain them but
+        this can be disabled with the `replace` parameter.  The result
+        callback is invoked with the return value of the subcommand
+        (or the list of return values from all subcommands if chaining
+        is enabled) as well as the parameters as they would be passed
+        to the main callback.
+
+        Example::
+
+            @click.group()
+            @click.option('-i', '--input', default=23)
+            def cli(input):
+                return 42
+
+            @cli.result_callback()
+            def process_result(result, input):
+                return result + input
+
+        :param replace: if set to `True` an already existing result
+                        callback will be removed.
+
+        .. versionchanged:: 8.0
+            Renamed from ``resultcallback``.
+
+        .. versionadded:: 3.0
+        """
+
+        def decorator(f: F) -> F:
+            old_callback = self._result_callback
+
+            if old_callback is None or replace:
+                self._result_callback = f
+                return f
+
+            def function(__value, *args, **kwargs):  # type: ignore
+                inner = old_callback(__value, *args, **kwargs)
+                return f(inner, *args, **kwargs)
+
+            self._result_callback = rv = update_wrapper(t.cast(F, function), f)
+            return rv
+
+        return decorator
+
+    def format_commands(self, ctx: Context, formatter: HelpFormatter) -> None:
+        """Extra format methods for multi methods that adds all the commands
+        after the options.
+        """
+        commands = []
+        for subcommand in self.list_commands(ctx):
+            cmd = self.get_command(ctx, subcommand)
+            # What is this, the tool lied about a command.  Ignore it
+            if cmd is None:
+                continue
+            if cmd.hidden:
+                continue
+
+            commands.append((subcommand, cmd))
+
+        # allow for 3 times the default spacing
+        if len(commands):
+            limit = formatter.width - 6 - max(len(cmd[0]) for cmd in commands)
+
+            rows = []
+            for subcommand, cmd in commands:
+                help = cmd.get_short_help_str(limit)
+                rows.append((subcommand, help))
+
+            if rows:
+                with formatter.section(_("Commands")):
+                    formatter.write_dl(rows)
+
+    def parse_args(self, ctx: Context, args: t.List[str]) -> t.List[str]:
+        if not args and self.no_args_is_help and not ctx.resilient_parsing:
+            echo(ctx.get_help(), color=ctx.color)
+            ctx.exit()
+
+        rest = super().parse_args(ctx, args)
+
+        if self.chain:
+            ctx.protected_args = rest
+            ctx.args = []
+        elif rest:
+            ctx.protected_args, ctx.args = rest[:1], rest[1:]
+
+        return ctx.args
+
+    def invoke(self, ctx: Context) -> t.Any:
+        def _process_result(value: t.Any) -> t.Any:
+            if self._result_callback is not None:
+                value = ctx.invoke(self._result_callback, value, **ctx.params)
+            return value
+
+        if not ctx.protected_args:
+            if self.invoke_without_command:
+                # No subcommand was invoked, so the result callback is
+                # invoked with the group return value for regular
+                # groups, or an empty list for chained groups.
+                with ctx:
+                    rv = super().invoke(ctx)
+                    return _process_result([] if self.chain else rv)
+            ctx.fail(_("Missing command."))
+
+        # Fetch args back out
+        args = [*ctx.protected_args, *ctx.args]
+        ctx.args = []
+        ctx.protected_args = []
+
+        # If we're not in chain mode, we only allow the invocation of a
+        # single command but we also inform the current context about the
+        # name of the command to invoke.
+        if not self.chain:
+            # Make sure the context is entered so we do not clean up
+            # resources until the result processor has worked.
+            with ctx:
+                cmd_name, cmd, args = self.resolve_command(ctx, args)
+                assert cmd is not None
+                ctx.invoked_subcommand = cmd_name
+                super().invoke(ctx)
+                sub_ctx = cmd.make_context(cmd_name, args, parent=ctx)
+                with sub_ctx:
+                    return _process_result(sub_ctx.command.invoke(sub_ctx))
+
+        # In chain mode we create the contexts step by step, but after the
+        # base command has been invoked.  Because at that point we do not
+        # know the subcommands yet, the invoked subcommand attribute is
+        # set to ``*`` to inform the command that subcommands are executed
+        # but nothing else.
+        with ctx:
+            ctx.invoked_subcommand = "*" if args else None
+            super().invoke(ctx)
+
+            # Otherwise we make every single context and invoke them in a
+            # chain.  In that case the return value to the result processor
+            # is the list of all invoked subcommand's results.
+            contexts = []
+            while args:
+                cmd_name, cmd, args = self.resolve_command(ctx, args)
+                assert cmd is not None
+                sub_ctx = cmd.make_context(
+                    cmd_name,
+                    args,
+                    parent=ctx,
+                    allow_extra_args=True,
+                    allow_interspersed_args=False,
+                )
+                contexts.append(sub_ctx)
+                args, sub_ctx.args = sub_ctx.args, []
+
+            rv = []
+            for sub_ctx in contexts:
+                with sub_ctx:
+                    rv.append(sub_ctx.command.invoke(sub_ctx))
+            return _process_result(rv)
+
+    def resolve_command(
+        self, ctx: Context, args: t.List[str]
+    ) -> t.Tuple[t.Optional[str], t.Optional[Command], t.List[str]]:
+        cmd_name = make_str(args[0])
+        original_cmd_name = cmd_name
+
+        # Get the command
+        cmd = self.get_command(ctx, cmd_name)
+
+        # If we can't find the command but there is a normalization
+        # function available, we try with that one.
+        if cmd is None and ctx.token_normalize_func is not None:
+            cmd_name = ctx.token_normalize_func(cmd_name)
+            cmd = self.get_command(ctx, cmd_name)
+
+        # If we don't find the command we want to show an error message
+        # to the user that it was not provided.  However, there is
+        # something else we should do: if the first argument looks like
+        # an option we want to kick off parsing again for arguments to
+        # resolve things like --help which now should go to the main
+        # place.
+        if cmd is None and not ctx.resilient_parsing:
+            if split_opt(cmd_name)[0]:
+                self.parse_args(ctx, ctx.args)
+            ctx.fail(_("No such command {name!r}.").format(name=original_cmd_name))
+        return cmd_name if cmd else None, cmd, args[1:]
+
+    def get_command(self, ctx: Context, cmd_name: str) -> t.Optional[Command]:
+        """Given a context and a command name, this returns a
+        :class:`Command` object if it exists or returns `None`.
+        """
+        raise NotImplementedError
+
+    def list_commands(self, ctx: Context) -> t.List[str]:
+        """Returns a list of subcommand names in the order they should
+        appear.
+        """
+        return []
+
+    def shell_complete(self, ctx: Context, incomplete: str) -> t.List["CompletionItem"]:
+        """Return a list of completions for the incomplete value. Looks
+        at the names of options, subcommands, and chained
+        multi-commands.
+
+        :param ctx: Invocation context for this command.
+        :param incomplete: Value being completed. May be empty.
+
+        .. versionadded:: 8.0
+        """
+        from click.shell_completion import CompletionItem
+
+        results = [
+            CompletionItem(name, help=command.get_short_help_str())
+            for name, command in _complete_visible_commands(ctx, incomplete)
+        ]
+        results.extend(super().shell_complete(ctx, incomplete))
+        return results
+
+
+class Group(MultiCommand):
+    """A group allows a command to have subcommands attached. This is
+    the most common way to implement nesting in Click.
+
+    :param name: The name of the group command.
+    :param commands: A dict mapping names to :class:`Command` objects.
+        Can also be a list of :class:`Command`, which will use
+        :attr:`Command.name` to create the dict.
+    :param attrs: Other command arguments described in
+        :class:`MultiCommand`, :class:`Command`, and
+        :class:`BaseCommand`.
+
+    .. versionchanged:: 8.0
+        The ``commands`` argument can be a list of command objects.
+    """
+
+    #: If set, this is used by the group's :meth:`command` decorator
+    #: as the default :class:`Command` class. This is useful to make all
+    #: subcommands use a custom command class.
+    #:
+    #: .. versionadded:: 8.0
+    command_class: t.Optional[t.Type[Command]] = None
+
+    #: If set, this is used by the group's :meth:`group` decorator
+    #: as the default :class:`Group` class. This is useful to make all
+    #: subgroups use a custom group class.
+    #:
+    #: If set to the special value :class:`type` (literally
+    #: ``group_class = type``), this group's class will be used as the
+    #: default class. This makes a custom group class continue to make
+    #: custom groups.
+    #:
+    #: .. versionadded:: 8.0
+    group_class: t.Optional[t.Union[t.Type["Group"], t.Type[type]]] = None
+    # Literal[type] isn't valid, so use Type[type]
+
+    def __init__(
+        self,
+        name: t.Optional[str] = None,
+        commands: t.Optional[
+            t.Union[t.MutableMapping[str, Command], t.Sequence[Command]]
+        ] = None,
+        **attrs: t.Any,
+    ) -> None:
+        super().__init__(name, **attrs)
+
+        if commands is None:
+            commands = {}
+        elif isinstance(commands, abc.Sequence):
+            commands = {c.name: c for c in commands if c.name is not None}
+
+        #: The registered subcommands by their exported names.
+        self.commands: t.MutableMapping[str, Command] = commands
+
+    def add_command(self, cmd: Command, name: t.Optional[str] = None) -> None:
+        """Registers another :class:`Command` with this group.  If the name
+        is not provided, the name of the command is used.
+        """
+        name = name or cmd.name
+        if name is None:
+            raise TypeError("Command has no name.")
+        _check_multicommand(self, name, cmd, register=True)
+        self.commands[name] = cmd
+
+    @t.overload
+    def command(self, __func: t.Callable[..., t.Any]) -> Command:
+        ...
+
+    @t.overload
+    def command(
+        self, *args: t.Any, **kwargs: t.Any
+    ) -> t.Callable[[t.Callable[..., t.Any]], Command]:
+        ...
+
+    def command(
+        self, *args: t.Any, **kwargs: t.Any
+    ) -> t.Union[t.Callable[[t.Callable[..., t.Any]], Command], Command]:
+        """A shortcut decorator for declaring and attaching a command to
+        the group. This takes the same arguments as :func:`command` and
+        immediately registers the created command with this group by
+        calling :meth:`add_command`.
+
+        To customize the command class used, set the
+        :attr:`command_class` attribute.
+
+        .. versionchanged:: 8.1
+            This decorator can be applied without parentheses.
+
+        .. versionchanged:: 8.0
+            Added the :attr:`command_class` attribute.
+        """
+        from .decorators import command
+
+        func: t.Optional[t.Callable[..., t.Any]] = None
+
+        if args and callable(args[0]):
+            assert (
+                len(args) == 1 and not kwargs
+            ), "Use 'command(**kwargs)(callable)' to provide arguments."
+            (func,) = args
+            args = ()
+
+        if self.command_class and kwargs.get("cls") is None:
+            kwargs["cls"] = self.command_class
+
+        def decorator(f: t.Callable[..., t.Any]) -> Command:
+            cmd: Command = command(*args, **kwargs)(f)
+            self.add_command(cmd)
+            return cmd
+
+        if func is not None:
+            return decorator(func)
+
+        return decorator
+
+    @t.overload
+    def group(self, __func: t.Callable[..., t.Any]) -> "Group":
+        ...
+
+    @t.overload
+    def group(
+        self, *args: t.Any, **kwargs: t.Any
+    ) -> t.Callable[[t.Callable[..., t.Any]], "Group"]:
+        ...
+
+    def group(
+        self, *args: t.Any, **kwargs: t.Any
+    ) -> t.Union[t.Callable[[t.Callable[..., t.Any]], "Group"], "Group"]:
+        """A shortcut decorator for declaring and attaching a group to
+        the group. This takes the same arguments as :func:`group` and
+        immediately registers the created group with this group by
+        calling :meth:`add_command`.
+
+        To customize the group class used, set the :attr:`group_class`
+        attribute.
+
+        .. versionchanged:: 8.1
+            This decorator can be applied without parentheses.
+
+        .. versionchanged:: 8.0
+            Added the :attr:`group_class` attribute.
+        """
+        from .decorators import group
+
+        func: t.Optional[t.Callable[..., t.Any]] = None
+
+        if args and callable(args[0]):
+            assert (
+                len(args) == 1 and not kwargs
+            ), "Use 'group(**kwargs)(callable)' to provide arguments."
+            (func,) = args
+            args = ()
+
+        if self.group_class is not None and kwargs.get("cls") is None:
+            if self.group_class is type:
+                kwargs["cls"] = type(self)
+            else:
+                kwargs["cls"] = self.group_class
+
+        def decorator(f: t.Callable[..., t.Any]) -> "Group":
+            cmd: Group = group(*args, **kwargs)(f)
+            self.add_command(cmd)
+            return cmd
+
+        if func is not None:
+            return decorator(func)
+
+        return decorator
+
+    def get_command(self, ctx: Context, cmd_name: str) -> t.Optional[Command]:
+        return self.commands.get(cmd_name)
+
+    def list_commands(self, ctx: Context) -> t.List[str]:
+        return sorted(self.commands)
+
+
+class CommandCollection(MultiCommand):
+    """A command collection is a multi command that merges multiple multi
+    commands together into one.  This is a straightforward implementation
+    that accepts a list of different multi commands as sources and
+    provides all the commands for each of them.
+
+    See :class:`MultiCommand` and :class:`Command` for the description of
+    ``name`` and ``attrs``.
+    """
+
+    def __init__(
+        self,
+        name: t.Optional[str] = None,
+        sources: t.Optional[t.List[MultiCommand]] = None,
+        **attrs: t.Any,
+    ) -> None:
+        super().__init__(name, **attrs)
+        #: The list of registered multi commands.
+        self.sources: t.List[MultiCommand] = sources or []
+
+    def add_source(self, multi_cmd: MultiCommand) -> None:
+        """Adds a new multi command to the chain dispatcher."""
+        self.sources.append(multi_cmd)
+
+    def get_command(self, ctx: Context, cmd_name: str) -> t.Optional[Command]:
+        for source in self.sources:
+            rv = source.get_command(ctx, cmd_name)
+
+            if rv is not None:
+                if self.chain:
+                    _check_multicommand(self, cmd_name, rv)
+
+                return rv
+
+        return None
+
+    def list_commands(self, ctx: Context) -> t.List[str]:
+        rv: t.Set[str] = set()
+
+        for source in self.sources:
+            rv.update(source.list_commands(ctx))
+
+        return sorted(rv)
+
+
+def _check_iter(value: t.Any) -> t.Iterator[t.Any]:
+    """Check if the value is iterable but not a string. Raises a type
+    error, or return an iterator over the value.
+    """
+    if isinstance(value, str):
+        raise TypeError
+
+    return iter(value)
+
+
+class Parameter:
+    r"""A parameter to a command comes in two versions: they are either
+    :class:`Option`\s or :class:`Argument`\s.  Other subclasses are currently
+    not supported by design as some of the internals for parsing are
+    intentionally not finalized.
+
+    Some settings are supported by both options and arguments.
+
+    :param param_decls: the parameter declarations for this option or
+                        argument.  This is a list of flags or argument
+                        names.
+    :param type: the type that should be used.  Either a :class:`ParamType`
+                 or a Python type.  The latter is converted into the former
+                 automatically if supported.
+    :param required: controls if this is optional or not.
+    :param default: the default value if omitted.  This can also be a callable,
+                    in which case it's invoked when the default is needed
+                    without any arguments.
+    :param callback: A function to further process or validate the value
+        after type conversion. It is called as ``f(ctx, param, value)``
+        and must return the value. It is called for all sources,
+        including prompts.
+    :param nargs: the number of arguments to match.  If not ``1`` the return
+                  value is a tuple instead of single value.  The default for
+                  nargs is ``1`` (except if the type is a tuple, then it's
+                  the arity of the tuple). If ``nargs=-1``, all remaining
+                  parameters are collected.
+    :param metavar: how the value is represented in the help page.
+    :param expose_value: if this is `True` then the value is passed onwards
+                         to the command callback and stored on the context,
+                         otherwise it's skipped.
+    :param is_eager: eager values are processed before non eager ones.  This
+                     should not be set for arguments or it will inverse the
+                     order of processing.
+    :param envvar: a string or list of strings that are environment variables
+                   that should be checked.
+    :param shell_complete: A function that returns custom shell
+        completions. Used instead of the param's type completion if
+        given. Takes ``ctx, param, incomplete`` and must return a list
+        of :class:`~click.shell_completion.CompletionItem` or a list of
+        strings.
+
+    .. versionchanged:: 8.0
+        ``process_value`` validates required parameters and bounded
+        ``nargs``, and invokes the parameter callback before returning
+        the value. This allows the callback to validate prompts.
+        ``full_process_value`` is removed.
+
+    .. versionchanged:: 8.0
+        ``autocompletion`` is renamed to ``shell_complete`` and has new
+        semantics described above. The old name is deprecated and will
+        be removed in 8.1, until then it will be wrapped to match the
+        new requirements.
+
+    .. versionchanged:: 8.0
+        For ``multiple=True, nargs>1``, the default must be a list of
+        tuples.
+
+    .. versionchanged:: 8.0
+        Setting a default is no longer required for ``nargs>1``, it will
+        default to ``None``. ``multiple=True`` or ``nargs=-1`` will
+        default to ``()``.
+
+    .. versionchanged:: 7.1
+        Empty environment variables are ignored rather than taking the
+        empty string value. This makes it possible for scripts to clear
+        variables if they can't unset them.
+
+    .. versionchanged:: 2.0
+        Changed signature for parameter callback to also be passed the
+        parameter. The old callback format will still work, but it will
+        raise a warning to give you a chance to migrate the code easier.
+    """
+
+    param_type_name = "parameter"
+
+    def __init__(
+        self,
+        param_decls: t.Optional[t.Sequence[str]] = None,
+        type: t.Optional[t.Union[types.ParamType, t.Any]] = None,
+        required: bool = False,
+        default: t.Optional[t.Union[t.Any, t.Callable[[], t.Any]]] = None,
+        callback: t.Optional[t.Callable[[Context, "Parameter", t.Any], t.Any]] = None,
+        nargs: t.Optional[int] = None,
+        multiple: bool = False,
+        metavar: t.Optional[str] = None,
+        expose_value: bool = True,
+        is_eager: bool = False,
+        envvar: t.Optional[t.Union[str, t.Sequence[str]]] = None,
+        shell_complete: t.Optional[
+            t.Callable[
+                [Context, "Parameter", str],
+                t.Union[t.List["CompletionItem"], t.List[str]],
+            ]
+        ] = None,
+    ) -> None:
+        self.name: t.Optional[str]
+        self.opts: t.List[str]
+        self.secondary_opts: t.List[str]
+        self.name, self.opts, self.secondary_opts = self._parse_decls(
+            param_decls or (), expose_value
+        )
+        self.type: types.ParamType = types.convert_type(type, default)
+
+        # Default nargs to what the type tells us if we have that
+        # information available.
+        if nargs is None:
+            if self.type.is_composite:
+                nargs = self.type.arity
+            else:
+                nargs = 1
+
+        self.required = required
+        self.callback = callback
+        self.nargs = nargs
+        self.multiple = multiple
+        self.expose_value = expose_value
+        self.default = default
+        self.is_eager = is_eager
+        self.metavar = metavar
+        self.envvar = envvar
+        self._custom_shell_complete = shell_complete
+
+        if __debug__:
+            if self.type.is_composite and nargs != self.type.arity:
+                raise ValueError(
+                    f"'nargs' must be {self.type.arity} (or None) for"
+                    f" type {self.type!r}, but it was {nargs}."
+                )
+
+            # Skip no default or callable default.
+            check_default = default if not callable(default) else None
+
+            if check_default is not None:
+                if multiple:
+                    try:
+                        # Only check the first value against nargs.
+                        check_default = next(_check_iter(check_default), None)
+                    except TypeError:
+                        raise ValueError(
+                            "'default' must be a list when 'multiple' is true."
+                        ) from None
+
+                # Can be None for multiple with empty default.
+                if nargs != 1 and check_default is not None:
+                    try:
+                        _check_iter(check_default)
+                    except TypeError:
+                        if multiple:
+                            message = (
+                                "'default' must be a list of lists when 'multiple' is"
+                                " true and 'nargs' != 1."
+                            )
+                        else:
+                            message = "'default' must be a list when 'nargs' != 1."
+
+                        raise ValueError(message) from None
+
+                    if nargs > 1 and len(check_default) != nargs:
+                        subject = "item length" if multiple else "length"
+                        raise ValueError(
+                            f"'default' {subject} must match nargs={nargs}."
+                        )
+
+    def to_info_dict(self) -> t.Dict[str, t.Any]:
+        """Gather information that could be useful for a tool generating
+        user-facing documentation.
+
+        Use :meth:`click.Context.to_info_dict` to traverse the entire
+        CLI structure.
+
+        .. versionadded:: 8.0
+        """
+        return {
+            "name": self.name,
+            "param_type_name": self.param_type_name,
+            "opts": self.opts,
+            "secondary_opts": self.secondary_opts,
+            "type": self.type.to_info_dict(),
+            "required": self.required,
+            "nargs": self.nargs,
+            "multiple": self.multiple,
+            "default": self.default,
+            "envvar": self.envvar,
+        }
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} {self.name}>"
+
+    def _parse_decls(
+        self, decls: t.Sequence[str], expose_value: bool
+    ) -> t.Tuple[t.Optional[str], t.List[str], t.List[str]]:
+        raise NotImplementedError()
+
+    @property
+    def human_readable_name(self) -> str:
+        """Returns the human readable name of this parameter.  This is the
+        same as the name for options, but the metavar for arguments.
+        """
+        return self.name  # type: ignore
+
+    def make_metavar(self) -> str:
+        if self.metavar is not None:
+            return self.metavar
+
+        metavar = self.type.get_metavar(self)
+
+        if metavar is None:
+            metavar = self.type.name.upper()
+
+        if self.nargs != 1:
+            metavar += "..."
+
+        return metavar
+
+    @t.overload
+    def get_default(
+        self, ctx: Context, call: "te.Literal[True]" = True
+    ) -> t.Optional[t.Any]:
+        ...
+
+    @t.overload
+    def get_default(
+        self, ctx: Context, call: bool = ...
+    ) -> t.Optional[t.Union[t.Any, t.Callable[[], t.Any]]]:
+        ...
+
+    def get_default(
+        self, ctx: Context, call: bool = True
+    ) -> t.Optional[t.Union[t.Any, t.Callable[[], t.Any]]]:
+        """Get the default for the parameter. Tries
+        :meth:`Context.lookup_default` first, then the local default.
+
+        :param ctx: Current context.
+        :param call: If the default is a callable, call it. Disable to
+            return the callable instead.
+
+        .. versionchanged:: 8.0.2
+            Type casting is no longer performed when getting a default.
+
+        .. versionchanged:: 8.0.1
+            Type casting can fail in resilient parsing mode. Invalid
+            defaults will not prevent showing help text.
+
+        .. versionchanged:: 8.0
+            Looks at ``ctx.default_map`` first.
+
+        .. versionchanged:: 8.0
+            Added the ``call`` parameter.
+        """
+        value = ctx.lookup_default(self.name, call=False)  # type: ignore
+
+        if value is None:
+            value = self.default
+
+        if call and callable(value):
+            value = value()
+
+        return value
+
+    def add_to_parser(self, parser: OptionParser, ctx: Context) -> None:
+        raise NotImplementedError()
+
+    def consume_value(
+        self, ctx: Context, opts: t.Mapping[str, t.Any]
+    ) -> t.Tuple[t.Any, ParameterSource]:
+        value = opts.get(self.name)  # type: ignore
+        source = ParameterSource.COMMANDLINE
+
+        if value is None:
+            value = self.value_from_envvar(ctx)
+            source = ParameterSource.ENVIRONMENT
+
+        if value is None:
+            value = ctx.lookup_default(self.name)  # type: ignore
+            source = ParameterSource.DEFAULT_MAP
+
+        if value is None:
+            value = self.get_default(ctx)
+            source = ParameterSource.DEFAULT
+
+        return value, source
+
+    def type_cast_value(self, ctx: Context, value: t.Any) -> t.Any:
+        """Convert and validate a value against the option's
+        :attr:`type`, :attr:`multiple`, and :attr:`nargs`.
+        """
+        if value is None:
+            return () if self.multiple or self.nargs == -1 else None
+
+        def check_iter(value: t.Any) -> t.Iterator[t.Any]:
+            try:
+                return _check_iter(value)
+            except TypeError:
+                # This should only happen when passing in args manually,
+                # the parser should construct an iterable when parsing
+                # the command line.
+                raise BadParameter(
+                    _("Value must be an iterable."), ctx=ctx, param=self
+                ) from None
+
+        if self.nargs == 1 or self.type.is_composite:
+
+            def convert(value: t.Any) -> t.Any:
+                return self.type(value, param=self, ctx=ctx)
+
+        elif self.nargs == -1:
+
+            def convert(value: t.Any) -> t.Any:  # t.Tuple[t.Any, ...]
+                return tuple(self.type(x, self, ctx) for x in check_iter(value))
+
+        else:  # nargs > 1
+
+            def convert(value: t.Any) -> t.Any:  # t.Tuple[t.Any, ...]
+                value = tuple(check_iter(value))
+
+                if len(value) != self.nargs:
+                    raise BadParameter(
+                        ngettext(
+                            "Takes {nargs} values but 1 was given.",
+                            "Takes {nargs} values but {len} were given.",
+                            len(value),
+                        ).format(nargs=self.nargs, len=len(value)),
+                        ctx=ctx,
+                        param=self,
+                    )
+
+                return tuple(self.type(x, self, ctx) for x in value)
+
+        if self.multiple:
+            return tuple(convert(x) for x in check_iter(value))
+
+        return convert(value)
+
+    def value_is_missing(self, value: t.Any) -> bool:
+        if value is None:
+            return True
+
+        if (self.nargs != 1 or self.multiple) and value == ():
+            return True
+
+        return False
+
+    def process_value(self, ctx: Context, value: t.Any) -> t.Any:
+        value = self.type_cast_value(ctx, value)
+
+        if self.required and self.value_is_missing(value):
+            raise MissingParameter(ctx=ctx, param=self)
+
+        if self.callback is not None:
+            value = self.callback(ctx, self, value)
+
+        return value
+
+    def resolve_envvar_value(self, ctx: Context) -> t.Optional[str]:
+        if self.envvar is None:
+            return None
+
+        if isinstance(self.envvar, str):
+            rv = os.environ.get(self.envvar)
+
+            if rv:
+                return rv
+        else:
+            for envvar in self.envvar:
+                rv = os.environ.get(envvar)
+
+                if rv:
+                    return rv
+
+        return None
+
+    def value_from_envvar(self, ctx: Context) -> t.Optional[t.Any]:
+        rv: t.Optional[t.Any] = self.resolve_envvar_value(ctx)
+
+        if rv is not None and self.nargs != 1:
+            rv = self.type.split_envvar_value(rv)
+
+        return rv
+
+    def handle_parse_result(
+        self, ctx: Context, opts: t.Mapping[str, t.Any], args: t.List[str]
+    ) -> t.Tuple[t.Any, t.List[str]]:
+        with augment_usage_errors(ctx, param=self):
+            value, source = self.consume_value(ctx, opts)
+            ctx.set_parameter_source(self.name, source)  # type: ignore
+
+            try:
+                value = self.process_value(ctx, value)
+            except Exception:
+                if not ctx.resilient_parsing:
+                    raise
+
+                value = None
+
+        if self.expose_value:
+            ctx.params[self.name] = value  # type: ignore
+
+        return value, args
+
+    def get_help_record(self, ctx: Context) -> t.Optional[t.Tuple[str, str]]:
+        pass
+
+    def get_usage_pieces(self, ctx: Context) -> t.List[str]:
+        return []
+
+    def get_error_hint(self, ctx: Context) -> str:
+        """Get a stringified version of the param for use in error messages to
+        indicate which param caused the error.
+        """
+        hint_list = self.opts or [self.human_readable_name]
+        return " / ".join(f"'{x}'" for x in hint_list)
+
+    def shell_complete(self, ctx: Context, incomplete: str) -> t.List["CompletionItem"]:
+        """Return a list of completions for the incomplete value. If a
+        ``shell_complete`` function was given during init, it is used.
+        Otherwise, the :attr:`type`
+        :meth:`~click.types.ParamType.shell_complete` function is used.
+
+        :param ctx: Invocation context for this command.
+        :param incomplete: Value being completed. May be empty.
+
+        .. versionadded:: 8.0
+        """
+        if self._custom_shell_complete is not None:
+            results = self._custom_shell_complete(ctx, self, incomplete)
+
+            if results and isinstance(results[0], str):
+                from click.shell_completion import CompletionItem
+
+                results = [CompletionItem(c) for c in results]
+
+            return t.cast(t.List["CompletionItem"], results)
+
+        return self.type.shell_complete(ctx, self, incomplete)
+
+
+class Option(Parameter):
+    """Options are usually optional values on the command line and
+    have some extra features that arguments don't have.
+
+    All other parameters are passed onwards to the parameter constructor.
+
+    :param show_default: Show the default value for this option in its
+        help text. Values are not shown by default, unless
+        :attr:`Context.show_default` is ``True``. If this value is a
+        string, it shows that string in parentheses instead of the
+        actual value. This is particularly useful for dynamic options.
+        For single option boolean flags, the default remains hidden if
+        its value is ``False``.
+    :param show_envvar: Controls if an environment variable should be
+        shown on the help page. Normally, environment variables are not
+        shown.
+    :param prompt: If set to ``True`` or a non empty string then the
+        user will be prompted for input. If set to ``True`` the prompt
+        will be the option name capitalized.
+    :param confirmation_prompt: Prompt a second time to confirm the
+        value if it was prompted for. Can be set to a string instead of
+        ``True`` to customize the message.
+    :param prompt_required: If set to ``False``, the user will be
+        prompted for input only when the option was specified as a flag
+        without a value.
+    :param hide_input: If this is ``True`` then the input on the prompt
+        will be hidden from the user. This is useful for password input.
+    :param is_flag: forces this option to act as a flag.  The default is
+                    auto detection.
+    :param flag_value: which value should be used for this flag if it's
+                       enabled.  This is set to a boolean automatically if
+                       the option string contains a slash to mark two options.
+    :param multiple: if this is set to `True` then the argument is accepted
+                     multiple times and recorded.  This is similar to ``nargs``
+                     in how it works but supports arbitrary number of
+                     arguments.
+    :param count: this flag makes an option increment an integer.
+    :param allow_from_autoenv: if this is enabled then the value of this
+                               parameter will be pulled from an environment
+                               variable in case a prefix is defined on the
+                               context.
+    :param help: the help string.
+    :param hidden: hide this option from help outputs.
+    :param attrs: Other command arguments described in :class:`Parameter`.
+
+    .. versionchanged:: 8.1.0
+        Help text indentation is cleaned here instead of only in the
+        ``@option`` decorator.
+
+    .. versionchanged:: 8.1.0
+        The ``show_default`` parameter overrides
+        ``Context.show_default``.
+
+    .. versionchanged:: 8.1.0
+        The default of a single option boolean flag is not shown if the
+        default value is ``False``.
+
+    .. versionchanged:: 8.0.1
+        ``type`` is detected from ``flag_value`` if given.
+    """
+
+    param_type_name = "option"
+
+    def __init__(
+        self,
+        param_decls: t.Optional[t.Sequence[str]] = None,
+        show_default: t.Union[bool, str, None] = None,
+        prompt: t.Union[bool, str] = False,
+        confirmation_prompt: t.Union[bool, str] = False,
+        prompt_required: bool = True,
+        hide_input: bool = False,
+        is_flag: t.Optional[bool] = None,
+        flag_value: t.Optional[t.Any] = None,
+        multiple: bool = False,
+        count: bool = False,
+        allow_from_autoenv: bool = True,
+        type: t.Optional[t.Union[types.ParamType, t.Any]] = None,
+        help: t.Optional[str] = None,
+        hidden: bool = False,
+        show_choices: bool = True,
+        show_envvar: bool = False,
+        **attrs: t.Any,
+    ) -> None:
+        if help:
+            help = inspect.cleandoc(help)
+
+        default_is_missing = "default" not in attrs
+        super().__init__(param_decls, type=type, multiple=multiple, **attrs)
+
+        if prompt is True:
+            if self.name is None:
+                raise TypeError("'name' is required with 'prompt=True'.")
+
+            prompt_text: t.Optional[str] = self.name.replace("_", " ").capitalize()
+        elif prompt is False:
+            prompt_text = None
+        else:
+            prompt_text = prompt
+
+        self.prompt = prompt_text
+        self.confirmation_prompt = confirmation_prompt
+        self.prompt_required = prompt_required
+        self.hide_input = hide_input
+        self.hidden = hidden
+
+        # If prompt is enabled but not required, then the option can be
+        # used as a flag to indicate using prompt or flag_value.
+        self._flag_needs_value = self.prompt is not None and not self.prompt_required
+
+        if is_flag is None:
+            if flag_value is not None:
+                # Implicitly a flag because flag_value was set.
+                is_flag = True
+            elif self._flag_needs_value:
+                # Not a flag, but when used as a flag it shows a prompt.
+                is_flag = False
+            else:
+                # Implicitly a flag because flag options were given.
+                is_flag = bool(self.secondary_opts)
+        elif is_flag is False and not self._flag_needs_value:
+            # Not a flag, and prompt is not enabled, can be used as a
+            # flag if flag_value is set.
+            self._flag_needs_value = flag_value is not None
+
+        self.default: t.Union[t.Any, t.Callable[[], t.Any]]
+
+        if is_flag and default_is_missing and not self.required:
+            if multiple:
+                self.default = ()
+            else:
+                self.default = False
+
+        if flag_value is None:
+            flag_value = not self.default
+
+        self.type: types.ParamType
+        if is_flag and type is None:
+            # Re-guess the type from the flag value instead of the
+            # default.
+            self.type = types.convert_type(None, flag_value)
+
+        self.is_flag: bool = is_flag
+        self.is_bool_flag: bool = is_flag and isinstance(self.type, types.BoolParamType)
+        self.flag_value: t.Any = flag_value
+
+        # Counting
+        self.count = count
+        if count:
+            if type is None:
+                self.type = types.IntRange(min=0)
+            if default_is_missing:
+                self.default = 0
+
+        self.allow_from_autoenv = allow_from_autoenv
+        self.help = help
+        self.show_default = show_default
+        self.show_choices = show_choices
+        self.show_envvar = show_envvar
+
+        if __debug__:
+            if self.nargs == -1:
+                raise TypeError("nargs=-1 is not supported for options.")
+
+            if self.prompt and self.is_flag and not self.is_bool_flag:
+                raise TypeError("'prompt' is not valid for non-boolean flag.")
+
+            if not self.is_bool_flag and self.secondary_opts:
+                raise TypeError("Secondary flag is not valid for non-boolean flag.")
+
+            if self.is_bool_flag and self.hide_input and self.prompt is not None:
+                raise TypeError(
+                    "'prompt' with 'hide_input' is not valid for boolean flag."
+                )
+
+            if self.count:
+                if self.multiple:
+                    raise TypeError("'count' is not valid with 'multiple'.")
+
+                if self.is_flag:
+                    raise TypeError("'count' is not valid with 'is_flag'.")
+
+    def to_info_dict(self) -> t.Dict[str, t.Any]:
+        info_dict = super().to_info_dict()
+        info_dict.update(
+            help=self.help,
+            prompt=self.prompt,
+            is_flag=self.is_flag,
+            flag_value=self.flag_value,
+            count=self.count,
+            hidden=self.hidden,
+        )
+        return info_dict
+
+    def _parse_decls(
+        self, decls: t.Sequence[str], expose_value: bool
+    ) -> t.Tuple[t.Optional[str], t.List[str], t.List[str]]:
+        opts = []
+        secondary_opts = []
+        name = None
+        possible_names = []
+
+        for decl in decls:
+            if decl.isidentifier():
+                if name is not None:
+                    raise TypeError(f"Name '{name}' defined twice")
+                name = decl
+            else:
+                split_char = ";" if decl[:1] == "/" else "/"
+                if split_char in decl:
+                    first, second = decl.split(split_char, 1)
+                    first = first.rstrip()
+                    if first:
+                        possible_names.append(split_opt(first))
+                        opts.append(first)
+                    second = second.lstrip()
+                    if second:
+                        secondary_opts.append(second.lstrip())
+                    if first == second:
+                        raise ValueError(
+                            f"Boolean option {decl!r} cannot use the"
+                            " same flag for true/false."
+                        )
+                else:
+                    possible_names.append(split_opt(decl))
+                    opts.append(decl)
+
+        if name is None and possible_names:
+            possible_names.sort(key=lambda x: -len(x[0]))  # group long options first
+            name = possible_names[0][1].replace("-", "_").lower()
+            if not name.isidentifier():
+                name = None
+
+        if name is None:
+            if not expose_value:
+                return None, opts, secondary_opts
+            raise TypeError("Could not determine name for option")
+
+        if not opts and not secondary_opts:
+            raise TypeError(
+                f"No options defined but a name was passed ({name})."
+                " Did you mean to declare an argument instead? Did"
+                f" you mean to pass '--{name}'?"
+            )
+
+        return name, opts, secondary_opts
+
+    def add_to_parser(self, parser: OptionParser, ctx: Context) -> None:
+        if self.multiple:
+            action = "append"
+        elif self.count:
+            action = "count"
+        else:
+            action = "store"
+
+        if self.is_flag:
+            action = f"{action}_const"
+
+            if self.is_bool_flag and self.secondary_opts:
+                parser.add_option(
+                    obj=self, opts=self.opts, dest=self.name, action=action, const=True
+                )
+                parser.add_option(
+                    obj=self,
+                    opts=self.secondary_opts,
+                    dest=self.name,
+                    action=action,
+                    const=False,
+                )
+            else:
+                parser.add_option(
+                    obj=self,
+                    opts=self.opts,
+                    dest=self.name,
+                    action=action,
+                    const=self.flag_value,
+                )
+        else:
+            parser.add_option(
+                obj=self,
+                opts=self.opts,
+                dest=self.name,
+                action=action,
+                nargs=self.nargs,
+            )
+
+    def get_help_record(self, ctx: Context) -> t.Optional[t.Tuple[str, str]]:
+        if self.hidden:
+            return None
+
+        any_prefix_is_slash = False
+
+        def _write_opts(opts: t.Sequence[str]) -> str:
+            nonlocal any_prefix_is_slash
+
+            rv, any_slashes = join_options(opts)
+
+            if any_slashes:
+                any_prefix_is_slash = True
+
+            if not self.is_flag and not self.count:
+                rv += f" {self.make_metavar()}"
+
+            return rv
+
+        rv = [_write_opts(self.opts)]
+
+        if self.secondary_opts:
+            rv.append(_write_opts(self.secondary_opts))
+
+        help = self.help or ""
+        extra = []
+
+        if self.show_envvar:
+            envvar = self.envvar
+
+            if envvar is None:
+                if (
+                    self.allow_from_autoenv
+                    and ctx.auto_envvar_prefix is not None
+                    and self.name is not None
+                ):
+                    envvar = f"{ctx.auto_envvar_prefix}_{self.name.upper()}"
+
+            if envvar is not None:
+                var_str = (
+                    envvar
+                    if isinstance(envvar, str)
+                    else ", ".join(str(d) for d in envvar)
+                )
+                extra.append(_("env var: {var}").format(var=var_str))
+
+        # Temporarily enable resilient parsing to avoid type casting
+        # failing for the default. Might be possible to extend this to
+        # help formatting in general.
+        resilient = ctx.resilient_parsing
+        ctx.resilient_parsing = True
+
+        try:
+            default_value = self.get_default(ctx, call=False)
+        finally:
+            ctx.resilient_parsing = resilient
+
+        show_default = False
+        show_default_is_str = False
+
+        if self.show_default is not None:
+            if isinstance(self.show_default, str):
+                show_default_is_str = show_default = True
+            else:
+                show_default = self.show_default
+        elif ctx.show_default is not None:
+            show_default = ctx.show_default
+
+        if show_default_is_str or (show_default and (default_value is not None)):
+            if show_default_is_str:
+                default_string = f"({self.show_default})"
+            elif isinstance(default_value, (list, tuple)):
+                default_string = ", ".join(str(d) for d in default_value)
+            elif inspect.isfunction(default_value):
+                default_string = _("(dynamic)")
+            elif self.is_bool_flag and self.secondary_opts:
+                # For boolean flags that have distinct True/False opts,
+                # use the opt without prefix instead of the value.
+                default_string = split_opt(
+                    (self.opts if self.default else self.secondary_opts)[0]
+                )[1]
+            elif self.is_bool_flag and not self.secondary_opts and not default_value:
+                default_string = ""
+            else:
+                default_string = str(default_value)
+
+            if default_string:
+                extra.append(_("default: {default}").format(default=default_string))
+
+        if (
+            isinstance(self.type, types._NumberRangeBase)
+            # skip count with default range type
+            and not (self.count and self.type.min == 0 and self.type.max is None)
+        ):
+            range_str = self.type._describe_range()
+
+            if range_str:
+                extra.append(range_str)
+
+        if self.required:
+            extra.append(_("required"))
+
+        if extra:
+            extra_str = "; ".join(extra)
+            help = f"{help}  [{extra_str}]" if help else f"[{extra_str}]"
+
+        return ("; " if any_prefix_is_slash else " / ").join(rv), help
+
+    @t.overload
+    def get_default(
+        self, ctx: Context, call: "te.Literal[True]" = True
+    ) -> t.Optional[t.Any]:
+        ...
+
+    @t.overload
+    def get_default(
+        self, ctx: Context, call: bool = ...
+    ) -> t.Optional[t.Union[t.Any, t.Callable[[], t.Any]]]:
+        ...
+
+    def get_default(
+        self, ctx: Context, call: bool = True
+    ) -> t.Optional[t.Union[t.Any, t.Callable[[], t.Any]]]:
+        # If we're a non boolean flag our default is more complex because
+        # we need to look at all flags in the same group to figure out
+        # if we're the default one in which case we return the flag
+        # value as default.
+        if self.is_flag and not self.is_bool_flag:
+            for param in ctx.command.params:
+                if param.name == self.name and param.default:
+                    return t.cast(Option, param).flag_value
+
+            return None
+
+        return super().get_default(ctx, call=call)
+
+    def prompt_for_value(self, ctx: Context) -> t.Any:
+        """This is an alternative flow that can be activated in the full
+        value processing if a value does not exist.  It will prompt the
+        user until a valid value exists and then returns the processed
+        value as result.
+        """
+        assert self.prompt is not None
+
+        # Calculate the default before prompting anything to be stable.
+        default = self.get_default(ctx)
+
+        # If this is a prompt for a flag we need to handle this
+        # differently.
+        if self.is_bool_flag:
+            return confirm(self.prompt, default)
+
+        return prompt(
+            self.prompt,
+            default=default,
+            type=self.type,
+            hide_input=self.hide_input,
+            show_choices=self.show_choices,
+            confirmation_prompt=self.confirmation_prompt,
+            value_proc=lambda x: self.process_value(ctx, x),
+        )
+
+    def resolve_envvar_value(self, ctx: Context) -> t.Optional[str]:
+        rv = super().resolve_envvar_value(ctx)
+
+        if rv is not None:
+            return rv
+
+        if (
+            self.allow_from_autoenv
+            and ctx.auto_envvar_prefix is not None
+            and self.name is not None
+        ):
+            envvar = f"{ctx.auto_envvar_prefix}_{self.name.upper()}"
+            rv = os.environ.get(envvar)
+
+            if rv:
+                return rv
+
+        return None
+
+    def value_from_envvar(self, ctx: Context) -> t.Optional[t.Any]:
+        rv: t.Optional[t.Any] = self.resolve_envvar_value(ctx)
+
+        if rv is None:
+            return None
+
+        value_depth = (self.nargs != 1) + bool(self.multiple)
+
+        if value_depth > 0:
+            rv = self.type.split_envvar_value(rv)
+
+            if self.multiple and self.nargs != 1:
+                rv = batch(rv, self.nargs)
+
+        return rv
+
+    def consume_value(
+        self, ctx: Context, opts: t.Mapping[str, "Parameter"]
+    ) -> t.Tuple[t.Any, ParameterSource]:
+        value, source = super().consume_value(ctx, opts)
+
+        # The parser will emit a sentinel value if the option can be
+        # given as a flag without a value. This is different from None
+        # to distinguish from the flag not being given at all.
+        if value is _flag_needs_value:
+            if self.prompt is not None and not ctx.resilient_parsing:
+                value = self.prompt_for_value(ctx)
+                source = ParameterSource.PROMPT
+            else:
+                value = self.flag_value
+                source = ParameterSource.COMMANDLINE
+
+        elif (
+            self.multiple
+            and value is not None
+            and any(v is _flag_needs_value for v in value)
+        ):
+            value = [self.flag_value if v is _flag_needs_value else v for v in value]
+            source = ParameterSource.COMMANDLINE
+
+        # The value wasn't set, or used the param's default, prompt if
+        # prompting is enabled.
+        elif (
+            source in {None, ParameterSource.DEFAULT}
+            and self.prompt is not None
+            and (self.required or self.prompt_required)
+            and not ctx.resilient_parsing
+        ):
+            value = self.prompt_for_value(ctx)
+            source = ParameterSource.PROMPT
+
+        return value, source
+
+
+class Argument(Parameter):
+    """Arguments are positional parameters to a command.  They generally
+    provide fewer features than options but can have infinite ``nargs``
+    and are required by default.
+
+    All parameters are passed onwards to the constructor of :class:`Parameter`.
+    """
+
+    param_type_name = "argument"
+
+    def __init__(
+        self,
+        param_decls: t.Sequence[str],
+        required: t.Optional[bool] = None,
+        **attrs: t.Any,
+    ) -> None:
+        if required is None:
+            if attrs.get("default") is not None:
+                required = False
+            else:
+                required = attrs.get("nargs", 1) > 0
+
+        if "multiple" in attrs:
+            raise TypeError("__init__() got an unexpected keyword argument 'multiple'.")
+
+        super().__init__(param_decls, required=required, **attrs)
+
+        if __debug__:
+            if self.default is not None and self.nargs == -1:
+                raise TypeError("'default' is not supported for nargs=-1.")
+
+    @property
+    def human_readable_name(self) -> str:
+        if self.metavar is not None:
+            return self.metavar
+        return self.name.upper()  # type: ignore
+
+    def make_metavar(self) -> str:
+        if self.metavar is not None:
+            return self.metavar
+        var = self.type.get_metavar(self)
+        if not var:
+            var = self.name.upper()  # type: ignore
+        if not self.required:
+            var = f"[{var}]"
+        if self.nargs != 1:
+            var += "..."
+        return var
+
+    def _parse_decls(
+        self, decls: t.Sequence[str], expose_value: bool
+    ) -> t.Tuple[t.Optional[str], t.List[str], t.List[str]]:
+        if not decls:
+            if not expose_value:
+                return None, [], []
+            raise TypeError("Could not determine name for argument")
+        if len(decls) == 1:
+            name = arg = decls[0]
+            name = name.replace("-", "_").lower()
+        else:
+            raise TypeError(
+                "Arguments take exactly one parameter declaration, got"
+                f" {len(decls)}."
+            )
+        return name, [arg], []
+
+    def get_usage_pieces(self, ctx: Context) -> t.List[str]:
+        return [self.make_metavar()]
+
+    def get_error_hint(self, ctx: Context) -> str:
+        return f"'{self.make_metavar()}'"
+
+    def add_to_parser(self, parser: OptionParser, ctx: Context) -> None:
+        parser.add_argument(dest=self.name, nargs=self.nargs, obj=self)
diff --git a/llm/Lib/site-packages/click/decorators.py b/llm/Lib/site-packages/click/decorators.py
new file mode 100644
index 0000000000000000000000000000000000000000..d9bba9502ca353bca5136f43c92436ff584f06e1
--- /dev/null
+++ b/llm/Lib/site-packages/click/decorators.py
@@ -0,0 +1,561 @@
+import inspect
+import types
+import typing as t
+from functools import update_wrapper
+from gettext import gettext as _
+
+from .core import Argument
+from .core import Command
+from .core import Context
+from .core import Group
+from .core import Option
+from .core import Parameter
+from .globals import get_current_context
+from .utils import echo
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+
+    P = te.ParamSpec("P")
+
+R = t.TypeVar("R")
+T = t.TypeVar("T")
+_AnyCallable = t.Callable[..., t.Any]
+FC = t.TypeVar("FC", bound=t.Union[_AnyCallable, Command])
+
+
+def pass_context(f: "t.Callable[te.Concatenate[Context, P], R]") -> "t.Callable[P, R]":
+    """Marks a callback as wanting to receive the current context
+    object as first argument.
+    """
+
+    def new_func(*args: "P.args", **kwargs: "P.kwargs") -> "R":
+        return f(get_current_context(), *args, **kwargs)
+
+    return update_wrapper(new_func, f)
+
+
+def pass_obj(f: "t.Callable[te.Concatenate[t.Any, P], R]") -> "t.Callable[P, R]":
+    """Similar to :func:`pass_context`, but only pass the object on the
+    context onwards (:attr:`Context.obj`).  This is useful if that object
+    represents the state of a nested system.
+    """
+
+    def new_func(*args: "P.args", **kwargs: "P.kwargs") -> "R":
+        return f(get_current_context().obj, *args, **kwargs)
+
+    return update_wrapper(new_func, f)
+
+
+def make_pass_decorator(
+    object_type: t.Type[T], ensure: bool = False
+) -> t.Callable[["t.Callable[te.Concatenate[T, P], R]"], "t.Callable[P, R]"]:
+    """Given an object type this creates a decorator that will work
+    similar to :func:`pass_obj` but instead of passing the object of the
+    current context, it will find the innermost context of type
+    :func:`object_type`.
+
+    This generates a decorator that works roughly like this::
+
+        from functools import update_wrapper
+
+        def decorator(f):
+            @pass_context
+            def new_func(ctx, *args, **kwargs):
+                obj = ctx.find_object(object_type)
+                return ctx.invoke(f, obj, *args, **kwargs)
+            return update_wrapper(new_func, f)
+        return decorator
+
+    :param object_type: the type of the object to pass.
+    :param ensure: if set to `True`, a new object will be created and
+                   remembered on the context if it's not there yet.
+    """
+
+    def decorator(f: "t.Callable[te.Concatenate[T, P], R]") -> "t.Callable[P, R]":
+        def new_func(*args: "P.args", **kwargs: "P.kwargs") -> "R":
+            ctx = get_current_context()
+
+            obj: t.Optional[T]
+            if ensure:
+                obj = ctx.ensure_object(object_type)
+            else:
+                obj = ctx.find_object(object_type)
+
+            if obj is None:
+                raise RuntimeError(
+                    "Managed to invoke callback without a context"
+                    f" object of type {object_type.__name__!r}"
+                    " existing."
+                )
+
+            return ctx.invoke(f, obj, *args, **kwargs)
+
+        return update_wrapper(new_func, f)
+
+    return decorator  # type: ignore[return-value]
+
+
+def pass_meta_key(
+    key: str, *, doc_description: t.Optional[str] = None
+) -> "t.Callable[[t.Callable[te.Concatenate[t.Any, P], R]], t.Callable[P, R]]":
+    """Create a decorator that passes a key from
+    :attr:`click.Context.meta` as the first argument to the decorated
+    function.
+
+    :param key: Key in ``Context.meta`` to pass.
+    :param doc_description: Description of the object being passed,
+        inserted into the decorator's docstring. Defaults to "the 'key'
+        key from Context.meta".
+
+    .. versionadded:: 8.0
+    """
+
+    def decorator(f: "t.Callable[te.Concatenate[t.Any, P], R]") -> "t.Callable[P, R]":
+        def new_func(*args: "P.args", **kwargs: "P.kwargs") -> R:
+            ctx = get_current_context()
+            obj = ctx.meta[key]
+            return ctx.invoke(f, obj, *args, **kwargs)
+
+        return update_wrapper(new_func, f)
+
+    if doc_description is None:
+        doc_description = f"the {key!r} key from :attr:`click.Context.meta`"
+
+    decorator.__doc__ = (
+        f"Decorator that passes {doc_description} as the first argument"
+        " to the decorated function."
+    )
+    return decorator  # type: ignore[return-value]
+
+
+CmdType = t.TypeVar("CmdType", bound=Command)
+
+
+# variant: no call, directly as decorator for a function.
+@t.overload
+def command(name: _AnyCallable) -> Command:
+    ...
+
+
+# variant: with positional name and with positional or keyword cls argument:
+# @command(namearg, CommandCls, ...) or @command(namearg, cls=CommandCls, ...)
+@t.overload
+def command(
+    name: t.Optional[str],
+    cls: t.Type[CmdType],
+    **attrs: t.Any,
+) -> t.Callable[[_AnyCallable], CmdType]:
+    ...
+
+
+# variant: name omitted, cls _must_ be a keyword argument, @command(cls=CommandCls, ...)
+@t.overload
+def command(
+    name: None = None,
+    *,
+    cls: t.Type[CmdType],
+    **attrs: t.Any,
+) -> t.Callable[[_AnyCallable], CmdType]:
+    ...
+
+
+# variant: with optional string name, no cls argument provided.
+@t.overload
+def command(
+    name: t.Optional[str] = ..., cls: None = None, **attrs: t.Any
+) -> t.Callable[[_AnyCallable], Command]:
+    ...
+
+
+def command(
+    name: t.Union[t.Optional[str], _AnyCallable] = None,
+    cls: t.Optional[t.Type[CmdType]] = None,
+    **attrs: t.Any,
+) -> t.Union[Command, t.Callable[[_AnyCallable], t.Union[Command, CmdType]]]:
+    r"""Creates a new :class:`Command` and uses the decorated function as
+    callback.  This will also automatically attach all decorated
+    :func:`option`\s and :func:`argument`\s as parameters to the command.
+
+    The name of the command defaults to the name of the function with
+    underscores replaced by dashes.  If you want to change that, you can
+    pass the intended name as the first argument.
+
+    All keyword arguments are forwarded to the underlying command class.
+    For the ``params`` argument, any decorated params are appended to
+    the end of the list.
+
+    Once decorated the function turns into a :class:`Command` instance
+    that can be invoked as a command line utility or be attached to a
+    command :class:`Group`.
+
+    :param name: the name of the command.  This defaults to the function
+                 name with underscores replaced by dashes.
+    :param cls: the command class to instantiate.  This defaults to
+                :class:`Command`.
+
+    .. versionchanged:: 8.1
+        This decorator can be applied without parentheses.
+
+    .. versionchanged:: 8.1
+        The ``params`` argument can be used. Decorated params are
+        appended to the end of the list.
+    """
+
+    func: t.Optional[t.Callable[[_AnyCallable], t.Any]] = None
+
+    if callable(name):
+        func = name
+        name = None
+        assert cls is None, "Use 'command(cls=cls)(callable)' to specify a class."
+        assert not attrs, "Use 'command(**kwargs)(callable)' to provide arguments."
+
+    if cls is None:
+        cls = t.cast(t.Type[CmdType], Command)
+
+    def decorator(f: _AnyCallable) -> CmdType:
+        if isinstance(f, Command):
+            raise TypeError("Attempted to convert a callback into a command twice.")
+
+        attr_params = attrs.pop("params", None)
+        params = attr_params if attr_params is not None else []
+
+        try:
+            decorator_params = f.__click_params__  # type: ignore
+        except AttributeError:
+            pass
+        else:
+            del f.__click_params__  # type: ignore
+            params.extend(reversed(decorator_params))
+
+        if attrs.get("help") is None:
+            attrs["help"] = f.__doc__
+
+        if t.TYPE_CHECKING:
+            assert cls is not None
+            assert not callable(name)
+
+        cmd = cls(
+            name=name or f.__name__.lower().replace("_", "-"),
+            callback=f,
+            params=params,
+            **attrs,
+        )
+        cmd.__doc__ = f.__doc__
+        return cmd
+
+    if func is not None:
+        return decorator(func)
+
+    return decorator
+
+
+GrpType = t.TypeVar("GrpType", bound=Group)
+
+
+# variant: no call, directly as decorator for a function.
+@t.overload
+def group(name: _AnyCallable) -> Group:
+    ...
+
+
+# variant: with positional name and with positional or keyword cls argument:
+# @group(namearg, GroupCls, ...) or @group(namearg, cls=GroupCls, ...)
+@t.overload
+def group(
+    name: t.Optional[str],
+    cls: t.Type[GrpType],
+    **attrs: t.Any,
+) -> t.Callable[[_AnyCallable], GrpType]:
+    ...
+
+
+# variant: name omitted, cls _must_ be a keyword argument, @group(cmd=GroupCls, ...)
+@t.overload
+def group(
+    name: None = None,
+    *,
+    cls: t.Type[GrpType],
+    **attrs: t.Any,
+) -> t.Callable[[_AnyCallable], GrpType]:
+    ...
+
+
+# variant: with optional string name, no cls argument provided.
+@t.overload
+def group(
+    name: t.Optional[str] = ..., cls: None = None, **attrs: t.Any
+) -> t.Callable[[_AnyCallable], Group]:
+    ...
+
+
+def group(
+    name: t.Union[str, _AnyCallable, None] = None,
+    cls: t.Optional[t.Type[GrpType]] = None,
+    **attrs: t.Any,
+) -> t.Union[Group, t.Callable[[_AnyCallable], t.Union[Group, GrpType]]]:
+    """Creates a new :class:`Group` with a function as callback.  This
+    works otherwise the same as :func:`command` just that the `cls`
+    parameter is set to :class:`Group`.
+
+    .. versionchanged:: 8.1
+        This decorator can be applied without parentheses.
+    """
+    if cls is None:
+        cls = t.cast(t.Type[GrpType], Group)
+
+    if callable(name):
+        return command(cls=cls, **attrs)(name)
+
+    return command(name, cls, **attrs)
+
+
+def _param_memo(f: t.Callable[..., t.Any], param: Parameter) -> None:
+    if isinstance(f, Command):
+        f.params.append(param)
+    else:
+        if not hasattr(f, "__click_params__"):
+            f.__click_params__ = []  # type: ignore
+
+        f.__click_params__.append(param)  # type: ignore
+
+
+def argument(
+    *param_decls: str, cls: t.Optional[t.Type[Argument]] = None, **attrs: t.Any
+) -> t.Callable[[FC], FC]:
+    """Attaches an argument to the command.  All positional arguments are
+    passed as parameter declarations to :class:`Argument`; all keyword
+    arguments are forwarded unchanged (except ``cls``).
+    This is equivalent to creating an :class:`Argument` instance manually
+    and attaching it to the :attr:`Command.params` list.
+
+    For the default argument class, refer to :class:`Argument` and
+    :class:`Parameter` for descriptions of parameters.
+
+    :param cls: the argument class to instantiate.  This defaults to
+                :class:`Argument`.
+    :param param_decls: Passed as positional arguments to the constructor of
+        ``cls``.
+    :param attrs: Passed as keyword arguments to the constructor of ``cls``.
+    """
+    if cls is None:
+        cls = Argument
+
+    def decorator(f: FC) -> FC:
+        _param_memo(f, cls(param_decls, **attrs))
+        return f
+
+    return decorator
+
+
+def option(
+    *param_decls: str, cls: t.Optional[t.Type[Option]] = None, **attrs: t.Any
+) -> t.Callable[[FC], FC]:
+    """Attaches an option to the command.  All positional arguments are
+    passed as parameter declarations to :class:`Option`; all keyword
+    arguments are forwarded unchanged (except ``cls``).
+    This is equivalent to creating an :class:`Option` instance manually
+    and attaching it to the :attr:`Command.params` list.
+
+    For the default option class, refer to :class:`Option` and
+    :class:`Parameter` for descriptions of parameters.
+
+    :param cls: the option class to instantiate.  This defaults to
+                :class:`Option`.
+    :param param_decls: Passed as positional arguments to the constructor of
+        ``cls``.
+    :param attrs: Passed as keyword arguments to the constructor of ``cls``.
+    """
+    if cls is None:
+        cls = Option
+
+    def decorator(f: FC) -> FC:
+        _param_memo(f, cls(param_decls, **attrs))
+        return f
+
+    return decorator
+
+
+def confirmation_option(*param_decls: str, **kwargs: t.Any) -> t.Callable[[FC], FC]:
+    """Add a ``--yes`` option which shows a prompt before continuing if
+    not passed. If the prompt is declined, the program will exit.
+
+    :param param_decls: One or more option names. Defaults to the single
+        value ``"--yes"``.
+    :param kwargs: Extra arguments are passed to :func:`option`.
+    """
+
+    def callback(ctx: Context, param: Parameter, value: bool) -> None:
+        if not value:
+            ctx.abort()
+
+    if not param_decls:
+        param_decls = ("--yes",)
+
+    kwargs.setdefault("is_flag", True)
+    kwargs.setdefault("callback", callback)
+    kwargs.setdefault("expose_value", False)
+    kwargs.setdefault("prompt", "Do you want to continue?")
+    kwargs.setdefault("help", "Confirm the action without prompting.")
+    return option(*param_decls, **kwargs)
+
+
+def password_option(*param_decls: str, **kwargs: t.Any) -> t.Callable[[FC], FC]:
+    """Add a ``--password`` option which prompts for a password, hiding
+    input and asking to enter the value again for confirmation.
+
+    :param param_decls: One or more option names. Defaults to the single
+        value ``"--password"``.
+    :param kwargs: Extra arguments are passed to :func:`option`.
+    """
+    if not param_decls:
+        param_decls = ("--password",)
+
+    kwargs.setdefault("prompt", True)
+    kwargs.setdefault("confirmation_prompt", True)
+    kwargs.setdefault("hide_input", True)
+    return option(*param_decls, **kwargs)
+
+
+def version_option(
+    version: t.Optional[str] = None,
+    *param_decls: str,
+    package_name: t.Optional[str] = None,
+    prog_name: t.Optional[str] = None,
+    message: t.Optional[str] = None,
+    **kwargs: t.Any,
+) -> t.Callable[[FC], FC]:
+    """Add a ``--version`` option which immediately prints the version
+    number and exits the program.
+
+    If ``version`` is not provided, Click will try to detect it using
+    :func:`importlib.metadata.version` to get the version for the
+    ``package_name``. On Python < 3.8, the ``importlib_metadata``
+    backport must be installed.
+
+    If ``package_name`` is not provided, Click will try to detect it by
+    inspecting the stack frames. This will be used to detect the
+    version, so it must match the name of the installed package.
+
+    :param version: The version number to show. If not provided, Click
+        will try to detect it.
+    :param param_decls: One or more option names. Defaults to the single
+        value ``"--version"``.
+    :param package_name: The package name to detect the version from. If
+        not provided, Click will try to detect it.
+    :param prog_name: The name of the CLI to show in the message. If not
+        provided, it will be detected from the command.
+    :param message: The message to show. The values ``%(prog)s``,
+        ``%(package)s``, and ``%(version)s`` are available. Defaults to
+        ``"%(prog)s, version %(version)s"``.
+    :param kwargs: Extra arguments are passed to :func:`option`.
+    :raise RuntimeError: ``version`` could not be detected.
+
+    .. versionchanged:: 8.0
+        Add the ``package_name`` parameter, and the ``%(package)s``
+        value for messages.
+
+    .. versionchanged:: 8.0
+        Use :mod:`importlib.metadata` instead of ``pkg_resources``. The
+        version is detected based on the package name, not the entry
+        point name. The Python package name must match the installed
+        package name, or be passed with ``package_name=``.
+    """
+    if message is None:
+        message = _("%(prog)s, version %(version)s")
+
+    if version is None and package_name is None:
+        frame = inspect.currentframe()
+        f_back = frame.f_back if frame is not None else None
+        f_globals = f_back.f_globals if f_back is not None else None
+        # break reference cycle
+        # https://docs.python.org/3/library/inspect.html#the-interpreter-stack
+        del frame
+
+        if f_globals is not None:
+            package_name = f_globals.get("__name__")
+
+            if package_name == "__main__":
+                package_name = f_globals.get("__package__")
+
+            if package_name:
+                package_name = package_name.partition(".")[0]
+
+    def callback(ctx: Context, param: Parameter, value: bool) -> None:
+        if not value or ctx.resilient_parsing:
+            return
+
+        nonlocal prog_name
+        nonlocal version
+
+        if prog_name is None:
+            prog_name = ctx.find_root().info_name
+
+        if version is None and package_name is not None:
+            metadata: t.Optional[types.ModuleType]
+
+            try:
+                from importlib import metadata  # type: ignore
+            except ImportError:
+                # Python < 3.8
+                import importlib_metadata as metadata  # type: ignore
+
+            try:
+                version = metadata.version(package_name)  # type: ignore
+            except metadata.PackageNotFoundError:  # type: ignore
+                raise RuntimeError(
+                    f"{package_name!r} is not installed. Try passing"
+                    " 'package_name' instead."
+                ) from None
+
+        if version is None:
+            raise RuntimeError(
+                f"Could not determine the version for {package_name!r} automatically."
+            )
+
+        echo(
+            message % {"prog": prog_name, "package": package_name, "version": version},
+            color=ctx.color,
+        )
+        ctx.exit()
+
+    if not param_decls:
+        param_decls = ("--version",)
+
+    kwargs.setdefault("is_flag", True)
+    kwargs.setdefault("expose_value", False)
+    kwargs.setdefault("is_eager", True)
+    kwargs.setdefault("help", _("Show the version and exit."))
+    kwargs["callback"] = callback
+    return option(*param_decls, **kwargs)
+
+
+def help_option(*param_decls: str, **kwargs: t.Any) -> t.Callable[[FC], FC]:
+    """Add a ``--help`` option which immediately prints the help page
+    and exits the program.
+
+    This is usually unnecessary, as the ``--help`` option is added to
+    each command automatically unless ``add_help_option=False`` is
+    passed.
+
+    :param param_decls: One or more option names. Defaults to the single
+        value ``"--help"``.
+    :param kwargs: Extra arguments are passed to :func:`option`.
+    """
+
+    def callback(ctx: Context, param: Parameter, value: bool) -> None:
+        if not value or ctx.resilient_parsing:
+            return
+
+        echo(ctx.get_help(), color=ctx.color)
+        ctx.exit()
+
+    if not param_decls:
+        param_decls = ("--help",)
+
+    kwargs.setdefault("is_flag", True)
+    kwargs.setdefault("expose_value", False)
+    kwargs.setdefault("is_eager", True)
+    kwargs.setdefault("help", _("Show this message and exit."))
+    kwargs["callback"] = callback
+    return option(*param_decls, **kwargs)
diff --git a/llm/Lib/site-packages/click/exceptions.py b/llm/Lib/site-packages/click/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe68a3613f74e5e82da4e3eedc7d9451977838dd
--- /dev/null
+++ b/llm/Lib/site-packages/click/exceptions.py
@@ -0,0 +1,288 @@
+import typing as t
+from gettext import gettext as _
+from gettext import ngettext
+
+from ._compat import get_text_stderr
+from .utils import echo
+from .utils import format_filename
+
+if t.TYPE_CHECKING:
+    from .core import Command
+    from .core import Context
+    from .core import Parameter
+
+
+def _join_param_hints(
+    param_hint: t.Optional[t.Union[t.Sequence[str], str]]
+) -> t.Optional[str]:
+    if param_hint is not None and not isinstance(param_hint, str):
+        return " / ".join(repr(x) for x in param_hint)
+
+    return param_hint
+
+
+class ClickException(Exception):
+    """An exception that Click can handle and show to the user."""
+
+    #: The exit code for this exception.
+    exit_code = 1
+
+    def __init__(self, message: str) -> None:
+        super().__init__(message)
+        self.message = message
+
+    def format_message(self) -> str:
+        return self.message
+
+    def __str__(self) -> str:
+        return self.message
+
+    def show(self, file: t.Optional[t.IO[t.Any]] = None) -> None:
+        if file is None:
+            file = get_text_stderr()
+
+        echo(_("Error: {message}").format(message=self.format_message()), file=file)
+
+
+class UsageError(ClickException):
+    """An internal exception that signals a usage error.  This typically
+    aborts any further handling.
+
+    :param message: the error message to display.
+    :param ctx: optionally the context that caused this error.  Click will
+                fill in the context automatically in some situations.
+    """
+
+    exit_code = 2
+
+    def __init__(self, message: str, ctx: t.Optional["Context"] = None) -> None:
+        super().__init__(message)
+        self.ctx = ctx
+        self.cmd: t.Optional["Command"] = self.ctx.command if self.ctx else None
+
+    def show(self, file: t.Optional[t.IO[t.Any]] = None) -> None:
+        if file is None:
+            file = get_text_stderr()
+        color = None
+        hint = ""
+        if (
+            self.ctx is not None
+            and self.ctx.command.get_help_option(self.ctx) is not None
+        ):
+            hint = _("Try '{command} {option}' for help.").format(
+                command=self.ctx.command_path, option=self.ctx.help_option_names[0]
+            )
+            hint = f"{hint}\n"
+        if self.ctx is not None:
+            color = self.ctx.color
+            echo(f"{self.ctx.get_usage()}\n{hint}", file=file, color=color)
+        echo(
+            _("Error: {message}").format(message=self.format_message()),
+            file=file,
+            color=color,
+        )
+
+
+class BadParameter(UsageError):
+    """An exception that formats out a standardized error message for a
+    bad parameter.  This is useful when thrown from a callback or type as
+    Click will attach contextual information to it (for instance, which
+    parameter it is).
+
+    .. versionadded:: 2.0
+
+    :param param: the parameter object that caused this error.  This can
+                  be left out, and Click will attach this info itself
+                  if possible.
+    :param param_hint: a string that shows up as parameter name.  This
+                       can be used as alternative to `param` in cases
+                       where custom validation should happen.  If it is
+                       a string it's used as such, if it's a list then
+                       each item is quoted and separated.
+    """
+
+    def __init__(
+        self,
+        message: str,
+        ctx: t.Optional["Context"] = None,
+        param: t.Optional["Parameter"] = None,
+        param_hint: t.Optional[str] = None,
+    ) -> None:
+        super().__init__(message, ctx)
+        self.param = param
+        self.param_hint = param_hint
+
+    def format_message(self) -> str:
+        if self.param_hint is not None:
+            param_hint = self.param_hint
+        elif self.param is not None:
+            param_hint = self.param.get_error_hint(self.ctx)  # type: ignore
+        else:
+            return _("Invalid value: {message}").format(message=self.message)
+
+        return _("Invalid value for {param_hint}: {message}").format(
+            param_hint=_join_param_hints(param_hint), message=self.message
+        )
+
+
+class MissingParameter(BadParameter):
+    """Raised if click required an option or argument but it was not
+    provided when invoking the script.
+
+    .. versionadded:: 4.0
+
+    :param param_type: a string that indicates the type of the parameter.
+                       The default is to inherit the parameter type from
+                       the given `param`.  Valid values are ``'parameter'``,
+                       ``'option'`` or ``'argument'``.
+    """
+
+    def __init__(
+        self,
+        message: t.Optional[str] = None,
+        ctx: t.Optional["Context"] = None,
+        param: t.Optional["Parameter"] = None,
+        param_hint: t.Optional[str] = None,
+        param_type: t.Optional[str] = None,
+    ) -> None:
+        super().__init__(message or "", ctx, param, param_hint)
+        self.param_type = param_type
+
+    def format_message(self) -> str:
+        if self.param_hint is not None:
+            param_hint: t.Optional[str] = self.param_hint
+        elif self.param is not None:
+            param_hint = self.param.get_error_hint(self.ctx)  # type: ignore
+        else:
+            param_hint = None
+
+        param_hint = _join_param_hints(param_hint)
+        param_hint = f" {param_hint}" if param_hint else ""
+
+        param_type = self.param_type
+        if param_type is None and self.param is not None:
+            param_type = self.param.param_type_name
+
+        msg = self.message
+        if self.param is not None:
+            msg_extra = self.param.type.get_missing_message(self.param)
+            if msg_extra:
+                if msg:
+                    msg += f". {msg_extra}"
+                else:
+                    msg = msg_extra
+
+        msg = f" {msg}" if msg else ""
+
+        # Translate param_type for known types.
+        if param_type == "argument":
+            missing = _("Missing argument")
+        elif param_type == "option":
+            missing = _("Missing option")
+        elif param_type == "parameter":
+            missing = _("Missing parameter")
+        else:
+            missing = _("Missing {param_type}").format(param_type=param_type)
+
+        return f"{missing}{param_hint}.{msg}"
+
+    def __str__(self) -> str:
+        if not self.message:
+            param_name = self.param.name if self.param else None
+            return _("Missing parameter: {param_name}").format(param_name=param_name)
+        else:
+            return self.message
+
+
+class NoSuchOption(UsageError):
+    """Raised if click attempted to handle an option that does not
+    exist.
+
+    .. versionadded:: 4.0
+    """
+
+    def __init__(
+        self,
+        option_name: str,
+        message: t.Optional[str] = None,
+        possibilities: t.Optional[t.Sequence[str]] = None,
+        ctx: t.Optional["Context"] = None,
+    ) -> None:
+        if message is None:
+            message = _("No such option: {name}").format(name=option_name)
+
+        super().__init__(message, ctx)
+        self.option_name = option_name
+        self.possibilities = possibilities
+
+    def format_message(self) -> str:
+        if not self.possibilities:
+            return self.message
+
+        possibility_str = ", ".join(sorted(self.possibilities))
+        suggest = ngettext(
+            "Did you mean {possibility}?",
+            "(Possible options: {possibilities})",
+            len(self.possibilities),
+        ).format(possibility=possibility_str, possibilities=possibility_str)
+        return f"{self.message} {suggest}"
+
+
+class BadOptionUsage(UsageError):
+    """Raised if an option is generally supplied but the use of the option
+    was incorrect.  This is for instance raised if the number of arguments
+    for an option is not correct.
+
+    .. versionadded:: 4.0
+
+    :param option_name: the name of the option being used incorrectly.
+    """
+
+    def __init__(
+        self, option_name: str, message: str, ctx: t.Optional["Context"] = None
+    ) -> None:
+        super().__init__(message, ctx)
+        self.option_name = option_name
+
+
+class BadArgumentUsage(UsageError):
+    """Raised if an argument is generally supplied but the use of the argument
+    was incorrect.  This is for instance raised if the number of values
+    for an argument is not correct.
+
+    .. versionadded:: 6.0
+    """
+
+
+class FileError(ClickException):
+    """Raised if a file cannot be opened."""
+
+    def __init__(self, filename: str, hint: t.Optional[str] = None) -> None:
+        if hint is None:
+            hint = _("unknown error")
+
+        super().__init__(hint)
+        self.ui_filename: str = format_filename(filename)
+        self.filename = filename
+
+    def format_message(self) -> str:
+        return _("Could not open file {filename!r}: {message}").format(
+            filename=self.ui_filename, message=self.message
+        )
+
+
+class Abort(RuntimeError):
+    """An internal signalling exception that signals Click to abort."""
+
+
+class Exit(RuntimeError):
+    """An exception that indicates that the application should exit with some
+    status code.
+
+    :param code: the status code to exit with.
+    """
+
+    __slots__ = ("exit_code",)
+
+    def __init__(self, code: int = 0) -> None:
+        self.exit_code: int = code
diff --git a/llm/Lib/site-packages/click/formatting.py b/llm/Lib/site-packages/click/formatting.py
new file mode 100644
index 0000000000000000000000000000000000000000..ddd2a2f825f206164eb9efb0a5c41528365beb85
--- /dev/null
+++ b/llm/Lib/site-packages/click/formatting.py
@@ -0,0 +1,301 @@
+import typing as t
+from contextlib import contextmanager
+from gettext import gettext as _
+
+from ._compat import term_len
+from .parser import split_opt
+
+# Can force a width.  This is used by the test system
+FORCED_WIDTH: t.Optional[int] = None
+
+
+def measure_table(rows: t.Iterable[t.Tuple[str, str]]) -> t.Tuple[int, ...]:
+    widths: t.Dict[int, int] = {}
+
+    for row in rows:
+        for idx, col in enumerate(row):
+            widths[idx] = max(widths.get(idx, 0), term_len(col))
+
+    return tuple(y for x, y in sorted(widths.items()))
+
+
+def iter_rows(
+    rows: t.Iterable[t.Tuple[str, str]], col_count: int
+) -> t.Iterator[t.Tuple[str, ...]]:
+    for row in rows:
+        yield row + ("",) * (col_count - len(row))
+
+
+def wrap_text(
+    text: str,
+    width: int = 78,
+    initial_indent: str = "",
+    subsequent_indent: str = "",
+    preserve_paragraphs: bool = False,
+) -> str:
+    """A helper function that intelligently wraps text.  By default, it
+    assumes that it operates on a single paragraph of text but if the
+    `preserve_paragraphs` parameter is provided it will intelligently
+    handle paragraphs (defined by two empty lines).
+
+    If paragraphs are handled, a paragraph can be prefixed with an empty
+    line containing the ``\\b`` character (``\\x08``) to indicate that
+    no rewrapping should happen in that block.
+
+    :param text: the text that should be rewrapped.
+    :param width: the maximum width for the text.
+    :param initial_indent: the initial indent that should be placed on the
+                           first line as a string.
+    :param subsequent_indent: the indent string that should be placed on
+                              each consecutive line.
+    :param preserve_paragraphs: if this flag is set then the wrapping will
+                                intelligently handle paragraphs.
+    """
+    from ._textwrap import TextWrapper
+
+    text = text.expandtabs()
+    wrapper = TextWrapper(
+        width,
+        initial_indent=initial_indent,
+        subsequent_indent=subsequent_indent,
+        replace_whitespace=False,
+    )
+    if not preserve_paragraphs:
+        return wrapper.fill(text)
+
+    p: t.List[t.Tuple[int, bool, str]] = []
+    buf: t.List[str] = []
+    indent = None
+
+    def _flush_par() -> None:
+        if not buf:
+            return
+        if buf[0].strip() == "\b":
+            p.append((indent or 0, True, "\n".join(buf[1:])))
+        else:
+            p.append((indent or 0, False, " ".join(buf)))
+        del buf[:]
+
+    for line in text.splitlines():
+        if not line:
+            _flush_par()
+            indent = None
+        else:
+            if indent is None:
+                orig_len = term_len(line)
+                line = line.lstrip()
+                indent = orig_len - term_len(line)
+            buf.append(line)
+    _flush_par()
+
+    rv = []
+    for indent, raw, text in p:
+        with wrapper.extra_indent(" " * indent):
+            if raw:
+                rv.append(wrapper.indent_only(text))
+            else:
+                rv.append(wrapper.fill(text))
+
+    return "\n\n".join(rv)
+
+
+class HelpFormatter:
+    """This class helps with formatting text-based help pages.  It's
+    usually just needed for very special internal cases, but it's also
+    exposed so that developers can write their own fancy outputs.
+
+    At present, it always writes into memory.
+
+    :param indent_increment: the additional increment for each level.
+    :param width: the width for the text.  This defaults to the terminal
+                  width clamped to a maximum of 78.
+    """
+
+    def __init__(
+        self,
+        indent_increment: int = 2,
+        width: t.Optional[int] = None,
+        max_width: t.Optional[int] = None,
+    ) -> None:
+        import shutil
+
+        self.indent_increment = indent_increment
+        if max_width is None:
+            max_width = 80
+        if width is None:
+            width = FORCED_WIDTH
+            if width is None:
+                width = max(min(shutil.get_terminal_size().columns, max_width) - 2, 50)
+        self.width = width
+        self.current_indent = 0
+        self.buffer: t.List[str] = []
+
+    def write(self, string: str) -> None:
+        """Writes a unicode string into the internal buffer."""
+        self.buffer.append(string)
+
+    def indent(self) -> None:
+        """Increases the indentation."""
+        self.current_indent += self.indent_increment
+
+    def dedent(self) -> None:
+        """Decreases the indentation."""
+        self.current_indent -= self.indent_increment
+
+    def write_usage(
+        self, prog: str, args: str = "", prefix: t.Optional[str] = None
+    ) -> None:
+        """Writes a usage line into the buffer.
+
+        :param prog: the program name.
+        :param args: whitespace separated list of arguments.
+        :param prefix: The prefix for the first line. Defaults to
+            ``"Usage: "``.
+        """
+        if prefix is None:
+            prefix = f"{_('Usage:')} "
+
+        usage_prefix = f"{prefix:>{self.current_indent}}{prog} "
+        text_width = self.width - self.current_indent
+
+        if text_width >= (term_len(usage_prefix) + 20):
+            # The arguments will fit to the right of the prefix.
+            indent = " " * term_len(usage_prefix)
+            self.write(
+                wrap_text(
+                    args,
+                    text_width,
+                    initial_indent=usage_prefix,
+                    subsequent_indent=indent,
+                )
+            )
+        else:
+            # The prefix is too long, put the arguments on the next line.
+            self.write(usage_prefix)
+            self.write("\n")
+            indent = " " * (max(self.current_indent, term_len(prefix)) + 4)
+            self.write(
+                wrap_text(
+                    args, text_width, initial_indent=indent, subsequent_indent=indent
+                )
+            )
+
+        self.write("\n")
+
+    def write_heading(self, heading: str) -> None:
+        """Writes a heading into the buffer."""
+        self.write(f"{'':>{self.current_indent}}{heading}:\n")
+
+    def write_paragraph(self) -> None:
+        """Writes a paragraph into the buffer."""
+        if self.buffer:
+            self.write("\n")
+
+    def write_text(self, text: str) -> None:
+        """Writes re-indented text into the buffer.  This rewraps and
+        preserves paragraphs.
+        """
+        indent = " " * self.current_indent
+        self.write(
+            wrap_text(
+                text,
+                self.width,
+                initial_indent=indent,
+                subsequent_indent=indent,
+                preserve_paragraphs=True,
+            )
+        )
+        self.write("\n")
+
+    def write_dl(
+        self,
+        rows: t.Sequence[t.Tuple[str, str]],
+        col_max: int = 30,
+        col_spacing: int = 2,
+    ) -> None:
+        """Writes a definition list into the buffer.  This is how options
+        and commands are usually formatted.
+
+        :param rows: a list of two item tuples for the terms and values.
+        :param col_max: the maximum width of the first column.
+        :param col_spacing: the number of spaces between the first and
+                            second column.
+        """
+        rows = list(rows)
+        widths = measure_table(rows)
+        if len(widths) != 2:
+            raise TypeError("Expected two columns for definition list")
+
+        first_col = min(widths[0], col_max) + col_spacing
+
+        for first, second in iter_rows(rows, len(widths)):
+            self.write(f"{'':>{self.current_indent}}{first}")
+            if not second:
+                self.write("\n")
+                continue
+            if term_len(first) <= first_col - col_spacing:
+                self.write(" " * (first_col - term_len(first)))
+            else:
+                self.write("\n")
+                self.write(" " * (first_col + self.current_indent))
+
+            text_width = max(self.width - first_col - 2, 10)
+            wrapped_text = wrap_text(second, text_width, preserve_paragraphs=True)
+            lines = wrapped_text.splitlines()
+
+            if lines:
+                self.write(f"{lines[0]}\n")
+
+                for line in lines[1:]:
+                    self.write(f"{'':>{first_col + self.current_indent}}{line}\n")
+            else:
+                self.write("\n")
+
+    @contextmanager
+    def section(self, name: str) -> t.Iterator[None]:
+        """Helpful context manager that writes a paragraph, a heading,
+        and the indents.
+
+        :param name: the section name that is written as heading.
+        """
+        self.write_paragraph()
+        self.write_heading(name)
+        self.indent()
+        try:
+            yield
+        finally:
+            self.dedent()
+
+    @contextmanager
+    def indentation(self) -> t.Iterator[None]:
+        """A context manager that increases the indentation."""
+        self.indent()
+        try:
+            yield
+        finally:
+            self.dedent()
+
+    def getvalue(self) -> str:
+        """Returns the buffer contents."""
+        return "".join(self.buffer)
+
+
+def join_options(options: t.Sequence[str]) -> t.Tuple[str, bool]:
+    """Given a list of option strings this joins them in the most appropriate
+    way and returns them in the form ``(formatted_string,
+    any_prefix_is_slash)`` where the second item in the tuple is a flag that
+    indicates if any of the option prefixes was a slash.
+    """
+    rv = []
+    any_prefix_is_slash = False
+
+    for opt in options:
+        prefix = split_opt(opt)[0]
+
+        if prefix == "/":
+            any_prefix_is_slash = True
+
+        rv.append((len(prefix), opt))
+
+    rv.sort(key=lambda x: x[0])
+    return ", ".join(x[1] for x in rv), any_prefix_is_slash
diff --git a/llm/Lib/site-packages/click/globals.py b/llm/Lib/site-packages/click/globals.py
new file mode 100644
index 0000000000000000000000000000000000000000..480058f10dd6a8205d1bff0b94de7ae347a7629a
--- /dev/null
+++ b/llm/Lib/site-packages/click/globals.py
@@ -0,0 +1,68 @@
+import typing as t
+from threading import local
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+    from .core import Context
+
+_local = local()
+
+
+@t.overload
+def get_current_context(silent: "te.Literal[False]" = False) -> "Context":
+    ...
+
+
+@t.overload
+def get_current_context(silent: bool = ...) -> t.Optional["Context"]:
+    ...
+
+
+def get_current_context(silent: bool = False) -> t.Optional["Context"]:
+    """Returns the current click context.  This can be used as a way to
+    access the current context object from anywhere.  This is a more implicit
+    alternative to the :func:`pass_context` decorator.  This function is
+    primarily useful for helpers such as :func:`echo` which might be
+    interested in changing its behavior based on the current context.
+
+    To push the current context, :meth:`Context.scope` can be used.
+
+    .. versionadded:: 5.0
+
+    :param silent: if set to `True` the return value is `None` if no context
+                   is available.  The default behavior is to raise a
+                   :exc:`RuntimeError`.
+    """
+    try:
+        return t.cast("Context", _local.stack[-1])
+    except (AttributeError, IndexError) as e:
+        if not silent:
+            raise RuntimeError("There is no active click context.") from e
+
+    return None
+
+
+def push_context(ctx: "Context") -> None:
+    """Pushes a new context to the current stack."""
+    _local.__dict__.setdefault("stack", []).append(ctx)
+
+
+def pop_context() -> None:
+    """Removes the top level from the stack."""
+    _local.stack.pop()
+
+
+def resolve_color_default(color: t.Optional[bool] = None) -> t.Optional[bool]:
+    """Internal helper to get the default value of the color flag.  If a
+    value is passed it's returned unchanged, otherwise it's looked up from
+    the current context.
+    """
+    if color is not None:
+        return color
+
+    ctx = get_current_context(silent=True)
+
+    if ctx is not None:
+        return ctx.color
+
+    return None
diff --git a/llm/Lib/site-packages/click/parser.py b/llm/Lib/site-packages/click/parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..5fa7adfac842bfa5689fd1a41ae4017be1ebff6f
--- /dev/null
+++ b/llm/Lib/site-packages/click/parser.py
@@ -0,0 +1,529 @@
+"""
+This module started out as largely a copy paste from the stdlib's
+optparse module with the features removed that we do not need from
+optparse because we implement them in Click on a higher level (for
+instance type handling, help formatting and a lot more).
+
+The plan is to remove more and more from here over time.
+
+The reason this is a different module and not optparse from the stdlib
+is that there are differences in 2.x and 3.x about the error messages
+generated and optparse in the stdlib uses gettext for no good reason
+and might cause us issues.
+
+Click uses parts of optparse written by Gregory P. Ward and maintained
+by the Python Software Foundation. This is limited to code in parser.py.
+
+Copyright 2001-2006 Gregory P. Ward. All rights reserved.
+Copyright 2002-2006 Python Software Foundation. All rights reserved.
+"""
+# This code uses parts of optparse written by Gregory P. Ward and
+# maintained by the Python Software Foundation.
+# Copyright 2001-2006 Gregory P. Ward
+# Copyright 2002-2006 Python Software Foundation
+import typing as t
+from collections import deque
+from gettext import gettext as _
+from gettext import ngettext
+
+from .exceptions import BadArgumentUsage
+from .exceptions import BadOptionUsage
+from .exceptions import NoSuchOption
+from .exceptions import UsageError
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+    from .core import Argument as CoreArgument
+    from .core import Context
+    from .core import Option as CoreOption
+    from .core import Parameter as CoreParameter
+
+V = t.TypeVar("V")
+
+# Sentinel value that indicates an option was passed as a flag without a
+# value but is not a flag option. Option.consume_value uses this to
+# prompt or use the flag_value.
+_flag_needs_value = object()
+
+
+def _unpack_args(
+    args: t.Sequence[str], nargs_spec: t.Sequence[int]
+) -> t.Tuple[t.Sequence[t.Union[str, t.Sequence[t.Optional[str]], None]], t.List[str]]:
+    """Given an iterable of arguments and an iterable of nargs specifications,
+    it returns a tuple with all the unpacked arguments at the first index
+    and all remaining arguments as the second.
+
+    The nargs specification is the number of arguments that should be consumed
+    or `-1` to indicate that this position should eat up all the remainders.
+
+    Missing items are filled with `None`.
+    """
+    args = deque(args)
+    nargs_spec = deque(nargs_spec)
+    rv: t.List[t.Union[str, t.Tuple[t.Optional[str], ...], None]] = []
+    spos: t.Optional[int] = None
+
+    def _fetch(c: "te.Deque[V]") -> t.Optional[V]:
+        try:
+            if spos is None:
+                return c.popleft()
+            else:
+                return c.pop()
+        except IndexError:
+            return None
+
+    while nargs_spec:
+        nargs = _fetch(nargs_spec)
+
+        if nargs is None:
+            continue
+
+        if nargs == 1:
+            rv.append(_fetch(args))
+        elif nargs > 1:
+            x = [_fetch(args) for _ in range(nargs)]
+
+            # If we're reversed, we're pulling in the arguments in reverse,
+            # so we need to turn them around.
+            if spos is not None:
+                x.reverse()
+
+            rv.append(tuple(x))
+        elif nargs < 0:
+            if spos is not None:
+                raise TypeError("Cannot have two nargs < 0")
+
+            spos = len(rv)
+            rv.append(None)
+
+    # spos is the position of the wildcard (star).  If it's not `None`,
+    # we fill it with the remainder.
+    if spos is not None:
+        rv[spos] = tuple(args)
+        args = []
+        rv[spos + 1 :] = reversed(rv[spos + 1 :])
+
+    return tuple(rv), list(args)
+
+
+def split_opt(opt: str) -> t.Tuple[str, str]:
+    first = opt[:1]
+    if first.isalnum():
+        return "", opt
+    if opt[1:2] == first:
+        return opt[:2], opt[2:]
+    return first, opt[1:]
+
+
+def normalize_opt(opt: str, ctx: t.Optional["Context"]) -> str:
+    if ctx is None or ctx.token_normalize_func is None:
+        return opt
+    prefix, opt = split_opt(opt)
+    return f"{prefix}{ctx.token_normalize_func(opt)}"
+
+
+def split_arg_string(string: str) -> t.List[str]:
+    """Split an argument string as with :func:`shlex.split`, but don't
+    fail if the string is incomplete. Ignores a missing closing quote or
+    incomplete escape sequence and uses the partial token as-is.
+
+    .. code-block:: python
+
+        split_arg_string("example 'my file")
+        ["example", "my file"]
+
+        split_arg_string("example my\\")
+        ["example", "my"]
+
+    :param string: String to split.
+    """
+    import shlex
+
+    lex = shlex.shlex(string, posix=True)
+    lex.whitespace_split = True
+    lex.commenters = ""
+    out = []
+
+    try:
+        for token in lex:
+            out.append(token)
+    except ValueError:
+        # Raised when end-of-string is reached in an invalid state. Use
+        # the partial token as-is. The quote or escape character is in
+        # lex.state, not lex.token.
+        out.append(lex.token)
+
+    return out
+
+
+class Option:
+    def __init__(
+        self,
+        obj: "CoreOption",
+        opts: t.Sequence[str],
+        dest: t.Optional[str],
+        action: t.Optional[str] = None,
+        nargs: int = 1,
+        const: t.Optional[t.Any] = None,
+    ):
+        self._short_opts = []
+        self._long_opts = []
+        self.prefixes: t.Set[str] = set()
+
+        for opt in opts:
+            prefix, value = split_opt(opt)
+            if not prefix:
+                raise ValueError(f"Invalid start character for option ({opt})")
+            self.prefixes.add(prefix[0])
+            if len(prefix) == 1 and len(value) == 1:
+                self._short_opts.append(opt)
+            else:
+                self._long_opts.append(opt)
+                self.prefixes.add(prefix)
+
+        if action is None:
+            action = "store"
+
+        self.dest = dest
+        self.action = action
+        self.nargs = nargs
+        self.const = const
+        self.obj = obj
+
+    @property
+    def takes_value(self) -> bool:
+        return self.action in ("store", "append")
+
+    def process(self, value: t.Any, state: "ParsingState") -> None:
+        if self.action == "store":
+            state.opts[self.dest] = value  # type: ignore
+        elif self.action == "store_const":
+            state.opts[self.dest] = self.const  # type: ignore
+        elif self.action == "append":
+            state.opts.setdefault(self.dest, []).append(value)  # type: ignore
+        elif self.action == "append_const":
+            state.opts.setdefault(self.dest, []).append(self.const)  # type: ignore
+        elif self.action == "count":
+            state.opts[self.dest] = state.opts.get(self.dest, 0) + 1  # type: ignore
+        else:
+            raise ValueError(f"unknown action '{self.action}'")
+        state.order.append(self.obj)
+
+
+class Argument:
+    def __init__(self, obj: "CoreArgument", dest: t.Optional[str], nargs: int = 1):
+        self.dest = dest
+        self.nargs = nargs
+        self.obj = obj
+
+    def process(
+        self,
+        value: t.Union[t.Optional[str], t.Sequence[t.Optional[str]]],
+        state: "ParsingState",
+    ) -> None:
+        if self.nargs > 1:
+            assert value is not None
+            holes = sum(1 for x in value if x is None)
+            if holes == len(value):
+                value = None
+            elif holes != 0:
+                raise BadArgumentUsage(
+                    _("Argument {name!r} takes {nargs} values.").format(
+                        name=self.dest, nargs=self.nargs
+                    )
+                )
+
+        if self.nargs == -1 and self.obj.envvar is not None and value == ():
+            # Replace empty tuple with None so that a value from the
+            # environment may be tried.
+            value = None
+
+        state.opts[self.dest] = value  # type: ignore
+        state.order.append(self.obj)
+
+
+class ParsingState:
+    def __init__(self, rargs: t.List[str]) -> None:
+        self.opts: t.Dict[str, t.Any] = {}
+        self.largs: t.List[str] = []
+        self.rargs = rargs
+        self.order: t.List["CoreParameter"] = []
+
+
+class OptionParser:
+    """The option parser is an internal class that is ultimately used to
+    parse options and arguments.  It's modelled after optparse and brings
+    a similar but vastly simplified API.  It should generally not be used
+    directly as the high level Click classes wrap it for you.
+
+    It's not nearly as extensible as optparse or argparse as it does not
+    implement features that are implemented on a higher level (such as
+    types or defaults).
+
+    :param ctx: optionally the :class:`~click.Context` where this parser
+                should go with.
+    """
+
+    def __init__(self, ctx: t.Optional["Context"] = None) -> None:
+        #: The :class:`~click.Context` for this parser.  This might be
+        #: `None` for some advanced use cases.
+        self.ctx = ctx
+        #: This controls how the parser deals with interspersed arguments.
+        #: If this is set to `False`, the parser will stop on the first
+        #: non-option.  Click uses this to implement nested subcommands
+        #: safely.
+        self.allow_interspersed_args: bool = True
+        #: This tells the parser how to deal with unknown options.  By
+        #: default it will error out (which is sensible), but there is a
+        #: second mode where it will ignore it and continue processing
+        #: after shifting all the unknown options into the resulting args.
+        self.ignore_unknown_options: bool = False
+
+        if ctx is not None:
+            self.allow_interspersed_args = ctx.allow_interspersed_args
+            self.ignore_unknown_options = ctx.ignore_unknown_options
+
+        self._short_opt: t.Dict[str, Option] = {}
+        self._long_opt: t.Dict[str, Option] = {}
+        self._opt_prefixes = {"-", "--"}
+        self._args: t.List[Argument] = []
+
+    def add_option(
+        self,
+        obj: "CoreOption",
+        opts: t.Sequence[str],
+        dest: t.Optional[str],
+        action: t.Optional[str] = None,
+        nargs: int = 1,
+        const: t.Optional[t.Any] = None,
+    ) -> None:
+        """Adds a new option named `dest` to the parser.  The destination
+        is not inferred (unlike with optparse) and needs to be explicitly
+        provided.  Action can be any of ``store``, ``store_const``,
+        ``append``, ``append_const`` or ``count``.
+
+        The `obj` can be used to identify the option in the order list
+        that is returned from the parser.
+        """
+        opts = [normalize_opt(opt, self.ctx) for opt in opts]
+        option = Option(obj, opts, dest, action=action, nargs=nargs, const=const)
+        self._opt_prefixes.update(option.prefixes)
+        for opt in option._short_opts:
+            self._short_opt[opt] = option
+        for opt in option._long_opts:
+            self._long_opt[opt] = option
+
+    def add_argument(
+        self, obj: "CoreArgument", dest: t.Optional[str], nargs: int = 1
+    ) -> None:
+        """Adds a positional argument named `dest` to the parser.
+
+        The `obj` can be used to identify the option in the order list
+        that is returned from the parser.
+        """
+        self._args.append(Argument(obj, dest=dest, nargs=nargs))
+
+    def parse_args(
+        self, args: t.List[str]
+    ) -> t.Tuple[t.Dict[str, t.Any], t.List[str], t.List["CoreParameter"]]:
+        """Parses positional arguments and returns ``(values, args, order)``
+        for the parsed options and arguments as well as the leftover
+        arguments if there are any.  The order is a list of objects as they
+        appear on the command line.  If arguments appear multiple times they
+        will be memorized multiple times as well.
+        """
+        state = ParsingState(args)
+        try:
+            self._process_args_for_options(state)
+            self._process_args_for_args(state)
+        except UsageError:
+            if self.ctx is None or not self.ctx.resilient_parsing:
+                raise
+        return state.opts, state.largs, state.order
+
+    def _process_args_for_args(self, state: ParsingState) -> None:
+        pargs, args = _unpack_args(
+            state.largs + state.rargs, [x.nargs for x in self._args]
+        )
+
+        for idx, arg in enumerate(self._args):
+            arg.process(pargs[idx], state)
+
+        state.largs = args
+        state.rargs = []
+
+    def _process_args_for_options(self, state: ParsingState) -> None:
+        while state.rargs:
+            arg = state.rargs.pop(0)
+            arglen = len(arg)
+            # Double dashes always handled explicitly regardless of what
+            # prefixes are valid.
+            if arg == "--":
+                return
+            elif arg[:1] in self._opt_prefixes and arglen > 1:
+                self._process_opts(arg, state)
+            elif self.allow_interspersed_args:
+                state.largs.append(arg)
+            else:
+                state.rargs.insert(0, arg)
+                return
+
+        # Say this is the original argument list:
+        # [arg0, arg1, ..., arg(i-1), arg(i), arg(i+1), ..., arg(N-1)]
+        #                            ^
+        # (we are about to process arg(i)).
+        #
+        # Then rargs is [arg(i), ..., arg(N-1)] and largs is a *subset* of
+        # [arg0, ..., arg(i-1)] (any options and their arguments will have
+        # been removed from largs).
+        #
+        # The while loop will usually consume 1 or more arguments per pass.
+        # If it consumes 1 (eg. arg is an option that takes no arguments),
+        # then after _process_arg() is done the situation is:
+        #
+        #   largs = subset of [arg0, ..., arg(i)]
+        #   rargs = [arg(i+1), ..., arg(N-1)]
+        #
+        # If allow_interspersed_args is false, largs will always be
+        # *empty* -- still a subset of [arg0, ..., arg(i-1)], but
+        # not a very interesting subset!
+
+    def _match_long_opt(
+        self, opt: str, explicit_value: t.Optional[str], state: ParsingState
+    ) -> None:
+        if opt not in self._long_opt:
+            from difflib import get_close_matches
+
+            possibilities = get_close_matches(opt, self._long_opt)
+            raise NoSuchOption(opt, possibilities=possibilities, ctx=self.ctx)
+
+        option = self._long_opt[opt]
+        if option.takes_value:
+            # At this point it's safe to modify rargs by injecting the
+            # explicit value, because no exception is raised in this
+            # branch.  This means that the inserted value will be fully
+            # consumed.
+            if explicit_value is not None:
+                state.rargs.insert(0, explicit_value)
+
+            value = self._get_value_from_state(opt, option, state)
+
+        elif explicit_value is not None:
+            raise BadOptionUsage(
+                opt, _("Option {name!r} does not take a value.").format(name=opt)
+            )
+
+        else:
+            value = None
+
+        option.process(value, state)
+
+    def _match_short_opt(self, arg: str, state: ParsingState) -> None:
+        stop = False
+        i = 1
+        prefix = arg[0]
+        unknown_options = []
+
+        for ch in arg[1:]:
+            opt = normalize_opt(f"{prefix}{ch}", self.ctx)
+            option = self._short_opt.get(opt)
+            i += 1
+
+            if not option:
+                if self.ignore_unknown_options:
+                    unknown_options.append(ch)
+                    continue
+                raise NoSuchOption(opt, ctx=self.ctx)
+            if option.takes_value:
+                # Any characters left in arg?  Pretend they're the
+                # next arg, and stop consuming characters of arg.
+                if i < len(arg):
+                    state.rargs.insert(0, arg[i:])
+                    stop = True
+
+                value = self._get_value_from_state(opt, option, state)
+
+            else:
+                value = None
+
+            option.process(value, state)
+
+            if stop:
+                break
+
+        # If we got any unknown options we recombine the string of the
+        # remaining options and re-attach the prefix, then report that
+        # to the state as new larg.  This way there is basic combinatorics
+        # that can be achieved while still ignoring unknown arguments.
+        if self.ignore_unknown_options and unknown_options:
+            state.largs.append(f"{prefix}{''.join(unknown_options)}")
+
+    def _get_value_from_state(
+        self, option_name: str, option: Option, state: ParsingState
+    ) -> t.Any:
+        nargs = option.nargs
+
+        if len(state.rargs) < nargs:
+            if option.obj._flag_needs_value:
+                # Option allows omitting the value.
+                value = _flag_needs_value
+            else:
+                raise BadOptionUsage(
+                    option_name,
+                    ngettext(
+                        "Option {name!r} requires an argument.",
+                        "Option {name!r} requires {nargs} arguments.",
+                        nargs,
+                    ).format(name=option_name, nargs=nargs),
+                )
+        elif nargs == 1:
+            next_rarg = state.rargs[0]
+
+            if (
+                option.obj._flag_needs_value
+                and isinstance(next_rarg, str)
+                and next_rarg[:1] in self._opt_prefixes
+                and len(next_rarg) > 1
+            ):
+                # The next arg looks like the start of an option, don't
+                # use it as the value if omitting the value is allowed.
+                value = _flag_needs_value
+            else:
+                value = state.rargs.pop(0)
+        else:
+            value = tuple(state.rargs[:nargs])
+            del state.rargs[:nargs]
+
+        return value
+
+    def _process_opts(self, arg: str, state: ParsingState) -> None:
+        explicit_value = None
+        # Long option handling happens in two parts.  The first part is
+        # supporting explicitly attached values.  In any case, we will try
+        # to long match the option first.
+        if "=" in arg:
+            long_opt, explicit_value = arg.split("=", 1)
+        else:
+            long_opt = arg
+        norm_long_opt = normalize_opt(long_opt, self.ctx)
+
+        # At this point we will match the (assumed) long option through
+        # the long option matching code.  Note that this allows options
+        # like "-foo" to be matched as long options.
+        try:
+            self._match_long_opt(norm_long_opt, explicit_value, state)
+        except NoSuchOption:
+            # At this point the long option matching failed, and we need
+            # to try with short options.  However there is a special rule
+            # which says, that if we have a two character options prefix
+            # (applies to "--foo" for instance), we do not dispatch to the
+            # short option code and will instead raise the no option
+            # error.
+            if arg[:2] not in self._opt_prefixes:
+                self._match_short_opt(arg, state)
+                return
+
+            if not self.ignore_unknown_options:
+                raise
+
+            state.largs.append(arg)
diff --git a/llm/Lib/site-packages/click/py.typed b/llm/Lib/site-packages/click/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/click/shell_completion.py b/llm/Lib/site-packages/click/shell_completion.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc9e00b9b0c6f4903b674f03343e887bd490b081
--- /dev/null
+++ b/llm/Lib/site-packages/click/shell_completion.py
@@ -0,0 +1,596 @@
+import os
+import re
+import typing as t
+from gettext import gettext as _
+
+from .core import Argument
+from .core import BaseCommand
+from .core import Context
+from .core import MultiCommand
+from .core import Option
+from .core import Parameter
+from .core import ParameterSource
+from .parser import split_arg_string
+from .utils import echo
+
+
+def shell_complete(
+    cli: BaseCommand,
+    ctx_args: t.MutableMapping[str, t.Any],
+    prog_name: str,
+    complete_var: str,
+    instruction: str,
+) -> int:
+    """Perform shell completion for the given CLI program.
+
+    :param cli: Command being called.
+    :param ctx_args: Extra arguments to pass to
+        ``cli.make_context``.
+    :param prog_name: Name of the executable in the shell.
+    :param complete_var: Name of the environment variable that holds
+        the completion instruction.
+    :param instruction: Value of ``complete_var`` with the completion
+        instruction and shell, in the form ``instruction_shell``.
+    :return: Status code to exit with.
+    """
+    shell, _, instruction = instruction.partition("_")
+    comp_cls = get_completion_class(shell)
+
+    if comp_cls is None:
+        return 1
+
+    comp = comp_cls(cli, ctx_args, prog_name, complete_var)
+
+    if instruction == "source":
+        echo(comp.source())
+        return 0
+
+    if instruction == "complete":
+        echo(comp.complete())
+        return 0
+
+    return 1
+
+
+class CompletionItem:
+    """Represents a completion value and metadata about the value. The
+    default metadata is ``type`` to indicate special shell handling,
+    and ``help`` if a shell supports showing a help string next to the
+    value.
+
+    Arbitrary parameters can be passed when creating the object, and
+    accessed using ``item.attr``. If an attribute wasn't passed,
+    accessing it returns ``None``.
+
+    :param value: The completion suggestion.
+    :param type: Tells the shell script to provide special completion
+        support for the type. Click uses ``"dir"`` and ``"file"``.
+    :param help: String shown next to the value if supported.
+    :param kwargs: Arbitrary metadata. The built-in implementations
+        don't use this, but custom type completions paired with custom
+        shell support could use it.
+    """
+
+    __slots__ = ("value", "type", "help", "_info")
+
+    def __init__(
+        self,
+        value: t.Any,
+        type: str = "plain",
+        help: t.Optional[str] = None,
+        **kwargs: t.Any,
+    ) -> None:
+        self.value: t.Any = value
+        self.type: str = type
+        self.help: t.Optional[str] = help
+        self._info = kwargs
+
+    def __getattr__(self, name: str) -> t.Any:
+        return self._info.get(name)
+
+
+# Only Bash >= 4.4 has the nosort option.
+_SOURCE_BASH = """\
+%(complete_func)s() {
+    local IFS=$'\\n'
+    local response
+
+    response=$(env COMP_WORDS="${COMP_WORDS[*]}" COMP_CWORD=$COMP_CWORD \
+%(complete_var)s=bash_complete $1)
+
+    for completion in $response; do
+        IFS=',' read type value <<< "$completion"
+
+        if [[ $type == 'dir' ]]; then
+            COMPREPLY=()
+            compopt -o dirnames
+        elif [[ $type == 'file' ]]; then
+            COMPREPLY=()
+            compopt -o default
+        elif [[ $type == 'plain' ]]; then
+            COMPREPLY+=($value)
+        fi
+    done
+
+    return 0
+}
+
+%(complete_func)s_setup() {
+    complete -o nosort -F %(complete_func)s %(prog_name)s
+}
+
+%(complete_func)s_setup;
+"""
+
+_SOURCE_ZSH = """\
+#compdef %(prog_name)s
+
+%(complete_func)s() {
+    local -a completions
+    local -a completions_with_descriptions
+    local -a response
+    (( ! $+commands[%(prog_name)s] )) && return 1
+
+    response=("${(@f)$(env COMP_WORDS="${words[*]}" COMP_CWORD=$((CURRENT-1)) \
+%(complete_var)s=zsh_complete %(prog_name)s)}")
+
+    for type key descr in ${response}; do
+        if [[ "$type" == "plain" ]]; then
+            if [[ "$descr" == "_" ]]; then
+                completions+=("$key")
+            else
+                completions_with_descriptions+=("$key":"$descr")
+            fi
+        elif [[ "$type" == "dir" ]]; then
+            _path_files -/
+        elif [[ "$type" == "file" ]]; then
+            _path_files -f
+        fi
+    done
+
+    if [ -n "$completions_with_descriptions" ]; then
+        _describe -V unsorted completions_with_descriptions -U
+    fi
+
+    if [ -n "$completions" ]; then
+        compadd -U -V unsorted -a completions
+    fi
+}
+
+if [[ $zsh_eval_context[-1] == loadautofunc ]]; then
+    # autoload from fpath, call function directly
+    %(complete_func)s "$@"
+else
+    # eval/source/. command, register function for later
+    compdef %(complete_func)s %(prog_name)s
+fi
+"""
+
+_SOURCE_FISH = """\
+function %(complete_func)s;
+    set -l response (env %(complete_var)s=fish_complete COMP_WORDS=(commandline -cp) \
+COMP_CWORD=(commandline -t) %(prog_name)s);
+
+    for completion in $response;
+        set -l metadata (string split "," $completion);
+
+        if test $metadata[1] = "dir";
+            __fish_complete_directories $metadata[2];
+        else if test $metadata[1] = "file";
+            __fish_complete_path $metadata[2];
+        else if test $metadata[1] = "plain";
+            echo $metadata[2];
+        end;
+    end;
+end;
+
+complete --no-files --command %(prog_name)s --arguments \
+"(%(complete_func)s)";
+"""
+
+
+class ShellComplete:
+    """Base class for providing shell completion support. A subclass for
+    a given shell will override attributes and methods to implement the
+    completion instructions (``source`` and ``complete``).
+
+    :param cli: Command being called.
+    :param prog_name: Name of the executable in the shell.
+    :param complete_var: Name of the environment variable that holds
+        the completion instruction.
+
+    .. versionadded:: 8.0
+    """
+
+    name: t.ClassVar[str]
+    """Name to register the shell as with :func:`add_completion_class`.
+    This is used in completion instructions (``{name}_source`` and
+    ``{name}_complete``).
+    """
+
+    source_template: t.ClassVar[str]
+    """Completion script template formatted by :meth:`source`. This must
+    be provided by subclasses.
+    """
+
+    def __init__(
+        self,
+        cli: BaseCommand,
+        ctx_args: t.MutableMapping[str, t.Any],
+        prog_name: str,
+        complete_var: str,
+    ) -> None:
+        self.cli = cli
+        self.ctx_args = ctx_args
+        self.prog_name = prog_name
+        self.complete_var = complete_var
+
+    @property
+    def func_name(self) -> str:
+        """The name of the shell function defined by the completion
+        script.
+        """
+        safe_name = re.sub(r"\W*", "", self.prog_name.replace("-", "_"), flags=re.ASCII)
+        return f"_{safe_name}_completion"
+
+    def source_vars(self) -> t.Dict[str, t.Any]:
+        """Vars for formatting :attr:`source_template`.
+
+        By default this provides ``complete_func``, ``complete_var``,
+        and ``prog_name``.
+        """
+        return {
+            "complete_func": self.func_name,
+            "complete_var": self.complete_var,
+            "prog_name": self.prog_name,
+        }
+
+    def source(self) -> str:
+        """Produce the shell script that defines the completion
+        function. By default this ``%``-style formats
+        :attr:`source_template` with the dict returned by
+        :meth:`source_vars`.
+        """
+        return self.source_template % self.source_vars()
+
+    def get_completion_args(self) -> t.Tuple[t.List[str], str]:
+        """Use the env vars defined by the shell script to return a
+        tuple of ``args, incomplete``. This must be implemented by
+        subclasses.
+        """
+        raise NotImplementedError
+
+    def get_completions(
+        self, args: t.List[str], incomplete: str
+    ) -> t.List[CompletionItem]:
+        """Determine the context and last complete command or parameter
+        from the complete args. Call that object's ``shell_complete``
+        method to get the completions for the incomplete value.
+
+        :param args: List of complete args before the incomplete value.
+        :param incomplete: Value being completed. May be empty.
+        """
+        ctx = _resolve_context(self.cli, self.ctx_args, self.prog_name, args)
+        obj, incomplete = _resolve_incomplete(ctx, args, incomplete)
+        return obj.shell_complete(ctx, incomplete)
+
+    def format_completion(self, item: CompletionItem) -> str:
+        """Format a completion item into the form recognized by the
+        shell script. This must be implemented by subclasses.
+
+        :param item: Completion item to format.
+        """
+        raise NotImplementedError
+
+    def complete(self) -> str:
+        """Produce the completion data to send back to the shell.
+
+        By default this calls :meth:`get_completion_args`, gets the
+        completions, then calls :meth:`format_completion` for each
+        completion.
+        """
+        args, incomplete = self.get_completion_args()
+        completions = self.get_completions(args, incomplete)
+        out = [self.format_completion(item) for item in completions]
+        return "\n".join(out)
+
+
+class BashComplete(ShellComplete):
+    """Shell completion for Bash."""
+
+    name = "bash"
+    source_template = _SOURCE_BASH
+
+    @staticmethod
+    def _check_version() -> None:
+        import subprocess
+
+        output = subprocess.run(
+            ["bash", "-c", 'echo "${BASH_VERSION}"'], stdout=subprocess.PIPE
+        )
+        match = re.search(r"^(\d+)\.(\d+)\.\d+", output.stdout.decode())
+
+        if match is not None:
+            major, minor = match.groups()
+
+            if major < "4" or major == "4" and minor < "4":
+                echo(
+                    _(
+                        "Shell completion is not supported for Bash"
+                        " versions older than 4.4."
+                    ),
+                    err=True,
+                )
+        else:
+            echo(
+                _("Couldn't detect Bash version, shell completion is not supported."),
+                err=True,
+            )
+
+    def source(self) -> str:
+        self._check_version()
+        return super().source()
+
+    def get_completion_args(self) -> t.Tuple[t.List[str], str]:
+        cwords = split_arg_string(os.environ["COMP_WORDS"])
+        cword = int(os.environ["COMP_CWORD"])
+        args = cwords[1:cword]
+
+        try:
+            incomplete = cwords[cword]
+        except IndexError:
+            incomplete = ""
+
+        return args, incomplete
+
+    def format_completion(self, item: CompletionItem) -> str:
+        return f"{item.type},{item.value}"
+
+
+class ZshComplete(ShellComplete):
+    """Shell completion for Zsh."""
+
+    name = "zsh"
+    source_template = _SOURCE_ZSH
+
+    def get_completion_args(self) -> t.Tuple[t.List[str], str]:
+        cwords = split_arg_string(os.environ["COMP_WORDS"])
+        cword = int(os.environ["COMP_CWORD"])
+        args = cwords[1:cword]
+
+        try:
+            incomplete = cwords[cword]
+        except IndexError:
+            incomplete = ""
+
+        return args, incomplete
+
+    def format_completion(self, item: CompletionItem) -> str:
+        return f"{item.type}\n{item.value}\n{item.help if item.help else '_'}"
+
+
+class FishComplete(ShellComplete):
+    """Shell completion for Fish."""
+
+    name = "fish"
+    source_template = _SOURCE_FISH
+
+    def get_completion_args(self) -> t.Tuple[t.List[str], str]:
+        cwords = split_arg_string(os.environ["COMP_WORDS"])
+        incomplete = os.environ["COMP_CWORD"]
+        args = cwords[1:]
+
+        # Fish stores the partial word in both COMP_WORDS and
+        # COMP_CWORD, remove it from complete args.
+        if incomplete and args and args[-1] == incomplete:
+            args.pop()
+
+        return args, incomplete
+
+    def format_completion(self, item: CompletionItem) -> str:
+        if item.help:
+            return f"{item.type},{item.value}\t{item.help}"
+
+        return f"{item.type},{item.value}"
+
+
+ShellCompleteType = t.TypeVar("ShellCompleteType", bound=t.Type[ShellComplete])
+
+
+_available_shells: t.Dict[str, t.Type[ShellComplete]] = {
+    "bash": BashComplete,
+    "fish": FishComplete,
+    "zsh": ZshComplete,
+}
+
+
+def add_completion_class(
+    cls: ShellCompleteType, name: t.Optional[str] = None
+) -> ShellCompleteType:
+    """Register a :class:`ShellComplete` subclass under the given name.
+    The name will be provided by the completion instruction environment
+    variable during completion.
+
+    :param cls: The completion class that will handle completion for the
+        shell.
+    :param name: Name to register the class under. Defaults to the
+        class's ``name`` attribute.
+    """
+    if name is None:
+        name = cls.name
+
+    _available_shells[name] = cls
+
+    return cls
+
+
+def get_completion_class(shell: str) -> t.Optional[t.Type[ShellComplete]]:
+    """Look up a registered :class:`ShellComplete` subclass by the name
+    provided by the completion instruction environment variable. If the
+    name isn't registered, returns ``None``.
+
+    :param shell: Name the class is registered under.
+    """
+    return _available_shells.get(shell)
+
+
+def _is_incomplete_argument(ctx: Context, param: Parameter) -> bool:
+    """Determine if the given parameter is an argument that can still
+    accept values.
+
+    :param ctx: Invocation context for the command represented by the
+        parsed complete args.
+    :param param: Argument object being checked.
+    """
+    if not isinstance(param, Argument):
+        return False
+
+    assert param.name is not None
+    # Will be None if expose_value is False.
+    value = ctx.params.get(param.name)
+    return (
+        param.nargs == -1
+        or ctx.get_parameter_source(param.name) is not ParameterSource.COMMANDLINE
+        or (
+            param.nargs > 1
+            and isinstance(value, (tuple, list))
+            and len(value) < param.nargs
+        )
+    )
+
+
+def _start_of_option(ctx: Context, value: str) -> bool:
+    """Check if the value looks like the start of an option."""
+    if not value:
+        return False
+
+    c = value[0]
+    return c in ctx._opt_prefixes
+
+
+def _is_incomplete_option(ctx: Context, args: t.List[str], param: Parameter) -> bool:
+    """Determine if the given parameter is an option that needs a value.
+
+    :param args: List of complete args before the incomplete value.
+    :param param: Option object being checked.
+    """
+    if not isinstance(param, Option):
+        return False
+
+    if param.is_flag or param.count:
+        return False
+
+    last_option = None
+
+    for index, arg in enumerate(reversed(args)):
+        if index + 1 > param.nargs:
+            break
+
+        if _start_of_option(ctx, arg):
+            last_option = arg
+
+    return last_option is not None and last_option in param.opts
+
+
+def _resolve_context(
+    cli: BaseCommand,
+    ctx_args: t.MutableMapping[str, t.Any],
+    prog_name: str,
+    args: t.List[str],
+) -> Context:
+    """Produce the context hierarchy starting with the command and
+    traversing the complete arguments. This only follows the commands,
+    it doesn't trigger input prompts or callbacks.
+
+    :param cli: Command being called.
+    :param prog_name: Name of the executable in the shell.
+    :param args: List of complete args before the incomplete value.
+    """
+    ctx_args["resilient_parsing"] = True
+    ctx = cli.make_context(prog_name, args.copy(), **ctx_args)
+    args = ctx.protected_args + ctx.args
+
+    while args:
+        command = ctx.command
+
+        if isinstance(command, MultiCommand):
+            if not command.chain:
+                name, cmd, args = command.resolve_command(ctx, args)
+
+                if cmd is None:
+                    return ctx
+
+                ctx = cmd.make_context(name, args, parent=ctx, resilient_parsing=True)
+                args = ctx.protected_args + ctx.args
+            else:
+                sub_ctx = ctx
+
+                while args:
+                    name, cmd, args = command.resolve_command(ctx, args)
+
+                    if cmd is None:
+                        return ctx
+
+                    sub_ctx = cmd.make_context(
+                        name,
+                        args,
+                        parent=ctx,
+                        allow_extra_args=True,
+                        allow_interspersed_args=False,
+                        resilient_parsing=True,
+                    )
+                    args = sub_ctx.args
+
+                ctx = sub_ctx
+                args = [*sub_ctx.protected_args, *sub_ctx.args]
+        else:
+            break
+
+    return ctx
+
+
+def _resolve_incomplete(
+    ctx: Context, args: t.List[str], incomplete: str
+) -> t.Tuple[t.Union[BaseCommand, Parameter], str]:
+    """Find the Click object that will handle the completion of the
+    incomplete value. Return the object and the incomplete value.
+
+    :param ctx: Invocation context for the command represented by
+        the parsed complete args.
+    :param args: List of complete args before the incomplete value.
+    :param incomplete: Value being completed. May be empty.
+    """
+    # Different shells treat an "=" between a long option name and
+    # value differently. Might keep the value joined, return the "="
+    # as a separate item, or return the split name and value. Always
+    # split and discard the "=" to make completion easier.
+    if incomplete == "=":
+        incomplete = ""
+    elif "=" in incomplete and _start_of_option(ctx, incomplete):
+        name, _, incomplete = incomplete.partition("=")
+        args.append(name)
+
+    # The "--" marker tells Click to stop treating values as options
+    # even if they start with the option character. If it hasn't been
+    # given and the incomplete arg looks like an option, the current
+    # command will provide option name completions.
+    if "--" not in args and _start_of_option(ctx, incomplete):
+        return ctx.command, incomplete
+
+    params = ctx.command.get_params(ctx)
+
+    # If the last complete arg is an option name with an incomplete
+    # value, the option will provide value completions.
+    for param in params:
+        if _is_incomplete_option(ctx, args, param):
+            return param, incomplete
+
+    # It's not an option name or value. The first argument without a
+    # parsed value will provide value completions.
+    for param in params:
+        if _is_incomplete_argument(ctx, param):
+            return param, incomplete
+
+    # There were no unparsed arguments, the command may be a group that
+    # will provide command name completions.
+    return ctx.command, incomplete
diff --git a/llm/Lib/site-packages/click/termui.py b/llm/Lib/site-packages/click/termui.py
new file mode 100644
index 0000000000000000000000000000000000000000..db7a4b286174fdf26f3251631a2066eda2fa5bea
--- /dev/null
+++ b/llm/Lib/site-packages/click/termui.py
@@ -0,0 +1,784 @@
+import inspect
+import io
+import itertools
+import sys
+import typing as t
+from gettext import gettext as _
+
+from ._compat import isatty
+from ._compat import strip_ansi
+from .exceptions import Abort
+from .exceptions import UsageError
+from .globals import resolve_color_default
+from .types import Choice
+from .types import convert_type
+from .types import ParamType
+from .utils import echo
+from .utils import LazyFile
+
+if t.TYPE_CHECKING:
+    from ._termui_impl import ProgressBar
+
+V = t.TypeVar("V")
+
+# The prompt functions to use.  The doc tools currently override these
+# functions to customize how they work.
+visible_prompt_func: t.Callable[[str], str] = input
+
+_ansi_colors = {
+    "black": 30,
+    "red": 31,
+    "green": 32,
+    "yellow": 33,
+    "blue": 34,
+    "magenta": 35,
+    "cyan": 36,
+    "white": 37,
+    "reset": 39,
+    "bright_black": 90,
+    "bright_red": 91,
+    "bright_green": 92,
+    "bright_yellow": 93,
+    "bright_blue": 94,
+    "bright_magenta": 95,
+    "bright_cyan": 96,
+    "bright_white": 97,
+}
+_ansi_reset_all = "\033[0m"
+
+
+def hidden_prompt_func(prompt: str) -> str:
+    import getpass
+
+    return getpass.getpass(prompt)
+
+
+def _build_prompt(
+    text: str,
+    suffix: str,
+    show_default: bool = False,
+    default: t.Optional[t.Any] = None,
+    show_choices: bool = True,
+    type: t.Optional[ParamType] = None,
+) -> str:
+    prompt = text
+    if type is not None and show_choices and isinstance(type, Choice):
+        prompt += f" ({', '.join(map(str, type.choices))})"
+    if default is not None and show_default:
+        prompt = f"{prompt} [{_format_default(default)}]"
+    return f"{prompt}{suffix}"
+
+
+def _format_default(default: t.Any) -> t.Any:
+    if isinstance(default, (io.IOBase, LazyFile)) and hasattr(default, "name"):
+        return default.name
+
+    return default
+
+
+def prompt(
+    text: str,
+    default: t.Optional[t.Any] = None,
+    hide_input: bool = False,
+    confirmation_prompt: t.Union[bool, str] = False,
+    type: t.Optional[t.Union[ParamType, t.Any]] = None,
+    value_proc: t.Optional[t.Callable[[str], t.Any]] = None,
+    prompt_suffix: str = ": ",
+    show_default: bool = True,
+    err: bool = False,
+    show_choices: bool = True,
+) -> t.Any:
+    """Prompts a user for input.  This is a convenience function that can
+    be used to prompt a user for input later.
+
+    If the user aborts the input by sending an interrupt signal, this
+    function will catch it and raise a :exc:`Abort` exception.
+
+    :param text: the text to show for the prompt.
+    :param default: the default value to use if no input happens.  If this
+                    is not given it will prompt until it's aborted.
+    :param hide_input: if this is set to true then the input value will
+                       be hidden.
+    :param confirmation_prompt: Prompt a second time to confirm the
+        value. Can be set to a string instead of ``True`` to customize
+        the message.
+    :param type: the type to use to check the value against.
+    :param value_proc: if this parameter is provided it's a function that
+                       is invoked instead of the type conversion to
+                       convert a value.
+    :param prompt_suffix: a suffix that should be added to the prompt.
+    :param show_default: shows or hides the default value in the prompt.
+    :param err: if set to true the file defaults to ``stderr`` instead of
+                ``stdout``, the same as with echo.
+    :param show_choices: Show or hide choices if the passed type is a Choice.
+                         For example if type is a Choice of either day or week,
+                         show_choices is true and text is "Group by" then the
+                         prompt will be "Group by (day, week): ".
+
+    .. versionadded:: 8.0
+        ``confirmation_prompt`` can be a custom string.
+
+    .. versionadded:: 7.0
+        Added the ``show_choices`` parameter.
+
+    .. versionadded:: 6.0
+        Added unicode support for cmd.exe on Windows.
+
+    .. versionadded:: 4.0
+        Added the `err` parameter.
+
+    """
+
+    def prompt_func(text: str) -> str:
+        f = hidden_prompt_func if hide_input else visible_prompt_func
+        try:
+            # Write the prompt separately so that we get nice
+            # coloring through colorama on Windows
+            echo(text.rstrip(" "), nl=False, err=err)
+            # Echo a space to stdout to work around an issue where
+            # readline causes backspace to clear the whole line.
+            return f(" ")
+        except (KeyboardInterrupt, EOFError):
+            # getpass doesn't print a newline if the user aborts input with ^C.
+            # Allegedly this behavior is inherited from getpass(3).
+            # A doc bug has been filed at https://bugs.python.org/issue24711
+            if hide_input:
+                echo(None, err=err)
+            raise Abort() from None
+
+    if value_proc is None:
+        value_proc = convert_type(type, default)
+
+    prompt = _build_prompt(
+        text, prompt_suffix, show_default, default, show_choices, type
+    )
+
+    if confirmation_prompt:
+        if confirmation_prompt is True:
+            confirmation_prompt = _("Repeat for confirmation")
+
+        confirmation_prompt = _build_prompt(confirmation_prompt, prompt_suffix)
+
+    while True:
+        while True:
+            value = prompt_func(prompt)
+            if value:
+                break
+            elif default is not None:
+                value = default
+                break
+        try:
+            result = value_proc(value)
+        except UsageError as e:
+            if hide_input:
+                echo(_("Error: The value you entered was invalid."), err=err)
+            else:
+                echo(_("Error: {e.message}").format(e=e), err=err)  # noqa: B306
+            continue
+        if not confirmation_prompt:
+            return result
+        while True:
+            value2 = prompt_func(confirmation_prompt)
+            is_empty = not value and not value2
+            if value2 or is_empty:
+                break
+        if value == value2:
+            return result
+        echo(_("Error: The two entered values do not match."), err=err)
+
+
+def confirm(
+    text: str,
+    default: t.Optional[bool] = False,
+    abort: bool = False,
+    prompt_suffix: str = ": ",
+    show_default: bool = True,
+    err: bool = False,
+) -> bool:
+    """Prompts for confirmation (yes/no question).
+
+    If the user aborts the input by sending a interrupt signal this
+    function will catch it and raise a :exc:`Abort` exception.
+
+    :param text: the question to ask.
+    :param default: The default value to use when no input is given. If
+        ``None``, repeat until input is given.
+    :param abort: if this is set to `True` a negative answer aborts the
+                  exception by raising :exc:`Abort`.
+    :param prompt_suffix: a suffix that should be added to the prompt.
+    :param show_default: shows or hides the default value in the prompt.
+    :param err: if set to true the file defaults to ``stderr`` instead of
+                ``stdout``, the same as with echo.
+
+    .. versionchanged:: 8.0
+        Repeat until input is given if ``default`` is ``None``.
+
+    .. versionadded:: 4.0
+        Added the ``err`` parameter.
+    """
+    prompt = _build_prompt(
+        text,
+        prompt_suffix,
+        show_default,
+        "y/n" if default is None else ("Y/n" if default else "y/N"),
+    )
+
+    while True:
+        try:
+            # Write the prompt separately so that we get nice
+            # coloring through colorama on Windows
+            echo(prompt.rstrip(" "), nl=False, err=err)
+            # Echo a space to stdout to work around an issue where
+            # readline causes backspace to clear the whole line.
+            value = visible_prompt_func(" ").lower().strip()
+        except (KeyboardInterrupt, EOFError):
+            raise Abort() from None
+        if value in ("y", "yes"):
+            rv = True
+        elif value in ("n", "no"):
+            rv = False
+        elif default is not None and value == "":
+            rv = default
+        else:
+            echo(_("Error: invalid input"), err=err)
+            continue
+        break
+    if abort and not rv:
+        raise Abort()
+    return rv
+
+
+def echo_via_pager(
+    text_or_generator: t.Union[t.Iterable[str], t.Callable[[], t.Iterable[str]], str],
+    color: t.Optional[bool] = None,
+) -> None:
+    """This function takes a text and shows it via an environment specific
+    pager on stdout.
+
+    .. versionchanged:: 3.0
+       Added the `color` flag.
+
+    :param text_or_generator: the text to page, or alternatively, a
+                              generator emitting the text to page.
+    :param color: controls if the pager supports ANSI colors or not.  The
+                  default is autodetection.
+    """
+    color = resolve_color_default(color)
+
+    if inspect.isgeneratorfunction(text_or_generator):
+        i = t.cast(t.Callable[[], t.Iterable[str]], text_or_generator)()
+    elif isinstance(text_or_generator, str):
+        i = [text_or_generator]
+    else:
+        i = iter(t.cast(t.Iterable[str], text_or_generator))
+
+    # convert every element of i to a text type if necessary
+    text_generator = (el if isinstance(el, str) else str(el) for el in i)
+
+    from ._termui_impl import pager
+
+    return pager(itertools.chain(text_generator, "\n"), color)
+
+
+def progressbar(
+    iterable: t.Optional[t.Iterable[V]] = None,
+    length: t.Optional[int] = None,
+    label: t.Optional[str] = None,
+    show_eta: bool = True,
+    show_percent: t.Optional[bool] = None,
+    show_pos: bool = False,
+    item_show_func: t.Optional[t.Callable[[t.Optional[V]], t.Optional[str]]] = None,
+    fill_char: str = "#",
+    empty_char: str = "-",
+    bar_template: str = "%(label)s  [%(bar)s]  %(info)s",
+    info_sep: str = "  ",
+    width: int = 36,
+    file: t.Optional[t.TextIO] = None,
+    color: t.Optional[bool] = None,
+    update_min_steps: int = 1,
+) -> "ProgressBar[V]":
+    """This function creates an iterable context manager that can be used
+    to iterate over something while showing a progress bar.  It will
+    either iterate over the `iterable` or `length` items (that are counted
+    up).  While iteration happens, this function will print a rendered
+    progress bar to the given `file` (defaults to stdout) and will attempt
+    to calculate remaining time and more.  By default, this progress bar
+    will not be rendered if the file is not a terminal.
+
+    The context manager creates the progress bar.  When the context
+    manager is entered the progress bar is already created.  With every
+    iteration over the progress bar, the iterable passed to the bar is
+    advanced and the bar is updated.  When the context manager exits,
+    a newline is printed and the progress bar is finalized on screen.
+
+    Note: The progress bar is currently designed for use cases where the
+    total progress can be expected to take at least several seconds.
+    Because of this, the ProgressBar class object won't display
+    progress that is considered too fast, and progress where the time
+    between steps is less than a second.
+
+    No printing must happen or the progress bar will be unintentionally
+    destroyed.
+
+    Example usage::
+
+        with progressbar(items) as bar:
+            for item in bar:
+                do_something_with(item)
+
+    Alternatively, if no iterable is specified, one can manually update the
+    progress bar through the `update()` method instead of directly
+    iterating over the progress bar.  The update method accepts the number
+    of steps to increment the bar with::
+
+        with progressbar(length=chunks.total_bytes) as bar:
+            for chunk in chunks:
+                process_chunk(chunk)
+                bar.update(chunks.bytes)
+
+    The ``update()`` method also takes an optional value specifying the
+    ``current_item`` at the new position. This is useful when used
+    together with ``item_show_func`` to customize the output for each
+    manual step::
+
+        with click.progressbar(
+            length=total_size,
+            label='Unzipping archive',
+            item_show_func=lambda a: a.filename
+        ) as bar:
+            for archive in zip_file:
+                archive.extract()
+                bar.update(archive.size, archive)
+
+    :param iterable: an iterable to iterate over.  If not provided the length
+                     is required.
+    :param length: the number of items to iterate over.  By default the
+                   progressbar will attempt to ask the iterator about its
+                   length, which might or might not work.  If an iterable is
+                   also provided this parameter can be used to override the
+                   length.  If an iterable is not provided the progress bar
+                   will iterate over a range of that length.
+    :param label: the label to show next to the progress bar.
+    :param show_eta: enables or disables the estimated time display.  This is
+                     automatically disabled if the length cannot be
+                     determined.
+    :param show_percent: enables or disables the percentage display.  The
+                         default is `True` if the iterable has a length or
+                         `False` if not.
+    :param show_pos: enables or disables the absolute position display.  The
+                     default is `False`.
+    :param item_show_func: A function called with the current item which
+        can return a string to show next to the progress bar. If the
+        function returns ``None`` nothing is shown. The current item can
+        be ``None``, such as when entering and exiting the bar.
+    :param fill_char: the character to use to show the filled part of the
+                      progress bar.
+    :param empty_char: the character to use to show the non-filled part of
+                       the progress bar.
+    :param bar_template: the format string to use as template for the bar.
+                         The parameters in it are ``label`` for the label,
+                         ``bar`` for the progress bar and ``info`` for the
+                         info section.
+    :param info_sep: the separator between multiple info items (eta etc.)
+    :param width: the width of the progress bar in characters, 0 means full
+                  terminal width
+    :param file: The file to write to. If this is not a terminal then
+        only the label is printed.
+    :param color: controls if the terminal supports ANSI colors or not.  The
+                  default is autodetection.  This is only needed if ANSI
+                  codes are included anywhere in the progress bar output
+                  which is not the case by default.
+    :param update_min_steps: Render only when this many updates have
+        completed. This allows tuning for very fast iterators.
+
+    .. versionchanged:: 8.0
+        Output is shown even if execution time is less than 0.5 seconds.
+
+    .. versionchanged:: 8.0
+        ``item_show_func`` shows the current item, not the previous one.
+
+    .. versionchanged:: 8.0
+        Labels are echoed if the output is not a TTY. Reverts a change
+        in 7.0 that removed all output.
+
+    .. versionadded:: 8.0
+       Added the ``update_min_steps`` parameter.
+
+    .. versionchanged:: 4.0
+        Added the ``color`` parameter. Added the ``update`` method to
+        the object.
+
+    .. versionadded:: 2.0
+    """
+    from ._termui_impl import ProgressBar
+
+    color = resolve_color_default(color)
+    return ProgressBar(
+        iterable=iterable,
+        length=length,
+        show_eta=show_eta,
+        show_percent=show_percent,
+        show_pos=show_pos,
+        item_show_func=item_show_func,
+        fill_char=fill_char,
+        empty_char=empty_char,
+        bar_template=bar_template,
+        info_sep=info_sep,
+        file=file,
+        label=label,
+        width=width,
+        color=color,
+        update_min_steps=update_min_steps,
+    )
+
+
+def clear() -> None:
+    """Clears the terminal screen.  This will have the effect of clearing
+    the whole visible space of the terminal and moving the cursor to the
+    top left.  This does not do anything if not connected to a terminal.
+
+    .. versionadded:: 2.0
+    """
+    if not isatty(sys.stdout):
+        return
+
+    # ANSI escape \033[2J clears the screen, \033[1;1H moves the cursor
+    echo("\033[2J\033[1;1H", nl=False)
+
+
+def _interpret_color(
+    color: t.Union[int, t.Tuple[int, int, int], str], offset: int = 0
+) -> str:
+    if isinstance(color, int):
+        return f"{38 + offset};5;{color:d}"
+
+    if isinstance(color, (tuple, list)):
+        r, g, b = color
+        return f"{38 + offset};2;{r:d};{g:d};{b:d}"
+
+    return str(_ansi_colors[color] + offset)
+
+
+def style(
+    text: t.Any,
+    fg: t.Optional[t.Union[int, t.Tuple[int, int, int], str]] = None,
+    bg: t.Optional[t.Union[int, t.Tuple[int, int, int], str]] = None,
+    bold: t.Optional[bool] = None,
+    dim: t.Optional[bool] = None,
+    underline: t.Optional[bool] = None,
+    overline: t.Optional[bool] = None,
+    italic: t.Optional[bool] = None,
+    blink: t.Optional[bool] = None,
+    reverse: t.Optional[bool] = None,
+    strikethrough: t.Optional[bool] = None,
+    reset: bool = True,
+) -> str:
+    """Styles a text with ANSI styles and returns the new string.  By
+    default the styling is self contained which means that at the end
+    of the string a reset code is issued.  This can be prevented by
+    passing ``reset=False``.
+
+    Examples::
+
+        click.echo(click.style('Hello World!', fg='green'))
+        click.echo(click.style('ATTENTION!', blink=True))
+        click.echo(click.style('Some things', reverse=True, fg='cyan'))
+        click.echo(click.style('More colors', fg=(255, 12, 128), bg=117))
+
+    Supported color names:
+
+    * ``black`` (might be a gray)
+    * ``red``
+    * ``green``
+    * ``yellow`` (might be an orange)
+    * ``blue``
+    * ``magenta``
+    * ``cyan``
+    * ``white`` (might be light gray)
+    * ``bright_black``
+    * ``bright_red``
+    * ``bright_green``
+    * ``bright_yellow``
+    * ``bright_blue``
+    * ``bright_magenta``
+    * ``bright_cyan``
+    * ``bright_white``
+    * ``reset`` (reset the color code only)
+
+    If the terminal supports it, color may also be specified as:
+
+    -   An integer in the interval [0, 255]. The terminal must support
+        8-bit/256-color mode.
+    -   An RGB tuple of three integers in [0, 255]. The terminal must
+        support 24-bit/true-color mode.
+
+    See https://en.wikipedia.org/wiki/ANSI_color and
+    https://gist.github.com/XVilka/8346728 for more information.
+
+    :param text: the string to style with ansi codes.
+    :param fg: if provided this will become the foreground color.
+    :param bg: if provided this will become the background color.
+    :param bold: if provided this will enable or disable bold mode.
+    :param dim: if provided this will enable or disable dim mode.  This is
+                badly supported.
+    :param underline: if provided this will enable or disable underline.
+    :param overline: if provided this will enable or disable overline.
+    :param italic: if provided this will enable or disable italic.
+    :param blink: if provided this will enable or disable blinking.
+    :param reverse: if provided this will enable or disable inverse
+                    rendering (foreground becomes background and the
+                    other way round).
+    :param strikethrough: if provided this will enable or disable
+        striking through text.
+    :param reset: by default a reset-all code is added at the end of the
+                  string which means that styles do not carry over.  This
+                  can be disabled to compose styles.
+
+    .. versionchanged:: 8.0
+        A non-string ``message`` is converted to a string.
+
+    .. versionchanged:: 8.0
+       Added support for 256 and RGB color codes.
+
+    .. versionchanged:: 8.0
+        Added the ``strikethrough``, ``italic``, and ``overline``
+        parameters.
+
+    .. versionchanged:: 7.0
+        Added support for bright colors.
+
+    .. versionadded:: 2.0
+    """
+    if not isinstance(text, str):
+        text = str(text)
+
+    bits = []
+
+    if fg:
+        try:
+            bits.append(f"\033[{_interpret_color(fg)}m")
+        except KeyError:
+            raise TypeError(f"Unknown color {fg!r}") from None
+
+    if bg:
+        try:
+            bits.append(f"\033[{_interpret_color(bg, 10)}m")
+        except KeyError:
+            raise TypeError(f"Unknown color {bg!r}") from None
+
+    if bold is not None:
+        bits.append(f"\033[{1 if bold else 22}m")
+    if dim is not None:
+        bits.append(f"\033[{2 if dim else 22}m")
+    if underline is not None:
+        bits.append(f"\033[{4 if underline else 24}m")
+    if overline is not None:
+        bits.append(f"\033[{53 if overline else 55}m")
+    if italic is not None:
+        bits.append(f"\033[{3 if italic else 23}m")
+    if blink is not None:
+        bits.append(f"\033[{5 if blink else 25}m")
+    if reverse is not None:
+        bits.append(f"\033[{7 if reverse else 27}m")
+    if strikethrough is not None:
+        bits.append(f"\033[{9 if strikethrough else 29}m")
+    bits.append(text)
+    if reset:
+        bits.append(_ansi_reset_all)
+    return "".join(bits)
+
+
+def unstyle(text: str) -> str:
+    """Removes ANSI styling information from a string.  Usually it's not
+    necessary to use this function as Click's echo function will
+    automatically remove styling if necessary.
+
+    .. versionadded:: 2.0
+
+    :param text: the text to remove style information from.
+    """
+    return strip_ansi(text)
+
+
+def secho(
+    message: t.Optional[t.Any] = None,
+    file: t.Optional[t.IO[t.AnyStr]] = None,
+    nl: bool = True,
+    err: bool = False,
+    color: t.Optional[bool] = None,
+    **styles: t.Any,
+) -> None:
+    """This function combines :func:`echo` and :func:`style` into one
+    call.  As such the following two calls are the same::
+
+        click.secho('Hello World!', fg='green')
+        click.echo(click.style('Hello World!', fg='green'))
+
+    All keyword arguments are forwarded to the underlying functions
+    depending on which one they go with.
+
+    Non-string types will be converted to :class:`str`. However,
+    :class:`bytes` are passed directly to :meth:`echo` without applying
+    style. If you want to style bytes that represent text, call
+    :meth:`bytes.decode` first.
+
+    .. versionchanged:: 8.0
+        A non-string ``message`` is converted to a string. Bytes are
+        passed through without style applied.
+
+    .. versionadded:: 2.0
+    """
+    if message is not None and not isinstance(message, (bytes, bytearray)):
+        message = style(message, **styles)
+
+    return echo(message, file=file, nl=nl, err=err, color=color)
+
+
+def edit(
+    text: t.Optional[t.AnyStr] = None,
+    editor: t.Optional[str] = None,
+    env: t.Optional[t.Mapping[str, str]] = None,
+    require_save: bool = True,
+    extension: str = ".txt",
+    filename: t.Optional[str] = None,
+) -> t.Optional[t.AnyStr]:
+    r"""Edits the given text in the defined editor.  If an editor is given
+    (should be the full path to the executable but the regular operating
+    system search path is used for finding the executable) it overrides
+    the detected editor.  Optionally, some environment variables can be
+    used.  If the editor is closed without changes, `None` is returned.  In
+    case a file is edited directly the return value is always `None` and
+    `require_save` and `extension` are ignored.
+
+    If the editor cannot be opened a :exc:`UsageError` is raised.
+
+    Note for Windows: to simplify cross-platform usage, the newlines are
+    automatically converted from POSIX to Windows and vice versa.  As such,
+    the message here will have ``\n`` as newline markers.
+
+    :param text: the text to edit.
+    :param editor: optionally the editor to use.  Defaults to automatic
+                   detection.
+    :param env: environment variables to forward to the editor.
+    :param require_save: if this is true, then not saving in the editor
+                         will make the return value become `None`.
+    :param extension: the extension to tell the editor about.  This defaults
+                      to `.txt` but changing this might change syntax
+                      highlighting.
+    :param filename: if provided it will edit this file instead of the
+                     provided text contents.  It will not use a temporary
+                     file as an indirection in that case.
+    """
+    from ._termui_impl import Editor
+
+    ed = Editor(editor=editor, env=env, require_save=require_save, extension=extension)
+
+    if filename is None:
+        return ed.edit(text)
+
+    ed.edit_file(filename)
+    return None
+
+
+def launch(url: str, wait: bool = False, locate: bool = False) -> int:
+    """This function launches the given URL (or filename) in the default
+    viewer application for this file type.  If this is an executable, it
+    might launch the executable in a new session.  The return value is
+    the exit code of the launched application.  Usually, ``0`` indicates
+    success.
+
+    Examples::
+
+        click.launch('https://click.palletsprojects.com/')
+        click.launch('/my/downloaded/file', locate=True)
+
+    .. versionadded:: 2.0
+
+    :param url: URL or filename of the thing to launch.
+    :param wait: Wait for the program to exit before returning. This
+        only works if the launched program blocks. In particular,
+        ``xdg-open`` on Linux does not block.
+    :param locate: if this is set to `True` then instead of launching the
+                   application associated with the URL it will attempt to
+                   launch a file manager with the file located.  This
+                   might have weird effects if the URL does not point to
+                   the filesystem.
+    """
+    from ._termui_impl import open_url
+
+    return open_url(url, wait=wait, locate=locate)
+
+
+# If this is provided, getchar() calls into this instead.  This is used
+# for unittesting purposes.
+_getchar: t.Optional[t.Callable[[bool], str]] = None
+
+
+def getchar(echo: bool = False) -> str:
+    """Fetches a single character from the terminal and returns it.  This
+    will always return a unicode character and under certain rare
+    circumstances this might return more than one character.  The
+    situations which more than one character is returned is when for
+    whatever reason multiple characters end up in the terminal buffer or
+    standard input was not actually a terminal.
+
+    Note that this will always read from the terminal, even if something
+    is piped into the standard input.
+
+    Note for Windows: in rare cases when typing non-ASCII characters, this
+    function might wait for a second character and then return both at once.
+    This is because certain Unicode characters look like special-key markers.
+
+    .. versionadded:: 2.0
+
+    :param echo: if set to `True`, the character read will also show up on
+                 the terminal.  The default is to not show it.
+    """
+    global _getchar
+
+    if _getchar is None:
+        from ._termui_impl import getchar as f
+
+        _getchar = f
+
+    return _getchar(echo)
+
+
+def raw_terminal() -> t.ContextManager[int]:
+    from ._termui_impl import raw_terminal as f
+
+    return f()
+
+
+def pause(info: t.Optional[str] = None, err: bool = False) -> None:
+    """This command stops execution and waits for the user to press any
+    key to continue.  This is similar to the Windows batch "pause"
+    command.  If the program is not run through a terminal, this command
+    will instead do nothing.
+
+    .. versionadded:: 2.0
+
+    .. versionadded:: 4.0
+       Added the `err` parameter.
+
+    :param info: The message to print before pausing. Defaults to
+        ``"Press any key to continue..."``.
+    :param err: if set to message goes to ``stderr`` instead of
+                ``stdout``, the same as with echo.
+    """
+    if not isatty(sys.stdin) or not isatty(sys.stdout):
+        return
+
+    if info is None:
+        info = _("Press any key to continue...")
+
+    try:
+        if info:
+            echo(info, nl=False, err=err)
+        try:
+            getchar()
+        except (KeyboardInterrupt, EOFError):
+            pass
+    finally:
+        if info:
+            echo(err=err)
diff --git a/llm/Lib/site-packages/click/testing.py b/llm/Lib/site-packages/click/testing.py
new file mode 100644
index 0000000000000000000000000000000000000000..e0df0d2a657fe19523957b85964b9956e5c78a30
--- /dev/null
+++ b/llm/Lib/site-packages/click/testing.py
@@ -0,0 +1,479 @@
+import contextlib
+import io
+import os
+import shlex
+import shutil
+import sys
+import tempfile
+import typing as t
+from types import TracebackType
+
+from . import formatting
+from . import termui
+from . import utils
+from ._compat import _find_binary_reader
+
+if t.TYPE_CHECKING:
+    from .core import BaseCommand
+
+
+class EchoingStdin:
+    def __init__(self, input: t.BinaryIO, output: t.BinaryIO) -> None:
+        self._input = input
+        self._output = output
+        self._paused = False
+
+    def __getattr__(self, x: str) -> t.Any:
+        return getattr(self._input, x)
+
+    def _echo(self, rv: bytes) -> bytes:
+        if not self._paused:
+            self._output.write(rv)
+
+        return rv
+
+    def read(self, n: int = -1) -> bytes:
+        return self._echo(self._input.read(n))
+
+    def read1(self, n: int = -1) -> bytes:
+        return self._echo(self._input.read1(n))  # type: ignore
+
+    def readline(self, n: int = -1) -> bytes:
+        return self._echo(self._input.readline(n))
+
+    def readlines(self) -> t.List[bytes]:
+        return [self._echo(x) for x in self._input.readlines()]
+
+    def __iter__(self) -> t.Iterator[bytes]:
+        return iter(self._echo(x) for x in self._input)
+
+    def __repr__(self) -> str:
+        return repr(self._input)
+
+
+@contextlib.contextmanager
+def _pause_echo(stream: t.Optional[EchoingStdin]) -> t.Iterator[None]:
+    if stream is None:
+        yield
+    else:
+        stream._paused = True
+        yield
+        stream._paused = False
+
+
+class _NamedTextIOWrapper(io.TextIOWrapper):
+    def __init__(
+        self, buffer: t.BinaryIO, name: str, mode: str, **kwargs: t.Any
+    ) -> None:
+        super().__init__(buffer, **kwargs)
+        self._name = name
+        self._mode = mode
+
+    @property
+    def name(self) -> str:
+        return self._name
+
+    @property
+    def mode(self) -> str:
+        return self._mode
+
+
+def make_input_stream(
+    input: t.Optional[t.Union[str, bytes, t.IO[t.Any]]], charset: str
+) -> t.BinaryIO:
+    # Is already an input stream.
+    if hasattr(input, "read"):
+        rv = _find_binary_reader(t.cast(t.IO[t.Any], input))
+
+        if rv is not None:
+            return rv
+
+        raise TypeError("Could not find binary reader for input stream.")
+
+    if input is None:
+        input = b""
+    elif isinstance(input, str):
+        input = input.encode(charset)
+
+    return io.BytesIO(input)
+
+
+class Result:
+    """Holds the captured result of an invoked CLI script."""
+
+    def __init__(
+        self,
+        runner: "CliRunner",
+        stdout_bytes: bytes,
+        stderr_bytes: t.Optional[bytes],
+        return_value: t.Any,
+        exit_code: int,
+        exception: t.Optional[BaseException],
+        exc_info: t.Optional[
+            t.Tuple[t.Type[BaseException], BaseException, TracebackType]
+        ] = None,
+    ):
+        #: The runner that created the result
+        self.runner = runner
+        #: The standard output as bytes.
+        self.stdout_bytes = stdout_bytes
+        #: The standard error as bytes, or None if not available
+        self.stderr_bytes = stderr_bytes
+        #: The value returned from the invoked command.
+        #:
+        #: .. versionadded:: 8.0
+        self.return_value = return_value
+        #: The exit code as integer.
+        self.exit_code = exit_code
+        #: The exception that happened if one did.
+        self.exception = exception
+        #: The traceback
+        self.exc_info = exc_info
+
+    @property
+    def output(self) -> str:
+        """The (standard) output as unicode string."""
+        return self.stdout
+
+    @property
+    def stdout(self) -> str:
+        """The standard output as unicode string."""
+        return self.stdout_bytes.decode(self.runner.charset, "replace").replace(
+            "\r\n", "\n"
+        )
+
+    @property
+    def stderr(self) -> str:
+        """The standard error as unicode string."""
+        if self.stderr_bytes is None:
+            raise ValueError("stderr not separately captured")
+        return self.stderr_bytes.decode(self.runner.charset, "replace").replace(
+            "\r\n", "\n"
+        )
+
+    def __repr__(self) -> str:
+        exc_str = repr(self.exception) if self.exception else "okay"
+        return f"<{type(self).__name__} {exc_str}>"
+
+
+class CliRunner:
+    """The CLI runner provides functionality to invoke a Click command line
+    script for unittesting purposes in a isolated environment.  This only
+    works in single-threaded systems without any concurrency as it changes the
+    global interpreter state.
+
+    :param charset: the character set for the input and output data.
+    :param env: a dictionary with environment variables for overriding.
+    :param echo_stdin: if this is set to `True`, then reading from stdin writes
+                       to stdout.  This is useful for showing examples in
+                       some circumstances.  Note that regular prompts
+                       will automatically echo the input.
+    :param mix_stderr: if this is set to `False`, then stdout and stderr are
+                       preserved as independent streams.  This is useful for
+                       Unix-philosophy apps that have predictable stdout and
+                       noisy stderr, such that each may be measured
+                       independently
+    """
+
+    def __init__(
+        self,
+        charset: str = "utf-8",
+        env: t.Optional[t.Mapping[str, t.Optional[str]]] = None,
+        echo_stdin: bool = False,
+        mix_stderr: bool = True,
+    ) -> None:
+        self.charset = charset
+        self.env: t.Mapping[str, t.Optional[str]] = env or {}
+        self.echo_stdin = echo_stdin
+        self.mix_stderr = mix_stderr
+
+    def get_default_prog_name(self, cli: "BaseCommand") -> str:
+        """Given a command object it will return the default program name
+        for it.  The default is the `name` attribute or ``"root"`` if not
+        set.
+        """
+        return cli.name or "root"
+
+    def make_env(
+        self, overrides: t.Optional[t.Mapping[str, t.Optional[str]]] = None
+    ) -> t.Mapping[str, t.Optional[str]]:
+        """Returns the environment overrides for invoking a script."""
+        rv = dict(self.env)
+        if overrides:
+            rv.update(overrides)
+        return rv
+
+    @contextlib.contextmanager
+    def isolation(
+        self,
+        input: t.Optional[t.Union[str, bytes, t.IO[t.Any]]] = None,
+        env: t.Optional[t.Mapping[str, t.Optional[str]]] = None,
+        color: bool = False,
+    ) -> t.Iterator[t.Tuple[io.BytesIO, t.Optional[io.BytesIO]]]:
+        """A context manager that sets up the isolation for invoking of a
+        command line tool.  This sets up stdin with the given input data
+        and `os.environ` with the overrides from the given dictionary.
+        This also rebinds some internals in Click to be mocked (like the
+        prompt functionality).
+
+        This is automatically done in the :meth:`invoke` method.
+
+        :param input: the input stream to put into sys.stdin.
+        :param env: the environment overrides as dictionary.
+        :param color: whether the output should contain color codes. The
+                      application can still override this explicitly.
+
+        .. versionchanged:: 8.0
+            ``stderr`` is opened with ``errors="backslashreplace"``
+            instead of the default ``"strict"``.
+
+        .. versionchanged:: 4.0
+            Added the ``color`` parameter.
+        """
+        bytes_input = make_input_stream(input, self.charset)
+        echo_input = None
+
+        old_stdin = sys.stdin
+        old_stdout = sys.stdout
+        old_stderr = sys.stderr
+        old_forced_width = formatting.FORCED_WIDTH
+        formatting.FORCED_WIDTH = 80
+
+        env = self.make_env(env)
+
+        bytes_output = io.BytesIO()
+
+        if self.echo_stdin:
+            bytes_input = echo_input = t.cast(
+                t.BinaryIO, EchoingStdin(bytes_input, bytes_output)
+            )
+
+        sys.stdin = text_input = _NamedTextIOWrapper(
+            bytes_input, encoding=self.charset, name="<stdin>", mode="r"
+        )
+
+        if self.echo_stdin:
+            # Force unbuffered reads, otherwise TextIOWrapper reads a
+            # large chunk which is echoed early.
+            text_input._CHUNK_SIZE = 1  # type: ignore
+
+        sys.stdout = _NamedTextIOWrapper(
+            bytes_output, encoding=self.charset, name="<stdout>", mode="w"
+        )
+
+        bytes_error = None
+        if self.mix_stderr:
+            sys.stderr = sys.stdout
+        else:
+            bytes_error = io.BytesIO()
+            sys.stderr = _NamedTextIOWrapper(
+                bytes_error,
+                encoding=self.charset,
+                name="<stderr>",
+                mode="w",
+                errors="backslashreplace",
+            )
+
+        @_pause_echo(echo_input)  # type: ignore
+        def visible_input(prompt: t.Optional[str] = None) -> str:
+            sys.stdout.write(prompt or "")
+            val = text_input.readline().rstrip("\r\n")
+            sys.stdout.write(f"{val}\n")
+            sys.stdout.flush()
+            return val
+
+        @_pause_echo(echo_input)  # type: ignore
+        def hidden_input(prompt: t.Optional[str] = None) -> str:
+            sys.stdout.write(f"{prompt or ''}\n")
+            sys.stdout.flush()
+            return text_input.readline().rstrip("\r\n")
+
+        @_pause_echo(echo_input)  # type: ignore
+        def _getchar(echo: bool) -> str:
+            char = sys.stdin.read(1)
+
+            if echo:
+                sys.stdout.write(char)
+
+            sys.stdout.flush()
+            return char
+
+        default_color = color
+
+        def should_strip_ansi(
+            stream: t.Optional[t.IO[t.Any]] = None, color: t.Optional[bool] = None
+        ) -> bool:
+            if color is None:
+                return not default_color
+            return not color
+
+        old_visible_prompt_func = termui.visible_prompt_func
+        old_hidden_prompt_func = termui.hidden_prompt_func
+        old__getchar_func = termui._getchar
+        old_should_strip_ansi = utils.should_strip_ansi  # type: ignore
+        termui.visible_prompt_func = visible_input
+        termui.hidden_prompt_func = hidden_input
+        termui._getchar = _getchar
+        utils.should_strip_ansi = should_strip_ansi  # type: ignore
+
+        old_env = {}
+        try:
+            for key, value in env.items():
+                old_env[key] = os.environ.get(key)
+                if value is None:
+                    try:
+                        del os.environ[key]
+                    except Exception:
+                        pass
+                else:
+                    os.environ[key] = value
+            yield (bytes_output, bytes_error)
+        finally:
+            for key, value in old_env.items():
+                if value is None:
+                    try:
+                        del os.environ[key]
+                    except Exception:
+                        pass
+                else:
+                    os.environ[key] = value
+            sys.stdout = old_stdout
+            sys.stderr = old_stderr
+            sys.stdin = old_stdin
+            termui.visible_prompt_func = old_visible_prompt_func
+            termui.hidden_prompt_func = old_hidden_prompt_func
+            termui._getchar = old__getchar_func
+            utils.should_strip_ansi = old_should_strip_ansi  # type: ignore
+            formatting.FORCED_WIDTH = old_forced_width
+
+    def invoke(
+        self,
+        cli: "BaseCommand",
+        args: t.Optional[t.Union[str, t.Sequence[str]]] = None,
+        input: t.Optional[t.Union[str, bytes, t.IO[t.Any]]] = None,
+        env: t.Optional[t.Mapping[str, t.Optional[str]]] = None,
+        catch_exceptions: bool = True,
+        color: bool = False,
+        **extra: t.Any,
+    ) -> Result:
+        """Invokes a command in an isolated environment.  The arguments are
+        forwarded directly to the command line script, the `extra` keyword
+        arguments are passed to the :meth:`~clickpkg.Command.main` function of
+        the command.
+
+        This returns a :class:`Result` object.
+
+        :param cli: the command to invoke
+        :param args: the arguments to invoke. It may be given as an iterable
+                     or a string. When given as string it will be interpreted
+                     as a Unix shell command. More details at
+                     :func:`shlex.split`.
+        :param input: the input data for `sys.stdin`.
+        :param env: the environment overrides.
+        :param catch_exceptions: Whether to catch any other exceptions than
+                                 ``SystemExit``.
+        :param extra: the keyword arguments to pass to :meth:`main`.
+        :param color: whether the output should contain color codes. The
+                      application can still override this explicitly.
+
+        .. versionchanged:: 8.0
+            The result object has the ``return_value`` attribute with
+            the value returned from the invoked command.
+
+        .. versionchanged:: 4.0
+            Added the ``color`` parameter.
+
+        .. versionchanged:: 3.0
+            Added the ``catch_exceptions`` parameter.
+
+        .. versionchanged:: 3.0
+            The result object has the ``exc_info`` attribute with the
+            traceback if available.
+        """
+        exc_info = None
+        with self.isolation(input=input, env=env, color=color) as outstreams:
+            return_value = None
+            exception: t.Optional[BaseException] = None
+            exit_code = 0
+
+            if isinstance(args, str):
+                args = shlex.split(args)
+
+            try:
+                prog_name = extra.pop("prog_name")
+            except KeyError:
+                prog_name = self.get_default_prog_name(cli)
+
+            try:
+                return_value = cli.main(args=args or (), prog_name=prog_name, **extra)
+            except SystemExit as e:
+                exc_info = sys.exc_info()
+                e_code = t.cast(t.Optional[t.Union[int, t.Any]], e.code)
+
+                if e_code is None:
+                    e_code = 0
+
+                if e_code != 0:
+                    exception = e
+
+                if not isinstance(e_code, int):
+                    sys.stdout.write(str(e_code))
+                    sys.stdout.write("\n")
+                    e_code = 1
+
+                exit_code = e_code
+
+            except Exception as e:
+                if not catch_exceptions:
+                    raise
+                exception = e
+                exit_code = 1
+                exc_info = sys.exc_info()
+            finally:
+                sys.stdout.flush()
+                stdout = outstreams[0].getvalue()
+                if self.mix_stderr:
+                    stderr = None
+                else:
+                    stderr = outstreams[1].getvalue()  # type: ignore
+
+        return Result(
+            runner=self,
+            stdout_bytes=stdout,
+            stderr_bytes=stderr,
+            return_value=return_value,
+            exit_code=exit_code,
+            exception=exception,
+            exc_info=exc_info,  # type: ignore
+        )
+
+    @contextlib.contextmanager
+    def isolated_filesystem(
+        self, temp_dir: t.Optional[t.Union[str, "os.PathLike[str]"]] = None
+    ) -> t.Iterator[str]:
+        """A context manager that creates a temporary directory and
+        changes the current working directory to it. This isolates tests
+        that affect the contents of the CWD to prevent them from
+        interfering with each other.
+
+        :param temp_dir: Create the temporary directory under this
+            directory. If given, the created directory is not removed
+            when exiting.
+
+        .. versionchanged:: 8.0
+            Added the ``temp_dir`` parameter.
+        """
+        cwd = os.getcwd()
+        dt = tempfile.mkdtemp(dir=temp_dir)
+        os.chdir(dt)
+
+        try:
+            yield dt
+        finally:
+            os.chdir(cwd)
+
+            if temp_dir is None:
+                try:
+                    shutil.rmtree(dt)
+                except OSError:  # noqa: B014
+                    pass
diff --git a/llm/Lib/site-packages/click/types.py b/llm/Lib/site-packages/click/types.py
new file mode 100644
index 0000000000000000000000000000000000000000..2b1d1797f2e115e9bc976bcaf7d8e1884a91e91c
--- /dev/null
+++ b/llm/Lib/site-packages/click/types.py
@@ -0,0 +1,1089 @@
+import os
+import stat
+import sys
+import typing as t
+from datetime import datetime
+from gettext import gettext as _
+from gettext import ngettext
+
+from ._compat import _get_argv_encoding
+from ._compat import open_stream
+from .exceptions import BadParameter
+from .utils import format_filename
+from .utils import LazyFile
+from .utils import safecall
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+    from .core import Context
+    from .core import Parameter
+    from .shell_completion import CompletionItem
+
+
+class ParamType:
+    """Represents the type of a parameter. Validates and converts values
+    from the command line or Python into the correct type.
+
+    To implement a custom type, subclass and implement at least the
+    following:
+
+    -   The :attr:`name` class attribute must be set.
+    -   Calling an instance of the type with ``None`` must return
+        ``None``. This is already implemented by default.
+    -   :meth:`convert` must convert string values to the correct type.
+    -   :meth:`convert` must accept values that are already the correct
+        type.
+    -   It must be able to convert a value if the ``ctx`` and ``param``
+        arguments are ``None``. This can occur when converting prompt
+        input.
+    """
+
+    is_composite: t.ClassVar[bool] = False
+    arity: t.ClassVar[int] = 1
+
+    #: the descriptive name of this type
+    name: str
+
+    #: if a list of this type is expected and the value is pulled from a
+    #: string environment variable, this is what splits it up.  `None`
+    #: means any whitespace.  For all parameters the general rule is that
+    #: whitespace splits them up.  The exception are paths and files which
+    #: are split by ``os.path.pathsep`` by default (":" on Unix and ";" on
+    #: Windows).
+    envvar_list_splitter: t.ClassVar[t.Optional[str]] = None
+
+    def to_info_dict(self) -> t.Dict[str, t.Any]:
+        """Gather information that could be useful for a tool generating
+        user-facing documentation.
+
+        Use :meth:`click.Context.to_info_dict` to traverse the entire
+        CLI structure.
+
+        .. versionadded:: 8.0
+        """
+        # The class name without the "ParamType" suffix.
+        param_type = type(self).__name__.partition("ParamType")[0]
+        param_type = param_type.partition("ParameterType")[0]
+
+        # Custom subclasses might not remember to set a name.
+        if hasattr(self, "name"):
+            name = self.name
+        else:
+            name = param_type
+
+        return {"param_type": param_type, "name": name}
+
+    def __call__(
+        self,
+        value: t.Any,
+        param: t.Optional["Parameter"] = None,
+        ctx: t.Optional["Context"] = None,
+    ) -> t.Any:
+        if value is not None:
+            return self.convert(value, param, ctx)
+
+    def get_metavar(self, param: "Parameter") -> t.Optional[str]:
+        """Returns the metavar default for this param if it provides one."""
+
+    def get_missing_message(self, param: "Parameter") -> t.Optional[str]:
+        """Optionally might return extra information about a missing
+        parameter.
+
+        .. versionadded:: 2.0
+        """
+
+    def convert(
+        self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"]
+    ) -> t.Any:
+        """Convert the value to the correct type. This is not called if
+        the value is ``None`` (the missing value).
+
+        This must accept string values from the command line, as well as
+        values that are already the correct type. It may also convert
+        other compatible types.
+
+        The ``param`` and ``ctx`` arguments may be ``None`` in certain
+        situations, such as when converting prompt input.
+
+        If the value cannot be converted, call :meth:`fail` with a
+        descriptive message.
+
+        :param value: The value to convert.
+        :param param: The parameter that is using this type to convert
+            its value. May be ``None``.
+        :param ctx: The current context that arrived at this value. May
+            be ``None``.
+        """
+        return value
+
+    def split_envvar_value(self, rv: str) -> t.Sequence[str]:
+        """Given a value from an environment variable this splits it up
+        into small chunks depending on the defined envvar list splitter.
+
+        If the splitter is set to `None`, which means that whitespace splits,
+        then leading and trailing whitespace is ignored.  Otherwise, leading
+        and trailing splitters usually lead to empty items being included.
+        """
+        return (rv or "").split(self.envvar_list_splitter)
+
+    def fail(
+        self,
+        message: str,
+        param: t.Optional["Parameter"] = None,
+        ctx: t.Optional["Context"] = None,
+    ) -> "t.NoReturn":
+        """Helper method to fail with an invalid value message."""
+        raise BadParameter(message, ctx=ctx, param=param)
+
+    def shell_complete(
+        self, ctx: "Context", param: "Parameter", incomplete: str
+    ) -> t.List["CompletionItem"]:
+        """Return a list of
+        :class:`~click.shell_completion.CompletionItem` objects for the
+        incomplete value. Most types do not provide completions, but
+        some do, and this allows custom types to provide custom
+        completions as well.
+
+        :param ctx: Invocation context for this command.
+        :param param: The parameter that is requesting completion.
+        :param incomplete: Value being completed. May be empty.
+
+        .. versionadded:: 8.0
+        """
+        return []
+
+
+class CompositeParamType(ParamType):
+    is_composite = True
+
+    @property
+    def arity(self) -> int:  # type: ignore
+        raise NotImplementedError()
+
+
+class FuncParamType(ParamType):
+    def __init__(self, func: t.Callable[[t.Any], t.Any]) -> None:
+        self.name: str = func.__name__
+        self.func = func
+
+    def to_info_dict(self) -> t.Dict[str, t.Any]:
+        info_dict = super().to_info_dict()
+        info_dict["func"] = self.func
+        return info_dict
+
+    def convert(
+        self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"]
+    ) -> t.Any:
+        try:
+            return self.func(value)
+        except ValueError:
+            try:
+                value = str(value)
+            except UnicodeError:
+                value = value.decode("utf-8", "replace")
+
+            self.fail(value, param, ctx)
+
+
+class UnprocessedParamType(ParamType):
+    name = "text"
+
+    def convert(
+        self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"]
+    ) -> t.Any:
+        return value
+
+    def __repr__(self) -> str:
+        return "UNPROCESSED"
+
+
+class StringParamType(ParamType):
+    name = "text"
+
+    def convert(
+        self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"]
+    ) -> t.Any:
+        if isinstance(value, bytes):
+            enc = _get_argv_encoding()
+            try:
+                value = value.decode(enc)
+            except UnicodeError:
+                fs_enc = sys.getfilesystemencoding()
+                if fs_enc != enc:
+                    try:
+                        value = value.decode(fs_enc)
+                    except UnicodeError:
+                        value = value.decode("utf-8", "replace")
+                else:
+                    value = value.decode("utf-8", "replace")
+            return value
+        return str(value)
+
+    def __repr__(self) -> str:
+        return "STRING"
+
+
+class Choice(ParamType):
+    """The choice type allows a value to be checked against a fixed set
+    of supported values. All of these values have to be strings.
+
+    You should only pass a list or tuple of choices. Other iterables
+    (like generators) may lead to surprising results.
+
+    The resulting value will always be one of the originally passed choices
+    regardless of ``case_sensitive`` or any ``ctx.token_normalize_func``
+    being specified.
+
+    See :ref:`choice-opts` for an example.
+
+    :param case_sensitive: Set to false to make choices case
+        insensitive. Defaults to true.
+    """
+
+    name = "choice"
+
+    def __init__(self, choices: t.Sequence[str], case_sensitive: bool = True) -> None:
+        self.choices = choices
+        self.case_sensitive = case_sensitive
+
+    def to_info_dict(self) -> t.Dict[str, t.Any]:
+        info_dict = super().to_info_dict()
+        info_dict["choices"] = self.choices
+        info_dict["case_sensitive"] = self.case_sensitive
+        return info_dict
+
+    def get_metavar(self, param: "Parameter") -> str:
+        choices_str = "|".join(self.choices)
+
+        # Use curly braces to indicate a required argument.
+        if param.required and param.param_type_name == "argument":
+            return f"{{{choices_str}}}"
+
+        # Use square braces to indicate an option or optional argument.
+        return f"[{choices_str}]"
+
+    def get_missing_message(self, param: "Parameter") -> str:
+        return _("Choose from:\n\t{choices}").format(choices=",\n\t".join(self.choices))
+
+    def convert(
+        self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"]
+    ) -> t.Any:
+        # Match through normalization and case sensitivity
+        # first do token_normalize_func, then lowercase
+        # preserve original `value` to produce an accurate message in
+        # `self.fail`
+        normed_value = value
+        normed_choices = {choice: choice for choice in self.choices}
+
+        if ctx is not None and ctx.token_normalize_func is not None:
+            normed_value = ctx.token_normalize_func(value)
+            normed_choices = {
+                ctx.token_normalize_func(normed_choice): original
+                for normed_choice, original in normed_choices.items()
+            }
+
+        if not self.case_sensitive:
+            normed_value = normed_value.casefold()
+            normed_choices = {
+                normed_choice.casefold(): original
+                for normed_choice, original in normed_choices.items()
+            }
+
+        if normed_value in normed_choices:
+            return normed_choices[normed_value]
+
+        choices_str = ", ".join(map(repr, self.choices))
+        self.fail(
+            ngettext(
+                "{value!r} is not {choice}.",
+                "{value!r} is not one of {choices}.",
+                len(self.choices),
+            ).format(value=value, choice=choices_str, choices=choices_str),
+            param,
+            ctx,
+        )
+
+    def __repr__(self) -> str:
+        return f"Choice({list(self.choices)})"
+
+    def shell_complete(
+        self, ctx: "Context", param: "Parameter", incomplete: str
+    ) -> t.List["CompletionItem"]:
+        """Complete choices that start with the incomplete value.
+
+        :param ctx: Invocation context for this command.
+        :param param: The parameter that is requesting completion.
+        :param incomplete: Value being completed. May be empty.
+
+        .. versionadded:: 8.0
+        """
+        from click.shell_completion import CompletionItem
+
+        str_choices = map(str, self.choices)
+
+        if self.case_sensitive:
+            matched = (c for c in str_choices if c.startswith(incomplete))
+        else:
+            incomplete = incomplete.lower()
+            matched = (c for c in str_choices if c.lower().startswith(incomplete))
+
+        return [CompletionItem(c) for c in matched]
+
+
+class DateTime(ParamType):
+    """The DateTime type converts date strings into `datetime` objects.
+
+    The format strings which are checked are configurable, but default to some
+    common (non-timezone aware) ISO 8601 formats.
+
+    When specifying *DateTime* formats, you should only pass a list or a tuple.
+    Other iterables, like generators, may lead to surprising results.
+
+    The format strings are processed using ``datetime.strptime``, and this
+    consequently defines the format strings which are allowed.
+
+    Parsing is tried using each format, in order, and the first format which
+    parses successfully is used.
+
+    :param formats: A list or tuple of date format strings, in the order in
+                    which they should be tried. Defaults to
+                    ``'%Y-%m-%d'``, ``'%Y-%m-%dT%H:%M:%S'``,
+                    ``'%Y-%m-%d %H:%M:%S'``.
+    """
+
+    name = "datetime"
+
+    def __init__(self, formats: t.Optional[t.Sequence[str]] = None):
+        self.formats: t.Sequence[str] = formats or [
+            "%Y-%m-%d",
+            "%Y-%m-%dT%H:%M:%S",
+            "%Y-%m-%d %H:%M:%S",
+        ]
+
+    def to_info_dict(self) -> t.Dict[str, t.Any]:
+        info_dict = super().to_info_dict()
+        info_dict["formats"] = self.formats
+        return info_dict
+
+    def get_metavar(self, param: "Parameter") -> str:
+        return f"[{'|'.join(self.formats)}]"
+
+    def _try_to_convert_date(self, value: t.Any, format: str) -> t.Optional[datetime]:
+        try:
+            return datetime.strptime(value, format)
+        except ValueError:
+            return None
+
+    def convert(
+        self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"]
+    ) -> t.Any:
+        if isinstance(value, datetime):
+            return value
+
+        for format in self.formats:
+            converted = self._try_to_convert_date(value, format)
+
+            if converted is not None:
+                return converted
+
+        formats_str = ", ".join(map(repr, self.formats))
+        self.fail(
+            ngettext(
+                "{value!r} does not match the format {format}.",
+                "{value!r} does not match the formats {formats}.",
+                len(self.formats),
+            ).format(value=value, format=formats_str, formats=formats_str),
+            param,
+            ctx,
+        )
+
+    def __repr__(self) -> str:
+        return "DateTime"
+
+
+class _NumberParamTypeBase(ParamType):
+    _number_class: t.ClassVar[t.Type[t.Any]]
+
+    def convert(
+        self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"]
+    ) -> t.Any:
+        try:
+            return self._number_class(value)
+        except ValueError:
+            self.fail(
+                _("{value!r} is not a valid {number_type}.").format(
+                    value=value, number_type=self.name
+                ),
+                param,
+                ctx,
+            )
+
+
+class _NumberRangeBase(_NumberParamTypeBase):
+    def __init__(
+        self,
+        min: t.Optional[float] = None,
+        max: t.Optional[float] = None,
+        min_open: bool = False,
+        max_open: bool = False,
+        clamp: bool = False,
+    ) -> None:
+        self.min = min
+        self.max = max
+        self.min_open = min_open
+        self.max_open = max_open
+        self.clamp = clamp
+
+    def to_info_dict(self) -> t.Dict[str, t.Any]:
+        info_dict = super().to_info_dict()
+        info_dict.update(
+            min=self.min,
+            max=self.max,
+            min_open=self.min_open,
+            max_open=self.max_open,
+            clamp=self.clamp,
+        )
+        return info_dict
+
+    def convert(
+        self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"]
+    ) -> t.Any:
+        import operator
+
+        rv = super().convert(value, param, ctx)
+        lt_min: bool = self.min is not None and (
+            operator.le if self.min_open else operator.lt
+        )(rv, self.min)
+        gt_max: bool = self.max is not None and (
+            operator.ge if self.max_open else operator.gt
+        )(rv, self.max)
+
+        if self.clamp:
+            if lt_min:
+                return self._clamp(self.min, 1, self.min_open)  # type: ignore
+
+            if gt_max:
+                return self._clamp(self.max, -1, self.max_open)  # type: ignore
+
+        if lt_min or gt_max:
+            self.fail(
+                _("{value} is not in the range {range}.").format(
+                    value=rv, range=self._describe_range()
+                ),
+                param,
+                ctx,
+            )
+
+        return rv
+
+    def _clamp(self, bound: float, dir: "te.Literal[1, -1]", open: bool) -> float:
+        """Find the valid value to clamp to bound in the given
+        direction.
+
+        :param bound: The boundary value.
+        :param dir: 1 or -1 indicating the direction to move.
+        :param open: If true, the range does not include the bound.
+        """
+        raise NotImplementedError
+
+    def _describe_range(self) -> str:
+        """Describe the range for use in help text."""
+        if self.min is None:
+            op = "<" if self.max_open else "<="
+            return f"x{op}{self.max}"
+
+        if self.max is None:
+            op = ">" if self.min_open else ">="
+            return f"x{op}{self.min}"
+
+        lop = "<" if self.min_open else "<="
+        rop = "<" if self.max_open else "<="
+        return f"{self.min}{lop}x{rop}{self.max}"
+
+    def __repr__(self) -> str:
+        clamp = " clamped" if self.clamp else ""
+        return f"<{type(self).__name__} {self._describe_range()}{clamp}>"
+
+
+class IntParamType(_NumberParamTypeBase):
+    name = "integer"
+    _number_class = int
+
+    def __repr__(self) -> str:
+        return "INT"
+
+
+class IntRange(_NumberRangeBase, IntParamType):
+    """Restrict an :data:`click.INT` value to a range of accepted
+    values. See :ref:`ranges`.
+
+    If ``min`` or ``max`` are not passed, any value is accepted in that
+    direction. If ``min_open`` or ``max_open`` are enabled, the
+    corresponding boundary is not included in the range.
+
+    If ``clamp`` is enabled, a value outside the range is clamped to the
+    boundary instead of failing.
+
+    .. versionchanged:: 8.0
+        Added the ``min_open`` and ``max_open`` parameters.
+    """
+
+    name = "integer range"
+
+    def _clamp(  # type: ignore
+        self, bound: int, dir: "te.Literal[1, -1]", open: bool
+    ) -> int:
+        if not open:
+            return bound
+
+        return bound + dir
+
+
+class FloatParamType(_NumberParamTypeBase):
+    name = "float"
+    _number_class = float
+
+    def __repr__(self) -> str:
+        return "FLOAT"
+
+
+class FloatRange(_NumberRangeBase, FloatParamType):
+    """Restrict a :data:`click.FLOAT` value to a range of accepted
+    values. See :ref:`ranges`.
+
+    If ``min`` or ``max`` are not passed, any value is accepted in that
+    direction. If ``min_open`` or ``max_open`` are enabled, the
+    corresponding boundary is not included in the range.
+
+    If ``clamp`` is enabled, a value outside the range is clamped to the
+    boundary instead of failing. This is not supported if either
+    boundary is marked ``open``.
+
+    .. versionchanged:: 8.0
+        Added the ``min_open`` and ``max_open`` parameters.
+    """
+
+    name = "float range"
+
+    def __init__(
+        self,
+        min: t.Optional[float] = None,
+        max: t.Optional[float] = None,
+        min_open: bool = False,
+        max_open: bool = False,
+        clamp: bool = False,
+    ) -> None:
+        super().__init__(
+            min=min, max=max, min_open=min_open, max_open=max_open, clamp=clamp
+        )
+
+        if (min_open or max_open) and clamp:
+            raise TypeError("Clamping is not supported for open bounds.")
+
+    def _clamp(self, bound: float, dir: "te.Literal[1, -1]", open: bool) -> float:
+        if not open:
+            return bound
+
+        # Could use Python 3.9's math.nextafter here, but clamping an
+        # open float range doesn't seem to be particularly useful. It's
+        # left up to the user to write a callback to do it if needed.
+        raise RuntimeError("Clamping is not supported for open bounds.")
+
+
+class BoolParamType(ParamType):
+    name = "boolean"
+
+    def convert(
+        self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"]
+    ) -> t.Any:
+        if value in {False, True}:
+            return bool(value)
+
+        norm = value.strip().lower()
+
+        if norm in {"1", "true", "t", "yes", "y", "on"}:
+            return True
+
+        if norm in {"0", "false", "f", "no", "n", "off"}:
+            return False
+
+        self.fail(
+            _("{value!r} is not a valid boolean.").format(value=value), param, ctx
+        )
+
+    def __repr__(self) -> str:
+        return "BOOL"
+
+
+class UUIDParameterType(ParamType):
+    name = "uuid"
+
+    def convert(
+        self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"]
+    ) -> t.Any:
+        import uuid
+
+        if isinstance(value, uuid.UUID):
+            return value
+
+        value = value.strip()
+
+        try:
+            return uuid.UUID(value)
+        except ValueError:
+            self.fail(
+                _("{value!r} is not a valid UUID.").format(value=value), param, ctx
+            )
+
+    def __repr__(self) -> str:
+        return "UUID"
+
+
+class File(ParamType):
+    """Declares a parameter to be a file for reading or writing.  The file
+    is automatically closed once the context tears down (after the command
+    finished working).
+
+    Files can be opened for reading or writing.  The special value ``-``
+    indicates stdin or stdout depending on the mode.
+
+    By default, the file is opened for reading text data, but it can also be
+    opened in binary mode or for writing.  The encoding parameter can be used
+    to force a specific encoding.
+
+    The `lazy` flag controls if the file should be opened immediately or upon
+    first IO. The default is to be non-lazy for standard input and output
+    streams as well as files opened for reading, `lazy` otherwise. When opening a
+    file lazily for reading, it is still opened temporarily for validation, but
+    will not be held open until first IO. lazy is mainly useful when opening
+    for writing to avoid creating the file until it is needed.
+
+    Starting with Click 2.0, files can also be opened atomically in which
+    case all writes go into a separate file in the same folder and upon
+    completion the file will be moved over to the original location.  This
+    is useful if a file regularly read by other users is modified.
+
+    See :ref:`file-args` for more information.
+    """
+
+    name = "filename"
+    envvar_list_splitter: t.ClassVar[str] = os.path.pathsep
+
+    def __init__(
+        self,
+        mode: str = "r",
+        encoding: t.Optional[str] = None,
+        errors: t.Optional[str] = "strict",
+        lazy: t.Optional[bool] = None,
+        atomic: bool = False,
+    ) -> None:
+        self.mode = mode
+        self.encoding = encoding
+        self.errors = errors
+        self.lazy = lazy
+        self.atomic = atomic
+
+    def to_info_dict(self) -> t.Dict[str, t.Any]:
+        info_dict = super().to_info_dict()
+        info_dict.update(mode=self.mode, encoding=self.encoding)
+        return info_dict
+
+    def resolve_lazy_flag(self, value: "t.Union[str, os.PathLike[str]]") -> bool:
+        if self.lazy is not None:
+            return self.lazy
+        if os.fspath(value) == "-":
+            return False
+        elif "w" in self.mode:
+            return True
+        return False
+
+    def convert(
+        self,
+        value: t.Union[str, "os.PathLike[str]", t.IO[t.Any]],
+        param: t.Optional["Parameter"],
+        ctx: t.Optional["Context"],
+    ) -> t.IO[t.Any]:
+        if _is_file_like(value):
+            return value
+
+        value = t.cast("t.Union[str, os.PathLike[str]]", value)
+
+        try:
+            lazy = self.resolve_lazy_flag(value)
+
+            if lazy:
+                lf = LazyFile(
+                    value, self.mode, self.encoding, self.errors, atomic=self.atomic
+                )
+
+                if ctx is not None:
+                    ctx.call_on_close(lf.close_intelligently)
+
+                return t.cast(t.IO[t.Any], lf)
+
+            f, should_close = open_stream(
+                value, self.mode, self.encoding, self.errors, atomic=self.atomic
+            )
+
+            # If a context is provided, we automatically close the file
+            # at the end of the context execution (or flush out).  If a
+            # context does not exist, it's the caller's responsibility to
+            # properly close the file.  This for instance happens when the
+            # type is used with prompts.
+            if ctx is not None:
+                if should_close:
+                    ctx.call_on_close(safecall(f.close))
+                else:
+                    ctx.call_on_close(safecall(f.flush))
+
+            return f
+        except OSError as e:  # noqa: B014
+            self.fail(f"'{format_filename(value)}': {e.strerror}", param, ctx)
+
+    def shell_complete(
+        self, ctx: "Context", param: "Parameter", incomplete: str
+    ) -> t.List["CompletionItem"]:
+        """Return a special completion marker that tells the completion
+        system to use the shell to provide file path completions.
+
+        :param ctx: Invocation context for this command.
+        :param param: The parameter that is requesting completion.
+        :param incomplete: Value being completed. May be empty.
+
+        .. versionadded:: 8.0
+        """
+        from click.shell_completion import CompletionItem
+
+        return [CompletionItem(incomplete, type="file")]
+
+
+def _is_file_like(value: t.Any) -> "te.TypeGuard[t.IO[t.Any]]":
+    return hasattr(value, "read") or hasattr(value, "write")
+
+
+class Path(ParamType):
+    """The ``Path`` type is similar to the :class:`File` type, but
+    returns the filename instead of an open file. Various checks can be
+    enabled to validate the type of file and permissions.
+
+    :param exists: The file or directory needs to exist for the value to
+        be valid. If this is not set to ``True``, and the file does not
+        exist, then all further checks are silently skipped.
+    :param file_okay: Allow a file as a value.
+    :param dir_okay: Allow a directory as a value.
+    :param readable: if true, a readable check is performed.
+    :param writable: if true, a writable check is performed.
+    :param executable: if true, an executable check is performed.
+    :param resolve_path: Make the value absolute and resolve any
+        symlinks. A ``~`` is not expanded, as this is supposed to be
+        done by the shell only.
+    :param allow_dash: Allow a single dash as a value, which indicates
+        a standard stream (but does not open it). Use
+        :func:`~click.open_file` to handle opening this value.
+    :param path_type: Convert the incoming path value to this type. If
+        ``None``, keep Python's default, which is ``str``. Useful to
+        convert to :class:`pathlib.Path`.
+
+    .. versionchanged:: 8.1
+        Added the ``executable`` parameter.
+
+    .. versionchanged:: 8.0
+        Allow passing ``path_type=pathlib.Path``.
+
+    .. versionchanged:: 6.0
+        Added the ``allow_dash`` parameter.
+    """
+
+    envvar_list_splitter: t.ClassVar[str] = os.path.pathsep
+
+    def __init__(
+        self,
+        exists: bool = False,
+        file_okay: bool = True,
+        dir_okay: bool = True,
+        writable: bool = False,
+        readable: bool = True,
+        resolve_path: bool = False,
+        allow_dash: bool = False,
+        path_type: t.Optional[t.Type[t.Any]] = None,
+        executable: bool = False,
+    ):
+        self.exists = exists
+        self.file_okay = file_okay
+        self.dir_okay = dir_okay
+        self.readable = readable
+        self.writable = writable
+        self.executable = executable
+        self.resolve_path = resolve_path
+        self.allow_dash = allow_dash
+        self.type = path_type
+
+        if self.file_okay and not self.dir_okay:
+            self.name: str = _("file")
+        elif self.dir_okay and not self.file_okay:
+            self.name = _("directory")
+        else:
+            self.name = _("path")
+
+    def to_info_dict(self) -> t.Dict[str, t.Any]:
+        info_dict = super().to_info_dict()
+        info_dict.update(
+            exists=self.exists,
+            file_okay=self.file_okay,
+            dir_okay=self.dir_okay,
+            writable=self.writable,
+            readable=self.readable,
+            allow_dash=self.allow_dash,
+        )
+        return info_dict
+
+    def coerce_path_result(
+        self, value: "t.Union[str, os.PathLike[str]]"
+    ) -> "t.Union[str, bytes, os.PathLike[str]]":
+        if self.type is not None and not isinstance(value, self.type):
+            if self.type is str:
+                return os.fsdecode(value)
+            elif self.type is bytes:
+                return os.fsencode(value)
+            else:
+                return t.cast("os.PathLike[str]", self.type(value))
+
+        return value
+
+    def convert(
+        self,
+        value: "t.Union[str, os.PathLike[str]]",
+        param: t.Optional["Parameter"],
+        ctx: t.Optional["Context"],
+    ) -> "t.Union[str, bytes, os.PathLike[str]]":
+        rv = value
+
+        is_dash = self.file_okay and self.allow_dash and rv in (b"-", "-")
+
+        if not is_dash:
+            if self.resolve_path:
+                # os.path.realpath doesn't resolve symlinks on Windows
+                # until Python 3.8. Use pathlib for now.
+                import pathlib
+
+                rv = os.fsdecode(pathlib.Path(rv).resolve())
+
+            try:
+                st = os.stat(rv)
+            except OSError:
+                if not self.exists:
+                    return self.coerce_path_result(rv)
+                self.fail(
+                    _("{name} {filename!r} does not exist.").format(
+                        name=self.name.title(), filename=format_filename(value)
+                    ),
+                    param,
+                    ctx,
+                )
+
+            if not self.file_okay and stat.S_ISREG(st.st_mode):
+                self.fail(
+                    _("{name} {filename!r} is a file.").format(
+                        name=self.name.title(), filename=format_filename(value)
+                    ),
+                    param,
+                    ctx,
+                )
+            if not self.dir_okay and stat.S_ISDIR(st.st_mode):
+                self.fail(
+                    _("{name} '{filename}' is a directory.").format(
+                        name=self.name.title(), filename=format_filename(value)
+                    ),
+                    param,
+                    ctx,
+                )
+
+            if self.readable and not os.access(rv, os.R_OK):
+                self.fail(
+                    _("{name} {filename!r} is not readable.").format(
+                        name=self.name.title(), filename=format_filename(value)
+                    ),
+                    param,
+                    ctx,
+                )
+
+            if self.writable and not os.access(rv, os.W_OK):
+                self.fail(
+                    _("{name} {filename!r} is not writable.").format(
+                        name=self.name.title(), filename=format_filename(value)
+                    ),
+                    param,
+                    ctx,
+                )
+
+            if self.executable and not os.access(value, os.X_OK):
+                self.fail(
+                    _("{name} {filename!r} is not executable.").format(
+                        name=self.name.title(), filename=format_filename(value)
+                    ),
+                    param,
+                    ctx,
+                )
+
+        return self.coerce_path_result(rv)
+
+    def shell_complete(
+        self, ctx: "Context", param: "Parameter", incomplete: str
+    ) -> t.List["CompletionItem"]:
+        """Return a special completion marker that tells the completion
+        system to use the shell to provide path completions for only
+        directories or any paths.
+
+        :param ctx: Invocation context for this command.
+        :param param: The parameter that is requesting completion.
+        :param incomplete: Value being completed. May be empty.
+
+        .. versionadded:: 8.0
+        """
+        from click.shell_completion import CompletionItem
+
+        type = "dir" if self.dir_okay and not self.file_okay else "file"
+        return [CompletionItem(incomplete, type=type)]
+
+
+class Tuple(CompositeParamType):
+    """The default behavior of Click is to apply a type on a value directly.
+    This works well in most cases, except for when `nargs` is set to a fixed
+    count and different types should be used for different items.  In this
+    case the :class:`Tuple` type can be used.  This type can only be used
+    if `nargs` is set to a fixed number.
+
+    For more information see :ref:`tuple-type`.
+
+    This can be selected by using a Python tuple literal as a type.
+
+    :param types: a list of types that should be used for the tuple items.
+    """
+
+    def __init__(self, types: t.Sequence[t.Union[t.Type[t.Any], ParamType]]) -> None:
+        self.types: t.Sequence[ParamType] = [convert_type(ty) for ty in types]
+
+    def to_info_dict(self) -> t.Dict[str, t.Any]:
+        info_dict = super().to_info_dict()
+        info_dict["types"] = [t.to_info_dict() for t in self.types]
+        return info_dict
+
+    @property
+    def name(self) -> str:  # type: ignore
+        return f"<{' '.join(ty.name for ty in self.types)}>"
+
+    @property
+    def arity(self) -> int:  # type: ignore
+        return len(self.types)
+
+    def convert(
+        self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"]
+    ) -> t.Any:
+        len_type = len(self.types)
+        len_value = len(value)
+
+        if len_value != len_type:
+            self.fail(
+                ngettext(
+                    "{len_type} values are required, but {len_value} was given.",
+                    "{len_type} values are required, but {len_value} were given.",
+                    len_value,
+                ).format(len_type=len_type, len_value=len_value),
+                param=param,
+                ctx=ctx,
+            )
+
+        return tuple(ty(x, param, ctx) for ty, x in zip(self.types, value))
+
+
+def convert_type(ty: t.Optional[t.Any], default: t.Optional[t.Any] = None) -> ParamType:
+    """Find the most appropriate :class:`ParamType` for the given Python
+    type. If the type isn't provided, it can be inferred from a default
+    value.
+    """
+    guessed_type = False
+
+    if ty is None and default is not None:
+        if isinstance(default, (tuple, list)):
+            # If the default is empty, ty will remain None and will
+            # return STRING.
+            if default:
+                item = default[0]
+
+                # A tuple of tuples needs to detect the inner types.
+                # Can't call convert recursively because that would
+                # incorrectly unwind the tuple to a single type.
+                if isinstance(item, (tuple, list)):
+                    ty = tuple(map(type, item))
+                else:
+                    ty = type(item)
+        else:
+            ty = type(default)
+
+        guessed_type = True
+
+    if isinstance(ty, tuple):
+        return Tuple(ty)
+
+    if isinstance(ty, ParamType):
+        return ty
+
+    if ty is str or ty is None:
+        return STRING
+
+    if ty is int:
+        return INT
+
+    if ty is float:
+        return FLOAT
+
+    if ty is bool:
+        return BOOL
+
+    if guessed_type:
+        return STRING
+
+    if __debug__:
+        try:
+            if issubclass(ty, ParamType):
+                raise AssertionError(
+                    f"Attempted to use an uninstantiated parameter type ({ty})."
+                )
+        except TypeError:
+            # ty is an instance (correct), so issubclass fails.
+            pass
+
+    return FuncParamType(ty)
+
+
+#: A dummy parameter type that just does nothing.  From a user's
+#: perspective this appears to just be the same as `STRING` but
+#: internally no string conversion takes place if the input was bytes.
+#: This is usually useful when working with file paths as they can
+#: appear in bytes and unicode.
+#:
+#: For path related uses the :class:`Path` type is a better choice but
+#: there are situations where an unprocessed type is useful which is why
+#: it is is provided.
+#:
+#: .. versionadded:: 4.0
+UNPROCESSED = UnprocessedParamType()
+
+#: A unicode string parameter type which is the implicit default.  This
+#: can also be selected by using ``str`` as type.
+STRING = StringParamType()
+
+#: An integer parameter.  This can also be selected by using ``int`` as
+#: type.
+INT = IntParamType()
+
+#: A floating point value parameter.  This can also be selected by using
+#: ``float`` as type.
+FLOAT = FloatParamType()
+
+#: A boolean parameter.  This is the default for boolean flags.  This can
+#: also be selected by using ``bool`` as a type.
+BOOL = BoolParamType()
+
+#: A UUID parameter.
+UUID = UUIDParameterType()
diff --git a/llm/Lib/site-packages/click/utils.py b/llm/Lib/site-packages/click/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..d536434f0bd00cd6fd910c506f5b85a8e485b964
--- /dev/null
+++ b/llm/Lib/site-packages/click/utils.py
@@ -0,0 +1,624 @@
+import os
+import re
+import sys
+import typing as t
+from functools import update_wrapper
+from types import ModuleType
+from types import TracebackType
+
+from ._compat import _default_text_stderr
+from ._compat import _default_text_stdout
+from ._compat import _find_binary_writer
+from ._compat import auto_wrap_for_ansi
+from ._compat import binary_streams
+from ._compat import open_stream
+from ._compat import should_strip_ansi
+from ._compat import strip_ansi
+from ._compat import text_streams
+from ._compat import WIN
+from .globals import resolve_color_default
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+
+    P = te.ParamSpec("P")
+
+R = t.TypeVar("R")
+
+
+def _posixify(name: str) -> str:
+    return "-".join(name.split()).lower()
+
+
+def safecall(func: "t.Callable[P, R]") -> "t.Callable[P, t.Optional[R]]":
+    """Wraps a function so that it swallows exceptions."""
+
+    def wrapper(*args: "P.args", **kwargs: "P.kwargs") -> t.Optional[R]:
+        try:
+            return func(*args, **kwargs)
+        except Exception:
+            pass
+        return None
+
+    return update_wrapper(wrapper, func)
+
+
+def make_str(value: t.Any) -> str:
+    """Converts a value into a valid string."""
+    if isinstance(value, bytes):
+        try:
+            return value.decode(sys.getfilesystemencoding())
+        except UnicodeError:
+            return value.decode("utf-8", "replace")
+    return str(value)
+
+
+def make_default_short_help(help: str, max_length: int = 45) -> str:
+    """Returns a condensed version of help string."""
+    # Consider only the first paragraph.
+    paragraph_end = help.find("\n\n")
+
+    if paragraph_end != -1:
+        help = help[:paragraph_end]
+
+    # Collapse newlines, tabs, and spaces.
+    words = help.split()
+
+    if not words:
+        return ""
+
+    # The first paragraph started with a "no rewrap" marker, ignore it.
+    if words[0] == "\b":
+        words = words[1:]
+
+    total_length = 0
+    last_index = len(words) - 1
+
+    for i, word in enumerate(words):
+        total_length += len(word) + (i > 0)
+
+        if total_length > max_length:  # too long, truncate
+            break
+
+        if word[-1] == ".":  # sentence end, truncate without "..."
+            return " ".join(words[: i + 1])
+
+        if total_length == max_length and i != last_index:
+            break  # not at sentence end, truncate with "..."
+    else:
+        return " ".join(words)  # no truncation needed
+
+    # Account for the length of the suffix.
+    total_length += len("...")
+
+    # remove words until the length is short enough
+    while i > 0:
+        total_length -= len(words[i]) + (i > 0)
+
+        if total_length <= max_length:
+            break
+
+        i -= 1
+
+    return " ".join(words[:i]) + "..."
+
+
+class LazyFile:
+    """A lazy file works like a regular file but it does not fully open
+    the file but it does perform some basic checks early to see if the
+    filename parameter does make sense.  This is useful for safely opening
+    files for writing.
+    """
+
+    def __init__(
+        self,
+        filename: t.Union[str, "os.PathLike[str]"],
+        mode: str = "r",
+        encoding: t.Optional[str] = None,
+        errors: t.Optional[str] = "strict",
+        atomic: bool = False,
+    ):
+        self.name: str = os.fspath(filename)
+        self.mode = mode
+        self.encoding = encoding
+        self.errors = errors
+        self.atomic = atomic
+        self._f: t.Optional[t.IO[t.Any]]
+        self.should_close: bool
+
+        if self.name == "-":
+            self._f, self.should_close = open_stream(filename, mode, encoding, errors)
+        else:
+            if "r" in mode:
+                # Open and close the file in case we're opening it for
+                # reading so that we can catch at least some errors in
+                # some cases early.
+                open(filename, mode).close()
+            self._f = None
+            self.should_close = True
+
+    def __getattr__(self, name: str) -> t.Any:
+        return getattr(self.open(), name)
+
+    def __repr__(self) -> str:
+        if self._f is not None:
+            return repr(self._f)
+        return f"<unopened file '{format_filename(self.name)}' {self.mode}>"
+
+    def open(self) -> t.IO[t.Any]:
+        """Opens the file if it's not yet open.  This call might fail with
+        a :exc:`FileError`.  Not handling this error will produce an error
+        that Click shows.
+        """
+        if self._f is not None:
+            return self._f
+        try:
+            rv, self.should_close = open_stream(
+                self.name, self.mode, self.encoding, self.errors, atomic=self.atomic
+            )
+        except OSError as e:  # noqa: E402
+            from .exceptions import FileError
+
+            raise FileError(self.name, hint=e.strerror) from e
+        self._f = rv
+        return rv
+
+    def close(self) -> None:
+        """Closes the underlying file, no matter what."""
+        if self._f is not None:
+            self._f.close()
+
+    def close_intelligently(self) -> None:
+        """This function only closes the file if it was opened by the lazy
+        file wrapper.  For instance this will never close stdin.
+        """
+        if self.should_close:
+            self.close()
+
+    def __enter__(self) -> "LazyFile":
+        return self
+
+    def __exit__(
+        self,
+        exc_type: t.Optional[t.Type[BaseException]],
+        exc_value: t.Optional[BaseException],
+        tb: t.Optional[TracebackType],
+    ) -> None:
+        self.close_intelligently()
+
+    def __iter__(self) -> t.Iterator[t.AnyStr]:
+        self.open()
+        return iter(self._f)  # type: ignore
+
+
+class KeepOpenFile:
+    def __init__(self, file: t.IO[t.Any]) -> None:
+        self._file: t.IO[t.Any] = file
+
+    def __getattr__(self, name: str) -> t.Any:
+        return getattr(self._file, name)
+
+    def __enter__(self) -> "KeepOpenFile":
+        return self
+
+    def __exit__(
+        self,
+        exc_type: t.Optional[t.Type[BaseException]],
+        exc_value: t.Optional[BaseException],
+        tb: t.Optional[TracebackType],
+    ) -> None:
+        pass
+
+    def __repr__(self) -> str:
+        return repr(self._file)
+
+    def __iter__(self) -> t.Iterator[t.AnyStr]:
+        return iter(self._file)
+
+
+def echo(
+    message: t.Optional[t.Any] = None,
+    file: t.Optional[t.IO[t.Any]] = None,
+    nl: bool = True,
+    err: bool = False,
+    color: t.Optional[bool] = None,
+) -> None:
+    """Print a message and newline to stdout or a file. This should be
+    used instead of :func:`print` because it provides better support
+    for different data, files, and environments.
+
+    Compared to :func:`print`, this does the following:
+
+    -   Ensures that the output encoding is not misconfigured on Linux.
+    -   Supports Unicode in the Windows console.
+    -   Supports writing to binary outputs, and supports writing bytes
+        to text outputs.
+    -   Supports colors and styles on Windows.
+    -   Removes ANSI color and style codes if the output does not look
+        like an interactive terminal.
+    -   Always flushes the output.
+
+    :param message: The string or bytes to output. Other objects are
+        converted to strings.
+    :param file: The file to write to. Defaults to ``stdout``.
+    :param err: Write to ``stderr`` instead of ``stdout``.
+    :param nl: Print a newline after the message. Enabled by default.
+    :param color: Force showing or hiding colors and other styles. By
+        default Click will remove color if the output does not look like
+        an interactive terminal.
+
+    .. versionchanged:: 6.0
+        Support Unicode output on the Windows console. Click does not
+        modify ``sys.stdout``, so ``sys.stdout.write()`` and ``print()``
+        will still not support Unicode.
+
+    .. versionchanged:: 4.0
+        Added the ``color`` parameter.
+
+    .. versionadded:: 3.0
+        Added the ``err`` parameter.
+
+    .. versionchanged:: 2.0
+        Support colors on Windows if colorama is installed.
+    """
+    if file is None:
+        if err:
+            file = _default_text_stderr()
+        else:
+            file = _default_text_stdout()
+
+        # There are no standard streams attached to write to. For example,
+        # pythonw on Windows.
+        if file is None:
+            return
+
+    # Convert non bytes/text into the native string type.
+    if message is not None and not isinstance(message, (str, bytes, bytearray)):
+        out: t.Optional[t.Union[str, bytes]] = str(message)
+    else:
+        out = message
+
+    if nl:
+        out = out or ""
+        if isinstance(out, str):
+            out += "\n"
+        else:
+            out += b"\n"
+
+    if not out:
+        file.flush()
+        return
+
+    # If there is a message and the value looks like bytes, we manually
+    # need to find the binary stream and write the message in there.
+    # This is done separately so that most stream types will work as you
+    # would expect. Eg: you can write to StringIO for other cases.
+    if isinstance(out, (bytes, bytearray)):
+        binary_file = _find_binary_writer(file)
+
+        if binary_file is not None:
+            file.flush()
+            binary_file.write(out)
+            binary_file.flush()
+            return
+
+    # ANSI style code support. For no message or bytes, nothing happens.
+    # When outputting to a file instead of a terminal, strip codes.
+    else:
+        color = resolve_color_default(color)
+
+        if should_strip_ansi(file, color):
+            out = strip_ansi(out)
+        elif WIN:
+            if auto_wrap_for_ansi is not None:
+                file = auto_wrap_for_ansi(file)  # type: ignore
+            elif not color:
+                out = strip_ansi(out)
+
+    file.write(out)  # type: ignore
+    file.flush()
+
+
+def get_binary_stream(name: "te.Literal['stdin', 'stdout', 'stderr']") -> t.BinaryIO:
+    """Returns a system stream for byte processing.
+
+    :param name: the name of the stream to open.  Valid names are ``'stdin'``,
+                 ``'stdout'`` and ``'stderr'``
+    """
+    opener = binary_streams.get(name)
+    if opener is None:
+        raise TypeError(f"Unknown standard stream '{name}'")
+    return opener()
+
+
+def get_text_stream(
+    name: "te.Literal['stdin', 'stdout', 'stderr']",
+    encoding: t.Optional[str] = None,
+    errors: t.Optional[str] = "strict",
+) -> t.TextIO:
+    """Returns a system stream for text processing.  This usually returns
+    a wrapped stream around a binary stream returned from
+    :func:`get_binary_stream` but it also can take shortcuts for already
+    correctly configured streams.
+
+    :param name: the name of the stream to open.  Valid names are ``'stdin'``,
+                 ``'stdout'`` and ``'stderr'``
+    :param encoding: overrides the detected default encoding.
+    :param errors: overrides the default error mode.
+    """
+    opener = text_streams.get(name)
+    if opener is None:
+        raise TypeError(f"Unknown standard stream '{name}'")
+    return opener(encoding, errors)
+
+
+def open_file(
+    filename: str,
+    mode: str = "r",
+    encoding: t.Optional[str] = None,
+    errors: t.Optional[str] = "strict",
+    lazy: bool = False,
+    atomic: bool = False,
+) -> t.IO[t.Any]:
+    """Open a file, with extra behavior to handle ``'-'`` to indicate
+    a standard stream, lazy open on write, and atomic write. Similar to
+    the behavior of the :class:`~click.File` param type.
+
+    If ``'-'`` is given to open ``stdout`` or ``stdin``, the stream is
+    wrapped so that using it in a context manager will not close it.
+    This makes it possible to use the function without accidentally
+    closing a standard stream:
+
+    .. code-block:: python
+
+        with open_file(filename) as f:
+            ...
+
+    :param filename: The name of the file to open, or ``'-'`` for
+        ``stdin``/``stdout``.
+    :param mode: The mode in which to open the file.
+    :param encoding: The encoding to decode or encode a file opened in
+        text mode.
+    :param errors: The error handling mode.
+    :param lazy: Wait to open the file until it is accessed. For read
+        mode, the file is temporarily opened to raise access errors
+        early, then closed until it is read again.
+    :param atomic: Write to a temporary file and replace the given file
+        on close.
+
+    .. versionadded:: 3.0
+    """
+    if lazy:
+        return t.cast(
+            t.IO[t.Any], LazyFile(filename, mode, encoding, errors, atomic=atomic)
+        )
+
+    f, should_close = open_stream(filename, mode, encoding, errors, atomic=atomic)
+
+    if not should_close:
+        f = t.cast(t.IO[t.Any], KeepOpenFile(f))
+
+    return f
+
+
+def format_filename(
+    filename: "t.Union[str, bytes, os.PathLike[str], os.PathLike[bytes]]",
+    shorten: bool = False,
+) -> str:
+    """Format a filename as a string for display. Ensures the filename can be
+    displayed by replacing any invalid bytes or surrogate escapes in the name
+    with the replacement character ``�``.
+
+    Invalid bytes or surrogate escapes will raise an error when written to a
+    stream with ``errors="strict". This will typically happen with ``stdout``
+    when the locale is something like ``en_GB.UTF-8``.
+
+    Many scenarios *are* safe to write surrogates though, due to PEP 538 and
+    PEP 540, including:
+
+    -   Writing to ``stderr``, which uses ``errors="backslashreplace"``.
+    -   The system has ``LANG=C.UTF-8``, ``C``, or ``POSIX``. Python opens
+        stdout and stderr with ``errors="surrogateescape"``.
+    -   None of ``LANG/LC_*`` are set. Python assumes ``LANG=C.UTF-8``.
+    -   Python is started in UTF-8 mode  with  ``PYTHONUTF8=1`` or ``-X utf8``.
+        Python opens stdout and stderr with ``errors="surrogateescape"``.
+
+    :param filename: formats a filename for UI display.  This will also convert
+                     the filename into unicode without failing.
+    :param shorten: this optionally shortens the filename to strip of the
+                    path that leads up to it.
+    """
+    if shorten:
+        filename = os.path.basename(filename)
+    else:
+        filename = os.fspath(filename)
+
+    if isinstance(filename, bytes):
+        filename = filename.decode(sys.getfilesystemencoding(), "replace")
+    else:
+        filename = filename.encode("utf-8", "surrogateescape").decode(
+            "utf-8", "replace"
+        )
+
+    return filename
+
+
+def get_app_dir(app_name: str, roaming: bool = True, force_posix: bool = False) -> str:
+    r"""Returns the config folder for the application.  The default behavior
+    is to return whatever is most appropriate for the operating system.
+
+    To give you an idea, for an app called ``"Foo Bar"``, something like
+    the following folders could be returned:
+
+    Mac OS X:
+      ``~/Library/Application Support/Foo Bar``
+    Mac OS X (POSIX):
+      ``~/.foo-bar``
+    Unix:
+      ``~/.config/foo-bar``
+    Unix (POSIX):
+      ``~/.foo-bar``
+    Windows (roaming):
+      ``C:\Users\<user>\AppData\Roaming\Foo Bar``
+    Windows (not roaming):
+      ``C:\Users\<user>\AppData\Local\Foo Bar``
+
+    .. versionadded:: 2.0
+
+    :param app_name: the application name.  This should be properly capitalized
+                     and can contain whitespace.
+    :param roaming: controls if the folder should be roaming or not on Windows.
+                    Has no effect otherwise.
+    :param force_posix: if this is set to `True` then on any POSIX system the
+                        folder will be stored in the home folder with a leading
+                        dot instead of the XDG config home or darwin's
+                        application support folder.
+    """
+    if WIN:
+        key = "APPDATA" if roaming else "LOCALAPPDATA"
+        folder = os.environ.get(key)
+        if folder is None:
+            folder = os.path.expanduser("~")
+        return os.path.join(folder, app_name)
+    if force_posix:
+        return os.path.join(os.path.expanduser(f"~/.{_posixify(app_name)}"))
+    if sys.platform == "darwin":
+        return os.path.join(
+            os.path.expanduser("~/Library/Application Support"), app_name
+        )
+    return os.path.join(
+        os.environ.get("XDG_CONFIG_HOME", os.path.expanduser("~/.config")),
+        _posixify(app_name),
+    )
+
+
+class PacifyFlushWrapper:
+    """This wrapper is used to catch and suppress BrokenPipeErrors resulting
+    from ``.flush()`` being called on broken pipe during the shutdown/final-GC
+    of the Python interpreter. Notably ``.flush()`` is always called on
+    ``sys.stdout`` and ``sys.stderr``. So as to have minimal impact on any
+    other cleanup code, and the case where the underlying file is not a broken
+    pipe, all calls and attributes are proxied.
+    """
+
+    def __init__(self, wrapped: t.IO[t.Any]) -> None:
+        self.wrapped = wrapped
+
+    def flush(self) -> None:
+        try:
+            self.wrapped.flush()
+        except OSError as e:
+            import errno
+
+            if e.errno != errno.EPIPE:
+                raise
+
+    def __getattr__(self, attr: str) -> t.Any:
+        return getattr(self.wrapped, attr)
+
+
+def _detect_program_name(
+    path: t.Optional[str] = None, _main: t.Optional[ModuleType] = None
+) -> str:
+    """Determine the command used to run the program, for use in help
+    text. If a file or entry point was executed, the file name is
+    returned. If ``python -m`` was used to execute a module or package,
+    ``python -m name`` is returned.
+
+    This doesn't try to be too precise, the goal is to give a concise
+    name for help text. Files are only shown as their name without the
+    path. ``python`` is only shown for modules, and the full path to
+    ``sys.executable`` is not shown.
+
+    :param path: The Python file being executed. Python puts this in
+        ``sys.argv[0]``, which is used by default.
+    :param _main: The ``__main__`` module. This should only be passed
+        during internal testing.
+
+    .. versionadded:: 8.0
+        Based on command args detection in the Werkzeug reloader.
+
+    :meta private:
+    """
+    if _main is None:
+        _main = sys.modules["__main__"]
+
+    if not path:
+        path = sys.argv[0]
+
+    # The value of __package__ indicates how Python was called. It may
+    # not exist if a setuptools script is installed as an egg. It may be
+    # set incorrectly for entry points created with pip on Windows.
+    # It is set to "" inside a Shiv or PEX zipapp.
+    if getattr(_main, "__package__", None) in {None, ""} or (
+        os.name == "nt"
+        and _main.__package__ == ""
+        and not os.path.exists(path)
+        and os.path.exists(f"{path}.exe")
+    ):
+        # Executed a file, like "python app.py".
+        return os.path.basename(path)
+
+    # Executed a module, like "python -m example".
+    # Rewritten by Python from "-m script" to "/path/to/script.py".
+    # Need to look at main module to determine how it was executed.
+    py_module = t.cast(str, _main.__package__)
+    name = os.path.splitext(os.path.basename(path))[0]
+
+    # A submodule like "example.cli".
+    if name != "__main__":
+        py_module = f"{py_module}.{name}"
+
+    return f"python -m {py_module.lstrip('.')}"
+
+
+def _expand_args(
+    args: t.Iterable[str],
+    *,
+    user: bool = True,
+    env: bool = True,
+    glob_recursive: bool = True,
+) -> t.List[str]:
+    """Simulate Unix shell expansion with Python functions.
+
+    See :func:`glob.glob`, :func:`os.path.expanduser`, and
+    :func:`os.path.expandvars`.
+
+    This is intended for use on Windows, where the shell does not do any
+    expansion. It may not exactly match what a Unix shell would do.
+
+    :param args: List of command line arguments to expand.
+    :param user: Expand user home directory.
+    :param env: Expand environment variables.
+    :param glob_recursive: ``**`` matches directories recursively.
+
+    .. versionchanged:: 8.1
+        Invalid glob patterns are treated as empty expansions rather
+        than raising an error.
+
+    .. versionadded:: 8.0
+
+    :meta private:
+    """
+    from glob import glob
+
+    out = []
+
+    for arg in args:
+        if user:
+            arg = os.path.expanduser(arg)
+
+        if env:
+            arg = os.path.expandvars(arg)
+
+        try:
+            matches = glob(arg, recursive=glob_recursive)
+        except re.error:
+            matches = []
+
+        if not matches:
+            out.append(arg)
+        else:
+            out.extend(matches)
+
+    return out
diff --git a/llm/Lib/site-packages/colorama-0.4.6.dist-info/INSTALLER b/llm/Lib/site-packages/colorama-0.4.6.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/colorama-0.4.6.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/colorama-0.4.6.dist-info/METADATA b/llm/Lib/site-packages/colorama-0.4.6.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..a1b5c57543005b310ac2efb02243a6b6ab6d8932
--- /dev/null
+++ b/llm/Lib/site-packages/colorama-0.4.6.dist-info/METADATA
@@ -0,0 +1,441 @@
+Metadata-Version: 2.1
+Name: colorama
+Version: 0.4.6
+Summary: Cross-platform colored terminal text.
+Project-URL: Homepage, https://github.com/tartley/colorama
+Author-email: Jonathan Hartley <tartley@tartley.com>
+License-File: LICENSE.txt
+Keywords: ansi,color,colour,crossplatform,terminal,text,windows,xplatform
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Terminals
+Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7
+Description-Content-Type: text/x-rst
+
+.. image:: https://img.shields.io/pypi/v/colorama.svg
+    :target: https://pypi.org/project/colorama/
+    :alt: Latest Version
+
+.. image:: https://img.shields.io/pypi/pyversions/colorama.svg
+    :target: https://pypi.org/project/colorama/
+    :alt: Supported Python versions
+
+.. image:: https://github.com/tartley/colorama/actions/workflows/test.yml/badge.svg
+    :target: https://github.com/tartley/colorama/actions/workflows/test.yml
+    :alt: Build Status
+
+Colorama
+========
+
+Makes ANSI escape character sequences (for producing colored terminal text and
+cursor positioning) work under MS Windows.
+
+.. |donate| image:: https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif
+  :target: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=2MZ9D2GMLYCUJ&item_name=Colorama&currency_code=USD
+  :alt: Donate with Paypal
+
+`PyPI for releases <https://pypi.org/project/colorama/>`_ |
+`Github for source <https://github.com/tartley/colorama>`_ |
+`Colorama for enterprise on Tidelift <https://github.com/tartley/colorama/blob/master/ENTERPRISE.md>`_
+
+If you find Colorama useful, please |donate| to the authors. Thank you!
+
+Installation
+------------
+
+Tested on CPython 2.7, 3.7, 3.8, 3.9 and 3.10 and Pypy 2.7 and 3.8.
+
+No requirements other than the standard library.
+
+.. code-block:: bash
+
+    pip install colorama
+    # or
+    conda install -c anaconda colorama
+
+Description
+-----------
+
+ANSI escape character sequences have long been used to produce colored terminal
+text and cursor positioning on Unix and Macs. Colorama makes this work on
+Windows, too, by wrapping ``stdout``, stripping ANSI sequences it finds (which
+would appear as gobbledygook in the output), and converting them into the
+appropriate win32 calls to modify the state of the terminal. On other platforms,
+Colorama does nothing.
+
+This has the upshot of providing a simple cross-platform API for printing
+colored terminal text from Python, and has the happy side-effect that existing
+applications or libraries which use ANSI sequences to produce colored output on
+Linux or Macs can now also work on Windows, simply by calling
+``colorama.just_fix_windows_console()`` (since v0.4.6) or ``colorama.init()``
+(all versions, but may have other side-effects – see below).
+
+An alternative approach is to install ``ansi.sys`` on Windows machines, which
+provides the same behaviour for all applications running in terminals. Colorama
+is intended for situations where that isn't easy (e.g., maybe your app doesn't
+have an installer.)
+
+Demo scripts in the source code repository print some colored text using
+ANSI sequences. Compare their output under Gnome-terminal's built in ANSI
+handling, versus on Windows Command-Prompt using Colorama:
+
+.. image:: https://github.com/tartley/colorama/raw/master/screenshots/ubuntu-demo.png
+    :width: 661
+    :height: 357
+    :alt: ANSI sequences on Ubuntu under gnome-terminal.
+
+.. image:: https://github.com/tartley/colorama/raw/master/screenshots/windows-demo.png
+    :width: 668
+    :height: 325
+    :alt: Same ANSI sequences on Windows, using Colorama.
+
+These screenshots show that, on Windows, Colorama does not support ANSI 'dim
+text'; it looks the same as 'normal text'.
+
+Usage
+-----
+
+Initialisation
+..............
+
+If the only thing you want from Colorama is to get ANSI escapes to work on
+Windows, then run:
+
+.. code-block:: python
+
+    from colorama import just_fix_windows_console
+    just_fix_windows_console()
+
+If you're on a recent version of Windows 10 or better, and your stdout/stderr
+are pointing to a Windows console, then this will flip the magic configuration
+switch to enable Windows' built-in ANSI support.
+
+If you're on an older version of Windows, and your stdout/stderr are pointing to
+a Windows console, then this will wrap ``sys.stdout`` and/or ``sys.stderr`` in a
+magic file object that intercepts ANSI escape sequences and issues the
+appropriate Win32 calls to emulate them.
+
+In all other circumstances, it does nothing whatsoever. Basically the idea is
+that this makes Windows act like Unix with respect to ANSI escape handling.
+
+It's safe to call this function multiple times. It's safe to call this function
+on non-Windows platforms, but it won't do anything. It's safe to call this
+function when one or both of your stdout/stderr are redirected to a file – it
+won't do anything to those streams.
+
+Alternatively, you can use the older interface with more features (but also more
+potential footguns):
+
+.. code-block:: python
+
+    from colorama import init
+    init()
+
+This does the same thing as ``just_fix_windows_console``, except for the
+following differences:
+
+- It's not safe to call ``init`` multiple times; you can end up with multiple
+  layers of wrapping and broken ANSI support.
+
+- Colorama will apply a heuristic to guess whether stdout/stderr support ANSI,
+  and if it thinks they don't, then it will wrap ``sys.stdout`` and
+  ``sys.stderr`` in a magic file object that strips out ANSI escape sequences
+  before printing them. This happens on all platforms, and can be convenient if
+  you want to write your code to emit ANSI escape sequences unconditionally, and
+  let Colorama decide whether they should actually be output. But note that
+  Colorama's heuristic is not particularly clever.
+
+- ``init`` also accepts explicit keyword args to enable/disable various
+  functionality – see below.
+
+To stop using Colorama before your program exits, simply call ``deinit()``.
+This will restore ``stdout`` and ``stderr`` to their original values, so that
+Colorama is disabled. To resume using Colorama again, call ``reinit()``; it is
+cheaper than calling ``init()`` again (but does the same thing).
+
+Most users should depend on ``colorama >= 0.4.6``, and use
+``just_fix_windows_console``. The old ``init`` interface will be supported
+indefinitely for backwards compatibility, but we don't plan to fix any issues
+with it, also for backwards compatibility.
+
+Colored Output
+..............
+
+Cross-platform printing of colored text can then be done using Colorama's
+constant shorthand for ANSI escape sequences. These are deliberately
+rudimentary, see below.
+
+.. code-block:: python
+
+    from colorama import Fore, Back, Style
+    print(Fore.RED + 'some red text')
+    print(Back.GREEN + 'and with a green background')
+    print(Style.DIM + 'and in dim text')
+    print(Style.RESET_ALL)
+    print('back to normal now')
+
+...or simply by manually printing ANSI sequences from your own code:
+
+.. code-block:: python
+
+    print('\033[31m' + 'some red text')
+    print('\033[39m') # and reset to default color
+
+...or, Colorama can be used in conjunction with existing ANSI libraries
+such as the venerable `Termcolor <https://pypi.org/project/termcolor/>`_
+the fabulous `Blessings <https://pypi.org/project/blessings/>`_,
+or the incredible `_Rich <https://pypi.org/project/rich/>`_.
+
+If you wish Colorama's Fore, Back and Style constants were more capable,
+then consider using one of the above highly capable libraries to generate
+colors, etc, and use Colorama just for its primary purpose: to convert
+those ANSI sequences to also work on Windows:
+
+SIMILARLY, do not send PRs adding the generation of new ANSI types to Colorama.
+We are only interested in converting ANSI codes to win32 API calls, not
+shortcuts like the above to generate ANSI characters.
+
+.. code-block:: python
+
+    from colorama import just_fix_windows_console
+    from termcolor import colored
+
+    # use Colorama to make Termcolor work on Windows too
+    just_fix_windows_console()
+
+    # then use Termcolor for all colored text output
+    print(colored('Hello, World!', 'green', 'on_red'))
+
+Available formatting constants are::
+
+    Fore: BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE, RESET.
+    Back: BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE, RESET.
+    Style: DIM, NORMAL, BRIGHT, RESET_ALL
+
+``Style.RESET_ALL`` resets foreground, background, and brightness. Colorama will
+perform this reset automatically on program exit.
+
+These are fairly well supported, but not part of the standard::
+
+    Fore: LIGHTBLACK_EX, LIGHTRED_EX, LIGHTGREEN_EX, LIGHTYELLOW_EX, LIGHTBLUE_EX, LIGHTMAGENTA_EX, LIGHTCYAN_EX, LIGHTWHITE_EX
+    Back: LIGHTBLACK_EX, LIGHTRED_EX, LIGHTGREEN_EX, LIGHTYELLOW_EX, LIGHTBLUE_EX, LIGHTMAGENTA_EX, LIGHTCYAN_EX, LIGHTWHITE_EX
+
+Cursor Positioning
+..................
+
+ANSI codes to reposition the cursor are supported. See ``demos/demo06.py`` for
+an example of how to generate them.
+
+Init Keyword Args
+.................
+
+``init()`` accepts some ``**kwargs`` to override default behaviour.
+
+init(autoreset=False):
+    If you find yourself repeatedly sending reset sequences to turn off color
+    changes at the end of every print, then ``init(autoreset=True)`` will
+    automate that:
+
+    .. code-block:: python
+
+        from colorama import init
+        init(autoreset=True)
+        print(Fore.RED + 'some red text')
+        print('automatically back to default color again')
+
+init(strip=None):
+    Pass ``True`` or ``False`` to override whether ANSI codes should be
+    stripped from the output. The default behaviour is to strip if on Windows
+    or if output is redirected (not a tty).
+
+init(convert=None):
+    Pass ``True`` or ``False`` to override whether to convert ANSI codes in the
+    output into win32 calls. The default behaviour is to convert if on Windows
+    and output is to a tty (terminal).
+
+init(wrap=True):
+    On Windows, Colorama works by replacing ``sys.stdout`` and ``sys.stderr``
+    with proxy objects, which override the ``.write()`` method to do their work.
+    If this wrapping causes you problems, then this can be disabled by passing
+    ``init(wrap=False)``. The default behaviour is to wrap if ``autoreset`` or
+    ``strip`` or ``convert`` are True.
+
+    When wrapping is disabled, colored printing on non-Windows platforms will
+    continue to work as normal. To do cross-platform colored output, you can
+    use Colorama's ``AnsiToWin32`` proxy directly:
+
+    .. code-block:: python
+
+        import sys
+        from colorama import init, AnsiToWin32
+        init(wrap=False)
+        stream = AnsiToWin32(sys.stderr).stream
+
+        # Python 2
+        print >>stream, Fore.BLUE + 'blue text on stderr'
+
+        # Python 3
+        print(Fore.BLUE + 'blue text on stderr', file=stream)
+
+Recognised ANSI Sequences
+.........................
+
+ANSI sequences generally take the form::
+
+    ESC [ <param> ; <param> ... <command>
+
+Where ``<param>`` is an integer, and ``<command>`` is a single letter. Zero or
+more params are passed to a ``<command>``. If no params are passed, it is
+generally synonymous with passing a single zero. No spaces exist in the
+sequence; they have been inserted here simply to read more easily.
+
+The only ANSI sequences that Colorama converts into win32 calls are::
+
+    ESC [ 0 m       # reset all (colors and brightness)
+    ESC [ 1 m       # bright
+    ESC [ 2 m       # dim (looks same as normal brightness)
+    ESC [ 22 m      # normal brightness
+
+    # FOREGROUND:
+    ESC [ 30 m      # black
+    ESC [ 31 m      # red
+    ESC [ 32 m      # green
+    ESC [ 33 m      # yellow
+    ESC [ 34 m      # blue
+    ESC [ 35 m      # magenta
+    ESC [ 36 m      # cyan
+    ESC [ 37 m      # white
+    ESC [ 39 m      # reset
+
+    # BACKGROUND
+    ESC [ 40 m      # black
+    ESC [ 41 m      # red
+    ESC [ 42 m      # green
+    ESC [ 43 m      # yellow
+    ESC [ 44 m      # blue
+    ESC [ 45 m      # magenta
+    ESC [ 46 m      # cyan
+    ESC [ 47 m      # white
+    ESC [ 49 m      # reset
+
+    # cursor positioning
+    ESC [ y;x H     # position cursor at x across, y down
+    ESC [ y;x f     # position cursor at x across, y down
+    ESC [ n A       # move cursor n lines up
+    ESC [ n B       # move cursor n lines down
+    ESC [ n C       # move cursor n characters forward
+    ESC [ n D       # move cursor n characters backward
+
+    # clear the screen
+    ESC [ mode J    # clear the screen
+
+    # clear the line
+    ESC [ mode K    # clear the line
+
+Multiple numeric params to the ``'m'`` command can be combined into a single
+sequence::
+
+    ESC [ 36 ; 45 ; 1 m     # bright cyan text on magenta background
+
+All other ANSI sequences of the form ``ESC [ <param> ; <param> ... <command>``
+are silently stripped from the output on Windows.
+
+Any other form of ANSI sequence, such as single-character codes or alternative
+initial characters, are not recognised or stripped. It would be cool to add
+them though. Let me know if it would be useful for you, via the Issues on
+GitHub.
+
+Status & Known Problems
+-----------------------
+
+I've personally only tested it on Windows XP (CMD, Console2), Ubuntu
+(gnome-terminal, xterm), and OS X.
+
+Some valid ANSI sequences aren't recognised.
+
+If you're hacking on the code, see `README-hacking.md`_. ESPECIALLY, see the
+explanation there of why we do not want PRs that allow Colorama to generate new
+types of ANSI codes.
+
+See outstanding issues and wish-list:
+https://github.com/tartley/colorama/issues
+
+If anything doesn't work for you, or doesn't do what you expected or hoped for,
+I'd love to hear about it on that issues list, would be delighted by patches,
+and would be happy to grant commit access to anyone who submits a working patch
+or two.
+
+.. _README-hacking.md: README-hacking.md
+
+License
+-------
+
+Copyright Jonathan Hartley & Arnon Yaari, 2013-2020. BSD 3-Clause license; see
+LICENSE file.
+
+Professional support
+--------------------
+
+.. |tideliftlogo| image:: https://cdn2.hubspot.net/hubfs/4008838/website/logos/logos_for_download/Tidelift_primary-shorthand-logo.png
+   :alt: Tidelift
+   :target: https://tidelift.com/subscription/pkg/pypi-colorama?utm_source=pypi-colorama&utm_medium=referral&utm_campaign=readme
+
+.. list-table::
+   :widths: 10 100
+
+   * - |tideliftlogo|
+     - Professional support for colorama is available as part of the
+       `Tidelift Subscription`_.
+       Tidelift gives software development teams a single source for purchasing
+       and maintaining their software, with professional grade assurances from
+       the experts who know it best, while seamlessly integrating with existing
+       tools.
+
+.. _Tidelift Subscription: https://tidelift.com/subscription/pkg/pypi-colorama?utm_source=pypi-colorama&utm_medium=referral&utm_campaign=readme
+
+Thanks
+------
+
+See the CHANGELOG for more thanks!
+
+* Marc Schlaich (schlamar) for a ``setup.py`` fix for Python2.5.
+* Marc Abramowitz, reported & fixed a crash on exit with closed ``stdout``,
+  providing a solution to issue #7's setuptools/distutils debate,
+  and other fixes.
+* User 'eryksun', for guidance on correctly instantiating ``ctypes.windll``.
+* Matthew McCormick for politely pointing out a longstanding crash on non-Win.
+* Ben Hoyt, for a magnificent fix under 64-bit Windows.
+* Jesse at Empty Square for submitting a fix for examples in the README.
+* User 'jamessp', an observant documentation fix for cursor positioning.
+* User 'vaal1239', Dave Mckee & Lackner Kristof for a tiny but much-needed Win7
+  fix.
+* Julien Stuyck, for wisely suggesting Python3 compatible updates to README.
+* Daniel Griffith for multiple fabulous patches.
+* Oscar Lesta for a valuable fix to stop ANSI chars being sent to non-tty
+  output.
+* Roger Binns, for many suggestions, valuable feedback, & bug reports.
+* Tim Golden for thought and much appreciated feedback on the initial idea.
+* User 'Zearin' for updates to the README file.
+* John Szakmeister for adding support for light colors
+* Charles Merriam for adding documentation to demos
+* Jurko for a fix on 64-bit Windows CPython2.5 w/o ctypes
+* Florian Bruhin for a fix when stdout or stderr are None
+* Thomas Weininger for fixing ValueError on Windows
+* Remi Rampin for better Github integration and fixes to the README file
+* Simeon Visser for closing a file handle using 'with' and updating classifiers
+  to include Python 3.3 and 3.4
+* Andy Neff for fixing RESET of LIGHT_EX colors.
+* Jonathan Hartley for the initial idea and implementation.
diff --git a/llm/Lib/site-packages/colorama-0.4.6.dist-info/RECORD b/llm/Lib/site-packages/colorama-0.4.6.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..6597275e19bbb716f786286a37a3cf88aadf311c
--- /dev/null
+++ b/llm/Lib/site-packages/colorama-0.4.6.dist-info/RECORD
@@ -0,0 +1,31 @@
+colorama-0.4.6.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+colorama-0.4.6.dist-info/METADATA,sha256=e67SnrUMOym9sz_4TjF3vxvAV4T3aF7NyqRHHH3YEMw,17158
+colorama-0.4.6.dist-info/RECORD,,
+colorama-0.4.6.dist-info/WHEEL,sha256=cdcF4Fbd0FPtw2EMIOwH-3rSOTUdTCeOSXRMD1iLUb8,105
+colorama-0.4.6.dist-info/licenses/LICENSE.txt,sha256=ysNcAmhuXQSlpxQL-zs25zrtSWZW6JEQLkKIhteTAxg,1491
+colorama/__init__.py,sha256=wePQA4U20tKgYARySLEC047ucNX-g8pRLpYBuiHlLb8,266
+colorama/__pycache__/__init__.cpython-311.pyc,,
+colorama/__pycache__/ansi.cpython-311.pyc,,
+colorama/__pycache__/ansitowin32.cpython-311.pyc,,
+colorama/__pycache__/initialise.cpython-311.pyc,,
+colorama/__pycache__/win32.cpython-311.pyc,,
+colorama/__pycache__/winterm.cpython-311.pyc,,
+colorama/ansi.py,sha256=Top4EeEuaQdBWdteKMEcGOTeKeF19Q-Wo_6_Cj5kOzQ,2522
+colorama/ansitowin32.py,sha256=vPNYa3OZbxjbuFyaVo0Tmhmy1FZ1lKMWCnT7odXpItk,11128
+colorama/initialise.py,sha256=-hIny86ClXo39ixh5iSCfUIa2f_h_bgKRDW7gqs-KLU,3325
+colorama/tests/__init__.py,sha256=MkgPAEzGQd-Rq0w0PZXSX2LadRWhUECcisJY8lSrm4Q,75
+colorama/tests/__pycache__/__init__.cpython-311.pyc,,
+colorama/tests/__pycache__/ansi_test.cpython-311.pyc,,
+colorama/tests/__pycache__/ansitowin32_test.cpython-311.pyc,,
+colorama/tests/__pycache__/initialise_test.cpython-311.pyc,,
+colorama/tests/__pycache__/isatty_test.cpython-311.pyc,,
+colorama/tests/__pycache__/utils.cpython-311.pyc,,
+colorama/tests/__pycache__/winterm_test.cpython-311.pyc,,
+colorama/tests/ansi_test.py,sha256=FeViDrUINIZcr505PAxvU4AjXz1asEiALs9GXMhwRaE,2839
+colorama/tests/ansitowin32_test.py,sha256=RN7AIhMJ5EqDsYaCjVo-o4u8JzDD4ukJbmevWKS70rY,10678
+colorama/tests/initialise_test.py,sha256=BbPy-XfyHwJ6zKozuQOvNvQZzsx9vdb_0bYXn7hsBTc,6741
+colorama/tests/isatty_test.py,sha256=Pg26LRpv0yQDB5Ac-sxgVXG7hsA1NYvapFgApZfYzZg,1866
+colorama/tests/utils.py,sha256=1IIRylG39z5-dzq09R_ngufxyPZxgldNbrxKxUGwGKE,1079
+colorama/tests/winterm_test.py,sha256=qoWFPEjym5gm2RuMwpf3pOis3a5r_PJZFCzK254JL8A,3709
+colorama/win32.py,sha256=YQOKwMTwtGBbsY4dL5HYTvwTeP9wIQra5MvPNddpxZs,6181
+colorama/winterm.py,sha256=XCQFDHjPi6AHYNdZwy0tA02H-Jh48Jp-HvCjeLeLp3U,7134
diff --git a/llm/Lib/site-packages/colorama-0.4.6.dist-info/WHEEL b/llm/Lib/site-packages/colorama-0.4.6.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..d79189fda3251187de18c3998f23ae6fec11b20f
--- /dev/null
+++ b/llm/Lib/site-packages/colorama-0.4.6.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.11.1
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/colorama-0.4.6.dist-info/licenses/LICENSE.txt b/llm/Lib/site-packages/colorama-0.4.6.dist-info/licenses/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..3105888ec149d10cad51c11d332779e94b548661
--- /dev/null
+++ b/llm/Lib/site-packages/colorama-0.4.6.dist-info/licenses/LICENSE.txt
@@ -0,0 +1,27 @@
+Copyright (c) 2010 Jonathan Hartley
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holders, nor those of its contributors
+  may be used to endorse or promote products derived from this software without
+  specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/llm/Lib/site-packages/colorama/__init__.py b/llm/Lib/site-packages/colorama/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..383101cdb38706c305449674044e9288b92b7d75
--- /dev/null
+++ b/llm/Lib/site-packages/colorama/__init__.py
@@ -0,0 +1,7 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+from .initialise import init, deinit, reinit, colorama_text, just_fix_windows_console
+from .ansi import Fore, Back, Style, Cursor
+from .ansitowin32 import AnsiToWin32
+
+__version__ = '0.4.6'
+
diff --git a/llm/Lib/site-packages/colorama/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/colorama/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..665fb6d6c1a372f31486e194a31af67440d53eee
Binary files /dev/null and b/llm/Lib/site-packages/colorama/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/colorama/__pycache__/ansi.cpython-311.pyc b/llm/Lib/site-packages/colorama/__pycache__/ansi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3f281c5d70eea013bfd923a0c5c33c78e46ca7d6
Binary files /dev/null and b/llm/Lib/site-packages/colorama/__pycache__/ansi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/colorama/__pycache__/ansitowin32.cpython-311.pyc b/llm/Lib/site-packages/colorama/__pycache__/ansitowin32.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7202ab811fac94ffe495d9cade498089c2ebd6b1
Binary files /dev/null and b/llm/Lib/site-packages/colorama/__pycache__/ansitowin32.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/colorama/__pycache__/initialise.cpython-311.pyc b/llm/Lib/site-packages/colorama/__pycache__/initialise.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d0442f89c5cbd7f3d0d27b2e043fe7d77e0dc867
Binary files /dev/null and b/llm/Lib/site-packages/colorama/__pycache__/initialise.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/colorama/__pycache__/win32.cpython-311.pyc b/llm/Lib/site-packages/colorama/__pycache__/win32.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..832649ee2ab42afe0e1771325abb32267d41f3f0
Binary files /dev/null and b/llm/Lib/site-packages/colorama/__pycache__/win32.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/colorama/__pycache__/winterm.cpython-311.pyc b/llm/Lib/site-packages/colorama/__pycache__/winterm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..10226d9b58b614da5b9e88add7c8b09c0a000ab4
Binary files /dev/null and b/llm/Lib/site-packages/colorama/__pycache__/winterm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/colorama/ansi.py b/llm/Lib/site-packages/colorama/ansi.py
new file mode 100644
index 0000000000000000000000000000000000000000..11ec695ff79627463a0282d25079527562de9e42
--- /dev/null
+++ b/llm/Lib/site-packages/colorama/ansi.py
@@ -0,0 +1,102 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+'''
+This module generates ANSI character codes to printing colors to terminals.
+See: http://en.wikipedia.org/wiki/ANSI_escape_code
+'''
+
+CSI = '\033['
+OSC = '\033]'
+BEL = '\a'
+
+
+def code_to_chars(code):
+    return CSI + str(code) + 'm'
+
+def set_title(title):
+    return OSC + '2;' + title + BEL
+
+def clear_screen(mode=2):
+    return CSI + str(mode) + 'J'
+
+def clear_line(mode=2):
+    return CSI + str(mode) + 'K'
+
+
+class AnsiCodes(object):
+    def __init__(self):
+        # the subclasses declare class attributes which are numbers.
+        # Upon instantiation we define instance attributes, which are the same
+        # as the class attributes but wrapped with the ANSI escape sequence
+        for name in dir(self):
+            if not name.startswith('_'):
+                value = getattr(self, name)
+                setattr(self, name, code_to_chars(value))
+
+
+class AnsiCursor(object):
+    def UP(self, n=1):
+        return CSI + str(n) + 'A'
+    def DOWN(self, n=1):
+        return CSI + str(n) + 'B'
+    def FORWARD(self, n=1):
+        return CSI + str(n) + 'C'
+    def BACK(self, n=1):
+        return CSI + str(n) + 'D'
+    def POS(self, x=1, y=1):
+        return CSI + str(y) + ';' + str(x) + 'H'
+
+
+class AnsiFore(AnsiCodes):
+    BLACK           = 30
+    RED             = 31
+    GREEN           = 32
+    YELLOW          = 33
+    BLUE            = 34
+    MAGENTA         = 35
+    CYAN            = 36
+    WHITE           = 37
+    RESET           = 39
+
+    # These are fairly well supported, but not part of the standard.
+    LIGHTBLACK_EX   = 90
+    LIGHTRED_EX     = 91
+    LIGHTGREEN_EX   = 92
+    LIGHTYELLOW_EX  = 93
+    LIGHTBLUE_EX    = 94
+    LIGHTMAGENTA_EX = 95
+    LIGHTCYAN_EX    = 96
+    LIGHTWHITE_EX   = 97
+
+
+class AnsiBack(AnsiCodes):
+    BLACK           = 40
+    RED             = 41
+    GREEN           = 42
+    YELLOW          = 43
+    BLUE            = 44
+    MAGENTA         = 45
+    CYAN            = 46
+    WHITE           = 47
+    RESET           = 49
+
+    # These are fairly well supported, but not part of the standard.
+    LIGHTBLACK_EX   = 100
+    LIGHTRED_EX     = 101
+    LIGHTGREEN_EX   = 102
+    LIGHTYELLOW_EX  = 103
+    LIGHTBLUE_EX    = 104
+    LIGHTMAGENTA_EX = 105
+    LIGHTCYAN_EX    = 106
+    LIGHTWHITE_EX   = 107
+
+
+class AnsiStyle(AnsiCodes):
+    BRIGHT    = 1
+    DIM       = 2
+    NORMAL    = 22
+    RESET_ALL = 0
+
+Fore   = AnsiFore()
+Back   = AnsiBack()
+Style  = AnsiStyle()
+Cursor = AnsiCursor()
diff --git a/llm/Lib/site-packages/colorama/ansitowin32.py b/llm/Lib/site-packages/colorama/ansitowin32.py
new file mode 100644
index 0000000000000000000000000000000000000000..abf209e60c7c4a9b1ae57452e36b383969848c2e
--- /dev/null
+++ b/llm/Lib/site-packages/colorama/ansitowin32.py
@@ -0,0 +1,277 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+import re
+import sys
+import os
+
+from .ansi import AnsiFore, AnsiBack, AnsiStyle, Style, BEL
+from .winterm import enable_vt_processing, WinTerm, WinColor, WinStyle
+from .win32 import windll, winapi_test
+
+
+winterm = None
+if windll is not None:
+    winterm = WinTerm()
+
+
+class StreamWrapper(object):
+    '''
+    Wraps a stream (such as stdout), acting as a transparent proxy for all
+    attribute access apart from method 'write()', which is delegated to our
+    Converter instance.
+    '''
+    def __init__(self, wrapped, converter):
+        # double-underscore everything to prevent clashes with names of
+        # attributes on the wrapped stream object.
+        self.__wrapped = wrapped
+        self.__convertor = converter
+
+    def __getattr__(self, name):
+        return getattr(self.__wrapped, name)
+
+    def __enter__(self, *args, **kwargs):
+        # special method lookup bypasses __getattr__/__getattribute__, see
+        # https://stackoverflow.com/questions/12632894/why-doesnt-getattr-work-with-exit
+        # thus, contextlib magic methods are not proxied via __getattr__
+        return self.__wrapped.__enter__(*args, **kwargs)
+
+    def __exit__(self, *args, **kwargs):
+        return self.__wrapped.__exit__(*args, **kwargs)
+
+    def __setstate__(self, state):
+        self.__dict__ = state
+
+    def __getstate__(self):
+        return self.__dict__
+
+    def write(self, text):
+        self.__convertor.write(text)
+
+    def isatty(self):
+        stream = self.__wrapped
+        if 'PYCHARM_HOSTED' in os.environ:
+            if stream is not None and (stream is sys.__stdout__ or stream is sys.__stderr__):
+                return True
+        try:
+            stream_isatty = stream.isatty
+        except AttributeError:
+            return False
+        else:
+            return stream_isatty()
+
+    @property
+    def closed(self):
+        stream = self.__wrapped
+        try:
+            return stream.closed
+        # AttributeError in the case that the stream doesn't support being closed
+        # ValueError for the case that the stream has already been detached when atexit runs
+        except (AttributeError, ValueError):
+            return True
+
+
+class AnsiToWin32(object):
+    '''
+    Implements a 'write()' method which, on Windows, will strip ANSI character
+    sequences from the text, and if outputting to a tty, will convert them into
+    win32 function calls.
+    '''
+    ANSI_CSI_RE = re.compile('\001?\033\\[((?:\\d|;)*)([a-zA-Z])\002?')   # Control Sequence Introducer
+    ANSI_OSC_RE = re.compile('\001?\033\\]([^\a]*)(\a)\002?')             # Operating System Command
+
+    def __init__(self, wrapped, convert=None, strip=None, autoreset=False):
+        # The wrapped stream (normally sys.stdout or sys.stderr)
+        self.wrapped = wrapped
+
+        # should we reset colors to defaults after every .write()
+        self.autoreset = autoreset
+
+        # create the proxy wrapping our output stream
+        self.stream = StreamWrapper(wrapped, self)
+
+        on_windows = os.name == 'nt'
+        # We test if the WinAPI works, because even if we are on Windows
+        # we may be using a terminal that doesn't support the WinAPI
+        # (e.g. Cygwin Terminal). In this case it's up to the terminal
+        # to support the ANSI codes.
+        conversion_supported = on_windows and winapi_test()
+        try:
+            fd = wrapped.fileno()
+        except Exception:
+            fd = -1
+        system_has_native_ansi = not on_windows or enable_vt_processing(fd)
+        have_tty = not self.stream.closed and self.stream.isatty()
+        need_conversion = conversion_supported and not system_has_native_ansi
+
+        # should we strip ANSI sequences from our output?
+        if strip is None:
+            strip = need_conversion or not have_tty
+        self.strip = strip
+
+        # should we should convert ANSI sequences into win32 calls?
+        if convert is None:
+            convert = need_conversion and have_tty
+        self.convert = convert
+
+        # dict of ansi codes to win32 functions and parameters
+        self.win32_calls = self.get_win32_calls()
+
+        # are we wrapping stderr?
+        self.on_stderr = self.wrapped is sys.stderr
+
+    def should_wrap(self):
+        '''
+        True if this class is actually needed. If false, then the output
+        stream will not be affected, nor will win32 calls be issued, so
+        wrapping stdout is not actually required. This will generally be
+        False on non-Windows platforms, unless optional functionality like
+        autoreset has been requested using kwargs to init()
+        '''
+        return self.convert or self.strip or self.autoreset
+
+    def get_win32_calls(self):
+        if self.convert and winterm:
+            return {
+                AnsiStyle.RESET_ALL: (winterm.reset_all, ),
+                AnsiStyle.BRIGHT: (winterm.style, WinStyle.BRIGHT),
+                AnsiStyle.DIM: (winterm.style, WinStyle.NORMAL),
+                AnsiStyle.NORMAL: (winterm.style, WinStyle.NORMAL),
+                AnsiFore.BLACK: (winterm.fore, WinColor.BLACK),
+                AnsiFore.RED: (winterm.fore, WinColor.RED),
+                AnsiFore.GREEN: (winterm.fore, WinColor.GREEN),
+                AnsiFore.YELLOW: (winterm.fore, WinColor.YELLOW),
+                AnsiFore.BLUE: (winterm.fore, WinColor.BLUE),
+                AnsiFore.MAGENTA: (winterm.fore, WinColor.MAGENTA),
+                AnsiFore.CYAN: (winterm.fore, WinColor.CYAN),
+                AnsiFore.WHITE: (winterm.fore, WinColor.GREY),
+                AnsiFore.RESET: (winterm.fore, ),
+                AnsiFore.LIGHTBLACK_EX: (winterm.fore, WinColor.BLACK, True),
+                AnsiFore.LIGHTRED_EX: (winterm.fore, WinColor.RED, True),
+                AnsiFore.LIGHTGREEN_EX: (winterm.fore, WinColor.GREEN, True),
+                AnsiFore.LIGHTYELLOW_EX: (winterm.fore, WinColor.YELLOW, True),
+                AnsiFore.LIGHTBLUE_EX: (winterm.fore, WinColor.BLUE, True),
+                AnsiFore.LIGHTMAGENTA_EX: (winterm.fore, WinColor.MAGENTA, True),
+                AnsiFore.LIGHTCYAN_EX: (winterm.fore, WinColor.CYAN, True),
+                AnsiFore.LIGHTWHITE_EX: (winterm.fore, WinColor.GREY, True),
+                AnsiBack.BLACK: (winterm.back, WinColor.BLACK),
+                AnsiBack.RED: (winterm.back, WinColor.RED),
+                AnsiBack.GREEN: (winterm.back, WinColor.GREEN),
+                AnsiBack.YELLOW: (winterm.back, WinColor.YELLOW),
+                AnsiBack.BLUE: (winterm.back, WinColor.BLUE),
+                AnsiBack.MAGENTA: (winterm.back, WinColor.MAGENTA),
+                AnsiBack.CYAN: (winterm.back, WinColor.CYAN),
+                AnsiBack.WHITE: (winterm.back, WinColor.GREY),
+                AnsiBack.RESET: (winterm.back, ),
+                AnsiBack.LIGHTBLACK_EX: (winterm.back, WinColor.BLACK, True),
+                AnsiBack.LIGHTRED_EX: (winterm.back, WinColor.RED, True),
+                AnsiBack.LIGHTGREEN_EX: (winterm.back, WinColor.GREEN, True),
+                AnsiBack.LIGHTYELLOW_EX: (winterm.back, WinColor.YELLOW, True),
+                AnsiBack.LIGHTBLUE_EX: (winterm.back, WinColor.BLUE, True),
+                AnsiBack.LIGHTMAGENTA_EX: (winterm.back, WinColor.MAGENTA, True),
+                AnsiBack.LIGHTCYAN_EX: (winterm.back, WinColor.CYAN, True),
+                AnsiBack.LIGHTWHITE_EX: (winterm.back, WinColor.GREY, True),
+            }
+        return dict()
+
+    def write(self, text):
+        if self.strip or self.convert:
+            self.write_and_convert(text)
+        else:
+            self.wrapped.write(text)
+            self.wrapped.flush()
+        if self.autoreset:
+            self.reset_all()
+
+
+    def reset_all(self):
+        if self.convert:
+            self.call_win32('m', (0,))
+        elif not self.strip and not self.stream.closed:
+            self.wrapped.write(Style.RESET_ALL)
+
+
+    def write_and_convert(self, text):
+        '''
+        Write the given text to our wrapped stream, stripping any ANSI
+        sequences from the text, and optionally converting them into win32
+        calls.
+        '''
+        cursor = 0
+        text = self.convert_osc(text)
+        for match in self.ANSI_CSI_RE.finditer(text):
+            start, end = match.span()
+            self.write_plain_text(text, cursor, start)
+            self.convert_ansi(*match.groups())
+            cursor = end
+        self.write_plain_text(text, cursor, len(text))
+
+
+    def write_plain_text(self, text, start, end):
+        if start < end:
+            self.wrapped.write(text[start:end])
+            self.wrapped.flush()
+
+
+    def convert_ansi(self, paramstring, command):
+        if self.convert:
+            params = self.extract_params(command, paramstring)
+            self.call_win32(command, params)
+
+
+    def extract_params(self, command, paramstring):
+        if command in 'Hf':
+            params = tuple(int(p) if len(p) != 0 else 1 for p in paramstring.split(';'))
+            while len(params) < 2:
+                # defaults:
+                params = params + (1,)
+        else:
+            params = tuple(int(p) for p in paramstring.split(';') if len(p) != 0)
+            if len(params) == 0:
+                # defaults:
+                if command in 'JKm':
+                    params = (0,)
+                elif command in 'ABCD':
+                    params = (1,)
+
+        return params
+
+
+    def call_win32(self, command, params):
+        if command == 'm':
+            for param in params:
+                if param in self.win32_calls:
+                    func_args = self.win32_calls[param]
+                    func = func_args[0]
+                    args = func_args[1:]
+                    kwargs = dict(on_stderr=self.on_stderr)
+                    func(*args, **kwargs)
+        elif command in 'J':
+            winterm.erase_screen(params[0], on_stderr=self.on_stderr)
+        elif command in 'K':
+            winterm.erase_line(params[0], on_stderr=self.on_stderr)
+        elif command in 'Hf':     # cursor position - absolute
+            winterm.set_cursor_position(params, on_stderr=self.on_stderr)
+        elif command in 'ABCD':   # cursor position - relative
+            n = params[0]
+            # A - up, B - down, C - forward, D - back
+            x, y = {'A': (0, -n), 'B': (0, n), 'C': (n, 0), 'D': (-n, 0)}[command]
+            winterm.cursor_adjust(x, y, on_stderr=self.on_stderr)
+
+
+    def convert_osc(self, text):
+        for match in self.ANSI_OSC_RE.finditer(text):
+            start, end = match.span()
+            text = text[:start] + text[end:]
+            paramstring, command = match.groups()
+            if command == BEL:
+                if paramstring.count(";") == 1:
+                    params = paramstring.split(";")
+                    # 0 - change title and icon (we will only change title)
+                    # 1 - change icon (we don't support this)
+                    # 2 - change title
+                    if params[0] in '02':
+                        winterm.set_title(params[1])
+        return text
+
+
+    def flush(self):
+        self.wrapped.flush()
diff --git a/llm/Lib/site-packages/colorama/initialise.py b/llm/Lib/site-packages/colorama/initialise.py
new file mode 100644
index 0000000000000000000000000000000000000000..d5fd4b71fed1bb4871717f978f0c470280f099c1
--- /dev/null
+++ b/llm/Lib/site-packages/colorama/initialise.py
@@ -0,0 +1,121 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+import atexit
+import contextlib
+import sys
+
+from .ansitowin32 import AnsiToWin32
+
+
+def _wipe_internal_state_for_tests():
+    global orig_stdout, orig_stderr
+    orig_stdout = None
+    orig_stderr = None
+
+    global wrapped_stdout, wrapped_stderr
+    wrapped_stdout = None
+    wrapped_stderr = None
+
+    global atexit_done
+    atexit_done = False
+
+    global fixed_windows_console
+    fixed_windows_console = False
+
+    try:
+        # no-op if it wasn't registered
+        atexit.unregister(reset_all)
+    except AttributeError:
+        # python 2: no atexit.unregister. Oh well, we did our best.
+        pass
+
+
+def reset_all():
+    if AnsiToWin32 is not None:    # Issue #74: objects might become None at exit
+        AnsiToWin32(orig_stdout).reset_all()
+
+
+def init(autoreset=False, convert=None, strip=None, wrap=True):
+
+    if not wrap and any([autoreset, convert, strip]):
+        raise ValueError('wrap=False conflicts with any other arg=True')
+
+    global wrapped_stdout, wrapped_stderr
+    global orig_stdout, orig_stderr
+
+    orig_stdout = sys.stdout
+    orig_stderr = sys.stderr
+
+    if sys.stdout is None:
+        wrapped_stdout = None
+    else:
+        sys.stdout = wrapped_stdout = \
+            wrap_stream(orig_stdout, convert, strip, autoreset, wrap)
+    if sys.stderr is None:
+        wrapped_stderr = None
+    else:
+        sys.stderr = wrapped_stderr = \
+            wrap_stream(orig_stderr, convert, strip, autoreset, wrap)
+
+    global atexit_done
+    if not atexit_done:
+        atexit.register(reset_all)
+        atexit_done = True
+
+
+def deinit():
+    if orig_stdout is not None:
+        sys.stdout = orig_stdout
+    if orig_stderr is not None:
+        sys.stderr = orig_stderr
+
+
+def just_fix_windows_console():
+    global fixed_windows_console
+
+    if sys.platform != "win32":
+        return
+    if fixed_windows_console:
+        return
+    if wrapped_stdout is not None or wrapped_stderr is not None:
+        # Someone already ran init() and it did stuff, so we won't second-guess them
+        return
+
+    # On newer versions of Windows, AnsiToWin32.__init__ will implicitly enable the
+    # native ANSI support in the console as a side-effect. We only need to actually
+    # replace sys.stdout/stderr if we're in the old-style conversion mode.
+    new_stdout = AnsiToWin32(sys.stdout, convert=None, strip=None, autoreset=False)
+    if new_stdout.convert:
+        sys.stdout = new_stdout
+    new_stderr = AnsiToWin32(sys.stderr, convert=None, strip=None, autoreset=False)
+    if new_stderr.convert:
+        sys.stderr = new_stderr
+
+    fixed_windows_console = True
+
+@contextlib.contextmanager
+def colorama_text(*args, **kwargs):
+    init(*args, **kwargs)
+    try:
+        yield
+    finally:
+        deinit()
+
+
+def reinit():
+    if wrapped_stdout is not None:
+        sys.stdout = wrapped_stdout
+    if wrapped_stderr is not None:
+        sys.stderr = wrapped_stderr
+
+
+def wrap_stream(stream, convert, strip, autoreset, wrap):
+    if wrap:
+        wrapper = AnsiToWin32(stream,
+            convert=convert, strip=strip, autoreset=autoreset)
+        if wrapper.should_wrap():
+            stream = wrapper.stream
+    return stream
+
+
+# Use this for initial setup as well, to reduce code duplication
+_wipe_internal_state_for_tests()
diff --git a/llm/Lib/site-packages/colorama/tests/__init__.py b/llm/Lib/site-packages/colorama/tests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..8c5661e93a205bf4fb22404d4fc50f902cc31369
--- /dev/null
+++ b/llm/Lib/site-packages/colorama/tests/__init__.py
@@ -0,0 +1 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
diff --git a/llm/Lib/site-packages/colorama/tests/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/colorama/tests/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cb82cf1cbfb19340a4ed955b1cf776d133fe60d1
Binary files /dev/null and b/llm/Lib/site-packages/colorama/tests/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/colorama/tests/__pycache__/ansi_test.cpython-311.pyc b/llm/Lib/site-packages/colorama/tests/__pycache__/ansi_test.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..97e819352e52e0c781c3218dba72f3cfb17b1cbb
Binary files /dev/null and b/llm/Lib/site-packages/colorama/tests/__pycache__/ansi_test.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/colorama/tests/__pycache__/ansitowin32_test.cpython-311.pyc b/llm/Lib/site-packages/colorama/tests/__pycache__/ansitowin32_test.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..717064e71c1a431f4eac54471218c683fd7b35e8
Binary files /dev/null and b/llm/Lib/site-packages/colorama/tests/__pycache__/ansitowin32_test.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/colorama/tests/__pycache__/initialise_test.cpython-311.pyc b/llm/Lib/site-packages/colorama/tests/__pycache__/initialise_test.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cbbd6247eebd8a9eb3a6904c69f02abf55908eac
Binary files /dev/null and b/llm/Lib/site-packages/colorama/tests/__pycache__/initialise_test.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/colorama/tests/__pycache__/isatty_test.cpython-311.pyc b/llm/Lib/site-packages/colorama/tests/__pycache__/isatty_test.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7722c41791b9c586e75442be5983e027a29ac31b
Binary files /dev/null and b/llm/Lib/site-packages/colorama/tests/__pycache__/isatty_test.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/colorama/tests/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/colorama/tests/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b1f9cee29e961e95a0a1f8d9eb860ddadf121bc1
Binary files /dev/null and b/llm/Lib/site-packages/colorama/tests/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/colorama/tests/__pycache__/winterm_test.cpython-311.pyc b/llm/Lib/site-packages/colorama/tests/__pycache__/winterm_test.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9e990635d9b86bbdfb25425c69c797308811c392
Binary files /dev/null and b/llm/Lib/site-packages/colorama/tests/__pycache__/winterm_test.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/colorama/tests/ansi_test.py b/llm/Lib/site-packages/colorama/tests/ansi_test.py
new file mode 100644
index 0000000000000000000000000000000000000000..0a20c80f882066e0e1323b0c7f61e22913c32e35
--- /dev/null
+++ b/llm/Lib/site-packages/colorama/tests/ansi_test.py
@@ -0,0 +1,76 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+import sys
+from unittest import TestCase, main
+
+from ..ansi import Back, Fore, Style
+from ..ansitowin32 import AnsiToWin32
+
+stdout_orig = sys.stdout
+stderr_orig = sys.stderr
+
+
+class AnsiTest(TestCase):
+
+    def setUp(self):
+        # sanity check: stdout should be a file or StringIO object.
+        # It will only be AnsiToWin32 if init() has previously wrapped it
+        self.assertNotEqual(type(sys.stdout), AnsiToWin32)
+        self.assertNotEqual(type(sys.stderr), AnsiToWin32)
+
+    def tearDown(self):
+        sys.stdout = stdout_orig
+        sys.stderr = stderr_orig
+
+
+    def testForeAttributes(self):
+        self.assertEqual(Fore.BLACK, '\033[30m')
+        self.assertEqual(Fore.RED, '\033[31m')
+        self.assertEqual(Fore.GREEN, '\033[32m')
+        self.assertEqual(Fore.YELLOW, '\033[33m')
+        self.assertEqual(Fore.BLUE, '\033[34m')
+        self.assertEqual(Fore.MAGENTA, '\033[35m')
+        self.assertEqual(Fore.CYAN, '\033[36m')
+        self.assertEqual(Fore.WHITE, '\033[37m')
+        self.assertEqual(Fore.RESET, '\033[39m')
+
+        # Check the light, extended versions.
+        self.assertEqual(Fore.LIGHTBLACK_EX, '\033[90m')
+        self.assertEqual(Fore.LIGHTRED_EX, '\033[91m')
+        self.assertEqual(Fore.LIGHTGREEN_EX, '\033[92m')
+        self.assertEqual(Fore.LIGHTYELLOW_EX, '\033[93m')
+        self.assertEqual(Fore.LIGHTBLUE_EX, '\033[94m')
+        self.assertEqual(Fore.LIGHTMAGENTA_EX, '\033[95m')
+        self.assertEqual(Fore.LIGHTCYAN_EX, '\033[96m')
+        self.assertEqual(Fore.LIGHTWHITE_EX, '\033[97m')
+
+
+    def testBackAttributes(self):
+        self.assertEqual(Back.BLACK, '\033[40m')
+        self.assertEqual(Back.RED, '\033[41m')
+        self.assertEqual(Back.GREEN, '\033[42m')
+        self.assertEqual(Back.YELLOW, '\033[43m')
+        self.assertEqual(Back.BLUE, '\033[44m')
+        self.assertEqual(Back.MAGENTA, '\033[45m')
+        self.assertEqual(Back.CYAN, '\033[46m')
+        self.assertEqual(Back.WHITE, '\033[47m')
+        self.assertEqual(Back.RESET, '\033[49m')
+
+        # Check the light, extended versions.
+        self.assertEqual(Back.LIGHTBLACK_EX, '\033[100m')
+        self.assertEqual(Back.LIGHTRED_EX, '\033[101m')
+        self.assertEqual(Back.LIGHTGREEN_EX, '\033[102m')
+        self.assertEqual(Back.LIGHTYELLOW_EX, '\033[103m')
+        self.assertEqual(Back.LIGHTBLUE_EX, '\033[104m')
+        self.assertEqual(Back.LIGHTMAGENTA_EX, '\033[105m')
+        self.assertEqual(Back.LIGHTCYAN_EX, '\033[106m')
+        self.assertEqual(Back.LIGHTWHITE_EX, '\033[107m')
+
+
+    def testStyleAttributes(self):
+        self.assertEqual(Style.DIM, '\033[2m')
+        self.assertEqual(Style.NORMAL, '\033[22m')
+        self.assertEqual(Style.BRIGHT, '\033[1m')
+
+
+if __name__ == '__main__':
+    main()
diff --git a/llm/Lib/site-packages/colorama/tests/ansitowin32_test.py b/llm/Lib/site-packages/colorama/tests/ansitowin32_test.py
new file mode 100644
index 0000000000000000000000000000000000000000..91ca551f97b4576c680711e826a1855fb944c872
--- /dev/null
+++ b/llm/Lib/site-packages/colorama/tests/ansitowin32_test.py
@@ -0,0 +1,294 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+from io import StringIO, TextIOWrapper
+from unittest import TestCase, main
+try:
+    from contextlib import ExitStack
+except ImportError:
+    # python 2
+    from contextlib2 import ExitStack
+
+try:
+    from unittest.mock import MagicMock, Mock, patch
+except ImportError:
+    from mock import MagicMock, Mock, patch
+
+from ..ansitowin32 import AnsiToWin32, StreamWrapper
+from ..win32 import ENABLE_VIRTUAL_TERMINAL_PROCESSING
+from .utils import osname
+
+
+class StreamWrapperTest(TestCase):
+
+    def testIsAProxy(self):
+        mockStream = Mock()
+        wrapper = StreamWrapper(mockStream, None)
+        self.assertTrue( wrapper.random_attr is mockStream.random_attr )
+
+    def testDelegatesWrite(self):
+        mockStream = Mock()
+        mockConverter = Mock()
+        wrapper = StreamWrapper(mockStream, mockConverter)
+        wrapper.write('hello')
+        self.assertTrue(mockConverter.write.call_args, (('hello',), {}))
+
+    def testDelegatesContext(self):
+        mockConverter = Mock()
+        s = StringIO()
+        with StreamWrapper(s, mockConverter) as fp:
+            fp.write(u'hello')
+        self.assertTrue(s.closed)
+
+    def testProxyNoContextManager(self):
+        mockStream = MagicMock()
+        mockStream.__enter__.side_effect = AttributeError()
+        mockConverter = Mock()
+        with self.assertRaises(AttributeError) as excinfo:
+            with StreamWrapper(mockStream, mockConverter) as wrapper:
+                wrapper.write('hello')
+
+    def test_closed_shouldnt_raise_on_closed_stream(self):
+        stream = StringIO()
+        stream.close()
+        wrapper = StreamWrapper(stream, None)
+        self.assertEqual(wrapper.closed, True)
+
+    def test_closed_shouldnt_raise_on_detached_stream(self):
+        stream = TextIOWrapper(StringIO())
+        stream.detach()
+        wrapper = StreamWrapper(stream, None)
+        self.assertEqual(wrapper.closed, True)
+
+class AnsiToWin32Test(TestCase):
+
+    def testInit(self):
+        mockStdout = Mock()
+        auto = Mock()
+        stream = AnsiToWin32(mockStdout, autoreset=auto)
+        self.assertEqual(stream.wrapped, mockStdout)
+        self.assertEqual(stream.autoreset, auto)
+
+    @patch('colorama.ansitowin32.winterm', None)
+    @patch('colorama.ansitowin32.winapi_test', lambda *_: True)
+    def testStripIsTrueOnWindows(self):
+        with osname('nt'):
+            mockStdout = Mock()
+            stream = AnsiToWin32(mockStdout)
+            self.assertTrue(stream.strip)
+
+    def testStripIsFalseOffWindows(self):
+        with osname('posix'):
+            mockStdout = Mock(closed=False)
+            stream = AnsiToWin32(mockStdout)
+            self.assertFalse(stream.strip)
+
+    def testWriteStripsAnsi(self):
+        mockStdout = Mock()
+        stream = AnsiToWin32(mockStdout)
+        stream.wrapped = Mock()
+        stream.write_and_convert = Mock()
+        stream.strip = True
+
+        stream.write('abc')
+
+        self.assertFalse(stream.wrapped.write.called)
+        self.assertEqual(stream.write_and_convert.call_args, (('abc',), {}))
+
+    def testWriteDoesNotStripAnsi(self):
+        mockStdout = Mock()
+        stream = AnsiToWin32(mockStdout)
+        stream.wrapped = Mock()
+        stream.write_and_convert = Mock()
+        stream.strip = False
+        stream.convert = False
+
+        stream.write('abc')
+
+        self.assertFalse(stream.write_and_convert.called)
+        self.assertEqual(stream.wrapped.write.call_args, (('abc',), {}))
+
+    def assert_autoresets(self, convert, autoreset=True):
+        stream = AnsiToWin32(Mock())
+        stream.convert = convert
+        stream.reset_all = Mock()
+        stream.autoreset = autoreset
+        stream.winterm = Mock()
+
+        stream.write('abc')
+
+        self.assertEqual(stream.reset_all.called, autoreset)
+
+    def testWriteAutoresets(self):
+        self.assert_autoresets(convert=True)
+        self.assert_autoresets(convert=False)
+        self.assert_autoresets(convert=True, autoreset=False)
+        self.assert_autoresets(convert=False, autoreset=False)
+
+    def testWriteAndConvertWritesPlainText(self):
+        stream = AnsiToWin32(Mock())
+        stream.write_and_convert( 'abc' )
+        self.assertEqual( stream.wrapped.write.call_args, (('abc',), {}) )
+
+    def testWriteAndConvertStripsAllValidAnsi(self):
+        stream = AnsiToWin32(Mock())
+        stream.call_win32 = Mock()
+        data = [
+            'abc\033[mdef',
+            'abc\033[0mdef',
+            'abc\033[2mdef',
+            'abc\033[02mdef',
+            'abc\033[002mdef',
+            'abc\033[40mdef',
+            'abc\033[040mdef',
+            'abc\033[0;1mdef',
+            'abc\033[40;50mdef',
+            'abc\033[50;30;40mdef',
+            'abc\033[Adef',
+            'abc\033[0Gdef',
+            'abc\033[1;20;128Hdef',
+        ]
+        for datum in data:
+            stream.wrapped.write.reset_mock()
+            stream.write_and_convert( datum )
+            self.assertEqual(
+               [args[0] for args in stream.wrapped.write.call_args_list],
+               [ ('abc',), ('def',) ]
+            )
+
+    def testWriteAndConvertSkipsEmptySnippets(self):
+        stream = AnsiToWin32(Mock())
+        stream.call_win32 = Mock()
+        stream.write_and_convert( '\033[40m\033[41m' )
+        self.assertFalse( stream.wrapped.write.called )
+
+    def testWriteAndConvertCallsWin32WithParamsAndCommand(self):
+        stream = AnsiToWin32(Mock())
+        stream.convert = True
+        stream.call_win32 = Mock()
+        stream.extract_params = Mock(return_value='params')
+        data = {
+            'abc\033[adef':         ('a', 'params'),
+            'abc\033[;;bdef':       ('b', 'params'),
+            'abc\033[0cdef':        ('c', 'params'),
+            'abc\033[;;0;;Gdef':    ('G', 'params'),
+            'abc\033[1;20;128Hdef': ('H', 'params'),
+        }
+        for datum, expected in data.items():
+            stream.call_win32.reset_mock()
+            stream.write_and_convert( datum )
+            self.assertEqual( stream.call_win32.call_args[0], expected )
+
+    def test_reset_all_shouldnt_raise_on_closed_orig_stdout(self):
+        stream = StringIO()
+        converter = AnsiToWin32(stream)
+        stream.close()
+
+        converter.reset_all()
+
+    def test_wrap_shouldnt_raise_on_closed_orig_stdout(self):
+        stream = StringIO()
+        stream.close()
+        with \
+            patch("colorama.ansitowin32.os.name", "nt"), \
+            patch("colorama.ansitowin32.winapi_test", lambda: True):
+                converter = AnsiToWin32(stream)
+        self.assertTrue(converter.strip)
+        self.assertFalse(converter.convert)
+
+    def test_wrap_shouldnt_raise_on_missing_closed_attr(self):
+        with \
+            patch("colorama.ansitowin32.os.name", "nt"), \
+            patch("colorama.ansitowin32.winapi_test", lambda: True):
+                converter = AnsiToWin32(object())
+        self.assertTrue(converter.strip)
+        self.assertFalse(converter.convert)
+
+    def testExtractParams(self):
+        stream = AnsiToWin32(Mock())
+        data = {
+            '':               (0,),
+            ';;':             (0,),
+            '2':              (2,),
+            ';;002;;':        (2,),
+            '0;1':            (0, 1),
+            ';;003;;456;;':   (3, 456),
+            '11;22;33;44;55': (11, 22, 33, 44, 55),
+        }
+        for datum, expected in data.items():
+            self.assertEqual(stream.extract_params('m', datum), expected)
+
+    def testCallWin32UsesLookup(self):
+        listener = Mock()
+        stream = AnsiToWin32(listener)
+        stream.win32_calls = {
+            1: (lambda *_, **__: listener(11),),
+            2: (lambda *_, **__: listener(22),),
+            3: (lambda *_, **__: listener(33),),
+        }
+        stream.call_win32('m', (3, 1, 99, 2))
+        self.assertEqual(
+            [a[0][0] for a in listener.call_args_list],
+            [33, 11, 22] )
+
+    def test_osc_codes(self):
+        mockStdout = Mock()
+        stream = AnsiToWin32(mockStdout, convert=True)
+        with patch('colorama.ansitowin32.winterm') as winterm:
+            data = [
+                '\033]0\x07',                      # missing arguments
+                '\033]0;foo\x08',                  # wrong OSC command
+                '\033]0;colorama_test_title\x07',  # should work
+                '\033]1;colorama_test_title\x07',  # wrong set command
+                '\033]2;colorama_test_title\x07',  # should work
+                '\033]' + ';' * 64 + '\x08',       # see issue #247
+            ]
+            for code in data:
+                stream.write(code)
+            self.assertEqual(winterm.set_title.call_count, 2)
+
+    def test_native_windows_ansi(self):
+        with ExitStack() as stack:
+            def p(a, b):
+                stack.enter_context(patch(a, b, create=True))
+            # Pretend to be on Windows
+            p("colorama.ansitowin32.os.name", "nt")
+            p("colorama.ansitowin32.winapi_test", lambda: True)
+            p("colorama.win32.winapi_test", lambda: True)
+            p("colorama.winterm.win32.windll", "non-None")
+            p("colorama.winterm.get_osfhandle", lambda _: 1234)
+
+            # Pretend that our mock stream has native ANSI support
+            p(
+                "colorama.winterm.win32.GetConsoleMode",
+                lambda _: ENABLE_VIRTUAL_TERMINAL_PROCESSING,
+            )
+            SetConsoleMode = Mock()
+            p("colorama.winterm.win32.SetConsoleMode", SetConsoleMode)
+
+            stdout = Mock()
+            stdout.closed = False
+            stdout.isatty.return_value = True
+            stdout.fileno.return_value = 1
+
+            # Our fake console says it has native vt support, so AnsiToWin32 should
+            # enable that support and do nothing else.
+            stream = AnsiToWin32(stdout)
+            SetConsoleMode.assert_called_with(1234, ENABLE_VIRTUAL_TERMINAL_PROCESSING)
+            self.assertFalse(stream.strip)
+            self.assertFalse(stream.convert)
+            self.assertFalse(stream.should_wrap())
+
+            # Now let's pretend we're on an old Windows console, that doesn't have
+            # native ANSI support.
+            p("colorama.winterm.win32.GetConsoleMode", lambda _: 0)
+            SetConsoleMode = Mock()
+            p("colorama.winterm.win32.SetConsoleMode", SetConsoleMode)
+
+            stream = AnsiToWin32(stdout)
+            SetConsoleMode.assert_called_with(1234, ENABLE_VIRTUAL_TERMINAL_PROCESSING)
+            self.assertTrue(stream.strip)
+            self.assertTrue(stream.convert)
+            self.assertTrue(stream.should_wrap())
+
+
+if __name__ == '__main__':
+    main()
diff --git a/llm/Lib/site-packages/colorama/tests/initialise_test.py b/llm/Lib/site-packages/colorama/tests/initialise_test.py
new file mode 100644
index 0000000000000000000000000000000000000000..89f9b07511c8fee74686d9cc434bf66345a46d6d
--- /dev/null
+++ b/llm/Lib/site-packages/colorama/tests/initialise_test.py
@@ -0,0 +1,189 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+import sys
+from unittest import TestCase, main, skipUnless
+
+try:
+    from unittest.mock import patch, Mock
+except ImportError:
+    from mock import patch, Mock
+
+from ..ansitowin32 import StreamWrapper
+from ..initialise import init, just_fix_windows_console, _wipe_internal_state_for_tests
+from .utils import osname, replace_by
+
+orig_stdout = sys.stdout
+orig_stderr = sys.stderr
+
+
+class InitTest(TestCase):
+
+    @skipUnless(sys.stdout.isatty(), "sys.stdout is not a tty")
+    def setUp(self):
+        # sanity check
+        self.assertNotWrapped()
+
+    def tearDown(self):
+        _wipe_internal_state_for_tests()
+        sys.stdout = orig_stdout
+        sys.stderr = orig_stderr
+
+    def assertWrapped(self):
+        self.assertIsNot(sys.stdout, orig_stdout, 'stdout should be wrapped')
+        self.assertIsNot(sys.stderr, orig_stderr, 'stderr should be wrapped')
+        self.assertTrue(isinstance(sys.stdout, StreamWrapper),
+            'bad stdout wrapper')
+        self.assertTrue(isinstance(sys.stderr, StreamWrapper),
+            'bad stderr wrapper')
+
+    def assertNotWrapped(self):
+        self.assertIs(sys.stdout, orig_stdout, 'stdout should not be wrapped')
+        self.assertIs(sys.stderr, orig_stderr, 'stderr should not be wrapped')
+
+    @patch('colorama.initialise.reset_all')
+    @patch('colorama.ansitowin32.winapi_test', lambda *_: True)
+    @patch('colorama.ansitowin32.enable_vt_processing', lambda *_: False)
+    def testInitWrapsOnWindows(self, _):
+        with osname("nt"):
+            init()
+            self.assertWrapped()
+
+    @patch('colorama.initialise.reset_all')
+    @patch('colorama.ansitowin32.winapi_test', lambda *_: False)
+    def testInitDoesntWrapOnEmulatedWindows(self, _):
+        with osname("nt"):
+            init()
+            self.assertNotWrapped()
+
+    def testInitDoesntWrapOnNonWindows(self):
+        with osname("posix"):
+            init()
+            self.assertNotWrapped()
+
+    def testInitDoesntWrapIfNone(self):
+        with replace_by(None):
+            init()
+            # We can't use assertNotWrapped here because replace_by(None)
+            # changes stdout/stderr already.
+            self.assertIsNone(sys.stdout)
+            self.assertIsNone(sys.stderr)
+
+    def testInitAutoresetOnWrapsOnAllPlatforms(self):
+        with osname("posix"):
+            init(autoreset=True)
+            self.assertWrapped()
+
+    def testInitWrapOffDoesntWrapOnWindows(self):
+        with osname("nt"):
+            init(wrap=False)
+            self.assertNotWrapped()
+
+    def testInitWrapOffIncompatibleWithAutoresetOn(self):
+        self.assertRaises(ValueError, lambda: init(autoreset=True, wrap=False))
+
+    @patch('colorama.win32.SetConsoleTextAttribute')
+    @patch('colorama.initialise.AnsiToWin32')
+    def testAutoResetPassedOn(self, mockATW32, _):
+        with osname("nt"):
+            init(autoreset=True)
+            self.assertEqual(len(mockATW32.call_args_list), 2)
+            self.assertEqual(mockATW32.call_args_list[1][1]['autoreset'], True)
+            self.assertEqual(mockATW32.call_args_list[0][1]['autoreset'], True)
+
+    @patch('colorama.initialise.AnsiToWin32')
+    def testAutoResetChangeable(self, mockATW32):
+        with osname("nt"):
+            init()
+
+            init(autoreset=True)
+            self.assertEqual(len(mockATW32.call_args_list), 4)
+            self.assertEqual(mockATW32.call_args_list[2][1]['autoreset'], True)
+            self.assertEqual(mockATW32.call_args_list[3][1]['autoreset'], True)
+
+            init()
+            self.assertEqual(len(mockATW32.call_args_list), 6)
+            self.assertEqual(
+                mockATW32.call_args_list[4][1]['autoreset'], False)
+            self.assertEqual(
+                mockATW32.call_args_list[5][1]['autoreset'], False)
+
+
+    @patch('colorama.initialise.atexit.register')
+    def testAtexitRegisteredOnlyOnce(self, mockRegister):
+        init()
+        self.assertTrue(mockRegister.called)
+        mockRegister.reset_mock()
+        init()
+        self.assertFalse(mockRegister.called)
+
+
+class JustFixWindowsConsoleTest(TestCase):
+    def _reset(self):
+        _wipe_internal_state_for_tests()
+        sys.stdout = orig_stdout
+        sys.stderr = orig_stderr
+
+    def tearDown(self):
+        self._reset()
+
+    @patch("colorama.ansitowin32.winapi_test", lambda: True)
+    def testJustFixWindowsConsole(self):
+        if sys.platform != "win32":
+            # just_fix_windows_console should be a no-op
+            just_fix_windows_console()
+            self.assertIs(sys.stdout, orig_stdout)
+            self.assertIs(sys.stderr, orig_stderr)
+        else:
+            def fake_std():
+                # Emulate stdout=not a tty, stderr=tty
+                # to check that we handle both cases correctly
+                stdout = Mock()
+                stdout.closed = False
+                stdout.isatty.return_value = False
+                stdout.fileno.return_value = 1
+                sys.stdout = stdout
+
+                stderr = Mock()
+                stderr.closed = False
+                stderr.isatty.return_value = True
+                stderr.fileno.return_value = 2
+                sys.stderr = stderr
+
+            for native_ansi in [False, True]:
+                with patch(
+                    'colorama.ansitowin32.enable_vt_processing',
+                    lambda *_: native_ansi
+                ):
+                    self._reset()
+                    fake_std()
+
+                    # Regular single-call test
+                    prev_stdout = sys.stdout
+                    prev_stderr = sys.stderr
+                    just_fix_windows_console()
+                    self.assertIs(sys.stdout, prev_stdout)
+                    if native_ansi:
+                        self.assertIs(sys.stderr, prev_stderr)
+                    else:
+                        self.assertIsNot(sys.stderr, prev_stderr)
+
+                    # second call without resetting is always a no-op
+                    prev_stdout = sys.stdout
+                    prev_stderr = sys.stderr
+                    just_fix_windows_console()
+                    self.assertIs(sys.stdout, prev_stdout)
+                    self.assertIs(sys.stderr, prev_stderr)
+
+                    self._reset()
+                    fake_std()
+
+                    # If init() runs first, just_fix_windows_console should be a no-op
+                    init()
+                    prev_stdout = sys.stdout
+                    prev_stderr = sys.stderr
+                    just_fix_windows_console()
+                    self.assertIs(prev_stdout, sys.stdout)
+                    self.assertIs(prev_stderr, sys.stderr)
+
+
+if __name__ == '__main__':
+    main()
diff --git a/llm/Lib/site-packages/colorama/tests/isatty_test.py b/llm/Lib/site-packages/colorama/tests/isatty_test.py
new file mode 100644
index 0000000000000000000000000000000000000000..0f84e4befe550d4386d24264648abf1323e682ff
--- /dev/null
+++ b/llm/Lib/site-packages/colorama/tests/isatty_test.py
@@ -0,0 +1,57 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+import sys
+from unittest import TestCase, main
+
+from ..ansitowin32 import StreamWrapper, AnsiToWin32
+from .utils import pycharm, replace_by, replace_original_by, StreamTTY, StreamNonTTY
+
+
+def is_a_tty(stream):
+    return StreamWrapper(stream, None).isatty()
+
+class IsattyTest(TestCase):
+
+    def test_TTY(self):
+        tty = StreamTTY()
+        self.assertTrue(is_a_tty(tty))
+        with pycharm():
+            self.assertTrue(is_a_tty(tty))
+
+    def test_nonTTY(self):
+        non_tty = StreamNonTTY()
+        self.assertFalse(is_a_tty(non_tty))
+        with pycharm():
+            self.assertFalse(is_a_tty(non_tty))
+
+    def test_withPycharm(self):
+        with pycharm():
+            self.assertTrue(is_a_tty(sys.stderr))
+            self.assertTrue(is_a_tty(sys.stdout))
+
+    def test_withPycharmTTYOverride(self):
+        tty = StreamTTY()
+        with pycharm(), replace_by(tty):
+            self.assertTrue(is_a_tty(tty))
+
+    def test_withPycharmNonTTYOverride(self):
+        non_tty = StreamNonTTY()
+        with pycharm(), replace_by(non_tty):
+            self.assertFalse(is_a_tty(non_tty))
+
+    def test_withPycharmNoneOverride(self):
+        with pycharm():
+            with replace_by(None), replace_original_by(None):
+                self.assertFalse(is_a_tty(None))
+                self.assertFalse(is_a_tty(StreamNonTTY()))
+                self.assertTrue(is_a_tty(StreamTTY()))
+
+    def test_withPycharmStreamWrapped(self):
+        with pycharm():
+            self.assertTrue(AnsiToWin32(StreamTTY()).stream.isatty())
+            self.assertFalse(AnsiToWin32(StreamNonTTY()).stream.isatty())
+            self.assertTrue(AnsiToWin32(sys.stdout).stream.isatty())
+            self.assertTrue(AnsiToWin32(sys.stderr).stream.isatty())
+
+
+if __name__ == '__main__':
+    main()
diff --git a/llm/Lib/site-packages/colorama/tests/utils.py b/llm/Lib/site-packages/colorama/tests/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..472fafb4403efb9673d5cc724dafd9cf764aac5b
--- /dev/null
+++ b/llm/Lib/site-packages/colorama/tests/utils.py
@@ -0,0 +1,49 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+from contextlib import contextmanager
+from io import StringIO
+import sys
+import os
+
+
+class StreamTTY(StringIO):
+    def isatty(self):
+        return True
+
+class StreamNonTTY(StringIO):
+    def isatty(self):
+        return False
+
+@contextmanager
+def osname(name):
+    orig = os.name
+    os.name = name
+    yield
+    os.name = orig
+
+@contextmanager
+def replace_by(stream):
+    orig_stdout = sys.stdout
+    orig_stderr = sys.stderr
+    sys.stdout = stream
+    sys.stderr = stream
+    yield
+    sys.stdout = orig_stdout
+    sys.stderr = orig_stderr
+
+@contextmanager
+def replace_original_by(stream):
+    orig_stdout = sys.__stdout__
+    orig_stderr = sys.__stderr__
+    sys.__stdout__ = stream
+    sys.__stderr__ = stream
+    yield
+    sys.__stdout__ = orig_stdout
+    sys.__stderr__ = orig_stderr
+
+@contextmanager
+def pycharm():
+    os.environ["PYCHARM_HOSTED"] = "1"
+    non_tty = StreamNonTTY()
+    with replace_by(non_tty), replace_original_by(non_tty):
+        yield
+    del os.environ["PYCHARM_HOSTED"]
diff --git a/llm/Lib/site-packages/colorama/tests/winterm_test.py b/llm/Lib/site-packages/colorama/tests/winterm_test.py
new file mode 100644
index 0000000000000000000000000000000000000000..d0955f9e608377940f0d548576964f2fcf3caf48
--- /dev/null
+++ b/llm/Lib/site-packages/colorama/tests/winterm_test.py
@@ -0,0 +1,131 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+import sys
+from unittest import TestCase, main, skipUnless
+
+try:
+    from unittest.mock import Mock, patch
+except ImportError:
+    from mock import Mock, patch
+
+from ..winterm import WinColor, WinStyle, WinTerm
+
+
+class WinTermTest(TestCase):
+
+    @patch('colorama.winterm.win32')
+    def testInit(self, mockWin32):
+        mockAttr = Mock()
+        mockAttr.wAttributes = 7 + 6 * 16 + 8
+        mockWin32.GetConsoleScreenBufferInfo.return_value = mockAttr
+        term = WinTerm()
+        self.assertEqual(term._fore, 7)
+        self.assertEqual(term._back, 6)
+        self.assertEqual(term._style, 8)
+
+    @skipUnless(sys.platform.startswith("win"), "requires Windows")
+    def testGetAttrs(self):
+        term = WinTerm()
+
+        term._fore = 0
+        term._back = 0
+        term._style = 0
+        self.assertEqual(term.get_attrs(), 0)
+
+        term._fore = WinColor.YELLOW
+        self.assertEqual(term.get_attrs(), WinColor.YELLOW)
+
+        term._back = WinColor.MAGENTA
+        self.assertEqual(
+            term.get_attrs(),
+            WinColor.YELLOW + WinColor.MAGENTA * 16)
+
+        term._style = WinStyle.BRIGHT
+        self.assertEqual(
+            term.get_attrs(),
+            WinColor.YELLOW + WinColor.MAGENTA * 16 + WinStyle.BRIGHT)
+
+    @patch('colorama.winterm.win32')
+    def testResetAll(self, mockWin32):
+        mockAttr = Mock()
+        mockAttr.wAttributes = 1 + 2 * 16 + 8
+        mockWin32.GetConsoleScreenBufferInfo.return_value = mockAttr
+        term = WinTerm()
+
+        term.set_console = Mock()
+        term._fore = -1
+        term._back = -1
+        term._style = -1
+
+        term.reset_all()
+
+        self.assertEqual(term._fore, 1)
+        self.assertEqual(term._back, 2)
+        self.assertEqual(term._style, 8)
+        self.assertEqual(term.set_console.called, True)
+
+    @skipUnless(sys.platform.startswith("win"), "requires Windows")
+    def testFore(self):
+        term = WinTerm()
+        term.set_console = Mock()
+        term._fore = 0
+
+        term.fore(5)
+
+        self.assertEqual(term._fore, 5)
+        self.assertEqual(term.set_console.called, True)
+
+    @skipUnless(sys.platform.startswith("win"), "requires Windows")
+    def testBack(self):
+        term = WinTerm()
+        term.set_console = Mock()
+        term._back = 0
+
+        term.back(5)
+
+        self.assertEqual(term._back, 5)
+        self.assertEqual(term.set_console.called, True)
+
+    @skipUnless(sys.platform.startswith("win"), "requires Windows")
+    def testStyle(self):
+        term = WinTerm()
+        term.set_console = Mock()
+        term._style = 0
+
+        term.style(22)
+
+        self.assertEqual(term._style, 22)
+        self.assertEqual(term.set_console.called, True)
+
+    @patch('colorama.winterm.win32')
+    def testSetConsole(self, mockWin32):
+        mockAttr = Mock()
+        mockAttr.wAttributes = 0
+        mockWin32.GetConsoleScreenBufferInfo.return_value = mockAttr
+        term = WinTerm()
+        term.windll = Mock()
+
+        term.set_console()
+
+        self.assertEqual(
+            mockWin32.SetConsoleTextAttribute.call_args,
+            ((mockWin32.STDOUT, term.get_attrs()), {})
+        )
+
+    @patch('colorama.winterm.win32')
+    def testSetConsoleOnStderr(self, mockWin32):
+        mockAttr = Mock()
+        mockAttr.wAttributes = 0
+        mockWin32.GetConsoleScreenBufferInfo.return_value = mockAttr
+        term = WinTerm()
+        term.windll = Mock()
+
+        term.set_console(on_stderr=True)
+
+        self.assertEqual(
+            mockWin32.SetConsoleTextAttribute.call_args,
+            ((mockWin32.STDERR, term.get_attrs()), {})
+        )
+
+
+if __name__ == '__main__':
+    main()
diff --git a/llm/Lib/site-packages/colorama/win32.py b/llm/Lib/site-packages/colorama/win32.py
new file mode 100644
index 0000000000000000000000000000000000000000..841b0e270a381cdfaca544a9be976d7276d83b1e
--- /dev/null
+++ b/llm/Lib/site-packages/colorama/win32.py
@@ -0,0 +1,180 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+
+# from winbase.h
+STDOUT = -11
+STDERR = -12
+
+ENABLE_VIRTUAL_TERMINAL_PROCESSING = 0x0004
+
+try:
+    import ctypes
+    from ctypes import LibraryLoader
+    windll = LibraryLoader(ctypes.WinDLL)
+    from ctypes import wintypes
+except (AttributeError, ImportError):
+    windll = None
+    SetConsoleTextAttribute = lambda *_: None
+    winapi_test = lambda *_: None
+else:
+    from ctypes import byref, Structure, c_char, POINTER
+
+    COORD = wintypes._COORD
+
+    class CONSOLE_SCREEN_BUFFER_INFO(Structure):
+        """struct in wincon.h."""
+        _fields_ = [
+            ("dwSize", COORD),
+            ("dwCursorPosition", COORD),
+            ("wAttributes", wintypes.WORD),
+            ("srWindow", wintypes.SMALL_RECT),
+            ("dwMaximumWindowSize", COORD),
+        ]
+        def __str__(self):
+            return '(%d,%d,%d,%d,%d,%d,%d,%d,%d,%d,%d)' % (
+                self.dwSize.Y, self.dwSize.X
+                , self.dwCursorPosition.Y, self.dwCursorPosition.X
+                , self.wAttributes
+                , self.srWindow.Top, self.srWindow.Left, self.srWindow.Bottom, self.srWindow.Right
+                , self.dwMaximumWindowSize.Y, self.dwMaximumWindowSize.X
+            )
+
+    _GetStdHandle = windll.kernel32.GetStdHandle
+    _GetStdHandle.argtypes = [
+        wintypes.DWORD,
+    ]
+    _GetStdHandle.restype = wintypes.HANDLE
+
+    _GetConsoleScreenBufferInfo = windll.kernel32.GetConsoleScreenBufferInfo
+    _GetConsoleScreenBufferInfo.argtypes = [
+        wintypes.HANDLE,
+        POINTER(CONSOLE_SCREEN_BUFFER_INFO),
+    ]
+    _GetConsoleScreenBufferInfo.restype = wintypes.BOOL
+
+    _SetConsoleTextAttribute = windll.kernel32.SetConsoleTextAttribute
+    _SetConsoleTextAttribute.argtypes = [
+        wintypes.HANDLE,
+        wintypes.WORD,
+    ]
+    _SetConsoleTextAttribute.restype = wintypes.BOOL
+
+    _SetConsoleCursorPosition = windll.kernel32.SetConsoleCursorPosition
+    _SetConsoleCursorPosition.argtypes = [
+        wintypes.HANDLE,
+        COORD,
+    ]
+    _SetConsoleCursorPosition.restype = wintypes.BOOL
+
+    _FillConsoleOutputCharacterA = windll.kernel32.FillConsoleOutputCharacterA
+    _FillConsoleOutputCharacterA.argtypes = [
+        wintypes.HANDLE,
+        c_char,
+        wintypes.DWORD,
+        COORD,
+        POINTER(wintypes.DWORD),
+    ]
+    _FillConsoleOutputCharacterA.restype = wintypes.BOOL
+
+    _FillConsoleOutputAttribute = windll.kernel32.FillConsoleOutputAttribute
+    _FillConsoleOutputAttribute.argtypes = [
+        wintypes.HANDLE,
+        wintypes.WORD,
+        wintypes.DWORD,
+        COORD,
+        POINTER(wintypes.DWORD),
+    ]
+    _FillConsoleOutputAttribute.restype = wintypes.BOOL
+
+    _SetConsoleTitleW = windll.kernel32.SetConsoleTitleW
+    _SetConsoleTitleW.argtypes = [
+        wintypes.LPCWSTR
+    ]
+    _SetConsoleTitleW.restype = wintypes.BOOL
+
+    _GetConsoleMode = windll.kernel32.GetConsoleMode
+    _GetConsoleMode.argtypes = [
+        wintypes.HANDLE,
+        POINTER(wintypes.DWORD)
+    ]
+    _GetConsoleMode.restype = wintypes.BOOL
+
+    _SetConsoleMode = windll.kernel32.SetConsoleMode
+    _SetConsoleMode.argtypes = [
+        wintypes.HANDLE,
+        wintypes.DWORD
+    ]
+    _SetConsoleMode.restype = wintypes.BOOL
+
+    def _winapi_test(handle):
+        csbi = CONSOLE_SCREEN_BUFFER_INFO()
+        success = _GetConsoleScreenBufferInfo(
+            handle, byref(csbi))
+        return bool(success)
+
+    def winapi_test():
+        return any(_winapi_test(h) for h in
+                   (_GetStdHandle(STDOUT), _GetStdHandle(STDERR)))
+
+    def GetConsoleScreenBufferInfo(stream_id=STDOUT):
+        handle = _GetStdHandle(stream_id)
+        csbi = CONSOLE_SCREEN_BUFFER_INFO()
+        success = _GetConsoleScreenBufferInfo(
+            handle, byref(csbi))
+        return csbi
+
+    def SetConsoleTextAttribute(stream_id, attrs):
+        handle = _GetStdHandle(stream_id)
+        return _SetConsoleTextAttribute(handle, attrs)
+
+    def SetConsoleCursorPosition(stream_id, position, adjust=True):
+        position = COORD(*position)
+        # If the position is out of range, do nothing.
+        if position.Y <= 0 or position.X <= 0:
+            return
+        # Adjust for Windows' SetConsoleCursorPosition:
+        #    1. being 0-based, while ANSI is 1-based.
+        #    2. expecting (x,y), while ANSI uses (y,x).
+        adjusted_position = COORD(position.Y - 1, position.X - 1)
+        if adjust:
+            # Adjust for viewport's scroll position
+            sr = GetConsoleScreenBufferInfo(STDOUT).srWindow
+            adjusted_position.Y += sr.Top
+            adjusted_position.X += sr.Left
+        # Resume normal processing
+        handle = _GetStdHandle(stream_id)
+        return _SetConsoleCursorPosition(handle, adjusted_position)
+
+    def FillConsoleOutputCharacter(stream_id, char, length, start):
+        handle = _GetStdHandle(stream_id)
+        char = c_char(char.encode())
+        length = wintypes.DWORD(length)
+        num_written = wintypes.DWORD(0)
+        # Note that this is hard-coded for ANSI (vs wide) bytes.
+        success = _FillConsoleOutputCharacterA(
+            handle, char, length, start, byref(num_written))
+        return num_written.value
+
+    def FillConsoleOutputAttribute(stream_id, attr, length, start):
+        ''' FillConsoleOutputAttribute( hConsole, csbi.wAttributes, dwConSize, coordScreen, &cCharsWritten )'''
+        handle = _GetStdHandle(stream_id)
+        attribute = wintypes.WORD(attr)
+        length = wintypes.DWORD(length)
+        num_written = wintypes.DWORD(0)
+        # Note that this is hard-coded for ANSI (vs wide) bytes.
+        return _FillConsoleOutputAttribute(
+            handle, attribute, length, start, byref(num_written))
+
+    def SetConsoleTitle(title):
+        return _SetConsoleTitleW(title)
+
+    def GetConsoleMode(handle):
+        mode = wintypes.DWORD()
+        success = _GetConsoleMode(handle, byref(mode))
+        if not success:
+            raise ctypes.WinError()
+        return mode.value
+
+    def SetConsoleMode(handle, mode):
+        success = _SetConsoleMode(handle, mode)
+        if not success:
+            raise ctypes.WinError()
diff --git a/llm/Lib/site-packages/colorama/winterm.py b/llm/Lib/site-packages/colorama/winterm.py
new file mode 100644
index 0000000000000000000000000000000000000000..aad867e8c80b826bf6a060116f17fa08a8eb0765
--- /dev/null
+++ b/llm/Lib/site-packages/colorama/winterm.py
@@ -0,0 +1,195 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+try:
+    from msvcrt import get_osfhandle
+except ImportError:
+    def get_osfhandle(_):
+        raise OSError("This isn't windows!")
+
+
+from . import win32
+
+# from wincon.h
+class WinColor(object):
+    BLACK   = 0
+    BLUE    = 1
+    GREEN   = 2
+    CYAN    = 3
+    RED     = 4
+    MAGENTA = 5
+    YELLOW  = 6
+    GREY    = 7
+
+# from wincon.h
+class WinStyle(object):
+    NORMAL              = 0x00 # dim text, dim background
+    BRIGHT              = 0x08 # bright text, dim background
+    BRIGHT_BACKGROUND   = 0x80 # dim text, bright background
+
+class WinTerm(object):
+
+    def __init__(self):
+        self._default = win32.GetConsoleScreenBufferInfo(win32.STDOUT).wAttributes
+        self.set_attrs(self._default)
+        self._default_fore = self._fore
+        self._default_back = self._back
+        self._default_style = self._style
+        # In order to emulate LIGHT_EX in windows, we borrow the BRIGHT style.
+        # So that LIGHT_EX colors and BRIGHT style do not clobber each other,
+        # we track them separately, since LIGHT_EX is overwritten by Fore/Back
+        # and BRIGHT is overwritten by Style codes.
+        self._light = 0
+
+    def get_attrs(self):
+        return self._fore + self._back * 16 + (self._style | self._light)
+
+    def set_attrs(self, value):
+        self._fore = value & 7
+        self._back = (value >> 4) & 7
+        self._style = value & (WinStyle.BRIGHT | WinStyle.BRIGHT_BACKGROUND)
+
+    def reset_all(self, on_stderr=None):
+        self.set_attrs(self._default)
+        self.set_console(attrs=self._default)
+        self._light = 0
+
+    def fore(self, fore=None, light=False, on_stderr=False):
+        if fore is None:
+            fore = self._default_fore
+        self._fore = fore
+        # Emulate LIGHT_EX with BRIGHT Style
+        if light:
+            self._light |= WinStyle.BRIGHT
+        else:
+            self._light &= ~WinStyle.BRIGHT
+        self.set_console(on_stderr=on_stderr)
+
+    def back(self, back=None, light=False, on_stderr=False):
+        if back is None:
+            back = self._default_back
+        self._back = back
+        # Emulate LIGHT_EX with BRIGHT_BACKGROUND Style
+        if light:
+            self._light |= WinStyle.BRIGHT_BACKGROUND
+        else:
+            self._light &= ~WinStyle.BRIGHT_BACKGROUND
+        self.set_console(on_stderr=on_stderr)
+
+    def style(self, style=None, on_stderr=False):
+        if style is None:
+            style = self._default_style
+        self._style = style
+        self.set_console(on_stderr=on_stderr)
+
+    def set_console(self, attrs=None, on_stderr=False):
+        if attrs is None:
+            attrs = self.get_attrs()
+        handle = win32.STDOUT
+        if on_stderr:
+            handle = win32.STDERR
+        win32.SetConsoleTextAttribute(handle, attrs)
+
+    def get_position(self, handle):
+        position = win32.GetConsoleScreenBufferInfo(handle).dwCursorPosition
+        # Because Windows coordinates are 0-based,
+        # and win32.SetConsoleCursorPosition expects 1-based.
+        position.X += 1
+        position.Y += 1
+        return position
+
+    def set_cursor_position(self, position=None, on_stderr=False):
+        if position is None:
+            # I'm not currently tracking the position, so there is no default.
+            # position = self.get_position()
+            return
+        handle = win32.STDOUT
+        if on_stderr:
+            handle = win32.STDERR
+        win32.SetConsoleCursorPosition(handle, position)
+
+    def cursor_adjust(self, x, y, on_stderr=False):
+        handle = win32.STDOUT
+        if on_stderr:
+            handle = win32.STDERR
+        position = self.get_position(handle)
+        adjusted_position = (position.Y + y, position.X + x)
+        win32.SetConsoleCursorPosition(handle, adjusted_position, adjust=False)
+
+    def erase_screen(self, mode=0, on_stderr=False):
+        # 0 should clear from the cursor to the end of the screen.
+        # 1 should clear from the cursor to the beginning of the screen.
+        # 2 should clear the entire screen, and move cursor to (1,1)
+        handle = win32.STDOUT
+        if on_stderr:
+            handle = win32.STDERR
+        csbi = win32.GetConsoleScreenBufferInfo(handle)
+        # get the number of character cells in the current buffer
+        cells_in_screen = csbi.dwSize.X * csbi.dwSize.Y
+        # get number of character cells before current cursor position
+        cells_before_cursor = csbi.dwSize.X * csbi.dwCursorPosition.Y + csbi.dwCursorPosition.X
+        if mode == 0:
+            from_coord = csbi.dwCursorPosition
+            cells_to_erase = cells_in_screen - cells_before_cursor
+        elif mode == 1:
+            from_coord = win32.COORD(0, 0)
+            cells_to_erase = cells_before_cursor
+        elif mode == 2:
+            from_coord = win32.COORD(0, 0)
+            cells_to_erase = cells_in_screen
+        else:
+            # invalid mode
+            return
+        # fill the entire screen with blanks
+        win32.FillConsoleOutputCharacter(handle, ' ', cells_to_erase, from_coord)
+        # now set the buffer's attributes accordingly
+        win32.FillConsoleOutputAttribute(handle, self.get_attrs(), cells_to_erase, from_coord)
+        if mode == 2:
+            # put the cursor where needed
+            win32.SetConsoleCursorPosition(handle, (1, 1))
+
+    def erase_line(self, mode=0, on_stderr=False):
+        # 0 should clear from the cursor to the end of the line.
+        # 1 should clear from the cursor to the beginning of the line.
+        # 2 should clear the entire line.
+        handle = win32.STDOUT
+        if on_stderr:
+            handle = win32.STDERR
+        csbi = win32.GetConsoleScreenBufferInfo(handle)
+        if mode == 0:
+            from_coord = csbi.dwCursorPosition
+            cells_to_erase = csbi.dwSize.X - csbi.dwCursorPosition.X
+        elif mode == 1:
+            from_coord = win32.COORD(0, csbi.dwCursorPosition.Y)
+            cells_to_erase = csbi.dwCursorPosition.X
+        elif mode == 2:
+            from_coord = win32.COORD(0, csbi.dwCursorPosition.Y)
+            cells_to_erase = csbi.dwSize.X
+        else:
+            # invalid mode
+            return
+        # fill the entire screen with blanks
+        win32.FillConsoleOutputCharacter(handle, ' ', cells_to_erase, from_coord)
+        # now set the buffer's attributes accordingly
+        win32.FillConsoleOutputAttribute(handle, self.get_attrs(), cells_to_erase, from_coord)
+
+    def set_title(self, title):
+        win32.SetConsoleTitle(title)
+
+
+def enable_vt_processing(fd):
+    if win32.windll is None or not win32.winapi_test():
+        return False
+
+    try:
+        handle = get_osfhandle(fd)
+        mode = win32.GetConsoleMode(handle)
+        win32.SetConsoleMode(
+            handle,
+            mode | win32.ENABLE_VIRTUAL_TERMINAL_PROCESSING,
+        )
+
+        mode = win32.GetConsoleMode(handle)
+        if mode & win32.ENABLE_VIRTUAL_TERMINAL_PROCESSING:
+            return True
+    # Can get TypeError in testsuite where 'fd' is a Mock()
+    except (OSError, TypeError):
+        return False
diff --git a/llm/Lib/site-packages/cpuinfo/__init__.py b/llm/Lib/site-packages/cpuinfo/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f0ae1cedef2202096faadc3ff0dd0614f8adf394
--- /dev/null
+++ b/llm/Lib/site-packages/cpuinfo/__init__.py
@@ -0,0 +1,5 @@
+
+import sys
+from cpuinfo.cpuinfo import *
+
+
diff --git a/llm/Lib/site-packages/cpuinfo/__main__.py b/llm/Lib/site-packages/cpuinfo/__main__.py
new file mode 100644
index 0000000000000000000000000000000000000000..09ebf764121cc9bae49421535e56d0c5a9394290
--- /dev/null
+++ b/llm/Lib/site-packages/cpuinfo/__main__.py
@@ -0,0 +1,5 @@
+
+import cpuinfo
+
+cpuinfo.main()
+
diff --git a/llm/Lib/site-packages/cpuinfo/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/cpuinfo/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..04dd3616d4db10109ee3a7ba6e1b0800b83f3c7f
Binary files /dev/null and b/llm/Lib/site-packages/cpuinfo/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cpuinfo/__pycache__/__main__.cpython-311.pyc b/llm/Lib/site-packages/cpuinfo/__pycache__/__main__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b3ae4c2a31a4758472b7406361e137d430d79ece
Binary files /dev/null and b/llm/Lib/site-packages/cpuinfo/__pycache__/__main__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cpuinfo/__pycache__/cpuinfo.cpython-311.pyc b/llm/Lib/site-packages/cpuinfo/__pycache__/cpuinfo.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d5dcdff66682055a73b78f089d5fc2872d348020
Binary files /dev/null and b/llm/Lib/site-packages/cpuinfo/__pycache__/cpuinfo.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/cpuinfo/cpuinfo.py b/llm/Lib/site-packages/cpuinfo/cpuinfo.py
new file mode 100644
index 0000000000000000000000000000000000000000..ea2f90e397404bb200d8c74a0331b9ede5c5b106
--- /dev/null
+++ b/llm/Lib/site-packages/cpuinfo/cpuinfo.py
@@ -0,0 +1,2827 @@
+#!/usr/bin/env python
+# -*- coding: UTF-8 -*-
+
+# Copyright (c) 2014-2022 Matthew Brennan Jones <matthew.brennan.jones@gmail.com>
+# Py-cpuinfo gets CPU info with pure Python
+# It uses the MIT License
+# It is hosted at: https://github.com/workhorsy/py-cpuinfo
+#
+# 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 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.
+
+CPUINFO_VERSION = (9, 0, 0)
+CPUINFO_VERSION_STRING = '.'.join([str(n) for n in CPUINFO_VERSION])
+
+import os, sys
+import platform
+import multiprocessing
+import ctypes
+
+
+CAN_CALL_CPUID_IN_SUBPROCESS = True
+
+g_trace = None
+
+
+class Trace(object):
+	def __init__(self, is_active, is_stored_in_string):
+		self._is_active = is_active
+		if not self._is_active:
+			return
+
+		from datetime import datetime
+		from io import StringIO
+
+		if is_stored_in_string:
+			self._output = StringIO()
+		else:
+			date = datetime.now().strftime("%Y-%m-%d_%H-%M-%S-%f")
+			self._output = open('cpuinfo_trace_{0}.trace'.format(date), 'w')
+
+		self._stdout = StringIO()
+		self._stderr = StringIO()
+		self._err = None
+
+	def header(self, msg):
+		if not self._is_active: return
+
+		from inspect import stack
+		frame = stack()[1]
+		file = frame[1]
+		line = frame[2]
+		self._output.write("{0} ({1} {2})\n".format(msg, file, line))
+		self._output.flush()
+
+	def success(self):
+		if not self._is_active: return
+
+		from inspect import stack
+		frame = stack()[1]
+		file = frame[1]
+		line = frame[2]
+
+		self._output.write("Success ... ({0} {1})\n\n".format(file, line))
+		self._output.flush()
+
+	def fail(self, msg):
+		if not self._is_active: return
+
+		from inspect import stack
+		frame = stack()[1]
+		file = frame[1]
+		line = frame[2]
+
+		if isinstance(msg, str):
+			msg = ''.join(['\t' + line for line in msg.split('\n')]) + '\n'
+
+			self._output.write(msg)
+			self._output.write("Failed ... ({0} {1})\n\n".format(file, line))
+			self._output.flush()
+		elif isinstance(msg, Exception):
+			from traceback import format_exc
+			err_string = format_exc()
+			self._output.write("\tFailed ... ({0} {1})\n".format(file, line))
+			self._output.write(''.join(['\t\t{0}\n'.format(n) for n in err_string.split('\n')]) + '\n')
+			self._output.flush()
+
+	def command_header(self, msg):
+		if not self._is_active: return
+
+		from inspect import stack
+		frame = stack()[3]
+		file = frame[1]
+		line = frame[2]
+		self._output.write("\t{0} ({1} {2})\n".format(msg, file, line))
+		self._output.flush()
+
+	def command_output(self, msg, output):
+		if not self._is_active: return
+
+		self._output.write("\t\t{0}\n".format(msg))
+		self._output.write(''.join(['\t\t\t{0}\n'.format(n) for n in output.split('\n')]) + '\n')
+		self._output.flush()
+
+	def keys(self, keys, info, new_info):
+		if not self._is_active: return
+
+		from inspect import stack
+		frame = stack()[2]
+		file = frame[1]
+		line = frame[2]
+
+		# List updated keys
+		self._output.write("\tChanged keys ({0} {1})\n".format(file, line))
+		changed_keys = [key for key in keys if key in info and key in new_info and info[key] != new_info[key]]
+		if changed_keys:
+			for key in changed_keys:
+				self._output.write('\t\t{0}: {1} to {2}\n'.format(key, info[key], new_info[key]))
+		else:
+			self._output.write('\t\tNone\n')
+
+		# List new keys
+		self._output.write("\tNew keys ({0} {1})\n".format(file, line))
+		new_keys = [key for key in keys if key in new_info and key not in info]
+		if new_keys:
+			for key in new_keys:
+				self._output.write('\t\t{0}: {1}\n'.format(key, new_info[key]))
+		else:
+			self._output.write('\t\tNone\n')
+
+		self._output.write('\n')
+		self._output.flush()
+
+	def write(self, msg):
+		if not self._is_active: return
+
+		self._output.write(msg + '\n')
+		self._output.flush()
+
+	def to_dict(self, info, is_fail):
+		return {
+		'output' : self._output.getvalue(),
+		'stdout' : self._stdout.getvalue(),
+		'stderr' : self._stderr.getvalue(),
+		'info' : info,
+		'err' : self._err,
+		'is_fail' : is_fail
+		}
+
+class DataSource(object):
+	bits = platform.architecture()[0]
+	cpu_count = multiprocessing.cpu_count()
+	is_windows = platform.system().lower() == 'windows'
+	arch_string_raw = platform.machine()
+	uname_string_raw = platform.uname()[5]
+	can_cpuid = True
+
+	@staticmethod
+	def has_proc_cpuinfo():
+		return os.path.exists('/proc/cpuinfo')
+
+	@staticmethod
+	def has_dmesg():
+		return len(_program_paths('dmesg')) > 0
+
+	@staticmethod
+	def has_var_run_dmesg_boot():
+		uname = platform.system().strip().strip('"').strip("'").strip().lower()
+		return 'linux' in uname and os.path.exists('/var/run/dmesg.boot')
+
+	@staticmethod
+	def has_cpufreq_info():
+		return len(_program_paths('cpufreq-info')) > 0
+
+	@staticmethod
+	def has_sestatus():
+		return len(_program_paths('sestatus')) > 0
+
+	@staticmethod
+	def has_sysctl():
+		return len(_program_paths('sysctl')) > 0
+
+	@staticmethod
+	def has_isainfo():
+		return len(_program_paths('isainfo')) > 0
+
+	@staticmethod
+	def has_kstat():
+		return len(_program_paths('kstat')) > 0
+
+	@staticmethod
+	def has_sysinfo():
+		uname = platform.system().strip().strip('"').strip("'").strip().lower()
+		is_beos = 'beos' in uname or 'haiku' in uname
+		return is_beos and len(_program_paths('sysinfo')) > 0
+
+	@staticmethod
+	def has_lscpu():
+		return len(_program_paths('lscpu')) > 0
+
+	@staticmethod
+	def has_ibm_pa_features():
+		return len(_program_paths('lsprop')) > 0
+
+	@staticmethod
+	def has_wmic():
+		returncode, output = _run_and_get_stdout(['wmic', 'os', 'get', 'Version'])
+		return returncode == 0 and len(output) > 0
+
+	@staticmethod
+	def cat_proc_cpuinfo():
+		return _run_and_get_stdout(['cat', '/proc/cpuinfo'])
+
+	@staticmethod
+	def cpufreq_info():
+		return _run_and_get_stdout(['cpufreq-info'])
+
+	@staticmethod
+	def sestatus_b():
+		return _run_and_get_stdout(['sestatus', '-b'])
+
+	@staticmethod
+	def dmesg_a():
+		return _run_and_get_stdout(['dmesg', '-a'])
+
+	@staticmethod
+	def cat_var_run_dmesg_boot():
+		return _run_and_get_stdout(['cat', '/var/run/dmesg.boot'])
+
+	@staticmethod
+	def sysctl_machdep_cpu_hw_cpufrequency():
+		return _run_and_get_stdout(['sysctl', 'machdep.cpu', 'hw.cpufrequency'])
+
+	@staticmethod
+	def isainfo_vb():
+		return _run_and_get_stdout(['isainfo', '-vb'])
+
+	@staticmethod
+	def kstat_m_cpu_info():
+		return _run_and_get_stdout(['kstat', '-m', 'cpu_info'])
+
+	@staticmethod
+	def sysinfo_cpu():
+		return _run_and_get_stdout(['sysinfo', '-cpu'])
+
+	@staticmethod
+	def lscpu():
+		return _run_and_get_stdout(['lscpu'])
+
+	@staticmethod
+	def ibm_pa_features():
+		import glob
+
+		ibm_features = glob.glob('/proc/device-tree/cpus/*/ibm,pa-features')
+		if ibm_features:
+			return _run_and_get_stdout(['lsprop', ibm_features[0]])
+
+	@staticmethod
+	def wmic_cpu():
+		return _run_and_get_stdout(['wmic', 'cpu', 'get', 'Name,CurrentClockSpeed,L2CacheSize,L3CacheSize,Description,Caption,Manufacturer', '/format:list'])
+
+	@staticmethod
+	def winreg_processor_brand():
+		processor_brand = _read_windows_registry_key(r"Hardware\Description\System\CentralProcessor\0", "ProcessorNameString")
+		return processor_brand.strip()
+
+	@staticmethod
+	def winreg_vendor_id_raw():
+		vendor_id_raw = _read_windows_registry_key(r"Hardware\Description\System\CentralProcessor\0", "VendorIdentifier")
+		return vendor_id_raw
+
+	@staticmethod
+	def winreg_arch_string_raw():
+		arch_string_raw = _read_windows_registry_key(r"SYSTEM\CurrentControlSet\Control\Session Manager\Environment", "PROCESSOR_ARCHITECTURE")
+		return arch_string_raw
+
+	@staticmethod
+	def winreg_hz_actual():
+		hz_actual = _read_windows_registry_key(r"Hardware\Description\System\CentralProcessor\0", "~Mhz")
+		hz_actual = _to_decimal_string(hz_actual)
+		return hz_actual
+
+	@staticmethod
+	def winreg_feature_bits():
+		feature_bits = _read_windows_registry_key(r"Hardware\Description\System\CentralProcessor\0", "FeatureSet")
+		return feature_bits
+
+
+def _program_paths(program_name):
+	paths = []
+	exts = filter(None, os.environ.get('PATHEXT', '').split(os.pathsep))
+	for p in os.environ['PATH'].split(os.pathsep):
+		p = os.path.join(p, program_name)
+		if os.access(p, os.X_OK):
+			paths.append(p)
+		for e in exts:
+			pext = p + e
+			if os.access(pext, os.X_OK):
+				paths.append(pext)
+	return paths
+
+def _run_and_get_stdout(command, pipe_command=None):
+	from subprocess import Popen, PIPE
+
+	g_trace.command_header('Running command "' + ' '.join(command) + '" ...')
+
+	# Run the command normally
+	if not pipe_command:
+		p1 = Popen(command, stdout=PIPE, stderr=PIPE, stdin=PIPE)
+	# Run the command and pipe it into another command
+	else:
+		p2 = Popen(command, stdout=PIPE, stderr=PIPE, stdin=PIPE)
+		p1 = Popen(pipe_command, stdin=p2.stdout, stdout=PIPE, stderr=PIPE)
+		p2.stdout.close()
+
+	# Get the stdout and stderr
+	stdout_output, stderr_output = p1.communicate()
+	stdout_output = stdout_output.decode(encoding='UTF-8')
+	stderr_output = stderr_output.decode(encoding='UTF-8')
+
+	# Send the result to the logger
+	g_trace.command_output('return code:', str(p1.returncode))
+	g_trace.command_output('stdout:', stdout_output)
+
+	# Return the return code and stdout
+	return p1.returncode, stdout_output
+
+def _read_windows_registry_key(key_name, field_name):
+	g_trace.command_header('Reading Registry key "{0}" field "{1}" ...'.format(key_name, field_name))
+
+	try:
+		import _winreg as winreg
+	except ImportError as err:
+		try:
+			import winreg
+		except ImportError as err:
+			pass
+
+	key = winreg.OpenKey(winreg.HKEY_LOCAL_MACHINE, key_name)
+	value = winreg.QueryValueEx(key, field_name)[0]
+	winreg.CloseKey(key)
+	g_trace.command_output('value:', str(value))
+	return value
+
+# Make sure we are running on a supported system
+def _check_arch():
+	arch, bits = _parse_arch(DataSource.arch_string_raw)
+	if not arch in ['X86_32', 'X86_64', 'ARM_7', 'ARM_8',
+	               'PPC_64', 'S390X', 'MIPS_32', 'MIPS_64',
+				   "RISCV_32", "RISCV_64"]:
+		raise Exception("py-cpuinfo currently only works on X86 "
+		                "and some ARM/PPC/S390X/MIPS/RISCV CPUs.")
+
+def _obj_to_b64(thing):
+	import pickle
+	import base64
+
+	a = thing
+	b = pickle.dumps(a)
+	c = base64.b64encode(b)
+	d = c.decode('utf8')
+	return d
+
+def _b64_to_obj(thing):
+	import pickle
+	import base64
+
+	try:
+		a = base64.b64decode(thing)
+		b = pickle.loads(a)
+		return b
+	except Exception:
+		return {}
+
+def _utf_to_str(input):
+	if isinstance(input, list):
+		return [_utf_to_str(element) for element in input]
+	elif isinstance(input, dict):
+		return {_utf_to_str(key): _utf_to_str(value)
+			for key, value in input.items()}
+	else:
+		return input
+
+def _copy_new_fields(info, new_info):
+	keys = [
+		'vendor_id_raw', 'hardware_raw', 'brand_raw', 'hz_advertised_friendly', 'hz_actual_friendly',
+		'hz_advertised', 'hz_actual', 'arch', 'bits', 'count',
+		'arch_string_raw', 'uname_string_raw',
+		'l2_cache_size', 'l2_cache_line_size', 'l2_cache_associativity',
+		'stepping', 'model', 'family',
+		'processor_type', 'flags',
+		'l3_cache_size', 'l1_data_cache_size', 'l1_instruction_cache_size'
+	]
+
+	g_trace.keys(keys, info, new_info)
+
+	# Update the keys with new values
+	for key in keys:
+		if new_info.get(key, None) and not info.get(key, None):
+			info[key] = new_info[key]
+		elif key == 'flags' and new_info.get('flags'):
+			for f in new_info['flags']:
+				if f not in info['flags']: info['flags'].append(f)
+			info['flags'].sort()
+
+def _get_field_actual(cant_be_number, raw_string, field_names):
+	for line in raw_string.splitlines():
+		for field_name in field_names:
+			field_name = field_name.lower()
+			if ':' in line:
+				left, right = line.split(':', 1)
+				left = left.strip().lower()
+				right = right.strip()
+				if left == field_name and len(right) > 0:
+					if cant_be_number:
+						if not right.isdigit():
+							return right
+					else:
+						return right
+
+	return None
+
+def _get_field(cant_be_number, raw_string, convert_to, default_value, *field_names):
+	retval = _get_field_actual(cant_be_number, raw_string, field_names)
+
+	# Convert the return value
+	if retval and convert_to:
+		try:
+			retval = convert_to(retval)
+		except Exception:
+			retval = default_value
+
+	# Return the default if there is no return value
+	if retval is None:
+		retval = default_value
+
+	return retval
+
+def _to_decimal_string(ticks):
+	try:
+		# Convert to string
+		ticks = '{0}'.format(ticks)
+		# Sometimes ',' is used as a decimal separator
+		ticks = ticks.replace(',', '.')
+
+		# Strip off non numbers and decimal places
+		ticks = "".join(n for n in ticks if n.isdigit() or n=='.').strip()
+		if ticks == '':
+			ticks = '0'
+
+		# Add decimal if missing
+		if '.' not in ticks:
+			ticks = '{0}.0'.format(ticks)
+
+		# Remove trailing zeros
+		ticks = ticks.rstrip('0')
+
+		# Add one trailing zero for empty right side
+		if ticks.endswith('.'):
+			ticks = '{0}0'.format(ticks)
+
+		# Make sure the number can be converted to a float
+		ticks = float(ticks)
+		ticks = '{0}'.format(ticks)
+		return ticks
+	except Exception:
+		return '0.0'
+
+def _hz_short_to_full(ticks, scale):
+	try:
+		# Make sure the number can be converted to a float
+		ticks = float(ticks)
+		ticks = '{0}'.format(ticks)
+
+		# Scale the numbers
+		hz = ticks.lstrip('0')
+		old_index = hz.index('.')
+		hz = hz.replace('.', '')
+		hz = hz.ljust(scale + old_index+1, '0')
+		new_index = old_index + scale
+		hz = '{0}.{1}'.format(hz[:new_index], hz[new_index:])
+		left, right = hz.split('.')
+		left, right = int(left), int(right)
+		return (left, right)
+	except Exception:
+		return (0, 0)
+
+def _hz_friendly_to_full(hz_string):
+	try:
+		hz_string = hz_string.strip().lower()
+		hz, scale = (None, None)
+
+		if hz_string.endswith('ghz'):
+			scale = 9
+		elif hz_string.endswith('mhz'):
+			scale = 6
+		elif hz_string.endswith('hz'):
+			scale = 0
+
+		hz = "".join(n for n in hz_string if n.isdigit() or n=='.').strip()
+		if not '.' in hz:
+			hz += '.0'
+
+		hz, scale = _hz_short_to_full(hz, scale)
+
+		return (hz, scale)
+	except Exception:
+		return (0, 0)
+
+def _hz_short_to_friendly(ticks, scale):
+	try:
+		# Get the raw Hz as a string
+		left, right = _hz_short_to_full(ticks, scale)
+		result = '{0}.{1}'.format(left, right)
+
+		# Get the location of the dot, and remove said dot
+		dot_index = result.index('.')
+		result = result.replace('.', '')
+
+		# Get the Hz symbol and scale
+		symbol = "Hz"
+		scale = 0
+		if dot_index > 9:
+			symbol = "GHz"
+			scale = 9
+		elif dot_index > 6:
+			symbol = "MHz"
+			scale = 6
+		elif dot_index > 3:
+			symbol = "KHz"
+			scale = 3
+
+		# Get the Hz with the dot at the new scaled point
+		result = '{0}.{1}'.format(result[:-scale-1], result[-scale-1:])
+
+		# Format the ticks to have 4 numbers after the decimal
+		# and remove any superfluous zeroes.
+		result = '{0:.4f} {1}'.format(float(result), symbol)
+		result = result.rstrip('0')
+		return result
+	except Exception:
+		return '0.0000 Hz'
+
+def _to_friendly_bytes(input):
+	import re
+
+	if not input:
+		return input
+	input = "{0}".format(input)
+
+	formats = {
+		r"^[0-9]+B$" : 'B',
+		r"^[0-9]+K$" : 'KB',
+		r"^[0-9]+M$" : 'MB',
+		r"^[0-9]+G$" : 'GB'
+	}
+
+	for pattern, friendly_size in formats.items():
+		if re.match(pattern, input):
+			return "{0} {1}".format(input[ : -1].strip(), friendly_size)
+
+	return input
+
+def _friendly_bytes_to_int(friendly_bytes):
+	input = friendly_bytes.lower()
+
+	formats = [
+		{'gib' : 1024 * 1024 * 1024},
+		{'mib' : 1024 * 1024},
+		{'kib' : 1024},
+
+		{'gb' : 1024 * 1024 * 1024},
+		{'mb' : 1024 * 1024},
+		{'kb' : 1024},
+
+		{'g' : 1024 * 1024 * 1024},
+		{'m' : 1024 * 1024},
+		{'k' : 1024},
+		{'b' : 1},
+	]
+
+	try:
+		for entry in formats:
+			pattern = list(entry.keys())[0]
+			multiplier = list(entry.values())[0]
+			if input.endswith(pattern):
+				return int(input.split(pattern)[0].strip()) * multiplier
+
+	except Exception as err:
+		pass
+
+	return friendly_bytes
+
+def _parse_cpu_brand_string(cpu_string):
+	# Just return 0 if the processor brand does not have the Hz
+	if not 'hz' in cpu_string.lower():
+		return ('0.0', 0)
+
+	hz = cpu_string.lower()
+	scale = 0
+
+	if hz.endswith('mhz'):
+		scale = 6
+	elif hz.endswith('ghz'):
+		scale = 9
+	if '@' in hz:
+		hz = hz.split('@')[1]
+	else:
+		hz = hz.rsplit(None, 1)[1]
+
+	hz = hz.rstrip('mhz').rstrip('ghz').strip()
+	hz = _to_decimal_string(hz)
+
+	return (hz, scale)
+
+def _parse_cpu_brand_string_dx(cpu_string):
+	import re
+
+	# Find all the strings inside brackets ()
+	starts = [m.start() for m in re.finditer(r"\(", cpu_string)]
+	ends = [m.start() for m in re.finditer(r"\)", cpu_string)]
+	insides = {k: v for k, v in zip(starts, ends)}
+	insides = [cpu_string[start+1 : end] for start, end in insides.items()]
+
+	# Find all the fields
+	vendor_id, stepping, model, family = (None, None, None, None)
+	for inside in insides:
+		for pair in inside.split(','):
+			pair = [n.strip() for n in pair.split(':')]
+			if len(pair) > 1:
+				name, value = pair[0], pair[1]
+				if name == 'origin':
+					vendor_id = value.strip('"')
+				elif name == 'stepping':
+					stepping = int(value.lstrip('0x'), 16)
+				elif name == 'model':
+					model = int(value.lstrip('0x'), 16)
+				elif name in ['fam', 'family']:
+					family = int(value.lstrip('0x'), 16)
+
+	# Find the Processor Brand
+	# Strip off extra strings in brackets at end
+	brand = cpu_string.strip()
+	is_working = True
+	while is_working:
+		is_working = False
+		for inside in insides:
+			full = "({0})".format(inside)
+			if brand.endswith(full):
+				brand = brand[ :-len(full)].strip()
+				is_working = True
+
+	# Find the Hz in the brand string
+	hz_brand, scale = _parse_cpu_brand_string(brand)
+
+	# Find Hz inside brackets () after the brand string
+	if hz_brand == '0.0':
+		for inside in insides:
+			hz = inside
+			for entry in ['GHz', 'MHz', 'Hz']:
+				if entry in hz:
+					hz = "CPU @ " + hz[ : hz.find(entry) + len(entry)]
+					hz_brand, scale = _parse_cpu_brand_string(hz)
+					break
+
+	return (hz_brand, scale, brand, vendor_id, stepping, model, family)
+
+def _parse_dmesg_output(output):
+	try:
+		# Get all the dmesg lines that might contain a CPU string
+		lines = output.split(' CPU0:')[1:] + \
+				output.split(' CPU1:')[1:] + \
+				output.split(' CPU:')[1:] + \
+				output.split('\nCPU0:')[1:] + \
+				output.split('\nCPU1:')[1:] + \
+				output.split('\nCPU:')[1:]
+		lines = [l.split('\n')[0].strip() for l in lines]
+
+		# Convert the lines to CPU strings
+		cpu_strings = [_parse_cpu_brand_string_dx(l) for l in lines]
+
+		# Find the CPU string that has the most fields
+		best_string = None
+		highest_count = 0
+		for cpu_string in cpu_strings:
+			count = sum([n is not None for n in cpu_string])
+			if count > highest_count:
+				highest_count = count
+				best_string = cpu_string
+
+		# If no CPU string was found, return {}
+		if not best_string:
+			return {}
+
+		hz_actual, scale, processor_brand, vendor_id, stepping, model, family = best_string
+
+		# Origin
+		if '  Origin=' in output:
+			fields = output[output.find('  Origin=') : ].split('\n')[0]
+			fields = fields.strip().split()
+			fields = [n.strip().split('=') for n in fields]
+			fields = [{n[0].strip().lower() : n[1].strip()} for n in fields]
+
+			for field in fields:
+				name = list(field.keys())[0]
+				value = list(field.values())[0]
+
+				if name == 'origin':
+					vendor_id = value.strip('"')
+				elif name == 'stepping':
+					stepping = int(value.lstrip('0x'), 16)
+				elif name == 'model':
+					model = int(value.lstrip('0x'), 16)
+				elif name in ['fam', 'family']:
+					family = int(value.lstrip('0x'), 16)
+
+		# Features
+		flag_lines = []
+		for category in ['  Features=', '  Features2=', '  AMD Features=', '  AMD Features2=']:
+			if category in output:
+				flag_lines.append(output.split(category)[1].split('\n')[0])
+
+		flags = []
+		for line in flag_lines:
+			line = line.split('<')[1].split('>')[0].lower()
+			for flag in line.split(','):
+				flags.append(flag)
+		flags.sort()
+
+		# Convert from GHz/MHz string to Hz
+		hz_advertised, scale = _parse_cpu_brand_string(processor_brand)
+
+		# If advertised hz not found, use the actual hz
+		if hz_advertised == '0.0':
+			scale = 6
+			hz_advertised = _to_decimal_string(hz_actual)
+
+		info = {
+		'vendor_id_raw' : vendor_id,
+		'brand_raw' : processor_brand,
+
+		'stepping' : stepping,
+		'model' : model,
+		'family' : family,
+		'flags' : flags
+		}
+
+		if hz_advertised and hz_advertised != '0.0':
+			info['hz_advertised_friendly'] = _hz_short_to_friendly(hz_advertised, scale)
+			info['hz_actual_friendly'] = _hz_short_to_friendly(hz_actual, scale)
+
+		if hz_advertised and hz_advertised != '0.0':
+			info['hz_advertised'] = _hz_short_to_full(hz_advertised, scale)
+			info['hz_actual'] = _hz_short_to_full(hz_actual, scale)
+
+		return {k: v for k, v in info.items() if v}
+	except Exception as err:
+		g_trace.fail(err)
+		#raise
+
+	return {}
+
+def _parse_arch(arch_string_raw):
+	import re
+
+	arch, bits = None, None
+	arch_string_raw = arch_string_raw.lower()
+
+	# X86
+	if re.match(r'^i\d86$|^x86$|^x86_32$|^i86pc$|^ia32$|^ia-32$|^bepc$', arch_string_raw):
+		arch = 'X86_32'
+		bits = 32
+	elif re.match(r'^x64$|^x86_64$|^x86_64t$|^i686-64$|^amd64$|^ia64$|^ia-64$', arch_string_raw):
+		arch = 'X86_64'
+		bits = 64
+	# ARM
+	elif re.match(r'^armv8-a|aarch64|arm64$', arch_string_raw):
+		arch = 'ARM_8'
+		bits = 64
+	elif re.match(r'^armv7$|^armv7[a-z]$|^armv7-[a-z]$|^armv6[a-z]$', arch_string_raw):
+		arch = 'ARM_7'
+		bits = 32
+	elif re.match(r'^armv8$|^armv8[a-z]$|^armv8-[a-z]$', arch_string_raw):
+		arch = 'ARM_8'
+		bits = 32
+	# PPC
+	elif re.match(r'^ppc32$|^prep$|^pmac$|^powermac$', arch_string_raw):
+		arch = 'PPC_32'
+		bits = 32
+	elif re.match(r'^powerpc$|^ppc64$|^ppc64le$', arch_string_raw):
+		arch = 'PPC_64'
+		bits = 64
+	# SPARC
+	elif re.match(r'^sparc32$|^sparc$', arch_string_raw):
+		arch = 'SPARC_32'
+		bits = 32
+	elif re.match(r'^sparc64$|^sun4u$|^sun4v$', arch_string_raw):
+		arch = 'SPARC_64'
+		bits = 64
+	# S390X
+	elif re.match(r'^s390x$', arch_string_raw):
+		arch = 'S390X'
+		bits = 64
+	elif arch_string_raw == 'mips':
+		arch = 'MIPS_32'
+		bits = 32
+	elif arch_string_raw == 'mips64':
+		arch = 'MIPS_64'
+		bits = 64
+	# RISCV
+	elif re.match(r'^riscv$|^riscv32$|^riscv32be$', arch_string_raw):
+		arch = 'RISCV_32'
+		bits = 32
+	elif re.match(r'^riscv64$|^riscv64be$', arch_string_raw):
+		arch = 'RISCV_64'
+		bits = 64
+
+	return (arch, bits)
+
+def _is_bit_set(reg, bit):
+	mask = 1 << bit
+	is_set = reg & mask > 0
+	return is_set
+
+
+def _is_selinux_enforcing(trace):
+	# Just return if the SE Linux Status Tool is not installed
+	if not DataSource.has_sestatus():
+		trace.fail('Failed to find sestatus.')
+		return False
+
+	# Run the sestatus, and just return if it failed to run
+	returncode, output = DataSource.sestatus_b()
+	if returncode != 0:
+		trace.fail('Failed to run sestatus. Skipping ...')
+		return False
+
+	# Figure out if explicitly in enforcing mode
+	for line in output.splitlines():
+		line = line.strip().lower()
+		if line.startswith("current mode:"):
+			if line.endswith("enforcing"):
+				return True
+			else:
+				return False
+
+	# Figure out if we can execute heap and execute memory
+	can_selinux_exec_heap = False
+	can_selinux_exec_memory = False
+	for line in output.splitlines():
+		line = line.strip().lower()
+		if line.startswith("allow_execheap") and line.endswith("on"):
+			can_selinux_exec_heap = True
+		elif line.startswith("allow_execmem") and line.endswith("on"):
+			can_selinux_exec_memory = True
+
+	trace.command_output('can_selinux_exec_heap:', can_selinux_exec_heap)
+	trace.command_output('can_selinux_exec_memory:', can_selinux_exec_memory)
+
+	return (not can_selinux_exec_heap or not can_selinux_exec_memory)
+
+def _filter_dict_keys_with_empty_values(info, acceptable_values = {}):
+	filtered_info = {}
+	for key in info:
+		value = info[key]
+
+		# Keep if value is acceptable
+		if key in acceptable_values:
+			if acceptable_values[key] == value:
+				filtered_info[key] = value
+				continue
+
+		# Filter out None, 0, "", (), {}, []
+		if not value:
+			continue
+
+		# Filter out (0, 0)
+		if value == (0, 0):
+			continue
+
+		# Filter out -1
+		if value == -1:
+			continue
+
+		# Filter out strings that start with "0.0"
+		if type(value) == str and value.startswith('0.0'):
+			continue
+
+		filtered_info[key] = value
+
+	return filtered_info
+
+class ASM(object):
+	def __init__(self, restype=None, argtypes=(), machine_code=[]):
+		self.restype = restype
+		self.argtypes = argtypes
+		self.machine_code = machine_code
+		self.prochandle = None
+		self.mm = None
+		self.func = None
+		self.address = None
+		self.size = 0
+
+	def compile(self):
+		machine_code = bytes.join(b'', self.machine_code)
+		self.size = ctypes.c_size_t(len(machine_code))
+
+		if DataSource.is_windows:
+			# Allocate a memory segment the size of the machine code, and make it executable
+			size = len(machine_code)
+			# Alloc at least 1 page to ensure we own all pages that we want to change protection on
+			if size < 0x1000: size = 0x1000
+			MEM_COMMIT = ctypes.c_ulong(0x1000)
+			PAGE_READWRITE = ctypes.c_ulong(0x4)
+			pfnVirtualAlloc = ctypes.windll.kernel32.VirtualAlloc
+			pfnVirtualAlloc.restype = ctypes.c_void_p
+			self.address = pfnVirtualAlloc(None, ctypes.c_size_t(size), MEM_COMMIT, PAGE_READWRITE)
+			if not self.address:
+				raise Exception("Failed to VirtualAlloc")
+
+			# Copy the machine code into the memory segment
+			memmove = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p, ctypes.c_void_p, ctypes.c_size_t)(ctypes._memmove_addr)
+			if memmove(self.address, machine_code, size) < 0:
+				raise Exception("Failed to memmove")
+
+			# Enable execute permissions
+			PAGE_EXECUTE = ctypes.c_ulong(0x10)
+			old_protect = ctypes.c_ulong(0)
+			pfnVirtualProtect = ctypes.windll.kernel32.VirtualProtect
+			res = pfnVirtualProtect(ctypes.c_void_p(self.address), ctypes.c_size_t(size), PAGE_EXECUTE, ctypes.byref(old_protect))
+			if not res:
+				raise Exception("Failed VirtualProtect")
+
+			# Flush Instruction Cache
+			# First, get process Handle
+			if not self.prochandle:
+				pfnGetCurrentProcess = ctypes.windll.kernel32.GetCurrentProcess
+				pfnGetCurrentProcess.restype = ctypes.c_void_p
+				self.prochandle = ctypes.c_void_p(pfnGetCurrentProcess())
+			# Actually flush cache
+			res = ctypes.windll.kernel32.FlushInstructionCache(self.prochandle, ctypes.c_void_p(self.address), ctypes.c_size_t(size))
+			if not res:
+				raise Exception("Failed FlushInstructionCache")
+		else:
+			from mmap import mmap, MAP_PRIVATE, MAP_ANONYMOUS, PROT_WRITE, PROT_READ, PROT_EXEC
+
+			# Allocate a private and executable memory segment the size of the machine code
+			machine_code = bytes.join(b'', self.machine_code)
+			self.size = len(machine_code)
+			self.mm = mmap(-1, self.size, flags=MAP_PRIVATE | MAP_ANONYMOUS, prot=PROT_WRITE | PROT_READ | PROT_EXEC)
+
+			# Copy the machine code into the memory segment
+			self.mm.write(machine_code)
+			self.address = ctypes.addressof(ctypes.c_int.from_buffer(self.mm))
+
+		# Cast the memory segment into a function
+		functype = ctypes.CFUNCTYPE(self.restype, *self.argtypes)
+		self.func = functype(self.address)
+
+	def run(self):
+		# Call the machine code like a function
+		retval = self.func()
+
+		return retval
+
+	def free(self):
+		# Free the function memory segment
+		if DataSource.is_windows:
+			MEM_RELEASE = ctypes.c_ulong(0x8000)
+			ctypes.windll.kernel32.VirtualFree(ctypes.c_void_p(self.address), ctypes.c_size_t(0), MEM_RELEASE)
+		else:
+			self.mm.close()
+
+		self.prochandle = None
+		self.mm = None
+		self.func = None
+		self.address = None
+		self.size = 0
+
+
+class CPUID(object):
+	def __init__(self, trace=None):
+		if trace is None:
+			trace = Trace(False, False)
+
+		# Figure out if SE Linux is on and in enforcing mode
+		self.is_selinux_enforcing = _is_selinux_enforcing(trace)
+
+	def _asm_func(self, restype=None, argtypes=(), machine_code=[]):
+		asm = ASM(restype, argtypes, machine_code)
+		asm.compile()
+		return asm
+
+	def _run_asm(self, *machine_code):
+		asm = ASM(ctypes.c_uint32, (), machine_code)
+		asm.compile()
+		retval = asm.run()
+		asm.free()
+		return retval
+
+	# http://en.wikipedia.org/wiki/CPUID#EAX.3D0:_Get_vendor_ID
+	def get_vendor_id(self):
+		# EBX
+		ebx = self._run_asm(
+			b"\x31\xC0",        # xor eax,eax
+			b"\x0F\xA2"         # cpuid
+			b"\x89\xD8"         # mov ax,bx
+			b"\xC3"             # ret
+		)
+
+		# ECX
+		ecx = self._run_asm(
+			b"\x31\xC0",        # xor eax,eax
+			b"\x0f\xa2"         # cpuid
+			b"\x89\xC8"         # mov ax,cx
+			b"\xC3"             # ret
+		)
+
+		# EDX
+		edx = self._run_asm(
+			b"\x31\xC0",        # xor eax,eax
+			b"\x0f\xa2"         # cpuid
+			b"\x89\xD0"         # mov ax,dx
+			b"\xC3"             # ret
+		)
+
+		# Each 4bits is a ascii letter in the name
+		vendor_id = []
+		for reg in [ebx, edx, ecx]:
+			for n in [0, 8, 16, 24]:
+				vendor_id.append(chr((reg >> n) & 0xFF))
+		vendor_id = ''.join(vendor_id)
+
+		return vendor_id
+
+	# http://en.wikipedia.org/wiki/CPUID#EAX.3D1:_Processor_Info_and_Feature_Bits
+	def get_info(self):
+		# EAX
+		eax = self._run_asm(
+			b"\xB8\x01\x00\x00\x00",   # mov eax,0x1"
+			b"\x0f\xa2"                # cpuid
+			b"\xC3"                    # ret
+		)
+
+		# Get the CPU info
+		stepping_id = (eax >> 0) & 0xF # 4 bits
+		model = (eax >> 4) & 0xF # 4 bits
+		family_id = (eax >> 8) & 0xF # 4 bits
+		processor_type = (eax >> 12) & 0x3 # 2 bits
+		extended_model_id = (eax >> 16) & 0xF # 4 bits
+		extended_family_id = (eax >> 20) & 0xFF # 8 bits
+		family = 0
+
+		if family_id in [15]:
+			family = extended_family_id + family_id
+		else:
+			family = family_id
+
+		if family_id in [6, 15]:
+			model = (extended_model_id << 4) + model
+
+		return {
+			'stepping' : stepping_id,
+			'model' : model,
+			'family' : family,
+			'processor_type' : processor_type
+		}
+
+	# http://en.wikipedia.org/wiki/CPUID#EAX.3D80000000h:_Get_Highest_Extended_Function_Supported
+	def get_max_extension_support(self):
+		# Check for extension support
+		max_extension_support = self._run_asm(
+			b"\xB8\x00\x00\x00\x80" # mov ax,0x80000000
+			b"\x0f\xa2"             # cpuid
+			b"\xC3"                 # ret
+		)
+
+		return max_extension_support
+
+	# http://en.wikipedia.org/wiki/CPUID#EAX.3D1:_Processor_Info_and_Feature_Bits
+	def get_flags(self, max_extension_support):
+		# EDX
+		edx = self._run_asm(
+			b"\xB8\x01\x00\x00\x00",   # mov eax,0x1"
+			b"\x0f\xa2"                # cpuid
+			b"\x89\xD0"                # mov ax,dx
+			b"\xC3"                    # ret
+		)
+
+		# ECX
+		ecx = self._run_asm(
+			b"\xB8\x01\x00\x00\x00",   # mov eax,0x1"
+			b"\x0f\xa2"                # cpuid
+			b"\x89\xC8"                # mov ax,cx
+			b"\xC3"                    # ret
+		)
+
+		# Get the CPU flags
+		flags = {
+			'fpu' : _is_bit_set(edx, 0),
+			'vme' : _is_bit_set(edx, 1),
+			'de' : _is_bit_set(edx, 2),
+			'pse' : _is_bit_set(edx, 3),
+			'tsc' : _is_bit_set(edx, 4),
+			'msr' : _is_bit_set(edx, 5),
+			'pae' : _is_bit_set(edx, 6),
+			'mce' : _is_bit_set(edx, 7),
+			'cx8' : _is_bit_set(edx, 8),
+			'apic' : _is_bit_set(edx, 9),
+			#'reserved1' : _is_bit_set(edx, 10),
+			'sep' : _is_bit_set(edx, 11),
+			'mtrr' : _is_bit_set(edx, 12),
+			'pge' : _is_bit_set(edx, 13),
+			'mca' : _is_bit_set(edx, 14),
+			'cmov' : _is_bit_set(edx, 15),
+			'pat' : _is_bit_set(edx, 16),
+			'pse36' : _is_bit_set(edx, 17),
+			'pn' : _is_bit_set(edx, 18),
+			'clflush' : _is_bit_set(edx, 19),
+			#'reserved2' : _is_bit_set(edx, 20),
+			'dts' : _is_bit_set(edx, 21),
+			'acpi' : _is_bit_set(edx, 22),
+			'mmx' : _is_bit_set(edx, 23),
+			'fxsr' : _is_bit_set(edx, 24),
+			'sse' : _is_bit_set(edx, 25),
+			'sse2' : _is_bit_set(edx, 26),
+			'ss' : _is_bit_set(edx, 27),
+			'ht' : _is_bit_set(edx, 28),
+			'tm' : _is_bit_set(edx, 29),
+			'ia64' : _is_bit_set(edx, 30),
+			'pbe' : _is_bit_set(edx, 31),
+
+			'pni' : _is_bit_set(ecx, 0),
+			'pclmulqdq' : _is_bit_set(ecx, 1),
+			'dtes64' : _is_bit_set(ecx, 2),
+			'monitor' : _is_bit_set(ecx, 3),
+			'ds_cpl' : _is_bit_set(ecx, 4),
+			'vmx' : _is_bit_set(ecx, 5),
+			'smx' : _is_bit_set(ecx, 6),
+			'est' : _is_bit_set(ecx, 7),
+			'tm2' : _is_bit_set(ecx, 8),
+			'ssse3' : _is_bit_set(ecx, 9),
+			'cid' : _is_bit_set(ecx, 10),
+			#'reserved3' : _is_bit_set(ecx, 11),
+			'fma' : _is_bit_set(ecx, 12),
+			'cx16' : _is_bit_set(ecx, 13),
+			'xtpr' : _is_bit_set(ecx, 14),
+			'pdcm' : _is_bit_set(ecx, 15),
+			#'reserved4' : _is_bit_set(ecx, 16),
+			'pcid' : _is_bit_set(ecx, 17),
+			'dca' : _is_bit_set(ecx, 18),
+			'sse4_1' : _is_bit_set(ecx, 19),
+			'sse4_2' : _is_bit_set(ecx, 20),
+			'x2apic' : _is_bit_set(ecx, 21),
+			'movbe' : _is_bit_set(ecx, 22),
+			'popcnt' : _is_bit_set(ecx, 23),
+			'tscdeadline' : _is_bit_set(ecx, 24),
+			'aes' : _is_bit_set(ecx, 25),
+			'xsave' : _is_bit_set(ecx, 26),
+			'osxsave' : _is_bit_set(ecx, 27),
+			'avx' : _is_bit_set(ecx, 28),
+			'f16c' : _is_bit_set(ecx, 29),
+			'rdrnd' : _is_bit_set(ecx, 30),
+			'hypervisor' : _is_bit_set(ecx, 31)
+		}
+
+		# Get a list of only the flags that are true
+		flags = [k for k, v in flags.items() if v]
+
+		# http://en.wikipedia.org/wiki/CPUID#EAX.3D7.2C_ECX.3D0:_Extended_Features
+		if max_extension_support >= 7:
+			# EBX
+			ebx = self._run_asm(
+				b"\x31\xC9",            # xor ecx,ecx
+				b"\xB8\x07\x00\x00\x00" # mov eax,7
+				b"\x0f\xa2"         # cpuid
+				b"\x89\xD8"         # mov ax,bx
+				b"\xC3"             # ret
+			)
+
+			# ECX
+			ecx = self._run_asm(
+				b"\x31\xC9",            # xor ecx,ecx
+				b"\xB8\x07\x00\x00\x00" # mov eax,7
+				b"\x0f\xa2"         # cpuid
+				b"\x89\xC8"         # mov ax,cx
+				b"\xC3"             # ret
+			)
+
+			# Get the extended CPU flags
+			extended_flags = {
+				#'fsgsbase' : _is_bit_set(ebx, 0),
+				#'IA32_TSC_ADJUST' : _is_bit_set(ebx, 1),
+				'sgx' : _is_bit_set(ebx, 2),
+				'bmi1' : _is_bit_set(ebx, 3),
+				'hle' : _is_bit_set(ebx, 4),
+				'avx2' : _is_bit_set(ebx, 5),
+				#'reserved' : _is_bit_set(ebx, 6),
+				'smep' : _is_bit_set(ebx, 7),
+				'bmi2' : _is_bit_set(ebx, 8),
+				'erms' : _is_bit_set(ebx, 9),
+				'invpcid' : _is_bit_set(ebx, 10),
+				'rtm' : _is_bit_set(ebx, 11),
+				'pqm' : _is_bit_set(ebx, 12),
+				#'FPU CS and FPU DS deprecated' : _is_bit_set(ebx, 13),
+				'mpx' : _is_bit_set(ebx, 14),
+				'pqe' : _is_bit_set(ebx, 15),
+				'avx512f' : _is_bit_set(ebx, 16),
+				'avx512dq' : _is_bit_set(ebx, 17),
+				'rdseed' : _is_bit_set(ebx, 18),
+				'adx' : _is_bit_set(ebx, 19),
+				'smap' : _is_bit_set(ebx, 20),
+				'avx512ifma' : _is_bit_set(ebx, 21),
+				'pcommit' : _is_bit_set(ebx, 22),
+				'clflushopt' : _is_bit_set(ebx, 23),
+				'clwb' : _is_bit_set(ebx, 24),
+				'intel_pt' : _is_bit_set(ebx, 25),
+				'avx512pf' : _is_bit_set(ebx, 26),
+				'avx512er' : _is_bit_set(ebx, 27),
+				'avx512cd' : _is_bit_set(ebx, 28),
+				'sha' : _is_bit_set(ebx, 29),
+				'avx512bw' : _is_bit_set(ebx, 30),
+				'avx512vl' : _is_bit_set(ebx, 31),
+
+				'prefetchwt1' : _is_bit_set(ecx, 0),
+				'avx512vbmi' : _is_bit_set(ecx, 1),
+				'umip' : _is_bit_set(ecx, 2),
+				'pku' : _is_bit_set(ecx, 3),
+				'ospke' : _is_bit_set(ecx, 4),
+				#'reserved' : _is_bit_set(ecx, 5),
+				'avx512vbmi2' : _is_bit_set(ecx, 6),
+				#'reserved' : _is_bit_set(ecx, 7),
+				'gfni' : _is_bit_set(ecx, 8),
+				'vaes' : _is_bit_set(ecx, 9),
+				'vpclmulqdq' : _is_bit_set(ecx, 10),
+				'avx512vnni' : _is_bit_set(ecx, 11),
+				'avx512bitalg' : _is_bit_set(ecx, 12),
+				#'reserved' : _is_bit_set(ecx, 13),
+				'avx512vpopcntdq' : _is_bit_set(ecx, 14),
+				#'reserved' : _is_bit_set(ecx, 15),
+				#'reserved' : _is_bit_set(ecx, 16),
+				#'mpx0' : _is_bit_set(ecx, 17),
+				#'mpx1' : _is_bit_set(ecx, 18),
+				#'mpx2' : _is_bit_set(ecx, 19),
+				#'mpx3' : _is_bit_set(ecx, 20),
+				#'mpx4' : _is_bit_set(ecx, 21),
+				'rdpid' : _is_bit_set(ecx, 22),
+				#'reserved' : _is_bit_set(ecx, 23),
+				#'reserved' : _is_bit_set(ecx, 24),
+				#'reserved' : _is_bit_set(ecx, 25),
+				#'reserved' : _is_bit_set(ecx, 26),
+				#'reserved' : _is_bit_set(ecx, 27),
+				#'reserved' : _is_bit_set(ecx, 28),
+				#'reserved' : _is_bit_set(ecx, 29),
+				'sgx_lc' : _is_bit_set(ecx, 30),
+				#'reserved' : _is_bit_set(ecx, 31)
+			}
+
+			# Get a list of only the flags that are true
+			extended_flags = [k for k, v in extended_flags.items() if v]
+			flags += extended_flags
+
+		# http://en.wikipedia.org/wiki/CPUID#EAX.3D80000001h:_Extended_Processor_Info_and_Feature_Bits
+		if max_extension_support >= 0x80000001:
+			# EBX
+			ebx = self._run_asm(
+				b"\xB8\x01\x00\x00\x80" # mov ax,0x80000001
+				b"\x0f\xa2"         # cpuid
+				b"\x89\xD8"         # mov ax,bx
+				b"\xC3"             # ret
+			)
+
+			# ECX
+			ecx = self._run_asm(
+				b"\xB8\x01\x00\x00\x80" # mov ax,0x80000001
+				b"\x0f\xa2"         # cpuid
+				b"\x89\xC8"         # mov ax,cx
+				b"\xC3"             # ret
+			)
+
+			# Get the extended CPU flags
+			extended_flags = {
+				'fpu' : _is_bit_set(ebx, 0),
+				'vme' : _is_bit_set(ebx, 1),
+				'de' : _is_bit_set(ebx, 2),
+				'pse' : _is_bit_set(ebx, 3),
+				'tsc' : _is_bit_set(ebx, 4),
+				'msr' : _is_bit_set(ebx, 5),
+				'pae' : _is_bit_set(ebx, 6),
+				'mce' : _is_bit_set(ebx, 7),
+				'cx8' : _is_bit_set(ebx, 8),
+				'apic' : _is_bit_set(ebx, 9),
+				#'reserved' : _is_bit_set(ebx, 10),
+				'syscall' : _is_bit_set(ebx, 11),
+				'mtrr' : _is_bit_set(ebx, 12),
+				'pge' : _is_bit_set(ebx, 13),
+				'mca' : _is_bit_set(ebx, 14),
+				'cmov' : _is_bit_set(ebx, 15),
+				'pat' : _is_bit_set(ebx, 16),
+				'pse36' : _is_bit_set(ebx, 17),
+				#'reserved' : _is_bit_set(ebx, 18),
+				'mp' : _is_bit_set(ebx, 19),
+				'nx' : _is_bit_set(ebx, 20),
+				#'reserved' : _is_bit_set(ebx, 21),
+				'mmxext' : _is_bit_set(ebx, 22),
+				'mmx' : _is_bit_set(ebx, 23),
+				'fxsr' : _is_bit_set(ebx, 24),
+				'fxsr_opt' : _is_bit_set(ebx, 25),
+				'pdpe1gp' : _is_bit_set(ebx, 26),
+				'rdtscp' : _is_bit_set(ebx, 27),
+				#'reserved' : _is_bit_set(ebx, 28),
+				'lm' : _is_bit_set(ebx, 29),
+				'3dnowext' : _is_bit_set(ebx, 30),
+				'3dnow' : _is_bit_set(ebx, 31),
+
+				'lahf_lm' : _is_bit_set(ecx, 0),
+				'cmp_legacy' : _is_bit_set(ecx, 1),
+				'svm' : _is_bit_set(ecx, 2),
+				'extapic' : _is_bit_set(ecx, 3),
+				'cr8_legacy' : _is_bit_set(ecx, 4),
+				'abm' : _is_bit_set(ecx, 5),
+				'sse4a' : _is_bit_set(ecx, 6),
+				'misalignsse' : _is_bit_set(ecx, 7),
+				'3dnowprefetch' : _is_bit_set(ecx, 8),
+				'osvw' : _is_bit_set(ecx, 9),
+				'ibs' : _is_bit_set(ecx, 10),
+				'xop' : _is_bit_set(ecx, 11),
+				'skinit' : _is_bit_set(ecx, 12),
+				'wdt' : _is_bit_set(ecx, 13),
+				#'reserved' : _is_bit_set(ecx, 14),
+				'lwp' : _is_bit_set(ecx, 15),
+				'fma4' : _is_bit_set(ecx, 16),
+				'tce' : _is_bit_set(ecx, 17),
+				#'reserved' : _is_bit_set(ecx, 18),
+				'nodeid_msr' : _is_bit_set(ecx, 19),
+				#'reserved' : _is_bit_set(ecx, 20),
+				'tbm' : _is_bit_set(ecx, 21),
+				'topoext' : _is_bit_set(ecx, 22),
+				'perfctr_core' : _is_bit_set(ecx, 23),
+				'perfctr_nb' : _is_bit_set(ecx, 24),
+				#'reserved' : _is_bit_set(ecx, 25),
+				'dbx' : _is_bit_set(ecx, 26),
+				'perftsc' : _is_bit_set(ecx, 27),
+				'pci_l2i' : _is_bit_set(ecx, 28),
+				#'reserved' : _is_bit_set(ecx, 29),
+				#'reserved' : _is_bit_set(ecx, 30),
+				#'reserved' : _is_bit_set(ecx, 31)
+			}
+
+			# Get a list of only the flags that are true
+			extended_flags = [k for k, v in extended_flags.items() if v]
+			flags += extended_flags
+
+		flags.sort()
+		return flags
+
+	# http://en.wikipedia.org/wiki/CPUID#EAX.3D80000002h.2C80000003h.2C80000004h:_Processor_Brand_String
+	def get_processor_brand(self, max_extension_support):
+		processor_brand = ""
+
+		# Processor brand string
+		if max_extension_support >= 0x80000004:
+			instructions = [
+				b"\xB8\x02\x00\x00\x80", # mov ax,0x80000002
+				b"\xB8\x03\x00\x00\x80", # mov ax,0x80000003
+				b"\xB8\x04\x00\x00\x80"  # mov ax,0x80000004
+			]
+			for instruction in instructions:
+				# EAX
+				eax = self._run_asm(
+					instruction,  # mov ax,0x8000000?
+					b"\x0f\xa2"   # cpuid
+					b"\x89\xC0"   # mov ax,ax
+					b"\xC3"       # ret
+				)
+
+				# EBX
+				ebx = self._run_asm(
+					instruction,  # mov ax,0x8000000?
+					b"\x0f\xa2"   # cpuid
+					b"\x89\xD8"   # mov ax,bx
+					b"\xC3"       # ret
+				)
+
+				# ECX
+				ecx = self._run_asm(
+					instruction,  # mov ax,0x8000000?
+					b"\x0f\xa2"   # cpuid
+					b"\x89\xC8"   # mov ax,cx
+					b"\xC3"       # ret
+				)
+
+				# EDX
+				edx = self._run_asm(
+					instruction,  # mov ax,0x8000000?
+					b"\x0f\xa2"   # cpuid
+					b"\x89\xD0"   # mov ax,dx
+					b"\xC3"       # ret
+				)
+
+				# Combine each of the 4 bytes in each register into the string
+				for reg in [eax, ebx, ecx, edx]:
+					for n in [0, 8, 16, 24]:
+						processor_brand += chr((reg >> n) & 0xFF)
+
+		# Strip off any trailing NULL terminators and white space
+		processor_brand = processor_brand.strip("\0").strip()
+
+		return processor_brand
+
+	# http://en.wikipedia.org/wiki/CPUID#EAX.3D80000006h:_Extended_L2_Cache_Features
+	def get_cache(self, max_extension_support):
+		cache_info = {}
+
+		# Just return if the cache feature is not supported
+		if max_extension_support < 0x80000006:
+			return cache_info
+
+		# ECX
+		ecx = self._run_asm(
+			b"\xB8\x06\x00\x00\x80"  # mov ax,0x80000006
+			b"\x0f\xa2"              # cpuid
+			b"\x89\xC8"              # mov ax,cx
+			b"\xC3"                   # ret
+		)
+
+		cache_info = {
+			'size_b' : (ecx & 0xFF) * 1024,
+			'associativity' : (ecx >> 12) & 0xF,
+			'line_size_b' : (ecx >> 16) & 0xFFFF
+		}
+
+		return cache_info
+
+	def get_ticks_func(self):
+		retval = None
+
+		if DataSource.bits == '32bit':
+			# Works on x86_32
+			restype = None
+			argtypes = (ctypes.POINTER(ctypes.c_uint), ctypes.POINTER(ctypes.c_uint))
+			get_ticks_x86_32 = self._asm_func(restype, argtypes,
+				[
+				b"\x55",         # push bp
+				b"\x89\xE5",     # mov bp,sp
+				b"\x31\xC0",     # xor ax,ax
+				b"\x0F\xA2",     # cpuid
+				b"\x0F\x31",     # rdtsc
+				b"\x8B\x5D\x08", # mov bx,[di+0x8]
+				b"\x8B\x4D\x0C", # mov cx,[di+0xc]
+				b"\x89\x13",     # mov [bp+di],dx
+				b"\x89\x01",     # mov [bx+di],ax
+				b"\x5D",         # pop bp
+				b"\xC3"          # ret
+				]
+			)
+
+			# Monkey patch func to combine high and low args into one return
+			old_func = get_ticks_x86_32.func
+			def new_func():
+				# Pass two uint32s into function
+				high = ctypes.c_uint32(0)
+				low = ctypes.c_uint32(0)
+				old_func(ctypes.byref(high), ctypes.byref(low))
+
+				# Shift the two uint32s into one uint64
+				retval = ((high.value << 32) & 0xFFFFFFFF00000000) | low.value
+				return retval
+			get_ticks_x86_32.func = new_func
+
+			retval = get_ticks_x86_32
+		elif DataSource.bits == '64bit':
+			# Works on x86_64
+			restype = ctypes.c_uint64
+			argtypes = ()
+			get_ticks_x86_64 = self._asm_func(restype, argtypes,
+				[
+				b"\x48",         # dec ax
+				b"\x31\xC0",     # xor ax,ax
+				b"\x0F\xA2",     # cpuid
+				b"\x0F\x31",     # rdtsc
+				b"\x48",         # dec ax
+				b"\xC1\xE2\x20", # shl dx,byte 0x20
+				b"\x48",         # dec ax
+				b"\x09\xD0",     # or ax,dx
+				b"\xC3",         # ret
+				]
+			)
+
+			retval = get_ticks_x86_64
+		return retval
+
+	def get_raw_hz(self):
+		from time import sleep
+
+		ticks_fn = self.get_ticks_func()
+
+		start = ticks_fn.func()
+		sleep(1)
+		end = ticks_fn.func()
+
+		ticks = (end - start)
+		ticks_fn.free()
+
+		return ticks
+
+def _get_cpu_info_from_cpuid_actual():
+	'''
+	Warning! This function has the potential to crash the Python runtime.
+	Do not call it directly. Use the _get_cpu_info_from_cpuid function instead.
+	It will safely call this function in another process.
+	'''
+
+	from io import StringIO
+
+	trace = Trace(True, True)
+	info = {}
+
+	# Pipe stdout and stderr to strings
+	sys.stdout = trace._stdout
+	sys.stderr = trace._stderr
+
+	try:
+		# Get the CPU arch and bits
+		arch, bits = _parse_arch(DataSource.arch_string_raw)
+
+		# Return none if this is not an X86 CPU
+		if not arch in ['X86_32', 'X86_64']:
+			trace.fail('Not running on X86_32 or X86_64. Skipping ...')
+			return trace.to_dict(info, True)
+
+		# Return none if SE Linux is in enforcing mode
+		cpuid = CPUID(trace)
+		if cpuid.is_selinux_enforcing:
+			trace.fail('SELinux is enforcing. Skipping ...')
+			return trace.to_dict(info, True)
+
+		# Get the cpu info from the CPUID register
+		max_extension_support = cpuid.get_max_extension_support()
+		cache_info = cpuid.get_cache(max_extension_support)
+		info = cpuid.get_info()
+
+		processor_brand = cpuid.get_processor_brand(max_extension_support)
+
+		# Get the Hz and scale
+		hz_actual = cpuid.get_raw_hz()
+		hz_actual = _to_decimal_string(hz_actual)
+
+		# Get the Hz and scale
+		hz_advertised, scale = _parse_cpu_brand_string(processor_brand)
+		info = {
+		'vendor_id_raw' : cpuid.get_vendor_id(),
+		'hardware_raw' : '',
+		'brand_raw' : processor_brand,
+
+		'hz_advertised_friendly' : _hz_short_to_friendly(hz_advertised, scale),
+		'hz_actual_friendly' : _hz_short_to_friendly(hz_actual, 0),
+		'hz_advertised' : _hz_short_to_full(hz_advertised, scale),
+		'hz_actual' : _hz_short_to_full(hz_actual, 0),
+
+		'l2_cache_size' : cache_info['size_b'],
+		'l2_cache_line_size' : cache_info['line_size_b'],
+		'l2_cache_associativity' : cache_info['associativity'],
+
+		'stepping' : info['stepping'],
+		'model' : info['model'],
+		'family' : info['family'],
+		'processor_type' : info['processor_type'],
+		'flags' : cpuid.get_flags(max_extension_support)
+		}
+
+		info = _filter_dict_keys_with_empty_values(info)
+		trace.success()
+	except Exception as err:
+		from traceback import format_exc
+		err_string = format_exc()
+		trace._err = ''.join(['\t\t{0}\n'.format(n) for n in err_string.split('\n')]) + '\n'
+		return trace.to_dict(info, True)
+
+	return trace.to_dict(info, False)
+
+def _get_cpu_info_from_cpuid_subprocess_wrapper(queue):
+	orig_stdout = sys.stdout
+	orig_stderr = sys.stderr
+
+	output = _get_cpu_info_from_cpuid_actual()
+
+	sys.stdout = orig_stdout
+	sys.stderr = orig_stderr
+
+	queue.put(_obj_to_b64(output))
+
+def _get_cpu_info_from_cpuid():
+	'''
+	Returns the CPU info gathered by querying the X86 cpuid register in a new process.
+	Returns {} on non X86 cpus.
+	Returns {} if SELinux is in enforcing mode.
+	'''
+
+	g_trace.header('Tying to get info from CPUID ...')
+
+	from multiprocessing import Process, Queue
+
+	# Return {} if can't cpuid
+	if not DataSource.can_cpuid:
+		g_trace.fail('Can\'t CPUID. Skipping ...')
+		return {}
+
+	# Get the CPU arch and bits
+	arch, bits = _parse_arch(DataSource.arch_string_raw)
+
+	# Return {} if this is not an X86 CPU
+	if not arch in ['X86_32', 'X86_64']:
+		g_trace.fail('Not running on X86_32 or X86_64. Skipping ...')
+		return {}
+
+	try:
+		if CAN_CALL_CPUID_IN_SUBPROCESS:
+			# Start running the function in a subprocess
+			queue = Queue()
+			p = Process(target=_get_cpu_info_from_cpuid_subprocess_wrapper, args=(queue,))
+			p.start()
+
+			# Wait for the process to end, while it is still alive
+			while p.is_alive():
+				p.join(0)
+
+			# Return {} if it failed
+			if p.exitcode != 0:
+				g_trace.fail('Failed to run CPUID in process. Skipping ...')
+				return {}
+
+			# Return {} if no results
+			if queue.empty():
+				g_trace.fail('Failed to get anything from CPUID process. Skipping ...')
+				return {}
+			# Return the result, only if there is something to read
+			else:
+				output = _b64_to_obj(queue.get())
+				import pprint
+				pp = pprint.PrettyPrinter(indent=4)
+				#pp.pprint(output)
+
+				if 'output' in output and output['output']:
+					g_trace.write(output['output'])
+
+				if 'stdout' in output and output['stdout']:
+					sys.stdout.write('{0}\n'.format(output['stdout']))
+					sys.stdout.flush()
+
+				if 'stderr' in output and output['stderr']:
+					sys.stderr.write('{0}\n'.format(output['stderr']))
+					sys.stderr.flush()
+
+				if 'is_fail' not in output:
+					g_trace.fail('Failed to get is_fail from CPUID process. Skipping ...')
+					return {}
+
+				# Fail if there was an exception
+				if 'err' in output and output['err']:
+					g_trace.fail('Failed to run CPUID in process. Skipping ...')
+					g_trace.write(output['err'])
+					g_trace.write('Failed ...')
+					return {}
+
+				if 'is_fail' in output and output['is_fail']:
+					g_trace.write('Failed ...')
+					return {}
+
+				if 'info' not in output or not output['info']:
+					g_trace.fail('Failed to get return info from CPUID process. Skipping ...')
+					return {}
+
+				return output['info']
+		else:
+			# FIXME: This should write the values like in the above call to actual
+			orig_stdout = sys.stdout
+			orig_stderr = sys.stderr
+
+			output = _get_cpu_info_from_cpuid_actual()
+
+			sys.stdout = orig_stdout
+			sys.stderr = orig_stderr
+
+			g_trace.success()
+			return output['info']
+	except Exception as err:
+		g_trace.fail(err)
+
+	# Return {} if everything failed
+	return {}
+
+def _get_cpu_info_from_proc_cpuinfo():
+	'''
+	Returns the CPU info gathered from /proc/cpuinfo.
+	Returns {} if /proc/cpuinfo is not found.
+	'''
+
+	g_trace.header('Tying to get info from /proc/cpuinfo ...')
+
+	try:
+		# Just return {} if there is no cpuinfo
+		if not DataSource.has_proc_cpuinfo():
+			g_trace.fail('Failed to find /proc/cpuinfo. Skipping ...')
+			return {}
+
+		returncode, output = DataSource.cat_proc_cpuinfo()
+		if returncode != 0:
+			g_trace.fail('Failed to run cat /proc/cpuinfo. Skipping ...')
+			return {}
+
+		# Various fields
+		vendor_id = _get_field(False, output, None, '', 'vendor_id', 'vendor id', 'vendor')
+		processor_brand = _get_field(True, output, None, None, 'model name', 'cpu', 'processor', 'uarch')
+		cache_size = _get_field(False, output, None, '', 'cache size')
+		stepping = _get_field(False, output, int, -1, 'stepping')
+		model = _get_field(False, output, int, -1, 'model')
+		family = _get_field(False, output, int, -1, 'cpu family')
+		hardware = _get_field(False, output, None, '', 'Hardware')
+
+		# Flags
+		flags = _get_field(False, output, None, None, 'flags', 'Features', 'ASEs implemented')
+		if flags:
+			flags = flags.split()
+			flags.sort()
+
+		# Check for other cache format
+		if not cache_size:
+			try:
+				for i in range(0, 10):
+					name = "cache{0}".format(i)
+					value = _get_field(False, output, None, None, name)
+					if value:
+						value = [entry.split('=') for entry in value.split(' ')]
+						value = dict(value)
+						if 'level' in value and value['level'] == '3' and 'size' in value:
+							cache_size = value['size']
+							break
+			except Exception:
+				pass
+
+		# Convert from MHz string to Hz
+		hz_actual = _get_field(False, output, None, '', 'cpu MHz', 'cpu speed', 'clock', 'cpu MHz dynamic', 'cpu MHz static')
+		hz_actual = hz_actual.lower().rstrip('mhz').strip()
+		hz_actual = _to_decimal_string(hz_actual)
+
+		# Convert from GHz/MHz string to Hz
+		hz_advertised, scale = (None, 0)
+		try:
+			hz_advertised, scale = _parse_cpu_brand_string(processor_brand)
+		except Exception:
+			pass
+
+		info = {
+		'hardware_raw' : hardware,
+		'brand_raw' : processor_brand,
+
+		'l3_cache_size' : _friendly_bytes_to_int(cache_size),
+		'flags' : flags,
+		'vendor_id_raw' : vendor_id,
+		'stepping' : stepping,
+		'model' : model,
+		'family' : family,
+		}
+
+		# Make the Hz the same for actual and advertised if missing any
+		if not hz_advertised or hz_advertised == '0.0':
+			hz_advertised = hz_actual
+			scale = 6
+		elif not hz_actual or hz_actual == '0.0':
+			hz_actual = hz_advertised
+
+		# Add the Hz if there is one
+		if _hz_short_to_full(hz_advertised, scale) > (0, 0):
+			info['hz_advertised_friendly'] = _hz_short_to_friendly(hz_advertised, scale)
+			info['hz_advertised'] = _hz_short_to_full(hz_advertised, scale)
+		if _hz_short_to_full(hz_actual, scale) > (0, 0):
+			info['hz_actual_friendly'] = _hz_short_to_friendly(hz_actual, 6)
+			info['hz_actual'] = _hz_short_to_full(hz_actual, 6)
+
+		info = _filter_dict_keys_with_empty_values(info, {'stepping':0, 'model':0, 'family':0})
+		g_trace.success()
+		return info
+	except Exception as err:
+		g_trace.fail(err)
+		#raise # NOTE: To have this throw on error, uncomment this line
+		return {}
+
+def _get_cpu_info_from_cpufreq_info():
+	'''
+	Returns the CPU info gathered from cpufreq-info.
+	Returns {} if cpufreq-info is not found.
+	'''
+
+	g_trace.header('Tying to get info from cpufreq-info ...')
+
+	try:
+		hz_brand, scale = '0.0', 0
+
+		if not DataSource.has_cpufreq_info():
+			g_trace.fail('Failed to find cpufreq-info. Skipping ...')
+			return {}
+
+		returncode, output = DataSource.cpufreq_info()
+		if returncode != 0:
+			g_trace.fail('Failed to run cpufreq-info. Skipping ...')
+			return {}
+
+		hz_brand = output.split('current CPU frequency is')[1].split('\n')[0]
+		i = hz_brand.find('Hz')
+		assert(i != -1)
+		hz_brand = hz_brand[0 : i+2].strip().lower()
+
+		if hz_brand.endswith('mhz'):
+			scale = 6
+		elif hz_brand.endswith('ghz'):
+			scale = 9
+		hz_brand = hz_brand.rstrip('mhz').rstrip('ghz').strip()
+		hz_brand = _to_decimal_string(hz_brand)
+
+		info = {
+			'hz_advertised_friendly' : _hz_short_to_friendly(hz_brand, scale),
+			'hz_actual_friendly' : _hz_short_to_friendly(hz_brand, scale),
+			'hz_advertised' : _hz_short_to_full(hz_brand, scale),
+			'hz_actual' : _hz_short_to_full(hz_brand, scale),
+		}
+
+		info = _filter_dict_keys_with_empty_values(info)
+		g_trace.success()
+		return info
+	except Exception as err:
+		g_trace.fail(err)
+		#raise # NOTE: To have this throw on error, uncomment this line
+		return {}
+
+def _get_cpu_info_from_lscpu():
+	'''
+	Returns the CPU info gathered from lscpu.
+	Returns {} if lscpu is not found.
+	'''
+
+	g_trace.header('Tying to get info from lscpu ...')
+
+	try:
+		if not DataSource.has_lscpu():
+			g_trace.fail('Failed to find lscpu. Skipping ...')
+			return {}
+
+		returncode, output = DataSource.lscpu()
+		if returncode != 0:
+			g_trace.fail('Failed to run lscpu. Skipping ...')
+			return {}
+
+		info = {}
+
+		new_hz = _get_field(False, output, None, None, 'CPU max MHz', 'CPU MHz')
+		if new_hz:
+			new_hz = _to_decimal_string(new_hz)
+			scale = 6
+			info['hz_advertised_friendly'] = _hz_short_to_friendly(new_hz, scale)
+			info['hz_actual_friendly'] = _hz_short_to_friendly(new_hz, scale)
+			info['hz_advertised'] = _hz_short_to_full(new_hz, scale)
+			info['hz_actual'] = _hz_short_to_full(new_hz, scale)
+
+		new_hz = _get_field(False, output, None, None, 'CPU dynamic MHz', 'CPU static MHz')
+		if new_hz:
+			new_hz = _to_decimal_string(new_hz)
+			scale = 6
+			info['hz_advertised_friendly'] = _hz_short_to_friendly(new_hz, scale)
+			info['hz_actual_friendly'] = _hz_short_to_friendly(new_hz, scale)
+			info['hz_advertised'] = _hz_short_to_full(new_hz, scale)
+			info['hz_actual'] = _hz_short_to_full(new_hz, scale)
+
+		vendor_id = _get_field(False, output, None, None, 'Vendor ID')
+		if vendor_id:
+			info['vendor_id_raw'] = vendor_id
+
+		brand = _get_field(False, output, None, None, 'Model name')
+		if brand:
+			info['brand_raw'] = brand
+		else:
+			brand = _get_field(False, output, None, None, 'Model')
+			if brand and not brand.isdigit():
+				info['brand_raw'] = brand
+
+		family = _get_field(False, output, None, None, 'CPU family')
+		if family and family.isdigit():
+			info['family'] = int(family)
+
+		stepping = _get_field(False, output, None, None, 'Stepping')
+		if stepping and stepping.isdigit():
+			info['stepping'] = int(stepping)
+
+		model = _get_field(False, output, None, None, 'Model')
+		if model and model.isdigit():
+			info['model'] = int(model)
+
+		l1_data_cache_size = _get_field(False, output, None, None, 'L1d cache')
+		if l1_data_cache_size:
+			l1_data_cache_size = l1_data_cache_size.split('(')[0].strip()
+			info['l1_data_cache_size'] = _friendly_bytes_to_int(l1_data_cache_size)
+
+		l1_instruction_cache_size = _get_field(False, output, None, None, 'L1i cache')
+		if l1_instruction_cache_size:
+			l1_instruction_cache_size = l1_instruction_cache_size.split('(')[0].strip()
+			info['l1_instruction_cache_size'] = _friendly_bytes_to_int(l1_instruction_cache_size)
+
+		l2_cache_size = _get_field(False, output, None, None, 'L2 cache', 'L2d cache')
+		if l2_cache_size:
+			l2_cache_size = l2_cache_size.split('(')[0].strip()
+			info['l2_cache_size'] = _friendly_bytes_to_int(l2_cache_size)
+
+		l3_cache_size = _get_field(False, output, None, None, 'L3 cache')
+		if l3_cache_size:
+			l3_cache_size = l3_cache_size.split('(')[0].strip()
+			info['l3_cache_size'] = _friendly_bytes_to_int(l3_cache_size)
+
+		# Flags
+		flags = _get_field(False, output, None, None, 'flags', 'Features', 'ASEs implemented')
+		if flags:
+			flags = flags.split()
+			flags.sort()
+			info['flags'] = flags
+
+		info = _filter_dict_keys_with_empty_values(info, {'stepping':0, 'model':0, 'family':0})
+		g_trace.success()
+		return info
+	except Exception as err:
+		g_trace.fail(err)
+		#raise # NOTE: To have this throw on error, uncomment this line
+		return {}
+
+def _get_cpu_info_from_dmesg():
+	'''
+	Returns the CPU info gathered from dmesg.
+	Returns {} if dmesg is not found or does not have the desired info.
+	'''
+
+	g_trace.header('Tying to get info from the dmesg ...')
+
+	# Just return {} if this arch has an unreliable dmesg log
+	arch, bits = _parse_arch(DataSource.arch_string_raw)
+	if arch in ['S390X']:
+		g_trace.fail('Running on S390X. Skipping ...')
+		return {}
+
+	# Just return {} if there is no dmesg
+	if not DataSource.has_dmesg():
+		g_trace.fail('Failed to find dmesg. Skipping ...')
+		return {}
+
+	# If dmesg fails return {}
+	returncode, output = DataSource.dmesg_a()
+	if output is None or returncode != 0:
+		g_trace.fail('Failed to run \"dmesg -a\". Skipping ...')
+		return {}
+
+	info = _parse_dmesg_output(output)
+	g_trace.success()
+	return info
+
+
+# https://openpowerfoundation.org/wp-content/uploads/2016/05/LoPAPR_DRAFT_v11_24March2016_cmt1.pdf
+# page 767
+def _get_cpu_info_from_ibm_pa_features():
+	'''
+	Returns the CPU info gathered from lsprop /proc/device-tree/cpus/*/ibm,pa-features
+	Returns {} if lsprop is not found or ibm,pa-features does not have the desired info.
+	'''
+
+	g_trace.header('Tying to get info from lsprop ...')
+
+	try:
+		# Just return {} if there is no lsprop
+		if not DataSource.has_ibm_pa_features():
+			g_trace.fail('Failed to find lsprop. Skipping ...')
+			return {}
+
+		# If ibm,pa-features fails return {}
+		returncode, output = DataSource.ibm_pa_features()
+		if output is None or returncode != 0:
+			g_trace.fail('Failed to glob /proc/device-tree/cpus/*/ibm,pa-features. Skipping ...')
+			return {}
+
+		# Filter out invalid characters from output
+		value = output.split("ibm,pa-features")[1].lower()
+		value = [s for s in value if s in list('0123456789abcfed')]
+		value = ''.join(value)
+
+		# Get data converted to Uint32 chunks
+		left = int(value[0 : 8], 16)
+		right = int(value[8 : 16], 16)
+
+		# Get the CPU flags
+		flags = {
+			# Byte 0
+			'mmu' : _is_bit_set(left, 0),
+			'fpu' : _is_bit_set(left, 1),
+			'slb' : _is_bit_set(left, 2),
+			'run' : _is_bit_set(left, 3),
+			#'reserved' : _is_bit_set(left, 4),
+			'dabr' : _is_bit_set(left, 5),
+			'ne' : _is_bit_set(left, 6),
+			'wtr' : _is_bit_set(left, 7),
+
+			# Byte 1
+			'mcr' : _is_bit_set(left, 8),
+			'dsisr' : _is_bit_set(left, 9),
+			'lp' : _is_bit_set(left, 10),
+			'ri' : _is_bit_set(left, 11),
+			'dabrx' : _is_bit_set(left, 12),
+			'sprg3' : _is_bit_set(left, 13),
+			'rislb' : _is_bit_set(left, 14),
+			'pp' : _is_bit_set(left, 15),
+
+			# Byte 2
+			'vpm' : _is_bit_set(left, 16),
+			'dss_2.05' : _is_bit_set(left, 17),
+			#'reserved' : _is_bit_set(left, 18),
+			'dar' : _is_bit_set(left, 19),
+			#'reserved' : _is_bit_set(left, 20),
+			'ppr' : _is_bit_set(left, 21),
+			'dss_2.02' : _is_bit_set(left, 22),
+			'dss_2.06' : _is_bit_set(left, 23),
+
+			# Byte 3
+			'lsd_in_dscr' : _is_bit_set(left, 24),
+			'ugr_in_dscr' : _is_bit_set(left, 25),
+			#'reserved' : _is_bit_set(left, 26),
+			#'reserved' : _is_bit_set(left, 27),
+			#'reserved' : _is_bit_set(left, 28),
+			#'reserved' : _is_bit_set(left, 29),
+			#'reserved' : _is_bit_set(left, 30),
+			#'reserved' : _is_bit_set(left, 31),
+
+			# Byte 4
+			'sso_2.06' : _is_bit_set(right, 0),
+			#'reserved' : _is_bit_set(right, 1),
+			#'reserved' : _is_bit_set(right, 2),
+			#'reserved' : _is_bit_set(right, 3),
+			#'reserved' : _is_bit_set(right, 4),
+			#'reserved' : _is_bit_set(right, 5),
+			#'reserved' : _is_bit_set(right, 6),
+			#'reserved' : _is_bit_set(right, 7),
+
+			# Byte 5
+			'le' : _is_bit_set(right, 8),
+			'cfar' : _is_bit_set(right, 9),
+			'eb' : _is_bit_set(right, 10),
+			'lsq_2.07' : _is_bit_set(right, 11),
+			#'reserved' : _is_bit_set(right, 12),
+			#'reserved' : _is_bit_set(right, 13),
+			#'reserved' : _is_bit_set(right, 14),
+			#'reserved' : _is_bit_set(right, 15),
+
+			# Byte 6
+			'dss_2.07' : _is_bit_set(right, 16),
+			#'reserved' : _is_bit_set(right, 17),
+			#'reserved' : _is_bit_set(right, 18),
+			#'reserved' : _is_bit_set(right, 19),
+			#'reserved' : _is_bit_set(right, 20),
+			#'reserved' : _is_bit_set(right, 21),
+			#'reserved' : _is_bit_set(right, 22),
+			#'reserved' : _is_bit_set(right, 23),
+
+			# Byte 7
+			#'reserved' : _is_bit_set(right, 24),
+			#'reserved' : _is_bit_set(right, 25),
+			#'reserved' : _is_bit_set(right, 26),
+			#'reserved' : _is_bit_set(right, 27),
+			#'reserved' : _is_bit_set(right, 28),
+			#'reserved' : _is_bit_set(right, 29),
+			#'reserved' : _is_bit_set(right, 30),
+			#'reserved' : _is_bit_set(right, 31),
+		}
+
+		# Get a list of only the flags that are true
+		flags = [k for k, v in flags.items() if v]
+		flags.sort()
+
+		info = {
+			'flags' : flags
+		}
+		info = _filter_dict_keys_with_empty_values(info)
+		g_trace.success()
+		return info
+	except Exception as err:
+		g_trace.fail(err)
+		return {}
+
+
+def _get_cpu_info_from_cat_var_run_dmesg_boot():
+	'''
+	Returns the CPU info gathered from /var/run/dmesg.boot.
+	Returns {} if dmesg is not found or does not have the desired info.
+	'''
+
+	g_trace.header('Tying to get info from the /var/run/dmesg.boot log ...')
+
+	# Just return {} if there is no /var/run/dmesg.boot
+	if not DataSource.has_var_run_dmesg_boot():
+		g_trace.fail('Failed to find /var/run/dmesg.boot file. Skipping ...')
+		return {}
+
+	# If dmesg.boot fails return {}
+	returncode, output = DataSource.cat_var_run_dmesg_boot()
+	if output is None or returncode != 0:
+		g_trace.fail('Failed to run \"cat /var/run/dmesg.boot\". Skipping ...')
+		return {}
+
+	info = _parse_dmesg_output(output)
+	g_trace.success()
+	return info
+
+
+def _get_cpu_info_from_sysctl():
+	'''
+	Returns the CPU info gathered from sysctl.
+	Returns {} if sysctl is not found.
+	'''
+
+	g_trace.header('Tying to get info from sysctl ...')
+
+	try:
+		# Just return {} if there is no sysctl
+		if not DataSource.has_sysctl():
+			g_trace.fail('Failed to find sysctl. Skipping ...')
+			return {}
+
+		# If sysctl fails return {}
+		returncode, output = DataSource.sysctl_machdep_cpu_hw_cpufrequency()
+		if output is None or returncode != 0:
+			g_trace.fail('Failed to run \"sysctl machdep.cpu hw.cpufrequency\". Skipping ...')
+			return {}
+
+		# Various fields
+		vendor_id = _get_field(False, output, None, None, 'machdep.cpu.vendor')
+		processor_brand = _get_field(True, output, None, None, 'machdep.cpu.brand_string')
+		cache_size = _get_field(False, output, int, 0, 'machdep.cpu.cache.size')
+		stepping = _get_field(False, output, int, 0, 'machdep.cpu.stepping')
+		model = _get_field(False, output, int, 0, 'machdep.cpu.model')
+		family = _get_field(False, output, int, 0, 'machdep.cpu.family')
+
+		# Flags
+		flags = _get_field(False, output, None, '', 'machdep.cpu.features').lower().split()
+		flags.extend(_get_field(False, output, None, '', 'machdep.cpu.leaf7_features').lower().split())
+		flags.extend(_get_field(False, output, None, '', 'machdep.cpu.extfeatures').lower().split())
+		flags.sort()
+
+		# Convert from GHz/MHz string to Hz
+		hz_advertised, scale = _parse_cpu_brand_string(processor_brand)
+		hz_actual = _get_field(False, output, None, None, 'hw.cpufrequency')
+		hz_actual = _to_decimal_string(hz_actual)
+
+		info = {
+		'vendor_id_raw' : vendor_id,
+		'brand_raw' : processor_brand,
+
+		'hz_advertised_friendly' : _hz_short_to_friendly(hz_advertised, scale),
+		'hz_actual_friendly' : _hz_short_to_friendly(hz_actual, 0),
+		'hz_advertised' : _hz_short_to_full(hz_advertised, scale),
+		'hz_actual' : _hz_short_to_full(hz_actual, 0),
+
+		'l2_cache_size' : int(cache_size) * 1024,
+
+		'stepping' : stepping,
+		'model' : model,
+		'family' : family,
+		'flags' : flags
+		}
+
+		info = _filter_dict_keys_with_empty_values(info)
+		g_trace.success()
+		return info
+	except Exception as err:
+		g_trace.fail(err)
+		return {}
+
+
+def _get_cpu_info_from_sysinfo():
+	'''
+	Returns the CPU info gathered from sysinfo.
+	Returns {} if sysinfo is not found.
+	'''
+
+	info = _get_cpu_info_from_sysinfo_v1()
+	info.update(_get_cpu_info_from_sysinfo_v2())
+	return info
+
+def _get_cpu_info_from_sysinfo_v1():
+	'''
+	Returns the CPU info gathered from sysinfo.
+	Returns {} if sysinfo is not found.
+	'''
+
+	g_trace.header('Tying to get info from sysinfo version 1 ...')
+
+	try:
+		# Just return {} if there is no sysinfo
+		if not DataSource.has_sysinfo():
+			g_trace.fail('Failed to find sysinfo. Skipping ...')
+			return {}
+
+		# If sysinfo fails return {}
+		returncode, output = DataSource.sysinfo_cpu()
+		if output is None or returncode != 0:
+			g_trace.fail('Failed to run \"sysinfo -cpu\". Skipping ...')
+			return {}
+
+		# Various fields
+		vendor_id = '' #_get_field(False, output, None, None, 'CPU #0: ')
+		processor_brand = output.split('CPU #0: "')[1].split('"\n')[0].strip()
+		cache_size = '' #_get_field(False, output, None, None, 'machdep.cpu.cache.size')
+		stepping = int(output.split(', stepping ')[1].split(',')[0].strip())
+		model = int(output.split(', model ')[1].split(',')[0].strip())
+		family = int(output.split(', family ')[1].split(',')[0].strip())
+
+		# Flags
+		flags = []
+		for line in output.split('\n'):
+			if line.startswith('\t\t'):
+				for flag in line.strip().lower().split():
+					flags.append(flag)
+		flags.sort()
+
+		# Convert from GHz/MHz string to Hz
+		hz_advertised, scale = _parse_cpu_brand_string(processor_brand)
+		hz_actual = hz_advertised
+
+		info = {
+		'vendor_id_raw' : vendor_id,
+		'brand_raw' : processor_brand,
+
+		'hz_advertised_friendly' : _hz_short_to_friendly(hz_advertised, scale),
+		'hz_actual_friendly' : _hz_short_to_friendly(hz_actual, scale),
+		'hz_advertised' : _hz_short_to_full(hz_advertised, scale),
+		'hz_actual' : _hz_short_to_full(hz_actual, scale),
+
+		'l2_cache_size' : _to_friendly_bytes(cache_size),
+
+		'stepping' : stepping,
+		'model' : model,
+		'family' : family,
+		'flags' : flags
+		}
+
+		info = _filter_dict_keys_with_empty_values(info)
+		g_trace.success()
+		return info
+	except Exception as err:
+		g_trace.fail(err)
+		#raise # NOTE: To have this throw on error, uncomment this line
+		return {}
+
+def _get_cpu_info_from_sysinfo_v2():
+	'''
+	Returns the CPU info gathered from sysinfo.
+	Returns {} if sysinfo is not found.
+	'''
+
+	g_trace.header('Tying to get info from sysinfo version 2 ...')
+
+	try:
+		# Just return {} if there is no sysinfo
+		if not DataSource.has_sysinfo():
+			g_trace.fail('Failed to find sysinfo. Skipping ...')
+			return {}
+
+		# If sysinfo fails return {}
+		returncode, output = DataSource.sysinfo_cpu()
+		if output is None or returncode != 0:
+			g_trace.fail('Failed to run \"sysinfo -cpu\". Skipping ...')
+			return {}
+
+		# Various fields
+		vendor_id = '' #_get_field(False, output, None, None, 'CPU #0: ')
+		processor_brand = output.split('CPU #0: "')[1].split('"\n')[0].strip()
+		cache_size = '' #_get_field(False, output, None, None, 'machdep.cpu.cache.size')
+		signature = output.split('Signature:')[1].split('\n')[0].strip()
+		#
+		stepping = int(signature.split('stepping ')[1].split(',')[0].strip())
+		model = int(signature.split('model ')[1].split(',')[0].strip())
+		family = int(signature.split('family ')[1].split(',')[0].strip())
+
+		# Flags
+		def get_subsection_flags(output):
+			retval = []
+			for line in output.split('\n')[1:]:
+				if not line.startswith('                ') and not line.startswith('		'): break
+				for entry in line.strip().lower().split(' '):
+					retval.append(entry)
+			return retval
+
+		flags = get_subsection_flags(output.split('Features: ')[1]) + \
+				get_subsection_flags(output.split('Extended Features (0x00000001): ')[1]) + \
+				get_subsection_flags(output.split('Extended Features (0x80000001): ')[1])
+		flags.sort()
+
+		# Convert from GHz/MHz string to Hz
+		lines = [n for n in output.split('\n') if n]
+		raw_hz = lines[0].split('running at ')[1].strip().lower()
+		hz_advertised = raw_hz.rstrip('mhz').rstrip('ghz').strip()
+		hz_advertised = _to_decimal_string(hz_advertised)
+		hz_actual = hz_advertised
+
+		scale = 0
+		if raw_hz.endswith('mhz'):
+			scale = 6
+		elif raw_hz.endswith('ghz'):
+			scale = 9
+
+		info = {
+		'vendor_id_raw' : vendor_id,
+		'brand_raw' : processor_brand,
+
+		'hz_advertised_friendly' : _hz_short_to_friendly(hz_advertised, scale),
+		'hz_actual_friendly' : _hz_short_to_friendly(hz_actual, scale),
+		'hz_advertised' : _hz_short_to_full(hz_advertised, scale),
+		'hz_actual' : _hz_short_to_full(hz_actual, scale),
+
+		'l2_cache_size' : _to_friendly_bytes(cache_size),
+
+		'stepping' : stepping,
+		'model' : model,
+		'family' : family,
+		'flags' : flags
+		}
+
+		info = _filter_dict_keys_with_empty_values(info)
+		g_trace.success()
+		return info
+	except Exception as err:
+		g_trace.fail(err)
+		#raise # NOTE: To have this throw on error, uncomment this line
+		return {}
+
+def _get_cpu_info_from_wmic():
+	'''
+	Returns the CPU info gathered from WMI.
+	Returns {} if not on Windows, or wmic is not installed.
+	'''
+	g_trace.header('Tying to get info from wmic ...')
+
+	try:
+		# Just return {} if not Windows or there is no wmic
+		if not DataSource.is_windows or not DataSource.has_wmic():
+			g_trace.fail('Failed to find WMIC, or not on Windows. Skipping ...')
+			return {}
+
+		returncode, output = DataSource.wmic_cpu()
+		if output is None or returncode != 0:
+			g_trace.fail('Failed to run wmic. Skipping ...')
+			return {}
+
+		# Break the list into key values pairs
+		value = output.split("\n")
+		value = [s.rstrip().split('=') for s in value if '=' in s]
+		value = {k: v for k, v in value if v}
+
+		# Get the advertised MHz
+		processor_brand = value.get('Name')
+		hz_advertised, scale_advertised = _parse_cpu_brand_string(processor_brand)
+
+		# Get the actual MHz
+		hz_actual = value.get('CurrentClockSpeed')
+		scale_actual = 6
+		if hz_actual:
+			hz_actual = _to_decimal_string(hz_actual)
+
+		# Get cache sizes
+		l2_cache_size = value.get('L2CacheSize') # NOTE: L2CacheSize is in kilobytes
+		if l2_cache_size:
+			l2_cache_size = int(l2_cache_size) * 1024
+
+		l3_cache_size = value.get('L3CacheSize') # NOTE: L3CacheSize is in kilobytes
+		if l3_cache_size:
+			l3_cache_size = int(l3_cache_size) * 1024
+
+		# Get family, model, and stepping
+		family, model, stepping = '', '', ''
+		description = value.get('Description') or value.get('Caption')
+		entries = description.split(' ')
+
+		if 'Family' in entries and entries.index('Family') < len(entries)-1:
+			i = entries.index('Family')
+			family = int(entries[i + 1])
+
+		if 'Model' in entries and entries.index('Model') < len(entries)-1:
+			i = entries.index('Model')
+			model = int(entries[i + 1])
+
+		if 'Stepping' in entries and entries.index('Stepping') < len(entries)-1:
+			i = entries.index('Stepping')
+			stepping = int(entries[i + 1])
+
+		info = {
+			'vendor_id_raw' : value.get('Manufacturer'),
+			'brand_raw' : processor_brand,
+
+			'hz_advertised_friendly' : _hz_short_to_friendly(hz_advertised, scale_advertised),
+			'hz_actual_friendly' : _hz_short_to_friendly(hz_actual, scale_actual),
+			'hz_advertised' : _hz_short_to_full(hz_advertised, scale_advertised),
+			'hz_actual' : _hz_short_to_full(hz_actual, scale_actual),
+
+			'l2_cache_size' : l2_cache_size,
+			'l3_cache_size' : l3_cache_size,
+
+			'stepping' : stepping,
+			'model' : model,
+			'family' : family,
+		}
+
+		info = _filter_dict_keys_with_empty_values(info)
+		g_trace.success()
+		return info
+	except Exception as err:
+		g_trace.fail(err)
+		#raise # NOTE: To have this throw on error, uncomment this line
+		return {}
+
+def _get_cpu_info_from_registry():
+	'''
+	Returns the CPU info gathered from the Windows Registry.
+	Returns {} if not on Windows.
+	'''
+
+	g_trace.header('Tying to get info from Windows registry ...')
+
+	try:
+		# Just return {} if not on Windows
+		if not DataSource.is_windows:
+			g_trace.fail('Not running on Windows. Skipping ...')
+			return {}
+
+		# Get the CPU name
+		processor_brand = DataSource.winreg_processor_brand().strip()
+
+		# Get the CPU vendor id
+		vendor_id = DataSource.winreg_vendor_id_raw()
+
+		# Get the CPU arch and bits
+		arch_string_raw = DataSource.winreg_arch_string_raw()
+		arch, bits = _parse_arch(arch_string_raw)
+
+		# Get the actual CPU Hz
+		hz_actual = DataSource.winreg_hz_actual()
+		hz_actual = _to_decimal_string(hz_actual)
+
+		# Get the advertised CPU Hz
+		hz_advertised, scale = _parse_cpu_brand_string(processor_brand)
+
+		# If advertised hz not found, use the actual hz
+		if hz_advertised == '0.0':
+			scale = 6
+			hz_advertised = _to_decimal_string(hz_actual)
+
+		# Get the CPU features
+		feature_bits = DataSource.winreg_feature_bits()
+
+		def is_set(bit):
+			mask = 0x80000000 >> bit
+			retval = mask & feature_bits > 0
+			return retval
+
+		# http://en.wikipedia.org/wiki/CPUID
+		# http://unix.stackexchange.com/questions/43539/what-do-the-flags-in-proc-cpuinfo-mean
+		# http://www.lohninger.com/helpcsuite/public_constants_cpuid.htm
+		flags = {
+			'fpu' : is_set(0), # Floating Point Unit
+			'vme' : is_set(1), # V86 Mode Extensions
+			'de' : is_set(2), # Debug Extensions - I/O breakpoints supported
+			'pse' : is_set(3), # Page Size Extensions (4 MB pages supported)
+			'tsc' : is_set(4), # Time Stamp Counter and RDTSC instruction are available
+			'msr' : is_set(5), # Model Specific Registers
+			'pae' : is_set(6), # Physical Address Extensions (36 bit address, 2MB pages)
+			'mce' : is_set(7), # Machine Check Exception supported
+			'cx8' : is_set(8), # Compare Exchange Eight Byte instruction available
+			'apic' : is_set(9), # Local APIC present (multiprocessor operation support)
+			'sepamd' : is_set(10), # Fast system calls (AMD only)
+			'sep' : is_set(11), # Fast system calls
+			'mtrr' : is_set(12), # Memory Type Range Registers
+			'pge' : is_set(13), # Page Global Enable
+			'mca' : is_set(14), # Machine Check Architecture
+			'cmov' : is_set(15), # Conditional MOVe instructions
+			'pat' : is_set(16), # Page Attribute Table
+			'pse36' : is_set(17), # 36 bit Page Size Extensions
+			'serial' : is_set(18), # Processor Serial Number
+			'clflush' : is_set(19), # Cache Flush
+			#'reserved1' : is_set(20), # reserved
+			'dts' : is_set(21), # Debug Trace Store
+			'acpi' : is_set(22), # ACPI support
+			'mmx' : is_set(23), # MultiMedia Extensions
+			'fxsr' : is_set(24), # FXSAVE and FXRSTOR instructions
+			'sse' : is_set(25), # SSE instructions
+			'sse2' : is_set(26), # SSE2 (WNI) instructions
+			'ss' : is_set(27), # self snoop
+			#'reserved2' : is_set(28), # reserved
+			'tm' : is_set(29), # Automatic clock control
+			'ia64' : is_set(30), # IA64 instructions
+			'3dnow' : is_set(31) # 3DNow! instructions available
+		}
+
+		# Get a list of only the flags that are true
+		flags = [k for k, v in flags.items() if v]
+		flags.sort()
+
+		info = {
+		'vendor_id_raw' : vendor_id,
+		'brand_raw' : processor_brand,
+
+		'hz_advertised_friendly' : _hz_short_to_friendly(hz_advertised, scale),
+		'hz_actual_friendly' : _hz_short_to_friendly(hz_actual, 6),
+		'hz_advertised' : _hz_short_to_full(hz_advertised, scale),
+		'hz_actual' : _hz_short_to_full(hz_actual, 6),
+
+		'flags' : flags
+		}
+
+		info = _filter_dict_keys_with_empty_values(info)
+		g_trace.success()
+		return info
+	except Exception as err:
+		g_trace.fail(err)
+		return {}
+
+def _get_cpu_info_from_kstat():
+	'''
+	Returns the CPU info gathered from isainfo and kstat.
+	Returns {} if isainfo or kstat are not found.
+	'''
+
+	g_trace.header('Tying to get info from kstat ...')
+
+	try:
+		# Just return {} if there is no isainfo or kstat
+		if not DataSource.has_isainfo() or not DataSource.has_kstat():
+			g_trace.fail('Failed to find isinfo or kstat. Skipping ...')
+			return {}
+
+		# If isainfo fails return {}
+		returncode, flag_output = DataSource.isainfo_vb()
+		if flag_output is None or returncode != 0:
+			g_trace.fail('Failed to run \"isainfo -vb\". Skipping ...')
+			return {}
+
+		# If kstat fails return {}
+		returncode, kstat = DataSource.kstat_m_cpu_info()
+		if kstat is None or returncode != 0:
+			g_trace.fail('Failed to run \"kstat -m cpu_info\". Skipping ...')
+			return {}
+
+		# Various fields
+		vendor_id = kstat.split('\tvendor_id ')[1].split('\n')[0].strip()
+		processor_brand = kstat.split('\tbrand ')[1].split('\n')[0].strip()
+		stepping = int(kstat.split('\tstepping ')[1].split('\n')[0].strip())
+		model = int(kstat.split('\tmodel ')[1].split('\n')[0].strip())
+		family = int(kstat.split('\tfamily ')[1].split('\n')[0].strip())
+
+		# Flags
+		flags = flag_output.strip().split('\n')[-1].strip().lower().split()
+		flags.sort()
+
+		# Convert from GHz/MHz string to Hz
+		scale = 6
+		hz_advertised = kstat.split('\tclock_MHz ')[1].split('\n')[0].strip()
+		hz_advertised = _to_decimal_string(hz_advertised)
+
+		# Convert from GHz/MHz string to Hz
+		hz_actual = kstat.split('\tcurrent_clock_Hz ')[1].split('\n')[0].strip()
+		hz_actual = _to_decimal_string(hz_actual)
+
+		info = {
+		'vendor_id_raw' : vendor_id,
+		'brand_raw' : processor_brand,
+
+		'hz_advertised_friendly' : _hz_short_to_friendly(hz_advertised, scale),
+		'hz_actual_friendly' : _hz_short_to_friendly(hz_actual, 0),
+		'hz_advertised' : _hz_short_to_full(hz_advertised, scale),
+		'hz_actual' : _hz_short_to_full(hz_actual, 0),
+
+		'stepping' : stepping,
+		'model' : model,
+		'family' : family,
+		'flags' : flags
+		}
+
+		info = _filter_dict_keys_with_empty_values(info)
+		g_trace.success()
+		return info
+	except Exception as err:
+		g_trace.fail(err)
+		return {}
+
+def _get_cpu_info_from_platform_uname():
+
+	g_trace.header('Tying to get info from platform.uname ...')
+
+	try:
+		uname = DataSource.uname_string_raw.split(',')[0]
+
+		family, model, stepping = (None, None, None)
+		entries = uname.split(' ')
+
+		if 'Family' in entries and entries.index('Family') < len(entries)-1:
+			i = entries.index('Family')
+			family = int(entries[i + 1])
+
+		if 'Model' in entries and entries.index('Model') < len(entries)-1:
+			i = entries.index('Model')
+			model = int(entries[i + 1])
+
+		if 'Stepping' in entries and entries.index('Stepping') < len(entries)-1:
+			i = entries.index('Stepping')
+			stepping = int(entries[i + 1])
+
+		info = {
+			'family' : family,
+			'model' : model,
+			'stepping' : stepping
+		}
+		info = _filter_dict_keys_with_empty_values(info)
+		g_trace.success()
+		return info
+	except Exception as err:
+		g_trace.fail(err)
+		return {}
+
+def _get_cpu_info_internal():
+	'''
+	Returns the CPU info by using the best sources of information for your OS.
+	Returns {} if nothing is found.
+	'''
+
+	g_trace.write('!' * 80)
+
+	# Get the CPU arch and bits
+	arch, bits = _parse_arch(DataSource.arch_string_raw)
+
+	friendly_maxsize = { 2**31-1: '32 bit', 2**63-1: '64 bit' }.get(sys.maxsize) or 'unknown bits'
+	friendly_version = "{0}.{1}.{2}.{3}.{4}".format(*sys.version_info)
+	PYTHON_VERSION = "{0} ({1})".format(friendly_version, friendly_maxsize)
+
+	info = {
+		'python_version' : PYTHON_VERSION,
+		'cpuinfo_version' : CPUINFO_VERSION,
+		'cpuinfo_version_string' : CPUINFO_VERSION_STRING,
+		'arch' : arch,
+		'bits' : bits,
+		'count' : DataSource.cpu_count,
+		'arch_string_raw' : DataSource.arch_string_raw,
+	}
+
+	g_trace.write("python_version: {0}".format(info['python_version']))
+	g_trace.write("cpuinfo_version: {0}".format(info['cpuinfo_version']))
+	g_trace.write("arch: {0}".format(info['arch']))
+	g_trace.write("bits: {0}".format(info['bits']))
+	g_trace.write("count: {0}".format(info['count']))
+	g_trace.write("arch_string_raw: {0}".format(info['arch_string_raw']))
+
+	# Try the Windows wmic
+	_copy_new_fields(info, _get_cpu_info_from_wmic())
+
+	# Try the Windows registry
+	_copy_new_fields(info, _get_cpu_info_from_registry())
+
+	# Try /proc/cpuinfo
+	_copy_new_fields(info, _get_cpu_info_from_proc_cpuinfo())
+
+	# Try cpufreq-info
+	_copy_new_fields(info, _get_cpu_info_from_cpufreq_info())
+
+	# Try LSCPU
+	_copy_new_fields(info, _get_cpu_info_from_lscpu())
+
+	# Try sysctl
+	_copy_new_fields(info, _get_cpu_info_from_sysctl())
+
+	# Try kstat
+	_copy_new_fields(info, _get_cpu_info_from_kstat())
+
+	# Try dmesg
+	_copy_new_fields(info, _get_cpu_info_from_dmesg())
+
+	# Try /var/run/dmesg.boot
+	_copy_new_fields(info, _get_cpu_info_from_cat_var_run_dmesg_boot())
+
+	# Try lsprop ibm,pa-features
+	_copy_new_fields(info, _get_cpu_info_from_ibm_pa_features())
+
+	# Try sysinfo
+	_copy_new_fields(info, _get_cpu_info_from_sysinfo())
+
+	# Try querying the CPU cpuid register
+	# FIXME: This should print stdout and stderr to trace log
+	_copy_new_fields(info, _get_cpu_info_from_cpuid())
+
+	# Try platform.uname
+	_copy_new_fields(info, _get_cpu_info_from_platform_uname())
+
+	g_trace.write('!' * 80)
+
+	return info
+
+def get_cpu_info_json():
+	'''
+	Returns the CPU info by using the best sources of information for your OS.
+	Returns the result in a json string
+	'''
+
+	import json
+
+	output = None
+
+	# If running under pyinstaller, run normally
+	if getattr(sys, 'frozen', False):
+		info = _get_cpu_info_internal()
+		output = json.dumps(info)
+		output = "{0}".format(output)
+	# if not running under pyinstaller, run in another process.
+	# This is done because multiprocesing has a design flaw that
+	# causes non main programs to run multiple times on Windows.
+	else:
+		from subprocess import Popen, PIPE
+
+		command = [sys.executable, __file__, '--json']
+		p1 = Popen(command, stdout=PIPE, stderr=PIPE, stdin=PIPE)
+		output = p1.communicate()[0]
+
+		if p1.returncode != 0:
+			return "{}"
+
+		output = output.decode(encoding='UTF-8')
+
+	return output
+
+def get_cpu_info():
+	'''
+	Returns the CPU info by using the best sources of information for your OS.
+	Returns the result in a dict
+	'''
+
+	import json
+
+	output = get_cpu_info_json()
+
+	# Convert JSON to Python with non unicode strings
+	output = json.loads(output, object_hook = _utf_to_str)
+
+	return output
+
+def main():
+	from argparse import ArgumentParser
+	import json
+
+	# Parse args
+	parser = ArgumentParser(description='Gets CPU info with pure Python')
+	parser.add_argument('--json', action='store_true', help='Return the info in JSON format')
+	parser.add_argument('--version', action='store_true', help='Return the version of py-cpuinfo')
+	parser.add_argument('--trace', action='store_true', help='Traces code paths used to find CPU info to file')
+	args = parser.parse_args()
+
+	global g_trace
+	g_trace = Trace(args.trace, False)
+
+	try:
+		_check_arch()
+	except Exception as err:
+		sys.stderr.write(str(err) + "\n")
+		sys.exit(1)
+
+	info = _get_cpu_info_internal()
+
+	if not info:
+		sys.stderr.write("Failed to find cpu info\n")
+		sys.exit(1)
+
+	if args.json:
+		print(json.dumps(info))
+	elif args.version:
+		print(CPUINFO_VERSION_STRING)
+	else:
+		print('Python Version: {0}'.format(info.get('python_version', '')))
+		print('Cpuinfo Version: {0}'.format(info.get('cpuinfo_version_string', '')))
+		print('Vendor ID Raw: {0}'.format(info.get('vendor_id_raw', '')))
+		print('Hardware Raw: {0}'.format(info.get('hardware_raw', '')))
+		print('Brand Raw: {0}'.format(info.get('brand_raw', '')))
+		print('Hz Advertised Friendly: {0}'.format(info.get('hz_advertised_friendly', '')))
+		print('Hz Actual Friendly: {0}'.format(info.get('hz_actual_friendly', '')))
+		print('Hz Advertised: {0}'.format(info.get('hz_advertised', '')))
+		print('Hz Actual: {0}'.format(info.get('hz_actual', '')))
+		print('Arch: {0}'.format(info.get('arch', '')))
+		print('Bits: {0}'.format(info.get('bits', '')))
+		print('Count: {0}'.format(info.get('count', '')))
+		print('Arch String Raw: {0}'.format(info.get('arch_string_raw', '')))
+		print('L1 Data Cache Size: {0}'.format(info.get('l1_data_cache_size', '')))
+		print('L1 Instruction Cache Size: {0}'.format(info.get('l1_instruction_cache_size', '')))
+		print('L2 Cache Size: {0}'.format(info.get('l2_cache_size', '')))
+		print('L2 Cache Line Size: {0}'.format(info.get('l2_cache_line_size', '')))
+		print('L2 Cache Associativity: {0}'.format(info.get('l2_cache_associativity', '')))
+		print('L3 Cache Size: {0}'.format(info.get('l3_cache_size', '')))
+		print('Stepping: {0}'.format(info.get('stepping', '')))
+		print('Model: {0}'.format(info.get('model', '')))
+		print('Family: {0}'.format(info.get('family', '')))
+		print('Processor Type: {0}'.format(info.get('processor_type', '')))
+		print('Flags: {0}'.format(', '.join(info.get('flags', ''))))
+
+
+if __name__ == '__main__':
+	main()
+else:
+	g_trace = Trace(False, False)
+	_check_arch()
diff --git a/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/INSTALLER b/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/LICENSE b/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..336b1f83e5d4d30bc9c7be578b83dc21664ebe65
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Ravindra Marella
+
+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
+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.
diff --git a/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/METADATA b/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..29a15b8ceb1c4fd2a8f094bc1ac66dc69a3a9ba2
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/METADATA
@@ -0,0 +1,592 @@
+Metadata-Version: 2.1
+Name: ctransformers
+Version: 0.2.27
+Summary: Python bindings for the Transformer models implemented in C/C++ using GGML library.
+Home-page: https://github.com/marella/ctransformers
+Author: Ravindra Marella
+Author-email: mv.ravindra007@gmail.com
+License: MIT
+Keywords: ctransformers transformers ai llm
+Platform: UNKNOWN
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Description-Content-Type: text/markdown
+Requires-Dist: huggingface-hub
+Requires-Dist: py-cpuinfo (<10.0.0,>=9.0.0)
+Provides-Extra: cuda
+Requires-Dist: nvidia-cublas-cu12 ; extra == 'cuda'
+Requires-Dist: nvidia-cuda-runtime-cu12 ; extra == 'cuda'
+Provides-Extra: gptq
+Requires-Dist: exllama (==0.1.0) ; extra == 'gptq'
+Provides-Extra: tests
+Requires-Dist: pytest ; extra == 'tests'
+
+# [CTransformers](https://github.com/marella/ctransformers) [![PyPI](https://img.shields.io/pypi/v/ctransformers)](https://pypi.org/project/ctransformers/) [![tests](https://github.com/marella/ctransformers/actions/workflows/tests.yml/badge.svg)](https://github.com/marella/ctransformers/actions/workflows/tests.yml) [![build](https://github.com/marella/ctransformers/actions/workflows/build.yml/badge.svg)](https://github.com/marella/ctransformers/actions/workflows/build.yml)
+
+Python bindings for the Transformer models implemented in C/C++ using [GGML](https://github.com/ggerganov/ggml) library.
+
+> Also see [ChatDocs](https://github.com/marella/chatdocs)
+
+- [Supported Models](#supported-models)
+- [Installation](#installation)
+- [Usage](#usage)
+  - [🤗 Transformers](#transformers)
+  - [LangChain](#langchain)
+  - [GPU](#gpu)
+  - [GPTQ](#gptq)
+- [Documentation](#documentation)
+- [License](#license)
+
+## Supported Models
+
+| Models              | Model Type    | CUDA | Metal |
+| :------------------ | ------------- | :--: | :---: |
+| GPT-2               | `gpt2`        |      |       |
+| GPT-J, GPT4All-J    | `gptj`        |      |       |
+| GPT-NeoX, StableLM  | `gpt_neox`    |      |       |
+| Falcon              | `falcon`      |  ✅  |       |
+| LLaMA, LLaMA 2      | `llama`       |  ✅  |  ✅   |
+| MPT                 | `mpt`         |  ✅  |       |
+| StarCoder, StarChat | `gpt_bigcode` |  ✅  |       |
+| Dolly V2            | `dolly-v2`    |      |       |
+| Replit              | `replit`      |      |       |
+
+## Installation
+
+```sh
+pip install ctransformers
+```
+
+## Usage
+
+It provides a unified interface for all models:
+
+```py
+from ctransformers import AutoModelForCausalLM
+
+llm = AutoModelForCausalLM.from_pretrained("/path/to/ggml-model.bin", model_type="gpt2")
+
+print(llm("AI is going to"))
+```
+
+[Run in Google Colab](https://colab.research.google.com/drive/1GMhYMUAv_TyZkpfvUI1NirM8-9mCXQyL)
+
+To stream the output, set `stream=True`:
+
+```py
+for text in llm("AI is going to", stream=True):
+    print(text, end="", flush=True)
+```
+
+You can load models from Hugging Face Hub directly:
+
+```py
+llm = AutoModelForCausalLM.from_pretrained("marella/gpt-2-ggml")
+```
+
+If a model repo has multiple model files (`.bin` or `.gguf` files), specify a model file using:
+
+```py
+llm = AutoModelForCausalLM.from_pretrained("marella/gpt-2-ggml", model_file="ggml-model.bin")
+```
+
+<a id="transformers"></a>
+
+### 🤗 Transformers
+
+> **Note:** This is an experimental feature and may change in the future.
+
+To use it with 🤗 Transformers, create model and tokenizer using:
+
+```py
+from ctransformers import AutoModelForCausalLM, AutoTokenizer
+
+model = AutoModelForCausalLM.from_pretrained("marella/gpt-2-ggml", hf=True)
+tokenizer = AutoTokenizer.from_pretrained(model)
+```
+
+[Run in Google Colab](https://colab.research.google.com/drive/1FVSLfTJ2iBbQ1oU2Rqz0MkpJbaB_5Got)
+
+You can use 🤗 Transformers text generation pipeline:
+
+```py
+from transformers import pipeline
+
+pipe = pipeline("text-generation", model=model, tokenizer=tokenizer)
+print(pipe("AI is going to", max_new_tokens=256))
+```
+
+You can use 🤗 Transformers generation [parameters](https://huggingface.co/docs/transformers/main/en/main_classes/text_generation#transformers.GenerationConfig):
+
+```py
+pipe("AI is going to", max_new_tokens=256, do_sample=True, temperature=0.8, repetition_penalty=1.1)
+```
+
+You can use 🤗 Transformers tokenizers:
+
+```py
+from ctransformers import AutoModelForCausalLM
+from transformers import AutoTokenizer
+
+model = AutoModelForCausalLM.from_pretrained("marella/gpt-2-ggml", hf=True)  # Load model from GGML model repo.
+tokenizer = AutoTokenizer.from_pretrained("gpt2")  # Load tokenizer from original model repo.
+```
+
+### LangChain
+
+It is integrated into LangChain. See [LangChain docs](https://python.langchain.com/docs/ecosystem/integrations/ctransformers).
+
+### GPU
+
+To run some of the model layers on GPU, set the `gpu_layers` parameter:
+
+```py
+llm = AutoModelForCausalLM.from_pretrained("TheBloke/Llama-2-7B-GGML", gpu_layers=50)
+```
+
+[Run in Google Colab](https://colab.research.google.com/drive/1Ihn7iPCYiqlTotpkqa1tOhUIpJBrJ1Tp)
+
+#### CUDA
+
+Install CUDA libraries using:
+
+```sh
+pip install ctransformers[cuda]
+```
+
+#### ROCm
+
+To enable ROCm support, install the `ctransformers` package using:
+
+```sh
+CT_HIPBLAS=1 pip install ctransformers --no-binary ctransformers
+```
+
+#### Metal
+
+To enable Metal support, install the `ctransformers` package using:
+
+```sh
+CT_METAL=1 pip install ctransformers --no-binary ctransformers
+```
+
+### GPTQ
+
+> **Note:** This is an experimental feature and only LLaMA models are supported using [ExLlama](https://github.com/turboderp/exllama).
+
+Install additional dependencies using:
+
+```sh
+pip install ctransformers[gptq]
+```
+
+Load a GPTQ model using:
+
+```py
+llm = AutoModelForCausalLM.from_pretrained("TheBloke/Llama-2-7B-GPTQ")
+```
+
+[Run in Google Colab](https://colab.research.google.com/drive/1SzHslJ4CiycMOgrppqecj4VYCWFnyrN0)
+
+> If model name or path doesn't contain the word `gptq` then specify `model_type="gptq"`.
+
+It can also be used with LangChain. Low-level APIs are not fully supported.
+
+## Documentation
+
+<!-- API_DOCS -->
+
+### Config
+
+| Parameter            | Type        | Description                                                     | Default |
+| :------------------- | :---------- | :-------------------------------------------------------------- | :------ |
+| `top_k`              | `int`       | The top-k value to use for sampling.                            | `40`    |
+| `top_p`              | `float`     | The top-p value to use for sampling.                            | `0.95`  |
+| `temperature`        | `float`     | The temperature to use for sampling.                            | `0.8`   |
+| `repetition_penalty` | `float`     | The repetition penalty to use for sampling.                     | `1.1`   |
+| `last_n_tokens`      | `int`       | The number of last tokens to use for repetition penalty.        | `64`    |
+| `seed`               | `int`       | The seed value to use for sampling tokens.                      | `-1`    |
+| `max_new_tokens`     | `int`       | The maximum number of new tokens to generate.                   | `256`   |
+| `stop`               | `List[str]` | A list of sequences to stop generation when encountered.        | `None`  |
+| `stream`             | `bool`      | Whether to stream the generated text.                           | `False` |
+| `reset`              | `bool`      | Whether to reset the model state before generating text.        | `True`  |
+| `batch_size`         | `int`       | The batch size to use for evaluating tokens in a single prompt. | `8`     |
+| `threads`            | `int`       | The number of threads to use for evaluating tokens.             | `-1`    |
+| `context_length`     | `int`       | The maximum context length to use.                              | `-1`    |
+| `gpu_layers`         | `int`       | The number of layers to run on GPU.                             | `0`     |
+
+> **Note:** Currently only LLaMA, MPT and Falcon models support the `context_length` parameter.
+
+### <kbd>class</kbd> `AutoModelForCausalLM`
+
+---
+
+#### <kbd>classmethod</kbd> `AutoModelForCausalLM.from_pretrained`
+
+```python
+from_pretrained(
+    model_path_or_repo_id: str,
+    model_type: Optional[str] = None,
+    model_file: Optional[str] = None,
+    config: Optional[ctransformers.hub.AutoConfig] = None,
+    lib: Optional[str] = None,
+    local_files_only: bool = False,
+    revision: Optional[str] = None,
+    hf: bool = False,
+    **kwargs
+) → LLM
+```
+
+Loads the language model from a local file or remote repo.
+
+**Args:**
+
+- <b>`model_path_or_repo_id`</b>: The path to a model file or directory or the name of a Hugging Face Hub model repo.
+- <b>`model_type`</b>: The model type.
+- <b>`model_file`</b>: The name of the model file in repo or directory.
+- <b>`config`</b>: `AutoConfig` object.
+- <b>`lib`</b>: The path to a shared library or one of `avx2`, `avx`, `basic`.
+- <b>`local_files_only`</b>: Whether or not to only look at local files (i.e., do not try to download the model).
+- <b>`revision`</b>: The specific model version to use. It can be a branch name, a tag name, or a commit id.
+- <b>`hf`</b>: Whether to create a Hugging Face Transformers model.
+
+**Returns:**
+`LLM` object.
+
+### <kbd>class</kbd> `LLM`
+
+### <kbd>method</kbd> `LLM.__init__`
+
+```python
+__init__(
+    model_path: str,
+    model_type: Optional[str] = None,
+    config: Optional[ctransformers.llm.Config] = None,
+    lib: Optional[str] = None
+)
+```
+
+Loads the language model from a local file.
+
+**Args:**
+
+- <b>`model_path`</b>: The path to a model file.
+- <b>`model_type`</b>: The model type.
+- <b>`config`</b>: `Config` object.
+- <b>`lib`</b>: The path to a shared library or one of `avx2`, `avx`, `basic`.
+
+---
+
+##### <kbd>property</kbd> LLM.bos_token_id
+
+The beginning-of-sequence token.
+
+---
+
+##### <kbd>property</kbd> LLM.config
+
+The config object.
+
+---
+
+##### <kbd>property</kbd> LLM.context_length
+
+The context length of model.
+
+---
+
+##### <kbd>property</kbd> LLM.embeddings
+
+The input embeddings.
+
+---
+
+##### <kbd>property</kbd> LLM.eos_token_id
+
+The end-of-sequence token.
+
+---
+
+##### <kbd>property</kbd> LLM.logits
+
+The unnormalized log probabilities.
+
+---
+
+##### <kbd>property</kbd> LLM.model_path
+
+The path to the model file.
+
+---
+
+##### <kbd>property</kbd> LLM.model_type
+
+The model type.
+
+---
+
+##### <kbd>property</kbd> LLM.pad_token_id
+
+The padding token.
+
+---
+
+##### <kbd>property</kbd> LLM.vocab_size
+
+The number of tokens in vocabulary.
+
+---
+
+#### <kbd>method</kbd> `LLM.detokenize`
+
+```python
+detokenize(tokens: Sequence[int], decode: bool = True) → Union[str, bytes]
+```
+
+Converts a list of tokens to text.
+
+**Args:**
+
+- <b>`tokens`</b>: The list of tokens.
+- <b>`decode`</b>: Whether to decode the text as UTF-8 string.
+
+**Returns:**
+The combined text of all tokens.
+
+---
+
+#### <kbd>method</kbd> `LLM.embed`
+
+```python
+embed(
+    input: Union[str, Sequence[int]],
+    batch_size: Optional[int] = None,
+    threads: Optional[int] = None
+) → List[float]
+```
+
+Computes embeddings for a text or list of tokens.
+
+> **Note:** Currently only LLaMA and Falcon models support embeddings.
+
+**Args:**
+
+- <b>`input`</b>: The input text or list of tokens to get embeddings for.
+- <b>`batch_size`</b>: The batch size to use for evaluating tokens in a single prompt. Default: `8`
+- <b>`threads`</b>: The number of threads to use for evaluating tokens. Default: `-1`
+
+**Returns:**
+The input embeddings.
+
+---
+
+#### <kbd>method</kbd> `LLM.eval`
+
+```python
+eval(
+    tokens: Sequence[int],
+    batch_size: Optional[int] = None,
+    threads: Optional[int] = None
+) → None
+```
+
+Evaluates a list of tokens.
+
+**Args:**
+
+- <b>`tokens`</b>: The list of tokens to evaluate.
+- <b>`batch_size`</b>: The batch size to use for evaluating tokens in a single prompt. Default: `8`
+- <b>`threads`</b>: The number of threads to use for evaluating tokens. Default: `-1`
+
+---
+
+#### <kbd>method</kbd> `LLM.generate`
+
+```python
+generate(
+    tokens: Sequence[int],
+    top_k: Optional[int] = None,
+    top_p: Optional[float] = None,
+    temperature: Optional[float] = None,
+    repetition_penalty: Optional[float] = None,
+    last_n_tokens: Optional[int] = None,
+    seed: Optional[int] = None,
+    batch_size: Optional[int] = None,
+    threads: Optional[int] = None,
+    reset: Optional[bool] = None
+) → Generator[int, NoneType, NoneType]
+```
+
+Generates new tokens from a list of tokens.
+
+**Args:**
+
+- <b>`tokens`</b>: The list of tokens to generate tokens from.
+- <b>`top_k`</b>: The top-k value to use for sampling. Default: `40`
+- <b>`top_p`</b>: The top-p value to use for sampling. Default: `0.95`
+- <b>`temperature`</b>: The temperature to use for sampling. Default: `0.8`
+- <b>`repetition_penalty`</b>: The repetition penalty to use for sampling. Default: `1.1`
+- <b>`last_n_tokens`</b>: The number of last tokens to use for repetition penalty. Default: `64`
+- <b>`seed`</b>: The seed value to use for sampling tokens. Default: `-1`
+- <b>`batch_size`</b>: The batch size to use for evaluating tokens in a single prompt. Default: `8`
+- <b>`threads`</b>: The number of threads to use for evaluating tokens. Default: `-1`
+- <b>`reset`</b>: Whether to reset the model state before generating text. Default: `True`
+
+**Returns:**
+The generated tokens.
+
+---
+
+#### <kbd>method</kbd> `LLM.is_eos_token`
+
+```python
+is_eos_token(token: int) → bool
+```
+
+Checks if a token is an end-of-sequence token.
+
+**Args:**
+
+- <b>`token`</b>: The token to check.
+
+**Returns:**
+`True` if the token is an end-of-sequence token else `False`.
+
+---
+
+#### <kbd>method</kbd> `LLM.prepare_inputs_for_generation`
+
+```python
+prepare_inputs_for_generation(
+    tokens: Sequence[int],
+    reset: Optional[bool] = None
+) → Sequence[int]
+```
+
+Removes input tokens that are evaluated in the past and updates the LLM context.
+
+**Args:**
+
+- <b>`tokens`</b>: The list of input tokens.
+- <b>`reset`</b>: Whether to reset the model state before generating text. Default: `True`
+
+**Returns:**
+The list of tokens to evaluate.
+
+---
+
+#### <kbd>method</kbd> `LLM.reset`
+
+```python
+reset() → None
+```
+
+Deprecated since 0.2.27.
+
+---
+
+#### <kbd>method</kbd> `LLM.sample`
+
+```python
+sample(
+    top_k: Optional[int] = None,
+    top_p: Optional[float] = None,
+    temperature: Optional[float] = None,
+    repetition_penalty: Optional[float] = None,
+    last_n_tokens: Optional[int] = None,
+    seed: Optional[int] = None
+) → int
+```
+
+Samples a token from the model.
+
+**Args:**
+
+- <b>`top_k`</b>: The top-k value to use for sampling. Default: `40`
+- <b>`top_p`</b>: The top-p value to use for sampling. Default: `0.95`
+- <b>`temperature`</b>: The temperature to use for sampling. Default: `0.8`
+- <b>`repetition_penalty`</b>: The repetition penalty to use for sampling. Default: `1.1`
+- <b>`last_n_tokens`</b>: The number of last tokens to use for repetition penalty. Default: `64`
+- <b>`seed`</b>: The seed value to use for sampling tokens. Default: `-1`
+
+**Returns:**
+The sampled token.
+
+---
+
+#### <kbd>method</kbd> `LLM.tokenize`
+
+```python
+tokenize(text: str, add_bos_token: Optional[bool] = None) → List[int]
+```
+
+Converts a text into list of tokens.
+
+**Args:**
+
+- <b>`text`</b>: The text to tokenize.
+- <b>`add_bos_token`</b>: Whether to add the beginning-of-sequence token.
+
+**Returns:**
+The list of tokens.
+
+---
+
+#### <kbd>method</kbd> `LLM.__call__`
+
+```python
+__call__(
+    prompt: str,
+    max_new_tokens: Optional[int] = None,
+    top_k: Optional[int] = None,
+    top_p: Optional[float] = None,
+    temperature: Optional[float] = None,
+    repetition_penalty: Optional[float] = None,
+    last_n_tokens: Optional[int] = None,
+    seed: Optional[int] = None,
+    batch_size: Optional[int] = None,
+    threads: Optional[int] = None,
+    stop: Optional[Sequence[str]] = None,
+    stream: Optional[bool] = None,
+    reset: Optional[bool] = None
+) → Union[str, Generator[str, NoneType, NoneType]]
+```
+
+Generates text from a prompt.
+
+**Args:**
+
+- <b>`prompt`</b>: The prompt to generate text from.
+- <b>`max_new_tokens`</b>: The maximum number of new tokens to generate. Default: `256`
+- <b>`top_k`</b>: The top-k value to use for sampling. Default: `40`
+- <b>`top_p`</b>: The top-p value to use for sampling. Default: `0.95`
+- <b>`temperature`</b>: The temperature to use for sampling. Default: `0.8`
+- <b>`repetition_penalty`</b>: The repetition penalty to use for sampling. Default: `1.1`
+- <b>`last_n_tokens`</b>: The number of last tokens to use for repetition penalty. Default: `64`
+- <b>`seed`</b>: The seed value to use for sampling tokens. Default: `-1`
+- <b>`batch_size`</b>: The batch size to use for evaluating tokens in a single prompt. Default: `8`
+- <b>`threads`</b>: The number of threads to use for evaluating tokens. Default: `-1`
+- <b>`stop`</b>: A list of sequences to stop generation when encountered. Default: `None`
+- <b>`stream`</b>: Whether to stream the generated text. Default: `False`
+- <b>`reset`</b>: Whether to reset the model state before generating text. Default: `True`
+
+**Returns:**
+The generated text.
+
+<!-- API_DOCS -->
+
+## License
+
+[MIT](https://github.com/marella/ctransformers/blob/main/LICENSE)
+
+
diff --git a/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/RECORD b/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..3a1683a1d3fa51242c0689539bb3ce040395934e
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/RECORD
@@ -0,0 +1,40 @@
+ctransformers-0.2.27.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+ctransformers-0.2.27.dist-info/LICENSE,sha256=hIcwOY6ByAAN0ghg64lJ-gNzEPqakLF2wRwK2F3oNkw,1078
+ctransformers-0.2.27.dist-info/METADATA,sha256=UwSjIX0hRN3F48BUlsZD9_YW6Ur-e0rxaQZuRCgYSEA,17580
+ctransformers-0.2.27.dist-info/RECORD,,
+ctransformers-0.2.27.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ctransformers-0.2.27.dist-info/WHEEL,sha256=g4nMs7d-Xl9-xC9XovUrsDHGXt-FT0E17Yqo92DEfvY,92
+ctransformers-0.2.27.dist-info/top_level.txt,sha256=dkLmSeLysRe0LDxM3mH_pwTbpJmhvfjp_NltBjdG4dQ,14
+ctransformers/__init__.py,sha256=WM-BX3TD-iNqfZTDkitPKAHyq869mJPeaamjNv1VRZE,94
+ctransformers/__pycache__/__init__.cpython-311.pyc,,
+ctransformers/__pycache__/hub.cpython-311.pyc,,
+ctransformers/__pycache__/langchain.cpython-311.pyc,,
+ctransformers/__pycache__/lib.cpython-311.pyc,,
+ctransformers/__pycache__/llm.cpython-311.pyc,,
+ctransformers/__pycache__/logger.cpython-311.pyc,,
+ctransformers/__pycache__/transformers.cpython-311.pyc,,
+ctransformers/__pycache__/utils.cpython-311.pyc,,
+ctransformers/gptq/__init__.py,sha256=EPGnQ71HaH8A-LHuCTLQGB1z2_TYZ60S2CuSXaBzulo,59
+ctransformers/gptq/__pycache__/__init__.cpython-311.pyc,,
+ctransformers/gptq/__pycache__/hub.cpython-311.pyc,,
+ctransformers/gptq/__pycache__/llm.cpython-311.pyc,,
+ctransformers/gptq/hub.py,sha256=bxnSOvsOO5vcTdmGGssBP8T9NZZjFUJqdmXMFVhbTyc,2164
+ctransformers/gptq/llm.py,sha256=Q26NazRieneLoduQFU4gfsDgMTzoe2tCXfpW_JkN6ck,9506
+ctransformers/hub.py,sha256=isCoiOaWlC7PPQ4Prw3RkcvG5ZxV4SvQBJG0Rm248MQ,8478
+ctransformers/langchain.py,sha256=FFZyRkNfJJKe00a68lwQSBKdaI8qW9Y4JOU4d9vMnwc,2620
+ctransformers/lib.py,sha256=tj4QCJh6aLmsP4cV9xsbiMwkfzxcu9QkQxkjX712_FY,2838
+ctransformers/lib/avx/ctransformers.dll,sha256=ikBxOHY-op6sDOXTQc9div8dNqAkKTU_NFEKcQ18DtQ,1282048
+ctransformers/lib/avx/libctransformers.dylib,sha256=Ho2xTChYqHfoqINSnpRCjJ_CWU49ecLy8t74qEGRUZk,1330880
+ctransformers/lib/avx/libctransformers.so,sha256=V3o9TvADlc2JsZomSV7ZKfHtA2YVnPym0TRTLvivKyw,1519272
+ctransformers/lib/avx2/ctransformers.dll,sha256=hmIWtN8VEi8o_TLPY7m-EsMh-8XYv9nWm1OTaHEg-XM,1263104
+ctransformers/lib/avx2/libctransformers.dylib,sha256=M9xZuPxHX5cEkhkwfG-KUb8sG4noYAhDxFSR9DHmB8Y,1330880
+ctransformers/lib/avx2/libctransformers.so,sha256=CbJiH8GAXAEvJf245o94Tkv6kdTiWlYLnE5g36j_e9U,1523368
+ctransformers/lib/basic/ctransformers.dll,sha256=gutTYW1CvMDDyxBX2IAeCYBubj0YxBiy6TsQVWtGd4E,1288192
+ctransformers/lib/basic/libctransformers.dylib,sha256=84WZr-mmiWrqfmN61FlRoXXsek9lOZZiH1LhPN-n6Gg,2525123
+ctransformers/lib/basic/libctransformers.so,sha256=iSaYkX7Ykge7tX9_zWK47gcx69Wzislq1TAvOITZ90g,1482416
+ctransformers/lib/cuda/ctransformers.dll,sha256=hckHpQ_zpbs90z0B146nRpYeOB_ywrAFbcp-pQIB_34,5395968
+ctransformers/lib/cuda/libctransformers.so,sha256=2tBSQP2JnTZu6JJTjMQessvgPXa2W1xxysOvF39TWQk,5691856
+ctransformers/llm.py,sha256=rU4EHPp9UOysJhJ_n2500nZvGjH-tXIeBazA5Yu06eM,20839
+ctransformers/logger.py,sha256=Dm2duNNdRNj2ec33l1rC-3JSx0nX5xB8EPI3R9IORZo,60
+ctransformers/transformers.py,sha256=d3RIIereFRWvx16s_w2fsPZ5s5V2n1Psl2HJz7UsM8o,4494
+ctransformers/utils.py,sha256=I-BoMGUmZ8yYsMsy4et8KtLRSY_avP6HrRWWhhZJx1o,1806
diff --git a/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/REQUESTED b/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/REQUESTED
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/WHEEL b/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..b552003ff90e66227ec90d1b159324f140d46001
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/top_level.txt b/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..b06a12c54335e9af172f8bf15e0dcdf8f008fecf
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers-0.2.27.dist-info/top_level.txt
@@ -0,0 +1 @@
+ctransformers
diff --git a/llm/Lib/site-packages/ctransformers/__init__.py b/llm/Lib/site-packages/ctransformers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..dbb28abb19e088841a82f57e04ee9a9ef2c88a1c
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/__init__.py
@@ -0,0 +1,2 @@
+from .llm import Config, LLM
+from .hub import AutoConfig, AutoModelForCausalLM, AutoTokenizer
diff --git a/llm/Lib/site-packages/ctransformers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/ctransformers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..41419b3dd0be9b0fa42d4aaf76fc5b5660ecc36f
Binary files /dev/null and b/llm/Lib/site-packages/ctransformers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/ctransformers/__pycache__/hub.cpython-311.pyc b/llm/Lib/site-packages/ctransformers/__pycache__/hub.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..76b8f51d09ccf72da95f9568995fd6b335ec8bb6
Binary files /dev/null and b/llm/Lib/site-packages/ctransformers/__pycache__/hub.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/ctransformers/__pycache__/langchain.cpython-311.pyc b/llm/Lib/site-packages/ctransformers/__pycache__/langchain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a34dd7dc7bd2c4272b515839894a4a2d54597adb
Binary files /dev/null and b/llm/Lib/site-packages/ctransformers/__pycache__/langchain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/ctransformers/__pycache__/lib.cpython-311.pyc b/llm/Lib/site-packages/ctransformers/__pycache__/lib.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c24b27b82d950374964cf5e9aa8875f6d7e86de7
Binary files /dev/null and b/llm/Lib/site-packages/ctransformers/__pycache__/lib.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/ctransformers/__pycache__/llm.cpython-311.pyc b/llm/Lib/site-packages/ctransformers/__pycache__/llm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..06de790a6d2ed646151f3c01f0da759c0ff12150
Binary files /dev/null and b/llm/Lib/site-packages/ctransformers/__pycache__/llm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/ctransformers/__pycache__/logger.cpython-311.pyc b/llm/Lib/site-packages/ctransformers/__pycache__/logger.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..24e0ede596155aa6b096a370eecb402f950eab8c
Binary files /dev/null and b/llm/Lib/site-packages/ctransformers/__pycache__/logger.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/ctransformers/__pycache__/transformers.cpython-311.pyc b/llm/Lib/site-packages/ctransformers/__pycache__/transformers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..49a9341992eb8e3c647a1de655a3ee04cdc7b23b
Binary files /dev/null and b/llm/Lib/site-packages/ctransformers/__pycache__/transformers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/ctransformers/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/ctransformers/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..28f9881505088a4c5ae92d222566ab60aee5124a
Binary files /dev/null and b/llm/Lib/site-packages/ctransformers/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/ctransformers/gptq/__init__.py b/llm/Lib/site-packages/ctransformers/gptq/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7e5131094af0c3c9f1682bb5a9328cc90551108
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/gptq/__init__.py
@@ -0,0 +1,2 @@
+from .llm import LLM
+from .hub import AutoModelForCausalLM
diff --git a/llm/Lib/site-packages/ctransformers/gptq/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/ctransformers/gptq/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..06b6d1787a402f1f6aca2ad3109b96cf49440ac4
Binary files /dev/null and b/llm/Lib/site-packages/ctransformers/gptq/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/ctransformers/gptq/__pycache__/hub.cpython-311.pyc b/llm/Lib/site-packages/ctransformers/gptq/__pycache__/hub.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..28f455356d60394b1e06d99efc8a36c9765fd271
Binary files /dev/null and b/llm/Lib/site-packages/ctransformers/gptq/__pycache__/hub.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/ctransformers/gptq/__pycache__/llm.cpython-311.pyc b/llm/Lib/site-packages/ctransformers/gptq/__pycache__/llm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..db30a8c9b06e8a38788bddeb8ded79f0062dec51
Binary files /dev/null and b/llm/Lib/site-packages/ctransformers/gptq/__pycache__/llm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/ctransformers/gptq/hub.py b/llm/Lib/site-packages/ctransformers/gptq/hub.py
new file mode 100644
index 0000000000000000000000000000000000000000..225d58defc07069d24555ad3572824a43bc372f6
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/gptq/hub.py
@@ -0,0 +1,71 @@
+from pathlib import Path
+from typing import Optional
+
+from huggingface_hub import snapshot_download
+from huggingface_hub.utils import validate_repo_id, HFValidationError
+
+from ..llm import Config
+from .llm import LLM
+
+
+def get_path_type(path: str) -> Optional[str]:
+    p = Path(path)
+    if p.is_file():
+        return "file"
+    elif p.is_dir():
+        return "dir"
+    try:
+        validate_repo_id(path)
+        return "repo"
+    except HFValidationError:
+        pass
+
+
+class AutoModelForCausalLM:
+    @classmethod
+    def from_pretrained(
+        cls,
+        model_path_or_repo_id: str,
+        *,
+        local_files_only: bool = False,
+        revision: Optional[str] = None,
+        **kwargs,
+    ) -> LLM:
+        """Loads the language model from a local file or remote repo.
+
+        Args:
+            model_path_or_repo_id: The path to a model file or directory or the
+            name of a Hugging Face Hub model repo.
+            local_files_only: Whether or not to only look at local files
+            (i.e., do not try to download the model).
+            revision: The specific model version to use. It can be a branch
+            name, a tag name, or a commit id.
+
+        Returns:
+            `LLM` object.
+        """
+        config = Config()
+        for k, v in kwargs.items():
+            if not hasattr(config, k):
+                raise TypeError(
+                    f"'{k}' is an invalid keyword argument for from_pretrained()"
+                )
+            setattr(config, k, v)
+
+        path_type = get_path_type(model_path_or_repo_id)
+        if not path_type:
+            raise ValueError(f"Model path '{model_path_or_repo_id}' doesn't exist.")
+
+        model_path = None
+        if path_type == "file":
+            model_path = Path(model_path_or_repo_id).parent
+        elif path_type == "dir":
+            model_path = Path(model_path_or_repo_id)
+        elif path_type == "repo":
+            model_path = snapshot_download(
+                repo_id=model_path_or_repo_id,
+                local_files_only=local_files_only,
+                revision=revision,
+            )
+
+        return LLM(model_path=model_path, config=config)
diff --git a/llm/Lib/site-packages/ctransformers/gptq/llm.py b/llm/Lib/site-packages/ctransformers/gptq/llm.py
new file mode 100644
index 0000000000000000000000000000000000000000..d4186e2025ccd5af07d91f4fd7feaa542ddbd725
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/gptq/llm.py
@@ -0,0 +1,312 @@
+try:
+    import exllama
+except ImportError:
+    raise ImportError(
+        "Could not import `exllama` package. "
+        "Please install it using `pip install ctransformers[gptq]`"
+    )
+
+import re
+from pathlib import Path
+from typing import (
+    Generator,
+    List,
+    Optional,
+    Sequence,
+    Union,
+)
+
+import torch
+from exllama.model import ExLlama, ExLlamaCache, ExLlamaConfig
+from exllama.tokenizer import ExLlamaTokenizer
+from exllama.generator import ExLlamaGenerator
+
+from ..llm import Config, doc, get
+
+
+class LLM:
+    def __init__(
+        self,
+        model_path: str,
+        *,
+        config: Optional[Config] = None,
+    ):
+        """Loads the language model from a local file.
+
+        Args:
+            model_path: The path to a model directory.
+            config: `Config` object.
+        """
+        model_path = Path(model_path).resolve()
+        config = config or Config()
+        self._model_path = model_path
+        self._config = config
+
+        files = [
+            (f.stat().st_size, f)
+            for f in model_path.iterdir()
+            if f.is_file() and f.name.endswith(".safetensors")
+        ]
+        if not files:
+            raise ValueError(f"No model file found in directory '{model_path}'")
+        model_file = min(files)[1]
+
+        model_config = ExLlamaConfig(str(model_path / "config.json"))
+        model_config.model_path = str(model_file)
+
+        model = ExLlama(model_config)
+        tokenizer = ExLlamaTokenizer(str(model_path / "tokenizer.model"))
+        cache = ExLlamaCache(model)
+        generator = ExLlamaGenerator(model, tokenizer, cache)
+
+        self._model = model
+        self._tokenizer = tokenizer
+        self._generator = generator
+
+    @property
+    def model_path(self) -> str:
+        """The path to the model directory."""
+        return self._model_path
+
+    @property
+    def config(self) -> Config:
+        """The config object."""
+        return self._config
+
+    @property
+    def eos_token_id(self) -> int:
+        """The end-of-sequence token."""
+        return self._tokenizer.eos_token_id
+
+    @property
+    def vocab_size(self) -> int:
+        """The number of tokens in vocabulary."""
+        return self._model.config.vocab_size
+
+    @property
+    def context_length(self) -> int:
+        """The context length of model."""
+        return self._model.config.max_seq_len
+
+    def tokenize(self, text: str) -> List[int]:
+        """Converts a text into list of tokens.
+
+        Args:
+            text: The text to tokenize.
+
+        Returns:
+            The list of tokens.
+        """
+        return self._tokenizer.encode(text)
+
+    def detokenize(
+        self,
+        tokens: Sequence[int],
+        decode: bool = True,
+    ) -> Union[str, bytes]:
+        """Converts a list of tokens to text.
+
+        Args:
+            tokens: The list of tokens.
+            decode: Whether to decode the text as UTF-8 string.
+
+        Returns:
+            The combined text of all tokens.
+        """
+        if isinstance(tokens, int):
+            tokens = [tokens]
+        if isinstance(tokens, list):
+            tokens = torch.tensor(tokens)
+        return self._tokenizer.decode(tokens)
+
+    def is_eos_token(self, token: int) -> bool:
+        """Checks if a token is an end-of-sequence token.
+
+        Args:
+            token: The token to check.
+
+        Returns:
+            `True` if the token is an end-of-sequence token else `False`.
+        """
+        return token == self.eos_token_id
+
+    def reset(self) -> None:
+        self._generator.reset()
+
+    @doc
+    def generate(
+        self,
+        tokens: Sequence[int],
+        *,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        temperature: Optional[float] = None,
+        repetition_penalty: Optional[float] = None,
+        last_n_tokens: Optional[int] = None,
+        seed: Optional[int] = None,
+        batch_size: Optional[int] = None,
+        threads: Optional[int] = None,
+        reset: Optional[bool] = None,
+    ) -> Generator[int, None, None]:
+        """Generates new tokens from a list of tokens.
+
+        Args:
+            tokens: The list of tokens to generate tokens from.
+            {params}
+
+        Returns:
+            The generated tokens.
+        """
+        generator = self._generator
+        config = self.config
+        top_k = get(top_k, config.top_k)
+        top_p = get(top_p, config.top_p)
+        temperature = get(temperature, config.temperature)
+        repetition_penalty = get(repetition_penalty, config.repetition_penalty)
+        last_n_tokens = get(last_n_tokens, config.last_n_tokens)
+        reset = get(reset, config.reset)
+
+        if reset:
+            self.reset()
+        generator.settings.top_k = top_k
+        generator.settings.top_p = top_p
+        generator.settings.temperature = temperature
+        generator.settings.token_repetition_penalty_max = repetition_penalty
+        generator.settings.token_repetition_penalty_sustain = last_n_tokens
+        generator.settings.token_repetition_penalty_decay = last_n_tokens // 2
+
+        if isinstance(tokens, list):
+            tokens = torch.tensor(tokens).unsqueeze(0)
+        assert tokens.shape[0] == 1
+        generator.gen_begin(tokens)
+        while True:
+            token = generator.gen_single_token()
+            token = token[0][0].item()
+            if self.is_eos_token(token):
+                break
+            yield token
+
+    def _stream(
+        self,
+        prompt: str,
+        *,
+        max_new_tokens: Optional[int] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        temperature: Optional[float] = None,
+        repetition_penalty: Optional[float] = None,
+        last_n_tokens: Optional[int] = None,
+        seed: Optional[int] = None,
+        batch_size: Optional[int] = None,
+        threads: Optional[int] = None,
+        stop: Optional[Sequence[str]] = None,
+        reset: Optional[bool] = None,
+    ) -> Generator[str, None, None]:
+        generator = self._generator
+        config = self.config
+        max_new_tokens = get(max_new_tokens, config.max_new_tokens)
+        stop = get(stop, config.stop) or []
+        if isinstance(stop, str):
+            stop = [stop]
+
+        tokens = self.tokenize(prompt)
+        max_new_tokens = min(max_new_tokens, self.context_length - tokens.shape[1])
+
+        stop_regex = re.compile("|".join(map(re.escape, stop)))
+        count = 0
+        length = len(self.detokenize(tokens[0]))
+        text = ""
+        for token in self.generate(
+            tokens,
+            top_k=top_k,
+            top_p=top_p,
+            temperature=temperature,
+            repetition_penalty=repetition_penalty,
+            last_n_tokens=last_n_tokens,
+            seed=seed,
+            batch_size=batch_size,
+            threads=threads,
+            reset=reset,
+        ):
+            new_text = self.detokenize(generator.sequence_actual[0])[length:]
+            length += len(new_text)
+            text += new_text
+
+            # https://github.com/abetlen/llama-cpp-python/blob/1a13d76c487df1c8560132d10bda62d6e2f4fa93/llama_cpp/llama.py#L686-L706
+            # Check if one of the stop sequences is part of the text.
+            # Note that the stop sequence may not always be at the end of text.
+            if stop:
+                match = stop_regex.search(text)
+                if match:
+                    text = text[: match.start()]
+                    break
+
+            # Avoid sending the longest suffix of text which is also a prefix
+            # of a stop sequence, as it can form a stop sequence with the text
+            # generated later.
+            longest = 0
+            for s in stop:
+                for i in range(len(s), 0, -1):
+                    if text.endswith(s[:i]):
+                        longest = max(i, longest)
+                        break
+
+            end = len(text) - longest
+            if end > 0:
+                yield text[:end]
+                text = text[end:]
+
+            count += 1
+            if count >= max_new_tokens:
+                break
+
+        if text:
+            yield text
+
+    @doc
+    def __call__(
+        self,
+        prompt: str,
+        *,
+        max_new_tokens: Optional[int] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        temperature: Optional[float] = None,
+        repetition_penalty: Optional[float] = None,
+        last_n_tokens: Optional[int] = None,
+        seed: Optional[int] = None,
+        batch_size: Optional[int] = None,
+        threads: Optional[int] = None,
+        stop: Optional[Sequence[str]] = None,
+        stream: Optional[bool] = None,
+        reset: Optional[bool] = None,
+    ) -> Union[str, Generator[str, None, None]]:
+        """Generates text from a prompt.
+
+        Args:
+            prompt: The prompt to generate text from.
+            {params}
+
+        Returns:
+            The generated text.
+        """
+        config = self.config
+        stream = get(stream, config.stream)
+
+        text = self._stream(
+            prompt,
+            max_new_tokens=max_new_tokens,
+            top_k=top_k,
+            top_p=top_p,
+            temperature=temperature,
+            repetition_penalty=repetition_penalty,
+            last_n_tokens=last_n_tokens,
+            seed=seed,
+            batch_size=batch_size,
+            threads=threads,
+            stop=stop,
+            reset=reset,
+        )
+        if stream:
+            return text
+        return "".join(text)
diff --git a/llm/Lib/site-packages/ctransformers/hub.py b/llm/Lib/site-packages/ctransformers/hub.py
new file mode 100644
index 0000000000000000000000000000000000000000..93fc08dce11259c1b4260df7e2caba8c664c4e46
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/hub.py
@@ -0,0 +1,268 @@
+import json
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Optional
+
+from huggingface_hub import HfApi, snapshot_download
+from huggingface_hub.utils import validate_repo_id, HFValidationError
+
+from .llm import Config, LLM
+
+
+def get_path_type(path: str) -> Optional[str]:
+    p = Path(path)
+    if p.is_file():
+        return "file"
+    elif p.is_dir():
+        return "dir"
+    try:
+        validate_repo_id(path)
+        return "repo"
+    except HFValidationError:
+        pass
+
+
+@dataclass
+class AutoConfig:
+    config: Config
+    model_type: Optional[str] = None
+
+    @classmethod
+    def from_pretrained(
+        cls,
+        model_path_or_repo_id: str,
+        local_files_only: bool = False,
+        revision: Optional[str] = None,
+        **kwargs,
+    ) -> "AutoConfig":
+        path_type = get_path_type(model_path_or_repo_id)
+        if not path_type:
+            raise ValueError(f"Model path '{model_path_or_repo_id}' doesn't exist.")
+
+        config = Config()
+        auto_config = AutoConfig(config=config)
+
+        if path_type == "dir":
+            cls._update_from_dir(model_path_or_repo_id, auto_config)
+        elif path_type == "repo":
+            cls._update_from_repo(
+                model_path_or_repo_id,
+                auto_config,
+                local_files_only=local_files_only,
+                revision=revision,
+            )
+
+        for k, v in kwargs.items():
+            if not hasattr(config, k):
+                raise TypeError(
+                    f"'{k}' is an invalid keyword argument for from_pretrained()"
+                )
+            setattr(config, k, v)
+
+        return auto_config
+
+    @classmethod
+    def _update_from_repo(
+        cls,
+        repo_id: str,
+        auto_config: "AutoConfig",
+        local_files_only: bool,
+        revision: Optional[str] = None,
+    ) -> None:
+        path = snapshot_download(
+            repo_id=repo_id,
+            allow_patterns="config.json",
+            local_files_only=local_files_only,
+            revision=revision,
+        )
+        cls._update_from_dir(path, auto_config)
+
+    @classmethod
+    def _update_from_dir(cls, path: str, auto_config: "AutoConfig") -> None:
+        path = (Path(path) / "config.json").resolve()
+        if path.is_file():
+            cls._update_from_file(path, auto_config)
+
+    @classmethod
+    def _update_from_file(cls, path: str, auto_config: "AutoConfig") -> None:
+        with open(path) as f:
+            config = json.load(f)
+
+        auto_config.model_type = config.get("model_type")
+        params = config.get("task_specific_params", {})
+        params = params.get("text-generation", {})
+        for name in [
+            "top_k",
+            "top_p",
+            "temperature",
+            "repetition_penalty",
+            "last_n_tokens",
+        ]:
+            value = params.get(name)
+            if value is not None:
+                setattr(auto_config.config, name, value)
+
+
+class AutoModelForCausalLM:
+    @classmethod
+    def from_pretrained(
+        cls,
+        model_path_or_repo_id: str,
+        *,
+        model_type: Optional[str] = None,
+        model_file: Optional[str] = None,
+        config: Optional[AutoConfig] = None,
+        lib: Optional[str] = None,
+        local_files_only: bool = False,
+        revision: Optional[str] = None,
+        hf: bool = False,
+        **kwargs,
+    ) -> LLM:
+        """Loads the language model from a local file or remote repo.
+
+        Args:
+            model_path_or_repo_id: The path to a model file or directory or the
+            name of a Hugging Face Hub model repo.
+            model_type: The model type.
+            model_file: The name of the model file in repo or directory.
+            config: `AutoConfig` object.
+            lib: The path to a shared library or one of `avx2`, `avx`, `basic`.
+            local_files_only: Whether or not to only look at local files
+            (i.e., do not try to download the model).
+            revision: The specific model version to use. It can be a branch
+            name, a tag name, or a commit id.
+            hf: Whether to create a Hugging Face Transformers model.
+
+        Returns:
+            `LLM` object.
+        """
+        if model_type is None and "gptq" in str(model_path_or_repo_id).lower():
+            model_type = "gptq"
+        if model_type == "gptq":
+            from . import gptq
+
+            return gptq.AutoModelForCausalLM.from_pretrained(
+                model_path_or_repo_id,
+                local_files_only=local_files_only,
+                revision=revision,
+                **kwargs,
+            )
+
+        config = config or AutoConfig.from_pretrained(
+            model_path_or_repo_id,
+            local_files_only=local_files_only,
+            revision=revision,
+            **kwargs,
+        )
+        model_type = model_type or config.model_type
+
+        path_type = get_path_type(model_path_or_repo_id)
+        model_path = None
+        if path_type == "file":
+            model_path = model_path_or_repo_id
+        elif path_type == "dir":
+            model_path = cls._find_model_path_from_dir(
+                model_path_or_repo_id, model_file
+            )
+        elif path_type == "repo":
+            model_path = cls._find_model_path_from_repo(
+                model_path_or_repo_id,
+                model_file,
+                local_files_only=local_files_only,
+                revision=revision,
+            )
+
+        llm = LLM(
+            model_path=model_path,
+            model_type=model_type,
+            config=config.config,
+            lib=lib,
+        )
+        if not hf:
+            return llm
+
+        from .transformers import CTransformersConfig, CTransformersModel
+
+        config = CTransformersConfig(name_or_path=str(model_path_or_repo_id))
+        return CTransformersModel(config=config, llm=llm)
+
+    @classmethod
+    def _find_model_path_from_repo(
+        cls,
+        repo_id: str,
+        filename: Optional[str],
+        local_files_only: bool,
+        revision: Optional[str] = None,
+    ) -> str:
+        if not filename and not local_files_only:
+            filename = cls._find_model_file_from_repo(
+                repo_id=repo_id,
+                revision=revision,
+            )
+        allow_patterns = filename or ["*.bin", "*.gguf"]
+        path = snapshot_download(
+            repo_id=repo_id,
+            allow_patterns=allow_patterns,
+            local_files_only=local_files_only,
+            revision=revision,
+        )
+        return cls._find_model_path_from_dir(path, filename=filename)
+
+    @classmethod
+    def _find_model_file_from_repo(
+        cls,
+        repo_id: str,
+        revision: Optional[str] = None,
+    ) -> Optional[str]:
+        api = HfApi()
+        repo_info = api.repo_info(
+            repo_id=repo_id,
+            files_metadata=True,
+            revision=revision,
+        )
+        files = [
+            (f.size, f.rfilename)
+            for f in repo_info.siblings
+            if f.rfilename.endswith(".bin") or f.rfilename.endswith(".gguf")
+        ]
+        if not files:
+            raise ValueError(f"No model file found in repo '{repo_id}'")
+        return min(files)[1]
+
+    @classmethod
+    def _find_model_path_from_dir(
+        cls,
+        path: str,
+        filename: Optional[str] = None,
+    ) -> str:
+        path = Path(path).resolve()
+        if filename:
+            file = (path / filename).resolve()
+            if not file.is_file():
+                raise ValueError(f"Model file '{filename}' not found in '{path}'")
+            return str(file)
+
+        files = [
+            (f.stat().st_size, f)
+            for f in path.iterdir()
+            if f.is_file() and (f.name.endswith(".bin") or f.name.endswith(".gguf"))
+        ]
+        if not files:
+            raise ValueError(f"No model file found in directory '{path}'")
+        file = min(files)[1]
+        return str(file.resolve())
+
+
+class AutoTokenizer:
+    @classmethod
+    def from_pretrained(cls, model):
+        from .transformers import CTransformersModel, CTransformersTokenizer
+
+        if not isinstance(model, CTransformersModel):
+            raise TypeError(
+                f"Currently `AutoTokenizer.from_pretrained` only accepts a model object. Please use:\n\n"
+                "  model = AutoModelForCausalLM.from_pretrained(..., hf=True)\n"
+                "  tokenizer = AutoTokenizer.from_pretrained(model)"
+            )
+
+        return CTransformersTokenizer(model._llm)
diff --git a/llm/Lib/site-packages/ctransformers/langchain.py b/llm/Lib/site-packages/ctransformers/langchain.py
new file mode 100644
index 0000000000000000000000000000000000000000..eadb57b94089c2061776514e73fcabb8a3a151fc
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/langchain.py
@@ -0,0 +1,89 @@
+try:
+    from langchain.llms.base import LLM
+except ImportError:
+    raise ImportError(
+        "To use the ctransformers.langchain module, please install the "
+        "`langchain` python package: `pip install langchain`"
+    )
+
+from typing import Any, Dict, Optional, Sequence
+
+from pydantic import root_validator
+from langchain.callbacks.manager import CallbackManagerForLLMRun
+
+from ctransformers import AutoModelForCausalLM
+
+
+class CTransformers(LLM):
+    """Wrapper around the C Transformers LLM interface.
+
+    To use, you should have the `langchain` python package installed.
+    """
+
+    client: Any  #: :meta private:
+
+    model: str
+    """The path to a model file or directory or the name of a Hugging Face Hub
+    model repo."""
+
+    model_type: Optional[str] = None
+    """The model type."""
+
+    model_file: Optional[str] = None
+    """The name of the model file in repo or directory."""
+
+    config: Optional[Dict[str, Any]] = None
+    """The config parameters."""
+
+    lib: Optional[Any] = None
+    """The path to a shared library or one of `avx2`, `avx`, `basic`."""
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model": self.model,
+            "model_type": self.model_type,
+            "model_file": self.model_file,
+            "config": self.config,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "ctransformers"
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate and load model from a local file or remote repo."""
+        config = values["config"] or {}
+        values["client"] = AutoModelForCausalLM.from_pretrained(
+            values["model"],
+            model_type=values["model_type"],
+            model_file=values["model_file"],
+            lib=values["lib"],
+            **config,
+        )
+        return values
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[Sequence[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+    ) -> str:
+        """Generate text from a prompt.
+
+        Args:
+            prompt: The prompt to generate text from.
+            stop: A list of sequences to stop generation when encountered.
+
+        Returns:
+            The generated text.
+        """
+        text = []
+        for chunk in self.client(prompt, stop=stop, stream=True):
+            text.append(chunk)
+            if run_manager:
+                run_manager.on_llm_new_token(chunk, verbose=self.verbose)
+        return "".join(text)
diff --git a/llm/Lib/site-packages/ctransformers/lib.py b/llm/Lib/site-packages/ctransformers/lib.py
new file mode 100644
index 0000000000000000000000000000000000000000..0b85d5a414b448cba4203297ce0a70e7a880f2e0
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/lib.py
@@ -0,0 +1,99 @@
+import platform
+from ctypes import CDLL
+from typing import List, Optional
+from pathlib import Path
+
+from .logger import logger
+
+
+def find_library(path: Optional[str] = None, gpu: bool = False) -> str:
+    lib_directory = Path(__file__).parent.resolve() / "lib"
+
+    if path:
+        subdirs = [d.name for d in lib_directory.iterdir() if d.is_dir()]
+        if path not in subdirs:
+            return path
+
+    system = platform.system()
+    metal = gpu and system == "Darwin"
+    cuda = gpu and not metal
+    if not path:
+        if (lib_directory / "local").is_dir():
+            path = "local"
+        elif cuda:
+            path = "cuda"
+        elif metal:
+            path = "metal"
+        elif platform.processor() == "arm":
+            # Apple silicon doesn't support AVX/AVX2.
+            path = "basic" if system == "Darwin" else ""
+        else:
+            from cpuinfo import get_cpu_info
+
+            try:
+                flags = get_cpu_info()["flags"]
+            except:
+                logger.warning(
+                    "Unable to detect CPU features. "
+                    "Please report at https://github.com/marella/ctransformers/issues"
+                )
+                flags = []
+
+            if "avx2" in flags:
+                path = "avx2"
+            elif "avx" in flags and "f16c" in flags:
+                path = "avx"
+            else:
+                path = "basic"
+
+    name = "ctransformers"
+    if system == "Linux":
+        name = f"lib{name}.so"
+    elif system == "Windows":
+        name = f"{name}.dll"
+    elif system == "Darwin":
+        name = f"lib{name}.dylib"
+    else:
+        name = ""
+
+    path = lib_directory / path / name
+    if not path.is_file():
+        if cuda:
+            env = "CT_CUBLAS=1 "
+        elif metal:
+            env = "CT_METAL=1 "
+        else:
+            env = ""
+        raise OSError(
+            "Precompiled binaries are not available for the current platform. "
+            "Please reinstall from source using:\n\n"
+            "  pip uninstall ctransformers --yes\n"
+            f"  {env}pip install ctransformers --no-binary ctransformers\n\n"
+        )
+    return str(path)
+
+
+def load_cuda() -> bool:
+    try:
+        import nvidia
+    except ImportError:
+        return False
+    path = Path(nvidia.__path__[0])
+    system = platform.system()
+    if system == "Windows":
+        libs = [
+            path / "cuda_runtime" / "bin" / "cudart64_12.dll",
+            path / "cublas" / "bin" / "cublas64_12.dll",
+        ]
+    else:
+        libs = [
+            path / "cuda_runtime" / "lib" / "libcudart.so.12",
+            path / "cublas" / "lib" / "libcublas.so.12",
+        ]
+    for lib in libs:
+        if not lib.is_file():
+            return False
+    libs = [str(lib.resolve()) for lib in libs]
+    for lib in libs:
+        CDLL(lib)
+    return True
diff --git a/llm/Lib/site-packages/ctransformers/lib/avx/ctransformers.dll b/llm/Lib/site-packages/ctransformers/lib/avx/ctransformers.dll
new file mode 100644
index 0000000000000000000000000000000000000000..f93b8b0ac192ea6adf2cbaea9df0221b696d6688
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/lib/avx/ctransformers.dll
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8a407138763ea29eac0ce5d341cf5d8aff1d36a02429353f34510a710d7c0ed4
+size 1282048
diff --git a/llm/Lib/site-packages/ctransformers/lib/avx/libctransformers.dylib b/llm/Lib/site-packages/ctransformers/lib/avx/libctransformers.dylib
new file mode 100644
index 0000000000000000000000000000000000000000..22e9db21772bd5e5c595fb0fced2e79fd61598b6
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/lib/avx/libctransformers.dylib
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1e8db14c2858a877e8a883529e94428c9fc2594e3d79c2f2f2def8a841915199
+size 1330880
diff --git a/llm/Lib/site-packages/ctransformers/lib/avx/libctransformers.so b/llm/Lib/site-packages/ctransformers/lib/avx/libctransformers.so
new file mode 100644
index 0000000000000000000000000000000000000000..a438fc0c10ffce3da256863d9168a1a4f977deae
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/lib/avx/libctransformers.so
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:577a3d4ef00395cd89b19a26495ed929f1ed0366159cfca6d134532ef8af2b2c
+size 1519272
diff --git a/llm/Lib/site-packages/ctransformers/lib/avx2/ctransformers.dll b/llm/Lib/site-packages/ctransformers/lib/avx2/ctransformers.dll
new file mode 100644
index 0000000000000000000000000000000000000000..25aaf4ff7b348c1f56832770e879590b4e782cef
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/lib/avx2/ctransformers.dll
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:866216b4df15122f28fd32cf63b9be12c321fbc5d8bfd9d69b5393687120f973
+size 1263104
diff --git a/llm/Lib/site-packages/ctransformers/lib/avx2/libctransformers.dylib b/llm/Lib/site-packages/ctransformers/lib/avx2/libctransformers.dylib
new file mode 100644
index 0000000000000000000000000000000000000000..69c564afa7a0590cdad92e9a5992598f3e2a4421
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/lib/avx2/libctransformers.dylib
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:33dc59b8fc475f97049219307c6f8a51bf2c1b89e8600843c45491f431e607c6
+size 1330880
diff --git a/llm/Lib/site-packages/ctransformers/lib/avx2/libctransformers.so b/llm/Lib/site-packages/ctransformers/lib/avx2/libctransformers.so
new file mode 100644
index 0000000000000000000000000000000000000000..8db754c51aba45c860947a3a5192576880b89423
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/lib/avx2/libctransformers.so
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:09b2621fc1805c012f25fdb8e68f784e4bfa91d4e25a560b9c4e60dfa8ff7bd5
+size 1523368
diff --git a/llm/Lib/site-packages/ctransformers/lib/basic/ctransformers.dll b/llm/Lib/site-packages/ctransformers/lib/basic/ctransformers.dll
new file mode 100644
index 0000000000000000000000000000000000000000..81d87fbeeec9d969987a2ec32eaa0b13d34585e4
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/lib/basic/ctransformers.dll
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:82eb53616d42bcc0c3cb1057d8801e09806e6e3d18c418b2e93b10556b467781
+size 1288192
diff --git a/llm/Lib/site-packages/ctransformers/lib/basic/libctransformers.dylib b/llm/Lib/site-packages/ctransformers/lib/basic/libctransformers.dylib
new file mode 100644
index 0000000000000000000000000000000000000000..94cc24519b45e2cc8f0059aa20009b4cdd2f0961
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/lib/basic/libctransformers.dylib
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f38599afe9a6896aea7e637ad45951a175ec7a4f653996621f52e13cdfa7e868
+size 2525123
diff --git a/llm/Lib/site-packages/ctransformers/lib/basic/libctransformers.so b/llm/Lib/site-packages/ctransformers/lib/basic/libctransformers.so
new file mode 100644
index 0000000000000000000000000000000000000000..65bb7dae6e32d1a14d88813f561656f0e5ae19f1
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/lib/basic/libctransformers.so
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:892698917ed89207bbb57f7fcd62b8ee0731ebd5b38ac96ad5302f3884d9f748
+size 1482416
diff --git a/llm/Lib/site-packages/ctransformers/lib/cuda/ctransformers.dll b/llm/Lib/site-packages/ctransformers/lib/cuda/ctransformers.dll
new file mode 100644
index 0000000000000000000000000000000000000000..66d523423e0615c351f2f2f101c5696543bed7b7
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/lib/cuda/ctransformers.dll
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:85c907a50ff3a5bb3dd33d01d78ea746961e381ff2c2b0056dca7ea50201ff7e
+size 5395968
diff --git a/llm/Lib/site-packages/ctransformers/lib/cuda/libctransformers.so b/llm/Lib/site-packages/ctransformers/lib/cuda/libctransformers.so
new file mode 100644
index 0000000000000000000000000000000000000000..0351fa144b8b2465639aca2346ba2fb1641fda5d
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/lib/cuda/libctransformers.so
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:dad05240fd899d366ee892538cc41eb2cbe03d76b65b5c71cac3af177f535909
+size 5691856
diff --git a/llm/Lib/site-packages/ctransformers/llm.py b/llm/Lib/site-packages/ctransformers/llm.py
new file mode 100644
index 0000000000000000000000000000000000000000..90cdfe20ee530affbc29c0ad4923bf5a637b5b0b
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/llm.py
@@ -0,0 +1,689 @@
+import inspect
+import os
+import re
+import warnings
+from collections import OrderedDict
+from dataclasses import dataclass
+from functools import partial
+from pathlib import Path
+from ctypes import (
+    CDLL,
+    c_bool,
+    c_int,
+    c_float,
+    c_char_p,
+    c_void_p,
+    POINTER,
+    Structure,
+)
+from typing import (
+    Any,
+    Callable,
+    Generator,
+    List,
+    Optional,
+    Sequence,
+    Union,
+)
+
+from .lib import find_library, load_cuda
+from .logger import logger
+from .utils import is_gguf, Vector, utf8_split_incomplete
+
+c_int_p = POINTER(c_int)
+c_float_p = POINTER(c_float)
+llm_p = c_void_p
+
+
+@dataclass
+class Config:
+    # sample
+    top_k: int = 40
+    top_p: float = 0.95
+    temperature: float = 0.8
+    repetition_penalty: float = 1.1
+    last_n_tokens: int = 64
+    seed: int = -1
+
+    # eval
+    batch_size: int = 8
+    threads: int = -1
+
+    # generate
+    max_new_tokens: int = 256
+    stop: Optional[Sequence[str]] = None
+    stream: bool = False
+    reset: bool = True
+
+    # model
+    context_length: int = -1
+    gpu_layers: int = 0
+    mmap: bool = True
+    mlock: bool = False
+
+    def to_struct(self):
+        return ConfigStruct(
+            context_length=self.context_length,
+            gpu_layers=self.gpu_layers,
+            mmap=self.mmap,
+            mlock=self.mlock,
+        )
+
+
+class ConfigStruct(Structure):
+    _fields_ = [
+        ("context_length", c_int),
+        ("gpu_layers", c_int),
+        ("mmap", c_bool),
+        ("mlock", c_bool),
+    ]
+
+
+docs = OrderedDict(
+    top_k="The top-k value to use for sampling.",
+    top_p="The top-p value to use for sampling.",
+    temperature="The temperature to use for sampling.",
+    repetition_penalty="The repetition penalty to use for sampling.",
+    last_n_tokens="The number of last tokens to use for repetition penalty.",
+    seed="The seed value to use for sampling tokens.",
+    max_new_tokens="The maximum number of new tokens to generate.",
+    stop="A list of sequences to stop generation when encountered.",
+    stream="Whether to stream the generated text.",
+    reset="Whether to reset the model state before generating text.",
+    batch_size="The batch size to use for evaluating tokens in a single prompt.",
+    threads="The number of threads to use for evaluating tokens.",
+    context_length="The maximum context length to use.",
+    gpu_layers="The number of layers to run on GPU.",
+)
+
+
+def doc(fn):
+    doc = []
+    for param in inspect.signature(fn).parameters:
+        if param in docs:
+            default = getattr(Config, param)
+            doc.append(f"{param}: {docs[param]} Default: `{default}`")
+    doc = ("\n" + " " * 12).join(doc)
+    fn.__doc__ = fn.__doc__.format(params=doc)
+    return fn
+
+
+def get(*values):
+    for value in values:
+        if value is not None:
+            return value
+
+
+def load_library(path: Optional[str] = None, gpu: bool = False) -> Any:
+    # https://docs.python.org/3.8/whatsnew/3.8.html#bpo-36085-whatsnew
+    # https://github.com/abetlen/llama-cpp-python/pull/225
+    if hasattr(os, "add_dll_directory") and "CUDA_PATH" in os.environ:
+        os.add_dll_directory(os.path.join(os.environ["CUDA_PATH"], "bin"))
+
+    path = find_library(path, gpu=gpu)
+    if "cuda" in path:
+        load_cuda()
+    lib = CDLL(path)
+
+    lib.ctransformers_llm_create.argtypes = [
+        c_char_p,  # model_path
+        c_char_p,  # model_type
+        ConfigStruct,  # config
+    ]
+    lib.ctransformers_llm_create.restype = llm_p
+
+    lib.ctransformers_llm_delete.argtypes = [llm_p]
+    lib.ctransformers_llm_delete.restype = None
+
+    lib.ctransformers_llm_tokenize.argtypes = [
+        llm_p,
+        c_char_p,  # text
+        c_bool,  # add_bos_token
+        c_int_p,  # output
+    ]
+    lib.ctransformers_llm_tokenize.restype = c_int
+
+    lib.ctransformers_llm_detokenize.argtypes = [
+        llm_p,
+        c_int,  # token
+    ]
+    lib.ctransformers_llm_detokenize.restype = c_char_p
+
+    lib.ctransformers_llm_is_eos_token.argtypes = [
+        llm_p,
+        c_int,  # token
+    ]
+    lib.ctransformers_llm_is_eos_token.restype = c_bool
+
+    lib.ctransformers_llm_eos_token_id.argtypes = [llm_p]
+    lib.ctransformers_llm_eos_token_id.restype = c_int
+
+    lib.ctransformers_llm_bos_token_id.argtypes = [llm_p]
+    lib.ctransformers_llm_bos_token_id.restype = c_int
+
+    lib.ctransformers_llm_vocab_size.argtypes = [llm_p]
+    lib.ctransformers_llm_vocab_size.restype = c_int
+
+    lib.ctransformers_llm_context_length.argtypes = [llm_p]
+    lib.ctransformers_llm_context_length.restype = c_int
+
+    lib.ctransformers_llm_architecture.argtypes = [llm_p]
+    lib.ctransformers_llm_architecture.restype = c_char_p
+
+    lib.ctransformers_llm_batch_eval.argtypes = [
+        llm_p,
+        c_int_p,  # tokens
+        c_int,  # n_tokens
+        c_int,  # n_past
+        c_int,  # batch_size
+        c_int,  # threads
+    ]
+    lib.ctransformers_llm_batch_eval.restype = c_bool
+
+    lib.ctransformers_llm_logits_data.argtypes = [llm_p]
+    lib.ctransformers_llm_logits_data.restype = c_float_p
+    lib.ctransformers_llm_logits_size.argtypes = [llm_p]
+    lib.ctransformers_llm_logits_size.restype = c_int
+
+    lib.ctransformers_llm_embeddings_data.argtypes = [llm_p]
+    lib.ctransformers_llm_embeddings_data.restype = c_float_p
+    lib.ctransformers_llm_embeddings_size.argtypes = [llm_p]
+    lib.ctransformers_llm_embeddings_size.restype = c_int
+
+    lib.ctransformers_llm_sample.argtypes = [
+        llm_p,
+        c_int_p,  # last_tokens
+        c_int,  # n_last
+        c_int,  # top_k
+        c_float,  # top_p
+        c_float,  # temperature
+        c_float,  # repetition_penalty
+        c_int,  # seed
+    ]
+    lib.ctransformers_llm_sample.restype = c_int
+
+    lib.ctransformers_llm_reset.argtypes = [llm_p]
+    lib.ctransformers_llm_reset.restype = None
+
+    return lib
+
+
+class LLM:
+    def __init__(
+        self,
+        model_path: str,
+        model_type: Optional[str] = None,
+        *,
+        config: Optional[Config] = None,
+        lib: Optional[str] = None,
+    ):
+        """Loads the language model from a local file.
+
+        Args:
+            model_path: The path to a model file.
+            model_type: The model type.
+            config: `Config` object.
+            lib: The path to a shared library or one of `avx2`, `avx`, `basic`.
+        """
+        config = config or Config()
+        self._model_path = model_path
+        self._config = config
+        self._llm = None
+        self._lib = None
+        self._context = []
+
+        if not Path(model_path).is_file():
+            raise ValueError(f"Model path '{model_path}' doesn't exist.")
+
+        if not model_type:
+            if not is_gguf(model_path):
+                raise ValueError(
+                    "Unable to detect model type. Please specify a model type using:\n\n"
+                    "  AutoModelForCausalLM.from_pretrained(..., model_type='...')\n\n"
+                )
+            model_type = "gguf"
+
+        self._lib = load_library(lib, gpu=config.gpu_layers > 0)
+        self._llm = self._lib.ctransformers_llm_create(
+            model_path.encode(),
+            model_type.encode(),
+            config.to_struct(),
+        )
+        if self._llm is None:
+            raise RuntimeError(
+                f"Failed to create LLM '{model_type}' from '{model_path}'."
+            )
+        architecture = self.ctransformers_llm_architecture().decode()
+        if architecture:
+            model_type = architecture
+        self._model_type = model_type
+
+    @property
+    def model_path(self) -> str:
+        """The path to the model file."""
+        return self._model_path
+
+    @property
+    def model_type(self) -> str:
+        """The model type."""
+        return self._model_type
+
+    @property
+    def config(self) -> Config:
+        """The config object."""
+        return self._config
+
+    @property
+    def eos_token_id(self) -> int:
+        """The end-of-sequence token."""
+        return self.ctransformers_llm_eos_token_id()
+
+    @property
+    def bos_token_id(self) -> int:
+        """The beginning-of-sequence token."""
+        return self.ctransformers_llm_bos_token_id()
+
+    @property
+    def pad_token_id(self) -> int:
+        """The padding token."""
+        return self.ctransformers_llm_eos_token_id()
+
+    @property
+    def vocab_size(self) -> int:
+        """The number of tokens in vocabulary."""
+        return self.ctransformers_llm_vocab_size()
+
+    @property
+    def context_length(self) -> int:
+        """The context length of model."""
+        return self.ctransformers_llm_context_length()
+
+    @property
+    def logits(self) -> List[float]:
+        """The unnormalized log probabilities."""
+        return Vector(
+            self.ctransformers_llm_logits_data(),
+            self.ctransformers_llm_logits_size(),
+        )
+
+    @property
+    def embeddings(self) -> List[float]:
+        """The input embeddings."""
+        return Vector(
+            self.ctransformers_llm_embeddings_data(),
+            self.ctransformers_llm_embeddings_size(),
+        )
+
+    def __getattr__(self, name: str) -> Callable:
+        lib, llm = self._lib, self._llm
+        if name.startswith("ctransformers_llm_") and hasattr(lib, name):
+            return partial(getattr(lib, name), llm)
+        raise AttributeError(f"'LLM' object has no attribute '{name}'")
+
+    def tokenize(self, text: str, add_bos_token: Optional[bool] = None) -> List[int]:
+        """Converts a text into list of tokens.
+
+        Args:
+            text: The text to tokenize.
+            add_bos_token: Whether to add the beginning-of-sequence token.
+
+        Returns:
+            The list of tokens.
+        """
+        if add_bos_token is None:
+            add_bos_token = self.model_type == "llama"
+        tokens = (c_int * (len(text) + 1))()
+        n_tokens = self.ctransformers_llm_tokenize(text.encode(), add_bos_token, tokens)
+        return tokens[:n_tokens]
+
+    def detokenize(
+        self,
+        tokens: Sequence[int],
+        decode: bool = True,
+    ) -> Union[str, bytes]:
+        """Converts a list of tokens to text.
+
+        Args:
+            tokens: The list of tokens.
+            decode: Whether to decode the text as UTF-8 string.
+
+        Returns:
+            The combined text of all tokens.
+        """
+        if isinstance(tokens, int):
+            tokens = [tokens]
+        texts = []
+        for token in tokens:
+            text = self.ctransformers_llm_detokenize(token)
+            texts.append(text)
+        texts = b"".join(texts)
+        if decode:
+            texts = texts.decode(errors="ignore")
+            # https://github.com/ggerganov/llama.cpp/blob/43033b7bb4858da4f591715b3babdf906c9b7cbc/common/common.cpp#L778-L781
+            if tokens[:1] == [self.bos_token_id] and texts[:1] == " ":
+                texts = texts[1:]
+        return texts
+
+    def is_eos_token(self, token: int) -> bool:
+        """Checks if a token is an end-of-sequence token.
+
+        Args:
+            token: The token to check.
+
+        Returns:
+            `True` if the token is an end-of-sequence token else `False`.
+        """
+        return self.ctransformers_llm_is_eos_token(token)
+
+    @doc
+    def eval(
+        self,
+        tokens: Sequence[int],
+        *,
+        batch_size: Optional[int] = None,
+        threads: Optional[int] = None,
+    ) -> None:
+        """Evaluates a list of tokens.
+
+        Args:
+            tokens: The list of tokens to evaluate.
+            {params}
+        """
+        config = self.config
+        batch_size = get(batch_size, config.batch_size)
+        threads = get(threads, config.threads)
+
+        n_past = len(self._context)
+        n_tokens = len(tokens)
+        if n_past + n_tokens > self.context_length:
+            logger.warning(
+                f"Number of tokens ({n_past + n_tokens}) exceeded maximum context length ({self.context_length})."
+            )
+        tokens = (c_int * n_tokens)(*tokens)
+        status = self.ctransformers_llm_batch_eval(
+            tokens,
+            n_tokens,
+            n_past,
+            batch_size,
+            threads,
+        )
+        if not status:
+            raise RuntimeError("Failed to evaluate tokens.")
+        self._context.extend(tokens)
+
+    @doc
+    def sample(
+        self,
+        *,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        temperature: Optional[float] = None,
+        repetition_penalty: Optional[float] = None,
+        last_n_tokens: Optional[int] = None,
+        seed: Optional[int] = None,
+    ) -> int:
+        """Samples a token from the model.
+
+        Args:
+            {params}
+
+        Returns:
+            The sampled token.
+        """
+        config = self.config
+        top_k = get(top_k, config.top_k)
+        top_p = get(top_p, config.top_p)
+        temperature = get(temperature, config.temperature)
+        repetition_penalty = get(repetition_penalty, config.repetition_penalty)
+        last_n_tokens = get(last_n_tokens, config.last_n_tokens)
+        seed = get(seed, config.seed)
+
+        if last_n_tokens < 0:
+            last_n_tokens = self.context_length
+        last_tokens = self._context[-last_n_tokens:]
+        n_last = len(last_tokens)
+        last_tokens = (c_int * n_last)(*last_tokens)
+
+        return self.ctransformers_llm_sample(
+            last_tokens,
+            n_last,
+            top_k,
+            top_p,
+            temperature,
+            repetition_penalty,
+            seed,
+        )
+
+    def reset(self) -> None:
+        """Deprecated since 0.2.27."""
+        warnings.warn(
+            "`LLM.reset()` method is deprecated since 0.2.27. Please use high-level API."
+        )
+        self._context.clear()
+        self.ctransformers_llm_reset()
+
+    def __del__(self):
+        if self._llm is not None:
+            self.ctransformers_llm_delete()
+
+    @doc
+    def prepare_inputs_for_generation(
+        self,
+        tokens: Sequence[int],
+        *,
+        reset: Optional[bool] = None,
+    ) -> Sequence[int]:
+        """Removes input tokens that are evaluated in the past and updates the LLM context.
+
+        Args:
+            tokens: The list of input tokens.
+            {params}
+
+        Returns:
+            The list of tokens to evaluate.
+        """
+        config = self.config
+        reset = get(reset, config.reset)
+
+        if not reset:
+            return tokens
+
+        # Keep at least one input token to evaluate the logits.
+        n = min(len(tokens) - 1, len(self._context))
+        l = 0
+        while l < n and tokens[l] == self._context[l]:
+            l += 1
+        # Remove input tokens that are evaluated in the past and update context.
+        tokens = tokens[l:]
+        self._context = self._context[:l]
+
+        return tokens
+
+    @doc
+    def generate(
+        self,
+        tokens: Sequence[int],
+        *,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        temperature: Optional[float] = None,
+        repetition_penalty: Optional[float] = None,
+        last_n_tokens: Optional[int] = None,
+        seed: Optional[int] = None,
+        batch_size: Optional[int] = None,
+        threads: Optional[int] = None,
+        reset: Optional[bool] = None,
+    ) -> Generator[int, None, None]:
+        """Generates new tokens from a list of tokens.
+
+        Args:
+            tokens: The list of tokens to generate tokens from.
+            {params}
+
+        Returns:
+            The generated tokens.
+        """
+        tokens = self.prepare_inputs_for_generation(tokens, reset=reset)
+        self.eval(tokens, batch_size=batch_size, threads=threads)
+        while True:
+            token = self.sample(
+                top_k=top_k,
+                top_p=top_p,
+                temperature=temperature,
+                repetition_penalty=repetition_penalty,
+                last_n_tokens=last_n_tokens,
+                seed=seed,
+            )
+            self.eval([token], batch_size=batch_size, threads=threads)
+            if self.is_eos_token(token):
+                break
+            yield token
+
+    def _stream(
+        self,
+        prompt: str,
+        *,
+        max_new_tokens: Optional[int] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        temperature: Optional[float] = None,
+        repetition_penalty: Optional[float] = None,
+        last_n_tokens: Optional[int] = None,
+        seed: Optional[int] = None,
+        batch_size: Optional[int] = None,
+        threads: Optional[int] = None,
+        stop: Optional[Sequence[str]] = None,
+        reset: Optional[bool] = None,
+    ) -> Generator[str, None, None]:
+        config = self.config
+        max_new_tokens = get(max_new_tokens, config.max_new_tokens)
+        stop = get(stop, config.stop) or []
+        if isinstance(stop, str):
+            stop = [stop]
+
+        tokens = self.tokenize(prompt)
+
+        stop_regex = re.compile("|".join(map(re.escape, stop)))
+        count = 0
+        text = ""
+        incomplete = b""
+        for token in self.generate(
+            tokens,
+            top_k=top_k,
+            top_p=top_p,
+            temperature=temperature,
+            repetition_penalty=repetition_penalty,
+            last_n_tokens=last_n_tokens,
+            seed=seed,
+            batch_size=batch_size,
+            threads=threads,
+            reset=reset,
+        ):
+            # Handle incomplete UTF-8 multi-byte characters.
+            incomplete += self.detokenize([token], decode=False)
+            complete, incomplete = utf8_split_incomplete(incomplete)
+            text += complete.decode(errors="ignore")
+
+            # https://github.com/abetlen/llama-cpp-python/blob/1a13d76c487df1c8560132d10bda62d6e2f4fa93/llama_cpp/llama.py#L686-L706
+            # Check if one of the stop sequences is part of the text.
+            # Note that the stop sequence may not always be at the end of text.
+            if stop:
+                match = stop_regex.search(text)
+                if match:
+                    text = text[: match.start()]
+                    break
+
+            # Avoid sending the longest suffix of text which is also a prefix
+            # of a stop sequence, as it can form a stop sequence with the text
+            # generated later.
+            longest = 0
+            for s in stop:
+                for i in range(len(s), 0, -1):
+                    if text.endswith(s[:i]):
+                        longest = max(i, longest)
+                        break
+
+            end = len(text) - longest
+            if end > 0:
+                yield text[:end]
+                text = text[end:]
+
+            count += 1
+            if count >= max_new_tokens:
+                break
+
+        if text:
+            yield text
+
+    @doc
+    def __call__(
+        self,
+        prompt: str,
+        *,
+        max_new_tokens: Optional[int] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        temperature: Optional[float] = None,
+        repetition_penalty: Optional[float] = None,
+        last_n_tokens: Optional[int] = None,
+        seed: Optional[int] = None,
+        batch_size: Optional[int] = None,
+        threads: Optional[int] = None,
+        stop: Optional[Sequence[str]] = None,
+        stream: Optional[bool] = None,
+        reset: Optional[bool] = None,
+    ) -> Union[str, Generator[str, None, None]]:
+        """Generates text from a prompt.
+
+        Args:
+            prompt: The prompt to generate text from.
+            {params}
+
+        Returns:
+            The generated text.
+        """
+        config = self.config
+        stream = get(stream, config.stream)
+
+        text = self._stream(
+            prompt,
+            max_new_tokens=max_new_tokens,
+            top_k=top_k,
+            top_p=top_p,
+            temperature=temperature,
+            repetition_penalty=repetition_penalty,
+            last_n_tokens=last_n_tokens,
+            seed=seed,
+            batch_size=batch_size,
+            threads=threads,
+            stop=stop,
+            reset=reset,
+        )
+        if stream:
+            return text
+        return "".join(text)
+
+    @doc
+    def embed(
+        self,
+        input: Union[str, Sequence[int]],
+        *,
+        batch_size: Optional[int] = None,
+        threads: Optional[int] = None,
+    ) -> List[float]:
+        """Computes embeddings for a text or list of tokens.
+
+        > **Note:** Currently only LLaMA and Falcon models support embeddings.
+
+        Args:
+            input: The input text or list of tokens to get embeddings for.
+            {params}
+
+        Returns:
+            The input embeddings.
+        """
+        if isinstance(input, str):
+            input = self.tokenize(input)
+        input = self.prepare_inputs_for_generation(input, reset=True)
+        self.eval(input, batch_size=batch_size, threads=threads)
+        return list(self.embeddings)
diff --git a/llm/Lib/site-packages/ctransformers/logger.py b/llm/Lib/site-packages/ctransformers/logger.py
new file mode 100644
index 0000000000000000000000000000000000000000..8fb415f165c394e07067e0390ffeec4e40df5d60
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/logger.py
@@ -0,0 +1,3 @@
+import logging
+
+logger = logging.getLogger("ctransformers")
diff --git a/llm/Lib/site-packages/ctransformers/transformers.py b/llm/Lib/site-packages/ctransformers/transformers.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd9d0e6b1ceb5a09006a9ca52de036a84c0276ad
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/transformers.py
@@ -0,0 +1,160 @@
+try:
+    import torch
+except ImportError:
+    raise ImportError(
+        "Could not import `torch` package. "
+        "Please install it using: pip install transformers[torch]"
+    )
+
+try:
+    import transformers
+except ImportError:
+    raise ImportError(
+        "Could not import `transformers` package. "
+        "Please install it using: pip install transformers"
+    )
+
+from typing import Any, Dict, List, Optional, Tuple, Union
+
+from transformers import (
+    BatchEncoding,
+    PretrainedConfig,
+    PreTrainedModel,
+    PreTrainedTokenizer,
+    TensorType,
+    MODEL_FOR_CAUSAL_LM_MAPPING,
+)
+from transformers.modeling_outputs import CausalLMOutput
+
+from .llm import LLM
+
+
+class CTransformersConfig(PretrainedConfig):
+    pass
+
+
+class CTransformersModel(PreTrainedModel):
+    def __init__(self, config: PretrainedConfig, llm: LLM):
+        for name in [
+            "vocab_size",
+            "bos_token_id",
+            "eos_token_id",
+            "pad_token_id",
+        ]:
+            if getattr(config, name, None) is None:
+                value = getattr(llm, name, None)
+                setattr(config, name, value)
+        super().__init__(config)
+        self._llm = llm
+        MODEL_FOR_CAUSAL_LM_MAPPING.register("ctransformers", CTransformersModel)
+
+    @property
+    def device(self) -> torch.device:
+        return torch.device("cpu")
+
+    def prepare_inputs_for_generation(
+        self,
+        input_ids: torch.LongTensor,
+        attention_mask: Optional[torch.FloatTensor] = None,
+        **kwargs,
+    ) -> Dict[str, Any]:
+        return {"input_ids": input_ids}
+
+    def forward(
+        self,
+        input_ids: Optional[torch.LongTensor] = None,
+        return_dict: Optional[bool] = None,
+        **kwargs,
+    ) -> Union[Tuple, CausalLMOutput]:
+        llm = self._llm
+        logits = []
+        for tokens in input_ids:
+            tokens = tokens.tolist()
+            tokens = llm.prepare_inputs_for_generation(tokens)
+            llm.eval(tokens)
+            logits.append(torch.tensor(llm.logits).reshape([1, -1]))
+        logits = torch.stack(logits)
+        if not return_dict:
+            return (logits,)
+        return CausalLMOutput(logits=logits)
+
+
+class CTransformersTokenizer(PreTrainedTokenizer):
+    def __init__(self, llm: LLM, **kwargs):
+        super().__init__(**kwargs)
+        self._llm = llm
+
+    @property
+    def vocab_size(self) -> int:
+        return self._llm.vocab_size
+
+    @property
+    def bos_token_id(self) -> int:
+        return self._llm.bos_token_id
+
+    @property
+    def bos_token(self) -> str:
+        return self._llm.detokenize(self._llm.bos_token_id) or "<s>"
+
+    @property
+    def eos_token_id(self) -> int:
+        return self._llm.eos_token_id
+
+    @property
+    def eos_token(self) -> str:
+        return self._llm.detokenize(self._llm.eos_token_id) or "</s>"
+
+    @property
+    def pad_token_id(self) -> int:
+        return self._llm.pad_token_id
+
+    @property
+    def pad_token(self) -> str:
+        return self._llm.detokenize(self._llm.pad_token_id) or "</s>"
+
+    @property
+    def all_special_ids(self) -> List[int]:
+        return [self.eos_token_id]
+
+    def _encode_plus(
+        self,
+        text: Union[str, List[int]],
+        return_tensors: Optional[Union[str, TensorType]] = None,
+        **kwargs,
+    ) -> BatchEncoding:
+        if isinstance(text, str):
+            input_ids = self._llm.tokenize(text)
+        elif (
+            isinstance(text, (list, tuple))
+            and len(text) > 0
+            and isinstance(text[0], int)
+        ):
+            input_ids = text
+        else:
+            raise ValueError(
+                f"Input {text} is not valid. Should be a string or a list/tuple of integers."
+            )
+        return self.prepare_for_model(
+            input_ids,
+            return_tensors=return_tensors,
+            prepend_batch_axis=True,
+        )
+
+    def _decode(
+        self,
+        token_ids: List[int],
+        skip_special_tokens: bool = False,
+        **kwargs,
+    ) -> str:
+        if skip_special_tokens:
+            token_ids = [id for id in token_ids if id not in self.all_special_ids]
+        return self._llm.detokenize(token_ids)
+
+    def _convert_token_to_id(self, token: str) -> int:
+        return self._llm.tokenize(token, add_bos_token=False)[0]
+
+    def _convert_id_to_token(self, index: int) -> str:
+        return self._llm.detokenize(index)
+
+    def convert_tokens_to_string(self, tokens: List[str]) -> str:
+        return "".join(tokens)
diff --git a/llm/Lib/site-packages/ctransformers/utils.py b/llm/Lib/site-packages/ctransformers/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed6f9976308d5cc2dd3b9e351576b6f4d844db19
--- /dev/null
+++ b/llm/Lib/site-packages/ctransformers/utils.py
@@ -0,0 +1,56 @@
+from collections.abc import MutableSequence
+from pathlib import Path
+from typing import Any, Tuple, Union
+
+
+def is_gguf(path: Union[str, Path]) -> bool:
+    path = str(Path(path).resolve())
+    with open(path, "rb") as f:
+        magic = f.read(4)
+    return magic == "GGUF".encode()
+
+
+class Vector(MutableSequence):
+    """Provides a Python list-like interface for a C array to access and modify
+    data in-place without copying the entire data between C and Python.
+    """
+
+    def __init__(self, data: Any, size: int):
+        self._data = data
+        self._size = size
+
+    def __getitem__(self, index: int) -> Any:
+        self._validate_index(index)
+        return self._data[index]
+
+    def __setitem__(self, index: int, value: Any) -> None:
+        self._validate_index(index)
+        self._data[index] = value
+
+    def __len__(self) -> int:
+        return self._size
+
+    def _validate_index(self, index: int) -> None:
+        if not isinstance(index, int):
+            raise TypeError("list index must be integer")
+        if not 0 <= index < self._size:
+            raise IndexError("list index out of range")
+
+    def __delitem__(self, index: int) -> None:
+        raise NotImplementedError("This operation is not allowed.")
+
+    def insert(self, index: int, value: Any) -> None:
+        raise NotImplementedError("This operation is not allowed.")
+
+
+def utf8_is_continuation_byte(byte: int) -> bool:
+    """Checks if a byte is a UTF-8 continuation byte (most significant bit is 1)."""
+    return (byte & 0b10000000) != 0
+
+
+def utf8_split_incomplete(seq: bytes) -> Tuple[bytes, bytes]:
+    """Splits a sequence of UTF-8 encoded bytes into complete and incomplete bytes."""
+    i = len(seq)
+    while i > 0 and utf8_is_continuation_byte(seq[i - 1]):
+        i -= 1
+    return seq[:i], seq[i:]
diff --git a/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/INSTALLER b/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/LICENSE b/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..b1ec907b50455561f220ac845a69732241fb7218
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Charles Li and contributors
+
+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
+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.
diff --git a/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/METADATA b/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..b69e90aefbf541e838cd759c1b0b04f206f6ad09
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/METADATA
@@ -0,0 +1,731 @@
+Metadata-Version: 2.1
+Name: dataclasses-json
+Version: 0.6.4
+Summary: Easily serialize dataclasses to and from JSON.
+Home-page: https://github.com/lidatong/dataclasses-json
+License: MIT
+Author: Charles Li
+Author-email: charles.dt.li@gmail.com
+Maintainer: Charles Li
+Maintainer-email: charles.dt.li@gmail.com
+Requires-Python: >=3.7,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: marshmallow (>=3.18.0,<4.0.0)
+Requires-Dist: typing-inspect (>=0.4.0,<1)
+Project-URL: Repository, https://github.com/lidatong/dataclasses-json
+Project-URL: changelog, https://github.com/lidatong/dataclasses-json/releases
+Project-URL: documentation, https://lidatong.github.io/dataclasses-json/
+Project-URL: issues, https://github.com/lidatong/dataclasses-json/issues
+Description-Content-Type: text/markdown
+
+# Dataclasses JSON
+
+![](https://github.com/lidatong/dataclasses-json/workflows/dataclasses-json/badge.svg)
+
+This library provides a simple API for encoding and decoding [dataclasses](https://docs.python.org/3/library/dataclasses.html) to and from JSON.
+
+It's very easy to get started.
+
+[README / Documentation website](https://lidatong.github.io/dataclasses-json). Features a navigation bar and search functionality, and should mirror this README exactly -- take a look!
+
+## Quickstart
+
+`pip install dataclasses-json`
+
+```python
+from dataclasses import dataclass
+from dataclasses_json import dataclass_json
+
+
+@dataclass_json
+@dataclass
+class Person:
+    name: str
+
+
+person = Person(name='lidatong')
+person.to_json()  # '{"name": "lidatong"}' <- this is a string
+person.to_dict()  # {'name': 'lidatong'} <- this is a dict
+Person.from_json('{"name": "lidatong"}')  # Person(1)
+Person.from_dict({'name': 'lidatong'})  # Person(1)
+
+# You can also apply _schema validation_ using an alternative API
+# This can be useful for "typed" Python code
+
+Person.from_json('{"name": 42}')  # This is ok. 42 is not a `str`, but
+                                  # dataclass creation does not validate types
+Person.schema().loads('{"name": 42}')  # Error! Raises `ValidationError`
+```
+
+**What if you want to work with camelCase JSON?**
+
+```python
+# same imports as above, with the additional `LetterCase` import
+from dataclasses import dataclass
+from dataclasses_json import dataclass_json, LetterCase
+
+@dataclass_json(letter_case=LetterCase.CAMEL)  # now all fields are encoded/decoded from camelCase
+@dataclass
+class ConfiguredSimpleExample:
+    int_field: int
+
+ConfiguredSimpleExample(1).to_json()  # {"intField": 1}
+ConfiguredSimpleExample.from_json('{"intField": 1}')  # ConfiguredSimpleExample(1)
+```
+
+## Supported types
+
+It's recursive (see caveats below), so you can easily work with nested dataclasses.
+In addition to the supported types in the 
+[py to JSON table](https://docs.python.org/3/library/json.html#py-to-json-table), this library supports the following:
+
+- any arbitrary [Collection](https://docs.python.org/3/library/collections.abc.html#collections.abc.Collection) type is supported.
+[Mapping](https://docs.python.org/3/library/collections.abc.html#collections.abc.Mapping) types are encoded as JSON objects and `str` types as JSON strings. 
+Any other Collection types are encoded into JSON arrays, but decoded into the original collection types.
+
+- [datetime](https://docs.python.org/3/library/datetime.html#available-types) 
+objects. `datetime` objects are encoded to `float` (JSON number) using 
+[timestamp](https://docs.python.org/3/library/datetime.html#datetime.datetime.timestamp).
+As specified in the `datetime` docs, if your `datetime` object is naive, it will 
+assume your system local timezone when calling `.timestamp()`. JSON numbers 
+corresponding to a `datetime` field in your dataclass are decoded 
+into a datetime-aware object, with `tzinfo` set to your system local timezone.
+Thus, if you encode a datetime-naive object, you will decode into a 
+datetime-aware object. This is important, because encoding and decoding won't 
+strictly be inverses. See [this section](#Overriding) if you want to override this default
+behavior (for example, if you want to use ISO).
+
+- [UUID](https://docs.python.org/3/library/uuid.html#uuid.UUID) objects. They 
+are encoded as `str` (JSON string).
+
+- [Decimal](https://docs.python.org/3/library/decimal.html) objects. They are
+also encoded as `str`.
+
+**The [latest release](https://github.com/lidatong/dataclasses-json/releases/latest) is compatible with both Python 3.7 and Python 3.6 (with the dataclasses backport).**
+
+## Usage
+
+#### Approach 1: Class decorator
+
+```python
+from dataclasses import dataclass
+from dataclasses_json import dataclass_json
+
+@dataclass_json
+@dataclass
+class Person:
+    name: str
+
+lidatong = Person('lidatong')
+
+# Encoding to JSON
+lidatong.to_json()  # '{"name": "lidatong"}'
+
+# Decoding from JSON
+Person.from_json('{"name": "lidatong"}')  # Person(name='lidatong')
+```
+
+Note that the `@dataclass_json` decorator must be stacked above the `@dataclass`
+decorator (order matters!)
+
+#### Approach 2: Inherit from a mixin
+
+```python
+from dataclasses import dataclass
+from dataclasses_json import DataClassJsonMixin
+
+@dataclass
+class Person(DataClassJsonMixin):
+    name: str
+
+lidatong = Person('lidatong')
+
+# A different example from Approach 1 above, but usage is the exact same
+assert Person.from_json(lidatong.to_json()) == lidatong
+```
+
+Pick whichever approach suits your taste. Note that there is better support for
+ the mixin approach when using _static analysis_ tools (e.g. linting, typing),
+ but the differences in implementation will be invisible in _runtime_ usage.
+
+## How do I...
+
+
+
+### Use my dataclass with JSON arrays or objects?
+
+```python
+from dataclasses import dataclass
+from dataclasses_json import dataclass_json
+
+@dataclass_json
+@dataclass
+class Person:
+    name: str
+```
+
+**Encode into a JSON array containing instances of my Data Class**
+
+```python
+people_json = [Person('lidatong')]
+Person.schema().dumps(people_json, many=True)  # '[{"name": "lidatong"}]'
+```
+
+**Decode a JSON array containing instances of my Data Class**
+
+```python
+people_json = '[{"name": "lidatong"}]'
+Person.schema().loads(people_json, many=True)  # [Person(name='lidatong')]
+```
+
+**Encode as part of a larger JSON object containing my Data Class (e.g. an HTTP 
+request/response)**
+
+```python
+import json
+
+response_dict = {
+    'response': {
+        'person': Person('lidatong').to_dict()
+    }
+}
+
+response_json = json.dumps(response_dict)
+```
+
+In this case, we do two steps. First, we encode the dataclass into a 
+**python dictionary** rather than a JSON string, using `.to_dict`. 
+
+Second, we leverage the built-in `json.dumps` to serialize our `dataclass` into 
+a JSON string.
+
+**Decode as part of a larger JSON object containing my Data Class (e.g. an HTTP 
+response)**
+
+```python
+import json
+
+response_dict = json.loads('{"response": {"person": {"name": "lidatong"}}}')
+
+person_dict = response_dict['response']
+
+person = Person.from_dict(person_dict)
+```
+
+In a similar vein to encoding above, we leverage the built-in `json` module.
+
+First, call `json.loads` to read the entire JSON object into a 
+dictionary. We then access the key of the value containing the encoded dict of 
+our `Person` that we want to decode (`response_dict['response']`).
+
+Second, we load in the dictionary using `Person.from_dict`.
+
+
+### Encode or decode into Python lists/dictionaries rather than JSON?
+
+This can be by calling `.schema()` and then using the corresponding 
+encoder/decoder methods, ie. `.load(...)`/`.dump(...)`.
+
+**Encode into a single Python dictionary**
+
+```python
+person = Person('lidatong')
+person.to_dict()  # {'name': 'lidatong'}
+```
+
+**Encode into a list of Python dictionaries**
+
+```python
+people = [Person('lidatong')]
+Person.schema().dump(people, many=True)  # [{'name': 'lidatong'}]
+```
+
+**Decode a dictionary into a single dataclass instance**
+
+```python
+person_dict = {'name': 'lidatong'}
+Person.from_dict(person_dict)  # Person(name='lidatong')
+```
+
+**Decode a list of dictionaries into a list of dataclass instances**
+
+```python
+people_dicts = [{"name": "lidatong"}]
+Person.schema().load(people_dicts, many=True)  # [Person(name='lidatong')]
+```
+
+### Encode or decode from camelCase (or kebab-case)?
+
+JSON letter case by convention is camelCase, in Python members are by convention snake_case.
+
+You can configure it to encode/decode from other casing schemes at both the class level and the field level.
+
+```python
+from dataclasses import dataclass, field
+
+from dataclasses_json import LetterCase, config, dataclass_json
+
+
+# changing casing at the class level
+@dataclass_json(letter_case=LetterCase.CAMEL)
+@dataclass
+class Person:
+    given_name: str
+    family_name: str
+    
+Person('Alice', 'Liddell').to_json()  # '{"givenName": "Alice"}'
+Person.from_json('{"givenName": "Alice", "familyName": "Liddell"}')  # Person('Alice', 'Liddell')
+
+# at the field level
+@dataclass_json
+@dataclass
+class Person:
+    given_name: str = field(metadata=config(letter_case=LetterCase.CAMEL))
+    family_name: str
+    
+Person('Alice', 'Liddell').to_json()  # '{"givenName": "Alice"}'
+# notice how the `family_name` field is still snake_case, because it wasn't configured above
+Person.from_json('{"givenName": "Alice", "family_name": "Liddell"}')  # Person('Alice', 'Liddell')
+```
+
+**This library assumes your field follows the Python convention of snake_case naming.**
+If your field is not `snake_case` to begin with and you attempt to parameterize `LetterCase`, 
+the behavior of encoding/decoding is undefined (most likely it will result in subtle bugs).
+
+### Encode or decode using a different name
+
+```python
+from dataclasses import dataclass, field
+
+from dataclasses_json import config, dataclass_json
+
+@dataclass_json
+@dataclass
+class Person:
+    given_name: str = field(metadata=config(field_name="overriddenGivenName"))
+
+Person(given_name="Alice")  # Person('Alice')
+Person.from_json('{"overriddenGivenName": "Alice"}')  # Person('Alice')
+Person('Alice').to_json()  # {"overriddenGivenName": "Alice"}
+```
+
+### Handle missing or optional field values when decoding?
+
+By default, any fields in your dataclass that use `default` or 
+`default_factory` will have the values filled with the provided default, if the
+corresponding field is missing from the JSON you're decoding.
+
+**Decode JSON with missing field**
+
+```python
+@dataclass_json
+@dataclass
+class Student:
+    id: int
+    name: str = 'student'
+
+Student.from_json('{"id": 1}')  # Student(id=1, name='student')
+```
+
+Notice `from_json` filled the field `name` with the specified default 'student'
+when it was missing from the JSON.
+
+Sometimes you have fields that are typed as `Optional`, but you don't 
+necessarily want to assign a default. In that case, you can use the 
+`infer_missing` kwarg to make `from_json` infer the missing field value as `None`.
+
+**Decode optional field without default**
+
+```python
+@dataclass_json
+@dataclass
+class Tutor:
+    id: int
+    student: Optional[Student] = None
+
+Tutor.from_json('{"id": 1}')  # Tutor(id=1, student=None)
+```
+
+Personally I recommend you leverage dataclass defaults rather than using 
+`infer_missing`, but if for some reason you need to decouple the behavior of 
+JSON decoding from the field's default value, this will allow you to do so.
+
+
+### Handle unknown / extraneous fields in JSON?
+
+By default, it is up to the implementation what happens when a `json_dataclass` receives input parameters that are not defined.
+(the `from_dict` method ignores them, when loading using `schema()` a ValidationError is raised.)
+There are three ways to customize this behavior.
+
+Assume you want to instantiate a dataclass with the following dictionary:
+```python
+dump_dict = {"endpoint": "some_api_endpoint", "data": {"foo": 1, "bar": "2"}, "undefined_field_name": [1, 2, 3]}
+```
+
+1. You can enforce to always raise an error by setting the `undefined` keyword to `Undefined.RAISE`
+ (`'RAISE'` as a case-insensitive string works as well). Of course it works normally if you don't pass any undefined parameters.
+    
+```python
+from dataclasses_json import Undefined
+
+@dataclass_json(undefined=Undefined.RAISE)
+@dataclass()
+class ExactAPIDump:
+    endpoint: str
+    data: Dict[str, Any]
+
+dump = ExactAPIDump.from_dict(dump_dict)  # raises UndefinedParameterError
+```
+
+2. You can simply ignore any undefined parameters by setting the `undefined` keyword to `Undefined.EXCLUDE`
+ (`'EXCLUDE'` as a case-insensitive string works as well). Note that you will not be able to retrieve them using `to_dict`:
+    
+```python
+from dataclasses_json import Undefined
+
+@dataclass_json(undefined=Undefined.EXCLUDE)
+@dataclass()
+class DontCareAPIDump:
+    endpoint: str
+    data: Dict[str, Any]
+
+dump = DontCareAPIDump.from_dict(dump_dict)  # DontCareAPIDump(endpoint='some_api_endpoint', data={'foo': 1, 'bar': '2'})
+dump.to_dict()  # {"endpoint": "some_api_endpoint", "data": {"foo": 1, "bar": "2"}}
+```
+
+3. You can save them in a catch-all field and do whatever needs to be done later. Simply set the `undefined`
+keyword to `Undefined.INCLUDE` (`'INCLUDE'` as a case-insensitive string works as well) and define a field
+of type `CatchAll` where all unknown values will end up.
+ This simply represents a dictionary that can hold anything. 
+ If there are no undefined parameters, this will be an empty dictionary.
+    
+```python
+from dataclasses_json import Undefined, CatchAll
+
+@dataclass_json(undefined=Undefined.INCLUDE)
+@dataclass()
+class UnknownAPIDump:
+    endpoint: str
+    data: Dict[str, Any]
+    unknown_things: CatchAll
+
+dump = UnknownAPIDump.from_dict(dump_dict)  # UnknownAPIDump(endpoint='some_api_endpoint', data={'foo': 1, 'bar': '2'}, unknown_things={'undefined_field_name': [1, 2, 3]})
+dump.to_dict()  # {'endpoint': 'some_api_endpoint', 'data': {'foo': 1, 'bar': '2'}, 'undefined_field_name': [1, 2, 3]}
+```
+
+Notes:
+- When using `Undefined.INCLUDE`, an `UndefinedParameterError` will be raised if you don't specify
+exactly one field of type `CatchAll`.
+- Note that `LetterCase` does not affect values written into the `CatchAll` field, they will be as they are given.
+- When specifying a default (or a default factory) for the the `CatchAll`-field, e.g. `unknown_things: CatchAll = None`, the default value will be used instead of an empty dict if there are no undefined parameters.
+- Calling __init__ with non-keyword arguments resolves the arguments to the defined fields and writes everything else into the catch-all field.
+
+4. All 3 options work as well using `schema().loads` and `schema().dumps`, as long as you don't overwrite it by specifying `schema(unknown=<a marshmallow value>)`.
+marshmallow uses the same 3 keywords ['include', 'exclude', 'raise'](https://marshmallow.readthedocs.io/en/stable/quickstart.html#handling-unknown-fields).
+
+5. All 3 operations work as well using `__init__`, e.g. `UnknownAPIDump(**dump_dict)` will **not** raise a `TypeError`, but write all unknown values to the field tagged as `CatchAll`.
+   Classes tagged with `EXCLUDE` will also simply ignore unknown parameters. Note that classes tagged as `RAISE` still raise a `TypeError`, and **not** a `UndefinedParameterError` if supplied with unknown keywords.
+
+
+### Override the default encode / decode / marshmallow field of a specific field?
+
+See [Overriding](#Overriding)
+
+### Handle recursive dataclasses?
+Object hierarchies where fields are of the type that they are declared within require a small
+type hinting trick to declare the forward reference.
+```python
+from typing import Optional
+from dataclasses import dataclass
+from dataclasses_json import dataclass_json
+
+@dataclass_json
+@dataclass
+class Tree():
+    value: str
+    left: Optional['Tree']
+    right: Optional['Tree']
+```
+
+Avoid using
+```python
+from __future__ import annotations
+```
+as it will cause problems with the way dataclasses_json accesses the type annotations.
+
+### Use numpy or pandas types?
+Data types specific to libraries commonly used in data analysis and machine learning like [numpy](https://github.com/numpy/numpy) and [pandas](https://github.com/pandas-dev/pandas) are not supported by default, but you can easily enable them by using custom decoders and encoders. Below are two examples for `numpy` and `pandas` types.
+
+```python
+from dataclasses import field, dataclass
+from dataclasses_json import config, dataclass_json
+import numpy as np
+import pandas as pd
+
+@dataclass_json
+@dataclass
+class DataWithNumpy:
+    my_int: np.int64 = field(metadata=config(decoder=np.int64))
+    my_float: np.float64 = field(metadata=config(decoder=np.float64))
+    my_array: np.ndarray = field(metadata=config(decoder=np.asarray))
+DataWithNumpy.from_json("{\"my_int\": 42, \"my_float\": 13.37, \"my_array\": [1,2,3]}")
+
+@dataclass_json
+@dataclass
+class DataWithPandas:
+    my_df: pd.DataFrame = field(metadata=config(decoder=pd.DataFrame.from_records, encoder=lambda x: x.to_dict(orient="records")))
+data = DataWithPandas.from_dict({"my_df": [{"col1": 1, "col2": 2}, {"col1": 3, "col2": 4}]})
+# my_df results in:
+# col1  col2
+# 1    2    
+# 3    4
+data.to_dict()
+# {"my_df": [{"col1": 1, "col2": 2}, {"col1": 3, "col2": 4}]}
+```
+
+## Marshmallow interop
+
+Using the `dataclass_json` decorator or mixing in `DataClassJsonMixin` will
+provide you with an additional method `.schema()`.
+
+`.schema()` generates a schema exactly equivalent to manually creating a
+marshmallow schema for your dataclass. You can reference the [marshmallow API docs](https://marshmallow.readthedocs.io/en/3.0/api_reference.html#schema)
+to learn other ways you can use the schema returned by `.schema()`.
+
+You can pass in the exact same arguments to `.schema()` that you would when
+constructing a `PersonSchema` instance, e.g. `.schema(many=True)`, and they will
+get passed through to the marshmallow schema.
+
+
+```python
+from dataclasses import dataclass
+from dataclasses_json import dataclass_json
+
+@dataclass_json
+@dataclass
+class Person:
+    name: str
+
+# You don't need to do this - it's generated for you by `.schema()`!
+from marshmallow import Schema, fields
+
+class PersonSchema(Schema):
+    name = fields.Str()
+```
+
+Briefly, on what's going on under the hood in the above examples: calling 
+`.schema()` will have this library generate a
+[marshmallow schema]('https://marshmallow.readthedocs.io/en/3.0/api_reference.html#schema)
+for you. It also fills in the corresponding object hook, so that marshmallow
+will create an instance of your Data Class on `load` (e.g.
+`Person.schema().load` returns a `Person`) rather than a `dict`, which it does
+by default in marshmallow.
+
+**Performance note**
+
+`.schema()` is not cached (it generates the schema on every call), so if you
+have a nested Data Class you may want to save the result to a variable to 
+avoid re-generation of the schema on every usage.
+
+```python
+person_schema = Person.schema()
+person_schema.dump(people, many=True)
+
+# later in the code...
+
+person_schema.dump(person)
+```
+
+## Overriding / Extending
+
+#### Overriding
+
+For example, you might want to encode/decode `datetime` objects using ISO format
+rather than the default `timestamp`.
+
+```python
+from dataclasses import dataclass, field
+from dataclasses_json import dataclass_json, config
+from datetime import datetime
+from marshmallow import fields
+
+@dataclass_json
+@dataclass
+class DataClassWithIsoDatetime:
+    created_at: datetime = field(
+        metadata=config(
+            encoder=datetime.isoformat,
+            decoder=datetime.fromisoformat,
+            mm_field=fields.DateTime(format='iso')
+        )
+    )
+```
+
+#### Extending
+
+Similarly, you might want to extend `dataclasses_json` to encode `date` objects.
+
+```python
+from dataclasses import dataclass, field
+from dataclasses_json import dataclass_json, config
+from datetime import date
+from marshmallow import fields
+
+dataclasses_json.cfg.global_config.encoders[date] = date.isoformat
+dataclasses_json.cfg.global_config.decoders[date] = date.fromisoformat
+
+@dataclass_json
+@dataclass
+class DataClassWithIsoDatetime:
+    created_at: date
+    modified_at: date
+    accessed_at: date
+```
+
+As you can see, you can **override** or **extend** the default codecs by providing a "hook" via a 
+callable:
+- `encoder`: a callable, which will be invoked to convert the field value when encoding to JSON
+- `decoder`: a callable, which will be invoked to convert the JSON value when decoding from JSON
+- `mm_field`: a marshmallow field, which will affect the behavior of any operations involving `.schema()`
+
+Note that these hooks will be invoked regardless if you're using 
+`.to_json`/`dump`/`dumps`
+and `.from_json`/`load`/`loads`. So apply overrides / extensions judiciously, making sure to 
+carefully consider whether the interaction of the encode/decode/mm_field is consistent with what you expect!
+
+
+#### What if I have other dataclass field extensions that rely on `metadata`
+
+All the `dataclasses_json.config` does is return a mapping, namespaced under the key `'dataclasses_json'`.
+
+Say there's another module, `other_dataclass_package` that uses metadata. Here's how you solve your problem:
+
+```python
+metadata = {'other_dataclass_package': 'some metadata...'}  # pre-existing metadata for another dataclass package
+dataclass_json_config = config(
+            encoder=datetime.isoformat,
+            decoder=datetime.fromisoformat,
+            mm_field=fields.DateTime(format='iso')
+        )
+metadata.update(dataclass_json_config)
+
+@dataclass_json
+@dataclass
+class DataClassWithIsoDatetime:
+    created_at: datetime = field(metadata=metadata)
+```
+
+You can also manually specify the dataclass_json configuration mapping.
+
+```python
+@dataclass_json
+@dataclass
+class DataClassWithIsoDatetime:
+    created_at: date = field(
+        metadata={'dataclasses_json': {
+            'encoder': date.isoformat,
+            'decoder': date.fromisoformat,
+            'mm_field': fields.DateTime(format='iso')
+        }}
+    )
+```
+
+## A larger example
+
+```python
+from dataclasses import dataclass
+from dataclasses_json import dataclass_json
+
+from typing import List
+
+@dataclass_json
+@dataclass(frozen=True)
+class Minion:
+    name: str
+
+
+@dataclass_json
+@dataclass(frozen=True)
+class Boss:
+    minions: List[Minion]
+
+boss = Boss([Minion('evil minion'), Minion('very evil minion')])
+boss_json = """
+{
+    "minions": [
+        {
+            "name": "evil minion"
+        },
+        {
+            "name": "very evil minion"
+        }
+    ]
+}
+""".strip()
+
+assert boss.to_json(indent=4) == boss_json
+assert Boss.from_json(boss_json) == boss
+```
+
+## Performance
+
+Take a look at [this issue](https://github.com/lidatong/dataclasses-json/issues/228)
+
+## Versioning
+
+Note this library is still pre-1.0.0 (SEMVER).
+
+The current convention is:
+- **PATCH** version upgrades for bug fixes and minor feature additions.
+- **MINOR** version upgrades for big API features and breaking changes.
+
+Once this library is 1.0.0, it will follow standard SEMVER conventions.
+
+### Python compatibility 
+
+Any version that is not listed in the table below we do not test against, though you might still be able to install the library. For future Python versions, please open an issue and/or a pull request, adding them to the CI suite.
+
+
+| Python version range | Compatible dataclasses-json version |
+|----------------------|:-----------------------------------:|
+| 3.7.x - 3.12.x       |            0.5.x - 0.6.x            |
+| >= 3.13.x            |         No official support (yet)   |
+
+
+## Roadmap
+
+Currently the focus is on investigating and fixing bugs in this library, working
+on performance, and finishing [this issue](https://github.com/lidatong/dataclasses-json/issues/31).
+
+That said, if you think there's a feature missing / something new needed in the
+library, please see the contributing section below.
+
+
+## Contributing
+
+First of all, thank you for being interested in contributing to this library.
+I really appreciate you taking the time to work on this project.
+
+- If you're just interested in getting into the code, a good place to start are 
+issues tagged as bugs.
+- If introducing a new feature, especially one that modifies the public API, 
+consider submitting an issue for discussion before a PR. Please also take a look 
+at existing issues / PRs to see what you're proposing has  already been covered 
+before / exists.
+- I like to follow the commit conventions documented [here](https://www.conventionalcommits.org/en/v1.0.0/#summary)
+
+### Setting up your environment
+
+This project uses [Poetry](https://python-poetry.org/) for dependency and venv management. It is quite simple to get ready for your first commit:
+- [Install](https://python-poetry.org/docs/#installation) latest stable Poetry
+- Navigate to where you cloned `dataclasses-json`
+- Run `poetry install`
+- Create a branch and start writing code!
+
diff --git a/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/RECORD b/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..63dfe0951216588794b07757d443dbe8378ab01e
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/RECORD
@@ -0,0 +1,24 @@
+dataclasses_json-0.6.4.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+dataclasses_json-0.6.4.dist-info/LICENSE,sha256=UjIbVWleiRm3xlSx6Ag8V88hK4hfQocb1sPN0t0mfw8,1084
+dataclasses_json-0.6.4.dist-info/METADATA,sha256=tQ46EyCSFGE_7rOqCnyxOiX9wqc1ZlTkPh15DW6tBzY,25035
+dataclasses_json-0.6.4.dist-info/RECORD,,
+dataclasses_json-0.6.4.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+dataclasses_json/__init__.py,sha256=O2-gxxDqFvB8F3WyvjBEn3J6epRHaRZjhJtVEhVJfCc,495
+dataclasses_json/__pycache__/__init__.cpython-311.pyc,,
+dataclasses_json/__pycache__/__version__.cpython-311.pyc,,
+dataclasses_json/__pycache__/api.cpython-311.pyc,,
+dataclasses_json/__pycache__/cfg.cpython-311.pyc,,
+dataclasses_json/__pycache__/core.cpython-311.pyc,,
+dataclasses_json/__pycache__/mm.cpython-311.pyc,,
+dataclasses_json/__pycache__/stringcase.cpython-311.pyc,,
+dataclasses_json/__pycache__/undefined.cpython-311.pyc,,
+dataclasses_json/__pycache__/utils.cpython-311.pyc,,
+dataclasses_json/__version__.py,sha256=5H9Z0psLwSRfLmr3qK_pnLgvneNd9L4q-36gNEN3rok,154
+dataclasses_json/api.py,sha256=hzH18PZWgBifuvqJFdUed7daRqOfCaGUyS2EMfmLXo8,5990
+dataclasses_json/cfg.py,sha256=IRREFI4oOTlWENXbOzp86X3_3tRpER-3bXlkBoMqqyk,3527
+dataclasses_json/core.py,sha256=uwMnARjhpj3vaQ4WjiaVkQBCkud2ONXdZCRrEdduWK4,17887
+dataclasses_json/mm.py,sha256=TKwSIn2OXeHF2E4n_Uhc5Mhe1LBQAKq0nmo5D4hc_qQ,15997
+dataclasses_json/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dataclasses_json/stringcase.py,sha256=lCTTNBaXwgudBdL2DAq42L4-yJgiEtWkLD6O5NvXAeo,3313
+dataclasses_json/undefined.py,sha256=GaN_LCwHpsfzVqAR2uv7AZyU2ID5tqLVaof81Y9VjM0,10452
+dataclasses_json/utils.py,sha256=x4tA6yCJJfyDIB1-wgeXEEAkQLm19f3vydlDv6CM9cg,5714
diff --git a/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/WHEEL b/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..7c881525d384f1537e81e8a783c8433a748a7089
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json-0.6.4.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 1.8.1
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/dataclasses_json/__init__.py b/llm/Lib/site-packages/dataclasses_json/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..937bdbc49c3fd0b1e27c8f4baf65570b0e802a46
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json/__init__.py
@@ -0,0 +1,12 @@
+# flake8: noqa
+from dataclasses_json.api import (DataClassJsonMixin,
+                                  dataclass_json)
+from dataclasses_json.cfg import (config, global_config,
+                                  Exclude, LetterCase)
+from dataclasses_json.undefined import CatchAll, Undefined
+
+from dataclasses_json.__version__ import __version__
+
+__all__ = ['DataClassJsonMixin', 'LetterCase', 'dataclass_json',
+           'config', 'global_config', 'Exclude',
+           'CatchAll', 'Undefined']
diff --git a/llm/Lib/site-packages/dataclasses_json/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/dataclasses_json/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5ea74fe0b48484c375cb76452978f1fb1d4f6163
Binary files /dev/null and b/llm/Lib/site-packages/dataclasses_json/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dataclasses_json/__pycache__/__version__.cpython-311.pyc b/llm/Lib/site-packages/dataclasses_json/__pycache__/__version__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0f1a42cf081b7b734bb042ea4f73873a4d293712
Binary files /dev/null and b/llm/Lib/site-packages/dataclasses_json/__pycache__/__version__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dataclasses_json/__pycache__/api.cpython-311.pyc b/llm/Lib/site-packages/dataclasses_json/__pycache__/api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3810fae1ff5e9eb6f622ab9dcd065560a83239ca
Binary files /dev/null and b/llm/Lib/site-packages/dataclasses_json/__pycache__/api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dataclasses_json/__pycache__/cfg.cpython-311.pyc b/llm/Lib/site-packages/dataclasses_json/__pycache__/cfg.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b19b4bdd7d6df51beb994de33410a77a69e4f303
Binary files /dev/null and b/llm/Lib/site-packages/dataclasses_json/__pycache__/cfg.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dataclasses_json/__pycache__/core.cpython-311.pyc b/llm/Lib/site-packages/dataclasses_json/__pycache__/core.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e873f1ed95d280c76b358a6c4498b97d35803359
Binary files /dev/null and b/llm/Lib/site-packages/dataclasses_json/__pycache__/core.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dataclasses_json/__pycache__/mm.cpython-311.pyc b/llm/Lib/site-packages/dataclasses_json/__pycache__/mm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6bbe072fec1d52850140a9ba72b8b6849868739c
Binary files /dev/null and b/llm/Lib/site-packages/dataclasses_json/__pycache__/mm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dataclasses_json/__pycache__/stringcase.cpython-311.pyc b/llm/Lib/site-packages/dataclasses_json/__pycache__/stringcase.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f1f6d47c631b8616bd24eb62cb4302a8dd322a46
Binary files /dev/null and b/llm/Lib/site-packages/dataclasses_json/__pycache__/stringcase.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dataclasses_json/__pycache__/undefined.cpython-311.pyc b/llm/Lib/site-packages/dataclasses_json/__pycache__/undefined.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bf13566dcfbb3760c7560d99ac4fdb9650711656
Binary files /dev/null and b/llm/Lib/site-packages/dataclasses_json/__pycache__/undefined.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dataclasses_json/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/dataclasses_json/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..595abbb689c07811b66b101611651bc4716e63b6
Binary files /dev/null and b/llm/Lib/site-packages/dataclasses_json/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dataclasses_json/__version__.py b/llm/Lib/site-packages/dataclasses_json/__version__.py
new file mode 100644
index 0000000000000000000000000000000000000000..24333b6d7f5912b1a87c99872f7bb7c91b51968a
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json/__version__.py
@@ -0,0 +1,6 @@
+"""
+ Version file.
+ Allows common version lookup via from dataclasses_json import __version__
+"""
+
+__version__ = "0.6.4"  # replaced by git tag on deploy
diff --git a/llm/Lib/site-packages/dataclasses_json/api.py b/llm/Lib/site-packages/dataclasses_json/api.py
new file mode 100644
index 0000000000000000000000000000000000000000..3481e93fbec486f8879f51dd0ea2fadacdeecf22
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json/api.py
@@ -0,0 +1,153 @@
+import abc
+import json
+from typing import Any, Callable, Dict, List, Optional, Tuple, Type, TypeVar, Union, overload
+
+from dataclasses_json.cfg import config, LetterCase
+from dataclasses_json.core import (Json, _ExtendedEncoder, _asdict,
+                                   _decode_dataclass)
+from dataclasses_json.mm import (JsonData, SchemaType, build_schema)
+from dataclasses_json.undefined import Undefined
+from dataclasses_json.utils import (_handle_undefined_parameters_safe,
+                                    _undefined_parameter_action_safe)
+
+A = TypeVar('A', bound="DataClassJsonMixin")
+T = TypeVar('T')
+Fields = List[Tuple[str, Any]]
+
+
+class DataClassJsonMixin(abc.ABC):
+    """
+    DataClassJsonMixin is an ABC that functions as a Mixin.
+
+    As with other ABCs, it should not be instantiated directly.
+    """
+    dataclass_json_config: Optional[dict] = None
+
+    def to_json(self,
+                *,
+                skipkeys: bool = False,
+                ensure_ascii: bool = True,
+                check_circular: bool = True,
+                allow_nan: bool = True,
+                indent: Optional[Union[int, str]] = None,
+                separators: Optional[Tuple[str, str]] = None,
+                default: Optional[Callable] = None,
+                sort_keys: bool = False,
+                **kw) -> str:
+        return json.dumps(self.to_dict(encode_json=False),
+                          cls=_ExtendedEncoder,
+                          skipkeys=skipkeys,
+                          ensure_ascii=ensure_ascii,
+                          check_circular=check_circular,
+                          allow_nan=allow_nan,
+                          indent=indent,
+                          separators=separators,
+                          default=default,
+                          sort_keys=sort_keys,
+                          **kw)
+
+    @classmethod
+    def from_json(cls: Type[A],
+                  s: JsonData,
+                  *,
+                  parse_float=None,
+                  parse_int=None,
+                  parse_constant=None,
+                  infer_missing=False,
+                  **kw) -> A:
+        kvs = json.loads(s,
+                         parse_float=parse_float,
+                         parse_int=parse_int,
+                         parse_constant=parse_constant,
+                         **kw)
+        return cls.from_dict(kvs, infer_missing=infer_missing)
+
+    @classmethod
+    def from_dict(cls: Type[A],
+                  kvs: Json,
+                  *,
+                  infer_missing=False) -> A:
+        return _decode_dataclass(cls, kvs, infer_missing)
+
+    def to_dict(self, encode_json=False) -> Dict[str, Json]:
+        return _asdict(self, encode_json=encode_json)
+
+    @classmethod
+    def schema(cls: Type[A],
+               *,
+               infer_missing: bool = False,
+               only=None,
+               exclude=(),
+               many: bool = False,
+               context=None,
+               load_only=(),
+               dump_only=(),
+               partial: bool = False,
+               unknown=None) -> "SchemaType[A]":
+        Schema = build_schema(cls, DataClassJsonMixin, infer_missing, partial)
+
+        if unknown is None:
+            undefined_parameter_action = _undefined_parameter_action_safe(cls)
+            if undefined_parameter_action is not None:
+                # We can just make use of the same-named mm keywords
+                unknown = undefined_parameter_action.name.lower()
+
+        return Schema(only=only,
+                      exclude=exclude,
+                      many=many,
+                      context=context,
+                      load_only=load_only,
+                      dump_only=dump_only,
+                      partial=partial,
+                      unknown=unknown)
+
+
+@overload
+def dataclass_json(_cls: None = ..., *, letter_case: Optional[LetterCase] = ...,
+                   undefined: Optional[Union[str, Undefined]] = ...) -> Callable[[Type[T]], Type[T]]: ...
+
+
+@overload
+def dataclass_json(_cls: Type[T], *, letter_case: Optional[LetterCase] = ...,
+                   undefined: Optional[Union[str, Undefined]] = ...) -> Type[T]: ...
+
+
+def dataclass_json(_cls: Optional[Type[T]] = None, *, letter_case: Optional[LetterCase] = None,
+                   undefined: Optional[Union[str, Undefined]] = None) -> Union[Callable[[Type[T]], Type[T]], Type[T]]:
+    """
+    Based on the code in the `dataclasses` module to handle optional-parens
+    decorators. See example below:
+
+    @dataclass_json
+    @dataclass_json(letter_case=LetterCase.CAMEL)
+    class Example:
+        ...
+    """
+
+    def wrap(cls: Type[T]) -> Type[T]:
+        return _process_class(cls, letter_case, undefined)
+
+    if _cls is None:
+        return wrap
+    return wrap(_cls)
+
+
+def _process_class(cls: Type[T], letter_case: Optional[LetterCase],
+                   undefined: Optional[Union[str, Undefined]]) -> Type[T]:
+    if letter_case is not None or undefined is not None:
+        cls.dataclass_json_config = config(letter_case=letter_case,  # type: ignore[attr-defined]
+                                           undefined=undefined)['dataclasses_json']
+
+    cls.to_json = DataClassJsonMixin.to_json  # type: ignore[attr-defined]
+    # unwrap and rewrap classmethod to tag it to cls rather than the literal
+    # DataClassJsonMixin ABC
+    cls.from_json = classmethod(DataClassJsonMixin.from_json.__func__)  # type: ignore[attr-defined]
+    cls.to_dict = DataClassJsonMixin.to_dict  # type: ignore[attr-defined]
+    cls.from_dict = classmethod(DataClassJsonMixin.from_dict.__func__)  # type: ignore[attr-defined]
+    cls.schema = classmethod(DataClassJsonMixin.schema.__func__)  # type: ignore[attr-defined]
+
+    cls.__init__ = _handle_undefined_parameters_safe(cls, kvs=(),  # type: ignore[attr-defined,method-assign]
+                                                     usage="init")
+    # register cls as a virtual subclass of DataClassJsonMixin
+    DataClassJsonMixin.register(cls)
+    return cls
diff --git a/llm/Lib/site-packages/dataclasses_json/cfg.py b/llm/Lib/site-packages/dataclasses_json/cfg.py
new file mode 100644
index 0000000000000000000000000000000000000000..930e51e064abbd5e906ae739acb2b30051ed7849
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json/cfg.py
@@ -0,0 +1,110 @@
+import functools
+from enum import Enum
+from typing import Callable, Dict, Optional, TypeVar, Union
+
+from marshmallow.fields import Field as MarshmallowField  # type: ignore
+
+from dataclasses_json.stringcase import (camelcase, pascalcase, snakecase,
+                                         spinalcase)  # type: ignore
+from dataclasses_json.undefined import Undefined, UndefinedParameterError
+
+T = TypeVar("T")
+
+
+class Exclude:
+    """
+    Pre-defined constants for exclusion. By default, fields are configured to
+    be included.
+    """
+    ALWAYS: Callable[[object], bool] = lambda _: True
+    NEVER: Callable[[object], bool] = lambda _: False
+
+
+# TODO: add warnings?
+class _GlobalConfig:
+
+    def __init__(self):
+        self.encoders: Dict[Union[type, Optional[type]], Callable] = {}
+        self.decoders: Dict[Union[type, Optional[type]], Callable] = {}
+        self.mm_fields: Dict[
+            Union[type, Optional[type]],
+            MarshmallowField
+        ] = {}
+        # self._json_module = json
+
+    # TODO: #180
+    # @property
+    # def json_module(self):
+    #     return self._json_module
+    #
+    # @json_module.setter
+    # def json_module(self, value):
+    #     warnings.warn(f"Now using {value.__name__} module to handle JSON. "
+    #                   f"{self._disable_msg}")
+    #     self._json_module = value
+
+
+global_config = _GlobalConfig()
+
+
+class LetterCase(Enum):
+    CAMEL = camelcase
+    KEBAB = spinalcase
+    SNAKE = snakecase
+    PASCAL = pascalcase
+
+
+def config(metadata: Optional[dict] = None, *,
+           # TODO: these can be typed more precisely
+           # Specifically, a Callable[A, B], where `B` is bound as a JSON type
+           encoder: Optional[Callable] = None,
+           decoder: Optional[Callable] = None,
+           mm_field: Optional[MarshmallowField] = None,
+           letter_case: Union[Callable[[str], str], LetterCase, None] = None,
+           undefined: Optional[Union[str, Undefined]] = None,
+           field_name: Optional[str] = None,
+           exclude: Optional[Callable[[T], bool]] = None,
+           ) -> Dict[str, dict]:
+    if metadata is None:
+        metadata = {}
+
+    lib_metadata = metadata.setdefault('dataclasses_json', {})
+
+    if encoder is not None:
+        lib_metadata['encoder'] = encoder
+
+    if decoder is not None:
+        lib_metadata['decoder'] = decoder
+
+    if mm_field is not None:
+        lib_metadata['mm_field'] = mm_field
+
+    if field_name is not None:
+        if letter_case is not None:
+            @functools.wraps(letter_case)  # type:ignore
+            def override(_, _letter_case=letter_case, _field_name=field_name):
+                return _letter_case(_field_name)
+        else:
+            def override(_, _field_name=field_name):  # type:ignore
+                return _field_name
+        letter_case = override
+
+    if letter_case is not None:
+        lib_metadata['letter_case'] = letter_case
+
+    if undefined is not None:
+        # Get the corresponding action for undefined parameters
+        if isinstance(undefined, str):
+            if not hasattr(Undefined, undefined.upper()):
+                valid_actions = list(action.name for action in Undefined)
+                raise UndefinedParameterError(
+                    f"Invalid undefined parameter action, "
+                    f"must be one of {valid_actions}")
+            undefined = Undefined[undefined.upper()]
+
+        lib_metadata['undefined'] = undefined
+
+    if exclude is not None:
+        lib_metadata['exclude'] = exclude
+
+    return metadata
diff --git a/llm/Lib/site-packages/dataclasses_json/core.py b/llm/Lib/site-packages/dataclasses_json/core.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf7b7cc81eeaa9feb7c7f9955039c6514cbce81b
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json/core.py
@@ -0,0 +1,432 @@
+import copy
+import json
+import sys
+import warnings
+from collections import defaultdict, namedtuple
+from dataclasses import (MISSING,
+                         fields,
+                         is_dataclass  # type: ignore
+                         )
+from datetime import datetime, timezone
+from decimal import Decimal
+from enum import Enum
+from typing import (Any, Collection, Mapping, Union, get_type_hints,
+                    Tuple, TypeVar, Type)
+from uuid import UUID
+
+from typing_inspect import is_union_type  # type: ignore
+
+from dataclasses_json import cfg
+from dataclasses_json.utils import (_get_type_cons, _get_type_origin,
+                                    _handle_undefined_parameters_safe,
+                                    _is_collection, _is_mapping, _is_new_type,
+                                    _is_optional, _isinstance_safe,
+                                    _get_type_arg_param,
+                                    _get_type_args, _is_counter,
+                                    _NO_ARGS,
+                                    _issubclass_safe, _is_tuple)
+
+Json = Union[dict, list, str, int, float, bool, None]
+
+confs = ['encoder', 'decoder', 'mm_field', 'letter_case', 'exclude']
+FieldOverride = namedtuple('FieldOverride', confs)  # type: ignore
+
+
+class _ExtendedEncoder(json.JSONEncoder):
+    def default(self, o) -> Json:
+        result: Json
+        if _isinstance_safe(o, Collection):
+            if _isinstance_safe(o, Mapping):
+                result = dict(o)
+            else:
+                result = list(o)
+        elif _isinstance_safe(o, datetime):
+            result = o.timestamp()
+        elif _isinstance_safe(o, UUID):
+            result = str(o)
+        elif _isinstance_safe(o, Enum):
+            result = o.value
+        elif _isinstance_safe(o, Decimal):
+            result = str(o)
+        else:
+            result = json.JSONEncoder.default(self, o)
+        return result
+
+
+def _user_overrides_or_exts(cls):
+    global_metadata = defaultdict(dict)
+    encoders = cfg.global_config.encoders
+    decoders = cfg.global_config.decoders
+    mm_fields = cfg.global_config.mm_fields
+    for field in fields(cls):
+        if field.type in encoders:
+            global_metadata[field.name]['encoder'] = encoders[field.type]
+        if field.type in decoders:
+            global_metadata[field.name]['decoder'] = decoders[field.type]
+        if field.type in mm_fields:
+            global_metadata[field.name]['mm_field'] = mm_fields[field.type]
+    try:
+        cls_config = (cls.dataclass_json_config
+                      if cls.dataclass_json_config is not None else {})
+    except AttributeError:
+        cls_config = {}
+
+    overrides = {}
+    for field in fields(cls):
+        field_config = {}
+        # first apply global overrides or extensions
+        field_metadata = global_metadata[field.name]
+        if 'encoder' in field_metadata:
+            field_config['encoder'] = field_metadata['encoder']
+        if 'decoder' in field_metadata:
+            field_config['decoder'] = field_metadata['decoder']
+        if 'mm_field' in field_metadata:
+            field_config['mm_field'] = field_metadata['mm_field']
+        # then apply class-level overrides or extensions
+        field_config.update(cls_config)
+        # last apply field-level overrides or extensions
+        field_config.update(field.metadata.get('dataclasses_json', {}))
+        overrides[field.name] = FieldOverride(*map(field_config.get, confs))
+    return overrides
+
+
+def _encode_json_type(value, default=_ExtendedEncoder().default):
+    if isinstance(value, Json.__args__):  # type: ignore
+        if isinstance(value, list):
+            return [_encode_json_type(i) for i in value]
+        elif isinstance(value, dict):
+            return {k: _encode_json_type(v) for k, v in value.items()}
+        else:
+            return value
+    return default(value)
+
+
+def _encode_overrides(kvs, overrides, encode_json=False):
+    override_kvs = {}
+    for k, v in kvs.items():
+        if k in overrides:
+            exclude = overrides[k].exclude
+            # If the exclude predicate returns true, the key should be
+            #  excluded from encoding, so skip the rest of the loop
+            if exclude and exclude(v):
+                continue
+            letter_case = overrides[k].letter_case
+            original_key = k
+            k = letter_case(k) if letter_case is not None else k
+            if k in override_kvs:
+                raise ValueError(
+                    f"Multiple fields map to the same JSON "
+                    f"key after letter case encoding: {k}"
+                )
+
+            encoder = overrides[original_key].encoder
+            v = encoder(v) if encoder is not None else v
+
+        if encode_json:
+            v = _encode_json_type(v)
+        override_kvs[k] = v
+    return override_kvs
+
+
+def _decode_letter_case_overrides(field_names, overrides):
+    """Override letter case of field names for encode/decode"""
+    names = {}
+    for field_name in field_names:
+        field_override = overrides.get(field_name)
+        if field_override is not None:
+            letter_case = field_override.letter_case
+            if letter_case is not None:
+                names[letter_case(field_name)] = field_name
+    return names
+
+
+def _decode_dataclass(cls, kvs, infer_missing):
+    if _isinstance_safe(kvs, cls):
+        return kvs
+    overrides = _user_overrides_or_exts(cls)
+    kvs = {} if kvs is None and infer_missing else kvs
+    field_names = [field.name for field in fields(cls)]
+    decode_names = _decode_letter_case_overrides(field_names, overrides)
+    kvs = {decode_names.get(k, k): v for k, v in kvs.items()}
+    missing_fields = {field for field in fields(cls) if field.name not in kvs}
+
+    for field in missing_fields:
+        if field.default is not MISSING:
+            kvs[field.name] = field.default
+        elif field.default_factory is not MISSING:
+            kvs[field.name] = field.default_factory()
+        elif infer_missing:
+            kvs[field.name] = None
+
+    # Perform undefined parameter action
+    kvs = _handle_undefined_parameters_safe(cls, kvs, usage="from")
+
+    init_kwargs = {}
+    types = get_type_hints(cls)
+    for field in fields(cls):
+        # The field should be skipped from being added
+        # to init_kwargs as it's not intended as a constructor argument.
+        if not field.init:
+            continue
+
+        field_value = kvs[field.name]
+        field_type = types[field.name]
+        if field_value is None:
+            if not _is_optional(field_type):
+                warning = (
+                    f"value of non-optional type {field.name} detected "
+                    f"when decoding {cls.__name__}"
+                )
+                if infer_missing:
+                    warnings.warn(
+                        f"Missing {warning} and was defaulted to None by "
+                        f"infer_missing=True. "
+                        f"Set infer_missing=False (the default) to prevent "
+                        f"this behavior.", RuntimeWarning
+                    )
+                else:
+                    warnings.warn(
+                        f"'NoneType' object {warning}.", RuntimeWarning
+                    )
+            init_kwargs[field.name] = field_value
+            continue
+
+        while True:
+            if not _is_new_type(field_type):
+                break
+
+            field_type = field_type.__supertype__
+
+        if (field.name in overrides
+                and overrides[field.name].decoder is not None):
+            # FIXME hack
+            if field_type is type(field_value):
+                init_kwargs[field.name] = field_value
+            else:
+                init_kwargs[field.name] = overrides[field.name].decoder(
+                    field_value)
+        elif is_dataclass(field_type):
+            # FIXME this is a band-aid to deal with the value already being
+            # serialized when handling nested marshmallow schema
+            # proper fix is to investigate the marshmallow schema generation
+            # code
+            if is_dataclass(field_value):
+                value = field_value
+            else:
+                value = _decode_dataclass(field_type, field_value,
+                                          infer_missing)
+            init_kwargs[field.name] = value
+        elif _is_supported_generic(field_type) and field_type != str:
+            init_kwargs[field.name] = _decode_generic(field_type,
+                                                      field_value,
+                                                      infer_missing)
+        else:
+            init_kwargs[field.name] = _support_extended_types(field_type,
+                                                              field_value)
+
+    return cls(**init_kwargs)
+
+
+def _support_extended_types(field_type, field_value):
+    if _issubclass_safe(field_type, datetime):
+        # FIXME this is a hack to deal with mm already decoding
+        # the issue is we want to leverage mm fields' missing argument
+        # but need this for the object creation hook
+        if isinstance(field_value, datetime):
+            res = field_value
+        else:
+            tz = datetime.now(timezone.utc).astimezone().tzinfo
+            res = datetime.fromtimestamp(field_value, tz=tz)
+    elif _issubclass_safe(field_type, Decimal):
+        res = (field_value
+               if isinstance(field_value, Decimal)
+               else Decimal(field_value))
+    elif _issubclass_safe(field_type, UUID):
+        res = (field_value
+               if isinstance(field_value, UUID)
+               else UUID(field_value))
+    elif _issubclass_safe(field_type, (int, float, str, bool)):
+        res = (field_value
+               if isinstance(field_value, field_type)
+               else field_type(field_value))
+    else:
+        res = field_value
+    return res
+
+
+def _is_supported_generic(type_):
+    if type_ is _NO_ARGS:
+        return False
+    not_str = not _issubclass_safe(type_, str)
+    is_enum = _issubclass_safe(type_, Enum)
+    return (not_str and _is_collection(type_)) or _is_optional(
+        type_) or is_union_type(type_) or is_enum
+
+
+def _decode_generic(type_, value, infer_missing):
+    if value is None:
+        res = value
+    elif _issubclass_safe(type_, Enum):
+        # Convert to an Enum using the type as a constructor.
+        # Assumes a direct match is found.
+        res = type_(value)
+    # FIXME this is a hack to fix a deeper underlying issue. A refactor is due.
+    elif _is_collection(type_):
+        if _is_mapping(type_) and not _is_counter(type_):
+            k_type, v_type = _get_type_args(type_, (Any, Any))
+            # a mapping type has `.keys()` and `.values()`
+            # (see collections.abc)
+            ks = _decode_dict_keys(k_type, value.keys(), infer_missing)
+            vs = _decode_items(v_type, value.values(), infer_missing)
+            xs = zip(ks, vs)
+        elif _is_tuple(type_):
+            types = _get_type_args(type_)
+            if Ellipsis in types:
+                xs = _decode_items(types[0], value, infer_missing)
+            else:
+                xs = _decode_items(_get_type_args(type_) or _NO_ARGS, value, infer_missing)
+        elif _is_counter(type_):
+            xs = dict(zip(_decode_items(_get_type_arg_param(type_, 0), value.keys(), infer_missing), value.values()))
+        else:
+            xs = _decode_items(_get_type_arg_param(type_, 0), value, infer_missing)
+
+        # get the constructor if using corresponding generic type in `typing`
+        # otherwise fallback on constructing using type_ itself
+        materialize_type = type_
+        try:
+            materialize_type = _get_type_cons(type_)
+        except (TypeError, AttributeError):
+            pass
+        res = materialize_type(xs)
+    else:  # Optional or Union
+        _args = _get_type_args(type_)
+        if _args is _NO_ARGS:
+            # Any, just accept
+            res = value
+        elif _is_optional(type_) and len(_args) == 2:  # Optional
+            type_arg = _get_type_arg_param(type_, 0)
+            if is_dataclass(type_arg) or is_dataclass(value):
+                res = _decode_dataclass(type_arg, value, infer_missing)
+            elif _is_supported_generic(type_arg):
+                res = _decode_generic(type_arg, value, infer_missing)
+            else:
+                res = _support_extended_types(type_arg, value)
+        else:  # Union (already decoded or try to decode a dataclass)
+            type_options = _get_type_args(type_)
+            res = value  # assume already decoded
+            if type(value) is dict and dict not in type_options:
+                for type_option in type_options:
+                    if is_dataclass(type_option):
+                        try:
+                            res = _decode_dataclass(type_option, value, infer_missing)
+                            break
+                        except (KeyError, ValueError, AttributeError):
+                            continue
+                if res == value:
+                    warnings.warn(
+                        f"Failed to decode {value} Union dataclasses."
+                        f"Expected Union to include a matching dataclass and it didn't."
+                    )
+    return res
+
+
+def _decode_dict_keys(key_type, xs, infer_missing):
+    """
+    Because JSON object keys must be strs, we need the extra step of decoding
+    them back into the user's chosen python type
+    """
+    decode_function = key_type
+    # handle NoneType keys... it's weird to type a Dict as NoneType keys
+    # but it's valid...
+    # Issue #341 and PR #346:
+    #   This is a special case for Python 3.7 and Python 3.8.
+    #   By some reason, "unbound" dicts are counted
+    #   as having key type parameter to be TypeVar('KT')
+    if key_type is None or key_type == Any or isinstance(key_type, TypeVar):
+        decode_function = key_type = (lambda x: x)
+    # handle a nested python dict that has tuples for keys. E.g. for
+    # Dict[Tuple[int], int], key_type will be typing.Tuple[int], but
+    # decode_function should be tuple, so map() doesn't break.
+    #
+    # Note: _get_type_origin() will return typing.Tuple for python
+    # 3.6 and tuple for 3.7 and higher.
+    elif _get_type_origin(key_type) in {tuple, Tuple}:
+        decode_function = tuple
+        key_type = key_type
+
+    return map(decode_function, _decode_items(key_type, xs, infer_missing))
+
+
+def _decode_items(type_args, xs, infer_missing):
+    """
+    This is a tricky situation where we need to check both the annotated
+    type info (which is usually a type from `typing`) and check the
+    value's type directly using `type()`.
+
+    If the type_arg is a generic we can use the annotated type, but if the
+    type_arg is a typevar we need to extract the reified type information
+    hence the check of `is_dataclass(vs)`
+    """
+    def _decode_item(type_arg, x):
+        if is_dataclass(type_arg) or is_dataclass(xs):
+            return _decode_dataclass(type_arg, x, infer_missing)
+        if _is_supported_generic(type_arg):
+            return _decode_generic(type_arg, x, infer_missing)
+        return x
+
+    def handle_pep0673(pre_0673_hint: str) -> Union[Type, str]:
+        for module in sys.modules:
+            maybe_resolved = getattr(sys.modules[module], type_args, None)
+            if maybe_resolved:
+                return maybe_resolved
+
+        warnings.warn(f"Could not resolve self-reference for type {pre_0673_hint}, "
+                      f"decoded type might be incorrect or decode might fail altogether.")
+        return pre_0673_hint
+
+    # Before https://peps.python.org/pep-0673 (3.11+) self-type hints are simply strings
+    if sys.version_info.minor < 11 and type_args is not type and type(type_args) is str:
+        type_args = handle_pep0673(type_args)
+
+    if _isinstance_safe(type_args, Collection) and not _issubclass_safe(type_args, Enum):
+        if len(type_args) == len(xs):
+            return list(_decode_item(type_arg, x) for type_arg, x in zip(type_args, xs))
+        else:
+            raise TypeError(f"Number of types specified in the collection type {str(type_args)} "
+                            f"does not match number of elements in the collection. In case you are working with tuples"
+                            f"take a look at this document "
+                            f"docs.python.org/3/library/typing.html#annotating-tuples.")
+    return list(_decode_item(type_args, x) for x in xs)
+
+
+def _asdict(obj, encode_json=False):
+    """
+    A re-implementation of `asdict` (based on the original in the `dataclasses`
+    source) to support arbitrary Collection and Mapping types.
+    """
+    if is_dataclass(obj):
+        result = []
+        overrides = _user_overrides_or_exts(obj)
+        for field in fields(obj):
+            if overrides[field.name].encoder:
+                value = getattr(obj, field.name)
+            else:
+                value = _asdict(
+                    getattr(obj, field.name),
+                    encode_json=encode_json
+                )
+            result.append((field.name, value))
+
+        result = _handle_undefined_parameters_safe(cls=obj, kvs=dict(result),
+                                                   usage="to")
+        return _encode_overrides(dict(result), _user_overrides_or_exts(obj),
+                                 encode_json=encode_json)
+    elif isinstance(obj, Mapping):
+        return dict((_asdict(k, encode_json=encode_json),
+                     _asdict(v, encode_json=encode_json)) for k, v in
+                    obj.items())
+    # enum.IntFlag and enum.Flag are regarded as collections in Python 3.11, thus a check against Enum is needed
+    elif isinstance(obj, Collection) and not isinstance(obj, (str, bytes, Enum)):
+        return list(_asdict(v, encode_json=encode_json) for v in obj)
+    else:
+        return copy.deepcopy(obj)
diff --git a/llm/Lib/site-packages/dataclasses_json/mm.py b/llm/Lib/site-packages/dataclasses_json/mm.py
new file mode 100644
index 0000000000000000000000000000000000000000..9cfacf1dec368083a9f2cff249e378d77d0ad127
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json/mm.py
@@ -0,0 +1,399 @@
+# flake8: noqa
+
+import typing
+import warnings
+import sys
+from copy import deepcopy
+
+from dataclasses import MISSING, is_dataclass, fields as dc_fields
+from datetime import datetime
+from decimal import Decimal
+from uuid import UUID
+from enum import Enum
+
+from typing_inspect import is_union_type  # type: ignore
+
+from marshmallow import fields, Schema, post_load  # type: ignore
+from marshmallow.exceptions import ValidationError  # type: ignore
+
+from dataclasses_json.core import (_is_supported_generic, _decode_dataclass,
+                                   _ExtendedEncoder, _user_overrides_or_exts)
+from dataclasses_json.utils import (_is_collection, _is_optional,
+                                    _issubclass_safe, _timestamp_to_dt_aware,
+                                    _is_new_type, _get_type_origin,
+                                    _handle_undefined_parameters_safe,
+                                    CatchAllVar)
+
+
+class _TimestampField(fields.Field):
+    def _serialize(self, value, attr, obj, **kwargs):
+        if value is not None:
+            return value.timestamp()
+        else:
+            if not self.required:
+                return None
+            else:
+                raise ValidationError(self.default_error_messages["required"])
+
+    def _deserialize(self, value, attr, data, **kwargs):
+        if value is not None:
+            return _timestamp_to_dt_aware(value)
+        else:
+            if not self.required:
+                return None
+            else:
+                raise ValidationError(self.default_error_messages["required"])
+
+
+class _IsoField(fields.Field):
+    def _serialize(self, value, attr, obj, **kwargs):
+        if value is not None:
+            return value.isoformat()
+        else:
+            if not self.required:
+                return None
+            else:
+                raise ValidationError(self.default_error_messages["required"])
+
+    def _deserialize(self, value, attr, data, **kwargs):
+        if value is not None:
+            return datetime.fromisoformat(value)
+        else:
+            if not self.required:
+                return None
+            else:
+                raise ValidationError(self.default_error_messages["required"])
+
+
+class _UnionField(fields.Field):
+    def __init__(self, desc, cls, field, *args, **kwargs):
+        self.desc = desc
+        self.cls = cls
+        self.field = field
+        super().__init__(*args, **kwargs)
+
+    def _serialize(self, value, attr, obj, **kwargs):
+        if self.allow_none and value is None:
+            return None
+        for type_, schema_ in self.desc.items():
+            if _issubclass_safe(type(value), type_):
+                if is_dataclass(value):
+                    res = schema_._serialize(value, attr, obj, **kwargs)
+                    res['__type'] = str(type_.__name__)
+                    return res
+                break
+            elif isinstance(value, _get_type_origin(type_)):
+                return schema_._serialize(value, attr, obj, **kwargs)
+        else:
+            warnings.warn(
+                f'The type "{type(value).__name__}" (value: "{value}") '
+                f'is not in the list of possible types of typing.Union '
+                f'(dataclass: {self.cls.__name__}, field: {self.field.name}). '
+                f'Value cannot be serialized properly.')
+        return super()._serialize(value, attr, obj, **kwargs)
+
+    def _deserialize(self, value, attr, data, **kwargs):
+        tmp_value = deepcopy(value)
+        if isinstance(tmp_value, dict) and '__type' in tmp_value:
+            dc_name = tmp_value['__type']
+            for type_, schema_ in self.desc.items():
+                if is_dataclass(type_) and type_.__name__ == dc_name:
+                    del tmp_value['__type']
+                    return schema_._deserialize(tmp_value, attr, data, **kwargs)
+        elif isinstance(tmp_value, dict):
+            warnings.warn(
+                f'Attempting to deserialize "dict" (value: "{tmp_value}) '
+                f'that does not have a "__type" type specifier field into'
+                f'(dataclass: {self.cls.__name__}, field: {self.field.name}).'
+                f'Deserialization may fail, or deserialization to wrong type may occur.'
+            )
+            return super()._deserialize(tmp_value, attr, data, **kwargs)
+        else:
+            for type_, schema_ in self.desc.items():
+                if isinstance(tmp_value, _get_type_origin(type_)):
+                    return schema_._deserialize(tmp_value, attr, data, **kwargs)
+            else:
+                warnings.warn(
+                    f'The type "{type(tmp_value).__name__}" (value: "{tmp_value}") '
+                    f'is not in the list of possible types of typing.Union '
+                    f'(dataclass: {self.cls.__name__}, field: {self.field.name}). '
+                    f'Value cannot be deserialized properly.')
+            return super()._deserialize(tmp_value, attr, data, **kwargs)
+
+
+class _TupleVarLen(fields.List):
+    """
+    variable-length homogeneous tuples
+    """
+    def _deserialize(self, value, attr, data, **kwargs):
+        optional_list = super()._deserialize(value, attr, data, **kwargs)
+        return None if optional_list is None else tuple(optional_list)
+
+
+TYPES = {
+    typing.Mapping: fields.Mapping,
+    typing.MutableMapping: fields.Mapping,
+    typing.List: fields.List,
+    typing.Dict: fields.Dict,
+    typing.Tuple: fields.Tuple,
+    typing.Callable: fields.Function,
+    typing.Any: fields.Raw,
+    dict: fields.Dict,
+    list: fields.List,
+    tuple: fields.Tuple,
+    str: fields.Str,
+    int: fields.Int,
+    float: fields.Float,
+    bool: fields.Bool,
+    datetime: _TimestampField,
+    UUID: fields.UUID,
+    Decimal: fields.Decimal,
+    CatchAllVar: fields.Dict,
+}
+
+A = typing.TypeVar('A')
+JsonData = typing.Union[str, bytes, bytearray]
+TEncoded = typing.Dict[str, typing.Any]
+TOneOrMulti = typing.Union[typing.List[A], A]
+TOneOrMultiEncoded = typing.Union[typing.List[TEncoded], TEncoded]
+
+if sys.version_info >= (3, 7) or typing.TYPE_CHECKING:
+    class SchemaF(Schema, typing.Generic[A]):
+        """Lift Schema into a type constructor"""
+
+        def __init__(self, *args, **kwargs):
+            """
+            Raises exception because this class should not be inherited.
+            This class is helper only.
+            """
+
+            super().__init__(*args, **kwargs)
+            raise NotImplementedError()
+
+        @typing.overload
+        def dump(self, obj: typing.List[A], many: typing.Optional[bool] = None) -> typing.List[TEncoded]:  # type: ignore
+            # mm has the wrong return type annotation (dict) so we can ignore the mypy error
+            pass
+
+        @typing.overload
+        def dump(self, obj: A, many: typing.Optional[bool] = None) -> TEncoded:
+            pass
+
+        def dump(self, obj: TOneOrMulti,    # type: ignore
+                 many: typing.Optional[bool] = None) -> TOneOrMultiEncoded:
+            pass
+
+        @typing.overload
+        def dumps(self, obj: typing.List[A], many: typing.Optional[bool] = None, *args,
+                  **kwargs) -> str:
+            pass
+
+        @typing.overload
+        def dumps(self, obj: A, many: typing.Optional[bool] = None, *args, **kwargs) -> str:
+            pass
+
+        def dumps(self, obj: TOneOrMulti, many: typing.Optional[bool] = None, *args,   # type: ignore
+                  **kwargs) -> str:
+            pass
+
+        @typing.overload  # type: ignore
+        def load(self, data: typing.List[TEncoded],
+                 many: bool = True, partial: typing.Optional[bool] = None,
+                 unknown: typing.Optional[str] = None) -> \
+                typing.List[A]:
+            # ignore the mypy error of the decorator because mm does not define lists as an allowed input type
+            pass
+
+        @typing.overload
+        def load(self, data: TEncoded,
+                 many: None = None, partial: typing.Optional[bool] = None,
+                 unknown: typing.Optional[str] = None) -> A:
+            pass
+
+        def load(self, data: TOneOrMultiEncoded,
+                 many: typing.Optional[bool] = None, partial: typing.Optional[bool] = None,
+                 unknown: typing.Optional[str] = None) -> TOneOrMulti:
+            pass
+
+        @typing.overload  # type: ignore
+        def loads(self, json_data: JsonData,  # type: ignore
+                  many: typing.Optional[bool] = True, partial: typing.Optional[bool] = None, unknown: typing.Optional[str] = None,
+                  **kwargs) -> typing.List[A]:
+            # ignore the mypy error of the decorator because mm does not define bytes as correct input data
+            # mm has the wrong return type annotation (dict) so we can ignore the mypy error
+            # for the return type overlap
+            pass
+
+        def loads(self, json_data: JsonData,
+                  many: typing.Optional[bool] = None, partial: typing.Optional[bool] = None, unknown: typing.Optional[str] = None,
+                  **kwargs) -> TOneOrMulti:
+            pass
+
+
+    SchemaType = SchemaF[A]
+else:
+    SchemaType = Schema
+
+
+def build_type(type_, options, mixin, field, cls):
+    def inner(type_, options):
+        while True:
+            if not _is_new_type(type_):
+                break
+
+            type_ = type_.__supertype__
+
+        if is_dataclass(type_):
+            if _issubclass_safe(type_, mixin):
+                options['field_many'] = bool(
+                    _is_supported_generic(field.type) and _is_collection(
+                        field.type))
+                return fields.Nested(type_.schema(), **options)
+            else:
+                warnings.warn(f"Nested dataclass field {field.name} of type "
+                              f"{field.type} detected in "
+                              f"{cls.__name__} that is not an instance of "
+                              f"dataclass_json. Did you mean to recursively "
+                              f"serialize this field? If so, make sure to "
+                              f"augment {type_} with either the "
+                              f"`dataclass_json` decorator or mixin.")
+                return fields.Field(**options)
+
+        origin = getattr(type_, '__origin__', type_)
+        args = [inner(a, {}) for a in getattr(type_, '__args__', []) if
+                a is not type(None)]
+
+        if type_ == Ellipsis:
+            return type_
+
+        if _is_optional(type_):
+            options["allow_none"] = True
+        if origin is tuple:
+            if len(args) == 2 and args[1] == Ellipsis:
+                return _TupleVarLen(args[0], **options)
+            else:
+                return fields.Tuple(args, **options)
+        if origin in TYPES:
+            return TYPES[origin](*args, **options)
+
+        if _issubclass_safe(origin, Enum):
+            return fields.Enum(enum=origin, by_value=True, *args, **options)
+
+        if is_union_type(type_):
+            union_types = [a for a in getattr(type_, '__args__', []) if
+                           a is not type(None)]
+            union_desc = dict(zip(union_types, args))
+            return _UnionField(union_desc, cls, field, **options)
+
+        warnings.warn(
+            f"Unknown type {type_} at {cls.__name__}.{field.name}: {field.type} "
+            f"It's advised to pass the correct marshmallow type to `mm_field`.")
+        return fields.Field(**options)
+
+    return inner(type_, options)
+
+
+def schema(cls, mixin, infer_missing):
+    schema = {}
+    overrides = _user_overrides_or_exts(cls)
+    # TODO check the undefined parameters and add the proper schema action
+    #  https://marshmallow.readthedocs.io/en/stable/quickstart.html
+    for field in dc_fields(cls):
+        metadata = overrides[field.name]
+        if metadata.mm_field is not None:
+            schema[field.name] = metadata.mm_field
+        else:
+            type_ = field.type
+            options: typing.Dict[str, typing.Any] = {}
+            missing_key = 'missing' if infer_missing else 'default'
+            if field.default is not MISSING:
+                options[missing_key] = field.default
+            elif field.default_factory is not MISSING:
+                options[missing_key] = field.default_factory()
+            else:
+                options['required'] = True
+
+            if options.get(missing_key, ...) is None:
+                options['allow_none'] = True
+
+            if _is_optional(type_):
+                options.setdefault(missing_key, None)
+                options['allow_none'] = True
+                if len(type_.__args__) == 2:
+                    # Union[str, int, None] is optional too, but it has more than 1 typed field.
+                    type_ = [tp for tp in type_.__args__ if tp is not type(None)][0]
+
+            if metadata.letter_case is not None:
+                options['data_key'] = metadata.letter_case(field.name)
+
+            t = build_type(type_, options, mixin, field, cls)
+            if field.metadata.get('dataclasses_json', {}).get('decoder'):
+                # If the field defines a custom decoder, it should completely replace the Marshmallow field's conversion
+                # logic.
+                # From Marshmallow's documentation for the _deserialize method:
+                # "Deserialize value. Concrete :class:`Field` classes should implement this method. "
+                # This is the method that Field implementations override to perform the actual deserialization logic.
+                # In this case we specifically override this method instead of `deserialize` to minimize potential
+                # side effects, and only cancel the actual value deserialization.
+                t._deserialize = lambda v, *_a, **_kw: v
+
+            # if type(t) is not fields.Field:  # If we use `isinstance` we would return nothing.
+            if field.type != typing.Optional[CatchAllVar]:
+                schema[field.name] = t
+
+    return schema
+
+
+def build_schema(cls: typing.Type[A],
+                 mixin,
+                 infer_missing,
+                 partial) -> typing.Type["SchemaType[A]"]:
+    Meta = type('Meta',
+                (),
+                {'fields': tuple(field.name for field in dc_fields(cls)  # type: ignore
+                                 if
+                                 field.name != 'dataclass_json_config' and field.type !=
+                                 typing.Optional[CatchAllVar]),
+                 # TODO #180
+                 # 'render_module': global_config.json_module
+                 })
+
+    @post_load
+    def make_instance(self, kvs, **kwargs):
+        return _decode_dataclass(cls, kvs, partial)
+
+    def dumps(self, *args, **kwargs):
+        if 'cls' not in kwargs:
+            kwargs['cls'] = _ExtendedEncoder
+
+        return Schema.dumps(self, *args, **kwargs)
+
+    def dump(self, obj, *, many=None):
+        many = self.many if many is None else bool(many)
+        dumped = Schema.dump(self, obj, many=many)
+        # TODO This is hacky, but the other option I can think of is to generate a different schema
+        #  depending on dump and load, which is even more hacky
+
+        # The only problem is the catch-all field, we can't statically create a schema for it,
+        # so we just update the dumped dict
+        if many:
+            for i, _obj in enumerate(obj):
+                dumped[i].update(
+                    _handle_undefined_parameters_safe(cls=_obj, kvs={},
+                                                      usage="dump"))
+        else:
+            dumped.update(_handle_undefined_parameters_safe(cls=obj, kvs={},
+                                                            usage="dump"))
+        return dumped
+
+    schema_ = schema(cls, mixin, infer_missing)
+    DataClassSchema: typing.Type["SchemaType[A]"] = type(
+        f'{cls.__name__.capitalize()}Schema',
+        (Schema,),
+        {'Meta': Meta,
+         f'make_{cls.__name__.lower()}': make_instance,
+         'dumps': dumps,
+         'dump': dump,
+         **schema_})
+
+    return DataClassSchema
diff --git a/llm/Lib/site-packages/dataclasses_json/py.typed b/llm/Lib/site-packages/dataclasses_json/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/dataclasses_json/stringcase.py b/llm/Lib/site-packages/dataclasses_json/stringcase.py
new file mode 100644
index 0000000000000000000000000000000000000000..da0f546f3c7cec1ad484bfb6ed4e47689aeab440
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json/stringcase.py
@@ -0,0 +1,130 @@
+# The MIT License (MIT)
+#
+# Copyright (c) 2015 Taka Okunishi
+#
+# 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
+# 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.
+#
+# Copyright © 2015-2018 Taka Okunishi <okunishinishi@gmail.com>.
+# Copyright © 2020 Louis-Philippe Véronneau <pollo@debian.org>
+
+import re
+
+
+def uplowcase(string, case):
+    """Convert string into upper or lower case.
+
+    Args:
+        string: String to convert.
+
+    Returns:
+        string: Uppercase or lowercase case string.
+
+    """
+    if case == 'up':
+        return str(string).upper()
+    elif case == 'low':
+        return str(string).lower()
+
+
+def capitalcase(string):
+    """Convert string into capital case.
+    First letters will be uppercase.
+
+    Args:
+        string: String to convert.
+
+    Returns:
+        string: Capital case string.
+
+    """
+
+    string = str(string)
+    if not string:
+        return string
+    return uplowcase(string[0], 'up') + string[1:]
+
+
+def camelcase(string):
+    """ Convert string into camel case.
+
+    Args:
+        string: String to convert.
+
+    Returns:
+        string: Camel case string.
+
+    """
+
+    string = re.sub(r"^[\-_\.]", '', str(string))
+    if not string:
+        return string
+    return (uplowcase(string[0], 'low')
+            + re.sub(r"[\-_\.\s]([a-z0-9])",
+                     lambda matched: uplowcase(matched.group(1), 'up'),
+                     string[1:]))
+
+
+def snakecase(string):
+    """Convert string into snake case.
+    Join punctuation with underscore
+
+    Args:
+        string: String to convert.
+
+    Returns:
+        string: Snake cased string.
+
+    """
+
+    string = re.sub(r"[\-\.\s]", '_', str(string))
+    if not string:
+        return string
+    return (uplowcase(string[0], 'low')
+            + re.sub(r"[A-Z0-9]",
+                     lambda matched: '_' + uplowcase(matched.group(0), 'low'),
+                     string[1:]))
+
+
+def spinalcase(string):
+    """Convert string into spinal case.
+    Join punctuation with hyphen.
+
+    Args:
+        string: String to convert.
+
+    Returns:
+        string: Spinal cased string.
+
+    """
+
+    return re.sub(r"_", "-", snakecase(string))
+
+
+def pascalcase(string):
+    """Convert string into pascal case.
+
+    Args:
+        string: String to convert.
+
+    Returns:
+        string: Pascal case string.
+
+    """
+
+    return capitalcase(camelcase(string))
diff --git a/llm/Lib/site-packages/dataclasses_json/undefined.py b/llm/Lib/site-packages/dataclasses_json/undefined.py
new file mode 100644
index 0000000000000000000000000000000000000000..cb8b2cfcde660729c8632c6f4f9d700a94e48890
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json/undefined.py
@@ -0,0 +1,280 @@
+import abc
+import dataclasses
+import functools
+import inspect
+import sys
+from dataclasses import Field, fields
+from typing import Any, Callable, Dict, Optional, Tuple, Union, Type, get_type_hints
+from enum import Enum
+
+from marshmallow.exceptions import ValidationError  # type: ignore
+
+from dataclasses_json.utils import CatchAllVar
+
+KnownParameters = Dict[str, Any]
+UnknownParameters = Dict[str, Any]
+
+
+class _UndefinedParameterAction(abc.ABC):
+    @staticmethod
+    @abc.abstractmethod
+    def handle_from_dict(cls, kvs: Dict[Any, Any]) -> Dict[str, Any]:
+        """
+        Return the parameters to initialize the class with.
+        """
+        pass
+
+    @staticmethod
+    def handle_to_dict(obj, kvs: Dict[Any, Any]) -> Dict[Any, Any]:
+        """
+        Return the parameters that will be written to the output dict
+        """
+        return kvs
+
+    @staticmethod
+    def handle_dump(obj) -> Dict[Any, Any]:
+        """
+        Return the parameters that will be added to the schema dump.
+        """
+        return {}
+
+    @staticmethod
+    def create_init(obj) -> Callable:
+        return obj.__init__
+
+    @staticmethod
+    def _separate_defined_undefined_kvs(cls, kvs: Dict) -> \
+            Tuple[KnownParameters, UnknownParameters]:
+        """
+        Returns a 2 dictionaries: defined and undefined parameters
+        """
+        class_fields = fields(cls)
+        field_names = [field.name for field in class_fields]
+        unknown_given_parameters = {k: v for k, v in kvs.items() if
+                                    k not in field_names}
+        known_given_parameters = {k: v for k, v in kvs.items() if
+                                  k in field_names}
+        return known_given_parameters, unknown_given_parameters
+
+
+class _RaiseUndefinedParameters(_UndefinedParameterAction):
+    """
+    This action raises UndefinedParameterError if it encounters an undefined
+    parameter during initialization.
+    """
+
+    @staticmethod
+    def handle_from_dict(cls, kvs: Dict) -> Dict[str, Any]:
+        known, unknown = \
+            _UndefinedParameterAction._separate_defined_undefined_kvs(
+                cls=cls, kvs=kvs)
+        if len(unknown) > 0:
+            raise UndefinedParameterError(
+                f"Received undefined initialization arguments {unknown}")
+        return known
+
+
+CatchAll = Optional[CatchAllVar]
+
+
+class _IgnoreUndefinedParameters(_UndefinedParameterAction):
+    """
+    This action does nothing when it encounters undefined parameters.
+    The undefined parameters can not be retrieved after the class has been
+    created.
+    """
+
+    @staticmethod
+    def handle_from_dict(cls, kvs: Dict) -> Dict[str, Any]:
+        known_given_parameters, _ = \
+            _UndefinedParameterAction._separate_defined_undefined_kvs(
+                cls=cls, kvs=kvs)
+        return known_given_parameters
+
+    @staticmethod
+    def create_init(obj) -> Callable:
+        original_init = obj.__init__
+        init_signature = inspect.signature(original_init)
+
+        @functools.wraps(obj.__init__)
+        def _ignore_init(self, *args, **kwargs):
+            known_kwargs, _ = \
+                _CatchAllUndefinedParameters._separate_defined_undefined_kvs(
+                    obj, kwargs)
+            num_params_takeable = len(
+                init_signature.parameters) - 1  # don't count self
+            num_args_takeable = num_params_takeable - len(known_kwargs)
+
+            args = args[:num_args_takeable]
+            bound_parameters = init_signature.bind_partial(self, *args,
+                                                           **known_kwargs)
+            bound_parameters.apply_defaults()
+
+            arguments = bound_parameters.arguments
+            arguments.pop("self", None)
+            final_parameters = \
+                _IgnoreUndefinedParameters.handle_from_dict(obj, arguments)
+            original_init(self, **final_parameters)
+
+        return _ignore_init
+
+
+class _CatchAllUndefinedParameters(_UndefinedParameterAction):
+    """
+    This class allows to add a field of type utils.CatchAll which acts as a
+    dictionary into which all
+    undefined parameters will be written.
+    These parameters are not affected by LetterCase.
+    If no undefined parameters are given, this dictionary will be empty.
+    """
+
+    class _SentinelNoDefault:
+        pass
+
+    @staticmethod
+    def handle_from_dict(cls, kvs: Dict) -> Dict[str, Any]:
+        known, unknown = _UndefinedParameterAction \
+            ._separate_defined_undefined_kvs(cls=cls, kvs=kvs)
+        catch_all_field = _CatchAllUndefinedParameters._get_catch_all_field(
+            cls=cls)
+
+        if catch_all_field.name in known:
+
+            already_parsed = isinstance(known[catch_all_field.name], dict)
+            default_value = _CatchAllUndefinedParameters._get_default(
+                catch_all_field=catch_all_field)
+            received_default = default_value == known[catch_all_field.name]
+
+            value_to_write: Any
+            if received_default and len(unknown) == 0:
+                value_to_write = default_value
+            elif received_default and len(unknown) > 0:
+                value_to_write = unknown
+            elif already_parsed:
+                # Did not receive default
+                value_to_write = known[catch_all_field.name]
+                if len(unknown) > 0:
+                    value_to_write.update(unknown)
+            else:
+                error_message = f"Received input field with " \
+                                f"same name as catch-all field: " \
+                                f"'{catch_all_field.name}': " \
+                                f"'{known[catch_all_field.name]}'"
+                raise UndefinedParameterError(error_message)
+        else:
+            value_to_write = unknown
+
+        known[catch_all_field.name] = value_to_write
+        return known
+
+    @staticmethod
+    def _get_default(catch_all_field: Field) -> Any:
+        # access to the default factory currently causes
+        # a false-positive mypy error (16. Dec 2019):
+        # https://github.com/python/mypy/issues/6910
+
+        # noinspection PyProtectedMember
+        has_default = not isinstance(catch_all_field.default,
+                                     dataclasses._MISSING_TYPE)
+        # noinspection PyProtectedMember
+        has_default_factory = not isinstance(catch_all_field.default_factory,
+                                             # type: ignore
+                                             dataclasses._MISSING_TYPE)
+        # TODO: black this for proper formatting
+        default_value: Union[
+            Type[_CatchAllUndefinedParameters._SentinelNoDefault], Any] = _CatchAllUndefinedParameters\
+            ._SentinelNoDefault
+
+        if has_default:
+            default_value = catch_all_field.default
+        elif has_default_factory:
+            # This might be unwanted if the default factory constructs
+            # something expensive,
+            # because we have to construct it again just for this test
+            default_value = catch_all_field.default_factory()  # type: ignore
+
+        return default_value
+
+    @staticmethod
+    def handle_to_dict(obj, kvs: Dict[Any, Any]) -> Dict[Any, Any]:
+        catch_all_field = \
+            _CatchAllUndefinedParameters._get_catch_all_field(obj.__class__)
+        undefined_parameters = kvs.pop(catch_all_field.name)
+        if isinstance(undefined_parameters, dict):
+            kvs.update(
+                undefined_parameters)  # If desired handle letter case here
+        return kvs
+
+    @staticmethod
+    def handle_dump(obj) -> Dict[Any, Any]:
+        catch_all_field = _CatchAllUndefinedParameters._get_catch_all_field(
+            cls=obj)
+        return getattr(obj, catch_all_field.name)
+
+    @staticmethod
+    def create_init(obj) -> Callable:
+        original_init = obj.__init__
+        init_signature = inspect.signature(original_init)
+
+        @functools.wraps(obj.__init__)
+        def _catch_all_init(self, *args, **kwargs):
+            known_kwargs, unknown_kwargs = \
+                _CatchAllUndefinedParameters._separate_defined_undefined_kvs(
+                    obj, kwargs)
+            num_params_takeable = len(
+                init_signature.parameters) - 1  # don't count self
+            if _CatchAllUndefinedParameters._get_catch_all_field(
+                    obj).name not in known_kwargs:
+                num_params_takeable -= 1
+            num_args_takeable = num_params_takeable - len(known_kwargs)
+
+            args, unknown_args = args[:num_args_takeable], args[
+                                                           num_args_takeable:]
+            bound_parameters = init_signature.bind_partial(self, *args,
+                                                           **known_kwargs)
+
+            unknown_args = {f"_UNKNOWN{i}": v for i, v in
+                            enumerate(unknown_args)}
+            arguments = bound_parameters.arguments
+            arguments.update(unknown_args)
+            arguments.update(unknown_kwargs)
+            arguments.pop("self", None)
+            final_parameters = _CatchAllUndefinedParameters.handle_from_dict(
+                obj, arguments)
+            original_init(self, **final_parameters)
+
+        return _catch_all_init
+
+    @staticmethod
+    def _get_catch_all_field(cls) -> Field:
+        cls_globals = vars(sys.modules[cls.__module__])
+        types = get_type_hints(cls, globalns=cls_globals)
+        catch_all_fields = list(
+            filter(lambda f: types[f.name] == Optional[CatchAllVar], fields(cls)))
+        number_of_catch_all_fields = len(catch_all_fields)
+        if number_of_catch_all_fields == 0:
+            raise UndefinedParameterError(
+                "No field of type dataclasses_json.CatchAll defined")
+        elif number_of_catch_all_fields > 1:
+            raise UndefinedParameterError(
+                f"Multiple catch-all fields supplied: "
+                f"{number_of_catch_all_fields}.")
+        else:
+            return catch_all_fields[0]
+
+
+class Undefined(Enum):
+    """
+    Choose the behavior what happens when an undefined parameter is encountered
+    during class initialization.
+    """
+    INCLUDE = _CatchAllUndefinedParameters
+    RAISE = _RaiseUndefinedParameters
+    EXCLUDE = _IgnoreUndefinedParameters
+
+
+class UndefinedParameterError(ValidationError):
+    """
+    Raised when something has gone wrong handling undefined parameters.
+    """
+    pass
diff --git a/llm/Lib/site-packages/dataclasses_json/utils.py b/llm/Lib/site-packages/dataclasses_json/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..942842ba8730843811969505dfaa2e5485ba3f9b
--- /dev/null
+++ b/llm/Lib/site-packages/dataclasses_json/utils.py
@@ -0,0 +1,214 @@
+import inspect
+import sys
+from datetime import datetime, timezone
+from collections import Counter
+from typing import (Collection, Mapping, Optional, TypeVar, Any, Type, Tuple,
+                    Union, cast)
+
+
+def _get_type_cons(type_):
+    """More spaghetti logic for 3.6 vs. 3.7"""
+    if sys.version_info.minor == 6:
+        try:
+            cons = type_.__extra__
+        except AttributeError:
+            try:
+                cons = type_.__origin__
+            except AttributeError:
+                cons = type_
+            else:
+                cons = type_ if cons is None else cons
+        else:
+            try:
+                cons = type_.__origin__ if cons is None else cons
+            except AttributeError:
+                cons = type_
+    else:
+        cons = type_.__origin__
+    return cons
+
+
+_NO_TYPE_ORIGIN = object()
+
+
+def _get_type_origin(type_):
+    """Some spaghetti logic to accommodate differences between 3.6 and 3.7 in
+    the typing api"""
+    try:
+        origin = type_.__origin__
+    except AttributeError:
+        # Issue #341 and PR #346:
+        # For some cases, the type_.__origin__ exists but is set to None
+        origin = _NO_TYPE_ORIGIN
+
+    if sys.version_info.minor == 6:
+        try:
+            origin = type_.__extra__
+        except AttributeError:
+            origin = type_
+        else:
+            origin = type_ if origin in (None, _NO_TYPE_ORIGIN) else origin
+    elif origin is _NO_TYPE_ORIGIN:
+        origin = type_
+    return origin
+
+
+def _hasargs(type_, *args):
+    try:
+        res = all(arg in type_.__args__ for arg in args)
+    except AttributeError:
+        return False
+    except TypeError:
+        if (type_.__args__ is None):
+            return False
+        else:
+            raise
+    else:
+        return res
+
+
+class _NoArgs(object):
+    def __bool__(self):
+        return False
+
+    def __len__(self):
+        return 0
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        raise StopIteration
+
+
+_NO_ARGS = _NoArgs()
+
+
+def _get_type_args(tp: Type, default: Union[Tuple[Type, ...], _NoArgs] = _NO_ARGS) -> \
+        Union[Tuple[Type, ...], _NoArgs]:
+    if hasattr(tp, '__args__'):
+        if tp.__args__ is not None:
+            return tp.__args__
+    return default
+
+
+def _get_type_arg_param(tp: Type, index: int) -> Union[Type, _NoArgs]:
+    _args = _get_type_args(tp)
+    if _args is not _NO_ARGS:
+        try:
+            return cast(Tuple[Type, ...], _args)[index]
+        except (TypeError, IndexError, NotImplementedError):
+            pass
+
+    return _NO_ARGS
+
+
+def _isinstance_safe(o, t):
+    try:
+        result = isinstance(o, t)
+    except Exception:
+        return False
+    else:
+        return result
+
+
+def _issubclass_safe(cls, classinfo):
+    try:
+        return issubclass(cls, classinfo)
+    except Exception:
+        return (_is_new_type_subclass_safe(cls, classinfo)
+                if _is_new_type(cls)
+                else False)
+
+
+def _is_new_type_subclass_safe(cls, classinfo):
+    super_type = getattr(cls, "__supertype__", None)
+
+    if super_type:
+        return _is_new_type_subclass_safe(super_type, classinfo)
+
+    try:
+        return issubclass(cls, classinfo)
+    except Exception:
+        return False
+
+
+def _is_new_type(type_):
+    return inspect.isfunction(type_) and hasattr(type_, "__supertype__")
+
+
+def _is_optional(type_):
+    return (_issubclass_safe(type_, Optional) or
+            _hasargs(type_, type(None)) or
+            type_ is Any)
+
+
+def _is_counter(type_):
+    return _issubclass_safe(_get_type_origin(type_), Counter)
+
+
+def _is_mapping(type_):
+    return _issubclass_safe(_get_type_origin(type_), Mapping)
+
+
+def _is_collection(type_):
+    return _issubclass_safe(_get_type_origin(type_), Collection)
+
+
+def _is_tuple(type_):
+    return _issubclass_safe(_get_type_origin(type_), Tuple)
+
+
+def _is_nonstr_collection(type_):
+    return (_issubclass_safe(_get_type_origin(type_), Collection)
+            and not _issubclass_safe(type_, str))
+
+
+def _timestamp_to_dt_aware(timestamp: float):
+    tz = datetime.now(timezone.utc).astimezone().tzinfo
+    dt = datetime.fromtimestamp(timestamp, tz=tz)
+    return dt
+
+
+def _undefined_parameter_action_safe(cls):
+    try:
+        if cls.dataclass_json_config is None:
+            return
+        action_enum = cls.dataclass_json_config['undefined']
+    except (AttributeError, KeyError):
+        return
+
+    if action_enum is None or action_enum.value is None:
+        return
+
+    return action_enum
+
+
+def _handle_undefined_parameters_safe(cls, kvs, usage: str):
+    """
+    Checks if an undefined parameters action is defined and performs the
+    according action.
+    """
+    undefined_parameter_action = _undefined_parameter_action_safe(cls)
+    usage = usage.lower()
+    if undefined_parameter_action is None:
+        return kvs if usage != "init" else cls.__init__
+    if usage == "from":
+        return undefined_parameter_action.value.handle_from_dict(cls=cls,
+                                                                 kvs=kvs)
+    elif usage == "to":
+        return undefined_parameter_action.value.handle_to_dict(obj=cls,
+                                                               kvs=kvs)
+    elif usage == "dump":
+        return undefined_parameter_action.value.handle_dump(obj=cls)
+    elif usage == "init":
+        return undefined_parameter_action.value.create_init(obj=cls)
+    else:
+        raise ValueError(
+            f"usage must be one of ['to', 'from', 'dump', 'init'], "
+            f"but is '{usage}'")
+
+
+# Define a type for the CatchAll field
+# https://stackoverflow.com/questions/59360567/define-a-custom-type-that-behaves-like-typing-any
+CatchAllVar = TypeVar("CatchAllVar", bound=Mapping)
diff --git a/llm/Lib/site-packages/dateutil/__init__.py b/llm/Lib/site-packages/dateutil/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a2c19c06fe14476a9bfa4f1f60de7a997a41191c
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+import sys
+
+try:
+    from ._version import version as __version__
+except ImportError:
+    __version__ = 'unknown'
+
+__all__ = ['easter', 'parser', 'relativedelta', 'rrule', 'tz',
+           'utils', 'zoneinfo']
+
+def __getattr__(name):
+    import importlib
+
+    if name in __all__:
+        return importlib.import_module("." + name, __name__)
+    raise AttributeError(
+        "module {!r} has not attribute {!r}".format(__name__, name)
+    )
+
+
+def __dir__():
+    # __dir__ should include all the lazy-importable modules as well.
+    return [x for x in globals() if x not in sys.modules] + __all__
diff --git a/llm/Lib/site-packages/dateutil/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/dateutil/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9bc8652dedf29730a133516e19371b770a18722b
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/__pycache__/_common.cpython-311.pyc b/llm/Lib/site-packages/dateutil/__pycache__/_common.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8f9edc1889248f20c06b8b475e814d06279122b0
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/__pycache__/_common.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/__pycache__/_version.cpython-311.pyc b/llm/Lib/site-packages/dateutil/__pycache__/_version.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cb64794fe8c7b4d73f6441ce5321e1e9bcfa982f
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/__pycache__/_version.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/__pycache__/easter.cpython-311.pyc b/llm/Lib/site-packages/dateutil/__pycache__/easter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0b01b0fcbe2375b4a6a4a51e1da7d4af4f925f75
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/__pycache__/easter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/__pycache__/relativedelta.cpython-311.pyc b/llm/Lib/site-packages/dateutil/__pycache__/relativedelta.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f53d49d0241af3773c8f03db6416985d4248826d
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/__pycache__/relativedelta.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/__pycache__/rrule.cpython-311.pyc b/llm/Lib/site-packages/dateutil/__pycache__/rrule.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1b0f644cbb39915e45f878bc50cdcddd0ccafbea
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/__pycache__/rrule.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/__pycache__/tzwin.cpython-311.pyc b/llm/Lib/site-packages/dateutil/__pycache__/tzwin.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..92bc752e4e6c5da7ed16bf14eb40d61f373acb57
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/__pycache__/tzwin.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/dateutil/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2a4cbf4464227a3f98de2a07469d8655ee76d291
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/_common.py b/llm/Lib/site-packages/dateutil/_common.py
new file mode 100644
index 0000000000000000000000000000000000000000..4eb2659bd2986125fcfb4afea5bae9efc2dcd1a0
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/_common.py
@@ -0,0 +1,43 @@
+"""
+Common code used in multiple modules.
+"""
+
+
+class weekday(object):
+    __slots__ = ["weekday", "n"]
+
+    def __init__(self, weekday, n=None):
+        self.weekday = weekday
+        self.n = n
+
+    def __call__(self, n):
+        if n == self.n:
+            return self
+        else:
+            return self.__class__(self.weekday, n)
+
+    def __eq__(self, other):
+        try:
+            if self.weekday != other.weekday or self.n != other.n:
+                return False
+        except AttributeError:
+            return False
+        return True
+
+    def __hash__(self):
+        return hash((
+          self.weekday,
+          self.n,
+        ))
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __repr__(self):
+        s = ("MO", "TU", "WE", "TH", "FR", "SA", "SU")[self.weekday]
+        if not self.n:
+            return s
+        else:
+            return "%s(%+d)" % (s, self.n)
+
+# vim:ts=4:sw=4:et
diff --git a/llm/Lib/site-packages/dateutil/_version.py b/llm/Lib/site-packages/dateutil/_version.py
new file mode 100644
index 0000000000000000000000000000000000000000..ddda98098527a73348e694c2edb691fd625475fc
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/_version.py
@@ -0,0 +1,4 @@
+# file generated by setuptools_scm
+# don't change, don't track in version control
+__version__ = version = '2.9.0.post0'
+__version_tuple__ = version_tuple = (2, 9, 0)
diff --git a/llm/Lib/site-packages/dateutil/easter.py b/llm/Lib/site-packages/dateutil/easter.py
new file mode 100644
index 0000000000000000000000000000000000000000..f74d1f7442473997245ac683b8a269a3574d1ba4
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/easter.py
@@ -0,0 +1,89 @@
+# -*- coding: utf-8 -*-
+"""
+This module offers a generic Easter computing method for any given year, using
+Western, Orthodox or Julian algorithms.
+"""
+
+import datetime
+
+__all__ = ["easter", "EASTER_JULIAN", "EASTER_ORTHODOX", "EASTER_WESTERN"]
+
+EASTER_JULIAN = 1
+EASTER_ORTHODOX = 2
+EASTER_WESTERN = 3
+
+
+def easter(year, method=EASTER_WESTERN):
+    """
+    This method was ported from the work done by GM Arts,
+    on top of the algorithm by Claus Tondering, which was
+    based in part on the algorithm of Ouding (1940), as
+    quoted in "Explanatory Supplement to the Astronomical
+    Almanac", P.  Kenneth Seidelmann, editor.
+
+    This algorithm implements three different Easter
+    calculation methods:
+
+    1. Original calculation in Julian calendar, valid in
+       dates after 326 AD
+    2. Original method, with date converted to Gregorian
+       calendar, valid in years 1583 to 4099
+    3. Revised method, in Gregorian calendar, valid in
+       years 1583 to 4099 as well
+
+    These methods are represented by the constants:
+
+    * ``EASTER_JULIAN   = 1``
+    * ``EASTER_ORTHODOX = 2``
+    * ``EASTER_WESTERN  = 3``
+
+    The default method is method 3.
+
+    More about the algorithm may be found at:
+
+    `GM Arts: Easter Algorithms <http://www.gmarts.org/index.php?go=415>`_
+
+    and
+
+    `The Calendar FAQ: Easter <https://www.tondering.dk/claus/cal/easter.php>`_
+
+    """
+
+    if not (1 <= method <= 3):
+        raise ValueError("invalid method")
+
+    # g - Golden year - 1
+    # c - Century
+    # h - (23 - Epact) mod 30
+    # i - Number of days from March 21 to Paschal Full Moon
+    # j - Weekday for PFM (0=Sunday, etc)
+    # p - Number of days from March 21 to Sunday on or before PFM
+    #     (-6 to 28 methods 1 & 3, to 56 for method 2)
+    # e - Extra days to add for method 2 (converting Julian
+    #     date to Gregorian date)
+
+    y = year
+    g = y % 19
+    e = 0
+    if method < 3:
+        # Old method
+        i = (19*g + 15) % 30
+        j = (y + y//4 + i) % 7
+        if method == 2:
+            # Extra dates to convert Julian to Gregorian date
+            e = 10
+            if y > 1600:
+                e = e + y//100 - 16 - (y//100 - 16)//4
+    else:
+        # New method
+        c = y//100
+        h = (c - c//4 - (8*c + 13)//25 + 19*g + 15) % 30
+        i = h - (h//28)*(1 - (h//28)*(29//(h + 1))*((21 - g)//11))
+        j = (y + y//4 + i + 2 - c + c//4) % 7
+
+    # p can be from -6 to 56 corresponding to dates 22 March to 23 May
+    # (later dates apply to method 2, although 23 May never actually occurs)
+    p = i - j + e
+    d = 1 + (p + 27 + (p + 6)//40) % 31
+    m = 3 + (p + 26)//30
+    return datetime.date(int(y), int(m), int(d))
diff --git a/llm/Lib/site-packages/dateutil/parser/__init__.py b/llm/Lib/site-packages/dateutil/parser/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d174b0e4dcc472999b75e55ebb88af320ae38081
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/parser/__init__.py
@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*-
+from ._parser import parse, parser, parserinfo, ParserError
+from ._parser import DEFAULTPARSER, DEFAULTTZPARSER
+from ._parser import UnknownTimezoneWarning
+
+from ._parser import __doc__
+
+from .isoparser import isoparser, isoparse
+
+__all__ = ['parse', 'parser', 'parserinfo',
+           'isoparse', 'isoparser',
+           'ParserError',
+           'UnknownTimezoneWarning']
+
+
+###
+# Deprecate portions of the private interface so that downstream code that
+# is improperly relying on it is given *some* notice.
+
+
+def __deprecated_private_func(f):
+    from functools import wraps
+    import warnings
+
+    msg = ('{name} is a private function and may break without warning, '
+           'it will be moved and or renamed in future versions.')
+    msg = msg.format(name=f.__name__)
+
+    @wraps(f)
+    def deprecated_func(*args, **kwargs):
+        warnings.warn(msg, DeprecationWarning)
+        return f(*args, **kwargs)
+
+    return deprecated_func
+
+def __deprecate_private_class(c):
+    import warnings
+
+    msg = ('{name} is a private class and may break without warning, '
+           'it will be moved and or renamed in future versions.')
+    msg = msg.format(name=c.__name__)
+
+    class private_class(c):
+        __doc__ = c.__doc__
+
+        def __init__(self, *args, **kwargs):
+            warnings.warn(msg, DeprecationWarning)
+            super(private_class, self).__init__(*args, **kwargs)
+
+    private_class.__name__ = c.__name__
+
+    return private_class
+
+
+from ._parser import _timelex, _resultbase
+from ._parser import _tzparser, _parsetz
+
+_timelex = __deprecate_private_class(_timelex)
+_tzparser = __deprecate_private_class(_tzparser)
+_resultbase = __deprecate_private_class(_resultbase)
+_parsetz = __deprecated_private_func(_parsetz)
diff --git a/llm/Lib/site-packages/dateutil/parser/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/dateutil/parser/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7bcbd751304f112eb991528836006a82e191f480
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/parser/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/parser/__pycache__/_parser.cpython-311.pyc b/llm/Lib/site-packages/dateutil/parser/__pycache__/_parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3a2d616608cfad94861f28718415dab35f9359d3
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/parser/__pycache__/_parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/parser/__pycache__/isoparser.cpython-311.pyc b/llm/Lib/site-packages/dateutil/parser/__pycache__/isoparser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8635bf33766de481b1e81661067172074d528be9
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/parser/__pycache__/isoparser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/parser/_parser.py b/llm/Lib/site-packages/dateutil/parser/_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..37d1663b2f72447800d9a553929e3de932244289
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/parser/_parser.py
@@ -0,0 +1,1613 @@
+# -*- coding: utf-8 -*-
+"""
+This module offers a generic date/time string parser which is able to parse
+most known formats to represent a date and/or time.
+
+This module attempts to be forgiving with regards to unlikely input formats,
+returning a datetime object even for dates which are ambiguous. If an element
+of a date/time stamp is omitted, the following rules are applied:
+
+- If AM or PM is left unspecified, a 24-hour clock is assumed, however, an hour
+  on a 12-hour clock (``0 <= hour <= 12``) *must* be specified if AM or PM is
+  specified.
+- If a time zone is omitted, a timezone-naive datetime is returned.
+
+If any other elements are missing, they are taken from the
+:class:`datetime.datetime` object passed to the parameter ``default``. If this
+results in a day number exceeding the valid number of days per month, the
+value falls back to the end of the month.
+
+Additional resources about date/time string formats can be found below:
+
+- `A summary of the international standard date and time notation
+  <https://www.cl.cam.ac.uk/~mgk25/iso-time.html>`_
+- `W3C Date and Time Formats <https://www.w3.org/TR/NOTE-datetime>`_
+- `Time Formats (Planetary Rings Node) <https://pds-rings.seti.org:443/tools/time_formats.html>`_
+- `CPAN ParseDate module
+  <https://metacpan.org/pod/release/MUIR/Time-modules-2013.0912/lib/Time/ParseDate.pm>`_
+- `Java SimpleDateFormat Class
+  <https://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>`_
+"""
+from __future__ import unicode_literals
+
+import datetime
+import re
+import string
+import time
+import warnings
+
+from calendar import monthrange
+from io import StringIO
+
+import six
+from six import integer_types, text_type
+
+from decimal import Decimal
+
+from warnings import warn
+
+from .. import relativedelta
+from .. import tz
+
+__all__ = ["parse", "parserinfo", "ParserError"]
+
+
+# TODO: pandas.core.tools.datetimes imports this explicitly.  Might be worth
+# making public and/or figuring out if there is something we can
+# take off their plate.
+class _timelex(object):
+    # Fractional seconds are sometimes split by a comma
+    _split_decimal = re.compile("([.,])")
+
+    def __init__(self, instream):
+        if isinstance(instream, (bytes, bytearray)):
+            instream = instream.decode()
+
+        if isinstance(instream, text_type):
+            instream = StringIO(instream)
+        elif getattr(instream, 'read', None) is None:
+            raise TypeError('Parser must be a string or character stream, not '
+                            '{itype}'.format(itype=instream.__class__.__name__))
+
+        self.instream = instream
+        self.charstack = []
+        self.tokenstack = []
+        self.eof = False
+
+    def get_token(self):
+        """
+        This function breaks the time string into lexical units (tokens), which
+        can be parsed by the parser. Lexical units are demarcated by changes in
+        the character set, so any continuous string of letters is considered
+        one unit, any continuous string of numbers is considered one unit.
+
+        The main complication arises from the fact that dots ('.') can be used
+        both as separators (e.g. "Sep.20.2009") or decimal points (e.g.
+        "4:30:21.447"). As such, it is necessary to read the full context of
+        any dot-separated strings before breaking it into tokens; as such, this
+        function maintains a "token stack", for when the ambiguous context
+        demands that multiple tokens be parsed at once.
+        """
+        if self.tokenstack:
+            return self.tokenstack.pop(0)
+
+        seenletters = False
+        token = None
+        state = None
+
+        while not self.eof:
+            # We only realize that we've reached the end of a token when we
+            # find a character that's not part of the current token - since
+            # that character may be part of the next token, it's stored in the
+            # charstack.
+            if self.charstack:
+                nextchar = self.charstack.pop(0)
+            else:
+                nextchar = self.instream.read(1)
+                while nextchar == '\x00':
+                    nextchar = self.instream.read(1)
+
+            if not nextchar:
+                self.eof = True
+                break
+            elif not state:
+                # First character of the token - determines if we're starting
+                # to parse a word, a number or something else.
+                token = nextchar
+                if self.isword(nextchar):
+                    state = 'a'
+                elif self.isnum(nextchar):
+                    state = '0'
+                elif self.isspace(nextchar):
+                    token = ' '
+                    break  # emit token
+                else:
+                    break  # emit token
+            elif state == 'a':
+                # If we've already started reading a word, we keep reading
+                # letters until we find something that's not part of a word.
+                seenletters = True
+                if self.isword(nextchar):
+                    token += nextchar
+                elif nextchar == '.':
+                    token += nextchar
+                    state = 'a.'
+                else:
+                    self.charstack.append(nextchar)
+                    break  # emit token
+            elif state == '0':
+                # If we've already started reading a number, we keep reading
+                # numbers until we find something that doesn't fit.
+                if self.isnum(nextchar):
+                    token += nextchar
+                elif nextchar == '.' or (nextchar == ',' and len(token) >= 2):
+                    token += nextchar
+                    state = '0.'
+                else:
+                    self.charstack.append(nextchar)
+                    break  # emit token
+            elif state == 'a.':
+                # If we've seen some letters and a dot separator, continue
+                # parsing, and the tokens will be broken up later.
+                seenletters = True
+                if nextchar == '.' or self.isword(nextchar):
+                    token += nextchar
+                elif self.isnum(nextchar) and token[-1] == '.':
+                    token += nextchar
+                    state = '0.'
+                else:
+                    self.charstack.append(nextchar)
+                    break  # emit token
+            elif state == '0.':
+                # If we've seen at least one dot separator, keep going, we'll
+                # break up the tokens later.
+                if nextchar == '.' or self.isnum(nextchar):
+                    token += nextchar
+                elif self.isword(nextchar) and token[-1] == '.':
+                    token += nextchar
+                    state = 'a.'
+                else:
+                    self.charstack.append(nextchar)
+                    break  # emit token
+
+        if (state in ('a.', '0.') and (seenletters or token.count('.') > 1 or
+                                       token[-1] in '.,')):
+            l = self._split_decimal.split(token)
+            token = l[0]
+            for tok in l[1:]:
+                if tok:
+                    self.tokenstack.append(tok)
+
+        if state == '0.' and token.count('.') == 0:
+            token = token.replace(',', '.')
+
+        return token
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        token = self.get_token()
+        if token is None:
+            raise StopIteration
+
+        return token
+
+    def next(self):
+        return self.__next__()  # Python 2.x support
+
+    @classmethod
+    def split(cls, s):
+        return list(cls(s))
+
+    @classmethod
+    def isword(cls, nextchar):
+        """ Whether or not the next character is part of a word """
+        return nextchar.isalpha()
+
+    @classmethod
+    def isnum(cls, nextchar):
+        """ Whether the next character is part of a number """
+        return nextchar.isdigit()
+
+    @classmethod
+    def isspace(cls, nextchar):
+        """ Whether the next character is whitespace """
+        return nextchar.isspace()
+
+
+class _resultbase(object):
+
+    def __init__(self):
+        for attr in self.__slots__:
+            setattr(self, attr, None)
+
+    def _repr(self, classname):
+        l = []
+        for attr in self.__slots__:
+            value = getattr(self, attr)
+            if value is not None:
+                l.append("%s=%s" % (attr, repr(value)))
+        return "%s(%s)" % (classname, ", ".join(l))
+
+    def __len__(self):
+        return (sum(getattr(self, attr) is not None
+                    for attr in self.__slots__))
+
+    def __repr__(self):
+        return self._repr(self.__class__.__name__)
+
+
+class parserinfo(object):
+    """
+    Class which handles what inputs are accepted. Subclass this to customize
+    the language and acceptable values for each parameter.
+
+    :param dayfirst:
+        Whether to interpret the first value in an ambiguous 3-integer date
+        (e.g. 01/05/09) as the day (``True``) or month (``False``). If
+        ``yearfirst`` is set to ``True``, this distinguishes between YDM
+        and YMD. Default is ``False``.
+
+    :param yearfirst:
+        Whether to interpret the first value in an ambiguous 3-integer date
+        (e.g. 01/05/09) as the year. If ``True``, the first number is taken
+        to be the year, otherwise the last number is taken to be the year.
+        Default is ``False``.
+    """
+
+    # m from a.m/p.m, t from ISO T separator
+    JUMP = [" ", ".", ",", ";", "-", "/", "'",
+            "at", "on", "and", "ad", "m", "t", "of",
+            "st", "nd", "rd", "th"]
+
+    WEEKDAYS = [("Mon", "Monday"),
+                ("Tue", "Tuesday"),     # TODO: "Tues"
+                ("Wed", "Wednesday"),
+                ("Thu", "Thursday"),    # TODO: "Thurs"
+                ("Fri", "Friday"),
+                ("Sat", "Saturday"),
+                ("Sun", "Sunday")]
+    MONTHS = [("Jan", "January"),
+              ("Feb", "February"),      # TODO: "Febr"
+              ("Mar", "March"),
+              ("Apr", "April"),
+              ("May", "May"),
+              ("Jun", "June"),
+              ("Jul", "July"),
+              ("Aug", "August"),
+              ("Sep", "Sept", "September"),
+              ("Oct", "October"),
+              ("Nov", "November"),
+              ("Dec", "December")]
+    HMS = [("h", "hour", "hours"),
+           ("m", "minute", "minutes"),
+           ("s", "second", "seconds")]
+    AMPM = [("am", "a"),
+            ("pm", "p")]
+    UTCZONE = ["UTC", "GMT", "Z", "z"]
+    PERTAIN = ["of"]
+    TZOFFSET = {}
+    # TODO: ERA = ["AD", "BC", "CE", "BCE", "Stardate",
+    #              "Anno Domini", "Year of Our Lord"]
+
+    def __init__(self, dayfirst=False, yearfirst=False):
+        self._jump = self._convert(self.JUMP)
+        self._weekdays = self._convert(self.WEEKDAYS)
+        self._months = self._convert(self.MONTHS)
+        self._hms = self._convert(self.HMS)
+        self._ampm = self._convert(self.AMPM)
+        self._utczone = self._convert(self.UTCZONE)
+        self._pertain = self._convert(self.PERTAIN)
+
+        self.dayfirst = dayfirst
+        self.yearfirst = yearfirst
+
+        self._year = time.localtime().tm_year
+        self._century = self._year // 100 * 100
+
+    def _convert(self, lst):
+        dct = {}
+        for i, v in enumerate(lst):
+            if isinstance(v, tuple):
+                for v in v:
+                    dct[v.lower()] = i
+            else:
+                dct[v.lower()] = i
+        return dct
+
+    def jump(self, name):
+        return name.lower() in self._jump
+
+    def weekday(self, name):
+        try:
+            return self._weekdays[name.lower()]
+        except KeyError:
+            pass
+        return None
+
+    def month(self, name):
+        try:
+            return self._months[name.lower()] + 1
+        except KeyError:
+            pass
+        return None
+
+    def hms(self, name):
+        try:
+            return self._hms[name.lower()]
+        except KeyError:
+            return None
+
+    def ampm(self, name):
+        try:
+            return self._ampm[name.lower()]
+        except KeyError:
+            return None
+
+    def pertain(self, name):
+        return name.lower() in self._pertain
+
+    def utczone(self, name):
+        return name.lower() in self._utczone
+
+    def tzoffset(self, name):
+        if name in self._utczone:
+            return 0
+
+        return self.TZOFFSET.get(name)
+
+    def convertyear(self, year, century_specified=False):
+        """
+        Converts two-digit years to year within [-50, 49]
+        range of self._year (current local time)
+        """
+
+        # Function contract is that the year is always positive
+        assert year >= 0
+
+        if year < 100 and not century_specified:
+            # assume current century to start
+            year += self._century
+
+            if year >= self._year + 50:  # if too far in future
+                year -= 100
+            elif year < self._year - 50:  # if too far in past
+                year += 100
+
+        return year
+
+    def validate(self, res):
+        # move to info
+        if res.year is not None:
+            res.year = self.convertyear(res.year, res.century_specified)
+
+        if ((res.tzoffset == 0 and not res.tzname) or
+             (res.tzname == 'Z' or res.tzname == 'z')):
+            res.tzname = "UTC"
+            res.tzoffset = 0
+        elif res.tzoffset != 0 and res.tzname and self.utczone(res.tzname):
+            res.tzoffset = 0
+        return True
+
+
+class _ymd(list):
+    def __init__(self, *args, **kwargs):
+        super(self.__class__, self).__init__(*args, **kwargs)
+        self.century_specified = False
+        self.dstridx = None
+        self.mstridx = None
+        self.ystridx = None
+
+    @property
+    def has_year(self):
+        return self.ystridx is not None
+
+    @property
+    def has_month(self):
+        return self.mstridx is not None
+
+    @property
+    def has_day(self):
+        return self.dstridx is not None
+
+    def could_be_day(self, value):
+        if self.has_day:
+            return False
+        elif not self.has_month:
+            return 1 <= value <= 31
+        elif not self.has_year:
+            # Be permissive, assume leap year
+            month = self[self.mstridx]
+            return 1 <= value <= monthrange(2000, month)[1]
+        else:
+            month = self[self.mstridx]
+            year = self[self.ystridx]
+            return 1 <= value <= monthrange(year, month)[1]
+
+    def append(self, val, label=None):
+        if hasattr(val, '__len__'):
+            if val.isdigit() and len(val) > 2:
+                self.century_specified = True
+                if label not in [None, 'Y']:  # pragma: no cover
+                    raise ValueError(label)
+                label = 'Y'
+        elif val > 100:
+            self.century_specified = True
+            if label not in [None, 'Y']:  # pragma: no cover
+                raise ValueError(label)
+            label = 'Y'
+
+        super(self.__class__, self).append(int(val))
+
+        if label == 'M':
+            if self.has_month:
+                raise ValueError('Month is already set')
+            self.mstridx = len(self) - 1
+        elif label == 'D':
+            if self.has_day:
+                raise ValueError('Day is already set')
+            self.dstridx = len(self) - 1
+        elif label == 'Y':
+            if self.has_year:
+                raise ValueError('Year is already set')
+            self.ystridx = len(self) - 1
+
+    def _resolve_from_stridxs(self, strids):
+        """
+        Try to resolve the identities of year/month/day elements using
+        ystridx, mstridx, and dstridx, if enough of these are specified.
+        """
+        if len(self) == 3 and len(strids) == 2:
+            # we can back out the remaining stridx value
+            missing = [x for x in range(3) if x not in strids.values()]
+            key = [x for x in ['y', 'm', 'd'] if x not in strids]
+            assert len(missing) == len(key) == 1
+            key = key[0]
+            val = missing[0]
+            strids[key] = val
+
+        assert len(self) == len(strids)  # otherwise this should not be called
+        out = {key: self[strids[key]] for key in strids}
+        return (out.get('y'), out.get('m'), out.get('d'))
+
+    def resolve_ymd(self, yearfirst, dayfirst):
+        len_ymd = len(self)
+        year, month, day = (None, None, None)
+
+        strids = (('y', self.ystridx),
+                  ('m', self.mstridx),
+                  ('d', self.dstridx))
+
+        strids = {key: val for key, val in strids if val is not None}
+        if (len(self) == len(strids) > 0 or
+                (len(self) == 3 and len(strids) == 2)):
+            return self._resolve_from_stridxs(strids)
+
+        mstridx = self.mstridx
+
+        if len_ymd > 3:
+            raise ValueError("More than three YMD values")
+        elif len_ymd == 1 or (mstridx is not None and len_ymd == 2):
+            # One member, or two members with a month string
+            if mstridx is not None:
+                month = self[mstridx]
+                # since mstridx is 0 or 1, self[mstridx-1] always
+                # looks up the other element
+                other = self[mstridx - 1]
+            else:
+                other = self[0]
+
+            if len_ymd > 1 or mstridx is None:
+                if other > 31:
+                    year = other
+                else:
+                    day = other
+
+        elif len_ymd == 2:
+            # Two members with numbers
+            if self[0] > 31:
+                # 99-01
+                year, month = self
+            elif self[1] > 31:
+                # 01-99
+                month, year = self
+            elif dayfirst and self[1] <= 12:
+                # 13-01
+                day, month = self
+            else:
+                # 01-13
+                month, day = self
+
+        elif len_ymd == 3:
+            # Three members
+            if mstridx == 0:
+                if self[1] > 31:
+                    # Apr-2003-25
+                    month, year, day = self
+                else:
+                    month, day, year = self
+            elif mstridx == 1:
+                if self[0] > 31 or (yearfirst and self[2] <= 31):
+                    # 99-Jan-01
+                    year, month, day = self
+                else:
+                    # 01-Jan-01
+                    # Give precedence to day-first, since
+                    # two-digit years is usually hand-written.
+                    day, month, year = self
+
+            elif mstridx == 2:
+                # WTF!?
+                if self[1] > 31:
+                    # 01-99-Jan
+                    day, year, month = self
+                else:
+                    # 99-01-Jan
+                    year, day, month = self
+
+            else:
+                if (self[0] > 31 or
+                    self.ystridx == 0 or
+                        (yearfirst and self[1] <= 12 and self[2] <= 31)):
+                    # 99-01-01
+                    if dayfirst and self[2] <= 12:
+                        year, day, month = self
+                    else:
+                        year, month, day = self
+                elif self[0] > 12 or (dayfirst and self[1] <= 12):
+                    # 13-01-01
+                    day, month, year = self
+                else:
+                    # 01-13-01
+                    month, day, year = self
+
+        return year, month, day
+
+
+class parser(object):
+    def __init__(self, info=None):
+        self.info = info or parserinfo()
+
+    def parse(self, timestr, default=None,
+              ignoretz=False, tzinfos=None, **kwargs):
+        """
+        Parse the date/time string into a :class:`datetime.datetime` object.
+
+        :param timestr:
+            Any date/time string using the supported formats.
+
+        :param default:
+            The default datetime object, if this is a datetime object and not
+            ``None``, elements specified in ``timestr`` replace elements in the
+            default object.
+
+        :param ignoretz:
+            If set ``True``, time zones in parsed strings are ignored and a
+            naive :class:`datetime.datetime` object is returned.
+
+        :param tzinfos:
+            Additional time zone names / aliases which may be present in the
+            string. This argument maps time zone names (and optionally offsets
+            from those time zones) to time zones. This parameter can be a
+            dictionary with timezone aliases mapping time zone names to time
+            zones or a function taking two parameters (``tzname`` and
+            ``tzoffset``) and returning a time zone.
+
+            The timezones to which the names are mapped can be an integer
+            offset from UTC in seconds or a :class:`tzinfo` object.
+
+            .. doctest::
+               :options: +NORMALIZE_WHITESPACE
+
+                >>> from dateutil.parser import parse
+                >>> from dateutil.tz import gettz
+                >>> tzinfos = {"BRST": -7200, "CST": gettz("America/Chicago")}
+                >>> parse("2012-01-19 17:21:00 BRST", tzinfos=tzinfos)
+                datetime.datetime(2012, 1, 19, 17, 21, tzinfo=tzoffset(u'BRST', -7200))
+                >>> parse("2012-01-19 17:21:00 CST", tzinfos=tzinfos)
+                datetime.datetime(2012, 1, 19, 17, 21,
+                                  tzinfo=tzfile('/usr/share/zoneinfo/America/Chicago'))
+
+            This parameter is ignored if ``ignoretz`` is set.
+
+        :param \\*\\*kwargs:
+            Keyword arguments as passed to ``_parse()``.
+
+        :return:
+            Returns a :class:`datetime.datetime` object or, if the
+            ``fuzzy_with_tokens`` option is ``True``, returns a tuple, the
+            first element being a :class:`datetime.datetime` object, the second
+            a tuple containing the fuzzy tokens.
+
+        :raises ParserError:
+            Raised for invalid or unknown string format, if the provided
+            :class:`tzinfo` is not in a valid format, or if an invalid date
+            would be created.
+
+        :raises TypeError:
+            Raised for non-string or character stream input.
+
+        :raises OverflowError:
+            Raised if the parsed date exceeds the largest valid C integer on
+            your system.
+        """
+
+        if default is None:
+            default = datetime.datetime.now().replace(hour=0, minute=0,
+                                                      second=0, microsecond=0)
+
+        res, skipped_tokens = self._parse(timestr, **kwargs)
+
+        if res is None:
+            raise ParserError("Unknown string format: %s", timestr)
+
+        if len(res) == 0:
+            raise ParserError("String does not contain a date: %s", timestr)
+
+        try:
+            ret = self._build_naive(res, default)
+        except ValueError as e:
+            six.raise_from(ParserError(str(e) + ": %s", timestr), e)
+
+        if not ignoretz:
+            ret = self._build_tzaware(ret, res, tzinfos)
+
+        if kwargs.get('fuzzy_with_tokens', False):
+            return ret, skipped_tokens
+        else:
+            return ret
+
+    class _result(_resultbase):
+        __slots__ = ["year", "month", "day", "weekday",
+                     "hour", "minute", "second", "microsecond",
+                     "tzname", "tzoffset", "ampm","any_unused_tokens"]
+
+    def _parse(self, timestr, dayfirst=None, yearfirst=None, fuzzy=False,
+               fuzzy_with_tokens=False):
+        """
+        Private method which performs the heavy lifting of parsing, called from
+        ``parse()``, which passes on its ``kwargs`` to this function.
+
+        :param timestr:
+            The string to parse.
+
+        :param dayfirst:
+            Whether to interpret the first value in an ambiguous 3-integer date
+            (e.g. 01/05/09) as the day (``True``) or month (``False``). If
+            ``yearfirst`` is set to ``True``, this distinguishes between YDM
+            and YMD. If set to ``None``, this value is retrieved from the
+            current :class:`parserinfo` object (which itself defaults to
+            ``False``).
+
+        :param yearfirst:
+            Whether to interpret the first value in an ambiguous 3-integer date
+            (e.g. 01/05/09) as the year. If ``True``, the first number is taken
+            to be the year, otherwise the last number is taken to be the year.
+            If this is set to ``None``, the value is retrieved from the current
+            :class:`parserinfo` object (which itself defaults to ``False``).
+
+        :param fuzzy:
+            Whether to allow fuzzy parsing, allowing for string like "Today is
+            January 1, 2047 at 8:21:00AM".
+
+        :param fuzzy_with_tokens:
+            If ``True``, ``fuzzy`` is automatically set to True, and the parser
+            will return a tuple where the first element is the parsed
+            :class:`datetime.datetime` datetimestamp and the second element is
+            a tuple containing the portions of the string which were ignored:
+
+            .. doctest::
+
+                >>> from dateutil.parser import parse
+                >>> parse("Today is January 1, 2047 at 8:21:00AM", fuzzy_with_tokens=True)
+                (datetime.datetime(2047, 1, 1, 8, 21), (u'Today is ', u' ', u'at '))
+
+        """
+        if fuzzy_with_tokens:
+            fuzzy = True
+
+        info = self.info
+
+        if dayfirst is None:
+            dayfirst = info.dayfirst
+
+        if yearfirst is None:
+            yearfirst = info.yearfirst
+
+        res = self._result()
+        l = _timelex.split(timestr)         # Splits the timestr into tokens
+
+        skipped_idxs = []
+
+        # year/month/day list
+        ymd = _ymd()
+
+        len_l = len(l)
+        i = 0
+        try:
+            while i < len_l:
+
+                # Check if it's a number
+                value_repr = l[i]
+                try:
+                    value = float(value_repr)
+                except ValueError:
+                    value = None
+
+                if value is not None:
+                    # Numeric token
+                    i = self._parse_numeric_token(l, i, info, ymd, res, fuzzy)
+
+                # Check weekday
+                elif info.weekday(l[i]) is not None:
+                    value = info.weekday(l[i])
+                    res.weekday = value
+
+                # Check month name
+                elif info.month(l[i]) is not None:
+                    value = info.month(l[i])
+                    ymd.append(value, 'M')
+
+                    if i + 1 < len_l:
+                        if l[i + 1] in ('-', '/'):
+                            # Jan-01[-99]
+                            sep = l[i + 1]
+                            ymd.append(l[i + 2])
+
+                            if i + 3 < len_l and l[i + 3] == sep:
+                                # Jan-01-99
+                                ymd.append(l[i + 4])
+                                i += 2
+
+                            i += 2
+
+                        elif (i + 4 < len_l and l[i + 1] == l[i + 3] == ' ' and
+                              info.pertain(l[i + 2])):
+                            # Jan of 01
+                            # In this case, 01 is clearly year
+                            if l[i + 4].isdigit():
+                                # Convert it here to become unambiguous
+                                value = int(l[i + 4])
+                                year = str(info.convertyear(value))
+                                ymd.append(year, 'Y')
+                            else:
+                                # Wrong guess
+                                pass
+                                # TODO: not hit in tests
+                            i += 4
+
+                # Check am/pm
+                elif info.ampm(l[i]) is not None:
+                    value = info.ampm(l[i])
+                    val_is_ampm = self._ampm_valid(res.hour, res.ampm, fuzzy)
+
+                    if val_is_ampm:
+                        res.hour = self._adjust_ampm(res.hour, value)
+                        res.ampm = value
+
+                    elif fuzzy:
+                        skipped_idxs.append(i)
+
+                # Check for a timezone name
+                elif self._could_be_tzname(res.hour, res.tzname, res.tzoffset, l[i]):
+                    res.tzname = l[i]
+                    res.tzoffset = info.tzoffset(res.tzname)
+
+                    # Check for something like GMT+3, or BRST+3. Notice
+                    # that it doesn't mean "I am 3 hours after GMT", but
+                    # "my time +3 is GMT". If found, we reverse the
+                    # logic so that timezone parsing code will get it
+                    # right.
+                    if i + 1 < len_l and l[i + 1] in ('+', '-'):
+                        l[i + 1] = ('+', '-')[l[i + 1] == '+']
+                        res.tzoffset = None
+                        if info.utczone(res.tzname):
+                            # With something like GMT+3, the timezone
+                            # is *not* GMT.
+                            res.tzname = None
+
+                # Check for a numbered timezone
+                elif res.hour is not None and l[i] in ('+', '-'):
+                    signal = (-1, 1)[l[i] == '+']
+                    len_li = len(l[i + 1])
+
+                    # TODO: check that l[i + 1] is integer?
+                    if len_li == 4:
+                        # -0300
+                        hour_offset = int(l[i + 1][:2])
+                        min_offset = int(l[i + 1][2:])
+                    elif i + 2 < len_l and l[i + 2] == ':':
+                        # -03:00
+                        hour_offset = int(l[i + 1])
+                        min_offset = int(l[i + 3])  # TODO: Check that l[i+3] is minute-like?
+                        i += 2
+                    elif len_li <= 2:
+                        # -[0]3
+                        hour_offset = int(l[i + 1][:2])
+                        min_offset = 0
+                    else:
+                        raise ValueError(timestr)
+
+                    res.tzoffset = signal * (hour_offset * 3600 + min_offset * 60)
+
+                    # Look for a timezone name between parenthesis
+                    if (i + 5 < len_l and
+                            info.jump(l[i + 2]) and l[i + 3] == '(' and
+                            l[i + 5] == ')' and
+                            3 <= len(l[i + 4]) and
+                            self._could_be_tzname(res.hour, res.tzname,
+                                                  None, l[i + 4])):
+                        # -0300 (BRST)
+                        res.tzname = l[i + 4]
+                        i += 4
+
+                    i += 1
+
+                # Check jumps
+                elif not (info.jump(l[i]) or fuzzy):
+                    raise ValueError(timestr)
+
+                else:
+                    skipped_idxs.append(i)
+                i += 1
+
+            # Process year/month/day
+            year, month, day = ymd.resolve_ymd(yearfirst, dayfirst)
+
+            res.century_specified = ymd.century_specified
+            res.year = year
+            res.month = month
+            res.day = day
+
+        except (IndexError, ValueError):
+            return None, None
+
+        if not info.validate(res):
+            return None, None
+
+        if fuzzy_with_tokens:
+            skipped_tokens = self._recombine_skipped(l, skipped_idxs)
+            return res, tuple(skipped_tokens)
+        else:
+            return res, None
+
+    def _parse_numeric_token(self, tokens, idx, info, ymd, res, fuzzy):
+        # Token is a number
+        value_repr = tokens[idx]
+        try:
+            value = self._to_decimal(value_repr)
+        except Exception as e:
+            six.raise_from(ValueError('Unknown numeric token'), e)
+
+        len_li = len(value_repr)
+
+        len_l = len(tokens)
+
+        if (len(ymd) == 3 and len_li in (2, 4) and
+            res.hour is None and
+            (idx + 1 >= len_l or
+             (tokens[idx + 1] != ':' and
+              info.hms(tokens[idx + 1]) is None))):
+            # 19990101T23[59]
+            s = tokens[idx]
+            res.hour = int(s[:2])
+
+            if len_li == 4:
+                res.minute = int(s[2:])
+
+        elif len_li == 6 or (len_li > 6 and tokens[idx].find('.') == 6):
+            # YYMMDD or HHMMSS[.ss]
+            s = tokens[idx]
+
+            if not ymd and '.' not in tokens[idx]:
+                ymd.append(s[:2])
+                ymd.append(s[2:4])
+                ymd.append(s[4:])
+            else:
+                # 19990101T235959[.59]
+
+                # TODO: Check if res attributes already set.
+                res.hour = int(s[:2])
+                res.minute = int(s[2:4])
+                res.second, res.microsecond = self._parsems(s[4:])
+
+        elif len_li in (8, 12, 14):
+            # YYYYMMDD
+            s = tokens[idx]
+            ymd.append(s[:4], 'Y')
+            ymd.append(s[4:6])
+            ymd.append(s[6:8])
+
+            if len_li > 8:
+                res.hour = int(s[8:10])
+                res.minute = int(s[10:12])
+
+                if len_li > 12:
+                    res.second = int(s[12:])
+
+        elif self._find_hms_idx(idx, tokens, info, allow_jump=True) is not None:
+            # HH[ ]h or MM[ ]m or SS[.ss][ ]s
+            hms_idx = self._find_hms_idx(idx, tokens, info, allow_jump=True)
+            (idx, hms) = self._parse_hms(idx, tokens, info, hms_idx)
+            if hms is not None:
+                # TODO: checking that hour/minute/second are not
+                # already set?
+                self._assign_hms(res, value_repr, hms)
+
+        elif idx + 2 < len_l and tokens[idx + 1] == ':':
+            # HH:MM[:SS[.ss]]
+            res.hour = int(value)
+            value = self._to_decimal(tokens[idx + 2])  # TODO: try/except for this?
+            (res.minute, res.second) = self._parse_min_sec(value)
+
+            if idx + 4 < len_l and tokens[idx + 3] == ':':
+                res.second, res.microsecond = self._parsems(tokens[idx + 4])
+
+                idx += 2
+
+            idx += 2
+
+        elif idx + 1 < len_l and tokens[idx + 1] in ('-', '/', '.'):
+            sep = tokens[idx + 1]
+            ymd.append(value_repr)
+
+            if idx + 2 < len_l and not info.jump(tokens[idx + 2]):
+                if tokens[idx + 2].isdigit():
+                    # 01-01[-01]
+                    ymd.append(tokens[idx + 2])
+                else:
+                    # 01-Jan[-01]
+                    value = info.month(tokens[idx + 2])
+
+                    if value is not None:
+                        ymd.append(value, 'M')
+                    else:
+                        raise ValueError()
+
+                if idx + 3 < len_l and tokens[idx + 3] == sep:
+                    # We have three members
+                    value = info.month(tokens[idx + 4])
+
+                    if value is not None:
+                        ymd.append(value, 'M')
+                    else:
+                        ymd.append(tokens[idx + 4])
+                    idx += 2
+
+                idx += 1
+            idx += 1
+
+        elif idx + 1 >= len_l or info.jump(tokens[idx + 1]):
+            if idx + 2 < len_l and info.ampm(tokens[idx + 2]) is not None:
+                # 12 am
+                hour = int(value)
+                res.hour = self._adjust_ampm(hour, info.ampm(tokens[idx + 2]))
+                idx += 1
+            else:
+                # Year, month or day
+                ymd.append(value)
+            idx += 1
+
+        elif info.ampm(tokens[idx + 1]) is not None and (0 <= value < 24):
+            # 12am
+            hour = int(value)
+            res.hour = self._adjust_ampm(hour, info.ampm(tokens[idx + 1]))
+            idx += 1
+
+        elif ymd.could_be_day(value):
+            ymd.append(value)
+
+        elif not fuzzy:
+            raise ValueError()
+
+        return idx
+
+    def _find_hms_idx(self, idx, tokens, info, allow_jump):
+        len_l = len(tokens)
+
+        if idx+1 < len_l and info.hms(tokens[idx+1]) is not None:
+            # There is an "h", "m", or "s" label following this token.  We take
+            # assign the upcoming label to the current token.
+            # e.g. the "12" in 12h"
+            hms_idx = idx + 1
+
+        elif (allow_jump and idx+2 < len_l and tokens[idx+1] == ' ' and
+              info.hms(tokens[idx+2]) is not None):
+            # There is a space and then an "h", "m", or "s" label.
+            # e.g. the "12" in "12 h"
+            hms_idx = idx + 2
+
+        elif idx > 0 and info.hms(tokens[idx-1]) is not None:
+            # There is a "h", "m", or "s" preceding this token.  Since neither
+            # of the previous cases was hit, there is no label following this
+            # token, so we use the previous label.
+            # e.g. the "04" in "12h04"
+            hms_idx = idx-1
+
+        elif (1 < idx == len_l-1 and tokens[idx-1] == ' ' and
+              info.hms(tokens[idx-2]) is not None):
+            # If we are looking at the final token, we allow for a
+            # backward-looking check to skip over a space.
+            # TODO: Are we sure this is the right condition here?
+            hms_idx = idx - 2
+
+        else:
+            hms_idx = None
+
+        return hms_idx
+
+    def _assign_hms(self, res, value_repr, hms):
+        # See GH issue #427, fixing float rounding
+        value = self._to_decimal(value_repr)
+
+        if hms == 0:
+            # Hour
+            res.hour = int(value)
+            if value % 1:
+                res.minute = int(60*(value % 1))
+
+        elif hms == 1:
+            (res.minute, res.second) = self._parse_min_sec(value)
+
+        elif hms == 2:
+            (res.second, res.microsecond) = self._parsems(value_repr)
+
+    def _could_be_tzname(self, hour, tzname, tzoffset, token):
+        return (hour is not None and
+                tzname is None and
+                tzoffset is None and
+                len(token) <= 5 and
+                (all(x in string.ascii_uppercase for x in token)
+                 or token in self.info.UTCZONE))
+
+    def _ampm_valid(self, hour, ampm, fuzzy):
+        """
+        For fuzzy parsing, 'a' or 'am' (both valid English words)
+        may erroneously trigger the AM/PM flag. Deal with that
+        here.
+        """
+        val_is_ampm = True
+
+        # If there's already an AM/PM flag, this one isn't one.
+        if fuzzy and ampm is not None:
+            val_is_ampm = False
+
+        # If AM/PM is found and hour is not, raise a ValueError
+        if hour is None:
+            if fuzzy:
+                val_is_ampm = False
+            else:
+                raise ValueError('No hour specified with AM or PM flag.')
+        elif not 0 <= hour <= 12:
+            # If AM/PM is found, it's a 12 hour clock, so raise
+            # an error for invalid range
+            if fuzzy:
+                val_is_ampm = False
+            else:
+                raise ValueError('Invalid hour specified for 12-hour clock.')
+
+        return val_is_ampm
+
+    def _adjust_ampm(self, hour, ampm):
+        if hour < 12 and ampm == 1:
+            hour += 12
+        elif hour == 12 and ampm == 0:
+            hour = 0
+        return hour
+
+    def _parse_min_sec(self, value):
+        # TODO: Every usage of this function sets res.second to the return
+        # value. Are there any cases where second will be returned as None and
+        # we *don't* want to set res.second = None?
+        minute = int(value)
+        second = None
+
+        sec_remainder = value % 1
+        if sec_remainder:
+            second = int(60 * sec_remainder)
+        return (minute, second)
+
+    def _parse_hms(self, idx, tokens, info, hms_idx):
+        # TODO: Is this going to admit a lot of false-positives for when we
+        # just happen to have digits and "h", "m" or "s" characters in non-date
+        # text?  I guess hex hashes won't have that problem, but there's plenty
+        # of random junk out there.
+        if hms_idx is None:
+            hms = None
+            new_idx = idx
+        elif hms_idx > idx:
+            hms = info.hms(tokens[hms_idx])
+            new_idx = hms_idx
+        else:
+            # Looking backwards, increment one.
+            hms = info.hms(tokens[hms_idx]) + 1
+            new_idx = idx
+
+        return (new_idx, hms)
+
+    # ------------------------------------------------------------------
+    # Handling for individual tokens.  These are kept as methods instead
+    #  of functions for the sake of customizability via subclassing.
+
+    def _parsems(self, value):
+        """Parse a I[.F] seconds value into (seconds, microseconds)."""
+        if "." not in value:
+            return int(value), 0
+        else:
+            i, f = value.split(".")
+            return int(i), int(f.ljust(6, "0")[:6])
+
+    def _to_decimal(self, val):
+        try:
+            decimal_value = Decimal(val)
+            # See GH 662, edge case, infinite value should not be converted
+            #  via `_to_decimal`
+            if not decimal_value.is_finite():
+                raise ValueError("Converted decimal value is infinite or NaN")
+        except Exception as e:
+            msg = "Could not convert %s to decimal" % val
+            six.raise_from(ValueError(msg), e)
+        else:
+            return decimal_value
+
+    # ------------------------------------------------------------------
+    # Post-Parsing construction of datetime output.  These are kept as
+    #  methods instead of functions for the sake of customizability via
+    #  subclassing.
+
+    def _build_tzinfo(self, tzinfos, tzname, tzoffset):
+        if callable(tzinfos):
+            tzdata = tzinfos(tzname, tzoffset)
+        else:
+            tzdata = tzinfos.get(tzname)
+        # handle case where tzinfo is paased an options that returns None
+        # eg tzinfos = {'BRST' : None}
+        if isinstance(tzdata, datetime.tzinfo) or tzdata is None:
+            tzinfo = tzdata
+        elif isinstance(tzdata, text_type):
+            tzinfo = tz.tzstr(tzdata)
+        elif isinstance(tzdata, integer_types):
+            tzinfo = tz.tzoffset(tzname, tzdata)
+        else:
+            raise TypeError("Offset must be tzinfo subclass, tz string, "
+                            "or int offset.")
+        return tzinfo
+
+    def _build_tzaware(self, naive, res, tzinfos):
+        if (callable(tzinfos) or (tzinfos and res.tzname in tzinfos)):
+            tzinfo = self._build_tzinfo(tzinfos, res.tzname, res.tzoffset)
+            aware = naive.replace(tzinfo=tzinfo)
+            aware = self._assign_tzname(aware, res.tzname)
+
+        elif res.tzname and res.tzname in time.tzname:
+            aware = naive.replace(tzinfo=tz.tzlocal())
+
+            # Handle ambiguous local datetime
+            aware = self._assign_tzname(aware, res.tzname)
+
+            # This is mostly relevant for winter GMT zones parsed in the UK
+            if (aware.tzname() != res.tzname and
+                    res.tzname in self.info.UTCZONE):
+                aware = aware.replace(tzinfo=tz.UTC)
+
+        elif res.tzoffset == 0:
+            aware = naive.replace(tzinfo=tz.UTC)
+
+        elif res.tzoffset:
+            aware = naive.replace(tzinfo=tz.tzoffset(res.tzname, res.tzoffset))
+
+        elif not res.tzname and not res.tzoffset:
+            # i.e. no timezone information was found.
+            aware = naive
+
+        elif res.tzname:
+            # tz-like string was parsed but we don't know what to do
+            # with it
+            warnings.warn("tzname {tzname} identified but not understood.  "
+                          "Pass `tzinfos` argument in order to correctly "
+                          "return a timezone-aware datetime.  In a future "
+                          "version, this will raise an "
+                          "exception.".format(tzname=res.tzname),
+                          category=UnknownTimezoneWarning)
+            aware = naive
+
+        return aware
+
+    def _build_naive(self, res, default):
+        repl = {}
+        for attr in ("year", "month", "day", "hour",
+                     "minute", "second", "microsecond"):
+            value = getattr(res, attr)
+            if value is not None:
+                repl[attr] = value
+
+        if 'day' not in repl:
+            # If the default day exceeds the last day of the month, fall back
+            # to the end of the month.
+            cyear = default.year if res.year is None else res.year
+            cmonth = default.month if res.month is None else res.month
+            cday = default.day if res.day is None else res.day
+
+            if cday > monthrange(cyear, cmonth)[1]:
+                repl['day'] = monthrange(cyear, cmonth)[1]
+
+        naive = default.replace(**repl)
+
+        if res.weekday is not None and not res.day:
+            naive = naive + relativedelta.relativedelta(weekday=res.weekday)
+
+        return naive
+
+    def _assign_tzname(self, dt, tzname):
+        if dt.tzname() != tzname:
+            new_dt = tz.enfold(dt, fold=1)
+            if new_dt.tzname() == tzname:
+                return new_dt
+
+        return dt
+
+    def _recombine_skipped(self, tokens, skipped_idxs):
+        """
+        >>> tokens = ["foo", " ", "bar", " ", "19June2000", "baz"]
+        >>> skipped_idxs = [0, 1, 2, 5]
+        >>> _recombine_skipped(tokens, skipped_idxs)
+        ["foo bar", "baz"]
+        """
+        skipped_tokens = []
+        for i, idx in enumerate(sorted(skipped_idxs)):
+            if i > 0 and idx - 1 == skipped_idxs[i - 1]:
+                skipped_tokens[-1] = skipped_tokens[-1] + tokens[idx]
+            else:
+                skipped_tokens.append(tokens[idx])
+
+        return skipped_tokens
+
+
+DEFAULTPARSER = parser()
+
+
+def parse(timestr, parserinfo=None, **kwargs):
+    """
+
+    Parse a string in one of the supported formats, using the
+    ``parserinfo`` parameters.
+
+    :param timestr:
+        A string containing a date/time stamp.
+
+    :param parserinfo:
+        A :class:`parserinfo` object containing parameters for the parser.
+        If ``None``, the default arguments to the :class:`parserinfo`
+        constructor are used.
+
+    The ``**kwargs`` parameter takes the following keyword arguments:
+
+    :param default:
+        The default datetime object, if this is a datetime object and not
+        ``None``, elements specified in ``timestr`` replace elements in the
+        default object.
+
+    :param ignoretz:
+        If set ``True``, time zones in parsed strings are ignored and a naive
+        :class:`datetime` object is returned.
+
+    :param tzinfos:
+        Additional time zone names / aliases which may be present in the
+        string. This argument maps time zone names (and optionally offsets
+        from those time zones) to time zones. This parameter can be a
+        dictionary with timezone aliases mapping time zone names to time
+        zones or a function taking two parameters (``tzname`` and
+        ``tzoffset``) and returning a time zone.
+
+        The timezones to which the names are mapped can be an integer
+        offset from UTC in seconds or a :class:`tzinfo` object.
+
+        .. doctest::
+           :options: +NORMALIZE_WHITESPACE
+
+            >>> from dateutil.parser import parse
+            >>> from dateutil.tz import gettz
+            >>> tzinfos = {"BRST": -7200, "CST": gettz("America/Chicago")}
+            >>> parse("2012-01-19 17:21:00 BRST", tzinfos=tzinfos)
+            datetime.datetime(2012, 1, 19, 17, 21, tzinfo=tzoffset(u'BRST', -7200))
+            >>> parse("2012-01-19 17:21:00 CST", tzinfos=tzinfos)
+            datetime.datetime(2012, 1, 19, 17, 21,
+                              tzinfo=tzfile('/usr/share/zoneinfo/America/Chicago'))
+
+        This parameter is ignored if ``ignoretz`` is set.
+
+    :param dayfirst:
+        Whether to interpret the first value in an ambiguous 3-integer date
+        (e.g. 01/05/09) as the day (``True``) or month (``False``). If
+        ``yearfirst`` is set to ``True``, this distinguishes between YDM and
+        YMD. If set to ``None``, this value is retrieved from the current
+        :class:`parserinfo` object (which itself defaults to ``False``).
+
+    :param yearfirst:
+        Whether to interpret the first value in an ambiguous 3-integer date
+        (e.g. 01/05/09) as the year. If ``True``, the first number is taken to
+        be the year, otherwise the last number is taken to be the year. If
+        this is set to ``None``, the value is retrieved from the current
+        :class:`parserinfo` object (which itself defaults to ``False``).
+
+    :param fuzzy:
+        Whether to allow fuzzy parsing, allowing for string like "Today is
+        January 1, 2047 at 8:21:00AM".
+
+    :param fuzzy_with_tokens:
+        If ``True``, ``fuzzy`` is automatically set to True, and the parser
+        will return a tuple where the first element is the parsed
+        :class:`datetime.datetime` datetimestamp and the second element is
+        a tuple containing the portions of the string which were ignored:
+
+        .. doctest::
+
+            >>> from dateutil.parser import parse
+            >>> parse("Today is January 1, 2047 at 8:21:00AM", fuzzy_with_tokens=True)
+            (datetime.datetime(2047, 1, 1, 8, 21), (u'Today is ', u' ', u'at '))
+
+    :return:
+        Returns a :class:`datetime.datetime` object or, if the
+        ``fuzzy_with_tokens`` option is ``True``, returns a tuple, the
+        first element being a :class:`datetime.datetime` object, the second
+        a tuple containing the fuzzy tokens.
+
+    :raises ParserError:
+        Raised for invalid or unknown string formats, if the provided
+        :class:`tzinfo` is not in a valid format, or if an invalid date would
+        be created.
+
+    :raises OverflowError:
+        Raised if the parsed date exceeds the largest valid C integer on
+        your system.
+    """
+    if parserinfo:
+        return parser(parserinfo).parse(timestr, **kwargs)
+    else:
+        return DEFAULTPARSER.parse(timestr, **kwargs)
+
+
+class _tzparser(object):
+
+    class _result(_resultbase):
+
+        __slots__ = ["stdabbr", "stdoffset", "dstabbr", "dstoffset",
+                     "start", "end"]
+
+        class _attr(_resultbase):
+            __slots__ = ["month", "week", "weekday",
+                         "yday", "jyday", "day", "time"]
+
+        def __repr__(self):
+            return self._repr("")
+
+        def __init__(self):
+            _resultbase.__init__(self)
+            self.start = self._attr()
+            self.end = self._attr()
+
+    def parse(self, tzstr):
+        res = self._result()
+        l = [x for x in re.split(r'([,:.]|[a-zA-Z]+|[0-9]+)',tzstr) if x]
+        used_idxs = list()
+        try:
+
+            len_l = len(l)
+
+            i = 0
+            while i < len_l:
+                # BRST+3[BRDT[+2]]
+                j = i
+                while j < len_l and not [x for x in l[j]
+                                         if x in "0123456789:,-+"]:
+                    j += 1
+                if j != i:
+                    if not res.stdabbr:
+                        offattr = "stdoffset"
+                        res.stdabbr = "".join(l[i:j])
+                    else:
+                        offattr = "dstoffset"
+                        res.dstabbr = "".join(l[i:j])
+
+                    for ii in range(j):
+                        used_idxs.append(ii)
+                    i = j
+                    if (i < len_l and (l[i] in ('+', '-') or l[i][0] in
+                                       "0123456789")):
+                        if l[i] in ('+', '-'):
+                            # Yes, that's right.  See the TZ variable
+                            # documentation.
+                            signal = (1, -1)[l[i] == '+']
+                            used_idxs.append(i)
+                            i += 1
+                        else:
+                            signal = -1
+                        len_li = len(l[i])
+                        if len_li == 4:
+                            # -0300
+                            setattr(res, offattr, (int(l[i][:2]) * 3600 +
+                                                   int(l[i][2:]) * 60) * signal)
+                        elif i + 1 < len_l and l[i + 1] == ':':
+                            # -03:00
+                            setattr(res, offattr,
+                                    (int(l[i]) * 3600 +
+                                     int(l[i + 2]) * 60) * signal)
+                            used_idxs.append(i)
+                            i += 2
+                        elif len_li <= 2:
+                            # -[0]3
+                            setattr(res, offattr,
+                                    int(l[i][:2]) * 3600 * signal)
+                        else:
+                            return None
+                        used_idxs.append(i)
+                        i += 1
+                    if res.dstabbr:
+                        break
+                else:
+                    break
+
+
+            if i < len_l:
+                for j in range(i, len_l):
+                    if l[j] == ';':
+                        l[j] = ','
+
+                assert l[i] == ','
+
+                i += 1
+
+            if i >= len_l:
+                pass
+            elif (8 <= l.count(',') <= 9 and
+                  not [y for x in l[i:] if x != ','
+                       for y in x if y not in "0123456789+-"]):
+                # GMT0BST,3,0,30,3600,10,0,26,7200[,3600]
+                for x in (res.start, res.end):
+                    x.month = int(l[i])
+                    used_idxs.append(i)
+                    i += 2
+                    if l[i] == '-':
+                        value = int(l[i + 1]) * -1
+                        used_idxs.append(i)
+                        i += 1
+                    else:
+                        value = int(l[i])
+                    used_idxs.append(i)
+                    i += 2
+                    if value:
+                        x.week = value
+                        x.weekday = (int(l[i]) - 1) % 7
+                    else:
+                        x.day = int(l[i])
+                    used_idxs.append(i)
+                    i += 2
+                    x.time = int(l[i])
+                    used_idxs.append(i)
+                    i += 2
+                if i < len_l:
+                    if l[i] in ('-', '+'):
+                        signal = (-1, 1)[l[i] == "+"]
+                        used_idxs.append(i)
+                        i += 1
+                    else:
+                        signal = 1
+                    used_idxs.append(i)
+                    res.dstoffset = (res.stdoffset + int(l[i]) * signal)
+
+                # This was a made-up format that is not in normal use
+                warn(('Parsed time zone "%s"' % tzstr) +
+                     'is in a non-standard dateutil-specific format, which ' +
+                     'is now deprecated; support for parsing this format ' +
+                     'will be removed in future versions. It is recommended ' +
+                     'that you switch to a standard format like the GNU ' +
+                     'TZ variable format.', tz.DeprecatedTzFormatWarning)
+            elif (l.count(',') == 2 and l[i:].count('/') <= 2 and
+                  not [y for x in l[i:] if x not in (',', '/', 'J', 'M',
+                                                     '.', '-', ':')
+                       for y in x if y not in "0123456789"]):
+                for x in (res.start, res.end):
+                    if l[i] == 'J':
+                        # non-leap year day (1 based)
+                        used_idxs.append(i)
+                        i += 1
+                        x.jyday = int(l[i])
+                    elif l[i] == 'M':
+                        # month[-.]week[-.]weekday
+                        used_idxs.append(i)
+                        i += 1
+                        x.month = int(l[i])
+                        used_idxs.append(i)
+                        i += 1
+                        assert l[i] in ('-', '.')
+                        used_idxs.append(i)
+                        i += 1
+                        x.week = int(l[i])
+                        if x.week == 5:
+                            x.week = -1
+                        used_idxs.append(i)
+                        i += 1
+                        assert l[i] in ('-', '.')
+                        used_idxs.append(i)
+                        i += 1
+                        x.weekday = (int(l[i]) - 1) % 7
+                    else:
+                        # year day (zero based)
+                        x.yday = int(l[i]) + 1
+
+                    used_idxs.append(i)
+                    i += 1
+
+                    if i < len_l and l[i] == '/':
+                        used_idxs.append(i)
+                        i += 1
+                        # start time
+                        len_li = len(l[i])
+                        if len_li == 4:
+                            # -0300
+                            x.time = (int(l[i][:2]) * 3600 +
+                                      int(l[i][2:]) * 60)
+                        elif i + 1 < len_l and l[i + 1] == ':':
+                            # -03:00
+                            x.time = int(l[i]) * 3600 + int(l[i + 2]) * 60
+                            used_idxs.append(i)
+                            i += 2
+                            if i + 1 < len_l and l[i + 1] == ':':
+                                used_idxs.append(i)
+                                i += 2
+                                x.time += int(l[i])
+                        elif len_li <= 2:
+                            # -[0]3
+                            x.time = (int(l[i][:2]) * 3600)
+                        else:
+                            return None
+                        used_idxs.append(i)
+                        i += 1
+
+                    assert i == len_l or l[i] == ','
+
+                    i += 1
+
+                assert i >= len_l
+
+        except (IndexError, ValueError, AssertionError):
+            return None
+
+        unused_idxs = set(range(len_l)).difference(used_idxs)
+        res.any_unused_tokens = not {l[n] for n in unused_idxs}.issubset({",",":"})
+        return res
+
+
+DEFAULTTZPARSER = _tzparser()
+
+
+def _parsetz(tzstr):
+    return DEFAULTTZPARSER.parse(tzstr)
+
+
+class ParserError(ValueError):
+    """Exception subclass used for any failure to parse a datetime string.
+
+    This is a subclass of :py:exc:`ValueError`, and should be raised any time
+    earlier versions of ``dateutil`` would have raised ``ValueError``.
+
+    .. versionadded:: 2.8.1
+    """
+    def __str__(self):
+        try:
+            return self.args[0] % self.args[1:]
+        except (TypeError, IndexError):
+            return super(ParserError, self).__str__()
+
+    def __repr__(self):
+        args = ", ".join("'%s'" % arg for arg in self.args)
+        return "%s(%s)" % (self.__class__.__name__, args)
+
+
+class UnknownTimezoneWarning(RuntimeWarning):
+    """Raised when the parser finds a timezone it cannot parse into a tzinfo.
+
+    .. versionadded:: 2.7.0
+    """
+# vim:ts=4:sw=4:et
diff --git a/llm/Lib/site-packages/dateutil/parser/isoparser.py b/llm/Lib/site-packages/dateutil/parser/isoparser.py
new file mode 100644
index 0000000000000000000000000000000000000000..7060087df4776a07347cbb60127a70db393e3a65
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/parser/isoparser.py
@@ -0,0 +1,416 @@
+# -*- coding: utf-8 -*-
+"""
+This module offers a parser for ISO-8601 strings
+
+It is intended to support all valid date, time and datetime formats per the
+ISO-8601 specification.
+
+..versionadded:: 2.7.0
+"""
+from datetime import datetime, timedelta, time, date
+import calendar
+from dateutil import tz
+
+from functools import wraps
+
+import re
+import six
+
+__all__ = ["isoparse", "isoparser"]
+
+
+def _takes_ascii(f):
+    @wraps(f)
+    def func(self, str_in, *args, **kwargs):
+        # If it's a stream, read the whole thing
+        str_in = getattr(str_in, 'read', lambda: str_in)()
+
+        # If it's unicode, turn it into bytes, since ISO-8601 only covers ASCII
+        if isinstance(str_in, six.text_type):
+            # ASCII is the same in UTF-8
+            try:
+                str_in = str_in.encode('ascii')
+            except UnicodeEncodeError as e:
+                msg = 'ISO-8601 strings should contain only ASCII characters'
+                six.raise_from(ValueError(msg), e)
+
+        return f(self, str_in, *args, **kwargs)
+
+    return func
+
+
+class isoparser(object):
+    def __init__(self, sep=None):
+        """
+        :param sep:
+            A single character that separates date and time portions. If
+            ``None``, the parser will accept any single character.
+            For strict ISO-8601 adherence, pass ``'T'``.
+        """
+        if sep is not None:
+            if (len(sep) != 1 or ord(sep) >= 128 or sep in '0123456789'):
+                raise ValueError('Separator must be a single, non-numeric ' +
+                                 'ASCII character')
+
+            sep = sep.encode('ascii')
+
+        self._sep = sep
+
+    @_takes_ascii
+    def isoparse(self, dt_str):
+        """
+        Parse an ISO-8601 datetime string into a :class:`datetime.datetime`.
+
+        An ISO-8601 datetime string consists of a date portion, followed
+        optionally by a time portion - the date and time portions are separated
+        by a single character separator, which is ``T`` in the official
+        standard. Incomplete date formats (such as ``YYYY-MM``) may *not* be
+        combined with a time portion.
+
+        Supported date formats are:
+
+        Common:
+
+        - ``YYYY``
+        - ``YYYY-MM``
+        - ``YYYY-MM-DD`` or ``YYYYMMDD``
+
+        Uncommon:
+
+        - ``YYYY-Www`` or ``YYYYWww`` - ISO week (day defaults to 0)
+        - ``YYYY-Www-D`` or ``YYYYWwwD`` - ISO week and day
+
+        The ISO week and day numbering follows the same logic as
+        :func:`datetime.date.isocalendar`.
+
+        Supported time formats are:
+
+        - ``hh``
+        - ``hh:mm`` or ``hhmm``
+        - ``hh:mm:ss`` or ``hhmmss``
+        - ``hh:mm:ss.ssssss`` (Up to 6 sub-second digits)
+
+        Midnight is a special case for `hh`, as the standard supports both
+        00:00 and 24:00 as a representation. The decimal separator can be
+        either a dot or a comma.
+
+
+        .. caution::
+
+            Support for fractional components other than seconds is part of the
+            ISO-8601 standard, but is not currently implemented in this parser.
+
+        Supported time zone offset formats are:
+
+        - `Z` (UTC)
+        - `±HH:MM`
+        - `±HHMM`
+        - `±HH`
+
+        Offsets will be represented as :class:`dateutil.tz.tzoffset` objects,
+        with the exception of UTC, which will be represented as
+        :class:`dateutil.tz.tzutc`. Time zone offsets equivalent to UTC (such
+        as `+00:00`) will also be represented as :class:`dateutil.tz.tzutc`.
+
+        :param dt_str:
+            A string or stream containing only an ISO-8601 datetime string
+
+        :return:
+            Returns a :class:`datetime.datetime` representing the string.
+            Unspecified components default to their lowest value.
+
+        .. warning::
+
+            As of version 2.7.0, the strictness of the parser should not be
+            considered a stable part of the contract. Any valid ISO-8601 string
+            that parses correctly with the default settings will continue to
+            parse correctly in future versions, but invalid strings that
+            currently fail (e.g. ``2017-01-01T00:00+00:00:00``) are not
+            guaranteed to continue failing in future versions if they encode
+            a valid date.
+
+        .. versionadded:: 2.7.0
+        """
+        components, pos = self._parse_isodate(dt_str)
+
+        if len(dt_str) > pos:
+            if self._sep is None or dt_str[pos:pos + 1] == self._sep:
+                components += self._parse_isotime(dt_str[pos + 1:])
+            else:
+                raise ValueError('String contains unknown ISO components')
+
+        if len(components) > 3 and components[3] == 24:
+            components[3] = 0
+            return datetime(*components) + timedelta(days=1)
+
+        return datetime(*components)
+
+    @_takes_ascii
+    def parse_isodate(self, datestr):
+        """
+        Parse the date portion of an ISO string.
+
+        :param datestr:
+            The string portion of an ISO string, without a separator
+
+        :return:
+            Returns a :class:`datetime.date` object
+        """
+        components, pos = self._parse_isodate(datestr)
+        if pos < len(datestr):
+            raise ValueError('String contains unknown ISO ' +
+                             'components: {!r}'.format(datestr.decode('ascii')))
+        return date(*components)
+
+    @_takes_ascii
+    def parse_isotime(self, timestr):
+        """
+        Parse the time portion of an ISO string.
+
+        :param timestr:
+            The time portion of an ISO string, without a separator
+
+        :return:
+            Returns a :class:`datetime.time` object
+        """
+        components = self._parse_isotime(timestr)
+        if components[0] == 24:
+            components[0] = 0
+        return time(*components)
+
+    @_takes_ascii
+    def parse_tzstr(self, tzstr, zero_as_utc=True):
+        """
+        Parse a valid ISO time zone string.
+
+        See :func:`isoparser.isoparse` for details on supported formats.
+
+        :param tzstr:
+            A string representing an ISO time zone offset
+
+        :param zero_as_utc:
+            Whether to return :class:`dateutil.tz.tzutc` for zero-offset zones
+
+        :return:
+            Returns :class:`dateutil.tz.tzoffset` for offsets and
+            :class:`dateutil.tz.tzutc` for ``Z`` and (if ``zero_as_utc`` is
+            specified) offsets equivalent to UTC.
+        """
+        return self._parse_tzstr(tzstr, zero_as_utc=zero_as_utc)
+
+    # Constants
+    _DATE_SEP = b'-'
+    _TIME_SEP = b':'
+    _FRACTION_REGEX = re.compile(b'[\\.,]([0-9]+)')
+
+    def _parse_isodate(self, dt_str):
+        try:
+            return self._parse_isodate_common(dt_str)
+        except ValueError:
+            return self._parse_isodate_uncommon(dt_str)
+
+    def _parse_isodate_common(self, dt_str):
+        len_str = len(dt_str)
+        components = [1, 1, 1]
+
+        if len_str < 4:
+            raise ValueError('ISO string too short')
+
+        # Year
+        components[0] = int(dt_str[0:4])
+        pos = 4
+        if pos >= len_str:
+            return components, pos
+
+        has_sep = dt_str[pos:pos + 1] == self._DATE_SEP
+        if has_sep:
+            pos += 1
+
+        # Month
+        if len_str - pos < 2:
+            raise ValueError('Invalid common month')
+
+        components[1] = int(dt_str[pos:pos + 2])
+        pos += 2
+
+        if pos >= len_str:
+            if has_sep:
+                return components, pos
+            else:
+                raise ValueError('Invalid ISO format')
+
+        if has_sep:
+            if dt_str[pos:pos + 1] != self._DATE_SEP:
+                raise ValueError('Invalid separator in ISO string')
+            pos += 1
+
+        # Day
+        if len_str - pos < 2:
+            raise ValueError('Invalid common day')
+        components[2] = int(dt_str[pos:pos + 2])
+        return components, pos + 2
+
+    def _parse_isodate_uncommon(self, dt_str):
+        if len(dt_str) < 4:
+            raise ValueError('ISO string too short')
+
+        # All ISO formats start with the year
+        year = int(dt_str[0:4])
+
+        has_sep = dt_str[4:5] == self._DATE_SEP
+
+        pos = 4 + has_sep       # Skip '-' if it's there
+        if dt_str[pos:pos + 1] == b'W':
+            # YYYY-?Www-?D?
+            pos += 1
+            weekno = int(dt_str[pos:pos + 2])
+            pos += 2
+
+            dayno = 1
+            if len(dt_str) > pos:
+                if (dt_str[pos:pos + 1] == self._DATE_SEP) != has_sep:
+                    raise ValueError('Inconsistent use of dash separator')
+
+                pos += has_sep
+
+                dayno = int(dt_str[pos:pos + 1])
+                pos += 1
+
+            base_date = self._calculate_weekdate(year, weekno, dayno)
+        else:
+            # YYYYDDD or YYYY-DDD
+            if len(dt_str) - pos < 3:
+                raise ValueError('Invalid ordinal day')
+
+            ordinal_day = int(dt_str[pos:pos + 3])
+            pos += 3
+
+            if ordinal_day < 1 or ordinal_day > (365 + calendar.isleap(year)):
+                raise ValueError('Invalid ordinal day' +
+                                 ' {} for year {}'.format(ordinal_day, year))
+
+            base_date = date(year, 1, 1) + timedelta(days=ordinal_day - 1)
+
+        components = [base_date.year, base_date.month, base_date.day]
+        return components, pos
+
+    def _calculate_weekdate(self, year, week, day):
+        """
+        Calculate the day of corresponding to the ISO year-week-day calendar.
+
+        This function is effectively the inverse of
+        :func:`datetime.date.isocalendar`.
+
+        :param year:
+            The year in the ISO calendar
+
+        :param week:
+            The week in the ISO calendar - range is [1, 53]
+
+        :param day:
+            The day in the ISO calendar - range is [1 (MON), 7 (SUN)]
+
+        :return:
+            Returns a :class:`datetime.date`
+        """
+        if not 0 < week < 54:
+            raise ValueError('Invalid week: {}'.format(week))
+
+        if not 0 < day < 8:     # Range is 1-7
+            raise ValueError('Invalid weekday: {}'.format(day))
+
+        # Get week 1 for the specific year:
+        jan_4 = date(year, 1, 4)   # Week 1 always has January 4th in it
+        week_1 = jan_4 - timedelta(days=jan_4.isocalendar()[2] - 1)
+
+        # Now add the specific number of weeks and days to get what we want
+        week_offset = (week - 1) * 7 + (day - 1)
+        return week_1 + timedelta(days=week_offset)
+
+    def _parse_isotime(self, timestr):
+        len_str = len(timestr)
+        components = [0, 0, 0, 0, None]
+        pos = 0
+        comp = -1
+
+        if len_str < 2:
+            raise ValueError('ISO time too short')
+
+        has_sep = False
+
+        while pos < len_str and comp < 5:
+            comp += 1
+
+            if timestr[pos:pos + 1] in b'-+Zz':
+                # Detect time zone boundary
+                components[-1] = self._parse_tzstr(timestr[pos:])
+                pos = len_str
+                break
+
+            if comp == 1 and timestr[pos:pos+1] == self._TIME_SEP:
+                has_sep = True
+                pos += 1
+            elif comp == 2 and has_sep:
+                if timestr[pos:pos+1] != self._TIME_SEP:
+                    raise ValueError('Inconsistent use of colon separator')
+                pos += 1
+
+            if comp < 3:
+                # Hour, minute, second
+                components[comp] = int(timestr[pos:pos + 2])
+                pos += 2
+
+            if comp == 3:
+                # Fraction of a second
+                frac = self._FRACTION_REGEX.match(timestr[pos:])
+                if not frac:
+                    continue
+
+                us_str = frac.group(1)[:6]  # Truncate to microseconds
+                components[comp] = int(us_str) * 10**(6 - len(us_str))
+                pos += len(frac.group())
+
+        if pos < len_str:
+            raise ValueError('Unused components in ISO string')
+
+        if components[0] == 24:
+            # Standard supports 00:00 and 24:00 as representations of midnight
+            if any(component != 0 for component in components[1:4]):
+                raise ValueError('Hour may only be 24 at 24:00:00.000')
+
+        return components
+
+    def _parse_tzstr(self, tzstr, zero_as_utc=True):
+        if tzstr == b'Z' or tzstr == b'z':
+            return tz.UTC
+
+        if len(tzstr) not in {3, 5, 6}:
+            raise ValueError('Time zone offset must be 1, 3, 5 or 6 characters')
+
+        if tzstr[0:1] == b'-':
+            mult = -1
+        elif tzstr[0:1] == b'+':
+            mult = 1
+        else:
+            raise ValueError('Time zone offset requires sign')
+
+        hours = int(tzstr[1:3])
+        if len(tzstr) == 3:
+            minutes = 0
+        else:
+            minutes = int(tzstr[(4 if tzstr[3:4] == self._TIME_SEP else 3):])
+
+        if zero_as_utc and hours == 0 and minutes == 0:
+            return tz.UTC
+        else:
+            if minutes > 59:
+                raise ValueError('Invalid minutes in time zone offset')
+
+            if hours > 23:
+                raise ValueError('Invalid hours in time zone offset')
+
+            return tz.tzoffset(None, mult * (hours * 60 + minutes) * 60)
+
+
+DEFAULT_ISOPARSER = isoparser()
+isoparse = DEFAULT_ISOPARSER.isoparse
diff --git a/llm/Lib/site-packages/dateutil/relativedelta.py b/llm/Lib/site-packages/dateutil/relativedelta.py
new file mode 100644
index 0000000000000000000000000000000000000000..cd323a549e0f182541ebcde2d2ea1adfbbd9701e
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/relativedelta.py
@@ -0,0 +1,599 @@
+# -*- coding: utf-8 -*-
+import datetime
+import calendar
+
+import operator
+from math import copysign
+
+from six import integer_types
+from warnings import warn
+
+from ._common import weekday
+
+MO, TU, WE, TH, FR, SA, SU = weekdays = tuple(weekday(x) for x in range(7))
+
+__all__ = ["relativedelta", "MO", "TU", "WE", "TH", "FR", "SA", "SU"]
+
+
+class relativedelta(object):
+    """
+    The relativedelta type is designed to be applied to an existing datetime and
+    can replace specific components of that datetime, or represents an interval
+    of time.
+
+    It is based on the specification of the excellent work done by M.-A. Lemburg
+    in his
+    `mx.DateTime <https://www.egenix.com/products/python/mxBase/mxDateTime/>`_ extension.
+    However, notice that this type does *NOT* implement the same algorithm as
+    his work. Do *NOT* expect it to behave like mx.DateTime's counterpart.
+
+    There are two different ways to build a relativedelta instance. The
+    first one is passing it two date/datetime classes::
+
+        relativedelta(datetime1, datetime2)
+
+    The second one is passing it any number of the following keyword arguments::
+
+        relativedelta(arg1=x,arg2=y,arg3=z...)
+
+        year, month, day, hour, minute, second, microsecond:
+            Absolute information (argument is singular); adding or subtracting a
+            relativedelta with absolute information does not perform an arithmetic
+            operation, but rather REPLACES the corresponding value in the
+            original datetime with the value(s) in relativedelta.
+
+        years, months, weeks, days, hours, minutes, seconds, microseconds:
+            Relative information, may be negative (argument is plural); adding
+            or subtracting a relativedelta with relative information performs
+            the corresponding arithmetic operation on the original datetime value
+            with the information in the relativedelta.
+
+        weekday:
+            One of the weekday instances (MO, TU, etc) available in the
+            relativedelta module. These instances may receive a parameter N,
+            specifying the Nth weekday, which could be positive or negative
+            (like MO(+1) or MO(-2)). Not specifying it is the same as specifying
+            +1. You can also use an integer, where 0=MO. This argument is always
+            relative e.g. if the calculated date is already Monday, using MO(1)
+            or MO(-1) won't change the day. To effectively make it absolute, use
+            it in combination with the day argument (e.g. day=1, MO(1) for first
+            Monday of the month).
+
+        leapdays:
+            Will add given days to the date found, if year is a leap
+            year, and the date found is post 28 of february.
+
+        yearday, nlyearday:
+            Set the yearday or the non-leap year day (jump leap days).
+            These are converted to day/month/leapdays information.
+
+    There are relative and absolute forms of the keyword
+    arguments. The plural is relative, and the singular is
+    absolute. For each argument in the order below, the absolute form
+    is applied first (by setting each attribute to that value) and
+    then the relative form (by adding the value to the attribute).
+
+    The order of attributes considered when this relativedelta is
+    added to a datetime is:
+
+    1. Year
+    2. Month
+    3. Day
+    4. Hours
+    5. Minutes
+    6. Seconds
+    7. Microseconds
+
+    Finally, weekday is applied, using the rule described above.
+
+    For example
+
+    >>> from datetime import datetime
+    >>> from dateutil.relativedelta import relativedelta, MO
+    >>> dt = datetime(2018, 4, 9, 13, 37, 0)
+    >>> delta = relativedelta(hours=25, day=1, weekday=MO(1))
+    >>> dt + delta
+    datetime.datetime(2018, 4, 2, 14, 37)
+
+    First, the day is set to 1 (the first of the month), then 25 hours
+    are added, to get to the 2nd day and 14th hour, finally the
+    weekday is applied, but since the 2nd is already a Monday there is
+    no effect.
+
+    """
+
+    def __init__(self, dt1=None, dt2=None,
+                 years=0, months=0, days=0, leapdays=0, weeks=0,
+                 hours=0, minutes=0, seconds=0, microseconds=0,
+                 year=None, month=None, day=None, weekday=None,
+                 yearday=None, nlyearday=None,
+                 hour=None, minute=None, second=None, microsecond=None):
+
+        if dt1 and dt2:
+            # datetime is a subclass of date. So both must be date
+            if not (isinstance(dt1, datetime.date) and
+                    isinstance(dt2, datetime.date)):
+                raise TypeError("relativedelta only diffs datetime/date")
+
+            # We allow two dates, or two datetimes, so we coerce them to be
+            # of the same type
+            if (isinstance(dt1, datetime.datetime) !=
+                    isinstance(dt2, datetime.datetime)):
+                if not isinstance(dt1, datetime.datetime):
+                    dt1 = datetime.datetime.fromordinal(dt1.toordinal())
+                elif not isinstance(dt2, datetime.datetime):
+                    dt2 = datetime.datetime.fromordinal(dt2.toordinal())
+
+            self.years = 0
+            self.months = 0
+            self.days = 0
+            self.leapdays = 0
+            self.hours = 0
+            self.minutes = 0
+            self.seconds = 0
+            self.microseconds = 0
+            self.year = None
+            self.month = None
+            self.day = None
+            self.weekday = None
+            self.hour = None
+            self.minute = None
+            self.second = None
+            self.microsecond = None
+            self._has_time = 0
+
+            # Get year / month delta between the two
+            months = (dt1.year - dt2.year) * 12 + (dt1.month - dt2.month)
+            self._set_months(months)
+
+            # Remove the year/month delta so the timedelta is just well-defined
+            # time units (seconds, days and microseconds)
+            dtm = self.__radd__(dt2)
+
+            # If we've overshot our target, make an adjustment
+            if dt1 < dt2:
+                compare = operator.gt
+                increment = 1
+            else:
+                compare = operator.lt
+                increment = -1
+
+            while compare(dt1, dtm):
+                months += increment
+                self._set_months(months)
+                dtm = self.__radd__(dt2)
+
+            # Get the timedelta between the "months-adjusted" date and dt1
+            delta = dt1 - dtm
+            self.seconds = delta.seconds + delta.days * 86400
+            self.microseconds = delta.microseconds
+        else:
+            # Check for non-integer values in integer-only quantities
+            if any(x is not None and x != int(x) for x in (years, months)):
+                raise ValueError("Non-integer years and months are "
+                                 "ambiguous and not currently supported.")
+
+            # Relative information
+            self.years = int(years)
+            self.months = int(months)
+            self.days = days + weeks * 7
+            self.leapdays = leapdays
+            self.hours = hours
+            self.minutes = minutes
+            self.seconds = seconds
+            self.microseconds = microseconds
+
+            # Absolute information
+            self.year = year
+            self.month = month
+            self.day = day
+            self.hour = hour
+            self.minute = minute
+            self.second = second
+            self.microsecond = microsecond
+
+            if any(x is not None and int(x) != x
+                   for x in (year, month, day, hour,
+                             minute, second, microsecond)):
+                # For now we'll deprecate floats - later it'll be an error.
+                warn("Non-integer value passed as absolute information. " +
+                     "This is not a well-defined condition and will raise " +
+                     "errors in future versions.", DeprecationWarning)
+
+            if isinstance(weekday, integer_types):
+                self.weekday = weekdays[weekday]
+            else:
+                self.weekday = weekday
+
+            yday = 0
+            if nlyearday:
+                yday = nlyearday
+            elif yearday:
+                yday = yearday
+                if yearday > 59:
+                    self.leapdays = -1
+            if yday:
+                ydayidx = [31, 59, 90, 120, 151, 181, 212,
+                           243, 273, 304, 334, 366]
+                for idx, ydays in enumerate(ydayidx):
+                    if yday <= ydays:
+                        self.month = idx+1
+                        if idx == 0:
+                            self.day = yday
+                        else:
+                            self.day = yday-ydayidx[idx-1]
+                        break
+                else:
+                    raise ValueError("invalid year day (%d)" % yday)
+
+        self._fix()
+
+    def _fix(self):
+        if abs(self.microseconds) > 999999:
+            s = _sign(self.microseconds)
+            div, mod = divmod(self.microseconds * s, 1000000)
+            self.microseconds = mod * s
+            self.seconds += div * s
+        if abs(self.seconds) > 59:
+            s = _sign(self.seconds)
+            div, mod = divmod(self.seconds * s, 60)
+            self.seconds = mod * s
+            self.minutes += div * s
+        if abs(self.minutes) > 59:
+            s = _sign(self.minutes)
+            div, mod = divmod(self.minutes * s, 60)
+            self.minutes = mod * s
+            self.hours += div * s
+        if abs(self.hours) > 23:
+            s = _sign(self.hours)
+            div, mod = divmod(self.hours * s, 24)
+            self.hours = mod * s
+            self.days += div * s
+        if abs(self.months) > 11:
+            s = _sign(self.months)
+            div, mod = divmod(self.months * s, 12)
+            self.months = mod * s
+            self.years += div * s
+        if (self.hours or self.minutes or self.seconds or self.microseconds
+                or self.hour is not None or self.minute is not None or
+                self.second is not None or self.microsecond is not None):
+            self._has_time = 1
+        else:
+            self._has_time = 0
+
+    @property
+    def weeks(self):
+        return int(self.days / 7.0)
+
+    @weeks.setter
+    def weeks(self, value):
+        self.days = self.days - (self.weeks * 7) + value * 7
+
+    def _set_months(self, months):
+        self.months = months
+        if abs(self.months) > 11:
+            s = _sign(self.months)
+            div, mod = divmod(self.months * s, 12)
+            self.months = mod * s
+            self.years = div * s
+        else:
+            self.years = 0
+
+    def normalized(self):
+        """
+        Return a version of this object represented entirely using integer
+        values for the relative attributes.
+
+        >>> relativedelta(days=1.5, hours=2).normalized()
+        relativedelta(days=+1, hours=+14)
+
+        :return:
+            Returns a :class:`dateutil.relativedelta.relativedelta` object.
+        """
+        # Cascade remainders down (rounding each to roughly nearest microsecond)
+        days = int(self.days)
+
+        hours_f = round(self.hours + 24 * (self.days - days), 11)
+        hours = int(hours_f)
+
+        minutes_f = round(self.minutes + 60 * (hours_f - hours), 10)
+        minutes = int(minutes_f)
+
+        seconds_f = round(self.seconds + 60 * (minutes_f - minutes), 8)
+        seconds = int(seconds_f)
+
+        microseconds = round(self.microseconds + 1e6 * (seconds_f - seconds))
+
+        # Constructor carries overflow back up with call to _fix()
+        return self.__class__(years=self.years, months=self.months,
+                              days=days, hours=hours, minutes=minutes,
+                              seconds=seconds, microseconds=microseconds,
+                              leapdays=self.leapdays, year=self.year,
+                              month=self.month, day=self.day,
+                              weekday=self.weekday, hour=self.hour,
+                              minute=self.minute, second=self.second,
+                              microsecond=self.microsecond)
+
+    def __add__(self, other):
+        if isinstance(other, relativedelta):
+            return self.__class__(years=other.years + self.years,
+                                 months=other.months + self.months,
+                                 days=other.days + self.days,
+                                 hours=other.hours + self.hours,
+                                 minutes=other.minutes + self.minutes,
+                                 seconds=other.seconds + self.seconds,
+                                 microseconds=(other.microseconds +
+                                               self.microseconds),
+                                 leapdays=other.leapdays or self.leapdays,
+                                 year=(other.year if other.year is not None
+                                       else self.year),
+                                 month=(other.month if other.month is not None
+                                        else self.month),
+                                 day=(other.day if other.day is not None
+                                      else self.day),
+                                 weekday=(other.weekday if other.weekday is not None
+                                          else self.weekday),
+                                 hour=(other.hour if other.hour is not None
+                                       else self.hour),
+                                 minute=(other.minute if other.minute is not None
+                                         else self.minute),
+                                 second=(other.second if other.second is not None
+                                         else self.second),
+                                 microsecond=(other.microsecond if other.microsecond
+                                              is not None else
+                                              self.microsecond))
+        if isinstance(other, datetime.timedelta):
+            return self.__class__(years=self.years,
+                                  months=self.months,
+                                  days=self.days + other.days,
+                                  hours=self.hours,
+                                  minutes=self.minutes,
+                                  seconds=self.seconds + other.seconds,
+                                  microseconds=self.microseconds + other.microseconds,
+                                  leapdays=self.leapdays,
+                                  year=self.year,
+                                  month=self.month,
+                                  day=self.day,
+                                  weekday=self.weekday,
+                                  hour=self.hour,
+                                  minute=self.minute,
+                                  second=self.second,
+                                  microsecond=self.microsecond)
+        if not isinstance(other, datetime.date):
+            return NotImplemented
+        elif self._has_time and not isinstance(other, datetime.datetime):
+            other = datetime.datetime.fromordinal(other.toordinal())
+        year = (self.year or other.year)+self.years
+        month = self.month or other.month
+        if self.months:
+            assert 1 <= abs(self.months) <= 12
+            month += self.months
+            if month > 12:
+                year += 1
+                month -= 12
+            elif month < 1:
+                year -= 1
+                month += 12
+        day = min(calendar.monthrange(year, month)[1],
+                  self.day or other.day)
+        repl = {"year": year, "month": month, "day": day}
+        for attr in ["hour", "minute", "second", "microsecond"]:
+            value = getattr(self, attr)
+            if value is not None:
+                repl[attr] = value
+        days = self.days
+        if self.leapdays and month > 2 and calendar.isleap(year):
+            days += self.leapdays
+        ret = (other.replace(**repl)
+               + datetime.timedelta(days=days,
+                                    hours=self.hours,
+                                    minutes=self.minutes,
+                                    seconds=self.seconds,
+                                    microseconds=self.microseconds))
+        if self.weekday:
+            weekday, nth = self.weekday.weekday, self.weekday.n or 1
+            jumpdays = (abs(nth) - 1) * 7
+            if nth > 0:
+                jumpdays += (7 - ret.weekday() + weekday) % 7
+            else:
+                jumpdays += (ret.weekday() - weekday) % 7
+                jumpdays *= -1
+            ret += datetime.timedelta(days=jumpdays)
+        return ret
+
+    def __radd__(self, other):
+        return self.__add__(other)
+
+    def __rsub__(self, other):
+        return self.__neg__().__radd__(other)
+
+    def __sub__(self, other):
+        if not isinstance(other, relativedelta):
+            return NotImplemented   # In case the other object defines __rsub__
+        return self.__class__(years=self.years - other.years,
+                             months=self.months - other.months,
+                             days=self.days - other.days,
+                             hours=self.hours - other.hours,
+                             minutes=self.minutes - other.minutes,
+                             seconds=self.seconds - other.seconds,
+                             microseconds=self.microseconds - other.microseconds,
+                             leapdays=self.leapdays or other.leapdays,
+                             year=(self.year if self.year is not None
+                                   else other.year),
+                             month=(self.month if self.month is not None else
+                                    other.month),
+                             day=(self.day if self.day is not None else
+                                  other.day),
+                             weekday=(self.weekday if self.weekday is not None else
+                                      other.weekday),
+                             hour=(self.hour if self.hour is not None else
+                                   other.hour),
+                             minute=(self.minute if self.minute is not None else
+                                     other.minute),
+                             second=(self.second if self.second is not None else
+                                     other.second),
+                             microsecond=(self.microsecond if self.microsecond
+                                          is not None else
+                                          other.microsecond))
+
+    def __abs__(self):
+        return self.__class__(years=abs(self.years),
+                              months=abs(self.months),
+                              days=abs(self.days),
+                              hours=abs(self.hours),
+                              minutes=abs(self.minutes),
+                              seconds=abs(self.seconds),
+                              microseconds=abs(self.microseconds),
+                              leapdays=self.leapdays,
+                              year=self.year,
+                              month=self.month,
+                              day=self.day,
+                              weekday=self.weekday,
+                              hour=self.hour,
+                              minute=self.minute,
+                              second=self.second,
+                              microsecond=self.microsecond)
+
+    def __neg__(self):
+        return self.__class__(years=-self.years,
+                             months=-self.months,
+                             days=-self.days,
+                             hours=-self.hours,
+                             minutes=-self.minutes,
+                             seconds=-self.seconds,
+                             microseconds=-self.microseconds,
+                             leapdays=self.leapdays,
+                             year=self.year,
+                             month=self.month,
+                             day=self.day,
+                             weekday=self.weekday,
+                             hour=self.hour,
+                             minute=self.minute,
+                             second=self.second,
+                             microsecond=self.microsecond)
+
+    def __bool__(self):
+        return not (not self.years and
+                    not self.months and
+                    not self.days and
+                    not self.hours and
+                    not self.minutes and
+                    not self.seconds and
+                    not self.microseconds and
+                    not self.leapdays and
+                    self.year is None and
+                    self.month is None and
+                    self.day is None and
+                    self.weekday is None and
+                    self.hour is None and
+                    self.minute is None and
+                    self.second is None and
+                    self.microsecond is None)
+    # Compatibility with Python 2.x
+    __nonzero__ = __bool__
+
+    def __mul__(self, other):
+        try:
+            f = float(other)
+        except TypeError:
+            return NotImplemented
+
+        return self.__class__(years=int(self.years * f),
+                             months=int(self.months * f),
+                             days=int(self.days * f),
+                             hours=int(self.hours * f),
+                             minutes=int(self.minutes * f),
+                             seconds=int(self.seconds * f),
+                             microseconds=int(self.microseconds * f),
+                             leapdays=self.leapdays,
+                             year=self.year,
+                             month=self.month,
+                             day=self.day,
+                             weekday=self.weekday,
+                             hour=self.hour,
+                             minute=self.minute,
+                             second=self.second,
+                             microsecond=self.microsecond)
+
+    __rmul__ = __mul__
+
+    def __eq__(self, other):
+        if not isinstance(other, relativedelta):
+            return NotImplemented
+        if self.weekday or other.weekday:
+            if not self.weekday or not other.weekday:
+                return False
+            if self.weekday.weekday != other.weekday.weekday:
+                return False
+            n1, n2 = self.weekday.n, other.weekday.n
+            if n1 != n2 and not ((not n1 or n1 == 1) and (not n2 or n2 == 1)):
+                return False
+        return (self.years == other.years and
+                self.months == other.months and
+                self.days == other.days and
+                self.hours == other.hours and
+                self.minutes == other.minutes and
+                self.seconds == other.seconds and
+                self.microseconds == other.microseconds and
+                self.leapdays == other.leapdays and
+                self.year == other.year and
+                self.month == other.month and
+                self.day == other.day and
+                self.hour == other.hour and
+                self.minute == other.minute and
+                self.second == other.second and
+                self.microsecond == other.microsecond)
+
+    def __hash__(self):
+        return hash((
+            self.weekday,
+            self.years,
+            self.months,
+            self.days,
+            self.hours,
+            self.minutes,
+            self.seconds,
+            self.microseconds,
+            self.leapdays,
+            self.year,
+            self.month,
+            self.day,
+            self.hour,
+            self.minute,
+            self.second,
+            self.microsecond,
+        ))
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __div__(self, other):
+        try:
+            reciprocal = 1 / float(other)
+        except TypeError:
+            return NotImplemented
+
+        return self.__mul__(reciprocal)
+
+    __truediv__ = __div__
+
+    def __repr__(self):
+        l = []
+        for attr in ["years", "months", "days", "leapdays",
+                     "hours", "minutes", "seconds", "microseconds"]:
+            value = getattr(self, attr)
+            if value:
+                l.append("{attr}={value:+g}".format(attr=attr, value=value))
+        for attr in ["year", "month", "day", "weekday",
+                     "hour", "minute", "second", "microsecond"]:
+            value = getattr(self, attr)
+            if value is not None:
+                l.append("{attr}={value}".format(attr=attr, value=repr(value)))
+        return "{classname}({attrs})".format(classname=self.__class__.__name__,
+                                             attrs=", ".join(l))
+
+
+def _sign(x):
+    return int(copysign(1, x))
+
+# vim:ts=4:sw=4:et
diff --git a/llm/Lib/site-packages/dateutil/rrule.py b/llm/Lib/site-packages/dateutil/rrule.py
new file mode 100644
index 0000000000000000000000000000000000000000..571a0d2bc886a7ea4c06196b2f52e740c2ed6e9f
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/rrule.py
@@ -0,0 +1,1737 @@
+# -*- coding: utf-8 -*-
+"""
+The rrule module offers a small, complete, and very fast, implementation of
+the recurrence rules documented in the
+`iCalendar RFC <https://tools.ietf.org/html/rfc5545>`_,
+including support for caching of results.
+"""
+import calendar
+import datetime
+import heapq
+import itertools
+import re
+import sys
+from functools import wraps
+# For warning about deprecation of until and count
+from warnings import warn
+
+from six import advance_iterator, integer_types
+
+from six.moves import _thread, range
+
+from ._common import weekday as weekdaybase
+
+try:
+    from math import gcd
+except ImportError:
+    from fractions import gcd
+
+__all__ = ["rrule", "rruleset", "rrulestr",
+           "YEARLY", "MONTHLY", "WEEKLY", "DAILY",
+           "HOURLY", "MINUTELY", "SECONDLY",
+           "MO", "TU", "WE", "TH", "FR", "SA", "SU"]
+
+# Every mask is 7 days longer to handle cross-year weekly periods.
+M366MASK = tuple([1]*31+[2]*29+[3]*31+[4]*30+[5]*31+[6]*30 +
+                 [7]*31+[8]*31+[9]*30+[10]*31+[11]*30+[12]*31+[1]*7)
+M365MASK = list(M366MASK)
+M29, M30, M31 = list(range(1, 30)), list(range(1, 31)), list(range(1, 32))
+MDAY366MASK = tuple(M31+M29+M31+M30+M31+M30+M31+M31+M30+M31+M30+M31+M31[:7])
+MDAY365MASK = list(MDAY366MASK)
+M29, M30, M31 = list(range(-29, 0)), list(range(-30, 0)), list(range(-31, 0))
+NMDAY366MASK = tuple(M31+M29+M31+M30+M31+M30+M31+M31+M30+M31+M30+M31+M31[:7])
+NMDAY365MASK = list(NMDAY366MASK)
+M366RANGE = (0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366)
+M365RANGE = (0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365)
+WDAYMASK = [0, 1, 2, 3, 4, 5, 6]*55
+del M29, M30, M31, M365MASK[59], MDAY365MASK[59], NMDAY365MASK[31]
+MDAY365MASK = tuple(MDAY365MASK)
+M365MASK = tuple(M365MASK)
+
+FREQNAMES = ['YEARLY', 'MONTHLY', 'WEEKLY', 'DAILY', 'HOURLY', 'MINUTELY', 'SECONDLY']
+
+(YEARLY,
+ MONTHLY,
+ WEEKLY,
+ DAILY,
+ HOURLY,
+ MINUTELY,
+ SECONDLY) = list(range(7))
+
+# Imported on demand.
+easter = None
+parser = None
+
+
+class weekday(weekdaybase):
+    """
+    This version of weekday does not allow n = 0.
+    """
+    def __init__(self, wkday, n=None):
+        if n == 0:
+            raise ValueError("Can't create weekday with n==0")
+
+        super(weekday, self).__init__(wkday, n)
+
+
+MO, TU, WE, TH, FR, SA, SU = weekdays = tuple(weekday(x) for x in range(7))
+
+
+def _invalidates_cache(f):
+    """
+    Decorator for rruleset methods which may invalidate the
+    cached length.
+    """
+    @wraps(f)
+    def inner_func(self, *args, **kwargs):
+        rv = f(self, *args, **kwargs)
+        self._invalidate_cache()
+        return rv
+
+    return inner_func
+
+
+class rrulebase(object):
+    def __init__(self, cache=False):
+        if cache:
+            self._cache = []
+            self._cache_lock = _thread.allocate_lock()
+            self._invalidate_cache()
+        else:
+            self._cache = None
+            self._cache_complete = False
+            self._len = None
+
+    def __iter__(self):
+        if self._cache_complete:
+            return iter(self._cache)
+        elif self._cache is None:
+            return self._iter()
+        else:
+            return self._iter_cached()
+
+    def _invalidate_cache(self):
+        if self._cache is not None:
+            self._cache = []
+            self._cache_complete = False
+            self._cache_gen = self._iter()
+
+            if self._cache_lock.locked():
+                self._cache_lock.release()
+
+        self._len = None
+
+    def _iter_cached(self):
+        i = 0
+        gen = self._cache_gen
+        cache = self._cache
+        acquire = self._cache_lock.acquire
+        release = self._cache_lock.release
+        while gen:
+            if i == len(cache):
+                acquire()
+                if self._cache_complete:
+                    break
+                try:
+                    for j in range(10):
+                        cache.append(advance_iterator(gen))
+                except StopIteration:
+                    self._cache_gen = gen = None
+                    self._cache_complete = True
+                    break
+                release()
+            yield cache[i]
+            i += 1
+        while i < self._len:
+            yield cache[i]
+            i += 1
+
+    def __getitem__(self, item):
+        if self._cache_complete:
+            return self._cache[item]
+        elif isinstance(item, slice):
+            if item.step and item.step < 0:
+                return list(iter(self))[item]
+            else:
+                return list(itertools.islice(self,
+                                             item.start or 0,
+                                             item.stop or sys.maxsize,
+                                             item.step or 1))
+        elif item >= 0:
+            gen = iter(self)
+            try:
+                for i in range(item+1):
+                    res = advance_iterator(gen)
+            except StopIteration:
+                raise IndexError
+            return res
+        else:
+            return list(iter(self))[item]
+
+    def __contains__(self, item):
+        if self._cache_complete:
+            return item in self._cache
+        else:
+            for i in self:
+                if i == item:
+                    return True
+                elif i > item:
+                    return False
+        return False
+
+    # __len__() introduces a large performance penalty.
+    def count(self):
+        """ Returns the number of recurrences in this set. It will have go
+            through the whole recurrence, if this hasn't been done before. """
+        if self._len is None:
+            for x in self:
+                pass
+        return self._len
+
+    def before(self, dt, inc=False):
+        """ Returns the last recurrence before the given datetime instance. The
+            inc keyword defines what happens if dt is an occurrence. With
+            inc=True, if dt itself is an occurrence, it will be returned. """
+        if self._cache_complete:
+            gen = self._cache
+        else:
+            gen = self
+        last = None
+        if inc:
+            for i in gen:
+                if i > dt:
+                    break
+                last = i
+        else:
+            for i in gen:
+                if i >= dt:
+                    break
+                last = i
+        return last
+
+    def after(self, dt, inc=False):
+        """ Returns the first recurrence after the given datetime instance. The
+            inc keyword defines what happens if dt is an occurrence. With
+            inc=True, if dt itself is an occurrence, it will be returned.  """
+        if self._cache_complete:
+            gen = self._cache
+        else:
+            gen = self
+        if inc:
+            for i in gen:
+                if i >= dt:
+                    return i
+        else:
+            for i in gen:
+                if i > dt:
+                    return i
+        return None
+
+    def xafter(self, dt, count=None, inc=False):
+        """
+        Generator which yields up to `count` recurrences after the given
+        datetime instance, equivalent to `after`.
+
+        :param dt:
+            The datetime at which to start generating recurrences.
+
+        :param count:
+            The maximum number of recurrences to generate. If `None` (default),
+            dates are generated until the recurrence rule is exhausted.
+
+        :param inc:
+            If `dt` is an instance of the rule and `inc` is `True`, it is
+            included in the output.
+
+        :yields: Yields a sequence of `datetime` objects.
+        """
+
+        if self._cache_complete:
+            gen = self._cache
+        else:
+            gen = self
+
+        # Select the comparison function
+        if inc:
+            comp = lambda dc, dtc: dc >= dtc
+        else:
+            comp = lambda dc, dtc: dc > dtc
+
+        # Generate dates
+        n = 0
+        for d in gen:
+            if comp(d, dt):
+                if count is not None:
+                    n += 1
+                    if n > count:
+                        break
+
+                yield d
+
+    def between(self, after, before, inc=False, count=1):
+        """ Returns all the occurrences of the rrule between after and before.
+        The inc keyword defines what happens if after and/or before are
+        themselves occurrences. With inc=True, they will be included in the
+        list, if they are found in the recurrence set. """
+        if self._cache_complete:
+            gen = self._cache
+        else:
+            gen = self
+        started = False
+        l = []
+        if inc:
+            for i in gen:
+                if i > before:
+                    break
+                elif not started:
+                    if i >= after:
+                        started = True
+                        l.append(i)
+                else:
+                    l.append(i)
+        else:
+            for i in gen:
+                if i >= before:
+                    break
+                elif not started:
+                    if i > after:
+                        started = True
+                        l.append(i)
+                else:
+                    l.append(i)
+        return l
+
+
+class rrule(rrulebase):
+    """
+    That's the base of the rrule operation. It accepts all the keywords
+    defined in the RFC as its constructor parameters (except byday,
+    which was renamed to byweekday) and more. The constructor prototype is::
+
+            rrule(freq)
+
+    Where freq must be one of YEARLY, MONTHLY, WEEKLY, DAILY, HOURLY, MINUTELY,
+    or SECONDLY.
+
+    .. note::
+        Per RFC section 3.3.10, recurrence instances falling on invalid dates
+        and times are ignored rather than coerced:
+
+            Recurrence rules may generate recurrence instances with an invalid
+            date (e.g., February 30) or nonexistent local time (e.g., 1:30 AM
+            on a day where the local time is moved forward by an hour at 1:00
+            AM).  Such recurrence instances MUST be ignored and MUST NOT be
+            counted as part of the recurrence set.
+
+        This can lead to possibly surprising behavior when, for example, the
+        start date occurs at the end of the month:
+
+        >>> from dateutil.rrule import rrule, MONTHLY
+        >>> from datetime import datetime
+        >>> start_date = datetime(2014, 12, 31)
+        >>> list(rrule(freq=MONTHLY, count=4, dtstart=start_date))
+        ... # doctest: +NORMALIZE_WHITESPACE
+        [datetime.datetime(2014, 12, 31, 0, 0),
+         datetime.datetime(2015, 1, 31, 0, 0),
+         datetime.datetime(2015, 3, 31, 0, 0),
+         datetime.datetime(2015, 5, 31, 0, 0)]
+
+    Additionally, it supports the following keyword arguments:
+
+    :param dtstart:
+        The recurrence start. Besides being the base for the recurrence,
+        missing parameters in the final recurrence instances will also be
+        extracted from this date. If not given, datetime.now() will be used
+        instead.
+    :param interval:
+        The interval between each freq iteration. For example, when using
+        YEARLY, an interval of 2 means once every two years, but with HOURLY,
+        it means once every two hours. The default interval is 1.
+    :param wkst:
+        The week start day. Must be one of the MO, TU, WE constants, or an
+        integer, specifying the first day of the week. This will affect
+        recurrences based on weekly periods. The default week start is got
+        from calendar.firstweekday(), and may be modified by
+        calendar.setfirstweekday().
+    :param count:
+        If given, this determines how many occurrences will be generated.
+
+        .. note::
+            As of version 2.5.0, the use of the keyword ``until`` in conjunction
+            with ``count`` is deprecated, to make sure ``dateutil`` is fully
+            compliant with `RFC-5545 Sec. 3.3.10 <https://tools.ietf.org/
+            html/rfc5545#section-3.3.10>`_. Therefore, ``until`` and ``count``
+            **must not** occur in the same call to ``rrule``.
+    :param until:
+        If given, this must be a datetime instance specifying the upper-bound
+        limit of the recurrence. The last recurrence in the rule is the greatest
+        datetime that is less than or equal to the value specified in the
+        ``until`` parameter.
+
+        .. note::
+            As of version 2.5.0, the use of the keyword ``until`` in conjunction
+            with ``count`` is deprecated, to make sure ``dateutil`` is fully
+            compliant with `RFC-5545 Sec. 3.3.10 <https://tools.ietf.org/
+            html/rfc5545#section-3.3.10>`_. Therefore, ``until`` and ``count``
+            **must not** occur in the same call to ``rrule``.
+    :param bysetpos:
+        If given, it must be either an integer, or a sequence of integers,
+        positive or negative. Each given integer will specify an occurrence
+        number, corresponding to the nth occurrence of the rule inside the
+        frequency period. For example, a bysetpos of -1 if combined with a
+        MONTHLY frequency, and a byweekday of (MO, TU, WE, TH, FR), will
+        result in the last work day of every month.
+    :param bymonth:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the months to apply the recurrence to.
+    :param bymonthday:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the month days to apply the recurrence to.
+    :param byyearday:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the year days to apply the recurrence to.
+    :param byeaster:
+        If given, it must be either an integer, or a sequence of integers,
+        positive or negative. Each integer will define an offset from the
+        Easter Sunday. Passing the offset 0 to byeaster will yield the Easter
+        Sunday itself. This is an extension to the RFC specification.
+    :param byweekno:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the week numbers to apply the recurrence to. Week numbers
+        have the meaning described in ISO8601, that is, the first week of
+        the year is that containing at least four days of the new year.
+    :param byweekday:
+        If given, it must be either an integer (0 == MO), a sequence of
+        integers, one of the weekday constants (MO, TU, etc), or a sequence
+        of these constants. When given, these variables will define the
+        weekdays where the recurrence will be applied. It's also possible to
+        use an argument n for the weekday instances, which will mean the nth
+        occurrence of this weekday in the period. For example, with MONTHLY,
+        or with YEARLY and BYMONTH, using FR(+1) in byweekday will specify the
+        first friday of the month where the recurrence happens. Notice that in
+        the RFC documentation, this is specified as BYDAY, but was renamed to
+        avoid the ambiguity of that keyword.
+    :param byhour:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the hours to apply the recurrence to.
+    :param byminute:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the minutes to apply the recurrence to.
+    :param bysecond:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the seconds to apply the recurrence to.
+    :param cache:
+        If given, it must be a boolean value specifying to enable or disable
+        caching of results. If you will use the same rrule instance multiple
+        times, enabling caching will improve the performance considerably.
+     """
+    def __init__(self, freq, dtstart=None,
+                 interval=1, wkst=None, count=None, until=None, bysetpos=None,
+                 bymonth=None, bymonthday=None, byyearday=None, byeaster=None,
+                 byweekno=None, byweekday=None,
+                 byhour=None, byminute=None, bysecond=None,
+                 cache=False):
+        super(rrule, self).__init__(cache)
+        global easter
+        if not dtstart:
+            if until and until.tzinfo:
+                dtstart = datetime.datetime.now(tz=until.tzinfo).replace(microsecond=0)
+            else:
+                dtstart = datetime.datetime.now().replace(microsecond=0)
+        elif not isinstance(dtstart, datetime.datetime):
+            dtstart = datetime.datetime.fromordinal(dtstart.toordinal())
+        else:
+            dtstart = dtstart.replace(microsecond=0)
+        self._dtstart = dtstart
+        self._tzinfo = dtstart.tzinfo
+        self._freq = freq
+        self._interval = interval
+        self._count = count
+
+        # Cache the original byxxx rules, if they are provided, as the _byxxx
+        # attributes do not necessarily map to the inputs, and this can be
+        # a problem in generating the strings. Only store things if they've
+        # been supplied (the string retrieval will just use .get())
+        self._original_rule = {}
+
+        if until and not isinstance(until, datetime.datetime):
+            until = datetime.datetime.fromordinal(until.toordinal())
+        self._until = until
+
+        if self._dtstart and self._until:
+            if (self._dtstart.tzinfo is not None) != (self._until.tzinfo is not None):
+                # According to RFC5545 Section 3.3.10:
+                # https://tools.ietf.org/html/rfc5545#section-3.3.10
+                #
+                # > If the "DTSTART" property is specified as a date with UTC
+                # > time or a date with local time and time zone reference,
+                # > then the UNTIL rule part MUST be specified as a date with
+                # > UTC time.
+                raise ValueError(
+                    'RRULE UNTIL values must be specified in UTC when DTSTART '
+                    'is timezone-aware'
+                )
+
+        if count is not None and until:
+            warn("Using both 'count' and 'until' is inconsistent with RFC 5545"
+                 " and has been deprecated in dateutil. Future versions will "
+                 "raise an error.", DeprecationWarning)
+
+        if wkst is None:
+            self._wkst = calendar.firstweekday()
+        elif isinstance(wkst, integer_types):
+            self._wkst = wkst
+        else:
+            self._wkst = wkst.weekday
+
+        if bysetpos is None:
+            self._bysetpos = None
+        elif isinstance(bysetpos, integer_types):
+            if bysetpos == 0 or not (-366 <= bysetpos <= 366):
+                raise ValueError("bysetpos must be between 1 and 366, "
+                                 "or between -366 and -1")
+            self._bysetpos = (bysetpos,)
+        else:
+            self._bysetpos = tuple(bysetpos)
+            for pos in self._bysetpos:
+                if pos == 0 or not (-366 <= pos <= 366):
+                    raise ValueError("bysetpos must be between 1 and 366, "
+                                     "or between -366 and -1")
+
+        if self._bysetpos:
+            self._original_rule['bysetpos'] = self._bysetpos
+
+        if (byweekno is None and byyearday is None and bymonthday is None and
+                byweekday is None and byeaster is None):
+            if freq == YEARLY:
+                if bymonth is None:
+                    bymonth = dtstart.month
+                    self._original_rule['bymonth'] = None
+                bymonthday = dtstart.day
+                self._original_rule['bymonthday'] = None
+            elif freq == MONTHLY:
+                bymonthday = dtstart.day
+                self._original_rule['bymonthday'] = None
+            elif freq == WEEKLY:
+                byweekday = dtstart.weekday()
+                self._original_rule['byweekday'] = None
+
+        # bymonth
+        if bymonth is None:
+            self._bymonth = None
+        else:
+            if isinstance(bymonth, integer_types):
+                bymonth = (bymonth,)
+
+            self._bymonth = tuple(sorted(set(bymonth)))
+
+            if 'bymonth' not in self._original_rule:
+                self._original_rule['bymonth'] = self._bymonth
+
+        # byyearday
+        if byyearday is None:
+            self._byyearday = None
+        else:
+            if isinstance(byyearday, integer_types):
+                byyearday = (byyearday,)
+
+            self._byyearday = tuple(sorted(set(byyearday)))
+            self._original_rule['byyearday'] = self._byyearday
+
+        # byeaster
+        if byeaster is not None:
+            if not easter:
+                from dateutil import easter
+            if isinstance(byeaster, integer_types):
+                self._byeaster = (byeaster,)
+            else:
+                self._byeaster = tuple(sorted(byeaster))
+
+            self._original_rule['byeaster'] = self._byeaster
+        else:
+            self._byeaster = None
+
+        # bymonthday
+        if bymonthday is None:
+            self._bymonthday = ()
+            self._bynmonthday = ()
+        else:
+            if isinstance(bymonthday, integer_types):
+                bymonthday = (bymonthday,)
+
+            bymonthday = set(bymonthday)            # Ensure it's unique
+
+            self._bymonthday = tuple(sorted(x for x in bymonthday if x > 0))
+            self._bynmonthday = tuple(sorted(x for x in bymonthday if x < 0))
+
+            # Storing positive numbers first, then negative numbers
+            if 'bymonthday' not in self._original_rule:
+                self._original_rule['bymonthday'] = tuple(
+                    itertools.chain(self._bymonthday, self._bynmonthday))
+
+        # byweekno
+        if byweekno is None:
+            self._byweekno = None
+        else:
+            if isinstance(byweekno, integer_types):
+                byweekno = (byweekno,)
+
+            self._byweekno = tuple(sorted(set(byweekno)))
+
+            self._original_rule['byweekno'] = self._byweekno
+
+        # byweekday / bynweekday
+        if byweekday is None:
+            self._byweekday = None
+            self._bynweekday = None
+        else:
+            # If it's one of the valid non-sequence types, convert to a
+            # single-element sequence before the iterator that builds the
+            # byweekday set.
+            if isinstance(byweekday, integer_types) or hasattr(byweekday, "n"):
+                byweekday = (byweekday,)
+
+            self._byweekday = set()
+            self._bynweekday = set()
+            for wday in byweekday:
+                if isinstance(wday, integer_types):
+                    self._byweekday.add(wday)
+                elif not wday.n or freq > MONTHLY:
+                    self._byweekday.add(wday.weekday)
+                else:
+                    self._bynweekday.add((wday.weekday, wday.n))
+
+            if not self._byweekday:
+                self._byweekday = None
+            elif not self._bynweekday:
+                self._bynweekday = None
+
+            if self._byweekday is not None:
+                self._byweekday = tuple(sorted(self._byweekday))
+                orig_byweekday = [weekday(x) for x in self._byweekday]
+            else:
+                orig_byweekday = ()
+
+            if self._bynweekday is not None:
+                self._bynweekday = tuple(sorted(self._bynweekday))
+                orig_bynweekday = [weekday(*x) for x in self._bynweekday]
+            else:
+                orig_bynweekday = ()
+
+            if 'byweekday' not in self._original_rule:
+                self._original_rule['byweekday'] = tuple(itertools.chain(
+                    orig_byweekday, orig_bynweekday))
+
+        # byhour
+        if byhour is None:
+            if freq < HOURLY:
+                self._byhour = {dtstart.hour}
+            else:
+                self._byhour = None
+        else:
+            if isinstance(byhour, integer_types):
+                byhour = (byhour,)
+
+            if freq == HOURLY:
+                self._byhour = self.__construct_byset(start=dtstart.hour,
+                                                      byxxx=byhour,
+                                                      base=24)
+            else:
+                self._byhour = set(byhour)
+
+            self._byhour = tuple(sorted(self._byhour))
+            self._original_rule['byhour'] = self._byhour
+
+        # byminute
+        if byminute is None:
+            if freq < MINUTELY:
+                self._byminute = {dtstart.minute}
+            else:
+                self._byminute = None
+        else:
+            if isinstance(byminute, integer_types):
+                byminute = (byminute,)
+
+            if freq == MINUTELY:
+                self._byminute = self.__construct_byset(start=dtstart.minute,
+                                                        byxxx=byminute,
+                                                        base=60)
+            else:
+                self._byminute = set(byminute)
+
+            self._byminute = tuple(sorted(self._byminute))
+            self._original_rule['byminute'] = self._byminute
+
+        # bysecond
+        if bysecond is None:
+            if freq < SECONDLY:
+                self._bysecond = ((dtstart.second,))
+            else:
+                self._bysecond = None
+        else:
+            if isinstance(bysecond, integer_types):
+                bysecond = (bysecond,)
+
+            self._bysecond = set(bysecond)
+
+            if freq == SECONDLY:
+                self._bysecond = self.__construct_byset(start=dtstart.second,
+                                                        byxxx=bysecond,
+                                                        base=60)
+            else:
+                self._bysecond = set(bysecond)
+
+            self._bysecond = tuple(sorted(self._bysecond))
+            self._original_rule['bysecond'] = self._bysecond
+
+        if self._freq >= HOURLY:
+            self._timeset = None
+        else:
+            self._timeset = []
+            for hour in self._byhour:
+                for minute in self._byminute:
+                    for second in self._bysecond:
+                        self._timeset.append(
+                            datetime.time(hour, minute, second,
+                                          tzinfo=self._tzinfo))
+            self._timeset.sort()
+            self._timeset = tuple(self._timeset)
+
+    def __str__(self):
+        """
+        Output a string that would generate this RRULE if passed to rrulestr.
+        This is mostly compatible with RFC5545, except for the
+        dateutil-specific extension BYEASTER.
+        """
+
+        output = []
+        h, m, s = [None] * 3
+        if self._dtstart:
+            output.append(self._dtstart.strftime('DTSTART:%Y%m%dT%H%M%S'))
+            h, m, s = self._dtstart.timetuple()[3:6]
+
+        parts = ['FREQ=' + FREQNAMES[self._freq]]
+        if self._interval != 1:
+            parts.append('INTERVAL=' + str(self._interval))
+
+        if self._wkst:
+            parts.append('WKST=' + repr(weekday(self._wkst))[0:2])
+
+        if self._count is not None:
+            parts.append('COUNT=' + str(self._count))
+
+        if self._until:
+            parts.append(self._until.strftime('UNTIL=%Y%m%dT%H%M%S'))
+
+        if self._original_rule.get('byweekday') is not None:
+            # The str() method on weekday objects doesn't generate
+            # RFC5545-compliant strings, so we should modify that.
+            original_rule = dict(self._original_rule)
+            wday_strings = []
+            for wday in original_rule['byweekday']:
+                if wday.n:
+                    wday_strings.append('{n:+d}{wday}'.format(
+                        n=wday.n,
+                        wday=repr(wday)[0:2]))
+                else:
+                    wday_strings.append(repr(wday))
+
+            original_rule['byweekday'] = wday_strings
+        else:
+            original_rule = self._original_rule
+
+        partfmt = '{name}={vals}'
+        for name, key in [('BYSETPOS', 'bysetpos'),
+                          ('BYMONTH', 'bymonth'),
+                          ('BYMONTHDAY', 'bymonthday'),
+                          ('BYYEARDAY', 'byyearday'),
+                          ('BYWEEKNO', 'byweekno'),
+                          ('BYDAY', 'byweekday'),
+                          ('BYHOUR', 'byhour'),
+                          ('BYMINUTE', 'byminute'),
+                          ('BYSECOND', 'bysecond'),
+                          ('BYEASTER', 'byeaster')]:
+            value = original_rule.get(key)
+            if value:
+                parts.append(partfmt.format(name=name, vals=(','.join(str(v)
+                                                             for v in value))))
+
+        output.append('RRULE:' + ';'.join(parts))
+        return '\n'.join(output)
+
+    def replace(self, **kwargs):
+        """Return new rrule with same attributes except for those attributes given new
+           values by whichever keyword arguments are specified."""
+        new_kwargs = {"interval": self._interval,
+                      "count": self._count,
+                      "dtstart": self._dtstart,
+                      "freq": self._freq,
+                      "until": self._until,
+                      "wkst": self._wkst,
+                      "cache": False if self._cache is None else True }
+        new_kwargs.update(self._original_rule)
+        new_kwargs.update(kwargs)
+        return rrule(**new_kwargs)
+
+    def _iter(self):
+        year, month, day, hour, minute, second, weekday, yearday, _ = \
+            self._dtstart.timetuple()
+
+        # Some local variables to speed things up a bit
+        freq = self._freq
+        interval = self._interval
+        wkst = self._wkst
+        until = self._until
+        bymonth = self._bymonth
+        byweekno = self._byweekno
+        byyearday = self._byyearday
+        byweekday = self._byweekday
+        byeaster = self._byeaster
+        bymonthday = self._bymonthday
+        bynmonthday = self._bynmonthday
+        bysetpos = self._bysetpos
+        byhour = self._byhour
+        byminute = self._byminute
+        bysecond = self._bysecond
+
+        ii = _iterinfo(self)
+        ii.rebuild(year, month)
+
+        getdayset = {YEARLY: ii.ydayset,
+                     MONTHLY: ii.mdayset,
+                     WEEKLY: ii.wdayset,
+                     DAILY: ii.ddayset,
+                     HOURLY: ii.ddayset,
+                     MINUTELY: ii.ddayset,
+                     SECONDLY: ii.ddayset}[freq]
+
+        if freq < HOURLY:
+            timeset = self._timeset
+        else:
+            gettimeset = {HOURLY: ii.htimeset,
+                          MINUTELY: ii.mtimeset,
+                          SECONDLY: ii.stimeset}[freq]
+            if ((freq >= HOURLY and
+                 self._byhour and hour not in self._byhour) or
+                (freq >= MINUTELY and
+                 self._byminute and minute not in self._byminute) or
+                (freq >= SECONDLY and
+                 self._bysecond and second not in self._bysecond)):
+                timeset = ()
+            else:
+                timeset = gettimeset(hour, minute, second)
+
+        total = 0
+        count = self._count
+        while True:
+            # Get dayset with the right frequency
+            dayset, start, end = getdayset(year, month, day)
+
+            # Do the "hard" work ;-)
+            filtered = False
+            for i in dayset[start:end]:
+                if ((bymonth and ii.mmask[i] not in bymonth) or
+                    (byweekno and not ii.wnomask[i]) or
+                    (byweekday and ii.wdaymask[i] not in byweekday) or
+                    (ii.nwdaymask and not ii.nwdaymask[i]) or
+                    (byeaster and not ii.eastermask[i]) or
+                    ((bymonthday or bynmonthday) and
+                     ii.mdaymask[i] not in bymonthday and
+                     ii.nmdaymask[i] not in bynmonthday) or
+                    (byyearday and
+                     ((i < ii.yearlen and i+1 not in byyearday and
+                       -ii.yearlen+i not in byyearday) or
+                      (i >= ii.yearlen and i+1-ii.yearlen not in byyearday and
+                       -ii.nextyearlen+i-ii.yearlen not in byyearday)))):
+                    dayset[i] = None
+                    filtered = True
+
+            # Output results
+            if bysetpos and timeset:
+                poslist = []
+                for pos in bysetpos:
+                    if pos < 0:
+                        daypos, timepos = divmod(pos, len(timeset))
+                    else:
+                        daypos, timepos = divmod(pos-1, len(timeset))
+                    try:
+                        i = [x for x in dayset[start:end]
+                             if x is not None][daypos]
+                        time = timeset[timepos]
+                    except IndexError:
+                        pass
+                    else:
+                        date = datetime.date.fromordinal(ii.yearordinal+i)
+                        res = datetime.datetime.combine(date, time)
+                        if res not in poslist:
+                            poslist.append(res)
+                poslist.sort()
+                for res in poslist:
+                    if until and res > until:
+                        self._len = total
+                        return
+                    elif res >= self._dtstart:
+                        if count is not None:
+                            count -= 1
+                            if count < 0:
+                                self._len = total
+                                return
+                        total += 1
+                        yield res
+            else:
+                for i in dayset[start:end]:
+                    if i is not None:
+                        date = datetime.date.fromordinal(ii.yearordinal + i)
+                        for time in timeset:
+                            res = datetime.datetime.combine(date, time)
+                            if until and res > until:
+                                self._len = total
+                                return
+                            elif res >= self._dtstart:
+                                if count is not None:
+                                    count -= 1
+                                    if count < 0:
+                                        self._len = total
+                                        return
+
+                                total += 1
+                                yield res
+
+            # Handle frequency and interval
+            fixday = False
+            if freq == YEARLY:
+                year += interval
+                if year > datetime.MAXYEAR:
+                    self._len = total
+                    return
+                ii.rebuild(year, month)
+            elif freq == MONTHLY:
+                month += interval
+                if month > 12:
+                    div, mod = divmod(month, 12)
+                    month = mod
+                    year += div
+                    if month == 0:
+                        month = 12
+                        year -= 1
+                    if year > datetime.MAXYEAR:
+                        self._len = total
+                        return
+                ii.rebuild(year, month)
+            elif freq == WEEKLY:
+                if wkst > weekday:
+                    day += -(weekday+1+(6-wkst))+self._interval*7
+                else:
+                    day += -(weekday-wkst)+self._interval*7
+                weekday = wkst
+                fixday = True
+            elif freq == DAILY:
+                day += interval
+                fixday = True
+            elif freq == HOURLY:
+                if filtered:
+                    # Jump to one iteration before next day
+                    hour += ((23-hour)//interval)*interval
+
+                if byhour:
+                    ndays, hour = self.__mod_distance(value=hour,
+                                                      byxxx=self._byhour,
+                                                      base=24)
+                else:
+                    ndays, hour = divmod(hour+interval, 24)
+
+                if ndays:
+                    day += ndays
+                    fixday = True
+
+                timeset = gettimeset(hour, minute, second)
+            elif freq == MINUTELY:
+                if filtered:
+                    # Jump to one iteration before next day
+                    minute += ((1439-(hour*60+minute))//interval)*interval
+
+                valid = False
+                rep_rate = (24*60)
+                for j in range(rep_rate // gcd(interval, rep_rate)):
+                    if byminute:
+                        nhours, minute = \
+                            self.__mod_distance(value=minute,
+                                                byxxx=self._byminute,
+                                                base=60)
+                    else:
+                        nhours, minute = divmod(minute+interval, 60)
+
+                    div, hour = divmod(hour+nhours, 24)
+                    if div:
+                        day += div
+                        fixday = True
+                        filtered = False
+
+                    if not byhour or hour in byhour:
+                        valid = True
+                        break
+
+                if not valid:
+                    raise ValueError('Invalid combination of interval and ' +
+                                     'byhour resulting in empty rule.')
+
+                timeset = gettimeset(hour, minute, second)
+            elif freq == SECONDLY:
+                if filtered:
+                    # Jump to one iteration before next day
+                    second += (((86399 - (hour * 3600 + minute * 60 + second))
+                                // interval) * interval)
+
+                rep_rate = (24 * 3600)
+                valid = False
+                for j in range(0, rep_rate // gcd(interval, rep_rate)):
+                    if bysecond:
+                        nminutes, second = \
+                            self.__mod_distance(value=second,
+                                                byxxx=self._bysecond,
+                                                base=60)
+                    else:
+                        nminutes, second = divmod(second+interval, 60)
+
+                    div, minute = divmod(minute+nminutes, 60)
+                    if div:
+                        hour += div
+                        div, hour = divmod(hour, 24)
+                        if div:
+                            day += div
+                            fixday = True
+
+                    if ((not byhour or hour in byhour) and
+                            (not byminute or minute in byminute) and
+                            (not bysecond or second in bysecond)):
+                        valid = True
+                        break
+
+                if not valid:
+                    raise ValueError('Invalid combination of interval, ' +
+                                     'byhour and byminute resulting in empty' +
+                                     ' rule.')
+
+                timeset = gettimeset(hour, minute, second)
+
+            if fixday and day > 28:
+                daysinmonth = calendar.monthrange(year, month)[1]
+                if day > daysinmonth:
+                    while day > daysinmonth:
+                        day -= daysinmonth
+                        month += 1
+                        if month == 13:
+                            month = 1
+                            year += 1
+                            if year > datetime.MAXYEAR:
+                                self._len = total
+                                return
+                        daysinmonth = calendar.monthrange(year, month)[1]
+                    ii.rebuild(year, month)
+
+    def __construct_byset(self, start, byxxx, base):
+        """
+        If a `BYXXX` sequence is passed to the constructor at the same level as
+        `FREQ` (e.g. `FREQ=HOURLY,BYHOUR={2,4,7},INTERVAL=3`), there are some
+        specifications which cannot be reached given some starting conditions.
+
+        This occurs whenever the interval is not coprime with the base of a
+        given unit and the difference between the starting position and the
+        ending position is not coprime with the greatest common denominator
+        between the interval and the base. For example, with a FREQ of hourly
+        starting at 17:00 and an interval of 4, the only valid values for
+        BYHOUR would be {21, 1, 5, 9, 13, 17}, because 4 and 24 are not
+        coprime.
+
+        :param start:
+            Specifies the starting position.
+        :param byxxx:
+            An iterable containing the list of allowed values.
+        :param base:
+            The largest allowable value for the specified frequency (e.g.
+            24 hours, 60 minutes).
+
+        This does not preserve the type of the iterable, returning a set, since
+        the values should be unique and the order is irrelevant, this will
+        speed up later lookups.
+
+        In the event of an empty set, raises a :exception:`ValueError`, as this
+        results in an empty rrule.
+        """
+
+        cset = set()
+
+        # Support a single byxxx value.
+        if isinstance(byxxx, integer_types):
+            byxxx = (byxxx, )
+
+        for num in byxxx:
+            i_gcd = gcd(self._interval, base)
+            # Use divmod rather than % because we need to wrap negative nums.
+            if i_gcd == 1 or divmod(num - start, i_gcd)[1] == 0:
+                cset.add(num)
+
+        if len(cset) == 0:
+            raise ValueError("Invalid rrule byxxx generates an empty set.")
+
+        return cset
+
+    def __mod_distance(self, value, byxxx, base):
+        """
+        Calculates the next value in a sequence where the `FREQ` parameter is
+        specified along with a `BYXXX` parameter at the same "level"
+        (e.g. `HOURLY` specified with `BYHOUR`).
+
+        :param value:
+            The old value of the component.
+        :param byxxx:
+            The `BYXXX` set, which should have been generated by
+            `rrule._construct_byset`, or something else which checks that a
+            valid rule is present.
+        :param base:
+            The largest allowable value for the specified frequency (e.g.
+            24 hours, 60 minutes).
+
+        If a valid value is not found after `base` iterations (the maximum
+        number before the sequence would start to repeat), this raises a
+        :exception:`ValueError`, as no valid values were found.
+
+        This returns a tuple of `divmod(n*interval, base)`, where `n` is the
+        smallest number of `interval` repetitions until the next specified
+        value in `byxxx` is found.
+        """
+        accumulator = 0
+        for ii in range(1, base + 1):
+            # Using divmod() over % to account for negative intervals
+            div, value = divmod(value + self._interval, base)
+            accumulator += div
+            if value in byxxx:
+                return (accumulator, value)
+
+
+class _iterinfo(object):
+    __slots__ = ["rrule", "lastyear", "lastmonth",
+                 "yearlen", "nextyearlen", "yearordinal", "yearweekday",
+                 "mmask", "mrange", "mdaymask", "nmdaymask",
+                 "wdaymask", "wnomask", "nwdaymask", "eastermask"]
+
+    def __init__(self, rrule):
+        for attr in self.__slots__:
+            setattr(self, attr, None)
+        self.rrule = rrule
+
+    def rebuild(self, year, month):
+        # Every mask is 7 days longer to handle cross-year weekly periods.
+        rr = self.rrule
+        if year != self.lastyear:
+            self.yearlen = 365 + calendar.isleap(year)
+            self.nextyearlen = 365 + calendar.isleap(year + 1)
+            firstyday = datetime.date(year, 1, 1)
+            self.yearordinal = firstyday.toordinal()
+            self.yearweekday = firstyday.weekday()
+
+            wday = datetime.date(year, 1, 1).weekday()
+            if self.yearlen == 365:
+                self.mmask = M365MASK
+                self.mdaymask = MDAY365MASK
+                self.nmdaymask = NMDAY365MASK
+                self.wdaymask = WDAYMASK[wday:]
+                self.mrange = M365RANGE
+            else:
+                self.mmask = M366MASK
+                self.mdaymask = MDAY366MASK
+                self.nmdaymask = NMDAY366MASK
+                self.wdaymask = WDAYMASK[wday:]
+                self.mrange = M366RANGE
+
+            if not rr._byweekno:
+                self.wnomask = None
+            else:
+                self.wnomask = [0]*(self.yearlen+7)
+                # no1wkst = firstwkst = self.wdaymask.index(rr._wkst)
+                no1wkst = firstwkst = (7-self.yearweekday+rr._wkst) % 7
+                if no1wkst >= 4:
+                    no1wkst = 0
+                    # Number of days in the year, plus the days we got
+                    # from last year.
+                    wyearlen = self.yearlen+(self.yearweekday-rr._wkst) % 7
+                else:
+                    # Number of days in the year, minus the days we
+                    # left in last year.
+                    wyearlen = self.yearlen-no1wkst
+                div, mod = divmod(wyearlen, 7)
+                numweeks = div+mod//4
+                for n in rr._byweekno:
+                    if n < 0:
+                        n += numweeks+1
+                    if not (0 < n <= numweeks):
+                        continue
+                    if n > 1:
+                        i = no1wkst+(n-1)*7
+                        if no1wkst != firstwkst:
+                            i -= 7-firstwkst
+                    else:
+                        i = no1wkst
+                    for j in range(7):
+                        self.wnomask[i] = 1
+                        i += 1
+                        if self.wdaymask[i] == rr._wkst:
+                            break
+                if 1 in rr._byweekno:
+                    # Check week number 1 of next year as well
+                    # TODO: Check -numweeks for next year.
+                    i = no1wkst+numweeks*7
+                    if no1wkst != firstwkst:
+                        i -= 7-firstwkst
+                    if i < self.yearlen:
+                        # If week starts in next year, we
+                        # don't care about it.
+                        for j in range(7):
+                            self.wnomask[i] = 1
+                            i += 1
+                            if self.wdaymask[i] == rr._wkst:
+                                break
+                if no1wkst:
+                    # Check last week number of last year as
+                    # well. If no1wkst is 0, either the year
+                    # started on week start, or week number 1
+                    # got days from last year, so there are no
+                    # days from last year's last week number in
+                    # this year.
+                    if -1 not in rr._byweekno:
+                        lyearweekday = datetime.date(year-1, 1, 1).weekday()
+                        lno1wkst = (7-lyearweekday+rr._wkst) % 7
+                        lyearlen = 365+calendar.isleap(year-1)
+                        if lno1wkst >= 4:
+                            lno1wkst = 0
+                            lnumweeks = 52+(lyearlen +
+                                            (lyearweekday-rr._wkst) % 7) % 7//4
+                        else:
+                            lnumweeks = 52+(self.yearlen-no1wkst) % 7//4
+                    else:
+                        lnumweeks = -1
+                    if lnumweeks in rr._byweekno:
+                        for i in range(no1wkst):
+                            self.wnomask[i] = 1
+
+        if (rr._bynweekday and (month != self.lastmonth or
+                                year != self.lastyear)):
+            ranges = []
+            if rr._freq == YEARLY:
+                if rr._bymonth:
+                    for month in rr._bymonth:
+                        ranges.append(self.mrange[month-1:month+1])
+                else:
+                    ranges = [(0, self.yearlen)]
+            elif rr._freq == MONTHLY:
+                ranges = [self.mrange[month-1:month+1]]
+            if ranges:
+                # Weekly frequency won't get here, so we may not
+                # care about cross-year weekly periods.
+                self.nwdaymask = [0]*self.yearlen
+                for first, last in ranges:
+                    last -= 1
+                    for wday, n in rr._bynweekday:
+                        if n < 0:
+                            i = last+(n+1)*7
+                            i -= (self.wdaymask[i]-wday) % 7
+                        else:
+                            i = first+(n-1)*7
+                            i += (7-self.wdaymask[i]+wday) % 7
+                        if first <= i <= last:
+                            self.nwdaymask[i] = 1
+
+        if rr._byeaster:
+            self.eastermask = [0]*(self.yearlen+7)
+            eyday = easter.easter(year).toordinal()-self.yearordinal
+            for offset in rr._byeaster:
+                self.eastermask[eyday+offset] = 1
+
+        self.lastyear = year
+        self.lastmonth = month
+
+    def ydayset(self, year, month, day):
+        return list(range(self.yearlen)), 0, self.yearlen
+
+    def mdayset(self, year, month, day):
+        dset = [None]*self.yearlen
+        start, end = self.mrange[month-1:month+1]
+        for i in range(start, end):
+            dset[i] = i
+        return dset, start, end
+
+    def wdayset(self, year, month, day):
+        # We need to handle cross-year weeks here.
+        dset = [None]*(self.yearlen+7)
+        i = datetime.date(year, month, day).toordinal()-self.yearordinal
+        start = i
+        for j in range(7):
+            dset[i] = i
+            i += 1
+            # if (not (0 <= i < self.yearlen) or
+            #    self.wdaymask[i] == self.rrule._wkst):
+            # This will cross the year boundary, if necessary.
+            if self.wdaymask[i] == self.rrule._wkst:
+                break
+        return dset, start, i
+
+    def ddayset(self, year, month, day):
+        dset = [None] * self.yearlen
+        i = datetime.date(year, month, day).toordinal() - self.yearordinal
+        dset[i] = i
+        return dset, i, i + 1
+
+    def htimeset(self, hour, minute, second):
+        tset = []
+        rr = self.rrule
+        for minute in rr._byminute:
+            for second in rr._bysecond:
+                tset.append(datetime.time(hour, minute, second,
+                                          tzinfo=rr._tzinfo))
+        tset.sort()
+        return tset
+
+    def mtimeset(self, hour, minute, second):
+        tset = []
+        rr = self.rrule
+        for second in rr._bysecond:
+            tset.append(datetime.time(hour, minute, second, tzinfo=rr._tzinfo))
+        tset.sort()
+        return tset
+
+    def stimeset(self, hour, minute, second):
+        return (datetime.time(hour, minute, second,
+                tzinfo=self.rrule._tzinfo),)
+
+
+class rruleset(rrulebase):
+    """ The rruleset type allows more complex recurrence setups, mixing
+    multiple rules, dates, exclusion rules, and exclusion dates. The type
+    constructor takes the following keyword arguments:
+
+    :param cache: If True, caching of results will be enabled, improving
+                  performance of multiple queries considerably. """
+
+    class _genitem(object):
+        def __init__(self, genlist, gen):
+            try:
+                self.dt = advance_iterator(gen)
+                genlist.append(self)
+            except StopIteration:
+                pass
+            self.genlist = genlist
+            self.gen = gen
+
+        def __next__(self):
+            try:
+                self.dt = advance_iterator(self.gen)
+            except StopIteration:
+                if self.genlist[0] is self:
+                    heapq.heappop(self.genlist)
+                else:
+                    self.genlist.remove(self)
+                    heapq.heapify(self.genlist)
+
+        next = __next__
+
+        def __lt__(self, other):
+            return self.dt < other.dt
+
+        def __gt__(self, other):
+            return self.dt > other.dt
+
+        def __eq__(self, other):
+            return self.dt == other.dt
+
+        def __ne__(self, other):
+            return self.dt != other.dt
+
+    def __init__(self, cache=False):
+        super(rruleset, self).__init__(cache)
+        self._rrule = []
+        self._rdate = []
+        self._exrule = []
+        self._exdate = []
+
+    @_invalidates_cache
+    def rrule(self, rrule):
+        """ Include the given :py:class:`rrule` instance in the recurrence set
+            generation. """
+        self._rrule.append(rrule)
+
+    @_invalidates_cache
+    def rdate(self, rdate):
+        """ Include the given :py:class:`datetime` instance in the recurrence
+            set generation. """
+        self._rdate.append(rdate)
+
+    @_invalidates_cache
+    def exrule(self, exrule):
+        """ Include the given rrule instance in the recurrence set exclusion
+            list. Dates which are part of the given recurrence rules will not
+            be generated, even if some inclusive rrule or rdate matches them.
+        """
+        self._exrule.append(exrule)
+
+    @_invalidates_cache
+    def exdate(self, exdate):
+        """ Include the given datetime instance in the recurrence set
+            exclusion list. Dates included that way will not be generated,
+            even if some inclusive rrule or rdate matches them. """
+        self._exdate.append(exdate)
+
+    def _iter(self):
+        rlist = []
+        self._rdate.sort()
+        self._genitem(rlist, iter(self._rdate))
+        for gen in [iter(x) for x in self._rrule]:
+            self._genitem(rlist, gen)
+        exlist = []
+        self._exdate.sort()
+        self._genitem(exlist, iter(self._exdate))
+        for gen in [iter(x) for x in self._exrule]:
+            self._genitem(exlist, gen)
+        lastdt = None
+        total = 0
+        heapq.heapify(rlist)
+        heapq.heapify(exlist)
+        while rlist:
+            ritem = rlist[0]
+            if not lastdt or lastdt != ritem.dt:
+                while exlist and exlist[0] < ritem:
+                    exitem = exlist[0]
+                    advance_iterator(exitem)
+                    if exlist and exlist[0] is exitem:
+                        heapq.heapreplace(exlist, exitem)
+                if not exlist or ritem != exlist[0]:
+                    total += 1
+                    yield ritem.dt
+                lastdt = ritem.dt
+            advance_iterator(ritem)
+            if rlist and rlist[0] is ritem:
+                heapq.heapreplace(rlist, ritem)
+        self._len = total
+
+
+
+
+class _rrulestr(object):
+    """ Parses a string representation of a recurrence rule or set of
+    recurrence rules.
+
+    :param s:
+        Required, a string defining one or more recurrence rules.
+
+    :param dtstart:
+        If given, used as the default recurrence start if not specified in the
+        rule string.
+
+    :param cache:
+        If set ``True`` caching of results will be enabled, improving
+        performance of multiple queries considerably.
+
+    :param unfold:
+        If set ``True`` indicates that a rule string is split over more
+        than one line and should be joined before processing.
+
+    :param forceset:
+        If set ``True`` forces a :class:`dateutil.rrule.rruleset` to
+        be returned.
+
+    :param compatible:
+        If set ``True`` forces ``unfold`` and ``forceset`` to be ``True``.
+
+    :param ignoretz:
+        If set ``True``, time zones in parsed strings are ignored and a naive
+        :class:`datetime.datetime` object is returned.
+
+    :param tzids:
+        If given, a callable or mapping used to retrieve a
+        :class:`datetime.tzinfo` from a string representation.
+        Defaults to :func:`dateutil.tz.gettz`.
+
+    :param tzinfos:
+        Additional time zone names / aliases which may be present in a string
+        representation.  See :func:`dateutil.parser.parse` for more
+        information.
+
+    :return:
+        Returns a :class:`dateutil.rrule.rruleset` or
+        :class:`dateutil.rrule.rrule`
+    """
+
+    _freq_map = {"YEARLY": YEARLY,
+                 "MONTHLY": MONTHLY,
+                 "WEEKLY": WEEKLY,
+                 "DAILY": DAILY,
+                 "HOURLY": HOURLY,
+                 "MINUTELY": MINUTELY,
+                 "SECONDLY": SECONDLY}
+
+    _weekday_map = {"MO": 0, "TU": 1, "WE": 2, "TH": 3,
+                    "FR": 4, "SA": 5, "SU": 6}
+
+    def _handle_int(self, rrkwargs, name, value, **kwargs):
+        rrkwargs[name.lower()] = int(value)
+
+    def _handle_int_list(self, rrkwargs, name, value, **kwargs):
+        rrkwargs[name.lower()] = [int(x) for x in value.split(',')]
+
+    _handle_INTERVAL = _handle_int
+    _handle_COUNT = _handle_int
+    _handle_BYSETPOS = _handle_int_list
+    _handle_BYMONTH = _handle_int_list
+    _handle_BYMONTHDAY = _handle_int_list
+    _handle_BYYEARDAY = _handle_int_list
+    _handle_BYEASTER = _handle_int_list
+    _handle_BYWEEKNO = _handle_int_list
+    _handle_BYHOUR = _handle_int_list
+    _handle_BYMINUTE = _handle_int_list
+    _handle_BYSECOND = _handle_int_list
+
+    def _handle_FREQ(self, rrkwargs, name, value, **kwargs):
+        rrkwargs["freq"] = self._freq_map[value]
+
+    def _handle_UNTIL(self, rrkwargs, name, value, **kwargs):
+        global parser
+        if not parser:
+            from dateutil import parser
+        try:
+            rrkwargs["until"] = parser.parse(value,
+                                             ignoretz=kwargs.get("ignoretz"),
+                                             tzinfos=kwargs.get("tzinfos"))
+        except ValueError:
+            raise ValueError("invalid until date")
+
+    def _handle_WKST(self, rrkwargs, name, value, **kwargs):
+        rrkwargs["wkst"] = self._weekday_map[value]
+
+    def _handle_BYWEEKDAY(self, rrkwargs, name, value, **kwargs):
+        """
+        Two ways to specify this: +1MO or MO(+1)
+        """
+        l = []
+        for wday in value.split(','):
+            if '(' in wday:
+                # If it's of the form TH(+1), etc.
+                splt = wday.split('(')
+                w = splt[0]
+                n = int(splt[1][:-1])
+            elif len(wday):
+                # If it's of the form +1MO
+                for i in range(len(wday)):
+                    if wday[i] not in '+-0123456789':
+                        break
+                n = wday[:i] or None
+                w = wday[i:]
+                if n:
+                    n = int(n)
+            else:
+                raise ValueError("Invalid (empty) BYDAY specification.")
+
+            l.append(weekdays[self._weekday_map[w]](n))
+        rrkwargs["byweekday"] = l
+
+    _handle_BYDAY = _handle_BYWEEKDAY
+
+    def _parse_rfc_rrule(self, line,
+                         dtstart=None,
+                         cache=False,
+                         ignoretz=False,
+                         tzinfos=None):
+        if line.find(':') != -1:
+            name, value = line.split(':')
+            if name != "RRULE":
+                raise ValueError("unknown parameter name")
+        else:
+            value = line
+        rrkwargs = {}
+        for pair in value.split(';'):
+            name, value = pair.split('=')
+            name = name.upper()
+            value = value.upper()
+            try:
+                getattr(self, "_handle_"+name)(rrkwargs, name, value,
+                                               ignoretz=ignoretz,
+                                               tzinfos=tzinfos)
+            except AttributeError:
+                raise ValueError("unknown parameter '%s'" % name)
+            except (KeyError, ValueError):
+                raise ValueError("invalid '%s': %s" % (name, value))
+        return rrule(dtstart=dtstart, cache=cache, **rrkwargs)
+
+    def _parse_date_value(self, date_value, parms, rule_tzids,
+                          ignoretz, tzids, tzinfos):
+        global parser
+        if not parser:
+            from dateutil import parser
+
+        datevals = []
+        value_found = False
+        TZID = None
+
+        for parm in parms:
+            if parm.startswith("TZID="):
+                try:
+                    tzkey = rule_tzids[parm.split('TZID=')[-1]]
+                except KeyError:
+                    continue
+                if tzids is None:
+                    from . import tz
+                    tzlookup = tz.gettz
+                elif callable(tzids):
+                    tzlookup = tzids
+                else:
+                    tzlookup = getattr(tzids, 'get', None)
+                    if tzlookup is None:
+                        msg = ('tzids must be a callable, mapping, or None, '
+                               'not %s' % tzids)
+                        raise ValueError(msg)
+
+                TZID = tzlookup(tzkey)
+                continue
+
+            # RFC 5445 3.8.2.4: The VALUE parameter is optional, but may be found
+            # only once.
+            if parm not in {"VALUE=DATE-TIME", "VALUE=DATE"}:
+                raise ValueError("unsupported parm: " + parm)
+            else:
+                if value_found:
+                    msg = ("Duplicate value parameter found in: " + parm)
+                    raise ValueError(msg)
+                value_found = True
+
+        for datestr in date_value.split(','):
+            date = parser.parse(datestr, ignoretz=ignoretz, tzinfos=tzinfos)
+            if TZID is not None:
+                if date.tzinfo is None:
+                    date = date.replace(tzinfo=TZID)
+                else:
+                    raise ValueError('DTSTART/EXDATE specifies multiple timezone')
+            datevals.append(date)
+
+        return datevals
+
+    def _parse_rfc(self, s,
+                   dtstart=None,
+                   cache=False,
+                   unfold=False,
+                   forceset=False,
+                   compatible=False,
+                   ignoretz=False,
+                   tzids=None,
+                   tzinfos=None):
+        global parser
+        if compatible:
+            forceset = True
+            unfold = True
+
+        TZID_NAMES = dict(map(
+            lambda x: (x.upper(), x),
+            re.findall('TZID=(?P<name>[^:]+):', s)
+        ))
+        s = s.upper()
+        if not s.strip():
+            raise ValueError("empty string")
+        if unfold:
+            lines = s.splitlines()
+            i = 0
+            while i < len(lines):
+                line = lines[i].rstrip()
+                if not line:
+                    del lines[i]
+                elif i > 0 and line[0] == " ":
+                    lines[i-1] += line[1:]
+                    del lines[i]
+                else:
+                    i += 1
+        else:
+            lines = s.split()
+        if (not forceset and len(lines) == 1 and (s.find(':') == -1 or
+                                                  s.startswith('RRULE:'))):
+            return self._parse_rfc_rrule(lines[0], cache=cache,
+                                         dtstart=dtstart, ignoretz=ignoretz,
+                                         tzinfos=tzinfos)
+        else:
+            rrulevals = []
+            rdatevals = []
+            exrulevals = []
+            exdatevals = []
+            for line in lines:
+                if not line:
+                    continue
+                if line.find(':') == -1:
+                    name = "RRULE"
+                    value = line
+                else:
+                    name, value = line.split(':', 1)
+                parms = name.split(';')
+                if not parms:
+                    raise ValueError("empty property name")
+                name = parms[0]
+                parms = parms[1:]
+                if name == "RRULE":
+                    for parm in parms:
+                        raise ValueError("unsupported RRULE parm: "+parm)
+                    rrulevals.append(value)
+                elif name == "RDATE":
+                    for parm in parms:
+                        if parm != "VALUE=DATE-TIME":
+                            raise ValueError("unsupported RDATE parm: "+parm)
+                    rdatevals.append(value)
+                elif name == "EXRULE":
+                    for parm in parms:
+                        raise ValueError("unsupported EXRULE parm: "+parm)
+                    exrulevals.append(value)
+                elif name == "EXDATE":
+                    exdatevals.extend(
+                        self._parse_date_value(value, parms,
+                                               TZID_NAMES, ignoretz,
+                                               tzids, tzinfos)
+                    )
+                elif name == "DTSTART":
+                    dtvals = self._parse_date_value(value, parms, TZID_NAMES,
+                                                    ignoretz, tzids, tzinfos)
+                    if len(dtvals) != 1:
+                        raise ValueError("Multiple DTSTART values specified:" +
+                                         value)
+                    dtstart = dtvals[0]
+                else:
+                    raise ValueError("unsupported property: "+name)
+            if (forceset or len(rrulevals) > 1 or rdatevals
+                    or exrulevals or exdatevals):
+                if not parser and (rdatevals or exdatevals):
+                    from dateutil import parser
+                rset = rruleset(cache=cache)
+                for value in rrulevals:
+                    rset.rrule(self._parse_rfc_rrule(value, dtstart=dtstart,
+                                                     ignoretz=ignoretz,
+                                                     tzinfos=tzinfos))
+                for value in rdatevals:
+                    for datestr in value.split(','):
+                        rset.rdate(parser.parse(datestr,
+                                                ignoretz=ignoretz,
+                                                tzinfos=tzinfos))
+                for value in exrulevals:
+                    rset.exrule(self._parse_rfc_rrule(value, dtstart=dtstart,
+                                                      ignoretz=ignoretz,
+                                                      tzinfos=tzinfos))
+                for value in exdatevals:
+                    rset.exdate(value)
+                if compatible and dtstart:
+                    rset.rdate(dtstart)
+                return rset
+            else:
+                return self._parse_rfc_rrule(rrulevals[0],
+                                             dtstart=dtstart,
+                                             cache=cache,
+                                             ignoretz=ignoretz,
+                                             tzinfos=tzinfos)
+
+    def __call__(self, s, **kwargs):
+        return self._parse_rfc(s, **kwargs)
+
+
+rrulestr = _rrulestr()
+
+# vim:ts=4:sw=4:et
diff --git a/llm/Lib/site-packages/dateutil/tz/__init__.py b/llm/Lib/site-packages/dateutil/tz/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..af1352c47292f4eebc5cae8da45641b5544558e3
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/tz/__init__.py
@@ -0,0 +1,12 @@
+# -*- coding: utf-8 -*-
+from .tz import *
+from .tz import __doc__
+
+__all__ = ["tzutc", "tzoffset", "tzlocal", "tzfile", "tzrange",
+           "tzstr", "tzical", "tzwin", "tzwinlocal", "gettz",
+           "enfold", "datetime_ambiguous", "datetime_exists",
+           "resolve_imaginary", "UTC", "DeprecatedTzFormatWarning"]
+
+
+class DeprecatedTzFormatWarning(Warning):
+    """Warning raised when time zones are parsed from deprecated formats."""
diff --git a/llm/Lib/site-packages/dateutil/tz/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/dateutil/tz/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8575140e10f2852ec2fdce344386772843b3c150
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/tz/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/tz/__pycache__/_common.cpython-311.pyc b/llm/Lib/site-packages/dateutil/tz/__pycache__/_common.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ecebedbfb2187576f422cfa93b36586d2402399d
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/tz/__pycache__/_common.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/tz/__pycache__/_factories.cpython-311.pyc b/llm/Lib/site-packages/dateutil/tz/__pycache__/_factories.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..06b6e0072afb4d15a4d3556f7420c1b1c303cf6b
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/tz/__pycache__/_factories.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/tz/__pycache__/tz.cpython-311.pyc b/llm/Lib/site-packages/dateutil/tz/__pycache__/tz.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d0b224e23a05a6374499a99d45fd820fcf755999
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/tz/__pycache__/tz.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/tz/__pycache__/win.cpython-311.pyc b/llm/Lib/site-packages/dateutil/tz/__pycache__/win.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bd5dcc6d86ed7c7faa61ed434a20d65e3f461c06
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/tz/__pycache__/win.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/tz/_common.py b/llm/Lib/site-packages/dateutil/tz/_common.py
new file mode 100644
index 0000000000000000000000000000000000000000..e6ac11831522b266114d5b68ee1da298e3aeb14a
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/tz/_common.py
@@ -0,0 +1,419 @@
+from six import PY2
+
+from functools import wraps
+
+from datetime import datetime, timedelta, tzinfo
+
+
+ZERO = timedelta(0)
+
+__all__ = ['tzname_in_python2', 'enfold']
+
+
+def tzname_in_python2(namefunc):
+    """Change unicode output into bytestrings in Python 2
+
+    tzname() API changed in Python 3. It used to return bytes, but was changed
+    to unicode strings
+    """
+    if PY2:
+        @wraps(namefunc)
+        def adjust_encoding(*args, **kwargs):
+            name = namefunc(*args, **kwargs)
+            if name is not None:
+                name = name.encode()
+
+            return name
+
+        return adjust_encoding
+    else:
+        return namefunc
+
+
+# The following is adapted from Alexander Belopolsky's tz library
+# https://github.com/abalkin/tz
+if hasattr(datetime, 'fold'):
+    # This is the pre-python 3.6 fold situation
+    def enfold(dt, fold=1):
+        """
+        Provides a unified interface for assigning the ``fold`` attribute to
+        datetimes both before and after the implementation of PEP-495.
+
+        :param fold:
+            The value for the ``fold`` attribute in the returned datetime. This
+            should be either 0 or 1.
+
+        :return:
+            Returns an object for which ``getattr(dt, 'fold', 0)`` returns
+            ``fold`` for all versions of Python. In versions prior to
+            Python 3.6, this is a ``_DatetimeWithFold`` object, which is a
+            subclass of :py:class:`datetime.datetime` with the ``fold``
+            attribute added, if ``fold`` is 1.
+
+        .. versionadded:: 2.6.0
+        """
+        return dt.replace(fold=fold)
+
+else:
+    class _DatetimeWithFold(datetime):
+        """
+        This is a class designed to provide a PEP 495-compliant interface for
+        Python versions before 3.6. It is used only for dates in a fold, so
+        the ``fold`` attribute is fixed at ``1``.
+
+        .. versionadded:: 2.6.0
+        """
+        __slots__ = ()
+
+        def replace(self, *args, **kwargs):
+            """
+            Return a datetime with the same attributes, except for those
+            attributes given new values by whichever keyword arguments are
+            specified. Note that tzinfo=None can be specified to create a naive
+            datetime from an aware datetime with no conversion of date and time
+            data.
+
+            This is reimplemented in ``_DatetimeWithFold`` because pypy3 will
+            return a ``datetime.datetime`` even if ``fold`` is unchanged.
+            """
+            argnames = (
+                'year', 'month', 'day', 'hour', 'minute', 'second',
+                'microsecond', 'tzinfo'
+            )
+
+            for arg, argname in zip(args, argnames):
+                if argname in kwargs:
+                    raise TypeError('Duplicate argument: {}'.format(argname))
+
+                kwargs[argname] = arg
+
+            for argname in argnames:
+                if argname not in kwargs:
+                    kwargs[argname] = getattr(self, argname)
+
+            dt_class = self.__class__ if kwargs.get('fold', 1) else datetime
+
+            return dt_class(**kwargs)
+
+        @property
+        def fold(self):
+            return 1
+
+    def enfold(dt, fold=1):
+        """
+        Provides a unified interface for assigning the ``fold`` attribute to
+        datetimes both before and after the implementation of PEP-495.
+
+        :param fold:
+            The value for the ``fold`` attribute in the returned datetime. This
+            should be either 0 or 1.
+
+        :return:
+            Returns an object for which ``getattr(dt, 'fold', 0)`` returns
+            ``fold`` for all versions of Python. In versions prior to
+            Python 3.6, this is a ``_DatetimeWithFold`` object, which is a
+            subclass of :py:class:`datetime.datetime` with the ``fold``
+            attribute added, if ``fold`` is 1.
+
+        .. versionadded:: 2.6.0
+        """
+        if getattr(dt, 'fold', 0) == fold:
+            return dt
+
+        args = dt.timetuple()[:6]
+        args += (dt.microsecond, dt.tzinfo)
+
+        if fold:
+            return _DatetimeWithFold(*args)
+        else:
+            return datetime(*args)
+
+
+def _validate_fromutc_inputs(f):
+    """
+    The CPython version of ``fromutc`` checks that the input is a ``datetime``
+    object and that ``self`` is attached as its ``tzinfo``.
+    """
+    @wraps(f)
+    def fromutc(self, dt):
+        if not isinstance(dt, datetime):
+            raise TypeError("fromutc() requires a datetime argument")
+        if dt.tzinfo is not self:
+            raise ValueError("dt.tzinfo is not self")
+
+        return f(self, dt)
+
+    return fromutc
+
+
+class _tzinfo(tzinfo):
+    """
+    Base class for all ``dateutil`` ``tzinfo`` objects.
+    """
+
+    def is_ambiguous(self, dt):
+        """
+        Whether or not the "wall time" of a given datetime is ambiguous in this
+        zone.
+
+        :param dt:
+            A :py:class:`datetime.datetime`, naive or time zone aware.
+
+
+        :return:
+            Returns ``True`` if ambiguous, ``False`` otherwise.
+
+        .. versionadded:: 2.6.0
+        """
+
+        dt = dt.replace(tzinfo=self)
+
+        wall_0 = enfold(dt, fold=0)
+        wall_1 = enfold(dt, fold=1)
+
+        same_offset = wall_0.utcoffset() == wall_1.utcoffset()
+        same_dt = wall_0.replace(tzinfo=None) == wall_1.replace(tzinfo=None)
+
+        return same_dt and not same_offset
+
+    def _fold_status(self, dt_utc, dt_wall):
+        """
+        Determine the fold status of a "wall" datetime, given a representation
+        of the same datetime as a (naive) UTC datetime. This is calculated based
+        on the assumption that ``dt.utcoffset() - dt.dst()`` is constant for all
+        datetimes, and that this offset is the actual number of hours separating
+        ``dt_utc`` and ``dt_wall``.
+
+        :param dt_utc:
+            Representation of the datetime as UTC
+
+        :param dt_wall:
+            Representation of the datetime as "wall time". This parameter must
+            either have a `fold` attribute or have a fold-naive
+            :class:`datetime.tzinfo` attached, otherwise the calculation may
+            fail.
+        """
+        if self.is_ambiguous(dt_wall):
+            delta_wall = dt_wall - dt_utc
+            _fold = int(delta_wall == (dt_utc.utcoffset() - dt_utc.dst()))
+        else:
+            _fold = 0
+
+        return _fold
+
+    def _fold(self, dt):
+        return getattr(dt, 'fold', 0)
+
+    def _fromutc(self, dt):
+        """
+        Given a timezone-aware datetime in a given timezone, calculates a
+        timezone-aware datetime in a new timezone.
+
+        Since this is the one time that we *know* we have an unambiguous
+        datetime object, we take this opportunity to determine whether the
+        datetime is ambiguous and in a "fold" state (e.g. if it's the first
+        occurrence, chronologically, of the ambiguous datetime).
+
+        :param dt:
+            A timezone-aware :class:`datetime.datetime` object.
+        """
+
+        # Re-implement the algorithm from Python's datetime.py
+        dtoff = dt.utcoffset()
+        if dtoff is None:
+            raise ValueError("fromutc() requires a non-None utcoffset() "
+                             "result")
+
+        # The original datetime.py code assumes that `dst()` defaults to
+        # zero during ambiguous times. PEP 495 inverts this presumption, so
+        # for pre-PEP 495 versions of python, we need to tweak the algorithm.
+        dtdst = dt.dst()
+        if dtdst is None:
+            raise ValueError("fromutc() requires a non-None dst() result")
+        delta = dtoff - dtdst
+
+        dt += delta
+        # Set fold=1 so we can default to being in the fold for
+        # ambiguous dates.
+        dtdst = enfold(dt, fold=1).dst()
+        if dtdst is None:
+            raise ValueError("fromutc(): dt.dst gave inconsistent "
+                             "results; cannot convert")
+        return dt + dtdst
+
+    @_validate_fromutc_inputs
+    def fromutc(self, dt):
+        """
+        Given a timezone-aware datetime in a given timezone, calculates a
+        timezone-aware datetime in a new timezone.
+
+        Since this is the one time that we *know* we have an unambiguous
+        datetime object, we take this opportunity to determine whether the
+        datetime is ambiguous and in a "fold" state (e.g. if it's the first
+        occurrence, chronologically, of the ambiguous datetime).
+
+        :param dt:
+            A timezone-aware :class:`datetime.datetime` object.
+        """
+        dt_wall = self._fromutc(dt)
+
+        # Calculate the fold status given the two datetimes.
+        _fold = self._fold_status(dt, dt_wall)
+
+        # Set the default fold value for ambiguous dates
+        return enfold(dt_wall, fold=_fold)
+
+
+class tzrangebase(_tzinfo):
+    """
+    This is an abstract base class for time zones represented by an annual
+    transition into and out of DST. Child classes should implement the following
+    methods:
+
+        * ``__init__(self, *args, **kwargs)``
+        * ``transitions(self, year)`` - this is expected to return a tuple of
+          datetimes representing the DST on and off transitions in standard
+          time.
+
+    A fully initialized ``tzrangebase`` subclass should also provide the
+    following attributes:
+        * ``hasdst``: Boolean whether or not the zone uses DST.
+        * ``_dst_offset`` / ``_std_offset``: :class:`datetime.timedelta` objects
+          representing the respective UTC offsets.
+        * ``_dst_abbr`` / ``_std_abbr``: Strings representing the timezone short
+          abbreviations in DST and STD, respectively.
+        * ``_hasdst``: Whether or not the zone has DST.
+
+    .. versionadded:: 2.6.0
+    """
+    def __init__(self):
+        raise NotImplementedError('tzrangebase is an abstract base class')
+
+    def utcoffset(self, dt):
+        isdst = self._isdst(dt)
+
+        if isdst is None:
+            return None
+        elif isdst:
+            return self._dst_offset
+        else:
+            return self._std_offset
+
+    def dst(self, dt):
+        isdst = self._isdst(dt)
+
+        if isdst is None:
+            return None
+        elif isdst:
+            return self._dst_base_offset
+        else:
+            return ZERO
+
+    @tzname_in_python2
+    def tzname(self, dt):
+        if self._isdst(dt):
+            return self._dst_abbr
+        else:
+            return self._std_abbr
+
+    def fromutc(self, dt):
+        """ Given a datetime in UTC, return local time """
+        if not isinstance(dt, datetime):
+            raise TypeError("fromutc() requires a datetime argument")
+
+        if dt.tzinfo is not self:
+            raise ValueError("dt.tzinfo is not self")
+
+        # Get transitions - if there are none, fixed offset
+        transitions = self.transitions(dt.year)
+        if transitions is None:
+            return dt + self.utcoffset(dt)
+
+        # Get the transition times in UTC
+        dston, dstoff = transitions
+
+        dston -= self._std_offset
+        dstoff -= self._std_offset
+
+        utc_transitions = (dston, dstoff)
+        dt_utc = dt.replace(tzinfo=None)
+
+        isdst = self._naive_isdst(dt_utc, utc_transitions)
+
+        if isdst:
+            dt_wall = dt + self._dst_offset
+        else:
+            dt_wall = dt + self._std_offset
+
+        _fold = int(not isdst and self.is_ambiguous(dt_wall))
+
+        return enfold(dt_wall, fold=_fold)
+
+    def is_ambiguous(self, dt):
+        """
+        Whether or not the "wall time" of a given datetime is ambiguous in this
+        zone.
+
+        :param dt:
+            A :py:class:`datetime.datetime`, naive or time zone aware.
+
+
+        :return:
+            Returns ``True`` if ambiguous, ``False`` otherwise.
+
+        .. versionadded:: 2.6.0
+        """
+        if not self.hasdst:
+            return False
+
+        start, end = self.transitions(dt.year)
+
+        dt = dt.replace(tzinfo=None)
+        return (end <= dt < end + self._dst_base_offset)
+
+    def _isdst(self, dt):
+        if not self.hasdst:
+            return False
+        elif dt is None:
+            return None
+
+        transitions = self.transitions(dt.year)
+
+        if transitions is None:
+            return False
+
+        dt = dt.replace(tzinfo=None)
+
+        isdst = self._naive_isdst(dt, transitions)
+
+        # Handle ambiguous dates
+        if not isdst and self.is_ambiguous(dt):
+            return not self._fold(dt)
+        else:
+            return isdst
+
+    def _naive_isdst(self, dt, transitions):
+        dston, dstoff = transitions
+
+        dt = dt.replace(tzinfo=None)
+
+        if dston < dstoff:
+            isdst = dston <= dt < dstoff
+        else:
+            isdst = not dstoff <= dt < dston
+
+        return isdst
+
+    @property
+    def _dst_base_offset(self):
+        return self._dst_offset - self._std_offset
+
+    __hash__ = None
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __repr__(self):
+        return "%s(...)" % self.__class__.__name__
+
+    __reduce__ = object.__reduce__
diff --git a/llm/Lib/site-packages/dateutil/tz/_factories.py b/llm/Lib/site-packages/dateutil/tz/_factories.py
new file mode 100644
index 0000000000000000000000000000000000000000..f8a65891a023ebf9eb0c24d391ba67541b7133f1
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/tz/_factories.py
@@ -0,0 +1,80 @@
+from datetime import timedelta
+import weakref
+from collections import OrderedDict
+
+from six.moves import _thread
+
+
+class _TzSingleton(type):
+    def __init__(cls, *args, **kwargs):
+        cls.__instance = None
+        super(_TzSingleton, cls).__init__(*args, **kwargs)
+
+    def __call__(cls):
+        if cls.__instance is None:
+            cls.__instance = super(_TzSingleton, cls).__call__()
+        return cls.__instance
+
+
+class _TzFactory(type):
+    def instance(cls, *args, **kwargs):
+        """Alternate constructor that returns a fresh instance"""
+        return type.__call__(cls, *args, **kwargs)
+
+
+class _TzOffsetFactory(_TzFactory):
+    def __init__(cls, *args, **kwargs):
+        cls.__instances = weakref.WeakValueDictionary()
+        cls.__strong_cache = OrderedDict()
+        cls.__strong_cache_size = 8
+
+        cls._cache_lock = _thread.allocate_lock()
+
+    def __call__(cls, name, offset):
+        if isinstance(offset, timedelta):
+            key = (name, offset.total_seconds())
+        else:
+            key = (name, offset)
+
+        instance = cls.__instances.get(key, None)
+        if instance is None:
+            instance = cls.__instances.setdefault(key,
+                                                  cls.instance(name, offset))
+
+        # This lock may not be necessary in Python 3. See GH issue #901
+        with cls._cache_lock:
+            cls.__strong_cache[key] = cls.__strong_cache.pop(key, instance)
+
+            # Remove an item if the strong cache is overpopulated
+            if len(cls.__strong_cache) > cls.__strong_cache_size:
+                cls.__strong_cache.popitem(last=False)
+
+        return instance
+
+
+class _TzStrFactory(_TzFactory):
+    def __init__(cls, *args, **kwargs):
+        cls.__instances = weakref.WeakValueDictionary()
+        cls.__strong_cache = OrderedDict()
+        cls.__strong_cache_size = 8
+
+        cls.__cache_lock = _thread.allocate_lock()
+
+    def __call__(cls, s, posix_offset=False):
+        key = (s, posix_offset)
+        instance = cls.__instances.get(key, None)
+
+        if instance is None:
+            instance = cls.__instances.setdefault(key,
+                cls.instance(s, posix_offset))
+
+        # This lock may not be necessary in Python 3. See GH issue #901
+        with cls.__cache_lock:
+            cls.__strong_cache[key] = cls.__strong_cache.pop(key, instance)
+
+            # Remove an item if the strong cache is overpopulated
+            if len(cls.__strong_cache) > cls.__strong_cache_size:
+                cls.__strong_cache.popitem(last=False)
+
+        return instance
+
diff --git a/llm/Lib/site-packages/dateutil/tz/tz.py b/llm/Lib/site-packages/dateutil/tz/tz.py
new file mode 100644
index 0000000000000000000000000000000000000000..617591446bd92eb1cc7b7d67fa3f17435e691cdd
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/tz/tz.py
@@ -0,0 +1,1849 @@
+# -*- coding: utf-8 -*-
+"""
+This module offers timezone implementations subclassing the abstract
+:py:class:`datetime.tzinfo` type. There are classes to handle tzfile format
+files (usually are in :file:`/etc/localtime`, :file:`/usr/share/zoneinfo`,
+etc), TZ environment string (in all known formats), given ranges (with help
+from relative deltas), local machine timezone, fixed offset timezone, and UTC
+timezone.
+"""
+import datetime
+import struct
+import time
+import sys
+import os
+import bisect
+import weakref
+from collections import OrderedDict
+
+import six
+from six import string_types
+from six.moves import _thread
+from ._common import tzname_in_python2, _tzinfo
+from ._common import tzrangebase, enfold
+from ._common import _validate_fromutc_inputs
+
+from ._factories import _TzSingleton, _TzOffsetFactory
+from ._factories import _TzStrFactory
+try:
+    from .win import tzwin, tzwinlocal
+except ImportError:
+    tzwin = tzwinlocal = None
+
+# For warning about rounding tzinfo
+from warnings import warn
+
+ZERO = datetime.timedelta(0)
+EPOCH = datetime.datetime(1970, 1, 1, 0, 0)
+EPOCHORDINAL = EPOCH.toordinal()
+
+
+@six.add_metaclass(_TzSingleton)
+class tzutc(datetime.tzinfo):
+    """
+    This is a tzinfo object that represents the UTC time zone.
+
+    **Examples:**
+
+    .. doctest::
+
+        >>> from datetime import *
+        >>> from dateutil.tz import *
+
+        >>> datetime.now()
+        datetime.datetime(2003, 9, 27, 9, 40, 1, 521290)
+
+        >>> datetime.now(tzutc())
+        datetime.datetime(2003, 9, 27, 12, 40, 12, 156379, tzinfo=tzutc())
+
+        >>> datetime.now(tzutc()).tzname()
+        'UTC'
+
+    .. versionchanged:: 2.7.0
+        ``tzutc()`` is now a singleton, so the result of ``tzutc()`` will
+        always return the same object.
+
+        .. doctest::
+
+            >>> from dateutil.tz import tzutc, UTC
+            >>> tzutc() is tzutc()
+            True
+            >>> tzutc() is UTC
+            True
+    """
+    def utcoffset(self, dt):
+        return ZERO
+
+    def dst(self, dt):
+        return ZERO
+
+    @tzname_in_python2
+    def tzname(self, dt):
+        return "UTC"
+
+    def is_ambiguous(self, dt):
+        """
+        Whether or not the "wall time" of a given datetime is ambiguous in this
+        zone.
+
+        :param dt:
+            A :py:class:`datetime.datetime`, naive or time zone aware.
+
+
+        :return:
+            Returns ``True`` if ambiguous, ``False`` otherwise.
+
+        .. versionadded:: 2.6.0
+        """
+        return False
+
+    @_validate_fromutc_inputs
+    def fromutc(self, dt):
+        """
+        Fast track version of fromutc() returns the original ``dt`` object for
+        any valid :py:class:`datetime.datetime` object.
+        """
+        return dt
+
+    def __eq__(self, other):
+        if not isinstance(other, (tzutc, tzoffset)):
+            return NotImplemented
+
+        return (isinstance(other, tzutc) or
+                (isinstance(other, tzoffset) and other._offset == ZERO))
+
+    __hash__ = None
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __repr__(self):
+        return "%s()" % self.__class__.__name__
+
+    __reduce__ = object.__reduce__
+
+
+#: Convenience constant providing a :class:`tzutc()` instance
+#:
+#: .. versionadded:: 2.7.0
+UTC = tzutc()
+
+
+@six.add_metaclass(_TzOffsetFactory)
+class tzoffset(datetime.tzinfo):
+    """
+    A simple class for representing a fixed offset from UTC.
+
+    :param name:
+        The timezone name, to be returned when ``tzname()`` is called.
+    :param offset:
+        The time zone offset in seconds, or (since version 2.6.0, represented
+        as a :py:class:`datetime.timedelta` object).
+    """
+    def __init__(self, name, offset):
+        self._name = name
+
+        try:
+            # Allow a timedelta
+            offset = offset.total_seconds()
+        except (TypeError, AttributeError):
+            pass
+
+        self._offset = datetime.timedelta(seconds=_get_supported_offset(offset))
+
+    def utcoffset(self, dt):
+        return self._offset
+
+    def dst(self, dt):
+        return ZERO
+
+    @tzname_in_python2
+    def tzname(self, dt):
+        return self._name
+
+    @_validate_fromutc_inputs
+    def fromutc(self, dt):
+        return dt + self._offset
+
+    def is_ambiguous(self, dt):
+        """
+        Whether or not the "wall time" of a given datetime is ambiguous in this
+        zone.
+
+        :param dt:
+            A :py:class:`datetime.datetime`, naive or time zone aware.
+        :return:
+            Returns ``True`` if ambiguous, ``False`` otherwise.
+
+        .. versionadded:: 2.6.0
+        """
+        return False
+
+    def __eq__(self, other):
+        if not isinstance(other, tzoffset):
+            return NotImplemented
+
+        return self._offset == other._offset
+
+    __hash__ = None
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __repr__(self):
+        return "%s(%s, %s)" % (self.__class__.__name__,
+                               repr(self._name),
+                               int(self._offset.total_seconds()))
+
+    __reduce__ = object.__reduce__
+
+
+class tzlocal(_tzinfo):
+    """
+    A :class:`tzinfo` subclass built around the ``time`` timezone functions.
+    """
+    def __init__(self):
+        super(tzlocal, self).__init__()
+
+        self._std_offset = datetime.timedelta(seconds=-time.timezone)
+        if time.daylight:
+            self._dst_offset = datetime.timedelta(seconds=-time.altzone)
+        else:
+            self._dst_offset = self._std_offset
+
+        self._dst_saved = self._dst_offset - self._std_offset
+        self._hasdst = bool(self._dst_saved)
+        self._tznames = tuple(time.tzname)
+
+    def utcoffset(self, dt):
+        if dt is None and self._hasdst:
+            return None
+
+        if self._isdst(dt):
+            return self._dst_offset
+        else:
+            return self._std_offset
+
+    def dst(self, dt):
+        if dt is None and self._hasdst:
+            return None
+
+        if self._isdst(dt):
+            return self._dst_offset - self._std_offset
+        else:
+            return ZERO
+
+    @tzname_in_python2
+    def tzname(self, dt):
+        return self._tznames[self._isdst(dt)]
+
+    def is_ambiguous(self, dt):
+        """
+        Whether or not the "wall time" of a given datetime is ambiguous in this
+        zone.
+
+        :param dt:
+            A :py:class:`datetime.datetime`, naive or time zone aware.
+
+
+        :return:
+            Returns ``True`` if ambiguous, ``False`` otherwise.
+
+        .. versionadded:: 2.6.0
+        """
+        naive_dst = self._naive_is_dst(dt)
+        return (not naive_dst and
+                (naive_dst != self._naive_is_dst(dt - self._dst_saved)))
+
+    def _naive_is_dst(self, dt):
+        timestamp = _datetime_to_timestamp(dt)
+        return time.localtime(timestamp + time.timezone).tm_isdst
+
+    def _isdst(self, dt, fold_naive=True):
+        # We can't use mktime here. It is unstable when deciding if
+        # the hour near to a change is DST or not.
+        #
+        # timestamp = time.mktime((dt.year, dt.month, dt.day, dt.hour,
+        #                         dt.minute, dt.second, dt.weekday(), 0, -1))
+        # return time.localtime(timestamp).tm_isdst
+        #
+        # The code above yields the following result:
+        #
+        # >>> import tz, datetime
+        # >>> t = tz.tzlocal()
+        # >>> datetime.datetime(2003,2,15,23,tzinfo=t).tzname()
+        # 'BRDT'
+        # >>> datetime.datetime(2003,2,16,0,tzinfo=t).tzname()
+        # 'BRST'
+        # >>> datetime.datetime(2003,2,15,23,tzinfo=t).tzname()
+        # 'BRST'
+        # >>> datetime.datetime(2003,2,15,22,tzinfo=t).tzname()
+        # 'BRDT'
+        # >>> datetime.datetime(2003,2,15,23,tzinfo=t).tzname()
+        # 'BRDT'
+        #
+        # Here is a more stable implementation:
+        #
+        if not self._hasdst:
+            return False
+
+        # Check for ambiguous times:
+        dstval = self._naive_is_dst(dt)
+        fold = getattr(dt, 'fold', None)
+
+        if self.is_ambiguous(dt):
+            if fold is not None:
+                return not self._fold(dt)
+            else:
+                return True
+
+        return dstval
+
+    def __eq__(self, other):
+        if isinstance(other, tzlocal):
+            return (self._std_offset == other._std_offset and
+                    self._dst_offset == other._dst_offset)
+        elif isinstance(other, tzutc):
+            return (not self._hasdst and
+                    self._tznames[0] in {'UTC', 'GMT'} and
+                    self._std_offset == ZERO)
+        elif isinstance(other, tzoffset):
+            return (not self._hasdst and
+                    self._tznames[0] == other._name and
+                    self._std_offset == other._offset)
+        else:
+            return NotImplemented
+
+    __hash__ = None
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __repr__(self):
+        return "%s()" % self.__class__.__name__
+
+    __reduce__ = object.__reduce__
+
+
+class _ttinfo(object):
+    __slots__ = ["offset", "delta", "isdst", "abbr",
+                 "isstd", "isgmt", "dstoffset"]
+
+    def __init__(self):
+        for attr in self.__slots__:
+            setattr(self, attr, None)
+
+    def __repr__(self):
+        l = []
+        for attr in self.__slots__:
+            value = getattr(self, attr)
+            if value is not None:
+                l.append("%s=%s" % (attr, repr(value)))
+        return "%s(%s)" % (self.__class__.__name__, ", ".join(l))
+
+    def __eq__(self, other):
+        if not isinstance(other, _ttinfo):
+            return NotImplemented
+
+        return (self.offset == other.offset and
+                self.delta == other.delta and
+                self.isdst == other.isdst and
+                self.abbr == other.abbr and
+                self.isstd == other.isstd and
+                self.isgmt == other.isgmt and
+                self.dstoffset == other.dstoffset)
+
+    __hash__ = None
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __getstate__(self):
+        state = {}
+        for name in self.__slots__:
+            state[name] = getattr(self, name, None)
+        return state
+
+    def __setstate__(self, state):
+        for name in self.__slots__:
+            if name in state:
+                setattr(self, name, state[name])
+
+
+class _tzfile(object):
+    """
+    Lightweight class for holding the relevant transition and time zone
+    information read from binary tzfiles.
+    """
+    attrs = ['trans_list', 'trans_list_utc', 'trans_idx', 'ttinfo_list',
+             'ttinfo_std', 'ttinfo_dst', 'ttinfo_before', 'ttinfo_first']
+
+    def __init__(self, **kwargs):
+        for attr in self.attrs:
+            setattr(self, attr, kwargs.get(attr, None))
+
+
+class tzfile(_tzinfo):
+    """
+    This is a ``tzinfo`` subclass that allows one to use the ``tzfile(5)``
+    format timezone files to extract current and historical zone information.
+
+    :param fileobj:
+        This can be an opened file stream or a file name that the time zone
+        information can be read from.
+
+    :param filename:
+        This is an optional parameter specifying the source of the time zone
+        information in the event that ``fileobj`` is a file object. If omitted
+        and ``fileobj`` is a file stream, this parameter will be set either to
+        ``fileobj``'s ``name`` attribute or to ``repr(fileobj)``.
+
+    See `Sources for Time Zone and Daylight Saving Time Data
+    <https://data.iana.org/time-zones/tz-link.html>`_ for more information.
+    Time zone files can be compiled from the `IANA Time Zone database files
+    <https://www.iana.org/time-zones>`_ with the `zic time zone compiler
+    <https://www.freebsd.org/cgi/man.cgi?query=zic&sektion=8>`_
+
+    .. note::
+
+        Only construct a ``tzfile`` directly if you have a specific timezone
+        file on disk that you want to read into a Python ``tzinfo`` object.
+        If you want to get a ``tzfile`` representing a specific IANA zone,
+        (e.g. ``'America/New_York'``), you should call
+        :func:`dateutil.tz.gettz` with the zone identifier.
+
+
+    **Examples:**
+
+    Using the US Eastern time zone as an example, we can see that a ``tzfile``
+    provides time zone information for the standard Daylight Saving offsets:
+
+    .. testsetup:: tzfile
+
+        from dateutil.tz import gettz
+        from datetime import datetime
+
+    .. doctest:: tzfile
+
+        >>> NYC = gettz('America/New_York')
+        >>> NYC
+        tzfile('/usr/share/zoneinfo/America/New_York')
+
+        >>> print(datetime(2016, 1, 3, tzinfo=NYC))     # EST
+        2016-01-03 00:00:00-05:00
+
+        >>> print(datetime(2016, 7, 7, tzinfo=NYC))     # EDT
+        2016-07-07 00:00:00-04:00
+
+
+    The ``tzfile`` structure contains a fully history of the time zone,
+    so historical dates will also have the right offsets. For example, before
+    the adoption of the UTC standards, New York used local solar  mean time:
+
+    .. doctest:: tzfile
+
+       >>> print(datetime(1901, 4, 12, tzinfo=NYC))    # LMT
+       1901-04-12 00:00:00-04:56
+
+    And during World War II, New York was on "Eastern War Time", which was a
+    state of permanent daylight saving time:
+
+    .. doctest:: tzfile
+
+        >>> print(datetime(1944, 2, 7, tzinfo=NYC))    # EWT
+        1944-02-07 00:00:00-04:00
+
+    """
+
+    def __init__(self, fileobj, filename=None):
+        super(tzfile, self).__init__()
+
+        file_opened_here = False
+        if isinstance(fileobj, string_types):
+            self._filename = fileobj
+            fileobj = open(fileobj, 'rb')
+            file_opened_here = True
+        elif filename is not None:
+            self._filename = filename
+        elif hasattr(fileobj, "name"):
+            self._filename = fileobj.name
+        else:
+            self._filename = repr(fileobj)
+
+        if fileobj is not None:
+            if not file_opened_here:
+                fileobj = _nullcontext(fileobj)
+
+            with fileobj as file_stream:
+                tzobj = self._read_tzfile(file_stream)
+
+            self._set_tzdata(tzobj)
+
+    def _set_tzdata(self, tzobj):
+        """ Set the time zone data of this object from a _tzfile object """
+        # Copy the relevant attributes over as private attributes
+        for attr in _tzfile.attrs:
+            setattr(self, '_' + attr, getattr(tzobj, attr))
+
+    def _read_tzfile(self, fileobj):
+        out = _tzfile()
+
+        # From tzfile(5):
+        #
+        # The time zone information files used by tzset(3)
+        # begin with the magic characters "TZif" to identify
+        # them as time zone information files, followed by
+        # sixteen bytes reserved for future use, followed by
+        # six four-byte values of type long, written in a
+        # ``standard'' byte order (the high-order  byte
+        # of the value is written first).
+        if fileobj.read(4).decode() != "TZif":
+            raise ValueError("magic not found")
+
+        fileobj.read(16)
+
+        (
+            # The number of UTC/local indicators stored in the file.
+            ttisgmtcnt,
+
+            # The number of standard/wall indicators stored in the file.
+            ttisstdcnt,
+
+            # The number of leap seconds for which data is
+            # stored in the file.
+            leapcnt,
+
+            # The number of "transition times" for which data
+            # is stored in the file.
+            timecnt,
+
+            # The number of "local time types" for which data
+            # is stored in the file (must not be zero).
+            typecnt,
+
+            # The  number  of  characters  of "time zone
+            # abbreviation strings" stored in the file.
+            charcnt,
+
+        ) = struct.unpack(">6l", fileobj.read(24))
+
+        # The above header is followed by tzh_timecnt four-byte
+        # values  of  type long,  sorted  in ascending order.
+        # These values are written in ``standard'' byte order.
+        # Each is used as a transition time (as  returned  by
+        # time(2)) at which the rules for computing local time
+        # change.
+
+        if timecnt:
+            out.trans_list_utc = list(struct.unpack(">%dl" % timecnt,
+                                                    fileobj.read(timecnt*4)))
+        else:
+            out.trans_list_utc = []
+
+        # Next come tzh_timecnt one-byte values of type unsigned
+        # char; each one tells which of the different types of
+        # ``local time'' types described in the file is associated
+        # with the same-indexed transition time. These values
+        # serve as indices into an array of ttinfo structures that
+        # appears next in the file.
+
+        if timecnt:
+            out.trans_idx = struct.unpack(">%dB" % timecnt,
+                                          fileobj.read(timecnt))
+        else:
+            out.trans_idx = []
+
+        # Each ttinfo structure is written as a four-byte value
+        # for tt_gmtoff  of  type long,  in  a  standard  byte
+        # order, followed  by a one-byte value for tt_isdst
+        # and a one-byte  value  for  tt_abbrind.   In  each
+        # structure, tt_gmtoff  gives  the  number  of
+        # seconds to be added to UTC, tt_isdst tells whether
+        # tm_isdst should be set by  localtime(3),  and
+        # tt_abbrind serves  as an index into the array of
+        # time zone abbreviation characters that follow the
+        # ttinfo structure(s) in the file.
+
+        ttinfo = []
+
+        for i in range(typecnt):
+            ttinfo.append(struct.unpack(">lbb", fileobj.read(6)))
+
+        abbr = fileobj.read(charcnt).decode()
+
+        # Then there are tzh_leapcnt pairs of four-byte
+        # values, written in  standard byte  order;  the
+        # first  value  of  each pair gives the time (as
+        # returned by time(2)) at which a leap second
+        # occurs;  the  second  gives the  total  number of
+        # leap seconds to be applied after the given time.
+        # The pairs of values are sorted in ascending order
+        # by time.
+
+        # Not used, for now (but seek for correct file position)
+        if leapcnt:
+            fileobj.seek(leapcnt * 8, os.SEEK_CUR)
+
+        # Then there are tzh_ttisstdcnt standard/wall
+        # indicators, each stored as a one-byte value;
+        # they tell whether the transition times associated
+        # with local time types were specified as standard
+        # time or wall clock time, and are used when
+        # a time zone file is used in handling POSIX-style
+        # time zone environment variables.
+
+        if ttisstdcnt:
+            isstd = struct.unpack(">%db" % ttisstdcnt,
+                                  fileobj.read(ttisstdcnt))
+
+        # Finally, there are tzh_ttisgmtcnt UTC/local
+        # indicators, each stored as a one-byte value;
+        # they tell whether the transition times associated
+        # with local time types were specified as UTC or
+        # local time, and are used when a time zone file
+        # is used in handling POSIX-style time zone envi-
+        # ronment variables.
+
+        if ttisgmtcnt:
+            isgmt = struct.unpack(">%db" % ttisgmtcnt,
+                                  fileobj.read(ttisgmtcnt))
+
+        # Build ttinfo list
+        out.ttinfo_list = []
+        for i in range(typecnt):
+            gmtoff, isdst, abbrind = ttinfo[i]
+            gmtoff = _get_supported_offset(gmtoff)
+            tti = _ttinfo()
+            tti.offset = gmtoff
+            tti.dstoffset = datetime.timedelta(0)
+            tti.delta = datetime.timedelta(seconds=gmtoff)
+            tti.isdst = isdst
+            tti.abbr = abbr[abbrind:abbr.find('\x00', abbrind)]
+            tti.isstd = (ttisstdcnt > i and isstd[i] != 0)
+            tti.isgmt = (ttisgmtcnt > i and isgmt[i] != 0)
+            out.ttinfo_list.append(tti)
+
+        # Replace ttinfo indexes for ttinfo objects.
+        out.trans_idx = [out.ttinfo_list[idx] for idx in out.trans_idx]
+
+        # Set standard, dst, and before ttinfos. before will be
+        # used when a given time is before any transitions,
+        # and will be set to the first non-dst ttinfo, or to
+        # the first dst, if all of them are dst.
+        out.ttinfo_std = None
+        out.ttinfo_dst = None
+        out.ttinfo_before = None
+        if out.ttinfo_list:
+            if not out.trans_list_utc:
+                out.ttinfo_std = out.ttinfo_first = out.ttinfo_list[0]
+            else:
+                for i in range(timecnt-1, -1, -1):
+                    tti = out.trans_idx[i]
+                    if not out.ttinfo_std and not tti.isdst:
+                        out.ttinfo_std = tti
+                    elif not out.ttinfo_dst and tti.isdst:
+                        out.ttinfo_dst = tti
+
+                    if out.ttinfo_std and out.ttinfo_dst:
+                        break
+                else:
+                    if out.ttinfo_dst and not out.ttinfo_std:
+                        out.ttinfo_std = out.ttinfo_dst
+
+                for tti in out.ttinfo_list:
+                    if not tti.isdst:
+                        out.ttinfo_before = tti
+                        break
+                else:
+                    out.ttinfo_before = out.ttinfo_list[0]
+
+        # Now fix transition times to become relative to wall time.
+        #
+        # I'm not sure about this. In my tests, the tz source file
+        # is setup to wall time, and in the binary file isstd and
+        # isgmt are off, so it should be in wall time. OTOH, it's
+        # always in gmt time. Let me know if you have comments
+        # about this.
+        lastdst = None
+        lastoffset = None
+        lastdstoffset = None
+        lastbaseoffset = None
+        out.trans_list = []
+
+        for i, tti in enumerate(out.trans_idx):
+            offset = tti.offset
+            dstoffset = 0
+
+            if lastdst is not None:
+                if tti.isdst:
+                    if not lastdst:
+                        dstoffset = offset - lastoffset
+
+                    if not dstoffset and lastdstoffset:
+                        dstoffset = lastdstoffset
+
+                    tti.dstoffset = datetime.timedelta(seconds=dstoffset)
+                    lastdstoffset = dstoffset
+
+            # If a time zone changes its base offset during a DST transition,
+            # then you need to adjust by the previous base offset to get the
+            # transition time in local time. Otherwise you use the current
+            # base offset. Ideally, I would have some mathematical proof of
+            # why this is true, but I haven't really thought about it enough.
+            baseoffset = offset - dstoffset
+            adjustment = baseoffset
+            if (lastbaseoffset is not None and baseoffset != lastbaseoffset
+                    and tti.isdst != lastdst):
+                # The base DST has changed
+                adjustment = lastbaseoffset
+
+            lastdst = tti.isdst
+            lastoffset = offset
+            lastbaseoffset = baseoffset
+
+            out.trans_list.append(out.trans_list_utc[i] + adjustment)
+
+        out.trans_idx = tuple(out.trans_idx)
+        out.trans_list = tuple(out.trans_list)
+        out.trans_list_utc = tuple(out.trans_list_utc)
+
+        return out
+
+    def _find_last_transition(self, dt, in_utc=False):
+        # If there's no list, there are no transitions to find
+        if not self._trans_list:
+            return None
+
+        timestamp = _datetime_to_timestamp(dt)
+
+        # Find where the timestamp fits in the transition list - if the
+        # timestamp is a transition time, it's part of the "after" period.
+        trans_list = self._trans_list_utc if in_utc else self._trans_list
+        idx = bisect.bisect_right(trans_list, timestamp)
+
+        # We want to know when the previous transition was, so subtract off 1
+        return idx - 1
+
+    def _get_ttinfo(self, idx):
+        # For no list or after the last transition, default to _ttinfo_std
+        if idx is None or (idx + 1) >= len(self._trans_list):
+            return self._ttinfo_std
+
+        # If there is a list and the time is before it, return _ttinfo_before
+        if idx < 0:
+            return self._ttinfo_before
+
+        return self._trans_idx[idx]
+
+    def _find_ttinfo(self, dt):
+        idx = self._resolve_ambiguous_time(dt)
+
+        return self._get_ttinfo(idx)
+
+    def fromutc(self, dt):
+        """
+        The ``tzfile`` implementation of :py:func:`datetime.tzinfo.fromutc`.
+
+        :param dt:
+            A :py:class:`datetime.datetime` object.
+
+        :raises TypeError:
+            Raised if ``dt`` is not a :py:class:`datetime.datetime` object.
+
+        :raises ValueError:
+            Raised if this is called with a ``dt`` which does not have this
+            ``tzinfo`` attached.
+
+        :return:
+            Returns a :py:class:`datetime.datetime` object representing the
+            wall time in ``self``'s time zone.
+        """
+        # These isinstance checks are in datetime.tzinfo, so we'll preserve
+        # them, even if we don't care about duck typing.
+        if not isinstance(dt, datetime.datetime):
+            raise TypeError("fromutc() requires a datetime argument")
+
+        if dt.tzinfo is not self:
+            raise ValueError("dt.tzinfo is not self")
+
+        # First treat UTC as wall time and get the transition we're in.
+        idx = self._find_last_transition(dt, in_utc=True)
+        tti = self._get_ttinfo(idx)
+
+        dt_out = dt + datetime.timedelta(seconds=tti.offset)
+
+        fold = self.is_ambiguous(dt_out, idx=idx)
+
+        return enfold(dt_out, fold=int(fold))
+
+    def is_ambiguous(self, dt, idx=None):
+        """
+        Whether or not the "wall time" of a given datetime is ambiguous in this
+        zone.
+
+        :param dt:
+            A :py:class:`datetime.datetime`, naive or time zone aware.
+
+
+        :return:
+            Returns ``True`` if ambiguous, ``False`` otherwise.
+
+        .. versionadded:: 2.6.0
+        """
+        if idx is None:
+            idx = self._find_last_transition(dt)
+
+        # Calculate the difference in offsets from current to previous
+        timestamp = _datetime_to_timestamp(dt)
+        tti = self._get_ttinfo(idx)
+
+        if idx is None or idx <= 0:
+            return False
+
+        od = self._get_ttinfo(idx - 1).offset - tti.offset
+        tt = self._trans_list[idx]          # Transition time
+
+        return timestamp < tt + od
+
+    def _resolve_ambiguous_time(self, dt):
+        idx = self._find_last_transition(dt)
+
+        # If we have no transitions, return the index
+        _fold = self._fold(dt)
+        if idx is None or idx == 0:
+            return idx
+
+        # If it's ambiguous and we're in a fold, shift to a different index.
+        idx_offset = int(not _fold and self.is_ambiguous(dt, idx))
+
+        return idx - idx_offset
+
+    def utcoffset(self, dt):
+        if dt is None:
+            return None
+
+        if not self._ttinfo_std:
+            return ZERO
+
+        return self._find_ttinfo(dt).delta
+
+    def dst(self, dt):
+        if dt is None:
+            return None
+
+        if not self._ttinfo_dst:
+            return ZERO
+
+        tti = self._find_ttinfo(dt)
+
+        if not tti.isdst:
+            return ZERO
+
+        # The documentation says that utcoffset()-dst() must
+        # be constant for every dt.
+        return tti.dstoffset
+
+    @tzname_in_python2
+    def tzname(self, dt):
+        if not self._ttinfo_std or dt is None:
+            return None
+        return self._find_ttinfo(dt).abbr
+
+    def __eq__(self, other):
+        if not isinstance(other, tzfile):
+            return NotImplemented
+        return (self._trans_list == other._trans_list and
+                self._trans_idx == other._trans_idx and
+                self._ttinfo_list == other._ttinfo_list)
+
+    __hash__ = None
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __repr__(self):
+        return "%s(%s)" % (self.__class__.__name__, repr(self._filename))
+
+    def __reduce__(self):
+        return self.__reduce_ex__(None)
+
+    def __reduce_ex__(self, protocol):
+        return (self.__class__, (None, self._filename), self.__dict__)
+
+
+class tzrange(tzrangebase):
+    """
+    The ``tzrange`` object is a time zone specified by a set of offsets and
+    abbreviations, equivalent to the way the ``TZ`` variable can be specified
+    in POSIX-like systems, but using Python delta objects to specify DST
+    start, end and offsets.
+
+    :param stdabbr:
+        The abbreviation for standard time (e.g. ``'EST'``).
+
+    :param stdoffset:
+        An integer or :class:`datetime.timedelta` object or equivalent
+        specifying the base offset from UTC.
+
+        If unspecified, +00:00 is used.
+
+    :param dstabbr:
+        The abbreviation for DST / "Summer" time (e.g. ``'EDT'``).
+
+        If specified, with no other DST information, DST is assumed to occur
+        and the default behavior or ``dstoffset``, ``start`` and ``end`` is
+        used. If unspecified and no other DST information is specified, it
+        is assumed that this zone has no DST.
+
+        If this is unspecified and other DST information is *is* specified,
+        DST occurs in the zone but the time zone abbreviation is left
+        unchanged.
+
+    :param dstoffset:
+        A an integer or :class:`datetime.timedelta` object or equivalent
+        specifying the UTC offset during DST. If unspecified and any other DST
+        information is specified, it is assumed to be the STD offset +1 hour.
+
+    :param start:
+        A :class:`relativedelta.relativedelta` object or equivalent specifying
+        the time and time of year that daylight savings time starts. To
+        specify, for example, that DST starts at 2AM on the 2nd Sunday in
+        March, pass:
+
+            ``relativedelta(hours=2, month=3, day=1, weekday=SU(+2))``
+
+        If unspecified and any other DST information is specified, the default
+        value is 2 AM on the first Sunday in April.
+
+    :param end:
+        A :class:`relativedelta.relativedelta` object or equivalent
+        representing the time and time of year that daylight savings time
+        ends, with the same specification method as in ``start``. One note is
+        that this should point to the first time in the *standard* zone, so if
+        a transition occurs at 2AM in the DST zone and the clocks are set back
+        1 hour to 1AM, set the ``hours`` parameter to +1.
+
+
+    **Examples:**
+
+    .. testsetup:: tzrange
+
+        from dateutil.tz import tzrange, tzstr
+
+    .. doctest:: tzrange
+
+        >>> tzstr('EST5EDT') == tzrange("EST", -18000, "EDT")
+        True
+
+        >>> from dateutil.relativedelta import *
+        >>> range1 = tzrange("EST", -18000, "EDT")
+        >>> range2 = tzrange("EST", -18000, "EDT", -14400,
+        ...                  relativedelta(hours=+2, month=4, day=1,
+        ...                                weekday=SU(+1)),
+        ...                  relativedelta(hours=+1, month=10, day=31,
+        ...                                weekday=SU(-1)))
+        >>> tzstr('EST5EDT') == range1 == range2
+        True
+
+    """
+    def __init__(self, stdabbr, stdoffset=None,
+                 dstabbr=None, dstoffset=None,
+                 start=None, end=None):
+
+        global relativedelta
+        from dateutil import relativedelta
+
+        self._std_abbr = stdabbr
+        self._dst_abbr = dstabbr
+
+        try:
+            stdoffset = stdoffset.total_seconds()
+        except (TypeError, AttributeError):
+            pass
+
+        try:
+            dstoffset = dstoffset.total_seconds()
+        except (TypeError, AttributeError):
+            pass
+
+        if stdoffset is not None:
+            self._std_offset = datetime.timedelta(seconds=stdoffset)
+        else:
+            self._std_offset = ZERO
+
+        if dstoffset is not None:
+            self._dst_offset = datetime.timedelta(seconds=dstoffset)
+        elif dstabbr and stdoffset is not None:
+            self._dst_offset = self._std_offset + datetime.timedelta(hours=+1)
+        else:
+            self._dst_offset = ZERO
+
+        if dstabbr and start is None:
+            self._start_delta = relativedelta.relativedelta(
+                hours=+2, month=4, day=1, weekday=relativedelta.SU(+1))
+        else:
+            self._start_delta = start
+
+        if dstabbr and end is None:
+            self._end_delta = relativedelta.relativedelta(
+                hours=+1, month=10, day=31, weekday=relativedelta.SU(-1))
+        else:
+            self._end_delta = end
+
+        self._dst_base_offset_ = self._dst_offset - self._std_offset
+        self.hasdst = bool(self._start_delta)
+
+    def transitions(self, year):
+        """
+        For a given year, get the DST on and off transition times, expressed
+        always on the standard time side. For zones with no transitions, this
+        function returns ``None``.
+
+        :param year:
+            The year whose transitions you would like to query.
+
+        :return:
+            Returns a :class:`tuple` of :class:`datetime.datetime` objects,
+            ``(dston, dstoff)`` for zones with an annual DST transition, or
+            ``None`` for fixed offset zones.
+        """
+        if not self.hasdst:
+            return None
+
+        base_year = datetime.datetime(year, 1, 1)
+
+        start = base_year + self._start_delta
+        end = base_year + self._end_delta
+
+        return (start, end)
+
+    def __eq__(self, other):
+        if not isinstance(other, tzrange):
+            return NotImplemented
+
+        return (self._std_abbr == other._std_abbr and
+                self._dst_abbr == other._dst_abbr and
+                self._std_offset == other._std_offset and
+                self._dst_offset == other._dst_offset and
+                self._start_delta == other._start_delta and
+                self._end_delta == other._end_delta)
+
+    @property
+    def _dst_base_offset(self):
+        return self._dst_base_offset_
+
+
+@six.add_metaclass(_TzStrFactory)
+class tzstr(tzrange):
+    """
+    ``tzstr`` objects are time zone objects specified by a time-zone string as
+    it would be passed to a ``TZ`` variable on POSIX-style systems (see
+    the `GNU C Library: TZ Variable`_ for more details).
+
+    There is one notable exception, which is that POSIX-style time zones use an
+    inverted offset format, so normally ``GMT+3`` would be parsed as an offset
+    3 hours *behind* GMT. The ``tzstr`` time zone object will parse this as an
+    offset 3 hours *ahead* of GMT. If you would like to maintain the POSIX
+    behavior, pass a ``True`` value to ``posix_offset``.
+
+    The :class:`tzrange` object provides the same functionality, but is
+    specified using :class:`relativedelta.relativedelta` objects. rather than
+    strings.
+
+    :param s:
+        A time zone string in ``TZ`` variable format. This can be a
+        :class:`bytes` (2.x: :class:`str`), :class:`str` (2.x:
+        :class:`unicode`) or a stream emitting unicode characters
+        (e.g. :class:`StringIO`).
+
+    :param posix_offset:
+        Optional. If set to ``True``, interpret strings such as ``GMT+3`` or
+        ``UTC+3`` as being 3 hours *behind* UTC rather than ahead, per the
+        POSIX standard.
+
+    .. caution::
+
+        Prior to version 2.7.0, this function also supported time zones
+        in the format:
+
+            * ``EST5EDT,4,0,6,7200,10,0,26,7200,3600``
+            * ``EST5EDT,4,1,0,7200,10,-1,0,7200,3600``
+
+        This format is non-standard and has been deprecated; this function
+        will raise a :class:`DeprecatedTZFormatWarning` until
+        support is removed in a future version.
+
+    .. _`GNU C Library: TZ Variable`:
+        https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html
+    """
+    def __init__(self, s, posix_offset=False):
+        global parser
+        from dateutil.parser import _parser as parser
+
+        self._s = s
+
+        res = parser._parsetz(s)
+        if res is None or res.any_unused_tokens:
+            raise ValueError("unknown string format")
+
+        # Here we break the compatibility with the TZ variable handling.
+        # GMT-3 actually *means* the timezone -3.
+        if res.stdabbr in ("GMT", "UTC") and not posix_offset:
+            res.stdoffset *= -1
+
+        # We must initialize it first, since _delta() needs
+        # _std_offset and _dst_offset set. Use False in start/end
+        # to avoid building it two times.
+        tzrange.__init__(self, res.stdabbr, res.stdoffset,
+                         res.dstabbr, res.dstoffset,
+                         start=False, end=False)
+
+        if not res.dstabbr:
+            self._start_delta = None
+            self._end_delta = None
+        else:
+            self._start_delta = self._delta(res.start)
+            if self._start_delta:
+                self._end_delta = self._delta(res.end, isend=1)
+
+        self.hasdst = bool(self._start_delta)
+
+    def _delta(self, x, isend=0):
+        from dateutil import relativedelta
+        kwargs = {}
+        if x.month is not None:
+            kwargs["month"] = x.month
+            if x.weekday is not None:
+                kwargs["weekday"] = relativedelta.weekday(x.weekday, x.week)
+                if x.week > 0:
+                    kwargs["day"] = 1
+                else:
+                    kwargs["day"] = 31
+            elif x.day:
+                kwargs["day"] = x.day
+        elif x.yday is not None:
+            kwargs["yearday"] = x.yday
+        elif x.jyday is not None:
+            kwargs["nlyearday"] = x.jyday
+        if not kwargs:
+            # Default is to start on first sunday of april, and end
+            # on last sunday of october.
+            if not isend:
+                kwargs["month"] = 4
+                kwargs["day"] = 1
+                kwargs["weekday"] = relativedelta.SU(+1)
+            else:
+                kwargs["month"] = 10
+                kwargs["day"] = 31
+                kwargs["weekday"] = relativedelta.SU(-1)
+        if x.time is not None:
+            kwargs["seconds"] = x.time
+        else:
+            # Default is 2AM.
+            kwargs["seconds"] = 7200
+        if isend:
+            # Convert to standard time, to follow the documented way
+            # of working with the extra hour. See the documentation
+            # of the tzinfo class.
+            delta = self._dst_offset - self._std_offset
+            kwargs["seconds"] -= delta.seconds + delta.days * 86400
+        return relativedelta.relativedelta(**kwargs)
+
+    def __repr__(self):
+        return "%s(%s)" % (self.__class__.__name__, repr(self._s))
+
+
+class _tzicalvtzcomp(object):
+    def __init__(self, tzoffsetfrom, tzoffsetto, isdst,
+                 tzname=None, rrule=None):
+        self.tzoffsetfrom = datetime.timedelta(seconds=tzoffsetfrom)
+        self.tzoffsetto = datetime.timedelta(seconds=tzoffsetto)
+        self.tzoffsetdiff = self.tzoffsetto - self.tzoffsetfrom
+        self.isdst = isdst
+        self.tzname = tzname
+        self.rrule = rrule
+
+
+class _tzicalvtz(_tzinfo):
+    def __init__(self, tzid, comps=[]):
+        super(_tzicalvtz, self).__init__()
+
+        self._tzid = tzid
+        self._comps = comps
+        self._cachedate = []
+        self._cachecomp = []
+        self._cache_lock = _thread.allocate_lock()
+
+    def _find_comp(self, dt):
+        if len(self._comps) == 1:
+            return self._comps[0]
+
+        dt = dt.replace(tzinfo=None)
+
+        try:
+            with self._cache_lock:
+                return self._cachecomp[self._cachedate.index(
+                    (dt, self._fold(dt)))]
+        except ValueError:
+            pass
+
+        lastcompdt = None
+        lastcomp = None
+
+        for comp in self._comps:
+            compdt = self._find_compdt(comp, dt)
+
+            if compdt and (not lastcompdt or lastcompdt < compdt):
+                lastcompdt = compdt
+                lastcomp = comp
+
+        if not lastcomp:
+            # RFC says nothing about what to do when a given
+            # time is before the first onset date. We'll look for the
+            # first standard component, or the first component, if
+            # none is found.
+            for comp in self._comps:
+                if not comp.isdst:
+                    lastcomp = comp
+                    break
+            else:
+                lastcomp = comp[0]
+
+        with self._cache_lock:
+            self._cachedate.insert(0, (dt, self._fold(dt)))
+            self._cachecomp.insert(0, lastcomp)
+
+            if len(self._cachedate) > 10:
+                self._cachedate.pop()
+                self._cachecomp.pop()
+
+        return lastcomp
+
+    def _find_compdt(self, comp, dt):
+        if comp.tzoffsetdiff < ZERO and self._fold(dt):
+            dt -= comp.tzoffsetdiff
+
+        compdt = comp.rrule.before(dt, inc=True)
+
+        return compdt
+
+    def utcoffset(self, dt):
+        if dt is None:
+            return None
+
+        return self._find_comp(dt).tzoffsetto
+
+    def dst(self, dt):
+        comp = self._find_comp(dt)
+        if comp.isdst:
+            return comp.tzoffsetdiff
+        else:
+            return ZERO
+
+    @tzname_in_python2
+    def tzname(self, dt):
+        return self._find_comp(dt).tzname
+
+    def __repr__(self):
+        return "<tzicalvtz %s>" % repr(self._tzid)
+
+    __reduce__ = object.__reduce__
+
+
+class tzical(object):
+    """
+    This object is designed to parse an iCalendar-style ``VTIMEZONE`` structure
+    as set out in `RFC 5545`_ Section 4.6.5 into one or more `tzinfo` objects.
+
+    :param `fileobj`:
+        A file or stream in iCalendar format, which should be UTF-8 encoded
+        with CRLF endings.
+
+    .. _`RFC 5545`: https://tools.ietf.org/html/rfc5545
+    """
+    def __init__(self, fileobj):
+        global rrule
+        from dateutil import rrule
+
+        if isinstance(fileobj, string_types):
+            self._s = fileobj
+            # ical should be encoded in UTF-8 with CRLF
+            fileobj = open(fileobj, 'r')
+        else:
+            self._s = getattr(fileobj, 'name', repr(fileobj))
+            fileobj = _nullcontext(fileobj)
+
+        self._vtz = {}
+
+        with fileobj as fobj:
+            self._parse_rfc(fobj.read())
+
+    def keys(self):
+        """
+        Retrieves the available time zones as a list.
+        """
+        return list(self._vtz.keys())
+
+    def get(self, tzid=None):
+        """
+        Retrieve a :py:class:`datetime.tzinfo` object by its ``tzid``.
+
+        :param tzid:
+            If there is exactly one time zone available, omitting ``tzid``
+            or passing :py:const:`None` value returns it. Otherwise a valid
+            key (which can be retrieved from :func:`keys`) is required.
+
+        :raises ValueError:
+            Raised if ``tzid`` is not specified but there are either more
+            or fewer than 1 zone defined.
+
+        :returns:
+            Returns either a :py:class:`datetime.tzinfo` object representing
+            the relevant time zone or :py:const:`None` if the ``tzid`` was
+            not found.
+        """
+        if tzid is None:
+            if len(self._vtz) == 0:
+                raise ValueError("no timezones defined")
+            elif len(self._vtz) > 1:
+                raise ValueError("more than one timezone available")
+            tzid = next(iter(self._vtz))
+
+        return self._vtz.get(tzid)
+
+    def _parse_offset(self, s):
+        s = s.strip()
+        if not s:
+            raise ValueError("empty offset")
+        if s[0] in ('+', '-'):
+            signal = (-1, +1)[s[0] == '+']
+            s = s[1:]
+        else:
+            signal = +1
+        if len(s) == 4:
+            return (int(s[:2]) * 3600 + int(s[2:]) * 60) * signal
+        elif len(s) == 6:
+            return (int(s[:2]) * 3600 + int(s[2:4]) * 60 + int(s[4:])) * signal
+        else:
+            raise ValueError("invalid offset: " + s)
+
+    def _parse_rfc(self, s):
+        lines = s.splitlines()
+        if not lines:
+            raise ValueError("empty string")
+
+        # Unfold
+        i = 0
+        while i < len(lines):
+            line = lines[i].rstrip()
+            if not line:
+                del lines[i]
+            elif i > 0 and line[0] == " ":
+                lines[i-1] += line[1:]
+                del lines[i]
+            else:
+                i += 1
+
+        tzid = None
+        comps = []
+        invtz = False
+        comptype = None
+        for line in lines:
+            if not line:
+                continue
+            name, value = line.split(':', 1)
+            parms = name.split(';')
+            if not parms:
+                raise ValueError("empty property name")
+            name = parms[0].upper()
+            parms = parms[1:]
+            if invtz:
+                if name == "BEGIN":
+                    if value in ("STANDARD", "DAYLIGHT"):
+                        # Process component
+                        pass
+                    else:
+                        raise ValueError("unknown component: "+value)
+                    comptype = value
+                    founddtstart = False
+                    tzoffsetfrom = None
+                    tzoffsetto = None
+                    rrulelines = []
+                    tzname = None
+                elif name == "END":
+                    if value == "VTIMEZONE":
+                        if comptype:
+                            raise ValueError("component not closed: "+comptype)
+                        if not tzid:
+                            raise ValueError("mandatory TZID not found")
+                        if not comps:
+                            raise ValueError(
+                                "at least one component is needed")
+                        # Process vtimezone
+                        self._vtz[tzid] = _tzicalvtz(tzid, comps)
+                        invtz = False
+                    elif value == comptype:
+                        if not founddtstart:
+                            raise ValueError("mandatory DTSTART not found")
+                        if tzoffsetfrom is None:
+                            raise ValueError(
+                                "mandatory TZOFFSETFROM not found")
+                        if tzoffsetto is None:
+                            raise ValueError(
+                                "mandatory TZOFFSETFROM not found")
+                        # Process component
+                        rr = None
+                        if rrulelines:
+                            rr = rrule.rrulestr("\n".join(rrulelines),
+                                                compatible=True,
+                                                ignoretz=True,
+                                                cache=True)
+                        comp = _tzicalvtzcomp(tzoffsetfrom, tzoffsetto,
+                                              (comptype == "DAYLIGHT"),
+                                              tzname, rr)
+                        comps.append(comp)
+                        comptype = None
+                    else:
+                        raise ValueError("invalid component end: "+value)
+                elif comptype:
+                    if name == "DTSTART":
+                        # DTSTART in VTIMEZONE takes a subset of valid RRULE
+                        # values under RFC 5545.
+                        for parm in parms:
+                            if parm != 'VALUE=DATE-TIME':
+                                msg = ('Unsupported DTSTART param in ' +
+                                       'VTIMEZONE: ' + parm)
+                                raise ValueError(msg)
+                        rrulelines.append(line)
+                        founddtstart = True
+                    elif name in ("RRULE", "RDATE", "EXRULE", "EXDATE"):
+                        rrulelines.append(line)
+                    elif name == "TZOFFSETFROM":
+                        if parms:
+                            raise ValueError(
+                                "unsupported %s parm: %s " % (name, parms[0]))
+                        tzoffsetfrom = self._parse_offset(value)
+                    elif name == "TZOFFSETTO":
+                        if parms:
+                            raise ValueError(
+                                "unsupported TZOFFSETTO parm: "+parms[0])
+                        tzoffsetto = self._parse_offset(value)
+                    elif name == "TZNAME":
+                        if parms:
+                            raise ValueError(
+                                "unsupported TZNAME parm: "+parms[0])
+                        tzname = value
+                    elif name == "COMMENT":
+                        pass
+                    else:
+                        raise ValueError("unsupported property: "+name)
+                else:
+                    if name == "TZID":
+                        if parms:
+                            raise ValueError(
+                                "unsupported TZID parm: "+parms[0])
+                        tzid = value
+                    elif name in ("TZURL", "LAST-MODIFIED", "COMMENT"):
+                        pass
+                    else:
+                        raise ValueError("unsupported property: "+name)
+            elif name == "BEGIN" and value == "VTIMEZONE":
+                tzid = None
+                comps = []
+                invtz = True
+
+    def __repr__(self):
+        return "%s(%s)" % (self.__class__.__name__, repr(self._s))
+
+
+if sys.platform != "win32":
+    TZFILES = ["/etc/localtime", "localtime"]
+    TZPATHS = ["/usr/share/zoneinfo",
+               "/usr/lib/zoneinfo",
+               "/usr/share/lib/zoneinfo",
+               "/etc/zoneinfo"]
+else:
+    TZFILES = []
+    TZPATHS = []
+
+
+def __get_gettz():
+    tzlocal_classes = (tzlocal,)
+    if tzwinlocal is not None:
+        tzlocal_classes += (tzwinlocal,)
+
+    class GettzFunc(object):
+        """
+        Retrieve a time zone object from a string representation
+
+        This function is intended to retrieve the :py:class:`tzinfo` subclass
+        that best represents the time zone that would be used if a POSIX
+        `TZ variable`_ were set to the same value.
+
+        If no argument or an empty string is passed to ``gettz``, local time
+        is returned:
+
+        .. code-block:: python3
+
+            >>> gettz()
+            tzfile('/etc/localtime')
+
+        This function is also the preferred way to map IANA tz database keys
+        to :class:`tzfile` objects:
+
+        .. code-block:: python3
+
+            >>> gettz('Pacific/Kiritimati')
+            tzfile('/usr/share/zoneinfo/Pacific/Kiritimati')
+
+        On Windows, the standard is extended to include the Windows-specific
+        zone names provided by the operating system:
+
+        .. code-block:: python3
+
+            >>> gettz('Egypt Standard Time')
+            tzwin('Egypt Standard Time')
+
+        Passing a GNU ``TZ`` style string time zone specification returns a
+        :class:`tzstr` object:
+
+        .. code-block:: python3
+
+            >>> gettz('AEST-10AEDT-11,M10.1.0/2,M4.1.0/3')
+            tzstr('AEST-10AEDT-11,M10.1.0/2,M4.1.0/3')
+
+        :param name:
+            A time zone name (IANA, or, on Windows, Windows keys), location of
+            a ``tzfile(5)`` zoneinfo file or ``TZ`` variable style time zone
+            specifier. An empty string, no argument or ``None`` is interpreted
+            as local time.
+
+        :return:
+            Returns an instance of one of ``dateutil``'s :py:class:`tzinfo`
+            subclasses.
+
+        .. versionchanged:: 2.7.0
+
+            After version 2.7.0, any two calls to ``gettz`` using the same
+            input strings will return the same object:
+
+            .. code-block:: python3
+
+                >>> tz.gettz('America/Chicago') is tz.gettz('America/Chicago')
+                True
+
+            In addition to improving performance, this ensures that
+            `"same zone" semantics`_ are used for datetimes in the same zone.
+
+
+        .. _`TZ variable`:
+            https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html
+
+        .. _`"same zone" semantics`:
+            https://blog.ganssle.io/articles/2018/02/aware-datetime-arithmetic.html
+        """
+        def __init__(self):
+
+            self.__instances = weakref.WeakValueDictionary()
+            self.__strong_cache_size = 8
+            self.__strong_cache = OrderedDict()
+            self._cache_lock = _thread.allocate_lock()
+
+        def __call__(self, name=None):
+            with self._cache_lock:
+                rv = self.__instances.get(name, None)
+
+                if rv is None:
+                    rv = self.nocache(name=name)
+                    if not (name is None
+                            or isinstance(rv, tzlocal_classes)
+                            or rv is None):
+                        # tzlocal is slightly more complicated than the other
+                        # time zone providers because it depends on environment
+                        # at construction time, so don't cache that.
+                        #
+                        # We also cannot store weak references to None, so we
+                        # will also not store that.
+                        self.__instances[name] = rv
+                    else:
+                        # No need for strong caching, return immediately
+                        return rv
+
+                self.__strong_cache[name] = self.__strong_cache.pop(name, rv)
+
+                if len(self.__strong_cache) > self.__strong_cache_size:
+                    self.__strong_cache.popitem(last=False)
+
+            return rv
+
+        def set_cache_size(self, size):
+            with self._cache_lock:
+                self.__strong_cache_size = size
+                while len(self.__strong_cache) > size:
+                    self.__strong_cache.popitem(last=False)
+
+        def cache_clear(self):
+            with self._cache_lock:
+                self.__instances = weakref.WeakValueDictionary()
+                self.__strong_cache.clear()
+
+        @staticmethod
+        def nocache(name=None):
+            """A non-cached version of gettz"""
+            tz = None
+            if not name:
+                try:
+                    name = os.environ["TZ"]
+                except KeyError:
+                    pass
+            if name is None or name in ("", ":"):
+                for filepath in TZFILES:
+                    if not os.path.isabs(filepath):
+                        filename = filepath
+                        for path in TZPATHS:
+                            filepath = os.path.join(path, filename)
+                            if os.path.isfile(filepath):
+                                break
+                        else:
+                            continue
+                    if os.path.isfile(filepath):
+                        try:
+                            tz = tzfile(filepath)
+                            break
+                        except (IOError, OSError, ValueError):
+                            pass
+                else:
+                    tz = tzlocal()
+            else:
+                try:
+                    if name.startswith(":"):
+                        name = name[1:]
+                except TypeError as e:
+                    if isinstance(name, bytes):
+                        new_msg = "gettz argument should be str, not bytes"
+                        six.raise_from(TypeError(new_msg), e)
+                    else:
+                        raise
+                if os.path.isabs(name):
+                    if os.path.isfile(name):
+                        tz = tzfile(name)
+                    else:
+                        tz = None
+                else:
+                    for path in TZPATHS:
+                        filepath = os.path.join(path, name)
+                        if not os.path.isfile(filepath):
+                            filepath = filepath.replace(' ', '_')
+                            if not os.path.isfile(filepath):
+                                continue
+                        try:
+                            tz = tzfile(filepath)
+                            break
+                        except (IOError, OSError, ValueError):
+                            pass
+                    else:
+                        tz = None
+                        if tzwin is not None:
+                            try:
+                                tz = tzwin(name)
+                            except (WindowsError, UnicodeEncodeError):
+                                # UnicodeEncodeError is for Python 2.7 compat
+                                tz = None
+
+                        if not tz:
+                            from dateutil.zoneinfo import get_zonefile_instance
+                            tz = get_zonefile_instance().get(name)
+
+                        if not tz:
+                            for c in name:
+                                # name is not a tzstr unless it has at least
+                                # one offset. For short values of "name", an
+                                # explicit for loop seems to be the fastest way
+                                # To determine if a string contains a digit
+                                if c in "0123456789":
+                                    try:
+                                        tz = tzstr(name)
+                                    except ValueError:
+                                        pass
+                                    break
+                            else:
+                                if name in ("GMT", "UTC"):
+                                    tz = UTC
+                                elif name in time.tzname:
+                                    tz = tzlocal()
+            return tz
+
+    return GettzFunc()
+
+
+gettz = __get_gettz()
+del __get_gettz
+
+
+def datetime_exists(dt, tz=None):
+    """
+    Given a datetime and a time zone, determine whether or not a given datetime
+    would fall in a gap.
+
+    :param dt:
+        A :class:`datetime.datetime` (whose time zone will be ignored if ``tz``
+        is provided.)
+
+    :param tz:
+        A :class:`datetime.tzinfo` with support for the ``fold`` attribute. If
+        ``None`` or not provided, the datetime's own time zone will be used.
+
+    :return:
+        Returns a boolean value whether or not the "wall time" exists in
+        ``tz``.
+
+    .. versionadded:: 2.7.0
+    """
+    if tz is None:
+        if dt.tzinfo is None:
+            raise ValueError('Datetime is naive and no time zone provided.')
+        tz = dt.tzinfo
+
+    dt = dt.replace(tzinfo=None)
+
+    # This is essentially a test of whether or not the datetime can survive
+    # a round trip to UTC.
+    dt_rt = dt.replace(tzinfo=tz).astimezone(UTC).astimezone(tz)
+    dt_rt = dt_rt.replace(tzinfo=None)
+
+    return dt == dt_rt
+
+
+def datetime_ambiguous(dt, tz=None):
+    """
+    Given a datetime and a time zone, determine whether or not a given datetime
+    is ambiguous (i.e if there are two times differentiated only by their DST
+    status).
+
+    :param dt:
+        A :class:`datetime.datetime` (whose time zone will be ignored if ``tz``
+        is provided.)
+
+    :param tz:
+        A :class:`datetime.tzinfo` with support for the ``fold`` attribute. If
+        ``None`` or not provided, the datetime's own time zone will be used.
+
+    :return:
+        Returns a boolean value whether or not the "wall time" is ambiguous in
+        ``tz``.
+
+    .. versionadded:: 2.6.0
+    """
+    if tz is None:
+        if dt.tzinfo is None:
+            raise ValueError('Datetime is naive and no time zone provided.')
+
+        tz = dt.tzinfo
+
+    # If a time zone defines its own "is_ambiguous" function, we'll use that.
+    is_ambiguous_fn = getattr(tz, 'is_ambiguous', None)
+    if is_ambiguous_fn is not None:
+        try:
+            return tz.is_ambiguous(dt)
+        except Exception:
+            pass
+
+    # If it doesn't come out and tell us it's ambiguous, we'll just check if
+    # the fold attribute has any effect on this particular date and time.
+    dt = dt.replace(tzinfo=tz)
+    wall_0 = enfold(dt, fold=0)
+    wall_1 = enfold(dt, fold=1)
+
+    same_offset = wall_0.utcoffset() == wall_1.utcoffset()
+    same_dst = wall_0.dst() == wall_1.dst()
+
+    return not (same_offset and same_dst)
+
+
+def resolve_imaginary(dt):
+    """
+    Given a datetime that may be imaginary, return an existing datetime.
+
+    This function assumes that an imaginary datetime represents what the
+    wall time would be in a zone had the offset transition not occurred, so
+    it will always fall forward by the transition's change in offset.
+
+    .. doctest::
+
+        >>> from dateutil import tz
+        >>> from datetime import datetime
+        >>> NYC = tz.gettz('America/New_York')
+        >>> print(tz.resolve_imaginary(datetime(2017, 3, 12, 2, 30, tzinfo=NYC)))
+        2017-03-12 03:30:00-04:00
+
+        >>> KIR = tz.gettz('Pacific/Kiritimati')
+        >>> print(tz.resolve_imaginary(datetime(1995, 1, 1, 12, 30, tzinfo=KIR)))
+        1995-01-02 12:30:00+14:00
+
+    As a note, :func:`datetime.astimezone` is guaranteed to produce a valid,
+    existing datetime, so a round-trip to and from UTC is sufficient to get
+    an extant datetime, however, this generally "falls back" to an earlier time
+    rather than falling forward to the STD side (though no guarantees are made
+    about this behavior).
+
+    :param dt:
+        A :class:`datetime.datetime` which may or may not exist.
+
+    :return:
+        Returns an existing :class:`datetime.datetime`. If ``dt`` was not
+        imaginary, the datetime returned is guaranteed to be the same object
+        passed to the function.
+
+    .. versionadded:: 2.7.0
+    """
+    if dt.tzinfo is not None and not datetime_exists(dt):
+
+        curr_offset = (dt + datetime.timedelta(hours=24)).utcoffset()
+        old_offset = (dt - datetime.timedelta(hours=24)).utcoffset()
+
+        dt += curr_offset - old_offset
+
+    return dt
+
+
+def _datetime_to_timestamp(dt):
+    """
+    Convert a :class:`datetime.datetime` object to an epoch timestamp in
+    seconds since January 1, 1970, ignoring the time zone.
+    """
+    return (dt.replace(tzinfo=None) - EPOCH).total_seconds()
+
+
+if sys.version_info >= (3, 6):
+    def _get_supported_offset(second_offset):
+        return second_offset
+else:
+    def _get_supported_offset(second_offset):
+        # For python pre-3.6, round to full-minutes if that's not the case.
+        # Python's datetime doesn't accept sub-minute timezones. Check
+        # http://python.org/sf/1447945 or https://bugs.python.org/issue5288
+        # for some information.
+        old_offset = second_offset
+        calculated_offset = 60 * ((second_offset + 30) // 60)
+        return calculated_offset
+
+
+try:
+    # Python 3.7 feature
+    from contextlib import nullcontext as _nullcontext
+except ImportError:
+    class _nullcontext(object):
+        """
+        Class for wrapping contexts so that they are passed through in a
+        with statement.
+        """
+        def __init__(self, context):
+            self.context = context
+
+        def __enter__(self):
+            return self.context
+
+        def __exit__(*args, **kwargs):
+            pass
+
+# vim:ts=4:sw=4:et
diff --git a/llm/Lib/site-packages/dateutil/tz/win.py b/llm/Lib/site-packages/dateutil/tz/win.py
new file mode 100644
index 0000000000000000000000000000000000000000..cde07ba792c40903f0c334839140173b39fd8124
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/tz/win.py
@@ -0,0 +1,370 @@
+# -*- coding: utf-8 -*-
+"""
+This module provides an interface to the native time zone data on Windows,
+including :py:class:`datetime.tzinfo` implementations.
+
+Attempting to import this module on a non-Windows platform will raise an
+:py:obj:`ImportError`.
+"""
+# This code was originally contributed by Jeffrey Harris.
+import datetime
+import struct
+
+from six.moves import winreg
+from six import text_type
+
+try:
+    import ctypes
+    from ctypes import wintypes
+except ValueError:
+    # ValueError is raised on non-Windows systems for some horrible reason.
+    raise ImportError("Running tzwin on non-Windows system")
+
+from ._common import tzrangebase
+
+__all__ = ["tzwin", "tzwinlocal", "tzres"]
+
+ONEWEEK = datetime.timedelta(7)
+
+TZKEYNAMENT = r"SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones"
+TZKEYNAME9X = r"SOFTWARE\Microsoft\Windows\CurrentVersion\Time Zones"
+TZLOCALKEYNAME = r"SYSTEM\CurrentControlSet\Control\TimeZoneInformation"
+
+
+def _settzkeyname():
+    handle = winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE)
+    try:
+        winreg.OpenKey(handle, TZKEYNAMENT).Close()
+        TZKEYNAME = TZKEYNAMENT
+    except WindowsError:
+        TZKEYNAME = TZKEYNAME9X
+    handle.Close()
+    return TZKEYNAME
+
+
+TZKEYNAME = _settzkeyname()
+
+
+class tzres(object):
+    """
+    Class for accessing ``tzres.dll``, which contains timezone name related
+    resources.
+
+    .. versionadded:: 2.5.0
+    """
+    p_wchar = ctypes.POINTER(wintypes.WCHAR)        # Pointer to a wide char
+
+    def __init__(self, tzres_loc='tzres.dll'):
+        # Load the user32 DLL so we can load strings from tzres
+        user32 = ctypes.WinDLL('user32')
+
+        # Specify the LoadStringW function
+        user32.LoadStringW.argtypes = (wintypes.HINSTANCE,
+                                       wintypes.UINT,
+                                       wintypes.LPWSTR,
+                                       ctypes.c_int)
+
+        self.LoadStringW = user32.LoadStringW
+        self._tzres = ctypes.WinDLL(tzres_loc)
+        self.tzres_loc = tzres_loc
+
+    def load_name(self, offset):
+        """
+        Load a timezone name from a DLL offset (integer).
+
+        >>> from dateutil.tzwin import tzres
+        >>> tzr = tzres()
+        >>> print(tzr.load_name(112))
+        'Eastern Standard Time'
+
+        :param offset:
+            A positive integer value referring to a string from the tzres dll.
+
+        .. note::
+
+            Offsets found in the registry are generally of the form
+            ``@tzres.dll,-114``. The offset in this case is 114, not -114.
+
+        """
+        resource = self.p_wchar()
+        lpBuffer = ctypes.cast(ctypes.byref(resource), wintypes.LPWSTR)
+        nchar = self.LoadStringW(self._tzres._handle, offset, lpBuffer, 0)
+        return resource[:nchar]
+
+    def name_from_string(self, tzname_str):
+        """
+        Parse strings as returned from the Windows registry into the time zone
+        name as defined in the registry.
+
+        >>> from dateutil.tzwin import tzres
+        >>> tzr = tzres()
+        >>> print(tzr.name_from_string('@tzres.dll,-251'))
+        'Dateline Daylight Time'
+        >>> print(tzr.name_from_string('Eastern Standard Time'))
+        'Eastern Standard Time'
+
+        :param tzname_str:
+            A timezone name string as returned from a Windows registry key.
+
+        :return:
+            Returns the localized timezone string from tzres.dll if the string
+            is of the form `@tzres.dll,-offset`, else returns the input string.
+        """
+        if not tzname_str.startswith('@'):
+            return tzname_str
+
+        name_splt = tzname_str.split(',-')
+        try:
+            offset = int(name_splt[1])
+        except:
+            raise ValueError("Malformed timezone string.")
+
+        return self.load_name(offset)
+
+
+class tzwinbase(tzrangebase):
+    """tzinfo class based on win32's timezones available in the registry."""
+    def __init__(self):
+        raise NotImplementedError('tzwinbase is an abstract base class')
+
+    def __eq__(self, other):
+        # Compare on all relevant dimensions, including name.
+        if not isinstance(other, tzwinbase):
+            return NotImplemented
+
+        return  (self._std_offset == other._std_offset and
+                 self._dst_offset == other._dst_offset and
+                 self._stddayofweek == other._stddayofweek and
+                 self._dstdayofweek == other._dstdayofweek and
+                 self._stdweeknumber == other._stdweeknumber and
+                 self._dstweeknumber == other._dstweeknumber and
+                 self._stdhour == other._stdhour and
+                 self._dsthour == other._dsthour and
+                 self._stdminute == other._stdminute and
+                 self._dstminute == other._dstminute and
+                 self._std_abbr == other._std_abbr and
+                 self._dst_abbr == other._dst_abbr)
+
+    @staticmethod
+    def list():
+        """Return a list of all time zones known to the system."""
+        with winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE) as handle:
+            with winreg.OpenKey(handle, TZKEYNAME) as tzkey:
+                result = [winreg.EnumKey(tzkey, i)
+                          for i in range(winreg.QueryInfoKey(tzkey)[0])]
+        return result
+
+    def display(self):
+        """
+        Return the display name of the time zone.
+        """
+        return self._display
+
+    def transitions(self, year):
+        """
+        For a given year, get the DST on and off transition times, expressed
+        always on the standard time side. For zones with no transitions, this
+        function returns ``None``.
+
+        :param year:
+            The year whose transitions you would like to query.
+
+        :return:
+            Returns a :class:`tuple` of :class:`datetime.datetime` objects,
+            ``(dston, dstoff)`` for zones with an annual DST transition, or
+            ``None`` for fixed offset zones.
+        """
+
+        if not self.hasdst:
+            return None
+
+        dston = picknthweekday(year, self._dstmonth, self._dstdayofweek,
+                               self._dsthour, self._dstminute,
+                               self._dstweeknumber)
+
+        dstoff = picknthweekday(year, self._stdmonth, self._stddayofweek,
+                                self._stdhour, self._stdminute,
+                                self._stdweeknumber)
+
+        # Ambiguous dates default to the STD side
+        dstoff -= self._dst_base_offset
+
+        return dston, dstoff
+
+    def _get_hasdst(self):
+        return self._dstmonth != 0
+
+    @property
+    def _dst_base_offset(self):
+        return self._dst_base_offset_
+
+
+class tzwin(tzwinbase):
+    """
+    Time zone object created from the zone info in the Windows registry
+
+    These are similar to :py:class:`dateutil.tz.tzrange` objects in that
+    the time zone data is provided in the format of a single offset rule
+    for either 0 or 2 time zone transitions per year.
+
+    :param: name
+        The name of a Windows time zone key, e.g. "Eastern Standard Time".
+        The full list of keys can be retrieved with :func:`tzwin.list`.
+    """
+
+    def __init__(self, name):
+        self._name = name
+
+        with winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE) as handle:
+            tzkeyname = text_type("{kn}\\{name}").format(kn=TZKEYNAME, name=name)
+            with winreg.OpenKey(handle, tzkeyname) as tzkey:
+                keydict = valuestodict(tzkey)
+
+        self._std_abbr = keydict["Std"]
+        self._dst_abbr = keydict["Dlt"]
+
+        self._display = keydict["Display"]
+
+        # See http://ww_winreg.jsiinc.com/SUBA/tip0300/rh0398.htm
+        tup = struct.unpack("=3l16h", keydict["TZI"])
+        stdoffset = -tup[0]-tup[1]          # Bias + StandardBias * -1
+        dstoffset = stdoffset-tup[2]        # + DaylightBias * -1
+        self._std_offset = datetime.timedelta(minutes=stdoffset)
+        self._dst_offset = datetime.timedelta(minutes=dstoffset)
+
+        # for the meaning see the win32 TIME_ZONE_INFORMATION structure docs
+        # http://msdn.microsoft.com/en-us/library/windows/desktop/ms725481(v=vs.85).aspx
+        (self._stdmonth,
+         self._stddayofweek,   # Sunday = 0
+         self._stdweeknumber,  # Last = 5
+         self._stdhour,
+         self._stdminute) = tup[4:9]
+
+        (self._dstmonth,
+         self._dstdayofweek,   # Sunday = 0
+         self._dstweeknumber,  # Last = 5
+         self._dsthour,
+         self._dstminute) = tup[12:17]
+
+        self._dst_base_offset_ = self._dst_offset - self._std_offset
+        self.hasdst = self._get_hasdst()
+
+    def __repr__(self):
+        return "tzwin(%s)" % repr(self._name)
+
+    def __reduce__(self):
+        return (self.__class__, (self._name,))
+
+
+class tzwinlocal(tzwinbase):
+    """
+    Class representing the local time zone information in the Windows registry
+
+    While :class:`dateutil.tz.tzlocal` makes system calls (via the :mod:`time`
+    module) to retrieve time zone information, ``tzwinlocal`` retrieves the
+    rules directly from the Windows registry and creates an object like
+    :class:`dateutil.tz.tzwin`.
+
+    Because Windows does not have an equivalent of :func:`time.tzset`, on
+    Windows, :class:`dateutil.tz.tzlocal` instances will always reflect the
+    time zone settings *at the time that the process was started*, meaning
+    changes to the machine's time zone settings during the run of a program
+    on Windows will **not** be reflected by :class:`dateutil.tz.tzlocal`.
+    Because ``tzwinlocal`` reads the registry directly, it is unaffected by
+    this issue.
+    """
+    def __init__(self):
+        with winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE) as handle:
+            with winreg.OpenKey(handle, TZLOCALKEYNAME) as tzlocalkey:
+                keydict = valuestodict(tzlocalkey)
+
+            self._std_abbr = keydict["StandardName"]
+            self._dst_abbr = keydict["DaylightName"]
+
+            try:
+                tzkeyname = text_type('{kn}\\{sn}').format(kn=TZKEYNAME,
+                                                          sn=self._std_abbr)
+                with winreg.OpenKey(handle, tzkeyname) as tzkey:
+                    _keydict = valuestodict(tzkey)
+                    self._display = _keydict["Display"]
+            except OSError:
+                self._display = None
+
+        stdoffset = -keydict["Bias"]-keydict["StandardBias"]
+        dstoffset = stdoffset-keydict["DaylightBias"]
+
+        self._std_offset = datetime.timedelta(minutes=stdoffset)
+        self._dst_offset = datetime.timedelta(minutes=dstoffset)
+
+        # For reasons unclear, in this particular key, the day of week has been
+        # moved to the END of the SYSTEMTIME structure.
+        tup = struct.unpack("=8h", keydict["StandardStart"])
+
+        (self._stdmonth,
+         self._stdweeknumber,  # Last = 5
+         self._stdhour,
+         self._stdminute) = tup[1:5]
+
+        self._stddayofweek = tup[7]
+
+        tup = struct.unpack("=8h", keydict["DaylightStart"])
+
+        (self._dstmonth,
+         self._dstweeknumber,  # Last = 5
+         self._dsthour,
+         self._dstminute) = tup[1:5]
+
+        self._dstdayofweek = tup[7]
+
+        self._dst_base_offset_ = self._dst_offset - self._std_offset
+        self.hasdst = self._get_hasdst()
+
+    def __repr__(self):
+        return "tzwinlocal()"
+
+    def __str__(self):
+        # str will return the standard name, not the daylight name.
+        return "tzwinlocal(%s)" % repr(self._std_abbr)
+
+    def __reduce__(self):
+        return (self.__class__, ())
+
+
+def picknthweekday(year, month, dayofweek, hour, minute, whichweek):
+    """ dayofweek == 0 means Sunday, whichweek 5 means last instance """
+    first = datetime.datetime(year, month, 1, hour, minute)
+
+    # This will work if dayofweek is ISO weekday (1-7) or Microsoft-style (0-6),
+    # Because 7 % 7 = 0
+    weekdayone = first.replace(day=((dayofweek - first.isoweekday()) % 7) + 1)
+    wd = weekdayone + ((whichweek - 1) * ONEWEEK)
+    if (wd.month != month):
+        wd -= ONEWEEK
+
+    return wd
+
+
+def valuestodict(key):
+    """Convert a registry key's values to a dictionary."""
+    dout = {}
+    size = winreg.QueryInfoKey(key)[1]
+    tz_res = None
+
+    for i in range(size):
+        key_name, value, dtype = winreg.EnumValue(key, i)
+        if dtype == winreg.REG_DWORD or dtype == winreg.REG_DWORD_LITTLE_ENDIAN:
+            # If it's a DWORD (32-bit integer), it's stored as unsigned - convert
+            # that to a proper signed integer
+            if value & (1 << 31):
+                value = value - (1 << 32)
+        elif dtype == winreg.REG_SZ:
+            # If it's a reference to the tzres DLL, load the actual string
+            if value.startswith('@tzres'):
+                tz_res = tz_res or tzres()
+                value = tz_res.name_from_string(value)
+
+            value = value.rstrip('\x00')    # Remove trailing nulls
+
+        dout[key_name] = value
+
+    return dout
diff --git a/llm/Lib/site-packages/dateutil/tzwin.py b/llm/Lib/site-packages/dateutil/tzwin.py
new file mode 100644
index 0000000000000000000000000000000000000000..cebc673e40fc376653ebf037e96f0a6d0b33e906
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/tzwin.py
@@ -0,0 +1,2 @@
+# tzwin has moved to dateutil.tz.win
+from .tz.win import *
diff --git a/llm/Lib/site-packages/dateutil/utils.py b/llm/Lib/site-packages/dateutil/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..dd2d245a0bebcd5fc37ac20526aabbd5358dab0e
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/utils.py
@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+"""
+This module offers general convenience and utility functions for dealing with
+datetimes.
+
+.. versionadded:: 2.7.0
+"""
+from __future__ import unicode_literals
+
+from datetime import datetime, time
+
+
+def today(tzinfo=None):
+    """
+    Returns a :py:class:`datetime` representing the current day at midnight
+
+    :param tzinfo:
+        The time zone to attach (also used to determine the current day).
+
+    :return:
+        A :py:class:`datetime.datetime` object representing the current day
+        at midnight.
+    """
+
+    dt = datetime.now(tzinfo)
+    return datetime.combine(dt.date(), time(0, tzinfo=tzinfo))
+
+
+def default_tzinfo(dt, tzinfo):
+    """
+    Sets the ``tzinfo`` parameter on naive datetimes only
+
+    This is useful for example when you are provided a datetime that may have
+    either an implicit or explicit time zone, such as when parsing a time zone
+    string.
+
+    .. doctest::
+
+        >>> from dateutil.tz import tzoffset
+        >>> from dateutil.parser import parse
+        >>> from dateutil.utils import default_tzinfo
+        >>> dflt_tz = tzoffset("EST", -18000)
+        >>> print(default_tzinfo(parse('2014-01-01 12:30 UTC'), dflt_tz))
+        2014-01-01 12:30:00+00:00
+        >>> print(default_tzinfo(parse('2014-01-01 12:30'), dflt_tz))
+        2014-01-01 12:30:00-05:00
+
+    :param dt:
+        The datetime on which to replace the time zone
+
+    :param tzinfo:
+        The :py:class:`datetime.tzinfo` subclass instance to assign to
+        ``dt`` if (and only if) it is naive.
+
+    :return:
+        Returns an aware :py:class:`datetime.datetime`.
+    """
+    if dt.tzinfo is not None:
+        return dt
+    else:
+        return dt.replace(tzinfo=tzinfo)
+
+
+def within_delta(dt1, dt2, delta):
+    """
+    Useful for comparing two datetimes that may have a negligible difference
+    to be considered equal.
+    """
+    delta = abs(delta)
+    difference = dt1 - dt2
+    return -delta <= difference <= delta
diff --git a/llm/Lib/site-packages/dateutil/zoneinfo/__init__.py b/llm/Lib/site-packages/dateutil/zoneinfo/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..34f11ad66c88047f2c049a4cdcc937b4b78ea6d6
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/zoneinfo/__init__.py
@@ -0,0 +1,167 @@
+# -*- coding: utf-8 -*-
+import warnings
+import json
+
+from tarfile import TarFile
+from pkgutil import get_data
+from io import BytesIO
+
+from dateutil.tz import tzfile as _tzfile
+
+__all__ = ["get_zonefile_instance", "gettz", "gettz_db_metadata"]
+
+ZONEFILENAME = "dateutil-zoneinfo.tar.gz"
+METADATA_FN = 'METADATA'
+
+
+class tzfile(_tzfile):
+    def __reduce__(self):
+        return (gettz, (self._filename,))
+
+
+def getzoneinfofile_stream():
+    try:
+        return BytesIO(get_data(__name__, ZONEFILENAME))
+    except IOError as e:  # TODO  switch to FileNotFoundError?
+        warnings.warn("I/O error({0}): {1}".format(e.errno, e.strerror))
+        return None
+
+
+class ZoneInfoFile(object):
+    def __init__(self, zonefile_stream=None):
+        if zonefile_stream is not None:
+            with TarFile.open(fileobj=zonefile_stream) as tf:
+                self.zones = {zf.name: tzfile(tf.extractfile(zf), filename=zf.name)
+                              for zf in tf.getmembers()
+                              if zf.isfile() and zf.name != METADATA_FN}
+                # deal with links: They'll point to their parent object. Less
+                # waste of memory
+                links = {zl.name: self.zones[zl.linkname]
+                         for zl in tf.getmembers() if
+                         zl.islnk() or zl.issym()}
+                self.zones.update(links)
+                try:
+                    metadata_json = tf.extractfile(tf.getmember(METADATA_FN))
+                    metadata_str = metadata_json.read().decode('UTF-8')
+                    self.metadata = json.loads(metadata_str)
+                except KeyError:
+                    # no metadata in tar file
+                    self.metadata = None
+        else:
+            self.zones = {}
+            self.metadata = None
+
+    def get(self, name, default=None):
+        """
+        Wrapper for :func:`ZoneInfoFile.zones.get`. This is a convenience method
+        for retrieving zones from the zone dictionary.
+
+        :param name:
+            The name of the zone to retrieve. (Generally IANA zone names)
+
+        :param default:
+            The value to return in the event of a missing key.
+
+        .. versionadded:: 2.6.0
+
+        """
+        return self.zones.get(name, default)
+
+
+# The current API has gettz as a module function, although in fact it taps into
+# a stateful class. So as a workaround for now, without changing the API, we
+# will create a new "global" class instance the first time a user requests a
+# timezone. Ugly, but adheres to the api.
+#
+# TODO: Remove after deprecation period.
+_CLASS_ZONE_INSTANCE = []
+
+
+def get_zonefile_instance(new_instance=False):
+    """
+    This is a convenience function which provides a :class:`ZoneInfoFile`
+    instance using the data provided by the ``dateutil`` package. By default, it
+    caches a single instance of the ZoneInfoFile object and returns that.
+
+    :param new_instance:
+        If ``True``, a new instance of :class:`ZoneInfoFile` is instantiated and
+        used as the cached instance for the next call. Otherwise, new instances
+        are created only as necessary.
+
+    :return:
+        Returns a :class:`ZoneInfoFile` object.
+
+    .. versionadded:: 2.6
+    """
+    if new_instance:
+        zif = None
+    else:
+        zif = getattr(get_zonefile_instance, '_cached_instance', None)
+
+    if zif is None:
+        zif = ZoneInfoFile(getzoneinfofile_stream())
+
+        get_zonefile_instance._cached_instance = zif
+
+    return zif
+
+
+def gettz(name):
+    """
+    This retrieves a time zone from the local zoneinfo tarball that is packaged
+    with dateutil.
+
+    :param name:
+        An IANA-style time zone name, as found in the zoneinfo file.
+
+    :return:
+        Returns a :class:`dateutil.tz.tzfile` time zone object.
+
+    .. warning::
+        It is generally inadvisable to use this function, and it is only
+        provided for API compatibility with earlier versions. This is *not*
+        equivalent to ``dateutil.tz.gettz()``, which selects an appropriate
+        time zone based on the inputs, favoring system zoneinfo. This is ONLY
+        for accessing the dateutil-specific zoneinfo (which may be out of
+        date compared to the system zoneinfo).
+
+    .. deprecated:: 2.6
+        If you need to use a specific zoneinfofile over the system zoneinfo,
+        instantiate a :class:`dateutil.zoneinfo.ZoneInfoFile` object and call
+        :func:`dateutil.zoneinfo.ZoneInfoFile.get(name)` instead.
+
+        Use :func:`get_zonefile_instance` to retrieve an instance of the
+        dateutil-provided zoneinfo.
+    """
+    warnings.warn("zoneinfo.gettz() will be removed in future versions, "
+                  "to use the dateutil-provided zoneinfo files, instantiate a "
+                  "ZoneInfoFile object and use ZoneInfoFile.zones.get() "
+                  "instead. See the documentation for details.",
+                  DeprecationWarning)
+
+    if len(_CLASS_ZONE_INSTANCE) == 0:
+        _CLASS_ZONE_INSTANCE.append(ZoneInfoFile(getzoneinfofile_stream()))
+    return _CLASS_ZONE_INSTANCE[0].zones.get(name)
+
+
+def gettz_db_metadata():
+    """ Get the zonefile metadata
+
+    See `zonefile_metadata`_
+
+    :returns:
+        A dictionary with the database metadata
+
+    .. deprecated:: 2.6
+        See deprecation warning in :func:`zoneinfo.gettz`. To get metadata,
+        query the attribute ``zoneinfo.ZoneInfoFile.metadata``.
+    """
+    warnings.warn("zoneinfo.gettz_db_metadata() will be removed in future "
+                  "versions, to use the dateutil-provided zoneinfo files, "
+                  "ZoneInfoFile object and query the 'metadata' attribute "
+                  "instead. See the documentation for details.",
+                  DeprecationWarning)
+
+    if len(_CLASS_ZONE_INSTANCE) == 0:
+        _CLASS_ZONE_INSTANCE.append(ZoneInfoFile(getzoneinfofile_stream()))
+    return _CLASS_ZONE_INSTANCE[0].metadata
diff --git a/llm/Lib/site-packages/dateutil/zoneinfo/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/dateutil/zoneinfo/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7920ffccb0f96eda1d8bf592cfdcdcbc765038fa
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/zoneinfo/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/zoneinfo/__pycache__/rebuild.cpython-311.pyc b/llm/Lib/site-packages/dateutil/zoneinfo/__pycache__/rebuild.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9ec1402ddfef7fe1515685977b1d5e14311d265f
Binary files /dev/null and b/llm/Lib/site-packages/dateutil/zoneinfo/__pycache__/rebuild.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/dateutil/zoneinfo/dateutil-zoneinfo.tar.gz b/llm/Lib/site-packages/dateutil/zoneinfo/dateutil-zoneinfo.tar.gz
new file mode 100644
index 0000000000000000000000000000000000000000..ff62a934a5009337271c60501278a7a34913a20b
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/zoneinfo/dateutil-zoneinfo.tar.gz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d3ea52e7b6e968de0d884df1288193596fa95b803db4f92a18279a7398004475
+size 156400
diff --git a/llm/Lib/site-packages/dateutil/zoneinfo/rebuild.py b/llm/Lib/site-packages/dateutil/zoneinfo/rebuild.py
new file mode 100644
index 0000000000000000000000000000000000000000..684c6586f091350c347f2b6150935f5214ffec27
--- /dev/null
+++ b/llm/Lib/site-packages/dateutil/zoneinfo/rebuild.py
@@ -0,0 +1,75 @@
+import logging
+import os
+import tempfile
+import shutil
+import json
+from subprocess import check_call, check_output
+from tarfile import TarFile
+
+from dateutil.zoneinfo import METADATA_FN, ZONEFILENAME
+
+
+def rebuild(filename, tag=None, format="gz", zonegroups=[], metadata=None):
+    """Rebuild the internal timezone info in dateutil/zoneinfo/zoneinfo*tar*
+
+    filename is the timezone tarball from ``ftp.iana.org/tz``.
+
+    """
+    tmpdir = tempfile.mkdtemp()
+    zonedir = os.path.join(tmpdir, "zoneinfo")
+    moduledir = os.path.dirname(__file__)
+    try:
+        with TarFile.open(filename) as tf:
+            for name in zonegroups:
+                tf.extract(name, tmpdir)
+            filepaths = [os.path.join(tmpdir, n) for n in zonegroups]
+
+            _run_zic(zonedir, filepaths)
+
+        # write metadata file
+        with open(os.path.join(zonedir, METADATA_FN), 'w') as f:
+            json.dump(metadata, f, indent=4, sort_keys=True)
+        target = os.path.join(moduledir, ZONEFILENAME)
+        with TarFile.open(target, "w:%s" % format) as tf:
+            for entry in os.listdir(zonedir):
+                entrypath = os.path.join(zonedir, entry)
+                tf.add(entrypath, entry)
+    finally:
+        shutil.rmtree(tmpdir)
+
+
+def _run_zic(zonedir, filepaths):
+    """Calls the ``zic`` compiler in a compatible way to get a "fat" binary.
+
+    Recent versions of ``zic`` default to ``-b slim``, while older versions
+    don't even have the ``-b`` option (but default to "fat" binaries). The
+    current version of dateutil does not support Version 2+ TZif files, which
+    causes problems when used in conjunction with "slim" binaries, so this
+    function is used to ensure that we always get a "fat" binary.
+    """
+
+    try:
+        help_text = check_output(["zic", "--help"])
+    except OSError as e:
+        _print_on_nosuchfile(e)
+        raise
+
+    if b"-b " in help_text:
+        bloat_args = ["-b", "fat"]
+    else:
+        bloat_args = []
+
+    check_call(["zic"] + bloat_args + ["-d", zonedir] + filepaths)
+
+
+def _print_on_nosuchfile(e):
+    """Print helpful troubleshooting message
+
+    e is an exception raised by subprocess.check_call()
+
+    """
+    if e.errno == 2:
+        logging.error(
+            "Could not find zic. Perhaps you need to install "
+            "libc-bin or some other package that provides it, "
+            "or it's not in your PATH?")
diff --git a/llm/Lib/site-packages/deprecation-2.1.0.dist-info/INSTALLER b/llm/Lib/site-packages/deprecation-2.1.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/deprecation-2.1.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/deprecation-2.1.0.dist-info/LICENSE b/llm/Lib/site-packages/deprecation-2.1.0.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..8dada3edaf50dbc082c9a125058f25def75e625a
--- /dev/null
+++ b/llm/Lib/site-packages/deprecation-2.1.0.dist-info/LICENSE
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright {yyyy} {name of copyright owner}
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/llm/Lib/site-packages/deprecation-2.1.0.dist-info/METADATA b/llm/Lib/site-packages/deprecation-2.1.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..1d44ff8c954b2d6e7b93e7ef0d370591d491b984
--- /dev/null
+++ b/llm/Lib/site-packages/deprecation-2.1.0.dist-info/METADATA
@@ -0,0 +1,114 @@
+Metadata-Version: 2.1
+Name: deprecation
+Version: 2.1.0
+Summary: A library to handle automated deprecations
+Home-page: http://deprecation.readthedocs.io/
+Author: Brian Curtin
+Author-email: brian@python.org
+Maintainer: Brian Curtin
+Maintainer-email: brian@python.org
+License: Apache 2
+Project-URL: Documentation, http://deprecation.readthedocs.io/en/latest/
+Project-URL: Source, https://github.com/briancurtin/deprecation
+Project-URL: Bug Tracker, https://github.com/briancurtin/deprecation/issues
+Keywords: deprecation
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: packaging
+
+deprecation
+===========
+
+.. image:: https://readthedocs.org/projects/deprecation/badge/?version=latest
+   :target: http://deprecation.readthedocs.io/en/latest/
+   :alt: Documentation Status
+
+.. image:: https://travis-ci.org/briancurtin/deprecation.svg?branch=master
+    :target: https://travis-ci.org/briancurtin/deprecation
+
+.. image:: https://codecov.io/gh/briancurtin/deprecation/branch/master/graph/badge.svg
+  :target: https://codecov.io/gh/briancurtin/deprecation
+
+The ``deprecation`` library provides a ``deprecated`` decorator and a
+``fail_if_not_removed`` decorator for your tests. Together, the two
+enable the automation of several things:
+
+1. The docstring of a deprecated method gets the deprecation details
+   appended to the end of it. If you generate your API docs direct
+   from your source, you don't need to worry about writing your own
+   notification. You also don't need to worry about forgetting to
+   write it. It's done for you.
+2. Rather than having code live on forever because you only deprecated
+   it but never actually moved on from it, you can have your tests
+   tell you when it's time to remove the code. The ``@deprecated``
+   decorator can be told when it's time to entirely remove the code,
+   which causes ``@fail_if_not_removed`` to raise an ``AssertionError``,
+   causing either your unittest or py.test tests to fail.
+
+See http://deprecation.readthedocs.io/ for the full documentation.
+
+Installation
+============
+
+ ::
+
+    pip install deprecation
+
+Usage
+=====
+
+ ::
+
+    import deprecation
+
+    @deprecation.deprecated(deprecated_in="1.0", removed_in="2.0",
+                            current_version=__version__,
+                            details="Use the bar function instead")
+    def foo():
+        """Do some stuff"""
+        return 1
+
+...but doesn't Python ignore ``DeprecationWarning``?
+====================================================
+
+Yes, by default since 2.7—and for good reason [#]_ —and this works fine
+with that.
+
+1. It often makes sense for you to run your tests with a ``-W`` flag or
+   the ``PYTHONWARNINGS`` environment variable so you catch warnings
+   in development and handle them appropriately. The warnings raised by
+   this library show up there, as they're subclasses of the built-in
+   ``DeprecationWarning``. See the `Command Line
+   <https://docs.python.org/2/using/cmdline.html#cmdoption-W>`_
+   and `Environment Variable
+   <https://docs.python.org/2/using/cmdline.html#envvar-PYTHONWARNINGS>`_
+   documentation for more details.
+2. Even if you don't enable those things, the behavior of this library
+   remains the same. The docstrings will still be updated and the tests
+   will still fail when they need to. You'll get the benefits regardless
+   of what Python cares about ``DeprecationWarning``.
+
+----
+
+.. [#] Exposing application users to ``DeprecationWarning``\s that are
+       emitted by lower-level code needlessly involves end-users in
+       "how things are done." It often leads to users raising issues
+       about warnings they're presented, which on one hand is done
+       rightfully so, as it's been presented to them as some sort of
+       issue to resolve. However, at the same time, the warning could
+       be well known and planned for. From either side, loud
+       ``DeprecationWarning``\s can be seen as noise that isn't
+       necessary outside of development.
+
+
diff --git a/llm/Lib/site-packages/deprecation-2.1.0.dist-info/RECORD b/llm/Lib/site-packages/deprecation-2.1.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..19f4b298076a86437b5f07e99b7fd39a6b1bfcb3
--- /dev/null
+++ b/llm/Lib/site-packages/deprecation-2.1.0.dist-info/RECORD
@@ -0,0 +1,8 @@
+__pycache__/deprecation.cpython-311.pyc,,
+deprecation-2.1.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+deprecation-2.1.0.dist-info/LICENSE,sha256=tAkwu8-AdEyGxGoSvJ2gVmQdcicWw3j1ZZueVV74M-E,11357
+deprecation-2.1.0.dist-info/METADATA,sha256=AmlhU86t_lQQh858jSMZMZpoYM6gfnnLSKKe5DgGU88,4604
+deprecation-2.1.0.dist-info/RECORD,,
+deprecation-2.1.0.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+deprecation-2.1.0.dist-info/top_level.txt,sha256=ztDh9pLraFksBgQ6iXWE_OnukoBC6_jkPQ4Y6p7771o,12
+deprecation.py,sha256=Z8qPVC-janAf7Ppoc1wYTiTWvGSdSjErOV1jDhnHN0Y,12895
diff --git a/llm/Lib/site-packages/deprecation-2.1.0.dist-info/WHEEL b/llm/Lib/site-packages/deprecation-2.1.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/llm/Lib/site-packages/deprecation-2.1.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/deprecation-2.1.0.dist-info/top_level.txt b/llm/Lib/site-packages/deprecation-2.1.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..4ba9b7530edb65eb2e59706b230a62c8912ab515
--- /dev/null
+++ b/llm/Lib/site-packages/deprecation-2.1.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+deprecation
diff --git a/llm/Lib/site-packages/deprecation.py b/llm/Lib/site-packages/deprecation.py
new file mode 100644
index 0000000000000000000000000000000000000000..0217b58906dbbb2a5217da39f84d65874db4185b
--- /dev/null
+++ b/llm/Lib/site-packages/deprecation.py
@@ -0,0 +1,290 @@
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+import collections
+import functools
+import textwrap
+import warnings
+
+from packaging import version
+from datetime import date
+
+__version__ = "2.1.0"
+
+# This is mostly here so automodule docs are ordered more ideally.
+__all__ = ["deprecated", "message_location", "fail_if_not_removed",
+           "DeprecatedWarning", "UnsupportedWarning"]
+
+#: Location where the details are added to a deprecated docstring
+#:
+#: When set to ``"bottom"``, the details are appended to the end.
+#: When set to ``"top"``, the details are inserted between the
+#: summary line and docstring contents.
+message_location = "bottom"
+
+
+class DeprecatedWarning(DeprecationWarning):
+    """A warning class for deprecated methods
+
+    This is a specialization of the built-in :class:`DeprecationWarning`,
+    adding parameters that allow us to get information into the __str__
+    that ends up being sent through the :mod:`warnings` system.
+    The attributes aren't able to be retrieved after the warning gets
+    raised and passed through the system as only the class--not the
+    instance--and message are what gets preserved.
+
+    :param function: The function being deprecated.
+    :param deprecated_in: The version that ``function`` is deprecated in
+    :param removed_in: The version or :class:`datetime.date` specifying
+                       when ``function`` gets removed.
+    :param details: Optional details about the deprecation. Most often
+                    this will include directions on what to use instead
+                    of the now deprecated code.
+    """
+
+    def __init__(self, function, deprecated_in, removed_in, details=""):
+        # NOTE: The docstring only works for this class if it appears up
+        # near the class name, not here inside __init__. I think it has
+        # to do with being an exception class.
+        self.function = function
+        self.deprecated_in = deprecated_in
+        self.removed_in = removed_in
+        self.details = details
+        super(DeprecatedWarning, self).__init__(function, deprecated_in,
+                                                removed_in, details)
+
+    def __str__(self):
+        # Use a defaultdict to give us the empty string
+        # when a part isn't included.
+        parts = collections.defaultdict(str)
+        parts["function"] = self.function
+
+        if self.deprecated_in:
+            parts["deprecated"] = " as of %s" % self.deprecated_in
+        if self.removed_in:
+            parts["removed"] = " and will be removed {} {}".format("on" if isinstance(self.removed_in, date) else "in",
+                                                                   self.removed_in)
+        if any([self.deprecated_in, self.removed_in, self.details]):
+            parts["period"] = "."
+        if self.details:
+            parts["details"] = " %s" % self.details
+
+        return ("%(function)s is deprecated%(deprecated)s%(removed)s"
+                "%(period)s%(details)s" % (parts))
+
+
+class UnsupportedWarning(DeprecatedWarning):
+    """A warning class for methods to be removed
+
+    This is a subclass of :class:`~deprecation.DeprecatedWarning` and is used
+    to output a proper message about a function being unsupported.
+    Additionally, the :func:`~deprecation.fail_if_not_removed` decorator
+    will handle this warning and cause any tests to fail if the system
+    under test uses code that raises this warning.
+    """
+
+    def __str__(self):
+        parts = collections.defaultdict(str)
+        parts["function"] = self.function
+        parts["removed"] = self.removed_in
+
+        if self.details:
+            parts["details"] = " %s" % self.details
+
+        return ("%(function)s is unsupported as of %(removed)s."
+                "%(details)s" % (parts))
+
+
+def deprecated(deprecated_in=None, removed_in=None, current_version=None,
+               details=""):
+    """Decorate a function to signify its deprecation
+
+    This function wraps a method that will soon be removed and does two things:
+        * The docstring of the method will be modified to include a notice
+          about deprecation, e.g., "Deprecated since 0.9.11. Use foo instead."
+        * Raises a :class:`~deprecation.DeprecatedWarning`
+          via the :mod:`warnings` module, which is a subclass of the built-in
+          :class:`DeprecationWarning`. Note that built-in
+          :class:`DeprecationWarning`s are ignored by default, so for users
+          to be informed of said warnings they will need to enable them--see
+          the :mod:`warnings` module documentation for more details.
+
+    :param deprecated_in: The version at which the decorated method is
+                          considered deprecated. This will usually be the
+                          next version to be released when the decorator is
+                          added. The default is **None**, which effectively
+                          means immediate deprecation. If this is not
+                          specified, then the `removed_in` and
+                          `current_version` arguments are ignored.
+    :param removed_in: The version or :class:`datetime.date` when the decorated
+                       method will be removed. The default is **None**,
+                       specifying that the function is not currently planned
+                       to be removed.
+                       Note: This parameter cannot be set to a value if
+                       `deprecated_in=None`.
+    :param current_version: The source of version information for the
+                            currently running code. This will usually be
+                            a `__version__` attribute on your library.
+                            The default is `None`.
+                            When `current_version=None` the automation to
+                            determine if the wrapped function is actually
+                            in a period of deprecation or time for removal
+                            does not work, causing a
+                            :class:`~deprecation.DeprecatedWarning`
+                            to be raised in all cases.
+    :param details: Extra details to be added to the method docstring and
+                    warning. For example, the details may point users to
+                    a replacement method, such as "Use the foo_bar
+                    method instead". By default there are no details.
+    """
+    # You can't just jump to removal. It's weird, unfair, and also makes
+    # building up the docstring weird.
+    if deprecated_in is None and removed_in is not None:
+        raise TypeError("Cannot set removed_in to a value "
+                        "without also setting deprecated_in")
+
+    # Only warn when it's appropriate. There may be cases when it makes sense
+    # to add this decorator before a formal deprecation period begins.
+    # In CPython, PendingDeprecatedWarning gets used in that period,
+    # so perhaps mimick that at some point.
+    is_deprecated = False
+    is_unsupported = False
+
+    # StrictVersion won't take a None or a "", so make whatever goes to it
+    # is at least *something*. Compare versions only if removed_in is not
+    # of type datetime.date
+    if isinstance(removed_in, date):
+        if date.today() >= removed_in:
+            is_unsupported = True
+        else:
+            is_deprecated = True
+    elif current_version:
+        current_version = version.parse(current_version)
+
+        if (removed_in
+                and current_version >= version.parse(removed_in)):
+            is_unsupported = True
+        elif (deprecated_in
+              and current_version >= version.parse(deprecated_in)):
+            is_deprecated = True
+    else:
+        # If we can't actually calculate that we're in a period of
+        # deprecation...well, they used the decorator, so it's deprecated.
+        # This will cover the case of someone just using
+        # @deprecated("1.0") without the other advantages.
+        is_deprecated = True
+
+    should_warn = any([is_deprecated, is_unsupported])
+
+    def _function_wrapper(function):
+        if should_warn:
+            # Everything *should* have a docstring, but just in case...
+            existing_docstring = function.__doc__ or ""
+
+            # The various parts of this decorator being optional makes for
+            # a number of ways the deprecation notice could go. The following
+            # makes for a nicely constructed sentence with or without any
+            # of the parts.
+
+            # If removed_in is a date, use "removed on"
+            # If removed_in is a version, use "removed in"
+            parts = {
+                "deprecated_in":
+                    " %s" % deprecated_in if deprecated_in else "",
+                "removed_in":
+                    "\n   This will be removed {} {}.".format("on" if isinstance(removed_in, date) else "in",
+                                                              removed_in) if removed_in else "",
+                "details":
+                    " %s" % details if details else ""}
+
+            deprecation_note = (".. deprecated::{deprecated_in}"
+                                "{removed_in}{details}".format(**parts))
+
+            # default location for insertion of deprecation note
+            loc = 1
+
+            # split docstring at first occurrence of newline
+            string_list = existing_docstring.split("\n", 1)
+
+            if len(string_list) > 1:
+                # With a multi-line docstring, when we modify
+                # existing_docstring to add our deprecation_note,
+                # if we're not careful we'll interfere with the
+                # indentation levels of the contents below the
+                # first line, or as PEP 257 calls it, the summary
+                # line. Since the summary line can start on the
+                # same line as the """, dedenting the whole thing
+                # won't help. Split the summary and contents up,
+                # dedent the contents independently, then join
+                # summary, dedent'ed contents, and our
+                # deprecation_note.
+
+                # in-place dedent docstring content
+                string_list[1] = textwrap.dedent(string_list[1])
+
+                # we need another newline
+                string_list.insert(loc, "\n")
+
+                # change the message_location if we add to end of docstring
+                # do this always if not "top"
+                if message_location != "top":
+                    loc = 3
+
+            # insert deprecation note and dual newline
+            string_list.insert(loc, deprecation_note)
+            string_list.insert(loc, "\n\n")
+
+            function.__doc__ = "".join(string_list)
+
+        @functools.wraps(function)
+        def _inner(*args, **kwargs):
+            if should_warn:
+                if is_unsupported:
+                    cls = UnsupportedWarning
+                else:
+                    cls = DeprecatedWarning
+
+                the_warning = cls(function.__name__, deprecated_in,
+                                  removed_in, details)
+                warnings.warn(the_warning, category=DeprecationWarning,
+                              stacklevel=2)
+
+            return function(*args, **kwargs)
+        return _inner
+    return _function_wrapper
+
+
+def fail_if_not_removed(method):
+    """Decorate a test method to track removal of deprecated code
+
+    This decorator catches :class:`~deprecation.UnsupportedWarning`
+    warnings that occur during testing and causes unittests to fail,
+    making it easier to keep track of when code should be removed.
+
+    :raises: :class:`AssertionError` if an
+             :class:`~deprecation.UnsupportedWarning`
+             is raised while running the test method.
+    """
+    # NOTE(briancurtin): Unless this is named test_inner, nose won't work
+    # properly. See Issue #32.
+    @functools.wraps(method)
+    def test_inner(*args, **kwargs):
+        with warnings.catch_warnings(record=True) as caught_warnings:
+            warnings.simplefilter("always")
+            rv = method(*args, **kwargs)
+
+        for warning in caught_warnings:
+            if warning.category == UnsupportedWarning:
+                raise AssertionError(
+                    ("%s uses a function that should be removed: %s" %
+                     (method, str(warning.message))))
+        return rv
+    return test_inner
diff --git a/llm/Lib/site-packages/distro-1.9.0.dist-info/INSTALLER b/llm/Lib/site-packages/distro-1.9.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/distro-1.9.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/distro-1.9.0.dist-info/LICENSE b/llm/Lib/site-packages/distro-1.9.0.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..e06d2081865a766a8668acc12878f98b27fc9ea0
--- /dev/null
+++ b/llm/Lib/site-packages/distro-1.9.0.dist-info/LICENSE
@@ -0,0 +1,202 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright {yyyy} {name of copyright owner}
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
diff --git a/llm/Lib/site-packages/distro-1.9.0.dist-info/METADATA b/llm/Lib/site-packages/distro-1.9.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..9312e8e4cefa36c70dcb27017fd154c7ff575ad5
--- /dev/null
+++ b/llm/Lib/site-packages/distro-1.9.0.dist-info/METADATA
@@ -0,0 +1,184 @@
+Metadata-Version: 2.1
+Name: distro
+Version: 1.9.0
+Summary: Distro - an OS platform information API
+Home-page: https://github.com/python-distro/distro
+Author: Nir Cohen
+Author-email: nir36g@gmail.com
+License: Apache License, Version 2.0
+Platform: All
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: POSIX :: BSD
+Classifier: Operating System :: POSIX :: BSD :: FreeBSD
+Classifier: Operating System :: POSIX :: BSD :: NetBSD
+Classifier: Operating System :: POSIX :: BSD :: OpenBSD
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Operating System
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+Distro - an OS platform information API
+=======================================
+
+[![CI Status](https://github.com/python-distro/distro/workflows/CI/badge.svg)](https://github.com/python-distro/distro/actions/workflows/ci.yaml)
+[![PyPI version](http://img.shields.io/pypi/v/distro.svg)](https://pypi.python.org/pypi/distro)
+[![Supported Python Versions](https://img.shields.io/pypi/pyversions/distro.svg)](https://img.shields.io/pypi/pyversions/distro.svg)
+[![Code Coverage](https://codecov.io/github/python-distro/distro/coverage.svg?branch=master)](https://codecov.io/github/python-distro/distro?branch=master)
+[![Is Wheel](https://img.shields.io/pypi/wheel/distro.svg?style=flat)](https://pypi.python.org/pypi/distro)
+[![Latest Github Release](https://readthedocs.org/projects/distro/badge/?version=stable)](http://distro.readthedocs.io/en/latest/)
+
+`distro` provides information about the
+OS distribution it runs on, such as a reliable machine-readable ID, or
+version information.
+
+It is the recommended replacement for Python's original
+[`platform.linux_distribution`](https://docs.python.org/3.7/library/platform.html#platform.linux_distribution)
+function (removed in Python 3.8). It also provides much more functionality
+which isn't necessarily Python bound, like a command-line interface.
+
+Distro currently supports Linux and BSD based systems but [Windows and OS X support](https://github.com/python-distro/distro/issues/177) is also planned.
+
+For Python 2.6 support, see https://github.com/python-distro/distro/tree/python2.6-support
+
+## Installation
+
+Installation of the latest released version from PyPI:
+
+```shell
+pip install distro
+```
+
+Installation of the latest development version:
+
+```shell
+pip install https://github.com/python-distro/distro/archive/master.tar.gz
+```
+
+To use as a standalone script, download `distro.py` directly:
+
+```shell
+curl -O https://raw.githubusercontent.com/python-distro/distro/master/src/distro/distro.py
+python distro.py
+```
+
+``distro`` is safe to vendor within projects that do not wish to add
+dependencies.
+
+```shell
+cd myproject
+curl -O https://raw.githubusercontent.com/python-distro/distro/master/src/distro/distro.py
+```
+
+## Usage
+
+```bash
+$ distro
+Name: Antergos Linux
+Version: 2015.10 (ISO-Rolling)
+Codename: ISO-Rolling
+
+$ distro -j
+{
+    "codename": "ISO-Rolling",
+    "id": "antergos",
+    "like": "arch",
+    "version": "16.9",
+    "version_parts": {
+        "build_number": "",
+        "major": "16",
+        "minor": "9"
+    }
+}
+
+
+$ python
+>>> import distro
+>>> distro.name(pretty=True)
+'CentOS Linux 8'
+>>> distro.id()
+'centos'
+>>> distro.version(best=True)
+'8.4.2105'
+```
+
+
+## Documentation
+
+On top of the aforementioned API, several more functions are available. For a complete description of the
+API, see the [latest API documentation](http://distro.readthedocs.org/en/latest/).
+
+## Background
+
+An alternative implementation became necessary because Python 3.5 deprecated
+this function, and Python 3.8 removed it altogether. Its predecessor function
+[`platform.dist`](https://docs.python.org/3.7/library/platform.html#platform.dist)
+was already deprecated since Python 2.6 and removed in Python 3.8. Still, there
+are many cases in which access to that information is needed. See [Python issue
+1322](https://bugs.python.org/issue1322) for more information.
+
+The `distro` package implements a robust and inclusive way of retrieving the
+information about a distribution based on new standards and old methods,
+namely from these data sources (from high to low precedence):
+
+* The os-release file `/etc/os-release` if present, with a fall-back on `/usr/lib/os-release` if needed.
+* The output of the `lsb_release` command, if available.
+* The distro release file (`/etc/*(-|_)(release|version)`), if present.
+* The `uname` command for BSD based distrubtions.
+
+
+## Python and Distribution Support
+
+`distro` is supported and tested on Python 3.6+ and PyPy and on any
+distribution that provides one or more of the data sources covered.
+
+This package is tested with test data that mimics the exact behavior of the data sources of [a number of Linux distributions](https://github.com/python-distro/distro/tree/master/tests/resources/distros).
+
+
+## Testing
+
+```shell
+git clone git@github.com:python-distro/distro.git
+cd distro
+pip install tox
+tox
+```
+
+
+## Contributions
+
+Pull requests are always welcome to deal with specific distributions or just
+for general merriment.
+
+See [CONTRIBUTIONS](https://github.com/python-distro/distro/blob/master/CONTRIBUTING.md) for contribution info.
+
+Reference implementations for supporting additional distributions and file
+formats can be found here:
+
+* https://github.com/saltstack/salt/blob/develop/salt/grains/core.py#L1172
+* https://github.com/chef/ohai/blob/master/lib/ohai/plugins/linux/platform.rb
+* https://github.com/ansible/ansible/blob/devel/lib/ansible/module_utils/facts/system/distribution.py
+* https://github.com/puppetlabs/facter/blob/master/lib/src/facts/linux/os_linux.cc
+
+## Package manager distributions
+
+* https://src.fedoraproject.org/rpms/python-distro
+* https://www.archlinux.org/packages/community/any/python-distro/
+* https://launchpad.net/ubuntu/+source/python-distro
+* https://packages.debian.org/stable/python3-distro
+* https://packages.gentoo.org/packages/dev-python/distro
+* https://pkgs.org/download/python3-distro
+* https://slackbuilds.org/repository/14.2/python/python-distro/
diff --git a/llm/Lib/site-packages/distro-1.9.0.dist-info/RECORD b/llm/Lib/site-packages/distro-1.9.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..bc188f22f277417e2fb74f1dfcb0cceec49c65e0
--- /dev/null
+++ b/llm/Lib/site-packages/distro-1.9.0.dist-info/RECORD
@@ -0,0 +1,15 @@
+../../Scripts/distro.exe,sha256=b5q3ArmCJoYfvjq6jS-9befRt6jfFWEu5HGANCOsCOk,108380
+distro-1.9.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+distro-1.9.0.dist-info/LICENSE,sha256=y16Ofl9KOYjhBjwULGDcLfdWBfTEZRXnduOspt-XbhQ,11325
+distro-1.9.0.dist-info/METADATA,sha256=MWMqst5VkRMQkbM5e9zfeXcYV52Fp1GG8Gg53QwJ6B0,6791
+distro-1.9.0.dist-info/RECORD,,
+distro-1.9.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+distro-1.9.0.dist-info/entry_points.txt,sha256=3ObjqQMbh1xeQQwsWtgbfDNDMDD-EbggR1Oj_z8s9hc,46
+distro-1.9.0.dist-info/top_level.txt,sha256=ikde_V_XEdSBqaGd5tEriN_wzYHLgTX_zVtlsGLHvwQ,7
+distro/__init__.py,sha256=2fHjF-SfgPvjyNZ1iHh_wjqWdR_Yo5ODHwZC0jLBPhc,981
+distro/__main__.py,sha256=bu9d3TifoKciZFcqRBuygV3GSuThnVD_m2IK4cz96Vs,64
+distro/__pycache__/__init__.cpython-311.pyc,,
+distro/__pycache__/__main__.cpython-311.pyc,,
+distro/__pycache__/distro.cpython-311.pyc,,
+distro/distro.py,sha256=XqbefacAhDT4zr_trnbA15eY8vdK4GTghgmvUGrEM_4,49430
+distro/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
diff --git a/llm/Lib/site-packages/distro-1.9.0.dist-info/WHEEL b/llm/Lib/site-packages/distro-1.9.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..98c0d20b7a64f4f998d7913e1d38a05dba20916c
--- /dev/null
+++ b/llm/Lib/site-packages/distro-1.9.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.42.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/distro-1.9.0.dist-info/entry_points.txt b/llm/Lib/site-packages/distro-1.9.0.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..08d29c55c1743a7d61860303c9b8074414d86781
--- /dev/null
+++ b/llm/Lib/site-packages/distro-1.9.0.dist-info/entry_points.txt
@@ -0,0 +1,2 @@
+[console_scripts]
+distro = distro.distro:main
diff --git a/llm/Lib/site-packages/distro-1.9.0.dist-info/top_level.txt b/llm/Lib/site-packages/distro-1.9.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..0e0933171d3eb977bbc6911eec27b9c0ba289500
--- /dev/null
+++ b/llm/Lib/site-packages/distro-1.9.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+distro
diff --git a/llm/Lib/site-packages/distro/__init__.py b/llm/Lib/site-packages/distro/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7686fe85a7cc94188da76bfb1c10ad2a10821256
--- /dev/null
+++ b/llm/Lib/site-packages/distro/__init__.py
@@ -0,0 +1,54 @@
+from .distro import (
+    NORMALIZED_DISTRO_ID,
+    NORMALIZED_LSB_ID,
+    NORMALIZED_OS_ID,
+    LinuxDistribution,
+    __version__,
+    build_number,
+    codename,
+    distro_release_attr,
+    distro_release_info,
+    id,
+    info,
+    like,
+    linux_distribution,
+    lsb_release_attr,
+    lsb_release_info,
+    major_version,
+    minor_version,
+    name,
+    os_release_attr,
+    os_release_info,
+    uname_attr,
+    uname_info,
+    version,
+    version_parts,
+)
+
+__all__ = [
+    "NORMALIZED_DISTRO_ID",
+    "NORMALIZED_LSB_ID",
+    "NORMALIZED_OS_ID",
+    "LinuxDistribution",
+    "build_number",
+    "codename",
+    "distro_release_attr",
+    "distro_release_info",
+    "id",
+    "info",
+    "like",
+    "linux_distribution",
+    "lsb_release_attr",
+    "lsb_release_info",
+    "major_version",
+    "minor_version",
+    "name",
+    "os_release_attr",
+    "os_release_info",
+    "uname_attr",
+    "uname_info",
+    "version",
+    "version_parts",
+]
+
+__version__ = __version__
diff --git a/llm/Lib/site-packages/distro/__main__.py b/llm/Lib/site-packages/distro/__main__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c01d5b08b6b44379b931d54d7fcf5221fdc9fde
--- /dev/null
+++ b/llm/Lib/site-packages/distro/__main__.py
@@ -0,0 +1,4 @@
+from .distro import main
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/distro/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/distro/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..867f31a23938b9a3059d11d3b7815cb95b718515
Binary files /dev/null and b/llm/Lib/site-packages/distro/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/distro/__pycache__/__main__.cpython-311.pyc b/llm/Lib/site-packages/distro/__pycache__/__main__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4735aa9f925d1b11d46b13575a55171d480ed570
Binary files /dev/null and b/llm/Lib/site-packages/distro/__pycache__/__main__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/distro/__pycache__/distro.cpython-311.pyc b/llm/Lib/site-packages/distro/__pycache__/distro.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..88fd5133b1b973d948fc9b1821ece293e22e3590
Binary files /dev/null and b/llm/Lib/site-packages/distro/__pycache__/distro.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/distro/distro.py b/llm/Lib/site-packages/distro/distro.py
new file mode 100644
index 0000000000000000000000000000000000000000..78ccdfa402ac29a8ef8aaddf7b527a0efb568d43
--- /dev/null
+++ b/llm/Lib/site-packages/distro/distro.py
@@ -0,0 +1,1403 @@
+#!/usr/bin/env python
+# Copyright 2015-2021 Nir Cohen
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+The ``distro`` package (``distro`` stands for Linux Distribution) provides
+information about the Linux distribution it runs on, such as a reliable
+machine-readable distro ID, or version information.
+
+It is the recommended replacement for Python's original
+:py:func:`platform.linux_distribution` function, but it provides much more
+functionality. An alternative implementation became necessary because Python
+3.5 deprecated this function, and Python 3.8 removed it altogether. Its
+predecessor function :py:func:`platform.dist` was already deprecated since
+Python 2.6 and removed in Python 3.8. Still, there are many cases in which
+access to OS distribution information is needed. See `Python issue 1322
+<https://bugs.python.org/issue1322>`_ for more information.
+"""
+
+import argparse
+import json
+import logging
+import os
+import re
+import shlex
+import subprocess
+import sys
+import warnings
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    Optional,
+    Sequence,
+    TextIO,
+    Tuple,
+    Type,
+)
+
+try:
+    from typing import TypedDict
+except ImportError:
+    # Python 3.7
+    TypedDict = dict
+
+__version__ = "1.9.0"
+
+
+class VersionDict(TypedDict):
+    major: str
+    minor: str
+    build_number: str
+
+
+class InfoDict(TypedDict):
+    id: str
+    version: str
+    version_parts: VersionDict
+    like: str
+    codename: str
+
+
+_UNIXCONFDIR = os.environ.get("UNIXCONFDIR", "/etc")
+_UNIXUSRLIBDIR = os.environ.get("UNIXUSRLIBDIR", "/usr/lib")
+_OS_RELEASE_BASENAME = "os-release"
+
+#: Translation table for normalizing the "ID" attribute defined in os-release
+#: files, for use by the :func:`distro.id` method.
+#:
+#: * Key: Value as defined in the os-release file, translated to lower case,
+#:   with blanks translated to underscores.
+#:
+#: * Value: Normalized value.
+NORMALIZED_OS_ID = {
+    "ol": "oracle",  # Oracle Linux
+    "opensuse-leap": "opensuse",  # Newer versions of OpenSuSE report as opensuse-leap
+}
+
+#: Translation table for normalizing the "Distributor ID" attribute returned by
+#: the lsb_release command, for use by the :func:`distro.id` method.
+#:
+#: * Key: Value as returned by the lsb_release command, translated to lower
+#:   case, with blanks translated to underscores.
+#:
+#: * Value: Normalized value.
+NORMALIZED_LSB_ID = {
+    "enterpriseenterpriseas": "oracle",  # Oracle Enterprise Linux 4
+    "enterpriseenterpriseserver": "oracle",  # Oracle Linux 5
+    "redhatenterpriseworkstation": "rhel",  # RHEL 6, 7 Workstation
+    "redhatenterpriseserver": "rhel",  # RHEL 6, 7 Server
+    "redhatenterprisecomputenode": "rhel",  # RHEL 6 ComputeNode
+}
+
+#: Translation table for normalizing the distro ID derived from the file name
+#: of distro release files, for use by the :func:`distro.id` method.
+#:
+#: * Key: Value as derived from the file name of a distro release file,
+#:   translated to lower case, with blanks translated to underscores.
+#:
+#: * Value: Normalized value.
+NORMALIZED_DISTRO_ID = {
+    "redhat": "rhel",  # RHEL 6.x, 7.x
+}
+
+# Pattern for content of distro release file (reversed)
+_DISTRO_RELEASE_CONTENT_REVERSED_PATTERN = re.compile(
+    r"(?:[^)]*\)(.*)\()? *(?:STL )?([\d.+\-a-z]*\d) *(?:esaeler *)?(.+)"
+)
+
+# Pattern for base file name of distro release file
+_DISTRO_RELEASE_BASENAME_PATTERN = re.compile(r"(\w+)[-_](release|version)$")
+
+# Base file names to be looked up for if _UNIXCONFDIR is not readable.
+_DISTRO_RELEASE_BASENAMES = [
+    "SuSE-release",
+    "altlinux-release",
+    "arch-release",
+    "base-release",
+    "centos-release",
+    "fedora-release",
+    "gentoo-release",
+    "mageia-release",
+    "mandrake-release",
+    "mandriva-release",
+    "mandrivalinux-release",
+    "manjaro-release",
+    "oracle-release",
+    "redhat-release",
+    "rocky-release",
+    "sl-release",
+    "slackware-version",
+]
+
+# Base file names to be ignored when searching for distro release file
+_DISTRO_RELEASE_IGNORE_BASENAMES = (
+    "debian_version",
+    "lsb-release",
+    "oem-release",
+    _OS_RELEASE_BASENAME,
+    "system-release",
+    "plesk-release",
+    "iredmail-release",
+    "board-release",
+    "ec2_version",
+)
+
+
+def linux_distribution(full_distribution_name: bool = True) -> Tuple[str, str, str]:
+    """
+    .. deprecated:: 1.6.0
+
+        :func:`distro.linux_distribution()` is deprecated. It should only be
+        used as a compatibility shim with Python's
+        :py:func:`platform.linux_distribution()`. Please use :func:`distro.id`,
+        :func:`distro.version` and :func:`distro.name` instead.
+
+    Return information about the current OS distribution as a tuple
+    ``(id_name, version, codename)`` with items as follows:
+
+    * ``id_name``:  If *full_distribution_name* is false, the result of
+      :func:`distro.id`. Otherwise, the result of :func:`distro.name`.
+
+    * ``version``:  The result of :func:`distro.version`.
+
+    * ``codename``:  The extra item (usually in parentheses) after the
+      os-release version number, or the result of :func:`distro.codename`.
+
+    The interface of this function is compatible with the original
+    :py:func:`platform.linux_distribution` function, supporting a subset of
+    its parameters.
+
+    The data it returns may not exactly be the same, because it uses more data
+    sources than the original function, and that may lead to different data if
+    the OS distribution is not consistent across multiple data sources it
+    provides (there are indeed such distributions ...).
+
+    Another reason for differences is the fact that the :func:`distro.id`
+    method normalizes the distro ID string to a reliable machine-readable value
+    for a number of popular OS distributions.
+    """
+    warnings.warn(
+        "distro.linux_distribution() is deprecated. It should only be used as a "
+        "compatibility shim with Python's platform.linux_distribution(). Please use "
+        "distro.id(), distro.version() and distro.name() instead.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return _distro.linux_distribution(full_distribution_name)
+
+
+def id() -> str:
+    """
+    Return the distro ID of the current distribution, as a
+    machine-readable string.
+
+    For a number of OS distributions, the returned distro ID value is
+    *reliable*, in the sense that it is documented and that it does not change
+    across releases of the distribution.
+
+    This package maintains the following reliable distro ID values:
+
+    ==============  =========================================
+    Distro ID       Distribution
+    ==============  =========================================
+    "ubuntu"        Ubuntu
+    "debian"        Debian
+    "rhel"          RedHat Enterprise Linux
+    "centos"        CentOS
+    "fedora"        Fedora
+    "sles"          SUSE Linux Enterprise Server
+    "opensuse"      openSUSE
+    "amzn"          Amazon Linux
+    "arch"          Arch Linux
+    "buildroot"     Buildroot
+    "cloudlinux"    CloudLinux OS
+    "exherbo"       Exherbo Linux
+    "gentoo"        GenToo Linux
+    "ibm_powerkvm"  IBM PowerKVM
+    "kvmibm"        KVM for IBM z Systems
+    "linuxmint"     Linux Mint
+    "mageia"        Mageia
+    "mandriva"      Mandriva Linux
+    "parallels"     Parallels
+    "pidora"        Pidora
+    "raspbian"      Raspbian
+    "oracle"        Oracle Linux (and Oracle Enterprise Linux)
+    "scientific"    Scientific Linux
+    "slackware"     Slackware
+    "xenserver"     XenServer
+    "openbsd"       OpenBSD
+    "netbsd"        NetBSD
+    "freebsd"       FreeBSD
+    "midnightbsd"   MidnightBSD
+    "rocky"         Rocky Linux
+    "aix"           AIX
+    "guix"          Guix System
+    "altlinux"      ALT Linux
+    ==============  =========================================
+
+    If you have a need to get distros for reliable IDs added into this set,
+    or if you find that the :func:`distro.id` function returns a different
+    distro ID for one of the listed distros, please create an issue in the
+    `distro issue tracker`_.
+
+    **Lookup hierarchy and transformations:**
+
+    First, the ID is obtained from the following sources, in the specified
+    order. The first available and non-empty value is used:
+
+    * the value of the "ID" attribute of the os-release file,
+
+    * the value of the "Distributor ID" attribute returned by the lsb_release
+      command,
+
+    * the first part of the file name of the distro release file,
+
+    The so determined ID value then passes the following transformations,
+    before it is returned by this method:
+
+    * it is translated to lower case,
+
+    * blanks (which should not be there anyway) are translated to underscores,
+
+    * a normalization of the ID is performed, based upon
+      `normalization tables`_. The purpose of this normalization is to ensure
+      that the ID is as reliable as possible, even across incompatible changes
+      in the OS distributions. A common reason for an incompatible change is
+      the addition of an os-release file, or the addition of the lsb_release
+      command, with ID values that differ from what was previously determined
+      from the distro release file name.
+    """
+    return _distro.id()
+
+
+def name(pretty: bool = False) -> str:
+    """
+    Return the name of the current OS distribution, as a human-readable
+    string.
+
+    If *pretty* is false, the name is returned without version or codename.
+    (e.g. "CentOS Linux")
+
+    If *pretty* is true, the version and codename are appended.
+    (e.g. "CentOS Linux 7.1.1503 (Core)")
+
+    **Lookup hierarchy:**
+
+    The name is obtained from the following sources, in the specified order.
+    The first available and non-empty value is used:
+
+    * If *pretty* is false:
+
+      - the value of the "NAME" attribute of the os-release file,
+
+      - the value of the "Distributor ID" attribute returned by the lsb_release
+        command,
+
+      - the value of the "<name>" field of the distro release file.
+
+    * If *pretty* is true:
+
+      - the value of the "PRETTY_NAME" attribute of the os-release file,
+
+      - the value of the "Description" attribute returned by the lsb_release
+        command,
+
+      - the value of the "<name>" field of the distro release file, appended
+        with the value of the pretty version ("<version_id>" and "<codename>"
+        fields) of the distro release file, if available.
+    """
+    return _distro.name(pretty)
+
+
+def version(pretty: bool = False, best: bool = False) -> str:
+    """
+    Return the version of the current OS distribution, as a human-readable
+    string.
+
+    If *pretty* is false, the version is returned without codename (e.g.
+    "7.0").
+
+    If *pretty* is true, the codename in parenthesis is appended, if the
+    codename is non-empty (e.g. "7.0 (Maipo)").
+
+    Some distributions provide version numbers with different precisions in
+    the different sources of distribution information. Examining the different
+    sources in a fixed priority order does not always yield the most precise
+    version (e.g. for Debian 8.2, or CentOS 7.1).
+
+    Some other distributions may not provide this kind of information. In these
+    cases, an empty string would be returned. This behavior can be observed
+    with rolling releases distributions (e.g. Arch Linux).
+
+    The *best* parameter can be used to control the approach for the returned
+    version:
+
+    If *best* is false, the first non-empty version number in priority order of
+    the examined sources is returned.
+
+    If *best* is true, the most precise version number out of all examined
+    sources is returned.
+
+    **Lookup hierarchy:**
+
+    In all cases, the version number is obtained from the following sources.
+    If *best* is false, this order represents the priority order:
+
+    * the value of the "VERSION_ID" attribute of the os-release file,
+    * the value of the "Release" attribute returned by the lsb_release
+      command,
+    * the version number parsed from the "<version_id>" field of the first line
+      of the distro release file,
+    * the version number parsed from the "PRETTY_NAME" attribute of the
+      os-release file, if it follows the format of the distro release files.
+    * the version number parsed from the "Description" attribute returned by
+      the lsb_release command, if it follows the format of the distro release
+      files.
+    """
+    return _distro.version(pretty, best)
+
+
+def version_parts(best: bool = False) -> Tuple[str, str, str]:
+    """
+    Return the version of the current OS distribution as a tuple
+    ``(major, minor, build_number)`` with items as follows:
+
+    * ``major``:  The result of :func:`distro.major_version`.
+
+    * ``minor``:  The result of :func:`distro.minor_version`.
+
+    * ``build_number``:  The result of :func:`distro.build_number`.
+
+    For a description of the *best* parameter, see the :func:`distro.version`
+    method.
+    """
+    return _distro.version_parts(best)
+
+
+def major_version(best: bool = False) -> str:
+    """
+    Return the major version of the current OS distribution, as a string,
+    if provided.
+    Otherwise, the empty string is returned. The major version is the first
+    part of the dot-separated version string.
+
+    For a description of the *best* parameter, see the :func:`distro.version`
+    method.
+    """
+    return _distro.major_version(best)
+
+
+def minor_version(best: bool = False) -> str:
+    """
+    Return the minor version of the current OS distribution, as a string,
+    if provided.
+    Otherwise, the empty string is returned. The minor version is the second
+    part of the dot-separated version string.
+
+    For a description of the *best* parameter, see the :func:`distro.version`
+    method.
+    """
+    return _distro.minor_version(best)
+
+
+def build_number(best: bool = False) -> str:
+    """
+    Return the build number of the current OS distribution, as a string,
+    if provided.
+    Otherwise, the empty string is returned. The build number is the third part
+    of the dot-separated version string.
+
+    For a description of the *best* parameter, see the :func:`distro.version`
+    method.
+    """
+    return _distro.build_number(best)
+
+
+def like() -> str:
+    """
+    Return a space-separated list of distro IDs of distributions that are
+    closely related to the current OS distribution in regards to packaging
+    and programming interfaces, for example distributions the current
+    distribution is a derivative from.
+
+    **Lookup hierarchy:**
+
+    This information item is only provided by the os-release file.
+    For details, see the description of the "ID_LIKE" attribute in the
+    `os-release man page
+    <http://www.freedesktop.org/software/systemd/man/os-release.html>`_.
+    """
+    return _distro.like()
+
+
+def codename() -> str:
+    """
+    Return the codename for the release of the current OS distribution,
+    as a string.
+
+    If the distribution does not have a codename, an empty string is returned.
+
+    Note that the returned codename is not always really a codename. For
+    example, openSUSE returns "x86_64". This function does not handle such
+    cases in any special way and just returns the string it finds, if any.
+
+    **Lookup hierarchy:**
+
+    * the codename within the "VERSION" attribute of the os-release file, if
+      provided,
+
+    * the value of the "Codename" attribute returned by the lsb_release
+      command,
+
+    * the value of the "<codename>" field of the distro release file.
+    """
+    return _distro.codename()
+
+
+def info(pretty: bool = False, best: bool = False) -> InfoDict:
+    """
+    Return certain machine-readable information items about the current OS
+    distribution in a dictionary, as shown in the following example:
+
+    .. sourcecode:: python
+
+        {
+            'id': 'rhel',
+            'version': '7.0',
+            'version_parts': {
+                'major': '7',
+                'minor': '0',
+                'build_number': ''
+            },
+            'like': 'fedora',
+            'codename': 'Maipo'
+        }
+
+    The dictionary structure and keys are always the same, regardless of which
+    information items are available in the underlying data sources. The values
+    for the various keys are as follows:
+
+    * ``id``:  The result of :func:`distro.id`.
+
+    * ``version``:  The result of :func:`distro.version`.
+
+    * ``version_parts -> major``:  The result of :func:`distro.major_version`.
+
+    * ``version_parts -> minor``:  The result of :func:`distro.minor_version`.
+
+    * ``version_parts -> build_number``:  The result of
+      :func:`distro.build_number`.
+
+    * ``like``:  The result of :func:`distro.like`.
+
+    * ``codename``:  The result of :func:`distro.codename`.
+
+    For a description of the *pretty* and *best* parameters, see the
+    :func:`distro.version` method.
+    """
+    return _distro.info(pretty, best)
+
+
+def os_release_info() -> Dict[str, str]:
+    """
+    Return a dictionary containing key-value pairs for the information items
+    from the os-release file data source of the current OS distribution.
+
+    See `os-release file`_ for details about these information items.
+    """
+    return _distro.os_release_info()
+
+
+def lsb_release_info() -> Dict[str, str]:
+    """
+    Return a dictionary containing key-value pairs for the information items
+    from the lsb_release command data source of the current OS distribution.
+
+    See `lsb_release command output`_ for details about these information
+    items.
+    """
+    return _distro.lsb_release_info()
+
+
+def distro_release_info() -> Dict[str, str]:
+    """
+    Return a dictionary containing key-value pairs for the information items
+    from the distro release file data source of the current OS distribution.
+
+    See `distro release file`_ for details about these information items.
+    """
+    return _distro.distro_release_info()
+
+
+def uname_info() -> Dict[str, str]:
+    """
+    Return a dictionary containing key-value pairs for the information items
+    from the distro release file data source of the current OS distribution.
+    """
+    return _distro.uname_info()
+
+
+def os_release_attr(attribute: str) -> str:
+    """
+    Return a single named information item from the os-release file data source
+    of the current OS distribution.
+
+    Parameters:
+
+    * ``attribute`` (string): Key of the information item.
+
+    Returns:
+
+    * (string): Value of the information item, if the item exists.
+      The empty string, if the item does not exist.
+
+    See `os-release file`_ for details about these information items.
+    """
+    return _distro.os_release_attr(attribute)
+
+
+def lsb_release_attr(attribute: str) -> str:
+    """
+    Return a single named information item from the lsb_release command output
+    data source of the current OS distribution.
+
+    Parameters:
+
+    * ``attribute`` (string): Key of the information item.
+
+    Returns:
+
+    * (string): Value of the information item, if the item exists.
+      The empty string, if the item does not exist.
+
+    See `lsb_release command output`_ for details about these information
+    items.
+    """
+    return _distro.lsb_release_attr(attribute)
+
+
+def distro_release_attr(attribute: str) -> str:
+    """
+    Return a single named information item from the distro release file
+    data source of the current OS distribution.
+
+    Parameters:
+
+    * ``attribute`` (string): Key of the information item.
+
+    Returns:
+
+    * (string): Value of the information item, if the item exists.
+      The empty string, if the item does not exist.
+
+    See `distro release file`_ for details about these information items.
+    """
+    return _distro.distro_release_attr(attribute)
+
+
+def uname_attr(attribute: str) -> str:
+    """
+    Return a single named information item from the distro release file
+    data source of the current OS distribution.
+
+    Parameters:
+
+    * ``attribute`` (string): Key of the information item.
+
+    Returns:
+
+    * (string): Value of the information item, if the item exists.
+                The empty string, if the item does not exist.
+    """
+    return _distro.uname_attr(attribute)
+
+
+try:
+    from functools import cached_property
+except ImportError:
+    # Python < 3.8
+    class cached_property:  # type: ignore
+        """A version of @property which caches the value.  On access, it calls the
+        underlying function and sets the value in `__dict__` so future accesses
+        will not re-call the property.
+        """
+
+        def __init__(self, f: Callable[[Any], Any]) -> None:
+            self._fname = f.__name__
+            self._f = f
+
+        def __get__(self, obj: Any, owner: Type[Any]) -> Any:
+            assert obj is not None, f"call {self._fname} on an instance"
+            ret = obj.__dict__[self._fname] = self._f(obj)
+            return ret
+
+
+class LinuxDistribution:
+    """
+    Provides information about a OS distribution.
+
+    This package creates a private module-global instance of this class with
+    default initialization arguments, that is used by the
+    `consolidated accessor functions`_ and `single source accessor functions`_.
+    By using default initialization arguments, that module-global instance
+    returns data about the current OS distribution (i.e. the distro this
+    package runs on).
+
+    Normally, it is not necessary to create additional instances of this class.
+    However, in situations where control is needed over the exact data sources
+    that are used, instances of this class can be created with a specific
+    distro release file, or a specific os-release file, or without invoking the
+    lsb_release command.
+    """
+
+    def __init__(
+        self,
+        include_lsb: Optional[bool] = None,
+        os_release_file: str = "",
+        distro_release_file: str = "",
+        include_uname: Optional[bool] = None,
+        root_dir: Optional[str] = None,
+        include_oslevel: Optional[bool] = None,
+    ) -> None:
+        """
+        The initialization method of this class gathers information from the
+        available data sources, and stores that in private instance attributes.
+        Subsequent access to the information items uses these private instance
+        attributes, so that the data sources are read only once.
+
+        Parameters:
+
+        * ``include_lsb`` (bool): Controls whether the
+          `lsb_release command output`_ is included as a data source.
+
+          If the lsb_release command is not available in the program execution
+          path, the data source for the lsb_release command will be empty.
+
+        * ``os_release_file`` (string): The path name of the
+          `os-release file`_ that is to be used as a data source.
+
+          An empty string (the default) will cause the default path name to
+          be used (see `os-release file`_ for details).
+
+          If the specified or defaulted os-release file does not exist, the
+          data source for the os-release file will be empty.
+
+        * ``distro_release_file`` (string): The path name of the
+          `distro release file`_ that is to be used as a data source.
+
+          An empty string (the default) will cause a default search algorithm
+          to be used (see `distro release file`_ for details).
+
+          If the specified distro release file does not exist, or if no default
+          distro release file can be found, the data source for the distro
+          release file will be empty.
+
+        * ``include_uname`` (bool): Controls whether uname command output is
+          included as a data source. If the uname command is not available in
+          the program execution path the data source for the uname command will
+          be empty.
+
+        * ``root_dir`` (string): The absolute path to the root directory to use
+          to find distro-related information files. Note that ``include_*``
+          parameters must not be enabled in combination with ``root_dir``.
+
+        * ``include_oslevel`` (bool): Controls whether (AIX) oslevel command
+          output is included as a data source. If the oslevel command is not
+          available in the program execution path the data source will be
+          empty.
+
+        Public instance attributes:
+
+        * ``os_release_file`` (string): The path name of the
+          `os-release file`_ that is actually used as a data source. The
+          empty string if no distro release file is used as a data source.
+
+        * ``distro_release_file`` (string): The path name of the
+          `distro release file`_ that is actually used as a data source. The
+          empty string if no distro release file is used as a data source.
+
+        * ``include_lsb`` (bool): The result of the ``include_lsb`` parameter.
+          This controls whether the lsb information will be loaded.
+
+        * ``include_uname`` (bool): The result of the ``include_uname``
+          parameter. This controls whether the uname information will
+          be loaded.
+
+        * ``include_oslevel`` (bool): The result of the ``include_oslevel``
+          parameter. This controls whether (AIX) oslevel information will be
+          loaded.
+
+        * ``root_dir`` (string): The result of the ``root_dir`` parameter.
+          The absolute path to the root directory to use to find distro-related
+          information files.
+
+        Raises:
+
+        * :py:exc:`ValueError`: Initialization parameters combination is not
+           supported.
+
+        * :py:exc:`OSError`: Some I/O issue with an os-release file or distro
+          release file.
+
+        * :py:exc:`UnicodeError`: A data source has unexpected characters or
+          uses an unexpected encoding.
+        """
+        self.root_dir = root_dir
+        self.etc_dir = os.path.join(root_dir, "etc") if root_dir else _UNIXCONFDIR
+        self.usr_lib_dir = (
+            os.path.join(root_dir, "usr/lib") if root_dir else _UNIXUSRLIBDIR
+        )
+
+        if os_release_file:
+            self.os_release_file = os_release_file
+        else:
+            etc_dir_os_release_file = os.path.join(self.etc_dir, _OS_RELEASE_BASENAME)
+            usr_lib_os_release_file = os.path.join(
+                self.usr_lib_dir, _OS_RELEASE_BASENAME
+            )
+
+            # NOTE: The idea is to respect order **and** have it set
+            #       at all times for API backwards compatibility.
+            if os.path.isfile(etc_dir_os_release_file) or not os.path.isfile(
+                usr_lib_os_release_file
+            ):
+                self.os_release_file = etc_dir_os_release_file
+            else:
+                self.os_release_file = usr_lib_os_release_file
+
+        self.distro_release_file = distro_release_file or ""  # updated later
+
+        is_root_dir_defined = root_dir is not None
+        if is_root_dir_defined and (include_lsb or include_uname or include_oslevel):
+            raise ValueError(
+                "Including subprocess data sources from specific root_dir is disallowed"
+                " to prevent false information"
+            )
+        self.include_lsb = (
+            include_lsb if include_lsb is not None else not is_root_dir_defined
+        )
+        self.include_uname = (
+            include_uname if include_uname is not None else not is_root_dir_defined
+        )
+        self.include_oslevel = (
+            include_oslevel if include_oslevel is not None else not is_root_dir_defined
+        )
+
+    def __repr__(self) -> str:
+        """Return repr of all info"""
+        return (
+            "LinuxDistribution("
+            "os_release_file={self.os_release_file!r}, "
+            "distro_release_file={self.distro_release_file!r}, "
+            "include_lsb={self.include_lsb!r}, "
+            "include_uname={self.include_uname!r}, "
+            "include_oslevel={self.include_oslevel!r}, "
+            "root_dir={self.root_dir!r}, "
+            "_os_release_info={self._os_release_info!r}, "
+            "_lsb_release_info={self._lsb_release_info!r}, "
+            "_distro_release_info={self._distro_release_info!r}, "
+            "_uname_info={self._uname_info!r}, "
+            "_oslevel_info={self._oslevel_info!r})".format(self=self)
+        )
+
+    def linux_distribution(
+        self, full_distribution_name: bool = True
+    ) -> Tuple[str, str, str]:
+        """
+        Return information about the OS distribution that is compatible
+        with Python's :func:`platform.linux_distribution`, supporting a subset
+        of its parameters.
+
+        For details, see :func:`distro.linux_distribution`.
+        """
+        return (
+            self.name() if full_distribution_name else self.id(),
+            self.version(),
+            self._os_release_info.get("release_codename") or self.codename(),
+        )
+
+    def id(self) -> str:
+        """Return the distro ID of the OS distribution, as a string.
+
+        For details, see :func:`distro.id`.
+        """
+
+        def normalize(distro_id: str, table: Dict[str, str]) -> str:
+            distro_id = distro_id.lower().replace(" ", "_")
+            return table.get(distro_id, distro_id)
+
+        distro_id = self.os_release_attr("id")
+        if distro_id:
+            return normalize(distro_id, NORMALIZED_OS_ID)
+
+        distro_id = self.lsb_release_attr("distributor_id")
+        if distro_id:
+            return normalize(distro_id, NORMALIZED_LSB_ID)
+
+        distro_id = self.distro_release_attr("id")
+        if distro_id:
+            return normalize(distro_id, NORMALIZED_DISTRO_ID)
+
+        distro_id = self.uname_attr("id")
+        if distro_id:
+            return normalize(distro_id, NORMALIZED_DISTRO_ID)
+
+        return ""
+
+    def name(self, pretty: bool = False) -> str:
+        """
+        Return the name of the OS distribution, as a string.
+
+        For details, see :func:`distro.name`.
+        """
+        name = (
+            self.os_release_attr("name")
+            or self.lsb_release_attr("distributor_id")
+            or self.distro_release_attr("name")
+            or self.uname_attr("name")
+        )
+        if pretty:
+            name = self.os_release_attr("pretty_name") or self.lsb_release_attr(
+                "description"
+            )
+            if not name:
+                name = self.distro_release_attr("name") or self.uname_attr("name")
+                version = self.version(pretty=True)
+                if version:
+                    name = f"{name} {version}"
+        return name or ""
+
+    def version(self, pretty: bool = False, best: bool = False) -> str:
+        """
+        Return the version of the OS distribution, as a string.
+
+        For details, see :func:`distro.version`.
+        """
+        versions = [
+            self.os_release_attr("version_id"),
+            self.lsb_release_attr("release"),
+            self.distro_release_attr("version_id"),
+            self._parse_distro_release_content(self.os_release_attr("pretty_name")).get(
+                "version_id", ""
+            ),
+            self._parse_distro_release_content(
+                self.lsb_release_attr("description")
+            ).get("version_id", ""),
+            self.uname_attr("release"),
+        ]
+        if self.uname_attr("id").startswith("aix"):
+            # On AIX platforms, prefer oslevel command output.
+            versions.insert(0, self.oslevel_info())
+        elif self.id() == "debian" or "debian" in self.like().split():
+            # On Debian-like, add debian_version file content to candidates list.
+            versions.append(self._debian_version)
+        version = ""
+        if best:
+            # This algorithm uses the last version in priority order that has
+            # the best precision. If the versions are not in conflict, that
+            # does not matter; otherwise, using the last one instead of the
+            # first one might be considered a surprise.
+            for v in versions:
+                if v.count(".") > version.count(".") or version == "":
+                    version = v
+        else:
+            for v in versions:
+                if v != "":
+                    version = v
+                    break
+        if pretty and version and self.codename():
+            version = f"{version} ({self.codename()})"
+        return version
+
+    def version_parts(self, best: bool = False) -> Tuple[str, str, str]:
+        """
+        Return the version of the OS distribution, as a tuple of version
+        numbers.
+
+        For details, see :func:`distro.version_parts`.
+        """
+        version_str = self.version(best=best)
+        if version_str:
+            version_regex = re.compile(r"(\d+)\.?(\d+)?\.?(\d+)?")
+            matches = version_regex.match(version_str)
+            if matches:
+                major, minor, build_number = matches.groups()
+                return major, minor or "", build_number or ""
+        return "", "", ""
+
+    def major_version(self, best: bool = False) -> str:
+        """
+        Return the major version number of the current distribution.
+
+        For details, see :func:`distro.major_version`.
+        """
+        return self.version_parts(best)[0]
+
+    def minor_version(self, best: bool = False) -> str:
+        """
+        Return the minor version number of the current distribution.
+
+        For details, see :func:`distro.minor_version`.
+        """
+        return self.version_parts(best)[1]
+
+    def build_number(self, best: bool = False) -> str:
+        """
+        Return the build number of the current distribution.
+
+        For details, see :func:`distro.build_number`.
+        """
+        return self.version_parts(best)[2]
+
+    def like(self) -> str:
+        """
+        Return the IDs of distributions that are like the OS distribution.
+
+        For details, see :func:`distro.like`.
+        """
+        return self.os_release_attr("id_like") or ""
+
+    def codename(self) -> str:
+        """
+        Return the codename of the OS distribution.
+
+        For details, see :func:`distro.codename`.
+        """
+        try:
+            # Handle os_release specially since distros might purposefully set
+            # this to empty string to have no codename
+            return self._os_release_info["codename"]
+        except KeyError:
+            return (
+                self.lsb_release_attr("codename")
+                or self.distro_release_attr("codename")
+                or ""
+            )
+
+    def info(self, pretty: bool = False, best: bool = False) -> InfoDict:
+        """
+        Return certain machine-readable information about the OS
+        distribution.
+
+        For details, see :func:`distro.info`.
+        """
+        return InfoDict(
+            id=self.id(),
+            version=self.version(pretty, best),
+            version_parts=VersionDict(
+                major=self.major_version(best),
+                minor=self.minor_version(best),
+                build_number=self.build_number(best),
+            ),
+            like=self.like(),
+            codename=self.codename(),
+        )
+
+    def os_release_info(self) -> Dict[str, str]:
+        """
+        Return a dictionary containing key-value pairs for the information
+        items from the os-release file data source of the OS distribution.
+
+        For details, see :func:`distro.os_release_info`.
+        """
+        return self._os_release_info
+
+    def lsb_release_info(self) -> Dict[str, str]:
+        """
+        Return a dictionary containing key-value pairs for the information
+        items from the lsb_release command data source of the OS
+        distribution.
+
+        For details, see :func:`distro.lsb_release_info`.
+        """
+        return self._lsb_release_info
+
+    def distro_release_info(self) -> Dict[str, str]:
+        """
+        Return a dictionary containing key-value pairs for the information
+        items from the distro release file data source of the OS
+        distribution.
+
+        For details, see :func:`distro.distro_release_info`.
+        """
+        return self._distro_release_info
+
+    def uname_info(self) -> Dict[str, str]:
+        """
+        Return a dictionary containing key-value pairs for the information
+        items from the uname command data source of the OS distribution.
+
+        For details, see :func:`distro.uname_info`.
+        """
+        return self._uname_info
+
+    def oslevel_info(self) -> str:
+        """
+        Return AIX' oslevel command output.
+        """
+        return self._oslevel_info
+
+    def os_release_attr(self, attribute: str) -> str:
+        """
+        Return a single named information item from the os-release file data
+        source of the OS distribution.
+
+        For details, see :func:`distro.os_release_attr`.
+        """
+        return self._os_release_info.get(attribute, "")
+
+    def lsb_release_attr(self, attribute: str) -> str:
+        """
+        Return a single named information item from the lsb_release command
+        output data source of the OS distribution.
+
+        For details, see :func:`distro.lsb_release_attr`.
+        """
+        return self._lsb_release_info.get(attribute, "")
+
+    def distro_release_attr(self, attribute: str) -> str:
+        """
+        Return a single named information item from the distro release file
+        data source of the OS distribution.
+
+        For details, see :func:`distro.distro_release_attr`.
+        """
+        return self._distro_release_info.get(attribute, "")
+
+    def uname_attr(self, attribute: str) -> str:
+        """
+        Return a single named information item from the uname command
+        output data source of the OS distribution.
+
+        For details, see :func:`distro.uname_attr`.
+        """
+        return self._uname_info.get(attribute, "")
+
+    @cached_property
+    def _os_release_info(self) -> Dict[str, str]:
+        """
+        Get the information items from the specified os-release file.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        if os.path.isfile(self.os_release_file):
+            with open(self.os_release_file, encoding="utf-8") as release_file:
+                return self._parse_os_release_content(release_file)
+        return {}
+
+    @staticmethod
+    def _parse_os_release_content(lines: TextIO) -> Dict[str, str]:
+        """
+        Parse the lines of an os-release file.
+
+        Parameters:
+
+        * lines: Iterable through the lines in the os-release file.
+                 Each line must be a unicode string or a UTF-8 encoded byte
+                 string.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        props = {}
+        lexer = shlex.shlex(lines, posix=True)
+        lexer.whitespace_split = True
+
+        tokens = list(lexer)
+        for token in tokens:
+            # At this point, all shell-like parsing has been done (i.e.
+            # comments processed, quotes and backslash escape sequences
+            # processed, multi-line values assembled, trailing newlines
+            # stripped, etc.), so the tokens are now either:
+            # * variable assignments: var=value
+            # * commands or their arguments (not allowed in os-release)
+            # Ignore any tokens that are not variable assignments
+            if "=" in token:
+                k, v = token.split("=", 1)
+                props[k.lower()] = v
+
+        if "version" in props:
+            # extract release codename (if any) from version attribute
+            match = re.search(r"\((\D+)\)|,\s*(\D+)", props["version"])
+            if match:
+                release_codename = match.group(1) or match.group(2)
+                props["codename"] = props["release_codename"] = release_codename
+
+        if "version_codename" in props:
+            # os-release added a version_codename field.  Use that in
+            # preference to anything else Note that some distros purposefully
+            # do not have code names.  They should be setting
+            # version_codename=""
+            props["codename"] = props["version_codename"]
+        elif "ubuntu_codename" in props:
+            # Same as above but a non-standard field name used on older Ubuntus
+            props["codename"] = props["ubuntu_codename"]
+
+        return props
+
+    @cached_property
+    def _lsb_release_info(self) -> Dict[str, str]:
+        """
+        Get the information items from the lsb_release command output.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        if not self.include_lsb:
+            return {}
+        try:
+            cmd = ("lsb_release", "-a")
+            stdout = subprocess.check_output(cmd, stderr=subprocess.DEVNULL)
+        # Command not found or lsb_release returned error
+        except (OSError, subprocess.CalledProcessError):
+            return {}
+        content = self._to_str(stdout).splitlines()
+        return self._parse_lsb_release_content(content)
+
+    @staticmethod
+    def _parse_lsb_release_content(lines: Iterable[str]) -> Dict[str, str]:
+        """
+        Parse the output of the lsb_release command.
+
+        Parameters:
+
+        * lines: Iterable through the lines of the lsb_release output.
+                 Each line must be a unicode string or a UTF-8 encoded byte
+                 string.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        props = {}
+        for line in lines:
+            kv = line.strip("\n").split(":", 1)
+            if len(kv) != 2:
+                # Ignore lines without colon.
+                continue
+            k, v = kv
+            props.update({k.replace(" ", "_").lower(): v.strip()})
+        return props
+
+    @cached_property
+    def _uname_info(self) -> Dict[str, str]:
+        if not self.include_uname:
+            return {}
+        try:
+            cmd = ("uname", "-rs")
+            stdout = subprocess.check_output(cmd, stderr=subprocess.DEVNULL)
+        except OSError:
+            return {}
+        content = self._to_str(stdout).splitlines()
+        return self._parse_uname_content(content)
+
+    @cached_property
+    def _oslevel_info(self) -> str:
+        if not self.include_oslevel:
+            return ""
+        try:
+            stdout = subprocess.check_output("oslevel", stderr=subprocess.DEVNULL)
+        except (OSError, subprocess.CalledProcessError):
+            return ""
+        return self._to_str(stdout).strip()
+
+    @cached_property
+    def _debian_version(self) -> str:
+        try:
+            with open(
+                os.path.join(self.etc_dir, "debian_version"), encoding="ascii"
+            ) as fp:
+                return fp.readline().rstrip()
+        except FileNotFoundError:
+            return ""
+
+    @staticmethod
+    def _parse_uname_content(lines: Sequence[str]) -> Dict[str, str]:
+        if not lines:
+            return {}
+        props = {}
+        match = re.search(r"^([^\s]+)\s+([\d\.]+)", lines[0].strip())
+        if match:
+            name, version = match.groups()
+
+            # This is to prevent the Linux kernel version from
+            # appearing as the 'best' version on otherwise
+            # identifiable distributions.
+            if name == "Linux":
+                return {}
+            props["id"] = name.lower()
+            props["name"] = name
+            props["release"] = version
+        return props
+
+    @staticmethod
+    def _to_str(bytestring: bytes) -> str:
+        encoding = sys.getfilesystemencoding()
+        return bytestring.decode(encoding)
+
+    @cached_property
+    def _distro_release_info(self) -> Dict[str, str]:
+        """
+        Get the information items from the specified distro release file.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        if self.distro_release_file:
+            # If it was specified, we use it and parse what we can, even if
+            # its file name or content does not match the expected pattern.
+            distro_info = self._parse_distro_release_file(self.distro_release_file)
+            basename = os.path.basename(self.distro_release_file)
+            # The file name pattern for user-specified distro release files
+            # is somewhat more tolerant (compared to when searching for the
+            # file), because we want to use what was specified as best as
+            # possible.
+            match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
+        else:
+            try:
+                basenames = [
+                    basename
+                    for basename in os.listdir(self.etc_dir)
+                    if basename not in _DISTRO_RELEASE_IGNORE_BASENAMES
+                    and os.path.isfile(os.path.join(self.etc_dir, basename))
+                ]
+                # We sort for repeatability in cases where there are multiple
+                # distro specific files; e.g. CentOS, Oracle, Enterprise all
+                # containing `redhat-release` on top of their own.
+                basenames.sort()
+            except OSError:
+                # This may occur when /etc is not readable but we can't be
+                # sure about the *-release files. Check common entries of
+                # /etc for information. If they turn out to not be there the
+                # error is handled in `_parse_distro_release_file()`.
+                basenames = _DISTRO_RELEASE_BASENAMES
+            for basename in basenames:
+                match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
+                if match is None:
+                    continue
+                filepath = os.path.join(self.etc_dir, basename)
+                distro_info = self._parse_distro_release_file(filepath)
+                # The name is always present if the pattern matches.
+                if "name" not in distro_info:
+                    continue
+                self.distro_release_file = filepath
+                break
+            else:  # the loop didn't "break": no candidate.
+                return {}
+
+        if match is not None:
+            distro_info["id"] = match.group(1)
+
+        # CloudLinux < 7: manually enrich info with proper id.
+        if "cloudlinux" in distro_info.get("name", "").lower():
+            distro_info["id"] = "cloudlinux"
+
+        return distro_info
+
+    def _parse_distro_release_file(self, filepath: str) -> Dict[str, str]:
+        """
+        Parse a distro release file.
+
+        Parameters:
+
+        * filepath: Path name of the distro release file.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        try:
+            with open(filepath, encoding="utf-8") as fp:
+                # Only parse the first line. For instance, on SLES there
+                # are multiple lines. We don't want them...
+                return self._parse_distro_release_content(fp.readline())
+        except OSError:
+            # Ignore not being able to read a specific, seemingly version
+            # related file.
+            # See https://github.com/python-distro/distro/issues/162
+            return {}
+
+    @staticmethod
+    def _parse_distro_release_content(line: str) -> Dict[str, str]:
+        """
+        Parse a line from a distro release file.
+
+        Parameters:
+        * line: Line from the distro release file. Must be a unicode string
+                or a UTF-8 encoded byte string.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        matches = _DISTRO_RELEASE_CONTENT_REVERSED_PATTERN.match(line.strip()[::-1])
+        distro_info = {}
+        if matches:
+            # regexp ensures non-None
+            distro_info["name"] = matches.group(3)[::-1]
+            if matches.group(2):
+                distro_info["version_id"] = matches.group(2)[::-1]
+            if matches.group(1):
+                distro_info["codename"] = matches.group(1)[::-1]
+        elif line:
+            distro_info["name"] = line.strip()
+        return distro_info
+
+
+_distro = LinuxDistribution()
+
+
+def main() -> None:
+    logger = logging.getLogger(__name__)
+    logger.setLevel(logging.DEBUG)
+    logger.addHandler(logging.StreamHandler(sys.stdout))
+
+    parser = argparse.ArgumentParser(description="OS distro info tool")
+    parser.add_argument(
+        "--json", "-j", help="Output in machine readable format", action="store_true"
+    )
+
+    parser.add_argument(
+        "--root-dir",
+        "-r",
+        type=str,
+        dest="root_dir",
+        help="Path to the root filesystem directory (defaults to /)",
+    )
+
+    args = parser.parse_args()
+
+    if args.root_dir:
+        dist = LinuxDistribution(
+            include_lsb=False,
+            include_uname=False,
+            include_oslevel=False,
+            root_dir=args.root_dir,
+        )
+    else:
+        dist = _distro
+
+    if args.json:
+        logger.info(json.dumps(dist.info(), indent=4, sort_keys=True))
+    else:
+        logger.info("Name: %s", dist.name(pretty=True))
+        distribution_version = dist.version(pretty=True)
+        logger.info("Version: %s", distribution_version)
+        distribution_codename = dist.codename()
+        logger.info("Codename: %s", distribution_codename)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/distro/py.typed b/llm/Lib/site-packages/distro/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/distutils-precedence.pth b/llm/Lib/site-packages/distutils-precedence.pth
new file mode 100644
index 0000000000000000000000000000000000000000..c659194195f07bd6f19b5522515551309af14a3d
--- /dev/null
+++ b/llm/Lib/site-packages/distutils-precedence.pth
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2638ce9e2500e572a5e0de7faed6661eb569d1b696fcba07b0dd223da5f5d224
+size 151
diff --git a/llm/Lib/site-packages/faiss/__init__.py b/llm/Lib/site-packages/faiss/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c3ae634a83e52651159c681373c2627e0220cf6d
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/__init__.py
@@ -0,0 +1,331 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+
+# start delvewheel patch
+def _delvewheel_patch_1_5_2():
+    import os
+    libs_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), os.pardir, 'faiss_cpu.libs'))
+    if os.path.isdir(libs_dir):
+        os.add_dll_directory(libs_dir)
+
+
+_delvewheel_patch_1_5_2()
+del _delvewheel_patch_1_5_2
+# end delvewheel patch
+
+# @nolint
+
+# not linting this file because it imports * from swigfaiss, which
+# causes a ton of useless warnings.
+
+import numpy as np
+import sys
+import inspect
+
+# We import * so that the symbol foo can be accessed as faiss.foo.
+from .loader import *
+
+# additional wrappers
+from faiss import class_wrappers
+from faiss.gpu_wrappers import *
+from faiss.array_conversions import *
+from faiss.extra_wrappers import kmin, kmax, pairwise_distances, rand, randint, \
+    lrand, randn, rand_smooth_vectors, eval_intersection, normalize_L2, \
+    ResultHeap, knn, Kmeans, checksum, matrix_bucket_sort_inplace, bucket_sort, \
+    merge_knn_results, MapInt64ToInt64, knn_hamming, \
+    pack_bitstrings, unpack_bitstrings
+
+
+__version__ = "%d.%d.%d" % (FAISS_VERSION_MAJOR,
+                            FAISS_VERSION_MINOR,
+                            FAISS_VERSION_PATCH)
+
+class_wrappers.handle_Clustering(Clustering)
+class_wrappers.handle_Clustering1D(Clustering1D)
+class_wrappers.handle_MatrixStats(MatrixStats)
+class_wrappers.handle_IOWriter(IOWriter)
+class_wrappers.handle_IOReader(IOReader)
+class_wrappers.handle_AutoTuneCriterion(AutoTuneCriterion)
+class_wrappers.handle_ParameterSpace(ParameterSpace)
+class_wrappers.handle_NSG(IndexNSG)
+class_wrappers.handle_MapLong2Long(MapLong2Long)
+class_wrappers.handle_IDSelectorSubset(IDSelectorBatch, class_owns=True)
+class_wrappers.handle_IDSelectorSubset(IDSelectorArray, class_owns=False)
+class_wrappers.handle_IDSelectorSubset(IDSelectorBitmap, class_owns=False, force_int64=False)
+class_wrappers.handle_CodeSet(CodeSet)
+
+this_module = sys.modules[__name__]
+
+# handle sub-classes
+for symbol in dir(this_module):
+    obj = getattr(this_module, symbol)
+    # print symbol, isinstance(obj, (type, types.ClassType))
+    if inspect.isclass(obj):
+        the_class = obj
+        if issubclass(the_class, Index):
+            class_wrappers.handle_Index(the_class)
+
+        if issubclass(the_class, IndexBinary):
+            class_wrappers.handle_IndexBinary(the_class)
+
+        if issubclass(the_class, VectorTransform):
+            class_wrappers.handle_VectorTransform(the_class)
+
+        if issubclass(the_class, Quantizer):
+            class_wrappers.handle_Quantizer(the_class)
+
+        if issubclass(the_class, IndexRowwiseMinMax) or \
+                issubclass(the_class, IndexRowwiseMinMaxFP16):
+            class_wrappers.handle_IndexRowwiseMinMax(the_class)
+
+        if issubclass(the_class, SearchParameters):
+            class_wrappers.handle_SearchParameters(the_class)
+
+        if issubclass(the_class, CodePacker):
+            class_wrappers.handle_CodePacker(the_class)
+
+##############################################################################
+# For some classes (IndexIVF, IDSelector), the object holds a reference to
+# a C++ object (eg. the quantizer object of IndexIVF). We don't transfer the
+# ownership to the C++ object (ie. set own_quantizer=true), but instead we add
+# a reference in the Python class wrapper instead. This is done via an
+# additional referenced_objects field.
+#
+# Since the semantics of ownership in the C++ classes are sometimes irregular,
+# these references are added manually using the functions below.
+##############################################################################
+
+
+def add_ref_in_constructor(the_class, parameter_no):
+    # adds a reference to parameter parameter_no in self
+    # so that that parameter does not get deallocated before self
+    original_init = the_class.__init__
+
+    def replacement_init(self, *args):
+        original_init(self, *args)
+        self.referenced_objects = [args[parameter_no]]
+
+    def replacement_init_multiple(self, *args):
+        original_init(self, *args)
+        pset = parameter_no[len(args)]
+        self.referenced_objects = [args[no] for no in pset]
+
+    if type(parameter_no) == dict:
+        # a list of parameters to keep, depending on the number of arguments
+        the_class.__init__ = replacement_init_multiple
+    else:
+        the_class.__init__ = replacement_init
+
+def add_to_referenced_objects(self, ref):
+    if not hasattr(self, 'referenced_objects'):
+        self.referenced_objects = [ref]
+    else:
+        self.referenced_objects.append(ref)
+
+
+def add_ref_in_method(the_class, method_name, parameter_no):
+    original_method = getattr(the_class, method_name)
+
+    def replacement_method(self, *args):
+        ref = args[parameter_no]
+        add_to_referenced_objects(self, ref)
+        return original_method(self, *args)
+    setattr(the_class, method_name, replacement_method)
+
+
+def add_ref_in_method_explicit_own(the_class, method_name):
+    # for methods of format set_XXX(object, own)
+    original_method = getattr(the_class, method_name)
+
+    def replacement_method(self, ref, own=False):
+        if not own:
+            if not hasattr(self, 'referenced_objects'):
+                self.referenced_objects = [ref]
+            else:
+                self.referenced_objects.append(ref)
+        else:
+            # transfer ownership to C++ class
+            ref.this.disown()
+        return original_method(self, ref, own)
+    setattr(the_class, method_name, replacement_method)
+
+
+def add_ref_in_function(function_name, parameter_no):
+    # assumes the function returns an object
+    original_function = getattr(this_module, function_name)
+
+    def replacement_function(*args):
+        result = original_function(*args)
+        ref = args[parameter_no]
+        result.referenced_objects = [ref]
+        return result
+    setattr(this_module, function_name, replacement_function)
+
+
+add_ref_in_constructor(IndexIVFFlat, 0)
+add_ref_in_constructor(IndexIVFFlatDedup, 0)
+add_ref_in_constructor(IndexPreTransform, {2: [0, 1], 1: [0]})
+add_ref_in_method(IndexPreTransform, 'prepend_transform', 0)
+add_ref_in_constructor(IndexIVFPQ, 0)
+add_ref_in_constructor(IndexIVFPQR, 0)
+add_ref_in_constructor(IndexIVFPQFastScan, 0)
+add_ref_in_constructor(IndexIVFResidualQuantizer, 0)
+add_ref_in_constructor(IndexIVFLocalSearchQuantizer, 0)
+add_ref_in_constructor(IndexIVFResidualQuantizerFastScan, 0)
+add_ref_in_constructor(IndexIVFLocalSearchQuantizerFastScan, 0)
+add_ref_in_constructor(IndexIVFSpectralHash, 0)
+add_ref_in_method_explicit_own(IndexIVFSpectralHash, "replace_vt")
+
+add_ref_in_constructor(Index2Layer, 0)
+add_ref_in_constructor(Level1Quantizer, 0)
+add_ref_in_constructor(IndexIVFScalarQuantizer, 0)
+add_ref_in_constructor(IndexRowwiseMinMax, 0)
+add_ref_in_constructor(IndexRowwiseMinMaxFP16, 0)
+add_ref_in_constructor(IndexIDMap, 0)
+add_ref_in_constructor(IndexIDMap2, 0)
+add_ref_in_constructor(IndexHNSW, 0)
+add_ref_in_method(IndexShards, 'add_shard', 0)
+add_ref_in_method(IndexBinaryShards, 'add_shard', 0)
+add_ref_in_constructor(IndexRefineFlat, {2: [0], 1: [0]})
+add_ref_in_constructor(IndexRefine, {2: [0, 1]})
+
+add_ref_in_constructor(IndexBinaryIVF, 0)
+add_ref_in_constructor(IndexBinaryFromFloat, 0)
+add_ref_in_constructor(IndexBinaryIDMap, 0)
+add_ref_in_constructor(IndexBinaryIDMap2, 0)
+
+add_ref_in_method(IndexReplicas, 'addIndex', 0)
+add_ref_in_method(IndexBinaryReplicas, 'addIndex', 0)
+
+add_ref_in_constructor(BufferedIOWriter, 0)
+add_ref_in_constructor(BufferedIOReader, 0)
+
+add_ref_in_constructor(IDSelectorNot, 0)
+add_ref_in_constructor(IDSelectorAnd, slice(2))
+add_ref_in_constructor(IDSelectorOr, slice(2))
+add_ref_in_constructor(IDSelectorXOr, slice(2))
+add_ref_in_constructor(IDSelectorTranslated, slice(2))
+
+add_ref_in_constructor(IDSelectorXOr, slice(2))
+add_ref_in_constructor(IndexIVFIndependentQuantizer, slice(3))
+
+# seems really marginal...
+# remove_ref_from_method(IndexReplicas, 'removeIndex', 0)
+
+
+######################################################
+# search_with_parameters interface
+######################################################
+
+search_with_parameters_c = search_with_parameters
+
+
+def search_with_parameters(index, x, k, params=None, output_stats=False):
+    x = np.ascontiguousarray(x, dtype='float32')
+    n, d = x.shape
+    assert d == index.d
+    if not params:
+        # if not provided use the ones set in the IVF object
+        params = IVFSearchParameters()
+        index_ivf = extract_index_ivf(index)
+        params.nprobe = index_ivf.nprobe
+        params.max_codes = index_ivf.max_codes
+    nb_dis = np.empty(1, 'uint64')
+    ms_per_stage = np.empty(3, 'float64')
+    distances = np.empty((n, k), dtype=np.float32)
+    labels = np.empty((n, k), dtype=np.int64)
+    search_with_parameters_c(
+        index, n, swig_ptr(x),
+        k, swig_ptr(distances),
+        swig_ptr(labels),
+        params, swig_ptr(nb_dis), swig_ptr(ms_per_stage)
+    )
+    if not output_stats:
+        return distances, labels
+    else:
+        stats = {
+            'ndis': nb_dis[0],
+            'pre_transform_ms': ms_per_stage[0],
+            'coarse_quantizer_ms': ms_per_stage[1],
+            'invlist_scan_ms': ms_per_stage[2],
+        }
+        return distances, labels, stats
+
+
+range_search_with_parameters_c = range_search_with_parameters
+
+
+def range_search_with_parameters(index, x, radius, params=None, output_stats=False):
+    x = np.ascontiguousarray(x, dtype='float32')
+    n, d = x.shape
+    assert d == index.d
+    if not params:
+        # if not provided use the ones set in the IVF object
+        params = IVFSearchParameters()
+        index_ivf = extract_index_ivf(index)
+        params.nprobe = index_ivf.nprobe
+        params.max_codes = index_ivf.max_codes
+    nb_dis = np.empty(1, 'uint64')
+    ms_per_stage = np.empty(3, 'float64')
+    res = RangeSearchResult(n)
+    range_search_with_parameters_c(
+        index, n, swig_ptr(x),
+        radius, res,
+        params, swig_ptr(nb_dis), swig_ptr(ms_per_stage)
+    )
+    lims = rev_swig_ptr(res.lims, n + 1).copy()
+    nd = int(lims[-1])
+    Dout = rev_swig_ptr(res.distances, nd).copy()
+    Iout = rev_swig_ptr(res.labels, nd).copy()
+    if not output_stats:
+        return lims, Dout, Iout
+    else:
+        stats = {
+            'ndis': nb_dis[0],
+            'pre_transform_ms': ms_per_stage[0],
+            'coarse_quantizer_ms': ms_per_stage[1],
+            'invlist_scan_ms': ms_per_stage[2],
+        }
+        return lims, Dout, Iout, stats
+
+
+# IndexProxy was renamed to IndexReplicas, remap the old name for any old code
+# people may have
+IndexProxy = IndexReplicas
+ConcatenatedInvertedLists = HStackInvertedLists
+IndexResidual = IndexResidualQuantizer
+
+IVFSearchParameters = SearchParametersIVF
+
+###########################################
+# serialization of indexes to byte arrays
+###########################################
+
+
+def serialize_index(index):
+    """ convert an index to a numpy uint8 array  """
+    writer = VectorIOWriter()
+    write_index(index, writer)
+    return vector_to_array(writer.data)
+
+
+def deserialize_index(data, io_flags=0):
+    reader = VectorIOReader()
+    copy_array_to_vector(data, reader.data)
+    return read_index(reader, io_flags)
+
+
+def serialize_index_binary(index):
+    """ convert an index to a numpy uint8 array  """
+    writer = VectorIOWriter()
+    write_index_binary(index, writer)
+    return vector_to_array(writer.data)
+
+
+def deserialize_index_binary(data):
+    reader = VectorIOReader()
+    copy_array_to_vector(data, reader.data)
+    return read_index_binary(reader)
diff --git a/llm/Lib/site-packages/faiss/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/faiss/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..af1f378f03f4663fcfdfce0cb6ada675196cb981
Binary files /dev/null and b/llm/Lib/site-packages/faiss/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/__pycache__/array_conversions.cpython-311.pyc b/llm/Lib/site-packages/faiss/__pycache__/array_conversions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..38cd04495cdd0a9a087f6adf5142452db23251d5
Binary files /dev/null and b/llm/Lib/site-packages/faiss/__pycache__/array_conversions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/__pycache__/class_wrappers.cpython-311.pyc b/llm/Lib/site-packages/faiss/__pycache__/class_wrappers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2fb81a8bc5b3c4455c460de598adab8a1b0eedf6
Binary files /dev/null and b/llm/Lib/site-packages/faiss/__pycache__/class_wrappers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/__pycache__/extra_wrappers.cpython-311.pyc b/llm/Lib/site-packages/faiss/__pycache__/extra_wrappers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3aba9b816852a49c6a5ae6b8f29219e7954cd135
Binary files /dev/null and b/llm/Lib/site-packages/faiss/__pycache__/extra_wrappers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/__pycache__/gpu_wrappers.cpython-311.pyc b/llm/Lib/site-packages/faiss/__pycache__/gpu_wrappers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..436c3a52c7f0dcf02829ced5c3007ce95f73c7c9
Binary files /dev/null and b/llm/Lib/site-packages/faiss/__pycache__/gpu_wrappers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/__pycache__/loader.cpython-311.pyc b/llm/Lib/site-packages/faiss/__pycache__/loader.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..63498fc98e81e5869b10e8fec7a7592f14a08ffb
Binary files /dev/null and b/llm/Lib/site-packages/faiss/__pycache__/loader.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/__pycache__/setup.cpython-311.pyc b/llm/Lib/site-packages/faiss/__pycache__/setup.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bd076b0562347602b1a868d4cf3281b2e2528797
Binary files /dev/null and b/llm/Lib/site-packages/faiss/__pycache__/setup.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/__pycache__/swigfaiss.cpython-311.pyc b/llm/Lib/site-packages/faiss/__pycache__/swigfaiss.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..38b0eef077193c0e29e9d4611d6e4fa57ae5b85f
Binary files /dev/null and b/llm/Lib/site-packages/faiss/__pycache__/swigfaiss.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/__pycache__/swigfaiss_avx2.cpython-311.pyc b/llm/Lib/site-packages/faiss/__pycache__/swigfaiss_avx2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c31d220685f81536eed3e49d81a329cfddc9e119
Binary files /dev/null and b/llm/Lib/site-packages/faiss/__pycache__/swigfaiss_avx2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/_swigfaiss.cp311-win_amd64.pyd b/llm/Lib/site-packages/faiss/_swigfaiss.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..9cdc6f758cf8b21cff162653129d48a22c964cfd
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/_swigfaiss.cp311-win_amd64.pyd
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:170a535311ec6e7763d9d3de3e675608132d2d1b0ce1810cf1a5b2fb78394f47
+size 9971712
diff --git a/llm/Lib/site-packages/faiss/_swigfaiss_avx2.cp311-win_amd64.pyd b/llm/Lib/site-packages/faiss/_swigfaiss_avx2.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..027360e3f8a0187d94f0de9aa27b97f64c19caef
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/_swigfaiss_avx2.cp311-win_amd64.pyd
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4921e83c8fb3be7f7ec667160b2278297a4401dd07c756885fb5cd5db249eac3
+size 11123200
diff --git a/llm/Lib/site-packages/faiss/array_conversions.py b/llm/Lib/site-packages/faiss/array_conversions.py
new file mode 100644
index 0000000000000000000000000000000000000000..5c5855d9ddbb833fc20d696ca802d7b438d06d27
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/array_conversions.py
@@ -0,0 +1,165 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+# @nolint
+
+# not linting this file because it imports * from swigfaiss, which
+# causes a ton of useless warnings.
+
+import numpy as np
+import array
+import warnings
+
+from faiss.loader import *
+
+###########################################
+# Utility to add a deprecation warning to
+# classes from the SWIG interface
+###########################################
+
+def _make_deprecated_swig_class(deprecated_name, base_name):
+    """
+    Dynamically construct deprecated classes as wrappers around renamed ones
+
+    The deprecation warning added in their __new__-method will trigger upon
+    construction of an instance of the class, but only once per session.
+
+    We do this here (in __init__.py) because the base classes are defined in
+    the SWIG interface, making it cumbersome to add the deprecation there.
+
+    Parameters
+    ----------
+    deprecated_name : string
+        Name of the class to be deprecated; _not_ present in SWIG interface.
+    base_name : string
+        Name of the class that is replacing deprecated_name; must already be
+        imported into the current namespace.
+
+    Returns
+    -------
+    None
+        However, the deprecated class gets added to the faiss namespace
+    """
+    base_class = globals()[base_name]
+
+    def new_meth(cls, *args, **kwargs):
+        msg = f"The class faiss.{deprecated_name} is deprecated in favour of faiss.{base_name}!"
+        warnings.warn(msg, DeprecationWarning, stacklevel=2)
+        instance = super(base_class, cls).__new__(cls, *args, **kwargs)
+        return instance
+
+    # three-argument version of "type" uses (name, tuple-of-bases, dict-of-attributes)
+    klazz = type(deprecated_name, (base_class,), {"__new__": new_meth})
+
+    # this ends up adding the class to the "faiss" namespace, in a way that it
+    # is available both through "import faiss" and "from faiss import *"
+    globals()[deprecated_name] = klazz
+
+
+###########################################
+# numpy array / std::vector conversions
+###########################################
+
+sizeof_long = array.array('l').itemsize
+deprecated_name_map = {
+    # deprecated: replacement
+    'Float': 'Float32',
+    'Double': 'Float64',
+    'Char': 'Int8',
+    'Int': 'Int32',
+    'Long': 'Int32' if sizeof_long == 4 else 'Int64',
+    'LongLong': 'Int64',
+    'Byte': 'UInt8',
+    # previously misspelled variant
+    'Uint64': 'UInt64',
+}
+
+for depr_prefix, base_prefix in deprecated_name_map.items():
+    _make_deprecated_swig_class(depr_prefix + "Vector", base_prefix + "Vector")
+
+    # same for the three legacy *VectorVector classes
+    if depr_prefix in ['Float', 'Long', 'Byte']:
+        _make_deprecated_swig_class(depr_prefix + "VectorVector",
+                                    base_prefix + "VectorVector")
+
+# mapping from vector names in swigfaiss.swig and the numpy dtype names
+# TODO: once deprecated classes are removed, remove the dict and just use .lower() below
+vector_name_map = {
+    'Float32': 'float32',
+    'Float64': 'float64',
+    'Int8': 'int8',
+    'Int16': 'int16',
+    'Int32': 'int32',
+    'Int64': 'int64',
+    'UInt8': 'uint8',
+    'UInt16': 'uint16',
+    'UInt32': 'uint32',
+    'UInt64': 'uint64',
+    **{k: v.lower() for k, v in deprecated_name_map.items()}
+}
+
+
+def vector_to_array(v):
+    """ convert a C++ vector to a numpy array """
+    classname = v.__class__.__name__
+    if classname.startswith('AlignedTable'):
+        return AlignedTable_to_array(v)
+    assert classname.endswith('Vector')
+    dtype = np.dtype(vector_name_map[classname[:-6]])
+    a = np.empty(v.size(), dtype=dtype)
+    if v.size() > 0:
+        memcpy(swig_ptr(a), v.data(), a.nbytes)
+    return a
+
+
+def vector_float_to_array(v):
+    return vector_to_array(v)
+
+
+def copy_array_to_vector(a, v):
+    """ copy a numpy array to a vector """
+    n, = a.shape
+    classname = v.__class__.__name__
+    assert classname.endswith('Vector')
+    dtype = np.dtype(vector_name_map[classname[:-6]])
+    assert dtype == a.dtype, (
+        'cannot copy a %s array to a %s (should be %s)' % (
+            a.dtype, classname, dtype))
+    v.resize(n)
+    if n > 0:
+        memcpy(v.data(), swig_ptr(a), a.nbytes)
+
+# same for AlignedTable
+
+
+def copy_array_to_AlignedTable(a, v):
+    n, = a.shape
+    # TODO check class name
+    assert v.itemsize() == a.itemsize
+    v.resize(n)
+    if n > 0:
+        memcpy(v.get(), swig_ptr(a), a.nbytes)
+
+
+def array_to_AlignedTable(a):
+    if a.dtype == 'uint16':
+        v = AlignedTableUint16(a.size)
+    elif a.dtype == 'uint8':
+        v = AlignedTableUint8(a.size)
+    else:
+        assert False
+    copy_array_to_AlignedTable(a, v)
+    return v
+
+
+def AlignedTable_to_array(v):
+    """ convert an AlignedTable to a numpy array """
+    classname = v.__class__.__name__
+    assert classname.startswith('AlignedTable')
+    dtype = classname[12:].lower()
+    a = np.empty(v.size(), dtype=dtype)
+    if a.size > 0:
+        memcpy(swig_ptr(a), v.data(), a.nbytes)
+    return a
diff --git a/llm/Lib/site-packages/faiss/class_wrappers.py b/llm/Lib/site-packages/faiss/class_wrappers.py
new file mode 100644
index 0000000000000000000000000000000000000000..7a4bf3bbc0ca588eb3a1a3862efaa655edd228b2
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/class_wrappers.py
@@ -0,0 +1,1215 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+import inspect
+
+import faiss
+import numpy as np
+
+from faiss.loader import (
+    DirectMap,
+    IDSelector,
+    IDSelectorArray,
+    IDSelectorBatch,
+    OperatingPoints,
+    RangeSearchResult,
+    rev_swig_ptr,
+    swig_ptr,
+    try_extract_index_ivf,
+)
+
+##################################################################
+# The functions below add or replace some methods for classes
+# this is to be able to pass in numpy arrays directly
+# The C++ version of the classnames will be suffixed with _c
+#
+# The docstrings in the wrappers are intended to be similar to numpy
+# comments, they will appear with help(Class.method) or ?Class.method
+# For methods that are not replaced, the C++ documentation will be used if
+# swig 4.x is run with -doxygen.
+##################################################################
+
+# For most arrays we force the convesion to the target type with
+# np.ascontiguousarray, but for uint8 codes, we raise a type error
+# because it is unclear how the conversion should occur: with a view
+# (= cast) or conversion?
+
+def _check_dtype_uint8(codes):
+    if codes.dtype != 'uint8':
+        raise TypeError("Input argument %s must be ndarray of dtype "
+                        " uint8, but found %s" % ("codes", codes.dtype))
+    return np.ascontiguousarray(codes)
+
+
+def replace_method(the_class, name, replacement, ignore_missing=False):
+    """ Replaces a method in a class with another version. The old method
+    is renamed to method_name_c (because presumably it was implemented in C) """
+    try:
+        orig_method = getattr(the_class, name)
+    except AttributeError:
+        if ignore_missing:
+            return
+        raise
+    if orig_method.__name__ == 'replacement_' + name:
+        # replacement was done in parent class
+        return
+    setattr(the_class, name + '_c', orig_method)
+    setattr(the_class, name, replacement)
+
+
+def handle_Clustering(the_class):
+
+    def replacement_train(self, x, index, weights=None):
+        """Perform clustering on a set of vectors. The index is used for assignment.
+
+        Parameters
+        ----------
+        x : array_like
+            Training vectors, shape (n, self.d). `dtype` must be float32.
+        index : faiss.Index
+            Index used for assignment. The dimension of the index should be `self.d`.
+        weights : array_like, optional
+            Per training sample weight (size n) used when computing the weighted
+            average to obtain the centroid (default is 1 for all training vectors).
+        """
+        n, d = x.shape
+        x = np.ascontiguousarray(x, dtype='float32')
+        assert d == self.d
+        if weights is not None:
+            weights = np.ascontiguousarray(weights, dtype='float32')
+            assert weights.shape == (n, )
+            self.train_c(n, swig_ptr(x), index, swig_ptr(weights))
+        else:
+            self.train_c(n, swig_ptr(x), index)
+
+    def replacement_train_encoded(self, x, codec, index, weights=None):
+        """ Perform clustering on a set of compressed vectors. The index is used for assignment.
+        The decompression is performed on-the-fly.
+
+        Parameters
+        ----------
+        x : array_like
+            Training vectors, shape (n, codec.code_size()). `dtype` must be `uint8`.
+        codec : faiss.Index
+            Index used to decode the vectors. Should have dimension `self.d`.
+        index : faiss.Index
+            Index used for assignment. The dimension of the index should be `self.d`.
+        weigths : array_like, optional
+            Per training sample weight (size n) used when computing the weighted
+            average to obtain the centroid (default is 1 for all training vectors).
+        """
+        n, d = x.shape
+        x = _check_dtype_uint8(x)
+        assert d == codec.sa_code_size()
+        assert codec.d == index.d
+        if weights is not None:
+            weights = np.ascontiguousarray(weights, dtype='float32')
+            assert weights.shape == (n, )
+            self.train_encoded_c(n, swig_ptr(x), codec,
+                                 index, swig_ptr(weights))
+        else:
+            self.train_encoded_c(n, swig_ptr(x), codec, index)
+
+    replace_method(the_class, 'train', replacement_train)
+    replace_method(the_class, 'train_encoded', replacement_train_encoded)
+
+
+def handle_Clustering1D(the_class):
+
+    def replacement_train_exact(self, x):
+        """Perform clustering on a set of 1D vectors.
+
+        Parameters
+        ----------
+        x : array_like
+            Training vectors, shape (n, 1). `dtype` must be float32.
+        """
+        n, d = x.shape
+        x = np.ascontiguousarray(x, dtype='float32')
+        assert d == self.d
+        self.train_exact_c(n, swig_ptr(x))
+
+    replace_method(the_class, 'train_exact', replacement_train_exact)
+
+
+def handle_Quantizer(the_class):
+
+    def replacement_train(self, x):
+        """ Train the quantizer on a set of training vectors.
+
+        Parameters
+        ----------
+        x : array_like
+            Training vectors, shape (n, self.d). `dtype` must be float32.
+        """
+        n, d = x.shape
+        x = np.ascontiguousarray(x, dtype='float32')
+        assert d == self.d
+        self.train_c(n, swig_ptr(x))
+
+    def replacement_compute_codes(self, x):
+        """ Compute the codes corresponding to a set of vectors.
+
+        Parameters
+        ----------
+        x : array_like
+            Vectors to encode, shape (n, self.d). `dtype` must be float32.
+
+        Returns
+        -------
+        codes : array_like
+            Corresponding code for each vector, shape (n, self.code_size)
+            and `dtype` uint8.
+        """
+        n, d = x.shape
+        x = np.ascontiguousarray(x, dtype='float32')
+        assert d == self.d
+        codes = np.empty((n, self.code_size), dtype='uint8')
+        self.compute_codes_c(swig_ptr(x), swig_ptr(codes), n)
+        return codes
+
+    def replacement_decode(self, codes):
+        """Reconstruct an approximation of vectors given their codes.
+
+        Parameters
+        ----------
+        codes : array_like
+            Codes to decode, shape (n, self.code_size). `dtype` must be uint8.
+
+        Returns
+        -------
+            Reconstructed vectors for each code, shape `(n, d)` and `dtype` float32.
+        """
+        n, cs = codes.shape
+        codes = _check_dtype_uint8(codes)
+        assert cs == self.code_size
+        x = np.empty((n, self.d), dtype='float32')
+        self.decode_c(swig_ptr(codes), swig_ptr(x), n)
+        return x
+
+    replace_method(the_class, 'train', replacement_train)
+    replace_method(the_class, 'compute_codes', replacement_compute_codes)
+    replace_method(the_class, 'decode', replacement_decode)
+
+
+def handle_NSG(the_class):
+
+    def replacement_build(self, x, graph):
+        n, d = x.shape
+        assert d == self.d
+        assert graph.ndim == 2
+        assert graph.shape[0] == n
+        K = graph.shape[1]
+        x = np.ascontiguousarray(x, dtype='float32')
+        graph = np.ascontiguousarray(graph, dtype='int64')
+        self.build_c(n, swig_ptr(x), swig_ptr(graph), K)
+
+    replace_method(the_class, 'build', replacement_build)
+
+
+def handle_Index(the_class):
+
+    def replacement_add(self, x):
+        """Adds vectors to the index.
+        The index must be trained before vectors can be added to it.
+        The vectors are implicitly numbered in sequence. When `n` vectors are
+        added to the index, they are given ids `ntotal`, `ntotal + 1`, ..., `ntotal + n - 1`.
+
+        Parameters
+        ----------
+        x : array_like
+            Query vectors, shape (n, d) where d is appropriate for the index.
+            `dtype` must be float32.
+        """
+
+        n, d = x.shape
+        assert d == self.d
+        x = np.ascontiguousarray(x, dtype='float32')
+        self.add_c(n, swig_ptr(x))
+
+    def replacement_add_with_ids(self, x, ids):
+        """Adds vectors with arbitrary ids to the index (not all indexes support this).
+        The index must be trained before vectors can be added to it.
+        Vector `i` is stored in `x[i]` and has id `ids[i]`.
+
+        Parameters
+        ----------
+        x : array_like
+            Query vectors, shape (n, d) where d is appropriate for the index.
+            `dtype` must be float32.
+        ids : array_like
+            Array if ids of size n. The ids must be of type `int64`. Note that `-1` is reserved
+            in result lists to mean "not found" so it's better to not use it as an id.
+        """
+        n, d = x.shape
+        assert d == self.d
+        x = np.ascontiguousarray(x, dtype='float32')
+        ids = np.ascontiguousarray(ids, dtype='int64')
+        assert ids.shape == (n, ), 'not same nb of vectors as ids'
+        self.add_with_ids_c(n, swig_ptr(x), swig_ptr(ids))
+
+    def replacement_assign(self, x, k, labels=None):
+        """Find the k nearest neighbors of the set of vectors x in the index.
+        This is the same as the `search` method, but discards the distances.
+
+        Parameters
+        ----------
+        x : array_like
+            Query vectors, shape (n, d) where d is appropriate for the index.
+            `dtype` must be float32.
+        k : int
+            Number of nearest neighbors.
+        labels : array_like, optional
+            Labels array to store the results.
+
+        Returns
+        -------
+        labels: array_like
+            Labels of the nearest neighbors, shape (n, k).
+            When not enough results are found, the label is set to -1
+        """
+        n, d = x.shape
+        assert d == self.d
+        x = np.ascontiguousarray(x, dtype='float32')
+
+        if labels is None:
+            labels = np.empty((n, k), dtype=np.int64)
+        else:
+            assert labels.shape == (n, k)
+
+        self.assign_c(n, swig_ptr(x), swig_ptr(labels), k)
+        return labels
+
+    def replacement_train(self, x):
+        """Trains the index on a representative set of vectors.
+        The index must be trained before vectors can be added to it.
+
+        Parameters
+        ----------
+        x : array_like
+            Query vectors, shape (n, d) where d is appropriate for the index.
+            `dtype` must be float32.
+        """
+        n, d = x.shape
+        assert d == self.d
+        x = np.ascontiguousarray(x, dtype='float32')
+        self.train_c(n, swig_ptr(x))
+
+    def replacement_search(self, x, k, *, params=None, D=None, I=None):
+        """Find the k nearest neighbors of the set of vectors x in the index.
+
+        Parameters
+        ----------
+        x : array_like
+            Query vectors, shape (n, d) where d is appropriate for the index.
+            `dtype` must be float32.
+        k : int
+            Number of nearest neighbors.
+        params : SearchParameters
+            Search parameters of the current search (overrides the class-level params)
+        D : array_like, optional
+            Distance array to store the result.
+        I : array_like, optional
+            Labels array to store the results.
+
+        Returns
+        -------
+        D : array_like
+            Distances of the nearest neighbors, shape (n, k). When not enough results are found
+            the label is set to +Inf or -Inf.
+        I : array_like
+            Labels of the nearest neighbors, shape (n, k).
+            When not enough results are found, the label is set to -1
+        """
+
+        n, d = x.shape
+        x = np.ascontiguousarray(x, dtype='float32')
+        assert d == self.d
+
+        assert k > 0
+
+        if D is None:
+            D = np.empty((n, k), dtype=np.float32)
+        else:
+            assert D.shape == (n, k)
+
+        if I is None:
+            I = np.empty((n, k), dtype=np.int64)
+        else:
+            assert I.shape == (n, k)
+
+        self.search_c(n, swig_ptr(x), k, swig_ptr(D), swig_ptr(I), params)
+        return D, I
+
+    def replacement_search_and_reconstruct(self, x, k, *, params=None, D=None, I=None, R=None):
+        """Find the k nearest neighbors of the set of vectors x in the index,
+        and return an approximation of these vectors.
+
+        Parameters
+        ----------
+        x : array_like
+            Query vectors, shape (n, d) where d is appropriate for the index.
+            `dtype` must be float32.
+        k : int
+            Number of nearest neighbors.
+        params : SearchParameters
+            Search parameters of the current search (overrides the class-level params)
+        D : array_like, optional
+            Distance array to store the result.
+        I : array_like, optional
+            Labels array to store the result.
+        R : array_like, optional
+            reconstruction array to store
+
+        Returns
+        -------
+        D : array_like
+            Distances of the nearest neighbors, shape (n, k). When not enough results are found
+            the label is set to +Inf or -Inf.
+        I : array_like
+            Labels of the nearest neighbors, shape (n, k). When not enough results are found,
+            the label is set to -1
+        R : array_like
+            Approximate (reconstructed) nearest neighbor vectors, shape (n, k, d).
+        """
+        n, d = x.shape
+        assert d == self.d
+        x = np.ascontiguousarray(x, dtype='float32')
+
+        assert k > 0
+
+        if D is None:
+            D = np.empty((n, k), dtype=np.float32)
+        else:
+            assert D.shape == (n, k)
+
+        if I is None:
+            I = np.empty((n, k), dtype=np.int64)
+        else:
+            assert I.shape == (n, k)
+
+        if R is None:
+            R = np.empty((n, k, d), dtype=np.float32)
+        else:
+            assert R.shape == (n, k, d)
+
+        self.search_and_reconstruct_c(
+            n, swig_ptr(x),
+            k, swig_ptr(D),
+            swig_ptr(I), swig_ptr(R), params
+        )
+        return D, I, R
+
+    def replacement_search_and_return_codes(
+            self, x, k, *,
+            include_listnos=False, params=None, D=None, I=None, codes=None):
+        """Find the k nearest neighbors of the set of vectors x in the index,
+        and return the codes stored for these vectors
+
+        Parameters
+        ----------
+        x : array_like
+            Query vectors, shape (n, d) where d is appropriate for the index.
+            `dtype` must be float32.
+        k : int
+            Number of nearest neighbors.
+        params : SearchParameters
+            Search parameters of the current search (overrides the class-level params)
+        include_listnos : bool, optional
+            whether to include the list ids in the first bytes of each code
+        D : array_like, optional
+            Distance array to store the result.
+        I : array_like, optional
+            Labels array to store the result.
+        codes : array_like, optional
+            codes array to store
+
+        Returns
+        -------
+        D : array_like
+            Distances of the nearest neighbors, shape (n, k). When not enough results are found
+            the label is set to +Inf or -Inf.
+        I : array_like
+            Labels of the nearest neighbors, shape (n, k). When not enough results are found,
+            the label is set to -1
+        R : array_like
+            Approximate (reconstructed) nearest neighbor vectors, shape (n, k, d).
+        """
+        n, d = x.shape
+        assert d == self.d
+        x = np.ascontiguousarray(x, dtype='float32')
+
+        assert k > 0
+
+        if D is None:
+            D = np.empty((n, k), dtype=np.float32)
+        else:
+            assert D.shape == (n, k)
+
+        if I is None:
+            I = np.empty((n, k), dtype=np.int64)
+        else:
+            assert I.shape == (n, k)
+
+        code_size_1 = self.code_size
+        if include_listnos:
+            code_size_1 += self.coarse_code_size()
+
+        if codes is None:
+            codes = np.empty((n, k, code_size_1), dtype=np.uint8)
+        else:
+            assert codes.shape == (n, k, code_size_1)
+
+        self.search_and_return_codes_c(
+            n, swig_ptr(x),
+            k, swig_ptr(D),
+            swig_ptr(I), swig_ptr(codes), include_listnos,
+            params
+        )
+        return D, I, codes
+
+    def replacement_remove_ids(self, x):
+        """Remove some ids from the index.
+        This is a O(ntotal) operation by default, so could be expensive.
+
+        Parameters
+        ----------
+        x : array_like or faiss.IDSelector
+            Either an IDSelector that returns True for vectors to remove, or a
+            list of ids to reomove (1D array of int64). When `x` is a list,
+            it is wrapped into an IDSelector.
+
+        Returns
+        -------
+        n_remove: int
+            number of vectors that were removed
+        """
+        if isinstance(x, IDSelector):
+            sel = x
+        else:
+            assert x.ndim == 1
+            index_ivf = try_extract_index_ivf(self)
+            x = np.ascontiguousarray(x, dtype='int64')
+            if index_ivf and index_ivf.direct_map.type == DirectMap.Hashtable:
+                sel = IDSelectorArray(x.size, swig_ptr(x))
+            else:
+                sel = IDSelectorBatch(x.size, swig_ptr(x))
+        return self.remove_ids_c(sel)
+
+    def replacement_reconstruct(self, key, x=None):
+        """Approximate reconstruction of one vector from the index.
+
+        Parameters
+        ----------
+        key : int
+            Id of the vector to reconstruct
+        x : array_like, optional
+            pre-allocated array to store the results
+
+        Returns
+        -------
+        x : array_like reconstructed vector, size `self.d`, `dtype`=float32
+        """
+        if x is None:
+            x = np.empty(self.d, dtype=np.float32)
+        else:
+            assert x.shape == (self.d, )
+
+        self.reconstruct_c(key, swig_ptr(x))
+        return x
+
+    def replacement_reconstruct_batch(self, key, x=None):
+        """Approximate reconstruction of several vectors from the index.
+
+        Parameters
+        ----------
+        key : array of ints
+            Ids of the vectors to reconstruct
+        x : array_like, optional
+            pre-allocated array to store the results
+
+        Returns
+        -------
+        x : array_like
+            reconstrcuted vectors, size `len(key), self.d`
+        """
+        key = np.ascontiguousarray(key, dtype='int64')
+        n, = key.shape
+        if x is None:
+            x = np.empty((n, self.d), dtype=np.float32)
+        else:
+            assert x.shape == (n, self.d)
+        self.reconstruct_batch_c(n, swig_ptr(key), swig_ptr(x))
+        return x
+
+    def replacement_reconstruct_n(self, n0=0, ni=-1, x=None):
+        """Approximate reconstruction of vectors `n0` ... `n0 + ni - 1` from the index.
+        Missing vectors trigger an exception.
+
+        Parameters
+        ----------
+        n0 : int
+            Id of the first vector to reconstruct (default 0)
+        ni : int
+            Number of vectors to reconstruct (-1 = default = ntotal)
+        x : array_like, optional
+            pre-allocated array to store the results
+
+        Returns
+        -------
+        x : array_like
+            Reconstructed vectors, size (`ni`, `self.d`), `dtype`=float32
+        """
+        if ni == -1:
+            ni = self.ntotal - n0
+        if x is None:
+            x = np.empty((ni, self.d), dtype=np.float32)
+        else:
+            assert x.shape == (ni, self.d)
+
+        self.reconstruct_n_c(n0, ni, swig_ptr(x))
+        return x
+
+    def replacement_update_vectors(self, keys, x):
+        n = keys.size
+        assert keys.shape == (n, )
+        assert x.shape == (n, self.d)
+        x = np.ascontiguousarray(x, dtype='float32')
+        keys = np.ascontiguousarray(keys, dtype='int64')
+        self.update_vectors_c(n, swig_ptr(keys), swig_ptr(x))
+
+    # No support passed-in for output buffers
+    def replacement_range_search(self, x, thresh, *, params=None):
+        """Search vectors that are within a distance of the query vectors.
+
+        Parameters
+        ----------
+        x : array_like
+            Query vectors, shape (n, d) where d is appropriate for the index.
+            `dtype` must be float32.
+        thresh : float
+            Threshold to select neighbors. All elements within this radius are returned,
+            except for maximum inner product indexes, where the elements above the
+            threshold are returned
+        params : SearchParameters
+            Search parameters of the current search (overrides the class-level params)
+
+
+        Returns
+        -------
+        lims: array_like
+            Starting index of the results for each query vector, size n+1.
+        D : array_like
+            Distances of the nearest neighbors, shape `lims[n]`. The distances for
+            query i are in `D[lims[i]:lims[i+1]]`.
+        I : array_like
+            Labels of nearest neighbors, shape `lims[n]`. The labels for query i
+            are in `I[lims[i]:lims[i+1]]`.
+
+        """
+        n, d = x.shape
+        assert d == self.d
+        x = np.ascontiguousarray(x, dtype='float32')
+        thresh = float(thresh)
+
+        res = RangeSearchResult(n)
+        self.range_search_c(n, swig_ptr(x), thresh, res, params)
+        # get pointers and copy them
+        lims = rev_swig_ptr(res.lims, n + 1).copy()
+        nd = int(lims[-1])
+        D = rev_swig_ptr(res.distances, nd).copy()
+        I = rev_swig_ptr(res.labels, nd).copy()
+        return lims, D, I
+
+    def replacement_search_preassigned(self, x, k, Iq, Dq, *, params=None, D=None, I=None):
+        """Find the k nearest neighbors of the set of vectors x in an IVF index,
+        with precalculated coarse quantization assignment.
+
+        Parameters
+        ----------
+        x : array_like
+            Query vectors, shape (n, d) where d is appropriate for the index.
+            `dtype` must be float32.
+        k : int
+            Number of nearest neighbors.
+        Dq : array_like, optional
+            Distance array to the centroids, size (n, nprobe)
+        Iq : array_like, optional
+            Nearest centroids, size (n, nprobe)
+
+        params : SearchParameters
+            Search parameters of the current search (overrides the class-level params)
+        D : array_like, optional
+            Distance array to store the result.
+        I : array_like, optional
+            Labels array to store the results.
+
+        Returns
+        -------
+        D : array_like
+            Distances of the nearest neighbors, shape (n, k). When not enough results are found
+            the label is set to +Inf or -Inf.
+        I : array_like
+            Labels of the nearest neighbors, shape (n, k).
+            When not enough results are found, the label is set to -1
+        """
+        n, d = x.shape
+        x = np.ascontiguousarray(x, dtype='float32')
+        assert d == self.d
+        assert k > 0
+
+        if D is None:
+            D = np.empty((n, k), dtype=np.float32)
+        else:
+            assert D.shape == (n, k)
+
+        if I is None:
+            I = np.empty((n, k), dtype=np.int64)
+        else:
+            assert I.shape == (n, k)
+
+        Iq = np.ascontiguousarray(Iq, dtype='int64')
+        assert params is None, "params not supported"
+        assert Iq.shape == (n, self.nprobe)
+
+        if Dq is not None:
+            Dq = np.ascontiguousarray(Dq, dtype='float32')
+            assert Dq.shape == Iq.shape
+
+        self.search_preassigned_c(
+            n, swig_ptr(x),
+            k,
+            swig_ptr(Iq), swig_ptr(Dq),
+            swig_ptr(D), swig_ptr(I),
+            False
+        )
+        return D, I
+
+    def replacement_range_search_preassigned(self, x, thresh, Iq, Dq, *, params=None):
+        """Search vectors that are within a distance of the query vectors.
+
+        Parameters
+        ----------
+        x : array_like
+            Query vectors, shape (n, d) where d is appropriate for the index.
+            `dtype` must be float32.
+        thresh : float
+            Threshold to select neighbors. All elements within this radius are returned,
+            except for maximum inner product indexes, where the elements above the
+            threshold are returned
+        Iq : array_like, optional
+            Nearest centroids, size (n, nprobe)
+        Dq : array_like, optional
+            Distance array to the centroids, size (n, nprobe)
+        params : SearchParameters
+            Search parameters of the current search (overrides the class-level params)
+
+
+        Returns
+        -------
+        lims: array_like
+            Starting index of the results for each query vector, size n+1.
+        D : array_like
+            Distances of the nearest neighbors, shape `lims[n]`. The distances for
+            query i are in `D[lims[i]:lims[i+1]]`.
+        I : array_like
+            Labels of nearest neighbors, shape `lims[n]`. The labels for query i
+            are in `I[lims[i]:lims[i+1]]`.
+
+        """
+        n, d = x.shape
+        assert d == self.d
+        x = np.ascontiguousarray(x, dtype='float32')
+
+        Iq = np.ascontiguousarray(Iq, dtype='int64')
+        assert params is None, "params not supported"
+        assert Iq.shape == (n, self.nprobe)
+
+        if Dq is not None:
+            Dq = np.ascontiguousarray(Dq, dtype='float32')
+            assert Dq.shape == Iq.shape
+
+        thresh = float(thresh)
+        res = RangeSearchResult(n)
+        self.range_search_preassigned_c(
+            n, swig_ptr(x), thresh,
+            swig_ptr(Iq), swig_ptr(Dq),
+            res
+        )
+        # get pointers and copy them
+        lims = rev_swig_ptr(res.lims, n + 1).copy()
+        nd = int(lims[-1])
+        D = rev_swig_ptr(res.distances, nd).copy()
+        I = rev_swig_ptr(res.labels, nd).copy()
+        return lims, D, I
+
+    def replacement_sa_encode(self, x, codes=None):
+        n, d = x.shape
+        assert d == self.d
+        x = np.ascontiguousarray(x, dtype='float32')
+
+        if codes is None:
+            codes = np.empty((n, self.sa_code_size()), dtype=np.uint8)
+        else:
+            assert codes.shape == (n, self.sa_code_size())
+
+        self.sa_encode_c(n, swig_ptr(x), swig_ptr(codes))
+        return codes
+
+    def replacement_sa_decode(self, codes, x=None):
+        n, cs = codes.shape
+        assert cs == self.sa_code_size()
+        codes = _check_dtype_uint8(codes)
+
+        if x is None:
+            x = np.empty((n, self.d), dtype=np.float32)
+        else:
+            assert x.shape == (n, self.d)
+
+        self.sa_decode_c(n, swig_ptr(codes), swig_ptr(x))
+        return x
+
+    def replacement_add_sa_codes(self, codes, ids=None):
+        n, cs = codes.shape
+        assert cs == self.sa_code_size()
+        codes = _check_dtype_uint8(codes)
+
+        if ids is not None:
+            assert ids.shape == (n,)
+            ids = swig_ptr(ids)
+        self.add_sa_codes_c(n, swig_ptr(codes), ids)
+
+    def replacement_permute_entries(self, perm):
+        n, = perm.shape
+        assert n == self.ntotal
+        perm = np.ascontiguousarray(perm, dtype='int64')
+        self.permute_entries_c(faiss.swig_ptr(perm))
+
+    replace_method(the_class, 'add', replacement_add)
+    replace_method(the_class, 'add_with_ids', replacement_add_with_ids)
+    replace_method(the_class, 'assign', replacement_assign)
+    replace_method(the_class, 'train', replacement_train)
+    replace_method(the_class, 'search', replacement_search)
+    replace_method(the_class, 'remove_ids', replacement_remove_ids)
+    replace_method(the_class, 'reconstruct', replacement_reconstruct)
+    replace_method(the_class, 'reconstruct_batch',
+                   replacement_reconstruct_batch)
+    replace_method(the_class, 'reconstruct_n', replacement_reconstruct_n)
+    replace_method(the_class, 'range_search', replacement_range_search)
+    replace_method(the_class, 'update_vectors', replacement_update_vectors,
+                   ignore_missing=True)
+    replace_method(the_class, 'search_and_reconstruct',
+                   replacement_search_and_reconstruct, ignore_missing=True)
+    replace_method(the_class, 'search_and_return_codes',
+                   replacement_search_and_return_codes, ignore_missing=True)
+
+    # these ones are IVF-specific
+    replace_method(the_class, 'search_preassigned',
+                   replacement_search_preassigned, ignore_missing=True)
+    replace_method(the_class, 'range_search_preassigned',
+                   replacement_range_search_preassigned, ignore_missing=True)
+    replace_method(the_class, 'sa_encode', replacement_sa_encode)
+    replace_method(the_class, 'sa_decode', replacement_sa_decode)
+    replace_method(the_class, 'add_sa_codes', replacement_add_sa_codes,
+                   ignore_missing=True)
+    replace_method(the_class, 'permute_entries', replacement_permute_entries,
+                   ignore_missing=True)
+
+    # get/set state for pickle
+    # the data is serialized to std::vector -> numpy array -> python bytes
+    # so not very efficient for now.
+
+    def index_getstate(self):
+        return {"this": faiss.serialize_index(self).tobytes()}
+
+    def index_setstate(self, st):
+        index2 = faiss.deserialize_index(np.frombuffer(st["this"], dtype="uint8"))
+        self.this = index2.this
+
+    the_class.__getstate__ = index_getstate
+    the_class.__setstate__ = index_setstate
+
+
+def handle_IndexBinary(the_class):
+
+    def replacement_add(self, x):
+        n, d = x.shape
+        x = _check_dtype_uint8(x)
+        assert d == self.code_size
+        self.add_c(n, swig_ptr(x))
+
+    def replacement_add_with_ids(self, x, ids):
+        n, d = x.shape
+        x = _check_dtype_uint8(x)
+        ids = np.ascontiguousarray(ids, dtype='int64')
+        assert d == self.code_size
+        assert ids.shape == (n, ), 'not same nb of vectors as ids'
+        self.add_with_ids_c(n, swig_ptr(x), swig_ptr(ids))
+
+    def replacement_train(self, x):
+        n, d = x.shape
+        x = _check_dtype_uint8(x)
+        assert d == self.code_size
+        self.train_c(n, swig_ptr(x))
+
+    def replacement_reconstruct(self, key):
+        x = np.empty(self.code_size, dtype=np.uint8)
+        self.reconstruct_c(key, swig_ptr(x))
+        return x
+
+    def replacement_reconstruct_n(self, n0=0, ni=-1, x=None):
+        if ni == -1:
+            ni = self.ntotal - n0
+        if x is None:
+            x = np.empty((ni, self.code_size), dtype=np.uint8)
+        else:
+            assert x.shape == (ni, self.code_size)
+
+        self.reconstruct_n_c(n0, ni, swig_ptr(x))
+        return x
+
+    def replacement_search(self, x, k):
+        x = _check_dtype_uint8(x)
+        n, d = x.shape
+        assert d == self.code_size
+        assert k > 0
+        distances = np.empty((n, k), dtype=np.int32)
+        labels = np.empty((n, k), dtype=np.int64)
+        self.search_c(n, swig_ptr(x),
+                      k, swig_ptr(distances),
+                      swig_ptr(labels))
+        return distances, labels
+
+    def replacement_search_preassigned(self, x, k, Iq, Dq):
+        n, d = x.shape
+        x = _check_dtype_uint8(x)
+        assert d == self.code_size
+        assert k > 0
+
+        D = np.empty((n, k), dtype=np.int32)
+        I = np.empty((n, k), dtype=np.int64)
+
+        Iq = np.ascontiguousarray(Iq, dtype='int64')
+        assert Iq.shape == (n, self.nprobe)
+
+        if Dq is not None:
+            Dq = np.ascontiguousarray(Dq, dtype='int32')
+            assert Dq.shape == Iq.shape
+
+        self.search_preassigned_c(
+            n, swig_ptr(x),
+            k,
+            swig_ptr(Iq), swig_ptr(Dq),
+            swig_ptr(D), swig_ptr(I),
+            False
+        )
+        return D, I
+
+    def replacement_range_search(self, x, thresh):
+        n, d = x.shape
+        x = _check_dtype_uint8(x)
+        assert d == self.code_size
+        res = RangeSearchResult(n)
+        self.range_search_c(n, swig_ptr(x), thresh, res)
+        # get pointers and copy them
+        lims = rev_swig_ptr(res.lims, n + 1).copy()
+        nd = int(lims[-1])
+        D = rev_swig_ptr(res.distances, nd).copy()
+        I = rev_swig_ptr(res.labels, nd).copy()
+        return lims, D, I
+
+    def replacement_range_search_preassigned(self, x, thresh, Iq, Dq, *, params=None):
+        n, d = x.shape
+        x = _check_dtype_uint8(x)
+        assert d == self.code_size
+
+        Iq = np.ascontiguousarray(Iq, dtype='int64')
+        assert params is None, "params not supported"
+        assert Iq.shape == (n, self.nprobe)
+
+        if Dq is not None:
+            Dq = np.ascontiguousarray(Dq, dtype='int32')
+            assert Dq.shape == Iq.shape
+
+        thresh = int(thresh)
+        res = RangeSearchResult(n)
+        self.range_search_preassigned_c(
+            n, swig_ptr(x), thresh,
+            swig_ptr(Iq), swig_ptr(Dq),
+            res
+        )
+        # get pointers and copy them
+        lims = rev_swig_ptr(res.lims, n + 1).copy()
+        nd = int(lims[-1])
+        D = rev_swig_ptr(res.distances, nd).copy()
+        I = rev_swig_ptr(res.labels, nd).copy()
+        return lims, D, I
+
+    def replacement_remove_ids(self, x):
+        if isinstance(x, IDSelector):
+            sel = x
+        else:
+            assert x.ndim == 1
+            x = np.ascontiguousarray(x, dtype='int64')
+            sel = IDSelectorBatch(x.size, swig_ptr(x))
+        return self.remove_ids_c(sel)
+
+    replace_method(the_class, 'add', replacement_add)
+    replace_method(the_class, 'add_with_ids', replacement_add_with_ids)
+    replace_method(the_class, 'train', replacement_train)
+    replace_method(the_class, 'search', replacement_search)
+    replace_method(the_class, 'range_search', replacement_range_search)
+    replace_method(the_class, 'reconstruct', replacement_reconstruct)
+    replace_method(the_class, 'reconstruct_n', replacement_reconstruct_n)
+    replace_method(the_class, 'remove_ids', replacement_remove_ids)
+    replace_method(the_class, 'search_preassigned',
+                   replacement_search_preassigned, ignore_missing=True)
+    replace_method(the_class, 'range_search_preassigned',
+                   replacement_range_search_preassigned, ignore_missing=True)
+
+
+def handle_VectorTransform(the_class):
+
+    def apply_method(self, x):
+        n, d = x.shape
+        x = np.ascontiguousarray(x, dtype='float32')
+        assert d == self.d_in
+        y = np.empty((n, self.d_out), dtype=np.float32)
+        self.apply_noalloc(n, swig_ptr(x), swig_ptr(y))
+        return y
+
+    def replacement_reverse_transform(self, x):
+        n, d = x.shape
+        x = np.ascontiguousarray(x, dtype='float32')
+        assert d == self.d_out
+        y = np.empty((n, self.d_in), dtype=np.float32)
+        self.reverse_transform_c(n, swig_ptr(x), swig_ptr(y))
+        return y
+
+    def replacement_vt_train(self, x):
+        n, d = x.shape
+        x = np.ascontiguousarray(x, dtype='float32')
+        assert d == self.d_in
+        self.train_c(n, swig_ptr(x))
+
+    replace_method(the_class, 'train', replacement_vt_train)
+    # apply is reserved in Pyton...
+    the_class.apply_py = apply_method
+    the_class.apply = apply_method
+    replace_method(the_class, 'reverse_transform',
+                   replacement_reverse_transform)
+
+
+def handle_AutoTuneCriterion(the_class):
+    def replacement_set_groundtruth(self, D, I):
+        if D:
+            assert I.shape == D.shape
+        self.nq, self.gt_nnn = I.shape
+        self.set_groundtruth_c(
+            self.gt_nnn, swig_ptr(D) if D else None, swig_ptr(I))
+
+    def replacement_evaluate(self, D, I):
+        assert I.shape == D.shape
+        assert I.shape == (self.nq, self.nnn)
+        return self.evaluate_c(swig_ptr(D), swig_ptr(I))
+
+    replace_method(the_class, 'set_groundtruth', replacement_set_groundtruth)
+    replace_method(the_class, 'evaluate', replacement_evaluate)
+
+
+def handle_ParameterSpace(the_class):
+    def replacement_explore(self, index, xq, crit):
+        assert xq.shape == (crit.nq, index.d)
+        xq = np.ascontiguousarray(xq, dtype='float32')
+        ops = OperatingPoints()
+        self.explore_c(index, crit.nq, swig_ptr(xq),
+                       crit, ops)
+        return ops
+    replace_method(the_class, 'explore', replacement_explore)
+
+
+def handle_MatrixStats(the_class):
+    original_init = the_class.__init__
+
+    def replacement_init(self, m):
+        assert len(m.shape) == 2
+        m = np.ascontiguousarray(m, dtype='float32')
+        original_init(self, m.shape[0], m.shape[1], swig_ptr(m))
+
+    the_class.__init__ = replacement_init
+
+
+def handle_IOWriter(the_class):
+    """ add a write_bytes method """
+    def write_bytes(self, b):
+        return self(swig_ptr(b), 1, len(b))
+
+    the_class.write_bytes = write_bytes
+
+
+def handle_IOReader(the_class):
+    """ add a read_bytes method """
+
+    def read_bytes(self, totsz):
+        buf = bytearray(totsz)
+        was_read = self(swig_ptr(buf), 1, len(buf))
+        return bytes(buf[:was_read])
+
+    the_class.read_bytes = read_bytes
+
+
+def handle_IndexRowwiseMinMax(the_class):
+    def replacement_train_inplace(self, x):
+        """Trains the index on a representative set of vectors inplace.
+        The index must be trained before vectors can be added to it.
+
+        This call WILL change the values in the input array, because
+        of two scaling proceduces being performed inplace.
+
+        Parameters
+        ----------
+        x : array_like
+            Query vectors, shape (n, d) where d is appropriate for the index.
+            `dtype` must be float32.
+        """
+        n, d = x.shape
+        assert d == self.d
+        x = np.ascontiguousarray(x, dtype='float32')
+        self.train_inplace_c(n, swig_ptr(x))
+
+    replace_method(the_class, 'train_inplace', replacement_train_inplace)
+
+
+def handle_CodePacker(the_class):
+
+    def replacement_pack_1(self, x, offset, block):
+        assert x.shape == (self.code_size,)
+        nblock, block_size = block.shape
+        assert block_size == self.block_size
+        assert 0 <= offset < block_size * self.nvec
+        self.pack_1_c(swig_ptr(x), offset, faiss.swig_ptr(block))
+
+    def replacement_unpack_1(self, block, offset):
+        nblock, block_size = block.shape
+        assert block_size == self.block_size
+        assert 0 <= offset < block_size * self.nvec
+        x = np.zeros(self.code_size, dtype='uint8')
+        self.unpack_1_c(faiss.swig_ptr(block), offset, swig_ptr(x))
+        return x
+
+    replace_method(the_class, 'pack_1', replacement_pack_1)
+    replace_method(the_class, 'unpack_1', replacement_unpack_1)
+
+######################################################
+# MapLong2Long interface
+######################################################
+
+
+def handle_MapLong2Long(the_class):
+
+    def replacement_map_add(self, keys, vals):
+        n, = keys.shape
+        assert (n,) == vals.shape
+        self.add_c(n, swig_ptr(keys), swig_ptr(vals))
+
+    def replacement_map_search_multiple(self, keys):
+        n, = keys.shape
+        vals = np.empty(n, dtype='int64')
+        self.search_multiple_c(n, swig_ptr(keys), swig_ptr(vals))
+        return vals
+
+    replace_method(the_class, 'add', replacement_map_add)
+    replace_method(the_class, 'search_multiple',
+                   replacement_map_search_multiple)
+
+
+######################################################
+# SearchParameters and related interface
+######################################################
+
+
+def add_to_referenced_objects(self, ref):
+    if not hasattr(self, 'referenced_objects'):
+        self.referenced_objects = [ref]
+    else:
+        self.referenced_objects.append(ref)
+
+class RememberSwigOwnership:
+    """
+    SWIG's seattr transfers ownership of SWIG wrapped objects to the class
+    (btw this seems to contradict https://www.swig.org/Doc1.3/Python.html#Python_nn22
+    31.4.2)
+    This interferes with how we manage ownership: with the referenced_objects
+    table. Therefore, we reset the thisown field in this context manager.
+    """
+
+    def __init__(self, obj):
+        self.obj = obj
+
+    def __enter__(self):
+        if hasattr(self.obj, "thisown"):
+            self.old_thisown = self.obj.thisown
+        else:
+            self.old_thisown = None
+
+    def __exit__(self, *ignored):
+        if self.old_thisown is not None:
+            self.obj.thisown = self.old_thisown
+
+
+def handle_SearchParameters(the_class):
+    """ this wrapper is to enable initializations of the form
+    SearchParametersXX(a=3, b=SearchParamsYY)
+    This also requires the enclosing class to keep a reference on the
+    sub-object, since the C++ code assumes the object ownwership is
+    handled externally.
+    """
+    the_class.original_init = the_class.__init__
+
+    def replacement_init(self, **args):
+        self.original_init()
+        for k, v in args.items():
+            assert hasattr(self, k)
+            with RememberSwigOwnership(v):
+                setattr(self, k, v)
+            if type(v) not in (int, float, bool, str):
+                add_to_referenced_objects(self, v)
+
+    the_class.__init__ = replacement_init
+
+
+def handle_IDSelectorSubset(the_class, class_owns, force_int64=True):
+    the_class.original_init = the_class.__init__
+
+    def replacement_init(self, *args):
+        if len(args) == 1:
+            # assume it's an array
+            subset, = args
+            if force_int64:
+                subset = np.ascontiguousarray(subset, dtype='int64')
+            args = (len(subset), faiss.swig_ptr(subset))
+            if not class_owns:
+                add_to_referenced_objects(self, subset)
+        self.original_init(*args)
+
+    the_class.__init__ = replacement_init
+
+
+def handle_CodeSet(the_class):
+
+    def replacement_insert(self, codes, inserted=None):
+        n, d = codes.shape
+        assert d == self.d
+        codes = np.ascontiguousarray(codes, dtype=np.uint8)
+
+        if inserted is None:
+            inserted = np.empty(n, dtype=bool)
+        else:
+            assert inserted.shape == (n, )
+
+        self.insert_c(n, swig_ptr(codes), swig_ptr(inserted))
+        return inserted
+
+    replace_method(the_class, 'insert', replacement_insert)
diff --git a/llm/Lib/site-packages/faiss/contrib/__init__.py b/llm/Lib/site-packages/faiss/contrib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dcea9828c09dfea3b6fe8647f25c018d522c528e
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/big_batch_search.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/big_batch_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..13c266d151cc1861981c14a36074be652b61bc97
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/big_batch_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/client_server.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/client_server.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4be1baff585401ecd3a8296a36a71fdf3faa4229
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/client_server.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/clustering.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/clustering.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..83eb95f00f353342a8eaa77be602bc250b0ff5a7
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/clustering.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/datasets.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/datasets.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e4292ad5c004949e190c595055b9ea6895c45566
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/datasets.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/evaluation.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/evaluation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..526368717c723edaf577d2058a7b5255629fe735
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/evaluation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/exhaustive_search.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/exhaustive_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..342d95245247fde2cedc90e68e085ae29e3fabce
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/exhaustive_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/factory_tools.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/factory_tools.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9f69c1af950800cb9f9f574114e082f8a9c07eb8
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/factory_tools.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/inspect_tools.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/inspect_tools.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c40cc15f64c7f7864d5d40d64f9ad2928dcdd578
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/inspect_tools.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/ivf_tools.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/ivf_tools.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9d28f6f2e45d5ae545b5cd252700594840bdec93
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/ivf_tools.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/ondisk.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/ondisk.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..889e2061e6258b5926a6a73eecec103d62b7256f
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/ondisk.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/rpc.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/rpc.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a31ac84d9b073d0d6132bea27e0a91afe935a94b
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/rpc.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/torch_utils.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/torch_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d4ee2eff80b8d892eab2a005f53350ae66c269fa
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/torch_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/__pycache__/vecs_io.cpython-311.pyc b/llm/Lib/site-packages/faiss/contrib/__pycache__/vecs_io.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..76e161de0dd90bf15b5e9f96efc0af9f70dcd4d9
Binary files /dev/null and b/llm/Lib/site-packages/faiss/contrib/__pycache__/vecs_io.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/faiss/contrib/big_batch_search.py b/llm/Lib/site-packages/faiss/contrib/big_batch_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..99c95941fada0e7bfdb9b75c6ddf9d14bf112946
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/contrib/big_batch_search.py
@@ -0,0 +1,515 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+import time
+import pickle
+import os
+import logging
+from multiprocessing.pool import ThreadPool
+import threading
+import _thread
+from queue import Queue
+import traceback
+import datetime
+
+import numpy as np
+import faiss
+
+from faiss.contrib.inspect_tools import get_invlist
+
+
+class BigBatchSearcher:
+    """
+    Object that manages all the data related to the computation
+    except the actual within-bucket matching and the organization of the
+    computation (parallel or not)
+    """
+
+    def __init__(
+            self,
+            index, xq, k,
+            verbose=0,
+            use_float16=False):
+
+        # verbosity
+        self.verbose = verbose
+        self.tictoc = []
+
+        self.xq = xq
+        self.index = index
+        self.use_float16 = use_float16
+        keep_max = faiss.is_similarity_metric(index.metric_type)
+        self.rh = faiss.ResultHeap(len(xq), k, keep_max=keep_max)
+        self.t_accu = [0] * 6
+        self.t_display = self.t0 = time.time()
+
+    def start_t_accu(self):
+        self.t_accu_t0 = time.time()
+
+    def stop_t_accu(self, n):
+        self.t_accu[n] += time.time() - self.t_accu_t0
+
+    def tic(self, name):
+        self.tictoc = (name, time.time())
+        if self.verbose > 0:
+            print(name, end="\r", flush=True)
+
+    def toc(self):
+        name, t0 = self.tictoc
+        dt = time.time() - t0
+        if self.verbose > 0:
+            print(f"{name}: {dt:.3f} s")
+        return dt
+
+    def report(self, l):
+        if self.verbose == 1 or (
+            self.verbose == 2 and (
+                l > 1000 and time.time() < self.t_display + 1.0
+            )
+        ):
+            return
+        t = time.time() - self.t0
+        print(
+            f"[{t:.1f} s] list {l}/{self.index.nlist} "
+            f"times prep q {self.t_accu[0]:.3f} prep b {self.t_accu[1]:.3f} "
+            f"comp {self.t_accu[2]:.3f} res {self.t_accu[3]:.3f} "
+            f"wait in {self.t_accu[4]:.3f} "
+            f"wait out {self.t_accu[5]:.3f} "
+            f"eta {datetime.timedelta(seconds=t*self.index.nlist/(l+1)-t)} "
+            f"mem {faiss.get_mem_usage_kb()}",
+             end="\r" if self.verbose <= 2 else "\n",
+             flush=True,
+        )
+        self.t_display = time.time()
+
+    def coarse_quantization(self):
+        self.tic("coarse quantization")
+        bs = 65536
+        nq = len(self.xq)
+        q_assign = np.empty((nq, self.index.nprobe), dtype='int32')
+        for i0 in range(0, nq, bs):
+            i1 = min(nq, i0 + bs)
+            q_dis_i, q_assign_i = self.index.quantizer.search(
+                self.xq[i0:i1], self.index.nprobe)
+            # q_dis[i0:i1] = q_dis_i
+            q_assign[i0:i1] = q_assign_i
+        self.toc()
+        self.q_assign = q_assign
+
+    def reorder_assign(self):
+        self.tic("bucket sort")
+        q_assign = self.q_assign
+        q_assign += 1   # move -1 -> 0
+        self.bucket_lims = faiss.matrix_bucket_sort_inplace(
+            self.q_assign, nbucket=self.index.nlist + 1, nt=16)
+        self.query_ids = self.q_assign.ravel()
+        if self.verbose > 0:
+            print('  number of -1s:', self.bucket_lims[1])
+        self.bucket_lims = self.bucket_lims[1:]  # shift back to ignore -1s
+        del self.q_assign   # inplace so let's forget about the old version...
+        self.toc()
+
+    def prepare_bucket(self, l):
+        """ prepare the queries and database items for bucket l"""
+        t0 = time.time()
+        index = self.index
+        # prepare queries
+        i0, i1 = self.bucket_lims[l], self.bucket_lims[l + 1]
+        q_subset = self.query_ids[i0:i1]
+        xq_l = self.xq[q_subset]
+        if self.by_residual:
+            xq_l = xq_l - index.quantizer.reconstruct(l)
+        t1 = time.time()
+        # prepare database side
+        list_ids, xb_l = get_invlist(index.invlists, l)
+
+        if self.decode_func is None:
+            xb_l = xb_l.ravel()
+        else:
+            xb_l = self.decode_func(xb_l)
+
+        if self.use_float16:
+            xb_l = xb_l.astype('float16')
+            xq_l = xq_l.astype('float16')
+
+        t2 = time.time()
+        self.t_accu[0] += t1 - t0
+        self.t_accu[1] += t2 - t1
+        return q_subset, xq_l, list_ids, xb_l
+
+    def add_results_to_heap(self, q_subset, D, list_ids, I):
+        """add the bucket results to the heap structure"""
+        if D is None:
+            return
+        t0 = time.time()
+        if I is None:
+            I = list_ids
+        else:
+            I = list_ids[I]
+        self.rh.add_result_subset(q_subset, D, I)
+        self.t_accu[3] += time.time() - t0
+
+    def sizes_in_checkpoint(self):
+        return (self.xq.shape, self.index.nprobe, self.index.nlist)
+
+    def write_checkpoint(self, fname, completed):
+        # write to temp file then move to final file
+        tmpname = fname + ".tmp"
+        with open(tmpname, "wb") as f:
+            pickle.dump(
+                {
+                    "sizes": self.sizes_in_checkpoint(),
+                    "completed": completed,
+                    "rh": (self.rh.D, self.rh.I),
+                }, f, -1)
+        os.replace(tmpname, fname)
+
+    def read_checkpoint(self, fname):
+        with open(fname, "rb") as f:
+            ckp = pickle.load(f)
+        assert ckp["sizes"] == self.sizes_in_checkpoint()
+        self.rh.D[:] = ckp["rh"][0]
+        self.rh.I[:] = ckp["rh"][1]
+        return ckp["completed"]
+
+
+class BlockComputer:
+    """ computation within one bucket """
+
+    def __init__(
+            self,
+            index,
+            method="knn_function",
+            pairwise_distances=faiss.pairwise_distances,
+            knn=faiss.knn):
+
+        self.index = index
+        if index.__class__ == faiss.IndexIVFFlat:
+            index_help = faiss.IndexFlat(index.d, index.metric_type)
+            decode_func = lambda x: x.view("float32")
+            by_residual = False
+        elif index.__class__ == faiss.IndexIVFPQ:
+            index_help = faiss.IndexPQ(
+                index.d, index.pq.M, index.pq.nbits, index.metric_type)
+            index_help.pq = index.pq
+            decode_func = index_help.pq.decode
+            index_help.is_trained = True
+            by_residual = index.by_residual
+        elif index.__class__ == faiss.IndexIVFScalarQuantizer:
+            index_help = faiss.IndexScalarQuantizer(
+                index.d, index.sq.qtype, index.metric_type)
+            index_help.sq = index.sq
+            decode_func = index_help.sq.decode
+            index_help.is_trained = True
+            by_residual = index.by_residual
+        else:
+            raise RuntimeError(f"index type {index.__class__} not supported")
+        self.index_help = index_help
+        self.decode_func = None if method == "index" else decode_func
+        self.by_residual = by_residual
+        self.method = method
+        self.pairwise_distances = pairwise_distances
+        self.knn = knn
+
+    def block_search(self, xq_l, xb_l, list_ids, k, **extra_args):
+        metric_type = self.index.metric_type
+        if xq_l.size == 0 or xb_l.size == 0:
+            D = I = None
+        elif self.method == "index":
+            faiss.copy_array_to_vector(xb_l, self.index_help.codes)
+            self.index_help.ntotal = len(list_ids)
+            D, I = self.index_help.search(xq_l, k)
+        elif self.method == "pairwise_distances":
+            # TODO implement blockwise to avoid mem blowup
+            D = self.pairwise_distances(xq_l, xb_l, metric=metric_type)
+            I = None
+        elif self.method == "knn_function":
+            D, I = self.knn(xq_l, xb_l, k, metric=metric_type, **extra_args)
+
+        return D, I
+
+
+def big_batch_search(
+        index, xq, k,
+        method="knn_function",
+        pairwise_distances=faiss.pairwise_distances,
+        knn=faiss.knn,
+        verbose=0,
+        threaded=0,
+        use_float16=False,
+        prefetch_threads=1,
+        computation_threads=1,
+        q_assign=None,
+        checkpoint=None,
+        checkpoint_freq=7200,
+        start_list=0,
+        end_list=None,
+        crash_at=-1
+        ):
+    """
+    Search queries xq in the IVF index, with a search function that collects
+    batches of query vectors per inverted list. This can be faster than the
+    regular search indexes.
+    Supports IVFFlat, IVFPQ and IVFScalarQuantizer.
+
+    Supports three computation methods:
+    method = "index":
+        build a flat index and populate it separately for each index
+    method = "pairwise_distances":
+        decompress codes and compute all pairwise distances for the queries
+        and index and add result to heap
+    method = "knn_function":
+        decompress codes and compute knn results for the queries
+
+    threaded=0: sequential execution
+    threaded=1: prefetch next bucket while computing the current one
+    threaded=2: prefetch prefetch_threads buckets at a time.
+
+    compute_threads>1: the knn function will get an additional thread_no that
+        tells which worker should handle this.
+
+    In threaded mode, the computation is tiled with the bucket perparation and
+    the writeback of results (useful to maximize GPU utilization).
+
+    use_float16: convert all matrices to float16 (faster for GPU gemm)
+
+    q_assign: override coarse assignment, should be a matrix of size nq * nprobe
+
+    checkpointing (only for threaded > 1):
+    checkpoint: file where the checkpoints are stored
+    checkpoint_freq: when to perform checkpoinging. Should be a multiple of threaded
+
+    start_list, end_list: process only a subset of invlists
+    """
+    nprobe = index.nprobe
+
+    assert method in ("index", "pairwise_distances", "knn_function")
+
+    mem_queries = xq.nbytes
+    mem_assign = len(xq) * nprobe * np.dtype('int32').itemsize
+    mem_res = len(xq) * k * (
+        np.dtype('int64').itemsize
+        + np.dtype('float32').itemsize
+    )
+    mem_tot = mem_queries + mem_assign + mem_res
+    if verbose > 0:
+        logging.info(
+            f"memory: queries {mem_queries} assign {mem_assign} "
+            f"result {mem_res} total {mem_tot} = {mem_tot / (1<<30):.3f} GiB"
+        )
+
+    bbs = BigBatchSearcher(
+        index, xq, k,
+        verbose=verbose,
+        use_float16=use_float16
+    )
+
+    comp = BlockComputer(
+        index,
+        method=method,
+        pairwise_distances=pairwise_distances,
+        knn=knn
+    )
+
+    bbs.decode_func = comp.decode_func
+
+    bbs.by_residual = comp.by_residual
+    if q_assign is None:
+        bbs.coarse_quantization()
+    else:
+        bbs.q_assign = q_assign
+    bbs.reorder_assign()
+
+    if end_list is None:
+        end_list = index.nlist
+
+    completed = set()
+    if checkpoint is not None:
+        assert (start_list, end_list) == (0, index.nlist)
+        if os.path.exists(checkpoint):
+            logging.info(f"recovering checkpoint: {checkpoint}")
+            completed = bbs.read_checkpoint(checkpoint)
+            logging.info(f"   already completed: {len(completed)}")
+        else:
+            logging.info("no checkpoint: starting from scratch")
+
+    if threaded == 0:
+        # simple sequential version
+
+        for l in range(start_list, end_list):
+            bbs.report(l)
+            q_subset, xq_l, list_ids, xb_l = bbs.prepare_bucket(l)
+            t0i = time.time()
+            D, I = comp.block_search(xq_l, xb_l, list_ids, k)
+            bbs.t_accu[2] += time.time() - t0i
+            bbs.add_results_to_heap(q_subset, D, list_ids, I)
+
+    elif threaded == 1:
+
+        # parallel version with granularity 1
+
+        def add_results_and_prefetch(to_add, l):
+            """ perform the addition for the previous bucket and
+            prefetch the next (if applicable) """
+            if to_add is not None:
+                bbs.add_results_to_heap(*to_add)
+            if l < index.nlist:
+                return bbs.prepare_bucket(l)
+
+        prefetched_bucket = bbs.prepare_bucket(start_list)
+        to_add = None
+        pool = ThreadPool(1)
+
+        for l in range(start_list, end_list):
+            bbs.report(l)
+            prefetched_bucket_a = pool.apply_async(
+                add_results_and_prefetch, (to_add, l + 1))
+            q_subset, xq_l, list_ids, xb_l = prefetched_bucket
+            bbs.start_t_accu()
+            D, I = comp.block_search(xq_l, xb_l, list_ids, k)
+            bbs.stop_t_accu(2)
+            to_add = q_subset, D, list_ids, I
+            bbs.start_t_accu()
+            prefetched_bucket = prefetched_bucket_a.get()
+            bbs.stop_t_accu(4)
+
+        bbs.add_results_to_heap(*to_add)
+        pool.close()
+    else:
+
+        def task_manager_thread(
+            task,
+            pool_size,
+            start_task,
+            end_task,
+            completed,
+            output_queue,
+            input_queue,
+        ):
+            try:
+                with ThreadPool(pool_size) as pool:
+                    res = [pool.apply_async(
+                        task,
+                        args=(i, output_queue, input_queue))
+                        for i in range(start_task, end_task)
+                        if i not in completed]
+                    for r in res:
+                        r.get()
+                    pool.close()
+                    pool.join()
+                output_queue.put(None)
+            except:
+                traceback.print_exc()
+                _thread.interrupt_main()
+                raise
+
+        def task_manager(*args):
+            task_manager = threading.Thread(
+                target=task_manager_thread,
+                args=args,
+            )
+            task_manager.daemon = True
+            task_manager.start()
+            return task_manager
+
+        def prepare_task(task_id, output_queue, input_queue=None):
+            try:
+                logging.info(f"Prepare start: {task_id}")
+                q_subset, xq_l, list_ids, xb_l = bbs.prepare_bucket(task_id)
+                output_queue.put((task_id, q_subset, xq_l, list_ids, xb_l))
+                logging.info(f"Prepare end: {task_id}")
+            except:
+                traceback.print_exc()
+                _thread.interrupt_main()
+                raise
+
+        def compute_task(task_id, output_queue, input_queue):
+            try:
+                logging.info(f"Compute start: {task_id}")
+                t_wait_out = 0
+                while True:
+                    t0 = time.time()
+                    logging.info(f'Compute input: task {task_id}')
+                    input_value = input_queue.get()
+                    t_wait_in = time.time() - t0
+                    if input_value is None:
+                        # signal for other compute tasks
+                        input_queue.put(None)
+                        break
+                    centroid, q_subset, xq_l, list_ids, xb_l = input_value
+                    logging.info(f'Compute work: task {task_id}, centroid {centroid}')
+                    t0 = time.time()
+                    if computation_threads > 1:
+                        D, I = comp.block_search(
+                            xq_l, xb_l, list_ids, k, thread_id=task_id
+                        )
+                    else:
+                        D, I = comp.block_search(xq_l, xb_l, list_ids, k)
+                    t_compute = time.time() - t0
+                    logging.info(f'Compute output: task {task_id}, centroid {centroid}')
+                    t0 = time.time()
+                    output_queue.put(
+                        (centroid, t_wait_in, t_wait_out, t_compute, q_subset, D, list_ids, I)
+                    )
+                    t_wait_out = time.time() - t0
+                logging.info(f"Compute end: {task_id}")
+            except:
+                traceback.print_exc()
+                _thread.interrupt_main()
+                raise
+
+        prepare_to_compute_queue = Queue(2)
+        compute_to_main_queue = Queue(2)
+        compute_task_manager = task_manager(
+            compute_task,
+            computation_threads,
+            0,
+            computation_threads,
+            set(),
+            compute_to_main_queue,
+            prepare_to_compute_queue,
+        )
+        prepare_task_manager = task_manager(
+            prepare_task,
+            prefetch_threads,
+            start_list,
+            end_list,
+            completed,
+            prepare_to_compute_queue,
+            None,
+        )
+
+        t_checkpoint = time.time()
+        while True:
+            logging.info("Waiting for result")
+            value = compute_to_main_queue.get()
+            if not value:
+                break
+            centroid, t_wait_in, t_wait_out, t_compute, q_subset, D, list_ids, I = value
+            # to test checkpointing
+            if centroid == crash_at:
+                1 / 0
+            bbs.t_accu[2] += t_compute
+            bbs.t_accu[4] += t_wait_in
+            bbs.t_accu[5] += t_wait_out
+            logging.info(f"Adding to heap start: centroid {centroid}")
+            bbs.add_results_to_heap(q_subset, D, list_ids, I)
+            logging.info(f"Adding to heap end: centroid {centroid}")
+            completed.add(centroid)
+            bbs.report(centroid)
+            if checkpoint is not None:
+                if time.time() - t_checkpoint > checkpoint_freq:
+                    logging.info("writing checkpoint")
+                    bbs.write_checkpoint(checkpoint, completed)
+                    t_checkpoint = time.time()
+
+        prepare_task_manager.join()
+        compute_task_manager.join()
+
+    bbs.tic("finalize heap")
+    bbs.rh.finalize()
+    bbs.toc()
+
+    return bbs.rh.D, bbs.rh.I
diff --git a/llm/Lib/site-packages/faiss/contrib/client_server.py b/llm/Lib/site-packages/faiss/contrib/client_server.py
new file mode 100644
index 0000000000000000000000000000000000000000..65b870908920554ea8b8365d82d3d06d864a151e
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/contrib/client_server.py
@@ -0,0 +1,91 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+from multiprocessing.pool import ThreadPool
+import faiss
+from typing import List, Tuple
+
+from . import rpc
+
+############################################################
+# Server implementation
+############################################################
+
+
+class SearchServer(rpc.Server):
+    """ Assign version that can be exposed via RPC """
+
+    def __init__(self, s: int, index: faiss.Index):
+        rpc.Server.__init__(self, s)
+        self.index = index
+        self.index_ivf = faiss.extract_index_ivf(index)
+
+    def set_nprobe(self, nprobe: int) -> int:
+        """ set nprobe field """
+        self.index_ivf.nprobe = nprobe
+
+    def get_ntotal(self) -> int:
+        return self.index.ntotal
+
+    def __getattr__(self, f):
+        # all other functions get forwarded to the index
+        return getattr(self.index, f)
+
+
+def run_index_server(index: faiss.Index, port: int, v6: bool = False):
+    """ serve requests for that index forerver """
+    rpc.run_server(
+        lambda s: SearchServer(s, index),
+        port, v6=v6)
+
+
+############################################################
+# Client implementation
+############################################################
+
+class ClientIndex:
+    """manages a set of distance sub-indexes. The sub_indexes search a
+    subset of the inverted lists. Searches are merged afterwards
+    """
+
+    def __init__(self, machine_ports: List[Tuple[str, int]], v6: bool = False):
+        """ connect to a series of (host, port) pairs """
+        self.sub_indexes = []
+        for machine, port in machine_ports:
+            self.sub_indexes.append(rpc.Client(machine, port, v6))
+
+        self.ni = len(self.sub_indexes)
+        # pool of threads. Each thread manages one sub-index.
+        self.pool = ThreadPool(self.ni)
+        # test connection...
+        self.ntotal = self.get_ntotal()
+        self.verbose = False
+
+    def set_nprobe(self, nprobe: int) -> None:
+        self.pool.map(
+            lambda idx: idx.set_nprobe(nprobe),
+            self.sub_indexes
+        )
+
+    def set_omp_num_threads(self, nt: int) -> None:
+        self.pool.map(
+            lambda idx: idx.set_omp_num_threads(nt),
+            self.sub_indexes
+        )
+
+    def get_ntotal(self) -> None:
+        return sum(self.pool.map(
+            lambda idx: idx.get_ntotal(),
+            self.sub_indexes
+        ))
+
+    def search(self, x, k: int):
+
+        rh = faiss.ResultHeap(x.shape[0], k)
+
+        for Di, Ii in self.pool.imap(lambda idx: idx.search(x, k), self.sub_indexes):
+            rh.add_result(Di, Ii)
+        rh.finalize()
+        return rh.D, rh.I
diff --git a/llm/Lib/site-packages/faiss/contrib/clustering.py b/llm/Lib/site-packages/faiss/contrib/clustering.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ffd03c150d42ed5e21b3c5c4ddaf855eed6afd6
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/contrib/clustering.py
@@ -0,0 +1,399 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+"""
+This contrib module contains a few routines useful to do clustering variants.
+"""
+
+import numpy as np
+import faiss
+import time
+from multiprocessing.pool import ThreadPool
+
+
+try:
+    import scipy.sparse
+except ImportError:
+    print("scipy not accessible, Python k-means will not work")
+
+def print_nop(*arg, **kwargs):
+    pass
+
+def two_level_clustering(xt, nc1, nc2, rebalance=True, clustering_niter=25, **args):
+    """
+    perform 2-level clustering on a training set xt
+    nc1 and nc2 are the number of clusters at each level, the final number of
+    clusters is nc2. Additional arguments are passed to the Kmeans object.
+
+    Rebalance allocates the number of sub-clusters depending on the number of
+    first-level assignment.
+    """
+    d = xt.shape[1]
+
+    verbose = args.get("verbose", False)
+
+    log = print if verbose else print_nop
+
+    log(f"2-level clustering of {xt.shape} nb 1st level clusters = {nc1} total {nc2}")
+    log("perform coarse training")
+
+    km = faiss.Kmeans(
+        d, nc1, niter=clustering_niter,
+        max_points_per_centroid=2000,
+        **args
+    )
+    km.train(xt)
+
+    iteration_stats = [km.iteration_stats]
+    log()
+
+    # coarse centroids
+    centroids1 = km.centroids
+
+    log("assigning the training set")
+    t0 = time.time()
+    _, assign1 = km.assign(xt)
+    bc = np.bincount(assign1, minlength=nc1)
+    log(f"done in {time.time() - t0:.2f} s. Sizes of clusters {min(bc)}-{max(bc)}")
+    o = assign1.argsort()
+    del km
+
+    if not rebalance:
+        # make sure the sub-clusters sum up to exactly nc2
+        cc = np.arange(nc1 + 1) * nc2 // nc1
+        all_nc2 = cc[1:] - cc[:-1]
+    else:
+        bc_sum = np.cumsum(bc)
+        all_nc2 = bc_sum * nc2 // bc_sum[-1]
+        all_nc2[1:] -= all_nc2[:-1]
+        assert sum(all_nc2) == nc2
+        log(f"nb 2nd-level centroids {min(all_nc2)}-{max(all_nc2)}")
+
+    # train sub-clusters
+    i0 = 0
+    c2 = []
+    t0 = time.time()
+    for c1 in range(nc1):
+        nc2 = int(all_nc2[c1])
+        log(f"[{time.time() - t0:.2f} s] training sub-cluster {c1}/{nc1} nc2={nc2}\r", end="", flush=True)
+        i1 = i0 + bc[c1]
+        subset = o[i0:i1]
+        assert np.all(assign1[subset] == c1)
+        km = faiss.Kmeans(d, nc2, **args)
+        xtsub = xt[subset]
+        km.train(xtsub)
+        iteration_stats.append(km.iteration_stats)
+        c2.append(km.centroids)
+        del km
+        i0 = i1
+    log(f"done in {time.time() - t0:.2f} s")
+    return np.vstack(c2), iteration_stats
+
+
+def train_ivf_index_with_2level(index, xt, **args):
+    """
+    Applies 2-level clustering to an index_ivf embedded in an index.
+    """
+    # handle PreTransforms
+    index = faiss.downcast_index(index)
+    if isinstance(index, faiss.IndexPreTransform):
+        for i in range(index.chain.size()):
+            vt = index.chain.at(i)
+            vt.train(xt)
+            xt = vt.apply(xt)
+        train_ivf_index_with_2level(index.index, xt, **args)
+        index.is_trained = True
+        return
+    assert isinstance(index, faiss.IndexIVF)
+    assert index.metric_type == faiss.METRIC_L2
+    # now do 2-level clustering
+    nc1 = int(np.sqrt(index.nlist))
+    print("REBALANCE=", args)
+
+    centroids, _ = two_level_clustering(xt, nc1, index.nlist, **args)
+    index.quantizer.train(centroids)
+    index.quantizer.add(centroids)
+    # finish training
+    index.train(xt)
+
+
+###############################################################################
+# K-means implementation in Python
+#
+# It relies on DatasetAssign, an abstraction of the training vectors that offers
+# the minimal set of operations to perform k-means clustering.
+###############################################################################
+
+
+class DatasetAssign:
+    """Wrapper for a matrix that offers a function to assign the vectors
+    to centroids. All other implementations offer the same interface"""
+
+    def __init__(self, x):
+        self.x = np.ascontiguousarray(x, dtype='float32')
+
+    def count(self):
+        return self.x.shape[0]
+
+    def dim(self):
+        return self.x.shape[1]
+
+    def get_subset(self, indices):
+        return self.x[indices]
+
+    def perform_search(self, centroids):
+        return faiss.knn(self.x, centroids, 1)
+
+    def assign_to(self, centroids, weights=None):
+        D, I = self.perform_search(centroids)
+
+        I = I.ravel()
+        D = D.ravel()
+        n = len(self.x)
+        if weights is None:
+            weights = np.ones(n, dtype='float32')
+        nc = len(centroids)
+        m = scipy.sparse.csc_matrix(
+            (weights, I, np.arange(n + 1)),
+            shape=(nc, n))
+        sum_per_centroid = m * self.x
+
+        return I, D, sum_per_centroid
+
+
+class DatasetAssignGPU(DatasetAssign):
+    """ GPU version of the previous """
+
+    def __init__(self, x, gpu_id, verbose=False):
+        DatasetAssign.__init__(self, x)
+        index = faiss.IndexFlatL2(x.shape[1])
+        if gpu_id >= 0:
+            self.index = faiss.index_cpu_to_gpu(
+                faiss.StandardGpuResources(),
+                gpu_id, index)
+        else:
+            # -1 -> assign to all GPUs
+            self.index = faiss.index_cpu_to_all_gpus(index)
+
+    def perform_search(self, centroids):
+        self.index.reset()
+        self.index.add(centroids)
+        return self.index.search(self.x, 1)
+
+
+def sparse_assign_to_dense(xq, xb, xq_norms=None, xb_norms=None):
+    """ assignment function for xq is sparse, xb is dense
+    uses a matrix multiplication. The squared norms can be provided if available.
+    """
+    nq = xq.shape[0]
+    nb = xb.shape[0]
+    if xb_norms is None:
+        xb_norms = (xb ** 2).sum(1)
+    if xq_norms is None:
+        xq_norms = np.array(xq.power(2).sum(1))
+    d2 =  xb_norms - 2 * xq @ xb.T
+    I = d2.argmin(axis=1)
+    D = d2.ravel()[I + np.arange(nq) * nb] + xq_norms.ravel()
+    return D, I
+
+
+def sparse_assign_to_dense_blocks(
+        xq, xb, xq_norms=None, xb_norms=None, qbs=16384, bbs=16384, nt=None):
+    """
+    decomposes the sparse_assign_to_dense function into blocks to avoid a
+    possible memory blow up. Can be run in multithreaded mode, because scipy's
+    sparse-dense matrix multiplication is single-threaded.
+    """
+    nq = xq.shape[0]
+    nb = xb.shape[0]
+    D = np.empty(nq, dtype="float32")
+    D.fill(np.inf)
+    I = -np.ones(nq, dtype=int)
+
+    if xb_norms is None:
+        xb_norms = (xb ** 2).sum(1)
+
+    def handle_query_block(i):
+        xq_block = xq[i : i + qbs]
+        Iblock = I[i : i + qbs]
+        Dblock = D[i : i + qbs]
+        if xq_norms is None:
+            xq_norms_block = np.array(xq_block.power(2).sum(1))
+        else:
+            xq_norms_block = xq_norms[i : i + qbs]
+        for j in range(0, nb, bbs):
+            Di, Ii = sparse_assign_to_dense(
+                xq_block,
+                xb[j : j + bbs],
+                xq_norms=xq_norms_block,
+                xb_norms=xb_norms[j : j + bbs],
+            )
+            if j == 0:
+                Iblock[:] = Ii
+                Dblock[:] = Di
+            else:
+                mask = Di < Dblock
+                Iblock[mask] = Ii[mask] + j
+                Dblock[mask] = Di[mask]
+
+    if nt == 0 or nt == 1 or nq <= qbs:
+        list(map(handle_query_block, range(0, nq, qbs)))
+    else:
+        pool = ThreadPool(nt)
+        pool.map(handle_query_block, range(0, nq, qbs))
+
+    return D, I
+
+
+class DatasetAssignSparse(DatasetAssign):
+    """Wrapper for a matrix that offers a function to assign the vectors
+    to centroids. All other implementations offer the same interface"""
+
+    def __init__(self, x):
+        assert x.__class__ == scipy.sparse.csr_matrix
+        self.x = x
+        self.squared_norms = np.array(x.power(2).sum(1))
+
+    def get_subset(self, indices):
+        return np.array(self.x[indices].todense())
+
+    def perform_search(self, centroids):
+        return sparse_assign_to_dense_blocks(
+            self.x, centroids, xq_norms=self.squared_norms)
+
+    def assign_to(self, centroids, weights=None):
+        D, I = self.perform_search(centroids)
+
+        I = I.ravel()
+        D = D.ravel()
+        n = self.x.shape[0]
+        if weights is None:
+            weights = np.ones(n, dtype='float32')
+        nc = len(centroids)
+        m = scipy.sparse.csc_matrix(
+            (weights, I, np.arange(n + 1)),
+            shape=(nc, n))
+        sum_per_centroid = np.array((m * self.x).todense())
+
+        return I, D, sum_per_centroid
+
+
+def imbalance_factor(k, assign):
+    assign = np.ascontiguousarray(assign, dtype='int64')
+    return faiss.imbalance_factor(len(assign), k, faiss.swig_ptr(assign))
+
+
+def reassign_centroids(hassign, centroids, rs=None):
+    """ reassign centroids when some of them collapse """
+    if rs is None:
+        rs = np.random
+    k, d = centroids.shape
+    nsplit = 0
+    empty_cents = np.where(hassign == 0)[0]
+
+    if empty_cents.size == 0:
+        return 0
+
+    fac = np.ones(d)
+    fac[::2] += 1 / 1024.
+    fac[1::2] -= 1 / 1024.
+
+    # this is a single pass unless there are more than k/2
+    # empty centroids
+    while empty_cents.size > 0:
+        # choose which centroids to split
+        probas = hassign.astype('float') - 1
+        probas[probas < 0] = 0
+        probas /= probas.sum()
+        nnz = (probas > 0).sum()
+
+        nreplace = min(nnz, empty_cents.size)
+        cjs = rs.choice(k, size=nreplace, p=probas)
+
+        for ci, cj in zip(empty_cents[:nreplace], cjs):
+
+            c = centroids[cj]
+            centroids[ci] = c * fac
+            centroids[cj] = c / fac
+
+            hassign[ci] = hassign[cj] // 2
+            hassign[cj] -= hassign[ci]
+            nsplit += 1
+
+        empty_cents = empty_cents[nreplace:]
+
+    return nsplit
+
+
+def kmeans(k, data, niter=25, seed=1234, checkpoint=None, verbose=True,
+           return_stats=False):
+    """Pure python kmeans implementation. Follows the Faiss C++ version
+    quite closely, but takes a DatasetAssign instead of a training data
+    matrix. Also redo is not implemented. """
+    n, d = data.count(), data.dim()
+
+    log = print if verbose else print_nop
+
+    log(("Clustering %d points in %dD to %d clusters, " +
+            "%d iterations seed %d") % (n, d, k, niter, seed))
+
+    rs = np.random.RandomState(seed)
+    print("preproc...")
+    t0 = time.time()
+    # initialization
+    perm = rs.choice(n, size=k, replace=False)
+    centroids = data.get_subset(perm)
+
+    iteration_stats = []
+
+    log("  done")
+    t_search_tot = 0
+    obj = []
+    for i in range(niter):
+        t0s = time.time()
+
+        log('assigning', end='\r', flush=True)
+        assign, D, sums = data.assign_to(centroids)
+
+        log('compute centroids', end='\r', flush=True)
+
+        t_search_tot += time.time() - t0s;
+
+        err = D.sum()
+        obj.append(err)
+
+        hassign = np.bincount(assign, minlength=k)
+
+        fac = hassign.reshape(-1, 1).astype('float32')
+        fac[fac == 0] = 1 # quiet warning
+
+        centroids = sums / fac
+
+        nsplit = reassign_centroids(hassign, centroids, rs)
+
+        s = {
+            "obj": err,
+            "time": (time.time() - t0),
+            "time_search": t_search_tot,
+            "imbalance_factor": imbalance_factor (k, assign),
+            "nsplit": nsplit
+        }
+
+        log(("  Iteration %d (%.2f s, search %.2f s): "
+             "objective=%g imbalance=%.3f nsplit=%d") % (
+                   i, s["time"], s["time_search"],
+                   err, s["imbalance_factor"],
+                   nsplit)
+        )
+        iteration_stats.append(s)
+
+        if checkpoint is not None:
+            log('storing centroids in', checkpoint)
+            np.save(checkpoint, centroids)
+
+    if return_stats:
+        return centroids, iteration_stats
+    else:
+        return centroids
diff --git a/llm/Lib/site-packages/faiss/contrib/datasets.py b/llm/Lib/site-packages/faiss/contrib/datasets.py
new file mode 100644
index 0000000000000000000000000000000000000000..a632baa34646ee37aa418d232b6fb611c1b8dd1c
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/contrib/datasets.py
@@ -0,0 +1,378 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+import os
+import numpy as np
+import faiss
+
+from .vecs_io import fvecs_read, ivecs_read, bvecs_mmap, fvecs_mmap
+from .exhaustive_search import knn
+
+class Dataset:
+    """ Generic abstract class for a test dataset """
+
+    def __init__(self):
+        """ the constructor should set the following fields: """
+        self.d = -1
+        self.metric = 'L2'   # or IP
+        self.nq = -1
+        self.nb = -1
+        self.nt = -1
+
+    def get_queries(self):
+        """ return the queries as a (nq, d) array """
+        raise NotImplementedError()
+
+    def get_train(self, maxtrain=None):
+        """ return the queries as a (nt, d) array """
+        raise NotImplementedError()
+
+    def get_database(self):
+        """ return the queries as a (nb, d) array """
+        raise NotImplementedError()
+
+    def database_iterator(self, bs=128, split=(1, 0)):
+        """returns an iterator on database vectors.
+        bs is the number of vectors per batch
+        split = (nsplit, rank) means the dataset is split in nsplit
+        shards and we want shard number rank
+        The default implementation just iterates over the full matrix
+        returned by get_dataset.
+        """
+        xb = self.get_database()
+        nsplit, rank = split
+        i0, i1 = self.nb * rank // nsplit, self.nb * (rank + 1) // nsplit
+        for j0 in range(i0, i1, bs):
+            yield xb[j0: min(j0 + bs, i1)]
+
+    def get_groundtruth(self, k=None):
+        """ return the ground truth for k-nearest neighbor search """
+        raise NotImplementedError()
+
+    def get_groundtruth_range(self, thresh=None):
+        """ return the ground truth for range search """
+        raise NotImplementedError()
+
+    def __str__(self):
+        return (f"dataset in dimension {self.d}, with metric {self.metric}, "
+                f"size: Q {self.nq} B {self.nb} T {self.nt}")
+
+    def check_sizes(self):
+        """ runs the previous and checks the sizes of the matrices """
+        assert self.get_queries().shape == (self.nq, self.d)
+        if self.nt > 0:
+            xt = self.get_train(maxtrain=123)
+            assert xt.shape == (123, self.d), "shape=%s" % (xt.shape, )
+        assert self.get_database().shape == (self.nb, self.d)
+        assert self.get_groundtruth(k=13).shape == (self.nq, 13)
+
+
+class SyntheticDataset(Dataset):
+    """A dataset that is not completely random but still challenging to
+    index
+    """
+
+    def __init__(self, d, nt, nb, nq, metric='L2', seed=1338):
+        Dataset.__init__(self)
+        self.d, self.nt, self.nb, self.nq = d, nt, nb, nq
+        d1 = 10     # intrinsic dimension (more or less)
+        n = nb + nt + nq
+        rs = np.random.RandomState(seed)
+        x = rs.normal(size=(n, d1))
+        x = np.dot(x, rs.rand(d1, d))
+        # now we have a d1-dim ellipsoid in d-dimensional space
+        # higher factor (>4) -> higher frequency -> less linear
+        x = x * (rs.rand(d) * 4 + 0.1)
+        x = np.sin(x)
+        x = x.astype('float32')
+        self.metric = metric
+        self.xt = x[:nt]
+        self.xb = x[nt:nt + nb]
+        self.xq = x[nt + nb:]
+
+    def get_queries(self):
+        return self.xq
+
+    def get_train(self, maxtrain=None):
+        maxtrain = maxtrain if maxtrain is not None else self.nt
+        return self.xt[:maxtrain]
+
+    def get_database(self):
+        return self.xb
+
+    def get_groundtruth(self, k=100):
+        return knn(
+            self.xq, self.xb, k,
+            faiss.METRIC_L2 if self.metric == 'L2' else faiss.METRIC_INNER_PRODUCT
+        )[1]
+
+
+############################################################################
+# The following datasets are a few standard open-source datasets
+# they should be stored in a directory, and we start by guessing where
+# that directory is
+############################################################################
+
+
+for dataset_basedir in (
+        '/datasets01/simsearch/041218/',
+        '/mnt/vol/gfsai-flash3-east/ai-group/datasets/simsearch/'):
+    if os.path.exists(dataset_basedir):
+        break
+else:
+    # users can link their data directory to `./data`
+    dataset_basedir = 'data/'
+
+
+class DatasetSIFT1M(Dataset):
+    """
+    The original dataset is available at: http://corpus-texmex.irisa.fr/
+    (ANN_SIFT1M)
+    """
+
+    def __init__(self):
+        Dataset.__init__(self)
+        self.d, self.nt, self.nb, self.nq = 128, 100000, 1000000, 10000
+        self.basedir = dataset_basedir + 'sift1M/'
+
+    def get_queries(self):
+        return fvecs_read(self.basedir + "sift_query.fvecs")
+
+    def get_train(self, maxtrain=None):
+        maxtrain = maxtrain if maxtrain is not None else self.nt
+        return fvecs_read(self.basedir + "sift_learn.fvecs")[:maxtrain]
+
+    def get_database(self):
+        return fvecs_read(self.basedir + "sift_base.fvecs")
+
+    def get_groundtruth(self, k=None):
+        gt = ivecs_read(self.basedir + "sift_groundtruth.ivecs")
+        if k is not None:
+            assert k <= 100
+            gt = gt[:, :k]
+        return gt
+
+
+def sanitize(x):
+    return np.ascontiguousarray(x, dtype='float32')
+
+
+class DatasetBigANN(Dataset):
+    """
+    The original dataset is available at: http://corpus-texmex.irisa.fr/
+    (ANN_SIFT1B)
+    """
+
+    def __init__(self, nb_M=1000):
+        Dataset.__init__(self)
+        assert nb_M in (1, 2, 5, 10, 20, 50, 100, 200, 500, 1000)
+        self.nb_M = nb_M
+        nb = nb_M * 10**6
+        self.d, self.nt, self.nb, self.nq = 128, 10**8, nb, 10000
+        self.basedir = dataset_basedir + 'bigann/'
+
+    def get_queries(self):
+        return sanitize(bvecs_mmap(self.basedir + 'bigann_query.bvecs')[:])
+
+    def get_train(self, maxtrain=None):
+        maxtrain = maxtrain if maxtrain is not None else self.nt
+        return sanitize(bvecs_mmap(self.basedir + 'bigann_learn.bvecs')[:maxtrain])
+
+    def get_groundtruth(self, k=None):
+        gt = ivecs_read(self.basedir + 'gnd/idx_%dM.ivecs' % self.nb_M)
+        if k is not None:
+            assert k <= 100
+            gt = gt[:, :k]
+        return gt
+
+    def get_database(self):
+        assert self.nb_M < 100, "dataset too large, use iterator"
+        return sanitize(bvecs_mmap(self.basedir + 'bigann_base.bvecs')[:self.nb])
+
+    def database_iterator(self, bs=128, split=(1, 0)):
+        xb = bvecs_mmap(self.basedir + 'bigann_base.bvecs')
+        nsplit, rank = split
+        i0, i1 = self.nb * rank // nsplit, self.nb * (rank + 1) // nsplit
+        for j0 in range(i0, i1, bs):
+            yield sanitize(xb[j0: min(j0 + bs, i1)])
+
+
+class DatasetDeep1B(Dataset):
+    """
+    See
+    https://github.com/facebookresearch/faiss/tree/main/benchs#getting-deep1b
+    on how to get the data
+    """
+
+    def __init__(self, nb=10**9):
+        Dataset.__init__(self)
+        nb_to_name = {
+            10**5: '100k',
+            10**6: '1M',
+            10**7: '10M',
+            10**8: '100M',
+            10**9: '1B'
+        }
+        assert nb in nb_to_name
+        self.d, self.nt, self.nb, self.nq = 96, 358480000, nb, 10000
+        self.basedir = dataset_basedir + 'deep1b/'
+        self.gt_fname = "%sdeep%s_groundtruth.ivecs" % (
+            self.basedir, nb_to_name[self.nb])
+
+    def get_queries(self):
+        return sanitize(fvecs_read(self.basedir + "deep1B_queries.fvecs"))
+
+    def get_train(self, maxtrain=None):
+        maxtrain = maxtrain if maxtrain is not None else self.nt
+        return sanitize(fvecs_mmap(self.basedir + "learn.fvecs")[:maxtrain])
+
+    def get_groundtruth(self, k=None):
+        gt = ivecs_read(self.gt_fname)
+        if k is not None:
+            assert k <= 100
+            gt = gt[:, :k]
+        return gt
+
+    def get_database(self):
+        assert self.nb <= 10**8, "dataset too large, use iterator"
+        return sanitize(fvecs_mmap(self.basedir + "base.fvecs")[:self.nb])
+
+    def database_iterator(self, bs=128, split=(1, 0)):
+        xb = fvecs_mmap(self.basedir + "base.fvecs")
+        nsplit, rank = split
+        i0, i1 = self.nb * rank // nsplit, self.nb * (rank + 1) // nsplit
+        for j0 in range(i0, i1, bs):
+            yield sanitize(xb[j0: min(j0 + bs, i1)])
+
+
+class DatasetGlove(Dataset):
+    """
+    Data from http://ann-benchmarks.com/glove-100-angular.hdf5
+    """
+
+    def __init__(self, loc=None, download=False):
+        import h5py
+        assert not download, "not implemented"
+        if not loc:
+            loc = dataset_basedir + 'glove/glove-100-angular.hdf5'
+        self.glove_h5py = h5py.File(loc, 'r')
+        # IP and L2 are equivalent in this case, but it is traditionally seen as an IP dataset
+        self.metric = 'IP'
+        self.d, self.nt = 100, 0
+        self.nb = self.glove_h5py['train'].shape[0]
+        self.nq = self.glove_h5py['test'].shape[0]
+
+    def get_queries(self):
+        xq = np.array(self.glove_h5py['test'])
+        faiss.normalize_L2(xq)
+        return xq
+
+    def get_database(self):
+        xb = np.array(self.glove_h5py['train'])
+        faiss.normalize_L2(xb)
+        return xb
+
+    def get_groundtruth(self, k=None):
+        gt = self.glove_h5py['neighbors']
+        if k is not None:
+            assert k <= 100
+            gt = gt[:, :k]
+        return gt
+
+
+class DatasetMusic100(Dataset):
+    """
+    get dataset from
+    https://github.com/stanis-morozov/ip-nsw#dataset
+    """
+
+    def __init__(self):
+        Dataset.__init__(self)
+        self.d, self.nt, self.nb, self.nq = 100, 0, 10**6, 10000
+        self.metric = 'IP'
+        self.basedir = dataset_basedir + 'music-100/'
+
+    def get_queries(self):
+        xq = np.fromfile(self.basedir + 'query_music100.bin', dtype='float32')
+        xq = xq.reshape(-1, 100)
+        return xq
+
+    def get_database(self):
+        xb = np.fromfile(self.basedir + 'database_music100.bin', dtype='float32')
+        xb = xb.reshape(-1, 100)
+        return xb
+
+    def get_groundtruth(self, k=None):
+        gt = np.load(self.basedir + 'gt.npy')
+        if k is not None:
+            assert k <= 100
+            gt = gt[:, :k]
+        return gt
+
+class DatasetGIST1M(Dataset):
+    """
+    The original dataset is available at: http://corpus-texmex.irisa.fr/
+    (ANN_SIFT1M)
+    """
+
+    def __init__(self):
+        Dataset.__init__(self)
+        self.d, self.nt, self.nb, self.nq = 960, 100000, 1000000, 10000
+        self.basedir = dataset_basedir + 'gist1M/'
+
+    def get_queries(self):
+        return fvecs_read(self.basedir + "gist_query.fvecs")
+
+    def get_train(self, maxtrain=None):
+        maxtrain = maxtrain if maxtrain is not None else self.nt
+        return fvecs_read(self.basedir + "gist_learn.fvecs")[:maxtrain]
+
+    def get_database(self):
+        return fvecs_read(self.basedir + "gist_base.fvecs")
+
+    def get_groundtruth(self, k=None):
+        gt = ivecs_read(self.basedir + "gist_groundtruth.ivecs")
+        if k is not None:
+            assert k <= 100
+            gt = gt[:, :k]
+        return gt
+
+
+def dataset_from_name(dataset='deep1M', download=False):
+    """ converts a string describing a dataset to a Dataset object
+    Supports sift1M, bigann1M..bigann1B, deep1M..deep1B, music-100 and glove
+    """
+
+    if dataset == 'sift1M':
+        return DatasetSIFT1M()
+
+    elif dataset == 'gist1M':
+        return DatasetGIST1M()
+
+    elif dataset.startswith('bigann'):
+        dbsize = 1000 if dataset == "bigann1B" else int(dataset[6:-1])
+        return DatasetBigANN(nb_M=dbsize)
+
+    elif dataset.startswith("deep"):
+
+        szsuf = dataset[4:]
+        if szsuf[-1] == 'M':
+            dbsize = 10 ** 6 * int(szsuf[:-1])
+        elif szsuf == '1B':
+            dbsize = 10 ** 9
+        elif szsuf[-1] == 'k':
+            dbsize = 1000 * int(szsuf[:-1])
+        else:
+            assert False, "did not recognize suffix " + szsuf
+        return DatasetDeep1B(nb=dbsize)
+
+    elif dataset == "music-100":
+        return DatasetMusic100()
+
+    elif dataset == "glove":
+        return DatasetGlove(download=download)
+
+    else:
+        raise RuntimeError("unknown dataset " + dataset)
diff --git a/llm/Lib/site-packages/faiss/contrib/evaluation.py b/llm/Lib/site-packages/faiss/contrib/evaluation.py
new file mode 100644
index 0000000000000000000000000000000000000000..63c1cd636f3f62f36191cf7f8b3495ed72fb65f1
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/contrib/evaluation.py
@@ -0,0 +1,492 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+import numpy as np
+import unittest
+import time
+import faiss
+
+from multiprocessing.pool import ThreadPool
+
+###############################################################
+# Simple functions to evaluate knn results
+
+def knn_intersection_measure(I1, I2):
+    """ computes the intersection measure of two result tables
+    """
+    nq, rank = I1.shape
+    assert I2.shape == (nq, rank)
+    ninter = sum(
+        np.intersect1d(I1[i], I2[i]).size
+        for i in range(nq)
+    )
+    return ninter / I1.size
+
+###############################################################
+# Range search results can be compared with Precision-Recall
+
+def filter_range_results(lims, D, I, thresh):
+    """ select a set of results """
+    nq = lims.size - 1
+    mask = D < thresh
+    new_lims = np.zeros_like(lims)
+    for i in range(nq):
+        new_lims[i + 1] = new_lims[i] + mask[lims[i] : lims[i + 1]].sum()
+    return new_lims, D[mask], I[mask]
+
+
+def range_PR(lims_ref, Iref, lims_new, Inew, mode="overall"):
+    """compute the precision and recall of range search results. The
+    function does not take the distances into account. """
+
+    def ref_result_for(i):
+        return Iref[lims_ref[i]:lims_ref[i + 1]]
+
+    def new_result_for(i):
+        return Inew[lims_new[i]:lims_new[i + 1]]
+
+    nq = lims_ref.size - 1
+    assert lims_new.size - 1 == nq
+
+    ninter = np.zeros(nq, dtype="int64")
+
+    def compute_PR_for(q):
+
+        # ground truth results for this query
+        gt_ids = ref_result_for(q)
+
+        # results for this query
+        new_ids = new_result_for(q)
+
+        # there are no set functions in numpy so let's do this
+        inter = np.intersect1d(gt_ids, new_ids)
+
+        ninter[q] = len(inter)
+
+    # run in a thread pool, which helps in spite of the GIL
+    pool = ThreadPool(20)
+    pool.map(compute_PR_for, range(nq))
+
+    return counts_to_PR(
+        lims_ref[1:] - lims_ref[:-1],
+        lims_new[1:] - lims_new[:-1],
+        ninter,
+        mode=mode
+    )
+
+
+def counts_to_PR(ngt, nres, ninter, mode="overall"):
+    """ computes a  precision-recall for a ser of queries.
+    ngt = nb of GT results per query
+    nres = nb of found results per query
+    ninter = nb of correct results per query (smaller than nres of course)
+    """
+
+    if mode == "overall":
+        ngt, nres, ninter = ngt.sum(), nres.sum(), ninter.sum()
+
+        if nres > 0:
+            precision = ninter / nres
+        else:
+            precision = 1.0
+
+        if ngt > 0:
+            recall = ninter / ngt
+        elif nres == 0:
+            recall = 1.0
+        else:
+            recall = 0.0
+
+        return precision, recall
+
+    elif mode == "average":
+        # average precision and recall over queries
+
+        mask = ngt == 0
+        ngt[mask] = 1
+
+        recalls = ninter / ngt
+        recalls[mask] = (nres[mask] == 0).astype(float)
+
+        # avoid division by 0
+        mask = nres == 0
+        assert np.all(ninter[mask] == 0)
+        ninter[mask] = 1
+        nres[mask] = 1
+
+        precisions = ninter / nres
+
+        return precisions.mean(), recalls.mean()
+
+    else:
+        raise AssertionError()
+
+def sort_range_res_2(lims, D, I):
+    """ sort 2 arrays using the first as key """
+    I2 = np.empty_like(I)
+    D2 = np.empty_like(D)
+    nq = len(lims) - 1
+    for i in range(nq):
+        l0, l1 = lims[i], lims[i + 1]
+        ii = I[l0:l1]
+        di = D[l0:l1]
+        o = di.argsort()
+        I2[l0:l1] = ii[o]
+        D2[l0:l1] = di[o]
+    return I2, D2
+
+
+def sort_range_res_1(lims, I):
+    I2 = np.empty_like(I)
+    nq = len(lims) - 1
+    for i in range(nq):
+        l0, l1 = lims[i], lims[i + 1]
+        I2[l0:l1] = I[l0:l1]
+        I2[l0:l1].sort()
+    return I2
+
+
+def range_PR_multiple_thresholds(
+            lims_ref, Iref,
+            lims_new, Dnew, Inew,
+            thresholds,
+            mode="overall", do_sort="ref,new"
+    ):
+    """ compute precision-recall values for range search results
+    for several thresholds on the "new" results.
+    This is to plot PR curves
+    """
+    # ref should be sorted by ids
+    if "ref" in do_sort:
+        Iref = sort_range_res_1(lims_ref, Iref)
+
+    # new should be sorted by distances
+    if "new" in do_sort:
+        Inew, Dnew = sort_range_res_2(lims_new, Dnew, Inew)
+
+    def ref_result_for(i):
+        return Iref[lims_ref[i]:lims_ref[i + 1]]
+
+    def new_result_for(i):
+        l0, l1 = lims_new[i], lims_new[i + 1]
+        return Inew[l0:l1], Dnew[l0:l1]
+
+    nq = lims_ref.size - 1
+    assert lims_new.size - 1 == nq
+
+    nt = len(thresholds)
+    counts = np.zeros((nq, nt, 3), dtype="int64")
+
+    def compute_PR_for(q):
+        gt_ids = ref_result_for(q)
+        res_ids, res_dis = new_result_for(q)
+
+        counts[q, :, 0] = len(gt_ids)
+
+        if res_dis.size == 0:
+            # the rest remains at 0
+            return
+
+        # which offsets we are interested in
+        nres= np.searchsorted(res_dis, thresholds)
+        counts[q, :, 1] = nres
+
+        if gt_ids.size == 0:
+            return
+
+        # find number of TPs at each stage in the result list
+        ii = np.searchsorted(gt_ids, res_ids)
+        ii[ii == len(gt_ids)] = -1
+        n_ok = np.cumsum(gt_ids[ii] == res_ids)
+
+        # focus on threshold points
+        n_ok = np.hstack(([0], n_ok))
+        counts[q, :, 2] = n_ok[nres]
+
+    pool = ThreadPool(20)
+    pool.map(compute_PR_for, range(nq))
+    # print(counts.transpose(2, 1, 0))
+
+    precisions = np.zeros(nt)
+    recalls = np.zeros(nt)
+    for t in range(nt):
+        p, r = counts_to_PR(
+                counts[:, t, 0], counts[:, t, 1], counts[:, t, 2],
+                mode=mode
+        )
+        precisions[t] = p
+        recalls[t] = r
+
+    return precisions, recalls
+
+
+###############################################################
+# Functions that compare search results with a reference result.
+# They are intended for use in tests
+
+def _cluster_tables_with_tolerance(tab1, tab2, thr):
+    """ for two tables, cluster them by merging values closer than thr.
+    Returns the cluster ids for each table element """
+    tab = np.hstack([tab1, tab2])
+    tab.sort()
+    n = len(tab)
+    diffs = np.ones(n)
+    diffs[1:] = tab[1:] - tab[:-1]
+    unique_vals = tab[diffs > thr]
+    idx1 = np.searchsorted(unique_vals, tab1, side='right') - 1
+    idx2 = np.searchsorted(unique_vals, tab2, side='right') - 1
+    return idx1, idx2
+
+
+def check_ref_knn_with_draws(Dref, Iref, Dnew, Inew, rtol=1e-5):
+    """ test that knn search results are identical, with possible ties.
+    Raise if not. """
+    np.testing.assert_allclose(Dref, Dnew, rtol=rtol)
+    # here we have to be careful because of draws
+    testcase = unittest.TestCase()   # because it makes nice error messages
+    for i in range(len(Iref)):
+        if np.all(Iref[i] == Inew[i]): # easy case
+            continue
+
+        # otherwise collect elements per distance
+        r = rtol * Dref[i].max()
+
+        DrefC, DnewC = _cluster_tables_with_tolerance(Dref[i], Dnew[i], r)
+
+        for dis in np.unique(DrefC):
+            if dis == DrefC[-1]:
+                continue
+            mask = DrefC == dis
+            testcase.assertEqual(set(Iref[i, mask]), set(Inew[i, mask]))
+
+
+def check_ref_range_results(Lref, Dref, Iref,
+                            Lnew, Dnew, Inew):
+    """ compare range search results wrt. a reference result,
+    throw if it fails """
+    np.testing.assert_array_equal(Lref, Lnew)
+    nq = len(Lref) - 1
+    for i in range(nq):
+        l0, l1 = Lref[i], Lref[i + 1]
+        Ii_ref = Iref[l0:l1]
+        Ii_new = Inew[l0:l1]
+        Di_ref = Dref[l0:l1]
+        Di_new = Dnew[l0:l1]
+        if np.all(Ii_ref == Ii_new): # easy
+            pass
+        else:
+            def sort_by_ids(I, D):
+                o = I.argsort()
+                return I[o], D[o]
+            # sort both
+            (Ii_ref, Di_ref) = sort_by_ids(Ii_ref, Di_ref)
+            (Ii_new, Di_new) = sort_by_ids(Ii_new, Di_new)
+            np.testing.assert_array_equal(Ii_ref, Ii_new)
+        np.testing.assert_array_almost_equal(Di_ref, Di_new, decimal=5)
+
+
+###############################################################
+# OperatingPoints functions
+# this is the Python version of the AutoTune object in C++
+
+class OperatingPoints:
+    """
+    Manages a set of search parameters with associated performance and time.
+    Keeps the Pareto optimal points.
+    """
+
+    def __init__(self):
+        # list of (key, perf, t)
+        self.operating_points = [
+            #  (self.do_nothing_key(), 0.0, 0.0)
+        ]
+        self.suboptimal_points = []
+
+    def compare_keys(self, k1, k2):
+        """ return -1 if k1 > k2, 1 if k2 > k1, 0 otherwise """
+        raise NotImplemented
+
+    def do_nothing_key(self):
+        """ parameters to say we do noting, takes 0 time and has 0 performance"""
+        raise NotImplemented
+
+    def is_pareto_optimal(self, perf_new, t_new):
+        for _, perf, t in self.operating_points:
+            if perf >= perf_new and t <= t_new:
+                return False
+        return True
+
+    def predict_bounds(self, key):
+        """ predicts the bound on time and performance """
+        min_time = 0.0
+        max_perf = 1.0
+        for key2, perf, t in self.operating_points + self.suboptimal_points:
+            cmp = self.compare_keys(key, key2)
+            if cmp > 0: # key2 > key
+                if t > min_time:
+                    min_time = t
+            if cmp < 0: # key2 < key
+                if perf < max_perf:
+                    max_perf = perf
+        return max_perf, min_time
+
+    def should_run_experiment(self, key):
+        (max_perf, min_time) = self.predict_bounds(key)
+        return self.is_pareto_optimal(max_perf, min_time)
+
+    def add_operating_point(self, key, perf, t):
+        if self.is_pareto_optimal(perf, t):
+            i = 0
+            # maybe it shadows some other operating point completely?
+            while i < len(self.operating_points):
+                op_Ls, perf2, t2 = self.operating_points[i]
+                if perf >= perf2 and t < t2:
+                    self.suboptimal_points.append(
+                        self.operating_points.pop(i))
+                else:
+                    i += 1
+            self.operating_points.append((key, perf, t))
+            return True
+        else:
+            self.suboptimal_points.append((key, perf, t))
+            return False
+
+
+class OperatingPointsWithRanges(OperatingPoints):
+    """
+    Set of parameters that are each picked from a discrete range of values.
+    An increase of each parameter is assumed to make the operation slower
+    and more accurate.
+    A key = int array of indices in the ordered set of parameters.
+    """
+
+    def __init__(self):
+        OperatingPoints.__init__(self)
+        # list of (name, values)
+        self.ranges = []
+
+    def add_range(self, name, values):
+        self.ranges.append((name, values))
+
+    def compare_keys(self, k1, k2):
+        if np.all(k1 >= k2):
+            return 1
+        if np.all(k2 >= k1):
+            return -1
+        return 0
+
+    def do_nothing_key(self):
+        return np.zeros(len(self.ranges), dtype=int)
+
+    def num_experiments(self):
+        return int(np.prod([len(values) for name, values in self.ranges]))
+
+    def sample_experiments(self, n_autotune, rs=np.random):
+        """ sample a set of experiments of max size n_autotune
+        (run all experiments in random order if n_autotune is 0)
+        """
+        assert n_autotune == 0 or n_autotune >= 2
+        totex = self.num_experiments()
+        rs = np.random.RandomState(123)
+        if n_autotune == 0 or totex < n_autotune:
+            experiments = rs.permutation(totex - 2)
+        else:
+            experiments = rs.choice(
+                totex - 2, size=n_autotune - 2, replace=False)
+
+        experiments = [0, totex - 1] + [int(cno) + 1 for cno in experiments]
+        return experiments
+
+    def cno_to_key(self, cno):
+        """Convert a sequential experiment number to a key"""
+        k = np.zeros(len(self.ranges), dtype=int)
+        for i, (name, values) in enumerate(self.ranges):
+            k[i] = cno % len(values)
+            cno //= len(values)
+        assert cno == 0
+        return k
+
+    def get_parameters(self, k):
+        """Convert a key to a dictionary with parameter values"""
+        return {
+            name: values[k[i]]
+            for i, (name, values) in enumerate(self.ranges)
+        }
+
+    def restrict_range(self, name, max_val):
+        """ remove too large values from a range"""
+        for name2, values in self.ranges:
+            if name == name2:
+                val2 = [v for v in values if v < max_val]
+                values[:] = val2
+                return
+        raise RuntimeError(f"parameter {name} not found")
+
+
+###############################################################
+# Timer object
+
+class TimerIter:
+    def __init__(self, timer):
+        self.ts = []
+        self.runs = timer.runs
+        self.timer = timer
+        if timer.nt >= 0:
+            faiss.omp_set_num_threads(timer.nt)
+
+    def __next__(self):
+        timer = self.timer
+        self.runs -= 1
+        self.ts.append(time.time())
+        total_time = self.ts[-1] - self.ts[0] if len(self.ts) >= 2 else 0
+        if self.runs == -1 or total_time > timer.max_secs:
+            if timer.nt >= 0:
+                faiss.omp_set_num_threads(timer.remember_nt)
+            ts = np.array(self.ts)
+            times = ts[1:] - ts[:-1]
+            if len(times) == timer.runs:
+                timer.times = times[timer.warmup :]
+            else:
+                # if timeout, we use all the runs
+                timer.times = times[:]
+            raise StopIteration
+
+class RepeatTimer:
+    """
+    This is yet another timer object. It is adapted to Faiss by
+    taking a number of openmp threads to set on input. It should be called
+    in an explicit loop as:
+
+    timer = RepeatTimer(warmup=1, nt=1, runs=6)
+
+    for _ in timer:
+        # perform operation
+
+    print(f"time={timer.get_ms():.1f} ± {timer.get_ms_std():.1f} ms")
+
+    the same timer can be re-used. In that case it is reset each time it
+    enters a loop. It focuses on ms-scale times because for second scale
+    it's usually less relevant to repeat the operation.
+    """
+    def __init__(self, warmup=0, nt=-1, runs=1, max_secs=np.inf):
+        assert warmup < runs
+        self.warmup = warmup
+        self.nt = nt
+        self.runs = runs
+        self.max_secs = max_secs
+        self.remember_nt = faiss.omp_get_max_threads()
+
+    def __iter__(self):
+        return TimerIter(self)
+
+    def ms(self):
+        return np.mean(self.times) * 1000
+
+    def ms_std(self):
+        return np.std(self.times) * 1000 if len(self.times) > 1 else 0.0
+
+    def nruns(self):
+        """ effective number of runs (may be lower than runs - warmup due to timeout)"""
+        return len(self.times)
diff --git a/llm/Lib/site-packages/faiss/contrib/exhaustive_search.py b/llm/Lib/site-packages/faiss/contrib/exhaustive_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..f6ca6d2d497ed2a9750d2d8ccf55469040611cfd
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/contrib/exhaustive_search.py
@@ -0,0 +1,362 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+import faiss
+import time
+import numpy as np
+
+import logging
+
+LOG = logging.getLogger(__name__)
+
+def knn_ground_truth(xq, db_iterator, k, metric_type=faiss.METRIC_L2):
+    """Computes the exact KNN search results for a dataset that possibly
+    does not fit in RAM but for which we have an iterator that
+    returns it block by block.
+    """
+    LOG.info("knn_ground_truth queries size %s k=%d" % (xq.shape, k))
+    t0 = time.time()
+    nq, d = xq.shape
+    keep_max = faiss.is_similarity_metric(metric_type)
+    rh = faiss.ResultHeap(nq, k, keep_max=keep_max)
+
+    index = faiss.IndexFlat(d, metric_type)
+    if faiss.get_num_gpus():
+        LOG.info('running on %d GPUs' % faiss.get_num_gpus())
+        index = faiss.index_cpu_to_all_gpus(index)
+
+    # compute ground-truth by blocks, and add to heaps
+    i0 = 0
+    for xbi in db_iterator:
+        ni = xbi.shape[0]
+        index.add(xbi)
+        D, I = index.search(xq, k)
+        I += i0
+        rh.add_result(D, I)
+        index.reset()
+        i0 += ni
+        LOG.info("%d db elements, %.3f s" % (i0, time.time() - t0))
+
+    rh.finalize()
+    LOG.info("GT time: %.3f s (%d vectors)" % (time.time() - t0, i0))
+
+    return rh.D, rh.I
+
+# knn function used to be here
+knn = faiss.knn
+
+
+
+
+def range_search_gpu(xq, r2, index_gpu, index_cpu, gpu_k=1024):
+    """GPU does not support range search, so we emulate it with
+    knn search + fallback to CPU index.
+
+    The index_cpu can either be:
+    - a CPU index that supports range search
+    - a numpy table, that will be used to construct a Flat index if needed.
+    - None. In that case, at most gpu_k results will be returned
+    """
+    nq, d = xq.shape
+    is_binary_index = isinstance(index_gpu, faiss.IndexBinary)
+    keep_max = faiss.is_similarity_metric(index_gpu.metric_type)
+    r2 = int(r2) if is_binary_index else float(r2)
+    k = min(index_gpu.ntotal, gpu_k)
+    LOG.debug(
+        f"GPU search {nq} queries with {k=:} {is_binary_index=:} {keep_max=:}")
+    t0 = time.time()
+    D, I = index_gpu.search(xq, k)
+    t1 = time.time() - t0
+    if is_binary_index:
+        assert d * 8 < 32768  # let's compact the distance matrix
+        D = D.astype('int16')
+    t2 = 0
+    lim_remain = None
+    if index_cpu is not None:
+        if not keep_max:
+            mask = D[:, k - 1] < r2
+        else:
+            mask = D[:, k - 1] > r2
+        if mask.sum() > 0:
+            LOG.debug("CPU search remain %d" % mask.sum())
+            t0 = time.time()
+            if isinstance(index_cpu, np.ndarray):
+                # then it in fact an array that we have to make flat
+                xb = index_cpu
+                if is_binary_index:
+                    index_cpu = faiss.IndexBinaryFlat(d * 8)
+                else:
+                    index_cpu = faiss.IndexFlat(d, index_gpu.metric_type)
+                index_cpu.add(xb)
+            lim_remain, D_remain, I_remain = index_cpu.range_search(xq[mask], r2)
+            if is_binary_index:
+                D_remain = D_remain.astype('int16')
+            t2 = time.time() - t0
+    LOG.debug("combine")
+    t0 = time.time()
+
+    CombinerRangeKNN = (
+        faiss.CombinerRangeKNNint16 if is_binary_index else
+        faiss.CombinerRangeKNNfloat
+    )
+
+    combiner = CombinerRangeKNN(nq, k, r2, keep_max)
+    if True:
+        sp = faiss.swig_ptr
+        combiner.I = sp(I)
+        combiner.D = sp(D)
+        # combiner.set_knn_result(sp(I), sp(D))
+        if lim_remain is not None:
+            combiner.mask = sp(mask)
+            combiner.D_remain = sp(D_remain)
+            combiner.lim_remain = sp(lim_remain.view("int64"))
+            combiner.I_remain = sp(I_remain)
+            # combiner.set_range_result(sp(mask), sp(lim_remain.view("int64")), sp(D_remain), sp(I_remain))
+        L_res = np.empty(nq + 1, dtype='int64')
+        combiner.compute_sizes(sp(L_res))
+        nres = L_res[-1]
+        D_res = np.empty(nres, dtype=D.dtype)
+        I_res = np.empty(nres, dtype='int64')
+        combiner.write_result(sp(D_res), sp(I_res))
+    else:
+        D_res, I_res = [], []
+        nr = 0
+        for i in range(nq):
+            if not mask[i]:
+                if index_gpu.metric_type == faiss.METRIC_L2:
+                    nv = (D[i, :] < r2).sum()
+                else:
+                    nv = (D[i, :] > r2).sum()
+                D_res.append(D[i, :nv])
+                I_res.append(I[i, :nv])
+            else:
+                l0, l1 = lim_remain[nr], lim_remain[nr + 1]
+                D_res.append(D_remain[l0:l1])
+                I_res.append(I_remain[l0:l1])
+                nr += 1
+        L_res = np.cumsum([0] + [len(di) for di in D_res])
+        D_res = np.hstack(D_res)
+        I_res = np.hstack(I_res)
+    t3 = time.time() - t0
+    LOG.debug(f"times {t1:.3f}s {t2:.3f}s {t3:.3f}s")
+    return L_res, D_res, I_res
+
+
+def range_ground_truth(xq, db_iterator, threshold, metric_type=faiss.METRIC_L2,
+                       shard=False, ngpu=-1):
+    """Computes the range-search search results for a dataset that possibly
+    does not fit in RAM but for which we have an iterator that
+    returns it block by block.
+    """
+    nq, d = xq.shape
+    t0 = time.time()
+    xq = np.ascontiguousarray(xq, dtype='float32')
+
+    index = faiss.IndexFlat(d, metric_type)
+    if ngpu == -1:
+        ngpu = faiss.get_num_gpus()
+    if ngpu:
+        LOG.info('running on %d GPUs' % ngpu)
+        co = faiss.GpuMultipleClonerOptions()
+        co.shard = shard
+        index_gpu = faiss.index_cpu_to_all_gpus(index, co=co, ngpu=ngpu)
+
+    # compute ground-truth by blocks
+    i0 = 0
+    D = [[] for _i in range(nq)]
+    I = [[] for _i in range(nq)]
+    for xbi in db_iterator:
+        ni = xbi.shape[0]
+        if ngpu > 0:
+            index_gpu.add(xbi)
+            lims_i, Di, Ii = range_search_gpu(xq, threshold, index_gpu, xbi)
+            index_gpu.reset()
+        else:
+            index.add(xbi)
+            lims_i, Di, Ii = index.range_search(xq, threshold)
+            index.reset()
+        Ii += i0
+        for j in range(nq):
+            l0, l1 = lims_i[j], lims_i[j + 1]
+            if l1 > l0:
+                D[j].append(Di[l0:l1])
+                I[j].append(Ii[l0:l1])
+        i0 += ni
+        LOG.info("%d db elements, %.3f s" % (i0, time.time() - t0))
+
+    empty_I = np.zeros(0, dtype='int64')
+    empty_D = np.zeros(0, dtype='float32')
+    # import pdb; pdb.set_trace()
+    D = [(np.hstack(i) if i != [] else empty_D) for i in D]
+    I = [(np.hstack(i) if i != [] else empty_I) for i in I]
+    sizes = [len(i) for i in I]
+    assert len(sizes) == nq
+    lims = np.zeros(nq + 1, dtype="uint64")
+    lims[1:] = np.cumsum(sizes)
+    return lims, np.hstack(D), np.hstack(I)
+
+
+def threshold_radius_nres(nres, dis, ids, thresh, keep_max=False):
+    """ select a set of results """
+    if keep_max:
+        mask = dis > thresh
+    else:
+        mask = dis < thresh
+    new_nres = np.zeros_like(nres)
+    o = 0
+    for i, nr in enumerate(nres):
+        nr = int(nr)   # avoid issues with int64 + uint64
+        new_nres[i] = mask[o:o + nr].sum()
+        o += nr
+    return new_nres, dis[mask], ids[mask]
+
+
+def threshold_radius(lims, dis, ids, thresh, keep_max=False):
+    """ restrict range-search results to those below a given radius """
+    if keep_max:
+        mask = dis > thresh
+    else:
+        mask = dis < thresh
+    new_lims = np.zeros_like(lims)
+    n = len(lims) - 1
+    for i in range(n):
+        l0, l1 = lims[i], lims[i + 1]
+        new_lims[i + 1] = new_lims[i] + mask[l0:l1].sum()
+    return new_lims, dis[mask], ids[mask]
+
+
+def apply_maxres(res_batches, target_nres, keep_max=False):
+    """find radius that reduces number of results to target_nres, and
+    applies it in-place to the result batches used in
+    range_search_max_results"""
+    alldis = np.hstack([dis for _, dis, _ in res_batches])
+    assert len(alldis) > target_nres
+    if keep_max:
+        alldis.partition(len(alldis) - target_nres - 1)
+        radius = alldis[-1 - target_nres]
+    else:
+        alldis.partition(target_nres)
+        radius = alldis[target_nres]
+
+    if alldis.dtype == 'float32':
+        radius = float(radius)
+    else:
+        radius = int(radius)
+    LOG.debug('   setting radius to %s' % radius)
+    totres = 0
+    for i, (nres, dis, ids) in enumerate(res_batches):
+        nres, dis, ids = threshold_radius_nres(
+            nres, dis, ids, radius, keep_max=keep_max)
+        totres += len(dis)
+        res_batches[i] = nres, dis, ids
+    LOG.debug('   updated previous results, new nb results %d' % totres)
+    return radius, totres
+
+
+def range_search_max_results(index, query_iterator, radius,
+                             max_results=None, min_results=None,
+                             shard=False, ngpu=0, clip_to_min=False):
+    """Performs a range search with many queries (given by an iterator)
+    and adjusts the threshold on-the-fly so that the total results
+    table does not grow larger than max_results.
+
+    If ngpu != 0, the function moves the index to this many GPUs to
+    speed up search.
+    """
+    # TODO: all result manipulations are in python, should move to C++ if perf
+    # critical
+    is_binary_index = isinstance(index, faiss.IndexBinary)
+
+    if min_results is None:
+        assert max_results is not None
+        min_results = int(0.8 * max_results)
+
+    if max_results is None:
+        assert min_results is not None
+        max_results = int(min_results * 1.5)
+
+    if ngpu == -1:
+        ngpu = faiss.get_num_gpus()
+
+    if ngpu:
+        LOG.info('running on %d GPUs' % ngpu)
+        co = faiss.GpuMultipleClonerOptions()
+        co.shard = shard
+        index_gpu = faiss.index_cpu_to_all_gpus(index, co=co, ngpu=ngpu)
+    else:
+        index_gpu = None
+
+    t_start = time.time()
+    t_search = t_post_process = 0
+    qtot = totres = raw_totres = 0
+    res_batches = []
+
+    for xqi in query_iterator:
+        t0 = time.time()
+        LOG.debug(f"searching {len(xqi)} vectors")
+        if index_gpu:
+            lims_i, Di, Ii = range_search_gpu(xqi, radius, index_gpu, index)
+        else:
+            lims_i, Di, Ii = index.range_search(xqi, radius)
+
+        nres_i = lims_i[1:] - lims_i[:-1]
+        raw_totres += len(Di)
+        qtot += len(xqi)
+
+        t1 = time.time()
+        if is_binary_index:
+            # weird Faiss quirk that returns floats for Hamming distances
+            Di = Di.astype('int16')
+
+        totres += len(Di)
+        res_batches.append((nres_i, Di, Ii))
+
+        if max_results is not None and totres > max_results:
+            LOG.info('too many results %d > %d, scaling back radius' %
+                     (totres, max_results))
+            radius, totres = apply_maxres(
+                res_batches, min_results,
+                keep_max=index.metric_type == faiss.METRIC_INNER_PRODUCT
+            )
+        t2 = time.time()
+        t_search += t1 - t0
+        t_post_process += t2 - t1
+        LOG.debug('   [%.3f s] %d queries done, %d results' % (
+            time.time() - t_start, qtot, totres))
+
+    LOG.info(
+        'search done in %.3f s + %.3f s, total %d results, end threshold %g' % (
+            t_search, t_post_process, totres, radius)
+    )
+
+    if clip_to_min and totres > min_results:
+        radius, totres = apply_maxres(
+            res_batches, min_results,
+            keep_max=index.metric_type == faiss.METRIC_INNER_PRODUCT
+        )
+
+    nres = np.hstack([nres_i for nres_i, dis_i, ids_i in res_batches])
+    dis = np.hstack([dis_i for nres_i, dis_i, ids_i in res_batches])
+    ids = np.hstack([ids_i for nres_i, dis_i, ids_i in res_batches])
+
+    lims = np.zeros(len(nres) + 1, dtype='uint64')
+    lims[1:] = np.cumsum(nres)
+
+    return radius, lims, dis, ids
+
+
+def exponential_query_iterator(xq, start_bs=32, max_bs=20000):
+    """ produces batches of progressively increasing sizes. This is useful to
+    adjust the search radius progressively without overflowing with
+    intermediate results """
+    nq = len(xq)
+    bs = start_bs
+    i = 0
+    while i < nq:
+        xqi = xq[i:i + bs]
+        yield xqi
+        if bs < max_bs:
+            bs *= 2
+        i += len(xqi)
diff --git a/llm/Lib/site-packages/faiss/contrib/factory_tools.py b/llm/Lib/site-packages/faiss/contrib/factory_tools.py
new file mode 100644
index 0000000000000000000000000000000000000000..45296524edda835d875e2bcc4e6ffd1208b9b080
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/contrib/factory_tools.py
@@ -0,0 +1,146 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+import faiss
+import re
+
+
+def get_code_size(d, indexkey):
+    """ size of one vector in an index in dimension d
+    constructed with factory string indexkey"""
+
+    if indexkey == "Flat":
+        return d * 4
+
+    if indexkey.endswith(",RFlat"):
+        return d * 4 + get_code_size(d, indexkey[:-len(",RFlat")])
+
+    mo = re.match("IVF\\d+(_HNSW32)?,(.*)$", indexkey)
+    if mo:
+        return get_code_size(d, mo.group(2))
+
+    mo = re.match("IVF\\d+\\(.*\\)?,(.*)$", indexkey)
+    if mo:
+        return get_code_size(d, mo.group(1))
+
+    mo = re.match("IMI\\d+x2,(.*)$", indexkey)
+    if mo:
+        return get_code_size(d, mo.group(1))
+
+    mo = re.match("(.*),Refine\\((.*)\\)$", indexkey)
+    if mo:
+        return get_code_size(d, mo.group(1)) + get_code_size(d, mo.group(2))
+
+    mo = re.match('PQ(\\d+)x(\\d+)(fs|fsr)?$', indexkey)
+    if mo:
+        return (int(mo.group(1)) * int(mo.group(2)) + 7) // 8
+
+    mo = re.match('PQ(\\d+)\\+(\\d+)$', indexkey)
+    if mo:
+        return (int(mo.group(1)) + int(mo.group(2)))
+
+    mo = re.match('PQ(\\d+)$', indexkey)
+    if mo:
+        return int(mo.group(1))
+
+    if indexkey == "HNSW32" or indexkey == "HNSW32,Flat":
+        return d * 4 + 64 * 4 # roughly
+
+    if indexkey == 'SQ8':
+        return d
+    elif indexkey == 'SQ4':
+        return (d + 1) // 2
+    elif indexkey == 'SQ6':
+        return (d * 6 + 7) // 8
+    elif indexkey == 'SQfp16':
+        return d * 2
+
+    mo = re.match('PCAR?(\\d+),(.*)$', indexkey)
+    if mo:
+        return get_code_size(int(mo.group(1)), mo.group(2))
+    mo = re.match('OPQ\\d+_(\\d+),(.*)$', indexkey)
+    if mo:
+        return get_code_size(int(mo.group(1)), mo.group(2))
+    mo = re.match('OPQ\\d+,(.*)$', indexkey)
+    if mo:
+        return get_code_size(d, mo.group(1))
+    mo = re.match('RR(\\d+),(.*)$', indexkey)
+    if mo:
+        return get_code_size(int(mo.group(1)), mo.group(2))
+    raise RuntimeError("cannot parse " + indexkey)
+
+
+def get_hnsw_M(index):
+    return index.hnsw.cum_nneighbor_per_level.at(1) // 2
+
+
+def reverse_index_factory(index):
+    """
+    attempts to get the factory string the index was built with
+    """
+    index = faiss.downcast_index(index)
+    if isinstance(index, faiss.IndexFlat):
+        return "Flat"
+    elif isinstance(index, faiss.IndexIVF):
+        quantizer = faiss.downcast_index(index.quantizer)
+
+        if isinstance(quantizer, faiss.IndexFlat):
+            prefix = f"IVF{index.nlist}"
+        elif isinstance(quantizer, faiss.MultiIndexQuantizer):
+            prefix = f"IMI{quantizer.pq.M}x{quantizer.pq.nbits}"
+        elif isinstance(quantizer, faiss.IndexHNSW):
+            prefix = f"IVF{index.nlist}_HNSW{get_hnsw_M(quantizer)}"
+        else:
+            prefix = f"IVF{index.nlist}({reverse_index_factory(quantizer)})"
+
+        if isinstance(index, faiss.IndexIVFFlat):
+            return prefix + ",Flat"
+        if isinstance(index, faiss.IndexIVFScalarQuantizer):
+            return prefix + ",SQ8"
+        if isinstance(index, faiss.IndexIVFPQ):
+            return prefix + f",PQ{index.pq.M}x{index.pq.nbits}"
+        if isinstance(index, faiss.IndexIVFPQFastScan):
+            return prefix + f",PQ{index.pq.M}x{index.pq.nbits}fs"
+
+    elif isinstance(index, faiss.IndexPreTransform):
+        if index.chain.size() != 1:
+            raise NotImplementedError()
+        vt = faiss.downcast_VectorTransform(index.chain.at(0))
+        if isinstance(vt, faiss.OPQMatrix):
+            prefix = f"OPQ{vt.M}_{vt.d_out}"
+        elif isinstance(vt, faiss.ITQTransform):
+            prefix = f"ITQ{vt.itq.d_out}"
+        elif isinstance(vt, faiss.PCAMatrix):
+            assert vt.eigen_power == 0
+            prefix = "PCA" + ("R" if vt.random_rotation else "") + str(vt.d_out)
+        else:
+            raise NotImplementedError()
+        return f"{prefix},{reverse_index_factory(index.index)}"
+
+    elif isinstance(index, faiss.IndexHNSW):
+        return f"HNSW{get_hnsw_M(index)}"
+
+    elif isinstance(index, faiss.IndexRefine):
+        return f"{reverse_index_factory(index.base_index)},Refine({reverse_index_factory(index.refine_index)})"
+
+    elif isinstance(index, faiss.IndexPQFastScan):
+        return f"PQ{index.pq.M}x{index.pq.nbits}fs"
+
+    elif isinstance(index, faiss.IndexPQ):
+        return f"PQ{index.pq.M}x{index.pq.nbits}"
+
+    elif isinstance(index, faiss.IndexLSH):
+        return "LSH" + ("r" if index.rotate_data else "") + ("t" if index.train_thresholds else "")
+
+    elif isinstance(index, faiss.IndexScalarQuantizer):
+        sqtypes = {
+            faiss.ScalarQuantizer.QT_8bit: "8",
+            faiss.ScalarQuantizer.QT_4bit: "4",
+            faiss.ScalarQuantizer.QT_6bit: "6",
+            faiss.ScalarQuantizer.QT_fp16: "fp16",
+        }
+        return f"SQ{sqtypes[index.sq.qtype]}"
+
+    raise NotImplementedError()
diff --git a/llm/Lib/site-packages/faiss/contrib/inspect_tools.py b/llm/Lib/site-packages/faiss/contrib/inspect_tools.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e8e434242944172bae4914c5ab0c225bc3885e0
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/contrib/inspect_tools.py
@@ -0,0 +1,111 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+import numpy as np
+import faiss
+
+
+def get_invlist(invlists, l):
+    """ returns the inverted lists content as a pair of (list_ids, list_codes).
+    The codes are reshaped to a proper size
+    """
+    invlists = faiss.downcast_InvertedLists(invlists)
+    ls = invlists.list_size(l)
+    list_ids = np.zeros(ls, dtype='int64')
+    ids = codes = None
+    try:
+        ids = invlists.get_ids(l)
+        if ls > 0:
+            faiss.memcpy(faiss.swig_ptr(list_ids), ids, list_ids.nbytes)
+        codes = invlists.get_codes(l)
+        if invlists.code_size != faiss.InvertedLists.INVALID_CODE_SIZE:
+            list_codes = np.zeros((ls, invlists.code_size), dtype='uint8')
+        else:
+            # it's a BlockInvertedLists
+            npb = invlists.n_per_block
+            bs = invlists.block_size
+            ls_round = (ls + npb - 1) // npb
+            list_codes = np.zeros((ls_round, bs // npb, npb), dtype='uint8')
+        if ls > 0:
+            faiss.memcpy(faiss.swig_ptr(list_codes), codes, list_codes.nbytes)
+    finally:
+        if ids is not None:
+            invlists.release_ids(l, ids)
+        if codes is not None:
+            invlists.release_codes(l, codes)
+    return list_ids, list_codes
+
+
+def get_invlist_sizes(invlists):
+    """ return the array of sizes of the inverted lists """
+    return np.array([
+        invlists.list_size(i)
+        for i in range(invlists.nlist)
+    ], dtype='int64')
+
+
+def print_object_fields(obj):
+    """ list values all fields of an object known to SWIG """
+
+    for name in obj.__class__.__swig_getmethods__:
+        print(f"{name} = {getattr(obj, name)}")
+
+
+def get_pq_centroids(pq):
+    """ return the PQ centroids as an array """
+    cen = faiss.vector_to_array(pq.centroids)
+    return cen.reshape(pq.M, pq.ksub, pq.dsub)
+
+
+def get_LinearTransform_matrix(pca):
+    """ extract matrix + bias from the PCA object
+    works for any linear transform (OPQ, random rotation, etc.)
+    """
+    b = faiss.vector_to_array(pca.b)
+    A = faiss.vector_to_array(pca.A).reshape(pca.d_out, pca.d_in)
+    return A, b
+
+
+def make_LinearTransform_matrix(A, b=None):
+    """ make a linear transform from a matrix and a bias term (optional)"""
+    d_out, d_in = A.shape
+    if b is not None:
+        assert b.shape == (d_out, )
+    lt = faiss.LinearTransform(d_in, d_out, b is not None)
+    faiss.copy_array_to_vector(A.ravel(), lt.A)
+    if b is not None:
+        faiss.copy_array_to_vector(b, lt.b)
+    lt.is_trained = True
+    lt.set_is_orthonormal()
+    return lt
+
+
+def get_additive_quantizer_codebooks(aq):
+    """ return to codebooks of an additive quantizer """
+    codebooks = faiss.vector_to_array(aq.codebooks).reshape(-1, aq.d)
+    co = faiss.vector_to_array(aq.codebook_offsets)
+    return [
+        codebooks[co[i]:co[i + 1]]
+        for i in range(aq.M)
+    ]
+
+
+def get_flat_data(index):
+    """ copy and return the data matrix in an IndexFlat """
+    xb = faiss.vector_to_array(index.codes).view("float32")
+    return xb.reshape(index.ntotal, index.d)
+
+
+def get_NSG_neighbors(nsg):
+    """ get the neighbor list for the vectors stored in the NSG structure, as
+    a N-by-K matrix of indices """
+    graph = nsg.get_final_graph()
+    neighbors = np.zeros((graph.N, graph.K), dtype='int32')
+    faiss.memcpy(
+        faiss.swig_ptr(neighbors),
+        graph.data,
+        neighbors.nbytes
+    )
+    return neighbors
diff --git a/llm/Lib/site-packages/faiss/contrib/ivf_tools.py b/llm/Lib/site-packages/faiss/contrib/ivf_tools.py
new file mode 100644
index 0000000000000000000000000000000000000000..ab7ba41eee1c553911df90fc648874aeec6406aa
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/contrib/ivf_tools.py
@@ -0,0 +1,148 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+import numpy as np
+import faiss
+
+from faiss.contrib.inspect_tools import get_invlist_sizes
+
+
+def add_preassigned(index_ivf, x, a, ids=None):
+    """
+    Add elements to an IVF index, where the assignment is already computed
+    """
+    n, d = x.shape
+    assert a.shape == (n, )
+    if isinstance(index_ivf, faiss.IndexBinaryIVF):
+        d *= 8
+    assert d == index_ivf.d
+    if ids is not None:
+        assert ids.shape == (n, )
+        ids = faiss.swig_ptr(ids)
+    index_ivf.add_core(
+        n, faiss.swig_ptr(x), ids, faiss.swig_ptr(a)
+    )
+
+
+def search_preassigned(index_ivf, xq, k, list_nos, coarse_dis=None):
+    """
+    Perform a search in the IVF index, with predefined lists to search into.
+    Supports indexes with pretransforms (as opposed to the
+    IndexIVF.search_preassigned, that cannot be applied with pretransform).
+    """
+    if isinstance(index_ivf, faiss.IndexPreTransform):
+        assert index_ivf.chain.size() == 1, "chain must have only one component"
+        transform = faiss.downcast_VectorTransform(index_ivf.chain.at(0))
+        xq = transform.apply(xq)
+        index_ivf = faiss.downcast_index(index_ivf.index)
+    n, d = xq.shape
+    if isinstance(index_ivf, faiss.IndexBinaryIVF):
+        d *= 8
+        dis_type = "int32"
+    else:
+        dis_type = "float32"
+
+    assert d == index_ivf.d
+    assert list_nos.shape == (n, index_ivf.nprobe)
+
+    # the coarse distances are used in IVFPQ with L2 distance and
+    # by_residual=True otherwise we provide dummy coarse_dis
+    if coarse_dis is None:
+        coarse_dis = np.zeros((n, index_ivf.nprobe), dtype=dis_type)
+    else:
+        assert coarse_dis.shape == (n, index_ivf.nprobe)
+
+    return index_ivf.search_preassigned(xq, k, list_nos, coarse_dis)
+
+
+def range_search_preassigned(index_ivf, x, radius, list_nos, coarse_dis=None):
+    """
+    Perform a range search in the IVF index, with predefined lists to
+    search into
+    """
+    n, d = x.shape
+    if isinstance(index_ivf, faiss.IndexBinaryIVF):
+        d *= 8
+        dis_type = "int32"
+    else:
+        dis_type = "float32"
+
+    # the coarse distances are used in IVFPQ with L2 distance and
+    # by_residual=True otherwise we provide dummy coarse_dis
+    if coarse_dis is None:
+        coarse_dis = np.empty((n, index_ivf.nprobe), dtype=dis_type)
+    else:
+        assert coarse_dis.shape == (n, index_ivf.nprobe)
+
+    assert d == index_ivf.d
+    assert list_nos.shape == (n, index_ivf.nprobe)
+
+    res = faiss.RangeSearchResult(n)
+    sp = faiss.swig_ptr
+
+    index_ivf.range_search_preassigned_c(
+        n, sp(x), radius,
+        sp(list_nos), sp(coarse_dis),
+        res
+    )
+    # get pointers and copy them
+    lims = faiss.rev_swig_ptr(res.lims, n + 1).copy()
+    num_results = int(lims[-1])
+    dist = faiss.rev_swig_ptr(res.distances, num_results).copy()
+    indices = faiss.rev_swig_ptr(res.labels, num_results).copy()
+    return lims, dist, indices
+
+
+def replace_ivf_quantizer(index_ivf, new_quantizer):
+    """ replace the IVF quantizer with a flat quantizer and return the
+    old quantizer"""
+    if new_quantizer.ntotal == 0:
+        centroids = index_ivf.quantizer.reconstruct_n()
+        new_quantizer.train(centroids)
+        new_quantizer.add(centroids)
+    else:
+        assert new_quantizer.ntotal == index_ivf.nlist
+
+    # cleanly dealloc old quantizer
+    old_own = index_ivf.own_fields
+    index_ivf.own_fields = False
+    old_quantizer = faiss.downcast_index(index_ivf.quantizer)
+    old_quantizer.this.own(old_own)
+    index_ivf.quantizer = new_quantizer
+
+    if hasattr(index_ivf, "referenced_objects"):
+        index_ivf.referenced_objects.append(new_quantizer)
+    else:
+        index_ivf.referenced_objects = [new_quantizer]
+    return old_quantizer
+
+
+def permute_invlists(index_ivf, perm):
+    """ Apply some permutation to the inverted lists, and modify the quantizer
+    entries accordingly.
+    Perm is an array of size nlist, where old_index = perm[new_index]
+    """
+    nlist, = perm.shape
+    assert index_ivf.nlist == nlist
+    quantizer = faiss.downcast_index(index_ivf.quantizer)
+    assert quantizer.ntotal == index_ivf.nlist
+    perm = np.ascontiguousarray(perm, dtype='int64')
+
+    # just make sure it's a permutation...
+    bc = np.bincount(perm, minlength=nlist)
+    assert np.all(bc == np.ones(nlist, dtype=int))
+
+    # handle quantizer
+    quantizer.permute_entries(perm)
+
+    # handle inverted lists
+    invlists = faiss.downcast_InvertedLists(index_ivf.invlists)
+    invlists.permute_invlists(faiss.swig_ptr(perm))
+
+
+def sort_invlists_by_size(index_ivf):
+    invlist_sizes = get_invlist_sizes(index_ivf.invlists)
+    perm = np.argsort(invlist_sizes)
+    permute_invlists(index_ivf, perm)
diff --git a/llm/Lib/site-packages/faiss/contrib/ondisk.py b/llm/Lib/site-packages/faiss/contrib/ondisk.py
new file mode 100644
index 0000000000000000000000000000000000000000..384ab7dcb7e87d92c236f41b8bcf1051cff6c577
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/contrib/ondisk.py
@@ -0,0 +1,59 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+from typing import List
+import faiss
+import logging
+
+LOG = logging.getLogger(__name__)
+
+
+def merge_ondisk(
+    trained_index: faiss.Index, shard_fnames: List[str], ivfdata_fname: str
+) -> None:
+    """Add the contents of the indexes stored in shard_fnames into the index
+    trained_index. The on-disk data is stored in ivfdata_fname"""
+    assert not isinstance(
+        trained_index, faiss.IndexIVFPQR
+    ), "IndexIVFPQR is not supported as an on disk index."
+    # merge the images into an on-disk index
+    # first load the inverted lists
+    ivfs = []
+    for fname in shard_fnames:
+        # the IO_FLAG_MMAP is to avoid actually loading the data thus
+        # the total size of the inverted lists can exceed the
+        # available RAM
+        LOG.info("read " + fname)
+        index = faiss.read_index(fname, faiss.IO_FLAG_MMAP)
+        index_ivf = faiss.extract_index_ivf(index)
+        ivfs.append(index_ivf.invlists)
+
+        # avoid that the invlists get deallocated with the index
+        index_ivf.own_invlists = False
+
+    # construct the output index
+    index = trained_index
+    index_ivf = faiss.extract_index_ivf(index)
+
+    assert index.ntotal == 0, "works only on empty index"
+
+    # prepare the output inverted lists. They will be written
+    # to merged_index.ivfdata
+    invlists = faiss.OnDiskInvertedLists(
+        index_ivf.nlist, index_ivf.code_size, ivfdata_fname
+    )
+
+    # merge all the inverted lists
+    ivf_vector = faiss.InvertedListsPtrVector()
+    for ivf in ivfs:
+        ivf_vector.push_back(ivf)
+
+    LOG.info("merge %d inverted lists " % ivf_vector.size())
+    ntotal = invlists.merge_from(ivf_vector.data(), ivf_vector.size())
+
+    # now replace the inverted lists in the output index
+    index.ntotal = index_ivf.ntotal = ntotal
+    index_ivf.replace_invlists(invlists, True)
+    invlists.this.disown()
diff --git a/llm/Lib/site-packages/faiss/contrib/rpc.py b/llm/Lib/site-packages/faiss/contrib/rpc.py
new file mode 100644
index 0000000000000000000000000000000000000000..e192346886d15cf31e0bb9793d9129a22008e9fe
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/contrib/rpc.py
@@ -0,0 +1,258 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+"""
+Simplistic RPC implementation.
+Exposes all functions of a Server object.
+
+This code is for demonstration purposes only, and does not include certain
+security protections. It is not meant to be run on an untrusted network or
+in a production environment.
+"""
+
+import importlib
+import os
+import pickle
+import sys
+import _thread
+import traceback
+import socket
+import logging
+
+LOG = logging.getLogger(__name__)
+
+# default
+PORT = 12032
+
+safe_modules = {
+    'numpy',
+    'numpy.core.multiarray',
+}
+
+
+class RestrictedUnpickler(pickle.Unpickler):
+
+    def find_class(self, module, name):
+        # Only allow safe modules.
+        if module in safe_modules:
+            return getattr(importlib.import_module(module), name)
+        # Forbid everything else.
+        raise pickle.UnpicklingError("global '%s.%s' is forbidden" %
+                                     (module, name))
+
+
+class FileSock:
+    " wraps a socket so that it is usable by pickle/cPickle "
+
+    def __init__(self,sock):
+        self.sock = sock
+        self.nr=0
+
+    def write(self, buf):
+        # print("sending %d bytes"%len(buf))
+        #self.sock.sendall(buf)
+        # print("...done")
+        bs = 512 * 1024
+        ns = 0
+        while ns < len(buf):
+            sent = self.sock.send(buf[ns:ns + bs])
+            ns += sent
+
+    def read(self,bs=512*1024):
+        #if self.nr==10000: pdb.set_trace()
+        self.nr+=1
+        # print("read bs=%d"%bs)
+        b = []
+        nb = 0
+        while len(b)<bs:
+            # print('   loop')
+            rb = self.sock.recv(bs - nb)
+            if not rb: break
+            b.append(rb)
+            nb += len(rb)
+        return b''.join(b)
+
+    def readline(self):
+        # print("readline!")
+        """may be optimized..."""
+        s=bytes()
+        while True:
+            c=self.read(1)
+            s+=c
+        if len(c)==0 or chr(c[0])=='\n':
+            return s
+
+class ClientExit(Exception):
+    pass
+
+class ServerException(Exception):
+    pass
+
+
+class Server:
+    """
+    server protocol. Methods from classes that subclass Server can be called
+    transparently from a client
+    """
+
+    def __init__(self, s, logf=sys.stderr, log_prefix=''):
+        self.logf = logf
+        self.log_prefix = log_prefix
+
+        # connection
+
+        self.conn = s
+        self.fs = FileSock(s)
+
+
+    def log(self, s):
+        self.logf.write("Sever log %s: %s\n" % (self.log_prefix, s))
+
+    def one_function(self):
+        """
+        Executes a single function with associated I/O.
+        Protocol:
+        - the arguments and results are serialized with the pickle protocol
+        - client sends : (fname,args)
+            fname = method name to call
+            args = tuple of arguments
+        - server sends result: (rid,st,ret)
+            rid = request id
+            st = None, or exception if there was during execution
+            ret = return value or None if st!=None
+        """
+
+        try:
+            (fname, args) = RestrictedUnpickler(self.fs).load()
+        except EOFError:
+            raise ClientExit("read args")
+        self.log("executing method %s"%(fname))
+        st = None
+        ret = None
+        try:
+            f=getattr(self,fname)
+        except AttributeError:
+            st = AttributeError("unknown method "+fname)
+            self.log("unknown method")
+
+        try:
+            ret = f(*args)
+        except Exception as e:
+            # due to a bug (in mod_python?), ServerException cannot be
+            # unpickled, so send the string and make the exception on the client side
+
+            #st=ServerException(
+            #  "".join(traceback.format_tb(sys.exc_info()[2]))+
+            #  str(e))
+            st="".join(traceback.format_tb(sys.exc_info()[2]))+str(e)
+            self.log("exception in method")
+            traceback.print_exc(50,self.logf)
+            self.logf.flush()
+
+        LOG.info("return")
+        try:
+            pickle.dump((st ,ret), self.fs, protocol=4)
+        except EOFError:
+            raise ClientExit("function return")
+
+    def exec_loop(self):
+        """ main execution loop. Loops and handles exit states"""
+
+        self.log("in exec_loop")
+        try:
+            while True:
+                self.one_function()
+        except ClientExit as e:
+            self.log("ClientExit %s"%e)
+        except socket.error as e:
+            self.log("socket error %s"%e)
+            traceback.print_exc(50,self.logf)
+        except EOFError:
+            self.log("EOF during communication")
+            traceback.print_exc(50,self.logf)
+        except BaseException:
+            # unexpected
+            traceback.print_exc(50,sys.stderr)
+            sys.exit(1)
+
+        LOG.info("exit sever")
+
+    def exec_loop_cleanup(self):
+        pass
+
+    ###################################################################
+    # spying stuff
+
+    def get_ps_stats(self):
+        ret=''
+        f=os.popen("echo ============ `hostname` uptime:; uptime;"+
+                   "echo ============ self:; "+
+                   "ps -p %d -o pid,vsize,rss,%%cpu,nlwp,psr; "%os.getpid()+
+                   "echo ============ run queue:;"+
+                   "ps ar -o user,pid,%cpu,%mem,ni,nlwp,psr,vsz,rss,cputime,command")
+        for l in f:
+            ret+=l
+        return ret
+
+class Client:
+    """
+    Methods of the server object can be called transparently. Exceptions are
+    re-raised.
+    """
+    def __init__(self, HOST, port=PORT, v6=False):
+        socktype = socket.AF_INET6 if v6 else socket.AF_INET
+
+        sock = socket.socket(socktype, socket.SOCK_STREAM)
+        LOG.info("connecting to %s:%d, socket type: %s", HOST, port, socktype)
+        sock.connect((HOST, port))
+        self.sock = sock
+        self.fs = FileSock(sock)
+
+    def generic_fun(self, fname, args):
+        # int "gen fun",fname
+        pickle.dump((fname, args), self.fs, protocol=4)
+        return self.get_result()
+
+    def get_result(self):
+        (st, ret) = RestrictedUnpickler(self.fs).load()
+        if st!=None:
+            raise ServerException(st)
+        else:
+            return ret
+
+    def __getattr__(self,name):
+        return lambda *x: self.generic_fun(name,x)
+
+
+def run_server(new_handler, port=PORT, report_to_file=None, v6=False):
+
+    HOST = ''                 # Symbolic name meaning the local host
+    socktype = socket.AF_INET6 if v6 else socket.AF_INET
+    s = socket.socket(socktype, socket.SOCK_STREAM)
+    s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+
+    LOG.info("bind %s:%d", HOST, port)
+    s.bind((HOST, port))
+    s.listen(5)
+
+    LOG.info("accepting connections")
+    if report_to_file is not None:
+        LOG.info('storing host+port in %s', report_to_file)
+        open(report_to_file, 'w').write('%s:%d ' % (socket.gethostname(), port))
+
+    while True:
+        try:
+            conn, addr = s.accept()
+        except socket.error as e:
+            if e[1]=='Interrupted system call': continue
+            raise
+
+        LOG.info('Connected to %s', addr)
+
+        ibs = new_handler(conn)
+
+        tid = _thread.start_new_thread(ibs.exec_loop,())
+
+        LOG.debug("Thread ID: %d", tid)
diff --git a/llm/Lib/site-packages/faiss/contrib/torch_utils.py b/llm/Lib/site-packages/faiss/contrib/torch_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..fafce2f7fbb016f847dd5d802c3e46913fc93616
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/contrib/torch_utils.py
@@ -0,0 +1,657 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+"""
+
+This is a set of function wrappers that override the default numpy versions.
+
+Interoperability functions for pytorch and Faiss: Importing this will allow
+pytorch Tensors (CPU or GPU) to be used as arguments to Faiss indexes and
+other functions. Torch GPU tensors can only be used with Faiss GPU indexes.
+If this is imported with a package that supports Faiss GPU, the necessary
+stream synchronization with the current pytorch stream will be automatically
+performed.
+
+Numpy ndarrays can continue to be used in the Faiss python interface after
+importing this file. All arguments must be uniformly either numpy ndarrays
+or Torch tensors; no mixing is allowed.
+
+"""
+
+
+import faiss
+import torch
+import contextlib
+import inspect
+import sys
+import numpy as np
+
+def swig_ptr_from_UInt8Tensor(x):
+    """ gets a Faiss SWIG pointer from a pytorch tensor (on CPU or GPU) """
+    assert x.is_contiguous()
+    assert x.dtype == torch.uint8
+    return faiss.cast_integer_to_uint8_ptr(
+        x.storage().data_ptr() + x.storage_offset())
+
+def swig_ptr_from_HalfTensor(x):
+    """ gets a Faiss SWIG pointer from a pytorch tensor (on CPU or GPU) """
+    assert x.is_contiguous()
+    assert x.dtype == torch.float16
+    # no canonical half type in C/C++
+    return faiss.cast_integer_to_void_ptr(
+        x.storage().data_ptr() + x.storage_offset() * 2)
+
+def swig_ptr_from_FloatTensor(x):
+    """ gets a Faiss SWIG pointer from a pytorch tensor (on CPU or GPU) """
+    assert x.is_contiguous()
+    assert x.dtype == torch.float32
+    return faiss.cast_integer_to_float_ptr(
+        x.storage().data_ptr() + x.storage_offset() * 4)
+
+def swig_ptr_from_IntTensor(x):
+    """ gets a Faiss SWIG pointer from a pytorch tensor (on CPU or GPU) """
+    assert x.is_contiguous()
+    assert x.dtype == torch.int32, 'dtype=%s' % x.dtype
+    return faiss.cast_integer_to_int_ptr(
+        x.storage().data_ptr() + x.storage_offset() * 4)
+
+def swig_ptr_from_IndicesTensor(x):
+    """ gets a Faiss SWIG pointer from a pytorch tensor (on CPU or GPU) """
+    assert x.is_contiguous()
+    assert x.dtype == torch.int64, 'dtype=%s' % x.dtype
+    return faiss.cast_integer_to_idx_t_ptr(
+        x.storage().data_ptr() + x.storage_offset() * 8)
+
+@contextlib.contextmanager
+def using_stream(res, pytorch_stream=None):
+    """ Creates a scoping object to make Faiss GPU use the same stream
+        as pytorch, based on torch.cuda.current_stream().
+        Or, a specific pytorch stream can be passed in as a second
+        argument, in which case we will use that stream.
+    """
+
+    if pytorch_stream is None:
+        pytorch_stream = torch.cuda.current_stream()
+
+    # This is the cudaStream_t that we wish to use
+    cuda_stream_s = faiss.cast_integer_to_cudastream_t(pytorch_stream.cuda_stream)
+
+    # So we can revert GpuResources stream state upon exit
+    prior_dev = torch.cuda.current_device()
+    prior_stream = res.getDefaultStream(torch.cuda.current_device())
+
+    res.setDefaultStream(torch.cuda.current_device(), cuda_stream_s)
+
+    # Do the user work
+    try:
+        yield
+    finally:
+        res.setDefaultStream(prior_dev, prior_stream)
+
+def torch_replace_method(the_class, name, replacement,
+                         ignore_missing=False, ignore_no_base=False):
+    try:
+        orig_method = getattr(the_class, name)
+    except AttributeError:
+        if ignore_missing:
+            return
+        raise
+    if orig_method.__name__ == 'torch_replacement_' + name:
+        # replacement was done in parent class
+        return
+
+    # We should already have the numpy replacement methods patched
+    assert ignore_no_base or (orig_method.__name__ == 'replacement_' + name)
+    setattr(the_class, name + '_numpy', orig_method)
+    setattr(the_class, name, replacement)
+
+def handle_torch_Index(the_class):
+    def torch_replacement_add(self, x):
+        if type(x) is np.ndarray:
+            # forward to faiss __init__.py base method
+            return self.add_numpy(x)
+
+        assert type(x) is torch.Tensor
+        n, d = x.shape
+        assert d == self.d
+        x_ptr = swig_ptr_from_FloatTensor(x)
+
+        if x.is_cuda:
+            assert hasattr(self, 'getDevice'), 'GPU tensor on CPU index not allowed'
+
+            # On the GPU, use proper stream ordering
+            with using_stream(self.getResources()):
+                self.add_c(n, x_ptr)
+        else:
+            # CPU torch
+            self.add_c(n, x_ptr)
+
+    def torch_replacement_add_with_ids(self, x, ids):
+        if type(x) is np.ndarray:
+            # forward to faiss __init__.py base method
+            return self.add_with_ids_numpy(x, ids)
+
+        assert type(x) is torch.Tensor
+        n, d = x.shape
+        assert d == self.d
+        x_ptr = swig_ptr_from_FloatTensor(x)
+
+        assert type(ids) is torch.Tensor
+        assert ids.shape == (n, ), 'not same number of vectors as ids'
+        ids_ptr = swig_ptr_from_IndicesTensor(ids)
+
+        if x.is_cuda:
+            assert hasattr(self, 'getDevice'), 'GPU tensor on CPU index not allowed'
+
+            # On the GPU, use proper stream ordering
+            with using_stream(self.getResources()):
+                self.add_with_ids_c(n, x_ptr, ids_ptr)
+        else:
+            # CPU torch
+            self.add_with_ids_c(n, x_ptr, ids_ptr)
+
+    def torch_replacement_assign(self, x, k, labels=None):
+        if type(x) is np.ndarray:
+            # forward to faiss __init__.py base method
+            return self.assign_numpy(x, k, labels)
+
+        assert type(x) is torch.Tensor
+        n, d = x.shape
+        assert d == self.d
+        x_ptr = swig_ptr_from_FloatTensor(x)
+
+        if labels is None:
+            labels = torch.empty(n, k, device=x.device, dtype=torch.int64)
+        else:
+            assert type(labels) is torch.Tensor
+            assert labels.shape == (n, k)
+        L_ptr = swig_ptr_from_IndicesTensor(labels)
+
+        if x.is_cuda:
+            assert hasattr(self, 'getDevice'), 'GPU tensor on CPU index not allowed'
+
+            # On the GPU, use proper stream ordering
+            with using_stream(self.getResources()):
+                self.assign_c(n, x_ptr, L_ptr, k)
+        else:
+            # CPU torch
+            self.assign_c(n, x_ptr, L_ptr, k)
+
+        return labels
+
+    def torch_replacement_train(self, x):
+        if type(x) is np.ndarray:
+            # forward to faiss __init__.py base method
+            return self.train_numpy(x)
+
+        assert type(x) is torch.Tensor
+        n, d = x.shape
+        assert d == self.d
+        x_ptr = swig_ptr_from_FloatTensor(x)
+
+        if x.is_cuda:
+            assert hasattr(self, 'getDevice'), 'GPU tensor on CPU index not allowed'
+
+            # On the GPU, use proper stream ordering
+            with using_stream(self.getResources()):
+                self.train_c(n, x_ptr)
+        else:
+            # CPU torch
+            self.train_c(n, x_ptr)
+
+    def torch_replacement_search(self, x, k, D=None, I=None):
+        if type(x) is np.ndarray:
+            # forward to faiss __init__.py base method
+            return self.search_numpy(x, k, D=D, I=I)
+
+        assert type(x) is torch.Tensor
+        n, d = x.shape
+        assert d == self.d
+        x_ptr = swig_ptr_from_FloatTensor(x)
+
+        if D is None:
+            D = torch.empty(n, k, device=x.device, dtype=torch.float32)
+        else:
+            assert type(D) is torch.Tensor
+            assert D.shape == (n, k)
+        D_ptr = swig_ptr_from_FloatTensor(D)
+
+        if I is None:
+            I = torch.empty(n, k, device=x.device, dtype=torch.int64)
+        else:
+            assert type(I) is torch.Tensor
+            assert I.shape == (n, k)
+        I_ptr = swig_ptr_from_IndicesTensor(I)
+
+        if x.is_cuda:
+            assert hasattr(self, 'getDevice'), 'GPU tensor on CPU index not allowed'
+
+            # On the GPU, use proper stream ordering
+            with using_stream(self.getResources()):
+                self.search_c(n, x_ptr, k, D_ptr, I_ptr)
+        else:
+            # CPU torch
+            self.search_c(n, x_ptr, k, D_ptr, I_ptr)
+
+        return D, I
+
+    def torch_replacement_search_and_reconstruct(self, x, k, D=None, I=None, R=None):
+        if type(x) is np.ndarray:
+            # Forward to faiss __init__.py base method
+            return self.search_and_reconstruct_numpy(x, k, D=D, I=I, R=R)
+
+        assert type(x) is torch.Tensor
+        n, d = x.shape
+        assert d == self.d
+        x_ptr = swig_ptr_from_FloatTensor(x)
+
+        if D is None:
+            D = torch.empty(n, k, device=x.device, dtype=torch.float32)
+        else:
+            assert type(D) is torch.Tensor
+            assert D.shape == (n, k)
+        D_ptr = swig_ptr_from_FloatTensor(D)
+
+        if I is None:
+            I = torch.empty(n, k, device=x.device, dtype=torch.int64)
+        else:
+            assert type(I) is torch.Tensor
+            assert I.shape == (n, k)
+        I_ptr = swig_ptr_from_IndicesTensor(I)
+
+        if R is None:
+            R = torch.empty(n, k, d, device=x.device, dtype=torch.float32)
+        else:
+            assert type(R) is torch.Tensor
+            assert R.shape == (n, k, d)
+        R_ptr = swig_ptr_from_FloatTensor(R)
+
+        if x.is_cuda:
+            assert hasattr(self, 'getDevice'), 'GPU tensor on CPU index not allowed'
+
+            # On the GPU, use proper stream ordering
+            with using_stream(self.getResources()):
+                self.search_and_reconstruct_c(n, x_ptr, k, D_ptr, I_ptr, R_ptr)
+        else:
+            # CPU torch
+            self.search_and_reconstruct_c(n, x_ptr, k, D_ptr, I_ptr, R_ptr)
+
+        return D, I, R
+
+    def torch_replacement_remove_ids(self, x):
+        # Not yet implemented
+        assert type(x) is not torch.Tensor, 'remove_ids not yet implemented for torch'
+        return self.remove_ids_numpy(x)
+
+    def torch_replacement_reconstruct(self, key, x=None):
+        # No tensor inputs are required, but with importing this module, we
+        # assume that the default should be torch tensors. If we are passed a
+        # numpy array, however, assume that the user is overriding this default
+        if (x is not None) and (type(x) is np.ndarray):
+            # Forward to faiss __init__.py base method
+            return self.reconstruct_numpy(key, x)
+
+        # If the index is a CPU index, the default device is CPU, otherwise we
+        # produce a GPU tensor
+        device = torch.device('cpu')
+        if hasattr(self, 'getDevice'):
+            # same device as the index
+            device = torch.device('cuda', self.getDevice())
+
+        if x is None:
+            x = torch.empty(self.d, device=device, dtype=torch.float32)
+        else:
+            assert type(x) is torch.Tensor
+            assert x.shape == (self.d, )
+        x_ptr = swig_ptr_from_FloatTensor(x)
+
+        if x.is_cuda:
+            assert hasattr(self, 'getDevice'), 'GPU tensor on CPU index not allowed'
+
+            # On the GPU, use proper stream ordering
+            with using_stream(self.getResources()):
+                self.reconstruct_c(key, x_ptr)
+        else:
+            # CPU torch
+            self.reconstruct_c(key, x_ptr)
+
+        return x
+
+    def torch_replacement_reconstruct_n(self, n0=0, ni=-1, x=None):
+        if ni == -1:
+            ni = self.ntotal
+
+        # No tensor inputs are required, but with importing this module, we
+        # assume that the default should be torch tensors. If we are passed a
+        # numpy array, however, assume that the user is overriding this default
+        if (x is not None) and (type(x) is np.ndarray):
+            # Forward to faiss __init__.py base method
+            return self.reconstruct_n_numpy(n0, ni, x)
+
+        # If the index is a CPU index, the default device is CPU, otherwise we
+        # produce a GPU tensor
+        device = torch.device('cpu')
+        if hasattr(self, 'getDevice'):
+            # same device as the index
+            device = torch.device('cuda', self.getDevice())
+
+        if x is None:
+            x = torch.empty(ni, self.d, device=device, dtype=torch.float32)
+        else:
+            assert type(x) is torch.Tensor
+            assert x.shape == (ni, self.d)
+        x_ptr = swig_ptr_from_FloatTensor(x)
+
+        if x.is_cuda:
+            assert hasattr(self, 'getDevice'), 'GPU tensor on CPU index not allowed'
+
+            # On the GPU, use proper stream ordering
+            with using_stream(self.getResources()):
+                self.reconstruct_n_c(n0, ni, x_ptr)
+        else:
+            # CPU torch
+            self.reconstruct_n_c(n0, ni, x_ptr)
+
+        return x
+
+    def torch_replacement_update_vectors(self, keys, x):
+        if type(keys) is np.ndarray:
+            # Forward to faiss __init__.py base method
+            return self.update_vectors_numpy(keys, x)
+
+        assert type(keys) is torch.Tensor
+        (n, ) = keys.shape
+        keys_ptr = swig_ptr_from_IndicesTensor(keys)
+
+        assert type(x) is torch.Tensor
+        assert x.shape == (n, self.d)
+        x_ptr = swig_ptr_from_FloatTensor(x)
+
+        if x.is_cuda:
+            assert hasattr(self, 'getDevice'), 'GPU tensor on CPU index not allowed'
+
+            # On the GPU, use proper stream ordering
+            with using_stream(self.getResources()):
+                self.update_vectors_c(n, keys_ptr, x_ptr)
+        else:
+            # CPU torch
+            self.update_vectors_c(n, keys_ptr, x_ptr)
+
+    # Until the GPU version is implemented, we do not support pre-allocated
+    # output buffers
+    def torch_replacement_range_search(self, x, thresh):
+        if type(x) is np.ndarray:
+            # Forward to faiss __init__.py base method
+            return self.range_search_numpy(x, thresh)
+
+        assert type(x) is torch.Tensor
+        n, d = x.shape
+        assert d == self.d
+        x_ptr = swig_ptr_from_FloatTensor(x)
+
+        assert not x.is_cuda, 'Range search using GPU tensor not yet implemented'
+        assert not hasattr(self, 'getDevice'), 'Range search on GPU index not yet implemented'
+
+        res = faiss.RangeSearchResult(n)
+        self.range_search_c(n, x_ptr, thresh, res)
+
+        # get pointers and copy them
+        # FIXME: no rev_swig_ptr equivalent for torch.Tensor, just convert
+        # np to torch
+        # NOTE: torch does not support np.uint64, just np.int64
+        lims = torch.from_numpy(faiss.rev_swig_ptr(res.lims, n + 1).copy().astype('int64'))
+        nd = int(lims[-1])
+        D = torch.from_numpy(faiss.rev_swig_ptr(res.distances, nd).copy())
+        I = torch.from_numpy(faiss.rev_swig_ptr(res.labels, nd).copy())
+
+        return lims, D, I
+
+    def torch_replacement_sa_encode(self, x, codes=None):
+        if type(x) is np.ndarray:
+            # Forward to faiss __init__.py base method
+            return self.sa_encode_numpy(x, codes)
+
+        assert type(x) is torch.Tensor
+        n, d = x.shape
+        assert d == self.d
+        x_ptr = swig_ptr_from_FloatTensor(x)
+
+        if codes is None:
+            codes = torch.empty(n, self.sa_code_size(), dtype=torch.uint8)
+        else:
+            assert codes.shape == (n, self.sa_code_size())
+        codes_ptr = swig_ptr_from_UInt8Tensor(codes)
+
+        if x.is_cuda:
+            assert hasattr(self, 'getDevice'), 'GPU tensor on CPU index not allowed'
+
+            # On the GPU, use proper stream ordering
+            with using_stream(self.getResources()):
+                self.sa_encode_c(n, x_ptr, codes_ptr)
+        else:
+            # CPU torch
+            self.sa_encode_c(n, x_ptr, codes_ptr)
+
+        return codes
+
+    def torch_replacement_sa_decode(self, codes, x=None):
+        if type(codes) is np.ndarray:
+            # Forward to faiss __init__.py base method
+            return self.sa_decode_numpy(codes, x)
+
+        assert type(codes) is torch.Tensor
+        n, cs = codes.shape
+        assert cs == self.sa_code_size()
+        codes_ptr = swig_ptr_from_UInt8Tensor(codes)
+
+        if x is None:
+            x = torch.empty(n, self.d, dtype=torch.float32)
+        else:
+            assert type(x) is torch.Tensor
+            assert x.shape == (n, self.d)
+        x_ptr = swig_ptr_from_FloatTensor(x)
+
+        if codes.is_cuda:
+            assert hasattr(self, 'getDevice'), 'GPU tensor on CPU index not allowed'
+
+            # On the GPU, use proper stream ordering
+            with using_stream(self.getResources()):
+                self.sa_decode_c(n, codes_ptr, x_ptr)
+        else:
+            # CPU torch
+            self.sa_decode_c(n, codes_ptr, x_ptr)
+
+        return x
+
+
+    torch_replace_method(the_class, 'add', torch_replacement_add)
+    torch_replace_method(the_class, 'add_with_ids', torch_replacement_add_with_ids)
+    torch_replace_method(the_class, 'assign', torch_replacement_assign)
+    torch_replace_method(the_class, 'train', torch_replacement_train)
+    torch_replace_method(the_class, 'search', torch_replacement_search)
+    torch_replace_method(the_class, 'remove_ids', torch_replacement_remove_ids)
+    torch_replace_method(the_class, 'reconstruct', torch_replacement_reconstruct)
+    torch_replace_method(the_class, 'reconstruct_n', torch_replacement_reconstruct_n)
+    torch_replace_method(the_class, 'range_search', torch_replacement_range_search)
+    torch_replace_method(the_class, 'update_vectors', torch_replacement_update_vectors,
+                         ignore_missing=True)
+    torch_replace_method(the_class, 'search_and_reconstruct',
+                         torch_replacement_search_and_reconstruct, ignore_missing=True)
+    torch_replace_method(the_class, 'sa_encode', torch_replacement_sa_encode)
+    torch_replace_method(the_class, 'sa_decode', torch_replacement_sa_decode)
+
+faiss_module = sys.modules['faiss']
+
+# Re-patch anything that inherits from faiss.Index to add the torch bindings
+for symbol in dir(faiss_module):
+    obj = getattr(faiss_module, symbol)
+    if inspect.isclass(obj):
+        the_class = obj
+        if issubclass(the_class, faiss.Index):
+            handle_torch_Index(the_class)
+
+# allows torch tensor usage with bfKnn
+def torch_replacement_knn_gpu(res, xq, xb, k, D=None, I=None, metric=faiss.METRIC_L2, device=-1):
+    if type(xb) is np.ndarray:
+        # Forward to faiss __init__.py base method
+        return faiss.knn_gpu_numpy(res, xq, xb, k, D, I, metric, device)
+
+    nb, d = xb.size()
+    if xb.is_contiguous():
+        xb_row_major = True
+    elif xb.t().is_contiguous():
+        xb = xb.t()
+        xb_row_major = False
+    else:
+        raise TypeError('matrix should be row or column-major')
+
+    if xb.dtype == torch.float32:
+        xb_type = faiss.DistanceDataType_F32
+        xb_ptr = swig_ptr_from_FloatTensor(xb)
+    elif xb.dtype == torch.float16:
+        xb_type = faiss.DistanceDataType_F16
+        xb_ptr = swig_ptr_from_HalfTensor(xb)
+    else:
+        raise TypeError('xb must be f32 or f16')
+
+    nq, d2 = xq.size()
+    assert d2 == d
+    if xq.is_contiguous():
+        xq_row_major = True
+    elif xq.t().is_contiguous():
+        xq = xq.t()
+        xq_row_major = False
+    else:
+        raise TypeError('matrix should be row or column-major')
+
+    if xq.dtype == torch.float32:
+        xq_type = faiss.DistanceDataType_F32
+        xq_ptr = swig_ptr_from_FloatTensor(xq)
+    elif xq.dtype == torch.float16:
+        xq_type = faiss.DistanceDataType_F16
+        xq_ptr = swig_ptr_from_HalfTensor(xq)
+    else:
+        raise TypeError('xq must be f32 or f16')
+
+    if D is None:
+        D = torch.empty(nq, k, device=xb.device, dtype=torch.float32)
+    else:
+        assert D.shape == (nq, k)
+        # interface takes void*, we need to check this
+        assert (D.dtype == torch.float32)
+
+    if I is None:
+        I = torch.empty(nq, k, device=xb.device, dtype=torch.int64)
+    else:
+        assert I.shape == (nq, k)
+
+    if I.dtype == torch.int64:
+        I_type = faiss.IndicesDataType_I64
+        I_ptr = swig_ptr_from_IndicesTensor(I)
+    elif I.dtype == I.dtype == torch.int32:
+        I_type = faiss.IndicesDataType_I32
+        I_ptr = swig_ptr_from_IntTensor(I)
+    else:
+        raise TypeError('I must be i64 or i32')
+
+    D_ptr = swig_ptr_from_FloatTensor(D)
+
+    args = faiss.GpuDistanceParams()
+    args.metric = metric
+    args.k = k
+    args.dims = d
+    args.vectors = xb_ptr
+    args.vectorsRowMajor = xb_row_major
+    args.vectorType = xb_type
+    args.numVectors = nb
+    args.queries = xq_ptr
+    args.queriesRowMajor = xq_row_major
+    args.queryType = xq_type
+    args.numQueries = nq
+    args.outDistances = D_ptr
+    args.outIndices = I_ptr
+    args.outIndicesType = I_type
+    args.device = device
+
+    with using_stream(res):
+        faiss.bfKnn(res, args)
+
+    return D, I
+
+torch_replace_method(faiss_module, 'knn_gpu', torch_replacement_knn_gpu, True, True)
+
+# allows torch tensor usage with bfKnn for all pairwise distances
+def torch_replacement_pairwise_distance_gpu(res, xq, xb, D=None, metric=faiss.METRIC_L2, device=-1):
+    if type(xb) is np.ndarray:
+        # Forward to faiss __init__.py base method
+        return faiss.pairwise_distance_gpu_numpy(res, xq, xb, D, metric)
+
+    nb, d = xb.size()
+    if xb.is_contiguous():
+        xb_row_major = True
+    elif xb.t().is_contiguous():
+        xb = xb.t()
+        xb_row_major = False
+    else:
+        raise TypeError('xb matrix should be row or column-major')
+
+    if xb.dtype == torch.float32:
+        xb_type = faiss.DistanceDataType_F32
+        xb_ptr = swig_ptr_from_FloatTensor(xb)
+    elif xb.dtype == torch.float16:
+        xb_type = faiss.DistanceDataType_F16
+        xb_ptr = swig_ptr_from_HalfTensor(xb)
+    else:
+        raise TypeError('xb must be float32 or float16')
+
+    nq, d2 = xq.size()
+    assert d2 == d
+    if xq.is_contiguous():
+        xq_row_major = True
+    elif xq.t().is_contiguous():
+        xq = xq.t()
+        xq_row_major = False
+    else:
+        raise TypeError('xq matrix should be row or column-major')
+
+    if xq.dtype == torch.float32:
+        xq_type = faiss.DistanceDataType_F32
+        xq_ptr = swig_ptr_from_FloatTensor(xq)
+    elif xq.dtype == torch.float16:
+        xq_type = faiss.DistanceDataType_F16
+        xq_ptr = swig_ptr_from_HalfTensor(xq)
+    else:
+        raise TypeError('xq must be float32 or float16')
+
+    if D is None:
+        D = torch.empty(nq, nb, device=xb.device, dtype=torch.float32)
+    else:
+        assert D.shape == (nq, nb)
+        # interface takes void*, we need to check this
+        assert (D.dtype == torch.float32)
+
+    D_ptr = swig_ptr_from_FloatTensor(D)
+
+    args = faiss.GpuDistanceParams()
+    args.metric = metric
+    args.k = -1 # selects all pairwise distance
+    args.dims = d
+    args.vectors = xb_ptr
+    args.vectorsRowMajor = xb_row_major
+    args.vectorType = xb_type
+    args.numVectors = nb
+    args.queries = xq_ptr
+    args.queriesRowMajor = xq_row_major
+    args.queryType = xq_type
+    args.numQueries = nq
+    args.outDistances = D_ptr
+    args.device = device
+
+    with using_stream(res):
+        faiss.bfKnn(res, args)
+
+    return D
+
+torch_replace_method(faiss_module, 'pairwise_distance_gpu', torch_replacement_pairwise_distance_gpu, True, True)
diff --git a/llm/Lib/site-packages/faiss/contrib/vecs_io.py b/llm/Lib/site-packages/faiss/contrib/vecs_io.py
new file mode 100644
index 0000000000000000000000000000000000000000..0e63aa7f1da1db2b334894badddb865a9dc49e17
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/contrib/vecs_io.py
@@ -0,0 +1,50 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+import numpy as np
+
+"""
+I/O functions in fvecs, bvecs, ivecs formats
+definition of the formats here: http://corpus-texmex.irisa.fr/
+"""
+
+
+def ivecs_read(fname):
+    a = np.fromfile(fname, dtype='int32')
+    d = a[0]
+    return a.reshape(-1, d + 1)[:, 1:].copy()
+
+
+def fvecs_read(fname):
+    return ivecs_read(fname).view('float32')
+
+
+def ivecs_mmap(fname):
+    a = np.memmap(fname, dtype='int32', mode='r')
+    d = a[0]
+    return a.reshape(-1, d + 1)[:, 1:]
+
+
+def fvecs_mmap(fname):
+    return ivecs_mmap(fname).view('float32')
+
+
+def bvecs_mmap(fname):
+    x = np.memmap(fname, dtype='uint8', mode='r')
+    d = x[:4].view('int32')[0]
+    return x.reshape(-1, d + 4)[:, 4:]
+
+
+def ivecs_write(fname, m):
+    n, d = m.shape
+    m1 = np.empty((n, d + 1), dtype='int32')
+    m1[:, 0] = d
+    m1[:, 1:] = m
+    m1.tofile(fname)
+
+
+def fvecs_write(fname, m):
+    m = m.astype('float32')
+    ivecs_write(fname, m.view('int32'))
diff --git a/llm/Lib/site-packages/faiss/extra_wrappers.py b/llm/Lib/site-packages/faiss/extra_wrappers.py
new file mode 100644
index 0000000000000000000000000000000000000000..10a9fcea512ff213740dbb9de5b8e11fcf951289
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/extra_wrappers.py
@@ -0,0 +1,653 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+# @nolint
+
+# not linting this file because it imports * from swigfaiss, which
+# causes a ton of useless warnings.
+
+import numpy as np
+
+from faiss.loader import *
+
+import faiss
+
+import collections.abc
+
+
+###########################################
+# Wrapper for a few functions
+###########################################
+
+
+def kmin(array, k):
+    """return k smallest values (and their indices) of the lines of a
+    float32 array"""
+    array = np.ascontiguousarray(array, dtype='float32')
+    m, n = array.shape
+    I = np.zeros((m, k), dtype='int64')
+    D = np.zeros((m, k), dtype='float32')
+    ha = faiss.float_maxheap_array_t()
+    ha.ids = swig_ptr(I)
+    ha.val = swig_ptr(D)
+    ha.nh = m
+    ha.k = k
+    ha.heapify()
+    ha.addn(n, swig_ptr(array))
+    ha.reorder()
+    return D, I
+
+
+def kmax(array, k):
+    """return k largest values (and their indices) of the lines of a
+    float32 array"""
+    array = np.ascontiguousarray(array, dtype='float32')
+    m, n = array.shape
+    I = np.zeros((m, k), dtype='int64')
+    D = np.zeros((m, k), dtype='float32')
+    ha = faiss.float_minheap_array_t()
+    ha.ids = swig_ptr(I)
+    ha.val = swig_ptr(D)
+    ha.nh = m
+    ha.k = k
+    ha.heapify()
+    ha.addn(n, swig_ptr(array))
+    ha.reorder()
+    return D, I
+
+
+def pairwise_distances(xq, xb, metric=METRIC_L2, metric_arg=0):
+    """compute the whole pairwise distance matrix between two sets of
+    vectors"""
+    xq = np.ascontiguousarray(xq, dtype='float32')
+    xb = np.ascontiguousarray(xb, dtype='float32')
+    nq, d = xq.shape
+    nb, d2 = xb.shape
+    assert d == d2
+    dis = np.empty((nq, nb), dtype='float32')
+    if metric == METRIC_L2:
+        pairwise_L2sqr(
+            d, nq, swig_ptr(xq),
+            nb, swig_ptr(xb),
+            swig_ptr(dis))
+    elif metric == METRIC_INNER_PRODUCT:
+        dis[:] = xq @ xb.T
+    else:
+        pairwise_extra_distances(
+            d, nq, swig_ptr(xq),
+            nb, swig_ptr(xb),
+            metric, metric_arg,
+            swig_ptr(dis))
+    return dis
+
+
+def rand(n, seed=12345):
+    res = np.empty(n, dtype='float32')
+    float_rand(swig_ptr(res), res.size, seed)
+    return res
+
+
+def randint(n, seed=12345, vmax=None):
+    res = np.empty(n, dtype='int64')
+    if vmax is None:
+        int64_rand(swig_ptr(res), res.size, seed)
+    else:
+        int64_rand_max(swig_ptr(res), res.size, vmax, seed)
+    return res
+
+
+lrand = randint
+
+
+def randn(n, seed=12345):
+    res = np.empty(n, dtype='float32')
+    float_randn(swig_ptr(res), res.size, seed)
+    return res
+
+
+def checksum(a):
+    """ compute a checksum for quick-and-dirty comparisons of arrays """
+    a = a.view('uint8')
+    if a.ndim == 1:
+        return bvec_checksum(a.size, swig_ptr(a))
+    n, d = a.shape
+    cs = np.zeros(n, dtype='uint64')
+    bvecs_checksum(n, d, swig_ptr(a), swig_ptr(cs))
+    return cs
+
+rand_smooth_vectors_c = rand_smooth_vectors
+
+def rand_smooth_vectors(n, d, seed=1234):
+    res = np.empty((n, d), dtype='float32')
+    rand_smooth_vectors_c(n, d, swig_ptr(res), seed)
+    return res
+
+
+def eval_intersection(I1, I2):
+    """ size of intersection between each line of two result tables"""
+    I1 = np.ascontiguousarray(I1, dtype='int64')
+    I2 = np.ascontiguousarray(I2, dtype='int64')
+    n = I1.shape[0]
+    assert I2.shape[0] == n
+    k1, k2 = I1.shape[1], I2.shape[1]
+    ninter = 0
+    for i in range(n):
+        ninter += ranklist_intersection_size(
+            k1, swig_ptr(I1[i]), k2, swig_ptr(I2[i]))
+    return ninter
+
+
+def normalize_L2(x):
+    fvec_renorm_L2(x.shape[1], x.shape[0], swig_ptr(x))
+
+bucket_sort_c = bucket_sort
+
+def bucket_sort(tab, nbucket=None, nt=0):
+    """Perform a bucket sort on a table of integers.
+
+    Parameters
+    ----------
+    tab : array_like
+        elements to sort, max value nbucket - 1
+    nbucket : integer
+        number of buckets, None if unknown
+    nt : integer
+        number of threads to use (0 = use unthreaded codepath)
+
+    Returns
+    -------
+    lims : array_like
+        cumulative sum of bucket sizes (size vmax + 1)
+    perm : array_like
+        perm[lims[i] : lims[i + 1]] contains the indices of bucket #i (size tab.size)
+    """
+    tab = np.ascontiguousarray(tab, dtype="int64")
+    if nbucket is None:
+        nbucket = int(tab.max() + 1)
+    lims = np.empty(nbucket + 1, dtype='int64')
+    perm = np.empty(tab.size, dtype='int64')
+    bucket_sort_c(
+        tab.size, faiss.swig_ptr(tab.view('uint64')),
+        nbucket, faiss.swig_ptr(lims), faiss.swig_ptr(perm),
+        nt
+    )
+    return lims, perm
+
+matrix_bucket_sort_inplace_c = matrix_bucket_sort_inplace
+
+def matrix_bucket_sort_inplace(tab, nbucket=None, nt=0):
+    """Perform a bucket sort on a matrix, recording the original
+    row of each element.
+
+    Parameters
+    ----------
+    tab : array_like
+        array of size (N, ncol) that contains the bucket ids, maximum
+        value nbucket - 1.
+        On output, it the elements are shuffled such that the flat array
+        tab.ravel()[lims[i] : lims[i + 1]] contains the row numbers
+        of each bucket entry.
+    nbucket : integer
+        number of buckets (the maximum value in tab should be nbucket - 1)
+    nt : integer
+        number of threads to use (0 = use unthreaded codepath)
+
+    Returns
+    -------
+    lims : array_like
+        cumulative sum of bucket sizes (size vmax + 1)
+    """
+    assert tab.dtype == 'int32' or tab.dtype == 'int64'
+    nrow, ncol = tab.shape
+    if nbucket is None:
+        nbucket = int(tab.max() + 1)
+    lims = np.empty(nbucket + 1, dtype='int64')
+    matrix_bucket_sort_inplace_c(
+        nrow, ncol, faiss.swig_ptr(tab),
+        nbucket, faiss.swig_ptr(lims),
+        nt
+    )
+    return lims
+
+
+###########################################
+# ResultHeap
+###########################################
+
+class ResultHeap:
+    """Accumulate query results from a sliced dataset. The final result will
+    be in self.D, self.I."""
+
+    def __init__(self, nq, k, keep_max=False):
+        """
+        nq: number of query vectors,
+        k: number of results per query
+        keep_max: keep the top-k maximum values instead of the minima
+        """
+        self.I = np.zeros((nq, k), dtype='int64')
+        self.D = np.zeros((nq, k), dtype='float32')
+        self.nq, self.k = nq, k
+        if keep_max:
+            heaps = float_minheap_array_t()
+        else:
+            heaps = float_maxheap_array_t()
+        heaps.k = k
+        heaps.nh = nq
+        heaps.val = swig_ptr(self.D)
+        heaps.ids = swig_ptr(self.I)
+        heaps.heapify()
+        self.heaps = heaps
+
+    def add_result(self, D, I):
+        """
+        Add results for all heaps
+        D, I should be of size (nh, nres)
+        D, I do not need to be in a particular order (heap or sorted)
+        """
+        nq, kd = D.shape
+        D = np.ascontiguousarray(D, dtype='float32')
+        I = np.ascontiguousarray(I, dtype='int64')
+        assert I.shape == (nq, kd)
+        assert nq == self.nq
+        self.heaps.addn_with_ids(
+            kd, swig_ptr(D),
+            swig_ptr(I), kd)
+
+    def add_result_subset(self, subset, D, I):
+        """
+        Add results for a subset of heaps.
+        D, I should hold resutls for all the subset
+        as a special case, if I is 1D, then all ids are assumed to be the same
+        """
+        nsubset, kd = D.shape
+        assert nsubset == len(subset)
+        assert (
+            I.ndim == 2 and D.shape == I.shape or
+            I.ndim == 1 and I.shape == (kd, )
+        )
+        D = np.ascontiguousarray(D, dtype='float32')
+        I = np.ascontiguousarray(I, dtype='int64')
+        subset = np.ascontiguousarray(subset, dtype='int64')
+        id_stride = 0 if I.ndim == 1 else kd
+        self.heaps.addn_query_subset_with_ids(
+            nsubset, swig_ptr(subset),
+            kd, swig_ptr(D), swig_ptr(I), id_stride
+        )
+
+    def finalize(self):
+        self.heaps.reorder()
+
+
+def merge_knn_results(Dall, Iall, keep_max=False):
+    """
+    Merge a set of sorted knn-results obtained from different shards in a dataset
+    Dall and Iall are of size (nshard, nq, k) each D[i, j] should be sorted
+    returns D, I of size (nq, k) as the merged result set
+    """
+    assert Iall.shape == Dall.shape
+    nshard, n, k = Dall.shape
+    Dnew = np.empty((n, k), dtype=Dall.dtype)
+    Inew = np.empty((n, k), dtype=Iall.dtype)
+    func = merge_knn_results_CMax if keep_max else merge_knn_results_CMin
+    func(
+        n, k, nshard,
+        swig_ptr(Dall), swig_ptr(Iall),
+        swig_ptr(Dnew), swig_ptr(Inew)
+    )
+    return Dnew, Inew
+
+######################################################
+# Efficient ID to ID map
+######################################################
+
+class MapInt64ToInt64:
+
+    def __init__(self, capacity):
+        self.log2_capacity = int(np.log2(capacity))
+        assert capacity == 2 ** self.log2_capacity, "need power of 2 capacity"
+        self.capacity = capacity
+        self.tab = np.empty((capacity, 2), dtype='int64')
+        faiss.hashtable_int64_to_int64_init(self.log2_capacity, swig_ptr(self.tab))
+
+    def add(self, keys, vals):
+        n, = keys.shape
+        assert vals.shape == (n,)
+        faiss.hashtable_int64_to_int64_add(
+            self.log2_capacity, swig_ptr(self.tab),
+            n, swig_ptr(keys), swig_ptr(vals))
+
+    def lookup(self, keys):
+        n, = keys.shape
+        vals = np.empty((n,), dtype='int64')
+        faiss.hashtable_int64_to_int64_lookup(
+            self.log2_capacity, swig_ptr(self.tab),
+            n, swig_ptr(keys), swig_ptr(vals))
+        return vals
+
+######################################################
+# KNN function
+######################################################
+
+def knn(xq, xb, k, metric=METRIC_L2):
+    """
+    Compute the k nearest neighbors of a vector without constructing an index
+
+
+    Parameters
+    ----------
+    xq : array_like
+        Query vectors, shape (nq, d) where the dimension d is that same as xb
+        `dtype` must be float32.
+    xb : array_like
+        Database vectors, shape (nb, d) where dimension d is the same as xq
+        `dtype` must be float32.
+    k : int
+        Number of nearest neighbors.
+    distance_type : MetricType, optional
+        distance measure to use (either METRIC_L2 or METRIC_INNER_PRODUCT)
+
+    Returns
+    -------
+    D : array_like
+        Distances of the nearest neighbors, shape (nq, k)
+    I : array_like
+        Labels of the nearest neighbors, shape (nq, k)
+    """
+    xq = np.ascontiguousarray(xq, dtype='float32')
+    xb = np.ascontiguousarray(xb, dtype='float32')
+    nq, d = xq.shape
+    nb, d2 = xb.shape
+    assert d == d2
+
+    I = np.empty((nq, k), dtype='int64')
+    D = np.empty((nq, k), dtype='float32')
+
+    if metric == METRIC_L2:
+        knn_L2sqr(
+            swig_ptr(xq), swig_ptr(xb),
+            d, nq, nb, k, swig_ptr(D), swig_ptr(I)
+        )
+    elif metric == METRIC_INNER_PRODUCT:
+        knn_inner_product(
+            swig_ptr(xq), swig_ptr(xb),
+            d, nq, nb, k, swig_ptr(D), swig_ptr(I)
+        )
+    else:
+        raise NotImplementedError("only L2 and INNER_PRODUCT are supported")
+    return D, I
+
+def knn_hamming(xq, xb, k, variant="hc"):
+    """
+    Compute the k nearest neighbors of a set of vectors without constructing an index.
+
+    Parameters
+    ----------
+    xq : array_like
+        Query vectors, shape (nq, d) where d is the number of bits / 8
+        `dtype` must be uint8.
+    xb : array_like
+        Database vectors, shape (nb, d) where d is the number of bits / 8
+        `dtype` must be uint8.
+    k : int
+        Number of nearest neighbors.
+    variant : string
+        Function variant to use, either "mc" (counter) or "hc" (heap)
+
+    Returns
+    -------
+    D : array_like
+        Distances of the nearest neighbors, shape (nq, k)
+    I : array_like
+        Labels of the nearest neighbors, shape (nq, k)
+    """
+    # other variant is "mc"
+    nq, d = xq.shape
+    nb, d2 = xb.shape
+    assert d == d2
+    D = np.empty((nq, k), dtype='int32')
+    I = np.empty((nq, k), dtype='int64')
+
+    if variant == "hc":
+        heap = faiss.int_maxheap_array_t()
+        heap.k = k
+        heap.nh = nq
+        heap.ids = faiss.swig_ptr(I)
+        heap.val = faiss.swig_ptr(D)
+        faiss.hammings_knn_hc(
+            heap, faiss.swig_ptr(xq), faiss.swig_ptr(xb), nb,
+            d, 1
+        )
+    elif variant == "mc":
+        faiss.hammings_knn_mc(
+            faiss.swig_ptr(xq), faiss.swig_ptr(xb), nq, nb, k, d,
+            faiss.swig_ptr(D), faiss.swig_ptr(I)
+        )
+    else:
+        raise NotImplementedError
+    return D, I
+
+
+###########################################
+# Kmeans object
+###########################################
+
+
+class Kmeans:
+    """Object that performs k-means clustering and manages the centroids.
+    The `Kmeans` class is essentially a wrapper around the C++ `Clustering` object.
+
+    Parameters
+    ----------
+    d : int
+       dimension of the vectors to cluster
+    k : int
+       number of clusters
+    gpu: bool or int, optional
+       False: don't use GPU
+       True: use all GPUs
+       number: use this many GPUs
+    progressive_dim_steps:
+        use a progressive dimension clustering (with that number of steps)
+
+    Subsequent parameters are fields of the Clustring object. The most important are:
+
+    niter: int, optional
+       clustering iterations
+    nredo: int, optional
+       redo clustering this many times and keep best
+    verbose: bool, optional
+    spherical: bool, optional
+       do we want normalized centroids?
+    int_centroids: bool, optional
+       round centroids coordinates to integer
+    seed: int, optional
+       seed for the random number generator
+
+    """
+
+    def __init__(self, d, k, **kwargs):
+        """d: input dimension, k: nb of centroids. Additional
+         parameters are passed on the ClusteringParameters object,
+         including niter=25, verbose=False, spherical = False
+        """
+        self.d = d
+        self.reset(k)
+        self.gpu = False
+        if "progressive_dim_steps" in kwargs:
+            self.cp = ProgressiveDimClusteringParameters()
+        else:
+            self.cp = ClusteringParameters()
+        for k, v in kwargs.items():
+            if k == 'gpu':
+                if v == True or v == -1:
+                    v = get_num_gpus()
+                self.gpu = v
+            else:
+                # if this raises an exception, it means that it is a non-existent field
+                getattr(self.cp, k)
+                setattr(self.cp, k, v)
+        self.set_index()
+
+    def set_index(self):
+        d = self.d
+        if self.cp.__class__ == ClusteringParameters:
+            if self.cp.spherical:
+                self.index = IndexFlatIP(d)
+            else:
+                self.index = IndexFlatL2(d)
+            if self.gpu:
+                self.index = faiss.index_cpu_to_all_gpus(self.index, ngpu=self.gpu)
+        else:
+            if self.gpu:
+                fac = GpuProgressiveDimIndexFactory(ngpu=self.gpu)
+            else:
+                fac = ProgressiveDimIndexFactory()
+            self.fac = fac
+
+    def reset(self, k=None):
+        """ prepare k-means object to perform a new clustering, possibly
+        with another number of centroids """
+        if k is not None:
+            self.k = int(k)
+        self.centroids = None
+        self.obj = None
+        self.iteration_stats = None
+
+    def train(self, x, weights=None, init_centroids=None):
+        """ Perform k-means clustering.
+        On output of the function call:
+
+        - the centroids are in the centroids field of size (`k`, `d`).
+
+        - the objective value at each iteration is in the array obj (size `niter`)
+
+        - detailed optimization statistics are in the array iteration_stats.
+
+        Parameters
+        ----------
+        x : array_like
+            Training vectors, shape (n, d), `dtype` must be float32 and n should
+            be larger than the number of clusters `k`.
+        weights : array_like
+            weight associated to each vector, shape `n`
+        init_centroids : array_like
+            initial set of centroids, shape (n, d)
+
+        Returns
+        -------
+        final_obj: float
+            final optimization objective
+
+        """
+        x = np.ascontiguousarray(x, dtype='float32')
+        n, d = x.shape
+        assert d == self.d
+
+        if self.cp.__class__ == ClusteringParameters:
+            # regular clustering
+            clus = Clustering(d, self.k, self.cp)
+            if init_centroids is not None:
+                nc, d2 = init_centroids.shape
+                assert d2 == d
+                faiss.copy_array_to_vector(init_centroids.ravel(), clus.centroids)
+            clus.train(x, self.index, weights)
+        else:
+            # not supported for progressive dim
+            assert weights is None
+            assert init_centroids is None
+            assert not self.cp.spherical
+            clus = ProgressiveDimClustering(d, self.k, self.cp)
+            clus.train(n, swig_ptr(x), self.fac)
+
+        centroids = faiss.vector_float_to_array(clus.centroids)
+
+        self.centroids = centroids.reshape(self.k, d)
+        stats = clus.iteration_stats
+        stats = [stats.at(i) for i in range(stats.size())]
+        self.obj = np.array([st.obj for st in stats])
+        # copy all the iteration_stats objects to a python array
+        stat_fields = 'obj time time_search imbalance_factor nsplit'.split()
+        self.iteration_stats = [
+            {field: getattr(st, field) for field in stat_fields}
+            for st in stats
+        ]
+        return self.obj[-1] if self.obj.size > 0 else 0.0
+
+    def assign(self, x):
+        x = np.ascontiguousarray(x, dtype='float32')
+        assert self.centroids is not None, "should train before assigning"
+        self.index.reset()
+        self.index.add(self.centroids)
+        D, I = self.index.search(x, 1)
+        return D.ravel(), I.ravel()
+
+
+###########################################
+# Packing and unpacking bistrings
+###########################################
+
+def is_sequence(x):
+    return isinstance(x, collections.abc.Sequence)
+
+pack_bitstrings_c = pack_bitstrings
+
+def pack_bitstrings(a, nbit):
+    """
+    Pack a set integers (i, j) where i=0:n and j=0:M into
+    n bitstrings.
+    Output is an uint8 array of size (n, code_size), where code_size is
+    such that at most 7 bits per code are wasted.
+
+    If nbit is an integer: all entries takes nbit bits.
+    If nbit is an array: entry (i, j) takes nbit[j] bits.
+    """
+    n, M = a.shape
+    a = np.ascontiguousarray(a, dtype='int32')
+    if is_sequence(nbit):
+        nbit = np.ascontiguousarray(nbit, dtype='int32')
+        assert nbit.shape == (M,)
+        code_size = int((nbit.sum() + 7) // 8)
+        b = np.empty((n, code_size), dtype='uint8')
+        pack_bitstrings_c(
+            n, M, swig_ptr(nbit), swig_ptr(a), swig_ptr(b), code_size)
+    else:
+        code_size = (M * nbit + 7) // 8
+        b = np.empty((n, code_size), dtype='uint8')
+        pack_bitstrings_c(n, M, nbit, swig_ptr(a), swig_ptr(b), code_size)
+    return b
+
+unpack_bitstrings_c = unpack_bitstrings
+
+def unpack_bitstrings(b, M_or_nbits, nbit=None):
+    """
+    Unpack a set integers (i, j) where i=0:n and j=0:M from
+    n bitstrings (encoded as uint8s).
+    Input is an uint8 array of size (n, code_size), where code_size is
+    such that at most 7 bits per code are wasted.
+
+    Two forms:
+    - when called with (array, M, nbit): there are M entries of size
+      nbit per row
+    - when called with (array, nbits): element (i, j) is encoded in
+      nbits[j] bits
+    """
+    n, code_size = b.shape
+    if nbit is None:
+        nbit = np.ascontiguousarray(M_or_nbits, dtype='int32')
+        M = len(nbit)
+        min_code_size = int((nbit.sum() + 7) // 8)
+        assert code_size >= min_code_size
+        a = np.empty((n, M), dtype='int32')
+        unpack_bitstrings_c(
+            n, M, swig_ptr(nbit),
+            swig_ptr(b), code_size, swig_ptr(a))
+    else:
+        M = M_or_nbits
+        min_code_size = (M * nbit + 7) // 8
+        assert code_size >= min_code_size
+        a = np.empty((n, M), dtype='int32')
+        unpack_bitstrings_c(
+            n, M, nbit, swig_ptr(b), code_size, swig_ptr(a))
+    return a
diff --git a/llm/Lib/site-packages/faiss/gpu_wrappers.py b/llm/Lib/site-packages/faiss/gpu_wrappers.py
new file mode 100644
index 0000000000000000000000000000000000000000..7b49f90243bfbb47a4914e77e9dd5b71c0d65542
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/gpu_wrappers.py
@@ -0,0 +1,293 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+# @nolint
+
+# not linting this file because it imports * from swigfaiss, which
+# causes a ton of useless warnings.
+
+import numpy as np
+
+from faiss.loader import *
+
+
+###########################################
+# GPU functions
+###########################################
+
+
+def index_cpu_to_gpu_multiple_py(resources, index, co=None, gpus=None):
+    """ builds the C++ vectors for the GPU indices and the
+    resources. Handles the case where the resources are assigned to
+    the list of GPUs """
+    if gpus is None:
+        gpus = range(len(resources))
+    vres = GpuResourcesVector()
+    vdev = Int32Vector()
+    for i, res in zip(gpus, resources):
+        vdev.push_back(i)
+        vres.push_back(res)
+    if isinstance(index, IndexBinary):
+        return index_binary_cpu_to_gpu_multiple(vres, vdev, index, co)
+    else:
+        return index_cpu_to_gpu_multiple(vres, vdev, index, co)
+
+
+def index_cpu_to_all_gpus(index, co=None, ngpu=-1):
+    index_gpu = index_cpu_to_gpus_list(index, co=co, gpus=None, ngpu=ngpu)
+    return index_gpu
+
+
+def index_cpu_to_gpus_list(index, co=None, gpus=None, ngpu=-1):
+    """ Here we can pass list of GPU ids as a parameter or ngpu to
+    use first n GPU's. gpus mut be a list or None.
+    co is a GpuMultipleClonerOptions
+    """
+    if (gpus is None) and (ngpu == -1):  # All blank
+        gpus = range(get_num_gpus())
+    elif (gpus is None) and (ngpu != -1):  # Get number of GPU's only
+        gpus = range(ngpu)
+    res = [StandardGpuResources() for _ in gpus]
+    index_gpu = index_cpu_to_gpu_multiple_py(res, index, co, gpus)
+    return index_gpu
+
+# allows numpy ndarray usage with bfKnn
+
+
+def knn_gpu(res, xq, xb, k, D=None, I=None, metric=METRIC_L2, device=-1, use_raft=False, vectorsMemoryLimit=0, queriesMemoryLimit=0):
+    """
+    Compute the k nearest neighbors of a vector on one GPU without constructing an index
+
+    Parameters
+    ----------
+    res : StandardGpuResources
+        GPU resources to use during computation
+    xq : array_like
+        Query vectors, shape (nq, d) where d is appropriate for the index.
+        `dtype` must be float32.
+    xb : array_like
+        Database vectors, shape (nb, d) where d is appropriate for the index.
+        `dtype` must be float32.
+    k : int
+        Number of nearest neighbors.
+    D : array_like, optional
+        Output array for distances of the nearest neighbors, shape (nq, k)
+    I : array_like, optional
+        Output array for the nearest neighbors, shape (nq, k)
+    metric : MetricType, optional
+        Distance measure to use (either METRIC_L2 or METRIC_INNER_PRODUCT)
+    device: int, optional
+        Which CUDA device in the system to run the search on. -1 indicates that
+        the current thread-local device state (via cudaGetDevice) should be used
+        (can also be set via torch.cuda.set_device in PyTorch)
+        Otherwise, an integer 0 <= device < numDevices indicates the GPU on which
+        the computation should be run
+    vectorsMemoryLimit: int, optional
+    queriesMemoryLimit: int, optional
+        Memory limits for vectors and queries.
+        If not 0, the GPU will use at most this amount of memory
+        for vectors and queries respectively.
+        Vectors are broken up into chunks of size vectorsMemoryLimit,
+        and queries are broken up into chunks of size queriesMemoryLimit,
+        including the memory required for the results.
+
+    Returns
+    -------
+    D : array_like
+        Distances of the nearest neighbors, shape (nq, k)
+    I : array_like
+        Labels of the nearest neighbors, shape (nq, k)
+    """
+    nq, d = xq.shape
+    if xq.flags.c_contiguous:
+        xq_row_major = True
+    elif xq.flags.f_contiguous:
+        xq = xq.T
+        xq_row_major = False
+    else:
+        xq = np.ascontiguousarray(xq, dtype='float32')
+        xq_row_major = True
+
+    xq_ptr = swig_ptr(xq)
+
+    if xq.dtype == np.float32:
+        xq_type = DistanceDataType_F32
+    elif xq.dtype == np.float16:
+        xq_type = DistanceDataType_F16
+    else:
+        raise TypeError('xq must be f32 or f16')
+
+    nb, d2 = xb.shape
+    assert d2 == d
+    if xb.flags.c_contiguous:
+        xb_row_major = True
+    elif xb.flags.f_contiguous:
+        xb = xb.T
+        xb_row_major = False
+    else:
+        xb = np.ascontiguousarray(xb, dtype='float32')
+        xb_row_major = True
+
+    xb_ptr = swig_ptr(xb)
+
+    if xb.dtype == np.float32:
+        xb_type = DistanceDataType_F32
+    elif xb.dtype == np.float16:
+        xb_type = DistanceDataType_F16
+    else:
+        raise TypeError('xb must be float32 or float16')
+
+    if D is None:
+        D = np.empty((nq, k), dtype=np.float32)
+    else:
+        assert D.shape == (nq, k)
+        # interface takes void*, we need to check this
+        assert D.dtype == np.float32
+
+    D_ptr = swig_ptr(D)
+
+    if I is None:
+        I = np.empty((nq, k), dtype=np.int64)
+    else:
+        assert I.shape == (nq, k)
+
+    I_ptr = swig_ptr(I)
+
+    if I.dtype == np.int64:
+        I_type = IndicesDataType_I64
+    elif I.dtype == I.dtype == np.int32:
+        I_type = IndicesDataType_I32
+    else:
+        raise TypeError('I must be i64 or i32')
+
+    args = GpuDistanceParams()
+    args.metric = metric
+    args.k = k
+    args.dims = d
+    args.vectors = xb_ptr
+    args.vectorsRowMajor = xb_row_major
+    args.vectorType = xb_type
+    args.numVectors = nb
+    args.queries = xq_ptr
+    args.queriesRowMajor = xq_row_major
+    args.queryType = xq_type
+    args.numQueries = nq
+    args.outDistances = D_ptr
+    args.outIndices = I_ptr
+    args.outIndicesType = I_type
+    args.device = device
+    args.use_raft = use_raft
+
+    # no stream synchronization needed, inputs and outputs are guaranteed to
+    # be on the CPU (numpy arrays)
+    if vectorsMemoryLimit > 0 or queriesMemoryLimit > 0:
+        bfKnn_tiling(res, args, vectorsMemoryLimit, queriesMemoryLimit)
+    else:
+        bfKnn(res, args)
+
+    return D, I
+
+# allows numpy ndarray usage with bfKnn for all pairwise distances
+
+
+def pairwise_distance_gpu(res, xq, xb, D=None, metric=METRIC_L2, device=-1):
+    """
+    Compute all pairwise distances between xq and xb on one GPU without constructing an index
+
+    Parameters
+    ----------
+    res : StandardGpuResources
+        GPU resources to use during computation
+    xq : array_like
+        Query vectors, shape (nq, d) where d is appropriate for the index.
+        `dtype` must be float32.
+    xb : array_like
+        Database vectors, shape (nb, d) where d is appropriate for the index.
+        `dtype` must be float32.
+    D : array_like, optional
+        Output array for all pairwise distances, shape (nq, nb)
+    metric : MetricType, optional
+        Distance measure to use (either METRIC_L2 or METRIC_INNER_PRODUCT)
+    device: int, optional
+        Which CUDA device in the system to run the search on. -1 indicates that
+        the current thread-local device state (via cudaGetDevice) should be used
+        (can also be set via torch.cuda.set_device in PyTorch)
+        Otherwise, an integer 0 <= device < numDevices indicates the GPU on which
+        the computation should be run
+
+    Returns
+    -------
+    D : array_like
+        All pairwise distances, shape (nq, nb)
+    """
+    nq, d = xq.shape
+    if xq.flags.c_contiguous:
+        xq_row_major = True
+    elif xq.flags.f_contiguous:
+        xq = xq.T
+        xq_row_major = False
+    else:
+        raise TypeError(
+            'xq matrix should be row (C) or column-major (Fortran)')
+
+    xq_ptr = swig_ptr(xq)
+
+    if xq.dtype == np.float32:
+        xq_type = DistanceDataType_F32
+    elif xq.dtype == np.float16:
+        xq_type = DistanceDataType_F16
+    else:
+        xq = np.ascontiguousarray(xb, dtype='float32')
+        xq_row_major = True
+
+    nb, d2 = xb.shape
+    assert d2 == d
+    if xb.flags.c_contiguous:
+        xb_row_major = True
+    elif xb.flags.f_contiguous:
+        xb = xb.T
+        xb_row_major = False
+    else:
+        xb = np.ascontiguousarray(xb, dtype='float32')
+        xb_row_major = True
+
+    xb_ptr = swig_ptr(xb)
+
+    if xb.dtype == np.float32:
+        xb_type = DistanceDataType_F32
+    elif xb.dtype == np.float16:
+        xb_type = DistanceDataType_F16
+    else:
+        raise TypeError('xb must be float32 or float16')
+
+    if D is None:
+        D = np.empty((nq, nb), dtype=np.float32)
+    else:
+        assert D.shape == (nq, nb)
+        # interface takes void*, we need to check this
+        assert D.dtype == np.float32
+
+    D_ptr = swig_ptr(D)
+
+    args = GpuDistanceParams()
+    args.metric = metric
+    args.k = -1  # selects all pairwise distances
+    args.dims = d
+    args.vectors = xb_ptr
+    args.vectorsRowMajor = xb_row_major
+    args.vectorType = xb_type
+    args.numVectors = nb
+    args.queries = xq_ptr
+    args.queriesRowMajor = xq_row_major
+    args.queryType = xq_type
+    args.numQueries = nq
+    args.outDistances = D_ptr
+    args.device = device
+
+    # no stream synchronization needed, inputs and outputs are guaranteed to
+    # be on the CPU (numpy arrays)
+    bfKnn(res, args)
+
+    return D
diff --git a/llm/Lib/site-packages/faiss/loader.py b/llm/Lib/site-packages/faiss/loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..b66e75131af8818f8cfc5860199a0e018cfa3d2b
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/loader.py
@@ -0,0 +1,99 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+from packaging.version import Version
+import platform
+import subprocess
+import logging
+import os
+
+
+def supported_instruction_sets():
+    """
+    Returns the set of supported CPU features, see
+    https://github.com/numpy/numpy/blob/master/numpy/core/src/common/npy_cpu_features.h
+    for the list of features that this set may contain per architecture.
+
+    Example:
+    >>> supported_instruction_sets()  # for x86
+    {"SSE2", "AVX2", "AVX512", ...}
+    >>> supported_instruction_sets()  # for PPC
+    {"VSX", "VSX2", ...}
+    >>> supported_instruction_sets()  # for ARM
+    {"NEON", "ASIMD", ...}
+    """
+    import numpy
+    if Version(numpy.__version__) >= Version("1.19"):
+        # use private API as next-best thing until numpy/numpy#18058 is solved
+        from numpy.core._multiarray_umath import __cpu_features__
+        # __cpu_features__ is a dictionary with CPU features
+        # as keys, and True / False as values
+        supported = {k for k, v in __cpu_features__.items() if v}
+        for f in os.getenv("FAISS_DISABLE_CPU_FEATURES", "").split(", \t\n\r"):
+            supported.discard(f)
+        return supported
+
+    # platform-dependent legacy fallback before numpy 1.19, no windows
+    if platform.system() == "Darwin":
+        if subprocess.check_output(["/usr/sbin/sysctl", "hw.optional.avx2_0"])[-1] == '1':
+            return {"AVX2"}
+    elif platform.system() == "Linux":
+        import numpy.distutils.cpuinfo
+        result = set()
+        if "avx2" in numpy.distutils.cpuinfo.cpu.info[0].get('flags', ""):
+            result.add("AVX2")
+        if "avx512" in numpy.distutils.cpuinfo.cpu.info[0].get('flags', ""):
+            result.add("AVX512")
+        return result
+    return set()
+
+
+logger = logging.getLogger(__name__)
+
+instruction_sets = None
+
+# try to load optimization level from env variable
+opt_env_variable_name = "FAISS_OPT_LEVEL"
+opt_level = os.environ.get(opt_env_variable_name, None)
+
+if opt_level is None:
+    logger.debug(f"Environment variable {opt_env_variable_name} is not set, " \
+                "so let's pick the instruction set according to the current CPU")
+    instruction_sets = supported_instruction_sets()
+else:
+    logger.debug(f"Using {opt_level} as an instruction set.")
+    instruction_sets = set()
+    instruction_sets.add(opt_level)
+
+loaded = False
+has_AVX512 = any("AVX512" in x.upper() for x in instruction_sets)
+if has_AVX512:
+    try:
+        logger.info("Loading faiss with AVX512 support.")
+        from .swigfaiss_avx512 import *
+        logger.info("Successfully loaded faiss with AVX512 support.")
+        loaded = True
+    except ImportError as e:
+        logger.info(f"Could not load library with AVX512 support due to:\n{e!r}")
+        # reset so that we load without AVX512 below
+        loaded = False
+
+has_AVX2 = "AVX2" in instruction_sets
+if has_AVX2 and not loaded:
+    try:
+        logger.info("Loading faiss with AVX2 support.")
+        from .swigfaiss_avx2 import *
+        logger.info("Successfully loaded faiss with AVX2 support.")
+        loaded = True
+    except ImportError as e:
+        logger.info(f"Could not load library with AVX2 support due to:\n{e!r}")
+        # reset so that we load without AVX2 below
+        loaded = False
+
+if not loaded:
+    # we import * so that the symbol X can be accessed as faiss.X
+    logger.info("Loading faiss.")
+    from .swigfaiss import *
+    logger.info("Successfully loaded faiss.")
diff --git a/llm/Lib/site-packages/faiss/python_callbacks.h b/llm/Lib/site-packages/faiss/python_callbacks.h
new file mode 100644
index 0000000000000000000000000000000000000000..8730246e2b4402651fd691e43c876aed4cb62d8b
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/python_callbacks.h
@@ -0,0 +1,60 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#pragma once
+
+#include <faiss/impl/IDSelector.h>
+#include <faiss/impl/io.h>
+#include <faiss/invlists/InvertedLists.h>
+#include "Python.h"
+
+//  all callbacks have to acquire the GIL on input
+
+/***********************************************************
+ * Callbacks for IO reader and writer
+ ***********************************************************/
+
+struct PyCallbackIOWriter : faiss::IOWriter {
+    PyObject* callback;
+    size_t bs; // maximum write size
+
+    /** Callback: Python function that takes a bytes object and
+     *  returns the number of bytes successfully written.
+     */
+    explicit PyCallbackIOWriter(PyObject* callback, size_t bs = 1024 * 1024);
+
+    size_t operator()(const void* ptrv, size_t size, size_t nitems) override;
+
+    ~PyCallbackIOWriter() override;
+};
+
+struct PyCallbackIOReader : faiss::IOReader {
+    PyObject* callback;
+    size_t bs; // maximum buffer size
+
+    /** Callback: Python function that takes a size and returns a
+     * bytes object with the resulting read */
+    explicit PyCallbackIOReader(PyObject* callback, size_t bs = 1024 * 1024);
+
+    size_t operator()(void* ptrv, size_t size, size_t nitems) override;
+
+    ~PyCallbackIOReader() override;
+};
+
+/***********************************************************
+ * Callbacks for IDSelector
+ ***********************************************************/
+
+struct PyCallbackIDSelector : faiss::IDSelector {
+    PyObject* callback;
+
+    explicit PyCallbackIDSelector(PyObject* callback);
+
+    bool is_member(faiss::idx_t id) const override;
+
+    ~PyCallbackIDSelector() override;
+};
diff --git a/llm/Lib/site-packages/faiss/setup.py b/llm/Lib/site-packages/faiss/setup.py
new file mode 100644
index 0000000000000000000000000000000000000000..eb4fa40817e38431ff957687eb6a9b7372110a0a
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/setup.py
@@ -0,0 +1,78 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+from __future__ import print_function
+from setuptools import setup, find_packages
+import os
+import shutil
+import platform
+
+# make the faiss python package dir
+shutil.rmtree("faiss", ignore_errors=True)
+os.mkdir("faiss")
+shutil.copytree("contrib", "faiss/contrib")
+shutil.copyfile("__init__.py", "faiss/__init__.py")
+shutil.copyfile("loader.py", "faiss/loader.py")
+shutil.copyfile("class_wrappers.py", "faiss/class_wrappers.py")
+shutil.copyfile("gpu_wrappers.py", "faiss/gpu_wrappers.py")
+shutil.copyfile("extra_wrappers.py", "faiss/extra_wrappers.py")
+shutil.copyfile("array_conversions.py", "faiss/array_conversions.py")
+
+ext = ".pyd" if platform.system() == 'Windows' else ".so"
+prefix = "Release/" * (platform.system() == 'Windows')
+
+swigfaiss_generic_lib = f"{prefix}_swigfaiss{ext}"
+swigfaiss_avx2_lib = f"{prefix}_swigfaiss_avx2{ext}"
+swigfaiss_avx512_lib = f"{prefix}_swigfaiss_avx512{ext}"
+
+found_swigfaiss_generic = os.path.exists(swigfaiss_generic_lib)
+found_swigfaiss_avx2 = os.path.exists(swigfaiss_avx2_lib)
+found_swigfaiss_avx512 = os.path.exists(swigfaiss_avx512_lib)
+
+assert (found_swigfaiss_generic or found_swigfaiss_avx2 or found_swigfaiss_avx512), \
+    f"Could not find {swigfaiss_generic_lib} or " \
+    f"{swigfaiss_avx2_lib} or {swigfaiss_avx512_lib}. Faiss may not be compiled yet."
+
+if found_swigfaiss_generic:
+    print(f"Copying {swigfaiss_generic_lib}")
+    shutil.copyfile("swigfaiss.py", "faiss/swigfaiss.py")
+    shutil.copyfile(swigfaiss_generic_lib, f"faiss/_swigfaiss{ext}")
+
+if found_swigfaiss_avx2:
+    print(f"Copying {swigfaiss_avx2_lib}")
+    shutil.copyfile("swigfaiss_avx2.py", "faiss/swigfaiss_avx2.py")
+    shutil.copyfile(swigfaiss_avx2_lib, f"faiss/_swigfaiss_avx2{ext}")
+
+if found_swigfaiss_avx512:
+    print(f"Copying {swigfaiss_avx512_lib}")
+    shutil.copyfile("swigfaiss_avx512.py", "faiss/swigfaiss_avx512.py")
+    shutil.copyfile(swigfaiss_avx512_lib, f"faiss/_swigfaiss_avx512{ext}")
+
+long_description="""
+Faiss is a library for efficient similarity search and clustering of dense
+vectors. It contains algorithms that search in sets of vectors of any size,
+ up to ones that possibly do not fit in RAM. It also contains supporting
+code for evaluation and parameter tuning. Faiss is written in C++ with
+complete wrappers for Python/numpy. Some of the most useful algorithms
+are implemented on the GPU. It is developed by Facebook AI Research.
+"""
+setup(
+    name='faiss',
+    version='1.8.0',
+    description='A library for efficient similarity search and clustering of dense vectors',
+    long_description=long_description,
+    url='https://github.com/facebookresearch/faiss',
+    author='Matthijs Douze, Jeff Johnson, Herve Jegou, Lucas Hosseini',
+    author_email='matthijs@fb.com',
+    license='MIT',
+    keywords='search nearest neighbors',
+
+    install_requires=['numpy', 'packaging'],
+    packages=['faiss', 'faiss.contrib'],
+    package_data={
+        'faiss': ['*.so', '*.pyd'],
+    },
+    zip_safe=False,
+)
diff --git a/llm/Lib/site-packages/faiss/swigfaiss.i b/llm/Lib/site-packages/faiss/swigfaiss.i
new file mode 100644
index 0000000000000000000000000000000000000000..b1043fce7c993ebe119e6dd0698e4eab32c86be9
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/swigfaiss.i
@@ -0,0 +1,1140 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// -*- C++ -*-
+
+// This file describes the C++-scripting language bridge for Python (and formerly Lua).
+// It contains mainly includes and a few macros. There are
+// 2 preprocessor macros of interest:
+
+// SWIGPYTHON: Python-specific code
+// GPU_WRAPPER: also compile interfaces for GPU.
+
+%module swigfaiss;
+
+// NOTE: While parsing the headers to generate the interface, SWIG does not know
+// about `_MSC_VER`.
+// TODO: Remove the need for this hack.
+#ifdef SWIGWIN
+#define _MSC_VER
+%include <windows.i>
+#endif // SWIGWIN
+
+// fbode SWIG fails on warnings, so make them non fatal
+#pragma SWIG nowarn=321
+#pragma SWIG nowarn=403
+#pragma SWIG nowarn=325
+#pragma SWIG nowarn=389
+#pragma SWIG nowarn=341
+#pragma SWIG nowarn=512
+#pragma SWIG nowarn=362
+
+%include <stdint.i>
+
+typedef uint64_t size_t;
+
+
+#define __restrict
+
+
+/*******************************************************************
+ * Copied verbatim to wrapper. Contains the C++-visible includes, and
+ * the language includes for their respective matrix libraries.
+ *******************************************************************/
+
+%{
+
+
+#include <stdint.h>
+#include <omp.h>
+
+
+
+#ifdef SWIGPYTHON
+
+#undef popcount64
+
+#define SWIG_FILE_WITH_INIT
+#define NPY_NO_DEPRECATED_API NPY_1_7_API_VERSION
+#include <numpy/arrayobject.h>
+
+#endif
+
+
+#include <faiss/IndexFlat.h>
+#include <faiss/VectorTransform.h>
+#include <faiss/IndexPreTransform.h>
+#include <faiss/IndexLSH.h>
+#include <faiss/IndexPQ.h>
+#include <faiss/IndexAdditiveQuantizer.h>
+#include <faiss/IndexIVF.h>
+#include <faiss/IndexIVFPQ.h>
+#include <faiss/Index2Layer.h>
+#include <faiss/IndexIVFPQR.h>
+#include <faiss/IndexIVFFlat.h>
+#include <faiss/IndexIVFIndependentQuantizer.h>
+
+#include <faiss/IndexFastScan.h>
+#include <faiss/IndexAdditiveQuantizerFastScan.h>
+#include <faiss/IndexPQFastScan.h>
+#include <faiss/utils/simdlib.h>
+#include <faiss/impl/simd_result_handlers.h>
+
+#include <faiss/IndexIVFFastScan.h>
+#include <faiss/IndexIVFAdditiveQuantizerFastScan.h>
+#include <faiss/IndexIVFPQFastScan.h>
+#include <faiss/utils/quantize_lut.h>
+
+#include <faiss/IndexScalarQuantizer.h>
+#include <faiss/IndexIVFAdditiveQuantizer.h>
+#include <faiss/IndexIVFSpectralHash.h>
+#include <faiss/impl/ThreadedIndex.h>
+#include <faiss/IndexShards.h>
+#include <faiss/IndexShardsIVF.h>
+#include <faiss/IndexReplicas.h>
+#include <faiss/impl/HNSW.h>
+#include <faiss/IndexHNSW.h>
+
+#include <faiss/impl/kmeans1d.h>
+
+#include <faiss/impl/NNDescent.h>
+#include <faiss/IndexNNDescent.h>
+
+#include <faiss/impl/NSG.h>
+#include <faiss/IndexNSG.h>
+
+#include <faiss/MetaIndexes.h>
+#include <faiss/IndexIDMap.h>
+#include <faiss/IndexRefine.h>
+
+#include <faiss/IndexRowwiseMinMax.h>
+
+#include <faiss/impl/FaissAssert.h>
+
+#include <faiss/IndexBinaryFlat.h>
+#include <faiss/IndexBinaryIVF.h>
+#include <faiss/IndexBinaryFromFloat.h>
+#include <faiss/IndexBinaryHNSW.h>
+#include <faiss/IndexBinaryHash.h>
+
+#include <faiss/impl/io.h>
+#include <faiss/index_io.h>
+#include <faiss/clone_index.h>
+
+#include <faiss/IVFlib.h>
+#include <faiss/utils/utils.h>
+
+#include <faiss/utils/sorting.h>
+#include <faiss/utils/distances.h>
+#include <faiss/utils/extra_distances.h>
+#include <faiss/utils/random.h>
+#include <faiss/utils/Heap.h>
+#include <faiss/utils/AlignedTable.h>
+#include <faiss/utils/partitioning.h>
+#include <faiss/impl/AuxIndexStructures.h>
+#include <faiss/impl/IDSelector.h>
+#include <faiss/impl/DistanceComputer.h>
+#include <faiss/impl/AdditiveQuantizer.h>
+#include <faiss/impl/ResidualQuantizer.h>
+#include <faiss/impl/residual_quantizer_encode_steps.h>
+
+#include <faiss/impl/LocalSearchQuantizer.h>
+#include <faiss/impl/ProductAdditiveQuantizer.h>
+#include <faiss/impl/CodePacker.h>
+
+#include <faiss/invlists/BlockInvertedLists.h>
+
+#ifndef _MSC_VER
+#include <faiss/invlists/OnDiskInvertedLists.h>
+#endif // !_MSC_VER
+
+#include <faiss/Clustering.h>
+
+#include <faiss/utils/hamming.h>
+#include <faiss/utils/hamming_distance/common.h>
+
+#include <faiss/AutoTune.h>
+#include <faiss/MatrixStats.h>
+#include <faiss/index_factory.h>
+
+#include <faiss/impl/lattice_Zn.h>
+#include <faiss/IndexLattice.h>
+
+
+%}
+
+/********************************************************
+ * GIL manipulation and exception handling
+ ********************************************************/
+
+#ifdef SWIGPYTHON
+// %catches(faiss::FaissException);
+
+
+// Python-specific: release GIL by default for all functions
+%exception {
+    Py_BEGIN_ALLOW_THREADS
+    try {
+        $action
+    } catch(faiss::FaissException & e) {
+        PyEval_RestoreThread(_save);
+
+        if (PyErr_Occurred()) {
+            // some previous code already set the error type.
+        } else {
+            PyErr_SetString(PyExc_RuntimeError, e.what());
+        }
+        SWIG_fail;
+    } catch(std::bad_alloc & ba) {
+        PyEval_RestoreThread(_save);
+        PyErr_SetString(PyExc_MemoryError, "std::bad_alloc");
+        SWIG_fail;
+    } catch(const std::exception& ex) {
+        PyEval_RestoreThread(_save);
+        std::string what = std::string("C++ exception ") + ex.what();
+        PyErr_SetString(PyExc_RuntimeError, what.c_str());
+        SWIG_fail;
+    }
+    Py_END_ALLOW_THREADS
+}
+
+#endif
+
+
+/*******************************************************************
+ * Types of vectors we want to manipulate at the scripting language
+ * level.
+ *******************************************************************/
+
+// simplified interface for vector
+namespace std {
+
+    template<class T>
+    class vector {
+    public:
+        vector();
+        void push_back(T);
+        void clear();
+        T * data();
+        size_t size();
+        T at (size_t n) const;
+        T & operator [] (size_t n);
+        void resize (size_t n);
+
+        void swap (vector<T> & other);
+    };
+};
+
+%include <std_string.i>
+%include <std_pair.i>
+%include <std_map.i>
+%include <std_shared_ptr.i>
+
+// primitive array types
+%template(Float32Vector) std::vector<float>;
+%template(Float64Vector) std::vector<double>;
+%template(Int8Vector) std::vector<int8_t>;
+%template(Int16Vector) std::vector<int16_t>;
+%template(Int32Vector) std::vector<int32_t>;
+%template(Int64Vector) std::vector<int64_t>;
+%template(UInt8Vector) std::vector<uint8_t>;
+%template(UInt16Vector) std::vector<uint16_t>;
+%template(UInt32Vector) std::vector<uint32_t>;
+%template(UInt64Vector) std::vector<uint64_t>;
+
+%template(Float32VectorVector) std::vector<std::vector<float> >;
+%template(UInt8VectorVector) std::vector<std::vector<uint8_t> >;
+%template(Int32VectorVector) std::vector<std::vector<int32_t> >;
+%template(Int64VectorVector) std::vector<std::vector<int64_t> >;
+%template(VectorTransformVector) std::vector<faiss::VectorTransform*>;
+%template(OperatingPointVector) std::vector<faiss::OperatingPoint>;
+%template(InvertedListsPtrVector) std::vector<faiss::InvertedLists*>;
+%template(RepeatVector) std::vector<faiss::Repeat>;
+%template(ClusteringIterationStatsVector) std::vector<faiss::ClusteringIterationStats>;
+%template(ParameterRangeVector) std::vector<faiss::ParameterRange>;
+
+
+#ifndef SWIGWIN
+%template(OnDiskOneListVector) std::vector<faiss::OnDiskOneList>;
+#endif // !SWIGWIN
+
+#ifdef GPU_WRAPPER
+%template(GpuResourcesVector) std::vector<faiss::gpu::GpuResourcesProvider*>;
+#endif
+
+// produces an error on the Mac
+%ignore faiss::hamming;
+
+/*******************************************************************
+ * Parse headers
+ *******************************************************************/
+
+%include <faiss/impl/platform_macros.h>
+
+%ignore *::cmp;
+
+%include <faiss/utils/ordered_key_value.h>
+%include <faiss/utils/Heap.h>
+
+// this ignore seems to be ignored, so disable W362 above
+%ignore faiss::AlignedTable::operator=;
+
+%include <faiss/utils/AlignedTable.h>
+%include <faiss/utils/partitioning.h>
+%include <faiss/utils/hamming.h>
+%include <faiss/utils/hamming_distance/common.h>
+
+int get_num_gpus();
+void gpu_profiler_start();
+void gpu_profiler_stop();
+void gpu_sync_all_devices();
+
+#ifdef GPU_WRAPPER
+
+%shared_ptr(faiss::gpu::GpuResources);
+%shared_ptr(faiss::gpu::StandardGpuResourcesImpl);
+
+%{
+
+#include <faiss/gpu/StandardGpuResources.h>
+#include <faiss/gpu/GpuIndicesOptions.h>
+#include <faiss/gpu/GpuClonerOptions.h>
+#include <faiss/gpu/GpuIndex.h>
+#include <faiss/gpu/GpuIndexFlat.h>
+#include <faiss/gpu/GpuIndexIVF.h>
+#include <faiss/gpu/GpuIndexIVFPQ.h>
+#include <faiss/gpu/GpuIndexIVFFlat.h>
+#include <faiss/gpu/GpuIndexIVFScalarQuantizer.h>
+#include <faiss/gpu/GpuIndexBinaryFlat.h>
+#include <faiss/gpu/GpuAutoTune.h>
+#include <faiss/gpu/GpuCloner.h>
+#include <faiss/gpu/GpuDistance.h>
+#include <faiss/gpu/GpuIcmEncoder.h>
+
+int get_num_gpus()
+{
+    return faiss::gpu::getNumDevices();
+}
+
+void gpu_profiler_start()
+{
+    return faiss::gpu::profilerStart();
+}
+
+void gpu_profiler_stop()
+{
+    return faiss::gpu::profilerStop();
+}
+
+void gpu_sync_all_devices()
+{
+    return faiss::gpu::synchronizeAllDevices();
+}
+
+%}
+
+%template() std::pair<int, uint64_t>;
+%template() std::map<std::string, std::pair<int, uint64_t> >;
+%template() std::map<int, std::map<std::string, std::pair<int, uint64_t> > >;
+
+// causes weird wrapper bug
+%ignore *::allocMemoryHandle;
+%ignore faiss::gpu::GpuMemoryReservation;
+%ignore faiss::gpu::GpuMemoryReservation::operator=(GpuMemoryReservation&&);
+%ignore faiss::gpu::AllocType;
+
+%include  <faiss/gpu/GpuResources.h>
+%include  <faiss/gpu/StandardGpuResources.h>
+
+typedef CUstream_st* cudaStream_t;
+
+%inline %{
+
+// interop between pytorch exposed cudaStream_t and faiss
+cudaStream_t cast_integer_to_cudastream_t(int64_t x) {
+  return (cudaStream_t) x;
+}
+
+int64_t cast_cudastream_t_to_integer(cudaStream_t x) {
+  return (int64_t) x;
+}
+
+%}
+
+#else
+
+%{
+int get_num_gpus()
+{
+    return 0;
+}
+
+void gpu_profiler_start()
+{
+}
+
+void gpu_profiler_stop()
+{
+}
+
+void gpu_sync_all_devices()
+{
+}
+%}
+
+
+#endif
+
+// order matters because includes are not recursive
+
+%include  <faiss/utils/utils.h>
+%template(CombinerRangeKNNfloat) faiss::CombinerRangeKNN<float>;
+%template(CombinerRangeKNNint16) faiss::CombinerRangeKNN<int16_t>;
+
+%include  <faiss/utils/distances.h>
+%include  <faiss/utils/random.h>
+%include  <faiss/utils/sorting.h>
+
+%include  <faiss/MetricType.h>
+
+%newobject *::get_distance_computer() const;
+%newobject *::get_CodePacker() const;
+
+%include  <faiss/Index.h>
+
+%include <faiss/impl/DistanceComputer.h>
+
+%newobject *::get_FlatCodesDistanceComputer() const;
+%include  <faiss/IndexFlatCodes.h>
+%include  <faiss/IndexFlat.h>
+%include  <faiss/Clustering.h>
+
+%include  <faiss/utils/extra_distances.h>
+
+%ignore faiss::ProductQuantizer::get_centroids(size_t,size_t) const;
+
+%include  <faiss/impl/Quantizer.h>
+%include  <faiss/impl/ProductQuantizer.h>
+%include  <faiss/impl/AdditiveQuantizer.h>
+%include  <faiss/impl/residual_quantizer_encode_steps.h>
+%include  <faiss/impl/ResidualQuantizer.h>
+%include  <faiss/impl/LocalSearchQuantizer.h>
+%include  <faiss/impl/ProductAdditiveQuantizer.h>
+%include  <faiss/impl/CodePacker.h>
+
+%include  <faiss/VectorTransform.h>
+%include  <faiss/IndexPreTransform.h>
+%include  <faiss/IndexRefine.h>
+%include  <faiss/IndexLSH.h>
+%include  <faiss/impl/PolysemousTraining.h>
+%include  <faiss/IndexPQ.h>
+%include  <faiss/IndexAdditiveQuantizer.h>
+%include  <faiss/impl/io.h>
+
+%include  <faiss/invlists/InvertedLists.h>
+%include  <faiss/invlists/InvertedListsIOHook.h>
+%ignore BlockInvertedListsIOHook;
+%include  <faiss/invlists/BlockInvertedLists.h>
+%include  <faiss/invlists/DirectMap.h>
+%include  <faiss/IndexIVF.h>
+// NOTE(hoss): SWIG (wrongly) believes the overloaded const version shadows the
+//   non-const one.
+%warnfilter(509) extract_index_ivf;
+%warnfilter(509) try_extract_index_ivf;
+%include  <faiss/IVFlib.h>
+%include  <faiss/impl/ScalarQuantizer.h>
+%include  <faiss/IndexScalarQuantizer.h>
+%include  <faiss/IndexIVFSpectralHash.h>
+%include  <faiss/IndexIVFAdditiveQuantizer.h>
+%include  <faiss/impl/HNSW.h>
+%include  <faiss/IndexHNSW.h>
+
+%include <faiss/impl/kmeans1d.h>
+
+%ignore faiss::nndescent::Nhood::lock;
+%include  <faiss/impl/NNDescent.h>
+%include  <faiss/IndexNNDescent.h>
+
+%include  <faiss/IndexIVFFlat.h>
+
+%warnfilter(509) faiss::nsg::Graph< int >::at(int,int);
+
+%include  <faiss/impl/NSG.h>
+
+%template(NSG_Graph_int) faiss::nsg::Graph<int>;
+
+// not using %shared_ptr to avoid mem leaks
+%extend faiss::NSG {
+    faiss::nsg::Graph<int>* get_final_graph() {
+        return $self->final_graph.get();
+    }
+}
+
+%include  <faiss/IndexNSG.h>
+
+#ifndef SWIGWIN
+%warnfilter(401) faiss::OnDiskInvertedListsIOHook;
+%ignore OnDiskInvertedListsIOHook;
+%include  <faiss/invlists/OnDiskInvertedLists.h>
+#endif // !SWIGWIN
+
+%include  <faiss/impl/lattice_Zn.h>
+%include  <faiss/IndexLattice.h>
+
+%ignore faiss::IndexIVFPQ::alloc_type;
+%include  <faiss/IndexIVFPQ.h>
+%include  <faiss/IndexIVFPQR.h>
+%include  <faiss/Index2Layer.h>
+
+%include  <faiss/IndexFastScan.h>
+%include  <faiss/IndexAdditiveQuantizerFastScan.h>
+%include  <faiss/IndexPQFastScan.h>
+
+// NOTE(matthijs) let's not go into wrapping simdlib
+struct faiss::simd16uint16 {};
+
+%include  <faiss/impl/simd_result_handlers.h>
+%include  <faiss/IndexIVFFastScan.h>
+%include  <faiss/IndexIVFAdditiveQuantizerFastScan.h>
+%include  <faiss/IndexIVFIndependentQuantizer.h>
+
+%include  <faiss/IndexIVFPQFastScan.h>
+%include  <faiss/utils/quantize_lut.h>
+
+%include  <faiss/IndexBinary.h>
+%include  <faiss/IndexBinaryFlat.h>
+%include  <faiss/IndexBinaryIVF.h>
+%include  <faiss/IndexBinaryFromFloat.h>
+%include  <faiss/IndexBinaryHNSW.h>
+%include  <faiss/IndexBinaryHash.h>
+
+%include  <faiss/impl/ThreadedIndex.h>
+%template(ThreadedIndexBase) faiss::ThreadedIndex<faiss::Index>;
+%template(ThreadedIndexBaseBinary) faiss::ThreadedIndex<faiss::IndexBinary>;
+
+%include  <faiss/IndexShards.h>
+%template(IndexShards) faiss::IndexShardsTemplate<faiss::Index>;
+%template(IndexBinaryShards) faiss::IndexShardsTemplate<faiss::IndexBinary>;
+%include  <faiss/IndexShardsIVF.h>
+
+%include  <faiss/IndexReplicas.h>
+%template(IndexReplicas) faiss::IndexReplicasTemplate<faiss::Index>;
+%template(IndexBinaryReplicas) faiss::IndexReplicasTemplate<faiss::IndexBinary>;
+
+%include  <faiss/MetaIndexes.h>
+
+%include  <faiss/IndexRowwiseMinMax.h>
+
+
+%ignore faiss::BufferList::Buffer;
+%ignore faiss::RangeSearchPartialResult::QueryResult;
+%ignore faiss::IDSelectorBatch::set;
+%ignore faiss::IDSelectorBatch::bloom;
+%ignore faiss::InterruptCallback::instance;
+%ignore faiss::InterruptCallback::lock;
+
+%include <faiss/impl/AuxIndexStructures.h>
+%include <faiss/impl/IDSelector.h>
+
+%include  <faiss/IndexIDMap.h>
+%template(IndexIDMap) faiss::IndexIDMapTemplate<faiss::Index>;
+%template(IndexBinaryIDMap) faiss::IndexIDMapTemplate<faiss::IndexBinary>;
+%template(IndexIDMap2) faiss::IndexIDMap2Template<faiss::Index>;
+%template(IndexBinaryIDMap2) faiss::IndexIDMap2Template<faiss::IndexBinary>;
+
+
+%include <faiss/utils/approx_topk/mode.h>
+
+#ifdef GPU_WRAPPER
+
+// quiet SWIG warnings
+%ignore faiss::gpu::GpuIndexIVF::GpuIndexIVF;
+
+%include  <faiss/gpu/GpuIndicesOptions.h>
+%include  <faiss/gpu/GpuClonerOptions.h>
+%include  <faiss/gpu/GpuIndex.h>
+%include  <faiss/gpu/GpuIndexFlat.h>
+%include  <faiss/gpu/GpuIndexIVF.h>
+%include  <faiss/gpu/GpuIndexIVFPQ.h>
+%include  <faiss/gpu/GpuIndexIVFFlat.h>
+%include  <faiss/gpu/GpuIndexIVFScalarQuantizer.h>
+%include  <faiss/gpu/GpuIndexBinaryFlat.h>
+%include  <faiss/gpu/GpuDistance.h>
+%include  <faiss/gpu/GpuIcmEncoder.h>
+
+
+#endif
+
+
+
+
+
+
+
+
+/*******************************************************************
+ * downcast return of some functions so that the sub-class is used
+ * instead of the generic upper-class.
+ *******************************************************************/
+
+
+#ifdef SWIGPYTHON
+
+%define DOWNCAST(subclass)
+    if (dynamic_cast<faiss::subclass *> ($1)) {
+      $result = SWIG_NewPointerObj($1,SWIGTYPE_p_faiss__ ## subclass,$owner);
+    } else
+%enddef
+
+%define DOWNCAST2(subclass, longname)
+    if (dynamic_cast<faiss::subclass *> ($1)) {
+      $result = SWIG_NewPointerObj($1,SWIGTYPE_p_faiss__ ## longname,$owner);
+    } else
+%enddef
+
+%define DOWNCAST_GPU(subclass)
+    if (dynamic_cast<faiss::gpu::subclass *> ($1)) {
+      $result = SWIG_NewPointerObj($1,SWIGTYPE_p_faiss__gpu__ ## subclass,$owner);
+    } else
+%enddef
+
+#endif
+
+%newobject read_index;
+%newobject read_index_binary;
+%newobject read_VectorTransform;
+%newobject read_ProductQuantizer;
+%newobject clone_index;
+%newobject clone_binary_index;
+%newobject clone_Quantizer;
+%newobject clone_VectorTransform;
+
+// Subclasses should appear before their parent
+%typemap(out) faiss::Index * {
+    DOWNCAST2 ( IndexIDMap2, IndexIDMap2TemplateT_faiss__Index_t )
+    DOWNCAST2 ( IndexIDMap, IndexIDMapTemplateT_faiss__Index_t )
+    DOWNCAST ( IndexShardsIVF )
+    DOWNCAST2 ( IndexShards, IndexShardsTemplateT_faiss__Index_t )
+    DOWNCAST2 ( IndexReplicas, IndexReplicasTemplateT_faiss__Index_t )
+    DOWNCAST ( IndexIVFIndependentQuantizer)
+    DOWNCAST ( IndexIVFPQR )
+    DOWNCAST ( IndexIVFPQ )
+    DOWNCAST ( IndexIVFPQFastScan )
+    DOWNCAST ( IndexIVFSpectralHash )
+    DOWNCAST ( IndexIVFScalarQuantizer )
+    DOWNCAST ( IndexIVFResidualQuantizer )
+    DOWNCAST ( IndexIVFLocalSearchQuantizer )
+    DOWNCAST ( IndexIVFProductResidualQuantizer )
+    DOWNCAST ( IndexIVFProductLocalSearchQuantizer )
+    DOWNCAST ( IndexIVFResidualQuantizerFastScan )
+    DOWNCAST ( IndexIVFLocalSearchQuantizerFastScan )
+    DOWNCAST ( IndexIVFProductResidualQuantizerFastScan )
+    DOWNCAST ( IndexIVFProductLocalSearchQuantizerFastScan )
+    DOWNCAST ( IndexIVFFlatDedup )
+    DOWNCAST ( IndexIVFFlat )
+    DOWNCAST ( IndexIVF )
+    DOWNCAST ( IndexFlatIP )
+    DOWNCAST ( IndexFlatL2 )
+    DOWNCAST ( IndexFlat )
+    DOWNCAST ( IndexRefineFlat )
+    DOWNCAST ( IndexRefine )
+    DOWNCAST ( IndexPQFastScan )
+    DOWNCAST ( IndexPQ )
+    DOWNCAST ( IndexResidualQuantizer )
+    DOWNCAST ( IndexLocalSearchQuantizer )
+    DOWNCAST ( IndexResidualQuantizerFastScan )
+    DOWNCAST ( IndexLocalSearchQuantizerFastScan )
+    DOWNCAST ( IndexProductResidualQuantizerFastScan )
+    DOWNCAST ( IndexProductLocalSearchQuantizerFastScan )
+    DOWNCAST ( ResidualCoarseQuantizer )
+    DOWNCAST ( LocalSearchCoarseQuantizer )
+    DOWNCAST ( IndexProductResidualQuantizer )
+    DOWNCAST ( IndexProductLocalSearchQuantizer )
+    DOWNCAST ( IndexScalarQuantizer )
+    DOWNCAST ( IndexLSH )
+    DOWNCAST ( IndexLattice )
+    DOWNCAST ( IndexPreTransform )
+    DOWNCAST ( MultiIndexQuantizer )
+    DOWNCAST ( IndexHNSWFlat )
+    DOWNCAST ( IndexHNSWPQ )
+    DOWNCAST ( IndexHNSWSQ )
+    DOWNCAST ( IndexHNSW )
+    DOWNCAST ( IndexHNSW2Level )
+    DOWNCAST ( IndexNNDescentFlat )
+    DOWNCAST ( IndexNSGFlat )
+    DOWNCAST ( IndexNSGPQ )
+    DOWNCAST ( IndexNSGSQ )
+    DOWNCAST ( Index2Layer )
+    DOWNCAST ( IndexRandom )
+    DOWNCAST ( IndexRowwiseMinMax )
+    DOWNCAST ( IndexRowwiseMinMaxFP16 )
+#ifdef GPU_WRAPPER
+    DOWNCAST_GPU ( GpuIndexIVFPQ )
+    DOWNCAST_GPU ( GpuIndexIVFFlat )
+    DOWNCAST_GPU ( GpuIndexIVFScalarQuantizer )
+    DOWNCAST_GPU ( GpuIndexFlat )
+#endif
+    // default for non-recognized classes
+    DOWNCAST ( Index )
+    if ($1 == NULL)
+    {
+#ifdef SWIGPYTHON
+        $result = SWIG_Py_Void();
+#endif
+    } else {
+        assert(false);
+    }
+}
+
+
+%typemap(out) faiss::IndexBinary * {
+    DOWNCAST2 ( IndexBinaryReplicas, IndexReplicasTemplateT_faiss__IndexBinary_t )
+    DOWNCAST2 ( IndexBinaryIDMap2, IndexIDMap2TemplateT_faiss__IndexBinary_t )
+    DOWNCAST2 ( IndexBinaryIDMap, IndexIDMapTemplateT_faiss__IndexBinary_t )
+    DOWNCAST ( IndexBinaryIVF )
+    DOWNCAST ( IndexBinaryFlat )
+    DOWNCAST ( IndexBinaryFromFloat )
+    DOWNCAST ( IndexBinaryHNSW )
+    DOWNCAST ( IndexBinaryHash )
+    DOWNCAST ( IndexBinaryMultiHash )
+#ifdef GPU_WRAPPER
+    DOWNCAST_GPU ( GpuIndexBinaryFlat )
+#endif
+    // default for non-recognized classes
+    DOWNCAST ( IndexBinary )
+    if ($1 == NULL)
+    {
+#ifdef SWIGPYTHON
+        $result = SWIG_Py_Void();
+#endif
+    } else {
+        assert(false);
+    }
+}
+
+%typemap(out) faiss::VectorTransform * {
+    DOWNCAST (RemapDimensionsTransform)
+    DOWNCAST (OPQMatrix)
+    DOWNCAST (PCAMatrix)
+    DOWNCAST (ITQMatrix)
+    DOWNCAST (RandomRotationMatrix)
+    DOWNCAST (LinearTransform)
+    DOWNCAST (NormalizationTransform)
+    DOWNCAST (CenteringTransform)
+    DOWNCAST (ITQTransform)
+    DOWNCAST (VectorTransform)
+    {
+        assert(false);
+    }
+}
+
+%typemap(out) faiss::InvertedLists * {
+    DOWNCAST (ArrayInvertedLists)
+    DOWNCAST (BlockInvertedLists)
+#ifndef SWIGWIN
+    DOWNCAST (OnDiskInvertedLists)
+#endif // !SWIGWIN
+    DOWNCAST (VStackInvertedLists)
+    DOWNCAST (HStackInvertedLists)
+    DOWNCAST (MaskedInvertedLists)
+    DOWNCAST (InvertedLists)
+    {
+        assert(false);
+    }
+}
+
+%typemap(out) faiss::Quantizer * {
+    DOWNCAST (ScalarQuantizer)
+    DOWNCAST (ProductQuantizer)
+    DOWNCAST (LocalSearchQuantizer)
+    DOWNCAST (ResidualQuantizer)
+    DOWNCAST (ProductLocalSearchQuantizer)
+    DOWNCAST (ProductResidualQuantizer)
+    {
+        assert(false);
+    }
+}
+
+// just to downcast pointers that come from elsewhere (eg. direct
+// access to object fields)
+%inline %{
+faiss::Index * downcast_index (faiss::Index *index)
+{
+    return index;
+}
+faiss::VectorTransform * downcast_VectorTransform (faiss::VectorTransform *vt)
+{
+    return vt;
+}
+faiss::IndexBinary * downcast_IndexBinary (faiss::IndexBinary *index)
+{
+    return index;
+}
+faiss::InvertedLists * downcast_InvertedLists (faiss::InvertedLists *il)
+{
+    return il;
+}
+// backwards compatibility
+faiss::Quantizer * downcast_AdditiveQuantizer (faiss::AdditiveQuantizer *aq)
+{
+    return aq;
+}
+faiss::Quantizer * downcast_Quantizer (faiss::Quantizer *aq)
+{
+    return aq;
+}
+%}
+
+%include  <faiss/index_io.h>
+%include  <faiss/clone_index.h>
+%newobject index_factory;
+%newobject index_binary_factory;
+
+%include  <faiss/AutoTune.h>
+%include  <faiss/index_factory.h>
+%include  <faiss/MatrixStats.h>
+
+
+#ifdef GPU_WRAPPER
+
+%include  <faiss/gpu/GpuAutoTune.h>
+
+%newobject index_gpu_to_cpu;
+%newobject index_cpu_to_gpu;
+%newobject index_cpu_to_gpu_multiple;
+
+%include  <faiss/gpu/GpuCloner.h>
+
+#endif
+
+
+
+/*******************************************************************
+ * Support I/O to arbitrary functions
+ *******************************************************************/
+
+
+#ifdef SWIGPYTHON
+%include <faiss/python/python_callbacks.h>
+
+
+%{
+#include <faiss/python/python_callbacks.h>
+%}
+
+#endif
+
+
+/*******************************************************************
+ * How should the template objects appear in the scripting language?
+ *******************************************************************/
+
+// answer: the same as the C++ typedefs, but we still have to redefine them
+
+%template() faiss::CMin<float, int64_t>;
+%template() faiss::CMin<int, int64_t>;
+%template() faiss::CMax<float, int64_t>;
+%template() faiss::CMax<int, int64_t>;
+
+%template(float_minheap_array_t) faiss::HeapArray<faiss::CMin<float, int64_t> >;
+%template(int_minheap_array_t) faiss::HeapArray<faiss::CMin<int, int64_t> >;
+%template(float_maxheap_array_t) faiss::HeapArray<faiss::CMax<float, int64_t> >;
+%template(int_maxheap_array_t) faiss::HeapArray<faiss::CMax<int, int64_t> >;
+
+%template(CMin_float_partition_fuzzy)
+    faiss::partition_fuzzy<faiss::CMin<float, int64_t> >;
+%template(CMax_float_partition_fuzzy)
+    faiss::partition_fuzzy<faiss::CMax<float, int64_t> >;
+
+%template(AlignedTableUint8) faiss::AlignedTable<uint8_t>;
+%template(AlignedTableUint16) faiss::AlignedTable<uint16_t>;
+%template(AlignedTableFloat32) faiss::AlignedTable<float>;
+
+
+// SWIG seems to have some trouble resolving function template types here, so
+// declare explicitly
+
+%define INSTANTIATE_uint16_partition_fuzzy(C, id_t)
+
+%inline %{
+
+uint16_t C ## _uint16_partition_fuzzy(
+        uint16_t *vals, id_t *ids, size_t n,
+        size_t q_min, size_t q_max, size_t * q_out)
+{
+    return faiss::partition_fuzzy<faiss::C<unsigned short, id_t> >(
+        vals, ids, n, q_min, q_max, q_out);
+}
+
+%}
+
+%enddef
+
+INSTANTIATE_uint16_partition_fuzzy(CMin, int64_t)
+INSTANTIATE_uint16_partition_fuzzy(CMax, int64_t)
+INSTANTIATE_uint16_partition_fuzzy(CMin, int)
+INSTANTIATE_uint16_partition_fuzzy(CMax, int)
+
+// Same for merge_knn_results
+
+// same define as explicit instanciation in Heap.cpp
+%define INSTANTIATE_merge_knn_results(C, distance_t)
+
+%inline %{
+void merge_knn_results_ ## C(
+    size_t n, size_t k, int nshard,
+    const distance_t *all_distances, const faiss::idx_t *all_labels,
+    distance_t *distances, faiss::idx_t *labels)
+{
+    faiss::merge_knn_results<faiss::idx_t, faiss::C<distance_t, int>>(
+        n, k, nshard, all_distances, all_labels, distances, labels);
+}
+%}
+
+%enddef
+
+INSTANTIATE_merge_knn_results(CMin, float);
+INSTANTIATE_merge_knn_results(CMax, float);
+INSTANTIATE_merge_knn_results(CMin, int32_t);
+INSTANTIATE_merge_knn_results(CMax, int32_t);
+
+
+
+%inline %{
+
+/*******************************************************************
+ * numpy misses a hash table implementation, hence this class. It
+ * represents not found values as -1 like in the Index implementation
+ *******************************************************************/
+
+
+struct MapLong2Long {
+    std::unordered_map<int64_t, int64_t> map;
+
+    void add(size_t n, const int64_t *keys, const int64_t *vals) {
+        map.reserve(map.size() + n);
+        for (size_t i = 0; i < n; i++) {
+            map[keys[i]] = vals[i];
+        }
+    }
+
+    int64_t search(int64_t key) const {
+        auto ptr = map.find(key);
+        if (ptr == map.end()) {
+            return -1;
+        } else {
+            return ptr->second;
+        }
+    }
+
+    void search_multiple(size_t n, int64_t *keys, int64_t * vals) {
+        for (size_t i = 0; i < n; i++) {
+            vals[i] = search(keys[i]);
+        }
+    }
+};
+
+%}
+
+
+/*******************************************************************
+ * Expose a few basic functions
+ *******************************************************************/
+
+
+void omp_set_num_threads (int num_threads);
+int omp_get_max_threads ();
+void *memcpy(void *dest, const void *src, size_t n);
+
+
+
+
+/*******************************************************************
+ * Python-specific: do not release GIL any more, as functions below
+ * use the Python/C API
+ *******************************************************************/
+
+#ifdef SWIGPYTHON
+%exception;
+#endif
+
+
+
+/*******************************************************************
+ * Python specific: numpy array <-> C++ pointer interface
+ *******************************************************************/
+
+#ifdef SWIGPYTHON
+
+%{
+PyObject *swig_ptr (PyObject *a)
+{
+
+    if (PyBytes_Check(a)) {
+        return SWIG_NewPointerObj(PyBytes_AsString(a), SWIGTYPE_p_char, 0);
+    }
+    if (PyByteArray_Check(a)) {
+        return SWIG_NewPointerObj(PyByteArray_AsString(a), SWIGTYPE_p_char, 0);
+    }
+    if(!PyArray_Check(a)) {
+        PyErr_SetString(PyExc_ValueError, "input not a numpy array");
+        return NULL;
+    }
+    PyArrayObject *ao = (PyArrayObject *)a;
+
+    if(!PyArray_ISCONTIGUOUS(ao)) {
+        PyErr_SetString(PyExc_ValueError, "array is not C-contiguous");
+        return NULL;
+    }
+    void * data = PyArray_DATA(ao);
+    if(PyArray_TYPE(ao) == NPY_FLOAT32) {
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_float, 0);
+    }
+    if(PyArray_TYPE(ao) == NPY_FLOAT64) {
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_double, 0);
+    }
+    if(PyArray_TYPE(ao) == NPY_FLOAT16) {
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_unsigned_short, 0);
+    }
+    if(PyArray_TYPE(ao) == NPY_UINT8) {
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_unsigned_char, 0);
+    }
+    if(PyArray_TYPE(ao) == NPY_INT8) {
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_char, 0);
+    }
+    if(PyArray_TYPE(ao) == NPY_UINT16) {
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_unsigned_short, 0);
+    }
+    if(PyArray_TYPE(ao) == NPY_INT16) {
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_short, 0);
+    }
+    if(PyArray_TYPE(ao) == NPY_UINT32) {
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_unsigned_int, 0);
+    }
+    if(PyArray_TYPE(ao) == NPY_INT32) {
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_int, 0);
+    }
+    if(PyArray_TYPE(ao) == NPY_BOOL) {
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_bool, 0);
+    }
+    if(PyArray_TYPE(ao) == NPY_UINT64) {
+#ifdef SWIGWORDSIZE64
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_unsigned_long, 0);
+#else
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_unsigned_long_long, 0);
+#endif
+    }
+    if(PyArray_TYPE(ao) == NPY_INT64) {
+#ifdef SWIGWORDSIZE64
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_long, 0);
+#else
+        return SWIG_NewPointerObj(data, SWIGTYPE_p_long_long, 0);
+#endif
+    }
+    PyErr_SetString(PyExc_ValueError, "did not recognize array type");
+    return NULL;
+}
+
+
+struct PythonInterruptCallback: faiss::InterruptCallback {
+
+    bool want_interrupt () override {
+        int err;
+        {
+            PyGILState_STATE gstate;
+            gstate = PyGILState_Ensure();
+            err = PyErr_CheckSignals();
+            PyGILState_Release(gstate);
+        }
+        return err == -1;
+    }
+
+};
+
+
+%}
+
+
+%init %{
+    /* needed, else crash at runtime */
+    import_array();
+
+    faiss::InterruptCallback::instance.reset(new PythonInterruptCallback());
+
+%}
+
+// return a pointer usable as input for functions that expect pointers
+PyObject *swig_ptr (PyObject *a);
+
+%define REV_SWIG_PTR(ctype, numpytype)
+
+%{
+PyObject * rev_swig_ptr(ctype *src, npy_intp size) {
+    return PyArray_SimpleNewFromData(1, &size, numpytype, src);
+}
+%}
+
+PyObject * rev_swig_ptr(ctype *src, size_t size);
+
+%enddef
+
+REV_SWIG_PTR(float, NPY_FLOAT32);
+REV_SWIG_PTR(double, NPY_FLOAT64);
+REV_SWIG_PTR(unsigned char, NPY_UINT8);
+REV_SWIG_PTR(char, NPY_INT8);
+REV_SWIG_PTR(unsigned short, NPY_UINT16);
+REV_SWIG_PTR(short, NPY_INT16);
+REV_SWIG_PTR(int, NPY_INT32);
+REV_SWIG_PTR(unsigned int, NPY_UINT32);
+REV_SWIG_PTR(int64_t, NPY_INT64);
+REV_SWIG_PTR(uint64_t, NPY_UINT64);
+
+#endif
+
+
+
+/*******************************************************************
+ * For Faiss/Pytorch interop via pointers encoded as longs
+ *******************************************************************/
+
+%inline %{
+uint8_t * cast_integer_to_uint8_ptr (int64_t x) {
+    return (uint8_t*)x;
+}
+
+float * cast_integer_to_float_ptr (int64_t x) {
+    return (float*)x;
+}
+
+faiss::idx_t* cast_integer_to_idx_t_ptr (int64_t x) {
+    return (faiss::idx_t*)x;
+}
+
+int * cast_integer_to_int_ptr (int64_t x) {
+    return (int*)x;
+}
+
+void * cast_integer_to_void_ptr (int64_t x) {
+    return (void*)x;
+}
+
+%}
+
+
+
+
+
+
+
+%inline %{
+    void wait() {
+        // in gdb, use return to get out of this function
+        for(int i = 0; i == 0; i += 0);
+    }
+ %}
+
+// End of file...
diff --git a/llm/Lib/site-packages/faiss/swigfaiss.py b/llm/Lib/site-packages/faiss/swigfaiss.py
new file mode 100644
index 0000000000000000000000000000000000000000..d43c53dad9967c336262db7537250c6137d21411
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/swigfaiss.py
@@ -0,0 +1,11343 @@
+# This file was automatically generated by SWIG (https://www.swig.org).
+# Version 4.1.1
+#
+# Do not make changes to this file unless you know what you are doing - modify
+# the SWIG interface file instead.
+
+from sys import version_info as _swig_python_version_info
+# Import the low-level C/C++ module
+if __package__ or "." in __name__:
+    from . import _swigfaiss
+else:
+    import _swigfaiss
+
+try:
+    import builtins as __builtin__
+except ImportError:
+    import __builtin__
+
+def _swig_repr(self):
+    try:
+        strthis = "proxy of " + self.this.__repr__()
+    except __builtin__.Exception:
+        strthis = ""
+    return "<%s.%s; %s >" % (self.__class__.__module__, self.__class__.__name__, strthis,)
+
+
+def _swig_setattr_nondynamic_instance_variable(set):
+    def set_instance_attr(self, name, value):
+        if name == "this":
+            set(self, name, value)
+        elif name == "thisown":
+            self.this.own(value)
+        elif hasattr(self, name) and isinstance(getattr(type(self), name), property):
+            set(self, name, value)
+        else:
+            raise AttributeError("You cannot add instance attributes to %s" % self)
+    return set_instance_attr
+
+
+def _swig_setattr_nondynamic_class_variable(set):
+    def set_class_attr(cls, name, value):
+        if hasattr(cls, name) and not isinstance(getattr(cls, name), property):
+            set(cls, name, value)
+        else:
+            raise AttributeError("You cannot add class attributes to %s" % cls)
+    return set_class_attr
+
+
+def _swig_add_metaclass(metaclass):
+    """Class decorator for adding a metaclass to a SWIG wrapped class - a slimmed down version of six.add_metaclass"""
+    def wrapper(cls):
+        return metaclass(cls.__name__, cls.__bases__, cls.__dict__.copy())
+    return wrapper
+
+
+class _SwigNonDynamicMeta(type):
+    """Meta class to enforce nondynamic attributes (no new attributes) for a class"""
+    __setattr__ = _swig_setattr_nondynamic_class_variable(type.__setattr__)
+
+
+class SwigPyIterator(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    __swig_destroy__ = _swigfaiss.delete_SwigPyIterator
+
+    def value(self):
+        return _swigfaiss.SwigPyIterator_value(self)
+
+    def incr(self, n=1):
+        return _swigfaiss.SwigPyIterator_incr(self, n)
+
+    def decr(self, n=1):
+        return _swigfaiss.SwigPyIterator_decr(self, n)
+
+    def distance(self, x):
+        return _swigfaiss.SwigPyIterator_distance(self, x)
+
+    def equal(self, x):
+        return _swigfaiss.SwigPyIterator_equal(self, x)
+
+    def copy(self):
+        return _swigfaiss.SwigPyIterator_copy(self)
+
+    def next(self):
+        return _swigfaiss.SwigPyIterator_next(self)
+
+    def __next__(self):
+        return _swigfaiss.SwigPyIterator___next__(self)
+
+    def previous(self):
+        return _swigfaiss.SwigPyIterator_previous(self)
+
+    def advance(self, n):
+        return _swigfaiss.SwigPyIterator_advance(self, n)
+
+    def __eq__(self, x):
+        return _swigfaiss.SwigPyIterator___eq__(self, x)
+
+    def __ne__(self, x):
+        return _swigfaiss.SwigPyIterator___ne__(self, x)
+
+    def __iadd__(self, n):
+        return _swigfaiss.SwigPyIterator___iadd__(self, n)
+
+    def __isub__(self, n):
+        return _swigfaiss.SwigPyIterator___isub__(self, n)
+
+    def __add__(self, n):
+        return _swigfaiss.SwigPyIterator___add__(self, n)
+
+    def __sub__(self, *args):
+        return _swigfaiss.SwigPyIterator___sub__(self, *args)
+    def __iter__(self):
+        return self
+
+# Register SwigPyIterator in _swigfaiss:
+_swigfaiss.SwigPyIterator_swigregister(SwigPyIterator)
+SHARED_PTR_DISOWN = _swigfaiss.SHARED_PTR_DISOWN
+class Float32Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.Float32Vector_swiginit(self, _swigfaiss.new_Float32Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.Float32Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.Float32Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss.Float32Vector_data(self)
+
+    def size(self):
+        return _swigfaiss.Float32Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.Float32Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.Float32Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.Float32Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_Float32Vector
+
+# Register Float32Vector in _swigfaiss:
+_swigfaiss.Float32Vector_swigregister(Float32Vector)
+class Float64Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.Float64Vector_swiginit(self, _swigfaiss.new_Float64Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.Float64Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.Float64Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss.Float64Vector_data(self)
+
+    def size(self):
+        return _swigfaiss.Float64Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.Float64Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.Float64Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.Float64Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_Float64Vector
+
+# Register Float64Vector in _swigfaiss:
+_swigfaiss.Float64Vector_swigregister(Float64Vector)
+class Int8Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.Int8Vector_swiginit(self, _swigfaiss.new_Int8Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.Int8Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.Int8Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss.Int8Vector_data(self)
+
+    def size(self):
+        return _swigfaiss.Int8Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.Int8Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.Int8Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.Int8Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_Int8Vector
+
+# Register Int8Vector in _swigfaiss:
+_swigfaiss.Int8Vector_swigregister(Int8Vector)
+class Int16Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.Int16Vector_swiginit(self, _swigfaiss.new_Int16Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.Int16Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.Int16Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss.Int16Vector_data(self)
+
+    def size(self):
+        return _swigfaiss.Int16Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.Int16Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.Int16Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.Int16Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_Int16Vector
+
+# Register Int16Vector in _swigfaiss:
+_swigfaiss.Int16Vector_swigregister(Int16Vector)
+class Int32Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.Int32Vector_swiginit(self, _swigfaiss.new_Int32Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.Int32Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.Int32Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss.Int32Vector_data(self)
+
+    def size(self):
+        return _swigfaiss.Int32Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.Int32Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.Int32Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.Int32Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_Int32Vector
+
+# Register Int32Vector in _swigfaiss:
+_swigfaiss.Int32Vector_swigregister(Int32Vector)
+class Int64Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.Int64Vector_swiginit(self, _swigfaiss.new_Int64Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.Int64Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.Int64Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss.Int64Vector_data(self)
+
+    def size(self):
+        return _swigfaiss.Int64Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.Int64Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.Int64Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.Int64Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_Int64Vector
+
+# Register Int64Vector in _swigfaiss:
+_swigfaiss.Int64Vector_swigregister(Int64Vector)
+class UInt8Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.UInt8Vector_swiginit(self, _swigfaiss.new_UInt8Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.UInt8Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.UInt8Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss.UInt8Vector_data(self)
+
+    def size(self):
+        return _swigfaiss.UInt8Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.UInt8Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.UInt8Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.UInt8Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_UInt8Vector
+
+# Register UInt8Vector in _swigfaiss:
+_swigfaiss.UInt8Vector_swigregister(UInt8Vector)
+class UInt16Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.UInt16Vector_swiginit(self, _swigfaiss.new_UInt16Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.UInt16Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.UInt16Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss.UInt16Vector_data(self)
+
+    def size(self):
+        return _swigfaiss.UInt16Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.UInt16Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.UInt16Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.UInt16Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_UInt16Vector
+
+# Register UInt16Vector in _swigfaiss:
+_swigfaiss.UInt16Vector_swigregister(UInt16Vector)
+class UInt32Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.UInt32Vector_swiginit(self, _swigfaiss.new_UInt32Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.UInt32Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.UInt32Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss.UInt32Vector_data(self)
+
+    def size(self):
+        return _swigfaiss.UInt32Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.UInt32Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.UInt32Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.UInt32Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_UInt32Vector
+
+# Register UInt32Vector in _swigfaiss:
+_swigfaiss.UInt32Vector_swigregister(UInt32Vector)
+class UInt64Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.UInt64Vector_swiginit(self, _swigfaiss.new_UInt64Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.UInt64Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.UInt64Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss.UInt64Vector_data(self)
+
+    def size(self):
+        return _swigfaiss.UInt64Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.UInt64Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.UInt64Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.UInt64Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_UInt64Vector
+
+# Register UInt64Vector in _swigfaiss:
+_swigfaiss.UInt64Vector_swigregister(UInt64Vector)
+class Float32VectorVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.Float32VectorVector_swiginit(self, _swigfaiss.new_Float32VectorVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.Float32VectorVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.Float32VectorVector_clear(self)
+
+    def data(self):
+        return _swigfaiss.Float32VectorVector_data(self)
+
+    def size(self):
+        return _swigfaiss.Float32VectorVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.Float32VectorVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.Float32VectorVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.Float32VectorVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_Float32VectorVector
+
+# Register Float32VectorVector in _swigfaiss:
+_swigfaiss.Float32VectorVector_swigregister(Float32VectorVector)
+class UInt8VectorVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.UInt8VectorVector_swiginit(self, _swigfaiss.new_UInt8VectorVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.UInt8VectorVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.UInt8VectorVector_clear(self)
+
+    def data(self):
+        return _swigfaiss.UInt8VectorVector_data(self)
+
+    def size(self):
+        return _swigfaiss.UInt8VectorVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.UInt8VectorVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.UInt8VectorVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.UInt8VectorVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_UInt8VectorVector
+
+# Register UInt8VectorVector in _swigfaiss:
+_swigfaiss.UInt8VectorVector_swigregister(UInt8VectorVector)
+class Int32VectorVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.Int32VectorVector_swiginit(self, _swigfaiss.new_Int32VectorVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.Int32VectorVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.Int32VectorVector_clear(self)
+
+    def data(self):
+        return _swigfaiss.Int32VectorVector_data(self)
+
+    def size(self):
+        return _swigfaiss.Int32VectorVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.Int32VectorVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.Int32VectorVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.Int32VectorVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_Int32VectorVector
+
+# Register Int32VectorVector in _swigfaiss:
+_swigfaiss.Int32VectorVector_swigregister(Int32VectorVector)
+class Int64VectorVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.Int64VectorVector_swiginit(self, _swigfaiss.new_Int64VectorVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.Int64VectorVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.Int64VectorVector_clear(self)
+
+    def data(self):
+        return _swigfaiss.Int64VectorVector_data(self)
+
+    def size(self):
+        return _swigfaiss.Int64VectorVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.Int64VectorVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.Int64VectorVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.Int64VectorVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_Int64VectorVector
+
+# Register Int64VectorVector in _swigfaiss:
+_swigfaiss.Int64VectorVector_swigregister(Int64VectorVector)
+class VectorTransformVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.VectorTransformVector_swiginit(self, _swigfaiss.new_VectorTransformVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.VectorTransformVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.VectorTransformVector_clear(self)
+
+    def data(self):
+        return _swigfaiss.VectorTransformVector_data(self)
+
+    def size(self):
+        return _swigfaiss.VectorTransformVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.VectorTransformVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.VectorTransformVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.VectorTransformVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_VectorTransformVector
+
+# Register VectorTransformVector in _swigfaiss:
+_swigfaiss.VectorTransformVector_swigregister(VectorTransformVector)
+class OperatingPointVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.OperatingPointVector_swiginit(self, _swigfaiss.new_OperatingPointVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.OperatingPointVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.OperatingPointVector_clear(self)
+
+    def data(self):
+        return _swigfaiss.OperatingPointVector_data(self)
+
+    def size(self):
+        return _swigfaiss.OperatingPointVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.OperatingPointVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.OperatingPointVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.OperatingPointVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_OperatingPointVector
+
+# Register OperatingPointVector in _swigfaiss:
+_swigfaiss.OperatingPointVector_swigregister(OperatingPointVector)
+class InvertedListsPtrVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.InvertedListsPtrVector_swiginit(self, _swigfaiss.new_InvertedListsPtrVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.InvertedListsPtrVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.InvertedListsPtrVector_clear(self)
+
+    def data(self):
+        return _swigfaiss.InvertedListsPtrVector_data(self)
+
+    def size(self):
+        return _swigfaiss.InvertedListsPtrVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.InvertedListsPtrVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.InvertedListsPtrVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.InvertedListsPtrVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_InvertedListsPtrVector
+
+# Register InvertedListsPtrVector in _swigfaiss:
+_swigfaiss.InvertedListsPtrVector_swigregister(InvertedListsPtrVector)
+class RepeatVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.RepeatVector_swiginit(self, _swigfaiss.new_RepeatVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.RepeatVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.RepeatVector_clear(self)
+
+    def data(self):
+        return _swigfaiss.RepeatVector_data(self)
+
+    def size(self):
+        return _swigfaiss.RepeatVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.RepeatVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.RepeatVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.RepeatVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_RepeatVector
+
+# Register RepeatVector in _swigfaiss:
+_swigfaiss.RepeatVector_swigregister(RepeatVector)
+class ClusteringIterationStatsVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.ClusteringIterationStatsVector_swiginit(self, _swigfaiss.new_ClusteringIterationStatsVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.ClusteringIterationStatsVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.ClusteringIterationStatsVector_clear(self)
+
+    def data(self):
+        return _swigfaiss.ClusteringIterationStatsVector_data(self)
+
+    def size(self):
+        return _swigfaiss.ClusteringIterationStatsVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.ClusteringIterationStatsVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.ClusteringIterationStatsVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.ClusteringIterationStatsVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_ClusteringIterationStatsVector
+
+# Register ClusteringIterationStatsVector in _swigfaiss:
+_swigfaiss.ClusteringIterationStatsVector_swigregister(ClusteringIterationStatsVector)
+class ParameterRangeVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.ParameterRangeVector_swiginit(self, _swigfaiss.new_ParameterRangeVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss.ParameterRangeVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss.ParameterRangeVector_clear(self)
+
+    def data(self):
+        return _swigfaiss.ParameterRangeVector_data(self)
+
+    def size(self):
+        return _swigfaiss.ParameterRangeVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss.ParameterRangeVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss.ParameterRangeVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss.ParameterRangeVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss.delete_ParameterRangeVector
+
+# Register ParameterRangeVector in _swigfaiss:
+_swigfaiss.ParameterRangeVector_swigregister(ParameterRangeVector)
+
+def __builtin_ctzll(x):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+    return _swigfaiss.__builtin_ctzll(x)
+
+def __builtin_ctz(x):
+    return _swigfaiss.__builtin_ctz(x)
+
+def __builtin_clzll(x):
+    return _swigfaiss.__builtin_clzll(x)
+
+def simd_histogram_8(data, n, min, shift, hist):
+    r"""
+     low level SIMD histogramming functions  8-bin histogram of (x - min) >> shift
+    values outside the range are ignored.
+    the data table should be aligned on 32 bytes
+    """
+    return _swigfaiss.simd_histogram_8(data, n, min, shift, hist)
+
+def simd_histogram_16(data, n, min, shift, hist):
+    r""" same for 16-bin histogram"""
+    return _swigfaiss.simd_histogram_16(data, n, min, shift, hist)
+class PartitionStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    bissect_cycles = property(_swigfaiss.PartitionStats_bissect_cycles_get, _swigfaiss.PartitionStats_bissect_cycles_set)
+    compress_cycles = property(_swigfaiss.PartitionStats_compress_cycles_get, _swigfaiss.PartitionStats_compress_cycles_set)
+
+    def __init__(self):
+        _swigfaiss.PartitionStats_swiginit(self, _swigfaiss.new_PartitionStats())
+
+    def reset(self):
+        return _swigfaiss.PartitionStats_reset(self)
+    __swig_destroy__ = _swigfaiss.delete_PartitionStats
+
+# Register PartitionStats in _swigfaiss:
+_swigfaiss.PartitionStats_swigregister(PartitionStats)
+
+def bitvec_print(b, d):
+    return _swigfaiss.bitvec_print(b, d)
+
+def fvecs2bitvecs(x, b, d, n):
+    return _swigfaiss.fvecs2bitvecs(x, b, d, n)
+
+def bitvecs2fvecs(b, x, d, n):
+    return _swigfaiss.bitvecs2fvecs(b, x, d, n)
+
+def fvec2bitvec(x, b, d):
+    return _swigfaiss.fvec2bitvec(x, b, d)
+
+def bitvec_shuffle(n, da, db, order, a, b):
+    r""" Shuffle the bits from b(i, j) := a(i, order[j])"""
+    return _swigfaiss.bitvec_shuffle(n, da, db, order, a, b)
+class BitstringWriter(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code = property(_swigfaiss.BitstringWriter_code_get, _swigfaiss.BitstringWriter_code_set)
+    code_size = property(_swigfaiss.BitstringWriter_code_size_get, _swigfaiss.BitstringWriter_code_size_set)
+    i = property(_swigfaiss.BitstringWriter_i_get, _swigfaiss.BitstringWriter_i_set)
+
+    def __init__(self, code, code_size):
+        _swigfaiss.BitstringWriter_swiginit(self, _swigfaiss.new_BitstringWriter(code, code_size))
+
+    def write(self, x, nbit):
+        return _swigfaiss.BitstringWriter_write(self, x, nbit)
+    __swig_destroy__ = _swigfaiss.delete_BitstringWriter
+
+# Register BitstringWriter in _swigfaiss:
+_swigfaiss.BitstringWriter_swigregister(BitstringWriter)
+cvar = _swigfaiss.cvar
+
+class BitstringReader(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code = property(_swigfaiss.BitstringReader_code_get, _swigfaiss.BitstringReader_code_set)
+    code_size = property(_swigfaiss.BitstringReader_code_size_get, _swigfaiss.BitstringReader_code_size_set)
+    i = property(_swigfaiss.BitstringReader_i_get, _swigfaiss.BitstringReader_i_set)
+
+    def __init__(self, code, code_size):
+        _swigfaiss.BitstringReader_swiginit(self, _swigfaiss.new_BitstringReader(code, code_size))
+
+    def read(self, nbit):
+        return _swigfaiss.BitstringReader_read(self, nbit)
+    __swig_destroy__ = _swigfaiss.delete_BitstringReader
+
+# Register BitstringReader in _swigfaiss:
+_swigfaiss.BitstringReader_swigregister(BitstringReader)
+
+def hammings(a, b, na, nb, nbytespercode, dis):
+    r"""
+     Compute a set of Hamming distances between na and nb binary vectors
+
+    :type a: uint8_t
+    :param a:             size na * nbytespercode
+    :type b: uint8_t
+    :param b:             size nb * nbytespercode
+    :type nbytespercode: int
+    :param nbytespercode: should be multiple of 8
+    :type dis: int
+    :param dis:           output distances, size na * nb
+    """
+    return _swigfaiss.hammings(a, b, na, nb, nbytespercode, dis)
+
+def hammings_knn_hc(*args):
+    r"""
+     Return the k smallest Hamming distances for a set of binary query vectors,
+    using a max heap.
+    :type a: uint8_t
+    :param a:       queries, size ha->nh * ncodes
+    :type b: uint8_t
+    :param b:       database, size nb * ncodes
+    :type nb: int
+    :param nb:      number of database vectors
+    :type ncodes: int
+    :param ncodes:  size of the binary codes (bytes)
+    :type ordered: int
+    :param ordered: if != 0: order the results by decreasing distance
+                       (may be bottleneck for k/n > 0.01)
+    :type approx_topk_mode: int, optional
+    :param approx_topk_mode: allows to use approximate top-k facilities
+                                to speedup heap
+    """
+    return _swigfaiss.hammings_knn_hc(*args)
+
+def hammings_knn(ha, a, b, nb, ncodes, ordered):
+    return _swigfaiss.hammings_knn(ha, a, b, nb, ncodes, ordered)
+
+def hammings_knn_mc(a, b, na, nb, k, ncodes, distances, labels):
+    r"""
+     Return the k smallest Hamming distances for a set of binary query vectors,
+    using counting max.
+    :type a: uint8_t
+    :param a:       queries, size na * ncodes
+    :type b: uint8_t
+    :param b:       database, size nb * ncodes
+    :type na: int
+    :param na:      number of query vectors
+    :type nb: int
+    :param nb:      number of database vectors
+    :type k: int
+    :param k:       number of vectors/distances to return
+    :type ncodes: int
+    :param ncodes:  size of the binary codes (bytes)
+    :type distances: int
+    :param distances: output distances from each query vector to its k nearest
+                       neighbors
+    :type labels: int
+    :param labels:  output ids of the k nearest neighbors to each query vector
+    """
+    return _swigfaiss.hammings_knn_mc(a, b, na, nb, k, ncodes, distances, labels)
+
+def hamming_range_search(a, b, na, nb, radius, ncodes, result):
+    r""" same as hammings_knn except we are doing a range search with radius"""
+    return _swigfaiss.hamming_range_search(a, b, na, nb, radius, ncodes, result)
+
+def hamming_count_thres(bs1, bs2, n1, n2, ht, ncodes, nptr):
+    return _swigfaiss.hamming_count_thres(bs1, bs2, n1, n2, ht, ncodes, nptr)
+
+def match_hamming_thres(bs1, bs2, n1, n2, ht, ncodes, idx, dis):
+    return _swigfaiss.match_hamming_thres(bs1, bs2, n1, n2, ht, ncodes, idx, dis)
+
+def crosshamming_count_thres(dbs, n, ht, ncodes, nptr):
+    return _swigfaiss.crosshamming_count_thres(dbs, n, ht, ncodes, nptr)
+
+def generalized_hammings_knn_hc(ha, a, b, nb, code_size, ordered=True):
+    r"""
+    generalized Hamming distances (= count number of code bytes that
+       are the same)
+    """
+    return _swigfaiss.generalized_hammings_knn_hc(ha, a, b, nb, code_size, ordered)
+
+def pack_bitstrings(*args):
+    r"""
+    *Overload 1:*
+     Pack a set of n codes of size M * nbit
+
+    :type n: int
+    :param n:           number of codes to pack
+    :type M: int
+    :param M:           number of elementary codes per code
+    :type nbit: int
+    :param nbit:        number of bits per elementary code
+    :type unpacked: int
+    :param unpacked:    input unpacked codes, size (n, M)
+    :type packed: uint8_t
+    :param packed:      output packed codes, size (n, code_size)
+    :type code_size: int
+    :param code_size:   should be >= ceil(M * nbit / 8)
+
+    |
+
+    *Overload 2:*
+     Pack a set of n codes of variable sizes
+
+    :param nbit:       number of bits per entry (size M)
+    """
+    return _swigfaiss.pack_bitstrings(*args)
+
+def unpack_bitstrings(*args):
+    r"""
+    *Overload 1:*
+     Unpack a set of n codes of size M * nbit
+
+    :type n: int
+    :param n:           number of codes to pack
+    :type M: int
+    :param M:           number of elementary codes per code
+    :type nbit: int
+    :param nbit:        number of bits per elementary code
+    :type unpacked: int
+    :param unpacked:    input unpacked codes, size (n, M)
+    :type packed: uint8_t
+    :param packed:      output packed codes, size (n, code_size)
+    :type code_size: int
+    :param code_size:   should be >= ceil(M * nbit / 8)
+
+    |
+
+    *Overload 2:*
+     Unpack a set of n codes of variable sizes
+
+    :param nbit:       number of bits per entry (size M)
+    """
+    return _swigfaiss.unpack_bitstrings(*args)
+
+def popcount32(x):
+    return _swigfaiss.popcount32(x)
+
+def popcount64(x):
+    return _swigfaiss.popcount64(x)
+
+def get_num_gpus():
+    return _swigfaiss.get_num_gpus()
+
+def gpu_profiler_start():
+    return _swigfaiss.gpu_profiler_start()
+
+def gpu_profiler_stop():
+    return _swigfaiss.gpu_profiler_stop()
+
+def gpu_sync_all_devices():
+    return _swigfaiss.gpu_sync_all_devices()
+
+def get_compile_options():
+    r""" get compile options"""
+    return _swigfaiss.get_compile_options()
+
+def getmillisecs():
+    r""" ms elapsed since some arbitrary epoch"""
+    return _swigfaiss.getmillisecs()
+
+def get_mem_usage_kb():
+    r""" get current RSS usage in kB"""
+    return _swigfaiss.get_mem_usage_kb()
+
+def get_cycles():
+    return _swigfaiss.get_cycles()
+
+def reflection(u, x, n, d, nu):
+    return _swigfaiss.reflection(u, x, n, d, nu)
+
+def matrix_qr(m, n, a):
+    r"""
+     compute the Q of the QR decomposition for m > n
+    :type a: float
+    :param a:   size n * m: input matrix and output Q
+    """
+    return _swigfaiss.matrix_qr(m, n, a)
+
+def ranklist_handle_ties(k, idx, dis):
+    r""" distances are supposed to be sorted. Sorts indices with same distance"""
+    return _swigfaiss.ranklist_handle_ties(k, idx, dis)
+
+def ranklist_intersection_size(k1, v1, k2, v2):
+    r"""
+     count the number of common elements between v1 and v2
+    algorithm = sorting + bissection to avoid double-counting duplicates
+    """
+    return _swigfaiss.ranklist_intersection_size(k1, v1, k2, v2)
+
+def merge_result_table_with(n, k, I0, D0, I1, D1, keep_min=True, translation=0):
+    r"""
+     merge a result table into another one
+
+    :type I0: int
+    :param I0:, D0       first result table, size (n, k)
+    :type I1: int
+    :param I1:, D1       second result table, size (n, k)
+    :type keep_min: boolean, optional
+    :param keep_min:     if true, keep min values, otherwise keep max
+    :type translation: int, optional
+    :param translation:  add this value to all I1's indexes
+    :rtype: int
+    :return: nb of values that were taken from the second table
+    """
+    return _swigfaiss.merge_result_table_with(n, k, I0, D0, I1, D1, keep_min, translation)
+
+def imbalance_factor(*args):
+    r"""
+    *Overload 1:*
+    a balanced assignment has a IF of 1
+
+    |
+
+    *Overload 2:*
+    same, takes a histogram as input
+    """
+    return _swigfaiss.imbalance_factor(*args)
+
+def ivec_hist(n, v, vmax, hist):
+    r""" compute histogram on v"""
+    return _swigfaiss.ivec_hist(n, v, vmax, hist)
+
+def bincode_hist(n, nbits, codes, hist):
+    r"""
+     Compute histogram of bits on a code array
+
+    :type codes: uint8_t
+    :param codes:   size(n, nbits / 8)
+    :type hist: int
+    :param hist:    size(nbits): nb of 1s in the array of codes
+    """
+    return _swigfaiss.bincode_hist(n, nbits, codes, hist)
+
+def ivec_checksum(n, a):
+    r""" compute a checksum on a table."""
+    return _swigfaiss.ivec_checksum(n, a)
+
+def bvec_checksum(n, a):
+    r""" compute a checksum on a table."""
+    return _swigfaiss.bvec_checksum(n, a)
+
+def bvecs_checksum(n, d, a, cs):
+    r"""
+     compute checksums for the rows of a matrix
+
+    :type n: int
+    :param n:   number of rows
+    :type d: int
+    :param d:   size per row
+    :type a: uint8_t
+    :param a:   matrix to handle, size n * d
+    :type cs: int
+    :param cs:  output checksums, size n
+    """
+    return _swigfaiss.bvecs_checksum(n, d, a, cs)
+
+def fvecs_maybe_subsample(d, n, nmax, x, verbose=False, seed=1234):
+    r"""
+     random subsamples a set of vectors if there are too many of them
+
+    :type d: int
+    :param d:      dimension of the vectors
+    :type n: int
+    :param n:      on input: nb of input vectors, output: nb of output vectors
+    :type nmax: int
+    :param nmax:   max nb of vectors to keep
+    :type x: float
+    :param x:      input array, size *n-by-d
+    :type seed: int, optional
+    :param seed:   random seed to use for sampling
+    :rtype: float
+    :return: x or an array allocated with new [] with *n vectors
+    """
+    return _swigfaiss.fvecs_maybe_subsample(d, n, nmax, x, verbose, seed)
+
+def binary_to_real(d, x_in, x_out):
+    r"""
+     Convert binary vector to +1/-1 valued float vector.
+
+    :type d: int
+    :param d:      dimension of the vector (multiple of 8)
+    :type x_in: uint8_t
+    :param x_in:   input binary vector (uint8_t table of size d / 8)
+    :type x_out: float
+    :param x_out:  output float vector (float table of size d)
+    """
+    return _swigfaiss.binary_to_real(d, x_in, x_out)
+
+def real_to_binary(d, x_in, x_out):
+    r"""
+     Convert float vector to binary vector. Components > 0 are converted to 1,
+    others to 0.
+
+    :type d: int
+    :param d:      dimension of the vector (multiple of 8)
+    :type x_in: float
+    :param x_in:   input float vector (float table of size d)
+    :type x_out: uint8_t
+    :param x_out:  output binary vector (uint8_t table of size d / 8)
+    """
+    return _swigfaiss.real_to_binary(d, x_in, x_out)
+
+def hash_bytes(bytes, n):
+    r""" A reasonable hashing function"""
+    return _swigfaiss.hash_bytes(bytes, n)
+
+def check_openmp():
+    r""" Whether OpenMP annotations were respected."""
+    return _swigfaiss.check_openmp()
+class CodeSet(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    d = property(_swigfaiss.CodeSet_d_get, _swigfaiss.CodeSet_d_set)
+    s = property(_swigfaiss.CodeSet_s_get, _swigfaiss.CodeSet_s_set)
+
+    def __init__(self, d):
+        _swigfaiss.CodeSet_swiginit(self, _swigfaiss.new_CodeSet(d))
+
+    def insert(self, n, codes, inserted):
+        return _swigfaiss.CodeSet_insert(self, n, codes, inserted)
+    __swig_destroy__ = _swigfaiss.delete_CodeSet
+
+# Register CodeSet in _swigfaiss:
+_swigfaiss.CodeSet_swigregister(CodeSet)
+hamdis_tab_ham_bytes = cvar.hamdis_tab_ham_bytes
+
+class CombinerRangeKNNfloat(object):
+    r"""
+     This class is used to combine range and knn search results
+    in contrib.exhaustive_search.range_search_gpu
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss.CombinerRangeKNNfloat_nq_get, _swigfaiss.CombinerRangeKNNfloat_nq_set)
+    k = property(_swigfaiss.CombinerRangeKNNfloat_k_get, _swigfaiss.CombinerRangeKNNfloat_k_set, doc=r""" nb of queries""")
+    r2 = property(_swigfaiss.CombinerRangeKNNfloat_r2_get, _swigfaiss.CombinerRangeKNNfloat_r2_set, doc=r""" number of neighbors for the knn search part""")
+    keep_max = property(_swigfaiss.CombinerRangeKNNfloat_keep_max_get, _swigfaiss.CombinerRangeKNNfloat_keep_max_set, doc=r""" range search radius""")
+
+    def __init__(self, nq, k, r2, keep_max):
+        r""" whether to keep max values instead of min."""
+        _swigfaiss.CombinerRangeKNNfloat_swiginit(self, _swigfaiss.new_CombinerRangeKNNfloat(nq, k, r2, keep_max))
+    I = property(_swigfaiss.CombinerRangeKNNfloat_I_get, _swigfaiss.CombinerRangeKNNfloat_I_set, doc=r""" Knn search results""")
+    D = property(_swigfaiss.CombinerRangeKNNfloat_D_get, _swigfaiss.CombinerRangeKNNfloat_D_set, doc=r""" size nq * k""")
+    mask = property(_swigfaiss.CombinerRangeKNNfloat_mask_get, _swigfaiss.CombinerRangeKNNfloat_mask_set, doc=r"""
+    size nq * k
+    optional: range search results (ignored if mask is NULL)
+    """)
+    lim_remain = property(_swigfaiss.CombinerRangeKNNfloat_lim_remain_get, _swigfaiss.CombinerRangeKNNfloat_lim_remain_set, doc=r""" mask for where knn results are valid, size nq""")
+    D_remain = property(_swigfaiss.CombinerRangeKNNfloat_D_remain_get, _swigfaiss.CombinerRangeKNNfloat_D_remain_set, doc=r""" size nrange + 1""")
+    I_remain = property(_swigfaiss.CombinerRangeKNNfloat_I_remain_get, _swigfaiss.CombinerRangeKNNfloat_I_remain_set, doc=r""" size lim_remain[nrange]""")
+    L_res = property(_swigfaiss.CombinerRangeKNNfloat_L_res_get, _swigfaiss.CombinerRangeKNNfloat_L_res_set, doc=r""" size lim_remain[nrange]""")
+
+    def compute_sizes(self, L_res):
+        r""" size nq + 1"""
+        return _swigfaiss.CombinerRangeKNNfloat_compute_sizes(self, L_res)
+
+    def write_result(self, D_res, I_res):
+        r"""
+        Phase 2: caller allocates D_res and I_res (size L_res[nq])
+        Phase 3: fill in D_res and I_res
+        """
+        return _swigfaiss.CombinerRangeKNNfloat_write_result(self, D_res, I_res)
+    __swig_destroy__ = _swigfaiss.delete_CombinerRangeKNNfloat
+
+# Register CombinerRangeKNNfloat in _swigfaiss:
+_swigfaiss.CombinerRangeKNNfloat_swigregister(CombinerRangeKNNfloat)
+class CombinerRangeKNNint16(object):
+    r"""
+     This class is used to combine range and knn search results
+    in contrib.exhaustive_search.range_search_gpu
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss.CombinerRangeKNNint16_nq_get, _swigfaiss.CombinerRangeKNNint16_nq_set)
+    k = property(_swigfaiss.CombinerRangeKNNint16_k_get, _swigfaiss.CombinerRangeKNNint16_k_set, doc=r""" nb of queries""")
+    r2 = property(_swigfaiss.CombinerRangeKNNint16_r2_get, _swigfaiss.CombinerRangeKNNint16_r2_set, doc=r""" number of neighbors for the knn search part""")
+    keep_max = property(_swigfaiss.CombinerRangeKNNint16_keep_max_get, _swigfaiss.CombinerRangeKNNint16_keep_max_set, doc=r""" range search radius""")
+
+    def __init__(self, nq, k, r2, keep_max):
+        r""" whether to keep max values instead of min."""
+        _swigfaiss.CombinerRangeKNNint16_swiginit(self, _swigfaiss.new_CombinerRangeKNNint16(nq, k, r2, keep_max))
+    I = property(_swigfaiss.CombinerRangeKNNint16_I_get, _swigfaiss.CombinerRangeKNNint16_I_set, doc=r""" Knn search results""")
+    D = property(_swigfaiss.CombinerRangeKNNint16_D_get, _swigfaiss.CombinerRangeKNNint16_D_set, doc=r""" size nq * k""")
+    mask = property(_swigfaiss.CombinerRangeKNNint16_mask_get, _swigfaiss.CombinerRangeKNNint16_mask_set, doc=r"""
+    size nq * k
+    optional: range search results (ignored if mask is NULL)
+    """)
+    lim_remain = property(_swigfaiss.CombinerRangeKNNint16_lim_remain_get, _swigfaiss.CombinerRangeKNNint16_lim_remain_set, doc=r""" mask for where knn results are valid, size nq""")
+    D_remain = property(_swigfaiss.CombinerRangeKNNint16_D_remain_get, _swigfaiss.CombinerRangeKNNint16_D_remain_set, doc=r""" size nrange + 1""")
+    I_remain = property(_swigfaiss.CombinerRangeKNNint16_I_remain_get, _swigfaiss.CombinerRangeKNNint16_I_remain_set, doc=r""" size lim_remain[nrange]""")
+    L_res = property(_swigfaiss.CombinerRangeKNNint16_L_res_get, _swigfaiss.CombinerRangeKNNint16_L_res_set, doc=r""" size lim_remain[nrange]""")
+
+    def compute_sizes(self, L_res):
+        r""" size nq + 1"""
+        return _swigfaiss.CombinerRangeKNNint16_compute_sizes(self, L_res)
+
+    def write_result(self, D_res, I_res):
+        r"""
+        Phase 2: caller allocates D_res and I_res (size L_res[nq])
+        Phase 3: fill in D_res and I_res
+        """
+        return _swigfaiss.CombinerRangeKNNint16_write_result(self, D_res, I_res)
+    __swig_destroy__ = _swigfaiss.delete_CombinerRangeKNNint16
+
+# Register CombinerRangeKNNint16 in _swigfaiss:
+_swigfaiss.CombinerRangeKNNint16_swigregister(CombinerRangeKNNint16)
+
+def fvec_L2sqr(x, y, d):
+    r""" Squared L2 distance between two vectors"""
+    return _swigfaiss.fvec_L2sqr(x, y, d)
+
+def fvec_inner_product(x, y, d):
+    r""" inner product"""
+    return _swigfaiss.fvec_inner_product(x, y, d)
+
+def fvec_L1(x, y, d):
+    r""" L1 distance"""
+    return _swigfaiss.fvec_L1(x, y, d)
+
+def fvec_Linf(x, y, d):
+    r""" infinity distance"""
+    return _swigfaiss.fvec_Linf(x, y, d)
+
+def fvec_inner_product_batch_4(x, y0, y1, y2, y3, d, dis0, dis1, dis2, dis3):
+    r"""
+    Special version of inner product that computes 4 distances
+    between x and yi, which is performance oriented.
+    """
+    return _swigfaiss.fvec_inner_product_batch_4(x, y0, y1, y2, y3, d, dis0, dis1, dis2, dis3)
+
+def fvec_L2sqr_batch_4(x, y0, y1, y2, y3, d, dis0, dis1, dis2, dis3):
+    r"""
+    Special version of L2sqr that computes 4 distances
+    between x and yi, which is performance oriented.
+    """
+    return _swigfaiss.fvec_L2sqr_batch_4(x, y0, y1, y2, y3, d, dis0, dis1, dis2, dis3)
+
+def pairwise_L2sqr(d, nq, xq, nb, xb, dis, ldq=-1, ldb=-1, ldd=-1):
+    r"""
+     Compute pairwise distances between sets of vectors
+
+    :type d: int
+    :param d:     dimension of the vectors
+    :type nq: int
+    :param nq:    nb of query vectors
+    :type nb: int
+    :param nb:    nb of database vectors
+    :type xq: float
+    :param xq:    query vectors (size nq * d)
+    :type xb: float
+    :param xb:    database vectors (size nb * d)
+    :type dis: float
+    :param dis:   output distances (size nq * nb)
+    :param ldq,ldb:, ldd strides for the matrices
+    """
+    return _swigfaiss.pairwise_L2sqr(d, nq, xq, nb, xb, dis, ldq, ldb, ldd)
+
+def fvec_inner_products_ny(ip, x, y, d, ny):
+    return _swigfaiss.fvec_inner_products_ny(ip, x, y, d, ny)
+
+def fvec_L2sqr_ny(dis, x, y, d, ny):
+    return _swigfaiss.fvec_L2sqr_ny(dis, x, y, d, ny)
+
+def fvec_L2sqr_ny_transposed(dis, x, y, y_sqlen, d, d_offset, ny):
+    return _swigfaiss.fvec_L2sqr_ny_transposed(dis, x, y, y_sqlen, d, d_offset, ny)
+
+def fvec_L2sqr_ny_nearest(distances_tmp_buffer, x, y, d, ny):
+    return _swigfaiss.fvec_L2sqr_ny_nearest(distances_tmp_buffer, x, y, d, ny)
+
+def fvec_L2sqr_ny_nearest_y_transposed(distances_tmp_buffer, x, y, y_sqlen, d, d_offset, ny):
+    return _swigfaiss.fvec_L2sqr_ny_nearest_y_transposed(distances_tmp_buffer, x, y, y_sqlen, d, d_offset, ny)
+
+def fvec_norm_L2sqr(x, d):
+    r""" squared norm of a vector"""
+    return _swigfaiss.fvec_norm_L2sqr(x, d)
+
+def fvec_norms_L2(norms, x, d, nx):
+    r"""
+     compute the L2 norms for a set of vectors
+
+    :type norms: float
+    :param norms:    output norms, size nx
+    :type x: float
+    :param x:        set of vectors, size nx * d
+    """
+    return _swigfaiss.fvec_norms_L2(norms, x, d, nx)
+
+def fvec_norms_L2sqr(norms, x, d, nx):
+    r""" same as fvec_norms_L2, but computes squared norms"""
+    return _swigfaiss.fvec_norms_L2sqr(norms, x, d, nx)
+
+def fvec_renorm_L2(d, nx, x):
+    return _swigfaiss.fvec_renorm_L2(d, nx, x)
+
+def inner_product_to_L2sqr(dis, nr1, nr2, n1, n2):
+    return _swigfaiss.inner_product_to_L2sqr(dis, nr1, nr2, n1, n2)
+
+def fvec_add(*args):
+    r"""
+    *Overload 1:*
+     compute c := a + b for vectors
+
+    c and a can overlap, c and b can overlap
+
+    :type a: float
+    :param a: size d
+    :type b: float
+    :param b: size d
+    :type c: float
+    :param c: size d
+
+    |
+
+    *Overload 2:*
+     compute c := a + b for a, c vectors and b a scalar
+
+    c and a can overlap
+
+    :type a: float
+    :param a: size d
+    :type c: float
+    :param c: size d
+    """
+    return _swigfaiss.fvec_add(*args)
+
+def fvec_sub(d, a, b, c):
+    r"""
+     compute c := a - b for vectors
+
+    c and a can overlap, c and b can overlap
+
+    :type a: float
+    :param a: size d
+    :type b: float
+    :param b: size d
+    :type c: float
+    :param c: size d
+    """
+    return _swigfaiss.fvec_sub(d, a, b, c)
+
+def fvec_inner_products_by_idx(ip, x, y, ids, d, nx, ny):
+    r"""
+     compute the inner product between x and a subset y of ny vectors defined by
+    ids
+
+    ip(i, j) = inner_product(x(i, :), y(ids(i, j), :))
+
+    :type ip: float
+    :param ip:    output array, size nx * ny
+    :type x: float
+    :param x:     first-term vector, size nx * d
+    :type y: float
+    :param y:     second-term vector, size (max(ids) + 1) * d
+    :type ids: int
+    :param ids:   ids to sample from y, size nx * ny
+    """
+    return _swigfaiss.fvec_inner_products_by_idx(ip, x, y, ids, d, nx, ny)
+
+def fvec_L2sqr_by_idx(dis, x, y, ids, d, nx, ny):
+    r"""
+     compute the squared L2 distances between x and a subset y of ny vectors
+    defined by ids
+
+    dis(i, j) = inner_product(x(i, :), y(ids(i, j), :))
+
+    :type dis: float
+    :param dis:   output array, size nx * ny
+    :type x: float
+    :param x:     first-term vector, size nx * d
+    :type y: float
+    :param y:     second-term vector, size (max(ids) + 1) * d
+    :type ids: int
+    :param ids:   ids to sample from y, size nx * ny
+    """
+    return _swigfaiss.fvec_L2sqr_by_idx(dis, x, y, ids, d, nx, ny)
+
+def pairwise_indexed_L2sqr(d, n, x, ix, y, iy, dis):
+    r"""
+     compute dis[j] = L2sqr(x[ix[j]], y[iy[j]]) forall j=0..n-1
+
+    :type x: float
+    :param x:  size (max(ix) + 1, d)
+    :type y: float
+    :param y:  size (max(iy) + 1, d)
+    :type ix: int
+    :param ix: size n
+    :type iy: int
+    :param iy: size n
+    :type dis: float
+    :param dis: size n
+    """
+    return _swigfaiss.pairwise_indexed_L2sqr(d, n, x, ix, y, iy, dis)
+
+def pairwise_indexed_inner_product(d, n, x, ix, y, iy, dis):
+    r"""
+     compute dis[j] = inner_product(x[ix[j]], y[iy[j]]) forall j=0..n-1
+
+    :type x: float
+    :param x:  size (max(ix) + 1, d)
+    :type y: float
+    :param y:  size (max(iy) + 1, d)
+    :type ix: int
+    :param ix: size n
+    :type iy: int
+    :param iy: size n
+    :type dis: float
+    :param dis: size n
+    """
+    return _swigfaiss.pairwise_indexed_inner_product(d, n, x, ix, y, iy, dis)
+
+def knn_inner_product(*args):
+    r"""
+    *Overload 1:*
+     Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, w.r.t to max inner product.
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type res: :py:class:`float_minheap_array_t`
+    :param res:  result heap structure, which also provides k. Sorted on output
+
+    |
+
+    *Overload 2:*
+      Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, for the inner product metric.
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type distances: float
+    :param distances:  output distances, size nq * k
+    :type indexes: int
+    :param indexes:    output vector ids, size nq * k
+
+    |
+
+    *Overload 3:*
+      Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, for the inner product metric.
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type distances: float
+    :param distances:  output distances, size nq * k
+    :type indexes: int
+    :param indexes:    output vector ids, size nq * k
+    """
+    return _swigfaiss.knn_inner_product(*args)
+
+def knn_L2sqr(*args):
+    r"""
+    *Overload 1:*
+     Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, for the L2 distance
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type res: :py:class:`float_maxheap_array_t`
+    :param res:  result heap strcture, which also provides k. Sorted on output
+    :type y_norm2: float, optional
+    :param y_norm2:    (optional) norms for the y vectors (nullptr or size ny)
+    :type sel: :py:class:`IDSelector`, optional
+    :param sel:  search in this subset of vectors
+
+    |
+
+    *Overload 2:*
+      Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, for the L2 distance
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type distances: float
+    :param distances:  output distances, size nq * k
+    :type indexes: int
+    :param indexes:    output vector ids, size nq * k
+    :type y_norm2: float, optional
+    :param y_norm2:    (optional) norms for the y vectors (nullptr or size ny)
+    :type sel: :py:class:`IDSelector`, optional
+    :param sel:  search in this subset of vectors
+
+    |
+
+    *Overload 3:*
+      Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, for the L2 distance
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type distances: float
+    :param distances:  output distances, size nq * k
+    :type indexes: int
+    :param indexes:    output vector ids, size nq * k
+    :type y_norm2: float, optional
+    :param y_norm2:    (optional) norms for the y vectors (nullptr or size ny)
+    :param sel:  search in this subset of vectors
+
+    |
+
+    *Overload 4:*
+      Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, for the L2 distance
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type distances: float
+    :param distances:  output distances, size nq * k
+    :type indexes: int
+    :param indexes:    output vector ids, size nq * k
+    :param y_norm2:    (optional) norms for the y vectors (nullptr or size ny)
+    :param sel:  search in this subset of vectors
+    """
+    return _swigfaiss.knn_L2sqr(*args)
+
+def knn_inner_products_by_idx(x, y, subset, d, nx, ny, nsubset, k, vals, ids, ld_ids=-1):
+    r"""
+     Find the max inner product neighbors for nx queries in a set of ny vectors
+    indexed by ids. May be useful for re-ranking a pre-selected vector list
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size (max(ids) + 1) * d
+    :type ids: int
+    :param ids:  subset of database vectors to consider, size (nx, nsubset)
+    :param res:  result structure
+    :type ld_ids: int, optional
+    :param ld_ids: stride for the ids array. -1: use nsubset, 0: all queries
+        process the same subset
+    """
+    return _swigfaiss.knn_inner_products_by_idx(x, y, subset, d, nx, ny, nsubset, k, vals, ids, ld_ids)
+
+def knn_L2sqr_by_idx(x, y, subset, d, nx, ny, nsubset, k, vals, ids, ld_subset=-1):
+    r"""
+     Find the nearest neighbors for nx queries in a set of ny vectors
+    indexed by ids. May be useful for re-ranking a pre-selected vector list
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size (max(ids) + 1) * d
+    :type subset: int
+    :param subset: subset of database vectors to consider, size (nx, nsubset)
+    :param res:  rIDesult structure
+    :type ld_subset: int, optional
+    :param ld_subset: stride for the subset array. -1: use nsubset, 0: all queries
+        process the same subset
+    """
+    return _swigfaiss.knn_L2sqr_by_idx(x, y, subset, d, nx, ny, nsubset, k, vals, ids, ld_subset)
+
+def range_search_L2sqr(x, y, d, nx, ny, radius, result, sel=None):
+    r"""
+     Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, w.r.t to max inner product
+
+    :type x: float
+    :param x:      query vectors, size nx * d
+    :type y: float
+    :param y:      database vectors, size ny * d
+    :type radius: float
+    :param radius: search radius around the x vectors
+    :type result: :py:class:`RangeSearchResult`
+    :param result: result structure
+    """
+    return _swigfaiss.range_search_L2sqr(x, y, d, nx, ny, radius, result, sel)
+
+def range_search_inner_product(x, y, d, nx, ny, radius, result, sel=None):
+    r""" same as range_search_L2sqr for the inner product similarity"""
+    return _swigfaiss.range_search_inner_product(x, y, d, nx, ny, radius, result, sel)
+
+def compute_PQ_dis_tables_dsub2(d, ksub, centroids, nx, x, is_inner_product, dis_tables):
+    r""" specialized function for PQ2"""
+    return _swigfaiss.compute_PQ_dis_tables_dsub2(d, ksub, centroids, nx, x, is_inner_product, dis_tables)
+
+def fvec_madd(n, a, bf, b, c):
+    r"""
+     compute c := a + bf * b for a, b and c tables
+
+    :type n: int
+    :param n:   size of the tables
+    :type a: float
+    :param a:   size n
+    :type b: float
+    :param b:   size n
+    :type c: float
+    :param c:   restult table, size n
+    """
+    return _swigfaiss.fvec_madd(n, a, bf, b, c)
+
+def fvec_madd_and_argmin(n, a, bf, b, c):
+    r"""
+     same as fvec_madd, also return index of the min of the result table
+    :rtype: int
+    :return: index of the min of table c
+    """
+    return _swigfaiss.fvec_madd_and_argmin(n, a, bf, b, c)
+class RandomGenerator(object):
+    r""" random generator that can be used in multithreaded contexts"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    mt = property(_swigfaiss.RandomGenerator_mt_get, _swigfaiss.RandomGenerator_mt_set)
+
+    def rand_int64(self):
+        r""" random int64_t"""
+        return _swigfaiss.RandomGenerator_rand_int64(self)
+
+    def rand_int(self, *args):
+        r"""
+        *Overload 1:*
+        random positive integer
+
+        |
+
+        *Overload 2:*
+        generate random integer between 0 and max-1
+        """
+        return _swigfaiss.RandomGenerator_rand_int(self, *args)
+
+    def rand_float(self):
+        r""" between 0 and 1"""
+        return _swigfaiss.RandomGenerator_rand_float(self)
+
+    def rand_double(self):
+        return _swigfaiss.RandomGenerator_rand_double(self)
+
+    def __init__(self, seed=1234):
+        _swigfaiss.RandomGenerator_swiginit(self, _swigfaiss.new_RandomGenerator(seed))
+    __swig_destroy__ = _swigfaiss.delete_RandomGenerator
+
+# Register RandomGenerator in _swigfaiss:
+_swigfaiss.RandomGenerator_swigregister(RandomGenerator)
+
+def float_rand(x, n, seed):
+    return _swigfaiss.float_rand(x, n, seed)
+
+def float_randn(x, n, seed):
+    return _swigfaiss.float_randn(x, n, seed)
+
+def int64_rand(x, n, seed):
+    return _swigfaiss.int64_rand(x, n, seed)
+
+def byte_rand(x, n, seed):
+    return _swigfaiss.byte_rand(x, n, seed)
+
+def int64_rand_max(x, n, max, seed):
+    return _swigfaiss.int64_rand_max(x, n, max, seed)
+
+def rand_perm(perm, n, seed):
+    return _swigfaiss.rand_perm(perm, n, seed)
+
+def rand_smooth_vectors(n, d, x, seed):
+    return _swigfaiss.rand_smooth_vectors(n, d, x, seed)
+
+def fvec_argsort(n, vals, perm):
+    r"""
+     Indirect sort of a floating-point array
+
+    :type n: int
+    :param n:     size of the array
+    :type vals: float
+    :param vals:  array to sort, size n
+    :type perm: int
+    :param perm:  output: permutation of [0..n-1], st.
+                     vals[perm[i + 1]] >= vals[perm[i]]
+    """
+    return _swigfaiss.fvec_argsort(n, vals, perm)
+
+def fvec_argsort_parallel(n, vals, perm):
+    r""" Same as fvec_argsort, parallelized"""
+    return _swigfaiss.fvec_argsort_parallel(n, vals, perm)
+
+def bucket_sort(nval, vals, nbucket, lims, perm, nt=0):
+    r"""
+     Bucket sort of a list of values
+
+    :type vals: int
+    :param vals:     values to sort, size nval, max value nbucket - 1
+    :type lims: int
+    :param lims:     output limits of buckets, size nbucket + 1
+    :type perm: int
+    :param perm:     output buckets, the elements of bucket
+                        i are in perm[lims[i]:lims[i + 1]]
+    :type nt: int, optional
+    :param nt:       number of threads (0 = pure sequential code)
+    """
+    return _swigfaiss.bucket_sort(nval, vals, nbucket, lims, perm, nt)
+
+def matrix_bucket_sort_inplace(*args):
+    r"""
+    *Overload 1:*
+     in-place bucket sort (with attention to memory=>int32)
+    on input the values are in a nrow * col matrix
+    we want to store the row numbers in the output.
+
+    :type vals: int
+    :param vals:     positive values to sort, size nrow * ncol,
+                        max value nbucket - 1
+    :type lims: int
+    :param lims:     output limits of buckets, size nbucket + 1
+    :type nt: int, optional
+    :param nt:       number of threads (0 = pure sequential code)
+
+    |
+
+    *Overload 2:*
+     same with int64 elements
+
+    |
+
+    *Overload 3:*
+     same with int64 elements
+    """
+    return _swigfaiss.matrix_bucket_sort_inplace(*args)
+
+def hashtable_int64_to_int64_init(log2_capacity, tab):
+    r"""
+     Hashtable implementation for int64 -> int64 with external storage
+    implemented for fast batch add and lookup.
+
+    tab is of size  2 * (1 << log2_capacity)
+    n is the number of elements to add or search
+
+    adding several values in a same batch: an arbitrary one gets added
+    in different batches: the newer batch overwrites.
+    raises an exception if capacity is exhausted.
+    """
+    return _swigfaiss.hashtable_int64_to_int64_init(log2_capacity, tab)
+
+def hashtable_int64_to_int64_add(log2_capacity, tab, n, keys, vals):
+    return _swigfaiss.hashtable_int64_to_int64_add(log2_capacity, tab, n, keys, vals)
+
+def hashtable_int64_to_int64_lookup(log2_capacity, tab, n, keys, vals):
+    return _swigfaiss.hashtable_int64_to_int64_lookup(log2_capacity, tab, n, keys, vals)
+METRIC_INNER_PRODUCT = _swigfaiss.METRIC_INNER_PRODUCT
+r""" maximum inner product search"""
+METRIC_L2 = _swigfaiss.METRIC_L2
+r""" squared L2 search"""
+METRIC_L1 = _swigfaiss.METRIC_L1
+r""" L1 (aka cityblock)"""
+METRIC_Linf = _swigfaiss.METRIC_Linf
+r""" infinity distance"""
+METRIC_Lp = _swigfaiss.METRIC_Lp
+r""" L_p distance, p is given by a faiss::Index"""
+METRIC_Canberra = _swigfaiss.METRIC_Canberra
+r"""
+    metric_arg
+    some additional metrics defined in scipy.spatial.distance
+    """
+METRIC_BrayCurtis = _swigfaiss.METRIC_BrayCurtis
+METRIC_JensenShannon = _swigfaiss.METRIC_JensenShannon
+METRIC_Jaccard = _swigfaiss.METRIC_Jaccard
+r"""
+    defined as: sum_i(min(a_i, b_i)) / sum_i(max(a_i, b_i))
+    where a_i, b_i > 0
+    """
+
+def is_similarity_metric(metric_type):
+    r"""
+    this function is used to distinguish between min and max indexes since
+    we need to support similarity and dis-similarity metrics in a flexible way
+    """
+    return _swigfaiss.is_similarity_metric(metric_type)
+FAISS_VERSION_MAJOR = _swigfaiss.FAISS_VERSION_MAJOR
+r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+FAISS_VERSION_MINOR = _swigfaiss.FAISS_VERSION_MINOR
+FAISS_VERSION_PATCH = _swigfaiss.FAISS_VERSION_PATCH
+class SearchParameters(object):
+    r"""
+     Parent class for the optional search paramenters.
+
+    Sub-classes with additional search parameters should inherit this class.
+    Ownership of the object fields is always to the caller.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    sel = property(_swigfaiss.SearchParameters_sel_get, _swigfaiss.SearchParameters_sel_set, doc=r""" if non-null, only these IDs will be considered during search.""")
+    __swig_destroy__ = _swigfaiss.delete_SearchParameters
+
+    def __init__(self):
+        _swigfaiss.SearchParameters_swiginit(self, _swigfaiss.new_SearchParameters())
+
+# Register SearchParameters in _swigfaiss:
+_swigfaiss.SearchParameters_swigregister(SearchParameters)
+class Index(object):
+    r"""
+     Abstract structure for an index, supports adding vectors and searching them.
+
+    All vectors provided at add or search time are 32-bit float arrays,
+    although the internal representation may vary.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    d = property(_swigfaiss.Index_d_get, _swigfaiss.Index_d_set, doc=r""" vector dimension""")
+    ntotal = property(_swigfaiss.Index_ntotal_get, _swigfaiss.Index_ntotal_set, doc=r""" total nb of indexed vectors""")
+    verbose = property(_swigfaiss.Index_verbose_get, _swigfaiss.Index_verbose_set, doc=r""" verbosity level""")
+    is_trained = property(_swigfaiss.Index_is_trained_get, _swigfaiss.Index_is_trained_set, doc=r"""
+    set if the Index does not require training, or if training is
+    done already
+    """)
+    metric_type = property(_swigfaiss.Index_metric_type_get, _swigfaiss.Index_metric_type_set, doc=r""" type of metric this index uses for search""")
+    metric_arg = property(_swigfaiss.Index_metric_arg_get, _swigfaiss.Index_metric_arg_set, doc=r""" argument of the metric type""")
+    __swig_destroy__ = _swigfaiss.delete_Index
+
+    def train(self, n, x):
+        r"""
+         Perform training on a representative set of vectors
+
+        :type n: int
+        :param n:      nb of training vectors
+        :type x: float
+        :param x:      training vecors, size n * d
+        """
+        return _swigfaiss.Index_train(self, n, x)
+
+    def add(self, n, x):
+        r"""
+         Add n vectors of dimension d to the index.
+
+        Vectors are implicitly assigned labels ntotal .. ntotal + n - 1
+        This function slices the input vectors in chunks smaller than
+        blocksize_add and calls add_core.
+        :type n: int
+        :param n:      number of vectors
+        :type x: float
+        :param x:      input matrix, size n * d
+        """
+        return _swigfaiss.Index_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        r"""
+         Same as add, but stores xids instead of sequential ids.
+
+        The default implementation fails with an assertion, as it is
+        not supported by all indexes.
+
+        :type n: int
+        :param n:         number of vectors
+        :type x: float
+        :param x:         input vectors, size n * d
+        :type xids: int
+        :param xids:      if non-null, ids to store for the vectors (size n)
+        """
+        return _swigfaiss.Index_add_with_ids(self, n, x, xids)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r"""
+         query n vectors of dimension d to the index.
+
+        return at most k vectors. If there are not enough results for a
+        query, the result array is padded with -1s.
+
+        :type n: int
+        :param n:           number of vectors
+        :type x: float
+        :param x:           input vectors to search, size n * d
+        :type k: int
+        :param k:           number of extracted vectors
+        :type distances: float
+        :param distances:   output pairwise distances, size n*k
+        :type labels: int
+        :param labels:      output labels of the NNs, size n*k
+        """
+        return _swigfaiss.Index_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        r"""
+         query n vectors of dimension d to the index.
+
+        return all vectors with distance < radius. Note that many
+        indexes do not implement the range_search (only the k-NN search
+        is mandatory).
+
+        :type n: int
+        :param n:           number of vectors
+        :type x: float
+        :param x:           input vectors to search, size n * d
+        :type radius: float
+        :param radius:      search radius
+        :type result: :py:class:`RangeSearchResult`
+        :param result:      result table
+        """
+        return _swigfaiss.Index_range_search(self, n, x, radius, result, params)
+
+    def assign(self, n, x, labels, k=1):
+        r"""
+         return the indexes of the k vectors closest to the query x.
+
+        This function is identical as search but only return labels of neighbors.
+        :type n: int
+        :param n:           number of vectors
+        :type x: float
+        :param x:           input vectors to search, size n * d
+        :type labels: int
+        :param labels:      output labels of the NNs, size n*k
+        :type k: int, optional
+        :param k:           number of nearest neighbours
+        """
+        return _swigfaiss.Index_assign(self, n, x, labels, k)
+
+    def reset(self):
+        r""" removes all elements from the database."""
+        return _swigfaiss.Index_reset(self)
+
+    def remove_ids(self, sel):
+        r"""
+         removes IDs from the index. Not supported by all
+        indexes. Returns the number of elements removed.
+        """
+        return _swigfaiss.Index_remove_ids(self, sel)
+
+    def reconstruct(self, key, recons):
+        r"""
+         Reconstruct a stored vector (or an approximation if lossy coding)
+
+        this function may not be defined for some indexes
+        :type key: int
+        :param key:         id of the vector to reconstruct
+        :type recons: float
+        :param recons:      reconstucted vector (size d)
+        """
+        return _swigfaiss.Index_reconstruct(self, key, recons)
+
+    def reconstruct_batch(self, n, keys, recons):
+        r"""
+         Reconstruct several stored vectors (or an approximation if lossy coding)
+
+        this function may not be defined for some indexes
+        :type n: int
+        :param n:           number of vectors to reconstruct
+        :type keys: int
+        :param keys:        ids of the vectors to reconstruct (size n)
+        :type recons: float
+        :param recons:      reconstucted vector (size n * d)
+        """
+        return _swigfaiss.Index_reconstruct_batch(self, n, keys, recons)
+
+    def reconstruct_n(self, i0, ni, recons):
+        r"""
+         Reconstruct vectors i0 to i0 + ni - 1
+
+        this function may not be defined for some indexes
+        :type i0: int
+        :param i0:          index of the first vector in the sequence
+        :type ni: int
+        :param ni:          number of vectors in the sequence
+        :type recons: float
+        :param recons:      reconstucted vector (size ni * d)
+        """
+        return _swigfaiss.Index_reconstruct_n(self, i0, ni, recons)
+
+    def search_and_reconstruct(self, n, x, k, distances, labels, recons, params=None):
+        r"""
+         Similar to search, but also reconstructs the stored vectors (or an
+        approximation in the case of lossy coding) for the search results.
+
+        If there are not enough results for a query, the resulting arrays
+        is padded with -1s.
+
+        :type n: int
+        :param n:           number of vectors
+        :type x: float
+        :param x:           input vectors to search, size n * d
+        :type k: int
+        :param k:           number of extracted vectors
+        :type distances: float
+        :param distances:   output pairwise distances, size n*k
+        :type labels: int
+        :param labels:      output labels of the NNs, size n*k
+        :type recons: float
+        :param recons:      reconstructed vectors size (n, k, d)
+        """
+        return _swigfaiss.Index_search_and_reconstruct(self, n, x, k, distances, labels, recons, params)
+
+    def compute_residual(self, x, residual, key):
+        r"""
+         Computes a residual vector after indexing encoding.
+
+        The residual vector is the difference between a vector and the
+        reconstruction that can be decoded from its representation in
+        the index. The residual can be used for multiple-stage indexing
+        methods, like IndexIVF's methods.
+
+        :type x: float
+        :param x:           input vector, size d
+        :type residual: float
+        :param residual:    output residual vector, size d
+        :type key: int
+        :param key:         encoded index, as returned by search and assign
+        """
+        return _swigfaiss.Index_compute_residual(self, x, residual, key)
+
+    def compute_residual_n(self, n, xs, residuals, keys):
+        r"""
+         Computes a residual vector after indexing encoding (batch form).
+        Equivalent to calling compute_residual for each vector.
+
+        The residual vector is the difference between a vector and the
+        reconstruction that can be decoded from its representation in
+        the index. The residual can be used for multiple-stage indexing
+        methods, like IndexIVF's methods.
+
+        :type n: int
+        :param n:           number of vectors
+        :type xs: float
+        :param xs:          input vectors, size (n x d)
+        :type residuals: float
+        :param residuals:   output residual vectors, size (n x d)
+        :type keys: int
+        :param keys:        encoded index, as returned by search and assign
+        """
+        return _swigfaiss.Index_compute_residual_n(self, n, xs, residuals, keys)
+
+    def get_distance_computer(self):
+        r"""
+         Get a DistanceComputer (defined in AuxIndexStructures) object
+        for this kind of index.
+
+        DistanceComputer is implemented for indexes that support random
+        access of their vectors.
+        """
+        return _swigfaiss.Index_get_distance_computer(self)
+
+    def sa_code_size(self):
+        r""" size of the produced codes in bytes"""
+        return _swigfaiss.Index_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        r"""
+         encode a set of vectors
+
+        :type n: int
+        :param n:       number of vectors
+        :type x: float
+        :param x:       input vectors, size n * d
+        :type bytes: uint8_t
+        :param bytes:   output encoded vectors, size n * sa_code_size()
+        """
+        return _swigfaiss.Index_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        r"""
+         decode a set of vectors
+
+        :type n: int
+        :param n:       number of vectors
+        :type bytes: uint8_t
+        :param bytes:   input encoded vectors, size n * sa_code_size()
+        :type x: float
+        :param x:       output vectors, size n * d
+        """
+        return _swigfaiss.Index_sa_decode(self, n, bytes, x)
+
+    def merge_from(self, otherIndex, add_id=0):
+        r"""
+         moves the entries from another dataset to self.
+        On output, other is empty.
+        add_id is added to all moved ids
+        (for sequential ids, this would be this->ntotal)
+        """
+        return _swigfaiss.Index_merge_from(self, otherIndex, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        r"""
+         check that the two indexes are compatible (ie, they are
+        trained in the same way and have the same
+        parameters). Otherwise throw.
+        """
+        return _swigfaiss.Index_check_compatible_for_merge(self, otherIndex)
+
+# Register Index in _swigfaiss:
+_swigfaiss.Index_swigregister(Index)
+class DistanceComputer(object):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+
+    def set_query(self, x):
+        r"""
+        called before computing distances. Pointer x should remain valid
+        while operator () is called
+        """
+        return _swigfaiss.DistanceComputer_set_query(self, x)
+
+    def __call__(self, i):
+        r""" compute distance of vector i to current query"""
+        return _swigfaiss.DistanceComputer___call__(self, i)
+
+    def distances_batch_4(self, idx0, idx1, idx2, idx3, dis0, dis1, dis2, dis3):
+        r"""
+        compute distances of current query to 4 stored vectors.
+        certain DistanceComputer implementations may benefit
+        heavily from this.
+        """
+        return _swigfaiss.DistanceComputer_distances_batch_4(self, idx0, idx1, idx2, idx3, dis0, dis1, dis2, dis3)
+
+    def symmetric_dis(self, i, j):
+        r""" compute distance between two stored vectors"""
+        return _swigfaiss.DistanceComputer_symmetric_dis(self, i, j)
+    __swig_destroy__ = _swigfaiss.delete_DistanceComputer
+
+# Register DistanceComputer in _swigfaiss:
+_swigfaiss.DistanceComputer_swigregister(DistanceComputer)
+class FlatCodesDistanceComputer(DistanceComputer):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    codes = property(_swigfaiss.FlatCodesDistanceComputer_codes_get, _swigfaiss.FlatCodesDistanceComputer_codes_set)
+    code_size = property(_swigfaiss.FlatCodesDistanceComputer_code_size_get, _swigfaiss.FlatCodesDistanceComputer_code_size_set)
+
+    def __call__(self, i):
+        return _swigfaiss.FlatCodesDistanceComputer___call__(self, i)
+
+    def distance_to_code(self, code):
+        r""" compute distance of current query to an encoded vector"""
+        return _swigfaiss.FlatCodesDistanceComputer_distance_to_code(self, code)
+    __swig_destroy__ = _swigfaiss.delete_FlatCodesDistanceComputer
+
+# Register FlatCodesDistanceComputer in _swigfaiss:
+_swigfaiss.FlatCodesDistanceComputer_swigregister(FlatCodesDistanceComputer)
+class IndexFlatCodes(Index):
+    r"""
+     Index that encodes all vectors as fixed-size codes (size code_size). Storage
+    is in the codes vector
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    code_size = property(_swigfaiss.IndexFlatCodes_code_size_get, _swigfaiss.IndexFlatCodes_code_size_set)
+    codes = property(_swigfaiss.IndexFlatCodes_codes_get, _swigfaiss.IndexFlatCodes_codes_set, doc=r""" encoded dataset, size ntotal * code_size""")
+
+    def add(self, n, x):
+        r""" default add uses sa_encode"""
+        return _swigfaiss.IndexFlatCodes_add(self, n, x)
+
+    def reset(self):
+        return _swigfaiss.IndexFlatCodes_reset(self)
+
+    def reconstruct_n(self, i0, ni, recons):
+        return _swigfaiss.IndexFlatCodes_reconstruct_n(self, i0, ni, recons)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexFlatCodes_reconstruct(self, key, recons)
+
+    def sa_code_size(self):
+        return _swigfaiss.IndexFlatCodes_sa_code_size(self)
+
+    def remove_ids(self, sel):
+        r"""
+         remove some ids. NB that because of the structure of the
+        index, the semantics of this operation are
+        different from the usual ones: the new ids are shifted
+        """
+        return _swigfaiss.IndexFlatCodes_remove_ids(self, sel)
+
+    def get_FlatCodesDistanceComputer(self):
+        r""" a FlatCodesDistanceComputer offers a distance_to_code method"""
+        return _swigfaiss.IndexFlatCodes_get_FlatCodesDistanceComputer(self)
+
+    def get_distance_computer(self):
+        return _swigfaiss.IndexFlatCodes_get_distance_computer(self)
+
+    def get_CodePacker(self):
+        return _swigfaiss.IndexFlatCodes_get_CodePacker(self)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss.IndexFlatCodes_check_compatible_for_merge(self, otherIndex)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss.IndexFlatCodes_merge_from(self, otherIndex, add_id)
+
+    def permute_entries(self, perm):
+        return _swigfaiss.IndexFlatCodes_permute_entries(self, perm)
+    __swig_destroy__ = _swigfaiss.delete_IndexFlatCodes
+
+# Register IndexFlatCodes in _swigfaiss:
+_swigfaiss.IndexFlatCodes_swigregister(IndexFlatCodes)
+class IndexFlat(IndexFlatCodes):
+    r""" Index that stores the full vectors and performs exhaustive search"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexFlat_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss.IndexFlat_range_search(self, n, x, radius, result, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexFlat_reconstruct(self, key, recons)
+
+    def compute_distance_subset(self, n, x, k, distances, labels):
+        r"""
+         compute distance with a subset of vectors
+
+        :type x: float
+        :param x:       query vectors, size n * d
+        :type labels: int
+        :param labels:  indices of the vectors that should be compared
+                           for each query vector, size n * k
+        :type distances: float
+        :param distances:
+                           corresponding output distances, size n * k
+        """
+        return _swigfaiss.IndexFlat_compute_distance_subset(self, n, x, k, distances, labels)
+
+    def get_xb(self, *args):
+        return _swigfaiss.IndexFlat_get_xb(self, *args)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexFlat_swiginit(self, _swigfaiss.new_IndexFlat(*args))
+
+    def get_FlatCodesDistanceComputer(self):
+        return _swigfaiss.IndexFlat_get_FlatCodesDistanceComputer(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss.IndexFlat_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexFlat_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexFlat
+
+# Register IndexFlat in _swigfaiss:
+_swigfaiss.IndexFlat_swigregister(IndexFlat)
+class IndexFlatIP(IndexFlat):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.IndexFlatIP_swiginit(self, _swigfaiss.new_IndexFlatIP(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexFlatIP
+
+# Register IndexFlatIP in _swigfaiss:
+_swigfaiss.IndexFlatIP_swigregister(IndexFlatIP)
+class IndexFlatL2(IndexFlat):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    cached_l2norms = property(_swigfaiss.IndexFlatL2_cached_l2norms_get, _swigfaiss.IndexFlatL2_cached_l2norms_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexFlatL2_swiginit(self, _swigfaiss.new_IndexFlatL2(*args))
+
+    def get_FlatCodesDistanceComputer(self):
+        return _swigfaiss.IndexFlatL2_get_FlatCodesDistanceComputer(self)
+
+    def sync_l2norms(self):
+        return _swigfaiss.IndexFlatL2_sync_l2norms(self)
+
+    def clear_l2norms(self):
+        return _swigfaiss.IndexFlatL2_clear_l2norms(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexFlatL2
+
+# Register IndexFlatL2 in _swigfaiss:
+_swigfaiss.IndexFlatL2_swigregister(IndexFlatL2)
+class IndexFlat1D(IndexFlatL2):
+    r""" optimized version for 1D "vectors"."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    continuous_update = property(_swigfaiss.IndexFlat1D_continuous_update_get, _swigfaiss.IndexFlat1D_continuous_update_set, doc=r""" is the permutation updated continuously?""")
+    perm = property(_swigfaiss.IndexFlat1D_perm_get, _swigfaiss.IndexFlat1D_perm_set, doc=r""" sorted database indices""")
+
+    def __init__(self, continuous_update=True):
+        _swigfaiss.IndexFlat1D_swiginit(self, _swigfaiss.new_IndexFlat1D(continuous_update))
+
+    def update_permutation(self):
+        r"""
+        if not continuous_update, call this between the last add and
+        the first search
+        """
+        return _swigfaiss.IndexFlat1D_update_permutation(self)
+
+    def add(self, n, x):
+        return _swigfaiss.IndexFlat1D_add(self, n, x)
+
+    def reset(self):
+        return _swigfaiss.IndexFlat1D_reset(self)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" Warn: the distances returned are L1 not L2"""
+        return _swigfaiss.IndexFlat1D_search(self, n, x, k, distances, labels, params)
+    __swig_destroy__ = _swigfaiss.delete_IndexFlat1D
+
+# Register IndexFlat1D in _swigfaiss:
+_swigfaiss.IndexFlat1D_swigregister(IndexFlat1D)
+class ClusteringParameters(object):
+    r"""
+     Class for the clustering parameters. Can be passed to the
+    constructor of the Clustering object.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    niter = property(_swigfaiss.ClusteringParameters_niter_get, _swigfaiss.ClusteringParameters_niter_set, doc=r""" number of clustering iterations""")
+    nredo = property(_swigfaiss.ClusteringParameters_nredo_get, _swigfaiss.ClusteringParameters_nredo_set, doc=r"""
+    redo clustering this many times and keep the clusters with the best
+    objective
+    """)
+    verbose = property(_swigfaiss.ClusteringParameters_verbose_get, _swigfaiss.ClusteringParameters_verbose_set)
+    spherical = property(_swigfaiss.ClusteringParameters_spherical_get, _swigfaiss.ClusteringParameters_spherical_set, doc=r"""
+    whether to normalize centroids after each iteration (useful for inner
+    product clustering)
+    """)
+    int_centroids = property(_swigfaiss.ClusteringParameters_int_centroids_get, _swigfaiss.ClusteringParameters_int_centroids_set, doc=r""" round centroids coordinates to integer after each iteration?""")
+    update_index = property(_swigfaiss.ClusteringParameters_update_index_get, _swigfaiss.ClusteringParameters_update_index_set, doc=r""" re-train index after each iteration?""")
+    frozen_centroids = property(_swigfaiss.ClusteringParameters_frozen_centroids_get, _swigfaiss.ClusteringParameters_frozen_centroids_set, doc=r"""
+    Use the subset of centroids provided as input and do not change them
+    during iterations
+    """)
+    min_points_per_centroid = property(_swigfaiss.ClusteringParameters_min_points_per_centroid_get, _swigfaiss.ClusteringParameters_min_points_per_centroid_set, doc=r"""
+    If fewer than this number of training vectors per centroid are provided,
+    writes a warning. Note that fewer than 1 point per centroid raises an
+    exception.
+    """)
+    max_points_per_centroid = property(_swigfaiss.ClusteringParameters_max_points_per_centroid_get, _swigfaiss.ClusteringParameters_max_points_per_centroid_set, doc=r""" to limit size of dataset, otherwise the training set is subsampled""")
+    seed = property(_swigfaiss.ClusteringParameters_seed_get, _swigfaiss.ClusteringParameters_seed_set, doc=r""" seed for the random number generator""")
+    decode_block_size = property(_swigfaiss.ClusteringParameters_decode_block_size_get, _swigfaiss.ClusteringParameters_decode_block_size_set, doc=r""" when the training set is encoded, batch size of the codec decoder""")
+
+    def __init__(self):
+        _swigfaiss.ClusteringParameters_swiginit(self, _swigfaiss.new_ClusteringParameters())
+    __swig_destroy__ = _swigfaiss.delete_ClusteringParameters
+
+# Register ClusteringParameters in _swigfaiss:
+_swigfaiss.ClusteringParameters_swigregister(ClusteringParameters)
+class ClusteringIterationStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    obj = property(_swigfaiss.ClusteringIterationStats_obj_get, _swigfaiss.ClusteringIterationStats_obj_set, doc=r""" objective values (sum of distances reported by index)""")
+    time = property(_swigfaiss.ClusteringIterationStats_time_get, _swigfaiss.ClusteringIterationStats_time_set, doc=r""" seconds for iteration""")
+    time_search = property(_swigfaiss.ClusteringIterationStats_time_search_get, _swigfaiss.ClusteringIterationStats_time_search_set, doc=r""" seconds for just search""")
+    imbalance_factor = property(_swigfaiss.ClusteringIterationStats_imbalance_factor_get, _swigfaiss.ClusteringIterationStats_imbalance_factor_set, doc=r""" imbalance factor of iteration""")
+    nsplit = property(_swigfaiss.ClusteringIterationStats_nsplit_get, _swigfaiss.ClusteringIterationStats_nsplit_set, doc=r""" number of cluster splits""")
+
+    def __init__(self):
+        _swigfaiss.ClusteringIterationStats_swiginit(self, _swigfaiss.new_ClusteringIterationStats())
+    __swig_destroy__ = _swigfaiss.delete_ClusteringIterationStats
+
+# Register ClusteringIterationStats in _swigfaiss:
+_swigfaiss.ClusteringIterationStats_swigregister(ClusteringIterationStats)
+class Clustering(ClusteringParameters):
+    r"""
+     K-means clustering based on assignment - centroid update iterations
+
+    The clustering is based on an Index object that assigns training
+    points to the centroids. Therefore, at each iteration the centroids
+    are added to the index.
+
+    On output, the centoids table is set to the latest version
+    of the centroids and they are also added to the index. If the
+    centroids table it is not empty on input, it is also used for
+    initialization.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    d = property(_swigfaiss.Clustering_d_get, _swigfaiss.Clustering_d_set, doc=r""" dimension of the vectors""")
+    k = property(_swigfaiss.Clustering_k_get, _swigfaiss.Clustering_k_set, doc=r""" nb of centroids""")
+    centroids = property(_swigfaiss.Clustering_centroids_get, _swigfaiss.Clustering_centroids_set, doc=r"""
+     centroids (k * d)
+    if centroids are set on input to train, they will be used as
+    initialization
+    """)
+    iteration_stats = property(_swigfaiss.Clustering_iteration_stats_get, _swigfaiss.Clustering_iteration_stats_set, doc=r""" stats at every iteration of clustering""")
+
+    def __init__(self, *args):
+        _swigfaiss.Clustering_swiginit(self, _swigfaiss.new_Clustering(*args))
+
+    def train(self, n, x, index, x_weights=None):
+        r"""
+         run k-means training
+
+        :type x: float
+        :param x:          training vectors, size n * d
+        :type index: :py:class:`Index`
+        :param index:      index used for assignment
+        :type x_weights: float, optional
+        :param x_weights:  weight associated to each vector: NULL or size n
+        """
+        return _swigfaiss.Clustering_train(self, n, x, index, x_weights)
+
+    def train_encoded(self, nx, x_in, codec, index, weights=None):
+        r"""
+         run with encoded vectors
+
+        win addition to train()'s parameters takes a codec as parameter
+        to decode the input vectors.
+
+        :type codec: :py:class:`Index`
+        :param codec:      codec used to decode the vectors (nullptr =
+                              vectors are in fact floats)
+        """
+        return _swigfaiss.Clustering_train_encoded(self, nx, x_in, codec, index, weights)
+
+    def post_process_centroids(self):
+        r"""
+        Post-process the centroids after each centroid update.
+        includes optional L2 normalization and nearest integer rounding
+        """
+        return _swigfaiss.Clustering_post_process_centroids(self)
+    __swig_destroy__ = _swigfaiss.delete_Clustering
+
+# Register Clustering in _swigfaiss:
+_swigfaiss.Clustering_swigregister(Clustering)
+class Clustering1D(Clustering):
+    r"""
+     Exact 1D clustering algorithm
+
+    Since it does not use an index, it does not overload the train() function
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.Clustering1D_swiginit(self, _swigfaiss.new_Clustering1D(*args))
+
+    def train_exact(self, n, x):
+        return _swigfaiss.Clustering1D_train_exact(self, n, x)
+    __swig_destroy__ = _swigfaiss.delete_Clustering1D
+
+# Register Clustering1D in _swigfaiss:
+_swigfaiss.Clustering1D_swigregister(Clustering1D)
+class ProgressiveDimClusteringParameters(ClusteringParameters):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    progressive_dim_steps = property(_swigfaiss.ProgressiveDimClusteringParameters_progressive_dim_steps_get, _swigfaiss.ProgressiveDimClusteringParameters_progressive_dim_steps_set, doc=r""" number of incremental steps""")
+    apply_pca = property(_swigfaiss.ProgressiveDimClusteringParameters_apply_pca_get, _swigfaiss.ProgressiveDimClusteringParameters_apply_pca_set, doc=r""" apply PCA on input""")
+
+    def __init__(self):
+        _swigfaiss.ProgressiveDimClusteringParameters_swiginit(self, _swigfaiss.new_ProgressiveDimClusteringParameters())
+    __swig_destroy__ = _swigfaiss.delete_ProgressiveDimClusteringParameters
+
+# Register ProgressiveDimClusteringParameters in _swigfaiss:
+_swigfaiss.ProgressiveDimClusteringParameters_swigregister(ProgressiveDimClusteringParameters)
+class ProgressiveDimIndexFactory(object):
+    r""" generates an index suitable for clustering when called"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __call__(self, dim):
+        r""" ownership transferred to caller"""
+        return _swigfaiss.ProgressiveDimIndexFactory___call__(self, dim)
+    __swig_destroy__ = _swigfaiss.delete_ProgressiveDimIndexFactory
+
+    def __init__(self):
+        _swigfaiss.ProgressiveDimIndexFactory_swiginit(self, _swigfaiss.new_ProgressiveDimIndexFactory())
+
+# Register ProgressiveDimIndexFactory in _swigfaiss:
+_swigfaiss.ProgressiveDimIndexFactory_swigregister(ProgressiveDimIndexFactory)
+class ProgressiveDimClustering(ProgressiveDimClusteringParameters):
+    r"""
+     K-means clustering with progressive dimensions used
+
+    The clustering first happens in dim 1, then with exponentially increasing
+    dimension until d (I steps). This is typically applied after a PCA
+    transformation (optional). Reference:
+
+    "Improved Residual Vector Quantization for High-dimensional Approximate
+    Nearest Neighbor Search"
+
+    Shicong Liu, Hongtao Lu, Junru Shao, AAAI'15
+
+    https://arxiv.org/abs/1509.05195
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    d = property(_swigfaiss.ProgressiveDimClustering_d_get, _swigfaiss.ProgressiveDimClustering_d_set, doc=r""" dimension of the vectors""")
+    k = property(_swigfaiss.ProgressiveDimClustering_k_get, _swigfaiss.ProgressiveDimClustering_k_set, doc=r""" nb of centroids""")
+    centroids = property(_swigfaiss.ProgressiveDimClustering_centroids_get, _swigfaiss.ProgressiveDimClustering_centroids_set, doc=r""" centroids (k * d)""")
+    iteration_stats = property(_swigfaiss.ProgressiveDimClustering_iteration_stats_get, _swigfaiss.ProgressiveDimClustering_iteration_stats_set, doc=r""" stats at every iteration of clustering""")
+
+    def __init__(self, *args):
+        _swigfaiss.ProgressiveDimClustering_swiginit(self, _swigfaiss.new_ProgressiveDimClustering(*args))
+
+    def train(self, n, x, factory):
+        return _swigfaiss.ProgressiveDimClustering_train(self, n, x, factory)
+    __swig_destroy__ = _swigfaiss.delete_ProgressiveDimClustering
+
+# Register ProgressiveDimClustering in _swigfaiss:
+_swigfaiss.ProgressiveDimClustering_swigregister(ProgressiveDimClustering)
+
+def kmeans_clustering(d, n, k, x, centroids):
+    r"""
+     simplified interface
+
+    :type d: int
+    :param d: dimension of the data
+    :type n: int
+    :param n: nb of training vectors
+    :type k: int
+    :param k: nb of output centroids
+    :type x: float
+    :param x: training set (size n * d)
+    :type centroids: float
+    :param centroids: output centroids (size k * d)
+    :rtype: float
+    :return: final quantization error
+    """
+    return _swigfaiss.kmeans_clustering(d, n, k, x, centroids)
+
+def pairwise_extra_distances(d, nq, xq, nb, xb, mt, metric_arg, dis, ldq=-1, ldb=-1, ldd=-1):
+    return _swigfaiss.pairwise_extra_distances(d, nq, xq, nb, xb, mt, metric_arg, dis, ldq, ldb, ldd)
+
+def get_extra_distance_computer(d, mt, metric_arg, nb, xb):
+    r"""
+    get a DistanceComputer that refers to this type of distance and
+    indexes a flat array of size nb
+    """
+    return _swigfaiss.get_extra_distance_computer(d, mt, metric_arg, nb, xb)
+class Quantizer(object):
+    r""" General interface for quantizer objects"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    d = property(_swigfaiss.Quantizer_d_get, _swigfaiss.Quantizer_d_set, doc=r""" size of the input vectors""")
+    code_size = property(_swigfaiss.Quantizer_code_size_get, _swigfaiss.Quantizer_code_size_set, doc=r""" bytes per indexed vector""")
+
+    def train(self, n, x):
+        r"""
+         Train the quantizer
+
+        :type x: float
+        :param x:       training vectors, size n * d
+        """
+        return _swigfaiss.Quantizer_train(self, n, x)
+
+    def compute_codes(self, x, codes, n):
+        r"""
+         Quantize a set of vectors
+
+        :type x: float
+        :param x:        input vectors, size n * d
+        :type codes: uint8_t
+        :param codes:    output codes, size n * code_size
+        """
+        return _swigfaiss.Quantizer_compute_codes(self, x, codes, n)
+
+    def decode(self, code, x, n):
+        r"""
+         Decode a set of vectors
+
+        :param codes:    input codes, size n * code_size
+        :type x: float
+        :param x:        output vectors, size n * d
+        """
+        return _swigfaiss.Quantizer_decode(self, code, x, n)
+    __swig_destroy__ = _swigfaiss.delete_Quantizer
+
+# Register Quantizer in _swigfaiss:
+_swigfaiss.Quantizer_swigregister(Quantizer)
+class ProductQuantizer(Quantizer):
+    r""" Product Quantizer. Implemented only for METRIC_L2"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    M = property(_swigfaiss.ProductQuantizer_M_get, _swigfaiss.ProductQuantizer_M_set, doc=r""" number of subquantizers""")
+    nbits = property(_swigfaiss.ProductQuantizer_nbits_get, _swigfaiss.ProductQuantizer_nbits_set, doc=r""" number of bits per quantization index""")
+    dsub = property(_swigfaiss.ProductQuantizer_dsub_get, _swigfaiss.ProductQuantizer_dsub_set, doc=r""" dimensionality of each subvector""")
+    ksub = property(_swigfaiss.ProductQuantizer_ksub_get, _swigfaiss.ProductQuantizer_ksub_set, doc=r""" number of centroids for each subquantizer""")
+    verbose = property(_swigfaiss.ProductQuantizer_verbose_get, _swigfaiss.ProductQuantizer_verbose_set, doc=r""" verbose during training?""")
+    Train_default = _swigfaiss.ProductQuantizer_Train_default
+    Train_hot_start = _swigfaiss.ProductQuantizer_Train_hot_start
+    r""" the centroids are already initialized"""
+    Train_shared = _swigfaiss.ProductQuantizer_Train_shared
+    r""" share dictionary across PQ segments"""
+    Train_hypercube = _swigfaiss.ProductQuantizer_Train_hypercube
+    r""" initialize centroids with nbits-D hypercube"""
+    Train_hypercube_pca = _swigfaiss.ProductQuantizer_Train_hypercube_pca
+    r""" initialize centroids with nbits-D hypercube"""
+    train_type = property(_swigfaiss.ProductQuantizer_train_type_get, _swigfaiss.ProductQuantizer_train_type_set)
+    cp = property(_swigfaiss.ProductQuantizer_cp_get, _swigfaiss.ProductQuantizer_cp_set, doc=r""" parameters used during clustering""")
+    assign_index = property(_swigfaiss.ProductQuantizer_assign_index_get, _swigfaiss.ProductQuantizer_assign_index_set, doc=r"""
+    if non-NULL, use this index for assignment (should be of size
+    d / M)
+    """)
+    centroids = property(_swigfaiss.ProductQuantizer_centroids_get, _swigfaiss.ProductQuantizer_centroids_set, doc=r"""
+    Centroid table, size M * ksub * dsub.
+    Layout: (M, ksub, dsub)
+    """)
+    transposed_centroids = property(_swigfaiss.ProductQuantizer_transposed_centroids_get, _swigfaiss.ProductQuantizer_transposed_centroids_set, doc=r"""
+    Transposed centroid table, size M * ksub * dsub.
+    Layout: (dsub, M, ksub)
+    """)
+    centroids_sq_lengths = property(_swigfaiss.ProductQuantizer_centroids_sq_lengths_get, _swigfaiss.ProductQuantizer_centroids_sq_lengths_set, doc=r"""
+    Squared lengths of centroids, size M * ksub
+    Layout: (M, ksub)
+    """)
+
+    def get_centroids(self, m, i):
+        r""" return the centroids associated with subvector m"""
+        return _swigfaiss.ProductQuantizer_get_centroids(self, m, i)
+
+    def train(self, n, x):
+        return _swigfaiss.ProductQuantizer_train(self, n, x)
+
+    def __init__(self, *args):
+        _swigfaiss.ProductQuantizer_swiginit(self, _swigfaiss.new_ProductQuantizer(*args))
+
+    def set_derived_values(self):
+        r""" compute derived values when d, M and nbits have been set"""
+        return _swigfaiss.ProductQuantizer_set_derived_values(self)
+
+    def set_params(self, centroids, m):
+        r""" Define the centroids for subquantizer m"""
+        return _swigfaiss.ProductQuantizer_set_params(self, centroids, m)
+
+    def compute_code(self, x, code):
+        r""" Quantize one vector with the product quantizer"""
+        return _swigfaiss.ProductQuantizer_compute_code(self, x, code)
+
+    def compute_codes(self, x, codes, n):
+        r""" same as compute_code for several vectors"""
+        return _swigfaiss.ProductQuantizer_compute_codes(self, x, codes, n)
+
+    def compute_codes_with_assign_index(self, x, codes, n):
+        r"""
+        speed up code assignment using assign_index
+        (non-const because the index is changed)
+        """
+        return _swigfaiss.ProductQuantizer_compute_codes_with_assign_index(self, x, codes, n)
+
+    def decode(self, *args):
+        return _swigfaiss.ProductQuantizer_decode(self, *args)
+
+    def compute_code_from_distance_table(self, tab, code):
+        r"""
+        If we happen to have the distance tables precomputed, this is
+        more efficient to compute the codes.
+        """
+        return _swigfaiss.ProductQuantizer_compute_code_from_distance_table(self, tab, code)
+
+    def compute_distance_table(self, x, dis_table):
+        r"""
+         Compute distance table for one vector.
+
+        The distance table for x = [x_0 x_1 .. x_(M-1)] is a M * ksub
+        matrix that contains
+
+          dis_table (m, j) = || x_m - c_(m, j)||^2
+          for m = 0..M-1 and j = 0 .. ksub - 1
+
+        where c_(m, j) is the centroid no j of sub-quantizer m.
+
+        :type x: float
+        :param x:         input vector size d
+        :type dis_table: float
+        :param dis_table: output table, size M * ksub
+        """
+        return _swigfaiss.ProductQuantizer_compute_distance_table(self, x, dis_table)
+
+    def compute_inner_prod_table(self, x, dis_table):
+        return _swigfaiss.ProductQuantizer_compute_inner_prod_table(self, x, dis_table)
+
+    def compute_distance_tables(self, nx, x, dis_tables):
+        r"""
+         compute distance table for several vectors
+        :type nx: int
+        :param nx:        nb of input vectors
+        :type x: float
+        :param x:         input vector size nx * d
+        :param dis_table: output table, size nx * M * ksub
+        """
+        return _swigfaiss.ProductQuantizer_compute_distance_tables(self, nx, x, dis_tables)
+
+    def compute_inner_prod_tables(self, nx, x, dis_tables):
+        return _swigfaiss.ProductQuantizer_compute_inner_prod_tables(self, nx, x, dis_tables)
+
+    def search(self, x, nx, codes, ncodes, res, init_finalize_heap=True):
+        r"""
+         perform a search (L2 distance)
+        :type x: float
+        :param x:        query vectors, size nx * d
+        :type nx: int
+        :param nx:       nb of queries
+        :type codes: uint8_t
+        :param codes:    database codes, size ncodes * code_size
+        :type ncodes: int
+        :param ncodes:   nb of nb vectors
+        :type res: :py:class:`float_maxheap_array_t`
+        :param res:      heap array to store results (nh == nx)
+        :type init_finalize_heap: boolean, optional
+        :param init_finalize_heap:  initialize heap (input) and sort (output)?
+        """
+        return _swigfaiss.ProductQuantizer_search(self, x, nx, codes, ncodes, res, init_finalize_heap)
+
+    def search_ip(self, x, nx, codes, ncodes, res, init_finalize_heap=True):
+        r""" same as search, but with inner product similarity"""
+        return _swigfaiss.ProductQuantizer_search_ip(self, x, nx, codes, ncodes, res, init_finalize_heap)
+    sdc_table = property(_swigfaiss.ProductQuantizer_sdc_table_get, _swigfaiss.ProductQuantizer_sdc_table_set, doc=r""" Symmetric Distance Table""")
+
+    def compute_sdc_table(self):
+        return _swigfaiss.ProductQuantizer_compute_sdc_table(self)
+
+    def search_sdc(self, qcodes, nq, bcodes, ncodes, res, init_finalize_heap=True):
+        return _swigfaiss.ProductQuantizer_search_sdc(self, qcodes, nq, bcodes, ncodes, res, init_finalize_heap)
+
+    def sync_transposed_centroids(self):
+        r"""
+        Sync transposed centroids with regular centroids. This call
+        is needed if centroids were edited directly.
+        """
+        return _swigfaiss.ProductQuantizer_sync_transposed_centroids(self)
+
+    def clear_transposed_centroids(self):
+        r""" Clear transposed centroids table so ones are no longer used."""
+        return _swigfaiss.ProductQuantizer_clear_transposed_centroids(self)
+    __swig_destroy__ = _swigfaiss.delete_ProductQuantizer
+
+# Register ProductQuantizer in _swigfaiss:
+_swigfaiss.ProductQuantizer_swigregister(ProductQuantizer)
+class PQEncoderGeneric(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code = property(_swigfaiss.PQEncoderGeneric_code_get, _swigfaiss.PQEncoderGeneric_code_set, doc=r""" code for this vector""")
+    offset = property(_swigfaiss.PQEncoderGeneric_offset_get, _swigfaiss.PQEncoderGeneric_offset_set)
+    nbits = property(_swigfaiss.PQEncoderGeneric_nbits_get, doc=r""" number of bits per subquantizer index""")
+    reg = property(_swigfaiss.PQEncoderGeneric_reg_get, _swigfaiss.PQEncoderGeneric_reg_set)
+
+    def __init__(self, code, nbits, offset=0):
+        _swigfaiss.PQEncoderGeneric_swiginit(self, _swigfaiss.new_PQEncoderGeneric(code, nbits, offset))
+
+    def encode(self, x):
+        return _swigfaiss.PQEncoderGeneric_encode(self, x)
+    __swig_destroy__ = _swigfaiss.delete_PQEncoderGeneric
+
+# Register PQEncoderGeneric in _swigfaiss:
+_swigfaiss.PQEncoderGeneric_swigregister(PQEncoderGeneric)
+class PQEncoder8(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code = property(_swigfaiss.PQEncoder8_code_get, _swigfaiss.PQEncoder8_code_set)
+
+    def __init__(self, code, nbits):
+        _swigfaiss.PQEncoder8_swiginit(self, _swigfaiss.new_PQEncoder8(code, nbits))
+
+    def encode(self, x):
+        return _swigfaiss.PQEncoder8_encode(self, x)
+    __swig_destroy__ = _swigfaiss.delete_PQEncoder8
+
+# Register PQEncoder8 in _swigfaiss:
+_swigfaiss.PQEncoder8_swigregister(PQEncoder8)
+class PQEncoder16(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code = property(_swigfaiss.PQEncoder16_code_get, _swigfaiss.PQEncoder16_code_set)
+
+    def __init__(self, code, nbits):
+        _swigfaiss.PQEncoder16_swiginit(self, _swigfaiss.new_PQEncoder16(code, nbits))
+
+    def encode(self, x):
+        return _swigfaiss.PQEncoder16_encode(self, x)
+    __swig_destroy__ = _swigfaiss.delete_PQEncoder16
+
+# Register PQEncoder16 in _swigfaiss:
+_swigfaiss.PQEncoder16_swigregister(PQEncoder16)
+class PQDecoderGeneric(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code = property(_swigfaiss.PQDecoderGeneric_code_get, _swigfaiss.PQDecoderGeneric_code_set)
+    offset = property(_swigfaiss.PQDecoderGeneric_offset_get, _swigfaiss.PQDecoderGeneric_offset_set)
+    nbits = property(_swigfaiss.PQDecoderGeneric_nbits_get)
+    mask = property(_swigfaiss.PQDecoderGeneric_mask_get)
+    reg = property(_swigfaiss.PQDecoderGeneric_reg_get, _swigfaiss.PQDecoderGeneric_reg_set)
+
+    def __init__(self, code, nbits):
+        _swigfaiss.PQDecoderGeneric_swiginit(self, _swigfaiss.new_PQDecoderGeneric(code, nbits))
+
+    def decode(self):
+        return _swigfaiss.PQDecoderGeneric_decode(self)
+    __swig_destroy__ = _swigfaiss.delete_PQDecoderGeneric
+
+# Register PQDecoderGeneric in _swigfaiss:
+_swigfaiss.PQDecoderGeneric_swigregister(PQDecoderGeneric)
+class PQDecoder8(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nbits = _swigfaiss.PQDecoder8_nbits
+    code = property(_swigfaiss.PQDecoder8_code_get, _swigfaiss.PQDecoder8_code_set)
+
+    def __init__(self, code, nbits):
+        _swigfaiss.PQDecoder8_swiginit(self, _swigfaiss.new_PQDecoder8(code, nbits))
+
+    def decode(self):
+        return _swigfaiss.PQDecoder8_decode(self)
+    __swig_destroy__ = _swigfaiss.delete_PQDecoder8
+
+# Register PQDecoder8 in _swigfaiss:
+_swigfaiss.PQDecoder8_swigregister(PQDecoder8)
+class PQDecoder16(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nbits = _swigfaiss.PQDecoder16_nbits
+    code = property(_swigfaiss.PQDecoder16_code_get, _swigfaiss.PQDecoder16_code_set)
+
+    def __init__(self, code, nbits):
+        _swigfaiss.PQDecoder16_swiginit(self, _swigfaiss.new_PQDecoder16(code, nbits))
+
+    def decode(self):
+        return _swigfaiss.PQDecoder16_decode(self)
+    __swig_destroy__ = _swigfaiss.delete_PQDecoder16
+
+# Register PQDecoder16 in _swigfaiss:
+_swigfaiss.PQDecoder16_swigregister(PQDecoder16)
+class AdditiveQuantizer(Quantizer):
+    r"""
+     Abstract structure for additive quantizers
+
+    Different from the product quantizer in which the decoded vector is the
+    concatenation of M sub-vectors, additive quantizers sum M sub-vectors
+    to get the decoded vector.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    M = property(_swigfaiss.AdditiveQuantizer_M_get, _swigfaiss.AdditiveQuantizer_M_set, doc=r""" number of codebooks""")
+    nbits = property(_swigfaiss.AdditiveQuantizer_nbits_get, _swigfaiss.AdditiveQuantizer_nbits_set, doc=r""" bits for each step""")
+    codebooks = property(_swigfaiss.AdditiveQuantizer_codebooks_get, _swigfaiss.AdditiveQuantizer_codebooks_set, doc=r""" codebooks""")
+    codebook_offsets = property(_swigfaiss.AdditiveQuantizer_codebook_offsets_get, _swigfaiss.AdditiveQuantizer_codebook_offsets_set)
+    tot_bits = property(_swigfaiss.AdditiveQuantizer_tot_bits_get, _swigfaiss.AdditiveQuantizer_tot_bits_set, doc=r""" total number of bits (indexes + norms)""")
+    norm_bits = property(_swigfaiss.AdditiveQuantizer_norm_bits_get, _swigfaiss.AdditiveQuantizer_norm_bits_set, doc=r""" bits allocated for the norms""")
+    total_codebook_size = property(_swigfaiss.AdditiveQuantizer_total_codebook_size_get, _swigfaiss.AdditiveQuantizer_total_codebook_size_set, doc=r""" size of the codebook in vectors""")
+    only_8bit = property(_swigfaiss.AdditiveQuantizer_only_8bit_get, _swigfaiss.AdditiveQuantizer_only_8bit_set, doc=r""" are all nbits = 8 (use faster decoder)""")
+    verbose = property(_swigfaiss.AdditiveQuantizer_verbose_get, _swigfaiss.AdditiveQuantizer_verbose_set, doc=r""" verbose during training?""")
+    is_trained = property(_swigfaiss.AdditiveQuantizer_is_trained_get, _swigfaiss.AdditiveQuantizer_is_trained_set, doc=r""" is trained or not""")
+    qnorm = property(_swigfaiss.AdditiveQuantizer_qnorm_get, _swigfaiss.AdditiveQuantizer_qnorm_set, doc=r""" store and search norms""")
+    norm_tabs = property(_swigfaiss.AdditiveQuantizer_norm_tabs_get, _swigfaiss.AdditiveQuantizer_norm_tabs_set, doc=r"""
+    store norms of codebook entries for 4-bit
+    fastscan search
+    """)
+    max_mem_distances = property(_swigfaiss.AdditiveQuantizer_max_mem_distances_get, _swigfaiss.AdditiveQuantizer_max_mem_distances_set, doc=r"""
+    norms and distance matrixes with beam search can get large, so use this
+    to control for the amount of memory that can be allocated
+    """)
+
+    def encode_norm(self, norm):
+        r""" encode a norm into norm_bits bits"""
+        return _swigfaiss.AdditiveQuantizer_encode_norm(self, norm)
+
+    def encode_qcint(self, x):
+        r""" encode norm by non-uniform scalar quantization"""
+        return _swigfaiss.AdditiveQuantizer_encode_qcint(self, x)
+
+    def decode_qcint(self, c):
+        r""" decode norm by non-uniform scalar quantization"""
+        return _swigfaiss.AdditiveQuantizer_decode_qcint(self, c)
+    ST_decompress = _swigfaiss.AdditiveQuantizer_ST_decompress
+    r""" decompress database vector"""
+    ST_LUT_nonorm = _swigfaiss.AdditiveQuantizer_ST_LUT_nonorm
+    r"""
+    use a LUT, don't include norms (OK for IP or
+    normalized vectors)
+    """
+    ST_norm_from_LUT = _swigfaiss.AdditiveQuantizer_ST_norm_from_LUT
+    r"""
+    compute the norms from the look-up tables (cost
+    is in O(M^2))
+    """
+    ST_norm_float = _swigfaiss.AdditiveQuantizer_ST_norm_float
+    r""" use a LUT, and store float32 norm with the vectors"""
+    ST_norm_qint8 = _swigfaiss.AdditiveQuantizer_ST_norm_qint8
+    r""" use a LUT, and store 8bit-quantized norm"""
+    ST_norm_qint4 = _swigfaiss.AdditiveQuantizer_ST_norm_qint4
+    ST_norm_cqint8 = _swigfaiss.AdditiveQuantizer_ST_norm_cqint8
+    r""" use a LUT, and store non-uniform quantized norm"""
+    ST_norm_cqint4 = _swigfaiss.AdditiveQuantizer_ST_norm_cqint4
+    ST_norm_lsq2x4 = _swigfaiss.AdditiveQuantizer_ST_norm_lsq2x4
+    r"""
+    use a 2x4 bits lsq as norm quantizer (for fast
+    scan)
+    """
+    ST_norm_rq2x4 = _swigfaiss.AdditiveQuantizer_ST_norm_rq2x4
+    r""" use a 2x4 bits rq as norm quantizer (for fast scan)"""
+
+    def set_derived_values(self):
+        r""" Train the norm quantizer"""
+        return _swigfaiss.AdditiveQuantizer_set_derived_values(self)
+
+    def train_norm(self, n, norms):
+        return _swigfaiss.AdditiveQuantizer_train_norm(self, n, norms)
+
+    def compute_codes(self, x, codes, n):
+        return _swigfaiss.AdditiveQuantizer_compute_codes(self, x, codes, n)
+
+    def compute_codes_add_centroids(self, x, codes, n, centroids=None):
+        r"""
+         Encode a set of vectors
+
+        :type x: float
+        :param x:      vectors to encode, size n * d
+        :type codes: uint8_t
+        :param codes:  output codes, size n * code_size
+        :type centroids: float, optional
+        :param centroids:  centroids to be added to x, size n * d
+        """
+        return _swigfaiss.AdditiveQuantizer_compute_codes_add_centroids(self, x, codes, n, centroids)
+
+    def pack_codes(self, n, codes, packed_codes, ld_codes=-1, norms=None, centroids=None):
+        r"""
+         pack a series of code to bit-compact format
+
+        :type codes: int
+        :param codes:        codes to be packed, size n * code_size
+        :type packed_codes: uint8_t
+        :param packed_codes: output bit-compact codes
+        :type ld_codes: int, optional
+        :param ld_codes:     leading dimension of codes
+        :type norms: float, optional
+        :param norms:        norms of the vectors (size n). Will be computed if
+                                needed but not provided
+        :type centroids: float, optional
+        :param centroids:    centroids to be added to x, size n * d
+        """
+        return _swigfaiss.AdditiveQuantizer_pack_codes(self, n, codes, packed_codes, ld_codes, norms, centroids)
+
+    def decode(self, codes, x, n):
+        r"""
+         Decode a set of vectors
+
+        :type codes: uint8_t
+        :param codes:  codes to decode, size n * code_size
+        :type x: float
+        :param x:      output vectors, size n * d
+        """
+        return _swigfaiss.AdditiveQuantizer_decode(self, codes, x, n)
+
+    def decode_unpacked(self, codes, x, n, ld_codes=-1):
+        r"""
+         Decode a set of vectors in non-packed format
+
+        :type codes: int
+        :param codes:  codes to decode, size n * ld_codes
+        :type x: float
+        :param x:      output vectors, size n * d
+        """
+        return _swigfaiss.AdditiveQuantizer_decode_unpacked(self, codes, x, n, ld_codes)
+    search_type = property(_swigfaiss.AdditiveQuantizer_search_type_get, _swigfaiss.AdditiveQuantizer_search_type_set, doc=r""" Also determines what's in the codes""")
+    norm_min = property(_swigfaiss.AdditiveQuantizer_norm_min_get, _swigfaiss.AdditiveQuantizer_norm_min_set, doc=r""" min/max for quantization of norms""")
+    norm_max = property(_swigfaiss.AdditiveQuantizer_norm_max_get, _swigfaiss.AdditiveQuantizer_norm_max_set)
+
+    def decode_64bit(self, n, x):
+        r""" decoding function for a code in a 64-bit word"""
+        return _swigfaiss.AdditiveQuantizer_decode_64bit(self, n, x)
+
+    def compute_LUT(self, n, xq, LUT, alpha=1.0, ld_lut=-1):
+        r"""
+         Compute inner-product look-up tables. Used in the centroid search
+        functions.
+
+        :type xq: float
+        :param xq:     query vector, size (n, d)
+        :type LUT: float
+        :param LUT:    look-up table, size (n, total_codebook_size)
+        :type alpha: float, optional
+        :param alpha:  compute alpha * inner-product
+        :type ld_lut: int, optional
+        :param ld_lut:  leading dimension of LUT
+        """
+        return _swigfaiss.AdditiveQuantizer_compute_LUT(self, n, xq, LUT, alpha, ld_lut)
+
+    def knn_centroids_inner_product(self, n, xq, k, distances, labels):
+        r""" exact IP search"""
+        return _swigfaiss.AdditiveQuantizer_knn_centroids_inner_product(self, n, xq, k, distances, labels)
+
+    def compute_centroid_norms(self, norms):
+        r"""
+         For L2 search we need the L2 norms of the centroids
+
+        :type norms: float
+        :param norms:    output norms table, size total_codebook_size
+        """
+        return _swigfaiss.AdditiveQuantizer_compute_centroid_norms(self, norms)
+
+    def knn_centroids_L2(self, n, xq, k, distances, labels, centroid_norms):
+        r""" Exact L2 search, with precomputed norms"""
+        return _swigfaiss.AdditiveQuantizer_knn_centroids_L2(self, n, xq, k, distances, labels, centroid_norms)
+    __swig_destroy__ = _swigfaiss.delete_AdditiveQuantizer
+
+# Register AdditiveQuantizer in _swigfaiss:
+_swigfaiss.AdditiveQuantizer_swigregister(AdditiveQuantizer)
+
+def beam_search_encode_step(*args):
+    r"""
+     Encode a residual by sampling from a centroid table.
+
+    This is a single encoding step the residual quantizer.
+    It allows low-level access to the encoding function, exposed mainly for unit
+    tests.
+
+    :type n: int
+    :param n:              number of vectors to hanlde
+    :type residuals: float
+    :param residuals:      vectors to encode, size (n, beam_size, d)
+    :type cent: float
+    :param cent:           centroids, size (K, d)
+    :type beam_size: int
+    :param beam_size:      input beam size
+    :type m: int
+    :param m:              size of the codes for the previous encoding steps
+    :type codes: int
+    :param codes:          code array for the previous steps of the beam (n,
+        beam_size, m)
+    :type new_beam_size: int
+    :param new_beam_size:  output beam size (should be <= K * beam_size)
+    :type new_codes: int
+    :param new_codes:      output codes, size (n, new_beam_size, m + 1)
+    :type new_residuals: float
+    :param new_residuals:  output residuals, size (n, new_beam_size, d)
+    :type new_distances: float
+    :param new_distances:  output distances, size (n, new_beam_size)
+    :type assign_index: :py:class:`Index`, optional
+    :param assign_index:   if non-NULL, will be used to perform assignment
+    """
+    return _swigfaiss.beam_search_encode_step(*args)
+
+def beam_search_encode_step_tab(*args):
+    r"""
+     Encode a set of vectors using their dot products with the codebooks
+
+    :type K: int
+    :param K:           number of vectors in the codebook
+    :type n: int
+    :param n:           nb of vectors to encode
+    :type beam_size: int
+    :param beam_size:   input beam size
+    :type codebook_cross_norms: float
+    :param codebook_cross_norms: inner product of this codebook with the m
+                                    previously encoded codebooks
+    :type codebook_offsets: int
+    :param codebook_offsets:     offsets into codebook_cross_norms for each
+                                    previous codebook
+    :type query_cp: float
+    :param query_cp:    dot products of query vectors with ???
+    :type cent_norms_i: float
+    :param cent_norms_i:  norms of centroids
+    """
+    return _swigfaiss.beam_search_encode_step_tab(*args)
+class RefineBeamMemoryPool(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    new_codes = property(_swigfaiss.RefineBeamMemoryPool_new_codes_get, _swigfaiss.RefineBeamMemoryPool_new_codes_set)
+    new_residuals = property(_swigfaiss.RefineBeamMemoryPool_new_residuals_get, _swigfaiss.RefineBeamMemoryPool_new_residuals_set)
+    residuals = property(_swigfaiss.RefineBeamMemoryPool_residuals_get, _swigfaiss.RefineBeamMemoryPool_residuals_set)
+    codes = property(_swigfaiss.RefineBeamMemoryPool_codes_get, _swigfaiss.RefineBeamMemoryPool_codes_set)
+    distances = property(_swigfaiss.RefineBeamMemoryPool_distances_get, _swigfaiss.RefineBeamMemoryPool_distances_set)
+
+    def __init__(self):
+        _swigfaiss.RefineBeamMemoryPool_swiginit(self, _swigfaiss.new_RefineBeamMemoryPool())
+    __swig_destroy__ = _swigfaiss.delete_RefineBeamMemoryPool
+
+# Register RefineBeamMemoryPool in _swigfaiss:
+_swigfaiss.RefineBeamMemoryPool_swigregister(RefineBeamMemoryPool)
+
+def refine_beam_mp(rq, n, beam_size, x, out_beam_size, out_codes, out_residuals, out_distances, pool):
+    return _swigfaiss.refine_beam_mp(rq, n, beam_size, x, out_beam_size, out_codes, out_residuals, out_distances, pool)
+class RefineBeamLUTMemoryPool(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    new_codes = property(_swigfaiss.RefineBeamLUTMemoryPool_new_codes_get, _swigfaiss.RefineBeamLUTMemoryPool_new_codes_set)
+    new_distances = property(_swigfaiss.RefineBeamLUTMemoryPool_new_distances_get, _swigfaiss.RefineBeamLUTMemoryPool_new_distances_set)
+    codes = property(_swigfaiss.RefineBeamLUTMemoryPool_codes_get, _swigfaiss.RefineBeamLUTMemoryPool_codes_set)
+    distances = property(_swigfaiss.RefineBeamLUTMemoryPool_distances_get, _swigfaiss.RefineBeamLUTMemoryPool_distances_set)
+
+    def __init__(self):
+        _swigfaiss.RefineBeamLUTMemoryPool_swiginit(self, _swigfaiss.new_RefineBeamLUTMemoryPool())
+    __swig_destroy__ = _swigfaiss.delete_RefineBeamLUTMemoryPool
+
+# Register RefineBeamLUTMemoryPool in _swigfaiss:
+_swigfaiss.RefineBeamLUTMemoryPool_swigregister(RefineBeamLUTMemoryPool)
+
+def refine_beam_LUT_mp(rq, n, query_norms, query_cp, out_beam_size, out_codes, out_distances, pool):
+    return _swigfaiss.refine_beam_LUT_mp(rq, n, query_norms, query_cp, out_beam_size, out_codes, out_distances, pool)
+class ComputeCodesAddCentroidsLUT0MemoryPool(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    codes = property(_swigfaiss.ComputeCodesAddCentroidsLUT0MemoryPool_codes_get, _swigfaiss.ComputeCodesAddCentroidsLUT0MemoryPool_codes_set)
+    norms = property(_swigfaiss.ComputeCodesAddCentroidsLUT0MemoryPool_norms_get, _swigfaiss.ComputeCodesAddCentroidsLUT0MemoryPool_norms_set)
+    distances = property(_swigfaiss.ComputeCodesAddCentroidsLUT0MemoryPool_distances_get, _swigfaiss.ComputeCodesAddCentroidsLUT0MemoryPool_distances_set)
+    residuals = property(_swigfaiss.ComputeCodesAddCentroidsLUT0MemoryPool_residuals_get, _swigfaiss.ComputeCodesAddCentroidsLUT0MemoryPool_residuals_set)
+    refine_beam_pool = property(_swigfaiss.ComputeCodesAddCentroidsLUT0MemoryPool_refine_beam_pool_get, _swigfaiss.ComputeCodesAddCentroidsLUT0MemoryPool_refine_beam_pool_set)
+
+    def __init__(self):
+        _swigfaiss.ComputeCodesAddCentroidsLUT0MemoryPool_swiginit(self, _swigfaiss.new_ComputeCodesAddCentroidsLUT0MemoryPool())
+    __swig_destroy__ = _swigfaiss.delete_ComputeCodesAddCentroidsLUT0MemoryPool
+
+# Register ComputeCodesAddCentroidsLUT0MemoryPool in _swigfaiss:
+_swigfaiss.ComputeCodesAddCentroidsLUT0MemoryPool_swigregister(ComputeCodesAddCentroidsLUT0MemoryPool)
+
+def compute_codes_add_centroids_mp_lut0(rq, x, codes_out, n, centroids, pool):
+    return _swigfaiss.compute_codes_add_centroids_mp_lut0(rq, x, codes_out, n, centroids, pool)
+class ComputeCodesAddCentroidsLUT1MemoryPool(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    codes = property(_swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_codes_get, _swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_codes_set)
+    distances = property(_swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_distances_get, _swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_distances_set)
+    query_norms = property(_swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_query_norms_get, _swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_query_norms_set)
+    query_cp = property(_swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_query_cp_get, _swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_query_cp_set)
+    residuals = property(_swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_residuals_get, _swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_residuals_set)
+    refine_beam_lut_pool = property(_swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_refine_beam_lut_pool_get, _swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_refine_beam_lut_pool_set)
+
+    def __init__(self):
+        _swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_swiginit(self, _swigfaiss.new_ComputeCodesAddCentroidsLUT1MemoryPool())
+    __swig_destroy__ = _swigfaiss.delete_ComputeCodesAddCentroidsLUT1MemoryPool
+
+# Register ComputeCodesAddCentroidsLUT1MemoryPool in _swigfaiss:
+_swigfaiss.ComputeCodesAddCentroidsLUT1MemoryPool_swigregister(ComputeCodesAddCentroidsLUT1MemoryPool)
+
+def compute_codes_add_centroids_mp_lut1(rq, x, codes_out, n, centroids, pool):
+    return _swigfaiss.compute_codes_add_centroids_mp_lut1(rq, x, codes_out, n, centroids, pool)
+class ResidualQuantizer(AdditiveQuantizer):
+    r"""
+     Residual quantizer with variable number of bits per sub-quantizer
+
+    The residual centroids are stored in a big cumulative centroid table.
+    The codes are represented either as a non-compact table of size (n, M) or
+    as the compact output (n, code_size).
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    train_type = property(_swigfaiss.ResidualQuantizer_train_type_get, _swigfaiss.ResidualQuantizer_train_type_set, doc=r""" Binary or of the Train_* flags below""")
+    Train_default = _swigfaiss.ResidualQuantizer_Train_default
+    r""" regular k-means (minimal amount of computation)"""
+    Train_progressive_dim = _swigfaiss.ResidualQuantizer_Train_progressive_dim
+    r""" progressive dim clustering (set by default)"""
+    Train_refine_codebook = _swigfaiss.ResidualQuantizer_Train_refine_codebook
+    r""" do a few iterations of codebook refinement after first level estimation"""
+    niter_codebook_refine = property(_swigfaiss.ResidualQuantizer_niter_codebook_refine_get, _swigfaiss.ResidualQuantizer_niter_codebook_refine_set, doc=r""" number of iterations for codebook refinement.""")
+    Train_top_beam = _swigfaiss.ResidualQuantizer_Train_top_beam
+    r"""
+    set this bit on train_type if beam is to be trained only on the
+    first element of the beam (faster but less accurate)
+    """
+    Skip_codebook_tables = _swigfaiss.ResidualQuantizer_Skip_codebook_tables
+    r"""
+     set this bit to *not* autmatically compute the codebook tables
+    after training
+    """
+    max_beam_size = property(_swigfaiss.ResidualQuantizer_max_beam_size_get, _swigfaiss.ResidualQuantizer_max_beam_size_set, doc=r""" beam size used for training and for encoding""")
+    use_beam_LUT = property(_swigfaiss.ResidualQuantizer_use_beam_LUT_get, _swigfaiss.ResidualQuantizer_use_beam_LUT_set, doc=r""" use LUT for beam search""")
+    approx_topk_mode = property(_swigfaiss.ResidualQuantizer_approx_topk_mode_get, _swigfaiss.ResidualQuantizer_approx_topk_mode_set, doc=r"""
+    Currently used mode of approximate min-k computations.
+    Default value is EXACT_TOPK.
+    """)
+    cp = property(_swigfaiss.ResidualQuantizer_cp_get, _swigfaiss.ResidualQuantizer_cp_set, doc=r""" clustering parameters""")
+    assign_index_factory = property(_swigfaiss.ResidualQuantizer_assign_index_factory_get, _swigfaiss.ResidualQuantizer_assign_index_factory_set, doc=r""" if non-NULL, use this index for assignment""")
+
+    def __init__(self, *args):
+        _swigfaiss.ResidualQuantizer_swiginit(self, _swigfaiss.new_ResidualQuantizer(*args))
+
+    def train(self, n, x):
+        r""" Train the residual quantizer"""
+        return _swigfaiss.ResidualQuantizer_train(self, n, x)
+
+    def initialize_from(self, other, skip_M=0):
+        r""" Copy the M codebook levels from other, starting from skip_M"""
+        return _swigfaiss.ResidualQuantizer_initialize_from(self, other, skip_M)
+
+    def retrain_AQ_codebook(self, n, x):
+        r"""
+         Encode the vectors and compute codebook that minimizes the quantization
+        error on these codes
+
+        :type x: float
+        :param x:      training vectors, size n * d
+        :type n: int
+        :param n:      nb of training vectors, n >= total_codebook_size
+        :rtype: float
+        :return: returns quantization error for the new codebook with old
+            codes
+        """
+        return _swigfaiss.ResidualQuantizer_retrain_AQ_codebook(self, n, x)
+
+    def compute_codes_add_centroids(self, x, codes, n, centroids=None):
+        r"""
+         Encode a set of vectors
+
+        :type x: float
+        :param x:      vectors to encode, size n * d
+        :type codes: uint8_t
+        :param codes:  output codes, size n * code_size
+        :type centroids: float, optional
+        :param centroids:  centroids to be added to x, size n * d
+        """
+        return _swigfaiss.ResidualQuantizer_compute_codes_add_centroids(self, x, codes, n, centroids)
+
+    def refine_beam(self, n, beam_size, residuals, new_beam_size, new_codes, new_residuals=None, new_distances=None):
+        r"""
+         lower-level encode function
+
+        :type n: int
+        :param n:              number of vectors to hanlde
+        :type residuals: float
+        :param residuals:      vectors to encode, size (n, beam_size, d)
+        :type beam_size: int
+        :param beam_size:      input beam size
+        :type new_beam_size: int
+        :param new_beam_size:  output beam size (should be <= K * beam_size)
+        :type new_codes: int
+        :param new_codes:      output codes, size (n, new_beam_size, m + 1)
+        :type new_residuals: float, optional
+        :param new_residuals:  output residuals, size (n, new_beam_size, d)
+        :type new_distances: float, optional
+        :param new_distances:  output distances, size (n, new_beam_size)
+        """
+        return _swigfaiss.ResidualQuantizer_refine_beam(self, n, beam_size, residuals, new_beam_size, new_codes, new_residuals, new_distances)
+
+    def refine_beam_LUT(self, n, query_norms, query_cp, new_beam_size, new_codes, new_distances=None):
+        return _swigfaiss.ResidualQuantizer_refine_beam_LUT(self, n, query_norms, query_cp, new_beam_size, new_codes, new_distances)
+
+    def memory_per_point(self, beam_size=-1):
+        r"""
+         Beam search can consume a lot of memory. This function estimates the
+        amount of mem used by refine_beam to adjust the batch size
+
+        :type beam_size: int, optional
+        :param beam_size:  if != -1, override the beam size
+        """
+        return _swigfaiss.ResidualQuantizer_memory_per_point(self, beam_size)
+
+    def compute_codebook_tables(self):
+        r""" Cross products used in codebook tables used for beam_LUT = 1"""
+        return _swigfaiss.ResidualQuantizer_compute_codebook_tables(self)
+    codebook_cross_products = property(_swigfaiss.ResidualQuantizer_codebook_cross_products_get, _swigfaiss.ResidualQuantizer_codebook_cross_products_set, doc=r"""
+    dot products of all codebook entries with the previous codebooks
+    size sum(codebook_offsets[m] * 2^nbits[m], m=0..M-1)
+    """)
+    cent_norms = property(_swigfaiss.ResidualQuantizer_cent_norms_get, _swigfaiss.ResidualQuantizer_cent_norms_set, doc=r""" norms of all codebook entries (size total_codebook_size)""")
+    __swig_destroy__ = _swigfaiss.delete_ResidualQuantizer
+
+# Register ResidualQuantizer in _swigfaiss:
+_swigfaiss.ResidualQuantizer_swigregister(ResidualQuantizer)
+class LocalSearchQuantizer(AdditiveQuantizer):
+    r"""
+     Implementation of LSQ/LSQ++ described in the following two papers:
+
+    Revisiting additive quantization
+    Julieta Martinez, et al. ECCV 2016
+
+    LSQ++: Lower running time and higher recall in multi-codebook quantization
+    Julieta Martinez, et al. ECCV 2018
+
+    This implementation is mostly translated from the Julia implementations
+    by Julieta Martinez:
+    (https://github.com/una-dinosauria/local-search-quantization,
+     https://github.com/una-dinosauria/Rayuela.jl)
+
+    The trained codes are stored in `codebooks` which is called
+    `centroids` in PQ and RQ.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    K = property(_swigfaiss.LocalSearchQuantizer_K_get, _swigfaiss.LocalSearchQuantizer_K_set, doc=r""" number of codes per codebook""")
+    train_iters = property(_swigfaiss.LocalSearchQuantizer_train_iters_get, _swigfaiss.LocalSearchQuantizer_train_iters_set, doc=r""" number of iterations in training""")
+    encode_ils_iters = property(_swigfaiss.LocalSearchQuantizer_encode_ils_iters_get, _swigfaiss.LocalSearchQuantizer_encode_ils_iters_set, doc=r""" iterations of local search in encoding""")
+    train_ils_iters = property(_swigfaiss.LocalSearchQuantizer_train_ils_iters_get, _swigfaiss.LocalSearchQuantizer_train_ils_iters_set, doc=r""" iterations of local search in training""")
+    icm_iters = property(_swigfaiss.LocalSearchQuantizer_icm_iters_get, _swigfaiss.LocalSearchQuantizer_icm_iters_set, doc=r""" number of iterations in icm""")
+    p = property(_swigfaiss.LocalSearchQuantizer_p_get, _swigfaiss.LocalSearchQuantizer_p_set, doc=r""" temperature factor""")
+    lambd = property(_swigfaiss.LocalSearchQuantizer_lambd_get, _swigfaiss.LocalSearchQuantizer_lambd_set, doc=r""" regularization factor""")
+    chunk_size = property(_swigfaiss.LocalSearchQuantizer_chunk_size_get, _swigfaiss.LocalSearchQuantizer_chunk_size_set, doc=r""" nb of vectors to encode at a time""")
+    random_seed = property(_swigfaiss.LocalSearchQuantizer_random_seed_get, _swigfaiss.LocalSearchQuantizer_random_seed_set, doc=r""" seed for random generator""")
+    nperts = property(_swigfaiss.LocalSearchQuantizer_nperts_get, _swigfaiss.LocalSearchQuantizer_nperts_set, doc=r"""
+    number of perturbation in each code
+    if non-NULL, use this encoder to encode (owned by the object)
+    """)
+    icm_encoder_factory = property(_swigfaiss.LocalSearchQuantizer_icm_encoder_factory_get, _swigfaiss.LocalSearchQuantizer_icm_encoder_factory_set)
+    update_codebooks_with_double = property(_swigfaiss.LocalSearchQuantizer_update_codebooks_with_double_get, _swigfaiss.LocalSearchQuantizer_update_codebooks_with_double_set)
+
+    def __init__(self, *args):
+        _swigfaiss.LocalSearchQuantizer_swiginit(self, _swigfaiss.new_LocalSearchQuantizer(*args))
+    __swig_destroy__ = _swigfaiss.delete_LocalSearchQuantizer
+
+    def train(self, n, x):
+        return _swigfaiss.LocalSearchQuantizer_train(self, n, x)
+
+    def compute_codes_add_centroids(self, x, codes, n, centroids=None):
+        r"""
+         Encode a set of vectors
+
+        :type x: float
+        :param x:      vectors to encode, size n * d
+        :type codes: uint8_t
+        :param codes:  output codes, size n * code_size
+        :type n: int
+        :param n:      number of vectors
+        :type centroids: float, optional
+        :param centroids:  centroids to be added to x, size n * d
+        """
+        return _swigfaiss.LocalSearchQuantizer_compute_codes_add_centroids(self, x, codes, n, centroids)
+
+    def update_codebooks(self, x, codes, n):
+        r"""
+         Update codebooks given encodings
+
+        :type x: float
+        :param x:      training vectors, size n * d
+        :type codes: int
+        :param codes:  encoded training vectors, size n * M
+        :type n: int
+        :param n:      number of vectors
+        """
+        return _swigfaiss.LocalSearchQuantizer_update_codebooks(self, x, codes, n)
+
+    def icm_encode(self, codes, x, n, ils_iters, gen):
+        r"""
+         Encode vectors given codebooks using iterative conditional mode (icm).
+
+        :type codes: int
+        :param codes:     output codes, size n * M
+        :type x: float
+        :param x:         vectors to encode, size n * d
+        :type n: int
+        :param n:         number of vectors
+        :type ils_iters: int
+        :param ils_iters: number of iterations of iterative local search
+        """
+        return _swigfaiss.LocalSearchQuantizer_icm_encode(self, codes, x, n, ils_iters, gen)
+
+    def icm_encode_impl(self, codes, x, unaries, gen, n, ils_iters, verbose):
+        return _swigfaiss.LocalSearchQuantizer_icm_encode_impl(self, codes, x, unaries, gen, n, ils_iters, verbose)
+
+    def icm_encode_step(self, codes, unaries, binaries, n, n_iters):
+        return _swigfaiss.LocalSearchQuantizer_icm_encode_step(self, codes, unaries, binaries, n, n_iters)
+
+    def perturb_codes(self, codes, n, gen):
+        r"""
+         Add some perturbation to codes
+
+        :type codes: int
+        :param codes: codes to be perturbed, size n * M
+        :type n: int
+        :param n:     number of vectors
+        """
+        return _swigfaiss.LocalSearchQuantizer_perturb_codes(self, codes, n, gen)
+
+    def perturb_codebooks(self, T, stddev, gen):
+        r"""
+         Add some perturbation to codebooks
+
+        :type T: float
+        :param T:         temperature of simulated annealing
+        :type stddev: std::vector< float >
+        :param stddev:    standard derivations of each dimension in training data
+        """
+        return _swigfaiss.LocalSearchQuantizer_perturb_codebooks(self, T, stddev, gen)
+
+    def compute_binary_terms(self, binaries):
+        r"""
+         Compute binary terms
+
+        :type binaries: float
+        :param binaries: binary terms, size M * M * K * K
+        """
+        return _swigfaiss.LocalSearchQuantizer_compute_binary_terms(self, binaries)
+
+    def compute_unary_terms(self, x, unaries, n):
+        r"""
+         Compute unary terms
+
+        :type n: int
+        :param n:       number of vectors
+        :type x: float
+        :param x:       vectors to encode, size n * d
+        :type unaries: float
+        :param unaries: unary terms, size n * M * K
+        """
+        return _swigfaiss.LocalSearchQuantizer_compute_unary_terms(self, x, unaries, n)
+
+    def evaluate(self, codes, x, n, objs=None):
+        r"""
+         Helper function to compute reconstruction error
+
+        :type codes: int
+        :param codes: encoded codes, size n * M
+        :type x: float
+        :param x:     vectors to encode, size n * d
+        :type n: int
+        :param n:     number of vectors
+        :type objs: float, optional
+        :param objs:  if it is not null, store reconstruction
+                                error of each vector into it, size n
+        """
+        return _swigfaiss.LocalSearchQuantizer_evaluate(self, codes, x, n, objs)
+
+# Register LocalSearchQuantizer in _swigfaiss:
+_swigfaiss.LocalSearchQuantizer_swigregister(LocalSearchQuantizer)
+class IcmEncoder(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    binaries = property(_swigfaiss.IcmEncoder_binaries_get, _swigfaiss.IcmEncoder_binaries_set)
+    verbose = property(_swigfaiss.IcmEncoder_verbose_get, _swigfaiss.IcmEncoder_verbose_set)
+    lsq = property(_swigfaiss.IcmEncoder_lsq_get, _swigfaiss.IcmEncoder_lsq_set)
+
+    def __init__(self, lsq):
+        _swigfaiss.IcmEncoder_swiginit(self, _swigfaiss.new_IcmEncoder(lsq))
+    __swig_destroy__ = _swigfaiss.delete_IcmEncoder
+
+    def set_binary_term(self):
+        return _swigfaiss.IcmEncoder_set_binary_term(self)
+
+    def encode(self, codes, x, gen, n, ils_iters):
+        r"""
+         Encode vectors given codebooks
+
+        :type codes: int
+        :param codes:     output codes, size n * M
+        :type x: float
+        :param x:         vectors to encode, size n * d
+        :type gen: std::mt19937
+        :param gen:       random generator
+        :type n: int
+        :param n:         number of vectors
+        :type ils_iters: int
+        :param ils_iters: number of iterations of iterative local search
+        """
+        return _swigfaiss.IcmEncoder_encode(self, codes, x, gen, n, ils_iters)
+
+# Register IcmEncoder in _swigfaiss:
+_swigfaiss.IcmEncoder_swigregister(IcmEncoder)
+class IcmEncoderFactory(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def get(self, lsq):
+        return _swigfaiss.IcmEncoderFactory_get(self, lsq)
+    __swig_destroy__ = _swigfaiss.delete_IcmEncoderFactory
+
+    def __init__(self):
+        _swigfaiss.IcmEncoderFactory_swiginit(self, _swigfaiss.new_IcmEncoderFactory())
+
+# Register IcmEncoderFactory in _swigfaiss:
+_swigfaiss.IcmEncoderFactory_swigregister(IcmEncoderFactory)
+class LSQTimer(object):
+    r"""
+    A helper struct to count consuming time during training.
+    It is NOT thread-safe.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    t = property(_swigfaiss.LSQTimer_t_get, _swigfaiss.LSQTimer_t_set)
+
+    def __init__(self):
+        _swigfaiss.LSQTimer_swiginit(self, _swigfaiss.new_LSQTimer())
+
+    def get(self, name):
+        return _swigfaiss.LSQTimer_get(self, name)
+
+    def add(self, name, delta):
+        return _swigfaiss.LSQTimer_add(self, name, delta)
+
+    def reset(self):
+        return _swigfaiss.LSQTimer_reset(self)
+    __swig_destroy__ = _swigfaiss.delete_LSQTimer
+
+# Register LSQTimer in _swigfaiss:
+_swigfaiss.LSQTimer_swigregister(LSQTimer)
+class LSQTimerScope(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    t0 = property(_swigfaiss.LSQTimerScope_t0_get, _swigfaiss.LSQTimerScope_t0_set)
+    timer = property(_swigfaiss.LSQTimerScope_timer_get, _swigfaiss.LSQTimerScope_timer_set)
+    name = property(_swigfaiss.LSQTimerScope_name_get, _swigfaiss.LSQTimerScope_name_set)
+    finished = property(_swigfaiss.LSQTimerScope_finished_get, _swigfaiss.LSQTimerScope_finished_set)
+
+    def __init__(self, timer, name):
+        _swigfaiss.LSQTimerScope_swiginit(self, _swigfaiss.new_LSQTimerScope(timer, name))
+
+    def finish(self):
+        return _swigfaiss.LSQTimerScope_finish(self)
+    __swig_destroy__ = _swigfaiss.delete_LSQTimerScope
+
+# Register LSQTimerScope in _swigfaiss:
+_swigfaiss.LSQTimerScope_swigregister(LSQTimerScope)
+class ProductAdditiveQuantizer(AdditiveQuantizer):
+    r"""
+     Product Additive Quantizers
+
+    The product additive quantizer is a variant of AQ and PQ.
+    It first splits the vector space into multiple orthogonal sub-spaces
+    just like PQ does. And then it quantizes each sub-space by an independent
+    additive quantizer.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nsplits = property(_swigfaiss.ProductAdditiveQuantizer_nsplits_get, _swigfaiss.ProductAdditiveQuantizer_nsplits_set, doc=r""" number of sub-vectors we split a vector into""")
+    quantizers = property(_swigfaiss.ProductAdditiveQuantizer_quantizers_get, _swigfaiss.ProductAdditiveQuantizer_quantizers_set)
+
+    def __init__(self, *args):
+        _swigfaiss.ProductAdditiveQuantizer_swiginit(self, _swigfaiss.new_ProductAdditiveQuantizer(*args))
+    __swig_destroy__ = _swigfaiss.delete_ProductAdditiveQuantizer
+
+    def init(self, d, aqs, search_type):
+        return _swigfaiss.ProductAdditiveQuantizer_init(self, d, aqs, search_type)
+
+    def subquantizer(self, m):
+        r""" Train the product additive quantizer"""
+        return _swigfaiss.ProductAdditiveQuantizer_subquantizer(self, m)
+
+    def train(self, n, x):
+        return _swigfaiss.ProductAdditiveQuantizer_train(self, n, x)
+
+    def compute_codes_add_centroids(self, x, codes, n, centroids=None):
+        r"""
+         Encode a set of vectors
+
+        :type x: float
+        :param x:      vectors to encode, size n * d
+        :type codes: uint8_t
+        :param codes:  output codes, size n * code_size
+        :type centroids: float, optional
+        :param centroids:  centroids to be added to x, size n * d
+        """
+        return _swigfaiss.ProductAdditiveQuantizer_compute_codes_add_centroids(self, x, codes, n, centroids)
+
+    def compute_unpacked_codes(self, x, codes, n, centroids=None):
+        return _swigfaiss.ProductAdditiveQuantizer_compute_unpacked_codes(self, x, codes, n, centroids)
+
+    def decode_unpacked(self, codes, x, n, ld_codes=-1):
+        r"""
+         Decode a set of vectors in non-packed format
+
+        :type codes: int
+        :param codes:  codes to decode, size n * ld_codes
+        :type x: float
+        :param x:      output vectors, size n * d
+        """
+        return _swigfaiss.ProductAdditiveQuantizer_decode_unpacked(self, codes, x, n, ld_codes)
+
+    def decode(self, codes, x, n):
+        r"""
+         Decode a set of vectors
+
+        :type codes: uint8_t
+        :param codes:  codes to decode, size n * code_size
+        :type x: float
+        :param x:      output vectors, size n * d
+        """
+        return _swigfaiss.ProductAdditiveQuantizer_decode(self, codes, x, n)
+
+    def compute_LUT(self, n, xq, LUT, alpha=1.0, ld_lut=-1):
+        r"""
+         Compute inner-product look-up tables. Used in the search functions.
+
+        :type xq: float
+        :param xq:     query vector, size (n, d)
+        :type LUT: float
+        :param LUT:    look-up table, size (n, total_codebook_size)
+        :type alpha: float, optional
+        :param alpha:  compute alpha * inner-product
+        :type ld_lut: int, optional
+        :param ld_lut:  leading dimension of LUT
+        """
+        return _swigfaiss.ProductAdditiveQuantizer_compute_LUT(self, n, xq, LUT, alpha, ld_lut)
+
+# Register ProductAdditiveQuantizer in _swigfaiss:
+_swigfaiss.ProductAdditiveQuantizer_swigregister(ProductAdditiveQuantizer)
+class ProductLocalSearchQuantizer(ProductAdditiveQuantizer):
+    r""" Product Local Search Quantizer"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.ProductLocalSearchQuantizer_swiginit(self, _swigfaiss.new_ProductLocalSearchQuantizer(*args))
+    __swig_destroy__ = _swigfaiss.delete_ProductLocalSearchQuantizer
+
+# Register ProductLocalSearchQuantizer in _swigfaiss:
+_swigfaiss.ProductLocalSearchQuantizer_swigregister(ProductLocalSearchQuantizer)
+class ProductResidualQuantizer(ProductAdditiveQuantizer):
+    r""" Product Residual Quantizer"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.ProductResidualQuantizer_swiginit(self, _swigfaiss.new_ProductResidualQuantizer(*args))
+    __swig_destroy__ = _swigfaiss.delete_ProductResidualQuantizer
+
+# Register ProductResidualQuantizer in _swigfaiss:
+_swigfaiss.ProductResidualQuantizer_swigregister(ProductResidualQuantizer)
+class CodePacker(object):
+    r"""
+    Packing consists in combining a fixed number of codes of constant size
+    (code_size) into a block of data where they may (or may not) be interleaved
+    for efficient consumption by distance computation kernels. This exists for
+    the "fast_scan" indexes on CPU and for some GPU kernels.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    code_size = property(_swigfaiss.CodePacker_code_size_get, _swigfaiss.CodePacker_code_size_set)
+    nvec = property(_swigfaiss.CodePacker_nvec_get, _swigfaiss.CodePacker_nvec_set)
+    block_size = property(_swigfaiss.CodePacker_block_size_get, _swigfaiss.CodePacker_block_size_set)
+
+    def pack_1(self, flat_code, offset, block):
+        return _swigfaiss.CodePacker_pack_1(self, flat_code, offset, block)
+
+    def unpack_1(self, block, offset, flat_code):
+        return _swigfaiss.CodePacker_unpack_1(self, block, offset, flat_code)
+
+    def pack_all(self, flat_codes, block):
+        return _swigfaiss.CodePacker_pack_all(self, flat_codes, block)
+
+    def unpack_all(self, block, flat_codes):
+        return _swigfaiss.CodePacker_unpack_all(self, block, flat_codes)
+    __swig_destroy__ = _swigfaiss.delete_CodePacker
+
+# Register CodePacker in _swigfaiss:
+_swigfaiss.CodePacker_swigregister(CodePacker)
+class CodePackerFlat(CodePacker):
+    r""" Trivial code packer where codes are stored one by one"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, code_size):
+        _swigfaiss.CodePackerFlat_swiginit(self, _swigfaiss.new_CodePackerFlat(code_size))
+
+    def pack_1(self, flat_code, offset, block):
+        return _swigfaiss.CodePackerFlat_pack_1(self, flat_code, offset, block)
+
+    def unpack_1(self, block, offset, flat_code):
+        return _swigfaiss.CodePackerFlat_unpack_1(self, block, offset, flat_code)
+
+    def pack_all(self, flat_codes, block):
+        return _swigfaiss.CodePackerFlat_pack_all(self, flat_codes, block)
+
+    def unpack_all(self, block, flat_codes):
+        return _swigfaiss.CodePackerFlat_unpack_all(self, block, flat_codes)
+    __swig_destroy__ = _swigfaiss.delete_CodePackerFlat
+
+# Register CodePackerFlat in _swigfaiss:
+_swigfaiss.CodePackerFlat_swigregister(CodePackerFlat)
+class VectorTransform(object):
+    r""" Any transformation applied on a set of vectors"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    d_in = property(_swigfaiss.VectorTransform_d_in_get, _swigfaiss.VectorTransform_d_in_set)
+    d_out = property(_swigfaiss.VectorTransform_d_out_get, _swigfaiss.VectorTransform_d_out_set, doc=r"""input dimension""")
+    is_trained = property(_swigfaiss.VectorTransform_is_trained_get, _swigfaiss.VectorTransform_is_trained_set, doc=r"""
+    set if the VectorTransform does not require training, or if
+    training is done already
+    """)
+
+    def train(self, n, x):
+        r"""
+         Perform training on a representative set of vectors. Does
+        nothing by default.
+
+        :type n: int
+        :param n:      nb of training vectors
+        :type x: float
+        :param x:      training vecors, size n * d
+        """
+        return _swigfaiss.VectorTransform_train(self, n, x)
+
+    def apply(self, n, x):
+        r"""
+         apply the transformation and return the result in an allocated pointer
+        :type n: int
+        :param n: number of vectors to transform
+        :type x: float
+        :param x: input vectors, size n * d_in
+        :rtype: float
+        :return: output vectors, size n * d_out
+        """
+        return _swigfaiss.VectorTransform_apply(self, n, x)
+
+    def apply_noalloc(self, n, x, xt):
+        r"""
+         apply the transformation and return the result in a provided matrix
+        :type n: int
+        :param n: number of vectors to transform
+        :type x: float
+        :param x: input vectors, size n * d_in
+        :type xt: float
+        :param xt: output vectors, size n * d_out
+        """
+        return _swigfaiss.VectorTransform_apply_noalloc(self, n, x, xt)
+
+    def reverse_transform(self, n, xt, x):
+        r"""
+        reverse transformation. May not be implemented or may return
+        approximate result
+        """
+        return _swigfaiss.VectorTransform_reverse_transform(self, n, xt, x)
+
+    def check_identical(self, other):
+        return _swigfaiss.VectorTransform_check_identical(self, other)
+    __swig_destroy__ = _swigfaiss.delete_VectorTransform
+
+# Register VectorTransform in _swigfaiss:
+_swigfaiss.VectorTransform_swigregister(VectorTransform)
+class LinearTransform(VectorTransform):
+    r"""
+     Generic linear transformation, with bias term applied on output
+    y = A * x + b
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    have_bias = property(_swigfaiss.LinearTransform_have_bias_get, _swigfaiss.LinearTransform_have_bias_set)
+    is_orthonormal = property(_swigfaiss.LinearTransform_is_orthonormal_get, _swigfaiss.LinearTransform_is_orthonormal_set, doc=r"""
+    whether to use the bias term
+     check if matrix A is orthonormal (enables reverse_transform)
+    """)
+    A = property(_swigfaiss.LinearTransform_A_get, _swigfaiss.LinearTransform_A_set, doc=r""" Transformation matrix, size d_out * d_in""")
+    b = property(_swigfaiss.LinearTransform_b_get, _swigfaiss.LinearTransform_b_set, doc=r""" bias vector, size d_out""")
+
+    def __init__(self, d_in=0, d_out=0, have_bias=False):
+        r""" both d_in > d_out and d_out < d_in are supported"""
+        _swigfaiss.LinearTransform_swiginit(self, _swigfaiss.new_LinearTransform(d_in, d_out, have_bias))
+
+    def apply_noalloc(self, n, x, xt):
+        r""" same as apply, but result is pre-allocated"""
+        return _swigfaiss.LinearTransform_apply_noalloc(self, n, x, xt)
+
+    def transform_transpose(self, n, y, x):
+        r"""
+        compute x = A^T * (x - b)
+        is reverse transform if A has orthonormal lines
+        """
+        return _swigfaiss.LinearTransform_transform_transpose(self, n, y, x)
+
+    def reverse_transform(self, n, xt, x):
+        r""" works only if is_orthonormal"""
+        return _swigfaiss.LinearTransform_reverse_transform(self, n, xt, x)
+
+    def set_is_orthonormal(self):
+        r""" compute A^T * A to set the is_orthonormal flag"""
+        return _swigfaiss.LinearTransform_set_is_orthonormal(self)
+    verbose = property(_swigfaiss.LinearTransform_verbose_get, _swigfaiss.LinearTransform_verbose_set)
+
+    def print_if_verbose(self, name, mat, n, d):
+        return _swigfaiss.LinearTransform_print_if_verbose(self, name, mat, n, d)
+
+    def check_identical(self, other):
+        return _swigfaiss.LinearTransform_check_identical(self, other)
+    __swig_destroy__ = _swigfaiss.delete_LinearTransform
+
+# Register LinearTransform in _swigfaiss:
+_swigfaiss.LinearTransform_swigregister(LinearTransform)
+class RandomRotationMatrix(LinearTransform):
+    r""" Randomly rotate a set of vectors"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def init(self, seed):
+        r""" must be called before the transform is used"""
+        return _swigfaiss.RandomRotationMatrix_init(self, seed)
+
+    def train(self, n, x):
+        return _swigfaiss.RandomRotationMatrix_train(self, n, x)
+
+    def __init__(self, *args):
+        _swigfaiss.RandomRotationMatrix_swiginit(self, _swigfaiss.new_RandomRotationMatrix(*args))
+    __swig_destroy__ = _swigfaiss.delete_RandomRotationMatrix
+
+# Register RandomRotationMatrix in _swigfaiss:
+_swigfaiss.RandomRotationMatrix_swigregister(RandomRotationMatrix)
+class PCAMatrix(LinearTransform):
+    r"""
+    Applies a principal component analysis on a set of vectors,
+    with optionally whitening and random rotation.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    eigen_power = property(_swigfaiss.PCAMatrix_eigen_power_get, _swigfaiss.PCAMatrix_eigen_power_set, doc=r"""
+     after transformation the components are multiplied by
+    eigenvalues^eigen_power
+
+    =0: no whitening
+    =-0.5: full whitening
+    """)
+    epsilon = property(_swigfaiss.PCAMatrix_epsilon_get, _swigfaiss.PCAMatrix_epsilon_set, doc=r""" value added to eigenvalues to avoid division by 0 when whitening""")
+    random_rotation = property(_swigfaiss.PCAMatrix_random_rotation_get, _swigfaiss.PCAMatrix_random_rotation_set, doc=r""" random rotation after PCA""")
+    max_points_per_d = property(_swigfaiss.PCAMatrix_max_points_per_d_get, _swigfaiss.PCAMatrix_max_points_per_d_set, doc=r""" ratio between # training vectors and dimension""")
+    balanced_bins = property(_swigfaiss.PCAMatrix_balanced_bins_get, _swigfaiss.PCAMatrix_balanced_bins_set, doc=r""" try to distribute output eigenvectors in this many bins""")
+    mean = property(_swigfaiss.PCAMatrix_mean_get, _swigfaiss.PCAMatrix_mean_set, doc=r""" Mean, size d_in""")
+    eigenvalues = property(_swigfaiss.PCAMatrix_eigenvalues_get, _swigfaiss.PCAMatrix_eigenvalues_set, doc=r""" eigenvalues of covariance matrix (= squared singular values)""")
+    PCAMat = property(_swigfaiss.PCAMatrix_PCAMat_get, _swigfaiss.PCAMatrix_PCAMat_set, doc=r""" PCA matrix, size d_in * d_in""")
+
+    def __init__(self, d_in=0, d_out=0, eigen_power=0, random_rotation=False):
+        _swigfaiss.PCAMatrix_swiginit(self, _swigfaiss.new_PCAMatrix(d_in, d_out, eigen_power, random_rotation))
+
+    def train(self, n, x):
+        r"""
+        train on n vectors. If n < d_in then the eigenvector matrix
+        will be completed with 0s
+        """
+        return _swigfaiss.PCAMatrix_train(self, n, x)
+
+    def copy_from(self, other):
+        r""" copy pre-trained PCA matrix"""
+        return _swigfaiss.PCAMatrix_copy_from(self, other)
+
+    def prepare_Ab(self):
+        r""" called after mean, PCAMat and eigenvalues are computed"""
+        return _swigfaiss.PCAMatrix_prepare_Ab(self)
+    __swig_destroy__ = _swigfaiss.delete_PCAMatrix
+
+# Register PCAMatrix in _swigfaiss:
+_swigfaiss.PCAMatrix_swigregister(PCAMatrix)
+class ITQMatrix(LinearTransform):
+    r"""
+     ITQ implementation from
+
+        Iterative quantization: A procrustean approach to learning binary codes
+        for large-scale image retrieval,
+
+    Yunchao Gong, Svetlana Lazebnik, Albert Gordo, Florent Perronnin,
+    PAMI'12.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    max_iter = property(_swigfaiss.ITQMatrix_max_iter_get, _swigfaiss.ITQMatrix_max_iter_set)
+    seed = property(_swigfaiss.ITQMatrix_seed_get, _swigfaiss.ITQMatrix_seed_set)
+    init_rotation = property(_swigfaiss.ITQMatrix_init_rotation_get, _swigfaiss.ITQMatrix_init_rotation_set)
+
+    def __init__(self, d=0):
+        _swigfaiss.ITQMatrix_swiginit(self, _swigfaiss.new_ITQMatrix(d))
+
+    def train(self, n, x):
+        return _swigfaiss.ITQMatrix_train(self, n, x)
+    __swig_destroy__ = _swigfaiss.delete_ITQMatrix
+
+# Register ITQMatrix in _swigfaiss:
+_swigfaiss.ITQMatrix_swigregister(ITQMatrix)
+class ITQTransform(VectorTransform):
+    r""" The full ITQ transform, including normalizations and PCA transformation"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    mean = property(_swigfaiss.ITQTransform_mean_get, _swigfaiss.ITQTransform_mean_set)
+    do_pca = property(_swigfaiss.ITQTransform_do_pca_get, _swigfaiss.ITQTransform_do_pca_set)
+    itq = property(_swigfaiss.ITQTransform_itq_get, _swigfaiss.ITQTransform_itq_set)
+    max_train_per_dim = property(_swigfaiss.ITQTransform_max_train_per_dim_get, _swigfaiss.ITQTransform_max_train_per_dim_set, doc=r""" max training points per dimension""")
+    pca_then_itq = property(_swigfaiss.ITQTransform_pca_then_itq_get, _swigfaiss.ITQTransform_pca_then_itq_set)
+
+    def __init__(self, d_in=0, d_out=0, do_pca=False):
+        _swigfaiss.ITQTransform_swiginit(self, _swigfaiss.new_ITQTransform(d_in, d_out, do_pca))
+
+    def train(self, n, x):
+        return _swigfaiss.ITQTransform_train(self, n, x)
+
+    def apply_noalloc(self, n, x, xt):
+        return _swigfaiss.ITQTransform_apply_noalloc(self, n, x, xt)
+
+    def check_identical(self, other):
+        return _swigfaiss.ITQTransform_check_identical(self, other)
+    __swig_destroy__ = _swigfaiss.delete_ITQTransform
+
+# Register ITQTransform in _swigfaiss:
+_swigfaiss.ITQTransform_swigregister(ITQTransform)
+class OPQMatrix(LinearTransform):
+    r"""
+     Applies a rotation to align the dimensions with a PQ to minimize
+     the reconstruction error. Can be used before an IndexPQ or an
+     IndexIVFPQ. The method is the non-parametric version described in:
+
+    "Optimized Product Quantization for Approximate Nearest Neighbor Search"
+    Tiezheng Ge, Kaiming He, Qifa Ke, Jian Sun, CVPR'13
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    M = property(_swigfaiss.OPQMatrix_M_get, _swigfaiss.OPQMatrix_M_set, doc=r""" nb of subquantizers""")
+    niter = property(_swigfaiss.OPQMatrix_niter_get, _swigfaiss.OPQMatrix_niter_set, doc=r""" Number of outer training iterations""")
+    niter_pq = property(_swigfaiss.OPQMatrix_niter_pq_get, _swigfaiss.OPQMatrix_niter_pq_set, doc=r""" Number of training iterations for the PQ""")
+    niter_pq_0 = property(_swigfaiss.OPQMatrix_niter_pq_0_get, _swigfaiss.OPQMatrix_niter_pq_0_set, doc=r""" same, for the first outer iteration""")
+    max_train_points = property(_swigfaiss.OPQMatrix_max_train_points_get, _swigfaiss.OPQMatrix_max_train_points_set, doc=r""" if there are too many training points, resample""")
+    verbose = property(_swigfaiss.OPQMatrix_verbose_get, _swigfaiss.OPQMatrix_verbose_set)
+    pq = property(_swigfaiss.OPQMatrix_pq_get, _swigfaiss.OPQMatrix_pq_set, doc=r"""
+    if non-NULL, use this product quantizer for training
+    should be constructed with (d_out, M, _)
+    """)
+
+    def __init__(self, d=0, M=1, d2=-1):
+        r""" if d2 != -1, output vectors of this dimension"""
+        _swigfaiss.OPQMatrix_swiginit(self, _swigfaiss.new_OPQMatrix(d, M, d2))
+
+    def train(self, n, x):
+        return _swigfaiss.OPQMatrix_train(self, n, x)
+    __swig_destroy__ = _swigfaiss.delete_OPQMatrix
+
+# Register OPQMatrix in _swigfaiss:
+_swigfaiss.OPQMatrix_swigregister(OPQMatrix)
+class RemapDimensionsTransform(VectorTransform):
+    r"""
+     remap dimensions for intput vectors, possibly inserting 0s
+    strictly speaking this is also a linear transform but we don't want
+    to compute it with matrix multiplies
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    map = property(_swigfaiss.RemapDimensionsTransform_map_get, _swigfaiss.RemapDimensionsTransform_map_set, doc=r"""
+    map from output dimension to input, size d_out
+    -1 -> set output to 0
+    """)
+
+    def apply_noalloc(self, n, x, xt):
+        return _swigfaiss.RemapDimensionsTransform_apply_noalloc(self, n, x, xt)
+
+    def reverse_transform(self, n, xt, x):
+        r""" reverse transform correct only when the mapping is a permutation"""
+        return _swigfaiss.RemapDimensionsTransform_reverse_transform(self, n, xt, x)
+
+    def __init__(self, *args):
+        _swigfaiss.RemapDimensionsTransform_swiginit(self, _swigfaiss.new_RemapDimensionsTransform(*args))
+
+    def check_identical(self, other):
+        return _swigfaiss.RemapDimensionsTransform_check_identical(self, other)
+    __swig_destroy__ = _swigfaiss.delete_RemapDimensionsTransform
+
+# Register RemapDimensionsTransform in _swigfaiss:
+_swigfaiss.RemapDimensionsTransform_swigregister(RemapDimensionsTransform)
+class NormalizationTransform(VectorTransform):
+    r""" per-vector normalization"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    norm = property(_swigfaiss.NormalizationTransform_norm_get, _swigfaiss.NormalizationTransform_norm_set)
+
+    def __init__(self, *args):
+        _swigfaiss.NormalizationTransform_swiginit(self, _swigfaiss.new_NormalizationTransform(*args))
+
+    def apply_noalloc(self, n, x, xt):
+        return _swigfaiss.NormalizationTransform_apply_noalloc(self, n, x, xt)
+
+    def reverse_transform(self, n, xt, x):
+        r""" Identity transform since norm is not revertible"""
+        return _swigfaiss.NormalizationTransform_reverse_transform(self, n, xt, x)
+
+    def check_identical(self, other):
+        return _swigfaiss.NormalizationTransform_check_identical(self, other)
+    __swig_destroy__ = _swigfaiss.delete_NormalizationTransform
+
+# Register NormalizationTransform in _swigfaiss:
+_swigfaiss.NormalizationTransform_swigregister(NormalizationTransform)
+class CenteringTransform(VectorTransform):
+    r""" Subtract the mean of each component from the vectors."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    mean = property(_swigfaiss.CenteringTransform_mean_get, _swigfaiss.CenteringTransform_mean_set, doc=r""" Mean, size d_in = d_out""")
+
+    def __init__(self, d=0):
+        _swigfaiss.CenteringTransform_swiginit(self, _swigfaiss.new_CenteringTransform(d))
+
+    def train(self, n, x):
+        r""" train on n vectors."""
+        return _swigfaiss.CenteringTransform_train(self, n, x)
+
+    def apply_noalloc(self, n, x, xt):
+        r""" subtract the mean"""
+        return _swigfaiss.CenteringTransform_apply_noalloc(self, n, x, xt)
+
+    def reverse_transform(self, n, xt, x):
+        r""" add the mean"""
+        return _swigfaiss.CenteringTransform_reverse_transform(self, n, xt, x)
+
+    def check_identical(self, other):
+        return _swigfaiss.CenteringTransform_check_identical(self, other)
+    __swig_destroy__ = _swigfaiss.delete_CenteringTransform
+
+# Register CenteringTransform in _swigfaiss:
+_swigfaiss.CenteringTransform_swigregister(CenteringTransform)
+class SearchParametersPreTransform(SearchParameters):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    index_params = property(_swigfaiss.SearchParametersPreTransform_index_params_get, _swigfaiss.SearchParametersPreTransform_index_params_set)
+
+    def __init__(self):
+        _swigfaiss.SearchParametersPreTransform_swiginit(self, _swigfaiss.new_SearchParametersPreTransform())
+    __swig_destroy__ = _swigfaiss.delete_SearchParametersPreTransform
+
+# Register SearchParametersPreTransform in _swigfaiss:
+_swigfaiss.SearchParametersPreTransform_swigregister(SearchParametersPreTransform)
+class IndexPreTransform(Index):
+    r"""
+    Index that applies a LinearTransform transform on vectors before
+    handing them over to a sub-index
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    chain = property(_swigfaiss.IndexPreTransform_chain_get, _swigfaiss.IndexPreTransform_chain_set)
+    index = property(_swigfaiss.IndexPreTransform_index_get, _swigfaiss.IndexPreTransform_index_set, doc=r"""chain of tranforms""")
+    own_fields = property(_swigfaiss.IndexPreTransform_own_fields_get, _swigfaiss.IndexPreTransform_own_fields_set, doc=r"""the sub-index""")
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+        whether pointers are deleted in destructor
+
+        |
+
+        *Overload 2:*
+         ltrans is the last transform before the index
+        """
+        _swigfaiss.IndexPreTransform_swiginit(self, _swigfaiss.new_IndexPreTransform(*args))
+
+    def prepend_transform(self, ltrans):
+        return _swigfaiss.IndexPreTransform_prepend_transform(self, ltrans)
+
+    def train(self, n, x):
+        return _swigfaiss.IndexPreTransform_train(self, n, x)
+
+    def add(self, n, x):
+        return _swigfaiss.IndexPreTransform_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss.IndexPreTransform_add_with_ids(self, n, x, xids)
+
+    def reset(self):
+        return _swigfaiss.IndexPreTransform_reset(self)
+
+    def remove_ids(self, sel):
+        r""" removes IDs from the index. Not supported by all indexes."""
+        return _swigfaiss.IndexPreTransform_remove_ids(self, sel)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexPreTransform_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss.IndexPreTransform_range_search(self, n, x, radius, result, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexPreTransform_reconstruct(self, key, recons)
+
+    def reconstruct_n(self, i0, ni, recons):
+        return _swigfaiss.IndexPreTransform_reconstruct_n(self, i0, ni, recons)
+
+    def search_and_reconstruct(self, n, x, k, distances, labels, recons, params=None):
+        return _swigfaiss.IndexPreTransform_search_and_reconstruct(self, n, x, k, distances, labels, recons, params)
+
+    def apply_chain(self, n, x):
+        r"""
+        apply the transforms in the chain. The returned float * may be
+        equal to x, otherwise it should be deallocated.
+        """
+        return _swigfaiss.IndexPreTransform_apply_chain(self, n, x)
+
+    def reverse_chain(self, n, xt, x):
+        r"""
+        Reverse the transforms in the chain. May not be implemented for
+        all transforms in the chain or may return approximate results.
+        """
+        return _swigfaiss.IndexPreTransform_reverse_chain(self, n, xt, x)
+
+    def get_distance_computer(self):
+        return _swigfaiss.IndexPreTransform_get_distance_computer(self)
+
+    def sa_code_size(self):
+        return _swigfaiss.IndexPreTransform_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss.IndexPreTransform_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexPreTransform_sa_decode(self, n, bytes, x)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss.IndexPreTransform_merge_from(self, otherIndex, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss.IndexPreTransform_check_compatible_for_merge(self, otherIndex)
+    __swig_destroy__ = _swigfaiss.delete_IndexPreTransform
+
+# Register IndexPreTransform in _swigfaiss:
+_swigfaiss.IndexPreTransform_swigregister(IndexPreTransform)
+class IndexRefineSearchParameters(SearchParameters):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    k_factor = property(_swigfaiss.IndexRefineSearchParameters_k_factor_get, _swigfaiss.IndexRefineSearchParameters_k_factor_set)
+    base_index_params = property(_swigfaiss.IndexRefineSearchParameters_base_index_params_get, _swigfaiss.IndexRefineSearchParameters_base_index_params_set)
+    __swig_destroy__ = _swigfaiss.delete_IndexRefineSearchParameters
+
+    def __init__(self):
+        _swigfaiss.IndexRefineSearchParameters_swiginit(self, _swigfaiss.new_IndexRefineSearchParameters())
+
+# Register IndexRefineSearchParameters in _swigfaiss:
+_swigfaiss.IndexRefineSearchParameters_swigregister(IndexRefineSearchParameters)
+class IndexRefine(Index):
+    r"""
+    Index that queries in a base_index (a fast one) and refines the
+    results with an exact search, hopefully improving the results.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    base_index = property(_swigfaiss.IndexRefine_base_index_get, _swigfaiss.IndexRefine_base_index_set, doc=r""" faster index to pre-select the vectors that should be filtered""")
+    refine_index = property(_swigfaiss.IndexRefine_refine_index_get, _swigfaiss.IndexRefine_refine_index_set, doc=r""" refinement index""")
+    own_fields = property(_swigfaiss.IndexRefine_own_fields_get, _swigfaiss.IndexRefine_own_fields_set, doc=r""" should the base index be deallocated?""")
+    own_refine_index = property(_swigfaiss.IndexRefine_own_refine_index_get, _swigfaiss.IndexRefine_own_refine_index_set, doc=r""" same with the refinement index""")
+    k_factor = property(_swigfaiss.IndexRefine_k_factor_get, _swigfaiss.IndexRefine_k_factor_set, doc=r"""
+    factor between k requested in search and the k requested from
+    the base_index (should be >= 1)
+    """)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexRefine_swiginit(self, _swigfaiss.new_IndexRefine(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexRefine_train(self, n, x)
+
+    def add(self, n, x):
+        return _swigfaiss.IndexRefine_add(self, n, x)
+
+    def reset(self):
+        return _swigfaiss.IndexRefine_reset(self)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexRefine_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexRefine_reconstruct(self, key, recons)
+
+    def sa_code_size(self):
+        return _swigfaiss.IndexRefine_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss.IndexRefine_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        r"""
+        The sa_decode decodes from the index_refine, which is assumed to be more
+        accurate
+        """
+        return _swigfaiss.IndexRefine_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexRefine
+
+# Register IndexRefine in _swigfaiss:
+_swigfaiss.IndexRefine_swigregister(IndexRefine)
+class IndexRefineFlat(IndexRefine):
+    r"""
+     Version where the refinement index is an IndexFlat. It has one additional
+    constructor that takes a table of elements to add to the flat refinement
+    index
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.IndexRefineFlat_swiginit(self, _swigfaiss.new_IndexRefineFlat(*args))
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexRefineFlat_search(self, n, x, k, distances, labels, params)
+    __swig_destroy__ = _swigfaiss.delete_IndexRefineFlat
+
+# Register IndexRefineFlat in _swigfaiss:
+_swigfaiss.IndexRefineFlat_swigregister(IndexRefineFlat)
+class IndexLSH(IndexFlatCodes):
+    r""" The sign of each vector component is put in a binary signature"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nbits = property(_swigfaiss.IndexLSH_nbits_get, _swigfaiss.IndexLSH_nbits_set, doc=r""" nb of bits per vector""")
+    rotate_data = property(_swigfaiss.IndexLSH_rotate_data_get, _swigfaiss.IndexLSH_rotate_data_set, doc=r""" whether to apply a random rotation to input""")
+    train_thresholds = property(_swigfaiss.IndexLSH_train_thresholds_get, _swigfaiss.IndexLSH_train_thresholds_set, doc=r""" whether we train thresholds or use 0""")
+    rrot = property(_swigfaiss.IndexLSH_rrot_get, _swigfaiss.IndexLSH_rrot_set, doc=r""" optional random rotation""")
+    thresholds = property(_swigfaiss.IndexLSH_thresholds_get, _swigfaiss.IndexLSH_thresholds_set, doc=r""" thresholds to compare with""")
+
+    def apply_preprocess(self, n, x):
+        r"""
+         Preprocesses and resizes the input to the size required to
+        binarize the data
+
+        :type x: float
+        :param x: input vectors, size n * d
+        :rtype: float
+        :return: output vectors, size n * bits. May be the same pointer
+                    as x, otherwise it should be deleted by the caller
+        """
+        return _swigfaiss.IndexLSH_apply_preprocess(self, n, x)
+
+    def train(self, n, x):
+        return _swigfaiss.IndexLSH_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexLSH_search(self, n, x, k, distances, labels, params)
+
+    def transfer_thresholds(self, vt):
+        r"""
+        transfer the thresholds to a pre-processing stage (and unset
+        train_thresholds)
+        """
+        return _swigfaiss.IndexLSH_transfer_thresholds(self, vt)
+    __swig_destroy__ = _swigfaiss.delete_IndexLSH
+
+    def __init__(self, *args):
+        _swigfaiss.IndexLSH_swiginit(self, _swigfaiss.new_IndexLSH(*args))
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss.IndexLSH_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexLSH_sa_decode(self, n, bytes, x)
+
+# Register IndexLSH in _swigfaiss:
+_swigfaiss.IndexLSH_swigregister(IndexLSH)
+class SimulatedAnnealingParameters(object):
+    r""" parameters used for the simulated annealing method"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    init_temperature = property(_swigfaiss.SimulatedAnnealingParameters_init_temperature_get, _swigfaiss.SimulatedAnnealingParameters_init_temperature_set)
+    temperature_decay = property(_swigfaiss.SimulatedAnnealingParameters_temperature_decay_get, _swigfaiss.SimulatedAnnealingParameters_temperature_decay_set)
+    n_iter = property(_swigfaiss.SimulatedAnnealingParameters_n_iter_get, _swigfaiss.SimulatedAnnealingParameters_n_iter_set)
+    n_redo = property(_swigfaiss.SimulatedAnnealingParameters_n_redo_get, _swigfaiss.SimulatedAnnealingParameters_n_redo_set)
+    seed = property(_swigfaiss.SimulatedAnnealingParameters_seed_get, _swigfaiss.SimulatedAnnealingParameters_seed_set)
+    verbose = property(_swigfaiss.SimulatedAnnealingParameters_verbose_get, _swigfaiss.SimulatedAnnealingParameters_verbose_set)
+    only_bit_flips = property(_swigfaiss.SimulatedAnnealingParameters_only_bit_flips_get, _swigfaiss.SimulatedAnnealingParameters_only_bit_flips_set)
+    init_random = property(_swigfaiss.SimulatedAnnealingParameters_init_random_get, _swigfaiss.SimulatedAnnealingParameters_init_random_set)
+
+    def __init__(self):
+        _swigfaiss.SimulatedAnnealingParameters_swiginit(self, _swigfaiss.new_SimulatedAnnealingParameters())
+    __swig_destroy__ = _swigfaiss.delete_SimulatedAnnealingParameters
+
+# Register SimulatedAnnealingParameters in _swigfaiss:
+_swigfaiss.SimulatedAnnealingParameters_swigregister(SimulatedAnnealingParameters)
+class PermutationObjective(object):
+    r""" abstract class for the loss function"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    n = property(_swigfaiss.PermutationObjective_n_get, _swigfaiss.PermutationObjective_n_set)
+
+    def compute_cost(self, perm):
+        return _swigfaiss.PermutationObjective_compute_cost(self, perm)
+
+    def cost_update(self, perm, iw, jw):
+        return _swigfaiss.PermutationObjective_cost_update(self, perm, iw, jw)
+    __swig_destroy__ = _swigfaiss.delete_PermutationObjective
+
+# Register PermutationObjective in _swigfaiss:
+_swigfaiss.PermutationObjective_swigregister(PermutationObjective)
+class ReproduceDistancesObjective(PermutationObjective):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    dis_weight_factor = property(_swigfaiss.ReproduceDistancesObjective_dis_weight_factor_get, _swigfaiss.ReproduceDistancesObjective_dis_weight_factor_set)
+
+    @staticmethod
+    def sqr(x):
+        return _swigfaiss.ReproduceDistancesObjective_sqr(x)
+
+    def dis_weight(self, x):
+        return _swigfaiss.ReproduceDistancesObjective_dis_weight(self, x)
+    source_dis = property(_swigfaiss.ReproduceDistancesObjective_source_dis_get, _swigfaiss.ReproduceDistancesObjective_source_dis_set, doc=r""" "real" corrected distances (size n^2)""")
+    target_dis = property(_swigfaiss.ReproduceDistancesObjective_target_dis_get, _swigfaiss.ReproduceDistancesObjective_target_dis_set, doc=r""" wanted distances (size n^2)""")
+    weights = property(_swigfaiss.ReproduceDistancesObjective_weights_get, _swigfaiss.ReproduceDistancesObjective_weights_set, doc=r""" weights for each distance (size n^2)""")
+
+    def get_source_dis(self, i, j):
+        return _swigfaiss.ReproduceDistancesObjective_get_source_dis(self, i, j)
+
+    def compute_cost(self, perm):
+        return _swigfaiss.ReproduceDistancesObjective_compute_cost(self, perm)
+
+    def cost_update(self, perm, iw, jw):
+        return _swigfaiss.ReproduceDistancesObjective_cost_update(self, perm, iw, jw)
+
+    def __init__(self, n, source_dis_in, target_dis_in, dis_weight_factor):
+        _swigfaiss.ReproduceDistancesObjective_swiginit(self, _swigfaiss.new_ReproduceDistancesObjective(n, source_dis_in, target_dis_in, dis_weight_factor))
+
+    @staticmethod
+    def compute_mean_stdev(tab, n2, mean_out, stddev_out):
+        return _swigfaiss.ReproduceDistancesObjective_compute_mean_stdev(tab, n2, mean_out, stddev_out)
+
+    def set_affine_target_dis(self, source_dis_in):
+        return _swigfaiss.ReproduceDistancesObjective_set_affine_target_dis(self, source_dis_in)
+    __swig_destroy__ = _swigfaiss.delete_ReproduceDistancesObjective
+
+# Register ReproduceDistancesObjective in _swigfaiss:
+_swigfaiss.ReproduceDistancesObjective_swigregister(ReproduceDistancesObjective)
+class SimulatedAnnealingOptimizer(SimulatedAnnealingParameters):
+    r""" Simulated annealing optimization algorithm for permutations."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    obj = property(_swigfaiss.SimulatedAnnealingOptimizer_obj_get, _swigfaiss.SimulatedAnnealingOptimizer_obj_set)
+    n = property(_swigfaiss.SimulatedAnnealingOptimizer_n_get, _swigfaiss.SimulatedAnnealingOptimizer_n_set, doc=r""" size of the permutation""")
+    logfile = property(_swigfaiss.SimulatedAnnealingOptimizer_logfile_get, _swigfaiss.SimulatedAnnealingOptimizer_logfile_set)
+
+    def __init__(self, obj, p):
+        r""" logs values of the cost function"""
+        _swigfaiss.SimulatedAnnealingOptimizer_swiginit(self, _swigfaiss.new_SimulatedAnnealingOptimizer(obj, p))
+    rnd = property(_swigfaiss.SimulatedAnnealingOptimizer_rnd_get, _swigfaiss.SimulatedAnnealingOptimizer_rnd_set)
+    init_cost = property(_swigfaiss.SimulatedAnnealingOptimizer_init_cost_get, _swigfaiss.SimulatedAnnealingOptimizer_init_cost_set, doc=r""" remember initial cost of optimization""")
+
+    def optimize(self, perm):
+        return _swigfaiss.SimulatedAnnealingOptimizer_optimize(self, perm)
+
+    def run_optimization(self, best_perm):
+        return _swigfaiss.SimulatedAnnealingOptimizer_run_optimization(self, best_perm)
+    __swig_destroy__ = _swigfaiss.delete_SimulatedAnnealingOptimizer
+
+# Register SimulatedAnnealingOptimizer in _swigfaiss:
+_swigfaiss.SimulatedAnnealingOptimizer_swigregister(SimulatedAnnealingOptimizer)
+class PolysemousTraining(SimulatedAnnealingParameters):
+    r""" optimizes the order of indices in a ProductQuantizer"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    OT_None = _swigfaiss.PolysemousTraining_OT_None
+    OT_ReproduceDistances_affine = _swigfaiss.PolysemousTraining_OT_ReproduceDistances_affine
+    r""" default"""
+    OT_Ranking_weighted_diff = _swigfaiss.PolysemousTraining_OT_Ranking_weighted_diff
+    r"""
+    same as _2, but use rank of y+ - rank of
+    y-
+    """
+    optimization_type = property(_swigfaiss.PolysemousTraining_optimization_type_get, _swigfaiss.PolysemousTraining_optimization_type_set)
+    ntrain_permutation = property(_swigfaiss.PolysemousTraining_ntrain_permutation_get, _swigfaiss.PolysemousTraining_ntrain_permutation_set, doc=r"""
+     use 1/4 of the training points for the optimization, with
+    max. ntrain_permutation. If ntrain_permutation == 0: train on
+    centroids
+    """)
+    dis_weight_factor = property(_swigfaiss.PolysemousTraining_dis_weight_factor_get, _swigfaiss.PolysemousTraining_dis_weight_factor_set, doc=r""" decay of exp that weights distance loss""")
+    max_memory = property(_swigfaiss.PolysemousTraining_max_memory_get, _swigfaiss.PolysemousTraining_max_memory_set, doc=r""" refuse to train if it would require more than that amount of RAM""")
+    log_pattern = property(_swigfaiss.PolysemousTraining_log_pattern_get, _swigfaiss.PolysemousTraining_log_pattern_set)
+
+    def __init__(self):
+        _swigfaiss.PolysemousTraining_swiginit(self, _swigfaiss.new_PolysemousTraining())
+
+    def optimize_pq_for_hamming(self, pq, n, x):
+        r"""
+        reorder the centroids so that the Hamming distance becomes a
+        good approximation of the SDC distance (called by train)
+        """
+        return _swigfaiss.PolysemousTraining_optimize_pq_for_hamming(self, pq, n, x)
+
+    def optimize_ranking(self, pq, n, x):
+        r""" called by optimize_pq_for_hamming"""
+        return _swigfaiss.PolysemousTraining_optimize_ranking(self, pq, n, x)
+
+    def optimize_reproduce_distances(self, pq):
+        r""" called by optimize_pq_for_hamming"""
+        return _swigfaiss.PolysemousTraining_optimize_reproduce_distances(self, pq)
+
+    def memory_usage_per_thread(self, pq):
+        r""" make sure we don't blow up the memory"""
+        return _swigfaiss.PolysemousTraining_memory_usage_per_thread(self, pq)
+    __swig_destroy__ = _swigfaiss.delete_PolysemousTraining
+
+# Register PolysemousTraining in _swigfaiss:
+_swigfaiss.PolysemousTraining_swigregister(PolysemousTraining)
+class IndexPQ(IndexFlatCodes):
+    r"""
+     Index based on a product quantizer. Stored vectors are
+    approximated by PQ codes.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    pq = property(_swigfaiss.IndexPQ_pq_get, _swigfaiss.IndexPQ_pq_set, doc=r""" The product quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexPQ_swiginit(self, _swigfaiss.new_IndexPQ(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexPQ_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexPQ_search(self, n, x, k, distances, labels, params)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss.IndexPQ_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexPQ_sa_decode(self, n, bytes, x)
+
+    def get_FlatCodesDistanceComputer(self):
+        return _swigfaiss.IndexPQ_get_FlatCodesDistanceComputer(self)
+    do_polysemous_training = property(_swigfaiss.IndexPQ_do_polysemous_training_get, _swigfaiss.IndexPQ_do_polysemous_training_set, doc=r""" false = standard PQ""")
+    polysemous_training = property(_swigfaiss.IndexPQ_polysemous_training_get, _swigfaiss.IndexPQ_polysemous_training_set, doc=r""" parameters used for the polysemous training""")
+    ST_PQ = _swigfaiss.IndexPQ_ST_PQ
+    r""" asymmetric product quantizer (default)"""
+    ST_HE = _swigfaiss.IndexPQ_ST_HE
+    r""" Hamming distance on codes"""
+    ST_generalized_HE = _swigfaiss.IndexPQ_ST_generalized_HE
+    r""" nb of same codes"""
+    ST_SDC = _swigfaiss.IndexPQ_ST_SDC
+    r""" symmetric product quantizer (SDC)"""
+    ST_polysemous = _swigfaiss.IndexPQ_ST_polysemous
+    r""" HE filter (using ht) + PQ combination"""
+    ST_polysemous_generalize = _swigfaiss.IndexPQ_ST_polysemous_generalize
+    r""" Filter on generalized Hamming"""
+    search_type = property(_swigfaiss.IndexPQ_search_type_get, _swigfaiss.IndexPQ_search_type_set)
+    encode_signs = property(_swigfaiss.IndexPQ_encode_signs_get, _swigfaiss.IndexPQ_encode_signs_set)
+    polysemous_ht = property(_swigfaiss.IndexPQ_polysemous_ht_get, _swigfaiss.IndexPQ_polysemous_ht_set, doc=r""" Hamming threshold used for polysemy""")
+
+    def search_core_polysemous(self, n, x, k, distances, labels, polysemous_ht, generalized_hamming):
+        return _swigfaiss.IndexPQ_search_core_polysemous(self, n, x, k, distances, labels, polysemous_ht, generalized_hamming)
+
+    def hamming_distance_histogram(self, n, x, nb, xb, dist_histogram):
+        r"""
+        prepare query for a polysemous search, but instead of
+        computing the result, just get the histogram of Hamming
+        distances. May be computed on a provided dataset if xb != NULL
+        :type dist_histogram: int
+        :param dist_histogram: (M * nbits + 1)
+        """
+        return _swigfaiss.IndexPQ_hamming_distance_histogram(self, n, x, nb, xb, dist_histogram)
+
+    def hamming_distance_table(self, n, x, dis):
+        r"""
+         compute pairwise distances between queries and database
+
+        :type n: int
+        :param n:    nb of query vectors
+        :type x: float
+        :param x:    query vector, size n * d
+        :type dis: int
+        :param dis:  output distances, size n * ntotal
+        """
+        return _swigfaiss.IndexPQ_hamming_distance_table(self, n, x, dis)
+    __swig_destroy__ = _swigfaiss.delete_IndexPQ
+
+# Register IndexPQ in _swigfaiss:
+_swigfaiss.IndexPQ_swigregister(IndexPQ)
+class SearchParametersPQ(SearchParameters):
+    r""" override search parameters from the class"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    search_type = property(_swigfaiss.SearchParametersPQ_search_type_get, _swigfaiss.SearchParametersPQ_search_type_set)
+    polysemous_ht = property(_swigfaiss.SearchParametersPQ_polysemous_ht_get, _swigfaiss.SearchParametersPQ_polysemous_ht_set)
+
+    def __init__(self):
+        _swigfaiss.SearchParametersPQ_swiginit(self, _swigfaiss.new_SearchParametersPQ())
+    __swig_destroy__ = _swigfaiss.delete_SearchParametersPQ
+
+# Register SearchParametersPQ in _swigfaiss:
+_swigfaiss.SearchParametersPQ_swigregister(SearchParametersPQ)
+class IndexPQStats(object):
+    r"""
+    statistics are robust to internal threading, but not if
+    IndexPQ::search is called by multiple threads
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss.IndexPQStats_nq_get, _swigfaiss.IndexPQStats_nq_set)
+    ncode = property(_swigfaiss.IndexPQStats_ncode_get, _swigfaiss.IndexPQStats_ncode_set)
+    n_hamming_pass = property(_swigfaiss.IndexPQStats_n_hamming_pass_get, _swigfaiss.IndexPQStats_n_hamming_pass_set)
+
+    def __init__(self):
+        _swigfaiss.IndexPQStats_swiginit(self, _swigfaiss.new_IndexPQStats())
+
+    def reset(self):
+        return _swigfaiss.IndexPQStats_reset(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexPQStats
+
+# Register IndexPQStats in _swigfaiss:
+_swigfaiss.IndexPQStats_swigregister(IndexPQStats)
+class MultiIndexQuantizer(Index):
+    r"""
+    Quantizer where centroids are virtual: they are the Cartesian
+    product of sub-centroids.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    pq = property(_swigfaiss.MultiIndexQuantizer_pq_get, _swigfaiss.MultiIndexQuantizer_pq_set)
+
+    def train(self, n, x):
+        return _swigfaiss.MultiIndexQuantizer_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.MultiIndexQuantizer_search(self, n, x, k, distances, labels, params)
+
+    def add(self, n, x):
+        r""" add and reset will crash at runtime"""
+        return _swigfaiss.MultiIndexQuantizer_add(self, n, x)
+
+    def reset(self):
+        return _swigfaiss.MultiIndexQuantizer_reset(self)
+
+    def __init__(self, *args):
+        _swigfaiss.MultiIndexQuantizer_swiginit(self, _swigfaiss.new_MultiIndexQuantizer(*args))
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.MultiIndexQuantizer_reconstruct(self, key, recons)
+    __swig_destroy__ = _swigfaiss.delete_MultiIndexQuantizer
+
+# Register MultiIndexQuantizer in _swigfaiss:
+_swigfaiss.MultiIndexQuantizer_swigregister(MultiIndexQuantizer)
+class MultiIndexQuantizer2(MultiIndexQuantizer):
+    r""" MultiIndexQuantizer where the PQ assignmnet is performed by sub-indexes"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    assign_indexes = property(_swigfaiss.MultiIndexQuantizer2_assign_indexes_get, _swigfaiss.MultiIndexQuantizer2_assign_indexes_set, doc=r""" M Indexes on d / M dimensions""")
+    own_fields = property(_swigfaiss.MultiIndexQuantizer2_own_fields_get, _swigfaiss.MultiIndexQuantizer2_own_fields_set)
+
+    def __init__(self, *args):
+        _swigfaiss.MultiIndexQuantizer2_swiginit(self, _swigfaiss.new_MultiIndexQuantizer2(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.MultiIndexQuantizer2_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.MultiIndexQuantizer2_search(self, n, x, k, distances, labels, params)
+    __swig_destroy__ = _swigfaiss.delete_MultiIndexQuantizer2
+
+# Register MultiIndexQuantizer2 in _swigfaiss:
+_swigfaiss.MultiIndexQuantizer2_swigregister(MultiIndexQuantizer2)
+class IndexAdditiveQuantizer(IndexFlatCodes):
+    r""" Abstract class for additive quantizers. The search functions are in common."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    aq = property(_swigfaiss.IndexAdditiveQuantizer_aq_get, _swigfaiss.IndexAdditiveQuantizer_aq_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexAdditiveQuantizer_swiginit(self, _swigfaiss.new_IndexAdditiveQuantizer(*args))
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexAdditiveQuantizer_search(self, n, x, k, distances, labels, params)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss.IndexAdditiveQuantizer_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexAdditiveQuantizer_sa_decode(self, n, bytes, x)
+
+    def get_FlatCodesDistanceComputer(self):
+        return _swigfaiss.IndexAdditiveQuantizer_get_FlatCodesDistanceComputer(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexAdditiveQuantizer
+
+# Register IndexAdditiveQuantizer in _swigfaiss:
+_swigfaiss.IndexAdditiveQuantizer_swigregister(IndexAdditiveQuantizer)
+class IndexResidualQuantizer(IndexAdditiveQuantizer):
+    r"""
+     Index based on a residual quantizer. Stored vectors are
+    approximated by residual quantization codes.
+    Can also be used as a codec
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rq = property(_swigfaiss.IndexResidualQuantizer_rq_get, _swigfaiss.IndexResidualQuantizer_rq_set, doc=r""" The residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexResidualQuantizer_swiginit(self, _swigfaiss.new_IndexResidualQuantizer(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexResidualQuantizer_train(self, n, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexResidualQuantizer
+
+# Register IndexResidualQuantizer in _swigfaiss:
+_swigfaiss.IndexResidualQuantizer_swigregister(IndexResidualQuantizer)
+class IndexLocalSearchQuantizer(IndexAdditiveQuantizer):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lsq = property(_swigfaiss.IndexLocalSearchQuantizer_lsq_get, _swigfaiss.IndexLocalSearchQuantizer_lsq_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexLocalSearchQuantizer_swiginit(self, _swigfaiss.new_IndexLocalSearchQuantizer(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexLocalSearchQuantizer_train(self, n, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexLocalSearchQuantizer
+
+# Register IndexLocalSearchQuantizer in _swigfaiss:
+_swigfaiss.IndexLocalSearchQuantizer_swigregister(IndexLocalSearchQuantizer)
+class IndexProductResidualQuantizer(IndexAdditiveQuantizer):
+    r""" Index based on a product residual quantizer."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    prq = property(_swigfaiss.IndexProductResidualQuantizer_prq_get, _swigfaiss.IndexProductResidualQuantizer_prq_set, doc=r""" The product residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexProductResidualQuantizer_swiginit(self, _swigfaiss.new_IndexProductResidualQuantizer(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexProductResidualQuantizer_train(self, n, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexProductResidualQuantizer
+
+# Register IndexProductResidualQuantizer in _swigfaiss:
+_swigfaiss.IndexProductResidualQuantizer_swigregister(IndexProductResidualQuantizer)
+class IndexProductLocalSearchQuantizer(IndexAdditiveQuantizer):
+    r""" Index based on a product local search quantizer."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    plsq = property(_swigfaiss.IndexProductLocalSearchQuantizer_plsq_get, _swigfaiss.IndexProductLocalSearchQuantizer_plsq_set, doc=r""" The product local search quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexProductLocalSearchQuantizer_swiginit(self, _swigfaiss.new_IndexProductLocalSearchQuantizer(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexProductLocalSearchQuantizer_train(self, n, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexProductLocalSearchQuantizer
+
+# Register IndexProductLocalSearchQuantizer in _swigfaiss:
+_swigfaiss.IndexProductLocalSearchQuantizer_swigregister(IndexProductLocalSearchQuantizer)
+class AdditiveCoarseQuantizer(Index):
+    r"""
+     A "virtual" index where the elements are the residual quantizer centroids.
+
+    Intended for use as a coarse quantizer in an IndexIVF.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    aq = property(_swigfaiss.AdditiveCoarseQuantizer_aq_get, _swigfaiss.AdditiveCoarseQuantizer_aq_set)
+
+    def __init__(self, *args):
+        _swigfaiss.AdditiveCoarseQuantizer_swiginit(self, _swigfaiss.new_AdditiveCoarseQuantizer(*args))
+    centroid_norms = property(_swigfaiss.AdditiveCoarseQuantizer_centroid_norms_get, _swigfaiss.AdditiveCoarseQuantizer_centroid_norms_set, doc=r""" norms of centroids, useful for knn-search""")
+
+    def add(self, n, x):
+        r""" N/A"""
+        return _swigfaiss.AdditiveCoarseQuantizer_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.AdditiveCoarseQuantizer_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.AdditiveCoarseQuantizer_reconstruct(self, key, recons)
+
+    def train(self, n, x):
+        return _swigfaiss.AdditiveCoarseQuantizer_train(self, n, x)
+
+    def reset(self):
+        r""" N/A"""
+        return _swigfaiss.AdditiveCoarseQuantizer_reset(self)
+    __swig_destroy__ = _swigfaiss.delete_AdditiveCoarseQuantizer
+
+# Register AdditiveCoarseQuantizer in _swigfaiss:
+_swigfaiss.AdditiveCoarseQuantizer_swigregister(AdditiveCoarseQuantizer)
+class SearchParametersResidualCoarseQuantizer(SearchParameters):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    beam_factor = property(_swigfaiss.SearchParametersResidualCoarseQuantizer_beam_factor_get, _swigfaiss.SearchParametersResidualCoarseQuantizer_beam_factor_set)
+    __swig_destroy__ = _swigfaiss.delete_SearchParametersResidualCoarseQuantizer
+
+    def __init__(self):
+        _swigfaiss.SearchParametersResidualCoarseQuantizer_swiginit(self, _swigfaiss.new_SearchParametersResidualCoarseQuantizer())
+
+# Register SearchParametersResidualCoarseQuantizer in _swigfaiss:
+_swigfaiss.SearchParametersResidualCoarseQuantizer_swigregister(SearchParametersResidualCoarseQuantizer)
+class ResidualCoarseQuantizer(AdditiveCoarseQuantizer):
+    r"""
+     The ResidualCoarseQuantizer is a bit specialized compared to the
+    default AdditiveCoarseQuantizer because it can use a beam search
+    at search time (slow but may be useful for very large vocabularies)
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rq = property(_swigfaiss.ResidualCoarseQuantizer_rq_get, _swigfaiss.ResidualCoarseQuantizer_rq_set, doc=r""" The residual quantizer used to encode the vectors""")
+    beam_factor = property(_swigfaiss.ResidualCoarseQuantizer_beam_factor_get, _swigfaiss.ResidualCoarseQuantizer_beam_factor_set, doc=r"""
+    factor between the beam size and the search k
+    if negative, use exact search-to-centroid
+    """)
+
+    def set_beam_factor(self, new_beam_factor):
+        r""" computes centroid norms if required"""
+        return _swigfaiss.ResidualCoarseQuantizer_set_beam_factor(self, new_beam_factor)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.ResidualCoarseQuantizer_search(self, n, x, k, distances, labels, params)
+
+    def initialize_from(self, other):
+        r"""
+         Copy the M first codebook levels from other. Useful to crop a
+        ResidualQuantizer to its first M quantizers.
+        """
+        return _swigfaiss.ResidualCoarseQuantizer_initialize_from(self, other)
+
+    def __init__(self, *args):
+        _swigfaiss.ResidualCoarseQuantizer_swiginit(self, _swigfaiss.new_ResidualCoarseQuantizer(*args))
+    __swig_destroy__ = _swigfaiss.delete_ResidualCoarseQuantizer
+
+# Register ResidualCoarseQuantizer in _swigfaiss:
+_swigfaiss.ResidualCoarseQuantizer_swigregister(ResidualCoarseQuantizer)
+class LocalSearchCoarseQuantizer(AdditiveCoarseQuantizer):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lsq = property(_swigfaiss.LocalSearchCoarseQuantizer_lsq_get, _swigfaiss.LocalSearchCoarseQuantizer_lsq_set, doc=r""" The residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss.LocalSearchCoarseQuantizer_swiginit(self, _swigfaiss.new_LocalSearchCoarseQuantizer(*args))
+    __swig_destroy__ = _swigfaiss.delete_LocalSearchCoarseQuantizer
+
+# Register LocalSearchCoarseQuantizer in _swigfaiss:
+_swigfaiss.LocalSearchCoarseQuantizer_swigregister(LocalSearchCoarseQuantizer)
+class IOReader(object):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    name = property(_swigfaiss.IOReader_name_get, _swigfaiss.IOReader_name_set)
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss.IOReader___call__(self, ptr, size, nitems)
+
+    def fileno(self):
+        return _swigfaiss.IOReader_fileno(self)
+    __swig_destroy__ = _swigfaiss.delete_IOReader
+
+# Register IOReader in _swigfaiss:
+_swigfaiss.IOReader_swigregister(IOReader)
+class IOWriter(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    name = property(_swigfaiss.IOWriter_name_get, _swigfaiss.IOWriter_name_set)
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss.IOWriter___call__(self, ptr, size, nitems)
+
+    def fileno(self):
+        return _swigfaiss.IOWriter_fileno(self)
+    __swig_destroy__ = _swigfaiss.delete_IOWriter
+
+# Register IOWriter in _swigfaiss:
+_swigfaiss.IOWriter_swigregister(IOWriter)
+class VectorIOReader(IOReader):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    data = property(_swigfaiss.VectorIOReader_data_get, _swigfaiss.VectorIOReader_data_set)
+    rp = property(_swigfaiss.VectorIOReader_rp_get, _swigfaiss.VectorIOReader_rp_set)
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss.VectorIOReader___call__(self, ptr, size, nitems)
+
+    def __init__(self):
+        _swigfaiss.VectorIOReader_swiginit(self, _swigfaiss.new_VectorIOReader())
+    __swig_destroy__ = _swigfaiss.delete_VectorIOReader
+
+# Register VectorIOReader in _swigfaiss:
+_swigfaiss.VectorIOReader_swigregister(VectorIOReader)
+class VectorIOWriter(IOWriter):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    data = property(_swigfaiss.VectorIOWriter_data_get, _swigfaiss.VectorIOWriter_data_set)
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss.VectorIOWriter___call__(self, ptr, size, nitems)
+
+    def __init__(self):
+        _swigfaiss.VectorIOWriter_swiginit(self, _swigfaiss.new_VectorIOWriter())
+    __swig_destroy__ = _swigfaiss.delete_VectorIOWriter
+
+# Register VectorIOWriter in _swigfaiss:
+_swigfaiss.VectorIOWriter_swigregister(VectorIOWriter)
+class FileIOReader(IOReader):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    f = property(_swigfaiss.FileIOReader_f_get, _swigfaiss.FileIOReader_f_set)
+    need_close = property(_swigfaiss.FileIOReader_need_close_get, _swigfaiss.FileIOReader_need_close_set)
+
+    def __init__(self, *args):
+        _swigfaiss.FileIOReader_swiginit(self, _swigfaiss.new_FileIOReader(*args))
+    __swig_destroy__ = _swigfaiss.delete_FileIOReader
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss.FileIOReader___call__(self, ptr, size, nitems)
+
+    def fileno(self):
+        return _swigfaiss.FileIOReader_fileno(self)
+
+# Register FileIOReader in _swigfaiss:
+_swigfaiss.FileIOReader_swigregister(FileIOReader)
+class FileIOWriter(IOWriter):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    f = property(_swigfaiss.FileIOWriter_f_get, _swigfaiss.FileIOWriter_f_set)
+    need_close = property(_swigfaiss.FileIOWriter_need_close_get, _swigfaiss.FileIOWriter_need_close_set)
+
+    def __init__(self, *args):
+        _swigfaiss.FileIOWriter_swiginit(self, _swigfaiss.new_FileIOWriter(*args))
+    __swig_destroy__ = _swigfaiss.delete_FileIOWriter
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss.FileIOWriter___call__(self, ptr, size, nitems)
+
+    def fileno(self):
+        return _swigfaiss.FileIOWriter_fileno(self)
+
+# Register FileIOWriter in _swigfaiss:
+_swigfaiss.FileIOWriter_swigregister(FileIOWriter)
+class BufferedIOReader(IOReader):
+    r""" wraps an ioreader to make buffered reads to avoid too small reads"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    reader = property(_swigfaiss.BufferedIOReader_reader_get, _swigfaiss.BufferedIOReader_reader_set)
+    bsz = property(_swigfaiss.BufferedIOReader_bsz_get, _swigfaiss.BufferedIOReader_bsz_set)
+    ofs = property(_swigfaiss.BufferedIOReader_ofs_get, _swigfaiss.BufferedIOReader_ofs_set, doc=r""" offset in input stream""")
+    ofs2 = property(_swigfaiss.BufferedIOReader_ofs2_get, _swigfaiss.BufferedIOReader_ofs2_set, doc=r""" number of bytes returned to caller""")
+    b0 = property(_swigfaiss.BufferedIOReader_b0_get, _swigfaiss.BufferedIOReader_b0_set, doc=r""" range of available bytes in the buffer""")
+    b1 = property(_swigfaiss.BufferedIOReader_b1_get, _swigfaiss.BufferedIOReader_b1_set)
+    buffer = property(_swigfaiss.BufferedIOReader_buffer_get, _swigfaiss.BufferedIOReader_buffer_set)
+
+    def __init__(self, *args):
+        r"""
+        :type bsz: int, optional
+        :param bsz:    buffer size (bytes). Reads will be done by batched of
+                          this size
+        """
+        _swigfaiss.BufferedIOReader_swiginit(self, _swigfaiss.new_BufferedIOReader(*args))
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss.BufferedIOReader___call__(self, ptr, size, nitems)
+    __swig_destroy__ = _swigfaiss.delete_BufferedIOReader
+
+# Register BufferedIOReader in _swigfaiss:
+_swigfaiss.BufferedIOReader_swigregister(BufferedIOReader)
+class BufferedIOWriter(IOWriter):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    writer = property(_swigfaiss.BufferedIOWriter_writer_get, _swigfaiss.BufferedIOWriter_writer_set)
+    bsz = property(_swigfaiss.BufferedIOWriter_bsz_get, _swigfaiss.BufferedIOWriter_bsz_set)
+    ofs = property(_swigfaiss.BufferedIOWriter_ofs_get, _swigfaiss.BufferedIOWriter_ofs_set)
+    ofs2 = property(_swigfaiss.BufferedIOWriter_ofs2_get, _swigfaiss.BufferedIOWriter_ofs2_set, doc=r""" number of bytes received from caller""")
+    b0 = property(_swigfaiss.BufferedIOWriter_b0_get, _swigfaiss.BufferedIOWriter_b0_set, doc=r""" amount of data in buffer""")
+    buffer = property(_swigfaiss.BufferedIOWriter_buffer_get, _swigfaiss.BufferedIOWriter_buffer_set)
+
+    def __init__(self, *args):
+        _swigfaiss.BufferedIOWriter_swiginit(self, _swigfaiss.new_BufferedIOWriter(*args))
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss.BufferedIOWriter___call__(self, ptr, size, nitems)
+    __swig_destroy__ = _swigfaiss.delete_BufferedIOWriter
+
+# Register BufferedIOWriter in _swigfaiss:
+_swigfaiss.BufferedIOWriter_swigregister(BufferedIOWriter)
+
+def fourcc(*args):
+    return _swigfaiss.fourcc(*args)
+
+def fourcc_inv(*args):
+    return _swigfaiss.fourcc_inv(*args)
+
+def fourcc_inv_printable(x):
+    return _swigfaiss.fourcc_inv_printable(x)
+class InvertedListsIterator(object):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+
+    Definition of inverted lists + a few common classes that implement
+    the interface.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    __swig_destroy__ = _swigfaiss.delete_InvertedListsIterator
+
+    def is_available(self):
+        return _swigfaiss.InvertedListsIterator_is_available(self)
+
+    def next(self):
+        return _swigfaiss.InvertedListsIterator_next(self)
+
+    def get_id_and_codes(self):
+        return _swigfaiss.InvertedListsIterator_get_id_and_codes(self)
+
+# Register InvertedListsIterator in _swigfaiss:
+_swigfaiss.InvertedListsIterator_swigregister(InvertedListsIterator)
+class InvertedLists(object):
+    r"""
+     Table of inverted lists
+    multithreading rules:
+    - concurrent read accesses are allowed
+    - concurrent update accesses are allowed
+    - for resize and add_entries, only concurrent access to different lists
+      are allowed
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    nlist = property(_swigfaiss.InvertedLists_nlist_get, _swigfaiss.InvertedLists_nlist_set, doc=r""" number of possible key values""")
+    code_size = property(_swigfaiss.InvertedLists_code_size_get, _swigfaiss.InvertedLists_code_size_set, doc=r""" code size per vector in bytes""")
+    use_iterator = property(_swigfaiss.InvertedLists_use_iterator_get, _swigfaiss.InvertedLists_use_iterator_set)
+    __swig_destroy__ = _swigfaiss.delete_InvertedLists
+    INVALID_CODE_SIZE = _swigfaiss.InvertedLists_INVALID_CODE_SIZE
+    r"""
+    used for BlockInvertedLists, where the codes are packed into groups
+    and the individual code size is meaningless
+    """
+
+    def is_empty(self, list_no, inverted_list_context):
+        return _swigfaiss.InvertedLists_is_empty(self, list_no, inverted_list_context)
+
+    def list_size(self, list_no):
+        r""" get the size of a list"""
+        return _swigfaiss.InvertedLists_list_size(self, list_no)
+
+    def get_iterator(self, list_no, inverted_list_context):
+        r""" get iterable for lists that use_iterator"""
+        return _swigfaiss.InvertedLists_get_iterator(self, list_no, inverted_list_context)
+
+    def get_codes(self, list_no):
+        r"""
+         get the codes for an inverted list
+        must be released by release_codes
+
+        :rtype: uint8_t
+        :return: codes    size list_size * code_size
+        """
+        return _swigfaiss.InvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        r"""
+         get the ids for an inverted list
+        must be released by release_ids
+
+        :rtype: int
+        :return: ids      size list_size
+        """
+        return _swigfaiss.InvertedLists_get_ids(self, list_no)
+
+    def release_codes(self, list_no, codes):
+        r""" release codes returned by get_codes (default implementation is nop"""
+        return _swigfaiss.InvertedLists_release_codes(self, list_no, codes)
+
+    def release_ids(self, list_no, ids):
+        r""" release ids returned by get_ids"""
+        return _swigfaiss.InvertedLists_release_ids(self, list_no, ids)
+
+    def get_single_id(self, list_no, offset):
+        r"""
+        :rtype: int
+        :return: a single id in an inverted list
+        """
+        return _swigfaiss.InvertedLists_get_single_id(self, list_no, offset)
+
+    def get_single_code(self, list_no, offset):
+        r"""
+        :rtype: uint8_t
+        :return: a single code in an inverted list
+            (should be deallocated with release_codes)
+        """
+        return _swigfaiss.InvertedLists_get_single_code(self, list_no, offset)
+
+    def prefetch_lists(self, list_nos, nlist):
+        r"""
+        prepare the following lists (default does nothing)
+        a list can be -1 hence the signed long
+        """
+        return _swigfaiss.InvertedLists_prefetch_lists(self, list_nos, nlist)
+
+    def add_entry(self, list_no, theid, code, inverted_list_context=None):
+        r""" add one entry to an inverted list"""
+        return _swigfaiss.InvertedLists_add_entry(self, list_no, theid, code, inverted_list_context)
+
+    def add_entries(self, list_no, n_entry, ids, code):
+        return _swigfaiss.InvertedLists_add_entries(self, list_no, n_entry, ids, code)
+
+    def update_entry(self, list_no, offset, id, code):
+        return _swigfaiss.InvertedLists_update_entry(self, list_no, offset, id, code)
+
+    def update_entries(self, list_no, offset, n_entry, ids, code):
+        return _swigfaiss.InvertedLists_update_entries(self, list_no, offset, n_entry, ids, code)
+
+    def resize(self, list_no, new_size):
+        return _swigfaiss.InvertedLists_resize(self, list_no, new_size)
+
+    def reset(self):
+        return _swigfaiss.InvertedLists_reset(self)
+
+    def merge_from(self, oivf, add_id):
+        r""" move all entries from oivf (empty on output)"""
+        return _swigfaiss.InvertedLists_merge_from(self, oivf, add_id)
+    SUBSET_TYPE_ID_RANGE = _swigfaiss.InvertedLists_SUBSET_TYPE_ID_RANGE
+    SUBSET_TYPE_ID_MOD = _swigfaiss.InvertedLists_SUBSET_TYPE_ID_MOD
+    SUBSET_TYPE_ELEMENT_RANGE = _swigfaiss.InvertedLists_SUBSET_TYPE_ELEMENT_RANGE
+    SUBSET_TYPE_INVLIST_FRACTION = _swigfaiss.InvertedLists_SUBSET_TYPE_INVLIST_FRACTION
+    SUBSET_TYPE_INVLIST = _swigfaiss.InvertedLists_SUBSET_TYPE_INVLIST
+
+    def copy_subset_to(self, other, subset_type, a1, a2):
+        r"""
+         copy a subset of the entries index to the other index
+        :rtype: int
+        :return: number of entries copied
+        """
+        return _swigfaiss.InvertedLists_copy_subset_to(self, other, subset_type, a1, a2)
+
+    def imbalance_factor(self):
+        r""" 1= perfectly balanced, >1: imbalanced"""
+        return _swigfaiss.InvertedLists_imbalance_factor(self)
+
+    def print_stats(self):
+        r""" display some stats about the inverted lists"""
+        return _swigfaiss.InvertedLists_print_stats(self)
+
+    def compute_ntotal(self):
+        r""" sum up list sizes"""
+        return _swigfaiss.InvertedLists_compute_ntotal(self)
+
+# Register InvertedLists in _swigfaiss:
+_swigfaiss.InvertedLists_swigregister(InvertedLists)
+class ArrayInvertedLists(InvertedLists):
+    r""" simple (default) implementation as an array of inverted lists"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    codes = property(_swigfaiss.ArrayInvertedLists_codes_get, _swigfaiss.ArrayInvertedLists_codes_set)
+    ids = property(_swigfaiss.ArrayInvertedLists_ids_get, _swigfaiss.ArrayInvertedLists_ids_set, doc=r""" Inverted lists for indexes""")
+
+    def __init__(self, nlist, code_size):
+        _swigfaiss.ArrayInvertedLists_swiginit(self, _swigfaiss.new_ArrayInvertedLists(nlist, code_size))
+
+    def list_size(self, list_no):
+        return _swigfaiss.ArrayInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss.ArrayInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss.ArrayInvertedLists_get_ids(self, list_no)
+
+    def add_entries(self, list_no, n_entry, ids, code):
+        return _swigfaiss.ArrayInvertedLists_add_entries(self, list_no, n_entry, ids, code)
+
+    def update_entries(self, list_no, offset, n_entry, ids, code):
+        return _swigfaiss.ArrayInvertedLists_update_entries(self, list_no, offset, n_entry, ids, code)
+
+    def resize(self, list_no, new_size):
+        return _swigfaiss.ArrayInvertedLists_resize(self, list_no, new_size)
+
+    def permute_invlists(self, map):
+        r""" permute the inverted lists, map maps new_id to old_id"""
+        return _swigfaiss.ArrayInvertedLists_permute_invlists(self, map)
+    __swig_destroy__ = _swigfaiss.delete_ArrayInvertedLists
+
+# Register ArrayInvertedLists in _swigfaiss:
+_swigfaiss.ArrayInvertedLists_swigregister(ArrayInvertedLists)
+class ReadOnlyInvertedLists(InvertedLists):
+    r""" invlists that fail for all write functions"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+
+    def add_entries(self, list_no, n_entry, ids, code):
+        return _swigfaiss.ReadOnlyInvertedLists_add_entries(self, list_no, n_entry, ids, code)
+
+    def update_entries(self, list_no, offset, n_entry, ids, code):
+        return _swigfaiss.ReadOnlyInvertedLists_update_entries(self, list_no, offset, n_entry, ids, code)
+
+    def resize(self, list_no, new_size):
+        return _swigfaiss.ReadOnlyInvertedLists_resize(self, list_no, new_size)
+    __swig_destroy__ = _swigfaiss.delete_ReadOnlyInvertedLists
+
+# Register ReadOnlyInvertedLists in _swigfaiss:
+_swigfaiss.ReadOnlyInvertedLists_swigregister(ReadOnlyInvertedLists)
+class HStackInvertedLists(ReadOnlyInvertedLists):
+    r""" Horizontal stack of inverted lists"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    ils = property(_swigfaiss.HStackInvertedLists_ils_get, _swigfaiss.HStackInvertedLists_ils_set)
+
+    def __init__(self, nil, ils):
+        r""" build InvertedLists by concatenating nil of them"""
+        _swigfaiss.HStackInvertedLists_swiginit(self, _swigfaiss.new_HStackInvertedLists(nil, ils))
+
+    def list_size(self, list_no):
+        return _swigfaiss.HStackInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss.HStackInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss.HStackInvertedLists_get_ids(self, list_no)
+
+    def prefetch_lists(self, list_nos, nlist):
+        return _swigfaiss.HStackInvertedLists_prefetch_lists(self, list_nos, nlist)
+
+    def release_codes(self, list_no, codes):
+        return _swigfaiss.HStackInvertedLists_release_codes(self, list_no, codes)
+
+    def release_ids(self, list_no, ids):
+        return _swigfaiss.HStackInvertedLists_release_ids(self, list_no, ids)
+
+    def get_single_id(self, list_no, offset):
+        return _swigfaiss.HStackInvertedLists_get_single_id(self, list_no, offset)
+
+    def get_single_code(self, list_no, offset):
+        return _swigfaiss.HStackInvertedLists_get_single_code(self, list_no, offset)
+    __swig_destroy__ = _swigfaiss.delete_HStackInvertedLists
+
+# Register HStackInvertedLists in _swigfaiss:
+_swigfaiss.HStackInvertedLists_swigregister(HStackInvertedLists)
+class SliceInvertedLists(ReadOnlyInvertedLists):
+    r""" vertical slice of indexes in another InvertedLists"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    il = property(_swigfaiss.SliceInvertedLists_il_get, _swigfaiss.SliceInvertedLists_il_set)
+    i0 = property(_swigfaiss.SliceInvertedLists_i0_get, _swigfaiss.SliceInvertedLists_i0_set)
+    i1 = property(_swigfaiss.SliceInvertedLists_i1_get, _swigfaiss.SliceInvertedLists_i1_set)
+
+    def __init__(self, il, i0, i1):
+        _swigfaiss.SliceInvertedLists_swiginit(self, _swigfaiss.new_SliceInvertedLists(il, i0, i1))
+
+    def list_size(self, list_no):
+        return _swigfaiss.SliceInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss.SliceInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss.SliceInvertedLists_get_ids(self, list_no)
+
+    def release_codes(self, list_no, codes):
+        return _swigfaiss.SliceInvertedLists_release_codes(self, list_no, codes)
+
+    def release_ids(self, list_no, ids):
+        return _swigfaiss.SliceInvertedLists_release_ids(self, list_no, ids)
+
+    def get_single_id(self, list_no, offset):
+        return _swigfaiss.SliceInvertedLists_get_single_id(self, list_no, offset)
+
+    def get_single_code(self, list_no, offset):
+        return _swigfaiss.SliceInvertedLists_get_single_code(self, list_no, offset)
+
+    def prefetch_lists(self, list_nos, nlist):
+        return _swigfaiss.SliceInvertedLists_prefetch_lists(self, list_nos, nlist)
+    __swig_destroy__ = _swigfaiss.delete_SliceInvertedLists
+
+# Register SliceInvertedLists in _swigfaiss:
+_swigfaiss.SliceInvertedLists_swigregister(SliceInvertedLists)
+class VStackInvertedLists(ReadOnlyInvertedLists):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    ils = property(_swigfaiss.VStackInvertedLists_ils_get, _swigfaiss.VStackInvertedLists_ils_set)
+    cumsz = property(_swigfaiss.VStackInvertedLists_cumsz_get, _swigfaiss.VStackInvertedLists_cumsz_set)
+
+    def __init__(self, nil, ils):
+        r""" build InvertedLists by concatenating nil of them"""
+        _swigfaiss.VStackInvertedLists_swiginit(self, _swigfaiss.new_VStackInvertedLists(nil, ils))
+
+    def list_size(self, list_no):
+        return _swigfaiss.VStackInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss.VStackInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss.VStackInvertedLists_get_ids(self, list_no)
+
+    def release_codes(self, list_no, codes):
+        return _swigfaiss.VStackInvertedLists_release_codes(self, list_no, codes)
+
+    def release_ids(self, list_no, ids):
+        return _swigfaiss.VStackInvertedLists_release_ids(self, list_no, ids)
+
+    def get_single_id(self, list_no, offset):
+        return _swigfaiss.VStackInvertedLists_get_single_id(self, list_no, offset)
+
+    def get_single_code(self, list_no, offset):
+        return _swigfaiss.VStackInvertedLists_get_single_code(self, list_no, offset)
+
+    def prefetch_lists(self, list_nos, nlist):
+        return _swigfaiss.VStackInvertedLists_prefetch_lists(self, list_nos, nlist)
+    __swig_destroy__ = _swigfaiss.delete_VStackInvertedLists
+
+# Register VStackInvertedLists in _swigfaiss:
+_swigfaiss.VStackInvertedLists_swigregister(VStackInvertedLists)
+class MaskedInvertedLists(ReadOnlyInvertedLists):
+    r"""
+     use the first inverted lists if they are non-empty otherwise use the second
+
+    This is useful if il1 has a few inverted lists that are too long,
+    and that il0 has replacement lists for those, with empty lists for
+    the others.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    il0 = property(_swigfaiss.MaskedInvertedLists_il0_get, _swigfaiss.MaskedInvertedLists_il0_set)
+    il1 = property(_swigfaiss.MaskedInvertedLists_il1_get, _swigfaiss.MaskedInvertedLists_il1_set)
+
+    def __init__(self, il0, il1):
+        _swigfaiss.MaskedInvertedLists_swiginit(self, _swigfaiss.new_MaskedInvertedLists(il0, il1))
+
+    def list_size(self, list_no):
+        return _swigfaiss.MaskedInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss.MaskedInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss.MaskedInvertedLists_get_ids(self, list_no)
+
+    def release_codes(self, list_no, codes):
+        return _swigfaiss.MaskedInvertedLists_release_codes(self, list_no, codes)
+
+    def release_ids(self, list_no, ids):
+        return _swigfaiss.MaskedInvertedLists_release_ids(self, list_no, ids)
+
+    def get_single_id(self, list_no, offset):
+        return _swigfaiss.MaskedInvertedLists_get_single_id(self, list_no, offset)
+
+    def get_single_code(self, list_no, offset):
+        return _swigfaiss.MaskedInvertedLists_get_single_code(self, list_no, offset)
+
+    def prefetch_lists(self, list_nos, nlist):
+        return _swigfaiss.MaskedInvertedLists_prefetch_lists(self, list_nos, nlist)
+    __swig_destroy__ = _swigfaiss.delete_MaskedInvertedLists
+
+# Register MaskedInvertedLists in _swigfaiss:
+_swigfaiss.MaskedInvertedLists_swigregister(MaskedInvertedLists)
+class StopWordsInvertedLists(ReadOnlyInvertedLists):
+    r"""
+    if the inverted list in il is smaller than maxsize then return it,
+    otherwise return an empty invlist
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    il0 = property(_swigfaiss.StopWordsInvertedLists_il0_get, _swigfaiss.StopWordsInvertedLists_il0_set)
+    maxsize = property(_swigfaiss.StopWordsInvertedLists_maxsize_get, _swigfaiss.StopWordsInvertedLists_maxsize_set)
+
+    def __init__(self, il, maxsize):
+        _swigfaiss.StopWordsInvertedLists_swiginit(self, _swigfaiss.new_StopWordsInvertedLists(il, maxsize))
+
+    def list_size(self, list_no):
+        return _swigfaiss.StopWordsInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss.StopWordsInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss.StopWordsInvertedLists_get_ids(self, list_no)
+
+    def release_codes(self, list_no, codes):
+        return _swigfaiss.StopWordsInvertedLists_release_codes(self, list_no, codes)
+
+    def release_ids(self, list_no, ids):
+        return _swigfaiss.StopWordsInvertedLists_release_ids(self, list_no, ids)
+
+    def get_single_id(self, list_no, offset):
+        return _swigfaiss.StopWordsInvertedLists_get_single_id(self, list_no, offset)
+
+    def get_single_code(self, list_no, offset):
+        return _swigfaiss.StopWordsInvertedLists_get_single_code(self, list_no, offset)
+
+    def prefetch_lists(self, list_nos, nlist):
+        return _swigfaiss.StopWordsInvertedLists_prefetch_lists(self, list_nos, nlist)
+    __swig_destroy__ = _swigfaiss.delete_StopWordsInvertedLists
+
+# Register StopWordsInvertedLists in _swigfaiss:
+_swigfaiss.StopWordsInvertedLists_swigregister(StopWordsInvertedLists)
+class InvertedListsIOHook(object):
+    r"""
+     Callbacks to handle other types of InvertedList objects.
+
+    The callbacks should be registered with add_callback before calling
+    read_index or read_InvertedLists. The callbacks for
+    OnDiskInvertedLists are registrered by default. The invlist type is
+    identified by:
+
+    - the key (a fourcc) at read time
+    - the class name (as given by typeid.name) at write time
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    key = property(_swigfaiss.InvertedListsIOHook_key_get, doc=r""" string version of the fourcc""")
+    classname = property(_swigfaiss.InvertedListsIOHook_classname_get, doc=r""" typeid.name""")
+
+    def write(self, ils, f):
+        r""" write the index to the IOWriter (including the fourcc)"""
+        return _swigfaiss.InvertedListsIOHook_write(self, ils, f)
+
+    def read(self, f, io_flags):
+        r""" called when the fourcc matches this class's fourcc"""
+        return _swigfaiss.InvertedListsIOHook_read(self, f, io_flags)
+
+    def read_ArrayInvertedLists(self, f, io_flags, nlist, code_size, sizes):
+        r"""
+         read from a ArrayInvertedLists into this invertedlist type.
+        For this to work, the callback has to be enabled and the io_flag has to
+        be set to IO_FLAG_SKIP_IVF_DATA | (16 upper bits of the fourcc)
+
+        (default implementation fails)
+        """
+        return _swigfaiss.InvertedListsIOHook_read_ArrayInvertedLists(self, f, io_flags, nlist, code_size, sizes)
+    __swig_destroy__ = _swigfaiss.delete_InvertedListsIOHook
+
+    @staticmethod
+    def add_callback(arg1):
+        return _swigfaiss.InvertedListsIOHook_add_callback(arg1)
+
+    @staticmethod
+    def print_callbacks():
+        return _swigfaiss.InvertedListsIOHook_print_callbacks()
+
+    @staticmethod
+    def lookup(h):
+        return _swigfaiss.InvertedListsIOHook_lookup(h)
+
+    @staticmethod
+    def lookup_classname(classname):
+        return _swigfaiss.InvertedListsIOHook_lookup_classname(classname)
+
+# Register InvertedListsIOHook in _swigfaiss:
+_swigfaiss.InvertedListsIOHook_swigregister(InvertedListsIOHook)
+class BlockInvertedLists(InvertedLists):
+    r"""
+     Inverted Lists that are organized by blocks.
+
+    Different from the regular inverted lists, the codes are organized by blocks
+    of size block_size bytes that reprsent a set of n_per_block. Therefore, code
+    allocations are always rounded up to block_size bytes. The codes are also
+    aligned on 32-byte boundaries for use with SIMD.
+
+    To avoid misinterpretations, the code_size is set to (size_t)(-1), even if
+    arguably the amount of memory consumed by code is block_size / n_per_block.
+
+    The writing functions add_entries and update_entries operate on block-aligned
+    data.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    n_per_block = property(_swigfaiss.BlockInvertedLists_n_per_block_get, _swigfaiss.BlockInvertedLists_n_per_block_set)
+    block_size = property(_swigfaiss.BlockInvertedLists_block_size_get, _swigfaiss.BlockInvertedLists_block_size_set)
+    packer = property(_swigfaiss.BlockInvertedLists_packer_get, _swigfaiss.BlockInvertedLists_packer_set)
+    codes = property(_swigfaiss.BlockInvertedLists_codes_get, _swigfaiss.BlockInvertedLists_codes_set)
+    ids = property(_swigfaiss.BlockInvertedLists_ids_get, _swigfaiss.BlockInvertedLists_ids_set)
+
+    def __init__(self, *args):
+        _swigfaiss.BlockInvertedLists_swiginit(self, _swigfaiss.new_BlockInvertedLists(*args))
+
+    def list_size(self, list_no):
+        return _swigfaiss.BlockInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss.BlockInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss.BlockInvertedLists_get_ids(self, list_no)
+
+    def add_entries(self, list_no, n_entry, ids, code):
+        return _swigfaiss.BlockInvertedLists_add_entries(self, list_no, n_entry, ids, code)
+
+    def update_entries(self, list_no, offset, n_entry, ids, code):
+        r""" not implemented"""
+        return _swigfaiss.BlockInvertedLists_update_entries(self, list_no, offset, n_entry, ids, code)
+
+    def resize(self, list_no, new_size):
+        return _swigfaiss.BlockInvertedLists_resize(self, list_no, new_size)
+    __swig_destroy__ = _swigfaiss.delete_BlockInvertedLists
+
+# Register BlockInvertedLists in _swigfaiss:
+_swigfaiss.BlockInvertedLists_swigregister(BlockInvertedLists)
+
+def lo_build(list_id, offset):
+    return _swigfaiss.lo_build(list_id, offset)
+
+def lo_listno(lo):
+    return _swigfaiss.lo_listno(lo)
+
+def lo_offset(lo):
+    return _swigfaiss.lo_offset(lo)
+class DirectMap(object):
+    r"""Direct map: a way to map back from ids to inverted lists"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    NoMap = _swigfaiss.DirectMap_NoMap
+    Array = _swigfaiss.DirectMap_Array
+    Hashtable = _swigfaiss.DirectMap_Hashtable
+    type = property(_swigfaiss.DirectMap_type_get, _swigfaiss.DirectMap_type_set)
+    array = property(_swigfaiss.DirectMap_array_get, _swigfaiss.DirectMap_array_set, doc=r""" map for direct access to the elements. Map ids to LO-encoded entries.""")
+    hashtable = property(_swigfaiss.DirectMap_hashtable_get, _swigfaiss.DirectMap_hashtable_set)
+
+    def __init__(self):
+        _swigfaiss.DirectMap_swiginit(self, _swigfaiss.new_DirectMap())
+
+    def set_type(self, new_type, invlists, ntotal):
+        r""" set type and initialize"""
+        return _swigfaiss.DirectMap_set_type(self, new_type, invlists, ntotal)
+
+    def get(self, id):
+        r""" get an entry"""
+        return _swigfaiss.DirectMap_get(self, id)
+
+    def no(self):
+        r""" for quick checks"""
+        return _swigfaiss.DirectMap_no(self)
+
+    def check_can_add(self, ids):
+        r"""
+        update the direct_map
+
+         throw if Array and ids is not NULL
+        """
+        return _swigfaiss.DirectMap_check_can_add(self, ids)
+
+    def add_single_id(self, id, list_no, offset):
+        r""" non thread-safe version"""
+        return _swigfaiss.DirectMap_add_single_id(self, id, list_no, offset)
+
+    def clear(self):
+        r""" remove all entries"""
+        return _swigfaiss.DirectMap_clear(self)
+
+    def remove_ids(self, sel, invlists):
+        r"""
+        operations on inverted lists that require translation with a DirectMap
+
+         remove ids from the InvertedLists, possibly using the direct map
+        """
+        return _swigfaiss.DirectMap_remove_ids(self, sel, invlists)
+
+    def update_codes(self, invlists, n, ids, list_nos, codes):
+        r""" update entries, using the direct map"""
+        return _swigfaiss.DirectMap_update_codes(self, invlists, n, ids, list_nos, codes)
+    __swig_destroy__ = _swigfaiss.delete_DirectMap
+
+# Register DirectMap in _swigfaiss:
+_swigfaiss.DirectMap_swigregister(DirectMap)
+class DirectMapAdd(object):
+    r""" Thread-safe way of updating the direct_map"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    direct_map = property(_swigfaiss.DirectMapAdd_direct_map_get, _swigfaiss.DirectMapAdd_direct_map_set)
+    type = property(_swigfaiss.DirectMapAdd_type_get, _swigfaiss.DirectMapAdd_type_set)
+    ntotal = property(_swigfaiss.DirectMapAdd_ntotal_get, _swigfaiss.DirectMapAdd_ntotal_set)
+    n = property(_swigfaiss.DirectMapAdd_n_get, _swigfaiss.DirectMapAdd_n_set)
+    xids = property(_swigfaiss.DirectMapAdd_xids_get, _swigfaiss.DirectMapAdd_xids_set)
+    all_ofs = property(_swigfaiss.DirectMapAdd_all_ofs_get, _swigfaiss.DirectMapAdd_all_ofs_set)
+
+    def __init__(self, direct_map, n, xids):
+        _swigfaiss.DirectMapAdd_swiginit(self, _swigfaiss.new_DirectMapAdd(direct_map, n, xids))
+
+    def add(self, i, list_no, offset):
+        r""" add vector i (with id xids[i]) at list_no and offset"""
+        return _swigfaiss.DirectMapAdd_add(self, i, list_no, offset)
+    __swig_destroy__ = _swigfaiss.delete_DirectMapAdd
+
+# Register DirectMapAdd in _swigfaiss:
+_swigfaiss.DirectMapAdd_swigregister(DirectMapAdd)
+class Level1Quantizer(object):
+    r"""
+     Encapsulates a quantizer object for the IndexIVF
+
+    The class isolates the fields that are independent of the storage
+    of the lists (especially training)
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    quantizer = property(_swigfaiss.Level1Quantizer_quantizer_get, _swigfaiss.Level1Quantizer_quantizer_set, doc=r""" quantizer that maps vectors to inverted lists""")
+    nlist = property(_swigfaiss.Level1Quantizer_nlist_get, _swigfaiss.Level1Quantizer_nlist_set, doc=r""" number of inverted lists""")
+    quantizer_trains_alone = property(_swigfaiss.Level1Quantizer_quantizer_trains_alone_get, _swigfaiss.Level1Quantizer_quantizer_trains_alone_set, doc=r"""
+    = 0: use the quantizer as index in a kmeans training
+    = 1: just pass on the training set to the train() of the quantizer
+    = 2: kmeans training on a flat index + add the centroids to the quantizer
+    """)
+    own_fields = property(_swigfaiss.Level1Quantizer_own_fields_get, _swigfaiss.Level1Quantizer_own_fields_set, doc=r""" whether object owns the quantizer""")
+    cp = property(_swigfaiss.Level1Quantizer_cp_get, _swigfaiss.Level1Quantizer_cp_set, doc=r""" to override default clustering params""")
+    clustering_index = property(_swigfaiss.Level1Quantizer_clustering_index_get, _swigfaiss.Level1Quantizer_clustering_index_set, doc=r""" to override index used during clustering""")
+
+    def train_q1(self, n, x, verbose, metric_type):
+        r""" Trains the quantizer and calls train_residual to train sub-quantizers"""
+        return _swigfaiss.Level1Quantizer_train_q1(self, n, x, verbose, metric_type)
+
+    def coarse_code_size(self):
+        r""" compute the number of bytes required to store list ids"""
+        return _swigfaiss.Level1Quantizer_coarse_code_size(self)
+
+    def encode_listno(self, list_no, code):
+        return _swigfaiss.Level1Quantizer_encode_listno(self, list_no, code)
+
+    def decode_listno(self, code):
+        return _swigfaiss.Level1Quantizer_decode_listno(self, code)
+
+    def __init__(self, *args):
+        _swigfaiss.Level1Quantizer_swiginit(self, _swigfaiss.new_Level1Quantizer(*args))
+    __swig_destroy__ = _swigfaiss.delete_Level1Quantizer
+
+# Register Level1Quantizer in _swigfaiss:
+_swigfaiss.Level1Quantizer_swigregister(Level1Quantizer)
+class SearchParametersIVF(SearchParameters):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nprobe = property(_swigfaiss.SearchParametersIVF_nprobe_get, _swigfaiss.SearchParametersIVF_nprobe_set, doc=r""" number of probes at query time""")
+    max_codes = property(_swigfaiss.SearchParametersIVF_max_codes_get, _swigfaiss.SearchParametersIVF_max_codes_set, doc=r""" max nb of codes to visit to do a query""")
+    quantizer_params = property(_swigfaiss.SearchParametersIVF_quantizer_params_get, _swigfaiss.SearchParametersIVF_quantizer_params_set)
+    inverted_list_context = property(_swigfaiss.SearchParametersIVF_inverted_list_context_get, _swigfaiss.SearchParametersIVF_inverted_list_context_set, doc=r""" context object to pass to InvertedLists""")
+    __swig_destroy__ = _swigfaiss.delete_SearchParametersIVF
+
+    def __init__(self):
+        _swigfaiss.SearchParametersIVF_swiginit(self, _swigfaiss.new_SearchParametersIVF())
+
+# Register SearchParametersIVF in _swigfaiss:
+_swigfaiss.SearchParametersIVF_swigregister(SearchParametersIVF)
+class IndexIVFInterface(Level1Quantizer):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    nprobe = property(_swigfaiss.IndexIVFInterface_nprobe_get, _swigfaiss.IndexIVFInterface_nprobe_set, doc=r""" number of probes at query time""")
+    max_codes = property(_swigfaiss.IndexIVFInterface_max_codes_get, _swigfaiss.IndexIVFInterface_max_codes_set, doc=r""" max nb of codes to visit to do a query""")
+
+    def search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params=None, stats=None):
+        r"""
+         search a set of vectors, that are pre-quantized by the IVF
+         quantizer. Fill in the corresponding heaps with the query
+         results. The default implementation uses InvertedListScanners
+         to do the search.
+
+        :type n: int
+        :param n:      nb of vectors to query
+        :type x: float
+        :param x:      query vectors, size nx * d
+        :type assign: int
+        :param assign: coarse quantization indices, size nx * nprobe
+        :type centroid_dis: float
+        :param centroid_dis:
+                          distances to coarse centroids, size nx * nprobe
+        :param distance:
+                          output distances, size n * k
+        :type labels: int
+        :param labels: output labels, size n * k
+        :type store_pairs: boolean
+        :param store_pairs: store inv list index + inv list offset
+                                instead in upper/lower 32 bit of result,
+                                instead of ids (used for reranking).
+        :type params: :py:class:`IVFSearchParameters`, optional
+        :param params: used to override the object's search parameters
+        :type stats: :py:class:`IndexIVFStats`, optional
+        :param stats:  search stats to be updated (can be null)
+        """
+        return _swigfaiss.IndexIVFInterface_search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params, stats)
+
+    def range_search_preassigned(self, nx, x, radius, keys, coarse_dis, result, store_pairs=False, params=None, stats=None):
+        r"""
+         Range search a set of vectors, that are pre-quantized by the IVF
+         quantizer. Fill in the RangeSearchResults results. The default
+        implementation uses InvertedListScanners to do the search.
+
+        :param n:      nb of vectors to query
+        :type x: float
+        :param x:      query vectors, size nx * d
+        :param assign: coarse quantization indices, size nx * nprobe
+        :param centroid_dis:
+                          distances to coarse centroids, size nx * nprobe
+        :type result: :py:class:`RangeSearchResult`
+        :param result: Output results
+        :type store_pairs: boolean, optional
+        :param store_pairs: store inv list index + inv list offset
+                                instead in upper/lower 32 bit of result,
+                                instead of ids (used for reranking).
+        :type params: :py:class:`IVFSearchParameters`, optional
+        :param params: used to override the object's search parameters
+        :type stats: :py:class:`IndexIVFStats`, optional
+        :param stats:  search stats to be updated (can be null)
+        """
+        return _swigfaiss.IndexIVFInterface_range_search_preassigned(self, nx, x, radius, keys, coarse_dis, result, store_pairs, params, stats)
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFInterface
+
+# Register IndexIVFInterface in _swigfaiss:
+_swigfaiss.IndexIVFInterface_swigregister(IndexIVFInterface)
+class IndexIVF(Index, IndexIVFInterface):
+    r"""
+     Index based on a inverted file (IVF)
+
+    In the inverted file, the quantizer (an Index instance) provides a
+    quantization index for each vector to be added. The quantization
+    index maps to a list (aka inverted list or posting list), where the
+    id of the vector is stored.
+
+    The inverted list object is required only after trainng. If none is
+    set externally, an ArrayInvertedLists is used automatically.
+
+    At search time, the vector to be searched is also quantized, and
+    only the list corresponding to the quantization index is
+    searched. This speeds up the search by making it
+    non-exhaustive. This can be relaxed using multi-probe search: a few
+    (nprobe) quantization indices are selected and several inverted
+    lists are visited.
+
+    Sub-classes implement a post-filtering of the index that refines
+    the distance estimation from the query to databse vectors.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    invlists = property(_swigfaiss.IndexIVF_invlists_get, _swigfaiss.IndexIVF_invlists_set, doc=r""" Access to the actual data""")
+    own_invlists = property(_swigfaiss.IndexIVF_own_invlists_get, _swigfaiss.IndexIVF_own_invlists_set)
+    code_size = property(_swigfaiss.IndexIVF_code_size_get, _swigfaiss.IndexIVF_code_size_set, doc=r""" code size per vector in bytes""")
+    parallel_mode = property(_swigfaiss.IndexIVF_parallel_mode_get, _swigfaiss.IndexIVF_parallel_mode_set, doc=r"""
+     Parallel mode determines how queries are parallelized with OpenMP
+
+    0 (default): split over queries
+    1: parallelize over inverted lists
+    2: parallelize over both
+    3: split over queries with a finer granularity
+
+    PARALLEL_MODE_NO_HEAP_INIT: binary or with the previous to
+    prevent the heap to be initialized and finalized
+    """)
+    PARALLEL_MODE_NO_HEAP_INIT = property(_swigfaiss.IndexIVF_PARALLEL_MODE_NO_HEAP_INIT_get)
+    direct_map = property(_swigfaiss.IndexIVF_direct_map_get, _swigfaiss.IndexIVF_direct_map_set, doc=r"""
+    optional map that maps back ids to invlist entries. This
+    enables reconstruct()
+    """)
+    by_residual = property(_swigfaiss.IndexIVF_by_residual_get, _swigfaiss.IndexIVF_by_residual_set, doc=r"""
+    do the codes in the invlists encode the vectors relative to the
+    centroids?
+    """)
+
+    def reset(self):
+        return _swigfaiss.IndexIVF_reset(self)
+
+    def train(self, n, x):
+        r""" Trains the quantizer and calls train_encoder to train sub-quantizers"""
+        return _swigfaiss.IndexIVF_train(self, n, x)
+
+    def add(self, n, x):
+        r""" Calls add_with_ids with NULL ids"""
+        return _swigfaiss.IndexIVF_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        r""" default implementation that calls encode_vectors"""
+        return _swigfaiss.IndexIVF_add_with_ids(self, n, x, xids)
+
+    def add_core(self, n, x, xids, precomputed_idx, inverted_list_context=None):
+        r"""
+         Implementation of vector addition where the vector assignments are
+        predefined. The default implementation hands over the code extraction to
+        encode_vectors.
+
+        :type precomputed_idx: int
+        :param precomputed_idx:    quantization indices for the input vectors
+            (size n)
+        """
+        return _swigfaiss.IndexIVF_add_core(self, n, x, xids, precomputed_idx, inverted_list_context)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listno=False):
+        r"""
+         Encodes a set of vectors as they would appear in the inverted lists
+
+        :type list_nos: int
+        :param list_nos:   inverted list ids as returned by the
+                              quantizer (size n). -1s are ignored.
+        :type codes: uint8_t
+        :param codes:      output codes, size n * code_size
+        :type include_listno: boolean, optional
+        :param include_listno:
+                              include the list ids in the code (in this case add
+                              ceil(log8(nlist)) to the code size)
+        """
+        return _swigfaiss.IndexIVF_encode_vectors(self, n, x, list_nos, codes, include_listno)
+
+    def add_sa_codes(self, n, codes, xids):
+        r"""
+         Add vectors that are computed with the standalone codec
+
+        :type codes: uint8_t
+        :param codes:  codes to add size n * sa_code_size()
+        :type xids: int
+        :param xids:   corresponding ids, size n
+        """
+        return _swigfaiss.IndexIVF_add_sa_codes(self, n, codes, xids)
+
+    def train_encoder(self, n, x, assign):
+        r"""
+         Train the encoder for the vectors.
+
+        If by_residual then it is called with residuals and corresponding assign
+        array, otherwise x is the raw training vectors and assign=nullptr
+        """
+        return _swigfaiss.IndexIVF_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        r"""
+        can be redefined by subclasses to indicate how many training vectors
+        they need
+        """
+        return _swigfaiss.IndexIVF_train_encoder_num_vectors(self)
+
+    def search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params=None, stats=None):
+        return _swigfaiss.IndexIVF_search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params, stats)
+
+    def range_search_preassigned(self, nx, x, radius, keys, coarse_dis, result, store_pairs=False, params=None, stats=None):
+        return _swigfaiss.IndexIVF_range_search_preassigned(self, nx, x, radius, keys, coarse_dis, result, store_pairs, params, stats)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" assign the vectors, then call search_preassign"""
+        return _swigfaiss.IndexIVF_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss.IndexIVF_range_search(self, n, x, radius, result, params)
+
+    def get_InvertedListScanner(self, store_pairs=False, sel=None):
+        r"""
+         Get a scanner for this index (store_pairs means ignore labels)
+
+        The default search implementation uses this to compute the distances
+        """
+        return _swigfaiss.IndexIVF_get_InvertedListScanner(self, store_pairs, sel)
+
+    def reconstruct(self, key, recons):
+        r""" reconstruct a vector. Works only if maintain_direct_map is set to 1 or 2"""
+        return _swigfaiss.IndexIVF_reconstruct(self, key, recons)
+
+    def update_vectors(self, nv, idx, v):
+        r"""
+         Update a subset of vectors.
+
+        The index must have a direct_map
+
+        :type nv: int
+        :param nv:     nb of vectors to update
+        :type idx: int
+        :param idx:    vector indices to update, size nv
+        :type v: float
+        :param v:      vectors of new values, size nv*d
+        """
+        return _swigfaiss.IndexIVF_update_vectors(self, nv, idx, v)
+
+    def reconstruct_n(self, i0, ni, recons):
+        r"""
+         Reconstruct a subset of the indexed vectors.
+
+        Overrides default implementation to bypass reconstruct() which requires
+        direct_map to be maintained.
+
+        :type i0: int
+        :param i0:     first vector to reconstruct
+        :type ni: int
+        :param ni:     nb of vectors to reconstruct
+        :type recons: float
+        :param recons: output array of reconstructed vectors, size ni * d
+        """
+        return _swigfaiss.IndexIVF_reconstruct_n(self, i0, ni, recons)
+
+    def search_and_reconstruct(self, n, x, k, distances, labels, recons, params=None):
+        r"""
+         Similar to search, but also reconstructs the stored vectors (or an
+        approximation in the case of lossy coding) for the search results.
+
+        Overrides default implementation to avoid having to maintain direct_map
+        and instead fetch the code offsets through the `store_pairs` flag in
+        search_preassigned().
+
+        :type recons: float
+        :param recons:      reconstructed vectors size (n, k, d)
+        """
+        return _swigfaiss.IndexIVF_search_and_reconstruct(self, n, x, k, distances, labels, recons, params)
+
+    def search_and_return_codes(self, n, x, k, distances, labels, recons, include_listno=False, params=None):
+        r"""
+         Similar to search, but also returns the codes corresponding to the
+        stored vectors for the search results.
+
+        :param codes:      codes (n, k, code_size)
+        :type include_listno: boolean, optional
+        :param include_listno:
+                              include the list ids in the code (in this case add
+                              ceil(log8(nlist)) to the code size)
+        """
+        return _swigfaiss.IndexIVF_search_and_return_codes(self, n, x, k, distances, labels, recons, include_listno, params)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        r"""
+         Reconstruct a vector given the location in terms of (inv list index +
+        inv list offset) instead of the id.
+
+        Useful for reconstructing when the direct_map is not maintained and
+        the inv list offset is computed by search_preassigned() with
+        `store_pairs` set.
+        """
+        return _swigfaiss.IndexIVF_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def remove_ids(self, sel):
+        r""" Dataset manipulation functions"""
+        return _swigfaiss.IndexIVF_remove_ids(self, sel)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss.IndexIVF_check_compatible_for_merge(self, otherIndex)
+
+    def merge_from(self, otherIndex, add_id):
+        return _swigfaiss.IndexIVF_merge_from(self, otherIndex, add_id)
+
+    def get_CodePacker(self):
+        return _swigfaiss.IndexIVF_get_CodePacker(self)
+
+    def copy_subset_to(self, other, subset_type, a1, a2):
+        r"""
+         copy a subset of the entries index to the other index
+        see Invlists::copy_subset_to for the meaning of subset_type
+        """
+        return _swigfaiss.IndexIVF_copy_subset_to(self, other, subset_type, a1, a2)
+    __swig_destroy__ = _swigfaiss.delete_IndexIVF
+
+    def get_list_size(self, list_no):
+        return _swigfaiss.IndexIVF_get_list_size(self, list_no)
+
+    def check_ids_sorted(self):
+        r""" are the ids sorted?"""
+        return _swigfaiss.IndexIVF_check_ids_sorted(self)
+
+    def make_direct_map(self, new_maintain_direct_map=True):
+        r"""
+         initialize a direct map
+
+        :type new_maintain_direct_map: boolean, optional
+        :param new_maintain_direct_map:    if true, create a direct map,
+                                              else clear it
+        """
+        return _swigfaiss.IndexIVF_make_direct_map(self, new_maintain_direct_map)
+
+    def set_direct_map_type(self, type):
+        return _swigfaiss.IndexIVF_set_direct_map_type(self, type)
+
+    def replace_invlists(self, il, own=False):
+        r""" replace the inverted lists, old one is deallocated if own_invlists"""
+        return _swigfaiss.IndexIVF_replace_invlists(self, il, own)
+
+    def sa_code_size(self):
+        return _swigfaiss.IndexIVF_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss.IndexIVF_sa_encode(self, n, x, bytes)
+
+# Register IndexIVF in _swigfaiss:
+_swigfaiss.IndexIVF_swigregister(IndexIVF)
+class InvertedListScanner(object):
+    r"""
+     Object that handles a query. The inverted lists to scan are
+    provided externally. The object has a lot of state, but
+    distance_to_code and scan_codes can be called in multiple
+    threads
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    list_no = property(_swigfaiss.InvertedListScanner_list_no_get, _swigfaiss.InvertedListScanner_list_no_set, doc=r""" remember current list""")
+    keep_max = property(_swigfaiss.InvertedListScanner_keep_max_get, _swigfaiss.InvertedListScanner_keep_max_set, doc=r""" keep maximum instead of minimum""")
+    store_pairs = property(_swigfaiss.InvertedListScanner_store_pairs_get, _swigfaiss.InvertedListScanner_store_pairs_set, doc=r""" store positions in invlists rather than labels""")
+    sel = property(_swigfaiss.InvertedListScanner_sel_get, _swigfaiss.InvertedListScanner_sel_set, doc=r""" search in this subset of ids""")
+    code_size = property(_swigfaiss.InvertedListScanner_code_size_get, _swigfaiss.InvertedListScanner_code_size_set, doc=r""" used in default implementation of scan_codes""")
+
+    def set_query(self, query_vector):
+        r""" from now on we handle this query."""
+        return _swigfaiss.InvertedListScanner_set_query(self, query_vector)
+
+    def set_list(self, list_no, coarse_dis):
+        r""" following codes come from this inverted list"""
+        return _swigfaiss.InvertedListScanner_set_list(self, list_no, coarse_dis)
+
+    def distance_to_code(self, code):
+        r""" compute a single query-to-code distance"""
+        return _swigfaiss.InvertedListScanner_distance_to_code(self, code)
+
+    def scan_codes(self, n, codes, ids, distances, labels, k):
+        r"""
+         scan a set of codes, compute distances to current query and
+        update heap of results if necessary. Default implemetation
+        calls distance_to_code.
+
+        :type n: int
+        :param n:      number of codes to scan
+        :type codes: uint8_t
+        :param codes:  codes to scan (n * code_size)
+        :type ids: int
+        :param ids:        corresponding ids (ignored if store_pairs)
+        :type distances: float
+        :param distances:  heap distances (size k)
+        :type labels: int
+        :param labels:     heap labels (size k)
+        :type k: int
+        :param k:          heap size
+        :rtype: int
+        :return: number of heap updates performed
+        """
+        return _swigfaiss.InvertedListScanner_scan_codes(self, n, codes, ids, distances, labels, k)
+
+    def iterate_codes(self, iterator, distances, labels, k, list_size):
+        return _swigfaiss.InvertedListScanner_iterate_codes(self, iterator, distances, labels, k, list_size)
+
+    def scan_codes_range(self, n, codes, ids, radius, result):
+        r"""
+         scan a set of codes, compute distances to current query and
+        update results if distances are below radius
+
+        (default implementation fails)
+        """
+        return _swigfaiss.InvertedListScanner_scan_codes_range(self, n, codes, ids, radius, result)
+
+    def iterate_codes_range(self, iterator, radius, result, list_size):
+        return _swigfaiss.InvertedListScanner_iterate_codes_range(self, iterator, radius, result, list_size)
+    __swig_destroy__ = _swigfaiss.delete_InvertedListScanner
+
+# Register InvertedListScanner in _swigfaiss:
+_swigfaiss.InvertedListScanner_swigregister(InvertedListScanner)
+class IndexIVFStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss.IndexIVFStats_nq_get, _swigfaiss.IndexIVFStats_nq_set)
+    nlist = property(_swigfaiss.IndexIVFStats_nlist_get, _swigfaiss.IndexIVFStats_nlist_set)
+    ndis = property(_swigfaiss.IndexIVFStats_ndis_get, _swigfaiss.IndexIVFStats_ndis_set)
+    nheap_updates = property(_swigfaiss.IndexIVFStats_nheap_updates_get, _swigfaiss.IndexIVFStats_nheap_updates_set)
+    quantization_time = property(_swigfaiss.IndexIVFStats_quantization_time_get, _swigfaiss.IndexIVFStats_quantization_time_set)
+    search_time = property(_swigfaiss.IndexIVFStats_search_time_get, _swigfaiss.IndexIVFStats_search_time_set)
+
+    def __init__(self):
+        _swigfaiss.IndexIVFStats_swiginit(self, _swigfaiss.new_IndexIVFStats())
+
+    def reset(self):
+        return _swigfaiss.IndexIVFStats_reset(self)
+
+    def add(self, other):
+        return _swigfaiss.IndexIVFStats_add(self, other)
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFStats
+
+# Register IndexIVFStats in _swigfaiss:
+_swigfaiss.IndexIVFStats_swigregister(IndexIVFStats)
+
+def check_compatible_for_merge(index1, index2):
+    r"""
+     check if two indexes have the same parameters and are trained in
+    the same way, otherwise throw.
+    """
+    return _swigfaiss.check_compatible_for_merge(index1, index2)
+
+def extract_index_ivf(*args):
+    return _swigfaiss.extract_index_ivf(*args)
+
+def try_extract_index_ivf(*args):
+    return _swigfaiss.try_extract_index_ivf(*args)
+
+def merge_into(index0, index1, shift_ids):
+    r"""
+     Merge index1 into index0. Works on IndexIVF's and IndexIVF's
+     embedded in a IndexPreTransform. On output, the index1 is empty.
+
+    :type shift_ids: boolean
+    :param shift_ids:: translate the ids from index1 to index0->prev_ntotal
+    """
+    return _swigfaiss.merge_into(index0, index1, shift_ids)
+
+def search_centroid(index, x, n, centroid_ids):
+    return _swigfaiss.search_centroid(index, x, n, centroid_ids)
+
+def search_and_return_centroids(index, n, xin, k, distances, labels, query_centroid_ids, result_centroid_ids):
+    return _swigfaiss.search_and_return_centroids(index, n, xin, k, distances, labels, query_centroid_ids, result_centroid_ids)
+class SlidingIndexWindow(object):
+    r"""
+     A set of IndexIVFs concatenated together in a FIFO fashion.
+    at each "step", the oldest index slice is removed and a new index is added.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    index = property(_swigfaiss.SlidingIndexWindow_index_get, _swigfaiss.SlidingIndexWindow_index_set, doc=r""" common index that contains the sliding window""")
+    ils = property(_swigfaiss.SlidingIndexWindow_ils_get, _swigfaiss.SlidingIndexWindow_ils_set, doc=r""" InvertedLists of index""")
+    n_slice = property(_swigfaiss.SlidingIndexWindow_n_slice_get, _swigfaiss.SlidingIndexWindow_n_slice_set, doc=r""" number of slices currently in index""")
+    nlist = property(_swigfaiss.SlidingIndexWindow_nlist_get, _swigfaiss.SlidingIndexWindow_nlist_set, doc=r""" same as index->nlist""")
+    sizes = property(_swigfaiss.SlidingIndexWindow_sizes_get, _swigfaiss.SlidingIndexWindow_sizes_set, doc=r""" cumulative list sizes at each slice""")
+
+    def __init__(self, index):
+        r""" index should be initially empty and trained"""
+        _swigfaiss.SlidingIndexWindow_swiginit(self, _swigfaiss.new_SlidingIndexWindow(index))
+
+    def step(self, sub_index, remove_oldest):
+        r"""
+         Add one index to the current index and remove the oldest one.
+
+        :type sub_index: :py:class:`Index`
+        :param sub_index:        slice to swap in (can be NULL)
+        :type remove_oldest: boolean
+        :param remove_oldest:    if true, remove the oldest slices
+        """
+        return _swigfaiss.SlidingIndexWindow_step(self, sub_index, remove_oldest)
+    __swig_destroy__ = _swigfaiss.delete_SlidingIndexWindow
+
+# Register SlidingIndexWindow in _swigfaiss:
+_swigfaiss.SlidingIndexWindow_swigregister(SlidingIndexWindow)
+
+def get_invlist_range(index, i0, i1):
+    r""" Get a subset of inverted lists [i0, i1)"""
+    return _swigfaiss.get_invlist_range(index, i0, i1)
+
+def set_invlist_range(index, i0, i1, src):
+    r""" Set a subset of inverted lists"""
+    return _swigfaiss.set_invlist_range(index, i0, i1, src)
+
+def search_with_parameters(index, n, x, k, distances, labels, params, nb_dis=None, ms_per_stage=None):
+    r"""
+     search an IndexIVF, possibly embedded in an IndexPreTransform with
+    given parameters. This is a way to set the nprobe and get
+    statdistics in a thread-safe way.
+
+    Optionally returns (if non-nullptr):
+    - nb_dis: number of distances computed
+    - ms_per_stage: [0]: preprocessing time
+                    [1]: coarse quantization,
+                    [2]: list scanning
+    """
+    return _swigfaiss.search_with_parameters(index, n, x, k, distances, labels, params, nb_dis, ms_per_stage)
+
+def range_search_with_parameters(index, n, x, radius, result, params, nb_dis=None, ms_per_stage=None):
+    r""" same as search_with_parameters but for range search"""
+    return _swigfaiss.range_search_with_parameters(index, n, x, radius, result, params, nb_dis, ms_per_stage)
+
+def ivf_residual_from_quantizer(arg1, nlevel):
+    r"""
+     Build an IndexIVFResidualQuantizer from an ResidualQuantizer, using the
+    nlevel first components as coarse quantizer and the rest as codes in invlists
+    """
+    return _swigfaiss.ivf_residual_from_quantizer(arg1, nlevel)
+
+def ivf_residual_add_from_flat_codes(ivfrq, ncode, codes, code_size=-1):
+    r"""
+     add from codes. NB that the norm component is not used, so the code_size can
+    be provided.
+
+    :type ivfrq: :py:class:`IndexIVFResidualQuantizer`
+    :param ivfrq:      index to populate with the codes
+    :type codes: uint8_t
+    :param codes:      codes to add, size (ncode, code_size)
+    :type code_size: int, optional
+    :param code_size:  override the ivfrq's code_size, useful if the norm encoding
+                          is different
+    """
+    return _swigfaiss.ivf_residual_add_from_flat_codes(ivfrq, ncode, codes, code_size)
+class ScalarQuantizer(Quantizer):
+    r"""
+    The uniform quantizer has a range [vmin, vmax]. The range can be
+    the same for all dimensions (uniform) or specific per dimension
+    (default).
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    QT_8bit = _swigfaiss.ScalarQuantizer_QT_8bit
+    r""" 8 bits per component"""
+    QT_4bit = _swigfaiss.ScalarQuantizer_QT_4bit
+    r""" 4 bits per component"""
+    QT_8bit_uniform = _swigfaiss.ScalarQuantizer_QT_8bit_uniform
+    r""" same, shared range for all dimensions"""
+    QT_4bit_uniform = _swigfaiss.ScalarQuantizer_QT_4bit_uniform
+    QT_fp16 = _swigfaiss.ScalarQuantizer_QT_fp16
+    QT_8bit_direct = _swigfaiss.ScalarQuantizer_QT_8bit_direct
+    r""" fast indexing of uint8s"""
+    QT_6bit = _swigfaiss.ScalarQuantizer_QT_6bit
+    r""" 6 bits per component"""
+    qtype = property(_swigfaiss.ScalarQuantizer_qtype_get, _swigfaiss.ScalarQuantizer_qtype_set)
+    RS_minmax = _swigfaiss.ScalarQuantizer_RS_minmax
+    r""" [min - rs*(max-min), max + rs*(max-min)]"""
+    RS_meanstd = _swigfaiss.ScalarQuantizer_RS_meanstd
+    r""" [mean - std * rs, mean + std * rs]"""
+    RS_quantiles = _swigfaiss.ScalarQuantizer_RS_quantiles
+    r""" [Q(rs), Q(1-rs)]"""
+    RS_optim = _swigfaiss.ScalarQuantizer_RS_optim
+    r""" alternate optimization of reconstruction error"""
+    rangestat = property(_swigfaiss.ScalarQuantizer_rangestat_get, _swigfaiss.ScalarQuantizer_rangestat_set)
+    rangestat_arg = property(_swigfaiss.ScalarQuantizer_rangestat_arg_get, _swigfaiss.ScalarQuantizer_rangestat_arg_set)
+    bits = property(_swigfaiss.ScalarQuantizer_bits_get, _swigfaiss.ScalarQuantizer_bits_set, doc=r""" bits per scalar code""")
+    trained = property(_swigfaiss.ScalarQuantizer_trained_get, _swigfaiss.ScalarQuantizer_trained_set, doc=r""" trained values (including the range)""")
+
+    def __init__(self, *args):
+        _swigfaiss.ScalarQuantizer_swiginit(self, _swigfaiss.new_ScalarQuantizer(*args))
+
+    def set_derived_sizes(self):
+        r""" updates internal values based on qtype and d"""
+        return _swigfaiss.ScalarQuantizer_set_derived_sizes(self)
+
+    def train(self, n, x):
+        return _swigfaiss.ScalarQuantizer_train(self, n, x)
+
+    def compute_codes(self, x, codes, n):
+        r"""
+         Encode a set of vectors
+
+        :type x: float
+        :param x:      vectors to encode, size n * d
+        :type codes: uint8_t
+        :param codes:  output codes, size n * code_size
+        """
+        return _swigfaiss.ScalarQuantizer_compute_codes(self, x, codes, n)
+
+    def decode(self, code, x, n):
+        r"""
+         Decode a set of vectors
+
+        :param codes:  codes to decode, size n * code_size
+        :type x: float
+        :param x:      output vectors, size n * d
+        """
+        return _swigfaiss.ScalarQuantizer_decode(self, code, x, n)
+
+    def select_quantizer(self):
+        return _swigfaiss.ScalarQuantizer_select_quantizer(self)
+
+    def get_distance_computer(self, *args):
+        return _swigfaiss.ScalarQuantizer_get_distance_computer(self, *args)
+
+    def select_InvertedListScanner(self, mt, quantizer, store_pairs, sel, by_residual=False):
+        return _swigfaiss.ScalarQuantizer_select_InvertedListScanner(self, mt, quantizer, store_pairs, sel, by_residual)
+    __swig_destroy__ = _swigfaiss.delete_ScalarQuantizer
+
+# Register ScalarQuantizer in _swigfaiss:
+_swigfaiss.ScalarQuantizer_swigregister(ScalarQuantizer)
+class IndexScalarQuantizer(IndexFlatCodes):
+    r"""Flat index built on a scalar quantizer."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    sq = property(_swigfaiss.IndexScalarQuantizer_sq_get, _swigfaiss.IndexScalarQuantizer_sq_set, doc=r""" Used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexScalarQuantizer_swiginit(self, _swigfaiss.new_IndexScalarQuantizer(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexScalarQuantizer_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexScalarQuantizer_search(self, n, x, k, distances, labels, params)
+
+    def get_FlatCodesDistanceComputer(self):
+        return _swigfaiss.IndexScalarQuantizer_get_FlatCodesDistanceComputer(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss.IndexScalarQuantizer_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexScalarQuantizer_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexScalarQuantizer
+
+# Register IndexScalarQuantizer in _swigfaiss:
+_swigfaiss.IndexScalarQuantizer_swigregister(IndexScalarQuantizer)
+class IndexIVFScalarQuantizer(IndexIVF):
+    r"""
+     An IVF implementation where the components of the residuals are
+    encoded with a scalar quantizer. All distance computations
+    are asymmetric, so the encoded vectors are decoded and approximate
+    distances are computed.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    sq = property(_swigfaiss.IndexIVFScalarQuantizer_sq_get, _swigfaiss.IndexIVFScalarQuantizer_sq_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFScalarQuantizer_swiginit(self, _swigfaiss.new_IndexIVFScalarQuantizer(*args))
+
+    def train_encoder(self, n, x, assign):
+        return _swigfaiss.IndexIVFScalarQuantizer_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        return _swigfaiss.IndexIVFScalarQuantizer_train_encoder_num_vectors(self)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listnos=False):
+        return _swigfaiss.IndexIVFScalarQuantizer_encode_vectors(self, n, x, list_nos, codes, include_listnos)
+
+    def add_core(self, n, x, xids, precomputed_idx, inverted_list_context=None):
+        return _swigfaiss.IndexIVFScalarQuantizer_add_core(self, n, x, xids, precomputed_idx, inverted_list_context)
+
+    def get_InvertedListScanner(self, store_pairs, sel):
+        return _swigfaiss.IndexIVFScalarQuantizer_get_InvertedListScanner(self, store_pairs, sel)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        return _swigfaiss.IndexIVFScalarQuantizer_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexIVFScalarQuantizer_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFScalarQuantizer
+
+# Register IndexIVFScalarQuantizer in _swigfaiss:
+_swigfaiss.IndexIVFScalarQuantizer_swigregister(IndexIVFScalarQuantizer)
+class IndexIVFSpectralHash(IndexIVF):
+    r"""
+     Inverted list that stores binary codes of size nbit. Before the
+    binary conversion, the dimension of the vectors is transformed from
+    dim d into dim nbit by vt (a random rotation by default).
+
+    Each coordinate is subtracted from a value determined by
+    threshold_type, and split into intervals of size period. Half of
+    the interval is a 0 bit, the other half a 1.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    vt = property(_swigfaiss.IndexIVFSpectralHash_vt_get, _swigfaiss.IndexIVFSpectralHash_vt_set, doc=r""" transformation from d to nbit dim""")
+    own_fields = property(_swigfaiss.IndexIVFSpectralHash_own_fields_get, _swigfaiss.IndexIVFSpectralHash_own_fields_set, doc=r""" own the vt""")
+    nbit = property(_swigfaiss.IndexIVFSpectralHash_nbit_get, _swigfaiss.IndexIVFSpectralHash_nbit_set, doc=r""" nb of bits of the binary signature""")
+    period = property(_swigfaiss.IndexIVFSpectralHash_period_get, _swigfaiss.IndexIVFSpectralHash_period_set, doc=r""" interval size for 0s and 1s""")
+    Thresh_global = _swigfaiss.IndexIVFSpectralHash_Thresh_global
+    r""" global threshold at 0"""
+    Thresh_centroid = _swigfaiss.IndexIVFSpectralHash_Thresh_centroid
+    r""" compare to centroid"""
+    Thresh_centroid_half = _swigfaiss.IndexIVFSpectralHash_Thresh_centroid_half
+    r""" central interval around centroid"""
+    Thresh_median = _swigfaiss.IndexIVFSpectralHash_Thresh_median
+    r""" median of training set"""
+    threshold_type = property(_swigfaiss.IndexIVFSpectralHash_threshold_type_get, _swigfaiss.IndexIVFSpectralHash_threshold_type_set)
+    trained = property(_swigfaiss.IndexIVFSpectralHash_trained_get, _swigfaiss.IndexIVFSpectralHash_trained_set, doc=r"""
+    Trained threshold.
+    size nlist * nbit or 0 if Thresh_global
+    """)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFSpectralHash_swiginit(self, _swigfaiss.new_IndexIVFSpectralHash(*args))
+
+    def train_encoder(self, n, x, assign):
+        return _swigfaiss.IndexIVFSpectralHash_train_encoder(self, n, x, assign)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listnos=False):
+        return _swigfaiss.IndexIVFSpectralHash_encode_vectors(self, n, x, list_nos, codes, include_listnos)
+
+    def get_InvertedListScanner(self, store_pairs, sel):
+        return _swigfaiss.IndexIVFSpectralHash_get_InvertedListScanner(self, store_pairs, sel)
+
+    def replace_vt(self, *args):
+        r"""
+        *Overload 1:*
+         replace the vector transform for an empty (and possibly untrained) index
+
+        |
+
+        *Overload 2:*
+         convenience function to get the VT from an index constucted by an
+        index_factory (should end in "LSH")
+
+        |
+
+        *Overload 3:*
+         convenience function to get the VT from an index constucted by an
+        index_factory (should end in "LSH")
+        """
+        return _swigfaiss.IndexIVFSpectralHash_replace_vt(self, *args)
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFSpectralHash
+
+# Register IndexIVFSpectralHash in _swigfaiss:
+_swigfaiss.IndexIVFSpectralHash_swigregister(IndexIVFSpectralHash)
+class IndexIVFAdditiveQuantizer(IndexIVF):
+    r"""
+    Abstract class for IVF additive quantizers.
+    The search functions are in common.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    aq = property(_swigfaiss.IndexIVFAdditiveQuantizer_aq_get, _swigfaiss.IndexIVFAdditiveQuantizer_aq_set)
+    use_precomputed_table = property(_swigfaiss.IndexIVFAdditiveQuantizer_use_precomputed_table_get, _swigfaiss.IndexIVFAdditiveQuantizer_use_precomputed_table_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFAdditiveQuantizer_swiginit(self, _swigfaiss.new_IndexIVFAdditiveQuantizer(*args))
+
+    def train_encoder(self, n, x, assign):
+        return _swigfaiss.IndexIVFAdditiveQuantizer_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        return _swigfaiss.IndexIVFAdditiveQuantizer_train_encoder_num_vectors(self)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listnos=False):
+        return _swigfaiss.IndexIVFAdditiveQuantizer_encode_vectors(self, n, x, list_nos, codes, include_listnos)
+
+    def get_InvertedListScanner(self, store_pairs, sel):
+        return _swigfaiss.IndexIVFAdditiveQuantizer_get_InvertedListScanner(self, store_pairs, sel)
+
+    def sa_decode(self, n, codes, x):
+        return _swigfaiss.IndexIVFAdditiveQuantizer_sa_decode(self, n, codes, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFAdditiveQuantizer
+
+# Register IndexIVFAdditiveQuantizer in _swigfaiss:
+_swigfaiss.IndexIVFAdditiveQuantizer_swigregister(IndexIVFAdditiveQuantizer)
+class IndexIVFResidualQuantizer(IndexIVFAdditiveQuantizer):
+    r"""
+     IndexIVF based on a residual quantizer. Stored vectors are
+    approximated by residual quantization codes.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rq = property(_swigfaiss.IndexIVFResidualQuantizer_rq_get, _swigfaiss.IndexIVFResidualQuantizer_rq_set, doc=r""" The residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFResidualQuantizer_swiginit(self, _swigfaiss.new_IndexIVFResidualQuantizer(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFResidualQuantizer
+
+# Register IndexIVFResidualQuantizer in _swigfaiss:
+_swigfaiss.IndexIVFResidualQuantizer_swigregister(IndexIVFResidualQuantizer)
+class IndexIVFLocalSearchQuantizer(IndexIVFAdditiveQuantizer):
+    r"""
+     IndexIVF based on a residual quantizer. Stored vectors are
+    approximated by residual quantization codes.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lsq = property(_swigfaiss.IndexIVFLocalSearchQuantizer_lsq_get, _swigfaiss.IndexIVFLocalSearchQuantizer_lsq_set, doc=r""" The LSQ quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFLocalSearchQuantizer_swiginit(self, _swigfaiss.new_IndexIVFLocalSearchQuantizer(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFLocalSearchQuantizer
+
+# Register IndexIVFLocalSearchQuantizer in _swigfaiss:
+_swigfaiss.IndexIVFLocalSearchQuantizer_swigregister(IndexIVFLocalSearchQuantizer)
+class IndexIVFProductResidualQuantizer(IndexIVFAdditiveQuantizer):
+    r"""
+     IndexIVF based on a product residual quantizer. Stored vectors are
+    approximated by product residual quantization codes.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    prq = property(_swigfaiss.IndexIVFProductResidualQuantizer_prq_get, _swigfaiss.IndexIVFProductResidualQuantizer_prq_set, doc=r""" The product residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFProductResidualQuantizer_swiginit(self, _swigfaiss.new_IndexIVFProductResidualQuantizer(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFProductResidualQuantizer
+
+# Register IndexIVFProductResidualQuantizer in _swigfaiss:
+_swigfaiss.IndexIVFProductResidualQuantizer_swigregister(IndexIVFProductResidualQuantizer)
+class IndexIVFProductLocalSearchQuantizer(IndexIVFAdditiveQuantizer):
+    r"""
+     IndexIVF based on a product local search quantizer. Stored vectors are
+    approximated by product local search quantization codes.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    plsq = property(_swigfaiss.IndexIVFProductLocalSearchQuantizer_plsq_get, _swigfaiss.IndexIVFProductLocalSearchQuantizer_plsq_set, doc=r""" The product local search quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFProductLocalSearchQuantizer_swiginit(self, _swigfaiss.new_IndexIVFProductLocalSearchQuantizer(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFProductLocalSearchQuantizer
+
+# Register IndexIVFProductLocalSearchQuantizer in _swigfaiss:
+_swigfaiss.IndexIVFProductLocalSearchQuantizer_swigregister(IndexIVFProductLocalSearchQuantizer)
+class SearchParametersHNSW(SearchParameters):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    efSearch = property(_swigfaiss.SearchParametersHNSW_efSearch_get, _swigfaiss.SearchParametersHNSW_efSearch_set)
+    check_relative_distance = property(_swigfaiss.SearchParametersHNSW_check_relative_distance_get, _swigfaiss.SearchParametersHNSW_check_relative_distance_set)
+    __swig_destroy__ = _swigfaiss.delete_SearchParametersHNSW
+
+    def __init__(self):
+        _swigfaiss.SearchParametersHNSW_swiginit(self, _swigfaiss.new_SearchParametersHNSW())
+
+# Register SearchParametersHNSW in _swigfaiss:
+_swigfaiss.SearchParametersHNSW_swigregister(SearchParametersHNSW)
+class HNSW(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    assign_probas = property(_swigfaiss.HNSW_assign_probas_get, _swigfaiss.HNSW_assign_probas_set, doc=r""" assignment probability to each layer (sum=1)""")
+    cum_nneighbor_per_level = property(_swigfaiss.HNSW_cum_nneighbor_per_level_get, _swigfaiss.HNSW_cum_nneighbor_per_level_set, doc=r"""
+    number of neighbors stored per layer (cumulative), should not
+    be changed after first add
+    """)
+    levels = property(_swigfaiss.HNSW_levels_get, _swigfaiss.HNSW_levels_set, doc=r""" level of each vector (base level = 1), size = ntotal""")
+    offsets = property(_swigfaiss.HNSW_offsets_get, _swigfaiss.HNSW_offsets_set, doc=r"""
+    offsets[i] is the offset in the neighbors array where vector i is stored
+    size ntotal + 1
+    """)
+    neighbors = property(_swigfaiss.HNSW_neighbors_get, _swigfaiss.HNSW_neighbors_set, doc=r"""
+    neighbors[offsets[i]:offsets[i+1]] is the list of neighbors of vector i
+    for all levels. this is where all storage goes.
+    """)
+    entry_point = property(_swigfaiss.HNSW_entry_point_get, _swigfaiss.HNSW_entry_point_set, doc=r"""
+    entry point in the search structure (one of the points with maximum
+    level
+    """)
+    rng = property(_swigfaiss.HNSW_rng_get, _swigfaiss.HNSW_rng_set)
+    max_level = property(_swigfaiss.HNSW_max_level_get, _swigfaiss.HNSW_max_level_set, doc=r""" maximum level""")
+    efConstruction = property(_swigfaiss.HNSW_efConstruction_get, _swigfaiss.HNSW_efConstruction_set, doc=r""" expansion factor at construction time""")
+    efSearch = property(_swigfaiss.HNSW_efSearch_get, _swigfaiss.HNSW_efSearch_set, doc=r""" expansion factor at search time""")
+    check_relative_distance = property(_swigfaiss.HNSW_check_relative_distance_get, _swigfaiss.HNSW_check_relative_distance_set, doc=r"""
+    during search: do we check whether the next best distance is good
+    enough?
+    """)
+    upper_beam = property(_swigfaiss.HNSW_upper_beam_get, _swigfaiss.HNSW_upper_beam_set, doc=r""" number of entry points in levels > 0.""")
+    search_bounded_queue = property(_swigfaiss.HNSW_search_bounded_queue_get, _swigfaiss.HNSW_search_bounded_queue_set, doc=r""" use bounded queue during exploration""")
+
+    def set_default_probas(self, M, levelMult):
+        r"""
+        initialize the assign_probas and cum_nneighbor_per_level to
+        have 2*M links on level 0 and M links on levels > 0
+        """
+        return _swigfaiss.HNSW_set_default_probas(self, M, levelMult)
+
+    def set_nb_neighbors(self, level_no, n):
+        r""" set nb of neighbors for this level (before adding anything)"""
+        return _swigfaiss.HNSW_set_nb_neighbors(self, level_no, n)
+
+    def nb_neighbors(self, layer_no):
+        r""" nb of neighbors for this level"""
+        return _swigfaiss.HNSW_nb_neighbors(self, layer_no)
+
+    def cum_nb_neighbors(self, layer_no):
+        r""" cumumlative nb up to (and excluding) this level"""
+        return _swigfaiss.HNSW_cum_nb_neighbors(self, layer_no)
+
+    def neighbor_range(self, no, layer_no, begin, end):
+        r""" range of entries in the neighbors table of vertex no at layer_no"""
+        return _swigfaiss.HNSW_neighbor_range(self, no, layer_no, begin, end)
+
+    def __init__(self, M=32):
+        r""" only mandatory parameter: nb of neighbors"""
+        _swigfaiss.HNSW_swiginit(self, _swigfaiss.new_HNSW(M))
+
+    def random_level(self):
+        r""" pick a random level for a new point"""
+        return _swigfaiss.HNSW_random_level(self)
+
+    def fill_with_random_links(self, n):
+        r""" add n random levels to table (for debugging...)"""
+        return _swigfaiss.HNSW_fill_with_random_links(self, n)
+
+    def add_links_starting_from(self, ptdis, pt_id, nearest, d_nearest, level, locks, vt):
+        return _swigfaiss.HNSW_add_links_starting_from(self, ptdis, pt_id, nearest, d_nearest, level, locks, vt)
+
+    def add_with_locks(self, ptdis, pt_level, pt_id, locks, vt):
+        r"""
+         add point pt_id on all levels <= pt_level and build the link
+        structure for them.
+        """
+        return _swigfaiss.HNSW_add_with_locks(self, ptdis, pt_level, pt_id, locks, vt)
+
+    def search(self, qdis, res, vt, params=None):
+        r""" search interface for 1 point, single thread"""
+        return _swigfaiss.HNSW_search(self, qdis, res, vt, params)
+
+    def search_level_0(self, qdis, res, nprobe, nearest_i, nearest_d, search_type, search_stats, vt):
+        r""" search only in level 0 from a given vertex"""
+        return _swigfaiss.HNSW_search_level_0(self, qdis, res, nprobe, nearest_i, nearest_d, search_type, search_stats, vt)
+
+    def reset(self):
+        return _swigfaiss.HNSW_reset(self)
+
+    def clear_neighbor_tables(self, level):
+        return _swigfaiss.HNSW_clear_neighbor_tables(self, level)
+
+    def print_neighbor_stats(self, level):
+        return _swigfaiss.HNSW_print_neighbor_stats(self, level)
+
+    def prepare_level_tab(self, n, preset_levels=False):
+        return _swigfaiss.HNSW_prepare_level_tab(self, n, preset_levels)
+
+    @staticmethod
+    def shrink_neighbor_list(qdis, input, output, max_size):
+        return _swigfaiss.HNSW_shrink_neighbor_list(qdis, input, output, max_size)
+
+    def permute_entries(self, map):
+        return _swigfaiss.HNSW_permute_entries(self, map)
+    __swig_destroy__ = _swigfaiss.delete_HNSW
+
+# Register HNSW in _swigfaiss:
+_swigfaiss.HNSW_swigregister(HNSW)
+class HNSWStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    n1 = property(_swigfaiss.HNSWStats_n1_get, _swigfaiss.HNSWStats_n1_set)
+    n2 = property(_swigfaiss.HNSWStats_n2_get, _swigfaiss.HNSWStats_n2_set)
+    n3 = property(_swigfaiss.HNSWStats_n3_get, _swigfaiss.HNSWStats_n3_set)
+    ndis = property(_swigfaiss.HNSWStats_ndis_get, _swigfaiss.HNSWStats_ndis_set)
+    nreorder = property(_swigfaiss.HNSWStats_nreorder_get, _swigfaiss.HNSWStats_nreorder_set)
+
+    def __init__(self, n1=0, n2=0, n3=0, ndis=0, nreorder=0):
+        _swigfaiss.HNSWStats_swiginit(self, _swigfaiss.new_HNSWStats(n1, n2, n3, ndis, nreorder))
+
+    def reset(self):
+        return _swigfaiss.HNSWStats_reset(self)
+
+    def combine(self, other):
+        return _swigfaiss.HNSWStats_combine(self, other)
+    __swig_destroy__ = _swigfaiss.delete_HNSWStats
+
+# Register HNSWStats in _swigfaiss:
+_swigfaiss.HNSWStats_swigregister(HNSWStats)
+class IndexHNSW(Index):
+    r"""
+     The HNSW index is a normal random-access index with a HNSW
+    link structure built on top
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    hnsw = property(_swigfaiss.IndexHNSW_hnsw_get, _swigfaiss.IndexHNSW_hnsw_set)
+    own_fields = property(_swigfaiss.IndexHNSW_own_fields_get, _swigfaiss.IndexHNSW_own_fields_set)
+    storage = property(_swigfaiss.IndexHNSW_storage_get, _swigfaiss.IndexHNSW_storage_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexHNSW_swiginit(self, _swigfaiss.new_IndexHNSW(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexHNSW
+
+    def add(self, n, x):
+        return _swigfaiss.IndexHNSW_add(self, n, x)
+
+    def train(self, n, x):
+        r""" Trains the storage if needed"""
+        return _swigfaiss.IndexHNSW_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" entry point for search"""
+        return _swigfaiss.IndexHNSW_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss.IndexHNSW_range_search(self, n, x, radius, result, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexHNSW_reconstruct(self, key, recons)
+
+    def reset(self):
+        return _swigfaiss.IndexHNSW_reset(self)
+
+    def shrink_level_0_neighbors(self, size):
+        return _swigfaiss.IndexHNSW_shrink_level_0_neighbors(self, size)
+
+    def search_level_0(self, n, x, k, nearest, nearest_d, distances, labels, nprobe=1, search_type=1):
+        r"""
+         Perform search only on level 0, given the starting points for
+        each vertex.
+
+        :type search_type: int, optional
+        :param search_type: 1:perform one search per nprobe, 2: enqueue
+                               all entry points
+        """
+        return _swigfaiss.IndexHNSW_search_level_0(self, n, x, k, nearest, nearest_d, distances, labels, nprobe, search_type)
+
+    def init_level_0_from_knngraph(self, k, D, I):
+        r""" alternative graph building"""
+        return _swigfaiss.IndexHNSW_init_level_0_from_knngraph(self, k, D, I)
+
+    def init_level_0_from_entry_points(self, npt, points, nearests):
+        r""" alternative graph building"""
+        return _swigfaiss.IndexHNSW_init_level_0_from_entry_points(self, npt, points, nearests)
+
+    def reorder_links(self):
+        return _swigfaiss.IndexHNSW_reorder_links(self)
+
+    def link_singletons(self):
+        return _swigfaiss.IndexHNSW_link_singletons(self)
+
+    def permute_entries(self, perm):
+        return _swigfaiss.IndexHNSW_permute_entries(self, perm)
+
+# Register IndexHNSW in _swigfaiss:
+_swigfaiss.IndexHNSW_swigregister(IndexHNSW)
+class IndexHNSWFlat(IndexHNSW):
+    r"""
+    Flat index topped with with a HNSW structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.IndexHNSWFlat_swiginit(self, _swigfaiss.new_IndexHNSWFlat(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexHNSWFlat
+
+# Register IndexHNSWFlat in _swigfaiss:
+_swigfaiss.IndexHNSWFlat_swigregister(IndexHNSWFlat)
+class IndexHNSWPQ(IndexHNSW):
+    r"""
+    PQ index topped with with a HNSW structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.IndexHNSWPQ_swiginit(self, _swigfaiss.new_IndexHNSWPQ(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexHNSWPQ_train(self, n, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexHNSWPQ
+
+# Register IndexHNSWPQ in _swigfaiss:
+_swigfaiss.IndexHNSWPQ_swigregister(IndexHNSWPQ)
+class IndexHNSWSQ(IndexHNSW):
+    r"""
+    SQ index topped with with a HNSW structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.IndexHNSWSQ_swiginit(self, _swigfaiss.new_IndexHNSWSQ(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexHNSWSQ
+
+# Register IndexHNSWSQ in _swigfaiss:
+_swigfaiss.IndexHNSWSQ_swigregister(IndexHNSWSQ)
+class IndexHNSW2Level(IndexHNSW):
+    r""" 2-level code structure with fast random access"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.IndexHNSW2Level_swiginit(self, _swigfaiss.new_IndexHNSW2Level(*args))
+
+    def flip_to_ivf(self):
+        return _swigfaiss.IndexHNSW2Level_flip_to_ivf(self)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" entry point for search"""
+        return _swigfaiss.IndexHNSW2Level_search(self, n, x, k, distances, labels, params)
+    __swig_destroy__ = _swigfaiss.delete_IndexHNSW2Level
+
+# Register IndexHNSW2Level in _swigfaiss:
+_swigfaiss.IndexHNSW2Level_swigregister(IndexHNSW2Level)
+
+def smawk(nrows, ncols, x, argmins):
+    r"""
+     SMAWK algorithm. Find the row minima of a monotone matrix.
+
+    Expose this for testing.
+
+    :type nrows: int
+    :param nrows:    number of rows
+    :type ncols: int
+    :param ncols:    number of columns
+    :type x: float
+    :param x:        input matrix, size (nrows, ncols)
+    :type argmins: int
+    :param argmins:  argmin of each row
+    """
+    return _swigfaiss.smawk(nrows, ncols, x, argmins)
+
+def kmeans1d(x, n, nclusters, centroids):
+    r"""
+     Exact 1D K-Means by dynamic programming
+
+    From  "Fast Exact k-Means, k-Medians and Bregman Divergence Clustering in 1D"
+    Allan Grønlund, Kasper Green Larsen, Alexander Mathiasen, Jesper Sindahl
+    Nielsen, Stefan Schneider, Mingzhou Song, ArXiV'17
+
+    Section 2.2
+
+    https://arxiv.org/abs/1701.07204
+
+    :type x: float
+    :param x:          input 1D array
+    :type n: int
+    :param n:          input array length
+    :type nclusters: int
+    :param nclusters:  number of clusters
+    :type centroids: float
+    :param centroids:  output centroids, size nclusters
+    :rtype: float
+    :return: imbalancce factor
+    """
+    return _swigfaiss.kmeans1d(x, n, nclusters, centroids)
+class Neighbor(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    id = property(_swigfaiss.Neighbor_id_get, _swigfaiss.Neighbor_id_set)
+    distance = property(_swigfaiss.Neighbor_distance_get, _swigfaiss.Neighbor_distance_set)
+    flag = property(_swigfaiss.Neighbor_flag_get, _swigfaiss.Neighbor_flag_set)
+
+    def __init__(self, *args):
+        _swigfaiss.Neighbor_swiginit(self, _swigfaiss.new_Neighbor(*args))
+
+    def __lt__(self, other):
+        return _swigfaiss.Neighbor___lt__(self, other)
+    __swig_destroy__ = _swigfaiss.delete_Neighbor
+
+# Register Neighbor in _swigfaiss:
+_swigfaiss.Neighbor_swigregister(Neighbor)
+class Nhood(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    pool = property(_swigfaiss.Nhood_pool_get, _swigfaiss.Nhood_pool_set)
+    M = property(_swigfaiss.Nhood_M_get, _swigfaiss.Nhood_M_set)
+    nn_old = property(_swigfaiss.Nhood_nn_old_get, _swigfaiss.Nhood_nn_old_set)
+    nn_new = property(_swigfaiss.Nhood_nn_new_get, _swigfaiss.Nhood_nn_new_set)
+    rnn_old = property(_swigfaiss.Nhood_rnn_old_get, _swigfaiss.Nhood_rnn_old_set)
+    rnn_new = property(_swigfaiss.Nhood_rnn_new_get, _swigfaiss.Nhood_rnn_new_set)
+
+    def __init__(self, *args):
+        _swigfaiss.Nhood_swiginit(self, _swigfaiss.new_Nhood(*args))
+
+    def insert(self, id, dist):
+        return _swigfaiss.Nhood_insert(self, id, dist)
+    __swig_destroy__ = _swigfaiss.delete_Nhood
+
+# Register Nhood in _swigfaiss:
+_swigfaiss.Nhood_swigregister(Nhood)
+class NNDescent(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, d, K):
+        _swigfaiss.NNDescent_swiginit(self, _swigfaiss.new_NNDescent(d, K))
+    __swig_destroy__ = _swigfaiss.delete_NNDescent
+
+    def build(self, qdis, n, verbose):
+        return _swigfaiss.NNDescent_build(self, qdis, n, verbose)
+
+    def search(self, qdis, topk, indices, dists, vt):
+        return _swigfaiss.NNDescent_search(self, qdis, topk, indices, dists, vt)
+
+    def reset(self):
+        return _swigfaiss.NNDescent_reset(self)
+
+    def init_graph(self, qdis):
+        r""" Initialize the KNN graph randomly"""
+        return _swigfaiss.NNDescent_init_graph(self, qdis)
+
+    def nndescent(self, qdis, verbose):
+        r""" Perform NNDescent algorithm"""
+        return _swigfaiss.NNDescent_nndescent(self, qdis, verbose)
+
+    def join(self, qdis):
+        r""" Perform local join on each node"""
+        return _swigfaiss.NNDescent_join(self, qdis)
+
+    def update(self):
+        r""" Sample new neighbors for each node to peform local join later"""
+        return _swigfaiss.NNDescent_update(self)
+
+    def generate_eval_set(self, qdis, c, v, N):
+        r""" Sample a small number of points to evaluate the quality of KNNG built"""
+        return _swigfaiss.NNDescent_generate_eval_set(self, qdis, c, v, N)
+
+    def eval_recall(self, ctrl_points, acc_eval_set):
+        r""" Evaluate the quality of KNNG built"""
+        return _swigfaiss.NNDescent_eval_recall(self, ctrl_points, acc_eval_set)
+    has_built = property(_swigfaiss.NNDescent_has_built_get, _swigfaiss.NNDescent_has_built_set)
+    S = property(_swigfaiss.NNDescent_S_get, _swigfaiss.NNDescent_S_set)
+    R = property(_swigfaiss.NNDescent_R_get, _swigfaiss.NNDescent_R_set)
+    iter = property(_swigfaiss.NNDescent_iter_get, _swigfaiss.NNDescent_iter_set)
+    search_L = property(_swigfaiss.NNDescent_search_L_get, _swigfaiss.NNDescent_search_L_set)
+    random_seed = property(_swigfaiss.NNDescent_random_seed_get, _swigfaiss.NNDescent_random_seed_set)
+    K = property(_swigfaiss.NNDescent_K_get, _swigfaiss.NNDescent_K_set)
+    d = property(_swigfaiss.NNDescent_d_get, _swigfaiss.NNDescent_d_set)
+    L = property(_swigfaiss.NNDescent_L_get, _swigfaiss.NNDescent_L_set)
+    ntotal = property(_swigfaiss.NNDescent_ntotal_get, _swigfaiss.NNDescent_ntotal_set)
+    graph = property(_swigfaiss.NNDescent_graph_get, _swigfaiss.NNDescent_graph_set)
+    final_graph = property(_swigfaiss.NNDescent_final_graph_get, _swigfaiss.NNDescent_final_graph_set)
+
+# Register NNDescent in _swigfaiss:
+_swigfaiss.NNDescent_swigregister(NNDescent)
+class IndexNNDescent(Index):
+    r"""
+     The NNDescent index is a normal random-access index with an NNDescent
+    link structure built on top
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nndescent = property(_swigfaiss.IndexNNDescent_nndescent_get, _swigfaiss.IndexNNDescent_nndescent_set, doc=r""" Faiss results are 64-bit""")
+    own_fields = property(_swigfaiss.IndexNNDescent_own_fields_get, _swigfaiss.IndexNNDescent_own_fields_set)
+    storage = property(_swigfaiss.IndexNNDescent_storage_get, _swigfaiss.IndexNNDescent_storage_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexNNDescent_swiginit(self, _swigfaiss.new_IndexNNDescent(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexNNDescent
+
+    def add(self, n, x):
+        return _swigfaiss.IndexNNDescent_add(self, n, x)
+
+    def train(self, n, x):
+        r""" Trains the storage if needed"""
+        return _swigfaiss.IndexNNDescent_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" entry point for search"""
+        return _swigfaiss.IndexNNDescent_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexNNDescent_reconstruct(self, key, recons)
+
+    def reset(self):
+        return _swigfaiss.IndexNNDescent_reset(self)
+
+# Register IndexNNDescent in _swigfaiss:
+_swigfaiss.IndexNNDescent_swigregister(IndexNNDescent)
+class IndexNNDescentFlat(IndexNNDescent):
+    r"""
+    Flat index topped with with a NNDescent structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.IndexNNDescentFlat_swiginit(self, _swigfaiss.new_IndexNNDescentFlat(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexNNDescentFlat
+
+# Register IndexNNDescentFlat in _swigfaiss:
+_swigfaiss.IndexNNDescentFlat_swigregister(IndexNNDescentFlat)
+class IndexIVFFlat(IndexIVF):
+    r"""
+     Inverted file with stored vectors. Here the inverted file
+    pre-selects the vectors to be searched, but they are not otherwise
+    encoded, the code array just contains the raw float entries.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def add_core(self, n, x, xids, precomputed_idx, inverted_list_context=None):
+        return _swigfaiss.IndexIVFFlat_add_core(self, n, x, xids, precomputed_idx, inverted_list_context)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listnos=False):
+        return _swigfaiss.IndexIVFFlat_encode_vectors(self, n, x, list_nos, codes, include_listnos)
+
+    def get_InvertedListScanner(self, store_pairs, sel):
+        return _swigfaiss.IndexIVFFlat_get_InvertedListScanner(self, store_pairs, sel)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        return _swigfaiss.IndexIVFFlat_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexIVFFlat_sa_decode(self, n, bytes, x)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFFlat_swiginit(self, _swigfaiss.new_IndexIVFFlat(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFFlat
+
+# Register IndexIVFFlat in _swigfaiss:
+_swigfaiss.IndexIVFFlat_swigregister(IndexIVFFlat)
+class IndexIVFFlatDedup(IndexIVFFlat):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    instances = property(_swigfaiss.IndexIVFFlatDedup_instances_get, _swigfaiss.IndexIVFFlatDedup_instances_set, doc=r"""
+    Maps ids stored in the index to the ids of vectors that are
+    the same. When a vector is unique, it does not appear in the
+    instances map
+    """)
+
+    def train(self, n, x):
+        r""" also dedups the training set"""
+        return _swigfaiss.IndexIVFFlatDedup_train(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        r""" implemented for all IndexIVF* classes"""
+        return _swigfaiss.IndexIVFFlatDedup_add_with_ids(self, n, x, xids)
+
+    def search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params=None, stats=None):
+        return _swigfaiss.IndexIVFFlatDedup_search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params, stats)
+
+    def remove_ids(self, sel):
+        return _swigfaiss.IndexIVFFlatDedup_remove_ids(self, sel)
+
+    def range_search(self, n, x, radius, result, params=None):
+        r""" not implemented"""
+        return _swigfaiss.IndexIVFFlatDedup_range_search(self, n, x, radius, result, params)
+
+    def update_vectors(self, nv, idx, v):
+        r""" not implemented"""
+        return _swigfaiss.IndexIVFFlatDedup_update_vectors(self, nv, idx, v)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        r""" not implemented"""
+        return _swigfaiss.IndexIVFFlatDedup_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFFlatDedup_swiginit(self, _swigfaiss.new_IndexIVFFlatDedup(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFFlatDedup
+
+# Register IndexIVFFlatDedup in _swigfaiss:
+_swigfaiss.IndexIVFFlatDedup_swigregister(IndexIVFFlatDedup)
+
+def storage_distance_computer(storage):
+    return _swigfaiss.storage_distance_computer(storage)
+class NSG(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    ntotal = property(_swigfaiss.NSG_ntotal_get, _swigfaiss.NSG_ntotal_set, doc=r""" nb of nodes""")
+    R = property(_swigfaiss.NSG_R_get, _swigfaiss.NSG_R_set, doc=r""" nb of neighbors per node""")
+    L = property(_swigfaiss.NSG_L_get, _swigfaiss.NSG_L_set, doc=r""" length of the search path at construction time""")
+    C = property(_swigfaiss.NSG_C_get, _swigfaiss.NSG_C_set, doc=r""" candidate pool size at construction time""")
+    search_L = property(_swigfaiss.NSG_search_L_get, _swigfaiss.NSG_search_L_set, doc=r""" length of the search path""")
+    enterpoint = property(_swigfaiss.NSG_enterpoint_get, _swigfaiss.NSG_enterpoint_set, doc=r""" enterpoint""")
+    final_graph = property(_swigfaiss.NSG_final_graph_get, _swigfaiss.NSG_final_graph_set, doc=r""" NSG graph structure""")
+    is_built = property(_swigfaiss.NSG_is_built_get, _swigfaiss.NSG_is_built_set, doc=r""" NSG is built or not""")
+    rng = property(_swigfaiss.NSG_rng_get, _swigfaiss.NSG_rng_set, doc=r""" random generator""")
+
+    def __init__(self, R=32):
+        _swigfaiss.NSG_swiginit(self, _swigfaiss.new_NSG(R))
+
+    def build(self, storage, n, knn_graph, verbose):
+        return _swigfaiss.NSG_build(self, storage, n, knn_graph, verbose)
+
+    def reset(self):
+        return _swigfaiss.NSG_reset(self)
+
+    def search(self, dis, k, I, D, vt):
+        return _swigfaiss.NSG_search(self, dis, k, I, D, vt)
+
+    def init_graph(self, storage, knn_graph):
+        return _swigfaiss.NSG_init_graph(self, storage, knn_graph)
+
+    def add_reverse_links(self, q, locks, dis, graph):
+        return _swigfaiss.NSG_add_reverse_links(self, q, locks, dis, graph)
+
+    def sync_prune(self, q, pool, dis, vt, knn_graph, graph):
+        return _swigfaiss.NSG_sync_prune(self, q, pool, dis, vt, knn_graph, graph)
+
+    def link(self, storage, knn_graph, graph, verbose):
+        return _swigfaiss.NSG_link(self, storage, knn_graph, graph, verbose)
+
+    def tree_grow(self, storage, degrees):
+        return _swigfaiss.NSG_tree_grow(self, storage, degrees)
+
+    def dfs(self, vt, root, cnt):
+        return _swigfaiss.NSG_dfs(self, vt, root, cnt)
+
+    def attach_unlinked(self, storage, vt, vt2, degrees):
+        return _swigfaiss.NSG_attach_unlinked(self, storage, vt, vt2, degrees)
+
+    def check_graph(self):
+        return _swigfaiss.NSG_check_graph(self)
+
+    def get_final_graph(self):
+        return _swigfaiss.NSG_get_final_graph(self)
+    __swig_destroy__ = _swigfaiss.delete_NSG
+
+# Register NSG in _swigfaiss:
+_swigfaiss.NSG_swigregister(NSG)
+class NSG_Graph_int(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    data = property(_swigfaiss.NSG_Graph_int_data_get, _swigfaiss.NSG_Graph_int_data_set, doc=r""" the flattened adjacency matrix, size N-by-K""")
+    K = property(_swigfaiss.NSG_Graph_int_K_get, _swigfaiss.NSG_Graph_int_K_set, doc=r""" nb of neighbors per node""")
+    N = property(_swigfaiss.NSG_Graph_int_N_get, _swigfaiss.NSG_Graph_int_N_set, doc=r""" total nb of nodes""")
+    own_fields = property(_swigfaiss.NSG_Graph_int_own_fields_get, _swigfaiss.NSG_Graph_int_own_fields_set, doc=r""" the underlying data owned by itself or not""")
+
+    def __init__(self, *args):
+        _swigfaiss.NSG_Graph_int_swiginit(self, _swigfaiss.new_NSG_Graph_int(*args))
+    __swig_destroy__ = _swigfaiss.delete_NSG_Graph_int
+
+    def at(self, *args):
+        return _swigfaiss.NSG_Graph_int_at(self, *args)
+
+# Register NSG_Graph_int in _swigfaiss:
+_swigfaiss.NSG_Graph_int_swigregister(NSG_Graph_int)
+class IndexNSG(Index):
+    r"""
+     The NSG index is a normal random-access index with a NSG
+    link structure built on top
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nsg = property(_swigfaiss.IndexNSG_nsg_get, _swigfaiss.IndexNSG_nsg_set, doc=r""" the link strcuture""")
+    own_fields = property(_swigfaiss.IndexNSG_own_fields_get, _swigfaiss.IndexNSG_own_fields_set, doc=r""" the sequential storage""")
+    storage = property(_swigfaiss.IndexNSG_storage_get, _swigfaiss.IndexNSG_storage_set)
+    is_built = property(_swigfaiss.IndexNSG_is_built_get, _swigfaiss.IndexNSG_is_built_set, doc=r""" the index is built or not""")
+    GK = property(_swigfaiss.IndexNSG_GK_get, _swigfaiss.IndexNSG_GK_set, doc=r""" K of KNN graph for building""")
+    build_type = property(_swigfaiss.IndexNSG_build_type_get, _swigfaiss.IndexNSG_build_type_set, doc=r"""
+    indicate how to build a knn graph
+    - 0: build NSG with brute force search
+    - 1: build NSG with NNDescent
+    """)
+    nndescent_S = property(_swigfaiss.IndexNSG_nndescent_S_get, _swigfaiss.IndexNSG_nndescent_S_set, doc=r""" parameters for nndescent""")
+    nndescent_R = property(_swigfaiss.IndexNSG_nndescent_R_get, _swigfaiss.IndexNSG_nndescent_R_set)
+    nndescent_L = property(_swigfaiss.IndexNSG_nndescent_L_get, _swigfaiss.IndexNSG_nndescent_L_set)
+    nndescent_iter = property(_swigfaiss.IndexNSG_nndescent_iter_get, _swigfaiss.IndexNSG_nndescent_iter_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexNSG_swiginit(self, _swigfaiss.new_IndexNSG(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexNSG
+
+    def build(self, n, x, knn_graph, GK):
+        return _swigfaiss.IndexNSG_build(self, n, x, knn_graph, GK)
+
+    def add(self, n, x):
+        return _swigfaiss.IndexNSG_add(self, n, x)
+
+    def train(self, n, x):
+        r""" Trains the storage if needed"""
+        return _swigfaiss.IndexNSG_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" entry point for search"""
+        return _swigfaiss.IndexNSG_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexNSG_reconstruct(self, key, recons)
+
+    def reset(self):
+        return _swigfaiss.IndexNSG_reset(self)
+
+    def check_knn_graph(self, knn_graph, n, K):
+        return _swigfaiss.IndexNSG_check_knn_graph(self, knn_graph, n, K)
+
+# Register IndexNSG in _swigfaiss:
+_swigfaiss.IndexNSG_swigregister(IndexNSG)
+class IndexNSGFlat(IndexNSG):
+    r"""
+    Flat index topped with with a NSG structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.IndexNSGFlat_swiginit(self, _swigfaiss.new_IndexNSGFlat(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexNSGFlat
+
+# Register IndexNSGFlat in _swigfaiss:
+_swigfaiss.IndexNSGFlat_swigregister(IndexNSGFlat)
+class IndexNSGPQ(IndexNSG):
+    r"""
+    PQ index topped with with a NSG structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.IndexNSGPQ_swiginit(self, _swigfaiss.new_IndexNSGPQ(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexNSGPQ_train(self, n, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexNSGPQ
+
+# Register IndexNSGPQ in _swigfaiss:
+_swigfaiss.IndexNSGPQ_swigregister(IndexNSGPQ)
+class IndexNSGSQ(IndexNSG):
+    r"""
+    SQ index topped with with a NSG structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.IndexNSGSQ_swiginit(self, _swigfaiss.new_IndexNSGSQ(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexNSGSQ
+
+# Register IndexNSGSQ in _swigfaiss:
+_swigfaiss.IndexNSGSQ_swigregister(IndexNSGSQ)
+class ZnSphereSearch(object):
+    r"""
+     returns the nearest vertex in the sphere to a query. Returns only
+    the coordinates, not an id.
+
+    Algorithm: all points are derived from a one atom vector up to a
+    permutation and sign changes. The search function finds the most
+    appropriate atom and transformation.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    dimS = property(_swigfaiss.ZnSphereSearch_dimS_get, _swigfaiss.ZnSphereSearch_dimS_set)
+    r2 = property(_swigfaiss.ZnSphereSearch_r2_get, _swigfaiss.ZnSphereSearch_r2_set)
+    natom = property(_swigfaiss.ZnSphereSearch_natom_get, _swigfaiss.ZnSphereSearch_natom_set)
+    voc = property(_swigfaiss.ZnSphereSearch_voc_get, _swigfaiss.ZnSphereSearch_voc_set, doc=r""" size dim * ntatom""")
+
+    def __init__(self, dim, r2):
+        _swigfaiss.ZnSphereSearch_swiginit(self, _swigfaiss.new_ZnSphereSearch(dim, r2))
+
+    def search(self, *args):
+        r"""
+        *Overload 1:*
+        find nearest centroid. x does not need to be normalized
+
+        |
+
+        *Overload 2:*
+        full call. Requires externally-allocated temp space
+
+        |
+
+        *Overload 3:*
+        full call. Requires externally-allocated temp space
+        """
+        return _swigfaiss.ZnSphereSearch_search(self, *args)
+
+    def search_multi(self, n, x, c_out, dp_out):
+        return _swigfaiss.ZnSphereSearch_search_multi(self, n, x, c_out, dp_out)
+    __swig_destroy__ = _swigfaiss.delete_ZnSphereSearch
+
+# Register ZnSphereSearch in _swigfaiss:
+_swigfaiss.ZnSphereSearch_swigregister(ZnSphereSearch)
+class EnumeratedVectors(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    nv = property(_swigfaiss.EnumeratedVectors_nv_get, _swigfaiss.EnumeratedVectors_nv_set, doc=r""" size of the collection""")
+    dim = property(_swigfaiss.EnumeratedVectors_dim_get, _swigfaiss.EnumeratedVectors_dim_set)
+
+    def encode(self, x):
+        r""" encode a vector from a collection"""
+        return _swigfaiss.EnumeratedVectors_encode(self, x)
+
+    def decode(self, code, c):
+        r""" decode it"""
+        return _swigfaiss.EnumeratedVectors_decode(self, code, c)
+
+    def encode_multi(self, nc, c, codes):
+        return _swigfaiss.EnumeratedVectors_encode_multi(self, nc, c, codes)
+
+    def decode_multi(self, nc, codes, c):
+        return _swigfaiss.EnumeratedVectors_decode_multi(self, nc, codes, c)
+
+    def find_nn(self, n, codes, nq, xq, idx, dis):
+        return _swigfaiss.EnumeratedVectors_find_nn(self, n, codes, nq, xq, idx, dis)
+    __swig_destroy__ = _swigfaiss.delete_EnumeratedVectors
+
+# Register EnumeratedVectors in _swigfaiss:
+_swigfaiss.EnumeratedVectors_swigregister(EnumeratedVectors)
+class Repeat(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    val = property(_swigfaiss.Repeat_val_get, _swigfaiss.Repeat_val_set)
+    n = property(_swigfaiss.Repeat_n_get, _swigfaiss.Repeat_n_set)
+
+    def __init__(self):
+        _swigfaiss.Repeat_swiginit(self, _swigfaiss.new_Repeat())
+    __swig_destroy__ = _swigfaiss.delete_Repeat
+
+# Register Repeat in _swigfaiss:
+_swigfaiss.Repeat_swigregister(Repeat)
+class Repeats(object):
+    r"""
+    Repeats: used to encode a vector that has n occurrences of
+    val. Encodes the signs and permutation of the vector. Useful for
+    atoms.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    dim = property(_swigfaiss.Repeats_dim_get, _swigfaiss.Repeats_dim_set)
+    repeats = property(_swigfaiss.Repeats_repeats_get, _swigfaiss.Repeats_repeats_set)
+
+    def __init__(self, dim=0, c=None):
+        _swigfaiss.Repeats_swiginit(self, _swigfaiss.new_Repeats(dim, c))
+
+    def count(self):
+        return _swigfaiss.Repeats_count(self)
+
+    def encode(self, c):
+        return _swigfaiss.Repeats_encode(self, c)
+
+    def decode(self, code, c):
+        return _swigfaiss.Repeats_decode(self, code, c)
+    __swig_destroy__ = _swigfaiss.delete_Repeats
+
+# Register Repeats in _swigfaiss:
+_swigfaiss.Repeats_swigregister(Repeats)
+class ZnSphereCodec(ZnSphereSearch, EnumeratedVectors):
+    r"""
+     codec that can return ids for the encoded vectors
+
+    uses the ZnSphereSearch to encode the vector by encoding the
+    permutation and signs. Depends on ZnSphereSearch because it uses
+    the atom numbers
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code_segments = property(_swigfaiss.ZnSphereCodec_code_segments_get, _swigfaiss.ZnSphereCodec_code_segments_set)
+    nv = property(_swigfaiss.ZnSphereCodec_nv_get, _swigfaiss.ZnSphereCodec_nv_set)
+    code_size = property(_swigfaiss.ZnSphereCodec_code_size_get, _swigfaiss.ZnSphereCodec_code_size_set)
+
+    def __init__(self, dim, r2):
+        _swigfaiss.ZnSphereCodec_swiginit(self, _swigfaiss.new_ZnSphereCodec(dim, r2))
+
+    def search_and_encode(self, x):
+        return _swigfaiss.ZnSphereCodec_search_and_encode(self, x)
+
+    def decode(self, code, c):
+        return _swigfaiss.ZnSphereCodec_decode(self, code, c)
+
+    def encode(self, x):
+        r""" takes vectors that do not need to be centroids"""
+        return _swigfaiss.ZnSphereCodec_encode(self, x)
+    __swig_destroy__ = _swigfaiss.delete_ZnSphereCodec
+
+# Register ZnSphereCodec in _swigfaiss:
+_swigfaiss.ZnSphereCodec_swigregister(ZnSphereCodec)
+class ZnSphereCodecRec(EnumeratedVectors):
+    r"""
+     recursive sphere codec
+
+    Uses a recursive decomposition on the dimensions to encode
+    centroids found by the ZnSphereSearch. The codes are *not*
+    compatible with the ones of ZnSpehreCodec
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    r2 = property(_swigfaiss.ZnSphereCodecRec_r2_get, _swigfaiss.ZnSphereCodecRec_r2_set)
+    log2_dim = property(_swigfaiss.ZnSphereCodecRec_log2_dim_get, _swigfaiss.ZnSphereCodecRec_log2_dim_set)
+    code_size = property(_swigfaiss.ZnSphereCodecRec_code_size_get, _swigfaiss.ZnSphereCodecRec_code_size_set)
+
+    def __init__(self, dim, r2):
+        _swigfaiss.ZnSphereCodecRec_swiginit(self, _swigfaiss.new_ZnSphereCodecRec(dim, r2))
+
+    def encode_centroid(self, c):
+        return _swigfaiss.ZnSphereCodecRec_encode_centroid(self, c)
+
+    def decode(self, code, c):
+        return _swigfaiss.ZnSphereCodecRec_decode(self, code, c)
+
+    def encode(self, x):
+        r"""
+        vectors need to be centroids (does not work on arbitrary
+        vectors)
+        """
+        return _swigfaiss.ZnSphereCodecRec_encode(self, x)
+    all_nv = property(_swigfaiss.ZnSphereCodecRec_all_nv_get, _swigfaiss.ZnSphereCodecRec_all_nv_set)
+    all_nv_cum = property(_swigfaiss.ZnSphereCodecRec_all_nv_cum_get, _swigfaiss.ZnSphereCodecRec_all_nv_cum_set)
+    decode_cache_ld = property(_swigfaiss.ZnSphereCodecRec_decode_cache_ld_get, _swigfaiss.ZnSphereCodecRec_decode_cache_ld_set)
+    decode_cache = property(_swigfaiss.ZnSphereCodecRec_decode_cache_get, _swigfaiss.ZnSphereCodecRec_decode_cache_set)
+
+    def get_nv(self, ld, r2a):
+        return _swigfaiss.ZnSphereCodecRec_get_nv(self, ld, r2a)
+
+    def get_nv_cum(self, ld, r2t, r2a):
+        return _swigfaiss.ZnSphereCodecRec_get_nv_cum(self, ld, r2t, r2a)
+
+    def set_nv_cum(self, ld, r2t, r2a, v):
+        return _swigfaiss.ZnSphereCodecRec_set_nv_cum(self, ld, r2t, r2a, v)
+    __swig_destroy__ = _swigfaiss.delete_ZnSphereCodecRec
+
+# Register ZnSphereCodecRec in _swigfaiss:
+_swigfaiss.ZnSphereCodecRec_swigregister(ZnSphereCodecRec)
+class ZnSphereCodecAlt(ZnSphereCodec):
+    r"""
+     Codec that uses the recursive codec if dim is a power of 2 and
+    the regular one otherwise
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    use_rec = property(_swigfaiss.ZnSphereCodecAlt_use_rec_get, _swigfaiss.ZnSphereCodecAlt_use_rec_set)
+    znc_rec = property(_swigfaiss.ZnSphereCodecAlt_znc_rec_get, _swigfaiss.ZnSphereCodecAlt_znc_rec_set)
+
+    def __init__(self, dim, r2):
+        _swigfaiss.ZnSphereCodecAlt_swiginit(self, _swigfaiss.new_ZnSphereCodecAlt(dim, r2))
+
+    def encode(self, x):
+        return _swigfaiss.ZnSphereCodecAlt_encode(self, x)
+
+    def decode(self, code, c):
+        return _swigfaiss.ZnSphereCodecAlt_decode(self, code, c)
+    __swig_destroy__ = _swigfaiss.delete_ZnSphereCodecAlt
+
+# Register ZnSphereCodecAlt in _swigfaiss:
+_swigfaiss.ZnSphereCodecAlt_swigregister(ZnSphereCodecAlt)
+class IndexLattice(Index):
+    r""" Index that encodes a vector with a series of Zn lattice quantizers"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nsq = property(_swigfaiss.IndexLattice_nsq_get, _swigfaiss.IndexLattice_nsq_set, doc=r""" number of sub-vectors""")
+    dsq = property(_swigfaiss.IndexLattice_dsq_get, _swigfaiss.IndexLattice_dsq_set, doc=r""" dimension of sub-vectors""")
+    zn_sphere_codec = property(_swigfaiss.IndexLattice_zn_sphere_codec_get, _swigfaiss.IndexLattice_zn_sphere_codec_set, doc=r""" the lattice quantizer""")
+    scale_nbit = property(_swigfaiss.IndexLattice_scale_nbit_get, _swigfaiss.IndexLattice_scale_nbit_set, doc=r""" nb bits used to encode the scale, per subvector""")
+    lattice_nbit = property(_swigfaiss.IndexLattice_lattice_nbit_get, _swigfaiss.IndexLattice_lattice_nbit_set)
+    code_size = property(_swigfaiss.IndexLattice_code_size_get, _swigfaiss.IndexLattice_code_size_set, doc=r""" total, in bytes""")
+    trained = property(_swigfaiss.IndexLattice_trained_get, _swigfaiss.IndexLattice_trained_set, doc=r""" mins and maxes of the vector norms, per subquantizer""")
+
+    def __init__(self, d, nsq, scale_nbit, r2):
+        _swigfaiss.IndexLattice_swiginit(self, _swigfaiss.new_IndexLattice(d, nsq, scale_nbit, r2))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexLattice_train(self, n, x)
+
+    def sa_code_size(self):
+        return _swigfaiss.IndexLattice_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss.IndexLattice_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexLattice_sa_decode(self, n, bytes, x)
+
+    def add(self, n, x):
+        r""" not implemented"""
+        return _swigfaiss.IndexLattice_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexLattice_search(self, n, x, k, distances, labels, params)
+
+    def reset(self):
+        return _swigfaiss.IndexLattice_reset(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexLattice
+
+# Register IndexLattice in _swigfaiss:
+_swigfaiss.IndexLattice_swigregister(IndexLattice)
+class IVFPQSearchParameters(SearchParametersIVF):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    scan_table_threshold = property(_swigfaiss.IVFPQSearchParameters_scan_table_threshold_get, _swigfaiss.IVFPQSearchParameters_scan_table_threshold_set, doc=r""" use table computation or on-the-fly?""")
+    polysemous_ht = property(_swigfaiss.IVFPQSearchParameters_polysemous_ht_get, _swigfaiss.IVFPQSearchParameters_polysemous_ht_set, doc=r""" Hamming thresh for polysemous filtering""")
+
+    def __init__(self):
+        _swigfaiss.IVFPQSearchParameters_swiginit(self, _swigfaiss.new_IVFPQSearchParameters())
+    __swig_destroy__ = _swigfaiss.delete_IVFPQSearchParameters
+
+# Register IVFPQSearchParameters in _swigfaiss:
+_swigfaiss.IVFPQSearchParameters_swigregister(IVFPQSearchParameters)
+class IndexIVFPQ(IndexIVF):
+    r"""
+     Inverted file with Product Quantizer encoding. Each residual
+    vector is encoded as a product quantizer code.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    pq = property(_swigfaiss.IndexIVFPQ_pq_get, _swigfaiss.IndexIVFPQ_pq_set, doc=r""" produces the codes""")
+    do_polysemous_training = property(_swigfaiss.IndexIVFPQ_do_polysemous_training_get, _swigfaiss.IndexIVFPQ_do_polysemous_training_set, doc=r""" reorder PQ centroids after training?""")
+    polysemous_training = property(_swigfaiss.IndexIVFPQ_polysemous_training_get, _swigfaiss.IndexIVFPQ_polysemous_training_set, doc=r""" if NULL, use default""")
+    scan_table_threshold = property(_swigfaiss.IndexIVFPQ_scan_table_threshold_get, _swigfaiss.IndexIVFPQ_scan_table_threshold_set, doc=r""" use table computation or on-the-fly?""")
+    polysemous_ht = property(_swigfaiss.IndexIVFPQ_polysemous_ht_get, _swigfaiss.IndexIVFPQ_polysemous_ht_set, doc=r""" Hamming thresh for polysemous filtering""")
+    use_precomputed_table = property(_swigfaiss.IndexIVFPQ_use_precomputed_table_get, _swigfaiss.IndexIVFPQ_use_precomputed_table_set, doc=r"""
+     Precompute table that speed up query preprocessing at some
+    memory cost (used only for by_residual with L2 metric)
+    """)
+    precomputed_table = property(_swigfaiss.IndexIVFPQ_precomputed_table_get, _swigfaiss.IndexIVFPQ_precomputed_table_set, doc=r"""
+    if use_precompute_table
+    size nlist * pq.M * pq.ksub
+    """)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listnos=False):
+        return _swigfaiss.IndexIVFPQ_encode_vectors(self, n, x, list_nos, codes, include_listnos)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexIVFPQ_sa_decode(self, n, bytes, x)
+
+    def add_core(self, n, x, xids, precomputed_idx, inverted_list_context=None):
+        return _swigfaiss.IndexIVFPQ_add_core(self, n, x, xids, precomputed_idx, inverted_list_context)
+
+    def add_core_o(self, n, x, xids, residuals_2, precomputed_idx=None, inverted_list_context=None):
+        r"""
+        same as add_core, also:
+        - output 2nd level residuals if residuals_2 != NULL
+        - accepts precomputed_idx = nullptr
+        """
+        return _swigfaiss.IndexIVFPQ_add_core_o(self, n, x, xids, residuals_2, precomputed_idx, inverted_list_context)
+
+    def train_encoder(self, n, x, assign):
+        r""" trains the product quantizer"""
+        return _swigfaiss.IndexIVFPQ_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        return _swigfaiss.IndexIVFPQ_train_encoder_num_vectors(self)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        return _swigfaiss.IndexIVFPQ_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def find_duplicates(self, ids, lims):
+        r"""
+         Find exact duplicates in the dataset.
+
+        the duplicates are returned in pre-allocated arrays (see the
+        max sizes).
+
+        :type lims: int
+        :param lims:   limits between groups of duplicates
+                           (max size ntotal / 2 + 1)
+        :type ids: int
+        :param ids:    ids[lims[i]] : ids[lims[i+1]-1] is a group of
+                           duplicates (max size ntotal)
+        :rtype: int
+        :return: n      number of groups found
+        """
+        return _swigfaiss.IndexIVFPQ_find_duplicates(self, ids, lims)
+
+    def encode(self, key, x, code):
+        return _swigfaiss.IndexIVFPQ_encode(self, key, x, code)
+
+    def encode_multiple(self, n, keys, x, codes, compute_keys=False):
+        r"""
+         Encode multiple vectors
+
+        :type n: int
+        :param n:       nb vectors to encode
+        :type keys: int
+        :param keys:    posting list ids for those vectors (size n)
+        :type x: float
+        :param x:       vectors (size n * d)
+        :type codes: uint8_t
+        :param codes:   output codes (size n * code_size)
+        :type compute_keys: boolean, optional
+        :param compute_keys:  if false, assume keys are precomputed,
+                                 otherwise compute them
+        """
+        return _swigfaiss.IndexIVFPQ_encode_multiple(self, n, keys, x, codes, compute_keys)
+
+    def decode_multiple(self, n, keys, xcodes, x):
+        r""" inverse of encode_multiple"""
+        return _swigfaiss.IndexIVFPQ_decode_multiple(self, n, keys, xcodes, x)
+
+    def get_InvertedListScanner(self, store_pairs, sel):
+        return _swigfaiss.IndexIVFPQ_get_InvertedListScanner(self, store_pairs, sel)
+
+    def precompute_table(self):
+        r""" build precomputed table"""
+        return _swigfaiss.IndexIVFPQ_precompute_table(self)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFPQ_swiginit(self, _swigfaiss.new_IndexIVFPQ(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFPQ
+
+# Register IndexIVFPQ in _swigfaiss:
+_swigfaiss.IndexIVFPQ_swigregister(IndexIVFPQ)
+
+def initialize_IVFPQ_precomputed_table(use_precomputed_table, quantizer, pq, precomputed_table, by_residual, verbose):
+    r"""
+     Pre-compute distance tables for IVFPQ with by-residual and METRIC_L2
+
+    :type use_precomputed_table: int
+    :param use_precomputed_table: (I/O)
+               =-1: force disable
+               =0: decide heuristically (default: use tables only if they are
+                   < precomputed_tables_max_bytes), set use_precomputed_table on
+        output =1: tables that work for all quantizers (size 256 * nlist * M) =2:
+        specific version for MultiIndexQuantizer (much more compact)
+    :type precomputed_table: faiss::AlignedTable< float,32 >
+    :param precomputed_table: precomputed table to initialize
+    """
+    return _swigfaiss.initialize_IVFPQ_precomputed_table(use_precomputed_table, quantizer, pq, precomputed_table, by_residual, verbose)
+class IndexIVFPQStats(object):
+    r"""
+    statistics are robust to internal threading, but not if
+    IndexIVFPQ::search_preassigned is called by multiple threads
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nrefine = property(_swigfaiss.IndexIVFPQStats_nrefine_get, _swigfaiss.IndexIVFPQStats_nrefine_set, doc=r""" nb of refines (IVFPQR)""")
+    n_hamming_pass = property(_swigfaiss.IndexIVFPQStats_n_hamming_pass_get, _swigfaiss.IndexIVFPQStats_n_hamming_pass_set, doc=r""" nb of passed Hamming distance tests (for polysemous)""")
+    search_cycles = property(_swigfaiss.IndexIVFPQStats_search_cycles_get, _swigfaiss.IndexIVFPQStats_search_cycles_set)
+    refine_cycles = property(_swigfaiss.IndexIVFPQStats_refine_cycles_get, _swigfaiss.IndexIVFPQStats_refine_cycles_set, doc=r""" only for IVFPQR""")
+
+    def __init__(self):
+        _swigfaiss.IndexIVFPQStats_swiginit(self, _swigfaiss.new_IndexIVFPQStats())
+
+    def reset(self):
+        return _swigfaiss.IndexIVFPQStats_reset(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFPQStats
+
+# Register IndexIVFPQStats in _swigfaiss:
+_swigfaiss.IndexIVFPQStats_swigregister(IndexIVFPQStats)
+class IndexIVFPQR(IndexIVFPQ):
+    r""" Index with an additional level of PQ refinement"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    refine_pq = property(_swigfaiss.IndexIVFPQR_refine_pq_get, _swigfaiss.IndexIVFPQR_refine_pq_set, doc=r""" 3rd level quantizer""")
+    refine_codes = property(_swigfaiss.IndexIVFPQR_refine_codes_get, _swigfaiss.IndexIVFPQR_refine_codes_set, doc=r""" corresponding codes""")
+    k_factor = property(_swigfaiss.IndexIVFPQR_k_factor_get, _swigfaiss.IndexIVFPQR_k_factor_set, doc=r""" factor between k requested in search and the k requested from the IVFPQ""")
+
+    def reset(self):
+        return _swigfaiss.IndexIVFPQR_reset(self)
+
+    def remove_ids(self, sel):
+        return _swigfaiss.IndexIVFPQR_remove_ids(self, sel)
+
+    def train_encoder(self, n, x, assign):
+        r""" trains the two product quantizers"""
+        return _swigfaiss.IndexIVFPQR_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        return _swigfaiss.IndexIVFPQR_train_encoder_num_vectors(self)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss.IndexIVFPQR_add_with_ids(self, n, x, xids)
+
+    def add_core(self, n, x, xids, precomputed_idx, inverted_list_context=None):
+        r""" same as add_with_ids, but optionally use the precomputed list ids"""
+        return _swigfaiss.IndexIVFPQR_add_core(self, n, x, xids, precomputed_idx, inverted_list_context)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        return _swigfaiss.IndexIVFPQR_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def merge_from(self, otherIndex, add_id):
+        return _swigfaiss.IndexIVFPQR_merge_from(self, otherIndex, add_id)
+
+    def search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params=None, stats=None):
+        return _swigfaiss.IndexIVFPQR_search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params, stats)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFPQR_swiginit(self, _swigfaiss.new_IndexIVFPQR(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFPQR
+
+# Register IndexIVFPQR in _swigfaiss:
+_swigfaiss.IndexIVFPQR_swigregister(IndexIVFPQR)
+class Index2Layer(IndexFlatCodes):
+    r"""
+     Same as an IndexIVFPQ without the inverted lists: codes are stored
+    sequentially
+
+    The class is mainly inteded to store encoded vectors that can be
+    accessed randomly, the search function is not implemented.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    q1 = property(_swigfaiss.Index2Layer_q1_get, _swigfaiss.Index2Layer_q1_set, doc=r""" first level quantizer""")
+    pq = property(_swigfaiss.Index2Layer_pq_get, _swigfaiss.Index2Layer_pq_set, doc=r""" second level quantizer is always a PQ""")
+    code_size_1 = property(_swigfaiss.Index2Layer_code_size_1_get, _swigfaiss.Index2Layer_code_size_1_set, doc=r""" size of the code for the first level (ceil(log8(q1.nlist)))""")
+    code_size_2 = property(_swigfaiss.Index2Layer_code_size_2_get, _swigfaiss.Index2Layer_code_size_2_set, doc=r""" size of the code for the second level""")
+
+    def __init__(self, *args):
+        _swigfaiss.Index2Layer_swiginit(self, _swigfaiss.new_Index2Layer(*args))
+    __swig_destroy__ = _swigfaiss.delete_Index2Layer
+
+    def train(self, n, x):
+        return _swigfaiss.Index2Layer_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" not implemented"""
+        return _swigfaiss.Index2Layer_search(self, n, x, k, distances, labels, params)
+
+    def get_distance_computer(self):
+        return _swigfaiss.Index2Layer_get_distance_computer(self)
+
+    def transfer_to_IVFPQ(self, other):
+        r""" transfer the flat codes to an IVFPQ index"""
+        return _swigfaiss.Index2Layer_transfer_to_IVFPQ(self, other)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss.Index2Layer_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.Index2Layer_sa_decode(self, n, bytes, x)
+
+# Register Index2Layer in _swigfaiss:
+_swigfaiss.Index2Layer_swigregister(Index2Layer)
+class IndexFastScan(Index):
+    r"""
+     Fast scan version of IndexPQ and IndexAQ. Works for 4-bit PQ and AQ for now.
+
+    The codes are not stored sequentially but grouped in blocks of size bbs.
+    This makes it possible to compute distances quickly with SIMD instructions.
+    The trailing codes (padding codes that are added to complete the last code)
+    are garbage.
+
+    Implementations:
+    12: blocked loop with internal loop on Q with qbs
+    13: same with reservoir accumulator to store results
+    14: no qbs with heap accumulator
+    15: no qbs with reservoir accumulator
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    implem = property(_swigfaiss.IndexFastScan_implem_get, _swigfaiss.IndexFastScan_implem_set)
+    skip = property(_swigfaiss.IndexFastScan_skip_get, _swigfaiss.IndexFastScan_skip_set)
+    bbs = property(_swigfaiss.IndexFastScan_bbs_get, _swigfaiss.IndexFastScan_bbs_set)
+    qbs = property(_swigfaiss.IndexFastScan_qbs_get, _swigfaiss.IndexFastScan_qbs_set)
+    M = property(_swigfaiss.IndexFastScan_M_get, _swigfaiss.IndexFastScan_M_set)
+    nbits = property(_swigfaiss.IndexFastScan_nbits_get, _swigfaiss.IndexFastScan_nbits_set)
+    ksub = property(_swigfaiss.IndexFastScan_ksub_get, _swigfaiss.IndexFastScan_ksub_set)
+    code_size = property(_swigfaiss.IndexFastScan_code_size_get, _swigfaiss.IndexFastScan_code_size_set)
+    ntotal2 = property(_swigfaiss.IndexFastScan_ntotal2_get, _swigfaiss.IndexFastScan_ntotal2_set)
+    M2 = property(_swigfaiss.IndexFastScan_M2_get, _swigfaiss.IndexFastScan_M2_set)
+    codes = property(_swigfaiss.IndexFastScan_codes_get, _swigfaiss.IndexFastScan_codes_set)
+    orig_codes = property(_swigfaiss.IndexFastScan_orig_codes_get, _swigfaiss.IndexFastScan_orig_codes_set)
+
+    def init_fastscan(self, d, M, nbits, metric, bbs):
+        return _swigfaiss.IndexFastScan_init_fastscan(self, d, M, nbits, metric, bbs)
+
+    def reset(self):
+        return _swigfaiss.IndexFastScan_reset(self)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexFastScan_search(self, n, x, k, distances, labels, params)
+
+    def add(self, n, x):
+        return _swigfaiss.IndexFastScan_add(self, n, x)
+
+    def compute_codes(self, codes, n, x):
+        return _swigfaiss.IndexFastScan_compute_codes(self, codes, n, x)
+
+    def compute_float_LUT(self, lut, n, x):
+        return _swigfaiss.IndexFastScan_compute_float_LUT(self, lut, n, x)
+
+    def compute_quantized_LUT(self, n, x, lut, normalizers):
+        return _swigfaiss.IndexFastScan_compute_quantized_LUT(self, n, x, lut, normalizers)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexFastScan_reconstruct(self, key, recons)
+
+    def remove_ids(self, sel):
+        return _swigfaiss.IndexFastScan_remove_ids(self, sel)
+
+    def get_CodePacker(self):
+        return _swigfaiss.IndexFastScan_get_CodePacker(self)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss.IndexFastScan_merge_from(self, otherIndex, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss.IndexFastScan_check_compatible_for_merge(self, otherIndex)
+    __swig_destroy__ = _swigfaiss.delete_IndexFastScan
+
+# Register IndexFastScan in _swigfaiss:
+_swigfaiss.IndexFastScan_swigregister(IndexFastScan)
+class FastScanStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    t0 = property(_swigfaiss.FastScanStats_t0_get, _swigfaiss.FastScanStats_t0_set)
+    t1 = property(_swigfaiss.FastScanStats_t1_get, _swigfaiss.FastScanStats_t1_set)
+    t2 = property(_swigfaiss.FastScanStats_t2_get, _swigfaiss.FastScanStats_t2_set)
+    t3 = property(_swigfaiss.FastScanStats_t3_get, _swigfaiss.FastScanStats_t3_set)
+
+    def __init__(self):
+        _swigfaiss.FastScanStats_swiginit(self, _swigfaiss.new_FastScanStats())
+
+    def reset(self):
+        return _swigfaiss.FastScanStats_reset(self)
+    __swig_destroy__ = _swigfaiss.delete_FastScanStats
+
+# Register FastScanStats in _swigfaiss:
+_swigfaiss.FastScanStats_swigregister(FastScanStats)
+class IndexAdditiveQuantizerFastScan(IndexFastScan):
+    r"""
+     Fast scan version of IndexAQ. Works for 4-bit AQ for now.
+
+    The codes are not stored sequentially but grouped in blocks of size bbs.
+    This makes it possible to compute distances quickly with SIMD instructions.
+
+    Implementations:
+    12: blocked loop with internal loop on Q with qbs
+    13: same with reservoir accumulator to store results
+    14: no qbs with heap accumulator
+    15: no qbs with reservoir accumulator
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    aq = property(_swigfaiss.IndexAdditiveQuantizerFastScan_aq_get, _swigfaiss.IndexAdditiveQuantizerFastScan_aq_set)
+    rescale_norm = property(_swigfaiss.IndexAdditiveQuantizerFastScan_rescale_norm_get, _swigfaiss.IndexAdditiveQuantizerFastScan_rescale_norm_set)
+    norm_scale = property(_swigfaiss.IndexAdditiveQuantizerFastScan_norm_scale_get, _swigfaiss.IndexAdditiveQuantizerFastScan_norm_scale_set)
+    max_train_points = property(_swigfaiss.IndexAdditiveQuantizerFastScan_max_train_points_get, _swigfaiss.IndexAdditiveQuantizerFastScan_max_train_points_set)
+
+    def init(self, *args):
+        return _swigfaiss.IndexAdditiveQuantizerFastScan_init(self, *args)
+    __swig_destroy__ = _swigfaiss.delete_IndexAdditiveQuantizerFastScan
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+        build from an existing IndexAQ
+
+        |
+
+        *Overload 2:*
+        build from an existing IndexAQ
+        """
+        _swigfaiss.IndexAdditiveQuantizerFastScan_swiginit(self, _swigfaiss.new_IndexAdditiveQuantizerFastScan(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexAdditiveQuantizerFastScan_train(self, n, x)
+
+    def estimate_norm_scale(self, n, x):
+        return _swigfaiss.IndexAdditiveQuantizerFastScan_estimate_norm_scale(self, n, x)
+
+    def compute_codes(self, codes, n, x):
+        return _swigfaiss.IndexAdditiveQuantizerFastScan_compute_codes(self, codes, n, x)
+
+    def compute_float_LUT(self, lut, n, x):
+        return _swigfaiss.IndexAdditiveQuantizerFastScan_compute_float_LUT(self, lut, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexAdditiveQuantizerFastScan_search(self, n, x, k, distances, labels, params)
+
+    def sa_decode(self, n, bytes, x):
+        r"""
+         Decode a set of vectors.
+
+         NOTE: The codes in the IndexAdditiveQuantizerFastScan object are non-
+               contiguous. But this method requires a contiguous representation.
+
+        :type n: int
+        :param n:       number of vectors
+        :type bytes: uint8_t
+        :param bytes:   input encoded vectors, size n * code_size
+        :type x: float
+        :param x:       output vectors, size n * d
+        """
+        return _swigfaiss.IndexAdditiveQuantizerFastScan_sa_decode(self, n, bytes, x)
+
+# Register IndexAdditiveQuantizerFastScan in _swigfaiss:
+_swigfaiss.IndexAdditiveQuantizerFastScan_swigregister(IndexAdditiveQuantizerFastScan)
+class IndexResidualQuantizerFastScan(IndexAdditiveQuantizerFastScan):
+    r"""
+     Index based on a residual quantizer. Stored vectors are
+    approximated by residual quantization codes.
+    Can also be used as a codec
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rq = property(_swigfaiss.IndexResidualQuantizerFastScan_rq_get, _swigfaiss.IndexResidualQuantizerFastScan_rq_set, doc=r""" The residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexResidualQuantizerFastScan_swiginit(self, _swigfaiss.new_IndexResidualQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexResidualQuantizerFastScan
+
+# Register IndexResidualQuantizerFastScan in _swigfaiss:
+_swigfaiss.IndexResidualQuantizerFastScan_swigregister(IndexResidualQuantizerFastScan)
+class IndexLocalSearchQuantizerFastScan(IndexAdditiveQuantizerFastScan):
+    r"""
+     Index based on a local search quantizer. Stored vectors are
+    approximated by local search quantization codes.
+    Can also be used as a codec
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lsq = property(_swigfaiss.IndexLocalSearchQuantizerFastScan_lsq_get, _swigfaiss.IndexLocalSearchQuantizerFastScan_lsq_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexLocalSearchQuantizerFastScan_swiginit(self, _swigfaiss.new_IndexLocalSearchQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexLocalSearchQuantizerFastScan
+
+# Register IndexLocalSearchQuantizerFastScan in _swigfaiss:
+_swigfaiss.IndexLocalSearchQuantizerFastScan_swigregister(IndexLocalSearchQuantizerFastScan)
+class IndexProductResidualQuantizerFastScan(IndexAdditiveQuantizerFastScan):
+    r"""
+     Index based on a product residual quantizer. Stored vectors are
+    approximated by product residual quantization codes.
+    Can also be used as a codec
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    prq = property(_swigfaiss.IndexProductResidualQuantizerFastScan_prq_get, _swigfaiss.IndexProductResidualQuantizerFastScan_prq_set, doc=r""" The product residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexProductResidualQuantizerFastScan_swiginit(self, _swigfaiss.new_IndexProductResidualQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexProductResidualQuantizerFastScan
+
+# Register IndexProductResidualQuantizerFastScan in _swigfaiss:
+_swigfaiss.IndexProductResidualQuantizerFastScan_swigregister(IndexProductResidualQuantizerFastScan)
+class IndexProductLocalSearchQuantizerFastScan(IndexAdditiveQuantizerFastScan):
+    r"""
+     Index based on a product local search quantizer. Stored vectors are
+    approximated by product local search quantization codes.
+    Can also be used as a codec
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    plsq = property(_swigfaiss.IndexProductLocalSearchQuantizerFastScan_plsq_get, _swigfaiss.IndexProductLocalSearchQuantizerFastScan_plsq_set, doc=r""" The product local search quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexProductLocalSearchQuantizerFastScan_swiginit(self, _swigfaiss.new_IndexProductLocalSearchQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexProductLocalSearchQuantizerFastScan
+
+# Register IndexProductLocalSearchQuantizerFastScan in _swigfaiss:
+_swigfaiss.IndexProductLocalSearchQuantizerFastScan_swigregister(IndexProductLocalSearchQuantizerFastScan)
+class IndexPQFastScan(IndexFastScan):
+    r"""
+     Fast scan version of IndexPQ. Works for 4-bit PQ for now.
+
+    The codes are not stored sequentially but grouped in blocks of size bbs.
+    This makes it possible to compute distances quickly with SIMD instructions.
+
+    Implementations:
+    12: blocked loop with internal loop on Q with qbs
+    13: same with reservoir accumulator to store results
+    14: no qbs with heap accumulator
+    15: no qbs with reservoir accumulator
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    pq = property(_swigfaiss.IndexPQFastScan_pq_get, _swigfaiss.IndexPQFastScan_pq_set)
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+        build from an existing IndexPQ
+
+        |
+
+        *Overload 2:*
+        build from an existing IndexPQ
+        """
+        _swigfaiss.IndexPQFastScan_swiginit(self, _swigfaiss.new_IndexPQFastScan(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexPQFastScan_train(self, n, x)
+
+    def compute_codes(self, codes, n, x):
+        return _swigfaiss.IndexPQFastScan_compute_codes(self, codes, n, x)
+
+    def compute_float_LUT(self, lut, n, x):
+        return _swigfaiss.IndexPQFastScan_compute_float_LUT(self, lut, n, x)
+
+    def sa_decode(self, n, bytes, x):
+        r"""
+         Decode a set of vectors.
+
+         NOTE: The codes in the IndexPQFastScan object are non-contiguous.
+               But this method requires a contiguous representation.
+
+        :type n: int
+        :param n:       number of vectors
+        :type bytes: uint8_t
+        :param bytes:   input encoded vectors, size n * code_size
+        :type x: float
+        :param x:       output vectors, size n * d
+        """
+        return _swigfaiss.IndexPQFastScan_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexPQFastScan
+
+# Register IndexPQFastScan in _swigfaiss:
+_swigfaiss.IndexPQFastScan_swigregister(IndexPQFastScan)
+class simd16uint16(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss.simd16uint16_swiginit(self, _swigfaiss.new_simd16uint16())
+    __swig_destroy__ = _swigfaiss.delete_simd16uint16
+
+# Register simd16uint16 in _swigfaiss:
+_swigfaiss.simd16uint16_swigregister(simd16uint16)
+class SIMDResultHandler(object):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+      This file contains callbacks for kernels that compute distances.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    is_CMax = property(_swigfaiss.SIMDResultHandler_is_CMax_get, _swigfaiss.SIMDResultHandler_is_CMax_set)
+    sizeof_ids = property(_swigfaiss.SIMDResultHandler_sizeof_ids_get, _swigfaiss.SIMDResultHandler_sizeof_ids_set)
+    with_fields = property(_swigfaiss.SIMDResultHandler_with_fields_get, _swigfaiss.SIMDResultHandler_with_fields_set)
+
+    def handle(self, q, b, d0, d1):
+        r"""
+        called when 32 distances are computed and provided in two
+        simd16uint16. (q, b) indicate which entry it is in the block.
+        """
+        return _swigfaiss.SIMDResultHandler_handle(self, q, b, d0, d1)
+
+    def set_block_origin(self, i0, j0):
+        r""" set the sub-matrix that is being computed"""
+        return _swigfaiss.SIMDResultHandler_set_block_origin(self, i0, j0)
+    __swig_destroy__ = _swigfaiss.delete_SIMDResultHandler
+
+# Register SIMDResultHandler in _swigfaiss:
+_swigfaiss.SIMDResultHandler_swigregister(SIMDResultHandler)
+class SIMDResultHandlerToFloat(SIMDResultHandler):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss.SIMDResultHandlerToFloat_nq_get, _swigfaiss.SIMDResultHandlerToFloat_nq_set)
+    ntotal = property(_swigfaiss.SIMDResultHandlerToFloat_ntotal_get, _swigfaiss.SIMDResultHandlerToFloat_ntotal_set)
+    id_map = property(_swigfaiss.SIMDResultHandlerToFloat_id_map_get, _swigfaiss.SIMDResultHandlerToFloat_id_map_set, doc=r""" these fields are used mainly for the IVF variants (with_id_map=true)""")
+    q_map = property(_swigfaiss.SIMDResultHandlerToFloat_q_map_get, _swigfaiss.SIMDResultHandlerToFloat_q_map_set)
+    dbias = property(_swigfaiss.SIMDResultHandlerToFloat_dbias_get, _swigfaiss.SIMDResultHandlerToFloat_dbias_set)
+    normalizers = property(_swigfaiss.SIMDResultHandlerToFloat_normalizers_get, _swigfaiss.SIMDResultHandlerToFloat_normalizers_set)
+
+    def begin(self, norms):
+        return _swigfaiss.SIMDResultHandlerToFloat_begin(self, norms)
+
+    def end(self):
+        return _swigfaiss.SIMDResultHandlerToFloat_end(self)
+    __swig_destroy__ = _swigfaiss.delete_SIMDResultHandlerToFloat
+
+# Register SIMDResultHandlerToFloat in _swigfaiss:
+_swigfaiss.SIMDResultHandlerToFloat_swigregister(SIMDResultHandlerToFloat)
+class DummyResultHandler(SIMDResultHandler):
+    r"""
+     Dummy structure that just computes a chqecksum on results
+    (to avoid the computation to be optimized away)
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    cs = property(_swigfaiss.DummyResultHandler_cs_get, _swigfaiss.DummyResultHandler_cs_set)
+
+    def handle(self, q, b, d0, d1):
+        return _swigfaiss.DummyResultHandler_handle(self, q, b, d0, d1)
+
+    def set_block_origin(self, arg2, arg3):
+        return _swigfaiss.DummyResultHandler_set_block_origin(self, arg2, arg3)
+    __swig_destroy__ = _swigfaiss.delete_DummyResultHandler
+
+    def __init__(self):
+        _swigfaiss.DummyResultHandler_swiginit(self, _swigfaiss.new_DummyResultHandler())
+
+# Register DummyResultHandler in _swigfaiss:
+_swigfaiss.DummyResultHandler_swigregister(DummyResultHandler)
+class StoreResultHandler(SIMDResultHandler):
+    r"""
+     memorize results in a nq-by-nb matrix.
+
+    j0 is the current upper-left block of the matrix
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    data = property(_swigfaiss.StoreResultHandler_data_get, _swigfaiss.StoreResultHandler_data_set)
+    ld = property(_swigfaiss.StoreResultHandler_ld_get, _swigfaiss.StoreResultHandler_ld_set)
+    i0 = property(_swigfaiss.StoreResultHandler_i0_get, _swigfaiss.StoreResultHandler_i0_set)
+    j0 = property(_swigfaiss.StoreResultHandler_j0_get, _swigfaiss.StoreResultHandler_j0_set)
+
+    def __init__(self, data, ld):
+        _swigfaiss.StoreResultHandler_swiginit(self, _swigfaiss.new_StoreResultHandler(data, ld))
+
+    def handle(self, q, b, d0, d1):
+        return _swigfaiss.StoreResultHandler_handle(self, q, b, d0, d1)
+
+    def set_block_origin(self, i0_in, j0_in):
+        return _swigfaiss.StoreResultHandler_set_block_origin(self, i0_in, j0_in)
+    __swig_destroy__ = _swigfaiss.delete_StoreResultHandler
+
+# Register StoreResultHandler in _swigfaiss:
+_swigfaiss.StoreResultHandler_swigregister(StoreResultHandler)
+class IndexIVFFastScan(IndexIVF):
+    r"""
+     Fast scan version of IVFPQ and IVFAQ. Works for 4-bit PQ/AQ for now.
+
+    The codes in the inverted lists are not stored sequentially but
+    grouped in blocks of size bbs. This makes it possible to very quickly
+    compute distances with SIMD instructions.
+
+    Implementations (implem):
+    0: auto-select implementation (default)
+    1: orig's search, re-implemented
+    2: orig's search, re-ordered by invlist
+    10: optimizer int16 search, collect results in heap, no qbs
+    11: idem, collect results in reservoir
+    12: optimizer int16 search, collect results in heap, uses qbs
+    13: idem, collect results in reservoir
+    14: internally multithreaded implem over nq * nprobe
+    15: same with reservoir
+
+    For range search, only 10 and 12 are supported.
+    add 100 to the implem to force single-thread scanning (the coarse quantizer
+    may still use multiple threads).
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    bbs = property(_swigfaiss.IndexIVFFastScan_bbs_get, _swigfaiss.IndexIVFFastScan_bbs_set)
+    M = property(_swigfaiss.IndexIVFFastScan_M_get, _swigfaiss.IndexIVFFastScan_M_set)
+    nbits = property(_swigfaiss.IndexIVFFastScan_nbits_get, _swigfaiss.IndexIVFFastScan_nbits_set)
+    ksub = property(_swigfaiss.IndexIVFFastScan_ksub_get, _swigfaiss.IndexIVFFastScan_ksub_set)
+    M2 = property(_swigfaiss.IndexIVFFastScan_M2_get, _swigfaiss.IndexIVFFastScan_M2_set)
+    implem = property(_swigfaiss.IndexIVFFastScan_implem_get, _swigfaiss.IndexIVFFastScan_implem_set)
+    skip = property(_swigfaiss.IndexIVFFastScan_skip_get, _swigfaiss.IndexIVFFastScan_skip_set)
+    qbs = property(_swigfaiss.IndexIVFFastScan_qbs_get, _swigfaiss.IndexIVFFastScan_qbs_set)
+    qbs2 = property(_swigfaiss.IndexIVFFastScan_qbs2_get, _swigfaiss.IndexIVFFastScan_qbs2_set)
+
+    def init_fastscan(self, M, nbits, nlist, metric, bbs):
+        return _swigfaiss.IndexIVFFastScan_init_fastscan(self, M, nbits, nlist, metric, bbs)
+
+    def init_code_packer(self):
+        return _swigfaiss.IndexIVFFastScan_init_code_packer(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFFastScan
+    orig_invlists = property(_swigfaiss.IndexIVFFastScan_orig_invlists_get, _swigfaiss.IndexIVFFastScan_orig_invlists_set, doc=r""" orig's inverted lists (for debugging)""")
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss.IndexIVFFastScan_add_with_ids(self, n, x, xids)
+
+    def lookup_table_is_3d(self):
+        return _swigfaiss.IndexIVFFastScan_lookup_table_is_3d(self)
+
+    def compute_LUT(self, n, x, cq, dis_tables, biases):
+        return _swigfaiss.IndexIVFFastScan_compute_LUT(self, n, x, cq, dis_tables, biases)
+
+    def compute_LUT_uint8(self, n, x, cq, dis_tables, biases, normalizers):
+        return _swigfaiss.IndexIVFFastScan_compute_LUT_uint8(self, n, x, cq, dis_tables, biases, normalizers)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexIVFFastScan_search(self, n, x, k, distances, labels, params)
+
+    def search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params=None, stats=None):
+        return _swigfaiss.IndexIVFFastScan_search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params, stats)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss.IndexIVFFastScan_range_search(self, n, x, radius, result, params)
+
+    def search_dispatch_implem(self, n, x, k, distances, labels, cq, scaler):
+        return _swigfaiss.IndexIVFFastScan_search_dispatch_implem(self, n, x, k, distances, labels, cq, scaler)
+
+    def range_search_dispatch_implem(self, n, x, radius, rres, cq_in, scaler):
+        return _swigfaiss.IndexIVFFastScan_range_search_dispatch_implem(self, n, x, radius, rres, cq_in, scaler)
+
+    def search_implem_10(self, n, x, handler, cq, ndis_out, nlist_out, scaler):
+        return _swigfaiss.IndexIVFFastScan_search_implem_10(self, n, x, handler, cq, ndis_out, nlist_out, scaler)
+
+    def search_implem_12(self, n, x, handler, cq, ndis_out, nlist_out, scaler):
+        return _swigfaiss.IndexIVFFastScan_search_implem_12(self, n, x, handler, cq, ndis_out, nlist_out, scaler)
+
+    def search_implem_14(self, n, x, k, distances, labels, cq, impl, scaler):
+        return _swigfaiss.IndexIVFFastScan_search_implem_14(self, n, x, k, distances, labels, cq, impl, scaler)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        return _swigfaiss.IndexIVFFastScan_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def get_CodePacker(self):
+        return _swigfaiss.IndexIVFFastScan_get_CodePacker(self)
+
+    def reconstruct_orig_invlists(self):
+        return _swigfaiss.IndexIVFFastScan_reconstruct_orig_invlists(self)
+
+# Register IndexIVFFastScan in _swigfaiss:
+_swigfaiss.IndexIVFFastScan_swigregister(IndexIVFFastScan)
+class IVFFastScanStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    times = property(_swigfaiss.IVFFastScanStats_times_get, _swigfaiss.IVFFastScanStats_times_set)
+    t_compute_distance_tables = property(_swigfaiss.IVFFastScanStats_t_compute_distance_tables_get, _swigfaiss.IVFFastScanStats_t_compute_distance_tables_set)
+    t_round = property(_swigfaiss.IVFFastScanStats_t_round_get, _swigfaiss.IVFFastScanStats_t_round_set)
+    t_copy_pack = property(_swigfaiss.IVFFastScanStats_t_copy_pack_get, _swigfaiss.IVFFastScanStats_t_copy_pack_set)
+    t_scan = property(_swigfaiss.IVFFastScanStats_t_scan_get, _swigfaiss.IVFFastScanStats_t_scan_set)
+    t_to_flat = property(_swigfaiss.IVFFastScanStats_t_to_flat_get, _swigfaiss.IVFFastScanStats_t_to_flat_set)
+    reservoir_times = property(_swigfaiss.IVFFastScanStats_reservoir_times_get, _swigfaiss.IVFFastScanStats_reservoir_times_set)
+    t_aq_encode = property(_swigfaiss.IVFFastScanStats_t_aq_encode_get, _swigfaiss.IVFFastScanStats_t_aq_encode_set)
+    t_aq_norm_encode = property(_swigfaiss.IVFFastScanStats_t_aq_norm_encode_get, _swigfaiss.IVFFastScanStats_t_aq_norm_encode_set)
+
+    def Mcy_at(self, i):
+        return _swigfaiss.IVFFastScanStats_Mcy_at(self, i)
+
+    def Mcy_reservoir_at(self, i):
+        return _swigfaiss.IVFFastScanStats_Mcy_reservoir_at(self, i)
+
+    def __init__(self):
+        _swigfaiss.IVFFastScanStats_swiginit(self, _swigfaiss.new_IVFFastScanStats())
+
+    def reset(self):
+        return _swigfaiss.IVFFastScanStats_reset(self)
+    __swig_destroy__ = _swigfaiss.delete_IVFFastScanStats
+
+# Register IVFFastScanStats in _swigfaiss:
+_swigfaiss.IVFFastScanStats_swigregister(IVFFastScanStats)
+class IndexIVFAdditiveQuantizerFastScan(IndexIVFFastScan):
+    r"""
+     Fast scan version of IVFAQ. Works for 4-bit AQ for now.
+
+    The codes in the inverted lists are not stored sequentially but
+    grouped in blocks of size bbs. This makes it possible to very quickly
+    compute distances with SIMD instructions.
+
+    Implementations (implem):
+    0: auto-select implementation (default)
+    1: orig's search, re-implemented
+    2: orig's search, re-ordered by invlist
+    10: optimizer int16 search, collect results in heap, no qbs
+    11: idem, collect results in reservoir
+    12: optimizer int16 search, collect results in heap, uses qbs
+    13: idem, collect results in reservoir
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    aq = property(_swigfaiss.IndexIVFAdditiveQuantizerFastScan_aq_get, _swigfaiss.IndexIVFAdditiveQuantizerFastScan_aq_set)
+    rescale_norm = property(_swigfaiss.IndexIVFAdditiveQuantizerFastScan_rescale_norm_get, _swigfaiss.IndexIVFAdditiveQuantizerFastScan_rescale_norm_set)
+    norm_scale = property(_swigfaiss.IndexIVFAdditiveQuantizerFastScan_norm_scale_get, _swigfaiss.IndexIVFAdditiveQuantizerFastScan_norm_scale_set)
+    max_train_points = property(_swigfaiss.IndexIVFAdditiveQuantizerFastScan_max_train_points_get, _swigfaiss.IndexIVFAdditiveQuantizerFastScan_max_train_points_set)
+
+    def init(self, aq, nlist, metric, bbs):
+        return _swigfaiss.IndexIVFAdditiveQuantizerFastScan_init(self, aq, nlist, metric, bbs)
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFAdditiveQuantizerFastScan
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFAdditiveQuantizerFastScan_swiginit(self, _swigfaiss.new_IndexIVFAdditiveQuantizerFastScan(*args))
+
+    def train_encoder(self, n, x, assign):
+        return _swigfaiss.IndexIVFAdditiveQuantizerFastScan_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        return _swigfaiss.IndexIVFAdditiveQuantizerFastScan_train_encoder_num_vectors(self)
+
+    def estimate_norm_scale(self, n, x):
+        return _swigfaiss.IndexIVFAdditiveQuantizerFastScan_estimate_norm_scale(self, n, x)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listno=False):
+        r"""
+        same as the regular IVFAQ encoder. The codes are not reorganized by
+        blocks a that point
+        """
+        return _swigfaiss.IndexIVFAdditiveQuantizerFastScan_encode_vectors(self, n, x, list_nos, codes, include_listno)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexIVFAdditiveQuantizerFastScan_search(self, n, x, k, distances, labels, params)
+
+    def lookup_table_is_3d(self):
+        return _swigfaiss.IndexIVFAdditiveQuantizerFastScan_lookup_table_is_3d(self)
+
+    def compute_LUT(self, n, x, cq, dis_tables, biases):
+        return _swigfaiss.IndexIVFAdditiveQuantizerFastScan_compute_LUT(self, n, x, cq, dis_tables, biases)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexIVFAdditiveQuantizerFastScan_sa_decode(self, n, bytes, x)
+
+# Register IndexIVFAdditiveQuantizerFastScan in _swigfaiss:
+_swigfaiss.IndexIVFAdditiveQuantizerFastScan_swigregister(IndexIVFAdditiveQuantizerFastScan)
+class IndexIVFLocalSearchQuantizerFastScan(IndexIVFAdditiveQuantizerFastScan):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lsq = property(_swigfaiss.IndexIVFLocalSearchQuantizerFastScan_lsq_get, _swigfaiss.IndexIVFLocalSearchQuantizerFastScan_lsq_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFLocalSearchQuantizerFastScan_swiginit(self, _swigfaiss.new_IndexIVFLocalSearchQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFLocalSearchQuantizerFastScan
+
+# Register IndexIVFLocalSearchQuantizerFastScan in _swigfaiss:
+_swigfaiss.IndexIVFLocalSearchQuantizerFastScan_swigregister(IndexIVFLocalSearchQuantizerFastScan)
+class IndexIVFResidualQuantizerFastScan(IndexIVFAdditiveQuantizerFastScan):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rq = property(_swigfaiss.IndexIVFResidualQuantizerFastScan_rq_get, _swigfaiss.IndexIVFResidualQuantizerFastScan_rq_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFResidualQuantizerFastScan_swiginit(self, _swigfaiss.new_IndexIVFResidualQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFResidualQuantizerFastScan
+
+# Register IndexIVFResidualQuantizerFastScan in _swigfaiss:
+_swigfaiss.IndexIVFResidualQuantizerFastScan_swigregister(IndexIVFResidualQuantizerFastScan)
+class IndexIVFProductLocalSearchQuantizerFastScan(IndexIVFAdditiveQuantizerFastScan):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    plsq = property(_swigfaiss.IndexIVFProductLocalSearchQuantizerFastScan_plsq_get, _swigfaiss.IndexIVFProductLocalSearchQuantizerFastScan_plsq_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFProductLocalSearchQuantizerFastScan_swiginit(self, _swigfaiss.new_IndexIVFProductLocalSearchQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFProductLocalSearchQuantizerFastScan
+
+# Register IndexIVFProductLocalSearchQuantizerFastScan in _swigfaiss:
+_swigfaiss.IndexIVFProductLocalSearchQuantizerFastScan_swigregister(IndexIVFProductLocalSearchQuantizerFastScan)
+class IndexIVFProductResidualQuantizerFastScan(IndexIVFAdditiveQuantizerFastScan):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    prq = property(_swigfaiss.IndexIVFProductResidualQuantizerFastScan_prq_get, _swigfaiss.IndexIVFProductResidualQuantizerFastScan_prq_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFProductResidualQuantizerFastScan_swiginit(self, _swigfaiss.new_IndexIVFProductResidualQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFProductResidualQuantizerFastScan
+
+# Register IndexIVFProductResidualQuantizerFastScan in _swigfaiss:
+_swigfaiss.IndexIVFProductResidualQuantizerFastScan_swigregister(IndexIVFProductResidualQuantizerFastScan)
+class IndexIVFIndependentQuantizer(Index):
+    r"""
+     An IVF index with a quantizer that has a different input dimension from the
+    payload size. The vectors to encode are obtained from the input vectors by a
+    VectorTransform.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    quantizer = property(_swigfaiss.IndexIVFIndependentQuantizer_quantizer_get, _swigfaiss.IndexIVFIndependentQuantizer_quantizer_set, doc=r""" quantizer is fed directly with the input vectors""")
+    vt = property(_swigfaiss.IndexIVFIndependentQuantizer_vt_get, _swigfaiss.IndexIVFIndependentQuantizer_vt_set, doc=r""" transform before the IVF vectors are applied""")
+    index_ivf = property(_swigfaiss.IndexIVFIndependentQuantizer_index_ivf_get, _swigfaiss.IndexIVFIndependentQuantizer_index_ivf_set, doc=r""" the IVF index, controls nlist and nprobe""")
+    own_fields = property(_swigfaiss.IndexIVFIndependentQuantizer_own_fields_get, _swigfaiss.IndexIVFIndependentQuantizer_own_fields_set, doc=r""" whether *this owns the 3 fields""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFIndependentQuantizer_swiginit(self, _swigfaiss.new_IndexIVFIndependentQuantizer(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexIVFIndependentQuantizer_train(self, n, x)
+
+    def add(self, n, x):
+        return _swigfaiss.IndexIVFIndependentQuantizer_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexIVFIndependentQuantizer_search(self, n, x, k, distances, labels, params)
+
+    def reset(self):
+        return _swigfaiss.IndexIVFIndependentQuantizer_reset(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFIndependentQuantizer
+
+# Register IndexIVFIndependentQuantizer in _swigfaiss:
+_swigfaiss.IndexIVFIndependentQuantizer_swigregister(IndexIVFIndependentQuantizer)
+class IndexIVFPQFastScan(IndexIVFFastScan):
+    r"""
+     Fast scan version of IVFPQ. Works for 4-bit PQ for now.
+
+    The codes in the inverted lists are not stored sequentially but
+    grouped in blocks of size bbs. This makes it possible to very quickly
+    compute distances with SIMD instructions.
+
+    Implementations (implem):
+    0: auto-select implementation (default)
+    1: orig's search, re-implemented
+    2: orig's search, re-ordered by invlist
+    10: optimizer int16 search, collect results in heap, no qbs
+    11: idem, collect results in reservoir
+    12: optimizer int16 search, collect results in heap, uses qbs
+    13: idem, collect results in reservoir
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    pq = property(_swigfaiss.IndexIVFPQFastScan_pq_get, _swigfaiss.IndexIVFPQFastScan_pq_set, doc=r""" produces the codes""")
+    use_precomputed_table = property(_swigfaiss.IndexIVFPQFastScan_use_precomputed_table_get, _swigfaiss.IndexIVFPQFastScan_use_precomputed_table_set, doc=r""" precomputed tables management""")
+    precomputed_table = property(_swigfaiss.IndexIVFPQFastScan_precomputed_table_get, _swigfaiss.IndexIVFPQFastScan_precomputed_table_set, doc=r""" if use_precompute_table size (nlist, pq.M, pq.ksub)""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIVFPQFastScan_swiginit(self, _swigfaiss.new_IndexIVFPQFastScan(*args))
+
+    def train_encoder(self, n, x, assign):
+        return _swigfaiss.IndexIVFPQFastScan_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        return _swigfaiss.IndexIVFPQFastScan_train_encoder_num_vectors(self)
+
+    def precompute_table(self):
+        r""" build precomputed table, possibly updating use_precomputed_table"""
+        return _swigfaiss.IndexIVFPQFastScan_precompute_table(self)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listno=False):
+        r"""
+        same as the regular IVFPQ encoder. The codes are not reorganized by
+        blocks a that point
+        """
+        return _swigfaiss.IndexIVFPQFastScan_encode_vectors(self, n, x, list_nos, codes, include_listno)
+
+    def lookup_table_is_3d(self):
+        return _swigfaiss.IndexIVFPQFastScan_lookup_table_is_3d(self)
+
+    def compute_LUT(self, n, x, cq, dis_tables, biases):
+        return _swigfaiss.IndexIVFPQFastScan_compute_LUT(self, n, x, cq, dis_tables, biases)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexIVFPQFastScan_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexIVFPQFastScan
+
+# Register IndexIVFPQFastScan in _swigfaiss:
+_swigfaiss.IndexIVFPQFastScan_swigregister(IndexIVFPQFastScan)
+
+def round_uint8_per_column(tab, n, d, a_out=None, b_out=None):
+    r"""
+     Functions to quantize PQ floating-point Look Up Tables (LUT) to uint8, and
+    biases to uint16. The accumulation is supposed to take place in uint16.
+    The quantization coefficients are float (a, b) such that
+
+         original_value = quantized_value * a / b
+
+    The hardest part of the quantization is with multiple LUTs that need to be
+    added up together. In that case, coefficient a has to be chosen so that
+    the sum fits in a uint16 accumulator.
+    """
+    return _swigfaiss.round_uint8_per_column(tab, n, d, a_out, b_out)
+
+def round_uint8_per_column_multi(tab, m, n, d, a_out=None, b_out=None):
+    return _swigfaiss.round_uint8_per_column_multi(tab, m, n, d, a_out, b_out)
+
+def quantize_LUT_and_bias(nprobe, M, ksub, lut_is_3d, LUT, bias, LUTq, M2, biasq, a_out=None, b_out=None):
+    r"""
+     LUT quantization to uint8 and bias to uint16.
+
+    (nprobe, M, ksub, lut_is_3d) determine the size of the the LUT
+
+     LUT input:
+     - 2D size (M, ksub): single matrix per probe (lut_is_3d=false)
+     - 3D size (nprobe, M, ksub): separate LUT per probe (lut_is_3d=true)
+     bias input:
+     - nullptr: bias is 0
+     - size (nprobe): one bias per probe
+     Output:
+     - LUTq uint8 version of the LUT (M size is rounded up to M2)
+     - biasq (or nullptr): uint16 version of the LUT
+     - a, b: scalars to approximate the true distance
+    """
+    return _swigfaiss.quantize_LUT_and_bias(nprobe, M, ksub, lut_is_3d, LUT, bias, LUTq, M2, biasq, a_out, b_out)
+
+def aq_quantize_LUT_and_bias(nprobe, M, ksub, LUT, bias, M_norm, norm_scale, LUTq, M2, biasq, a_out, b_out):
+    return _swigfaiss.aq_quantize_LUT_and_bias(nprobe, M, ksub, LUT, bias, M_norm, norm_scale, LUTq, M2, biasq, a_out, b_out)
+
+def aq_estimate_norm_scale(M, ksub, M_norm, LUT):
+    return _swigfaiss.aq_estimate_norm_scale(M, ksub, M_norm, LUT)
+class IndexBinary(object):
+    r"""
+     Abstract structure for a binary index.
+
+    Supports adding vertices and searching them.
+
+    All queries are symmetric because there is no distinction between codes and
+    vectors.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    d = property(_swigfaiss.IndexBinary_d_get, _swigfaiss.IndexBinary_d_set, doc=r""" vector dimension""")
+    code_size = property(_swigfaiss.IndexBinary_code_size_get, _swigfaiss.IndexBinary_code_size_set, doc=r""" number of bytes per vector ( = d / 8 )""")
+    ntotal = property(_swigfaiss.IndexBinary_ntotal_get, _swigfaiss.IndexBinary_ntotal_set, doc=r""" total nb of indexed vectors""")
+    verbose = property(_swigfaiss.IndexBinary_verbose_get, _swigfaiss.IndexBinary_verbose_set, doc=r""" verbosity level""")
+    is_trained = property(_swigfaiss.IndexBinary_is_trained_get, _swigfaiss.IndexBinary_is_trained_set, doc=r"""
+    set if the Index does not require training, or if training is done
+    already
+    """)
+    metric_type = property(_swigfaiss.IndexBinary_metric_type_get, _swigfaiss.IndexBinary_metric_type_set, doc=r""" type of metric this index uses for search""")
+    __swig_destroy__ = _swigfaiss.delete_IndexBinary
+
+    def train(self, n, x):
+        r"""
+         Perform training on a representative set of vectors.
+
+        :type n: int
+        :param n:      nb of training vectors
+        :type x: uint8_t
+        :param x:      training vecors, size n * d / 8
+        """
+        return _swigfaiss.IndexBinary_train(self, n, x)
+
+    def add(self, n, x):
+        r"""
+         Add n vectors of dimension d to the index.
+
+        Vectors are implicitly assigned labels ntotal .. ntotal + n - 1
+        :type x: uint8_t
+        :param x:      input matrix, size n * d / 8
+        """
+        return _swigfaiss.IndexBinary_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        r"""
+         Same as add, but stores xids instead of sequential ids.
+
+        The default implementation fails with an assertion, as it is
+        not supported by all indexes.
+
+        :type xids: int
+        :param xids: if non-null, ids to store for the vectors (size n)
+        """
+        return _swigfaiss.IndexBinary_add_with_ids(self, n, x, xids)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r"""
+         Query n vectors of dimension d to the index.
+
+        return at most k vectors. If there are not enough results for a
+        query, the result array is padded with -1s.
+
+        :type x: uint8_t
+        :param x:           input vectors to search, size n * d / 8
+        :type labels: int
+        :param labels:      output labels of the NNs, size n*k
+        :type distances: int
+        :param distances:   output pairwise distances, size n*k
+        """
+        return _swigfaiss.IndexBinary_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        r"""
+         Query n vectors of dimension d to the index.
+
+        return all vectors with distance < radius. Note that many indexes
+        do not implement the range_search (only the k-NN search is
+        mandatory). The distances are converted to float to reuse the
+        RangeSearchResult structure, but they are integer. By convention,
+        only distances < radius (strict comparison) are returned,
+        ie. radius = 0 does not return any result and 1 returns only
+        exact same vectors.
+
+        :type x: uint8_t
+        :param x:           input vectors to search, size n * d / 8
+        :type radius: int
+        :param radius:      search radius
+        :type result: :py:class:`RangeSearchResult`
+        :param result:      result table
+        """
+        return _swigfaiss.IndexBinary_range_search(self, n, x, radius, result, params)
+
+    def assign(self, n, x, labels, k=1):
+        r"""
+         Return the indexes of the k vectors closest to the query x.
+
+        This function is identical to search but only returns labels of
+        neighbors.
+        :type x: uint8_t
+        :param x:           input vectors to search, size n * d / 8
+        :type labels: int
+        :param labels:      output labels of the NNs, size n*k
+        """
+        return _swigfaiss.IndexBinary_assign(self, n, x, labels, k)
+
+    def reset(self):
+        r""" Removes all elements from the database."""
+        return _swigfaiss.IndexBinary_reset(self)
+
+    def remove_ids(self, sel):
+        r""" Removes IDs from the index. Not supported by all indexes."""
+        return _swigfaiss.IndexBinary_remove_ids(self, sel)
+
+    def reconstruct(self, key, recons):
+        r"""
+         Reconstruct a stored vector.
+
+        This function may not be defined for some indexes.
+        :type key: int
+        :param key:         id of the vector to reconstruct
+        :type recons: uint8_t
+        :param recons:      reconstucted vector (size d / 8)
+        """
+        return _swigfaiss.IndexBinary_reconstruct(self, key, recons)
+
+    def reconstruct_n(self, i0, ni, recons):
+        r"""
+         Reconstruct vectors i0 to i0 + ni - 1.
+
+        This function may not be defined for some indexes.
+        :type recons: uint8_t
+        :param recons:      reconstucted vectors (size ni * d / 8)
+        """
+        return _swigfaiss.IndexBinary_reconstruct_n(self, i0, ni, recons)
+
+    def search_and_reconstruct(self, n, x, k, distances, labels, recons, params=None):
+        r"""
+         Similar to search, but also reconstructs the stored vectors (or an
+        approximation in the case of lossy coding) for the search results.
+
+        If there are not enough results for a query, the resulting array
+        is padded with -1s.
+
+        :type recons: uint8_t
+        :param recons:      reconstructed vectors size (n, k, d)
+        """
+        return _swigfaiss.IndexBinary_search_and_reconstruct(self, n, x, k, distances, labels, recons, params)
+
+    def display(self):
+        r""" Display the actual class name and some more info."""
+        return _swigfaiss.IndexBinary_display(self)
+
+    def merge_from(self, otherIndex, add_id=0):
+        r"""
+         moves the entries from another dataset to self.
+        On output, other is empty.
+        add_id is added to all moved ids
+        (for sequential ids, this would be this->ntotal)
+        """
+        return _swigfaiss.IndexBinary_merge_from(self, otherIndex, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        r"""
+         check that the two indexes are compatible (ie, they are
+        trained in the same way and have the same
+        parameters). Otherwise throw.
+        """
+        return _swigfaiss.IndexBinary_check_compatible_for_merge(self, otherIndex)
+
+# Register IndexBinary in _swigfaiss:
+_swigfaiss.IndexBinary_swigregister(IndexBinary)
+class IndexBinaryFlat(IndexBinary):
+    r""" Index that stores the full vectors and performs exhaustive search."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    xb = property(_swigfaiss.IndexBinaryFlat_xb_get, _swigfaiss.IndexBinaryFlat_xb_set, doc=r""" database vectors, size ntotal * d / 8""")
+    use_heap = property(_swigfaiss.IndexBinaryFlat_use_heap_get, _swigfaiss.IndexBinaryFlat_use_heap_set, doc=r"""
+     Select between using a heap or counting to select the k smallest values
+    when scanning inverted lists.
+    """)
+    query_batch_size = property(_swigfaiss.IndexBinaryFlat_query_batch_size_get, _swigfaiss.IndexBinaryFlat_query_batch_size_set)
+    approx_topk_mode = property(_swigfaiss.IndexBinaryFlat_approx_topk_mode_get, _swigfaiss.IndexBinaryFlat_approx_topk_mode_set)
+
+    def add(self, n, x):
+        return _swigfaiss.IndexBinaryFlat_add(self, n, x)
+
+    def reset(self):
+        return _swigfaiss.IndexBinaryFlat_reset(self)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexBinaryFlat_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss.IndexBinaryFlat_range_search(self, n, x, radius, result, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexBinaryFlat_reconstruct(self, key, recons)
+
+    def remove_ids(self, sel):
+        r"""
+         Remove some ids. Note that because of the indexing structure,
+        the semantics of this operation are different from the usual ones:
+        the new ids are shifted.
+        """
+        return _swigfaiss.IndexBinaryFlat_remove_ids(self, sel)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexBinaryFlat_swiginit(self, _swigfaiss.new_IndexBinaryFlat(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexBinaryFlat
+
+# Register IndexBinaryFlat in _swigfaiss:
+_swigfaiss.IndexBinaryFlat_swigregister(IndexBinaryFlat)
+class IndexBinaryIVF(IndexBinary):
+    r"""
+     Index based on a inverted file (IVF)
+
+    In the inverted file, the quantizer (an IndexBinary instance) provides a
+    quantization index for each vector to be added. The quantization
+    index maps to a list (aka inverted list or posting list), where the
+    id of the vector is stored.
+
+    Otherwise the object is similar to the IndexIVF
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    invlists = property(_swigfaiss.IndexBinaryIVF_invlists_get, _swigfaiss.IndexBinaryIVF_invlists_set, doc=r""" Access to the actual data""")
+    own_invlists = property(_swigfaiss.IndexBinaryIVF_own_invlists_get, _swigfaiss.IndexBinaryIVF_own_invlists_set)
+    nprobe = property(_swigfaiss.IndexBinaryIVF_nprobe_get, _swigfaiss.IndexBinaryIVF_nprobe_set, doc=r""" number of probes at query time""")
+    max_codes = property(_swigfaiss.IndexBinaryIVF_max_codes_get, _swigfaiss.IndexBinaryIVF_max_codes_set, doc=r""" max nb of codes to visit to do a query""")
+    use_heap = property(_swigfaiss.IndexBinaryIVF_use_heap_get, _swigfaiss.IndexBinaryIVF_use_heap_set, doc=r"""
+     Select between using a heap or counting to select the k smallest values
+    when scanning inverted lists.
+    """)
+    per_invlist_search = property(_swigfaiss.IndexBinaryIVF_per_invlist_search_get, _swigfaiss.IndexBinaryIVF_per_invlist_search_set, doc=r""" collect computations per batch""")
+    direct_map = property(_swigfaiss.IndexBinaryIVF_direct_map_get, _swigfaiss.IndexBinaryIVF_direct_map_set, doc=r""" map for direct access to the elements. Enables reconstruct().""")
+    quantizer = property(_swigfaiss.IndexBinaryIVF_quantizer_get, _swigfaiss.IndexBinaryIVF_quantizer_set, doc=r""" quantizer that maps vectors to inverted lists""")
+    nlist = property(_swigfaiss.IndexBinaryIVF_nlist_get, _swigfaiss.IndexBinaryIVF_nlist_set, doc=r""" number of possible key values""")
+    own_fields = property(_swigfaiss.IndexBinaryIVF_own_fields_get, _swigfaiss.IndexBinaryIVF_own_fields_set, doc=r""" whether object owns the quantizer""")
+    cp = property(_swigfaiss.IndexBinaryIVF_cp_get, _swigfaiss.IndexBinaryIVF_cp_set, doc=r""" to override default clustering params""")
+    clustering_index = property(_swigfaiss.IndexBinaryIVF_clustering_index_get, _swigfaiss.IndexBinaryIVF_clustering_index_set, doc=r""" to override index used during clustering""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexBinaryIVF_swiginit(self, _swigfaiss.new_IndexBinaryIVF(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexBinaryIVF
+
+    def reset(self):
+        return _swigfaiss.IndexBinaryIVF_reset(self)
+
+    def train(self, n, x):
+        r""" Trains the quantizer"""
+        return _swigfaiss.IndexBinaryIVF_train(self, n, x)
+
+    def add(self, n, x):
+        return _swigfaiss.IndexBinaryIVF_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss.IndexBinaryIVF_add_with_ids(self, n, x, xids)
+
+    def add_core(self, n, x, xids, precomputed_idx):
+        r"""
+         Implementation of vector addition where the vector assignments are
+        predefined.
+
+        :type precomputed_idx: int
+        :param precomputed_idx:    quantization indices for the input vectors
+            (size n)
+        """
+        return _swigfaiss.IndexBinaryIVF_add_core(self, n, x, xids, precomputed_idx)
+
+    def search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params=None):
+        r"""
+         Search a set of vectors, that are pre-quantized by the IVF
+         quantizer. Fill in the corresponding heaps with the query
+         results. search() calls this.
+
+        :type n: int
+        :param n:      nb of vectors to query
+        :type x: uint8_t
+        :param x:      query vectors, size nx * d
+        :type assign: int
+        :param assign: coarse quantization indices, size nx * nprobe
+        :type centroid_dis: int
+        :param centroid_dis:
+                          distances to coarse centroids, size nx * nprobe
+        :param distance:
+                          output distances, size n * k
+        :type labels: int
+        :param labels: output labels, size n * k
+        :type store_pairs: boolean
+        :param store_pairs: store inv list index + inv list offset
+                                instead in upper/lower 32 bit of result,
+                                instead of ids (used for reranking).
+        :type params: :py:class:`IVFSearchParameters`, optional
+        :param params: used to override the object's search parameters
+        """
+        return _swigfaiss.IndexBinaryIVF_search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params)
+
+    def get_InvertedListScanner(self, store_pairs=False):
+        return _swigfaiss.IndexBinaryIVF_get_InvertedListScanner(self, store_pairs)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" assign the vectors, then call search_preassign"""
+        return _swigfaiss.IndexBinaryIVF_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss.IndexBinaryIVF_range_search(self, n, x, radius, result, params)
+
+    def range_search_preassigned(self, n, x, radius, assign, centroid_dis, result):
+        return _swigfaiss.IndexBinaryIVF_range_search_preassigned(self, n, x, radius, assign, centroid_dis, result)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexBinaryIVF_reconstruct(self, key, recons)
+
+    def reconstruct_n(self, i0, ni, recons):
+        r"""
+         Reconstruct a subset of the indexed vectors.
+
+        Overrides default implementation to bypass reconstruct() which requires
+        direct_map to be maintained.
+
+        :type i0: int
+        :param i0:     first vector to reconstruct
+        :type ni: int
+        :param ni:     nb of vectors to reconstruct
+        :type recons: uint8_t
+        :param recons: output array of reconstructed vectors, size ni * d / 8
+        """
+        return _swigfaiss.IndexBinaryIVF_reconstruct_n(self, i0, ni, recons)
+
+    def search_and_reconstruct(self, n, x, k, distances, labels, recons, params=None):
+        r"""
+         Similar to search, but also reconstructs the stored vectors (or an
+        approximation in the case of lossy coding) for the search results.
+
+        Overrides default implementation to avoid having to maintain direct_map
+        and instead fetch the code offsets through the `store_pairs` flag in
+        search_preassigned().
+
+        :type recons: uint8_t
+        :param recons:      reconstructed vectors size (n, k, d / 8)
+        """
+        return _swigfaiss.IndexBinaryIVF_search_and_reconstruct(self, n, x, k, distances, labels, recons, params)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        r"""
+         Reconstruct a vector given the location in terms of (inv list index +
+        inv list offset) instead of the id.
+
+        Useful for reconstructing when the direct_map is not maintained and
+        the inv list offset is computed by search_preassigned() with
+        `store_pairs` set.
+        """
+        return _swigfaiss.IndexBinaryIVF_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def remove_ids(self, sel):
+        r""" Dataset manipulation functions"""
+        return _swigfaiss.IndexBinaryIVF_remove_ids(self, sel)
+
+    def merge_from(self, other, add_id):
+        return _swigfaiss.IndexBinaryIVF_merge_from(self, other, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss.IndexBinaryIVF_check_compatible_for_merge(self, otherIndex)
+
+    def get_list_size(self, list_no):
+        return _swigfaiss.IndexBinaryIVF_get_list_size(self, list_no)
+
+    def make_direct_map(self, new_maintain_direct_map=True):
+        r"""
+         initialize a direct map
+
+        :type new_maintain_direct_map: boolean, optional
+        :param new_maintain_direct_map:    if true, create a direct map,
+                                              else clear it
+        """
+        return _swigfaiss.IndexBinaryIVF_make_direct_map(self, new_maintain_direct_map)
+
+    def set_direct_map_type(self, type):
+        return _swigfaiss.IndexBinaryIVF_set_direct_map_type(self, type)
+
+    def replace_invlists(self, il, own=False):
+        return _swigfaiss.IndexBinaryIVF_replace_invlists(self, il, own)
+
+# Register IndexBinaryIVF in _swigfaiss:
+_swigfaiss.IndexBinaryIVF_swigregister(IndexBinaryIVF)
+class BinaryInvertedListScanner(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+
+    def set_query(self, query_vector):
+        r""" from now on we handle this query."""
+        return _swigfaiss.BinaryInvertedListScanner_set_query(self, query_vector)
+
+    def set_list(self, list_no, coarse_dis):
+        r""" following codes come from this inverted list"""
+        return _swigfaiss.BinaryInvertedListScanner_set_list(self, list_no, coarse_dis)
+
+    def distance_to_code(self, code):
+        r""" compute a single query-to-code distance"""
+        return _swigfaiss.BinaryInvertedListScanner_distance_to_code(self, code)
+
+    def scan_codes(self, n, codes, ids, distances, labels, k):
+        r"""
+         compute the distances to codes. (distances, labels) should be
+        organized as a min- or max-heap
+
+        :type n: int
+        :param n:      number of codes to scan
+        :type codes: uint8_t
+        :param codes:  codes to scan (n * code_size)
+        :type ids: int
+        :param ids:        corresponding ids (ignored if store_pairs)
+        :type distances: int
+        :param distances:  heap distances (size k)
+        :type labels: int
+        :param labels:     heap labels (size k)
+        :type k: int
+        :param k:          heap size
+        """
+        return _swigfaiss.BinaryInvertedListScanner_scan_codes(self, n, codes, ids, distances, labels, k)
+
+    def scan_codes_range(self, n, codes, ids, radius, result):
+        return _swigfaiss.BinaryInvertedListScanner_scan_codes_range(self, n, codes, ids, radius, result)
+    __swig_destroy__ = _swigfaiss.delete_BinaryInvertedListScanner
+
+# Register BinaryInvertedListScanner in _swigfaiss:
+_swigfaiss.BinaryInvertedListScanner_swigregister(BinaryInvertedListScanner)
+class IndexBinaryFromFloat(IndexBinary):
+    r"""
+     IndexBinary backed by a float Index.
+
+    Supports adding vertices and searching them.
+
+    All queries are symmetric because there is no distinction between codes and
+    vectors.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    index = property(_swigfaiss.IndexBinaryFromFloat_index_get, _swigfaiss.IndexBinaryFromFloat_index_set)
+    own_fields = property(_swigfaiss.IndexBinaryFromFloat_own_fields_get, _swigfaiss.IndexBinaryFromFloat_own_fields_set, doc=r""" Whether object owns the index pointer.""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexBinaryFromFloat_swiginit(self, _swigfaiss.new_IndexBinaryFromFloat(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexBinaryFromFloat
+
+    def add(self, n, x):
+        return _swigfaiss.IndexBinaryFromFloat_add(self, n, x)
+
+    def reset(self):
+        return _swigfaiss.IndexBinaryFromFloat_reset(self)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexBinaryFromFloat_search(self, n, x, k, distances, labels, params)
+
+    def train(self, n, x):
+        return _swigfaiss.IndexBinaryFromFloat_train(self, n, x)
+
+# Register IndexBinaryFromFloat in _swigfaiss:
+_swigfaiss.IndexBinaryFromFloat_swigregister(IndexBinaryFromFloat)
+class IndexBinaryHNSW(IndexBinary):
+    r"""
+     The HNSW index is a normal random-access index with a HNSW
+    link structure built on top
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    hnsw = property(_swigfaiss.IndexBinaryHNSW_hnsw_get, _swigfaiss.IndexBinaryHNSW_hnsw_set)
+    own_fields = property(_swigfaiss.IndexBinaryHNSW_own_fields_get, _swigfaiss.IndexBinaryHNSW_own_fields_set)
+    storage = property(_swigfaiss.IndexBinaryHNSW_storage_get, _swigfaiss.IndexBinaryHNSW_storage_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexBinaryHNSW_swiginit(self, _swigfaiss.new_IndexBinaryHNSW(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexBinaryHNSW
+
+    def get_distance_computer(self):
+        return _swigfaiss.IndexBinaryHNSW_get_distance_computer(self)
+
+    def add(self, n, x):
+        return _swigfaiss.IndexBinaryHNSW_add(self, n, x)
+
+    def train(self, n, x):
+        r""" Trains the storage if needed"""
+        return _swigfaiss.IndexBinaryHNSW_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" entry point for search"""
+        return _swigfaiss.IndexBinaryHNSW_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexBinaryHNSW_reconstruct(self, key, recons)
+
+    def reset(self):
+        return _swigfaiss.IndexBinaryHNSW_reset(self)
+
+# Register IndexBinaryHNSW in _swigfaiss:
+_swigfaiss.IndexBinaryHNSW_swigregister(IndexBinaryHNSW)
+class IndexBinaryHash(IndexBinary):
+    r""" just uses the b first bits as a hash value"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    invlists = property(_swigfaiss.IndexBinaryHash_invlists_get, _swigfaiss.IndexBinaryHash_invlists_set)
+    b = property(_swigfaiss.IndexBinaryHash_b_get, _swigfaiss.IndexBinaryHash_b_set)
+    nflip = property(_swigfaiss.IndexBinaryHash_nflip_get, _swigfaiss.IndexBinaryHash_nflip_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexBinaryHash_swiginit(self, _swigfaiss.new_IndexBinaryHash(*args))
+
+    def reset(self):
+        return _swigfaiss.IndexBinaryHash_reset(self)
+
+    def add(self, n, x):
+        return _swigfaiss.IndexBinaryHash_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss.IndexBinaryHash_add_with_ids(self, n, x, xids)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss.IndexBinaryHash_range_search(self, n, x, radius, result, params)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexBinaryHash_search(self, n, x, k, distances, labels, params)
+
+    def display(self):
+        return _swigfaiss.IndexBinaryHash_display(self)
+
+    def hashtable_size(self):
+        return _swigfaiss.IndexBinaryHash_hashtable_size(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexBinaryHash
+
+# Register IndexBinaryHash in _swigfaiss:
+_swigfaiss.IndexBinaryHash_swigregister(IndexBinaryHash)
+class IndexBinaryHashStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss.IndexBinaryHashStats_nq_get, _swigfaiss.IndexBinaryHashStats_nq_set)
+    n0 = property(_swigfaiss.IndexBinaryHashStats_n0_get, _swigfaiss.IndexBinaryHashStats_n0_set)
+    nlist = property(_swigfaiss.IndexBinaryHashStats_nlist_get, _swigfaiss.IndexBinaryHashStats_nlist_set)
+    ndis = property(_swigfaiss.IndexBinaryHashStats_ndis_get, _swigfaiss.IndexBinaryHashStats_ndis_set)
+
+    def __init__(self):
+        _swigfaiss.IndexBinaryHashStats_swiginit(self, _swigfaiss.new_IndexBinaryHashStats())
+
+    def reset(self):
+        return _swigfaiss.IndexBinaryHashStats_reset(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexBinaryHashStats
+
+# Register IndexBinaryHashStats in _swigfaiss:
+_swigfaiss.IndexBinaryHashStats_swigregister(IndexBinaryHashStats)
+class IndexBinaryMultiHash(IndexBinary):
+    r""" just uses the b first bits as a hash value"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    storage = property(_swigfaiss.IndexBinaryMultiHash_storage_get, _swigfaiss.IndexBinaryMultiHash_storage_set)
+    own_fields = property(_swigfaiss.IndexBinaryMultiHash_own_fields_get, _swigfaiss.IndexBinaryMultiHash_own_fields_set)
+    maps = property(_swigfaiss.IndexBinaryMultiHash_maps_get, _swigfaiss.IndexBinaryMultiHash_maps_set)
+    nhash = property(_swigfaiss.IndexBinaryMultiHash_nhash_get, _swigfaiss.IndexBinaryMultiHash_nhash_set, doc=r""" nb of hash maps""")
+    b = property(_swigfaiss.IndexBinaryMultiHash_b_get, _swigfaiss.IndexBinaryMultiHash_b_set, doc=r""" nb bits per hash map""")
+    nflip = property(_swigfaiss.IndexBinaryMultiHash_nflip_get, _swigfaiss.IndexBinaryMultiHash_nflip_set, doc=r""" nb bit flips to use at search time""")
+
+    def __init__(self, *args):
+        _swigfaiss.IndexBinaryMultiHash_swiginit(self, _swigfaiss.new_IndexBinaryMultiHash(*args))
+    __swig_destroy__ = _swigfaiss.delete_IndexBinaryMultiHash
+
+    def reset(self):
+        return _swigfaiss.IndexBinaryMultiHash_reset(self)
+
+    def add(self, n, x):
+        return _swigfaiss.IndexBinaryMultiHash_add(self, n, x)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss.IndexBinaryMultiHash_range_search(self, n, x, radius, result, params)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexBinaryMultiHash_search(self, n, x, k, distances, labels, params)
+
+    def hashtable_size(self):
+        return _swigfaiss.IndexBinaryMultiHash_hashtable_size(self)
+
+# Register IndexBinaryMultiHash in _swigfaiss:
+_swigfaiss.IndexBinaryMultiHash_swigregister(IndexBinaryMultiHash)
+class ThreadedIndexBase(Index):
+    r"""
+    A holder of indices in a collection of threads
+    The interface to this class itself is not thread safe
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    __swig_destroy__ = _swigfaiss.delete_ThreadedIndexBase
+
+    def addIndex(self, index):
+        r"""
+        override an index that is managed by ourselves.
+        WARNING: once an index is added, it becomes unsafe to touch it from any
+        other thread than that on which is managing it, until we are shut
+        down. Use runOnIndex to perform work on it instead.
+        """
+        return _swigfaiss.ThreadedIndexBase_addIndex(self, index)
+
+    def removeIndex(self, index):
+        r"""
+        Remove an index that is managed by ourselves.
+        This will flush all pending work on that index, and then shut
+        down its managing thread, and will remove the index.
+        """
+        return _swigfaiss.ThreadedIndexBase_removeIndex(self, index)
+
+    def runOnIndex(self, *args):
+        return _swigfaiss.ThreadedIndexBase_runOnIndex(self, *args)
+
+    def reset(self):
+        r"""
+        faiss::Index API
+        All indices receive the same call
+        """
+        return _swigfaiss.ThreadedIndexBase_reset(self)
+
+    def count(self):
+        r""" Returns the number of sub-indices"""
+        return _swigfaiss.ThreadedIndexBase_count(self)
+
+    def at(self, *args):
+        r"""
+        *Overload 1:*
+        Returns the i-th sub-index
+
+        |
+
+        *Overload 2:*
+        Returns the i-th sub-index (const version)
+        """
+        return _swigfaiss.ThreadedIndexBase_at(self, *args)
+    own_indices = property(_swigfaiss.ThreadedIndexBase_own_indices_get, _swigfaiss.ThreadedIndexBase_own_indices_set, doc=r""" Whether or not we are responsible for deleting our contained indices""")
+
+# Register ThreadedIndexBase in _swigfaiss:
+_swigfaiss.ThreadedIndexBase_swigregister(ThreadedIndexBase)
+class ThreadedIndexBaseBinary(IndexBinary):
+    r"""
+    A holder of indices in a collection of threads
+    The interface to this class itself is not thread safe
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    __swig_destroy__ = _swigfaiss.delete_ThreadedIndexBaseBinary
+
+    def addIndex(self, index):
+        r"""
+        override an index that is managed by ourselves.
+        WARNING: once an index is added, it becomes unsafe to touch it from any
+        other thread than that on which is managing it, until we are shut
+        down. Use runOnIndex to perform work on it instead.
+        """
+        return _swigfaiss.ThreadedIndexBaseBinary_addIndex(self, index)
+
+    def removeIndex(self, index):
+        r"""
+        Remove an index that is managed by ourselves.
+        This will flush all pending work on that index, and then shut
+        down its managing thread, and will remove the index.
+        """
+        return _swigfaiss.ThreadedIndexBaseBinary_removeIndex(self, index)
+
+    def runOnIndex(self, *args):
+        return _swigfaiss.ThreadedIndexBaseBinary_runOnIndex(self, *args)
+
+    def reset(self):
+        r"""
+        faiss::Index API
+        All indices receive the same call
+        """
+        return _swigfaiss.ThreadedIndexBaseBinary_reset(self)
+
+    def count(self):
+        r""" Returns the number of sub-indices"""
+        return _swigfaiss.ThreadedIndexBaseBinary_count(self)
+
+    def at(self, *args):
+        r"""
+        *Overload 1:*
+        Returns the i-th sub-index
+
+        |
+
+        *Overload 2:*
+        Returns the i-th sub-index (const version)
+        """
+        return _swigfaiss.ThreadedIndexBaseBinary_at(self, *args)
+    own_indices = property(_swigfaiss.ThreadedIndexBaseBinary_own_indices_get, _swigfaiss.ThreadedIndexBaseBinary_own_indices_set, doc=r""" Whether or not we are responsible for deleting our contained indices""")
+
+# Register ThreadedIndexBaseBinary in _swigfaiss:
+_swigfaiss.ThreadedIndexBaseBinary_swigregister(ThreadedIndexBaseBinary)
+class IndexShards(ThreadedIndexBase):
+    r"""Index that concatenates the results from several sub-indexes"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+
+        The dimension that all sub-indices must share will be the dimension of
+        the first sub-index added
+
+        :type threaded: boolean, optional
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :type successive_ids: boolean, optional
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 2:*
+
+        :type threaded: boolean, optional
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :type successive_ids: boolean, optional
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 3:*
+
+        :type threaded: boolean, optional
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 4:*
+
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 5:*
+         int version due to the implicit bool conversion ambiguity of int as
+         dimension
+
+        |
+
+        *Overload 6:*
+         int version due to the implicit bool conversion ambiguity of int as
+         dimension
+
+        |
+
+        *Overload 7:*
+         int version due to the implicit bool conversion ambiguity of int as
+         dimension
+        """
+        _swigfaiss.IndexShards_swiginit(self, _swigfaiss.new_IndexShards(*args))
+
+    def add_shard(self, index):
+        r""" Alias for addIndex()"""
+        return _swigfaiss.IndexShards_add_shard(self, index)
+
+    def remove_shard(self, index):
+        r""" Alias for removeIndex()"""
+        return _swigfaiss.IndexShards_remove_shard(self, index)
+
+    def add(self, n, x):
+        r""" supported only for sub-indices that implement add_with_ids"""
+        return _swigfaiss.IndexShards_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        r"""
+        Cases (successive_ids, xids):
+        - true, non-NULL       ERROR: it makes no sense to pass in ids and
+                               request them to be shifted
+        - true, NULL           OK: but should be called only once (calls add()
+                               on sub-indexes).
+        - false, non-NULL      OK: will call add_with_ids with passed in xids
+                               distributed evenly over shards
+        - false, NULL          OK: will call add_with_ids on each sub-index,
+                               starting at ntotal
+        """
+        return _swigfaiss.IndexShards_add_with_ids(self, n, x, xids)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexShards_search(self, n, x, k, distances, labels, params)
+
+    def train(self, n, x):
+        return _swigfaiss.IndexShards_train(self, n, x)
+    successive_ids = property(_swigfaiss.IndexShards_successive_ids_get, _swigfaiss.IndexShards_successive_ids_set)
+
+    def syncWithSubIndexes(self):
+        r"""
+        Synchronize the top-level index (IndexShards) with data in the
+        sub-indices
+        """
+        return _swigfaiss.IndexShards_syncWithSubIndexes(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexShards
+
+# Register IndexShards in _swigfaiss:
+_swigfaiss.IndexShards_swigregister(IndexShards)
+class IndexBinaryShards(ThreadedIndexBaseBinary):
+    r"""Index that concatenates the results from several sub-indexes"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+
+        The dimension that all sub-indices must share will be the dimension of
+        the first sub-index added
+
+        :type threaded: boolean, optional
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :type successive_ids: boolean, optional
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 2:*
+
+        :type threaded: boolean, optional
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :type successive_ids: boolean, optional
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 3:*
+
+        :type threaded: boolean, optional
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 4:*
+
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 5:*
+         int version due to the implicit bool conversion ambiguity of int as
+         dimension
+
+        |
+
+        *Overload 6:*
+         int version due to the implicit bool conversion ambiguity of int as
+         dimension
+
+        |
+
+        *Overload 7:*
+         int version due to the implicit bool conversion ambiguity of int as
+         dimension
+        """
+        _swigfaiss.IndexBinaryShards_swiginit(self, _swigfaiss.new_IndexBinaryShards(*args))
+
+    def add_shard(self, index):
+        r""" Alias for addIndex()"""
+        return _swigfaiss.IndexBinaryShards_add_shard(self, index)
+
+    def remove_shard(self, index):
+        r""" Alias for removeIndex()"""
+        return _swigfaiss.IndexBinaryShards_remove_shard(self, index)
+
+    def add(self, n, x):
+        r""" supported only for sub-indices that implement add_with_ids"""
+        return _swigfaiss.IndexBinaryShards_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        r"""
+        Cases (successive_ids, xids):
+        - true, non-NULL       ERROR: it makes no sense to pass in ids and
+                               request them to be shifted
+        - true, NULL           OK: but should be called only once (calls add()
+                               on sub-indexes).
+        - false, non-NULL      OK: will call add_with_ids with passed in xids
+                               distributed evenly over shards
+        - false, NULL          OK: will call add_with_ids on each sub-index,
+                               starting at ntotal
+        """
+        return _swigfaiss.IndexBinaryShards_add_with_ids(self, n, x, xids)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexBinaryShards_search(self, n, x, k, distances, labels, params)
+
+    def train(self, n, x):
+        return _swigfaiss.IndexBinaryShards_train(self, n, x)
+    successive_ids = property(_swigfaiss.IndexBinaryShards_successive_ids_get, _swigfaiss.IndexBinaryShards_successive_ids_set)
+
+    def syncWithSubIndexes(self):
+        r"""
+        Synchronize the top-level index (IndexShards) with data in the
+        sub-indices
+        """
+        return _swigfaiss.IndexBinaryShards_syncWithSubIndexes(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexBinaryShards
+
+# Register IndexBinaryShards in _swigfaiss:
+_swigfaiss.IndexBinaryShards_swigregister(IndexBinaryShards)
+class IndexShardsIVF(IndexShards, Level1Quantizer):
+    r"""
+    IndexShards with a common coarse quantizer. All the indexes added should be
+    IndexIVFInterface indexes so that the search_precomputed can be called.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, quantizer, nlist, threaded=False, successive_ids=True):
+        _swigfaiss.IndexShardsIVF_swiginit(self, _swigfaiss.new_IndexShardsIVF(quantizer, nlist, threaded, successive_ids))
+
+    def addIndex(self, index):
+        return _swigfaiss.IndexShardsIVF_addIndex(self, index)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss.IndexShardsIVF_add_with_ids(self, n, x, xids)
+
+    def train(self, n, x):
+        return _swigfaiss.IndexShardsIVF_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexShardsIVF_search(self, n, x, k, distances, labels, params)
+    __swig_destroy__ = _swigfaiss.delete_IndexShardsIVF
+
+# Register IndexShardsIVF in _swigfaiss:
+_swigfaiss.IndexShardsIVF_swigregister(IndexShardsIVF)
+class IndexReplicas(ThreadedIndexBase):
+    r"""
+    Takes individual faiss::Index instances, and splits queries for
+    sending to each Index instance, and joins the results together
+    when done.
+    Each index is managed by a separate CPU thread.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+        The dimension that all sub-indices must share will be the dimension of
+        the first sub-index added
+        :type threaded: boolean, optional
+        :param threaded: do we use one thread per sub-index or do queries
+            sequentially?
+
+        |
+
+        *Overload 2:*
+        :type d: int
+        :param d: the dimension that all sub-indices must share
+        :type threaded: boolean, optional
+        :param threaded: do we use one thread per sub index or do queries
+            sequentially?
+
+        |
+
+        *Overload 3:*
+        :type d: int
+        :param d: the dimension that all sub-indices must share
+        :param threaded: do we use one thread per sub index or do queries
+            sequentially?
+
+        |
+
+        *Overload 4:*
+        int version due to the implicit bool conversion ambiguity of int as
+        dimension
+
+        |
+
+        *Overload 5:*
+        int version due to the implicit bool conversion ambiguity of int as
+        dimension
+        """
+        _swigfaiss.IndexReplicas_swiginit(self, _swigfaiss.new_IndexReplicas(*args))
+
+    def add_replica(self, index):
+        r""" Alias for addIndex()"""
+        return _swigfaiss.IndexReplicas_add_replica(self, index)
+
+    def remove_replica(self, index):
+        r""" Alias for removeIndex()"""
+        return _swigfaiss.IndexReplicas_remove_replica(self, index)
+
+    def train(self, n, x):
+        r"""
+        faiss::Index API
+        All indices receive the same call
+        """
+        return _swigfaiss.IndexReplicas_train(self, n, x)
+
+    def add(self, n, x):
+        r"""
+        faiss::Index API
+        All indices receive the same call
+        """
+        return _swigfaiss.IndexReplicas_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r"""
+        faiss::Index API
+        Query is partitioned into a slice for each sub-index
+        split by ceil(n / #indices) for our sub-indices
+        """
+        return _swigfaiss.IndexReplicas_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, arg2, v):
+        r""" reconstructs from the first index"""
+        return _swigfaiss.IndexReplicas_reconstruct(self, arg2, v)
+
+    def syncWithSubIndexes(self):
+        r"""
+        Synchronize the top-level index (IndexShards) with data in the
+        sub-indices
+        """
+        return _swigfaiss.IndexReplicas_syncWithSubIndexes(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexReplicas
+
+# Register IndexReplicas in _swigfaiss:
+_swigfaiss.IndexReplicas_swigregister(IndexReplicas)
+class IndexBinaryReplicas(ThreadedIndexBaseBinary):
+    r"""
+    Takes individual faiss::Index instances, and splits queries for
+    sending to each Index instance, and joins the results together
+    when done.
+    Each index is managed by a separate CPU thread.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+        The dimension that all sub-indices must share will be the dimension of
+        the first sub-index added
+        :type threaded: boolean, optional
+        :param threaded: do we use one thread per sub-index or do queries
+            sequentially?
+
+        |
+
+        *Overload 2:*
+        :type d: int
+        :param d: the dimension that all sub-indices must share
+        :type threaded: boolean, optional
+        :param threaded: do we use one thread per sub index or do queries
+            sequentially?
+
+        |
+
+        *Overload 3:*
+        :type d: int
+        :param d: the dimension that all sub-indices must share
+        :param threaded: do we use one thread per sub index or do queries
+            sequentially?
+
+        |
+
+        *Overload 4:*
+        int version due to the implicit bool conversion ambiguity of int as
+        dimension
+
+        |
+
+        *Overload 5:*
+        int version due to the implicit bool conversion ambiguity of int as
+        dimension
+        """
+        _swigfaiss.IndexBinaryReplicas_swiginit(self, _swigfaiss.new_IndexBinaryReplicas(*args))
+
+    def add_replica(self, index):
+        r""" Alias for addIndex()"""
+        return _swigfaiss.IndexBinaryReplicas_add_replica(self, index)
+
+    def remove_replica(self, index):
+        r""" Alias for removeIndex()"""
+        return _swigfaiss.IndexBinaryReplicas_remove_replica(self, index)
+
+    def train(self, n, x):
+        r"""
+        faiss::Index API
+        All indices receive the same call
+        """
+        return _swigfaiss.IndexBinaryReplicas_train(self, n, x)
+
+    def add(self, n, x):
+        r"""
+        faiss::Index API
+        All indices receive the same call
+        """
+        return _swigfaiss.IndexBinaryReplicas_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r"""
+        faiss::Index API
+        Query is partitioned into a slice for each sub-index
+        split by ceil(n / #indices) for our sub-indices
+        """
+        return _swigfaiss.IndexBinaryReplicas_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, arg2, v):
+        r""" reconstructs from the first index"""
+        return _swigfaiss.IndexBinaryReplicas_reconstruct(self, arg2, v)
+
+    def syncWithSubIndexes(self):
+        r"""
+        Synchronize the top-level index (IndexShards) with data in the
+        sub-indices
+        """
+        return _swigfaiss.IndexBinaryReplicas_syncWithSubIndexes(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexBinaryReplicas
+
+# Register IndexBinaryReplicas in _swigfaiss:
+_swigfaiss.IndexBinaryReplicas_swigregister(IndexBinaryReplicas)
+class IndexSplitVectors(Index):
+    r"""
+     splits input vectors in segments and assigns each segment to a sub-index
+    used to distribute a MultiIndexQuantizer
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    own_fields = property(_swigfaiss.IndexSplitVectors_own_fields_get, _swigfaiss.IndexSplitVectors_own_fields_set)
+    threaded = property(_swigfaiss.IndexSplitVectors_threaded_get, _swigfaiss.IndexSplitVectors_threaded_set)
+    sub_indexes = property(_swigfaiss.IndexSplitVectors_sub_indexes_get, _swigfaiss.IndexSplitVectors_sub_indexes_set)
+    sum_d = property(_swigfaiss.IndexSplitVectors_sum_d_get, _swigfaiss.IndexSplitVectors_sum_d_set)
+
+    def __init__(self, d, threaded=False):
+        r""" sum of dimensions seen so far"""
+        _swigfaiss.IndexSplitVectors_swiginit(self, _swigfaiss.new_IndexSplitVectors(d, threaded))
+
+    def add_sub_index(self, arg2):
+        return _swigfaiss.IndexSplitVectors_add_sub_index(self, arg2)
+
+    def sync_with_sub_indexes(self):
+        return _swigfaiss.IndexSplitVectors_sync_with_sub_indexes(self)
+
+    def add(self, n, x):
+        return _swigfaiss.IndexSplitVectors_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexSplitVectors_search(self, n, x, k, distances, labels, params)
+
+    def train(self, n, x):
+        return _swigfaiss.IndexSplitVectors_train(self, n, x)
+
+    def reset(self):
+        return _swigfaiss.IndexSplitVectors_reset(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexSplitVectors
+
+# Register IndexSplitVectors in _swigfaiss:
+_swigfaiss.IndexSplitVectors_swigregister(IndexSplitVectors)
+class IndexRandom(Index):
+    r"""
+     index that returns random results.
+    used mainly for time benchmarks
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    seed = property(_swigfaiss.IndexRandom_seed_get, _swigfaiss.IndexRandom_seed_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IndexRandom_swiginit(self, _swigfaiss.new_IndexRandom(*args))
+
+    def add(self, n, x):
+        return _swigfaiss.IndexRandom_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexRandom_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexRandom_reconstruct(self, key, recons)
+
+    def reset(self):
+        return _swigfaiss.IndexRandom_reset(self)
+    __swig_destroy__ = _swigfaiss.delete_IndexRandom
+
+# Register IndexRandom in _swigfaiss:
+_swigfaiss.IndexRandom_swigregister(IndexRandom)
+class IndexRowwiseMinMaxBase(Index):
+    r"""
+     Index wrapper that performs rowwise normalization to [0,1], preserving
+     the coefficients. This is a vector codec index only.
+
+     Basically, this index performs a rowwise scaling to [0,1] of every row
+     in an input dataset before calling subindex::train() and
+     subindex::sa_encode(). sa_encode() call stores the scaling coefficients
+      (scaler and minv) in the very beginning of every output code. The format:
+         [scaler][minv][subindex::sa_encode() output]
+     The de-scaling in sa_decode() is done using:
+         output_rescaled = scaler * output + minv
+
+     An additional ::train_inplace() function is provided in order to do
+     an inplace scaling before calling subindex::train() and, thus, avoiding
+     the cloning of the input dataset, but modifying the input dataset because
+     of the scaling and the scaling back. It is up to user to call
+     this function instead of ::train()
+
+     Derived classes provide different data types for scaling coefficients.
+     Currently, versions with fp16 and fp32 scaling coefficients are available.
+    fp16 version adds 4 extra bytes per encoded vector
+    fp32 version adds 8 extra bytes per encoded vector
+     Provides base functions for rowwise normalizing indices.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    index = property(_swigfaiss.IndexRowwiseMinMaxBase_index_get, _swigfaiss.IndexRowwiseMinMaxBase_index_set, doc=r""" sub-index""")
+    own_fields = property(_swigfaiss.IndexRowwiseMinMaxBase_own_fields_get, _swigfaiss.IndexRowwiseMinMaxBase_own_fields_set, doc=r""" whether the subindex needs to be freed in the destructor.""")
+    __swig_destroy__ = _swigfaiss.delete_IndexRowwiseMinMaxBase
+
+    def add(self, n, x):
+        return _swigfaiss.IndexRowwiseMinMaxBase_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexRowwiseMinMaxBase_search(self, n, x, k, distances, labels, params)
+
+    def reset(self):
+        return _swigfaiss.IndexRowwiseMinMaxBase_reset(self)
+
+    def train_inplace(self, n, x):
+        return _swigfaiss.IndexRowwiseMinMaxBase_train_inplace(self, n, x)
+
+# Register IndexRowwiseMinMaxBase in _swigfaiss:
+_swigfaiss.IndexRowwiseMinMaxBase_swigregister(IndexRowwiseMinMaxBase)
+class IndexRowwiseMinMaxFP16(IndexRowwiseMinMaxBase):
+    r""" Stores scaling coefficients as fp16 values."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.IndexRowwiseMinMaxFP16_swiginit(self, _swigfaiss.new_IndexRowwiseMinMaxFP16(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexRowwiseMinMaxFP16_train(self, n, x)
+
+    def train_inplace(self, n, x):
+        return _swigfaiss.IndexRowwiseMinMaxFP16_train_inplace(self, n, x)
+
+    def sa_code_size(self):
+        return _swigfaiss.IndexRowwiseMinMaxFP16_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss.IndexRowwiseMinMaxFP16_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexRowwiseMinMaxFP16_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexRowwiseMinMaxFP16
+
+# Register IndexRowwiseMinMaxFP16 in _swigfaiss:
+_swigfaiss.IndexRowwiseMinMaxFP16_swigregister(IndexRowwiseMinMaxFP16)
+class IndexRowwiseMinMax(IndexRowwiseMinMaxBase):
+    r""" Stores scaling coefficients as fp32 values."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss.IndexRowwiseMinMax_swiginit(self, _swigfaiss.new_IndexRowwiseMinMax(*args))
+
+    def train(self, n, x):
+        return _swigfaiss.IndexRowwiseMinMax_train(self, n, x)
+
+    def train_inplace(self, n, x):
+        return _swigfaiss.IndexRowwiseMinMax_train_inplace(self, n, x)
+
+    def sa_code_size(self):
+        return _swigfaiss.IndexRowwiseMinMax_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss.IndexRowwiseMinMax_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss.IndexRowwiseMinMax_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss.delete_IndexRowwiseMinMax
+
+# Register IndexRowwiseMinMax in _swigfaiss:
+_swigfaiss.IndexRowwiseMinMax_swigregister(IndexRowwiseMinMax)
+class RangeSearchResult(object):
+    r"""
+    The objective is to have a simple result structure while
+    minimizing the number of mem copies in the result. The method
+    do_allocation can be overloaded to allocate the result tables in
+    the matrix type of a scripting language like Lua or Python.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss.RangeSearchResult_nq_get, _swigfaiss.RangeSearchResult_nq_set, doc=r""" nb of queries""")
+    lims = property(_swigfaiss.RangeSearchResult_lims_get, _swigfaiss.RangeSearchResult_lims_set, doc=r""" size (nq + 1)""")
+    labels = property(_swigfaiss.RangeSearchResult_labels_get, _swigfaiss.RangeSearchResult_labels_set, doc=r""" result for query i is labels[lims[i]:lims[i+1]]""")
+    distances = property(_swigfaiss.RangeSearchResult_distances_get, _swigfaiss.RangeSearchResult_distances_set, doc=r""" corresponding distances (not sorted)""")
+    buffer_size = property(_swigfaiss.RangeSearchResult_buffer_size_get, _swigfaiss.RangeSearchResult_buffer_size_set, doc=r""" size of the result buffers used""")
+
+    def __init__(self, nq, alloc_lims=True):
+        r""" lims must be allocated on input to range_search."""
+        _swigfaiss.RangeSearchResult_swiginit(self, _swigfaiss.new_RangeSearchResult(nq, alloc_lims))
+
+    def do_allocation(self):
+        r"""
+        called when lims contains the nb of elements result entries
+        for each query
+        """
+        return _swigfaiss.RangeSearchResult_do_allocation(self)
+    __swig_destroy__ = _swigfaiss.delete_RangeSearchResult
+
+# Register RangeSearchResult in _swigfaiss:
+_swigfaiss.RangeSearchResult_swigregister(RangeSearchResult)
+class BufferList(object):
+    r"""
+    List of temporary buffers used to store results before they are
+    copied to the RangeSearchResult object.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    buffer_size = property(_swigfaiss.BufferList_buffer_size_get, _swigfaiss.BufferList_buffer_size_set)
+    buffers = property(_swigfaiss.BufferList_buffers_get, _swigfaiss.BufferList_buffers_set)
+    wp = property(_swigfaiss.BufferList_wp_get, _swigfaiss.BufferList_wp_set, doc=r""" write pointer in the last buffer.""")
+
+    def __init__(self, buffer_size):
+        _swigfaiss.BufferList_swiginit(self, _swigfaiss.new_BufferList(buffer_size))
+    __swig_destroy__ = _swigfaiss.delete_BufferList
+
+    def append_buffer(self):
+        r""" create a new buffer"""
+        return _swigfaiss.BufferList_append_buffer(self)
+
+    def add(self, id, dis):
+        r""" add one result, possibly appending a new buffer if needed"""
+        return _swigfaiss.BufferList_add(self, id, dis)
+
+    def copy_range(self, ofs, n, dest_ids, dest_dis):
+        r"""
+        copy elemnts ofs:ofs+n-1 seen as linear data in the buffers to
+        tables dest_ids, dest_dis
+        """
+        return _swigfaiss.BufferList_copy_range(self, ofs, n, dest_ids, dest_dis)
+
+# Register BufferList in _swigfaiss:
+_swigfaiss.BufferList_swigregister(BufferList)
+class RangeQueryResult(object):
+    r""" result structure for a single query"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    qno = property(_swigfaiss.RangeQueryResult_qno_get, _swigfaiss.RangeQueryResult_qno_set)
+    nres = property(_swigfaiss.RangeQueryResult_nres_get, _swigfaiss.RangeQueryResult_nres_set)
+    pres = property(_swigfaiss.RangeQueryResult_pres_get, _swigfaiss.RangeQueryResult_pres_set)
+
+    def add(self, dis, id):
+        r""" called by search function to report a new result"""
+        return _swigfaiss.RangeQueryResult_add(self, dis, id)
+
+    def __init__(self):
+        _swigfaiss.RangeQueryResult_swiginit(self, _swigfaiss.new_RangeQueryResult())
+    __swig_destroy__ = _swigfaiss.delete_RangeQueryResult
+
+# Register RangeQueryResult in _swigfaiss:
+_swigfaiss.RangeQueryResult_swigregister(RangeQueryResult)
+class RangeSearchPartialResult(BufferList):
+    r""" the entries in the buffers are split per query"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    res = property(_swigfaiss.RangeSearchPartialResult_res_get, _swigfaiss.RangeSearchPartialResult_res_set)
+
+    def __init__(self, res_in):
+        r""" eventually the result will be stored in res_in"""
+        _swigfaiss.RangeSearchPartialResult_swiginit(self, _swigfaiss.new_RangeSearchPartialResult(res_in))
+    queries = property(_swigfaiss.RangeSearchPartialResult_queries_get, _swigfaiss.RangeSearchPartialResult_queries_set, doc=r""" query ids + nb of results per query.""")
+
+    def new_result(self, qno):
+        r""" begin a new result"""
+        return _swigfaiss.RangeSearchPartialResult_new_result(self, qno)
+
+    def finalize(self):
+        return _swigfaiss.RangeSearchPartialResult_finalize(self)
+
+    def set_lims(self):
+        r""" called by range_search before do_allocation"""
+        return _swigfaiss.RangeSearchPartialResult_set_lims(self)
+
+    def copy_result(self, incremental=False):
+        r""" called by range_search after do_allocation"""
+        return _swigfaiss.RangeSearchPartialResult_copy_result(self, incremental)
+
+    @staticmethod
+    def merge(partial_results, do_delete=True):
+        r"""
+        merge a set of PartialResult's into one RangeSearchResult
+        on ouptut the partialresults are empty!
+        """
+        return _swigfaiss.RangeSearchPartialResult_merge(partial_results, do_delete)
+    __swig_destroy__ = _swigfaiss.delete_RangeSearchPartialResult
+
+# Register RangeSearchPartialResult in _swigfaiss:
+_swigfaiss.RangeSearchPartialResult_swigregister(RangeSearchPartialResult)
+class InterruptCallback(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+
+    def want_interrupt(self):
+        return _swigfaiss.InterruptCallback_want_interrupt(self)
+    __swig_destroy__ = _swigfaiss.delete_InterruptCallback
+
+    @staticmethod
+    def clear_instance():
+        return _swigfaiss.InterruptCallback_clear_instance()
+
+    @staticmethod
+    def check():
+        r"""
+         check if:
+        - an interrupt callback is set
+        - the callback returns true
+        if this is the case, then throw an exception. Should not be called
+        from multiple threads.
+        """
+        return _swigfaiss.InterruptCallback_check()
+
+    @staticmethod
+    def is_interrupted():
+        r"""
+        same as check() but return true if is interrupted instead of
+        throwing. Can be called from multiple threads.
+        """
+        return _swigfaiss.InterruptCallback_is_interrupted()
+
+    @staticmethod
+    def get_period_hint(flops):
+        r"""
+         assuming each iteration takes a certain number of flops, what
+        is a reasonable interval to check for interrupts?
+        """
+        return _swigfaiss.InterruptCallback_get_period_hint(flops)
+
+# Register InterruptCallback in _swigfaiss:
+_swigfaiss.InterruptCallback_swigregister(InterruptCallback)
+class VisitedTable(object):
+    r""" set implementation optimized for fast access."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    visited = property(_swigfaiss.VisitedTable_visited_get, _swigfaiss.VisitedTable_visited_set)
+    visno = property(_swigfaiss.VisitedTable_visno_get, _swigfaiss.VisitedTable_visno_set)
+
+    def __init__(self, size):
+        _swigfaiss.VisitedTable_swiginit(self, _swigfaiss.new_VisitedTable(size))
+
+    def set(self, no):
+        r""" set flag #no to true"""
+        return _swigfaiss.VisitedTable_set(self, no)
+
+    def get(self, no):
+        r""" get flag #no"""
+        return _swigfaiss.VisitedTable_get(self, no)
+
+    def advance(self):
+        r""" reset all flags to false"""
+        return _swigfaiss.VisitedTable_advance(self)
+    __swig_destroy__ = _swigfaiss.delete_VisitedTable
+
+# Register VisitedTable in _swigfaiss:
+_swigfaiss.VisitedTable_swigregister(VisitedTable)
+class IDSelector(object):
+    r""" Encapsulates a set of ids to handle."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+
+    def is_member(self, id):
+        return _swigfaiss.IDSelector_is_member(self, id)
+    __swig_destroy__ = _swigfaiss.delete_IDSelector
+
+# Register IDSelector in _swigfaiss:
+_swigfaiss.IDSelector_swigregister(IDSelector)
+class IDSelectorRange(IDSelector):
+    r""" ids between [imin, imax)"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    imin = property(_swigfaiss.IDSelectorRange_imin_get, _swigfaiss.IDSelectorRange_imin_set)
+    imax = property(_swigfaiss.IDSelectorRange_imax_get, _swigfaiss.IDSelectorRange_imax_set)
+    assume_sorted = property(_swigfaiss.IDSelectorRange_assume_sorted_get, _swigfaiss.IDSelectorRange_assume_sorted_set, doc=r"""
+    Assume that the ids to handle are sorted. In some cases this can speed
+    up processing
+    """)
+
+    def __init__(self, imin, imax, assume_sorted=False):
+        _swigfaiss.IDSelectorRange_swiginit(self, _swigfaiss.new_IDSelectorRange(imin, imax, assume_sorted))
+
+    def is_member(self, id):
+        return _swigfaiss.IDSelectorRange_is_member(self, id)
+
+    def find_sorted_ids_bounds(self, list_size, ids, jmin, jmax):
+        r"""
+        for sorted ids, find the range of list indices where the valid ids are
+        stored
+        """
+        return _swigfaiss.IDSelectorRange_find_sorted_ids_bounds(self, list_size, ids, jmin, jmax)
+    __swig_destroy__ = _swigfaiss.delete_IDSelectorRange
+
+# Register IDSelectorRange in _swigfaiss:
+_swigfaiss.IDSelectorRange_swigregister(IDSelectorRange)
+class IDSelectorArray(IDSelector):
+    r"""
+     Simple array of elements
+
+    is_member calls are very inefficient, but some operations can use the ids
+    directly.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    n = property(_swigfaiss.IDSelectorArray_n_get, _swigfaiss.IDSelectorArray_n_set)
+    ids = property(_swigfaiss.IDSelectorArray_ids_get, _swigfaiss.IDSelectorArray_ids_set)
+
+    def __init__(self, n, ids):
+        r"""
+         Construct with an array of ids to process
+
+        :type n: int
+        :param n: number of ids to store
+        :type ids: int
+        :param ids: elements to store. The pointer should remain valid during
+                       IDSelectorArray's lifetime
+        """
+        _swigfaiss.IDSelectorArray_swiginit(self, _swigfaiss.new_IDSelectorArray(n, ids))
+
+    def is_member(self, id):
+        return _swigfaiss.IDSelectorArray_is_member(self, id)
+    __swig_destroy__ = _swigfaiss.delete_IDSelectorArray
+
+# Register IDSelectorArray in _swigfaiss:
+_swigfaiss.IDSelectorArray_swigregister(IDSelectorArray)
+class IDSelectorBatch(IDSelector):
+    r"""
+     Ids from a set.
+
+    Repetitions of ids in the indices set passed to the constructor does not hurt
+    performance.
+
+    The hash function used for the bloom filter and GCC's implementation of
+    unordered_set are just the least significant bits of the id. This works fine
+    for random ids or ids in sequences but will produce many hash collisions if
+    lsb's are always the same
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nbits = property(_swigfaiss.IDSelectorBatch_nbits_get, _swigfaiss.IDSelectorBatch_nbits_set)
+    mask = property(_swigfaiss.IDSelectorBatch_mask_get, _swigfaiss.IDSelectorBatch_mask_set)
+
+    def __init__(self, n, indices):
+        r"""
+         Construct with an array of ids to process
+
+        :type n: int
+        :param n: number of ids to store
+        :param ids: elements to store. The pointer can be released after
+                       construction
+        """
+        _swigfaiss.IDSelectorBatch_swiginit(self, _swigfaiss.new_IDSelectorBatch(n, indices))
+
+    def is_member(self, id):
+        return _swigfaiss.IDSelectorBatch_is_member(self, id)
+    __swig_destroy__ = _swigfaiss.delete_IDSelectorBatch
+
+# Register IDSelectorBatch in _swigfaiss:
+_swigfaiss.IDSelectorBatch_swigregister(IDSelectorBatch)
+class IDSelectorBitmap(IDSelector):
+    r""" One bit per element. Constructed with a bitmap, size ceil(n / 8)."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    n = property(_swigfaiss.IDSelectorBitmap_n_get, _swigfaiss.IDSelectorBitmap_n_set)
+    bitmap = property(_swigfaiss.IDSelectorBitmap_bitmap_get, _swigfaiss.IDSelectorBitmap_bitmap_set)
+
+    def __init__(self, n, bitmap):
+        r"""
+         Construct with a binary mask
+
+        :type n: int
+        :param n: size of the bitmap array
+        :type bitmap: uint8_t
+        :param bitmap: id will be selected iff id / 8 < n and bit number
+                          (i%8) of bitmap[floor(i / 8)] is 1.
+        """
+        _swigfaiss.IDSelectorBitmap_swiginit(self, _swigfaiss.new_IDSelectorBitmap(n, bitmap))
+
+    def is_member(self, id):
+        return _swigfaiss.IDSelectorBitmap_is_member(self, id)
+    __swig_destroy__ = _swigfaiss.delete_IDSelectorBitmap
+
+# Register IDSelectorBitmap in _swigfaiss:
+_swigfaiss.IDSelectorBitmap_swigregister(IDSelectorBitmap)
+class IDSelectorNot(IDSelector):
+    r""" reverts the membership test of another selector"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    sel = property(_swigfaiss.IDSelectorNot_sel_get, _swigfaiss.IDSelectorNot_sel_set)
+
+    def __init__(self, sel):
+        _swigfaiss.IDSelectorNot_swiginit(self, _swigfaiss.new_IDSelectorNot(sel))
+
+    def is_member(self, id):
+        return _swigfaiss.IDSelectorNot_is_member(self, id)
+    __swig_destroy__ = _swigfaiss.delete_IDSelectorNot
+
+# Register IDSelectorNot in _swigfaiss:
+_swigfaiss.IDSelectorNot_swigregister(IDSelectorNot)
+class IDSelectorAll(IDSelector):
+    r""" selects all entries (useful for benchmarking)"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def is_member(self, id):
+        return _swigfaiss.IDSelectorAll_is_member(self, id)
+    __swig_destroy__ = _swigfaiss.delete_IDSelectorAll
+
+    def __init__(self):
+        _swigfaiss.IDSelectorAll_swiginit(self, _swigfaiss.new_IDSelectorAll())
+
+# Register IDSelectorAll in _swigfaiss:
+_swigfaiss.IDSelectorAll_swigregister(IDSelectorAll)
+class IDSelectorAnd(IDSelector):
+    r"""
+    does an AND operation on the the two given IDSelector's is_membership
+    results.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lhs = property(_swigfaiss.IDSelectorAnd_lhs_get, _swigfaiss.IDSelectorAnd_lhs_set)
+    rhs = property(_swigfaiss.IDSelectorAnd_rhs_get, _swigfaiss.IDSelectorAnd_rhs_set)
+
+    def __init__(self, lhs, rhs):
+        _swigfaiss.IDSelectorAnd_swiginit(self, _swigfaiss.new_IDSelectorAnd(lhs, rhs))
+
+    def is_member(self, id):
+        return _swigfaiss.IDSelectorAnd_is_member(self, id)
+    __swig_destroy__ = _swigfaiss.delete_IDSelectorAnd
+
+# Register IDSelectorAnd in _swigfaiss:
+_swigfaiss.IDSelectorAnd_swigregister(IDSelectorAnd)
+class IDSelectorOr(IDSelector):
+    r"""
+    does an OR operation on the the two given IDSelector's is_membership
+    results.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lhs = property(_swigfaiss.IDSelectorOr_lhs_get, _swigfaiss.IDSelectorOr_lhs_set)
+    rhs = property(_swigfaiss.IDSelectorOr_rhs_get, _swigfaiss.IDSelectorOr_rhs_set)
+
+    def __init__(self, lhs, rhs):
+        _swigfaiss.IDSelectorOr_swiginit(self, _swigfaiss.new_IDSelectorOr(lhs, rhs))
+
+    def is_member(self, id):
+        return _swigfaiss.IDSelectorOr_is_member(self, id)
+    __swig_destroy__ = _swigfaiss.delete_IDSelectorOr
+
+# Register IDSelectorOr in _swigfaiss:
+_swigfaiss.IDSelectorOr_swigregister(IDSelectorOr)
+class IDSelectorXOr(IDSelector):
+    r"""
+    does an XOR operation on the the two given IDSelector's is_membership
+    results.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lhs = property(_swigfaiss.IDSelectorXOr_lhs_get, _swigfaiss.IDSelectorXOr_lhs_set)
+    rhs = property(_swigfaiss.IDSelectorXOr_rhs_get, _swigfaiss.IDSelectorXOr_rhs_set)
+
+    def __init__(self, lhs, rhs):
+        _swigfaiss.IDSelectorXOr_swiginit(self, _swigfaiss.new_IDSelectorXOr(lhs, rhs))
+
+    def is_member(self, id):
+        return _swigfaiss.IDSelectorXOr_is_member(self, id)
+    __swig_destroy__ = _swigfaiss.delete_IDSelectorXOr
+
+# Register IDSelectorXOr in _swigfaiss:
+_swigfaiss.IDSelectorXOr_swigregister(IDSelectorXOr)
+class IDSelectorTranslated(IDSelector):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    id_map = property(_swigfaiss.IDSelectorTranslated_id_map_get)
+    sel = property(_swigfaiss.IDSelectorTranslated_sel_get, _swigfaiss.IDSelectorTranslated_sel_set)
+
+    def __init__(self, *args):
+        _swigfaiss.IDSelectorTranslated_swiginit(self, _swigfaiss.new_IDSelectorTranslated(*args))
+
+    def is_member(self, id):
+        return _swigfaiss.IDSelectorTranslated_is_member(self, id)
+    __swig_destroy__ = _swigfaiss.delete_IDSelectorTranslated
+
+# Register IDSelectorTranslated in _swigfaiss:
+_swigfaiss.IDSelectorTranslated_swigregister(IDSelectorTranslated)
+class IndexIDMap(Index):
+    r""" Index that translates search results to ids"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    index = property(_swigfaiss.IndexIDMap_index_get, _swigfaiss.IndexIDMap_index_set)
+    own_fields = property(_swigfaiss.IndexIDMap_own_fields_get, _swigfaiss.IndexIDMap_own_fields_set, doc=r"""the sub-index""")
+    id_map = property(_swigfaiss.IndexIDMap_id_map_get, _swigfaiss.IndexIDMap_id_map_set, doc=r"""whether pointers are deleted in destructo""")
+
+    def add_with_ids(self, n, x, xids):
+        r"""
+        :type xids: int
+        :param xids: if non-null, ids to store for the vectors (size n)
+        """
+        return _swigfaiss.IndexIDMap_add_with_ids(self, n, x, xids)
+
+    def add(self, n, x):
+        r""" this will fail. Use add_with_ids"""
+        return _swigfaiss.IndexIDMap_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexIDMap_search(self, n, x, k, distances, labels, params)
+
+    def train(self, n, x):
+        return _swigfaiss.IndexIDMap_train(self, n, x)
+
+    def reset(self):
+        return _swigfaiss.IndexIDMap_reset(self)
+
+    def remove_ids(self, sel):
+        r""" remove ids adapted to IndexFlat"""
+        return _swigfaiss.IndexIDMap_remove_ids(self, sel)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss.IndexIDMap_range_search(self, n, x, radius, result, params)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss.IndexIDMap_merge_from(self, otherIndex, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss.IndexIDMap_check_compatible_for_merge(self, otherIndex)
+    __swig_destroy__ = _swigfaiss.delete_IndexIDMap
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIDMap_swiginit(self, _swigfaiss.new_IndexIDMap(*args))
+
+# Register IndexIDMap in _swigfaiss:
+_swigfaiss.IndexIDMap_swigregister(IndexIDMap)
+class IndexBinaryIDMap(IndexBinary):
+    r""" Index that translates search results to ids"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    index = property(_swigfaiss.IndexBinaryIDMap_index_get, _swigfaiss.IndexBinaryIDMap_index_set)
+    own_fields = property(_swigfaiss.IndexBinaryIDMap_own_fields_get, _swigfaiss.IndexBinaryIDMap_own_fields_set, doc=r"""the sub-index""")
+    id_map = property(_swigfaiss.IndexBinaryIDMap_id_map_get, _swigfaiss.IndexBinaryIDMap_id_map_set, doc=r"""whether pointers are deleted in destructo""")
+
+    def add_with_ids(self, n, x, xids):
+        r"""
+        :type xids: int
+        :param xids: if non-null, ids to store for the vectors (size n)
+        """
+        return _swigfaiss.IndexBinaryIDMap_add_with_ids(self, n, x, xids)
+
+    def add(self, n, x):
+        r""" this will fail. Use add_with_ids"""
+        return _swigfaiss.IndexBinaryIDMap_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss.IndexBinaryIDMap_search(self, n, x, k, distances, labels, params)
+
+    def train(self, n, x):
+        return _swigfaiss.IndexBinaryIDMap_train(self, n, x)
+
+    def reset(self):
+        return _swigfaiss.IndexBinaryIDMap_reset(self)
+
+    def remove_ids(self, sel):
+        r""" remove ids adapted to IndexFlat"""
+        return _swigfaiss.IndexBinaryIDMap_remove_ids(self, sel)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss.IndexBinaryIDMap_range_search(self, n, x, radius, result, params)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss.IndexBinaryIDMap_merge_from(self, otherIndex, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss.IndexBinaryIDMap_check_compatible_for_merge(self, otherIndex)
+    __swig_destroy__ = _swigfaiss.delete_IndexBinaryIDMap
+
+    def __init__(self, *args):
+        _swigfaiss.IndexBinaryIDMap_swiginit(self, _swigfaiss.new_IndexBinaryIDMap(*args))
+
+# Register IndexBinaryIDMap in _swigfaiss:
+_swigfaiss.IndexBinaryIDMap_swigregister(IndexBinaryIDMap)
+class IndexIDMap2(IndexIDMap):
+    r"""
+    same as IndexIDMap but also provides an efficient reconstruction
+    implementation via a 2-way index
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rev_map = property(_swigfaiss.IndexIDMap2_rev_map_get, _swigfaiss.IndexIDMap2_rev_map_set)
+
+    def construct_rev_map(self):
+        r""" make the rev_map from scratch"""
+        return _swigfaiss.IndexIDMap2_construct_rev_map(self)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss.IndexIDMap2_add_with_ids(self, n, x, xids)
+
+    def remove_ids(self, sel):
+        return _swigfaiss.IndexIDMap2_remove_ids(self, sel)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexIDMap2_reconstruct(self, key, recons)
+
+    def check_consistency(self):
+        r""" check that the rev_map and the id_map are in sync"""
+        return _swigfaiss.IndexIDMap2_check_consistency(self)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss.IndexIDMap2_merge_from(self, otherIndex, add_id)
+    __swig_destroy__ = _swigfaiss.delete_IndexIDMap2
+
+    def __init__(self, *args):
+        _swigfaiss.IndexIDMap2_swiginit(self, _swigfaiss.new_IndexIDMap2(*args))
+
+# Register IndexIDMap2 in _swigfaiss:
+_swigfaiss.IndexIDMap2_swigregister(IndexIDMap2)
+class IndexBinaryIDMap2(IndexBinaryIDMap):
+    r"""
+    same as IndexIDMap but also provides an efficient reconstruction
+    implementation via a 2-way index
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rev_map = property(_swigfaiss.IndexBinaryIDMap2_rev_map_get, _swigfaiss.IndexBinaryIDMap2_rev_map_set)
+
+    def construct_rev_map(self):
+        r""" make the rev_map from scratch"""
+        return _swigfaiss.IndexBinaryIDMap2_construct_rev_map(self)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss.IndexBinaryIDMap2_add_with_ids(self, n, x, xids)
+
+    def remove_ids(self, sel):
+        return _swigfaiss.IndexBinaryIDMap2_remove_ids(self, sel)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss.IndexBinaryIDMap2_reconstruct(self, key, recons)
+
+    def check_consistency(self):
+        r""" check that the rev_map and the id_map are in sync"""
+        return _swigfaiss.IndexBinaryIDMap2_check_consistency(self)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss.IndexBinaryIDMap2_merge_from(self, otherIndex, add_id)
+    __swig_destroy__ = _swigfaiss.delete_IndexBinaryIDMap2
+
+    def __init__(self, *args):
+        _swigfaiss.IndexBinaryIDMap2_swiginit(self, _swigfaiss.new_IndexBinaryIDMap2(*args))
+
+# Register IndexBinaryIDMap2 in _swigfaiss:
+_swigfaiss.IndexBinaryIDMap2_swigregister(IndexBinaryIDMap2)
+EXACT_TOPK = _swigfaiss.EXACT_TOPK
+APPROX_TOPK_BUCKETS_B32_D2 = _swigfaiss.APPROX_TOPK_BUCKETS_B32_D2
+APPROX_TOPK_BUCKETS_B8_D3 = _swigfaiss.APPROX_TOPK_BUCKETS_B8_D3
+APPROX_TOPK_BUCKETS_B16_D2 = _swigfaiss.APPROX_TOPK_BUCKETS_B16_D2
+APPROX_TOPK_BUCKETS_B8_D2 = _swigfaiss.APPROX_TOPK_BUCKETS_B8_D2
+
+def downcast_index(index):
+    return _swigfaiss.downcast_index(index)
+
+def downcast_VectorTransform(vt):
+    return _swigfaiss.downcast_VectorTransform(vt)
+
+def downcast_IndexBinary(index):
+    return _swigfaiss.downcast_IndexBinary(index)
+
+def downcast_InvertedLists(il):
+    return _swigfaiss.downcast_InvertedLists(il)
+
+def downcast_AdditiveQuantizer(aq):
+    return _swigfaiss.downcast_AdditiveQuantizer(aq)
+
+def downcast_Quantizer(aq):
+    return _swigfaiss.downcast_Quantizer(aq)
+
+def write_index(*args):
+    return _swigfaiss.write_index(*args)
+
+def write_index_binary(*args):
+    return _swigfaiss.write_index_binary(*args)
+
+def read_index(*args):
+    return _swigfaiss.read_index(*args)
+
+def read_index_binary(*args):
+    return _swigfaiss.read_index_binary(*args)
+
+def write_VectorTransform(*args):
+    return _swigfaiss.write_VectorTransform(*args)
+
+def read_VectorTransform(*args):
+    return _swigfaiss.read_VectorTransform(*args)
+
+def read_ProductQuantizer(*args):
+    return _swigfaiss.read_ProductQuantizer(*args)
+
+def write_ProductQuantizer(*args):
+    return _swigfaiss.write_ProductQuantizer(*args)
+
+def write_InvertedLists(ils, f):
+    return _swigfaiss.write_InvertedLists(ils, f)
+
+def read_InvertedLists(reader, io_flags=0):
+    return _swigfaiss.read_InvertedLists(reader, io_flags)
+
+def clone_index(arg1):
+    return _swigfaiss.clone_index(arg1)
+class Cloner(object):
+    r"""
+     Cloner class, useful to override classes with other cloning
+    functions. The cloning function above just calls
+    Cloner::clone_Index.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def clone_VectorTransform(self, arg2):
+        return _swigfaiss.Cloner_clone_VectorTransform(self, arg2)
+
+    def clone_Index(self, arg2):
+        return _swigfaiss.Cloner_clone_Index(self, arg2)
+
+    def clone_IndexIVF(self, arg2):
+        return _swigfaiss.Cloner_clone_IndexIVF(self, arg2)
+    __swig_destroy__ = _swigfaiss.delete_Cloner
+
+    def __init__(self):
+        _swigfaiss.Cloner_swiginit(self, _swigfaiss.new_Cloner())
+
+# Register Cloner in _swigfaiss:
+_swigfaiss.Cloner_swigregister(Cloner)
+IO_FLAG_READ_ONLY = cvar.IO_FLAG_READ_ONLY
+IO_FLAG_ONDISK_SAME_DIR = cvar.IO_FLAG_ONDISK_SAME_DIR
+IO_FLAG_SKIP_IVF_DATA = cvar.IO_FLAG_SKIP_IVF_DATA
+IO_FLAG_SKIP_PRECOMPUTE_TABLE = cvar.IO_FLAG_SKIP_PRECOMPUTE_TABLE
+IO_FLAG_MMAP = cvar.IO_FLAG_MMAP
+
+
+def clone_Quantizer(quant):
+    return _swigfaiss.clone_Quantizer(quant)
+
+def clone_binary_index(index):
+    return _swigfaiss.clone_binary_index(index)
+class AutoTuneCriterion(object):
+    r"""
+    Evaluation criterion. Returns a performance measure in [0,1],
+    higher is better.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss.AutoTuneCriterion_nq_get, _swigfaiss.AutoTuneCriterion_nq_set, doc=r""" nb of queries this criterion is evaluated on""")
+    nnn = property(_swigfaiss.AutoTuneCriterion_nnn_get, _swigfaiss.AutoTuneCriterion_nnn_set, doc=r""" nb of NNs that the query should request""")
+    gt_nnn = property(_swigfaiss.AutoTuneCriterion_gt_nnn_get, _swigfaiss.AutoTuneCriterion_gt_nnn_set, doc=r""" nb of GT NNs required to evaluate criterion""")
+    gt_D = property(_swigfaiss.AutoTuneCriterion_gt_D_get, _swigfaiss.AutoTuneCriterion_gt_D_set, doc=r""" Ground-truth distances (size nq * gt_nnn)""")
+    gt_I = property(_swigfaiss.AutoTuneCriterion_gt_I_get, _swigfaiss.AutoTuneCriterion_gt_I_set, doc=r""" Ground-truth indexes (size nq * gt_nnn)""")
+
+    def set_groundtruth(self, gt_nnn, gt_D_in, gt_I_in):
+        r"""
+         Intitializes the gt_D and gt_I vectors. Must be called before evaluating
+
+        :type gt_D_in: float
+        :param gt_D_in:  size nq * gt_nnn
+        :type gt_I_in: int
+        :param gt_I_in:  size nq * gt_nnn
+        """
+        return _swigfaiss.AutoTuneCriterion_set_groundtruth(self, gt_nnn, gt_D_in, gt_I_in)
+
+    def evaluate(self, D, I):
+        r"""
+         Evaluate the criterion.
+
+        :type D: float
+        :param D:  size nq * nnn
+        :type I: int
+        :param I:  size nq * nnn
+        :rtype: float
+        :return: the criterion, between 0 and 1. Larger is better.
+        """
+        return _swigfaiss.AutoTuneCriterion_evaluate(self, D, I)
+    __swig_destroy__ = _swigfaiss.delete_AutoTuneCriterion
+
+# Register AutoTuneCriterion in _swigfaiss:
+_swigfaiss.AutoTuneCriterion_swigregister(AutoTuneCriterion)
+class OneRecallAtRCriterion(AutoTuneCriterion):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    R = property(_swigfaiss.OneRecallAtRCriterion_R_get, _swigfaiss.OneRecallAtRCriterion_R_set)
+
+    def __init__(self, nq, R):
+        _swigfaiss.OneRecallAtRCriterion_swiginit(self, _swigfaiss.new_OneRecallAtRCriterion(nq, R))
+
+    def evaluate(self, D, I):
+        return _swigfaiss.OneRecallAtRCriterion_evaluate(self, D, I)
+    __swig_destroy__ = _swigfaiss.delete_OneRecallAtRCriterion
+
+# Register OneRecallAtRCriterion in _swigfaiss:
+_swigfaiss.OneRecallAtRCriterion_swigregister(OneRecallAtRCriterion)
+class IntersectionCriterion(AutoTuneCriterion):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    R = property(_swigfaiss.IntersectionCriterion_R_get, _swigfaiss.IntersectionCriterion_R_set)
+
+    def __init__(self, nq, R):
+        _swigfaiss.IntersectionCriterion_swiginit(self, _swigfaiss.new_IntersectionCriterion(nq, R))
+
+    def evaluate(self, D, I):
+        return _swigfaiss.IntersectionCriterion_evaluate(self, D, I)
+    __swig_destroy__ = _swigfaiss.delete_IntersectionCriterion
+
+# Register IntersectionCriterion in _swigfaiss:
+_swigfaiss.IntersectionCriterion_swigregister(IntersectionCriterion)
+class OperatingPoint(object):
+    r"""
+    Maintains a list of experimental results. Each operating point is a
+    (perf, t, key) triplet, where higher perf and lower t is
+    better. The key field is an arbitrary identifier for the operating point.
+
+    Includes primitives to extract the Pareto-optimal operating points in the
+    (perf, t) space.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    perf = property(_swigfaiss.OperatingPoint_perf_get, _swigfaiss.OperatingPoint_perf_set, doc=r""" performance measure (output of a Criterion)""")
+    t = property(_swigfaiss.OperatingPoint_t_get, _swigfaiss.OperatingPoint_t_set, doc=r""" corresponding execution time (ms)""")
+    key = property(_swigfaiss.OperatingPoint_key_get, _swigfaiss.OperatingPoint_key_set, doc=r""" key that identifies this op pt""")
+    cno = property(_swigfaiss.OperatingPoint_cno_get, _swigfaiss.OperatingPoint_cno_set, doc=r""" integer identifer""")
+
+    def __init__(self):
+        _swigfaiss.OperatingPoint_swiginit(self, _swigfaiss.new_OperatingPoint())
+    __swig_destroy__ = _swigfaiss.delete_OperatingPoint
+
+# Register OperatingPoint in _swigfaiss:
+_swigfaiss.OperatingPoint_swigregister(OperatingPoint)
+class OperatingPoints(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    all_pts = property(_swigfaiss.OperatingPoints_all_pts_get, _swigfaiss.OperatingPoints_all_pts_set, doc=r""" all operating points""")
+    optimal_pts = property(_swigfaiss.OperatingPoints_optimal_pts_get, _swigfaiss.OperatingPoints_optimal_pts_set, doc=r""" optimal operating points, sorted by perf""")
+
+    def __init__(self):
+        _swigfaiss.OperatingPoints_swiginit(self, _swigfaiss.new_OperatingPoints())
+
+    def merge_with(self, *args):
+        r""" add operating points from other to this, with a prefix to the keys"""
+        return _swigfaiss.OperatingPoints_merge_with(self, *args)
+
+    def clear(self):
+        return _swigfaiss.OperatingPoints_clear(self)
+
+    def add(self, perf, t, key, cno=0):
+        r""" add a performance measure. Return whether it is an optimal point"""
+        return _swigfaiss.OperatingPoints_add(self, perf, t, key, cno)
+
+    def t_for_perf(self, perf):
+        r""" get time required to obtain a given performance measure"""
+        return _swigfaiss.OperatingPoints_t_for_perf(self, perf)
+
+    def display(self, only_optimal=True):
+        r""" easy-to-read output"""
+        return _swigfaiss.OperatingPoints_display(self, only_optimal)
+
+    def all_to_gnuplot(self, fname):
+        r""" output to a format easy to digest by gnuplot"""
+        return _swigfaiss.OperatingPoints_all_to_gnuplot(self, fname)
+
+    def optimal_to_gnuplot(self, fname):
+        return _swigfaiss.OperatingPoints_optimal_to_gnuplot(self, fname)
+    __swig_destroy__ = _swigfaiss.delete_OperatingPoints
+
+# Register OperatingPoints in _swigfaiss:
+_swigfaiss.OperatingPoints_swigregister(OperatingPoints)
+class ParameterRange(object):
+    r""" possible values of a parameter, sorted from least to most expensive/accurate"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    name = property(_swigfaiss.ParameterRange_name_get, _swigfaiss.ParameterRange_name_set)
+    values = property(_swigfaiss.ParameterRange_values_get, _swigfaiss.ParameterRange_values_set)
+
+    def __init__(self):
+        _swigfaiss.ParameterRange_swiginit(self, _swigfaiss.new_ParameterRange())
+    __swig_destroy__ = _swigfaiss.delete_ParameterRange
+
+# Register ParameterRange in _swigfaiss:
+_swigfaiss.ParameterRange_swigregister(ParameterRange)
+class ParameterSpace(object):
+    r""" Uses a-priori knowledge on the Faiss indexes to extract tunable parameters."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    parameter_ranges = property(_swigfaiss.ParameterSpace_parameter_ranges_get, _swigfaiss.ParameterSpace_parameter_ranges_set, doc=r""" all tunable parameters""")
+    verbose = property(_swigfaiss.ParameterSpace_verbose_get, _swigfaiss.ParameterSpace_verbose_set, doc=r""" verbosity during exploration""")
+    n_experiments = property(_swigfaiss.ParameterSpace_n_experiments_get, _swigfaiss.ParameterSpace_n_experiments_set, doc=r""" nb of experiments during optimization (0 = try all combinations)""")
+    batchsize = property(_swigfaiss.ParameterSpace_batchsize_get, _swigfaiss.ParameterSpace_batchsize_set, doc=r""" maximum number of queries to submit at a time.""")
+    thread_over_batches = property(_swigfaiss.ParameterSpace_thread_over_batches_get, _swigfaiss.ParameterSpace_thread_over_batches_set, doc=r"""
+    use multithreading over batches (useful to benchmark
+    independent single-searches)
+    """)
+    min_test_duration = property(_swigfaiss.ParameterSpace_min_test_duration_get, _swigfaiss.ParameterSpace_min_test_duration_set, doc=r"""
+    run tests several times until they reach at least this
+    duration (to avoid jittering in MT mode)
+    """)
+
+    def __init__(self):
+        _swigfaiss.ParameterSpace_swiginit(self, _swigfaiss.new_ParameterSpace())
+
+    def n_combinations(self):
+        r""" nb of combinations, = product of values sizes"""
+        return _swigfaiss.ParameterSpace_n_combinations(self)
+
+    def combination_ge(self, c1, c2):
+        r""" returns whether combinations c1 >= c2 in the tuple sense"""
+        return _swigfaiss.ParameterSpace_combination_ge(self, c1, c2)
+
+    def combination_name(self, cno):
+        r""" get string representation of the combination"""
+        return _swigfaiss.ParameterSpace_combination_name(self, cno)
+
+    def display(self):
+        r""" print a description on stdout"""
+        return _swigfaiss.ParameterSpace_display(self)
+
+    def add_range(self, name):
+        r""" add a new parameter (or return it if it exists)"""
+        return _swigfaiss.ParameterSpace_add_range(self, name)
+
+    def initialize(self, index):
+        r""" initialize with reasonable parameters for the index"""
+        return _swigfaiss.ParameterSpace_initialize(self, index)
+
+    def set_index_parameters(self, *args):
+        r"""
+        *Overload 1:*
+        set a combination of parameters on an index
+
+        |
+
+        *Overload 2:*
+        set a combination of parameters described by a string
+        """
+        return _swigfaiss.ParameterSpace_set_index_parameters(self, *args)
+
+    def set_index_parameter(self, index, name, val):
+        r""" set one of the parameters, returns whether setting was successful"""
+        return _swigfaiss.ParameterSpace_set_index_parameter(self, index, name, val)
+
+    def update_bounds(self, cno, op, upper_bound_perf, lower_bound_t):
+        r"""
+         find an upper bound on the performance and a lower bound on t
+        for configuration cno given another operating point op
+        """
+        return _swigfaiss.ParameterSpace_update_bounds(self, cno, op, upper_bound_perf, lower_bound_t)
+
+    def explore(self, index, nq, xq, crit, ops):
+        r"""
+         explore operating points
+        :type index: :py:class:`Index`
+        :param index:   index to run on
+        :type xq: float
+        :param xq:      query vectors (size nq * index.d)
+        :type crit: :py:class:`AutoTuneCriterion`
+        :param crit:    selection criterion
+        :type ops: :py:class:`OperatingPoints`
+        :param ops:     resulting operating points
+        """
+        return _swigfaiss.ParameterSpace_explore(self, index, nq, xq, crit, ops)
+    __swig_destroy__ = _swigfaiss.delete_ParameterSpace
+
+# Register ParameterSpace in _swigfaiss:
+_swigfaiss.ParameterSpace_swigregister(ParameterSpace)
+
+def index_factory(*args):
+    r"""
+    Build and index with the sequence of processing steps described in
+    the string.
+    """
+    return _swigfaiss.index_factory(*args)
+
+def index_binary_factory(d, description):
+    return _swigfaiss.index_binary_factory(d, description)
+class MatrixStats(object):
+    r"""
+     Reports some statistics on a dataset and comments on them.
+
+    It is a class rather than a function so that all stats can also be
+    accessed from code
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, n, d, x):
+        _swigfaiss.MatrixStats_swiginit(self, _swigfaiss.new_MatrixStats(n, d, x))
+    comments = property(_swigfaiss.MatrixStats_comments_get, _swigfaiss.MatrixStats_comments_set)
+    n = property(_swigfaiss.MatrixStats_n_get, _swigfaiss.MatrixStats_n_set)
+    d = property(_swigfaiss.MatrixStats_d_get, _swigfaiss.MatrixStats_d_set)
+    n_collision = property(_swigfaiss.MatrixStats_n_collision_get, _swigfaiss.MatrixStats_n_collision_set)
+    n_valid = property(_swigfaiss.MatrixStats_n_valid_get, _swigfaiss.MatrixStats_n_valid_set)
+    n0 = property(_swigfaiss.MatrixStats_n0_get, _swigfaiss.MatrixStats_n0_set)
+    min_norm2 = property(_swigfaiss.MatrixStats_min_norm2_get, _swigfaiss.MatrixStats_min_norm2_set)
+    max_norm2 = property(_swigfaiss.MatrixStats_max_norm2_get, _swigfaiss.MatrixStats_max_norm2_set)
+    hash_value = property(_swigfaiss.MatrixStats_hash_value_get, _swigfaiss.MatrixStats_hash_value_set)
+    per_dim_stats = property(_swigfaiss.MatrixStats_per_dim_stats_get, _swigfaiss.MatrixStats_per_dim_stats_set)
+    occurrences = property(_swigfaiss.MatrixStats_occurrences_get, _swigfaiss.MatrixStats_occurrences_set)
+    buf = property(_swigfaiss.MatrixStats_buf_get, _swigfaiss.MatrixStats_buf_set)
+    nbuf = property(_swigfaiss.MatrixStats_nbuf_get, _swigfaiss.MatrixStats_nbuf_set)
+
+    def do_comment(self, fmt):
+        return _swigfaiss.MatrixStats_do_comment(self, fmt)
+    __swig_destroy__ = _swigfaiss.delete_MatrixStats
+
+# Register MatrixStats in _swigfaiss:
+_swigfaiss.MatrixStats_swigregister(MatrixStats)
+class PyCallbackIOWriter(IOWriter):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    callback = property(_swigfaiss.PyCallbackIOWriter_callback_get, _swigfaiss.PyCallbackIOWriter_callback_set)
+    bs = property(_swigfaiss.PyCallbackIOWriter_bs_get, _swigfaiss.PyCallbackIOWriter_bs_set)
+
+    def __init__(self, *args):
+        r"""
+        Callback: Python function that takes a bytes object and
+        returns the number of bytes successfully written.
+        """
+        _swigfaiss.PyCallbackIOWriter_swiginit(self, _swigfaiss.new_PyCallbackIOWriter(*args))
+
+    def __call__(self, ptrv, size, nitems):
+        return _swigfaiss.PyCallbackIOWriter___call__(self, ptrv, size, nitems)
+    __swig_destroy__ = _swigfaiss.delete_PyCallbackIOWriter
+
+# Register PyCallbackIOWriter in _swigfaiss:
+_swigfaiss.PyCallbackIOWriter_swigregister(PyCallbackIOWriter)
+class PyCallbackIOReader(IOReader):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    callback = property(_swigfaiss.PyCallbackIOReader_callback_get, _swigfaiss.PyCallbackIOReader_callback_set)
+    bs = property(_swigfaiss.PyCallbackIOReader_bs_get, _swigfaiss.PyCallbackIOReader_bs_set)
+
+    def __init__(self, *args):
+        r"""
+         Callback: Python function that takes a size and returns a
+        bytes object with the resulting read
+        """
+        _swigfaiss.PyCallbackIOReader_swiginit(self, _swigfaiss.new_PyCallbackIOReader(*args))
+
+    def __call__(self, ptrv, size, nitems):
+        return _swigfaiss.PyCallbackIOReader___call__(self, ptrv, size, nitems)
+    __swig_destroy__ = _swigfaiss.delete_PyCallbackIOReader
+
+# Register PyCallbackIOReader in _swigfaiss:
+_swigfaiss.PyCallbackIOReader_swigregister(PyCallbackIOReader)
+class PyCallbackIDSelector(IDSelector):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    callback = property(_swigfaiss.PyCallbackIDSelector_callback_get, _swigfaiss.PyCallbackIDSelector_callback_set)
+
+    def __init__(self, callback):
+        _swigfaiss.PyCallbackIDSelector_swiginit(self, _swigfaiss.new_PyCallbackIDSelector(callback))
+
+    def is_member(self, id):
+        return _swigfaiss.PyCallbackIDSelector_is_member(self, id)
+    __swig_destroy__ = _swigfaiss.delete_PyCallbackIDSelector
+
+# Register PyCallbackIDSelector in _swigfaiss:
+_swigfaiss.PyCallbackIDSelector_swigregister(PyCallbackIDSelector)
+class float_minheap_array_t(object):
+    r"""
+     a template structure for a set of [min|max]-heaps it is tailored
+    so that the actual data of the heaps can just live in compact
+    arrays.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nh = property(_swigfaiss.float_minheap_array_t_nh_get, _swigfaiss.float_minheap_array_t_nh_set, doc=r""" number of heaps""")
+    k = property(_swigfaiss.float_minheap_array_t_k_get, _swigfaiss.float_minheap_array_t_k_set, doc=r""" allocated size per heap""")
+    ids = property(_swigfaiss.float_minheap_array_t_ids_get, _swigfaiss.float_minheap_array_t_ids_set, doc=r""" identifiers (size nh * k)""")
+    val = property(_swigfaiss.float_minheap_array_t_val_get, _swigfaiss.float_minheap_array_t_val_set, doc=r""" values (distances or similarities), size nh * k""")
+
+    def get_val(self, key):
+        r""" Return the list of values for a heap"""
+        return _swigfaiss.float_minheap_array_t_get_val(self, key)
+
+    def get_ids(self, key):
+        r""" Correspponding identifiers"""
+        return _swigfaiss.float_minheap_array_t_get_ids(self, key)
+
+    def heapify(self):
+        r""" prepare all the heaps before adding"""
+        return _swigfaiss.float_minheap_array_t_heapify(self)
+
+    def addn(self, nj, vin, j0=0, i0=0, ni=-1):
+        r"""
+         add nj elements to heaps i0:i0+ni, with sequential ids
+
+        :type nj: int
+        :param nj:    nb of elements to add to each heap
+        :type vin: float
+        :param vin:   elements to add, size ni * nj
+        :type j0: int, optional
+        :param j0:    add this to the ids that are added
+        :type i0: int, optional
+        :param i0:    first heap to update
+        :type ni: int, optional
+        :param ni:    nb of elements to update (-1 = use nh)
+        """
+        return _swigfaiss.float_minheap_array_t_addn(self, nj, vin, j0, i0, ni)
+
+    def addn_with_ids(self, nj, vin, id_in=None, id_stride=0, i0=0, ni=-1):
+        r"""
+         same as addn
+
+        :type id_in: int, optional
+        :param id_in:     ids of the elements to add, size ni * nj
+        :type id_stride: int, optional
+        :param id_stride: stride for id_in
+        """
+        return _swigfaiss.float_minheap_array_t_addn_with_ids(self, nj, vin, id_in, id_stride, i0, ni)
+
+    def addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in=None, id_stride=0):
+        r"""
+         same as addn_with_ids, but for just a subset of queries
+
+        :type nsubset: int
+        :param nsubset:  number of query entries to update
+        :type subset: int
+        :param subset:   indexes of queries to update, in 0..nh-1, size nsubset
+        """
+        return _swigfaiss.float_minheap_array_t_addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in, id_stride)
+
+    def reorder(self):
+        r""" reorder all the heaps"""
+        return _swigfaiss.float_minheap_array_t_reorder(self)
+
+    def per_line_extrema(self, vals_out, idx_out):
+        r"""
+         this is not really a heap function. It just finds the per-line
+          extrema of each line of array D
+        :type vals_out: float
+        :param vals_out:    extreme value of each line (size nh, or NULL)
+        :type idx_out: int
+        :param idx_out:     index of extreme value (size nh or NULL)
+        """
+        return _swigfaiss.float_minheap_array_t_per_line_extrema(self, vals_out, idx_out)
+
+    def __init__(self):
+        _swigfaiss.float_minheap_array_t_swiginit(self, _swigfaiss.new_float_minheap_array_t())
+    __swig_destroy__ = _swigfaiss.delete_float_minheap_array_t
+
+# Register float_minheap_array_t in _swigfaiss:
+_swigfaiss.float_minheap_array_t_swigregister(float_minheap_array_t)
+class int_minheap_array_t(object):
+    r"""
+     a template structure for a set of [min|max]-heaps it is tailored
+    so that the actual data of the heaps can just live in compact
+    arrays.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nh = property(_swigfaiss.int_minheap_array_t_nh_get, _swigfaiss.int_minheap_array_t_nh_set, doc=r""" number of heaps""")
+    k = property(_swigfaiss.int_minheap_array_t_k_get, _swigfaiss.int_minheap_array_t_k_set, doc=r""" allocated size per heap""")
+    ids = property(_swigfaiss.int_minheap_array_t_ids_get, _swigfaiss.int_minheap_array_t_ids_set, doc=r""" identifiers (size nh * k)""")
+    val = property(_swigfaiss.int_minheap_array_t_val_get, _swigfaiss.int_minheap_array_t_val_set, doc=r""" values (distances or similarities), size nh * k""")
+
+    def get_val(self, key):
+        r""" Return the list of values for a heap"""
+        return _swigfaiss.int_minheap_array_t_get_val(self, key)
+
+    def get_ids(self, key):
+        r""" Correspponding identifiers"""
+        return _swigfaiss.int_minheap_array_t_get_ids(self, key)
+
+    def heapify(self):
+        r""" prepare all the heaps before adding"""
+        return _swigfaiss.int_minheap_array_t_heapify(self)
+
+    def addn(self, nj, vin, j0=0, i0=0, ni=-1):
+        r"""
+         add nj elements to heaps i0:i0+ni, with sequential ids
+
+        :type nj: int
+        :param nj:    nb of elements to add to each heap
+        :type vin: int
+        :param vin:   elements to add, size ni * nj
+        :type j0: int, optional
+        :param j0:    add this to the ids that are added
+        :type i0: int, optional
+        :param i0:    first heap to update
+        :type ni: int, optional
+        :param ni:    nb of elements to update (-1 = use nh)
+        """
+        return _swigfaiss.int_minheap_array_t_addn(self, nj, vin, j0, i0, ni)
+
+    def addn_with_ids(self, nj, vin, id_in=None, id_stride=0, i0=0, ni=-1):
+        r"""
+         same as addn
+
+        :type id_in: int, optional
+        :param id_in:     ids of the elements to add, size ni * nj
+        :type id_stride: int, optional
+        :param id_stride: stride for id_in
+        """
+        return _swigfaiss.int_minheap_array_t_addn_with_ids(self, nj, vin, id_in, id_stride, i0, ni)
+
+    def addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in=None, id_stride=0):
+        r"""
+         same as addn_with_ids, but for just a subset of queries
+
+        :type nsubset: int
+        :param nsubset:  number of query entries to update
+        :type subset: int
+        :param subset:   indexes of queries to update, in 0..nh-1, size nsubset
+        """
+        return _swigfaiss.int_minheap_array_t_addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in, id_stride)
+
+    def reorder(self):
+        r""" reorder all the heaps"""
+        return _swigfaiss.int_minheap_array_t_reorder(self)
+
+    def per_line_extrema(self, vals_out, idx_out):
+        r"""
+         this is not really a heap function. It just finds the per-line
+          extrema of each line of array D
+        :type vals_out: int
+        :param vals_out:    extreme value of each line (size nh, or NULL)
+        :type idx_out: int
+        :param idx_out:     index of extreme value (size nh or NULL)
+        """
+        return _swigfaiss.int_minheap_array_t_per_line_extrema(self, vals_out, idx_out)
+
+    def __init__(self):
+        _swigfaiss.int_minheap_array_t_swiginit(self, _swigfaiss.new_int_minheap_array_t())
+    __swig_destroy__ = _swigfaiss.delete_int_minheap_array_t
+
+# Register int_minheap_array_t in _swigfaiss:
+_swigfaiss.int_minheap_array_t_swigregister(int_minheap_array_t)
+class float_maxheap_array_t(object):
+    r"""
+     a template structure for a set of [min|max]-heaps it is tailored
+    so that the actual data of the heaps can just live in compact
+    arrays.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nh = property(_swigfaiss.float_maxheap_array_t_nh_get, _swigfaiss.float_maxheap_array_t_nh_set, doc=r""" number of heaps""")
+    k = property(_swigfaiss.float_maxheap_array_t_k_get, _swigfaiss.float_maxheap_array_t_k_set, doc=r""" allocated size per heap""")
+    ids = property(_swigfaiss.float_maxheap_array_t_ids_get, _swigfaiss.float_maxheap_array_t_ids_set, doc=r""" identifiers (size nh * k)""")
+    val = property(_swigfaiss.float_maxheap_array_t_val_get, _swigfaiss.float_maxheap_array_t_val_set, doc=r""" values (distances or similarities), size nh * k""")
+
+    def get_val(self, key):
+        r""" Return the list of values for a heap"""
+        return _swigfaiss.float_maxheap_array_t_get_val(self, key)
+
+    def get_ids(self, key):
+        r""" Correspponding identifiers"""
+        return _swigfaiss.float_maxheap_array_t_get_ids(self, key)
+
+    def heapify(self):
+        r""" prepare all the heaps before adding"""
+        return _swigfaiss.float_maxheap_array_t_heapify(self)
+
+    def addn(self, nj, vin, j0=0, i0=0, ni=-1):
+        r"""
+         add nj elements to heaps i0:i0+ni, with sequential ids
+
+        :type nj: int
+        :param nj:    nb of elements to add to each heap
+        :type vin: float
+        :param vin:   elements to add, size ni * nj
+        :type j0: int, optional
+        :param j0:    add this to the ids that are added
+        :type i0: int, optional
+        :param i0:    first heap to update
+        :type ni: int, optional
+        :param ni:    nb of elements to update (-1 = use nh)
+        """
+        return _swigfaiss.float_maxheap_array_t_addn(self, nj, vin, j0, i0, ni)
+
+    def addn_with_ids(self, nj, vin, id_in=None, id_stride=0, i0=0, ni=-1):
+        r"""
+         same as addn
+
+        :type id_in: int, optional
+        :param id_in:     ids of the elements to add, size ni * nj
+        :type id_stride: int, optional
+        :param id_stride: stride for id_in
+        """
+        return _swigfaiss.float_maxheap_array_t_addn_with_ids(self, nj, vin, id_in, id_stride, i0, ni)
+
+    def addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in=None, id_stride=0):
+        r"""
+         same as addn_with_ids, but for just a subset of queries
+
+        :type nsubset: int
+        :param nsubset:  number of query entries to update
+        :type subset: int
+        :param subset:   indexes of queries to update, in 0..nh-1, size nsubset
+        """
+        return _swigfaiss.float_maxheap_array_t_addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in, id_stride)
+
+    def reorder(self):
+        r""" reorder all the heaps"""
+        return _swigfaiss.float_maxheap_array_t_reorder(self)
+
+    def per_line_extrema(self, vals_out, idx_out):
+        r"""
+         this is not really a heap function. It just finds the per-line
+          extrema of each line of array D
+        :type vals_out: float
+        :param vals_out:    extreme value of each line (size nh, or NULL)
+        :type idx_out: int
+        :param idx_out:     index of extreme value (size nh or NULL)
+        """
+        return _swigfaiss.float_maxheap_array_t_per_line_extrema(self, vals_out, idx_out)
+
+    def __init__(self):
+        _swigfaiss.float_maxheap_array_t_swiginit(self, _swigfaiss.new_float_maxheap_array_t())
+    __swig_destroy__ = _swigfaiss.delete_float_maxheap_array_t
+
+# Register float_maxheap_array_t in _swigfaiss:
+_swigfaiss.float_maxheap_array_t_swigregister(float_maxheap_array_t)
+class int_maxheap_array_t(object):
+    r"""
+     a template structure for a set of [min|max]-heaps it is tailored
+    so that the actual data of the heaps can just live in compact
+    arrays.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nh = property(_swigfaiss.int_maxheap_array_t_nh_get, _swigfaiss.int_maxheap_array_t_nh_set, doc=r""" number of heaps""")
+    k = property(_swigfaiss.int_maxheap_array_t_k_get, _swigfaiss.int_maxheap_array_t_k_set, doc=r""" allocated size per heap""")
+    ids = property(_swigfaiss.int_maxheap_array_t_ids_get, _swigfaiss.int_maxheap_array_t_ids_set, doc=r""" identifiers (size nh * k)""")
+    val = property(_swigfaiss.int_maxheap_array_t_val_get, _swigfaiss.int_maxheap_array_t_val_set, doc=r""" values (distances or similarities), size nh * k""")
+
+    def get_val(self, key):
+        r""" Return the list of values for a heap"""
+        return _swigfaiss.int_maxheap_array_t_get_val(self, key)
+
+    def get_ids(self, key):
+        r""" Correspponding identifiers"""
+        return _swigfaiss.int_maxheap_array_t_get_ids(self, key)
+
+    def heapify(self):
+        r""" prepare all the heaps before adding"""
+        return _swigfaiss.int_maxheap_array_t_heapify(self)
+
+    def addn(self, nj, vin, j0=0, i0=0, ni=-1):
+        r"""
+         add nj elements to heaps i0:i0+ni, with sequential ids
+
+        :type nj: int
+        :param nj:    nb of elements to add to each heap
+        :type vin: int
+        :param vin:   elements to add, size ni * nj
+        :type j0: int, optional
+        :param j0:    add this to the ids that are added
+        :type i0: int, optional
+        :param i0:    first heap to update
+        :type ni: int, optional
+        :param ni:    nb of elements to update (-1 = use nh)
+        """
+        return _swigfaiss.int_maxheap_array_t_addn(self, nj, vin, j0, i0, ni)
+
+    def addn_with_ids(self, nj, vin, id_in=None, id_stride=0, i0=0, ni=-1):
+        r"""
+         same as addn
+
+        :type id_in: int, optional
+        :param id_in:     ids of the elements to add, size ni * nj
+        :type id_stride: int, optional
+        :param id_stride: stride for id_in
+        """
+        return _swigfaiss.int_maxheap_array_t_addn_with_ids(self, nj, vin, id_in, id_stride, i0, ni)
+
+    def addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in=None, id_stride=0):
+        r"""
+         same as addn_with_ids, but for just a subset of queries
+
+        :type nsubset: int
+        :param nsubset:  number of query entries to update
+        :type subset: int
+        :param subset:   indexes of queries to update, in 0..nh-1, size nsubset
+        """
+        return _swigfaiss.int_maxheap_array_t_addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in, id_stride)
+
+    def reorder(self):
+        r""" reorder all the heaps"""
+        return _swigfaiss.int_maxheap_array_t_reorder(self)
+
+    def per_line_extrema(self, vals_out, idx_out):
+        r"""
+         this is not really a heap function. It just finds the per-line
+          extrema of each line of array D
+        :type vals_out: int
+        :param vals_out:    extreme value of each line (size nh, or NULL)
+        :type idx_out: int
+        :param idx_out:     index of extreme value (size nh or NULL)
+        """
+        return _swigfaiss.int_maxheap_array_t_per_line_extrema(self, vals_out, idx_out)
+
+    def __init__(self):
+        _swigfaiss.int_maxheap_array_t_swiginit(self, _swigfaiss.new_int_maxheap_array_t())
+    __swig_destroy__ = _swigfaiss.delete_int_maxheap_array_t
+
+# Register int_maxheap_array_t in _swigfaiss:
+_swigfaiss.int_maxheap_array_t_swigregister(int_maxheap_array_t)
+
+def CMin_float_partition_fuzzy(vals, ids, n, q_min, q_max, q_out):
+    r"""
+     partitions the table into 0:q and q:n where all elements above q are >= all
+    elements below q (for C = CMax, for CMin comparisons are reversed)
+
+    Returns the partition threshold. The elements q:n are destroyed on output.
+    """
+    return _swigfaiss.CMin_float_partition_fuzzy(vals, ids, n, q_min, q_max, q_out)
+
+def CMax_float_partition_fuzzy(vals, ids, n, q_min, q_max, q_out):
+    r"""
+     partitions the table into 0:q and q:n where all elements above q are >= all
+    elements below q (for C = CMax, for CMin comparisons are reversed)
+
+    Returns the partition threshold. The elements q:n are destroyed on output.
+    """
+    return _swigfaiss.CMax_float_partition_fuzzy(vals, ids, n, q_min, q_max, q_out)
+class AlignedTableUint8(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    tab = property(_swigfaiss.AlignedTableUint8_tab_get, _swigfaiss.AlignedTableUint8_tab_set)
+    numel = property(_swigfaiss.AlignedTableUint8_numel_get, _swigfaiss.AlignedTableUint8_numel_set)
+
+    @staticmethod
+    def round_capacity(n):
+        return _swigfaiss.AlignedTableUint8_round_capacity(n)
+
+    def __init__(self, *args):
+        _swigfaiss.AlignedTableUint8_swiginit(self, _swigfaiss.new_AlignedTableUint8(*args))
+
+    def itemsize(self):
+        return _swigfaiss.AlignedTableUint8_itemsize(self)
+
+    def resize(self, n):
+        return _swigfaiss.AlignedTableUint8_resize(self, n)
+
+    def clear(self):
+        return _swigfaiss.AlignedTableUint8_clear(self)
+
+    def size(self):
+        return _swigfaiss.AlignedTableUint8_size(self)
+
+    def nbytes(self):
+        return _swigfaiss.AlignedTableUint8_nbytes(self)
+
+    def get(self, *args):
+        return _swigfaiss.AlignedTableUint8_get(self, *args)
+
+    def data(self, *args):
+        return _swigfaiss.AlignedTableUint8_data(self, *args)
+    __swig_destroy__ = _swigfaiss.delete_AlignedTableUint8
+
+# Register AlignedTableUint8 in _swigfaiss:
+_swigfaiss.AlignedTableUint8_swigregister(AlignedTableUint8)
+class AlignedTableUint16(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    tab = property(_swigfaiss.AlignedTableUint16_tab_get, _swigfaiss.AlignedTableUint16_tab_set)
+    numel = property(_swigfaiss.AlignedTableUint16_numel_get, _swigfaiss.AlignedTableUint16_numel_set)
+
+    @staticmethod
+    def round_capacity(n):
+        return _swigfaiss.AlignedTableUint16_round_capacity(n)
+
+    def __init__(self, *args):
+        _swigfaiss.AlignedTableUint16_swiginit(self, _swigfaiss.new_AlignedTableUint16(*args))
+
+    def itemsize(self):
+        return _swigfaiss.AlignedTableUint16_itemsize(self)
+
+    def resize(self, n):
+        return _swigfaiss.AlignedTableUint16_resize(self, n)
+
+    def clear(self):
+        return _swigfaiss.AlignedTableUint16_clear(self)
+
+    def size(self):
+        return _swigfaiss.AlignedTableUint16_size(self)
+
+    def nbytes(self):
+        return _swigfaiss.AlignedTableUint16_nbytes(self)
+
+    def get(self, *args):
+        return _swigfaiss.AlignedTableUint16_get(self, *args)
+
+    def data(self, *args):
+        return _swigfaiss.AlignedTableUint16_data(self, *args)
+    __swig_destroy__ = _swigfaiss.delete_AlignedTableUint16
+
+# Register AlignedTableUint16 in _swigfaiss:
+_swigfaiss.AlignedTableUint16_swigregister(AlignedTableUint16)
+class AlignedTableFloat32(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    tab = property(_swigfaiss.AlignedTableFloat32_tab_get, _swigfaiss.AlignedTableFloat32_tab_set)
+    numel = property(_swigfaiss.AlignedTableFloat32_numel_get, _swigfaiss.AlignedTableFloat32_numel_set)
+
+    @staticmethod
+    def round_capacity(n):
+        return _swigfaiss.AlignedTableFloat32_round_capacity(n)
+
+    def __init__(self, *args):
+        _swigfaiss.AlignedTableFloat32_swiginit(self, _swigfaiss.new_AlignedTableFloat32(*args))
+
+    def itemsize(self):
+        return _swigfaiss.AlignedTableFloat32_itemsize(self)
+
+    def resize(self, n):
+        return _swigfaiss.AlignedTableFloat32_resize(self, n)
+
+    def clear(self):
+        return _swigfaiss.AlignedTableFloat32_clear(self)
+
+    def size(self):
+        return _swigfaiss.AlignedTableFloat32_size(self)
+
+    def nbytes(self):
+        return _swigfaiss.AlignedTableFloat32_nbytes(self)
+
+    def get(self, *args):
+        return _swigfaiss.AlignedTableFloat32_get(self, *args)
+
+    def data(self, *args):
+        return _swigfaiss.AlignedTableFloat32_data(self, *args)
+    __swig_destroy__ = _swigfaiss.delete_AlignedTableFloat32
+
+# Register AlignedTableFloat32 in _swigfaiss:
+_swigfaiss.AlignedTableFloat32_swigregister(AlignedTableFloat32)
+
+def CMin_uint16_partition_fuzzy(*args):
+    return _swigfaiss.CMin_uint16_partition_fuzzy(*args)
+
+def CMax_uint16_partition_fuzzy(*args):
+    return _swigfaiss.CMax_uint16_partition_fuzzy(*args)
+
+def merge_knn_results_CMin(*args):
+    return _swigfaiss.merge_knn_results_CMin(*args)
+
+def merge_knn_results_CMax(*args):
+    return _swigfaiss.merge_knn_results_CMax(*args)
+class MapLong2Long(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    map = property(_swigfaiss.MapLong2Long_map_get, _swigfaiss.MapLong2Long_map_set)
+
+    def add(self, n, keys, vals):
+        return _swigfaiss.MapLong2Long_add(self, n, keys, vals)
+
+    def search(self, key):
+        return _swigfaiss.MapLong2Long_search(self, key)
+
+    def search_multiple(self, n, keys, vals):
+        return _swigfaiss.MapLong2Long_search_multiple(self, n, keys, vals)
+
+    def __init__(self):
+        _swigfaiss.MapLong2Long_swiginit(self, _swigfaiss.new_MapLong2Long())
+    __swig_destroy__ = _swigfaiss.delete_MapLong2Long
+
+# Register MapLong2Long in _swigfaiss:
+_swigfaiss.MapLong2Long_swigregister(MapLong2Long)
+
+def omp_set_num_threads(num_threads):
+    return _swigfaiss.omp_set_num_threads(num_threads)
+
+def omp_get_max_threads():
+    return _swigfaiss.omp_get_max_threads()
+
+def memcpy(dest, src, n):
+    return _swigfaiss.memcpy(dest, src, n)
+
+def swig_ptr(a):
+    return _swigfaiss.swig_ptr(a)
+
+def rev_swig_ptr(*args):
+    return _swigfaiss.rev_swig_ptr(*args)
+
+def cast_integer_to_uint8_ptr(x):
+    return _swigfaiss.cast_integer_to_uint8_ptr(x)
+
+def cast_integer_to_float_ptr(x):
+    return _swigfaiss.cast_integer_to_float_ptr(x)
+
+def cast_integer_to_idx_t_ptr(x):
+    return _swigfaiss.cast_integer_to_idx_t_ptr(x)
+
+def cast_integer_to_int_ptr(x):
+    return _swigfaiss.cast_integer_to_int_ptr(x)
+
+def cast_integer_to_void_ptr(x):
+    return _swigfaiss.cast_integer_to_void_ptr(x)
+
+def wait():
+    return _swigfaiss.wait()
+
diff --git a/llm/Lib/site-packages/faiss/swigfaiss_avx2.py b/llm/Lib/site-packages/faiss/swigfaiss_avx2.py
new file mode 100644
index 0000000000000000000000000000000000000000..895311611575e2481976c3c1b20289e8496da414
--- /dev/null
+++ b/llm/Lib/site-packages/faiss/swigfaiss_avx2.py
@@ -0,0 +1,11343 @@
+# This file was automatically generated by SWIG (https://www.swig.org).
+# Version 4.1.1
+#
+# Do not make changes to this file unless you know what you are doing - modify
+# the SWIG interface file instead.
+
+from sys import version_info as _swig_python_version_info
+# Import the low-level C/C++ module
+if __package__ or "." in __name__:
+    from . import _swigfaiss_avx2
+else:
+    import _swigfaiss_avx2
+
+try:
+    import builtins as __builtin__
+except ImportError:
+    import __builtin__
+
+def _swig_repr(self):
+    try:
+        strthis = "proxy of " + self.this.__repr__()
+    except __builtin__.Exception:
+        strthis = ""
+    return "<%s.%s; %s >" % (self.__class__.__module__, self.__class__.__name__, strthis,)
+
+
+def _swig_setattr_nondynamic_instance_variable(set):
+    def set_instance_attr(self, name, value):
+        if name == "this":
+            set(self, name, value)
+        elif name == "thisown":
+            self.this.own(value)
+        elif hasattr(self, name) and isinstance(getattr(type(self), name), property):
+            set(self, name, value)
+        else:
+            raise AttributeError("You cannot add instance attributes to %s" % self)
+    return set_instance_attr
+
+
+def _swig_setattr_nondynamic_class_variable(set):
+    def set_class_attr(cls, name, value):
+        if hasattr(cls, name) and not isinstance(getattr(cls, name), property):
+            set(cls, name, value)
+        else:
+            raise AttributeError("You cannot add class attributes to %s" % cls)
+    return set_class_attr
+
+
+def _swig_add_metaclass(metaclass):
+    """Class decorator for adding a metaclass to a SWIG wrapped class - a slimmed down version of six.add_metaclass"""
+    def wrapper(cls):
+        return metaclass(cls.__name__, cls.__bases__, cls.__dict__.copy())
+    return wrapper
+
+
+class _SwigNonDynamicMeta(type):
+    """Meta class to enforce nondynamic attributes (no new attributes) for a class"""
+    __setattr__ = _swig_setattr_nondynamic_class_variable(type.__setattr__)
+
+
+class SwigPyIterator(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    __swig_destroy__ = _swigfaiss_avx2.delete_SwigPyIterator
+
+    def value(self):
+        return _swigfaiss_avx2.SwigPyIterator_value(self)
+
+    def incr(self, n=1):
+        return _swigfaiss_avx2.SwigPyIterator_incr(self, n)
+
+    def decr(self, n=1):
+        return _swigfaiss_avx2.SwigPyIterator_decr(self, n)
+
+    def distance(self, x):
+        return _swigfaiss_avx2.SwigPyIterator_distance(self, x)
+
+    def equal(self, x):
+        return _swigfaiss_avx2.SwigPyIterator_equal(self, x)
+
+    def copy(self):
+        return _swigfaiss_avx2.SwigPyIterator_copy(self)
+
+    def next(self):
+        return _swigfaiss_avx2.SwigPyIterator_next(self)
+
+    def __next__(self):
+        return _swigfaiss_avx2.SwigPyIterator___next__(self)
+
+    def previous(self):
+        return _swigfaiss_avx2.SwigPyIterator_previous(self)
+
+    def advance(self, n):
+        return _swigfaiss_avx2.SwigPyIterator_advance(self, n)
+
+    def __eq__(self, x):
+        return _swigfaiss_avx2.SwigPyIterator___eq__(self, x)
+
+    def __ne__(self, x):
+        return _swigfaiss_avx2.SwigPyIterator___ne__(self, x)
+
+    def __iadd__(self, n):
+        return _swigfaiss_avx2.SwigPyIterator___iadd__(self, n)
+
+    def __isub__(self, n):
+        return _swigfaiss_avx2.SwigPyIterator___isub__(self, n)
+
+    def __add__(self, n):
+        return _swigfaiss_avx2.SwigPyIterator___add__(self, n)
+
+    def __sub__(self, *args):
+        return _swigfaiss_avx2.SwigPyIterator___sub__(self, *args)
+    def __iter__(self):
+        return self
+
+# Register SwigPyIterator in _swigfaiss_avx2:
+_swigfaiss_avx2.SwigPyIterator_swigregister(SwigPyIterator)
+SHARED_PTR_DISOWN = _swigfaiss_avx2.SHARED_PTR_DISOWN
+class Float32Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.Float32Vector_swiginit(self, _swigfaiss_avx2.new_Float32Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.Float32Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.Float32Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.Float32Vector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.Float32Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.Float32Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.Float32Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.Float32Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Float32Vector
+
+# Register Float32Vector in _swigfaiss_avx2:
+_swigfaiss_avx2.Float32Vector_swigregister(Float32Vector)
+class Float64Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.Float64Vector_swiginit(self, _swigfaiss_avx2.new_Float64Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.Float64Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.Float64Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.Float64Vector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.Float64Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.Float64Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.Float64Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.Float64Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Float64Vector
+
+# Register Float64Vector in _swigfaiss_avx2:
+_swigfaiss_avx2.Float64Vector_swigregister(Float64Vector)
+class Int8Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.Int8Vector_swiginit(self, _swigfaiss_avx2.new_Int8Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.Int8Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.Int8Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.Int8Vector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.Int8Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.Int8Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.Int8Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.Int8Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Int8Vector
+
+# Register Int8Vector in _swigfaiss_avx2:
+_swigfaiss_avx2.Int8Vector_swigregister(Int8Vector)
+class Int16Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.Int16Vector_swiginit(self, _swigfaiss_avx2.new_Int16Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.Int16Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.Int16Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.Int16Vector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.Int16Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.Int16Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.Int16Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.Int16Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Int16Vector
+
+# Register Int16Vector in _swigfaiss_avx2:
+_swigfaiss_avx2.Int16Vector_swigregister(Int16Vector)
+class Int32Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.Int32Vector_swiginit(self, _swigfaiss_avx2.new_Int32Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.Int32Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.Int32Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.Int32Vector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.Int32Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.Int32Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.Int32Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.Int32Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Int32Vector
+
+# Register Int32Vector in _swigfaiss_avx2:
+_swigfaiss_avx2.Int32Vector_swigregister(Int32Vector)
+class Int64Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.Int64Vector_swiginit(self, _swigfaiss_avx2.new_Int64Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.Int64Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.Int64Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.Int64Vector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.Int64Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.Int64Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.Int64Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.Int64Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Int64Vector
+
+# Register Int64Vector in _swigfaiss_avx2:
+_swigfaiss_avx2.Int64Vector_swigregister(Int64Vector)
+class UInt8Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.UInt8Vector_swiginit(self, _swigfaiss_avx2.new_UInt8Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.UInt8Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.UInt8Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.UInt8Vector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.UInt8Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.UInt8Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.UInt8Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.UInt8Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_UInt8Vector
+
+# Register UInt8Vector in _swigfaiss_avx2:
+_swigfaiss_avx2.UInt8Vector_swigregister(UInt8Vector)
+class UInt16Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.UInt16Vector_swiginit(self, _swigfaiss_avx2.new_UInt16Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.UInt16Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.UInt16Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.UInt16Vector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.UInt16Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.UInt16Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.UInt16Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.UInt16Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_UInt16Vector
+
+# Register UInt16Vector in _swigfaiss_avx2:
+_swigfaiss_avx2.UInt16Vector_swigregister(UInt16Vector)
+class UInt32Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.UInt32Vector_swiginit(self, _swigfaiss_avx2.new_UInt32Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.UInt32Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.UInt32Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.UInt32Vector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.UInt32Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.UInt32Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.UInt32Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.UInt32Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_UInt32Vector
+
+# Register UInt32Vector in _swigfaiss_avx2:
+_swigfaiss_avx2.UInt32Vector_swigregister(UInt32Vector)
+class UInt64Vector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.UInt64Vector_swiginit(self, _swigfaiss_avx2.new_UInt64Vector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.UInt64Vector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.UInt64Vector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.UInt64Vector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.UInt64Vector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.UInt64Vector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.UInt64Vector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.UInt64Vector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_UInt64Vector
+
+# Register UInt64Vector in _swigfaiss_avx2:
+_swigfaiss_avx2.UInt64Vector_swigregister(UInt64Vector)
+class Float32VectorVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.Float32VectorVector_swiginit(self, _swigfaiss_avx2.new_Float32VectorVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.Float32VectorVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.Float32VectorVector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.Float32VectorVector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.Float32VectorVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.Float32VectorVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.Float32VectorVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.Float32VectorVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Float32VectorVector
+
+# Register Float32VectorVector in _swigfaiss_avx2:
+_swigfaiss_avx2.Float32VectorVector_swigregister(Float32VectorVector)
+class UInt8VectorVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.UInt8VectorVector_swiginit(self, _swigfaiss_avx2.new_UInt8VectorVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.UInt8VectorVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.UInt8VectorVector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.UInt8VectorVector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.UInt8VectorVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.UInt8VectorVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.UInt8VectorVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.UInt8VectorVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_UInt8VectorVector
+
+# Register UInt8VectorVector in _swigfaiss_avx2:
+_swigfaiss_avx2.UInt8VectorVector_swigregister(UInt8VectorVector)
+class Int32VectorVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.Int32VectorVector_swiginit(self, _swigfaiss_avx2.new_Int32VectorVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.Int32VectorVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.Int32VectorVector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.Int32VectorVector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.Int32VectorVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.Int32VectorVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.Int32VectorVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.Int32VectorVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Int32VectorVector
+
+# Register Int32VectorVector in _swigfaiss_avx2:
+_swigfaiss_avx2.Int32VectorVector_swigregister(Int32VectorVector)
+class Int64VectorVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.Int64VectorVector_swiginit(self, _swigfaiss_avx2.new_Int64VectorVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.Int64VectorVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.Int64VectorVector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.Int64VectorVector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.Int64VectorVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.Int64VectorVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.Int64VectorVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.Int64VectorVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Int64VectorVector
+
+# Register Int64VectorVector in _swigfaiss_avx2:
+_swigfaiss_avx2.Int64VectorVector_swigregister(Int64VectorVector)
+class VectorTransformVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.VectorTransformVector_swiginit(self, _swigfaiss_avx2.new_VectorTransformVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.VectorTransformVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.VectorTransformVector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.VectorTransformVector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.VectorTransformVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.VectorTransformVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.VectorTransformVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.VectorTransformVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_VectorTransformVector
+
+# Register VectorTransformVector in _swigfaiss_avx2:
+_swigfaiss_avx2.VectorTransformVector_swigregister(VectorTransformVector)
+class OperatingPointVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.OperatingPointVector_swiginit(self, _swigfaiss_avx2.new_OperatingPointVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.OperatingPointVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.OperatingPointVector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.OperatingPointVector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.OperatingPointVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.OperatingPointVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.OperatingPointVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.OperatingPointVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_OperatingPointVector
+
+# Register OperatingPointVector in _swigfaiss_avx2:
+_swigfaiss_avx2.OperatingPointVector_swigregister(OperatingPointVector)
+class InvertedListsPtrVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.InvertedListsPtrVector_swiginit(self, _swigfaiss_avx2.new_InvertedListsPtrVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.InvertedListsPtrVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.InvertedListsPtrVector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.InvertedListsPtrVector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.InvertedListsPtrVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.InvertedListsPtrVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.InvertedListsPtrVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.InvertedListsPtrVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_InvertedListsPtrVector
+
+# Register InvertedListsPtrVector in _swigfaiss_avx2:
+_swigfaiss_avx2.InvertedListsPtrVector_swigregister(InvertedListsPtrVector)
+class RepeatVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.RepeatVector_swiginit(self, _swigfaiss_avx2.new_RepeatVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.RepeatVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.RepeatVector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.RepeatVector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.RepeatVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.RepeatVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.RepeatVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.RepeatVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_RepeatVector
+
+# Register RepeatVector in _swigfaiss_avx2:
+_swigfaiss_avx2.RepeatVector_swigregister(RepeatVector)
+class ClusteringIterationStatsVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.ClusteringIterationStatsVector_swiginit(self, _swigfaiss_avx2.new_ClusteringIterationStatsVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.ClusteringIterationStatsVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.ClusteringIterationStatsVector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.ClusteringIterationStatsVector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.ClusteringIterationStatsVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.ClusteringIterationStatsVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.ClusteringIterationStatsVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.ClusteringIterationStatsVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ClusteringIterationStatsVector
+
+# Register ClusteringIterationStatsVector in _swigfaiss_avx2:
+_swigfaiss_avx2.ClusteringIterationStatsVector_swigregister(ClusteringIterationStatsVector)
+class ParameterRangeVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.ParameterRangeVector_swiginit(self, _swigfaiss_avx2.new_ParameterRangeVector())
+
+    def push_back(self, arg2):
+        return _swigfaiss_avx2.ParameterRangeVector_push_back(self, arg2)
+
+    def clear(self):
+        return _swigfaiss_avx2.ParameterRangeVector_clear(self)
+
+    def data(self):
+        return _swigfaiss_avx2.ParameterRangeVector_data(self)
+
+    def size(self):
+        return _swigfaiss_avx2.ParameterRangeVector_size(self)
+
+    def at(self, n):
+        return _swigfaiss_avx2.ParameterRangeVector_at(self, n)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.ParameterRangeVector_resize(self, n)
+
+    def swap(self, other):
+        return _swigfaiss_avx2.ParameterRangeVector_swap(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ParameterRangeVector
+
+# Register ParameterRangeVector in _swigfaiss_avx2:
+_swigfaiss_avx2.ParameterRangeVector_swigregister(ParameterRangeVector)
+
+def __builtin_ctzll(x):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+    return _swigfaiss_avx2.__builtin_ctzll(x)
+
+def __builtin_ctz(x):
+    return _swigfaiss_avx2.__builtin_ctz(x)
+
+def __builtin_clzll(x):
+    return _swigfaiss_avx2.__builtin_clzll(x)
+
+def simd_histogram_8(data, n, min, shift, hist):
+    r"""
+     low level SIMD histogramming functions  8-bin histogram of (x - min) >> shift
+    values outside the range are ignored.
+    the data table should be aligned on 32 bytes
+    """
+    return _swigfaiss_avx2.simd_histogram_8(data, n, min, shift, hist)
+
+def simd_histogram_16(data, n, min, shift, hist):
+    r""" same for 16-bin histogram"""
+    return _swigfaiss_avx2.simd_histogram_16(data, n, min, shift, hist)
+class PartitionStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    bissect_cycles = property(_swigfaiss_avx2.PartitionStats_bissect_cycles_get, _swigfaiss_avx2.PartitionStats_bissect_cycles_set)
+    compress_cycles = property(_swigfaiss_avx2.PartitionStats_compress_cycles_get, _swigfaiss_avx2.PartitionStats_compress_cycles_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.PartitionStats_swiginit(self, _swigfaiss_avx2.new_PartitionStats())
+
+    def reset(self):
+        return _swigfaiss_avx2.PartitionStats_reset(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_PartitionStats
+
+# Register PartitionStats in _swigfaiss_avx2:
+_swigfaiss_avx2.PartitionStats_swigregister(PartitionStats)
+
+def bitvec_print(b, d):
+    return _swigfaiss_avx2.bitvec_print(b, d)
+
+def fvecs2bitvecs(x, b, d, n):
+    return _swigfaiss_avx2.fvecs2bitvecs(x, b, d, n)
+
+def bitvecs2fvecs(b, x, d, n):
+    return _swigfaiss_avx2.bitvecs2fvecs(b, x, d, n)
+
+def fvec2bitvec(x, b, d):
+    return _swigfaiss_avx2.fvec2bitvec(x, b, d)
+
+def bitvec_shuffle(n, da, db, order, a, b):
+    r""" Shuffle the bits from b(i, j) := a(i, order[j])"""
+    return _swigfaiss_avx2.bitvec_shuffle(n, da, db, order, a, b)
+class BitstringWriter(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code = property(_swigfaiss_avx2.BitstringWriter_code_get, _swigfaiss_avx2.BitstringWriter_code_set)
+    code_size = property(_swigfaiss_avx2.BitstringWriter_code_size_get, _swigfaiss_avx2.BitstringWriter_code_size_set)
+    i = property(_swigfaiss_avx2.BitstringWriter_i_get, _swigfaiss_avx2.BitstringWriter_i_set)
+
+    def __init__(self, code, code_size):
+        _swigfaiss_avx2.BitstringWriter_swiginit(self, _swigfaiss_avx2.new_BitstringWriter(code, code_size))
+
+    def write(self, x, nbit):
+        return _swigfaiss_avx2.BitstringWriter_write(self, x, nbit)
+    __swig_destroy__ = _swigfaiss_avx2.delete_BitstringWriter
+
+# Register BitstringWriter in _swigfaiss_avx2:
+_swigfaiss_avx2.BitstringWriter_swigregister(BitstringWriter)
+cvar = _swigfaiss_avx2.cvar
+
+class BitstringReader(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code = property(_swigfaiss_avx2.BitstringReader_code_get, _swigfaiss_avx2.BitstringReader_code_set)
+    code_size = property(_swigfaiss_avx2.BitstringReader_code_size_get, _swigfaiss_avx2.BitstringReader_code_size_set)
+    i = property(_swigfaiss_avx2.BitstringReader_i_get, _swigfaiss_avx2.BitstringReader_i_set)
+
+    def __init__(self, code, code_size):
+        _swigfaiss_avx2.BitstringReader_swiginit(self, _swigfaiss_avx2.new_BitstringReader(code, code_size))
+
+    def read(self, nbit):
+        return _swigfaiss_avx2.BitstringReader_read(self, nbit)
+    __swig_destroy__ = _swigfaiss_avx2.delete_BitstringReader
+
+# Register BitstringReader in _swigfaiss_avx2:
+_swigfaiss_avx2.BitstringReader_swigregister(BitstringReader)
+
+def hammings(a, b, na, nb, nbytespercode, dis):
+    r"""
+     Compute a set of Hamming distances between na and nb binary vectors
+
+    :type a: uint8_t
+    :param a:             size na * nbytespercode
+    :type b: uint8_t
+    :param b:             size nb * nbytespercode
+    :type nbytespercode: int
+    :param nbytespercode: should be multiple of 8
+    :type dis: int
+    :param dis:           output distances, size na * nb
+    """
+    return _swigfaiss_avx2.hammings(a, b, na, nb, nbytespercode, dis)
+
+def hammings_knn_hc(*args):
+    r"""
+     Return the k smallest Hamming distances for a set of binary query vectors,
+    using a max heap.
+    :type a: uint8_t
+    :param a:       queries, size ha->nh * ncodes
+    :type b: uint8_t
+    :param b:       database, size nb * ncodes
+    :type nb: int
+    :param nb:      number of database vectors
+    :type ncodes: int
+    :param ncodes:  size of the binary codes (bytes)
+    :type ordered: int
+    :param ordered: if != 0: order the results by decreasing distance
+                       (may be bottleneck for k/n > 0.01)
+    :type approx_topk_mode: int, optional
+    :param approx_topk_mode: allows to use approximate top-k facilities
+                                to speedup heap
+    """
+    return _swigfaiss_avx2.hammings_knn_hc(*args)
+
+def hammings_knn(ha, a, b, nb, ncodes, ordered):
+    return _swigfaiss_avx2.hammings_knn(ha, a, b, nb, ncodes, ordered)
+
+def hammings_knn_mc(a, b, na, nb, k, ncodes, distances, labels):
+    r"""
+     Return the k smallest Hamming distances for a set of binary query vectors,
+    using counting max.
+    :type a: uint8_t
+    :param a:       queries, size na * ncodes
+    :type b: uint8_t
+    :param b:       database, size nb * ncodes
+    :type na: int
+    :param na:      number of query vectors
+    :type nb: int
+    :param nb:      number of database vectors
+    :type k: int
+    :param k:       number of vectors/distances to return
+    :type ncodes: int
+    :param ncodes:  size of the binary codes (bytes)
+    :type distances: int
+    :param distances: output distances from each query vector to its k nearest
+                       neighbors
+    :type labels: int
+    :param labels:  output ids of the k nearest neighbors to each query vector
+    """
+    return _swigfaiss_avx2.hammings_knn_mc(a, b, na, nb, k, ncodes, distances, labels)
+
+def hamming_range_search(a, b, na, nb, radius, ncodes, result):
+    r""" same as hammings_knn except we are doing a range search with radius"""
+    return _swigfaiss_avx2.hamming_range_search(a, b, na, nb, radius, ncodes, result)
+
+def hamming_count_thres(bs1, bs2, n1, n2, ht, ncodes, nptr):
+    return _swigfaiss_avx2.hamming_count_thres(bs1, bs2, n1, n2, ht, ncodes, nptr)
+
+def match_hamming_thres(bs1, bs2, n1, n2, ht, ncodes, idx, dis):
+    return _swigfaiss_avx2.match_hamming_thres(bs1, bs2, n1, n2, ht, ncodes, idx, dis)
+
+def crosshamming_count_thres(dbs, n, ht, ncodes, nptr):
+    return _swigfaiss_avx2.crosshamming_count_thres(dbs, n, ht, ncodes, nptr)
+
+def generalized_hammings_knn_hc(ha, a, b, nb, code_size, ordered=True):
+    r"""
+    generalized Hamming distances (= count number of code bytes that
+       are the same)
+    """
+    return _swigfaiss_avx2.generalized_hammings_knn_hc(ha, a, b, nb, code_size, ordered)
+
+def pack_bitstrings(*args):
+    r"""
+    *Overload 1:*
+     Pack a set of n codes of size M * nbit
+
+    :type n: int
+    :param n:           number of codes to pack
+    :type M: int
+    :param M:           number of elementary codes per code
+    :type nbit: int
+    :param nbit:        number of bits per elementary code
+    :type unpacked: int
+    :param unpacked:    input unpacked codes, size (n, M)
+    :type packed: uint8_t
+    :param packed:      output packed codes, size (n, code_size)
+    :type code_size: int
+    :param code_size:   should be >= ceil(M * nbit / 8)
+
+    |
+
+    *Overload 2:*
+     Pack a set of n codes of variable sizes
+
+    :param nbit:       number of bits per entry (size M)
+    """
+    return _swigfaiss_avx2.pack_bitstrings(*args)
+
+def unpack_bitstrings(*args):
+    r"""
+    *Overload 1:*
+     Unpack a set of n codes of size M * nbit
+
+    :type n: int
+    :param n:           number of codes to pack
+    :type M: int
+    :param M:           number of elementary codes per code
+    :type nbit: int
+    :param nbit:        number of bits per elementary code
+    :type unpacked: int
+    :param unpacked:    input unpacked codes, size (n, M)
+    :type packed: uint8_t
+    :param packed:      output packed codes, size (n, code_size)
+    :type code_size: int
+    :param code_size:   should be >= ceil(M * nbit / 8)
+
+    |
+
+    *Overload 2:*
+     Unpack a set of n codes of variable sizes
+
+    :param nbit:       number of bits per entry (size M)
+    """
+    return _swigfaiss_avx2.unpack_bitstrings(*args)
+
+def popcount32(x):
+    return _swigfaiss_avx2.popcount32(x)
+
+def popcount64(x):
+    return _swigfaiss_avx2.popcount64(x)
+
+def get_num_gpus():
+    return _swigfaiss_avx2.get_num_gpus()
+
+def gpu_profiler_start():
+    return _swigfaiss_avx2.gpu_profiler_start()
+
+def gpu_profiler_stop():
+    return _swigfaiss_avx2.gpu_profiler_stop()
+
+def gpu_sync_all_devices():
+    return _swigfaiss_avx2.gpu_sync_all_devices()
+
+def get_compile_options():
+    r""" get compile options"""
+    return _swigfaiss_avx2.get_compile_options()
+
+def getmillisecs():
+    r""" ms elapsed since some arbitrary epoch"""
+    return _swigfaiss_avx2.getmillisecs()
+
+def get_mem_usage_kb():
+    r""" get current RSS usage in kB"""
+    return _swigfaiss_avx2.get_mem_usage_kb()
+
+def get_cycles():
+    return _swigfaiss_avx2.get_cycles()
+
+def reflection(u, x, n, d, nu):
+    return _swigfaiss_avx2.reflection(u, x, n, d, nu)
+
+def matrix_qr(m, n, a):
+    r"""
+     compute the Q of the QR decomposition for m > n
+    :type a: float
+    :param a:   size n * m: input matrix and output Q
+    """
+    return _swigfaiss_avx2.matrix_qr(m, n, a)
+
+def ranklist_handle_ties(k, idx, dis):
+    r""" distances are supposed to be sorted. Sorts indices with same distance"""
+    return _swigfaiss_avx2.ranklist_handle_ties(k, idx, dis)
+
+def ranklist_intersection_size(k1, v1, k2, v2):
+    r"""
+     count the number of common elements between v1 and v2
+    algorithm = sorting + bissection to avoid double-counting duplicates
+    """
+    return _swigfaiss_avx2.ranklist_intersection_size(k1, v1, k2, v2)
+
+def merge_result_table_with(n, k, I0, D0, I1, D1, keep_min=True, translation=0):
+    r"""
+     merge a result table into another one
+
+    :type I0: int
+    :param I0:, D0       first result table, size (n, k)
+    :type I1: int
+    :param I1:, D1       second result table, size (n, k)
+    :type keep_min: boolean, optional
+    :param keep_min:     if true, keep min values, otherwise keep max
+    :type translation: int, optional
+    :param translation:  add this value to all I1's indexes
+    :rtype: int
+    :return: nb of values that were taken from the second table
+    """
+    return _swigfaiss_avx2.merge_result_table_with(n, k, I0, D0, I1, D1, keep_min, translation)
+
+def imbalance_factor(*args):
+    r"""
+    *Overload 1:*
+    a balanced assignment has a IF of 1
+
+    |
+
+    *Overload 2:*
+    same, takes a histogram as input
+    """
+    return _swigfaiss_avx2.imbalance_factor(*args)
+
+def ivec_hist(n, v, vmax, hist):
+    r""" compute histogram on v"""
+    return _swigfaiss_avx2.ivec_hist(n, v, vmax, hist)
+
+def bincode_hist(n, nbits, codes, hist):
+    r"""
+     Compute histogram of bits on a code array
+
+    :type codes: uint8_t
+    :param codes:   size(n, nbits / 8)
+    :type hist: int
+    :param hist:    size(nbits): nb of 1s in the array of codes
+    """
+    return _swigfaiss_avx2.bincode_hist(n, nbits, codes, hist)
+
+def ivec_checksum(n, a):
+    r""" compute a checksum on a table."""
+    return _swigfaiss_avx2.ivec_checksum(n, a)
+
+def bvec_checksum(n, a):
+    r""" compute a checksum on a table."""
+    return _swigfaiss_avx2.bvec_checksum(n, a)
+
+def bvecs_checksum(n, d, a, cs):
+    r"""
+     compute checksums for the rows of a matrix
+
+    :type n: int
+    :param n:   number of rows
+    :type d: int
+    :param d:   size per row
+    :type a: uint8_t
+    :param a:   matrix to handle, size n * d
+    :type cs: int
+    :param cs:  output checksums, size n
+    """
+    return _swigfaiss_avx2.bvecs_checksum(n, d, a, cs)
+
+def fvecs_maybe_subsample(d, n, nmax, x, verbose=False, seed=1234):
+    r"""
+     random subsamples a set of vectors if there are too many of them
+
+    :type d: int
+    :param d:      dimension of the vectors
+    :type n: int
+    :param n:      on input: nb of input vectors, output: nb of output vectors
+    :type nmax: int
+    :param nmax:   max nb of vectors to keep
+    :type x: float
+    :param x:      input array, size *n-by-d
+    :type seed: int, optional
+    :param seed:   random seed to use for sampling
+    :rtype: float
+    :return: x or an array allocated with new [] with *n vectors
+    """
+    return _swigfaiss_avx2.fvecs_maybe_subsample(d, n, nmax, x, verbose, seed)
+
+def binary_to_real(d, x_in, x_out):
+    r"""
+     Convert binary vector to +1/-1 valued float vector.
+
+    :type d: int
+    :param d:      dimension of the vector (multiple of 8)
+    :type x_in: uint8_t
+    :param x_in:   input binary vector (uint8_t table of size d / 8)
+    :type x_out: float
+    :param x_out:  output float vector (float table of size d)
+    """
+    return _swigfaiss_avx2.binary_to_real(d, x_in, x_out)
+
+def real_to_binary(d, x_in, x_out):
+    r"""
+     Convert float vector to binary vector. Components > 0 are converted to 1,
+    others to 0.
+
+    :type d: int
+    :param d:      dimension of the vector (multiple of 8)
+    :type x_in: float
+    :param x_in:   input float vector (float table of size d)
+    :type x_out: uint8_t
+    :param x_out:  output binary vector (uint8_t table of size d / 8)
+    """
+    return _swigfaiss_avx2.real_to_binary(d, x_in, x_out)
+
+def hash_bytes(bytes, n):
+    r""" A reasonable hashing function"""
+    return _swigfaiss_avx2.hash_bytes(bytes, n)
+
+def check_openmp():
+    r""" Whether OpenMP annotations were respected."""
+    return _swigfaiss_avx2.check_openmp()
+class CodeSet(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    d = property(_swigfaiss_avx2.CodeSet_d_get, _swigfaiss_avx2.CodeSet_d_set)
+    s = property(_swigfaiss_avx2.CodeSet_s_get, _swigfaiss_avx2.CodeSet_s_set)
+
+    def __init__(self, d):
+        _swigfaiss_avx2.CodeSet_swiginit(self, _swigfaiss_avx2.new_CodeSet(d))
+
+    def insert(self, n, codes, inserted):
+        return _swigfaiss_avx2.CodeSet_insert(self, n, codes, inserted)
+    __swig_destroy__ = _swigfaiss_avx2.delete_CodeSet
+
+# Register CodeSet in _swigfaiss_avx2:
+_swigfaiss_avx2.CodeSet_swigregister(CodeSet)
+hamdis_tab_ham_bytes = cvar.hamdis_tab_ham_bytes
+
+class CombinerRangeKNNfloat(object):
+    r"""
+     This class is used to combine range and knn search results
+    in contrib.exhaustive_search.range_search_gpu
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss_avx2.CombinerRangeKNNfloat_nq_get, _swigfaiss_avx2.CombinerRangeKNNfloat_nq_set)
+    k = property(_swigfaiss_avx2.CombinerRangeKNNfloat_k_get, _swigfaiss_avx2.CombinerRangeKNNfloat_k_set, doc=r""" nb of queries""")
+    r2 = property(_swigfaiss_avx2.CombinerRangeKNNfloat_r2_get, _swigfaiss_avx2.CombinerRangeKNNfloat_r2_set, doc=r""" number of neighbors for the knn search part""")
+    keep_max = property(_swigfaiss_avx2.CombinerRangeKNNfloat_keep_max_get, _swigfaiss_avx2.CombinerRangeKNNfloat_keep_max_set, doc=r""" range search radius""")
+
+    def __init__(self, nq, k, r2, keep_max):
+        r""" whether to keep max values instead of min."""
+        _swigfaiss_avx2.CombinerRangeKNNfloat_swiginit(self, _swigfaiss_avx2.new_CombinerRangeKNNfloat(nq, k, r2, keep_max))
+    I = property(_swigfaiss_avx2.CombinerRangeKNNfloat_I_get, _swigfaiss_avx2.CombinerRangeKNNfloat_I_set, doc=r""" Knn search results""")
+    D = property(_swigfaiss_avx2.CombinerRangeKNNfloat_D_get, _swigfaiss_avx2.CombinerRangeKNNfloat_D_set, doc=r""" size nq * k""")
+    mask = property(_swigfaiss_avx2.CombinerRangeKNNfloat_mask_get, _swigfaiss_avx2.CombinerRangeKNNfloat_mask_set, doc=r"""
+    size nq * k
+    optional: range search results (ignored if mask is NULL)
+    """)
+    lim_remain = property(_swigfaiss_avx2.CombinerRangeKNNfloat_lim_remain_get, _swigfaiss_avx2.CombinerRangeKNNfloat_lim_remain_set, doc=r""" mask for where knn results are valid, size nq""")
+    D_remain = property(_swigfaiss_avx2.CombinerRangeKNNfloat_D_remain_get, _swigfaiss_avx2.CombinerRangeKNNfloat_D_remain_set, doc=r""" size nrange + 1""")
+    I_remain = property(_swigfaiss_avx2.CombinerRangeKNNfloat_I_remain_get, _swigfaiss_avx2.CombinerRangeKNNfloat_I_remain_set, doc=r""" size lim_remain[nrange]""")
+    L_res = property(_swigfaiss_avx2.CombinerRangeKNNfloat_L_res_get, _swigfaiss_avx2.CombinerRangeKNNfloat_L_res_set, doc=r""" size lim_remain[nrange]""")
+
+    def compute_sizes(self, L_res):
+        r""" size nq + 1"""
+        return _swigfaiss_avx2.CombinerRangeKNNfloat_compute_sizes(self, L_res)
+
+    def write_result(self, D_res, I_res):
+        r"""
+        Phase 2: caller allocates D_res and I_res (size L_res[nq])
+        Phase 3: fill in D_res and I_res
+        """
+        return _swigfaiss_avx2.CombinerRangeKNNfloat_write_result(self, D_res, I_res)
+    __swig_destroy__ = _swigfaiss_avx2.delete_CombinerRangeKNNfloat
+
+# Register CombinerRangeKNNfloat in _swigfaiss_avx2:
+_swigfaiss_avx2.CombinerRangeKNNfloat_swigregister(CombinerRangeKNNfloat)
+class CombinerRangeKNNint16(object):
+    r"""
+     This class is used to combine range and knn search results
+    in contrib.exhaustive_search.range_search_gpu
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss_avx2.CombinerRangeKNNint16_nq_get, _swigfaiss_avx2.CombinerRangeKNNint16_nq_set)
+    k = property(_swigfaiss_avx2.CombinerRangeKNNint16_k_get, _swigfaiss_avx2.CombinerRangeKNNint16_k_set, doc=r""" nb of queries""")
+    r2 = property(_swigfaiss_avx2.CombinerRangeKNNint16_r2_get, _swigfaiss_avx2.CombinerRangeKNNint16_r2_set, doc=r""" number of neighbors for the knn search part""")
+    keep_max = property(_swigfaiss_avx2.CombinerRangeKNNint16_keep_max_get, _swigfaiss_avx2.CombinerRangeKNNint16_keep_max_set, doc=r""" range search radius""")
+
+    def __init__(self, nq, k, r2, keep_max):
+        r""" whether to keep max values instead of min."""
+        _swigfaiss_avx2.CombinerRangeKNNint16_swiginit(self, _swigfaiss_avx2.new_CombinerRangeKNNint16(nq, k, r2, keep_max))
+    I = property(_swigfaiss_avx2.CombinerRangeKNNint16_I_get, _swigfaiss_avx2.CombinerRangeKNNint16_I_set, doc=r""" Knn search results""")
+    D = property(_swigfaiss_avx2.CombinerRangeKNNint16_D_get, _swigfaiss_avx2.CombinerRangeKNNint16_D_set, doc=r""" size nq * k""")
+    mask = property(_swigfaiss_avx2.CombinerRangeKNNint16_mask_get, _swigfaiss_avx2.CombinerRangeKNNint16_mask_set, doc=r"""
+    size nq * k
+    optional: range search results (ignored if mask is NULL)
+    """)
+    lim_remain = property(_swigfaiss_avx2.CombinerRangeKNNint16_lim_remain_get, _swigfaiss_avx2.CombinerRangeKNNint16_lim_remain_set, doc=r""" mask for where knn results are valid, size nq""")
+    D_remain = property(_swigfaiss_avx2.CombinerRangeKNNint16_D_remain_get, _swigfaiss_avx2.CombinerRangeKNNint16_D_remain_set, doc=r""" size nrange + 1""")
+    I_remain = property(_swigfaiss_avx2.CombinerRangeKNNint16_I_remain_get, _swigfaiss_avx2.CombinerRangeKNNint16_I_remain_set, doc=r""" size lim_remain[nrange]""")
+    L_res = property(_swigfaiss_avx2.CombinerRangeKNNint16_L_res_get, _swigfaiss_avx2.CombinerRangeKNNint16_L_res_set, doc=r""" size lim_remain[nrange]""")
+
+    def compute_sizes(self, L_res):
+        r""" size nq + 1"""
+        return _swigfaiss_avx2.CombinerRangeKNNint16_compute_sizes(self, L_res)
+
+    def write_result(self, D_res, I_res):
+        r"""
+        Phase 2: caller allocates D_res and I_res (size L_res[nq])
+        Phase 3: fill in D_res and I_res
+        """
+        return _swigfaiss_avx2.CombinerRangeKNNint16_write_result(self, D_res, I_res)
+    __swig_destroy__ = _swigfaiss_avx2.delete_CombinerRangeKNNint16
+
+# Register CombinerRangeKNNint16 in _swigfaiss_avx2:
+_swigfaiss_avx2.CombinerRangeKNNint16_swigregister(CombinerRangeKNNint16)
+
+def fvec_L2sqr(x, y, d):
+    r""" Squared L2 distance between two vectors"""
+    return _swigfaiss_avx2.fvec_L2sqr(x, y, d)
+
+def fvec_inner_product(x, y, d):
+    r""" inner product"""
+    return _swigfaiss_avx2.fvec_inner_product(x, y, d)
+
+def fvec_L1(x, y, d):
+    r""" L1 distance"""
+    return _swigfaiss_avx2.fvec_L1(x, y, d)
+
+def fvec_Linf(x, y, d):
+    r""" infinity distance"""
+    return _swigfaiss_avx2.fvec_Linf(x, y, d)
+
+def fvec_inner_product_batch_4(x, y0, y1, y2, y3, d, dis0, dis1, dis2, dis3):
+    r"""
+    Special version of inner product that computes 4 distances
+    between x and yi, which is performance oriented.
+    """
+    return _swigfaiss_avx2.fvec_inner_product_batch_4(x, y0, y1, y2, y3, d, dis0, dis1, dis2, dis3)
+
+def fvec_L2sqr_batch_4(x, y0, y1, y2, y3, d, dis0, dis1, dis2, dis3):
+    r"""
+    Special version of L2sqr that computes 4 distances
+    between x and yi, which is performance oriented.
+    """
+    return _swigfaiss_avx2.fvec_L2sqr_batch_4(x, y0, y1, y2, y3, d, dis0, dis1, dis2, dis3)
+
+def pairwise_L2sqr(d, nq, xq, nb, xb, dis, ldq=-1, ldb=-1, ldd=-1):
+    r"""
+     Compute pairwise distances between sets of vectors
+
+    :type d: int
+    :param d:     dimension of the vectors
+    :type nq: int
+    :param nq:    nb of query vectors
+    :type nb: int
+    :param nb:    nb of database vectors
+    :type xq: float
+    :param xq:    query vectors (size nq * d)
+    :type xb: float
+    :param xb:    database vectors (size nb * d)
+    :type dis: float
+    :param dis:   output distances (size nq * nb)
+    :param ldq,ldb:, ldd strides for the matrices
+    """
+    return _swigfaiss_avx2.pairwise_L2sqr(d, nq, xq, nb, xb, dis, ldq, ldb, ldd)
+
+def fvec_inner_products_ny(ip, x, y, d, ny):
+    return _swigfaiss_avx2.fvec_inner_products_ny(ip, x, y, d, ny)
+
+def fvec_L2sqr_ny(dis, x, y, d, ny):
+    return _swigfaiss_avx2.fvec_L2sqr_ny(dis, x, y, d, ny)
+
+def fvec_L2sqr_ny_transposed(dis, x, y, y_sqlen, d, d_offset, ny):
+    return _swigfaiss_avx2.fvec_L2sqr_ny_transposed(dis, x, y, y_sqlen, d, d_offset, ny)
+
+def fvec_L2sqr_ny_nearest(distances_tmp_buffer, x, y, d, ny):
+    return _swigfaiss_avx2.fvec_L2sqr_ny_nearest(distances_tmp_buffer, x, y, d, ny)
+
+def fvec_L2sqr_ny_nearest_y_transposed(distances_tmp_buffer, x, y, y_sqlen, d, d_offset, ny):
+    return _swigfaiss_avx2.fvec_L2sqr_ny_nearest_y_transposed(distances_tmp_buffer, x, y, y_sqlen, d, d_offset, ny)
+
+def fvec_norm_L2sqr(x, d):
+    r""" squared norm of a vector"""
+    return _swigfaiss_avx2.fvec_norm_L2sqr(x, d)
+
+def fvec_norms_L2(norms, x, d, nx):
+    r"""
+     compute the L2 norms for a set of vectors
+
+    :type norms: float
+    :param norms:    output norms, size nx
+    :type x: float
+    :param x:        set of vectors, size nx * d
+    """
+    return _swigfaiss_avx2.fvec_norms_L2(norms, x, d, nx)
+
+def fvec_norms_L2sqr(norms, x, d, nx):
+    r""" same as fvec_norms_L2, but computes squared norms"""
+    return _swigfaiss_avx2.fvec_norms_L2sqr(norms, x, d, nx)
+
+def fvec_renorm_L2(d, nx, x):
+    return _swigfaiss_avx2.fvec_renorm_L2(d, nx, x)
+
+def inner_product_to_L2sqr(dis, nr1, nr2, n1, n2):
+    return _swigfaiss_avx2.inner_product_to_L2sqr(dis, nr1, nr2, n1, n2)
+
+def fvec_add(*args):
+    r"""
+    *Overload 1:*
+     compute c := a + b for vectors
+
+    c and a can overlap, c and b can overlap
+
+    :type a: float
+    :param a: size d
+    :type b: float
+    :param b: size d
+    :type c: float
+    :param c: size d
+
+    |
+
+    *Overload 2:*
+     compute c := a + b for a, c vectors and b a scalar
+
+    c and a can overlap
+
+    :type a: float
+    :param a: size d
+    :type c: float
+    :param c: size d
+    """
+    return _swigfaiss_avx2.fvec_add(*args)
+
+def fvec_sub(d, a, b, c):
+    r"""
+     compute c := a - b for vectors
+
+    c and a can overlap, c and b can overlap
+
+    :type a: float
+    :param a: size d
+    :type b: float
+    :param b: size d
+    :type c: float
+    :param c: size d
+    """
+    return _swigfaiss_avx2.fvec_sub(d, a, b, c)
+
+def fvec_inner_products_by_idx(ip, x, y, ids, d, nx, ny):
+    r"""
+     compute the inner product between x and a subset y of ny vectors defined by
+    ids
+
+    ip(i, j) = inner_product(x(i, :), y(ids(i, j), :))
+
+    :type ip: float
+    :param ip:    output array, size nx * ny
+    :type x: float
+    :param x:     first-term vector, size nx * d
+    :type y: float
+    :param y:     second-term vector, size (max(ids) + 1) * d
+    :type ids: int
+    :param ids:   ids to sample from y, size nx * ny
+    """
+    return _swigfaiss_avx2.fvec_inner_products_by_idx(ip, x, y, ids, d, nx, ny)
+
+def fvec_L2sqr_by_idx(dis, x, y, ids, d, nx, ny):
+    r"""
+     compute the squared L2 distances between x and a subset y of ny vectors
+    defined by ids
+
+    dis(i, j) = inner_product(x(i, :), y(ids(i, j), :))
+
+    :type dis: float
+    :param dis:   output array, size nx * ny
+    :type x: float
+    :param x:     first-term vector, size nx * d
+    :type y: float
+    :param y:     second-term vector, size (max(ids) + 1) * d
+    :type ids: int
+    :param ids:   ids to sample from y, size nx * ny
+    """
+    return _swigfaiss_avx2.fvec_L2sqr_by_idx(dis, x, y, ids, d, nx, ny)
+
+def pairwise_indexed_L2sqr(d, n, x, ix, y, iy, dis):
+    r"""
+     compute dis[j] = L2sqr(x[ix[j]], y[iy[j]]) forall j=0..n-1
+
+    :type x: float
+    :param x:  size (max(ix) + 1, d)
+    :type y: float
+    :param y:  size (max(iy) + 1, d)
+    :type ix: int
+    :param ix: size n
+    :type iy: int
+    :param iy: size n
+    :type dis: float
+    :param dis: size n
+    """
+    return _swigfaiss_avx2.pairwise_indexed_L2sqr(d, n, x, ix, y, iy, dis)
+
+def pairwise_indexed_inner_product(d, n, x, ix, y, iy, dis):
+    r"""
+     compute dis[j] = inner_product(x[ix[j]], y[iy[j]]) forall j=0..n-1
+
+    :type x: float
+    :param x:  size (max(ix) + 1, d)
+    :type y: float
+    :param y:  size (max(iy) + 1, d)
+    :type ix: int
+    :param ix: size n
+    :type iy: int
+    :param iy: size n
+    :type dis: float
+    :param dis: size n
+    """
+    return _swigfaiss_avx2.pairwise_indexed_inner_product(d, n, x, ix, y, iy, dis)
+
+def knn_inner_product(*args):
+    r"""
+    *Overload 1:*
+     Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, w.r.t to max inner product.
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type res: :py:class:`float_minheap_array_t`
+    :param res:  result heap structure, which also provides k. Sorted on output
+
+    |
+
+    *Overload 2:*
+      Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, for the inner product metric.
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type distances: float
+    :param distances:  output distances, size nq * k
+    :type indexes: int
+    :param indexes:    output vector ids, size nq * k
+
+    |
+
+    *Overload 3:*
+      Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, for the inner product metric.
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type distances: float
+    :param distances:  output distances, size nq * k
+    :type indexes: int
+    :param indexes:    output vector ids, size nq * k
+    """
+    return _swigfaiss_avx2.knn_inner_product(*args)
+
+def knn_L2sqr(*args):
+    r"""
+    *Overload 1:*
+     Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, for the L2 distance
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type res: :py:class:`float_maxheap_array_t`
+    :param res:  result heap strcture, which also provides k. Sorted on output
+    :type y_norm2: float, optional
+    :param y_norm2:    (optional) norms for the y vectors (nullptr or size ny)
+    :type sel: :py:class:`IDSelector`, optional
+    :param sel:  search in this subset of vectors
+
+    |
+
+    *Overload 2:*
+      Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, for the L2 distance
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type distances: float
+    :param distances:  output distances, size nq * k
+    :type indexes: int
+    :param indexes:    output vector ids, size nq * k
+    :type y_norm2: float, optional
+    :param y_norm2:    (optional) norms for the y vectors (nullptr or size ny)
+    :type sel: :py:class:`IDSelector`, optional
+    :param sel:  search in this subset of vectors
+
+    |
+
+    *Overload 3:*
+      Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, for the L2 distance
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type distances: float
+    :param distances:  output distances, size nq * k
+    :type indexes: int
+    :param indexes:    output vector ids, size nq * k
+    :type y_norm2: float, optional
+    :param y_norm2:    (optional) norms for the y vectors (nullptr or size ny)
+    :param sel:  search in this subset of vectors
+
+    |
+
+    *Overload 4:*
+      Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, for the L2 distance
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size ny * d
+    :type distances: float
+    :param distances:  output distances, size nq * k
+    :type indexes: int
+    :param indexes:    output vector ids, size nq * k
+    :param y_norm2:    (optional) norms for the y vectors (nullptr or size ny)
+    :param sel:  search in this subset of vectors
+    """
+    return _swigfaiss_avx2.knn_L2sqr(*args)
+
+def knn_inner_products_by_idx(x, y, subset, d, nx, ny, nsubset, k, vals, ids, ld_ids=-1):
+    r"""
+     Find the max inner product neighbors for nx queries in a set of ny vectors
+    indexed by ids. May be useful for re-ranking a pre-selected vector list
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size (max(ids) + 1) * d
+    :type ids: int
+    :param ids:  subset of database vectors to consider, size (nx, nsubset)
+    :param res:  result structure
+    :type ld_ids: int, optional
+    :param ld_ids: stride for the ids array. -1: use nsubset, 0: all queries
+        process the same subset
+    """
+    return _swigfaiss_avx2.knn_inner_products_by_idx(x, y, subset, d, nx, ny, nsubset, k, vals, ids, ld_ids)
+
+def knn_L2sqr_by_idx(x, y, subset, d, nx, ny, nsubset, k, vals, ids, ld_subset=-1):
+    r"""
+     Find the nearest neighbors for nx queries in a set of ny vectors
+    indexed by ids. May be useful for re-ranking a pre-selected vector list
+
+    :type x: float
+    :param x:    query vectors, size nx * d
+    :type y: float
+    :param y:    database vectors, size (max(ids) + 1) * d
+    :type subset: int
+    :param subset: subset of database vectors to consider, size (nx, nsubset)
+    :param res:  rIDesult structure
+    :type ld_subset: int, optional
+    :param ld_subset: stride for the subset array. -1: use nsubset, 0: all queries
+        process the same subset
+    """
+    return _swigfaiss_avx2.knn_L2sqr_by_idx(x, y, subset, d, nx, ny, nsubset, k, vals, ids, ld_subset)
+
+def range_search_L2sqr(x, y, d, nx, ny, radius, result, sel=None):
+    r"""
+     Return the k nearest neighors of each of the nx vectors x among the ny
+     vector y, w.r.t to max inner product
+
+    :type x: float
+    :param x:      query vectors, size nx * d
+    :type y: float
+    :param y:      database vectors, size ny * d
+    :type radius: float
+    :param radius: search radius around the x vectors
+    :type result: :py:class:`RangeSearchResult`
+    :param result: result structure
+    """
+    return _swigfaiss_avx2.range_search_L2sqr(x, y, d, nx, ny, radius, result, sel)
+
+def range_search_inner_product(x, y, d, nx, ny, radius, result, sel=None):
+    r""" same as range_search_L2sqr for the inner product similarity"""
+    return _swigfaiss_avx2.range_search_inner_product(x, y, d, nx, ny, radius, result, sel)
+
+def compute_PQ_dis_tables_dsub2(d, ksub, centroids, nx, x, is_inner_product, dis_tables):
+    r""" specialized function for PQ2"""
+    return _swigfaiss_avx2.compute_PQ_dis_tables_dsub2(d, ksub, centroids, nx, x, is_inner_product, dis_tables)
+
+def fvec_madd(n, a, bf, b, c):
+    r"""
+     compute c := a + bf * b for a, b and c tables
+
+    :type n: int
+    :param n:   size of the tables
+    :type a: float
+    :param a:   size n
+    :type b: float
+    :param b:   size n
+    :type c: float
+    :param c:   restult table, size n
+    """
+    return _swigfaiss_avx2.fvec_madd(n, a, bf, b, c)
+
+def fvec_madd_and_argmin(n, a, bf, b, c):
+    r"""
+     same as fvec_madd, also return index of the min of the result table
+    :rtype: int
+    :return: index of the min of table c
+    """
+    return _swigfaiss_avx2.fvec_madd_and_argmin(n, a, bf, b, c)
+class RandomGenerator(object):
+    r""" random generator that can be used in multithreaded contexts"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    mt = property(_swigfaiss_avx2.RandomGenerator_mt_get, _swigfaiss_avx2.RandomGenerator_mt_set)
+
+    def rand_int64(self):
+        r""" random int64_t"""
+        return _swigfaiss_avx2.RandomGenerator_rand_int64(self)
+
+    def rand_int(self, *args):
+        r"""
+        *Overload 1:*
+        random positive integer
+
+        |
+
+        *Overload 2:*
+        generate random integer between 0 and max-1
+        """
+        return _swigfaiss_avx2.RandomGenerator_rand_int(self, *args)
+
+    def rand_float(self):
+        r""" between 0 and 1"""
+        return _swigfaiss_avx2.RandomGenerator_rand_float(self)
+
+    def rand_double(self):
+        return _swigfaiss_avx2.RandomGenerator_rand_double(self)
+
+    def __init__(self, seed=1234):
+        _swigfaiss_avx2.RandomGenerator_swiginit(self, _swigfaiss_avx2.new_RandomGenerator(seed))
+    __swig_destroy__ = _swigfaiss_avx2.delete_RandomGenerator
+
+# Register RandomGenerator in _swigfaiss_avx2:
+_swigfaiss_avx2.RandomGenerator_swigregister(RandomGenerator)
+
+def float_rand(x, n, seed):
+    return _swigfaiss_avx2.float_rand(x, n, seed)
+
+def float_randn(x, n, seed):
+    return _swigfaiss_avx2.float_randn(x, n, seed)
+
+def int64_rand(x, n, seed):
+    return _swigfaiss_avx2.int64_rand(x, n, seed)
+
+def byte_rand(x, n, seed):
+    return _swigfaiss_avx2.byte_rand(x, n, seed)
+
+def int64_rand_max(x, n, max, seed):
+    return _swigfaiss_avx2.int64_rand_max(x, n, max, seed)
+
+def rand_perm(perm, n, seed):
+    return _swigfaiss_avx2.rand_perm(perm, n, seed)
+
+def rand_smooth_vectors(n, d, x, seed):
+    return _swigfaiss_avx2.rand_smooth_vectors(n, d, x, seed)
+
+def fvec_argsort(n, vals, perm):
+    r"""
+     Indirect sort of a floating-point array
+
+    :type n: int
+    :param n:     size of the array
+    :type vals: float
+    :param vals:  array to sort, size n
+    :type perm: int
+    :param perm:  output: permutation of [0..n-1], st.
+                     vals[perm[i + 1]] >= vals[perm[i]]
+    """
+    return _swigfaiss_avx2.fvec_argsort(n, vals, perm)
+
+def fvec_argsort_parallel(n, vals, perm):
+    r""" Same as fvec_argsort, parallelized"""
+    return _swigfaiss_avx2.fvec_argsort_parallel(n, vals, perm)
+
+def bucket_sort(nval, vals, nbucket, lims, perm, nt=0):
+    r"""
+     Bucket sort of a list of values
+
+    :type vals: int
+    :param vals:     values to sort, size nval, max value nbucket - 1
+    :type lims: int
+    :param lims:     output limits of buckets, size nbucket + 1
+    :type perm: int
+    :param perm:     output buckets, the elements of bucket
+                        i are in perm[lims[i]:lims[i + 1]]
+    :type nt: int, optional
+    :param nt:       number of threads (0 = pure sequential code)
+    """
+    return _swigfaiss_avx2.bucket_sort(nval, vals, nbucket, lims, perm, nt)
+
+def matrix_bucket_sort_inplace(*args):
+    r"""
+    *Overload 1:*
+     in-place bucket sort (with attention to memory=>int32)
+    on input the values are in a nrow * col matrix
+    we want to store the row numbers in the output.
+
+    :type vals: int
+    :param vals:     positive values to sort, size nrow * ncol,
+                        max value nbucket - 1
+    :type lims: int
+    :param lims:     output limits of buckets, size nbucket + 1
+    :type nt: int, optional
+    :param nt:       number of threads (0 = pure sequential code)
+
+    |
+
+    *Overload 2:*
+     same with int64 elements
+
+    |
+
+    *Overload 3:*
+     same with int64 elements
+    """
+    return _swigfaiss_avx2.matrix_bucket_sort_inplace(*args)
+
+def hashtable_int64_to_int64_init(log2_capacity, tab):
+    r"""
+     Hashtable implementation for int64 -> int64 with external storage
+    implemented for fast batch add and lookup.
+
+    tab is of size  2 * (1 << log2_capacity)
+    n is the number of elements to add or search
+
+    adding several values in a same batch: an arbitrary one gets added
+    in different batches: the newer batch overwrites.
+    raises an exception if capacity is exhausted.
+    """
+    return _swigfaiss_avx2.hashtable_int64_to_int64_init(log2_capacity, tab)
+
+def hashtable_int64_to_int64_add(log2_capacity, tab, n, keys, vals):
+    return _swigfaiss_avx2.hashtable_int64_to_int64_add(log2_capacity, tab, n, keys, vals)
+
+def hashtable_int64_to_int64_lookup(log2_capacity, tab, n, keys, vals):
+    return _swigfaiss_avx2.hashtable_int64_to_int64_lookup(log2_capacity, tab, n, keys, vals)
+METRIC_INNER_PRODUCT = _swigfaiss_avx2.METRIC_INNER_PRODUCT
+r""" maximum inner product search"""
+METRIC_L2 = _swigfaiss_avx2.METRIC_L2
+r""" squared L2 search"""
+METRIC_L1 = _swigfaiss_avx2.METRIC_L1
+r""" L1 (aka cityblock)"""
+METRIC_Linf = _swigfaiss_avx2.METRIC_Linf
+r""" infinity distance"""
+METRIC_Lp = _swigfaiss_avx2.METRIC_Lp
+r""" L_p distance, p is given by a faiss::Index"""
+METRIC_Canberra = _swigfaiss_avx2.METRIC_Canberra
+r"""
+    metric_arg
+    some additional metrics defined in scipy.spatial.distance
+    """
+METRIC_BrayCurtis = _swigfaiss_avx2.METRIC_BrayCurtis
+METRIC_JensenShannon = _swigfaiss_avx2.METRIC_JensenShannon
+METRIC_Jaccard = _swigfaiss_avx2.METRIC_Jaccard
+r"""
+    defined as: sum_i(min(a_i, b_i)) / sum_i(max(a_i, b_i))
+    where a_i, b_i > 0
+    """
+
+def is_similarity_metric(metric_type):
+    r"""
+    this function is used to distinguish between min and max indexes since
+    we need to support similarity and dis-similarity metrics in a flexible way
+    """
+    return _swigfaiss_avx2.is_similarity_metric(metric_type)
+FAISS_VERSION_MAJOR = _swigfaiss_avx2.FAISS_VERSION_MAJOR
+r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+FAISS_VERSION_MINOR = _swigfaiss_avx2.FAISS_VERSION_MINOR
+FAISS_VERSION_PATCH = _swigfaiss_avx2.FAISS_VERSION_PATCH
+class SearchParameters(object):
+    r"""
+     Parent class for the optional search paramenters.
+
+    Sub-classes with additional search parameters should inherit this class.
+    Ownership of the object fields is always to the caller.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    sel = property(_swigfaiss_avx2.SearchParameters_sel_get, _swigfaiss_avx2.SearchParameters_sel_set, doc=r""" if non-null, only these IDs will be considered during search.""")
+    __swig_destroy__ = _swigfaiss_avx2.delete_SearchParameters
+
+    def __init__(self):
+        _swigfaiss_avx2.SearchParameters_swiginit(self, _swigfaiss_avx2.new_SearchParameters())
+
+# Register SearchParameters in _swigfaiss_avx2:
+_swigfaiss_avx2.SearchParameters_swigregister(SearchParameters)
+class Index(object):
+    r"""
+     Abstract structure for an index, supports adding vectors and searching them.
+
+    All vectors provided at add or search time are 32-bit float arrays,
+    although the internal representation may vary.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    d = property(_swigfaiss_avx2.Index_d_get, _swigfaiss_avx2.Index_d_set, doc=r""" vector dimension""")
+    ntotal = property(_swigfaiss_avx2.Index_ntotal_get, _swigfaiss_avx2.Index_ntotal_set, doc=r""" total nb of indexed vectors""")
+    verbose = property(_swigfaiss_avx2.Index_verbose_get, _swigfaiss_avx2.Index_verbose_set, doc=r""" verbosity level""")
+    is_trained = property(_swigfaiss_avx2.Index_is_trained_get, _swigfaiss_avx2.Index_is_trained_set, doc=r"""
+    set if the Index does not require training, or if training is
+    done already
+    """)
+    metric_type = property(_swigfaiss_avx2.Index_metric_type_get, _swigfaiss_avx2.Index_metric_type_set, doc=r""" type of metric this index uses for search""")
+    metric_arg = property(_swigfaiss_avx2.Index_metric_arg_get, _swigfaiss_avx2.Index_metric_arg_set, doc=r""" argument of the metric type""")
+    __swig_destroy__ = _swigfaiss_avx2.delete_Index
+
+    def train(self, n, x):
+        r"""
+         Perform training on a representative set of vectors
+
+        :type n: int
+        :param n:      nb of training vectors
+        :type x: float
+        :param x:      training vecors, size n * d
+        """
+        return _swigfaiss_avx2.Index_train(self, n, x)
+
+    def add(self, n, x):
+        r"""
+         Add n vectors of dimension d to the index.
+
+        Vectors are implicitly assigned labels ntotal .. ntotal + n - 1
+        This function slices the input vectors in chunks smaller than
+        blocksize_add and calls add_core.
+        :type n: int
+        :param n:      number of vectors
+        :type x: float
+        :param x:      input matrix, size n * d
+        """
+        return _swigfaiss_avx2.Index_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        r"""
+         Same as add, but stores xids instead of sequential ids.
+
+        The default implementation fails with an assertion, as it is
+        not supported by all indexes.
+
+        :type n: int
+        :param n:         number of vectors
+        :type x: float
+        :param x:         input vectors, size n * d
+        :type xids: int
+        :param xids:      if non-null, ids to store for the vectors (size n)
+        """
+        return _swigfaiss_avx2.Index_add_with_ids(self, n, x, xids)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r"""
+         query n vectors of dimension d to the index.
+
+        return at most k vectors. If there are not enough results for a
+        query, the result array is padded with -1s.
+
+        :type n: int
+        :param n:           number of vectors
+        :type x: float
+        :param x:           input vectors to search, size n * d
+        :type k: int
+        :param k:           number of extracted vectors
+        :type distances: float
+        :param distances:   output pairwise distances, size n*k
+        :type labels: int
+        :param labels:      output labels of the NNs, size n*k
+        """
+        return _swigfaiss_avx2.Index_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        r"""
+         query n vectors of dimension d to the index.
+
+        return all vectors with distance < radius. Note that many
+        indexes do not implement the range_search (only the k-NN search
+        is mandatory).
+
+        :type n: int
+        :param n:           number of vectors
+        :type x: float
+        :param x:           input vectors to search, size n * d
+        :type radius: float
+        :param radius:      search radius
+        :type result: :py:class:`RangeSearchResult`
+        :param result:      result table
+        """
+        return _swigfaiss_avx2.Index_range_search(self, n, x, radius, result, params)
+
+    def assign(self, n, x, labels, k=1):
+        r"""
+         return the indexes of the k vectors closest to the query x.
+
+        This function is identical as search but only return labels of neighbors.
+        :type n: int
+        :param n:           number of vectors
+        :type x: float
+        :param x:           input vectors to search, size n * d
+        :type labels: int
+        :param labels:      output labels of the NNs, size n*k
+        :type k: int, optional
+        :param k:           number of nearest neighbours
+        """
+        return _swigfaiss_avx2.Index_assign(self, n, x, labels, k)
+
+    def reset(self):
+        r""" removes all elements from the database."""
+        return _swigfaiss_avx2.Index_reset(self)
+
+    def remove_ids(self, sel):
+        r"""
+         removes IDs from the index. Not supported by all
+        indexes. Returns the number of elements removed.
+        """
+        return _swigfaiss_avx2.Index_remove_ids(self, sel)
+
+    def reconstruct(self, key, recons):
+        r"""
+         Reconstruct a stored vector (or an approximation if lossy coding)
+
+        this function may not be defined for some indexes
+        :type key: int
+        :param key:         id of the vector to reconstruct
+        :type recons: float
+        :param recons:      reconstucted vector (size d)
+        """
+        return _swigfaiss_avx2.Index_reconstruct(self, key, recons)
+
+    def reconstruct_batch(self, n, keys, recons):
+        r"""
+         Reconstruct several stored vectors (or an approximation if lossy coding)
+
+        this function may not be defined for some indexes
+        :type n: int
+        :param n:           number of vectors to reconstruct
+        :type keys: int
+        :param keys:        ids of the vectors to reconstruct (size n)
+        :type recons: float
+        :param recons:      reconstucted vector (size n * d)
+        """
+        return _swigfaiss_avx2.Index_reconstruct_batch(self, n, keys, recons)
+
+    def reconstruct_n(self, i0, ni, recons):
+        r"""
+         Reconstruct vectors i0 to i0 + ni - 1
+
+        this function may not be defined for some indexes
+        :type i0: int
+        :param i0:          index of the first vector in the sequence
+        :type ni: int
+        :param ni:          number of vectors in the sequence
+        :type recons: float
+        :param recons:      reconstucted vector (size ni * d)
+        """
+        return _swigfaiss_avx2.Index_reconstruct_n(self, i0, ni, recons)
+
+    def search_and_reconstruct(self, n, x, k, distances, labels, recons, params=None):
+        r"""
+         Similar to search, but also reconstructs the stored vectors (or an
+        approximation in the case of lossy coding) for the search results.
+
+        If there are not enough results for a query, the resulting arrays
+        is padded with -1s.
+
+        :type n: int
+        :param n:           number of vectors
+        :type x: float
+        :param x:           input vectors to search, size n * d
+        :type k: int
+        :param k:           number of extracted vectors
+        :type distances: float
+        :param distances:   output pairwise distances, size n*k
+        :type labels: int
+        :param labels:      output labels of the NNs, size n*k
+        :type recons: float
+        :param recons:      reconstructed vectors size (n, k, d)
+        """
+        return _swigfaiss_avx2.Index_search_and_reconstruct(self, n, x, k, distances, labels, recons, params)
+
+    def compute_residual(self, x, residual, key):
+        r"""
+         Computes a residual vector after indexing encoding.
+
+        The residual vector is the difference between a vector and the
+        reconstruction that can be decoded from its representation in
+        the index. The residual can be used for multiple-stage indexing
+        methods, like IndexIVF's methods.
+
+        :type x: float
+        :param x:           input vector, size d
+        :type residual: float
+        :param residual:    output residual vector, size d
+        :type key: int
+        :param key:         encoded index, as returned by search and assign
+        """
+        return _swigfaiss_avx2.Index_compute_residual(self, x, residual, key)
+
+    def compute_residual_n(self, n, xs, residuals, keys):
+        r"""
+         Computes a residual vector after indexing encoding (batch form).
+        Equivalent to calling compute_residual for each vector.
+
+        The residual vector is the difference between a vector and the
+        reconstruction that can be decoded from its representation in
+        the index. The residual can be used for multiple-stage indexing
+        methods, like IndexIVF's methods.
+
+        :type n: int
+        :param n:           number of vectors
+        :type xs: float
+        :param xs:          input vectors, size (n x d)
+        :type residuals: float
+        :param residuals:   output residual vectors, size (n x d)
+        :type keys: int
+        :param keys:        encoded index, as returned by search and assign
+        """
+        return _swigfaiss_avx2.Index_compute_residual_n(self, n, xs, residuals, keys)
+
+    def get_distance_computer(self):
+        r"""
+         Get a DistanceComputer (defined in AuxIndexStructures) object
+        for this kind of index.
+
+        DistanceComputer is implemented for indexes that support random
+        access of their vectors.
+        """
+        return _swigfaiss_avx2.Index_get_distance_computer(self)
+
+    def sa_code_size(self):
+        r""" size of the produced codes in bytes"""
+        return _swigfaiss_avx2.Index_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        r"""
+         encode a set of vectors
+
+        :type n: int
+        :param n:       number of vectors
+        :type x: float
+        :param x:       input vectors, size n * d
+        :type bytes: uint8_t
+        :param bytes:   output encoded vectors, size n * sa_code_size()
+        """
+        return _swigfaiss_avx2.Index_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        r"""
+         decode a set of vectors
+
+        :type n: int
+        :param n:       number of vectors
+        :type bytes: uint8_t
+        :param bytes:   input encoded vectors, size n * sa_code_size()
+        :type x: float
+        :param x:       output vectors, size n * d
+        """
+        return _swigfaiss_avx2.Index_sa_decode(self, n, bytes, x)
+
+    def merge_from(self, otherIndex, add_id=0):
+        r"""
+         moves the entries from another dataset to self.
+        On output, other is empty.
+        add_id is added to all moved ids
+        (for sequential ids, this would be this->ntotal)
+        """
+        return _swigfaiss_avx2.Index_merge_from(self, otherIndex, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        r"""
+         check that the two indexes are compatible (ie, they are
+        trained in the same way and have the same
+        parameters). Otherwise throw.
+        """
+        return _swigfaiss_avx2.Index_check_compatible_for_merge(self, otherIndex)
+
+# Register Index in _swigfaiss_avx2:
+_swigfaiss_avx2.Index_swigregister(Index)
+class DistanceComputer(object):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+
+    def set_query(self, x):
+        r"""
+        called before computing distances. Pointer x should remain valid
+        while operator () is called
+        """
+        return _swigfaiss_avx2.DistanceComputer_set_query(self, x)
+
+    def __call__(self, i):
+        r""" compute distance of vector i to current query"""
+        return _swigfaiss_avx2.DistanceComputer___call__(self, i)
+
+    def distances_batch_4(self, idx0, idx1, idx2, idx3, dis0, dis1, dis2, dis3):
+        r"""
+        compute distances of current query to 4 stored vectors.
+        certain DistanceComputer implementations may benefit
+        heavily from this.
+        """
+        return _swigfaiss_avx2.DistanceComputer_distances_batch_4(self, idx0, idx1, idx2, idx3, dis0, dis1, dis2, dis3)
+
+    def symmetric_dis(self, i, j):
+        r""" compute distance between two stored vectors"""
+        return _swigfaiss_avx2.DistanceComputer_symmetric_dis(self, i, j)
+    __swig_destroy__ = _swigfaiss_avx2.delete_DistanceComputer
+
+# Register DistanceComputer in _swigfaiss_avx2:
+_swigfaiss_avx2.DistanceComputer_swigregister(DistanceComputer)
+class FlatCodesDistanceComputer(DistanceComputer):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    codes = property(_swigfaiss_avx2.FlatCodesDistanceComputer_codes_get, _swigfaiss_avx2.FlatCodesDistanceComputer_codes_set)
+    code_size = property(_swigfaiss_avx2.FlatCodesDistanceComputer_code_size_get, _swigfaiss_avx2.FlatCodesDistanceComputer_code_size_set)
+
+    def __call__(self, i):
+        return _swigfaiss_avx2.FlatCodesDistanceComputer___call__(self, i)
+
+    def distance_to_code(self, code):
+        r""" compute distance of current query to an encoded vector"""
+        return _swigfaiss_avx2.FlatCodesDistanceComputer_distance_to_code(self, code)
+    __swig_destroy__ = _swigfaiss_avx2.delete_FlatCodesDistanceComputer
+
+# Register FlatCodesDistanceComputer in _swigfaiss_avx2:
+_swigfaiss_avx2.FlatCodesDistanceComputer_swigregister(FlatCodesDistanceComputer)
+class IndexFlatCodes(Index):
+    r"""
+     Index that encodes all vectors as fixed-size codes (size code_size). Storage
+    is in the codes vector
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    code_size = property(_swigfaiss_avx2.IndexFlatCodes_code_size_get, _swigfaiss_avx2.IndexFlatCodes_code_size_set)
+    codes = property(_swigfaiss_avx2.IndexFlatCodes_codes_get, _swigfaiss_avx2.IndexFlatCodes_codes_set, doc=r""" encoded dataset, size ntotal * code_size""")
+
+    def add(self, n, x):
+        r""" default add uses sa_encode"""
+        return _swigfaiss_avx2.IndexFlatCodes_add(self, n, x)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexFlatCodes_reset(self)
+
+    def reconstruct_n(self, i0, ni, recons):
+        return _swigfaiss_avx2.IndexFlatCodes_reconstruct_n(self, i0, ni, recons)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexFlatCodes_reconstruct(self, key, recons)
+
+    def sa_code_size(self):
+        return _swigfaiss_avx2.IndexFlatCodes_sa_code_size(self)
+
+    def remove_ids(self, sel):
+        r"""
+         remove some ids. NB that because of the structure of the
+        index, the semantics of this operation are
+        different from the usual ones: the new ids are shifted
+        """
+        return _swigfaiss_avx2.IndexFlatCodes_remove_ids(self, sel)
+
+    def get_FlatCodesDistanceComputer(self):
+        r""" a FlatCodesDistanceComputer offers a distance_to_code method"""
+        return _swigfaiss_avx2.IndexFlatCodes_get_FlatCodesDistanceComputer(self)
+
+    def get_distance_computer(self):
+        return _swigfaiss_avx2.IndexFlatCodes_get_distance_computer(self)
+
+    def get_CodePacker(self):
+        return _swigfaiss_avx2.IndexFlatCodes_get_CodePacker(self)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss_avx2.IndexFlatCodes_check_compatible_for_merge(self, otherIndex)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss_avx2.IndexFlatCodes_merge_from(self, otherIndex, add_id)
+
+    def permute_entries(self, perm):
+        return _swigfaiss_avx2.IndexFlatCodes_permute_entries(self, perm)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexFlatCodes
+
+# Register IndexFlatCodes in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexFlatCodes_swigregister(IndexFlatCodes)
+class IndexFlat(IndexFlatCodes):
+    r""" Index that stores the full vectors and performs exhaustive search"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexFlat_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss_avx2.IndexFlat_range_search(self, n, x, radius, result, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexFlat_reconstruct(self, key, recons)
+
+    def compute_distance_subset(self, n, x, k, distances, labels):
+        r"""
+         compute distance with a subset of vectors
+
+        :type x: float
+        :param x:       query vectors, size n * d
+        :type labels: int
+        :param labels:  indices of the vectors that should be compared
+                           for each query vector, size n * k
+        :type distances: float
+        :param distances:
+                           corresponding output distances, size n * k
+        """
+        return _swigfaiss_avx2.IndexFlat_compute_distance_subset(self, n, x, k, distances, labels)
+
+    def get_xb(self, *args):
+        return _swigfaiss_avx2.IndexFlat_get_xb(self, *args)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexFlat_swiginit(self, _swigfaiss_avx2.new_IndexFlat(*args))
+
+    def get_FlatCodesDistanceComputer(self):
+        return _swigfaiss_avx2.IndexFlat_get_FlatCodesDistanceComputer(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss_avx2.IndexFlat_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexFlat_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexFlat
+
+# Register IndexFlat in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexFlat_swigregister(IndexFlat)
+class IndexFlatIP(IndexFlat):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexFlatIP_swiginit(self, _swigfaiss_avx2.new_IndexFlatIP(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexFlatIP
+
+# Register IndexFlatIP in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexFlatIP_swigregister(IndexFlatIP)
+class IndexFlatL2(IndexFlat):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    cached_l2norms = property(_swigfaiss_avx2.IndexFlatL2_cached_l2norms_get, _swigfaiss_avx2.IndexFlatL2_cached_l2norms_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexFlatL2_swiginit(self, _swigfaiss_avx2.new_IndexFlatL2(*args))
+
+    def get_FlatCodesDistanceComputer(self):
+        return _swigfaiss_avx2.IndexFlatL2_get_FlatCodesDistanceComputer(self)
+
+    def sync_l2norms(self):
+        return _swigfaiss_avx2.IndexFlatL2_sync_l2norms(self)
+
+    def clear_l2norms(self):
+        return _swigfaiss_avx2.IndexFlatL2_clear_l2norms(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexFlatL2
+
+# Register IndexFlatL2 in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexFlatL2_swigregister(IndexFlatL2)
+class IndexFlat1D(IndexFlatL2):
+    r""" optimized version for 1D "vectors"."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    continuous_update = property(_swigfaiss_avx2.IndexFlat1D_continuous_update_get, _swigfaiss_avx2.IndexFlat1D_continuous_update_set, doc=r""" is the permutation updated continuously?""")
+    perm = property(_swigfaiss_avx2.IndexFlat1D_perm_get, _swigfaiss_avx2.IndexFlat1D_perm_set, doc=r""" sorted database indices""")
+
+    def __init__(self, continuous_update=True):
+        _swigfaiss_avx2.IndexFlat1D_swiginit(self, _swigfaiss_avx2.new_IndexFlat1D(continuous_update))
+
+    def update_permutation(self):
+        r"""
+        if not continuous_update, call this between the last add and
+        the first search
+        """
+        return _swigfaiss_avx2.IndexFlat1D_update_permutation(self)
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexFlat1D_add(self, n, x)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexFlat1D_reset(self)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" Warn: the distances returned are L1 not L2"""
+        return _swigfaiss_avx2.IndexFlat1D_search(self, n, x, k, distances, labels, params)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexFlat1D
+
+# Register IndexFlat1D in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexFlat1D_swigregister(IndexFlat1D)
+class ClusteringParameters(object):
+    r"""
+     Class for the clustering parameters. Can be passed to the
+    constructor of the Clustering object.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    niter = property(_swigfaiss_avx2.ClusteringParameters_niter_get, _swigfaiss_avx2.ClusteringParameters_niter_set, doc=r""" number of clustering iterations""")
+    nredo = property(_swigfaiss_avx2.ClusteringParameters_nredo_get, _swigfaiss_avx2.ClusteringParameters_nredo_set, doc=r"""
+    redo clustering this many times and keep the clusters with the best
+    objective
+    """)
+    verbose = property(_swigfaiss_avx2.ClusteringParameters_verbose_get, _swigfaiss_avx2.ClusteringParameters_verbose_set)
+    spherical = property(_swigfaiss_avx2.ClusteringParameters_spherical_get, _swigfaiss_avx2.ClusteringParameters_spherical_set, doc=r"""
+    whether to normalize centroids after each iteration (useful for inner
+    product clustering)
+    """)
+    int_centroids = property(_swigfaiss_avx2.ClusteringParameters_int_centroids_get, _swigfaiss_avx2.ClusteringParameters_int_centroids_set, doc=r""" round centroids coordinates to integer after each iteration?""")
+    update_index = property(_swigfaiss_avx2.ClusteringParameters_update_index_get, _swigfaiss_avx2.ClusteringParameters_update_index_set, doc=r""" re-train index after each iteration?""")
+    frozen_centroids = property(_swigfaiss_avx2.ClusteringParameters_frozen_centroids_get, _swigfaiss_avx2.ClusteringParameters_frozen_centroids_set, doc=r"""
+    Use the subset of centroids provided as input and do not change them
+    during iterations
+    """)
+    min_points_per_centroid = property(_swigfaiss_avx2.ClusteringParameters_min_points_per_centroid_get, _swigfaiss_avx2.ClusteringParameters_min_points_per_centroid_set, doc=r"""
+    If fewer than this number of training vectors per centroid are provided,
+    writes a warning. Note that fewer than 1 point per centroid raises an
+    exception.
+    """)
+    max_points_per_centroid = property(_swigfaiss_avx2.ClusteringParameters_max_points_per_centroid_get, _swigfaiss_avx2.ClusteringParameters_max_points_per_centroid_set, doc=r""" to limit size of dataset, otherwise the training set is subsampled""")
+    seed = property(_swigfaiss_avx2.ClusteringParameters_seed_get, _swigfaiss_avx2.ClusteringParameters_seed_set, doc=r""" seed for the random number generator""")
+    decode_block_size = property(_swigfaiss_avx2.ClusteringParameters_decode_block_size_get, _swigfaiss_avx2.ClusteringParameters_decode_block_size_set, doc=r""" when the training set is encoded, batch size of the codec decoder""")
+
+    def __init__(self):
+        _swigfaiss_avx2.ClusteringParameters_swiginit(self, _swigfaiss_avx2.new_ClusteringParameters())
+    __swig_destroy__ = _swigfaiss_avx2.delete_ClusteringParameters
+
+# Register ClusteringParameters in _swigfaiss_avx2:
+_swigfaiss_avx2.ClusteringParameters_swigregister(ClusteringParameters)
+class ClusteringIterationStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    obj = property(_swigfaiss_avx2.ClusteringIterationStats_obj_get, _swigfaiss_avx2.ClusteringIterationStats_obj_set, doc=r""" objective values (sum of distances reported by index)""")
+    time = property(_swigfaiss_avx2.ClusteringIterationStats_time_get, _swigfaiss_avx2.ClusteringIterationStats_time_set, doc=r""" seconds for iteration""")
+    time_search = property(_swigfaiss_avx2.ClusteringIterationStats_time_search_get, _swigfaiss_avx2.ClusteringIterationStats_time_search_set, doc=r""" seconds for just search""")
+    imbalance_factor = property(_swigfaiss_avx2.ClusteringIterationStats_imbalance_factor_get, _swigfaiss_avx2.ClusteringIterationStats_imbalance_factor_set, doc=r""" imbalance factor of iteration""")
+    nsplit = property(_swigfaiss_avx2.ClusteringIterationStats_nsplit_get, _swigfaiss_avx2.ClusteringIterationStats_nsplit_set, doc=r""" number of cluster splits""")
+
+    def __init__(self):
+        _swigfaiss_avx2.ClusteringIterationStats_swiginit(self, _swigfaiss_avx2.new_ClusteringIterationStats())
+    __swig_destroy__ = _swigfaiss_avx2.delete_ClusteringIterationStats
+
+# Register ClusteringIterationStats in _swigfaiss_avx2:
+_swigfaiss_avx2.ClusteringIterationStats_swigregister(ClusteringIterationStats)
+class Clustering(ClusteringParameters):
+    r"""
+     K-means clustering based on assignment - centroid update iterations
+
+    The clustering is based on an Index object that assigns training
+    points to the centroids. Therefore, at each iteration the centroids
+    are added to the index.
+
+    On output, the centoids table is set to the latest version
+    of the centroids and they are also added to the index. If the
+    centroids table it is not empty on input, it is also used for
+    initialization.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    d = property(_swigfaiss_avx2.Clustering_d_get, _swigfaiss_avx2.Clustering_d_set, doc=r""" dimension of the vectors""")
+    k = property(_swigfaiss_avx2.Clustering_k_get, _swigfaiss_avx2.Clustering_k_set, doc=r""" nb of centroids""")
+    centroids = property(_swigfaiss_avx2.Clustering_centroids_get, _swigfaiss_avx2.Clustering_centroids_set, doc=r"""
+     centroids (k * d)
+    if centroids are set on input to train, they will be used as
+    initialization
+    """)
+    iteration_stats = property(_swigfaiss_avx2.Clustering_iteration_stats_get, _swigfaiss_avx2.Clustering_iteration_stats_set, doc=r""" stats at every iteration of clustering""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.Clustering_swiginit(self, _swigfaiss_avx2.new_Clustering(*args))
+
+    def train(self, n, x, index, x_weights=None):
+        r"""
+         run k-means training
+
+        :type x: float
+        :param x:          training vectors, size n * d
+        :type index: :py:class:`Index`
+        :param index:      index used for assignment
+        :type x_weights: float, optional
+        :param x_weights:  weight associated to each vector: NULL or size n
+        """
+        return _swigfaiss_avx2.Clustering_train(self, n, x, index, x_weights)
+
+    def train_encoded(self, nx, x_in, codec, index, weights=None):
+        r"""
+         run with encoded vectors
+
+        win addition to train()'s parameters takes a codec as parameter
+        to decode the input vectors.
+
+        :type codec: :py:class:`Index`
+        :param codec:      codec used to decode the vectors (nullptr =
+                              vectors are in fact floats)
+        """
+        return _swigfaiss_avx2.Clustering_train_encoded(self, nx, x_in, codec, index, weights)
+
+    def post_process_centroids(self):
+        r"""
+        Post-process the centroids after each centroid update.
+        includes optional L2 normalization and nearest integer rounding
+        """
+        return _swigfaiss_avx2.Clustering_post_process_centroids(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Clustering
+
+# Register Clustering in _swigfaiss_avx2:
+_swigfaiss_avx2.Clustering_swigregister(Clustering)
+class Clustering1D(Clustering):
+    r"""
+     Exact 1D clustering algorithm
+
+    Since it does not use an index, it does not overload the train() function
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.Clustering1D_swiginit(self, _swigfaiss_avx2.new_Clustering1D(*args))
+
+    def train_exact(self, n, x):
+        return _swigfaiss_avx2.Clustering1D_train_exact(self, n, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Clustering1D
+
+# Register Clustering1D in _swigfaiss_avx2:
+_swigfaiss_avx2.Clustering1D_swigregister(Clustering1D)
+class ProgressiveDimClusteringParameters(ClusteringParameters):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    progressive_dim_steps = property(_swigfaiss_avx2.ProgressiveDimClusteringParameters_progressive_dim_steps_get, _swigfaiss_avx2.ProgressiveDimClusteringParameters_progressive_dim_steps_set, doc=r""" number of incremental steps""")
+    apply_pca = property(_swigfaiss_avx2.ProgressiveDimClusteringParameters_apply_pca_get, _swigfaiss_avx2.ProgressiveDimClusteringParameters_apply_pca_set, doc=r""" apply PCA on input""")
+
+    def __init__(self):
+        _swigfaiss_avx2.ProgressiveDimClusteringParameters_swiginit(self, _swigfaiss_avx2.new_ProgressiveDimClusteringParameters())
+    __swig_destroy__ = _swigfaiss_avx2.delete_ProgressiveDimClusteringParameters
+
+# Register ProgressiveDimClusteringParameters in _swigfaiss_avx2:
+_swigfaiss_avx2.ProgressiveDimClusteringParameters_swigregister(ProgressiveDimClusteringParameters)
+class ProgressiveDimIndexFactory(object):
+    r""" generates an index suitable for clustering when called"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __call__(self, dim):
+        r""" ownership transferred to caller"""
+        return _swigfaiss_avx2.ProgressiveDimIndexFactory___call__(self, dim)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ProgressiveDimIndexFactory
+
+    def __init__(self):
+        _swigfaiss_avx2.ProgressiveDimIndexFactory_swiginit(self, _swigfaiss_avx2.new_ProgressiveDimIndexFactory())
+
+# Register ProgressiveDimIndexFactory in _swigfaiss_avx2:
+_swigfaiss_avx2.ProgressiveDimIndexFactory_swigregister(ProgressiveDimIndexFactory)
+class ProgressiveDimClustering(ProgressiveDimClusteringParameters):
+    r"""
+     K-means clustering with progressive dimensions used
+
+    The clustering first happens in dim 1, then with exponentially increasing
+    dimension until d (I steps). This is typically applied after a PCA
+    transformation (optional). Reference:
+
+    "Improved Residual Vector Quantization for High-dimensional Approximate
+    Nearest Neighbor Search"
+
+    Shicong Liu, Hongtao Lu, Junru Shao, AAAI'15
+
+    https://arxiv.org/abs/1509.05195
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    d = property(_swigfaiss_avx2.ProgressiveDimClustering_d_get, _swigfaiss_avx2.ProgressiveDimClustering_d_set, doc=r""" dimension of the vectors""")
+    k = property(_swigfaiss_avx2.ProgressiveDimClustering_k_get, _swigfaiss_avx2.ProgressiveDimClustering_k_set, doc=r""" nb of centroids""")
+    centroids = property(_swigfaiss_avx2.ProgressiveDimClustering_centroids_get, _swigfaiss_avx2.ProgressiveDimClustering_centroids_set, doc=r""" centroids (k * d)""")
+    iteration_stats = property(_swigfaiss_avx2.ProgressiveDimClustering_iteration_stats_get, _swigfaiss_avx2.ProgressiveDimClustering_iteration_stats_set, doc=r""" stats at every iteration of clustering""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.ProgressiveDimClustering_swiginit(self, _swigfaiss_avx2.new_ProgressiveDimClustering(*args))
+
+    def train(self, n, x, factory):
+        return _swigfaiss_avx2.ProgressiveDimClustering_train(self, n, x, factory)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ProgressiveDimClustering
+
+# Register ProgressiveDimClustering in _swigfaiss_avx2:
+_swigfaiss_avx2.ProgressiveDimClustering_swigregister(ProgressiveDimClustering)
+
+def kmeans_clustering(d, n, k, x, centroids):
+    r"""
+     simplified interface
+
+    :type d: int
+    :param d: dimension of the data
+    :type n: int
+    :param n: nb of training vectors
+    :type k: int
+    :param k: nb of output centroids
+    :type x: float
+    :param x: training set (size n * d)
+    :type centroids: float
+    :param centroids: output centroids (size k * d)
+    :rtype: float
+    :return: final quantization error
+    """
+    return _swigfaiss_avx2.kmeans_clustering(d, n, k, x, centroids)
+
+def pairwise_extra_distances(d, nq, xq, nb, xb, mt, metric_arg, dis, ldq=-1, ldb=-1, ldd=-1):
+    return _swigfaiss_avx2.pairwise_extra_distances(d, nq, xq, nb, xb, mt, metric_arg, dis, ldq, ldb, ldd)
+
+def get_extra_distance_computer(d, mt, metric_arg, nb, xb):
+    r"""
+    get a DistanceComputer that refers to this type of distance and
+    indexes a flat array of size nb
+    """
+    return _swigfaiss_avx2.get_extra_distance_computer(d, mt, metric_arg, nb, xb)
+class Quantizer(object):
+    r""" General interface for quantizer objects"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    d = property(_swigfaiss_avx2.Quantizer_d_get, _swigfaiss_avx2.Quantizer_d_set, doc=r""" size of the input vectors""")
+    code_size = property(_swigfaiss_avx2.Quantizer_code_size_get, _swigfaiss_avx2.Quantizer_code_size_set, doc=r""" bytes per indexed vector""")
+
+    def train(self, n, x):
+        r"""
+         Train the quantizer
+
+        :type x: float
+        :param x:       training vectors, size n * d
+        """
+        return _swigfaiss_avx2.Quantizer_train(self, n, x)
+
+    def compute_codes(self, x, codes, n):
+        r"""
+         Quantize a set of vectors
+
+        :type x: float
+        :param x:        input vectors, size n * d
+        :type codes: uint8_t
+        :param codes:    output codes, size n * code_size
+        """
+        return _swigfaiss_avx2.Quantizer_compute_codes(self, x, codes, n)
+
+    def decode(self, code, x, n):
+        r"""
+         Decode a set of vectors
+
+        :param codes:    input codes, size n * code_size
+        :type x: float
+        :param x:        output vectors, size n * d
+        """
+        return _swigfaiss_avx2.Quantizer_decode(self, code, x, n)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Quantizer
+
+# Register Quantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.Quantizer_swigregister(Quantizer)
+class ProductQuantizer(Quantizer):
+    r""" Product Quantizer. Implemented only for METRIC_L2"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    M = property(_swigfaiss_avx2.ProductQuantizer_M_get, _swigfaiss_avx2.ProductQuantizer_M_set, doc=r""" number of subquantizers""")
+    nbits = property(_swigfaiss_avx2.ProductQuantizer_nbits_get, _swigfaiss_avx2.ProductQuantizer_nbits_set, doc=r""" number of bits per quantization index""")
+    dsub = property(_swigfaiss_avx2.ProductQuantizer_dsub_get, _swigfaiss_avx2.ProductQuantizer_dsub_set, doc=r""" dimensionality of each subvector""")
+    ksub = property(_swigfaiss_avx2.ProductQuantizer_ksub_get, _swigfaiss_avx2.ProductQuantizer_ksub_set, doc=r""" number of centroids for each subquantizer""")
+    verbose = property(_swigfaiss_avx2.ProductQuantizer_verbose_get, _swigfaiss_avx2.ProductQuantizer_verbose_set, doc=r""" verbose during training?""")
+    Train_default = _swigfaiss_avx2.ProductQuantizer_Train_default
+    Train_hot_start = _swigfaiss_avx2.ProductQuantizer_Train_hot_start
+    r""" the centroids are already initialized"""
+    Train_shared = _swigfaiss_avx2.ProductQuantizer_Train_shared
+    r""" share dictionary across PQ segments"""
+    Train_hypercube = _swigfaiss_avx2.ProductQuantizer_Train_hypercube
+    r""" initialize centroids with nbits-D hypercube"""
+    Train_hypercube_pca = _swigfaiss_avx2.ProductQuantizer_Train_hypercube_pca
+    r""" initialize centroids with nbits-D hypercube"""
+    train_type = property(_swigfaiss_avx2.ProductQuantizer_train_type_get, _swigfaiss_avx2.ProductQuantizer_train_type_set)
+    cp = property(_swigfaiss_avx2.ProductQuantizer_cp_get, _swigfaiss_avx2.ProductQuantizer_cp_set, doc=r""" parameters used during clustering""")
+    assign_index = property(_swigfaiss_avx2.ProductQuantizer_assign_index_get, _swigfaiss_avx2.ProductQuantizer_assign_index_set, doc=r"""
+    if non-NULL, use this index for assignment (should be of size
+    d / M)
+    """)
+    centroids = property(_swigfaiss_avx2.ProductQuantizer_centroids_get, _swigfaiss_avx2.ProductQuantizer_centroids_set, doc=r"""
+    Centroid table, size M * ksub * dsub.
+    Layout: (M, ksub, dsub)
+    """)
+    transposed_centroids = property(_swigfaiss_avx2.ProductQuantizer_transposed_centroids_get, _swigfaiss_avx2.ProductQuantizer_transposed_centroids_set, doc=r"""
+    Transposed centroid table, size M * ksub * dsub.
+    Layout: (dsub, M, ksub)
+    """)
+    centroids_sq_lengths = property(_swigfaiss_avx2.ProductQuantizer_centroids_sq_lengths_get, _swigfaiss_avx2.ProductQuantizer_centroids_sq_lengths_set, doc=r"""
+    Squared lengths of centroids, size M * ksub
+    Layout: (M, ksub)
+    """)
+
+    def get_centroids(self, m, i):
+        r""" return the centroids associated with subvector m"""
+        return _swigfaiss_avx2.ProductQuantizer_get_centroids(self, m, i)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.ProductQuantizer_train(self, n, x)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.ProductQuantizer_swiginit(self, _swigfaiss_avx2.new_ProductQuantizer(*args))
+
+    def set_derived_values(self):
+        r""" compute derived values when d, M and nbits have been set"""
+        return _swigfaiss_avx2.ProductQuantizer_set_derived_values(self)
+
+    def set_params(self, centroids, m):
+        r""" Define the centroids for subquantizer m"""
+        return _swigfaiss_avx2.ProductQuantizer_set_params(self, centroids, m)
+
+    def compute_code(self, x, code):
+        r""" Quantize one vector with the product quantizer"""
+        return _swigfaiss_avx2.ProductQuantizer_compute_code(self, x, code)
+
+    def compute_codes(self, x, codes, n):
+        r""" same as compute_code for several vectors"""
+        return _swigfaiss_avx2.ProductQuantizer_compute_codes(self, x, codes, n)
+
+    def compute_codes_with_assign_index(self, x, codes, n):
+        r"""
+        speed up code assignment using assign_index
+        (non-const because the index is changed)
+        """
+        return _swigfaiss_avx2.ProductQuantizer_compute_codes_with_assign_index(self, x, codes, n)
+
+    def decode(self, *args):
+        return _swigfaiss_avx2.ProductQuantizer_decode(self, *args)
+
+    def compute_code_from_distance_table(self, tab, code):
+        r"""
+        If we happen to have the distance tables precomputed, this is
+        more efficient to compute the codes.
+        """
+        return _swigfaiss_avx2.ProductQuantizer_compute_code_from_distance_table(self, tab, code)
+
+    def compute_distance_table(self, x, dis_table):
+        r"""
+         Compute distance table for one vector.
+
+        The distance table for x = [x_0 x_1 .. x_(M-1)] is a M * ksub
+        matrix that contains
+
+          dis_table (m, j) = || x_m - c_(m, j)||^2
+          for m = 0..M-1 and j = 0 .. ksub - 1
+
+        where c_(m, j) is the centroid no j of sub-quantizer m.
+
+        :type x: float
+        :param x:         input vector size d
+        :type dis_table: float
+        :param dis_table: output table, size M * ksub
+        """
+        return _swigfaiss_avx2.ProductQuantizer_compute_distance_table(self, x, dis_table)
+
+    def compute_inner_prod_table(self, x, dis_table):
+        return _swigfaiss_avx2.ProductQuantizer_compute_inner_prod_table(self, x, dis_table)
+
+    def compute_distance_tables(self, nx, x, dis_tables):
+        r"""
+         compute distance table for several vectors
+        :type nx: int
+        :param nx:        nb of input vectors
+        :type x: float
+        :param x:         input vector size nx * d
+        :param dis_table: output table, size nx * M * ksub
+        """
+        return _swigfaiss_avx2.ProductQuantizer_compute_distance_tables(self, nx, x, dis_tables)
+
+    def compute_inner_prod_tables(self, nx, x, dis_tables):
+        return _swigfaiss_avx2.ProductQuantizer_compute_inner_prod_tables(self, nx, x, dis_tables)
+
+    def search(self, x, nx, codes, ncodes, res, init_finalize_heap=True):
+        r"""
+         perform a search (L2 distance)
+        :type x: float
+        :param x:        query vectors, size nx * d
+        :type nx: int
+        :param nx:       nb of queries
+        :type codes: uint8_t
+        :param codes:    database codes, size ncodes * code_size
+        :type ncodes: int
+        :param ncodes:   nb of nb vectors
+        :type res: :py:class:`float_maxheap_array_t`
+        :param res:      heap array to store results (nh == nx)
+        :type init_finalize_heap: boolean, optional
+        :param init_finalize_heap:  initialize heap (input) and sort (output)?
+        """
+        return _swigfaiss_avx2.ProductQuantizer_search(self, x, nx, codes, ncodes, res, init_finalize_heap)
+
+    def search_ip(self, x, nx, codes, ncodes, res, init_finalize_heap=True):
+        r""" same as search, but with inner product similarity"""
+        return _swigfaiss_avx2.ProductQuantizer_search_ip(self, x, nx, codes, ncodes, res, init_finalize_heap)
+    sdc_table = property(_swigfaiss_avx2.ProductQuantizer_sdc_table_get, _swigfaiss_avx2.ProductQuantizer_sdc_table_set, doc=r""" Symmetric Distance Table""")
+
+    def compute_sdc_table(self):
+        return _swigfaiss_avx2.ProductQuantizer_compute_sdc_table(self)
+
+    def search_sdc(self, qcodes, nq, bcodes, ncodes, res, init_finalize_heap=True):
+        return _swigfaiss_avx2.ProductQuantizer_search_sdc(self, qcodes, nq, bcodes, ncodes, res, init_finalize_heap)
+
+    def sync_transposed_centroids(self):
+        r"""
+        Sync transposed centroids with regular centroids. This call
+        is needed if centroids were edited directly.
+        """
+        return _swigfaiss_avx2.ProductQuantizer_sync_transposed_centroids(self)
+
+    def clear_transposed_centroids(self):
+        r""" Clear transposed centroids table so ones are no longer used."""
+        return _swigfaiss_avx2.ProductQuantizer_clear_transposed_centroids(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ProductQuantizer
+
+# Register ProductQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.ProductQuantizer_swigregister(ProductQuantizer)
+class PQEncoderGeneric(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code = property(_swigfaiss_avx2.PQEncoderGeneric_code_get, _swigfaiss_avx2.PQEncoderGeneric_code_set, doc=r""" code for this vector""")
+    offset = property(_swigfaiss_avx2.PQEncoderGeneric_offset_get, _swigfaiss_avx2.PQEncoderGeneric_offset_set)
+    nbits = property(_swigfaiss_avx2.PQEncoderGeneric_nbits_get, doc=r""" number of bits per subquantizer index""")
+    reg = property(_swigfaiss_avx2.PQEncoderGeneric_reg_get, _swigfaiss_avx2.PQEncoderGeneric_reg_set)
+
+    def __init__(self, code, nbits, offset=0):
+        _swigfaiss_avx2.PQEncoderGeneric_swiginit(self, _swigfaiss_avx2.new_PQEncoderGeneric(code, nbits, offset))
+
+    def encode(self, x):
+        return _swigfaiss_avx2.PQEncoderGeneric_encode(self, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_PQEncoderGeneric
+
+# Register PQEncoderGeneric in _swigfaiss_avx2:
+_swigfaiss_avx2.PQEncoderGeneric_swigregister(PQEncoderGeneric)
+class PQEncoder8(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code = property(_swigfaiss_avx2.PQEncoder8_code_get, _swigfaiss_avx2.PQEncoder8_code_set)
+
+    def __init__(self, code, nbits):
+        _swigfaiss_avx2.PQEncoder8_swiginit(self, _swigfaiss_avx2.new_PQEncoder8(code, nbits))
+
+    def encode(self, x):
+        return _swigfaiss_avx2.PQEncoder8_encode(self, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_PQEncoder8
+
+# Register PQEncoder8 in _swigfaiss_avx2:
+_swigfaiss_avx2.PQEncoder8_swigregister(PQEncoder8)
+class PQEncoder16(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code = property(_swigfaiss_avx2.PQEncoder16_code_get, _swigfaiss_avx2.PQEncoder16_code_set)
+
+    def __init__(self, code, nbits):
+        _swigfaiss_avx2.PQEncoder16_swiginit(self, _swigfaiss_avx2.new_PQEncoder16(code, nbits))
+
+    def encode(self, x):
+        return _swigfaiss_avx2.PQEncoder16_encode(self, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_PQEncoder16
+
+# Register PQEncoder16 in _swigfaiss_avx2:
+_swigfaiss_avx2.PQEncoder16_swigregister(PQEncoder16)
+class PQDecoderGeneric(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code = property(_swigfaiss_avx2.PQDecoderGeneric_code_get, _swigfaiss_avx2.PQDecoderGeneric_code_set)
+    offset = property(_swigfaiss_avx2.PQDecoderGeneric_offset_get, _swigfaiss_avx2.PQDecoderGeneric_offset_set)
+    nbits = property(_swigfaiss_avx2.PQDecoderGeneric_nbits_get)
+    mask = property(_swigfaiss_avx2.PQDecoderGeneric_mask_get)
+    reg = property(_swigfaiss_avx2.PQDecoderGeneric_reg_get, _swigfaiss_avx2.PQDecoderGeneric_reg_set)
+
+    def __init__(self, code, nbits):
+        _swigfaiss_avx2.PQDecoderGeneric_swiginit(self, _swigfaiss_avx2.new_PQDecoderGeneric(code, nbits))
+
+    def decode(self):
+        return _swigfaiss_avx2.PQDecoderGeneric_decode(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_PQDecoderGeneric
+
+# Register PQDecoderGeneric in _swigfaiss_avx2:
+_swigfaiss_avx2.PQDecoderGeneric_swigregister(PQDecoderGeneric)
+class PQDecoder8(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nbits = _swigfaiss_avx2.PQDecoder8_nbits
+    code = property(_swigfaiss_avx2.PQDecoder8_code_get, _swigfaiss_avx2.PQDecoder8_code_set)
+
+    def __init__(self, code, nbits):
+        _swigfaiss_avx2.PQDecoder8_swiginit(self, _swigfaiss_avx2.new_PQDecoder8(code, nbits))
+
+    def decode(self):
+        return _swigfaiss_avx2.PQDecoder8_decode(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_PQDecoder8
+
+# Register PQDecoder8 in _swigfaiss_avx2:
+_swigfaiss_avx2.PQDecoder8_swigregister(PQDecoder8)
+class PQDecoder16(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nbits = _swigfaiss_avx2.PQDecoder16_nbits
+    code = property(_swigfaiss_avx2.PQDecoder16_code_get, _swigfaiss_avx2.PQDecoder16_code_set)
+
+    def __init__(self, code, nbits):
+        _swigfaiss_avx2.PQDecoder16_swiginit(self, _swigfaiss_avx2.new_PQDecoder16(code, nbits))
+
+    def decode(self):
+        return _swigfaiss_avx2.PQDecoder16_decode(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_PQDecoder16
+
+# Register PQDecoder16 in _swigfaiss_avx2:
+_swigfaiss_avx2.PQDecoder16_swigregister(PQDecoder16)
+class AdditiveQuantizer(Quantizer):
+    r"""
+     Abstract structure for additive quantizers
+
+    Different from the product quantizer in which the decoded vector is the
+    concatenation of M sub-vectors, additive quantizers sum M sub-vectors
+    to get the decoded vector.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    M = property(_swigfaiss_avx2.AdditiveQuantizer_M_get, _swigfaiss_avx2.AdditiveQuantizer_M_set, doc=r""" number of codebooks""")
+    nbits = property(_swigfaiss_avx2.AdditiveQuantizer_nbits_get, _swigfaiss_avx2.AdditiveQuantizer_nbits_set, doc=r""" bits for each step""")
+    codebooks = property(_swigfaiss_avx2.AdditiveQuantizer_codebooks_get, _swigfaiss_avx2.AdditiveQuantizer_codebooks_set, doc=r""" codebooks""")
+    codebook_offsets = property(_swigfaiss_avx2.AdditiveQuantizer_codebook_offsets_get, _swigfaiss_avx2.AdditiveQuantizer_codebook_offsets_set)
+    tot_bits = property(_swigfaiss_avx2.AdditiveQuantizer_tot_bits_get, _swigfaiss_avx2.AdditiveQuantizer_tot_bits_set, doc=r""" total number of bits (indexes + norms)""")
+    norm_bits = property(_swigfaiss_avx2.AdditiveQuantizer_norm_bits_get, _swigfaiss_avx2.AdditiveQuantizer_norm_bits_set, doc=r""" bits allocated for the norms""")
+    total_codebook_size = property(_swigfaiss_avx2.AdditiveQuantizer_total_codebook_size_get, _swigfaiss_avx2.AdditiveQuantizer_total_codebook_size_set, doc=r""" size of the codebook in vectors""")
+    only_8bit = property(_swigfaiss_avx2.AdditiveQuantizer_only_8bit_get, _swigfaiss_avx2.AdditiveQuantizer_only_8bit_set, doc=r""" are all nbits = 8 (use faster decoder)""")
+    verbose = property(_swigfaiss_avx2.AdditiveQuantizer_verbose_get, _swigfaiss_avx2.AdditiveQuantizer_verbose_set, doc=r""" verbose during training?""")
+    is_trained = property(_swigfaiss_avx2.AdditiveQuantizer_is_trained_get, _swigfaiss_avx2.AdditiveQuantizer_is_trained_set, doc=r""" is trained or not""")
+    qnorm = property(_swigfaiss_avx2.AdditiveQuantizer_qnorm_get, _swigfaiss_avx2.AdditiveQuantizer_qnorm_set, doc=r""" store and search norms""")
+    norm_tabs = property(_swigfaiss_avx2.AdditiveQuantizer_norm_tabs_get, _swigfaiss_avx2.AdditiveQuantizer_norm_tabs_set, doc=r"""
+    store norms of codebook entries for 4-bit
+    fastscan search
+    """)
+    max_mem_distances = property(_swigfaiss_avx2.AdditiveQuantizer_max_mem_distances_get, _swigfaiss_avx2.AdditiveQuantizer_max_mem_distances_set, doc=r"""
+    norms and distance matrixes with beam search can get large, so use this
+    to control for the amount of memory that can be allocated
+    """)
+
+    def encode_norm(self, norm):
+        r""" encode a norm into norm_bits bits"""
+        return _swigfaiss_avx2.AdditiveQuantizer_encode_norm(self, norm)
+
+    def encode_qcint(self, x):
+        r""" encode norm by non-uniform scalar quantization"""
+        return _swigfaiss_avx2.AdditiveQuantizer_encode_qcint(self, x)
+
+    def decode_qcint(self, c):
+        r""" decode norm by non-uniform scalar quantization"""
+        return _swigfaiss_avx2.AdditiveQuantizer_decode_qcint(self, c)
+    ST_decompress = _swigfaiss_avx2.AdditiveQuantizer_ST_decompress
+    r""" decompress database vector"""
+    ST_LUT_nonorm = _swigfaiss_avx2.AdditiveQuantizer_ST_LUT_nonorm
+    r"""
+    use a LUT, don't include norms (OK for IP or
+    normalized vectors)
+    """
+    ST_norm_from_LUT = _swigfaiss_avx2.AdditiveQuantizer_ST_norm_from_LUT
+    r"""
+    compute the norms from the look-up tables (cost
+    is in O(M^2))
+    """
+    ST_norm_float = _swigfaiss_avx2.AdditiveQuantizer_ST_norm_float
+    r""" use a LUT, and store float32 norm with the vectors"""
+    ST_norm_qint8 = _swigfaiss_avx2.AdditiveQuantizer_ST_norm_qint8
+    r""" use a LUT, and store 8bit-quantized norm"""
+    ST_norm_qint4 = _swigfaiss_avx2.AdditiveQuantizer_ST_norm_qint4
+    ST_norm_cqint8 = _swigfaiss_avx2.AdditiveQuantizer_ST_norm_cqint8
+    r""" use a LUT, and store non-uniform quantized norm"""
+    ST_norm_cqint4 = _swigfaiss_avx2.AdditiveQuantizer_ST_norm_cqint4
+    ST_norm_lsq2x4 = _swigfaiss_avx2.AdditiveQuantizer_ST_norm_lsq2x4
+    r"""
+    use a 2x4 bits lsq as norm quantizer (for fast
+    scan)
+    """
+    ST_norm_rq2x4 = _swigfaiss_avx2.AdditiveQuantizer_ST_norm_rq2x4
+    r""" use a 2x4 bits rq as norm quantizer (for fast scan)"""
+
+    def set_derived_values(self):
+        r""" Train the norm quantizer"""
+        return _swigfaiss_avx2.AdditiveQuantizer_set_derived_values(self)
+
+    def train_norm(self, n, norms):
+        return _swigfaiss_avx2.AdditiveQuantizer_train_norm(self, n, norms)
+
+    def compute_codes(self, x, codes, n):
+        return _swigfaiss_avx2.AdditiveQuantizer_compute_codes(self, x, codes, n)
+
+    def compute_codes_add_centroids(self, x, codes, n, centroids=None):
+        r"""
+         Encode a set of vectors
+
+        :type x: float
+        :param x:      vectors to encode, size n * d
+        :type codes: uint8_t
+        :param codes:  output codes, size n * code_size
+        :type centroids: float, optional
+        :param centroids:  centroids to be added to x, size n * d
+        """
+        return _swigfaiss_avx2.AdditiveQuantizer_compute_codes_add_centroids(self, x, codes, n, centroids)
+
+    def pack_codes(self, n, codes, packed_codes, ld_codes=-1, norms=None, centroids=None):
+        r"""
+         pack a series of code to bit-compact format
+
+        :type codes: int
+        :param codes:        codes to be packed, size n * code_size
+        :type packed_codes: uint8_t
+        :param packed_codes: output bit-compact codes
+        :type ld_codes: int, optional
+        :param ld_codes:     leading dimension of codes
+        :type norms: float, optional
+        :param norms:        norms of the vectors (size n). Will be computed if
+                                needed but not provided
+        :type centroids: float, optional
+        :param centroids:    centroids to be added to x, size n * d
+        """
+        return _swigfaiss_avx2.AdditiveQuantizer_pack_codes(self, n, codes, packed_codes, ld_codes, norms, centroids)
+
+    def decode(self, codes, x, n):
+        r"""
+         Decode a set of vectors
+
+        :type codes: uint8_t
+        :param codes:  codes to decode, size n * code_size
+        :type x: float
+        :param x:      output vectors, size n * d
+        """
+        return _swigfaiss_avx2.AdditiveQuantizer_decode(self, codes, x, n)
+
+    def decode_unpacked(self, codes, x, n, ld_codes=-1):
+        r"""
+         Decode a set of vectors in non-packed format
+
+        :type codes: int
+        :param codes:  codes to decode, size n * ld_codes
+        :type x: float
+        :param x:      output vectors, size n * d
+        """
+        return _swigfaiss_avx2.AdditiveQuantizer_decode_unpacked(self, codes, x, n, ld_codes)
+    search_type = property(_swigfaiss_avx2.AdditiveQuantizer_search_type_get, _swigfaiss_avx2.AdditiveQuantizer_search_type_set, doc=r""" Also determines what's in the codes""")
+    norm_min = property(_swigfaiss_avx2.AdditiveQuantizer_norm_min_get, _swigfaiss_avx2.AdditiveQuantizer_norm_min_set, doc=r""" min/max for quantization of norms""")
+    norm_max = property(_swigfaiss_avx2.AdditiveQuantizer_norm_max_get, _swigfaiss_avx2.AdditiveQuantizer_norm_max_set)
+
+    def decode_64bit(self, n, x):
+        r""" decoding function for a code in a 64-bit word"""
+        return _swigfaiss_avx2.AdditiveQuantizer_decode_64bit(self, n, x)
+
+    def compute_LUT(self, n, xq, LUT, alpha=1.0, ld_lut=-1):
+        r"""
+         Compute inner-product look-up tables. Used in the centroid search
+        functions.
+
+        :type xq: float
+        :param xq:     query vector, size (n, d)
+        :type LUT: float
+        :param LUT:    look-up table, size (n, total_codebook_size)
+        :type alpha: float, optional
+        :param alpha:  compute alpha * inner-product
+        :type ld_lut: int, optional
+        :param ld_lut:  leading dimension of LUT
+        """
+        return _swigfaiss_avx2.AdditiveQuantizer_compute_LUT(self, n, xq, LUT, alpha, ld_lut)
+
+    def knn_centroids_inner_product(self, n, xq, k, distances, labels):
+        r""" exact IP search"""
+        return _swigfaiss_avx2.AdditiveQuantizer_knn_centroids_inner_product(self, n, xq, k, distances, labels)
+
+    def compute_centroid_norms(self, norms):
+        r"""
+         For L2 search we need the L2 norms of the centroids
+
+        :type norms: float
+        :param norms:    output norms table, size total_codebook_size
+        """
+        return _swigfaiss_avx2.AdditiveQuantizer_compute_centroid_norms(self, norms)
+
+    def knn_centroids_L2(self, n, xq, k, distances, labels, centroid_norms):
+        r""" Exact L2 search, with precomputed norms"""
+        return _swigfaiss_avx2.AdditiveQuantizer_knn_centroids_L2(self, n, xq, k, distances, labels, centroid_norms)
+    __swig_destroy__ = _swigfaiss_avx2.delete_AdditiveQuantizer
+
+# Register AdditiveQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.AdditiveQuantizer_swigregister(AdditiveQuantizer)
+
+def beam_search_encode_step(*args):
+    r"""
+     Encode a residual by sampling from a centroid table.
+
+    This is a single encoding step the residual quantizer.
+    It allows low-level access to the encoding function, exposed mainly for unit
+    tests.
+
+    :type n: int
+    :param n:              number of vectors to hanlde
+    :type residuals: float
+    :param residuals:      vectors to encode, size (n, beam_size, d)
+    :type cent: float
+    :param cent:           centroids, size (K, d)
+    :type beam_size: int
+    :param beam_size:      input beam size
+    :type m: int
+    :param m:              size of the codes for the previous encoding steps
+    :type codes: int
+    :param codes:          code array for the previous steps of the beam (n,
+        beam_size, m)
+    :type new_beam_size: int
+    :param new_beam_size:  output beam size (should be <= K * beam_size)
+    :type new_codes: int
+    :param new_codes:      output codes, size (n, new_beam_size, m + 1)
+    :type new_residuals: float
+    :param new_residuals:  output residuals, size (n, new_beam_size, d)
+    :type new_distances: float
+    :param new_distances:  output distances, size (n, new_beam_size)
+    :type assign_index: :py:class:`Index`, optional
+    :param assign_index:   if non-NULL, will be used to perform assignment
+    """
+    return _swigfaiss_avx2.beam_search_encode_step(*args)
+
+def beam_search_encode_step_tab(*args):
+    r"""
+     Encode a set of vectors using their dot products with the codebooks
+
+    :type K: int
+    :param K:           number of vectors in the codebook
+    :type n: int
+    :param n:           nb of vectors to encode
+    :type beam_size: int
+    :param beam_size:   input beam size
+    :type codebook_cross_norms: float
+    :param codebook_cross_norms: inner product of this codebook with the m
+                                    previously encoded codebooks
+    :type codebook_offsets: int
+    :param codebook_offsets:     offsets into codebook_cross_norms for each
+                                    previous codebook
+    :type query_cp: float
+    :param query_cp:    dot products of query vectors with ???
+    :type cent_norms_i: float
+    :param cent_norms_i:  norms of centroids
+    """
+    return _swigfaiss_avx2.beam_search_encode_step_tab(*args)
+class RefineBeamMemoryPool(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    new_codes = property(_swigfaiss_avx2.RefineBeamMemoryPool_new_codes_get, _swigfaiss_avx2.RefineBeamMemoryPool_new_codes_set)
+    new_residuals = property(_swigfaiss_avx2.RefineBeamMemoryPool_new_residuals_get, _swigfaiss_avx2.RefineBeamMemoryPool_new_residuals_set)
+    residuals = property(_swigfaiss_avx2.RefineBeamMemoryPool_residuals_get, _swigfaiss_avx2.RefineBeamMemoryPool_residuals_set)
+    codes = property(_swigfaiss_avx2.RefineBeamMemoryPool_codes_get, _swigfaiss_avx2.RefineBeamMemoryPool_codes_set)
+    distances = property(_swigfaiss_avx2.RefineBeamMemoryPool_distances_get, _swigfaiss_avx2.RefineBeamMemoryPool_distances_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.RefineBeamMemoryPool_swiginit(self, _swigfaiss_avx2.new_RefineBeamMemoryPool())
+    __swig_destroy__ = _swigfaiss_avx2.delete_RefineBeamMemoryPool
+
+# Register RefineBeamMemoryPool in _swigfaiss_avx2:
+_swigfaiss_avx2.RefineBeamMemoryPool_swigregister(RefineBeamMemoryPool)
+
+def refine_beam_mp(rq, n, beam_size, x, out_beam_size, out_codes, out_residuals, out_distances, pool):
+    return _swigfaiss_avx2.refine_beam_mp(rq, n, beam_size, x, out_beam_size, out_codes, out_residuals, out_distances, pool)
+class RefineBeamLUTMemoryPool(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    new_codes = property(_swigfaiss_avx2.RefineBeamLUTMemoryPool_new_codes_get, _swigfaiss_avx2.RefineBeamLUTMemoryPool_new_codes_set)
+    new_distances = property(_swigfaiss_avx2.RefineBeamLUTMemoryPool_new_distances_get, _swigfaiss_avx2.RefineBeamLUTMemoryPool_new_distances_set)
+    codes = property(_swigfaiss_avx2.RefineBeamLUTMemoryPool_codes_get, _swigfaiss_avx2.RefineBeamLUTMemoryPool_codes_set)
+    distances = property(_swigfaiss_avx2.RefineBeamLUTMemoryPool_distances_get, _swigfaiss_avx2.RefineBeamLUTMemoryPool_distances_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.RefineBeamLUTMemoryPool_swiginit(self, _swigfaiss_avx2.new_RefineBeamLUTMemoryPool())
+    __swig_destroy__ = _swigfaiss_avx2.delete_RefineBeamLUTMemoryPool
+
+# Register RefineBeamLUTMemoryPool in _swigfaiss_avx2:
+_swigfaiss_avx2.RefineBeamLUTMemoryPool_swigregister(RefineBeamLUTMemoryPool)
+
+def refine_beam_LUT_mp(rq, n, query_norms, query_cp, out_beam_size, out_codes, out_distances, pool):
+    return _swigfaiss_avx2.refine_beam_LUT_mp(rq, n, query_norms, query_cp, out_beam_size, out_codes, out_distances, pool)
+class ComputeCodesAddCentroidsLUT0MemoryPool(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    codes = property(_swigfaiss_avx2.ComputeCodesAddCentroidsLUT0MemoryPool_codes_get, _swigfaiss_avx2.ComputeCodesAddCentroidsLUT0MemoryPool_codes_set)
+    norms = property(_swigfaiss_avx2.ComputeCodesAddCentroidsLUT0MemoryPool_norms_get, _swigfaiss_avx2.ComputeCodesAddCentroidsLUT0MemoryPool_norms_set)
+    distances = property(_swigfaiss_avx2.ComputeCodesAddCentroidsLUT0MemoryPool_distances_get, _swigfaiss_avx2.ComputeCodesAddCentroidsLUT0MemoryPool_distances_set)
+    residuals = property(_swigfaiss_avx2.ComputeCodesAddCentroidsLUT0MemoryPool_residuals_get, _swigfaiss_avx2.ComputeCodesAddCentroidsLUT0MemoryPool_residuals_set)
+    refine_beam_pool = property(_swigfaiss_avx2.ComputeCodesAddCentroidsLUT0MemoryPool_refine_beam_pool_get, _swigfaiss_avx2.ComputeCodesAddCentroidsLUT0MemoryPool_refine_beam_pool_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.ComputeCodesAddCentroidsLUT0MemoryPool_swiginit(self, _swigfaiss_avx2.new_ComputeCodesAddCentroidsLUT0MemoryPool())
+    __swig_destroy__ = _swigfaiss_avx2.delete_ComputeCodesAddCentroidsLUT0MemoryPool
+
+# Register ComputeCodesAddCentroidsLUT0MemoryPool in _swigfaiss_avx2:
+_swigfaiss_avx2.ComputeCodesAddCentroidsLUT0MemoryPool_swigregister(ComputeCodesAddCentroidsLUT0MemoryPool)
+
+def compute_codes_add_centroids_mp_lut0(rq, x, codes_out, n, centroids, pool):
+    return _swigfaiss_avx2.compute_codes_add_centroids_mp_lut0(rq, x, codes_out, n, centroids, pool)
+class ComputeCodesAddCentroidsLUT1MemoryPool(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    codes = property(_swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_codes_get, _swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_codes_set)
+    distances = property(_swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_distances_get, _swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_distances_set)
+    query_norms = property(_swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_query_norms_get, _swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_query_norms_set)
+    query_cp = property(_swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_query_cp_get, _swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_query_cp_set)
+    residuals = property(_swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_residuals_get, _swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_residuals_set)
+    refine_beam_lut_pool = property(_swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_refine_beam_lut_pool_get, _swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_refine_beam_lut_pool_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_swiginit(self, _swigfaiss_avx2.new_ComputeCodesAddCentroidsLUT1MemoryPool())
+    __swig_destroy__ = _swigfaiss_avx2.delete_ComputeCodesAddCentroidsLUT1MemoryPool
+
+# Register ComputeCodesAddCentroidsLUT1MemoryPool in _swigfaiss_avx2:
+_swigfaiss_avx2.ComputeCodesAddCentroidsLUT1MemoryPool_swigregister(ComputeCodesAddCentroidsLUT1MemoryPool)
+
+def compute_codes_add_centroids_mp_lut1(rq, x, codes_out, n, centroids, pool):
+    return _swigfaiss_avx2.compute_codes_add_centroids_mp_lut1(rq, x, codes_out, n, centroids, pool)
+class ResidualQuantizer(AdditiveQuantizer):
+    r"""
+     Residual quantizer with variable number of bits per sub-quantizer
+
+    The residual centroids are stored in a big cumulative centroid table.
+    The codes are represented either as a non-compact table of size (n, M) or
+    as the compact output (n, code_size).
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    train_type = property(_swigfaiss_avx2.ResidualQuantizer_train_type_get, _swigfaiss_avx2.ResidualQuantizer_train_type_set, doc=r""" Binary or of the Train_* flags below""")
+    Train_default = _swigfaiss_avx2.ResidualQuantizer_Train_default
+    r""" regular k-means (minimal amount of computation)"""
+    Train_progressive_dim = _swigfaiss_avx2.ResidualQuantizer_Train_progressive_dim
+    r""" progressive dim clustering (set by default)"""
+    Train_refine_codebook = _swigfaiss_avx2.ResidualQuantizer_Train_refine_codebook
+    r""" do a few iterations of codebook refinement after first level estimation"""
+    niter_codebook_refine = property(_swigfaiss_avx2.ResidualQuantizer_niter_codebook_refine_get, _swigfaiss_avx2.ResidualQuantizer_niter_codebook_refine_set, doc=r""" number of iterations for codebook refinement.""")
+    Train_top_beam = _swigfaiss_avx2.ResidualQuantizer_Train_top_beam
+    r"""
+    set this bit on train_type if beam is to be trained only on the
+    first element of the beam (faster but less accurate)
+    """
+    Skip_codebook_tables = _swigfaiss_avx2.ResidualQuantizer_Skip_codebook_tables
+    r"""
+     set this bit to *not* autmatically compute the codebook tables
+    after training
+    """
+    max_beam_size = property(_swigfaiss_avx2.ResidualQuantizer_max_beam_size_get, _swigfaiss_avx2.ResidualQuantizer_max_beam_size_set, doc=r""" beam size used for training and for encoding""")
+    use_beam_LUT = property(_swigfaiss_avx2.ResidualQuantizer_use_beam_LUT_get, _swigfaiss_avx2.ResidualQuantizer_use_beam_LUT_set, doc=r""" use LUT for beam search""")
+    approx_topk_mode = property(_swigfaiss_avx2.ResidualQuantizer_approx_topk_mode_get, _swigfaiss_avx2.ResidualQuantizer_approx_topk_mode_set, doc=r"""
+    Currently used mode of approximate min-k computations.
+    Default value is EXACT_TOPK.
+    """)
+    cp = property(_swigfaiss_avx2.ResidualQuantizer_cp_get, _swigfaiss_avx2.ResidualQuantizer_cp_set, doc=r""" clustering parameters""")
+    assign_index_factory = property(_swigfaiss_avx2.ResidualQuantizer_assign_index_factory_get, _swigfaiss_avx2.ResidualQuantizer_assign_index_factory_set, doc=r""" if non-NULL, use this index for assignment""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.ResidualQuantizer_swiginit(self, _swigfaiss_avx2.new_ResidualQuantizer(*args))
+
+    def train(self, n, x):
+        r""" Train the residual quantizer"""
+        return _swigfaiss_avx2.ResidualQuantizer_train(self, n, x)
+
+    def initialize_from(self, other, skip_M=0):
+        r""" Copy the M codebook levels from other, starting from skip_M"""
+        return _swigfaiss_avx2.ResidualQuantizer_initialize_from(self, other, skip_M)
+
+    def retrain_AQ_codebook(self, n, x):
+        r"""
+         Encode the vectors and compute codebook that minimizes the quantization
+        error on these codes
+
+        :type x: float
+        :param x:      training vectors, size n * d
+        :type n: int
+        :param n:      nb of training vectors, n >= total_codebook_size
+        :rtype: float
+        :return: returns quantization error for the new codebook with old
+            codes
+        """
+        return _swigfaiss_avx2.ResidualQuantizer_retrain_AQ_codebook(self, n, x)
+
+    def compute_codes_add_centroids(self, x, codes, n, centroids=None):
+        r"""
+         Encode a set of vectors
+
+        :type x: float
+        :param x:      vectors to encode, size n * d
+        :type codes: uint8_t
+        :param codes:  output codes, size n * code_size
+        :type centroids: float, optional
+        :param centroids:  centroids to be added to x, size n * d
+        """
+        return _swigfaiss_avx2.ResidualQuantizer_compute_codes_add_centroids(self, x, codes, n, centroids)
+
+    def refine_beam(self, n, beam_size, residuals, new_beam_size, new_codes, new_residuals=None, new_distances=None):
+        r"""
+         lower-level encode function
+
+        :type n: int
+        :param n:              number of vectors to hanlde
+        :type residuals: float
+        :param residuals:      vectors to encode, size (n, beam_size, d)
+        :type beam_size: int
+        :param beam_size:      input beam size
+        :type new_beam_size: int
+        :param new_beam_size:  output beam size (should be <= K * beam_size)
+        :type new_codes: int
+        :param new_codes:      output codes, size (n, new_beam_size, m + 1)
+        :type new_residuals: float, optional
+        :param new_residuals:  output residuals, size (n, new_beam_size, d)
+        :type new_distances: float, optional
+        :param new_distances:  output distances, size (n, new_beam_size)
+        """
+        return _swigfaiss_avx2.ResidualQuantizer_refine_beam(self, n, beam_size, residuals, new_beam_size, new_codes, new_residuals, new_distances)
+
+    def refine_beam_LUT(self, n, query_norms, query_cp, new_beam_size, new_codes, new_distances=None):
+        return _swigfaiss_avx2.ResidualQuantizer_refine_beam_LUT(self, n, query_norms, query_cp, new_beam_size, new_codes, new_distances)
+
+    def memory_per_point(self, beam_size=-1):
+        r"""
+         Beam search can consume a lot of memory. This function estimates the
+        amount of mem used by refine_beam to adjust the batch size
+
+        :type beam_size: int, optional
+        :param beam_size:  if != -1, override the beam size
+        """
+        return _swigfaiss_avx2.ResidualQuantizer_memory_per_point(self, beam_size)
+
+    def compute_codebook_tables(self):
+        r""" Cross products used in codebook tables used for beam_LUT = 1"""
+        return _swigfaiss_avx2.ResidualQuantizer_compute_codebook_tables(self)
+    codebook_cross_products = property(_swigfaiss_avx2.ResidualQuantizer_codebook_cross_products_get, _swigfaiss_avx2.ResidualQuantizer_codebook_cross_products_set, doc=r"""
+    dot products of all codebook entries with the previous codebooks
+    size sum(codebook_offsets[m] * 2^nbits[m], m=0..M-1)
+    """)
+    cent_norms = property(_swigfaiss_avx2.ResidualQuantizer_cent_norms_get, _swigfaiss_avx2.ResidualQuantizer_cent_norms_set, doc=r""" norms of all codebook entries (size total_codebook_size)""")
+    __swig_destroy__ = _swigfaiss_avx2.delete_ResidualQuantizer
+
+# Register ResidualQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.ResidualQuantizer_swigregister(ResidualQuantizer)
+class LocalSearchQuantizer(AdditiveQuantizer):
+    r"""
+     Implementation of LSQ/LSQ++ described in the following two papers:
+
+    Revisiting additive quantization
+    Julieta Martinez, et al. ECCV 2016
+
+    LSQ++: Lower running time and higher recall in multi-codebook quantization
+    Julieta Martinez, et al. ECCV 2018
+
+    This implementation is mostly translated from the Julia implementations
+    by Julieta Martinez:
+    (https://github.com/una-dinosauria/local-search-quantization,
+     https://github.com/una-dinosauria/Rayuela.jl)
+
+    The trained codes are stored in `codebooks` which is called
+    `centroids` in PQ and RQ.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    K = property(_swigfaiss_avx2.LocalSearchQuantizer_K_get, _swigfaiss_avx2.LocalSearchQuantizer_K_set, doc=r""" number of codes per codebook""")
+    train_iters = property(_swigfaiss_avx2.LocalSearchQuantizer_train_iters_get, _swigfaiss_avx2.LocalSearchQuantizer_train_iters_set, doc=r""" number of iterations in training""")
+    encode_ils_iters = property(_swigfaiss_avx2.LocalSearchQuantizer_encode_ils_iters_get, _swigfaiss_avx2.LocalSearchQuantizer_encode_ils_iters_set, doc=r""" iterations of local search in encoding""")
+    train_ils_iters = property(_swigfaiss_avx2.LocalSearchQuantizer_train_ils_iters_get, _swigfaiss_avx2.LocalSearchQuantizer_train_ils_iters_set, doc=r""" iterations of local search in training""")
+    icm_iters = property(_swigfaiss_avx2.LocalSearchQuantizer_icm_iters_get, _swigfaiss_avx2.LocalSearchQuantizer_icm_iters_set, doc=r""" number of iterations in icm""")
+    p = property(_swigfaiss_avx2.LocalSearchQuantizer_p_get, _swigfaiss_avx2.LocalSearchQuantizer_p_set, doc=r""" temperature factor""")
+    lambd = property(_swigfaiss_avx2.LocalSearchQuantizer_lambd_get, _swigfaiss_avx2.LocalSearchQuantizer_lambd_set, doc=r""" regularization factor""")
+    chunk_size = property(_swigfaiss_avx2.LocalSearchQuantizer_chunk_size_get, _swigfaiss_avx2.LocalSearchQuantizer_chunk_size_set, doc=r""" nb of vectors to encode at a time""")
+    random_seed = property(_swigfaiss_avx2.LocalSearchQuantizer_random_seed_get, _swigfaiss_avx2.LocalSearchQuantizer_random_seed_set, doc=r""" seed for random generator""")
+    nperts = property(_swigfaiss_avx2.LocalSearchQuantizer_nperts_get, _swigfaiss_avx2.LocalSearchQuantizer_nperts_set, doc=r"""
+    number of perturbation in each code
+    if non-NULL, use this encoder to encode (owned by the object)
+    """)
+    icm_encoder_factory = property(_swigfaiss_avx2.LocalSearchQuantizer_icm_encoder_factory_get, _swigfaiss_avx2.LocalSearchQuantizer_icm_encoder_factory_set)
+    update_codebooks_with_double = property(_swigfaiss_avx2.LocalSearchQuantizer_update_codebooks_with_double_get, _swigfaiss_avx2.LocalSearchQuantizer_update_codebooks_with_double_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.LocalSearchQuantizer_swiginit(self, _swigfaiss_avx2.new_LocalSearchQuantizer(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_LocalSearchQuantizer
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.LocalSearchQuantizer_train(self, n, x)
+
+    def compute_codes_add_centroids(self, x, codes, n, centroids=None):
+        r"""
+         Encode a set of vectors
+
+        :type x: float
+        :param x:      vectors to encode, size n * d
+        :type codes: uint8_t
+        :param codes:  output codes, size n * code_size
+        :type n: int
+        :param n:      number of vectors
+        :type centroids: float, optional
+        :param centroids:  centroids to be added to x, size n * d
+        """
+        return _swigfaiss_avx2.LocalSearchQuantizer_compute_codes_add_centroids(self, x, codes, n, centroids)
+
+    def update_codebooks(self, x, codes, n):
+        r"""
+         Update codebooks given encodings
+
+        :type x: float
+        :param x:      training vectors, size n * d
+        :type codes: int
+        :param codes:  encoded training vectors, size n * M
+        :type n: int
+        :param n:      number of vectors
+        """
+        return _swigfaiss_avx2.LocalSearchQuantizer_update_codebooks(self, x, codes, n)
+
+    def icm_encode(self, codes, x, n, ils_iters, gen):
+        r"""
+         Encode vectors given codebooks using iterative conditional mode (icm).
+
+        :type codes: int
+        :param codes:     output codes, size n * M
+        :type x: float
+        :param x:         vectors to encode, size n * d
+        :type n: int
+        :param n:         number of vectors
+        :type ils_iters: int
+        :param ils_iters: number of iterations of iterative local search
+        """
+        return _swigfaiss_avx2.LocalSearchQuantizer_icm_encode(self, codes, x, n, ils_iters, gen)
+
+    def icm_encode_impl(self, codes, x, unaries, gen, n, ils_iters, verbose):
+        return _swigfaiss_avx2.LocalSearchQuantizer_icm_encode_impl(self, codes, x, unaries, gen, n, ils_iters, verbose)
+
+    def icm_encode_step(self, codes, unaries, binaries, n, n_iters):
+        return _swigfaiss_avx2.LocalSearchQuantizer_icm_encode_step(self, codes, unaries, binaries, n, n_iters)
+
+    def perturb_codes(self, codes, n, gen):
+        r"""
+         Add some perturbation to codes
+
+        :type codes: int
+        :param codes: codes to be perturbed, size n * M
+        :type n: int
+        :param n:     number of vectors
+        """
+        return _swigfaiss_avx2.LocalSearchQuantizer_perturb_codes(self, codes, n, gen)
+
+    def perturb_codebooks(self, T, stddev, gen):
+        r"""
+         Add some perturbation to codebooks
+
+        :type T: float
+        :param T:         temperature of simulated annealing
+        :type stddev: std::vector< float >
+        :param stddev:    standard derivations of each dimension in training data
+        """
+        return _swigfaiss_avx2.LocalSearchQuantizer_perturb_codebooks(self, T, stddev, gen)
+
+    def compute_binary_terms(self, binaries):
+        r"""
+         Compute binary terms
+
+        :type binaries: float
+        :param binaries: binary terms, size M * M * K * K
+        """
+        return _swigfaiss_avx2.LocalSearchQuantizer_compute_binary_terms(self, binaries)
+
+    def compute_unary_terms(self, x, unaries, n):
+        r"""
+         Compute unary terms
+
+        :type n: int
+        :param n:       number of vectors
+        :type x: float
+        :param x:       vectors to encode, size n * d
+        :type unaries: float
+        :param unaries: unary terms, size n * M * K
+        """
+        return _swigfaiss_avx2.LocalSearchQuantizer_compute_unary_terms(self, x, unaries, n)
+
+    def evaluate(self, codes, x, n, objs=None):
+        r"""
+         Helper function to compute reconstruction error
+
+        :type codes: int
+        :param codes: encoded codes, size n * M
+        :type x: float
+        :param x:     vectors to encode, size n * d
+        :type n: int
+        :param n:     number of vectors
+        :type objs: float, optional
+        :param objs:  if it is not null, store reconstruction
+                                error of each vector into it, size n
+        """
+        return _swigfaiss_avx2.LocalSearchQuantizer_evaluate(self, codes, x, n, objs)
+
+# Register LocalSearchQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.LocalSearchQuantizer_swigregister(LocalSearchQuantizer)
+class IcmEncoder(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    binaries = property(_swigfaiss_avx2.IcmEncoder_binaries_get, _swigfaiss_avx2.IcmEncoder_binaries_set)
+    verbose = property(_swigfaiss_avx2.IcmEncoder_verbose_get, _swigfaiss_avx2.IcmEncoder_verbose_set)
+    lsq = property(_swigfaiss_avx2.IcmEncoder_lsq_get, _swigfaiss_avx2.IcmEncoder_lsq_set)
+
+    def __init__(self, lsq):
+        _swigfaiss_avx2.IcmEncoder_swiginit(self, _swigfaiss_avx2.new_IcmEncoder(lsq))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IcmEncoder
+
+    def set_binary_term(self):
+        return _swigfaiss_avx2.IcmEncoder_set_binary_term(self)
+
+    def encode(self, codes, x, gen, n, ils_iters):
+        r"""
+         Encode vectors given codebooks
+
+        :type codes: int
+        :param codes:     output codes, size n * M
+        :type x: float
+        :param x:         vectors to encode, size n * d
+        :type gen: std::mt19937
+        :param gen:       random generator
+        :type n: int
+        :param n:         number of vectors
+        :type ils_iters: int
+        :param ils_iters: number of iterations of iterative local search
+        """
+        return _swigfaiss_avx2.IcmEncoder_encode(self, codes, x, gen, n, ils_iters)
+
+# Register IcmEncoder in _swigfaiss_avx2:
+_swigfaiss_avx2.IcmEncoder_swigregister(IcmEncoder)
+class IcmEncoderFactory(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def get(self, lsq):
+        return _swigfaiss_avx2.IcmEncoderFactory_get(self, lsq)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IcmEncoderFactory
+
+    def __init__(self):
+        _swigfaiss_avx2.IcmEncoderFactory_swiginit(self, _swigfaiss_avx2.new_IcmEncoderFactory())
+
+# Register IcmEncoderFactory in _swigfaiss_avx2:
+_swigfaiss_avx2.IcmEncoderFactory_swigregister(IcmEncoderFactory)
+class LSQTimer(object):
+    r"""
+    A helper struct to count consuming time during training.
+    It is NOT thread-safe.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    t = property(_swigfaiss_avx2.LSQTimer_t_get, _swigfaiss_avx2.LSQTimer_t_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.LSQTimer_swiginit(self, _swigfaiss_avx2.new_LSQTimer())
+
+    def get(self, name):
+        return _swigfaiss_avx2.LSQTimer_get(self, name)
+
+    def add(self, name, delta):
+        return _swigfaiss_avx2.LSQTimer_add(self, name, delta)
+
+    def reset(self):
+        return _swigfaiss_avx2.LSQTimer_reset(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_LSQTimer
+
+# Register LSQTimer in _swigfaiss_avx2:
+_swigfaiss_avx2.LSQTimer_swigregister(LSQTimer)
+class LSQTimerScope(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    t0 = property(_swigfaiss_avx2.LSQTimerScope_t0_get, _swigfaiss_avx2.LSQTimerScope_t0_set)
+    timer = property(_swigfaiss_avx2.LSQTimerScope_timer_get, _swigfaiss_avx2.LSQTimerScope_timer_set)
+    name = property(_swigfaiss_avx2.LSQTimerScope_name_get, _swigfaiss_avx2.LSQTimerScope_name_set)
+    finished = property(_swigfaiss_avx2.LSQTimerScope_finished_get, _swigfaiss_avx2.LSQTimerScope_finished_set)
+
+    def __init__(self, timer, name):
+        _swigfaiss_avx2.LSQTimerScope_swiginit(self, _swigfaiss_avx2.new_LSQTimerScope(timer, name))
+
+    def finish(self):
+        return _swigfaiss_avx2.LSQTimerScope_finish(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_LSQTimerScope
+
+# Register LSQTimerScope in _swigfaiss_avx2:
+_swigfaiss_avx2.LSQTimerScope_swigregister(LSQTimerScope)
+class ProductAdditiveQuantizer(AdditiveQuantizer):
+    r"""
+     Product Additive Quantizers
+
+    The product additive quantizer is a variant of AQ and PQ.
+    It first splits the vector space into multiple orthogonal sub-spaces
+    just like PQ does. And then it quantizes each sub-space by an independent
+    additive quantizer.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nsplits = property(_swigfaiss_avx2.ProductAdditiveQuantizer_nsplits_get, _swigfaiss_avx2.ProductAdditiveQuantizer_nsplits_set, doc=r""" number of sub-vectors we split a vector into""")
+    quantizers = property(_swigfaiss_avx2.ProductAdditiveQuantizer_quantizers_get, _swigfaiss_avx2.ProductAdditiveQuantizer_quantizers_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.ProductAdditiveQuantizer_swiginit(self, _swigfaiss_avx2.new_ProductAdditiveQuantizer(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_ProductAdditiveQuantizer
+
+    def init(self, d, aqs, search_type):
+        return _swigfaiss_avx2.ProductAdditiveQuantizer_init(self, d, aqs, search_type)
+
+    def subquantizer(self, m):
+        r""" Train the product additive quantizer"""
+        return _swigfaiss_avx2.ProductAdditiveQuantizer_subquantizer(self, m)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.ProductAdditiveQuantizer_train(self, n, x)
+
+    def compute_codes_add_centroids(self, x, codes, n, centroids=None):
+        r"""
+         Encode a set of vectors
+
+        :type x: float
+        :param x:      vectors to encode, size n * d
+        :type codes: uint8_t
+        :param codes:  output codes, size n * code_size
+        :type centroids: float, optional
+        :param centroids:  centroids to be added to x, size n * d
+        """
+        return _swigfaiss_avx2.ProductAdditiveQuantizer_compute_codes_add_centroids(self, x, codes, n, centroids)
+
+    def compute_unpacked_codes(self, x, codes, n, centroids=None):
+        return _swigfaiss_avx2.ProductAdditiveQuantizer_compute_unpacked_codes(self, x, codes, n, centroids)
+
+    def decode_unpacked(self, codes, x, n, ld_codes=-1):
+        r"""
+         Decode a set of vectors in non-packed format
+
+        :type codes: int
+        :param codes:  codes to decode, size n * ld_codes
+        :type x: float
+        :param x:      output vectors, size n * d
+        """
+        return _swigfaiss_avx2.ProductAdditiveQuantizer_decode_unpacked(self, codes, x, n, ld_codes)
+
+    def decode(self, codes, x, n):
+        r"""
+         Decode a set of vectors
+
+        :type codes: uint8_t
+        :param codes:  codes to decode, size n * code_size
+        :type x: float
+        :param x:      output vectors, size n * d
+        """
+        return _swigfaiss_avx2.ProductAdditiveQuantizer_decode(self, codes, x, n)
+
+    def compute_LUT(self, n, xq, LUT, alpha=1.0, ld_lut=-1):
+        r"""
+         Compute inner-product look-up tables. Used in the search functions.
+
+        :type xq: float
+        :param xq:     query vector, size (n, d)
+        :type LUT: float
+        :param LUT:    look-up table, size (n, total_codebook_size)
+        :type alpha: float, optional
+        :param alpha:  compute alpha * inner-product
+        :type ld_lut: int, optional
+        :param ld_lut:  leading dimension of LUT
+        """
+        return _swigfaiss_avx2.ProductAdditiveQuantizer_compute_LUT(self, n, xq, LUT, alpha, ld_lut)
+
+# Register ProductAdditiveQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.ProductAdditiveQuantizer_swigregister(ProductAdditiveQuantizer)
+class ProductLocalSearchQuantizer(ProductAdditiveQuantizer):
+    r""" Product Local Search Quantizer"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.ProductLocalSearchQuantizer_swiginit(self, _swigfaiss_avx2.new_ProductLocalSearchQuantizer(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_ProductLocalSearchQuantizer
+
+# Register ProductLocalSearchQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.ProductLocalSearchQuantizer_swigregister(ProductLocalSearchQuantizer)
+class ProductResidualQuantizer(ProductAdditiveQuantizer):
+    r""" Product Residual Quantizer"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.ProductResidualQuantizer_swiginit(self, _swigfaiss_avx2.new_ProductResidualQuantizer(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_ProductResidualQuantizer
+
+# Register ProductResidualQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.ProductResidualQuantizer_swigregister(ProductResidualQuantizer)
+class CodePacker(object):
+    r"""
+    Packing consists in combining a fixed number of codes of constant size
+    (code_size) into a block of data where they may (or may not) be interleaved
+    for efficient consumption by distance computation kernels. This exists for
+    the "fast_scan" indexes on CPU and for some GPU kernels.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    code_size = property(_swigfaiss_avx2.CodePacker_code_size_get, _swigfaiss_avx2.CodePacker_code_size_set)
+    nvec = property(_swigfaiss_avx2.CodePacker_nvec_get, _swigfaiss_avx2.CodePacker_nvec_set)
+    block_size = property(_swigfaiss_avx2.CodePacker_block_size_get, _swigfaiss_avx2.CodePacker_block_size_set)
+
+    def pack_1(self, flat_code, offset, block):
+        return _swigfaiss_avx2.CodePacker_pack_1(self, flat_code, offset, block)
+
+    def unpack_1(self, block, offset, flat_code):
+        return _swigfaiss_avx2.CodePacker_unpack_1(self, block, offset, flat_code)
+
+    def pack_all(self, flat_codes, block):
+        return _swigfaiss_avx2.CodePacker_pack_all(self, flat_codes, block)
+
+    def unpack_all(self, block, flat_codes):
+        return _swigfaiss_avx2.CodePacker_unpack_all(self, block, flat_codes)
+    __swig_destroy__ = _swigfaiss_avx2.delete_CodePacker
+
+# Register CodePacker in _swigfaiss_avx2:
+_swigfaiss_avx2.CodePacker_swigregister(CodePacker)
+class CodePackerFlat(CodePacker):
+    r""" Trivial code packer where codes are stored one by one"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, code_size):
+        _swigfaiss_avx2.CodePackerFlat_swiginit(self, _swigfaiss_avx2.new_CodePackerFlat(code_size))
+
+    def pack_1(self, flat_code, offset, block):
+        return _swigfaiss_avx2.CodePackerFlat_pack_1(self, flat_code, offset, block)
+
+    def unpack_1(self, block, offset, flat_code):
+        return _swigfaiss_avx2.CodePackerFlat_unpack_1(self, block, offset, flat_code)
+
+    def pack_all(self, flat_codes, block):
+        return _swigfaiss_avx2.CodePackerFlat_pack_all(self, flat_codes, block)
+
+    def unpack_all(self, block, flat_codes):
+        return _swigfaiss_avx2.CodePackerFlat_unpack_all(self, block, flat_codes)
+    __swig_destroy__ = _swigfaiss_avx2.delete_CodePackerFlat
+
+# Register CodePackerFlat in _swigfaiss_avx2:
+_swigfaiss_avx2.CodePackerFlat_swigregister(CodePackerFlat)
+class VectorTransform(object):
+    r""" Any transformation applied on a set of vectors"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    d_in = property(_swigfaiss_avx2.VectorTransform_d_in_get, _swigfaiss_avx2.VectorTransform_d_in_set)
+    d_out = property(_swigfaiss_avx2.VectorTransform_d_out_get, _swigfaiss_avx2.VectorTransform_d_out_set, doc=r"""input dimension""")
+    is_trained = property(_swigfaiss_avx2.VectorTransform_is_trained_get, _swigfaiss_avx2.VectorTransform_is_trained_set, doc=r"""
+    set if the VectorTransform does not require training, or if
+    training is done already
+    """)
+
+    def train(self, n, x):
+        r"""
+         Perform training on a representative set of vectors. Does
+        nothing by default.
+
+        :type n: int
+        :param n:      nb of training vectors
+        :type x: float
+        :param x:      training vecors, size n * d
+        """
+        return _swigfaiss_avx2.VectorTransform_train(self, n, x)
+
+    def apply(self, n, x):
+        r"""
+         apply the transformation and return the result in an allocated pointer
+        :type n: int
+        :param n: number of vectors to transform
+        :type x: float
+        :param x: input vectors, size n * d_in
+        :rtype: float
+        :return: output vectors, size n * d_out
+        """
+        return _swigfaiss_avx2.VectorTransform_apply(self, n, x)
+
+    def apply_noalloc(self, n, x, xt):
+        r"""
+         apply the transformation and return the result in a provided matrix
+        :type n: int
+        :param n: number of vectors to transform
+        :type x: float
+        :param x: input vectors, size n * d_in
+        :type xt: float
+        :param xt: output vectors, size n * d_out
+        """
+        return _swigfaiss_avx2.VectorTransform_apply_noalloc(self, n, x, xt)
+
+    def reverse_transform(self, n, xt, x):
+        r"""
+        reverse transformation. May not be implemented or may return
+        approximate result
+        """
+        return _swigfaiss_avx2.VectorTransform_reverse_transform(self, n, xt, x)
+
+    def check_identical(self, other):
+        return _swigfaiss_avx2.VectorTransform_check_identical(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_VectorTransform
+
+# Register VectorTransform in _swigfaiss_avx2:
+_swigfaiss_avx2.VectorTransform_swigregister(VectorTransform)
+class LinearTransform(VectorTransform):
+    r"""
+     Generic linear transformation, with bias term applied on output
+    y = A * x + b
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    have_bias = property(_swigfaiss_avx2.LinearTransform_have_bias_get, _swigfaiss_avx2.LinearTransform_have_bias_set)
+    is_orthonormal = property(_swigfaiss_avx2.LinearTransform_is_orthonormal_get, _swigfaiss_avx2.LinearTransform_is_orthonormal_set, doc=r"""
+    whether to use the bias term
+     check if matrix A is orthonormal (enables reverse_transform)
+    """)
+    A = property(_swigfaiss_avx2.LinearTransform_A_get, _swigfaiss_avx2.LinearTransform_A_set, doc=r""" Transformation matrix, size d_out * d_in""")
+    b = property(_swigfaiss_avx2.LinearTransform_b_get, _swigfaiss_avx2.LinearTransform_b_set, doc=r""" bias vector, size d_out""")
+
+    def __init__(self, d_in=0, d_out=0, have_bias=False):
+        r""" both d_in > d_out and d_out < d_in are supported"""
+        _swigfaiss_avx2.LinearTransform_swiginit(self, _swigfaiss_avx2.new_LinearTransform(d_in, d_out, have_bias))
+
+    def apply_noalloc(self, n, x, xt):
+        r""" same as apply, but result is pre-allocated"""
+        return _swigfaiss_avx2.LinearTransform_apply_noalloc(self, n, x, xt)
+
+    def transform_transpose(self, n, y, x):
+        r"""
+        compute x = A^T * (x - b)
+        is reverse transform if A has orthonormal lines
+        """
+        return _swigfaiss_avx2.LinearTransform_transform_transpose(self, n, y, x)
+
+    def reverse_transform(self, n, xt, x):
+        r""" works only if is_orthonormal"""
+        return _swigfaiss_avx2.LinearTransform_reverse_transform(self, n, xt, x)
+
+    def set_is_orthonormal(self):
+        r""" compute A^T * A to set the is_orthonormal flag"""
+        return _swigfaiss_avx2.LinearTransform_set_is_orthonormal(self)
+    verbose = property(_swigfaiss_avx2.LinearTransform_verbose_get, _swigfaiss_avx2.LinearTransform_verbose_set)
+
+    def print_if_verbose(self, name, mat, n, d):
+        return _swigfaiss_avx2.LinearTransform_print_if_verbose(self, name, mat, n, d)
+
+    def check_identical(self, other):
+        return _swigfaiss_avx2.LinearTransform_check_identical(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_LinearTransform
+
+# Register LinearTransform in _swigfaiss_avx2:
+_swigfaiss_avx2.LinearTransform_swigregister(LinearTransform)
+class RandomRotationMatrix(LinearTransform):
+    r""" Randomly rotate a set of vectors"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def init(self, seed):
+        r""" must be called before the transform is used"""
+        return _swigfaiss_avx2.RandomRotationMatrix_init(self, seed)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.RandomRotationMatrix_train(self, n, x)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.RandomRotationMatrix_swiginit(self, _swigfaiss_avx2.new_RandomRotationMatrix(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_RandomRotationMatrix
+
+# Register RandomRotationMatrix in _swigfaiss_avx2:
+_swigfaiss_avx2.RandomRotationMatrix_swigregister(RandomRotationMatrix)
+class PCAMatrix(LinearTransform):
+    r"""
+    Applies a principal component analysis on a set of vectors,
+    with optionally whitening and random rotation.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    eigen_power = property(_swigfaiss_avx2.PCAMatrix_eigen_power_get, _swigfaiss_avx2.PCAMatrix_eigen_power_set, doc=r"""
+     after transformation the components are multiplied by
+    eigenvalues^eigen_power
+
+    =0: no whitening
+    =-0.5: full whitening
+    """)
+    epsilon = property(_swigfaiss_avx2.PCAMatrix_epsilon_get, _swigfaiss_avx2.PCAMatrix_epsilon_set, doc=r""" value added to eigenvalues to avoid division by 0 when whitening""")
+    random_rotation = property(_swigfaiss_avx2.PCAMatrix_random_rotation_get, _swigfaiss_avx2.PCAMatrix_random_rotation_set, doc=r""" random rotation after PCA""")
+    max_points_per_d = property(_swigfaiss_avx2.PCAMatrix_max_points_per_d_get, _swigfaiss_avx2.PCAMatrix_max_points_per_d_set, doc=r""" ratio between # training vectors and dimension""")
+    balanced_bins = property(_swigfaiss_avx2.PCAMatrix_balanced_bins_get, _swigfaiss_avx2.PCAMatrix_balanced_bins_set, doc=r""" try to distribute output eigenvectors in this many bins""")
+    mean = property(_swigfaiss_avx2.PCAMatrix_mean_get, _swigfaiss_avx2.PCAMatrix_mean_set, doc=r""" Mean, size d_in""")
+    eigenvalues = property(_swigfaiss_avx2.PCAMatrix_eigenvalues_get, _swigfaiss_avx2.PCAMatrix_eigenvalues_set, doc=r""" eigenvalues of covariance matrix (= squared singular values)""")
+    PCAMat = property(_swigfaiss_avx2.PCAMatrix_PCAMat_get, _swigfaiss_avx2.PCAMatrix_PCAMat_set, doc=r""" PCA matrix, size d_in * d_in""")
+
+    def __init__(self, d_in=0, d_out=0, eigen_power=0, random_rotation=False):
+        _swigfaiss_avx2.PCAMatrix_swiginit(self, _swigfaiss_avx2.new_PCAMatrix(d_in, d_out, eigen_power, random_rotation))
+
+    def train(self, n, x):
+        r"""
+        train on n vectors. If n < d_in then the eigenvector matrix
+        will be completed with 0s
+        """
+        return _swigfaiss_avx2.PCAMatrix_train(self, n, x)
+
+    def copy_from(self, other):
+        r""" copy pre-trained PCA matrix"""
+        return _swigfaiss_avx2.PCAMatrix_copy_from(self, other)
+
+    def prepare_Ab(self):
+        r""" called after mean, PCAMat and eigenvalues are computed"""
+        return _swigfaiss_avx2.PCAMatrix_prepare_Ab(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_PCAMatrix
+
+# Register PCAMatrix in _swigfaiss_avx2:
+_swigfaiss_avx2.PCAMatrix_swigregister(PCAMatrix)
+class ITQMatrix(LinearTransform):
+    r"""
+     ITQ implementation from
+
+        Iterative quantization: A procrustean approach to learning binary codes
+        for large-scale image retrieval,
+
+    Yunchao Gong, Svetlana Lazebnik, Albert Gordo, Florent Perronnin,
+    PAMI'12.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    max_iter = property(_swigfaiss_avx2.ITQMatrix_max_iter_get, _swigfaiss_avx2.ITQMatrix_max_iter_set)
+    seed = property(_swigfaiss_avx2.ITQMatrix_seed_get, _swigfaiss_avx2.ITQMatrix_seed_set)
+    init_rotation = property(_swigfaiss_avx2.ITQMatrix_init_rotation_get, _swigfaiss_avx2.ITQMatrix_init_rotation_set)
+
+    def __init__(self, d=0):
+        _swigfaiss_avx2.ITQMatrix_swiginit(self, _swigfaiss_avx2.new_ITQMatrix(d))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.ITQMatrix_train(self, n, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ITQMatrix
+
+# Register ITQMatrix in _swigfaiss_avx2:
+_swigfaiss_avx2.ITQMatrix_swigregister(ITQMatrix)
+class ITQTransform(VectorTransform):
+    r""" The full ITQ transform, including normalizations and PCA transformation"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    mean = property(_swigfaiss_avx2.ITQTransform_mean_get, _swigfaiss_avx2.ITQTransform_mean_set)
+    do_pca = property(_swigfaiss_avx2.ITQTransform_do_pca_get, _swigfaiss_avx2.ITQTransform_do_pca_set)
+    itq = property(_swigfaiss_avx2.ITQTransform_itq_get, _swigfaiss_avx2.ITQTransform_itq_set)
+    max_train_per_dim = property(_swigfaiss_avx2.ITQTransform_max_train_per_dim_get, _swigfaiss_avx2.ITQTransform_max_train_per_dim_set, doc=r""" max training points per dimension""")
+    pca_then_itq = property(_swigfaiss_avx2.ITQTransform_pca_then_itq_get, _swigfaiss_avx2.ITQTransform_pca_then_itq_set)
+
+    def __init__(self, d_in=0, d_out=0, do_pca=False):
+        _swigfaiss_avx2.ITQTransform_swiginit(self, _swigfaiss_avx2.new_ITQTransform(d_in, d_out, do_pca))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.ITQTransform_train(self, n, x)
+
+    def apply_noalloc(self, n, x, xt):
+        return _swigfaiss_avx2.ITQTransform_apply_noalloc(self, n, x, xt)
+
+    def check_identical(self, other):
+        return _swigfaiss_avx2.ITQTransform_check_identical(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ITQTransform
+
+# Register ITQTransform in _swigfaiss_avx2:
+_swigfaiss_avx2.ITQTransform_swigregister(ITQTransform)
+class OPQMatrix(LinearTransform):
+    r"""
+     Applies a rotation to align the dimensions with a PQ to minimize
+     the reconstruction error. Can be used before an IndexPQ or an
+     IndexIVFPQ. The method is the non-parametric version described in:
+
+    "Optimized Product Quantization for Approximate Nearest Neighbor Search"
+    Tiezheng Ge, Kaiming He, Qifa Ke, Jian Sun, CVPR'13
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    M = property(_swigfaiss_avx2.OPQMatrix_M_get, _swigfaiss_avx2.OPQMatrix_M_set, doc=r""" nb of subquantizers""")
+    niter = property(_swigfaiss_avx2.OPQMatrix_niter_get, _swigfaiss_avx2.OPQMatrix_niter_set, doc=r""" Number of outer training iterations""")
+    niter_pq = property(_swigfaiss_avx2.OPQMatrix_niter_pq_get, _swigfaiss_avx2.OPQMatrix_niter_pq_set, doc=r""" Number of training iterations for the PQ""")
+    niter_pq_0 = property(_swigfaiss_avx2.OPQMatrix_niter_pq_0_get, _swigfaiss_avx2.OPQMatrix_niter_pq_0_set, doc=r""" same, for the first outer iteration""")
+    max_train_points = property(_swigfaiss_avx2.OPQMatrix_max_train_points_get, _swigfaiss_avx2.OPQMatrix_max_train_points_set, doc=r""" if there are too many training points, resample""")
+    verbose = property(_swigfaiss_avx2.OPQMatrix_verbose_get, _swigfaiss_avx2.OPQMatrix_verbose_set)
+    pq = property(_swigfaiss_avx2.OPQMatrix_pq_get, _swigfaiss_avx2.OPQMatrix_pq_set, doc=r"""
+    if non-NULL, use this product quantizer for training
+    should be constructed with (d_out, M, _)
+    """)
+
+    def __init__(self, d=0, M=1, d2=-1):
+        r""" if d2 != -1, output vectors of this dimension"""
+        _swigfaiss_avx2.OPQMatrix_swiginit(self, _swigfaiss_avx2.new_OPQMatrix(d, M, d2))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.OPQMatrix_train(self, n, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_OPQMatrix
+
+# Register OPQMatrix in _swigfaiss_avx2:
+_swigfaiss_avx2.OPQMatrix_swigregister(OPQMatrix)
+class RemapDimensionsTransform(VectorTransform):
+    r"""
+     remap dimensions for intput vectors, possibly inserting 0s
+    strictly speaking this is also a linear transform but we don't want
+    to compute it with matrix multiplies
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    map = property(_swigfaiss_avx2.RemapDimensionsTransform_map_get, _swigfaiss_avx2.RemapDimensionsTransform_map_set, doc=r"""
+    map from output dimension to input, size d_out
+    -1 -> set output to 0
+    """)
+
+    def apply_noalloc(self, n, x, xt):
+        return _swigfaiss_avx2.RemapDimensionsTransform_apply_noalloc(self, n, x, xt)
+
+    def reverse_transform(self, n, xt, x):
+        r""" reverse transform correct only when the mapping is a permutation"""
+        return _swigfaiss_avx2.RemapDimensionsTransform_reverse_transform(self, n, xt, x)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.RemapDimensionsTransform_swiginit(self, _swigfaiss_avx2.new_RemapDimensionsTransform(*args))
+
+    def check_identical(self, other):
+        return _swigfaiss_avx2.RemapDimensionsTransform_check_identical(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_RemapDimensionsTransform
+
+# Register RemapDimensionsTransform in _swigfaiss_avx2:
+_swigfaiss_avx2.RemapDimensionsTransform_swigregister(RemapDimensionsTransform)
+class NormalizationTransform(VectorTransform):
+    r""" per-vector normalization"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    norm = property(_swigfaiss_avx2.NormalizationTransform_norm_get, _swigfaiss_avx2.NormalizationTransform_norm_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.NormalizationTransform_swiginit(self, _swigfaiss_avx2.new_NormalizationTransform(*args))
+
+    def apply_noalloc(self, n, x, xt):
+        return _swigfaiss_avx2.NormalizationTransform_apply_noalloc(self, n, x, xt)
+
+    def reverse_transform(self, n, xt, x):
+        r""" Identity transform since norm is not revertible"""
+        return _swigfaiss_avx2.NormalizationTransform_reverse_transform(self, n, xt, x)
+
+    def check_identical(self, other):
+        return _swigfaiss_avx2.NormalizationTransform_check_identical(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_NormalizationTransform
+
+# Register NormalizationTransform in _swigfaiss_avx2:
+_swigfaiss_avx2.NormalizationTransform_swigregister(NormalizationTransform)
+class CenteringTransform(VectorTransform):
+    r""" Subtract the mean of each component from the vectors."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    mean = property(_swigfaiss_avx2.CenteringTransform_mean_get, _swigfaiss_avx2.CenteringTransform_mean_set, doc=r""" Mean, size d_in = d_out""")
+
+    def __init__(self, d=0):
+        _swigfaiss_avx2.CenteringTransform_swiginit(self, _swigfaiss_avx2.new_CenteringTransform(d))
+
+    def train(self, n, x):
+        r""" train on n vectors."""
+        return _swigfaiss_avx2.CenteringTransform_train(self, n, x)
+
+    def apply_noalloc(self, n, x, xt):
+        r""" subtract the mean"""
+        return _swigfaiss_avx2.CenteringTransform_apply_noalloc(self, n, x, xt)
+
+    def reverse_transform(self, n, xt, x):
+        r""" add the mean"""
+        return _swigfaiss_avx2.CenteringTransform_reverse_transform(self, n, xt, x)
+
+    def check_identical(self, other):
+        return _swigfaiss_avx2.CenteringTransform_check_identical(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_CenteringTransform
+
+# Register CenteringTransform in _swigfaiss_avx2:
+_swigfaiss_avx2.CenteringTransform_swigregister(CenteringTransform)
+class SearchParametersPreTransform(SearchParameters):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    index_params = property(_swigfaiss_avx2.SearchParametersPreTransform_index_params_get, _swigfaiss_avx2.SearchParametersPreTransform_index_params_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.SearchParametersPreTransform_swiginit(self, _swigfaiss_avx2.new_SearchParametersPreTransform())
+    __swig_destroy__ = _swigfaiss_avx2.delete_SearchParametersPreTransform
+
+# Register SearchParametersPreTransform in _swigfaiss_avx2:
+_swigfaiss_avx2.SearchParametersPreTransform_swigregister(SearchParametersPreTransform)
+class IndexPreTransform(Index):
+    r"""
+    Index that applies a LinearTransform transform on vectors before
+    handing them over to a sub-index
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    chain = property(_swigfaiss_avx2.IndexPreTransform_chain_get, _swigfaiss_avx2.IndexPreTransform_chain_set)
+    index = property(_swigfaiss_avx2.IndexPreTransform_index_get, _swigfaiss_avx2.IndexPreTransform_index_set, doc=r"""chain of tranforms""")
+    own_fields = property(_swigfaiss_avx2.IndexPreTransform_own_fields_get, _swigfaiss_avx2.IndexPreTransform_own_fields_set, doc=r"""the sub-index""")
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+        whether pointers are deleted in destructor
+
+        |
+
+        *Overload 2:*
+         ltrans is the last transform before the index
+        """
+        _swigfaiss_avx2.IndexPreTransform_swiginit(self, _swigfaiss_avx2.new_IndexPreTransform(*args))
+
+    def prepend_transform(self, ltrans):
+        return _swigfaiss_avx2.IndexPreTransform_prepend_transform(self, ltrans)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexPreTransform_train(self, n, x)
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexPreTransform_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss_avx2.IndexPreTransform_add_with_ids(self, n, x, xids)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexPreTransform_reset(self)
+
+    def remove_ids(self, sel):
+        r""" removes IDs from the index. Not supported by all indexes."""
+        return _swigfaiss_avx2.IndexPreTransform_remove_ids(self, sel)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexPreTransform_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss_avx2.IndexPreTransform_range_search(self, n, x, radius, result, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexPreTransform_reconstruct(self, key, recons)
+
+    def reconstruct_n(self, i0, ni, recons):
+        return _swigfaiss_avx2.IndexPreTransform_reconstruct_n(self, i0, ni, recons)
+
+    def search_and_reconstruct(self, n, x, k, distances, labels, recons, params=None):
+        return _swigfaiss_avx2.IndexPreTransform_search_and_reconstruct(self, n, x, k, distances, labels, recons, params)
+
+    def apply_chain(self, n, x):
+        r"""
+        apply the transforms in the chain. The returned float * may be
+        equal to x, otherwise it should be deallocated.
+        """
+        return _swigfaiss_avx2.IndexPreTransform_apply_chain(self, n, x)
+
+    def reverse_chain(self, n, xt, x):
+        r"""
+        Reverse the transforms in the chain. May not be implemented for
+        all transforms in the chain or may return approximate results.
+        """
+        return _swigfaiss_avx2.IndexPreTransform_reverse_chain(self, n, xt, x)
+
+    def get_distance_computer(self):
+        return _swigfaiss_avx2.IndexPreTransform_get_distance_computer(self)
+
+    def sa_code_size(self):
+        return _swigfaiss_avx2.IndexPreTransform_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss_avx2.IndexPreTransform_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexPreTransform_sa_decode(self, n, bytes, x)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss_avx2.IndexPreTransform_merge_from(self, otherIndex, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss_avx2.IndexPreTransform_check_compatible_for_merge(self, otherIndex)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexPreTransform
+
+# Register IndexPreTransform in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexPreTransform_swigregister(IndexPreTransform)
+class IndexRefineSearchParameters(SearchParameters):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    k_factor = property(_swigfaiss_avx2.IndexRefineSearchParameters_k_factor_get, _swigfaiss_avx2.IndexRefineSearchParameters_k_factor_set)
+    base_index_params = property(_swigfaiss_avx2.IndexRefineSearchParameters_base_index_params_get, _swigfaiss_avx2.IndexRefineSearchParameters_base_index_params_set)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexRefineSearchParameters
+
+    def __init__(self):
+        _swigfaiss_avx2.IndexRefineSearchParameters_swiginit(self, _swigfaiss_avx2.new_IndexRefineSearchParameters())
+
+# Register IndexRefineSearchParameters in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexRefineSearchParameters_swigregister(IndexRefineSearchParameters)
+class IndexRefine(Index):
+    r"""
+    Index that queries in a base_index (a fast one) and refines the
+    results with an exact search, hopefully improving the results.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    base_index = property(_swigfaiss_avx2.IndexRefine_base_index_get, _swigfaiss_avx2.IndexRefine_base_index_set, doc=r""" faster index to pre-select the vectors that should be filtered""")
+    refine_index = property(_swigfaiss_avx2.IndexRefine_refine_index_get, _swigfaiss_avx2.IndexRefine_refine_index_set, doc=r""" refinement index""")
+    own_fields = property(_swigfaiss_avx2.IndexRefine_own_fields_get, _swigfaiss_avx2.IndexRefine_own_fields_set, doc=r""" should the base index be deallocated?""")
+    own_refine_index = property(_swigfaiss_avx2.IndexRefine_own_refine_index_get, _swigfaiss_avx2.IndexRefine_own_refine_index_set, doc=r""" same with the refinement index""")
+    k_factor = property(_swigfaiss_avx2.IndexRefine_k_factor_get, _swigfaiss_avx2.IndexRefine_k_factor_set, doc=r"""
+    factor between k requested in search and the k requested from
+    the base_index (should be >= 1)
+    """)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexRefine_swiginit(self, _swigfaiss_avx2.new_IndexRefine(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexRefine_train(self, n, x)
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexRefine_add(self, n, x)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexRefine_reset(self)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexRefine_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexRefine_reconstruct(self, key, recons)
+
+    def sa_code_size(self):
+        return _swigfaiss_avx2.IndexRefine_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss_avx2.IndexRefine_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        r"""
+        The sa_decode decodes from the index_refine, which is assumed to be more
+        accurate
+        """
+        return _swigfaiss_avx2.IndexRefine_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexRefine
+
+# Register IndexRefine in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexRefine_swigregister(IndexRefine)
+class IndexRefineFlat(IndexRefine):
+    r"""
+     Version where the refinement index is an IndexFlat. It has one additional
+    constructor that takes a table of elements to add to the flat refinement
+    index
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexRefineFlat_swiginit(self, _swigfaiss_avx2.new_IndexRefineFlat(*args))
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexRefineFlat_search(self, n, x, k, distances, labels, params)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexRefineFlat
+
+# Register IndexRefineFlat in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexRefineFlat_swigregister(IndexRefineFlat)
+class IndexLSH(IndexFlatCodes):
+    r""" The sign of each vector component is put in a binary signature"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nbits = property(_swigfaiss_avx2.IndexLSH_nbits_get, _swigfaiss_avx2.IndexLSH_nbits_set, doc=r""" nb of bits per vector""")
+    rotate_data = property(_swigfaiss_avx2.IndexLSH_rotate_data_get, _swigfaiss_avx2.IndexLSH_rotate_data_set, doc=r""" whether to apply a random rotation to input""")
+    train_thresholds = property(_swigfaiss_avx2.IndexLSH_train_thresholds_get, _swigfaiss_avx2.IndexLSH_train_thresholds_set, doc=r""" whether we train thresholds or use 0""")
+    rrot = property(_swigfaiss_avx2.IndexLSH_rrot_get, _swigfaiss_avx2.IndexLSH_rrot_set, doc=r""" optional random rotation""")
+    thresholds = property(_swigfaiss_avx2.IndexLSH_thresholds_get, _swigfaiss_avx2.IndexLSH_thresholds_set, doc=r""" thresholds to compare with""")
+
+    def apply_preprocess(self, n, x):
+        r"""
+         Preprocesses and resizes the input to the size required to
+        binarize the data
+
+        :type x: float
+        :param x: input vectors, size n * d
+        :rtype: float
+        :return: output vectors, size n * bits. May be the same pointer
+                    as x, otherwise it should be deleted by the caller
+        """
+        return _swigfaiss_avx2.IndexLSH_apply_preprocess(self, n, x)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexLSH_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexLSH_search(self, n, x, k, distances, labels, params)
+
+    def transfer_thresholds(self, vt):
+        r"""
+        transfer the thresholds to a pre-processing stage (and unset
+        train_thresholds)
+        """
+        return _swigfaiss_avx2.IndexLSH_transfer_thresholds(self, vt)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexLSH
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexLSH_swiginit(self, _swigfaiss_avx2.new_IndexLSH(*args))
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss_avx2.IndexLSH_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexLSH_sa_decode(self, n, bytes, x)
+
+# Register IndexLSH in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexLSH_swigregister(IndexLSH)
+class SimulatedAnnealingParameters(object):
+    r""" parameters used for the simulated annealing method"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    init_temperature = property(_swigfaiss_avx2.SimulatedAnnealingParameters_init_temperature_get, _swigfaiss_avx2.SimulatedAnnealingParameters_init_temperature_set)
+    temperature_decay = property(_swigfaiss_avx2.SimulatedAnnealingParameters_temperature_decay_get, _swigfaiss_avx2.SimulatedAnnealingParameters_temperature_decay_set)
+    n_iter = property(_swigfaiss_avx2.SimulatedAnnealingParameters_n_iter_get, _swigfaiss_avx2.SimulatedAnnealingParameters_n_iter_set)
+    n_redo = property(_swigfaiss_avx2.SimulatedAnnealingParameters_n_redo_get, _swigfaiss_avx2.SimulatedAnnealingParameters_n_redo_set)
+    seed = property(_swigfaiss_avx2.SimulatedAnnealingParameters_seed_get, _swigfaiss_avx2.SimulatedAnnealingParameters_seed_set)
+    verbose = property(_swigfaiss_avx2.SimulatedAnnealingParameters_verbose_get, _swigfaiss_avx2.SimulatedAnnealingParameters_verbose_set)
+    only_bit_flips = property(_swigfaiss_avx2.SimulatedAnnealingParameters_only_bit_flips_get, _swigfaiss_avx2.SimulatedAnnealingParameters_only_bit_flips_set)
+    init_random = property(_swigfaiss_avx2.SimulatedAnnealingParameters_init_random_get, _swigfaiss_avx2.SimulatedAnnealingParameters_init_random_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.SimulatedAnnealingParameters_swiginit(self, _swigfaiss_avx2.new_SimulatedAnnealingParameters())
+    __swig_destroy__ = _swigfaiss_avx2.delete_SimulatedAnnealingParameters
+
+# Register SimulatedAnnealingParameters in _swigfaiss_avx2:
+_swigfaiss_avx2.SimulatedAnnealingParameters_swigregister(SimulatedAnnealingParameters)
+class PermutationObjective(object):
+    r""" abstract class for the loss function"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    n = property(_swigfaiss_avx2.PermutationObjective_n_get, _swigfaiss_avx2.PermutationObjective_n_set)
+
+    def compute_cost(self, perm):
+        return _swigfaiss_avx2.PermutationObjective_compute_cost(self, perm)
+
+    def cost_update(self, perm, iw, jw):
+        return _swigfaiss_avx2.PermutationObjective_cost_update(self, perm, iw, jw)
+    __swig_destroy__ = _swigfaiss_avx2.delete_PermutationObjective
+
+# Register PermutationObjective in _swigfaiss_avx2:
+_swigfaiss_avx2.PermutationObjective_swigregister(PermutationObjective)
+class ReproduceDistancesObjective(PermutationObjective):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    dis_weight_factor = property(_swigfaiss_avx2.ReproduceDistancesObjective_dis_weight_factor_get, _swigfaiss_avx2.ReproduceDistancesObjective_dis_weight_factor_set)
+
+    @staticmethod
+    def sqr(x):
+        return _swigfaiss_avx2.ReproduceDistancesObjective_sqr(x)
+
+    def dis_weight(self, x):
+        return _swigfaiss_avx2.ReproduceDistancesObjective_dis_weight(self, x)
+    source_dis = property(_swigfaiss_avx2.ReproduceDistancesObjective_source_dis_get, _swigfaiss_avx2.ReproduceDistancesObjective_source_dis_set, doc=r""" "real" corrected distances (size n^2)""")
+    target_dis = property(_swigfaiss_avx2.ReproduceDistancesObjective_target_dis_get, _swigfaiss_avx2.ReproduceDistancesObjective_target_dis_set, doc=r""" wanted distances (size n^2)""")
+    weights = property(_swigfaiss_avx2.ReproduceDistancesObjective_weights_get, _swigfaiss_avx2.ReproduceDistancesObjective_weights_set, doc=r""" weights for each distance (size n^2)""")
+
+    def get_source_dis(self, i, j):
+        return _swigfaiss_avx2.ReproduceDistancesObjective_get_source_dis(self, i, j)
+
+    def compute_cost(self, perm):
+        return _swigfaiss_avx2.ReproduceDistancesObjective_compute_cost(self, perm)
+
+    def cost_update(self, perm, iw, jw):
+        return _swigfaiss_avx2.ReproduceDistancesObjective_cost_update(self, perm, iw, jw)
+
+    def __init__(self, n, source_dis_in, target_dis_in, dis_weight_factor):
+        _swigfaiss_avx2.ReproduceDistancesObjective_swiginit(self, _swigfaiss_avx2.new_ReproduceDistancesObjective(n, source_dis_in, target_dis_in, dis_weight_factor))
+
+    @staticmethod
+    def compute_mean_stdev(tab, n2, mean_out, stddev_out):
+        return _swigfaiss_avx2.ReproduceDistancesObjective_compute_mean_stdev(tab, n2, mean_out, stddev_out)
+
+    def set_affine_target_dis(self, source_dis_in):
+        return _swigfaiss_avx2.ReproduceDistancesObjective_set_affine_target_dis(self, source_dis_in)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ReproduceDistancesObjective
+
+# Register ReproduceDistancesObjective in _swigfaiss_avx2:
+_swigfaiss_avx2.ReproduceDistancesObjective_swigregister(ReproduceDistancesObjective)
+class SimulatedAnnealingOptimizer(SimulatedAnnealingParameters):
+    r""" Simulated annealing optimization algorithm for permutations."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    obj = property(_swigfaiss_avx2.SimulatedAnnealingOptimizer_obj_get, _swigfaiss_avx2.SimulatedAnnealingOptimizer_obj_set)
+    n = property(_swigfaiss_avx2.SimulatedAnnealingOptimizer_n_get, _swigfaiss_avx2.SimulatedAnnealingOptimizer_n_set, doc=r""" size of the permutation""")
+    logfile = property(_swigfaiss_avx2.SimulatedAnnealingOptimizer_logfile_get, _swigfaiss_avx2.SimulatedAnnealingOptimizer_logfile_set)
+
+    def __init__(self, obj, p):
+        r""" logs values of the cost function"""
+        _swigfaiss_avx2.SimulatedAnnealingOptimizer_swiginit(self, _swigfaiss_avx2.new_SimulatedAnnealingOptimizer(obj, p))
+    rnd = property(_swigfaiss_avx2.SimulatedAnnealingOptimizer_rnd_get, _swigfaiss_avx2.SimulatedAnnealingOptimizer_rnd_set)
+    init_cost = property(_swigfaiss_avx2.SimulatedAnnealingOptimizer_init_cost_get, _swigfaiss_avx2.SimulatedAnnealingOptimizer_init_cost_set, doc=r""" remember initial cost of optimization""")
+
+    def optimize(self, perm):
+        return _swigfaiss_avx2.SimulatedAnnealingOptimizer_optimize(self, perm)
+
+    def run_optimization(self, best_perm):
+        return _swigfaiss_avx2.SimulatedAnnealingOptimizer_run_optimization(self, best_perm)
+    __swig_destroy__ = _swigfaiss_avx2.delete_SimulatedAnnealingOptimizer
+
+# Register SimulatedAnnealingOptimizer in _swigfaiss_avx2:
+_swigfaiss_avx2.SimulatedAnnealingOptimizer_swigregister(SimulatedAnnealingOptimizer)
+class PolysemousTraining(SimulatedAnnealingParameters):
+    r""" optimizes the order of indices in a ProductQuantizer"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    OT_None = _swigfaiss_avx2.PolysemousTraining_OT_None
+    OT_ReproduceDistances_affine = _swigfaiss_avx2.PolysemousTraining_OT_ReproduceDistances_affine
+    r""" default"""
+    OT_Ranking_weighted_diff = _swigfaiss_avx2.PolysemousTraining_OT_Ranking_weighted_diff
+    r"""
+    same as _2, but use rank of y+ - rank of
+    y-
+    """
+    optimization_type = property(_swigfaiss_avx2.PolysemousTraining_optimization_type_get, _swigfaiss_avx2.PolysemousTraining_optimization_type_set)
+    ntrain_permutation = property(_swigfaiss_avx2.PolysemousTraining_ntrain_permutation_get, _swigfaiss_avx2.PolysemousTraining_ntrain_permutation_set, doc=r"""
+     use 1/4 of the training points for the optimization, with
+    max. ntrain_permutation. If ntrain_permutation == 0: train on
+    centroids
+    """)
+    dis_weight_factor = property(_swigfaiss_avx2.PolysemousTraining_dis_weight_factor_get, _swigfaiss_avx2.PolysemousTraining_dis_weight_factor_set, doc=r""" decay of exp that weights distance loss""")
+    max_memory = property(_swigfaiss_avx2.PolysemousTraining_max_memory_get, _swigfaiss_avx2.PolysemousTraining_max_memory_set, doc=r""" refuse to train if it would require more than that amount of RAM""")
+    log_pattern = property(_swigfaiss_avx2.PolysemousTraining_log_pattern_get, _swigfaiss_avx2.PolysemousTraining_log_pattern_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.PolysemousTraining_swiginit(self, _swigfaiss_avx2.new_PolysemousTraining())
+
+    def optimize_pq_for_hamming(self, pq, n, x):
+        r"""
+        reorder the centroids so that the Hamming distance becomes a
+        good approximation of the SDC distance (called by train)
+        """
+        return _swigfaiss_avx2.PolysemousTraining_optimize_pq_for_hamming(self, pq, n, x)
+
+    def optimize_ranking(self, pq, n, x):
+        r""" called by optimize_pq_for_hamming"""
+        return _swigfaiss_avx2.PolysemousTraining_optimize_ranking(self, pq, n, x)
+
+    def optimize_reproduce_distances(self, pq):
+        r""" called by optimize_pq_for_hamming"""
+        return _swigfaiss_avx2.PolysemousTraining_optimize_reproduce_distances(self, pq)
+
+    def memory_usage_per_thread(self, pq):
+        r""" make sure we don't blow up the memory"""
+        return _swigfaiss_avx2.PolysemousTraining_memory_usage_per_thread(self, pq)
+    __swig_destroy__ = _swigfaiss_avx2.delete_PolysemousTraining
+
+# Register PolysemousTraining in _swigfaiss_avx2:
+_swigfaiss_avx2.PolysemousTraining_swigregister(PolysemousTraining)
+class IndexPQ(IndexFlatCodes):
+    r"""
+     Index based on a product quantizer. Stored vectors are
+    approximated by PQ codes.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    pq = property(_swigfaiss_avx2.IndexPQ_pq_get, _swigfaiss_avx2.IndexPQ_pq_set, doc=r""" The product quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexPQ_swiginit(self, _swigfaiss_avx2.new_IndexPQ(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexPQ_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexPQ_search(self, n, x, k, distances, labels, params)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss_avx2.IndexPQ_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexPQ_sa_decode(self, n, bytes, x)
+
+    def get_FlatCodesDistanceComputer(self):
+        return _swigfaiss_avx2.IndexPQ_get_FlatCodesDistanceComputer(self)
+    do_polysemous_training = property(_swigfaiss_avx2.IndexPQ_do_polysemous_training_get, _swigfaiss_avx2.IndexPQ_do_polysemous_training_set, doc=r""" false = standard PQ""")
+    polysemous_training = property(_swigfaiss_avx2.IndexPQ_polysemous_training_get, _swigfaiss_avx2.IndexPQ_polysemous_training_set, doc=r""" parameters used for the polysemous training""")
+    ST_PQ = _swigfaiss_avx2.IndexPQ_ST_PQ
+    r""" asymmetric product quantizer (default)"""
+    ST_HE = _swigfaiss_avx2.IndexPQ_ST_HE
+    r""" Hamming distance on codes"""
+    ST_generalized_HE = _swigfaiss_avx2.IndexPQ_ST_generalized_HE
+    r""" nb of same codes"""
+    ST_SDC = _swigfaiss_avx2.IndexPQ_ST_SDC
+    r""" symmetric product quantizer (SDC)"""
+    ST_polysemous = _swigfaiss_avx2.IndexPQ_ST_polysemous
+    r""" HE filter (using ht) + PQ combination"""
+    ST_polysemous_generalize = _swigfaiss_avx2.IndexPQ_ST_polysemous_generalize
+    r""" Filter on generalized Hamming"""
+    search_type = property(_swigfaiss_avx2.IndexPQ_search_type_get, _swigfaiss_avx2.IndexPQ_search_type_set)
+    encode_signs = property(_swigfaiss_avx2.IndexPQ_encode_signs_get, _swigfaiss_avx2.IndexPQ_encode_signs_set)
+    polysemous_ht = property(_swigfaiss_avx2.IndexPQ_polysemous_ht_get, _swigfaiss_avx2.IndexPQ_polysemous_ht_set, doc=r""" Hamming threshold used for polysemy""")
+
+    def search_core_polysemous(self, n, x, k, distances, labels, polysemous_ht, generalized_hamming):
+        return _swigfaiss_avx2.IndexPQ_search_core_polysemous(self, n, x, k, distances, labels, polysemous_ht, generalized_hamming)
+
+    def hamming_distance_histogram(self, n, x, nb, xb, dist_histogram):
+        r"""
+        prepare query for a polysemous search, but instead of
+        computing the result, just get the histogram of Hamming
+        distances. May be computed on a provided dataset if xb != NULL
+        :type dist_histogram: int
+        :param dist_histogram: (M * nbits + 1)
+        """
+        return _swigfaiss_avx2.IndexPQ_hamming_distance_histogram(self, n, x, nb, xb, dist_histogram)
+
+    def hamming_distance_table(self, n, x, dis):
+        r"""
+         compute pairwise distances between queries and database
+
+        :type n: int
+        :param n:    nb of query vectors
+        :type x: float
+        :param x:    query vector, size n * d
+        :type dis: int
+        :param dis:  output distances, size n * ntotal
+        """
+        return _swigfaiss_avx2.IndexPQ_hamming_distance_table(self, n, x, dis)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexPQ
+
+# Register IndexPQ in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexPQ_swigregister(IndexPQ)
+class SearchParametersPQ(SearchParameters):
+    r""" override search parameters from the class"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    search_type = property(_swigfaiss_avx2.SearchParametersPQ_search_type_get, _swigfaiss_avx2.SearchParametersPQ_search_type_set)
+    polysemous_ht = property(_swigfaiss_avx2.SearchParametersPQ_polysemous_ht_get, _swigfaiss_avx2.SearchParametersPQ_polysemous_ht_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.SearchParametersPQ_swiginit(self, _swigfaiss_avx2.new_SearchParametersPQ())
+    __swig_destroy__ = _swigfaiss_avx2.delete_SearchParametersPQ
+
+# Register SearchParametersPQ in _swigfaiss_avx2:
+_swigfaiss_avx2.SearchParametersPQ_swigregister(SearchParametersPQ)
+class IndexPQStats(object):
+    r"""
+    statistics are robust to internal threading, but not if
+    IndexPQ::search is called by multiple threads
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss_avx2.IndexPQStats_nq_get, _swigfaiss_avx2.IndexPQStats_nq_set)
+    ncode = property(_swigfaiss_avx2.IndexPQStats_ncode_get, _swigfaiss_avx2.IndexPQStats_ncode_set)
+    n_hamming_pass = property(_swigfaiss_avx2.IndexPQStats_n_hamming_pass_get, _swigfaiss_avx2.IndexPQStats_n_hamming_pass_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.IndexPQStats_swiginit(self, _swigfaiss_avx2.new_IndexPQStats())
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexPQStats_reset(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexPQStats
+
+# Register IndexPQStats in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexPQStats_swigregister(IndexPQStats)
+class MultiIndexQuantizer(Index):
+    r"""
+    Quantizer where centroids are virtual: they are the Cartesian
+    product of sub-centroids.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    pq = property(_swigfaiss_avx2.MultiIndexQuantizer_pq_get, _swigfaiss_avx2.MultiIndexQuantizer_pq_set)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.MultiIndexQuantizer_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.MultiIndexQuantizer_search(self, n, x, k, distances, labels, params)
+
+    def add(self, n, x):
+        r""" add and reset will crash at runtime"""
+        return _swigfaiss_avx2.MultiIndexQuantizer_add(self, n, x)
+
+    def reset(self):
+        return _swigfaiss_avx2.MultiIndexQuantizer_reset(self)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.MultiIndexQuantizer_swiginit(self, _swigfaiss_avx2.new_MultiIndexQuantizer(*args))
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.MultiIndexQuantizer_reconstruct(self, key, recons)
+    __swig_destroy__ = _swigfaiss_avx2.delete_MultiIndexQuantizer
+
+# Register MultiIndexQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.MultiIndexQuantizer_swigregister(MultiIndexQuantizer)
+class MultiIndexQuantizer2(MultiIndexQuantizer):
+    r""" MultiIndexQuantizer where the PQ assignmnet is performed by sub-indexes"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    assign_indexes = property(_swigfaiss_avx2.MultiIndexQuantizer2_assign_indexes_get, _swigfaiss_avx2.MultiIndexQuantizer2_assign_indexes_set, doc=r""" M Indexes on d / M dimensions""")
+    own_fields = property(_swigfaiss_avx2.MultiIndexQuantizer2_own_fields_get, _swigfaiss_avx2.MultiIndexQuantizer2_own_fields_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.MultiIndexQuantizer2_swiginit(self, _swigfaiss_avx2.new_MultiIndexQuantizer2(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.MultiIndexQuantizer2_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.MultiIndexQuantizer2_search(self, n, x, k, distances, labels, params)
+    __swig_destroy__ = _swigfaiss_avx2.delete_MultiIndexQuantizer2
+
+# Register MultiIndexQuantizer2 in _swigfaiss_avx2:
+_swigfaiss_avx2.MultiIndexQuantizer2_swigregister(MultiIndexQuantizer2)
+class IndexAdditiveQuantizer(IndexFlatCodes):
+    r""" Abstract class for additive quantizers. The search functions are in common."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    aq = property(_swigfaiss_avx2.IndexAdditiveQuantizer_aq_get, _swigfaiss_avx2.IndexAdditiveQuantizer_aq_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexAdditiveQuantizer_swiginit(self, _swigfaiss_avx2.new_IndexAdditiveQuantizer(*args))
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexAdditiveQuantizer_search(self, n, x, k, distances, labels, params)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss_avx2.IndexAdditiveQuantizer_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexAdditiveQuantizer_sa_decode(self, n, bytes, x)
+
+    def get_FlatCodesDistanceComputer(self):
+        return _swigfaiss_avx2.IndexAdditiveQuantizer_get_FlatCodesDistanceComputer(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexAdditiveQuantizer
+
+# Register IndexAdditiveQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexAdditiveQuantizer_swigregister(IndexAdditiveQuantizer)
+class IndexResidualQuantizer(IndexAdditiveQuantizer):
+    r"""
+     Index based on a residual quantizer. Stored vectors are
+    approximated by residual quantization codes.
+    Can also be used as a codec
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rq = property(_swigfaiss_avx2.IndexResidualQuantizer_rq_get, _swigfaiss_avx2.IndexResidualQuantizer_rq_set, doc=r""" The residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexResidualQuantizer_swiginit(self, _swigfaiss_avx2.new_IndexResidualQuantizer(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexResidualQuantizer_train(self, n, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexResidualQuantizer
+
+# Register IndexResidualQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexResidualQuantizer_swigregister(IndexResidualQuantizer)
+class IndexLocalSearchQuantizer(IndexAdditiveQuantizer):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lsq = property(_swigfaiss_avx2.IndexLocalSearchQuantizer_lsq_get, _swigfaiss_avx2.IndexLocalSearchQuantizer_lsq_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexLocalSearchQuantizer_swiginit(self, _swigfaiss_avx2.new_IndexLocalSearchQuantizer(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexLocalSearchQuantizer_train(self, n, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexLocalSearchQuantizer
+
+# Register IndexLocalSearchQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexLocalSearchQuantizer_swigregister(IndexLocalSearchQuantizer)
+class IndexProductResidualQuantizer(IndexAdditiveQuantizer):
+    r""" Index based on a product residual quantizer."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    prq = property(_swigfaiss_avx2.IndexProductResidualQuantizer_prq_get, _swigfaiss_avx2.IndexProductResidualQuantizer_prq_set, doc=r""" The product residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexProductResidualQuantizer_swiginit(self, _swigfaiss_avx2.new_IndexProductResidualQuantizer(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexProductResidualQuantizer_train(self, n, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexProductResidualQuantizer
+
+# Register IndexProductResidualQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexProductResidualQuantizer_swigregister(IndexProductResidualQuantizer)
+class IndexProductLocalSearchQuantizer(IndexAdditiveQuantizer):
+    r""" Index based on a product local search quantizer."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    plsq = property(_swigfaiss_avx2.IndexProductLocalSearchQuantizer_plsq_get, _swigfaiss_avx2.IndexProductLocalSearchQuantizer_plsq_set, doc=r""" The product local search quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexProductLocalSearchQuantizer_swiginit(self, _swigfaiss_avx2.new_IndexProductLocalSearchQuantizer(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexProductLocalSearchQuantizer_train(self, n, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexProductLocalSearchQuantizer
+
+# Register IndexProductLocalSearchQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexProductLocalSearchQuantizer_swigregister(IndexProductLocalSearchQuantizer)
+class AdditiveCoarseQuantizer(Index):
+    r"""
+     A "virtual" index where the elements are the residual quantizer centroids.
+
+    Intended for use as a coarse quantizer in an IndexIVF.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    aq = property(_swigfaiss_avx2.AdditiveCoarseQuantizer_aq_get, _swigfaiss_avx2.AdditiveCoarseQuantizer_aq_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.AdditiveCoarseQuantizer_swiginit(self, _swigfaiss_avx2.new_AdditiveCoarseQuantizer(*args))
+    centroid_norms = property(_swigfaiss_avx2.AdditiveCoarseQuantizer_centroid_norms_get, _swigfaiss_avx2.AdditiveCoarseQuantizer_centroid_norms_set, doc=r""" norms of centroids, useful for knn-search""")
+
+    def add(self, n, x):
+        r""" N/A"""
+        return _swigfaiss_avx2.AdditiveCoarseQuantizer_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.AdditiveCoarseQuantizer_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.AdditiveCoarseQuantizer_reconstruct(self, key, recons)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.AdditiveCoarseQuantizer_train(self, n, x)
+
+    def reset(self):
+        r""" N/A"""
+        return _swigfaiss_avx2.AdditiveCoarseQuantizer_reset(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_AdditiveCoarseQuantizer
+
+# Register AdditiveCoarseQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.AdditiveCoarseQuantizer_swigregister(AdditiveCoarseQuantizer)
+class SearchParametersResidualCoarseQuantizer(SearchParameters):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    beam_factor = property(_swigfaiss_avx2.SearchParametersResidualCoarseQuantizer_beam_factor_get, _swigfaiss_avx2.SearchParametersResidualCoarseQuantizer_beam_factor_set)
+    __swig_destroy__ = _swigfaiss_avx2.delete_SearchParametersResidualCoarseQuantizer
+
+    def __init__(self):
+        _swigfaiss_avx2.SearchParametersResidualCoarseQuantizer_swiginit(self, _swigfaiss_avx2.new_SearchParametersResidualCoarseQuantizer())
+
+# Register SearchParametersResidualCoarseQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.SearchParametersResidualCoarseQuantizer_swigregister(SearchParametersResidualCoarseQuantizer)
+class ResidualCoarseQuantizer(AdditiveCoarseQuantizer):
+    r"""
+     The ResidualCoarseQuantizer is a bit specialized compared to the
+    default AdditiveCoarseQuantizer because it can use a beam search
+    at search time (slow but may be useful for very large vocabularies)
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rq = property(_swigfaiss_avx2.ResidualCoarseQuantizer_rq_get, _swigfaiss_avx2.ResidualCoarseQuantizer_rq_set, doc=r""" The residual quantizer used to encode the vectors""")
+    beam_factor = property(_swigfaiss_avx2.ResidualCoarseQuantizer_beam_factor_get, _swigfaiss_avx2.ResidualCoarseQuantizer_beam_factor_set, doc=r"""
+    factor between the beam size and the search k
+    if negative, use exact search-to-centroid
+    """)
+
+    def set_beam_factor(self, new_beam_factor):
+        r""" computes centroid norms if required"""
+        return _swigfaiss_avx2.ResidualCoarseQuantizer_set_beam_factor(self, new_beam_factor)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.ResidualCoarseQuantizer_search(self, n, x, k, distances, labels, params)
+
+    def initialize_from(self, other):
+        r"""
+         Copy the M first codebook levels from other. Useful to crop a
+        ResidualQuantizer to its first M quantizers.
+        """
+        return _swigfaiss_avx2.ResidualCoarseQuantizer_initialize_from(self, other)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.ResidualCoarseQuantizer_swiginit(self, _swigfaiss_avx2.new_ResidualCoarseQuantizer(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_ResidualCoarseQuantizer
+
+# Register ResidualCoarseQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.ResidualCoarseQuantizer_swigregister(ResidualCoarseQuantizer)
+class LocalSearchCoarseQuantizer(AdditiveCoarseQuantizer):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lsq = property(_swigfaiss_avx2.LocalSearchCoarseQuantizer_lsq_get, _swigfaiss_avx2.LocalSearchCoarseQuantizer_lsq_set, doc=r""" The residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.LocalSearchCoarseQuantizer_swiginit(self, _swigfaiss_avx2.new_LocalSearchCoarseQuantizer(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_LocalSearchCoarseQuantizer
+
+# Register LocalSearchCoarseQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.LocalSearchCoarseQuantizer_swigregister(LocalSearchCoarseQuantizer)
+class IOReader(object):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    name = property(_swigfaiss_avx2.IOReader_name_get, _swigfaiss_avx2.IOReader_name_set)
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss_avx2.IOReader___call__(self, ptr, size, nitems)
+
+    def fileno(self):
+        return _swigfaiss_avx2.IOReader_fileno(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IOReader
+
+# Register IOReader in _swigfaiss_avx2:
+_swigfaiss_avx2.IOReader_swigregister(IOReader)
+class IOWriter(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    name = property(_swigfaiss_avx2.IOWriter_name_get, _swigfaiss_avx2.IOWriter_name_set)
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss_avx2.IOWriter___call__(self, ptr, size, nitems)
+
+    def fileno(self):
+        return _swigfaiss_avx2.IOWriter_fileno(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IOWriter
+
+# Register IOWriter in _swigfaiss_avx2:
+_swigfaiss_avx2.IOWriter_swigregister(IOWriter)
+class VectorIOReader(IOReader):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    data = property(_swigfaiss_avx2.VectorIOReader_data_get, _swigfaiss_avx2.VectorIOReader_data_set)
+    rp = property(_swigfaiss_avx2.VectorIOReader_rp_get, _swigfaiss_avx2.VectorIOReader_rp_set)
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss_avx2.VectorIOReader___call__(self, ptr, size, nitems)
+
+    def __init__(self):
+        _swigfaiss_avx2.VectorIOReader_swiginit(self, _swigfaiss_avx2.new_VectorIOReader())
+    __swig_destroy__ = _swigfaiss_avx2.delete_VectorIOReader
+
+# Register VectorIOReader in _swigfaiss_avx2:
+_swigfaiss_avx2.VectorIOReader_swigregister(VectorIOReader)
+class VectorIOWriter(IOWriter):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    data = property(_swigfaiss_avx2.VectorIOWriter_data_get, _swigfaiss_avx2.VectorIOWriter_data_set)
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss_avx2.VectorIOWriter___call__(self, ptr, size, nitems)
+
+    def __init__(self):
+        _swigfaiss_avx2.VectorIOWriter_swiginit(self, _swigfaiss_avx2.new_VectorIOWriter())
+    __swig_destroy__ = _swigfaiss_avx2.delete_VectorIOWriter
+
+# Register VectorIOWriter in _swigfaiss_avx2:
+_swigfaiss_avx2.VectorIOWriter_swigregister(VectorIOWriter)
+class FileIOReader(IOReader):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    f = property(_swigfaiss_avx2.FileIOReader_f_get, _swigfaiss_avx2.FileIOReader_f_set)
+    need_close = property(_swigfaiss_avx2.FileIOReader_need_close_get, _swigfaiss_avx2.FileIOReader_need_close_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.FileIOReader_swiginit(self, _swigfaiss_avx2.new_FileIOReader(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_FileIOReader
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss_avx2.FileIOReader___call__(self, ptr, size, nitems)
+
+    def fileno(self):
+        return _swigfaiss_avx2.FileIOReader_fileno(self)
+
+# Register FileIOReader in _swigfaiss_avx2:
+_swigfaiss_avx2.FileIOReader_swigregister(FileIOReader)
+class FileIOWriter(IOWriter):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    f = property(_swigfaiss_avx2.FileIOWriter_f_get, _swigfaiss_avx2.FileIOWriter_f_set)
+    need_close = property(_swigfaiss_avx2.FileIOWriter_need_close_get, _swigfaiss_avx2.FileIOWriter_need_close_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.FileIOWriter_swiginit(self, _swigfaiss_avx2.new_FileIOWriter(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_FileIOWriter
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss_avx2.FileIOWriter___call__(self, ptr, size, nitems)
+
+    def fileno(self):
+        return _swigfaiss_avx2.FileIOWriter_fileno(self)
+
+# Register FileIOWriter in _swigfaiss_avx2:
+_swigfaiss_avx2.FileIOWriter_swigregister(FileIOWriter)
+class BufferedIOReader(IOReader):
+    r""" wraps an ioreader to make buffered reads to avoid too small reads"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    reader = property(_swigfaiss_avx2.BufferedIOReader_reader_get, _swigfaiss_avx2.BufferedIOReader_reader_set)
+    bsz = property(_swigfaiss_avx2.BufferedIOReader_bsz_get, _swigfaiss_avx2.BufferedIOReader_bsz_set)
+    ofs = property(_swigfaiss_avx2.BufferedIOReader_ofs_get, _swigfaiss_avx2.BufferedIOReader_ofs_set, doc=r""" offset in input stream""")
+    ofs2 = property(_swigfaiss_avx2.BufferedIOReader_ofs2_get, _swigfaiss_avx2.BufferedIOReader_ofs2_set, doc=r""" number of bytes returned to caller""")
+    b0 = property(_swigfaiss_avx2.BufferedIOReader_b0_get, _swigfaiss_avx2.BufferedIOReader_b0_set, doc=r""" range of available bytes in the buffer""")
+    b1 = property(_swigfaiss_avx2.BufferedIOReader_b1_get, _swigfaiss_avx2.BufferedIOReader_b1_set)
+    buffer = property(_swigfaiss_avx2.BufferedIOReader_buffer_get, _swigfaiss_avx2.BufferedIOReader_buffer_set)
+
+    def __init__(self, *args):
+        r"""
+        :type bsz: int, optional
+        :param bsz:    buffer size (bytes). Reads will be done by batched of
+                          this size
+        """
+        _swigfaiss_avx2.BufferedIOReader_swiginit(self, _swigfaiss_avx2.new_BufferedIOReader(*args))
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss_avx2.BufferedIOReader___call__(self, ptr, size, nitems)
+    __swig_destroy__ = _swigfaiss_avx2.delete_BufferedIOReader
+
+# Register BufferedIOReader in _swigfaiss_avx2:
+_swigfaiss_avx2.BufferedIOReader_swigregister(BufferedIOReader)
+class BufferedIOWriter(IOWriter):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    writer = property(_swigfaiss_avx2.BufferedIOWriter_writer_get, _swigfaiss_avx2.BufferedIOWriter_writer_set)
+    bsz = property(_swigfaiss_avx2.BufferedIOWriter_bsz_get, _swigfaiss_avx2.BufferedIOWriter_bsz_set)
+    ofs = property(_swigfaiss_avx2.BufferedIOWriter_ofs_get, _swigfaiss_avx2.BufferedIOWriter_ofs_set)
+    ofs2 = property(_swigfaiss_avx2.BufferedIOWriter_ofs2_get, _swigfaiss_avx2.BufferedIOWriter_ofs2_set, doc=r""" number of bytes received from caller""")
+    b0 = property(_swigfaiss_avx2.BufferedIOWriter_b0_get, _swigfaiss_avx2.BufferedIOWriter_b0_set, doc=r""" amount of data in buffer""")
+    buffer = property(_swigfaiss_avx2.BufferedIOWriter_buffer_get, _swigfaiss_avx2.BufferedIOWriter_buffer_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.BufferedIOWriter_swiginit(self, _swigfaiss_avx2.new_BufferedIOWriter(*args))
+
+    def __call__(self, ptr, size, nitems):
+        return _swigfaiss_avx2.BufferedIOWriter___call__(self, ptr, size, nitems)
+    __swig_destroy__ = _swigfaiss_avx2.delete_BufferedIOWriter
+
+# Register BufferedIOWriter in _swigfaiss_avx2:
+_swigfaiss_avx2.BufferedIOWriter_swigregister(BufferedIOWriter)
+
+def fourcc(*args):
+    return _swigfaiss_avx2.fourcc(*args)
+
+def fourcc_inv(*args):
+    return _swigfaiss_avx2.fourcc_inv(*args)
+
+def fourcc_inv_printable(x):
+    return _swigfaiss_avx2.fourcc_inv_printable(x)
+class InvertedListsIterator(object):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+
+    Definition of inverted lists + a few common classes that implement
+    the interface.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    __swig_destroy__ = _swigfaiss_avx2.delete_InvertedListsIterator
+
+    def is_available(self):
+        return _swigfaiss_avx2.InvertedListsIterator_is_available(self)
+
+    def next(self):
+        return _swigfaiss_avx2.InvertedListsIterator_next(self)
+
+    def get_id_and_codes(self):
+        return _swigfaiss_avx2.InvertedListsIterator_get_id_and_codes(self)
+
+# Register InvertedListsIterator in _swigfaiss_avx2:
+_swigfaiss_avx2.InvertedListsIterator_swigregister(InvertedListsIterator)
+class InvertedLists(object):
+    r"""
+     Table of inverted lists
+    multithreading rules:
+    - concurrent read accesses are allowed
+    - concurrent update accesses are allowed
+    - for resize and add_entries, only concurrent access to different lists
+      are allowed
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    nlist = property(_swigfaiss_avx2.InvertedLists_nlist_get, _swigfaiss_avx2.InvertedLists_nlist_set, doc=r""" number of possible key values""")
+    code_size = property(_swigfaiss_avx2.InvertedLists_code_size_get, _swigfaiss_avx2.InvertedLists_code_size_set, doc=r""" code size per vector in bytes""")
+    use_iterator = property(_swigfaiss_avx2.InvertedLists_use_iterator_get, _swigfaiss_avx2.InvertedLists_use_iterator_set)
+    __swig_destroy__ = _swigfaiss_avx2.delete_InvertedLists
+    INVALID_CODE_SIZE = _swigfaiss_avx2.InvertedLists_INVALID_CODE_SIZE
+    r"""
+    used for BlockInvertedLists, where the codes are packed into groups
+    and the individual code size is meaningless
+    """
+
+    def is_empty(self, list_no, inverted_list_context):
+        return _swigfaiss_avx2.InvertedLists_is_empty(self, list_no, inverted_list_context)
+
+    def list_size(self, list_no):
+        r""" get the size of a list"""
+        return _swigfaiss_avx2.InvertedLists_list_size(self, list_no)
+
+    def get_iterator(self, list_no, inverted_list_context):
+        r""" get iterable for lists that use_iterator"""
+        return _swigfaiss_avx2.InvertedLists_get_iterator(self, list_no, inverted_list_context)
+
+    def get_codes(self, list_no):
+        r"""
+         get the codes for an inverted list
+        must be released by release_codes
+
+        :rtype: uint8_t
+        :return: codes    size list_size * code_size
+        """
+        return _swigfaiss_avx2.InvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        r"""
+         get the ids for an inverted list
+        must be released by release_ids
+
+        :rtype: int
+        :return: ids      size list_size
+        """
+        return _swigfaiss_avx2.InvertedLists_get_ids(self, list_no)
+
+    def release_codes(self, list_no, codes):
+        r""" release codes returned by get_codes (default implementation is nop"""
+        return _swigfaiss_avx2.InvertedLists_release_codes(self, list_no, codes)
+
+    def release_ids(self, list_no, ids):
+        r""" release ids returned by get_ids"""
+        return _swigfaiss_avx2.InvertedLists_release_ids(self, list_no, ids)
+
+    def get_single_id(self, list_no, offset):
+        r"""
+        :rtype: int
+        :return: a single id in an inverted list
+        """
+        return _swigfaiss_avx2.InvertedLists_get_single_id(self, list_no, offset)
+
+    def get_single_code(self, list_no, offset):
+        r"""
+        :rtype: uint8_t
+        :return: a single code in an inverted list
+            (should be deallocated with release_codes)
+        """
+        return _swigfaiss_avx2.InvertedLists_get_single_code(self, list_no, offset)
+
+    def prefetch_lists(self, list_nos, nlist):
+        r"""
+        prepare the following lists (default does nothing)
+        a list can be -1 hence the signed long
+        """
+        return _swigfaiss_avx2.InvertedLists_prefetch_lists(self, list_nos, nlist)
+
+    def add_entry(self, list_no, theid, code, inverted_list_context=None):
+        r""" add one entry to an inverted list"""
+        return _swigfaiss_avx2.InvertedLists_add_entry(self, list_no, theid, code, inverted_list_context)
+
+    def add_entries(self, list_no, n_entry, ids, code):
+        return _swigfaiss_avx2.InvertedLists_add_entries(self, list_no, n_entry, ids, code)
+
+    def update_entry(self, list_no, offset, id, code):
+        return _swigfaiss_avx2.InvertedLists_update_entry(self, list_no, offset, id, code)
+
+    def update_entries(self, list_no, offset, n_entry, ids, code):
+        return _swigfaiss_avx2.InvertedLists_update_entries(self, list_no, offset, n_entry, ids, code)
+
+    def resize(self, list_no, new_size):
+        return _swigfaiss_avx2.InvertedLists_resize(self, list_no, new_size)
+
+    def reset(self):
+        return _swigfaiss_avx2.InvertedLists_reset(self)
+
+    def merge_from(self, oivf, add_id):
+        r""" move all entries from oivf (empty on output)"""
+        return _swigfaiss_avx2.InvertedLists_merge_from(self, oivf, add_id)
+    SUBSET_TYPE_ID_RANGE = _swigfaiss_avx2.InvertedLists_SUBSET_TYPE_ID_RANGE
+    SUBSET_TYPE_ID_MOD = _swigfaiss_avx2.InvertedLists_SUBSET_TYPE_ID_MOD
+    SUBSET_TYPE_ELEMENT_RANGE = _swigfaiss_avx2.InvertedLists_SUBSET_TYPE_ELEMENT_RANGE
+    SUBSET_TYPE_INVLIST_FRACTION = _swigfaiss_avx2.InvertedLists_SUBSET_TYPE_INVLIST_FRACTION
+    SUBSET_TYPE_INVLIST = _swigfaiss_avx2.InvertedLists_SUBSET_TYPE_INVLIST
+
+    def copy_subset_to(self, other, subset_type, a1, a2):
+        r"""
+         copy a subset of the entries index to the other index
+        :rtype: int
+        :return: number of entries copied
+        """
+        return _swigfaiss_avx2.InvertedLists_copy_subset_to(self, other, subset_type, a1, a2)
+
+    def imbalance_factor(self):
+        r""" 1= perfectly balanced, >1: imbalanced"""
+        return _swigfaiss_avx2.InvertedLists_imbalance_factor(self)
+
+    def print_stats(self):
+        r""" display some stats about the inverted lists"""
+        return _swigfaiss_avx2.InvertedLists_print_stats(self)
+
+    def compute_ntotal(self):
+        r""" sum up list sizes"""
+        return _swigfaiss_avx2.InvertedLists_compute_ntotal(self)
+
+# Register InvertedLists in _swigfaiss_avx2:
+_swigfaiss_avx2.InvertedLists_swigregister(InvertedLists)
+class ArrayInvertedLists(InvertedLists):
+    r""" simple (default) implementation as an array of inverted lists"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    codes = property(_swigfaiss_avx2.ArrayInvertedLists_codes_get, _swigfaiss_avx2.ArrayInvertedLists_codes_set)
+    ids = property(_swigfaiss_avx2.ArrayInvertedLists_ids_get, _swigfaiss_avx2.ArrayInvertedLists_ids_set, doc=r""" Inverted lists for indexes""")
+
+    def __init__(self, nlist, code_size):
+        _swigfaiss_avx2.ArrayInvertedLists_swiginit(self, _swigfaiss_avx2.new_ArrayInvertedLists(nlist, code_size))
+
+    def list_size(self, list_no):
+        return _swigfaiss_avx2.ArrayInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss_avx2.ArrayInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss_avx2.ArrayInvertedLists_get_ids(self, list_no)
+
+    def add_entries(self, list_no, n_entry, ids, code):
+        return _swigfaiss_avx2.ArrayInvertedLists_add_entries(self, list_no, n_entry, ids, code)
+
+    def update_entries(self, list_no, offset, n_entry, ids, code):
+        return _swigfaiss_avx2.ArrayInvertedLists_update_entries(self, list_no, offset, n_entry, ids, code)
+
+    def resize(self, list_no, new_size):
+        return _swigfaiss_avx2.ArrayInvertedLists_resize(self, list_no, new_size)
+
+    def permute_invlists(self, map):
+        r""" permute the inverted lists, map maps new_id to old_id"""
+        return _swigfaiss_avx2.ArrayInvertedLists_permute_invlists(self, map)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ArrayInvertedLists
+
+# Register ArrayInvertedLists in _swigfaiss_avx2:
+_swigfaiss_avx2.ArrayInvertedLists_swigregister(ArrayInvertedLists)
+class ReadOnlyInvertedLists(InvertedLists):
+    r""" invlists that fail for all write functions"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+
+    def add_entries(self, list_no, n_entry, ids, code):
+        return _swigfaiss_avx2.ReadOnlyInvertedLists_add_entries(self, list_no, n_entry, ids, code)
+
+    def update_entries(self, list_no, offset, n_entry, ids, code):
+        return _swigfaiss_avx2.ReadOnlyInvertedLists_update_entries(self, list_no, offset, n_entry, ids, code)
+
+    def resize(self, list_no, new_size):
+        return _swigfaiss_avx2.ReadOnlyInvertedLists_resize(self, list_no, new_size)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ReadOnlyInvertedLists
+
+# Register ReadOnlyInvertedLists in _swigfaiss_avx2:
+_swigfaiss_avx2.ReadOnlyInvertedLists_swigregister(ReadOnlyInvertedLists)
+class HStackInvertedLists(ReadOnlyInvertedLists):
+    r""" Horizontal stack of inverted lists"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    ils = property(_swigfaiss_avx2.HStackInvertedLists_ils_get, _swigfaiss_avx2.HStackInvertedLists_ils_set)
+
+    def __init__(self, nil, ils):
+        r""" build InvertedLists by concatenating nil of them"""
+        _swigfaiss_avx2.HStackInvertedLists_swiginit(self, _swigfaiss_avx2.new_HStackInvertedLists(nil, ils))
+
+    def list_size(self, list_no):
+        return _swigfaiss_avx2.HStackInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss_avx2.HStackInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss_avx2.HStackInvertedLists_get_ids(self, list_no)
+
+    def prefetch_lists(self, list_nos, nlist):
+        return _swigfaiss_avx2.HStackInvertedLists_prefetch_lists(self, list_nos, nlist)
+
+    def release_codes(self, list_no, codes):
+        return _swigfaiss_avx2.HStackInvertedLists_release_codes(self, list_no, codes)
+
+    def release_ids(self, list_no, ids):
+        return _swigfaiss_avx2.HStackInvertedLists_release_ids(self, list_no, ids)
+
+    def get_single_id(self, list_no, offset):
+        return _swigfaiss_avx2.HStackInvertedLists_get_single_id(self, list_no, offset)
+
+    def get_single_code(self, list_no, offset):
+        return _swigfaiss_avx2.HStackInvertedLists_get_single_code(self, list_no, offset)
+    __swig_destroy__ = _swigfaiss_avx2.delete_HStackInvertedLists
+
+# Register HStackInvertedLists in _swigfaiss_avx2:
+_swigfaiss_avx2.HStackInvertedLists_swigregister(HStackInvertedLists)
+class SliceInvertedLists(ReadOnlyInvertedLists):
+    r""" vertical slice of indexes in another InvertedLists"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    il = property(_swigfaiss_avx2.SliceInvertedLists_il_get, _swigfaiss_avx2.SliceInvertedLists_il_set)
+    i0 = property(_swigfaiss_avx2.SliceInvertedLists_i0_get, _swigfaiss_avx2.SliceInvertedLists_i0_set)
+    i1 = property(_swigfaiss_avx2.SliceInvertedLists_i1_get, _swigfaiss_avx2.SliceInvertedLists_i1_set)
+
+    def __init__(self, il, i0, i1):
+        _swigfaiss_avx2.SliceInvertedLists_swiginit(self, _swigfaiss_avx2.new_SliceInvertedLists(il, i0, i1))
+
+    def list_size(self, list_no):
+        return _swigfaiss_avx2.SliceInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss_avx2.SliceInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss_avx2.SliceInvertedLists_get_ids(self, list_no)
+
+    def release_codes(self, list_no, codes):
+        return _swigfaiss_avx2.SliceInvertedLists_release_codes(self, list_no, codes)
+
+    def release_ids(self, list_no, ids):
+        return _swigfaiss_avx2.SliceInvertedLists_release_ids(self, list_no, ids)
+
+    def get_single_id(self, list_no, offset):
+        return _swigfaiss_avx2.SliceInvertedLists_get_single_id(self, list_no, offset)
+
+    def get_single_code(self, list_no, offset):
+        return _swigfaiss_avx2.SliceInvertedLists_get_single_code(self, list_no, offset)
+
+    def prefetch_lists(self, list_nos, nlist):
+        return _swigfaiss_avx2.SliceInvertedLists_prefetch_lists(self, list_nos, nlist)
+    __swig_destroy__ = _swigfaiss_avx2.delete_SliceInvertedLists
+
+# Register SliceInvertedLists in _swigfaiss_avx2:
+_swigfaiss_avx2.SliceInvertedLists_swigregister(SliceInvertedLists)
+class VStackInvertedLists(ReadOnlyInvertedLists):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    ils = property(_swigfaiss_avx2.VStackInvertedLists_ils_get, _swigfaiss_avx2.VStackInvertedLists_ils_set)
+    cumsz = property(_swigfaiss_avx2.VStackInvertedLists_cumsz_get, _swigfaiss_avx2.VStackInvertedLists_cumsz_set)
+
+    def __init__(self, nil, ils):
+        r""" build InvertedLists by concatenating nil of them"""
+        _swigfaiss_avx2.VStackInvertedLists_swiginit(self, _swigfaiss_avx2.new_VStackInvertedLists(nil, ils))
+
+    def list_size(self, list_no):
+        return _swigfaiss_avx2.VStackInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss_avx2.VStackInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss_avx2.VStackInvertedLists_get_ids(self, list_no)
+
+    def release_codes(self, list_no, codes):
+        return _swigfaiss_avx2.VStackInvertedLists_release_codes(self, list_no, codes)
+
+    def release_ids(self, list_no, ids):
+        return _swigfaiss_avx2.VStackInvertedLists_release_ids(self, list_no, ids)
+
+    def get_single_id(self, list_no, offset):
+        return _swigfaiss_avx2.VStackInvertedLists_get_single_id(self, list_no, offset)
+
+    def get_single_code(self, list_no, offset):
+        return _swigfaiss_avx2.VStackInvertedLists_get_single_code(self, list_no, offset)
+
+    def prefetch_lists(self, list_nos, nlist):
+        return _swigfaiss_avx2.VStackInvertedLists_prefetch_lists(self, list_nos, nlist)
+    __swig_destroy__ = _swigfaiss_avx2.delete_VStackInvertedLists
+
+# Register VStackInvertedLists in _swigfaiss_avx2:
+_swigfaiss_avx2.VStackInvertedLists_swigregister(VStackInvertedLists)
+class MaskedInvertedLists(ReadOnlyInvertedLists):
+    r"""
+     use the first inverted lists if they are non-empty otherwise use the second
+
+    This is useful if il1 has a few inverted lists that are too long,
+    and that il0 has replacement lists for those, with empty lists for
+    the others.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    il0 = property(_swigfaiss_avx2.MaskedInvertedLists_il0_get, _swigfaiss_avx2.MaskedInvertedLists_il0_set)
+    il1 = property(_swigfaiss_avx2.MaskedInvertedLists_il1_get, _swigfaiss_avx2.MaskedInvertedLists_il1_set)
+
+    def __init__(self, il0, il1):
+        _swigfaiss_avx2.MaskedInvertedLists_swiginit(self, _swigfaiss_avx2.new_MaskedInvertedLists(il0, il1))
+
+    def list_size(self, list_no):
+        return _swigfaiss_avx2.MaskedInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss_avx2.MaskedInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss_avx2.MaskedInvertedLists_get_ids(self, list_no)
+
+    def release_codes(self, list_no, codes):
+        return _swigfaiss_avx2.MaskedInvertedLists_release_codes(self, list_no, codes)
+
+    def release_ids(self, list_no, ids):
+        return _swigfaiss_avx2.MaskedInvertedLists_release_ids(self, list_no, ids)
+
+    def get_single_id(self, list_no, offset):
+        return _swigfaiss_avx2.MaskedInvertedLists_get_single_id(self, list_no, offset)
+
+    def get_single_code(self, list_no, offset):
+        return _swigfaiss_avx2.MaskedInvertedLists_get_single_code(self, list_no, offset)
+
+    def prefetch_lists(self, list_nos, nlist):
+        return _swigfaiss_avx2.MaskedInvertedLists_prefetch_lists(self, list_nos, nlist)
+    __swig_destroy__ = _swigfaiss_avx2.delete_MaskedInvertedLists
+
+# Register MaskedInvertedLists in _swigfaiss_avx2:
+_swigfaiss_avx2.MaskedInvertedLists_swigregister(MaskedInvertedLists)
+class StopWordsInvertedLists(ReadOnlyInvertedLists):
+    r"""
+    if the inverted list in il is smaller than maxsize then return it,
+    otherwise return an empty invlist
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    il0 = property(_swigfaiss_avx2.StopWordsInvertedLists_il0_get, _swigfaiss_avx2.StopWordsInvertedLists_il0_set)
+    maxsize = property(_swigfaiss_avx2.StopWordsInvertedLists_maxsize_get, _swigfaiss_avx2.StopWordsInvertedLists_maxsize_set)
+
+    def __init__(self, il, maxsize):
+        _swigfaiss_avx2.StopWordsInvertedLists_swiginit(self, _swigfaiss_avx2.new_StopWordsInvertedLists(il, maxsize))
+
+    def list_size(self, list_no):
+        return _swigfaiss_avx2.StopWordsInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss_avx2.StopWordsInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss_avx2.StopWordsInvertedLists_get_ids(self, list_no)
+
+    def release_codes(self, list_no, codes):
+        return _swigfaiss_avx2.StopWordsInvertedLists_release_codes(self, list_no, codes)
+
+    def release_ids(self, list_no, ids):
+        return _swigfaiss_avx2.StopWordsInvertedLists_release_ids(self, list_no, ids)
+
+    def get_single_id(self, list_no, offset):
+        return _swigfaiss_avx2.StopWordsInvertedLists_get_single_id(self, list_no, offset)
+
+    def get_single_code(self, list_no, offset):
+        return _swigfaiss_avx2.StopWordsInvertedLists_get_single_code(self, list_no, offset)
+
+    def prefetch_lists(self, list_nos, nlist):
+        return _swigfaiss_avx2.StopWordsInvertedLists_prefetch_lists(self, list_nos, nlist)
+    __swig_destroy__ = _swigfaiss_avx2.delete_StopWordsInvertedLists
+
+# Register StopWordsInvertedLists in _swigfaiss_avx2:
+_swigfaiss_avx2.StopWordsInvertedLists_swigregister(StopWordsInvertedLists)
+class InvertedListsIOHook(object):
+    r"""
+     Callbacks to handle other types of InvertedList objects.
+
+    The callbacks should be registered with add_callback before calling
+    read_index or read_InvertedLists. The callbacks for
+    OnDiskInvertedLists are registrered by default. The invlist type is
+    identified by:
+
+    - the key (a fourcc) at read time
+    - the class name (as given by typeid.name) at write time
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    key = property(_swigfaiss_avx2.InvertedListsIOHook_key_get, doc=r""" string version of the fourcc""")
+    classname = property(_swigfaiss_avx2.InvertedListsIOHook_classname_get, doc=r""" typeid.name""")
+
+    def write(self, ils, f):
+        r""" write the index to the IOWriter (including the fourcc)"""
+        return _swigfaiss_avx2.InvertedListsIOHook_write(self, ils, f)
+
+    def read(self, f, io_flags):
+        r""" called when the fourcc matches this class's fourcc"""
+        return _swigfaiss_avx2.InvertedListsIOHook_read(self, f, io_flags)
+
+    def read_ArrayInvertedLists(self, f, io_flags, nlist, code_size, sizes):
+        r"""
+         read from a ArrayInvertedLists into this invertedlist type.
+        For this to work, the callback has to be enabled and the io_flag has to
+        be set to IO_FLAG_SKIP_IVF_DATA | (16 upper bits of the fourcc)
+
+        (default implementation fails)
+        """
+        return _swigfaiss_avx2.InvertedListsIOHook_read_ArrayInvertedLists(self, f, io_flags, nlist, code_size, sizes)
+    __swig_destroy__ = _swigfaiss_avx2.delete_InvertedListsIOHook
+
+    @staticmethod
+    def add_callback(arg1):
+        return _swigfaiss_avx2.InvertedListsIOHook_add_callback(arg1)
+
+    @staticmethod
+    def print_callbacks():
+        return _swigfaiss_avx2.InvertedListsIOHook_print_callbacks()
+
+    @staticmethod
+    def lookup(h):
+        return _swigfaiss_avx2.InvertedListsIOHook_lookup(h)
+
+    @staticmethod
+    def lookup_classname(classname):
+        return _swigfaiss_avx2.InvertedListsIOHook_lookup_classname(classname)
+
+# Register InvertedListsIOHook in _swigfaiss_avx2:
+_swigfaiss_avx2.InvertedListsIOHook_swigregister(InvertedListsIOHook)
+class BlockInvertedLists(InvertedLists):
+    r"""
+     Inverted Lists that are organized by blocks.
+
+    Different from the regular inverted lists, the codes are organized by blocks
+    of size block_size bytes that reprsent a set of n_per_block. Therefore, code
+    allocations are always rounded up to block_size bytes. The codes are also
+    aligned on 32-byte boundaries for use with SIMD.
+
+    To avoid misinterpretations, the code_size is set to (size_t)(-1), even if
+    arguably the amount of memory consumed by code is block_size / n_per_block.
+
+    The writing functions add_entries and update_entries operate on block-aligned
+    data.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    n_per_block = property(_swigfaiss_avx2.BlockInvertedLists_n_per_block_get, _swigfaiss_avx2.BlockInvertedLists_n_per_block_set)
+    block_size = property(_swigfaiss_avx2.BlockInvertedLists_block_size_get, _swigfaiss_avx2.BlockInvertedLists_block_size_set)
+    packer = property(_swigfaiss_avx2.BlockInvertedLists_packer_get, _swigfaiss_avx2.BlockInvertedLists_packer_set)
+    codes = property(_swigfaiss_avx2.BlockInvertedLists_codes_get, _swigfaiss_avx2.BlockInvertedLists_codes_set)
+    ids = property(_swigfaiss_avx2.BlockInvertedLists_ids_get, _swigfaiss_avx2.BlockInvertedLists_ids_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.BlockInvertedLists_swiginit(self, _swigfaiss_avx2.new_BlockInvertedLists(*args))
+
+    def list_size(self, list_no):
+        return _swigfaiss_avx2.BlockInvertedLists_list_size(self, list_no)
+
+    def get_codes(self, list_no):
+        return _swigfaiss_avx2.BlockInvertedLists_get_codes(self, list_no)
+
+    def get_ids(self, list_no):
+        return _swigfaiss_avx2.BlockInvertedLists_get_ids(self, list_no)
+
+    def add_entries(self, list_no, n_entry, ids, code):
+        return _swigfaiss_avx2.BlockInvertedLists_add_entries(self, list_no, n_entry, ids, code)
+
+    def update_entries(self, list_no, offset, n_entry, ids, code):
+        r""" not implemented"""
+        return _swigfaiss_avx2.BlockInvertedLists_update_entries(self, list_no, offset, n_entry, ids, code)
+
+    def resize(self, list_no, new_size):
+        return _swigfaiss_avx2.BlockInvertedLists_resize(self, list_no, new_size)
+    __swig_destroy__ = _swigfaiss_avx2.delete_BlockInvertedLists
+
+# Register BlockInvertedLists in _swigfaiss_avx2:
+_swigfaiss_avx2.BlockInvertedLists_swigregister(BlockInvertedLists)
+
+def lo_build(list_id, offset):
+    return _swigfaiss_avx2.lo_build(list_id, offset)
+
+def lo_listno(lo):
+    return _swigfaiss_avx2.lo_listno(lo)
+
+def lo_offset(lo):
+    return _swigfaiss_avx2.lo_offset(lo)
+class DirectMap(object):
+    r"""Direct map: a way to map back from ids to inverted lists"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    NoMap = _swigfaiss_avx2.DirectMap_NoMap
+    Array = _swigfaiss_avx2.DirectMap_Array
+    Hashtable = _swigfaiss_avx2.DirectMap_Hashtable
+    type = property(_swigfaiss_avx2.DirectMap_type_get, _swigfaiss_avx2.DirectMap_type_set)
+    array = property(_swigfaiss_avx2.DirectMap_array_get, _swigfaiss_avx2.DirectMap_array_set, doc=r""" map for direct access to the elements. Map ids to LO-encoded entries.""")
+    hashtable = property(_swigfaiss_avx2.DirectMap_hashtable_get, _swigfaiss_avx2.DirectMap_hashtable_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.DirectMap_swiginit(self, _swigfaiss_avx2.new_DirectMap())
+
+    def set_type(self, new_type, invlists, ntotal):
+        r""" set type and initialize"""
+        return _swigfaiss_avx2.DirectMap_set_type(self, new_type, invlists, ntotal)
+
+    def get(self, id):
+        r""" get an entry"""
+        return _swigfaiss_avx2.DirectMap_get(self, id)
+
+    def no(self):
+        r""" for quick checks"""
+        return _swigfaiss_avx2.DirectMap_no(self)
+
+    def check_can_add(self, ids):
+        r"""
+        update the direct_map
+
+         throw if Array and ids is not NULL
+        """
+        return _swigfaiss_avx2.DirectMap_check_can_add(self, ids)
+
+    def add_single_id(self, id, list_no, offset):
+        r""" non thread-safe version"""
+        return _swigfaiss_avx2.DirectMap_add_single_id(self, id, list_no, offset)
+
+    def clear(self):
+        r""" remove all entries"""
+        return _swigfaiss_avx2.DirectMap_clear(self)
+
+    def remove_ids(self, sel, invlists):
+        r"""
+        operations on inverted lists that require translation with a DirectMap
+
+         remove ids from the InvertedLists, possibly using the direct map
+        """
+        return _swigfaiss_avx2.DirectMap_remove_ids(self, sel, invlists)
+
+    def update_codes(self, invlists, n, ids, list_nos, codes):
+        r""" update entries, using the direct map"""
+        return _swigfaiss_avx2.DirectMap_update_codes(self, invlists, n, ids, list_nos, codes)
+    __swig_destroy__ = _swigfaiss_avx2.delete_DirectMap
+
+# Register DirectMap in _swigfaiss_avx2:
+_swigfaiss_avx2.DirectMap_swigregister(DirectMap)
+class DirectMapAdd(object):
+    r""" Thread-safe way of updating the direct_map"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    direct_map = property(_swigfaiss_avx2.DirectMapAdd_direct_map_get, _swigfaiss_avx2.DirectMapAdd_direct_map_set)
+    type = property(_swigfaiss_avx2.DirectMapAdd_type_get, _swigfaiss_avx2.DirectMapAdd_type_set)
+    ntotal = property(_swigfaiss_avx2.DirectMapAdd_ntotal_get, _swigfaiss_avx2.DirectMapAdd_ntotal_set)
+    n = property(_swigfaiss_avx2.DirectMapAdd_n_get, _swigfaiss_avx2.DirectMapAdd_n_set)
+    xids = property(_swigfaiss_avx2.DirectMapAdd_xids_get, _swigfaiss_avx2.DirectMapAdd_xids_set)
+    all_ofs = property(_swigfaiss_avx2.DirectMapAdd_all_ofs_get, _swigfaiss_avx2.DirectMapAdd_all_ofs_set)
+
+    def __init__(self, direct_map, n, xids):
+        _swigfaiss_avx2.DirectMapAdd_swiginit(self, _swigfaiss_avx2.new_DirectMapAdd(direct_map, n, xids))
+
+    def add(self, i, list_no, offset):
+        r""" add vector i (with id xids[i]) at list_no and offset"""
+        return _swigfaiss_avx2.DirectMapAdd_add(self, i, list_no, offset)
+    __swig_destroy__ = _swigfaiss_avx2.delete_DirectMapAdd
+
+# Register DirectMapAdd in _swigfaiss_avx2:
+_swigfaiss_avx2.DirectMapAdd_swigregister(DirectMapAdd)
+class Level1Quantizer(object):
+    r"""
+     Encapsulates a quantizer object for the IndexIVF
+
+    The class isolates the fields that are independent of the storage
+    of the lists (especially training)
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    quantizer = property(_swigfaiss_avx2.Level1Quantizer_quantizer_get, _swigfaiss_avx2.Level1Quantizer_quantizer_set, doc=r""" quantizer that maps vectors to inverted lists""")
+    nlist = property(_swigfaiss_avx2.Level1Quantizer_nlist_get, _swigfaiss_avx2.Level1Quantizer_nlist_set, doc=r""" number of inverted lists""")
+    quantizer_trains_alone = property(_swigfaiss_avx2.Level1Quantizer_quantizer_trains_alone_get, _swigfaiss_avx2.Level1Quantizer_quantizer_trains_alone_set, doc=r"""
+    = 0: use the quantizer as index in a kmeans training
+    = 1: just pass on the training set to the train() of the quantizer
+    = 2: kmeans training on a flat index + add the centroids to the quantizer
+    """)
+    own_fields = property(_swigfaiss_avx2.Level1Quantizer_own_fields_get, _swigfaiss_avx2.Level1Quantizer_own_fields_set, doc=r""" whether object owns the quantizer""")
+    cp = property(_swigfaiss_avx2.Level1Quantizer_cp_get, _swigfaiss_avx2.Level1Quantizer_cp_set, doc=r""" to override default clustering params""")
+    clustering_index = property(_swigfaiss_avx2.Level1Quantizer_clustering_index_get, _swigfaiss_avx2.Level1Quantizer_clustering_index_set, doc=r""" to override index used during clustering""")
+
+    def train_q1(self, n, x, verbose, metric_type):
+        r""" Trains the quantizer and calls train_residual to train sub-quantizers"""
+        return _swigfaiss_avx2.Level1Quantizer_train_q1(self, n, x, verbose, metric_type)
+
+    def coarse_code_size(self):
+        r""" compute the number of bytes required to store list ids"""
+        return _swigfaiss_avx2.Level1Quantizer_coarse_code_size(self)
+
+    def encode_listno(self, list_no, code):
+        return _swigfaiss_avx2.Level1Quantizer_encode_listno(self, list_no, code)
+
+    def decode_listno(self, code):
+        return _swigfaiss_avx2.Level1Quantizer_decode_listno(self, code)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.Level1Quantizer_swiginit(self, _swigfaiss_avx2.new_Level1Quantizer(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_Level1Quantizer
+
+# Register Level1Quantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.Level1Quantizer_swigregister(Level1Quantizer)
+class SearchParametersIVF(SearchParameters):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nprobe = property(_swigfaiss_avx2.SearchParametersIVF_nprobe_get, _swigfaiss_avx2.SearchParametersIVF_nprobe_set, doc=r""" number of probes at query time""")
+    max_codes = property(_swigfaiss_avx2.SearchParametersIVF_max_codes_get, _swigfaiss_avx2.SearchParametersIVF_max_codes_set, doc=r""" max nb of codes to visit to do a query""")
+    quantizer_params = property(_swigfaiss_avx2.SearchParametersIVF_quantizer_params_get, _swigfaiss_avx2.SearchParametersIVF_quantizer_params_set)
+    inverted_list_context = property(_swigfaiss_avx2.SearchParametersIVF_inverted_list_context_get, _swigfaiss_avx2.SearchParametersIVF_inverted_list_context_set, doc=r""" context object to pass to InvertedLists""")
+    __swig_destroy__ = _swigfaiss_avx2.delete_SearchParametersIVF
+
+    def __init__(self):
+        _swigfaiss_avx2.SearchParametersIVF_swiginit(self, _swigfaiss_avx2.new_SearchParametersIVF())
+
+# Register SearchParametersIVF in _swigfaiss_avx2:
+_swigfaiss_avx2.SearchParametersIVF_swigregister(SearchParametersIVF)
+class IndexIVFInterface(Level1Quantizer):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    nprobe = property(_swigfaiss_avx2.IndexIVFInterface_nprobe_get, _swigfaiss_avx2.IndexIVFInterface_nprobe_set, doc=r""" number of probes at query time""")
+    max_codes = property(_swigfaiss_avx2.IndexIVFInterface_max_codes_get, _swigfaiss_avx2.IndexIVFInterface_max_codes_set, doc=r""" max nb of codes to visit to do a query""")
+
+    def search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params=None, stats=None):
+        r"""
+         search a set of vectors, that are pre-quantized by the IVF
+         quantizer. Fill in the corresponding heaps with the query
+         results. The default implementation uses InvertedListScanners
+         to do the search.
+
+        :type n: int
+        :param n:      nb of vectors to query
+        :type x: float
+        :param x:      query vectors, size nx * d
+        :type assign: int
+        :param assign: coarse quantization indices, size nx * nprobe
+        :type centroid_dis: float
+        :param centroid_dis:
+                          distances to coarse centroids, size nx * nprobe
+        :param distance:
+                          output distances, size n * k
+        :type labels: int
+        :param labels: output labels, size n * k
+        :type store_pairs: boolean
+        :param store_pairs: store inv list index + inv list offset
+                                instead in upper/lower 32 bit of result,
+                                instead of ids (used for reranking).
+        :type params: :py:class:`IVFSearchParameters`, optional
+        :param params: used to override the object's search parameters
+        :type stats: :py:class:`IndexIVFStats`, optional
+        :param stats:  search stats to be updated (can be null)
+        """
+        return _swigfaiss_avx2.IndexIVFInterface_search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params, stats)
+
+    def range_search_preassigned(self, nx, x, radius, keys, coarse_dis, result, store_pairs=False, params=None, stats=None):
+        r"""
+         Range search a set of vectors, that are pre-quantized by the IVF
+         quantizer. Fill in the RangeSearchResults results. The default
+        implementation uses InvertedListScanners to do the search.
+
+        :param n:      nb of vectors to query
+        :type x: float
+        :param x:      query vectors, size nx * d
+        :param assign: coarse quantization indices, size nx * nprobe
+        :param centroid_dis:
+                          distances to coarse centroids, size nx * nprobe
+        :type result: :py:class:`RangeSearchResult`
+        :param result: Output results
+        :type store_pairs: boolean, optional
+        :param store_pairs: store inv list index + inv list offset
+                                instead in upper/lower 32 bit of result,
+                                instead of ids (used for reranking).
+        :type params: :py:class:`IVFSearchParameters`, optional
+        :param params: used to override the object's search parameters
+        :type stats: :py:class:`IndexIVFStats`, optional
+        :param stats:  search stats to be updated (can be null)
+        """
+        return _swigfaiss_avx2.IndexIVFInterface_range_search_preassigned(self, nx, x, radius, keys, coarse_dis, result, store_pairs, params, stats)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFInterface
+
+# Register IndexIVFInterface in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFInterface_swigregister(IndexIVFInterface)
+class IndexIVF(Index, IndexIVFInterface):
+    r"""
+     Index based on a inverted file (IVF)
+
+    In the inverted file, the quantizer (an Index instance) provides a
+    quantization index for each vector to be added. The quantization
+    index maps to a list (aka inverted list or posting list), where the
+    id of the vector is stored.
+
+    The inverted list object is required only after trainng. If none is
+    set externally, an ArrayInvertedLists is used automatically.
+
+    At search time, the vector to be searched is also quantized, and
+    only the list corresponding to the quantization index is
+    searched. This speeds up the search by making it
+    non-exhaustive. This can be relaxed using multi-probe search: a few
+    (nprobe) quantization indices are selected and several inverted
+    lists are visited.
+
+    Sub-classes implement a post-filtering of the index that refines
+    the distance estimation from the query to databse vectors.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    invlists = property(_swigfaiss_avx2.IndexIVF_invlists_get, _swigfaiss_avx2.IndexIVF_invlists_set, doc=r""" Access to the actual data""")
+    own_invlists = property(_swigfaiss_avx2.IndexIVF_own_invlists_get, _swigfaiss_avx2.IndexIVF_own_invlists_set)
+    code_size = property(_swigfaiss_avx2.IndexIVF_code_size_get, _swigfaiss_avx2.IndexIVF_code_size_set, doc=r""" code size per vector in bytes""")
+    parallel_mode = property(_swigfaiss_avx2.IndexIVF_parallel_mode_get, _swigfaiss_avx2.IndexIVF_parallel_mode_set, doc=r"""
+     Parallel mode determines how queries are parallelized with OpenMP
+
+    0 (default): split over queries
+    1: parallelize over inverted lists
+    2: parallelize over both
+    3: split over queries with a finer granularity
+
+    PARALLEL_MODE_NO_HEAP_INIT: binary or with the previous to
+    prevent the heap to be initialized and finalized
+    """)
+    PARALLEL_MODE_NO_HEAP_INIT = property(_swigfaiss_avx2.IndexIVF_PARALLEL_MODE_NO_HEAP_INIT_get)
+    direct_map = property(_swigfaiss_avx2.IndexIVF_direct_map_get, _swigfaiss_avx2.IndexIVF_direct_map_set, doc=r"""
+    optional map that maps back ids to invlist entries. This
+    enables reconstruct()
+    """)
+    by_residual = property(_swigfaiss_avx2.IndexIVF_by_residual_get, _swigfaiss_avx2.IndexIVF_by_residual_set, doc=r"""
+    do the codes in the invlists encode the vectors relative to the
+    centroids?
+    """)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexIVF_reset(self)
+
+    def train(self, n, x):
+        r""" Trains the quantizer and calls train_encoder to train sub-quantizers"""
+        return _swigfaiss_avx2.IndexIVF_train(self, n, x)
+
+    def add(self, n, x):
+        r""" Calls add_with_ids with NULL ids"""
+        return _swigfaiss_avx2.IndexIVF_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        r""" default implementation that calls encode_vectors"""
+        return _swigfaiss_avx2.IndexIVF_add_with_ids(self, n, x, xids)
+
+    def add_core(self, n, x, xids, precomputed_idx, inverted_list_context=None):
+        r"""
+         Implementation of vector addition where the vector assignments are
+        predefined. The default implementation hands over the code extraction to
+        encode_vectors.
+
+        :type precomputed_idx: int
+        :param precomputed_idx:    quantization indices for the input vectors
+            (size n)
+        """
+        return _swigfaiss_avx2.IndexIVF_add_core(self, n, x, xids, precomputed_idx, inverted_list_context)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listno=False):
+        r"""
+         Encodes a set of vectors as they would appear in the inverted lists
+
+        :type list_nos: int
+        :param list_nos:   inverted list ids as returned by the
+                              quantizer (size n). -1s are ignored.
+        :type codes: uint8_t
+        :param codes:      output codes, size n * code_size
+        :type include_listno: boolean, optional
+        :param include_listno:
+                              include the list ids in the code (in this case add
+                              ceil(log8(nlist)) to the code size)
+        """
+        return _swigfaiss_avx2.IndexIVF_encode_vectors(self, n, x, list_nos, codes, include_listno)
+
+    def add_sa_codes(self, n, codes, xids):
+        r"""
+         Add vectors that are computed with the standalone codec
+
+        :type codes: uint8_t
+        :param codes:  codes to add size n * sa_code_size()
+        :type xids: int
+        :param xids:   corresponding ids, size n
+        """
+        return _swigfaiss_avx2.IndexIVF_add_sa_codes(self, n, codes, xids)
+
+    def train_encoder(self, n, x, assign):
+        r"""
+         Train the encoder for the vectors.
+
+        If by_residual then it is called with residuals and corresponding assign
+        array, otherwise x is the raw training vectors and assign=nullptr
+        """
+        return _swigfaiss_avx2.IndexIVF_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        r"""
+        can be redefined by subclasses to indicate how many training vectors
+        they need
+        """
+        return _swigfaiss_avx2.IndexIVF_train_encoder_num_vectors(self)
+
+    def search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params=None, stats=None):
+        return _swigfaiss_avx2.IndexIVF_search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params, stats)
+
+    def range_search_preassigned(self, nx, x, radius, keys, coarse_dis, result, store_pairs=False, params=None, stats=None):
+        return _swigfaiss_avx2.IndexIVF_range_search_preassigned(self, nx, x, radius, keys, coarse_dis, result, store_pairs, params, stats)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" assign the vectors, then call search_preassign"""
+        return _swigfaiss_avx2.IndexIVF_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss_avx2.IndexIVF_range_search(self, n, x, radius, result, params)
+
+    def get_InvertedListScanner(self, store_pairs=False, sel=None):
+        r"""
+         Get a scanner for this index (store_pairs means ignore labels)
+
+        The default search implementation uses this to compute the distances
+        """
+        return _swigfaiss_avx2.IndexIVF_get_InvertedListScanner(self, store_pairs, sel)
+
+    def reconstruct(self, key, recons):
+        r""" reconstruct a vector. Works only if maintain_direct_map is set to 1 or 2"""
+        return _swigfaiss_avx2.IndexIVF_reconstruct(self, key, recons)
+
+    def update_vectors(self, nv, idx, v):
+        r"""
+         Update a subset of vectors.
+
+        The index must have a direct_map
+
+        :type nv: int
+        :param nv:     nb of vectors to update
+        :type idx: int
+        :param idx:    vector indices to update, size nv
+        :type v: float
+        :param v:      vectors of new values, size nv*d
+        """
+        return _swigfaiss_avx2.IndexIVF_update_vectors(self, nv, idx, v)
+
+    def reconstruct_n(self, i0, ni, recons):
+        r"""
+         Reconstruct a subset of the indexed vectors.
+
+        Overrides default implementation to bypass reconstruct() which requires
+        direct_map to be maintained.
+
+        :type i0: int
+        :param i0:     first vector to reconstruct
+        :type ni: int
+        :param ni:     nb of vectors to reconstruct
+        :type recons: float
+        :param recons: output array of reconstructed vectors, size ni * d
+        """
+        return _swigfaiss_avx2.IndexIVF_reconstruct_n(self, i0, ni, recons)
+
+    def search_and_reconstruct(self, n, x, k, distances, labels, recons, params=None):
+        r"""
+         Similar to search, but also reconstructs the stored vectors (or an
+        approximation in the case of lossy coding) for the search results.
+
+        Overrides default implementation to avoid having to maintain direct_map
+        and instead fetch the code offsets through the `store_pairs` flag in
+        search_preassigned().
+
+        :type recons: float
+        :param recons:      reconstructed vectors size (n, k, d)
+        """
+        return _swigfaiss_avx2.IndexIVF_search_and_reconstruct(self, n, x, k, distances, labels, recons, params)
+
+    def search_and_return_codes(self, n, x, k, distances, labels, recons, include_listno=False, params=None):
+        r"""
+         Similar to search, but also returns the codes corresponding to the
+        stored vectors for the search results.
+
+        :param codes:      codes (n, k, code_size)
+        :type include_listno: boolean, optional
+        :param include_listno:
+                              include the list ids in the code (in this case add
+                              ceil(log8(nlist)) to the code size)
+        """
+        return _swigfaiss_avx2.IndexIVF_search_and_return_codes(self, n, x, k, distances, labels, recons, include_listno, params)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        r"""
+         Reconstruct a vector given the location in terms of (inv list index +
+        inv list offset) instead of the id.
+
+        Useful for reconstructing when the direct_map is not maintained and
+        the inv list offset is computed by search_preassigned() with
+        `store_pairs` set.
+        """
+        return _swigfaiss_avx2.IndexIVF_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def remove_ids(self, sel):
+        r""" Dataset manipulation functions"""
+        return _swigfaiss_avx2.IndexIVF_remove_ids(self, sel)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss_avx2.IndexIVF_check_compatible_for_merge(self, otherIndex)
+
+    def merge_from(self, otherIndex, add_id):
+        return _swigfaiss_avx2.IndexIVF_merge_from(self, otherIndex, add_id)
+
+    def get_CodePacker(self):
+        return _swigfaiss_avx2.IndexIVF_get_CodePacker(self)
+
+    def copy_subset_to(self, other, subset_type, a1, a2):
+        r"""
+         copy a subset of the entries index to the other index
+        see Invlists::copy_subset_to for the meaning of subset_type
+        """
+        return _swigfaiss_avx2.IndexIVF_copy_subset_to(self, other, subset_type, a1, a2)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVF
+
+    def get_list_size(self, list_no):
+        return _swigfaiss_avx2.IndexIVF_get_list_size(self, list_no)
+
+    def check_ids_sorted(self):
+        r""" are the ids sorted?"""
+        return _swigfaiss_avx2.IndexIVF_check_ids_sorted(self)
+
+    def make_direct_map(self, new_maintain_direct_map=True):
+        r"""
+         initialize a direct map
+
+        :type new_maintain_direct_map: boolean, optional
+        :param new_maintain_direct_map:    if true, create a direct map,
+                                              else clear it
+        """
+        return _swigfaiss_avx2.IndexIVF_make_direct_map(self, new_maintain_direct_map)
+
+    def set_direct_map_type(self, type):
+        return _swigfaiss_avx2.IndexIVF_set_direct_map_type(self, type)
+
+    def replace_invlists(self, il, own=False):
+        r""" replace the inverted lists, old one is deallocated if own_invlists"""
+        return _swigfaiss_avx2.IndexIVF_replace_invlists(self, il, own)
+
+    def sa_code_size(self):
+        return _swigfaiss_avx2.IndexIVF_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss_avx2.IndexIVF_sa_encode(self, n, x, bytes)
+
+# Register IndexIVF in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVF_swigregister(IndexIVF)
+class InvertedListScanner(object):
+    r"""
+     Object that handles a query. The inverted lists to scan are
+    provided externally. The object has a lot of state, but
+    distance_to_code and scan_codes can be called in multiple
+    threads
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    list_no = property(_swigfaiss_avx2.InvertedListScanner_list_no_get, _swigfaiss_avx2.InvertedListScanner_list_no_set, doc=r""" remember current list""")
+    keep_max = property(_swigfaiss_avx2.InvertedListScanner_keep_max_get, _swigfaiss_avx2.InvertedListScanner_keep_max_set, doc=r""" keep maximum instead of minimum""")
+    store_pairs = property(_swigfaiss_avx2.InvertedListScanner_store_pairs_get, _swigfaiss_avx2.InvertedListScanner_store_pairs_set, doc=r""" store positions in invlists rather than labels""")
+    sel = property(_swigfaiss_avx2.InvertedListScanner_sel_get, _swigfaiss_avx2.InvertedListScanner_sel_set, doc=r""" search in this subset of ids""")
+    code_size = property(_swigfaiss_avx2.InvertedListScanner_code_size_get, _swigfaiss_avx2.InvertedListScanner_code_size_set, doc=r""" used in default implementation of scan_codes""")
+
+    def set_query(self, query_vector):
+        r""" from now on we handle this query."""
+        return _swigfaiss_avx2.InvertedListScanner_set_query(self, query_vector)
+
+    def set_list(self, list_no, coarse_dis):
+        r""" following codes come from this inverted list"""
+        return _swigfaiss_avx2.InvertedListScanner_set_list(self, list_no, coarse_dis)
+
+    def distance_to_code(self, code):
+        r""" compute a single query-to-code distance"""
+        return _swigfaiss_avx2.InvertedListScanner_distance_to_code(self, code)
+
+    def scan_codes(self, n, codes, ids, distances, labels, k):
+        r"""
+         scan a set of codes, compute distances to current query and
+        update heap of results if necessary. Default implemetation
+        calls distance_to_code.
+
+        :type n: int
+        :param n:      number of codes to scan
+        :type codes: uint8_t
+        :param codes:  codes to scan (n * code_size)
+        :type ids: int
+        :param ids:        corresponding ids (ignored if store_pairs)
+        :type distances: float
+        :param distances:  heap distances (size k)
+        :type labels: int
+        :param labels:     heap labels (size k)
+        :type k: int
+        :param k:          heap size
+        :rtype: int
+        :return: number of heap updates performed
+        """
+        return _swigfaiss_avx2.InvertedListScanner_scan_codes(self, n, codes, ids, distances, labels, k)
+
+    def iterate_codes(self, iterator, distances, labels, k, list_size):
+        return _swigfaiss_avx2.InvertedListScanner_iterate_codes(self, iterator, distances, labels, k, list_size)
+
+    def scan_codes_range(self, n, codes, ids, radius, result):
+        r"""
+         scan a set of codes, compute distances to current query and
+        update results if distances are below radius
+
+        (default implementation fails)
+        """
+        return _swigfaiss_avx2.InvertedListScanner_scan_codes_range(self, n, codes, ids, radius, result)
+
+    def iterate_codes_range(self, iterator, radius, result, list_size):
+        return _swigfaiss_avx2.InvertedListScanner_iterate_codes_range(self, iterator, radius, result, list_size)
+    __swig_destroy__ = _swigfaiss_avx2.delete_InvertedListScanner
+
+# Register InvertedListScanner in _swigfaiss_avx2:
+_swigfaiss_avx2.InvertedListScanner_swigregister(InvertedListScanner)
+class IndexIVFStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss_avx2.IndexIVFStats_nq_get, _swigfaiss_avx2.IndexIVFStats_nq_set)
+    nlist = property(_swigfaiss_avx2.IndexIVFStats_nlist_get, _swigfaiss_avx2.IndexIVFStats_nlist_set)
+    ndis = property(_swigfaiss_avx2.IndexIVFStats_ndis_get, _swigfaiss_avx2.IndexIVFStats_ndis_set)
+    nheap_updates = property(_swigfaiss_avx2.IndexIVFStats_nheap_updates_get, _swigfaiss_avx2.IndexIVFStats_nheap_updates_set)
+    quantization_time = property(_swigfaiss_avx2.IndexIVFStats_quantization_time_get, _swigfaiss_avx2.IndexIVFStats_quantization_time_set)
+    search_time = property(_swigfaiss_avx2.IndexIVFStats_search_time_get, _swigfaiss_avx2.IndexIVFStats_search_time_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.IndexIVFStats_swiginit(self, _swigfaiss_avx2.new_IndexIVFStats())
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexIVFStats_reset(self)
+
+    def add(self, other):
+        return _swigfaiss_avx2.IndexIVFStats_add(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFStats
+
+# Register IndexIVFStats in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFStats_swigregister(IndexIVFStats)
+
+def check_compatible_for_merge(index1, index2):
+    r"""
+     check if two indexes have the same parameters and are trained in
+    the same way, otherwise throw.
+    """
+    return _swigfaiss_avx2.check_compatible_for_merge(index1, index2)
+
+def extract_index_ivf(*args):
+    return _swigfaiss_avx2.extract_index_ivf(*args)
+
+def try_extract_index_ivf(*args):
+    return _swigfaiss_avx2.try_extract_index_ivf(*args)
+
+def merge_into(index0, index1, shift_ids):
+    r"""
+     Merge index1 into index0. Works on IndexIVF's and IndexIVF's
+     embedded in a IndexPreTransform. On output, the index1 is empty.
+
+    :type shift_ids: boolean
+    :param shift_ids:: translate the ids from index1 to index0->prev_ntotal
+    """
+    return _swigfaiss_avx2.merge_into(index0, index1, shift_ids)
+
+def search_centroid(index, x, n, centroid_ids):
+    return _swigfaiss_avx2.search_centroid(index, x, n, centroid_ids)
+
+def search_and_return_centroids(index, n, xin, k, distances, labels, query_centroid_ids, result_centroid_ids):
+    return _swigfaiss_avx2.search_and_return_centroids(index, n, xin, k, distances, labels, query_centroid_ids, result_centroid_ids)
+class SlidingIndexWindow(object):
+    r"""
+     A set of IndexIVFs concatenated together in a FIFO fashion.
+    at each "step", the oldest index slice is removed and a new index is added.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    index = property(_swigfaiss_avx2.SlidingIndexWindow_index_get, _swigfaiss_avx2.SlidingIndexWindow_index_set, doc=r""" common index that contains the sliding window""")
+    ils = property(_swigfaiss_avx2.SlidingIndexWindow_ils_get, _swigfaiss_avx2.SlidingIndexWindow_ils_set, doc=r""" InvertedLists of index""")
+    n_slice = property(_swigfaiss_avx2.SlidingIndexWindow_n_slice_get, _swigfaiss_avx2.SlidingIndexWindow_n_slice_set, doc=r""" number of slices currently in index""")
+    nlist = property(_swigfaiss_avx2.SlidingIndexWindow_nlist_get, _swigfaiss_avx2.SlidingIndexWindow_nlist_set, doc=r""" same as index->nlist""")
+    sizes = property(_swigfaiss_avx2.SlidingIndexWindow_sizes_get, _swigfaiss_avx2.SlidingIndexWindow_sizes_set, doc=r""" cumulative list sizes at each slice""")
+
+    def __init__(self, index):
+        r""" index should be initially empty and trained"""
+        _swigfaiss_avx2.SlidingIndexWindow_swiginit(self, _swigfaiss_avx2.new_SlidingIndexWindow(index))
+
+    def step(self, sub_index, remove_oldest):
+        r"""
+         Add one index to the current index and remove the oldest one.
+
+        :type sub_index: :py:class:`Index`
+        :param sub_index:        slice to swap in (can be NULL)
+        :type remove_oldest: boolean
+        :param remove_oldest:    if true, remove the oldest slices
+        """
+        return _swigfaiss_avx2.SlidingIndexWindow_step(self, sub_index, remove_oldest)
+    __swig_destroy__ = _swigfaiss_avx2.delete_SlidingIndexWindow
+
+# Register SlidingIndexWindow in _swigfaiss_avx2:
+_swigfaiss_avx2.SlidingIndexWindow_swigregister(SlidingIndexWindow)
+
+def get_invlist_range(index, i0, i1):
+    r""" Get a subset of inverted lists [i0, i1)"""
+    return _swigfaiss_avx2.get_invlist_range(index, i0, i1)
+
+def set_invlist_range(index, i0, i1, src):
+    r""" Set a subset of inverted lists"""
+    return _swigfaiss_avx2.set_invlist_range(index, i0, i1, src)
+
+def search_with_parameters(index, n, x, k, distances, labels, params, nb_dis=None, ms_per_stage=None):
+    r"""
+     search an IndexIVF, possibly embedded in an IndexPreTransform with
+    given parameters. This is a way to set the nprobe and get
+    statdistics in a thread-safe way.
+
+    Optionally returns (if non-nullptr):
+    - nb_dis: number of distances computed
+    - ms_per_stage: [0]: preprocessing time
+                    [1]: coarse quantization,
+                    [2]: list scanning
+    """
+    return _swigfaiss_avx2.search_with_parameters(index, n, x, k, distances, labels, params, nb_dis, ms_per_stage)
+
+def range_search_with_parameters(index, n, x, radius, result, params, nb_dis=None, ms_per_stage=None):
+    r""" same as search_with_parameters but for range search"""
+    return _swigfaiss_avx2.range_search_with_parameters(index, n, x, radius, result, params, nb_dis, ms_per_stage)
+
+def ivf_residual_from_quantizer(arg1, nlevel):
+    r"""
+     Build an IndexIVFResidualQuantizer from an ResidualQuantizer, using the
+    nlevel first components as coarse quantizer and the rest as codes in invlists
+    """
+    return _swigfaiss_avx2.ivf_residual_from_quantizer(arg1, nlevel)
+
+def ivf_residual_add_from_flat_codes(ivfrq, ncode, codes, code_size=-1):
+    r"""
+     add from codes. NB that the norm component is not used, so the code_size can
+    be provided.
+
+    :type ivfrq: :py:class:`IndexIVFResidualQuantizer`
+    :param ivfrq:      index to populate with the codes
+    :type codes: uint8_t
+    :param codes:      codes to add, size (ncode, code_size)
+    :type code_size: int, optional
+    :param code_size:  override the ivfrq's code_size, useful if the norm encoding
+                          is different
+    """
+    return _swigfaiss_avx2.ivf_residual_add_from_flat_codes(ivfrq, ncode, codes, code_size)
+class ScalarQuantizer(Quantizer):
+    r"""
+    The uniform quantizer has a range [vmin, vmax]. The range can be
+    the same for all dimensions (uniform) or specific per dimension
+    (default).
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    QT_8bit = _swigfaiss_avx2.ScalarQuantizer_QT_8bit
+    r""" 8 bits per component"""
+    QT_4bit = _swigfaiss_avx2.ScalarQuantizer_QT_4bit
+    r""" 4 bits per component"""
+    QT_8bit_uniform = _swigfaiss_avx2.ScalarQuantizer_QT_8bit_uniform
+    r""" same, shared range for all dimensions"""
+    QT_4bit_uniform = _swigfaiss_avx2.ScalarQuantizer_QT_4bit_uniform
+    QT_fp16 = _swigfaiss_avx2.ScalarQuantizer_QT_fp16
+    QT_8bit_direct = _swigfaiss_avx2.ScalarQuantizer_QT_8bit_direct
+    r""" fast indexing of uint8s"""
+    QT_6bit = _swigfaiss_avx2.ScalarQuantizer_QT_6bit
+    r""" 6 bits per component"""
+    qtype = property(_swigfaiss_avx2.ScalarQuantizer_qtype_get, _swigfaiss_avx2.ScalarQuantizer_qtype_set)
+    RS_minmax = _swigfaiss_avx2.ScalarQuantizer_RS_minmax
+    r""" [min - rs*(max-min), max + rs*(max-min)]"""
+    RS_meanstd = _swigfaiss_avx2.ScalarQuantizer_RS_meanstd
+    r""" [mean - std * rs, mean + std * rs]"""
+    RS_quantiles = _swigfaiss_avx2.ScalarQuantizer_RS_quantiles
+    r""" [Q(rs), Q(1-rs)]"""
+    RS_optim = _swigfaiss_avx2.ScalarQuantizer_RS_optim
+    r""" alternate optimization of reconstruction error"""
+    rangestat = property(_swigfaiss_avx2.ScalarQuantizer_rangestat_get, _swigfaiss_avx2.ScalarQuantizer_rangestat_set)
+    rangestat_arg = property(_swigfaiss_avx2.ScalarQuantizer_rangestat_arg_get, _swigfaiss_avx2.ScalarQuantizer_rangestat_arg_set)
+    bits = property(_swigfaiss_avx2.ScalarQuantizer_bits_get, _swigfaiss_avx2.ScalarQuantizer_bits_set, doc=r""" bits per scalar code""")
+    trained = property(_swigfaiss_avx2.ScalarQuantizer_trained_get, _swigfaiss_avx2.ScalarQuantizer_trained_set, doc=r""" trained values (including the range)""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.ScalarQuantizer_swiginit(self, _swigfaiss_avx2.new_ScalarQuantizer(*args))
+
+    def set_derived_sizes(self):
+        r""" updates internal values based on qtype and d"""
+        return _swigfaiss_avx2.ScalarQuantizer_set_derived_sizes(self)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.ScalarQuantizer_train(self, n, x)
+
+    def compute_codes(self, x, codes, n):
+        r"""
+         Encode a set of vectors
+
+        :type x: float
+        :param x:      vectors to encode, size n * d
+        :type codes: uint8_t
+        :param codes:  output codes, size n * code_size
+        """
+        return _swigfaiss_avx2.ScalarQuantizer_compute_codes(self, x, codes, n)
+
+    def decode(self, code, x, n):
+        r"""
+         Decode a set of vectors
+
+        :param codes:  codes to decode, size n * code_size
+        :type x: float
+        :param x:      output vectors, size n * d
+        """
+        return _swigfaiss_avx2.ScalarQuantizer_decode(self, code, x, n)
+
+    def select_quantizer(self):
+        return _swigfaiss_avx2.ScalarQuantizer_select_quantizer(self)
+
+    def get_distance_computer(self, *args):
+        return _swigfaiss_avx2.ScalarQuantizer_get_distance_computer(self, *args)
+
+    def select_InvertedListScanner(self, mt, quantizer, store_pairs, sel, by_residual=False):
+        return _swigfaiss_avx2.ScalarQuantizer_select_InvertedListScanner(self, mt, quantizer, store_pairs, sel, by_residual)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ScalarQuantizer
+
+# Register ScalarQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.ScalarQuantizer_swigregister(ScalarQuantizer)
+class IndexScalarQuantizer(IndexFlatCodes):
+    r"""Flat index built on a scalar quantizer."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    sq = property(_swigfaiss_avx2.IndexScalarQuantizer_sq_get, _swigfaiss_avx2.IndexScalarQuantizer_sq_set, doc=r""" Used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexScalarQuantizer_swiginit(self, _swigfaiss_avx2.new_IndexScalarQuantizer(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexScalarQuantizer_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexScalarQuantizer_search(self, n, x, k, distances, labels, params)
+
+    def get_FlatCodesDistanceComputer(self):
+        return _swigfaiss_avx2.IndexScalarQuantizer_get_FlatCodesDistanceComputer(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss_avx2.IndexScalarQuantizer_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexScalarQuantizer_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexScalarQuantizer
+
+# Register IndexScalarQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexScalarQuantizer_swigregister(IndexScalarQuantizer)
+class IndexIVFScalarQuantizer(IndexIVF):
+    r"""
+     An IVF implementation where the components of the residuals are
+    encoded with a scalar quantizer. All distance computations
+    are asymmetric, so the encoded vectors are decoded and approximate
+    distances are computed.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    sq = property(_swigfaiss_avx2.IndexIVFScalarQuantizer_sq_get, _swigfaiss_avx2.IndexIVFScalarQuantizer_sq_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFScalarQuantizer_swiginit(self, _swigfaiss_avx2.new_IndexIVFScalarQuantizer(*args))
+
+    def train_encoder(self, n, x, assign):
+        return _swigfaiss_avx2.IndexIVFScalarQuantizer_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        return _swigfaiss_avx2.IndexIVFScalarQuantizer_train_encoder_num_vectors(self)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listnos=False):
+        return _swigfaiss_avx2.IndexIVFScalarQuantizer_encode_vectors(self, n, x, list_nos, codes, include_listnos)
+
+    def add_core(self, n, x, xids, precomputed_idx, inverted_list_context=None):
+        return _swigfaiss_avx2.IndexIVFScalarQuantizer_add_core(self, n, x, xids, precomputed_idx, inverted_list_context)
+
+    def get_InvertedListScanner(self, store_pairs, sel):
+        return _swigfaiss_avx2.IndexIVFScalarQuantizer_get_InvertedListScanner(self, store_pairs, sel)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        return _swigfaiss_avx2.IndexIVFScalarQuantizer_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexIVFScalarQuantizer_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFScalarQuantizer
+
+# Register IndexIVFScalarQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFScalarQuantizer_swigregister(IndexIVFScalarQuantizer)
+class IndexIVFSpectralHash(IndexIVF):
+    r"""
+     Inverted list that stores binary codes of size nbit. Before the
+    binary conversion, the dimension of the vectors is transformed from
+    dim d into dim nbit by vt (a random rotation by default).
+
+    Each coordinate is subtracted from a value determined by
+    threshold_type, and split into intervals of size period. Half of
+    the interval is a 0 bit, the other half a 1.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    vt = property(_swigfaiss_avx2.IndexIVFSpectralHash_vt_get, _swigfaiss_avx2.IndexIVFSpectralHash_vt_set, doc=r""" transformation from d to nbit dim""")
+    own_fields = property(_swigfaiss_avx2.IndexIVFSpectralHash_own_fields_get, _swigfaiss_avx2.IndexIVFSpectralHash_own_fields_set, doc=r""" own the vt""")
+    nbit = property(_swigfaiss_avx2.IndexIVFSpectralHash_nbit_get, _swigfaiss_avx2.IndexIVFSpectralHash_nbit_set, doc=r""" nb of bits of the binary signature""")
+    period = property(_swigfaiss_avx2.IndexIVFSpectralHash_period_get, _swigfaiss_avx2.IndexIVFSpectralHash_period_set, doc=r""" interval size for 0s and 1s""")
+    Thresh_global = _swigfaiss_avx2.IndexIVFSpectralHash_Thresh_global
+    r""" global threshold at 0"""
+    Thresh_centroid = _swigfaiss_avx2.IndexIVFSpectralHash_Thresh_centroid
+    r""" compare to centroid"""
+    Thresh_centroid_half = _swigfaiss_avx2.IndexIVFSpectralHash_Thresh_centroid_half
+    r""" central interval around centroid"""
+    Thresh_median = _swigfaiss_avx2.IndexIVFSpectralHash_Thresh_median
+    r""" median of training set"""
+    threshold_type = property(_swigfaiss_avx2.IndexIVFSpectralHash_threshold_type_get, _swigfaiss_avx2.IndexIVFSpectralHash_threshold_type_set)
+    trained = property(_swigfaiss_avx2.IndexIVFSpectralHash_trained_get, _swigfaiss_avx2.IndexIVFSpectralHash_trained_set, doc=r"""
+    Trained threshold.
+    size nlist * nbit or 0 if Thresh_global
+    """)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFSpectralHash_swiginit(self, _swigfaiss_avx2.new_IndexIVFSpectralHash(*args))
+
+    def train_encoder(self, n, x, assign):
+        return _swigfaiss_avx2.IndexIVFSpectralHash_train_encoder(self, n, x, assign)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listnos=False):
+        return _swigfaiss_avx2.IndexIVFSpectralHash_encode_vectors(self, n, x, list_nos, codes, include_listnos)
+
+    def get_InvertedListScanner(self, store_pairs, sel):
+        return _swigfaiss_avx2.IndexIVFSpectralHash_get_InvertedListScanner(self, store_pairs, sel)
+
+    def replace_vt(self, *args):
+        r"""
+        *Overload 1:*
+         replace the vector transform for an empty (and possibly untrained) index
+
+        |
+
+        *Overload 2:*
+         convenience function to get the VT from an index constucted by an
+        index_factory (should end in "LSH")
+
+        |
+
+        *Overload 3:*
+         convenience function to get the VT from an index constucted by an
+        index_factory (should end in "LSH")
+        """
+        return _swigfaiss_avx2.IndexIVFSpectralHash_replace_vt(self, *args)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFSpectralHash
+
+# Register IndexIVFSpectralHash in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFSpectralHash_swigregister(IndexIVFSpectralHash)
+class IndexIVFAdditiveQuantizer(IndexIVF):
+    r"""
+    Abstract class for IVF additive quantizers.
+    The search functions are in common.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    aq = property(_swigfaiss_avx2.IndexIVFAdditiveQuantizer_aq_get, _swigfaiss_avx2.IndexIVFAdditiveQuantizer_aq_set)
+    use_precomputed_table = property(_swigfaiss_avx2.IndexIVFAdditiveQuantizer_use_precomputed_table_get, _swigfaiss_avx2.IndexIVFAdditiveQuantizer_use_precomputed_table_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFAdditiveQuantizer_swiginit(self, _swigfaiss_avx2.new_IndexIVFAdditiveQuantizer(*args))
+
+    def train_encoder(self, n, x, assign):
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizer_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizer_train_encoder_num_vectors(self)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listnos=False):
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizer_encode_vectors(self, n, x, list_nos, codes, include_listnos)
+
+    def get_InvertedListScanner(self, store_pairs, sel):
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizer_get_InvertedListScanner(self, store_pairs, sel)
+
+    def sa_decode(self, n, codes, x):
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizer_sa_decode(self, n, codes, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFAdditiveQuantizer
+
+# Register IndexIVFAdditiveQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFAdditiveQuantizer_swigregister(IndexIVFAdditiveQuantizer)
+class IndexIVFResidualQuantizer(IndexIVFAdditiveQuantizer):
+    r"""
+     IndexIVF based on a residual quantizer. Stored vectors are
+    approximated by residual quantization codes.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rq = property(_swigfaiss_avx2.IndexIVFResidualQuantizer_rq_get, _swigfaiss_avx2.IndexIVFResidualQuantizer_rq_set, doc=r""" The residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFResidualQuantizer_swiginit(self, _swigfaiss_avx2.new_IndexIVFResidualQuantizer(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFResidualQuantizer
+
+# Register IndexIVFResidualQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFResidualQuantizer_swigregister(IndexIVFResidualQuantizer)
+class IndexIVFLocalSearchQuantizer(IndexIVFAdditiveQuantizer):
+    r"""
+     IndexIVF based on a residual quantizer. Stored vectors are
+    approximated by residual quantization codes.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lsq = property(_swigfaiss_avx2.IndexIVFLocalSearchQuantizer_lsq_get, _swigfaiss_avx2.IndexIVFLocalSearchQuantizer_lsq_set, doc=r""" The LSQ quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFLocalSearchQuantizer_swiginit(self, _swigfaiss_avx2.new_IndexIVFLocalSearchQuantizer(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFLocalSearchQuantizer
+
+# Register IndexIVFLocalSearchQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFLocalSearchQuantizer_swigregister(IndexIVFLocalSearchQuantizer)
+class IndexIVFProductResidualQuantizer(IndexIVFAdditiveQuantizer):
+    r"""
+     IndexIVF based on a product residual quantizer. Stored vectors are
+    approximated by product residual quantization codes.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    prq = property(_swigfaiss_avx2.IndexIVFProductResidualQuantizer_prq_get, _swigfaiss_avx2.IndexIVFProductResidualQuantizer_prq_set, doc=r""" The product residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFProductResidualQuantizer_swiginit(self, _swigfaiss_avx2.new_IndexIVFProductResidualQuantizer(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFProductResidualQuantizer
+
+# Register IndexIVFProductResidualQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFProductResidualQuantizer_swigregister(IndexIVFProductResidualQuantizer)
+class IndexIVFProductLocalSearchQuantizer(IndexIVFAdditiveQuantizer):
+    r"""
+     IndexIVF based on a product local search quantizer. Stored vectors are
+    approximated by product local search quantization codes.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    plsq = property(_swigfaiss_avx2.IndexIVFProductLocalSearchQuantizer_plsq_get, _swigfaiss_avx2.IndexIVFProductLocalSearchQuantizer_plsq_set, doc=r""" The product local search quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFProductLocalSearchQuantizer_swiginit(self, _swigfaiss_avx2.new_IndexIVFProductLocalSearchQuantizer(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFProductLocalSearchQuantizer
+
+# Register IndexIVFProductLocalSearchQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFProductLocalSearchQuantizer_swigregister(IndexIVFProductLocalSearchQuantizer)
+class SearchParametersHNSW(SearchParameters):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    efSearch = property(_swigfaiss_avx2.SearchParametersHNSW_efSearch_get, _swigfaiss_avx2.SearchParametersHNSW_efSearch_set)
+    check_relative_distance = property(_swigfaiss_avx2.SearchParametersHNSW_check_relative_distance_get, _swigfaiss_avx2.SearchParametersHNSW_check_relative_distance_set)
+    __swig_destroy__ = _swigfaiss_avx2.delete_SearchParametersHNSW
+
+    def __init__(self):
+        _swigfaiss_avx2.SearchParametersHNSW_swiginit(self, _swigfaiss_avx2.new_SearchParametersHNSW())
+
+# Register SearchParametersHNSW in _swigfaiss_avx2:
+_swigfaiss_avx2.SearchParametersHNSW_swigregister(SearchParametersHNSW)
+class HNSW(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    assign_probas = property(_swigfaiss_avx2.HNSW_assign_probas_get, _swigfaiss_avx2.HNSW_assign_probas_set, doc=r""" assignment probability to each layer (sum=1)""")
+    cum_nneighbor_per_level = property(_swigfaiss_avx2.HNSW_cum_nneighbor_per_level_get, _swigfaiss_avx2.HNSW_cum_nneighbor_per_level_set, doc=r"""
+    number of neighbors stored per layer (cumulative), should not
+    be changed after first add
+    """)
+    levels = property(_swigfaiss_avx2.HNSW_levels_get, _swigfaiss_avx2.HNSW_levels_set, doc=r""" level of each vector (base level = 1), size = ntotal""")
+    offsets = property(_swigfaiss_avx2.HNSW_offsets_get, _swigfaiss_avx2.HNSW_offsets_set, doc=r"""
+    offsets[i] is the offset in the neighbors array where vector i is stored
+    size ntotal + 1
+    """)
+    neighbors = property(_swigfaiss_avx2.HNSW_neighbors_get, _swigfaiss_avx2.HNSW_neighbors_set, doc=r"""
+    neighbors[offsets[i]:offsets[i+1]] is the list of neighbors of vector i
+    for all levels. this is where all storage goes.
+    """)
+    entry_point = property(_swigfaiss_avx2.HNSW_entry_point_get, _swigfaiss_avx2.HNSW_entry_point_set, doc=r"""
+    entry point in the search structure (one of the points with maximum
+    level
+    """)
+    rng = property(_swigfaiss_avx2.HNSW_rng_get, _swigfaiss_avx2.HNSW_rng_set)
+    max_level = property(_swigfaiss_avx2.HNSW_max_level_get, _swigfaiss_avx2.HNSW_max_level_set, doc=r""" maximum level""")
+    efConstruction = property(_swigfaiss_avx2.HNSW_efConstruction_get, _swigfaiss_avx2.HNSW_efConstruction_set, doc=r""" expansion factor at construction time""")
+    efSearch = property(_swigfaiss_avx2.HNSW_efSearch_get, _swigfaiss_avx2.HNSW_efSearch_set, doc=r""" expansion factor at search time""")
+    check_relative_distance = property(_swigfaiss_avx2.HNSW_check_relative_distance_get, _swigfaiss_avx2.HNSW_check_relative_distance_set, doc=r"""
+    during search: do we check whether the next best distance is good
+    enough?
+    """)
+    upper_beam = property(_swigfaiss_avx2.HNSW_upper_beam_get, _swigfaiss_avx2.HNSW_upper_beam_set, doc=r""" number of entry points in levels > 0.""")
+    search_bounded_queue = property(_swigfaiss_avx2.HNSW_search_bounded_queue_get, _swigfaiss_avx2.HNSW_search_bounded_queue_set, doc=r""" use bounded queue during exploration""")
+
+    def set_default_probas(self, M, levelMult):
+        r"""
+        initialize the assign_probas and cum_nneighbor_per_level to
+        have 2*M links on level 0 and M links on levels > 0
+        """
+        return _swigfaiss_avx2.HNSW_set_default_probas(self, M, levelMult)
+
+    def set_nb_neighbors(self, level_no, n):
+        r""" set nb of neighbors for this level (before adding anything)"""
+        return _swigfaiss_avx2.HNSW_set_nb_neighbors(self, level_no, n)
+
+    def nb_neighbors(self, layer_no):
+        r""" nb of neighbors for this level"""
+        return _swigfaiss_avx2.HNSW_nb_neighbors(self, layer_no)
+
+    def cum_nb_neighbors(self, layer_no):
+        r""" cumumlative nb up to (and excluding) this level"""
+        return _swigfaiss_avx2.HNSW_cum_nb_neighbors(self, layer_no)
+
+    def neighbor_range(self, no, layer_no, begin, end):
+        r""" range of entries in the neighbors table of vertex no at layer_no"""
+        return _swigfaiss_avx2.HNSW_neighbor_range(self, no, layer_no, begin, end)
+
+    def __init__(self, M=32):
+        r""" only mandatory parameter: nb of neighbors"""
+        _swigfaiss_avx2.HNSW_swiginit(self, _swigfaiss_avx2.new_HNSW(M))
+
+    def random_level(self):
+        r""" pick a random level for a new point"""
+        return _swigfaiss_avx2.HNSW_random_level(self)
+
+    def fill_with_random_links(self, n):
+        r""" add n random levels to table (for debugging...)"""
+        return _swigfaiss_avx2.HNSW_fill_with_random_links(self, n)
+
+    def add_links_starting_from(self, ptdis, pt_id, nearest, d_nearest, level, locks, vt):
+        return _swigfaiss_avx2.HNSW_add_links_starting_from(self, ptdis, pt_id, nearest, d_nearest, level, locks, vt)
+
+    def add_with_locks(self, ptdis, pt_level, pt_id, locks, vt):
+        r"""
+         add point pt_id on all levels <= pt_level and build the link
+        structure for them.
+        """
+        return _swigfaiss_avx2.HNSW_add_with_locks(self, ptdis, pt_level, pt_id, locks, vt)
+
+    def search(self, qdis, res, vt, params=None):
+        r""" search interface for 1 point, single thread"""
+        return _swigfaiss_avx2.HNSW_search(self, qdis, res, vt, params)
+
+    def search_level_0(self, qdis, res, nprobe, nearest_i, nearest_d, search_type, search_stats, vt):
+        r""" search only in level 0 from a given vertex"""
+        return _swigfaiss_avx2.HNSW_search_level_0(self, qdis, res, nprobe, nearest_i, nearest_d, search_type, search_stats, vt)
+
+    def reset(self):
+        return _swigfaiss_avx2.HNSW_reset(self)
+
+    def clear_neighbor_tables(self, level):
+        return _swigfaiss_avx2.HNSW_clear_neighbor_tables(self, level)
+
+    def print_neighbor_stats(self, level):
+        return _swigfaiss_avx2.HNSW_print_neighbor_stats(self, level)
+
+    def prepare_level_tab(self, n, preset_levels=False):
+        return _swigfaiss_avx2.HNSW_prepare_level_tab(self, n, preset_levels)
+
+    @staticmethod
+    def shrink_neighbor_list(qdis, input, output, max_size):
+        return _swigfaiss_avx2.HNSW_shrink_neighbor_list(qdis, input, output, max_size)
+
+    def permute_entries(self, map):
+        return _swigfaiss_avx2.HNSW_permute_entries(self, map)
+    __swig_destroy__ = _swigfaiss_avx2.delete_HNSW
+
+# Register HNSW in _swigfaiss_avx2:
+_swigfaiss_avx2.HNSW_swigregister(HNSW)
+class HNSWStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    n1 = property(_swigfaiss_avx2.HNSWStats_n1_get, _swigfaiss_avx2.HNSWStats_n1_set)
+    n2 = property(_swigfaiss_avx2.HNSWStats_n2_get, _swigfaiss_avx2.HNSWStats_n2_set)
+    n3 = property(_swigfaiss_avx2.HNSWStats_n3_get, _swigfaiss_avx2.HNSWStats_n3_set)
+    ndis = property(_swigfaiss_avx2.HNSWStats_ndis_get, _swigfaiss_avx2.HNSWStats_ndis_set)
+    nreorder = property(_swigfaiss_avx2.HNSWStats_nreorder_get, _swigfaiss_avx2.HNSWStats_nreorder_set)
+
+    def __init__(self, n1=0, n2=0, n3=0, ndis=0, nreorder=0):
+        _swigfaiss_avx2.HNSWStats_swiginit(self, _swigfaiss_avx2.new_HNSWStats(n1, n2, n3, ndis, nreorder))
+
+    def reset(self):
+        return _swigfaiss_avx2.HNSWStats_reset(self)
+
+    def combine(self, other):
+        return _swigfaiss_avx2.HNSWStats_combine(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_HNSWStats
+
+# Register HNSWStats in _swigfaiss_avx2:
+_swigfaiss_avx2.HNSWStats_swigregister(HNSWStats)
+class IndexHNSW(Index):
+    r"""
+     The HNSW index is a normal random-access index with a HNSW
+    link structure built on top
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    hnsw = property(_swigfaiss_avx2.IndexHNSW_hnsw_get, _swigfaiss_avx2.IndexHNSW_hnsw_set)
+    own_fields = property(_swigfaiss_avx2.IndexHNSW_own_fields_get, _swigfaiss_avx2.IndexHNSW_own_fields_set)
+    storage = property(_swigfaiss_avx2.IndexHNSW_storage_get, _swigfaiss_avx2.IndexHNSW_storage_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexHNSW_swiginit(self, _swigfaiss_avx2.new_IndexHNSW(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexHNSW
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexHNSW_add(self, n, x)
+
+    def train(self, n, x):
+        r""" Trains the storage if needed"""
+        return _swigfaiss_avx2.IndexHNSW_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" entry point for search"""
+        return _swigfaiss_avx2.IndexHNSW_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss_avx2.IndexHNSW_range_search(self, n, x, radius, result, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexHNSW_reconstruct(self, key, recons)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexHNSW_reset(self)
+
+    def shrink_level_0_neighbors(self, size):
+        return _swigfaiss_avx2.IndexHNSW_shrink_level_0_neighbors(self, size)
+
+    def search_level_0(self, n, x, k, nearest, nearest_d, distances, labels, nprobe=1, search_type=1):
+        r"""
+         Perform search only on level 0, given the starting points for
+        each vertex.
+
+        :type search_type: int, optional
+        :param search_type: 1:perform one search per nprobe, 2: enqueue
+                               all entry points
+        """
+        return _swigfaiss_avx2.IndexHNSW_search_level_0(self, n, x, k, nearest, nearest_d, distances, labels, nprobe, search_type)
+
+    def init_level_0_from_knngraph(self, k, D, I):
+        r""" alternative graph building"""
+        return _swigfaiss_avx2.IndexHNSW_init_level_0_from_knngraph(self, k, D, I)
+
+    def init_level_0_from_entry_points(self, npt, points, nearests):
+        r""" alternative graph building"""
+        return _swigfaiss_avx2.IndexHNSW_init_level_0_from_entry_points(self, npt, points, nearests)
+
+    def reorder_links(self):
+        return _swigfaiss_avx2.IndexHNSW_reorder_links(self)
+
+    def link_singletons(self):
+        return _swigfaiss_avx2.IndexHNSW_link_singletons(self)
+
+    def permute_entries(self, perm):
+        return _swigfaiss_avx2.IndexHNSW_permute_entries(self, perm)
+
+# Register IndexHNSW in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexHNSW_swigregister(IndexHNSW)
+class IndexHNSWFlat(IndexHNSW):
+    r"""
+    Flat index topped with with a HNSW structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexHNSWFlat_swiginit(self, _swigfaiss_avx2.new_IndexHNSWFlat(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexHNSWFlat
+
+# Register IndexHNSWFlat in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexHNSWFlat_swigregister(IndexHNSWFlat)
+class IndexHNSWPQ(IndexHNSW):
+    r"""
+    PQ index topped with with a HNSW structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexHNSWPQ_swiginit(self, _swigfaiss_avx2.new_IndexHNSWPQ(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexHNSWPQ_train(self, n, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexHNSWPQ
+
+# Register IndexHNSWPQ in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexHNSWPQ_swigregister(IndexHNSWPQ)
+class IndexHNSWSQ(IndexHNSW):
+    r"""
+    SQ index topped with with a HNSW structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexHNSWSQ_swiginit(self, _swigfaiss_avx2.new_IndexHNSWSQ(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexHNSWSQ
+
+# Register IndexHNSWSQ in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexHNSWSQ_swigregister(IndexHNSWSQ)
+class IndexHNSW2Level(IndexHNSW):
+    r""" 2-level code structure with fast random access"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexHNSW2Level_swiginit(self, _swigfaiss_avx2.new_IndexHNSW2Level(*args))
+
+    def flip_to_ivf(self):
+        return _swigfaiss_avx2.IndexHNSW2Level_flip_to_ivf(self)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" entry point for search"""
+        return _swigfaiss_avx2.IndexHNSW2Level_search(self, n, x, k, distances, labels, params)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexHNSW2Level
+
+# Register IndexHNSW2Level in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexHNSW2Level_swigregister(IndexHNSW2Level)
+
+def smawk(nrows, ncols, x, argmins):
+    r"""
+     SMAWK algorithm. Find the row minima of a monotone matrix.
+
+    Expose this for testing.
+
+    :type nrows: int
+    :param nrows:    number of rows
+    :type ncols: int
+    :param ncols:    number of columns
+    :type x: float
+    :param x:        input matrix, size (nrows, ncols)
+    :type argmins: int
+    :param argmins:  argmin of each row
+    """
+    return _swigfaiss_avx2.smawk(nrows, ncols, x, argmins)
+
+def kmeans1d(x, n, nclusters, centroids):
+    r"""
+     Exact 1D K-Means by dynamic programming
+
+    From  "Fast Exact k-Means, k-Medians and Bregman Divergence Clustering in 1D"
+    Allan Grønlund, Kasper Green Larsen, Alexander Mathiasen, Jesper Sindahl
+    Nielsen, Stefan Schneider, Mingzhou Song, ArXiV'17
+
+    Section 2.2
+
+    https://arxiv.org/abs/1701.07204
+
+    :type x: float
+    :param x:          input 1D array
+    :type n: int
+    :param n:          input array length
+    :type nclusters: int
+    :param nclusters:  number of clusters
+    :type centroids: float
+    :param centroids:  output centroids, size nclusters
+    :rtype: float
+    :return: imbalancce factor
+    """
+    return _swigfaiss_avx2.kmeans1d(x, n, nclusters, centroids)
+class Neighbor(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    id = property(_swigfaiss_avx2.Neighbor_id_get, _swigfaiss_avx2.Neighbor_id_set)
+    distance = property(_swigfaiss_avx2.Neighbor_distance_get, _swigfaiss_avx2.Neighbor_distance_set)
+    flag = property(_swigfaiss_avx2.Neighbor_flag_get, _swigfaiss_avx2.Neighbor_flag_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.Neighbor_swiginit(self, _swigfaiss_avx2.new_Neighbor(*args))
+
+    def __lt__(self, other):
+        return _swigfaiss_avx2.Neighbor___lt__(self, other)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Neighbor
+
+# Register Neighbor in _swigfaiss_avx2:
+_swigfaiss_avx2.Neighbor_swigregister(Neighbor)
+class Nhood(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    pool = property(_swigfaiss_avx2.Nhood_pool_get, _swigfaiss_avx2.Nhood_pool_set)
+    M = property(_swigfaiss_avx2.Nhood_M_get, _swigfaiss_avx2.Nhood_M_set)
+    nn_old = property(_swigfaiss_avx2.Nhood_nn_old_get, _swigfaiss_avx2.Nhood_nn_old_set)
+    nn_new = property(_swigfaiss_avx2.Nhood_nn_new_get, _swigfaiss_avx2.Nhood_nn_new_set)
+    rnn_old = property(_swigfaiss_avx2.Nhood_rnn_old_get, _swigfaiss_avx2.Nhood_rnn_old_set)
+    rnn_new = property(_swigfaiss_avx2.Nhood_rnn_new_get, _swigfaiss_avx2.Nhood_rnn_new_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.Nhood_swiginit(self, _swigfaiss_avx2.new_Nhood(*args))
+
+    def insert(self, id, dist):
+        return _swigfaiss_avx2.Nhood_insert(self, id, dist)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Nhood
+
+# Register Nhood in _swigfaiss_avx2:
+_swigfaiss_avx2.Nhood_swigregister(Nhood)
+class NNDescent(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, d, K):
+        _swigfaiss_avx2.NNDescent_swiginit(self, _swigfaiss_avx2.new_NNDescent(d, K))
+    __swig_destroy__ = _swigfaiss_avx2.delete_NNDescent
+
+    def build(self, qdis, n, verbose):
+        return _swigfaiss_avx2.NNDescent_build(self, qdis, n, verbose)
+
+    def search(self, qdis, topk, indices, dists, vt):
+        return _swigfaiss_avx2.NNDescent_search(self, qdis, topk, indices, dists, vt)
+
+    def reset(self):
+        return _swigfaiss_avx2.NNDescent_reset(self)
+
+    def init_graph(self, qdis):
+        r""" Initialize the KNN graph randomly"""
+        return _swigfaiss_avx2.NNDescent_init_graph(self, qdis)
+
+    def nndescent(self, qdis, verbose):
+        r""" Perform NNDescent algorithm"""
+        return _swigfaiss_avx2.NNDescent_nndescent(self, qdis, verbose)
+
+    def join(self, qdis):
+        r""" Perform local join on each node"""
+        return _swigfaiss_avx2.NNDescent_join(self, qdis)
+
+    def update(self):
+        r""" Sample new neighbors for each node to peform local join later"""
+        return _swigfaiss_avx2.NNDescent_update(self)
+
+    def generate_eval_set(self, qdis, c, v, N):
+        r""" Sample a small number of points to evaluate the quality of KNNG built"""
+        return _swigfaiss_avx2.NNDescent_generate_eval_set(self, qdis, c, v, N)
+
+    def eval_recall(self, ctrl_points, acc_eval_set):
+        r""" Evaluate the quality of KNNG built"""
+        return _swigfaiss_avx2.NNDescent_eval_recall(self, ctrl_points, acc_eval_set)
+    has_built = property(_swigfaiss_avx2.NNDescent_has_built_get, _swigfaiss_avx2.NNDescent_has_built_set)
+    S = property(_swigfaiss_avx2.NNDescent_S_get, _swigfaiss_avx2.NNDescent_S_set)
+    R = property(_swigfaiss_avx2.NNDescent_R_get, _swigfaiss_avx2.NNDescent_R_set)
+    iter = property(_swigfaiss_avx2.NNDescent_iter_get, _swigfaiss_avx2.NNDescent_iter_set)
+    search_L = property(_swigfaiss_avx2.NNDescent_search_L_get, _swigfaiss_avx2.NNDescent_search_L_set)
+    random_seed = property(_swigfaiss_avx2.NNDescent_random_seed_get, _swigfaiss_avx2.NNDescent_random_seed_set)
+    K = property(_swigfaiss_avx2.NNDescent_K_get, _swigfaiss_avx2.NNDescent_K_set)
+    d = property(_swigfaiss_avx2.NNDescent_d_get, _swigfaiss_avx2.NNDescent_d_set)
+    L = property(_swigfaiss_avx2.NNDescent_L_get, _swigfaiss_avx2.NNDescent_L_set)
+    ntotal = property(_swigfaiss_avx2.NNDescent_ntotal_get, _swigfaiss_avx2.NNDescent_ntotal_set)
+    graph = property(_swigfaiss_avx2.NNDescent_graph_get, _swigfaiss_avx2.NNDescent_graph_set)
+    final_graph = property(_swigfaiss_avx2.NNDescent_final_graph_get, _swigfaiss_avx2.NNDescent_final_graph_set)
+
+# Register NNDescent in _swigfaiss_avx2:
+_swigfaiss_avx2.NNDescent_swigregister(NNDescent)
+class IndexNNDescent(Index):
+    r"""
+     The NNDescent index is a normal random-access index with an NNDescent
+    link structure built on top
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nndescent = property(_swigfaiss_avx2.IndexNNDescent_nndescent_get, _swigfaiss_avx2.IndexNNDescent_nndescent_set, doc=r""" Faiss results are 64-bit""")
+    own_fields = property(_swigfaiss_avx2.IndexNNDescent_own_fields_get, _swigfaiss_avx2.IndexNNDescent_own_fields_set)
+    storage = property(_swigfaiss_avx2.IndexNNDescent_storage_get, _swigfaiss_avx2.IndexNNDescent_storage_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexNNDescent_swiginit(self, _swigfaiss_avx2.new_IndexNNDescent(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexNNDescent
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexNNDescent_add(self, n, x)
+
+    def train(self, n, x):
+        r""" Trains the storage if needed"""
+        return _swigfaiss_avx2.IndexNNDescent_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" entry point for search"""
+        return _swigfaiss_avx2.IndexNNDescent_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexNNDescent_reconstruct(self, key, recons)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexNNDescent_reset(self)
+
+# Register IndexNNDescent in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexNNDescent_swigregister(IndexNNDescent)
+class IndexNNDescentFlat(IndexNNDescent):
+    r"""
+    Flat index topped with with a NNDescent structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexNNDescentFlat_swiginit(self, _swigfaiss_avx2.new_IndexNNDescentFlat(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexNNDescentFlat
+
+# Register IndexNNDescentFlat in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexNNDescentFlat_swigregister(IndexNNDescentFlat)
+class IndexIVFFlat(IndexIVF):
+    r"""
+     Inverted file with stored vectors. Here the inverted file
+    pre-selects the vectors to be searched, but they are not otherwise
+    encoded, the code array just contains the raw float entries.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def add_core(self, n, x, xids, precomputed_idx, inverted_list_context=None):
+        return _swigfaiss_avx2.IndexIVFFlat_add_core(self, n, x, xids, precomputed_idx, inverted_list_context)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listnos=False):
+        return _swigfaiss_avx2.IndexIVFFlat_encode_vectors(self, n, x, list_nos, codes, include_listnos)
+
+    def get_InvertedListScanner(self, store_pairs, sel):
+        return _swigfaiss_avx2.IndexIVFFlat_get_InvertedListScanner(self, store_pairs, sel)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        return _swigfaiss_avx2.IndexIVFFlat_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexIVFFlat_sa_decode(self, n, bytes, x)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFFlat_swiginit(self, _swigfaiss_avx2.new_IndexIVFFlat(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFFlat
+
+# Register IndexIVFFlat in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFFlat_swigregister(IndexIVFFlat)
+class IndexIVFFlatDedup(IndexIVFFlat):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    instances = property(_swigfaiss_avx2.IndexIVFFlatDedup_instances_get, _swigfaiss_avx2.IndexIVFFlatDedup_instances_set, doc=r"""
+    Maps ids stored in the index to the ids of vectors that are
+    the same. When a vector is unique, it does not appear in the
+    instances map
+    """)
+
+    def train(self, n, x):
+        r""" also dedups the training set"""
+        return _swigfaiss_avx2.IndexIVFFlatDedup_train(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        r""" implemented for all IndexIVF* classes"""
+        return _swigfaiss_avx2.IndexIVFFlatDedup_add_with_ids(self, n, x, xids)
+
+    def search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params=None, stats=None):
+        return _swigfaiss_avx2.IndexIVFFlatDedup_search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params, stats)
+
+    def remove_ids(self, sel):
+        return _swigfaiss_avx2.IndexIVFFlatDedup_remove_ids(self, sel)
+
+    def range_search(self, n, x, radius, result, params=None):
+        r""" not implemented"""
+        return _swigfaiss_avx2.IndexIVFFlatDedup_range_search(self, n, x, radius, result, params)
+
+    def update_vectors(self, nv, idx, v):
+        r""" not implemented"""
+        return _swigfaiss_avx2.IndexIVFFlatDedup_update_vectors(self, nv, idx, v)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        r""" not implemented"""
+        return _swigfaiss_avx2.IndexIVFFlatDedup_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFFlatDedup_swiginit(self, _swigfaiss_avx2.new_IndexIVFFlatDedup(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFFlatDedup
+
+# Register IndexIVFFlatDedup in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFFlatDedup_swigregister(IndexIVFFlatDedup)
+
+def storage_distance_computer(storage):
+    return _swigfaiss_avx2.storage_distance_computer(storage)
+class NSG(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    ntotal = property(_swigfaiss_avx2.NSG_ntotal_get, _swigfaiss_avx2.NSG_ntotal_set, doc=r""" nb of nodes""")
+    R = property(_swigfaiss_avx2.NSG_R_get, _swigfaiss_avx2.NSG_R_set, doc=r""" nb of neighbors per node""")
+    L = property(_swigfaiss_avx2.NSG_L_get, _swigfaiss_avx2.NSG_L_set, doc=r""" length of the search path at construction time""")
+    C = property(_swigfaiss_avx2.NSG_C_get, _swigfaiss_avx2.NSG_C_set, doc=r""" candidate pool size at construction time""")
+    search_L = property(_swigfaiss_avx2.NSG_search_L_get, _swigfaiss_avx2.NSG_search_L_set, doc=r""" length of the search path""")
+    enterpoint = property(_swigfaiss_avx2.NSG_enterpoint_get, _swigfaiss_avx2.NSG_enterpoint_set, doc=r""" enterpoint""")
+    final_graph = property(_swigfaiss_avx2.NSG_final_graph_get, _swigfaiss_avx2.NSG_final_graph_set, doc=r""" NSG graph structure""")
+    is_built = property(_swigfaiss_avx2.NSG_is_built_get, _swigfaiss_avx2.NSG_is_built_set, doc=r""" NSG is built or not""")
+    rng = property(_swigfaiss_avx2.NSG_rng_get, _swigfaiss_avx2.NSG_rng_set, doc=r""" random generator""")
+
+    def __init__(self, R=32):
+        _swigfaiss_avx2.NSG_swiginit(self, _swigfaiss_avx2.new_NSG(R))
+
+    def build(self, storage, n, knn_graph, verbose):
+        return _swigfaiss_avx2.NSG_build(self, storage, n, knn_graph, verbose)
+
+    def reset(self):
+        return _swigfaiss_avx2.NSG_reset(self)
+
+    def search(self, dis, k, I, D, vt):
+        return _swigfaiss_avx2.NSG_search(self, dis, k, I, D, vt)
+
+    def init_graph(self, storage, knn_graph):
+        return _swigfaiss_avx2.NSG_init_graph(self, storage, knn_graph)
+
+    def add_reverse_links(self, q, locks, dis, graph):
+        return _swigfaiss_avx2.NSG_add_reverse_links(self, q, locks, dis, graph)
+
+    def sync_prune(self, q, pool, dis, vt, knn_graph, graph):
+        return _swigfaiss_avx2.NSG_sync_prune(self, q, pool, dis, vt, knn_graph, graph)
+
+    def link(self, storage, knn_graph, graph, verbose):
+        return _swigfaiss_avx2.NSG_link(self, storage, knn_graph, graph, verbose)
+
+    def tree_grow(self, storage, degrees):
+        return _swigfaiss_avx2.NSG_tree_grow(self, storage, degrees)
+
+    def dfs(self, vt, root, cnt):
+        return _swigfaiss_avx2.NSG_dfs(self, vt, root, cnt)
+
+    def attach_unlinked(self, storage, vt, vt2, degrees):
+        return _swigfaiss_avx2.NSG_attach_unlinked(self, storage, vt, vt2, degrees)
+
+    def check_graph(self):
+        return _swigfaiss_avx2.NSG_check_graph(self)
+
+    def get_final_graph(self):
+        return _swigfaiss_avx2.NSG_get_final_graph(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_NSG
+
+# Register NSG in _swigfaiss_avx2:
+_swigfaiss_avx2.NSG_swigregister(NSG)
+class NSG_Graph_int(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    data = property(_swigfaiss_avx2.NSG_Graph_int_data_get, _swigfaiss_avx2.NSG_Graph_int_data_set, doc=r""" the flattened adjacency matrix, size N-by-K""")
+    K = property(_swigfaiss_avx2.NSG_Graph_int_K_get, _swigfaiss_avx2.NSG_Graph_int_K_set, doc=r""" nb of neighbors per node""")
+    N = property(_swigfaiss_avx2.NSG_Graph_int_N_get, _swigfaiss_avx2.NSG_Graph_int_N_set, doc=r""" total nb of nodes""")
+    own_fields = property(_swigfaiss_avx2.NSG_Graph_int_own_fields_get, _swigfaiss_avx2.NSG_Graph_int_own_fields_set, doc=r""" the underlying data owned by itself or not""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.NSG_Graph_int_swiginit(self, _swigfaiss_avx2.new_NSG_Graph_int(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_NSG_Graph_int
+
+    def at(self, *args):
+        return _swigfaiss_avx2.NSG_Graph_int_at(self, *args)
+
+# Register NSG_Graph_int in _swigfaiss_avx2:
+_swigfaiss_avx2.NSG_Graph_int_swigregister(NSG_Graph_int)
+class IndexNSG(Index):
+    r"""
+     The NSG index is a normal random-access index with a NSG
+    link structure built on top
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nsg = property(_swigfaiss_avx2.IndexNSG_nsg_get, _swigfaiss_avx2.IndexNSG_nsg_set, doc=r""" the link strcuture""")
+    own_fields = property(_swigfaiss_avx2.IndexNSG_own_fields_get, _swigfaiss_avx2.IndexNSG_own_fields_set, doc=r""" the sequential storage""")
+    storage = property(_swigfaiss_avx2.IndexNSG_storage_get, _swigfaiss_avx2.IndexNSG_storage_set)
+    is_built = property(_swigfaiss_avx2.IndexNSG_is_built_get, _swigfaiss_avx2.IndexNSG_is_built_set, doc=r""" the index is built or not""")
+    GK = property(_swigfaiss_avx2.IndexNSG_GK_get, _swigfaiss_avx2.IndexNSG_GK_set, doc=r""" K of KNN graph for building""")
+    build_type = property(_swigfaiss_avx2.IndexNSG_build_type_get, _swigfaiss_avx2.IndexNSG_build_type_set, doc=r"""
+    indicate how to build a knn graph
+    - 0: build NSG with brute force search
+    - 1: build NSG with NNDescent
+    """)
+    nndescent_S = property(_swigfaiss_avx2.IndexNSG_nndescent_S_get, _swigfaiss_avx2.IndexNSG_nndescent_S_set, doc=r""" parameters for nndescent""")
+    nndescent_R = property(_swigfaiss_avx2.IndexNSG_nndescent_R_get, _swigfaiss_avx2.IndexNSG_nndescent_R_set)
+    nndescent_L = property(_swigfaiss_avx2.IndexNSG_nndescent_L_get, _swigfaiss_avx2.IndexNSG_nndescent_L_set)
+    nndescent_iter = property(_swigfaiss_avx2.IndexNSG_nndescent_iter_get, _swigfaiss_avx2.IndexNSG_nndescent_iter_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexNSG_swiginit(self, _swigfaiss_avx2.new_IndexNSG(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexNSG
+
+    def build(self, n, x, knn_graph, GK):
+        return _swigfaiss_avx2.IndexNSG_build(self, n, x, knn_graph, GK)
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexNSG_add(self, n, x)
+
+    def train(self, n, x):
+        r""" Trains the storage if needed"""
+        return _swigfaiss_avx2.IndexNSG_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" entry point for search"""
+        return _swigfaiss_avx2.IndexNSG_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexNSG_reconstruct(self, key, recons)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexNSG_reset(self)
+
+    def check_knn_graph(self, knn_graph, n, K):
+        return _swigfaiss_avx2.IndexNSG_check_knn_graph(self, knn_graph, n, K)
+
+# Register IndexNSG in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexNSG_swigregister(IndexNSG)
+class IndexNSGFlat(IndexNSG):
+    r"""
+    Flat index topped with with a NSG structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexNSGFlat_swiginit(self, _swigfaiss_avx2.new_IndexNSGFlat(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexNSGFlat
+
+# Register IndexNSGFlat in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexNSGFlat_swigregister(IndexNSGFlat)
+class IndexNSGPQ(IndexNSG):
+    r"""
+    PQ index topped with with a NSG structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexNSGPQ_swiginit(self, _swigfaiss_avx2.new_IndexNSGPQ(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexNSGPQ_train(self, n, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexNSGPQ
+
+# Register IndexNSGPQ in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexNSGPQ_swigregister(IndexNSGPQ)
+class IndexNSGSQ(IndexNSG):
+    r"""
+    SQ index topped with with a NSG structure to access elements
+    more efficiently.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexNSGSQ_swiginit(self, _swigfaiss_avx2.new_IndexNSGSQ(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexNSGSQ
+
+# Register IndexNSGSQ in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexNSGSQ_swigregister(IndexNSGSQ)
+class ZnSphereSearch(object):
+    r"""
+     returns the nearest vertex in the sphere to a query. Returns only
+    the coordinates, not an id.
+
+    Algorithm: all points are derived from a one atom vector up to a
+    permutation and sign changes. The search function finds the most
+    appropriate atom and transformation.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    dimS = property(_swigfaiss_avx2.ZnSphereSearch_dimS_get, _swigfaiss_avx2.ZnSphereSearch_dimS_set)
+    r2 = property(_swigfaiss_avx2.ZnSphereSearch_r2_get, _swigfaiss_avx2.ZnSphereSearch_r2_set)
+    natom = property(_swigfaiss_avx2.ZnSphereSearch_natom_get, _swigfaiss_avx2.ZnSphereSearch_natom_set)
+    voc = property(_swigfaiss_avx2.ZnSphereSearch_voc_get, _swigfaiss_avx2.ZnSphereSearch_voc_set, doc=r""" size dim * ntatom""")
+
+    def __init__(self, dim, r2):
+        _swigfaiss_avx2.ZnSphereSearch_swiginit(self, _swigfaiss_avx2.new_ZnSphereSearch(dim, r2))
+
+    def search(self, *args):
+        r"""
+        *Overload 1:*
+        find nearest centroid. x does not need to be normalized
+
+        |
+
+        *Overload 2:*
+        full call. Requires externally-allocated temp space
+
+        |
+
+        *Overload 3:*
+        full call. Requires externally-allocated temp space
+        """
+        return _swigfaiss_avx2.ZnSphereSearch_search(self, *args)
+
+    def search_multi(self, n, x, c_out, dp_out):
+        return _swigfaiss_avx2.ZnSphereSearch_search_multi(self, n, x, c_out, dp_out)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ZnSphereSearch
+
+# Register ZnSphereSearch in _swigfaiss_avx2:
+_swigfaiss_avx2.ZnSphereSearch_swigregister(ZnSphereSearch)
+class EnumeratedVectors(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    nv = property(_swigfaiss_avx2.EnumeratedVectors_nv_get, _swigfaiss_avx2.EnumeratedVectors_nv_set, doc=r""" size of the collection""")
+    dim = property(_swigfaiss_avx2.EnumeratedVectors_dim_get, _swigfaiss_avx2.EnumeratedVectors_dim_set)
+
+    def encode(self, x):
+        r""" encode a vector from a collection"""
+        return _swigfaiss_avx2.EnumeratedVectors_encode(self, x)
+
+    def decode(self, code, c):
+        r""" decode it"""
+        return _swigfaiss_avx2.EnumeratedVectors_decode(self, code, c)
+
+    def encode_multi(self, nc, c, codes):
+        return _swigfaiss_avx2.EnumeratedVectors_encode_multi(self, nc, c, codes)
+
+    def decode_multi(self, nc, codes, c):
+        return _swigfaiss_avx2.EnumeratedVectors_decode_multi(self, nc, codes, c)
+
+    def find_nn(self, n, codes, nq, xq, idx, dis):
+        return _swigfaiss_avx2.EnumeratedVectors_find_nn(self, n, codes, nq, xq, idx, dis)
+    __swig_destroy__ = _swigfaiss_avx2.delete_EnumeratedVectors
+
+# Register EnumeratedVectors in _swigfaiss_avx2:
+_swigfaiss_avx2.EnumeratedVectors_swigregister(EnumeratedVectors)
+class Repeat(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    val = property(_swigfaiss_avx2.Repeat_val_get, _swigfaiss_avx2.Repeat_val_set)
+    n = property(_swigfaiss_avx2.Repeat_n_get, _swigfaiss_avx2.Repeat_n_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.Repeat_swiginit(self, _swigfaiss_avx2.new_Repeat())
+    __swig_destroy__ = _swigfaiss_avx2.delete_Repeat
+
+# Register Repeat in _swigfaiss_avx2:
+_swigfaiss_avx2.Repeat_swigregister(Repeat)
+class Repeats(object):
+    r"""
+    Repeats: used to encode a vector that has n occurrences of
+    val. Encodes the signs and permutation of the vector. Useful for
+    atoms.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    dim = property(_swigfaiss_avx2.Repeats_dim_get, _swigfaiss_avx2.Repeats_dim_set)
+    repeats = property(_swigfaiss_avx2.Repeats_repeats_get, _swigfaiss_avx2.Repeats_repeats_set)
+
+    def __init__(self, dim=0, c=None):
+        _swigfaiss_avx2.Repeats_swiginit(self, _swigfaiss_avx2.new_Repeats(dim, c))
+
+    def count(self):
+        return _swigfaiss_avx2.Repeats_count(self)
+
+    def encode(self, c):
+        return _swigfaiss_avx2.Repeats_encode(self, c)
+
+    def decode(self, code, c):
+        return _swigfaiss_avx2.Repeats_decode(self, code, c)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Repeats
+
+# Register Repeats in _swigfaiss_avx2:
+_swigfaiss_avx2.Repeats_swigregister(Repeats)
+class ZnSphereCodec(ZnSphereSearch, EnumeratedVectors):
+    r"""
+     codec that can return ids for the encoded vectors
+
+    uses the ZnSphereSearch to encode the vector by encoding the
+    permutation and signs. Depends on ZnSphereSearch because it uses
+    the atom numbers
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    code_segments = property(_swigfaiss_avx2.ZnSphereCodec_code_segments_get, _swigfaiss_avx2.ZnSphereCodec_code_segments_set)
+    nv = property(_swigfaiss_avx2.ZnSphereCodec_nv_get, _swigfaiss_avx2.ZnSphereCodec_nv_set)
+    code_size = property(_swigfaiss_avx2.ZnSphereCodec_code_size_get, _swigfaiss_avx2.ZnSphereCodec_code_size_set)
+
+    def __init__(self, dim, r2):
+        _swigfaiss_avx2.ZnSphereCodec_swiginit(self, _swigfaiss_avx2.new_ZnSphereCodec(dim, r2))
+
+    def search_and_encode(self, x):
+        return _swigfaiss_avx2.ZnSphereCodec_search_and_encode(self, x)
+
+    def decode(self, code, c):
+        return _swigfaiss_avx2.ZnSphereCodec_decode(self, code, c)
+
+    def encode(self, x):
+        r""" takes vectors that do not need to be centroids"""
+        return _swigfaiss_avx2.ZnSphereCodec_encode(self, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ZnSphereCodec
+
+# Register ZnSphereCodec in _swigfaiss_avx2:
+_swigfaiss_avx2.ZnSphereCodec_swigregister(ZnSphereCodec)
+class ZnSphereCodecRec(EnumeratedVectors):
+    r"""
+     recursive sphere codec
+
+    Uses a recursive decomposition on the dimensions to encode
+    centroids found by the ZnSphereSearch. The codes are *not*
+    compatible with the ones of ZnSpehreCodec
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    r2 = property(_swigfaiss_avx2.ZnSphereCodecRec_r2_get, _swigfaiss_avx2.ZnSphereCodecRec_r2_set)
+    log2_dim = property(_swigfaiss_avx2.ZnSphereCodecRec_log2_dim_get, _swigfaiss_avx2.ZnSphereCodecRec_log2_dim_set)
+    code_size = property(_swigfaiss_avx2.ZnSphereCodecRec_code_size_get, _swigfaiss_avx2.ZnSphereCodecRec_code_size_set)
+
+    def __init__(self, dim, r2):
+        _swigfaiss_avx2.ZnSphereCodecRec_swiginit(self, _swigfaiss_avx2.new_ZnSphereCodecRec(dim, r2))
+
+    def encode_centroid(self, c):
+        return _swigfaiss_avx2.ZnSphereCodecRec_encode_centroid(self, c)
+
+    def decode(self, code, c):
+        return _swigfaiss_avx2.ZnSphereCodecRec_decode(self, code, c)
+
+    def encode(self, x):
+        r"""
+        vectors need to be centroids (does not work on arbitrary
+        vectors)
+        """
+        return _swigfaiss_avx2.ZnSphereCodecRec_encode(self, x)
+    all_nv = property(_swigfaiss_avx2.ZnSphereCodecRec_all_nv_get, _swigfaiss_avx2.ZnSphereCodecRec_all_nv_set)
+    all_nv_cum = property(_swigfaiss_avx2.ZnSphereCodecRec_all_nv_cum_get, _swigfaiss_avx2.ZnSphereCodecRec_all_nv_cum_set)
+    decode_cache_ld = property(_swigfaiss_avx2.ZnSphereCodecRec_decode_cache_ld_get, _swigfaiss_avx2.ZnSphereCodecRec_decode_cache_ld_set)
+    decode_cache = property(_swigfaiss_avx2.ZnSphereCodecRec_decode_cache_get, _swigfaiss_avx2.ZnSphereCodecRec_decode_cache_set)
+
+    def get_nv(self, ld, r2a):
+        return _swigfaiss_avx2.ZnSphereCodecRec_get_nv(self, ld, r2a)
+
+    def get_nv_cum(self, ld, r2t, r2a):
+        return _swigfaiss_avx2.ZnSphereCodecRec_get_nv_cum(self, ld, r2t, r2a)
+
+    def set_nv_cum(self, ld, r2t, r2a, v):
+        return _swigfaiss_avx2.ZnSphereCodecRec_set_nv_cum(self, ld, r2t, r2a, v)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ZnSphereCodecRec
+
+# Register ZnSphereCodecRec in _swigfaiss_avx2:
+_swigfaiss_avx2.ZnSphereCodecRec_swigregister(ZnSphereCodecRec)
+class ZnSphereCodecAlt(ZnSphereCodec):
+    r"""
+     Codec that uses the recursive codec if dim is a power of 2 and
+    the regular one otherwise
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    use_rec = property(_swigfaiss_avx2.ZnSphereCodecAlt_use_rec_get, _swigfaiss_avx2.ZnSphereCodecAlt_use_rec_set)
+    znc_rec = property(_swigfaiss_avx2.ZnSphereCodecAlt_znc_rec_get, _swigfaiss_avx2.ZnSphereCodecAlt_znc_rec_set)
+
+    def __init__(self, dim, r2):
+        _swigfaiss_avx2.ZnSphereCodecAlt_swiginit(self, _swigfaiss_avx2.new_ZnSphereCodecAlt(dim, r2))
+
+    def encode(self, x):
+        return _swigfaiss_avx2.ZnSphereCodecAlt_encode(self, x)
+
+    def decode(self, code, c):
+        return _swigfaiss_avx2.ZnSphereCodecAlt_decode(self, code, c)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ZnSphereCodecAlt
+
+# Register ZnSphereCodecAlt in _swigfaiss_avx2:
+_swigfaiss_avx2.ZnSphereCodecAlt_swigregister(ZnSphereCodecAlt)
+class IndexLattice(Index):
+    r""" Index that encodes a vector with a series of Zn lattice quantizers"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nsq = property(_swigfaiss_avx2.IndexLattice_nsq_get, _swigfaiss_avx2.IndexLattice_nsq_set, doc=r""" number of sub-vectors""")
+    dsq = property(_swigfaiss_avx2.IndexLattice_dsq_get, _swigfaiss_avx2.IndexLattice_dsq_set, doc=r""" dimension of sub-vectors""")
+    zn_sphere_codec = property(_swigfaiss_avx2.IndexLattice_zn_sphere_codec_get, _swigfaiss_avx2.IndexLattice_zn_sphere_codec_set, doc=r""" the lattice quantizer""")
+    scale_nbit = property(_swigfaiss_avx2.IndexLattice_scale_nbit_get, _swigfaiss_avx2.IndexLattice_scale_nbit_set, doc=r""" nb bits used to encode the scale, per subvector""")
+    lattice_nbit = property(_swigfaiss_avx2.IndexLattice_lattice_nbit_get, _swigfaiss_avx2.IndexLattice_lattice_nbit_set)
+    code_size = property(_swigfaiss_avx2.IndexLattice_code_size_get, _swigfaiss_avx2.IndexLattice_code_size_set, doc=r""" total, in bytes""")
+    trained = property(_swigfaiss_avx2.IndexLattice_trained_get, _swigfaiss_avx2.IndexLattice_trained_set, doc=r""" mins and maxes of the vector norms, per subquantizer""")
+
+    def __init__(self, d, nsq, scale_nbit, r2):
+        _swigfaiss_avx2.IndexLattice_swiginit(self, _swigfaiss_avx2.new_IndexLattice(d, nsq, scale_nbit, r2))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexLattice_train(self, n, x)
+
+    def sa_code_size(self):
+        return _swigfaiss_avx2.IndexLattice_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss_avx2.IndexLattice_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexLattice_sa_decode(self, n, bytes, x)
+
+    def add(self, n, x):
+        r""" not implemented"""
+        return _swigfaiss_avx2.IndexLattice_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexLattice_search(self, n, x, k, distances, labels, params)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexLattice_reset(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexLattice
+
+# Register IndexLattice in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexLattice_swigregister(IndexLattice)
+class IVFPQSearchParameters(SearchParametersIVF):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    scan_table_threshold = property(_swigfaiss_avx2.IVFPQSearchParameters_scan_table_threshold_get, _swigfaiss_avx2.IVFPQSearchParameters_scan_table_threshold_set, doc=r""" use table computation or on-the-fly?""")
+    polysemous_ht = property(_swigfaiss_avx2.IVFPQSearchParameters_polysemous_ht_get, _swigfaiss_avx2.IVFPQSearchParameters_polysemous_ht_set, doc=r""" Hamming thresh for polysemous filtering""")
+
+    def __init__(self):
+        _swigfaiss_avx2.IVFPQSearchParameters_swiginit(self, _swigfaiss_avx2.new_IVFPQSearchParameters())
+    __swig_destroy__ = _swigfaiss_avx2.delete_IVFPQSearchParameters
+
+# Register IVFPQSearchParameters in _swigfaiss_avx2:
+_swigfaiss_avx2.IVFPQSearchParameters_swigregister(IVFPQSearchParameters)
+class IndexIVFPQ(IndexIVF):
+    r"""
+     Inverted file with Product Quantizer encoding. Each residual
+    vector is encoded as a product quantizer code.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    pq = property(_swigfaiss_avx2.IndexIVFPQ_pq_get, _swigfaiss_avx2.IndexIVFPQ_pq_set, doc=r""" produces the codes""")
+    do_polysemous_training = property(_swigfaiss_avx2.IndexIVFPQ_do_polysemous_training_get, _swigfaiss_avx2.IndexIVFPQ_do_polysemous_training_set, doc=r""" reorder PQ centroids after training?""")
+    polysemous_training = property(_swigfaiss_avx2.IndexIVFPQ_polysemous_training_get, _swigfaiss_avx2.IndexIVFPQ_polysemous_training_set, doc=r""" if NULL, use default""")
+    scan_table_threshold = property(_swigfaiss_avx2.IndexIVFPQ_scan_table_threshold_get, _swigfaiss_avx2.IndexIVFPQ_scan_table_threshold_set, doc=r""" use table computation or on-the-fly?""")
+    polysemous_ht = property(_swigfaiss_avx2.IndexIVFPQ_polysemous_ht_get, _swigfaiss_avx2.IndexIVFPQ_polysemous_ht_set, doc=r""" Hamming thresh for polysemous filtering""")
+    use_precomputed_table = property(_swigfaiss_avx2.IndexIVFPQ_use_precomputed_table_get, _swigfaiss_avx2.IndexIVFPQ_use_precomputed_table_set, doc=r"""
+     Precompute table that speed up query preprocessing at some
+    memory cost (used only for by_residual with L2 metric)
+    """)
+    precomputed_table = property(_swigfaiss_avx2.IndexIVFPQ_precomputed_table_get, _swigfaiss_avx2.IndexIVFPQ_precomputed_table_set, doc=r"""
+    if use_precompute_table
+    size nlist * pq.M * pq.ksub
+    """)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listnos=False):
+        return _swigfaiss_avx2.IndexIVFPQ_encode_vectors(self, n, x, list_nos, codes, include_listnos)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexIVFPQ_sa_decode(self, n, bytes, x)
+
+    def add_core(self, n, x, xids, precomputed_idx, inverted_list_context=None):
+        return _swigfaiss_avx2.IndexIVFPQ_add_core(self, n, x, xids, precomputed_idx, inverted_list_context)
+
+    def add_core_o(self, n, x, xids, residuals_2, precomputed_idx=None, inverted_list_context=None):
+        r"""
+        same as add_core, also:
+        - output 2nd level residuals if residuals_2 != NULL
+        - accepts precomputed_idx = nullptr
+        """
+        return _swigfaiss_avx2.IndexIVFPQ_add_core_o(self, n, x, xids, residuals_2, precomputed_idx, inverted_list_context)
+
+    def train_encoder(self, n, x, assign):
+        r""" trains the product quantizer"""
+        return _swigfaiss_avx2.IndexIVFPQ_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        return _swigfaiss_avx2.IndexIVFPQ_train_encoder_num_vectors(self)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        return _swigfaiss_avx2.IndexIVFPQ_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def find_duplicates(self, ids, lims):
+        r"""
+         Find exact duplicates in the dataset.
+
+        the duplicates are returned in pre-allocated arrays (see the
+        max sizes).
+
+        :type lims: int
+        :param lims:   limits between groups of duplicates
+                           (max size ntotal / 2 + 1)
+        :type ids: int
+        :param ids:    ids[lims[i]] : ids[lims[i+1]-1] is a group of
+                           duplicates (max size ntotal)
+        :rtype: int
+        :return: n      number of groups found
+        """
+        return _swigfaiss_avx2.IndexIVFPQ_find_duplicates(self, ids, lims)
+
+    def encode(self, key, x, code):
+        return _swigfaiss_avx2.IndexIVFPQ_encode(self, key, x, code)
+
+    def encode_multiple(self, n, keys, x, codes, compute_keys=False):
+        r"""
+         Encode multiple vectors
+
+        :type n: int
+        :param n:       nb vectors to encode
+        :type keys: int
+        :param keys:    posting list ids for those vectors (size n)
+        :type x: float
+        :param x:       vectors (size n * d)
+        :type codes: uint8_t
+        :param codes:   output codes (size n * code_size)
+        :type compute_keys: boolean, optional
+        :param compute_keys:  if false, assume keys are precomputed,
+                                 otherwise compute them
+        """
+        return _swigfaiss_avx2.IndexIVFPQ_encode_multiple(self, n, keys, x, codes, compute_keys)
+
+    def decode_multiple(self, n, keys, xcodes, x):
+        r""" inverse of encode_multiple"""
+        return _swigfaiss_avx2.IndexIVFPQ_decode_multiple(self, n, keys, xcodes, x)
+
+    def get_InvertedListScanner(self, store_pairs, sel):
+        return _swigfaiss_avx2.IndexIVFPQ_get_InvertedListScanner(self, store_pairs, sel)
+
+    def precompute_table(self):
+        r""" build precomputed table"""
+        return _swigfaiss_avx2.IndexIVFPQ_precompute_table(self)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFPQ_swiginit(self, _swigfaiss_avx2.new_IndexIVFPQ(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFPQ
+
+# Register IndexIVFPQ in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFPQ_swigregister(IndexIVFPQ)
+
+def initialize_IVFPQ_precomputed_table(use_precomputed_table, quantizer, pq, precomputed_table, by_residual, verbose):
+    r"""
+     Pre-compute distance tables for IVFPQ with by-residual and METRIC_L2
+
+    :type use_precomputed_table: int
+    :param use_precomputed_table: (I/O)
+               =-1: force disable
+               =0: decide heuristically (default: use tables only if they are
+                   < precomputed_tables_max_bytes), set use_precomputed_table on
+        output =1: tables that work for all quantizers (size 256 * nlist * M) =2:
+        specific version for MultiIndexQuantizer (much more compact)
+    :type precomputed_table: faiss::AlignedTable< float,32 >
+    :param precomputed_table: precomputed table to initialize
+    """
+    return _swigfaiss_avx2.initialize_IVFPQ_precomputed_table(use_precomputed_table, quantizer, pq, precomputed_table, by_residual, verbose)
+class IndexIVFPQStats(object):
+    r"""
+    statistics are robust to internal threading, but not if
+    IndexIVFPQ::search_preassigned is called by multiple threads
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nrefine = property(_swigfaiss_avx2.IndexIVFPQStats_nrefine_get, _swigfaiss_avx2.IndexIVFPQStats_nrefine_set, doc=r""" nb of refines (IVFPQR)""")
+    n_hamming_pass = property(_swigfaiss_avx2.IndexIVFPQStats_n_hamming_pass_get, _swigfaiss_avx2.IndexIVFPQStats_n_hamming_pass_set, doc=r""" nb of passed Hamming distance tests (for polysemous)""")
+    search_cycles = property(_swigfaiss_avx2.IndexIVFPQStats_search_cycles_get, _swigfaiss_avx2.IndexIVFPQStats_search_cycles_set)
+    refine_cycles = property(_swigfaiss_avx2.IndexIVFPQStats_refine_cycles_get, _swigfaiss_avx2.IndexIVFPQStats_refine_cycles_set, doc=r""" only for IVFPQR""")
+
+    def __init__(self):
+        _swigfaiss_avx2.IndexIVFPQStats_swiginit(self, _swigfaiss_avx2.new_IndexIVFPQStats())
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexIVFPQStats_reset(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFPQStats
+
+# Register IndexIVFPQStats in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFPQStats_swigregister(IndexIVFPQStats)
+class IndexIVFPQR(IndexIVFPQ):
+    r""" Index with an additional level of PQ refinement"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    refine_pq = property(_swigfaiss_avx2.IndexIVFPQR_refine_pq_get, _swigfaiss_avx2.IndexIVFPQR_refine_pq_set, doc=r""" 3rd level quantizer""")
+    refine_codes = property(_swigfaiss_avx2.IndexIVFPQR_refine_codes_get, _swigfaiss_avx2.IndexIVFPQR_refine_codes_set, doc=r""" corresponding codes""")
+    k_factor = property(_swigfaiss_avx2.IndexIVFPQR_k_factor_get, _swigfaiss_avx2.IndexIVFPQR_k_factor_set, doc=r""" factor between k requested in search and the k requested from the IVFPQ""")
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexIVFPQR_reset(self)
+
+    def remove_ids(self, sel):
+        return _swigfaiss_avx2.IndexIVFPQR_remove_ids(self, sel)
+
+    def train_encoder(self, n, x, assign):
+        r""" trains the two product quantizers"""
+        return _swigfaiss_avx2.IndexIVFPQR_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        return _swigfaiss_avx2.IndexIVFPQR_train_encoder_num_vectors(self)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss_avx2.IndexIVFPQR_add_with_ids(self, n, x, xids)
+
+    def add_core(self, n, x, xids, precomputed_idx, inverted_list_context=None):
+        r""" same as add_with_ids, but optionally use the precomputed list ids"""
+        return _swigfaiss_avx2.IndexIVFPQR_add_core(self, n, x, xids, precomputed_idx, inverted_list_context)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        return _swigfaiss_avx2.IndexIVFPQR_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def merge_from(self, otherIndex, add_id):
+        return _swigfaiss_avx2.IndexIVFPQR_merge_from(self, otherIndex, add_id)
+
+    def search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params=None, stats=None):
+        return _swigfaiss_avx2.IndexIVFPQR_search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params, stats)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFPQR_swiginit(self, _swigfaiss_avx2.new_IndexIVFPQR(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFPQR
+
+# Register IndexIVFPQR in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFPQR_swigregister(IndexIVFPQR)
+class Index2Layer(IndexFlatCodes):
+    r"""
+     Same as an IndexIVFPQ without the inverted lists: codes are stored
+    sequentially
+
+    The class is mainly inteded to store encoded vectors that can be
+    accessed randomly, the search function is not implemented.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    q1 = property(_swigfaiss_avx2.Index2Layer_q1_get, _swigfaiss_avx2.Index2Layer_q1_set, doc=r""" first level quantizer""")
+    pq = property(_swigfaiss_avx2.Index2Layer_pq_get, _swigfaiss_avx2.Index2Layer_pq_set, doc=r""" second level quantizer is always a PQ""")
+    code_size_1 = property(_swigfaiss_avx2.Index2Layer_code_size_1_get, _swigfaiss_avx2.Index2Layer_code_size_1_set, doc=r""" size of the code for the first level (ceil(log8(q1.nlist)))""")
+    code_size_2 = property(_swigfaiss_avx2.Index2Layer_code_size_2_get, _swigfaiss_avx2.Index2Layer_code_size_2_set, doc=r""" size of the code for the second level""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.Index2Layer_swiginit(self, _swigfaiss_avx2.new_Index2Layer(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_Index2Layer
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.Index2Layer_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" not implemented"""
+        return _swigfaiss_avx2.Index2Layer_search(self, n, x, k, distances, labels, params)
+
+    def get_distance_computer(self):
+        return _swigfaiss_avx2.Index2Layer_get_distance_computer(self)
+
+    def transfer_to_IVFPQ(self, other):
+        r""" transfer the flat codes to an IVFPQ index"""
+        return _swigfaiss_avx2.Index2Layer_transfer_to_IVFPQ(self, other)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss_avx2.Index2Layer_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.Index2Layer_sa_decode(self, n, bytes, x)
+
+# Register Index2Layer in _swigfaiss_avx2:
+_swigfaiss_avx2.Index2Layer_swigregister(Index2Layer)
+class IndexFastScan(Index):
+    r"""
+     Fast scan version of IndexPQ and IndexAQ. Works for 4-bit PQ and AQ for now.
+
+    The codes are not stored sequentially but grouped in blocks of size bbs.
+    This makes it possible to compute distances quickly with SIMD instructions.
+    The trailing codes (padding codes that are added to complete the last code)
+    are garbage.
+
+    Implementations:
+    12: blocked loop with internal loop on Q with qbs
+    13: same with reservoir accumulator to store results
+    14: no qbs with heap accumulator
+    15: no qbs with reservoir accumulator
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    implem = property(_swigfaiss_avx2.IndexFastScan_implem_get, _swigfaiss_avx2.IndexFastScan_implem_set)
+    skip = property(_swigfaiss_avx2.IndexFastScan_skip_get, _swigfaiss_avx2.IndexFastScan_skip_set)
+    bbs = property(_swigfaiss_avx2.IndexFastScan_bbs_get, _swigfaiss_avx2.IndexFastScan_bbs_set)
+    qbs = property(_swigfaiss_avx2.IndexFastScan_qbs_get, _swigfaiss_avx2.IndexFastScan_qbs_set)
+    M = property(_swigfaiss_avx2.IndexFastScan_M_get, _swigfaiss_avx2.IndexFastScan_M_set)
+    nbits = property(_swigfaiss_avx2.IndexFastScan_nbits_get, _swigfaiss_avx2.IndexFastScan_nbits_set)
+    ksub = property(_swigfaiss_avx2.IndexFastScan_ksub_get, _swigfaiss_avx2.IndexFastScan_ksub_set)
+    code_size = property(_swigfaiss_avx2.IndexFastScan_code_size_get, _swigfaiss_avx2.IndexFastScan_code_size_set)
+    ntotal2 = property(_swigfaiss_avx2.IndexFastScan_ntotal2_get, _swigfaiss_avx2.IndexFastScan_ntotal2_set)
+    M2 = property(_swigfaiss_avx2.IndexFastScan_M2_get, _swigfaiss_avx2.IndexFastScan_M2_set)
+    codes = property(_swigfaiss_avx2.IndexFastScan_codes_get, _swigfaiss_avx2.IndexFastScan_codes_set)
+    orig_codes = property(_swigfaiss_avx2.IndexFastScan_orig_codes_get, _swigfaiss_avx2.IndexFastScan_orig_codes_set)
+
+    def init_fastscan(self, d, M, nbits, metric, bbs):
+        return _swigfaiss_avx2.IndexFastScan_init_fastscan(self, d, M, nbits, metric, bbs)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexFastScan_reset(self)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexFastScan_search(self, n, x, k, distances, labels, params)
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexFastScan_add(self, n, x)
+
+    def compute_codes(self, codes, n, x):
+        return _swigfaiss_avx2.IndexFastScan_compute_codes(self, codes, n, x)
+
+    def compute_float_LUT(self, lut, n, x):
+        return _swigfaiss_avx2.IndexFastScan_compute_float_LUT(self, lut, n, x)
+
+    def compute_quantized_LUT(self, n, x, lut, normalizers):
+        return _swigfaiss_avx2.IndexFastScan_compute_quantized_LUT(self, n, x, lut, normalizers)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexFastScan_reconstruct(self, key, recons)
+
+    def remove_ids(self, sel):
+        return _swigfaiss_avx2.IndexFastScan_remove_ids(self, sel)
+
+    def get_CodePacker(self):
+        return _swigfaiss_avx2.IndexFastScan_get_CodePacker(self)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss_avx2.IndexFastScan_merge_from(self, otherIndex, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss_avx2.IndexFastScan_check_compatible_for_merge(self, otherIndex)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexFastScan
+
+# Register IndexFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexFastScan_swigregister(IndexFastScan)
+class FastScanStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    t0 = property(_swigfaiss_avx2.FastScanStats_t0_get, _swigfaiss_avx2.FastScanStats_t0_set)
+    t1 = property(_swigfaiss_avx2.FastScanStats_t1_get, _swigfaiss_avx2.FastScanStats_t1_set)
+    t2 = property(_swigfaiss_avx2.FastScanStats_t2_get, _swigfaiss_avx2.FastScanStats_t2_set)
+    t3 = property(_swigfaiss_avx2.FastScanStats_t3_get, _swigfaiss_avx2.FastScanStats_t3_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.FastScanStats_swiginit(self, _swigfaiss_avx2.new_FastScanStats())
+
+    def reset(self):
+        return _swigfaiss_avx2.FastScanStats_reset(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_FastScanStats
+
+# Register FastScanStats in _swigfaiss_avx2:
+_swigfaiss_avx2.FastScanStats_swigregister(FastScanStats)
+class IndexAdditiveQuantizerFastScan(IndexFastScan):
+    r"""
+     Fast scan version of IndexAQ. Works for 4-bit AQ for now.
+
+    The codes are not stored sequentially but grouped in blocks of size bbs.
+    This makes it possible to compute distances quickly with SIMD instructions.
+
+    Implementations:
+    12: blocked loop with internal loop on Q with qbs
+    13: same with reservoir accumulator to store results
+    14: no qbs with heap accumulator
+    15: no qbs with reservoir accumulator
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    aq = property(_swigfaiss_avx2.IndexAdditiveQuantizerFastScan_aq_get, _swigfaiss_avx2.IndexAdditiveQuantizerFastScan_aq_set)
+    rescale_norm = property(_swigfaiss_avx2.IndexAdditiveQuantizerFastScan_rescale_norm_get, _swigfaiss_avx2.IndexAdditiveQuantizerFastScan_rescale_norm_set)
+    norm_scale = property(_swigfaiss_avx2.IndexAdditiveQuantizerFastScan_norm_scale_get, _swigfaiss_avx2.IndexAdditiveQuantizerFastScan_norm_scale_set)
+    max_train_points = property(_swigfaiss_avx2.IndexAdditiveQuantizerFastScan_max_train_points_get, _swigfaiss_avx2.IndexAdditiveQuantizerFastScan_max_train_points_set)
+
+    def init(self, *args):
+        return _swigfaiss_avx2.IndexAdditiveQuantizerFastScan_init(self, *args)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexAdditiveQuantizerFastScan
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+        build from an existing IndexAQ
+
+        |
+
+        *Overload 2:*
+        build from an existing IndexAQ
+        """
+        _swigfaiss_avx2.IndexAdditiveQuantizerFastScan_swiginit(self, _swigfaiss_avx2.new_IndexAdditiveQuantizerFastScan(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexAdditiveQuantizerFastScan_train(self, n, x)
+
+    def estimate_norm_scale(self, n, x):
+        return _swigfaiss_avx2.IndexAdditiveQuantizerFastScan_estimate_norm_scale(self, n, x)
+
+    def compute_codes(self, codes, n, x):
+        return _swigfaiss_avx2.IndexAdditiveQuantizerFastScan_compute_codes(self, codes, n, x)
+
+    def compute_float_LUT(self, lut, n, x):
+        return _swigfaiss_avx2.IndexAdditiveQuantizerFastScan_compute_float_LUT(self, lut, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexAdditiveQuantizerFastScan_search(self, n, x, k, distances, labels, params)
+
+    def sa_decode(self, n, bytes, x):
+        r"""
+         Decode a set of vectors.
+
+         NOTE: The codes in the IndexAdditiveQuantizerFastScan object are non-
+               contiguous. But this method requires a contiguous representation.
+
+        :type n: int
+        :param n:       number of vectors
+        :type bytes: uint8_t
+        :param bytes:   input encoded vectors, size n * code_size
+        :type x: float
+        :param x:       output vectors, size n * d
+        """
+        return _swigfaiss_avx2.IndexAdditiveQuantizerFastScan_sa_decode(self, n, bytes, x)
+
+# Register IndexAdditiveQuantizerFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexAdditiveQuantizerFastScan_swigregister(IndexAdditiveQuantizerFastScan)
+class IndexResidualQuantizerFastScan(IndexAdditiveQuantizerFastScan):
+    r"""
+     Index based on a residual quantizer. Stored vectors are
+    approximated by residual quantization codes.
+    Can also be used as a codec
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rq = property(_swigfaiss_avx2.IndexResidualQuantizerFastScan_rq_get, _swigfaiss_avx2.IndexResidualQuantizerFastScan_rq_set, doc=r""" The residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexResidualQuantizerFastScan_swiginit(self, _swigfaiss_avx2.new_IndexResidualQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexResidualQuantizerFastScan
+
+# Register IndexResidualQuantizerFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexResidualQuantizerFastScan_swigregister(IndexResidualQuantizerFastScan)
+class IndexLocalSearchQuantizerFastScan(IndexAdditiveQuantizerFastScan):
+    r"""
+     Index based on a local search quantizer. Stored vectors are
+    approximated by local search quantization codes.
+    Can also be used as a codec
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lsq = property(_swigfaiss_avx2.IndexLocalSearchQuantizerFastScan_lsq_get, _swigfaiss_avx2.IndexLocalSearchQuantizerFastScan_lsq_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexLocalSearchQuantizerFastScan_swiginit(self, _swigfaiss_avx2.new_IndexLocalSearchQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexLocalSearchQuantizerFastScan
+
+# Register IndexLocalSearchQuantizerFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexLocalSearchQuantizerFastScan_swigregister(IndexLocalSearchQuantizerFastScan)
+class IndexProductResidualQuantizerFastScan(IndexAdditiveQuantizerFastScan):
+    r"""
+     Index based on a product residual quantizer. Stored vectors are
+    approximated by product residual quantization codes.
+    Can also be used as a codec
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    prq = property(_swigfaiss_avx2.IndexProductResidualQuantizerFastScan_prq_get, _swigfaiss_avx2.IndexProductResidualQuantizerFastScan_prq_set, doc=r""" The product residual quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexProductResidualQuantizerFastScan_swiginit(self, _swigfaiss_avx2.new_IndexProductResidualQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexProductResidualQuantizerFastScan
+
+# Register IndexProductResidualQuantizerFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexProductResidualQuantizerFastScan_swigregister(IndexProductResidualQuantizerFastScan)
+class IndexProductLocalSearchQuantizerFastScan(IndexAdditiveQuantizerFastScan):
+    r"""
+     Index based on a product local search quantizer. Stored vectors are
+    approximated by product local search quantization codes.
+    Can also be used as a codec
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    plsq = property(_swigfaiss_avx2.IndexProductLocalSearchQuantizerFastScan_plsq_get, _swigfaiss_avx2.IndexProductLocalSearchQuantizerFastScan_plsq_set, doc=r""" The product local search quantizer used to encode the vectors""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexProductLocalSearchQuantizerFastScan_swiginit(self, _swigfaiss_avx2.new_IndexProductLocalSearchQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexProductLocalSearchQuantizerFastScan
+
+# Register IndexProductLocalSearchQuantizerFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexProductLocalSearchQuantizerFastScan_swigregister(IndexProductLocalSearchQuantizerFastScan)
+class IndexPQFastScan(IndexFastScan):
+    r"""
+     Fast scan version of IndexPQ. Works for 4-bit PQ for now.
+
+    The codes are not stored sequentially but grouped in blocks of size bbs.
+    This makes it possible to compute distances quickly with SIMD instructions.
+
+    Implementations:
+    12: blocked loop with internal loop on Q with qbs
+    13: same with reservoir accumulator to store results
+    14: no qbs with heap accumulator
+    15: no qbs with reservoir accumulator
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    pq = property(_swigfaiss_avx2.IndexPQFastScan_pq_get, _swigfaiss_avx2.IndexPQFastScan_pq_set)
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+        build from an existing IndexPQ
+
+        |
+
+        *Overload 2:*
+        build from an existing IndexPQ
+        """
+        _swigfaiss_avx2.IndexPQFastScan_swiginit(self, _swigfaiss_avx2.new_IndexPQFastScan(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexPQFastScan_train(self, n, x)
+
+    def compute_codes(self, codes, n, x):
+        return _swigfaiss_avx2.IndexPQFastScan_compute_codes(self, codes, n, x)
+
+    def compute_float_LUT(self, lut, n, x):
+        return _swigfaiss_avx2.IndexPQFastScan_compute_float_LUT(self, lut, n, x)
+
+    def sa_decode(self, n, bytes, x):
+        r"""
+         Decode a set of vectors.
+
+         NOTE: The codes in the IndexPQFastScan object are non-contiguous.
+               But this method requires a contiguous representation.
+
+        :type n: int
+        :param n:       number of vectors
+        :type bytes: uint8_t
+        :param bytes:   input encoded vectors, size n * code_size
+        :type x: float
+        :param x:       output vectors, size n * d
+        """
+        return _swigfaiss_avx2.IndexPQFastScan_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexPQFastScan
+
+# Register IndexPQFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexPQFastScan_swigregister(IndexPQFastScan)
+class simd16uint16(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self):
+        _swigfaiss_avx2.simd16uint16_swiginit(self, _swigfaiss_avx2.new_simd16uint16())
+    __swig_destroy__ = _swigfaiss_avx2.delete_simd16uint16
+
+# Register simd16uint16 in _swigfaiss_avx2:
+_swigfaiss_avx2.simd16uint16_swigregister(simd16uint16)
+class SIMDResultHandler(object):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+      This file contains callbacks for kernels that compute distances.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    is_CMax = property(_swigfaiss_avx2.SIMDResultHandler_is_CMax_get, _swigfaiss_avx2.SIMDResultHandler_is_CMax_set)
+    sizeof_ids = property(_swigfaiss_avx2.SIMDResultHandler_sizeof_ids_get, _swigfaiss_avx2.SIMDResultHandler_sizeof_ids_set)
+    with_fields = property(_swigfaiss_avx2.SIMDResultHandler_with_fields_get, _swigfaiss_avx2.SIMDResultHandler_with_fields_set)
+
+    def handle(self, q, b, d0, d1):
+        r"""
+        called when 32 distances are computed and provided in two
+        simd16uint16. (q, b) indicate which entry it is in the block.
+        """
+        return _swigfaiss_avx2.SIMDResultHandler_handle(self, q, b, d0, d1)
+
+    def set_block_origin(self, i0, j0):
+        r""" set the sub-matrix that is being computed"""
+        return _swigfaiss_avx2.SIMDResultHandler_set_block_origin(self, i0, j0)
+    __swig_destroy__ = _swigfaiss_avx2.delete_SIMDResultHandler
+
+# Register SIMDResultHandler in _swigfaiss_avx2:
+_swigfaiss_avx2.SIMDResultHandler_swigregister(SIMDResultHandler)
+class SIMDResultHandlerToFloat(SIMDResultHandler):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss_avx2.SIMDResultHandlerToFloat_nq_get, _swigfaiss_avx2.SIMDResultHandlerToFloat_nq_set)
+    ntotal = property(_swigfaiss_avx2.SIMDResultHandlerToFloat_ntotal_get, _swigfaiss_avx2.SIMDResultHandlerToFloat_ntotal_set)
+    id_map = property(_swigfaiss_avx2.SIMDResultHandlerToFloat_id_map_get, _swigfaiss_avx2.SIMDResultHandlerToFloat_id_map_set, doc=r""" these fields are used mainly for the IVF variants (with_id_map=true)""")
+    q_map = property(_swigfaiss_avx2.SIMDResultHandlerToFloat_q_map_get, _swigfaiss_avx2.SIMDResultHandlerToFloat_q_map_set)
+    dbias = property(_swigfaiss_avx2.SIMDResultHandlerToFloat_dbias_get, _swigfaiss_avx2.SIMDResultHandlerToFloat_dbias_set)
+    normalizers = property(_swigfaiss_avx2.SIMDResultHandlerToFloat_normalizers_get, _swigfaiss_avx2.SIMDResultHandlerToFloat_normalizers_set)
+
+    def begin(self, norms):
+        return _swigfaiss_avx2.SIMDResultHandlerToFloat_begin(self, norms)
+
+    def end(self):
+        return _swigfaiss_avx2.SIMDResultHandlerToFloat_end(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_SIMDResultHandlerToFloat
+
+# Register SIMDResultHandlerToFloat in _swigfaiss_avx2:
+_swigfaiss_avx2.SIMDResultHandlerToFloat_swigregister(SIMDResultHandlerToFloat)
+class DummyResultHandler(SIMDResultHandler):
+    r"""
+     Dummy structure that just computes a chqecksum on results
+    (to avoid the computation to be optimized away)
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    cs = property(_swigfaiss_avx2.DummyResultHandler_cs_get, _swigfaiss_avx2.DummyResultHandler_cs_set)
+
+    def handle(self, q, b, d0, d1):
+        return _swigfaiss_avx2.DummyResultHandler_handle(self, q, b, d0, d1)
+
+    def set_block_origin(self, arg2, arg3):
+        return _swigfaiss_avx2.DummyResultHandler_set_block_origin(self, arg2, arg3)
+    __swig_destroy__ = _swigfaiss_avx2.delete_DummyResultHandler
+
+    def __init__(self):
+        _swigfaiss_avx2.DummyResultHandler_swiginit(self, _swigfaiss_avx2.new_DummyResultHandler())
+
+# Register DummyResultHandler in _swigfaiss_avx2:
+_swigfaiss_avx2.DummyResultHandler_swigregister(DummyResultHandler)
+class StoreResultHandler(SIMDResultHandler):
+    r"""
+     memorize results in a nq-by-nb matrix.
+
+    j0 is the current upper-left block of the matrix
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    data = property(_swigfaiss_avx2.StoreResultHandler_data_get, _swigfaiss_avx2.StoreResultHandler_data_set)
+    ld = property(_swigfaiss_avx2.StoreResultHandler_ld_get, _swigfaiss_avx2.StoreResultHandler_ld_set)
+    i0 = property(_swigfaiss_avx2.StoreResultHandler_i0_get, _swigfaiss_avx2.StoreResultHandler_i0_set)
+    j0 = property(_swigfaiss_avx2.StoreResultHandler_j0_get, _swigfaiss_avx2.StoreResultHandler_j0_set)
+
+    def __init__(self, data, ld):
+        _swigfaiss_avx2.StoreResultHandler_swiginit(self, _swigfaiss_avx2.new_StoreResultHandler(data, ld))
+
+    def handle(self, q, b, d0, d1):
+        return _swigfaiss_avx2.StoreResultHandler_handle(self, q, b, d0, d1)
+
+    def set_block_origin(self, i0_in, j0_in):
+        return _swigfaiss_avx2.StoreResultHandler_set_block_origin(self, i0_in, j0_in)
+    __swig_destroy__ = _swigfaiss_avx2.delete_StoreResultHandler
+
+# Register StoreResultHandler in _swigfaiss_avx2:
+_swigfaiss_avx2.StoreResultHandler_swigregister(StoreResultHandler)
+class IndexIVFFastScan(IndexIVF):
+    r"""
+     Fast scan version of IVFPQ and IVFAQ. Works for 4-bit PQ/AQ for now.
+
+    The codes in the inverted lists are not stored sequentially but
+    grouped in blocks of size bbs. This makes it possible to very quickly
+    compute distances with SIMD instructions.
+
+    Implementations (implem):
+    0: auto-select implementation (default)
+    1: orig's search, re-implemented
+    2: orig's search, re-ordered by invlist
+    10: optimizer int16 search, collect results in heap, no qbs
+    11: idem, collect results in reservoir
+    12: optimizer int16 search, collect results in heap, uses qbs
+    13: idem, collect results in reservoir
+    14: internally multithreaded implem over nq * nprobe
+    15: same with reservoir
+
+    For range search, only 10 and 12 are supported.
+    add 100 to the implem to force single-thread scanning (the coarse quantizer
+    may still use multiple threads).
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    bbs = property(_swigfaiss_avx2.IndexIVFFastScan_bbs_get, _swigfaiss_avx2.IndexIVFFastScan_bbs_set)
+    M = property(_swigfaiss_avx2.IndexIVFFastScan_M_get, _swigfaiss_avx2.IndexIVFFastScan_M_set)
+    nbits = property(_swigfaiss_avx2.IndexIVFFastScan_nbits_get, _swigfaiss_avx2.IndexIVFFastScan_nbits_set)
+    ksub = property(_swigfaiss_avx2.IndexIVFFastScan_ksub_get, _swigfaiss_avx2.IndexIVFFastScan_ksub_set)
+    M2 = property(_swigfaiss_avx2.IndexIVFFastScan_M2_get, _swigfaiss_avx2.IndexIVFFastScan_M2_set)
+    implem = property(_swigfaiss_avx2.IndexIVFFastScan_implem_get, _swigfaiss_avx2.IndexIVFFastScan_implem_set)
+    skip = property(_swigfaiss_avx2.IndexIVFFastScan_skip_get, _swigfaiss_avx2.IndexIVFFastScan_skip_set)
+    qbs = property(_swigfaiss_avx2.IndexIVFFastScan_qbs_get, _swigfaiss_avx2.IndexIVFFastScan_qbs_set)
+    qbs2 = property(_swigfaiss_avx2.IndexIVFFastScan_qbs2_get, _swigfaiss_avx2.IndexIVFFastScan_qbs2_set)
+
+    def init_fastscan(self, M, nbits, nlist, metric, bbs):
+        return _swigfaiss_avx2.IndexIVFFastScan_init_fastscan(self, M, nbits, nlist, metric, bbs)
+
+    def init_code_packer(self):
+        return _swigfaiss_avx2.IndexIVFFastScan_init_code_packer(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFFastScan
+    orig_invlists = property(_swigfaiss_avx2.IndexIVFFastScan_orig_invlists_get, _swigfaiss_avx2.IndexIVFFastScan_orig_invlists_set, doc=r""" orig's inverted lists (for debugging)""")
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss_avx2.IndexIVFFastScan_add_with_ids(self, n, x, xids)
+
+    def lookup_table_is_3d(self):
+        return _swigfaiss_avx2.IndexIVFFastScan_lookup_table_is_3d(self)
+
+    def compute_LUT(self, n, x, cq, dis_tables, biases):
+        return _swigfaiss_avx2.IndexIVFFastScan_compute_LUT(self, n, x, cq, dis_tables, biases)
+
+    def compute_LUT_uint8(self, n, x, cq, dis_tables, biases, normalizers):
+        return _swigfaiss_avx2.IndexIVFFastScan_compute_LUT_uint8(self, n, x, cq, dis_tables, biases, normalizers)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexIVFFastScan_search(self, n, x, k, distances, labels, params)
+
+    def search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params=None, stats=None):
+        return _swigfaiss_avx2.IndexIVFFastScan_search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params, stats)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss_avx2.IndexIVFFastScan_range_search(self, n, x, radius, result, params)
+
+    def search_dispatch_implem(self, n, x, k, distances, labels, cq, scaler):
+        return _swigfaiss_avx2.IndexIVFFastScan_search_dispatch_implem(self, n, x, k, distances, labels, cq, scaler)
+
+    def range_search_dispatch_implem(self, n, x, radius, rres, cq_in, scaler):
+        return _swigfaiss_avx2.IndexIVFFastScan_range_search_dispatch_implem(self, n, x, radius, rres, cq_in, scaler)
+
+    def search_implem_10(self, n, x, handler, cq, ndis_out, nlist_out, scaler):
+        return _swigfaiss_avx2.IndexIVFFastScan_search_implem_10(self, n, x, handler, cq, ndis_out, nlist_out, scaler)
+
+    def search_implem_12(self, n, x, handler, cq, ndis_out, nlist_out, scaler):
+        return _swigfaiss_avx2.IndexIVFFastScan_search_implem_12(self, n, x, handler, cq, ndis_out, nlist_out, scaler)
+
+    def search_implem_14(self, n, x, k, distances, labels, cq, impl, scaler):
+        return _swigfaiss_avx2.IndexIVFFastScan_search_implem_14(self, n, x, k, distances, labels, cq, impl, scaler)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        return _swigfaiss_avx2.IndexIVFFastScan_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def get_CodePacker(self):
+        return _swigfaiss_avx2.IndexIVFFastScan_get_CodePacker(self)
+
+    def reconstruct_orig_invlists(self):
+        return _swigfaiss_avx2.IndexIVFFastScan_reconstruct_orig_invlists(self)
+
+# Register IndexIVFFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFFastScan_swigregister(IndexIVFFastScan)
+class IVFFastScanStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    times = property(_swigfaiss_avx2.IVFFastScanStats_times_get, _swigfaiss_avx2.IVFFastScanStats_times_set)
+    t_compute_distance_tables = property(_swigfaiss_avx2.IVFFastScanStats_t_compute_distance_tables_get, _swigfaiss_avx2.IVFFastScanStats_t_compute_distance_tables_set)
+    t_round = property(_swigfaiss_avx2.IVFFastScanStats_t_round_get, _swigfaiss_avx2.IVFFastScanStats_t_round_set)
+    t_copy_pack = property(_swigfaiss_avx2.IVFFastScanStats_t_copy_pack_get, _swigfaiss_avx2.IVFFastScanStats_t_copy_pack_set)
+    t_scan = property(_swigfaiss_avx2.IVFFastScanStats_t_scan_get, _swigfaiss_avx2.IVFFastScanStats_t_scan_set)
+    t_to_flat = property(_swigfaiss_avx2.IVFFastScanStats_t_to_flat_get, _swigfaiss_avx2.IVFFastScanStats_t_to_flat_set)
+    reservoir_times = property(_swigfaiss_avx2.IVFFastScanStats_reservoir_times_get, _swigfaiss_avx2.IVFFastScanStats_reservoir_times_set)
+    t_aq_encode = property(_swigfaiss_avx2.IVFFastScanStats_t_aq_encode_get, _swigfaiss_avx2.IVFFastScanStats_t_aq_encode_set)
+    t_aq_norm_encode = property(_swigfaiss_avx2.IVFFastScanStats_t_aq_norm_encode_get, _swigfaiss_avx2.IVFFastScanStats_t_aq_norm_encode_set)
+
+    def Mcy_at(self, i):
+        return _swigfaiss_avx2.IVFFastScanStats_Mcy_at(self, i)
+
+    def Mcy_reservoir_at(self, i):
+        return _swigfaiss_avx2.IVFFastScanStats_Mcy_reservoir_at(self, i)
+
+    def __init__(self):
+        _swigfaiss_avx2.IVFFastScanStats_swiginit(self, _swigfaiss_avx2.new_IVFFastScanStats())
+
+    def reset(self):
+        return _swigfaiss_avx2.IVFFastScanStats_reset(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IVFFastScanStats
+
+# Register IVFFastScanStats in _swigfaiss_avx2:
+_swigfaiss_avx2.IVFFastScanStats_swigregister(IVFFastScanStats)
+class IndexIVFAdditiveQuantizerFastScan(IndexIVFFastScan):
+    r"""
+     Fast scan version of IVFAQ. Works for 4-bit AQ for now.
+
+    The codes in the inverted lists are not stored sequentially but
+    grouped in blocks of size bbs. This makes it possible to very quickly
+    compute distances with SIMD instructions.
+
+    Implementations (implem):
+    0: auto-select implementation (default)
+    1: orig's search, re-implemented
+    2: orig's search, re-ordered by invlist
+    10: optimizer int16 search, collect results in heap, no qbs
+    11: idem, collect results in reservoir
+    12: optimizer int16 search, collect results in heap, uses qbs
+    13: idem, collect results in reservoir
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    aq = property(_swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_aq_get, _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_aq_set)
+    rescale_norm = property(_swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_rescale_norm_get, _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_rescale_norm_set)
+    norm_scale = property(_swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_norm_scale_get, _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_norm_scale_set)
+    max_train_points = property(_swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_max_train_points_get, _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_max_train_points_set)
+
+    def init(self, aq, nlist, metric, bbs):
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_init(self, aq, nlist, metric, bbs)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFAdditiveQuantizerFastScan
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_swiginit(self, _swigfaiss_avx2.new_IndexIVFAdditiveQuantizerFastScan(*args))
+
+    def train_encoder(self, n, x, assign):
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_train_encoder_num_vectors(self)
+
+    def estimate_norm_scale(self, n, x):
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_estimate_norm_scale(self, n, x)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listno=False):
+        r"""
+        same as the regular IVFAQ encoder. The codes are not reorganized by
+        blocks a that point
+        """
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_encode_vectors(self, n, x, list_nos, codes, include_listno)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_search(self, n, x, k, distances, labels, params)
+
+    def lookup_table_is_3d(self):
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_lookup_table_is_3d(self)
+
+    def compute_LUT(self, n, x, cq, dis_tables, biases):
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_compute_LUT(self, n, x, cq, dis_tables, biases)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_sa_decode(self, n, bytes, x)
+
+# Register IndexIVFAdditiveQuantizerFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFAdditiveQuantizerFastScan_swigregister(IndexIVFAdditiveQuantizerFastScan)
+class IndexIVFLocalSearchQuantizerFastScan(IndexIVFAdditiveQuantizerFastScan):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lsq = property(_swigfaiss_avx2.IndexIVFLocalSearchQuantizerFastScan_lsq_get, _swigfaiss_avx2.IndexIVFLocalSearchQuantizerFastScan_lsq_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFLocalSearchQuantizerFastScan_swiginit(self, _swigfaiss_avx2.new_IndexIVFLocalSearchQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFLocalSearchQuantizerFastScan
+
+# Register IndexIVFLocalSearchQuantizerFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFLocalSearchQuantizerFastScan_swigregister(IndexIVFLocalSearchQuantizerFastScan)
+class IndexIVFResidualQuantizerFastScan(IndexIVFAdditiveQuantizerFastScan):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rq = property(_swigfaiss_avx2.IndexIVFResidualQuantizerFastScan_rq_get, _swigfaiss_avx2.IndexIVFResidualQuantizerFastScan_rq_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFResidualQuantizerFastScan_swiginit(self, _swigfaiss_avx2.new_IndexIVFResidualQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFResidualQuantizerFastScan
+
+# Register IndexIVFResidualQuantizerFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFResidualQuantizerFastScan_swigregister(IndexIVFResidualQuantizerFastScan)
+class IndexIVFProductLocalSearchQuantizerFastScan(IndexIVFAdditiveQuantizerFastScan):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    plsq = property(_swigfaiss_avx2.IndexIVFProductLocalSearchQuantizerFastScan_plsq_get, _swigfaiss_avx2.IndexIVFProductLocalSearchQuantizerFastScan_plsq_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFProductLocalSearchQuantizerFastScan_swiginit(self, _swigfaiss_avx2.new_IndexIVFProductLocalSearchQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFProductLocalSearchQuantizerFastScan
+
+# Register IndexIVFProductLocalSearchQuantizerFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFProductLocalSearchQuantizerFastScan_swigregister(IndexIVFProductLocalSearchQuantizerFastScan)
+class IndexIVFProductResidualQuantizerFastScan(IndexIVFAdditiveQuantizerFastScan):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    prq = property(_swigfaiss_avx2.IndexIVFProductResidualQuantizerFastScan_prq_get, _swigfaiss_avx2.IndexIVFProductResidualQuantizerFastScan_prq_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFProductResidualQuantizerFastScan_swiginit(self, _swigfaiss_avx2.new_IndexIVFProductResidualQuantizerFastScan(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFProductResidualQuantizerFastScan
+
+# Register IndexIVFProductResidualQuantizerFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFProductResidualQuantizerFastScan_swigregister(IndexIVFProductResidualQuantizerFastScan)
+class IndexIVFIndependentQuantizer(Index):
+    r"""
+     An IVF index with a quantizer that has a different input dimension from the
+    payload size. The vectors to encode are obtained from the input vectors by a
+    VectorTransform.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    quantizer = property(_swigfaiss_avx2.IndexIVFIndependentQuantizer_quantizer_get, _swigfaiss_avx2.IndexIVFIndependentQuantizer_quantizer_set, doc=r""" quantizer is fed directly with the input vectors""")
+    vt = property(_swigfaiss_avx2.IndexIVFIndependentQuantizer_vt_get, _swigfaiss_avx2.IndexIVFIndependentQuantizer_vt_set, doc=r""" transform before the IVF vectors are applied""")
+    index_ivf = property(_swigfaiss_avx2.IndexIVFIndependentQuantizer_index_ivf_get, _swigfaiss_avx2.IndexIVFIndependentQuantizer_index_ivf_set, doc=r""" the IVF index, controls nlist and nprobe""")
+    own_fields = property(_swigfaiss_avx2.IndexIVFIndependentQuantizer_own_fields_get, _swigfaiss_avx2.IndexIVFIndependentQuantizer_own_fields_set, doc=r""" whether *this owns the 3 fields""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFIndependentQuantizer_swiginit(self, _swigfaiss_avx2.new_IndexIVFIndependentQuantizer(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexIVFIndependentQuantizer_train(self, n, x)
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexIVFIndependentQuantizer_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexIVFIndependentQuantizer_search(self, n, x, k, distances, labels, params)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexIVFIndependentQuantizer_reset(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFIndependentQuantizer
+
+# Register IndexIVFIndependentQuantizer in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFIndependentQuantizer_swigregister(IndexIVFIndependentQuantizer)
+class IndexIVFPQFastScan(IndexIVFFastScan):
+    r"""
+     Fast scan version of IVFPQ. Works for 4-bit PQ for now.
+
+    The codes in the inverted lists are not stored sequentially but
+    grouped in blocks of size bbs. This makes it possible to very quickly
+    compute distances with SIMD instructions.
+
+    Implementations (implem):
+    0: auto-select implementation (default)
+    1: orig's search, re-implemented
+    2: orig's search, re-ordered by invlist
+    10: optimizer int16 search, collect results in heap, no qbs
+    11: idem, collect results in reservoir
+    12: optimizer int16 search, collect results in heap, uses qbs
+    13: idem, collect results in reservoir
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    pq = property(_swigfaiss_avx2.IndexIVFPQFastScan_pq_get, _swigfaiss_avx2.IndexIVFPQFastScan_pq_set, doc=r""" produces the codes""")
+    use_precomputed_table = property(_swigfaiss_avx2.IndexIVFPQFastScan_use_precomputed_table_get, _swigfaiss_avx2.IndexIVFPQFastScan_use_precomputed_table_set, doc=r""" precomputed tables management""")
+    precomputed_table = property(_swigfaiss_avx2.IndexIVFPQFastScan_precomputed_table_get, _swigfaiss_avx2.IndexIVFPQFastScan_precomputed_table_set, doc=r""" if use_precompute_table size (nlist, pq.M, pq.ksub)""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIVFPQFastScan_swiginit(self, _swigfaiss_avx2.new_IndexIVFPQFastScan(*args))
+
+    def train_encoder(self, n, x, assign):
+        return _swigfaiss_avx2.IndexIVFPQFastScan_train_encoder(self, n, x, assign)
+
+    def train_encoder_num_vectors(self):
+        return _swigfaiss_avx2.IndexIVFPQFastScan_train_encoder_num_vectors(self)
+
+    def precompute_table(self):
+        r""" build precomputed table, possibly updating use_precomputed_table"""
+        return _swigfaiss_avx2.IndexIVFPQFastScan_precompute_table(self)
+
+    def encode_vectors(self, n, x, list_nos, codes, include_listno=False):
+        r"""
+        same as the regular IVFPQ encoder. The codes are not reorganized by
+        blocks a that point
+        """
+        return _swigfaiss_avx2.IndexIVFPQFastScan_encode_vectors(self, n, x, list_nos, codes, include_listno)
+
+    def lookup_table_is_3d(self):
+        return _swigfaiss_avx2.IndexIVFPQFastScan_lookup_table_is_3d(self)
+
+    def compute_LUT(self, n, x, cq, dis_tables, biases):
+        return _swigfaiss_avx2.IndexIVFPQFastScan_compute_LUT(self, n, x, cq, dis_tables, biases)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexIVFPQFastScan_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIVFPQFastScan
+
+# Register IndexIVFPQFastScan in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIVFPQFastScan_swigregister(IndexIVFPQFastScan)
+
+def round_uint8_per_column(tab, n, d, a_out=None, b_out=None):
+    r"""
+     Functions to quantize PQ floating-point Look Up Tables (LUT) to uint8, and
+    biases to uint16. The accumulation is supposed to take place in uint16.
+    The quantization coefficients are float (a, b) such that
+
+         original_value = quantized_value * a / b
+
+    The hardest part of the quantization is with multiple LUTs that need to be
+    added up together. In that case, coefficient a has to be chosen so that
+    the sum fits in a uint16 accumulator.
+    """
+    return _swigfaiss_avx2.round_uint8_per_column(tab, n, d, a_out, b_out)
+
+def round_uint8_per_column_multi(tab, m, n, d, a_out=None, b_out=None):
+    return _swigfaiss_avx2.round_uint8_per_column_multi(tab, m, n, d, a_out, b_out)
+
+def quantize_LUT_and_bias(nprobe, M, ksub, lut_is_3d, LUT, bias, LUTq, M2, biasq, a_out=None, b_out=None):
+    r"""
+     LUT quantization to uint8 and bias to uint16.
+
+    (nprobe, M, ksub, lut_is_3d) determine the size of the the LUT
+
+     LUT input:
+     - 2D size (M, ksub): single matrix per probe (lut_is_3d=false)
+     - 3D size (nprobe, M, ksub): separate LUT per probe (lut_is_3d=true)
+     bias input:
+     - nullptr: bias is 0
+     - size (nprobe): one bias per probe
+     Output:
+     - LUTq uint8 version of the LUT (M size is rounded up to M2)
+     - biasq (or nullptr): uint16 version of the LUT
+     - a, b: scalars to approximate the true distance
+    """
+    return _swigfaiss_avx2.quantize_LUT_and_bias(nprobe, M, ksub, lut_is_3d, LUT, bias, LUTq, M2, biasq, a_out, b_out)
+
+def aq_quantize_LUT_and_bias(nprobe, M, ksub, LUT, bias, M_norm, norm_scale, LUTq, M2, biasq, a_out, b_out):
+    return _swigfaiss_avx2.aq_quantize_LUT_and_bias(nprobe, M, ksub, LUT, bias, M_norm, norm_scale, LUTq, M2, biasq, a_out, b_out)
+
+def aq_estimate_norm_scale(M, ksub, M_norm, LUT):
+    return _swigfaiss_avx2.aq_estimate_norm_scale(M, ksub, M_norm, LUT)
+class IndexBinary(object):
+    r"""
+     Abstract structure for a binary index.
+
+    Supports adding vertices and searching them.
+
+    All queries are symmetric because there is no distinction between codes and
+    vectors.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    d = property(_swigfaiss_avx2.IndexBinary_d_get, _swigfaiss_avx2.IndexBinary_d_set, doc=r""" vector dimension""")
+    code_size = property(_swigfaiss_avx2.IndexBinary_code_size_get, _swigfaiss_avx2.IndexBinary_code_size_set, doc=r""" number of bytes per vector ( = d / 8 )""")
+    ntotal = property(_swigfaiss_avx2.IndexBinary_ntotal_get, _swigfaiss_avx2.IndexBinary_ntotal_set, doc=r""" total nb of indexed vectors""")
+    verbose = property(_swigfaiss_avx2.IndexBinary_verbose_get, _swigfaiss_avx2.IndexBinary_verbose_set, doc=r""" verbosity level""")
+    is_trained = property(_swigfaiss_avx2.IndexBinary_is_trained_get, _swigfaiss_avx2.IndexBinary_is_trained_set, doc=r"""
+    set if the Index does not require training, or if training is done
+    already
+    """)
+    metric_type = property(_swigfaiss_avx2.IndexBinary_metric_type_get, _swigfaiss_avx2.IndexBinary_metric_type_set, doc=r""" type of metric this index uses for search""")
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexBinary
+
+    def train(self, n, x):
+        r"""
+         Perform training on a representative set of vectors.
+
+        :type n: int
+        :param n:      nb of training vectors
+        :type x: uint8_t
+        :param x:      training vecors, size n * d / 8
+        """
+        return _swigfaiss_avx2.IndexBinary_train(self, n, x)
+
+    def add(self, n, x):
+        r"""
+         Add n vectors of dimension d to the index.
+
+        Vectors are implicitly assigned labels ntotal .. ntotal + n - 1
+        :type x: uint8_t
+        :param x:      input matrix, size n * d / 8
+        """
+        return _swigfaiss_avx2.IndexBinary_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        r"""
+         Same as add, but stores xids instead of sequential ids.
+
+        The default implementation fails with an assertion, as it is
+        not supported by all indexes.
+
+        :type xids: int
+        :param xids: if non-null, ids to store for the vectors (size n)
+        """
+        return _swigfaiss_avx2.IndexBinary_add_with_ids(self, n, x, xids)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r"""
+         Query n vectors of dimension d to the index.
+
+        return at most k vectors. If there are not enough results for a
+        query, the result array is padded with -1s.
+
+        :type x: uint8_t
+        :param x:           input vectors to search, size n * d / 8
+        :type labels: int
+        :param labels:      output labels of the NNs, size n*k
+        :type distances: int
+        :param distances:   output pairwise distances, size n*k
+        """
+        return _swigfaiss_avx2.IndexBinary_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        r"""
+         Query n vectors of dimension d to the index.
+
+        return all vectors with distance < radius. Note that many indexes
+        do not implement the range_search (only the k-NN search is
+        mandatory). The distances are converted to float to reuse the
+        RangeSearchResult structure, but they are integer. By convention,
+        only distances < radius (strict comparison) are returned,
+        ie. radius = 0 does not return any result and 1 returns only
+        exact same vectors.
+
+        :type x: uint8_t
+        :param x:           input vectors to search, size n * d / 8
+        :type radius: int
+        :param radius:      search radius
+        :type result: :py:class:`RangeSearchResult`
+        :param result:      result table
+        """
+        return _swigfaiss_avx2.IndexBinary_range_search(self, n, x, radius, result, params)
+
+    def assign(self, n, x, labels, k=1):
+        r"""
+         Return the indexes of the k vectors closest to the query x.
+
+        This function is identical to search but only returns labels of
+        neighbors.
+        :type x: uint8_t
+        :param x:           input vectors to search, size n * d / 8
+        :type labels: int
+        :param labels:      output labels of the NNs, size n*k
+        """
+        return _swigfaiss_avx2.IndexBinary_assign(self, n, x, labels, k)
+
+    def reset(self):
+        r""" Removes all elements from the database."""
+        return _swigfaiss_avx2.IndexBinary_reset(self)
+
+    def remove_ids(self, sel):
+        r""" Removes IDs from the index. Not supported by all indexes."""
+        return _swigfaiss_avx2.IndexBinary_remove_ids(self, sel)
+
+    def reconstruct(self, key, recons):
+        r"""
+         Reconstruct a stored vector.
+
+        This function may not be defined for some indexes.
+        :type key: int
+        :param key:         id of the vector to reconstruct
+        :type recons: uint8_t
+        :param recons:      reconstucted vector (size d / 8)
+        """
+        return _swigfaiss_avx2.IndexBinary_reconstruct(self, key, recons)
+
+    def reconstruct_n(self, i0, ni, recons):
+        r"""
+         Reconstruct vectors i0 to i0 + ni - 1.
+
+        This function may not be defined for some indexes.
+        :type recons: uint8_t
+        :param recons:      reconstucted vectors (size ni * d / 8)
+        """
+        return _swigfaiss_avx2.IndexBinary_reconstruct_n(self, i0, ni, recons)
+
+    def search_and_reconstruct(self, n, x, k, distances, labels, recons, params=None):
+        r"""
+         Similar to search, but also reconstructs the stored vectors (or an
+        approximation in the case of lossy coding) for the search results.
+
+        If there are not enough results for a query, the resulting array
+        is padded with -1s.
+
+        :type recons: uint8_t
+        :param recons:      reconstructed vectors size (n, k, d)
+        """
+        return _swigfaiss_avx2.IndexBinary_search_and_reconstruct(self, n, x, k, distances, labels, recons, params)
+
+    def display(self):
+        r""" Display the actual class name and some more info."""
+        return _swigfaiss_avx2.IndexBinary_display(self)
+
+    def merge_from(self, otherIndex, add_id=0):
+        r"""
+         moves the entries from another dataset to self.
+        On output, other is empty.
+        add_id is added to all moved ids
+        (for sequential ids, this would be this->ntotal)
+        """
+        return _swigfaiss_avx2.IndexBinary_merge_from(self, otherIndex, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        r"""
+         check that the two indexes are compatible (ie, they are
+        trained in the same way and have the same
+        parameters). Otherwise throw.
+        """
+        return _swigfaiss_avx2.IndexBinary_check_compatible_for_merge(self, otherIndex)
+
+# Register IndexBinary in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexBinary_swigregister(IndexBinary)
+class IndexBinaryFlat(IndexBinary):
+    r""" Index that stores the full vectors and performs exhaustive search."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    xb = property(_swigfaiss_avx2.IndexBinaryFlat_xb_get, _swigfaiss_avx2.IndexBinaryFlat_xb_set, doc=r""" database vectors, size ntotal * d / 8""")
+    use_heap = property(_swigfaiss_avx2.IndexBinaryFlat_use_heap_get, _swigfaiss_avx2.IndexBinaryFlat_use_heap_set, doc=r"""
+     Select between using a heap or counting to select the k smallest values
+    when scanning inverted lists.
+    """)
+    query_batch_size = property(_swigfaiss_avx2.IndexBinaryFlat_query_batch_size_get, _swigfaiss_avx2.IndexBinaryFlat_query_batch_size_set)
+    approx_topk_mode = property(_swigfaiss_avx2.IndexBinaryFlat_approx_topk_mode_get, _swigfaiss_avx2.IndexBinaryFlat_approx_topk_mode_set)
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexBinaryFlat_add(self, n, x)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexBinaryFlat_reset(self)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexBinaryFlat_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss_avx2.IndexBinaryFlat_range_search(self, n, x, radius, result, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexBinaryFlat_reconstruct(self, key, recons)
+
+    def remove_ids(self, sel):
+        r"""
+         Remove some ids. Note that because of the indexing structure,
+        the semantics of this operation are different from the usual ones:
+        the new ids are shifted.
+        """
+        return _swigfaiss_avx2.IndexBinaryFlat_remove_ids(self, sel)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexBinaryFlat_swiginit(self, _swigfaiss_avx2.new_IndexBinaryFlat(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexBinaryFlat
+
+# Register IndexBinaryFlat in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexBinaryFlat_swigregister(IndexBinaryFlat)
+class IndexBinaryIVF(IndexBinary):
+    r"""
+     Index based on a inverted file (IVF)
+
+    In the inverted file, the quantizer (an IndexBinary instance) provides a
+    quantization index for each vector to be added. The quantization
+    index maps to a list (aka inverted list or posting list), where the
+    id of the vector is stored.
+
+    Otherwise the object is similar to the IndexIVF
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    invlists = property(_swigfaiss_avx2.IndexBinaryIVF_invlists_get, _swigfaiss_avx2.IndexBinaryIVF_invlists_set, doc=r""" Access to the actual data""")
+    own_invlists = property(_swigfaiss_avx2.IndexBinaryIVF_own_invlists_get, _swigfaiss_avx2.IndexBinaryIVF_own_invlists_set)
+    nprobe = property(_swigfaiss_avx2.IndexBinaryIVF_nprobe_get, _swigfaiss_avx2.IndexBinaryIVF_nprobe_set, doc=r""" number of probes at query time""")
+    max_codes = property(_swigfaiss_avx2.IndexBinaryIVF_max_codes_get, _swigfaiss_avx2.IndexBinaryIVF_max_codes_set, doc=r""" max nb of codes to visit to do a query""")
+    use_heap = property(_swigfaiss_avx2.IndexBinaryIVF_use_heap_get, _swigfaiss_avx2.IndexBinaryIVF_use_heap_set, doc=r"""
+     Select between using a heap or counting to select the k smallest values
+    when scanning inverted lists.
+    """)
+    per_invlist_search = property(_swigfaiss_avx2.IndexBinaryIVF_per_invlist_search_get, _swigfaiss_avx2.IndexBinaryIVF_per_invlist_search_set, doc=r""" collect computations per batch""")
+    direct_map = property(_swigfaiss_avx2.IndexBinaryIVF_direct_map_get, _swigfaiss_avx2.IndexBinaryIVF_direct_map_set, doc=r""" map for direct access to the elements. Enables reconstruct().""")
+    quantizer = property(_swigfaiss_avx2.IndexBinaryIVF_quantizer_get, _swigfaiss_avx2.IndexBinaryIVF_quantizer_set, doc=r""" quantizer that maps vectors to inverted lists""")
+    nlist = property(_swigfaiss_avx2.IndexBinaryIVF_nlist_get, _swigfaiss_avx2.IndexBinaryIVF_nlist_set, doc=r""" number of possible key values""")
+    own_fields = property(_swigfaiss_avx2.IndexBinaryIVF_own_fields_get, _swigfaiss_avx2.IndexBinaryIVF_own_fields_set, doc=r""" whether object owns the quantizer""")
+    cp = property(_swigfaiss_avx2.IndexBinaryIVF_cp_get, _swigfaiss_avx2.IndexBinaryIVF_cp_set, doc=r""" to override default clustering params""")
+    clustering_index = property(_swigfaiss_avx2.IndexBinaryIVF_clustering_index_get, _swigfaiss_avx2.IndexBinaryIVF_clustering_index_set, doc=r""" to override index used during clustering""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexBinaryIVF_swiginit(self, _swigfaiss_avx2.new_IndexBinaryIVF(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexBinaryIVF
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexBinaryIVF_reset(self)
+
+    def train(self, n, x):
+        r""" Trains the quantizer"""
+        return _swigfaiss_avx2.IndexBinaryIVF_train(self, n, x)
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexBinaryIVF_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss_avx2.IndexBinaryIVF_add_with_ids(self, n, x, xids)
+
+    def add_core(self, n, x, xids, precomputed_idx):
+        r"""
+         Implementation of vector addition where the vector assignments are
+        predefined.
+
+        :type precomputed_idx: int
+        :param precomputed_idx:    quantization indices for the input vectors
+            (size n)
+        """
+        return _swigfaiss_avx2.IndexBinaryIVF_add_core(self, n, x, xids, precomputed_idx)
+
+    def search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params=None):
+        r"""
+         Search a set of vectors, that are pre-quantized by the IVF
+         quantizer. Fill in the corresponding heaps with the query
+         results. search() calls this.
+
+        :type n: int
+        :param n:      nb of vectors to query
+        :type x: uint8_t
+        :param x:      query vectors, size nx * d
+        :type assign: int
+        :param assign: coarse quantization indices, size nx * nprobe
+        :type centroid_dis: int
+        :param centroid_dis:
+                          distances to coarse centroids, size nx * nprobe
+        :param distance:
+                          output distances, size n * k
+        :type labels: int
+        :param labels: output labels, size n * k
+        :type store_pairs: boolean
+        :param store_pairs: store inv list index + inv list offset
+                                instead in upper/lower 32 bit of result,
+                                instead of ids (used for reranking).
+        :type params: :py:class:`IVFSearchParameters`, optional
+        :param params: used to override the object's search parameters
+        """
+        return _swigfaiss_avx2.IndexBinaryIVF_search_preassigned(self, n, x, k, assign, centroid_dis, distances, labels, store_pairs, params)
+
+    def get_InvertedListScanner(self, store_pairs=False):
+        return _swigfaiss_avx2.IndexBinaryIVF_get_InvertedListScanner(self, store_pairs)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" assign the vectors, then call search_preassign"""
+        return _swigfaiss_avx2.IndexBinaryIVF_search(self, n, x, k, distances, labels, params)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss_avx2.IndexBinaryIVF_range_search(self, n, x, radius, result, params)
+
+    def range_search_preassigned(self, n, x, radius, assign, centroid_dis, result):
+        return _swigfaiss_avx2.IndexBinaryIVF_range_search_preassigned(self, n, x, radius, assign, centroid_dis, result)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexBinaryIVF_reconstruct(self, key, recons)
+
+    def reconstruct_n(self, i0, ni, recons):
+        r"""
+         Reconstruct a subset of the indexed vectors.
+
+        Overrides default implementation to bypass reconstruct() which requires
+        direct_map to be maintained.
+
+        :type i0: int
+        :param i0:     first vector to reconstruct
+        :type ni: int
+        :param ni:     nb of vectors to reconstruct
+        :type recons: uint8_t
+        :param recons: output array of reconstructed vectors, size ni * d / 8
+        """
+        return _swigfaiss_avx2.IndexBinaryIVF_reconstruct_n(self, i0, ni, recons)
+
+    def search_and_reconstruct(self, n, x, k, distances, labels, recons, params=None):
+        r"""
+         Similar to search, but also reconstructs the stored vectors (or an
+        approximation in the case of lossy coding) for the search results.
+
+        Overrides default implementation to avoid having to maintain direct_map
+        and instead fetch the code offsets through the `store_pairs` flag in
+        search_preassigned().
+
+        :type recons: uint8_t
+        :param recons:      reconstructed vectors size (n, k, d / 8)
+        """
+        return _swigfaiss_avx2.IndexBinaryIVF_search_and_reconstruct(self, n, x, k, distances, labels, recons, params)
+
+    def reconstruct_from_offset(self, list_no, offset, recons):
+        r"""
+         Reconstruct a vector given the location in terms of (inv list index +
+        inv list offset) instead of the id.
+
+        Useful for reconstructing when the direct_map is not maintained and
+        the inv list offset is computed by search_preassigned() with
+        `store_pairs` set.
+        """
+        return _swigfaiss_avx2.IndexBinaryIVF_reconstruct_from_offset(self, list_no, offset, recons)
+
+    def remove_ids(self, sel):
+        r""" Dataset manipulation functions"""
+        return _swigfaiss_avx2.IndexBinaryIVF_remove_ids(self, sel)
+
+    def merge_from(self, other, add_id):
+        return _swigfaiss_avx2.IndexBinaryIVF_merge_from(self, other, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss_avx2.IndexBinaryIVF_check_compatible_for_merge(self, otherIndex)
+
+    def get_list_size(self, list_no):
+        return _swigfaiss_avx2.IndexBinaryIVF_get_list_size(self, list_no)
+
+    def make_direct_map(self, new_maintain_direct_map=True):
+        r"""
+         initialize a direct map
+
+        :type new_maintain_direct_map: boolean, optional
+        :param new_maintain_direct_map:    if true, create a direct map,
+                                              else clear it
+        """
+        return _swigfaiss_avx2.IndexBinaryIVF_make_direct_map(self, new_maintain_direct_map)
+
+    def set_direct_map_type(self, type):
+        return _swigfaiss_avx2.IndexBinaryIVF_set_direct_map_type(self, type)
+
+    def replace_invlists(self, il, own=False):
+        return _swigfaiss_avx2.IndexBinaryIVF_replace_invlists(self, il, own)
+
+# Register IndexBinaryIVF in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexBinaryIVF_swigregister(IndexBinaryIVF)
+class BinaryInvertedListScanner(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+
+    def set_query(self, query_vector):
+        r""" from now on we handle this query."""
+        return _swigfaiss_avx2.BinaryInvertedListScanner_set_query(self, query_vector)
+
+    def set_list(self, list_no, coarse_dis):
+        r""" following codes come from this inverted list"""
+        return _swigfaiss_avx2.BinaryInvertedListScanner_set_list(self, list_no, coarse_dis)
+
+    def distance_to_code(self, code):
+        r""" compute a single query-to-code distance"""
+        return _swigfaiss_avx2.BinaryInvertedListScanner_distance_to_code(self, code)
+
+    def scan_codes(self, n, codes, ids, distances, labels, k):
+        r"""
+         compute the distances to codes. (distances, labels) should be
+        organized as a min- or max-heap
+
+        :type n: int
+        :param n:      number of codes to scan
+        :type codes: uint8_t
+        :param codes:  codes to scan (n * code_size)
+        :type ids: int
+        :param ids:        corresponding ids (ignored if store_pairs)
+        :type distances: int
+        :param distances:  heap distances (size k)
+        :type labels: int
+        :param labels:     heap labels (size k)
+        :type k: int
+        :param k:          heap size
+        """
+        return _swigfaiss_avx2.BinaryInvertedListScanner_scan_codes(self, n, codes, ids, distances, labels, k)
+
+    def scan_codes_range(self, n, codes, ids, radius, result):
+        return _swigfaiss_avx2.BinaryInvertedListScanner_scan_codes_range(self, n, codes, ids, radius, result)
+    __swig_destroy__ = _swigfaiss_avx2.delete_BinaryInvertedListScanner
+
+# Register BinaryInvertedListScanner in _swigfaiss_avx2:
+_swigfaiss_avx2.BinaryInvertedListScanner_swigregister(BinaryInvertedListScanner)
+class IndexBinaryFromFloat(IndexBinary):
+    r"""
+     IndexBinary backed by a float Index.
+
+    Supports adding vertices and searching them.
+
+    All queries are symmetric because there is no distinction between codes and
+    vectors.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    index = property(_swigfaiss_avx2.IndexBinaryFromFloat_index_get, _swigfaiss_avx2.IndexBinaryFromFloat_index_set)
+    own_fields = property(_swigfaiss_avx2.IndexBinaryFromFloat_own_fields_get, _swigfaiss_avx2.IndexBinaryFromFloat_own_fields_set, doc=r""" Whether object owns the index pointer.""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexBinaryFromFloat_swiginit(self, _swigfaiss_avx2.new_IndexBinaryFromFloat(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexBinaryFromFloat
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexBinaryFromFloat_add(self, n, x)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexBinaryFromFloat_reset(self)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexBinaryFromFloat_search(self, n, x, k, distances, labels, params)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexBinaryFromFloat_train(self, n, x)
+
+# Register IndexBinaryFromFloat in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexBinaryFromFloat_swigregister(IndexBinaryFromFloat)
+class IndexBinaryHNSW(IndexBinary):
+    r"""
+     The HNSW index is a normal random-access index with a HNSW
+    link structure built on top
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    hnsw = property(_swigfaiss_avx2.IndexBinaryHNSW_hnsw_get, _swigfaiss_avx2.IndexBinaryHNSW_hnsw_set)
+    own_fields = property(_swigfaiss_avx2.IndexBinaryHNSW_own_fields_get, _swigfaiss_avx2.IndexBinaryHNSW_own_fields_set)
+    storage = property(_swigfaiss_avx2.IndexBinaryHNSW_storage_get, _swigfaiss_avx2.IndexBinaryHNSW_storage_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexBinaryHNSW_swiginit(self, _swigfaiss_avx2.new_IndexBinaryHNSW(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexBinaryHNSW
+
+    def get_distance_computer(self):
+        return _swigfaiss_avx2.IndexBinaryHNSW_get_distance_computer(self)
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexBinaryHNSW_add(self, n, x)
+
+    def train(self, n, x):
+        r""" Trains the storage if needed"""
+        return _swigfaiss_avx2.IndexBinaryHNSW_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r""" entry point for search"""
+        return _swigfaiss_avx2.IndexBinaryHNSW_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexBinaryHNSW_reconstruct(self, key, recons)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexBinaryHNSW_reset(self)
+
+# Register IndexBinaryHNSW in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexBinaryHNSW_swigregister(IndexBinaryHNSW)
+class IndexBinaryHash(IndexBinary):
+    r""" just uses the b first bits as a hash value"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    invlists = property(_swigfaiss_avx2.IndexBinaryHash_invlists_get, _swigfaiss_avx2.IndexBinaryHash_invlists_set)
+    b = property(_swigfaiss_avx2.IndexBinaryHash_b_get, _swigfaiss_avx2.IndexBinaryHash_b_set)
+    nflip = property(_swigfaiss_avx2.IndexBinaryHash_nflip_get, _swigfaiss_avx2.IndexBinaryHash_nflip_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexBinaryHash_swiginit(self, _swigfaiss_avx2.new_IndexBinaryHash(*args))
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexBinaryHash_reset(self)
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexBinaryHash_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss_avx2.IndexBinaryHash_add_with_ids(self, n, x, xids)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss_avx2.IndexBinaryHash_range_search(self, n, x, radius, result, params)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexBinaryHash_search(self, n, x, k, distances, labels, params)
+
+    def display(self):
+        return _swigfaiss_avx2.IndexBinaryHash_display(self)
+
+    def hashtable_size(self):
+        return _swigfaiss_avx2.IndexBinaryHash_hashtable_size(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexBinaryHash
+
+# Register IndexBinaryHash in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexBinaryHash_swigregister(IndexBinaryHash)
+class IndexBinaryHashStats(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss_avx2.IndexBinaryHashStats_nq_get, _swigfaiss_avx2.IndexBinaryHashStats_nq_set)
+    n0 = property(_swigfaiss_avx2.IndexBinaryHashStats_n0_get, _swigfaiss_avx2.IndexBinaryHashStats_n0_set)
+    nlist = property(_swigfaiss_avx2.IndexBinaryHashStats_nlist_get, _swigfaiss_avx2.IndexBinaryHashStats_nlist_set)
+    ndis = property(_swigfaiss_avx2.IndexBinaryHashStats_ndis_get, _swigfaiss_avx2.IndexBinaryHashStats_ndis_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.IndexBinaryHashStats_swiginit(self, _swigfaiss_avx2.new_IndexBinaryHashStats())
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexBinaryHashStats_reset(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexBinaryHashStats
+
+# Register IndexBinaryHashStats in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexBinaryHashStats_swigregister(IndexBinaryHashStats)
+class IndexBinaryMultiHash(IndexBinary):
+    r""" just uses the b first bits as a hash value"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    storage = property(_swigfaiss_avx2.IndexBinaryMultiHash_storage_get, _swigfaiss_avx2.IndexBinaryMultiHash_storage_set)
+    own_fields = property(_swigfaiss_avx2.IndexBinaryMultiHash_own_fields_get, _swigfaiss_avx2.IndexBinaryMultiHash_own_fields_set)
+    maps = property(_swigfaiss_avx2.IndexBinaryMultiHash_maps_get, _swigfaiss_avx2.IndexBinaryMultiHash_maps_set)
+    nhash = property(_swigfaiss_avx2.IndexBinaryMultiHash_nhash_get, _swigfaiss_avx2.IndexBinaryMultiHash_nhash_set, doc=r""" nb of hash maps""")
+    b = property(_swigfaiss_avx2.IndexBinaryMultiHash_b_get, _swigfaiss_avx2.IndexBinaryMultiHash_b_set, doc=r""" nb bits per hash map""")
+    nflip = property(_swigfaiss_avx2.IndexBinaryMultiHash_nflip_get, _swigfaiss_avx2.IndexBinaryMultiHash_nflip_set, doc=r""" nb bit flips to use at search time""")
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexBinaryMultiHash_swiginit(self, _swigfaiss_avx2.new_IndexBinaryMultiHash(*args))
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexBinaryMultiHash
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexBinaryMultiHash_reset(self)
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexBinaryMultiHash_add(self, n, x)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss_avx2.IndexBinaryMultiHash_range_search(self, n, x, radius, result, params)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexBinaryMultiHash_search(self, n, x, k, distances, labels, params)
+
+    def hashtable_size(self):
+        return _swigfaiss_avx2.IndexBinaryMultiHash_hashtable_size(self)
+
+# Register IndexBinaryMultiHash in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexBinaryMultiHash_swigregister(IndexBinaryMultiHash)
+class ThreadedIndexBase(Index):
+    r"""
+    A holder of indices in a collection of threads
+    The interface to this class itself is not thread safe
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    __swig_destroy__ = _swigfaiss_avx2.delete_ThreadedIndexBase
+
+    def addIndex(self, index):
+        r"""
+        override an index that is managed by ourselves.
+        WARNING: once an index is added, it becomes unsafe to touch it from any
+        other thread than that on which is managing it, until we are shut
+        down. Use runOnIndex to perform work on it instead.
+        """
+        return _swigfaiss_avx2.ThreadedIndexBase_addIndex(self, index)
+
+    def removeIndex(self, index):
+        r"""
+        Remove an index that is managed by ourselves.
+        This will flush all pending work on that index, and then shut
+        down its managing thread, and will remove the index.
+        """
+        return _swigfaiss_avx2.ThreadedIndexBase_removeIndex(self, index)
+
+    def runOnIndex(self, *args):
+        return _swigfaiss_avx2.ThreadedIndexBase_runOnIndex(self, *args)
+
+    def reset(self):
+        r"""
+        faiss::Index API
+        All indices receive the same call
+        """
+        return _swigfaiss_avx2.ThreadedIndexBase_reset(self)
+
+    def count(self):
+        r""" Returns the number of sub-indices"""
+        return _swigfaiss_avx2.ThreadedIndexBase_count(self)
+
+    def at(self, *args):
+        r"""
+        *Overload 1:*
+        Returns the i-th sub-index
+
+        |
+
+        *Overload 2:*
+        Returns the i-th sub-index (const version)
+        """
+        return _swigfaiss_avx2.ThreadedIndexBase_at(self, *args)
+    own_indices = property(_swigfaiss_avx2.ThreadedIndexBase_own_indices_get, _swigfaiss_avx2.ThreadedIndexBase_own_indices_set, doc=r""" Whether or not we are responsible for deleting our contained indices""")
+
+# Register ThreadedIndexBase in _swigfaiss_avx2:
+_swigfaiss_avx2.ThreadedIndexBase_swigregister(ThreadedIndexBase)
+class ThreadedIndexBaseBinary(IndexBinary):
+    r"""
+    A holder of indices in a collection of threads
+    The interface to this class itself is not thread safe
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    __swig_destroy__ = _swigfaiss_avx2.delete_ThreadedIndexBaseBinary
+
+    def addIndex(self, index):
+        r"""
+        override an index that is managed by ourselves.
+        WARNING: once an index is added, it becomes unsafe to touch it from any
+        other thread than that on which is managing it, until we are shut
+        down. Use runOnIndex to perform work on it instead.
+        """
+        return _swigfaiss_avx2.ThreadedIndexBaseBinary_addIndex(self, index)
+
+    def removeIndex(self, index):
+        r"""
+        Remove an index that is managed by ourselves.
+        This will flush all pending work on that index, and then shut
+        down its managing thread, and will remove the index.
+        """
+        return _swigfaiss_avx2.ThreadedIndexBaseBinary_removeIndex(self, index)
+
+    def runOnIndex(self, *args):
+        return _swigfaiss_avx2.ThreadedIndexBaseBinary_runOnIndex(self, *args)
+
+    def reset(self):
+        r"""
+        faiss::Index API
+        All indices receive the same call
+        """
+        return _swigfaiss_avx2.ThreadedIndexBaseBinary_reset(self)
+
+    def count(self):
+        r""" Returns the number of sub-indices"""
+        return _swigfaiss_avx2.ThreadedIndexBaseBinary_count(self)
+
+    def at(self, *args):
+        r"""
+        *Overload 1:*
+        Returns the i-th sub-index
+
+        |
+
+        *Overload 2:*
+        Returns the i-th sub-index (const version)
+        """
+        return _swigfaiss_avx2.ThreadedIndexBaseBinary_at(self, *args)
+    own_indices = property(_swigfaiss_avx2.ThreadedIndexBaseBinary_own_indices_get, _swigfaiss_avx2.ThreadedIndexBaseBinary_own_indices_set, doc=r""" Whether or not we are responsible for deleting our contained indices""")
+
+# Register ThreadedIndexBaseBinary in _swigfaiss_avx2:
+_swigfaiss_avx2.ThreadedIndexBaseBinary_swigregister(ThreadedIndexBaseBinary)
+class IndexShards(ThreadedIndexBase):
+    r"""Index that concatenates the results from several sub-indexes"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+
+        The dimension that all sub-indices must share will be the dimension of
+        the first sub-index added
+
+        :type threaded: boolean, optional
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :type successive_ids: boolean, optional
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 2:*
+
+        :type threaded: boolean, optional
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :type successive_ids: boolean, optional
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 3:*
+
+        :type threaded: boolean, optional
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 4:*
+
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 5:*
+         int version due to the implicit bool conversion ambiguity of int as
+         dimension
+
+        |
+
+        *Overload 6:*
+         int version due to the implicit bool conversion ambiguity of int as
+         dimension
+
+        |
+
+        *Overload 7:*
+         int version due to the implicit bool conversion ambiguity of int as
+         dimension
+        """
+        _swigfaiss_avx2.IndexShards_swiginit(self, _swigfaiss_avx2.new_IndexShards(*args))
+
+    def add_shard(self, index):
+        r""" Alias for addIndex()"""
+        return _swigfaiss_avx2.IndexShards_add_shard(self, index)
+
+    def remove_shard(self, index):
+        r""" Alias for removeIndex()"""
+        return _swigfaiss_avx2.IndexShards_remove_shard(self, index)
+
+    def add(self, n, x):
+        r""" supported only for sub-indices that implement add_with_ids"""
+        return _swigfaiss_avx2.IndexShards_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        r"""
+        Cases (successive_ids, xids):
+        - true, non-NULL       ERROR: it makes no sense to pass in ids and
+                               request them to be shifted
+        - true, NULL           OK: but should be called only once (calls add()
+                               on sub-indexes).
+        - false, non-NULL      OK: will call add_with_ids with passed in xids
+                               distributed evenly over shards
+        - false, NULL          OK: will call add_with_ids on each sub-index,
+                               starting at ntotal
+        """
+        return _swigfaiss_avx2.IndexShards_add_with_ids(self, n, x, xids)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexShards_search(self, n, x, k, distances, labels, params)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexShards_train(self, n, x)
+    successive_ids = property(_swigfaiss_avx2.IndexShards_successive_ids_get, _swigfaiss_avx2.IndexShards_successive_ids_set)
+
+    def syncWithSubIndexes(self):
+        r"""
+        Synchronize the top-level index (IndexShards) with data in the
+        sub-indices
+        """
+        return _swigfaiss_avx2.IndexShards_syncWithSubIndexes(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexShards
+
+# Register IndexShards in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexShards_swigregister(IndexShards)
+class IndexBinaryShards(ThreadedIndexBaseBinary):
+    r"""Index that concatenates the results from several sub-indexes"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+
+        The dimension that all sub-indices must share will be the dimension of
+        the first sub-index added
+
+        :type threaded: boolean, optional
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :type successive_ids: boolean, optional
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 2:*
+
+        :type threaded: boolean, optional
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :type successive_ids: boolean, optional
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 3:*
+
+        :type threaded: boolean, optional
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 4:*
+
+        :param threaded:     do we use one thread per sub_index or do
+                                queries sequentially?
+        :param successive_ids: should we shift the returned ids by
+                                the size of each sub-index or return them
+                                as they are?
+
+        |
+
+        *Overload 5:*
+         int version due to the implicit bool conversion ambiguity of int as
+         dimension
+
+        |
+
+        *Overload 6:*
+         int version due to the implicit bool conversion ambiguity of int as
+         dimension
+
+        |
+
+        *Overload 7:*
+         int version due to the implicit bool conversion ambiguity of int as
+         dimension
+        """
+        _swigfaiss_avx2.IndexBinaryShards_swiginit(self, _swigfaiss_avx2.new_IndexBinaryShards(*args))
+
+    def add_shard(self, index):
+        r""" Alias for addIndex()"""
+        return _swigfaiss_avx2.IndexBinaryShards_add_shard(self, index)
+
+    def remove_shard(self, index):
+        r""" Alias for removeIndex()"""
+        return _swigfaiss_avx2.IndexBinaryShards_remove_shard(self, index)
+
+    def add(self, n, x):
+        r""" supported only for sub-indices that implement add_with_ids"""
+        return _swigfaiss_avx2.IndexBinaryShards_add(self, n, x)
+
+    def add_with_ids(self, n, x, xids):
+        r"""
+        Cases (successive_ids, xids):
+        - true, non-NULL       ERROR: it makes no sense to pass in ids and
+                               request them to be shifted
+        - true, NULL           OK: but should be called only once (calls add()
+                               on sub-indexes).
+        - false, non-NULL      OK: will call add_with_ids with passed in xids
+                               distributed evenly over shards
+        - false, NULL          OK: will call add_with_ids on each sub-index,
+                               starting at ntotal
+        """
+        return _swigfaiss_avx2.IndexBinaryShards_add_with_ids(self, n, x, xids)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexBinaryShards_search(self, n, x, k, distances, labels, params)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexBinaryShards_train(self, n, x)
+    successive_ids = property(_swigfaiss_avx2.IndexBinaryShards_successive_ids_get, _swigfaiss_avx2.IndexBinaryShards_successive_ids_set)
+
+    def syncWithSubIndexes(self):
+        r"""
+        Synchronize the top-level index (IndexShards) with data in the
+        sub-indices
+        """
+        return _swigfaiss_avx2.IndexBinaryShards_syncWithSubIndexes(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexBinaryShards
+
+# Register IndexBinaryShards in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexBinaryShards_swigregister(IndexBinaryShards)
+class IndexShardsIVF(IndexShards, Level1Quantizer):
+    r"""
+    IndexShards with a common coarse quantizer. All the indexes added should be
+    IndexIVFInterface indexes so that the search_precomputed can be called.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, quantizer, nlist, threaded=False, successive_ids=True):
+        _swigfaiss_avx2.IndexShardsIVF_swiginit(self, _swigfaiss_avx2.new_IndexShardsIVF(quantizer, nlist, threaded, successive_ids))
+
+    def addIndex(self, index):
+        return _swigfaiss_avx2.IndexShardsIVF_addIndex(self, index)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss_avx2.IndexShardsIVF_add_with_ids(self, n, x, xids)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexShardsIVF_train(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexShardsIVF_search(self, n, x, k, distances, labels, params)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexShardsIVF
+
+# Register IndexShardsIVF in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexShardsIVF_swigregister(IndexShardsIVF)
+class IndexReplicas(ThreadedIndexBase):
+    r"""
+    Takes individual faiss::Index instances, and splits queries for
+    sending to each Index instance, and joins the results together
+    when done.
+    Each index is managed by a separate CPU thread.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+        The dimension that all sub-indices must share will be the dimension of
+        the first sub-index added
+        :type threaded: boolean, optional
+        :param threaded: do we use one thread per sub-index or do queries
+            sequentially?
+
+        |
+
+        *Overload 2:*
+        :type d: int
+        :param d: the dimension that all sub-indices must share
+        :type threaded: boolean, optional
+        :param threaded: do we use one thread per sub index or do queries
+            sequentially?
+
+        |
+
+        *Overload 3:*
+        :type d: int
+        :param d: the dimension that all sub-indices must share
+        :param threaded: do we use one thread per sub index or do queries
+            sequentially?
+
+        |
+
+        *Overload 4:*
+        int version due to the implicit bool conversion ambiguity of int as
+        dimension
+
+        |
+
+        *Overload 5:*
+        int version due to the implicit bool conversion ambiguity of int as
+        dimension
+        """
+        _swigfaiss_avx2.IndexReplicas_swiginit(self, _swigfaiss_avx2.new_IndexReplicas(*args))
+
+    def add_replica(self, index):
+        r""" Alias for addIndex()"""
+        return _swigfaiss_avx2.IndexReplicas_add_replica(self, index)
+
+    def remove_replica(self, index):
+        r""" Alias for removeIndex()"""
+        return _swigfaiss_avx2.IndexReplicas_remove_replica(self, index)
+
+    def train(self, n, x):
+        r"""
+        faiss::Index API
+        All indices receive the same call
+        """
+        return _swigfaiss_avx2.IndexReplicas_train(self, n, x)
+
+    def add(self, n, x):
+        r"""
+        faiss::Index API
+        All indices receive the same call
+        """
+        return _swigfaiss_avx2.IndexReplicas_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r"""
+        faiss::Index API
+        Query is partitioned into a slice for each sub-index
+        split by ceil(n / #indices) for our sub-indices
+        """
+        return _swigfaiss_avx2.IndexReplicas_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, arg2, v):
+        r""" reconstructs from the first index"""
+        return _swigfaiss_avx2.IndexReplicas_reconstruct(self, arg2, v)
+
+    def syncWithSubIndexes(self):
+        r"""
+        Synchronize the top-level index (IndexShards) with data in the
+        sub-indices
+        """
+        return _swigfaiss_avx2.IndexReplicas_syncWithSubIndexes(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexReplicas
+
+# Register IndexReplicas in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexReplicas_swigregister(IndexReplicas)
+class IndexBinaryReplicas(ThreadedIndexBaseBinary):
+    r"""
+    Takes individual faiss::Index instances, and splits queries for
+    sending to each Index instance, and joins the results together
+    when done.
+    Each index is managed by a separate CPU thread.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        r"""
+        *Overload 1:*
+        The dimension that all sub-indices must share will be the dimension of
+        the first sub-index added
+        :type threaded: boolean, optional
+        :param threaded: do we use one thread per sub-index or do queries
+            sequentially?
+
+        |
+
+        *Overload 2:*
+        :type d: int
+        :param d: the dimension that all sub-indices must share
+        :type threaded: boolean, optional
+        :param threaded: do we use one thread per sub index or do queries
+            sequentially?
+
+        |
+
+        *Overload 3:*
+        :type d: int
+        :param d: the dimension that all sub-indices must share
+        :param threaded: do we use one thread per sub index or do queries
+            sequentially?
+
+        |
+
+        *Overload 4:*
+        int version due to the implicit bool conversion ambiguity of int as
+        dimension
+
+        |
+
+        *Overload 5:*
+        int version due to the implicit bool conversion ambiguity of int as
+        dimension
+        """
+        _swigfaiss_avx2.IndexBinaryReplicas_swiginit(self, _swigfaiss_avx2.new_IndexBinaryReplicas(*args))
+
+    def add_replica(self, index):
+        r""" Alias for addIndex()"""
+        return _swigfaiss_avx2.IndexBinaryReplicas_add_replica(self, index)
+
+    def remove_replica(self, index):
+        r""" Alias for removeIndex()"""
+        return _swigfaiss_avx2.IndexBinaryReplicas_remove_replica(self, index)
+
+    def train(self, n, x):
+        r"""
+        faiss::Index API
+        All indices receive the same call
+        """
+        return _swigfaiss_avx2.IndexBinaryReplicas_train(self, n, x)
+
+    def add(self, n, x):
+        r"""
+        faiss::Index API
+        All indices receive the same call
+        """
+        return _swigfaiss_avx2.IndexBinaryReplicas_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        r"""
+        faiss::Index API
+        Query is partitioned into a slice for each sub-index
+        split by ceil(n / #indices) for our sub-indices
+        """
+        return _swigfaiss_avx2.IndexBinaryReplicas_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, arg2, v):
+        r""" reconstructs from the first index"""
+        return _swigfaiss_avx2.IndexBinaryReplicas_reconstruct(self, arg2, v)
+
+    def syncWithSubIndexes(self):
+        r"""
+        Synchronize the top-level index (IndexShards) with data in the
+        sub-indices
+        """
+        return _swigfaiss_avx2.IndexBinaryReplicas_syncWithSubIndexes(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexBinaryReplicas
+
+# Register IndexBinaryReplicas in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexBinaryReplicas_swigregister(IndexBinaryReplicas)
+class IndexSplitVectors(Index):
+    r"""
+     splits input vectors in segments and assigns each segment to a sub-index
+    used to distribute a MultiIndexQuantizer
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    own_fields = property(_swigfaiss_avx2.IndexSplitVectors_own_fields_get, _swigfaiss_avx2.IndexSplitVectors_own_fields_set)
+    threaded = property(_swigfaiss_avx2.IndexSplitVectors_threaded_get, _swigfaiss_avx2.IndexSplitVectors_threaded_set)
+    sub_indexes = property(_swigfaiss_avx2.IndexSplitVectors_sub_indexes_get, _swigfaiss_avx2.IndexSplitVectors_sub_indexes_set)
+    sum_d = property(_swigfaiss_avx2.IndexSplitVectors_sum_d_get, _swigfaiss_avx2.IndexSplitVectors_sum_d_set)
+
+    def __init__(self, d, threaded=False):
+        r""" sum of dimensions seen so far"""
+        _swigfaiss_avx2.IndexSplitVectors_swiginit(self, _swigfaiss_avx2.new_IndexSplitVectors(d, threaded))
+
+    def add_sub_index(self, arg2):
+        return _swigfaiss_avx2.IndexSplitVectors_add_sub_index(self, arg2)
+
+    def sync_with_sub_indexes(self):
+        return _swigfaiss_avx2.IndexSplitVectors_sync_with_sub_indexes(self)
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexSplitVectors_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexSplitVectors_search(self, n, x, k, distances, labels, params)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexSplitVectors_train(self, n, x)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexSplitVectors_reset(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexSplitVectors
+
+# Register IndexSplitVectors in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexSplitVectors_swigregister(IndexSplitVectors)
+class IndexRandom(Index):
+    r"""
+     index that returns random results.
+    used mainly for time benchmarks
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    seed = property(_swigfaiss_avx2.IndexRandom_seed_get, _swigfaiss_avx2.IndexRandom_seed_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexRandom_swiginit(self, _swigfaiss_avx2.new_IndexRandom(*args))
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexRandom_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexRandom_search(self, n, x, k, distances, labels, params)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexRandom_reconstruct(self, key, recons)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexRandom_reset(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexRandom
+
+# Register IndexRandom in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexRandom_swigregister(IndexRandom)
+class IndexRowwiseMinMaxBase(Index):
+    r"""
+     Index wrapper that performs rowwise normalization to [0,1], preserving
+     the coefficients. This is a vector codec index only.
+
+     Basically, this index performs a rowwise scaling to [0,1] of every row
+     in an input dataset before calling subindex::train() and
+     subindex::sa_encode(). sa_encode() call stores the scaling coefficients
+      (scaler and minv) in the very beginning of every output code. The format:
+         [scaler][minv][subindex::sa_encode() output]
+     The de-scaling in sa_decode() is done using:
+         output_rescaled = scaler * output + minv
+
+     An additional ::train_inplace() function is provided in order to do
+     an inplace scaling before calling subindex::train() and, thus, avoiding
+     the cloning of the input dataset, but modifying the input dataset because
+     of the scaling and the scaling back. It is up to user to call
+     this function instead of ::train()
+
+     Derived classes provide different data types for scaling coefficients.
+     Currently, versions with fp16 and fp32 scaling coefficients are available.
+    fp16 version adds 4 extra bytes per encoded vector
+    fp32 version adds 8 extra bytes per encoded vector
+     Provides base functions for rowwise normalizing indices.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    index = property(_swigfaiss_avx2.IndexRowwiseMinMaxBase_index_get, _swigfaiss_avx2.IndexRowwiseMinMaxBase_index_set, doc=r""" sub-index""")
+    own_fields = property(_swigfaiss_avx2.IndexRowwiseMinMaxBase_own_fields_get, _swigfaiss_avx2.IndexRowwiseMinMaxBase_own_fields_set, doc=r""" whether the subindex needs to be freed in the destructor.""")
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexRowwiseMinMaxBase
+
+    def add(self, n, x):
+        return _swigfaiss_avx2.IndexRowwiseMinMaxBase_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexRowwiseMinMaxBase_search(self, n, x, k, distances, labels, params)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexRowwiseMinMaxBase_reset(self)
+
+    def train_inplace(self, n, x):
+        return _swigfaiss_avx2.IndexRowwiseMinMaxBase_train_inplace(self, n, x)
+
+# Register IndexRowwiseMinMaxBase in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexRowwiseMinMaxBase_swigregister(IndexRowwiseMinMaxBase)
+class IndexRowwiseMinMaxFP16(IndexRowwiseMinMaxBase):
+    r""" Stores scaling coefficients as fp16 values."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexRowwiseMinMaxFP16_swiginit(self, _swigfaiss_avx2.new_IndexRowwiseMinMaxFP16(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexRowwiseMinMaxFP16_train(self, n, x)
+
+    def train_inplace(self, n, x):
+        return _swigfaiss_avx2.IndexRowwiseMinMaxFP16_train_inplace(self, n, x)
+
+    def sa_code_size(self):
+        return _swigfaiss_avx2.IndexRowwiseMinMaxFP16_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss_avx2.IndexRowwiseMinMaxFP16_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexRowwiseMinMaxFP16_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexRowwiseMinMaxFP16
+
+# Register IndexRowwiseMinMaxFP16 in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexRowwiseMinMaxFP16_swigregister(IndexRowwiseMinMaxFP16)
+class IndexRowwiseMinMax(IndexRowwiseMinMaxBase):
+    r""" Stores scaling coefficients as fp32 values."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexRowwiseMinMax_swiginit(self, _swigfaiss_avx2.new_IndexRowwiseMinMax(*args))
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexRowwiseMinMax_train(self, n, x)
+
+    def train_inplace(self, n, x):
+        return _swigfaiss_avx2.IndexRowwiseMinMax_train_inplace(self, n, x)
+
+    def sa_code_size(self):
+        return _swigfaiss_avx2.IndexRowwiseMinMax_sa_code_size(self)
+
+    def sa_encode(self, n, x, bytes):
+        return _swigfaiss_avx2.IndexRowwiseMinMax_sa_encode(self, n, x, bytes)
+
+    def sa_decode(self, n, bytes, x):
+        return _swigfaiss_avx2.IndexRowwiseMinMax_sa_decode(self, n, bytes, x)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexRowwiseMinMax
+
+# Register IndexRowwiseMinMax in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexRowwiseMinMax_swigregister(IndexRowwiseMinMax)
+class RangeSearchResult(object):
+    r"""
+    The objective is to have a simple result structure while
+    minimizing the number of mem copies in the result. The method
+    do_allocation can be overloaded to allocate the result tables in
+    the matrix type of a scripting language like Lua or Python.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss_avx2.RangeSearchResult_nq_get, _swigfaiss_avx2.RangeSearchResult_nq_set, doc=r""" nb of queries""")
+    lims = property(_swigfaiss_avx2.RangeSearchResult_lims_get, _swigfaiss_avx2.RangeSearchResult_lims_set, doc=r""" size (nq + 1)""")
+    labels = property(_swigfaiss_avx2.RangeSearchResult_labels_get, _swigfaiss_avx2.RangeSearchResult_labels_set, doc=r""" result for query i is labels[lims[i]:lims[i+1]]""")
+    distances = property(_swigfaiss_avx2.RangeSearchResult_distances_get, _swigfaiss_avx2.RangeSearchResult_distances_set, doc=r""" corresponding distances (not sorted)""")
+    buffer_size = property(_swigfaiss_avx2.RangeSearchResult_buffer_size_get, _swigfaiss_avx2.RangeSearchResult_buffer_size_set, doc=r""" size of the result buffers used""")
+
+    def __init__(self, nq, alloc_lims=True):
+        r""" lims must be allocated on input to range_search."""
+        _swigfaiss_avx2.RangeSearchResult_swiginit(self, _swigfaiss_avx2.new_RangeSearchResult(nq, alloc_lims))
+
+    def do_allocation(self):
+        r"""
+        called when lims contains the nb of elements result entries
+        for each query
+        """
+        return _swigfaiss_avx2.RangeSearchResult_do_allocation(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_RangeSearchResult
+
+# Register RangeSearchResult in _swigfaiss_avx2:
+_swigfaiss_avx2.RangeSearchResult_swigregister(RangeSearchResult)
+class BufferList(object):
+    r"""
+    List of temporary buffers used to store results before they are
+    copied to the RangeSearchResult object.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    buffer_size = property(_swigfaiss_avx2.BufferList_buffer_size_get, _swigfaiss_avx2.BufferList_buffer_size_set)
+    buffers = property(_swigfaiss_avx2.BufferList_buffers_get, _swigfaiss_avx2.BufferList_buffers_set)
+    wp = property(_swigfaiss_avx2.BufferList_wp_get, _swigfaiss_avx2.BufferList_wp_set, doc=r""" write pointer in the last buffer.""")
+
+    def __init__(self, buffer_size):
+        _swigfaiss_avx2.BufferList_swiginit(self, _swigfaiss_avx2.new_BufferList(buffer_size))
+    __swig_destroy__ = _swigfaiss_avx2.delete_BufferList
+
+    def append_buffer(self):
+        r""" create a new buffer"""
+        return _swigfaiss_avx2.BufferList_append_buffer(self)
+
+    def add(self, id, dis):
+        r""" add one result, possibly appending a new buffer if needed"""
+        return _swigfaiss_avx2.BufferList_add(self, id, dis)
+
+    def copy_range(self, ofs, n, dest_ids, dest_dis):
+        r"""
+        copy elemnts ofs:ofs+n-1 seen as linear data in the buffers to
+        tables dest_ids, dest_dis
+        """
+        return _swigfaiss_avx2.BufferList_copy_range(self, ofs, n, dest_ids, dest_dis)
+
+# Register BufferList in _swigfaiss_avx2:
+_swigfaiss_avx2.BufferList_swigregister(BufferList)
+class RangeQueryResult(object):
+    r""" result structure for a single query"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    qno = property(_swigfaiss_avx2.RangeQueryResult_qno_get, _swigfaiss_avx2.RangeQueryResult_qno_set)
+    nres = property(_swigfaiss_avx2.RangeQueryResult_nres_get, _swigfaiss_avx2.RangeQueryResult_nres_set)
+    pres = property(_swigfaiss_avx2.RangeQueryResult_pres_get, _swigfaiss_avx2.RangeQueryResult_pres_set)
+
+    def add(self, dis, id):
+        r""" called by search function to report a new result"""
+        return _swigfaiss_avx2.RangeQueryResult_add(self, dis, id)
+
+    def __init__(self):
+        _swigfaiss_avx2.RangeQueryResult_swiginit(self, _swigfaiss_avx2.new_RangeQueryResult())
+    __swig_destroy__ = _swigfaiss_avx2.delete_RangeQueryResult
+
+# Register RangeQueryResult in _swigfaiss_avx2:
+_swigfaiss_avx2.RangeQueryResult_swigregister(RangeQueryResult)
+class RangeSearchPartialResult(BufferList):
+    r""" the entries in the buffers are split per query"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    res = property(_swigfaiss_avx2.RangeSearchPartialResult_res_get, _swigfaiss_avx2.RangeSearchPartialResult_res_set)
+
+    def __init__(self, res_in):
+        r""" eventually the result will be stored in res_in"""
+        _swigfaiss_avx2.RangeSearchPartialResult_swiginit(self, _swigfaiss_avx2.new_RangeSearchPartialResult(res_in))
+    queries = property(_swigfaiss_avx2.RangeSearchPartialResult_queries_get, _swigfaiss_avx2.RangeSearchPartialResult_queries_set, doc=r""" query ids + nb of results per query.""")
+
+    def new_result(self, qno):
+        r""" begin a new result"""
+        return _swigfaiss_avx2.RangeSearchPartialResult_new_result(self, qno)
+
+    def finalize(self):
+        return _swigfaiss_avx2.RangeSearchPartialResult_finalize(self)
+
+    def set_lims(self):
+        r""" called by range_search before do_allocation"""
+        return _swigfaiss_avx2.RangeSearchPartialResult_set_lims(self)
+
+    def copy_result(self, incremental=False):
+        r""" called by range_search after do_allocation"""
+        return _swigfaiss_avx2.RangeSearchPartialResult_copy_result(self, incremental)
+
+    @staticmethod
+    def merge(partial_results, do_delete=True):
+        r"""
+        merge a set of PartialResult's into one RangeSearchResult
+        on ouptut the partialresults are empty!
+        """
+        return _swigfaiss_avx2.RangeSearchPartialResult_merge(partial_results, do_delete)
+    __swig_destroy__ = _swigfaiss_avx2.delete_RangeSearchPartialResult
+
+# Register RangeSearchPartialResult in _swigfaiss_avx2:
+_swigfaiss_avx2.RangeSearchPartialResult_swigregister(RangeSearchPartialResult)
+class InterruptCallback(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+
+    def want_interrupt(self):
+        return _swigfaiss_avx2.InterruptCallback_want_interrupt(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_InterruptCallback
+
+    @staticmethod
+    def clear_instance():
+        return _swigfaiss_avx2.InterruptCallback_clear_instance()
+
+    @staticmethod
+    def check():
+        r"""
+         check if:
+        - an interrupt callback is set
+        - the callback returns true
+        if this is the case, then throw an exception. Should not be called
+        from multiple threads.
+        """
+        return _swigfaiss_avx2.InterruptCallback_check()
+
+    @staticmethod
+    def is_interrupted():
+        r"""
+        same as check() but return true if is interrupted instead of
+        throwing. Can be called from multiple threads.
+        """
+        return _swigfaiss_avx2.InterruptCallback_is_interrupted()
+
+    @staticmethod
+    def get_period_hint(flops):
+        r"""
+         assuming each iteration takes a certain number of flops, what
+        is a reasonable interval to check for interrupts?
+        """
+        return _swigfaiss_avx2.InterruptCallback_get_period_hint(flops)
+
+# Register InterruptCallback in _swigfaiss_avx2:
+_swigfaiss_avx2.InterruptCallback_swigregister(InterruptCallback)
+class VisitedTable(object):
+    r""" set implementation optimized for fast access."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    visited = property(_swigfaiss_avx2.VisitedTable_visited_get, _swigfaiss_avx2.VisitedTable_visited_set)
+    visno = property(_swigfaiss_avx2.VisitedTable_visno_get, _swigfaiss_avx2.VisitedTable_visno_set)
+
+    def __init__(self, size):
+        _swigfaiss_avx2.VisitedTable_swiginit(self, _swigfaiss_avx2.new_VisitedTable(size))
+
+    def set(self, no):
+        r""" set flag #no to true"""
+        return _swigfaiss_avx2.VisitedTable_set(self, no)
+
+    def get(self, no):
+        r""" get flag #no"""
+        return _swigfaiss_avx2.VisitedTable_get(self, no)
+
+    def advance(self):
+        r""" reset all flags to false"""
+        return _swigfaiss_avx2.VisitedTable_advance(self)
+    __swig_destroy__ = _swigfaiss_avx2.delete_VisitedTable
+
+# Register VisitedTable in _swigfaiss_avx2:
+_swigfaiss_avx2.VisitedTable_swigregister(VisitedTable)
+class IDSelector(object):
+    r""" Encapsulates a set of ids to handle."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+
+    def is_member(self, id):
+        return _swigfaiss_avx2.IDSelector_is_member(self, id)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IDSelector
+
+# Register IDSelector in _swigfaiss_avx2:
+_swigfaiss_avx2.IDSelector_swigregister(IDSelector)
+class IDSelectorRange(IDSelector):
+    r""" ids between [imin, imax)"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    imin = property(_swigfaiss_avx2.IDSelectorRange_imin_get, _swigfaiss_avx2.IDSelectorRange_imin_set)
+    imax = property(_swigfaiss_avx2.IDSelectorRange_imax_get, _swigfaiss_avx2.IDSelectorRange_imax_set)
+    assume_sorted = property(_swigfaiss_avx2.IDSelectorRange_assume_sorted_get, _swigfaiss_avx2.IDSelectorRange_assume_sorted_set, doc=r"""
+    Assume that the ids to handle are sorted. In some cases this can speed
+    up processing
+    """)
+
+    def __init__(self, imin, imax, assume_sorted=False):
+        _swigfaiss_avx2.IDSelectorRange_swiginit(self, _swigfaiss_avx2.new_IDSelectorRange(imin, imax, assume_sorted))
+
+    def is_member(self, id):
+        return _swigfaiss_avx2.IDSelectorRange_is_member(self, id)
+
+    def find_sorted_ids_bounds(self, list_size, ids, jmin, jmax):
+        r"""
+        for sorted ids, find the range of list indices where the valid ids are
+        stored
+        """
+        return _swigfaiss_avx2.IDSelectorRange_find_sorted_ids_bounds(self, list_size, ids, jmin, jmax)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IDSelectorRange
+
+# Register IDSelectorRange in _swigfaiss_avx2:
+_swigfaiss_avx2.IDSelectorRange_swigregister(IDSelectorRange)
+class IDSelectorArray(IDSelector):
+    r"""
+     Simple array of elements
+
+    is_member calls are very inefficient, but some operations can use the ids
+    directly.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    n = property(_swigfaiss_avx2.IDSelectorArray_n_get, _swigfaiss_avx2.IDSelectorArray_n_set)
+    ids = property(_swigfaiss_avx2.IDSelectorArray_ids_get, _swigfaiss_avx2.IDSelectorArray_ids_set)
+
+    def __init__(self, n, ids):
+        r"""
+         Construct with an array of ids to process
+
+        :type n: int
+        :param n: number of ids to store
+        :type ids: int
+        :param ids: elements to store. The pointer should remain valid during
+                       IDSelectorArray's lifetime
+        """
+        _swigfaiss_avx2.IDSelectorArray_swiginit(self, _swigfaiss_avx2.new_IDSelectorArray(n, ids))
+
+    def is_member(self, id):
+        return _swigfaiss_avx2.IDSelectorArray_is_member(self, id)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IDSelectorArray
+
+# Register IDSelectorArray in _swigfaiss_avx2:
+_swigfaiss_avx2.IDSelectorArray_swigregister(IDSelectorArray)
+class IDSelectorBatch(IDSelector):
+    r"""
+     Ids from a set.
+
+    Repetitions of ids in the indices set passed to the constructor does not hurt
+    performance.
+
+    The hash function used for the bloom filter and GCC's implementation of
+    unordered_set are just the least significant bits of the id. This works fine
+    for random ids or ids in sequences but will produce many hash collisions if
+    lsb's are always the same
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nbits = property(_swigfaiss_avx2.IDSelectorBatch_nbits_get, _swigfaiss_avx2.IDSelectorBatch_nbits_set)
+    mask = property(_swigfaiss_avx2.IDSelectorBatch_mask_get, _swigfaiss_avx2.IDSelectorBatch_mask_set)
+
+    def __init__(self, n, indices):
+        r"""
+         Construct with an array of ids to process
+
+        :type n: int
+        :param n: number of ids to store
+        :param ids: elements to store. The pointer can be released after
+                       construction
+        """
+        _swigfaiss_avx2.IDSelectorBatch_swiginit(self, _swigfaiss_avx2.new_IDSelectorBatch(n, indices))
+
+    def is_member(self, id):
+        return _swigfaiss_avx2.IDSelectorBatch_is_member(self, id)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IDSelectorBatch
+
+# Register IDSelectorBatch in _swigfaiss_avx2:
+_swigfaiss_avx2.IDSelectorBatch_swigregister(IDSelectorBatch)
+class IDSelectorBitmap(IDSelector):
+    r""" One bit per element. Constructed with a bitmap, size ceil(n / 8)."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    n = property(_swigfaiss_avx2.IDSelectorBitmap_n_get, _swigfaiss_avx2.IDSelectorBitmap_n_set)
+    bitmap = property(_swigfaiss_avx2.IDSelectorBitmap_bitmap_get, _swigfaiss_avx2.IDSelectorBitmap_bitmap_set)
+
+    def __init__(self, n, bitmap):
+        r"""
+         Construct with a binary mask
+
+        :type n: int
+        :param n: size of the bitmap array
+        :type bitmap: uint8_t
+        :param bitmap: id will be selected iff id / 8 < n and bit number
+                          (i%8) of bitmap[floor(i / 8)] is 1.
+        """
+        _swigfaiss_avx2.IDSelectorBitmap_swiginit(self, _swigfaiss_avx2.new_IDSelectorBitmap(n, bitmap))
+
+    def is_member(self, id):
+        return _swigfaiss_avx2.IDSelectorBitmap_is_member(self, id)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IDSelectorBitmap
+
+# Register IDSelectorBitmap in _swigfaiss_avx2:
+_swigfaiss_avx2.IDSelectorBitmap_swigregister(IDSelectorBitmap)
+class IDSelectorNot(IDSelector):
+    r""" reverts the membership test of another selector"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    sel = property(_swigfaiss_avx2.IDSelectorNot_sel_get, _swigfaiss_avx2.IDSelectorNot_sel_set)
+
+    def __init__(self, sel):
+        _swigfaiss_avx2.IDSelectorNot_swiginit(self, _swigfaiss_avx2.new_IDSelectorNot(sel))
+
+    def is_member(self, id):
+        return _swigfaiss_avx2.IDSelectorNot_is_member(self, id)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IDSelectorNot
+
+# Register IDSelectorNot in _swigfaiss_avx2:
+_swigfaiss_avx2.IDSelectorNot_swigregister(IDSelectorNot)
+class IDSelectorAll(IDSelector):
+    r""" selects all entries (useful for benchmarking)"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def is_member(self, id):
+        return _swigfaiss_avx2.IDSelectorAll_is_member(self, id)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IDSelectorAll
+
+    def __init__(self):
+        _swigfaiss_avx2.IDSelectorAll_swiginit(self, _swigfaiss_avx2.new_IDSelectorAll())
+
+# Register IDSelectorAll in _swigfaiss_avx2:
+_swigfaiss_avx2.IDSelectorAll_swigregister(IDSelectorAll)
+class IDSelectorAnd(IDSelector):
+    r"""
+    does an AND operation on the the two given IDSelector's is_membership
+    results.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lhs = property(_swigfaiss_avx2.IDSelectorAnd_lhs_get, _swigfaiss_avx2.IDSelectorAnd_lhs_set)
+    rhs = property(_swigfaiss_avx2.IDSelectorAnd_rhs_get, _swigfaiss_avx2.IDSelectorAnd_rhs_set)
+
+    def __init__(self, lhs, rhs):
+        _swigfaiss_avx2.IDSelectorAnd_swiginit(self, _swigfaiss_avx2.new_IDSelectorAnd(lhs, rhs))
+
+    def is_member(self, id):
+        return _swigfaiss_avx2.IDSelectorAnd_is_member(self, id)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IDSelectorAnd
+
+# Register IDSelectorAnd in _swigfaiss_avx2:
+_swigfaiss_avx2.IDSelectorAnd_swigregister(IDSelectorAnd)
+class IDSelectorOr(IDSelector):
+    r"""
+    does an OR operation on the the two given IDSelector's is_membership
+    results.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lhs = property(_swigfaiss_avx2.IDSelectorOr_lhs_get, _swigfaiss_avx2.IDSelectorOr_lhs_set)
+    rhs = property(_swigfaiss_avx2.IDSelectorOr_rhs_get, _swigfaiss_avx2.IDSelectorOr_rhs_set)
+
+    def __init__(self, lhs, rhs):
+        _swigfaiss_avx2.IDSelectorOr_swiginit(self, _swigfaiss_avx2.new_IDSelectorOr(lhs, rhs))
+
+    def is_member(self, id):
+        return _swigfaiss_avx2.IDSelectorOr_is_member(self, id)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IDSelectorOr
+
+# Register IDSelectorOr in _swigfaiss_avx2:
+_swigfaiss_avx2.IDSelectorOr_swigregister(IDSelectorOr)
+class IDSelectorXOr(IDSelector):
+    r"""
+    does an XOR operation on the the two given IDSelector's is_membership
+    results.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    lhs = property(_swigfaiss_avx2.IDSelectorXOr_lhs_get, _swigfaiss_avx2.IDSelectorXOr_lhs_set)
+    rhs = property(_swigfaiss_avx2.IDSelectorXOr_rhs_get, _swigfaiss_avx2.IDSelectorXOr_rhs_set)
+
+    def __init__(self, lhs, rhs):
+        _swigfaiss_avx2.IDSelectorXOr_swiginit(self, _swigfaiss_avx2.new_IDSelectorXOr(lhs, rhs))
+
+    def is_member(self, id):
+        return _swigfaiss_avx2.IDSelectorXOr_is_member(self, id)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IDSelectorXOr
+
+# Register IDSelectorXOr in _swigfaiss_avx2:
+_swigfaiss_avx2.IDSelectorXOr_swigregister(IDSelectorXOr)
+class IDSelectorTranslated(IDSelector):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    id_map = property(_swigfaiss_avx2.IDSelectorTranslated_id_map_get)
+    sel = property(_swigfaiss_avx2.IDSelectorTranslated_sel_get, _swigfaiss_avx2.IDSelectorTranslated_sel_set)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IDSelectorTranslated_swiginit(self, _swigfaiss_avx2.new_IDSelectorTranslated(*args))
+
+    def is_member(self, id):
+        return _swigfaiss_avx2.IDSelectorTranslated_is_member(self, id)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IDSelectorTranslated
+
+# Register IDSelectorTranslated in _swigfaiss_avx2:
+_swigfaiss_avx2.IDSelectorTranslated_swigregister(IDSelectorTranslated)
+class IndexIDMap(Index):
+    r""" Index that translates search results to ids"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    index = property(_swigfaiss_avx2.IndexIDMap_index_get, _swigfaiss_avx2.IndexIDMap_index_set)
+    own_fields = property(_swigfaiss_avx2.IndexIDMap_own_fields_get, _swigfaiss_avx2.IndexIDMap_own_fields_set, doc=r"""the sub-index""")
+    id_map = property(_swigfaiss_avx2.IndexIDMap_id_map_get, _swigfaiss_avx2.IndexIDMap_id_map_set, doc=r"""whether pointers are deleted in destructo""")
+
+    def add_with_ids(self, n, x, xids):
+        r"""
+        :type xids: int
+        :param xids: if non-null, ids to store for the vectors (size n)
+        """
+        return _swigfaiss_avx2.IndexIDMap_add_with_ids(self, n, x, xids)
+
+    def add(self, n, x):
+        r""" this will fail. Use add_with_ids"""
+        return _swigfaiss_avx2.IndexIDMap_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexIDMap_search(self, n, x, k, distances, labels, params)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexIDMap_train(self, n, x)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexIDMap_reset(self)
+
+    def remove_ids(self, sel):
+        r""" remove ids adapted to IndexFlat"""
+        return _swigfaiss_avx2.IndexIDMap_remove_ids(self, sel)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss_avx2.IndexIDMap_range_search(self, n, x, radius, result, params)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss_avx2.IndexIDMap_merge_from(self, otherIndex, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss_avx2.IndexIDMap_check_compatible_for_merge(self, otherIndex)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIDMap
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIDMap_swiginit(self, _swigfaiss_avx2.new_IndexIDMap(*args))
+
+# Register IndexIDMap in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIDMap_swigregister(IndexIDMap)
+class IndexBinaryIDMap(IndexBinary):
+    r""" Index that translates search results to ids"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    index = property(_swigfaiss_avx2.IndexBinaryIDMap_index_get, _swigfaiss_avx2.IndexBinaryIDMap_index_set)
+    own_fields = property(_swigfaiss_avx2.IndexBinaryIDMap_own_fields_get, _swigfaiss_avx2.IndexBinaryIDMap_own_fields_set, doc=r"""the sub-index""")
+    id_map = property(_swigfaiss_avx2.IndexBinaryIDMap_id_map_get, _swigfaiss_avx2.IndexBinaryIDMap_id_map_set, doc=r"""whether pointers are deleted in destructo""")
+
+    def add_with_ids(self, n, x, xids):
+        r"""
+        :type xids: int
+        :param xids: if non-null, ids to store for the vectors (size n)
+        """
+        return _swigfaiss_avx2.IndexBinaryIDMap_add_with_ids(self, n, x, xids)
+
+    def add(self, n, x):
+        r""" this will fail. Use add_with_ids"""
+        return _swigfaiss_avx2.IndexBinaryIDMap_add(self, n, x)
+
+    def search(self, n, x, k, distances, labels, params=None):
+        return _swigfaiss_avx2.IndexBinaryIDMap_search(self, n, x, k, distances, labels, params)
+
+    def train(self, n, x):
+        return _swigfaiss_avx2.IndexBinaryIDMap_train(self, n, x)
+
+    def reset(self):
+        return _swigfaiss_avx2.IndexBinaryIDMap_reset(self)
+
+    def remove_ids(self, sel):
+        r""" remove ids adapted to IndexFlat"""
+        return _swigfaiss_avx2.IndexBinaryIDMap_remove_ids(self, sel)
+
+    def range_search(self, n, x, radius, result, params=None):
+        return _swigfaiss_avx2.IndexBinaryIDMap_range_search(self, n, x, radius, result, params)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss_avx2.IndexBinaryIDMap_merge_from(self, otherIndex, add_id)
+
+    def check_compatible_for_merge(self, otherIndex):
+        return _swigfaiss_avx2.IndexBinaryIDMap_check_compatible_for_merge(self, otherIndex)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexBinaryIDMap
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexBinaryIDMap_swiginit(self, _swigfaiss_avx2.new_IndexBinaryIDMap(*args))
+
+# Register IndexBinaryIDMap in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexBinaryIDMap_swigregister(IndexBinaryIDMap)
+class IndexIDMap2(IndexIDMap):
+    r"""
+    same as IndexIDMap but also provides an efficient reconstruction
+    implementation via a 2-way index
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rev_map = property(_swigfaiss_avx2.IndexIDMap2_rev_map_get, _swigfaiss_avx2.IndexIDMap2_rev_map_set)
+
+    def construct_rev_map(self):
+        r""" make the rev_map from scratch"""
+        return _swigfaiss_avx2.IndexIDMap2_construct_rev_map(self)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss_avx2.IndexIDMap2_add_with_ids(self, n, x, xids)
+
+    def remove_ids(self, sel):
+        return _swigfaiss_avx2.IndexIDMap2_remove_ids(self, sel)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexIDMap2_reconstruct(self, key, recons)
+
+    def check_consistency(self):
+        r""" check that the rev_map and the id_map are in sync"""
+        return _swigfaiss_avx2.IndexIDMap2_check_consistency(self)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss_avx2.IndexIDMap2_merge_from(self, otherIndex, add_id)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexIDMap2
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexIDMap2_swiginit(self, _swigfaiss_avx2.new_IndexIDMap2(*args))
+
+# Register IndexIDMap2 in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexIDMap2_swigregister(IndexIDMap2)
+class IndexBinaryIDMap2(IndexBinaryIDMap):
+    r"""
+    same as IndexIDMap but also provides an efficient reconstruction
+    implementation via a 2-way index
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    rev_map = property(_swigfaiss_avx2.IndexBinaryIDMap2_rev_map_get, _swigfaiss_avx2.IndexBinaryIDMap2_rev_map_set)
+
+    def construct_rev_map(self):
+        r""" make the rev_map from scratch"""
+        return _swigfaiss_avx2.IndexBinaryIDMap2_construct_rev_map(self)
+
+    def add_with_ids(self, n, x, xids):
+        return _swigfaiss_avx2.IndexBinaryIDMap2_add_with_ids(self, n, x, xids)
+
+    def remove_ids(self, sel):
+        return _swigfaiss_avx2.IndexBinaryIDMap2_remove_ids(self, sel)
+
+    def reconstruct(self, key, recons):
+        return _swigfaiss_avx2.IndexBinaryIDMap2_reconstruct(self, key, recons)
+
+    def check_consistency(self):
+        r""" check that the rev_map and the id_map are in sync"""
+        return _swigfaiss_avx2.IndexBinaryIDMap2_check_consistency(self)
+
+    def merge_from(self, otherIndex, add_id=0):
+        return _swigfaiss_avx2.IndexBinaryIDMap2_merge_from(self, otherIndex, add_id)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IndexBinaryIDMap2
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.IndexBinaryIDMap2_swiginit(self, _swigfaiss_avx2.new_IndexBinaryIDMap2(*args))
+
+# Register IndexBinaryIDMap2 in _swigfaiss_avx2:
+_swigfaiss_avx2.IndexBinaryIDMap2_swigregister(IndexBinaryIDMap2)
+EXACT_TOPK = _swigfaiss_avx2.EXACT_TOPK
+APPROX_TOPK_BUCKETS_B32_D2 = _swigfaiss_avx2.APPROX_TOPK_BUCKETS_B32_D2
+APPROX_TOPK_BUCKETS_B8_D3 = _swigfaiss_avx2.APPROX_TOPK_BUCKETS_B8_D3
+APPROX_TOPK_BUCKETS_B16_D2 = _swigfaiss_avx2.APPROX_TOPK_BUCKETS_B16_D2
+APPROX_TOPK_BUCKETS_B8_D2 = _swigfaiss_avx2.APPROX_TOPK_BUCKETS_B8_D2
+
+def downcast_index(index):
+    return _swigfaiss_avx2.downcast_index(index)
+
+def downcast_VectorTransform(vt):
+    return _swigfaiss_avx2.downcast_VectorTransform(vt)
+
+def downcast_IndexBinary(index):
+    return _swigfaiss_avx2.downcast_IndexBinary(index)
+
+def downcast_InvertedLists(il):
+    return _swigfaiss_avx2.downcast_InvertedLists(il)
+
+def downcast_AdditiveQuantizer(aq):
+    return _swigfaiss_avx2.downcast_AdditiveQuantizer(aq)
+
+def downcast_Quantizer(aq):
+    return _swigfaiss_avx2.downcast_Quantizer(aq)
+
+def write_index(*args):
+    return _swigfaiss_avx2.write_index(*args)
+
+def write_index_binary(*args):
+    return _swigfaiss_avx2.write_index_binary(*args)
+
+def read_index(*args):
+    return _swigfaiss_avx2.read_index(*args)
+
+def read_index_binary(*args):
+    return _swigfaiss_avx2.read_index_binary(*args)
+
+def write_VectorTransform(*args):
+    return _swigfaiss_avx2.write_VectorTransform(*args)
+
+def read_VectorTransform(*args):
+    return _swigfaiss_avx2.read_VectorTransform(*args)
+
+def read_ProductQuantizer(*args):
+    return _swigfaiss_avx2.read_ProductQuantizer(*args)
+
+def write_ProductQuantizer(*args):
+    return _swigfaiss_avx2.write_ProductQuantizer(*args)
+
+def write_InvertedLists(ils, f):
+    return _swigfaiss_avx2.write_InvertedLists(ils, f)
+
+def read_InvertedLists(reader, io_flags=0):
+    return _swigfaiss_avx2.read_InvertedLists(reader, io_flags)
+
+def clone_index(arg1):
+    return _swigfaiss_avx2.clone_index(arg1)
+class Cloner(object):
+    r"""
+     Cloner class, useful to override classes with other cloning
+    functions. The cloning function above just calls
+    Cloner::clone_Index.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def clone_VectorTransform(self, arg2):
+        return _swigfaiss_avx2.Cloner_clone_VectorTransform(self, arg2)
+
+    def clone_Index(self, arg2):
+        return _swigfaiss_avx2.Cloner_clone_Index(self, arg2)
+
+    def clone_IndexIVF(self, arg2):
+        return _swigfaiss_avx2.Cloner_clone_IndexIVF(self, arg2)
+    __swig_destroy__ = _swigfaiss_avx2.delete_Cloner
+
+    def __init__(self):
+        _swigfaiss_avx2.Cloner_swiginit(self, _swigfaiss_avx2.new_Cloner())
+
+# Register Cloner in _swigfaiss_avx2:
+_swigfaiss_avx2.Cloner_swigregister(Cloner)
+IO_FLAG_READ_ONLY = cvar.IO_FLAG_READ_ONLY
+IO_FLAG_ONDISK_SAME_DIR = cvar.IO_FLAG_ONDISK_SAME_DIR
+IO_FLAG_SKIP_IVF_DATA = cvar.IO_FLAG_SKIP_IVF_DATA
+IO_FLAG_SKIP_PRECOMPUTE_TABLE = cvar.IO_FLAG_SKIP_PRECOMPUTE_TABLE
+IO_FLAG_MMAP = cvar.IO_FLAG_MMAP
+
+
+def clone_Quantizer(quant):
+    return _swigfaiss_avx2.clone_Quantizer(quant)
+
+def clone_binary_index(index):
+    return _swigfaiss_avx2.clone_binary_index(index)
+class AutoTuneCriterion(object):
+    r"""
+    Evaluation criterion. Returns a performance measure in [0,1],
+    higher is better.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    nq = property(_swigfaiss_avx2.AutoTuneCriterion_nq_get, _swigfaiss_avx2.AutoTuneCriterion_nq_set, doc=r""" nb of queries this criterion is evaluated on""")
+    nnn = property(_swigfaiss_avx2.AutoTuneCriterion_nnn_get, _swigfaiss_avx2.AutoTuneCriterion_nnn_set, doc=r""" nb of NNs that the query should request""")
+    gt_nnn = property(_swigfaiss_avx2.AutoTuneCriterion_gt_nnn_get, _swigfaiss_avx2.AutoTuneCriterion_gt_nnn_set, doc=r""" nb of GT NNs required to evaluate criterion""")
+    gt_D = property(_swigfaiss_avx2.AutoTuneCriterion_gt_D_get, _swigfaiss_avx2.AutoTuneCriterion_gt_D_set, doc=r""" Ground-truth distances (size nq * gt_nnn)""")
+    gt_I = property(_swigfaiss_avx2.AutoTuneCriterion_gt_I_get, _swigfaiss_avx2.AutoTuneCriterion_gt_I_set, doc=r""" Ground-truth indexes (size nq * gt_nnn)""")
+
+    def set_groundtruth(self, gt_nnn, gt_D_in, gt_I_in):
+        r"""
+         Intitializes the gt_D and gt_I vectors. Must be called before evaluating
+
+        :type gt_D_in: float
+        :param gt_D_in:  size nq * gt_nnn
+        :type gt_I_in: int
+        :param gt_I_in:  size nq * gt_nnn
+        """
+        return _swigfaiss_avx2.AutoTuneCriterion_set_groundtruth(self, gt_nnn, gt_D_in, gt_I_in)
+
+    def evaluate(self, D, I):
+        r"""
+         Evaluate the criterion.
+
+        :type D: float
+        :param D:  size nq * nnn
+        :type I: int
+        :param I:  size nq * nnn
+        :rtype: float
+        :return: the criterion, between 0 and 1. Larger is better.
+        """
+        return _swigfaiss_avx2.AutoTuneCriterion_evaluate(self, D, I)
+    __swig_destroy__ = _swigfaiss_avx2.delete_AutoTuneCriterion
+
+# Register AutoTuneCriterion in _swigfaiss_avx2:
+_swigfaiss_avx2.AutoTuneCriterion_swigregister(AutoTuneCriterion)
+class OneRecallAtRCriterion(AutoTuneCriterion):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    R = property(_swigfaiss_avx2.OneRecallAtRCriterion_R_get, _swigfaiss_avx2.OneRecallAtRCriterion_R_set)
+
+    def __init__(self, nq, R):
+        _swigfaiss_avx2.OneRecallAtRCriterion_swiginit(self, _swigfaiss_avx2.new_OneRecallAtRCriterion(nq, R))
+
+    def evaluate(self, D, I):
+        return _swigfaiss_avx2.OneRecallAtRCriterion_evaluate(self, D, I)
+    __swig_destroy__ = _swigfaiss_avx2.delete_OneRecallAtRCriterion
+
+# Register OneRecallAtRCriterion in _swigfaiss_avx2:
+_swigfaiss_avx2.OneRecallAtRCriterion_swigregister(OneRecallAtRCriterion)
+class IntersectionCriterion(AutoTuneCriterion):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    R = property(_swigfaiss_avx2.IntersectionCriterion_R_get, _swigfaiss_avx2.IntersectionCriterion_R_set)
+
+    def __init__(self, nq, R):
+        _swigfaiss_avx2.IntersectionCriterion_swiginit(self, _swigfaiss_avx2.new_IntersectionCriterion(nq, R))
+
+    def evaluate(self, D, I):
+        return _swigfaiss_avx2.IntersectionCriterion_evaluate(self, D, I)
+    __swig_destroy__ = _swigfaiss_avx2.delete_IntersectionCriterion
+
+# Register IntersectionCriterion in _swigfaiss_avx2:
+_swigfaiss_avx2.IntersectionCriterion_swigregister(IntersectionCriterion)
+class OperatingPoint(object):
+    r"""
+    Maintains a list of experimental results. Each operating point is a
+    (perf, t, key) triplet, where higher perf and lower t is
+    better. The key field is an arbitrary identifier for the operating point.
+
+    Includes primitives to extract the Pareto-optimal operating points in the
+    (perf, t) space.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    perf = property(_swigfaiss_avx2.OperatingPoint_perf_get, _swigfaiss_avx2.OperatingPoint_perf_set, doc=r""" performance measure (output of a Criterion)""")
+    t = property(_swigfaiss_avx2.OperatingPoint_t_get, _swigfaiss_avx2.OperatingPoint_t_set, doc=r""" corresponding execution time (ms)""")
+    key = property(_swigfaiss_avx2.OperatingPoint_key_get, _swigfaiss_avx2.OperatingPoint_key_set, doc=r""" key that identifies this op pt""")
+    cno = property(_swigfaiss_avx2.OperatingPoint_cno_get, _swigfaiss_avx2.OperatingPoint_cno_set, doc=r""" integer identifer""")
+
+    def __init__(self):
+        _swigfaiss_avx2.OperatingPoint_swiginit(self, _swigfaiss_avx2.new_OperatingPoint())
+    __swig_destroy__ = _swigfaiss_avx2.delete_OperatingPoint
+
+# Register OperatingPoint in _swigfaiss_avx2:
+_swigfaiss_avx2.OperatingPoint_swigregister(OperatingPoint)
+class OperatingPoints(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    all_pts = property(_swigfaiss_avx2.OperatingPoints_all_pts_get, _swigfaiss_avx2.OperatingPoints_all_pts_set, doc=r""" all operating points""")
+    optimal_pts = property(_swigfaiss_avx2.OperatingPoints_optimal_pts_get, _swigfaiss_avx2.OperatingPoints_optimal_pts_set, doc=r""" optimal operating points, sorted by perf""")
+
+    def __init__(self):
+        _swigfaiss_avx2.OperatingPoints_swiginit(self, _swigfaiss_avx2.new_OperatingPoints())
+
+    def merge_with(self, *args):
+        r""" add operating points from other to this, with a prefix to the keys"""
+        return _swigfaiss_avx2.OperatingPoints_merge_with(self, *args)
+
+    def clear(self):
+        return _swigfaiss_avx2.OperatingPoints_clear(self)
+
+    def add(self, perf, t, key, cno=0):
+        r""" add a performance measure. Return whether it is an optimal point"""
+        return _swigfaiss_avx2.OperatingPoints_add(self, perf, t, key, cno)
+
+    def t_for_perf(self, perf):
+        r""" get time required to obtain a given performance measure"""
+        return _swigfaiss_avx2.OperatingPoints_t_for_perf(self, perf)
+
+    def display(self, only_optimal=True):
+        r""" easy-to-read output"""
+        return _swigfaiss_avx2.OperatingPoints_display(self, only_optimal)
+
+    def all_to_gnuplot(self, fname):
+        r""" output to a format easy to digest by gnuplot"""
+        return _swigfaiss_avx2.OperatingPoints_all_to_gnuplot(self, fname)
+
+    def optimal_to_gnuplot(self, fname):
+        return _swigfaiss_avx2.OperatingPoints_optimal_to_gnuplot(self, fname)
+    __swig_destroy__ = _swigfaiss_avx2.delete_OperatingPoints
+
+# Register OperatingPoints in _swigfaiss_avx2:
+_swigfaiss_avx2.OperatingPoints_swigregister(OperatingPoints)
+class ParameterRange(object):
+    r""" possible values of a parameter, sorted from least to most expensive/accurate"""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    name = property(_swigfaiss_avx2.ParameterRange_name_get, _swigfaiss_avx2.ParameterRange_name_set)
+    values = property(_swigfaiss_avx2.ParameterRange_values_get, _swigfaiss_avx2.ParameterRange_values_set)
+
+    def __init__(self):
+        _swigfaiss_avx2.ParameterRange_swiginit(self, _swigfaiss_avx2.new_ParameterRange())
+    __swig_destroy__ = _swigfaiss_avx2.delete_ParameterRange
+
+# Register ParameterRange in _swigfaiss_avx2:
+_swigfaiss_avx2.ParameterRange_swigregister(ParameterRange)
+class ParameterSpace(object):
+    r""" Uses a-priori knowledge on the Faiss indexes to extract tunable parameters."""
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    parameter_ranges = property(_swigfaiss_avx2.ParameterSpace_parameter_ranges_get, _swigfaiss_avx2.ParameterSpace_parameter_ranges_set, doc=r""" all tunable parameters""")
+    verbose = property(_swigfaiss_avx2.ParameterSpace_verbose_get, _swigfaiss_avx2.ParameterSpace_verbose_set, doc=r""" verbosity during exploration""")
+    n_experiments = property(_swigfaiss_avx2.ParameterSpace_n_experiments_get, _swigfaiss_avx2.ParameterSpace_n_experiments_set, doc=r""" nb of experiments during optimization (0 = try all combinations)""")
+    batchsize = property(_swigfaiss_avx2.ParameterSpace_batchsize_get, _swigfaiss_avx2.ParameterSpace_batchsize_set, doc=r""" maximum number of queries to submit at a time.""")
+    thread_over_batches = property(_swigfaiss_avx2.ParameterSpace_thread_over_batches_get, _swigfaiss_avx2.ParameterSpace_thread_over_batches_set, doc=r"""
+    use multithreading over batches (useful to benchmark
+    independent single-searches)
+    """)
+    min_test_duration = property(_swigfaiss_avx2.ParameterSpace_min_test_duration_get, _swigfaiss_avx2.ParameterSpace_min_test_duration_set, doc=r"""
+    run tests several times until they reach at least this
+    duration (to avoid jittering in MT mode)
+    """)
+
+    def __init__(self):
+        _swigfaiss_avx2.ParameterSpace_swiginit(self, _swigfaiss_avx2.new_ParameterSpace())
+
+    def n_combinations(self):
+        r""" nb of combinations, = product of values sizes"""
+        return _swigfaiss_avx2.ParameterSpace_n_combinations(self)
+
+    def combination_ge(self, c1, c2):
+        r""" returns whether combinations c1 >= c2 in the tuple sense"""
+        return _swigfaiss_avx2.ParameterSpace_combination_ge(self, c1, c2)
+
+    def combination_name(self, cno):
+        r""" get string representation of the combination"""
+        return _swigfaiss_avx2.ParameterSpace_combination_name(self, cno)
+
+    def display(self):
+        r""" print a description on stdout"""
+        return _swigfaiss_avx2.ParameterSpace_display(self)
+
+    def add_range(self, name):
+        r""" add a new parameter (or return it if it exists)"""
+        return _swigfaiss_avx2.ParameterSpace_add_range(self, name)
+
+    def initialize(self, index):
+        r""" initialize with reasonable parameters for the index"""
+        return _swigfaiss_avx2.ParameterSpace_initialize(self, index)
+
+    def set_index_parameters(self, *args):
+        r"""
+        *Overload 1:*
+        set a combination of parameters on an index
+
+        |
+
+        *Overload 2:*
+        set a combination of parameters described by a string
+        """
+        return _swigfaiss_avx2.ParameterSpace_set_index_parameters(self, *args)
+
+    def set_index_parameter(self, index, name, val):
+        r""" set one of the parameters, returns whether setting was successful"""
+        return _swigfaiss_avx2.ParameterSpace_set_index_parameter(self, index, name, val)
+
+    def update_bounds(self, cno, op, upper_bound_perf, lower_bound_t):
+        r"""
+         find an upper bound on the performance and a lower bound on t
+        for configuration cno given another operating point op
+        """
+        return _swigfaiss_avx2.ParameterSpace_update_bounds(self, cno, op, upper_bound_perf, lower_bound_t)
+
+    def explore(self, index, nq, xq, crit, ops):
+        r"""
+         explore operating points
+        :type index: :py:class:`Index`
+        :param index:   index to run on
+        :type xq: float
+        :param xq:      query vectors (size nq * index.d)
+        :type crit: :py:class:`AutoTuneCriterion`
+        :param crit:    selection criterion
+        :type ops: :py:class:`OperatingPoints`
+        :param ops:     resulting operating points
+        """
+        return _swigfaiss_avx2.ParameterSpace_explore(self, index, nq, xq, crit, ops)
+    __swig_destroy__ = _swigfaiss_avx2.delete_ParameterSpace
+
+# Register ParameterSpace in _swigfaiss_avx2:
+_swigfaiss_avx2.ParameterSpace_swigregister(ParameterSpace)
+
+def index_factory(*args):
+    r"""
+    Build and index with the sequence of processing steps described in
+    the string.
+    """
+    return _swigfaiss_avx2.index_factory(*args)
+
+def index_binary_factory(d, description):
+    return _swigfaiss_avx2.index_binary_factory(d, description)
+class MatrixStats(object):
+    r"""
+     Reports some statistics on a dataset and comments on them.
+
+    It is a class rather than a function so that all stats can also be
+    accessed from code
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def __init__(self, n, d, x):
+        _swigfaiss_avx2.MatrixStats_swiginit(self, _swigfaiss_avx2.new_MatrixStats(n, d, x))
+    comments = property(_swigfaiss_avx2.MatrixStats_comments_get, _swigfaiss_avx2.MatrixStats_comments_set)
+    n = property(_swigfaiss_avx2.MatrixStats_n_get, _swigfaiss_avx2.MatrixStats_n_set)
+    d = property(_swigfaiss_avx2.MatrixStats_d_get, _swigfaiss_avx2.MatrixStats_d_set)
+    n_collision = property(_swigfaiss_avx2.MatrixStats_n_collision_get, _swigfaiss_avx2.MatrixStats_n_collision_set)
+    n_valid = property(_swigfaiss_avx2.MatrixStats_n_valid_get, _swigfaiss_avx2.MatrixStats_n_valid_set)
+    n0 = property(_swigfaiss_avx2.MatrixStats_n0_get, _swigfaiss_avx2.MatrixStats_n0_set)
+    min_norm2 = property(_swigfaiss_avx2.MatrixStats_min_norm2_get, _swigfaiss_avx2.MatrixStats_min_norm2_set)
+    max_norm2 = property(_swigfaiss_avx2.MatrixStats_max_norm2_get, _swigfaiss_avx2.MatrixStats_max_norm2_set)
+    hash_value = property(_swigfaiss_avx2.MatrixStats_hash_value_get, _swigfaiss_avx2.MatrixStats_hash_value_set)
+    per_dim_stats = property(_swigfaiss_avx2.MatrixStats_per_dim_stats_get, _swigfaiss_avx2.MatrixStats_per_dim_stats_set)
+    occurrences = property(_swigfaiss_avx2.MatrixStats_occurrences_get, _swigfaiss_avx2.MatrixStats_occurrences_set)
+    buf = property(_swigfaiss_avx2.MatrixStats_buf_get, _swigfaiss_avx2.MatrixStats_buf_set)
+    nbuf = property(_swigfaiss_avx2.MatrixStats_nbuf_get, _swigfaiss_avx2.MatrixStats_nbuf_set)
+
+    def do_comment(self, fmt):
+        return _swigfaiss_avx2.MatrixStats_do_comment(self, fmt)
+    __swig_destroy__ = _swigfaiss_avx2.delete_MatrixStats
+
+# Register MatrixStats in _swigfaiss_avx2:
+_swigfaiss_avx2.MatrixStats_swigregister(MatrixStats)
+class PyCallbackIOWriter(IOWriter):
+    r"""
+    Copyright (c) Facebook, Inc. and its affiliates.
+
+    This source code is licensed under the MIT license found in the
+    LICENSE file in the root directory of this source tree.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    callback = property(_swigfaiss_avx2.PyCallbackIOWriter_callback_get, _swigfaiss_avx2.PyCallbackIOWriter_callback_set)
+    bs = property(_swigfaiss_avx2.PyCallbackIOWriter_bs_get, _swigfaiss_avx2.PyCallbackIOWriter_bs_set)
+
+    def __init__(self, *args):
+        r"""
+        Callback: Python function that takes a bytes object and
+        returns the number of bytes successfully written.
+        """
+        _swigfaiss_avx2.PyCallbackIOWriter_swiginit(self, _swigfaiss_avx2.new_PyCallbackIOWriter(*args))
+
+    def __call__(self, ptrv, size, nitems):
+        return _swigfaiss_avx2.PyCallbackIOWriter___call__(self, ptrv, size, nitems)
+    __swig_destroy__ = _swigfaiss_avx2.delete_PyCallbackIOWriter
+
+# Register PyCallbackIOWriter in _swigfaiss_avx2:
+_swigfaiss_avx2.PyCallbackIOWriter_swigregister(PyCallbackIOWriter)
+class PyCallbackIOReader(IOReader):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    callback = property(_swigfaiss_avx2.PyCallbackIOReader_callback_get, _swigfaiss_avx2.PyCallbackIOReader_callback_set)
+    bs = property(_swigfaiss_avx2.PyCallbackIOReader_bs_get, _swigfaiss_avx2.PyCallbackIOReader_bs_set)
+
+    def __init__(self, *args):
+        r"""
+         Callback: Python function that takes a size and returns a
+        bytes object with the resulting read
+        """
+        _swigfaiss_avx2.PyCallbackIOReader_swiginit(self, _swigfaiss_avx2.new_PyCallbackIOReader(*args))
+
+    def __call__(self, ptrv, size, nitems):
+        return _swigfaiss_avx2.PyCallbackIOReader___call__(self, ptrv, size, nitems)
+    __swig_destroy__ = _swigfaiss_avx2.delete_PyCallbackIOReader
+
+# Register PyCallbackIOReader in _swigfaiss_avx2:
+_swigfaiss_avx2.PyCallbackIOReader_swigregister(PyCallbackIOReader)
+class PyCallbackIDSelector(IDSelector):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    callback = property(_swigfaiss_avx2.PyCallbackIDSelector_callback_get, _swigfaiss_avx2.PyCallbackIDSelector_callback_set)
+
+    def __init__(self, callback):
+        _swigfaiss_avx2.PyCallbackIDSelector_swiginit(self, _swigfaiss_avx2.new_PyCallbackIDSelector(callback))
+
+    def is_member(self, id):
+        return _swigfaiss_avx2.PyCallbackIDSelector_is_member(self, id)
+    __swig_destroy__ = _swigfaiss_avx2.delete_PyCallbackIDSelector
+
+# Register PyCallbackIDSelector in _swigfaiss_avx2:
+_swigfaiss_avx2.PyCallbackIDSelector_swigregister(PyCallbackIDSelector)
+class float_minheap_array_t(object):
+    r"""
+     a template structure for a set of [min|max]-heaps it is tailored
+    so that the actual data of the heaps can just live in compact
+    arrays.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nh = property(_swigfaiss_avx2.float_minheap_array_t_nh_get, _swigfaiss_avx2.float_minheap_array_t_nh_set, doc=r""" number of heaps""")
+    k = property(_swigfaiss_avx2.float_minheap_array_t_k_get, _swigfaiss_avx2.float_minheap_array_t_k_set, doc=r""" allocated size per heap""")
+    ids = property(_swigfaiss_avx2.float_minheap_array_t_ids_get, _swigfaiss_avx2.float_minheap_array_t_ids_set, doc=r""" identifiers (size nh * k)""")
+    val = property(_swigfaiss_avx2.float_minheap_array_t_val_get, _swigfaiss_avx2.float_minheap_array_t_val_set, doc=r""" values (distances or similarities), size nh * k""")
+
+    def get_val(self, key):
+        r""" Return the list of values for a heap"""
+        return _swigfaiss_avx2.float_minheap_array_t_get_val(self, key)
+
+    def get_ids(self, key):
+        r""" Correspponding identifiers"""
+        return _swigfaiss_avx2.float_minheap_array_t_get_ids(self, key)
+
+    def heapify(self):
+        r""" prepare all the heaps before adding"""
+        return _swigfaiss_avx2.float_minheap_array_t_heapify(self)
+
+    def addn(self, nj, vin, j0=0, i0=0, ni=-1):
+        r"""
+         add nj elements to heaps i0:i0+ni, with sequential ids
+
+        :type nj: int
+        :param nj:    nb of elements to add to each heap
+        :type vin: float
+        :param vin:   elements to add, size ni * nj
+        :type j0: int, optional
+        :param j0:    add this to the ids that are added
+        :type i0: int, optional
+        :param i0:    first heap to update
+        :type ni: int, optional
+        :param ni:    nb of elements to update (-1 = use nh)
+        """
+        return _swigfaiss_avx2.float_minheap_array_t_addn(self, nj, vin, j0, i0, ni)
+
+    def addn_with_ids(self, nj, vin, id_in=None, id_stride=0, i0=0, ni=-1):
+        r"""
+         same as addn
+
+        :type id_in: int, optional
+        :param id_in:     ids of the elements to add, size ni * nj
+        :type id_stride: int, optional
+        :param id_stride: stride for id_in
+        """
+        return _swigfaiss_avx2.float_minheap_array_t_addn_with_ids(self, nj, vin, id_in, id_stride, i0, ni)
+
+    def addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in=None, id_stride=0):
+        r"""
+         same as addn_with_ids, but for just a subset of queries
+
+        :type nsubset: int
+        :param nsubset:  number of query entries to update
+        :type subset: int
+        :param subset:   indexes of queries to update, in 0..nh-1, size nsubset
+        """
+        return _swigfaiss_avx2.float_minheap_array_t_addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in, id_stride)
+
+    def reorder(self):
+        r""" reorder all the heaps"""
+        return _swigfaiss_avx2.float_minheap_array_t_reorder(self)
+
+    def per_line_extrema(self, vals_out, idx_out):
+        r"""
+         this is not really a heap function. It just finds the per-line
+          extrema of each line of array D
+        :type vals_out: float
+        :param vals_out:    extreme value of each line (size nh, or NULL)
+        :type idx_out: int
+        :param idx_out:     index of extreme value (size nh or NULL)
+        """
+        return _swigfaiss_avx2.float_minheap_array_t_per_line_extrema(self, vals_out, idx_out)
+
+    def __init__(self):
+        _swigfaiss_avx2.float_minheap_array_t_swiginit(self, _swigfaiss_avx2.new_float_minheap_array_t())
+    __swig_destroy__ = _swigfaiss_avx2.delete_float_minheap_array_t
+
+# Register float_minheap_array_t in _swigfaiss_avx2:
+_swigfaiss_avx2.float_minheap_array_t_swigregister(float_minheap_array_t)
+class int_minheap_array_t(object):
+    r"""
+     a template structure for a set of [min|max]-heaps it is tailored
+    so that the actual data of the heaps can just live in compact
+    arrays.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nh = property(_swigfaiss_avx2.int_minheap_array_t_nh_get, _swigfaiss_avx2.int_minheap_array_t_nh_set, doc=r""" number of heaps""")
+    k = property(_swigfaiss_avx2.int_minheap_array_t_k_get, _swigfaiss_avx2.int_minheap_array_t_k_set, doc=r""" allocated size per heap""")
+    ids = property(_swigfaiss_avx2.int_minheap_array_t_ids_get, _swigfaiss_avx2.int_minheap_array_t_ids_set, doc=r""" identifiers (size nh * k)""")
+    val = property(_swigfaiss_avx2.int_minheap_array_t_val_get, _swigfaiss_avx2.int_minheap_array_t_val_set, doc=r""" values (distances or similarities), size nh * k""")
+
+    def get_val(self, key):
+        r""" Return the list of values for a heap"""
+        return _swigfaiss_avx2.int_minheap_array_t_get_val(self, key)
+
+    def get_ids(self, key):
+        r""" Correspponding identifiers"""
+        return _swigfaiss_avx2.int_minheap_array_t_get_ids(self, key)
+
+    def heapify(self):
+        r""" prepare all the heaps before adding"""
+        return _swigfaiss_avx2.int_minheap_array_t_heapify(self)
+
+    def addn(self, nj, vin, j0=0, i0=0, ni=-1):
+        r"""
+         add nj elements to heaps i0:i0+ni, with sequential ids
+
+        :type nj: int
+        :param nj:    nb of elements to add to each heap
+        :type vin: int
+        :param vin:   elements to add, size ni * nj
+        :type j0: int, optional
+        :param j0:    add this to the ids that are added
+        :type i0: int, optional
+        :param i0:    first heap to update
+        :type ni: int, optional
+        :param ni:    nb of elements to update (-1 = use nh)
+        """
+        return _swigfaiss_avx2.int_minheap_array_t_addn(self, nj, vin, j0, i0, ni)
+
+    def addn_with_ids(self, nj, vin, id_in=None, id_stride=0, i0=0, ni=-1):
+        r"""
+         same as addn
+
+        :type id_in: int, optional
+        :param id_in:     ids of the elements to add, size ni * nj
+        :type id_stride: int, optional
+        :param id_stride: stride for id_in
+        """
+        return _swigfaiss_avx2.int_minheap_array_t_addn_with_ids(self, nj, vin, id_in, id_stride, i0, ni)
+
+    def addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in=None, id_stride=0):
+        r"""
+         same as addn_with_ids, but for just a subset of queries
+
+        :type nsubset: int
+        :param nsubset:  number of query entries to update
+        :type subset: int
+        :param subset:   indexes of queries to update, in 0..nh-1, size nsubset
+        """
+        return _swigfaiss_avx2.int_minheap_array_t_addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in, id_stride)
+
+    def reorder(self):
+        r""" reorder all the heaps"""
+        return _swigfaiss_avx2.int_minheap_array_t_reorder(self)
+
+    def per_line_extrema(self, vals_out, idx_out):
+        r"""
+         this is not really a heap function. It just finds the per-line
+          extrema of each line of array D
+        :type vals_out: int
+        :param vals_out:    extreme value of each line (size nh, or NULL)
+        :type idx_out: int
+        :param idx_out:     index of extreme value (size nh or NULL)
+        """
+        return _swigfaiss_avx2.int_minheap_array_t_per_line_extrema(self, vals_out, idx_out)
+
+    def __init__(self):
+        _swigfaiss_avx2.int_minheap_array_t_swiginit(self, _swigfaiss_avx2.new_int_minheap_array_t())
+    __swig_destroy__ = _swigfaiss_avx2.delete_int_minheap_array_t
+
+# Register int_minheap_array_t in _swigfaiss_avx2:
+_swigfaiss_avx2.int_minheap_array_t_swigregister(int_minheap_array_t)
+class float_maxheap_array_t(object):
+    r"""
+     a template structure for a set of [min|max]-heaps it is tailored
+    so that the actual data of the heaps can just live in compact
+    arrays.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nh = property(_swigfaiss_avx2.float_maxheap_array_t_nh_get, _swigfaiss_avx2.float_maxheap_array_t_nh_set, doc=r""" number of heaps""")
+    k = property(_swigfaiss_avx2.float_maxheap_array_t_k_get, _swigfaiss_avx2.float_maxheap_array_t_k_set, doc=r""" allocated size per heap""")
+    ids = property(_swigfaiss_avx2.float_maxheap_array_t_ids_get, _swigfaiss_avx2.float_maxheap_array_t_ids_set, doc=r""" identifiers (size nh * k)""")
+    val = property(_swigfaiss_avx2.float_maxheap_array_t_val_get, _swigfaiss_avx2.float_maxheap_array_t_val_set, doc=r""" values (distances or similarities), size nh * k""")
+
+    def get_val(self, key):
+        r""" Return the list of values for a heap"""
+        return _swigfaiss_avx2.float_maxheap_array_t_get_val(self, key)
+
+    def get_ids(self, key):
+        r""" Correspponding identifiers"""
+        return _swigfaiss_avx2.float_maxheap_array_t_get_ids(self, key)
+
+    def heapify(self):
+        r""" prepare all the heaps before adding"""
+        return _swigfaiss_avx2.float_maxheap_array_t_heapify(self)
+
+    def addn(self, nj, vin, j0=0, i0=0, ni=-1):
+        r"""
+         add nj elements to heaps i0:i0+ni, with sequential ids
+
+        :type nj: int
+        :param nj:    nb of elements to add to each heap
+        :type vin: float
+        :param vin:   elements to add, size ni * nj
+        :type j0: int, optional
+        :param j0:    add this to the ids that are added
+        :type i0: int, optional
+        :param i0:    first heap to update
+        :type ni: int, optional
+        :param ni:    nb of elements to update (-1 = use nh)
+        """
+        return _swigfaiss_avx2.float_maxheap_array_t_addn(self, nj, vin, j0, i0, ni)
+
+    def addn_with_ids(self, nj, vin, id_in=None, id_stride=0, i0=0, ni=-1):
+        r"""
+         same as addn
+
+        :type id_in: int, optional
+        :param id_in:     ids of the elements to add, size ni * nj
+        :type id_stride: int, optional
+        :param id_stride: stride for id_in
+        """
+        return _swigfaiss_avx2.float_maxheap_array_t_addn_with_ids(self, nj, vin, id_in, id_stride, i0, ni)
+
+    def addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in=None, id_stride=0):
+        r"""
+         same as addn_with_ids, but for just a subset of queries
+
+        :type nsubset: int
+        :param nsubset:  number of query entries to update
+        :type subset: int
+        :param subset:   indexes of queries to update, in 0..nh-1, size nsubset
+        """
+        return _swigfaiss_avx2.float_maxheap_array_t_addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in, id_stride)
+
+    def reorder(self):
+        r""" reorder all the heaps"""
+        return _swigfaiss_avx2.float_maxheap_array_t_reorder(self)
+
+    def per_line_extrema(self, vals_out, idx_out):
+        r"""
+         this is not really a heap function. It just finds the per-line
+          extrema of each line of array D
+        :type vals_out: float
+        :param vals_out:    extreme value of each line (size nh, or NULL)
+        :type idx_out: int
+        :param idx_out:     index of extreme value (size nh or NULL)
+        """
+        return _swigfaiss_avx2.float_maxheap_array_t_per_line_extrema(self, vals_out, idx_out)
+
+    def __init__(self):
+        _swigfaiss_avx2.float_maxheap_array_t_swiginit(self, _swigfaiss_avx2.new_float_maxheap_array_t())
+    __swig_destroy__ = _swigfaiss_avx2.delete_float_maxheap_array_t
+
+# Register float_maxheap_array_t in _swigfaiss_avx2:
+_swigfaiss_avx2.float_maxheap_array_t_swigregister(float_maxheap_array_t)
+class int_maxheap_array_t(object):
+    r"""
+     a template structure for a set of [min|max]-heaps it is tailored
+    so that the actual data of the heaps can just live in compact
+    arrays.
+    """
+
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    nh = property(_swigfaiss_avx2.int_maxheap_array_t_nh_get, _swigfaiss_avx2.int_maxheap_array_t_nh_set, doc=r""" number of heaps""")
+    k = property(_swigfaiss_avx2.int_maxheap_array_t_k_get, _swigfaiss_avx2.int_maxheap_array_t_k_set, doc=r""" allocated size per heap""")
+    ids = property(_swigfaiss_avx2.int_maxheap_array_t_ids_get, _swigfaiss_avx2.int_maxheap_array_t_ids_set, doc=r""" identifiers (size nh * k)""")
+    val = property(_swigfaiss_avx2.int_maxheap_array_t_val_get, _swigfaiss_avx2.int_maxheap_array_t_val_set, doc=r""" values (distances or similarities), size nh * k""")
+
+    def get_val(self, key):
+        r""" Return the list of values for a heap"""
+        return _swigfaiss_avx2.int_maxheap_array_t_get_val(self, key)
+
+    def get_ids(self, key):
+        r""" Correspponding identifiers"""
+        return _swigfaiss_avx2.int_maxheap_array_t_get_ids(self, key)
+
+    def heapify(self):
+        r""" prepare all the heaps before adding"""
+        return _swigfaiss_avx2.int_maxheap_array_t_heapify(self)
+
+    def addn(self, nj, vin, j0=0, i0=0, ni=-1):
+        r"""
+         add nj elements to heaps i0:i0+ni, with sequential ids
+
+        :type nj: int
+        :param nj:    nb of elements to add to each heap
+        :type vin: int
+        :param vin:   elements to add, size ni * nj
+        :type j0: int, optional
+        :param j0:    add this to the ids that are added
+        :type i0: int, optional
+        :param i0:    first heap to update
+        :type ni: int, optional
+        :param ni:    nb of elements to update (-1 = use nh)
+        """
+        return _swigfaiss_avx2.int_maxheap_array_t_addn(self, nj, vin, j0, i0, ni)
+
+    def addn_with_ids(self, nj, vin, id_in=None, id_stride=0, i0=0, ni=-1):
+        r"""
+         same as addn
+
+        :type id_in: int, optional
+        :param id_in:     ids of the elements to add, size ni * nj
+        :type id_stride: int, optional
+        :param id_stride: stride for id_in
+        """
+        return _swigfaiss_avx2.int_maxheap_array_t_addn_with_ids(self, nj, vin, id_in, id_stride, i0, ni)
+
+    def addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in=None, id_stride=0):
+        r"""
+         same as addn_with_ids, but for just a subset of queries
+
+        :type nsubset: int
+        :param nsubset:  number of query entries to update
+        :type subset: int
+        :param subset:   indexes of queries to update, in 0..nh-1, size nsubset
+        """
+        return _swigfaiss_avx2.int_maxheap_array_t_addn_query_subset_with_ids(self, nsubset, subset, nj, vin, id_in, id_stride)
+
+    def reorder(self):
+        r""" reorder all the heaps"""
+        return _swigfaiss_avx2.int_maxheap_array_t_reorder(self)
+
+    def per_line_extrema(self, vals_out, idx_out):
+        r"""
+         this is not really a heap function. It just finds the per-line
+          extrema of each line of array D
+        :type vals_out: int
+        :param vals_out:    extreme value of each line (size nh, or NULL)
+        :type idx_out: int
+        :param idx_out:     index of extreme value (size nh or NULL)
+        """
+        return _swigfaiss_avx2.int_maxheap_array_t_per_line_extrema(self, vals_out, idx_out)
+
+    def __init__(self):
+        _swigfaiss_avx2.int_maxheap_array_t_swiginit(self, _swigfaiss_avx2.new_int_maxheap_array_t())
+    __swig_destroy__ = _swigfaiss_avx2.delete_int_maxheap_array_t
+
+# Register int_maxheap_array_t in _swigfaiss_avx2:
+_swigfaiss_avx2.int_maxheap_array_t_swigregister(int_maxheap_array_t)
+
+def CMin_float_partition_fuzzy(vals, ids, n, q_min, q_max, q_out):
+    r"""
+     partitions the table into 0:q and q:n where all elements above q are >= all
+    elements below q (for C = CMax, for CMin comparisons are reversed)
+
+    Returns the partition threshold. The elements q:n are destroyed on output.
+    """
+    return _swigfaiss_avx2.CMin_float_partition_fuzzy(vals, ids, n, q_min, q_max, q_out)
+
+def CMax_float_partition_fuzzy(vals, ids, n, q_min, q_max, q_out):
+    r"""
+     partitions the table into 0:q and q:n where all elements above q are >= all
+    elements below q (for C = CMax, for CMin comparisons are reversed)
+
+    Returns the partition threshold. The elements q:n are destroyed on output.
+    """
+    return _swigfaiss_avx2.CMax_float_partition_fuzzy(vals, ids, n, q_min, q_max, q_out)
+class AlignedTableUint8(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    tab = property(_swigfaiss_avx2.AlignedTableUint8_tab_get, _swigfaiss_avx2.AlignedTableUint8_tab_set)
+    numel = property(_swigfaiss_avx2.AlignedTableUint8_numel_get, _swigfaiss_avx2.AlignedTableUint8_numel_set)
+
+    @staticmethod
+    def round_capacity(n):
+        return _swigfaiss_avx2.AlignedTableUint8_round_capacity(n)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.AlignedTableUint8_swiginit(self, _swigfaiss_avx2.new_AlignedTableUint8(*args))
+
+    def itemsize(self):
+        return _swigfaiss_avx2.AlignedTableUint8_itemsize(self)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.AlignedTableUint8_resize(self, n)
+
+    def clear(self):
+        return _swigfaiss_avx2.AlignedTableUint8_clear(self)
+
+    def size(self):
+        return _swigfaiss_avx2.AlignedTableUint8_size(self)
+
+    def nbytes(self):
+        return _swigfaiss_avx2.AlignedTableUint8_nbytes(self)
+
+    def get(self, *args):
+        return _swigfaiss_avx2.AlignedTableUint8_get(self, *args)
+
+    def data(self, *args):
+        return _swigfaiss_avx2.AlignedTableUint8_data(self, *args)
+    __swig_destroy__ = _swigfaiss_avx2.delete_AlignedTableUint8
+
+# Register AlignedTableUint8 in _swigfaiss_avx2:
+_swigfaiss_avx2.AlignedTableUint8_swigregister(AlignedTableUint8)
+class AlignedTableUint16(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    tab = property(_swigfaiss_avx2.AlignedTableUint16_tab_get, _swigfaiss_avx2.AlignedTableUint16_tab_set)
+    numel = property(_swigfaiss_avx2.AlignedTableUint16_numel_get, _swigfaiss_avx2.AlignedTableUint16_numel_set)
+
+    @staticmethod
+    def round_capacity(n):
+        return _swigfaiss_avx2.AlignedTableUint16_round_capacity(n)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.AlignedTableUint16_swiginit(self, _swigfaiss_avx2.new_AlignedTableUint16(*args))
+
+    def itemsize(self):
+        return _swigfaiss_avx2.AlignedTableUint16_itemsize(self)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.AlignedTableUint16_resize(self, n)
+
+    def clear(self):
+        return _swigfaiss_avx2.AlignedTableUint16_clear(self)
+
+    def size(self):
+        return _swigfaiss_avx2.AlignedTableUint16_size(self)
+
+    def nbytes(self):
+        return _swigfaiss_avx2.AlignedTableUint16_nbytes(self)
+
+    def get(self, *args):
+        return _swigfaiss_avx2.AlignedTableUint16_get(self, *args)
+
+    def data(self, *args):
+        return _swigfaiss_avx2.AlignedTableUint16_data(self, *args)
+    __swig_destroy__ = _swigfaiss_avx2.delete_AlignedTableUint16
+
+# Register AlignedTableUint16 in _swigfaiss_avx2:
+_swigfaiss_avx2.AlignedTableUint16_swigregister(AlignedTableUint16)
+class AlignedTableFloat32(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    tab = property(_swigfaiss_avx2.AlignedTableFloat32_tab_get, _swigfaiss_avx2.AlignedTableFloat32_tab_set)
+    numel = property(_swigfaiss_avx2.AlignedTableFloat32_numel_get, _swigfaiss_avx2.AlignedTableFloat32_numel_set)
+
+    @staticmethod
+    def round_capacity(n):
+        return _swigfaiss_avx2.AlignedTableFloat32_round_capacity(n)
+
+    def __init__(self, *args):
+        _swigfaiss_avx2.AlignedTableFloat32_swiginit(self, _swigfaiss_avx2.new_AlignedTableFloat32(*args))
+
+    def itemsize(self):
+        return _swigfaiss_avx2.AlignedTableFloat32_itemsize(self)
+
+    def resize(self, n):
+        return _swigfaiss_avx2.AlignedTableFloat32_resize(self, n)
+
+    def clear(self):
+        return _swigfaiss_avx2.AlignedTableFloat32_clear(self)
+
+    def size(self):
+        return _swigfaiss_avx2.AlignedTableFloat32_size(self)
+
+    def nbytes(self):
+        return _swigfaiss_avx2.AlignedTableFloat32_nbytes(self)
+
+    def get(self, *args):
+        return _swigfaiss_avx2.AlignedTableFloat32_get(self, *args)
+
+    def data(self, *args):
+        return _swigfaiss_avx2.AlignedTableFloat32_data(self, *args)
+    __swig_destroy__ = _swigfaiss_avx2.delete_AlignedTableFloat32
+
+# Register AlignedTableFloat32 in _swigfaiss_avx2:
+_swigfaiss_avx2.AlignedTableFloat32_swigregister(AlignedTableFloat32)
+
+def CMin_uint16_partition_fuzzy(*args):
+    return _swigfaiss_avx2.CMin_uint16_partition_fuzzy(*args)
+
+def CMax_uint16_partition_fuzzy(*args):
+    return _swigfaiss_avx2.CMax_uint16_partition_fuzzy(*args)
+
+def merge_knn_results_CMin(*args):
+    return _swigfaiss_avx2.merge_knn_results_CMin(*args)
+
+def merge_knn_results_CMax(*args):
+    return _swigfaiss_avx2.merge_knn_results_CMax(*args)
+class MapLong2Long(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    map = property(_swigfaiss_avx2.MapLong2Long_map_get, _swigfaiss_avx2.MapLong2Long_map_set)
+
+    def add(self, n, keys, vals):
+        return _swigfaiss_avx2.MapLong2Long_add(self, n, keys, vals)
+
+    def search(self, key):
+        return _swigfaiss_avx2.MapLong2Long_search(self, key)
+
+    def search_multiple(self, n, keys, vals):
+        return _swigfaiss_avx2.MapLong2Long_search_multiple(self, n, keys, vals)
+
+    def __init__(self):
+        _swigfaiss_avx2.MapLong2Long_swiginit(self, _swigfaiss_avx2.new_MapLong2Long())
+    __swig_destroy__ = _swigfaiss_avx2.delete_MapLong2Long
+
+# Register MapLong2Long in _swigfaiss_avx2:
+_swigfaiss_avx2.MapLong2Long_swigregister(MapLong2Long)
+
+def omp_set_num_threads(num_threads):
+    return _swigfaiss_avx2.omp_set_num_threads(num_threads)
+
+def omp_get_max_threads():
+    return _swigfaiss_avx2.omp_get_max_threads()
+
+def memcpy(dest, src, n):
+    return _swigfaiss_avx2.memcpy(dest, src, n)
+
+def swig_ptr(a):
+    return _swigfaiss_avx2.swig_ptr(a)
+
+def rev_swig_ptr(*args):
+    return _swigfaiss_avx2.rev_swig_ptr(*args)
+
+def cast_integer_to_uint8_ptr(x):
+    return _swigfaiss_avx2.cast_integer_to_uint8_ptr(x)
+
+def cast_integer_to_float_ptr(x):
+    return _swigfaiss_avx2.cast_integer_to_float_ptr(x)
+
+def cast_integer_to_idx_t_ptr(x):
+    return _swigfaiss_avx2.cast_integer_to_idx_t_ptr(x)
+
+def cast_integer_to_int_ptr(x):
+    return _swigfaiss_avx2.cast_integer_to_int_ptr(x)
+
+def cast_integer_to_void_ptr(x):
+    return _swigfaiss_avx2.cast_integer_to_void_ptr(x)
+
+def wait():
+    return _swigfaiss_avx2.wait()
+
diff --git a/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/DELVEWHEEL b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/DELVEWHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef727dffe9c3088f5b7d9f9df1e6f4159687a36b
--- /dev/null
+++ b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/DELVEWHEEL
@@ -0,0 +1,2 @@
+Version: 1.5.2
+Arguments: ['C:\\Users\\runneradmin\\AppData\\Local\\Temp\\cibw-run-zw6z5ien\\cp311-win_amd64\\build\\venv\\Scripts\\delvewheel', 'repair', '-v', '-w', 'C:\\Users\\runneradmin\\AppData\\Local\\Temp\\cibw-run-zw6z5ien\\cp311-win_amd64\\repaired_wheel', 'C:\\Users\\runneradmin\\AppData\\Local\\Temp\\cibw-run-zw6z5ien\\cp311-win_amd64\\built_wheel\\faiss_cpu-1.8.0-cp311-cp311-win_amd64.whl']
diff --git a/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/INSTALLER b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/LICENSE b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..d84f27d9304929b1175f8c906bcc9cd2fa2e1cb7
--- /dev/null
+++ b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Kota Yamaguchi
+
+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
+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.
diff --git a/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/METADATA b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..d377c1c3fc033be92321954c30f9ead2f480286e
--- /dev/null
+++ b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/METADATA
@@ -0,0 +1,102 @@
+Metadata-Version: 2.1
+Name: faiss-cpu
+Version: 1.8.0
+Summary: A library for efficient similarity search and clustering of dense vectors.
+Author-email: Kota Yamaguchi <yamaguchi_kota@cyberagent.co.jp>
+License: MIT License
+Project-URL: Repository, https://github.com/kyamagu/faiss-wheels
+Keywords: faiss,similarity search,clustering,machine learning
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+
+# faiss-wheels
+
+[![Build](https://github.com/kyamagu/faiss-wheels/actions/workflows/build.yml/badge.svg)](https://github.com/kyamagu/faiss-wheels/actions/workflows/build.yml)
+[![PyPI](https://img.shields.io/pypi/v/faiss-cpu?label=faiss-cpu)](https://pypi.org/project/faiss-cpu/)
+
+faiss python wheel packages.
+
+- [faiss](https://github.com/facebookresearch/faiss)
+
+## Overview
+
+This repository provides scripts to build wheel packages for the
+[faiss](https://github.com/facebookresearch/faiss) library.
+
+- Builds CPU-only version with [cibuildwheel](https://github.com/pypa/cibuildwheel/).
+- Bundles OpenBLAS in Linux/Windows
+- Uses Accelerate framework in macOS
+
+There is also a source package to customize the build process.
+
+> **Note**
+> GPU package has been supported until version 1.7.2, but is not available since version 1.7.3 due to [the PyPI limitation](https://github.com/kyamagu/faiss-wheels/issues/57).
+
+### Install
+
+Install a binary package by:
+
+```bash
+pip install faiss-cpu
+```
+
+## Building source package
+
+If there is a custom built faiss library in the system, build source package for
+the best performance.
+
+### Prerequisite
+
+The source package assumes faiss is already built and installed in the system.
+Build and install the faiss library first.
+
+```bash
+cd faiss
+cmake . -B build -DFAISS_ENABLE_GPU=OFF -DFAISS_ENABLE_PYTHON=OFF -DFAISS_OPT_LEVEL=avx512
+cmake --build build --config Release -j
+cmake --install build install
+cd ..
+```
+
+See the official
+[faiss installation instruction](https://github.com/facebookresearch/faiss/blob/master/INSTALL.md)
+for more on how to build and install faiss.
+
+For building sdist, swig 3.0.12 or later needs to be available.
+
+### Building a source distribution
+
+The following builds and installs the faiss-cpu source package with AVX512.
+
+```bash
+export FAISS_OPT_LEVEL=avx512
+pip install --no-binary :all: faiss-cpu
+```
+
+The following example builds a GPU wheel.
+
+```bash
+export FAISS_ENABLE_GPU=ON
+pip install --no-binary :all: faiss-cpu
+```
+
+There are a few environment variables that specifies build-time options.
+- `FAISS_INSTALL_PREFIX`: Specifies the install location of faiss library, default to `/usr/local`.
+- `FAISS_OPT_LEVEL`: Faiss SIMD optimization, one of `generic`, `avx2`, `avx512`. Note that AVX option is only available in x86_64 arch.
+- `FAISS_ENABLE_GPU`: Setting this variable to `ON` builds GPU wrappers. Set this variable if faiss is built with GPU support.
+- `CUDA_HOME`: Specifies CUDA install location for building GPU wrappers, default to `/usr/local/cuda`.
diff --git a/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/RECORD b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..e58e4ed90ec19b7379e556bdd77ac9b4d52cfaa4
--- /dev/null
+++ b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/RECORD
@@ -0,0 +1,64 @@
+faiss/__init__.py,sha256=HypDOCmVUQVjO6skHUwsFjIdYpdXxsdEsKKHhFcY3T4,12020
+faiss/__pycache__/__init__.cpython-311.pyc,,
+faiss/__pycache__/array_conversions.cpython-311.pyc,,
+faiss/__pycache__/class_wrappers.cpython-311.pyc,,
+faiss/__pycache__/extra_wrappers.cpython-311.pyc,,
+faiss/__pycache__/gpu_wrappers.cpython-311.pyc,,
+faiss/__pycache__/loader.cpython-311.pyc,,
+faiss/__pycache__/setup.cpython-311.pyc,,
+faiss/__pycache__/swigfaiss.cpython-311.pyc,,
+faiss/__pycache__/swigfaiss_avx2.cpython-311.pyc,,
+faiss/_swigfaiss.cp311-win_amd64.pyd,sha256=FwpTUxHsbndj2dPePmdWCBMtLRsM4YEM8aWy-3g5T0c,9971712
+faiss/_swigfaiss_avx2.cp311-win_amd64.pyd,sha256=SSHoPI-zvn9-xmcWCyJ4KXpEAd0Hx1aIX7XNXbJJ6sM,11123200
+faiss/array_conversions.py,sha256=vfmg0_uiJ5it-3z5UUC6freGAZLFGuek_fkUek-3vvM,5268
+faiss/class_wrappers.py,sha256=iYemtTvmDXRFV2Gj2qZ_hX5NMTBhtfK21BpFBsXoLnI,43201
+faiss/contrib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+faiss/contrib/__pycache__/__init__.cpython-311.pyc,,
+faiss/contrib/__pycache__/big_batch_search.cpython-311.pyc,,
+faiss/contrib/__pycache__/client_server.cpython-311.pyc,,
+faiss/contrib/__pycache__/clustering.cpython-311.pyc,,
+faiss/contrib/__pycache__/datasets.cpython-311.pyc,,
+faiss/contrib/__pycache__/evaluation.cpython-311.pyc,,
+faiss/contrib/__pycache__/exhaustive_search.cpython-311.pyc,,
+faiss/contrib/__pycache__/factory_tools.cpython-311.pyc,,
+faiss/contrib/__pycache__/inspect_tools.cpython-311.pyc,,
+faiss/contrib/__pycache__/ivf_tools.cpython-311.pyc,,
+faiss/contrib/__pycache__/ondisk.cpython-311.pyc,,
+faiss/contrib/__pycache__/rpc.cpython-311.pyc,,
+faiss/contrib/__pycache__/torch_utils.cpython-311.pyc,,
+faiss/contrib/__pycache__/vecs_io.cpython-311.pyc,,
+faiss/contrib/big_batch_search.py,sha256=QxRsW558bbEezlsyAkO3bP82E8Y66FsY5v1h9Dr7BTE,18153
+faiss/contrib/client_server.py,sha256=RP9_7RKqEmGbGTd_hWOUGZe5o6oNMppiRRwgnsFoZ_o,2863
+faiss/contrib/clustering.py,sha256=muy5_CnZil0rkM15hLFSfaO78cLpgQoJnDqYaEnzLNM,12281
+faiss/contrib/datasets.py,sha256=wvB22o2wzaLTw_K-Bxgi7aNd0GpJeXLCrR3aLvnFhf0,12472
+faiss/contrib/evaluation.py,sha256=Rkwj-GnVNlNNdukvs9f4bwMH_i3dCbY1MKd4d3xJ8G4,15485
+faiss/contrib/exhaustive_search.py,sha256=NxK69OBtvORZMx58MlDUMpBrnxPKi2Gt-A7whW6MlSw,12605
+faiss/contrib/factory_tools.py,sha256=5iIg0zQ6IOAiP-uWCjalaFVCD_RzqinwbTnTsMTiCgM,5126
+faiss/contrib/inspect_tools.py,sha256=eCNiaxUVSn0XBVoLmYtJ0FgcrmJ33TObfScqGRzevbk,3653
+faiss/contrib/ivf_tools.py,sha256=87nFxLLaufXCBrnkIBik-RtAiZYHVBh0HQvLpGFhvlY,5020
+faiss/contrib/ondisk.py,sha256=vgim3MpwoN7jKz_w-mn8Mv4RHMMX926yRk-wm6v_07o,2089
+faiss/contrib/rpc.py,sha256=4ly7hzPJ7BkPWLA0NbydcdgsoY2qmfX7FhZ0rlkjF8c,7561
+faiss/contrib/torch_utils.py,sha256=ynBAQFIBwaflIaevBah9MJu5WIAxdDrrHU04JdRDp18,23846
+faiss/contrib/vecs_io.py,sha256=jz7qDJxcjSBLQXVbAgJnwVRYL_Wc-AaTA5mXYvmJB_c,1148
+faiss/extra_wrappers.py,sha256=hdQeMINOG1r_9IP5b0Ru6P0VEhT15wrXKfcIHDiOMdM,21049
+faiss/gpu_wrappers.py,sha256=WDUThCIzl_OvFC3qk28q25WLkIS7T8bZH6YCk2zjpCs,9489
+faiss/loader.py,sha256=rqS09AHypkhDmamZ5YMSwcmwlkBBssbaL22PLYraY8M,3697
+faiss/python_callbacks.h,sha256=Z8ySIYmI8qo9ySqJcd-YeDLRE5yu23gqcWwXQMwS8-E,1830
+faiss/setup.py,sha256=MjOtxcY2YS3tEIKkTU_lSu5VAFj1yDjwgAtrdxW1n4A,3225
+faiss/swigfaiss.i,sha256=Q__SWJN6fB0VM6t25dtoTiD2HKSiVWqecJraQQtzXY0,31866
+faiss/swigfaiss.py,sha256=_zKYA5MdyP70qOu8PI72EMHMqhqJAAIihxZuzwisP40,507609
+faiss/swigfaiss_avx2.py,sha256=XbEf81jykBs7S1AwLoo0Uwp8tC2xMHgNR1jyF4JI2GM,527669
+faiss_cpu-1.8.0.dist-info/DELVEWHEEL,sha256=1jyfuNGYwDbMeum7Rfh-caLVt9brvTnzvUQ2tMTstxQ,407
+faiss_cpu-1.8.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+faiss_cpu-1.8.0.dist-info/LICENSE,sha256=SJxdqdQ2exFo_NAY7cECLSMQJiwecF3aA-fbVYHJTC4,1092
+faiss_cpu-1.8.0.dist-info/METADATA,sha256=todvRsCbgN0ZFf5SW8Cx9s7wFFb8r0muQ485gTosr6U,3750
+faiss_cpu-1.8.0.dist-info/RECORD,,
+faiss_cpu-1.8.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+faiss_cpu-1.8.0.dist-info/WHEEL,sha256=ircjsfhzblqgSzO8ow7-0pXK-RVqDqNRGQ8F650AUNM,102
+faiss_cpu-1.8.0.dist-info/top_level.txt,sha256=nr2S-1YAhqAuAlFJukntDvRGXfI1KmwnUNs_iFlNiig,6
+faiss_cpu.libs/flang-d38962844214aa9b06fc3989f9adae5b.dll,sha256=p-OMoMwhfQk0V77Q13HSD0GecllsUlsoq5cHUsSQ12o,1679360
+faiss_cpu.libs/flangrti-5bbaf6aff159e72f9b015d5bc31c7584.dll,sha256=hjEIKL-p4aO4_sLvz5BUYGASxVkR8G46Hh5iiao31hQ,50688
+faiss_cpu.libs/libomp-26259cba665d756e8627cb8a206937cd.dll,sha256=spay6ExhTquWwHIW_jQb_PBjn6THYrURwdfeFbdwh_w,742912
+faiss_cpu.libs/libomp140.x86_64-21fc660a28479b04d9fec85174fc894e.dll,sha256=uopcjt-ef_24jRY4X0elDjJufjh27oYWnLZ2Rp1GTWY,772016
+faiss_cpu.libs/msvcp140-75f0e17aa84445df8d9f6c5be7aa31ac.dll,sha256=j1nF9clJpqZTLsG7o_4IX6jBVzVPZuyBZqCcxbfsrsg,621960
+faiss_cpu.libs/openblas-1ba25ee8d70fa3c45ede15bdc95fbee3.dll,sha256=PvrGUEfXqer7eTSY7hni78P10kgX0WGGs8J7MpPGiHs,28739072
diff --git a/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/REQUESTED b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/REQUESTED
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/WHEEL b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..d60b00472b6db035b28a0470c4bc8f72f5db2de0
--- /dev/null
+++ b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.42.0)
+Root-Is-Purelib: false
+Tag: cp311-cp311-win_amd64
+
diff --git a/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/top_level.txt b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..a38fbdc9b38998b943720997ac2c9f9f4e5ffcb2
--- /dev/null
+++ b/llm/Lib/site-packages/faiss_cpu-1.8.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+faiss
diff --git a/llm/Lib/site-packages/faiss_cpu.libs/flang-d38962844214aa9b06fc3989f9adae5b.dll b/llm/Lib/site-packages/faiss_cpu.libs/flang-d38962844214aa9b06fc3989f9adae5b.dll
new file mode 100644
index 0000000000000000000000000000000000000000..7a764884d3ddc27d7ccd409ab5bc9312185367db
--- /dev/null
+++ b/llm/Lib/site-packages/faiss_cpu.libs/flang-d38962844214aa9b06fc3989f9adae5b.dll
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a7e38ca0cc217d093457bed0d771d20f419e72596c525b28ab970752c490d76a
+size 1679360
diff --git a/llm/Lib/site-packages/faiss_cpu.libs/flangrti-5bbaf6aff159e72f9b015d5bc31c7584.dll b/llm/Lib/site-packages/faiss_cpu.libs/flangrti-5bbaf6aff159e72f9b015d5bc31c7584.dll
new file mode 100644
index 0000000000000000000000000000000000000000..00d2d9111078a3285f164492396c9c857df76851
Binary files /dev/null and b/llm/Lib/site-packages/faiss_cpu.libs/flangrti-5bbaf6aff159e72f9b015d5bc31c7584.dll differ
diff --git a/llm/Lib/site-packages/faiss_cpu.libs/libomp-26259cba665d756e8627cb8a206937cd.dll b/llm/Lib/site-packages/faiss_cpu.libs/libomp-26259cba665d756e8627cb8a206937cd.dll
new file mode 100644
index 0000000000000000000000000000000000000000..a0f3b1676954243482204991949e5d83cf339c33
Binary files /dev/null and b/llm/Lib/site-packages/faiss_cpu.libs/libomp-26259cba665d756e8627cb8a206937cd.dll differ
diff --git a/llm/Lib/site-packages/faiss_cpu.libs/libomp140.x86_64-21fc660a28479b04d9fec85174fc894e.dll b/llm/Lib/site-packages/faiss_cpu.libs/libomp140.x86_64-21fc660a28479b04d9fec85174fc894e.dll
new file mode 100644
index 0000000000000000000000000000000000000000..c20579a20b97ca243f376217128b2a2c278f024b
Binary files /dev/null and b/llm/Lib/site-packages/faiss_cpu.libs/libomp140.x86_64-21fc660a28479b04d9fec85174fc894e.dll differ
diff --git a/llm/Lib/site-packages/faiss_cpu.libs/msvcp140-75f0e17aa84445df8d9f6c5be7aa31ac.dll b/llm/Lib/site-packages/faiss_cpu.libs/msvcp140-75f0e17aa84445df8d9f6c5be7aa31ac.dll
new file mode 100644
index 0000000000000000000000000000000000000000..9a884663b03adeec5755f49038798007e378c273
Binary files /dev/null and b/llm/Lib/site-packages/faiss_cpu.libs/msvcp140-75f0e17aa84445df8d9f6c5be7aa31ac.dll differ
diff --git a/llm/Lib/site-packages/faiss_cpu.libs/openblas-1ba25ee8d70fa3c45ede15bdc95fbee3.dll b/llm/Lib/site-packages/faiss_cpu.libs/openblas-1ba25ee8d70fa3c45ede15bdc95fbee3.dll
new file mode 100644
index 0000000000000000000000000000000000000000..d1ee58289b55d3b62c19f0e4c6b0eb81e9815964
--- /dev/null
+++ b/llm/Lib/site-packages/faiss_cpu.libs/openblas-1ba25ee8d70fa3c45ede15bdc95fbee3.dll
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3efac65047d7a9eafb793498ee19e2efc3f5d24817d16186b3c27b3293c6887b
+size 28739072
diff --git a/llm/Lib/site-packages/filelock-3.13.4.dist-info/INSTALLER b/llm/Lib/site-packages/filelock-3.13.4.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/filelock-3.13.4.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/filelock-3.13.4.dist-info/METADATA b/llm/Lib/site-packages/filelock-3.13.4.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..e9fd3bc591c5778e2ffdd3110f93757fd5c25dc9
--- /dev/null
+++ b/llm/Lib/site-packages/filelock-3.13.4.dist-info/METADATA
@@ -0,0 +1,56 @@
+Metadata-Version: 2.3
+Name: filelock
+Version: 3.13.4
+Summary: A platform independent file lock.
+Project-URL: Documentation, https://py-filelock.readthedocs.io
+Project-URL: Homepage, https://github.com/tox-dev/py-filelock
+Project-URL: Source, https://github.com/tox-dev/py-filelock
+Project-URL: Tracker, https://github.com/tox-dev/py-filelock/issues
+Maintainer-email: Bernát Gábor <gaborjbernat@gmail.com>
+License-Expression: Unlicense
+License-File: LICENSE
+Keywords: application,cache,directory,log,user
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System
+Requires-Python: >=3.8
+Provides-Extra: docs
+Requires-Dist: furo>=2023.9.10; extra == 'docs'
+Requires-Dist: sphinx-autodoc-typehints!=1.23.4,>=1.25.2; extra == 'docs'
+Requires-Dist: sphinx>=7.2.6; extra == 'docs'
+Provides-Extra: testing
+Requires-Dist: covdefaults>=2.3; extra == 'testing'
+Requires-Dist: coverage>=7.3.2; extra == 'testing'
+Requires-Dist: diff-cover>=8.0.1; extra == 'testing'
+Requires-Dist: pytest-cov>=4.1; extra == 'testing'
+Requires-Dist: pytest-mock>=3.12; extra == 'testing'
+Requires-Dist: pytest-timeout>=2.2; extra == 'testing'
+Requires-Dist: pytest>=7.4.3; extra == 'testing'
+Provides-Extra: typing
+Requires-Dist: typing-extensions>=4.8; (python_version < '3.11') and extra == 'typing'
+Description-Content-Type: text/markdown
+
+# filelock
+
+[![PyPI](https://img.shields.io/pypi/v/filelock)](https://pypi.org/project/filelock/)
+[![Supported Python
+versions](https://img.shields.io/pypi/pyversions/filelock.svg)](https://pypi.org/project/filelock/)
+[![Documentation
+status](https://readthedocs.org/projects/py-filelock/badge/?version=latest)](https://py-filelock.readthedocs.io/en/latest/?badge=latest)
+[![Code style:
+black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Downloads](https://static.pepy.tech/badge/filelock/month)](https://pepy.tech/project/filelock)
+[![check](https://github.com/tox-dev/py-filelock/actions/workflows/check.yml/badge.svg)](https://github.com/tox-dev/py-filelock/actions/workflows/check.yml)
+
+For more information checkout the [official documentation](https://py-filelock.readthedocs.io/en/latest/index.html).
diff --git a/llm/Lib/site-packages/filelock-3.13.4.dist-info/RECORD b/llm/Lib/site-packages/filelock-3.13.4.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..59d24974fa8be6372deff8f156f342ce881a7e2c
--- /dev/null
+++ b/llm/Lib/site-packages/filelock-3.13.4.dist-info/RECORD
@@ -0,0 +1,22 @@
+filelock-3.13.4.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+filelock-3.13.4.dist-info/METADATA,sha256=id-2QR57cZ5P7lgQZdhd_xGLBlUrD1p_mFir6ITfRx4,2792
+filelock-3.13.4.dist-info/RECORD,,
+filelock-3.13.4.dist-info/WHEEL,sha256=as-1oFTWSeWBgyzh0O_qF439xqBe6AbBgt4MfYe5zwY,87
+filelock-3.13.4.dist-info/licenses/LICENSE,sha256=iNm062BXnBkew5HKBMFhMFctfu3EqG2qWL8oxuFMm80,1210
+filelock/__init__.py,sha256=c_wPy9Fo0fmqE4V448Q2A2dDYnMTZeAVHX-kUoN3KCY,1214
+filelock/__pycache__/__init__.cpython-311.pyc,,
+filelock/__pycache__/_api.cpython-311.pyc,,
+filelock/__pycache__/_error.cpython-311.pyc,,
+filelock/__pycache__/_soft.cpython-311.pyc,,
+filelock/__pycache__/_unix.cpython-311.pyc,,
+filelock/__pycache__/_util.cpython-311.pyc,,
+filelock/__pycache__/_windows.cpython-311.pyc,,
+filelock/__pycache__/version.cpython-311.pyc,,
+filelock/_api.py,sha256=rdQfF14SEH01ZoSQXdRm7CW7xGFUTBZyQytd8TySiio,12330
+filelock/_error.py,sha256=-5jMcjTu60YAvAO1UbqDD1GIEjVkwr8xCFwDBtMeYDg,787
+filelock/_soft.py,sha256=haqtc_TB_KJbYv2a8iuEAclKuM4fMG1vTcp28sK919c,1711
+filelock/_unix.py,sha256=-FXP0tjInBHUYygOlMpp4taUmD87QOkrD_4ybg_iT7Q,2259
+filelock/_util.py,sha256=QHBoNFIYfbAThhotH3Q8E2acFc84wpG49-T-uu017ZE,1715
+filelock/_windows.py,sha256=eMKL8dZKrgekf5VYVGR14an29JGEInRtUO8ui9ABywg,2177
+filelock/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+filelock/version.py,sha256=7_6ZiCN2IEbqvGolC1tvkUZXIMID8-9wKt9GAmhPeyU,413
diff --git a/llm/Lib/site-packages/filelock-3.13.4.dist-info/WHEEL b/llm/Lib/site-packages/filelock-3.13.4.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..8781814daf6f6e9eb407b0dd748ad19ed5f050a0
--- /dev/null
+++ b/llm/Lib/site-packages/filelock-3.13.4.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.22.5
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/filelock-3.13.4.dist-info/licenses/LICENSE b/llm/Lib/site-packages/filelock-3.13.4.dist-info/licenses/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..cf1ab25da0349f84a3fdd40032f0ce99db813b8b
--- /dev/null
+++ b/llm/Lib/site-packages/filelock-3.13.4.dist-info/licenses/LICENSE
@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <http://unlicense.org>
diff --git a/llm/Lib/site-packages/filelock/__init__.py b/llm/Lib/site-packages/filelock/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..006299d2188c5d642cf78cf19305e88c95ee01cb
--- /dev/null
+++ b/llm/Lib/site-packages/filelock/__init__.py
@@ -0,0 +1,52 @@
+"""
+A platform independent file lock that supports the with-statement.
+
+.. autodata:: filelock.__version__
+   :no-value:
+
+"""
+
+from __future__ import annotations
+
+import sys
+import warnings
+from typing import TYPE_CHECKING
+
+from ._api import AcquireReturnProxy, BaseFileLock
+from ._error import Timeout
+from ._soft import SoftFileLock
+from ._unix import UnixFileLock, has_fcntl
+from ._windows import WindowsFileLock
+from .version import version
+
+#: version of the project as a string
+__version__: str = version
+
+
+if sys.platform == "win32":  # pragma: win32 cover
+    _FileLock: type[BaseFileLock] = WindowsFileLock
+else:  # pragma: win32 no cover # noqa: PLR5501
+    if has_fcntl:
+        _FileLock: type[BaseFileLock] = UnixFileLock
+    else:
+        _FileLock = SoftFileLock
+        if warnings is not None:
+            warnings.warn("only soft file lock is available", stacklevel=2)
+
+if TYPE_CHECKING:
+    FileLock = SoftFileLock
+else:
+    #: Alias for the lock, which should be used for the current platform.
+    FileLock = _FileLock
+
+
+__all__ = [
+    "AcquireReturnProxy",
+    "BaseFileLock",
+    "FileLock",
+    "SoftFileLock",
+    "Timeout",
+    "UnixFileLock",
+    "WindowsFileLock",
+    "__version__",
+]
diff --git a/llm/Lib/site-packages/filelock/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/filelock/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d4c80847e8642fde2c1c9fd1c3bba7a52c5584b6
Binary files /dev/null and b/llm/Lib/site-packages/filelock/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/filelock/__pycache__/_api.cpython-311.pyc b/llm/Lib/site-packages/filelock/__pycache__/_api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d0ff6ebe162e38be5945f809d8b0c22e856f6730
Binary files /dev/null and b/llm/Lib/site-packages/filelock/__pycache__/_api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/filelock/__pycache__/_error.cpython-311.pyc b/llm/Lib/site-packages/filelock/__pycache__/_error.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a125abce2d9999ca4536016d4546949c54856fda
Binary files /dev/null and b/llm/Lib/site-packages/filelock/__pycache__/_error.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/filelock/__pycache__/_soft.cpython-311.pyc b/llm/Lib/site-packages/filelock/__pycache__/_soft.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dfbd59866d8b9bdced37d75ad03460e1ac47b3ca
Binary files /dev/null and b/llm/Lib/site-packages/filelock/__pycache__/_soft.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/filelock/__pycache__/_unix.cpython-311.pyc b/llm/Lib/site-packages/filelock/__pycache__/_unix.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5e2104945d13299b34b63bad69f47eea4277e7f6
Binary files /dev/null and b/llm/Lib/site-packages/filelock/__pycache__/_unix.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/filelock/__pycache__/_util.cpython-311.pyc b/llm/Lib/site-packages/filelock/__pycache__/_util.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c4814619a83bebe7b68afe35e4d055e2d5bd622a
Binary files /dev/null and b/llm/Lib/site-packages/filelock/__pycache__/_util.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/filelock/__pycache__/_windows.cpython-311.pyc b/llm/Lib/site-packages/filelock/__pycache__/_windows.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..29f11b0b9b12e851f597ffe3d58a8a04fadf0ae8
Binary files /dev/null and b/llm/Lib/site-packages/filelock/__pycache__/_windows.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/filelock/__pycache__/version.cpython-311.pyc b/llm/Lib/site-packages/filelock/__pycache__/version.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7410a3c03cf8a36ee32fe3ad375688e4cdd7002b
Binary files /dev/null and b/llm/Lib/site-packages/filelock/__pycache__/version.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/filelock/_api.py b/llm/Lib/site-packages/filelock/_api.py
new file mode 100644
index 0000000000000000000000000000000000000000..210b8c4138d70ac989401d9ca3fd6ab03e36c6eb
--- /dev/null
+++ b/llm/Lib/site-packages/filelock/_api.py
@@ -0,0 +1,341 @@
+from __future__ import annotations
+
+import contextlib
+import logging
+import os
+import time
+import warnings
+from abc import ABC, abstractmethod
+from dataclasses import dataclass
+from threading import local
+from typing import TYPE_CHECKING, Any
+from weakref import WeakValueDictionary
+
+from ._error import Timeout
+
+if TYPE_CHECKING:
+    import sys
+    from types import TracebackType
+
+    if sys.version_info >= (3, 11):  # pragma: no cover (py311+)
+        from typing import Self
+    else:  # pragma: no cover (<py311)
+        from typing_extensions import Self
+
+
+_LOGGER = logging.getLogger("filelock")
+
+
+# This is a helper class which is returned by :meth:`BaseFileLock.acquire` and wraps the lock to make sure __enter__
+# is not called twice when entering the with statement. If we would simply return *self*, the lock would be acquired
+# again in the *__enter__* method of the BaseFileLock, but not released again automatically. issue #37 (memory leak)
+class AcquireReturnProxy:
+    """A context-aware object that will release the lock file when exiting."""
+
+    def __init__(self, lock: BaseFileLock) -> None:
+        self.lock = lock
+
+    def __enter__(self) -> BaseFileLock:
+        return self.lock
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_value: BaseException | None,
+        traceback: TracebackType | None,
+    ) -> None:
+        self.lock.release()
+
+
+@dataclass
+class FileLockContext:
+    """A dataclass which holds the context for a ``BaseFileLock`` object."""
+
+    # The context is held in a separate class to allow optional use of thread local storage via the
+    # ThreadLocalFileContext class.
+
+    #: The path to the lock file.
+    lock_file: str
+
+    #: The default timeout value.
+    timeout: float
+
+    #: The mode for the lock files
+    mode: int
+
+    #: The file descriptor for the *_lock_file* as it is returned by the os.open() function, not None when lock held
+    lock_file_fd: int | None = None
+
+    #: The lock counter is used for implementing the nested locking mechanism.
+    lock_counter: int = 0  # When the lock is acquired is increased and the lock is only released, when this value is 0
+
+
+class ThreadLocalFileContext(FileLockContext, local):
+    """A thread local version of the ``FileLockContext`` class."""
+
+
+class BaseFileLock(ABC, contextlib.ContextDecorator):
+    """Abstract base class for a file lock object."""
+
+    _instances: WeakValueDictionary[str, BaseFileLock]
+
+    def __new__(  # noqa: PLR0913
+        cls,
+        lock_file: str | os.PathLike[str],
+        timeout: float = -1,
+        mode: int = 0o644,
+        thread_local: bool = True,  # noqa: ARG003, FBT001, FBT002
+        *,
+        is_singleton: bool = False,
+        **kwargs: dict[str, Any],  # capture remaining kwargs for subclasses  # noqa: ARG003
+    ) -> Self:
+        """Create a new lock object or if specified return the singleton instance for the lock file."""
+        if not is_singleton:
+            return super().__new__(cls)
+
+        instance = cls._instances.get(str(lock_file))
+        if not instance:
+            instance = super().__new__(cls)
+            cls._instances[str(lock_file)] = instance
+        elif timeout != instance.timeout or mode != instance.mode:
+            msg = "Singleton lock instances cannot be initialized with differing arguments"
+            raise ValueError(msg)
+
+        return instance  # type: ignore[return-value] # https://github.com/python/mypy/issues/15322
+
+    def __init_subclass__(cls, **kwargs: dict[str, Any]) -> None:
+        """Setup unique state for lock subclasses."""
+        super().__init_subclass__(**kwargs)
+        cls._instances = WeakValueDictionary()
+
+    def __init__(  # noqa: PLR0913
+        self,
+        lock_file: str | os.PathLike[str],
+        timeout: float = -1,
+        mode: int = 0o644,
+        thread_local: bool = True,  # noqa: FBT001, FBT002
+        *,
+        is_singleton: bool = False,
+    ) -> None:
+        """
+        Create a new lock object.
+
+        :param lock_file: path to the file
+        :param timeout: default timeout when acquiring the lock, in seconds. It will be used as fallback value in \
+            the acquire method, if no timeout value (``None``) is given. If you want to disable the timeout, set it \
+            to a negative value. A timeout of 0 means that there is exactly one attempt to acquire the file lock.
+        :param mode: file permissions for the lockfile
+        :param thread_local: Whether this object's internal context should be thread local or not. If this is set to \
+            ``False`` then the lock will be reentrant across threads.
+        :param is_singleton: If this is set to ``True`` then only one instance of this class will be created \
+            per lock file. This is useful if you want to use the lock object for reentrant locking without needing \
+            to pass the same object around.
+
+        """
+        self._is_thread_local = thread_local
+        self._is_singleton = is_singleton
+
+        # Create the context. Note that external code should not work with the context directly  and should instead use
+        # properties of this class.
+        kwargs: dict[str, Any] = {
+            "lock_file": os.fspath(lock_file),
+            "timeout": timeout,
+            "mode": mode,
+        }
+        self._context: FileLockContext = (ThreadLocalFileContext if thread_local else FileLockContext)(**kwargs)
+
+    def is_thread_local(self) -> bool:
+        """:return: a flag indicating if this lock is thread local or not"""
+        return self._is_thread_local
+
+    @property
+    def is_singleton(self) -> bool:
+        """:return: a flag indicating if this lock is singleton or not"""
+        return self._is_singleton
+
+    @property
+    def lock_file(self) -> str:
+        """:return: path to the lock file"""
+        return self._context.lock_file
+
+    @property
+    def timeout(self) -> float:
+        """
+        :return: the default timeout value, in seconds
+
+        .. versionadded:: 2.0.0
+        """
+        return self._context.timeout
+
+    @timeout.setter
+    def timeout(self, value: float | str) -> None:
+        """
+        Change the default timeout value.
+
+        :param value: the new value, in seconds
+
+        """
+        self._context.timeout = float(value)
+
+    @property
+    def mode(self) -> int:
+        """:return: the file permissions for the lockfile"""
+        return self._context.mode
+
+    @abstractmethod
+    def _acquire(self) -> None:
+        """If the file lock could be acquired, self._context.lock_file_fd holds the file descriptor of the lock file."""
+        raise NotImplementedError
+
+    @abstractmethod
+    def _release(self) -> None:
+        """Releases the lock and sets self._context.lock_file_fd to None."""
+        raise NotImplementedError
+
+    @property
+    def is_locked(self) -> bool:
+        """
+
+        :return: A boolean indicating if the lock file is holding the lock currently.
+
+        .. versionchanged:: 2.0.0
+
+            This was previously a method and is now a property.
+        """
+        return self._context.lock_file_fd is not None
+
+    @property
+    def lock_counter(self) -> int:
+        """:return: The number of times this lock has been acquired (but not yet released)."""
+        return self._context.lock_counter
+
+    def acquire(
+        self,
+        timeout: float | None = None,
+        poll_interval: float = 0.05,
+        *,
+        poll_intervall: float | None = None,
+        blocking: bool = True,
+    ) -> AcquireReturnProxy:
+        """
+        Try to acquire the file lock.
+
+        :param timeout: maximum wait time for acquiring the lock, ``None`` means use the default :attr:`~timeout` is and
+         if ``timeout < 0``, there is no timeout and this method will block until the lock could be acquired
+        :param poll_interval: interval of trying to acquire the lock file
+        :param poll_intervall: deprecated, kept for backwards compatibility, use ``poll_interval`` instead
+        :param blocking: defaults to True. If False, function will return immediately if it cannot obtain a lock on the
+         first attempt. Otherwise, this method will block until the timeout expires or the lock is acquired.
+        :raises Timeout: if fails to acquire lock within the timeout period
+        :return: a context object that will unlock the file when the context is exited
+
+        .. code-block:: python
+
+            # You can use this method in the context manager (recommended)
+            with lock.acquire():
+                pass
+
+            # Or use an equivalent try-finally construct:
+            lock.acquire()
+            try:
+                pass
+            finally:
+                lock.release()
+
+        .. versionchanged:: 2.0.0
+
+            This method returns now a *proxy* object instead of *self*,
+            so that it can be used in a with statement without side effects.
+
+        """
+        # Use the default timeout, if no timeout is provided.
+        if timeout is None:
+            timeout = self._context.timeout
+
+        if poll_intervall is not None:
+            msg = "use poll_interval instead of poll_intervall"
+            warnings.warn(msg, DeprecationWarning, stacklevel=2)
+            poll_interval = poll_intervall
+
+        # Increment the number right at the beginning. We can still undo it, if something fails.
+        self._context.lock_counter += 1
+
+        lock_id = id(self)
+        lock_filename = self.lock_file
+        start_time = time.perf_counter()
+        try:
+            while True:
+                if not self.is_locked:
+                    _LOGGER.debug("Attempting to acquire lock %s on %s", lock_id, lock_filename)
+                    self._acquire()
+                if self.is_locked:
+                    _LOGGER.debug("Lock %s acquired on %s", lock_id, lock_filename)
+                    break
+                if blocking is False:
+                    _LOGGER.debug("Failed to immediately acquire lock %s on %s", lock_id, lock_filename)
+                    raise Timeout(lock_filename)  # noqa: TRY301
+                if 0 <= timeout < time.perf_counter() - start_time:
+                    _LOGGER.debug("Timeout on acquiring lock %s on %s", lock_id, lock_filename)
+                    raise Timeout(lock_filename)  # noqa: TRY301
+                msg = "Lock %s not acquired on %s, waiting %s seconds ..."
+                _LOGGER.debug(msg, lock_id, lock_filename, poll_interval)
+                time.sleep(poll_interval)
+        except BaseException:  # Something did go wrong, so decrement the counter.
+            self._context.lock_counter = max(0, self._context.lock_counter - 1)
+            raise
+        return AcquireReturnProxy(lock=self)
+
+    def release(self, force: bool = False) -> None:  # noqa: FBT001, FBT002
+        """
+        Releases the file lock. Please note, that the lock is only completely released, if the lock counter is 0.
+        Also note, that the lock file itself is not automatically deleted.
+
+        :param force: If true, the lock counter is ignored and the lock is released in every case/
+
+        """
+        if self.is_locked:
+            self._context.lock_counter -= 1
+
+            if self._context.lock_counter == 0 or force:
+                lock_id, lock_filename = id(self), self.lock_file
+
+                _LOGGER.debug("Attempting to release lock %s on %s", lock_id, lock_filename)
+                self._release()
+                self._context.lock_counter = 0
+                _LOGGER.debug("Lock %s released on %s", lock_id, lock_filename)
+
+    def __enter__(self) -> Self:
+        """
+        Acquire the lock.
+
+        :return: the lock object
+
+        """
+        self.acquire()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_value: BaseException | None,
+        traceback: TracebackType | None,
+    ) -> None:
+        """
+        Release the lock.
+
+        :param exc_type: the exception type if raised
+        :param exc_value: the exception value if raised
+        :param traceback: the exception traceback if raised
+
+        """
+        self.release()
+
+    def __del__(self) -> None:
+        """Called when the lock object is deleted."""
+        self.release(force=True)
+
+
+__all__ = [
+    "AcquireReturnProxy",
+    "BaseFileLock",
+]
diff --git a/llm/Lib/site-packages/filelock/_error.py b/llm/Lib/site-packages/filelock/_error.py
new file mode 100644
index 0000000000000000000000000000000000000000..f7ff08c0f508ad7077eb6ed1990898840c952b3a
--- /dev/null
+++ b/llm/Lib/site-packages/filelock/_error.py
@@ -0,0 +1,30 @@
+from __future__ import annotations
+
+from typing import Any
+
+
+class Timeout(TimeoutError):  # noqa: N818
+    """Raised when the lock could not be acquired in *timeout* seconds."""
+
+    def __init__(self, lock_file: str) -> None:
+        super().__init__()
+        self._lock_file = lock_file
+
+    def __reduce__(self) -> str | tuple[Any, ...]:
+        return self.__class__, (self._lock_file,)  # Properly pickle the exception
+
+    def __str__(self) -> str:
+        return f"The file lock '{self._lock_file}' could not be acquired."
+
+    def __repr__(self) -> str:
+        return f"{self.__class__.__name__}({self.lock_file!r})"
+
+    @property
+    def lock_file(self) -> str:
+        """:return: The path of the file lock."""
+        return self._lock_file
+
+
+__all__ = [
+    "Timeout",
+]
diff --git a/llm/Lib/site-packages/filelock/_soft.py b/llm/Lib/site-packages/filelock/_soft.py
new file mode 100644
index 0000000000000000000000000000000000000000..28c67f74cc82b8f55e47afd6a71972cc1fb95eb6
--- /dev/null
+++ b/llm/Lib/site-packages/filelock/_soft.py
@@ -0,0 +1,47 @@
+from __future__ import annotations
+
+import os
+import sys
+from contextlib import suppress
+from errno import EACCES, EEXIST
+from pathlib import Path
+
+from ._api import BaseFileLock
+from ._util import ensure_directory_exists, raise_on_not_writable_file
+
+
+class SoftFileLock(BaseFileLock):
+    """Simply watches the existence of the lock file."""
+
+    def _acquire(self) -> None:
+        raise_on_not_writable_file(self.lock_file)
+        ensure_directory_exists(self.lock_file)
+        # first check for exists and read-only mode as the open will mask this case as EEXIST
+        flags = (
+            os.O_WRONLY  # open for writing only
+            | os.O_CREAT
+            | os.O_EXCL  # together with above raise EEXIST if the file specified by filename exists
+            | os.O_TRUNC  # truncate the file to zero byte
+        )
+        try:
+            file_handler = os.open(self.lock_file, flags, self._context.mode)
+        except OSError as exception:  # re-raise unless expected exception
+            if not (
+                exception.errno == EEXIST  # lock already exist
+                or (exception.errno == EACCES and sys.platform == "win32")  # has no access to this lock
+            ):  # pragma: win32 no cover
+                raise
+        else:
+            self._context.lock_file_fd = file_handler
+
+    def _release(self) -> None:
+        assert self._context.lock_file_fd is not None  # noqa: S101
+        os.close(self._context.lock_file_fd)  # the lock file is definitely not None
+        self._context.lock_file_fd = None
+        with suppress(OSError):  # the file is already deleted and that's what we want
+            Path(self.lock_file).unlink()
+
+
+__all__ = [
+    "SoftFileLock",
+]
diff --git a/llm/Lib/site-packages/filelock/_unix.py b/llm/Lib/site-packages/filelock/_unix.py
new file mode 100644
index 0000000000000000000000000000000000000000..4ae1fbe916f95762418cd62251f91f74ba35fc8c
--- /dev/null
+++ b/llm/Lib/site-packages/filelock/_unix.py
@@ -0,0 +1,68 @@
+from __future__ import annotations
+
+import os
+import sys
+from contextlib import suppress
+from errno import ENOSYS
+from pathlib import Path
+from typing import cast
+
+from ._api import BaseFileLock
+from ._util import ensure_directory_exists
+
+#: a flag to indicate if the fcntl API is available
+has_fcntl = False
+if sys.platform == "win32":  # pragma: win32 cover
+
+    class UnixFileLock(BaseFileLock):
+        """Uses the :func:`fcntl.flock` to hard lock the lock file on unix systems."""
+
+        def _acquire(self) -> None:
+            raise NotImplementedError
+
+        def _release(self) -> None:
+            raise NotImplementedError
+
+else:  # pragma: win32 no cover
+    try:
+        import fcntl
+    except ImportError:
+        pass
+    else:
+        has_fcntl = True
+
+    class UnixFileLock(BaseFileLock):
+        """Uses the :func:`fcntl.flock` to hard lock the lock file on unix systems."""
+
+        def _acquire(self) -> None:
+            ensure_directory_exists(self.lock_file)
+            open_flags = os.O_RDWR | os.O_TRUNC
+            if not Path(self.lock_file).exists():
+                open_flags |= os.O_CREAT
+            fd = os.open(self.lock_file, open_flags, self._context.mode)
+            with suppress(PermissionError):  # This locked is not owned by this UID
+                os.fchmod(fd, self._context.mode)
+            try:
+                fcntl.flock(fd, fcntl.LOCK_EX | fcntl.LOCK_NB)
+            except OSError as exception:
+                os.close(fd)
+                if exception.errno == ENOSYS:  # NotImplemented error
+                    msg = "FileSystem does not appear to support flock; use SoftFileLock instead"
+                    raise NotImplementedError(msg) from exception
+            else:
+                self._context.lock_file_fd = fd
+
+        def _release(self) -> None:
+            # Do not remove the lockfile:
+            #   https://github.com/tox-dev/py-filelock/issues/31
+            #   https://stackoverflow.com/questions/17708885/flock-removing-locked-file-without-race-condition
+            fd = cast(int, self._context.lock_file_fd)
+            self._context.lock_file_fd = None
+            fcntl.flock(fd, fcntl.LOCK_UN)
+            os.close(fd)
+
+
+__all__ = [
+    "UnixFileLock",
+    "has_fcntl",
+]
diff --git a/llm/Lib/site-packages/filelock/_util.py b/llm/Lib/site-packages/filelock/_util.py
new file mode 100644
index 0000000000000000000000000000000000000000..c671e8533873948f0e1b5575ff952c722019f067
--- /dev/null
+++ b/llm/Lib/site-packages/filelock/_util.py
@@ -0,0 +1,52 @@
+from __future__ import annotations
+
+import os
+import stat
+import sys
+from errno import EACCES, EISDIR
+from pathlib import Path
+
+
+def raise_on_not_writable_file(filename: str) -> None:
+    """
+    Raise an exception if attempting to open the file for writing would fail.
+
+    This is done so files that will never be writable can be separated from files that are writable but currently
+    locked.
+
+    :param filename: file to check
+    :raises OSError: as if the file was opened for writing.
+
+    """
+    try:  # use stat to do exists + can write to check without race condition
+        file_stat = os.stat(filename)  # noqa: PTH116
+    except OSError:
+        return  # swallow does not exist or other errors
+
+    if file_stat.st_mtime != 0:  # if os.stat returns but modification is zero that's an invalid os.stat - ignore it
+        if not (file_stat.st_mode & stat.S_IWUSR):
+            raise PermissionError(EACCES, "Permission denied", filename)
+
+        if stat.S_ISDIR(file_stat.st_mode):
+            if sys.platform == "win32":  # pragma: win32 cover
+                # On Windows, this is PermissionError
+                raise PermissionError(EACCES, "Permission denied", filename)
+            else:  # pragma: win32 no cover # noqa: RET506
+                # On linux / macOS, this is IsADirectoryError
+                raise IsADirectoryError(EISDIR, "Is a directory", filename)
+
+
+def ensure_directory_exists(filename: Path | str) -> None:
+    """
+    Ensure the directory containing the file exists (create it if necessary).
+
+    :param filename: file.
+
+    """
+    Path(filename).parent.mkdir(parents=True, exist_ok=True)
+
+
+__all__ = [
+    "ensure_directory_exists",
+    "raise_on_not_writable_file",
+]
diff --git a/llm/Lib/site-packages/filelock/_windows.py b/llm/Lib/site-packages/filelock/_windows.py
new file mode 100644
index 0000000000000000000000000000000000000000..8db55dcbaa3e7bab091781b17ce22fde1fc239f2
--- /dev/null
+++ b/llm/Lib/site-packages/filelock/_windows.py
@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+import os
+import sys
+from contextlib import suppress
+from errno import EACCES
+from pathlib import Path
+from typing import cast
+
+from ._api import BaseFileLock
+from ._util import ensure_directory_exists, raise_on_not_writable_file
+
+if sys.platform == "win32":  # pragma: win32 cover
+    import msvcrt
+
+    class WindowsFileLock(BaseFileLock):
+        """Uses the :func:`msvcrt.locking` function to hard lock the lock file on Windows systems."""
+
+        def _acquire(self) -> None:
+            raise_on_not_writable_file(self.lock_file)
+            ensure_directory_exists(self.lock_file)
+            flags = (
+                os.O_RDWR  # open for read and write
+                | os.O_CREAT  # create file if not exists
+                | os.O_TRUNC  # truncate file if not empty
+            )
+            try:
+                fd = os.open(self.lock_file, flags, self._context.mode)
+            except OSError as exception:
+                if exception.errno != EACCES:  # has no access to this lock
+                    raise
+            else:
+                try:
+                    msvcrt.locking(fd, msvcrt.LK_NBLCK, 1)
+                except OSError as exception:
+                    os.close(fd)  # close file first
+                    if exception.errno != EACCES:  # file is already locked
+                        raise
+                else:
+                    self._context.lock_file_fd = fd
+
+        def _release(self) -> None:
+            fd = cast(int, self._context.lock_file_fd)
+            self._context.lock_file_fd = None
+            msvcrt.locking(fd, msvcrt.LK_UNLCK, 1)
+            os.close(fd)
+
+            with suppress(OSError):  # Probably another instance of the application hat acquired the file lock.
+                Path(self.lock_file).unlink()
+
+else:  # pragma: win32 no cover
+
+    class WindowsFileLock(BaseFileLock):
+        """Uses the :func:`msvcrt.locking` function to hard lock the lock file on Windows systems."""
+
+        def _acquire(self) -> None:
+            raise NotImplementedError
+
+        def _release(self) -> None:
+            raise NotImplementedError
+
+
+__all__ = [
+    "WindowsFileLock",
+]
diff --git a/llm/Lib/site-packages/filelock/py.typed b/llm/Lib/site-packages/filelock/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/filelock/version.py b/llm/Lib/site-packages/filelock/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..cf2a247c31b187acc0502a58ec7062029e31f0fe
--- /dev/null
+++ b/llm/Lib/site-packages/filelock/version.py
@@ -0,0 +1,16 @@
+# file generated by setuptools_scm
+# don't change, don't track in version control
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple, Union
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+else:
+    VERSION_TUPLE = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+
+__version__ = version = '3.13.4'
+__version_tuple__ = version_tuple = (3, 13, 4)
diff --git a/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/INSTALLER b/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/LICENSE b/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..7082a2d5b9047bfc09589f387053e24ea490bc54
--- /dev/null
+++ b/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/LICENSE
@@ -0,0 +1,201 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2013-2019 Nikolay Kim and Andrew Svetlov
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/METADATA b/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..1b6f3e7dfde5077c52a0130c5a37cb0fb605f59e
--- /dev/null
+++ b/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/METADATA
@@ -0,0 +1,420 @@
+Metadata-Version: 2.1
+Name: frozenlist
+Version: 1.4.1
+Summary: A list-like structure which implements collections.abc.MutableSequence
+Home-page: https://github.com/aio-libs/frozenlist
+Maintainer: aiohttp team <team@aiohttp.org>
+Maintainer-email: team@aiohttp.org
+License: Apache 2
+Project-URL: Chat: Matrix, https://matrix.to/#/#aio-libs:matrix.org
+Project-URL: Chat: Matrix Space, https://matrix.to/#/#aio-libs-space:matrix.org
+Project-URL: CI: Github Actions, https://github.com/aio-libs/frozenlist/actions
+Project-URL: Code of Conduct, https://github.com/aio-libs/.github/blob/master/CODE_OF_CONDUCT.md
+Project-URL: Coverage: codecov, https://codecov.io/github/aio-libs/frozenlist
+Project-URL: Docs: Changelog, https://github.com/aio-libs/frozenlist/blob/master/CHANGES.rst#changelog
+Project-URL: Docs: RTD, https://frozenlist.aio-libs.org
+Project-URL: GitHub: issues, https://github.com/aio-libs/frozenlist/issues
+Project-URL: GitHub: repo, https://github.com/aio-libs/frozenlist
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Cython
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+
+frozenlist
+==========
+
+.. image:: https://github.com/aio-libs/frozenlist/workflows/CI/badge.svg
+   :target: https://github.com/aio-libs/frozenlist/actions
+   :alt: GitHub status for master branch
+
+.. image:: https://codecov.io/gh/aio-libs/frozenlist/branch/master/graph/badge.svg
+   :target: https://codecov.io/gh/aio-libs/frozenlist
+   :alt: codecov.io status for master branch
+
+.. image:: https://img.shields.io/pypi/v/frozenlist.svg?logo=Python&logoColor=white
+   :target: https://pypi.org/project/frozenlist
+   :alt: frozenlist @ PyPI
+
+.. image:: https://readthedocs.org/projects/frozenlist/badge/?version=latest
+   :target: https://frozenlist.aio-libs.org
+   :alt: Read The Docs build status badge
+
+.. image:: https://img.shields.io/matrix/aio-libs:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat
+   :target: https://matrix.to/#/%23aio-libs:matrix.org
+   :alt: Matrix Room — #aio-libs:matrix.org
+
+.. image:: https://img.shields.io/matrix/aio-libs-space:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs-space%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat
+   :target: https://matrix.to/#/%23aio-libs-space:matrix.org
+   :alt: Matrix Space — #aio-libs-space:matrix.org
+
+Introduction
+------------
+
+``frozenlist.FrozenList`` is a list-like structure which implements
+``collections.abc.MutableSequence``. The list is *mutable* until ``FrozenList.freeze``
+is called, after which list modifications raise ``RuntimeError``:
+
+
+>>> from frozenlist import FrozenList
+>>> fl = FrozenList([17, 42])
+>>> fl.append('spam')
+>>> fl.append('Vikings')
+>>> fl
+<FrozenList(frozen=False, [17, 42, 'spam', 'Vikings'])>
+>>> fl.freeze()
+>>> fl
+<FrozenList(frozen=True, [17, 42, 'spam', 'Vikings'])>
+>>> fl.frozen
+True
+>>> fl.append("Monty")
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+  File "frozenlist/_frozenlist.pyx", line 97, in frozenlist._frozenlist.FrozenList.append
+    self._check_frozen()
+  File "frozenlist/_frozenlist.pyx", line 19, in frozenlist._frozenlist.FrozenList._check_frozen
+    raise RuntimeError("Cannot modify frozen list.")
+RuntimeError: Cannot modify frozen list.
+
+
+FrozenList is also hashable, but only when frozen. Otherwise it also throws a RuntimeError:
+
+
+>>> fl = FrozenList([17, 42, 'spam'])
+>>> hash(fl)
+Traceback (most recent call last):
+  File "<stdin>", line 1, in <module>
+  File "frozenlist/_frozenlist.pyx", line 111, in frozenlist._frozenlist.FrozenList.__hash__
+    raise RuntimeError("Cannot hash unfrozen list.")
+RuntimeError: Cannot hash unfrozen list.
+>>> fl.freeze()
+>>> hash(fl)
+3713081631934410656
+>>> dictionary = {fl: 'Vikings'} # frozen fl can be a dict key
+>>> dictionary
+{<FrozenList(frozen=True, [1, 2])>: 'Vikings'}
+
+
+Installation
+------------
+
+::
+
+   $ pip install frozenlist
+
+The library requires Python 3.8 or newer.
+
+
+Documentation
+-------------
+
+https://frozenlist.aio-libs.org
+
+Communication channels
+----------------------
+
+We have a *Matrix Space* `#aio-libs-space:matrix.org
+<https://matrix.to/#/%23aio-libs-space:matrix.org>`_ which is
+also accessible via Gitter.
+
+Requirements
+------------
+
+- Python >= 3.8
+
+License
+-------
+
+``frozenlist`` is offered under the Apache 2 license.
+
+Source code
+-----------
+
+The project is hosted on GitHub_
+
+Please file an issue in the `bug tracker
+<https://github.com/aio-libs/frozenlist/issues>`_ if you have found a bug
+or have some suggestions to improve the library.
+
+.. _GitHub: https://github.com/aio-libs/frozenlist
+
+=========
+Changelog
+=========
+
+..
+    You should *NOT* be adding new change log entries to this file, this
+    file is managed by towncrier. You *may* edit previous change logs to
+    fix problems like typo corrections or such.
+    To add a new change log entry, please see
+    https://pip.pypa.io/en/latest/development/contributing/#news-entries
+    we named the news folder "changes".
+
+    WARNING: Don't drop the next directive!
+
+.. towncrier release notes start
+
+1.4.1 (2023-12-15)
+==================
+
+Packaging updates and notes for downstreams
+-------------------------------------------
+
+- Declared Python 3.12 and PyPy 3.8-3.10 supported officially
+  in the distribution package metadata.
+
+
+  *Related issues and pull requests on GitHub:*
+  `#553 <https://github.com/aio-libs/yarl/issues/553>`__.
+
+- Replaced the packaging is replaced from an old-fashioned ``setup.py`` to an
+  in-tree `PEP 517 <https://peps.python.org/pep-517>`__ build backend -- by `@webknjaz <https://github.com/sponsors/webknjaz>`__.
+
+  Whenever the end-users or downstream packagers need to build ``frozenlist``
+  from source (a Git checkout or an sdist), they may pass a ``config_settings``
+  flag ``pure-python``. If this flag is not set, a C-extension will be built
+  and included into the distribution.
+
+  Here is how this can be done with ``pip``:
+
+  .. code-block:: console
+
+      $ python3 -m pip install . --config-settings=pure-python=
+
+  This will also work with ``-e | --editable``.
+
+  The same can be achieved via ``pypa/build``:
+
+  .. code-block:: console
+
+      $ python3 -m build --config-setting=pure-python=
+
+  Adding ``-w | --wheel`` can force ``pypa/build`` produce a wheel from source
+  directly, as opposed to building an ``sdist`` and then building from it.
+
+
+  *Related issues and pull requests on GitHub:*
+  `#560 <https://github.com/aio-libs/yarl/issues/560>`__.
+
+
+Contributor-facing changes
+--------------------------
+
+- It is now possible to request line tracing in Cython builds using the
+  ``with-cython-tracing`` `PEP 517 <https://peps.python.org/pep-517>`__ config setting
+  -- `@webknjaz <https://github.com/sponsors/webknjaz>`__.
+
+  This can be used in CI and development environment to measure coverage
+  on Cython modules, but is not normally useful to the end-users or
+  downstream packagers.
+
+  Here's a usage example:
+
+  .. code-block:: console
+
+      $ python3 -Im pip install . --config-settings=with-cython-tracing=true
+
+  For editable installs, this setting is on by default. Otherwise, it's
+  off unless requested explicitly.
+
+  The following produces C-files required for the Cython coverage
+  plugin to map the measurements back to the PYX-files:
+
+  .. code-block:: console
+
+      $ python -Im pip install -e .
+
+  Alternatively, the ``FROZENLIST_CYTHON_TRACING=1`` environment variable
+  can be set to do the same as the `PEP 517 <https://peps.python.org/pep-517>`__ config setting.
+
+
+  *Related issues and pull requests on GitHub:*
+  `#560 <https://github.com/aio-libs/yarl/issues/560>`__.
+
+- Coverage collection has been implemented for the Cython modules
+  -- by `@webknjaz <https://github.com/sponsors/webknjaz>`__.
+
+  It will also be reported to Codecov from any non-release CI jobs.
+
+
+  *Related issues and pull requests on GitHub:*
+  `#561 <https://github.com/aio-libs/yarl/issues/561>`__.
+
+- A step-by-step ``Release Guide`` guide has
+  been added, describing how to release *frozenlist* -- by `@webknjaz <https://github.com/sponsors/webknjaz>`__.
+
+  This is primarily targeting the maintainers.
+
+
+  *Related issues and pull requests on GitHub:*
+  `#563 <https://github.com/aio-libs/yarl/issues/563>`__.
+
+- Detailed ``Contributing Guidelines`` on
+  authoring the changelog fragments have been published in the
+  documentation -- by `@webknjaz <https://github.com/sponsors/webknjaz>`__.
+
+
+  *Related issues and pull requests on GitHub:*
+  `#564 <https://github.com/aio-libs/yarl/issues/564>`__.
+
+
+----
+
+
+1.4.0 (2023-07-12)
+==================
+
+The published source distribution package became buildable
+under Python 3.12.
+
+
+----
+
+
+Bugfixes
+--------
+
+- Removed an unused ``typing.Tuple`` import
+  `#411 <https://github.com/aio-libs/frozenlist/issues/411>`_
+
+
+Deprecations and Removals
+-------------------------
+
+- Dropped Python 3.7 support.
+  `#413 <https://github.com/aio-libs/frozenlist/issues/413>`_
+
+
+Misc
+----
+
+- `#410 <https://github.com/aio-libs/frozenlist/issues/410>`_, `#433 <https://github.com/aio-libs/frozenlist/issues/433>`_
+
+
+----
+
+
+1.3.3 (2022-11-08)
+==================
+
+- Fixed CI runs when creating a new release, where new towncrier versions
+  fail when the current version section is already present.
+
+
+----
+
+
+1.3.2 (2022-11-08)
+==================
+
+Misc
+----
+
+- Updated the CI runs to better check for test results and to avoid deprecated syntax. `#327 <https://github.com/aio-libs/frozenlist/issues/327>`_
+
+
+----
+
+
+1.3.1 (2022-08-02)
+==================
+
+The published source distribution package became buildable
+under Python 3.11.
+
+
+----
+
+
+1.3.0 (2022-01-18)
+==================
+
+Bugfixes
+--------
+
+- Do not install C sources with binary distributions.
+  `#250 <https://github.com/aio-libs/frozenlist/issues/250>`_
+
+
+Deprecations and Removals
+-------------------------
+
+- Dropped Python 3.6 support
+  `#274 <https://github.com/aio-libs/frozenlist/issues/274>`_
+
+
+----
+
+
+1.2.0 (2021-10-16)
+==================
+
+Features
+--------
+
+- ``FrozenList`` now supports being used as a generic type as per PEP 585, e.g. ``frozen_int_list: FrozenList[int]`` (requires Python 3.9 or newer).
+  `#172 <https://github.com/aio-libs/frozenlist/issues/172>`_
+- Added support for Python 3.10.
+  `#227 <https://github.com/aio-libs/frozenlist/issues/227>`_
+- Started shipping platform-specific wheels with the ``musl`` tag targeting typical Alpine Linux runtimes.
+  `#227 <https://github.com/aio-libs/frozenlist/issues/227>`_
+- Started shipping platform-specific arm64 wheels for Apple Silicon.
+  `#227 <https://github.com/aio-libs/frozenlist/issues/227>`_
+
+
+----
+
+
+1.1.1 (2020-11-14)
+==================
+
+Bugfixes
+--------
+
+- Provide x86 Windows wheels.
+  `#169 <https://github.com/aio-libs/frozenlist/issues/169>`_
+
+
+----
+
+
+1.1.0 (2020-10-13)
+==================
+
+Features
+--------
+
+- Add support for hashing of a frozen list.
+  `#136 <https://github.com/aio-libs/frozenlist/issues/136>`_
+
+- Support Python 3.8 and 3.9.
+
+- Provide wheels for ``aarch64``, ``i686``, ``ppc64le``, ``s390x`` architectures on
+  Linux as well as ``x86_64``.
+
+
+----
+
+
+1.0.0 (2019-11-09)
+==================
+
+Deprecations and Removals
+-------------------------
+
+- Dropped support for Python 3.5; only 3.6, 3.7 and 3.8 are supported going forward.
+  `#24 <https://github.com/aio-libs/frozenlist/issues/24>`_
diff --git a/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/RECORD b/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..104ff619238e2c7abc64e36bf7be30d26e39e6d2
--- /dev/null
+++ b/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/RECORD
@@ -0,0 +1,12 @@
+frozenlist-1.4.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+frozenlist-1.4.1.dist-info/LICENSE,sha256=b9UkPpLdf5jsacesN3co50kFcJ_1J6W_mNbQJjwE9bY,11332
+frozenlist-1.4.1.dist-info/METADATA,sha256=WdGawzRX-kmYknJIJ9gpGgcerMabLYAsSKg62FF8258,12556
+frozenlist-1.4.1.dist-info/RECORD,,
+frozenlist-1.4.1.dist-info/WHEEL,sha256=badvNS-y9fEq0X-qzdZYvql_JFjI7Xfw-wR8FsjoK0I,102
+frozenlist-1.4.1.dist-info/top_level.txt,sha256=jivtxsPXA3nK3WBWW2LW5Mtu_GHt8UZA13NeCs2cKuA,11
+frozenlist/__init__.py,sha256=hrSQhfujMaz1BWlHfwuVFrPD02-pCK7jG4e9FaCZCmM,2316
+frozenlist/__init__.pyi,sha256=vMEoES1xGegPtVXoCi9XydEeHsyuIq-KdeXwP5PdsaA,1470
+frozenlist/__pycache__/__init__.cpython-311.pyc,,
+frozenlist/_frozenlist.cp311-win_amd64.pyd,sha256=D3U4RBwWaCSGGO4V0RQUzmhkLCy90WNrkD7O-s-IZS0,86016
+frozenlist/_frozenlist.pyx,sha256=9V4Z1En6TZwgFD26d-sjxyhUzUm338H1Qiz4-i5ukv0,2983
+frozenlist/py.typed,sha256=sow9soTwP9T_gEAQSVh7Gb8855h04Nwmhs2We-JRgZM,7
diff --git a/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/WHEEL b/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..6d160455a81f006d13b4485d8d1d7c5d50dc3a04
--- /dev/null
+++ b/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.41.2)
+Root-Is-Purelib: false
+Tag: cp311-cp311-win_amd64
+
diff --git a/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/top_level.txt b/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..52f13fc459edf8f3def6f792c432f0b64f313176
--- /dev/null
+++ b/llm/Lib/site-packages/frozenlist-1.4.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+frozenlist
diff --git a/llm/Lib/site-packages/frozenlist/__init__.py b/llm/Lib/site-packages/frozenlist/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c0f71368bab1a1bf44abe10d73a3e005c747a3bb
--- /dev/null
+++ b/llm/Lib/site-packages/frozenlist/__init__.py
@@ -0,0 +1,95 @@
+import os
+import sys
+import types
+from collections.abc import MutableSequence
+from functools import total_ordering
+from typing import Type
+
+__version__ = "1.4.1"
+
+__all__ = ("FrozenList", "PyFrozenList")  # type: Tuple[str, ...]
+
+
+NO_EXTENSIONS = bool(os.environ.get("FROZENLIST_NO_EXTENSIONS"))  # type: bool
+
+
+@total_ordering
+class FrozenList(MutableSequence):
+    __slots__ = ("_frozen", "_items")
+
+    if sys.version_info >= (3, 9):
+        __class_getitem__ = classmethod(types.GenericAlias)
+    else:
+
+        @classmethod
+        def __class_getitem__(cls: Type["FrozenList"]) -> Type["FrozenList"]:
+            return cls
+
+    def __init__(self, items=None):
+        self._frozen = False
+        if items is not None:
+            items = list(items)
+        else:
+            items = []
+        self._items = items
+
+    @property
+    def frozen(self):
+        return self._frozen
+
+    def freeze(self):
+        self._frozen = True
+
+    def __getitem__(self, index):
+        return self._items[index]
+
+    def __setitem__(self, index, value):
+        if self._frozen:
+            raise RuntimeError("Cannot modify frozen list.")
+        self._items[index] = value
+
+    def __delitem__(self, index):
+        if self._frozen:
+            raise RuntimeError("Cannot modify frozen list.")
+        del self._items[index]
+
+    def __len__(self):
+        return self._items.__len__()
+
+    def __iter__(self):
+        return self._items.__iter__()
+
+    def __reversed__(self):
+        return self._items.__reversed__()
+
+    def __eq__(self, other):
+        return list(self) == other
+
+    def __le__(self, other):
+        return list(self) <= other
+
+    def insert(self, pos, item):
+        if self._frozen:
+            raise RuntimeError("Cannot modify frozen list.")
+        self._items.insert(pos, item)
+
+    def __repr__(self):
+        return f"<FrozenList(frozen={self._frozen}, {self._items!r})>"
+
+    def __hash__(self):
+        if self._frozen:
+            return hash(tuple(self))
+        else:
+            raise RuntimeError("Cannot hash unfrozen list.")
+
+
+PyFrozenList = FrozenList
+
+
+if not NO_EXTENSIONS:
+    try:
+        from ._frozenlist import FrozenList as CFrozenList  # type: ignore
+    except ImportError:  # pragma: no cover
+        pass
+    else:
+        FrozenList = CFrozenList  # type: ignore
diff --git a/llm/Lib/site-packages/frozenlist/__init__.pyi b/llm/Lib/site-packages/frozenlist/__init__.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..ae803ef6aad72f57e7379db5a2044a95f214df7b
--- /dev/null
+++ b/llm/Lib/site-packages/frozenlist/__init__.pyi
@@ -0,0 +1,47 @@
+from typing import (
+    Generic,
+    Iterable,
+    Iterator,
+    List,
+    MutableSequence,
+    Optional,
+    TypeVar,
+    Union,
+    overload,
+)
+
+_T = TypeVar("_T")
+_Arg = Union[List[_T], Iterable[_T]]
+
+class FrozenList(MutableSequence[_T], Generic[_T]):
+    def __init__(self, items: Optional[_Arg[_T]] = None) -> None: ...
+    @property
+    def frozen(self) -> bool: ...
+    def freeze(self) -> None: ...
+    @overload
+    def __getitem__(self, i: int) -> _T: ...
+    @overload
+    def __getitem__(self, s: slice) -> FrozenList[_T]: ...
+    @overload
+    def __setitem__(self, i: int, o: _T) -> None: ...
+    @overload
+    def __setitem__(self, s: slice, o: Iterable[_T]) -> None: ...
+    @overload
+    def __delitem__(self, i: int) -> None: ...
+    @overload
+    def __delitem__(self, i: slice) -> None: ...
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[_T]: ...
+    def __reversed__(self) -> Iterator[_T]: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __le__(self, other: FrozenList[_T]) -> bool: ...
+    def __ne__(self, other: object) -> bool: ...
+    def __lt__(self, other: FrozenList[_T]) -> bool: ...
+    def __ge__(self, other: FrozenList[_T]) -> bool: ...
+    def __gt__(self, other: FrozenList[_T]) -> bool: ...
+    def insert(self, pos: int, item: _T) -> None: ...
+    def __repr__(self) -> str: ...
+    def __hash__(self) -> int: ...
+
+# types for C accelerators are the same
+CFrozenList = PyFrozenList = FrozenList
diff --git a/llm/Lib/site-packages/frozenlist/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/frozenlist/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..71aed815e476f8b17069e25d3ca1abf7dbddb110
Binary files /dev/null and b/llm/Lib/site-packages/frozenlist/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/frozenlist/_frozenlist.cp311-win_amd64.pyd b/llm/Lib/site-packages/frozenlist/_frozenlist.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..932a629483223fe4bc374491b47347cbbc22ca2b
Binary files /dev/null and b/llm/Lib/site-packages/frozenlist/_frozenlist.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/frozenlist/_frozenlist.pyx b/llm/Lib/site-packages/frozenlist/_frozenlist.pyx
new file mode 100644
index 0000000000000000000000000000000000000000..9ee846c1aeb17ac8521f44bcb8617f189b89e5fe
--- /dev/null
+++ b/llm/Lib/site-packages/frozenlist/_frozenlist.pyx
@@ -0,0 +1,123 @@
+import sys
+import types
+from collections.abc import MutableSequence
+
+
+cdef class FrozenList:
+
+    if sys.version_info >= (3, 9):
+        __class_getitem__ = classmethod(types.GenericAlias)
+    else:
+        @classmethod
+        def __class_getitem__(cls):
+            return cls
+
+    cdef readonly bint frozen
+    cdef list _items
+
+    def __init__(self, items=None):
+        self.frozen = False
+        if items is not None:
+            items = list(items)
+        else:
+            items = []
+        self._items = items
+
+    cdef object _check_frozen(self):
+        if self.frozen:
+            raise RuntimeError("Cannot modify frozen list.")
+
+    cdef inline object _fast_len(self):
+        return len(self._items)
+
+    def freeze(self):
+        self.frozen = True
+
+    def __getitem__(self, index):
+        return self._items[index]
+
+    def __setitem__(self, index, value):
+        self._check_frozen()
+        self._items[index] = value
+
+    def __delitem__(self, index):
+        self._check_frozen()
+        del self._items[index]
+
+    def __len__(self):
+        return self._fast_len()
+
+    def __iter__(self):
+        return self._items.__iter__()
+
+    def __reversed__(self):
+        return self._items.__reversed__()
+
+    def __richcmp__(self, other, op):
+        if op == 0:  # <
+            return list(self) < other
+        if op == 1:  # <=
+            return list(self) <= other
+        if op == 2:  # ==
+            return list(self) == other
+        if op == 3:  # !=
+            return list(self) != other
+        if op == 4:  # >
+            return list(self) > other
+        if op == 5:  # =>
+            return list(self) >= other
+
+    def insert(self, pos, item):
+        self._check_frozen()
+        self._items.insert(pos, item)
+
+    def __contains__(self, item):
+        return item in self._items
+
+    def __iadd__(self, items):
+        self._check_frozen()
+        self._items += list(items)
+        return self
+
+    def index(self, item):
+        return self._items.index(item)
+
+    def remove(self, item):
+        self._check_frozen()
+        self._items.remove(item)
+
+    def clear(self):
+        self._check_frozen()
+        self._items.clear()
+
+    def extend(self, items):
+        self._check_frozen()
+        self._items += list(items)
+
+    def reverse(self):
+        self._check_frozen()
+        self._items.reverse()
+
+    def pop(self, index=-1):
+        self._check_frozen()
+        return self._items.pop(index)
+
+    def append(self, item):
+        self._check_frozen()
+        return self._items.append(item)
+
+    def count(self, item):
+        return self._items.count(item)
+
+    def __repr__(self):
+        return '<FrozenList(frozen={}, {!r})>'.format(self.frozen,
+                                                      self._items)
+
+    def __hash__(self):
+        if self.frozen:
+            return hash(tuple(self._items))
+        else:
+            raise RuntimeError("Cannot hash unfrozen list.")
+
+
+MutableSequence.register(FrozenList)
diff --git a/llm/Lib/site-packages/frozenlist/py.typed b/llm/Lib/site-packages/frozenlist/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..f5642f79f21d872f010979dcf6f0c4a415acc19d
--- /dev/null
+++ b/llm/Lib/site-packages/frozenlist/py.typed
@@ -0,0 +1 @@
+Marker
diff --git a/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/INSTALLER b/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/LICENSE b/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..67590a5e5be5a5a2dde3fe53a7512e404a896c22
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/LICENSE
@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2018, Martin Durant
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/METADATA b/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..f885cd9222a0b1e67a0f676d20a9ea2c07553dfb
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/METADATA
@@ -0,0 +1,167 @@
+Metadata-Version: 2.1
+Name: fsspec
+Version: 2024.3.1
+Summary: File-system specification
+Home-page: https://github.com/fsspec/filesystem_spec
+Maintainer: Martin Durant
+Maintainer-email: mdurant@anaconda.com
+License: BSD
+Project-URL: Changelog, https://filesystem-spec.readthedocs.io/en/latest/changelog.html
+Project-URL: Documentation, https://filesystem-spec.readthedocs.io/en/latest/
+Keywords: file
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: abfs
+Requires-Dist: adlfs ; extra == 'abfs'
+Provides-Extra: adl
+Requires-Dist: adlfs ; extra == 'adl'
+Provides-Extra: arrow
+Requires-Dist: pyarrow >=1 ; extra == 'arrow'
+Provides-Extra: dask
+Requires-Dist: dask ; extra == 'dask'
+Requires-Dist: distributed ; extra == 'dask'
+Provides-Extra: devel
+Requires-Dist: pytest ; extra == 'devel'
+Requires-Dist: pytest-cov ; extra == 'devel'
+Provides-Extra: dropbox
+Requires-Dist: dropboxdrivefs ; extra == 'dropbox'
+Requires-Dist: requests ; extra == 'dropbox'
+Requires-Dist: dropbox ; extra == 'dropbox'
+Provides-Extra: entrypoints
+Provides-Extra: full
+Requires-Dist: adlfs ; extra == 'full'
+Requires-Dist: aiohttp !=4.0.0a0,!=4.0.0a1 ; extra == 'full'
+Requires-Dist: dask ; extra == 'full'
+Requires-Dist: distributed ; extra == 'full'
+Requires-Dist: dropbox ; extra == 'full'
+Requires-Dist: dropboxdrivefs ; extra == 'full'
+Requires-Dist: fusepy ; extra == 'full'
+Requires-Dist: gcsfs ; extra == 'full'
+Requires-Dist: libarchive-c ; extra == 'full'
+Requires-Dist: ocifs ; extra == 'full'
+Requires-Dist: panel ; extra == 'full'
+Requires-Dist: paramiko ; extra == 'full'
+Requires-Dist: pyarrow >=1 ; extra == 'full'
+Requires-Dist: pygit2 ; extra == 'full'
+Requires-Dist: requests ; extra == 'full'
+Requires-Dist: s3fs ; extra == 'full'
+Requires-Dist: smbprotocol ; extra == 'full'
+Requires-Dist: tqdm ; extra == 'full'
+Provides-Extra: fuse
+Requires-Dist: fusepy ; extra == 'fuse'
+Provides-Extra: gcs
+Requires-Dist: gcsfs ; extra == 'gcs'
+Provides-Extra: git
+Requires-Dist: pygit2 ; extra == 'git'
+Provides-Extra: github
+Requires-Dist: requests ; extra == 'github'
+Provides-Extra: gs
+Requires-Dist: gcsfs ; extra == 'gs'
+Provides-Extra: gui
+Requires-Dist: panel ; extra == 'gui'
+Provides-Extra: hdfs
+Requires-Dist: pyarrow >=1 ; extra == 'hdfs'
+Provides-Extra: http
+Requires-Dist: aiohttp !=4.0.0a0,!=4.0.0a1 ; extra == 'http'
+Provides-Extra: libarchive
+Requires-Dist: libarchive-c ; extra == 'libarchive'
+Provides-Extra: oci
+Requires-Dist: ocifs ; extra == 'oci'
+Provides-Extra: s3
+Requires-Dist: s3fs ; extra == 's3'
+Provides-Extra: sftp
+Requires-Dist: paramiko ; extra == 'sftp'
+Provides-Extra: smb
+Requires-Dist: smbprotocol ; extra == 'smb'
+Provides-Extra: ssh
+Requires-Dist: paramiko ; extra == 'ssh'
+Provides-Extra: tqdm
+Requires-Dist: tqdm ; extra == 'tqdm'
+
+# filesystem_spec
+
+[![PyPI version](https://badge.fury.io/py/fsspec.svg)](https://pypi.python.org/pypi/fsspec/)
+[![Anaconda-Server Badge](https://anaconda.org/conda-forge/fsspec/badges/version.svg)](https://anaconda.org/conda-forge/fsspec)
+![Build](https://github.com/fsspec/filesystem_spec/workflows/CI/badge.svg)
+[![Docs](https://readthedocs.org/projects/filesystem-spec/badge/?version=latest)](https://filesystem-spec.readthedocs.io/en/latest/?badge=latest)
+[![PyPi downloads](https://img.shields.io/pypi/dm/fsspec?label=pypi%20downloads&style=flat)](https://pepy.tech/project/fsspec)
+
+A specification for pythonic filesystems.
+
+## Install
+
+```bash
+pip install fsspec
+```
+
+would install the base fsspec. Various optionally supported features might require specification of custom
+extra require, e.g. `pip install fsspec[ssh]` will install dependencies for `ssh` backends support.
+Use `pip install fsspec[full]` for installation of all known extra dependencies.
+
+Up-to-date package also provided through conda-forge distribution:
+
+```bash
+conda install -c conda-forge fsspec
+```
+
+
+## Purpose
+
+To produce a template or specification for a file-system interface, that specific implementations should follow,
+so that applications making use of them can rely on a common behaviour and not have to worry about the specific
+internal implementation decisions with any given backend. Many such implementations are included in this package,
+or in sister projects such as `s3fs` and `gcsfs`.
+
+In addition, if this is well-designed, then additional functionality, such as a key-value store or FUSE
+mounting of the file-system implementation may be available for all implementations "for free".
+
+## Documentation
+
+Please refer to [RTD](https://filesystem-spec.readthedocs.io/en/latest/?badge=latest)
+
+## Develop
+
+fsspec uses GitHub Actions for CI. Environment files can be found
+in the "ci/" directory. Note that the main environment is called "py38",
+but it is expected that the version of python installed be adjustable at
+CI runtime. For local use, pick a version suitable for you.
+
+### Testing
+
+Tests can be run in the dev environment, if activated, via ``pytest fsspec``.
+
+The full fsspec suite requires a system-level docker, docker-compose, and fuse
+installation. If only making changes to one backend implementation, it is
+not generally necessary to run all tests locally.
+
+It is expected that contributors ensure that any change to fsspec does not
+cause issues or regressions for either other fsspec-related packages such
+as gcsfs and s3fs, nor for downstream users of fsspec. The "downstream" CI
+run and corresponding environment file run a set of tests from the dask
+test suite, and very minimal tests against pandas and zarr from the
+test_downstream.py module in this repo.
+
+### Code Formatting
+
+fsspec uses [Black](https://black.readthedocs.io/en/stable) to ensure
+a consistent code format throughout the project.
+Run ``black fsspec`` from the root of the filesystem_spec repository to
+auto-format your code. Additionally, many editors have plugins that will apply
+``black`` as you edit files. ``black`` is included in the ``tox`` environments.
+
+Optionally, you may wish to setup [pre-commit hooks](https://pre-commit.com) to
+automatically run ``black`` when you make a git commit.
+Run ``pre-commit install --install-hooks`` from the root of the
+filesystem_spec repository to setup pre-commit hooks. ``black`` will now be run
+before you commit, reformatting any changed files. You can format without
+committing via ``pre-commit run`` or skip these checks with ``git commit
+--no-verify``.
diff --git a/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/RECORD b/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..9eab660eda68fb980eba6c3525c617b1b1868355
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/RECORD
@@ -0,0 +1,104 @@
+fsspec-2024.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+fsspec-2024.3.1.dist-info/LICENSE,sha256=LcNUls5TpzB5FcAIqESq1T53K0mzTN0ARFBnaRQH7JQ,1513
+fsspec-2024.3.1.dist-info/METADATA,sha256=Wv4QVGqB4lYfHfgP-Cfby1Nce57WYXXAhH0f6Ju5FUM,6786
+fsspec-2024.3.1.dist-info/RECORD,,
+fsspec-2024.3.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+fsspec-2024.3.1.dist-info/top_level.txt,sha256=blt2pDrQDwN3Gklcw13CSPLQRd6aaOgJ8AxqrW395MI,7
+fsspec/__init__.py,sha256=C8G5rqeNAes0NHYFhdxcw-ZMg4yDipqzSNc4NIR7uoc,2010
+fsspec/__pycache__/__init__.cpython-311.pyc,,
+fsspec/__pycache__/_version.cpython-311.pyc,,
+fsspec/__pycache__/archive.cpython-311.pyc,,
+fsspec/__pycache__/asyn.cpython-311.pyc,,
+fsspec/__pycache__/caching.cpython-311.pyc,,
+fsspec/__pycache__/callbacks.cpython-311.pyc,,
+fsspec/__pycache__/compression.cpython-311.pyc,,
+fsspec/__pycache__/config.cpython-311.pyc,,
+fsspec/__pycache__/conftest.cpython-311.pyc,,
+fsspec/__pycache__/core.cpython-311.pyc,,
+fsspec/__pycache__/dircache.cpython-311.pyc,,
+fsspec/__pycache__/exceptions.cpython-311.pyc,,
+fsspec/__pycache__/fuse.cpython-311.pyc,,
+fsspec/__pycache__/generic.cpython-311.pyc,,
+fsspec/__pycache__/gui.cpython-311.pyc,,
+fsspec/__pycache__/mapping.cpython-311.pyc,,
+fsspec/__pycache__/parquet.cpython-311.pyc,,
+fsspec/__pycache__/registry.cpython-311.pyc,,
+fsspec/__pycache__/spec.cpython-311.pyc,,
+fsspec/__pycache__/transaction.cpython-311.pyc,,
+fsspec/__pycache__/utils.cpython-311.pyc,,
+fsspec/_version.py,sha256=wHq_BWmvVWba6IeFL8lWxmbw1fXQhCR4NJHH8b77Nxs,500
+fsspec/archive.py,sha256=S__DzfZj-urAN3tp2W6jJ6YDiXG1fAl7FjvWUN73qIE,2386
+fsspec/asyn.py,sha256=AOd2SXH2YPCaQL5jA6IegYevdMFkAnGD7Seh9DC2gSE,36404
+fsspec/caching.py,sha256=TrZqKo3drK9Afujg7grZRiLNcmgUr84rnvMcojzURnI,28819
+fsspec/callbacks.py,sha256=BDIwLzK6rr_0V5ch557fSzsivCElpdqhXr5dZ9Te-EE,9210
+fsspec/compression.py,sha256=Yyd8FXw2rwWRtVoRVah_yguv-J7BUcBo4yDu6Qt52a0,4859
+fsspec/config.py,sha256=LF4Zmu1vhJW7Je9Q-cwkRc3xP7Rhyy7Xnwj26Z6sv2g,4279
+fsspec/conftest.py,sha256=fVfx-NLrH_OZS1TIpYNoPzM7efEcMoL62reHOdYeFCA,1245
+fsspec/core.py,sha256=kkwJ7IR3-i1C9SAZ_oGrPpbM5hqpBZ2OLkuHU5a1sYE,22471
+fsspec/dircache.py,sha256=YzogWJrhEastHU7vWz-cJiJ7sdtLXFXhEpInGKd4EcM,2717
+fsspec/exceptions.py,sha256=xcS7LiRrQ748kvOB9mrUR14kpjNztrHgEkZWi9M-VaI,330
+fsspec/fuse.py,sha256=66amOa6wdIbS0DMhhfAPUoOB37HPorfXD1izV0prmTY,10145
+fsspec/generic.py,sha256=jIA7wBwtUzJhTth78PTzWbOBjGom2e4IjmQ_KBSlHPg,13575
+fsspec/gui.py,sha256=XKoXZpUhRE7jOhRCJH4-jRbKhVu56aS8h9tecvPD3nc,13932
+fsspec/implementations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fsspec/implementations/__pycache__/__init__.cpython-311.pyc,,
+fsspec/implementations/__pycache__/arrow.cpython-311.pyc,,
+fsspec/implementations/__pycache__/cache_mapper.cpython-311.pyc,,
+fsspec/implementations/__pycache__/cache_metadata.cpython-311.pyc,,
+fsspec/implementations/__pycache__/cached.cpython-311.pyc,,
+fsspec/implementations/__pycache__/dask.cpython-311.pyc,,
+fsspec/implementations/__pycache__/data.cpython-311.pyc,,
+fsspec/implementations/__pycache__/dbfs.cpython-311.pyc,,
+fsspec/implementations/__pycache__/dirfs.cpython-311.pyc,,
+fsspec/implementations/__pycache__/ftp.cpython-311.pyc,,
+fsspec/implementations/__pycache__/git.cpython-311.pyc,,
+fsspec/implementations/__pycache__/github.cpython-311.pyc,,
+fsspec/implementations/__pycache__/http.cpython-311.pyc,,
+fsspec/implementations/__pycache__/jupyter.cpython-311.pyc,,
+fsspec/implementations/__pycache__/libarchive.cpython-311.pyc,,
+fsspec/implementations/__pycache__/local.cpython-311.pyc,,
+fsspec/implementations/__pycache__/memory.cpython-311.pyc,,
+fsspec/implementations/__pycache__/reference.cpython-311.pyc,,
+fsspec/implementations/__pycache__/sftp.cpython-311.pyc,,
+fsspec/implementations/__pycache__/smb.cpython-311.pyc,,
+fsspec/implementations/__pycache__/tar.cpython-311.pyc,,
+fsspec/implementations/__pycache__/webhdfs.cpython-311.pyc,,
+fsspec/implementations/__pycache__/zip.cpython-311.pyc,,
+fsspec/implementations/arrow.py,sha256=_7TLuV6ZzNlpmUU_v6ud56u2wadzsKmY5qugPBxgMEs,8649
+fsspec/implementations/cache_mapper.py,sha256=iHgBA6gjzDJ7_mBboHFzpLTf55HP3UEwUOZ43xyUK4M,2429
+fsspec/implementations/cache_metadata.py,sha256=ZvyA7Y3KK-5Ct4E5pELzD6mH_5T03XqaKVT96qYDADU,8576
+fsspec/implementations/cached.py,sha256=CuxQXQ6f-MRnLvsRzvauEhpmXEgicZZCfViKjIu1kn4,33029
+fsspec/implementations/dask.py,sha256=CXZbJzIVOhKV8ILcxuy3bTvcacCueAbyQxmvAkbPkrk,4466
+fsspec/implementations/data.py,sha256=LDLczxRh8h7x39Zjrd-GgzdQHr78yYxDlrv2C9Uxb5E,1658
+fsspec/implementations/dbfs.py,sha256=cix9OYUveuSOx5UO5uRUwNUkYqjzyY0fkKnca1kTgZ0,15014
+fsspec/implementations/dirfs.py,sha256=inDIRSDPhI1_ud1MMBFrpZQ11VIAMJ_dZQtbE4V08Ng,11384
+fsspec/implementations/ftp.py,sha256=rp6cTog8xqjDPlKdSLKcsyP7K593_ByMabxGbNSEpTo,11655
+fsspec/implementations/git.py,sha256=vKGI-Vd5q4H2RrvhebkPc9NwlfkZ980OUGhebeCw-M0,4034
+fsspec/implementations/github.py,sha256=0kIiKkeAaROuHgdWBHVQFrzJ2ZfoDgymCehL_kJXHYA,7565
+fsspec/implementations/http.py,sha256=yr6t0OhLwZx_pvNQ05detAehcQjRw0Pg6XdwWv81jxk,29601
+fsspec/implementations/jupyter.py,sha256=B2uj7OEm7yIk-vRSsO37_ND0t0EBvn4B-Su43ibN4Pg,3811
+fsspec/implementations/libarchive.py,sha256=5_I2DiLXwQ1JC8x-K7jXu-tBwhO9dj7tFLnb0bTnVMQ,7102
+fsspec/implementations/local.py,sha256=XLsBoG4lf92w5ZddmbHXcStThSYxHgeoJEd2Mp5Uo0Y,14327
+fsspec/implementations/memory.py,sha256=tlaGCekgZ2Z_9n8B6hsSpo6_V89PwjugkOmD445QrqE,9778
+fsspec/implementations/reference.py,sha256=3dPi55riD_cROCafpeoUm2Xbb1vpXpyQijl09f5jTsE,43871
+fsspec/implementations/sftp.py,sha256=fMY9XZcmpjszQ2tCqO_TPaJesaeD_Dv7ptYzgUPGoO0,5631
+fsspec/implementations/smb.py,sha256=_hR5MKwDUCi3u5zEzvnenIWRIGPMhuUryWRYvNSp0WE,10804
+fsspec/implementations/tar.py,sha256=dam78Tp_CozybNqCY2JYgGBS3Uc9FuJUAT9oB0lolOs,4111
+fsspec/implementations/webhdfs.py,sha256=wqVfno7z0TY1HepaIvKTUUcl_bi5NkV6qWsST8t_s7Y,16745
+fsspec/implementations/zip.py,sha256=vc1fNz-yO8uWQ9bQUqBFYpTcgsfZQq9vDwwg4Aufs9Y,4417
+fsspec/mapping.py,sha256=hSsiRo-dgAOj6oHf67bF3i11U4xREglXToHGUX4GhRY,8261
+fsspec/parquet.py,sha256=qVxDhwc960SGOt5etcYAJxCr-7HQKP01687KpDR02Gw,19463
+fsspec/registry.py,sha256=VjnfGUg39lvlCDxOoGSeYm8UL12wZC5yQ5n8-W92eD0,11173
+fsspec/spec.py,sha256=3t96RgizRN_slIuHXnuR0bXjVUfBS1TfuDrEua4oQvE,66277
+fsspec/tests/abstract/__init__.py,sha256=i1wcFixV6QhOwdoB24c8oXjzobISNqiKVz9kl2DvAY8,10028
+fsspec/tests/abstract/__pycache__/__init__.cpython-311.pyc,,
+fsspec/tests/abstract/__pycache__/common.cpython-311.pyc,,
+fsspec/tests/abstract/__pycache__/copy.cpython-311.pyc,,
+fsspec/tests/abstract/__pycache__/get.cpython-311.pyc,,
+fsspec/tests/abstract/__pycache__/put.cpython-311.pyc,,
+fsspec/tests/abstract/common.py,sha256=1GQwNo5AONzAnzZj0fWgn8NJPLXALehbsuGxS3FzWVU,4973
+fsspec/tests/abstract/copy.py,sha256=gU5-d97U3RSde35Vp4RxPY4rWwL744HiSrJ8IBOp9-8,19967
+fsspec/tests/abstract/get.py,sha256=vNR4HztvTR7Cj56AMo7_tx7TeYz1Jgr_2Wb8Lv-UiBY,20755
+fsspec/tests/abstract/put.py,sha256=7aih17OKB_IZZh1Mkq1eBDIjobhtMQmI8x-Pw-S_aZk,21201
+fsspec/transaction.py,sha256=xliRG6U2Zf3khG4xcw9WiB-yAoqJSHEGK_VjHOdtgo0,2398
+fsspec/utils.py,sha256=kYBiiw_0AEFJPCYwYlbZ7QxiGwuXdaaxrK6KM3mcFak,23052
diff --git a/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/WHEEL b/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..bab98d675883cc7567a79df485cd7b4f015e376f
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/top_level.txt b/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..968fea66e533ba30593c7fbfe750c36fae2f3cfe
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec-2024.3.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+fsspec
diff --git a/llm/Lib/site-packages/fsspec/__init__.py b/llm/Lib/site-packages/fsspec/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0ce4d601f1188a41df7812c320395800a64e1bee
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/__init__.py
@@ -0,0 +1,70 @@
+from importlib.metadata import entry_points
+
+from . import _version, caching
+from .callbacks import Callback
+from .compression import available_compressions
+from .core import get_fs_token_paths, open, open_files, open_local, url_to_fs
+from .exceptions import FSTimeoutError
+from .mapping import FSMap, get_mapper
+from .registry import (
+    available_protocols,
+    filesystem,
+    get_filesystem_class,
+    register_implementation,
+    registry,
+)
+from .spec import AbstractFileSystem
+
+__version__ = _version.get_versions()["version"]
+
+__all__ = [
+    "AbstractFileSystem",
+    "FSTimeoutError",
+    "FSMap",
+    "filesystem",
+    "register_implementation",
+    "get_filesystem_class",
+    "get_fs_token_paths",
+    "get_mapper",
+    "open",
+    "open_files",
+    "open_local",
+    "registry",
+    "caching",
+    "Callback",
+    "available_protocols",
+    "available_compressions",
+    "url_to_fs",
+]
+
+
+def process_entries():
+    if entry_points is not None:
+        try:
+            eps = entry_points()
+        except TypeError:
+            pass  # importlib-metadata < 0.8
+        else:
+            if hasattr(eps, "select"):  # Python 3.10+ / importlib_metadata >= 3.9.0
+                specs = eps.select(group="fsspec.specs")
+            else:
+                specs = eps.get("fsspec.specs", [])
+            registered_names = {}
+            for spec in specs:
+                err_msg = f"Unable to load filesystem from {spec}"
+                name = spec.name
+                if name in registered_names:
+                    continue
+                registered_names[name] = True
+                register_implementation(
+                    name,
+                    spec.value.replace(":", "."),
+                    errtxt=err_msg,
+                    # We take our implementations as the ones to overload with if
+                    # for some reason we encounter some, may be the same, already
+                    # registered
+                    clobber=True,
+                )
+
+
+process_entries()
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f82758939c65b330a810bfdb244655cbf6233921
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/_version.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/_version.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ded1aa65344c198e000e77c32cee693ab9a7f8cb
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/_version.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/archive.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/archive.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..26d5699c7a4ef718fac08311237b58b6579f29f0
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/archive.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/asyn.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/asyn.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3c6cbd116396fdf53bac38462a41854b601b5dca
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/asyn.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/caching.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/caching.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4a16282f03aad0fd5fe9e0d6228fbd3d7ba3738a
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/caching.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/callbacks.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/callbacks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f27573eb68c700bba25e2b2f40a06a6eaa2ce0ca
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/callbacks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/compression.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/compression.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a3db0ed6d4bda9bd84e5ca1c28ec122800f08157
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/compression.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/config.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/config.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..37d01118f61bc3bc6a87b8b083eee40506dc5033
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/config.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/conftest.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/conftest.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c0cca0972c2bc0c2a952cec5fd1ed21536ce93e8
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/conftest.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/core.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/core.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3010fd035f7452534f4a8780a86211f8c58317c0
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/core.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/dircache.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/dircache.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..71e8c9f4b6c7eca30494dd4642ea397d21cab1ec
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/dircache.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..07100140fbd617c383df7bf83f99f4cc62260633
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/fuse.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/fuse.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..96b9213e0ddc6727a731e25acb644d15380dcd3d
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/fuse.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/generic.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/generic.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d70b8aec3ae6cd1a825b497f0f404b0bd9b3f161
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/generic.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/gui.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/gui.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4a1aa1ea2aacabe800e6fc8291761467daef2204
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/gui.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/mapping.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/mapping.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..86cdca9e4f6c5242369745b25812ffbc23e18ee3
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/mapping.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/parquet.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/parquet.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cdcea37123fc41eb98872780062d641f55597afa
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/parquet.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/registry.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/registry.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e71a3500191939d1805f4dae2e28d21e1825b06
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/registry.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/spec.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/spec.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..84233553cd4a3c8e5c965623ef7fc904ca2d708d
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/spec.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/transaction.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/transaction.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8115a84dc07252ae3ec65352955d20ce9abcb666
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/transaction.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/fsspec/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..72466ba7a150b5efcaeb38a0e44521295162f709
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/_version.py b/llm/Lib/site-packages/fsspec/_version.py
new file mode 100644
index 0000000000000000000000000000000000000000..bdb3a1059f12c0b1e92812169c4cc8014b9d3b75
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/_version.py
@@ -0,0 +1,21 @@
+
+# This file was generated by 'versioneer.py' (0.29) from
+# revision-control system data, or from the parent directory name of an
+# unpacked source archive. Distribution tarballs contain a pre-generated copy
+# of this file.
+
+import json
+
+version_json = '''
+{
+ "date": "2024-03-18T15:33:58-0400",
+ "dirty": false,
+ "error": null,
+ "full-revisionid": "47b445ae4c284a82dd15e0287b1ffc410e8fc470",
+ "version": "2024.3.1"
+}
+'''  # END VERSION_JSON
+
+
+def get_versions():
+    return json.loads(version_json)
diff --git a/llm/Lib/site-packages/fsspec/archive.py b/llm/Lib/site-packages/fsspec/archive.py
new file mode 100644
index 0000000000000000000000000000000000000000..f466780fc802d6aa79be02a2af3424c051503708
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/archive.py
@@ -0,0 +1,73 @@
+from fsspec import AbstractFileSystem
+from fsspec.utils import tokenize
+
+
+class AbstractArchiveFileSystem(AbstractFileSystem):
+    """
+    A generic superclass for implementing Archive-based filesystems.
+
+    Currently, it is shared amongst
+    :class:`~fsspec.implementations.zip.ZipFileSystem`,
+    :class:`~fsspec.implementations.libarchive.LibArchiveFileSystem` and
+    :class:`~fsspec.implementations.tar.TarFileSystem`.
+    """
+
+    def __str__(self):
+        return f"<Archive-like object {type(self).__name__} at {id(self)}>"
+
+    __repr__ = __str__
+
+    def ukey(self, path):
+        return tokenize(path, self.fo, self.protocol)
+
+    def _all_dirnames(self, paths):
+        """Returns *all* directory names for each path in paths, including intermediate
+        ones.
+
+        Parameters
+        ----------
+        paths: Iterable of path strings
+        """
+        if len(paths) == 0:
+            return set()
+
+        dirnames = {self._parent(path) for path in paths} - {self.root_marker}
+        return dirnames | self._all_dirnames(dirnames)
+
+    def info(self, path, **kwargs):
+        self._get_dirs()
+        path = self._strip_protocol(path)
+        if path in {"", "/"} and self.dir_cache:
+            return {"name": "", "type": "directory", "size": 0}
+        if path in self.dir_cache:
+            return self.dir_cache[path]
+        elif path + "/" in self.dir_cache:
+            return self.dir_cache[path + "/"]
+        else:
+            raise FileNotFoundError(path)
+
+    def ls(self, path, detail=True, **kwargs):
+        self._get_dirs()
+        paths = {}
+        for p, f in self.dir_cache.items():
+            p = p.rstrip("/")
+            if "/" in p:
+                root = p.rsplit("/", 1)[0]
+            else:
+                root = ""
+            if root == path.rstrip("/"):
+                paths[p] = f
+            elif all(
+                (a == b)
+                for a, b in zip(path.split("/"), [""] + p.strip("/").split("/"))
+            ):
+                # root directory entry
+                ppath = p.rstrip("/").split("/", 1)[0]
+                if ppath not in paths:
+                    out = {"name": ppath, "size": 0, "type": "directory"}
+                    paths[ppath] = out
+        if detail:
+            out = sorted(paths.values(), key=lambda _: _["name"])
+            return out
+        else:
+            return sorted(paths)
diff --git a/llm/Lib/site-packages/fsspec/asyn.py b/llm/Lib/site-packages/fsspec/asyn.py
new file mode 100644
index 0000000000000000000000000000000000000000..a040efc4bba984d27b132e961f8245c1ec11721d
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/asyn.py
@@ -0,0 +1,1096 @@
+import asyncio
+import asyncio.events
+import functools
+import inspect
+import io
+import numbers
+import os
+import re
+import threading
+from contextlib import contextmanager
+from glob import has_magic
+from typing import TYPE_CHECKING, Iterable
+
+from .callbacks import DEFAULT_CALLBACK
+from .exceptions import FSTimeoutError
+from .implementations.local import LocalFileSystem, make_path_posix, trailing_sep
+from .spec import AbstractBufferedFile, AbstractFileSystem
+from .utils import glob_translate, is_exception, other_paths
+
+private = re.compile("_[^_]")
+iothread = [None]  # dedicated fsspec IO thread
+loop = [None]  # global event loop for any non-async instance
+_lock = None  # global lock placeholder
+get_running_loop = asyncio.get_running_loop
+
+
+def get_lock():
+    """Allocate or return a threading lock.
+
+    The lock is allocated on first use to allow setting one lock per forked process.
+    """
+    global _lock
+    if not _lock:
+        _lock = threading.Lock()
+    return _lock
+
+
+def reset_lock():
+    """Reset the global lock.
+
+    This should be called only on the init of a forked process to reset the lock to
+    None, enabling the new forked process to get a new lock.
+    """
+    global _lock
+
+    iothread[0] = None
+    loop[0] = None
+    _lock = None
+
+
+async def _runner(event, coro, result, timeout=None):
+    timeout = timeout if timeout else None  # convert 0 or 0.0 to None
+    if timeout is not None:
+        coro = asyncio.wait_for(coro, timeout=timeout)
+    try:
+        result[0] = await coro
+    except Exception as ex:
+        result[0] = ex
+    finally:
+        event.set()
+
+
+def sync(loop, func, *args, timeout=None, **kwargs):
+    """
+    Make loop run coroutine until it returns. Runs in other thread
+
+    Examples
+    --------
+    >>> fsspec.asyn.sync(fsspec.asyn.get_loop(), func, *args,
+                         timeout=timeout, **kwargs)
+    """
+    timeout = timeout if timeout else None  # convert 0 or 0.0 to None
+    # NB: if the loop is not running *yet*, it is OK to submit work
+    # and we will wait for it
+    if loop is None or loop.is_closed():
+        raise RuntimeError("Loop is not running")
+    try:
+        loop0 = asyncio.events.get_running_loop()
+        if loop0 is loop:
+            raise NotImplementedError("Calling sync() from within a running loop")
+    except NotImplementedError:
+        raise
+    except RuntimeError:
+        pass
+    coro = func(*args, **kwargs)
+    result = [None]
+    event = threading.Event()
+    asyncio.run_coroutine_threadsafe(_runner(event, coro, result, timeout), loop)
+    while True:
+        # this loops allows thread to get interrupted
+        if event.wait(1):
+            break
+        if timeout is not None:
+            timeout -= 1
+            if timeout < 0:
+                raise FSTimeoutError
+
+    return_result = result[0]
+    if isinstance(return_result, asyncio.TimeoutError):
+        # suppress asyncio.TimeoutError, raise FSTimeoutError
+        raise FSTimeoutError from return_result
+    elif isinstance(return_result, BaseException):
+        raise return_result
+    else:
+        return return_result
+
+
+def sync_wrapper(func, obj=None):
+    """Given a function, make so can be called in blocking contexts
+
+    Leave obj=None if defining within a class. Pass the instance if attaching
+    as an attribute of the instance.
+    """
+
+    @functools.wraps(func)
+    def wrapper(*args, **kwargs):
+        self = obj or args[0]
+        return sync(self.loop, func, *args, **kwargs)
+
+    return wrapper
+
+
+@contextmanager
+def _selector_policy():
+    original_policy = asyncio.get_event_loop_policy()
+    try:
+        if os.name == "nt" and hasattr(asyncio, "WindowsSelectorEventLoopPolicy"):
+            asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
+
+        yield
+    finally:
+        asyncio.set_event_loop_policy(original_policy)
+
+
+def get_loop():
+    """Create or return the default fsspec IO loop
+
+    The loop will be running on a separate thread.
+    """
+    if loop[0] is None:
+        with get_lock():
+            # repeat the check just in case the loop got filled between the
+            # previous two calls from another thread
+            if loop[0] is None:
+                with _selector_policy():
+                    loop[0] = asyncio.new_event_loop()
+                th = threading.Thread(target=loop[0].run_forever, name="fsspecIO")
+                th.daemon = True
+                th.start()
+                iothread[0] = th
+    return loop[0]
+
+
+if TYPE_CHECKING:
+    import resource
+
+    ResourceError = resource.error
+else:
+    try:
+        import resource
+    except ImportError:
+        resource = None
+        ResourceError = OSError
+    else:
+        ResourceError = getattr(resource, "error", OSError)
+
+_DEFAULT_BATCH_SIZE = 128
+_NOFILES_DEFAULT_BATCH_SIZE = 1280
+
+
+def _get_batch_size(nofiles=False):
+    from fsspec.config import conf
+
+    if nofiles:
+        if "nofiles_gather_batch_size" in conf:
+            return conf["nofiles_gather_batch_size"]
+    else:
+        if "gather_batch_size" in conf:
+            return conf["gather_batch_size"]
+    if nofiles:
+        return _NOFILES_DEFAULT_BATCH_SIZE
+    if resource is None:
+        return _DEFAULT_BATCH_SIZE
+
+    try:
+        soft_limit, _ = resource.getrlimit(resource.RLIMIT_NOFILE)
+    except (ImportError, ValueError, ResourceError):
+        return _DEFAULT_BATCH_SIZE
+
+    if soft_limit == resource.RLIM_INFINITY:
+        return -1
+    else:
+        return soft_limit // 8
+
+
+def running_async() -> bool:
+    """Being executed by an event loop?"""
+    try:
+        asyncio.get_running_loop()
+        return True
+    except RuntimeError:
+        return False
+
+
+async def _run_coros_in_chunks(
+    coros,
+    batch_size=None,
+    callback=DEFAULT_CALLBACK,
+    timeout=None,
+    return_exceptions=False,
+    nofiles=False,
+):
+    """Run the given coroutines in  chunks.
+
+    Parameters
+    ----------
+    coros: list of coroutines to run
+    batch_size: int or None
+        Number of coroutines to submit/wait on simultaneously.
+        If -1, then it will not be any throttling. If
+        None, it will be inferred from _get_batch_size()
+    callback: fsspec.callbacks.Callback instance
+        Gets a relative_update when each coroutine completes
+    timeout: number or None
+        If given, each coroutine times out after this time. Note that, since
+        there are multiple batches, the total run time of this function will in
+        general be longer
+    return_exceptions: bool
+        Same meaning as in asyncio.gather
+    nofiles: bool
+        If inferring the batch_size, does this operation involve local files?
+        If yes, you normally expect smaller batches.
+    """
+
+    if batch_size is None:
+        batch_size = _get_batch_size(nofiles=nofiles)
+
+    if batch_size == -1:
+        batch_size = len(coros)
+
+    assert batch_size > 0
+
+    async def _run_coro(coro, i):
+        try:
+            return await asyncio.wait_for(coro, timeout=timeout), i
+        except Exception as e:
+            if not return_exceptions:
+                raise
+            return e, i
+        finally:
+            callback.relative_update(1)
+
+    i = 0
+    n = len(coros)
+    results = [None] * n
+    pending = set()
+
+    while pending or i < n:
+        while len(pending) < batch_size and i < n:
+            pending.add(asyncio.ensure_future(_run_coro(coros[i], i)))
+            i += 1
+
+        if not pending:
+            break
+
+        done, pending = await asyncio.wait(pending, return_when=asyncio.FIRST_COMPLETED)
+        while done:
+            result, k = await done.pop()
+            results[k] = result
+
+    return results
+
+
+# these methods should be implemented as async by any async-able backend
+async_methods = [
+    "_ls",
+    "_cat_file",
+    "_get_file",
+    "_put_file",
+    "_rm_file",
+    "_cp_file",
+    "_pipe_file",
+    "_expand_path",
+    "_info",
+    "_isfile",
+    "_isdir",
+    "_exists",
+    "_walk",
+    "_glob",
+    "_find",
+    "_du",
+    "_size",
+    "_mkdir",
+    "_makedirs",
+]
+
+
+class AsyncFileSystem(AbstractFileSystem):
+    """Async file operations, default implementations
+
+    Passes bulk operations to asyncio.gather for concurrent operation.
+
+    Implementations that have concurrent batch operations and/or async methods
+    should inherit from this class instead of AbstractFileSystem. Docstrings are
+    copied from the un-underscored method in AbstractFileSystem, if not given.
+    """
+
+    # note that methods do not have docstring here; they will be copied
+    # for _* methods and inferred for overridden methods.
+
+    async_impl = True
+    mirror_sync_methods = True
+    disable_throttling = False
+
+    def __init__(self, *args, asynchronous=False, loop=None, batch_size=None, **kwargs):
+        self.asynchronous = asynchronous
+        self._pid = os.getpid()
+        if not asynchronous:
+            self._loop = loop or get_loop()
+        else:
+            self._loop = None
+        self.batch_size = batch_size
+        super().__init__(*args, **kwargs)
+
+    @property
+    def loop(self):
+        if self._pid != os.getpid():
+            raise RuntimeError("This class is not fork-safe")
+        return self._loop
+
+    async def _rm_file(self, path, **kwargs):
+        raise NotImplementedError
+
+    async def _rm(self, path, recursive=False, batch_size=None, **kwargs):
+        # TODO: implement on_error
+        batch_size = batch_size or self.batch_size
+        path = await self._expand_path(path, recursive=recursive)
+        return await _run_coros_in_chunks(
+            [self._rm_file(p, **kwargs) for p in reversed(path)],
+            batch_size=batch_size,
+            nofiles=True,
+        )
+
+    async def _cp_file(self, path1, path2, **kwargs):
+        raise NotImplementedError
+
+    async def _copy(
+        self,
+        path1,
+        path2,
+        recursive=False,
+        on_error=None,
+        maxdepth=None,
+        batch_size=None,
+        **kwargs,
+    ):
+        if on_error is None and recursive:
+            on_error = "ignore"
+        elif on_error is None:
+            on_error = "raise"
+
+        if isinstance(path1, list) and isinstance(path2, list):
+            # No need to expand paths when both source and destination
+            # are provided as lists
+            paths1 = path1
+            paths2 = path2
+        else:
+            source_is_str = isinstance(path1, str)
+            paths1 = await self._expand_path(
+                path1, maxdepth=maxdepth, recursive=recursive
+            )
+            if source_is_str and (not recursive or maxdepth is not None):
+                # Non-recursive glob does not copy directories
+                paths1 = [
+                    p for p in paths1 if not (trailing_sep(p) or await self._isdir(p))
+                ]
+                if not paths1:
+                    return
+
+            source_is_file = len(paths1) == 1
+            dest_is_dir = isinstance(path2, str) and (
+                trailing_sep(path2) or await self._isdir(path2)
+            )
+
+            exists = source_is_str and (
+                (has_magic(path1) and source_is_file)
+                or (not has_magic(path1) and dest_is_dir and not trailing_sep(path1))
+            )
+            paths2 = other_paths(
+                paths1,
+                path2,
+                exists=exists,
+                flatten=not source_is_str,
+            )
+
+        batch_size = batch_size or self.batch_size
+        coros = [self._cp_file(p1, p2, **kwargs) for p1, p2 in zip(paths1, paths2)]
+        result = await _run_coros_in_chunks(
+            coros, batch_size=batch_size, return_exceptions=True, nofiles=True
+        )
+
+        for ex in filter(is_exception, result):
+            if on_error == "ignore" and isinstance(ex, FileNotFoundError):
+                continue
+            raise ex
+
+    async def _pipe_file(self, path, value, **kwargs):
+        raise NotImplementedError
+
+    async def _pipe(self, path, value=None, batch_size=None, **kwargs):
+        if isinstance(path, str):
+            path = {path: value}
+        batch_size = batch_size or self.batch_size
+        return await _run_coros_in_chunks(
+            [self._pipe_file(k, v, **kwargs) for k, v in path.items()],
+            batch_size=batch_size,
+            nofiles=True,
+        )
+
+    async def _process_limits(self, url, start, end):
+        """Helper for "Range"-based _cat_file"""
+        size = None
+        suff = False
+        if start is not None and start < 0:
+            # if start is negative and end None, end is the "suffix length"
+            if end is None:
+                end = -start
+                start = ""
+                suff = True
+            else:
+                size = size or (await self._info(url))["size"]
+                start = size + start
+        elif start is None:
+            start = 0
+        if not suff:
+            if end is not None and end < 0:
+                if start is not None:
+                    size = size or (await self._info(url))["size"]
+                    end = size + end
+            elif end is None:
+                end = ""
+            if isinstance(end, numbers.Integral):
+                end -= 1  # bytes range is inclusive
+        return f"bytes={start}-{end}"
+
+    async def _cat_file(self, path, start=None, end=None, **kwargs):
+        raise NotImplementedError
+
+    async def _cat(
+        self, path, recursive=False, on_error="raise", batch_size=None, **kwargs
+    ):
+        paths = await self._expand_path(path, recursive=recursive)
+        coros = [self._cat_file(path, **kwargs) for path in paths]
+        batch_size = batch_size or self.batch_size
+        out = await _run_coros_in_chunks(
+            coros, batch_size=batch_size, nofiles=True, return_exceptions=True
+        )
+        if on_error == "raise":
+            ex = next(filter(is_exception, out), False)
+            if ex:
+                raise ex
+        if (
+            len(paths) > 1
+            or isinstance(path, list)
+            or paths[0] != self._strip_protocol(path)
+        ):
+            return {
+                k: v
+                for k, v in zip(paths, out)
+                if on_error != "omit" or not is_exception(v)
+            }
+        else:
+            return out[0]
+
+    async def _cat_ranges(
+        self,
+        paths,
+        starts,
+        ends,
+        max_gap=None,
+        batch_size=None,
+        on_error="return",
+        **kwargs,
+    ):
+        """Get the contents of byte ranges from one or more files
+
+        Parameters
+        ----------
+        paths: list
+            A list of of filepaths on this filesystems
+        starts, ends: int or list
+            Bytes limits of the read. If using a single int, the same value will be
+            used to read all the specified files.
+        """
+        # TODO: on_error
+        if max_gap is not None:
+            # use utils.merge_offset_ranges
+            raise NotImplementedError
+        if not isinstance(paths, list):
+            raise TypeError
+        if not isinstance(starts, Iterable):
+            starts = [starts] * len(paths)
+        if not isinstance(ends, Iterable):
+            ends = [ends] * len(paths)
+        if len(starts) != len(paths) or len(ends) != len(paths):
+            raise ValueError
+        coros = [
+            self._cat_file(p, start=s, end=e, **kwargs)
+            for p, s, e in zip(paths, starts, ends)
+        ]
+        batch_size = batch_size or self.batch_size
+        return await _run_coros_in_chunks(
+            coros, batch_size=batch_size, nofiles=True, return_exceptions=True
+        )
+
+    async def _put_file(self, lpath, rpath, **kwargs):
+        raise NotImplementedError
+
+    async def _put(
+        self,
+        lpath,
+        rpath,
+        recursive=False,
+        callback=DEFAULT_CALLBACK,
+        batch_size=None,
+        maxdepth=None,
+        **kwargs,
+    ):
+        """Copy file(s) from local.
+
+        Copies a specific file or tree of files (if recursive=True). If rpath
+        ends with a "/", it will be assumed to be a directory, and target files
+        will go within.
+
+        The put_file method will be called concurrently on a batch of files. The
+        batch_size option can configure the amount of futures that can be executed
+        at the same time. If it is -1, then all the files will be uploaded concurrently.
+        The default can be set for this instance by passing "batch_size" in the
+        constructor, or for all instances by setting the "gather_batch_size" key
+        in ``fsspec.config.conf``, falling back to 1/8th of the system limit .
+        """
+        if isinstance(lpath, list) and isinstance(rpath, list):
+            # No need to expand paths when both source and destination
+            # are provided as lists
+            rpaths = rpath
+            lpaths = lpath
+        else:
+            source_is_str = isinstance(lpath, str)
+            if source_is_str:
+                lpath = make_path_posix(lpath)
+            fs = LocalFileSystem()
+            lpaths = fs.expand_path(lpath, recursive=recursive, maxdepth=maxdepth)
+            if source_is_str and (not recursive or maxdepth is not None):
+                # Non-recursive glob does not copy directories
+                lpaths = [p for p in lpaths if not (trailing_sep(p) or fs.isdir(p))]
+                if not lpaths:
+                    return
+
+            source_is_file = len(lpaths) == 1
+            dest_is_dir = isinstance(rpath, str) and (
+                trailing_sep(rpath) or await self._isdir(rpath)
+            )
+
+            rpath = self._strip_protocol(rpath)
+            exists = source_is_str and (
+                (has_magic(lpath) and source_is_file)
+                or (not has_magic(lpath) and dest_is_dir and not trailing_sep(lpath))
+            )
+            rpaths = other_paths(
+                lpaths,
+                rpath,
+                exists=exists,
+                flatten=not source_is_str,
+            )
+
+        is_dir = {l: os.path.isdir(l) for l in lpaths}
+        rdirs = [r for l, r in zip(lpaths, rpaths) if is_dir[l]]
+        file_pairs = [(l, r) for l, r in zip(lpaths, rpaths) if not is_dir[l]]
+
+        await asyncio.gather(*[self._makedirs(d, exist_ok=True) for d in rdirs])
+        batch_size = batch_size or self.batch_size
+
+        coros = []
+        callback.set_size(len(file_pairs))
+        for lfile, rfile in file_pairs:
+            put_file = callback.branch_coro(self._put_file)
+            coros.append(put_file(lfile, rfile, **kwargs))
+
+        return await _run_coros_in_chunks(
+            coros, batch_size=batch_size, callback=callback
+        )
+
+    async def _get_file(self, rpath, lpath, **kwargs):
+        raise NotImplementedError
+
+    async def _get(
+        self,
+        rpath,
+        lpath,
+        recursive=False,
+        callback=DEFAULT_CALLBACK,
+        maxdepth=None,
+        **kwargs,
+    ):
+        """Copy file(s) to local.
+
+        Copies a specific file or tree of files (if recursive=True). If lpath
+        ends with a "/", it will be assumed to be a directory, and target files
+        will go within. Can submit a list of paths, which may be glob-patterns
+        and will be expanded.
+
+        The get_file method will be called concurrently on a batch of files. The
+        batch_size option can configure the amount of futures that can be executed
+        at the same time. If it is -1, then all the files will be uploaded concurrently.
+        The default can be set for this instance by passing "batch_size" in the
+        constructor, or for all instances by setting the "gather_batch_size" key
+        in ``fsspec.config.conf``, falling back to 1/8th of the system limit .
+        """
+        if isinstance(lpath, list) and isinstance(rpath, list):
+            # No need to expand paths when both source and destination
+            # are provided as lists
+            rpaths = rpath
+            lpaths = lpath
+        else:
+            source_is_str = isinstance(rpath, str)
+            # First check for rpath trailing slash as _strip_protocol removes it.
+            source_not_trailing_sep = source_is_str and not trailing_sep(rpath)
+            rpath = self._strip_protocol(rpath)
+            rpaths = await self._expand_path(
+                rpath, recursive=recursive, maxdepth=maxdepth
+            )
+            if source_is_str and (not recursive or maxdepth is not None):
+                # Non-recursive glob does not copy directories
+                rpaths = [
+                    p for p in rpaths if not (trailing_sep(p) or await self._isdir(p))
+                ]
+                if not rpaths:
+                    return
+
+            lpath = make_path_posix(lpath)
+            source_is_file = len(rpaths) == 1
+            dest_is_dir = isinstance(lpath, str) and (
+                trailing_sep(lpath) or LocalFileSystem().isdir(lpath)
+            )
+
+            exists = source_is_str and (
+                (has_magic(rpath) and source_is_file)
+                or (not has_magic(rpath) and dest_is_dir and source_not_trailing_sep)
+            )
+            lpaths = other_paths(
+                rpaths,
+                lpath,
+                exists=exists,
+                flatten=not source_is_str,
+            )
+
+        [os.makedirs(os.path.dirname(lp), exist_ok=True) for lp in lpaths]
+        batch_size = kwargs.pop("batch_size", self.batch_size)
+
+        coros = []
+        callback.set_size(len(lpaths))
+        for lpath, rpath in zip(lpaths, rpaths):
+            get_file = callback.branch_coro(self._get_file)
+            coros.append(get_file(rpath, lpath, **kwargs))
+        return await _run_coros_in_chunks(
+            coros, batch_size=batch_size, callback=callback
+        )
+
+    async def _isfile(self, path):
+        try:
+            return (await self._info(path))["type"] == "file"
+        except:  # noqa: E722
+            return False
+
+    async def _isdir(self, path):
+        try:
+            return (await self._info(path))["type"] == "directory"
+        except OSError:
+            return False
+
+    async def _size(self, path):
+        return (await self._info(path)).get("size", None)
+
+    async def _sizes(self, paths, batch_size=None):
+        batch_size = batch_size or self.batch_size
+        return await _run_coros_in_chunks(
+            [self._size(p) for p in paths], batch_size=batch_size
+        )
+
+    async def _exists(self, path, **kwargs):
+        try:
+            await self._info(path, **kwargs)
+            return True
+        except FileNotFoundError:
+            return False
+
+    async def _info(self, path, **kwargs):
+        raise NotImplementedError
+
+    async def _ls(self, path, detail=True, **kwargs):
+        raise NotImplementedError
+
+    async def _walk(self, path, maxdepth=None, on_error="omit", **kwargs):
+        if maxdepth is not None and maxdepth < 1:
+            raise ValueError("maxdepth must be at least 1")
+
+        path = self._strip_protocol(path)
+        full_dirs = {}
+        dirs = {}
+        files = {}
+
+        detail = kwargs.pop("detail", False)
+        try:
+            listing = await self._ls(path, detail=True, **kwargs)
+        except (FileNotFoundError, OSError) as e:
+            if on_error == "raise":
+                raise
+            elif callable(on_error):
+                on_error(e)
+            if detail:
+                yield path, {}, {}
+            else:
+                yield path, [], []
+            return
+
+        for info in listing:
+            # each info name must be at least [path]/part , but here
+            # we check also for names like [path]/part/
+            pathname = info["name"].rstrip("/")
+            name = pathname.rsplit("/", 1)[-1]
+            if info["type"] == "directory" and pathname != path:
+                # do not include "self" path
+                full_dirs[name] = pathname
+                dirs[name] = info
+            elif pathname == path:
+                # file-like with same name as give path
+                files[""] = info
+            else:
+                files[name] = info
+
+        if detail:
+            yield path, dirs, files
+        else:
+            yield path, list(dirs), list(files)
+
+        if maxdepth is not None:
+            maxdepth -= 1
+            if maxdepth < 1:
+                return
+
+        for d in dirs:
+            async for _ in self._walk(
+                full_dirs[d], maxdepth=maxdepth, detail=detail, **kwargs
+            ):
+                yield _
+
+    async def _glob(self, path, maxdepth=None, **kwargs):
+        if maxdepth is not None and maxdepth < 1:
+            raise ValueError("maxdepth must be at least 1")
+
+        import re
+
+        seps = (os.path.sep, os.path.altsep) if os.path.altsep else (os.path.sep,)
+        ends_with_sep = path.endswith(seps)  # _strip_protocol strips trailing slash
+        path = self._strip_protocol(path)
+        append_slash_to_dirname = ends_with_sep or path.endswith(
+            tuple(sep + "**" for sep in seps)
+        )
+        idx_star = path.find("*") if path.find("*") >= 0 else len(path)
+        idx_qmark = path.find("?") if path.find("?") >= 0 else len(path)
+        idx_brace = path.find("[") if path.find("[") >= 0 else len(path)
+
+        min_idx = min(idx_star, idx_qmark, idx_brace)
+
+        detail = kwargs.pop("detail", False)
+
+        if not has_magic(path):
+            if await self._exists(path, **kwargs):
+                if not detail:
+                    return [path]
+                else:
+                    return {path: await self._info(path, **kwargs)}
+            else:
+                if not detail:
+                    return []  # glob of non-existent returns empty
+                else:
+                    return {}
+        elif "/" in path[:min_idx]:
+            min_idx = path[:min_idx].rindex("/")
+            root = path[: min_idx + 1]
+            depth = path[min_idx + 1 :].count("/") + 1
+        else:
+            root = ""
+            depth = path[min_idx + 1 :].count("/") + 1
+
+        if "**" in path:
+            if maxdepth is not None:
+                idx_double_stars = path.find("**")
+                depth_double_stars = path[idx_double_stars:].count("/") + 1
+                depth = depth - depth_double_stars + maxdepth
+            else:
+                depth = None
+
+        allpaths = await self._find(
+            root, maxdepth=depth, withdirs=True, detail=True, **kwargs
+        )
+
+        pattern = glob_translate(path + ("/" if ends_with_sep else ""))
+        pattern = re.compile(pattern)
+
+        out = {
+            p: info
+            for p, info in sorted(allpaths.items())
+            if pattern.match(
+                (
+                    p + "/"
+                    if append_slash_to_dirname and info["type"] == "directory"
+                    else p
+                )
+            )
+        }
+
+        if detail:
+            return out
+        else:
+            return list(out)
+
+    async def _du(self, path, total=True, maxdepth=None, **kwargs):
+        sizes = {}
+        # async for?
+        for f in await self._find(path, maxdepth=maxdepth, **kwargs):
+            info = await self._info(f)
+            sizes[info["name"]] = info["size"]
+        if total:
+            return sum(sizes.values())
+        else:
+            return sizes
+
+    async def _find(self, path, maxdepth=None, withdirs=False, **kwargs):
+        path = self._strip_protocol(path)
+        out = {}
+        detail = kwargs.pop("detail", False)
+
+        # Add the root directory if withdirs is requested
+        # This is needed for posix glob compliance
+        if withdirs and path != "" and await self._isdir(path):
+            out[path] = await self._info(path)
+
+        # async for?
+        async for _, dirs, files in self._walk(path, maxdepth, detail=True, **kwargs):
+            if withdirs:
+                files.update(dirs)
+            out.update({info["name"]: info for name, info in files.items()})
+        if not out and (await self._isfile(path)):
+            # walk works on directories, but find should also return [path]
+            # when path happens to be a file
+            out[path] = {}
+        names = sorted(out)
+        if not detail:
+            return names
+        else:
+            return {name: out[name] for name in names}
+
+    async def _expand_path(self, path, recursive=False, maxdepth=None):
+        if maxdepth is not None and maxdepth < 1:
+            raise ValueError("maxdepth must be at least 1")
+
+        if isinstance(path, str):
+            out = await self._expand_path([path], recursive, maxdepth)
+        else:
+            out = set()
+            path = [self._strip_protocol(p) for p in path]
+            for p in path:  # can gather here
+                if has_magic(p):
+                    bit = set(await self._glob(p, maxdepth=maxdepth))
+                    out |= bit
+                    if recursive:
+                        # glob call above expanded one depth so if maxdepth is defined
+                        # then decrement it in expand_path call below. If it is zero
+                        # after decrementing then avoid expand_path call.
+                        if maxdepth is not None and maxdepth <= 1:
+                            continue
+                        out |= set(
+                            await self._expand_path(
+                                list(bit),
+                                recursive=recursive,
+                                maxdepth=maxdepth - 1 if maxdepth is not None else None,
+                            )
+                        )
+                    continue
+                elif recursive:
+                    rec = set(await self._find(p, maxdepth=maxdepth, withdirs=True))
+                    out |= rec
+                if p not in out and (recursive is False or (await self._exists(p))):
+                    # should only check once, for the root
+                    out.add(p)
+        if not out:
+            raise FileNotFoundError(path)
+        return sorted(out)
+
+    async def _mkdir(self, path, create_parents=True, **kwargs):
+        pass  # not necessary to implement, may not have directories
+
+    async def _makedirs(self, path, exist_ok=False):
+        pass  # not necessary to implement, may not have directories
+
+    async def open_async(self, path, mode="rb", **kwargs):
+        if "b" not in mode or kwargs.get("compression"):
+            raise ValueError
+        raise NotImplementedError
+
+
+def mirror_sync_methods(obj):
+    """Populate sync and async methods for obj
+
+    For each method will create a sync version if the name refers to an async method
+    (coroutine) and there is no override in the child class; will create an async
+    method for the corresponding sync method if there is no implementation.
+
+    Uses the methods specified in
+    - async_methods: the set that an implementation is expected to provide
+    - default_async_methods: that can be derived from their sync version in
+      AbstractFileSystem
+    - AsyncFileSystem: async-specific default coroutines
+    """
+    from fsspec import AbstractFileSystem
+
+    for method in async_methods + dir(AsyncFileSystem):
+        if not method.startswith("_"):
+            continue
+        smethod = method[1:]
+        if private.match(method):
+            isco = inspect.iscoroutinefunction(getattr(obj, method, None))
+            unsync = getattr(getattr(obj, smethod, False), "__func__", None)
+            is_default = unsync is getattr(AbstractFileSystem, smethod, "")
+            if isco and is_default:
+                mth = sync_wrapper(getattr(obj, method), obj=obj)
+                setattr(obj, smethod, mth)
+                if not mth.__doc__:
+                    mth.__doc__ = getattr(
+                        getattr(AbstractFileSystem, smethod, None), "__doc__", ""
+                    )
+
+
+class FSSpecCoroutineCancel(Exception):
+    pass
+
+
+def _dump_running_tasks(
+    printout=True, cancel=True, exc=FSSpecCoroutineCancel, with_task=False
+):
+    import traceback
+
+    tasks = [t for t in asyncio.tasks.all_tasks(loop[0]) if not t.done()]
+    if printout:
+        [task.print_stack() for task in tasks]
+    out = [
+        {
+            "locals": task._coro.cr_frame.f_locals,
+            "file": task._coro.cr_frame.f_code.co_filename,
+            "firstline": task._coro.cr_frame.f_code.co_firstlineno,
+            "linelo": task._coro.cr_frame.f_lineno,
+            "stack": traceback.format_stack(task._coro.cr_frame),
+            "task": task if with_task else None,
+        }
+        for task in tasks
+    ]
+    if cancel:
+        for t in tasks:
+            cbs = t._callbacks
+            t.cancel()
+            asyncio.futures.Future.set_exception(t, exc)
+            asyncio.futures.Future.cancel(t)
+            [cb[0](t) for cb in cbs]  # cancels any dependent concurrent.futures
+            try:
+                t._coro.throw(exc)  # exits coro, unless explicitly handled
+            except exc:
+                pass
+    return out
+
+
+class AbstractAsyncStreamedFile(AbstractBufferedFile):
+    # no read buffering, and always auto-commit
+    # TODO: readahead might still be useful here, but needs async version
+
+    async def read(self, length=-1):
+        """
+        Return data from cache, or fetch pieces as necessary
+
+        Parameters
+        ----------
+        length: int (-1)
+            Number of bytes to read; if <0, all remaining bytes.
+        """
+        length = -1 if length is None else int(length)
+        if self.mode != "rb":
+            raise ValueError("File not in read mode")
+        if length < 0:
+            length = self.size - self.loc
+        if self.closed:
+            raise ValueError("I/O operation on closed file.")
+        if length == 0:
+            # don't even bother calling fetch
+            return b""
+        out = await self._fetch_range(self.loc, self.loc + length)
+        self.loc += len(out)
+        return out
+
+    async def write(self, data):
+        """
+        Write data to buffer.
+
+        Buffer only sent on flush() or if buffer is greater than
+        or equal to blocksize.
+
+        Parameters
+        ----------
+        data: bytes
+            Set of bytes to be written.
+        """
+        if self.mode not in {"wb", "ab"}:
+            raise ValueError("File not in write mode")
+        if self.closed:
+            raise ValueError("I/O operation on closed file.")
+        if self.forced:
+            raise ValueError("This file has been force-flushed, can only close")
+        out = self.buffer.write(data)
+        self.loc += out
+        if self.buffer.tell() >= self.blocksize:
+            await self.flush()
+        return out
+
+    async def close(self):
+        """Close file
+
+        Finalizes writes, discards cache
+        """
+        if getattr(self, "_unclosable", False):
+            return
+        if self.closed:
+            return
+        if self.mode == "rb":
+            self.cache = None
+        else:
+            if not self.forced:
+                await self.flush(force=True)
+
+            if self.fs is not None:
+                self.fs.invalidate_cache(self.path)
+                self.fs.invalidate_cache(self.fs._parent(self.path))
+
+        self.closed = True
+
+    async def flush(self, force=False):
+        if self.closed:
+            raise ValueError("Flush on closed file")
+        if force and self.forced:
+            raise ValueError("Force flush cannot be called more than once")
+        if force:
+            self.forced = True
+
+        if self.mode not in {"wb", "ab"}:
+            # no-op to flush on read-mode
+            return
+
+        if not force and self.buffer.tell() < self.blocksize:
+            # Defer write on small block
+            return
+
+        if self.offset is None:
+            # Initialize a multipart upload
+            self.offset = 0
+            try:
+                await self._initiate_upload()
+            except:  # noqa: E722
+                self.closed = True
+                raise
+
+        if await self._upload_chunk(final=force) is not False:
+            self.offset += self.buffer.seek(0, 2)
+            self.buffer = io.BytesIO()
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, exc_type, exc_val, exc_tb):
+        await self.close()
+
+    async def _fetch_range(self, start, end):
+        raise NotImplementedError
+
+    async def _initiate_upload(self):
+        pass
+
+    async def _upload_chunk(self, final=False):
+        raise NotImplementedError
diff --git a/llm/Lib/site-packages/fsspec/caching.py b/llm/Lib/site-packages/fsspec/caching.py
new file mode 100644
index 0000000000000000000000000000000000000000..b1a51f1e2184f09d2ac7fdb8ce2e3596775ccce3
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/caching.py
@@ -0,0 +1,881 @@
+from __future__ import annotations
+
+import collections
+import functools
+import logging
+import math
+import os
+import threading
+import warnings
+from concurrent.futures import Future, ThreadPoolExecutor
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    ClassVar,
+    Generic,
+    NamedTuple,
+    OrderedDict,
+    TypeVar,
+)
+
+if TYPE_CHECKING:
+    import mmap
+
+    from typing_extensions import ParamSpec
+
+    P = ParamSpec("P")
+else:
+    P = TypeVar("P")
+
+T = TypeVar("T")
+
+
+logger = logging.getLogger("fsspec")
+
+Fetcher = Callable[[int, int], bytes]  # Maps (start, end) to bytes
+
+
+class BaseCache:
+    """Pass-though cache: doesn't keep anything, calls every time
+
+    Acts as base class for other cachers
+
+    Parameters
+    ----------
+    blocksize: int
+        How far to read ahead in numbers of bytes
+    fetcher: func
+        Function of the form f(start, end) which gets bytes from remote as
+        specified
+    size: int
+        How big this file is
+    """
+
+    name: ClassVar[str] = "none"
+
+    def __init__(self, blocksize: int, fetcher: Fetcher, size: int) -> None:
+        self.blocksize = blocksize
+        self.fetcher = fetcher
+        self.size = size
+
+    def _fetch(self, start: int | None, stop: int | None) -> bytes:
+        if start is None:
+            start = 0
+        if stop is None:
+            stop = self.size
+        if start >= self.size or start >= stop:
+            return b""
+        return self.fetcher(start, stop)
+
+
+class MMapCache(BaseCache):
+    """memory-mapped sparse file cache
+
+    Opens temporary file, which is filled blocks-wise when data is requested.
+    Ensure there is enough disc space in the temporary location.
+
+    This cache method might only work on posix
+    """
+
+    name = "mmap"
+
+    def __init__(
+        self,
+        blocksize: int,
+        fetcher: Fetcher,
+        size: int,
+        location: str | None = None,
+        blocks: set[int] | None = None,
+    ) -> None:
+        super().__init__(blocksize, fetcher, size)
+        self.blocks = set() if blocks is None else blocks
+        self.location = location
+        self.cache = self._makefile()
+
+    def _makefile(self) -> mmap.mmap | bytearray:
+        import mmap
+        import tempfile
+
+        if self.size == 0:
+            return bytearray()
+
+        # posix version
+        if self.location is None or not os.path.exists(self.location):
+            if self.location is None:
+                fd = tempfile.TemporaryFile()
+                self.blocks = set()
+            else:
+                fd = open(self.location, "wb+")
+            fd.seek(self.size - 1)
+            fd.write(b"1")
+            fd.flush()
+        else:
+            fd = open(self.location, "r+b")
+
+        return mmap.mmap(fd.fileno(), self.size)
+
+    def _fetch(self, start: int | None, end: int | None) -> bytes:
+        logger.debug(f"MMap cache fetching {start}-{end}")
+        if start is None:
+            start = 0
+        if end is None:
+            end = self.size
+        if start >= self.size or start >= end:
+            return b""
+        start_block = start // self.blocksize
+        end_block = end // self.blocksize
+        need = [i for i in range(start_block, end_block + 1) if i not in self.blocks]
+        while need:
+            # TODO: not a for loop so we can consolidate blocks later to
+            # make fewer fetch calls; this could be parallel
+            i = need.pop(0)
+            sstart = i * self.blocksize
+            send = min(sstart + self.blocksize, self.size)
+            logger.debug(f"MMap get block #{i} ({sstart}-{send}")
+            self.cache[sstart:send] = self.fetcher(sstart, send)
+            self.blocks.add(i)
+
+        return self.cache[start:end]
+
+    def __getstate__(self) -> dict[str, Any]:
+        state = self.__dict__.copy()
+        # Remove the unpicklable entries.
+        del state["cache"]
+        return state
+
+    def __setstate__(self, state: dict[str, Any]) -> None:
+        # Restore instance attributes
+        self.__dict__.update(state)
+        self.cache = self._makefile()
+
+
+class ReadAheadCache(BaseCache):
+    """Cache which reads only when we get beyond a block of data
+
+    This is a much simpler version of BytesCache, and does not attempt to
+    fill holes in the cache or keep fragments alive. It is best suited to
+    many small reads in a sequential order (e.g., reading lines from a file).
+    """
+
+    name = "readahead"
+
+    def __init__(self, blocksize: int, fetcher: Fetcher, size: int) -> None:
+        super().__init__(blocksize, fetcher, size)
+        self.cache = b""
+        self.start = 0
+        self.end = 0
+
+    def _fetch(self, start: int | None, end: int | None) -> bytes:
+        if start is None:
+            start = 0
+        if end is None or end > self.size:
+            end = self.size
+        if start >= self.size or start >= end:
+            return b""
+        l = end - start
+        if start >= self.start and end <= self.end:
+            # cache hit
+            return self.cache[start - self.start : end - self.start]
+        elif self.start <= start < self.end:
+            # partial hit
+            part = self.cache[start - self.start :]
+            l -= len(part)
+            start = self.end
+        else:
+            # miss
+            part = b""
+        end = min(self.size, end + self.blocksize)
+        self.cache = self.fetcher(start, end)  # new block replaces old
+        self.start = start
+        self.end = self.start + len(self.cache)
+        return part + self.cache[:l]
+
+
+class FirstChunkCache(BaseCache):
+    """Caches the first block of a file only
+
+    This may be useful for file types where the metadata is stored in the header,
+    but is randomly accessed.
+    """
+
+    name = "first"
+
+    def __init__(self, blocksize: int, fetcher: Fetcher, size: int) -> None:
+        super().__init__(blocksize, fetcher, size)
+        self.cache: bytes | None = None
+
+    def _fetch(self, start: int | None, end: int | None) -> bytes:
+        start = start or 0
+        end = end or self.size
+        if start < self.blocksize:
+            if self.cache is None:
+                if end > self.blocksize:
+                    data = self.fetcher(0, end)
+                    self.cache = data[: self.blocksize]
+                    return data[start:]
+                self.cache = self.fetcher(0, self.blocksize)
+            part = self.cache[start:end]
+            if end > self.blocksize:
+                part += self.fetcher(self.blocksize, end)
+            return part
+        else:
+            return self.fetcher(start, end)
+
+
+class BlockCache(BaseCache):
+    """
+    Cache holding memory as a set of blocks.
+
+    Requests are only ever made ``blocksize`` at a time, and are
+    stored in an LRU cache. The least recently accessed block is
+    discarded when more than ``maxblocks`` are stored.
+
+    Parameters
+    ----------
+    blocksize : int
+        The number of bytes to store in each block.
+        Requests are only ever made for ``blocksize``, so this
+        should balance the overhead of making a request against
+        the granularity of the blocks.
+    fetcher : Callable
+    size : int
+        The total size of the file being cached.
+    maxblocks : int
+        The maximum number of blocks to cache for. The maximum memory
+        use for this cache is then ``blocksize * maxblocks``.
+    """
+
+    name = "blockcache"
+
+    def __init__(
+        self, blocksize: int, fetcher: Fetcher, size: int, maxblocks: int = 32
+    ) -> None:
+        super().__init__(blocksize, fetcher, size)
+        self.nblocks = math.ceil(size / blocksize)
+        self.maxblocks = maxblocks
+        self._fetch_block_cached = functools.lru_cache(maxblocks)(self._fetch_block)
+
+    def __repr__(self) -> str:
+        return (
+            f"<BlockCache blocksize={self.blocksize}, "
+            f"size={self.size}, nblocks={self.nblocks}>"
+        )
+
+    def cache_info(self):
+        """
+        The statistics on the block cache.
+
+        Returns
+        -------
+        NamedTuple
+            Returned directly from the LRU Cache used internally.
+        """
+        return self._fetch_block_cached.cache_info()
+
+    def __getstate__(self) -> dict[str, Any]:
+        state = self.__dict__
+        del state["_fetch_block_cached"]
+        return state
+
+    def __setstate__(self, state: dict[str, Any]) -> None:
+        self.__dict__.update(state)
+        self._fetch_block_cached = functools.lru_cache(state["maxblocks"])(
+            self._fetch_block
+        )
+
+    def _fetch(self, start: int | None, end: int | None) -> bytes:
+        if start is None:
+            start = 0
+        if end is None:
+            end = self.size
+        if start >= self.size or start >= end:
+            return b""
+
+        # byte position -> block numbers
+        start_block_number = start // self.blocksize
+        end_block_number = end // self.blocksize
+
+        # these are cached, so safe to do multiple calls for the same start and end.
+        for block_number in range(start_block_number, end_block_number + 1):
+            self._fetch_block_cached(block_number)
+
+        return self._read_cache(
+            start,
+            end,
+            start_block_number=start_block_number,
+            end_block_number=end_block_number,
+        )
+
+    def _fetch_block(self, block_number: int) -> bytes:
+        """
+        Fetch the block of data for `block_number`.
+        """
+        if block_number > self.nblocks:
+            raise ValueError(
+                f"'block_number={block_number}' is greater than "
+                f"the number of blocks ({self.nblocks})"
+            )
+
+        start = block_number * self.blocksize
+        end = start + self.blocksize
+        logger.info("BlockCache fetching block %d", block_number)
+        block_contents = super()._fetch(start, end)
+        return block_contents
+
+    def _read_cache(
+        self, start: int, end: int, start_block_number: int, end_block_number: int
+    ) -> bytes:
+        """
+        Read from our block cache.
+
+        Parameters
+        ----------
+        start, end : int
+            The start and end byte positions.
+        start_block_number, end_block_number : int
+            The start and end block numbers.
+        """
+        start_pos = start % self.blocksize
+        end_pos = end % self.blocksize
+
+        if start_block_number == end_block_number:
+            block: bytes = self._fetch_block_cached(start_block_number)
+            return block[start_pos:end_pos]
+
+        else:
+            # read from the initial
+            out = [self._fetch_block_cached(start_block_number)[start_pos:]]
+
+            # intermediate blocks
+            # Note: it'd be nice to combine these into one big request. However
+            # that doesn't play nicely with our LRU cache.
+            out.extend(
+                map(
+                    self._fetch_block_cached,
+                    range(start_block_number + 1, end_block_number),
+                )
+            )
+
+            # final block
+            out.append(self._fetch_block_cached(end_block_number)[:end_pos])
+
+            return b"".join(out)
+
+
+class BytesCache(BaseCache):
+    """Cache which holds data in a in-memory bytes object
+
+    Implements read-ahead by the block size, for semi-random reads progressing
+    through the file.
+
+    Parameters
+    ----------
+    trim: bool
+        As we read more data, whether to discard the start of the buffer when
+        we are more than a blocksize ahead of it.
+    """
+
+    name: ClassVar[str] = "bytes"
+
+    def __init__(
+        self, blocksize: int, fetcher: Fetcher, size: int, trim: bool = True
+    ) -> None:
+        super().__init__(blocksize, fetcher, size)
+        self.cache = b""
+        self.start: int | None = None
+        self.end: int | None = None
+        self.trim = trim
+
+    def _fetch(self, start: int | None, end: int | None) -> bytes:
+        # TODO: only set start/end after fetch, in case it fails?
+        # is this where retry logic might go?
+        if start is None:
+            start = 0
+        if end is None:
+            end = self.size
+        if start >= self.size or start >= end:
+            return b""
+        if (
+            self.start is not None
+            and start >= self.start
+            and self.end is not None
+            and end < self.end
+        ):
+            # cache hit: we have all the required data
+            offset = start - self.start
+            return self.cache[offset : offset + end - start]
+
+        if self.blocksize:
+            bend = min(self.size, end + self.blocksize)
+        else:
+            bend = end
+
+        if bend == start or start > self.size:
+            return b""
+
+        if (self.start is None or start < self.start) and (
+            self.end is None or end > self.end
+        ):
+            # First read, or extending both before and after
+            self.cache = self.fetcher(start, bend)
+            self.start = start
+        else:
+            assert self.start is not None
+            assert self.end is not None
+
+            if start < self.start:
+                if self.end is None or self.end - end > self.blocksize:
+                    self.cache = self.fetcher(start, bend)
+                    self.start = start
+                else:
+                    new = self.fetcher(start, self.start)
+                    self.start = start
+                    self.cache = new + self.cache
+            elif self.end is not None and bend > self.end:
+                if self.end > self.size:
+                    pass
+                elif end - self.end > self.blocksize:
+                    self.cache = self.fetcher(start, bend)
+                    self.start = start
+                else:
+                    new = self.fetcher(self.end, bend)
+                    self.cache = self.cache + new
+
+        self.end = self.start + len(self.cache)
+        offset = start - self.start
+        out = self.cache[offset : offset + end - start]
+        if self.trim:
+            num = (self.end - self.start) // (self.blocksize + 1)
+            if num > 1:
+                self.start += self.blocksize * num
+                self.cache = self.cache[self.blocksize * num :]
+        return out
+
+    def __len__(self) -> int:
+        return len(self.cache)
+
+
+class AllBytes(BaseCache):
+    """Cache entire contents of the file"""
+
+    name: ClassVar[str] = "all"
+
+    def __init__(
+        self,
+        blocksize: int | None = None,
+        fetcher: Fetcher | None = None,
+        size: int | None = None,
+        data: bytes | None = None,
+    ) -> None:
+        super().__init__(blocksize, fetcher, size)  # type: ignore[arg-type]
+        if data is None:
+            data = self.fetcher(0, self.size)
+        self.data = data
+
+    def _fetch(self, start: int | None, stop: int | None) -> bytes:
+        return self.data[start:stop]
+
+
+class KnownPartsOfAFile(BaseCache):
+    """
+    Cache holding known file parts.
+
+    Parameters
+    ----------
+    blocksize: int
+        How far to read ahead in numbers of bytes
+    fetcher: func
+        Function of the form f(start, end) which gets bytes from remote as
+        specified
+    size: int
+        How big this file is
+    data: dict
+        A dictionary mapping explicit `(start, stop)` file-offset tuples
+        with known bytes.
+    strict: bool, default True
+        Whether to fetch reads that go beyond a known byte-range boundary.
+        If `False`, any read that ends outside a known part will be zero
+        padded. Note that zero padding will not be used for reads that
+        begin outside a known byte-range.
+    """
+
+    name: ClassVar[str] = "parts"
+
+    def __init__(
+        self,
+        blocksize: int,
+        fetcher: Fetcher,
+        size: int,
+        data: dict[tuple[int, int], bytes] = {},
+        strict: bool = True,
+        **_: Any,
+    ):
+        super().__init__(blocksize, fetcher, size)
+        self.strict = strict
+
+        # simple consolidation of contiguous blocks
+        if data:
+            old_offsets = sorted(data.keys())
+            offsets = [old_offsets[0]]
+            blocks = [data.pop(old_offsets[0])]
+            for start, stop in old_offsets[1:]:
+                start0, stop0 = offsets[-1]
+                if start == stop0:
+                    offsets[-1] = (start0, stop)
+                    blocks[-1] += data.pop((start, stop))
+                else:
+                    offsets.append((start, stop))
+                    blocks.append(data.pop((start, stop)))
+
+            self.data = dict(zip(offsets, blocks))
+        else:
+            self.data = data
+
+    def _fetch(self, start: int | None, stop: int | None) -> bytes:
+        if start is None:
+            start = 0
+        if stop is None:
+            stop = self.size
+
+        out = b""
+        for (loc0, loc1), data in self.data.items():
+            # If self.strict=False, use zero-padded data
+            # for reads beyond the end of a "known" buffer
+            if loc0 <= start < loc1:
+                off = start - loc0
+                out = data[off : off + stop - start]
+                if not self.strict or loc0 <= stop <= loc1:
+                    # The request is within a known range, or
+                    # it begins within a known range, and we
+                    # are allowed to pad reads beyond the
+                    # buffer with zero
+                    out += b"\x00" * (stop - start - len(out))
+                    return out
+                else:
+                    # The request ends outside a known range,
+                    # and we are being "strict" about reads
+                    # beyond the buffer
+                    start = loc1
+                    break
+
+        # We only get here if there is a request outside the
+        # known parts of the file. In an ideal world, this
+        # should never happen
+        if self.fetcher is None:
+            # We cannot fetch the data, so raise an error
+            raise ValueError(f"Read is outside the known file parts: {(start, stop)}. ")
+        # We can fetch the data, but should warn the user
+        # that this may be slow
+        warnings.warn(
+            f"Read is outside the known file parts: {(start, stop)}. "
+            f"IO/caching performance may be poor!"
+        )
+        logger.debug(f"KnownPartsOfAFile cache fetching {start}-{stop}")
+        return out + super()._fetch(start, stop)
+
+
+class UpdatableLRU(Generic[P, T]):
+    """
+    Custom implementation of LRU cache that allows updating keys
+
+    Used by BackgroudBlockCache
+    """
+
+    class CacheInfo(NamedTuple):
+        hits: int
+        misses: int
+        maxsize: int
+        currsize: int
+
+    def __init__(self, func: Callable[P, T], max_size: int = 128) -> None:
+        self._cache: OrderedDict[Any, T] = collections.OrderedDict()
+        self._func = func
+        self._max_size = max_size
+        self._hits = 0
+        self._misses = 0
+        self._lock = threading.Lock()
+
+    def __call__(self, *args: P.args, **kwargs: P.kwargs) -> T:
+        if kwargs:
+            raise TypeError(f"Got unexpected keyword argument {kwargs.keys()}")
+        with self._lock:
+            if args in self._cache:
+                self._cache.move_to_end(args)
+                self._hits += 1
+                return self._cache[args]
+
+        result = self._func(*args, **kwargs)
+
+        with self._lock:
+            self._cache[args] = result
+            self._misses += 1
+            if len(self._cache) > self._max_size:
+                self._cache.popitem(last=False)
+
+        return result
+
+    def is_key_cached(self, *args: Any) -> bool:
+        with self._lock:
+            return args in self._cache
+
+    def add_key(self, result: T, *args: Any) -> None:
+        with self._lock:
+            self._cache[args] = result
+            if len(self._cache) > self._max_size:
+                self._cache.popitem(last=False)
+
+    def cache_info(self) -> UpdatableLRU.CacheInfo:
+        with self._lock:
+            return self.CacheInfo(
+                maxsize=self._max_size,
+                currsize=len(self._cache),
+                hits=self._hits,
+                misses=self._misses,
+            )
+
+
+class BackgroundBlockCache(BaseCache):
+    """
+    Cache holding memory as a set of blocks with pre-loading of
+    the next block in the background.
+
+    Requests are only ever made ``blocksize`` at a time, and are
+    stored in an LRU cache. The least recently accessed block is
+    discarded when more than ``maxblocks`` are stored. If the
+    next block is not in cache, it is loaded in a separate thread
+    in non-blocking way.
+
+    Parameters
+    ----------
+    blocksize : int
+        The number of bytes to store in each block.
+        Requests are only ever made for ``blocksize``, so this
+        should balance the overhead of making a request against
+        the granularity of the blocks.
+    fetcher : Callable
+    size : int
+        The total size of the file being cached.
+    maxblocks : int
+        The maximum number of blocks to cache for. The maximum memory
+        use for this cache is then ``blocksize * maxblocks``.
+    """
+
+    name: ClassVar[str] = "background"
+
+    def __init__(
+        self, blocksize: int, fetcher: Fetcher, size: int, maxblocks: int = 32
+    ) -> None:
+        super().__init__(blocksize, fetcher, size)
+        self.nblocks = math.ceil(size / blocksize)
+        self.maxblocks = maxblocks
+        self._fetch_block_cached = UpdatableLRU(self._fetch_block, maxblocks)
+
+        self._thread_executor = ThreadPoolExecutor(max_workers=1)
+        self._fetch_future_block_number: int | None = None
+        self._fetch_future: Future[bytes] | None = None
+        self._fetch_future_lock = threading.Lock()
+
+    def __repr__(self) -> str:
+        return (
+            f"<BackgroundBlockCache blocksize={self.blocksize}, "
+            f"size={self.size}, nblocks={self.nblocks}>"
+        )
+
+    def cache_info(self) -> UpdatableLRU.CacheInfo:
+        """
+        The statistics on the block cache.
+
+        Returns
+        -------
+        NamedTuple
+            Returned directly from the LRU Cache used internally.
+        """
+        return self._fetch_block_cached.cache_info()
+
+    def __getstate__(self) -> dict[str, Any]:
+        state = self.__dict__
+        del state["_fetch_block_cached"]
+        del state["_thread_executor"]
+        del state["_fetch_future_block_number"]
+        del state["_fetch_future"]
+        del state["_fetch_future_lock"]
+        return state
+
+    def __setstate__(self, state) -> None:
+        self.__dict__.update(state)
+        self._fetch_block_cached = UpdatableLRU(self._fetch_block, state["maxblocks"])
+        self._thread_executor = ThreadPoolExecutor(max_workers=1)
+        self._fetch_future_block_number = None
+        self._fetch_future = None
+        self._fetch_future_lock = threading.Lock()
+
+    def _fetch(self, start: int | None, end: int | None) -> bytes:
+        if start is None:
+            start = 0
+        if end is None:
+            end = self.size
+        if start >= self.size or start >= end:
+            return b""
+
+        # byte position -> block numbers
+        start_block_number = start // self.blocksize
+        end_block_number = end // self.blocksize
+
+        fetch_future_block_number = None
+        fetch_future = None
+        with self._fetch_future_lock:
+            # Background thread is running. Check we we can or must join it.
+            if self._fetch_future is not None:
+                assert self._fetch_future_block_number is not None
+                if self._fetch_future.done():
+                    logger.info("BlockCache joined background fetch without waiting.")
+                    self._fetch_block_cached.add_key(
+                        self._fetch_future.result(), self._fetch_future_block_number
+                    )
+                    # Cleanup the fetch variables. Done with fetching the block.
+                    self._fetch_future_block_number = None
+                    self._fetch_future = None
+                else:
+                    # Must join if we need the block for the current fetch
+                    must_join = bool(
+                        start_block_number
+                        <= self._fetch_future_block_number
+                        <= end_block_number
+                    )
+                    if must_join:
+                        # Copy to the local variables to release lock
+                        # before waiting for result
+                        fetch_future_block_number = self._fetch_future_block_number
+                        fetch_future = self._fetch_future
+
+                        # Cleanup the fetch variables. Have a local copy.
+                        self._fetch_future_block_number = None
+                        self._fetch_future = None
+
+        # Need to wait for the future for the current read
+        if fetch_future is not None:
+            logger.info("BlockCache waiting for background fetch.")
+            # Wait until result and put it in cache
+            self._fetch_block_cached.add_key(
+                fetch_future.result(), fetch_future_block_number
+            )
+
+        # these are cached, so safe to do multiple calls for the same start and end.
+        for block_number in range(start_block_number, end_block_number + 1):
+            self._fetch_block_cached(block_number)
+
+        # fetch next block in the background if nothing is running in the background,
+        # the block is within file and it is not already cached
+        end_block_plus_1 = end_block_number + 1
+        with self._fetch_future_lock:
+            if (
+                self._fetch_future is None
+                and end_block_plus_1 <= self.nblocks
+                and not self._fetch_block_cached.is_key_cached(end_block_plus_1)
+            ):
+                self._fetch_future_block_number = end_block_plus_1
+                self._fetch_future = self._thread_executor.submit(
+                    self._fetch_block, end_block_plus_1, "async"
+                )
+
+        return self._read_cache(
+            start,
+            end,
+            start_block_number=start_block_number,
+            end_block_number=end_block_number,
+        )
+
+    def _fetch_block(self, block_number: int, log_info: str = "sync") -> bytes:
+        """
+        Fetch the block of data for `block_number`.
+        """
+        if block_number > self.nblocks:
+            raise ValueError(
+                f"'block_number={block_number}' is greater than "
+                f"the number of blocks ({self.nblocks})"
+            )
+
+        start = block_number * self.blocksize
+        end = start + self.blocksize
+        logger.info("BlockCache fetching block (%s) %d", log_info, block_number)
+        block_contents = super()._fetch(start, end)
+        return block_contents
+
+    def _read_cache(
+        self, start: int, end: int, start_block_number: int, end_block_number: int
+    ) -> bytes:
+        """
+        Read from our block cache.
+
+        Parameters
+        ----------
+        start, end : int
+            The start and end byte positions.
+        start_block_number, end_block_number : int
+            The start and end block numbers.
+        """
+        start_pos = start % self.blocksize
+        end_pos = end % self.blocksize
+
+        if start_block_number == end_block_number:
+            block = self._fetch_block_cached(start_block_number)
+            return block[start_pos:end_pos]
+
+        else:
+            # read from the initial
+            out = [self._fetch_block_cached(start_block_number)[start_pos:]]
+
+            # intermediate blocks
+            # Note: it'd be nice to combine these into one big request. However
+            # that doesn't play nicely with our LRU cache.
+            out.extend(
+                map(
+                    self._fetch_block_cached,
+                    range(start_block_number + 1, end_block_number),
+                )
+            )
+
+            # final block
+            out.append(self._fetch_block_cached(end_block_number)[:end_pos])
+
+            return b"".join(out)
+
+
+caches: dict[str | None, type[BaseCache]] = {
+    # one custom case
+    None: BaseCache,
+}
+
+
+def register_cache(cls: type[BaseCache], clobber: bool = False) -> None:
+    """'Register' cache implementation.
+
+    Parameters
+    ----------
+    clobber: bool, optional
+        If set to True (default is False) - allow to overwrite existing
+        entry.
+
+    Raises
+    ------
+    ValueError
+    """
+    name = cls.name
+    if not clobber and name in caches:
+        raise ValueError(f"Cache with name {name!r} is already known: {caches[name]}")
+    caches[name] = cls
+
+
+for c in (
+    BaseCache,
+    MMapCache,
+    BytesCache,
+    ReadAheadCache,
+    BlockCache,
+    FirstChunkCache,
+    AllBytes,
+    KnownPartsOfAFile,
+    BackgroundBlockCache,
+):
+    register_cache(c)
diff --git a/llm/Lib/site-packages/fsspec/callbacks.py b/llm/Lib/site-packages/fsspec/callbacks.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ca99ca6ac3cd69b28bcd1550f6550e8e648c5fe
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/callbacks.py
@@ -0,0 +1,324 @@
+from functools import wraps
+
+
+class Callback:
+    """
+    Base class and interface for callback mechanism
+
+    This class can be used directly for monitoring file transfers by
+    providing ``callback=Callback(hooks=...)`` (see the ``hooks`` argument,
+    below), or subclassed for more specialised behaviour.
+
+    Parameters
+    ----------
+    size: int (optional)
+        Nominal quantity for the value that corresponds to a complete
+        transfer, e.g., total number of tiles or total number of
+        bytes
+    value: int (0)
+        Starting internal counter value
+    hooks: dict or None
+        A dict of named functions to be called on each update. The signature
+        of these must be ``f(size, value, **kwargs)``
+    """
+
+    def __init__(self, size=None, value=0, hooks=None, **kwargs):
+        self.size = size
+        self.value = value
+        self.hooks = hooks or {}
+        self.kw = kwargs
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *exc_args):
+        self.close()
+
+    def close(self):
+        """Close callback."""
+
+    def branched(self, path_1, path_2, **kwargs):
+        """
+        Return callback for child transfers
+
+        If this callback is operating at a higher level, e.g., put, which may
+        trigger transfers that can also be monitored. The function returns a callback
+        that has to be passed to the child method, e.g., put_file,
+        as `callback=` argument.
+
+        The implementation uses `callback.branch` for compatibility.
+        When implementing callbacks, it is recommended to override this function instead
+        of `branch` and avoid calling `super().branched(...)`.
+
+        Prefer using this function over `branch`.
+
+        Parameters
+        ----------
+        path_1: str
+            Child's source path
+        path_2: str
+            Child's destination path
+        **kwargs:
+            Arbitrary keyword arguments
+
+        Returns
+        -------
+        callback: Callback
+            A callback instance to be passed to the child method
+        """
+        self.branch(path_1, path_2, kwargs)
+        # mutate kwargs so that we can force the caller to pass "callback=" explicitly
+        return kwargs.pop("callback", DEFAULT_CALLBACK)
+
+    def branch_coro(self, fn):
+        """
+        Wraps a coroutine, and pass a new child callback to it.
+        """
+
+        @wraps(fn)
+        async def func(path1, path2: str, **kwargs):
+            with self.branched(path1, path2, **kwargs) as child:
+                return await fn(path1, path2, callback=child, **kwargs)
+
+        return func
+
+    def set_size(self, size):
+        """
+        Set the internal maximum size attribute
+
+        Usually called if not initially set at instantiation. Note that this
+        triggers a ``call()``.
+
+        Parameters
+        ----------
+        size: int
+        """
+        self.size = size
+        self.call()
+
+    def absolute_update(self, value):
+        """
+        Set the internal value state
+
+        Triggers ``call()``
+
+        Parameters
+        ----------
+        value: int
+        """
+        self.value = value
+        self.call()
+
+    def relative_update(self, inc=1):
+        """
+        Delta increment the internal counter
+
+        Triggers ``call()``
+
+        Parameters
+        ----------
+        inc: int
+        """
+        self.value += inc
+        self.call()
+
+    def call(self, hook_name=None, **kwargs):
+        """
+        Execute hook(s) with current state
+
+        Each function is passed the internal size and current value
+
+        Parameters
+        ----------
+        hook_name: str or None
+            If given, execute on this hook
+        kwargs: passed on to (all) hook(s)
+        """
+        if not self.hooks:
+            return
+        kw = self.kw.copy()
+        kw.update(kwargs)
+        if hook_name:
+            if hook_name not in self.hooks:
+                return
+            return self.hooks[hook_name](self.size, self.value, **kw)
+        for hook in self.hooks.values() or []:
+            hook(self.size, self.value, **kw)
+
+    def wrap(self, iterable):
+        """
+        Wrap an iterable to call ``relative_update`` on each iterations
+
+        Parameters
+        ----------
+        iterable: Iterable
+            The iterable that is being wrapped
+        """
+        for item in iterable:
+            self.relative_update()
+            yield item
+
+    def branch(self, path_1, path_2, kwargs):
+        """
+        Set callbacks for child transfers
+
+        If this callback is operating at a higher level, e.g., put, which may
+        trigger transfers that can also be monitored. The passed kwargs are
+        to be *mutated* to add ``callback=``, if this class supports branching
+        to children.
+
+        Parameters
+        ----------
+        path_1: str
+            Child's source path
+        path_2: str
+            Child's destination path
+        kwargs: dict
+            arguments passed to child method, e.g., put_file.
+
+        Returns
+        -------
+
+        """
+        return None
+
+    def no_op(self, *_, **__):
+        pass
+
+    def __getattr__(self, item):
+        """
+        If undefined methods are called on this class, nothing happens
+        """
+        return self.no_op
+
+    @classmethod
+    def as_callback(cls, maybe_callback=None):
+        """Transform callback=... into Callback instance
+
+        For the special value of ``None``, return the global instance of
+        ``NoOpCallback``. This is an alternative to including
+        ``callback=DEFAULT_CALLBACK`` directly in a method signature.
+        """
+        if maybe_callback is None:
+            return DEFAULT_CALLBACK
+        return maybe_callback
+
+
+class NoOpCallback(Callback):
+    """
+    This implementation of Callback does exactly nothing
+    """
+
+    def call(self, *args, **kwargs):
+        return None
+
+
+class DotPrinterCallback(Callback):
+    """
+    Simple example Callback implementation
+
+    Almost identical to Callback with a hook that prints a char; here we
+    demonstrate how the outer layer may print "#" and the inner layer "."
+    """
+
+    def __init__(self, chr_to_print="#", **kwargs):
+        self.chr = chr_to_print
+        super().__init__(**kwargs)
+
+    def branch(self, path_1, path_2, kwargs):
+        """Mutate kwargs to add new instance with different print char"""
+        kwargs["callback"] = DotPrinterCallback(".")
+
+    def call(self, **kwargs):
+        """Just outputs a character"""
+        print(self.chr, end="")
+
+
+class TqdmCallback(Callback):
+    """
+    A callback to display a progress bar using tqdm
+
+    Parameters
+    ----------
+    tqdm_kwargs : dict, (optional)
+        Any argument accepted by the tqdm constructor.
+        See the `tqdm doc <https://tqdm.github.io/docs/tqdm/#__init__>`_.
+        Will be forwarded to `tqdm_cls`.
+    tqdm_cls: (optional)
+        subclass of `tqdm.tqdm`. If not passed, it will default to `tqdm.tqdm`.
+
+    Examples
+    --------
+    >>> import fsspec
+    >>> from fsspec.callbacks import TqdmCallback
+    >>> fs = fsspec.filesystem("memory")
+    >>> path2distant_data = "/your-path"
+    >>> fs.upload(
+            ".",
+            path2distant_data,
+            recursive=True,
+            callback=TqdmCallback(),
+        )
+
+    You can forward args to tqdm using the ``tqdm_kwargs`` parameter.
+
+    >>> fs.upload(
+            ".",
+            path2distant_data,
+            recursive=True,
+            callback=TqdmCallback(tqdm_kwargs={"desc": "Your tqdm description"}),
+        )
+
+    You can also customize the progress bar by passing a subclass of `tqdm`.
+
+    .. code-block:: python
+
+        class TqdmFormat(tqdm):
+            '''Provides a `total_time` format parameter'''
+            @property
+            def format_dict(self):
+                d = super().format_dict
+                total_time = d["elapsed"] * (d["total"] or 0) / max(d["n"], 1)
+                d.update(total_time=self.format_interval(total_time) + " in total")
+                return d
+
+    >>> with TqdmCallback(
+            tqdm_kwargs={
+                "desc": "desc",
+                "bar_format": "{total_time}: {percentage:.0f}%|{bar}{r_bar}",
+            },
+            tqdm_cls=TqdmFormat,
+        ) as callback:
+            fs.upload(".", path2distant_data, recursive=True, callback=callback)
+    """
+
+    def __init__(self, tqdm_kwargs=None, *args, **kwargs):
+        try:
+            from tqdm import tqdm
+
+        except ImportError as exce:
+            raise ImportError(
+                "Using TqdmCallback requires tqdm to be installed"
+            ) from exce
+
+        self._tqdm_cls = kwargs.pop("tqdm_cls", tqdm)
+        self._tqdm_kwargs = tqdm_kwargs or {}
+        self.tqdm = None
+        super().__init__(*args, **kwargs)
+
+    def call(self, *args, **kwargs):
+        if self.tqdm is None:
+            self.tqdm = self._tqdm_cls(total=self.size, **self._tqdm_kwargs)
+        self.tqdm.total = self.size
+        self.tqdm.update(self.value - self.tqdm.n)
+
+    def close(self):
+        if self.tqdm is not None:
+            self.tqdm.close()
+            self.tqdm = None
+
+    def __del__(self):
+        return self.close()
+
+
+DEFAULT_CALLBACK = _DEFAULT_CALLBACK = NoOpCallback()
diff --git a/llm/Lib/site-packages/fsspec/compression.py b/llm/Lib/site-packages/fsspec/compression.py
new file mode 100644
index 0000000000000000000000000000000000000000..d76e76cc51ec87a83f71ce1d309474b7fde57385
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/compression.py
@@ -0,0 +1,174 @@
+"""Helper functions for a standard streaming compression API"""
+from zipfile import ZipFile
+
+import fsspec.utils
+from fsspec.spec import AbstractBufferedFile
+
+
+def noop_file(file, mode, **kwargs):
+    return file
+
+
+# TODO: files should also be available as contexts
+# should be functions of the form func(infile, mode=, **kwargs) -> file-like
+compr = {None: noop_file}
+
+
+def register_compression(name, callback, extensions, force=False):
+    """Register an "inferable" file compression type.
+
+    Registers transparent file compression type for use with fsspec.open.
+    Compression can be specified by name in open, or "infer"-ed for any files
+    ending with the given extensions.
+
+    Args:
+        name: (str) The compression type name. Eg. "gzip".
+        callback: A callable of form (infile, mode, **kwargs) -> file-like.
+            Accepts an input file-like object, the target mode and kwargs.
+            Returns a wrapped file-like object.
+        extensions: (str, Iterable[str]) A file extension, or list of file
+            extensions for which to infer this compression scheme. Eg. "gz".
+        force: (bool) Force re-registration of compression type or extensions.
+
+    Raises:
+        ValueError: If name or extensions already registered, and not force.
+
+    """
+    if isinstance(extensions, str):
+        extensions = [extensions]
+
+    # Validate registration
+    if name in compr and not force:
+        raise ValueError(f"Duplicate compression registration: {name}")
+
+    for ext in extensions:
+        if ext in fsspec.utils.compressions and not force:
+            raise ValueError(f"Duplicate compression file extension: {ext} ({name})")
+
+    compr[name] = callback
+
+    for ext in extensions:
+        fsspec.utils.compressions[ext] = name
+
+
+def unzip(infile, mode="rb", filename=None, **kwargs):
+    if "r" not in mode:
+        filename = filename or "file"
+        z = ZipFile(infile, mode="w", **kwargs)
+        fo = z.open(filename, mode="w")
+        fo.close = lambda closer=fo.close: closer() or z.close()
+        return fo
+    z = ZipFile(infile)
+    if filename is None:
+        filename = z.namelist()[0]
+    return z.open(filename, mode="r", **kwargs)
+
+
+register_compression("zip", unzip, "zip")
+
+try:
+    from bz2 import BZ2File
+except ImportError:
+    pass
+else:
+    register_compression("bz2", BZ2File, "bz2")
+
+try:  # pragma: no cover
+    from isal import igzip
+
+    def isal(infile, mode="rb", **kwargs):
+        return igzip.IGzipFile(fileobj=infile, mode=mode, **kwargs)
+
+    register_compression("gzip", isal, "gz")
+except ImportError:
+    from gzip import GzipFile
+
+    register_compression(
+        "gzip", lambda f, **kwargs: GzipFile(fileobj=f, **kwargs), "gz"
+    )
+
+try:
+    from lzma import LZMAFile
+
+    register_compression("lzma", LZMAFile, "lzma")
+    register_compression("xz", LZMAFile, "xz")
+except ImportError:
+    pass
+
+try:
+    import lzmaffi
+
+    register_compression("lzma", lzmaffi.LZMAFile, "lzma", force=True)
+    register_compression("xz", lzmaffi.LZMAFile, "xz", force=True)
+except ImportError:
+    pass
+
+
+class SnappyFile(AbstractBufferedFile):
+    def __init__(self, infile, mode, **kwargs):
+        import snappy
+
+        super().__init__(
+            fs=None, path="snappy", mode=mode.strip("b") + "b", size=999999999, **kwargs
+        )
+        self.infile = infile
+        if "r" in mode:
+            self.codec = snappy.StreamDecompressor()
+        else:
+            self.codec = snappy.StreamCompressor()
+
+    def _upload_chunk(self, final=False):
+        self.buffer.seek(0)
+        out = self.codec.add_chunk(self.buffer.read())
+        self.infile.write(out)
+        return True
+
+    def seek(self, loc, whence=0):
+        raise NotImplementedError("SnappyFile is not seekable")
+
+    def seekable(self):
+        return False
+
+    def _fetch_range(self, start, end):
+        """Get the specified set of bytes from remote"""
+        data = self.infile.read(end - start)
+        return self.codec.decompress(data)
+
+
+try:
+    import snappy
+
+    snappy.compress
+    # Snappy may use the .sz file extension, but this is not part of the
+    # standard implementation.
+    register_compression("snappy", SnappyFile, [])
+
+except (ImportError, NameError, AttributeError):
+    pass
+
+try:
+    import lz4.frame
+
+    register_compression("lz4", lz4.frame.open, "lz4")
+except ImportError:
+    pass
+
+try:
+    import zstandard as zstd
+
+    def zstandard_file(infile, mode="rb"):
+        if "r" in mode:
+            cctx = zstd.ZstdDecompressor()
+            return cctx.stream_reader(infile)
+        else:
+            cctx = zstd.ZstdCompressor(level=10)
+            return cctx.stream_writer(infile)
+
+    register_compression("zstd", zstandard_file, "zst")
+except ImportError:
+    pass
+
+
+def available_compressions():
+    """Return a list of the implemented compressions."""
+    return list(compr)
diff --git a/llm/Lib/site-packages/fsspec/config.py b/llm/Lib/site-packages/fsspec/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..76d9af14aaf7df47c4551c169f27b05abf9c269e
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/config.py
@@ -0,0 +1,131 @@
+from __future__ import annotations
+
+import configparser
+import json
+import os
+import warnings
+from typing import Any
+
+conf: dict[str, dict[str, Any]] = {}
+default_conf_dir = os.path.join(os.path.expanduser("~"), ".config/fsspec")
+conf_dir = os.environ.get("FSSPEC_CONFIG_DIR", default_conf_dir)
+
+
+def set_conf_env(conf_dict, envdict=os.environ):
+    """Set config values from environment variables
+
+    Looks for variables of the form ``FSSPEC_<protocol>`` and
+    ``FSSPEC_<protocol>_<kwarg>``. For ``FSSPEC_<protocol>`` the value is parsed
+    as a json dictionary and used to ``update`` the config of the
+    corresponding protocol. For ``FSSPEC_<protocol>_<kwarg>`` there is no
+    attempt to convert the string value, but the kwarg keys will be lower-cased.
+
+    The ``FSSPEC_<protocol>_<kwarg>`` variables are applied after the
+    ``FSSPEC_<protocol>`` ones.
+
+    Parameters
+    ----------
+    conf_dict : dict(str, dict)
+        This dict will be mutated
+    envdict : dict-like(str, str)
+        Source for the values - usually the real environment
+    """
+    kwarg_keys = []
+    for key in envdict:
+        if key.startswith("FSSPEC_") and len(key) > 7 and key[7] != "_":
+            if key.count("_") > 1:
+                kwarg_keys.append(key)
+                continue
+            try:
+                value = json.loads(envdict[key])
+            except json.decoder.JSONDecodeError as ex:
+                warnings.warn(
+                    f"Ignoring environment variable {key} due to a parse failure: {ex}"
+                )
+            else:
+                if isinstance(value, dict):
+                    _, proto = key.split("_", 1)
+                    conf_dict.setdefault(proto.lower(), {}).update(value)
+                else:
+                    warnings.warn(
+                        f"Ignoring environment variable {key} due to not being a dict:"
+                        f" {type(value)}"
+                    )
+        elif key.startswith("FSSPEC"):
+            warnings.warn(
+                f"Ignoring environment variable {key} due to having an unexpected name"
+            )
+
+    for key in kwarg_keys:
+        _, proto, kwarg = key.split("_", 2)
+        conf_dict.setdefault(proto.lower(), {})[kwarg.lower()] = envdict[key]
+
+
+def set_conf_files(cdir, conf_dict):
+    """Set config values from files
+
+    Scans for INI and JSON files in the given dictionary, and uses their
+    contents to set the config. In case of repeated values, later values
+    win.
+
+    In the case of INI files, all values are strings, and these will not
+    be converted.
+
+    Parameters
+    ----------
+    cdir : str
+        Directory to search
+    conf_dict : dict(str, dict)
+        This dict will be mutated
+    """
+    if not os.path.isdir(cdir):
+        return
+    allfiles = sorted(os.listdir(cdir))
+    for fn in allfiles:
+        if fn.endswith(".ini"):
+            ini = configparser.ConfigParser()
+            ini.read(os.path.join(cdir, fn))
+            for key in ini:
+                if key == "DEFAULT":
+                    continue
+                conf_dict.setdefault(key, {}).update(dict(ini[key]))
+        if fn.endswith(".json"):
+            with open(os.path.join(cdir, fn)) as f:
+                js = json.load(f)
+            for key in js:
+                conf_dict.setdefault(key, {}).update(dict(js[key]))
+
+
+def apply_config(cls, kwargs, conf_dict=None):
+    """Supply default values for kwargs when instantiating class
+
+    Augments the passed kwargs, by finding entries in the config dict
+    which match the classes ``.protocol`` attribute (one or more str)
+
+    Parameters
+    ----------
+    cls : file system implementation
+    kwargs : dict
+    conf_dict : dict of dict
+        Typically this is the global configuration
+
+    Returns
+    -------
+    dict : the modified set of kwargs
+    """
+    if conf_dict is None:
+        conf_dict = conf
+    protos = cls.protocol if isinstance(cls.protocol, (tuple, list)) else [cls.protocol]
+    kw = {}
+    for proto in protos:
+        # default kwargs from the current state of the config
+        if proto in conf_dict:
+            kw.update(conf_dict[proto])
+    # explicit kwargs always win
+    kw.update(**kwargs)
+    kwargs = kw
+    return kwargs
+
+
+set_conf_files(conf_dir, conf)
+set_conf_env(conf)
diff --git a/llm/Lib/site-packages/fsspec/conftest.py b/llm/Lib/site-packages/fsspec/conftest.py
new file mode 100644
index 0000000000000000000000000000000000000000..6874a42c4895c3c7b973dc5d63fd4488a4e60b44
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/conftest.py
@@ -0,0 +1,55 @@
+import os
+import shutil
+import subprocess
+import sys
+import time
+
+import pytest
+
+import fsspec
+from fsspec.implementations.cached import CachingFileSystem
+
+
+@pytest.fixture()
+def m():
+    """
+    Fixture providing a memory filesystem.
+    """
+    m = fsspec.filesystem("memory")
+    m.store.clear()
+    m.pseudo_dirs.clear()
+    m.pseudo_dirs.append("")
+    try:
+        yield m
+    finally:
+        m.store.clear()
+        m.pseudo_dirs.clear()
+        m.pseudo_dirs.append("")
+
+
+@pytest.fixture
+def ftp_writable(tmpdir):
+    """
+    Fixture providing a writable FTP filesystem.
+    """
+    pytest.importorskip("pyftpdlib")
+    from fsspec.implementations.ftp import FTPFileSystem
+
+    FTPFileSystem.clear_instance_cache()  # remove lingering connections
+    CachingFileSystem.clear_instance_cache()
+    d = str(tmpdir)
+    with open(os.path.join(d, "out"), "wb") as f:
+        f.write(b"hello" * 10000)
+    P = subprocess.Popen(
+        [sys.executable, "-m", "pyftpdlib", "-d", d, "-u", "user", "-P", "pass", "-w"]
+    )
+    try:
+        time.sleep(1)
+        yield "localhost", 2121, "user", "pass"
+    finally:
+        P.terminate()
+        P.wait()
+        try:
+            shutil.rmtree(tmpdir)
+        except Exception:
+            pass
diff --git a/llm/Lib/site-packages/fsspec/core.py b/llm/Lib/site-packages/fsspec/core.py
new file mode 100644
index 0000000000000000000000000000000000000000..41789b48c0426c30615d41a643940e4ef5ca3a29
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/core.py
@@ -0,0 +1,714 @@
+from __future__ import annotations
+
+import io
+import logging
+import os
+import re
+from glob import has_magic
+from pathlib import Path
+
+# for backwards compat, we export cache things from here too
+from .caching import (  # noqa: F401
+    BaseCache,
+    BlockCache,
+    BytesCache,
+    MMapCache,
+    ReadAheadCache,
+    caches,
+)
+from .compression import compr
+from .registry import filesystem, get_filesystem_class
+from .utils import (
+    _unstrip_protocol,
+    build_name_function,
+    infer_compression,
+    stringify_path,
+)
+
+logger = logging.getLogger("fsspec")
+
+
+class OpenFile:
+    """
+    File-like object to be used in a context
+
+    Can layer (buffered) text-mode and compression over any file-system, which
+    are typically binary-only.
+
+    These instances are safe to serialize, as the low-level file object
+    is not created until invoked using ``with``.
+
+    Parameters
+    ----------
+    fs: FileSystem
+        The file system to use for opening the file. Should be a subclass or duck-type
+        with ``fsspec.spec.AbstractFileSystem``
+    path: str
+        Location to open
+    mode: str like 'rb', optional
+        Mode of the opened file
+    compression: str or None, optional
+        Compression to apply
+    encoding: str or None, optional
+        The encoding to use if opened in text mode.
+    errors: str or None, optional
+        How to handle encoding errors if opened in text mode.
+    newline: None or str
+        Passed to TextIOWrapper in text mode, how to handle line endings.
+    autoopen: bool
+        If True, calls open() immediately. Mostly used by pickle
+    pos: int
+        If given and autoopen is True, seek to this location immediately
+    """
+
+    def __init__(
+        self,
+        fs,
+        path,
+        mode="rb",
+        compression=None,
+        encoding=None,
+        errors=None,
+        newline=None,
+    ):
+        self.fs = fs
+        self.path = path
+        self.mode = mode
+        self.compression = get_compression(path, compression)
+        self.encoding = encoding
+        self.errors = errors
+        self.newline = newline
+        self.fobjects = []
+
+    def __reduce__(self):
+        return (
+            OpenFile,
+            (
+                self.fs,
+                self.path,
+                self.mode,
+                self.compression,
+                self.encoding,
+                self.errors,
+                self.newline,
+            ),
+        )
+
+    def __repr__(self):
+        return f"<OpenFile '{self.path}'>"
+
+    def __enter__(self):
+        mode = self.mode.replace("t", "").replace("b", "") + "b"
+
+        f = self.fs.open(self.path, mode=mode)
+
+        self.fobjects = [f]
+
+        if self.compression is not None:
+            compress = compr[self.compression]
+            f = compress(f, mode=mode[0])
+            self.fobjects.append(f)
+
+        if "b" not in self.mode:
+            # assume, for example, that 'r' is equivalent to 'rt' as in builtin
+            f = PickleableTextIOWrapper(
+                f, encoding=self.encoding, errors=self.errors, newline=self.newline
+            )
+            self.fobjects.append(f)
+
+        return self.fobjects[-1]
+
+    def __exit__(self, *args):
+        self.close()
+
+    @property
+    def full_name(self):
+        return _unstrip_protocol(self.path, self.fs)
+
+    def open(self):
+        """Materialise this as a real open file without context
+
+        The OpenFile object should be explicitly closed to avoid enclosed file
+        instances persisting. You must, therefore, keep a reference to the OpenFile
+        during the life of the file-like it generates.
+        """
+        return self.__enter__()
+
+    def close(self):
+        """Close all encapsulated file objects"""
+        for f in reversed(self.fobjects):
+            if "r" not in self.mode and not f.closed:
+                f.flush()
+            f.close()
+        self.fobjects.clear()
+
+
+class OpenFiles(list):
+    """List of OpenFile instances
+
+    Can be used in a single context, which opens and closes all of the
+    contained files. Normal list access to get the elements works as
+    normal.
+
+    A special case is made for caching filesystems - the files will
+    be down/uploaded together at the start or end of the context, and
+    this may happen concurrently, if the target filesystem supports it.
+    """
+
+    def __init__(self, *args, mode="rb", fs=None):
+        self.mode = mode
+        self.fs = fs
+        self.files = []
+        super().__init__(*args)
+
+    def __enter__(self):
+        if self.fs is None:
+            raise ValueError("Context has already been used")
+
+        fs = self.fs
+        while True:
+            if hasattr(fs, "open_many"):
+                # check for concurrent cache download; or set up for upload
+                self.files = fs.open_many(self)
+                return self.files
+            if hasattr(fs, "fs") and fs.fs is not None:
+                fs = fs.fs
+            else:
+                break
+        return [s.__enter__() for s in self]
+
+    def __exit__(self, *args):
+        fs = self.fs
+        [s.__exit__(*args) for s in self]
+        if "r" not in self.mode:
+            while True:
+                if hasattr(fs, "open_many"):
+                    # check for concurrent cache upload
+                    fs.commit_many(self.files)
+                    return
+                if hasattr(fs, "fs") and fs.fs is not None:
+                    fs = fs.fs
+                else:
+                    break
+
+    def __getitem__(self, item):
+        out = super().__getitem__(item)
+        if isinstance(item, slice):
+            return OpenFiles(out, mode=self.mode, fs=self.fs)
+        return out
+
+    def __repr__(self):
+        return f"<List of {len(self)} OpenFile instances>"
+
+
+def open_files(
+    urlpath,
+    mode="rb",
+    compression=None,
+    encoding="utf8",
+    errors=None,
+    name_function=None,
+    num=1,
+    protocol=None,
+    newline=None,
+    auto_mkdir=True,
+    expand=True,
+    **kwargs,
+):
+    """Given a path or paths, return a list of ``OpenFile`` objects.
+
+    For writing, a str path must contain the "*" character, which will be filled
+    in by increasing numbers, e.g., "part*" ->  "part1", "part2" if num=2.
+
+    For either reading or writing, can instead provide explicit list of paths.
+
+    Parameters
+    ----------
+    urlpath: string or list
+        Absolute or relative filepath(s). Prefix with a protocol like ``s3://``
+        to read from alternative filesystems. To read from multiple files you
+        can pass a globstring or a list of paths, with the caveat that they
+        must all have the same protocol.
+    mode: 'rb', 'wt', etc.
+    compression: string or None
+        If given, open file using compression codec. Can either be a compression
+        name (a key in ``fsspec.compression.compr``) or "infer" to guess the
+        compression from the filename suffix.
+    encoding: str
+        For text mode only
+    errors: None or str
+        Passed to TextIOWrapper in text mode
+    name_function: function or None
+        if opening a set of files for writing, those files do not yet exist,
+        so we need to generate their names by formatting the urlpath for
+        each sequence number
+    num: int [1]
+        if writing mode, number of files we expect to create (passed to
+        name+function)
+    protocol: str or None
+        If given, overrides the protocol found in the URL.
+    newline: bytes or None
+        Used for line terminator in text mode. If None, uses system default;
+        if blank, uses no translation.
+    auto_mkdir: bool (True)
+        If in write mode, this will ensure the target directory exists before
+        writing, by calling ``fs.mkdirs(exist_ok=True)``.
+    expand: bool
+    **kwargs: dict
+        Extra options that make sense to a particular storage connection, e.g.
+        host, port, username, password, etc.
+
+    Examples
+    --------
+    >>> files = open_files('2015-*-*.csv')  # doctest: +SKIP
+    >>> files = open_files(
+    ...     's3://bucket/2015-*-*.csv.gz', compression='gzip'
+    ... )  # doctest: +SKIP
+
+    Returns
+    -------
+    An ``OpenFiles`` instance, which is a list of ``OpenFile`` objects that can
+    be used as a single context
+
+    Notes
+    -----
+    For a full list of the available protocols and the implementations that
+    they map across to see the latest online documentation:
+
+    - For implementations built into ``fsspec`` see
+      https://filesystem-spec.readthedocs.io/en/latest/api.html#built-in-implementations
+    - For implementations in separate packages see
+      https://filesystem-spec.readthedocs.io/en/latest/api.html#other-known-implementations
+    """
+    fs, fs_token, paths = get_fs_token_paths(
+        urlpath,
+        mode,
+        num=num,
+        name_function=name_function,
+        storage_options=kwargs,
+        protocol=protocol,
+        expand=expand,
+    )
+    if fs.protocol == "file":
+        fs.auto_mkdir = auto_mkdir
+    elif "r" not in mode and auto_mkdir:
+        parents = {fs._parent(path) for path in paths}
+        for parent in parents:
+            try:
+                fs.makedirs(parent, exist_ok=True)
+            except PermissionError:
+                pass
+    return OpenFiles(
+        [
+            OpenFile(
+                fs,
+                path,
+                mode=mode,
+                compression=compression,
+                encoding=encoding,
+                errors=errors,
+                newline=newline,
+            )
+            for path in paths
+        ],
+        mode=mode,
+        fs=fs,
+    )
+
+
+def _un_chain(path, kwargs):
+    x = re.compile(".*[^a-z]+.*")  # test for non protocol-like single word
+    bits = (
+        [p if "://" in p or x.match(p) else p + "://" for p in path.split("::")]
+        if "::" in path
+        else [path]
+    )
+    # [[url, protocol, kwargs], ...]
+    out = []
+    previous_bit = None
+    kwargs = kwargs.copy()
+    for bit in reversed(bits):
+        protocol = kwargs.pop("protocol", None) or split_protocol(bit)[0] or "file"
+        cls = get_filesystem_class(protocol)
+        extra_kwargs = cls._get_kwargs_from_urls(bit)
+        kws = kwargs.pop(protocol, {})
+        if bit is bits[0]:
+            kws.update(kwargs)
+        kw = dict(**extra_kwargs, **kws)
+        bit = cls._strip_protocol(bit)
+        if (
+            protocol in {"blockcache", "filecache", "simplecache"}
+            and "target_protocol" not in kw
+        ):
+            bit = previous_bit
+        out.append((bit, protocol, kw))
+        previous_bit = bit
+    out.reverse()
+    return out
+
+
+def url_to_fs(url, **kwargs):
+    """
+    Turn fully-qualified and potentially chained URL into filesystem instance
+
+    Parameters
+    ----------
+    url : str
+        The fsspec-compatible URL
+    **kwargs: dict
+        Extra options that make sense to a particular storage connection, e.g.
+        host, port, username, password, etc.
+
+    Returns
+    -------
+    filesystem : FileSystem
+        The new filesystem discovered from ``url`` and created with
+        ``**kwargs``.
+    urlpath : str
+        The file-systems-specific URL for ``url``.
+    """
+    # non-FS arguments that appear in fsspec.open()
+    # inspect could keep this in sync with open()'s signature
+    known_kwargs = {
+        "compression",
+        "encoding",
+        "errors",
+        "expand",
+        "mode",
+        "name_function",
+        "newline",
+        "num",
+    }
+    kwargs = {k: v for k, v in kwargs.items() if k not in known_kwargs}
+    chain = _un_chain(url, kwargs)
+    inkwargs = {}
+    # Reverse iterate the chain, creating a nested target_* structure
+    for i, ch in enumerate(reversed(chain)):
+        urls, protocol, kw = ch
+        if i == len(chain) - 1:
+            inkwargs = dict(**kw, **inkwargs)
+            continue
+        inkwargs["target_options"] = dict(**kw, **inkwargs)
+        inkwargs["target_protocol"] = protocol
+        inkwargs["fo"] = urls
+    urlpath, protocol, _ = chain[0]
+    fs = filesystem(protocol, **inkwargs)
+    return fs, urlpath
+
+
+def open(
+    urlpath,
+    mode="rb",
+    compression=None,
+    encoding="utf8",
+    errors=None,
+    protocol=None,
+    newline=None,
+    **kwargs,
+):
+    """Given a path or paths, return one ``OpenFile`` object.
+
+    Parameters
+    ----------
+    urlpath: string or list
+        Absolute or relative filepath. Prefix with a protocol like ``s3://``
+        to read from alternative filesystems. Should not include glob
+        character(s).
+    mode: 'rb', 'wt', etc.
+    compression: string or None
+        If given, open file using compression codec. Can either be a compression
+        name (a key in ``fsspec.compression.compr``) or "infer" to guess the
+        compression from the filename suffix.
+    encoding: str
+        For text mode only
+    errors: None or str
+        Passed to TextIOWrapper in text mode
+    protocol: str or None
+        If given, overrides the protocol found in the URL.
+    newline: bytes or None
+        Used for line terminator in text mode. If None, uses system default;
+        if blank, uses no translation.
+    **kwargs: dict
+        Extra options that make sense to a particular storage connection, e.g.
+        host, port, username, password, etc.
+
+    Examples
+    --------
+    >>> openfile = open('2015-01-01.csv')  # doctest: +SKIP
+    >>> openfile = open(
+    ...     's3://bucket/2015-01-01.csv.gz', compression='gzip'
+    ... )  # doctest: +SKIP
+    >>> with openfile as f:
+    ...     df = pd.read_csv(f)  # doctest: +SKIP
+    ...
+
+    Returns
+    -------
+    ``OpenFile`` object.
+
+    Notes
+    -----
+    For a full list of the available protocols and the implementations that
+    they map across to see the latest online documentation:
+
+    - For implementations built into ``fsspec`` see
+      https://filesystem-spec.readthedocs.io/en/latest/api.html#built-in-implementations
+    - For implementations in separate packages see
+      https://filesystem-spec.readthedocs.io/en/latest/api.html#other-known-implementations
+    """
+    kw = {"expand": False}
+    kw.update(kwargs)
+    out = open_files(
+        urlpath=[urlpath],
+        mode=mode,
+        compression=compression,
+        encoding=encoding,
+        errors=errors,
+        protocol=protocol,
+        newline=newline,
+        **kw,
+    )
+    if not out:
+        raise FileNotFoundError(urlpath)
+    return out[0]
+
+
+def open_local(
+    url: str | list[str] | Path | list[Path],
+    mode: str = "rb",
+    **storage_options: dict,
+) -> str | list[str]:
+    """Open file(s) which can be resolved to local
+
+    For files which either are local, or get downloaded upon open
+    (e.g., by file caching)
+
+    Parameters
+    ----------
+    url: str or list(str)
+    mode: str
+        Must be read mode
+    storage_options:
+        passed on to FS for or used by open_files (e.g., compression)
+    """
+    if "r" not in mode:
+        raise ValueError("Can only ensure local files when reading")
+    of = open_files(url, mode=mode, **storage_options)
+    if not getattr(of[0].fs, "local_file", False):
+        raise ValueError(
+            "open_local can only be used on a filesystem which"
+            " has attribute local_file=True"
+        )
+    with of as files:
+        paths = [f.name for f in files]
+    if (isinstance(url, str) and not has_magic(url)) or isinstance(url, Path):
+        return paths[0]
+    return paths
+
+
+def get_compression(urlpath, compression):
+    if compression == "infer":
+        compression = infer_compression(urlpath)
+    if compression is not None and compression not in compr:
+        raise ValueError(f"Compression type {compression} not supported")
+    return compression
+
+
+def split_protocol(urlpath):
+    """Return protocol, path pair"""
+    urlpath = stringify_path(urlpath)
+    if "://" in urlpath:
+        protocol, path = urlpath.split("://", 1)
+        if len(protocol) > 1:
+            # excludes Windows paths
+            return protocol, path
+    if urlpath.startswith("data:"):
+        return urlpath.split(":", 1)
+    return None, urlpath
+
+
+def strip_protocol(urlpath):
+    """Return only path part of full URL, according to appropriate backend"""
+    protocol, _ = split_protocol(urlpath)
+    cls = get_filesystem_class(protocol)
+    return cls._strip_protocol(urlpath)
+
+
+def expand_paths_if_needed(paths, mode, num, fs, name_function):
+    """Expand paths if they have a ``*`` in them (write mode) or any of ``*?[]``
+    in them (read mode).
+
+    :param paths: list of paths
+    mode: str
+        Mode in which to open files.
+    num: int
+        If opening in writing mode, number of files we expect to create.
+    fs: filesystem object
+    name_function: callable
+        If opening in writing mode, this callable is used to generate path
+        names. Names are generated for each partition by
+        ``urlpath.replace('*', name_function(partition_index))``.
+    :return: list of paths
+    """
+    expanded_paths = []
+    paths = list(paths)
+
+    if "w" in mode:  # read mode
+        if sum([1 for p in paths if "*" in p]) > 1:
+            raise ValueError(
+                "When writing data, only one filename mask can be specified."
+            )
+        num = max(num, len(paths))
+
+        for curr_path in paths:
+            if "*" in curr_path:
+                # expand using name_function
+                expanded_paths.extend(_expand_paths(curr_path, name_function, num))
+            else:
+                expanded_paths.append(curr_path)
+        # if we generated more paths that asked for, trim the list
+        if len(expanded_paths) > num:
+            expanded_paths = expanded_paths[:num]
+
+    else:  # read mode
+        for curr_path in paths:
+            if has_magic(curr_path):
+                # expand using glob
+                expanded_paths.extend(fs.glob(curr_path))
+            else:
+                expanded_paths.append(curr_path)
+
+    return expanded_paths
+
+
+def get_fs_token_paths(
+    urlpath,
+    mode="rb",
+    num=1,
+    name_function=None,
+    storage_options=None,
+    protocol=None,
+    expand=True,
+):
+    """Filesystem, deterministic token, and paths from a urlpath and options.
+
+    Parameters
+    ----------
+    urlpath: string or iterable
+        Absolute or relative filepath, URL (may include protocols like
+        ``s3://``), or globstring pointing to data.
+    mode: str, optional
+        Mode in which to open files.
+    num: int, optional
+        If opening in writing mode, number of files we expect to create.
+    name_function: callable, optional
+        If opening in writing mode, this callable is used to generate path
+        names. Names are generated for each partition by
+        ``urlpath.replace('*', name_function(partition_index))``.
+    storage_options: dict, optional
+        Additional keywords to pass to the filesystem class.
+    protocol: str or None
+        To override the protocol specifier in the URL
+    expand: bool
+        Expand string paths for writing, assuming the path is a directory
+    """
+    if isinstance(urlpath, (list, tuple, set)):
+        if not urlpath:
+            raise ValueError("empty urlpath sequence")
+        urlpath0 = stringify_path(list(urlpath)[0])
+    else:
+        urlpath0 = stringify_path(urlpath)
+    storage_options = storage_options or {}
+    if protocol:
+        storage_options["protocol"] = protocol
+    chain = _un_chain(urlpath0, storage_options or {})
+    inkwargs = {}
+    # Reverse iterate the chain, creating a nested target_* structure
+    for i, ch in enumerate(reversed(chain)):
+        urls, nested_protocol, kw = ch
+        if i == len(chain) - 1:
+            inkwargs = dict(**kw, **inkwargs)
+            continue
+        inkwargs["target_options"] = dict(**kw, **inkwargs)
+        inkwargs["target_protocol"] = nested_protocol
+        inkwargs["fo"] = urls
+    paths, protocol, _ = chain[0]
+    fs = filesystem(protocol, **inkwargs)
+    if isinstance(urlpath, (list, tuple, set)):
+        pchains = [
+            _un_chain(stringify_path(u), storage_options or {})[0] for u in urlpath
+        ]
+        if len({pc[1] for pc in pchains}) > 1:
+            raise ValueError("Protocol mismatch getting fs from %s", urlpath)
+        paths = [pc[0] for pc in pchains]
+    else:
+        paths = fs._strip_protocol(paths)
+    if isinstance(paths, (list, tuple, set)):
+        if expand:
+            paths = expand_paths_if_needed(paths, mode, num, fs, name_function)
+        elif not isinstance(paths, list):
+            paths = list(paths)
+    else:
+        if "w" in mode and expand:
+            paths = _expand_paths(paths, name_function, num)
+        elif "x" in mode and expand:
+            paths = _expand_paths(paths, name_function, num)
+        elif "*" in paths:
+            paths = [f for f in sorted(fs.glob(paths)) if not fs.isdir(f)]
+        else:
+            paths = [paths]
+
+    return fs, fs._fs_token, paths
+
+
+def _expand_paths(path, name_function, num):
+    if isinstance(path, str):
+        if path.count("*") > 1:
+            raise ValueError("Output path spec must contain exactly one '*'.")
+        elif "*" not in path:
+            path = os.path.join(path, "*.part")
+
+        if name_function is None:
+            name_function = build_name_function(num - 1)
+
+        paths = [path.replace("*", name_function(i)) for i in range(num)]
+        if paths != sorted(paths):
+            logger.warning(
+                "In order to preserve order between partitions"
+                " paths created with ``name_function`` should "
+                "sort to partition order"
+            )
+    elif isinstance(path, (tuple, list)):
+        assert len(path) == num
+        paths = list(path)
+    else:
+        raise ValueError(
+            "Path should be either\n"
+            "1. A list of paths: ['foo.json', 'bar.json', ...]\n"
+            "2. A directory: 'foo/\n"
+            "3. A path with a '*' in it: 'foo.*.json'"
+        )
+    return paths
+
+
+class PickleableTextIOWrapper(io.TextIOWrapper):
+    """TextIOWrapper cannot be pickled. This solves it.
+
+    Requires that ``buffer`` be pickleable, which all instances of
+    AbstractBufferedFile are.
+    """
+
+    def __init__(
+        self,
+        buffer,
+        encoding=None,
+        errors=None,
+        newline=None,
+        line_buffering=False,
+        write_through=False,
+    ):
+        self.args = buffer, encoding, errors, newline, line_buffering, write_through
+        super().__init__(*self.args)
+
+    def __reduce__(self):
+        return PickleableTextIOWrapper, self.args
diff --git a/llm/Lib/site-packages/fsspec/dircache.py b/llm/Lib/site-packages/fsspec/dircache.py
new file mode 100644
index 0000000000000000000000000000000000000000..eca19566b135e5a7a4f6e7407d56411ec58bfe44
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/dircache.py
@@ -0,0 +1,98 @@
+import time
+from collections.abc import MutableMapping
+from functools import lru_cache
+
+
+class DirCache(MutableMapping):
+    """
+    Caching of directory listings, in a structure like::
+
+        {"path0": [
+            {"name": "path0/file0",
+             "size": 123,
+             "type": "file",
+             ...
+            },
+            {"name": "path0/file1",
+            },
+            ...
+            ],
+         "path1": [...]
+        }
+
+    Parameters to this class control listing expiry or indeed turn
+    caching off
+    """
+
+    def __init__(
+        self,
+        use_listings_cache=True,
+        listings_expiry_time=None,
+        max_paths=None,
+        **kwargs,
+    ):
+        """
+
+        Parameters
+        ----------
+        use_listings_cache: bool
+            If False, this cache never returns items, but always reports KeyError,
+            and setting items has no effect
+        listings_expiry_time: int or float (optional)
+            Time in seconds that a listing is considered valid. If None,
+            listings do not expire.
+        max_paths: int (optional)
+            The number of most recent listings that are considered valid; 'recent'
+            refers to when the entry was set.
+        """
+        self._cache = {}
+        self._times = {}
+        if max_paths:
+            self._q = lru_cache(max_paths + 1)(lambda key: self._cache.pop(key, None))
+        self.use_listings_cache = use_listings_cache
+        self.listings_expiry_time = listings_expiry_time
+        self.max_paths = max_paths
+
+    def __getitem__(self, item):
+        if self.listings_expiry_time is not None:
+            if self._times.get(item, 0) - time.time() < -self.listings_expiry_time:
+                del self._cache[item]
+        if self.max_paths:
+            self._q(item)
+        return self._cache[item]  # maybe raises KeyError
+
+    def clear(self):
+        self._cache.clear()
+
+    def __len__(self):
+        return len(self._cache)
+
+    def __contains__(self, item):
+        try:
+            self[item]
+            return True
+        except KeyError:
+            return False
+
+    def __setitem__(self, key, value):
+        if not self.use_listings_cache:
+            return
+        if self.max_paths:
+            self._q(key)
+        self._cache[key] = value
+        if self.listings_expiry_time is not None:
+            self._times[key] = time.time()
+
+    def __delitem__(self, key):
+        del self._cache[key]
+
+    def __iter__(self):
+        entries = list(self._cache)
+
+        return (k for k in entries if k in self)
+
+    def __reduce__(self):
+        return (
+            DirCache,
+            (self.use_listings_cache, self.listings_expiry_time, self.max_paths),
+        )
diff --git a/llm/Lib/site-packages/fsspec/exceptions.py b/llm/Lib/site-packages/fsspec/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..0593f0e5804fc7077b76a426aee5d9d3f6cec5d8
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/exceptions.py
@@ -0,0 +1,17 @@
+"""
+fsspec user-defined exception classes
+"""
+import asyncio
+
+
+class BlocksizeMismatchError(ValueError):
+    """
+    Raised when a cached file is opened with a different blocksize than it was
+    written with
+    """
+
+
+class FSTimeoutError(asyncio.TimeoutError):
+    """
+    Raised when a fsspec function timed out occurs
+    """
diff --git a/llm/Lib/site-packages/fsspec/fuse.py b/llm/Lib/site-packages/fsspec/fuse.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ca8c973c1993ac00016bb46e3ae7a3e44bc8d15
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/fuse.py
@@ -0,0 +1,324 @@
+import argparse
+import logging
+import os
+import stat
+import threading
+import time
+from errno import EIO, ENOENT
+
+from fuse import FUSE, FuseOSError, LoggingMixIn, Operations
+
+from fsspec import __version__
+from fsspec.core import url_to_fs
+
+logger = logging.getLogger("fsspec.fuse")
+
+
+class FUSEr(Operations):
+    def __init__(self, fs, path, ready_file=False):
+        self.fs = fs
+        self.cache = {}
+        self.root = path.rstrip("/") + "/"
+        self.counter = 0
+        logger.info("Starting FUSE at %s", path)
+        self._ready_file = ready_file
+
+    def getattr(self, path, fh=None):
+        logger.debug("getattr %s", path)
+        if self._ready_file and path in ["/.fuse_ready", ".fuse_ready"]:
+            return {"type": "file", "st_size": 5}
+
+        path = "".join([self.root, path.lstrip("/")]).rstrip("/")
+        try:
+            info = self.fs.info(path)
+        except FileNotFoundError:
+            raise FuseOSError(ENOENT)
+
+        data = {"st_uid": info.get("uid", 1000), "st_gid": info.get("gid", 1000)}
+        perm = info.get("mode", 0o777)
+
+        if info["type"] != "file":
+            data["st_mode"] = stat.S_IFDIR | perm
+            data["st_size"] = 0
+            data["st_blksize"] = 0
+        else:
+            data["st_mode"] = stat.S_IFREG | perm
+            data["st_size"] = info["size"]
+            data["st_blksize"] = 5 * 2**20
+            data["st_nlink"] = 1
+        data["st_atime"] = info["atime"] if "atime" in info else time.time()
+        data["st_ctime"] = info["ctime"] if "ctime" in info else time.time()
+        data["st_mtime"] = info["mtime"] if "mtime" in info else time.time()
+        return data
+
+    def readdir(self, path, fh):
+        logger.debug("readdir %s", path)
+        path = "".join([self.root, path.lstrip("/")])
+        files = self.fs.ls(path, False)
+        files = [os.path.basename(f.rstrip("/")) for f in files]
+        return [".", ".."] + files
+
+    def mkdir(self, path, mode):
+        path = "".join([self.root, path.lstrip("/")])
+        self.fs.mkdir(path)
+        return 0
+
+    def rmdir(self, path):
+        path = "".join([self.root, path.lstrip("/")])
+        self.fs.rmdir(path)
+        return 0
+
+    def read(self, path, size, offset, fh):
+        logger.debug("read %s", (path, size, offset))
+        if self._ready_file and path in ["/.fuse_ready", ".fuse_ready"]:
+            # status indicator
+            return b"ready"
+
+        f = self.cache[fh]
+        f.seek(offset)
+        out = f.read(size)
+        return out
+
+    def write(self, path, data, offset, fh):
+        logger.debug("write %s", (path, offset))
+        f = self.cache[fh]
+        f.seek(offset)
+        f.write(data)
+        return len(data)
+
+    def create(self, path, flags, fi=None):
+        logger.debug("create %s", (path, flags))
+        fn = "".join([self.root, path.lstrip("/")])
+        self.fs.touch(fn)  # OS will want to get attributes immediately
+        f = self.fs.open(fn, "wb")
+        self.cache[self.counter] = f
+        self.counter += 1
+        return self.counter - 1
+
+    def open(self, path, flags):
+        logger.debug("open %s", (path, flags))
+        fn = "".join([self.root, path.lstrip("/")])
+        if flags % 2 == 0:
+            # read
+            mode = "rb"
+        else:
+            # write/create
+            mode = "wb"
+        self.cache[self.counter] = self.fs.open(fn, mode)
+        self.counter += 1
+        return self.counter - 1
+
+    def truncate(self, path, length, fh=None):
+        fn = "".join([self.root, path.lstrip("/")])
+        if length != 0:
+            raise NotImplementedError
+        # maybe should be no-op since open with write sets size to zero anyway
+        self.fs.touch(fn)
+
+    def unlink(self, path):
+        fn = "".join([self.root, path.lstrip("/")])
+        try:
+            self.fs.rm(fn, False)
+        except (OSError, FileNotFoundError):
+            raise FuseOSError(EIO)
+
+    def release(self, path, fh):
+        try:
+            if fh in self.cache:
+                f = self.cache[fh]
+                f.close()
+                self.cache.pop(fh)
+        except Exception as e:
+            print(e)
+        return 0
+
+    def chmod(self, path, mode):
+        if hasattr(self.fs, "chmod"):
+            path = "".join([self.root, path.lstrip("/")])
+            return self.fs.chmod(path, mode)
+        raise NotImplementedError
+
+
+def run(
+    fs,
+    path,
+    mount_point,
+    foreground=True,
+    threads=False,
+    ready_file=False,
+    ops_class=FUSEr,
+):
+    """Mount stuff in a local directory
+
+    This uses fusepy to make it appear as if a given path on an fsspec
+    instance is in fact resident within the local file-system.
+
+    This requires that fusepy by installed, and that FUSE be available on
+    the system (typically requiring a package to be installed with
+    apt, yum, brew, etc.).
+
+    Parameters
+    ----------
+    fs: file-system instance
+        From one of the compatible implementations
+    path: str
+        Location on that file-system to regard as the root directory to
+        mount. Note that you typically should include the terminating "/"
+        character.
+    mount_point: str
+        An empty directory on the local file-system where the contents of
+        the remote path will appear.
+    foreground: bool
+        Whether or not calling this function will block. Operation will
+        typically be more stable if True.
+    threads: bool
+        Whether or not to create threads when responding to file operations
+        within the mounter directory. Operation will typically be more
+        stable if False.
+    ready_file: bool
+        Whether the FUSE process is ready. The ``.fuse_ready`` file will
+        exist in the ``mount_point`` directory if True. Debugging purpose.
+    ops_class: FUSEr or Subclass of FUSEr
+        To override the default behavior of FUSEr. For Example, logging
+        to file.
+
+    """
+    func = lambda: FUSE(
+        ops_class(fs, path, ready_file=ready_file),
+        mount_point,
+        nothreads=not threads,
+        foreground=foreground,
+    )
+    if not foreground:
+        th = threading.Thread(target=func)
+        th.daemon = True
+        th.start()
+        return th
+    else:  # pragma: no cover
+        try:
+            func()
+        except KeyboardInterrupt:
+            pass
+
+
+def main(args):
+    """Mount filesystem from chained URL to MOUNT_POINT.
+
+    Examples:
+
+    python3 -m fsspec.fuse memory /usr/share /tmp/mem
+
+    python3 -m fsspec.fuse local /tmp/source /tmp/local \\
+            -l /tmp/fsspecfuse.log
+
+    You can also mount chained-URLs and use special settings:
+
+    python3 -m fsspec.fuse 'filecache::zip::file://data.zip' \\
+            / /tmp/zip \\
+            -o 'filecache-cache_storage=/tmp/simplecache'
+
+    You can specify the type of the setting by using `[int]` or `[bool]`,
+    (`true`, `yes`, `1` represents the Boolean value `True`):
+
+    python3 -m fsspec.fuse 'simplecache::ftp://ftp1.at.proftpd.org' \\
+            /historic/packages/RPMS /tmp/ftp \\
+            -o 'simplecache-cache_storage=/tmp/simplecache' \\
+            -o 'simplecache-check_files=false[bool]' \\
+            -o 'ftp-listings_expiry_time=60[int]' \\
+            -o 'ftp-username=anonymous' \\
+            -o 'ftp-password=xieyanbo'
+    """
+
+    class RawDescriptionArgumentParser(argparse.ArgumentParser):
+        def format_help(self):
+            usage = super().format_help()
+            parts = usage.split("\n\n")
+            parts[1] = self.description.rstrip()
+            return "\n\n".join(parts)
+
+    parser = RawDescriptionArgumentParser(prog="fsspec.fuse", description=main.__doc__)
+    parser.add_argument("--version", action="version", version=__version__)
+    parser.add_argument("url", type=str, help="fs url")
+    parser.add_argument("source_path", type=str, help="source directory in fs")
+    parser.add_argument("mount_point", type=str, help="local directory")
+    parser.add_argument(
+        "-o",
+        "--option",
+        action="append",
+        help="Any options of protocol included in the chained URL",
+    )
+    parser.add_argument(
+        "-l", "--log-file", type=str, help="Logging FUSE debug info (Default: '')"
+    )
+    parser.add_argument(
+        "-f",
+        "--foreground",
+        action="store_false",
+        help="Running in foreground or not (Default: False)",
+    )
+    parser.add_argument(
+        "-t",
+        "--threads",
+        action="store_false",
+        help="Running with threads support (Default: False)",
+    )
+    parser.add_argument(
+        "-r",
+        "--ready-file",
+        action="store_false",
+        help="The `.fuse_ready` file will exist after FUSE is ready. "
+        "(Debugging purpose, Default: False)",
+    )
+    args = parser.parse_args(args)
+
+    kwargs = {}
+    for item in args.option or []:
+        key, sep, value = item.partition("=")
+        if not sep:
+            parser.error(message=f"Wrong option: {item!r}")
+        val = value.lower()
+        if val.endswith("[int]"):
+            value = int(value[: -len("[int]")])
+        elif val.endswith("[bool]"):
+            value = val[: -len("[bool]")] in ["1", "yes", "true"]
+
+        if "-" in key:
+            fs_name, setting_name = key.split("-", 1)
+            if fs_name in kwargs:
+                kwargs[fs_name][setting_name] = value
+            else:
+                kwargs[fs_name] = {setting_name: value}
+        else:
+            kwargs[key] = value
+
+    if args.log_file:
+        logging.basicConfig(
+            level=logging.DEBUG,
+            filename=args.log_file,
+            format="%(asctime)s %(message)s",
+        )
+
+        class LoggingFUSEr(FUSEr, LoggingMixIn):
+            pass
+
+        fuser = LoggingFUSEr
+    else:
+        fuser = FUSEr
+
+    fs, url_path = url_to_fs(args.url, **kwargs)
+    logger.debug("Mounting %s to %s", url_path, str(args.mount_point))
+    run(
+        fs,
+        args.source_path,
+        args.mount_point,
+        foreground=args.foreground,
+        threads=args.threads,
+        ready_file=args.ready_file,
+        ops_class=fuser,
+    )
+
+
+if __name__ == "__main__":
+    import sys
+
+    main(sys.argv[1:])
diff --git a/llm/Lib/site-packages/fsspec/generic.py b/llm/Lib/site-packages/fsspec/generic.py
new file mode 100644
index 0000000000000000000000000000000000000000..4fb58ac5b4035c9af01273c115e6409a19b26488
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/generic.py
@@ -0,0 +1,408 @@
+from __future__ import annotations
+
+import inspect
+import logging
+import os
+import shutil
+import uuid
+from typing import Optional
+
+from .asyn import AsyncFileSystem, _run_coros_in_chunks, sync_wrapper
+from .callbacks import DEFAULT_CALLBACK
+from .core import filesystem, get_filesystem_class, split_protocol, url_to_fs
+
+_generic_fs = {}
+logger = logging.getLogger("fsspec.generic")
+
+
+def set_generic_fs(protocol, **storage_options):
+    _generic_fs[protocol] = filesystem(protocol, **storage_options)
+
+
+default_method = "default"
+
+
+def _resolve_fs(url, method=None, protocol=None, storage_options=None):
+    """Pick instance of backend FS"""
+    method = method or default_method
+    protocol = protocol or split_protocol(url)[0]
+    storage_options = storage_options or {}
+    if method == "default":
+        return filesystem(protocol)
+    if method == "generic":
+        return _generic_fs[protocol]
+    if method == "current":
+        cls = get_filesystem_class(protocol)
+        return cls.current()
+    if method == "options":
+        fs, _ = url_to_fs(url, **storage_options.get(protocol, {}))
+        return fs
+    raise ValueError(f"Unknown FS resolution method: {method}")
+
+
+def rsync(
+    source,
+    destination,
+    delete_missing=False,
+    source_field="size",
+    dest_field="size",
+    update_cond="different",
+    inst_kwargs=None,
+    fs=None,
+    **kwargs,
+):
+    """Sync files between two directory trees
+
+    (experimental)
+
+    Parameters
+    ----------
+    source: str
+        Root of the directory tree to take files from. This must be a directory, but
+        do not include any terminating "/" character
+    destination: str
+        Root path to copy into. The contents of this location should be
+        identical to the contents of ``source`` when done. This will be made a
+        directory, and the terminal "/" should not be included.
+    delete_missing: bool
+        If there are paths in the destination that don't exist in the
+        source and this is True, delete them. Otherwise, leave them alone.
+    source_field: str | callable
+        If ``update_field`` is "different", this is the key in the info
+        of source files to consider for difference. Maybe a function of the
+        info dict.
+    dest_field: str | callable
+        If ``update_field`` is "different", this is the key in the info
+        of destination files to consider for difference. May be a function of
+        the info dict.
+    update_cond: "different"|"always"|"never"
+        If "always", every file is copied, regardless of whether it exists in
+        the destination. If "never", files that exist in the destination are
+        not copied again. If "different" (default), only copy if the info
+        fields given by ``source_field`` and ``dest_field`` (usually "size")
+        are different. Other comparisons may be added in the future.
+    inst_kwargs: dict|None
+        If ``fs`` is None, use this set of keyword arguments to make a
+        GenericFileSystem instance
+    fs: GenericFileSystem|None
+        Instance to use if explicitly given. The instance defines how to
+        to make downstream file system instances from paths.
+
+    Returns
+    -------
+    dict of the copy operations that were performed, {source: destination}
+    """
+    fs = fs or GenericFileSystem(**(inst_kwargs or {}))
+    source = fs._strip_protocol(source)
+    destination = fs._strip_protocol(destination)
+    allfiles = fs.find(source, withdirs=True, detail=True)
+    if not fs.isdir(source):
+        raise ValueError("Can only rsync on a directory")
+    otherfiles = fs.find(destination, withdirs=True, detail=True)
+    dirs = [
+        a
+        for a, v in allfiles.items()
+        if v["type"] == "directory" and a.replace(source, destination) not in otherfiles
+    ]
+    logger.debug(f"{len(dirs)} directories to create")
+    if dirs:
+        fs.make_many_dirs(
+            [dirn.replace(source, destination) for dirn in dirs], exist_ok=True
+        )
+    allfiles = {a: v for a, v in allfiles.items() if v["type"] == "file"}
+    logger.debug(f"{len(allfiles)} files to consider for copy")
+    to_delete = [
+        o
+        for o, v in otherfiles.items()
+        if o.replace(destination, source) not in allfiles and v["type"] == "file"
+    ]
+    for k, v in allfiles.copy().items():
+        otherfile = k.replace(source, destination)
+        if otherfile in otherfiles:
+            if update_cond == "always":
+                allfiles[k] = otherfile
+            elif update_cond == "different":
+                inf1 = source_field(v) if callable(source_field) else v[source_field]
+                v2 = otherfiles[otherfile]
+                inf2 = dest_field(v2) if callable(dest_field) else v2[dest_field]
+                if inf1 != inf2:
+                    # details mismatch, make copy
+                    allfiles[k] = otherfile
+                else:
+                    # details match, don't copy
+                    allfiles.pop(k)
+        else:
+            # file not in target yet
+            allfiles[k] = otherfile
+    logger.debug(f"{len(allfiles)} files to copy")
+    if allfiles:
+        source_files, target_files = zip(*allfiles.items())
+        fs.cp(source_files, target_files, **kwargs)
+    logger.debug(f"{len(to_delete)} files to delete")
+    if delete_missing:
+        fs.rm(to_delete)
+    return allfiles
+
+
+class GenericFileSystem(AsyncFileSystem):
+    """Wrapper over all other FS types
+
+    <experimental!>
+
+    This implementation is a single unified interface to be able to run FS operations
+    over generic URLs, and dispatch to the specific implementations using the URL
+    protocol prefix.
+
+    Note: instances of this FS are always async, even if you never use it with any async
+    backend.
+    """
+
+    protocol = "generic"  # there is no real reason to ever use a protocol with this FS
+
+    def __init__(self, default_method="default", **kwargs):
+        """
+
+        Parameters
+        ----------
+        default_method: str (optional)
+            Defines how to configure backend FS instances. Options are:
+            - "default": instantiate like FSClass(), with no
+              extra arguments; this is the default instance of that FS, and can be
+              configured via the config system
+            - "generic": takes instances from the `_generic_fs` dict in this module,
+              which you must populate before use. Keys are by protocol
+            - "current": takes the most recently instantiated version of each FS
+        """
+        self.method = default_method
+        super().__init__(**kwargs)
+
+    def _parent(self, path):
+        fs = _resolve_fs(path, self.method)
+        return fs.unstrip_protocol(fs._parent(path))
+
+    def _strip_protocol(self, path):
+        # normalization only
+        fs = _resolve_fs(path, self.method)
+        return fs.unstrip_protocol(fs._strip_protocol(path))
+
+    async def _find(self, path, maxdepth=None, withdirs=False, detail=False, **kwargs):
+        fs = _resolve_fs(path, self.method)
+        if fs.async_impl:
+            out = await fs._find(
+                path, maxdepth=maxdepth, withdirs=withdirs, detail=True, **kwargs
+            )
+        else:
+            out = fs.find(
+                path, maxdepth=maxdepth, withdirs=withdirs, detail=True, **kwargs
+            )
+        result = {}
+        for k, v in out.items():
+            name = fs.unstrip_protocol(k)
+            v["name"] = name
+            result[name] = v
+        if detail:
+            return result
+        return list(result)
+
+    async def _info(self, url, **kwargs):
+        fs = _resolve_fs(url, self.method)
+        if fs.async_impl:
+            out = await fs._info(url, **kwargs)
+        else:
+            out = fs.info(url, **kwargs)
+        out["name"] = fs.unstrip_protocol(out["name"])
+        return out
+
+    async def _ls(
+        self,
+        url,
+        detail=True,
+        **kwargs,
+    ):
+        fs = _resolve_fs(url, self.method)
+        if fs.async_impl:
+            out = await fs._ls(url, detail=True, **kwargs)
+        else:
+            out = fs.ls(url, detail=True, **kwargs)
+        for o in out:
+            o["name"] = fs.unstrip_protocol(o["name"])
+        if detail:
+            return out
+        else:
+            return [o["name"] for o in out]
+
+    async def _cat_file(
+        self,
+        url,
+        **kwargs,
+    ):
+        fs = _resolve_fs(url, self.method)
+        if fs.async_impl:
+            return await fs._cat_file(url, **kwargs)
+        else:
+            return fs.cat_file(url, **kwargs)
+
+    async def _pipe_file(
+        self,
+        path,
+        value,
+        **kwargs,
+    ):
+        fs = _resolve_fs(path, self.method)
+        if fs.async_impl:
+            return await fs._pipe_file(path, value, **kwargs)
+        else:
+            return fs.pipe_file(path, value, **kwargs)
+
+    async def _rm(self, url, **kwargs):
+        urls = url
+        if isinstance(urls, str):
+            urls = [urls]
+        fs = _resolve_fs(urls[0], self.method)
+        if fs.async_impl:
+            await fs._rm(urls, **kwargs)
+        else:
+            fs.rm(url, **kwargs)
+
+    async def _makedirs(self, path, exist_ok=False):
+        logger.debug("Make dir %s", path)
+        fs = _resolve_fs(path, self.method)
+        if fs.async_impl:
+            await fs._makedirs(path, exist_ok=exist_ok)
+        else:
+            fs.makedirs(path, exist_ok=exist_ok)
+
+    def rsync(self, source, destination, **kwargs):
+        """Sync files between two directory trees
+
+        See `func:rsync` for more details.
+        """
+        rsync(source, destination, fs=self, **kwargs)
+
+    async def _cp_file(
+        self,
+        url,
+        url2,
+        blocksize=2**20,
+        callback=DEFAULT_CALLBACK,
+        **kwargs,
+    ):
+        fs = _resolve_fs(url, self.method)
+        fs2 = _resolve_fs(url2, self.method)
+        if fs is fs2:
+            # pure remote
+            if fs.async_impl:
+                return await fs._cp_file(url, url2, **kwargs)
+            else:
+                return fs.cp_file(url, url2, **kwargs)
+        kw = {"blocksize": 0, "cache_type": "none"}
+        try:
+            f1 = (
+                await fs.open_async(url, "rb")
+                if hasattr(fs, "open_async")
+                else fs.open(url, "rb", **kw)
+            )
+            callback.set_size(await maybe_await(f1.size))
+            f2 = (
+                await fs2.open_async(url2, "wb")
+                if hasattr(fs2, "open_async")
+                else fs2.open(url2, "wb", **kw)
+            )
+            while f1.size is None or f2.tell() < f1.size:
+                data = await maybe_await(f1.read(blocksize))
+                if f1.size is None and not data:
+                    break
+                await maybe_await(f2.write(data))
+                callback.absolute_update(f2.tell())
+        finally:
+            try:
+                await maybe_await(f2.close())
+                await maybe_await(f1.close())
+            except NameError:
+                # fail while opening f1 or f2
+                pass
+
+    async def _make_many_dirs(self, urls, exist_ok=True):
+        fs = _resolve_fs(urls[0], self.method)
+        if fs.async_impl:
+            coros = [fs._makedirs(u, exist_ok=exist_ok) for u in urls]
+            await _run_coros_in_chunks(coros)
+        else:
+            for u in urls:
+                fs.makedirs(u, exist_ok=exist_ok)
+
+    make_many_dirs = sync_wrapper(_make_many_dirs)
+
+    async def _copy(
+        self,
+        path1: list[str],
+        path2: list[str],
+        recursive: bool = False,
+        on_error: str = "ignore",
+        maxdepth: Optional[int] = None,
+        batch_size: Optional[int] = None,
+        tempdir: Optional[str] = None,
+        **kwargs,
+    ):
+        if recursive:
+            raise NotImplementedError
+        fs = _resolve_fs(path1[0], self.method)
+        fs2 = _resolve_fs(path2[0], self.method)
+        # not expanding paths atm., assume call is from rsync()
+        if fs is fs2:
+            # pure remote
+            if fs.async_impl:
+                return await fs._copy(path1, path2, **kwargs)
+            else:
+                return fs.copy(path1, path2, **kwargs)
+        await copy_file_op(
+            fs, path1, fs2, path2, tempdir, batch_size, on_error=on_error
+        )
+
+
+async def copy_file_op(
+    fs1, url1, fs2, url2, tempdir=None, batch_size=20, on_error="ignore"
+):
+    import tempfile
+
+    tempdir = tempdir or tempfile.mkdtemp()
+    try:
+        coros = [
+            _copy_file_op(
+                fs1,
+                u1,
+                fs2,
+                u2,
+                os.path.join(tempdir, uuid.uuid4().hex),
+                on_error=on_error,
+            )
+            for u1, u2 in zip(url1, url2)
+        ]
+        await _run_coros_in_chunks(coros, batch_size=batch_size)
+    finally:
+        shutil.rmtree(tempdir)
+
+
+async def _copy_file_op(fs1, url1, fs2, url2, local, on_error="ignore"):
+    ex = () if on_error == "raise" else Exception
+    logger.debug("Copy %s -> %s", url1, url2)
+    try:
+        if fs1.async_impl:
+            await fs1._get_file(url1, local)
+        else:
+            fs1.get_file(url1, local)
+        if fs2.async_impl:
+            await fs2._put_file(local, url2)
+        else:
+            fs2.put_file(local, url2)
+        os.unlink(local)
+        logger.debug("Copy %s -> %s; done", url1, url2)
+    except ex as e:
+        logger.debug("ignoring cp exception for %s: %s", url1, e)
+
+
+async def maybe_await(cor):
+    if inspect.iscoroutine(cor):
+        return await cor
+    else:
+        return cor
diff --git a/llm/Lib/site-packages/fsspec/gui.py b/llm/Lib/site-packages/fsspec/gui.py
new file mode 100644
index 0000000000000000000000000000000000000000..14fc4935cb8184ff2910f7cf9f7c6ec2993d819c
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/gui.py
@@ -0,0 +1,414 @@
+import ast
+import contextlib
+import logging
+import os
+import re
+from typing import ClassVar, Sequence
+
+import panel as pn
+
+from .core import OpenFile, get_filesystem_class, split_protocol
+from .registry import known_implementations
+
+pn.extension()
+logger = logging.getLogger("fsspec.gui")
+
+
+class SigSlot:
+    """Signal-slot mixin, for Panel event passing
+
+    Include this class in a widget manager's superclasses to be able to
+    register events and callbacks on Panel widgets managed by that class.
+
+    The method ``_register`` should be called as widgets are added, and external
+    code should call ``connect`` to associate callbacks.
+
+    By default, all signals emit a DEBUG logging statement.
+    """
+
+    # names of signals that this class may emit each of which must be
+    # set by _register for any new instance
+    signals: ClassVar[Sequence[str]] = []
+    # names of actions that this class may respond to
+    slots: ClassVar[Sequence[str]] = []
+
+    # each of which must be a method name
+
+    def __init__(self):
+        self._ignoring_events = False
+        self._sigs = {}
+        self._map = {}
+        self._setup()
+
+    def _setup(self):
+        """Create GUI elements and register signals"""
+        self.panel = pn.pane.PaneBase()
+        # no signals to set up in the base class
+
+    def _register(
+        self, widget, name, thing="value", log_level=logging.DEBUG, auto=False
+    ):
+        """Watch the given attribute of a widget and assign it a named event
+
+        This is normally called at the time a widget is instantiated, in the
+        class which owns it.
+
+        Parameters
+        ----------
+        widget : pn.layout.Panel or None
+            Widget to watch. If None, an anonymous signal not associated with
+            any widget.
+        name : str
+            Name of this event
+        thing : str
+            Attribute of the given widget to watch
+        log_level : int
+            When the signal is triggered, a logging event of the given level
+            will be fired in the dfviz logger.
+        auto : bool
+            If True, automatically connects with a method in this class of the
+            same name.
+        """
+        if name not in self.signals:
+            raise ValueError(f"Attempt to assign an undeclared signal: {name}")
+        self._sigs[name] = {
+            "widget": widget,
+            "callbacks": [],
+            "thing": thing,
+            "log": log_level,
+        }
+        wn = "-".join(
+            [
+                getattr(widget, "name", str(widget)) if widget is not None else "none",
+                thing,
+            ]
+        )
+        self._map[wn] = name
+        if widget is not None:
+            widget.param.watch(self._signal, thing, onlychanged=True)
+        if auto and hasattr(self, name):
+            self.connect(name, getattr(self, name))
+
+    def _repr_mimebundle_(self, *args, **kwargs):
+        """Display in a notebook or a server"""
+        try:
+            return self.panel._repr_mimebundle_(*args, **kwargs)
+        except (ValueError, AttributeError):
+            raise NotImplementedError("Panel does not seem to be set " "up properly")
+
+    def connect(self, signal, slot):
+        """Associate call back with given event
+
+        The callback must be a function which takes the "new" value of the
+        watched attribute as the only parameter. If the callback return False,
+        this cancels any further processing of the given event.
+
+        Alternatively, the callback can be a string, in which case it means
+        emitting the correspondingly-named event (i.e., connect to self)
+        """
+        self._sigs[signal]["callbacks"].append(slot)
+
+    def _signal(self, event):
+        """This is called by a an action on a widget
+
+        Within an self.ignore_events context, nothing happens.
+
+        Tests can execute this method by directly changing the values of
+        widget components.
+        """
+        if not self._ignoring_events:
+            wn = "-".join([event.obj.name, event.name])
+            if wn in self._map and self._map[wn] in self._sigs:
+                self._emit(self._map[wn], event.new)
+
+    @contextlib.contextmanager
+    def ignore_events(self):
+        """Temporarily turn off events processing in this instance
+
+        (does not propagate to children)
+        """
+        self._ignoring_events = True
+        try:
+            yield
+        finally:
+            self._ignoring_events = False
+
+    def _emit(self, sig, value=None):
+        """An event happened, call its callbacks
+
+        This method can be used in tests to simulate message passing without
+        directly changing visual elements.
+
+        Calling of callbacks will halt whenever one returns False.
+        """
+        logger.log(self._sigs[sig]["log"], f"{sig}: {value}")
+        for callback in self._sigs[sig]["callbacks"]:
+            if isinstance(callback, str):
+                self._emit(callback)
+            else:
+                try:
+                    # running callbacks should not break the interface
+                    ret = callback(value)
+                    if ret is False:
+                        break
+                except Exception as e:
+                    logger.exception(
+                        "Exception (%s) while executing callback for signal: %s",
+                        e,
+                        sig,
+                    )
+
+    def show(self, threads=False):
+        """Open a new browser tab and display this instance's interface"""
+        self.panel.show(threads=threads, verbose=False)
+        return self
+
+
+class SingleSelect(SigSlot):
+    """A multiselect which only allows you to select one item for an event"""
+
+    signals = ["_selected", "selected"]  # the first is internal
+    slots = ["set_options", "set_selection", "add", "clear", "select"]
+
+    def __init__(self, **kwargs):
+        self.kwargs = kwargs
+        super().__init__()
+
+    def _setup(self):
+        self.panel = pn.widgets.MultiSelect(**self.kwargs)
+        self._register(self.panel, "_selected", "value")
+        self._register(None, "selected")
+        self.connect("_selected", self.select_one)
+
+    def _signal(self, *args, **kwargs):
+        super()._signal(*args, **kwargs)
+
+    def select_one(self, *_):
+        with self.ignore_events():
+            val = [self.panel.value[-1]] if self.panel.value else []
+            self.panel.value = val
+        self._emit("selected", self.panel.value)
+
+    def set_options(self, options):
+        self.panel.options = options
+
+    def clear(self):
+        self.panel.options = []
+
+    @property
+    def value(self):
+        return self.panel.value
+
+    def set_selection(self, selection):
+        self.panel.value = [selection]
+
+
+class FileSelector(SigSlot):
+    """Panel-based graphical file selector widget
+
+    Instances of this widget are interactive and can be displayed in jupyter by having
+    them as the output of a cell,  or in a separate browser tab using ``.show()``.
+    """
+
+    signals = [
+        "protocol_changed",
+        "selection_changed",
+        "directory_entered",
+        "home_clicked",
+        "up_clicked",
+        "go_clicked",
+        "filters_changed",
+    ]
+    slots = ["set_filters", "go_home"]
+
+    def __init__(self, url=None, filters=None, ignore=None, kwargs=None):
+        """
+
+        Parameters
+        ----------
+        url : str (optional)
+            Initial value of the URL to populate the dialog; should include protocol
+        filters : list(str) (optional)
+            File endings to include in the listings. If not included, all files are
+            allowed. Does not affect directories.
+            If given, the endings will appear as checkboxes in the interface
+        ignore : list(str) (optional)
+            Regex(s) of file basename patterns to ignore, e.g., "\\." for typical
+            hidden files on posix
+        kwargs : dict (optional)
+            To pass to file system instance
+        """
+        if url:
+            self.init_protocol, url = split_protocol(url)
+        else:
+            self.init_protocol, url = "file", os.getcwd()
+        self.init_url = url
+        self.init_kwargs = (kwargs if isinstance(kwargs, str) else str(kwargs)) or "{}"
+        self.filters = filters
+        self.ignore = [re.compile(i) for i in ignore or []]
+        self._fs = None
+        super().__init__()
+
+    def _setup(self):
+        self.url = pn.widgets.TextInput(
+            name="url",
+            value=self.init_url,
+            align="end",
+            sizing_mode="stretch_width",
+            width_policy="max",
+        )
+        self.protocol = pn.widgets.Select(
+            options=sorted(known_implementations),
+            value=self.init_protocol,
+            name="protocol",
+            align="center",
+        )
+        self.kwargs = pn.widgets.TextInput(
+            name="kwargs", value=self.init_kwargs, align="center"
+        )
+        self.go = pn.widgets.Button(name="⇨", align="end", width=45)
+        self.main = SingleSelect(size=10)
+        self.home = pn.widgets.Button(name="🏠", width=40, height=30, align="end")
+        self.up = pn.widgets.Button(name="‹", width=30, height=30, align="end")
+
+        self._register(self.protocol, "protocol_changed", auto=True)
+        self._register(self.go, "go_clicked", "clicks", auto=True)
+        self._register(self.up, "up_clicked", "clicks", auto=True)
+        self._register(self.home, "home_clicked", "clicks", auto=True)
+        self._register(None, "selection_changed")
+        self.main.connect("selected", self.selection_changed)
+        self._register(None, "directory_entered")
+        self.prev_protocol = self.protocol.value
+        self.prev_kwargs = self.storage_options
+
+        self.filter_sel = pn.widgets.CheckBoxGroup(
+            value=[], options=[], inline=False, align="end", width_policy="min"
+        )
+        self._register(self.filter_sel, "filters_changed", auto=True)
+
+        self.panel = pn.Column(
+            pn.Row(self.protocol, self.kwargs),
+            pn.Row(self.home, self.up, self.url, self.go, self.filter_sel),
+            self.main.panel,
+        )
+        self.set_filters(self.filters)
+        self.go_clicked()
+
+    def set_filters(self, filters=None):
+        self.filters = filters
+        if filters:
+            self.filter_sel.options = filters
+            self.filter_sel.value = filters
+        else:
+            self.filter_sel.options = []
+            self.filter_sel.value = []
+
+    @property
+    def storage_options(self):
+        """Value of the kwargs box as a dictionary"""
+        return ast.literal_eval(self.kwargs.value) or {}
+
+    @property
+    def fs(self):
+        """Current filesystem instance"""
+        if self._fs is None:
+            cls = get_filesystem_class(self.protocol.value)
+            self._fs = cls(**self.storage_options)
+        return self._fs
+
+    @property
+    def urlpath(self):
+        """URL of currently selected item"""
+        return (
+            (f"{self.protocol.value}://{self.main.value[0]}")
+            if self.main.value
+            else None
+        )
+
+    def open_file(self, mode="rb", compression=None, encoding=None):
+        """Create OpenFile instance for the currently selected item
+
+        For example, in a notebook you might do something like
+
+        .. code-block::
+
+            [ ]: sel = FileSelector(); sel
+
+            # user selects their file
+
+            [ ]: with sel.open_file('rb') as f:
+            ...      out = f.read()
+
+        Parameters
+        ----------
+        mode: str (optional)
+            Open mode for the file.
+        compression: str (optional)
+            The interact with the file as compressed. Set to 'infer' to guess
+            compression from the file ending
+        encoding: str (optional)
+            If using text mode, use this encoding; defaults to UTF8.
+        """
+        if self.urlpath is None:
+            raise ValueError("No file selected")
+        return OpenFile(self.fs, self.urlpath, mode, compression, encoding)
+
+    def filters_changed(self, values):
+        self.filters = values
+        self.go_clicked()
+
+    def selection_changed(self, *_):
+        if self.urlpath is None:
+            return
+        if self.fs.isdir(self.urlpath):
+            self.url.value = self.fs._strip_protocol(self.urlpath)
+        self.go_clicked()
+
+    def go_clicked(self, *_):
+        if (
+            self.prev_protocol != self.protocol.value
+            or self.prev_kwargs != self.storage_options
+        ):
+            self._fs = None  # causes fs to be recreated
+            self.prev_protocol = self.protocol.value
+            self.prev_kwargs = self.storage_options
+        listing = sorted(
+            self.fs.ls(self.url.value, detail=True), key=lambda x: x["name"]
+        )
+        listing = [
+            l
+            for l in listing
+            if not any(i.match(l["name"].rsplit("/", 1)[-1]) for i in self.ignore)
+        ]
+        folders = {
+            "📁 " + o["name"].rsplit("/", 1)[-1]: o["name"]
+            for o in listing
+            if o["type"] == "directory"
+        }
+        files = {
+            "📄 " + o["name"].rsplit("/", 1)[-1]: o["name"]
+            for o in listing
+            if o["type"] == "file"
+        }
+        if self.filters:
+            files = {
+                k: v
+                for k, v in files.items()
+                if any(v.endswith(ext) for ext in self.filters)
+            }
+        self.main.set_options(dict(**folders, **files))
+
+    def protocol_changed(self, *_):
+        self._fs = None
+        self.main.options = []
+        self.url.value = ""
+
+    def home_clicked(self, *_):
+        self.protocol.value = self.init_protocol
+        self.kwargs.value = self.init_kwargs
+        self.url.value = self.init_url
+        self.go_clicked()
+
+    def up_clicked(self, *_):
+        self.url.value = self.fs._parent(self.url.value)
+        self.go_clicked()
diff --git a/llm/Lib/site-packages/fsspec/implementations/__init__.py b/llm/Lib/site-packages/fsspec/implementations/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e33bad13e319e4e1863bf3150e125d2a0521b1c
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/arrow.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/arrow.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..88d19086af108d1871b9dcd828d736b43dcffc4c
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/arrow.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/cache_mapper.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/cache_mapper.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..12dc69fa8f47632f60b6816a61fb09626a8f9546
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/cache_mapper.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/cache_metadata.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/cache_metadata.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e92dfa7622049c04f7e6342a71191ca8fff5edc9
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/cache_metadata.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/cached.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/cached.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..194d564fcae5f7d97d6eb9dd2057a7d5b209a4c9
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/cached.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/dask.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/dask.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..27bb120672a33698d21784996075921c3c3580a3
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/dask.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/data.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/data.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3ef70d6bfbca59ba4545f093190026418e16a340
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/data.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/dbfs.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/dbfs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fd769f6145a49a7af3fe19118cd6357538fd9aaa
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/dbfs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/dirfs.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/dirfs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ffde397822ccade7f5bfbda25c3f49ce05efb71d
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/dirfs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/ftp.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/ftp.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9ff967e007e9d40bff6ecce26423da73a1041bf5
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/ftp.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/git.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/git.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a59d0692ce712d16aea5ccac5fd074e5320cb141
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/git.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/github.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/github.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..34aff834e2604e9768694817a874a0be4e5df572
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/github.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/http.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/http.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eafa5af5c6451b6b8a5255b4321f375ab93093bb
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/http.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/jupyter.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/jupyter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2730e529067817919421962c6a5dd9d789295de7
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/jupyter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/libarchive.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/libarchive.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f2bf2c1628c41caaa342c5e29938940d9d0ea4db
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/libarchive.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/local.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/local.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e081d156ec222e7df78048f6aef70c4acf488804
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/local.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/memory.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..94beddbd328db7c522714a5ae785a1df830f86c6
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/reference.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/reference.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..93d44daa9090da288b2345f0e18d77d2a821f017
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/reference.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/sftp.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/sftp.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dd983084c4a4a97ac4f77975cdb54a57d40156d8
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/sftp.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/smb.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/smb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9474e0fe942623d73844032152b154a987afcc3a
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/smb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/tar.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/tar.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6d33a91990e3883c9b8550a4ac9b88c0f5a3ffe7
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/tar.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/webhdfs.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/webhdfs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e5e054f5078ae805b8bcae1123e5055f2e44ee88
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/webhdfs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/__pycache__/zip.cpython-311.pyc b/llm/Lib/site-packages/fsspec/implementations/__pycache__/zip.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c1c9f8452958e2dadfb93fb3ea7d4e867b002244
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/implementations/__pycache__/zip.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/implementations/arrow.py b/llm/Lib/site-packages/fsspec/implementations/arrow.py
new file mode 100644
index 0000000000000000000000000000000000000000..e3dd17f8526c378177681a2fd96cf9a4cee014b3
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/arrow.py
@@ -0,0 +1,306 @@
+import errno
+import io
+import os
+import secrets
+import shutil
+from contextlib import suppress
+from functools import cached_property, wraps
+from urllib.parse import parse_qs
+
+from fsspec.spec import AbstractFileSystem
+from fsspec.utils import (
+    get_package_version_without_import,
+    infer_storage_options,
+    mirror_from,
+    tokenize,
+)
+
+
+def wrap_exceptions(func):
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        try:
+            return func(*args, **kwargs)
+        except OSError as exception:
+            if not exception.args:
+                raise
+
+            message, *args = exception.args
+            if isinstance(message, str) and "does not exist" in message:
+                raise FileNotFoundError(errno.ENOENT, message) from exception
+            else:
+                raise
+
+    return wrapper
+
+
+PYARROW_VERSION = None
+
+
+class ArrowFSWrapper(AbstractFileSystem):
+    """FSSpec-compatible wrapper of pyarrow.fs.FileSystem.
+
+    Parameters
+    ----------
+    fs : pyarrow.fs.FileSystem
+
+    """
+
+    root_marker = "/"
+
+    def __init__(self, fs, **kwargs):
+        global PYARROW_VERSION
+        PYARROW_VERSION = get_package_version_without_import("pyarrow")
+        self.fs = fs
+        super().__init__(**kwargs)
+
+    @property
+    def protocol(self):
+        return self.fs.type_name
+
+    @cached_property
+    def fsid(self):
+        return "hdfs_" + tokenize(self.fs.host, self.fs.port)
+
+    @classmethod
+    def _strip_protocol(cls, path):
+        ops = infer_storage_options(path)
+        path = ops["path"]
+        if path.startswith("//"):
+            # special case for "hdfs://path" (without the triple slash)
+            path = path[1:]
+        return path
+
+    def ls(self, path, detail=False, **kwargs):
+        path = self._strip_protocol(path)
+        from pyarrow.fs import FileSelector
+
+        entries = [
+            self._make_entry(entry)
+            for entry in self.fs.get_file_info(FileSelector(path))
+        ]
+        if detail:
+            return entries
+        else:
+            return [entry["name"] for entry in entries]
+
+    def info(self, path, **kwargs):
+        path = self._strip_protocol(path)
+        [info] = self.fs.get_file_info([path])
+        return self._make_entry(info)
+
+    def exists(self, path):
+        path = self._strip_protocol(path)
+        try:
+            self.info(path)
+        except FileNotFoundError:
+            return False
+        else:
+            return True
+
+    def _make_entry(self, info):
+        from pyarrow.fs import FileType
+
+        if info.type is FileType.Directory:
+            kind = "directory"
+        elif info.type is FileType.File:
+            kind = "file"
+        elif info.type is FileType.NotFound:
+            raise FileNotFoundError(errno.ENOENT, os.strerror(errno.ENOENT), info.path)
+        else:
+            kind = "other"
+
+        return {
+            "name": info.path,
+            "size": info.size,
+            "type": kind,
+            "mtime": info.mtime,
+        }
+
+    @wrap_exceptions
+    def cp_file(self, path1, path2, **kwargs):
+        path1 = self._strip_protocol(path1).rstrip("/")
+        path2 = self._strip_protocol(path2).rstrip("/")
+
+        with self._open(path1, "rb") as lstream:
+            tmp_fname = f"{path2}.tmp.{secrets.token_hex(6)}"
+            try:
+                with self.open(tmp_fname, "wb") as rstream:
+                    shutil.copyfileobj(lstream, rstream)
+                self.fs.move(tmp_fname, path2)
+            except BaseException:  # noqa
+                with suppress(FileNotFoundError):
+                    self.fs.delete_file(tmp_fname)
+                raise
+
+    @wrap_exceptions
+    def mv(self, path1, path2, **kwargs):
+        path1 = self._strip_protocol(path1).rstrip("/")
+        path2 = self._strip_protocol(path2).rstrip("/")
+        self.fs.move(path1, path2)
+
+    mv_file = mv
+
+    @wrap_exceptions
+    def rm_file(self, path):
+        path = self._strip_protocol(path)
+        self.fs.delete_file(path)
+
+    @wrap_exceptions
+    def rm(self, path, recursive=False, maxdepth=None):
+        path = self._strip_protocol(path).rstrip("/")
+        if self.isdir(path):
+            if recursive:
+                self.fs.delete_dir(path)
+            else:
+                raise ValueError("Can't delete directories without recursive=False")
+        else:
+            self.fs.delete_file(path)
+
+    @wrap_exceptions
+    def _open(self, path, mode="rb", block_size=None, seekable=True, **kwargs):
+        if mode == "rb":
+            if seekable:
+                method = self.fs.open_input_file
+            else:
+                method = self.fs.open_input_stream
+        elif mode == "wb":
+            method = self.fs.open_output_stream
+        elif mode == "ab":
+            method = self.fs.open_append_stream
+        else:
+            raise ValueError(f"unsupported mode for Arrow filesystem: {mode!r}")
+
+        _kwargs = {}
+        if mode != "rb" or not seekable:
+            if int(PYARROW_VERSION.split(".")[0]) >= 4:
+                # disable compression auto-detection
+                _kwargs["compression"] = None
+        stream = method(path, **_kwargs)
+
+        return ArrowFile(self, stream, path, mode, block_size, **kwargs)
+
+    @wrap_exceptions
+    def mkdir(self, path, create_parents=True, **kwargs):
+        path = self._strip_protocol(path)
+        if create_parents:
+            self.makedirs(path, exist_ok=True)
+        else:
+            self.fs.create_dir(path, recursive=False)
+
+    @wrap_exceptions
+    def makedirs(self, path, exist_ok=False):
+        path = self._strip_protocol(path)
+        self.fs.create_dir(path, recursive=True)
+
+    @wrap_exceptions
+    def rmdir(self, path):
+        path = self._strip_protocol(path)
+        self.fs.delete_dir(path)
+
+    @wrap_exceptions
+    def modified(self, path):
+        path = self._strip_protocol(path)
+        return self.fs.get_file_info(path).mtime
+
+    def cat_file(self, path, start=None, end=None, **kwargs):
+        kwargs["seekable"] = start not in [None, 0]
+        return super().cat_file(path, start=None, end=None, **kwargs)
+
+    def get_file(self, rpath, lpath, **kwargs):
+        kwargs["seekable"] = False
+        super().get_file(rpath, lpath, **kwargs)
+
+
+@mirror_from(
+    "stream",
+    [
+        "read",
+        "seek",
+        "tell",
+        "write",
+        "readable",
+        "writable",
+        "close",
+        "size",
+        "seekable",
+    ],
+)
+class ArrowFile(io.IOBase):
+    def __init__(self, fs, stream, path, mode, block_size=None, **kwargs):
+        self.path = path
+        self.mode = mode
+
+        self.fs = fs
+        self.stream = stream
+
+        self.blocksize = self.block_size = block_size
+        self.kwargs = kwargs
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        return self.close()
+
+
+class HadoopFileSystem(ArrowFSWrapper):
+    """A wrapper on top of the pyarrow.fs.HadoopFileSystem
+    to connect it's interface with fsspec"""
+
+    protocol = "hdfs"
+
+    def __init__(
+        self,
+        host="default",
+        port=0,
+        user=None,
+        kerb_ticket=None,
+        replication=3,
+        extra_conf=None,
+        **kwargs,
+    ):
+        """
+
+        Parameters
+        ----------
+        host: str
+            Hostname, IP or "default" to try to read from Hadoop config
+        port: int
+            Port to connect on, or default from Hadoop config if 0
+        user: str or None
+            If given, connect as this username
+        kerb_ticket: str or None
+            If given, use this ticket for authentication
+        replication: int
+            set replication factor of file for write operations. default value is 3.
+        extra_conf: None or dict
+            Passed on to HadoopFileSystem
+        """
+        from pyarrow.fs import HadoopFileSystem
+
+        fs = HadoopFileSystem(
+            host=host,
+            port=port,
+            user=user,
+            kerb_ticket=kerb_ticket,
+            replication=replication,
+            extra_conf=extra_conf,
+        )
+        super().__init__(fs=fs, **kwargs)
+
+    @staticmethod
+    def _get_kwargs_from_urls(path):
+        ops = infer_storage_options(path)
+        out = {}
+        if ops.get("host", None):
+            out["host"] = ops["host"]
+        if ops.get("username", None):
+            out["user"] = ops["username"]
+        if ops.get("port", None):
+            out["port"] = ops["port"]
+        if ops.get("url_query", None):
+            queries = parse_qs(ops["url_query"])
+            if queries.get("replication", None):
+                out["replication"] = int(queries["replication"][0])
+        return out
diff --git a/llm/Lib/site-packages/fsspec/implementations/cache_mapper.py b/llm/Lib/site-packages/fsspec/implementations/cache_mapper.py
new file mode 100644
index 0000000000000000000000000000000000000000..64cc908801d057c75e5eded5bb9ca592180f5e1b
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/cache_mapper.py
@@ -0,0 +1,76 @@
+from __future__ import annotations
+
+import abc
+import hashlib
+
+from fsspec.implementations.local import make_path_posix
+
+
+class AbstractCacheMapper(abc.ABC):
+    """Abstract super-class for mappers from remote URLs to local cached
+    basenames.
+    """
+
+    @abc.abstractmethod
+    def __call__(self, path: str) -> str:
+        ...
+
+    def __eq__(self, other: object) -> bool:
+        # Identity only depends on class. When derived classes have attributes
+        # they will need to be included.
+        return isinstance(other, type(self))
+
+    def __hash__(self) -> int:
+        # Identity only depends on class. When derived classes have attributes
+        # they will need to be included.
+        return hash(type(self))
+
+
+class BasenameCacheMapper(AbstractCacheMapper):
+    """Cache mapper that uses the basename of the remote URL and a fixed number
+    of directory levels above this.
+
+    The default is zero directory levels, meaning different paths with the same
+    basename will have the same cached basename.
+    """
+
+    def __init__(self, directory_levels: int = 0):
+        if directory_levels < 0:
+            raise ValueError(
+                "BasenameCacheMapper requires zero or positive directory_levels"
+            )
+        self.directory_levels = directory_levels
+
+        # Separator for directories when encoded as strings.
+        self._separator = "_@_"
+
+    def __call__(self, path: str) -> str:
+        path = make_path_posix(path)
+        prefix, *bits = path.rsplit("/", self.directory_levels + 1)
+        if bits:
+            return self._separator.join(bits)
+        else:
+            return prefix  # No separator found, simple filename
+
+    def __eq__(self, other: object) -> bool:
+        return super().__eq__(other) and self.directory_levels == other.directory_levels
+
+    def __hash__(self) -> int:
+        return super().__hash__() ^ hash(self.directory_levels)
+
+
+class HashCacheMapper(AbstractCacheMapper):
+    """Cache mapper that uses a hash of the remote URL."""
+
+    def __call__(self, path: str) -> str:
+        return hashlib.sha256(path.encode()).hexdigest()
+
+
+def create_cache_mapper(same_names: bool) -> AbstractCacheMapper:
+    """Factory method to create cache mapper for backward compatibility with
+    ``CachingFileSystem`` constructor using ``same_names`` kwarg.
+    """
+    if same_names:
+        return BasenameCacheMapper()
+    else:
+        return HashCacheMapper()
diff --git a/llm/Lib/site-packages/fsspec/implementations/cache_metadata.py b/llm/Lib/site-packages/fsspec/implementations/cache_metadata.py
new file mode 100644
index 0000000000000000000000000000000000000000..16964c2a7153d40b480dd47513d1129ed27e307b
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/cache_metadata.py
@@ -0,0 +1,232 @@
+from __future__ import annotations
+
+import os
+import pickle
+import time
+from typing import TYPE_CHECKING
+
+from fsspec.utils import atomic_write
+
+try:
+    import ujson as json
+except ImportError:
+    if not TYPE_CHECKING:
+        import json
+
+if TYPE_CHECKING:
+    from typing import Any, Dict, Iterator, Literal
+
+    from typing_extensions import TypeAlias
+
+    from .cached import CachingFileSystem
+
+    Detail: TypeAlias = Dict[str, Any]
+
+
+class CacheMetadata:
+    """Cache metadata.
+
+    All reading and writing of cache metadata is performed by this class,
+    accessing the cached files and blocks is not.
+
+    Metadata is stored in a single file per storage directory in JSON format.
+    For backward compatibility, also reads metadata stored in pickle format
+    which is converted to JSON when next saved.
+    """
+
+    def __init__(self, storage: list[str]):
+        """
+
+        Parameters
+        ----------
+        storage: list[str]
+            Directories containing cached files, must be at least one. Metadata
+            is stored in the last of these directories by convention.
+        """
+        if not storage:
+            raise ValueError("CacheMetadata expects at least one storage location")
+
+        self._storage = storage
+        self.cached_files: list[Detail] = [{}]
+
+        # Private attribute to force saving of metadata in pickle format rather than
+        # JSON for use in tests to confirm can read both pickle and JSON formats.
+        self._force_save_pickle = False
+
+    def _load(self, fn: str) -> Detail:
+        """Low-level function to load metadata from specific file"""
+        try:
+            with open(fn, "r") as f:
+                return json.load(f)
+        except ValueError:
+            with open(fn, "rb") as f:
+                return pickle.load(f)
+
+    def _save(self, metadata_to_save: Detail, fn: str) -> None:
+        """Low-level function to save metadata to specific file"""
+        if self._force_save_pickle:
+            with atomic_write(fn) as f:
+                pickle.dump(metadata_to_save, f)
+        else:
+            with atomic_write(fn, mode="w") as f:
+                json.dump(metadata_to_save, f)
+
+    def _scan_locations(
+        self, writable_only: bool = False
+    ) -> Iterator[tuple[str, str, bool]]:
+        """Yield locations (filenames) where metadata is stored, and whether
+        writable or not.
+
+        Parameters
+        ----------
+        writable: bool
+            Set to True to only yield writable locations.
+
+        Returns
+        -------
+        Yields (str, str, bool)
+        """
+        n = len(self._storage)
+        for i, storage in enumerate(self._storage):
+            writable = i == n - 1
+            if writable_only and not writable:
+                continue
+            yield os.path.join(storage, "cache"), storage, writable
+
+    def check_file(
+        self, path: str, cfs: CachingFileSystem | None
+    ) -> Literal[False] | tuple[Detail, str]:
+        """If path is in cache return its details, otherwise return ``False``.
+
+        If the optional CachingFileSystem is specified then it is used to
+        perform extra checks to reject possible matches, such as if they are
+        too old.
+        """
+        for (fn, base, _), cache in zip(self._scan_locations(), self.cached_files):
+            if path not in cache:
+                continue
+            detail = cache[path].copy()
+
+            if cfs is not None:
+                if cfs.check_files and detail["uid"] != cfs.fs.ukey(path):
+                    # Wrong file as determined by hash of file properties
+                    continue
+                if cfs.expiry and time.time() - detail["time"] > cfs.expiry:
+                    # Cached file has expired
+                    continue
+
+            fn = os.path.join(base, detail["fn"])
+            if os.path.exists(fn):
+                return detail, fn
+        return False
+
+    def clear_expired(self, expiry_time: int) -> tuple[list[str], bool]:
+        """Remove expired metadata from the cache.
+
+        Returns names of files corresponding to expired metadata and a boolean
+        flag indicating whether the writable cache is empty. Caller is
+        responsible for deleting the expired files.
+        """
+        expired_files = []
+        for path, detail in self.cached_files[-1].copy().items():
+            if time.time() - detail["time"] > expiry_time:
+                fn = detail.get("fn", "")
+                if not fn:
+                    raise RuntimeError(
+                        f"Cache metadata does not contain 'fn' for {path}"
+                    )
+                fn = os.path.join(self._storage[-1], fn)
+                expired_files.append(fn)
+                self.cached_files[-1].pop(path)
+
+        if self.cached_files[-1]:
+            cache_path = os.path.join(self._storage[-1], "cache")
+            self._save(self.cached_files[-1], cache_path)
+
+        writable_cache_empty = not self.cached_files[-1]
+        return expired_files, writable_cache_empty
+
+    def load(self) -> None:
+        """Load all metadata from disk and store in ``self.cached_files``"""
+        cached_files = []
+        for fn, _, _ in self._scan_locations():
+            if os.path.exists(fn):
+                # TODO: consolidate blocks here
+                loaded_cached_files = self._load(fn)
+                for c in loaded_cached_files.values():
+                    if isinstance(c["blocks"], list):
+                        c["blocks"] = set(c["blocks"])
+                cached_files.append(loaded_cached_files)
+            else:
+                cached_files.append({})
+        self.cached_files = cached_files or [{}]
+
+    def on_close_cached_file(self, f: Any, path: str) -> None:
+        """Perform side-effect actions on closing a cached file.
+
+        The actual closing of the file is the responsibility of the caller.
+        """
+        # File must be writeble, so in self.cached_files[-1]
+        c = self.cached_files[-1][path]
+        if c["blocks"] is not True and len(c["blocks"]) * f.blocksize >= f.size:
+            c["blocks"] = True
+
+    def pop_file(self, path: str) -> str | None:
+        """Remove metadata of cached file.
+
+        If path is in the cache, return the filename of the cached file,
+        otherwise return ``None``.  Caller is responsible for deleting the
+        cached file.
+        """
+        details = self.check_file(path, None)
+        if not details:
+            return None
+        _, fn = details
+        if fn.startswith(self._storage[-1]):
+            self.cached_files[-1].pop(path)
+            self.save()
+        else:
+            raise PermissionError(
+                "Can only delete cached file in last, writable cache location"
+            )
+        return fn
+
+    def save(self) -> None:
+        """Save metadata to disk"""
+        for (fn, _, writable), cache in zip(self._scan_locations(), self.cached_files):
+            if not writable:
+                continue
+
+            if os.path.exists(fn):
+                cached_files = self._load(fn)
+                for k, c in cached_files.items():
+                    if k in cache:
+                        if c["blocks"] is True or cache[k]["blocks"] is True:
+                            c["blocks"] = True
+                        else:
+                            # self.cached_files[*][*]["blocks"] must continue to
+                            # point to the same set object so that updates
+                            # performed by MMapCache are propagated back to
+                            # self.cached_files.
+                            blocks = cache[k]["blocks"]
+                            blocks.update(c["blocks"])
+                            c["blocks"] = blocks
+                        c["time"] = max(c["time"], cache[k]["time"])
+                        c["uid"] = cache[k]["uid"]
+
+                # Files can be added to cache after it was written once
+                for k, c in cache.items():
+                    if k not in cached_files:
+                        cached_files[k] = c
+            else:
+                cached_files = cache
+            cache = {k: v.copy() for k, v in cached_files.items()}
+            for c in cache.values():
+                if isinstance(c["blocks"], set):
+                    c["blocks"] = list(c["blocks"])
+            self._save(cache, fn)
+            self.cached_files[-1] = cached_files
+
+    def update_file(self, path: str, detail: Detail) -> None:
+        """Update metadata for specific file in memory, do not save"""
+        self.cached_files[-1][path] = detail
diff --git a/llm/Lib/site-packages/fsspec/implementations/cached.py b/llm/Lib/site-packages/fsspec/implementations/cached.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2ee17214a23e7d74ecf935449cf8923ad903ce1
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/cached.py
@@ -0,0 +1,939 @@
+from __future__ import annotations
+
+import inspect
+import logging
+import os
+import tempfile
+import time
+import weakref
+from shutil import rmtree
+from typing import TYPE_CHECKING, Any, Callable, ClassVar
+
+from fsspec import AbstractFileSystem, filesystem
+from fsspec.callbacks import DEFAULT_CALLBACK
+from fsspec.compression import compr
+from fsspec.core import BaseCache, MMapCache
+from fsspec.exceptions import BlocksizeMismatchError
+from fsspec.implementations.cache_mapper import create_cache_mapper
+from fsspec.implementations.cache_metadata import CacheMetadata
+from fsspec.spec import AbstractBufferedFile
+from fsspec.transaction import Transaction
+from fsspec.utils import infer_compression
+
+if TYPE_CHECKING:
+    from fsspec.implementations.cache_mapper import AbstractCacheMapper
+
+logger = logging.getLogger("fsspec.cached")
+
+
+class WriteCachedTransaction(Transaction):
+    def complete(self, commit=True):
+        rpaths = [f.path for f in self.files]
+        lpaths = [f.fn for f in self.files]
+        if commit:
+            self.fs.put(lpaths, rpaths)
+        self.files.clear()
+        self.fs._intrans = False
+        self.fs._transaction = None
+        self.fs = None  # break cycle
+
+
+class CachingFileSystem(AbstractFileSystem):
+    """Locally caching filesystem, layer over any other FS
+
+    This class implements chunk-wise local storage of remote files, for quick
+    access after the initial download. The files are stored in a given
+    directory with hashes of URLs for the filenames. If no directory is given,
+    a temporary one is used, which should be cleaned up by the OS after the
+    process ends. The files themselves are sparse (as implemented in
+    :class:`~fsspec.caching.MMapCache`), so only the data which is accessed
+    takes up space.
+
+    Restrictions:
+
+    - the block-size must be the same for each access of a given file, unless
+      all blocks of the file have already been read
+    - caching can only be applied to file-systems which produce files
+      derived from fsspec.spec.AbstractBufferedFile ; LocalFileSystem is also
+      allowed, for testing
+    """
+
+    protocol: ClassVar[str | tuple[str, ...]] = ("blockcache", "cached")
+
+    def __init__(
+        self,
+        target_protocol=None,
+        cache_storage="TMP",
+        cache_check=10,
+        check_files=False,
+        expiry_time=604800,
+        target_options=None,
+        fs=None,
+        same_names: bool | None = None,
+        compression=None,
+        cache_mapper: AbstractCacheMapper | None = None,
+        **kwargs,
+    ):
+        """
+
+        Parameters
+        ----------
+        target_protocol: str (optional)
+            Target filesystem protocol. Provide either this or ``fs``.
+        cache_storage: str or list(str)
+            Location to store files. If "TMP", this is a temporary directory,
+            and will be cleaned up by the OS when this process ends (or later).
+            If a list, each location will be tried in the order given, but
+            only the last will be considered writable.
+        cache_check: int
+            Number of seconds between reload of cache metadata
+        check_files: bool
+            Whether to explicitly see if the UID of the remote file matches
+            the stored one before using. Warning: some file systems such as
+            HTTP cannot reliably give a unique hash of the contents of some
+            path, so be sure to set this option to False.
+        expiry_time: int
+            The time in seconds after which a local copy is considered useless.
+            Set to falsy to prevent expiry. The default is equivalent to one
+            week.
+        target_options: dict or None
+            Passed to the instantiation of the FS, if fs is None.
+        fs: filesystem instance
+            The target filesystem to run against. Provide this or ``protocol``.
+        same_names: bool (optional)
+            By default, target URLs are hashed using a ``HashCacheMapper`` so
+            that files from different backends with the same basename do not
+            conflict. If this argument is ``true``, a ``BasenameCacheMapper``
+            is used instead. Other cache mapper options are available by using
+            the ``cache_mapper`` keyword argument. Only one of this and
+            ``cache_mapper`` should be specified.
+        compression: str (optional)
+            To decompress on download. Can be 'infer' (guess from the URL name),
+            one of the entries in ``fsspec.compression.compr``, or None for no
+            decompression.
+        cache_mapper: AbstractCacheMapper (optional)
+            The object use to map from original filenames to cached filenames.
+            Only one of this and ``same_names`` should be specified.
+        """
+        super().__init__(**kwargs)
+        if fs is None and target_protocol is None:
+            raise ValueError(
+                "Please provide filesystem instance(fs) or target_protocol"
+            )
+        if not (fs is None) ^ (target_protocol is None):
+            raise ValueError(
+                "Both filesystems (fs) and target_protocol may not be both given."
+            )
+        if cache_storage == "TMP":
+            tempdir = tempfile.mkdtemp()
+            storage = [tempdir]
+            weakref.finalize(self, self._remove_tempdir, tempdir)
+        else:
+            if isinstance(cache_storage, str):
+                storage = [cache_storage]
+            else:
+                storage = cache_storage
+        os.makedirs(storage[-1], exist_ok=True)
+        self.storage = storage
+        self.kwargs = target_options or {}
+        self.cache_check = cache_check
+        self.check_files = check_files
+        self.expiry = expiry_time
+        self.compression = compression
+
+        # Size of cache in bytes. If None then the size is unknown and will be
+        # recalculated the next time cache_size() is called. On writes to the
+        # cache this is reset to None.
+        self._cache_size = None
+
+        if same_names is not None and cache_mapper is not None:
+            raise ValueError(
+                "Cannot specify both same_names and cache_mapper in "
+                "CachingFileSystem.__init__"
+            )
+        if cache_mapper is not None:
+            self._mapper = cache_mapper
+        else:
+            self._mapper = create_cache_mapper(
+                same_names if same_names is not None else False
+            )
+
+        self.target_protocol = (
+            target_protocol
+            if isinstance(target_protocol, str)
+            else (fs.protocol if isinstance(fs.protocol, str) else fs.protocol[0])
+        )
+        self._metadata = CacheMetadata(self.storage)
+        self.load_cache()
+        self.fs = fs if fs is not None else filesystem(target_protocol, **self.kwargs)
+
+        def _strip_protocol(path):
+            # acts as a method, since each instance has a difference target
+            return self.fs._strip_protocol(type(self)._strip_protocol(path))
+
+        self._strip_protocol: Callable = _strip_protocol
+
+    @staticmethod
+    def _remove_tempdir(tempdir):
+        try:
+            rmtree(tempdir)
+        except Exception:
+            pass
+
+    def _mkcache(self):
+        os.makedirs(self.storage[-1], exist_ok=True)
+
+    def cache_size(self):
+        """Return size of cache in bytes.
+
+        If more than one cache directory is in use, only the size of the last
+        one (the writable cache directory) is returned.
+        """
+        if self._cache_size is None:
+            cache_dir = self.storage[-1]
+            self._cache_size = filesystem("file").du(cache_dir, withdirs=True)
+        return self._cache_size
+
+    def load_cache(self):
+        """Read set of stored blocks from file"""
+        self._metadata.load()
+        self._mkcache()
+        self.last_cache = time.time()
+
+    def save_cache(self):
+        """Save set of stored blocks from file"""
+        self._mkcache()
+        self._metadata.save()
+        self.last_cache = time.time()
+        self._cache_size = None
+
+    def _check_cache(self):
+        """Reload caches if time elapsed or any disappeared"""
+        self._mkcache()
+        if not self.cache_check:
+            # explicitly told not to bother checking
+            return
+        timecond = time.time() - self.last_cache > self.cache_check
+        existcond = all(os.path.exists(storage) for storage in self.storage)
+        if timecond or not existcond:
+            self.load_cache()
+
+    def _check_file(self, path):
+        """Is path in cache and still valid"""
+        path = self._strip_protocol(path)
+        self._check_cache()
+        return self._metadata.check_file(path, self)
+
+    def clear_cache(self):
+        """Remove all files and metadata from the cache
+
+        In the case of multiple cache locations, this clears only the last one,
+        which is assumed to be the read/write one.
+        """
+        rmtree(self.storage[-1])
+        self.load_cache()
+        self._cache_size = None
+
+    def clear_expired_cache(self, expiry_time=None):
+        """Remove all expired files and metadata from the cache
+
+        In the case of multiple cache locations, this clears only the last one,
+        which is assumed to be the read/write one.
+
+        Parameters
+        ----------
+        expiry_time: int
+            The time in seconds after which a local copy is considered useless.
+            If not defined the default is equivalent to the attribute from the
+            file caching instantiation.
+        """
+
+        if not expiry_time:
+            expiry_time = self.expiry
+
+        self._check_cache()
+
+        expired_files, writable_cache_empty = self._metadata.clear_expired(expiry_time)
+        for fn in expired_files:
+            if os.path.exists(fn):
+                os.remove(fn)
+
+        if writable_cache_empty:
+            rmtree(self.storage[-1])
+            self.load_cache()
+
+        self._cache_size = None
+
+    def pop_from_cache(self, path):
+        """Remove cached version of given file
+
+        Deletes local copy of the given (remote) path. If it is found in a cache
+        location which is not the last, it is assumed to be read-only, and
+        raises PermissionError
+        """
+        path = self._strip_protocol(path)
+        fn = self._metadata.pop_file(path)
+        if fn is not None:
+            os.remove(fn)
+        self._cache_size = None
+
+    def _open(
+        self,
+        path,
+        mode="rb",
+        block_size=None,
+        autocommit=True,
+        cache_options=None,
+        **kwargs,
+    ):
+        """Wrap the target _open
+
+        If the whole file exists in the cache, just open it locally and
+        return that.
+
+        Otherwise, open the file on the target FS, and make it have a mmap
+        cache pointing to the location which we determine, in our cache.
+        The ``blocks`` instance is shared, so as the mmap cache instance
+        updates, so does the entry in our ``cached_files`` attribute.
+        We monkey-patch this file, so that when it closes, we call
+        ``close_and_update`` to save the state of the blocks.
+        """
+        path = self._strip_protocol(path)
+
+        path = self.fs._strip_protocol(path)
+        if "r" not in mode:
+            return self.fs._open(
+                path,
+                mode=mode,
+                block_size=block_size,
+                autocommit=autocommit,
+                cache_options=cache_options,
+                **kwargs,
+            )
+        detail = self._check_file(path)
+        if detail:
+            # file is in cache
+            detail, fn = detail
+            hash, blocks = detail["fn"], detail["blocks"]
+            if blocks is True:
+                # stored file is complete
+                logger.debug("Opening local copy of %s", path)
+                return open(fn, mode)
+            # TODO: action where partial file exists in read-only cache
+            logger.debug("Opening partially cached copy of %s", path)
+        else:
+            hash = self._mapper(path)
+            fn = os.path.join(self.storage[-1], hash)
+            blocks = set()
+            detail = {
+                "original": path,
+                "fn": hash,
+                "blocks": blocks,
+                "time": time.time(),
+                "uid": self.fs.ukey(path),
+            }
+            self._metadata.update_file(path, detail)
+            logger.debug("Creating local sparse file for %s", path)
+
+        # call target filesystems open
+        self._mkcache()
+        f = self.fs._open(
+            path,
+            mode=mode,
+            block_size=block_size,
+            autocommit=autocommit,
+            cache_options=cache_options,
+            cache_type="none",
+            **kwargs,
+        )
+        if self.compression:
+            comp = (
+                infer_compression(path)
+                if self.compression == "infer"
+                else self.compression
+            )
+            f = compr[comp](f, mode="rb")
+        if "blocksize" in detail:
+            if detail["blocksize"] != f.blocksize:
+                raise BlocksizeMismatchError(
+                    f"Cached file must be reopened with same block"
+                    f" size as original (old: {detail['blocksize']},"
+                    f" new {f.blocksize})"
+                )
+        else:
+            detail["blocksize"] = f.blocksize
+        f.cache = MMapCache(f.blocksize, f._fetch_range, f.size, fn, blocks)
+        close = f.close
+        f.close = lambda: self.close_and_update(f, close)
+        self.save_cache()
+        return f
+
+    def _parent(self, path):
+        return self.fs._parent(path)
+
+    def hash_name(self, path: str, *args: Any) -> str:
+        # Kept for backward compatibility with downstream libraries.
+        # Ignores extra arguments, previously same_name boolean.
+        return self._mapper(path)
+
+    def close_and_update(self, f, close):
+        """Called when a file is closing, so store the set of blocks"""
+        if f.closed:
+            return
+        path = self._strip_protocol(f.path)
+        self._metadata.on_close_cached_file(f, path)
+        try:
+            logger.debug("going to save")
+            self.save_cache()
+            logger.debug("saved")
+        except OSError:
+            logger.debug("Cache saving failed while closing file")
+        except NameError:
+            logger.debug("Cache save failed due to interpreter shutdown")
+        close()
+        f.closed = True
+
+    def ls(self, path, detail=True):
+        return self.fs.ls(path, detail)
+
+    def __getattribute__(self, item):
+        if item in {
+            "load_cache",
+            "_open",
+            "save_cache",
+            "close_and_update",
+            "__init__",
+            "__getattribute__",
+            "__reduce__",
+            "_make_local_details",
+            "open",
+            "cat",
+            "cat_file",
+            "cat_ranges",
+            "get",
+            "read_block",
+            "tail",
+            "head",
+            "info",
+            "ls",
+            "exists",
+            "isfile",
+            "isdir",
+            "_check_file",
+            "_check_cache",
+            "_mkcache",
+            "clear_cache",
+            "clear_expired_cache",
+            "pop_from_cache",
+            "_mkcache",
+            "local_file",
+            "_paths_from_path",
+            "get_mapper",
+            "open_many",
+            "commit_many",
+            "hash_name",
+            "__hash__",
+            "__eq__",
+            "to_json",
+            "cache_size",
+            "pipe_file",
+            "pipe",
+            "isdir",
+            "isfile",
+            "exists",
+            "start_transaction",
+            "end_transaction",
+        }:
+            # all the methods defined in this class. Note `open` here, since
+            # it calls `_open`, but is actually in superclass
+            return lambda *args, **kw: getattr(type(self), item).__get__(self)(
+                *args, **kw
+            )
+        if item in ["__reduce_ex__"]:
+            raise AttributeError
+        if item in ["transaction"]:
+            # property
+            return type(self).transaction.__get__(self)
+        if item in ["_cache", "transaction_type"]:
+            # class attributes
+            return getattr(type(self), item)
+        if item == "__class__":
+            return type(self)
+        d = object.__getattribute__(self, "__dict__")
+        fs = d.get("fs", None)  # fs is not immediately defined
+        if item in d:
+            return d[item]
+        elif fs is not None:
+            if item in fs.__dict__:
+                # attribute of instance
+                return fs.__dict__[item]
+            # attributed belonging to the target filesystem
+            cls = type(fs)
+            m = getattr(cls, item)
+            if (inspect.isfunction(m) or inspect.isdatadescriptor(m)) and (
+                not hasattr(m, "__self__") or m.__self__ is None
+            ):
+                # instance method
+                return m.__get__(fs, cls)
+            return m  # class method or attribute
+        else:
+            # attributes of the superclass, while target is being set up
+            return super().__getattribute__(item)
+
+    def __eq__(self, other):
+        """Test for equality."""
+        if self is other:
+            return True
+        if not isinstance(other, type(self)):
+            return False
+        return (
+            self.storage == other.storage
+            and self.kwargs == other.kwargs
+            and self.cache_check == other.cache_check
+            and self.check_files == other.check_files
+            and self.expiry == other.expiry
+            and self.compression == other.compression
+            and self._mapper == other._mapper
+            and self.target_protocol == other.target_protocol
+        )
+
+    def __hash__(self):
+        """Calculate hash."""
+        return (
+            hash(tuple(self.storage))
+            ^ hash(str(self.kwargs))
+            ^ hash(self.cache_check)
+            ^ hash(self.check_files)
+            ^ hash(self.expiry)
+            ^ hash(self.compression)
+            ^ hash(self._mapper)
+            ^ hash(self.target_protocol)
+        )
+
+    def to_json(self):
+        """Calculate JSON representation.
+
+        Not implemented yet for CachingFileSystem.
+        """
+        raise NotImplementedError(
+            "CachingFileSystem JSON representation not implemented"
+        )
+
+
+class WholeFileCacheFileSystem(CachingFileSystem):
+    """Caches whole remote files on first access
+
+    This class is intended as a layer over any other file system, and
+    will make a local copy of each file accessed, so that all subsequent
+    reads are local. This is similar to ``CachingFileSystem``, but without
+    the block-wise functionality and so can work even when sparse files
+    are not allowed. See its docstring for definition of the init
+    arguments.
+
+    The class still needs access to the remote store for listing files,
+    and may refresh cached files.
+    """
+
+    protocol = "filecache"
+    local_file = True
+
+    def open_many(self, open_files, **kwargs):
+        paths = [of.path for of in open_files]
+        if "r" in open_files.mode:
+            self._mkcache()
+        else:
+            return [
+                LocalTempFile(
+                    self.fs,
+                    path,
+                    mode=open_files.mode,
+                    fn=os.path.join(self.storage[-1], self._mapper(path)),
+                    **kwargs,
+                )
+                for path in paths
+            ]
+
+        if self.compression:
+            raise NotImplementedError
+        details = [self._check_file(sp) for sp in paths]
+        downpath = [p for p, d in zip(paths, details) if not d]
+        downfn0 = [
+            os.path.join(self.storage[-1], self._mapper(p))
+            for p, d in zip(paths, details)
+        ]  # keep these path names for opening later
+        downfn = [fn for fn, d in zip(downfn0, details) if not d]
+        if downpath:
+            # skip if all files are already cached and up to date
+            self.fs.get(downpath, downfn)
+
+            # update metadata - only happens when downloads are successful
+            newdetail = [
+                {
+                    "original": path,
+                    "fn": self._mapper(path),
+                    "blocks": True,
+                    "time": time.time(),
+                    "uid": self.fs.ukey(path),
+                }
+                for path in downpath
+            ]
+            for path, detail in zip(downpath, newdetail):
+                self._metadata.update_file(path, detail)
+            self.save_cache()
+
+        def firstpart(fn):
+            # helper to adapt both whole-file and simple-cache
+            return fn[1] if isinstance(fn, tuple) else fn
+
+        return [
+            open(firstpart(fn0) if fn0 else fn1, mode=open_files.mode)
+            for fn0, fn1 in zip(details, downfn0)
+        ]
+
+    def commit_many(self, open_files):
+        self.fs.put([f.fn for f in open_files], [f.path for f in open_files])
+        [f.close() for f in open_files]
+        for f in open_files:
+            # in case autocommit is off, and so close did not already delete
+            try:
+                os.remove(f.name)
+            except FileNotFoundError:
+                pass
+        self._cache_size = None
+
+    def _make_local_details(self, path):
+        hash = self._mapper(path)
+        fn = os.path.join(self.storage[-1], hash)
+        detail = {
+            "original": path,
+            "fn": hash,
+            "blocks": True,
+            "time": time.time(),
+            "uid": self.fs.ukey(path),
+        }
+        self._metadata.update_file(path, detail)
+        logger.debug("Copying %s to local cache", path)
+        return fn
+
+    def cat(
+        self,
+        path,
+        recursive=False,
+        on_error="raise",
+        callback=DEFAULT_CALLBACK,
+        **kwargs,
+    ):
+        paths = self.expand_path(
+            path, recursive=recursive, maxdepth=kwargs.get("maxdepth", None)
+        )
+        getpaths = []
+        storepaths = []
+        fns = []
+        out = {}
+        for p in paths.copy():
+            try:
+                detail = self._check_file(p)
+                if not detail:
+                    fn = self._make_local_details(p)
+                    getpaths.append(p)
+                    storepaths.append(fn)
+                else:
+                    detail, fn = detail if isinstance(detail, tuple) else (None, detail)
+                fns.append(fn)
+            except Exception as e:
+                if on_error == "raise":
+                    raise
+                if on_error == "return":
+                    out[p] = e
+                paths.remove(p)
+
+        if getpaths:
+            self.fs.get(getpaths, storepaths)
+            self.save_cache()
+
+        callback.set_size(len(paths))
+        for p, fn in zip(paths, fns):
+            with open(fn, "rb") as f:
+                out[p] = f.read()
+            callback.relative_update(1)
+        if isinstance(path, str) and len(paths) == 1 and recursive is False:
+            out = out[paths[0]]
+        return out
+
+    def _open(self, path, mode="rb", **kwargs):
+        path = self._strip_protocol(path)
+        if "r" not in mode:
+            fn = self._make_local_details(path)
+            user_specified_kwargs = {
+                k: v
+                for k, v in kwargs.items()
+                # those kwargs were added by open(), we don't want them
+                if k not in ["autocommit", "block_size", "cache_options"]
+            }
+            return LocalTempFile(self, path, mode=mode, fn=fn, **user_specified_kwargs)
+        detail = self._check_file(path)
+        if detail:
+            detail, fn = detail
+            _, blocks = detail["fn"], detail["blocks"]
+            if blocks is True:
+                logger.debug("Opening local copy of %s", path)
+
+                # In order to support downstream filesystems to be able to
+                # infer the compression from the original filename, like
+                # the `TarFileSystem`, let's extend the `io.BufferedReader`
+                # fileobject protocol by adding a dedicated attribute
+                # `original`.
+                f = open(fn, mode)
+                f.original = detail.get("original")
+                return f
+            else:
+                raise ValueError(
+                    f"Attempt to open partially cached file {path}"
+                    f" as a wholly cached file"
+                )
+        else:
+            fn = self._make_local_details(path)
+        kwargs["mode"] = mode
+
+        # call target filesystems open
+        self._mkcache()
+        if self.compression:
+            with self.fs._open(path, **kwargs) as f, open(fn, "wb") as f2:
+                if isinstance(f, AbstractBufferedFile):
+                    # want no type of caching if just downloading whole thing
+                    f.cache = BaseCache(0, f.cache.fetcher, f.size)
+                comp = (
+                    infer_compression(path)
+                    if self.compression == "infer"
+                    else self.compression
+                )
+                f = compr[comp](f, mode="rb")
+                data = True
+                while data:
+                    block = getattr(f, "blocksize", 5 * 2**20)
+                    data = f.read(block)
+                    f2.write(data)
+        else:
+            self.fs.get_file(path, fn)
+        self.save_cache()
+        return self._open(path, mode)
+
+
+class SimpleCacheFileSystem(WholeFileCacheFileSystem):
+    """Caches whole remote files on first access
+
+    This class is intended as a layer over any other file system, and
+    will make a local copy of each file accessed, so that all subsequent
+    reads are local. This implementation only copies whole files, and
+    does not keep any metadata about the download time or file details.
+    It is therefore safer to use in multi-threaded/concurrent situations.
+
+    This is the only of the caching filesystems that supports write: you will
+    be given a real local open file, and upon close and commit, it will be
+    uploaded to the target filesystem; the writability or the target URL is
+    not checked until that time.
+
+    """
+
+    protocol = "simplecache"
+    local_file = True
+    transaction_type = WriteCachedTransaction
+
+    def __init__(self, **kwargs):
+        kw = kwargs.copy()
+        for key in ["cache_check", "expiry_time", "check_files"]:
+            kw[key] = False
+        super().__init__(**kw)
+        for storage in self.storage:
+            if not os.path.exists(storage):
+                os.makedirs(storage, exist_ok=True)
+
+    def _check_file(self, path):
+        self._check_cache()
+        sha = self._mapper(path)
+        for storage in self.storage:
+            fn = os.path.join(storage, sha)
+            if os.path.exists(fn):
+                return fn
+
+    def save_cache(self):
+        pass
+
+    def load_cache(self):
+        pass
+
+    def pipe_file(self, path, value=None, **kwargs):
+        if self._intrans:
+            with self.open(path, "wb") as f:
+                f.write(value)
+        else:
+            super().pipe_file(path, value)
+
+    def ls(self, path, detail=True, **kwargs):
+        path = self._strip_protocol(path)
+        details = []
+        try:
+            details = self.fs.ls(
+                path, detail=True, **kwargs
+            ).copy()  # don't edit original!
+        except FileNotFoundError as e:
+            ex = e
+        else:
+            ex = None
+        if self._intrans:
+            path1 = path.rstrip("/") + "/"
+            for f in self.transaction.files:
+                if f.path == path:
+                    details.append(
+                        {"name": path, "size": f.size or f.tell(), "type": "file"}
+                    )
+                elif f.path.startswith(path1):
+                    if f.path.count("/") == path1.count("/"):
+                        details.append(
+                            {"name": f.path, "size": f.size or f.tell(), "type": "file"}
+                        )
+                    else:
+                        dname = "/".join(f.path.split("/")[: path1.count("/") + 1])
+                        details.append({"name": dname, "size": 0, "type": "directory"})
+        if ex is not None and not details:
+            raise ex
+        if detail:
+            return details
+        return sorted(_["name"] for _ in details)
+
+    def info(self, path, **kwargs):
+        path = self._strip_protocol(path)
+        if self._intrans:
+            f = [_ for _ in self.transaction.files if _.path == path]
+            if f:
+                return {"name": path, "size": f[0].size or f[0].tell(), "type": "file"}
+            f = any(_.path.startswith(path + "/") for _ in self.transaction.files)
+            if f:
+                return {"name": path, "size": 0, "type": "directory"}
+        return self.fs.info(path, **kwargs)
+
+    def pipe(self, path, value=None, **kwargs):
+        if isinstance(path, str):
+            self.pipe_file(self._strip_protocol(path), value, **kwargs)
+        elif isinstance(path, dict):
+            for k, v in path.items():
+                self.pipe_file(self._strip_protocol(k), v, **kwargs)
+        else:
+            raise ValueError("path must be str or dict")
+
+    def cat_ranges(
+        self, paths, starts, ends, max_gap=None, on_error="return", **kwargs
+    ):
+        lpaths = [self._check_file(p) for p in paths]
+        rpaths = [p for l, p in zip(lpaths, paths) if l is False]
+        lpaths = [l for l, p in zip(lpaths, paths) if l is False]
+        self.fs.get(rpaths, lpaths)
+        return super().cat_ranges(
+            paths, starts, ends, max_gap=max_gap, on_error=on_error, **kwargs
+        )
+
+    def _open(self, path, mode="rb", **kwargs):
+        path = self._strip_protocol(path)
+        sha = self._mapper(path)
+
+        if "r" not in mode:
+            fn = os.path.join(self.storage[-1], sha)
+            user_specified_kwargs = {
+                k: v
+                for k, v in kwargs.items()
+                if k not in ["autocommit", "block_size", "cache_options"]
+            }  # those were added by open()
+            return LocalTempFile(
+                self,
+                path,
+                mode=mode,
+                autocommit=not self._intrans,
+                fn=fn,
+                **user_specified_kwargs,
+            )
+        fn = self._check_file(path)
+        if fn:
+            return open(fn, mode)
+
+        fn = os.path.join(self.storage[-1], sha)
+        logger.debug("Copying %s to local cache", path)
+        kwargs["mode"] = mode
+
+        self._mkcache()
+        self._cache_size = None
+        if self.compression:
+            with self.fs._open(path, **kwargs) as f, open(fn, "wb") as f2:
+                if isinstance(f, AbstractBufferedFile):
+                    # want no type of caching if just downloading whole thing
+                    f.cache = BaseCache(0, f.cache.fetcher, f.size)
+                comp = (
+                    infer_compression(path)
+                    if self.compression == "infer"
+                    else self.compression
+                )
+                f = compr[comp](f, mode="rb")
+                data = True
+                while data:
+                    block = getattr(f, "blocksize", 5 * 2**20)
+                    data = f.read(block)
+                    f2.write(data)
+        else:
+            self.fs.get_file(path, fn)
+        return self._open(path, mode)
+
+
+class LocalTempFile:
+    """A temporary local file, which will be uploaded on commit"""
+
+    def __init__(self, fs, path, fn, mode="wb", autocommit=True, seek=0, **kwargs):
+        self.fn = fn
+        self.fh = open(fn, mode)
+        self.mode = mode
+        if seek:
+            self.fh.seek(seek)
+        self.path = path
+        self.size = None
+        self.fs = fs
+        self.closed = False
+        self.autocommit = autocommit
+        self.kwargs = kwargs
+
+    def __reduce__(self):
+        # always open in r+b to allow continuing writing at a location
+        return (
+            LocalTempFile,
+            (self.fs, self.path, self.fn, "r+b", self.autocommit, self.tell()),
+        )
+
+    def __enter__(self):
+        return self.fh
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+
+    def close(self):
+        self.size = self.fh.tell()
+        if self.closed:
+            return
+        self.fh.close()
+        self.closed = True
+        if self.autocommit:
+            self.commit()
+
+    def discard(self):
+        self.fh.close()
+        os.remove(self.fn)
+
+    def commit(self):
+        self.fs.put(self.fn, self.path, **self.kwargs)
+        # we do not delete local copy - it's still in the cache
+
+    @property
+    def name(self):
+        return self.fn
+
+    def __repr__(self) -> str:
+        return f"LocalTempFile: {self.path}"
+
+    def __getattr__(self, item):
+        return getattr(self.fh, item)
diff --git a/llm/Lib/site-packages/fsspec/implementations/dask.py b/llm/Lib/site-packages/fsspec/implementations/dask.py
new file mode 100644
index 0000000000000000000000000000000000000000..3e1276463db6866665e6a0fe114efc247971b57e
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/dask.py
@@ -0,0 +1,152 @@
+import dask
+from distributed.client import Client, _get_global_client
+from distributed.worker import Worker
+
+from fsspec import filesystem
+from fsspec.spec import AbstractBufferedFile, AbstractFileSystem
+from fsspec.utils import infer_storage_options
+
+
+def _get_client(client):
+    if client is None:
+        return _get_global_client()
+    elif isinstance(client, Client):
+        return client
+    else:
+        # e.g., connection string
+        return Client(client)
+
+
+def _in_worker():
+    return bool(Worker._instances)
+
+
+class DaskWorkerFileSystem(AbstractFileSystem):
+    """View files accessible to a worker as any other remote file-system
+
+    When instances are run on the worker, uses the real filesystem. When
+    run on the client, they call the worker to provide information or data.
+
+    **Warning** this implementation is experimental, and read-only for now.
+    """
+
+    def __init__(
+        self, target_protocol=None, target_options=None, fs=None, client=None, **kwargs
+    ):
+        super().__init__(**kwargs)
+        if not (fs is None) ^ (target_protocol is None):
+            raise ValueError(
+                "Please provide one of filesystem instance (fs) or"
+                " target_protocol, not both"
+            )
+        self.target_protocol = target_protocol
+        self.target_options = target_options
+        self.worker = None
+        self.client = client
+        self.fs = fs
+        self._determine_worker()
+
+    @staticmethod
+    def _get_kwargs_from_urls(path):
+        so = infer_storage_options(path)
+        if "host" in so and "port" in so:
+            return {"client": f"{so['host']}:{so['port']}"}
+        else:
+            return {}
+
+    def _determine_worker(self):
+        if _in_worker():
+            self.worker = True
+            if self.fs is None:
+                self.fs = filesystem(
+                    self.target_protocol, **(self.target_options or {})
+                )
+        else:
+            self.worker = False
+            self.client = _get_client(self.client)
+            self.rfs = dask.delayed(self)
+
+    def mkdir(self, *args, **kwargs):
+        if self.worker:
+            self.fs.mkdir(*args, **kwargs)
+        else:
+            self.rfs.mkdir(*args, **kwargs).compute()
+
+    def rm(self, *args, **kwargs):
+        if self.worker:
+            self.fs.rm(*args, **kwargs)
+        else:
+            self.rfs.rm(*args, **kwargs).compute()
+
+    def copy(self, *args, **kwargs):
+        if self.worker:
+            self.fs.copy(*args, **kwargs)
+        else:
+            self.rfs.copy(*args, **kwargs).compute()
+
+    def mv(self, *args, **kwargs):
+        if self.worker:
+            self.fs.mv(*args, **kwargs)
+        else:
+            self.rfs.mv(*args, **kwargs).compute()
+
+    def ls(self, *args, **kwargs):
+        if self.worker:
+            return self.fs.ls(*args, **kwargs)
+        else:
+            return self.rfs.ls(*args, **kwargs).compute()
+
+    def _open(
+        self,
+        path,
+        mode="rb",
+        block_size=None,
+        autocommit=True,
+        cache_options=None,
+        **kwargs,
+    ):
+        if self.worker:
+            return self.fs._open(
+                path,
+                mode=mode,
+                block_size=block_size,
+                autocommit=autocommit,
+                cache_options=cache_options,
+                **kwargs,
+            )
+        else:
+            return DaskFile(
+                fs=self,
+                path=path,
+                mode=mode,
+                block_size=block_size,
+                autocommit=autocommit,
+                cache_options=cache_options,
+                **kwargs,
+            )
+
+    def fetch_range(self, path, mode, start, end):
+        if self.worker:
+            with self._open(path, mode) as f:
+                f.seek(start)
+                return f.read(end - start)
+        else:
+            return self.rfs.fetch_range(path, mode, start, end).compute()
+
+
+class DaskFile(AbstractBufferedFile):
+    def __init__(self, mode="rb", **kwargs):
+        if mode != "rb":
+            raise ValueError('Remote dask files can only be opened in "rb" mode')
+        super().__init__(**kwargs)
+
+    def _upload_chunk(self, final=False):
+        pass
+
+    def _initiate_upload(self):
+        """Create remote file/upload"""
+        pass
+
+    def _fetch_range(self, start, end):
+        """Get the specified set of bytes from remote"""
+        return self.fs.fetch_range(self.path, self.mode, start, end)
diff --git a/llm/Lib/site-packages/fsspec/implementations/data.py b/llm/Lib/site-packages/fsspec/implementations/data.py
new file mode 100644
index 0000000000000000000000000000000000000000..519032305bed633f2ba8a6148076433caf81710b
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/data.py
@@ -0,0 +1,58 @@
+import base64
+import io
+from typing import Optional
+from urllib.parse import unquote
+
+from fsspec import AbstractFileSystem
+
+
+class DataFileSystem(AbstractFileSystem):
+    """A handy decoder for data-URLs
+
+    Example
+    -------
+    >>> with fsspec.open("data:,Hello%2C%20World%21") as f:
+    ...     print(f.read())
+    b"Hello, World!"
+
+    See https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
+    """
+
+    protocol = "data"
+
+    def __init__(self, **kwargs):
+        """No parameters for this filesystem"""
+        super().__init__(**kwargs)
+
+    def cat_file(self, path, start=None, end=None, **kwargs):
+        pref, data = path.split(",", 1)
+        if pref.endswith("base64"):
+            return base64.b64decode(data)[start:end]
+        return unquote(data).encode()[start:end]
+
+    def info(self, path, **kwargs):
+        pref, name = path.split(",", 1)
+        data = self.cat_file(path)
+        mime = pref.split(":", 1)[1].split(";", 1)[0]
+        return {"name": name, "size": len(data), "type": "file", "mimetype": mime}
+
+    def _open(
+        self,
+        path,
+        mode="rb",
+        block_size=None,
+        autocommit=True,
+        cache_options=None,
+        **kwargs,
+    ):
+        if "r" not in mode:
+            raise ValueError("Read only filesystem")
+        return io.BytesIO(self.cat_file(path))
+
+    @staticmethod
+    def encode(data: bytes, mime: Optional[str] = None):
+        """Format the given data into data-URL syntax
+
+        This version always base64 encodes, even when the data is ascii/url-safe.
+        """
+        return f"data:{mime or ''};base64,{base64.b64encode(data).decode()}"
diff --git a/llm/Lib/site-packages/fsspec/implementations/dbfs.py b/llm/Lib/site-packages/fsspec/implementations/dbfs.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce9f9eadb798577970ee95530743b4521813ca7c
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/dbfs.py
@@ -0,0 +1,467 @@
+import base64
+import urllib
+
+import requests
+import requests.exceptions
+from requests.adapters import HTTPAdapter, Retry
+
+from fsspec import AbstractFileSystem
+from fsspec.spec import AbstractBufferedFile
+
+
+class DatabricksException(Exception):
+    """
+    Helper class for exceptions raised in this module.
+    """
+
+    def __init__(self, error_code, message):
+        """Create a new DatabricksException"""
+        super().__init__(message)
+
+        self.error_code = error_code
+        self.message = message
+
+
+class DatabricksFileSystem(AbstractFileSystem):
+    """
+    Get access to the Databricks filesystem implementation over HTTP.
+    Can be used inside and outside of a databricks cluster.
+    """
+
+    def __init__(self, instance, token, **kwargs):
+        """
+        Create a new DatabricksFileSystem.
+
+        Parameters
+        ----------
+        instance: str
+            The instance URL of the databricks cluster.
+            For example for an Azure databricks cluster, this
+            has the form adb-<some-number>.<two digits>.azuredatabricks.net.
+        token: str
+            Your personal token. Find out more
+            here: https://docs.databricks.com/dev-tools/api/latest/authentication.html
+        """
+        self.instance = instance
+        self.token = token
+        self.session = requests.Session()
+        self.retries = Retry(
+            total=10,
+            backoff_factor=0.05,
+            status_forcelist=[408, 429, 500, 502, 503, 504],
+        )
+
+        self.session.mount("https://", HTTPAdapter(max_retries=self.retries))
+        self.session.headers.update({"Authorization": f"Bearer {self.token}"})
+
+        super().__init__(**kwargs)
+
+    def ls(self, path, detail=True, **kwargs):
+        """
+        List the contents of the given path.
+
+        Parameters
+        ----------
+        path: str
+            Absolute path
+        detail: bool
+            Return not only the list of filenames,
+            but also additional information on file sizes
+            and types.
+        """
+        out = self._ls_from_cache(path)
+        if not out:
+            try:
+                r = self._send_to_api(
+                    method="get", endpoint="list", json={"path": path}
+                )
+            except DatabricksException as e:
+                if e.error_code == "RESOURCE_DOES_NOT_EXIST":
+                    raise FileNotFoundError(e.message)
+
+                raise e
+            files = r["files"]
+            out = [
+                {
+                    "name": o["path"],
+                    "type": "directory" if o["is_dir"] else "file",
+                    "size": o["file_size"],
+                }
+                for o in files
+            ]
+            self.dircache[path] = out
+
+        if detail:
+            return out
+        return [o["name"] for o in out]
+
+    def makedirs(self, path, exist_ok=True):
+        """
+        Create a given absolute path and all of its parents.
+
+        Parameters
+        ----------
+        path: str
+            Absolute path to create
+        exist_ok: bool
+            If false, checks if the folder
+            exists before creating it (and raises an
+            Exception if this is the case)
+        """
+        if not exist_ok:
+            try:
+                # If the following succeeds, the path is already present
+                self._send_to_api(
+                    method="get", endpoint="get-status", json={"path": path}
+                )
+                raise FileExistsError(f"Path {path} already exists")
+            except DatabricksException as e:
+                if e.error_code == "RESOURCE_DOES_NOT_EXIST":
+                    pass
+
+        try:
+            self._send_to_api(method="post", endpoint="mkdirs", json={"path": path})
+        except DatabricksException as e:
+            if e.error_code == "RESOURCE_ALREADY_EXISTS":
+                raise FileExistsError(e.message)
+
+            raise e
+        self.invalidate_cache(self._parent(path))
+
+    def mkdir(self, path, create_parents=True, **kwargs):
+        """
+        Create a given absolute path and all of its parents.
+
+        Parameters
+        ----------
+        path: str
+            Absolute path to create
+        create_parents: bool
+            Whether to create all parents or not.
+            "False" is not implemented so far.
+        """
+        if not create_parents:
+            raise NotImplementedError
+
+        self.mkdirs(path, **kwargs)
+
+    def rm(self, path, recursive=False, **kwargs):
+        """
+        Remove the file or folder at the given absolute path.
+
+        Parameters
+        ----------
+        path: str
+            Absolute path what to remove
+        recursive: bool
+            Recursively delete all files in a folder.
+        """
+        try:
+            self._send_to_api(
+                method="post",
+                endpoint="delete",
+                json={"path": path, "recursive": recursive},
+            )
+        except DatabricksException as e:
+            # This is not really an exception, it just means
+            # not everything was deleted so far
+            if e.error_code == "PARTIAL_DELETE":
+                self.rm(path=path, recursive=recursive)
+            elif e.error_code == "IO_ERROR":
+                # Using the same exception as the os module would use here
+                raise OSError(e.message)
+
+            raise e
+        self.invalidate_cache(self._parent(path))
+
+    def mv(
+        self, source_path, destination_path, recursive=False, maxdepth=None, **kwargs
+    ):
+        """
+        Move a source to a destination path.
+
+        A note from the original [databricks API manual]
+        (https://docs.databricks.com/dev-tools/api/latest/dbfs.html#move).
+
+        When moving a large number of files the API call will time out after
+        approximately 60s, potentially resulting in partially moved data.
+        Therefore, for operations that move more than 10k files, we strongly
+        discourage using the DBFS REST API.
+
+        Parameters
+        ----------
+        source_path: str
+            From where to move (absolute path)
+        destination_path: str
+            To where to move (absolute path)
+        recursive: bool
+            Not implemented to far.
+        maxdepth:
+            Not implemented to far.
+        """
+        if recursive:
+            raise NotImplementedError
+        if maxdepth:
+            raise NotImplementedError
+
+        try:
+            self._send_to_api(
+                method="post",
+                endpoint="move",
+                json={"source_path": source_path, "destination_path": destination_path},
+            )
+        except DatabricksException as e:
+            if e.error_code == "RESOURCE_DOES_NOT_EXIST":
+                raise FileNotFoundError(e.message)
+            elif e.error_code == "RESOURCE_ALREADY_EXISTS":
+                raise FileExistsError(e.message)
+
+            raise e
+        self.invalidate_cache(self._parent(source_path))
+        self.invalidate_cache(self._parent(destination_path))
+
+    def _open(self, path, mode="rb", block_size="default", **kwargs):
+        """
+        Overwrite the base class method to make sure to create a DBFile.
+        All arguments are copied from the base method.
+
+        Only the default blocksize is allowed.
+        """
+        return DatabricksFile(self, path, mode=mode, block_size=block_size, **kwargs)
+
+    def _send_to_api(self, method, endpoint, json):
+        """
+        Send the given json to the DBFS API
+        using a get or post request (specified by the argument `method`).
+
+        Parameters
+        ----------
+        method: str
+            Which http method to use for communication; "get" or "post".
+        endpoint: str
+            Where to send the request to (last part of the API URL)
+        json: dict
+            Dictionary of information to send
+        """
+        if method == "post":
+            session_call = self.session.post
+        elif method == "get":
+            session_call = self.session.get
+        else:
+            raise ValueError(f"Do not understand method {method}")
+
+        url = urllib.parse.urljoin(f"https://{self.instance}/api/2.0/dbfs/", endpoint)
+
+        r = session_call(url, json=json)
+
+        # The DBFS API will return a json, also in case of an exception.
+        # We want to preserve this information as good as possible.
+        try:
+            r.raise_for_status()
+        except requests.HTTPError as e:
+            # try to extract json error message
+            # if that fails, fall back to the original exception
+            try:
+                exception_json = e.response.json()
+            except Exception:
+                raise e
+
+            raise DatabricksException(**exception_json)
+
+        return r.json()
+
+    def _create_handle(self, path, overwrite=True):
+        """
+        Internal function to create a handle, which can be used to
+        write blocks of a file to DBFS.
+        A handle has a unique identifier which needs to be passed
+        whenever written during this transaction.
+        The handle is active for 10 minutes - after that a new
+        write transaction needs to be created.
+        Make sure to close the handle after you are finished.
+
+        Parameters
+        ----------
+        path: str
+            Absolute path for this file.
+        overwrite: bool
+            If a file already exist at this location, either overwrite
+            it or raise an exception.
+        """
+        try:
+            r = self._send_to_api(
+                method="post",
+                endpoint="create",
+                json={"path": path, "overwrite": overwrite},
+            )
+            return r["handle"]
+        except DatabricksException as e:
+            if e.error_code == "RESOURCE_ALREADY_EXISTS":
+                raise FileExistsError(e.message)
+
+            raise e
+
+    def _close_handle(self, handle):
+        """
+        Close a handle, which was opened by :func:`_create_handle`.
+
+        Parameters
+        ----------
+        handle: str
+            Which handle to close.
+        """
+        try:
+            self._send_to_api(method="post", endpoint="close", json={"handle": handle})
+        except DatabricksException as e:
+            if e.error_code == "RESOURCE_DOES_NOT_EXIST":
+                raise FileNotFoundError(e.message)
+
+            raise e
+
+    def _add_data(self, handle, data):
+        """
+        Upload data to an already opened file handle
+        (opened by :func:`_create_handle`).
+        The maximal allowed data size is 1MB after
+        conversion to base64.
+        Remember to close the handle when you are finished.
+
+        Parameters
+        ----------
+        handle: str
+            Which handle to upload data to.
+        data: bytes
+            Block of data to add to the handle.
+        """
+        data = base64.b64encode(data).decode()
+        try:
+            self._send_to_api(
+                method="post",
+                endpoint="add-block",
+                json={"handle": handle, "data": data},
+            )
+        except DatabricksException as e:
+            if e.error_code == "RESOURCE_DOES_NOT_EXIST":
+                raise FileNotFoundError(e.message)
+            elif e.error_code == "MAX_BLOCK_SIZE_EXCEEDED":
+                raise ValueError(e.message)
+
+            raise e
+
+    def _get_data(self, path, start, end):
+        """
+        Download data in bytes from a given absolute path in a block
+        from [start, start+length].
+        The maximum number of allowed bytes to read is 1MB.
+
+        Parameters
+        ----------
+        path: str
+            Absolute path to download data from
+        start: int
+            Start position of the block
+        end: int
+            End position of the block
+        """
+        try:
+            r = self._send_to_api(
+                method="get",
+                endpoint="read",
+                json={"path": path, "offset": start, "length": end - start},
+            )
+            return base64.b64decode(r["data"])
+        except DatabricksException as e:
+            if e.error_code == "RESOURCE_DOES_NOT_EXIST":
+                raise FileNotFoundError(e.message)
+            elif e.error_code in ["INVALID_PARAMETER_VALUE", "MAX_READ_SIZE_EXCEEDED"]:
+                raise ValueError(e.message)
+
+            raise e
+
+    def invalidate_cache(self, path=None):
+        if path is None:
+            self.dircache.clear()
+        else:
+            self.dircache.pop(path, None)
+        super().invalidate_cache(path)
+
+
+class DatabricksFile(AbstractBufferedFile):
+    """
+    Helper class for files referenced in the DatabricksFileSystem.
+    """
+
+    DEFAULT_BLOCK_SIZE = 1 * 2**20  # only allowed block size
+
+    def __init__(
+        self,
+        fs,
+        path,
+        mode="rb",
+        block_size="default",
+        autocommit=True,
+        cache_type="readahead",
+        cache_options=None,
+        **kwargs,
+    ):
+        """
+        Create a new instance of the DatabricksFile.
+
+        The blocksize needs to be the default one.
+        """
+        if block_size is None or block_size == "default":
+            block_size = self.DEFAULT_BLOCK_SIZE
+
+        assert (
+            block_size == self.DEFAULT_BLOCK_SIZE
+        ), f"Only the default block size is allowed, not {block_size}"
+
+        super().__init__(
+            fs,
+            path,
+            mode=mode,
+            block_size=block_size,
+            autocommit=autocommit,
+            cache_type=cache_type,
+            cache_options=cache_options or {},
+            **kwargs,
+        )
+
+    def _initiate_upload(self):
+        """Internal function to start a file upload"""
+        self.handle = self.fs._create_handle(self.path)
+
+    def _upload_chunk(self, final=False):
+        """Internal function to add a chunk of data to a started upload"""
+        self.buffer.seek(0)
+        data = self.buffer.getvalue()
+
+        data_chunks = [
+            data[start:end] for start, end in self._to_sized_blocks(len(data))
+        ]
+
+        for data_chunk in data_chunks:
+            self.fs._add_data(handle=self.handle, data=data_chunk)
+
+        if final:
+            self.fs._close_handle(handle=self.handle)
+            return True
+
+    def _fetch_range(self, start, end):
+        """Internal function to download a block of data"""
+        return_buffer = b""
+        length = end - start
+        for chunk_start, chunk_end in self._to_sized_blocks(length, start):
+            return_buffer += self.fs._get_data(
+                path=self.path, start=chunk_start, end=chunk_end
+            )
+
+        return return_buffer
+
+    def _to_sized_blocks(self, length, start=0):
+        """Helper function to split a range from 0 to total_length into bloksizes"""
+        end = start + length
+        for data_chunk in range(start, end, self.blocksize):
+            data_start = data_chunk
+            data_end = min(end, data_chunk + self.blocksize)
+            yield data_start, data_end
diff --git a/llm/Lib/site-packages/fsspec/implementations/dirfs.py b/llm/Lib/site-packages/fsspec/implementations/dirfs.py
new file mode 100644
index 0000000000000000000000000000000000000000..b1b3f6db7fc729a734f628eac6fa0dfb3d5412b5
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/dirfs.py
@@ -0,0 +1,364 @@
+from .. import filesystem
+from ..asyn import AsyncFileSystem
+
+
+class DirFileSystem(AsyncFileSystem):
+    """Directory prefix filesystem
+
+    The DirFileSystem is a filesystem-wrapper. It assumes every path it is dealing with
+    is relative to the `path`. After performing the necessary paths operation it
+    delegates everything to the wrapped filesystem.
+    """
+
+    protocol = "dir"
+
+    def __init__(
+        self,
+        path=None,
+        fs=None,
+        fo=None,
+        target_protocol=None,
+        target_options=None,
+        **storage_options,
+    ):
+        """
+        Parameters
+        ----------
+        path: str
+            Path to the directory.
+        fs: AbstractFileSystem
+            An instantiated filesystem to wrap.
+        target_protocol, target_options:
+            if fs is none, construct it from these
+        fo: str
+            Alternate for path; do not provide both
+        """
+        super().__init__(**storage_options)
+        if fs is None:
+            fs = filesystem(protocol=target_protocol, **(target_options or {}))
+        if (path is not None) ^ (fo is not None) is False:
+            raise ValueError("Provide path or fo, not both")
+        path = path or fo
+
+        if self.asynchronous and not fs.async_impl:
+            raise ValueError("can't use asynchronous with non-async fs")
+
+        if fs.async_impl and self.asynchronous != fs.asynchronous:
+            raise ValueError("both dirfs and fs should be in the same sync/async mode")
+
+        self.path = fs._strip_protocol(path)
+        self.fs = fs
+
+    def _join(self, path):
+        if isinstance(path, str):
+            if not self.path:
+                return path
+            if not path:
+                return self.path
+            return self.fs.sep.join((self.path, self._strip_protocol(path)))
+        return [self._join(_path) for _path in path]
+
+    def _relpath(self, path):
+        if isinstance(path, str):
+            if not self.path:
+                return path
+            if path == self.path:
+                return ""
+            prefix = self.path + self.fs.sep
+            assert path.startswith(prefix)
+            return path[len(prefix) :]
+        return [self._relpath(_path) for _path in path]
+
+    # Wrappers below
+
+    @property
+    def sep(self):
+        return self.fs.sep
+
+    async def set_session(self, *args, **kwargs):
+        return await self.fs.set_session(*args, **kwargs)
+
+    async def _rm_file(self, path, **kwargs):
+        return await self.fs._rm_file(self._join(path), **kwargs)
+
+    def rm_file(self, path, **kwargs):
+        return self.fs.rm_file(self._join(path), **kwargs)
+
+    async def _rm(self, path, *args, **kwargs):
+        return await self.fs._rm(self._join(path), *args, **kwargs)
+
+    def rm(self, path, *args, **kwargs):
+        return self.fs.rm(self._join(path), *args, **kwargs)
+
+    async def _cp_file(self, path1, path2, **kwargs):
+        return await self.fs._cp_file(self._join(path1), self._join(path2), **kwargs)
+
+    def cp_file(self, path1, path2, **kwargs):
+        return self.fs.cp_file(self._join(path1), self._join(path2), **kwargs)
+
+    async def _copy(
+        self,
+        path1,
+        path2,
+        *args,
+        **kwargs,
+    ):
+        return await self.fs._copy(
+            self._join(path1),
+            self._join(path2),
+            *args,
+            **kwargs,
+        )
+
+    def copy(self, path1, path2, *args, **kwargs):
+        return self.fs.copy(
+            self._join(path1),
+            self._join(path2),
+            *args,
+            **kwargs,
+        )
+
+    async def _pipe(self, path, *args, **kwargs):
+        return await self.fs._pipe(self._join(path), *args, **kwargs)
+
+    def pipe(self, path, *args, **kwargs):
+        return self.fs.pipe(self._join(path), *args, **kwargs)
+
+    async def _pipe_file(self, path, *args, **kwargs):
+        return await self.fs._pipe_file(self._join(path), *args, **kwargs)
+
+    def pipe_file(self, path, *args, **kwargs):
+        return self.fs.pipe_file(self._join(path), *args, **kwargs)
+
+    async def _cat_file(self, path, *args, **kwargs):
+        return await self.fs._cat_file(self._join(path), *args, **kwargs)
+
+    def cat_file(self, path, *args, **kwargs):
+        return self.fs.cat_file(self._join(path), *args, **kwargs)
+
+    async def _cat(self, path, *args, **kwargs):
+        ret = await self.fs._cat(
+            self._join(path),
+            *args,
+            **kwargs,
+        )
+
+        if isinstance(ret, dict):
+            return {self._relpath(key): value for key, value in ret.items()}
+
+        return ret
+
+    def cat(self, path, *args, **kwargs):
+        ret = self.fs.cat(
+            self._join(path),
+            *args,
+            **kwargs,
+        )
+
+        if isinstance(ret, dict):
+            return {self._relpath(key): value for key, value in ret.items()}
+
+        return ret
+
+    async def _put_file(self, lpath, rpath, **kwargs):
+        return await self.fs._put_file(lpath, self._join(rpath), **kwargs)
+
+    def put_file(self, lpath, rpath, **kwargs):
+        return self.fs.put_file(lpath, self._join(rpath), **kwargs)
+
+    async def _put(
+        self,
+        lpath,
+        rpath,
+        *args,
+        **kwargs,
+    ):
+        return await self.fs._put(
+            lpath,
+            self._join(rpath),
+            *args,
+            **kwargs,
+        )
+
+    def put(self, lpath, rpath, *args, **kwargs):
+        return self.fs.put(
+            lpath,
+            self._join(rpath),
+            *args,
+            **kwargs,
+        )
+
+    async def _get_file(self, rpath, lpath, **kwargs):
+        return await self.fs._get_file(self._join(rpath), lpath, **kwargs)
+
+    def get_file(self, rpath, lpath, **kwargs):
+        return self.fs.get_file(self._join(rpath), lpath, **kwargs)
+
+    async def _get(self, rpath, *args, **kwargs):
+        return await self.fs._get(self._join(rpath), *args, **kwargs)
+
+    def get(self, rpath, *args, **kwargs):
+        return self.fs.get(self._join(rpath), *args, **kwargs)
+
+    async def _isfile(self, path):
+        return await self.fs._isfile(self._join(path))
+
+    def isfile(self, path):
+        return self.fs.isfile(self._join(path))
+
+    async def _isdir(self, path):
+        return await self.fs._isdir(self._join(path))
+
+    def isdir(self, path):
+        return self.fs.isdir(self._join(path))
+
+    async def _size(self, path):
+        return await self.fs._size(self._join(path))
+
+    def size(self, path):
+        return self.fs.size(self._join(path))
+
+    async def _exists(self, path):
+        return await self.fs._exists(self._join(path))
+
+    def exists(self, path):
+        return self.fs.exists(self._join(path))
+
+    async def _info(self, path, **kwargs):
+        return await self.fs._info(self._join(path), **kwargs)
+
+    def info(self, path, **kwargs):
+        return self.fs.info(self._join(path), **kwargs)
+
+    async def _ls(self, path, detail=True, **kwargs):
+        ret = (await self.fs._ls(self._join(path), detail=detail, **kwargs)).copy()
+        if detail:
+            out = []
+            for entry in ret:
+                entry = entry.copy()
+                entry["name"] = self._relpath(entry["name"])
+                out.append(entry)
+            return out
+
+        return self._relpath(ret)
+
+    def ls(self, path, detail=True, **kwargs):
+        ret = self.fs.ls(self._join(path), detail=detail, **kwargs).copy()
+        if detail:
+            out = []
+            for entry in ret:
+                entry = entry.copy()
+                entry["name"] = self._relpath(entry["name"])
+                out.append(entry)
+            return out
+
+        return self._relpath(ret)
+
+    async def _walk(self, path, *args, **kwargs):
+        async for root, dirs, files in self.fs._walk(self._join(path), *args, **kwargs):
+            yield self._relpath(root), dirs, files
+
+    def walk(self, path, *args, **kwargs):
+        for root, dirs, files in self.fs.walk(self._join(path), *args, **kwargs):
+            yield self._relpath(root), dirs, files
+
+    async def _glob(self, path, **kwargs):
+        detail = kwargs.get("detail", False)
+        ret = await self.fs._glob(self._join(path), **kwargs)
+        if detail:
+            return {self._relpath(path): info for path, info in ret.items()}
+        return self._relpath(ret)
+
+    def glob(self, path, **kwargs):
+        detail = kwargs.get("detail", False)
+        ret = self.fs.glob(self._join(path), **kwargs)
+        if detail:
+            return {self._relpath(path): info for path, info in ret.items()}
+        return self._relpath(ret)
+
+    async def _du(self, path, *args, **kwargs):
+        total = kwargs.get("total", True)
+        ret = await self.fs._du(self._join(path), *args, **kwargs)
+        if total:
+            return ret
+
+        return {self._relpath(path): size for path, size in ret.items()}
+
+    def du(self, path, *args, **kwargs):
+        total = kwargs.get("total", True)
+        ret = self.fs.du(self._join(path), *args, **kwargs)
+        if total:
+            return ret
+
+        return {self._relpath(path): size for path, size in ret.items()}
+
+    async def _find(self, path, *args, **kwargs):
+        detail = kwargs.get("detail", False)
+        ret = await self.fs._find(self._join(path), *args, **kwargs)
+        if detail:
+            return {self._relpath(path): info for path, info in ret.items()}
+        return self._relpath(ret)
+
+    def find(self, path, *args, **kwargs):
+        detail = kwargs.get("detail", False)
+        ret = self.fs.find(self._join(path), *args, **kwargs)
+        if detail:
+            return {self._relpath(path): info for path, info in ret.items()}
+        return self._relpath(ret)
+
+    async def _expand_path(self, path, *args, **kwargs):
+        return self._relpath(
+            await self.fs._expand_path(self._join(path), *args, **kwargs)
+        )
+
+    def expand_path(self, path, *args, **kwargs):
+        return self._relpath(self.fs.expand_path(self._join(path), *args, **kwargs))
+
+    async def _mkdir(self, path, *args, **kwargs):
+        return await self.fs._mkdir(self._join(path), *args, **kwargs)
+
+    def mkdir(self, path, *args, **kwargs):
+        return self.fs.mkdir(self._join(path), *args, **kwargs)
+
+    async def _makedirs(self, path, *args, **kwargs):
+        return await self.fs._makedirs(self._join(path), *args, **kwargs)
+
+    def makedirs(self, path, *args, **kwargs):
+        return self.fs.makedirs(self._join(path), *args, **kwargs)
+
+    def rmdir(self, path):
+        return self.fs.rmdir(self._join(path))
+
+    def mv_file(self, path1, path2, **kwargs):
+        return self.fs.mv_file(
+            self._join(path1),
+            self._join(path2),
+            **kwargs,
+        )
+
+    def touch(self, path, **kwargs):
+        return self.fs.touch(self._join(path), **kwargs)
+
+    def created(self, path):
+        return self.fs.created(self._join(path))
+
+    def modified(self, path):
+        return self.fs.modified(self._join(path))
+
+    def sign(self, path, *args, **kwargs):
+        return self.fs.sign(self._join(path), *args, **kwargs)
+
+    def __repr__(self):
+        return f"{self.__class__.__qualname__}(path='{self.path}', fs={self.fs})"
+
+    def open(
+        self,
+        path,
+        *args,
+        **kwargs,
+    ):
+        return self.fs.open(
+            self._join(path),
+            *args,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/fsspec/implementations/ftp.py b/llm/Lib/site-packages/fsspec/implementations/ftp.py
new file mode 100644
index 0000000000000000000000000000000000000000..415f4844952f362188561a3e41425d364a115400
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/ftp.py
@@ -0,0 +1,385 @@
+import os
+import sys
+import uuid
+import warnings
+from ftplib import FTP, Error, error_perm
+from typing import Any
+
+from ..spec import AbstractBufferedFile, AbstractFileSystem
+from ..utils import infer_storage_options, isfilelike
+
+
+class FTPFileSystem(AbstractFileSystem):
+    """A filesystem over classic FTP"""
+
+    root_marker = "/"
+    cachable = False
+    protocol = "ftp"
+
+    def __init__(
+        self,
+        host,
+        port=21,
+        username=None,
+        password=None,
+        acct=None,
+        block_size=None,
+        tempdir=None,
+        timeout=30,
+        encoding="utf-8",
+        **kwargs,
+    ):
+        """
+        You can use _get_kwargs_from_urls to get some kwargs from
+        a reasonable FTP url.
+
+        Authentication will be anonymous if username/password are not
+        given.
+
+        Parameters
+        ----------
+        host: str
+            The remote server name/ip to connect to
+        port: int
+            Port to connect with
+        username: str or None
+            If authenticating, the user's identifier
+        password: str of None
+            User's password on the server, if using
+        acct: str or None
+            Some servers also need an "account" string for auth
+        block_size: int or None
+            If given, the read-ahead or write buffer size.
+        tempdir: str
+            Directory on remote to put temporary files when in a transaction
+        timeout: int
+            Timeout of the ftp connection in seconds
+        encoding: str
+            Encoding to use for directories and filenames in FTP connection
+        """
+        super().__init__(**kwargs)
+        self.host = host
+        self.port = port
+        self.tempdir = tempdir or "/tmp"
+        self.cred = username, password, acct
+        self.timeout = timeout
+        self.encoding = encoding
+        if block_size is not None:
+            self.blocksize = block_size
+        else:
+            self.blocksize = 2**16
+        self._connect()
+
+    def _connect(self):
+        if sys.version_info >= (3, 9):
+            self.ftp = FTP(timeout=self.timeout, encoding=self.encoding)
+        elif self.encoding:
+            warnings.warn("`encoding` not supported for python<3.9, ignoring")
+            self.ftp = FTP(timeout=self.timeout)
+        else:
+            self.ftp = FTP(timeout=self.timeout)
+        self.ftp.connect(self.host, self.port)
+        self.ftp.login(*self.cred)
+
+    @classmethod
+    def _strip_protocol(cls, path):
+        return "/" + infer_storage_options(path)["path"].lstrip("/").rstrip("/")
+
+    @staticmethod
+    def _get_kwargs_from_urls(urlpath):
+        out = infer_storage_options(urlpath)
+        out.pop("path", None)
+        out.pop("protocol", None)
+        return out
+
+    def ls(self, path, detail=True, **kwargs):
+        path = self._strip_protocol(path)
+        out = []
+        if path not in self.dircache:
+            try:
+                try:
+                    out = [
+                        (fn, details)
+                        for (fn, details) in self.ftp.mlsd(path)
+                        if fn not in [".", ".."]
+                        and details["type"] not in ["pdir", "cdir"]
+                    ]
+                except error_perm:
+                    out = _mlsd2(self.ftp, path)  # Not platform independent
+                for fn, details in out:
+                    if path == "/":
+                        path = ""  # just for forming the names, below
+                    details["name"] = "/".join([path, fn.lstrip("/")])
+                    if details["type"] == "file":
+                        details["size"] = int(details["size"])
+                    else:
+                        details["size"] = 0
+                    if details["type"] == "dir":
+                        details["type"] = "directory"
+                self.dircache[path] = out
+            except Error:
+                try:
+                    info = self.info(path)
+                    if info["type"] == "file":
+                        out = [(path, info)]
+                except (Error, IndexError):
+                    raise FileNotFoundError(path)
+        files = self.dircache.get(path, out)
+        if not detail:
+            return sorted([fn for fn, details in files])
+        return [details for fn, details in files]
+
+    def info(self, path, **kwargs):
+        # implement with direct method
+        path = self._strip_protocol(path)
+        if path == "/":
+            # special case, since this dir has no real entry
+            return {"name": "/", "size": 0, "type": "directory"}
+        files = self.ls(self._parent(path).lstrip("/"), True)
+        try:
+            out = [f for f in files if f["name"] == path][0]
+        except IndexError:
+            raise FileNotFoundError(path)
+        return out
+
+    def get_file(self, rpath, lpath, **kwargs):
+        if self.isdir(rpath):
+            if not os.path.exists(lpath):
+                os.mkdir(lpath)
+            return
+        if isfilelike(lpath):
+            outfile = lpath
+        else:
+            outfile = open(lpath, "wb")
+
+        def cb(x):
+            outfile.write(x)
+
+        self.ftp.retrbinary(
+            f"RETR {rpath}",
+            blocksize=self.blocksize,
+            callback=cb,
+        )
+        if not isfilelike(lpath):
+            outfile.close()
+
+    def cat_file(self, path, start=None, end=None, **kwargs):
+        if end is not None:
+            return super().cat_file(path, start, end, **kwargs)
+        out = []
+
+        def cb(x):
+            out.append(x)
+
+        try:
+            self.ftp.retrbinary(
+                f"RETR {path}",
+                blocksize=self.blocksize,
+                rest=start,
+                callback=cb,
+            )
+        except (Error, error_perm) as orig_exc:
+            raise FileNotFoundError(path) from orig_exc
+        return b"".join(out)
+
+    def _open(
+        self,
+        path,
+        mode="rb",
+        block_size=None,
+        cache_options=None,
+        autocommit=True,
+        **kwargs,
+    ):
+        path = self._strip_protocol(path)
+        block_size = block_size or self.blocksize
+        return FTPFile(
+            self,
+            path,
+            mode=mode,
+            block_size=block_size,
+            tempdir=self.tempdir,
+            autocommit=autocommit,
+            cache_options=cache_options,
+        )
+
+    def _rm(self, path):
+        path = self._strip_protocol(path)
+        self.ftp.delete(path)
+        self.invalidate_cache(self._parent(path))
+
+    def rm(self, path, recursive=False, maxdepth=None):
+        paths = self.expand_path(path, recursive=recursive, maxdepth=maxdepth)
+        for p in reversed(paths):
+            if self.isfile(p):
+                self.rm_file(p)
+            else:
+                self.rmdir(p)
+
+    def mkdir(self, path: str, create_parents: bool = True, **kwargs: Any) -> None:
+        path = self._strip_protocol(path)
+        parent = self._parent(path)
+        if parent != self.root_marker and not self.exists(parent) and create_parents:
+            self.mkdir(parent, create_parents=create_parents)
+
+        self.ftp.mkd(path)
+        self.invalidate_cache(self._parent(path))
+
+    def makedirs(self, path: str, exist_ok: bool = False) -> None:
+        path = self._strip_protocol(path)
+        if self.exists(path):
+            # NB: "/" does not "exist" as it has no directory entry
+            if not exist_ok:
+                raise FileExistsError(f"{path} exists without `exist_ok`")
+            # exists_ok=True -> no-op
+        else:
+            self.mkdir(path, create_parents=True)
+
+    def rmdir(self, path):
+        path = self._strip_protocol(path)
+        self.ftp.rmd(path)
+        self.invalidate_cache(self._parent(path))
+
+    def mv(self, path1, path2, **kwargs):
+        path1 = self._strip_protocol(path1)
+        path2 = self._strip_protocol(path2)
+        self.ftp.rename(path1, path2)
+        self.invalidate_cache(self._parent(path1))
+        self.invalidate_cache(self._parent(path2))
+
+    def __del__(self):
+        self.ftp.close()
+
+    def invalidate_cache(self, path=None):
+        if path is None:
+            self.dircache.clear()
+        else:
+            self.dircache.pop(path, None)
+        super().invalidate_cache(path)
+
+
+class TransferDone(Exception):
+    """Internal exception to break out of transfer"""
+
+    pass
+
+
+class FTPFile(AbstractBufferedFile):
+    """Interact with a remote FTP file with read/write buffering"""
+
+    def __init__(
+        self,
+        fs,
+        path,
+        mode="rb",
+        block_size="default",
+        autocommit=True,
+        cache_type="readahead",
+        cache_options=None,
+        **kwargs,
+    ):
+        super().__init__(
+            fs,
+            path,
+            mode=mode,
+            block_size=block_size,
+            autocommit=autocommit,
+            cache_type=cache_type,
+            cache_options=cache_options,
+            **kwargs,
+        )
+        if not autocommit:
+            self.target = self.path
+            self.path = "/".join([kwargs["tempdir"], str(uuid.uuid4())])
+
+    def commit(self):
+        self.fs.mv(self.path, self.target)
+
+    def discard(self):
+        self.fs.rm(self.path)
+
+    def _fetch_range(self, start, end):
+        """Get bytes between given byte limits
+
+        Implemented by raising an exception in the fetch callback when the
+        number of bytes received reaches the requested amount.
+
+        Will fail if the server does not respect the REST command on
+        retrieve requests.
+        """
+        out = []
+        total = [0]
+
+        def callback(x):
+            total[0] += len(x)
+            if total[0] > end - start:
+                out.append(x[: (end - start) - total[0]])
+                if end < self.size:
+                    raise TransferDone
+            else:
+                out.append(x)
+
+            if total[0] == end - start and end < self.size:
+                raise TransferDone
+
+        try:
+            self.fs.ftp.retrbinary(
+                f"RETR {self.path}",
+                blocksize=self.blocksize,
+                rest=start,
+                callback=callback,
+            )
+        except TransferDone:
+            try:
+                # stop transfer, we got enough bytes for this block
+                self.fs.ftp.abort()
+                self.fs.ftp.getmultiline()
+            except Error:
+                self.fs._connect()
+
+        return b"".join(out)
+
+    def _upload_chunk(self, final=False):
+        self.buffer.seek(0)
+        self.fs.ftp.storbinary(
+            f"STOR {self.path}", self.buffer, blocksize=self.blocksize, rest=self.offset
+        )
+        return True
+
+
+def _mlsd2(ftp, path="."):
+    """
+    Fall back to using `dir` instead of `mlsd` if not supported.
+
+    This parses a Linux style `ls -l` response to `dir`, but the response may
+    be platform dependent.
+
+    Parameters
+    ----------
+    ftp: ftplib.FTP
+    path: str
+        Expects to be given path, but defaults to ".".
+    """
+    lines = []
+    minfo = []
+    ftp.dir(path, lines.append)
+    for line in lines:
+        split_line = line.split()
+        if len(split_line) < 9:
+            continue
+        this = (
+            split_line[-1],
+            {
+                "modify": " ".join(split_line[5:8]),
+                "unix.owner": split_line[2],
+                "unix.group": split_line[3],
+                "unix.mode": split_line[0],
+                "size": split_line[4],
+            },
+        )
+        if "d" == this[1]["unix.mode"][0]:
+            this[1]["type"] = "dir"
+        else:
+            this[1]["type"] = "file"
+        minfo.append(this)
+    return minfo
diff --git a/llm/Lib/site-packages/fsspec/implementations/git.py b/llm/Lib/site-packages/fsspec/implementations/git.py
new file mode 100644
index 0000000000000000000000000000000000000000..7c34d93e08c20fc65421e5aa4bab53e8c683fee7
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/git.py
@@ -0,0 +1,127 @@
+import os
+
+import pygit2
+
+from fsspec.spec import AbstractFileSystem
+
+from .memory import MemoryFile
+
+
+class GitFileSystem(AbstractFileSystem):
+    """Browse the files of a local git repo at any hash/tag/branch
+
+    (experimental backend)
+    """
+
+    root_marker = ""
+    cachable = True
+
+    def __init__(self, path=None, fo=None, ref=None, **kwargs):
+        """
+
+        Parameters
+        ----------
+        path: str (optional)
+            Local location of the repo (uses current directory if not given).
+            May be deprecated in favour of ``fo``. When used with a higher
+            level function such as fsspec.open(), may be of the form
+            "git://[path-to-repo[:]][ref@]path/to/file" (but the actual
+            file path should not contain "@" or ":").
+        fo: str (optional)
+            Same as ``path``, but passed as part of a chained URL. This one
+            takes precedence if both are given.
+        ref: str (optional)
+            Reference to work with, could be a hash, tag or branch name. Defaults
+            to current working tree. Note that ``ls`` and ``open`` also take hash,
+            so this becomes the default for those operations
+        kwargs
+        """
+        super().__init__(**kwargs)
+        self.repo = pygit2.Repository(fo or path or os.getcwd())
+        self.ref = ref or "master"
+
+    @classmethod
+    def _strip_protocol(cls, path):
+        path = super()._strip_protocol(path).lstrip("/")
+        if ":" in path:
+            path = path.split(":", 1)[1]
+        if "@" in path:
+            path = path.split("@", 1)[1]
+        return path.lstrip("/")
+
+    def _path_to_object(self, path, ref):
+        comm, ref = self.repo.resolve_refish(ref or self.ref)
+        parts = path.split("/")
+        tree = comm.tree
+        for part in parts:
+            if part and isinstance(tree, pygit2.Tree):
+                tree = tree[part]
+        return tree
+
+    @staticmethod
+    def _get_kwargs_from_urls(path):
+        if path.startswith("git://"):
+            path = path[6:]
+        out = {}
+        if ":" in path:
+            out["path"], path = path.split(":", 1)
+        if "@" in path:
+            out["ref"], path = path.split("@", 1)
+        return out
+
+    def ls(self, path, detail=True, ref=None, **kwargs):
+        path = self._strip_protocol(path)
+        tree = self._path_to_object(path, ref)
+        if isinstance(tree, pygit2.Tree):
+            out = []
+            for obj in tree:
+                if isinstance(obj, pygit2.Tree):
+                    out.append(
+                        {
+                            "type": "directory",
+                            "name": "/".join([path, obj.name]).lstrip("/"),
+                            "hex": obj.hex,
+                            "mode": f"{obj.filemode:o}",
+                            "size": 0,
+                        }
+                    )
+                else:
+                    out.append(
+                        {
+                            "type": "file",
+                            "name": "/".join([path, obj.name]).lstrip("/"),
+                            "hex": obj.hex,
+                            "mode": f"{obj.filemode:o}",
+                            "size": obj.size,
+                        }
+                    )
+        else:
+            obj = tree
+            out = [
+                {
+                    "type": "file",
+                    "name": obj.name,
+                    "hex": obj.hex,
+                    "mode": f"{obj.filemode:o}",
+                    "size": obj.size,
+                }
+            ]
+        if detail:
+            return out
+        return [o["name"] for o in out]
+
+    def ukey(self, path, ref=None):
+        return self.info(path, ref=ref)["hex"]
+
+    def _open(
+        self,
+        path,
+        mode="rb",
+        block_size=None,
+        autocommit=True,
+        cache_options=None,
+        ref=None,
+        **kwargs,
+    ):
+        obj = self._path_to_object(path, ref or self.ref)
+        return MemoryFile(data=obj.data)
diff --git a/llm/Lib/site-packages/fsspec/implementations/github.py b/llm/Lib/site-packages/fsspec/implementations/github.py
new file mode 100644
index 0000000000000000000000000000000000000000..e8fe7a2f67d7d9648e75b82d5f0b5cf2bf7a4868
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/github.py
@@ -0,0 +1,227 @@
+import requests
+
+from ..spec import AbstractFileSystem
+from ..utils import infer_storage_options
+from .memory import MemoryFile
+
+# TODO: add GIST backend, would be very similar
+
+
+class GithubFileSystem(AbstractFileSystem):
+    """Interface to files in github
+
+    An instance of this class provides the files residing within a remote github
+    repository. You may specify a point in the repos history, by SHA, branch
+    or tag (default is current master).
+
+    Given that code files tend to be small, and that github does not support
+    retrieving partial content, we always fetch whole files.
+
+    When using fsspec.open, allows URIs of the form:
+
+    - "github://path/file", in which case you must specify org, repo and
+      may specify sha in the extra args
+    - 'github://org:repo@/precip/catalog.yml', where the org and repo are
+      part of the URI
+    - 'github://org:repo@sha/precip/catalog.yml', where the sha is also included
+
+    ``sha`` can be the full or abbreviated hex of the commit you want to fetch
+    from, or a branch or tag name (so long as it doesn't contain special characters
+    like "/", "?", which would have to be HTTP-encoded).
+
+    For authorised access, you must provide username and token, which can be made
+    at https://github.com/settings/tokens
+    """
+
+    url = "https://api.github.com/repos/{org}/{repo}/git/trees/{sha}"
+    rurl = "https://raw.githubusercontent.com/{org}/{repo}/{sha}/{path}"
+    protocol = "github"
+    timeout = (60, 60)  # connect, read timeouts
+
+    def __init__(
+        self, org, repo, sha=None, username=None, token=None, timeout=None, **kwargs
+    ):
+        super().__init__(**kwargs)
+        self.org = org
+        self.repo = repo
+        if (username is None) ^ (token is None):
+            raise ValueError("Auth required both username and token")
+        self.username = username
+        self.token = token
+        if timeout is not None:
+            self.timeout = timeout
+        if sha is None:
+            # look up default branch (not necessarily "master")
+            u = "https://api.github.com/repos/{org}/{repo}"
+            r = requests.get(
+                u.format(org=org, repo=repo), timeout=self.timeout, **self.kw
+            )
+            r.raise_for_status()
+            sha = r.json()["default_branch"]
+
+        self.root = sha
+        self.ls("")
+
+    @property
+    def kw(self):
+        if self.username:
+            return {"auth": (self.username, self.token)}
+        return {}
+
+    @classmethod
+    def repos(cls, org_or_user, is_org=True):
+        """List repo names for given org or user
+
+        This may become the top level of the FS
+
+        Parameters
+        ----------
+        org_or_user: str
+            Name of the github org or user to query
+        is_org: bool (default True)
+            Whether the name is an organisation (True) or user (False)
+
+        Returns
+        -------
+        List of string
+        """
+        r = requests.get(
+            f"https://api.github.com/{['users', 'orgs'][is_org]}/{org_or_user}/repos",
+            timeout=cls.timeout,
+        )
+        r.raise_for_status()
+        return [repo["name"] for repo in r.json()]
+
+    @property
+    def tags(self):
+        """Names of tags in the repo"""
+        r = requests.get(
+            f"https://api.github.com/repos/{self.org}/{self.repo}/tags",
+            timeout=self.timeout,
+            **self.kw,
+        )
+        r.raise_for_status()
+        return [t["name"] for t in r.json()]
+
+    @property
+    def branches(self):
+        """Names of branches in the repo"""
+        r = requests.get(
+            f"https://api.github.com/repos/{self.org}/{self.repo}/branches",
+            timeout=self.timeout,
+            **self.kw,
+        )
+        r.raise_for_status()
+        return [t["name"] for t in r.json()]
+
+    @property
+    def refs(self):
+        """Named references, tags and branches"""
+        return {"tags": self.tags, "branches": self.branches}
+
+    def ls(self, path, detail=False, sha=None, _sha=None, **kwargs):
+        """List files at given path
+
+        Parameters
+        ----------
+        path: str
+            Location to list, relative to repo root
+        detail: bool
+            If True, returns list of dicts, one per file; if False, returns
+            list of full filenames only
+        sha: str (optional)
+            List at the given point in the repo history, branch or tag name or commit
+            SHA
+        _sha: str (optional)
+            List this specific tree object (used internally to descend into trees)
+        """
+        path = self._strip_protocol(path)
+        if path == "":
+            _sha = sha or self.root
+        if _sha is None:
+            parts = path.rstrip("/").split("/")
+            so_far = ""
+            _sha = sha or self.root
+            for part in parts:
+                out = self.ls(so_far, True, sha=sha, _sha=_sha)
+                so_far += "/" + part if so_far else part
+                out = [o for o in out if o["name"] == so_far]
+                if not out:
+                    raise FileNotFoundError(path)
+                out = out[0]
+                if out["type"] == "file":
+                    if detail:
+                        return [out]
+                    else:
+                        return path
+                _sha = out["sha"]
+        if path not in self.dircache or sha not in [self.root, None]:
+            r = requests.get(
+                self.url.format(org=self.org, repo=self.repo, sha=_sha),
+                timeout=self.timeout,
+                **self.kw,
+            )
+            if r.status_code == 404:
+                raise FileNotFoundError(path)
+            r.raise_for_status()
+            types = {"blob": "file", "tree": "directory"}
+            out = [
+                {
+                    "name": path + "/" + f["path"] if path else f["path"],
+                    "mode": f["mode"],
+                    "type": types[f["type"]],
+                    "size": f.get("size", 0),
+                    "sha": f["sha"],
+                }
+                for f in r.json()["tree"]
+                if f["type"] in types
+            ]
+            if sha in [self.root, None]:
+                self.dircache[path] = out
+        else:
+            out = self.dircache[path]
+        if detail:
+            return out
+        else:
+            return sorted([f["name"] for f in out])
+
+    def invalidate_cache(self, path=None):
+        self.dircache.clear()
+
+    @classmethod
+    def _strip_protocol(cls, path):
+        opts = infer_storage_options(path)
+        if "username" not in opts:
+            return super()._strip_protocol(path)
+        return opts["path"].lstrip("/")
+
+    @staticmethod
+    def _get_kwargs_from_urls(path):
+        opts = infer_storage_options(path)
+        if "username" not in opts:
+            return {}
+        out = {"org": opts["username"], "repo": opts["password"]}
+        if opts["host"]:
+            out["sha"] = opts["host"]
+        return out
+
+    def _open(
+        self,
+        path,
+        mode="rb",
+        block_size=None,
+        autocommit=True,
+        cache_options=None,
+        sha=None,
+        **kwargs,
+    ):
+        if mode != "rb":
+            raise NotImplementedError
+        url = self.rurl.format(
+            org=self.org, repo=self.repo, path=path, sha=sha or self.root
+        )
+        r = requests.get(url, timeout=self.timeout, **self.kw)
+        if r.status_code == 404:
+            raise FileNotFoundError(path)
+        r.raise_for_status()
+        return MemoryFile(None, None, r.content)
diff --git a/llm/Lib/site-packages/fsspec/implementations/http.py b/llm/Lib/site-packages/fsspec/implementations/http.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ffb7ed4195b8bc1fa41c34fc619a4c6eaa47912
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/http.py
@@ -0,0 +1,871 @@
+import asyncio
+import io
+import logging
+import re
+import weakref
+from copy import copy
+from urllib.parse import urlparse
+
+import aiohttp
+import yarl
+
+from fsspec.asyn import AbstractAsyncStreamedFile, AsyncFileSystem, sync, sync_wrapper
+from fsspec.callbacks import DEFAULT_CALLBACK
+from fsspec.exceptions import FSTimeoutError
+from fsspec.spec import AbstractBufferedFile
+from fsspec.utils import (
+    DEFAULT_BLOCK_SIZE,
+    glob_translate,
+    isfilelike,
+    nullcontext,
+    tokenize,
+)
+
+from ..caching import AllBytes
+
+# https://stackoverflow.com/a/15926317/3821154
+ex = re.compile(r"""<(a|A)\s+(?:[^>]*?\s+)?(href|HREF)=["'](?P<url>[^"']+)""")
+ex2 = re.compile(r"""(?P<url>http[s]?://[-a-zA-Z0-9@:%_+.~#?&/=]+)""")
+logger = logging.getLogger("fsspec.http")
+
+
+async def get_client(**kwargs):
+    return aiohttp.ClientSession(**kwargs)
+
+
+class HTTPFileSystem(AsyncFileSystem):
+    """
+    Simple File-System for fetching data via HTTP(S)
+
+    ``ls()`` is implemented by loading the parent page and doing a regex
+    match on the result. If simple_link=True, anything of the form
+    "http(s)://server.com/stuff?thing=other"; otherwise only links within
+    HTML href tags will be used.
+    """
+
+    sep = "/"
+
+    def __init__(
+        self,
+        simple_links=True,
+        block_size=None,
+        same_scheme=True,
+        size_policy=None,
+        cache_type="bytes",
+        cache_options=None,
+        asynchronous=False,
+        loop=None,
+        client_kwargs=None,
+        get_client=get_client,
+        encoded=False,
+        **storage_options,
+    ):
+        """
+        NB: if this is called async, you must await set_client
+
+        Parameters
+        ----------
+        block_size: int
+            Blocks to read bytes; if 0, will default to raw requests file-like
+            objects instead of HTTPFile instances
+        simple_links: bool
+            If True, will consider both HTML <a> tags and anything that looks
+            like a URL; if False, will consider only the former.
+        same_scheme: True
+            When doing ls/glob, if this is True, only consider paths that have
+            http/https matching the input URLs.
+        size_policy: this argument is deprecated
+        client_kwargs: dict
+            Passed to aiohttp.ClientSession, see
+            https://docs.aiohttp.org/en/stable/client_reference.html
+            For example, ``{'auth': aiohttp.BasicAuth('user', 'pass')}``
+        get_client: Callable[..., aiohttp.ClientSession]
+            A callable which takes keyword arguments and constructs
+            an aiohttp.ClientSession. It's state will be managed by
+            the HTTPFileSystem class.
+        storage_options: key-value
+            Any other parameters passed on to requests
+        cache_type, cache_options: defaults used in open
+        """
+        super().__init__(self, asynchronous=asynchronous, loop=loop, **storage_options)
+        self.block_size = block_size if block_size is not None else DEFAULT_BLOCK_SIZE
+        self.simple_links = simple_links
+        self.same_schema = same_scheme
+        self.cache_type = cache_type
+        self.cache_options = cache_options
+        self.client_kwargs = client_kwargs or {}
+        self.get_client = get_client
+        self.encoded = encoded
+        self.kwargs = storage_options
+        self._session = None
+
+        # Clean caching-related parameters from `storage_options`
+        # before propagating them as `request_options` through `self.kwargs`.
+        # TODO: Maybe rename `self.kwargs` to `self.request_options` to make
+        #       it clearer.
+        request_options = copy(storage_options)
+        self.use_listings_cache = request_options.pop("use_listings_cache", False)
+        request_options.pop("listings_expiry_time", None)
+        request_options.pop("max_paths", None)
+        request_options.pop("skip_instance_cache", None)
+        self.kwargs = request_options
+
+    @property
+    def fsid(self):
+        return "http"
+
+    def encode_url(self, url):
+        return yarl.URL(url, encoded=self.encoded)
+
+    @staticmethod
+    def close_session(loop, session):
+        if loop is not None and loop.is_running():
+            try:
+                sync(loop, session.close, timeout=0.1)
+                return
+            except (TimeoutError, FSTimeoutError, NotImplementedError):
+                pass
+        connector = getattr(session, "_connector", None)
+        if connector is not None:
+            # close after loop is dead
+            connector._close()
+
+    async def set_session(self):
+        if self._session is None:
+            self._session = await self.get_client(loop=self.loop, **self.client_kwargs)
+            if not self.asynchronous:
+                weakref.finalize(self, self.close_session, self.loop, self._session)
+        return self._session
+
+    @classmethod
+    def _strip_protocol(cls, path):
+        """For HTTP, we always want to keep the full URL"""
+        return path
+
+    @classmethod
+    def _parent(cls, path):
+        # override, since _strip_protocol is different for URLs
+        par = super()._parent(path)
+        if len(par) > 7:  # "http://..."
+            return par
+        return ""
+
+    async def _ls_real(self, url, detail=True, **kwargs):
+        # ignoring URL-encoded arguments
+        kw = self.kwargs.copy()
+        kw.update(kwargs)
+        logger.debug(url)
+        session = await self.set_session()
+        async with session.get(self.encode_url(url), **self.kwargs) as r:
+            self._raise_not_found_for_status(r, url)
+            try:
+                text = await r.text()
+                if self.simple_links:
+                    links = ex2.findall(text) + [u[2] for u in ex.findall(text)]
+                else:
+                    links = [u[2] for u in ex.findall(text)]
+            except UnicodeDecodeError:
+                links = []  # binary, not HTML
+        out = set()
+        parts = urlparse(url)
+        for l in links:
+            if isinstance(l, tuple):
+                l = l[1]
+            if l.startswith("/") and len(l) > 1:
+                # absolute URL on this server
+                l = f"{parts.scheme}://{parts.netloc}{l}"
+            if l.startswith("http"):
+                if self.same_schema and l.startswith(url.rstrip("/") + "/"):
+                    out.add(l)
+                elif l.replace("https", "http").startswith(
+                    url.replace("https", "http").rstrip("/") + "/"
+                ):
+                    # allowed to cross http <-> https
+                    out.add(l)
+            else:
+                if l not in ["..", "../"]:
+                    # Ignore FTP-like "parent"
+                    out.add("/".join([url.rstrip("/"), l.lstrip("/")]))
+        if not out and url.endswith("/"):
+            out = await self._ls_real(url.rstrip("/"), detail=False)
+        if detail:
+            return [
+                {
+                    "name": u,
+                    "size": None,
+                    "type": "directory" if u.endswith("/") else "file",
+                }
+                for u in out
+            ]
+        else:
+            return sorted(out)
+
+    async def _ls(self, url, detail=True, **kwargs):
+        if self.use_listings_cache and url in self.dircache:
+            out = self.dircache[url]
+        else:
+            out = await self._ls_real(url, detail=detail, **kwargs)
+            self.dircache[url] = out
+        return out
+
+    ls = sync_wrapper(_ls)
+
+    def _raise_not_found_for_status(self, response, url):
+        """
+        Raises FileNotFoundError for 404s, otherwise uses raise_for_status.
+        """
+        if response.status == 404:
+            raise FileNotFoundError(url)
+        response.raise_for_status()
+
+    async def _cat_file(self, url, start=None, end=None, **kwargs):
+        kw = self.kwargs.copy()
+        kw.update(kwargs)
+        logger.debug(url)
+
+        if start is not None or end is not None:
+            if start == end:
+                return b""
+            headers = kw.pop("headers", {}).copy()
+
+            headers["Range"] = await self._process_limits(url, start, end)
+            kw["headers"] = headers
+        session = await self.set_session()
+        async with session.get(self.encode_url(url), **kw) as r:
+            out = await r.read()
+            self._raise_not_found_for_status(r, url)
+        return out
+
+    async def _get_file(
+        self, rpath, lpath, chunk_size=5 * 2**20, callback=DEFAULT_CALLBACK, **kwargs
+    ):
+        kw = self.kwargs.copy()
+        kw.update(kwargs)
+        logger.debug(rpath)
+        session = await self.set_session()
+        async with session.get(self.encode_url(rpath), **kw) as r:
+            try:
+                size = int(r.headers["content-length"])
+            except (ValueError, KeyError):
+                size = None
+
+            callback.set_size(size)
+            self._raise_not_found_for_status(r, rpath)
+            if isfilelike(lpath):
+                outfile = lpath
+            else:
+                outfile = open(lpath, "wb")  # noqa: ASYNC101
+
+            try:
+                chunk = True
+                while chunk:
+                    chunk = await r.content.read(chunk_size)
+                    outfile.write(chunk)
+                    callback.relative_update(len(chunk))
+            finally:
+                if not isfilelike(lpath):
+                    outfile.close()
+
+    async def _put_file(
+        self,
+        lpath,
+        rpath,
+        chunk_size=5 * 2**20,
+        callback=DEFAULT_CALLBACK,
+        method="post",
+        **kwargs,
+    ):
+        async def gen_chunks():
+            # Support passing arbitrary file-like objects
+            # and use them instead of streams.
+            if isinstance(lpath, io.IOBase):
+                context = nullcontext(lpath)
+                use_seek = False  # might not support seeking
+            else:
+                context = open(lpath, "rb")  # noqa: ASYNC101
+                use_seek = True
+
+            with context as f:
+                if use_seek:
+                    callback.set_size(f.seek(0, 2))
+                    f.seek(0)
+                else:
+                    callback.set_size(getattr(f, "size", None))
+
+                chunk = f.read(chunk_size)
+                while chunk:
+                    yield chunk
+                    callback.relative_update(len(chunk))
+                    chunk = f.read(chunk_size)
+
+        kw = self.kwargs.copy()
+        kw.update(kwargs)
+        session = await self.set_session()
+
+        method = method.lower()
+        if method not in ("post", "put"):
+            raise ValueError(
+                f"method has to be either 'post' or 'put', not: {method!r}"
+            )
+
+        meth = getattr(session, method)
+        async with meth(self.encode_url(rpath), data=gen_chunks(), **kw) as resp:
+            self._raise_not_found_for_status(resp, rpath)
+
+    async def _exists(self, path, **kwargs):
+        kw = self.kwargs.copy()
+        kw.update(kwargs)
+        try:
+            logger.debug(path)
+            session = await self.set_session()
+            r = await session.get(self.encode_url(path), **kw)
+            async with r:
+                return r.status < 400
+        except aiohttp.ClientError:
+            return False
+
+    async def _isfile(self, path, **kwargs):
+        return await self._exists(path, **kwargs)
+
+    def _open(
+        self,
+        path,
+        mode="rb",
+        block_size=None,
+        autocommit=None,  # XXX: This differs from the base class.
+        cache_type=None,
+        cache_options=None,
+        size=None,
+        **kwargs,
+    ):
+        """Make a file-like object
+
+        Parameters
+        ----------
+        path: str
+            Full URL with protocol
+        mode: string
+            must be "rb"
+        block_size: int or None
+            Bytes to download in one request; use instance value if None. If
+            zero, will return a streaming Requests file-like instance.
+        kwargs: key-value
+            Any other parameters, passed to requests calls
+        """
+        if mode != "rb":
+            raise NotImplementedError
+        block_size = block_size if block_size is not None else self.block_size
+        kw = self.kwargs.copy()
+        kw["asynchronous"] = self.asynchronous
+        kw.update(kwargs)
+        size = size or self.info(path, **kwargs)["size"]
+        session = sync(self.loop, self.set_session)
+        if block_size and size:
+            return HTTPFile(
+                self,
+                path,
+                session=session,
+                block_size=block_size,
+                mode=mode,
+                size=size,
+                cache_type=cache_type or self.cache_type,
+                cache_options=cache_options or self.cache_options,
+                loop=self.loop,
+                **kw,
+            )
+        else:
+            return HTTPStreamFile(
+                self,
+                path,
+                mode=mode,
+                loop=self.loop,
+                session=session,
+                **kw,
+            )
+
+    async def open_async(self, path, mode="rb", size=None, **kwargs):
+        session = await self.set_session()
+        if size is None:
+            try:
+                size = (await self._info(path, **kwargs))["size"]
+            except FileNotFoundError:
+                pass
+        return AsyncStreamFile(
+            self,
+            path,
+            loop=self.loop,
+            session=session,
+            size=size,
+            **kwargs,
+        )
+
+    def ukey(self, url):
+        """Unique identifier; assume HTTP files are static, unchanging"""
+        return tokenize(url, self.kwargs, self.protocol)
+
+    async def _info(self, url, **kwargs):
+        """Get info of URL
+
+        Tries to access location via HEAD, and then GET methods, but does
+        not fetch the data.
+
+        It is possible that the server does not supply any size information, in
+        which case size will be given as None (and certain operations on the
+        corresponding file will not work).
+        """
+        info = {}
+        session = await self.set_session()
+
+        for policy in ["head", "get"]:
+            try:
+                info.update(
+                    await _file_info(
+                        self.encode_url(url),
+                        size_policy=policy,
+                        session=session,
+                        **self.kwargs,
+                        **kwargs,
+                    )
+                )
+                if info.get("size") is not None:
+                    break
+            except Exception as exc:
+                if policy == "get":
+                    # If get failed, then raise a FileNotFoundError
+                    raise FileNotFoundError(url) from exc
+                logger.debug("", exc_info=exc)
+
+        return {"name": url, "size": None, **info, "type": "file"}
+
+    async def _glob(self, path, maxdepth=None, **kwargs):
+        """
+        Find files by glob-matching.
+
+        This implementation is idntical to the one in AbstractFileSystem,
+        but "?" is not considered as a character for globbing, because it is
+        so common in URLs, often identifying the "query" part.
+        """
+        if maxdepth is not None and maxdepth < 1:
+            raise ValueError("maxdepth must be at least 1")
+        import re
+
+        ends_with_slash = path.endswith("/")  # _strip_protocol strips trailing slash
+        path = self._strip_protocol(path)
+        append_slash_to_dirname = ends_with_slash or path.endswith("/**")
+        idx_star = path.find("*") if path.find("*") >= 0 else len(path)
+        idx_brace = path.find("[") if path.find("[") >= 0 else len(path)
+
+        min_idx = min(idx_star, idx_brace)
+
+        detail = kwargs.pop("detail", False)
+
+        if not has_magic(path):
+            if await self._exists(path, **kwargs):
+                if not detail:
+                    return [path]
+                else:
+                    return {path: await self._info(path, **kwargs)}
+            else:
+                if not detail:
+                    return []  # glob of non-existent returns empty
+                else:
+                    return {}
+        elif "/" in path[:min_idx]:
+            min_idx = path[:min_idx].rindex("/")
+            root = path[: min_idx + 1]
+            depth = path[min_idx + 1 :].count("/") + 1
+        else:
+            root = ""
+            depth = path[min_idx + 1 :].count("/") + 1
+
+        if "**" in path:
+            if maxdepth is not None:
+                idx_double_stars = path.find("**")
+                depth_double_stars = path[idx_double_stars:].count("/") + 1
+                depth = depth - depth_double_stars + maxdepth
+            else:
+                depth = None
+
+        allpaths = await self._find(
+            root, maxdepth=depth, withdirs=True, detail=True, **kwargs
+        )
+
+        pattern = glob_translate(path + ("/" if ends_with_slash else ""))
+        pattern = re.compile(pattern)
+
+        out = {
+            p: info
+            for p, info in sorted(allpaths.items())
+            if pattern.match(
+                (
+                    p + "/"
+                    if append_slash_to_dirname and info["type"] == "directory"
+                    else p
+                )
+            )
+        }
+
+        if detail:
+            return out
+        else:
+            return list(out)
+
+    async def _isdir(self, path):
+        # override, since all URLs are (also) files
+        try:
+            return bool(await self._ls(path))
+        except (FileNotFoundError, ValueError):
+            return False
+
+
+class HTTPFile(AbstractBufferedFile):
+    """
+    A file-like object pointing to a remove HTTP(S) resource
+
+    Supports only reading, with read-ahead of a predermined block-size.
+
+    In the case that the server does not supply the filesize, only reading of
+    the complete file in one go is supported.
+
+    Parameters
+    ----------
+    url: str
+        Full URL of the remote resource, including the protocol
+    session: aiohttp.ClientSession or None
+        All calls will be made within this session, to avoid restarting
+        connections where the server allows this
+    block_size: int or None
+        The amount of read-ahead to do, in bytes. Default is 5MB, or the value
+        configured for the FileSystem creating this file
+    size: None or int
+        If given, this is the size of the file in bytes, and we don't attempt
+        to call the server to find the value.
+    kwargs: all other key-values are passed to requests calls.
+    """
+
+    def __init__(
+        self,
+        fs,
+        url,
+        session=None,
+        block_size=None,
+        mode="rb",
+        cache_type="bytes",
+        cache_options=None,
+        size=None,
+        loop=None,
+        asynchronous=False,
+        **kwargs,
+    ):
+        if mode != "rb":
+            raise NotImplementedError("File mode not supported")
+        self.asynchronous = asynchronous
+        self.url = url
+        self.session = session
+        self.details = {"name": url, "size": size, "type": "file"}
+        super().__init__(
+            fs=fs,
+            path=url,
+            mode=mode,
+            block_size=block_size,
+            cache_type=cache_type,
+            cache_options=cache_options,
+            **kwargs,
+        )
+        self.loop = loop
+
+    def read(self, length=-1):
+        """Read bytes from file
+
+        Parameters
+        ----------
+        length: int
+            Read up to this many bytes. If negative, read all content to end of
+            file. If the server has not supplied the filesize, attempting to
+            read only part of the data will raise a ValueError.
+        """
+        if (
+            (length < 0 and self.loc == 0)  # explicit read all
+            # but not when the size is known and fits into a block anyways
+            and not (self.size is not None and self.size <= self.blocksize)
+        ):
+            self._fetch_all()
+        if self.size is None:
+            if length < 0:
+                self._fetch_all()
+        else:
+            length = min(self.size - self.loc, length)
+        return super().read(length)
+
+    async def async_fetch_all(self):
+        """Read whole file in one shot, without caching
+
+        This is only called when position is still at zero,
+        and read() is called without a byte-count.
+        """
+        logger.debug(f"Fetch all for {self}")
+        if not isinstance(self.cache, AllBytes):
+            r = await self.session.get(self.fs.encode_url(self.url), **self.kwargs)
+            async with r:
+                r.raise_for_status()
+                out = await r.read()
+                self.cache = AllBytes(
+                    size=len(out), fetcher=None, blocksize=None, data=out
+                )
+                self.size = len(out)
+
+    _fetch_all = sync_wrapper(async_fetch_all)
+
+    def _parse_content_range(self, headers):
+        """Parse the Content-Range header"""
+        s = headers.get("Content-Range", "")
+        m = re.match(r"bytes (\d+-\d+|\*)/(\d+|\*)", s)
+        if not m:
+            return None, None, None
+
+        if m[1] == "*":
+            start = end = None
+        else:
+            start, end = [int(x) for x in m[1].split("-")]
+        total = None if m[2] == "*" else int(m[2])
+        return start, end, total
+
+    async def async_fetch_range(self, start, end):
+        """Download a block of data
+
+        The expectation is that the server returns only the requested bytes,
+        with HTTP code 206. If this is not the case, we first check the headers,
+        and then stream the output - if the data size is bigger than we
+        requested, an exception is raised.
+        """
+        logger.debug(f"Fetch range for {self}: {start}-{end}")
+        kwargs = self.kwargs.copy()
+        headers = kwargs.pop("headers", {}).copy()
+        headers["Range"] = f"bytes={start}-{end - 1}"
+        logger.debug(f"{self.url} : {headers['Range']}")
+        r = await self.session.get(
+            self.fs.encode_url(self.url), headers=headers, **kwargs
+        )
+        async with r:
+            if r.status == 416:
+                # range request outside file
+                return b""
+            r.raise_for_status()
+
+            # If the server has handled the range request, it should reply
+            # with status 206 (partial content). But we'll guess that a suitable
+            # Content-Range header or a Content-Length no more than the
+            # requested range also mean we have got the desired range.
+            response_is_range = (
+                r.status == 206
+                or self._parse_content_range(r.headers)[0] == start
+                or int(r.headers.get("Content-Length", end + 1)) <= end - start
+            )
+
+            if response_is_range:
+                # partial content, as expected
+                out = await r.read()
+            elif start > 0:
+                raise ValueError(
+                    "The HTTP server doesn't appear to support range requests. "
+                    "Only reading this file from the beginning is supported. "
+                    "Open with block_size=0 for a streaming file interface."
+                )
+            else:
+                # Response is not a range, but we want the start of the file,
+                # so we can read the required amount anyway.
+                cl = 0
+                out = []
+                while True:
+                    chunk = await r.content.read(2**20)
+                    # data size unknown, let's read until we have enough
+                    if chunk:
+                        out.append(chunk)
+                        cl += len(chunk)
+                        if cl > end - start:
+                            break
+                    else:
+                        break
+                out = b"".join(out)[: end - start]
+            return out
+
+    _fetch_range = sync_wrapper(async_fetch_range)
+
+    def __reduce__(self):
+        return (
+            reopen,
+            (
+                self.fs,
+                self.url,
+                self.mode,
+                self.blocksize,
+                self.cache.name if self.cache else "none",
+                self.size,
+            ),
+        )
+
+
+def reopen(fs, url, mode, blocksize, cache_type, size=None):
+    return fs.open(
+        url, mode=mode, block_size=blocksize, cache_type=cache_type, size=size
+    )
+
+
+magic_check = re.compile("([*[])")
+
+
+def has_magic(s):
+    match = magic_check.search(s)
+    return match is not None
+
+
+class HTTPStreamFile(AbstractBufferedFile):
+    def __init__(self, fs, url, mode="rb", loop=None, session=None, **kwargs):
+        self.asynchronous = kwargs.pop("asynchronous", False)
+        self.url = url
+        self.loop = loop
+        self.session = session
+        if mode != "rb":
+            raise ValueError
+        self.details = {"name": url, "size": None}
+        super().__init__(fs=fs, path=url, mode=mode, cache_type="none", **kwargs)
+
+        async def cor():
+            r = await self.session.get(self.fs.encode_url(url), **kwargs).__aenter__()
+            self.fs._raise_not_found_for_status(r, url)
+            return r
+
+        self.r = sync(self.loop, cor)
+
+    def seek(self, loc, whence=0):
+        if loc == 0 and whence == 1:
+            return
+        if loc == self.loc and whence == 0:
+            return
+        raise ValueError("Cannot seek streaming HTTP file")
+
+    async def _read(self, num=-1):
+        out = await self.r.content.read(num)
+        self.loc += len(out)
+        return out
+
+    read = sync_wrapper(_read)
+
+    async def _close(self):
+        self.r.close()
+
+    def close(self):
+        asyncio.run_coroutine_threadsafe(self._close(), self.loop)
+        super().close()
+
+    def __reduce__(self):
+        return reopen, (self.fs, self.url, self.mode, self.blocksize, self.cache.name)
+
+
+class AsyncStreamFile(AbstractAsyncStreamedFile):
+    def __init__(
+        self, fs, url, mode="rb", loop=None, session=None, size=None, **kwargs
+    ):
+        self.url = url
+        self.session = session
+        self.r = None
+        if mode != "rb":
+            raise ValueError
+        self.details = {"name": url, "size": None}
+        self.kwargs = kwargs
+        super().__init__(fs=fs, path=url, mode=mode, cache_type="none")
+        self.size = size
+
+    async def read(self, num=-1):
+        if self.r is None:
+            r = await self.session.get(
+                self.fs.encode_url(self.url), **self.kwargs
+            ).__aenter__()
+            self.fs._raise_not_found_for_status(r, self.url)
+            self.r = r
+        out = await self.r.content.read(num)
+        self.loc += len(out)
+        return out
+
+    async def close(self):
+        if self.r is not None:
+            self.r.close()
+            self.r = None
+        await super().close()
+
+
+async def get_range(session, url, start, end, file=None, **kwargs):
+    # explicit get a range when we know it must be safe
+    kwargs = kwargs.copy()
+    headers = kwargs.pop("headers", {}).copy()
+    headers["Range"] = f"bytes={start}-{end - 1}"
+    r = await session.get(url, headers=headers, **kwargs)
+    r.raise_for_status()
+    async with r:
+        out = await r.read()
+    if file:
+        with open(file, "r+b") as f:  # noqa: ASYNC101
+            f.seek(start)
+            f.write(out)
+    else:
+        return out
+
+
+async def _file_info(url, session, size_policy="head", **kwargs):
+    """Call HEAD on the server to get details about the file (size/checksum etc.)
+
+    Default operation is to explicitly allow redirects and use encoding
+    'identity' (no compression) to get the true size of the target.
+    """
+    logger.debug("Retrieve file size for %s", url)
+    kwargs = kwargs.copy()
+    ar = kwargs.pop("allow_redirects", True)
+    head = kwargs.get("headers", {}).copy()
+    head["Accept-Encoding"] = "identity"
+    kwargs["headers"] = head
+
+    info = {}
+    if size_policy == "head":
+        r = await session.head(url, allow_redirects=ar, **kwargs)
+    elif size_policy == "get":
+        r = await session.get(url, allow_redirects=ar, **kwargs)
+    else:
+        raise TypeError(f'size_policy must be "head" or "get", got {size_policy}')
+    async with r:
+        r.raise_for_status()
+
+        # TODO:
+        #  recognise lack of 'Accept-Ranges',
+        #                 or 'Accept-Ranges': 'none' (not 'bytes')
+        #  to mean streaming only, no random access => return None
+        if "Content-Length" in r.headers:
+            # Some servers may choose to ignore Accept-Encoding and return
+            # compressed content, in which case the returned size is unreliable.
+            if "Content-Encoding" not in r.headers or r.headers["Content-Encoding"] in [
+                "identity",
+                "",
+            ]:
+                info["size"] = int(r.headers["Content-Length"])
+        elif "Content-Range" in r.headers:
+            info["size"] = int(r.headers["Content-Range"].split("/")[1])
+
+        if "Content-Type" in r.headers:
+            info["mimetype"] = r.headers["Content-Type"].partition(";")[0]
+
+        info["url"] = str(r.url)
+
+        for checksum_field in ["ETag", "Content-MD5", "Digest"]:
+            if r.headers.get(checksum_field):
+                info[checksum_field] = r.headers[checksum_field]
+
+    return info
+
+
+async def _file_size(url, session=None, *args, **kwargs):
+    if session is None:
+        session = await get_client()
+    info = await _file_info(url, session=session, *args, **kwargs)
+    return info.get("size")
+
+
+file_size = sync_wrapper(_file_size)
diff --git a/llm/Lib/site-packages/fsspec/implementations/jupyter.py b/llm/Lib/site-packages/fsspec/implementations/jupyter.py
new file mode 100644
index 0000000000000000000000000000000000000000..2839f4c1feea56dddd54bdc00f0b884c8461d29e
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/jupyter.py
@@ -0,0 +1,124 @@
+import base64
+import io
+import re
+
+import requests
+
+import fsspec
+
+
+class JupyterFileSystem(fsspec.AbstractFileSystem):
+    """View of the files as seen by a Jupyter server (notebook or lab)"""
+
+    protocol = ("jupyter", "jlab")
+
+    def __init__(self, url, tok=None, **kwargs):
+        """
+
+        Parameters
+        ----------
+        url : str
+            Base URL of the server, like "http://127.0.0.1:8888". May include
+            token in the string, which is given by the process when starting up
+        tok : str
+            If the token is obtained separately, can be given here
+        kwargs
+        """
+        if "?" in url:
+            if tok is None:
+                try:
+                    tok = re.findall("token=([a-z0-9]+)", url)[0]
+                except IndexError as e:
+                    raise ValueError("Could not determine token") from e
+            url = url.split("?", 1)[0]
+        self.url = url.rstrip("/") + "/api/contents"
+        self.session = requests.Session()
+        if tok:
+            self.session.headers["Authorization"] = f"token {tok}"
+
+        super().__init__(**kwargs)
+
+    def ls(self, path, detail=True, **kwargs):
+        path = self._strip_protocol(path)
+        r = self.session.get(f"{self.url}/{path}")
+        if r.status_code == 404:
+            return FileNotFoundError(path)
+        r.raise_for_status()
+        out = r.json()
+
+        if out["type"] == "directory":
+            out = out["content"]
+        else:
+            out = [out]
+        for o in out:
+            o["name"] = o.pop("path")
+            o.pop("content")
+            if o["type"] == "notebook":
+                o["type"] = "file"
+        if detail:
+            return out
+        return [o["name"] for o in out]
+
+    def cat_file(self, path, start=None, end=None, **kwargs):
+        path = self._strip_protocol(path)
+        r = self.session.get(f"{self.url}/{path}")
+        if r.status_code == 404:
+            return FileNotFoundError(path)
+        r.raise_for_status()
+        out = r.json()
+        if out["format"] == "text":
+            # data should be binary
+            b = out["content"].encode()
+        else:
+            b = base64.b64decode(out["content"])
+        return b[start:end]
+
+    def pipe_file(self, path, value, **_):
+        path = self._strip_protocol(path)
+        json = {
+            "name": path.rsplit("/", 1)[-1],
+            "path": path,
+            "size": len(value),
+            "content": base64.b64encode(value).decode(),
+            "format": "base64",
+            "type": "file",
+        }
+        self.session.put(f"{self.url}/{path}", json=json)
+
+    def mkdir(self, path, create_parents=True, **kwargs):
+        path = self._strip_protocol(path)
+        if create_parents and "/" in path:
+            self.mkdir(path.rsplit("/", 1)[0], True)
+        json = {
+            "name": path.rsplit("/", 1)[-1],
+            "path": path,
+            "size": None,
+            "content": None,
+            "type": "directory",
+        }
+        self.session.put(f"{self.url}/{path}", json=json)
+
+    def _rm(self, path):
+        path = self._strip_protocol(path)
+        self.session.delete(f"{self.url}/{path}")
+
+    def _open(self, path, mode="rb", **kwargs):
+        path = self._strip_protocol(path)
+        if mode == "rb":
+            data = self.cat_file(path)
+            return io.BytesIO(data)
+        else:
+            return SimpleFileWriter(self, path, mode="wb")
+
+
+class SimpleFileWriter(fsspec.spec.AbstractBufferedFile):
+    def _upload_chunk(self, final=False):
+        """Never uploads a chunk until file is done
+
+        Not suitable for large files
+        """
+        if final is False:
+            return False
+        self.buffer.seek(0)
+        data = self.buffer.read()
+        self.fs.pipe_file(self.path, data)
diff --git a/llm/Lib/site-packages/fsspec/implementations/libarchive.py b/llm/Lib/site-packages/fsspec/implementations/libarchive.py
new file mode 100644
index 0000000000000000000000000000000000000000..eb6f145352e1989e0477e259be02d8d7f4d729e2
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/libarchive.py
@@ -0,0 +1,213 @@
+from contextlib import contextmanager
+from ctypes import (
+    CFUNCTYPE,
+    POINTER,
+    c_int,
+    c_longlong,
+    c_void_p,
+    cast,
+    create_string_buffer,
+)
+
+import libarchive
+import libarchive.ffi as ffi
+
+from fsspec import open_files
+from fsspec.archive import AbstractArchiveFileSystem
+from fsspec.implementations.memory import MemoryFile
+from fsspec.utils import DEFAULT_BLOCK_SIZE
+
+# Libarchive requires seekable files or memory only for certain archive
+# types. However, since we read the directory first to cache the contents
+# and also allow random access to any file, the file-like object needs
+# to be seekable no matter what.
+
+# Seek call-backs (not provided in the libarchive python wrapper)
+SEEK_CALLBACK = CFUNCTYPE(c_longlong, c_int, c_void_p, c_longlong, c_int)
+read_set_seek_callback = ffi.ffi(
+    "read_set_seek_callback", [ffi.c_archive_p, SEEK_CALLBACK], c_int, ffi.check_int
+)
+new_api = hasattr(ffi, "NO_OPEN_CB")
+
+
+@contextmanager
+def custom_reader(file, format_name="all", filter_name="all", block_size=ffi.page_size):
+    """Read an archive from a seekable file-like object.
+
+    The `file` object must support the standard `readinto` and 'seek' methods.
+    """
+    buf = create_string_buffer(block_size)
+    buf_p = cast(buf, c_void_p)
+
+    def read_func(archive_p, context, ptrptr):
+        # readinto the buffer, returns number of bytes read
+        length = file.readinto(buf)
+        # write the address of the buffer into the pointer
+        ptrptr = cast(ptrptr, POINTER(c_void_p))
+        ptrptr[0] = buf_p
+        # tell libarchive how much data was written into the buffer
+        return length
+
+    def seek_func(archive_p, context, offset, whence):
+        file.seek(offset, whence)
+        # tell libarchvie the current position
+        return file.tell()
+
+    read_cb = ffi.READ_CALLBACK(read_func)
+    seek_cb = SEEK_CALLBACK(seek_func)
+
+    if new_api:
+        open_cb = ffi.NO_OPEN_CB
+        close_cb = ffi.NO_CLOSE_CB
+    else:
+        open_cb = libarchive.read.OPEN_CALLBACK(ffi.VOID_CB)
+        close_cb = libarchive.read.CLOSE_CALLBACK(ffi.VOID_CB)
+
+    with libarchive.read.new_archive_read(format_name, filter_name) as archive_p:
+        read_set_seek_callback(archive_p, seek_cb)
+        ffi.read_open(archive_p, None, open_cb, read_cb, close_cb)
+        yield libarchive.read.ArchiveRead(archive_p)
+
+
+class LibArchiveFileSystem(AbstractArchiveFileSystem):
+    """Compressed archives as a file-system (read-only)
+
+    Supports the following formats:
+    tar, pax , cpio, ISO9660, zip, mtree, shar, ar, raw, xar, lha/lzh, rar
+    Microsoft CAB, 7-Zip, WARC
+
+    See the libarchive documentation for further restrictions.
+    https://www.libarchive.org/
+
+    Keeps file object open while instance lives. It only works in seekable
+    file-like objects. In case the filesystem does not support this kind of
+    file object, it is recommended to cache locally.
+
+    This class is pickleable, but not necessarily thread-safe (depends on the
+    platform). See libarchive documentation for details.
+    """
+
+    root_marker = ""
+    protocol = "libarchive"
+    cachable = False
+
+    def __init__(
+        self,
+        fo="",
+        mode="r",
+        target_protocol=None,
+        target_options=None,
+        block_size=DEFAULT_BLOCK_SIZE,
+        **kwargs,
+    ):
+        """
+        Parameters
+        ----------
+        fo: str or file-like
+            Contains ZIP, and must exist. If a str, will fetch file using
+            :meth:`~fsspec.open_files`, which must return one file exactly.
+        mode: str
+            Currently, only 'r' accepted
+        target_protocol: str (optional)
+            If ``fo`` is a string, this value can be used to override the
+            FS protocol inferred from a URL
+        target_options: dict (optional)
+            Kwargs passed when instantiating the target FS, if ``fo`` is
+            a string.
+        """
+        super().__init__(self, **kwargs)
+        if mode != "r":
+            raise ValueError("Only read from archive files accepted")
+        if isinstance(fo, str):
+            files = open_files(fo, protocol=target_protocol, **(target_options or {}))
+            if len(files) != 1:
+                raise ValueError(
+                    f'Path "{fo}" did not resolve to exactly one file: "{files}"'
+                )
+            fo = files[0]
+        self.of = fo
+        self.fo = fo.__enter__()  # the whole instance is a context
+        self.block_size = block_size
+        self.dir_cache = None
+
+    @contextmanager
+    def _open_archive(self):
+        self.fo.seek(0)
+        with custom_reader(self.fo, block_size=self.block_size) as arc:
+            yield arc
+
+    @classmethod
+    def _strip_protocol(cls, path):
+        # file paths are always relative to the archive root
+        return super()._strip_protocol(path).lstrip("/")
+
+    def _get_dirs(self):
+        fields = {
+            "name": "pathname",
+            "size": "size",
+            "created": "ctime",
+            "mode": "mode",
+            "uid": "uid",
+            "gid": "gid",
+            "mtime": "mtime",
+        }
+
+        if self.dir_cache is not None:
+            return
+
+        self.dir_cache = {}
+        list_names = []
+        with self._open_archive() as arc:
+            for entry in arc:
+                if not entry.isdir and not entry.isfile:
+                    # Skip symbolic links, fifo entries, etc.
+                    continue
+                self.dir_cache.update(
+                    {
+                        dirname: {"name": dirname, "size": 0, "type": "directory"}
+                        for dirname in self._all_dirnames(set(entry.name))
+                    }
+                )
+                f = {key: getattr(entry, fields[key]) for key in fields}
+                f["type"] = "directory" if entry.isdir else "file"
+                list_names.append(entry.name)
+
+                self.dir_cache[f["name"]] = f
+        # libarchive does not seem to return an entry for the directories (at least
+        # not in all formats), so get the directories names from the files names
+        self.dir_cache.update(
+            {
+                dirname: {"name": dirname, "size": 0, "type": "directory"}
+                for dirname in self._all_dirnames(list_names)
+            }
+        )
+
+    def _open(
+        self,
+        path,
+        mode="rb",
+        block_size=None,
+        autocommit=True,
+        cache_options=None,
+        **kwargs,
+    ):
+        path = self._strip_protocol(path)
+        if mode != "rb":
+            raise NotImplementedError
+
+        data = bytes()
+        with self._open_archive() as arc:
+            for entry in arc:
+                if entry.pathname != path:
+                    continue
+
+                if entry.size == 0:
+                    # empty file, so there are no blocks
+                    break
+
+                for block in entry.get_blocks(entry.size):
+                    data = block
+                    break
+                else:
+                    raise ValueError
+        return MemoryFile(fs=self, path=path, data=data)
diff --git a/llm/Lib/site-packages/fsspec/implementations/local.py b/llm/Lib/site-packages/fsspec/implementations/local.py
new file mode 100644
index 0000000000000000000000000000000000000000..9d2b335cfb55f6b6222d52ff69adfb969d2ca600
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/local.py
@@ -0,0 +1,434 @@
+import datetime
+import io
+import logging
+import os
+import os.path as osp
+import shutil
+import stat
+import tempfile
+
+from fsspec import AbstractFileSystem
+from fsspec.compression import compr
+from fsspec.core import get_compression
+from fsspec.utils import isfilelike, stringify_path
+
+logger = logging.getLogger("fsspec.local")
+
+
+def _remove_prefix(text: str, prefix: str):
+    if text.startswith(prefix):
+        return text[len(prefix) :]
+    return text
+
+
+class LocalFileSystem(AbstractFileSystem):
+    """Interface to files on local storage
+
+    Parameters
+    ----------
+    auto_mkdir: bool
+        Whether, when opening a file, the directory containing it should
+        be created (if it doesn't already exist). This is assumed by pyarrow
+        code.
+    """
+
+    root_marker = "/"
+    protocol = "file", "local"
+    local_file = True
+
+    def __init__(self, auto_mkdir=False, **kwargs):
+        super().__init__(**kwargs)
+        self.auto_mkdir = auto_mkdir
+
+    @property
+    def fsid(self):
+        return "local"
+
+    def mkdir(self, path, create_parents=True, **kwargs):
+        path = self._strip_protocol(path)
+        if self.exists(path):
+            raise FileExistsError(path)
+        if create_parents:
+            self.makedirs(path, exist_ok=True)
+        else:
+            os.mkdir(path, **kwargs)
+
+    def makedirs(self, path, exist_ok=False):
+        path = self._strip_protocol(path)
+        os.makedirs(path, exist_ok=exist_ok)
+
+    def rmdir(self, path):
+        path = self._strip_protocol(path)
+        os.rmdir(path)
+
+    def ls(self, path, detail=False, **kwargs):
+        path = self._strip_protocol(path)
+        info = self.info(path)
+        if info["type"] == "directory":
+            with os.scandir(path) as it:
+                infos = [self.info(f) for f in it]
+        else:
+            infos = [info]
+
+        if not detail:
+            return [i["name"] for i in infos]
+        return infos
+
+    def info(self, path, **kwargs):
+        if isinstance(path, os.DirEntry):
+            # scandir DirEntry
+            out = path.stat(follow_symlinks=False)
+            link = path.is_symlink()
+            if path.is_dir(follow_symlinks=False):
+                t = "directory"
+            elif path.is_file(follow_symlinks=False):
+                t = "file"
+            else:
+                t = "other"
+            path = self._strip_protocol(path.path)
+        else:
+            # str or path-like
+            path = self._strip_protocol(path)
+            out = os.stat(path, follow_symlinks=False)
+            link = stat.S_ISLNK(out.st_mode)
+            if link:
+                out = os.stat(path, follow_symlinks=True)
+            if stat.S_ISDIR(out.st_mode):
+                t = "directory"
+            elif stat.S_ISREG(out.st_mode):
+                t = "file"
+            else:
+                t = "other"
+        result = {
+            "name": path,
+            "size": out.st_size,
+            "type": t,
+            "created": out.st_ctime,
+            "islink": link,
+        }
+        for field in ["mode", "uid", "gid", "mtime", "ino", "nlink"]:
+            result[field] = getattr(out, f"st_{field}")
+        if result["islink"]:
+            result["destination"] = os.readlink(path)
+            try:
+                out2 = os.stat(path, follow_symlinks=True)
+                result["size"] = out2.st_size
+            except OSError:
+                result["size"] = 0
+        return result
+
+    def lexists(self, path, **kwargs):
+        return osp.lexists(path)
+
+    def cp_file(self, path1, path2, **kwargs):
+        path1 = self._strip_protocol(path1, remove_trailing_slash=True)
+        path2 = self._strip_protocol(path2, remove_trailing_slash=True)
+        if self.auto_mkdir:
+            self.makedirs(self._parent(path2), exist_ok=True)
+        if self.isfile(path1):
+            shutil.copyfile(path1, path2)
+        elif self.isdir(path1):
+            self.mkdirs(path2, exist_ok=True)
+        else:
+            raise FileNotFoundError(path1)
+
+    def isfile(self, path):
+        path = self._strip_protocol(path)
+        return os.path.isfile(path)
+
+    def isdir(self, path):
+        path = self._strip_protocol(path)
+        return os.path.isdir(path)
+
+    def get_file(self, path1, path2, callback=None, **kwargs):
+        if isfilelike(path2):
+            with open(path1, "rb") as f:
+                shutil.copyfileobj(f, path2)
+        else:
+            return self.cp_file(path1, path2, **kwargs)
+
+    def put_file(self, path1, path2, callback=None, **kwargs):
+        return self.cp_file(path1, path2, **kwargs)
+
+    def mv_file(self, path1, path2, **kwargs):
+        path1 = self._strip_protocol(path1, remove_trailing_slash=True)
+        path2 = self._strip_protocol(path2, remove_trailing_slash=True)
+        shutil.move(path1, path2)
+
+    def link(self, src, dst, **kwargs):
+        src = self._strip_protocol(src)
+        dst = self._strip_protocol(dst)
+        os.link(src, dst, **kwargs)
+
+    def symlink(self, src, dst, **kwargs):
+        src = self._strip_protocol(src)
+        dst = self._strip_protocol(dst)
+        os.symlink(src, dst, **kwargs)
+
+    def islink(self, path) -> bool:
+        return os.path.islink(self._strip_protocol(path))
+
+    def rm_file(self, path):
+        os.remove(self._strip_protocol(path))
+
+    def rm(self, path, recursive=False, maxdepth=None):
+        if not isinstance(path, list):
+            path = [path]
+
+        for p in path:
+            p = self._strip_protocol(p, remove_trailing_slash=True)
+            if self.isdir(p):
+                if not recursive:
+                    raise ValueError("Cannot delete directory, set recursive=True")
+                if osp.abspath(p) == os.getcwd():
+                    raise ValueError("Cannot delete current working directory")
+                shutil.rmtree(p)
+            else:
+                os.remove(p)
+
+    def unstrip_protocol(self, name):
+        name = self._strip_protocol(name)  # normalise for local/win/...
+        return f"file://{name}"
+
+    def _open(self, path, mode="rb", block_size=None, **kwargs):
+        path = self._strip_protocol(path)
+        if self.auto_mkdir and "w" in mode:
+            self.makedirs(self._parent(path), exist_ok=True)
+        return LocalFileOpener(path, mode, fs=self, **kwargs)
+
+    def touch(self, path, truncate=True, **kwargs):
+        path = self._strip_protocol(path)
+        if self.auto_mkdir:
+            self.makedirs(self._parent(path), exist_ok=True)
+        if self.exists(path):
+            os.utime(path, None)
+        else:
+            open(path, "a").close()
+        if truncate:
+            os.truncate(path, 0)
+
+    def created(self, path):
+        info = self.info(path=path)
+        return datetime.datetime.fromtimestamp(
+            info["created"], tz=datetime.timezone.utc
+        )
+
+    def modified(self, path):
+        info = self.info(path=path)
+        return datetime.datetime.fromtimestamp(info["mtime"], tz=datetime.timezone.utc)
+
+    @classmethod
+    def _parent(cls, path):
+        path = cls._strip_protocol(path, remove_trailing_slash=True)
+        if os.sep == "/":
+            # posix native
+            return path.rsplit("/", 1)[0] or "/"
+        else:
+            # NT
+            path_ = path.rsplit("/", 1)[0]
+            if len(path_) <= 3:
+                if path_[1:2] == ":":
+                    # nt root (something like c:/)
+                    return path_[0] + ":/"
+            # More cases may be required here
+            return path_
+
+    @classmethod
+    def _strip_protocol(cls, path, remove_trailing_slash=False):
+        path = stringify_path(path)
+        if path.startswith("file:"):
+            path = _remove_prefix(_remove_prefix(path, "file://"), "file:")
+            if os.sep == "\\":
+                path = path.lstrip("/")
+        elif path.startswith("local:"):
+            path = _remove_prefix(_remove_prefix(path, "local://"), "local:")
+            if os.sep == "\\":
+                path = path.lstrip("/")
+        return make_path_posix(path, remove_trailing_slash)
+
+    def _isfilestore(self):
+        # Inheriting from DaskFileSystem makes this False (S3, etc. were)
+        # the original motivation. But we are a posix-like file system.
+        # See https://github.com/dask/dask/issues/5526
+        return True
+
+    def chmod(self, path, mode):
+        path = stringify_path(path)
+        return os.chmod(path, mode)
+
+
+def make_path_posix(path, remove_trailing_slash=False):
+    """Make path generic for current OS"""
+    if not isinstance(path, str):
+        if isinstance(path, (list, set, tuple)):
+            return type(path)(make_path_posix(p, remove_trailing_slash) for p in path)
+        else:
+            path = str(stringify_path(path))
+    if os.sep == "/":
+        # Native posix
+        if path.startswith("/"):
+            # most common fast case for posix
+            return path.rstrip("/") or "/" if remove_trailing_slash else path
+        elif path.startswith("~"):
+            return make_path_posix(osp.expanduser(path), remove_trailing_slash)
+        elif path.startswith("./"):
+            path = path[2:]
+            path = f"{os.getcwd()}/{path}"
+            return path.rstrip("/") or "/" if remove_trailing_slash else path
+        return f"{os.getcwd()}/{path}"
+    else:
+        # NT handling
+        if len(path) > 1:
+            if path[1] == ":":
+                # windows full path like "C:\\local\\path"
+                if len(path) <= 3:
+                    # nt root (something like c:/)
+                    return path[0] + ":/"
+                path = path.replace("\\", "/").replace("//", "/")
+                return path.rstrip("/") if remove_trailing_slash else path
+            elif path[0] == "~":
+                return make_path_posix(osp.expanduser(path), remove_trailing_slash)
+            elif path.startswith(("\\\\", "//")):
+                # windows UNC/DFS-style paths
+                path = "//" + path[2:].replace("\\", "/").replace("//", "/")
+                return path.rstrip("/") if remove_trailing_slash else path
+        return make_path_posix(osp.abspath(path), remove_trailing_slash)
+
+
+def trailing_sep(path):
+    """Return True if the path ends with a path separator.
+
+    A forward slash is always considered a path separator, even on Operating
+    Systems that normally use a backslash.
+    """
+    # TODO: if all incoming paths were posix-compliant then separator would
+    # always be a forward slash, simplifying this function.
+    # See https://github.com/fsspec/filesystem_spec/pull/1250
+    return path.endswith(os.sep) or (os.altsep is not None and path.endswith(os.altsep))
+
+
+class LocalFileOpener(io.IOBase):
+    def __init__(
+        self, path, mode, autocommit=True, fs=None, compression=None, **kwargs
+    ):
+        logger.debug("open file: %s", path)
+        self.path = path
+        self.mode = mode
+        self.fs = fs
+        self.f = None
+        self.autocommit = autocommit
+        self.compression = get_compression(path, compression)
+        self.blocksize = io.DEFAULT_BUFFER_SIZE
+        self._open()
+
+    def _open(self):
+        if self.f is None or self.f.closed:
+            if self.autocommit or "w" not in self.mode:
+                self.f = open(self.path, mode=self.mode)
+                if self.compression:
+                    compress = compr[self.compression]
+                    self.f = compress(self.f, mode=self.mode)
+            else:
+                # TODO: check if path is writable?
+                i, name = tempfile.mkstemp()
+                os.close(i)  # we want normal open and normal buffered file
+                self.temp = name
+                self.f = open(name, mode=self.mode)
+            if "w" not in self.mode:
+                self.size = self.f.seek(0, 2)
+                self.f.seek(0)
+                self.f.size = self.size
+
+    def _fetch_range(self, start, end):
+        # probably only used by cached FS
+        if "r" not in self.mode:
+            raise ValueError
+        self._open()
+        self.f.seek(start)
+        return self.f.read(end - start)
+
+    def __setstate__(self, state):
+        self.f = None
+        loc = state.pop("loc", None)
+        self.__dict__.update(state)
+        if "r" in state["mode"]:
+            self.f = None
+            self._open()
+            self.f.seek(loc)
+
+    def __getstate__(self):
+        d = self.__dict__.copy()
+        d.pop("f")
+        if "r" in self.mode:
+            d["loc"] = self.f.tell()
+        else:
+            if not self.f.closed:
+                raise ValueError("Cannot serialise open write-mode local file")
+        return d
+
+    def commit(self):
+        if self.autocommit:
+            raise RuntimeError("Can only commit if not already set to autocommit")
+        shutil.move(self.temp, self.path)
+
+    def discard(self):
+        if self.autocommit:
+            raise RuntimeError("Cannot discard if set to autocommit")
+        os.remove(self.temp)
+
+    def readable(self) -> bool:
+        return True
+
+    def writable(self) -> bool:
+        return "r" not in self.mode
+
+    def read(self, *args, **kwargs):
+        return self.f.read(*args, **kwargs)
+
+    def write(self, *args, **kwargs):
+        return self.f.write(*args, **kwargs)
+
+    def tell(self, *args, **kwargs):
+        return self.f.tell(*args, **kwargs)
+
+    def seek(self, *args, **kwargs):
+        return self.f.seek(*args, **kwargs)
+
+    def seekable(self, *args, **kwargs):
+        return self.f.seekable(*args, **kwargs)
+
+    def readline(self, *args, **kwargs):
+        return self.f.readline(*args, **kwargs)
+
+    def readlines(self, *args, **kwargs):
+        return self.f.readlines(*args, **kwargs)
+
+    def close(self):
+        return self.f.close()
+
+    def truncate(self, size=None) -> int:
+        return self.f.truncate(size)
+
+    @property
+    def closed(self):
+        return self.f.closed
+
+    def fileno(self):
+        return self.raw.fileno()
+
+    def flush(self) -> None:
+        self.f.flush()
+
+    def __iter__(self):
+        return self.f.__iter__()
+
+    def __getattr__(self, item):
+        return getattr(self.f, item)
+
+    def __enter__(self):
+        self._incontext = True
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        self._incontext = False
+        self.f.__exit__(exc_type, exc_value, traceback)
diff --git a/llm/Lib/site-packages/fsspec/implementations/memory.py b/llm/Lib/site-packages/fsspec/implementations/memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..394fa9770f99dd6a5f798f8817380e071c5fa967
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/memory.py
@@ -0,0 +1,294 @@
+from __future__ import annotations
+
+import logging
+from datetime import datetime, timezone
+from errno import ENOTEMPTY
+from io import BytesIO
+from typing import Any, ClassVar
+
+from fsspec import AbstractFileSystem
+
+logger = logging.getLogger("fsspec.memoryfs")
+
+
+class MemoryFileSystem(AbstractFileSystem):
+    """A filesystem based on a dict of BytesIO objects
+
+    This is a global filesystem so instances of this class all point to the same
+    in memory filesystem.
+    """
+
+    store: ClassVar[dict[str, Any]] = {}  # global, do not overwrite!
+    pseudo_dirs = [""]  # global, do not overwrite!
+    protocol = "memory"
+    root_marker = "/"
+
+    @classmethod
+    def _strip_protocol(cls, path):
+        if path.startswith("memory://"):
+            path = path[len("memory://") :]
+        if "::" in path or "://" in path:
+            return path.rstrip("/")
+        path = path.lstrip("/").rstrip("/")
+        return "/" + path if path else ""
+
+    def ls(self, path, detail=True, **kwargs):
+        path = self._strip_protocol(path)
+        if path in self.store:
+            # there is a key with this exact name
+            if not detail:
+                return [path]
+            return [
+                {
+                    "name": path,
+                    "size": self.store[path].size,
+                    "type": "file",
+                    "created": self.store[path].created.timestamp(),
+                }
+            ]
+        paths = set()
+        starter = path + "/"
+        out = []
+        for p2 in tuple(self.store):
+            if p2.startswith(starter):
+                if "/" not in p2[len(starter) :]:
+                    # exact child
+                    out.append(
+                        {
+                            "name": p2,
+                            "size": self.store[p2].size,
+                            "type": "file",
+                            "created": self.store[p2].created.timestamp(),
+                        }
+                    )
+                elif len(p2) > len(starter):
+                    # implied child directory
+                    ppath = starter + p2[len(starter) :].split("/", 1)[0]
+                    if ppath not in paths:
+                        out = out or []
+                        out.append(
+                            {
+                                "name": ppath,
+                                "size": 0,
+                                "type": "directory",
+                            }
+                        )
+                        paths.add(ppath)
+        for p2 in self.pseudo_dirs:
+            if p2.startswith(starter):
+                if "/" not in p2[len(starter) :]:
+                    # exact child pdir
+                    if p2 not in paths:
+                        out.append({"name": p2, "size": 0, "type": "directory"})
+                        paths.add(p2)
+                else:
+                    # directory implied by deeper pdir
+                    ppath = starter + p2[len(starter) :].split("/", 1)[0]
+                    if ppath not in paths:
+                        out.append({"name": ppath, "size": 0, "type": "directory"})
+                        paths.add(ppath)
+        if not out:
+            if path in self.pseudo_dirs:
+                # empty dir
+                return []
+            raise FileNotFoundError(path)
+        if detail:
+            return out
+        return sorted([f["name"] for f in out])
+
+    def mkdir(self, path, create_parents=True, **kwargs):
+        path = self._strip_protocol(path)
+        if path in self.store or path in self.pseudo_dirs:
+            raise FileExistsError(path)
+        if self._parent(path).strip("/") and self.isfile(self._parent(path)):
+            raise NotADirectoryError(self._parent(path))
+        if create_parents and self._parent(path).strip("/"):
+            try:
+                self.mkdir(self._parent(path), create_parents, **kwargs)
+            except FileExistsError:
+                pass
+        if path and path not in self.pseudo_dirs:
+            self.pseudo_dirs.append(path)
+
+    def makedirs(self, path, exist_ok=False):
+        try:
+            self.mkdir(path, create_parents=True)
+        except FileExistsError:
+            if not exist_ok:
+                raise
+
+    def pipe_file(self, path, value, **kwargs):
+        """Set the bytes of given file
+
+        Avoids copies of the data if possible
+        """
+        self.open(path, "wb", data=value)
+
+    def rmdir(self, path):
+        path = self._strip_protocol(path)
+        if path == "":
+            # silently avoid deleting FS root
+            return
+        if path in self.pseudo_dirs:
+            if not self.ls(path):
+                self.pseudo_dirs.remove(path)
+            else:
+                raise OSError(ENOTEMPTY, "Directory not empty", path)
+        else:
+            raise FileNotFoundError(path)
+
+    def info(self, path, **kwargs):
+        logger.debug("info: %s", path)
+        path = self._strip_protocol(path)
+        if path in self.pseudo_dirs or any(
+            p.startswith(path + "/") for p in list(self.store) + self.pseudo_dirs
+        ):
+            return {
+                "name": path,
+                "size": 0,
+                "type": "directory",
+            }
+        elif path in self.store:
+            filelike = self.store[path]
+            return {
+                "name": path,
+                "size": filelike.size,
+                "type": "file",
+                "created": getattr(filelike, "created", None),
+            }
+        else:
+            raise FileNotFoundError(path)
+
+    def _open(
+        self,
+        path,
+        mode="rb",
+        block_size=None,
+        autocommit=True,
+        cache_options=None,
+        **kwargs,
+    ):
+        path = self._strip_protocol(path)
+        if path in self.pseudo_dirs:
+            raise IsADirectoryError(path)
+        parent = path
+        while len(parent) > 1:
+            parent = self._parent(parent)
+            if self.isfile(parent):
+                raise FileExistsError(parent)
+        if mode in ["rb", "ab", "r+b"]:
+            if path in self.store:
+                f = self.store[path]
+                if mode == "ab":
+                    # position at the end of file
+                    f.seek(0, 2)
+                else:
+                    # position at the beginning of file
+                    f.seek(0)
+                return f
+            else:
+                raise FileNotFoundError(path)
+        elif mode == "wb":
+            m = MemoryFile(self, path, kwargs.get("data"))
+            if not self._intrans:
+                m.commit()
+            return m
+        else:
+            name = self.__class__.__name__
+            raise ValueError(f"unsupported file mode for {name}: {mode!r}")
+
+    def cp_file(self, path1, path2, **kwargs):
+        path1 = self._strip_protocol(path1)
+        path2 = self._strip_protocol(path2)
+        if self.isfile(path1):
+            self.store[path2] = MemoryFile(
+                self, path2, self.store[path1].getvalue()
+            )  # implicit copy
+        elif self.isdir(path1):
+            if path2 not in self.pseudo_dirs:
+                self.pseudo_dirs.append(path2)
+        else:
+            raise FileNotFoundError(path1)
+
+    def cat_file(self, path, start=None, end=None, **kwargs):
+        logger.debug("cat: %s", path)
+        path = self._strip_protocol(path)
+        try:
+            return bytes(self.store[path].getbuffer()[start:end])
+        except KeyError:
+            raise FileNotFoundError(path)
+
+    def _rm(self, path):
+        path = self._strip_protocol(path)
+        try:
+            del self.store[path]
+        except KeyError as e:
+            raise FileNotFoundError(path) from e
+
+    def modified(self, path):
+        path = self._strip_protocol(path)
+        try:
+            return self.store[path].modified
+        except KeyError:
+            raise FileNotFoundError(path)
+
+    def created(self, path):
+        path = self._strip_protocol(path)
+        try:
+            return self.store[path].created
+        except KeyError:
+            raise FileNotFoundError(path)
+
+    def rm(self, path, recursive=False, maxdepth=None):
+        if isinstance(path, str):
+            path = self._strip_protocol(path)
+        else:
+            path = [self._strip_protocol(p) for p in path]
+        paths = self.expand_path(path, recursive=recursive, maxdepth=maxdepth)
+        for p in reversed(paths):
+            # If the expanded path doesn't exist, it is only because the expanded
+            # path was a directory that does not exist in self.pseudo_dirs. This
+            # is possible if you directly create files without making the
+            # directories first.
+            if not self.exists(p):
+                continue
+            if self.isfile(p):
+                self.rm_file(p)
+            else:
+                self.rmdir(p)
+
+
+class MemoryFile(BytesIO):
+    """A BytesIO which can't close and works as a context manager
+
+    Can initialise with data. Each path should only be active once at any moment.
+
+    No need to provide fs, path if auto-committing (default)
+    """
+
+    def __init__(self, fs=None, path=None, data=None):
+        logger.debug("open file %s", path)
+        self.fs = fs
+        self.path = path
+        self.created = datetime.now(tz=timezone.utc)
+        self.modified = datetime.now(tz=timezone.utc)
+        if data:
+            super().__init__(data)
+            self.seek(0)
+
+    @property
+    def size(self):
+        return self.getbuffer().nbytes
+
+    def __enter__(self):
+        return self
+
+    def close(self):
+        pass
+
+    def discard(self):
+        pass
+
+    def commit(self):
+        self.fs.store[self.path] = self
+        self.modified = datetime.now(tz=timezone.utc)
diff --git a/llm/Lib/site-packages/fsspec/implementations/reference.py b/llm/Lib/site-packages/fsspec/implementations/reference.py
new file mode 100644
index 0000000000000000000000000000000000000000..e202c96d6bcb000144710115156c1c4c78935bc7
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/reference.py
@@ -0,0 +1,1160 @@
+import base64
+import collections
+import io
+import itertools
+import logging
+import math
+import os
+from functools import lru_cache
+from typing import TYPE_CHECKING
+
+import fsspec.core
+
+try:
+    import ujson as json
+except ImportError:
+    if not TYPE_CHECKING:
+        import json
+
+from ..asyn import AsyncFileSystem
+from ..callbacks import DEFAULT_CALLBACK
+from ..core import filesystem, open, split_protocol
+from ..utils import isfilelike, merge_offset_ranges, other_paths
+
+logger = logging.getLogger("fsspec.reference")
+
+
+class ReferenceNotReachable(RuntimeError):
+    def __init__(self, reference, target, *args):
+        super().__init__(*args)
+        self.reference = reference
+        self.target = target
+
+    def __str__(self):
+        return f'Reference "{self.reference}" failed to fetch target {self.target}'
+
+
+def _first(d):
+    return list(d.values())[0]
+
+
+def _prot_in_references(path, references):
+    ref = references.get(path)
+    if isinstance(ref, (list, tuple)):
+        return split_protocol(ref[0])[0] if ref[0] else ref[0]
+
+
+def _protocol_groups(paths, references):
+    if isinstance(paths, str):
+        return {_prot_in_references(paths, references): [paths]}
+    out = {}
+    for path in paths:
+        protocol = _prot_in_references(path, references)
+        out.setdefault(protocol, []).append(path)
+    return out
+
+
+class RefsValuesView(collections.abc.ValuesView):
+    def __iter__(self):
+        for val in self._mapping.zmetadata.values():
+            yield json.dumps(val).encode()
+        yield from self._mapping._items.values()
+        for field in self._mapping.listdir():
+            chunk_sizes = self._mapping._get_chunk_sizes(field)
+            if len(chunk_sizes) == 0:
+                yield self._mapping[field + "/0"]
+                continue
+            yield from self._mapping._generate_all_records(field)
+
+
+class RefsItemsView(collections.abc.ItemsView):
+    def __iter__(self):
+        return zip(self._mapping.keys(), self._mapping.values())
+
+
+def ravel_multi_index(idx, sizes):
+    val = 0
+    mult = 1
+    for i, s in zip(idx[::-1], sizes[::-1]):
+        val += i * mult
+        mult *= s
+    return val
+
+
+class LazyReferenceMapper(collections.abc.MutableMapping):
+    """This interface can be used to read/write references from Parquet stores.
+    It is not intended for other types of references.
+    It can be used with Kerchunk's MultiZarrToZarr method to combine
+    references into a parquet store.
+    Examples of this use-case can be found here:
+    https://fsspec.github.io/kerchunk/advanced.html?highlight=parquet#parquet-storage"""
+
+    # import is class level to prevent numpy dep requirement for fsspec
+    @property
+    def np(self):
+        import numpy as np
+
+        return np
+
+    @property
+    def pd(self):
+        import pandas as pd
+
+        return pd
+
+    def __init__(
+        self, root, fs=None, out_root=None, cache_size=128, categorical_threshold=10
+    ):
+        """
+
+        This instance will be writable, storing changes in memory until full partitions
+        are accumulated or .flush() is called.
+
+        To create an empty lazy store, use .create()
+
+        Parameters
+        ----------
+        root : str
+            Root of parquet store
+        fs : fsspec.AbstractFileSystem
+            fsspec filesystem object, default is local filesystem.
+        cache_size : int, default=128
+            Maximum size of LRU cache, where cache_size*record_size denotes
+            the total number of references that can be loaded in memory at once.
+        categorical_threshold : int
+            Encode urls as pandas.Categorical to reduce memory footprint if the ratio
+            of the number of unique urls to total number of refs for each variable
+            is greater than or equal to this number. (default 10)
+        """
+        self.root = root
+        self.chunk_sizes = {}
+        self.out_root = out_root or self.root
+        self.cat_thresh = categorical_threshold
+        self.cache_size = cache_size
+        self.dirs = None
+        self.url = self.root + "/{field}/refs.{record}.parq"
+        # TODO: derive fs from `root`
+        self.fs = fsspec.filesystem("file") if fs is None else fs
+
+    def __getattr__(self, item):
+        if item in ("_items", "record_size", "zmetadata"):
+            self.setup()
+            # avoid possible recursion if setup fails somehow
+            return self.__dict__[item]
+        raise AttributeError(item)
+
+    def setup(self):
+        self._items = {}
+        self._items[".zmetadata"] = self.fs.cat_file(
+            "/".join([self.root, ".zmetadata"])
+        )
+        met = json.loads(self._items[".zmetadata"])
+        self.record_size = met["record_size"]
+        self.zmetadata = met["metadata"]
+
+        # Define function to open and decompress refs
+        @lru_cache(maxsize=self.cache_size)
+        def open_refs(field, record):
+            """cached parquet file loader"""
+            path = self.url.format(field=field, record=record)
+            data = io.BytesIO(self.fs.cat_file(path))
+            df = self.pd.read_parquet(data, engine="fastparquet")
+            refs = {c: df[c].values for c in df.columns}
+            return refs
+
+        self.open_refs = open_refs
+
+    @staticmethod
+    def create(root, storage_options=None, fs=None, record_size=10000, **kwargs):
+        """Make empty parquet reference set
+
+        First deletes the contents of the given directory, if it exists.
+
+        Parameters
+        ----------
+        root: str
+            Directory to contain the output; will be created
+        storage_options: dict | None
+            For making the filesystem to use for writing is fs is None
+        fs: FileSystem | None
+            Filesystem for writing
+        record_size: int
+            Number of references per parquet file
+        kwargs: passed to __init__
+
+        Returns
+        -------
+        LazyReferenceMapper instance
+        """
+        met = {"metadata": {}, "record_size": record_size}
+        if fs is None:
+            fs, root = fsspec.core.url_to_fs(root, **(storage_options or {}))
+        if fs.exists(root):
+            fs.rm(root, recursive=True)
+        fs.makedirs(root, exist_ok=True)
+        fs.pipe("/".join([root, ".zmetadata"]), json.dumps(met).encode())
+        return LazyReferenceMapper(root, fs, **kwargs)
+
+    def listdir(self, basename=True):
+        """List top-level directories"""
+        # cache me?
+        if self.dirs is None:
+            dirs = [p.split("/", 1)[0] for p in self.zmetadata]
+            self.dirs = {p for p in dirs if p and not p.startswith(".")}
+        listing = self.dirs
+        if basename:
+            listing = [os.path.basename(path) for path in listing]
+        return listing
+
+    def ls(self, path="", detail=True):
+        """Shortcut file listings"""
+        if not path:
+            dirnames = self.listdir()
+            others = set(
+                [".zmetadata"]
+                + [name for name in self.zmetadata if "/" not in name]
+                + [name for name in self._items if "/" not in name]
+            )
+            if detail is False:
+                others.update(dirnames)
+                return sorted(others)
+            dirinfo = [
+                {"name": name, "type": "directory", "size": 0} for name in dirnames
+            ]
+            fileinfo = [
+                {
+                    "name": name,
+                    "type": "file",
+                    "size": len(
+                        json.dumps(self.zmetadata[name])
+                        if name in self.zmetadata
+                        else self._items[name]
+                    ),
+                }
+                for name in others
+            ]
+            return sorted(dirinfo + fileinfo, key=lambda s: s["name"])
+        parts = path.split("/", 1)
+        if len(parts) > 1:
+            raise FileNotFoundError("Cannot list within directories right now")
+        field = parts[0]
+        others = set(
+            [name for name in self.zmetadata if name.startswith(f"{path}/")]
+            + [name for name in self._items if name.startswith(f"{path}/")]
+        )
+        fileinfo = [
+            {
+                "name": name,
+                "type": "file",
+                "size": len(
+                    json.dumps(self.zmetadata[name])
+                    if name in self.zmetadata
+                    else self._items[name]
+                ),
+            }
+            for name in others
+        ]
+        keys = self._keys_in_field(field)
+
+        if detail is False:
+            return list(others) + list(keys)
+        recs = self._generate_all_records(field)
+        recinfo = [
+            {"name": name, "type": "file", "size": rec[-1]}
+            for name, rec in zip(keys, recs)
+            if rec[0]  # filters out path==None, deleted/missing
+        ]
+        return fileinfo + recinfo
+
+    def _load_one_key(self, key):
+        """Get the reference for one key
+
+        Returns bytes, one-element list or three-element list.
+        """
+        if key in self._items:
+            return self._items[key]
+        elif key in self.zmetadata:
+            return json.dumps(self.zmetadata[key]).encode()
+        elif "/" not in key or self._is_meta(key):
+            raise KeyError(key)
+        field, _ = key.rsplit("/", 1)
+        record, ri, chunk_size = self._key_to_record(key)
+        maybe = self._items.get((field, record), {}).get(ri, False)
+        if maybe is None:
+            # explicitly deleted
+            raise KeyError
+        elif maybe:
+            return maybe
+        elif chunk_size == 0:
+            return b""
+
+        # Chunk keys can be loaded from row group and cached in LRU cache
+        try:
+            refs = self.open_refs(field, record)
+        except (ValueError, TypeError, FileNotFoundError):
+            raise KeyError(key)
+        columns = ["path", "offset", "size", "raw"]
+        selection = [refs[c][ri] if c in refs else None for c in columns]
+        raw = selection[-1]
+        if raw is not None:
+            return raw
+        if selection[0] is None:
+            raise KeyError("This reference does not exist or has been deleted")
+        if selection[1:3] == [0, 0]:
+            # URL only
+            return selection[:1]
+        # URL, offset, size
+        return selection[:3]
+
+    @lru_cache(4096)
+    def _key_to_record(self, key):
+        """Details needed to construct a reference for one key"""
+        field, chunk = key.rsplit("/", 1)
+        chunk_sizes = self._get_chunk_sizes(field)
+        if len(chunk_sizes) == 0:
+            return 0, 0, 0
+        chunk_idx = [int(c) for c in chunk.split(".")]
+        chunk_number = ravel_multi_index(chunk_idx, chunk_sizes)
+        record = chunk_number // self.record_size
+        ri = chunk_number % self.record_size
+        return record, ri, len(chunk_sizes)
+
+    def _get_chunk_sizes(self, field):
+        """The number of chunks along each axis for a given field"""
+        if field not in self.chunk_sizes:
+            zarray = self.zmetadata[f"{field}/.zarray"]
+            size_ratio = [
+                math.ceil(s / c) for s, c in zip(zarray["shape"], zarray["chunks"])
+            ]
+            self.chunk_sizes[field] = size_ratio or [1]
+        return self.chunk_sizes[field]
+
+    def _generate_record(self, field, record):
+        """The references for a given parquet file of a given field"""
+        refs = self.open_refs(field, record)
+        it = iter(zip(*refs.values()))
+        if len(refs) == 3:
+            # All urls
+            return (list(t) for t in it)
+        elif len(refs) == 1:
+            # All raws
+            return refs["raw"]
+        else:
+            # Mix of urls and raws
+            return (list(t[:3]) if not t[3] else t[3] for t in it)
+
+    def _generate_all_records(self, field):
+        """Load all the references within a field by iterating over the parquet files"""
+        nrec = 1
+        for ch in self._get_chunk_sizes(field):
+            nrec *= ch
+        nrec = math.ceil(nrec / self.record_size)
+        for record in range(nrec):
+            yield from self._generate_record(field, record)
+
+    def values(self):
+        return RefsValuesView(self)
+
+    def items(self):
+        return RefsItemsView(self)
+
+    def __hash__(self):
+        return id(self)
+
+    def __getitem__(self, key):
+        return self._load_one_key(key)
+
+    def __setitem__(self, key, value):
+        if "/" in key and not self._is_meta(key):
+            field, chunk = key.rsplit("/", 1)
+            record, i, _ = self._key_to_record(key)
+            subdict = self._items.setdefault((field, record), {})
+            subdict[i] = value
+            if len(subdict) == self.record_size:
+                self.write(field, record)
+        else:
+            # metadata or top-level
+            self._items[key] = value
+            new_value = json.loads(
+                value.decode() if isinstance(value, bytes) else value
+            )
+            self.zmetadata[key] = {**self.zmetadata.get(key, {}), **new_value}
+
+    @staticmethod
+    def _is_meta(key):
+        return key.startswith(".z") or "/.z" in key
+
+    def __delitem__(self, key):
+        if key in self._items:
+            del self._items[key]
+        elif key in self.zmetadata:
+            del self.zmetadata[key]
+        else:
+            if "/" in key and not self._is_meta(key):
+                field, _ = key.rsplit("/", 1)
+                record, i, _ = self._key_to_record(key)
+                subdict = self._items.setdefault((field, record), {})
+                subdict[i] = None
+                if len(subdict) == self.record_size:
+                    self.write(field, record)
+            else:
+                # metadata or top-level
+                self._items[key] = None
+
+    def write(self, field, record, base_url=None, storage_options=None):
+        # extra requirements if writing
+        import kerchunk.df
+        import numpy as np
+        import pandas as pd
+
+        partition = self._items[(field, record)]
+        original = False
+        if len(partition) < self.record_size:
+            try:
+                original = self.open_refs(field, record)
+            except IOError:
+                pass
+
+        if original:
+            paths = original["path"]
+            offsets = original["offset"]
+            sizes = original["size"]
+            raws = original["raw"]
+        else:
+            paths = np.full(self.record_size, np.nan, dtype="O")
+            offsets = np.zeros(self.record_size, dtype="int64")
+            sizes = np.zeros(self.record_size, dtype="int64")
+            raws = np.full(self.record_size, np.nan, dtype="O")
+        for j, data in partition.items():
+            if isinstance(data, list):
+                if (
+                    str(paths.dtype) == "category"
+                    and data[0] not in paths.dtype.categories
+                ):
+                    paths = paths.add_categories(data[0])
+                paths[j] = data[0]
+                if len(data) > 1:
+                    offsets[j] = data[1]
+                    sizes[j] = data[2]
+            elif data is None:
+                # delete
+                paths[j] = None
+                offsets[j] = 0
+                sizes[j] = 0
+                raws[j] = None
+            else:
+                # this is the only call into kerchunk, could remove
+                raws[j] = kerchunk.df._proc_raw(data)
+        # TODO: only save needed columns
+        df = pd.DataFrame(
+            {
+                "path": paths,
+                "offset": offsets,
+                "size": sizes,
+                "raw": raws,
+            },
+            copy=False,
+        )
+        if df.path.count() / (df.path.nunique() or 1) > self.cat_thresh:
+            df["path"] = df["path"].astype("category")
+        object_encoding = {"raw": "bytes", "path": "utf8"}
+        has_nulls = ["path", "raw"]
+
+        fn = f"{base_url or self.out_root}/{field}/refs.{record}.parq"
+        self.fs.mkdirs(f"{base_url or self.out_root}/{field}", exist_ok=True)
+        df.to_parquet(
+            fn,
+            engine="fastparquet",
+            storage_options=storage_options
+            or getattr(self.fs, "storage_options", None),
+            compression="zstd",
+            index=False,
+            stats=False,
+            object_encoding=object_encoding,
+            has_nulls=has_nulls,
+            # **kwargs,
+        )
+        partition.clear()
+        self._items.pop((field, record))
+
+    def flush(self, base_url=None, storage_options=None):
+        """Output any modified or deleted keys
+
+        Parameters
+        ----------
+        base_url: str
+            Location of the output
+        """
+        # write what we have so far and clear sub chunks
+        for thing in list(self._items):
+            if isinstance(thing, tuple):
+                field, record = thing
+                self.write(
+                    field,
+                    record,
+                    base_url=base_url,
+                    storage_options=storage_options,
+                )
+
+        # gather .zmetadata from self._items and write that too
+        for k in list(self._items):
+            if k != ".zmetadata" and ".z" in k:
+                self.zmetadata[k] = json.loads(self._items.pop(k))
+        met = {"metadata": self.zmetadata, "record_size": self.record_size}
+        self._items[".zmetadata"] = json.dumps(met).encode()
+        self.fs.pipe(
+            "/".join([base_url or self.out_root, ".zmetadata"]),
+            self._items[".zmetadata"],
+        )
+
+        # TODO: only clear those that we wrote to?
+        self.open_refs.cache_clear()
+
+    def __len__(self):
+        # Caveat: This counts expected references, not actual - but is fast
+        count = 0
+        for field in self.listdir():
+            if field.startswith("."):
+                count += 1
+            else:
+                count += math.prod(self._get_chunk_sizes(field))
+        count += len(self.zmetadata)  # all metadata keys
+        # any other files not in reference partitions
+        count += sum(1 for _ in self._items if not isinstance(_, tuple))
+        return count
+
+    def __iter__(self):
+        # Caveat: returns only existing keys, so the number of these does not
+        #  match len(self)
+        metas = set(self.zmetadata)
+        metas.update(self._items)
+        for bit in metas:
+            if isinstance(bit, str):
+                yield bit
+        for field in self.listdir():
+            for k in self._keys_in_field(field):
+                if k in self:
+                    yield k
+
+    def __contains__(self, item):
+        try:
+            self._load_one_key(item)
+            return True
+        except KeyError:
+            return False
+
+    def _keys_in_field(self, field):
+        """List key names in given field
+
+        Produces strings like "field/x.y" appropriate from the chunking of the array
+        """
+        chunk_sizes = self._get_chunk_sizes(field)
+        if len(chunk_sizes) == 0:
+            yield field + "/0"
+            return
+        inds = itertools.product(*(range(i) for i in chunk_sizes))
+        for ind in inds:
+            yield field + "/" + ".".join([str(c) for c in ind])
+
+
+class ReferenceFileSystem(AsyncFileSystem):
+    """View byte ranges of some other file as a file system
+    Initial version: single file system target, which must support
+    async, and must allow start and end args in _cat_file. Later versions
+    may allow multiple arbitrary URLs for the targets.
+    This FileSystem is read-only. It is designed to be used with async
+    targets (for now). This FileSystem only allows whole-file access, no
+    ``open``. We do not get original file details from the target FS.
+    Configuration is by passing a dict of references at init, or a URL to
+    a JSON file containing the same; this dict
+    can also contain concrete data for some set of paths.
+    Reference dict format:
+    {path0: bytes_data, path1: (target_url, offset, size)}
+    https://github.com/fsspec/kerchunk/blob/main/README.md
+    """
+
+    protocol = "reference"
+
+    def __init__(
+        self,
+        fo,
+        target=None,
+        ref_storage_args=None,
+        target_protocol=None,
+        target_options=None,
+        remote_protocol=None,
+        remote_options=None,
+        fs=None,
+        template_overrides=None,
+        simple_templates=True,
+        max_gap=64_000,
+        max_block=256_000_000,
+        cache_size=128,
+        **kwargs,
+    ):
+        """
+        Parameters
+        ----------
+        fo : dict or str
+            The set of references to use for this instance, with a structure as above.
+            If str referencing a JSON file, will use fsspec.open, in conjunction
+            with target_options and target_protocol to open and parse JSON at this
+            location. If a directory, then assume references are a set of parquet
+            files to be loaded lazily.
+        target : str
+            For any references having target_url as None, this is the default file
+            target to use
+        ref_storage_args : dict
+            If references is a str, use these kwargs for loading the JSON file.
+            Deprecated: use target_options instead.
+        target_protocol : str
+            Used for loading the reference file, if it is a path. If None, protocol
+            will be derived from the given path
+        target_options : dict
+            Extra FS options for loading the reference file ``fo``, if given as a path
+        remote_protocol : str
+            The protocol of the filesystem on which the references will be evaluated
+            (unless fs is provided). If not given, will be derived from the first
+            URL that has a protocol in the templates or in the references, in that
+            order.
+        remote_options : dict
+            kwargs to go with remote_protocol
+        fs : AbstractFileSystem | dict(str, (AbstractFileSystem | dict))
+            Directly provide a file system(s):
+                - a single filesystem instance
+                - a dict of protocol:filesystem, where each value is either a filesystem
+                  instance, or a dict of kwargs that can be used to create in
+                  instance for the given protocol
+
+            If this is given, remote_options and remote_protocol are ignored.
+        template_overrides : dict
+            Swap out any templates in the references file with these - useful for
+            testing.
+        simple_templates: bool
+            Whether templates can be processed with simple replace (True) or if
+            jinja  is needed (False, much slower). All reference sets produced by
+            ``kerchunk`` are simple in this sense, but the spec allows for complex.
+        max_gap, max_block: int
+            For merging multiple concurrent requests to the same remote file.
+            Neighboring byte ranges will only be merged when their
+            inter-range gap is <= ``max_gap``. Default is 64KB. Set to 0
+            to only merge when it requires no extra bytes. Pass a negative
+            number to disable merging, appropriate for local target files.
+            Neighboring byte ranges will only be merged when the size of
+            the aggregated range is <= ``max_block``. Default is 256MB.
+        cache_size : int
+            Maximum size of LRU cache, where cache_size*record_size denotes
+            the total number of references that can be loaded in memory at once.
+            Only used for lazily loaded references.
+        kwargs : passed to parent class
+        """
+        super().__init__(**kwargs)
+        self.target = target
+        self.template_overrides = template_overrides
+        self.simple_templates = simple_templates
+        self.templates = {}
+        self.fss = {}
+        self._dircache = {}
+        self.max_gap = max_gap
+        self.max_block = max_block
+        if isinstance(fo, str):
+            dic = dict(
+                **(ref_storage_args or target_options or {}), protocol=target_protocol
+            )
+            ref_fs, fo2 = fsspec.core.url_to_fs(fo, **dic)
+            if ref_fs.isfile(fo2):
+                # text JSON
+                with fsspec.open(fo, "rb", **dic) as f:
+                    logger.info("Read reference from URL %s", fo)
+                    text = json.load(f)
+                self._process_references(text, template_overrides)
+            else:
+                # Lazy parquet refs
+                logger.info("Open lazy reference dict from URL %s", fo)
+                self.references = LazyReferenceMapper(
+                    fo2,
+                    fs=ref_fs,
+                    cache_size=cache_size,
+                )
+        else:
+            # dictionaries
+            self._process_references(fo, template_overrides)
+        if isinstance(fs, dict):
+            self.fss = {
+                k: (
+                    fsspec.filesystem(k.split(":", 1)[0], **opts)
+                    if isinstance(opts, dict)
+                    else opts
+                )
+                for k, opts in fs.items()
+            }
+            if None not in self.fss:
+                self.fss[None] = filesystem("file")
+            return
+        if fs is not None:
+            # single remote FS
+            remote_protocol = (
+                fs.protocol[0] if isinstance(fs.protocol, tuple) else fs.protocol
+            )
+            self.fss[remote_protocol] = fs
+
+        if remote_protocol is None:
+            # get single protocol from any templates
+            for ref in self.templates.values():
+                if callable(ref):
+                    ref = ref()
+                protocol, _ = fsspec.core.split_protocol(ref)
+                if protocol and protocol not in self.fss:
+                    fs = filesystem(protocol, **(remote_options or {}))
+                    self.fss[protocol] = fs
+        if remote_protocol is None:
+            # get single protocol from references
+            # TODO: warning here, since this can be very expensive?
+            for ref in self.references.values():
+                if callable(ref):
+                    ref = ref()
+                if isinstance(ref, list) and ref[0]:
+                    protocol, _ = fsspec.core.split_protocol(ref[0])
+                    if protocol not in self.fss:
+                        fs = filesystem(protocol, **(remote_options or {}))
+                        self.fss[protocol] = fs
+                        # only use first remote URL
+                        break
+
+        if remote_protocol and remote_protocol not in self.fss:
+            fs = filesystem(remote_protocol, **(remote_options or {}))
+            self.fss[remote_protocol] = fs
+
+        self.fss[None] = fs or filesystem("file")  # default one
+
+    def _cat_common(self, path, start=None, end=None):
+        path = self._strip_protocol(path)
+        logger.debug(f"cat: {path}")
+        try:
+            part = self.references[path]
+        except KeyError:
+            raise FileNotFoundError(path)
+        if isinstance(part, str):
+            part = part.encode()
+        if isinstance(part, bytes):
+            logger.debug(f"Reference: {path}, type bytes")
+            if part.startswith(b"base64:"):
+                part = base64.b64decode(part[7:])
+            return part, None, None
+
+        if len(part) == 1:
+            logger.debug(f"Reference: {path}, whole file => {part}")
+            url = part[0]
+            start1, end1 = start, end
+        else:
+            url, start0, size = part
+            logger.debug(f"Reference: {path} => {url}, offset {start0}, size {size}")
+            end0 = start0 + size
+
+            if start is not None:
+                if start >= 0:
+                    start1 = start0 + start
+                else:
+                    start1 = end0 + start
+            else:
+                start1 = start0
+            if end is not None:
+                if end >= 0:
+                    end1 = start0 + end
+                else:
+                    end1 = end0 + end
+            else:
+                end1 = end0
+        if url is None:
+            url = self.target
+        return url, start1, end1
+
+    async def _cat_file(self, path, start=None, end=None, **kwargs):
+        part_or_url, start0, end0 = self._cat_common(path, start=start, end=end)
+        if isinstance(part_or_url, bytes):
+            return part_or_url[start:end]
+        protocol, _ = split_protocol(part_or_url)
+        try:
+            await self.fss[protocol]._cat_file(part_or_url, start=start, end=end)
+        except Exception as e:
+            raise ReferenceNotReachable(path, part_or_url) from e
+
+    def cat_file(self, path, start=None, end=None, **kwargs):
+        part_or_url, start0, end0 = self._cat_common(path, start=start, end=end)
+        if isinstance(part_or_url, bytes):
+            return part_or_url[start:end]
+        protocol, _ = split_protocol(part_or_url)
+        try:
+            return self.fss[protocol].cat_file(part_or_url, start=start0, end=end0)
+        except Exception as e:
+            raise ReferenceNotReachable(path, part_or_url) from e
+
+    def pipe_file(self, path, value, **_):
+        """Temporarily add binary data or reference as a file"""
+        self.references[path] = value
+
+    async def _get_file(self, rpath, lpath, **kwargs):
+        if self.isdir(rpath):
+            return os.makedirs(lpath, exist_ok=True)
+        data = await self._cat_file(rpath)
+        with open(lpath, "wb") as f:
+            f.write(data)
+
+    def get_file(self, rpath, lpath, callback=DEFAULT_CALLBACK, **kwargs):
+        if self.isdir(rpath):
+            return os.makedirs(lpath, exist_ok=True)
+        data = self.cat_file(rpath, **kwargs)
+        callback.set_size(len(data))
+        if isfilelike(lpath):
+            lpath.write(data)
+        else:
+            with open(lpath, "wb") as f:
+                f.write(data)
+        callback.absolute_update(len(data))
+
+    def get(self, rpath, lpath, recursive=False, **kwargs):
+        if recursive:
+            # trigger directory build
+            self.ls("")
+        rpath = self.expand_path(rpath, recursive=recursive)
+        fs = fsspec.filesystem("file", auto_mkdir=True)
+        targets = other_paths(rpath, lpath)
+        if recursive:
+            data = self.cat([r for r in rpath if not self.isdir(r)])
+        else:
+            data = self.cat(rpath)
+        for remote, local in zip(rpath, targets):
+            if remote in data:
+                fs.pipe_file(local, data[remote])
+
+    def cat(self, path, recursive=False, on_error="raise", **kwargs):
+        if isinstance(path, str) and recursive:
+            raise NotImplementedError
+        if isinstance(path, list) and (recursive or any("*" in p for p in path)):
+            raise NotImplementedError
+        # TODO: if references is lazy, pre-fetch all paths in batch before access
+        proto_dict = _protocol_groups(path, self.references)
+        out = {}
+        for proto, paths in proto_dict.items():
+            fs = self.fss[proto]
+            urls, starts, ends, valid_paths = [], [], [], []
+            for p in paths:
+                # find references or label not-found. Early exit if any not
+                # found and on_error is "raise"
+                try:
+                    u, s, e = self._cat_common(p)
+                except FileNotFoundError as err:
+                    if on_error == "raise":
+                        raise
+                    if on_error != "omit":
+                        out[p] = err
+                else:
+                    urls.append(u)
+                    starts.append(s)
+                    ends.append(e)
+                    valid_paths.append(p)
+
+            # process references into form for merging
+            urls2 = []
+            starts2 = []
+            ends2 = []
+            paths2 = []
+            whole_files = set()
+            for u, s, e, p in zip(urls, starts, ends, valid_paths):
+                if isinstance(u, bytes):
+                    # data
+                    out[p] = u
+                elif s is None:
+                    # whole file - limits are None, None, but no further
+                    # entries take for this file
+                    whole_files.add(u)
+                    urls2.append(u)
+                    starts2.append(s)
+                    ends2.append(e)
+                    paths2.append(p)
+            for u, s, e, p in zip(urls, starts, ends, valid_paths):
+                # second run to account for files that are to be loaded whole
+                if s is not None and u not in whole_files:
+                    urls2.append(u)
+                    starts2.append(s)
+                    ends2.append(e)
+                    paths2.append(p)
+
+            # merge and fetch consolidated ranges
+            new_paths, new_starts, new_ends = merge_offset_ranges(
+                list(urls2),
+                list(starts2),
+                list(ends2),
+                sort=True,
+                max_gap=self.max_gap,
+                max_block=self.max_block,
+            )
+            bytes_out = fs.cat_ranges(new_paths, new_starts, new_ends)
+
+            # unbundle from merged bytes - simple approach
+            for u, s, e, p in zip(urls, starts, ends, valid_paths):
+                if p in out:
+                    continue  # was bytes, already handled
+                for np, ns, ne, b in zip(new_paths, new_starts, new_ends, bytes_out):
+                    if np == u and (ns is None or ne is None):
+                        if isinstance(b, Exception):
+                            out[p] = b
+                        else:
+                            out[p] = b[s:e]
+                    elif np == u and s >= ns and e <= ne:
+                        if isinstance(b, Exception):
+                            out[p] = b
+                        else:
+                            out[p] = b[s - ns : (e - ne) or None]
+
+        for k, v in out.copy().items():
+            # these were valid references, but fetch failed, so transform exc
+            if isinstance(v, Exception) and k in self.references:
+                ex = out[k]
+                new_ex = ReferenceNotReachable(k, self.references[k])
+                new_ex.__cause__ = ex
+                if on_error == "raise":
+                    raise new_ex
+                elif on_error != "omit":
+                    out[k] = new_ex
+
+        if len(out) == 1 and isinstance(path, str) and "*" not in path:
+            return _first(out)
+        return out
+
+    def _process_references(self, references, template_overrides=None):
+        vers = references.get("version", None)
+        if vers is None:
+            self._process_references0(references)
+        elif vers == 1:
+            self._process_references1(references, template_overrides=template_overrides)
+        else:
+            raise ValueError(f"Unknown reference spec version: {vers}")
+        # TODO: we make dircache by iterating over all entries, but for Spec >= 1,
+        #  can replace with programmatic. Is it even needed for mapper interface?
+
+    def _process_references0(self, references):
+        """Make reference dict for Spec Version 0"""
+        self.references = references
+
+    def _process_references1(self, references, template_overrides=None):
+        if not self.simple_templates or self.templates:
+            import jinja2
+        self.references = {}
+        self._process_templates(references.get("templates", {}))
+
+        @lru_cache(1000)
+        def _render_jinja(u):
+            return jinja2.Template(u).render(**self.templates)
+
+        for k, v in references.get("refs", {}).items():
+            if isinstance(v, str):
+                if v.startswith("base64:"):
+                    self.references[k] = base64.b64decode(v[7:])
+                self.references[k] = v
+            elif self.templates:
+                u = v[0]
+                if "{{" in u:
+                    if self.simple_templates:
+                        u = (
+                            u.replace("{{", "{")
+                            .replace("}}", "}")
+                            .format(**self.templates)
+                        )
+                    else:
+                        u = _render_jinja(u)
+                self.references[k] = [u] if len(v) == 1 else [u, v[1], v[2]]
+            else:
+                self.references[k] = v
+        self.references.update(self._process_gen(references.get("gen", [])))
+
+    def _process_templates(self, tmp):
+        self.templates = {}
+        if self.template_overrides is not None:
+            tmp.update(self.template_overrides)
+        for k, v in tmp.items():
+            if "{{" in v:
+                import jinja2
+
+                self.templates[k] = lambda temp=v, **kwargs: jinja2.Template(
+                    temp
+                ).render(**kwargs)
+            else:
+                self.templates[k] = v
+
+    def _process_gen(self, gens):
+        out = {}
+        for gen in gens:
+            dimension = {
+                k: v
+                if isinstance(v, list)
+                else range(v.get("start", 0), v["stop"], v.get("step", 1))
+                for k, v in gen["dimensions"].items()
+            }
+            products = (
+                dict(zip(dimension.keys(), values))
+                for values in itertools.product(*dimension.values())
+            )
+            for pr in products:
+                import jinja2
+
+                key = jinja2.Template(gen["key"]).render(**pr, **self.templates)
+                url = jinja2.Template(gen["url"]).render(**pr, **self.templates)
+                if ("offset" in gen) and ("length" in gen):
+                    offset = int(
+                        jinja2.Template(gen["offset"]).render(**pr, **self.templates)
+                    )
+                    length = int(
+                        jinja2.Template(gen["length"]).render(**pr, **self.templates)
+                    )
+                    out[key] = [url, offset, length]
+                elif ("offset" in gen) ^ ("length" in gen):
+                    raise ValueError(
+                        "Both 'offset' and 'length' are required for a "
+                        "reference generator entry if either is provided."
+                    )
+                else:
+                    out[key] = [url]
+        return out
+
+    def _dircache_from_items(self):
+        self.dircache = {"": []}
+        it = self.references.items()
+        for path, part in it:
+            if isinstance(part, (bytes, str)):
+                size = len(part)
+            elif len(part) == 1:
+                size = None
+            else:
+                _, _, size = part
+            par = path.rsplit("/", 1)[0] if "/" in path else ""
+            par0 = par
+            subdirs = [par0]
+            while par0 and par0 not in self.dircache:
+                # collect parent directories
+                par0 = self._parent(par0)
+                subdirs.append(par0)
+
+            subdirs.reverse()
+            for parent, child in zip(subdirs, subdirs[1:]):
+                # register newly discovered directories
+                assert child not in self.dircache
+                assert parent in self.dircache
+                self.dircache[parent].append(
+                    {"name": child, "type": "directory", "size": 0}
+                )
+                self.dircache[child] = []
+
+            self.dircache[par].append({"name": path, "type": "file", "size": size})
+
+    def _open(self, path, mode="rb", block_size=None, cache_options=None, **kwargs):
+        data = self.cat_file(path)  # load whole chunk into memory
+        return io.BytesIO(data)
+
+    def ls(self, path, detail=True, **kwargs):
+        path = self._strip_protocol(path)
+        if isinstance(self.references, LazyReferenceMapper):
+            try:
+                return self.references.ls(path, detail)
+            except KeyError:
+                pass
+            raise FileNotFoundError(f"'{path}' is not a known key")
+        if not self.dircache:
+            self._dircache_from_items()
+        out = self._ls_from_cache(path)
+        if out is None:
+            raise FileNotFoundError(path)
+        if detail:
+            return out
+        return [o["name"] for o in out]
+
+    def exists(self, path, **kwargs):  # overwrite auto-sync version
+        return self.isdir(path) or self.isfile(path)
+
+    def isdir(self, path):  # overwrite auto-sync version
+        if self.dircache:
+            return path in self.dircache
+        elif isinstance(self.references, LazyReferenceMapper):
+            return path in self.references.listdir("")
+        else:
+            # this may be faster than building dircache for single calls, but
+            # by looping will be slow for many calls; could cache it?
+            return any(_.startswith(f"{path}/") for _ in self.references)
+
+    def isfile(self, path):  # overwrite auto-sync version
+        return path in self.references
+
+    async def _ls(self, path, detail=True, **kwargs):  # calls fast sync code
+        return self.ls(path, detail, **kwargs)
+
+    def find(self, path, maxdepth=None, withdirs=False, detail=False, **kwargs):
+        if withdirs:
+            return super().find(
+                path, maxdepth=maxdepth, withdirs=withdirs, detail=detail, **kwargs
+            )
+        if path:
+            path = self._strip_protocol(path)
+            r = sorted(k for k in self.references if k.startswith(path))
+        else:
+            r = sorted(self.references)
+        if detail:
+            if not self.dircache:
+                self._dircache_from_items()
+            return {k: self._ls_from_cache(k)[0] for k in r}
+        else:
+            return r
+
+    def info(self, path, **kwargs):
+        out = self.references.get(path)
+        if out is not None:
+            if isinstance(out, (str, bytes)):
+                # decode base64 here
+                return {"name": path, "type": "file", "size": len(out)}
+            elif len(out) > 1:
+                return {"name": path, "type": "file", "size": out[2]}
+            else:
+                out0 = [{"name": path, "type": "file", "size": None}]
+        else:
+            out = self.ls(path, True)
+            out0 = [o for o in out if o["name"] == path]
+            if not out0:
+                return {"name": path, "type": "directory", "size": 0}
+        if out0[0]["size"] is None:
+            # if this is a whole remote file, update size using remote FS
+            prot, _ = split_protocol(self.references[path][0])
+            out0[0]["size"] = self.fss[prot].size(self.references[path][0])
+        return out0[0]
+
+    async def _info(self, path, **kwargs):  # calls fast sync code
+        return self.info(path)
+
+    async def _rm_file(self, path, **kwargs):
+        self.references.pop(
+            path, None
+        )  # ignores FileNotFound, just as well for directories
+        self.dircache.clear()  # this is a bit heavy handed
+
+    async def _pipe_file(self, path, data):
+        # can be str or bytes
+        self.references[path] = data
+        self.dircache.clear()  # this is a bit heavy handed
+
+    async def _put_file(self, lpath, rpath, **kwargs):
+        # puts binary
+        with open(lpath, "rb") as f:
+            self.references[rpath] = f.read()
+        self.dircache.clear()  # this is a bit heavy handed
+
+    def save_json(self, url, **storage_options):
+        """Write modified references into new location"""
+        out = {}
+        for k, v in self.references.items():
+            if isinstance(v, bytes):
+                try:
+                    out[k] = v.decode("ascii")
+                except UnicodeDecodeError:
+                    out[k] = (b"base64:" + base64.b64encode(v)).decode()
+            else:
+                out[k] = v
+        with fsspec.open(url, "wb", **storage_options) as f:
+            f.write(json.dumps({"version": 1, "refs": out}).encode())
diff --git a/llm/Lib/site-packages/fsspec/implementations/sftp.py b/llm/Lib/site-packages/fsspec/implementations/sftp.py
new file mode 100644
index 0000000000000000000000000000000000000000..77f7b370cd246f9a9bfd34141afc3edd728d13c3
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/sftp.py
@@ -0,0 +1,180 @@
+import datetime
+import logging
+import os
+import types
+import uuid
+from stat import S_ISDIR, S_ISLNK
+
+import paramiko
+
+from .. import AbstractFileSystem
+from ..utils import infer_storage_options
+
+logger = logging.getLogger("fsspec.sftp")
+
+
+class SFTPFileSystem(AbstractFileSystem):
+    """Files over SFTP/SSH
+
+    Peer-to-peer filesystem over SSH using paramiko.
+
+    Note: if using this with the ``open`` or ``open_files``, with full URLs,
+    there is no way to tell if a path is relative, so all paths are assumed
+    to be absolute.
+    """
+
+    protocol = "sftp", "ssh"
+
+    def __init__(self, host, **ssh_kwargs):
+        """
+
+        Parameters
+        ----------
+        host: str
+            Hostname or IP as a string
+        temppath: str
+            Location on the server to put files, when within a transaction
+        ssh_kwargs: dict
+            Parameters passed on to connection. See details in
+            https://docs.paramiko.org/en/3.3/api/client.html#paramiko.client.SSHClient.connect
+            May include port, username, password...
+        """
+        if self._cached:
+            return
+        super().__init__(**ssh_kwargs)
+        self.temppath = ssh_kwargs.pop("temppath", "/tmp")  # remote temp directory
+        self.host = host
+        self.ssh_kwargs = ssh_kwargs
+        self._connect()
+
+    def _connect(self):
+        logger.debug("Connecting to SFTP server %s", self.host)
+        self.client = paramiko.SSHClient()
+        self.client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
+        self.client.connect(self.host, **self.ssh_kwargs)
+        self.ftp = self.client.open_sftp()
+
+    @classmethod
+    def _strip_protocol(cls, path):
+        return infer_storage_options(path)["path"]
+
+    @staticmethod
+    def _get_kwargs_from_urls(urlpath):
+        out = infer_storage_options(urlpath)
+        out.pop("path", None)
+        out.pop("protocol", None)
+        return out
+
+    def mkdir(self, path, create_parents=True, mode=511):
+        logger.debug("Creating folder %s", path)
+        if self.exists(path):
+            raise FileExistsError(f"File exists: {path}")
+
+        if create_parents:
+            self.makedirs(path)
+        else:
+            self.ftp.mkdir(path, mode)
+
+    def makedirs(self, path, exist_ok=False, mode=511):
+        if self.exists(path) and not exist_ok:
+            raise FileExistsError(f"File exists: {path}")
+
+        parts = path.split("/")
+        new_path = "/" if path[:1] == "/" else ""
+
+        for part in parts:
+            if part:
+                new_path = f"{new_path}/{part}" if new_path else part
+                if not self.exists(new_path):
+                    self.ftp.mkdir(new_path, mode)
+
+    def rmdir(self, path):
+        logger.debug("Removing folder %s", path)
+        self.ftp.rmdir(path)
+
+    def info(self, path):
+        stat = self._decode_stat(self.ftp.stat(path))
+        stat["name"] = path
+        return stat
+
+    @staticmethod
+    def _decode_stat(stat, parent_path=None):
+        if S_ISDIR(stat.st_mode):
+            t = "directory"
+        elif S_ISLNK(stat.st_mode):
+            t = "link"
+        else:
+            t = "file"
+        out = {
+            "name": "",
+            "size": stat.st_size,
+            "type": t,
+            "uid": stat.st_uid,
+            "gid": stat.st_gid,
+            "time": datetime.datetime.fromtimestamp(
+                stat.st_atime, tz=datetime.timezone.utc
+            ),
+            "mtime": datetime.datetime.fromtimestamp(
+                stat.st_mtime, tz=datetime.timezone.utc
+            ),
+        }
+        if parent_path:
+            out["name"] = "/".join([parent_path.rstrip("/"), stat.filename])
+        return out
+
+    def ls(self, path, detail=False):
+        logger.debug("Listing folder %s", path)
+        stats = [self._decode_stat(stat, path) for stat in self.ftp.listdir_iter(path)]
+        if detail:
+            return stats
+        else:
+            paths = [stat["name"] for stat in stats]
+            return sorted(paths)
+
+    def put(self, lpath, rpath, callback=None, **kwargs):
+        logger.debug("Put file %s into %s", lpath, rpath)
+        self.ftp.put(lpath, rpath)
+
+    def get_file(self, rpath, lpath, **kwargs):
+        if self.isdir(rpath):
+            os.makedirs(lpath, exist_ok=True)
+        else:
+            self.ftp.get(self._strip_protocol(rpath), lpath)
+
+    def _open(self, path, mode="rb", block_size=None, **kwargs):
+        """
+        block_size: int or None
+            If 0, no buffering, if 1, line buffering, if >1, buffer that many
+            bytes, if None use default from paramiko.
+        """
+        logger.debug("Opening file %s", path)
+        if kwargs.get("autocommit", True) is False:
+            # writes to temporary file, move on commit
+            path2 = "/".join([self.temppath, str(uuid.uuid4())])
+            f = self.ftp.open(path2, mode, bufsize=block_size if block_size else -1)
+            f.temppath = path2
+            f.targetpath = path
+            f.fs = self
+            f.commit = types.MethodType(commit_a_file, f)
+            f.discard = types.MethodType(discard_a_file, f)
+        else:
+            f = self.ftp.open(path, mode, bufsize=block_size if block_size else -1)
+        return f
+
+    def _rm(self, path):
+        if self.isdir(path):
+            self.ftp.rmdir(path)
+        else:
+            self.ftp.remove(path)
+
+    def mv(self, old, new):
+        logger.debug("Renaming %s into %s", old, new)
+        self.ftp.posix_rename(old, new)
+
+
+def commit_a_file(self):
+    self.fs.mv(self.temppath, self.targetpath)
+
+
+def discard_a_file(self):
+    self.fs._rm(self.temppath)
diff --git a/llm/Lib/site-packages/fsspec/implementations/smb.py b/llm/Lib/site-packages/fsspec/implementations/smb.py
new file mode 100644
index 0000000000000000000000000000000000000000..37949939ecb928bd2b6b7d5caf51e052a123bd36
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/smb.py
@@ -0,0 +1,331 @@
+"""
+This module contains SMBFileSystem class responsible for handling access to
+Windows Samba network shares by using package smbprotocol
+"""
+
+import datetime
+import uuid
+from stat import S_ISDIR, S_ISLNK
+
+import smbclient
+
+from .. import AbstractFileSystem
+from ..utils import infer_storage_options
+
+# ! pylint: disable=bad-continuation
+
+
+class SMBFileSystem(AbstractFileSystem):
+    """Allow reading and writing to Windows and Samba network shares.
+
+    When using `fsspec.open()` for getting a file-like object the URI
+    should be specified as this format:
+    ``smb://workgroup;user:password@server:port/share/folder/file.csv``.
+
+    Example::
+
+        >>> import fsspec
+        >>> with fsspec.open(
+        ...     'smb://myuser:mypassword@myserver.com/' 'share/folder/file.csv'
+        ... ) as smbfile:
+        ...     df = pd.read_csv(smbfile, sep='|', header=None)
+
+    Note that you need to pass in a valid hostname or IP address for the host
+    component of the URL. Do not use the Windows/NetBIOS machine name for the
+    host component.
+
+    The first component of the path in the URL points to the name of the shared
+    folder. Subsequent path components will point to the directory/folder/file.
+
+    The URL components ``workgroup`` , ``user``, ``password`` and ``port`` may be
+    optional.
+
+    .. note::
+
+        For working this source require `smbprotocol`_ to be installed, e.g.::
+
+            $ pip install smbprotocol
+            # or
+            # pip install smbprotocol[kerberos]
+
+    .. _smbprotocol: https://github.com/jborean93/smbprotocol#requirements
+
+    Note: if using this with the ``open`` or ``open_files``, with full URLs,
+    there is no way to tell if a path is relative, so all paths are assumed
+    to be absolute.
+    """
+
+    protocol = "smb"
+
+    # pylint: disable=too-many-arguments
+    def __init__(
+        self,
+        host,
+        port=None,
+        username=None,
+        password=None,
+        timeout=60,
+        encrypt=None,
+        share_access=None,
+        **kwargs,
+    ):
+        """
+        You can use _get_kwargs_from_urls to get some kwargs from
+        a reasonable SMB url.
+
+        Authentication will be anonymous or integrated if username/password are not
+        given.
+
+        Parameters
+        ----------
+        host: str
+            The remote server name/ip to connect to
+        port: int or None
+            Port to connect with. Usually 445, sometimes 139.
+        username: str or None
+            Username to connect with. Required if Kerberos auth is not being used.
+        password: str or None
+            User's password on the server, if using username
+        timeout: int
+            Connection timeout in seconds
+        encrypt: bool
+            Whether to force encryption or not, once this has been set to True
+            the session cannot be changed back to False.
+        share_access: str or None
+            Specifies the default access applied to file open operations
+            performed with this file system object.
+            This affects whether other processes can concurrently open a handle
+            to the same file.
+
+            - None (the default): exclusively locks the file until closed.
+            - 'r': Allow other handles to be opened with read access.
+            - 'w': Allow other handles to be opened with write access.
+            - 'd': Allow other handles to be opened with delete access.
+        """
+        super().__init__(**kwargs)
+        self.host = host
+        self.port = port
+        self.username = username
+        self.password = password
+        self.timeout = timeout
+        self.encrypt = encrypt
+        self.temppath = kwargs.pop("temppath", "")
+        self.share_access = share_access
+        self._connect()
+
+    @property
+    def _port(self):
+        return 445 if self.port is None else self.port
+
+    def _connect(self):
+        import time
+
+        for _ in range(5):
+            try:
+                smbclient.register_session(
+                    self.host,
+                    username=self.username,
+                    password=self.password,
+                    port=self._port,
+                    encrypt=self.encrypt,
+                    connection_timeout=self.timeout,
+                )
+                break
+            except Exception:
+                time.sleep(0.1)
+
+    @classmethod
+    def _strip_protocol(cls, path):
+        return infer_storage_options(path)["path"]
+
+    @staticmethod
+    def _get_kwargs_from_urls(path):
+        # smb://workgroup;user:password@host:port/share/folder/file.csv
+        out = infer_storage_options(path)
+        out.pop("path", None)
+        out.pop("protocol", None)
+        return out
+
+    def mkdir(self, path, create_parents=True, **kwargs):
+        wpath = _as_unc_path(self.host, path)
+        if create_parents:
+            smbclient.makedirs(wpath, exist_ok=False, port=self._port, **kwargs)
+        else:
+            smbclient.mkdir(wpath, port=self._port, **kwargs)
+
+    def makedirs(self, path, exist_ok=False):
+        if _share_has_path(path):
+            wpath = _as_unc_path(self.host, path)
+            smbclient.makedirs(wpath, exist_ok=exist_ok, port=self._port)
+
+    def rmdir(self, path):
+        if _share_has_path(path):
+            wpath = _as_unc_path(self.host, path)
+            smbclient.rmdir(wpath, port=self._port)
+
+    def info(self, path, **kwargs):
+        wpath = _as_unc_path(self.host, path)
+        stats = smbclient.stat(wpath, port=self._port, **kwargs)
+        if S_ISDIR(stats.st_mode):
+            stype = "directory"
+        elif S_ISLNK(stats.st_mode):
+            stype = "link"
+        else:
+            stype = "file"
+        res = {
+            "name": path + "/" if stype == "directory" else path,
+            "size": stats.st_size,
+            "type": stype,
+            "uid": stats.st_uid,
+            "gid": stats.st_gid,
+            "time": stats.st_atime,
+            "mtime": stats.st_mtime,
+        }
+        return res
+
+    def created(self, path):
+        """Return the created timestamp of a file as a datetime.datetime"""
+        wpath = _as_unc_path(self.host, path)
+        stats = smbclient.stat(wpath, port=self._port)
+        return datetime.datetime.fromtimestamp(stats.st_ctime, tz=datetime.timezone.utc)
+
+    def modified(self, path):
+        """Return the modified timestamp of a file as a datetime.datetime"""
+        wpath = _as_unc_path(self.host, path)
+        stats = smbclient.stat(wpath, port=self._port)
+        return datetime.datetime.fromtimestamp(stats.st_mtime, tz=datetime.timezone.utc)
+
+    def ls(self, path, detail=True, **kwargs):
+        unc = _as_unc_path(self.host, path)
+        listed = smbclient.listdir(unc, port=self._port, **kwargs)
+        dirs = ["/".join([path.rstrip("/"), p]) for p in listed]
+        if detail:
+            dirs = [self.info(d) for d in dirs]
+        return dirs
+
+    # pylint: disable=too-many-arguments
+    def _open(
+        self,
+        path,
+        mode="rb",
+        block_size=-1,
+        autocommit=True,
+        cache_options=None,
+        **kwargs,
+    ):
+        """
+        block_size: int or None
+            If 0, no buffering, 1, line buffering, >1, buffer that many bytes
+
+        Notes
+        -----
+        By specifying 'share_access' in 'kwargs' it is possible to override the
+        default shared access setting applied in the constructor of this object.
+        """
+        bls = block_size if block_size is not None and block_size >= 0 else -1
+        wpath = _as_unc_path(self.host, path)
+        share_access = kwargs.pop("share_access", self.share_access)
+        if "w" in mode and autocommit is False:
+            temp = _as_temp_path(self.host, path, self.temppath)
+            return SMBFileOpener(
+                wpath, temp, mode, port=self._port, block_size=bls, **kwargs
+            )
+        return smbclient.open_file(
+            wpath,
+            mode,
+            buffering=bls,
+            share_access=share_access,
+            port=self._port,
+            **kwargs,
+        )
+
+    def copy(self, path1, path2, **kwargs):
+        """Copy within two locations in the same filesystem"""
+        wpath1 = _as_unc_path(self.host, path1)
+        wpath2 = _as_unc_path(self.host, path2)
+        smbclient.copyfile(wpath1, wpath2, port=self._port, **kwargs)
+
+    def _rm(self, path):
+        if _share_has_path(path):
+            wpath = _as_unc_path(self.host, path)
+            stats = smbclient.stat(wpath, port=self._port)
+            if S_ISDIR(stats.st_mode):
+                smbclient.rmdir(wpath, port=self._port)
+            else:
+                smbclient.remove(wpath, port=self._port)
+
+    def mv(self, path1, path2, recursive=None, maxdepth=None, **kwargs):
+        wpath1 = _as_unc_path(self.host, path1)
+        wpath2 = _as_unc_path(self.host, path2)
+        smbclient.rename(wpath1, wpath2, port=self._port, **kwargs)
+
+
+def _as_unc_path(host, path):
+    rpath = path.replace("/", "\\")
+    unc = f"\\\\{host}{rpath}"
+    return unc
+
+
+def _as_temp_path(host, path, temppath):
+    share = path.split("/")[1]
+    temp_file = f"/{share}{temppath}/{uuid.uuid4()}"
+    unc = _as_unc_path(host, temp_file)
+    return unc
+
+
+def _share_has_path(path):
+    parts = path.count("/")
+    if path.endswith("/"):
+        return parts > 2
+    return parts > 1
+
+
+class SMBFileOpener:
+    """writes to remote temporary file, move on commit"""
+
+    def __init__(self, path, temp, mode, port=445, block_size=-1, **kwargs):
+        self.path = path
+        self.temp = temp
+        self.mode = mode
+        self.block_size = block_size
+        self.kwargs = kwargs
+        self.smbfile = None
+        self._incontext = False
+        self.port = port
+        self._open()
+
+    def _open(self):
+        if self.smbfile is None or self.smbfile.closed:
+            self.smbfile = smbclient.open_file(
+                self.temp,
+                self.mode,
+                port=self.port,
+                buffering=self.block_size,
+                **self.kwargs,
+            )
+
+    def commit(self):
+        """Move temp file to definitive on success."""
+        # TODO: use transaction support in SMB protocol
+        smbclient.replace(self.temp, self.path, port=self.port)
+
+    def discard(self):
+        """Remove the temp file on failure."""
+        smbclient.remove(self.temp, port=self.port)
+
+    def __fspath__(self):
+        return self.path
+
+    def __iter__(self):
+        return self.smbfile.__iter__()
+
+    def __getattr__(self, item):
+        return getattr(self.smbfile, item)
+
+    def __enter__(self):
+        self._incontext = True
+        return self.smbfile.__enter__()
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        self._incontext = False
+        self.smbfile.__exit__(exc_type, exc_value, traceback)
diff --git a/llm/Lib/site-packages/fsspec/implementations/tar.py b/llm/Lib/site-packages/fsspec/implementations/tar.py
new file mode 100644
index 0000000000000000000000000000000000000000..412e5ba4d2cdea7db090dc96412e697909a38d78
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/tar.py
@@ -0,0 +1,124 @@
+import logging
+import tarfile
+
+import fsspec
+from fsspec.archive import AbstractArchiveFileSystem
+from fsspec.compression import compr
+from fsspec.utils import infer_compression
+
+typemap = {b"0": "file", b"5": "directory"}
+
+logger = logging.getLogger("tar")
+
+
+class TarFileSystem(AbstractArchiveFileSystem):
+    """Compressed Tar archives as a file-system (read-only)
+
+    Supports the following formats:
+    tar.gz, tar.bz2, tar.xz
+    """
+
+    root_marker = ""
+    protocol = "tar"
+    cachable = False
+
+    def __init__(
+        self,
+        fo="",
+        index_store=None,
+        target_options=None,
+        target_protocol=None,
+        compression=None,
+        **kwargs,
+    ):
+        super().__init__(**kwargs)
+        target_options = target_options or {}
+
+        if isinstance(fo, str):
+            self.of = fsspec.open(fo, protocol=target_protocol, **target_options)
+            fo = self.of.open()  # keep the reference
+
+        # Try to infer compression.
+        if compression is None:
+            name = None
+
+            # Try different ways to get hold of the filename. `fo` might either
+            # be a `fsspec.LocalFileOpener`, an `io.BufferedReader` or an
+            # `fsspec.AbstractFileSystem` instance.
+            try:
+                # Amended io.BufferedReader or similar.
+                # This uses a "protocol extension" where original filenames are
+                # propagated to archive-like filesystems in order to let them
+                # infer the right compression appropriately.
+                if hasattr(fo, "original"):
+                    name = fo.original
+
+                # fsspec.LocalFileOpener
+                elif hasattr(fo, "path"):
+                    name = fo.path
+
+                # io.BufferedReader
+                elif hasattr(fo, "name"):
+                    name = fo.name
+
+                # fsspec.AbstractFileSystem
+                elif hasattr(fo, "info"):
+                    name = fo.info()["name"]
+
+            except Exception as ex:
+                logger.warning(
+                    f"Unable to determine file name, not inferring compression: {ex}"
+                )
+
+            if name is not None:
+                compression = infer_compression(name)
+                logger.info(f"Inferred compression {compression} from file name {name}")
+
+        if compression is not None:
+            # TODO: tarfile already implements compression with modes like "'r:gz'",
+            #  but then would seek to offset in the file work?
+            fo = compr[compression](fo)
+
+        self._fo_ref = fo
+        self.fo = fo  # the whole instance is a context
+        self.tar = tarfile.TarFile(fileobj=self.fo)
+        self.dir_cache = None
+
+        self.index_store = index_store
+        self.index = None
+        self._index()
+
+    def _index(self):
+        # TODO: load and set saved index, if exists
+        out = {}
+        for ti in self.tar:
+            info = ti.get_info()
+            info["type"] = typemap.get(info["type"], "file")
+            name = ti.get_info()["name"].rstrip("/")
+            out[name] = (info, ti.offset_data)
+
+        self.index = out
+        # TODO: save index to self.index_store here, if set
+
+    def _get_dirs(self):
+        if self.dir_cache is not None:
+            return
+
+        # This enables ls to get directories as children as well as files
+        self.dir_cache = {
+            dirname: {"name": dirname, "size": 0, "type": "directory"}
+            for dirname in self._all_dirnames(self.tar.getnames())
+        }
+        for member in self.tar.getmembers():
+            info = member.get_info()
+            info["name"] = info["name"].rstrip("/")
+            info["type"] = typemap.get(info["type"], "file")
+            self.dir_cache[info["name"]] = info
+
+    def _open(self, path, mode="rb", **kwargs):
+        if mode != "rb":
+            raise ValueError("Read-only filesystem implementation")
+        details, offset = self.index[path]
+        if details["type"] != "file":
+            raise ValueError("Can only handle regular files")
+        return self.tar.extractfile(path)
diff --git a/llm/Lib/site-packages/fsspec/implementations/webhdfs.py b/llm/Lib/site-packages/fsspec/implementations/webhdfs.py
new file mode 100644
index 0000000000000000000000000000000000000000..5a6b901d19e5b9e268b36545fc1332f0f098de76
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/webhdfs.py
@@ -0,0 +1,486 @@
+# https://hadoop.apache.org/docs/r1.0.4/webhdfs.html
+
+import logging
+import os
+import secrets
+import shutil
+import tempfile
+import uuid
+from contextlib import suppress
+from urllib.parse import quote
+
+import requests
+
+from ..spec import AbstractBufferedFile, AbstractFileSystem
+from ..utils import infer_storage_options, tokenize
+
+logger = logging.getLogger("webhdfs")
+
+
+class WebHDFS(AbstractFileSystem):
+    """
+    Interface to HDFS over HTTP using the WebHDFS API. Supports also HttpFS gateways.
+
+    Four auth mechanisms are supported:
+
+    insecure: no auth is done, and the user is assumed to be whoever they
+        say they are (parameter ``user``), or a predefined value such as
+        "dr.who" if not given
+    spnego: when kerberos authentication is enabled, auth is negotiated by
+        requests_kerberos https://github.com/requests/requests-kerberos .
+        This establishes a session based on existing kinit login and/or
+        specified principal/password; parameters are passed with ``kerb_kwargs``
+    token: uses an existing Hadoop delegation token from another secured
+        service. Indeed, this client can also generate such tokens when
+        not insecure. Note that tokens expire, but can be renewed (by a
+        previously specified user) and may allow for proxying.
+    basic-auth: used when both parameter ``user`` and parameter ``password``
+        are provided.
+
+    """
+
+    tempdir = str(tempfile.gettempdir())
+    protocol = "webhdfs", "webHDFS"
+
+    def __init__(
+        self,
+        host,
+        port=50070,
+        kerberos=False,
+        token=None,
+        user=None,
+        password=None,
+        proxy_to=None,
+        kerb_kwargs=None,
+        data_proxy=None,
+        use_https=False,
+        session_cert=None,
+        session_verify=True,
+        **kwargs,
+    ):
+        """
+        Parameters
+        ----------
+        host: str
+            Name-node address
+        port: int
+            Port for webHDFS
+        kerberos: bool
+            Whether to authenticate with kerberos for this connection
+        token: str or None
+            If given, use this token on every call to authenticate. A user
+            and user-proxy may be encoded in the token and should not be also
+            given
+        user: str or None
+            If given, assert the user name to connect with
+        password: str or None
+            If given, assert the password to use for basic auth. If password
+            is provided, user must be provided also
+        proxy_to: str or None
+            If given, the user has the authority to proxy, and this value is
+            the user in who's name actions are taken
+        kerb_kwargs: dict
+            Any extra arguments for HTTPKerberosAuth, see
+            `<https://github.com/requests/requests-kerberos/blob/master/requests_kerberos/kerberos_.py>`_
+        data_proxy: dict, callable or None
+            If given, map data-node addresses. This can be necessary if the
+            HDFS cluster is behind a proxy, running on Docker or otherwise has
+            a mismatch between the host-names given by the name-node and the
+            address by which to refer to them from the client. If a dict,
+            maps host names ``host->data_proxy[host]``; if a callable, full
+            URLs are passed, and function must conform to
+            ``url->data_proxy(url)``.
+        use_https: bool
+            Whether to connect to the Name-node using HTTPS instead of HTTP
+        session_cert: str or Tuple[str, str] or None
+            Path to a certificate file, or tuple of (cert, key) files to use
+            for the requests.Session
+        session_verify: str, bool or None
+            Path to a certificate file to use for verifying the requests.Session.
+        kwargs
+        """
+        if self._cached:
+            return
+        super().__init__(**kwargs)
+        self.url = (
+            f"{'https' if use_https else 'http'}://{host}:{port}/webhdfs/v1"  # noqa
+        )
+        self.kerb = kerberos
+        self.kerb_kwargs = kerb_kwargs or {}
+        self.pars = {}
+        self.proxy = data_proxy or {}
+        if token is not None:
+            if user is not None or proxy_to is not None:
+                raise ValueError(
+                    "If passing a delegation token, must not set "
+                    "user or proxy_to, as these are encoded in the"
+                    " token"
+                )
+            self.pars["delegation"] = token
+        self.user = user
+        self.password = password
+
+        if password is not None:
+            if user is None:
+                raise ValueError(
+                    "If passing a password, the user must also be"
+                    "set in order to set up the basic-auth"
+                )
+        else:
+            if user is not None:
+                self.pars["user.name"] = user
+
+        if proxy_to is not None:
+            self.pars["doas"] = proxy_to
+        if kerberos and user is not None:
+            raise ValueError(
+                "If using Kerberos auth, do not specify the "
+                "user, this is handled by kinit."
+            )
+
+        self.session_cert = session_cert
+        self.session_verify = session_verify
+
+        self._connect()
+
+        self._fsid = f"webhdfs_{tokenize(host, port)}"
+
+    @property
+    def fsid(self):
+        return self._fsid
+
+    def _connect(self):
+        self.session = requests.Session()
+
+        if self.session_cert:
+            self.session.cert = self.session_cert
+
+        self.session.verify = self.session_verify
+
+        if self.kerb:
+            from requests_kerberos import HTTPKerberosAuth
+
+            self.session.auth = HTTPKerberosAuth(**self.kerb_kwargs)
+
+        if self.user is not None and self.password is not None:
+            from requests.auth import HTTPBasicAuth
+
+            self.session.auth = HTTPBasicAuth(self.user, self.password)
+
+    def _call(self, op, method="get", path=None, data=None, redirect=True, **kwargs):
+        url = self._apply_proxy(self.url + quote(path or "", safe="/="))
+        args = kwargs.copy()
+        args.update(self.pars)
+        args["op"] = op.upper()
+        logger.debug("sending %s with %s", url, method)
+        out = self.session.request(
+            method=method.upper(),
+            url=url,
+            params=args,
+            data=data,
+            allow_redirects=redirect,
+        )
+        if out.status_code in [400, 401, 403, 404, 500]:
+            try:
+                err = out.json()
+                msg = err["RemoteException"]["message"]
+                exp = err["RemoteException"]["exception"]
+            except (ValueError, KeyError):
+                pass
+            else:
+                if exp in ["IllegalArgumentException", "UnsupportedOperationException"]:
+                    raise ValueError(msg)
+                elif exp in ["SecurityException", "AccessControlException"]:
+                    raise PermissionError(msg)
+                elif exp in ["FileNotFoundException"]:
+                    raise FileNotFoundError(msg)
+                else:
+                    raise RuntimeError(msg)
+        out.raise_for_status()
+        return out
+
+    def _open(
+        self,
+        path,
+        mode="rb",
+        block_size=None,
+        autocommit=True,
+        replication=None,
+        permissions=None,
+        **kwargs,
+    ):
+        """
+
+        Parameters
+        ----------
+        path: str
+            File location
+        mode: str
+            'rb', 'wb', etc.
+        block_size: int
+            Client buffer size for read-ahead or write buffer
+        autocommit: bool
+            If False, writes to temporary file that only gets put in final
+            location upon commit
+        replication: int
+            Number of copies of file on the cluster, write mode only
+        permissions: str or int
+            posix permissions, write mode only
+        kwargs
+
+        Returns
+        -------
+        WebHDFile instance
+        """
+        block_size = block_size or self.blocksize
+        return WebHDFile(
+            self,
+            path,
+            mode=mode,
+            block_size=block_size,
+            tempdir=self.tempdir,
+            autocommit=autocommit,
+            replication=replication,
+            permissions=permissions,
+        )
+
+    @staticmethod
+    def _process_info(info):
+        info["type"] = info["type"].lower()
+        info["size"] = info["length"]
+        return info
+
+    @classmethod
+    def _strip_protocol(cls, path):
+        return infer_storage_options(path)["path"]
+
+    @staticmethod
+    def _get_kwargs_from_urls(urlpath):
+        out = infer_storage_options(urlpath)
+        out.pop("path", None)
+        out.pop("protocol", None)
+        if "username" in out:
+            out["user"] = out.pop("username")
+        return out
+
+    def info(self, path):
+        out = self._call("GETFILESTATUS", path=path)
+        info = out.json()["FileStatus"]
+        info["name"] = path
+        return self._process_info(info)
+
+    def ls(self, path, detail=False):
+        out = self._call("LISTSTATUS", path=path)
+        infos = out.json()["FileStatuses"]["FileStatus"]
+        for info in infos:
+            self._process_info(info)
+            info["name"] = path.rstrip("/") + "/" + info["pathSuffix"]
+        if detail:
+            return sorted(infos, key=lambda i: i["name"])
+        else:
+            return sorted(info["name"] for info in infos)
+
+    def content_summary(self, path):
+        """Total numbers of files, directories and bytes under path"""
+        out = self._call("GETCONTENTSUMMARY", path=path)
+        return out.json()["ContentSummary"]
+
+    def ukey(self, path):
+        """Checksum info of file, giving method and result"""
+        out = self._call("GETFILECHECKSUM", path=path, redirect=False)
+        if "Location" in out.headers:
+            location = self._apply_proxy(out.headers["Location"])
+            out2 = self.session.get(location)
+            out2.raise_for_status()
+            return out2.json()["FileChecksum"]
+        else:
+            out.raise_for_status()
+            return out.json()["FileChecksum"]
+
+    def home_directory(self):
+        """Get user's home directory"""
+        out = self._call("GETHOMEDIRECTORY")
+        return out.json()["Path"]
+
+    def get_delegation_token(self, renewer=None):
+        """Retrieve token which can give the same authority to other uses
+
+        Parameters
+        ----------
+        renewer: str or None
+            User who may use this token; if None, will be current user
+        """
+        if renewer:
+            out = self._call("GETDELEGATIONTOKEN", renewer=renewer)
+        else:
+            out = self._call("GETDELEGATIONTOKEN")
+        t = out.json()["Token"]
+        if t is None:
+            raise ValueError("No token available for this user/security context")
+        return t["urlString"]
+
+    def renew_delegation_token(self, token):
+        """Make token live longer. Returns new expiry time"""
+        out = self._call("RENEWDELEGATIONTOKEN", method="put", token=token)
+        return out.json()["long"]
+
+    def cancel_delegation_token(self, token):
+        """Stop the token from being useful"""
+        self._call("CANCELDELEGATIONTOKEN", method="put", token=token)
+
+    def chmod(self, path, mod):
+        """Set the permission at path
+
+        Parameters
+        ----------
+        path: str
+            location to set (file or directory)
+        mod: str or int
+            posix epresentation or permission, give as oct string, e.g, '777'
+            or 0o777
+        """
+        self._call("SETPERMISSION", method="put", path=path, permission=mod)
+
+    def chown(self, path, owner=None, group=None):
+        """Change owning user and/or group"""
+        kwargs = {}
+        if owner is not None:
+            kwargs["owner"] = owner
+        if group is not None:
+            kwargs["group"] = group
+        self._call("SETOWNER", method="put", path=path, **kwargs)
+
+    def set_replication(self, path, replication):
+        """
+        Set file replication factor
+
+        Parameters
+        ----------
+        path: str
+            File location (not for directories)
+        replication: int
+            Number of copies of file on the cluster. Should be smaller than
+            number of data nodes; normally 3 on most systems.
+        """
+        self._call("SETREPLICATION", path=path, method="put", replication=replication)
+
+    def mkdir(self, path, **kwargs):
+        self._call("MKDIRS", method="put", path=path)
+
+    def makedirs(self, path, exist_ok=False):
+        if exist_ok is False and self.exists(path):
+            raise FileExistsError(path)
+        self.mkdir(path)
+
+    def mv(self, path1, path2, **kwargs):
+        self._call("RENAME", method="put", path=path1, destination=path2)
+
+    def rm(self, path, recursive=False, **kwargs):
+        self._call(
+            "DELETE",
+            method="delete",
+            path=path,
+            recursive="true" if recursive else "false",
+        )
+
+    def rm_file(self, path, **kwargs):
+        self.rm(path)
+
+    def cp_file(self, lpath, rpath, **kwargs):
+        with self.open(lpath) as lstream:
+            tmp_fname = "/".join([self._parent(rpath), f".tmp.{secrets.token_hex(16)}"])
+            # Perform an atomic copy (stream to a temporary file and
+            # move it to the actual destination).
+            try:
+                with self.open(tmp_fname, "wb") as rstream:
+                    shutil.copyfileobj(lstream, rstream)
+                self.mv(tmp_fname, rpath)
+            except BaseException:  # noqa
+                with suppress(FileNotFoundError):
+                    self.rm(tmp_fname)
+                raise
+
+    def _apply_proxy(self, location):
+        if self.proxy and callable(self.proxy):
+            location = self.proxy(location)
+        elif self.proxy:
+            # as a dict
+            for k, v in self.proxy.items():
+                location = location.replace(k, v, 1)
+        return location
+
+
+class WebHDFile(AbstractBufferedFile):
+    """A file living in HDFS over webHDFS"""
+
+    def __init__(self, fs, path, **kwargs):
+        super().__init__(fs, path, **kwargs)
+        kwargs = kwargs.copy()
+        if kwargs.get("permissions", None) is None:
+            kwargs.pop("permissions", None)
+        if kwargs.get("replication", None) is None:
+            kwargs.pop("replication", None)
+        self.permissions = kwargs.pop("permissions", 511)
+        tempdir = kwargs.pop("tempdir")
+        if kwargs.pop("autocommit", False) is False:
+            self.target = self.path
+            self.path = os.path.join(tempdir, str(uuid.uuid4()))
+
+    def _upload_chunk(self, final=False):
+        """Write one part of a multi-block file upload
+
+        Parameters
+        ==========
+        final: bool
+            This is the last block, so should complete file, if
+            self.autocommit is True.
+        """
+        out = self.fs.session.post(
+            self.location,
+            data=self.buffer.getvalue(),
+            headers={"content-type": "application/octet-stream"},
+        )
+        out.raise_for_status()
+        return True
+
+    def _initiate_upload(self):
+        """Create remote file/upload"""
+        kwargs = self.kwargs.copy()
+        if "a" in self.mode:
+            op, method = "APPEND", "POST"
+        else:
+            op, method = "CREATE", "PUT"
+            kwargs["overwrite"] = "true"
+        out = self.fs._call(op, method, self.path, redirect=False, **kwargs)
+        location = self.fs._apply_proxy(out.headers["Location"])
+        if "w" in self.mode:
+            # create empty file to append to
+            out2 = self.fs.session.put(
+                location, headers={"content-type": "application/octet-stream"}
+            )
+            out2.raise_for_status()
+            # after creating empty file, change location to append to
+            out2 = self.fs._call("APPEND", "POST", self.path, redirect=False, **kwargs)
+            self.location = self.fs._apply_proxy(out2.headers["Location"])
+
+    def _fetch_range(self, start, end):
+        start = max(start, 0)
+        end = min(self.size, end)
+        if start >= end or start >= self.size:
+            return b""
+        out = self.fs._call(
+            "OPEN", path=self.path, offset=start, length=end - start, redirect=False
+        )
+        out.raise_for_status()
+        if "Location" in out.headers:
+            location = out.headers["Location"]
+            out2 = self.fs.session.get(self.fs._apply_proxy(location))
+            return out2.content
+        else:
+            return out.content
+
+    def commit(self):
+        self.fs.mv(self.path, self.target)
+
+    def discard(self):
+        self.fs.rm(self.path)
diff --git a/llm/Lib/site-packages/fsspec/implementations/zip.py b/llm/Lib/site-packages/fsspec/implementations/zip.py
new file mode 100644
index 0000000000000000000000000000000000000000..9d9c046bfde313b6868399c4d200bc779c1ab19f
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/implementations/zip.py
@@ -0,0 +1,134 @@
+import zipfile
+
+import fsspec
+from fsspec.archive import AbstractArchiveFileSystem
+
+
+class ZipFileSystem(AbstractArchiveFileSystem):
+    """Read/Write contents of ZIP archive as a file-system
+
+    Keeps file object open while instance lives.
+
+    This class is pickleable, but not necessarily thread-safe
+    """
+
+    root_marker = ""
+    protocol = "zip"
+    cachable = False
+
+    def __init__(
+        self,
+        fo="",
+        mode="r",
+        target_protocol=None,
+        target_options=None,
+        compression=zipfile.ZIP_STORED,
+        allowZip64=True,
+        compresslevel=None,
+        **kwargs,
+    ):
+        """
+        Parameters
+        ----------
+        fo: str or file-like
+            Contains ZIP, and must exist. If a str, will fetch file using
+            :meth:`~fsspec.open_files`, which must return one file exactly.
+        mode: str
+            Accept: "r", "w", "a"
+        target_protocol: str (optional)
+            If ``fo`` is a string, this value can be used to override the
+            FS protocol inferred from a URL
+        target_options: dict (optional)
+            Kwargs passed when instantiating the target FS, if ``fo`` is
+            a string.
+        compression, allowZip64, compresslevel: passed to ZipFile
+            Only relevant when creating a ZIP
+        """
+        super().__init__(self, **kwargs)
+        if mode not in set("rwa"):
+            raise ValueError(f"mode '{mode}' no understood")
+        self.mode = mode
+        if isinstance(fo, str):
+            if mode == "a":
+                m = "r+b"
+            else:
+                m = mode + "b"
+            fo = fsspec.open(
+                fo, mode=m, protocol=target_protocol, **(target_options or {})
+            )
+        self.force_zip_64 = allowZip64
+        self.of = fo
+        self.fo = fo.__enter__()  # the whole instance is a context
+        self.zip = zipfile.ZipFile(
+            self.fo,
+            mode=mode,
+            compression=compression,
+            allowZip64=allowZip64,
+            compresslevel=compresslevel,
+        )
+        self.dir_cache = None
+
+    @classmethod
+    def _strip_protocol(cls, path):
+        # zip file paths are always relative to the archive root
+        return super()._strip_protocol(path).lstrip("/")
+
+    def __del__(self):
+        if hasattr(self, "zip"):
+            self.close()
+            del self.zip
+
+    def close(self):
+        """Commits any write changes to the file. Done on ``del`` too."""
+        self.zip.close()
+
+    def _get_dirs(self):
+        if self.dir_cache is None or self.mode in set("wa"):
+            # when writing, dir_cache is always in the ZipFile's attributes,
+            # not read from the file.
+            files = self.zip.infolist()
+            self.dir_cache = {
+                dirname.rstrip("/"): {
+                    "name": dirname.rstrip("/"),
+                    "size": 0,
+                    "type": "directory",
+                }
+                for dirname in self._all_dirnames(self.zip.namelist())
+            }
+            for z in files:
+                f = {s: getattr(z, s, None) for s in zipfile.ZipInfo.__slots__}
+                f.update(
+                    {
+                        "name": z.filename.rstrip("/"),
+                        "size": z.file_size,
+                        "type": ("directory" if z.is_dir() else "file"),
+                    }
+                )
+                self.dir_cache[f["name"]] = f
+
+    def pipe_file(self, path, value, **kwargs):
+        # override upstream, because we know the exact file size in this case
+        self.zip.writestr(path, value, **kwargs)
+
+    def _open(
+        self,
+        path,
+        mode="rb",
+        block_size=None,
+        autocommit=True,
+        cache_options=None,
+        **kwargs,
+    ):
+        path = self._strip_protocol(path)
+        if "r" in mode and self.mode in set("wa"):
+            if self.exists(path):
+                raise OSError("ZipFS can only be open for reading or writing, not both")
+            raise FileNotFoundError(path)
+        if "r" in self.mode and "w" in mode:
+            raise OSError("ZipFS can only be open for reading or writing, not both")
+        out = self.zip.open(path, mode.strip("b"), force_zip64=self.force_zip_64)
+        if "r" in mode:
+            info = self.info(path)
+            out.size = info["size"]
+            out.name = info["name"]
+        return out
diff --git a/llm/Lib/site-packages/fsspec/mapping.py b/llm/Lib/site-packages/fsspec/mapping.py
new file mode 100644
index 0000000000000000000000000000000000000000..93ebd1df3a127ab1ad7d0d218cdb4fe0217f44bd
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/mapping.py
@@ -0,0 +1,251 @@
+import array
+import logging
+import posixpath
+import warnings
+from collections.abc import MutableMapping
+from functools import cached_property
+
+from fsspec.core import url_to_fs
+
+logger = logging.getLogger("fsspec.mapping")
+
+
+class FSMap(MutableMapping):
+    """Wrap a FileSystem instance as a mutable wrapping.
+
+    The keys of the mapping become files under the given root, and the
+    values (which must be bytes) the contents of those files.
+
+    Parameters
+    ----------
+    root: string
+        prefix for all the files
+    fs: FileSystem instance
+    check: bool (=True)
+        performs a touch at the location, to check for write access.
+
+    Examples
+    --------
+    >>> fs = FileSystem(**parameters)  # doctest: +SKIP
+    >>> d = FSMap('my-data/path/', fs)  # doctest: +SKIP
+    or, more likely
+    >>> d = fs.get_mapper('my-data/path/')
+
+    >>> d['loc1'] = b'Hello World'  # doctest: +SKIP
+    >>> list(d.keys())  # doctest: +SKIP
+    ['loc1']
+    >>> d['loc1']  # doctest: +SKIP
+    b'Hello World'
+    """
+
+    def __init__(self, root, fs, check=False, create=False, missing_exceptions=None):
+        self.fs = fs
+        self.root = fs._strip_protocol(root)
+        self._root_key_to_str = fs._strip_protocol(posixpath.join(root, "x"))[:-1]
+        if missing_exceptions is None:
+            missing_exceptions = (
+                FileNotFoundError,
+                IsADirectoryError,
+                NotADirectoryError,
+            )
+        self.missing_exceptions = missing_exceptions
+        self.check = check
+        self.create = create
+        if create:
+            if not self.fs.exists(root):
+                self.fs.mkdir(root)
+        if check:
+            if not self.fs.exists(root):
+                raise ValueError(
+                    f"Path {root} does not exist. Create "
+                    f" with the ``create=True`` keyword"
+                )
+            self.fs.touch(root + "/a")
+            self.fs.rm(root + "/a")
+
+    @cached_property
+    def dirfs(self):
+        """dirfs instance that can be used with the same keys as the mapper"""
+        from .implementations.dirfs import DirFileSystem
+
+        return DirFileSystem(path=self._root_key_to_str, fs=self.fs)
+
+    def clear(self):
+        """Remove all keys below root - empties out mapping"""
+        logger.info("Clear mapping at %s", self.root)
+        try:
+            self.fs.rm(self.root, True)
+            self.fs.mkdir(self.root)
+        except:  # noqa: E722
+            pass
+
+    def getitems(self, keys, on_error="raise"):
+        """Fetch multiple items from the store
+
+        If the backend is async-able, this might proceed concurrently
+
+        Parameters
+        ----------
+        keys: list(str)
+            They keys to be fetched
+        on_error : "raise", "omit", "return"
+            If raise, an underlying exception will be raised (converted to KeyError
+            if the type is in self.missing_exceptions); if omit, keys with exception
+            will simply not be included in the output; if "return", all keys are
+            included in the output, but the value will be bytes or an exception
+            instance.
+
+        Returns
+        -------
+        dict(key, bytes|exception)
+        """
+        keys2 = [self._key_to_str(k) for k in keys]
+        oe = on_error if on_error == "raise" else "return"
+        try:
+            out = self.fs.cat(keys2, on_error=oe)
+            if isinstance(out, bytes):
+                out = {keys2[0]: out}
+        except self.missing_exceptions as e:
+            raise KeyError from e
+        out = {
+            k: (KeyError() if isinstance(v, self.missing_exceptions) else v)
+            for k, v in out.items()
+        }
+        return {
+            key: out[k2]
+            for key, k2 in zip(keys, keys2)
+            if on_error == "return" or not isinstance(out[k2], BaseException)
+        }
+
+    def setitems(self, values_dict):
+        """Set the values of multiple items in the store
+
+        Parameters
+        ----------
+        values_dict: dict(str, bytes)
+        """
+        values = {self._key_to_str(k): maybe_convert(v) for k, v in values_dict.items()}
+        self.fs.pipe(values)
+
+    def delitems(self, keys):
+        """Remove multiple keys from the store"""
+        self.fs.rm([self._key_to_str(k) for k in keys])
+
+    def _key_to_str(self, key):
+        """Generate full path for the key"""
+        if not isinstance(key, str):
+            # raise TypeError("key must be of type `str`, got `{type(key).__name__}`"
+            warnings.warn(
+                "from fsspec 2023.5 onward FSMap non-str keys will raise TypeError",
+                DeprecationWarning,
+            )
+            if isinstance(key, list):
+                key = tuple(key)
+            key = str(key)
+        return f"{self._root_key_to_str}{key}".rstrip("/")
+
+    def _str_to_key(self, s):
+        """Strip path of to leave key name"""
+        return s[len(self.root) :].lstrip("/")
+
+    def __getitem__(self, key, default=None):
+        """Retrieve data"""
+        k = self._key_to_str(key)
+        try:
+            result = self.fs.cat(k)
+        except self.missing_exceptions:
+            if default is not None:
+                return default
+            raise KeyError(key)
+        return result
+
+    def pop(self, key, default=None):
+        """Pop data"""
+        result = self.__getitem__(key, default)
+        try:
+            del self[key]
+        except KeyError:
+            pass
+        return result
+
+    def __setitem__(self, key, value):
+        """Store value in key"""
+        key = self._key_to_str(key)
+        self.fs.mkdirs(self.fs._parent(key), exist_ok=True)
+        self.fs.pipe_file(key, maybe_convert(value))
+
+    def __iter__(self):
+        return (self._str_to_key(x) for x in self.fs.find(self.root))
+
+    def __len__(self):
+        return len(self.fs.find(self.root))
+
+    def __delitem__(self, key):
+        """Remove key"""
+        try:
+            self.fs.rm(self._key_to_str(key))
+        except:  # noqa: E722
+            raise KeyError
+
+    def __contains__(self, key):
+        """Does key exist in mapping?"""
+        path = self._key_to_str(key)
+        return self.fs.isfile(path)
+
+    def __reduce__(self):
+        return FSMap, (self.root, self.fs, False, False, self.missing_exceptions)
+
+
+def maybe_convert(value):
+    if isinstance(value, array.array) or hasattr(value, "__array__"):
+        # bytes-like things
+        if hasattr(value, "dtype") and value.dtype.kind in "Mm":
+            # The buffer interface doesn't support datetime64/timdelta64 numpy
+            # arrays
+            value = value.view("int64")
+        value = bytes(memoryview(value))
+    return value
+
+
+def get_mapper(
+    url="",
+    check=False,
+    create=False,
+    missing_exceptions=None,
+    alternate_root=None,
+    **kwargs,
+):
+    """Create key-value interface for given URL and options
+
+    The URL will be of the form "protocol://location" and point to the root
+    of the mapper required. All keys will be file-names below this location,
+    and their values the contents of each key.
+
+    Also accepts compound URLs like zip::s3://bucket/file.zip , see ``fsspec.open``.
+
+    Parameters
+    ----------
+    url: str
+        Root URL of mapping
+    check: bool
+        Whether to attempt to read from the location before instantiation, to
+        check that the mapping does exist
+    create: bool
+        Whether to make the directory corresponding to the root before
+        instantiating
+    missing_exceptions: None or tuple
+        If given, these exception types will be regarded as missing keys and
+        return KeyError when trying to read data. By default, you get
+        (FileNotFoundError, IsADirectoryError, NotADirectoryError)
+    alternate_root: None or str
+        In cases of complex URLs, the parser may fail to pick the correct part
+        for the mapper root, so this arg can override
+
+    Returns
+    -------
+    ``FSMap`` instance, the dict-like key-value store.
+    """
+    # Removing protocol here - could defer to each open() on the backend
+    fs, urlpath = url_to_fs(url, **kwargs)
+    root = alternate_root if alternate_root is not None else urlpath
+    return FSMap(root, fs, check, create, missing_exceptions=missing_exceptions)
diff --git a/llm/Lib/site-packages/fsspec/parquet.py b/llm/Lib/site-packages/fsspec/parquet.py
new file mode 100644
index 0000000000000000000000000000000000000000..bb4625c629fcf1f55b79e17187ccc749495e6b4f
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/parquet.py
@@ -0,0 +1,549 @@
+import io
+import json
+import warnings
+
+from .core import url_to_fs
+from .utils import merge_offset_ranges
+
+# Parquet-Specific Utilities for fsspec
+#
+# Most of the functions defined in this module are NOT
+# intended for public consumption. The only exception
+# to this is `open_parquet_file`, which should be used
+# place of `fs.open()` to open parquet-formatted files
+# on remote file systems.
+
+
+def open_parquet_file(
+    path,
+    mode="rb",
+    fs=None,
+    metadata=None,
+    columns=None,
+    row_groups=None,
+    storage_options=None,
+    strict=False,
+    engine="auto",
+    max_gap=64_000,
+    max_block=256_000_000,
+    footer_sample_size=1_000_000,
+    **kwargs,
+):
+    """
+    Return a file-like object for a single Parquet file.
+
+    The specified parquet `engine` will be used to parse the
+    footer metadata, and determine the required byte ranges
+    from the file. The target path will then be opened with
+    the "parts" (`KnownPartsOfAFile`) caching strategy.
+
+    Note that this method is intended for usage with remote
+    file systems, and is unlikely to improve parquet-read
+    performance on local file systems.
+
+    Parameters
+    ----------
+    path: str
+        Target file path.
+    mode: str, optional
+        Mode option to be passed through to `fs.open`. Default is "rb".
+    metadata: Any, optional
+        Parquet metadata object. Object type must be supported
+        by the backend parquet engine. For now, only the "fastparquet"
+        engine supports an explicit `ParquetFile` metadata object.
+        If a metadata object is supplied, the remote footer metadata
+        will not need to be transferred into local memory.
+    fs: AbstractFileSystem, optional
+        Filesystem object to use for opening the file. If nothing is
+        specified, an `AbstractFileSystem` object will be inferred.
+    engine : str, default "auto"
+        Parquet engine to use for metadata parsing. Allowed options
+        include "fastparquet", "pyarrow", and "auto". The specified
+        engine must be installed in the current environment. If
+        "auto" is specified, and both engines are installed,
+        "fastparquet" will take precedence over "pyarrow".
+    columns: list, optional
+        List of all column names that may be read from the file.
+    row_groups : list, optional
+        List of all row-groups that may be read from the file. This
+        may be a list of row-group indices (integers), or it may be
+        a list of `RowGroup` metadata objects (if the "fastparquet"
+        engine is used).
+    storage_options : dict, optional
+        Used to generate an `AbstractFileSystem` object if `fs` was
+        not specified.
+    strict : bool, optional
+        Whether the resulting `KnownPartsOfAFile` cache should
+        fetch reads that go beyond a known byte-range boundary.
+        If `False` (the default), any read that ends outside a
+        known part will be zero padded. Note that using
+        `strict=True` may be useful for debugging.
+    max_gap : int, optional
+        Neighboring byte ranges will only be merged when their
+        inter-range gap is <= `max_gap`. Default is 64KB.
+    max_block : int, optional
+        Neighboring byte ranges will only be merged when the size of
+        the aggregated range is <= `max_block`. Default is 256MB.
+    footer_sample_size : int, optional
+        Number of bytes to read from the end of the path to look
+        for the footer metadata. If the sampled bytes do not contain
+        the footer, a second read request will be required, and
+        performance will suffer. Default is 1MB.
+    **kwargs :
+        Optional key-word arguments to pass to `fs.open`
+    """
+
+    # Make sure we have an `AbstractFileSystem` object
+    # to work with
+    if fs is None:
+        fs = url_to_fs(path, **(storage_options or {}))[0]
+
+    # For now, `columns == []` not supported. Just use
+    # default `open` command with `path` input
+    if columns is not None and len(columns) == 0:
+        return fs.open(path, mode=mode)
+
+    # Set the engine
+    engine = _set_engine(engine)
+
+    # Fetch the known byte ranges needed to read
+    # `columns` and/or `row_groups`
+    data = _get_parquet_byte_ranges(
+        [path],
+        fs,
+        metadata=metadata,
+        columns=columns,
+        row_groups=row_groups,
+        engine=engine,
+        max_gap=max_gap,
+        max_block=max_block,
+        footer_sample_size=footer_sample_size,
+    )
+
+    # Extract file name from `data`
+    fn = next(iter(data)) if data else path
+
+    # Call self.open with "parts" caching
+    options = kwargs.pop("cache_options", {}).copy()
+    return fs.open(
+        fn,
+        mode=mode,
+        cache_type="parts",
+        cache_options={
+            **options,
+            "data": data.get(fn, {}),
+            "strict": strict,
+        },
+        **kwargs,
+    )
+
+
+def _get_parquet_byte_ranges(
+    paths,
+    fs,
+    metadata=None,
+    columns=None,
+    row_groups=None,
+    max_gap=64_000,
+    max_block=256_000_000,
+    footer_sample_size=1_000_000,
+    engine="auto",
+):
+    """Get a dictionary of the known byte ranges needed
+    to read a specific column/row-group selection from a
+    Parquet dataset. Each value in the output dictionary
+    is intended for use as the `data` argument for the
+    `KnownPartsOfAFile` caching strategy of a single path.
+    """
+
+    # Set engine if necessary
+    if isinstance(engine, str):
+        engine = _set_engine(engine)
+
+    # Pass to specialized function if metadata is defined
+    if metadata is not None:
+
+        # Use the provided parquet metadata object
+        # to avoid transferring/parsing footer metadata
+        return _get_parquet_byte_ranges_from_metadata(
+            metadata,
+            fs,
+            engine,
+            columns=columns,
+            row_groups=row_groups,
+            max_gap=max_gap,
+            max_block=max_block,
+        )
+
+    # Get file sizes asynchronously
+    file_sizes = fs.sizes(paths)
+
+    # Populate global paths, starts, & ends
+    result = {}
+    data_paths = []
+    data_starts = []
+    data_ends = []
+    add_header_magic = True
+    if columns is None and row_groups is None:
+        # We are NOT selecting specific columns or row-groups.
+        #
+        # We can avoid sampling the footers, and just transfer
+        # all file data with cat_ranges
+        for i, path in enumerate(paths):
+            result[path] = {}
+            for b in range(0, file_sizes[i], max_block):
+                data_paths.append(path)
+                data_starts.append(b)
+                data_ends.append(min(b + max_block, file_sizes[i]))
+        add_header_magic = False  # "Magic" should already be included
+    else:
+        # We ARE selecting specific columns or row-groups.
+        #
+        # Gather file footers.
+        # We just take the last `footer_sample_size` bytes of each
+        # file (or the entire file if it is smaller than that)
+        footer_starts = []
+        footer_ends = []
+        for i, path in enumerate(paths):
+            footer_ends.append(file_sizes[i])
+            sample_size = max(0, file_sizes[i] - footer_sample_size)
+            footer_starts.append(sample_size)
+        footer_samples = fs.cat_ranges(paths, footer_starts, footer_ends)
+
+        # Check our footer samples and re-sample if necessary.
+        missing_footer_starts = footer_starts.copy()
+        large_footer = 0
+        for i, path in enumerate(paths):
+            footer_size = int.from_bytes(footer_samples[i][-8:-4], "little")
+            real_footer_start = file_sizes[i] - (footer_size + 8)
+            if real_footer_start < footer_starts[i]:
+                missing_footer_starts[i] = real_footer_start
+                large_footer = max(large_footer, (footer_size + 8))
+        if large_footer:
+            warnings.warn(
+                f"Not enough data was used to sample the parquet footer. "
+                f"Try setting footer_sample_size >= {large_footer}."
+            )
+            for i, block in enumerate(
+                fs.cat_ranges(
+                    paths,
+                    missing_footer_starts,
+                    footer_starts,
+                )
+            ):
+                footer_samples[i] = block + footer_samples[i]
+                footer_starts[i] = missing_footer_starts[i]
+
+        # Calculate required byte ranges for each path
+        for i, path in enumerate(paths):
+
+            # Deal with small-file case.
+            # Just include all remaining bytes of the file
+            # in a single range.
+            if file_sizes[i] < max_block:
+                if footer_starts[i] > 0:
+                    # Only need to transfer the data if the
+                    # footer sample isn't already the whole file
+                    data_paths.append(path)
+                    data_starts.append(0)
+                    data_ends.append(footer_starts[i])
+                continue
+
+            # Use "engine" to collect data byte ranges
+            path_data_starts, path_data_ends = engine._parquet_byte_ranges(
+                columns,
+                row_groups=row_groups,
+                footer=footer_samples[i],
+                footer_start=footer_starts[i],
+            )
+
+            data_paths += [path] * len(path_data_starts)
+            data_starts += path_data_starts
+            data_ends += path_data_ends
+
+        # Merge adjacent offset ranges
+        data_paths, data_starts, data_ends = merge_offset_ranges(
+            data_paths,
+            data_starts,
+            data_ends,
+            max_gap=max_gap,
+            max_block=max_block,
+            sort=False,  # Should already be sorted
+        )
+
+        # Start by populating `result` with footer samples
+        for i, path in enumerate(paths):
+            result[path] = {(footer_starts[i], footer_ends[i]): footer_samples[i]}
+
+    # Transfer the data byte-ranges into local memory
+    _transfer_ranges(fs, result, data_paths, data_starts, data_ends)
+
+    # Add b"PAR1" to header if necessary
+    if add_header_magic:
+        _add_header_magic(result)
+
+    return result
+
+
+def _get_parquet_byte_ranges_from_metadata(
+    metadata,
+    fs,
+    engine,
+    columns=None,
+    row_groups=None,
+    max_gap=64_000,
+    max_block=256_000_000,
+):
+    """Simplified version of `_get_parquet_byte_ranges` for
+    the case that an engine-specific `metadata` object is
+    provided, and the remote footer metadata does not need to
+    be transferred before calculating the required byte ranges.
+    """
+
+    # Use "engine" to collect data byte ranges
+    data_paths, data_starts, data_ends = engine._parquet_byte_ranges(
+        columns,
+        row_groups=row_groups,
+        metadata=metadata,
+    )
+
+    # Merge adjacent offset ranges
+    data_paths, data_starts, data_ends = merge_offset_ranges(
+        data_paths,
+        data_starts,
+        data_ends,
+        max_gap=max_gap,
+        max_block=max_block,
+        sort=False,  # Should be sorted
+    )
+
+    # Transfer the data byte-ranges into local memory
+    result = {fn: {} for fn in list(set(data_paths))}
+    _transfer_ranges(fs, result, data_paths, data_starts, data_ends)
+
+    # Add b"PAR1" to header
+    _add_header_magic(result)
+
+    return result
+
+
+def _transfer_ranges(fs, blocks, paths, starts, ends):
+    # Use cat_ranges to gather the data byte_ranges
+    ranges = (paths, starts, ends)
+    for path, start, stop, data in zip(*ranges, fs.cat_ranges(*ranges)):
+        blocks[path][(start, stop)] = data
+
+
+def _add_header_magic(data):
+    # Add b"PAR1" to file headers
+    for path in list(data.keys()):
+        add_magic = True
+        for k in data[path].keys():
+            if k[0] == 0 and k[1] >= 4:
+                add_magic = False
+                break
+        if add_magic:
+            data[path][(0, 4)] = b"PAR1"
+
+
+def _set_engine(engine_str):
+
+    # Define a list of parquet engines to try
+    if engine_str == "auto":
+        try_engines = ("fastparquet", "pyarrow")
+    elif not isinstance(engine_str, str):
+        raise ValueError(
+            "Failed to set parquet engine! "
+            "Please pass 'fastparquet', 'pyarrow', or 'auto'"
+        )
+    elif engine_str not in ("fastparquet", "pyarrow"):
+        raise ValueError(f"{engine_str} engine not supported by `fsspec.parquet`")
+    else:
+        try_engines = [engine_str]
+
+    # Try importing the engines in `try_engines`,
+    # and choose the first one that succeeds
+    for engine in try_engines:
+        try:
+            if engine == "fastparquet":
+                return FastparquetEngine()
+            elif engine == "pyarrow":
+                return PyarrowEngine()
+        except ImportError:
+            pass
+
+    # Raise an error if a supported parquet engine
+    # was not found
+    raise ImportError(
+        f"The following parquet engines are not installed "
+        f"in your python environment: {try_engines}."
+        f"Please install 'fastparquert' or 'pyarrow' to "
+        f"utilize the `fsspec.parquet` module."
+    )
+
+
+class FastparquetEngine:
+
+    # The purpose of the FastparquetEngine class is
+    # to check if fastparquet can be imported (on initialization)
+    # and to define a `_parquet_byte_ranges` method. In the
+    # future, this class may also be used to define other
+    # methods/logic that are specific to fastparquet.
+
+    def __init__(self):
+        import fastparquet as fp
+
+        self.fp = fp
+
+    def _row_group_filename(self, row_group, pf):
+        return pf.row_group_filename(row_group)
+
+    def _parquet_byte_ranges(
+        self,
+        columns,
+        row_groups=None,
+        metadata=None,
+        footer=None,
+        footer_start=None,
+    ):
+
+        # Initialize offset ranges and define ParqetFile metadata
+        pf = metadata
+        data_paths, data_starts, data_ends = [], [], []
+        if pf is None:
+            pf = self.fp.ParquetFile(io.BytesIO(footer))
+
+        # Convert columns to a set and add any index columns
+        # specified in the pandas metadata (just in case)
+        column_set = None if columns is None else set(columns)
+        if column_set is not None and hasattr(pf, "pandas_metadata"):
+            md_index = [
+                ind
+                for ind in pf.pandas_metadata.get("index_columns", [])
+                # Ignore RangeIndex information
+                if not isinstance(ind, dict)
+            ]
+            column_set |= set(md_index)
+
+        # Check if row_groups is a list of integers
+        # or a list of row-group metadata
+        if row_groups and not isinstance(row_groups[0], int):
+            # Input row_groups contains row-group metadata
+            row_group_indices = None
+        else:
+            # Input row_groups contains row-group indices
+            row_group_indices = row_groups
+            row_groups = pf.row_groups
+
+        # Loop through column chunks to add required byte ranges
+        for r, row_group in enumerate(row_groups):
+            # Skip this row-group if we are targeting
+            # specific row-groups
+            if row_group_indices is None or r in row_group_indices:
+
+                # Find the target parquet-file path for `row_group`
+                fn = self._row_group_filename(row_group, pf)
+
+                for column in row_group.columns:
+                    name = column.meta_data.path_in_schema[0]
+                    # Skip this column if we are targeting a
+                    # specific columns
+                    if column_set is None or name in column_set:
+                        file_offset0 = column.meta_data.dictionary_page_offset
+                        if file_offset0 is None:
+                            file_offset0 = column.meta_data.data_page_offset
+                        num_bytes = column.meta_data.total_compressed_size
+                        if footer_start is None or file_offset0 < footer_start:
+                            data_paths.append(fn)
+                            data_starts.append(file_offset0)
+                            data_ends.append(
+                                min(
+                                    file_offset0 + num_bytes,
+                                    footer_start or (file_offset0 + num_bytes),
+                                )
+                            )
+
+        if metadata:
+            # The metadata in this call may map to multiple
+            # file paths. Need to include `data_paths`
+            return data_paths, data_starts, data_ends
+        return data_starts, data_ends
+
+
+class PyarrowEngine:
+
+    # The purpose of the PyarrowEngine class is
+    # to check if pyarrow can be imported (on initialization)
+    # and to define a `_parquet_byte_ranges` method. In the
+    # future, this class may also be used to define other
+    # methods/logic that are specific to pyarrow.
+
+    def __init__(self):
+        import pyarrow.parquet as pq
+
+        self.pq = pq
+
+    def _row_group_filename(self, row_group, metadata):
+        raise NotImplementedError
+
+    def _parquet_byte_ranges(
+        self,
+        columns,
+        row_groups=None,
+        metadata=None,
+        footer=None,
+        footer_start=None,
+    ):
+
+        if metadata is not None:
+            raise ValueError("metadata input not supported for PyarrowEngine")
+
+        data_starts, data_ends = [], []
+        md = self.pq.ParquetFile(io.BytesIO(footer)).metadata
+
+        # Convert columns to a set and add any index columns
+        # specified in the pandas metadata (just in case)
+        column_set = None if columns is None else set(columns)
+        if column_set is not None:
+            schema = md.schema.to_arrow_schema()
+            has_pandas_metadata = (
+                schema.metadata is not None and b"pandas" in schema.metadata
+            )
+            if has_pandas_metadata:
+                md_index = [
+                    ind
+                    for ind in json.loads(
+                        schema.metadata[b"pandas"].decode("utf8")
+                    ).get("index_columns", [])
+                    # Ignore RangeIndex information
+                    if not isinstance(ind, dict)
+                ]
+                column_set |= set(md_index)
+
+        # Loop through column chunks to add required byte ranges
+        for r in range(md.num_row_groups):
+            # Skip this row-group if we are targeting
+            # specific row-groups
+            if row_groups is None or r in row_groups:
+                row_group = md.row_group(r)
+                for c in range(row_group.num_columns):
+                    column = row_group.column(c)
+                    name = column.path_in_schema
+                    # Skip this column if we are targeting a
+                    # specific columns
+                    split_name = name.split(".")[0]
+                    if (
+                        column_set is None
+                        or name in column_set
+                        or split_name in column_set
+                    ):
+                        file_offset0 = column.dictionary_page_offset
+                        if file_offset0 is None:
+                            file_offset0 = column.data_page_offset
+                        num_bytes = column.total_compressed_size
+                        if file_offset0 < footer_start:
+                            data_starts.append(file_offset0)
+                            data_ends.append(
+                                min(file_offset0 + num_bytes, footer_start)
+                            )
+        return data_starts, data_ends
diff --git a/llm/Lib/site-packages/fsspec/registry.py b/llm/Lib/site-packages/fsspec/registry.py
new file mode 100644
index 0000000000000000000000000000000000000000..8a36e0948332e324a41487efc757bc1b0acc50c6
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/registry.py
@@ -0,0 +1,301 @@
+from __future__ import annotations
+
+import importlib
+import types
+import warnings
+
+__all__ = ["registry", "get_filesystem_class", "default"]
+
+# internal, mutable
+_registry: dict[str, type] = {}
+
+# external, immutable
+registry = types.MappingProxyType(_registry)
+default = "file"
+
+
+def register_implementation(name, cls, clobber=False, errtxt=None):
+    """Add implementation class to the registry
+
+    Parameters
+    ----------
+    name: str
+        Protocol name to associate with the class
+    cls: class or str
+        if a class: fsspec-compliant implementation class (normally inherits from
+        ``fsspec.AbstractFileSystem``, gets added straight to the registry. If a
+        str, the full path to an implementation class like package.module.class,
+        which gets added to known_implementations,
+        so the import is deferred until the filesystem is actually used.
+    clobber: bool (optional)
+        Whether to overwrite a protocol with the same name; if False, will raise
+        instead.
+    errtxt: str (optional)
+        If given, then a failure to import the given class will result in this
+        text being given.
+    """
+    if isinstance(cls, str):
+        if name in known_implementations and clobber is False:
+            if cls != known_implementations[name]["class"]:
+                raise ValueError(
+                    f"Name ({name}) already in the known_implementations and clobber "
+                    f"is False"
+                )
+        else:
+            known_implementations[name] = {
+                "class": cls,
+                "err": errtxt or f"{cls} import failed for protocol {name}",
+            }
+
+    else:
+        if name in registry and clobber is False:
+            if _registry[name] is not cls:
+                raise ValueError(
+                    f"Name ({name}) already in the registry and clobber is False"
+                )
+        else:
+            _registry[name] = cls
+
+
+# protocols mapped to the class which implements them. This dict can be
+# updated with register_implementation
+known_implementations = {
+    "abfs": {
+        "class": "adlfs.AzureBlobFileSystem",
+        "err": "Install adlfs to access Azure Datalake Gen2 and Azure Blob Storage",
+    },
+    "adl": {
+        "class": "adlfs.AzureDatalakeFileSystem",
+        "err": "Install adlfs to access Azure Datalake Gen1",
+    },
+    "arrow_hdfs": {
+        "class": "fsspec.implementations.arrow.HadoopFileSystem",
+        "err": "pyarrow and local java libraries required for HDFS",
+    },
+    "asynclocal": {
+        "class": "morefs.asyn_local.AsyncLocalFileSystem",
+        "err": "Install 'morefs[asynclocalfs]' to use AsyncLocalFileSystem",
+    },
+    "az": {
+        "class": "adlfs.AzureBlobFileSystem",
+        "err": "Install adlfs to access Azure Datalake Gen2 and Azure Blob Storage",
+    },
+    "blockcache": {"class": "fsspec.implementations.cached.CachingFileSystem"},
+    "box": {
+        "class": "boxfs.BoxFileSystem",
+        "err": "Please install boxfs to access BoxFileSystem",
+    },
+    "cached": {"class": "fsspec.implementations.cached.CachingFileSystem"},
+    "dask": {
+        "class": "fsspec.implementations.dask.DaskWorkerFileSystem",
+        "err": "Install dask distributed to access worker file system",
+    },
+    "data": {"class": "fsspec.implementations.data.DataFileSystem"},
+    "dbfs": {
+        "class": "fsspec.implementations.dbfs.DatabricksFileSystem",
+        "err": "Install the requests package to use the DatabricksFileSystem",
+    },
+    "dir": {"class": "fsspec.implementations.dirfs.DirFileSystem"},
+    "dropbox": {
+        "class": "dropboxdrivefs.DropboxDriveFileSystem",
+        "err": (
+            'DropboxFileSystem requires "dropboxdrivefs","requests" and "'
+            '"dropbox" to be installed'
+        ),
+    },
+    "dvc": {
+        "class": "dvc.api.DVCFileSystem",
+        "err": "Install dvc to access DVCFileSystem",
+    },
+    "file": {"class": "fsspec.implementations.local.LocalFileSystem"},
+    "filecache": {"class": "fsspec.implementations.cached.WholeFileCacheFileSystem"},
+    "ftp": {"class": "fsspec.implementations.ftp.FTPFileSystem"},
+    "gcs": {
+        "class": "gcsfs.GCSFileSystem",
+        "err": "Please install gcsfs to access Google Storage",
+    },
+    "gdrive": {
+        "class": "gdrivefs.GoogleDriveFileSystem",
+        "err": "Please install gdrivefs for access to Google Drive",
+    },
+    "generic": {"class": "fsspec.generic.GenericFileSystem"},
+    "git": {
+        "class": "fsspec.implementations.git.GitFileSystem",
+        "err": "Install pygit2 to browse local git repos",
+    },
+    "github": {
+        "class": "fsspec.implementations.github.GithubFileSystem",
+        "err": "Install the requests package to use the github FS",
+    },
+    "gs": {
+        "class": "gcsfs.GCSFileSystem",
+        "err": "Please install gcsfs to access Google Storage",
+    },
+    "hdfs": {
+        "class": "fsspec.implementations.arrow.HadoopFileSystem",
+        "err": "pyarrow and local java libraries required for HDFS",
+    },
+    "hf": {
+        "class": "huggingface_hub.HfFileSystem",
+        "err": "Install huggingface_hub to access HfFileSystem",
+    },
+    "http": {
+        "class": "fsspec.implementations.http.HTTPFileSystem",
+        "err": 'HTTPFileSystem requires "requests" and "aiohttp" to be installed',
+    },
+    "https": {
+        "class": "fsspec.implementations.http.HTTPFileSystem",
+        "err": 'HTTPFileSystem requires "requests" and "aiohttp" to be installed',
+    },
+    "jlab": {
+        "class": "fsspec.implementations.jupyter.JupyterFileSystem",
+        "err": "Jupyter FS requires requests to be installed",
+    },
+    "jupyter": {
+        "class": "fsspec.implementations.jupyter.JupyterFileSystem",
+        "err": "Jupyter FS requires requests to be installed",
+    },
+    "lakefs": {
+        "class": "lakefs_spec.LakeFSFileSystem",
+        "err": "Please install lakefs-spec to access LakeFSFileSystem",
+    },
+    "libarchive": {
+        "class": "fsspec.implementations.libarchive.LibArchiveFileSystem",
+        "err": "LibArchive requires to be installed",
+    },
+    "local": {"class": "fsspec.implementations.local.LocalFileSystem"},
+    "memory": {"class": "fsspec.implementations.memory.MemoryFileSystem"},
+    "oci": {
+        "class": "ocifs.OCIFileSystem",
+        "err": "Install ocifs to access OCI Object Storage",
+    },
+    "ocilake": {
+        "class": "ocifs.OCIFileSystem",
+        "err": "Install ocifs to access OCI Data Lake",
+    },
+    "oss": {
+        "class": "ossfs.OSSFileSystem",
+        "err": "Install ossfs to access Alibaba Object Storage System",
+    },
+    "reference": {"class": "fsspec.implementations.reference.ReferenceFileSystem"},
+    "root": {
+        "class": "fsspec_xrootd.XRootDFileSystem",
+        "err": (
+            "Install fsspec-xrootd to access xrootd storage system. "
+            "Note: 'root' is the protocol name for xrootd storage systems, "
+            "not referring to root directories"
+        ),
+    },
+    "s3": {"class": "s3fs.S3FileSystem", "err": "Install s3fs to access S3"},
+    "s3a": {"class": "s3fs.S3FileSystem", "err": "Install s3fs to access S3"},
+    "sftp": {
+        "class": "fsspec.implementations.sftp.SFTPFileSystem",
+        "err": 'SFTPFileSystem requires "paramiko" to be installed',
+    },
+    "simplecache": {"class": "fsspec.implementations.cached.SimpleCacheFileSystem"},
+    "smb": {
+        "class": "fsspec.implementations.smb.SMBFileSystem",
+        "err": 'SMB requires "smbprotocol" or "smbprotocol[kerberos]" installed',
+    },
+    "ssh": {
+        "class": "fsspec.implementations.sftp.SFTPFileSystem",
+        "err": 'SFTPFileSystem requires "paramiko" to be installed',
+    },
+    "tar": {"class": "fsspec.implementations.tar.TarFileSystem"},
+    "wandb": {"class": "wandbfs.WandbFS", "err": "Install wandbfs to access wandb"},
+    "webdav": {
+        "class": "webdav4.fsspec.WebdavFileSystem",
+        "err": "Install webdav4 to access WebDAV",
+    },
+    "webhdfs": {
+        "class": "fsspec.implementations.webhdfs.WebHDFS",
+        "err": 'webHDFS access requires "requests" to be installed',
+    },
+    "zip": {"class": "fsspec.implementations.zip.ZipFileSystem"},
+}
+
+
+def get_filesystem_class(protocol):
+    """Fetch named protocol implementation from the registry
+
+    The dict ``known_implementations`` maps protocol names to the locations
+    of classes implementing the corresponding file-system. When used for the
+    first time, appropriate imports will happen and the class will be placed in
+    the registry. All subsequent calls will fetch directly from the registry.
+
+    Some protocol implementations require additional dependencies, and so the
+    import may fail. In this case, the string in the "err" field of the
+    ``known_implementations`` will be given as the error message.
+    """
+    if not protocol:
+        protocol = default
+
+    if protocol not in registry:
+        if protocol not in known_implementations:
+            raise ValueError(f"Protocol not known: {protocol}")
+        bit = known_implementations[protocol]
+        try:
+            register_implementation(protocol, _import_class(bit["class"]))
+        except ImportError as e:
+            raise ImportError(bit["err"]) from e
+    cls = registry[protocol]
+    if getattr(cls, "protocol", None) in ("abstract", None):
+        cls.protocol = protocol
+
+    return cls
+
+
+s3_msg = """Your installed version of s3fs is very old and known to cause
+severe performance issues, see also https://github.com/dask/dask/issues/10276
+
+To fix, you should specify a lower version bound on s3fs, or
+update the current installation.
+"""
+
+
+def _import_class(cls, minv=None):
+    """Take a string FQP and return the imported class or identifier
+
+    cls is of the form "package.module.klass" or "package.module:subobject.klass"
+    """
+    if ":" in cls:
+        mod, name = cls.rsplit(":", 1)
+        s3 = mod == "s3fs"
+        mod = importlib.import_module(mod)
+        if s3 and mod.__version__.split(".") < ["0", "5"]:
+            warnings.warn(s3_msg)
+        for part in name.split("."):
+            mod = getattr(mod, part)
+        return mod
+    else:
+        mod, name = cls.rsplit(".", 1)
+        s3 = mod == "s3fs"
+        mod = importlib.import_module(mod)
+        if s3 and mod.__version__.split(".") < ["0", "5"]:
+            warnings.warn(s3_msg)
+        return getattr(mod, name)
+
+
+def filesystem(protocol, **storage_options):
+    """Instantiate filesystems for given protocol and arguments
+
+    ``storage_options`` are specific to the protocol being chosen, and are
+    passed directly to the class.
+    """
+    if protocol == "arrow_hdfs":
+        warnings.warn(
+            "The 'arrow_hdfs' protocol has been deprecated and will be "
+            "removed in the future. Specify it as 'hdfs'.",
+            DeprecationWarning,
+        )
+
+    cls = get_filesystem_class(protocol)
+    return cls(**storage_options)
+
+
+def available_protocols():
+    """Return a list of the implemented protocols.
+
+    Note that any given protocol may require extra packages to be importable.
+    """
+    return list(known_implementations)
diff --git a/llm/Lib/site-packages/fsspec/spec.py b/llm/Lib/site-packages/fsspec/spec.py
new file mode 100644
index 0000000000000000000000000000000000000000..39ee91a16786570533ebdf03f847819610251136
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/spec.py
@@ -0,0 +1,1965 @@
+from __future__ import annotations
+
+import io
+import logging
+import os
+import threading
+import warnings
+import weakref
+from errno import ESPIPE
+from glob import has_magic
+from hashlib import sha256
+from typing import ClassVar
+
+from .callbacks import DEFAULT_CALLBACK
+from .config import apply_config, conf
+from .dircache import DirCache
+from .transaction import Transaction
+from .utils import (
+    _unstrip_protocol,
+    glob_translate,
+    isfilelike,
+    other_paths,
+    read_block,
+    stringify_path,
+    tokenize,
+)
+
+logger = logging.getLogger("fsspec")
+
+
+def make_instance(cls, args, kwargs):
+    return cls(*args, **kwargs)
+
+
+class _Cached(type):
+    """
+    Metaclass for caching file system instances.
+
+    Notes
+    -----
+    Instances are cached according to
+
+    * The values of the class attributes listed in `_extra_tokenize_attributes`
+    * The arguments passed to ``__init__``.
+
+    This creates an additional reference to the filesystem, which prevents the
+    filesystem from being garbage collected when all *user* references go away.
+    A call to the :meth:`AbstractFileSystem.clear_instance_cache` must *also*
+    be made for a filesystem instance to be garbage collected.
+    """
+
+    def __init__(cls, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        # Note: we intentionally create a reference here, to avoid garbage
+        # collecting instances when all other references are gone. To really
+        # delete a FileSystem, the cache must be cleared.
+        if conf.get("weakref_instance_cache"):  # pragma: no cover
+            # debug option for analysing fork/spawn conditions
+            cls._cache = weakref.WeakValueDictionary()
+        else:
+            cls._cache = {}
+        cls._pid = os.getpid()
+
+    def __call__(cls, *args, **kwargs):
+        kwargs = apply_config(cls, kwargs)
+        extra_tokens = tuple(
+            getattr(cls, attr, None) for attr in cls._extra_tokenize_attributes
+        )
+        token = tokenize(
+            cls, cls._pid, threading.get_ident(), *args, *extra_tokens, **kwargs
+        )
+        skip = kwargs.pop("skip_instance_cache", False)
+        if os.getpid() != cls._pid:
+            cls._cache.clear()
+            cls._pid = os.getpid()
+        if not skip and cls.cachable and token in cls._cache:
+            cls._latest = token
+            return cls._cache[token]
+        else:
+            obj = super().__call__(*args, **kwargs)
+            # Setting _fs_token here causes some static linters to complain.
+            obj._fs_token_ = token
+            obj.storage_args = args
+            obj.storage_options = kwargs
+            if obj.async_impl and obj.mirror_sync_methods:
+                from .asyn import mirror_sync_methods
+
+                mirror_sync_methods(obj)
+
+            if cls.cachable and not skip:
+                cls._latest = token
+                cls._cache[token] = obj
+            return obj
+
+
+class AbstractFileSystem(metaclass=_Cached):
+    """
+    An abstract super-class for pythonic file-systems
+
+    Implementations are expected to be compatible with or, better, subclass
+    from here.
+    """
+
+    cachable = True  # this class can be cached, instances reused
+    _cached = False
+    blocksize = 2**22
+    sep = "/"
+    protocol: ClassVar[str | tuple[str, ...]] = "abstract"
+    _latest = None
+    async_impl = False
+    mirror_sync_methods = False
+    root_marker = ""  # For some FSs, may require leading '/' or other character
+    transaction_type = Transaction
+
+    #: Extra *class attributes* that should be considered when hashing.
+    _extra_tokenize_attributes = ()
+
+    def __init__(self, *args, **storage_options):
+        """Create and configure file-system instance
+
+        Instances may be cachable, so if similar enough arguments are seen
+        a new instance is not required. The token attribute exists to allow
+        implementations to cache instances if they wish.
+
+        A reasonable default should be provided if there are no arguments.
+
+        Subclasses should call this method.
+
+        Parameters
+        ----------
+        use_listings_cache, listings_expiry_time, max_paths:
+            passed to ``DirCache``, if the implementation supports
+            directory listing caching. Pass use_listings_cache=False
+            to disable such caching.
+        skip_instance_cache: bool
+            If this is a cachable implementation, pass True here to force
+            creating a new instance even if a matching instance exists, and prevent
+            storing this instance.
+        asynchronous: bool
+        loop: asyncio-compatible IOLoop or None
+        """
+        if self._cached:
+            # reusing instance, don't change
+            return
+        self._cached = True
+        self._intrans = False
+        self._transaction = None
+        self._invalidated_caches_in_transaction = []
+        self.dircache = DirCache(**storage_options)
+
+        if storage_options.pop("add_docs", None):
+            warnings.warn("add_docs is no longer supported.", FutureWarning)
+
+        if storage_options.pop("add_aliases", None):
+            warnings.warn("add_aliases has been removed.", FutureWarning)
+        # This is set in _Cached
+        self._fs_token_ = None
+
+    @property
+    def fsid(self):
+        """Persistent filesystem id that can be used to compare filesystems
+        across sessions.
+        """
+        raise NotImplementedError
+
+    @property
+    def _fs_token(self):
+        return self._fs_token_
+
+    def __dask_tokenize__(self):
+        return self._fs_token
+
+    def __hash__(self):
+        return int(self._fs_token, 16)
+
+    def __eq__(self, other):
+        return isinstance(other, type(self)) and self._fs_token == other._fs_token
+
+    def __reduce__(self):
+        return make_instance, (type(self), self.storage_args, self.storage_options)
+
+    @classmethod
+    def _strip_protocol(cls, path):
+        """Turn path from fully-qualified to file-system-specific
+
+        May require FS-specific handling, e.g., for relative paths or links.
+        """
+        if isinstance(path, list):
+            return [cls._strip_protocol(p) for p in path]
+        path = stringify_path(path)
+        protos = (cls.protocol,) if isinstance(cls.protocol, str) else cls.protocol
+        for protocol in protos:
+            if path.startswith(protocol + "://"):
+                path = path[len(protocol) + 3 :]
+            elif path.startswith(protocol + "::"):
+                path = path[len(protocol) + 2 :]
+        path = path.rstrip("/")
+        # use of root_marker to make minimum required path, e.g., "/"
+        return path or cls.root_marker
+
+    def unstrip_protocol(self, name: str) -> str:
+        """Format FS-specific path to generic, including protocol"""
+        protos = (self.protocol,) if isinstance(self.protocol, str) else self.protocol
+        for protocol in protos:
+            if name.startswith(f"{protocol}://"):
+                return name
+        return f"{protos[0]}://{name}"
+
+    @staticmethod
+    def _get_kwargs_from_urls(path):
+        """If kwargs can be encoded in the paths, extract them here
+
+        This should happen before instantiation of the class; incoming paths
+        then should be amended to strip the options in methods.
+
+        Examples may look like an sftp path "sftp://user@host:/my/path", where
+        the user and host should become kwargs and later get stripped.
+        """
+        # by default, nothing happens
+        return {}
+
+    @classmethod
+    def current(cls):
+        """Return the most recently instantiated FileSystem
+
+        If no instance has been created, then create one with defaults
+        """
+        if cls._latest in cls._cache:
+            return cls._cache[cls._latest]
+        return cls()
+
+    @property
+    def transaction(self):
+        """A context within which files are committed together upon exit
+
+        Requires the file class to implement `.commit()` and `.discard()`
+        for the normal and exception cases.
+        """
+        if self._transaction is None:
+            self._transaction = self.transaction_type(self)
+        return self._transaction
+
+    def start_transaction(self):
+        """Begin write transaction for deferring files, non-context version"""
+        self._intrans = True
+        self._transaction = self.transaction_type(self)
+        return self.transaction
+
+    def end_transaction(self):
+        """Finish write transaction, non-context version"""
+        self.transaction.complete()
+        self._transaction = None
+        # The invalid cache must be cleared after the transaction is completed.
+        for path in self._invalidated_caches_in_transaction:
+            self.invalidate_cache(path)
+        self._invalidated_caches_in_transaction.clear()
+
+    def invalidate_cache(self, path=None):
+        """
+        Discard any cached directory information
+
+        Parameters
+        ----------
+        path: string or None
+            If None, clear all listings cached else listings at or under given
+            path.
+        """
+        # Not necessary to implement invalidation mechanism, may have no cache.
+        # But if have, you should call this method of parent class from your
+        # subclass to ensure expiring caches after transacations correctly.
+        # See the implementation of FTPFileSystem in ftp.py
+        if self._intrans:
+            self._invalidated_caches_in_transaction.append(path)
+
+    def mkdir(self, path, create_parents=True, **kwargs):
+        """
+        Create directory entry at path
+
+        For systems that don't have true directories, may create an for
+        this instance only and not touch the real filesystem
+
+        Parameters
+        ----------
+        path: str
+            location
+        create_parents: bool
+            if True, this is equivalent to ``makedirs``
+        kwargs:
+            may be permissions, etc.
+        """
+        pass  # not necessary to implement, may not have directories
+
+    def makedirs(self, path, exist_ok=False):
+        """Recursively make directories
+
+        Creates directory at path and any intervening required directories.
+        Raises exception if, for instance, the path already exists but is a
+        file.
+
+        Parameters
+        ----------
+        path: str
+            leaf directory name
+        exist_ok: bool (False)
+            If False, will error if the target already exists
+        """
+        pass  # not necessary to implement, may not have directories
+
+    def rmdir(self, path):
+        """Remove a directory, if empty"""
+        pass  # not necessary to implement, may not have directories
+
+    def ls(self, path, detail=True, **kwargs):
+        """List objects at path.
+
+        This should include subdirectories and files at that location. The
+        difference between a file and a directory must be clear when details
+        are requested.
+
+        The specific keys, or perhaps a FileInfo class, or similar, is TBD,
+        but must be consistent across implementations.
+        Must include:
+
+        - full path to the entry (without protocol)
+        - size of the entry, in bytes. If the value cannot be determined, will
+          be ``None``.
+        - type of entry, "file", "directory" or other
+
+        Additional information
+        may be present, appropriate to the file-system, e.g., generation,
+        checksum, etc.
+
+        May use refresh=True|False to allow use of self._ls_from_cache to
+        check for a saved listing and avoid calling the backend. This would be
+        common where listing may be expensive.
+
+        Parameters
+        ----------
+        path: str
+        detail: bool
+            if True, gives a list of dictionaries, where each is the same as
+            the result of ``info(path)``. If False, gives a list of paths
+            (str).
+        kwargs: may have additional backend-specific options, such as version
+            information
+
+        Returns
+        -------
+        List of strings if detail is False, or list of directory information
+        dicts if detail is True.
+        """
+        raise NotImplementedError
+
+    def _ls_from_cache(self, path):
+        """Check cache for listing
+
+        Returns listing, if found (may be empty list for a directly that exists
+        but contains nothing), None if not in cache.
+        """
+        parent = self._parent(path)
+        if path.rstrip("/") in self.dircache:
+            return self.dircache[path.rstrip("/")]
+        try:
+            files = [
+                f
+                for f in self.dircache[parent]
+                if f["name"] == path
+                or (f["name"] == path.rstrip("/") and f["type"] == "directory")
+            ]
+            if len(files) == 0:
+                # parent dir was listed but did not contain this file
+                raise FileNotFoundError(path)
+            return files
+        except KeyError:
+            pass
+
+    def walk(self, path, maxdepth=None, topdown=True, on_error="omit", **kwargs):
+        """Return all files belows path
+
+        List all files, recursing into subdirectories; output is iterator-style,
+        like ``os.walk()``. For a simple list of files, ``find()`` is available.
+
+        When topdown is True, the caller can modify the dirnames list in-place (perhaps
+        using del or slice assignment), and walk() will
+        only recurse into the subdirectories whose names remain in dirnames;
+        this can be used to prune the search, impose a specific order of visiting,
+        or even to inform walk() about directories the caller creates or renames before
+        it resumes walk() again.
+        Modifying dirnames when topdown is False has no effect. (see os.walk)
+
+        Note that the "files" outputted will include anything that is not
+        a directory, such as links.
+
+        Parameters
+        ----------
+        path: str
+            Root to recurse into
+        maxdepth: int
+            Maximum recursion depth. None means limitless, but not recommended
+            on link-based file-systems.
+        topdown: bool (True)
+            Whether to walk the directory tree from the top downwards or from
+            the bottom upwards.
+        on_error: "omit", "raise", a collable
+            if omit (default), path with exception will simply be empty;
+            If raise, an underlying exception will be raised;
+            if callable, it will be called with a single OSError instance as argument
+        kwargs: passed to ``ls``
+        """
+        if maxdepth is not None and maxdepth < 1:
+            raise ValueError("maxdepth must be at least 1")
+
+        path = self._strip_protocol(path)
+        full_dirs = {}
+        dirs = {}
+        files = {}
+
+        detail = kwargs.pop("detail", False)
+        try:
+            listing = self.ls(path, detail=True, **kwargs)
+        except (FileNotFoundError, OSError) as e:
+            if on_error == "raise":
+                raise
+            elif callable(on_error):
+                on_error(e)
+            if detail:
+                return path, {}, {}
+            return path, [], []
+
+        for info in listing:
+            # each info name must be at least [path]/part , but here
+            # we check also for names like [path]/part/
+            pathname = info["name"].rstrip("/")
+            name = pathname.rsplit("/", 1)[-1]
+            if info["type"] == "directory" and pathname != path:
+                # do not include "self" path
+                full_dirs[name] = pathname
+                dirs[name] = info
+            elif pathname == path:
+                # file-like with same name as give path
+                files[""] = info
+            else:
+                files[name] = info
+
+        if not detail:
+            dirs = list(dirs)
+            files = list(files)
+
+        if topdown:
+            # Yield before recursion if walking top down
+            yield path, dirs, files
+
+        if maxdepth is not None:
+            maxdepth -= 1
+            if maxdepth < 1:
+                if not topdown:
+                    yield path, dirs, files
+                return
+
+        for d in dirs:
+            yield from self.walk(
+                full_dirs[d],
+                maxdepth=maxdepth,
+                detail=detail,
+                topdown=topdown,
+                **kwargs,
+            )
+
+        if not topdown:
+            # Yield after recursion if walking bottom up
+            yield path, dirs, files
+
+    def find(self, path, maxdepth=None, withdirs=False, detail=False, **kwargs):
+        """List all files below path.
+
+        Like posix ``find`` command without conditions
+
+        Parameters
+        ----------
+        path : str
+        maxdepth: int or None
+            If not None, the maximum number of levels to descend
+        withdirs: bool
+            Whether to include directory paths in the output. This is True
+            when used by glob, but users usually only want files.
+        kwargs are passed to ``ls``.
+        """
+        # TODO: allow equivalent of -name parameter
+        path = self._strip_protocol(path)
+        out = {}
+
+        # Add the root directory if withdirs is requested
+        # This is needed for posix glob compliance
+        if withdirs and path != "" and self.isdir(path):
+            out[path] = self.info(path)
+
+        for _, dirs, files in self.walk(path, maxdepth, detail=True, **kwargs):
+            if withdirs:
+                files.update(dirs)
+            out.update({info["name"]: info for name, info in files.items()})
+        if not out and self.isfile(path):
+            # walk works on directories, but find should also return [path]
+            # when path happens to be a file
+            out[path] = {}
+        names = sorted(out)
+        if not detail:
+            return names
+        else:
+            return {name: out[name] for name in names}
+
+    def du(self, path, total=True, maxdepth=None, withdirs=False, **kwargs):
+        """Space used by files and optionally directories within a path
+
+        Directory size does not include the size of its contents.
+
+        Parameters
+        ----------
+        path: str
+        total: bool
+            Whether to sum all the file sizes
+        maxdepth: int or None
+            Maximum number of directory levels to descend, None for unlimited.
+        withdirs: bool
+            Whether to include directory paths in the output.
+        kwargs: passed to ``find``
+
+        Returns
+        -------
+        Dict of {path: size} if total=False, or int otherwise, where numbers
+        refer to bytes used.
+        """
+        sizes = {}
+        if withdirs and self.isdir(path):
+            # Include top-level directory in output
+            info = self.info(path)
+            sizes[info["name"]] = info["size"]
+        for f in self.find(path, maxdepth=maxdepth, withdirs=withdirs, **kwargs):
+            info = self.info(f)
+            sizes[info["name"]] = info["size"]
+        if total:
+            return sum(sizes.values())
+        else:
+            return sizes
+
+    def glob(self, path, maxdepth=None, **kwargs):
+        """
+        Find files by glob-matching.
+
+        If the path ends with '/', only folders are returned.
+
+        We support ``"**"``,
+        ``"?"`` and ``"[..]"``. We do not support ^ for pattern negation.
+
+        The `maxdepth` option is applied on the first `**` found in the path.
+
+        kwargs are passed to ``ls``.
+        """
+        if maxdepth is not None and maxdepth < 1:
+            raise ValueError("maxdepth must be at least 1")
+
+        import re
+
+        seps = (os.path.sep, os.path.altsep) if os.path.altsep else (os.path.sep,)
+        ends_with_sep = path.endswith(seps)  # _strip_protocol strips trailing slash
+        path = self._strip_protocol(path)
+        append_slash_to_dirname = ends_with_sep or path.endswith(
+            tuple(sep + "**" for sep in seps)
+        )
+        idx_star = path.find("*") if path.find("*") >= 0 else len(path)
+        idx_qmark = path.find("?") if path.find("?") >= 0 else len(path)
+        idx_brace = path.find("[") if path.find("[") >= 0 else len(path)
+
+        min_idx = min(idx_star, idx_qmark, idx_brace)
+
+        detail = kwargs.pop("detail", False)
+
+        if not has_magic(path):
+            if self.exists(path, **kwargs):
+                if not detail:
+                    return [path]
+                else:
+                    return {path: self.info(path, **kwargs)}
+            else:
+                if not detail:
+                    return []  # glob of non-existent returns empty
+                else:
+                    return {}
+        elif "/" in path[:min_idx]:
+            min_idx = path[:min_idx].rindex("/")
+            root = path[: min_idx + 1]
+            depth = path[min_idx + 1 :].count("/") + 1
+        else:
+            root = ""
+            depth = path[min_idx + 1 :].count("/") + 1
+
+        if "**" in path:
+            if maxdepth is not None:
+                idx_double_stars = path.find("**")
+                depth_double_stars = path[idx_double_stars:].count("/") + 1
+                depth = depth - depth_double_stars + maxdepth
+            else:
+                depth = None
+
+        allpaths = self.find(root, maxdepth=depth, withdirs=True, detail=True, **kwargs)
+
+        pattern = glob_translate(path + ("/" if ends_with_sep else ""))
+        pattern = re.compile(pattern)
+
+        out = {
+            p: info
+            for p, info in sorted(allpaths.items())
+            if pattern.match(
+                (
+                    p + "/"
+                    if append_slash_to_dirname and info["type"] == "directory"
+                    else p
+                )
+            )
+        }
+
+        if detail:
+            return out
+        else:
+            return list(out)
+
+    def exists(self, path, **kwargs):
+        """Is there a file at the given path"""
+        try:
+            self.info(path, **kwargs)
+            return True
+        except:  # noqa: E722
+            # any exception allowed bar FileNotFoundError?
+            return False
+
+    def lexists(self, path, **kwargs):
+        """If there is a file at the given path (including
+        broken links)"""
+        return self.exists(path)
+
+    def info(self, path, **kwargs):
+        """Give details of entry at path
+
+        Returns a single dictionary, with exactly the same information as ``ls``
+        would with ``detail=True``.
+
+        The default implementation should calls ls and could be overridden by a
+        shortcut. kwargs are passed on to ```ls()``.
+
+        Some file systems might not be able to measure the file's size, in
+        which case, the returned dict will include ``'size': None``.
+
+        Returns
+        -------
+        dict with keys: name (full path in the FS), size (in bytes), type (file,
+        directory, or something else) and other FS-specific keys.
+        """
+        path = self._strip_protocol(path)
+        out = self.ls(self._parent(path), detail=True, **kwargs)
+        out = [o for o in out if o["name"].rstrip("/") == path]
+        if out:
+            return out[0]
+        out = self.ls(path, detail=True, **kwargs)
+        path = path.rstrip("/")
+        out1 = [o for o in out if o["name"].rstrip("/") == path]
+        if len(out1) == 1:
+            if "size" not in out1[0]:
+                out1[0]["size"] = None
+            return out1[0]
+        elif len(out1) > 1 or out:
+            return {"name": path, "size": 0, "type": "directory"}
+        else:
+            raise FileNotFoundError(path)
+
+    def checksum(self, path):
+        """Unique value for current version of file
+
+        If the checksum is the same from one moment to another, the contents
+        are guaranteed to be the same. If the checksum changes, the contents
+        *might* have changed.
+
+        This should normally be overridden; default will probably capture
+        creation/modification timestamp (which would be good) or maybe
+        access timestamp (which would be bad)
+        """
+        return int(tokenize(self.info(path)), 16)
+
+    def size(self, path):
+        """Size in bytes of file"""
+        return self.info(path).get("size", None)
+
+    def sizes(self, paths):
+        """Size in bytes of each file in a list of paths"""
+        return [self.size(p) for p in paths]
+
+    def isdir(self, path):
+        """Is this entry directory-like?"""
+        try:
+            return self.info(path)["type"] == "directory"
+        except OSError:
+            return False
+
+    def isfile(self, path):
+        """Is this entry file-like?"""
+        try:
+            return self.info(path)["type"] == "file"
+        except:  # noqa: E722
+            return False
+
+    def read_text(self, path, encoding=None, errors=None, newline=None, **kwargs):
+        """Get the contents of the file as a string.
+
+        Parameters
+        ----------
+        path: str
+            URL of file on this filesystems
+        encoding, errors, newline: same as `open`.
+        """
+        with self.open(
+            path,
+            mode="r",
+            encoding=encoding,
+            errors=errors,
+            newline=newline,
+            **kwargs,
+        ) as f:
+            return f.read()
+
+    def write_text(
+        self, path, value, encoding=None, errors=None, newline=None, **kwargs
+    ):
+        """Write the text to the given file.
+
+        An existing file will be overwritten.
+
+        Parameters
+        ----------
+        path: str
+            URL of file on this filesystems
+        value: str
+            Text to write.
+        encoding, errors, newline: same as `open`.
+        """
+        with self.open(
+            path,
+            mode="w",
+            encoding=encoding,
+            errors=errors,
+            newline=newline,
+            **kwargs,
+        ) as f:
+            return f.write(value)
+
+    def cat_file(self, path, start=None, end=None, **kwargs):
+        """Get the content of a file
+
+        Parameters
+        ----------
+        path: URL of file on this filesystems
+        start, end: int
+            Bytes limits of the read. If negative, backwards from end,
+            like usual python slices. Either can be None for start or
+            end of file, respectively
+        kwargs: passed to ``open()``.
+        """
+        # explicitly set buffering off?
+        with self.open(path, "rb", **kwargs) as f:
+            if start is not None:
+                if start >= 0:
+                    f.seek(start)
+                else:
+                    f.seek(max(0, f.size + start))
+            if end is not None:
+                if end < 0:
+                    end = f.size + end
+                return f.read(end - f.tell())
+            return f.read()
+
+    def pipe_file(self, path, value, **kwargs):
+        """Set the bytes of given file"""
+        with self.open(path, "wb", **kwargs) as f:
+            f.write(value)
+
+    def pipe(self, path, value=None, **kwargs):
+        """Put value into path
+
+        (counterpart to ``cat``)
+
+        Parameters
+        ----------
+        path: string or dict(str, bytes)
+            If a string, a single remote location to put ``value`` bytes; if a dict,
+            a mapping of {path: bytesvalue}.
+        value: bytes, optional
+            If using a single path, these are the bytes to put there. Ignored if
+            ``path`` is a dict
+        """
+        if isinstance(path, str):
+            self.pipe_file(self._strip_protocol(path), value, **kwargs)
+        elif isinstance(path, dict):
+            for k, v in path.items():
+                self.pipe_file(self._strip_protocol(k), v, **kwargs)
+        else:
+            raise ValueError("path must be str or dict")
+
+    def cat_ranges(
+        self, paths, starts, ends, max_gap=None, on_error="return", **kwargs
+    ):
+        """Get the contents of byte ranges from one or more files
+
+        Parameters
+        ----------
+        paths: list
+            A list of of filepaths on this filesystems
+        starts, ends: int or list
+            Bytes limits of the read. If using a single int, the same value will be
+            used to read all the specified files.
+        """
+        if max_gap is not None:
+            raise NotImplementedError
+        if not isinstance(paths, list):
+            raise TypeError
+        if not isinstance(starts, list):
+            starts = [starts] * len(paths)
+        if not isinstance(ends, list):
+            ends = [ends] * len(paths)
+        if len(starts) != len(paths) or len(ends) != len(paths):
+            raise ValueError
+        out = []
+        for p, s, e in zip(paths, starts, ends):
+            try:
+                out.append(self.cat_file(p, s, e))
+            except Exception as e:
+                if on_error == "return":
+                    out.append(e)
+                else:
+                    raise
+        return out
+
+    def cat(self, path, recursive=False, on_error="raise", **kwargs):
+        """Fetch (potentially multiple) paths' contents
+
+        Parameters
+        ----------
+        recursive: bool
+            If True, assume the path(s) are directories, and get all the
+            contained files
+        on_error : "raise", "omit", "return"
+            If raise, an underlying exception will be raised (converted to KeyError
+            if the type is in self.missing_exceptions); if omit, keys with exception
+            will simply not be included in the output; if "return", all keys are
+            included in the output, but the value will be bytes or an exception
+            instance.
+        kwargs: passed to cat_file
+
+        Returns
+        -------
+        dict of {path: contents} if there are multiple paths
+        or the path has been otherwise expanded
+        """
+        paths = self.expand_path(path, recursive=recursive)
+        if (
+            len(paths) > 1
+            or isinstance(path, list)
+            or paths[0] != self._strip_protocol(path)
+        ):
+            out = {}
+            for path in paths:
+                try:
+                    out[path] = self.cat_file(path, **kwargs)
+                except Exception as e:
+                    if on_error == "raise":
+                        raise
+                    if on_error == "return":
+                        out[path] = e
+            return out
+        else:
+            return self.cat_file(paths[0], **kwargs)
+
+    def get_file(self, rpath, lpath, callback=DEFAULT_CALLBACK, outfile=None, **kwargs):
+        """Copy single remote file to local"""
+        from .implementations.local import LocalFileSystem
+
+        if isfilelike(lpath):
+            outfile = lpath
+        elif self.isdir(rpath):
+            os.makedirs(lpath, exist_ok=True)
+            return None
+
+        fs = LocalFileSystem(auto_mkdir=True)
+        fs.makedirs(fs._parent(lpath), exist_ok=True)
+
+        with self.open(rpath, "rb", **kwargs) as f1:
+            if outfile is None:
+                outfile = open(lpath, "wb")
+
+            try:
+                callback.set_size(getattr(f1, "size", None))
+                data = True
+                while data:
+                    data = f1.read(self.blocksize)
+                    segment_len = outfile.write(data)
+                    if segment_len is None:
+                        segment_len = len(data)
+                    callback.relative_update(segment_len)
+            finally:
+                if not isfilelike(lpath):
+                    outfile.close()
+
+    def get(
+        self,
+        rpath,
+        lpath,
+        recursive=False,
+        callback=DEFAULT_CALLBACK,
+        maxdepth=None,
+        **kwargs,
+    ):
+        """Copy file(s) to local.
+
+        Copies a specific file or tree of files (if recursive=True). If lpath
+        ends with a "/", it will be assumed to be a directory, and target files
+        will go within. Can submit a list of paths, which may be glob-patterns
+        and will be expanded.
+
+        Calls get_file for each source.
+        """
+        if isinstance(lpath, list) and isinstance(rpath, list):
+            # No need to expand paths when both source and destination
+            # are provided as lists
+            rpaths = rpath
+            lpaths = lpath
+        else:
+            from .implementations.local import (
+                LocalFileSystem,
+                make_path_posix,
+                trailing_sep,
+            )
+
+            source_is_str = isinstance(rpath, str)
+            rpaths = self.expand_path(rpath, recursive=recursive, maxdepth=maxdepth)
+            if source_is_str and (not recursive or maxdepth is not None):
+                # Non-recursive glob does not copy directories
+                rpaths = [p for p in rpaths if not (trailing_sep(p) or self.isdir(p))]
+                if not rpaths:
+                    return
+
+            if isinstance(lpath, str):
+                lpath = make_path_posix(lpath)
+
+            source_is_file = len(rpaths) == 1
+            dest_is_dir = isinstance(lpath, str) and (
+                trailing_sep(lpath) or LocalFileSystem().isdir(lpath)
+            )
+
+            exists = source_is_str and (
+                (has_magic(rpath) and source_is_file)
+                or (not has_magic(rpath) and dest_is_dir and not trailing_sep(rpath))
+            )
+            lpaths = other_paths(
+                rpaths,
+                lpath,
+                exists=exists,
+                flatten=not source_is_str,
+            )
+
+        callback.set_size(len(lpaths))
+        for lpath, rpath in callback.wrap(zip(lpaths, rpaths)):
+            with callback.branched(rpath, lpath) as child:
+                self.get_file(rpath, lpath, callback=child, **kwargs)
+
+    def put_file(self, lpath, rpath, callback=DEFAULT_CALLBACK, **kwargs):
+        """Copy single file to remote"""
+        if os.path.isdir(lpath):
+            self.makedirs(rpath, exist_ok=True)
+            return None
+
+        with open(lpath, "rb") as f1:
+            size = f1.seek(0, 2)
+            callback.set_size(size)
+            f1.seek(0)
+
+            self.mkdirs(self._parent(os.fspath(rpath)), exist_ok=True)
+            with self.open(rpath, "wb", **kwargs) as f2:
+                while f1.tell() < size:
+                    data = f1.read(self.blocksize)
+                    segment_len = f2.write(data)
+                    if segment_len is None:
+                        segment_len = len(data)
+                    callback.relative_update(segment_len)
+
+    def put(
+        self,
+        lpath,
+        rpath,
+        recursive=False,
+        callback=DEFAULT_CALLBACK,
+        maxdepth=None,
+        **kwargs,
+    ):
+        """Copy file(s) from local.
+
+        Copies a specific file or tree of files (if recursive=True). If rpath
+        ends with a "/", it will be assumed to be a directory, and target files
+        will go within.
+
+        Calls put_file for each source.
+        """
+        if isinstance(lpath, list) and isinstance(rpath, list):
+            # No need to expand paths when both source and destination
+            # are provided as lists
+            rpaths = rpath
+            lpaths = lpath
+        else:
+            from .implementations.local import (
+                LocalFileSystem,
+                make_path_posix,
+                trailing_sep,
+            )
+
+            source_is_str = isinstance(lpath, str)
+            if source_is_str:
+                lpath = make_path_posix(lpath)
+            fs = LocalFileSystem()
+            lpaths = fs.expand_path(lpath, recursive=recursive, maxdepth=maxdepth)
+            if source_is_str and (not recursive or maxdepth is not None):
+                # Non-recursive glob does not copy directories
+                lpaths = [p for p in lpaths if not (trailing_sep(p) or fs.isdir(p))]
+                if not lpaths:
+                    return
+
+            source_is_file = len(lpaths) == 1
+            dest_is_dir = isinstance(rpath, str) and (
+                trailing_sep(rpath) or self.isdir(rpath)
+            )
+
+            rpath = (
+                self._strip_protocol(rpath)
+                if isinstance(rpath, str)
+                else [self._strip_protocol(p) for p in rpath]
+            )
+            exists = source_is_str and (
+                (has_magic(lpath) and source_is_file)
+                or (not has_magic(lpath) and dest_is_dir and not trailing_sep(lpath))
+            )
+            rpaths = other_paths(
+                lpaths,
+                rpath,
+                exists=exists,
+                flatten=not source_is_str,
+            )
+
+        callback.set_size(len(rpaths))
+        for lpath, rpath in callback.wrap(zip(lpaths, rpaths)):
+            with callback.branched(lpath, rpath) as child:
+                self.put_file(lpath, rpath, callback=child, **kwargs)
+
+    def head(self, path, size=1024):
+        """Get the first ``size`` bytes from file"""
+        with self.open(path, "rb") as f:
+            return f.read(size)
+
+    def tail(self, path, size=1024):
+        """Get the last ``size`` bytes from file"""
+        with self.open(path, "rb") as f:
+            f.seek(max(-size, -f.size), 2)
+            return f.read()
+
+    def cp_file(self, path1, path2, **kwargs):
+        raise NotImplementedError
+
+    def copy(
+        self, path1, path2, recursive=False, maxdepth=None, on_error=None, **kwargs
+    ):
+        """Copy within two locations in the filesystem
+
+        on_error : "raise", "ignore"
+            If raise, any not-found exceptions will be raised; if ignore any
+            not-found exceptions will cause the path to be skipped; defaults to
+            raise unless recursive is true, where the default is ignore
+        """
+        if on_error is None and recursive:
+            on_error = "ignore"
+        elif on_error is None:
+            on_error = "raise"
+
+        if isinstance(path1, list) and isinstance(path2, list):
+            # No need to expand paths when both source and destination
+            # are provided as lists
+            paths1 = path1
+            paths2 = path2
+        else:
+            from .implementations.local import trailing_sep
+
+            source_is_str = isinstance(path1, str)
+            paths1 = self.expand_path(path1, recursive=recursive, maxdepth=maxdepth)
+            if source_is_str and (not recursive or maxdepth is not None):
+                # Non-recursive glob does not copy directories
+                paths1 = [p for p in paths1 if not (trailing_sep(p) or self.isdir(p))]
+                if not paths1:
+                    return
+
+            source_is_file = len(paths1) == 1
+            dest_is_dir = isinstance(path2, str) and (
+                trailing_sep(path2) or self.isdir(path2)
+            )
+
+            exists = source_is_str and (
+                (has_magic(path1) and source_is_file)
+                or (not has_magic(path1) and dest_is_dir and not trailing_sep(path1))
+            )
+            paths2 = other_paths(
+                paths1,
+                path2,
+                exists=exists,
+                flatten=not source_is_str,
+            )
+
+        for p1, p2 in zip(paths1, paths2):
+            try:
+                self.cp_file(p1, p2, **kwargs)
+            except FileNotFoundError:
+                if on_error == "raise":
+                    raise
+
+    def expand_path(self, path, recursive=False, maxdepth=None, **kwargs):
+        """Turn one or more globs or directories into a list of all matching paths
+        to files or directories.
+
+        kwargs are passed to ``glob`` or ``find``, which may in turn call ``ls``
+        """
+
+        if maxdepth is not None and maxdepth < 1:
+            raise ValueError("maxdepth must be at least 1")
+
+        if isinstance(path, (str, os.PathLike)):
+            out = self.expand_path([path], recursive, maxdepth)
+        else:
+            out = set()
+            path = [self._strip_protocol(p) for p in path]
+            for p in path:
+                if has_magic(p):
+                    bit = set(self.glob(p, maxdepth=maxdepth, **kwargs))
+                    out |= bit
+                    if recursive:
+                        # glob call above expanded one depth so if maxdepth is defined
+                        # then decrement it in expand_path call below. If it is zero
+                        # after decrementing then avoid expand_path call.
+                        if maxdepth is not None and maxdepth <= 1:
+                            continue
+                        out |= set(
+                            self.expand_path(
+                                list(bit),
+                                recursive=recursive,
+                                maxdepth=maxdepth - 1 if maxdepth is not None else None,
+                                **kwargs,
+                            )
+                        )
+                    continue
+                elif recursive:
+                    rec = set(
+                        self.find(
+                            p, maxdepth=maxdepth, withdirs=True, detail=False, **kwargs
+                        )
+                    )
+                    out |= rec
+                if p not in out and (recursive is False or self.exists(p)):
+                    # should only check once, for the root
+                    out.add(p)
+        if not out:
+            raise FileNotFoundError(path)
+        return sorted(out)
+
+    def mv(self, path1, path2, recursive=False, maxdepth=None, **kwargs):
+        """Move file(s) from one location to another"""
+        if path1 == path2:
+            logger.debug("%s mv: The paths are the same, so no files were moved.", self)
+        else:
+            self.copy(path1, path2, recursive=recursive, maxdepth=maxdepth)
+            self.rm(path1, recursive=recursive)
+
+    def rm_file(self, path):
+        """Delete a file"""
+        self._rm(path)
+
+    def _rm(self, path):
+        """Delete one file"""
+        # this is the old name for the method, prefer rm_file
+        raise NotImplementedError
+
+    def rm(self, path, recursive=False, maxdepth=None):
+        """Delete files.
+
+        Parameters
+        ----------
+        path: str or list of str
+            File(s) to delete.
+        recursive: bool
+            If file(s) are directories, recursively delete contents and then
+            also remove the directory
+        maxdepth: int or None
+            Depth to pass to walk for finding files to delete, if recursive.
+            If None, there will be no limit and infinite recursion may be
+            possible.
+        """
+        path = self.expand_path(path, recursive=recursive, maxdepth=maxdepth)
+        for p in reversed(path):
+            self.rm_file(p)
+
+    @classmethod
+    def _parent(cls, path):
+        path = cls._strip_protocol(path)
+        if "/" in path:
+            parent = path.rsplit("/", 1)[0].lstrip(cls.root_marker)
+            return cls.root_marker + parent
+        else:
+            return cls.root_marker
+
+    def _open(
+        self,
+        path,
+        mode="rb",
+        block_size=None,
+        autocommit=True,
+        cache_options=None,
+        **kwargs,
+    ):
+        """Return raw bytes-mode file-like from the file-system"""
+        return AbstractBufferedFile(
+            self,
+            path,
+            mode,
+            block_size,
+            autocommit,
+            cache_options=cache_options,
+            **kwargs,
+        )
+
+    def open(
+        self,
+        path,
+        mode="rb",
+        block_size=None,
+        cache_options=None,
+        compression=None,
+        **kwargs,
+    ):
+        """
+        Return a file-like object from the filesystem
+
+        The resultant instance must function correctly in a context ``with``
+        block.
+
+        Parameters
+        ----------
+        path: str
+            Target file
+        mode: str like 'rb', 'w'
+            See builtin ``open()``
+        block_size: int
+            Some indication of buffering - this is a value in bytes
+        cache_options : dict, optional
+            Extra arguments to pass through to the cache.
+        compression: string or None
+            If given, open file using compression codec. Can either be a compression
+            name (a key in ``fsspec.compression.compr``) or "infer" to guess the
+            compression from the filename suffix.
+        encoding, errors, newline: passed on to TextIOWrapper for text mode
+        """
+        import io
+
+        path = self._strip_protocol(path)
+        if "b" not in mode:
+            mode = mode.replace("t", "") + "b"
+
+            text_kwargs = {
+                k: kwargs.pop(k)
+                for k in ["encoding", "errors", "newline"]
+                if k in kwargs
+            }
+            return io.TextIOWrapper(
+                self.open(
+                    path,
+                    mode,
+                    block_size=block_size,
+                    cache_options=cache_options,
+                    compression=compression,
+                    **kwargs,
+                ),
+                **text_kwargs,
+            )
+        else:
+            ac = kwargs.pop("autocommit", not self._intrans)
+            f = self._open(
+                path,
+                mode=mode,
+                block_size=block_size,
+                autocommit=ac,
+                cache_options=cache_options,
+                **kwargs,
+            )
+            if compression is not None:
+                from fsspec.compression import compr
+                from fsspec.core import get_compression
+
+                compression = get_compression(path, compression)
+                compress = compr[compression]
+                f = compress(f, mode=mode[0])
+
+            if not ac and "r" not in mode:
+                self.transaction.files.append(f)
+            return f
+
+    def touch(self, path, truncate=True, **kwargs):
+        """Create empty file, or update timestamp
+
+        Parameters
+        ----------
+        path: str
+            file location
+        truncate: bool
+            If True, always set file size to 0; if False, update timestamp and
+            leave file unchanged, if backend allows this
+        """
+        if truncate or not self.exists(path):
+            with self.open(path, "wb", **kwargs):
+                pass
+        else:
+            raise NotImplementedError  # update timestamp, if possible
+
+    def ukey(self, path):
+        """Hash of file properties, to tell if it has changed"""
+        return sha256(str(self.info(path)).encode()).hexdigest()
+
+    def read_block(self, fn, offset, length, delimiter=None):
+        """Read a block of bytes from
+
+        Starting at ``offset`` of the file, read ``length`` bytes.  If
+        ``delimiter`` is set then we ensure that the read starts and stops at
+        delimiter boundaries that follow the locations ``offset`` and ``offset
+        + length``.  If ``offset`` is zero then we start at zero.  The
+        bytestring returned WILL include the end delimiter string.
+
+        If offset+length is beyond the eof, reads to eof.
+
+        Parameters
+        ----------
+        fn: string
+            Path to filename
+        offset: int
+            Byte offset to start read
+        length: int
+            Number of bytes to read. If None, read to end.
+        delimiter: bytes (optional)
+            Ensure reading starts and stops at delimiter bytestring
+
+        Examples
+        --------
+        >>> fs.read_block('data/file.csv', 0, 13)  # doctest: +SKIP
+        b'Alice, 100\\nBo'
+        >>> fs.read_block('data/file.csv', 0, 13, delimiter=b'\\n')  # doctest: +SKIP
+        b'Alice, 100\\nBob, 200\\n'
+
+        Use ``length=None`` to read to the end of the file.
+        >>> fs.read_block('data/file.csv', 0, None, delimiter=b'\\n')  # doctest: +SKIP
+        b'Alice, 100\\nBob, 200\\nCharlie, 300'
+
+        See Also
+        --------
+        :func:`fsspec.utils.read_block`
+        """
+        with self.open(fn, "rb") as f:
+            size = f.size
+            if length is None:
+                length = size
+            if size is not None and offset + length > size:
+                length = size - offset
+            return read_block(f, offset, length, delimiter)
+
+    def to_json(self):
+        """
+        JSON representation of this filesystem instance
+
+        Returns
+        -------
+        str: JSON structure with keys cls (the python location of this class),
+            protocol (text name of this class's protocol, first one in case of
+            multiple), args (positional args, usually empty), and all other
+            kwargs as their own keys.
+        """
+        import json
+
+        cls = type(self)
+        cls = ".".join((cls.__module__, cls.__name__))
+        proto = (
+            self.protocol[0]
+            if isinstance(self.protocol, (tuple, list))
+            else self.protocol
+        )
+        return json.dumps(
+            dict(
+                cls=cls,
+                protocol=proto,
+                args=self.storage_args,
+                **self.storage_options,
+            )
+        )
+
+    @staticmethod
+    def from_json(blob):
+        """
+        Recreate a filesystem instance from JSON representation
+
+        See ``.to_json()`` for the expected structure of the input
+
+        Parameters
+        ----------
+        blob: str
+
+        Returns
+        -------
+        file system instance, not necessarily of this particular class.
+        """
+        import json
+
+        from .registry import _import_class, get_filesystem_class
+
+        dic = json.loads(blob)
+        protocol = dic.pop("protocol")
+        try:
+            cls = _import_class(dic.pop("cls"))
+        except (ImportError, ValueError, RuntimeError, KeyError):
+            cls = get_filesystem_class(protocol)
+        return cls(*dic.pop("args", ()), **dic)
+
+    def _get_pyarrow_filesystem(self):
+        """
+        Make a version of the FS instance which will be acceptable to pyarrow
+        """
+        # all instances already also derive from pyarrow
+        return self
+
+    def get_mapper(self, root="", check=False, create=False, missing_exceptions=None):
+        """Create key/value store based on this file-system
+
+        Makes a MutableMapping interface to the FS at the given root path.
+        See ``fsspec.mapping.FSMap`` for further details.
+        """
+        from .mapping import FSMap
+
+        return FSMap(
+            root,
+            self,
+            check=check,
+            create=create,
+            missing_exceptions=missing_exceptions,
+        )
+
+    @classmethod
+    def clear_instance_cache(cls):
+        """
+        Clear the cache of filesystem instances.
+
+        Notes
+        -----
+        Unless overridden by setting the ``cachable`` class attribute to False,
+        the filesystem class stores a reference to newly created instances. This
+        prevents Python's normal rules around garbage collection from working,
+        since the instances refcount will not drop to zero until
+        ``clear_instance_cache`` is called.
+        """
+        cls._cache.clear()
+
+    def created(self, path):
+        """Return the created timestamp of a file as a datetime.datetime"""
+        raise NotImplementedError
+
+    def modified(self, path):
+        """Return the modified timestamp of a file as a datetime.datetime"""
+        raise NotImplementedError
+
+    # ------------------------------------------------------------------------
+    # Aliases
+
+    def read_bytes(self, path, start=None, end=None, **kwargs):
+        """Alias of `AbstractFileSystem.cat_file`."""
+        return self.cat_file(path, start=start, end=end, **kwargs)
+
+    def write_bytes(self, path, value, **kwargs):
+        """Alias of `AbstractFileSystem.pipe_file`."""
+        self.pipe_file(path, value, **kwargs)
+
+    def makedir(self, path, create_parents=True, **kwargs):
+        """Alias of `AbstractFileSystem.mkdir`."""
+        return self.mkdir(path, create_parents=create_parents, **kwargs)
+
+    def mkdirs(self, path, exist_ok=False):
+        """Alias of `AbstractFileSystem.makedirs`."""
+        return self.makedirs(path, exist_ok=exist_ok)
+
+    def listdir(self, path, detail=True, **kwargs):
+        """Alias of `AbstractFileSystem.ls`."""
+        return self.ls(path, detail=detail, **kwargs)
+
+    def cp(self, path1, path2, **kwargs):
+        """Alias of `AbstractFileSystem.copy`."""
+        return self.copy(path1, path2, **kwargs)
+
+    def move(self, path1, path2, **kwargs):
+        """Alias of `AbstractFileSystem.mv`."""
+        return self.mv(path1, path2, **kwargs)
+
+    def stat(self, path, **kwargs):
+        """Alias of `AbstractFileSystem.info`."""
+        return self.info(path, **kwargs)
+
+    def disk_usage(self, path, total=True, maxdepth=None, **kwargs):
+        """Alias of `AbstractFileSystem.du`."""
+        return self.du(path, total=total, maxdepth=maxdepth, **kwargs)
+
+    def rename(self, path1, path2, **kwargs):
+        """Alias of `AbstractFileSystem.mv`."""
+        return self.mv(path1, path2, **kwargs)
+
+    def delete(self, path, recursive=False, maxdepth=None):
+        """Alias of `AbstractFileSystem.rm`."""
+        return self.rm(path, recursive=recursive, maxdepth=maxdepth)
+
+    def upload(self, lpath, rpath, recursive=False, **kwargs):
+        """Alias of `AbstractFileSystem.put`."""
+        return self.put(lpath, rpath, recursive=recursive, **kwargs)
+
+    def download(self, rpath, lpath, recursive=False, **kwargs):
+        """Alias of `AbstractFileSystem.get`."""
+        return self.get(rpath, lpath, recursive=recursive, **kwargs)
+
+    def sign(self, path, expiration=100, **kwargs):
+        """Create a signed URL representing the given path
+
+        Some implementations allow temporary URLs to be generated, as a
+        way of delegating credentials.
+
+        Parameters
+        ----------
+        path : str
+             The path on the filesystem
+        expiration : int
+            Number of seconds to enable the URL for (if supported)
+
+        Returns
+        -------
+        URL : str
+            The signed URL
+
+        Raises
+        ------
+        NotImplementedError : if method is not implemented for a filesystem
+        """
+        raise NotImplementedError("Sign is not implemented for this filesystem")
+
+    def _isfilestore(self):
+        # Originally inherited from pyarrow DaskFileSystem. Keeping this
+        # here for backwards compatibility as long as pyarrow uses its
+        # legacy fsspec-compatible filesystems and thus accepts fsspec
+        # filesystems as well
+        return False
+
+
+class AbstractBufferedFile(io.IOBase):
+    """Convenient class to derive from to provide buffering
+
+    In the case that the backend does not provide a pythonic file-like object
+    already, this class contains much of the logic to build one. The only
+    methods that need to be overridden are ``_upload_chunk``,
+    ``_initiate_upload`` and ``_fetch_range``.
+    """
+
+    DEFAULT_BLOCK_SIZE = 5 * 2**20
+    _details = None
+
+    def __init__(
+        self,
+        fs,
+        path,
+        mode="rb",
+        block_size="default",
+        autocommit=True,
+        cache_type="readahead",
+        cache_options=None,
+        size=None,
+        **kwargs,
+    ):
+        """
+        Template for files with buffered reading and writing
+
+        Parameters
+        ----------
+        fs: instance of FileSystem
+        path: str
+            location in file-system
+        mode: str
+            Normal file modes. Currently only 'wb', 'ab' or 'rb'. Some file
+            systems may be read-only, and some may not support append.
+        block_size: int
+            Buffer size for reading or writing, 'default' for class default
+        autocommit: bool
+            Whether to write to final destination; may only impact what
+            happens when file is being closed.
+        cache_type: {"readahead", "none", "mmap", "bytes"}, default "readahead"
+            Caching policy in read mode. See the definitions in ``core``.
+        cache_options : dict
+            Additional options passed to the constructor for the cache specified
+            by `cache_type`.
+        size: int
+            If given and in read mode, suppressed having to look up the file size
+        kwargs:
+            Gets stored as self.kwargs
+        """
+        from .core import caches
+
+        self.path = path
+        self.fs = fs
+        self.mode = mode
+        self.blocksize = (
+            self.DEFAULT_BLOCK_SIZE if block_size in ["default", None] else block_size
+        )
+        self.loc = 0
+        self.autocommit = autocommit
+        self.end = None
+        self.start = None
+        self.closed = False
+
+        if cache_options is None:
+            cache_options = {}
+
+        if "trim" in kwargs:
+            warnings.warn(
+                "Passing 'trim' to control the cache behavior has been deprecated. "
+                "Specify it within the 'cache_options' argument instead.",
+                FutureWarning,
+            )
+            cache_options["trim"] = kwargs.pop("trim")
+
+        self.kwargs = kwargs
+
+        if mode not in {"ab", "rb", "wb"}:
+            raise NotImplementedError("File mode not supported")
+        if mode == "rb":
+            if size is not None:
+                self.size = size
+            else:
+                self.size = self.details["size"]
+            self.cache = caches[cache_type](
+                self.blocksize, self._fetch_range, self.size, **cache_options
+            )
+        else:
+            self.buffer = io.BytesIO()
+            self.offset = None
+            self.forced = False
+            self.location = None
+
+    @property
+    def details(self):
+        if self._details is None:
+            self._details = self.fs.info(self.path)
+        return self._details
+
+    @details.setter
+    def details(self, value):
+        self._details = value
+        self.size = value["size"]
+
+    @property
+    def full_name(self):
+        return _unstrip_protocol(self.path, self.fs)
+
+    @property
+    def closed(self):
+        # get around this attr being read-only in IOBase
+        # use getattr here, since this can be called during del
+        return getattr(self, "_closed", True)
+
+    @closed.setter
+    def closed(self, c):
+        self._closed = c
+
+    def __hash__(self):
+        if "w" in self.mode:
+            return id(self)
+        else:
+            return int(tokenize(self.details), 16)
+
+    def __eq__(self, other):
+        """Files are equal if they have the same checksum, only in read mode"""
+        if self is other:
+            return True
+        return self.mode == "rb" and other.mode == "rb" and hash(self) == hash(other)
+
+    def commit(self):
+        """Move from temp to final destination"""
+
+    def discard(self):
+        """Throw away temporary file"""
+
+    def info(self):
+        """File information about this path"""
+        if "r" in self.mode:
+            return self.details
+        else:
+            raise ValueError("Info not available while writing")
+
+    def tell(self):
+        """Current file location"""
+        return self.loc
+
+    def seek(self, loc, whence=0):
+        """Set current file location
+
+        Parameters
+        ----------
+        loc: int
+            byte location
+        whence: {0, 1, 2}
+            from start of file, current location or end of file, resp.
+        """
+        loc = int(loc)
+        if not self.mode == "rb":
+            raise OSError(ESPIPE, "Seek only available in read mode")
+        if whence == 0:
+            nloc = loc
+        elif whence == 1:
+            nloc = self.loc + loc
+        elif whence == 2:
+            nloc = self.size + loc
+        else:
+            raise ValueError(f"invalid whence ({whence}, should be 0, 1 or 2)")
+        if nloc < 0:
+            raise ValueError("Seek before start of file")
+        self.loc = nloc
+        return self.loc
+
+    def write(self, data):
+        """
+        Write data to buffer.
+
+        Buffer only sent on flush() or if buffer is greater than
+        or equal to blocksize.
+
+        Parameters
+        ----------
+        data: bytes
+            Set of bytes to be written.
+        """
+        if self.mode not in {"wb", "ab"}:
+            raise ValueError("File not in write mode")
+        if self.closed:
+            raise ValueError("I/O operation on closed file.")
+        if self.forced:
+            raise ValueError("This file has been force-flushed, can only close")
+        out = self.buffer.write(data)
+        self.loc += out
+        if self.buffer.tell() >= self.blocksize:
+            self.flush()
+        return out
+
+    def flush(self, force=False):
+        """
+        Write buffered data to backend store.
+
+        Writes the current buffer, if it is larger than the block-size, or if
+        the file is being closed.
+
+        Parameters
+        ----------
+        force: bool
+            When closing, write the last block even if it is smaller than
+            blocks are allowed to be. Disallows further writing to this file.
+        """
+
+        if self.closed:
+            raise ValueError("Flush on closed file")
+        if force and self.forced:
+            raise ValueError("Force flush cannot be called more than once")
+        if force:
+            self.forced = True
+
+        if self.mode not in {"wb", "ab"}:
+            # no-op to flush on read-mode
+            return
+
+        if not force and self.buffer.tell() < self.blocksize:
+            # Defer write on small block
+            return
+
+        if self.offset is None:
+            # Initialize a multipart upload
+            self.offset = 0
+            try:
+                self._initiate_upload()
+            except:  # noqa: E722
+                self.closed = True
+                raise
+
+        if self._upload_chunk(final=force) is not False:
+            self.offset += self.buffer.seek(0, 2)
+            self.buffer = io.BytesIO()
+
+    def _upload_chunk(self, final=False):
+        """Write one part of a multi-block file upload
+
+        Parameters
+        ==========
+        final: bool
+            This is the last block, so should complete file, if
+            self.autocommit is True.
+        """
+        # may not yet have been initialized, may need to call _initialize_upload
+
+    def _initiate_upload(self):
+        """Create remote file/upload"""
+        pass
+
+    def _fetch_range(self, start, end):
+        """Get the specified set of bytes from remote"""
+        raise NotImplementedError
+
+    def read(self, length=-1):
+        """
+        Return data from cache, or fetch pieces as necessary
+
+        Parameters
+        ----------
+        length: int (-1)
+            Number of bytes to read; if <0, all remaining bytes.
+        """
+        length = -1 if length is None else int(length)
+        if self.mode != "rb":
+            raise ValueError("File not in read mode")
+        if length < 0:
+            length = self.size - self.loc
+        if self.closed:
+            raise ValueError("I/O operation on closed file.")
+        logger.debug("%s read: %i - %i", self, self.loc, self.loc + length)
+        if length == 0:
+            # don't even bother calling fetch
+            return b""
+        out = self.cache._fetch(self.loc, self.loc + length)
+        self.loc += len(out)
+        return out
+
+    def readinto(self, b):
+        """mirrors builtin file's readinto method
+
+        https://docs.python.org/3/library/io.html#io.RawIOBase.readinto
+        """
+        out = memoryview(b).cast("B")
+        data = self.read(out.nbytes)
+        out[: len(data)] = data
+        return len(data)
+
+    def readuntil(self, char=b"\n", blocks=None):
+        """Return data between current position and first occurrence of char
+
+        char is included in the output, except if the end of the tile is
+        encountered first.
+
+        Parameters
+        ----------
+        char: bytes
+            Thing to find
+        blocks: None or int
+            How much to read in each go. Defaults to file blocksize - which may
+            mean a new read on every call.
+        """
+        out = []
+        while True:
+            start = self.tell()
+            part = self.read(blocks or self.blocksize)
+            if len(part) == 0:
+                break
+            found = part.find(char)
+            if found > -1:
+                out.append(part[: found + len(char)])
+                self.seek(start + found + len(char))
+                break
+            out.append(part)
+        return b"".join(out)
+
+    def readline(self):
+        """Read until first occurrence of newline character
+
+        Note that, because of character encoding, this is not necessarily a
+        true line ending.
+        """
+        return self.readuntil(b"\n")
+
+    def __next__(self):
+        out = self.readline()
+        if out:
+            return out
+        raise StopIteration
+
+    def __iter__(self):
+        return self
+
+    def readlines(self):
+        """Return all data, split by the newline character"""
+        data = self.read()
+        lines = data.split(b"\n")
+        out = [l + b"\n" for l in lines[:-1]]
+        if data.endswith(b"\n"):
+            return out
+        else:
+            return out + [lines[-1]]
+        # return list(self)  ???
+
+    def readinto1(self, b):
+        return self.readinto(b)
+
+    def close(self):
+        """Close file
+
+        Finalizes writes, discards cache
+        """
+        if getattr(self, "_unclosable", False):
+            return
+        if self.closed:
+            return
+        if self.mode == "rb":
+            self.cache = None
+        else:
+            if not self.forced:
+                self.flush(force=True)
+
+            if self.fs is not None:
+                self.fs.invalidate_cache(self.path)
+                self.fs.invalidate_cache(self.fs._parent(self.path))
+
+        self.closed = True
+
+    def readable(self):
+        """Whether opened for reading"""
+        return self.mode == "rb" and not self.closed
+
+    def seekable(self):
+        """Whether is seekable (only in read mode)"""
+        return self.readable()
+
+    def writable(self):
+        """Whether opened for writing"""
+        return self.mode in {"wb", "ab"} and not self.closed
+
+    def __del__(self):
+        if not self.closed:
+            self.close()
+
+    def __str__(self):
+        return f"<File-like object {type(self.fs).__name__}, {self.path}>"
+
+    __repr__ = __str__
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()
diff --git a/llm/Lib/site-packages/fsspec/tests/abstract/__init__.py b/llm/Lib/site-packages/fsspec/tests/abstract/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..45d081921ad29104bedd336dbf04fa86e1e48b7a
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/tests/abstract/__init__.py
@@ -0,0 +1,287 @@
+import os
+from hashlib import md5
+
+import pytest
+
+from fsspec.implementations.local import LocalFileSystem
+from fsspec.tests.abstract.copy import AbstractCopyTests  # noqa
+from fsspec.tests.abstract.get import AbstractGetTests  # noqa
+from fsspec.tests.abstract.put import AbstractPutTests  # noqa
+
+
+class BaseAbstractFixtures:
+    """
+    Abstract base class containing fixtures that are used by but never need to
+    be overridden in derived filesystem-specific classes to run the abstract
+    tests on such filesystems.
+    """
+
+    @pytest.fixture
+    def fs_bulk_operations_scenario_0(self, fs, fs_join, fs_path):
+        """
+        Scenario on remote filesystem that is used for many cp/get/put tests.
+
+        Cleans up at the end of each test it which it is used.
+        """
+        source = self._bulk_operations_scenario_0(fs, fs_join, fs_path)
+        yield source
+        fs.rm(source, recursive=True)
+
+    @pytest.fixture
+    def fs_glob_edge_cases_files(self, fs, fs_join, fs_path):
+        """
+        Scenario on remote filesystem that is used for glob edge cases cp/get/put tests.
+
+        Cleans up at the end of each test it which it is used.
+        """
+        source = self._glob_edge_cases_files(fs, fs_join, fs_path)
+        yield source
+        fs.rm(source, recursive=True)
+
+    @pytest.fixture
+    def fs_dir_and_file_with_same_name_prefix(self, fs, fs_join, fs_path):
+        """
+        Scenario on remote filesystem that is used to check cp/get/put on directory
+        and file with the same name prefixes.
+
+        Cleans up at the end of each test it which it is used.
+        """
+        source = self._dir_and_file_with_same_name_prefix(fs, fs_join, fs_path)
+        yield source
+        fs.rm(source, recursive=True)
+
+    @pytest.fixture
+    def fs_10_files_with_hashed_names(self, fs, fs_join, fs_path):
+        """
+        Scenario on remote filesystem that is used to check cp/get/put files order
+        when source and destination are lists.
+
+        Cleans up at the end of each test it which it is used.
+        """
+        source = self._10_files_with_hashed_names(fs, fs_join, fs_path)
+        yield source
+        fs.rm(source, recursive=True)
+
+    @pytest.fixture
+    def fs_target(self, fs, fs_join, fs_path):
+        """
+        Return name of remote directory that does not yet exist to copy into.
+
+        Cleans up at the end of each test it which it is used.
+        """
+        target = fs_join(fs_path, "target")
+        yield target
+        if fs.exists(target):
+            fs.rm(target, recursive=True)
+
+    @pytest.fixture
+    def local_bulk_operations_scenario_0(self, local_fs, local_join, local_path):
+        """
+        Scenario on local filesystem that is used for many cp/get/put tests.
+
+        Cleans up at the end of each test it which it is used.
+        """
+        source = self._bulk_operations_scenario_0(local_fs, local_join, local_path)
+        yield source
+        local_fs.rm(source, recursive=True)
+
+    @pytest.fixture
+    def local_glob_edge_cases_files(self, local_fs, local_join, local_path):
+        """
+        Scenario on local filesystem that is used for glob edge cases cp/get/put tests.
+
+        Cleans up at the end of each test it which it is used.
+        """
+        source = self._glob_edge_cases_files(local_fs, local_join, local_path)
+        yield source
+        local_fs.rm(source, recursive=True)
+
+    @pytest.fixture
+    def local_dir_and_file_with_same_name_prefix(
+        self, local_fs, local_join, local_path
+    ):
+        """
+        Scenario on local filesystem that is used to check cp/get/put on directory
+        and file with the same name prefixes.
+
+        Cleans up at the end of each test it which it is used.
+        """
+        source = self._dir_and_file_with_same_name_prefix(
+            local_fs, local_join, local_path
+        )
+        yield source
+        local_fs.rm(source, recursive=True)
+
+    @pytest.fixture
+    def local_10_files_with_hashed_names(self, local_fs, local_join, local_path):
+        """
+        Scenario on local filesystem that is used to check cp/get/put files order
+        when source and destination are lists.
+
+        Cleans up at the end of each test it which it is used.
+        """
+        source = self._10_files_with_hashed_names(local_fs, local_join, local_path)
+        yield source
+        local_fs.rm(source, recursive=True)
+
+    @pytest.fixture
+    def local_target(self, local_fs, local_join, local_path):
+        """
+        Return name of local directory that does not yet exist to copy into.
+
+        Cleans up at the end of each test it which it is used.
+        """
+        target = local_join(local_path, "target")
+        yield target
+        if local_fs.exists(target):
+            local_fs.rm(target, recursive=True)
+
+    def _glob_edge_cases_files(self, some_fs, some_join, some_path):
+        """
+        Scenario that is used for glob edge cases cp/get/put tests.
+        Creates the following directory and file structure:
+
+        📁 source
+        ├── 📄 file1
+        ├── 📄 file2
+        ├── 📁 subdir0
+        │   ├── 📄 subfile1
+        │   ├── 📄 subfile2
+        │   └── 📁 nesteddir
+        │       └── 📄 nestedfile
+        └── 📁 subdir1
+            ├── 📄 subfile1
+            ├── 📄 subfile2
+            └── 📁 nesteddir
+                └── 📄 nestedfile
+        """
+        source = some_join(some_path, "source")
+        some_fs.touch(some_join(source, "file1"))
+        some_fs.touch(some_join(source, "file2"))
+
+        for subdir_idx in range(2):
+            subdir = some_join(source, f"subdir{subdir_idx}")
+            nesteddir = some_join(subdir, "nesteddir")
+            some_fs.makedirs(nesteddir)
+            some_fs.touch(some_join(subdir, "subfile1"))
+            some_fs.touch(some_join(subdir, "subfile2"))
+            some_fs.touch(some_join(nesteddir, "nestedfile"))
+
+        return source
+
+    def _bulk_operations_scenario_0(self, some_fs, some_join, some_path):
+        """
+        Scenario that is used for many cp/get/put tests. Creates the following
+        directory and file structure:
+
+        📁 source
+        ├── 📄 file1
+        ├── 📄 file2
+        └── 📁 subdir
+            ├── 📄 subfile1
+            ├── 📄 subfile2
+            └── 📁 nesteddir
+                └── 📄 nestedfile
+        """
+        source = some_join(some_path, "source")
+        subdir = some_join(source, "subdir")
+        nesteddir = some_join(subdir, "nesteddir")
+        some_fs.makedirs(nesteddir)
+        some_fs.touch(some_join(source, "file1"))
+        some_fs.touch(some_join(source, "file2"))
+        some_fs.touch(some_join(subdir, "subfile1"))
+        some_fs.touch(some_join(subdir, "subfile2"))
+        some_fs.touch(some_join(nesteddir, "nestedfile"))
+        return source
+
+    def _dir_and_file_with_same_name_prefix(self, some_fs, some_join, some_path):
+        """
+        Scenario that is used to check cp/get/put on directory and file with
+        the same name prefixes. Creates the following directory and file structure:
+
+        📁 source
+        ├── 📄 subdir.txt
+        └── 📁 subdir
+            └── 📄 subfile.txt
+        """
+        source = some_join(some_path, "source")
+        subdir = some_join(source, "subdir")
+        file = some_join(source, "subdir.txt")
+        subfile = some_join(subdir, "subfile.txt")
+        some_fs.makedirs(subdir)
+        some_fs.touch(file)
+        some_fs.touch(subfile)
+        return source
+
+    def _10_files_with_hashed_names(self, some_fs, some_join, some_path):
+        """
+        Scenario that is used to check cp/get/put files order when source and
+        destination are lists. Creates the following directory and file structure:
+
+        📁 source
+        └── 📄 {hashed([0-9])}.txt
+        """
+        source = some_join(some_path, "source")
+        for i in range(10):
+            hashed_i = md5(str(i).encode("utf-8")).hexdigest()
+            path = some_join(source, f"{hashed_i}.txt")
+            some_fs.pipe(path=path, value=f"{i}".encode("utf-8"))
+        return source
+
+
+class AbstractFixtures(BaseAbstractFixtures):
+    """
+    Abstract base class containing fixtures that may be overridden in derived
+    filesystem-specific classes to run the abstract tests on such filesystems.
+
+    For any particular filesystem some of these fixtures must be overridden,
+    such as ``fs`` and ``fs_path``, and others may be overridden if the
+    default functions here are not appropriate, such as ``fs_join``.
+    """
+
+    @pytest.fixture
+    def fs(self):
+        raise NotImplementedError("This function must be overridden in derived classes")
+
+    @pytest.fixture
+    def fs_join(self):
+        """
+        Return a function that joins its arguments together into a path.
+
+        Most fsspec implementations join paths in a platform-dependent way,
+        but some will override this to always use a forward slash.
+        """
+        return os.path.join
+
+    @pytest.fixture
+    def fs_path(self):
+        raise NotImplementedError("This function must be overridden in derived classes")
+
+    @pytest.fixture(scope="class")
+    def local_fs(self):
+        # Maybe need an option for auto_mkdir=False?  This is only relevant
+        # for certain implementations.
+        return LocalFileSystem(auto_mkdir=True)
+
+    @pytest.fixture
+    def local_join(self):
+        """
+        Return a function that joins its arguments together into a path, on
+        the local filesystem.
+        """
+        return os.path.join
+
+    @pytest.fixture
+    def local_path(self, tmpdir):
+        return tmpdir
+
+    @pytest.fixture
+    def supports_empty_directories(self):
+        """
+        Return whether this implementation supports empty directories.
+        """
+        return True
+
+    @pytest.fixture
+    def fs_sanitize_path(self):
+        return lambda x: x
diff --git a/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3408b7e3b1e4fed52b0042df96b0a9b4b5508d17
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/common.cpython-311.pyc b/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/common.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2e39200f193299f95fbf3e31d8933472b6c6b99e
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/common.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/copy.cpython-311.pyc b/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/copy.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5149630cdbedd7d5c28e85b962ce8896aa9214fe
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/copy.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/get.cpython-311.pyc b/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/get.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dd67333cdc3947a17f507de3ed15bbb445a0f8c4
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/get.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/put.cpython-311.pyc b/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/put.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..98067a237d7e8ec3be9db1a600e60fd4194643e1
Binary files /dev/null and b/llm/Lib/site-packages/fsspec/tests/abstract/__pycache__/put.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/fsspec/tests/abstract/common.py b/llm/Lib/site-packages/fsspec/tests/abstract/common.py
new file mode 100644
index 0000000000000000000000000000000000000000..22e7c4140404ab2a8928689721419cf05c2760b9
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/tests/abstract/common.py
@@ -0,0 +1,175 @@
+GLOB_EDGE_CASES_TESTS = {
+    "argnames": ("path", "recursive", "maxdepth", "expected"),
+    "argvalues": [
+        ("fil?1", False, None, ["file1"]),
+        ("fil?1", True, None, ["file1"]),
+        ("file[1-2]", False, None, ["file1", "file2"]),
+        ("file[1-2]", True, None, ["file1", "file2"]),
+        ("*", False, None, ["file1", "file2"]),
+        (
+            "*",
+            True,
+            None,
+            [
+                "file1",
+                "file2",
+                "subdir0/subfile1",
+                "subdir0/subfile2",
+                "subdir0/nesteddir/nestedfile",
+                "subdir1/subfile1",
+                "subdir1/subfile2",
+                "subdir1/nesteddir/nestedfile",
+            ],
+        ),
+        ("*", True, 1, ["file1", "file2"]),
+        (
+            "*",
+            True,
+            2,
+            [
+                "file1",
+                "file2",
+                "subdir0/subfile1",
+                "subdir0/subfile2",
+                "subdir1/subfile1",
+                "subdir1/subfile2",
+            ],
+        ),
+        ("*1", False, None, ["file1"]),
+        (
+            "*1",
+            True,
+            None,
+            [
+                "file1",
+                "subdir1/subfile1",
+                "subdir1/subfile2",
+                "subdir1/nesteddir/nestedfile",
+            ],
+        ),
+        ("*1", True, 2, ["file1", "subdir1/subfile1", "subdir1/subfile2"]),
+        (
+            "**",
+            False,
+            None,
+            [
+                "file1",
+                "file2",
+                "subdir0/subfile1",
+                "subdir0/subfile2",
+                "subdir0/nesteddir/nestedfile",
+                "subdir1/subfile1",
+                "subdir1/subfile2",
+                "subdir1/nesteddir/nestedfile",
+            ],
+        ),
+        (
+            "**",
+            True,
+            None,
+            [
+                "file1",
+                "file2",
+                "subdir0/subfile1",
+                "subdir0/subfile2",
+                "subdir0/nesteddir/nestedfile",
+                "subdir1/subfile1",
+                "subdir1/subfile2",
+                "subdir1/nesteddir/nestedfile",
+            ],
+        ),
+        ("**", True, 1, ["file1", "file2"]),
+        (
+            "**",
+            True,
+            2,
+            [
+                "file1",
+                "file2",
+                "subdir0/subfile1",
+                "subdir0/subfile2",
+                "subdir0/nesteddir/nestedfile",
+                "subdir1/subfile1",
+                "subdir1/subfile2",
+                "subdir1/nesteddir/nestedfile",
+            ],
+        ),
+        (
+            "**",
+            False,
+            2,
+            [
+                "file1",
+                "file2",
+                "subdir0/subfile1",
+                "subdir0/subfile2",
+                "subdir1/subfile1",
+                "subdir1/subfile2",
+            ],
+        ),
+        ("**/*1", False, None, ["file1", "subdir0/subfile1", "subdir1/subfile1"]),
+        (
+            "**/*1",
+            True,
+            None,
+            [
+                "file1",
+                "subdir0/subfile1",
+                "subdir1/subfile1",
+                "subdir1/subfile2",
+                "subdir1/nesteddir/nestedfile",
+            ],
+        ),
+        ("**/*1", True, 1, ["file1"]),
+        (
+            "**/*1",
+            True,
+            2,
+            ["file1", "subdir0/subfile1", "subdir1/subfile1", "subdir1/subfile2"],
+        ),
+        ("**/*1", False, 2, ["file1", "subdir0/subfile1", "subdir1/subfile1"]),
+        ("**/subdir0", False, None, []),
+        ("**/subdir0", True, None, ["subfile1", "subfile2", "nesteddir/nestedfile"]),
+        ("**/subdir0/nested*", False, 2, []),
+        ("**/subdir0/nested*", True, 2, ["nestedfile"]),
+        ("subdir[1-2]", False, None, []),
+        ("subdir[1-2]", True, None, ["subfile1", "subfile2", "nesteddir/nestedfile"]),
+        ("subdir[1-2]", True, 2, ["subfile1", "subfile2"]),
+        ("subdir[0-1]", False, None, []),
+        (
+            "subdir[0-1]",
+            True,
+            None,
+            [
+                "subdir0/subfile1",
+                "subdir0/subfile2",
+                "subdir0/nesteddir/nestedfile",
+                "subdir1/subfile1",
+                "subdir1/subfile2",
+                "subdir1/nesteddir/nestedfile",
+            ],
+        ),
+        (
+            "subdir[0-1]/*fil[e]*",
+            False,
+            None,
+            [
+                "subdir0/subfile1",
+                "subdir0/subfile2",
+                "subdir1/subfile1",
+                "subdir1/subfile2",
+            ],
+        ),
+        (
+            "subdir[0-1]/*fil[e]*",
+            True,
+            None,
+            [
+                "subdir0/subfile1",
+                "subdir0/subfile2",
+                "subdir1/subfile1",
+                "subdir1/subfile2",
+            ],
+        ),
+    ],
+}
diff --git a/llm/Lib/site-packages/fsspec/tests/abstract/copy.py b/llm/Lib/site-packages/fsspec/tests/abstract/copy.py
new file mode 100644
index 0000000000000000000000000000000000000000..e39e57e5f7d52bfda8ab5e2398b04cc2303630a0
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/tests/abstract/copy.py
@@ -0,0 +1,557 @@
+from hashlib import md5
+from itertools import product
+
+import pytest
+
+from fsspec.tests.abstract.common import GLOB_EDGE_CASES_TESTS
+
+
+class AbstractCopyTests:
+    def test_copy_file_to_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        fs_target,
+        supports_empty_directories,
+    ):
+        # Copy scenario 1a
+        source = fs_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+        if not supports_empty_directories:
+            # Force target directory to exist by adding a dummy file
+            fs.touch(fs_join(target, "dummy"))
+        assert fs.isdir(target)
+
+        target_file2 = fs_join(target, "file2")
+        target_subfile1 = fs_join(target, "subfile1")
+
+        # Copy from source directory
+        fs.cp(fs_join(source, "file2"), target)
+        assert fs.isfile(target_file2)
+
+        # Copy from sub directory
+        fs.cp(fs_join(source, "subdir", "subfile1"), target)
+        assert fs.isfile(target_subfile1)
+
+        # Remove copied files
+        fs.rm([target_file2, target_subfile1])
+        assert not fs.exists(target_file2)
+        assert not fs.exists(target_subfile1)
+
+        # Repeat with trailing slash on target
+        fs.cp(fs_join(source, "file2"), target + "/")
+        assert fs.isdir(target)
+        assert fs.isfile(target_file2)
+
+        fs.cp(fs_join(source, "subdir", "subfile1"), target + "/")
+        assert fs.isfile(target_subfile1)
+
+    def test_copy_file_to_new_directory(
+        self, fs, fs_join, fs_bulk_operations_scenario_0, fs_target
+    ):
+        # Copy scenario 1b
+        source = fs_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+
+        fs.cp(
+            fs_join(source, "subdir", "subfile1"), fs_join(target, "newdir/")
+        )  # Note trailing slash
+        assert fs.isdir(target)
+        assert fs.isdir(fs_join(target, "newdir"))
+        assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+
+    def test_copy_file_to_file_in_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        fs_target,
+        supports_empty_directories,
+    ):
+        # Copy scenario 1c
+        source = fs_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+        if not supports_empty_directories:
+            # Force target directory to exist by adding a dummy file
+            fs.touch(fs_join(target, "dummy"))
+        assert fs.isdir(target)
+
+        fs.cp(fs_join(source, "subdir", "subfile1"), fs_join(target, "newfile"))
+        assert fs.isfile(fs_join(target, "newfile"))
+
+    def test_copy_file_to_file_in_new_directory(
+        self, fs, fs_join, fs_bulk_operations_scenario_0, fs_target
+    ):
+        # Copy scenario 1d
+        source = fs_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+
+        fs.cp(
+            fs_join(source, "subdir", "subfile1"), fs_join(target, "newdir", "newfile")
+        )
+        assert fs.isdir(fs_join(target, "newdir"))
+        assert fs.isfile(fs_join(target, "newdir", "newfile"))
+
+    def test_copy_directory_to_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        fs_target,
+        supports_empty_directories,
+    ):
+        # Copy scenario 1e
+        source = fs_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+        if not supports_empty_directories:
+            # Force target directory to exist by adding a dummy file
+            dummy = fs_join(target, "dummy")
+            fs.touch(dummy)
+        assert fs.isdir(target)
+
+        for source_slash, target_slash in zip([False, True], [False, True]):
+            s = fs_join(source, "subdir")
+            if source_slash:
+                s += "/"
+            t = target + "/" if target_slash else target
+
+            # Without recursive does nothing
+            fs.cp(s, t)
+            assert fs.ls(target, detail=False) == (
+                [] if supports_empty_directories else [dummy]
+            )
+
+            # With recursive
+            fs.cp(s, t, recursive=True)
+            if source_slash:
+                assert fs.isfile(fs_join(target, "subfile1"))
+                assert fs.isfile(fs_join(target, "subfile2"))
+                assert fs.isdir(fs_join(target, "nesteddir"))
+                assert fs.isfile(fs_join(target, "nesteddir", "nestedfile"))
+                assert not fs.exists(fs_join(target, "subdir"))
+
+                fs.rm(
+                    [
+                        fs_join(target, "subfile1"),
+                        fs_join(target, "subfile2"),
+                        fs_join(target, "nesteddir"),
+                    ],
+                    recursive=True,
+                )
+            else:
+                assert fs.isdir(fs_join(target, "subdir"))
+                assert fs.isfile(fs_join(target, "subdir", "subfile1"))
+                assert fs.isfile(fs_join(target, "subdir", "subfile2"))
+                assert fs.isdir(fs_join(target, "subdir", "nesteddir"))
+                assert fs.isfile(fs_join(target, "subdir", "nesteddir", "nestedfile"))
+
+                fs.rm(fs_join(target, "subdir"), recursive=True)
+            assert fs.ls(target, detail=False) == (
+                [] if supports_empty_directories else [dummy]
+            )
+
+            # Limit recursive by maxdepth
+            fs.cp(s, t, recursive=True, maxdepth=1)
+            if source_slash:
+                assert fs.isfile(fs_join(target, "subfile1"))
+                assert fs.isfile(fs_join(target, "subfile2"))
+                assert not fs.exists(fs_join(target, "nesteddir"))
+                assert not fs.exists(fs_join(target, "subdir"))
+
+                fs.rm(
+                    [
+                        fs_join(target, "subfile1"),
+                        fs_join(target, "subfile2"),
+                    ],
+                    recursive=True,
+                )
+            else:
+                assert fs.isdir(fs_join(target, "subdir"))
+                assert fs.isfile(fs_join(target, "subdir", "subfile1"))
+                assert fs.isfile(fs_join(target, "subdir", "subfile2"))
+                assert not fs.exists(fs_join(target, "subdir", "nesteddir"))
+
+                fs.rm(fs_join(target, "subdir"), recursive=True)
+            assert fs.ls(target, detail=False) == (
+                [] if supports_empty_directories else [dummy]
+            )
+
+    def test_copy_directory_to_new_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        fs_target,
+        supports_empty_directories,
+    ):
+        # Copy scenario 1f
+        source = fs_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+
+        for source_slash, target_slash in zip([False, True], [False, True]):
+            s = fs_join(source, "subdir")
+            if source_slash:
+                s += "/"
+            t = fs_join(target, "newdir")
+            if target_slash:
+                t += "/"
+
+            # Without recursive does nothing
+            fs.cp(s, t)
+            if supports_empty_directories:
+                assert fs.ls(target) == []
+            else:
+                with pytest.raises(FileNotFoundError):
+                    fs.ls(target)
+
+            # With recursive
+            fs.cp(s, t, recursive=True)
+            assert fs.isdir(fs_join(target, "newdir"))
+            assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+            assert fs.isfile(fs_join(target, "newdir", "subfile2"))
+            assert fs.isdir(fs_join(target, "newdir", "nesteddir"))
+            assert fs.isfile(fs_join(target, "newdir", "nesteddir", "nestedfile"))
+            assert not fs.exists(fs_join(target, "subdir"))
+
+            fs.rm(fs_join(target, "newdir"), recursive=True)
+            assert not fs.exists(fs_join(target, "newdir"))
+
+            # Limit recursive by maxdepth
+            fs.cp(s, t, recursive=True, maxdepth=1)
+            assert fs.isdir(fs_join(target, "newdir"))
+            assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+            assert fs.isfile(fs_join(target, "newdir", "subfile2"))
+            assert not fs.exists(fs_join(target, "newdir", "nesteddir"))
+            assert not fs.exists(fs_join(target, "subdir"))
+
+            fs.rm(fs_join(target, "newdir"), recursive=True)
+            assert not fs.exists(fs_join(target, "newdir"))
+
+    def test_copy_glob_to_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        fs_target,
+        supports_empty_directories,
+    ):
+        # Copy scenario 1g
+        source = fs_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+        if not supports_empty_directories:
+            # Force target directory to exist by adding a dummy file
+            dummy = fs_join(target, "dummy")
+            fs.touch(dummy)
+        assert fs.isdir(target)
+
+        for target_slash in [False, True]:
+            t = target + "/" if target_slash else target
+
+            # Without recursive
+            fs.cp(fs_join(source, "subdir", "*"), t)
+            assert fs.isfile(fs_join(target, "subfile1"))
+            assert fs.isfile(fs_join(target, "subfile2"))
+            assert not fs.isdir(fs_join(target, "nesteddir"))
+            assert not fs.exists(fs_join(target, "nesteddir", "nestedfile"))
+            assert not fs.exists(fs_join(target, "subdir"))
+
+            fs.rm(
+                [
+                    fs_join(target, "subfile1"),
+                    fs_join(target, "subfile2"),
+                ],
+                recursive=True,
+            )
+            assert fs.ls(target, detail=False) == (
+                [] if supports_empty_directories else [dummy]
+            )
+
+            # With recursive
+            for glob, recursive in zip(["*", "**"], [True, False]):
+                fs.cp(fs_join(source, "subdir", glob), t, recursive=recursive)
+                assert fs.isfile(fs_join(target, "subfile1"))
+                assert fs.isfile(fs_join(target, "subfile2"))
+                assert fs.isdir(fs_join(target, "nesteddir"))
+                assert fs.isfile(fs_join(target, "nesteddir", "nestedfile"))
+                assert not fs.exists(fs_join(target, "subdir"))
+
+                fs.rm(
+                    [
+                        fs_join(target, "subfile1"),
+                        fs_join(target, "subfile2"),
+                        fs_join(target, "nesteddir"),
+                    ],
+                    recursive=True,
+                )
+                assert fs.ls(target, detail=False) == (
+                    [] if supports_empty_directories else [dummy]
+                )
+
+                # Limit recursive by maxdepth
+                fs.cp(
+                    fs_join(source, "subdir", glob), t, recursive=recursive, maxdepth=1
+                )
+                assert fs.isfile(fs_join(target, "subfile1"))
+                assert fs.isfile(fs_join(target, "subfile2"))
+                assert not fs.exists(fs_join(target, "nesteddir"))
+                assert not fs.exists(fs_join(target, "subdir"))
+
+                fs.rm(
+                    [
+                        fs_join(target, "subfile1"),
+                        fs_join(target, "subfile2"),
+                    ],
+                    recursive=True,
+                )
+                assert fs.ls(target, detail=False) == (
+                    [] if supports_empty_directories else [dummy]
+                )
+
+    def test_copy_glob_to_new_directory(
+        self, fs, fs_join, fs_bulk_operations_scenario_0, fs_target
+    ):
+        # Copy scenario 1h
+        source = fs_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+
+        for target_slash in [False, True]:
+            t = fs_join(target, "newdir")
+            if target_slash:
+                t += "/"
+
+            # Without recursive
+            fs.cp(fs_join(source, "subdir", "*"), t)
+            assert fs.isdir(fs_join(target, "newdir"))
+            assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+            assert fs.isfile(fs_join(target, "newdir", "subfile2"))
+            assert not fs.exists(fs_join(target, "newdir", "nesteddir"))
+            assert not fs.exists(fs_join(target, "newdir", "nesteddir", "nestedfile"))
+            assert not fs.exists(fs_join(target, "subdir"))
+            assert not fs.exists(fs_join(target, "newdir", "subdir"))
+
+            fs.rm(fs_join(target, "newdir"), recursive=True)
+            assert not fs.exists(fs_join(target, "newdir"))
+
+            # With recursive
+            for glob, recursive in zip(["*", "**"], [True, False]):
+                fs.cp(fs_join(source, "subdir", glob), t, recursive=recursive)
+                assert fs.isdir(fs_join(target, "newdir"))
+                assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+                assert fs.isfile(fs_join(target, "newdir", "subfile2"))
+                assert fs.isdir(fs_join(target, "newdir", "nesteddir"))
+                assert fs.isfile(fs_join(target, "newdir", "nesteddir", "nestedfile"))
+                assert not fs.exists(fs_join(target, "subdir"))
+                assert not fs.exists(fs_join(target, "newdir", "subdir"))
+
+                fs.rm(fs_join(target, "newdir"), recursive=True)
+                assert not fs.exists(fs_join(target, "newdir"))
+
+                # Limit recursive by maxdepth
+                fs.cp(
+                    fs_join(source, "subdir", glob), t, recursive=recursive, maxdepth=1
+                )
+                assert fs.isdir(fs_join(target, "newdir"))
+                assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+                assert fs.isfile(fs_join(target, "newdir", "subfile2"))
+                assert not fs.exists(fs_join(target, "newdir", "nesteddir"))
+                assert not fs.exists(fs_join(target, "subdir"))
+                assert not fs.exists(fs_join(target, "newdir", "subdir"))
+
+                fs.rm(fs_join(target, "newdir"), recursive=True)
+                assert not fs.exists(fs_join(target, "newdir"))
+
+    @pytest.mark.parametrize(
+        GLOB_EDGE_CASES_TESTS["argnames"],
+        GLOB_EDGE_CASES_TESTS["argvalues"],
+    )
+    def test_copy_glob_edge_cases(
+        self,
+        path,
+        recursive,
+        maxdepth,
+        expected,
+        fs,
+        fs_join,
+        fs_glob_edge_cases_files,
+        fs_target,
+        fs_sanitize_path,
+    ):
+        # Copy scenario 1g
+        source = fs_glob_edge_cases_files
+
+        target = fs_target
+
+        for new_dir, target_slash in product([True, False], [True, False]):
+            fs.mkdir(target)
+
+            t = fs_join(target, "newdir") if new_dir else target
+            t = t + "/" if target_slash else t
+
+            fs.copy(fs_join(source, path), t, recursive=recursive, maxdepth=maxdepth)
+
+            output = fs.find(target)
+            if new_dir:
+                prefixed_expected = [
+                    fs_sanitize_path(fs_join(target, "newdir", p)) for p in expected
+                ]
+            else:
+                prefixed_expected = [
+                    fs_sanitize_path(fs_join(target, p)) for p in expected
+                ]
+            assert sorted(output) == sorted(prefixed_expected)
+
+            try:
+                fs.rm(target, recursive=True)
+            except FileNotFoundError:
+                pass
+
+    def test_copy_list_of_files_to_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        fs_target,
+        supports_empty_directories,
+    ):
+        # Copy scenario 2a
+        source = fs_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+        if not supports_empty_directories:
+            # Force target directory to exist by adding a dummy file
+            dummy = fs_join(target, "dummy")
+            fs.touch(dummy)
+        assert fs.isdir(target)
+
+        source_files = [
+            fs_join(source, "file1"),
+            fs_join(source, "file2"),
+            fs_join(source, "subdir", "subfile1"),
+        ]
+
+        for target_slash in [False, True]:
+            t = target + "/" if target_slash else target
+
+            fs.cp(source_files, t)
+            assert fs.isfile(fs_join(target, "file1"))
+            assert fs.isfile(fs_join(target, "file2"))
+            assert fs.isfile(fs_join(target, "subfile1"))
+
+            fs.rm(
+                [
+                    fs_join(target, "file1"),
+                    fs_join(target, "file2"),
+                    fs_join(target, "subfile1"),
+                ],
+                recursive=True,
+            )
+            assert fs.ls(target, detail=False) == (
+                [] if supports_empty_directories else [dummy]
+            )
+
+    def test_copy_list_of_files_to_new_directory(
+        self, fs, fs_join, fs_bulk_operations_scenario_0, fs_target
+    ):
+        # Copy scenario 2b
+        source = fs_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+
+        source_files = [
+            fs_join(source, "file1"),
+            fs_join(source, "file2"),
+            fs_join(source, "subdir", "subfile1"),
+        ]
+
+        fs.cp(source_files, fs_join(target, "newdir") + "/")  # Note trailing slash
+        assert fs.isdir(fs_join(target, "newdir"))
+        assert fs.isfile(fs_join(target, "newdir", "file1"))
+        assert fs.isfile(fs_join(target, "newdir", "file2"))
+        assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+
+    def test_copy_two_files_new_directory(
+        self, fs, fs_join, fs_bulk_operations_scenario_0, fs_target
+    ):
+        # This is a duplicate of test_copy_list_of_files_to_new_directory and
+        # can eventually be removed.
+        source = fs_bulk_operations_scenario_0
+
+        target = fs_target
+        assert not fs.exists(target)
+        fs.cp([fs_join(source, "file1"), fs_join(source, "file2")], target)
+
+        assert fs.isdir(target)
+        assert fs.isfile(fs_join(target, "file1"))
+        assert fs.isfile(fs_join(target, "file2"))
+
+    def test_copy_directory_without_files_with_same_name_prefix(
+        self,
+        fs,
+        fs_join,
+        fs_target,
+        fs_dir_and_file_with_same_name_prefix,
+        supports_empty_directories,
+    ):
+        # Create the test dirs
+        source = fs_dir_and_file_with_same_name_prefix
+        target = fs_target
+
+        # Test without glob
+        fs.cp(fs_join(source, "subdir"), target, recursive=True)
+
+        assert fs.isfile(fs_join(target, "subfile.txt"))
+        assert not fs.isfile(fs_join(target, "subdir.txt"))
+
+        fs.rm([fs_join(target, "subfile.txt")])
+        if supports_empty_directories:
+            assert fs.ls(target) == []
+        else:
+            assert not fs.exists(target)
+
+        # Test with glob
+        fs.cp(fs_join(source, "subdir*"), target, recursive=True)
+
+        assert fs.isdir(fs_join(target, "subdir"))
+        assert fs.isfile(fs_join(target, "subdir", "subfile.txt"))
+        assert fs.isfile(fs_join(target, "subdir.txt"))
+
+    def test_copy_with_source_and_destination_as_list(
+        self, fs, fs_target, fs_join, fs_10_files_with_hashed_names
+    ):
+        # Create the test dir
+        source = fs_10_files_with_hashed_names
+        target = fs_target
+
+        # Create list of files for source and destination
+        source_files = []
+        destination_files = []
+        for i in range(10):
+            hashed_i = md5(str(i).encode("utf-8")).hexdigest()
+            source_files.append(fs_join(source, f"{hashed_i}.txt"))
+            destination_files.append(fs_join(target, f"{hashed_i}.txt"))
+
+        # Copy and assert order was kept
+        fs.copy(path1=source_files, path2=destination_files)
+
+        for i in range(10):
+            file_content = fs.cat(destination_files[i]).decode("utf-8")
+            assert file_content == str(i)
diff --git a/llm/Lib/site-packages/fsspec/tests/abstract/get.py b/llm/Lib/site-packages/fsspec/tests/abstract/get.py
new file mode 100644
index 0000000000000000000000000000000000000000..851ab81ee581e74cac41c64c83ef0af75826d6b0
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/tests/abstract/get.py
@@ -0,0 +1,587 @@
+from hashlib import md5
+from itertools import product
+
+import pytest
+
+from fsspec.implementations.local import make_path_posix
+from fsspec.tests.abstract.common import GLOB_EDGE_CASES_TESTS
+
+
+class AbstractGetTests:
+    def test_get_file_to_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        local_fs,
+        local_join,
+        local_target,
+    ):
+        # Copy scenario 1a
+        source = fs_bulk_operations_scenario_0
+
+        target = local_target
+        local_fs.mkdir(target)
+        assert local_fs.isdir(target)
+
+        target_file2 = local_join(target, "file2")
+        target_subfile1 = local_join(target, "subfile1")
+
+        # Copy from source directory
+        fs.get(fs_join(source, "file2"), target)
+        assert local_fs.isfile(target_file2)
+
+        # Copy from sub directory
+        fs.get(fs_join(source, "subdir", "subfile1"), target)
+        assert local_fs.isfile(target_subfile1)
+
+        # Remove copied files
+        local_fs.rm([target_file2, target_subfile1])
+        assert not local_fs.exists(target_file2)
+        assert not local_fs.exists(target_subfile1)
+
+        # Repeat with trailing slash on target
+        fs.get(fs_join(source, "file2"), target + "/")
+        assert local_fs.isdir(target)
+        assert local_fs.isfile(target_file2)
+
+        fs.get(fs_join(source, "subdir", "subfile1"), target + "/")
+        assert local_fs.isfile(target_subfile1)
+
+    def test_get_file_to_new_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        local_fs,
+        local_join,
+        local_target,
+    ):
+        # Copy scenario 1b
+        source = fs_bulk_operations_scenario_0
+
+        target = local_target
+        local_fs.mkdir(target)
+
+        fs.get(
+            fs_join(source, "subdir", "subfile1"), local_join(target, "newdir/")
+        )  # Note trailing slash
+
+        assert local_fs.isdir(target)
+        assert local_fs.isdir(local_join(target, "newdir"))
+        assert local_fs.isfile(local_join(target, "newdir", "subfile1"))
+
+    def test_get_file_to_file_in_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        local_fs,
+        local_join,
+        local_target,
+    ):
+        # Copy scenario 1c
+        source = fs_bulk_operations_scenario_0
+
+        target = local_target
+        local_fs.mkdir(target)
+
+        fs.get(fs_join(source, "subdir", "subfile1"), local_join(target, "newfile"))
+        assert local_fs.isfile(local_join(target, "newfile"))
+
+    def test_get_file_to_file_in_new_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        local_fs,
+        local_join,
+        local_target,
+    ):
+        # Copy scenario 1d
+        source = fs_bulk_operations_scenario_0
+
+        target = local_target
+        local_fs.mkdir(target)
+
+        fs.get(
+            fs_join(source, "subdir", "subfile1"),
+            local_join(target, "newdir", "newfile"),
+        )
+        assert local_fs.isdir(local_join(target, "newdir"))
+        assert local_fs.isfile(local_join(target, "newdir", "newfile"))
+
+    def test_get_directory_to_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        local_fs,
+        local_join,
+        local_target,
+    ):
+        # Copy scenario 1e
+        source = fs_bulk_operations_scenario_0
+
+        target = local_target
+        local_fs.mkdir(target)
+        assert local_fs.isdir(target)
+
+        for source_slash, target_slash in zip([False, True], [False, True]):
+            s = fs_join(source, "subdir")
+            if source_slash:
+                s += "/"
+            t = target + "/" if target_slash else target
+
+            # Without recursive does nothing
+            fs.get(s, t)
+            assert local_fs.ls(target) == []
+
+            # With recursive
+            fs.get(s, t, recursive=True)
+            if source_slash:
+                assert local_fs.isfile(local_join(target, "subfile1"))
+                assert local_fs.isfile(local_join(target, "subfile2"))
+                assert local_fs.isdir(local_join(target, "nesteddir"))
+                assert local_fs.isfile(local_join(target, "nesteddir", "nestedfile"))
+                assert not local_fs.exists(local_join(target, "subdir"))
+
+                local_fs.rm(
+                    [
+                        local_join(target, "subfile1"),
+                        local_join(target, "subfile2"),
+                        local_join(target, "nesteddir"),
+                    ],
+                    recursive=True,
+                )
+            else:
+                assert local_fs.isdir(local_join(target, "subdir"))
+                assert local_fs.isfile(local_join(target, "subdir", "subfile1"))
+                assert local_fs.isfile(local_join(target, "subdir", "subfile2"))
+                assert local_fs.isdir(local_join(target, "subdir", "nesteddir"))
+                assert local_fs.isfile(
+                    local_join(target, "subdir", "nesteddir", "nestedfile")
+                )
+
+                local_fs.rm(local_join(target, "subdir"), recursive=True)
+            assert local_fs.ls(target) == []
+
+            # Limit recursive by maxdepth
+            fs.get(s, t, recursive=True, maxdepth=1)
+            if source_slash:
+                assert local_fs.isfile(local_join(target, "subfile1"))
+                assert local_fs.isfile(local_join(target, "subfile2"))
+                assert not local_fs.exists(local_join(target, "nesteddir"))
+                assert not local_fs.exists(local_join(target, "subdir"))
+
+                local_fs.rm(
+                    [
+                        local_join(target, "subfile1"),
+                        local_join(target, "subfile2"),
+                    ],
+                    recursive=True,
+                )
+            else:
+                assert local_fs.isdir(local_join(target, "subdir"))
+                assert local_fs.isfile(local_join(target, "subdir", "subfile1"))
+                assert local_fs.isfile(local_join(target, "subdir", "subfile2"))
+                assert not local_fs.exists(local_join(target, "subdir", "nesteddir"))
+
+                local_fs.rm(local_join(target, "subdir"), recursive=True)
+            assert local_fs.ls(target) == []
+
+    def test_get_directory_to_new_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        local_fs,
+        local_join,
+        local_target,
+    ):
+        # Copy scenario 1f
+        source = fs_bulk_operations_scenario_0
+
+        target = local_target
+        local_fs.mkdir(target)
+
+        for source_slash, target_slash in zip([False, True], [False, True]):
+            s = fs_join(source, "subdir")
+            if source_slash:
+                s += "/"
+            t = local_join(target, "newdir")
+            if target_slash:
+                t += "/"
+
+            # Without recursive does nothing
+            fs.get(s, t)
+            assert local_fs.ls(target) == []
+
+            # With recursive
+            fs.get(s, t, recursive=True)
+            assert local_fs.isdir(local_join(target, "newdir"))
+            assert local_fs.isfile(local_join(target, "newdir", "subfile1"))
+            assert local_fs.isfile(local_join(target, "newdir", "subfile2"))
+            assert local_fs.isdir(local_join(target, "newdir", "nesteddir"))
+            assert local_fs.isfile(
+                local_join(target, "newdir", "nesteddir", "nestedfile")
+            )
+            assert not local_fs.exists(local_join(target, "subdir"))
+
+            local_fs.rm(local_join(target, "newdir"), recursive=True)
+            assert local_fs.ls(target) == []
+
+            # Limit recursive by maxdepth
+            fs.get(s, t, recursive=True, maxdepth=1)
+            assert local_fs.isdir(local_join(target, "newdir"))
+            assert local_fs.isfile(local_join(target, "newdir", "subfile1"))
+            assert local_fs.isfile(local_join(target, "newdir", "subfile2"))
+            assert not local_fs.exists(local_join(target, "newdir", "nesteddir"))
+            assert not local_fs.exists(local_join(target, "subdir"))
+
+            local_fs.rm(local_join(target, "newdir"), recursive=True)
+            assert not local_fs.exists(local_join(target, "newdir"))
+
+    def test_get_glob_to_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        local_fs,
+        local_join,
+        local_target,
+    ):
+        # Copy scenario 1g
+        source = fs_bulk_operations_scenario_0
+
+        target = local_target
+        local_fs.mkdir(target)
+
+        for target_slash in [False, True]:
+            t = target + "/" if target_slash else target
+
+            # Without recursive
+            fs.get(fs_join(source, "subdir", "*"), t)
+            assert local_fs.isfile(local_join(target, "subfile1"))
+            assert local_fs.isfile(local_join(target, "subfile2"))
+            assert not local_fs.isdir(local_join(target, "nesteddir"))
+            assert not local_fs.exists(local_join(target, "nesteddir", "nestedfile"))
+            assert not local_fs.exists(local_join(target, "subdir"))
+
+            local_fs.rm(
+                [
+                    local_join(target, "subfile1"),
+                    local_join(target, "subfile2"),
+                ],
+                recursive=True,
+            )
+            assert local_fs.ls(target) == []
+
+            # With recursive
+            for glob, recursive in zip(["*", "**"], [True, False]):
+                fs.get(fs_join(source, "subdir", glob), t, recursive=recursive)
+                assert local_fs.isfile(local_join(target, "subfile1"))
+                assert local_fs.isfile(local_join(target, "subfile2"))
+                assert local_fs.isdir(local_join(target, "nesteddir"))
+                assert local_fs.isfile(local_join(target, "nesteddir", "nestedfile"))
+                assert not local_fs.exists(local_join(target, "subdir"))
+
+                local_fs.rm(
+                    [
+                        local_join(target, "subfile1"),
+                        local_join(target, "subfile2"),
+                        local_join(target, "nesteddir"),
+                    ],
+                    recursive=True,
+                )
+                assert local_fs.ls(target) == []
+
+                # Limit recursive by maxdepth
+                fs.get(
+                    fs_join(source, "subdir", glob), t, recursive=recursive, maxdepth=1
+                )
+                assert local_fs.isfile(local_join(target, "subfile1"))
+                assert local_fs.isfile(local_join(target, "subfile2"))
+                assert not local_fs.exists(local_join(target, "nesteddir"))
+                assert not local_fs.exists(local_join(target, "subdir"))
+
+                local_fs.rm(
+                    [
+                        local_join(target, "subfile1"),
+                        local_join(target, "subfile2"),
+                    ],
+                    recursive=True,
+                )
+                assert local_fs.ls(target) == []
+
+    def test_get_glob_to_new_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        local_fs,
+        local_join,
+        local_target,
+    ):
+        # Copy scenario 1h
+        source = fs_bulk_operations_scenario_0
+
+        target = local_target
+        local_fs.mkdir(target)
+
+        for target_slash in [False, True]:
+            t = fs_join(target, "newdir")
+            if target_slash:
+                t += "/"
+
+            # Without recursive
+            fs.get(fs_join(source, "subdir", "*"), t)
+            assert local_fs.isdir(local_join(target, "newdir"))
+            assert local_fs.isfile(local_join(target, "newdir", "subfile1"))
+            assert local_fs.isfile(local_join(target, "newdir", "subfile2"))
+            assert not local_fs.exists(local_join(target, "newdir", "nesteddir"))
+            assert not local_fs.exists(
+                local_join(target, "newdir", "nesteddir", "nestedfile")
+            )
+            assert not local_fs.exists(local_join(target, "subdir"))
+            assert not local_fs.exists(local_join(target, "newdir", "subdir"))
+
+            local_fs.rm(local_join(target, "newdir"), recursive=True)
+            assert local_fs.ls(target) == []
+
+            # With recursive
+            for glob, recursive in zip(["*", "**"], [True, False]):
+                fs.get(fs_join(source, "subdir", glob), t, recursive=recursive)
+                assert local_fs.isdir(local_join(target, "newdir"))
+                assert local_fs.isfile(local_join(target, "newdir", "subfile1"))
+                assert local_fs.isfile(local_join(target, "newdir", "subfile2"))
+                assert local_fs.isdir(local_join(target, "newdir", "nesteddir"))
+                assert local_fs.isfile(
+                    local_join(target, "newdir", "nesteddir", "nestedfile")
+                )
+                assert not local_fs.exists(local_join(target, "subdir"))
+                assert not local_fs.exists(local_join(target, "newdir", "subdir"))
+
+                local_fs.rm(local_join(target, "newdir"), recursive=True)
+                assert not local_fs.exists(local_join(target, "newdir"))
+
+                # Limit recursive by maxdepth
+                fs.get(
+                    fs_join(source, "subdir", glob), t, recursive=recursive, maxdepth=1
+                )
+                assert local_fs.isdir(local_join(target, "newdir"))
+                assert local_fs.isfile(local_join(target, "newdir", "subfile1"))
+                assert local_fs.isfile(local_join(target, "newdir", "subfile2"))
+                assert not local_fs.exists(local_join(target, "newdir", "nesteddir"))
+                assert not local_fs.exists(local_join(target, "subdir"))
+                assert not local_fs.exists(local_join(target, "newdir", "subdir"))
+
+                local_fs.rm(local_fs.ls(target, detail=False), recursive=True)
+                assert not local_fs.exists(local_join(target, "newdir"))
+
+    @pytest.mark.parametrize(
+        GLOB_EDGE_CASES_TESTS["argnames"],
+        GLOB_EDGE_CASES_TESTS["argvalues"],
+    )
+    def test_get_glob_edge_cases(
+        self,
+        path,
+        recursive,
+        maxdepth,
+        expected,
+        fs,
+        fs_join,
+        fs_glob_edge_cases_files,
+        local_fs,
+        local_join,
+        local_target,
+    ):
+        # Copy scenario 1g
+        source = fs_glob_edge_cases_files
+
+        target = local_target
+
+        for new_dir, target_slash in product([True, False], [True, False]):
+            local_fs.mkdir(target)
+
+            t = local_join(target, "newdir") if new_dir else target
+            t = t + "/" if target_slash else t
+
+            fs.get(fs_join(source, path), t, recursive=recursive, maxdepth=maxdepth)
+
+            output = local_fs.find(target)
+            if new_dir:
+                prefixed_expected = [
+                    make_path_posix(local_join(target, "newdir", p)) for p in expected
+                ]
+            else:
+                prefixed_expected = [
+                    make_path_posix(local_join(target, p)) for p in expected
+                ]
+            assert sorted(output) == sorted(prefixed_expected)
+
+            try:
+                local_fs.rm(target, recursive=True)
+            except FileNotFoundError:
+                pass
+
+    def test_get_list_of_files_to_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        local_fs,
+        local_join,
+        local_target,
+    ):
+        # Copy scenario 2a
+        source = fs_bulk_operations_scenario_0
+
+        target = local_target
+        local_fs.mkdir(target)
+
+        source_files = [
+            fs_join(source, "file1"),
+            fs_join(source, "file2"),
+            fs_join(source, "subdir", "subfile1"),
+        ]
+
+        for target_slash in [False, True]:
+            t = target + "/" if target_slash else target
+
+            fs.get(source_files, t)
+            assert local_fs.isfile(local_join(target, "file1"))
+            assert local_fs.isfile(local_join(target, "file2"))
+            assert local_fs.isfile(local_join(target, "subfile1"))
+
+            local_fs.rm(
+                [
+                    local_join(target, "file1"),
+                    local_join(target, "file2"),
+                    local_join(target, "subfile1"),
+                ],
+                recursive=True,
+            )
+            assert local_fs.ls(target) == []
+
+    def test_get_list_of_files_to_new_directory(
+        self,
+        fs,
+        fs_join,
+        fs_bulk_operations_scenario_0,
+        local_fs,
+        local_join,
+        local_target,
+    ):
+        # Copy scenario 2b
+        source = fs_bulk_operations_scenario_0
+
+        target = local_target
+        local_fs.mkdir(target)
+
+        source_files = [
+            fs_join(source, "file1"),
+            fs_join(source, "file2"),
+            fs_join(source, "subdir", "subfile1"),
+        ]
+
+        fs.get(source_files, local_join(target, "newdir") + "/")  # Note trailing slash
+        assert local_fs.isdir(local_join(target, "newdir"))
+        assert local_fs.isfile(local_join(target, "newdir", "file1"))
+        assert local_fs.isfile(local_join(target, "newdir", "file2"))
+        assert local_fs.isfile(local_join(target, "newdir", "subfile1"))
+
+    def test_get_directory_recursive(
+        self, fs, fs_join, fs_path, local_fs, local_join, local_target
+    ):
+        # https://github.com/fsspec/filesystem_spec/issues/1062
+        # Recursive cp/get/put of source directory into non-existent target directory.
+        src = fs_join(fs_path, "src")
+        src_file = fs_join(src, "file")
+        fs.mkdir(src)
+        fs.touch(src_file)
+
+        target = local_target
+
+        # get without slash
+        assert not local_fs.exists(target)
+        for loop in range(2):
+            fs.get(src, target, recursive=True)
+            assert local_fs.isdir(target)
+
+            if loop == 0:
+                assert local_fs.isfile(local_join(target, "file"))
+                assert not local_fs.exists(local_join(target, "src"))
+            else:
+                assert local_fs.isfile(local_join(target, "file"))
+                assert local_fs.isdir(local_join(target, "src"))
+                assert local_fs.isfile(local_join(target, "src", "file"))
+
+        local_fs.rm(target, recursive=True)
+
+        # get with slash
+        assert not local_fs.exists(target)
+        for loop in range(2):
+            fs.get(src + "/", target, recursive=True)
+            assert local_fs.isdir(target)
+            assert local_fs.isfile(local_join(target, "file"))
+            assert not local_fs.exists(local_join(target, "src"))
+
+    def test_get_directory_without_files_with_same_name_prefix(
+        self,
+        fs,
+        fs_join,
+        local_fs,
+        local_join,
+        local_target,
+        fs_dir_and_file_with_same_name_prefix,
+    ):
+        # Create the test dirs
+        source = fs_dir_and_file_with_same_name_prefix
+        target = local_target
+
+        # Test without glob
+        fs.get(fs_join(source, "subdir"), target, recursive=True)
+
+        assert local_fs.isfile(local_join(target, "subfile.txt"))
+        assert not local_fs.isfile(local_join(target, "subdir.txt"))
+
+        local_fs.rm([local_join(target, "subfile.txt")])
+        assert local_fs.ls(target) == []
+
+        # Test with glob
+        fs.get(fs_join(source, "subdir*"), target, recursive=True)
+
+        assert local_fs.isdir(local_join(target, "subdir"))
+        assert local_fs.isfile(local_join(target, "subdir", "subfile.txt"))
+        assert local_fs.isfile(local_join(target, "subdir.txt"))
+
+    def test_get_with_source_and_destination_as_list(
+        self,
+        fs,
+        fs_join,
+        local_fs,
+        local_join,
+        local_target,
+        fs_10_files_with_hashed_names,
+    ):
+        # Create the test dir
+        source = fs_10_files_with_hashed_names
+        target = local_target
+
+        # Create list of files for source and destination
+        source_files = []
+        destination_files = []
+        for i in range(10):
+            hashed_i = md5(str(i).encode("utf-8")).hexdigest()
+            source_files.append(fs_join(source, f"{hashed_i}.txt"))
+            destination_files.append(
+                make_path_posix(local_join(target, f"{hashed_i}.txt"))
+            )
+
+        # Copy and assert order was kept
+        fs.get(rpath=source_files, lpath=destination_files)
+
+        for i in range(10):
+            file_content = local_fs.cat(destination_files[i]).decode("utf-8")
+            assert file_content == str(i)
diff --git a/llm/Lib/site-packages/fsspec/tests/abstract/put.py b/llm/Lib/site-packages/fsspec/tests/abstract/put.py
new file mode 100644
index 0000000000000000000000000000000000000000..9fc349977f0384d9fc86126498be5c6ad99a21d3
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/tests/abstract/put.py
@@ -0,0 +1,591 @@
+from hashlib import md5
+from itertools import product
+
+import pytest
+
+from fsspec.tests.abstract.common import GLOB_EDGE_CASES_TESTS
+
+
+class AbstractPutTests:
+    def test_put_file_to_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_target,
+        local_join,
+        local_bulk_operations_scenario_0,
+        supports_empty_directories,
+    ):
+        # Copy scenario 1a
+        source = local_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+        if not supports_empty_directories:
+            # Force target directory to exist by adding a dummy file
+            fs.touch(fs_join(target, "dummy"))
+        assert fs.isdir(target)
+
+        target_file2 = fs_join(target, "file2")
+        target_subfile1 = fs_join(target, "subfile1")
+
+        # Copy from source directory
+        fs.put(local_join(source, "file2"), target)
+        assert fs.isfile(target_file2)
+
+        # Copy from sub directory
+        fs.put(local_join(source, "subdir", "subfile1"), target)
+        assert fs.isfile(target_subfile1)
+
+        # Remove copied files
+        fs.rm([target_file2, target_subfile1])
+        assert not fs.exists(target_file2)
+        assert not fs.exists(target_subfile1)
+
+        # Repeat with trailing slash on target
+        fs.put(local_join(source, "file2"), target + "/")
+        assert fs.isdir(target)
+        assert fs.isfile(target_file2)
+
+        fs.put(local_join(source, "subdir", "subfile1"), target + "/")
+        assert fs.isfile(target_subfile1)
+
+    def test_put_file_to_new_directory(
+        self, fs, fs_join, fs_target, local_join, local_bulk_operations_scenario_0
+    ):
+        # Copy scenario 1b
+        source = local_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+
+        fs.put(
+            local_join(source, "subdir", "subfile1"), fs_join(target, "newdir/")
+        )  # Note trailing slash
+        assert fs.isdir(target)
+        assert fs.isdir(fs_join(target, "newdir"))
+        assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+
+    def test_put_file_to_file_in_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_target,
+        local_join,
+        supports_empty_directories,
+        local_bulk_operations_scenario_0,
+    ):
+        # Copy scenario 1c
+        source = local_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+        if not supports_empty_directories:
+            # Force target directory to exist by adding a dummy file
+            fs.touch(fs_join(target, "dummy"))
+        assert fs.isdir(target)
+
+        fs.put(local_join(source, "subdir", "subfile1"), fs_join(target, "newfile"))
+        assert fs.isfile(fs_join(target, "newfile"))
+
+    def test_put_file_to_file_in_new_directory(
+        self, fs, fs_join, fs_target, local_join, local_bulk_operations_scenario_0
+    ):
+        # Copy scenario 1d
+        source = local_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+
+        fs.put(
+            local_join(source, "subdir", "subfile1"),
+            fs_join(target, "newdir", "newfile"),
+        )
+        assert fs.isdir(fs_join(target, "newdir"))
+        assert fs.isfile(fs_join(target, "newdir", "newfile"))
+
+    def test_put_directory_to_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_target,
+        local_bulk_operations_scenario_0,
+        supports_empty_directories,
+    ):
+        # Copy scenario 1e
+        source = local_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+        if not supports_empty_directories:
+            # Force target directory to exist by adding a dummy file
+            dummy = fs_join(target, "dummy")
+            fs.touch(dummy)
+        assert fs.isdir(target)
+
+        for source_slash, target_slash in zip([False, True], [False, True]):
+            s = fs_join(source, "subdir")
+            if source_slash:
+                s += "/"
+            t = target + "/" if target_slash else target
+
+            # Without recursive does nothing
+            fs.put(s, t)
+            assert fs.ls(target, detail=False) == (
+                [] if supports_empty_directories else [dummy]
+            )
+
+            # With recursive
+            fs.put(s, t, recursive=True)
+            if source_slash:
+                assert fs.isfile(fs_join(target, "subfile1"))
+                assert fs.isfile(fs_join(target, "subfile2"))
+                assert fs.isdir(fs_join(target, "nesteddir"))
+                assert fs.isfile(fs_join(target, "nesteddir", "nestedfile"))
+                assert not fs.exists(fs_join(target, "subdir"))
+
+                fs.rm(
+                    [
+                        fs_join(target, "subfile1"),
+                        fs_join(target, "subfile2"),
+                        fs_join(target, "nesteddir"),
+                    ],
+                    recursive=True,
+                )
+            else:
+                assert fs.isdir(fs_join(target, "subdir"))
+                assert fs.isfile(fs_join(target, "subdir", "subfile1"))
+                assert fs.isfile(fs_join(target, "subdir", "subfile2"))
+                assert fs.isdir(fs_join(target, "subdir", "nesteddir"))
+                assert fs.isfile(fs_join(target, "subdir", "nesteddir", "nestedfile"))
+
+                fs.rm(fs_join(target, "subdir"), recursive=True)
+            assert fs.ls(target, detail=False) == (
+                [] if supports_empty_directories else [dummy]
+            )
+
+            # Limit recursive by maxdepth
+            fs.put(s, t, recursive=True, maxdepth=1)
+            if source_slash:
+                assert fs.isfile(fs_join(target, "subfile1"))
+                assert fs.isfile(fs_join(target, "subfile2"))
+                assert not fs.exists(fs_join(target, "nesteddir"))
+                assert not fs.exists(fs_join(target, "subdir"))
+
+                fs.rm(
+                    [
+                        fs_join(target, "subfile1"),
+                        fs_join(target, "subfile2"),
+                    ],
+                    recursive=True,
+                )
+            else:
+                assert fs.isdir(fs_join(target, "subdir"))
+                assert fs.isfile(fs_join(target, "subdir", "subfile1"))
+                assert fs.isfile(fs_join(target, "subdir", "subfile2"))
+                assert not fs.exists(fs_join(target, "subdir", "nesteddir"))
+
+                fs.rm(fs_join(target, "subdir"), recursive=True)
+            assert fs.ls(target, detail=False) == (
+                [] if supports_empty_directories else [dummy]
+            )
+
+    def test_put_directory_to_new_directory(
+        self,
+        fs,
+        fs_join,
+        fs_target,
+        local_bulk_operations_scenario_0,
+        supports_empty_directories,
+    ):
+        # Copy scenario 1f
+        source = local_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+
+        for source_slash, target_slash in zip([False, True], [False, True]):
+            s = fs_join(source, "subdir")
+            if source_slash:
+                s += "/"
+            t = fs_join(target, "newdir")
+            if target_slash:
+                t += "/"
+
+            # Without recursive does nothing
+            fs.put(s, t)
+            if supports_empty_directories:
+                assert fs.ls(target) == []
+            else:
+                with pytest.raises(FileNotFoundError):
+                    fs.ls(target)
+
+            # With recursive
+            fs.put(s, t, recursive=True)
+            assert fs.isdir(fs_join(target, "newdir"))
+            assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+            assert fs.isfile(fs_join(target, "newdir", "subfile2"))
+            assert fs.isdir(fs_join(target, "newdir", "nesteddir"))
+            assert fs.isfile(fs_join(target, "newdir", "nesteddir", "nestedfile"))
+            assert not fs.exists(fs_join(target, "subdir"))
+
+            fs.rm(fs_join(target, "newdir"), recursive=True)
+            assert not fs.exists(fs_join(target, "newdir"))
+
+            # Limit recursive by maxdepth
+            fs.put(s, t, recursive=True, maxdepth=1)
+            assert fs.isdir(fs_join(target, "newdir"))
+            assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+            assert fs.isfile(fs_join(target, "newdir", "subfile2"))
+            assert not fs.exists(fs_join(target, "newdir", "nesteddir"))
+            assert not fs.exists(fs_join(target, "subdir"))
+
+            fs.rm(fs_join(target, "newdir"), recursive=True)
+            assert not fs.exists(fs_join(target, "newdir"))
+
+    def test_put_glob_to_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_target,
+        local_join,
+        supports_empty_directories,
+        local_bulk_operations_scenario_0,
+    ):
+        # Copy scenario 1g
+        source = local_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+        if not supports_empty_directories:
+            # Force target directory to exist by adding a dummy file
+            dummy = fs_join(target, "dummy")
+            fs.touch(dummy)
+        assert fs.isdir(target)
+
+        for target_slash in [False, True]:
+            t = target + "/" if target_slash else target
+
+            # Without recursive
+            fs.put(local_join(source, "subdir", "*"), t)
+            assert fs.isfile(fs_join(target, "subfile1"))
+            assert fs.isfile(fs_join(target, "subfile2"))
+            assert not fs.isdir(fs_join(target, "nesteddir"))
+            assert not fs.exists(fs_join(target, "nesteddir", "nestedfile"))
+            assert not fs.exists(fs_join(target, "subdir"))
+
+            fs.rm(
+                [
+                    fs_join(target, "subfile1"),
+                    fs_join(target, "subfile2"),
+                ],
+                recursive=True,
+            )
+            assert fs.ls(target, detail=False) == (
+                [] if supports_empty_directories else [dummy]
+            )
+
+            # With recursive
+            for glob, recursive in zip(["*", "**"], [True, False]):
+                fs.put(local_join(source, "subdir", glob), t, recursive=recursive)
+                assert fs.isfile(fs_join(target, "subfile1"))
+                assert fs.isfile(fs_join(target, "subfile2"))
+                assert fs.isdir(fs_join(target, "nesteddir"))
+                assert fs.isfile(fs_join(target, "nesteddir", "nestedfile"))
+                assert not fs.exists(fs_join(target, "subdir"))
+
+                fs.rm(
+                    [
+                        fs_join(target, "subfile1"),
+                        fs_join(target, "subfile2"),
+                        fs_join(target, "nesteddir"),
+                    ],
+                    recursive=True,
+                )
+                assert fs.ls(target, detail=False) == (
+                    [] if supports_empty_directories else [dummy]
+                )
+
+                # Limit recursive by maxdepth
+                fs.put(
+                    local_join(source, "subdir", glob),
+                    t,
+                    recursive=recursive,
+                    maxdepth=1,
+                )
+                assert fs.isfile(fs_join(target, "subfile1"))
+                assert fs.isfile(fs_join(target, "subfile2"))
+                assert not fs.exists(fs_join(target, "nesteddir"))
+                assert not fs.exists(fs_join(target, "subdir"))
+
+                fs.rm(
+                    [
+                        fs_join(target, "subfile1"),
+                        fs_join(target, "subfile2"),
+                    ],
+                    recursive=True,
+                )
+                assert fs.ls(target, detail=False) == (
+                    [] if supports_empty_directories else [dummy]
+                )
+
+    def test_put_glob_to_new_directory(
+        self, fs, fs_join, fs_target, local_join, local_bulk_operations_scenario_0
+    ):
+        # Copy scenario 1h
+        source = local_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+
+        for target_slash in [False, True]:
+            t = fs_join(target, "newdir")
+            if target_slash:
+                t += "/"
+
+            # Without recursive
+            fs.put(local_join(source, "subdir", "*"), t)
+            assert fs.isdir(fs_join(target, "newdir"))
+            assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+            assert fs.isfile(fs_join(target, "newdir", "subfile2"))
+            assert not fs.exists(fs_join(target, "newdir", "nesteddir"))
+            assert not fs.exists(fs_join(target, "newdir", "nesteddir", "nestedfile"))
+            assert not fs.exists(fs_join(target, "subdir"))
+            assert not fs.exists(fs_join(target, "newdir", "subdir"))
+
+            fs.rm(fs_join(target, "newdir"), recursive=True)
+            assert not fs.exists(fs_join(target, "newdir"))
+
+            # With recursive
+            for glob, recursive in zip(["*", "**"], [True, False]):
+                fs.put(local_join(source, "subdir", glob), t, recursive=recursive)
+                assert fs.isdir(fs_join(target, "newdir"))
+                assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+                assert fs.isfile(fs_join(target, "newdir", "subfile2"))
+                assert fs.isdir(fs_join(target, "newdir", "nesteddir"))
+                assert fs.isfile(fs_join(target, "newdir", "nesteddir", "nestedfile"))
+                assert not fs.exists(fs_join(target, "subdir"))
+                assert not fs.exists(fs_join(target, "newdir", "subdir"))
+
+                fs.rm(fs_join(target, "newdir"), recursive=True)
+                assert not fs.exists(fs_join(target, "newdir"))
+
+                # Limit recursive by maxdepth
+                fs.put(
+                    local_join(source, "subdir", glob),
+                    t,
+                    recursive=recursive,
+                    maxdepth=1,
+                )
+                assert fs.isdir(fs_join(target, "newdir"))
+                assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+                assert fs.isfile(fs_join(target, "newdir", "subfile2"))
+                assert not fs.exists(fs_join(target, "newdir", "nesteddir"))
+                assert not fs.exists(fs_join(target, "subdir"))
+                assert not fs.exists(fs_join(target, "newdir", "subdir"))
+
+                fs.rm(fs_join(target, "newdir"), recursive=True)
+                assert not fs.exists(fs_join(target, "newdir"))
+
+    @pytest.mark.parametrize(
+        GLOB_EDGE_CASES_TESTS["argnames"],
+        GLOB_EDGE_CASES_TESTS["argvalues"],
+    )
+    def test_put_glob_edge_cases(
+        self,
+        path,
+        recursive,
+        maxdepth,
+        expected,
+        fs,
+        fs_join,
+        fs_target,
+        local_glob_edge_cases_files,
+        local_join,
+        fs_sanitize_path,
+    ):
+        # Copy scenario 1g
+        source = local_glob_edge_cases_files
+
+        target = fs_target
+
+        for new_dir, target_slash in product([True, False], [True, False]):
+            fs.mkdir(target)
+
+            t = fs_join(target, "newdir") if new_dir else target
+            t = t + "/" if target_slash else t
+
+            fs.put(local_join(source, path), t, recursive=recursive, maxdepth=maxdepth)
+
+            output = fs.find(target)
+            if new_dir:
+                prefixed_expected = [
+                    fs_sanitize_path(fs_join(target, "newdir", p)) for p in expected
+                ]
+            else:
+                prefixed_expected = [
+                    fs_sanitize_path(fs_join(target, p)) for p in expected
+                ]
+            assert sorted(output) == sorted(prefixed_expected)
+
+            try:
+                fs.rm(target, recursive=True)
+            except FileNotFoundError:
+                pass
+
+    def test_put_list_of_files_to_existing_directory(
+        self,
+        fs,
+        fs_join,
+        fs_target,
+        local_join,
+        local_bulk_operations_scenario_0,
+        supports_empty_directories,
+    ):
+        # Copy scenario 2a
+        source = local_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+        if not supports_empty_directories:
+            # Force target directory to exist by adding a dummy file
+            dummy = fs_join(target, "dummy")
+            fs.touch(dummy)
+        assert fs.isdir(target)
+
+        source_files = [
+            local_join(source, "file1"),
+            local_join(source, "file2"),
+            local_join(source, "subdir", "subfile1"),
+        ]
+
+        for target_slash in [False, True]:
+            t = target + "/" if target_slash else target
+
+            fs.put(source_files, t)
+            assert fs.isfile(fs_join(target, "file1"))
+            assert fs.isfile(fs_join(target, "file2"))
+            assert fs.isfile(fs_join(target, "subfile1"))
+
+            fs.rm(
+                [
+                    fs_join(target, "file1"),
+                    fs_join(target, "file2"),
+                    fs_join(target, "subfile1"),
+                ],
+                recursive=True,
+            )
+            assert fs.ls(target, detail=False) == (
+                [] if supports_empty_directories else [dummy]
+            )
+
+    def test_put_list_of_files_to_new_directory(
+        self, fs, fs_join, fs_target, local_join, local_bulk_operations_scenario_0
+    ):
+        # Copy scenario 2b
+        source = local_bulk_operations_scenario_0
+
+        target = fs_target
+        fs.mkdir(target)
+
+        source_files = [
+            local_join(source, "file1"),
+            local_join(source, "file2"),
+            local_join(source, "subdir", "subfile1"),
+        ]
+
+        fs.put(source_files, fs_join(target, "newdir") + "/")  # Note trailing slash
+        assert fs.isdir(fs_join(target, "newdir"))
+        assert fs.isfile(fs_join(target, "newdir", "file1"))
+        assert fs.isfile(fs_join(target, "newdir", "file2"))
+        assert fs.isfile(fs_join(target, "newdir", "subfile1"))
+
+    def test_put_directory_recursive(
+        self, fs, fs_join, fs_target, local_fs, local_join, local_path
+    ):
+        # https://github.com/fsspec/filesystem_spec/issues/1062
+        # Recursive cp/get/put of source directory into non-existent target directory.
+        src = local_join(local_path, "src")
+        src_file = local_join(src, "file")
+        local_fs.mkdir(src)
+        local_fs.touch(src_file)
+
+        target = fs_target
+
+        # put without slash
+        assert not fs.exists(target)
+        for loop in range(2):
+            fs.put(src, target, recursive=True)
+            assert fs.isdir(target)
+
+            if loop == 0:
+                assert fs.isfile(fs_join(target, "file"))
+                assert not fs.exists(fs_join(target, "src"))
+            else:
+                assert fs.isfile(fs_join(target, "file"))
+                assert fs.isdir(fs_join(target, "src"))
+                assert fs.isfile(fs_join(target, "src", "file"))
+
+        fs.rm(target, recursive=True)
+
+        # put with slash
+        assert not fs.exists(target)
+        for loop in range(2):
+            fs.put(src + "/", target, recursive=True)
+            assert fs.isdir(target)
+            assert fs.isfile(fs_join(target, "file"))
+            assert not fs.exists(fs_join(target, "src"))
+
+    def test_put_directory_without_files_with_same_name_prefix(
+        self,
+        fs,
+        fs_join,
+        fs_target,
+        local_join,
+        local_dir_and_file_with_same_name_prefix,
+        supports_empty_directories,
+    ):
+        # Create the test dirs
+        source = local_dir_and_file_with_same_name_prefix
+        target = fs_target
+
+        # Test without glob
+        fs.put(local_join(source, "subdir"), fs_target, recursive=True)
+
+        assert fs.isfile(fs_join(fs_target, "subfile.txt"))
+        assert not fs.isfile(fs_join(fs_target, "subdir.txt"))
+
+        fs.rm([fs_join(target, "subfile.txt")])
+        if supports_empty_directories:
+            assert fs.ls(target) == []
+        else:
+            assert not fs.exists(target)
+
+        # Test with glob
+        fs.put(local_join(source, "subdir*"), fs_target, recursive=True)
+
+        assert fs.isdir(fs_join(fs_target, "subdir"))
+        assert fs.isfile(fs_join(fs_target, "subdir", "subfile.txt"))
+        assert fs.isfile(fs_join(fs_target, "subdir.txt"))
+
+    def test_copy_with_source_and_destination_as_list(
+        self, fs, fs_target, fs_join, local_join, local_10_files_with_hashed_names
+    ):
+        # Create the test dir
+        source = local_10_files_with_hashed_names
+        target = fs_target
+
+        # Create list of files for source and destination
+        source_files = []
+        destination_files = []
+        for i in range(10):
+            hashed_i = md5(str(i).encode("utf-8")).hexdigest()
+            source_files.append(local_join(source, f"{hashed_i}.txt"))
+            destination_files.append(fs_join(target, f"{hashed_i}.txt"))
+
+        # Copy and assert order was kept
+        fs.put(lpath=source_files, rpath=destination_files)
+
+        for i in range(10):
+            file_content = fs.cat(destination_files[i]).decode("utf-8")
+            assert file_content == str(i)
diff --git a/llm/Lib/site-packages/fsspec/transaction.py b/llm/Lib/site-packages/fsspec/transaction.py
new file mode 100644
index 0000000000000000000000000000000000000000..77293f63ecc5f611e19d849ef236d53e9c258efc
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/transaction.py
@@ -0,0 +1,90 @@
+from collections import deque
+
+
+class Transaction:
+    """Filesystem transaction write context
+
+    Gathers files for deferred commit or discard, so that several write
+    operations can be finalized semi-atomically. This works by having this
+    instance as the ``.transaction`` attribute of the given filesystem
+    """
+
+    def __init__(self, fs, **kwargs):
+        """
+        Parameters
+        ----------
+        fs: FileSystem instance
+        """
+        self.fs = fs
+        self.files = deque()
+
+    def __enter__(self):
+        self.start()
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        """End transaction and commit, if exit is not due to exception"""
+        # only commit if there was no exception
+        self.complete(commit=exc_type is None)
+        if self.fs:
+            self.fs._intrans = False
+            self.fs._transaction = None
+            self.fs = None
+
+    def start(self):
+        """Start a transaction on this FileSystem"""
+        self.files = deque()  # clean up after previous failed completions
+        self.fs._intrans = True
+
+    def complete(self, commit=True):
+        """Finish transaction: commit or discard all deferred files"""
+        while self.files:
+            f = self.files.popleft()
+            if commit:
+                f.commit()
+            else:
+                f.discard()
+        self.fs._intrans = False
+        self.fs._transaction = None
+        self.fs = None
+
+
+class FileActor:
+    def __init__(self):
+        self.files = []
+
+    def commit(self):
+        for f in self.files:
+            f.commit()
+        self.files.clear()
+
+    def discard(self):
+        for f in self.files:
+            f.discard()
+        self.files.clear()
+
+    def append(self, f):
+        self.files.append(f)
+
+
+class DaskTransaction(Transaction):
+    def __init__(self, fs):
+        """
+        Parameters
+        ----------
+        fs: FileSystem instance
+        """
+        import distributed
+
+        super().__init__(fs)
+        client = distributed.default_client()
+        self.files = client.submit(FileActor, actor=True).result()
+
+    def complete(self, commit=True):
+        """Finish transaction: commit or discard all deferred files"""
+        if commit:
+            self.files.commit().result()
+        else:
+            self.files.discard().result()
+        self.fs._intrans = False
+        self.fs = None
diff --git a/llm/Lib/site-packages/fsspec/utils.py b/llm/Lib/site-packages/fsspec/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba3f80be36d4aa4f2f56df10549c1dff6b72e43b
--- /dev/null
+++ b/llm/Lib/site-packages/fsspec/utils.py
@@ -0,0 +1,742 @@
+from __future__ import annotations
+
+import contextlib
+import logging
+import math
+import os
+import pathlib
+import re
+import sys
+import tempfile
+from functools import partial
+from hashlib import md5
+from importlib.metadata import version
+from typing import (
+    IO,
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Iterable,
+    Iterator,
+    Sequence,
+    TypeVar,
+)
+from urllib.parse import urlsplit
+
+if TYPE_CHECKING:
+    from typing_extensions import TypeGuard
+
+    from fsspec.spec import AbstractFileSystem
+
+
+DEFAULT_BLOCK_SIZE = 5 * 2**20
+
+T = TypeVar("T")
+
+
+def infer_storage_options(
+    urlpath: str, inherit_storage_options: dict[str, Any] | None = None
+) -> dict[str, Any]:
+    """Infer storage options from URL path and merge it with existing storage
+    options.
+
+    Parameters
+    ----------
+    urlpath: str or unicode
+        Either local absolute file path or URL (hdfs://namenode:8020/file.csv)
+    inherit_storage_options: dict (optional)
+        Its contents will get merged with the inferred information from the
+        given path
+
+    Returns
+    -------
+    Storage options dict.
+
+    Examples
+    --------
+    >>> infer_storage_options('/mnt/datasets/test.csv')  # doctest: +SKIP
+    {"protocol": "file", "path", "/mnt/datasets/test.csv"}
+    >>> infer_storage_options(
+    ...     'hdfs://username:pwd@node:123/mnt/datasets/test.csv?q=1',
+    ...     inherit_storage_options={'extra': 'value'},
+    ... )  # doctest: +SKIP
+    {"protocol": "hdfs", "username": "username", "password": "pwd",
+    "host": "node", "port": 123, "path": "/mnt/datasets/test.csv",
+    "url_query": "q=1", "extra": "value"}
+    """
+    # Handle Windows paths including disk name in this special case
+    if (
+        re.match(r"^[a-zA-Z]:[\\/]", urlpath)
+        or re.match(r"^[a-zA-Z0-9]+://", urlpath) is None
+    ):
+        return {"protocol": "file", "path": urlpath}
+
+    parsed_path = urlsplit(urlpath)
+    protocol = parsed_path.scheme or "file"
+    if parsed_path.fragment:
+        path = "#".join([parsed_path.path, parsed_path.fragment])
+    else:
+        path = parsed_path.path
+    if protocol == "file":
+        # Special case parsing file protocol URL on Windows according to:
+        # https://msdn.microsoft.com/en-us/library/jj710207.aspx
+        windows_path = re.match(r"^/([a-zA-Z])[:|]([\\/].*)$", path)
+        if windows_path:
+            path = "%s:%s" % windows_path.groups()
+
+    if protocol in ["http", "https"]:
+        # for HTTP, we don't want to parse, as requests will anyway
+        return {"protocol": protocol, "path": urlpath}
+
+    options: dict[str, Any] = {"protocol": protocol, "path": path}
+
+    if parsed_path.netloc:
+        # Parse `hostname` from netloc manually because `parsed_path.hostname`
+        # lowercases the hostname which is not always desirable (e.g. in S3):
+        # https://github.com/dask/dask/issues/1417
+        options["host"] = parsed_path.netloc.rsplit("@", 1)[-1].rsplit(":", 1)[0]
+
+        if protocol in ("s3", "s3a", "gcs", "gs"):
+            options["path"] = options["host"] + options["path"]
+        else:
+            options["host"] = options["host"]
+        if parsed_path.port:
+            options["port"] = parsed_path.port
+        if parsed_path.username:
+            options["username"] = parsed_path.username
+        if parsed_path.password:
+            options["password"] = parsed_path.password
+
+    if parsed_path.query:
+        options["url_query"] = parsed_path.query
+    if parsed_path.fragment:
+        options["url_fragment"] = parsed_path.fragment
+
+    if inherit_storage_options:
+        update_storage_options(options, inherit_storage_options)
+
+    return options
+
+
+def update_storage_options(
+    options: dict[str, Any], inherited: dict[str, Any] | None = None
+) -> None:
+    if not inherited:
+        inherited = {}
+    collisions = set(options) & set(inherited)
+    if collisions:
+        for collision in collisions:
+            if options.get(collision) != inherited.get(collision):
+                raise KeyError(
+                    f"Collision between inferred and specified storage "
+                    f"option:\n{collision}"
+                )
+    options.update(inherited)
+
+
+# Compression extensions registered via fsspec.compression.register_compression
+compressions: dict[str, str] = {}
+
+
+def infer_compression(filename: str) -> str | None:
+    """Infer compression, if available, from filename.
+
+    Infer a named compression type, if registered and available, from filename
+    extension. This includes builtin (gz, bz2, zip) compressions, as well as
+    optional compressions. See fsspec.compression.register_compression.
+    """
+    extension = os.path.splitext(filename)[-1].strip(".").lower()
+    if extension in compressions:
+        return compressions[extension]
+    return None
+
+
+def build_name_function(max_int: float) -> Callable[[int], str]:
+    """Returns a function that receives a single integer
+    and returns it as a string padded by enough zero characters
+    to align with maximum possible integer
+
+    >>> name_f = build_name_function(57)
+
+    >>> name_f(7)
+    '07'
+    >>> name_f(31)
+    '31'
+    >>> build_name_function(1000)(42)
+    '0042'
+    >>> build_name_function(999)(42)
+    '042'
+    >>> build_name_function(0)(0)
+    '0'
+    """
+    # handle corner cases max_int is 0 or exact power of 10
+    max_int += 1e-8
+
+    pad_length = int(math.ceil(math.log10(max_int)))
+
+    def name_function(i: int) -> str:
+        return str(i).zfill(pad_length)
+
+    return name_function
+
+
+def seek_delimiter(file: IO[bytes], delimiter: bytes, blocksize: int) -> bool:
+    r"""Seek current file to file start, file end, or byte after delimiter seq.
+
+    Seeks file to next chunk delimiter, where chunks are defined on file start,
+    a delimiting sequence, and file end. Use file.tell() to see location afterwards.
+    Note that file start is a valid split, so must be at offset > 0 to seek for
+    delimiter.
+
+    Parameters
+    ----------
+    file: a file
+    delimiter: bytes
+        a delimiter like ``b'\n'`` or message sentinel, matching file .read() type
+    blocksize: int
+        Number of bytes to read from the file at once.
+
+
+    Returns
+    -------
+    Returns True if a delimiter was found, False if at file start or end.
+
+    """
+
+    if file.tell() == 0:
+        # beginning-of-file, return without seek
+        return False
+
+    # Interface is for binary IO, with delimiter as bytes, but initialize last
+    # with result of file.read to preserve compatibility with text IO.
+    last: bytes | None = None
+    while True:
+        current = file.read(blocksize)
+        if not current:
+            # end-of-file without delimiter
+            return False
+        full = last + current if last else current
+        try:
+            if delimiter in full:
+                i = full.index(delimiter)
+                file.seek(file.tell() - (len(full) - i) + len(delimiter))
+                return True
+            elif len(current) < blocksize:
+                # end-of-file without delimiter
+                return False
+        except (OSError, ValueError):
+            pass
+        last = full[-len(delimiter) :]
+
+
+def read_block(
+    f: IO[bytes],
+    offset: int,
+    length: int | None,
+    delimiter: bytes | None = None,
+    split_before: bool = False,
+) -> bytes:
+    """Read a block of bytes from a file
+
+    Parameters
+    ----------
+    f: File
+        Open file
+    offset: int
+        Byte offset to start read
+    length: int
+        Number of bytes to read, read through end of file if None
+    delimiter: bytes (optional)
+        Ensure reading starts and stops at delimiter bytestring
+    split_before: bool (optional)
+        Start/stop read *before* delimiter bytestring.
+
+
+    If using the ``delimiter=`` keyword argument we ensure that the read
+    starts and stops at delimiter boundaries that follow the locations
+    ``offset`` and ``offset + length``.  If ``offset`` is zero then we
+    start at zero, regardless of delimiter.  The bytestring returned WILL
+    include the terminating delimiter string.
+
+    Examples
+    --------
+
+    >>> from io import BytesIO  # doctest: +SKIP
+    >>> f = BytesIO(b'Alice, 100\\nBob, 200\\nCharlie, 300')  # doctest: +SKIP
+    >>> read_block(f, 0, 13)  # doctest: +SKIP
+    b'Alice, 100\\nBo'
+
+    >>> read_block(f, 0, 13, delimiter=b'\\n')  # doctest: +SKIP
+    b'Alice, 100\\nBob, 200\\n'
+
+    >>> read_block(f, 10, 10, delimiter=b'\\n')  # doctest: +SKIP
+    b'Bob, 200\\nCharlie, 300'
+    """
+    if delimiter:
+        f.seek(offset)
+        found_start_delim = seek_delimiter(f, delimiter, 2**16)
+        if length is None:
+            return f.read()
+        start = f.tell()
+        length -= start - offset
+
+        f.seek(start + length)
+        found_end_delim = seek_delimiter(f, delimiter, 2**16)
+        end = f.tell()
+
+        # Adjust split location to before delimiter if seek found the
+        # delimiter sequence, not start or end of file.
+        if found_start_delim and split_before:
+            start -= len(delimiter)
+
+        if found_end_delim and split_before:
+            end -= len(delimiter)
+
+        offset = start
+        length = end - start
+
+    f.seek(offset)
+
+    # TODO: allow length to be None and read to the end of the file?
+    assert length is not None
+    b = f.read(length)
+    return b
+
+
+def tokenize(*args: Any, **kwargs: Any) -> str:
+    """Deterministic token
+
+    (modified from dask.base)
+
+    >>> tokenize([1, 2, '3'])
+    '9d71491b50023b06fc76928e6eddb952'
+
+    >>> tokenize('Hello') == tokenize('Hello')
+    True
+    """
+    if kwargs:
+        args += (kwargs,)
+    try:
+        h = md5(str(args).encode())
+    except ValueError:
+        # FIPS systems: https://github.com/fsspec/filesystem_spec/issues/380
+        h = md5(str(args).encode(), usedforsecurity=False)
+    return h.hexdigest()
+
+
+def stringify_path(filepath: str | os.PathLike[str] | pathlib.Path) -> str:
+    """Attempt to convert a path-like object to a string.
+
+    Parameters
+    ----------
+    filepath: object to be converted
+
+    Returns
+    -------
+    filepath_str: maybe a string version of the object
+
+    Notes
+    -----
+    Objects supporting the fspath protocol are coerced according to its
+    __fspath__ method.
+
+    For backwards compatibility with older Python version, pathlib.Path
+    objects are specially coerced.
+
+    Any other object is passed through unchanged, which includes bytes,
+    strings, buffers, or anything else that's not even path-like.
+    """
+    if isinstance(filepath, str):
+        return filepath
+    elif hasattr(filepath, "__fspath__"):
+        return filepath.__fspath__()
+    elif isinstance(filepath, pathlib.Path):
+        return str(filepath)
+    elif hasattr(filepath, "path"):
+        return filepath.path
+    else:
+        return filepath  # type: ignore[return-value]
+
+
+def make_instance(
+    cls: Callable[..., T], args: Sequence[Any], kwargs: dict[str, Any]
+) -> T:
+    inst = cls(*args, **kwargs)
+    inst._determine_worker()  # type: ignore[attr-defined]
+    return inst
+
+
+def common_prefix(paths: Iterable[str]) -> str:
+    """For a list of paths, find the shortest prefix common to all"""
+    parts = [p.split("/") for p in paths]
+    lmax = min(len(p) for p in parts)
+    end = 0
+    for i in range(lmax):
+        end = all(p[i] == parts[0][i] for p in parts)
+        if not end:
+            break
+    i += end
+    return "/".join(parts[0][:i])
+
+
+def other_paths(
+    paths: list[str],
+    path2: str | list[str],
+    exists: bool = False,
+    flatten: bool = False,
+) -> list[str]:
+    """In bulk file operations, construct a new file tree from a list of files
+
+    Parameters
+    ----------
+    paths: list of str
+        The input file tree
+    path2: str or list of str
+        Root to construct the new list in. If this is already a list of str, we just
+        assert it has the right number of elements.
+    exists: bool (optional)
+        For a str destination, it is already exists (and is a dir), files should
+        end up inside.
+    flatten: bool (optional)
+        Whether to flatten the input directory tree structure so that the output files
+        are in the same directory.
+
+    Returns
+    -------
+    list of str
+    """
+
+    if isinstance(path2, str):
+        path2 = path2.rstrip("/")
+
+        if flatten:
+            path2 = ["/".join((path2, p.split("/")[-1])) for p in paths]
+        else:
+            cp = common_prefix(paths)
+            if exists:
+                cp = cp.rsplit("/", 1)[0]
+            if not cp and all(not s.startswith("/") for s in paths):
+                path2 = ["/".join([path2, p]) for p in paths]
+            else:
+                path2 = [p.replace(cp, path2, 1) for p in paths]
+    else:
+        assert len(paths) == len(path2)
+    return path2
+
+
+def is_exception(obj: Any) -> bool:
+    return isinstance(obj, BaseException)
+
+
+def isfilelike(f: Any) -> TypeGuard[IO[bytes]]:
+    for attr in ["read", "close", "tell"]:
+        if not hasattr(f, attr):
+            return False
+    return True
+
+
+def get_protocol(url: str) -> str:
+    url = stringify_path(url)
+    parts = re.split(r"(\:\:|\://)", url, 1)
+    if len(parts) > 1:
+        return parts[0]
+    return "file"
+
+
+def can_be_local(path: str) -> bool:
+    """Can the given URL be used with open_local?"""
+    from fsspec import get_filesystem_class
+
+    try:
+        return getattr(get_filesystem_class(get_protocol(path)), "local_file", False)
+    except (ValueError, ImportError):
+        # not in registry or import failed
+        return False
+
+
+def get_package_version_without_import(name: str) -> str | None:
+    """For given package name, try to find the version without importing it
+
+    Import and package.__version__ is still the backup here, so an import
+    *might* happen.
+
+    Returns either the version string, or None if the package
+    or the version was not readily  found.
+    """
+    if name in sys.modules:
+        mod = sys.modules[name]
+        if hasattr(mod, "__version__"):
+            return mod.__version__
+    try:
+        return version(name)
+    except:  # noqa: E722
+        pass
+    try:
+        import importlib
+
+        mod = importlib.import_module(name)
+        return mod.__version__
+    except (ImportError, AttributeError):
+        return None
+
+
+def setup_logging(
+    logger: logging.Logger | None = None,
+    logger_name: str | None = None,
+    level: str = "DEBUG",
+    clear: bool = True,
+) -> logging.Logger:
+    if logger is None and logger_name is None:
+        raise ValueError("Provide either logger object or logger name")
+    logger = logger or logging.getLogger(logger_name)
+    handle = logging.StreamHandler()
+    formatter = logging.Formatter(
+        "%(asctime)s - %(name)s - %(levelname)s - %(funcName)s -- %(message)s"
+    )
+    handle.setFormatter(formatter)
+    if clear:
+        logger.handlers.clear()
+    logger.addHandler(handle)
+    logger.setLevel(level)
+    return logger
+
+
+def _unstrip_protocol(name: str, fs: AbstractFileSystem) -> str:
+    return fs.unstrip_protocol(name)
+
+
+def mirror_from(
+    origin_name: str, methods: Iterable[str]
+) -> Callable[[type[T]], type[T]]:
+    """Mirror attributes and methods from the given
+    origin_name attribute of the instance to the
+    decorated class"""
+
+    def origin_getter(method: str, self: Any) -> Any:
+        origin = getattr(self, origin_name)
+        return getattr(origin, method)
+
+    def wrapper(cls: type[T]) -> type[T]:
+        for method in methods:
+            wrapped_method = partial(origin_getter, method)
+            setattr(cls, method, property(wrapped_method))
+        return cls
+
+    return wrapper
+
+
+@contextlib.contextmanager
+def nullcontext(obj: T) -> Iterator[T]:
+    yield obj
+
+
+def merge_offset_ranges(
+    paths: list[str],
+    starts: list[int] | int,
+    ends: list[int] | int,
+    max_gap: int = 0,
+    max_block: int | None = None,
+    sort: bool = True,
+) -> tuple[list[str], list[int], list[int]]:
+    """Merge adjacent byte-offset ranges when the inter-range
+    gap is <= `max_gap`, and when the merged byte range does not
+    exceed `max_block` (if specified). By default, this function
+    will re-order the input paths and byte ranges to ensure sorted
+    order. If the user can guarantee that the inputs are already
+    sorted, passing `sort=False` will skip the re-ordering.
+    """
+    # Check input
+    if not isinstance(paths, list):
+        raise TypeError
+    if not isinstance(starts, list):
+        starts = [starts] * len(paths)
+    if not isinstance(ends, list):
+        ends = [ends] * len(paths)
+    if len(starts) != len(paths) or len(ends) != len(paths):
+        raise ValueError
+
+    # Early Return
+    if len(starts) <= 1:
+        return paths, starts, ends
+
+    starts = [s or 0 for s in starts]
+    # Sort by paths and then ranges if `sort=True`
+    if sort:
+        paths, starts, ends = (
+            list(v)
+            for v in zip(
+                *sorted(
+                    zip(paths, starts, ends),
+                )
+            )
+        )
+
+    if paths:
+        # Loop through the coupled `paths`, `starts`, and
+        # `ends`, and merge adjacent blocks when appropriate
+        new_paths = paths[:1]
+        new_starts = starts[:1]
+        new_ends = ends[:1]
+        for i in range(1, len(paths)):
+            if paths[i] == paths[i - 1] and new_ends[-1] is None:
+                continue
+            elif (
+                paths[i] != paths[i - 1]
+                or ((starts[i] - new_ends[-1]) > max_gap)
+                or (max_block is not None and (ends[i] - new_starts[-1]) > max_block)
+            ):
+                # Cannot merge with previous block.
+                # Add new `paths`, `starts`, and `ends` elements
+                new_paths.append(paths[i])
+                new_starts.append(starts[i])
+                new_ends.append(ends[i])
+            else:
+                # Merge with previous block by updating the
+                # last element of `ends`
+                new_ends[-1] = ends[i]
+        return new_paths, new_starts, new_ends
+
+    # `paths` is empty. Just return input lists
+    return paths, starts, ends
+
+
+def file_size(filelike: IO[bytes]) -> int:
+    """Find length of any open read-mode file-like"""
+    pos = filelike.tell()
+    try:
+        return filelike.seek(0, 2)
+    finally:
+        filelike.seek(pos)
+
+
+@contextlib.contextmanager
+def atomic_write(path: str, mode: str = "wb"):
+    """
+    A context manager that opens a temporary file next to `path` and, on exit,
+    replaces `path` with the temporary file, thereby updating `path`
+    atomically.
+    """
+    fd, fn = tempfile.mkstemp(
+        dir=os.path.dirname(path), prefix=os.path.basename(path) + "-"
+    )
+    try:
+        with open(fd, mode) as fp:
+            yield fp
+    except BaseException:
+        with contextlib.suppress(FileNotFoundError):
+            os.unlink(fn)
+        raise
+    else:
+        os.replace(fn, path)
+
+
+def _translate(pat, STAR, QUESTION_MARK):
+    # Copied from: https://github.com/python/cpython/pull/106703.
+    res: list[str] = []
+    add = res.append
+    i, n = 0, len(pat)
+    while i < n:
+        c = pat[i]
+        i = i + 1
+        if c == "*":
+            # compress consecutive `*` into one
+            if (not res) or res[-1] is not STAR:
+                add(STAR)
+        elif c == "?":
+            add(QUESTION_MARK)
+        elif c == "[":
+            j = i
+            if j < n and pat[j] == "!":
+                j = j + 1
+            if j < n and pat[j] == "]":
+                j = j + 1
+            while j < n and pat[j] != "]":
+                j = j + 1
+            if j >= n:
+                add("\\[")
+            else:
+                stuff = pat[i:j]
+                if "-" not in stuff:
+                    stuff = stuff.replace("\\", r"\\")
+                else:
+                    chunks = []
+                    k = i + 2 if pat[i] == "!" else i + 1
+                    while True:
+                        k = pat.find("-", k, j)
+                        if k < 0:
+                            break
+                        chunks.append(pat[i:k])
+                        i = k + 1
+                        k = k + 3
+                    chunk = pat[i:j]
+                    if chunk:
+                        chunks.append(chunk)
+                    else:
+                        chunks[-1] += "-"
+                    # Remove empty ranges -- invalid in RE.
+                    for k in range(len(chunks) - 1, 0, -1):
+                        if chunks[k - 1][-1] > chunks[k][0]:
+                            chunks[k - 1] = chunks[k - 1][:-1] + chunks[k][1:]
+                            del chunks[k]
+                    # Escape backslashes and hyphens for set difference (--).
+                    # Hyphens that create ranges shouldn't be escaped.
+                    stuff = "-".join(
+                        s.replace("\\", r"\\").replace("-", r"\-") for s in chunks
+                    )
+                # Escape set operations (&&, ~~ and ||).
+                stuff = re.sub(r"([&~|])", r"\\\1", stuff)
+                i = j + 1
+                if not stuff:
+                    # Empty range: never match.
+                    add("(?!)")
+                elif stuff == "!":
+                    # Negated empty range: match any character.
+                    add(".")
+                else:
+                    if stuff[0] == "!":
+                        stuff = "^" + stuff[1:]
+                    elif stuff[0] in ("^", "["):
+                        stuff = "\\" + stuff
+                    add(f"[{stuff}]")
+        else:
+            add(re.escape(c))
+    assert i == n
+    return res
+
+
+def glob_translate(pat):
+    # Copied from: https://github.com/python/cpython/pull/106703.
+    # The keyword parameters' values are fixed to:
+    # recursive=True, include_hidden=True, seps=None
+    """Translate a pathname with shell wildcards to a regular expression."""
+    if os.path.altsep:
+        seps = os.path.sep + os.path.altsep
+    else:
+        seps = os.path.sep
+    escaped_seps = "".join(map(re.escape, seps))
+    any_sep = f"[{escaped_seps}]" if len(seps) > 1 else escaped_seps
+    not_sep = f"[^{escaped_seps}]"
+    one_last_segment = f"{not_sep}+"
+    one_segment = f"{one_last_segment}{any_sep}"
+    any_segments = f"(?:.+{any_sep})?"
+    any_last_segments = ".*"
+    results = []
+    parts = re.split(any_sep, pat)
+    last_part_idx = len(parts) - 1
+    for idx, part in enumerate(parts):
+        if part == "*":
+            results.append(one_segment if idx < last_part_idx else one_last_segment)
+            continue
+        if part == "**":
+            results.append(any_segments if idx < last_part_idx else any_last_segments)
+            continue
+        elif "**" in part:
+            raise ValueError(
+                "Invalid pattern: '**' can only be an entire path component"
+            )
+        if part:
+            results.extend(_translate(part, f"{not_sep}*", not_sep))
+        if idx < last_part_idx:
+            results.append(any_sep)
+    res = "".join(results)
+    return rf"(?s:{res})\Z"
diff --git a/llm/Lib/site-packages/functorch/_C.cp311-win_amd64.pyd b/llm/Lib/site-packages/functorch/_C.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..07e4565bb47ae48aa915f87324112e6206a4ee4e
Binary files /dev/null and b/llm/Lib/site-packages/functorch/_C.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/functorch/__init__.py b/llm/Lib/site-packages/functorch/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f8902dccdfa98d0b5503ea3636b156cf42f36d6
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/__init__.py
@@ -0,0 +1,38 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+import torch
+
+from torch._functorch.deprecated import (
+    combine_state_for_ensemble,
+    functionalize,
+    grad,
+    grad_and_value,
+    hessian,
+    jacfwd,
+    jacrev,
+    jvp,
+    make_functional,
+    make_functional_with_buffers,
+    vjp,
+    vmap,
+)
+
+# utilities. Maybe these should go in their own namespace in the future?
+from torch._functorch.make_functional import (
+    FunctionalModule,
+    FunctionalModuleWithBuffers,
+)
+
+# Top-level APIs. Please think carefully before adding something to the
+# top-level namespace:
+# - private helper functions should go into torch._functorch
+# - very experimental things should go into functorch.experimental
+# - compilation related things should go into functorch.compile
+
+# Was never documented
+from torch._functorch.python_key import make_fx
+
+__version__ = torch.__version__
diff --git a/llm/Lib/site-packages/functorch/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/functorch/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a050ac467e131b291fd62b16eb909e8916c81bc9
Binary files /dev/null and b/llm/Lib/site-packages/functorch/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/_src/__init__.py b/llm/Lib/site-packages/functorch/_src/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/functorch/_src/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/functorch/_src/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..11a0e3bdc29737462332466b4641ba01a2cda857
Binary files /dev/null and b/llm/Lib/site-packages/functorch/_src/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/_src/aot_autograd/__init__.py b/llm/Lib/site-packages/functorch/_src/aot_autograd/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bef6245f7a0f900c71b5350dcec65c19c260cd78
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/_src/aot_autograd/__init__.py
@@ -0,0 +1,8 @@
+# This file has moved to under torch/_functorch. It is not public API.
+# If you are not a PyTorch developer and you are relying on the following
+# imports, please file an issue.
+from torch._functorch.aot_autograd import (
+    aot_autograd_decompositions,
+    KNOWN_TYPES,
+    PytreeThunk,
+)
diff --git a/llm/Lib/site-packages/functorch/_src/aot_autograd/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/functorch/_src/aot_autograd/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..adbe577c6080d0d34fdc056a02a70fc1c4d2c1c7
Binary files /dev/null and b/llm/Lib/site-packages/functorch/_src/aot_autograd/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/_src/eager_transforms/__init__.py b/llm/Lib/site-packages/functorch/_src/eager_transforms/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..37df7424c4056760388c6b0d17288e4571fde359
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/_src/eager_transforms/__init__.py
@@ -0,0 +1,7 @@
+# This file has moved to under torch/_functorch. It is not public API.
+# If you are not a PyTorch developer and you are relying on the following
+# imports, please file an issue.
+from torch._functorch.eager_transforms import (
+    _assert_wrapped_functional,
+    _unwrap_functional_tensor,
+)
diff --git a/llm/Lib/site-packages/functorch/_src/eager_transforms/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/functorch/_src/eager_transforms/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1b3c575842ffb8f88374b28a56f1c745f96ad1ba
Binary files /dev/null and b/llm/Lib/site-packages/functorch/_src/eager_transforms/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/_src/make_functional/__init__.py b/llm/Lib/site-packages/functorch/_src/make_functional/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c96ce28510b5172edbc3941b232c2221e75397de
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/_src/make_functional/__init__.py
@@ -0,0 +1,4 @@
+# This file has moved to under torch/_functorch. It is not public API.
+# If you are not a PyTorch developer and you are relying on the following
+# imports, please file an issue.
+from torch._functorch.make_functional import _swap_state
diff --git a/llm/Lib/site-packages/functorch/_src/make_functional/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/functorch/_src/make_functional/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8f5ca246fb37f68b2d9f5af88a1181d57010648c
Binary files /dev/null and b/llm/Lib/site-packages/functorch/_src/make_functional/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/_src/vmap/__init__.py b/llm/Lib/site-packages/functorch/_src/vmap/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ec274ba24ad6b3f28798c42bfe92c8b14670a51e
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/_src/vmap/__init__.py
@@ -0,0 +1,16 @@
+# This file has moved to under torch/_functorch. It is not public API.
+# If you are not a PyTorch developer and you are relying on the following
+# imports, please file an issue.
+from torch._functorch.vmap import (
+    _add_batch_dim,
+    _broadcast_to_and_flatten,
+    _create_batched_inputs,
+    _get_name,
+    _process_batched_inputs,
+    _remove_batch_dim,
+    _unwrap_batched,
+    _validate_and_get_batch_size,
+    Tensor,
+    tree_flatten,
+    tree_unflatten,
+)
diff --git a/llm/Lib/site-packages/functorch/_src/vmap/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/functorch/_src/vmap/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ce0e09013f79af6cc38c84e9534746e006930c95
Binary files /dev/null and b/llm/Lib/site-packages/functorch/_src/vmap/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/compile/__init__.py b/llm/Lib/site-packages/functorch/compile/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7fee7319cec6799e385431068747125893f62f45
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/compile/__init__.py
@@ -0,0 +1,31 @@
+from torch._functorch import config
+from torch._functorch.aot_autograd import (
+    aot_function,
+    aot_module,
+    aot_module_simplified,
+    compiled_function,
+    compiled_module,
+    get_aot_compilation_context,
+    get_aot_graph_name,
+    get_graph_being_compiled,
+    make_boxed_compiler,
+    make_boxed_func,
+)
+from torch._functorch.compilers import (
+    debug_compile,
+    default_decompositions,
+    draw_graph_compile,
+    memory_efficient_fusion,
+    nnc_jit,
+    nop,
+    print_compile,
+    ts_compile,
+)
+from torch._functorch.fx_minifier import minifier
+from torch._functorch.partitioners import (
+    default_partition,
+    draw_graph,
+    draw_joint_graph,
+    min_cut_rematerialization_partition,
+)
+from torch._functorch.python_key import pythonkey_decompose
diff --git a/llm/Lib/site-packages/functorch/compile/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/functorch/compile/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..543ba67ac14d05d14e4c31b4aa702e0190b12040
Binary files /dev/null and b/llm/Lib/site-packages/functorch/compile/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/dim/__init__.py b/llm/Lib/site-packages/functorch/dim/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..43f853714015f256f82b5b98df83d269896f3cea
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/dim/__init__.py
@@ -0,0 +1,179 @@
+import dis
+import inspect
+from typing import Sequence, Union
+
+import torch
+
+import functorch._C
+from functorch._C import dim as _C
+from .tree_map import tree_flatten, tree_map
+from .wrap_type import wrap_type
+
+_C._patch_tensor_class()
+dims, DimList, dimlists = _C.dims, _C.DimList, _C.dimlists
+
+
+class DimensionMismatchError(Exception):
+    pass
+
+
+class DimensionBindError(Exception):
+    pass
+
+
+from . import op_properties
+
+# use dict to avoid writing C++ bindings for set
+pointwise = {t: True for t in op_properties.pointwise}
+
+use_c = True
+if not use_c:
+    from . import reference
+
+
+class _Tensor:
+    # fast path around slow wrapping/unwrapping logic for simply queries used
+    # by the implementation...
+
+    @property
+    def dims(self):
+        return tuple(d for d in self._levels if isinstance(d, Dim))
+
+    def dim(self):
+        return self.ndim
+
+    if use_c:
+        __torch_function__ = classmethod(_C.__torch_function__)
+        expand = _C._instancemethod(_C.expand)
+    else:
+        __torch_function__ = reference.__torch_function__
+        expand = reference.expand
+
+    index = _C._instancemethod(_C.index)
+
+    def __repr__(self):
+        tensor, levels, ndim = self._tensor, self._levels, self.ndim
+        return f"{tensor}\nwith dims={tuple(l + ndim if isinstance(l, int) else l for l in levels)} sizes={tuple(tensor.size())}"
+
+
+TensorLike = (_Tensor, torch.Tensor)
+
+
+class Dim(_C.Dim, _Tensor):
+    # note that _C.Dim comes before tensor because we want the Dim API for things like size to take precendence.
+    # Tensor defines format, but we want to print Dims with special formatting
+    __format__ = object.__format__
+
+
+class Tensor(_Tensor, _C.Tensor):
+    if not use_c:
+        from_batched = staticmethod(_C.Tensor_from_batched)
+    from_positional = staticmethod(_C.Tensor_from_positional)
+    sum = _C._instancemethod(_C.Tensor_sum)
+
+
+def cat(tensors, dim, new_dim):
+    n = dims()
+    return stack(tensors, n, dim).index([n, dim], new_dim)
+
+
+if use_c:
+    _wrap = _C._wrap
+
+    def _def(name, *args, **kwargs):
+        orig = getattr(torch.Tensor, name)
+        setattr(_Tensor, name, _C._instancemethod(_wrap(orig, *args, **kwargs)))
+
+    t__getitem__ = _C._instancemethod(_C.__getitem__)
+    stack = _C.stack
+    split = _C._instancemethod(_C.split)
+else:
+    _wrap, _def = reference._wrap, reference._def
+    t__getitem__ = reference.t__getitem__
+    stack = reference.stack
+    split = reference.split
+
+# note: there is no python reference
+t__setitem__ = _C._instancemethod(_C.__setitem__)
+# this is patched in the C API because otherwise torch.Tensor will
+# no longer be considered a sequence and things will break
+# torch.Tensor.__getitem__ = t__getitem__
+
+_Tensor.__getitem__ = t__getitem__
+# torch.Tensor.__setitem__ = t__setitem__
+_Tensor.__setitem__ = t__setitem__
+
+torch.Tensor.split = split
+_Tensor.split = split
+torch.Tensor.expand = _C._instancemethod(_C.expand)
+torch.Tensor.index = _C._instancemethod(_C.index)
+wrap_type(use_c, _Tensor, torch.Tensor, _Tensor.__torch_function__)
+del _Tensor.ndim
+
+if use_c:
+    _Tensor.order = _C._instancemethod(_C.order)
+else:
+    _Tensor.order = reference.positional
+
+_def("mean")
+_def("sum")
+_def("all")
+_def("amax")
+_def("amin")
+_def("aminmax")
+_def("any")
+_def("count_nonzero")
+_def("logsumexp")
+_def("nanmean")
+_def("nansum")
+_def("prod")
+_def("std", keepdim_offset=2)
+_def("var", keepdim_offset=2)
+_def("max", single_dim=True)
+_def("min", single_dim=True)
+_def("argmax", single_dim=True)
+_def("argmin", single_dim=True)
+_def("kthvalue", single_dim=True)
+_def("median", single_dim=True)
+_def("nanmedian", single_dim=True)
+_def("mode", single_dim=True)
+_def("sort", reduce=False)
+_def("argsort", reduce=False)
+_def("unbind", single_dim=True)
+_def("chunk", dim_offset=1, reduce=False)
+_def("cummax", single_dim=True, reduce=False)
+_def("cummin", single_dim=True, reduce=False)
+_def("cumprod", single_dim=True, reduce=False)
+_def("cumprod_", single_dim=True, reduce=False)
+_def("cumsum", single_dim=True, reduce=False)
+_def("cumsum_", single_dim=True, reduce=False)
+_def("logcumsumexp", single_dim=True, reduce=False)
+_def("renorm", dim_offset=1, single_dim=True, reduce=False)
+_def("softmax", single_dim=True, reduce=False)
+softmax = _wrap(torch.nn.functional.softmax, single_dim=True, reduce=False)
+
+# stuff to handle in the future, because they require special
+# binding logic for dims
+# cross
+# diag_embed
+# diagonal
+# diagonal_scatter
+# diff
+# nanquantile
+# quantile
+# roll
+# rot90
+# topk (new dimes on output)
+# should these all be subsumed by inplace indexing?
+# index_add_
+# index_add
+# index_copy
+# index_copy_
+# index_fill
+# index_fill_
+# index_select
+# scatter
+# scatter_
+# scatter_add
+# scatter_add_
+# scatter_reduce
diff --git a/llm/Lib/site-packages/functorch/dim/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/functorch/dim/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..23b8ce5bb27fc6756de956ada3064db85fa58231
Binary files /dev/null and b/llm/Lib/site-packages/functorch/dim/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/dim/__pycache__/batch_tensor.cpython-311.pyc b/llm/Lib/site-packages/functorch/dim/__pycache__/batch_tensor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ed11dfdbdba75be806ab885e127b5e8bb87afbf8
Binary files /dev/null and b/llm/Lib/site-packages/functorch/dim/__pycache__/batch_tensor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/dim/__pycache__/delayed_mul_tensor.cpython-311.pyc b/llm/Lib/site-packages/functorch/dim/__pycache__/delayed_mul_tensor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d430cf6aef9f21743b40ad1beed1ced5bf03ef3d
Binary files /dev/null and b/llm/Lib/site-packages/functorch/dim/__pycache__/delayed_mul_tensor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/dim/__pycache__/dim.cpython-311.pyc b/llm/Lib/site-packages/functorch/dim/__pycache__/dim.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2bb77ab633e03a0eeb2778a5f2c913ba4fab139f
Binary files /dev/null and b/llm/Lib/site-packages/functorch/dim/__pycache__/dim.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/dim/__pycache__/magic_trace.cpython-311.pyc b/llm/Lib/site-packages/functorch/dim/__pycache__/magic_trace.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eae254526dd850f8c9601e26866da2c7a207e142
Binary files /dev/null and b/llm/Lib/site-packages/functorch/dim/__pycache__/magic_trace.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/dim/__pycache__/op_properties.cpython-311.pyc b/llm/Lib/site-packages/functorch/dim/__pycache__/op_properties.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..77e9e8aa7817f2547bffae89ec9759a1502ee9fa
Binary files /dev/null and b/llm/Lib/site-packages/functorch/dim/__pycache__/op_properties.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/dim/__pycache__/reference.cpython-311.pyc b/llm/Lib/site-packages/functorch/dim/__pycache__/reference.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5639325a0d1b795b980678c5d4623226fc7dbed6
Binary files /dev/null and b/llm/Lib/site-packages/functorch/dim/__pycache__/reference.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/dim/__pycache__/tree_map.cpython-311.pyc b/llm/Lib/site-packages/functorch/dim/__pycache__/tree_map.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..663616a0d42e9336d4072036281c959d422b3ad8
Binary files /dev/null and b/llm/Lib/site-packages/functorch/dim/__pycache__/tree_map.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/dim/__pycache__/wrap_type.cpython-311.pyc b/llm/Lib/site-packages/functorch/dim/__pycache__/wrap_type.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..01a4e2fcd8ea54e60f9f9f31a86148e9f0b0d36a
Binary files /dev/null and b/llm/Lib/site-packages/functorch/dim/__pycache__/wrap_type.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/dim/batch_tensor.py b/llm/Lib/site-packages/functorch/dim/batch_tensor.py
new file mode 100644
index 0000000000000000000000000000000000000000..92b10d049640d4b48dc3437fbb22a26929c68799
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/dim/batch_tensor.py
@@ -0,0 +1,25 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+from contextlib import contextmanager
+
+from torch._C._functorch import _vmap_add_layers, _vmap_remove_layers
+
+_enabled = False
+
+
+@contextmanager
+def _enable_layers(dims):
+    global _enabled
+    assert not _enabled
+    input = sorted((d._level, d.size) for d in dims if not isinstance(d, int))
+    n = len(input)
+    try:
+        _vmap_add_layers(input)
+        _enabled = True
+        yield
+    finally:
+        _enabled = False
+        _vmap_remove_layers(n)
diff --git a/llm/Lib/site-packages/functorch/dim/delayed_mul_tensor.py b/llm/Lib/site-packages/functorch/dim/delayed_mul_tensor.py
new file mode 100644
index 0000000000000000000000000000000000000000..397b1b56796f7be73987cfa4f7eb58fb58ea0a40
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/dim/delayed_mul_tensor.py
@@ -0,0 +1,77 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+import torch
+
+from . import _Tensor, Tensor
+from .reference import _dims, _enable_layers, llist, ltuple
+
+
+class DelayedMulTensor(_Tensor):
+    def __init__(self, lhs, rhs):
+        self._lhs, self._rhs = lhs, rhs
+        self._data = None
+        self._levels_data = None
+        self._has_device = lhs._has_device or rhs._has_device
+        self._batchtensor_data = None
+        self._tensor_data = None
+
+    @property
+    def _levels(self):
+        if self._levels_data is None:
+            levels = llist(self._lhs._levels)
+            for l in self._rhs._levels:
+                if l not in levels:
+                    levels.append(l)
+            self._levels_data = ltuple(levels)
+        return self._levels_data
+
+    @property
+    def _batchtensor(self):
+        if self._batchtensor_data is None:
+            with _enable_layers(self._levels):
+                print("bt multiply fallback")
+                self._batchtensor_data = self._lhs._batchtensor * self._rhs._batchtensor
+        return self._batchtensor_data
+
+    @property
+    def _tensor(self):
+        if self._tensor_data is None:
+            self._tensor_data = Tensor.from_batched(
+                self._batchtensor, self._has_device
+            )._tensor
+        return self._tensor_data
+
+    @property
+    def ndim(self):
+        return self._batchtensor.ndim
+
+    @property
+    def dims(self):
+        return ltuple(super().dims)
+
+    def sum(self, dim):
+        dims = _dims(dim, 0, False, False)
+        n = ord("a")
+        all_levels = self._levels
+
+        def to_char(d):
+            return chr(n + all_levels.index(d))
+
+        plhs, levelslhs = self._lhs._tensor, self._lhs._levels
+        prhs, levelsrhs = self._rhs._tensor, self._rhs._levels
+        new_dims = tuple(d for d in self.dims if d not in dims)
+        new_levels = [l for l in self._levels if l not in dims]
+        fmt = "".join(
+            [
+                *(to_char(d) for d in levelslhs),
+                ",",
+                *(to_char(d) for d in levelsrhs),
+                "->",
+                *(to_char(d) for d in new_levels),
+            ]
+        )
+        result_data = torch.einsum(fmt, (plhs, prhs))
+        return Tensor.from_positional(result_data, new_levels, True)
diff --git a/llm/Lib/site-packages/functorch/dim/dim.py b/llm/Lib/site-packages/functorch/dim/dim.py
new file mode 100644
index 0000000000000000000000000000000000000000..2d1cf511e51c60640f284b30170f63b407cb8ebe
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/dim/dim.py
@@ -0,0 +1,110 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+_vmap_levels = []
+
+
+@dataclass
+class LevelInfo:
+    level: int
+    alive: bool = True
+
+
+class Dim:
+    def __init__(self, name: str, size: Union[None, int] = None):
+        self.name = name
+        self._size = None
+        self._vmap_level = None
+        if size is not None:
+            self.size = size
+
+    def __del__(self):
+        if self._vmap_level is not None:
+            _vmap_active_levels[self._vmap_stack].alive = False
+            while (
+                not _vmap_levels[-1].alive and current_level() == _vmap_levels[-1].level
+            ):
+                _vmap_decrement_nesting()
+                _vmap_levels.pop()
+
+    @property
+    def size(self):
+        assert self.is_bound
+        return self._size
+
+    @size.setter
+    def size(self, size: int):
+        if self._size is None:
+            self._size = size
+            self._vmap_level = _vmap_increment_nesting(size, "same")
+            self._vmap_stack = len(_vmap_levels)
+            _vmap_levels.append(LevelInfo(self._vmap_level))
+
+        elif self._size != size:
+            raise DimensionBindError(
+                f"Dim '{self}' previously bound to a dimension of size {self._size} cannot bind to a dimension of size {size}"
+            )
+
+    @property
+    def is_bound(self):
+        return self._size is not None
+
+    def __repr__(self):
+        return self.name
+
+
+def extract_name(inst):
+    assert inst.opname == "STORE_FAST" or inst.opname == "STORE_NAME"
+    return inst.argval
+
+
+_cache = {}
+
+
+def dims(lists=0):
+    frame = inspect.currentframe()
+    assert frame is not None
+    calling_frame = frame.f_back
+    assert calling_frame is not None
+    code, lasti = calling_frame.f_code, calling_frame.f_lasti
+    key = (code, lasti)
+    if key not in _cache:
+        first = lasti // 2 + 1
+        instructions = list(dis.get_instructions(calling_frame.f_code))
+        unpack = instructions[first]
+
+        if unpack.opname == "STORE_FAST" or unpack.opname == "STORE_NAME":
+            # just a single dim, not a list
+            name = unpack.argval
+            ctor = Dim if lists == 0 else DimList
+            _cache[key] = lambda: ctor(name=name)
+        else:
+            assert unpack.opname == "UNPACK_SEQUENCE"
+            ndims = unpack.argval
+            names = tuple(
+                extract_name(instructions[first + 1 + i]) for i in range(ndims)
+            )
+            first_list = len(names) - lists
+            _cache[key] = lambda: tuple(
+                Dim(n) if i < first_list else DimList(name=n)
+                for i, n in enumerate(names)
+            )
+    return _cache[key]()
+
+
+def _dim_set(positional, arg):
+    def convert(a):
+        if isinstance(a, Dim):
+            return a
+        else:
+            assert isinstance(a, int)
+            return positional[a]
+
+    if arg is None:
+        return positional
+    elif not isinstance(arg, (Dim, int)):
+        return tuple(convert(a) for a in arg)
+    else:
+        return (convert(arg),)
diff --git a/llm/Lib/site-packages/functorch/dim/magic_trace.py b/llm/Lib/site-packages/functorch/dim/magic_trace.py
new file mode 100644
index 0000000000000000000000000000000000000000..8ad92632a2ef08b300493d9e63c8a7d3ab8e9749
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/dim/magic_trace.py
@@ -0,0 +1,42 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+import os
+import signal
+import subprocess
+from contextlib import contextmanager
+
+
+@contextmanager
+def magic_trace(output="trace.fxt", magic_trace_cache="/tmp/magic-trace"):
+    pid = os.getpid()
+    if not os.path.exists(magic_trace_cache):
+        print(f"Downloading magic_trace to: {magic_trace_cache}")
+        subprocess.run(
+            [
+                "wget",
+                "-O",
+                magic_trace_cache,
+                "-q",
+                "https://github.com/janestreet/magic-trace/releases/download/v1.0.2/magic-trace",
+            ]
+        )
+        subprocess.run(["chmod", "+x", magic_trace_cache])
+    args = [magic_trace_cache, "attach", "-pid", str(pid), "-o", output]
+    p = subprocess.Popen(args, stderr=subprocess.PIPE, encoding="utf-8")
+    while True:
+        x = p.stderr.readline()
+        print(x)
+        if "Attached" in x:
+            break
+    try:
+        yield
+    finally:
+        p.send_signal(signal.SIGINT)
+        r = p.wait()
+        print(p.stderr.read())
+        p.stderr.close()
+        if r != 0:
+            raise ValueError(f"magic_trace exited abnormally: {r}")
diff --git a/llm/Lib/site-packages/functorch/dim/op_properties.py b/llm/Lib/site-packages/functorch/dim/op_properties.py
new file mode 100644
index 0000000000000000000000000000000000000000..137bb5d7383ae33201e38e88c254a0fad683ed1d
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/dim/op_properties.py
@@ -0,0 +1,311 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+import torch
+
+# pointwise operators can go through a faster pathway
+
+tensor_magic_methods = ["add", ""]
+pointwise_magic_methods_with_reverse = (
+    "add",
+    "sub",
+    "mul",
+    "floordiv",
+    "div",
+    "truediv",
+    "mod",
+    "pow",
+    "lshift",
+    "rshift",
+    "and",
+    "or",
+    "xor",
+)
+pointwise_magic_methods = (
+    *(x for m in pointwise_magic_methods_with_reverse for x in (m, "r" + m)),
+    "eq",
+    "gt",
+    "le",
+    "lt",
+    "ge",
+    "gt",
+    "ne",
+    "neg",
+    "pos",
+    "abs",
+    "invert",
+    "iadd",
+    "isub",
+    "imul",
+    "ifloordiv",
+    "idiv",
+    "itruediv",
+    "imod",
+    "ipow",
+    "ilshift",
+    "irshift",
+    "iand",
+    "ior",
+    "ixor",
+    "int",
+    "long",
+    "float",
+    "complex",
+)
+
+pointwise_methods = (*(f"__{m}__" for m in pointwise_magic_methods),)
+
+pointwise = (
+    *(getattr(torch.Tensor, m) for m in pointwise_methods),
+    torch.nn.functional.dropout,
+    torch.where,
+    torch.Tensor.abs,
+    torch.abs,
+    torch.Tensor.acos,
+    torch.acos,
+    torch.Tensor.acosh,
+    torch.acosh,
+    torch.Tensor.add,
+    torch.add,
+    torch.Tensor.addcdiv,
+    torch.addcdiv,
+    torch.Tensor.addcmul,
+    torch.addcmul,
+    torch.Tensor.addr,
+    torch.addr,
+    torch.Tensor.angle,
+    torch.angle,
+    torch.Tensor.asin,
+    torch.asin,
+    torch.Tensor.asinh,
+    torch.asinh,
+    torch.Tensor.atan,
+    torch.atan,
+    torch.Tensor.atan2,
+    torch.atan2,
+    torch.Tensor.atanh,
+    torch.atanh,
+    torch.Tensor.bitwise_and,
+    torch.bitwise_and,
+    torch.Tensor.bitwise_left_shift,
+    torch.bitwise_left_shift,
+    torch.Tensor.bitwise_not,
+    torch.bitwise_not,
+    torch.Tensor.bitwise_or,
+    torch.bitwise_or,
+    torch.Tensor.bitwise_right_shift,
+    torch.bitwise_right_shift,
+    torch.Tensor.bitwise_xor,
+    torch.bitwise_xor,
+    torch.Tensor.ceil,
+    torch.ceil,
+    torch.celu,
+    torch.nn.functional.celu,
+    torch.Tensor.clamp,
+    torch.clamp,
+    torch.Tensor.clamp_max,
+    torch.clamp_max,
+    torch.Tensor.clamp_min,
+    torch.clamp_min,
+    torch.Tensor.copysign,
+    torch.copysign,
+    torch.Tensor.cos,
+    torch.cos,
+    torch.Tensor.cosh,
+    torch.cosh,
+    torch.Tensor.deg2rad,
+    torch.deg2rad,
+    torch.Tensor.digamma,
+    torch.digamma,
+    torch.Tensor.div,
+    torch.div,
+    torch.dropout,
+    torch.nn.functional.dropout,
+    torch.nn.functional.elu,
+    torch.Tensor.eq,
+    torch.eq,
+    torch.Tensor.erf,
+    torch.erf,
+    torch.Tensor.erfc,
+    torch.erfc,
+    torch.Tensor.erfinv,
+    torch.erfinv,
+    torch.Tensor.exp,
+    torch.exp,
+    torch.Tensor.exp2,
+    torch.exp2,
+    torch.Tensor.expm1,
+    torch.expm1,
+    torch.feature_dropout,
+    torch.Tensor.float_power,
+    torch.float_power,
+    torch.Tensor.floor,
+    torch.floor,
+    torch.Tensor.floor_divide,
+    torch.floor_divide,
+    torch.Tensor.fmod,
+    torch.fmod,
+    torch.Tensor.frac,
+    torch.frac,
+    torch.Tensor.frexp,
+    torch.frexp,
+    torch.Tensor.gcd,
+    torch.gcd,
+    torch.Tensor.ge,
+    torch.ge,
+    torch.nn.functional.gelu,
+    torch.nn.functional.glu,
+    torch.Tensor.gt,
+    torch.gt,
+    torch.Tensor.hardshrink,
+    torch.hardshrink,
+    torch.nn.functional.hardshrink,
+    torch.nn.functional.hardsigmoid,
+    torch.nn.functional.hardswish,
+    torch.nn.functional.hardtanh,
+    torch.Tensor.heaviside,
+    torch.heaviside,
+    torch.Tensor.hypot,
+    torch.hypot,
+    torch.Tensor.i0,
+    torch.i0,
+    torch.Tensor.igamma,
+    torch.igamma,
+    torch.Tensor.igammac,
+    torch.igammac,
+    torch.Tensor.isclose,
+    torch.isclose,
+    torch.Tensor.isfinite,
+    torch.isfinite,
+    torch.Tensor.isinf,
+    torch.isinf,
+    torch.Tensor.isnan,
+    torch.isnan,
+    torch.Tensor.isneginf,
+    torch.isneginf,
+    torch.Tensor.isposinf,
+    torch.isposinf,
+    torch.Tensor.isreal,
+    torch.isreal,
+    torch.Tensor.kron,
+    torch.kron,
+    torch.Tensor.lcm,
+    torch.lcm,
+    torch.Tensor.ldexp,
+    torch.ldexp,
+    torch.Tensor.le,
+    torch.le,
+    torch.nn.functional.leaky_relu,
+    torch.Tensor.lerp,
+    torch.lerp,
+    torch.Tensor.lgamma,
+    torch.lgamma,
+    torch.Tensor.log,
+    torch.log,
+    torch.Tensor.log10,
+    torch.log10,
+    torch.Tensor.log1p,
+    torch.log1p,
+    torch.Tensor.log2,
+    torch.log2,
+    torch.nn.functional.logsigmoid,
+    torch.Tensor.logical_and,
+    torch.logical_and,
+    torch.Tensor.logical_not,
+    torch.logical_not,
+    torch.Tensor.logical_or,
+    torch.logical_or,
+    torch.Tensor.logical_xor,
+    torch.logical_xor,
+    torch.Tensor.logit,
+    torch.logit,
+    torch.Tensor.lt,
+    torch.lt,
+    torch.Tensor.maximum,
+    torch.maximum,
+    torch.Tensor.minimum,
+    torch.minimum,
+    torch.nn.functional.mish,
+    torch.Tensor.mvlgamma,
+    torch.mvlgamma,
+    torch.Tensor.nan_to_num,
+    torch.nan_to_num,
+    torch.Tensor.ne,
+    torch.ne,
+    torch.Tensor.neg,
+    torch.neg,
+    torch.Tensor.nextafter,
+    torch.nextafter,
+    torch.Tensor.outer,
+    torch.outer,
+    torch.polar,
+    torch.Tensor.polygamma,
+    torch.polygamma,
+    torch.Tensor.positive,
+    torch.positive,
+    torch.Tensor.pow,
+    torch.pow,
+    torch.Tensor.prelu,
+    torch.prelu,
+    torch.nn.functional.prelu,
+    torch.Tensor.rad2deg,
+    torch.rad2deg,
+    torch.Tensor.reciprocal,
+    torch.reciprocal,
+    torch.Tensor.relu,
+    torch.relu,
+    torch.nn.functional.relu,
+    torch.nn.functional.relu6,
+    torch.Tensor.remainder,
+    torch.remainder,
+    torch.Tensor.round,
+    torch.round,
+    torch.rrelu,
+    torch.nn.functional.rrelu,
+    torch.Tensor.rsqrt,
+    torch.rsqrt,
+    torch.rsub,
+    torch.selu,
+    torch.nn.functional.selu,
+    torch.Tensor.sgn,
+    torch.sgn,
+    torch.Tensor.sigmoid,
+    torch.sigmoid,
+    torch.nn.functional.sigmoid,
+    torch.Tensor.sign,
+    torch.sign,
+    torch.Tensor.signbit,
+    torch.signbit,
+    torch.nn.functional.silu,
+    torch.Tensor.sin,
+    torch.sin,
+    torch.Tensor.sinc,
+    torch.sinc,
+    torch.Tensor.sinh,
+    torch.sinh,
+    torch.nn.functional.softplus,
+    torch.nn.functional.softshrink,
+    torch.Tensor.sqrt,
+    torch.sqrt,
+    torch.Tensor.square,
+    torch.square,
+    torch.Tensor.sub,
+    torch.sub,
+    torch.Tensor.tan,
+    torch.tan,
+    torch.Tensor.tanh,
+    torch.tanh,
+    torch.nn.functional.tanh,
+    torch.threshold,
+    torch.nn.functional.threshold,
+    torch.trapz,
+    torch.Tensor.true_divide,
+    torch.true_divide,
+    torch.Tensor.trunc,
+    torch.trunc,
+    torch.Tensor.xlogy,
+    torch.xlogy,
+    torch.rand_like,
+)
diff --git a/llm/Lib/site-packages/functorch/dim/reference.py b/llm/Lib/site-packages/functorch/dim/reference.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ce8b64986ec4a17656e6a503c0a8c0022ddde61
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/dim/reference.py
@@ -0,0 +1,645 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+# reference python implementations for C ops
+import torch
+
+from functorch._C import dim as _C
+from . import op_properties
+from .batch_tensor import _enable_layers
+from .tree_map import tree_flatten, tree_map
+
+DimList = _C.DimList
+import operator
+from functools import reduce
+
+
+# use dict to avoid writing C++ bindings for set
+pointwise = set(op_properties.pointwise)
+
+
+def prod(x):
+    return reduce(operator.mul, x, 1)
+
+
+def _wrap_dim(d, N, keepdim):
+    from . import Dim
+
+    if isinstance(d, Dim):
+        assert not keepdim, "cannot preserve first-class dimensions with keepdim=True"
+        return d
+    elif d >= 0:
+        return d - N
+    else:
+        return d
+
+
+def _dims(d, N, keepdim, single_dim):
+    from . import Dim
+
+    if isinstance(d, (Dim, int)):
+        return ltuple((_wrap_dim(d, N, keepdim),))
+    assert not single_dim, f"expected a single dimension or int but found: {d}"
+    return ltuple(_wrap_dim(x, N, keepdim) for x in d)
+
+
+def _bind_dims_to_size(lhs_size, rhs, lhs_debug):
+    from . import DimensionMismatchError
+
+    not_bound = tuple((i, r) for i, r in enumerate(rhs) if not r.is_bound)
+    if len(not_bound) == 1:
+        idx, d = not_bound[0]
+        rhs_so_far = prod(r.size for r in rhs if r.is_bound)
+        if lhs_size % rhs_so_far != 0:
+            rhs_s = tuple("?" if not r.is_bound else str(r.size) for r in rhs)
+            raise DimensionMismatchError(
+                f"inferred dimension does not evenly fit into larger dimension: {lhs_size} vs {rhs_s}"
+            )
+        new_size = lhs_size // rhs_so_far
+        d.size = new_size
+    elif len(not_bound) > 1:
+        rhs_s = tuple("?" if not r.is_bound else str(r.size) for r in rhs)
+        raise DimensionMismatchError(
+            f"cannot infer the size of two dimensions at once: {rhs} with sizes {rhs_s}"
+        )
+    else:
+        rhs_size = prod(r.size for r in rhs)
+        if lhs_size != rhs_size:
+            raise DimensionMismatchError(
+                f"Dimension sizes to do not match ({lhs_size} != {rhs_size}) when matching {lhs_debug} to {rhs}"
+            )
+
+
+def _tensor_levels(inp):
+    from . import _Tensor
+
+    if isinstance(inp, _Tensor):
+        return inp._tensor, llist(inp._levels), inp._has_device
+    else:
+        return inp, llist(range(-inp.ndim, 0)), True
+
+
+def _match_levels(v, from_levels, to_levels):
+    view = []
+    permute = []
+    requires_view = False
+    size = v.size()
+    for t in to_levels:
+        try:
+            idx = from_levels.index(t)
+            permute.append(idx)
+            view.append(size[idx])
+        except ValueError:
+            view.append(1)
+            requires_view = True
+    if permute != list(range(len(permute))):
+        v = v.permute(*permute)
+    if requires_view:
+        v = v.view(*view)
+    return v
+
+
+# make a single dimension positional but do not permute it,
+# used to do multi-tensor operators where the dim being acted on
+# should not physically move if possible
+def _positional_no_permute(self, dim, expand_dim=False):
+    from . import Tensor
+
+    ptensor, levels = self._tensor, llist(self._levels)
+    try:
+        idx = levels.index(dim)
+    except ValueError:
+        if not expand_dim:
+            raise
+        idx = 0
+        ptensor = ptensor.expand(dim.size, *ptensor.size())
+        levels.insert(0, 0)
+    idx_batched = 0
+    for i in range(idx):
+        if isinstance(levels[i], int):
+            levels[i] -= 1
+            idx_batched += 1
+    levels[idx] = -idx_batched - 1
+    return Tensor.from_positional(ptensor, levels, self._has_device), idx_batched
+
+
+def seq(a, b):
+    from . import Dim
+
+    if isinstance(a, Dim) != isinstance(b, Dim):
+        return False
+    if isinstance(a, Dim):
+        return a is b
+    else:
+        return a == b
+
+
+class isin:
+    def __contains__(self, item):
+        for x in self:
+            if seq(item, x):
+                return True
+        return False
+
+    def index(self, item):
+        for i, x in enumerate(self):
+            if seq(item, x):
+                return i
+        raise ValueError
+
+
+class llist(isin, list):
+    pass
+
+
+class ltuple(isin, tuple):
+    pass
+
+
+empty_dict = {}
+
+
+@classmethod
+def __torch_function__(self, orig, cls, args, kwargs=empty_dict):
+    from . import _Tensor, Tensor, TensorLike
+    from .delayed_mul_tensor import DelayedMulTensor
+
+    if orig is torch.Tensor.__mul__:
+        lhs, rhs = args
+        if (
+            isinstance(lhs, _Tensor)
+            and isinstance(rhs, _Tensor)
+            and lhs.ndim == 0
+            and rhs.ndim == 0
+        ):
+            return DelayedMulTensor(lhs, rhs)
+    all_dims = llist()
+    flat_args, unflatten = tree_flatten((args, kwargs))
+    device_holding_tensor = None
+    for f in flat_args:
+        if isinstance(f, _Tensor):
+            if f._has_device:
+                device_holding_tensor = f._batchtensor
+            for d in f.dims:
+                if d not in all_dims:
+                    all_dims.append(d)
+
+    def unwrap(t):
+        if isinstance(t, _Tensor):
+            r = t._batchtensor
+            if device_holding_tensor is not None and not t._has_device:
+                r = r.to(device=device_holding_tensor.device)
+            return r
+        return t
+
+    if orig in pointwise:
+        result_levels = llist()
+        arg_levels = llist()
+        to_expand = []
+        for i, f in enumerate(flat_args):
+            if isinstance(f, TensorLike):
+                ptensor, levels, _ = _tensor_levels(f)
+                if (
+                    isinstance(f, _Tensor)
+                    and not f._has_device
+                    and device_holding_tensor is not None
+                ):
+                    ptensor = ptensor.to(device=device_holding_tensor.device)
+                flat_args[i] = ptensor
+                for l in levels:
+                    if l not in result_levels:
+                        result_levels.append(l)
+                to_expand.append((i, levels))
+
+        for i, levels in to_expand:
+            flat_args[i] = _match_levels(flat_args[i], levels, result_levels)
+        args, kwargs = unflatten(flat_args)
+        result = orig(*args, **kwargs)
+
+        def wrap(t):
+            if isinstance(t, TensorLike):
+                return Tensor.from_positional(
+                    t, result_levels, device_holding_tensor is not None
+                )
+            return t
+
+        return tree_map(wrap, result)
+    else:
+
+        def wrap(t):
+            if isinstance(t, TensorLike):
+                return Tensor.from_batched(t, device_holding_tensor is not None)
+            return t
+
+        with _enable_layers(all_dims):
+            print(f"batch_tensor for {orig}")
+            args, kwargs = unflatten(unwrap(f) for f in flat_args)
+            result = orig(*args, **kwargs)
+            # print("END", orig)
+            return tree_map(wrap, result)
+
+
+def positional(self, *dims):
+    from . import Dim, Tensor
+
+    ptensor, levels = self._tensor, llist(self._levels)
+    flat_dims = llist()
+    view = []
+    needs_view = False
+    ndim = self.ndim
+    for d in dims:
+        if isinstance(d, DimList):
+            flat_dims.extend(d)
+            view.extend(e.size for e in d)
+        elif isinstance(d, Dim):
+            flat_dims.append(d)
+            view.append(d.size)
+        elif isinstance(d, int):
+            d = _wrap_dim(d, ndim, False)
+            flat_dims.append(d)
+            view.append(ptensor.size(d))
+        else:
+            flat_dims.extend(d)
+            view.append(prod(e.size for e in d))
+            needs_view = True
+
+    permute = list(range(len(levels)))
+    nflat = len(flat_dims)
+    for i, d in enumerate(flat_dims):
+        try:
+            idx = levels.index(d)
+        except ValueError as e:
+            raise DimensionBindError(
+                f"tensor of dimensions {self.dims} does not contain dim {d}"
+            ) from e
+        p = permute[idx]
+        del levels[idx]
+        del permute[idx]
+        levels.insert(i, 0)
+        permute.insert(i, p)
+    ptensor = ptensor.permute(*permute)
+    seen = 0
+    for i in range(len(levels) - 1, -1, -1):
+        if isinstance(levels[i], int):
+            seen += 1
+            levels[i] = -seen
+    result = Tensor.from_positional(ptensor, levels, self._has_device)
+    if needs_view:
+        result = result.reshape(*view, *result.size()[len(flat_dims) :])
+    return result
+
+
+def _contains_dim(input):
+    from . import Dim
+
+    for i in input:
+        if isinstance(i, Dim):
+            return True
+
+
+def expand(self, *sizes):
+    if not _contains_dim(sizes):
+        return self.__torch_function__(torch.Tensor.expand, None, (self, *sizes))
+    dims = sizes
+    sizes = [d.size for d in dims] + [-1] * self.ndim
+    self = self.expand(*sizes)
+    return self[dims]
+
+
+_not_present = object()
+
+
+def _getarg(name, offset, args, kwargs, default):
+    if len(args) > offset:
+        return args[offset]
+    return kwargs.get(name, default)
+
+
+def _patcharg(name, offset, args, kwargs, value):
+    if len(args) > offset:
+        args[offset] = value
+    else:
+        kwargs[name] = value
+
+
+def _wrap(
+    orig, dim_offset=0, keepdim_offset=1, dim_name="dim", single_dim=False, reduce=True
+):
+    from . import Dim, Tensor, TensorLike
+
+    def fn(self, *args, **kwargs):
+        dim = _getarg(dim_name, dim_offset, args, kwargs, _not_present)
+        if dim is _not_present or (single_dim and not isinstance(dim, Dim)):
+            with _enable_layers(self.dims):
+                print(f"dim fallback batch_tensor for {orig}")
+                return Tensor.from_batched(
+                    orig(self._batchtensor, *args, **kwargs), self._has_device
+                )
+        keepdim = (
+            _getarg("keepdim", keepdim_offset, args, kwargs, False) if reduce else False
+        )
+        t, levels = self._tensor, llist(self._levels)
+        dims = _dims(dim, self._batchtensor.ndim, keepdim, single_dim)
+        dim_indices = tuple(levels.index(d) for d in dims)
+        if reduce and not keepdim:
+            new_levels = [l for i, l in enumerate(levels) if i not in dim_indices]
+        else:
+            new_levels = levels
+
+        if len(dim_indices) == 1:
+            dim_indices = dim_indices[
+                0
+            ]  # so that dims that really only take a single argument work...
+        args = list(args)
+        _patcharg(dim_name, dim_offset, args, kwargs, dim_indices)
+
+        def wrap(t):
+            if isinstance(t, TensorLike):
+                return Tensor.from_positional(t, new_levels, self._has_device)
+            return t
+
+        with _enable_layers(new_levels):
+            print(f"dim used batch_tensor for {orig}")
+            r = orig(t, *args, **kwargs)
+            return tree_map(wrap, r)
+
+    return fn
+
+
+def _def(name, *args, **kwargs):
+    from . import _Tensor
+
+    orig = getattr(torch.Tensor, name)
+    setattr(_Tensor, name, _wrap(orig, *args, **kwargs))
+
+
+no_slice = slice(None)
+
+_orig_getitem = torch.Tensor.__getitem__
+
+
+class dim_tracker:
+    def __init__(self):
+        self.dims = llist()
+        self.count = []
+
+    def record(self, d):
+        if d not in self.dims:
+            self.dims.append(d)
+            self.count.append(1)
+
+    def __getitem__(self, d):
+        return self.count[self.dims.index(d)]
+
+
+def t__getitem__(self, input):
+    from . import _Tensor, Dim, DimensionBindError, DimList, Tensor, TensorLike
+
+    # * bail to original example if we have a single non-Dim tensor, or a non-tensor
+    # * locate ... or an unbound tensor list, and determine its size, bind dim list
+    #   (remember that None does not count to the total dim count)
+    # * bind simple dims and dim-packs to their sizes, count the number of uses of each dim,
+    #   produce the re-view if needed
+    # * for each single-use dim index, replace with no_slice and mark that it will be added
+    #   (keep track of whether we have to call super)
+    # * call super if needed
+    # * if we have dims to bind, bind them (it will help if we eliminated ... and None before)
+
+    # this handles bool indexing handling, as well as some other simple cases.
+
+    is_simple = (
+        not isinstance(input, Dim)
+        and not isinstance(input, (tuple, list))
+        and
+        # WAR for functorch bug where zero time tensors in getitem are not handled correctly.
+        not (isinstance(input, TensorLike) and input.ndim == 0)
+    )
+
+    if is_simple:
+        if isinstance(self, _Tensor):
+            return _Tensor.__torch_function__(_orig_getitem, None, (self, input))
+        else:
+            return _orig_getitem(self, input)
+
+    # can further optimize this case
+    if not isinstance(input, tuple):
+        input = [input]
+    else:
+        input = list(input)
+
+    dims_indexed = 0
+    expanding_object = None
+    dimlists = []
+    for i, s in enumerate(input):
+        if s is ... or isinstance(s, DimList) and not s.is_bound:
+            if expanding_object is not None:
+                msg = (
+                    "at most one ... or unbound dimension list can exist in indexing list but"
+                    f" found 2 at offsets {i} and {expanding_object}"
+                )
+                raise DimensionBindError(msg)
+            expanding_object = i
+
+        if isinstance(s, DimList):
+            dims_indexed += len(s) if s.is_bound else 0
+            dimlists.append(i)
+        elif s is not None and s is not ...:
+            dims_indexed += 1
+
+    ndim = self.ndim
+    if dims_indexed > ndim:
+        raise IndexError(
+            f"at least {dims_indexed} indices were supplied but the tensor only has {ndim} dimensions."
+        )
+    if expanding_object is not None:
+        expanding_ndims = ndim - dims_indexed
+        obj = input[expanding_object]
+        if obj is ...:
+            input[expanding_object : expanding_object + 1] = [
+                no_slice
+            ] * expanding_ndims
+        else:
+            obj.bind_len(expanding_ndims)
+    # flatten the dimslists into the indexing
+    for i in reversed(dimlists):
+        input[i : i + 1] = input[i]
+    dims_indexed = 0
+    requires_view = False
+    size = self.size()
+    view_sizes = []
+    dims_seen = dim_tracker()
+
+    def add_dims(t):
+        if not isinstance(t, _Tensor):
+            return
+        for d in t.dims:
+            dims_seen.record(d)
+
+    add_dims(self)
+    dim_packs = []
+    for i, idx in enumerate(input):
+        if idx is None:
+            input[i] = no_slice
+            view_sizes.append(1)
+            requires_view = True
+        else:
+            sz = size[dims_indexed]
+            if isinstance(idx, Dim):
+                idx.size = sz
+                dims_seen.record(idx)
+                view_sizes.append(sz)
+            elif isinstance(idx, (tuple, list)) and idx and isinstance(idx[0], Dim):
+                for d in idx:
+                    dims_seen.record(idx)
+                _bind_dims_to_size(sz, idx, f"offset {i}")
+                view_sizes.extend(d.size for d in idx)
+                requires_view = True
+                dim_packs.append(i)
+            else:
+                add_dims(idx)
+                view_sizes.append(sz)
+            dims_indexed += 1
+    if requires_view:
+        self = self.view(*view_sizes)
+    for i in reversed(dim_packs):
+        input[i : i + 1] = input[i]
+
+    # currenty:
+    # input is flat, containing either Dim, or Tensor, or something valid for standard indexing
+    # self may have first-class dims as well.
+
+    # to index:
+    # drop the first class dims from self, they just become direct indices of their positions
+
+    # figure out the dimensions of the indexing tensors: union of all the dims in the tensors in the index.
+    # these dimensions will appear and need to be bound at the first place tensor occures
+
+    if isinstance(self, _Tensor):
+        ptensor_self, levels = self._tensor, list(self._levels)
+        # indices to ptensor rather than self which has first-class dimensions
+        input_it = iter(input)
+        flat_inputs = [next(input_it) if isinstance(l, int) else l for l in levels]
+        has_device = self._has_device
+        to_pad = 0
+    else:
+        ptensor_self, flat_inputs = self, input
+        to_pad = ptensor_self.ndim - len(flat_inputs)
+        has_device = True
+
+    result_levels = []
+    index_levels = []
+    tensor_insert_point = None
+    to_expand = {}
+    requires_getindex = False
+    for i, inp in enumerate(flat_inputs):
+        if isinstance(inp, Dim) and dims_seen[inp] == 1:
+            flat_inputs[i] = no_slice
+            result_levels.append(inp)
+        elif isinstance(inp, TensorLike):
+            requires_getindex = True
+            if tensor_insert_point is None:
+                tensor_insert_point = len(result_levels)
+            ptensor, levels, _ = _tensor_levels(inp)
+            to_expand[i] = levels
+            flat_inputs[i] = ptensor
+            for l in levels:
+                if l not in index_levels:
+                    index_levels.append(l)
+        else:
+            requires_getindex = True
+            result_levels.append(0)
+
+    if tensor_insert_point is not None:
+        result_levels[tensor_insert_point:tensor_insert_point] = index_levels
+
+    for i, levels in to_expand.items():
+        flat_inputs[i] = _match_levels(flat_inputs[i], levels, index_levels)
+
+    if requires_getindex:
+        result = _orig_getitem(ptensor_self, flat_inputs)
+    else:
+        result = ptensor_self
+
+    next_positional = -1
+    if to_pad > 0:
+        result_levels.extend([0] * to_pad)
+    for i, r in enumerate(reversed(result_levels)):
+        if isinstance(r, int):
+            result_levels[-1 - i] = next_positional
+            next_positional -= 1
+
+    return Tensor.from_positional(result, result_levels, has_device)
+
+
+# XXX - dim is optional and can be the outer-most dimension...
+def stack(tensors, new_dim, dim=0, out=None):
+    if isinstance(dim, int):
+        return torch.stack(tensors, dim, out).index(dim, new_dim)
+    index = None
+    if out is not None:
+        out, index = _positional_no_permute(out, dim, expand_dim=True)
+    ptensors = []
+    for t in tensors:
+        pt, pi = _positional_no_permute(t, dim, expand_dim=True)
+        if index is not None and pi != index:
+            pt = pt.move_dim(pi, index)
+        else:
+            index = pi
+        ptensors.append(pt)
+    pr = torch.stack(ptensors, index, out=out)
+    return pr.index((index, index + 1), (new_dim, dim))
+
+
+_orig_split = torch.Tensor.split
+
+
+def split(self, split_size_or_sections, dim=0):
+    from . import _Tensor, Dim
+
+    if isinstance(split_size_or_sections, int) or any(
+        isinstance(t, int) for t in split_size_or_sections
+    ):
+        if isinstance(dim, Dim):
+            raise ValueError(
+                "when dim is specified as a Dim object, split sizes must also be dimensions."
+            )
+        return _orig_split(self, split_size_or_sections, dim=dim)
+
+    if isinstance(dim, Dim):
+        assert isinstance(self, _Tensor), f"Tensor does not have dimension {dim}"
+        self, dim = _positional_no_permute(self, dim)
+
+    size = self.size(dim)
+    total_bound_size = 0
+    unbound = []
+    sizes = []
+    for i, d in enumerate(split_size_or_sections):
+        if d.is_bound:
+            sizes.append(d.size)
+            total_bound_size += d.size
+        else:
+            sizes.append(0)
+            unbound.append(i)
+
+    if unbound:
+        assert (
+            total_bound_size <= size
+        ), f"result dimensions are larger than original: {total_bound_size} vs {size} ({split_size_or_sections})"
+        remaining_size = size - total_bound_size
+        chunk_size = -(-remaining_size // len(unbound))
+        for u in unbound:
+            sz = min(chunk_size, remaining_size)
+            split_size_or_sections[u].size = sz
+            sizes[u] = sz
+            remaining_size -= sz
+    else:
+        assert (
+            total_bound_size == size
+        ), f"result dimensions do not match original: {total_bound_size} vs {size} ({split_size_or_sections})"
+    return tuple(
+        t.index(dim, d)
+        for d, t in zip(split_size_or_sections, _orig_split(self, sizes, dim=dim))
+    )
diff --git a/llm/Lib/site-packages/functorch/dim/tree_map.py b/llm/Lib/site-packages/functorch/dim/tree_map.py
new file mode 100644
index 0000000000000000000000000000000000000000..b8f24a5617969eaa101e1dc6267cbb2805c53d3e
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/dim/tree_map.py
@@ -0,0 +1,14 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+from functorch._C import dim
+
+tree_flatten = dim.tree_flatten
+
+
+def tree_map(fn, tree):
+    vs, unflatten = tree_flatten(tree)
+    return unflatten(fn(v) for v in vs)
diff --git a/llm/Lib/site-packages/functorch/dim/wrap_type.py b/llm/Lib/site-packages/functorch/dim/wrap_type.py
new file mode 100644
index 0000000000000000000000000000000000000000..349743ec000093f9337c09130eaf31e59b8d75ec
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/dim/wrap_type.py
@@ -0,0 +1,71 @@
+# Copyright (c) Facebook, Inc. and its affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+from types import (
+    BuiltinMethodType,
+    FunctionType,
+    GetSetDescriptorType,
+    MethodDescriptorType,
+    WrapperDescriptorType,
+)
+
+from functorch._C import dim as _C
+
+_wrap_method = _C._wrap_method
+
+FUNC_TYPES = (
+    FunctionType,
+    MethodDescriptorType,
+    BuiltinMethodType,
+    WrapperDescriptorType,
+)
+PROPERTY_TYPES = (GetSetDescriptorType, property)
+
+
+def _py_wrap_method(orig, __torch_function__):
+    def impl(*args, **kwargs):
+        return __torch_function__(orig, None, args, kwargs)
+
+    return impl
+
+
+def wrap_type(use_c, to_patch, pattern, __torch_function__):
+    if use_c:
+        wrap_method = _wrap_method
+    else:
+        wrap_method = _py_wrap_method
+
+    all = {}
+    for t in reversed(pattern.mro()[:-1]):  # skip object
+        all.update(t.__dict__)
+
+    def wrap_attr(orig):
+        return property(wrap_method(orig.__get__, __torch_function__))
+
+    for name, obj in all.items():
+        if name in (
+            "__dict__",
+            "__new__",
+            "__init__",
+            "__repr__",
+            "__weakref__",
+            "__doc__",
+            "__module__",
+            "__dir__",
+        ):
+            continue
+
+        # skip things that have been overloaded
+        # things that come from object like `__eq__` still need to be patched, however.
+        if hasattr(to_patch, name) and getattr(to_patch, name) is not getattr(
+            object, name, None
+        ):
+            continue
+
+        if isinstance(obj, FUNC_TYPES):
+            setattr(to_patch, name, wrap_method(obj, __torch_function__))
+        elif isinstance(obj, PROPERTY_TYPES):
+            setattr(to_patch, name, wrap_attr(obj))
diff --git a/llm/Lib/site-packages/functorch/einops/__init__.py b/llm/Lib/site-packages/functorch/einops/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d423f16537091985182f7d787e6eb672000a88a5
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/einops/__init__.py
@@ -0,0 +1,3 @@
+from .rearrange import rearrange
+
+__all__ = ["rearrange"]
diff --git a/llm/Lib/site-packages/functorch/einops/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/functorch/einops/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ce23a4faee31de42df9413daa1fe99e79aaf3aa1
Binary files /dev/null and b/llm/Lib/site-packages/functorch/einops/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/einops/__pycache__/_parsing.cpython-311.pyc b/llm/Lib/site-packages/functorch/einops/__pycache__/_parsing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..be731d5ca733801bd8d5b7fd6e476fcc4b0f2cb6
Binary files /dev/null and b/llm/Lib/site-packages/functorch/einops/__pycache__/_parsing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/einops/__pycache__/rearrange.cpython-311.pyc b/llm/Lib/site-packages/functorch/einops/__pycache__/rearrange.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7625df00a34653631b78d324994606ce61f714f3
Binary files /dev/null and b/llm/Lib/site-packages/functorch/einops/__pycache__/rearrange.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/einops/_parsing.py b/llm/Lib/site-packages/functorch/einops/_parsing.py
new file mode 100644
index 0000000000000000000000000000000000000000..8da2bc9bf2afb80fa74227e5f23f77ab44638e7e
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/einops/_parsing.py
@@ -0,0 +1,302 @@
+"""Adapted from https://github.com/arogozhnikov/einops/blob/36c7bb16e57d6e57f8f3050f9e07abdf3f00469f/einops/parsing.py.
+
+MIT License
+
+Copyright (c) 2018 Alex Rogozhnikov
+
+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
+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.
+"""
+from __future__ import annotations
+
+import keyword
+import warnings
+from typing import Collection, List, Mapping, Optional, Set, Tuple, Union
+
+_ellipsis: str = "…"  # NB, this is a single unicode symbol. String is used as it is not a list, but can be iterated
+
+
+class AnonymousAxis:
+    """Used by `ParsedExpression` to represent an axis with a size (> 1), but no associated identifier.
+
+    Note: Different instances of this class are not equal to each other, even if they have the same value.
+    """
+
+    def __init__(self, value: str) -> None:
+        self.value = int(value)
+        if self.value < 1:
+            raise ValueError(
+                f"Anonymous axis should have positive length, not {self.value}"
+            )
+
+    def __repr__(self) -> str:
+        return f"{self.value}-axis"
+
+
+class ParsedExpression:
+    """Structure containing information about one side of an `einops`-style pattern (e.g. 'b c (h w)')."""
+
+    def __init__(
+        self,
+        expression: str,
+        *,
+        allow_underscore: bool = False,
+        allow_duplicates: bool = False,
+    ) -> None:
+        """Parse the expression and store relevant metadata.
+
+        Args:
+            expression (str): the `einops`-pattern to parse
+            allow_underscore (bool): whether to allow axis identifier names to begin with an underscore
+            allow_duplicates (bool): whether to allow an identifier to appear more than once in the expression
+        """
+        self.has_ellipsis: bool = False
+        self.has_ellipsis_parenthesized: Optional[bool] = None
+        self.identifiers: Set[Union[str, AnonymousAxis]] = set()
+        # that's axes like 2, 3, 4 or 5. Axes with size 1 are exceptional and replaced with empty composition
+        self.has_non_unitary_anonymous_axes: bool = False
+        # composition keeps structure of composite axes, see how different corner cases are handled in tests
+        self.composition: List[Union[List[Union[str, AnonymousAxis]], str]] = []
+        if "." in expression:
+            if "..." not in expression:
+                raise ValueError(
+                    "Expression may contain dots only inside ellipsis (...)"
+                )
+            if str.count(expression, "...") != 1 or str.count(expression, ".") != 3:
+                raise ValueError(
+                    "Expression may contain dots only inside ellipsis (...); only one ellipsis for tensor "
+                )
+            expression = expression.replace("...", _ellipsis)
+            self.has_ellipsis = True
+
+        bracket_group: Optional[List[Union[str, AnonymousAxis]]] = None
+
+        def add_axis_name(x: str) -> None:
+            if x in self.identifiers:
+                if not (allow_underscore and x == "_") and not allow_duplicates:
+                    raise ValueError(
+                        f"Indexing expression contains duplicate dimension '{x}'"
+                    )
+            if x == _ellipsis:
+                self.identifiers.add(_ellipsis)
+                if bracket_group is None:
+                    self.composition.append(_ellipsis)
+                    self.has_ellipsis_parenthesized = False
+                else:
+                    bracket_group.append(_ellipsis)
+                    self.has_ellipsis_parenthesized = True
+            else:
+                is_number = str.isdecimal(x)
+                if is_number and int(x) == 1:
+                    # handling the case of anonymous axis of length 1
+                    if bracket_group is None:
+                        self.composition.append([])
+                    else:
+                        pass  # no need to think about 1s inside parenthesis
+                    return
+                is_axis_name, reason = self.check_axis_name_return_reason(
+                    x, allow_underscore=allow_underscore
+                )
+                if not (is_number or is_axis_name):
+                    raise ValueError(f"Invalid axis identifier: {x}\n{reason}")
+                axis_name: Union[str, AnonymousAxis] = (
+                    AnonymousAxis(x) if is_number else x
+                )
+                self.identifiers.add(axis_name)
+                if is_number:
+                    self.has_non_unitary_anonymous_axes = True
+                if bracket_group is None:
+                    self.composition.append([axis_name])
+                else:
+                    bracket_group.append(axis_name)
+
+        current_identifier = None
+        for char in expression:
+            if char in "() ":
+                if current_identifier is not None:
+                    add_axis_name(current_identifier)
+                current_identifier = None
+                if char == "(":
+                    if bracket_group is not None:
+                        raise ValueError(
+                            "Axis composition is one-level (brackets inside brackets not allowed)"
+                        )
+                    bracket_group = []
+                elif char == ")":
+                    if bracket_group is None:
+                        raise ValueError("Brackets are not balanced")
+                    self.composition.append(bracket_group)
+                    bracket_group = None
+            elif str.isalnum(char) or char in ["_", _ellipsis]:
+                if current_identifier is None:
+                    current_identifier = char
+                else:
+                    current_identifier += char
+            else:
+                raise ValueError(f"Unknown character '{char}'")
+
+        if bracket_group is not None:
+            raise ValueError(f"Imbalanced parentheses in expression: '{expression}'")
+        if current_identifier is not None:
+            add_axis_name(current_identifier)
+
+    @staticmethod
+    def check_axis_name_return_reason(
+        name: str, allow_underscore: bool = False
+    ) -> Tuple[bool, str]:
+        """Check if the given axis name is valid, and a message explaining why if not.
+
+        Valid axes names are python identifiers except keywords, and should not start or end with an underscore.
+
+        Args:
+            name (str): the axis name to check
+            allow_underscore (bool): whether axis names are allowed to start with an underscore
+
+        Returns:
+            Tuple[bool, str]: whether the axis name is valid, a message explaining why if not
+        """
+        if not str.isidentifier(name):
+            return False, "not a valid python identifier"
+        elif name[0] == "_" or name[-1] == "_":
+            if name == "_" and allow_underscore:
+                return True, ""
+            return False, "axis name should should not start or end with underscore"
+        else:
+            if keyword.iskeyword(name):
+                warnings.warn(
+                    f"It is discouraged to use axes names that are keywords: {name}",
+                    RuntimeWarning,
+                )
+            if name in ["axis"]:
+                warnings.warn(
+                    "It is discouraged to use 'axis' as an axis name and will raise an error in future",
+                    FutureWarning,
+                )
+            return True, ""
+
+    @staticmethod
+    def check_axis_name(name: str) -> bool:
+        """Check if the name is a valid axis name.
+
+        Args:
+            name (str): the axis name to check
+
+        Returns:
+            bool: whether the axis name is valid
+        """
+        is_valid, _ = ParsedExpression.check_axis_name_return_reason(name)
+        return is_valid
+
+
+def parse_pattern(
+    pattern: str, axes_lengths: Mapping[str, int]
+) -> Tuple[ParsedExpression, ParsedExpression]:
+    """Parse an `einops`-style pattern into a left-hand side and right-hand side `ParsedExpression` object.
+
+    Args:
+        pattern (str): the `einops`-style rearrangement pattern
+        axes_lengths (Mapping[str, int]): any additional length specifications for dimensions
+
+    Returns:
+       Tuple[ParsedExpression, ParsedExpression]: a tuple containing the left-hand side and right-hand side expressions
+    """
+    # adapted from einops.einops._prepare_transformation_recipe
+    # https://github.com/arogozhnikov/einops/blob/230ac1526c1f42c9e1f7373912c7f8047496df11/einops/einops.py
+    try:
+        left_str, right_str = pattern.split("->")
+    except ValueError:
+        raise ValueError("Pattern must contain a single '->' separator") from None
+
+    if _ellipsis in axes_lengths:
+        raise ValueError(f"'{_ellipsis}' is not an allowed axis identifier")
+
+    left = ParsedExpression(left_str)
+    right = ParsedExpression(right_str)
+
+    if not left.has_ellipsis and right.has_ellipsis:
+        raise ValueError(
+            f"Ellipsis found in right side, but not left side of a pattern {pattern}"
+        )
+    if left.has_ellipsis and left.has_ellipsis_parenthesized:
+        raise ValueError(
+            f"Ellipsis is parenthesis in the left side is not allowed: {pattern}"
+        )
+
+    return left, right
+
+
+def validate_rearrange_expressions(
+    left: ParsedExpression, right: ParsedExpression, axes_lengths: Mapping[str, int]
+) -> None:
+    """Perform expression validations that are specific to the `rearrange` operation.
+
+    Args:
+        left (ParsedExpression): left-hand side expression
+        right (ParsedExpression): right-hand side expression
+        axes_lengths (Mapping[str, int]): any additional length specifications for dimensions
+    """
+    for length in axes_lengths.values():
+        if (length_type := type(length)) is not int:
+            raise TypeError(
+                f"rearrange axis lengths must be integers, got: {length_type}"
+            )
+
+    if left.has_non_unitary_anonymous_axes or right.has_non_unitary_anonymous_axes:
+        raise ValueError("rearrange only supports unnamed axes of size 1")
+
+    difference = set.symmetric_difference(left.identifiers, right.identifiers)
+    if len(difference) > 0:
+        raise ValueError(
+            f"Identifiers only on one side of rearrange expression (should be on both): {difference}"
+        )
+
+    unmatched_axes = axes_lengths.keys() - left.identifiers
+    if len(unmatched_axes) > 0:
+        raise ValueError(
+            f"Identifiers not found in rearrange expression: {unmatched_axes}"
+        )
+
+
+def comma_separate(collection: Collection[Union[str, Collection[str]]]) -> str:
+    """Convert a collection of strings representing first class dims into a comma-separated string.
+
+    Args:
+        collection (Collection[Union[str, Collection[str]]]): the collection of strings to convert
+
+    Returns:
+        str: the comma-separated string
+
+    Examples:
+        >>> comma_separate(('d0',))
+        'd0'
+
+        >>> comma_separate(('d0', 'd1', 'd2', 'd3'))
+        'd0, d1, d2, d3'
+
+        >>> comma_separate([('d1', 'd4')])
+        '(d1, d4)'
+
+        >>> comma_separate([('d0',), (), ('d1',), ('d2',), ('d3', 'd4')])
+        '(d0,), (), (d1,), (d2,), (d3, d4)'
+    """
+    return ", ".join(
+        item
+        if isinstance(item, str)
+        else f"({comma_separate(item)}{',' if len(item) == 1 else ''})"
+        for item in collection
+    )
diff --git a/llm/Lib/site-packages/functorch/einops/rearrange.py b/llm/Lib/site-packages/functorch/einops/rearrange.py
new file mode 100644
index 0000000000000000000000000000000000000000..b5040d529e8c3ab1464a0fa95766e4f956de6cce
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/einops/rearrange.py
@@ -0,0 +1,207 @@
+from __future__ import annotations
+
+import functools
+from typing import Callable, Dict, List, Sequence, Tuple, Union
+
+import torch
+
+from functorch._C import dim as _C
+from ._parsing import (
+    _ellipsis,
+    AnonymousAxis,
+    comma_separate,
+    parse_pattern,
+    validate_rearrange_expressions,
+)
+
+__all__ = ["rearrange"]
+
+dims = _C.dims
+
+
+@functools.lru_cache(256)
+def _create_rearrange_callable(
+    tensor_ndim: int, pattern: str, **axes_lengths: int
+) -> Callable[[torch.Tensor], torch.Tensor]:
+    r"""Translate an `einops`-style pattern into a callable that performs the rearrange using first-class dimensions.
+
+    Since the an equivalent result is computed for tensors with the same number of dimensions, with the same pattern and
+    specified axes lengths, this function can be memoized.
+
+    Args:
+        tensor_ndim (int): the number of dimensions in the tensor to rearrange
+        pattern (str): the `einops`-style rearrangement pattern
+        axes_lengths (int): any additional length specifications for dimensions
+
+    Returns:
+        Callable[[torch.Tensor], torch.Tensor]: a callable that performs the rearrangement
+    """
+    left, right = parse_pattern(pattern, axes_lengths)
+    validate_rearrange_expressions(left, right, axes_lengths)
+
+    n_anon_dims = sum(not dim for dim in left.composition)
+    if left.has_ellipsis:
+        n_ellipsis_dims = tensor_ndim - (len(left.composition) - 1)
+        n_named_dims = len(left.identifiers) - 1
+
+        if (pattern_ndim := n_anon_dims + n_named_dims) > tensor_ndim:
+            raise ValueError(
+                f"Number of dimensions in pattern ({pattern_ndim}) must be less than or equal to the number of "
+                f"dimensions in the tensor ({tensor_ndim})"
+            )
+    else:
+        n_ellipsis_dims = 0
+        n_named_dims = len(left.identifiers)
+
+        if (pattern_ndim := len(left.composition)) != tensor_ndim:
+            raise ValueError(
+                f"Number of dimensions in pattern ({pattern_ndim}) must be equal to the number of dimensions in "
+                f"the tensor ({tensor_ndim})"
+            )
+    n_dims = n_named_dims + n_ellipsis_dims + n_anon_dims
+
+    if n_dims == 0:
+        # an identity rearrangement on a 0-dimension tensor
+        return lambda tensor: tensor
+
+    first_class_dims: Tuple[str, ...] = tuple(f"d{i}" for i in range(n_dims))
+    identifier_dim_map: Dict[Union[str, AnonymousAxis], Tuple[str, ...]] = {}
+    anon_axes: List[AnonymousAxis] = []
+
+    # map the left-hand side identifiers to strings representing first class dims
+    dims_i = 0
+    for dimension in left.composition:
+        if isinstance(dimension, list):
+            for identifier in dimension:
+                # non-unitary anon axes are not allowed in rearrange & unitary anon axes are represented as empty lists
+                assert isinstance(identifier, str)
+                identifier_dim_map[identifier] = (first_class_dims[dims_i],)
+                dims_i += 1
+            if not dimension:
+                # unitary anonymous axis
+                anon_axis = AnonymousAxis("1")
+                identifier_dim_map[anon_axis] = (first_class_dims[dims_i],)
+                anon_axes.append(anon_axis)
+                dimension.append(anon_axis)
+                dims_i += 1
+        elif dimension == _ellipsis:
+            identifier = _ellipsis
+            identifier_dim_map[identifier] = tuple(
+                first_class_dims[dims_i + j] for j in range(n_ellipsis_dims)
+            )
+            dims_i += n_ellipsis_dims
+        else:
+            raise ValueError(f"Unexpected dimension: {dimension}")
+
+    def composition_to_dims(
+        composition: Sequence[Union[List[Union[str, AnonymousAxis]], str]]
+    ) -> List[Union[str, Tuple[str, ...]]]:
+        """Convert a `ParsedExpression.composition` into a `Tensor.__getitem__` index of strings representing first
+        class dims."""
+        dim_composition: List[Union[str, Tuple[str, ...]]] = []
+        for dimension in composition:
+            if isinstance(dimension, list):
+                dim_composition.append(
+                    tuple(
+                        dim
+                        for identifier in dimension
+                        for dim in identifier_dim_map[identifier]
+                    )
+                )
+            elif dimension == _ellipsis:
+                dim_composition.extend(identifier_dim_map[_ellipsis])
+            else:
+                raise ValueError(f"Unexpected dimension: {dimension}")
+        return dim_composition
+
+    left_dims = composition_to_dims(left.composition)
+    right_dims = composition_to_dims(right.composition)
+    anon_dims = tuple(identifier_dim_map[axis][0] for axis in anon_axes)
+    specified_lengths = tuple(
+        (identifier_dim_map[axis][0], length) for axis, length in axes_lengths.items()
+    )
+
+    custom_rearrange_callable_name = "do_rearrange"
+    custom_rearrange_callable_code = (
+        (
+            f"def {custom_rearrange_callable_name}(tensor):\n"
+            f"    {comma_separate(first_class_dims)} = dims({n_dims})\n"
+        )
+        + (
+            "".join(
+                f"    {dim}.size = {length}\n" for (dim, length) in specified_lengths
+            )
+            if specified_lengths
+            else ""
+        )
+        + f"    tensor = tensor[{comma_separate(left_dims)}].order({comma_separate(right_dims)})\n"
+        + (
+            f"    return tensor.sum({comma_separate([anon_dims])}, keepdim=False)\n"
+            if anon_dims
+            else "    return tensor\n"
+        )
+    )
+
+    exec(custom_rearrange_callable_code)
+    return locals()[custom_rearrange_callable_name]
+
+
+def rearrange(
+    tensor: Union[torch.Tensor, List[torch.Tensor], Tuple[torch.Tensor, ...]],
+    pattern: str,
+    **axes_lengths: int,
+) -> torch.Tensor:
+    r"""A native implementation of `einops.rearrange`, a reader-friendly smart element reordering for multidimensional
+    tensors. This operation includes functionality of transpose (axes permutation), reshape (view), squeeze, unsqueeze,
+    stack, concatenate and other operations.
+
+    See: https://einops.rocks/api/rearrange/
+
+    Args:
+        tensor (Tensor or sequence of Tensor): the tensor(s) to rearrange
+        pattern (str): the rearrangement pattern
+        axes_lengths (int): any additional length specifications for dimensions
+
+    Returns:
+        Tensor: the rearranged tensor
+
+    Examples:
+        >>> # suppose we have a set of 32 images in "h w c" format (height-width-channel)
+        >>> images = torch.randn((32, 30, 40, 3))
+
+        >>> # stack along first (batch) axis, output is a single array
+        >>> rearrange(images, 'b h w c -> b h w c').shape
+        torch.Size([32, 30, 40, 3])
+
+        >>> # concatenate images along height (vertical axis), 960 = 32 * 30
+        >>> rearrange(images, 'b h w c -> (b h) w c').shape
+        torch.Size([960, 40, 3])
+
+        >>> # concatenated images along horizontal axis, 1280 = 32 * 40
+        >>> rearrange(images, 'b h w c -> h (b w) c').shape
+        torch.Size([30, 1280, 3])
+
+        >>> # reordered axes to "b c h w" format for deep learning
+        >>> rearrange(images, 'b h w c -> b c h w').shape
+        torch.Size([32, 3, 30, 40])
+
+        >>> # flattened each image into a vector, 3600 = 30 * 40 * 3
+        >>> rearrange(images, 'b h w c -> b (c h w)').shape
+        torch.Size([32, 3600])
+
+        >>> # split each image into 4 smaller (top-left, top-right, bottom-left, bottom-right), 128 = 32 * 2 * 2
+        >>> rearrange(images, 'b (h1 h) (w1 w) c -> (b h1 w1) h w c', h1=2, w1=2).shape
+        torch.Size([128, 15, 20, 3])
+
+        >>> # space-to-depth operation
+        >>> rearrange(images, 'b (h h1) (w w1) c -> b h w (c h1 w1)', h1=2, w1=2).shape
+        torch.Size([32, 15, 20, 12])
+    """
+    if not isinstance(tensor, torch.Tensor):
+        tensor = torch.stack(tensor)
+
+    rearrange_callable = _create_rearrange_callable(
+        tensor.ndim, pattern, **axes_lengths
+    )
+
+    return rearrange_callable(tensor)
diff --git a/llm/Lib/site-packages/functorch/experimental/__init__.py b/llm/Lib/site-packages/functorch/experimental/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d3c0a43ae10a0334d6c48b0cbc4a8aaf63ede85a
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/experimental/__init__.py
@@ -0,0 +1,6 @@
+# PyTorch forward-mode is not mature yet
+from torch._functorch.apis import chunk_vmap
+from torch._functorch.batch_norm_replacement import replace_all_batch_norm_modules_
+from torch._functorch.eager_transforms import hessian, jacfwd, jvp
+
+from functorch import functionalize
diff --git a/llm/Lib/site-packages/functorch/experimental/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/functorch/experimental/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5135124e36810e4352e54a651d7698482acafc8e
Binary files /dev/null and b/llm/Lib/site-packages/functorch/experimental/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/experimental/__pycache__/control_flow.cpython-311.pyc b/llm/Lib/site-packages/functorch/experimental/__pycache__/control_flow.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e83706b334ee0df9b62d13debdfab4440c15adbf
Binary files /dev/null and b/llm/Lib/site-packages/functorch/experimental/__pycache__/control_flow.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/experimental/__pycache__/ops.cpython-311.pyc b/llm/Lib/site-packages/functorch/experimental/__pycache__/ops.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8d21664c9ee9dde8eafdb62cb9b7ecc88da67428
Binary files /dev/null and b/llm/Lib/site-packages/functorch/experimental/__pycache__/ops.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/functorch/experimental/control_flow.py b/llm/Lib/site-packages/functorch/experimental/control_flow.py
new file mode 100644
index 0000000000000000000000000000000000000000..1815c78847b7550f831b15ba0492658bcceaac3b
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/experimental/control_flow.py
@@ -0,0 +1,8 @@
+from torch import cond  # noqa: F401
+from torch._higher_order_ops.cond import UnsupportedAliasMutationException  # noqa: F401
+
+from torch._higher_order_ops.map import (  # noqa: F401
+    _stack_pytree,
+    _unstack_pytree,
+    map,
+)
diff --git a/llm/Lib/site-packages/functorch/experimental/ops.py b/llm/Lib/site-packages/functorch/experimental/ops.py
new file mode 100644
index 0000000000000000000000000000000000000000..144515478f0c537ee28ba46f72e3a70f08858f38
--- /dev/null
+++ b/llm/Lib/site-packages/functorch/experimental/ops.py
@@ -0,0 +1 @@
+from torch._ops import HigherOrderOperator  # noqa: F401
diff --git a/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/DESCRIPTION.rst b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/DESCRIPTION.rst
new file mode 100644
index 0000000000000000000000000000000000000000..2ad4df59961d16c15a3d80c52badacba759dc14b
--- /dev/null
+++ b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/DESCRIPTION.rst
@@ -0,0 +1,6 @@
+
+GeoMet
+
+Convert GeoJSON to WKT/WKB (Well-Known Text/Binary), and vice versa.
+
+
diff --git a/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/INSTALLER b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/METADATA b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..7471327dde7ca20f080b7c36c12a7e0750f6fe27
--- /dev/null
+++ b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/METADATA
@@ -0,0 +1,32 @@
+Metadata-Version: 2.0
+Name: geomet
+Version: 0.2.1.post1
+Summary: GeoJSON <-> WKT/WKB conversion utilities
+Home-page: https://github.com/geomet/geomet
+Maintainer: Lars Butler
+Maintainer-email: lars.butler@gmail.com
+License: Apache 2.0
+Keywords: wkb wkt geojson
+Platform: any
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >2.6, !=3.3.*, <4
+Requires-Dist: click
+Requires-Dist: six
+
+
+GeoMet
+
+Convert GeoJSON to WKT/WKB (Well-Known Text/Binary), and vice versa.
+
+
diff --git a/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/RECORD b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..5656f849d776a890204a03a189247cc011d42bba
--- /dev/null
+++ b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/RECORD
@@ -0,0 +1,19 @@
+../../Scripts/geomet.exe,sha256=4z3ZLgOeWYOHtkJkZsmLp8uR_dQ-9QHp1phmopPMcK8,108376
+geomet-0.2.1.post1.dist-info/DESCRIPTION.rst,sha256=a0eagLsAH83QNDRxPYRMYoN9rAWGM9BIDrPLW1Xd2BE,80
+geomet-0.2.1.post1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+geomet-0.2.1.post1.dist-info/METADATA,sha256=bAr6SlxUfGfXwF_eeO9JCweBfnHXRB4mZgjC6PFs4Vg,1021
+geomet-0.2.1.post1.dist-info/RECORD,,
+geomet-0.2.1.post1.dist-info/WHEEL,sha256=-aSo8rHuuPDEFzkcqqQ55pDyCjy25bYMLxSiHWKAOTc,92
+geomet-0.2.1.post1.dist-info/entry_points.txt,sha256=Sg9nCG9A3p1YUcUFM8A5ljv7m5S7xjU6cRyxIspA0B0,44
+geomet-0.2.1.post1.dist-info/metadata.json,sha256=WMNID8WsUBihoqcSktJhGIYDtxJOzqL3WiIyTBlb21c,1235
+geomet-0.2.1.post1.dist-info/top_level.txt,sha256=VLGhEnyKFna0kJi3gbO6vQChgBTUK6UYDXZAA8Wi86A,7
+geomet/__init__.py,sha256=HSLKOYsdusp3hU3osW5gavVQanRJwZb-JtA1JTsST8c,769
+geomet/__pycache__/__init__.cpython-311.pyc,,
+geomet/__pycache__/tool.cpython-311.pyc,,
+geomet/__pycache__/util.cpython-311.pyc,,
+geomet/__pycache__/wkb.cpython-311.pyc,,
+geomet/__pycache__/wkt.cpython-311.pyc,,
+geomet/tool.py,sha256=P2teovzSAR1XvP9hvlJ5nAIo8nbeT1UBKKZJKAkFHKY,3796
+geomet/util.py,sha256=t8V5jRs8-ABdDvtSS35yiribf-5LsM6FcFHfU6m_0IM,4096
+geomet/wkb.py,sha256=gH-ZMOGp8rTf0VHk429WbcFRTWSl6O1hxM3Ws5HfpHs,30808
+geomet/wkt.py,sha256=73ihn6JKtocmQa4iYfhvip8uAfmZD00_0vvz5s_xaYI,17964
diff --git a/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/WHEEL b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..4c62fb97e97c72edbf786b692994d784e7ea38e5
--- /dev/null
+++ b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.24.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/entry_points.txt b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..3d9ca55b986e528c7c74cc6be985533e12593b5e
--- /dev/null
+++ b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/entry_points.txt
@@ -0,0 +1,3 @@
+[console_scripts]
+geomet = geomet.tool:cli
+
diff --git a/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/metadata.json b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/metadata.json
new file mode 100644
index 0000000000000000000000000000000000000000..c09d2fc5c90303a84a657e28ff1874038c21f8bc
--- /dev/null
+++ b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/metadata.json
@@ -0,0 +1 @@
+{"generator": "bdist_wheel (0.24.0)", "summary": "GeoJSON <-> WKT/WKB conversion utilities", "metadata_version": "2.0", "name": "geomet", "version": "0.2.1.post1", "extensions": {"python.details": {"project_urls": {"Home": "https://github.com/geomet/geomet"}, "contacts": [{"email": "lars.butler@gmail.com", "name": "Lars Butler", "role": "maintainer"}], "document_names": {"description": "DESCRIPTION.rst"}}, "python.exports": {"console_scripts": {"geomet": "geomet.tool:cli"}}, "python.commands": {"wrap_console": {"geomet": "geomet.tool:cli"}}}, "license": "Apache 2.0", "keywords": ["wkb", "wkt", "geojson"], "platform": "any", "classifiers": ["Development Status :: 4 - Beta", "License :: OSI Approved :: Apache Software License", "Intended Audience :: Developers", "Intended Audience :: Education", "Intended Audience :: Science/Research", "Operating System :: OS Independent", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: Scientific/Engineering :: GIS"], "requires_python": ">2.6, !=3.3.*, <4", "run_requires": [{"requires": ["click", "six"]}], "extras": []}
\ No newline at end of file
diff --git a/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/top_level.txt b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..a2a2ba1781fc2cd07bcc3df85c6d7977f97b86a5
--- /dev/null
+++ b/llm/Lib/site-packages/geomet-0.2.1.post1.dist-info/top_level.txt
@@ -0,0 +1 @@
+geomet
diff --git a/llm/Lib/site-packages/geomet/__init__.py b/llm/Lib/site-packages/geomet/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3388052ae327794f39d9e309c3460eb8e097247c
--- /dev/null
+++ b/llm/Lib/site-packages/geomet/__init__.py
@@ -0,0 +1,20 @@
+#  Copyright 2013 Lars Butler & individual contributors
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+__version__ = '0.2.1-1'
+
+
+class InvalidGeoJSONException(Exception):
+    """
+    Simple exception class to indicate if invalid GeoJSON is encountered.
+    """
diff --git a/llm/Lib/site-packages/geomet/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/geomet/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fa76a16876baa71927ad96ccc40c1e79c89866f3
Binary files /dev/null and b/llm/Lib/site-packages/geomet/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/geomet/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/geomet/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ec5d4415d2be2a5baa6ca5a889e5f80941b352f7
Binary files /dev/null and b/llm/Lib/site-packages/geomet/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/geomet/__pycache__/util.cpython-311.pyc b/llm/Lib/site-packages/geomet/__pycache__/util.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..702e5f6793954d41c33b9d29510ee1d2d5bf70cc
Binary files /dev/null and b/llm/Lib/site-packages/geomet/__pycache__/util.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/geomet/__pycache__/wkb.cpython-311.pyc b/llm/Lib/site-packages/geomet/__pycache__/wkb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..30f65b2eb104f02d290127198c54699559884638
Binary files /dev/null and b/llm/Lib/site-packages/geomet/__pycache__/wkb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/geomet/__pycache__/wkt.cpython-311.pyc b/llm/Lib/site-packages/geomet/__pycache__/wkt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1bba849eb3aaae189c2b5046a4a39c17fd807321
Binary files /dev/null and b/llm/Lib/site-packages/geomet/__pycache__/wkt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/geomet/tool.py b/llm/Lib/site-packages/geomet/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..ef09dec8abd3df30218d954d061402bddb7e490d
--- /dev/null
+++ b/llm/Lib/site-packages/geomet/tool.py
@@ -0,0 +1,120 @@
+#!/usr/bin/env python
+
+#  Copyright 2013 Lars Butler & individual contributors
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+"""Simple CLI for converting between WKB/WKT and GeoJSON
+
+Example usage:
+
+  $ echo "POINT (0.9999999 0.9999999)" \
+  > | geomet --wkb - \
+  > | geomet --wkt --precision 7 -
+  POINT (0.9999999 0.9999999)
+
+"""
+
+from binascii import a2b_hex
+from binascii import b2a_hex
+import json
+import logging
+import sys
+
+import click
+
+from geomet import util, wkb, wkt
+
+CONTEXT_SETTINGS = dict(help_option_names=['-h', '--help'])
+
+
+def configure_logging(verbosity):
+    log_level = max(10, 30 - 10 * verbosity)
+    logging.basicConfig(stream=sys.stderr, level=log_level)
+
+
+def translate(text, output_format='json', indent=None, precision=-1):
+    if text.startswith('{'):
+        geom = json.loads(text)
+    elif text.startswith(('G', 'L', 'M', 'P')):
+        geom = wkt.loads(text)
+    else:
+        geom = wkb.loads(a2b_hex(text))
+    if output_format == 'wkb':
+        output = b2a_hex(wkb.dumps(geom))
+    elif output_format == 'wkt':
+        kwds = {}
+        if precision >= 0:
+            kwds['decimals'] = precision
+        output = wkt.dumps(geom, **kwds)
+    else:
+        if precision >= 0:
+            geom = util.round_geom(geom, precision)
+        output = json.dumps(geom, indent=indent, sort_keys=True)
+    return output
+
+
+@click.command(
+    short_help="Convert between WKT or hex-encoded WKB and GeoJSON.",
+    context_settings=CONTEXT_SETTINGS)
+@click.argument('input', default='-', required=False)
+@click.option('--verbose', '-v', count=True, help="Increase verbosity.")
+@click.option('--quiet', '-q', count=True, help="Decrease verbosity.")
+@click.option('--json', 'output_format', flag_value='json', default=True,
+              help="JSON output.")
+@click.option('--wkb', 'output_format', flag_value='wkb',
+              help="Hex-encoded WKB output.")
+@click.option('--wkt', 'output_format', flag_value='wkt',
+              help="WKT output.")
+@click.option('--precision', type=int, default=-1,
+              help="Decimal precision of JSON and WKT coordinates.")
+@click.option('--indent', default=None, type=int,
+              help="Indentation level for pretty printed output")
+def cli(input, verbose, quiet, output_format, precision, indent):
+    """Convert text read from the first positional argument, stdin, or
+    a file to GeoJSON and write to stdout."""
+
+    verbosity = verbose - quiet
+    configure_logging(verbosity)
+    logger = logging.getLogger('geomet')
+
+    # Handle the case of file, stream, or string input.
+    try:
+        src = click.open_file(input).readlines()
+    except IOError:
+        src = [input]
+
+    stdout = click.get_text_stream('stdout')
+
+    # Read-write loop.
+    try:
+        for line in src:
+            text = line.strip()
+            logger.debug("Input: %r", text)
+            output = translate(
+                text,
+                output_format=output_format,
+                indent=indent,
+                precision=precision
+            )
+            logger.debug("Output: %r", output)
+            stdout.write(output)
+            stdout.write('\n')
+        sys.exit(0)
+    except Exception:
+        logger.exception("Failed. Exception caught")
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    cli()
diff --git a/llm/Lib/site-packages/geomet/util.py b/llm/Lib/site-packages/geomet/util.py
new file mode 100644
index 0000000000000000000000000000000000000000..19bbd64e9f990a7071115f91dbc9f8be594f2ab8
--- /dev/null
+++ b/llm/Lib/site-packages/geomet/util.py
@@ -0,0 +1,128 @@
+#  Copyright 2013 Lars Butler & individual contributors
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+import itertools
+import six
+if six.PY2:
+    import collections
+else:
+    import collections.abc as collections
+
+
+def block_splitter(data, block_size):
+    """
+    Creates a generator by slicing ``data`` into chunks of ``block_size``.
+
+    >>> data = range(10)
+    >>> list(block_splitter(data, 2))
+    [[0, 1], [2, 3], [4, 5], [6, 7], [8, 9]]
+
+    If ``data`` cannot be evenly divided by ``block_size``, the last block will
+    simply be the remainder of the data. Example:
+
+    >>> data = range(10)
+    >>> list(block_splitter(data, 3))
+    [[0, 1, 2], [3, 4, 5], [6, 7, 8], [9]]
+
+    If the ``block_size`` is greater than the total length of ``data``, a
+    single block will be generated:
+
+    >>> data = range(3)
+    >>> list(block_splitter(data, 4))
+    [[0, 1, 2]]
+
+    :param data:
+        Any iterable. If ``data`` is a generator, it will be exhausted,
+        obviously.
+    :param int block_site:
+        Desired (maximum) block size.
+    """
+    buf = []
+    for i, datum in enumerate(data):
+        buf.append(datum)
+        if len(buf) == block_size:
+            yield buf
+            buf = []
+
+    # If there's anything leftover (a partial block),
+    # yield it as well.
+    if buf:
+        yield buf
+
+
+def take(n, iterable):
+    """
+    Return first n items of the iterable as a list
+
+    Copied shamelessly from
+    http://docs.python.org/2/library/itertools.html#recipes.
+    """
+    return list(itertools.islice(iterable, n))
+
+
+def as_bin_str(a_list):
+    if six.PY2:
+        return b''.join(a_list)
+    else:
+        return bytes(a_list)
+
+
+def round_geom(geom, precision=None):
+    """Round coordinates of a geometric object to given precision."""
+    if geom['type'] == 'Point':
+        x, y = geom['coordinates']
+        xp, yp = [x], [y]
+        if precision is not None:
+            xp = [round(v, precision) for v in xp]
+            yp = [round(v, precision) for v in yp]
+        new_coords = tuple(zip(xp, yp))[0]
+    if geom['type'] in ['LineString', 'MultiPoint']:
+        xp, yp = zip(*geom['coordinates'])
+        if precision is not None:
+            xp = [round(v, precision) for v in xp]
+            yp = [round(v, precision) for v in yp]
+        new_coords = tuple(zip(xp, yp))
+    elif geom['type'] in ['Polygon', 'MultiLineString']:
+        new_coords = []
+        for piece in geom['coordinates']:
+            xp, yp = zip(*piece)
+            if precision is not None:
+                xp = [round(v, precision) for v in xp]
+                yp = [round(v, precision) for v in yp]
+            new_coords.append(tuple(zip(xp, yp)))
+    elif geom['type'] == 'MultiPolygon':
+        parts = geom['coordinates']
+        new_coords = []
+        for part in parts:
+            inner_coords = []
+            for ring in part:
+                xp, yp = zip(*ring)
+                if precision is not None:
+                    xp = [round(v, precision) for v in xp]
+                    yp = [round(v, precision) for v in yp]
+                inner_coords.append(tuple(zip(xp, yp)))
+            new_coords.append(inner_coords)
+    return {'type': geom['type'], 'coordinates': new_coords}
+
+
+def flatten_multi_dim(sequence):
+    """Flatten a multi-dimensional array-like to a single dimensional sequence
+    (as a generator).
+    """
+    for x in sequence:
+        if (isinstance(x, collections.Iterable)
+                and not isinstance(x, six.string_types)):
+            for y in flatten_multi_dim(x):
+                yield y
+        else:
+            yield x
diff --git a/llm/Lib/site-packages/geomet/wkb.py b/llm/Lib/site-packages/geomet/wkb.py
new file mode 100644
index 0000000000000000000000000000000000000000..7136c34cc2df01aa281b8f090d00efee3d67215b
--- /dev/null
+++ b/llm/Lib/site-packages/geomet/wkb.py
@@ -0,0 +1,943 @@
+#  Copyright 2013 Lars Butler & individual contributors
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+import binascii
+import six
+import struct
+
+from geomet.util import block_splitter
+from geomet.util import take
+from geomet.util import as_bin_str
+from geomet.util import flatten_multi_dim
+from itertools import chain
+
+#: '\x00': The first byte of any WKB string. Indicates big endian byte
+#: ordering for the data.
+BIG_ENDIAN = b'\x00'
+#: '\x01': The first byte of any WKB string. Indicates little endian byte
+#: ordering for the data.
+LITTLE_ENDIAN = b'\x01'
+#: High byte in a 4-byte geometry type field to indicate that a 4-byte SRID
+#: field follows.
+SRID_FLAG = b'\x20'
+
+#: Mapping of GeoJSON geometry types to the "2D" 4-byte binary string
+#: representation for WKB. "2D" indicates that the geometry is 2-dimensional,
+#: X and Y components.
+#: NOTE: Byte ordering is big endian.
+WKB_2D = {
+    'Point': b'\x00\x00\x00\x01',
+    'LineString': b'\x00\x00\x00\x02',
+    'Polygon': b'\x00\x00\x00\x03',
+    'MultiPoint': b'\x00\x00\x00\x04',
+    'MultiLineString': b'\x00\x00\x00\x05',
+    'MultiPolygon': b'\x00\x00\x00\x06',
+    'GeometryCollection': b'\x00\x00\x00\x07',
+}
+
+#: Mapping of GeoJSON geometry types to the "Z" 4-byte binary string
+#: representation for WKB. "Z" indicates that the geometry is 3-dimensional,
+#: with X, Y, and Z components.
+#: NOTE: Byte ordering is big endian.
+WKB_Z = {
+    'Point': b'\x00\x00\x03\xe9',
+    'LineString': b'\x00\x00\x03\xea',
+    'Polygon': b'\x00\x00\x03\xeb',
+    'MultiPoint': b'\x00\x00\x03\xec',
+    'MultiLineString': b'\x00\x00\x03\xed',
+    'MultiPolygon': b'\x00\x00\x03\xee',
+    'GeometryCollection': b'\x00\x00\x03\xef',
+}
+
+#: Mapping of GeoJSON geometry types to the "M" 4-byte binary string
+#: representation for WKB. "M" indicates that the geometry is 2-dimensional,
+#: with X, Y, and M ("Measure") components.
+#: NOTE: Byte ordering is big endian.
+WKB_M = {
+    'Point': b'\x00\x00\x07\xd1',
+    'LineString': b'\x00\x00\x07\xd2',
+    'Polygon': b'\x00\x00\x07\xd3',
+    'MultiPoint': b'\x00\x00\x07\xd4',
+    'MultiLineString': b'\x00\x00\x07\xd5',
+    'MultiPolygon': b'\x00\x00\x07\xd6',
+    'GeometryCollection': b'\x00\x00\x07\xd7',
+}
+
+#: Mapping of GeoJSON geometry types to the "ZM" 4-byte binary string
+#: representation for WKB. "ZM" indicates that the geometry is 4-dimensional,
+#: with X, Y, Z, and M ("Measure") components.
+#: NOTE: Byte ordering is big endian.
+WKB_ZM = {
+    'Point': b'\x00\x00\x0b\xb9',
+    'LineString': b'\x00\x00\x0b\xba',
+    'Polygon': b'\x00\x00\x0b\xbb',
+    'MultiPoint': b'\x00\x00\x0b\xbc',
+    'MultiLineString': b'\x00\x00\x0b\xbd',
+    'MultiPolygon': b'\x00\x00\x0b\xbe',
+    'GeometryCollection': b'\x00\x00\x0b\xbf',
+}
+
+#: Mapping of dimension types to maps of GeoJSON geometry type -> 4-byte binary
+#: string representation for WKB.
+_WKB = {
+    '2D': WKB_2D,
+    'Z': WKB_Z,
+    'M': WKB_M,
+    'ZM': WKB_ZM,
+}
+
+#: Mapping from binary geometry type (as a 4-byte binary string) to GeoJSON
+#: geometry type.
+#: NOTE: Byte ordering is big endian.
+_BINARY_TO_GEOM_TYPE = dict(
+    chain(*((reversed(x) for x in wkb_map.items())
+            for wkb_map in _WKB.values()))
+)
+
+_INT_TO_DIM_LABEL = {2: '2D', 3: 'Z', 4: 'ZM'}
+
+
+def _get_geom_type(type_bytes):
+    """Get the GeoJSON geometry type label from a WKB type byte string.
+
+    :param type_bytes:
+        4 byte string in big endian byte order containing a WKB type number.
+        It may also contain a "has SRID" flag in the high byte (the first type,
+        since this is big endian byte order), indicated as 0x20. If the SRID
+        flag is not set, the high byte will always be null (0x00).
+    :returns:
+        3-tuple ofGeoJSON geometry type label, the bytes resprenting the
+        geometry type, and a separate "has SRID" flag. If the input
+        `type_bytes` contains an SRID flag, it will be removed.
+
+        >>> # Z Point, with SRID flag
+        >>> _get_geom_type(b'\\x20\\x00\\x03\\xe9') == (
+        ... 'Point', b'\\x00\\x00\\x03\\xe9', True)
+        True
+
+        >>> # 2D MultiLineString, without SRID flag
+        >>> _get_geom_type(b'\\x00\\x00\\x00\\x05') == (
+        ... 'MultiLineString', b'\\x00\\x00\\x00\\x05', False)
+        True
+
+    """
+    # slice off the high byte, which may contain the SRID flag
+    high_byte = type_bytes[0]
+    if six.PY3:
+        high_byte = bytes([high_byte])
+    has_srid = high_byte == b'\x20'
+    if has_srid:
+        # replace the high byte with a null byte
+        type_bytes = as_bin_str(b'\x00' + type_bytes[1:])
+    else:
+        type_bytes = as_bin_str(type_bytes)
+
+    # look up the geometry type
+    geom_type = _BINARY_TO_GEOM_TYPE.get(type_bytes)
+    return geom_type, type_bytes, has_srid
+
+
+def dump(obj, dest_file):
+    """
+    Dump GeoJSON-like `dict` to WKB and write it to the `dest_file`.
+
+    :param dict obj:
+        A GeoJSON-like dictionary. It must at least the keys 'type' and
+        'coordinates'.
+    :param dest_file:
+        Open and writable file-like object.
+    """
+    dest_file.write(dumps(obj))
+
+
+def load(source_file):
+    """
+    Load a GeoJSON `dict` object from a ``source_file`` containing WKB (as a
+    byte string).
+
+    :param source_file:
+        Open and readable file-like object.
+
+    :returns:
+        A GeoJSON `dict` representing the geometry read from the file.
+    """
+    return loads(source_file.read())
+
+
+def dumps(obj, big_endian=True):
+    """
+    Dump a GeoJSON-like `dict` to a WKB string.
+
+    .. note::
+        The dimensions of the generated WKB will be inferred from the first
+        vertex in the GeoJSON `coordinates`. It will be assumed that all
+        vertices are uniform. There are 4 types:
+
+        - 2D (X, Y): 2-dimensional geometry
+        - Z (X, Y, Z): 3-dimensional geometry
+        - M (X, Y, M): 2-dimensional geometry with a "Measure"
+        - ZM (X, Y, Z, M): 3-dimensional geometry with a "Measure"
+
+        If the first vertex contains 2 values, we assume a 2D geometry.
+        If the first vertex contains 3 values, this is slightly ambiguous and
+        so the most common case is chosen: Z.
+        If the first vertex contains 4 values, we assume a ZM geometry.
+
+        The WKT/WKB standards provide a way of differentiating normal (2D), Z,
+        M, and ZM geometries (http://en.wikipedia.org/wiki/Well-known_text),
+        but the GeoJSON spec does not. Therefore, for the sake of interface
+        simplicity, we assume that geometry that looks 3D contains XYZ
+        components, instead of XYM.
+
+        If the coordinates list has no coordinate values (this includes nested
+        lists, for example, `[[[[],[]], []]]`, the geometry is considered to be
+        empty. Geometries, with the exception of points, have a reasonable
+        "empty" representation in WKB; however, without knowing the number of
+        coordinate values per vertex, the type is ambigious, and thus we don't
+        know if the geometry type is 2D, Z, M, or ZM. Therefore in this case
+        we expect a `ValueError` to be raised.
+
+    :param dict obj:
+        GeoJson-like `dict` object.
+    :param bool big_endian:
+        Defaults to `True`. If `True`, data values in the generated WKB will
+        be represented using big endian byte order. Else, little endian.
+
+    TODO: remove this
+
+    :param str dims:
+        Indicates to WKB representation desired from converting the given
+        GeoJSON `dict` ``obj``. The accepted values are:
+
+        * '2D': 2-dimensional geometry (X, Y)
+        * 'Z': 3-dimensional geometry (X, Y, Z)
+        * 'M': 3-dimensional geometry (X, Y, M)
+        * 'ZM': 4-dimensional geometry (X, Y, Z, M)
+
+    :returns:
+        A WKB binary string representing of the ``obj``.
+    """
+    geom_type = obj['type']
+    meta = obj.get('meta', {})
+
+    exporter = _dumps_registry.get(geom_type)
+    if exporter is None:
+        _unsupported_geom_type(geom_type)
+
+    # Check for empty geometries. GeometryCollections have a slightly different
+    # JSON/dict structure, but that's handled.
+    coords_or_geoms = obj.get('coordinates', obj.get('geometries'))
+    if len(list(flatten_multi_dim(coords_or_geoms))) == 0:
+        raise ValueError(
+            'Empty geometries cannot be represented in WKB. Reason: The '
+            'dimensionality of the WKB would be ambiguous.'
+        )
+
+    return exporter(obj, big_endian, meta)
+
+
+def loads(string):
+    """
+    Construct a GeoJSON `dict` from WKB (`string`).
+
+    The resulting GeoJSON `dict` will include the SRID as an integer in the
+    `meta` object. This was an arbitrary decision made by `geomet, the
+    discussion of which took place here:
+    https://github.com/geomet/geomet/issues/28.
+
+    In order to be consistent with other libraries [1] and (deprecated)
+    specifications [2], also include the same information in a `crs`
+    object. This isn't ideal, but the `crs` member is no longer part of
+    the GeoJSON standard, according to RFC7946 [3]. However, it's still
+    useful to include this information in GeoJSON payloads because it
+    supports conversion to EWKT/EWKB (which are canonical formats used by
+    PostGIS and the like).
+
+    Example:
+
+        {'type': 'Point',
+         'coordinates': [0.0, 1.0],
+         'meta': {'srid': 4326},
+         'crs': {'type': 'name', 'properties': {'name': 'EPSG4326'}}}
+
+    NOTE(larsbutler): I'm not sure if it's valid to just prefix EPSG
+    (European Petroluem Survey Group) to an SRID like this, but we'll
+    stick with it for now until it becomes a problem.
+
+    NOTE(larsbutler): Ideally, we should use URNs instead of this
+    notation, according to the new GeoJSON spec [4]. However, in
+    order to be consistent with [1], we'll stick with this approach
+    for now.
+
+    References:
+
+    [1] - https://github.com/bryanjos/geo/issues/76
+    [2] - http://geojson.org/geojson-spec.html#coordinate-reference-system-objects
+    [3] - https://tools.ietf.org/html/rfc7946#appendix-B.1
+    [4] - https://tools.ietf.org/html/rfc7946#section-4
+    """  # noqa
+    string = iter(string)
+    # endianness = string[0:1]
+    endianness = as_bin_str(take(1, string))
+    if endianness == BIG_ENDIAN:
+        big_endian = True
+    elif endianness == LITTLE_ENDIAN:
+        big_endian = False
+    else:
+        raise ValueError("Invalid endian byte: '0x%s'. Expected 0x00 or 0x01"
+                         % binascii.hexlify(endianness.encode()).decode())
+
+    endian_token = '>' if big_endian else '<'
+    # type_bytes = string[1:5]
+    type_bytes = as_bin_str(take(4, string))
+    if not big_endian:
+        # To identify the type, order the type bytes in big endian:
+        type_bytes = type_bytes[::-1]
+
+    geom_type, type_bytes, has_srid = _get_geom_type(type_bytes)
+    srid = None
+    if has_srid:
+        srid_field = as_bin_str(take(4, string))
+        [srid] = struct.unpack('%si' % endian_token, srid_field)
+
+    # data_bytes = string[5:]  # FIXME: This won't work for GeometryCollections
+    data_bytes = string
+
+    importer = _loads_registry.get(geom_type)
+
+    if importer is None:
+        _unsupported_geom_type(geom_type)
+
+    data_bytes = iter(data_bytes)
+    result = importer(big_endian, type_bytes, data_bytes)
+    if has_srid:
+        # As mentioned in the docstring above, include both approaches to
+        # indicating the SRID.
+        result['meta'] = {'srid': int(srid)}
+        result['crs'] = {
+            'type': 'name',
+            'properties': {'name': 'EPSG%s' % srid},
+        }
+    return result
+
+
+def _unsupported_geom_type(geom_type):
+    raise ValueError("Unsupported geometry type '%s'" % geom_type)
+
+
+# TODO: dont default meta to none
+def _header_bytefmt_byteorder(geom_type, num_dims, big_endian, meta=None):
+    """
+    Utility function to get the WKB header (endian byte + type header), byte
+    format string, and byte order string.
+    """
+    dim = _INT_TO_DIM_LABEL.get(num_dims)
+    if dim is None:
+        pass  # TODO: raise
+
+    type_byte_str = _WKB[dim][geom_type]
+    srid = meta.get('srid')
+    if srid is not None:
+        # Add the srid flag
+        type_byte_str = SRID_FLAG + type_byte_str[1:]
+
+    if big_endian:
+        header = BIG_ENDIAN
+        byte_fmt = b'>'
+        byte_order = '>'
+    else:
+        header = LITTLE_ENDIAN
+        byte_fmt = b'<'
+        byte_order = '<'
+        # reverse the byte ordering for little endian
+        type_byte_str = type_byte_str[::-1]
+
+    header += type_byte_str
+    if srid is not None:
+        srid = int(srid)
+
+        if big_endian:
+            srid_header = struct.pack('>i', srid)
+        else:
+            srid_header = struct.pack('<i', srid)
+        header += srid_header
+    byte_fmt += b'd' * num_dims
+
+    return header, byte_fmt, byte_order
+
+
+def _dump_point(obj, big_endian, meta):
+    """
+    Dump a GeoJSON-like `dict` to a point WKB string.
+
+    :param dict obj:
+        GeoJson-like `dict` object.
+    :param bool big_endian:
+        If `True`, data values in the generated WKB will be represented using
+        big endian byte order. Else, little endian.
+    :param dict meta:
+        Metadata associated with the GeoJSON object. Currently supported
+        metadata:
+
+        - srid: Used to support EWKT/EWKB. For example, ``meta`` equal to
+          ``{'srid': '4326'}`` indicates that the geometry is defined using
+          Extended WKT/WKB and that it bears a Spatial Reference System
+          Identifier of 4326. This ID will be encoded into the resulting
+          binary.
+
+        Any other meta data objects will simply be ignored by this function.
+
+    :returns:
+        A WKB binary string representing of the Point ``obj``.
+    """
+    coords = obj['coordinates']
+    num_dims = len(coords)
+
+    wkb_string, byte_fmt, _ = _header_bytefmt_byteorder(
+        'Point', num_dims, big_endian, meta
+    )
+
+    wkb_string += struct.pack(byte_fmt, *coords)
+    return wkb_string
+
+
+def _dump_linestring(obj, big_endian, meta):
+    """
+    Dump a GeoJSON-like `dict` to a linestring WKB string.
+
+    Input parameters and output are similar to :func:`_dump_point`.
+    """
+    coords = obj['coordinates']
+    vertex = coords[0]
+    # Infer the number of dimensions from the first vertex
+    num_dims = len(vertex)
+
+    wkb_string, byte_fmt, byte_order = _header_bytefmt_byteorder(
+        'LineString', num_dims, big_endian, meta
+    )
+    # append number of vertices in linestring
+    wkb_string += struct.pack('%sl' % byte_order, len(coords))
+
+    for vertex in coords:
+        wkb_string += struct.pack(byte_fmt, *vertex)
+
+    return wkb_string
+
+
+def _dump_polygon(obj, big_endian, meta):
+    """
+    Dump a GeoJSON-like `dict` to a polygon WKB string.
+
+    Input parameters and output are similar to :funct:`_dump_point`.
+    """
+    coords = obj['coordinates']
+    vertex = coords[0][0]
+    # Infer the number of dimensions from the first vertex
+    num_dims = len(vertex)
+
+    wkb_string, byte_fmt, byte_order = _header_bytefmt_byteorder(
+        'Polygon', num_dims, big_endian, meta
+    )
+
+    # number of rings:
+    wkb_string += struct.pack('%sl' % byte_order, len(coords))
+    for ring in coords:
+        # number of verts in this ring:
+        wkb_string += struct.pack('%sl' % byte_order, len(ring))
+        for vertex in ring:
+            wkb_string += struct.pack(byte_fmt, *vertex)
+
+    return wkb_string
+
+
+def _dump_multipoint(obj, big_endian, meta):
+    """
+    Dump a GeoJSON-like `dict` to a multipoint WKB string.
+
+    Input parameters and output are similar to :funct:`_dump_point`.
+    """
+    coords = obj['coordinates']
+    vertex = coords[0]
+    num_dims = len(vertex)
+
+    wkb_string, byte_fmt, byte_order = _header_bytefmt_byteorder(
+        'MultiPoint', num_dims, big_endian, meta
+    )
+
+    point_type = _WKB[_INT_TO_DIM_LABEL.get(num_dims)]['Point']
+    if big_endian:
+        point_type = BIG_ENDIAN + point_type
+    else:
+        point_type = LITTLE_ENDIAN + point_type[::-1]
+
+    wkb_string += struct.pack('%sl' % byte_order, len(coords))
+    for vertex in coords:
+        # POINT type strings
+        wkb_string += point_type
+        wkb_string += struct.pack(byte_fmt, *vertex)
+
+    return wkb_string
+
+
+def _dump_multilinestring(obj, big_endian, meta):
+    """
+    Dump a GeoJSON-like `dict` to a multilinestring WKB string.
+
+    Input parameters and output are similar to :funct:`_dump_point`.
+    """
+    coords = obj['coordinates']
+    vertex = coords[0][0]
+    num_dims = len(vertex)
+
+    wkb_string, byte_fmt, byte_order = _header_bytefmt_byteorder(
+        'MultiLineString', num_dims, big_endian, meta
+    )
+
+    ls_type = _WKB[_INT_TO_DIM_LABEL.get(num_dims)]['LineString']
+    if big_endian:
+        ls_type = BIG_ENDIAN + ls_type
+    else:
+        ls_type = LITTLE_ENDIAN + ls_type[::-1]
+
+    # append the number of linestrings
+    wkb_string += struct.pack('%sl' % byte_order, len(coords))
+
+    for linestring in coords:
+        wkb_string += ls_type
+        # append the number of vertices in each linestring
+        wkb_string += struct.pack('%sl' % byte_order, len(linestring))
+        for vertex in linestring:
+            wkb_string += struct.pack(byte_fmt, *vertex)
+
+    return wkb_string
+
+
+def _dump_multipolygon(obj, big_endian, meta):
+    """
+    Dump a GeoJSON-like `dict` to a multipolygon WKB string.
+
+    Input parameters and output are similar to :funct:`_dump_point`.
+    """
+    coords = obj['coordinates']
+    vertex = coords[0][0][0]
+    num_dims = len(vertex)
+
+    wkb_string, byte_fmt, byte_order = _header_bytefmt_byteorder(
+        'MultiPolygon', num_dims, big_endian, meta
+    )
+
+    poly_type = _WKB[_INT_TO_DIM_LABEL.get(num_dims)]['Polygon']
+    if big_endian:
+        poly_type = BIG_ENDIAN + poly_type
+    else:
+        poly_type = LITTLE_ENDIAN + poly_type[::-1]
+
+    # apped the number of polygons
+    wkb_string += struct.pack('%sl' % byte_order, len(coords))
+
+    for polygon in coords:
+        # append polygon header
+        wkb_string += poly_type
+        # append the number of rings in this polygon
+        wkb_string += struct.pack('%sl' % byte_order, len(polygon))
+        for ring in polygon:
+            # append the number of vertices in this ring
+            wkb_string += struct.pack('%sl' % byte_order, len(ring))
+            for vertex in ring:
+                wkb_string += struct.pack(byte_fmt, *vertex)
+
+    return wkb_string
+
+
+def _dump_geometrycollection(obj, big_endian, meta):
+    # TODO: handle empty collections
+    geoms = obj['geometries']
+    # determine the dimensionality (2d, 3d, 4d) of the collection
+    # by sampling the first geometry
+    first_geom = geoms[0]
+    rest = geoms[1:]
+
+    first_wkb = dumps(first_geom, big_endian=big_endian)
+    first_type = first_wkb[1:5]
+    if not big_endian:
+        first_type = first_type[::-1]
+
+    if first_type in WKB_2D.values():
+        num_dims = 2
+    elif first_type in WKB_Z.values():
+        num_dims = 3
+    elif first_type in WKB_ZM.values():
+        num_dims = 4
+
+    wkb_string, byte_fmt, byte_order = _header_bytefmt_byteorder(
+        'GeometryCollection', num_dims, big_endian, meta
+    )
+    # append the number of geometries
+    wkb_string += struct.pack('%sl' % byte_order, len(geoms))
+
+    wkb_string += first_wkb
+    for geom in rest:
+        wkb_string += dumps(geom, big_endian=big_endian)
+
+    return wkb_string
+
+
+def _load_point(big_endian, type_bytes, data_bytes):
+    """
+    Convert byte data for a Point to a GeoJSON `dict`.
+
+    :param bool big_endian:
+        If `True`, interpret the ``data_bytes`` in big endian order, else
+        little endian.
+    :param str type_bytes:
+        4-byte integer (as a binary string) indicating the geometry type
+        (Point) and the dimensions (2D, Z, M or ZM). For consistency, these
+        bytes are expected to always be in big endian order, regardless of the
+        value of ``big_endian``.
+    :param str data_bytes:
+        Coordinate data in a binary string.
+
+    :returns:
+        GeoJSON `dict` representing the Point geometry.
+    """
+    endian_token = '>' if big_endian else '<'
+
+    if type_bytes == WKB_2D['Point']:
+        coords = struct.unpack('%sdd' % endian_token,
+                               as_bin_str(take(16, data_bytes)))
+    elif type_bytes == WKB_Z['Point']:
+        coords = struct.unpack('%sddd' % endian_token,
+                               as_bin_str(take(24, data_bytes)))
+    elif type_bytes == WKB_M['Point']:
+        # NOTE: The use of XYM types geometries is quite rare. In the interest
+        # of removing ambiguity, we will treat all XYM geometries as XYZM when
+        # generate the GeoJSON. A default Z value of `0.0` will be given in
+        # this case.
+        coords = list(struct.unpack('%sddd' % endian_token,
+                                    as_bin_str(take(24, data_bytes))))
+        coords.insert(2, 0.0)
+    elif type_bytes == WKB_ZM['Point']:
+        coords = struct.unpack('%sdddd' % endian_token,
+                               as_bin_str(take(32, data_bytes)))
+
+    return dict(type='Point', coordinates=list(coords))
+
+
+def _load_linestring(big_endian, type_bytes, data_bytes):
+    endian_token = '>' if big_endian else '<'
+
+    is_m = False
+
+    if type_bytes in WKB_2D.values():
+        num_dims = 2
+    elif type_bytes in WKB_Z.values():
+        num_dims = 3
+    elif type_bytes in WKB_M.values():
+        num_dims = 3
+        is_m = True
+    elif type_bytes in WKB_ZM.values():
+        num_dims = 4
+
+    coords = []
+    [num_verts] = struct.unpack('%sl' % endian_token,
+                                as_bin_str(take(4, data_bytes)))
+
+    while True:
+        vert_wkb = as_bin_str(take(8 * num_dims, data_bytes))
+        fmt = '%s' + 'd' * num_dims
+        vert = list(struct.unpack(fmt % endian_token, vert_wkb))
+        if is_m:
+            vert.insert(2, 0.0)
+
+        coords.append(vert)
+
+        if len(coords) == num_verts:
+            break
+
+    return dict(type='LineString', coordinates=list(coords))
+
+
+def _load_polygon(big_endian, type_bytes, data_bytes):
+    endian_token = '>' if big_endian else '<'
+    data_bytes = iter(data_bytes)
+
+    is_m = False
+
+    if type_bytes in WKB_2D.values():
+        num_dims = 2
+    elif type_bytes in WKB_Z.values():
+        num_dims = 3
+    elif type_bytes in WKB_M.values():
+        num_dims = 3
+        is_m = True
+    elif type_bytes in WKB_ZM.values():
+        num_dims = 4
+
+    coords = []
+    [num_rings] = struct.unpack('%sl' % endian_token,
+                                as_bin_str(take(4, data_bytes)))
+
+    while True:
+        ring = []
+        [num_verts] = struct.unpack('%sl' % endian_token,
+                                    as_bin_str(take(4, data_bytes)))
+
+        verts_wkb = as_bin_str(take(8 * num_verts * num_dims, data_bytes))
+        verts = block_splitter(verts_wkb, 8)
+        if six.PY2:
+            verts = (b''.join(x) for x in verts)
+        elif six.PY3:
+            verts = (b''.join(bytes([y]) for y in x) for x in verts)
+        for vert_wkb in block_splitter(verts, num_dims):
+            values = [struct.unpack('%sd' % endian_token, x)[0]
+                      for x in vert_wkb]
+            if is_m:
+                values.insert(2, 0.0)
+            ring.append(values)
+        coords.append(ring)
+        if len(coords) == num_rings:
+            break
+
+    return dict(type='Polygon', coordinates=coords)
+
+
+def _load_multipoint(big_endian, type_bytes, data_bytes):
+    endian_token = '>' if big_endian else '<'
+    data_bytes = iter(data_bytes)
+
+    is_m = False
+
+    if type_bytes in WKB_2D.values():
+        num_dims = 2
+    elif type_bytes in WKB_Z.values():
+        num_dims = 3
+    elif type_bytes in WKB_M.values():
+        num_dims = 3
+        is_m = True
+    elif type_bytes in WKB_ZM.values():
+        num_dims = 4
+
+    if is_m:
+        dim = 'M'
+    else:
+        dim = _INT_TO_DIM_LABEL[num_dims]
+
+    coords = []
+    [num_points] = struct.unpack('%sl' % endian_token,
+                                 as_bin_str(take(4, data_bytes)))
+
+    while True:
+        point_endian = as_bin_str(take(1, data_bytes))
+        point_type = as_bin_str(take(4, data_bytes))
+        values = struct.unpack('%s%s' % (endian_token, 'd' * num_dims),
+                               as_bin_str(take(8 * num_dims, data_bytes)))
+        values = list(values)
+        if is_m:
+            values.insert(2, 0.0)
+
+        if big_endian:
+            assert point_endian == BIG_ENDIAN
+            assert point_type == _WKB[dim]['Point']
+        else:
+            assert point_endian == LITTLE_ENDIAN
+            assert point_type[::-1] == _WKB[dim]['Point']
+
+        coords.append(list(values))
+        if len(coords) == num_points:
+            break
+
+    return dict(type='MultiPoint', coordinates=coords)
+
+
+def _load_multilinestring(big_endian, type_bytes, data_bytes):
+    endian_token = '>' if big_endian else '<'
+    data_bytes = iter(data_bytes)
+
+    is_m = False
+
+    if type_bytes in WKB_2D.values():
+        num_dims = 2
+    elif type_bytes in WKB_Z.values():
+        num_dims = 3
+    elif type_bytes in WKB_M.values():
+        num_dims = 3
+        is_m = True
+    elif type_bytes in WKB_ZM.values():
+        num_dims = 4
+
+    if is_m:
+        dim = 'M'
+    else:
+        dim = _INT_TO_DIM_LABEL[num_dims]
+
+    [num_ls] = struct.unpack('%sl' % endian_token,
+                             as_bin_str(take(4, data_bytes)))
+    coords = []
+
+    while True:
+        ls_endian = as_bin_str(take(1, data_bytes))
+        ls_type = as_bin_str(take(4, data_bytes))
+        if big_endian:
+            assert ls_endian == BIG_ENDIAN
+            assert ls_type == _WKB[dim]['LineString']
+        else:
+            assert ls_endian == LITTLE_ENDIAN
+            assert ls_type[::-1] == _WKB[dim]['LineString']
+
+        [num_verts] = struct.unpack('%sl' % endian_token,
+                                    as_bin_str(take(4, data_bytes)))
+        num_values = num_dims * num_verts
+        values = struct.unpack(endian_token + 'd' * num_values,
+                               as_bin_str(take(8 * num_values, data_bytes)))
+
+        values = list(block_splitter(values, num_dims))
+        if is_m:
+            for v in values:
+                v.insert(2, 0.0)
+        coords.append(values)
+        if len(coords) == num_ls:
+            break
+
+    return dict(type='MultiLineString', coordinates=coords)
+
+
+def _load_multipolygon(big_endian, type_bytes, data_bytes):
+    endian_token = '>' if big_endian else '<'
+
+    is_m = False
+
+    if type_bytes in WKB_2D.values():
+        num_dims = 2
+    elif type_bytes in WKB_Z.values():
+        num_dims = 3
+    elif type_bytes in WKB_M.values():
+        num_dims = 3
+        is_m = True
+    elif type_bytes in WKB_ZM.values():
+        num_dims = 4
+
+    if is_m:
+        dim = 'M'
+    else:
+        dim = _INT_TO_DIM_LABEL[num_dims]
+
+    [num_polys] = struct.unpack('%sl' % endian_token,
+                                as_bin_str(take(4, data_bytes)))
+    coords = []
+    while True:
+        polygon = []
+        poly_endian = as_bin_str(take(1, data_bytes))
+        poly_type = as_bin_str(take(4, data_bytes))
+        if big_endian:
+            assert poly_endian == BIG_ENDIAN
+            assert poly_type == _WKB[dim]['Polygon']
+        else:
+            assert poly_endian == LITTLE_ENDIAN
+            assert poly_type[::-1] == _WKB[dim]['Polygon']
+
+        [num_rings] = struct.unpack('%sl' % endian_token,
+                                    as_bin_str(take(4, data_bytes)))
+        for _ in range(num_rings):
+            ring = []
+            [num_verts] = struct.unpack('%sl' % endian_token,
+                                        as_bin_str(take(4, data_bytes)))
+            for _ in range(num_verts):
+                vert_wkb = as_bin_str(take(8 * num_dims, data_bytes))
+                fmt = '%s' + 'd' * num_dims
+                vert = list(struct.unpack(fmt % endian_token, vert_wkb))
+                if is_m:
+                    vert.insert(2, 0.0)
+                ring.append(vert)
+
+            polygon.append(ring)
+
+        coords.append(polygon)
+
+        if len(coords) == num_polys:
+            break
+
+    return dict(type='MultiPolygon', coordinates=coords)
+
+
+def _check_dimensionality(geom, num_dims):
+    def first_geom(gc):
+        for g in gc['geometries']:
+            if not g['type'] == 'GeometryCollection':
+                return g
+
+    first_vert = {
+        'Point': lambda x: x['coordinates'],
+        'LineString': lambda x: x['coordinates'][0],
+        'Polygon': lambda x: x['coordinates'][0][0],
+        'MultiLineString': lambda x: x['coordinates'][0][0],
+        'MultiPolygon': lambda x: x['coordinates'][0][0][0],
+        'GeometryCollection': first_geom,
+    }
+    if not len(first_vert[geom['type']](geom)) == num_dims:
+        error = 'Cannot mix dimensionality in a geometry'
+        raise Exception(error)
+
+
+def _load_geometrycollection(big_endian, type_bytes, data_bytes):
+    endian_token = '>' if big_endian else '<'
+
+    is_m = False
+
+    if type_bytes in WKB_2D.values():
+        num_dims = 2
+    elif type_bytes in WKB_Z.values():
+        num_dims = 3
+    elif type_bytes in WKB_M.values():
+        num_dims = 3
+        is_m = True
+    elif type_bytes in WKB_ZM.values():
+        num_dims = 4
+
+    geometries = []
+    [num_geoms] = struct.unpack('%sl' % endian_token,
+                                as_bin_str(take(4, data_bytes)))
+    while True:
+        geometry = loads(data_bytes)
+        if is_m:
+            _check_dimensionality(geometry, 4)
+        else:
+            _check_dimensionality(geometry, num_dims)
+        # TODO(LB): Add type assertions for the geometry; collections should
+        # not mix 2d, 3d, 4d, etc.
+        geometries.append(geometry)
+        if len(geometries) == num_geoms:
+            break
+
+    return dict(type='GeometryCollection', geometries=geometries)
+
+
+_dumps_registry = {
+    'Point':  _dump_point,
+    'LineString': _dump_linestring,
+    'Polygon': _dump_polygon,
+    'MultiPoint': _dump_multipoint,
+    'MultiLineString': _dump_multilinestring,
+    'MultiPolygon': _dump_multipolygon,
+    'GeometryCollection': _dump_geometrycollection,
+}
+
+
+_loads_registry = {
+    'Point': _load_point,
+    'LineString': _load_linestring,
+    'Polygon': _load_polygon,
+    'MultiPoint': _load_multipoint,
+    'MultiLineString': _load_multilinestring,
+    'MultiPolygon': _load_multipolygon,
+    'GeometryCollection': _load_geometrycollection,
+}
diff --git a/llm/Lib/site-packages/geomet/wkt.py b/llm/Lib/site-packages/geomet/wkt.py
new file mode 100644
index 0000000000000000000000000000000000000000..f3f9eb96b9e53ecc23941e1bb70ae3d919cf6ed9
--- /dev/null
+++ b/llm/Lib/site-packages/geomet/wkt.py
@@ -0,0 +1,612 @@
+#  Copyright 2013 Lars Butler & individual contributors
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+import geomet
+import itertools
+import six
+import tokenize
+
+try:
+    import StringIO
+except ImportError:
+    import io
+    StringIO = io
+
+from geomet import util
+
+
+INVALID_WKT_FMT = 'Invalid WKT: `%s`'
+
+
+def dump(obj, dest_file):
+    """
+    Dump GeoJSON-like `dict` to WKT and write it to the `dest_file`.
+
+    :param dict obj:
+        A GeoJSON-like dictionary. It must at least the keys 'type' and
+        'coordinates'.
+    :param dest_file:
+        Open and writable file-like object.
+    """
+    dest_file.write(dumps(obj))
+
+
+def load(source_file):
+    """
+    Load a GeoJSON `dict` object from a ``source_file`` containing WKT.
+
+    :param source_file:
+        Open and readable file-like object.
+
+    :returns:
+        A GeoJSON `dict` representing the geometry read from the file.
+    """
+    return loads(source_file.read())
+
+
+def dumps(obj, decimals=16):
+    """
+    Dump a GeoJSON-like `dict` to a WKT string.
+    """
+    try:
+        geom_type = obj['type']
+        exporter = _dumps_registry.get(geom_type)
+
+        if exporter is None:
+            _unsupported_geom_type(geom_type)
+
+        # Check for empty cases
+        if geom_type == 'GeometryCollection':
+            if len(obj['geometries']) == 0:
+                return 'GEOMETRYCOLLECTION EMPTY'
+        else:
+            # Geom has no coordinate values at all, and must be empty.
+            if len(list(util.flatten_multi_dim(obj['coordinates']))) == 0:
+                return '%s EMPTY' % geom_type.upper()
+    except KeyError:
+        raise geomet.InvalidGeoJSONException('Invalid GeoJSON: %s' % obj)
+
+    result = exporter(obj, decimals)
+    # Try to get the SRID from `meta.srid`
+    meta_srid = obj.get('meta', {}).get('srid')
+    # Also try to get it from `crs.properties.name`:
+    crs_srid = obj.get('crs', {}).get('properties', {}).get('name')
+    if crs_srid is not None:
+        # Shave off the EPSG prefix to give us the SRID:
+        crs_srid = crs_srid.replace('EPSG', '')
+
+    if (meta_srid is not None and
+            crs_srid is not None and
+            str(meta_srid) != str(crs_srid)):
+        raise ValueError(
+            'Ambiguous CRS/SRID values: %s and %s' % (meta_srid, crs_srid)
+        )
+    srid = meta_srid or crs_srid
+
+    # TODO: add tests for CRS input
+    if srid is not None:
+        # Prepend the SRID
+        result = 'SRID=%s;%s' % (srid, result)
+    return result
+
+
+def _assert_next_token(sequence, expected):
+    next_token = next(sequence)
+    if not next_token == expected:
+        raise ValueError(
+            'Expected "%s" but found "%s"' % (expected, next_token)
+        )
+
+
+def loads(string):
+    """
+    Construct a GeoJSON `dict` from WKT (`string`).
+    """
+    sio = StringIO.StringIO(string)
+    # NOTE: This is not the intended purpose of `tokenize`, but it works.
+    tokens = (x[1] for x in tokenize.generate_tokens(sio.readline))
+    tokens = _tokenize_wkt(tokens)
+    geom_type_or_srid = next(tokens)
+    srid = None
+    geom_type = geom_type_or_srid
+    if geom_type_or_srid == 'SRID':
+        # The geometry WKT contains an SRID header.
+        _assert_next_token(tokens, '=')
+        srid = int(next(tokens))
+        _assert_next_token(tokens, ';')
+        # We expected the geometry type to be next:
+        geom_type = next(tokens)
+    else:
+        geom_type = geom_type_or_srid
+
+    importer = _loads_registry.get(geom_type)
+
+    if importer is None:
+        _unsupported_geom_type(geom_type)
+
+    peek = six.advance_iterator(tokens)
+    if peek == 'EMPTY':
+        if geom_type == 'GEOMETRYCOLLECTION':
+            return dict(type='GeometryCollection', geometries=[])
+        else:
+            return dict(type=_type_map_caps_to_mixed[geom_type],
+                        coordinates=[])
+
+    # Put the peeked element back on the head of the token generator
+    tokens = itertools.chain([peek], tokens)
+    result = importer(tokens, string)
+    if srid is not None:
+        result['meta'] = dict(srid=srid)
+    return result
+
+
+def _tokenize_wkt(tokens):
+    """
+    Since the tokenizer treats "-" and numeric strings as separate values,
+    combine them and yield them as a single token. This utility encapsulates
+    parsing of negative numeric values from WKT can be used generically in all
+    parsers.
+    """
+    negative = False
+    for t in tokens:
+        if t == '-':
+            negative = True
+            continue
+        else:
+            if negative:
+                yield '-%s' % t
+            else:
+                yield t
+            negative = False
+
+
+def _unsupported_geom_type(geom_type):
+    raise ValueError("Unsupported geometry type '%s'" % geom_type)
+
+
+def _round_and_pad(value, decimals):
+    """
+    Round the input value to `decimals` places, and pad with 0's
+    if the resulting value is less than `decimals`.
+
+    :param value:
+        The value to round
+    :param decimals:
+        Number of decimals places which should be displayed after the rounding.
+    :return:
+        str of the rounded value
+    """
+    if isinstance(value, int) and decimals != 0:
+        # if we get an int coordinate and we have a non-zero value for
+        # `decimals`, we want to create a float to pad out.
+        value = float(value)
+
+    elif decimals == 0:
+        # if get a `decimals` value of 0, we want to return an int.
+        return repr(int(round(value, decimals)))
+
+    rounded = repr(round(value, decimals))
+    rounded += '0' * (decimals - len(rounded.split('.')[1]))
+    return rounded
+
+
+def _dump_point(obj, decimals):
+    """
+    Dump a GeoJSON-like Point object to WKT.
+
+    :param dict obj:
+        A GeoJSON-like `dict` representing a Point.
+    :param int decimals:
+        int which indicates the number of digits to display after the
+        decimal point when formatting coordinates.
+
+    :returns:
+        WKT representation of the input GeoJSON Point ``obj``.
+    """
+    coords = obj['coordinates']
+    pt = 'POINT (%s)' % ' '.join(_round_and_pad(c, decimals)
+                                 for c in coords)
+    return pt
+
+
+def _dump_linestring(obj, decimals):
+    """
+    Dump a GeoJSON-like LineString object to WKT.
+
+    Input parameters and return value are the LINESTRING equivalent to
+    :func:`_dump_point`.
+    """
+    coords = obj['coordinates']
+    ls = 'LINESTRING (%s)'
+    ls %= ', '.join(' '.join(_round_and_pad(c, decimals)
+                             for c in pt) for pt in coords)
+    return ls
+
+
+def _dump_polygon(obj, decimals):
+    """
+    Dump a GeoJSON-like Polygon object to WKT.
+
+    Input parameters and return value are the POLYGON equivalent to
+    :func:`_dump_point`.
+    """
+    coords = obj['coordinates']
+    poly = 'POLYGON (%s)'
+    rings = (', '.join(' '.join(_round_and_pad(c, decimals)
+                                for c in pt) for pt in ring)
+             for ring in coords)
+    rings = ('(%s)' % r for r in rings)
+    poly %= ', '.join(rings)
+    return poly
+
+
+def _dump_multipoint(obj, decimals):
+    """
+    Dump a GeoJSON-like MultiPoint object to WKT.
+
+    Input parameters and return value are the MULTIPOINT equivalent to
+    :func:`_dump_point`.
+    """
+    coords = obj['coordinates']
+    mp = 'MULTIPOINT (%s)'
+    points = (' '.join(_round_and_pad(c, decimals)
+                       for c in pt) for pt in coords)
+    # Add parens around each point.
+    points = ('(%s)' % pt for pt in points)
+    mp %= ', '.join(points)
+    return mp
+
+
+def _dump_multilinestring(obj, decimals):
+    """
+    Dump a GeoJSON-like MultiLineString object to WKT.
+
+    Input parameters and return value are the MULTILINESTRING equivalent to
+    :func:`_dump_point`.
+    """
+    coords = obj['coordinates']
+    mlls = 'MULTILINESTRING (%s)'
+    linestrs = ('(%s)' % ', '.join(' '.join(_round_and_pad(c, decimals)
+                for c in pt) for pt in linestr) for linestr in coords)
+    mlls %= ', '.join(ls for ls in linestrs)
+    return mlls
+
+
+def _dump_multipolygon(obj, decimals):
+    """
+    Dump a GeoJSON-like MultiPolygon object to WKT.
+
+    Input parameters and return value are the MULTIPOLYGON equivalent to
+    :func:`_dump_point`.
+    """
+    coords = obj['coordinates']
+    mp = 'MULTIPOLYGON (%s)'
+
+    polys = (
+        # join the polygons in the multipolygon
+        ', '.join(
+            # join the rings in a polygon,
+            # and wrap in parens
+            '(%s)' % ', '.join(
+                # join the points in a ring,
+                # and wrap in parens
+                '(%s)' % ', '.join(
+                    # join coordinate values of a vertex
+                    ' '.join(_round_and_pad(c, decimals) for c in pt)
+                    for pt in ring)
+                for ring in poly)
+            for poly in coords)
+    )
+    mp %= polys
+    return mp
+
+
+def _dump_geometrycollection(obj, decimals):
+    """
+    Dump a GeoJSON-like GeometryCollection object to WKT.
+
+    Input parameters and return value are the GEOMETRYCOLLECTION equivalent to
+    :func:`_dump_point`.
+
+    The WKT conversions for each geometry in the collection are delegated to
+    their respective functions.
+    """
+    gc = 'GEOMETRYCOLLECTION (%s)'
+    geoms = obj['geometries']
+    geoms_wkt = []
+    for geom in geoms:
+        geom_type = geom['type']
+        geoms_wkt.append(_dumps_registry.get(geom_type)(geom, decimals))
+    gc %= ','.join(geoms_wkt)
+    return gc
+
+
+def _load_point(tokens, string):
+    """
+    :param tokens:
+        A generator of string tokens for the input WKT, begining just after the
+        geometry type. The geometry type is consumed before we get to here. For
+        example, if :func:`loads` is called with the input 'POINT(0.0 1.0)',
+        ``tokens`` would generate the following values:
+
+        .. code-block:: python
+            ['(', '0.0', '1.0', ')']
+    :param str string:
+        The original WKT string.
+
+    :returns:
+        A GeoJSON `dict` Point representation of the WKT ``string``.
+    """
+    if not next(tokens) == '(':
+        raise ValueError(INVALID_WKT_FMT % string)
+
+    coords = []
+    try:
+        for t in tokens:
+            if t == ')':
+                break
+            else:
+                coords.append(float(t))
+    except tokenize.TokenError:
+        raise ValueError(INVALID_WKT_FMT % string)
+
+    return dict(type='Point', coordinates=coords)
+
+
+def _load_linestring(tokens, string):
+    """
+    Has similar inputs and return value to to :func:`_load_point`, except is
+    for handling LINESTRING geometry.
+
+    :returns:
+        A GeoJSON `dict` LineString representation of the WKT ``string``.
+    """
+    if not next(tokens) == '(':
+        raise ValueError(INVALID_WKT_FMT % string)
+
+    # a list of lists
+    # each member list represents a point
+    coords = []
+    try:
+        pt = []
+        for t in tokens:
+            if t == ')':
+                coords.append(pt)
+                break
+            elif t == ',':
+                # it's the end of the point
+                coords.append(pt)
+                pt = []
+            else:
+                pt.append(float(t))
+    except tokenize.TokenError:
+        raise ValueError(INVALID_WKT_FMT % string)
+
+    return dict(type='LineString', coordinates=coords)
+
+
+def _load_polygon(tokens, string):
+    """
+    Has similar inputs and return value to to :func:`_load_point`, except is
+    for handling POLYGON geometry.
+
+    :returns:
+        A GeoJSON `dict` Polygon representation of the WKT ``string``.
+    """
+    open_parens = next(tokens), next(tokens)
+    if not open_parens == ('(', '('):
+        raise ValueError(INVALID_WKT_FMT % string)
+
+    # coords contains a list of rings
+    # each ring contains a list of points
+    # each point is a list of 2-4 values
+    coords = []
+
+    ring = []
+    on_ring = True
+    try:
+        pt = []
+        for t in tokens:
+            if t == ')' and on_ring:
+                # The ring is finished
+                ring.append(pt)
+                coords.append(ring)
+                on_ring = False
+            elif t == ')' and not on_ring:
+                # it's the end of the polygon
+                break
+            elif t == '(':
+                # it's a new ring
+                ring = []
+                pt = []
+                on_ring = True
+            elif t == ',' and on_ring:
+                # it's the end of a point
+                ring.append(pt)
+                pt = []
+            elif t == ',' and not on_ring:
+                # there's another ring.
+                # do nothing
+                pass
+            else:
+                pt.append(float(t))
+    except tokenize.TokenError:
+        raise ValueError(INVALID_WKT_FMT % string)
+
+    return dict(type='Polygon', coordinates=coords)
+
+
+def _load_multipoint(tokens, string):
+    """
+    Has similar inputs and return value to to :func:`_load_point`, except is
+    for handling MULTIPOINT geometry.
+
+    :returns:
+        A GeoJSON `dict` MultiPoint representation of the WKT ``string``.
+    """
+    open_paren = next(tokens)
+    if not open_paren == '(':
+        raise ValueError(INVALID_WKT_FMT % string)
+
+    coords = []
+    pt = []
+
+    paren_depth = 1
+    try:
+        for t in tokens:
+            if t == '(':
+                paren_depth += 1
+            elif t == ')':
+                paren_depth -= 1
+                if paren_depth == 0:
+                    break
+            elif t == '':
+                pass
+            elif t == ',':
+                # the point is done
+                coords.append(pt)
+                pt = []
+            else:
+                pt.append(float(t))
+    except tokenize.TokenError:
+        raise ValueError(INVALID_WKT_FMT % string)
+
+    # Given the way we're parsing, we'll probably have to deal with the last
+    # point after the loop
+    if len(pt) > 0:
+        coords.append(pt)
+
+    return dict(type='MultiPoint', coordinates=coords)
+
+
+def _load_multipolygon(tokens, string):
+    """
+    Has similar inputs and return value to to :func:`_load_point`, except is
+    for handling MULTIPOLYGON geometry.
+
+    :returns:
+        A GeoJSON `dict` MultiPolygon representation of the WKT ``string``.
+    """
+    open_paren = next(tokens)
+    if not open_paren == '(':
+        raise ValueError(INVALID_WKT_FMT % string)
+
+    polygons = []
+    while True:
+        try:
+            poly = _load_polygon(tokens, string)
+            polygons.append(poly['coordinates'])
+            t = next(tokens)
+            if t == ')':
+                # we're done; no more polygons.
+                break
+        except StopIteration:
+            # If we reach this, the WKT is not valid.
+            raise ValueError(INVALID_WKT_FMT % string)
+
+    return dict(type='MultiPolygon', coordinates=polygons)
+
+
+def _load_multilinestring(tokens, string):
+    """
+    Has similar inputs and return value to to :func:`_load_point`, except is
+    for handling MULTILINESTRING geometry.
+
+    :returns:
+        A GeoJSON `dict` MultiLineString representation of the WKT ``string``.
+    """
+    open_paren = next(tokens)
+    if not open_paren == '(':
+        raise ValueError(INVALID_WKT_FMT % string)
+
+    linestrs = []
+    while True:
+        try:
+            linestr = _load_linestring(tokens, string)
+            linestrs.append(linestr['coordinates'])
+            t = next(tokens)
+            if t == ')':
+                # we're done; no more linestrings.
+                break
+        except StopIteration:
+            # If we reach this, the WKT is not valid.
+            raise ValueError(INVALID_WKT_FMT % string)
+
+    return dict(type='MultiLineString', coordinates=linestrs)
+
+
+def _load_geometrycollection(tokens, string):
+    """
+    Has similar inputs and return value to to :func:`_load_point`, except is
+    for handling GEOMETRYCOLLECTIONs.
+
+    Delegates parsing to the parsers for the individual geometry types.
+
+    :returns:
+        A GeoJSON `dict` GeometryCollection representation of the WKT
+        ``string``.
+    """
+    open_paren = next(tokens)
+    if not open_paren == '(':
+        raise ValueError(INVALID_WKT_FMT % string)
+
+    geoms = []
+    result = dict(type='GeometryCollection', geometries=geoms)
+    while True:
+        try:
+            t = next(tokens)
+            if t == ')':
+                break
+            elif t == ',':
+                # another geometry still
+                continue
+            else:
+                geom_type = t
+                load_func = _loads_registry.get(geom_type)
+                geom = load_func(tokens, string)
+                geoms.append(geom)
+        except StopIteration:
+            raise ValueError(INVALID_WKT_FMT % string)
+    return result
+
+
+_dumps_registry = {
+    'Point':  _dump_point,
+    'LineString': _dump_linestring,
+    'Polygon': _dump_polygon,
+    'MultiPoint': _dump_multipoint,
+    'MultiLineString': _dump_multilinestring,
+    'MultiPolygon': _dump_multipolygon,
+    'GeometryCollection': _dump_geometrycollection,
+}
+
+
+_loads_registry = {
+    'POINT': _load_point,
+    'LINESTRING': _load_linestring,
+    'POLYGON': _load_polygon,
+    'MULTIPOINT': _load_multipoint,
+    'MULTILINESTRING': _load_multilinestring,
+    'MULTIPOLYGON': _load_multipolygon,
+    'GEOMETRYCOLLECTION': _load_geometrycollection,
+}
+
+_type_map_caps_to_mixed = dict(
+    POINT='Point',
+    LINESTRING='LineString',
+    POLYGON='Polygon',
+    MULTIPOINT='MultiPoint',
+    MULTILINESTRING='MultiLineString',
+    MULTIPOLYGON='MultiPolygon',
+    GEOMETRYCOLLECTION='GeometryCollection',
+)
diff --git a/llm/Lib/site-packages/git/__init__.py b/llm/Lib/site-packages/git/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5a5b4cbecb01587e37f672ff2f255f07352ccfe0
--- /dev/null
+++ b/llm/Lib/site-packages/git/__init__.py
@@ -0,0 +1,300 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+# @PydevCodeAnalysisIgnore
+
+__all__ = [
+    "Actor",
+    "AmbiguousObjectName",
+    "BadName",
+    "BadObject",
+    "BadObjectType",
+    "BaseIndexEntry",
+    "Blob",
+    "BlobFilter",
+    "BlockingLockFile",
+    "CacheError",
+    "CheckoutError",
+    "CommandError",
+    "Commit",
+    "Diff",
+    "DiffConstants",
+    "DiffIndex",
+    "Diffable",
+    "FetchInfo",
+    "Git",
+    "GitCmdObjectDB",
+    "GitCommandError",
+    "GitCommandNotFound",
+    "GitConfigParser",
+    "GitDB",
+    "GitError",
+    "HEAD",
+    "Head",
+    "HookExecutionError",
+    "INDEX",
+    "IndexEntry",
+    "IndexFile",
+    "IndexObject",
+    "InvalidDBRoot",
+    "InvalidGitRepositoryError",
+    "List",  # Deprecated - import this from `typing` instead.
+    "LockFile",
+    "NULL_TREE",
+    "NoSuchPathError",
+    "ODBError",
+    "Object",
+    "Optional",  # Deprecated - import this from `typing` instead.
+    "ParseError",
+    "PathLike",
+    "PushInfo",
+    "RefLog",
+    "RefLogEntry",
+    "Reference",
+    "Remote",
+    "RemoteProgress",
+    "RemoteReference",
+    "Repo",
+    "RepositoryDirtyError",
+    "RootModule",
+    "RootUpdateProgress",
+    "Sequence",  # Deprecated - import from `typing`, or `collections.abc` in 3.9+.
+    "StageType",
+    "Stats",
+    "Submodule",
+    "SymbolicReference",
+    "TYPE_CHECKING",  # Deprecated - import this from `typing` instead.
+    "Tag",
+    "TagObject",
+    "TagReference",
+    "Tree",
+    "TreeModifier",
+    "Tuple",  # Deprecated - import this from `typing` instead.
+    "Union",  # Deprecated - import this from `typing` instead.
+    "UnmergedEntriesError",
+    "UnsafeOptionError",
+    "UnsafeProtocolError",
+    "UnsupportedOperation",
+    "UpdateProgress",
+    "WorkTreeRepositoryUnsupported",
+    "refresh",
+    "remove_password_if_present",
+    "rmtree",
+    "safe_decode",
+    "to_hex_sha",
+]
+
+__version__ = '3.1.43'
+
+from typing import Any, List, Optional, Sequence, TYPE_CHECKING, Tuple, Union
+
+if TYPE_CHECKING:
+    from types import ModuleType
+
+import warnings
+
+from gitdb.util import to_hex_sha
+
+from git.exc import (
+    AmbiguousObjectName,
+    BadName,
+    BadObject,
+    BadObjectType,
+    CacheError,
+    CheckoutError,
+    CommandError,
+    GitCommandError,
+    GitCommandNotFound,
+    GitError,
+    HookExecutionError,
+    InvalidDBRoot,
+    InvalidGitRepositoryError,
+    NoSuchPathError,
+    ODBError,
+    ParseError,
+    RepositoryDirtyError,
+    UnmergedEntriesError,
+    UnsafeOptionError,
+    UnsafeProtocolError,
+    UnsupportedOperation,
+    WorkTreeRepositoryUnsupported,
+)
+from git.types import PathLike
+
+try:
+    from git.compat import safe_decode  # @NoMove
+    from git.config import GitConfigParser  # @NoMove
+    from git.objects import (  # @NoMove
+        Blob,
+        Commit,
+        IndexObject,
+        Object,
+        RootModule,
+        RootUpdateProgress,
+        Submodule,
+        TagObject,
+        Tree,
+        TreeModifier,
+        UpdateProgress,
+    )
+    from git.refs import (  # @NoMove
+        HEAD,
+        Head,
+        RefLog,
+        RefLogEntry,
+        Reference,
+        RemoteReference,
+        SymbolicReference,
+        Tag,
+        TagReference,
+    )
+    from git.diff import (  # @NoMove
+        INDEX,
+        NULL_TREE,
+        Diff,
+        DiffConstants,
+        DiffIndex,
+        Diffable,
+    )
+    from git.db import GitCmdObjectDB, GitDB  # @NoMove
+    from git.cmd import Git  # @NoMove
+    from git.repo import Repo  # @NoMove
+    from git.remote import FetchInfo, PushInfo, Remote, RemoteProgress  # @NoMove
+    from git.index import (  # @NoMove
+        BaseIndexEntry,
+        BlobFilter,
+        CheckoutError,
+        IndexEntry,
+        IndexFile,
+        StageType,
+        # NOTE: This tells type checkers what util resolves to. We delete it, and it is
+        # really resolved by __getattr__, which warns. See below on what to use instead.
+        util,
+    )
+    from git.util import (  # @NoMove
+        Actor,
+        BlockingLockFile,
+        LockFile,
+        Stats,
+        remove_password_if_present,
+        rmtree,
+    )
+except GitError as _exc:
+    raise ImportError("%s: %s" % (_exc.__class__.__name__, _exc)) from _exc
+
+
+def _warned_import(message: str, fullname: str) -> "ModuleType":
+    import importlib
+
+    warnings.warn(message, DeprecationWarning, stacklevel=3)
+    return importlib.import_module(fullname)
+
+
+def _getattr(name: str) -> Any:
+    # TODO: If __version__ is made dynamic and lazily fetched, put that case right here.
+
+    if name == "util":
+        return _warned_import(
+            "The expression `git.util` and the import `from git import util` actually "
+            "reference git.index.util, and not the git.util module accessed in "
+            '`from git.util import XYZ` or `sys.modules["git.util"]`. This potentially '
+            "confusing behavior is currently preserved for compatibility, but may be "
+            "changed in the future and should not be relied on.",
+            fullname="git.index.util",
+        )
+
+    for names, prefix in (
+        ({"head", "log", "reference", "symbolic", "tag"}, "git.refs"),
+        ({"base", "fun", "typ"}, "git.index"),
+    ):
+        if name not in names:
+            continue
+
+        fullname = f"{prefix}.{name}"
+
+        return _warned_import(
+            f"{__name__}.{name} is a private alias of {fullname} and subject to "
+            f"immediate removal. Use {fullname} instead.",
+            fullname=fullname,
+        )
+
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+if not TYPE_CHECKING:
+    # NOTE: The expression `git.util` gives git.index.util and `from git import util`
+    # imports git.index.util, NOT git.util. It may not be feasible to change this until
+    # the next major version, to avoid breaking code inadvertently relying on it.
+    #
+    # - If git.index.util *is* what you want, use (or import from) that, to avoid
+    #   confusion.
+    #
+    # - To use the "real" git.util module, write `from git.util import ...`, or if
+    #   necessary access it as `sys.modules["git.util"]`.
+    #
+    # Note also that `import git.util` technically imports the "real" git.util... but
+    # the *expression* `git.util` after doing so is still git.index.util!
+    #
+    # (This situation differs from that of other indirect-submodule imports that are
+    # unambiguously non-public and subject to immediate removal. Here, the public
+    # git.util module, though different, makes less discoverable that the expression
+    # `git.util` refers to a non-public attribute of the git module.)
+    #
+    # This had originally come about by a wildcard import. Now that all intended imports
+    # are explicit, the intuitive but potentially incompatible binding occurs due to the
+    # usual rules for Python submodule bindings. So for now we replace that binding with
+    # git.index.util, delete that, and let __getattr__ handle it and issue a warning.
+    #
+    # For the same runtime behavior, it would be enough to forgo importing util, and
+    # delete util as created naturally; __getattr__ would behave the same. But type
+    # checkers would not know what util refers to when accessed as an attribute of git.
+    del util
+
+    # This is "hidden" to preserve static checking for undefined/misspelled attributes.
+    __getattr__ = _getattr
+
+# { Initialize git executable path
+
+GIT_OK = None
+
+
+def refresh(path: Optional[PathLike] = None) -> None:
+    """Convenience method for setting the git executable path.
+
+    :param path:
+        Optional path to the Git executable. If not absolute, it is resolved
+        immediately, relative to the current directory.
+
+    :note:
+        The `path` parameter is usually omitted and cannot be used to specify a custom
+        command whose location is looked up in a path search on each call. See
+        :meth:`Git.refresh <git.cmd.Git.refresh>` for details on how to achieve this.
+
+    :note:
+        This calls :meth:`Git.refresh <git.cmd.Git.refresh>` and sets other global
+        configuration according to the effect of doing so. As such, this function should
+        usually be used instead of using :meth:`Git.refresh <git.cmd.Git.refresh>` or
+        :meth:`FetchInfo.refresh <git.remote.FetchInfo.refresh>` directly.
+
+    :note:
+        This function is called automatically, with no arguments, at import time.
+    """
+    global GIT_OK
+    GIT_OK = False
+
+    if not Git.refresh(path=path):
+        return
+    if not FetchInfo.refresh():  # noqa: F405
+        return  # type: ignore[unreachable]
+
+    GIT_OK = True
+
+
+try:
+    refresh()
+except Exception as _exc:
+    raise ImportError("Failed to initialize: {0}".format(_exc)) from _exc
+
+# } END initialize git executable path
diff --git a/llm/Lib/site-packages/git/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/git/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..333429f2fe22ed0e51b7e437c448321b1612b0fe
Binary files /dev/null and b/llm/Lib/site-packages/git/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/__pycache__/cmd.cpython-311.pyc b/llm/Lib/site-packages/git/__pycache__/cmd.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4e034fa751d4157dce6963ac29bcf53408283818
Binary files /dev/null and b/llm/Lib/site-packages/git/__pycache__/cmd.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/__pycache__/compat.cpython-311.pyc b/llm/Lib/site-packages/git/__pycache__/compat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..84396ad2ed2901882042d83f8f75a07b71cc5c63
Binary files /dev/null and b/llm/Lib/site-packages/git/__pycache__/compat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/__pycache__/config.cpython-311.pyc b/llm/Lib/site-packages/git/__pycache__/config.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..631960a023db6bf1519b36d6960ca474912826ce
Binary files /dev/null and b/llm/Lib/site-packages/git/__pycache__/config.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/__pycache__/db.cpython-311.pyc b/llm/Lib/site-packages/git/__pycache__/db.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a87708177a8652755c5e8cc93aaf6f5c08557d0d
Binary files /dev/null and b/llm/Lib/site-packages/git/__pycache__/db.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/__pycache__/diff.cpython-311.pyc b/llm/Lib/site-packages/git/__pycache__/diff.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..19a92ab9b095b2617c9db8488f6084211ec73915
Binary files /dev/null and b/llm/Lib/site-packages/git/__pycache__/diff.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/__pycache__/exc.cpython-311.pyc b/llm/Lib/site-packages/git/__pycache__/exc.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e041e4c55d7393b6953037132bbec23b36b053c9
Binary files /dev/null and b/llm/Lib/site-packages/git/__pycache__/exc.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/__pycache__/remote.cpython-311.pyc b/llm/Lib/site-packages/git/__pycache__/remote.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..82282679dc1c87adc453ddccf87c8db3cbffd326
Binary files /dev/null and b/llm/Lib/site-packages/git/__pycache__/remote.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/__pycache__/types.cpython-311.pyc b/llm/Lib/site-packages/git/__pycache__/types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ad2dcce12adcbe05376ad7f86d281f777d33a75c
Binary files /dev/null and b/llm/Lib/site-packages/git/__pycache__/types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/__pycache__/util.cpython-311.pyc b/llm/Lib/site-packages/git/__pycache__/util.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..84461800eb5b623c9b45f3dc6aa76433925c2e82
Binary files /dev/null and b/llm/Lib/site-packages/git/__pycache__/util.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/cmd.py b/llm/Lib/site-packages/git/cmd.py
new file mode 100644
index 0000000000000000000000000000000000000000..90fc39cd650d067007c63a4c9c8aff3499488a78
--- /dev/null
+++ b/llm/Lib/site-packages/git/cmd.py
@@ -0,0 +1,1723 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+from __future__ import annotations
+
+__all__ = ["GitMeta", "Git"]
+
+import contextlib
+import io
+import itertools
+import logging
+import os
+import re
+import signal
+import subprocess
+from subprocess import DEVNULL, PIPE, Popen
+import sys
+from textwrap import dedent
+import threading
+import warnings
+
+from git.compat import defenc, force_bytes, safe_decode
+from git.exc import (
+    CommandError,
+    GitCommandError,
+    GitCommandNotFound,
+    UnsafeOptionError,
+    UnsafeProtocolError,
+)
+from git.util import (
+    cygpath,
+    expand_path,
+    is_cygwin_git,
+    patch_env,
+    remove_password_if_present,
+    stream_copy,
+)
+
+# typing ---------------------------------------------------------------------------
+
+from typing import (
+    Any,
+    AnyStr,
+    BinaryIO,
+    Callable,
+    Dict,
+    IO,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Sequence,
+    TYPE_CHECKING,
+    TextIO,
+    Tuple,
+    Union,
+    cast,
+    overload,
+)
+
+from git.types import Literal, PathLike, TBD
+
+if TYPE_CHECKING:
+    from git.diff import DiffIndex
+    from git.repo.base import Repo
+
+# ---------------------------------------------------------------------------------
+
+execute_kwargs = {
+    "istream",
+    "with_extended_output",
+    "with_exceptions",
+    "as_process",
+    "output_stream",
+    "stdout_as_string",
+    "kill_after_timeout",
+    "with_stdout",
+    "universal_newlines",
+    "shell",
+    "env",
+    "max_chunk_size",
+    "strip_newline_in_stdout",
+}
+
+_logger = logging.getLogger(__name__)
+
+
+# ==============================================================================
+## @name Utilities
+# ------------------------------------------------------------------------------
+# Documentation
+## @{
+
+
+def handle_process_output(
+    process: "Git.AutoInterrupt" | Popen,
+    stdout_handler: Union[
+        None,
+        Callable[[AnyStr], None],
+        Callable[[List[AnyStr]], None],
+        Callable[[bytes, "Repo", "DiffIndex"], None],
+    ],
+    stderr_handler: Union[None, Callable[[AnyStr], None], Callable[[List[AnyStr]], None]],
+    finalizer: Union[None, Callable[[Union[Popen, "Git.AutoInterrupt"]], None]] = None,
+    decode_streams: bool = True,
+    kill_after_timeout: Union[None, float] = None,
+) -> None:
+    R"""Register for notifications to learn that process output is ready to read, and
+    dispatch lines to the respective line handlers.
+
+    This function returns once the finalizer returns.
+
+    :param process:
+        :class:`subprocess.Popen` instance.
+
+    :param stdout_handler:
+        f(stdout_line_string), or ``None``.
+
+    :param stderr_handler:
+        f(stderr_line_string), or ``None``.
+
+    :param finalizer:
+        f(proc) - wait for proc to finish.
+
+    :param decode_streams:
+        Assume stdout/stderr streams are binary and decode them before pushing their
+        contents to handlers.
+
+        This defaults to ``True``. Set it to ``False`` if:
+
+        - ``universal_newlines == True``, as then streams are in text mode, or
+        - decoding must happen later, such as for :class:`~git.diff.Diff`\s.
+
+    :param kill_after_timeout:
+        :class:`float` or ``None``, Default = ``None``
+
+        To specify a timeout in seconds for the git command, after which the process
+        should be killed.
+    """
+
+    # Use 2 "pump" threads and wait for both to finish.
+    def pump_stream(
+        cmdline: List[str],
+        name: str,
+        stream: Union[BinaryIO, TextIO],
+        is_decode: bool,
+        handler: Union[None, Callable[[Union[bytes, str]], None]],
+    ) -> None:
+        try:
+            for line in stream:
+                if handler:
+                    if is_decode:
+                        assert isinstance(line, bytes)
+                        line_str = line.decode(defenc)
+                        handler(line_str)
+                    else:
+                        handler(line)
+
+        except Exception as ex:
+            _logger.error(f"Pumping {name!r} of cmd({remove_password_if_present(cmdline)}) failed due to: {ex!r}")
+            if "I/O operation on closed file" not in str(ex):
+                # Only reraise if the error was not due to the stream closing.
+                raise CommandError([f"<{name}-pump>"] + remove_password_if_present(cmdline), ex) from ex
+        finally:
+            stream.close()
+
+    if hasattr(process, "proc"):
+        process = cast("Git.AutoInterrupt", process)
+        cmdline: str | Tuple[str, ...] | List[str] = getattr(process.proc, "args", "")
+        p_stdout = process.proc.stdout if process.proc else None
+        p_stderr = process.proc.stderr if process.proc else None
+    else:
+        process = cast(Popen, process)  # type: ignore[redundant-cast]
+        cmdline = getattr(process, "args", "")
+        p_stdout = process.stdout
+        p_stderr = process.stderr
+
+    if not isinstance(cmdline, (tuple, list)):
+        cmdline = cmdline.split()
+
+    pumps: List[Tuple[str, IO, Callable[..., None] | None]] = []
+    if p_stdout:
+        pumps.append(("stdout", p_stdout, stdout_handler))
+    if p_stderr:
+        pumps.append(("stderr", p_stderr, stderr_handler))
+
+    threads: List[threading.Thread] = []
+
+    for name, stream, handler in pumps:
+        t = threading.Thread(target=pump_stream, args=(cmdline, name, stream, decode_streams, handler))
+        t.daemon = True
+        t.start()
+        threads.append(t)
+
+    # FIXME: Why join? Will block if stdin needs feeding...
+    for t in threads:
+        t.join(timeout=kill_after_timeout)
+        if t.is_alive():
+            if isinstance(process, Git.AutoInterrupt):
+                process._terminate()
+            else:  # Don't want to deal with the other case.
+                raise RuntimeError(
+                    "Thread join() timed out in cmd.handle_process_output()."
+                    f" kill_after_timeout={kill_after_timeout} seconds"
+                )
+            if stderr_handler:
+                error_str: Union[str, bytes] = (
+                    "error: process killed because it timed out." f" kill_after_timeout={kill_after_timeout} seconds"
+                )
+                if not decode_streams and isinstance(p_stderr, BinaryIO):
+                    # Assume stderr_handler needs binary input.
+                    error_str = cast(str, error_str)
+                    error_str = error_str.encode()
+                # We ignore typing on the next line because mypy does not like the way
+                # we inferred that stderr takes str or bytes.
+                stderr_handler(error_str)  # type: ignore[arg-type]
+
+    if finalizer:
+        finalizer(process)
+
+
+safer_popen: Callable[..., Popen]
+
+if sys.platform == "win32":
+
+    def _safer_popen_windows(
+        command: Union[str, Sequence[Any]],
+        *,
+        shell: bool = False,
+        env: Optional[Mapping[str, str]] = None,
+        **kwargs: Any,
+    ) -> Popen:
+        """Call :class:`subprocess.Popen` on Windows but don't include a CWD in the
+        search.
+
+        This avoids an untrusted search path condition where a file like ``git.exe`` in
+        a malicious repository would be run when GitPython operates on the repository.
+        The process using GitPython may have an untrusted repository's working tree as
+        its current working directory. Some operations may temporarily change to that
+        directory before running a subprocess. In addition, while by default GitPython
+        does not run external commands with a shell, it can be made to do so, in which
+        case the CWD of the subprocess, which GitPython usually sets to a repository
+        working tree, can itself be searched automatically by the shell. This wrapper
+        covers all those cases.
+
+        :note:
+            This currently works by setting the
+            :envvar:`NoDefaultCurrentDirectoryInExePath` environment variable during
+            subprocess creation. It also takes care of passing Windows-specific process
+            creation flags, but that is unrelated to path search.
+
+        :note:
+            The current implementation contains a race condition on :attr:`os.environ`.
+            GitPython isn't thread-safe, but a program using it on one thread should
+            ideally be able to mutate :attr:`os.environ` on another, without
+            unpredictable results. See comments in:
+            https://github.com/gitpython-developers/GitPython/pull/1650
+        """
+        # CREATE_NEW_PROCESS_GROUP is needed for some ways of killing it afterwards.
+        # https://docs.python.org/3/library/subprocess.html#subprocess.Popen.send_signal
+        # https://docs.python.org/3/library/subprocess.html#subprocess.CREATE_NEW_PROCESS_GROUP
+        creationflags = subprocess.CREATE_NO_WINDOW | subprocess.CREATE_NEW_PROCESS_GROUP
+
+        # When using a shell, the shell is the direct subprocess, so the variable must
+        # be set in its environment, to affect its search behavior.
+        if shell:
+            # The original may be immutable, or the caller may reuse it. Mutate a copy.
+            env = {} if env is None else dict(env)
+            env["NoDefaultCurrentDirectoryInExePath"] = "1"  # The "1" can be an value.
+
+        # When not using a shell, the current process does the search in a
+        # CreateProcessW API call, so the variable must be set in our environment. With
+        # a shell, that's unnecessary if https://github.com/python/cpython/issues/101283
+        # is patched. In Python versions where it is unpatched, and in the rare case the
+        # ComSpec environment variable is unset, the search for the shell itself is
+        # unsafe. Setting NoDefaultCurrentDirectoryInExePath in all cases, as done here,
+        # is simpler and protects against that. (As above, the "1" can be any value.)
+        with patch_env("NoDefaultCurrentDirectoryInExePath", "1"):
+            return Popen(
+                command,
+                shell=shell,
+                env=env,
+                creationflags=creationflags,
+                **kwargs,
+            )
+
+    safer_popen = _safer_popen_windows
+else:
+    safer_popen = Popen
+
+
+def dashify(string: str) -> str:
+    return string.replace("_", "-")
+
+
+def slots_to_dict(self: "Git", exclude: Sequence[str] = ()) -> Dict[str, Any]:
+    return {s: getattr(self, s) for s in self.__slots__ if s not in exclude}
+
+
+def dict_to_slots_and__excluded_are_none(self: object, d: Mapping[str, Any], excluded: Sequence[str] = ()) -> None:
+    for k, v in d.items():
+        setattr(self, k, v)
+    for k in excluded:
+        setattr(self, k, None)
+
+
+## -- End Utilities -- @}
+
+_USE_SHELL_DEFAULT_MESSAGE = (
+    "Git.USE_SHELL is deprecated, because only its default value of False is safe. "
+    "It will be removed in a future release."
+)
+
+_USE_SHELL_DANGER_MESSAGE = (
+    "Setting Git.USE_SHELL to True is unsafe and insecure, as the effect of special "
+    "shell syntax cannot usually be accounted for. This can result in a command "
+    "injection vulnerability and arbitrary code execution. Git.USE_SHELL is deprecated "
+    "and will be removed in a future release."
+)
+
+
+def _warn_use_shell(extra_danger: bool) -> None:
+    warnings.warn(
+        _USE_SHELL_DANGER_MESSAGE if extra_danger else _USE_SHELL_DEFAULT_MESSAGE,
+        DeprecationWarning,
+        stacklevel=3,
+    )
+
+
+class _GitMeta(type):
+    """Metaclass for :class:`Git`.
+
+    This helps issue :class:`DeprecationWarning` if :attr:`Git.USE_SHELL` is used.
+    """
+
+    def __getattribute(cls, name: str) -> Any:
+        if name == "USE_SHELL":
+            _warn_use_shell(False)
+        return super().__getattribute__(name)
+
+    def __setattr(cls, name: str, value: Any) -> Any:
+        if name == "USE_SHELL":
+            _warn_use_shell(value)
+        super().__setattr__(name, value)
+
+    if not TYPE_CHECKING:
+        # To preserve static checking for undefined/misspelled attributes while letting
+        # the methods' bodies be type-checked, these are defined as non-special methods,
+        # then bound to special names out of view of static type checkers. (The original
+        # names invoke name mangling (leading "__") to avoid confusion in other scopes.)
+        __getattribute__ = __getattribute
+        __setattr__ = __setattr
+
+
+GitMeta = _GitMeta
+"""Alias of :class:`Git`'s metaclass, whether it is :class:`type` or a custom metaclass.
+
+Whether the :class:`Git` class has the default :class:`type` as its metaclass or uses a
+custom metaclass is not documented and may change at any time. This statically checkable
+metaclass alias is equivalent at runtime to ``type(Git)``. This should almost never be
+used. Code that benefits from it is likely to be remain brittle even if it is used.
+
+In view of the :class:`Git` class's intended use and :class:`Git` objects' dynamic
+callable attributes representing git subcommands, it rarely makes sense to inherit from
+:class:`Git` at all. Using :class:`Git` in multiple inheritance can be especially tricky
+to do correctly. Attempting uses of :class:`Git` where its metaclass is relevant, such
+as when a sibling class has an unrelated metaclass and a shared lower bound metaclass
+might have to be introduced to solve a metaclass conflict, is not recommended.
+
+:note:
+    The correct static type of the :class:`Git` class itself, and any subclasses, is
+    ``Type[Git]``. (This can be written as ``type[Git]`` in Python 3.9 later.)
+
+    :class:`GitMeta` should never be used in any annotation where ``Type[Git]`` is
+    intended or otherwise possible to use. This alias is truly only for very rare and
+    inherently precarious situations where it is necessary to deal with the metaclass
+    explicitly.
+"""
+
+
+class Git(metaclass=_GitMeta):
+    """The Git class manages communication with the Git binary.
+
+    It provides a convenient interface to calling the Git binary, such as in::
+
+     g = Git( git_dir )
+     g.init()                   # calls 'git init' program
+     rval = g.ls_files()        # calls 'git ls-files' program
+
+    Debugging:
+
+    * Set the :envvar:`GIT_PYTHON_TRACE` environment variable to print each invocation
+      of the command to stdout.
+    * Set its value to ``full`` to see details about the returned values.
+    """
+
+    __slots__ = (
+        "_working_dir",
+        "cat_file_all",
+        "cat_file_header",
+        "_version_info",
+        "_version_info_token",
+        "_git_options",
+        "_persistent_git_options",
+        "_environment",
+    )
+
+    _excluded_ = (
+        "cat_file_all",
+        "cat_file_header",
+        "_version_info",
+        "_version_info_token",
+    )
+
+    re_unsafe_protocol = re.compile(r"(.+)::.+")
+
+    def __getstate__(self) -> Dict[str, Any]:
+        return slots_to_dict(self, exclude=self._excluded_)
+
+    def __setstate__(self, d: Dict[str, Any]) -> None:
+        dict_to_slots_and__excluded_are_none(self, d, excluded=self._excluded_)
+
+    # CONFIGURATION
+
+    git_exec_name = "git"
+    """Default git command that should work on Linux, Windows, and other systems."""
+
+    GIT_PYTHON_TRACE = os.environ.get("GIT_PYTHON_TRACE", False)
+    """Enables debugging of GitPython's git commands."""
+
+    USE_SHELL: bool = False
+    """Deprecated. If set to ``True``, a shell will be used when executing git commands.
+
+    Code that uses ``USE_SHELL = True`` or that passes ``shell=True`` to any GitPython
+    functions should be updated to use the default value of ``False`` instead. ``True``
+    is unsafe unless the effect of syntax treated specially by the shell is fully
+    considered and accounted for, which is not possible under most circumstances. As
+    detailed below, it is also no longer needed, even where it had been in the past.
+
+    It is in many if not most cases a command injection vulnerability for an application
+    to set :attr:`USE_SHELL` to ``True``. Any attacker who can cause a specially crafted
+    fragment of text to make its way into any part of any argument to any git command
+    (including paths, branch names, etc.) can cause the shell to read and write
+    arbitrary files and execute arbitrary commands. Innocent input may also accidentally
+    contain special shell syntax, leading to inadvertent malfunctions.
+
+    In addition, how a value of ``True`` interacts with some aspects of GitPython's
+    operation is not precisely specified and may change without warning, even before
+    GitPython 4.0.0 when :attr:`USE_SHELL` may be removed. This includes:
+
+    * Whether or how GitPython automatically customizes the shell environment.
+
+    * Whether, outside of Windows (where :class:`subprocess.Popen` supports lists of
+      separate arguments even when ``shell=True``), this can be used with any GitPython
+      functionality other than direct calls to the :meth:`execute` method.
+
+    * Whether any GitPython feature that runs git commands ever attempts to partially
+      sanitize data a shell may treat specially. Currently this is not done.
+
+    Prior to GitPython 2.0.8, this had a narrow purpose in suppressing console windows
+    in graphical Windows applications. In 2.0.8 and higher, it provides no benefit, as
+    GitPython solves that problem more robustly and safely by using the
+    ``CREATE_NO_WINDOW`` process creation flag on Windows.
+
+    Because Windows path search differs subtly based on whether a shell is used, in rare
+    cases changing this from ``True`` to ``False`` may keep an unusual git "executable",
+    such as a batch file, from being found. To fix this, set the command name or full
+    path in the :envvar:`GIT_PYTHON_GIT_EXECUTABLE` environment variable or pass the
+    full path to :func:`git.refresh` (or invoke the script using a ``.exe`` shim).
+
+    Further reading:
+
+    * :meth:`Git.execute` (on the ``shell`` parameter).
+    * https://github.com/gitpython-developers/GitPython/commit/0d9390866f9ce42870d3116094cd49e0019a970a
+    * https://learn.microsoft.com/en-us/windows/win32/procthread/process-creation-flags
+    * https://github.com/python/cpython/issues/91558#issuecomment-1100942950
+    * https://learn.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-createprocessw
+    """
+
+    _git_exec_env_var = "GIT_PYTHON_GIT_EXECUTABLE"
+    _refresh_env_var = "GIT_PYTHON_REFRESH"
+
+    GIT_PYTHON_GIT_EXECUTABLE = None
+    """Provide the full path to the git executable. Otherwise it assumes git is in the
+    executable search path.
+
+    :note:
+        The git executable is actually found during the refresh step in the top level
+        ``__init__``. It can also be changed by explicitly calling :func:`git.refresh`.
+    """
+
+    _refresh_token = object()  # Since None would match an initial _version_info_token.
+
+    @classmethod
+    def refresh(cls, path: Union[None, PathLike] = None) -> bool:
+        """Update information about the git executable :class:`Git` objects will use.
+
+        Called by the :func:`git.refresh` function in the top level ``__init__``.
+
+        :param path:
+            Optional path to the git executable. If not absolute, it is resolved
+            immediately, relative to the current directory. (See note below.)
+
+        :note:
+            The top-level :func:`git.refresh` should be preferred because it calls this
+            method and may also update other state accordingly.
+
+        :note:
+            There are three different ways to specify the command that refreshing causes
+            to be used for git:
+
+            1. Pass no `path` argument and do not set the
+               :envvar:`GIT_PYTHON_GIT_EXECUTABLE` environment variable. The command
+               name ``git`` is used. It is looked up in a path search by the system, in
+               each command run (roughly similar to how git is found when running
+               ``git`` commands manually). This is usually the desired behavior.
+
+            2. Pass no `path` argument but set the :envvar:`GIT_PYTHON_GIT_EXECUTABLE`
+               environment variable. The command given as the value of that variable is
+               used. This may be a simple command or an arbitrary path. It is looked up
+               in each command run. Setting :envvar:`GIT_PYTHON_GIT_EXECUTABLE` to
+               ``git`` has the same effect as not setting it.
+
+            3. Pass a `path` argument. This path, if not absolute, is immediately
+               resolved, relative to the current directory. This resolution occurs at
+               the time of the refresh. When git commands are run, they are run using
+               that previously resolved path. If a `path` argument is passed, the
+               :envvar:`GIT_PYTHON_GIT_EXECUTABLE` environment variable is not
+               consulted.
+
+        :note:
+            Refreshing always sets the :attr:`Git.GIT_PYTHON_GIT_EXECUTABLE` class
+            attribute, which can be read on the :class:`Git` class or any of its
+            instances to check what command is used to run git. This attribute should
+            not be confused with the related :envvar:`GIT_PYTHON_GIT_EXECUTABLE`
+            environment variable. The class attribute is set no matter how refreshing is
+            performed.
+        """
+        # Discern which path to refresh with.
+        if path is not None:
+            new_git = os.path.expanduser(path)
+            new_git = os.path.abspath(new_git)
+        else:
+            new_git = os.environ.get(cls._git_exec_env_var, cls.git_exec_name)
+
+        # Keep track of the old and new git executable path.
+        old_git = cls.GIT_PYTHON_GIT_EXECUTABLE
+        old_refresh_token = cls._refresh_token
+        cls.GIT_PYTHON_GIT_EXECUTABLE = new_git
+        cls._refresh_token = object()
+
+        # Test if the new git executable path is valid. A GitCommandNotFound error is
+        # raised by us. A PermissionError is raised if the git executable cannot be
+        # executed for whatever reason.
+        has_git = False
+        try:
+            cls().version()
+            has_git = True
+        except (GitCommandNotFound, PermissionError):
+            pass
+
+        # Warn or raise exception if test failed.
+        if not has_git:
+            err = (
+                dedent(
+                    """\
+                Bad git executable.
+                The git executable must be specified in one of the following ways:
+                    - be included in your $PATH
+                    - be set via $%s
+                    - explicitly set via git.refresh(<full-path-to-git-executable>)
+                """
+                )
+                % cls._git_exec_env_var
+            )
+
+            # Revert to whatever the old_git was.
+            cls.GIT_PYTHON_GIT_EXECUTABLE = old_git
+            cls._refresh_token = old_refresh_token
+
+            if old_git is None:
+                # On the first refresh (when GIT_PYTHON_GIT_EXECUTABLE is None) we only
+                # are quiet, warn, or error depending on the GIT_PYTHON_REFRESH value.
+
+                # Determine what the user wants to happen during the initial refresh. We
+                # expect GIT_PYTHON_REFRESH to either be unset or be one of the
+                # following values:
+                #
+                #   0|q|quiet|s|silence|silent|n|none
+                #   1|w|warn|warning|l|log
+                #   2|r|raise|e|error|exception
+
+                mode = os.environ.get(cls._refresh_env_var, "raise").lower()
+
+                quiet = ["quiet", "q", "silence", "s", "silent", "none", "n", "0"]
+                warn = ["warn", "w", "warning", "log", "l", "1"]
+                error = ["error", "e", "exception", "raise", "r", "2"]
+
+                if mode in quiet:
+                    pass
+                elif mode in warn or mode in error:
+                    err = dedent(
+                        """\
+                        %s
+                        All git commands will error until this is rectified.
+
+                        This initial message can be silenced or aggravated in the future by setting the
+                        $%s environment variable. Use one of the following values:
+                            - %s: for no message or exception
+                            - %s: for a warning message (logging level CRITICAL, displayed by default)
+                            - %s: for a raised exception
+
+                        Example:
+                            export %s=%s
+                        """
+                    ) % (
+                        err,
+                        cls._refresh_env_var,
+                        "|".join(quiet),
+                        "|".join(warn),
+                        "|".join(error),
+                        cls._refresh_env_var,
+                        quiet[0],
+                    )
+
+                    if mode in warn:
+                        _logger.critical(err)
+                    else:
+                        raise ImportError(err)
+                else:
+                    err = dedent(
+                        """\
+                        %s environment variable has been set but it has been set with an invalid value.
+
+                        Use only the following values:
+                            - %s: for no message or exception
+                            - %s: for a warning message (logging level CRITICAL, displayed by default)
+                            - %s: for a raised exception
+                        """
+                    ) % (
+                        cls._refresh_env_var,
+                        "|".join(quiet),
+                        "|".join(warn),
+                        "|".join(error),
+                    )
+                    raise ImportError(err)
+
+                # We get here if this was the initial refresh and the refresh mode was
+                # not error. Go ahead and set the GIT_PYTHON_GIT_EXECUTABLE such that we
+                # discern the difference between the first refresh at import time
+                # and subsequent calls to git.refresh or this refresh method.
+                cls.GIT_PYTHON_GIT_EXECUTABLE = cls.git_exec_name
+            else:
+                # After the first refresh (when GIT_PYTHON_GIT_EXECUTABLE is no longer
+                # None) we raise an exception.
+                raise GitCommandNotFound(new_git, err)
+
+        return has_git
+
+    @classmethod
+    def is_cygwin(cls) -> bool:
+        return is_cygwin_git(cls.GIT_PYTHON_GIT_EXECUTABLE)
+
+    @overload
+    @classmethod
+    def polish_url(cls, url: str, is_cygwin: Literal[False] = ...) -> str: ...
+
+    @overload
+    @classmethod
+    def polish_url(cls, url: str, is_cygwin: Union[None, bool] = None) -> str: ...
+
+    @classmethod
+    def polish_url(cls, url: str, is_cygwin: Union[None, bool] = None) -> PathLike:
+        """Remove any backslashes from URLs to be written in config files.
+
+        Windows might create config files containing paths with backslashes, but git
+        stops liking them as it will escape the backslashes. Hence we undo the escaping
+        just to be sure.
+        """
+        if is_cygwin is None:
+            is_cygwin = cls.is_cygwin()
+
+        if is_cygwin:
+            url = cygpath(url)
+        else:
+            url = os.path.expandvars(url)
+            if url.startswith("~"):
+                url = os.path.expanduser(url)
+            url = url.replace("\\\\", "\\").replace("\\", "/")
+        return url
+
+    @classmethod
+    def check_unsafe_protocols(cls, url: str) -> None:
+        """Check for unsafe protocols.
+
+        Apart from the usual protocols (http, git, ssh), Git allows "remote helpers"
+        that have the form ``<transport>::<address>``. One of these helpers (``ext::``)
+        can be used to invoke any arbitrary command.
+
+        See:
+
+        - https://git-scm.com/docs/gitremote-helpers
+        - https://git-scm.com/docs/git-remote-ext
+        """
+        match = cls.re_unsafe_protocol.match(url)
+        if match:
+            protocol = match.group(1)
+            raise UnsafeProtocolError(
+                f"The `{protocol}::` protocol looks suspicious, use `allow_unsafe_protocols=True` to allow it."
+            )
+
+    @classmethod
+    def check_unsafe_options(cls, options: List[str], unsafe_options: List[str]) -> None:
+        """Check for unsafe options.
+
+        Some options that are passed to ``git <command>`` can be used to execute
+        arbitrary commands. These are blocked by default.
+        """
+        # Options can be of the form `foo`, `--foo bar`, or `--foo=bar`, so we need to
+        # check if they start with "--foo" or if they are equal to "foo".
+        bare_unsafe_options = [option.lstrip("-") for option in unsafe_options]
+        for option in options:
+            for unsafe_option, bare_option in zip(unsafe_options, bare_unsafe_options):
+                if option.startswith(unsafe_option) or option == bare_option:
+                    raise UnsafeOptionError(
+                        f"{unsafe_option} is not allowed, use `allow_unsafe_options=True` to allow it."
+                    )
+
+    class AutoInterrupt:
+        """Process wrapper that terminates the wrapped process on finalization.
+
+        This kills/interrupts the stored process instance once this instance goes out of
+        scope. It is used to prevent processes piling up in case iterators stop reading.
+
+        All attributes are wired through to the contained process object.
+
+        The wait method is overridden to perform automatic status code checking and
+        possibly raise.
+        """
+
+        __slots__ = ("proc", "args", "status")
+
+        # If this is non-zero it will override any status code during _terminate, used
+        # to prevent race conditions in testing.
+        _status_code_if_terminate: int = 0
+
+        def __init__(self, proc: Union[None, subprocess.Popen], args: Any) -> None:
+            self.proc = proc
+            self.args = args
+            self.status: Union[int, None] = None
+
+        def _terminate(self) -> None:
+            """Terminate the underlying process."""
+            if self.proc is None:
+                return
+
+            proc = self.proc
+            self.proc = None
+            if proc.stdin:
+                proc.stdin.close()
+            if proc.stdout:
+                proc.stdout.close()
+            if proc.stderr:
+                proc.stderr.close()
+            # Did the process finish already so we have a return code?
+            try:
+                if proc.poll() is not None:
+                    self.status = self._status_code_if_terminate or proc.poll()
+                    return
+            except OSError as ex:
+                _logger.info("Ignored error after process had died: %r", ex)
+
+            # It can be that nothing really exists anymore...
+            if os is None or getattr(os, "kill", None) is None:
+                return
+
+            # Try to kill it.
+            try:
+                proc.terminate()
+                status = proc.wait()  # Ensure the process goes away.
+
+                self.status = self._status_code_if_terminate or status
+            except OSError as ex:
+                _logger.info("Ignored error after process had died: %r", ex)
+            # END exception handling
+
+        def __del__(self) -> None:
+            self._terminate()
+
+        def __getattr__(self, attr: str) -> Any:
+            return getattr(self.proc, attr)
+
+        # TODO: Bad choice to mimic `proc.wait()` but with different args.
+        def wait(self, stderr: Union[None, str, bytes] = b"") -> int:
+            """Wait for the process and return its status code.
+
+            :param stderr:
+                Previously read value of stderr, in case stderr is already closed.
+
+            :warn:
+                May deadlock if output or error pipes are used and not handled
+                separately.
+
+            :raise git.exc.GitCommandError:
+                If the return status is not 0.
+            """
+            if stderr is None:
+                stderr_b = b""
+            stderr_b = force_bytes(data=stderr, encoding="utf-8")
+            status: Union[int, None]
+            if self.proc is not None:
+                status = self.proc.wait()
+                p_stderr = self.proc.stderr
+            else:  # Assume the underlying proc was killed earlier or never existed.
+                status = self.status
+                p_stderr = None
+
+            def read_all_from_possibly_closed_stream(stream: Union[IO[bytes], None]) -> bytes:
+                if stream:
+                    try:
+                        return stderr_b + force_bytes(stream.read())
+                    except (OSError, ValueError):
+                        return stderr_b or b""
+                else:
+                    return stderr_b or b""
+
+            # END status handling
+
+            if status != 0:
+                errstr = read_all_from_possibly_closed_stream(p_stderr)
+                _logger.debug("AutoInterrupt wait stderr: %r" % (errstr,))
+                raise GitCommandError(remove_password_if_present(self.args), status, errstr)
+            return status
+
+    # END auto interrupt
+
+    class CatFileContentStream:
+        """Object representing a sized read-only stream returning the contents of
+        an object.
+
+        This behaves like a stream, but counts the data read and simulates an empty
+        stream once our sized content region is empty.
+
+        If not all data are read to the end of the object's lifetime, we read the
+        rest to ensure the underlying stream continues to work.
+        """
+
+        __slots__ = ("_stream", "_nbr", "_size")
+
+        def __init__(self, size: int, stream: IO[bytes]) -> None:
+            self._stream = stream
+            self._size = size
+            self._nbr = 0  # Number of bytes read.
+
+            # Special case: If the object is empty, has null bytes, get the final
+            # newline right away.
+            if size == 0:
+                stream.read(1)
+            # END handle empty streams
+
+        def read(self, size: int = -1) -> bytes:
+            bytes_left = self._size - self._nbr
+            if bytes_left == 0:
+                return b""
+            if size > -1:
+                # Ensure we don't try to read past our limit.
+                size = min(bytes_left, size)
+            else:
+                # They try to read all, make sure it's not more than what remains.
+                size = bytes_left
+            # END check early depletion
+            data = self._stream.read(size)
+            self._nbr += len(data)
+
+            # Check for depletion, read our final byte to make the stream usable by
+            # others.
+            if self._size - self._nbr == 0:
+                self._stream.read(1)  # final newline
+            # END finish reading
+            return data
+
+        def readline(self, size: int = -1) -> bytes:
+            if self._nbr == self._size:
+                return b""
+
+            # Clamp size to lowest allowed value.
+            bytes_left = self._size - self._nbr
+            if size > -1:
+                size = min(bytes_left, size)
+            else:
+                size = bytes_left
+            # END handle size
+
+            data = self._stream.readline(size)
+            self._nbr += len(data)
+
+            # Handle final byte.
+            if self._size - self._nbr == 0:
+                self._stream.read(1)
+            # END finish reading
+
+            return data
+
+        def readlines(self, size: int = -1) -> List[bytes]:
+            if self._nbr == self._size:
+                return []
+
+            # Leave all additional logic to our readline method, we just check the size.
+            out = []
+            nbr = 0
+            while True:
+                line = self.readline()
+                if not line:
+                    break
+                out.append(line)
+                if size > -1:
+                    nbr += len(line)
+                    if nbr > size:
+                        break
+                # END handle size constraint
+            # END readline loop
+            return out
+
+        # skipcq: PYL-E0301
+        def __iter__(self) -> "Git.CatFileContentStream":
+            return self
+
+        def __next__(self) -> bytes:
+            line = self.readline()
+            if not line:
+                raise StopIteration
+
+            return line
+
+        next = __next__
+
+        def __del__(self) -> None:
+            bytes_left = self._size - self._nbr
+            if bytes_left:
+                # Read and discard - seeking is impossible within a stream.
+                # This includes any terminating newline.
+                self._stream.read(bytes_left + 1)
+            # END handle incomplete read
+
+    def __init__(self, working_dir: Union[None, PathLike] = None) -> None:
+        """Initialize this instance with:
+
+        :param working_dir:
+            Git directory we should work in. If ``None``, we always work in the current
+            directory as returned by :func:`os.getcwd`.
+            This is meant to be the working tree directory if available, or the
+            ``.git`` directory in case of bare repositories.
+        """
+        super().__init__()
+        self._working_dir = expand_path(working_dir)
+        self._git_options: Union[List[str], Tuple[str, ...]] = ()
+        self._persistent_git_options: List[str] = []
+
+        # Extra environment variables to pass to git commands
+        self._environment: Dict[str, str] = {}
+
+        # Cached version slots
+        self._version_info: Union[Tuple[int, ...], None] = None
+        self._version_info_token: object = None
+
+        # Cached command slots
+        self.cat_file_header: Union[None, TBD] = None
+        self.cat_file_all: Union[None, TBD] = None
+
+    def __getattribute__(self, name: str) -> Any:
+        if name == "USE_SHELL":
+            _warn_use_shell(False)
+        return super().__getattribute__(name)
+
+    def __getattr__(self, name: str) -> Any:
+        """A convenience method as it allows to call the command as if it was an object.
+
+        :return:
+            Callable object that will execute call :meth:`_call_process` with your
+            arguments.
+        """
+        if name.startswith("_"):
+            return super().__getattribute__(name)
+        return lambda *args, **kwargs: self._call_process(name, *args, **kwargs)
+
+    def set_persistent_git_options(self, **kwargs: Any) -> None:
+        """Specify command line options to the git executable for subsequent
+        subcommand calls.
+
+        :param kwargs:
+            A dict of keyword arguments.
+            These arguments are passed as in :meth:`_call_process`, but will be passed
+            to the git command rather than the subcommand.
+        """
+
+        self._persistent_git_options = self.transform_kwargs(split_single_char_options=True, **kwargs)
+
+    @property
+    def working_dir(self) -> Union[None, PathLike]:
+        """:return: Git directory we are working on"""
+        return self._working_dir
+
+    @property
+    def version_info(self) -> Tuple[int, ...]:
+        """
+        :return: Tuple with integers representing the major, minor and additional
+            version numbers as parsed from :manpage:`git-version(1)`. Up to four fields
+            are used.
+
+            This value is generated on demand and is cached.
+        """
+        # Refreshing is global, but version_info caching is per-instance.
+        refresh_token = self._refresh_token  # Copy token in case of concurrent refresh.
+
+        # Use the cached version if obtained after the most recent refresh.
+        if self._version_info_token is refresh_token:
+            assert self._version_info is not None, "Bug: corrupted token-check state"
+            return self._version_info
+
+        # Run "git version" and parse it.
+        process_version = self._call_process("version")
+        version_string = process_version.split(" ")[2]
+        version_fields = version_string.split(".")[:4]
+        leading_numeric_fields = itertools.takewhile(str.isdigit, version_fields)
+        self._version_info = tuple(map(int, leading_numeric_fields))
+
+        # This value will be considered valid until the next refresh.
+        self._version_info_token = refresh_token
+        return self._version_info
+
+    @overload
+    def execute(
+        self,
+        command: Union[str, Sequence[Any]],
+        *,
+        as_process: Literal[True],
+    ) -> "AutoInterrupt": ...
+
+    @overload
+    def execute(
+        self,
+        command: Union[str, Sequence[Any]],
+        *,
+        as_process: Literal[False] = False,
+        stdout_as_string: Literal[True],
+    ) -> Union[str, Tuple[int, str, str]]: ...
+
+    @overload
+    def execute(
+        self,
+        command: Union[str, Sequence[Any]],
+        *,
+        as_process: Literal[False] = False,
+        stdout_as_string: Literal[False] = False,
+    ) -> Union[bytes, Tuple[int, bytes, str]]: ...
+
+    @overload
+    def execute(
+        self,
+        command: Union[str, Sequence[Any]],
+        *,
+        with_extended_output: Literal[False],
+        as_process: Literal[False],
+        stdout_as_string: Literal[True],
+    ) -> str: ...
+
+    @overload
+    def execute(
+        self,
+        command: Union[str, Sequence[Any]],
+        *,
+        with_extended_output: Literal[False],
+        as_process: Literal[False],
+        stdout_as_string: Literal[False],
+    ) -> bytes: ...
+
+    def execute(
+        self,
+        command: Union[str, Sequence[Any]],
+        istream: Union[None, BinaryIO] = None,
+        with_extended_output: bool = False,
+        with_exceptions: bool = True,
+        as_process: bool = False,
+        output_stream: Union[None, BinaryIO] = None,
+        stdout_as_string: bool = True,
+        kill_after_timeout: Union[None, float] = None,
+        with_stdout: bool = True,
+        universal_newlines: bool = False,
+        shell: Union[None, bool] = None,
+        env: Union[None, Mapping[str, str]] = None,
+        max_chunk_size: int = io.DEFAULT_BUFFER_SIZE,
+        strip_newline_in_stdout: bool = True,
+        **subprocess_kwargs: Any,
+    ) -> Union[str, bytes, Tuple[int, Union[str, bytes], str], AutoInterrupt]:
+        R"""Handle executing the command, and consume and return the returned
+        information (stdout).
+
+        :param command:
+            The command argument list to execute.
+            It should be a sequence of program arguments, or a string. The
+            program to execute is the first item in the args sequence or string.
+
+        :param istream:
+            Standard input filehandle passed to :class:`subprocess.Popen`.
+
+        :param with_extended_output:
+            Whether to return a (status, stdout, stderr) tuple.
+
+        :param with_exceptions:
+            Whether to raise an exception when git returns a non-zero status.
+
+        :param as_process:
+            Whether to return the created process instance directly from which
+            streams can be read on demand. This will render `with_extended_output`
+            and `with_exceptions` ineffective - the caller will have to deal with
+            the details. It is important to note that the process will be placed
+            into an :class:`AutoInterrupt` wrapper that will interrupt the process
+            once it goes out of scope. If you use the command in iterators, you
+            should pass the whole process instance instead of a single stream.
+
+        :param output_stream:
+            If set to a file-like object, data produced by the git command will be
+            copied to the given stream instead of being returned as a string.
+            This feature only has any effect if `as_process` is ``False``.
+
+        :param stdout_as_string:
+            If ``False``, the command's standard output will be bytes. Otherwise, it
+            will be decoded into a string using the default encoding (usually UTF-8).
+            The latter can fail, if the output contains binary data.
+
+        :param kill_after_timeout:
+            Specifies a timeout in seconds for the git command, after which the process
+            should be killed. This will have no effect if `as_process` is set to
+            ``True``. It is set to ``None`` by default and will let the process run
+            until the timeout is explicitly specified. Uses of this feature should be
+            carefully considered, due to the following limitations:
+
+            1. This feature is not supported at all on Windows.
+            2. Effectiveness may vary by operating system. ``ps --ppid`` is used to
+               enumerate child processes, which is available on most GNU/Linux systems
+               but not most others.
+            3. Deeper descendants do not receive signals, though they may sometimes
+               terminate as a consequence of their parent processes being killed.
+            4. `kill_after_timeout` uses ``SIGKILL``, which can have negative side
+               effects on a repository. For example, stale locks in case of
+               :manpage:`git-gc(1)` could render the repository incapable of accepting
+               changes until the lock is manually removed.
+
+        :param with_stdout:
+            If ``True``, default ``True``, we open stdout on the created process.
+
+        :param universal_newlines:
+            If ``True``, pipes will be opened as text, and lines are split at all known
+            line endings.
+
+        :param shell:
+            Whether to invoke commands through a shell
+            (see :class:`Popen(..., shell=True) <subprocess.Popen>`).
+            If this is not ``None``, it overrides :attr:`USE_SHELL`.
+
+            Passing ``shell=True`` to this or any other GitPython function should be
+            avoided, as it is unsafe under most circumstances. This is because it is
+            typically not feasible to fully consider and account for the effect of shell
+            expansions, especially when passing ``shell=True`` to other methods that
+            forward it to :meth:`Git.execute`. Passing ``shell=True`` is also no longer
+            needed (nor useful) to work around any known operating system specific
+            issues.
+
+        :param env:
+            A dictionary of environment variables to be passed to
+            :class:`subprocess.Popen`.
+
+        :param max_chunk_size:
+            Maximum number of bytes in one chunk of data passed to the `output_stream`
+            in one invocation of its ``write()`` method. If the given number is not
+            positive then the default value is used.
+
+        :param strip_newline_in_stdout:
+            Whether to strip the trailing ``\n`` of the command stdout.
+
+        :param subprocess_kwargs:
+            Keyword arguments to be passed to :class:`subprocess.Popen`. Please note
+            that some of the valid kwargs are already set by this method; the ones you
+            specify may not be the same ones.
+
+        :return:
+            * str(output), if `extended_output` is ``False`` (Default)
+            * tuple(int(status), str(stdout), str(stderr)),
+              if `extended_output` is ``True``
+
+            If `output_stream` is ``True``, the stdout value will be your output stream:
+
+            * output_stream, if `extended_output` is ``False``
+            * tuple(int(status), output_stream, str(stderr)),
+              if `extended_output` is ``True``
+
+            Note that git is executed with ``LC_MESSAGES="C"`` to ensure consistent
+            output regardless of system language.
+
+        :raise git.exc.GitCommandError:
+
+        :note:
+            If you add additional keyword arguments to the signature of this method, you
+            must update the ``execute_kwargs`` variable housed in this module.
+        """
+        # Remove password for the command if present.
+        redacted_command = remove_password_if_present(command)
+        if self.GIT_PYTHON_TRACE and (self.GIT_PYTHON_TRACE != "full" or as_process):
+            _logger.info(" ".join(redacted_command))
+
+        # Allow the user to have the command executed in their working dir.
+        try:
+            cwd = self._working_dir or os.getcwd()  # type: Union[None, str]
+            if not os.access(str(cwd), os.X_OK):
+                cwd = None
+        except FileNotFoundError:
+            cwd = None
+
+        # Start the process.
+        inline_env = env
+        env = os.environ.copy()
+        # Attempt to force all output to plain ASCII English, which is what some parsing
+        # code may expect.
+        # According to https://askubuntu.com/a/311796, we are setting LANGUAGE as well
+        # just to be sure.
+        env["LANGUAGE"] = "C"
+        env["LC_ALL"] = "C"
+        env.update(self._environment)
+        if inline_env is not None:
+            env.update(inline_env)
+
+        if sys.platform == "win32":
+            if kill_after_timeout is not None:
+                raise GitCommandError(
+                    redacted_command,
+                    '"kill_after_timeout" feature is not supported on Windows.',
+                )
+            cmd_not_found_exception = OSError
+        else:
+            cmd_not_found_exception = FileNotFoundError
+        # END handle
+
+        stdout_sink = PIPE if with_stdout else getattr(subprocess, "DEVNULL", None) or open(os.devnull, "wb")
+        if shell is None:
+            # Get the value of USE_SHELL with no deprecation warning. Do this without
+            # warnings.catch_warnings, to avoid a race condition with application code
+            # configuring warnings. The value could be looked up in type(self).__dict__
+            # or Git.__dict__, but those can break under some circumstances. This works
+            # the same as self.USE_SHELL in more situations; see Git.__getattribute__.
+            shell = super().__getattribute__("USE_SHELL")
+        _logger.debug(
+            "Popen(%s, cwd=%s, stdin=%s, shell=%s, universal_newlines=%s)",
+            redacted_command,
+            cwd,
+            "<valid stream>" if istream else "None",
+            shell,
+            universal_newlines,
+        )
+        try:
+            proc = safer_popen(
+                command,
+                env=env,
+                cwd=cwd,
+                bufsize=-1,
+                stdin=(istream or DEVNULL),
+                stderr=PIPE,
+                stdout=stdout_sink,
+                shell=shell,
+                universal_newlines=universal_newlines,
+                **subprocess_kwargs,
+            )
+        except cmd_not_found_exception as err:
+            raise GitCommandNotFound(redacted_command, err) from err
+        else:
+            # Replace with a typeguard for Popen[bytes]?
+            proc.stdout = cast(BinaryIO, proc.stdout)
+            proc.stderr = cast(BinaryIO, proc.stderr)
+
+        if as_process:
+            return self.AutoInterrupt(proc, command)
+
+        if sys.platform != "win32" and kill_after_timeout is not None:
+            # Help mypy figure out this is not None even when used inside communicate().
+            timeout = kill_after_timeout
+
+            def kill_process(pid: int) -> None:
+                """Callback to kill a process.
+
+                This callback implementation would be ineffective and unsafe on Windows.
+                """
+                p = Popen(["ps", "--ppid", str(pid)], stdout=PIPE)
+                child_pids = []
+                if p.stdout is not None:
+                    for line in p.stdout:
+                        if len(line.split()) > 0:
+                            local_pid = (line.split())[0]
+                            if local_pid.isdigit():
+                                child_pids.append(int(local_pid))
+                try:
+                    os.kill(pid, signal.SIGKILL)
+                    for child_pid in child_pids:
+                        try:
+                            os.kill(child_pid, signal.SIGKILL)
+                        except OSError:
+                            pass
+                    # Tell the main routine that the process was killed.
+                    kill_check.set()
+                except OSError:
+                    # It is possible that the process gets completed in the duration
+                    # after timeout happens and before we try to kill the process.
+                    pass
+                return
+
+            def communicate() -> Tuple[AnyStr, AnyStr]:
+                watchdog.start()
+                out, err = proc.communicate()
+                watchdog.cancel()
+                if kill_check.is_set():
+                    err = 'Timeout: the command "%s" did not complete in %d ' "secs." % (
+                        " ".join(redacted_command),
+                        timeout,
+                    )
+                    if not universal_newlines:
+                        err = err.encode(defenc)
+                return out, err
+
+            # END helpers
+
+            kill_check = threading.Event()
+            watchdog = threading.Timer(timeout, kill_process, args=(proc.pid,))
+        else:
+            communicate = proc.communicate
+
+        # Wait for the process to return.
+        status = 0
+        stdout_value: Union[str, bytes] = b""
+        stderr_value: Union[str, bytes] = b""
+        newline = "\n" if universal_newlines else b"\n"
+        try:
+            if output_stream is None:
+                stdout_value, stderr_value = communicate()
+                # Strip trailing "\n".
+                if stdout_value.endswith(newline) and strip_newline_in_stdout:  # type: ignore[arg-type]
+                    stdout_value = stdout_value[:-1]
+                if stderr_value.endswith(newline):  # type: ignore[arg-type]
+                    stderr_value = stderr_value[:-1]
+
+                status = proc.returncode
+            else:
+                max_chunk_size = max_chunk_size if max_chunk_size and max_chunk_size > 0 else io.DEFAULT_BUFFER_SIZE
+                stream_copy(proc.stdout, output_stream, max_chunk_size)
+                stdout_value = proc.stdout.read()
+                stderr_value = proc.stderr.read()
+                # Strip trailing "\n".
+                if stderr_value.endswith(newline):  # type: ignore[arg-type]
+                    stderr_value = stderr_value[:-1]
+                status = proc.wait()
+            # END stdout handling
+        finally:
+            proc.stdout.close()
+            proc.stderr.close()
+
+        if self.GIT_PYTHON_TRACE == "full":
+            cmdstr = " ".join(redacted_command)
+
+            def as_text(stdout_value: Union[bytes, str]) -> str:
+                return not output_stream and safe_decode(stdout_value) or "<OUTPUT_STREAM>"
+
+            # END as_text
+
+            if stderr_value:
+                _logger.info(
+                    "%s -> %d; stdout: '%s'; stderr: '%s'",
+                    cmdstr,
+                    status,
+                    as_text(stdout_value),
+                    safe_decode(stderr_value),
+                )
+            elif stdout_value:
+                _logger.info("%s -> %d; stdout: '%s'", cmdstr, status, as_text(stdout_value))
+            else:
+                _logger.info("%s -> %d", cmdstr, status)
+        # END handle debug printing
+
+        if with_exceptions and status != 0:
+            raise GitCommandError(redacted_command, status, stderr_value, stdout_value)
+
+        if isinstance(stdout_value, bytes) and stdout_as_string:  # Could also be output_stream.
+            stdout_value = safe_decode(stdout_value)
+
+        # Allow access to the command's status code.
+        if with_extended_output:
+            return (status, stdout_value, safe_decode(stderr_value))
+        else:
+            return stdout_value
+
+    def environment(self) -> Dict[str, str]:
+        return self._environment
+
+    def update_environment(self, **kwargs: Any) -> Dict[str, Union[str, None]]:
+        """Set environment variables for future git invocations. Return all changed
+        values in a format that can be passed back into this function to revert the
+        changes.
+
+        Examples::
+
+            old_env = self.update_environment(PWD='/tmp')
+            self.update_environment(**old_env)
+
+        :param kwargs:
+            Environment variables to use for git processes.
+
+        :return:
+            Dict that maps environment variables to their old values
+        """
+        old_env = {}
+        for key, value in kwargs.items():
+            # Set value if it is None.
+            if value is not None:
+                old_env[key] = self._environment.get(key)
+                self._environment[key] = value
+            # Remove key from environment if its value is None.
+            elif key in self._environment:
+                old_env[key] = self._environment[key]
+                del self._environment[key]
+        return old_env
+
+    @contextlib.contextmanager
+    def custom_environment(self, **kwargs: Any) -> Iterator[None]:
+        """A context manager around the above :meth:`update_environment` method to
+        restore the environment back to its previous state after operation.
+
+        Examples::
+
+            with self.custom_environment(GIT_SSH='/bin/ssh_wrapper'):
+                repo.remotes.origin.fetch()
+
+        :param kwargs:
+            See :meth:`update_environment`.
+        """
+        old_env = self.update_environment(**kwargs)
+        try:
+            yield
+        finally:
+            self.update_environment(**old_env)
+
+    def transform_kwarg(self, name: str, value: Any, split_single_char_options: bool) -> List[str]:
+        if len(name) == 1:
+            if value is True:
+                return ["-%s" % name]
+            elif value not in (False, None):
+                if split_single_char_options:
+                    return ["-%s" % name, "%s" % value]
+                else:
+                    return ["-%s%s" % (name, value)]
+        else:
+            if value is True:
+                return ["--%s" % dashify(name)]
+            elif value is not False and value is not None:
+                return ["--%s=%s" % (dashify(name), value)]
+        return []
+
+    def transform_kwargs(self, split_single_char_options: bool = True, **kwargs: Any) -> List[str]:
+        """Transform Python-style kwargs into git command line options."""
+        args = []
+        for k, v in kwargs.items():
+            if isinstance(v, (list, tuple)):
+                for value in v:
+                    args += self.transform_kwarg(k, value, split_single_char_options)
+            else:
+                args += self.transform_kwarg(k, v, split_single_char_options)
+        return args
+
+    @classmethod
+    def _unpack_args(cls, arg_list: Sequence[str]) -> List[str]:
+        outlist = []
+        if isinstance(arg_list, (list, tuple)):
+            for arg in arg_list:
+                outlist.extend(cls._unpack_args(arg))
+        else:
+            outlist.append(str(arg_list))
+
+        return outlist
+
+    def __call__(self, **kwargs: Any) -> "Git":
+        """Specify command line options to the git executable for a subcommand call.
+
+        :param kwargs:
+            A dict of keyword arguments.
+            These arguments are passed as in :meth:`_call_process`, but will be passed
+            to the git command rather than the subcommand.
+
+        Examples::
+
+            git(work_tree='/tmp').difftool()
+        """
+        self._git_options = self.transform_kwargs(split_single_char_options=True, **kwargs)
+        return self
+
+    @overload
+    def _call_process(
+        self, method: str, *args: None, **kwargs: None
+    ) -> str: ...  # If no args were given, execute the call with all defaults.
+
+    @overload
+    def _call_process(
+        self,
+        method: str,
+        istream: int,
+        as_process: Literal[True],
+        *args: Any,
+        **kwargs: Any,
+    ) -> "Git.AutoInterrupt": ...
+
+    @overload
+    def _call_process(
+        self, method: str, *args: Any, **kwargs: Any
+    ) -> Union[str, bytes, Tuple[int, Union[str, bytes], str], "Git.AutoInterrupt"]: ...
+
+    def _call_process(
+        self, method: str, *args: Any, **kwargs: Any
+    ) -> Union[str, bytes, Tuple[int, Union[str, bytes], str], "Git.AutoInterrupt"]:
+        """Run the given git command with the specified arguments and return the result
+        as a string.
+
+        :param method:
+            The command. Contained ``_`` characters will be converted to hyphens, such
+            as in ``ls_files`` to call ``ls-files``.
+
+        :param args:
+            The list of arguments. If ``None`` is included, it will be pruned.
+            This allows your commands to call git more conveniently, as ``None`` is
+            realized as non-existent.
+
+        :param kwargs:
+            Contains key-values for the following:
+
+            - The :meth:`execute()` kwds, as listed in ``execute_kwargs``.
+            - "Command options" to be converted by :meth:`transform_kwargs`.
+            - The ``insert_kwargs_after`` key which its value must match one of
+              ``*args``.
+
+            It also contains any command options, to be appended after the matched arg.
+
+        Examples::
+
+            git.rev_list('master', max_count=10, header=True)
+
+        turns into::
+
+            git rev-list max-count 10 --header master
+
+        :return:
+            Same as :meth:`execute`. If no args are given, used :meth:`execute`'s
+            default (especially ``as_process = False``, ``stdout_as_string = True``) and
+            return :class:`str`.
+        """
+        # Handle optional arguments prior to calling transform_kwargs.
+        # Otherwise these'll end up in args, which is bad.
+        exec_kwargs = {k: v for k, v in kwargs.items() if k in execute_kwargs}
+        opts_kwargs = {k: v for k, v in kwargs.items() if k not in execute_kwargs}
+
+        insert_after_this_arg = opts_kwargs.pop("insert_kwargs_after", None)
+
+        # Prepare the argument list.
+
+        opt_args = self.transform_kwargs(**opts_kwargs)
+        ext_args = self._unpack_args([a for a in args if a is not None])
+
+        if insert_after_this_arg is None:
+            args_list = opt_args + ext_args
+        else:
+            try:
+                index = ext_args.index(insert_after_this_arg)
+            except ValueError as err:
+                raise ValueError(
+                    "Couldn't find argument '%s' in args %s to insert cmd options after"
+                    % (insert_after_this_arg, str(ext_args))
+                ) from err
+            # END handle error
+            args_list = ext_args[: index + 1] + opt_args + ext_args[index + 1 :]
+        # END handle opts_kwargs
+
+        call = [self.GIT_PYTHON_GIT_EXECUTABLE]
+
+        # Add persistent git options.
+        call.extend(self._persistent_git_options)
+
+        # Add the git options, then reset to empty to avoid side effects.
+        call.extend(self._git_options)
+        self._git_options = ()
+
+        call.append(dashify(method))
+        call.extend(args_list)
+
+        return self.execute(call, **exec_kwargs)
+
+    def _parse_object_header(self, header_line: str) -> Tuple[str, str, int]:
+        """
+        :param header_line:
+            A line of the form::
+
+                <hex_sha> type_string size_as_int
+
+        :return:
+            (hex_sha, type_string, size_as_int)
+
+        :raise ValueError:
+            If the header contains indication for an error due to incorrect input sha.
+        """
+        tokens = header_line.split()
+        if len(tokens) != 3:
+            if not tokens:
+                err_msg = (
+                    f"SHA is empty, possible dubious ownership in the repository "
+                    f"""at {self._working_dir}.\n            If this is unintended run:\n\n         """
+                    f"""             "git config --global --add safe.directory {self._working_dir}" """
+                )
+                raise ValueError(err_msg)
+            else:
+                raise ValueError("SHA %s could not be resolved, git returned: %r" % (tokens[0], header_line.strip()))
+            # END handle actual return value
+        # END error handling
+
+        if len(tokens[0]) != 40:
+            raise ValueError("Failed to parse header: %r" % header_line)
+        return (tokens[0], tokens[1], int(tokens[2]))
+
+    def _prepare_ref(self, ref: AnyStr) -> bytes:
+        # Required for command to separate refs on stdin, as bytes.
+        if isinstance(ref, bytes):
+            # Assume 40 bytes hexsha - bin-to-ascii for some reason returns bytes, not text.
+            refstr: str = ref.decode("ascii")
+        elif not isinstance(ref, str):
+            refstr = str(ref)  # Could be ref-object.
+        else:
+            refstr = ref
+
+        if not refstr.endswith("\n"):
+            refstr += "\n"
+        return refstr.encode(defenc)
+
+    def _get_persistent_cmd(self, attr_name: str, cmd_name: str, *args: Any, **kwargs: Any) -> "Git.AutoInterrupt":
+        cur_val = getattr(self, attr_name)
+        if cur_val is not None:
+            return cur_val
+
+        options = {"istream": PIPE, "as_process": True}
+        options.update(kwargs)
+
+        cmd = self._call_process(cmd_name, *args, **options)
+        setattr(self, attr_name, cmd)
+        cmd = cast("Git.AutoInterrupt", cmd)
+        return cmd
+
+    def __get_object_header(self, cmd: "Git.AutoInterrupt", ref: AnyStr) -> Tuple[str, str, int]:
+        if cmd.stdin and cmd.stdout:
+            cmd.stdin.write(self._prepare_ref(ref))
+            cmd.stdin.flush()
+            return self._parse_object_header(cmd.stdout.readline())
+        else:
+            raise ValueError("cmd stdin was empty")
+
+    def get_object_header(self, ref: str) -> Tuple[str, str, int]:
+        """Use this method to quickly examine the type and size of the object behind the
+        given ref.
+
+        :note:
+            The method will only suffer from the costs of command invocation once and
+            reuses the command in subsequent calls.
+
+        :return:
+            (hexsha, type_string, size_as_int)
+        """
+        cmd = self._get_persistent_cmd("cat_file_header", "cat_file", batch_check=True)
+        return self.__get_object_header(cmd, ref)
+
+    def get_object_data(self, ref: str) -> Tuple[str, str, int, bytes]:
+        """Similar to :meth:`get_object_header`, but returns object data as well.
+
+        :return:
+            (hexsha, type_string, size_as_int, data_string)
+
+        :note:
+            Not threadsafe.
+        """
+        hexsha, typename, size, stream = self.stream_object_data(ref)
+        data = stream.read(size)
+        del stream
+        return (hexsha, typename, size, data)
+
+    def stream_object_data(self, ref: str) -> Tuple[str, str, int, "Git.CatFileContentStream"]:
+        """Similar to :meth:`get_object_data`, but returns the data as a stream.
+
+        :return:
+            (hexsha, type_string, size_as_int, stream)
+
+        :note:
+            This method is not threadsafe. You need one independent :class:`Git`
+            instance per thread to be safe!
+        """
+        cmd = self._get_persistent_cmd("cat_file_all", "cat_file", batch=True)
+        hexsha, typename, size = self.__get_object_header(cmd, ref)
+        cmd_stdout = cmd.stdout if cmd.stdout is not None else io.BytesIO()
+        return (hexsha, typename, size, self.CatFileContentStream(size, cmd_stdout))
+
+    def clear_cache(self) -> "Git":
+        """Clear all kinds of internal caches to release resources.
+
+        Currently persistent commands will be interrupted.
+
+        :return:
+            self
+        """
+        for cmd in (self.cat_file_all, self.cat_file_header):
+            if cmd:
+                cmd.__del__()
+
+        self.cat_file_all = None
+        self.cat_file_header = None
+        return self
diff --git a/llm/Lib/site-packages/git/compat.py b/llm/Lib/site-packages/git/compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7d9a55a9f3cd42c587bcf7ae3de63004f927dd5
--- /dev/null
+++ b/llm/Lib/site-packages/git/compat.py
@@ -0,0 +1,165 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Utilities to help provide compatibility with Python 3.
+
+This module exists for historical reasons. Code outside GitPython may make use of public
+members of this module, but is unlikely to benefit from doing so. GitPython continues to
+use some of these utilities, in some cases for compatibility across different platforms.
+"""
+
+import locale
+import os
+import sys
+import warnings
+
+from gitdb.utils.encoding import force_bytes, force_text  # noqa: F401
+
+# typing --------------------------------------------------------------------
+
+from typing import (
+    Any,  # noqa: F401
+    AnyStr,
+    Dict,  # noqa: F401
+    IO,  # noqa: F401
+    List,
+    Optional,
+    TYPE_CHECKING,
+    Tuple,  # noqa: F401
+    Type,  # noqa: F401
+    Union,
+    overload,
+)
+
+# ---------------------------------------------------------------------------
+
+
+_deprecated_platform_aliases = {
+    "is_win": os.name == "nt",
+    "is_posix": os.name == "posix",
+    "is_darwin": sys.platform == "darwin",
+}
+
+
+def _getattr(name: str) -> Any:
+    try:
+        value = _deprecated_platform_aliases[name]
+    except KeyError:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}") from None
+
+    warnings.warn(
+        f"{__name__}.{name} and other is_<platform> aliases are deprecated. "
+        "Write the desired os.name or sys.platform check explicitly instead.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return value
+
+
+if not TYPE_CHECKING:  # Preserve static checking for undefined/misspelled attributes.
+    __getattr__ = _getattr
+
+
+def __dir__() -> List[str]:
+    return [*globals(), *_deprecated_platform_aliases]
+
+
+is_win: bool
+"""Deprecated alias for ``os.name == "nt"`` to check for native Windows.
+
+This is deprecated because it is clearer to write out :attr:`os.name` or
+:attr:`sys.platform` checks explicitly, especially in cases where it matters which is
+used.
+
+:note:
+    ``is_win`` is ``False`` on Cygwin, but is often wrongly assumed ``True``. To detect
+    Cygwin, use ``sys.platform == "cygwin"``.
+"""
+
+is_posix: bool
+"""Deprecated alias for ``os.name == "posix"`` to check for Unix-like ("POSIX") systems.
+
+This is deprecated because it clearer to write out :attr:`os.name` or
+:attr:`sys.platform` checks explicitly, especially in cases where it matters which is
+used.
+
+:note:
+    For POSIX systems, more detailed information is available in :attr:`sys.platform`,
+    while :attr:`os.name` is always ``"posix"`` on such systems, including macOS
+    (Darwin).
+"""
+
+is_darwin: bool
+"""Deprecated alias for ``sys.platform == "darwin"`` to check for macOS (Darwin).
+
+This is deprecated because it clearer to write out :attr:`os.name` or
+:attr:`sys.platform` checks explicitly.
+
+:note:
+    For macOS (Darwin), ``os.name == "posix"`` as in other Unix-like systems, while
+    ``sys.platform == "darwin"``.
+"""
+
+defenc = sys.getfilesystemencoding()
+"""The encoding used to convert between Unicode and bytes filenames."""
+
+
+@overload
+def safe_decode(s: None) -> None: ...
+
+
+@overload
+def safe_decode(s: AnyStr) -> str: ...
+
+
+def safe_decode(s: Union[AnyStr, None]) -> Optional[str]:
+    """Safely decode a binary string to Unicode."""
+    if isinstance(s, str):
+        return s
+    elif isinstance(s, bytes):
+        return s.decode(defenc, "surrogateescape")
+    elif s is None:
+        return None
+    else:
+        raise TypeError("Expected bytes or text, but got %r" % (s,))
+
+
+@overload
+def safe_encode(s: None) -> None: ...
+
+
+@overload
+def safe_encode(s: AnyStr) -> bytes: ...
+
+
+def safe_encode(s: Optional[AnyStr]) -> Optional[bytes]:
+    """Safely encode a binary string to Unicode."""
+    if isinstance(s, str):
+        return s.encode(defenc)
+    elif isinstance(s, bytes):
+        return s
+    elif s is None:
+        return None
+    else:
+        raise TypeError("Expected bytes or text, but got %r" % (s,))
+
+
+@overload
+def win_encode(s: None) -> None: ...
+
+
+@overload
+def win_encode(s: AnyStr) -> bytes: ...
+
+
+def win_encode(s: Optional[AnyStr]) -> Optional[bytes]:
+    """Encode Unicode strings for process arguments on Windows."""
+    if isinstance(s, str):
+        return s.encode(locale.getpreferredencoding(False))
+    elif isinstance(s, bytes):
+        return s
+    elif s is not None:
+        raise TypeError("Expected bytes or text, but got %r" % (s,))
+    return None
diff --git a/llm/Lib/site-packages/git/config.py b/llm/Lib/site-packages/git/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ce9b123f920bdefb127f696b6a01543ed3c9e65
--- /dev/null
+++ b/llm/Lib/site-packages/git/config.py
@@ -0,0 +1,944 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Parser for reading and writing configuration files."""
+
+__all__ = ["GitConfigParser", "SectionConstraint"]
+
+import abc
+import configparser as cp
+import fnmatch
+from functools import wraps
+import inspect
+from io import BufferedReader, IOBase
+import logging
+import os
+import os.path as osp
+import re
+import sys
+
+from git.compat import defenc, force_text
+from git.util import LockFile
+
+# typing-------------------------------------------------------
+
+from typing import (
+    Any,
+    Callable,
+    Generic,
+    IO,
+    List,
+    Dict,
+    Sequence,
+    TYPE_CHECKING,
+    Tuple,
+    TypeVar,
+    Union,
+    cast,
+)
+
+from git.types import Lit_config_levels, ConfigLevels_Tup, PathLike, assert_never, _T
+
+if TYPE_CHECKING:
+    from io import BytesIO
+
+    from git.repo.base import Repo
+
+T_ConfigParser = TypeVar("T_ConfigParser", bound="GitConfigParser")
+T_OMD_value = TypeVar("T_OMD_value", str, bytes, int, float, bool)
+
+if sys.version_info[:3] < (3, 7, 2):
+    # typing.Ordereddict not added until Python 3.7.2.
+    from collections import OrderedDict
+
+    OrderedDict_OMD = OrderedDict
+else:
+    from typing import OrderedDict
+
+    OrderedDict_OMD = OrderedDict[str, List[T_OMD_value]]  # type: ignore[assignment, misc]
+
+# -------------------------------------------------------------
+
+_logger = logging.getLogger(__name__)
+
+CONFIG_LEVELS: ConfigLevels_Tup = ("system", "user", "global", "repository")
+"""The configuration level of a configuration file."""
+
+CONDITIONAL_INCLUDE_REGEXP = re.compile(r"(?<=includeIf )\"(gitdir|gitdir/i|onbranch):(.+)\"")
+"""Section pattern to detect conditional includes.
+
+See: https://git-scm.com/docs/git-config#_conditional_includes
+"""
+
+
+class MetaParserBuilder(abc.ABCMeta):  # noqa: B024
+    """Utility class wrapping base-class methods into decorators that assure read-only
+    properties."""
+
+    def __new__(cls, name: str, bases: Tuple, clsdict: Dict[str, Any]) -> "MetaParserBuilder":
+        """Equip all base-class methods with a needs_values decorator, and all non-const
+        methods with a :func:`set_dirty_and_flush_changes` decorator in addition to
+        that.
+        """
+        kmm = "_mutating_methods_"
+        if kmm in clsdict:
+            mutating_methods = clsdict[kmm]
+            for base in bases:
+                methods = (t for t in inspect.getmembers(base, inspect.isroutine) if not t[0].startswith("_"))
+                for name, method in methods:
+                    if name in clsdict:
+                        continue
+                    method_with_values = needs_values(method)
+                    if name in mutating_methods:
+                        method_with_values = set_dirty_and_flush_changes(method_with_values)
+                    # END mutating methods handling
+
+                    clsdict[name] = method_with_values
+                # END for each name/method pair
+            # END for each base
+        # END if mutating methods configuration is set
+
+        new_type = super().__new__(cls, name, bases, clsdict)
+        return new_type
+
+
+def needs_values(func: Callable[..., _T]) -> Callable[..., _T]:
+    """Return a method for ensuring we read values (on demand) before we try to access
+    them."""
+
+    @wraps(func)
+    def assure_data_present(self: "GitConfigParser", *args: Any, **kwargs: Any) -> _T:
+        self.read()
+        return func(self, *args, **kwargs)
+
+    # END wrapper method
+    return assure_data_present
+
+
+def set_dirty_and_flush_changes(non_const_func: Callable[..., _T]) -> Callable[..., _T]:
+    """Return a method that checks whether given non constant function may be called.
+
+    If so, the instance will be set dirty. Additionally, we flush the changes right to
+    disk.
+    """
+
+    def flush_changes(self: "GitConfigParser", *args: Any, **kwargs: Any) -> _T:
+        rval = non_const_func(self, *args, **kwargs)
+        self._dirty = True
+        self.write()
+        return rval
+
+    # END wrapper method
+    flush_changes.__name__ = non_const_func.__name__
+    return flush_changes
+
+
+class SectionConstraint(Generic[T_ConfigParser]):
+    """Constrains a ConfigParser to only option commands which are constrained to
+    always use the section we have been initialized with.
+
+    It supports all ConfigParser methods that operate on an option.
+
+    :note:
+        If used as a context manager, will release the wrapped ConfigParser.
+    """
+
+    __slots__ = ("_config", "_section_name")
+
+    _valid_attrs_ = (
+        "get_value",
+        "set_value",
+        "get",
+        "set",
+        "getint",
+        "getfloat",
+        "getboolean",
+        "has_option",
+        "remove_section",
+        "remove_option",
+        "options",
+    )
+
+    def __init__(self, config: T_ConfigParser, section: str) -> None:
+        self._config = config
+        self._section_name = section
+
+    def __del__(self) -> None:
+        # Yes, for some reason, we have to call it explicitly for it to work in PY3 !
+        # Apparently __del__ doesn't get call anymore if refcount becomes 0
+        # Ridiculous ... .
+        self._config.release()
+
+    def __getattr__(self, attr: str) -> Any:
+        if attr in self._valid_attrs_:
+            return lambda *args, **kwargs: self._call_config(attr, *args, **kwargs)
+        return super().__getattribute__(attr)
+
+    def _call_config(self, method: str, *args: Any, **kwargs: Any) -> Any:
+        """Call the configuration at the given method which must take a section name as
+        first argument."""
+        return getattr(self._config, method)(self._section_name, *args, **kwargs)
+
+    @property
+    def config(self) -> T_ConfigParser:
+        """return: ConfigParser instance we constrain"""
+        return self._config
+
+    def release(self) -> None:
+        """Equivalent to :meth:`GitConfigParser.release`, which is called on our
+        underlying parser instance."""
+        return self._config.release()
+
+    def __enter__(self) -> "SectionConstraint[T_ConfigParser]":
+        self._config.__enter__()
+        return self
+
+    def __exit__(self, exception_type: str, exception_value: str, traceback: str) -> None:
+        self._config.__exit__(exception_type, exception_value, traceback)
+
+
+class _OMD(OrderedDict_OMD):
+    """Ordered multi-dict."""
+
+    def __setitem__(self, key: str, value: _T) -> None:
+        super().__setitem__(key, [value])
+
+    def add(self, key: str, value: Any) -> None:
+        if key not in self:
+            super().__setitem__(key, [value])
+            return
+
+        super().__getitem__(key).append(value)
+
+    def setall(self, key: str, values: List[_T]) -> None:
+        super().__setitem__(key, values)
+
+    def __getitem__(self, key: str) -> Any:
+        return super().__getitem__(key)[-1]
+
+    def getlast(self, key: str) -> Any:
+        return super().__getitem__(key)[-1]
+
+    def setlast(self, key: str, value: Any) -> None:
+        if key not in self:
+            super().__setitem__(key, [value])
+            return
+
+        prior = super().__getitem__(key)
+        prior[-1] = value
+
+    def get(self, key: str, default: Union[_T, None] = None) -> Union[_T, None]:
+        return super().get(key, [default])[-1]
+
+    def getall(self, key: str) -> List[_T]:
+        return super().__getitem__(key)
+
+    def items(self) -> List[Tuple[str, _T]]:  # type: ignore[override]
+        """List of (key, last value for key)."""
+        return [(k, self[k]) for k in self]
+
+    def items_all(self) -> List[Tuple[str, List[_T]]]:
+        """List of (key, list of values for key)."""
+        return [(k, self.getall(k)) for k in self]
+
+
+def get_config_path(config_level: Lit_config_levels) -> str:
+    # We do not support an absolute path of the gitconfig on Windows.
+    # Use the global config instead.
+    if sys.platform == "win32" and config_level == "system":
+        config_level = "global"
+
+    if config_level == "system":
+        return "/etc/gitconfig"
+    elif config_level == "user":
+        config_home = os.environ.get("XDG_CONFIG_HOME") or osp.join(os.environ.get("HOME", "~"), ".config")
+        return osp.normpath(osp.expanduser(osp.join(config_home, "git", "config")))
+    elif config_level == "global":
+        return osp.normpath(osp.expanduser("~/.gitconfig"))
+    elif config_level == "repository":
+        raise ValueError("No repo to get repository configuration from. Use Repo._get_config_path")
+    else:
+        # Should not reach here. Will raise ValueError if does. Static typing will warn
+        # about missing elifs.
+        assert_never(  # type: ignore[unreachable]
+            config_level,
+            ValueError(f"Invalid configuration level: {config_level!r}"),
+        )
+
+
+class GitConfigParser(cp.RawConfigParser, metaclass=MetaParserBuilder):
+    """Implements specifics required to read git style configuration files.
+
+    This variation behaves much like the :manpage:`git-config(1)` command, such that the
+    configuration will be read on demand based on the filepath given during
+    initialization.
+
+    The changes will automatically be written once the instance goes out of scope, but
+    can be triggered manually as well.
+
+    The configuration file will be locked if you intend to change values preventing
+    other instances to write concurrently.
+
+    :note:
+        The config is case-sensitive even when queried, hence section and option names
+        must match perfectly.
+
+    :note:
+        If used as a context manager, this will release the locked file.
+    """
+
+    # { Configuration
+    t_lock = LockFile
+    """The lock type determines the type of lock to use in new configuration readers.
+
+    They must be compatible to the :class:`~git.util.LockFile` interface.
+    A suitable alternative would be the :class:`~git.util.BlockingLockFile`.
+    """
+
+    re_comment = re.compile(r"^\s*[#;]")
+    # } END configuration
+
+    optvalueonly_source = r"\s*(?P<option>[^:=\s][^:=]*)"
+
+    OPTVALUEONLY = re.compile(optvalueonly_source)
+
+    OPTCRE = re.compile(optvalueonly_source + r"\s*(?P<vi>[:=])\s*" + r"(?P<value>.*)$")
+
+    del optvalueonly_source
+
+    _mutating_methods_ = ("add_section", "remove_section", "remove_option", "set")
+    """Names of :class:`~configparser.RawConfigParser` methods able to change the
+    instance."""
+
+    def __init__(
+        self,
+        file_or_files: Union[None, PathLike, "BytesIO", Sequence[Union[PathLike, "BytesIO"]]] = None,
+        read_only: bool = True,
+        merge_includes: bool = True,
+        config_level: Union[Lit_config_levels, None] = None,
+        repo: Union["Repo", None] = None,
+    ) -> None:
+        """Initialize a configuration reader to read the given `file_or_files` and to
+        possibly allow changes to it by setting `read_only` False.
+
+        :param file_or_files:
+            A file path or file object, or a sequence of possibly more than one of them.
+
+        :param read_only:
+            If ``True``, the ConfigParser may only read the data, but not change it.
+            If ``False``, only a single file path or file object may be given. We will
+            write back the changes when they happen, or when the ConfigParser is
+            released. This will not happen if other configuration files have been
+            included.
+
+        :param merge_includes:
+            If ``True``, we will read files mentioned in ``[include]`` sections and
+            merge their contents into ours. This makes it impossible to write back an
+            individual configuration file. Thus, if you want to modify a single
+            configuration file, turn this off to leave the original dataset unaltered
+            when reading it.
+
+        :param repo:
+            Reference to repository to use if ``[includeIf]`` sections are found in
+            configuration files.
+        """
+        cp.RawConfigParser.__init__(self, dict_type=_OMD)
+        self._dict: Callable[..., _OMD]
+        self._defaults: _OMD
+        self._sections: _OMD
+
+        # Used in Python 3. Needs to stay in sync with sections for underlying
+        # implementation to work.
+        if not hasattr(self, "_proxies"):
+            self._proxies = self._dict()
+
+        if file_or_files is not None:
+            self._file_or_files: Union[PathLike, "BytesIO", Sequence[Union[PathLike, "BytesIO"]]] = file_or_files
+        else:
+            if config_level is None:
+                if read_only:
+                    self._file_or_files = [
+                        get_config_path(cast(Lit_config_levels, f)) for f in CONFIG_LEVELS if f != "repository"
+                    ]
+                else:
+                    raise ValueError("No configuration level or configuration files specified")
+            else:
+                self._file_or_files = [get_config_path(config_level)]
+
+        self._read_only = read_only
+        self._dirty = False
+        self._is_initialized = False
+        self._merge_includes = merge_includes
+        self._repo = repo
+        self._lock: Union["LockFile", None] = None
+        self._acquire_lock()
+
+    def _acquire_lock(self) -> None:
+        if not self._read_only:
+            if not self._lock:
+                if isinstance(self._file_or_files, (str, os.PathLike)):
+                    file_or_files = self._file_or_files
+                elif isinstance(self._file_or_files, (tuple, list, Sequence)):
+                    raise ValueError(
+                        "Write-ConfigParsers can operate on a single file only, multiple files have been passed"
+                    )
+                else:
+                    file_or_files = self._file_or_files.name
+
+                # END get filename from handle/stream
+                # Initialize lock base - we want to write.
+                self._lock = self.t_lock(file_or_files)
+            # END lock check
+
+            self._lock._obtain_lock()
+        # END read-only check
+
+    def __del__(self) -> None:
+        """Write pending changes if required and release locks."""
+        # NOTE: Only consistent in Python 2.
+        self.release()
+
+    def __enter__(self) -> "GitConfigParser":
+        self._acquire_lock()
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        self.release()
+
+    def release(self) -> None:
+        """Flush changes and release the configuration write lock. This instance must
+        not be used anymore afterwards.
+
+        In Python 3, it's required to explicitly release locks and flush changes, as
+        ``__del__`` is not called deterministically anymore.
+        """
+        # Checking for the lock here makes sure we do not raise during write()
+        # in case an invalid parser was created who could not get a lock.
+        if self.read_only or (self._lock and not self._lock._has_lock()):
+            return
+
+        try:
+            self.write()
+        except IOError:
+            _logger.error("Exception during destruction of GitConfigParser", exc_info=True)
+        except ReferenceError:
+            # This happens in Python 3... and usually means that some state cannot be
+            # written as the sections dict cannot be iterated. This usually happens when
+            # the interpreter is shutting down. Can it be fixed?
+            pass
+        finally:
+            if self._lock is not None:
+                self._lock._release_lock()
+
+    def optionxform(self, optionstr: str) -> str:
+        """Do not transform options in any way when writing."""
+        return optionstr
+
+    def _read(self, fp: Union[BufferedReader, IO[bytes]], fpname: str) -> None:
+        """Originally a direct copy of the Python 2.4 version of
+        :meth:`RawConfigParser._read <configparser.RawConfigParser._read>`, to ensure it
+        uses ordered dicts.
+
+        The ordering bug was fixed in Python 2.4, and dict itself keeps ordering since
+        Python 3.7. This has some other changes, especially that it ignores initial
+        whitespace, since git uses tabs. (Big comments are removed to be more compact.)
+        """
+        cursect = None  # None, or a dictionary.
+        optname = None
+        lineno = 0
+        is_multi_line = False
+        e = None  # None, or an exception.
+
+        def string_decode(v: str) -> str:
+            if v[-1] == "\\":
+                v = v[:-1]
+            # END cut trailing escapes to prevent decode error
+
+            return v.encode(defenc).decode("unicode_escape")
+
+        # END string_decode
+
+        while True:
+            # We assume to read binary!
+            line = fp.readline().decode(defenc)
+            if not line:
+                break
+            lineno = lineno + 1
+            # Comment or blank line?
+            if line.strip() == "" or self.re_comment.match(line):
+                continue
+            if line.split(None, 1)[0].lower() == "rem" and line[0] in "rR":
+                # No leading whitespace.
+                continue
+
+            # Is it a section header?
+            mo = self.SECTCRE.match(line.strip())
+            if not is_multi_line and mo:
+                sectname: str = mo.group("header").strip()
+                if sectname in self._sections:
+                    cursect = self._sections[sectname]
+                elif sectname == cp.DEFAULTSECT:
+                    cursect = self._defaults
+                else:
+                    cursect = self._dict((("__name__", sectname),))
+                    self._sections[sectname] = cursect
+                    self._proxies[sectname] = None
+                # So sections can't start with a continuation line.
+                optname = None
+            # No section header in the file?
+            elif cursect is None:
+                raise cp.MissingSectionHeaderError(fpname, lineno, line)
+            # An option line?
+            elif not is_multi_line:
+                mo = self.OPTCRE.match(line)
+                if mo:
+                    # We might just have handled the last line, which could contain a quotation we want to remove.
+                    optname, vi, optval = mo.group("option", "vi", "value")
+                    if vi in ("=", ":") and ";" in optval and not optval.strip().startswith('"'):
+                        pos = optval.find(";")
+                        if pos != -1 and optval[pos - 1].isspace():
+                            optval = optval[:pos]
+                    optval = optval.strip()
+                    if optval == '""':
+                        optval = ""
+                    # END handle empty string
+                    optname = self.optionxform(optname.rstrip())
+                    if len(optval) > 1 and optval[0] == '"' and optval[-1] != '"':
+                        is_multi_line = True
+                        optval = string_decode(optval[1:])
+                    # END handle multi-line
+                    # Preserves multiple values for duplicate optnames.
+                    cursect.add(optname, optval)
+                else:
+                    # Check if it's an option with no value - it's just ignored by git.
+                    if not self.OPTVALUEONLY.match(line):
+                        if not e:
+                            e = cp.ParsingError(fpname)
+                        e.append(lineno, repr(line))
+                    continue
+            else:
+                line = line.rstrip()
+                if line.endswith('"'):
+                    is_multi_line = False
+                    line = line[:-1]
+                # END handle quotations
+                optval = cursect.getlast(optname)
+                cursect.setlast(optname, optval + string_decode(line))
+            # END parse section or option
+        # END while reading
+
+        # If any parsing errors occurred, raise an exception.
+        if e:
+            raise e
+
+    def _has_includes(self) -> Union[bool, int]:
+        return self._merge_includes and len(self._included_paths())
+
+    def _included_paths(self) -> List[Tuple[str, str]]:
+        """List all paths that must be included to configuration.
+
+        :return:
+            The list of paths, where each path is a tuple of (option, value).
+        """
+        paths = []
+
+        for section in self.sections():
+            if section == "include":
+                paths += self.items(section)
+
+            match = CONDITIONAL_INCLUDE_REGEXP.search(section)
+            if match is None or self._repo is None:
+                continue
+
+            keyword = match.group(1)
+            value = match.group(2).strip()
+
+            if keyword in ["gitdir", "gitdir/i"]:
+                value = osp.expanduser(value)
+
+                if not any(value.startswith(s) for s in ["./", "/"]):
+                    value = "**/" + value
+                if value.endswith("/"):
+                    value += "**"
+
+                # Ensure that glob is always case insensitive if required.
+                if keyword.endswith("/i"):
+                    value = re.sub(
+                        r"[a-zA-Z]",
+                        lambda m: "[{}{}]".format(m.group().lower(), m.group().upper()),
+                        value,
+                    )
+                if self._repo.git_dir:
+                    if fnmatch.fnmatchcase(str(self._repo.git_dir), value):
+                        paths += self.items(section)
+
+            elif keyword == "onbranch":
+                try:
+                    branch_name = self._repo.active_branch.name
+                except TypeError:
+                    # Ignore section if active branch cannot be retrieved.
+                    continue
+
+                if fnmatch.fnmatchcase(branch_name, value):
+                    paths += self.items(section)
+
+        return paths
+
+    def read(self) -> None:  # type: ignore[override]
+        """Read the data stored in the files we have been initialized with.
+
+        This will ignore files that cannot be read, possibly leaving an empty
+        configuration.
+
+        :raise IOError:
+            If a file cannot be handled.
+        """
+        if self._is_initialized:
+            return
+        self._is_initialized = True
+
+        files_to_read: List[Union[PathLike, IO]] = [""]
+        if isinstance(self._file_or_files, (str, os.PathLike)):
+            # For str or Path, as str is a type of Sequence.
+            files_to_read = [self._file_or_files]
+        elif not isinstance(self._file_or_files, (tuple, list, Sequence)):
+            # Could merge with above isinstance once runtime type known.
+            files_to_read = [self._file_or_files]
+        else:  # For lists or tuples.
+            files_to_read = list(self._file_or_files)
+        # END ensure we have a copy of the paths to handle
+
+        seen = set(files_to_read)
+        num_read_include_files = 0
+        while files_to_read:
+            file_path = files_to_read.pop(0)
+            file_ok = False
+
+            if hasattr(file_path, "seek"):
+                # Must be a file-object.
+                # TODO: Replace cast with assert to narrow type, once sure.
+                file_path = cast(IO[bytes], file_path)
+                self._read(file_path, file_path.name)
+            else:
+                # Assume a path if it is not a file-object.
+                file_path = cast(PathLike, file_path)
+                try:
+                    with open(file_path, "rb") as fp:
+                        file_ok = True
+                        self._read(fp, fp.name)
+                except IOError:
+                    continue
+
+            # Read includes and append those that we didn't handle yet. We expect all
+            # paths to be normalized and absolute (and will ensure that is the case).
+            if self._has_includes():
+                for _, include_path in self._included_paths():
+                    if include_path.startswith("~"):
+                        include_path = osp.expanduser(include_path)
+                    if not osp.isabs(include_path):
+                        if not file_ok:
+                            continue
+                        # END ignore relative paths if we don't know the configuration file path
+                        file_path = cast(PathLike, file_path)
+                        assert osp.isabs(file_path), "Need absolute paths to be sure our cycle checks will work"
+                        include_path = osp.join(osp.dirname(file_path), include_path)
+                    # END make include path absolute
+                    include_path = osp.normpath(include_path)
+                    if include_path in seen or not os.access(include_path, os.R_OK):
+                        continue
+                    seen.add(include_path)
+                    # Insert included file to the top to be considered first.
+                    files_to_read.insert(0, include_path)
+                    num_read_include_files += 1
+                # END each include path in configuration file
+            # END handle includes
+        # END for each file object to read
+
+        # If there was no file included, we can safely write back (potentially) the
+        # configuration file without altering its meaning.
+        if num_read_include_files == 0:
+            self._merge_includes = False
+
+    def _write(self, fp: IO) -> None:
+        """Write an .ini-format representation of the configuration state in
+        git compatible format."""
+
+        def write_section(name: str, section_dict: _OMD) -> None:
+            fp.write(("[%s]\n" % name).encode(defenc))
+
+            values: Sequence[str]  # Runtime only gets str in tests, but should be whatever _OMD stores.
+            v: str
+            for key, values in section_dict.items_all():
+                if key == "__name__":
+                    continue
+
+                for v in values:
+                    fp.write(("\t%s = %s\n" % (key, self._value_to_string(v).replace("\n", "\n\t"))).encode(defenc))
+                # END if key is not __name__
+
+        # END section writing
+
+        if self._defaults:
+            write_section(cp.DEFAULTSECT, self._defaults)
+        value: _OMD
+
+        for name, value in self._sections.items():
+            write_section(name, value)
+
+    def items(self, section_name: str) -> List[Tuple[str, str]]:  # type: ignore[override]
+        """:return: list((option, value), ...) pairs of all items in the given section"""
+        return [(k, v) for k, v in super().items(section_name) if k != "__name__"]
+
+    def items_all(self, section_name: str) -> List[Tuple[str, List[str]]]:
+        """:return: list((option, [values...]), ...) pairs of all items in the given section"""
+        rv = _OMD(self._defaults)
+
+        for k, vs in self._sections[section_name].items_all():
+            if k == "__name__":
+                continue
+
+            if k in rv and rv.getall(k) == vs:
+                continue
+
+            for v in vs:
+                rv.add(k, v)
+
+        return rv.items_all()
+
+    @needs_values
+    def write(self) -> None:
+        """Write changes to our file, if there are changes at all.
+
+        :raise IOError:
+            If this is a read-only writer instance or if we could not obtain a file
+            lock.
+        """
+        self._assure_writable("write")
+        if not self._dirty:
+            return
+
+        if isinstance(self._file_or_files, (list, tuple)):
+            raise AssertionError(
+                "Cannot write back if there is not exactly a single file to write to, have %i files"
+                % len(self._file_or_files)
+            )
+        # END assert multiple files
+
+        if self._has_includes():
+            _logger.debug(
+                "Skipping write-back of configuration file as include files were merged in."
+                + "Set merge_includes=False to prevent this."
+            )
+            return
+        # END stop if we have include files
+
+        fp = self._file_or_files
+
+        # We have a physical file on disk, so get a lock.
+        is_file_lock = isinstance(fp, (str, os.PathLike, IOBase))  # TODO: Use PathLike (having dropped 3.5).
+        if is_file_lock and self._lock is not None:  # Else raise error?
+            self._lock._obtain_lock()
+
+        if not hasattr(fp, "seek"):
+            fp = cast(PathLike, fp)
+            with open(fp, "wb") as fp_open:
+                self._write(fp_open)
+        else:
+            fp = cast("BytesIO", fp)
+            fp.seek(0)
+            # Make sure we do not overwrite into an existing file.
+            if hasattr(fp, "truncate"):
+                fp.truncate()
+            self._write(fp)
+
+    def _assure_writable(self, method_name: str) -> None:
+        if self.read_only:
+            raise IOError("Cannot execute non-constant method %s.%s" % (self, method_name))
+
+    def add_section(self, section: str) -> None:
+        """Assures added options will stay in order."""
+        return super().add_section(section)
+
+    @property
+    def read_only(self) -> bool:
+        """:return: ``True`` if this instance may change the configuration file"""
+        return self._read_only
+
+    # FIXME: Figure out if default or return type can really include bool.
+    def get_value(
+        self,
+        section: str,
+        option: str,
+        default: Union[int, float, str, bool, None] = None,
+    ) -> Union[int, float, str, bool]:
+        """Get an option's value.
+
+        If multiple values are specified for this option in the section, the last one
+        specified is returned.
+
+        :param default:
+            If not ``None``, the given default value will be returned in case the option
+            did not exist.
+
+        :return:
+            A properly typed value, either int, float or string
+
+        :raise TypeError:
+            In case the value could not be understood.
+            Otherwise the exceptions known to the ConfigParser will be raised.
+        """
+        try:
+            valuestr = self.get(section, option)
+        except Exception:
+            if default is not None:
+                return default
+            raise
+
+        return self._string_to_value(valuestr)
+
+    def get_values(
+        self,
+        section: str,
+        option: str,
+        default: Union[int, float, str, bool, None] = None,
+    ) -> List[Union[int, float, str, bool]]:
+        """Get an option's values.
+
+        If multiple values are specified for this option in the section, all are
+        returned.
+
+        :param default:
+            If not ``None``, a list containing the given default value will be returned
+            in case the option did not exist.
+
+        :return:
+            A list of properly typed values, either int, float or string
+
+        :raise TypeError:
+            In case the value could not be understood.
+            Otherwise the exceptions known to the ConfigParser will be raised.
+        """
+        try:
+            self.sections()
+            lst = self._sections[section].getall(option)
+        except Exception:
+            if default is not None:
+                return [default]
+            raise
+
+        return [self._string_to_value(valuestr) for valuestr in lst]
+
+    def _string_to_value(self, valuestr: str) -> Union[int, float, str, bool]:
+        types = (int, float)
+        for numtype in types:
+            try:
+                val = numtype(valuestr)
+                # truncated value ?
+                if val != float(valuestr):
+                    continue
+                return val
+            except (ValueError, TypeError):
+                continue
+        # END for each numeric type
+
+        # Try boolean values as git uses them.
+        vl = valuestr.lower()
+        if vl == "false":
+            return False
+        if vl == "true":
+            return True
+
+        if not isinstance(valuestr, str):
+            raise TypeError(
+                "Invalid value type: only int, long, float and str are allowed",
+                valuestr,
+            )
+
+        return valuestr
+
+    def _value_to_string(self, value: Union[str, bytes, int, float, bool]) -> str:
+        if isinstance(value, (int, float, bool)):
+            return str(value)
+        return force_text(value)
+
+    @needs_values
+    @set_dirty_and_flush_changes
+    def set_value(self, section: str, option: str, value: Union[str, bytes, int, float, bool]) -> "GitConfigParser":
+        """Set the given option in section to the given value.
+
+        This will create the section if required, and will not throw as opposed to the
+        default ConfigParser ``set`` method.
+
+        :param section:
+            Name of the section in which the option resides or should reside.
+
+        :param option:
+            Name of the options whose value to set.
+
+        :param value:
+            Value to set the option to. It must be a string or convertible to a string.
+
+        :return:
+            This instance
+        """
+        if not self.has_section(section):
+            self.add_section(section)
+        self.set(section, option, self._value_to_string(value))
+        return self
+
+    @needs_values
+    @set_dirty_and_flush_changes
+    def add_value(self, section: str, option: str, value: Union[str, bytes, int, float, bool]) -> "GitConfigParser":
+        """Add a value for the given option in section.
+
+        This will create the section if required, and will not throw as opposed to the
+        default ConfigParser ``set`` method. The value becomes the new value of the
+        option as returned by :meth:`get_value`, and appends to the list of values
+        returned by :meth:`get_values`.
+
+        :param section:
+            Name of the section in which the option resides or should reside.
+
+        :param option:
+            Name of the option.
+
+        :param value:
+            Value to add to option. It must be a string or convertible to a string.
+
+        :return:
+            This instance
+        """
+        if not self.has_section(section):
+            self.add_section(section)
+        self._sections[section].add(option, self._value_to_string(value))
+        return self
+
+    def rename_section(self, section: str, new_name: str) -> "GitConfigParser":
+        """Rename the given section to `new_name`.
+
+        :raise ValueError:
+            If:
+
+            * `section` doesn't exist.
+            * A section with `new_name` does already exist.
+
+        :return:
+            This instance
+        """
+        if not self.has_section(section):
+            raise ValueError("Source section '%s' doesn't exist" % section)
+        if self.has_section(new_name):
+            raise ValueError("Destination section '%s' already exists" % new_name)
+
+        super().add_section(new_name)
+        new_section = self._sections[new_name]
+        for k, vs in self.items_all(section):
+            new_section.setall(k, vs)
+        # END for each value to copy
+
+        # This call writes back the changes, which is why we don't have the respective
+        # decorator.
+        self.remove_section(section)
+        return self
diff --git a/llm/Lib/site-packages/git/db.py b/llm/Lib/site-packages/git/db.py
new file mode 100644
index 0000000000000000000000000000000000000000..cacd030d0c7e29b1dc373aff2f73b1b40b92426a
--- /dev/null
+++ b/llm/Lib/site-packages/git/db.py
@@ -0,0 +1,71 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Module with our own gitdb implementation - it uses the git command."""
+
+__all__ = ["GitCmdObjectDB", "GitDB"]
+
+from gitdb.base import OInfo, OStream
+from gitdb.db import GitDB, LooseObjectDB
+from gitdb.exc import BadObject
+
+from git.util import bin_to_hex, hex_to_bin
+from git.exc import GitCommandError
+
+# typing-------------------------------------------------
+
+from typing import TYPE_CHECKING
+
+from git.types import PathLike
+
+if TYPE_CHECKING:
+    from git.cmd import Git
+
+# --------------------------------------------------------
+
+
+class GitCmdObjectDB(LooseObjectDB):
+    """A database representing the default git object store, which includes loose
+    objects, pack files and an alternates file.
+
+    It will create objects only in the loose object database.
+    """
+
+    def __init__(self, root_path: PathLike, git: "Git") -> None:
+        """Initialize this instance with the root and a git command."""
+        super().__init__(root_path)
+        self._git = git
+
+    def info(self, binsha: bytes) -> OInfo:
+        """Get a git object header (using git itself)."""
+        hexsha, typename, size = self._git.get_object_header(bin_to_hex(binsha))
+        return OInfo(hex_to_bin(hexsha), typename, size)
+
+    def stream(self, binsha: bytes) -> OStream:
+        """Get git object data as a stream supporting ``read()`` (using git itself)."""
+        hexsha, typename, size, stream = self._git.stream_object_data(bin_to_hex(binsha))
+        return OStream(hex_to_bin(hexsha), typename, size, stream)
+
+    # { Interface
+
+    def partial_to_complete_sha_hex(self, partial_hexsha: str) -> bytes:
+        """
+        :return:
+            Full binary 20 byte sha from the given partial hexsha
+
+        :raise gitdb.exc.AmbiguousObjectName:
+
+        :raise gitdb.exc.BadObject:
+
+        :note:
+            Currently we only raise :exc:`~gitdb.exc.BadObject` as git does not
+            communicate ambiguous objects separately.
+        """
+        try:
+            hexsha, _typename, _size = self._git.get_object_header(partial_hexsha)
+            return hex_to_bin(hexsha)
+        except (GitCommandError, ValueError) as e:
+            raise BadObject(partial_hexsha) from e
+        # END handle exceptions
+
+    # } END interface
diff --git a/llm/Lib/site-packages/git/diff.py b/llm/Lib/site-packages/git/diff.py
new file mode 100644
index 0000000000000000000000000000000000000000..f89b12d9854371e7a975892b562cbd046ae2a0f5
--- /dev/null
+++ b/llm/Lib/site-packages/git/diff.py
@@ -0,0 +1,775 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+__all__ = ["DiffConstants", "NULL_TREE", "INDEX", "Diffable", "DiffIndex", "Diff"]
+
+import enum
+import re
+import warnings
+
+from git.cmd import handle_process_output
+from git.compat import defenc
+from git.objects.blob import Blob
+from git.objects.util import mode_str_to_int
+from git.util import finalize_process, hex_to_bin
+
+# typing ------------------------------------------------------------------
+
+from typing import (
+    Any,
+    Iterator,
+    List,
+    Match,
+    Optional,
+    Tuple,
+    TYPE_CHECKING,
+    TypeVar,
+    Union,
+    cast,
+)
+from git.types import Literal, PathLike
+
+if TYPE_CHECKING:
+    from subprocess import Popen
+
+    from git.cmd import Git
+    from git.objects.base import IndexObject
+    from git.objects.commit import Commit
+    from git.objects.tree import Tree
+    from git.repo.base import Repo
+
+Lit_change_type = Literal["A", "D", "C", "M", "R", "T", "U"]
+
+# ------------------------------------------------------------------------
+
+
+@enum.unique
+class DiffConstants(enum.Enum):
+    """Special objects for :meth:`Diffable.diff`.
+
+    See the :meth:`Diffable.diff` method's ``other`` parameter, which accepts various
+    values including these.
+
+    :note:
+        These constants are also available as attributes of the :mod:`git.diff` module,
+        the :class:`Diffable` class and its subclasses and instances, and the top-level
+        :mod:`git` module.
+    """
+
+    NULL_TREE = enum.auto()
+    """Stand-in indicating you want to compare against the empty tree in diffs.
+
+    Also accessible as :const:`git.NULL_TREE`, :const:`git.diff.NULL_TREE`, and
+    :const:`Diffable.NULL_TREE`.
+    """
+
+    INDEX = enum.auto()
+    """Stand-in indicating you want to diff against the index.
+
+    Also accessible as :const:`git.INDEX`, :const:`git.diff.INDEX`, and
+    :const:`Diffable.INDEX`, as well as :const:`Diffable.Index`. The latter has been
+    kept for backward compatibility and made an alias of this, so it may still be used.
+    """
+
+
+NULL_TREE: Literal[DiffConstants.NULL_TREE] = DiffConstants.NULL_TREE
+"""Stand-in indicating you want to compare against the empty tree in diffs.
+
+See :meth:`Diffable.diff`, which accepts this as a value of its ``other`` parameter.
+
+This is an alias of :const:`DiffConstants.NULL_TREE`, which may also be accessed as
+:const:`git.NULL_TREE` and :const:`Diffable.NULL_TREE`.
+"""
+
+INDEX: Literal[DiffConstants.INDEX] = DiffConstants.INDEX
+"""Stand-in indicating you want to diff against the index.
+
+See :meth:`Diffable.diff`, which accepts this as a value of its ``other`` parameter.
+
+This is an alias of :const:`DiffConstants.INDEX`, which may also be accessed as
+:const:`git.INDEX` and :const:`Diffable.INDEX`, as well as :const:`Diffable.Index`.
+"""
+
+_octal_byte_re = re.compile(rb"\\([0-9]{3})")
+
+
+def _octal_repl(matchobj: Match) -> bytes:
+    value = matchobj.group(1)
+    value = int(value, 8)
+    value = bytes(bytearray((value,)))
+    return value
+
+
+def decode_path(path: bytes, has_ab_prefix: bool = True) -> Optional[bytes]:
+    if path == b"/dev/null":
+        return None
+
+    if path.startswith(b'"') and path.endswith(b'"'):
+        path = path[1:-1].replace(b"\\n", b"\n").replace(b"\\t", b"\t").replace(b'\\"', b'"').replace(b"\\\\", b"\\")
+
+    path = _octal_byte_re.sub(_octal_repl, path)
+
+    if has_ab_prefix:
+        assert path.startswith(b"a/") or path.startswith(b"b/")
+        path = path[2:]
+
+    return path
+
+
+class Diffable:
+    """Common interface for all objects that can be diffed against another object of
+    compatible type.
+
+    :note:
+        Subclasses require a :attr:`repo` member, as it is the case for
+        :class:`~git.objects.base.Object` instances. For practical reasons we do not
+        derive from :class:`~git.objects.base.Object`.
+    """
+
+    __slots__ = ()
+
+    repo: "Repo"
+    """Repository to operate on. Must be provided by subclass or sibling class."""
+
+    NULL_TREE = NULL_TREE
+    """Stand-in indicating you want to compare against the empty tree in diffs.
+
+    See the :meth:`diff` method, which accepts this as a value of its ``other``
+    parameter.
+
+    This is the same as :const:`DiffConstants.NULL_TREE`, and may also be accessed as
+    :const:`git.NULL_TREE` and :const:`git.diff.NULL_TREE`.
+    """
+
+    INDEX = INDEX
+    """Stand-in indicating you want to diff against the index.
+
+    See the :meth:`diff` method, which accepts this as a value of its ``other``
+    parameter.
+
+    This is the same as :const:`DiffConstants.INDEX`, and may also be accessed as
+    :const:`git.INDEX` and :const:`git.diff.INDEX`, as well as :class:`Diffable.INDEX`,
+    which is kept for backward compatibility (it is now defined an alias of this).
+    """
+
+    Index = INDEX
+    """Stand-in indicating you want to diff against the index
+    (same as :const:`~Diffable.INDEX`).
+
+    This is an alias of :const:`~Diffable.INDEX`, for backward compatibility. See
+    :const:`~Diffable.INDEX` and :meth:`diff` for details.
+
+    :note:
+        Although always meant for use as an opaque constant, this was formerly defined
+        as a class. Its usage is unchanged, but static type annotations that attempt
+        to permit only this object must be changed to avoid new mypy errors. This was
+        previously not possible to do, though ``Type[Diffable.Index]`` approximated it.
+        It is now possible to do precisely, using ``Literal[DiffConstants.INDEX]``.
+    """
+
+    def _process_diff_args(
+        self,
+        args: List[Union[PathLike, "Diffable"]],
+    ) -> List[Union[PathLike, "Diffable"]]:
+        """
+        :return:
+            Possibly altered version of the given args list.
+            This method is called right before git command execution.
+            Subclasses can use it to alter the behaviour of the superclass.
+        """
+        return args
+
+    def diff(
+        self,
+        other: Union[DiffConstants, "Tree", "Commit", str, None] = INDEX,
+        paths: Union[PathLike, List[PathLike], Tuple[PathLike, ...], None] = None,
+        create_patch: bool = False,
+        **kwargs: Any,
+    ) -> "DiffIndex":
+        """Create diffs between two items being trees, trees and index or an index and
+        the working tree. Detects renames automatically.
+
+        :param other:
+            This the item to compare us with.
+
+            * If ``None``, we will be compared to the working tree.
+
+            * If a :class:`~git.types.Tree_ish` or string, it will be compared against
+              the respective tree.
+
+            * If :const:`INDEX`, it will be compared against the index.
+
+            * If :const:`NULL_TREE`, it will compare against the empty tree.
+
+            This parameter defaults to :const:`INDEX` (rather than ``None``) so that the
+            method will not by default fail on bare repositories.
+
+        :param paths:
+            This a list of paths or a single path to limit the diff to. It will only
+            include at least one of the given path or paths.
+
+        :param create_patch:
+            If ``True``, the returned :class:`Diff` contains a detailed patch that if
+            applied makes the self to other. Patches are somewhat costly as blobs have
+            to be read and diffed.
+
+        :param kwargs:
+            Additional arguments passed to :manpage:`git-diff(1)`, such as ``R=True`` to
+            swap both sides of the diff.
+
+        :return:
+            A :class:`DiffIndex` representing the computed diff.
+
+        :note:
+            On a bare repository, `other` needs to be provided as :const:`INDEX`, or as
+            an instance of :class:`~git.objects.tree.Tree` or
+            :class:`~git.objects.commit.Commit`, or a git command error will occur.
+        """
+        args: List[Union[PathLike, Diffable]] = []
+        args.append("--abbrev=40")  # We need full shas.
+        args.append("--full-index")  # Get full index paths, not only filenames.
+
+        # Remove default '-M' arg (check for renames) if user is overriding it.
+        if not any(x in kwargs for x in ("find_renames", "no_renames", "M")):
+            args.append("-M")
+
+        if create_patch:
+            args.append("-p")
+            args.append("--no-ext-diff")
+        else:
+            args.append("--raw")
+            args.append("-z")
+
+        # Ensure we never see colored output.
+        # Fixes: https://github.com/gitpython-developers/GitPython/issues/172
+        args.append("--no-color")
+
+        if paths is not None and not isinstance(paths, (tuple, list)):
+            paths = [paths]
+
+        diff_cmd = self.repo.git.diff
+        if other is INDEX:
+            args.insert(0, "--cached")
+        elif other is NULL_TREE:
+            args.insert(0, "-r")  # Recursive diff-tree.
+            args.insert(0, "--root")
+            diff_cmd = self.repo.git.diff_tree
+        elif other is not None:
+            args.insert(0, "-r")  # Recursive diff-tree.
+            args.insert(0, other)
+            diff_cmd = self.repo.git.diff_tree
+
+        args.insert(0, self)
+
+        # paths is a list or tuple here, or None.
+        if paths:
+            args.append("--")
+            args.extend(paths)
+        # END paths handling
+
+        kwargs["as_process"] = True
+        proc = diff_cmd(*self._process_diff_args(args), **kwargs)
+
+        diff_method = Diff._index_from_patch_format if create_patch else Diff._index_from_raw_format
+        index = diff_method(self.repo, proc)
+
+        proc.wait()
+        return index
+
+
+T_Diff = TypeVar("T_Diff", bound="Diff")
+
+
+class DiffIndex(List[T_Diff]):
+    R"""An index for diffs, allowing a list of :class:`Diff`\s to be queried by the diff
+    properties.
+
+    The class improves the diff handling convenience.
+    """
+
+    change_type = ("A", "C", "D", "R", "M", "T")
+    """Change type invariant identifying possible ways a blob can have changed:
+
+    * ``A`` = Added
+    * ``D`` = Deleted
+    * ``R`` = Renamed
+    * ``M`` = Modified
+    * ``T`` = Changed in the type
+    """
+
+    def iter_change_type(self, change_type: Lit_change_type) -> Iterator[T_Diff]:
+        """
+        :return:
+            Iterator yielding :class:`Diff` instances that match the given `change_type`
+
+        :param change_type:
+            Member of :attr:`DiffIndex.change_type`, namely:
+
+            * 'A' for added paths
+            * 'D' for deleted paths
+            * 'R' for renamed paths
+            * 'M' for paths with modified data
+            * 'T' for changed in the type paths
+        """
+        if change_type not in self.change_type:
+            raise ValueError("Invalid change type: %s" % change_type)
+
+        for diffidx in self:
+            if diffidx.change_type == change_type:
+                yield diffidx
+            elif change_type == "A" and diffidx.new_file:
+                yield diffidx
+            elif change_type == "D" and diffidx.deleted_file:
+                yield diffidx
+            elif change_type == "C" and diffidx.copied_file:
+                yield diffidx
+            elif change_type == "R" and diffidx.renamed:
+                yield diffidx
+            elif change_type == "M" and diffidx.a_blob and diffidx.b_blob and diffidx.a_blob != diffidx.b_blob:
+                yield diffidx
+        # END for each diff
+
+
+class Diff:
+    """A Diff contains diff information between two Trees.
+
+    It contains two sides a and b of the diff. Members are prefixed with "a" and "b"
+    respectively to indicate that.
+
+    Diffs keep information about the changed blob objects, the file mode, renames,
+    deletions and new files.
+
+    There are a few cases where ``None`` has to be expected as member variable value:
+
+    New File::
+
+        a_mode is None
+        a_blob is None
+        a_path is None
+
+    Deleted File::
+
+        b_mode is None
+        b_blob is None
+        b_path is None
+
+    Working Tree Blobs:
+
+        When comparing to working trees, the working tree blob will have a null hexsha
+        as a corresponding object does not yet exist. The mode will be null as well. The
+        path will be available, though.
+
+        If it is listed in a diff, the working tree version of the file must differ from
+        the version in the index or tree, and hence has been modified.
+    """
+
+    # Precompiled regex.
+    re_header = re.compile(
+        rb"""
+                                ^diff[ ]--git
+                                    [ ](?P<a_path_fallback>"?[ab]/.+?"?)[ ](?P<b_path_fallback>"?[ab]/.+?"?)\n
+                                (?:^old[ ]mode[ ](?P<old_mode>\d+)\n
+                                   ^new[ ]mode[ ](?P<new_mode>\d+)(?:\n|$))?
+                                (?:^similarity[ ]index[ ]\d+%\n
+                                   ^rename[ ]from[ ](?P<rename_from>.*)\n
+                                   ^rename[ ]to[ ](?P<rename_to>.*)(?:\n|$))?
+                                (?:^new[ ]file[ ]mode[ ](?P<new_file_mode>.+)(?:\n|$))?
+                                (?:^deleted[ ]file[ ]mode[ ](?P<deleted_file_mode>.+)(?:\n|$))?
+                                (?:^similarity[ ]index[ ]\d+%\n
+                                   ^copy[ ]from[ ].*\n
+                                   ^copy[ ]to[ ](?P<copied_file_name>.*)(?:\n|$))?
+                                (?:^index[ ](?P<a_blob_id>[0-9A-Fa-f]+)
+                                    \.\.(?P<b_blob_id>[0-9A-Fa-f]+)[ ]?(?P<b_mode>.+)?(?:\n|$))?
+                                (?:^---[ ](?P<a_path>[^\t\n\r\f\v]*)[\t\r\f\v]*(?:\n|$))?
+                                (?:^\+\+\+[ ](?P<b_path>[^\t\n\r\f\v]*)[\t\r\f\v]*(?:\n|$))?
+                            """,
+        re.VERBOSE | re.MULTILINE,
+    )
+
+    # These can be used for comparisons.
+    NULL_HEX_SHA = "0" * 40
+    NULL_BIN_SHA = b"\0" * 20
+
+    __slots__ = (
+        "a_blob",
+        "b_blob",
+        "a_mode",
+        "b_mode",
+        "a_rawpath",
+        "b_rawpath",
+        "new_file",
+        "deleted_file",
+        "copied_file",
+        "raw_rename_from",
+        "raw_rename_to",
+        "diff",
+        "change_type",
+        "score",
+    )
+
+    def __init__(
+        self,
+        repo: "Repo",
+        a_rawpath: Optional[bytes],
+        b_rawpath: Optional[bytes],
+        a_blob_id: Union[str, bytes, None],
+        b_blob_id: Union[str, bytes, None],
+        a_mode: Union[bytes, str, None],
+        b_mode: Union[bytes, str, None],
+        new_file: bool,
+        deleted_file: bool,
+        copied_file: bool,
+        raw_rename_from: Optional[bytes],
+        raw_rename_to: Optional[bytes],
+        diff: Union[str, bytes, None],
+        change_type: Optional[Lit_change_type],
+        score: Optional[int],
+    ) -> None:
+        assert a_rawpath is None or isinstance(a_rawpath, bytes)
+        assert b_rawpath is None or isinstance(b_rawpath, bytes)
+        self.a_rawpath = a_rawpath
+        self.b_rawpath = b_rawpath
+
+        self.a_mode = mode_str_to_int(a_mode) if a_mode else None
+        self.b_mode = mode_str_to_int(b_mode) if b_mode else None
+
+        # Determine whether this diff references a submodule. If it does then
+        # we need to overwrite "repo" to the corresponding submodule's repo instead.
+        if repo and a_rawpath:
+            for submodule in repo.submodules:
+                if submodule.path == a_rawpath.decode(defenc, "replace"):
+                    if submodule.module_exists():
+                        repo = submodule.module()
+                    break
+
+        self.a_blob: Union["IndexObject", None]
+        if a_blob_id is None or a_blob_id == self.NULL_HEX_SHA:
+            self.a_blob = None
+        else:
+            self.a_blob = Blob(repo, hex_to_bin(a_blob_id), mode=self.a_mode, path=self.a_path)
+
+        self.b_blob: Union["IndexObject", None]
+        if b_blob_id is None or b_blob_id == self.NULL_HEX_SHA:
+            self.b_blob = None
+        else:
+            self.b_blob = Blob(repo, hex_to_bin(b_blob_id), mode=self.b_mode, path=self.b_path)
+
+        self.new_file: bool = new_file
+        self.deleted_file: bool = deleted_file
+        self.copied_file: bool = copied_file
+
+        # Be clear and use None instead of empty strings.
+        assert raw_rename_from is None or isinstance(raw_rename_from, bytes)
+        assert raw_rename_to is None or isinstance(raw_rename_to, bytes)
+        self.raw_rename_from = raw_rename_from or None
+        self.raw_rename_to = raw_rename_to or None
+
+        self.diff = diff
+        self.change_type: Union[Lit_change_type, None] = change_type
+        self.score = score
+
+    def __eq__(self, other: object) -> bool:
+        for name in self.__slots__:
+            if getattr(self, name) != getattr(other, name):
+                return False
+        # END for each name
+        return True
+
+    def __ne__(self, other: object) -> bool:
+        return not (self == other)
+
+    def __hash__(self) -> int:
+        return hash(tuple(getattr(self, n) for n in self.__slots__))
+
+    def __str__(self) -> str:
+        h = "%s"
+        if self.a_blob:
+            h %= self.a_blob.path
+        elif self.b_blob:
+            h %= self.b_blob.path
+
+        msg = ""
+        line = None
+        line_length = 0
+        for b, n in zip((self.a_blob, self.b_blob), ("lhs", "rhs")):
+            if b:
+                line = "\n%s: %o | %s" % (n, b.mode, b.hexsha)
+            else:
+                line = "\n%s: None" % n
+            # END if blob is not None
+            line_length = max(len(line), line_length)
+            msg += line
+        # END for each blob
+
+        # Add headline.
+        h += "\n" + "=" * line_length
+
+        if self.deleted_file:
+            msg += "\nfile deleted in rhs"
+        if self.new_file:
+            msg += "\nfile added in rhs"
+        if self.copied_file:
+            msg += "\nfile %r copied from %r" % (self.b_path, self.a_path)
+        if self.rename_from:
+            msg += "\nfile renamed from %r" % self.rename_from
+        if self.rename_to:
+            msg += "\nfile renamed to %r" % self.rename_to
+        if self.diff:
+            msg += "\n---"
+            try:
+                msg += self.diff.decode(defenc) if isinstance(self.diff, bytes) else self.diff
+            except UnicodeDecodeError:
+                msg += "OMITTED BINARY DATA"
+            # END handle encoding
+            msg += "\n---"
+        # END diff info
+
+        return h + msg
+
+    @property
+    def a_path(self) -> Optional[str]:
+        return self.a_rawpath.decode(defenc, "replace") if self.a_rawpath else None
+
+    @property
+    def b_path(self) -> Optional[str]:
+        return self.b_rawpath.decode(defenc, "replace") if self.b_rawpath else None
+
+    @property
+    def rename_from(self) -> Optional[str]:
+        return self.raw_rename_from.decode(defenc, "replace") if self.raw_rename_from else None
+
+    @property
+    def rename_to(self) -> Optional[str]:
+        return self.raw_rename_to.decode(defenc, "replace") if self.raw_rename_to else None
+
+    @property
+    def renamed(self) -> bool:
+        """Deprecated, use :attr:`renamed_file` instead.
+
+        :return:
+            ``True`` if the blob of our diff has been renamed
+
+        :note:
+            This property is deprecated.
+            Please use the :attr:`renamed_file` property instead.
+        """
+        warnings.warn(
+            "Diff.renamed is deprecated, use Diff.renamed_file instead",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.renamed_file
+
+    @property
+    def renamed_file(self) -> bool:
+        """:return: ``True`` if the blob of our diff has been renamed"""
+        return self.rename_from != self.rename_to
+
+    @classmethod
+    def _pick_best_path(cls, path_match: bytes, rename_match: bytes, path_fallback_match: bytes) -> Optional[bytes]:
+        if path_match:
+            return decode_path(path_match)
+
+        if rename_match:
+            return decode_path(rename_match, has_ab_prefix=False)
+
+        if path_fallback_match:
+            return decode_path(path_fallback_match)
+
+        return None
+
+    @classmethod
+    def _index_from_patch_format(cls, repo: "Repo", proc: Union["Popen", "Git.AutoInterrupt"]) -> DiffIndex:
+        """Create a new :class:`DiffIndex` from the given process output which must be
+        in patch format.
+
+        :param repo:
+            The repository we are operating on.
+
+        :param proc:
+            :manpage:`git-diff(1)` process to read from
+            (supports :class:`Git.AutoInterrupt <git.cmd.Git.AutoInterrupt>` wrapper).
+
+        :return:
+            :class:`DiffIndex`
+        """
+
+        # FIXME: Here SLURPING raw, need to re-phrase header-regexes linewise.
+        text_list: List[bytes] = []
+        handle_process_output(proc, text_list.append, None, finalize_process, decode_streams=False)
+
+        # For now, we have to bake the stream.
+        text = b"".join(text_list)
+        index: "DiffIndex" = DiffIndex()
+        previous_header: Union[Match[bytes], None] = None
+        header: Union[Match[bytes], None] = None
+        a_path, b_path = None, None  # For mypy.
+        a_mode, b_mode = None, None  # For mypy.
+        for _header in cls.re_header.finditer(text):
+            (
+                a_path_fallback,
+                b_path_fallback,
+                old_mode,
+                new_mode,
+                rename_from,
+                rename_to,
+                new_file_mode,
+                deleted_file_mode,
+                copied_file_name,
+                a_blob_id,
+                b_blob_id,
+                b_mode,
+                a_path,
+                b_path,
+            ) = _header.groups()
+
+            new_file, deleted_file, copied_file = (
+                bool(new_file_mode),
+                bool(deleted_file_mode),
+                bool(copied_file_name),
+            )
+
+            a_path = cls._pick_best_path(a_path, rename_from, a_path_fallback)
+            b_path = cls._pick_best_path(b_path, rename_to, b_path_fallback)
+
+            # Our only means to find the actual text is to see what has not been matched
+            # by our regex, and then retro-actively assign it to our index.
+            if previous_header is not None:
+                index[-1].diff = text[previous_header.end() : _header.start()]
+            # END assign actual diff
+
+            # Make sure the mode is set if the path is set. Otherwise the resulting blob
+            # is invalid. We just use the one mode we should have parsed.
+            a_mode = old_mode or deleted_file_mode or (a_path and (b_mode or new_mode or new_file_mode))
+            b_mode = b_mode or new_mode or new_file_mode or (b_path and a_mode)
+            index.append(
+                Diff(
+                    repo,
+                    a_path,
+                    b_path,
+                    a_blob_id and a_blob_id.decode(defenc),
+                    b_blob_id and b_blob_id.decode(defenc),
+                    a_mode and a_mode.decode(defenc),
+                    b_mode and b_mode.decode(defenc),
+                    new_file,
+                    deleted_file,
+                    copied_file,
+                    rename_from,
+                    rename_to,
+                    None,
+                    None,
+                    None,
+                )
+            )
+
+            previous_header = _header
+            header = _header
+        # END for each header we parse
+        if index and header:
+            index[-1].diff = text[header.end() :]
+        # END assign last diff
+
+        return index
+
+    @staticmethod
+    def _handle_diff_line(lines_bytes: bytes, repo: "Repo", index: DiffIndex) -> None:
+        lines = lines_bytes.decode(defenc)
+
+        # Discard everything before the first colon, and the colon itself.
+        _, _, lines = lines.partition(":")
+
+        for line in lines.split("\x00:"):
+            if not line:
+                # The line data is empty, skip.
+                continue
+            meta, _, path = line.partition("\x00")
+            path = path.rstrip("\x00")
+            a_blob_id: Optional[str]
+            b_blob_id: Optional[str]
+            old_mode, new_mode, a_blob_id, b_blob_id, _change_type = meta.split(None, 4)
+            # Change type can be R100
+            # R: status letter
+            # 100: score (in case of copy and rename)
+            change_type: Lit_change_type = cast(Lit_change_type, _change_type[0])
+            score_str = "".join(_change_type[1:])
+            score = int(score_str) if score_str.isdigit() else None
+            path = path.strip()
+            a_path = path.encode(defenc)
+            b_path = path.encode(defenc)
+            deleted_file = False
+            new_file = False
+            copied_file = False
+            rename_from = None
+            rename_to = None
+
+            # NOTE: We cannot conclude from the existence of a blob to change type,
+            # as diffs with the working do not have blobs yet.
+            if change_type == "D":
+                b_blob_id = None  # Optional[str]
+                deleted_file = True
+            elif change_type == "A":
+                a_blob_id = None
+                new_file = True
+            elif change_type == "C":
+                copied_file = True
+                a_path_str, b_path_str = path.split("\x00", 1)
+                a_path = a_path_str.encode(defenc)
+                b_path = b_path_str.encode(defenc)
+            elif change_type == "R":
+                a_path_str, b_path_str = path.split("\x00", 1)
+                a_path = a_path_str.encode(defenc)
+                b_path = b_path_str.encode(defenc)
+                rename_from, rename_to = a_path, b_path
+            elif change_type == "T":
+                # Nothing to do.
+                pass
+            # END add/remove handling
+
+            diff = Diff(
+                repo,
+                a_path,
+                b_path,
+                a_blob_id,
+                b_blob_id,
+                old_mode,
+                new_mode,
+                new_file,
+                deleted_file,
+                copied_file,
+                rename_from,
+                rename_to,
+                "",
+                change_type,
+                score,
+            )
+            index.append(diff)
+
+    @classmethod
+    def _index_from_raw_format(cls, repo: "Repo", proc: "Popen") -> "DiffIndex":
+        """Create a new :class:`DiffIndex` from the given process output which must be
+        in raw format.
+
+        :param repo:
+            The repository we are operating on.
+
+        :param proc:
+            Process to read output from.
+
+        :return:
+            :class:`DiffIndex`
+        """
+        # handles
+        # :100644 100644 687099101... 37c5e30c8... M    .gitignore
+
+        index: "DiffIndex" = DiffIndex()
+        handle_process_output(
+            proc,
+            lambda byt: cls._handle_diff_line(byt, repo, index),
+            None,
+            finalize_process,
+            decode_streams=False,
+        )
+
+        return index
diff --git a/llm/Lib/site-packages/git/exc.py b/llm/Lib/site-packages/git/exc.py
new file mode 100644
index 0000000000000000000000000000000000000000..583eee8c13bf757274180ee388be63ce8ef65f62
--- /dev/null
+++ b/llm/Lib/site-packages/git/exc.py
@@ -0,0 +1,228 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Exceptions thrown throughout the git package."""
+
+__all__ = [
+    # Defined in gitdb.exc:
+    "AmbiguousObjectName",
+    "BadName",
+    "BadObject",
+    "BadObjectType",
+    "InvalidDBRoot",
+    "ODBError",
+    "ParseError",
+    "UnsupportedOperation",
+    # Introduced in this module:
+    "GitError",
+    "InvalidGitRepositoryError",
+    "WorkTreeRepositoryUnsupported",
+    "NoSuchPathError",
+    "UnsafeProtocolError",
+    "UnsafeOptionError",
+    "CommandError",
+    "GitCommandNotFound",
+    "GitCommandError",
+    "CheckoutError",
+    "CacheError",
+    "UnmergedEntriesError",
+    "HookExecutionError",
+    "RepositoryDirtyError",
+]
+
+from gitdb.exc import (
+    AmbiguousObjectName,
+    BadName,
+    BadObject,
+    BadObjectType,
+    InvalidDBRoot,
+    ODBError,
+    ParseError,
+    UnsupportedOperation,
+)
+
+from git.compat import safe_decode
+from git.util import remove_password_if_present
+
+# typing ----------------------------------------------------
+
+from typing import List, Sequence, Tuple, TYPE_CHECKING, Union
+
+from git.types import PathLike
+
+if TYPE_CHECKING:
+    from git.repo.base import Repo
+
+# ------------------------------------------------------------------
+
+
+class GitError(Exception):
+    """Base class for all package exceptions."""
+
+
+class InvalidGitRepositoryError(GitError):
+    """Thrown if the given repository appears to have an invalid format."""
+
+
+class WorkTreeRepositoryUnsupported(InvalidGitRepositoryError):
+    """Thrown to indicate we can't handle work tree repositories."""
+
+
+class NoSuchPathError(GitError, OSError):
+    """Thrown if a path could not be access by the system."""
+
+
+class UnsafeProtocolError(GitError):
+    """Thrown if unsafe protocols are passed without being explicitly allowed."""
+
+
+class UnsafeOptionError(GitError):
+    """Thrown if unsafe options are passed without being explicitly allowed."""
+
+
+class CommandError(GitError):
+    """Base class for exceptions thrown at every stage of :class:`~subprocess.Popen`
+    execution.
+
+    :param command:
+        A non-empty list of argv comprising the command-line.
+    """
+
+    _msg = "Cmd('%s') failed%s"
+    """Format string with 2 ``%s`` for ``<cmdline>`` and the rest.
+
+    For example: ``"'%s' failed%s"``
+
+    Subclasses may override this attribute, provided it is still in this form.
+    """
+
+    def __init__(
+        self,
+        command: Union[List[str], Tuple[str, ...], str],
+        status: Union[str, int, None, Exception] = None,
+        stderr: Union[bytes, str, None] = None,
+        stdout: Union[bytes, str, None] = None,
+    ) -> None:
+        if not isinstance(command, (tuple, list)):
+            command = command.split()
+        self.command = remove_password_if_present(command)
+        self.status = status
+        if status:
+            if isinstance(status, Exception):
+                status = "%s('%s')" % (type(status).__name__, safe_decode(str(status)))
+            else:
+                try:
+                    status = "exit code(%s)" % int(status)
+                except (ValueError, TypeError):
+                    s = safe_decode(str(status))
+                    status = "'%s'" % s if isinstance(status, str) else s
+
+        self._cmd = safe_decode(self.command[0])
+        self._cmdline = " ".join(safe_decode(i) for i in self.command)
+        self._cause = status and " due to: %s" % status or "!"
+        stdout_decode = safe_decode(stdout)
+        stderr_decode = safe_decode(stderr)
+        self.stdout = stdout_decode and "\n  stdout: '%s'" % stdout_decode or ""
+        self.stderr = stderr_decode and "\n  stderr: '%s'" % stderr_decode or ""
+
+    def __str__(self) -> str:
+        return (self._msg + "\n  cmdline: %s%s%s") % (
+            self._cmd,
+            self._cause,
+            self._cmdline,
+            self.stdout,
+            self.stderr,
+        )
+
+
+class GitCommandNotFound(CommandError):
+    """Thrown if we cannot find the ``git`` executable in the :envvar:`PATH` or at the
+    path given by the :envvar:`GIT_PYTHON_GIT_EXECUTABLE` environment variable."""
+
+    def __init__(self, command: Union[List[str], Tuple[str], str], cause: Union[str, Exception]) -> None:
+        super().__init__(command, cause)
+        self._msg = "Cmd('%s') not found%s"
+
+
+class GitCommandError(CommandError):
+    """Thrown if execution of the git command fails with non-zero status code."""
+
+    def __init__(
+        self,
+        command: Union[List[str], Tuple[str, ...], str],
+        status: Union[str, int, None, Exception] = None,
+        stderr: Union[bytes, str, None] = None,
+        stdout: Union[bytes, str, None] = None,
+    ) -> None:
+        super().__init__(command, status, stderr, stdout)
+
+
+class CheckoutError(GitError):
+    """Thrown if a file could not be checked out from the index as it contained
+    changes.
+
+    The :attr:`failed_files` attribute contains a list of relative paths that failed to
+    be checked out as they contained changes that did not exist in the index.
+
+    The :attr:`failed_reasons` attribute contains a string informing about the actual
+    cause of the issue.
+
+    The :attr:`valid_files` attribute contains a list of relative paths to files that
+    were checked out successfully and hence match the version stored in the index.
+    """
+
+    def __init__(
+        self,
+        message: str,
+        failed_files: Sequence[PathLike],
+        valid_files: Sequence[PathLike],
+        failed_reasons: List[str],
+    ) -> None:
+        Exception.__init__(self, message)
+        self.failed_files = failed_files
+        self.failed_reasons = failed_reasons
+        self.valid_files = valid_files
+
+    def __str__(self) -> str:
+        return Exception.__str__(self) + ":%s" % self.failed_files
+
+
+class CacheError(GitError):
+    """Base for all errors related to the git index, which is called "cache"
+    internally."""
+
+
+class UnmergedEntriesError(CacheError):
+    """Thrown if an operation cannot proceed as there are still unmerged
+    entries in the cache."""
+
+
+class HookExecutionError(CommandError):
+    """Thrown if a hook exits with a non-zero exit code.
+
+    This provides access to the exit code and the string returned via standard output.
+    """
+
+    def __init__(
+        self,
+        command: Union[List[str], Tuple[str, ...], str],
+        status: Union[str, int, None, Exception],
+        stderr: Union[bytes, str, None] = None,
+        stdout: Union[bytes, str, None] = None,
+    ) -> None:
+        super().__init__(command, status, stderr, stdout)
+        self._msg = "Hook('%s') failed%s"
+
+
+class RepositoryDirtyError(GitError):
+    """Thrown whenever an operation on a repository fails as it has uncommitted changes
+    that would be overwritten."""
+
+    def __init__(self, repo: "Repo", message: str) -> None:
+        self.repo = repo
+        self.message = message
+
+    def __str__(self) -> str:
+        return "Operation cannot be performed on %r: %s" % (self.repo, self.message)
diff --git a/llm/Lib/site-packages/git/index/__init__.py b/llm/Lib/site-packages/git/index/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba48110fddcdf549b6e61f115d28b137a57cc219
--- /dev/null
+++ b/llm/Lib/site-packages/git/index/__init__.py
@@ -0,0 +1,16 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Initialize the index package."""
+
+__all__ = [
+    "BaseIndexEntry",
+    "BlobFilter",
+    "CheckoutError",
+    "IndexEntry",
+    "IndexFile",
+    "StageType",
+]
+
+from .base import CheckoutError, IndexFile
+from .typ import BaseIndexEntry, BlobFilter, IndexEntry, StageType
diff --git a/llm/Lib/site-packages/git/index/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/git/index/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..30a67b2d7d6d9a7a850f52f7014e294a27289083
Binary files /dev/null and b/llm/Lib/site-packages/git/index/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/index/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/git/index/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d69e94c45b6b608c516eebf6aec3b2c0d26e6b7b
Binary files /dev/null and b/llm/Lib/site-packages/git/index/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/index/__pycache__/fun.cpython-311.pyc b/llm/Lib/site-packages/git/index/__pycache__/fun.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8cc1553a877c837532d41c7064c296879f7db2ef
Binary files /dev/null and b/llm/Lib/site-packages/git/index/__pycache__/fun.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/index/__pycache__/typ.cpython-311.pyc b/llm/Lib/site-packages/git/index/__pycache__/typ.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..36e10873a8c799885f5cfdf69a3f6a7a5ba21f52
Binary files /dev/null and b/llm/Lib/site-packages/git/index/__pycache__/typ.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/index/__pycache__/util.cpython-311.pyc b/llm/Lib/site-packages/git/index/__pycache__/util.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..069c9452366ec47a2fc1f736fcc4892bdbcc4e18
Binary files /dev/null and b/llm/Lib/site-packages/git/index/__pycache__/util.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/index/base.py b/llm/Lib/site-packages/git/index/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..b8161ea52810ed8ba58c2c5052ac86f3517ecd18
--- /dev/null
+++ b/llm/Lib/site-packages/git/index/base.py
@@ -0,0 +1,1518 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Module containing :class:`IndexFile`, an Index implementation facilitating all kinds
+of index manipulations such as querying and merging."""
+
+__all__ = ["IndexFile", "CheckoutError", "StageType"]
+
+import contextlib
+import datetime
+import glob
+from io import BytesIO
+import os
+import os.path as osp
+from stat import S_ISLNK
+import subprocess
+import sys
+import tempfile
+
+from gitdb.base import IStream
+from gitdb.db import MemoryDB
+
+from git.compat import defenc, force_bytes
+import git.diff as git_diff
+from git.exc import CheckoutError, GitCommandError, GitError, InvalidGitRepositoryError
+from git.objects import Blob, Commit, Object, Submodule, Tree
+from git.objects.util import Serializable
+from git.util import (
+    LazyMixin,
+    LockedFD,
+    join_path_native,
+    file_contents_ro,
+    to_native_path_linux,
+    unbare_repo,
+    to_bin_sha,
+)
+
+from .fun import (
+    S_IFGITLINK,
+    aggressive_tree_merge,
+    entry_key,
+    read_cache,
+    run_commit_hook,
+    stat_mode_to_index_mode,
+    write_cache,
+    write_tree_from_cache,
+)
+from .typ import BaseIndexEntry, IndexEntry, StageType
+from .util import TemporaryFileSwap, post_clear_cache, default_index, git_working_dir
+
+# typing -----------------------------------------------------------------------------
+
+from typing import (
+    Any,
+    BinaryIO,
+    Callable,
+    Dict,
+    Generator,
+    IO,
+    Iterable,
+    Iterator,
+    List,
+    NoReturn,
+    Sequence,
+    TYPE_CHECKING,
+    Tuple,
+    Union,
+)
+
+from git.types import Literal, PathLike
+
+if TYPE_CHECKING:
+    from subprocess import Popen
+
+    from git.refs.reference import Reference
+    from git.repo import Repo
+    from git.util import Actor
+
+
+Treeish = Union[Tree, Commit, str, bytes]
+
+# ------------------------------------------------------------------------------------
+
+
+@contextlib.contextmanager
+def _named_temporary_file_for_subprocess(directory: PathLike) -> Generator[str, None, None]:
+    """Create a named temporary file git subprocesses can open, deleting it afterward.
+
+    :param directory:
+        The directory in which the file is created.
+
+    :return:
+        A context manager object that creates the file and provides its name on entry,
+        and deletes it on exit.
+    """
+    if sys.platform == "win32":
+        fd, name = tempfile.mkstemp(dir=directory)
+        os.close(fd)
+        try:
+            yield name
+        finally:
+            os.remove(name)
+    else:
+        with tempfile.NamedTemporaryFile(dir=directory) as ctx:
+            yield ctx.name
+
+
+class IndexFile(LazyMixin, git_diff.Diffable, Serializable):
+    """An Index that can be manipulated using a native implementation in order to save
+    git command function calls wherever possible.
+
+    This provides custom merging facilities allowing to merge without actually changing
+    your index or your working tree. This way you can perform your own test merges based
+    on the index only without having to deal with the working copy. This is useful in
+    case of partial working trees.
+
+    Entries:
+
+        The index contains an entries dict whose keys are tuples of type
+        :class:`~git.index.typ.IndexEntry` to facilitate access.
+
+        You may read the entries dict or manipulate it using IndexEntry instance, i.e.::
+
+            index.entries[index.entry_key(index_entry_instance)] = index_entry_instance
+
+    Make sure you use :meth:`index.write() <write>` once you are done manipulating the
+    index directly before operating on it using the git command.
+    """
+
+    __slots__ = ("repo", "version", "entries", "_extension_data", "_file_path")
+
+    _VERSION = 2
+    """The latest version we support."""
+
+    S_IFGITLINK = S_IFGITLINK
+    """Flags for a submodule."""
+
+    def __init__(self, repo: "Repo", file_path: Union[PathLike, None] = None) -> None:
+        """Initialize this Index instance, optionally from the given `file_path`.
+
+        If no `file_path` is given, we will be created from the current index file.
+
+        If a stream is not given, the stream will be initialized from the current
+        repository's index on demand.
+        """
+        self.repo = repo
+        self.version = self._VERSION
+        self._extension_data = b""
+        self._file_path: PathLike = file_path or self._index_path()
+
+    def _set_cache_(self, attr: str) -> None:
+        if attr == "entries":
+            try:
+                fd = os.open(self._file_path, os.O_RDONLY)
+            except OSError:
+                # In new repositories, there may be no index, which means we are empty.
+                self.entries: Dict[Tuple[PathLike, StageType], IndexEntry] = {}
+                return
+            # END exception handling
+
+            try:
+                stream = file_contents_ro(fd, stream=True, allow_mmap=True)
+            finally:
+                os.close(fd)
+
+            self._deserialize(stream)
+        else:
+            super()._set_cache_(attr)
+
+    def _index_path(self) -> PathLike:
+        if self.repo.git_dir:
+            return join_path_native(self.repo.git_dir, "index")
+        else:
+            raise GitCommandError("No git directory given to join index path")
+
+    @property
+    def path(self) -> PathLike:
+        """:return: Path to the index file we are representing"""
+        return self._file_path
+
+    def _delete_entries_cache(self) -> None:
+        """Safely clear the entries cache so it can be recreated."""
+        try:
+            del self.entries
+        except AttributeError:
+            # It failed in Python 2.6.5 with AttributeError.
+            # FIXME: Look into whether we can just remove this except clause now.
+            pass
+        # END exception handling
+
+    # { Serializable Interface
+
+    def _deserialize(self, stream: IO) -> "IndexFile":
+        """Initialize this instance with index values read from the given stream."""
+        self.version, self.entries, self._extension_data, _conten_sha = read_cache(stream)
+        return self
+
+    def _entries_sorted(self) -> List[IndexEntry]:
+        """:return: List of entries, in a sorted fashion, first by path, then by stage"""
+        return sorted(self.entries.values(), key=lambda e: (e.path, e.stage))
+
+    def _serialize(self, stream: IO, ignore_extension_data: bool = False) -> "IndexFile":
+        entries = self._entries_sorted()
+        extension_data = self._extension_data  # type: Union[None, bytes]
+        if ignore_extension_data:
+            extension_data = None
+        write_cache(entries, stream, extension_data)
+        return self
+
+    # } END serializable interface
+
+    def write(
+        self,
+        file_path: Union[None, PathLike] = None,
+        ignore_extension_data: bool = False,
+    ) -> None:
+        """Write the current state to our file path or to the given one.
+
+        :param file_path:
+            If ``None``, we will write to our stored file path from which we have been
+            initialized. Otherwise we write to the given file path. Please note that
+            this will change the `file_path` of this index to the one you gave.
+
+        :param ignore_extension_data:
+            If ``True``, the TREE type extension data read in the index will not be
+            written to disk. NOTE that no extension data is actually written. Use this
+            if you have altered the index and would like to use
+            :manpage:`git-write-tree(1)` afterwards to create a tree representing your
+            written changes. If this data is present in the written index,
+            :manpage:`git-write-tree(1)` will instead write the stored/cached tree.
+            Alternatively, use :meth:`write_tree` to handle this case automatically.
+        """
+        # Make sure we have our entries read before getting a write lock.
+        # Otherwise it would be done when streaming.
+        # This can happen if one doesn't change the index, but writes it right away.
+        self.entries  # noqa: B018
+        lfd = LockedFD(file_path or self._file_path)
+        stream = lfd.open(write=True, stream=True)
+
+        try:
+            self._serialize(stream, ignore_extension_data)
+        except BaseException:
+            lfd.rollback()
+            raise
+
+        lfd.commit()
+
+        # Make sure we represent what we have written.
+        if file_path is not None:
+            self._file_path = file_path
+
+    @post_clear_cache
+    @default_index
+    def merge_tree(self, rhs: Treeish, base: Union[None, Treeish] = None) -> "IndexFile":
+        """Merge the given `rhs` treeish into the current index, possibly taking
+        a common base treeish into account.
+
+        As opposed to the :func:`from_tree` method, this allows you to use an already
+        existing tree as the left side of the merge.
+
+        :param rhs:
+            Treeish reference pointing to the 'other' side of the merge.
+
+        :param base:
+            Optional treeish reference pointing to the common base of `rhs` and this
+            index which equals lhs.
+
+        :return:
+            self (containing the merge and possibly unmerged entries in case of
+            conflicts)
+
+        :raise git.exc.GitCommandError:
+            If there is a merge conflict. The error will be raised at the first
+            conflicting path. If you want to have proper merge resolution to be done by
+            yourself, you have to commit the changed index (or make a valid tree from
+            it) and retry with a three-way :meth:`index.from_tree <from_tree>` call.
+        """
+        # -i : ignore working tree status
+        # --aggressive : handle more merge cases
+        # -m : do an actual merge
+        args: List[Union[Treeish, str]] = ["--aggressive", "-i", "-m"]
+        if base is not None:
+            args.append(base)
+        args.append(rhs)
+
+        self.repo.git.read_tree(args)
+        return self
+
+    @classmethod
+    def new(cls, repo: "Repo", *tree_sha: Union[str, Tree]) -> "IndexFile":
+        """Merge the given treeish revisions into a new index which is returned.
+
+        This method behaves like ``git-read-tree --aggressive`` when doing the merge.
+
+        :param repo:
+            The repository treeish are located in.
+
+        :param tree_sha:
+            20 byte or 40 byte tree sha or tree objects.
+
+        :return:
+            New :class:`IndexFile` instance. Its path will be undefined.
+            If you intend to write such a merged Index, supply an alternate
+            ``file_path`` to its :meth:`write` method.
+        """
+        tree_sha_bytes: List[bytes] = [to_bin_sha(str(t)) for t in tree_sha]
+        base_entries = aggressive_tree_merge(repo.odb, tree_sha_bytes)
+
+        inst = cls(repo)
+        # Convert to entries dict.
+        entries: Dict[Tuple[PathLike, int], IndexEntry] = dict(
+            zip(
+                ((e.path, e.stage) for e in base_entries),
+                (IndexEntry.from_base(e) for e in base_entries),
+            )
+        )
+
+        inst.entries = entries
+        return inst
+
+    @classmethod
+    def from_tree(cls, repo: "Repo", *treeish: Treeish, **kwargs: Any) -> "IndexFile":
+        R"""Merge the given treeish revisions into a new index which is returned.
+        The original index will remain unaltered.
+
+        :param repo:
+            The repository treeish are located in.
+
+        :param treeish:
+            One, two or three :class:`~git.objects.tree.Tree` objects,
+            :class:`~git.objects.commit.Commit`\s or 40 byte hexshas.
+
+            The result changes according to the amount of trees:
+
+            1. If 1 Tree is given, it will just be read into a new index.
+            2. If 2 Trees are given, they will be merged into a new index using a two
+               way merge algorithm. Tree 1 is the 'current' tree, tree 2 is the 'other'
+               one. It behaves like a fast-forward.
+            3. If 3 Trees are given, a 3-way merge will be performed with the first tree
+               being the common ancestor of tree 2 and tree 3. Tree 2 is the 'current'
+               tree, tree 3 is the 'other' one.
+
+        :param kwargs:
+            Additional arguments passed to :manpage:`git-read-tree(1)`.
+
+        :return:
+            New :class:`IndexFile` instance. It will point to a temporary index location
+            which does not exist anymore. If you intend to write such a merged Index,
+            supply an alternate ``file_path`` to its :meth:`write` method.
+
+        :note:
+            In the three-way merge case, ``--aggressive`` will be specified to
+            automatically resolve more cases in a commonly correct manner. Specify
+            ``trivial=True`` as a keyword argument to override that.
+
+            As the underlying :manpage:`git-read-tree(1)` command takes into account the
+            current index, it will be temporarily moved out of the way to prevent any
+            unexpected interference.
+        """
+        if len(treeish) == 0 or len(treeish) > 3:
+            raise ValueError("Please specify between 1 and 3 treeish, got %i" % len(treeish))
+
+        arg_list: List[Union[Treeish, str]] = []
+        # Ignore that the working tree and index possibly are out of date.
+        if len(treeish) > 1:
+            # Drop unmerged entries when reading our index and merging.
+            arg_list.append("--reset")
+            # Handle non-trivial cases the way a real merge does.
+            arg_list.append("--aggressive")
+        # END merge handling
+
+        # Create the temporary file in the .git directory to be sure renaming
+        # works - /tmp/ directories could be on another device.
+        with _named_temporary_file_for_subprocess(repo.git_dir) as tmp_index:
+            arg_list.append("--index-output=%s" % tmp_index)
+            arg_list.extend(treeish)
+
+            # Move the current index out of the way - otherwise the merge may fail as it
+            # considers existing entries. Moving it essentially clears the index.
+            # Unfortunately there is no 'soft' way to do it.
+            # The TemporaryFileSwap ensures the original file gets put back.
+            with TemporaryFileSwap(join_path_native(repo.git_dir, "index")):
+                repo.git.read_tree(*arg_list, **kwargs)
+                index = cls(repo, tmp_index)
+                index.entries  # noqa: B018 # Force it to read the file as we will delete the temp-file.
+                return index
+            # END index merge handling
+
+    # UTILITIES
+
+    @unbare_repo
+    def _iter_expand_paths(self: "IndexFile", paths: Sequence[PathLike]) -> Iterator[PathLike]:
+        """Expand the directories in list of paths to the corresponding paths
+        accordingly.
+
+        :note:
+            git will add items multiple times even if a glob overlapped with manually
+            specified paths or if paths where specified multiple times - we respect that
+            and do not prune.
+        """
+
+        def raise_exc(e: Exception) -> NoReturn:
+            raise e
+
+        r = str(self.repo.working_tree_dir)
+        rs = r + os.sep
+        for path in paths:
+            abs_path = str(path)
+            if not osp.isabs(abs_path):
+                abs_path = osp.join(r, path)
+            # END make absolute path
+
+            try:
+                st = os.lstat(abs_path)  # Handles non-symlinks as well.
+            except OSError:
+                # The lstat call may fail as the path may contain globs as well.
+                pass
+            else:
+                if S_ISLNK(st.st_mode):
+                    yield abs_path.replace(rs, "")
+                    continue
+            # END check symlink
+
+            # If the path is not already pointing to an existing file, resolve globs if possible.
+            if not os.path.exists(abs_path) and ("?" in abs_path or "*" in abs_path or "[" in abs_path):
+                resolved_paths = glob.glob(abs_path)
+                # not abs_path in resolved_paths:
+                #   A glob() resolving to the same path we are feeding it with is a
+                #   glob() that failed to resolve. If we continued calling ourselves
+                #   we'd endlessly recurse. If the condition below evaluates to true
+                #   then we are likely dealing with a file whose name contains wildcard
+                #   characters.
+                if abs_path not in resolved_paths:
+                    for f in self._iter_expand_paths(glob.glob(abs_path)):
+                        yield str(f).replace(rs, "")
+                    continue
+            # END glob handling
+            try:
+                for root, _dirs, files in os.walk(abs_path, onerror=raise_exc):
+                    for rela_file in files:
+                        # Add relative paths only.
+                        yield osp.join(root.replace(rs, ""), rela_file)
+                    # END for each file in subdir
+                # END for each subdirectory
+            except OSError:
+                # It was a file or something that could not be iterated.
+                yield abs_path.replace(rs, "")
+            # END path exception handling
+        # END for each path
+
+    def _write_path_to_stdin(
+        self,
+        proc: "Popen",
+        filepath: PathLike,
+        item: PathLike,
+        fmakeexc: Callable[..., GitError],
+        fprogress: Callable[[PathLike, bool, PathLike], None],
+        read_from_stdout: bool = True,
+    ) -> Union[None, str]:
+        """Write path to ``proc.stdin`` and make sure it processes the item, including
+        progress.
+
+        :return:
+            stdout string
+
+        :param read_from_stdout:
+            If ``True``, ``proc.stdout`` will be read after the item was sent to stdin.
+            In that case, it will return ``None``.
+
+        :note:
+            There is a bug in :manpage:`git-update-index(1)` that prevents it from
+            sending reports just in time. This is why we have a version that tries to
+            read stdout and one which doesn't. In fact, the stdout is not important as
+            the piped-in files are processed anyway and just in time.
+
+        :note:
+            Newlines are essential here, git's behaviour is somewhat inconsistent on
+            this depending on the version, hence we try our best to deal with newlines
+            carefully. Usually the last newline will not be sent, instead we will close
+            stdin to break the pipe.
+        """
+        fprogress(filepath, False, item)
+        rval: Union[None, str] = None
+
+        if proc.stdin is not None:
+            try:
+                proc.stdin.write(("%s\n" % filepath).encode(defenc))
+            except IOError as e:
+                # Pipe broke, usually because some error happened.
+                raise fmakeexc() from e
+            # END write exception handling
+            proc.stdin.flush()
+
+        if read_from_stdout and proc.stdout is not None:
+            rval = proc.stdout.readline().strip()
+        fprogress(filepath, True, item)
+        return rval
+
+    def iter_blobs(
+        self, predicate: Callable[[Tuple[StageType, Blob]], bool] = lambda t: True
+    ) -> Iterator[Tuple[StageType, Blob]]:
+        """
+        :return:
+            Iterator yielding tuples of :class:`~git.objects.blob.Blob` objects and
+            stages, tuple(stage, Blob).
+
+        :param predicate:
+            Function(t) returning ``True`` if tuple(stage, Blob) should be yielded by
+            the iterator. A default filter, the `~git.index.typ.BlobFilter`, allows you
+            to yield blobs only if they match a given list of paths.
+        """
+        for entry in self.entries.values():
+            blob = entry.to_blob(self.repo)
+            blob.size = entry.size
+            output = (entry.stage, blob)
+            if predicate(output):
+                yield output
+        # END for each entry
+
+    def unmerged_blobs(self) -> Dict[PathLike, List[Tuple[StageType, Blob]]]:
+        """
+        :return:
+            Dict(path : list(tuple(stage, Blob, ...))), being a dictionary associating a
+            path in the index with a list containing sorted stage/blob pairs.
+
+        :note:
+            Blobs that have been removed in one side simply do not exist in the given
+            stage. That is, a file removed on the 'other' branch whose entries are at
+            stage 3 will not have a stage 3 entry.
+        """
+        is_unmerged_blob = lambda t: t[0] != 0
+        path_map: Dict[PathLike, List[Tuple[StageType, Blob]]] = {}
+        for stage, blob in self.iter_blobs(is_unmerged_blob):
+            path_map.setdefault(blob.path, []).append((stage, blob))
+        # END for each unmerged blob
+        for line in path_map.values():
+            line.sort()
+
+        return path_map
+
+    @classmethod
+    def entry_key(cls, *entry: Union[BaseIndexEntry, PathLike, StageType]) -> Tuple[PathLike, StageType]:
+        return entry_key(*entry)
+
+    def resolve_blobs(self, iter_blobs: Iterator[Blob]) -> "IndexFile":
+        """Resolve the blobs given in blob iterator.
+
+        This will effectively remove the index entries of the respective path at all
+        non-null stages and add the given blob as new stage null blob.
+
+        For each path there may only be one blob, otherwise a :exc:`ValueError` will be
+        raised claiming the path is already at stage 0.
+
+        :raise ValueError:
+            If one of the blobs already existed at stage 0.
+
+        :return:
+            self
+
+        :note:
+            You will have to write the index manually once you are done, i.e.
+            ``index.resolve_blobs(blobs).write()``.
+        """
+        for blob in iter_blobs:
+            stage_null_key = (blob.path, 0)
+            if stage_null_key in self.entries:
+                raise ValueError("Path %r already exists at stage 0" % str(blob.path))
+            # END assert blob is not stage 0 already
+
+            # Delete all possible stages.
+            for stage in (1, 2, 3):
+                try:
+                    del self.entries[(blob.path, stage)]
+                except KeyError:
+                    pass
+                # END ignore key errors
+            # END for each possible stage
+
+            self.entries[stage_null_key] = IndexEntry.from_blob(blob)
+        # END for each blob
+
+        return self
+
+    def update(self) -> "IndexFile":
+        """Reread the contents of our index file, discarding all cached information
+        we might have.
+
+        :note:
+            This is a possibly dangerous operations as it will discard your changes to
+            :attr:`index.entries <entries>`.
+
+        :return:
+            self
+        """
+        self._delete_entries_cache()
+        # Allows to lazily reread on demand.
+        return self
+
+    def write_tree(self) -> Tree:
+        """Write this index to a corresponding :class:`~git.objects.tree.Tree` object
+        into the repository's object database and return it.
+
+        :return:
+            :class:`~git.objects.tree.Tree` object representing this index.
+
+        :note:
+            The tree will be written even if one or more objects the tree refers to does
+            not yet exist in the object database. This could happen if you added entries
+            to the index directly.
+
+        :raise ValueError:
+            If there are no entries in the cache.
+
+        :raise git.exc.UnmergedEntriesError:
+        """
+        # We obtain no lock as we just flush our contents to disk as tree.
+        # If we are a new index, the entries access will load our data accordingly.
+        mdb = MemoryDB()
+        entries = self._entries_sorted()
+        binsha, tree_items = write_tree_from_cache(entries, mdb, slice(0, len(entries)))
+
+        # Copy changed trees only.
+        mdb.stream_copy(mdb.sha_iter(), self.repo.odb)
+
+        # Note: Additional deserialization could be saved if write_tree_from_cache would
+        # return sorted tree entries.
+        root_tree = Tree(self.repo, binsha, path="")
+        root_tree._cache = tree_items
+        return root_tree
+
+    def _process_diff_args(
+        self,
+        args: List[Union[PathLike, "git_diff.Diffable"]],
+    ) -> List[Union[PathLike, "git_diff.Diffable"]]:
+        try:
+            args.pop(args.index(self))
+        except IndexError:
+            pass
+        # END remove self
+        return args
+
+    def _to_relative_path(self, path: PathLike) -> PathLike:
+        """
+        :return:
+            Version of path relative to our git directory or raise :exc:`ValueError` if
+            it is not within our git directory.
+
+        :raise ValueError:
+        """
+        if not osp.isabs(path):
+            return path
+        if self.repo.bare:
+            raise InvalidGitRepositoryError("require non-bare repository")
+        if not str(path).startswith(str(self.repo.working_tree_dir)):
+            raise ValueError("Absolute path %r is not in git repository at %r" % (path, self.repo.working_tree_dir))
+        return os.path.relpath(path, self.repo.working_tree_dir)
+
+    def _preprocess_add_items(
+        self, items: Sequence[Union[PathLike, Blob, BaseIndexEntry, "Submodule"]]
+    ) -> Tuple[List[PathLike], List[BaseIndexEntry]]:
+        """Split the items into two lists of path strings and BaseEntries."""
+        paths = []
+        entries = []
+        # if it is a string put in list
+        if isinstance(items, (str, os.PathLike)):
+            items = [items]
+
+        for item in items:
+            if isinstance(item, (str, os.PathLike)):
+                paths.append(self._to_relative_path(item))
+            elif isinstance(item, (Blob, Submodule)):
+                entries.append(BaseIndexEntry.from_blob(item))
+            elif isinstance(item, BaseIndexEntry):
+                entries.append(item)
+            else:
+                raise TypeError("Invalid Type: %r" % item)
+        # END for each item
+        return paths, entries
+
+    def _store_path(self, filepath: PathLike, fprogress: Callable) -> BaseIndexEntry:
+        """Store file at filepath in the database and return the base index entry.
+
+        :note:
+            This needs the :func:`~git.index.util.git_working_dir` decorator active!
+            This must be ensured in the calling code.
+        """
+        st = os.lstat(filepath)  # Handles non-symlinks as well.
+        if S_ISLNK(st.st_mode):
+            # In PY3, readlink is a string, but we need bytes.
+            # In PY2, it was just OS encoded bytes, we assumed UTF-8.
+            open_stream: Callable[[], BinaryIO] = lambda: BytesIO(force_bytes(os.readlink(filepath), encoding=defenc))
+        else:
+            open_stream = lambda: open(filepath, "rb")
+        with open_stream() as stream:
+            fprogress(filepath, False, filepath)
+            istream = self.repo.odb.store(IStream(Blob.type, st.st_size, stream))
+            fprogress(filepath, True, filepath)
+        return BaseIndexEntry(
+            (
+                stat_mode_to_index_mode(st.st_mode),
+                istream.binsha,
+                0,
+                to_native_path_linux(filepath),
+            )
+        )
+
+    @unbare_repo
+    @git_working_dir
+    def _entries_for_paths(
+        self,
+        paths: List[str],
+        path_rewriter: Union[Callable, None],
+        fprogress: Callable,
+        entries: List[BaseIndexEntry],
+    ) -> List[BaseIndexEntry]:
+        entries_added: List[BaseIndexEntry] = []
+        if path_rewriter:
+            for path in paths:
+                if osp.isabs(path):
+                    abspath = path
+                    gitrelative_path = path[len(str(self.repo.working_tree_dir)) + 1 :]
+                else:
+                    gitrelative_path = path
+                    if self.repo.working_tree_dir:
+                        abspath = osp.join(self.repo.working_tree_dir, gitrelative_path)
+                # END obtain relative and absolute paths
+
+                blob = Blob(
+                    self.repo,
+                    Blob.NULL_BIN_SHA,
+                    stat_mode_to_index_mode(os.stat(abspath).st_mode),
+                    to_native_path_linux(gitrelative_path),
+                )
+                # TODO: variable undefined
+                entries.append(BaseIndexEntry.from_blob(blob))
+            # END for each path
+            del paths[:]
+        # END rewrite paths
+
+        # HANDLE PATHS
+        assert len(entries_added) == 0
+        for filepath in self._iter_expand_paths(paths):
+            entries_added.append(self._store_path(filepath, fprogress))
+        # END for each filepath
+        # END path handling
+        return entries_added
+
+    def add(
+        self,
+        items: Sequence[Union[PathLike, Blob, BaseIndexEntry, "Submodule"]],
+        force: bool = True,
+        fprogress: Callable = lambda *args: None,
+        path_rewriter: Union[Callable[..., PathLike], None] = None,
+        write: bool = True,
+        write_extension_data: bool = False,
+    ) -> List[BaseIndexEntry]:
+        R"""Add files from the working tree, specific blobs, or
+        :class:`~git.index.typ.BaseIndexEntry`\s to the index.
+
+        :param items:
+            Multiple types of items are supported, types can be mixed within one call.
+            Different types imply a different handling. File paths may generally be
+            relative or absolute.
+
+            - path string
+
+                Strings denote a relative or absolute path into the repository pointing
+                to an existing file, e.g., ``CHANGES``, `lib/myfile.ext``,
+                ``/home/gitrepo/lib/myfile.ext``.
+
+                Absolute paths must start with working tree directory of this index's
+                repository to be considered valid. For example, if it was initialized
+                with a non-normalized path, like ``/root/repo/../repo``, absolute paths
+                to be added must start with ``/root/repo/../repo``.
+
+                Paths provided like this must exist. When added, they will be written
+                into the object database.
+
+                PathStrings may contain globs, such as ``lib/__init__*``. Or they can be
+                directories like ``lib``, which will add all the files within the
+                directory and subdirectories.
+
+                This equals a straight :manpage:`git-add(1)`.
+
+                They are added at stage 0.
+
+            - :class:~`git.objects.blob.Blob` or
+              :class:`~git.objects.submodule.base.Submodule` object
+
+                Blobs are added as they are assuming a valid mode is set.
+
+                The file they refer to may or may not exist in the file system, but must
+                be a path relative to our repository.
+
+                If their sha is null (40*0), their path must exist in the file system
+                relative to the git repository as an object will be created from the
+                data at the path.
+
+                The handling now very much equals the way string paths are processed,
+                except that the mode you have set will be kept. This allows you to
+                create symlinks by settings the mode respectively and writing the target
+                of the symlink directly into the file. This equals a default Linux
+                symlink which is not dereferenced automatically, except that it can be
+                created on filesystems not supporting it as well.
+
+                Please note that globs or directories are not allowed in
+                :class:`~git.objects.blob.Blob` objects.
+
+                They are added at stage 0.
+
+            - :class:`~git.index.typ.BaseIndexEntry` or type
+
+                Handling equals the one of :class:~`git.objects.blob.Blob` objects, but
+                the stage may be explicitly set. Please note that Index Entries require
+                binary sha's.
+
+        :param force:
+            **CURRENTLY INEFFECTIVE**
+            If ``True``, otherwise ignored or excluded files will be added anyway. As
+            opposed to the :manpage:`git-add(1)` command, we enable this flag by default
+            as the API user usually wants the item to be added even though they might be
+            excluded.
+
+        :param fprogress:
+            Function with signature ``f(path, done=False, item=item)`` called for each
+            path to be added, one time once it is about to be added where ``done=False``
+            and once after it was added where ``done=True``.
+
+            ``item`` is set to the actual item we handle, either a path or a
+            :class:`~git.index.typ.BaseIndexEntry`.
+
+            Please note that the processed path is not guaranteed to be present in the
+            index already as the index is currently being processed.
+
+        :param path_rewriter:
+            Function, with signature ``(string) func(BaseIndexEntry)``, returning a path
+            for each passed entry which is the path to be actually recorded for the
+            object created from :attr:`entry.path <git.index.typ.BaseIndexEntry.path>`.
+            This allows you to write an index which is not identical to the layout of
+            the actual files on your hard-disk. If not ``None`` and `items` contain
+            plain paths, these paths will be converted to Entries beforehand and passed
+            to the path_rewriter. Please note that ``entry.path`` is relative to the git
+            repository.
+
+        :param write:
+            If ``True``, the index will be written once it was altered. Otherwise the
+            changes only exist in memory and are not available to git commands.
+
+        :param write_extension_data:
+            If ``True``, extension data will be written back to the index. This can lead
+            to issues in case it is containing the 'TREE' extension, which will cause
+            the :manpage:`git-commit(1)` command to write an old tree, instead of a new
+            one representing the now changed index.
+
+            This doesn't matter if you use :meth:`IndexFile.commit`, which ignores the
+            'TREE' extension altogether. You should set it to ``True`` if you intend to
+            use :meth:`IndexFile.commit` exclusively while maintaining support for
+            third-party extensions. Besides that, you can usually safely ignore the
+            built-in extensions when using GitPython on repositories that are not
+            handled manually at all.
+
+            All current built-in extensions are listed here:
+            https://git-scm.com/docs/index-format
+
+        :return:
+            List of :class:`~git.index.typ.BaseIndexEntry`\s representing the entries
+            just actually added.
+
+        :raise OSError:
+            If a supplied path did not exist. Please note that
+            :class:`~git.index.typ.BaseIndexEntry` objects that do not have a null sha
+            will be added even if their paths do not exist.
+        """
+        # Sort the entries into strings and Entries.
+        # Blobs are converted to entries automatically.
+        # Paths can be git-added. For everything else we use git-update-index.
+        paths, entries = self._preprocess_add_items(items)
+        entries_added: List[BaseIndexEntry] = []
+        # This code needs a working tree, so we try not to run it unless required.
+        # That way, we are OK on a bare repository as well.
+        # If there are no paths, the rewriter has nothing to do either.
+        if paths:
+            entries_added.extend(self._entries_for_paths(paths, path_rewriter, fprogress, entries))
+
+        # HANDLE ENTRIES
+        if entries:
+            null_mode_entries = [e for e in entries if e.mode == 0]
+            if null_mode_entries:
+                raise ValueError(
+                    "At least one Entry has a null-mode - please use index.remove to remove files for clarity"
+                )
+            # END null mode should be remove
+
+            # HANDLE ENTRY OBJECT CREATION
+            # Create objects if required, otherwise go with the existing shas.
+            null_entries_indices = [i for i, e in enumerate(entries) if e.binsha == Object.NULL_BIN_SHA]
+            if null_entries_indices:
+
+                @git_working_dir
+                def handle_null_entries(self: "IndexFile") -> None:
+                    for ei in null_entries_indices:
+                        null_entry = entries[ei]
+                        new_entry = self._store_path(null_entry.path, fprogress)
+
+                        # Update null entry.
+                        entries[ei] = BaseIndexEntry(
+                            (
+                                null_entry.mode,
+                                new_entry.binsha,
+                                null_entry.stage,
+                                null_entry.path,
+                            )
+                        )
+                    # END for each entry index
+
+                # END closure
+
+                handle_null_entries(self)
+            # END null_entry handling
+
+            # REWRITE PATHS
+            # If we have to rewrite the entries, do so now, after we have generated all
+            # object sha's.
+            if path_rewriter:
+                for i, e in enumerate(entries):
+                    entries[i] = BaseIndexEntry((e.mode, e.binsha, e.stage, path_rewriter(e)))
+                # END for each entry
+            # END handle path rewriting
+
+            # Just go through the remaining entries and provide progress info.
+            for i, entry in enumerate(entries):
+                progress_sent = i in null_entries_indices
+                if not progress_sent:
+                    fprogress(entry.path, False, entry)
+                    fprogress(entry.path, True, entry)
+                # END handle progress
+            # END for each entry
+            entries_added.extend(entries)
+        # END if there are base entries
+
+        # FINALIZE
+        # Add the new entries to this instance.
+        for entry in entries_added:
+            self.entries[(entry.path, 0)] = IndexEntry.from_base(entry)
+
+        if write:
+            self.write(ignore_extension_data=not write_extension_data)
+        # END handle write
+
+        return entries_added
+
+    def _items_to_rela_paths(
+        self,
+        items: Union[PathLike, Sequence[Union[PathLike, BaseIndexEntry, Blob, Submodule]]],
+    ) -> List[PathLike]:
+        """Returns a list of repo-relative paths from the given items which
+        may be absolute or relative paths, entries or blobs."""
+        paths = []
+        # If string, put in list.
+        if isinstance(items, (str, os.PathLike)):
+            items = [items]
+
+        for item in items:
+            if isinstance(item, (BaseIndexEntry, (Blob, Submodule))):
+                paths.append(self._to_relative_path(item.path))
+            elif isinstance(item, (str, os.PathLike)):
+                paths.append(self._to_relative_path(item))
+            else:
+                raise TypeError("Invalid item type: %r" % item)
+        # END for each item
+        return paths
+
+    @post_clear_cache
+    @default_index
+    def remove(
+        self,
+        items: Sequence[Union[PathLike, Blob, BaseIndexEntry, "Submodule"]],
+        working_tree: bool = False,
+        **kwargs: Any,
+    ) -> List[str]:
+        R"""Remove the given items from the index and optionally from the working tree
+        as well.
+
+        :param items:
+            Multiple types of items are supported which may be be freely mixed.
+
+            - path string
+
+                Remove the given path at all stages. If it is a directory, you must
+                specify the ``r=True`` keyword argument to remove all file entries below
+                it. If absolute paths are given, they will be converted to a path
+                relative to the git repository directory containing the working tree
+
+                The path string may include globs, such as ``*.c``.
+
+            - :class:~`git.objects.blob.Blob` object
+
+                Only the path portion is used in this case.
+
+            - :class:`~git.index.typ.BaseIndexEntry` or compatible type
+
+                The only relevant information here is the path. The stage is ignored.
+
+        :param working_tree:
+            If ``True``, the entry will also be removed from the working tree,
+            physically removing the respective file. This may fail if there are
+            uncommitted changes in it.
+
+        :param kwargs:
+            Additional keyword arguments to be passed to :manpage:`git-rm(1)`, such as
+            ``r`` to allow recursive removal.
+
+        :return:
+            List(path_string, ...) list of repository relative paths that have been
+            removed effectively.
+
+            This is interesting to know in case you have provided a directory or globs.
+            Paths are relative to the repository.
+        """
+        args = []
+        if not working_tree:
+            args.append("--cached")
+        args.append("--")
+
+        # Preprocess paths.
+        paths = self._items_to_rela_paths(items)
+        removed_paths = self.repo.git.rm(args, paths, **kwargs).splitlines()
+
+        # Process output to gain proper paths.
+        # rm 'path'
+        return [p[4:-1] for p in removed_paths]
+
+    @post_clear_cache
+    @default_index
+    def move(
+        self,
+        items: Sequence[Union[PathLike, Blob, BaseIndexEntry, "Submodule"]],
+        skip_errors: bool = False,
+        **kwargs: Any,
+    ) -> List[Tuple[str, str]]:
+        """Rename/move the items, whereas the last item is considered the destination of
+        the move operation.
+
+        If the destination is a file, the first item (of two) must be a file as well.
+
+        If the destination is a directory, it may be preceded by one or more directories
+        or files.
+
+        The working tree will be affected in non-bare repositories.
+
+        :param items:
+            Multiple types of items are supported, please see the :meth:`remove` method
+            for reference.
+
+        :param skip_errors:
+            If ``True``, errors such as ones resulting from missing source files will be
+            skipped.
+
+        :param kwargs:
+            Additional arguments you would like to pass to :manpage:`git-mv(1)`, such as
+            ``dry_run`` or ``force``.
+
+        :return:
+            List(tuple(source_path_string, destination_path_string), ...)
+
+            A list of pairs, containing the source file moved as well as its actual
+            destination. Relative to the repository root.
+
+        :raise ValueError:
+            If only one item was given.
+
+        :raise git.exc.GitCommandError:
+            If git could not handle your request.
+        """
+        args = []
+        if skip_errors:
+            args.append("-k")
+
+        paths = self._items_to_rela_paths(items)
+        if len(paths) < 2:
+            raise ValueError("Please provide at least one source and one destination of the move operation")
+
+        was_dry_run = kwargs.pop("dry_run", kwargs.pop("n", None))
+        kwargs["dry_run"] = True
+
+        # First execute rename in dry run so the command tells us what it actually does
+        # (for later output).
+        out = []
+        mvlines = self.repo.git.mv(args, paths, **kwargs).splitlines()
+
+        # Parse result - first 0:n/2 lines are 'checking ', the remaining ones are the
+        # 'renaming' ones which we parse.
+        for ln in range(int(len(mvlines) / 2), len(mvlines)):
+            tokens = mvlines[ln].split(" to ")
+            assert len(tokens) == 2, "Too many tokens in %s" % mvlines[ln]
+
+            # [0] = Renaming x
+            # [1] = y
+            out.append((tokens[0][9:], tokens[1]))
+        # END for each line to parse
+
+        # Either prepare for the real run, or output the dry-run result.
+        if was_dry_run:
+            return out
+        # END handle dry run
+
+        # Now apply the actual operation.
+        kwargs.pop("dry_run")
+        self.repo.git.mv(args, paths, **kwargs)
+
+        return out
+
+    def commit(
+        self,
+        message: str,
+        parent_commits: Union[List[Commit], None] = None,
+        head: bool = True,
+        author: Union[None, "Actor"] = None,
+        committer: Union[None, "Actor"] = None,
+        author_date: Union[datetime.datetime, str, None] = None,
+        commit_date: Union[datetime.datetime, str, None] = None,
+        skip_hooks: bool = False,
+    ) -> Commit:
+        """Commit the current default index file, creating a
+        :class:`~git.objects.commit.Commit` object.
+
+        For more information on the arguments, see
+        :meth:`Commit.create_from_tree <git.objects.commit.Commit.create_from_tree>`.
+
+        :note:
+            If you have manually altered the :attr:`entries` member of this instance,
+            don't forget to :meth:`write` your changes to disk beforehand.
+
+        :note:
+            Passing ``skip_hooks=True`` is the equivalent of using ``-n`` or
+            ``--no-verify`` on the command line.
+
+        :return:
+            :class:`~git.objects.commit.Commit` object representing the new commit
+        """
+        if not skip_hooks:
+            run_commit_hook("pre-commit", self)
+
+            self._write_commit_editmsg(message)
+            run_commit_hook("commit-msg", self, self._commit_editmsg_filepath())
+            message = self._read_commit_editmsg()
+            self._remove_commit_editmsg()
+        tree = self.write_tree()
+        rval = Commit.create_from_tree(
+            self.repo,
+            tree,
+            message,
+            parent_commits,
+            head,
+            author=author,
+            committer=committer,
+            author_date=author_date,
+            commit_date=commit_date,
+        )
+        if not skip_hooks:
+            run_commit_hook("post-commit", self)
+        return rval
+
+    def _write_commit_editmsg(self, message: str) -> None:
+        with open(self._commit_editmsg_filepath(), "wb") as commit_editmsg_file:
+            commit_editmsg_file.write(message.encode(defenc))
+
+    def _remove_commit_editmsg(self) -> None:
+        os.remove(self._commit_editmsg_filepath())
+
+    def _read_commit_editmsg(self) -> str:
+        with open(self._commit_editmsg_filepath(), "rb") as commit_editmsg_file:
+            return commit_editmsg_file.read().decode(defenc)
+
+    def _commit_editmsg_filepath(self) -> str:
+        return osp.join(self.repo.common_dir, "COMMIT_EDITMSG")
+
+    def _flush_stdin_and_wait(cls, proc: "Popen[bytes]", ignore_stdout: bool = False) -> bytes:
+        stdin_IO = proc.stdin
+        if stdin_IO:
+            stdin_IO.flush()
+            stdin_IO.close()
+
+        stdout = b""
+        if not ignore_stdout and proc.stdout:
+            stdout = proc.stdout.read()
+
+        if proc.stdout:
+            proc.stdout.close()
+            proc.wait()
+        return stdout
+
+    @default_index
+    def checkout(
+        self,
+        paths: Union[None, Iterable[PathLike]] = None,
+        force: bool = False,
+        fprogress: Callable = lambda *args: None,
+        **kwargs: Any,
+    ) -> Union[None, Iterator[PathLike], Sequence[PathLike]]:
+        """Check out the given paths or all files from the version known to the index
+        into the working tree.
+
+        :note:
+            Be sure you have written pending changes using the :meth:`write` method in
+            case you have altered the entries dictionary directly.
+
+        :param paths:
+            If ``None``, all paths in the index will be checked out.
+            Otherwise an iterable of relative or absolute paths or a single path
+            pointing to files or directories in the index is expected.
+
+        :param force:
+            If ``True``, existing files will be overwritten even if they contain local
+            modifications.
+            If ``False``, these will trigger a :exc:`~git.exc.CheckoutError`.
+
+        :param fprogress:
+            See :meth:`IndexFile.add` for signature and explanation.
+
+            The provided progress information will contain ``None`` as path and item if
+            no explicit paths are given. Otherwise progress information will be send
+            prior and after a file has been checked out.
+
+        :param kwargs:
+            Additional arguments to be passed to :manpage:`git-checkout-index(1)`.
+
+        :return:
+            Iterable yielding paths to files which have been checked out and are
+            guaranteed to match the version stored in the index.
+
+        :raise git.exc.CheckoutError:
+            * If at least one file failed to be checked out. This is a summary, hence it
+              will checkout as many files as it can anyway.
+            * If one of files or directories do not exist in the index (as opposed to
+              the original git command, which ignores them).
+
+        :raise git.exc.GitCommandError:
+            If error lines could not be parsed - this truly is an exceptional state.
+
+        :note:
+            The checkout is limited to checking out the files in the index. Files which
+            are not in the index anymore and exist in the working tree will not be
+            deleted. This behaviour is fundamentally different to ``head.checkout``,
+            i.e. if you want :manpage:`git-checkout(1)`-like behaviour, use
+            ``head.checkout`` instead of ``index.checkout``.
+        """
+        args = ["--index"]
+        if force:
+            args.append("--force")
+
+        failed_files = []
+        failed_reasons = []
+        unknown_lines = []
+
+        def handle_stderr(proc: "Popen[bytes]", iter_checked_out_files: Iterable[PathLike]) -> None:
+            stderr_IO = proc.stderr
+            if not stderr_IO:
+                return  # Return early if stderr empty.
+
+            stderr_bytes = stderr_IO.read()
+            # line contents:
+            stderr = stderr_bytes.decode(defenc)
+            # git-checkout-index: this already exists
+            endings = (
+                " already exists",
+                " is not in the cache",
+                " does not exist at stage",
+                " is unmerged",
+            )
+            for line in stderr.splitlines():
+                if not line.startswith("git checkout-index: ") and not line.startswith("git-checkout-index: "):
+                    is_a_dir = " is a directory"
+                    unlink_issue = "unable to unlink old '"
+                    already_exists_issue = " already exists, no checkout"  # created by entry.c:checkout_entry(...)
+                    if line.endswith(is_a_dir):
+                        failed_files.append(line[: -len(is_a_dir)])
+                        failed_reasons.append(is_a_dir)
+                    elif line.startswith(unlink_issue):
+                        failed_files.append(line[len(unlink_issue) : line.rfind("'")])
+                        failed_reasons.append(unlink_issue)
+                    elif line.endswith(already_exists_issue):
+                        failed_files.append(line[: -len(already_exists_issue)])
+                        failed_reasons.append(already_exists_issue)
+                    else:
+                        unknown_lines.append(line)
+                    continue
+                # END special lines parsing
+
+                for e in endings:
+                    if line.endswith(e):
+                        failed_files.append(line[20 : -len(e)])
+                        failed_reasons.append(e)
+                        break
+                    # END if ending matches
+                # END for each possible ending
+            # END for each line
+            if unknown_lines:
+                raise GitCommandError(("git-checkout-index",), 128, stderr)
+            if failed_files:
+                valid_files = list(set(iter_checked_out_files) - set(failed_files))
+                raise CheckoutError(
+                    "Some files could not be checked out from the index due to local modifications",
+                    failed_files,
+                    valid_files,
+                    failed_reasons,
+                )
+
+        # END stderr handler
+
+        if paths is None:
+            args.append("--all")
+            kwargs["as_process"] = 1
+            fprogress(None, False, None)
+            proc = self.repo.git.checkout_index(*args, **kwargs)
+            proc.wait()
+            fprogress(None, True, None)
+            rval_iter = (e.path for e in self.entries.values())
+            handle_stderr(proc, rval_iter)
+            return rval_iter
+        else:
+            if isinstance(paths, str):
+                paths = [paths]
+
+            # Make sure we have our entries loaded before we start checkout_index, which
+            # will hold a lock on it. We try to get the lock as well during our entries
+            # initialization.
+            self.entries  # noqa: B018
+
+            args.append("--stdin")
+            kwargs["as_process"] = True
+            kwargs["istream"] = subprocess.PIPE
+            proc = self.repo.git.checkout_index(args, **kwargs)
+            # FIXME: Reading from GIL!
+            make_exc = lambda: GitCommandError(("git-checkout-index",) + tuple(args), 128, proc.stderr.read())
+            checked_out_files: List[PathLike] = []
+
+            for path in paths:
+                co_path = to_native_path_linux(self._to_relative_path(path))
+                # If the item is not in the index, it could be a directory.
+                path_is_directory = False
+
+                try:
+                    self.entries[(co_path, 0)]
+                except KeyError:
+                    folder = str(co_path)
+                    if not folder.endswith("/"):
+                        folder += "/"
+                    for entry in self.entries.values():
+                        if str(entry.path).startswith(folder):
+                            p = entry.path
+                            self._write_path_to_stdin(proc, p, p, make_exc, fprogress, read_from_stdout=False)
+                            checked_out_files.append(p)
+                            path_is_directory = True
+                        # END if entry is in directory
+                    # END for each entry
+                # END path exception handlnig
+
+                if not path_is_directory:
+                    self._write_path_to_stdin(proc, co_path, path, make_exc, fprogress, read_from_stdout=False)
+                    checked_out_files.append(co_path)
+                # END path is a file
+            # END for each path
+            try:
+                self._flush_stdin_and_wait(proc, ignore_stdout=True)
+            except GitCommandError:
+                # Without parsing stdout we don't know what failed.
+                raise CheckoutError(  # noqa: B904
+                    "Some files could not be checked out from the index, probably because they didn't exist.",
+                    failed_files,
+                    [],
+                    failed_reasons,
+                )
+
+            handle_stderr(proc, checked_out_files)
+            return checked_out_files
+        # END paths handling
+
+    @default_index
+    def reset(
+        self,
+        commit: Union[Commit, "Reference", str] = "HEAD",
+        working_tree: bool = False,
+        paths: Union[None, Iterable[PathLike]] = None,
+        head: bool = False,
+        **kwargs: Any,
+    ) -> "IndexFile":
+        """Reset the index to reflect the tree at the given commit. This will not adjust
+        our HEAD reference by default, as opposed to
+        :meth:`HEAD.reset <git.refs.head.HEAD.reset>`.
+
+        :param commit:
+            Revision, :class:`~git.refs.reference.Reference` or
+            :class:`~git.objects.commit.Commit` specifying the commit we should
+            represent.
+
+            If you want to specify a tree only, use :meth:`IndexFile.from_tree` and
+            overwrite the default index.
+
+        :param working_tree:
+            If ``True``, the files in the working tree will reflect the changed index.
+            If ``False``, the working tree will not be touched.
+            Please note that changes to the working copy will be discarded without
+            warning!
+
+        :param head:
+            If ``True``, the head will be set to the given commit. This is ``False`` by
+            default, but if ``True``, this method behaves like
+            :meth:`HEAD.reset <git.refs.head.HEAD.reset>`.
+
+        :param paths:
+            If given as an iterable of absolute or repository-relative paths, only these
+            will be reset to their state at the given commit-ish.
+            The paths need to exist at the commit, otherwise an exception will be
+            raised.
+
+        :param kwargs:
+            Additional keyword arguments passed to :manpage:`git-reset(1)`.
+
+        :note:
+            :meth:`IndexFile.reset`, as opposed to
+            :meth:`HEAD.reset <git.refs.head.HEAD.reset>`, will not delete any files in
+            order to maintain a consistent working tree. Instead, it will just check out
+            the files according to their state in the index.
+            If you want :manpage:`git-reset(1)`-like behaviour, use
+            :meth:`HEAD.reset <git.refs.head.HEAD.reset>` instead.
+
+        :return:
+            self
+        """
+        # What we actually want to do is to merge the tree into our existing index,
+        # which is what git-read-tree does.
+        new_inst = type(self).from_tree(self.repo, commit)
+        if not paths:
+            self.entries = new_inst.entries
+        else:
+            nie = new_inst.entries
+            for path in paths:
+                path = self._to_relative_path(path)
+                try:
+                    key = entry_key(path, 0)
+                    self.entries[key] = nie[key]
+                except KeyError:
+                    # If key is not in theirs, it musn't be in ours.
+                    try:
+                        del self.entries[key]
+                    except KeyError:
+                        pass
+                    # END handle deletion keyerror
+                # END handle keyerror
+            # END for each path
+        # END handle paths
+        self.write()
+
+        if working_tree:
+            self.checkout(paths=paths, force=True)
+        # END handle working tree
+
+        if head:
+            self.repo.head.set_commit(self.repo.commit(commit), logmsg="%s: Updating HEAD" % commit)
+        # END handle head change
+
+        return self
+
+    # FIXME: This is documented to accept the same parameters as Diffable.diff, but this
+    # does not handle NULL_TREE for `other`. (The suppressed mypy error is about this.)
+    def diff(
+        self,
+        other: Union[  # type: ignore[override]
+            Literal[git_diff.DiffConstants.INDEX],
+            "Tree",
+            "Commit",
+            str,
+            None,
+        ] = git_diff.INDEX,
+        paths: Union[PathLike, List[PathLike], Tuple[PathLike, ...], None] = None,
+        create_patch: bool = False,
+        **kwargs: Any,
+    ) -> git_diff.DiffIndex:
+        """Diff this index against the working copy or a :class:`~git.objects.tree.Tree`
+        or :class:`~git.objects.commit.Commit` object.
+
+        For documentation of the parameters and return values, see
+        :meth:`Diffable.diff <git.diff.Diffable.diff>`.
+
+        :note:
+            Will only work with indices that represent the default git index as they
+            have not been initialized with a stream.
+        """
+        # Only run if we are the default repository index.
+        if self._file_path != self._index_path():
+            raise AssertionError("Cannot call %r on indices that do not represent the default git index" % self.diff())
+        # Index against index is always empty.
+        if other is self.INDEX:
+            return git_diff.DiffIndex()
+
+        # Index against anything but None is a reverse diff with the respective item.
+        # Handle existing -R flags properly.
+        # Transform strings to the object so that we can call diff on it.
+        if isinstance(other, str):
+            other = self.repo.rev_parse(other)
+        # END object conversion
+
+        if isinstance(other, Object):  # For Tree or Commit.
+            # Invert the existing R flag.
+            cur_val = kwargs.get("R", False)
+            kwargs["R"] = not cur_val
+            return other.diff(self.INDEX, paths, create_patch, **kwargs)
+        # END diff against other item handling
+
+        # If other is not None here, something is wrong.
+        if other is not None:
+            raise ValueError("other must be None, Diffable.INDEX, a Tree or Commit, was %r" % other)
+
+        # Diff against working copy - can be handled by superclass natively.
+        return super().diff(other, paths, create_patch, **kwargs)
diff --git a/llm/Lib/site-packages/git/index/fun.py b/llm/Lib/site-packages/git/index/fun.py
new file mode 100644
index 0000000000000000000000000000000000000000..59cce6ae6ef845d686b4724fa99681805d9638a1
--- /dev/null
+++ b/llm/Lib/site-packages/git/index/fun.py
@@ -0,0 +1,465 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Standalone functions to accompany the index implementation and make it more
+versatile."""
+
+__all__ = [
+    "write_cache",
+    "read_cache",
+    "write_tree_from_cache",
+    "entry_key",
+    "stat_mode_to_index_mode",
+    "S_IFGITLINK",
+    "run_commit_hook",
+    "hook_path",
+]
+
+from io import BytesIO
+import os
+import os.path as osp
+from pathlib import Path
+from stat import S_IFDIR, S_IFLNK, S_IFMT, S_IFREG, S_ISDIR, S_ISLNK, S_IXUSR
+import subprocess
+import sys
+
+from gitdb.base import IStream
+from gitdb.typ import str_tree_type
+
+from git.cmd import handle_process_output, safer_popen
+from git.compat import defenc, force_bytes, force_text, safe_decode
+from git.exc import HookExecutionError, UnmergedEntriesError
+from git.objects.fun import (
+    traverse_tree_recursive,
+    traverse_trees_recursive,
+    tree_to_stream,
+)
+from git.util import IndexFileSHA1Writer, finalize_process
+
+from .typ import BaseIndexEntry, IndexEntry, CE_NAMEMASK, CE_STAGESHIFT
+from .util import pack, unpack
+
+# typing -----------------------------------------------------------------------------
+
+from typing import Dict, IO, List, Sequence, TYPE_CHECKING, Tuple, Type, Union, cast
+
+from git.types import PathLike
+
+if TYPE_CHECKING:
+    from git.db import GitCmdObjectDB
+    from git.objects.tree import TreeCacheTup
+
+    from .base import IndexFile
+
+# ------------------------------------------------------------------------------------
+
+S_IFGITLINK = S_IFLNK | S_IFDIR
+"""Flags for a submodule."""
+
+CE_NAMEMASK_INV = ~CE_NAMEMASK
+
+
+def hook_path(name: str, git_dir: PathLike) -> str:
+    """:return: path to the given named hook in the given git repository directory"""
+    return osp.join(git_dir, "hooks", name)
+
+
+def _has_file_extension(path: str) -> str:
+    return osp.splitext(path)[1]
+
+
+def run_commit_hook(name: str, index: "IndexFile", *args: str) -> None:
+    """Run the commit hook of the given name. Silently ignore hooks that do not exist.
+
+    :param name:
+        Name of hook, like ``pre-commit``.
+
+    :param index:
+        :class:`~git.index.base.IndexFile` instance.
+
+    :param args:
+        Arguments passed to hook file.
+
+    :raise git.exc.HookExecutionError:
+    """
+    hp = hook_path(name, index.repo.git_dir)
+    if not os.access(hp, os.X_OK):
+        return
+
+    env = os.environ.copy()
+    env["GIT_INDEX_FILE"] = safe_decode(str(index.path))
+    env["GIT_EDITOR"] = ":"
+    cmd = [hp]
+    try:
+        if sys.platform == "win32" and not _has_file_extension(hp):
+            # Windows only uses extensions to determine how to open files
+            # (doesn't understand shebangs). Try using bash to run the hook.
+            relative_hp = Path(hp).relative_to(index.repo.working_dir).as_posix()
+            cmd = ["bash.exe", relative_hp]
+
+        process = safer_popen(
+            cmd + list(args),
+            env=env,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            cwd=index.repo.working_dir,
+        )
+    except Exception as ex:
+        raise HookExecutionError(hp, ex) from ex
+    else:
+        stdout_list: List[str] = []
+        stderr_list: List[str] = []
+        handle_process_output(process, stdout_list.append, stderr_list.append, finalize_process)
+        stdout = "".join(stdout_list)
+        stderr = "".join(stderr_list)
+        if process.returncode != 0:
+            stdout = force_text(stdout, defenc)
+            stderr = force_text(stderr, defenc)
+            raise HookExecutionError(hp, process.returncode, stderr, stdout)
+    # END handle return code
+
+
+def stat_mode_to_index_mode(mode: int) -> int:
+    """Convert the given mode from a stat call to the corresponding index mode and
+    return it."""
+    if S_ISLNK(mode):  # symlinks
+        return S_IFLNK
+    if S_ISDIR(mode) or S_IFMT(mode) == S_IFGITLINK:  # submodules
+        return S_IFGITLINK
+    return S_IFREG | (mode & S_IXUSR and 0o755 or 0o644)  # blobs with or without executable bit
+
+
+def write_cache(
+    entries: Sequence[Union[BaseIndexEntry, "IndexEntry"]],
+    stream: IO[bytes],
+    extension_data: Union[None, bytes] = None,
+    ShaStreamCls: Type[IndexFileSHA1Writer] = IndexFileSHA1Writer,
+) -> None:
+    """Write the cache represented by entries to a stream.
+
+    :param entries:
+        **Sorted** list of entries.
+
+    :param stream:
+        Stream to wrap into the AdapterStreamCls - it is used for final output.
+
+    :param ShaStreamCls:
+        Type to use when writing to the stream. It produces a sha while writing to it,
+        before the data is passed on to the wrapped stream.
+
+    :param extension_data:
+        Any kind of data to write as a trailer, it must begin a 4 byte identifier,
+        followed by its size (4 bytes).
+    """
+    # Wrap the stream into a compatible writer.
+    stream_sha = ShaStreamCls(stream)
+
+    tell = stream_sha.tell
+    write = stream_sha.write
+
+    # Header
+    version = 2
+    write(b"DIRC")
+    write(pack(">LL", version, len(entries)))
+
+    # Body
+    for entry in entries:
+        beginoffset = tell()
+        write(entry.ctime_bytes)  # ctime
+        write(entry.mtime_bytes)  # mtime
+        path_str = str(entry.path)
+        path: bytes = force_bytes(path_str, encoding=defenc)
+        plen = len(path) & CE_NAMEMASK  # Path length
+        assert plen == len(path), "Path %s too long to fit into index" % entry.path
+        flags = plen | (entry.flags & CE_NAMEMASK_INV)  # Clear possible previous values.
+        write(
+            pack(
+                ">LLLLLL20sH",
+                entry.dev,
+                entry.inode,
+                entry.mode,
+                entry.uid,
+                entry.gid,
+                entry.size,
+                entry.binsha,
+                flags,
+            )
+        )
+        write(path)
+        real_size = (tell() - beginoffset + 8) & ~7
+        write(b"\0" * ((beginoffset + real_size) - tell()))
+    # END for each entry
+
+    # Write previously cached extensions data.
+    if extension_data is not None:
+        stream_sha.write(extension_data)
+
+    # Write the sha over the content.
+    stream_sha.write_sha()
+
+
+def read_header(stream: IO[bytes]) -> Tuple[int, int]:
+    """Return tuple(version_long, num_entries) from the given stream."""
+    type_id = stream.read(4)
+    if type_id != b"DIRC":
+        raise AssertionError("Invalid index file header: %r" % type_id)
+    unpacked = cast(Tuple[int, int], unpack(">LL", stream.read(4 * 2)))
+    version, num_entries = unpacked
+
+    # TODO: Handle version 3: extended data, see read-cache.c.
+    assert version in (1, 2)
+    return version, num_entries
+
+
+def entry_key(*entry: Union[BaseIndexEntry, PathLike, int]) -> Tuple[PathLike, int]:
+    """
+    :return:
+        Key suitable to be used for the
+        :attr:`index.entries <git.index.base.IndexFile.entries>` dictionary.
+
+    :param entry:
+        One instance of type BaseIndexEntry or the path and the stage.
+    """
+
+    # def is_entry_key_tup(entry_key: Tuple) -> TypeGuard[Tuple[PathLike, int]]:
+    #     return isinstance(entry_key, tuple) and len(entry_key) == 2
+
+    if len(entry) == 1:
+        entry_first = entry[0]
+        assert isinstance(entry_first, BaseIndexEntry)
+        return (entry_first.path, entry_first.stage)
+    else:
+        # assert is_entry_key_tup(entry)
+        entry = cast(Tuple[PathLike, int], entry)
+        return entry
+    # END handle entry
+
+
+def read_cache(
+    stream: IO[bytes],
+) -> Tuple[int, Dict[Tuple[PathLike, int], "IndexEntry"], bytes, bytes]:
+    """Read a cache file from the given stream.
+
+    :return:
+        tuple(version, entries_dict, extension_data, content_sha)
+
+        * *version* is the integer version number.
+        * *entries_dict* is a dictionary which maps IndexEntry instances to a path at a
+          stage.
+        * *extension_data* is ``""`` or 4 bytes of type + 4 bytes of size + size bytes.
+        * *content_sha* is a 20 byte sha on all cache file contents.
+    """
+    version, num_entries = read_header(stream)
+    count = 0
+    entries: Dict[Tuple[PathLike, int], "IndexEntry"] = {}
+
+    read = stream.read
+    tell = stream.tell
+    while count < num_entries:
+        beginoffset = tell()
+        ctime = unpack(">8s", read(8))[0]
+        mtime = unpack(">8s", read(8))[0]
+        (dev, ino, mode, uid, gid, size, sha, flags) = unpack(">LLLLLL20sH", read(20 + 4 * 6 + 2))
+        path_size = flags & CE_NAMEMASK
+        path = read(path_size).decode(defenc)
+
+        real_size = (tell() - beginoffset + 8) & ~7
+        read((beginoffset + real_size) - tell())
+        entry = IndexEntry((mode, sha, flags, path, ctime, mtime, dev, ino, uid, gid, size))
+        # entry_key would be the method to use, but we save the effort.
+        entries[(path, entry.stage)] = entry
+        count += 1
+    # END for each entry
+
+    # The footer contains extension data and a sha on the content so far.
+    # Keep the extension footer,and verify we have a sha in the end.
+    # Extension data format is:
+    #   4 bytes ID
+    #   4 bytes length of chunk
+    #   Repeated 0 - N times
+    extension_data = stream.read(~0)
+    assert len(extension_data) > 19, (
+        "Index Footer was not at least a sha on content as it was only %i bytes in size" % len(extension_data)
+    )
+
+    content_sha = extension_data[-20:]
+
+    # Truncate the sha in the end as we will dynamically create it anyway.
+    extension_data = extension_data[:-20]
+
+    return (version, entries, extension_data, content_sha)
+
+
+def write_tree_from_cache(
+    entries: List[IndexEntry], odb: "GitCmdObjectDB", sl: slice, si: int = 0
+) -> Tuple[bytes, List["TreeCacheTup"]]:
+    R"""Create a tree from the given sorted list of entries and put the respective
+    trees into the given object database.
+
+    :param entries:
+        **Sorted** list of :class:`~git.index.typ.IndexEntry`\s.
+
+    :param odb:
+        Object database to store the trees in.
+
+    :param si:
+        Start index at which we should start creating subtrees.
+
+    :param sl:
+        Slice indicating the range we should process on the entries list.
+
+    :return:
+        tuple(binsha, list(tree_entry, ...))
+
+        A tuple of a sha and a list of tree entries being a tuple of hexsha, mode, name.
+    """
+    tree_items: List["TreeCacheTup"] = []
+
+    ci = sl.start
+    end = sl.stop
+    while ci < end:
+        entry = entries[ci]
+        if entry.stage != 0:
+            raise UnmergedEntriesError(entry)
+        # END abort on unmerged
+        ci += 1
+        rbound = entry.path.find("/", si)
+        if rbound == -1:
+            # It's not a tree.
+            tree_items.append((entry.binsha, entry.mode, entry.path[si:]))
+        else:
+            # Find common base range.
+            base = entry.path[si:rbound]
+            xi = ci
+            while xi < end:
+                oentry = entries[xi]
+                orbound = oentry.path.find("/", si)
+                if orbound == -1 or oentry.path[si:orbound] != base:
+                    break
+                # END abort on base mismatch
+                xi += 1
+            # END find common base
+
+            # Enter recursion.
+            # ci - 1 as we want to count our current item as well.
+            sha, _tree_entry_list = write_tree_from_cache(entries, odb, slice(ci - 1, xi), rbound + 1)
+            tree_items.append((sha, S_IFDIR, base))
+
+            # Skip ahead.
+            ci = xi
+        # END handle bounds
+    # END for each entry
+
+    # Finally create the tree.
+    sio = BytesIO()
+    tree_to_stream(tree_items, sio.write)  # Writes to stream as bytes, but doesn't change tree_items.
+    sio.seek(0)
+
+    istream = odb.store(IStream(str_tree_type, len(sio.getvalue()), sio))
+    return (istream.binsha, tree_items)
+
+
+def _tree_entry_to_baseindexentry(tree_entry: "TreeCacheTup", stage: int) -> BaseIndexEntry:
+    return BaseIndexEntry((tree_entry[1], tree_entry[0], stage << CE_STAGESHIFT, tree_entry[2]))
+
+
+def aggressive_tree_merge(odb: "GitCmdObjectDB", tree_shas: Sequence[bytes]) -> List[BaseIndexEntry]:
+    R"""
+    :return:
+        List of :class:`~git.index.typ.BaseIndexEntry`\s representing the aggressive
+        merge of the given trees. All valid entries are on stage 0, whereas the
+        conflicting ones are left on stage 1, 2 or 3, whereas stage 1 corresponds to the
+        common ancestor tree, 2 to our tree and 3 to 'their' tree.
+
+    :param tree_shas:
+        1, 2 or 3 trees as identified by their binary 20 byte shas. If 1 or two, the
+        entries will effectively correspond to the last given tree. If 3 are given, a 3
+        way merge is performed.
+    """
+    out: List[BaseIndexEntry] = []
+
+    # One and two way is the same for us, as we don't have to handle an existing
+    # index, instrea
+    if len(tree_shas) in (1, 2):
+        for entry in traverse_tree_recursive(odb, tree_shas[-1], ""):
+            out.append(_tree_entry_to_baseindexentry(entry, 0))
+        # END for each entry
+        return out
+    # END handle single tree
+
+    if len(tree_shas) > 3:
+        raise ValueError("Cannot handle %i trees at once" % len(tree_shas))
+
+    # Three trees.
+    for base, ours, theirs in traverse_trees_recursive(odb, tree_shas, ""):
+        if base is not None:
+            # Base version exists.
+            if ours is not None:
+                # Ours exists.
+                if theirs is not None:
+                    # It exists in all branches. Ff it was changed in both
+                    # its a conflict. Otherwise, we take the changed version.
+                    # This should be the most common branch, so it comes first.
+                    if (base[0] != ours[0] and base[0] != theirs[0] and ours[0] != theirs[0]) or (
+                        base[1] != ours[1] and base[1] != theirs[1] and ours[1] != theirs[1]
+                    ):
+                        # Changed by both.
+                        out.append(_tree_entry_to_baseindexentry(base, 1))
+                        out.append(_tree_entry_to_baseindexentry(ours, 2))
+                        out.append(_tree_entry_to_baseindexentry(theirs, 3))
+                    elif base[0] != ours[0] or base[1] != ours[1]:
+                        # Only we changed it.
+                        out.append(_tree_entry_to_baseindexentry(ours, 0))
+                    else:
+                        # Either nobody changed it, or they did. In either
+                        # case, use theirs.
+                        out.append(_tree_entry_to_baseindexentry(theirs, 0))
+                    # END handle modification
+                else:
+                    if ours[0] != base[0] or ours[1] != base[1]:
+                        # They deleted it, we changed it, conflict.
+                        out.append(_tree_entry_to_baseindexentry(base, 1))
+                        out.append(_tree_entry_to_baseindexentry(ours, 2))
+                    # else:
+                    #   # We didn't change it, ignore.
+                    #   pass
+                    # END handle our change
+                # END handle theirs
+            else:
+                if theirs is None:
+                    # Deleted in both, its fine - it's out.
+                    pass
+                else:
+                    if theirs[0] != base[0] or theirs[1] != base[1]:
+                        # Deleted in ours, changed theirs, conflict.
+                        out.append(_tree_entry_to_baseindexentry(base, 1))
+                        out.append(_tree_entry_to_baseindexentry(theirs, 3))
+                    # END theirs changed
+                    # else:
+                    #   # Theirs didn't change.
+                    #   pass
+                # END handle theirs
+            # END handle ours
+        else:
+            # All three can't be None.
+            if ours is None:
+                # Added in their branch.
+                assert theirs is not None
+                out.append(_tree_entry_to_baseindexentry(theirs, 0))
+            elif theirs is None:
+                # Added in our branch.
+                out.append(_tree_entry_to_baseindexentry(ours, 0))
+            else:
+                # Both have it, except for the base, see whether it changed.
+                if ours[0] != theirs[0] or ours[1] != theirs[1]:
+                    out.append(_tree_entry_to_baseindexentry(ours, 2))
+                    out.append(_tree_entry_to_baseindexentry(theirs, 3))
+                else:
+                    # It was added the same in both.
+                    out.append(_tree_entry_to_baseindexentry(ours, 0))
+                # END handle two items
+            # END handle heads
+        # END handle base exists
+    # END for each entries tuple
+
+    return out
diff --git a/llm/Lib/site-packages/git/index/typ.py b/llm/Lib/site-packages/git/index/typ.py
new file mode 100644
index 0000000000000000000000000000000000000000..974252528881dcc645fa425a4f35f10bed255ce4
--- /dev/null
+++ b/llm/Lib/site-packages/git/index/typ.py
@@ -0,0 +1,202 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Additional types used by the index."""
+
+__all__ = ["BlobFilter", "BaseIndexEntry", "IndexEntry", "StageType"]
+
+from binascii import b2a_hex
+from pathlib import Path
+
+from git.objects import Blob
+
+from .util import pack, unpack
+
+# typing ----------------------------------------------------------------------
+
+from typing import NamedTuple, Sequence, TYPE_CHECKING, Tuple, Union, cast
+
+from git.types import PathLike
+
+if TYPE_CHECKING:
+    from git.repo import Repo
+
+StageType = int
+
+# ---------------------------------------------------------------------------------
+
+# { Invariants
+CE_NAMEMASK = 0x0FFF
+CE_STAGEMASK = 0x3000
+CE_EXTENDED = 0x4000
+CE_VALID = 0x8000
+CE_STAGESHIFT = 12
+
+# } END invariants
+
+
+class BlobFilter:
+    """Predicate to be used by
+    :meth:`IndexFile.iter_blobs <git.index.base.IndexFile.iter_blobs>` allowing to
+    filter only return blobs which match the given list of directories or files.
+
+    The given paths are given relative to the repository.
+    """
+
+    __slots__ = ("paths",)
+
+    def __init__(self, paths: Sequence[PathLike]) -> None:
+        """
+        :param paths:
+            Tuple or list of paths which are either pointing to directories or to files
+            relative to the current repository.
+        """
+        self.paths = paths
+
+    def __call__(self, stage_blob: Tuple[StageType, Blob]) -> bool:
+        blob_pathlike: PathLike = stage_blob[1].path
+        blob_path: Path = blob_pathlike if isinstance(blob_pathlike, Path) else Path(blob_pathlike)
+        for pathlike in self.paths:
+            path: Path = pathlike if isinstance(pathlike, Path) else Path(pathlike)
+            # TODO: Change to use `PosixPath.is_relative_to` once Python 3.8 is no
+            # longer supported.
+            filter_parts = path.parts
+            blob_parts = blob_path.parts
+            if len(filter_parts) > len(blob_parts):
+                continue
+            if all(i == j for i, j in zip(filter_parts, blob_parts)):
+                return True
+        return False
+
+
+class BaseIndexEntryHelper(NamedTuple):
+    """Typed named tuple to provide named attribute access for :class:`BaseIndexEntry`.
+
+    This is needed to allow overriding ``__new__`` in child class to preserve backwards
+    compatibility.
+    """
+
+    mode: int
+    binsha: bytes
+    flags: int
+    path: PathLike
+    ctime_bytes: bytes = pack(">LL", 0, 0)
+    mtime_bytes: bytes = pack(">LL", 0, 0)
+    dev: int = 0
+    inode: int = 0
+    uid: int = 0
+    gid: int = 0
+    size: int = 0
+
+
+class BaseIndexEntry(BaseIndexEntryHelper):
+    R"""Small brother of an index entry which can be created to describe changes
+    done to the index in which case plenty of additional information is not required.
+
+    As the first 4 data members match exactly to the :class:`IndexEntry` type, methods
+    expecting a :class:`BaseIndexEntry` can also handle full :class:`IndexEntry`\s even
+    if they use numeric indices for performance reasons.
+    """
+
+    def __new__(
+        cls,
+        inp_tuple: Union[
+            Tuple[int, bytes, int, PathLike],
+            Tuple[int, bytes, int, PathLike, bytes, bytes, int, int, int, int, int],
+        ],
+    ) -> "BaseIndexEntry":
+        """Override ``__new__`` to allow construction from a tuple for backwards
+        compatibility."""
+        return super().__new__(cls, *inp_tuple)
+
+    def __str__(self) -> str:
+        return "%o %s %i\t%s" % (self.mode, self.hexsha, self.stage, self.path)
+
+    def __repr__(self) -> str:
+        return "(%o, %s, %i, %s)" % (self.mode, self.hexsha, self.stage, self.path)
+
+    @property
+    def hexsha(self) -> str:
+        """hex version of our sha"""
+        return b2a_hex(self.binsha).decode("ascii")
+
+    @property
+    def stage(self) -> int:
+        """Stage of the entry, either:
+
+            * 0 = default stage
+            * 1 = stage before a merge or common ancestor entry in case of a 3 way merge
+            * 2 = stage of entries from the 'left' side of the merge
+            * 3 = stage of entries from the 'right' side of the merge
+
+        :note:
+            For more information, see :manpage:`git-read-tree(1)`.
+        """
+        return (self.flags & CE_STAGEMASK) >> CE_STAGESHIFT
+
+    @classmethod
+    def from_blob(cls, blob: Blob, stage: int = 0) -> "BaseIndexEntry":
+        """:return: Fully equipped BaseIndexEntry at the given stage"""
+        return cls((blob.mode, blob.binsha, stage << CE_STAGESHIFT, blob.path))
+
+    def to_blob(self, repo: "Repo") -> Blob:
+        """:return: Blob using the information of this index entry"""
+        return Blob(repo, self.binsha, self.mode, self.path)
+
+
+class IndexEntry(BaseIndexEntry):
+    """Allows convenient access to index entry data as defined in
+    :class:`BaseIndexEntry` without completely unpacking it.
+
+    Attributes usually accessed often are cached in the tuple whereas others are
+    unpacked on demand.
+
+    See the properties for a mapping between names and tuple indices.
+    """
+
+    @property
+    def ctime(self) -> Tuple[int, int]:
+        """
+        :return:
+            Tuple(int_time_seconds_since_epoch, int_nano_seconds) of the
+            file's creation time
+        """
+        return cast(Tuple[int, int], unpack(">LL", self.ctime_bytes))
+
+    @property
+    def mtime(self) -> Tuple[int, int]:
+        """See :attr:`ctime` property, but returns modification time."""
+        return cast(Tuple[int, int], unpack(">LL", self.mtime_bytes))
+
+    @classmethod
+    def from_base(cls, base: "BaseIndexEntry") -> "IndexEntry":
+        """
+        :return:
+            Minimal entry as created from the given :class:`BaseIndexEntry` instance.
+            Missing values will be set to null-like values.
+
+        :param base:
+            Instance of type :class:`BaseIndexEntry`.
+        """
+        time = pack(">LL", 0, 0)
+        return IndexEntry((base.mode, base.binsha, base.flags, base.path, time, time, 0, 0, 0, 0, 0))
+
+    @classmethod
+    def from_blob(cls, blob: Blob, stage: int = 0) -> "IndexEntry":
+        """:return: Minimal entry resembling the given blob object"""
+        time = pack(">LL", 0, 0)
+        return IndexEntry(
+            (
+                blob.mode,
+                blob.binsha,
+                stage << CE_STAGESHIFT,
+                blob.path,
+                time,
+                time,
+                0,
+                0,
+                0,
+                0,
+                blob.size,
+            )
+        )
diff --git a/llm/Lib/site-packages/git/index/util.py b/llm/Lib/site-packages/git/index/util.py
new file mode 100644
index 0000000000000000000000000000000000000000..e59cb609f70a2ec532b310158f021618e7d0505d
--- /dev/null
+++ b/llm/Lib/site-packages/git/index/util.py
@@ -0,0 +1,121 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Index utilities."""
+
+__all__ = ["TemporaryFileSwap", "post_clear_cache", "default_index", "git_working_dir"]
+
+import contextlib
+from functools import wraps
+import os
+import os.path as osp
+import struct
+import tempfile
+from types import TracebackType
+
+# typing ----------------------------------------------------------------------
+
+from typing import Any, Callable, TYPE_CHECKING, Optional, Type
+
+from git.types import Literal, PathLike, _T
+
+if TYPE_CHECKING:
+    from git.index import IndexFile
+
+# ---------------------------------------------------------------------------------
+
+# { Aliases
+pack = struct.pack
+unpack = struct.unpack
+# } END aliases
+
+
+class TemporaryFileSwap:
+    """Utility class moving a file to a temporary location within the same directory and
+    moving it back on to where on object deletion."""
+
+    __slots__ = ("file_path", "tmp_file_path")
+
+    def __init__(self, file_path: PathLike) -> None:
+        self.file_path = file_path
+        dirname, basename = osp.split(file_path)
+        fd, self.tmp_file_path = tempfile.mkstemp(prefix=basename, dir=dirname)
+        os.close(fd)
+        with contextlib.suppress(OSError):  # It may be that the source does not exist.
+            os.replace(self.file_path, self.tmp_file_path)
+
+    def __enter__(self) -> "TemporaryFileSwap":
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
+    ) -> Literal[False]:
+        if osp.isfile(self.tmp_file_path):
+            os.replace(self.tmp_file_path, self.file_path)
+        return False
+
+
+# { Decorators
+
+
+def post_clear_cache(func: Callable[..., _T]) -> Callable[..., _T]:
+    """Decorator for functions that alter the index using the git command.
+
+    When a git command alters the index, this invalidates our possibly existing entries
+    dictionary, which is why it must be deleted to allow it to be lazily reread later.
+    """
+
+    @wraps(func)
+    def post_clear_cache_if_not_raised(self: "IndexFile", *args: Any, **kwargs: Any) -> _T:
+        rval = func(self, *args, **kwargs)
+        self._delete_entries_cache()
+        return rval
+
+    # END wrapper method
+
+    return post_clear_cache_if_not_raised
+
+
+def default_index(func: Callable[..., _T]) -> Callable[..., _T]:
+    """Decorator ensuring the wrapped method may only run if we are the default
+    repository index.
+
+    This is as we rely on git commands that operate on that index only.
+    """
+
+    @wraps(func)
+    def check_default_index(self: "IndexFile", *args: Any, **kwargs: Any) -> _T:
+        if self._file_path != self._index_path():
+            raise AssertionError(
+                "Cannot call %r on indices that do not represent the default git index" % func.__name__
+            )
+        return func(self, *args, **kwargs)
+
+    # END wrapper method
+
+    return check_default_index
+
+
+def git_working_dir(func: Callable[..., _T]) -> Callable[..., _T]:
+    """Decorator which changes the current working dir to the one of the git
+    repository in order to ensure relative paths are handled correctly."""
+
+    @wraps(func)
+    def set_git_working_dir(self: "IndexFile", *args: Any, **kwargs: Any) -> _T:
+        cur_wd = os.getcwd()
+        os.chdir(str(self.repo.working_tree_dir))
+        try:
+            return func(self, *args, **kwargs)
+        finally:
+            os.chdir(cur_wd)
+        # END handle working dir
+
+    # END wrapper
+
+    return set_git_working_dir
+
+
+# } END decorators
diff --git a/llm/Lib/site-packages/git/objects/__init__.py b/llm/Lib/site-packages/git/objects/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4447ca50d321963e10b50178253a2d3edf5e707a
--- /dev/null
+++ b/llm/Lib/site-packages/git/objects/__init__.py
@@ -0,0 +1,25 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Import all submodules' main classes into the package space."""
+
+__all__ = [
+    "IndexObject",
+    "Object",
+    "Blob",
+    "Commit",
+    "Submodule",
+    "UpdateProgress",
+    "RootModule",
+    "RootUpdateProgress",
+    "TagObject",
+    "Tree",
+    "TreeModifier",
+]
+
+from .base import IndexObject, Object
+from .blob import Blob
+from .commit import Commit
+from .submodule import RootModule, RootUpdateProgress, Submodule, UpdateProgress
+from .tag import TagObject
+from .tree import Tree, TreeModifier
diff --git a/llm/Lib/site-packages/git/objects/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/git/objects/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0c19c932b794a5cab0919c3ecc9a8f17687402da
Binary files /dev/null and b/llm/Lib/site-packages/git/objects/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/objects/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/git/objects/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c6096c36ca6c5253db8a27fc912babf4e315be00
Binary files /dev/null and b/llm/Lib/site-packages/git/objects/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/objects/__pycache__/blob.cpython-311.pyc b/llm/Lib/site-packages/git/objects/__pycache__/blob.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..77ef80affa76ebc8477d4fa8ff185ed44d255233
Binary files /dev/null and b/llm/Lib/site-packages/git/objects/__pycache__/blob.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/objects/__pycache__/commit.cpython-311.pyc b/llm/Lib/site-packages/git/objects/__pycache__/commit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f687bedef6a0ad3b5e66bd68e361df68cb68b972
Binary files /dev/null and b/llm/Lib/site-packages/git/objects/__pycache__/commit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/objects/__pycache__/fun.cpython-311.pyc b/llm/Lib/site-packages/git/objects/__pycache__/fun.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2f85da7c6eab6f47539aab916173f7a7bef8c43f
Binary files /dev/null and b/llm/Lib/site-packages/git/objects/__pycache__/fun.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/objects/__pycache__/tag.cpython-311.pyc b/llm/Lib/site-packages/git/objects/__pycache__/tag.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2dd9ac392262f42c91106d5f0c77f731f8a8173d
Binary files /dev/null and b/llm/Lib/site-packages/git/objects/__pycache__/tag.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/objects/__pycache__/tree.cpython-311.pyc b/llm/Lib/site-packages/git/objects/__pycache__/tree.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..44014ca926f0ec01511f90ee74b101c911a51ef3
Binary files /dev/null and b/llm/Lib/site-packages/git/objects/__pycache__/tree.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/objects/__pycache__/util.cpython-311.pyc b/llm/Lib/site-packages/git/objects/__pycache__/util.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7f503984a3447f233ed439a7815092ad627d4346
Binary files /dev/null and b/llm/Lib/site-packages/git/objects/__pycache__/util.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/objects/base.py b/llm/Lib/site-packages/git/objects/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..eeaebc09bd320de6e0a2402c4d77c7dca5c263e6
--- /dev/null
+++ b/llm/Lib/site-packages/git/objects/base.py
@@ -0,0 +1,301 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+__all__ = ["Object", "IndexObject"]
+
+import os.path as osp
+
+import gitdb.typ as dbtyp
+
+from git.exc import WorkTreeRepositoryUnsupported
+from git.util import LazyMixin, bin_to_hex, join_path_native, stream_copy
+
+from .util import get_object_type_by_name
+
+# typing ------------------------------------------------------------------
+
+from typing import Any, TYPE_CHECKING, Union
+
+from git.types import AnyGitObject, GitObjectTypeString, PathLike
+
+if TYPE_CHECKING:
+    from gitdb.base import OStream
+
+    from git.refs.reference import Reference
+    from git.repo import Repo
+
+    from .blob import Blob
+    from .submodule.base import Submodule
+    from .tree import Tree
+
+IndexObjUnion = Union["Tree", "Blob", "Submodule"]
+
+# --------------------------------------------------------------------------
+
+
+class Object(LazyMixin):
+    """Base class for classes representing git object types.
+
+    The following four leaf classes represent specific kinds of git objects:
+
+    * :class:`Blob <git.objects.blob.Blob>`
+    * :class:`Tree <git.objects.tree.Tree>`
+    * :class:`Commit <git.objects.commit.Commit>`
+    * :class:`TagObject <git.objects.tag.TagObject>`
+
+    See :manpage:`gitglossary(7)` on:
+
+    * "object": https://git-scm.com/docs/gitglossary#def_object
+    * "object type": https://git-scm.com/docs/gitglossary#def_object_type
+    * "blob": https://git-scm.com/docs/gitglossary#def_blob_object
+    * "tree object": https://git-scm.com/docs/gitglossary#def_tree_object
+    * "commit object": https://git-scm.com/docs/gitglossary#def_commit_object
+    * "tag object": https://git-scm.com/docs/gitglossary#def_tag_object
+
+    :note:
+        See the :class:`~git.types.AnyGitObject` union type of the four leaf subclasses
+        that represent actual git object types.
+
+    :note:
+        :class:`~git.objects.submodule.base.Submodule` is defined under the hierarchy
+        rooted at this :class:`Object` class, even though submodules are not really a
+        type of git object. (This also applies to its
+        :class:`~git.objects.submodule.root.RootModule` subclass.)
+
+    :note:
+        This :class:`Object` class should not be confused with :class:`object` (the root
+        of the class hierarchy in Python).
+    """
+
+    NULL_HEX_SHA = "0" * 40
+    NULL_BIN_SHA = b"\0" * 20
+
+    TYPES = (
+        dbtyp.str_blob_type,
+        dbtyp.str_tree_type,
+        dbtyp.str_commit_type,
+        dbtyp.str_tag_type,
+    )
+
+    __slots__ = ("repo", "binsha", "size")
+
+    type: Union[GitObjectTypeString, None] = None
+    """String identifying (a concrete :class:`Object` subtype for) a git object type.
+
+    The subtypes that this may name correspond to the kinds of git objects that exist,
+    i.e., the objects that may be present in a git repository.
+
+    :note:
+        Most subclasses represent specific types of git objects and override this class
+        attribute accordingly. This attribute is ``None`` in the :class:`Object` base
+        class, as well as the :class:`IndexObject` intermediate subclass, but never
+        ``None`` in concrete leaf subclasses representing specific git object types.
+
+    :note:
+        See also :class:`~git.types.GitObjectTypeString`.
+    """
+
+    def __init__(self, repo: "Repo", binsha: bytes) -> None:
+        """Initialize an object by identifying it by its binary sha.
+
+        All keyword arguments will be set on demand if ``None``.
+
+        :param repo:
+            Repository this object is located in.
+
+        :param binsha:
+            20 byte SHA1
+        """
+        super().__init__()
+        self.repo = repo
+        self.binsha = binsha
+        assert len(binsha) == 20, "Require 20 byte binary sha, got %r, len = %i" % (
+            binsha,
+            len(binsha),
+        )
+
+    @classmethod
+    def new(cls, repo: "Repo", id: Union[str, "Reference"]) -> AnyGitObject:
+        """
+        :return:
+            New :class:`Object` instance of a type appropriate to the object type behind
+            `id`. The id of the newly created object will be a binsha even though the
+            input id may have been a `~git.refs.reference.Reference` or rev-spec.
+
+        :param id:
+            :class:`~git.refs.reference.Reference`, rev-spec, or hexsha.
+
+        :note:
+            This cannot be a ``__new__`` method as it would always call :meth:`__init__`
+            with the input id which is not necessarily a binsha.
+        """
+        return repo.rev_parse(str(id))
+
+    @classmethod
+    def new_from_sha(cls, repo: "Repo", sha1: bytes) -> AnyGitObject:
+        """
+        :return:
+            New object instance of a type appropriate to represent the given binary sha1
+
+        :param sha1:
+            20 byte binary sha1.
+        """
+        if sha1 == cls.NULL_BIN_SHA:
+            # The NULL binsha is always the root commit.
+            return get_object_type_by_name(b"commit")(repo, sha1)
+        # END handle special case
+        oinfo = repo.odb.info(sha1)
+        inst = get_object_type_by_name(oinfo.type)(repo, oinfo.binsha)
+        inst.size = oinfo.size
+        return inst
+
+    def _set_cache_(self, attr: str) -> None:
+        """Retrieve object information."""
+        if attr == "size":
+            oinfo = self.repo.odb.info(self.binsha)
+            self.size = oinfo.size  # type: int
+        else:
+            super()._set_cache_(attr)
+
+    def __eq__(self, other: Any) -> bool:
+        """:return: ``True`` if the objects have the same SHA1"""
+        if not hasattr(other, "binsha"):
+            return False
+        return self.binsha == other.binsha
+
+    def __ne__(self, other: Any) -> bool:
+        """:return: ``True`` if the objects do not have the same SHA1"""
+        if not hasattr(other, "binsha"):
+            return True
+        return self.binsha != other.binsha
+
+    def __hash__(self) -> int:
+        """:return: Hash of our id allowing objects to be used in dicts and sets"""
+        return hash(self.binsha)
+
+    def __str__(self) -> str:
+        """:return: String of our SHA1 as understood by all git commands"""
+        return self.hexsha
+
+    def __repr__(self) -> str:
+        """:return: String with pythonic representation of our object"""
+        return '<git.%s "%s">' % (self.__class__.__name__, self.hexsha)
+
+    @property
+    def hexsha(self) -> str:
+        """:return: 40 byte hex version of our 20 byte binary sha"""
+        # b2a_hex produces bytes.
+        return bin_to_hex(self.binsha).decode("ascii")
+
+    @property
+    def data_stream(self) -> "OStream":
+        """
+        :return:
+            File-object compatible stream to the uncompressed raw data of the object
+
+        :note:
+            Returned streams must be read in order.
+        """
+        return self.repo.odb.stream(self.binsha)
+
+    def stream_data(self, ostream: "OStream") -> "Object":
+        """Write our data directly to the given output stream.
+
+        :param ostream:
+            File-object compatible stream object.
+
+        :return:
+            self
+        """
+        istream = self.repo.odb.stream(self.binsha)
+        stream_copy(istream, ostream)
+        return self
+
+
+class IndexObject(Object):
+    """Base for all objects that can be part of the index file.
+
+    The classes representing git object types that can be part of the index file are
+    :class:`~git.objects.tree.Tree and :class:`~git.objects.blob.Blob`. In addition,
+    :class:`~git.objects.submodule.base.Submodule`, which is not really a git object
+    type but can be part of an index file, is also a subclass.
+    """
+
+    __slots__ = ("path", "mode")
+
+    # For compatibility with iterable lists.
+    _id_attribute_ = "path"
+
+    def __init__(
+        self,
+        repo: "Repo",
+        binsha: bytes,
+        mode: Union[None, int] = None,
+        path: Union[None, PathLike] = None,
+    ) -> None:
+        """Initialize a newly instanced :class:`IndexObject`.
+
+        :param repo:
+            The :class:`~git.repo.base.Repo` we are located in.
+
+        :param binsha:
+            20 byte sha1.
+
+        :param mode:
+            The stat-compatible file mode as :class:`int`.
+            Use the :mod:`stat` module to evaluate the information.
+
+        :param path:
+            The path to the file in the file system, relative to the git repository
+            root, like ``file.ext`` or ``folder/other.ext``.
+
+        :note:
+            Path may not be set if the index object has been created directly, as it
+            cannot be retrieved without knowing the parent tree.
+        """
+        super().__init__(repo, binsha)
+        if mode is not None:
+            self.mode = mode
+        if path is not None:
+            self.path = path
+
+    def __hash__(self) -> int:
+        """
+        :return:
+            Hash of our path as index items are uniquely identifiable by path, not by
+            their data!
+        """
+        return hash(self.path)
+
+    def _set_cache_(self, attr: str) -> None:
+        if attr in IndexObject.__slots__:
+            # They cannot be retrieved later on (not without searching for them).
+            raise AttributeError(
+                "Attribute '%s' unset: path and mode attributes must have been set during %s object creation"
+                % (attr, type(self).__name__)
+            )
+        else:
+            super()._set_cache_(attr)
+        # END handle slot attribute
+
+    @property
+    def name(self) -> str:
+        """:return: Name portion of the path, effectively being the basename"""
+        return osp.basename(self.path)
+
+    @property
+    def abspath(self) -> PathLike:
+        R"""
+        :return:
+            Absolute path to this index object in the file system (as opposed to the
+            :attr:`path` field which is a path relative to the git repository).
+
+            The returned path will be native to the system and contains ``\`` on
+            Windows.
+        """
+        if self.repo.working_tree_dir is not None:
+            return join_path_native(self.repo.working_tree_dir, self.path)
+        else:
+            raise WorkTreeRepositoryUnsupported("working_tree_dir was None or empty")
diff --git a/llm/Lib/site-packages/git/objects/blob.py b/llm/Lib/site-packages/git/objects/blob.py
new file mode 100644
index 0000000000000000000000000000000000000000..58de59642da7f7b70a217fc28b85a488a81cfae0
--- /dev/null
+++ b/llm/Lib/site-packages/git/objects/blob.py
@@ -0,0 +1,48 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+__all__ = ["Blob"]
+
+from mimetypes import guess_type
+import sys
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from typing_extensions import Literal
+
+from . import base
+
+
+class Blob(base.IndexObject):
+    """A Blob encapsulates a git blob object.
+
+    See :manpage:`gitglossary(7)` on "blob":
+    https://git-scm.com/docs/gitglossary#def_blob_object
+    """
+
+    DEFAULT_MIME_TYPE = "text/plain"
+    type: Literal["blob"] = "blob"
+
+    # Valid blob modes
+    executable_mode = 0o100755
+    file_mode = 0o100644
+    link_mode = 0o120000
+
+    __slots__ = ()
+
+    @property
+    def mime_type(self) -> str:
+        """
+        :return:
+            String describing the mime type of this file (based on the filename)
+
+        :note:
+            Defaults to ``text/plain`` in case the actual file type is unknown.
+        """
+        guesses = None
+        if self.path:
+            guesses = guess_type(str(self.path))
+        return guesses and guesses[0] or self.DEFAULT_MIME_TYPE
diff --git a/llm/Lib/site-packages/git/objects/commit.py b/llm/Lib/site-packages/git/objects/commit.py
new file mode 100644
index 0000000000000000000000000000000000000000..d957c90514989c34f4bfd343b0061e6e8c3b8d2c
--- /dev/null
+++ b/llm/Lib/site-packages/git/objects/commit.py
@@ -0,0 +1,899 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+__all__ = ["Commit"]
+
+from collections import defaultdict
+import datetime
+from io import BytesIO
+import logging
+import os
+import re
+from subprocess import Popen, PIPE
+import sys
+from time import altzone, daylight, localtime, time, timezone
+import warnings
+
+from gitdb import IStream
+
+from git.cmd import Git
+from git.diff import Diffable
+from git.util import Actor, Stats, finalize_process, hex_to_bin
+
+from . import base
+from .tree import Tree
+from .util import (
+    Serializable,
+    TraversableIterableObj,
+    altz_to_utctz_str,
+    from_timestamp,
+    parse_actor_and_date,
+    parse_date,
+)
+
+# typing ------------------------------------------------------------------
+
+from typing import (
+    Any,
+    Dict,
+    IO,
+    Iterator,
+    List,
+    Sequence,
+    Tuple,
+    TYPE_CHECKING,
+    Union,
+    cast,
+)
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from typing_extensions import Literal
+
+from git.types import PathLike
+
+if TYPE_CHECKING:
+    from git.refs import SymbolicReference
+    from git.repo import Repo
+
+# ------------------------------------------------------------------------
+
+_logger = logging.getLogger(__name__)
+
+
+class Commit(base.Object, TraversableIterableObj, Diffable, Serializable):
+    """Wraps a git commit object.
+
+    See :manpage:`gitglossary(7)` on "commit object":
+    https://git-scm.com/docs/gitglossary#def_commit_object
+
+    :note:
+        This class will act lazily on some of its attributes and will query the value on
+        demand only if it involves calling the git binary.
+    """
+
+    # ENVIRONMENT VARIABLES
+    # Read when creating new commits.
+    env_author_date = "GIT_AUTHOR_DATE"
+    env_committer_date = "GIT_COMMITTER_DATE"
+
+    # CONFIGURATION KEYS
+    conf_encoding = "i18n.commitencoding"
+
+    # INVARIANTS
+    default_encoding = "UTF-8"
+
+    type: Literal["commit"] = "commit"
+
+    __slots__ = (
+        "tree",
+        "author",
+        "authored_date",
+        "author_tz_offset",
+        "committer",
+        "committed_date",
+        "committer_tz_offset",
+        "message",
+        "parents",
+        "encoding",
+        "gpgsig",
+    )
+
+    _id_attribute_ = "hexsha"
+
+    parents: Sequence["Commit"]
+
+    def __init__(
+        self,
+        repo: "Repo",
+        binsha: bytes,
+        tree: Union[Tree, None] = None,
+        author: Union[Actor, None] = None,
+        authored_date: Union[int, None] = None,
+        author_tz_offset: Union[None, float] = None,
+        committer: Union[Actor, None] = None,
+        committed_date: Union[int, None] = None,
+        committer_tz_offset: Union[None, float] = None,
+        message: Union[str, bytes, None] = None,
+        parents: Union[Sequence["Commit"], None] = None,
+        encoding: Union[str, None] = None,
+        gpgsig: Union[str, None] = None,
+    ) -> None:
+        """Instantiate a new :class:`Commit`. All keyword arguments taking ``None`` as
+        default will be implicitly set on first query.
+
+        :param binsha:
+            20 byte sha1.
+
+        :param tree:
+            A :class:`~git.objects.tree.Tree` object.
+
+        :param author:
+            The author :class:`~git.util.Actor` object.
+
+        :param authored_date: int_seconds_since_epoch
+            The authored DateTime - use :func:`time.gmtime` to convert it into a
+            different format.
+
+        :param author_tz_offset: int_seconds_west_of_utc
+            The timezone that the `authored_date` is in.
+
+        :param committer:
+            The committer string, as an :class:`~git.util.Actor` object.
+
+        :param committed_date: int_seconds_since_epoch
+            The committed DateTime - use :func:`time.gmtime` to convert it into a
+            different format.
+
+        :param committer_tz_offset: int_seconds_west_of_utc
+            The timezone that the `committed_date` is in.
+
+        :param message: string
+            The commit message.
+
+        :param encoding: string
+            Encoding of the message, defaults to UTF-8.
+
+        :param parents:
+            List or tuple of :class:`Commit` objects which are our parent(s) in the
+            commit dependency graph.
+
+        :return:
+            :class:`Commit`
+
+        :note:
+            Timezone information is in the same format and in the same sign as what
+            :func:`time.altzone` returns. The sign is inverted compared to git's UTC
+            timezone.
+        """
+        super().__init__(repo, binsha)
+        self.binsha = binsha
+        if tree is not None:
+            assert isinstance(tree, Tree), "Tree needs to be a Tree instance, was %s" % type(tree)
+        if tree is not None:
+            self.tree = tree
+        if author is not None:
+            self.author = author
+        if authored_date is not None:
+            self.authored_date = authored_date
+        if author_tz_offset is not None:
+            self.author_tz_offset = author_tz_offset
+        if committer is not None:
+            self.committer = committer
+        if committed_date is not None:
+            self.committed_date = committed_date
+        if committer_tz_offset is not None:
+            self.committer_tz_offset = committer_tz_offset
+        if message is not None:
+            self.message = message
+        if parents is not None:
+            self.parents = parents
+        if encoding is not None:
+            self.encoding = encoding
+        if gpgsig is not None:
+            self.gpgsig = gpgsig
+
+    @classmethod
+    def _get_intermediate_items(cls, commit: "Commit") -> Tuple["Commit", ...]:
+        return tuple(commit.parents)
+
+    @classmethod
+    def _calculate_sha_(cls, repo: "Repo", commit: "Commit") -> bytes:
+        """Calculate the sha of a commit.
+
+        :param repo:
+            :class:`~git.repo.base.Repo` object the commit should be part of.
+
+        :param commit:
+            :class:`Commit` object for which to generate the sha.
+        """
+
+        stream = BytesIO()
+        commit._serialize(stream)
+        streamlen = stream.tell()
+        stream.seek(0)
+
+        istream = repo.odb.store(IStream(cls.type, streamlen, stream))
+        return istream.binsha
+
+    def replace(self, **kwargs: Any) -> "Commit":
+        """Create new commit object from an existing commit object.
+
+        Any values provided as keyword arguments will replace the corresponding
+        attribute in the new object.
+        """
+
+        attrs = {k: getattr(self, k) for k in self.__slots__}
+
+        for attrname in kwargs:
+            if attrname not in self.__slots__:
+                raise ValueError("invalid attribute name")
+
+        attrs.update(kwargs)
+        new_commit = self.__class__(self.repo, self.NULL_BIN_SHA, **attrs)
+        new_commit.binsha = self._calculate_sha_(self.repo, new_commit)
+
+        return new_commit
+
+    def _set_cache_(self, attr: str) -> None:
+        if attr in Commit.__slots__:
+            # Read the data in a chunk, its faster - then provide a file wrapper.
+            _binsha, _typename, self.size, stream = self.repo.odb.stream(self.binsha)
+            self._deserialize(BytesIO(stream.read()))
+        else:
+            super()._set_cache_(attr)
+        # END handle attrs
+
+    @property
+    def authored_datetime(self) -> datetime.datetime:
+        return from_timestamp(self.authored_date, self.author_tz_offset)
+
+    @property
+    def committed_datetime(self) -> datetime.datetime:
+        return from_timestamp(self.committed_date, self.committer_tz_offset)
+
+    @property
+    def summary(self) -> Union[str, bytes]:
+        """:return: First line of the commit message"""
+        if isinstance(self.message, str):
+            return self.message.split("\n", 1)[0]
+        else:
+            return self.message.split(b"\n", 1)[0]
+
+    def count(self, paths: Union[PathLike, Sequence[PathLike]] = "", **kwargs: Any) -> int:
+        """Count the number of commits reachable from this commit.
+
+        :param paths:
+            An optional path or a list of paths restricting the return value to commits
+            actually containing the paths.
+
+        :param kwargs:
+            Additional options to be passed to :manpage:`git-rev-list(1)`. They must not
+            alter the output style of the command, or parsing will yield incorrect
+            results.
+
+        :return:
+            An int defining the number of reachable commits
+        """
+        # Yes, it makes a difference whether empty paths are given or not in our case as
+        # the empty paths version will ignore merge commits for some reason.
+        if paths:
+            return len(self.repo.git.rev_list(self.hexsha, "--", paths, **kwargs).splitlines())
+        return len(self.repo.git.rev_list(self.hexsha, **kwargs).splitlines())
+
+    @property
+    def name_rev(self) -> str:
+        """
+        :return:
+            String describing the commits hex sha based on the closest
+            `~git.refs.reference.Reference`.
+
+        :note:
+            Mostly useful for UI purposes.
+        """
+        return self.repo.git.name_rev(self)
+
+    @classmethod
+    def iter_items(
+        cls,
+        repo: "Repo",
+        rev: Union[str, "Commit", "SymbolicReference"],
+        paths: Union[PathLike, Sequence[PathLike]] = "",
+        **kwargs: Any,
+    ) -> Iterator["Commit"]:
+        R"""Find all commits matching the given criteria.
+
+        :param repo:
+            The :class:`~git.repo.base.Repo`.
+
+        :param rev:
+            Revision specifier. See :manpage:`git-rev-parse(1)` for viable options.
+
+        :param paths:
+            An optional path or list of paths. If set only :class:`Commit`\s that
+            include the path or paths will be considered.
+
+        :param kwargs:
+            Optional keyword arguments to :manpage:`git-rev-list(1)` where:
+
+            * ``max_count`` is the maximum number of commits to fetch.
+            * ``skip`` is the number of commits to skip.
+            * ``since`` selects all commits since some date, e.g. ``"1970-01-01"``.
+
+        :return:
+            Iterator yielding :class:`Commit` items.
+        """
+        if "pretty" in kwargs:
+            raise ValueError("--pretty cannot be used as parsing expects single sha's only")
+        # END handle pretty
+
+        # Use -- in all cases, to prevent possibility of ambiguous arguments.
+        # See https://github.com/gitpython-developers/GitPython/issues/264.
+
+        args_list: List[PathLike] = ["--"]
+
+        if paths:
+            paths_tup: Tuple[PathLike, ...]
+            if isinstance(paths, (str, os.PathLike)):
+                paths_tup = (paths,)
+            else:
+                paths_tup = tuple(paths)
+
+            args_list.extend(paths_tup)
+        # END if paths
+
+        proc = repo.git.rev_list(rev, args_list, as_process=True, **kwargs)
+        return cls._iter_from_process_or_stream(repo, proc)
+
+    def iter_parents(self, paths: Union[PathLike, Sequence[PathLike]] = "", **kwargs: Any) -> Iterator["Commit"]:
+        R"""Iterate _all_ parents of this commit.
+
+        :param paths:
+            Optional path or list of paths limiting the :class:`Commit`\s to those that
+            contain at least one of the paths.
+
+        :param kwargs:
+            All arguments allowed by :manpage:`git-rev-list(1)`.
+
+        :return:
+            Iterator yielding :class:`Commit` objects which are parents of ``self``
+        """
+        # skip ourselves
+        skip = kwargs.get("skip", 1)
+        if skip == 0:  # skip ourselves
+            skip = 1
+        kwargs["skip"] = skip
+
+        return self.iter_items(self.repo, self, paths, **kwargs)
+
+    @property
+    def stats(self) -> Stats:
+        """Create a git stat from changes between this commit and its first parent
+        or from all changes done if this is the very first commit.
+
+        :return:
+            :class:`Stats`
+        """
+        if not self.parents:
+            text = self.repo.git.diff_tree(self.hexsha, "--", numstat=True, no_renames=True, root=True)
+            text2 = ""
+            for line in text.splitlines()[1:]:
+                (insertions, deletions, filename) = line.split("\t")
+                text2 += "%s\t%s\t%s\n" % (insertions, deletions, filename)
+            text = text2
+        else:
+            text = self.repo.git.diff(self.parents[0].hexsha, self.hexsha, "--", numstat=True, no_renames=True)
+        return Stats._list_from_string(self.repo, text)
+
+    @property
+    def trailers(self) -> Dict[str, str]:
+        """Deprecated. Get the trailers of the message as a dictionary.
+
+        :note:
+            This property is deprecated, please use either :attr:`trailers_list` or
+            :attr:`trailers_dict`.
+
+        :return:
+            Dictionary containing whitespace stripped trailer information.
+            Only contains the latest instance of each trailer key.
+        """
+        warnings.warn(
+            "Commit.trailers is deprecated, use Commit.trailers_list or Commit.trailers_dict instead",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return {k: v[0] for k, v in self.trailers_dict.items()}
+
+    @property
+    def trailers_list(self) -> List[Tuple[str, str]]:
+        """Get the trailers of the message as a list.
+
+        Git messages can contain trailer information that are similar to :rfc:`822`
+        e-mail headers. See :manpage:`git-interpret-trailers(1)`.
+
+        This function calls ``git interpret-trailers --parse`` onto the message to
+        extract the trailer information, returns the raw trailer data as a list.
+
+        Valid message with trailer::
+
+            Subject line
+
+            some body information
+
+            another information
+
+            key1: value1.1
+            key1: value1.2
+            key2 :    value 2 with inner spaces
+
+        Returned list will look like this::
+
+            [
+                ("key1", "value1.1"),
+                ("key1", "value1.2"),
+                ("key2", "value 2 with inner spaces"),
+            ]
+
+        :return:
+            List containing key-value tuples of whitespace stripped trailer information.
+        """
+        cmd = ["git", "interpret-trailers", "--parse"]
+        proc: Git.AutoInterrupt = self.repo.git.execute(  # type: ignore[call-overload]
+            cmd,
+            as_process=True,
+            istream=PIPE,
+        )
+        trailer: str = proc.communicate(str(self.message).encode())[0].decode("utf8")
+        trailer = trailer.strip()
+
+        if not trailer:
+            return []
+
+        trailer_list = []
+        for t in trailer.split("\n"):
+            key, val = t.split(":", 1)
+            trailer_list.append((key.strip(), val.strip()))
+
+        return trailer_list
+
+    @property
+    def trailers_dict(self) -> Dict[str, List[str]]:
+        """Get the trailers of the message as a dictionary.
+
+        Git messages can contain trailer information that are similar to :rfc:`822`
+        e-mail headers. See :manpage:`git-interpret-trailers(1)`.
+
+        This function calls ``git interpret-trailers --parse`` onto the message to
+        extract the trailer information. The key value pairs are stripped of leading and
+        trailing whitespaces before they get saved into a dictionary.
+
+        Valid message with trailer::
+
+            Subject line
+
+            some body information
+
+            another information
+
+            key1: value1.1
+            key1: value1.2
+            key2 :    value 2 with inner spaces
+
+        Returned dictionary will look like this::
+
+            {
+                "key1": ["value1.1", "value1.2"],
+                "key2": ["value 2 with inner spaces"],
+            }
+
+
+        :return:
+            Dictionary containing whitespace stripped trailer information, mapping
+            trailer keys to a list of their corresponding values.
+        """
+        d = defaultdict(list)
+        for key, val in self.trailers_list:
+            d[key].append(val)
+        return dict(d)
+
+    @classmethod
+    def _iter_from_process_or_stream(cls, repo: "Repo", proc_or_stream: Union[Popen, IO]) -> Iterator["Commit"]:
+        """Parse out commit information into a list of :class:`Commit` objects.
+
+        We expect one line per commit, and parse the actual commit information directly
+        from our lighting fast object database.
+
+        :param proc:
+            :manpage:`git-rev-list(1)` process instance - one sha per line.
+
+        :return:
+            Iterator supplying :class:`Commit` objects
+        """
+
+        # def is_proc(inp) -> TypeGuard[Popen]:
+        #     return hasattr(proc_or_stream, 'wait') and not hasattr(proc_or_stream, 'readline')
+
+        # def is_stream(inp) -> TypeGuard[IO]:
+        #     return hasattr(proc_or_stream, 'readline')
+
+        if hasattr(proc_or_stream, "wait"):
+            proc_or_stream = cast(Popen, proc_or_stream)
+            if proc_or_stream.stdout is not None:
+                stream = proc_or_stream.stdout
+        elif hasattr(proc_or_stream, "readline"):
+            proc_or_stream = cast(IO, proc_or_stream)  # type: ignore[redundant-cast]
+            stream = proc_or_stream
+
+        readline = stream.readline
+        while True:
+            line = readline()
+            if not line:
+                break
+            hexsha = line.strip()
+            if len(hexsha) > 40:
+                # Split additional information, as returned by bisect for instance.
+                hexsha, _ = line.split(None, 1)
+            # END handle extra info
+
+            assert len(hexsha) == 40, "Invalid line: %s" % hexsha
+            yield cls(repo, hex_to_bin(hexsha))
+        # END for each line in stream
+
+        # TODO: Review this - it seems process handling got a bit out of control due to
+        # many developers trying to fix the open file handles issue.
+        if hasattr(proc_or_stream, "wait"):
+            proc_or_stream = cast(Popen, proc_or_stream)
+            finalize_process(proc_or_stream)
+
+    @classmethod
+    def create_from_tree(
+        cls,
+        repo: "Repo",
+        tree: Union[Tree, str],
+        message: str,
+        parent_commits: Union[None, List["Commit"]] = None,
+        head: bool = False,
+        author: Union[None, Actor] = None,
+        committer: Union[None, Actor] = None,
+        author_date: Union[None, str, datetime.datetime] = None,
+        commit_date: Union[None, str, datetime.datetime] = None,
+    ) -> "Commit":
+        """Commit the given tree, creating a :class:`Commit` object.
+
+        :param repo:
+            :class:`~git.repo.base.Repo` object the commit should be part of.
+
+        :param tree:
+            :class:`~git.objects.tree.Tree` object or hex or bin sha.
+            The tree of the new commit.
+
+        :param message:
+            Commit message. It may be an empty string if no message is provided. It will
+            be converted to a string, in any case.
+
+        :param parent_commits:
+            Optional :class:`Commit` objects to use as parents for the new commit. If
+            empty list, the commit will have no parents at all and become a root commit.
+            If ``None``, the current head commit will be the parent of the new commit
+            object.
+
+        :param head:
+            If ``True``, the HEAD will be advanced to the new commit automatically.
+            Otherwise the HEAD will remain pointing on the previous commit. This could
+            lead to undesired results when diffing files.
+
+        :param author:
+            The name of the author, optional.
+            If unset, the repository configuration is used to obtain this value.
+
+        :param committer:
+            The name of the committer, optional.
+            If unset, the repository configuration is used to obtain this value.
+
+        :param author_date:
+            The timestamp for the author field.
+
+        :param commit_date:
+            The timestamp for the committer field.
+
+        :return:
+            :class:`Commit` object representing the new commit.
+
+        :note:
+            Additional information about the committer and author are taken from the
+            environment or from the git configuration. See :manpage:`git-commit-tree(1)`
+            for more information.
+        """
+        if parent_commits is None:
+            try:
+                parent_commits = [repo.head.commit]
+            except ValueError:
+                # Empty repositories have no head commit.
+                parent_commits = []
+            # END handle parent commits
+        else:
+            for p in parent_commits:
+                if not isinstance(p, cls):
+                    raise ValueError(f"Parent commit '{p!r}' must be of type {cls}")
+            # END check parent commit types
+        # END if parent commits are unset
+
+        # Retrieve all additional information, create a commit object, and serialize it.
+        # Generally:
+        # * Environment variables override configuration values.
+        # * Sensible defaults are set according to the git documentation.
+
+        # COMMITTER AND AUTHOR INFO
+        cr = repo.config_reader()
+        env = os.environ
+
+        committer = committer or Actor.committer(cr)
+        author = author or Actor.author(cr)
+
+        # PARSE THE DATES
+        unix_time = int(time())
+        is_dst = daylight and localtime().tm_isdst > 0
+        offset = altzone if is_dst else timezone
+
+        author_date_str = env.get(cls.env_author_date, "")
+        if author_date:
+            author_time, author_offset = parse_date(author_date)
+        elif author_date_str:
+            author_time, author_offset = parse_date(author_date_str)
+        else:
+            author_time, author_offset = unix_time, offset
+        # END set author time
+
+        committer_date_str = env.get(cls.env_committer_date, "")
+        if commit_date:
+            committer_time, committer_offset = parse_date(commit_date)
+        elif committer_date_str:
+            committer_time, committer_offset = parse_date(committer_date_str)
+        else:
+            committer_time, committer_offset = unix_time, offset
+        # END set committer time
+
+        # Assume UTF-8 encoding.
+        enc_section, enc_option = cls.conf_encoding.split(".")
+        conf_encoding = cr.get_value(enc_section, enc_option, cls.default_encoding)
+        if not isinstance(conf_encoding, str):
+            raise TypeError("conf_encoding could not be coerced to str")
+
+        # If the tree is no object, make sure we create one - otherwise the created
+        # commit object is invalid.
+        if isinstance(tree, str):
+            tree = repo.tree(tree)
+        # END tree conversion
+
+        # CREATE NEW COMMIT
+        new_commit = cls(
+            repo,
+            cls.NULL_BIN_SHA,
+            tree,
+            author,
+            author_time,
+            author_offset,
+            committer,
+            committer_time,
+            committer_offset,
+            message,
+            parent_commits,
+            conf_encoding,
+        )
+
+        new_commit.binsha = cls._calculate_sha_(repo, new_commit)
+
+        if head:
+            # Need late import here, importing git at the very beginning throws as
+            # well...
+            import git.refs
+
+            try:
+                repo.head.set_commit(new_commit, logmsg=message)
+            except ValueError:
+                # head is not yet set to the ref our HEAD points to.
+                # Happens on first commit.
+                master = git.refs.Head.create(
+                    repo,
+                    repo.head.ref,
+                    new_commit,
+                    logmsg="commit (initial): %s" % message,
+                )
+                repo.head.set_reference(master, logmsg="commit: Switching to %s" % master)
+            # END handle empty repositories
+        # END advance head handling
+
+        return new_commit
+
+    # { Serializable Implementation
+
+    def _serialize(self, stream: BytesIO) -> "Commit":
+        write = stream.write
+        write(("tree %s\n" % self.tree).encode("ascii"))
+        for p in self.parents:
+            write(("parent %s\n" % p).encode("ascii"))
+
+        a = self.author
+        aname = a.name
+        c = self.committer
+        fmt = "%s %s <%s> %s %s\n"
+        write(
+            (
+                fmt
+                % (
+                    "author",
+                    aname,
+                    a.email,
+                    self.authored_date,
+                    altz_to_utctz_str(self.author_tz_offset),
+                )
+            ).encode(self.encoding)
+        )
+
+        # Encode committer.
+        aname = c.name
+        write(
+            (
+                fmt
+                % (
+                    "committer",
+                    aname,
+                    c.email,
+                    self.committed_date,
+                    altz_to_utctz_str(self.committer_tz_offset),
+                )
+            ).encode(self.encoding)
+        )
+
+        if self.encoding != self.default_encoding:
+            write(("encoding %s\n" % self.encoding).encode("ascii"))
+
+        try:
+            if self.__getattribute__("gpgsig"):
+                write(b"gpgsig")
+                for sigline in self.gpgsig.rstrip("\n").split("\n"):
+                    write((" " + sigline + "\n").encode("ascii"))
+        except AttributeError:
+            pass
+
+        write(b"\n")
+
+        # Write plain bytes, be sure its encoded according to our encoding.
+        if isinstance(self.message, str):
+            write(self.message.encode(self.encoding))
+        else:
+            write(self.message)
+        # END handle encoding
+        return self
+
+    def _deserialize(self, stream: BytesIO) -> "Commit":
+        readline = stream.readline
+        self.tree = Tree(self.repo, hex_to_bin(readline().split()[1]), Tree.tree_id << 12, "")
+
+        self.parents = []
+        next_line = None
+        while True:
+            parent_line = readline()
+            if not parent_line.startswith(b"parent"):
+                next_line = parent_line
+                break
+            # END abort reading parents
+            self.parents.append(type(self)(self.repo, hex_to_bin(parent_line.split()[-1].decode("ascii"))))
+        # END for each parent line
+        self.parents = tuple(self.parents)
+
+        # We don't know actual author encoding before we have parsed it, so keep the
+        # lines around.
+        author_line = next_line
+        committer_line = readline()
+
+        # We might run into one or more mergetag blocks, skip those for now.
+        next_line = readline()
+        while next_line.startswith(b"mergetag "):
+            next_line = readline()
+            while next_line.startswith(b" "):
+                next_line = readline()
+        # END skip mergetags
+
+        # Now we can have the encoding line, or an empty line followed by the optional
+        # message.
+        self.encoding = self.default_encoding
+        self.gpgsig = ""
+
+        # Read headers.
+        enc = next_line
+        buf = enc.strip()
+        while buf:
+            if buf[0:10] == b"encoding ":
+                self.encoding = buf[buf.find(b" ") + 1 :].decode(self.encoding, "ignore")
+            elif buf[0:7] == b"gpgsig ":
+                sig = buf[buf.find(b" ") + 1 :] + b"\n"
+                is_next_header = False
+                while True:
+                    sigbuf = readline()
+                    if not sigbuf:
+                        break
+                    if sigbuf[0:1] != b" ":
+                        buf = sigbuf.strip()
+                        is_next_header = True
+                        break
+                    sig += sigbuf[1:]
+                # END read all signature
+                self.gpgsig = sig.rstrip(b"\n").decode(self.encoding, "ignore")
+                if is_next_header:
+                    continue
+            buf = readline().strip()
+
+        # Decode the author's name.
+        try:
+            (
+                self.author,
+                self.authored_date,
+                self.author_tz_offset,
+            ) = parse_actor_and_date(author_line.decode(self.encoding, "replace"))
+        except UnicodeDecodeError:
+            _logger.error(
+                "Failed to decode author line '%s' using encoding %s",
+                author_line,
+                self.encoding,
+                exc_info=True,
+            )
+
+        try:
+            (
+                self.committer,
+                self.committed_date,
+                self.committer_tz_offset,
+            ) = parse_actor_and_date(committer_line.decode(self.encoding, "replace"))
+        except UnicodeDecodeError:
+            _logger.error(
+                "Failed to decode committer line '%s' using encoding %s",
+                committer_line,
+                self.encoding,
+                exc_info=True,
+            )
+        # END handle author's encoding
+
+        # A stream from our data simply gives us the plain message.
+        # The end of our message stream is marked with a newline that we strip.
+        self.message = stream.read()
+        try:
+            self.message = self.message.decode(self.encoding, "replace")
+        except UnicodeDecodeError:
+            _logger.error(
+                "Failed to decode message '%s' using encoding %s",
+                self.message,
+                self.encoding,
+                exc_info=True,
+            )
+        # END exception handling
+
+        return self
+
+    # } END serializable implementation
+
+    @property
+    def co_authors(self) -> List[Actor]:
+        """Search the commit message for any co-authors of this commit.
+
+        Details on co-authors:
+        https://github.blog/2018-01-29-commit-together-with-co-authors/
+
+        :return:
+            List of co-authors for this commit (as :class:`~git.util.Actor` objects).
+        """
+        co_authors = []
+
+        if self.message:
+            results = re.findall(
+                r"^Co-authored-by: (.*) <(.*?)>$",
+                self.message,
+                re.MULTILINE,
+            )
+            for author in results:
+                co_authors.append(Actor(*author))
+
+        return co_authors
diff --git a/llm/Lib/site-packages/git/objects/fun.py b/llm/Lib/site-packages/git/objects/fun.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe57da13ae4599368b9ebb396c2be1dfdb3d6a83
--- /dev/null
+++ b/llm/Lib/site-packages/git/objects/fun.py
@@ -0,0 +1,281 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Functions that are supposed to be as fast as possible."""
+
+__all__ = [
+    "tree_to_stream",
+    "tree_entries_from_data",
+    "traverse_trees_recursive",
+    "traverse_tree_recursive",
+]
+
+from stat import S_ISDIR
+
+from git.compat import safe_decode, defenc
+
+# typing ----------------------------------------------
+
+from typing import (
+    Callable,
+    List,
+    MutableSequence,
+    Sequence,
+    Tuple,
+    TYPE_CHECKING,
+    Union,
+    overload,
+)
+
+if TYPE_CHECKING:
+    from _typeshed import ReadableBuffer
+
+    from git import GitCmdObjectDB
+
+EntryTup = Tuple[bytes, int, str]  # Same as TreeCacheTup in tree.py.
+EntryTupOrNone = Union[EntryTup, None]
+
+# ---------------------------------------------------
+
+
+def tree_to_stream(entries: Sequence[EntryTup], write: Callable[["ReadableBuffer"], Union[int, None]]) -> None:
+    """Write the given list of entries into a stream using its ``write`` method.
+
+    :param entries:
+        **Sorted** list of tuples with (binsha, mode, name).
+
+    :param write:
+        A ``write`` method which takes a data string.
+    """
+    ord_zero = ord("0")
+    bit_mask = 7  # 3 bits set.
+
+    for binsha, mode, name in entries:
+        mode_str = b""
+        for i in range(6):
+            mode_str = bytes([((mode >> (i * 3)) & bit_mask) + ord_zero]) + mode_str
+        # END for each 8 octal value
+
+        # git slices away the first octal if it's zero.
+        if mode_str[0] == ord_zero:
+            mode_str = mode_str[1:]
+        # END save a byte
+
+        # Here it comes: If the name is actually unicode, the replacement below will not
+        # work as the binsha is not part of the ascii unicode encoding - hence we must
+        # convert to an UTF-8 string for it to work properly. According to my tests,
+        # this is exactly what git does, that is it just takes the input literally,
+        # which appears to be UTF-8 on linux.
+        if isinstance(name, str):
+            name_bytes = name.encode(defenc)
+        else:
+            name_bytes = name  # type: ignore[unreachable]  # check runtime types - is always str?
+        write(b"".join((mode_str, b" ", name_bytes, b"\0", binsha)))
+    # END for each item
+
+
+def tree_entries_from_data(data: bytes) -> List[EntryTup]:
+    """Read the binary representation of a tree and returns tuples of
+    :class:`~git.objects.tree.Tree` items.
+
+    :param data:
+        Data block with tree data (as bytes).
+
+    :return:
+        list(tuple(binsha, mode, tree_relative_path), ...)
+    """
+    ord_zero = ord("0")
+    space_ord = ord(" ")
+    len_data = len(data)
+    i = 0
+    out = []
+    while i < len_data:
+        mode = 0
+
+        # Read Mode
+        # Some git versions truncate the leading 0, some don't.
+        # The type will be extracted from the mode later.
+        while data[i] != space_ord:
+            # Move existing mode integer up one level being 3 bits and add the actual
+            # ordinal value of the character.
+            mode = (mode << 3) + (data[i] - ord_zero)
+            i += 1
+        # END while reading mode
+
+        # Byte is space now, skip it.
+        i += 1
+
+        # Parse name, it is NULL separated.
+
+        ns = i
+        while data[i] != 0:
+            i += 1
+        # END while not reached NULL
+
+        # Default encoding for strings in git is UTF-8.
+        # Only use the respective unicode object if the byte stream was encoded.
+        name_bytes = data[ns:i]
+        name = safe_decode(name_bytes)
+
+        # Byte is NULL, get next 20.
+        i += 1
+        sha = data[i : i + 20]
+        i = i + 20
+        out.append((sha, mode, name))
+    # END for each byte in data stream
+    return out
+
+
+def _find_by_name(tree_data: MutableSequence[EntryTupOrNone], name: str, is_dir: bool, start_at: int) -> EntryTupOrNone:
+    """Return data entry matching the given name and tree mode or ``None``.
+
+    Before the item is returned, the respective data item is set None in the `tree_data`
+    list to mark it done.
+    """
+
+    try:
+        item = tree_data[start_at]
+        if item and item[2] == name and S_ISDIR(item[1]) == is_dir:
+            tree_data[start_at] = None
+            return item
+    except IndexError:
+        pass
+    # END exception handling
+    for index, item in enumerate(tree_data):
+        if item and item[2] == name and S_ISDIR(item[1]) == is_dir:
+            tree_data[index] = None
+            return item
+        # END if item matches
+    # END for each item
+    return None
+
+
+@overload
+def _to_full_path(item: None, path_prefix: str) -> None: ...
+
+
+@overload
+def _to_full_path(item: EntryTup, path_prefix: str) -> EntryTup: ...
+
+
+def _to_full_path(item: EntryTupOrNone, path_prefix: str) -> EntryTupOrNone:
+    """Rebuild entry with given path prefix."""
+    if not item:
+        return item
+    return (item[0], item[1], path_prefix + item[2])
+
+
+def traverse_trees_recursive(
+    odb: "GitCmdObjectDB", tree_shas: Sequence[Union[bytes, None]], path_prefix: str
+) -> List[Tuple[EntryTupOrNone, ...]]:
+    """
+    :return:
+        List of list with entries according to the given binary tree-shas.
+
+        The result is encoded in a list
+        of n tuple|None per blob/commit, (n == len(tree_shas)), where:
+
+        * [0] == 20 byte sha
+        * [1] == mode as int
+        * [2] == path relative to working tree root
+
+        The entry tuple is ``None`` if the respective blob/commit did not exist in the
+        given tree.
+
+    :param tree_shas:
+        Iterable of shas pointing to trees. All trees must be on the same level.
+        A tree-sha may be ``None``, in which case ``None``.
+
+    :param path_prefix:
+        A prefix to be added to the returned paths on this level.
+        Set it ``""`` for the first iteration.
+
+    :note:
+        The ordering of the returned items will be partially lost.
+    """
+    trees_data: List[List[EntryTupOrNone]] = []
+
+    nt = len(tree_shas)
+    for tree_sha in tree_shas:
+        if tree_sha is None:
+            data: List[EntryTupOrNone] = []
+        else:
+            # Make new list for typing as list invariant.
+            data = list(tree_entries_from_data(odb.stream(tree_sha).read()))
+        # END handle muted trees
+        trees_data.append(data)
+    # END for each sha to get data for
+
+    out: List[Tuple[EntryTupOrNone, ...]] = []
+
+    # Find all matching entries and recursively process them together if the match is a
+    # tree. If the match is a non-tree item, put it into the result.
+    # Processed items will be set None.
+    for ti, tree_data in enumerate(trees_data):
+        for ii, item in enumerate(tree_data):
+            if not item:
+                continue
+            # END skip already done items
+            entries: List[EntryTupOrNone]
+            entries = [None for _ in range(nt)]
+            entries[ti] = item
+            _sha, mode, name = item
+            is_dir = S_ISDIR(mode)  # Type mode bits
+
+            # Find this item in all other tree data items.
+            # Wrap around, but stop one before our current index, hence ti+nt, not
+            # ti+1+nt.
+            for tio in range(ti + 1, ti + nt):
+                tio = tio % nt
+                entries[tio] = _find_by_name(trees_data[tio], name, is_dir, ii)
+
+            # END for each other item data
+            # If we are a directory, enter recursion.
+            if is_dir:
+                out.extend(
+                    traverse_trees_recursive(
+                        odb,
+                        [((ei and ei[0]) or None) for ei in entries],
+                        path_prefix + name + "/",
+                    )
+                )
+            else:
+                out.append(tuple(_to_full_path(e, path_prefix) for e in entries))
+
+            # END handle recursion
+            # Finally mark it done.
+            tree_data[ii] = None
+        # END for each item
+
+        # We are done with one tree, set all its data empty.
+        del tree_data[:]
+    # END for each tree_data chunk
+    return out
+
+
+def traverse_tree_recursive(odb: "GitCmdObjectDB", tree_sha: bytes, path_prefix: str) -> List[EntryTup]:
+    """
+    :return:
+        List of entries of the tree pointed to by the binary `tree_sha`.
+
+        An entry has the following format:
+
+        * [0] 20 byte sha
+        * [1] mode as int
+        * [2] path relative to the repository
+
+    :param path_prefix:
+        Prefix to prepend to the front of all returned paths.
+    """
+    entries = []
+    data = tree_entries_from_data(odb.stream(tree_sha).read())
+
+    # Unpacking/packing is faster than accessing individual items.
+    for sha, mode, name in data:
+        if S_ISDIR(mode):
+            entries.extend(traverse_tree_recursive(odb, sha, path_prefix + name + "/"))
+        else:
+            entries.append((sha, mode, path_prefix + name))
+    # END for each item
+
+    return entries
diff --git a/llm/Lib/site-packages/git/objects/submodule/__init__.py b/llm/Lib/site-packages/git/objects/submodule/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c0604e76f42559e1189a2c2114d5e638a7e808a4
--- /dev/null
+++ b/llm/Lib/site-packages/git/objects/submodule/__init__.py
@@ -0,0 +1,7 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+__all__ = ["Submodule", "UpdateProgress", "RootModule", "RootUpdateProgress"]
+
+from .base import Submodule, UpdateProgress
+from .root import RootModule, RootUpdateProgress
diff --git a/llm/Lib/site-packages/git/objects/submodule/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/git/objects/submodule/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8f20f5caa45464d6c99c9523f0f8405c1771e123
Binary files /dev/null and b/llm/Lib/site-packages/git/objects/submodule/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/objects/submodule/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/git/objects/submodule/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ff00131df676717285878fe8d00d4c6cd75df0c4
Binary files /dev/null and b/llm/Lib/site-packages/git/objects/submodule/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/objects/submodule/__pycache__/root.cpython-311.pyc b/llm/Lib/site-packages/git/objects/submodule/__pycache__/root.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7142722f2bbb5c36e0cfa167c6874cc53818acae
Binary files /dev/null and b/llm/Lib/site-packages/git/objects/submodule/__pycache__/root.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/objects/submodule/__pycache__/util.cpython-311.pyc b/llm/Lib/site-packages/git/objects/submodule/__pycache__/util.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e1ae854a22d9d238f83d7ef1f44f3cdfd68d8bbe
Binary files /dev/null and b/llm/Lib/site-packages/git/objects/submodule/__pycache__/util.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/objects/submodule/base.py b/llm/Lib/site-packages/git/objects/submodule/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..fa60bcdaf840fdc542ee5a776c239f4885289a14
--- /dev/null
+++ b/llm/Lib/site-packages/git/objects/submodule/base.py
@@ -0,0 +1,1632 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+__all__ = ["Submodule", "UpdateProgress"]
+
+import gc
+from io import BytesIO
+import logging
+import os
+import os.path as osp
+import stat
+import sys
+import uuid
+
+import git
+from git.cmd import Git
+from git.compat import defenc
+from git.config import GitConfigParser, SectionConstraint, cp
+from git.exc import (
+    BadName,
+    InvalidGitRepositoryError,
+    NoSuchPathError,
+    RepositoryDirtyError,
+)
+from git.objects.base import IndexObject, Object
+from git.objects.util import TraversableIterableObj
+from git.util import (
+    IterableList,
+    RemoteProgress,
+    join_path_native,
+    rmtree,
+    to_native_path_linux,
+    unbare_repo,
+)
+
+from .util import (
+    SubmoduleConfigParser,
+    find_first_remote_branch,
+    mkhead,
+    sm_name,
+    sm_section,
+)
+
+# typing ----------------------------------------------------------------------
+
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterator,
+    Mapping,
+    Sequence,
+    TYPE_CHECKING,
+    Union,
+    cast,
+)
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from typing_extensions import Literal
+
+from git.types import Commit_ish, PathLike, TBD
+
+if TYPE_CHECKING:
+    from git.index import IndexFile
+    from git.objects.commit import Commit
+    from git.refs import Head
+    from git.repo import Repo
+
+# -----------------------------------------------------------------------------
+
+_logger = logging.getLogger(__name__)
+
+
+class UpdateProgress(RemoteProgress):
+    """Class providing detailed progress information to the caller who should
+    derive from it and implement the
+    :meth:`update(...) <git.util.RemoteProgress.update>` message."""
+
+    CLONE, FETCH, UPDWKTREE = [1 << x for x in range(RemoteProgress._num_op_codes, RemoteProgress._num_op_codes + 3)]
+    _num_op_codes: int = RemoteProgress._num_op_codes + 3
+
+    __slots__ = ()
+
+
+BEGIN = UpdateProgress.BEGIN
+END = UpdateProgress.END
+CLONE = UpdateProgress.CLONE
+FETCH = UpdateProgress.FETCH
+UPDWKTREE = UpdateProgress.UPDWKTREE
+
+
+# IndexObject comes via the util module. It's a 'hacky' fix thanks to Python's import
+# mechanism, which causes plenty of trouble if the only reason for packages and modules
+# is refactoring - subpackages shouldn't depend on parent packages.
+class Submodule(IndexObject, TraversableIterableObj):
+    """Implements access to a git submodule. They are special in that their sha
+    represents a commit in the submodule's repository which is to be checked out
+    at the path of this instance.
+
+    The submodule type does not have a string type associated with it, as it exists
+    solely as a marker in the tree and index.
+
+    All methods work in bare and non-bare repositories.
+    """
+
+    _id_attribute_ = "name"
+    k_modules_file = ".gitmodules"
+    k_head_option = "branch"
+    k_head_default = "master"
+    k_default_mode = stat.S_IFDIR | stat.S_IFLNK
+    """Submodule flags. Submodules are directories with link-status."""
+
+    type: Literal["submodule"] = "submodule"  # type: ignore[assignment]
+    """This is a bogus type string for base class compatibility."""
+
+    __slots__ = ("_parent_commit", "_url", "_branch_path", "_name", "__weakref__")
+
+    _cache_attrs = ("path", "_url", "_branch_path")
+
+    def __init__(
+        self,
+        repo: "Repo",
+        binsha: bytes,
+        mode: Union[int, None] = None,
+        path: Union[PathLike, None] = None,
+        name: Union[str, None] = None,
+        parent_commit: Union["Commit", None] = None,
+        url: Union[str, None] = None,
+        branch_path: Union[PathLike, None] = None,
+    ) -> None:
+        """Initialize this instance with its attributes.
+
+        We only document the parameters that differ from
+        :class:`~git.objects.base.IndexObject`.
+
+        :param repo:
+            Our parent repository.
+
+        :param binsha:
+            Binary sha referring to a commit in the remote repository.
+            See the `url` parameter.
+
+        :param parent_commit:
+            The :class:`~git.objects.commit.Commit` whose tree is supposed to contain
+            the ``.gitmodules`` blob, or ``None`` to always point to the most recent
+            commit. See :meth:`set_parent_commit` for details.
+
+        :param url:
+            The URL to the remote repository which is the submodule.
+
+        :param branch_path:
+            Full repository-relative path to ref to checkout when cloning the remote
+            repository.
+        """
+        super().__init__(repo, binsha, mode, path)
+        self.size = 0
+        self._parent_commit = parent_commit
+        if url is not None:
+            self._url = url
+        if branch_path is not None:
+            self._branch_path = branch_path
+        if name is not None:
+            self._name = name
+
+    def _set_cache_(self, attr: str) -> None:
+        if attr in ("path", "_url", "_branch_path"):
+            reader: SectionConstraint = self.config_reader()
+            # Default submodule values.
+            try:
+                self.path = reader.get("path")
+            except cp.NoSectionError as e:
+                if self.repo.working_tree_dir is not None:
+                    raise ValueError(
+                        "This submodule instance does not exist anymore in '%s' file"
+                        % osp.join(self.repo.working_tree_dir, ".gitmodules")
+                    ) from e
+
+            self._url = reader.get("url")
+            # GitPython extension values - optional.
+            self._branch_path = reader.get_value(self.k_head_option, git.Head.to_full_path(self.k_head_default))
+        elif attr == "_name":
+            raise AttributeError("Cannot retrieve the name of a submodule if it was not set initially")
+        else:
+            super()._set_cache_(attr)
+        # END handle attribute name
+
+    @classmethod
+    def _get_intermediate_items(cls, item: "Submodule") -> IterableList["Submodule"]:
+        """:return: All the submodules of our module repository"""
+        try:
+            return cls.list_items(item.module())
+        except InvalidGitRepositoryError:
+            return IterableList("")
+        # END handle intermediate items
+
+    @classmethod
+    def _need_gitfile_submodules(cls, git: Git) -> bool:
+        return git.version_info[:3] >= (1, 7, 5)
+
+    def __eq__(self, other: Any) -> bool:
+        """Compare with another submodule."""
+        # We may only compare by name as this should be the ID they are hashed with.
+        # Otherwise this type wouldn't be hashable.
+        # return self.path == other.path and self.url == other.url and super().__eq__(other)
+        return self._name == other._name
+
+    def __ne__(self, other: object) -> bool:
+        """Compare with another submodule for inequality."""
+        return not (self == other)
+
+    def __hash__(self) -> int:
+        """Hash this instance using its logical id, not the sha."""
+        return hash(self._name)
+
+    def __str__(self) -> str:
+        return self._name
+
+    def __repr__(self) -> str:
+        return "git.%s(name=%s, path=%s, url=%s, branch_path=%s)" % (
+            type(self).__name__,
+            self._name,
+            self.path,
+            self.url,
+            self.branch_path,
+        )
+
+    @classmethod
+    def _config_parser(
+        cls, repo: "Repo", parent_commit: Union["Commit", None], read_only: bool
+    ) -> SubmoduleConfigParser:
+        """
+        :return:
+            Config parser constrained to our submodule in read or write mode
+
+        :raise IOError:
+            If the ``.gitmodules`` file cannot be found, either locally or in the
+            repository at the given parent commit. Otherwise the exception would be
+            delayed until the first access of the config parser.
+        """
+        parent_matches_head = True
+        if parent_commit is not None:
+            try:
+                parent_matches_head = repo.head.commit == parent_commit
+            except ValueError:
+                # We are most likely in an empty repository, so the HEAD doesn't point
+                # to a valid ref.
+                pass
+        # END handle parent_commit
+        fp_module: Union[str, BytesIO]
+        if not repo.bare and parent_matches_head and repo.working_tree_dir:
+            fp_module = osp.join(repo.working_tree_dir, cls.k_modules_file)
+        else:
+            assert parent_commit is not None, "need valid parent_commit in bare repositories"
+            try:
+                fp_module = cls._sio_modules(parent_commit)
+            except KeyError as e:
+                raise IOError(
+                    "Could not find %s file in the tree of parent commit %s" % (cls.k_modules_file, parent_commit)
+                ) from e
+            # END handle exceptions
+        # END handle non-bare working tree
+
+        if not read_only and (repo.bare or not parent_matches_head):
+            raise ValueError("Cannot write blobs of 'historical' submodule configurations")
+        # END handle writes of historical submodules
+
+        return SubmoduleConfigParser(fp_module, read_only=read_only)
+
+    def _clear_cache(self) -> None:
+        """Clear the possibly changed values."""
+        for name in self._cache_attrs:
+            try:
+                delattr(self, name)
+            except AttributeError:
+                pass
+            # END try attr deletion
+        # END for each name to delete
+
+    @classmethod
+    def _sio_modules(cls, parent_commit: "Commit") -> BytesIO:
+        """
+        :return:
+            Configuration file as :class:`~io.BytesIO` - we only access it through the
+            respective blob's data
+        """
+        sio = BytesIO(parent_commit.tree[cls.k_modules_file].data_stream.read())
+        sio.name = cls.k_modules_file
+        return sio
+
+    def _config_parser_constrained(self, read_only: bool) -> SectionConstraint:
+        """:return: Config parser constrained to our submodule in read or write mode"""
+        try:
+            pc = self.parent_commit
+        except ValueError:
+            pc = None
+        # END handle empty parent repository
+        parser = self._config_parser(self.repo, pc, read_only)
+        parser.set_submodule(self)
+        return SectionConstraint(parser, sm_section(self.name))
+
+    @classmethod
+    def _module_abspath(cls, parent_repo: "Repo", path: PathLike, name: str) -> PathLike:
+        if cls._need_gitfile_submodules(parent_repo.git):
+            return osp.join(parent_repo.git_dir, "modules", name)
+        if parent_repo.working_tree_dir:
+            return osp.join(parent_repo.working_tree_dir, path)
+        raise NotADirectoryError()
+
+    @classmethod
+    def _clone_repo(
+        cls,
+        repo: "Repo",
+        url: str,
+        path: PathLike,
+        name: str,
+        allow_unsafe_options: bool = False,
+        allow_unsafe_protocols: bool = False,
+        **kwargs: Any,
+    ) -> "Repo":
+        """
+        :return:
+            :class:`~git.repo.base.Repo` instance of newly cloned repository.
+
+        :param repo:
+            Our parent repository.
+
+        :param url:
+            URL to clone from.
+
+        :param path:
+            Repository-relative path to the submodule checkout location.
+
+        :param name:
+            Canonical name of the submodule.
+
+        :param allow_unsafe_protocols:
+            Allow unsafe protocols to be used, like ``ext``.
+
+        :param allow_unsafe_options:
+            Allow unsafe options to be used, like ``--upload-pack``.
+
+        :param kwargs:
+            Additional arguments given to :manpage:`git-clone(1)`.
+        """
+        module_abspath = cls._module_abspath(repo, path, name)
+        module_checkout_path = module_abspath
+        if cls._need_gitfile_submodules(repo.git):
+            kwargs["separate_git_dir"] = module_abspath
+            module_abspath_dir = osp.dirname(module_abspath)
+            if not osp.isdir(module_abspath_dir):
+                os.makedirs(module_abspath_dir)
+            module_checkout_path = osp.join(str(repo.working_tree_dir), path)
+
+        clone = git.Repo.clone_from(
+            url,
+            module_checkout_path,
+            allow_unsafe_options=allow_unsafe_options,
+            allow_unsafe_protocols=allow_unsafe_protocols,
+            **kwargs,
+        )
+        if cls._need_gitfile_submodules(repo.git):
+            cls._write_git_file_and_module_config(module_checkout_path, module_abspath)
+
+        return clone
+
+    @classmethod
+    def _to_relative_path(cls, parent_repo: "Repo", path: PathLike) -> PathLike:
+        """:return: A path guaranteed to be relative to the given parent repository
+
+        :raise ValueError:
+            If path is not contained in the parent repository's working tree.
+        """
+        path = to_native_path_linux(path)
+        if path.endswith("/"):
+            path = path[:-1]
+        # END handle trailing slash
+
+        if osp.isabs(path) and parent_repo.working_tree_dir:
+            working_tree_linux = to_native_path_linux(parent_repo.working_tree_dir)
+            if not path.startswith(working_tree_linux):
+                raise ValueError(
+                    "Submodule checkout path '%s' needs to be within the parents repository at '%s'"
+                    % (working_tree_linux, path)
+                )
+            path = path[len(working_tree_linux.rstrip("/")) + 1 :]
+            if not path:
+                raise ValueError("Absolute submodule path '%s' didn't yield a valid relative path" % path)
+            # END verify converted relative path makes sense
+        # END convert to a relative path
+
+        return path
+
+    @classmethod
+    def _write_git_file_and_module_config(cls, working_tree_dir: PathLike, module_abspath: PathLike) -> None:
+        """Write a ``.git`` file containing a (preferably) relative path to the actual
+        git module repository.
+
+        It is an error if the `module_abspath` cannot be made into a relative path,
+        relative to the `working_tree_dir`.
+
+        :note:
+            This will overwrite existing files!
+
+        :note:
+            As we rewrite both the git file as well as the module configuration, we
+            might fail on the configuration and will not roll back changes done to the
+            git file. This should be a non-issue, but may easily be fixed if it becomes
+            one.
+
+        :param working_tree_dir:
+            Directory to write the ``.git`` file into.
+
+        :param module_abspath:
+            Absolute path to the bare repository.
+        """
+        git_file = osp.join(working_tree_dir, ".git")
+        rela_path = osp.relpath(module_abspath, start=working_tree_dir)
+        if sys.platform == "win32" and osp.isfile(git_file):
+            os.remove(git_file)
+        with open(git_file, "wb") as fp:
+            fp.write(("gitdir: %s" % rela_path).encode(defenc))
+
+        with GitConfigParser(osp.join(module_abspath, "config"), read_only=False, merge_includes=False) as writer:
+            writer.set_value(
+                "core",
+                "worktree",
+                to_native_path_linux(osp.relpath(working_tree_dir, start=module_abspath)),
+            )
+
+    # { Edit Interface
+
+    @classmethod
+    def add(
+        cls,
+        repo: "Repo",
+        name: str,
+        path: PathLike,
+        url: Union[str, None] = None,
+        branch: Union[str, None] = None,
+        no_checkout: bool = False,
+        depth: Union[int, None] = None,
+        env: Union[Mapping[str, str], None] = None,
+        clone_multi_options: Union[Sequence[TBD], None] = None,
+        allow_unsafe_options: bool = False,
+        allow_unsafe_protocols: bool = False,
+    ) -> "Submodule":
+        """Add a new submodule to the given repository. This will alter the index as
+        well as the ``.gitmodules`` file, but will not create a new commit. If the
+        submodule already exists, no matter if the configuration differs from the one
+        provided, the existing submodule will be returned.
+
+        :param repo:
+            Repository instance which should receive the submodule.
+
+        :param name:
+            The name/identifier for the submodule.
+
+        :param path:
+            Repository-relative or absolute path at which the submodule should be
+            located.
+            It will be created as required during the repository initialization.
+
+        :param url:
+            ``git clone ...``-compatible URL. See :manpage:`git-clone(1)` for more
+            information. If ``None``, the repository is assumed to exist, and the URL of
+            the first remote is taken instead. This is useful if you want to make an
+            existing repository a submodule of another one.
+
+        :param branch:
+            Name of branch at which the submodule should (later) be checked out. The
+            given branch must exist in the remote repository, and will be checked out
+            locally as a tracking branch.
+            It will only be written into the configuration if it not ``None``, which is
+            when the checked out branch will be the one the remote HEAD pointed to.
+            The result you get in these situation is somewhat fuzzy, and it is
+            recommended to specify at least ``master`` here.
+            Examples are ``master`` or ``feature/new``.
+
+        :param no_checkout:
+            If ``True``, and if the repository has to be cloned manually, no checkout
+            will be performed.
+
+        :param depth:
+            Create a shallow clone with a history truncated to the specified number of
+            commits.
+
+        :param env:
+            Optional dictionary containing the desired environment variables.
+
+            Note: Provided variables will be used to update the execution environment
+            for ``git``. If some variable is not specified in `env` and is defined in
+            attr:`os.environ`, the value from attr:`os.environ` will be used. If you
+            want to unset some variable, consider providing an empty string as its
+            value.
+
+        :param clone_multi_options:
+            A list of clone options. Please see
+            :meth:`Repo.clone <git.repo.base.Repo.clone>` for details.
+
+        :param allow_unsafe_protocols:
+            Allow unsafe protocols to be used, like ``ext``.
+
+        :param allow_unsafe_options:
+            Allow unsafe options to be used, like ``--upload-pack``.
+
+        :return:
+            The newly created :class:`Submodule` instance.
+
+        :note:
+            Works atomically, such that no change will be done if, for example, the
+            repository update fails.
+        """
+        if repo.bare:
+            raise InvalidGitRepositoryError("Cannot add submodules to bare repositories")
+        # END handle bare repos
+
+        path = cls._to_relative_path(repo, path)
+
+        # Ensure we never put backslashes into the URL, as might happen on Windows.
+        if url is not None:
+            url = to_native_path_linux(url)
+        # END ensure URL correctness
+
+        # INSTANTIATE INTERMEDIATE SM
+        sm = cls(
+            repo,
+            cls.NULL_BIN_SHA,
+            cls.k_default_mode,
+            path,
+            name,
+            url="invalid-temporary",
+        )
+        if sm.exists():
+            # Reretrieve submodule from tree.
+            try:
+                sm = repo.head.commit.tree[str(path)]
+                sm._name = name
+                return sm
+            except KeyError:
+                # Could only be in index.
+                index = repo.index
+                entry = index.entries[index.entry_key(path, 0)]
+                sm.binsha = entry.binsha
+                return sm
+            # END handle exceptions
+        # END handle existing
+
+        # fake-repo - we only need the functionality on the branch instance.
+        br = git.Head(repo, git.Head.to_full_path(str(branch) or cls.k_head_default))
+        has_module = sm.module_exists()
+        branch_is_default = branch is None
+        if has_module and url is not None:
+            if url not in [r.url for r in sm.module().remotes]:
+                raise ValueError(
+                    "Specified URL '%s' does not match any remote url of the repository at '%s'" % (url, sm.abspath)
+                )
+            # END check url
+        # END verify urls match
+
+        mrepo: Union[Repo, None] = None
+
+        if url is None:
+            if not has_module:
+                raise ValueError("A URL was not given and a repository did not exist at %s" % path)
+            # END check url
+            mrepo = sm.module()
+            # assert isinstance(mrepo, git.Repo)
+            urls = [r.url for r in mrepo.remotes]
+            if not urls:
+                raise ValueError("Didn't find any remote url in repository at %s" % sm.abspath)
+            # END verify we have url
+            url = urls[0]
+        else:
+            # Clone new repo.
+            kwargs: Dict[str, Union[bool, int, str, Sequence[TBD]]] = {"n": no_checkout}
+            if not branch_is_default:
+                kwargs["b"] = br.name
+            # END setup checkout-branch
+
+            if depth:
+                if isinstance(depth, int):
+                    kwargs["depth"] = depth
+                else:
+                    raise ValueError("depth should be an integer")
+            if clone_multi_options:
+                kwargs["multi_options"] = clone_multi_options
+
+            # _clone_repo(cls, repo, url, path, name, **kwargs):
+            mrepo = cls._clone_repo(
+                repo,
+                url,
+                path,
+                name,
+                env=env,
+                allow_unsafe_options=allow_unsafe_options,
+                allow_unsafe_protocols=allow_unsafe_protocols,
+                **kwargs,
+            )
+        # END verify url
+
+        ## See #525 for ensuring git URLs in config-files are valid under Windows.
+        url = Git.polish_url(url)
+
+        # It's important to add the URL to the parent config, to let `git submodule` know.
+        # Otherwise there is a '-' character in front of the submodule listing:
+        #  a38efa84daef914e4de58d1905a500d8d14aaf45 mymodule (v0.9.0-1-ga38efa8)
+        # -a38efa84daef914e4de58d1905a500d8d14aaf45 submodules/intermediate/one
+        writer: Union[GitConfigParser, SectionConstraint]
+
+        with sm.repo.config_writer() as writer:
+            writer.set_value(sm_section(name), "url", url)
+
+        # Update configuration and index.
+        index = sm.repo.index
+        with sm.config_writer(index=index, write=False) as writer:
+            writer.set_value("url", url)
+            writer.set_value("path", path)
+
+            sm._url = url
+            if not branch_is_default:
+                # Store full path.
+                writer.set_value(cls.k_head_option, br.path)
+                sm._branch_path = br.path
+
+        # We deliberately assume that our head matches our index!
+        if mrepo:
+            sm.binsha = mrepo.head.commit.binsha
+        index.add([sm], write=True)
+
+        return sm
+
+    def update(
+        self,
+        recursive: bool = False,
+        init: bool = True,
+        to_latest_revision: bool = False,
+        progress: Union["UpdateProgress", None] = None,
+        dry_run: bool = False,
+        force: bool = False,
+        keep_going: bool = False,
+        env: Union[Mapping[str, str], None] = None,
+        clone_multi_options: Union[Sequence[TBD], None] = None,
+        allow_unsafe_options: bool = False,
+        allow_unsafe_protocols: bool = False,
+    ) -> "Submodule":
+        """Update the repository of this submodule to point to the checkout we point at
+        with the binsha of this instance.
+
+        :param recursive:
+            If ``True``, we will operate recursively and update child modules as well.
+
+        :param init:
+            If ``True``, the module repository will be cloned into place if necessary.
+
+        :param to_latest_revision:
+            If ``True``, the submodule's sha will be ignored during checkout. Instead,
+            the remote will be fetched, and the local tracking branch updated. This only
+            works if we have a local tracking branch, which is the case if the remote
+            repository had a master branch, or if the ``branch`` option was specified
+            for this submodule and the branch existed remotely.
+
+        :param progress:
+            :class:`UpdateProgress` instance, or ``None`` if no progress should be
+            shown.
+
+        :param dry_run:
+            If ``True``, the operation will only be simulated, but not performed.
+            All performed operations are read-only.
+
+        :param force:
+            If ``True``, we may reset heads even if the repository in question is dirty.
+            Additionally we will be allowed to set a tracking branch which is ahead of
+            its remote branch back into the past or the location of the remote branch.
+            This will essentially 'forget' commits.
+
+            If ``False``, local tracking branches that are in the future of their
+            respective remote branches will simply not be moved.
+
+        :param keep_going:
+            If ``True``, we will ignore but log all errors, and keep going recursively.
+            Unless `dry_run` is set as well, `keep_going` could cause
+            subsequent/inherited errors you wouldn't see otherwise.
+            In conjunction with `dry_run`, it can be useful to anticipate all errors
+            when updating submodules.
+
+        :param env:
+            Optional dictionary containing the desired environment variables.
+
+            Note: Provided variables will be used to update the execution environment
+            for ``git``. If some variable is not specified in `env` and is defined in
+            attr:`os.environ`, value from attr:`os.environ` will be used.
+
+            If you want to unset some variable, consider providing the empty string as
+            its value.
+
+        :param clone_multi_options:
+            List of :manpage:`git-clone(1)` options.
+            Please see :meth:`Repo.clone <git.repo.base.Repo.clone>` for details.
+            They only take effect with the `init` option.
+
+        :param allow_unsafe_protocols:
+            Allow unsafe protocols to be used, like ``ext``.
+
+        :param allow_unsafe_options:
+            Allow unsafe options to be used, like ``--upload-pack``.
+
+        :note:
+            Does nothing in bare repositories.
+
+        :note:
+            This method is definitely not atomic if `recursive` is ``True``.
+
+        :return:
+            self
+        """
+        if self.repo.bare:
+            return self
+        # END pass in bare mode
+
+        if progress is None:
+            progress = UpdateProgress()
+        # END handle progress
+        prefix = ""
+        if dry_run:
+            prefix = "DRY-RUN: "
+        # END handle prefix
+
+        # To keep things plausible in dry-run mode.
+        if dry_run:
+            mrepo = None
+        # END init mrepo
+
+        try:
+            # ENSURE REPO IS PRESENT AND UP-TO-DATE
+            #######################################
+            try:
+                mrepo = self.module()
+                rmts = mrepo.remotes
+                len_rmts = len(rmts)
+                for i, remote in enumerate(rmts):
+                    op = FETCH
+                    if i == 0:
+                        op |= BEGIN
+                    # END handle start
+
+                    progress.update(
+                        op,
+                        i,
+                        len_rmts,
+                        prefix + "Fetching remote %s of submodule %r" % (remote, self.name),
+                    )
+                    # ===============================
+                    if not dry_run:
+                        remote.fetch(progress=progress)
+                    # END handle dry-run
+                    # ===============================
+                    if i == len_rmts - 1:
+                        op |= END
+                    # END handle end
+                    progress.update(
+                        op,
+                        i,
+                        len_rmts,
+                        prefix + "Done fetching remote of submodule %r" % self.name,
+                    )
+                # END fetch new data
+            except InvalidGitRepositoryError:
+                mrepo = None
+                if not init:
+                    return self
+                # END early abort if init is not allowed
+
+                # There is no git-repository yet - but delete empty paths.
+                checkout_module_abspath = self.abspath
+                if not dry_run and osp.isdir(checkout_module_abspath):
+                    try:
+                        os.rmdir(checkout_module_abspath)
+                    except OSError as e:
+                        raise OSError(
+                            "Module directory at %r does already exist and is non-empty" % checkout_module_abspath
+                        ) from e
+                    # END handle OSError
+                # END handle directory removal
+
+                # Don't check it out at first - nonetheless it will create a local
+                # branch according to the remote-HEAD if possible.
+                progress.update(
+                    BEGIN | CLONE,
+                    0,
+                    1,
+                    prefix
+                    + "Cloning url '%s' to '%s' in submodule %r" % (self.url, checkout_module_abspath, self.name),
+                )
+                if not dry_run:
+                    mrepo = self._clone_repo(
+                        self.repo,
+                        self.url,
+                        self.path,
+                        self.name,
+                        n=True,
+                        env=env,
+                        multi_options=clone_multi_options,
+                        allow_unsafe_options=allow_unsafe_options,
+                        allow_unsafe_protocols=allow_unsafe_protocols,
+                    )
+                # END handle dry-run
+                progress.update(
+                    END | CLONE,
+                    0,
+                    1,
+                    prefix + "Done cloning to %s" % checkout_module_abspath,
+                )
+
+                if not dry_run:
+                    # See whether we have a valid branch to check out.
+                    try:
+                        mrepo = cast("Repo", mrepo)
+                        # Find a remote which has our branch - we try to be flexible.
+                        remote_branch = find_first_remote_branch(mrepo.remotes, self.branch_name)
+                        local_branch = mkhead(mrepo, self.branch_path)
+
+                        # Have a valid branch, but no checkout - make sure we can figure
+                        # that out by marking the commit with a null_sha.
+                        local_branch.set_object(Object(mrepo, self.NULL_BIN_SHA))
+                        # END initial checkout + branch creation
+
+                        # Make sure HEAD is not detached.
+                        mrepo.head.set_reference(
+                            local_branch,
+                            logmsg="submodule: attaching head to %s" % local_branch,
+                        )
+                        mrepo.head.reference.set_tracking_branch(remote_branch)
+                    except (IndexError, InvalidGitRepositoryError):
+                        _logger.warning("Failed to checkout tracking branch %s", self.branch_path)
+                    # END handle tracking branch
+
+                    # NOTE: Have to write the repo config file as well, otherwise the
+                    # default implementation will be offended and not update the
+                    # repository. Maybe this is a good way to ensure it doesn't get into
+                    # our way, but we want to stay backwards compatible too... It's so
+                    # redundant!
+                    with self.repo.config_writer() as writer:
+                        writer.set_value(sm_section(self.name), "url", self.url)
+                # END handle dry_run
+            # END handle initialization
+
+            # DETERMINE SHAS TO CHECK OUT
+            #############################
+            binsha = self.binsha
+            hexsha = self.hexsha
+            if mrepo is not None:
+                # mrepo is only set if we are not in dry-run mode or if the module
+                # existed.
+                is_detached = mrepo.head.is_detached
+            # END handle dry_run
+
+            if mrepo is not None and to_latest_revision:
+                msg_base = "Cannot update to latest revision in repository at %r as " % mrepo.working_dir
+                if not is_detached:
+                    rref = mrepo.head.reference.tracking_branch()
+                    if rref is not None:
+                        rcommit = rref.commit
+                        binsha = rcommit.binsha
+                        hexsha = rcommit.hexsha
+                    else:
+                        _logger.error(
+                            "%s a tracking branch was not set for local branch '%s'",
+                            msg_base,
+                            mrepo.head.reference,
+                        )
+                    # END handle remote ref
+                else:
+                    _logger.error("%s there was no local tracking branch", msg_base)
+                # END handle detached head
+            # END handle to_latest_revision option
+
+            # Update the working tree.
+            # Handles dry_run.
+            if mrepo is not None and mrepo.head.commit.binsha != binsha:
+                # We must ensure that our destination sha (the one to point to) is in
+                # the future of our current head. Otherwise, we will reset changes that
+                # might have been done on the submodule, but were not yet pushed. We
+                # also handle the case that history has been rewritten, leaving no
+                # merge-base. In that case we behave conservatively, protecting possible
+                # changes the user had done.
+                may_reset = True
+                if mrepo.head.commit.binsha != self.NULL_BIN_SHA:
+                    base_commit = mrepo.merge_base(mrepo.head.commit, hexsha)
+                    if len(base_commit) == 0 or (base_commit[0] is not None and base_commit[0].hexsha == hexsha):
+                        if force:
+                            msg = "Will force checkout or reset on local branch that is possibly in the future of"
+                            msg += " the commit it will be checked out to, effectively 'forgetting' new commits"
+                            _logger.debug(msg)
+                        else:
+                            msg = "Skipping %s on branch '%s' of submodule repo '%s' as it contains un-pushed commits"
+                            msg %= (
+                                is_detached and "checkout" or "reset",
+                                mrepo.head,
+                                mrepo,
+                            )
+                            _logger.info(msg)
+                            may_reset = False
+                        # END handle force
+                    # END handle if we are in the future
+
+                    if may_reset and not force and mrepo.is_dirty(index=True, working_tree=True, untracked_files=True):
+                        raise RepositoryDirtyError(mrepo, "Cannot reset a dirty repository")
+                    # END handle force and dirty state
+                # END handle empty repo
+
+                # END verify future/past
+                progress.update(
+                    BEGIN | UPDWKTREE,
+                    0,
+                    1,
+                    prefix
+                    + "Updating working tree at %s for submodule %r to revision %s" % (self.path, self.name, hexsha),
+                )
+
+                if not dry_run and may_reset:
+                    if is_detached:
+                        # NOTE: For now we force. The user is not supposed to change
+                        # detached submodules anyway. Maybe at some point this becomes
+                        # an option, to properly handle user modifications - see below
+                        # for future options regarding rebase and merge.
+                        mrepo.git.checkout(hexsha, force=force)
+                    else:
+                        mrepo.head.reset(hexsha, index=True, working_tree=True)
+                    # END handle checkout
+                # If we may reset/checkout.
+                progress.update(
+                    END | UPDWKTREE,
+                    0,
+                    1,
+                    prefix + "Done updating working tree for submodule %r" % self.name,
+                )
+            # END update to new commit only if needed
+        except Exception as err:
+            if not keep_going:
+                raise
+            _logger.error(str(err))
+        # END handle keep_going
+
+        # HANDLE RECURSION
+        ##################
+        if recursive:
+            # In dry_run mode, the module might not exist.
+            if mrepo is not None:
+                for submodule in self.iter_items(self.module()):
+                    submodule.update(
+                        recursive,
+                        init,
+                        to_latest_revision,
+                        progress=progress,
+                        dry_run=dry_run,
+                        force=force,
+                        keep_going=keep_going,
+                    )
+                # END handle recursive update
+            # END handle dry run
+        # END for each submodule
+
+        return self
+
+    @unbare_repo
+    def move(self, module_path: PathLike, configuration: bool = True, module: bool = True) -> "Submodule":
+        """Move the submodule to a another module path. This involves physically moving
+        the repository at our current path, changing the configuration, as well as
+        adjusting our index entry accordingly.
+
+        :param module_path:
+            The path to which to move our module in the parent repository's working
+            tree, given as repository-relative or absolute path. Intermediate
+            directories will be created accordingly. If the path already exists, it must
+            be empty. Trailing (back)slashes are removed automatically.
+
+        :param configuration:
+            If ``True``, the configuration will be adjusted to let the submodule point
+            to the given path.
+
+        :param module:
+            If ``True``, the repository managed by this submodule will be moved as well.
+            If ``False``, we don't move the submodule's checkout, which may leave the
+            parent repository in an inconsistent state.
+
+        :return:
+            self
+
+        :raise ValueError:
+            If the module path existed and was not empty, or was a file.
+
+        :note:
+            Currently the method is not atomic, and it could leave the repository in an
+            inconsistent state if a sub-step fails for some reason.
+        """
+        if module + configuration < 1:
+            raise ValueError("You must specify to move at least the module or the configuration of the submodule")
+        # END handle input
+
+        module_checkout_path = self._to_relative_path(self.repo, module_path)
+
+        # VERIFY DESTINATION
+        if module_checkout_path == self.path:
+            return self
+        # END handle no change
+
+        module_checkout_abspath = join_path_native(str(self.repo.working_tree_dir), module_checkout_path)
+        if osp.isfile(module_checkout_abspath):
+            raise ValueError("Cannot move repository onto a file: %s" % module_checkout_abspath)
+        # END handle target files
+
+        index = self.repo.index
+        tekey = index.entry_key(module_checkout_path, 0)
+        # if the target item already exists, fail
+        if configuration and tekey in index.entries:
+            raise ValueError("Index entry for target path did already exist")
+        # END handle index key already there
+
+        # Remove existing destination.
+        if module:
+            if osp.exists(module_checkout_abspath):
+                if len(os.listdir(module_checkout_abspath)):
+                    raise ValueError("Destination module directory was not empty")
+                # END handle non-emptiness
+
+                if osp.islink(module_checkout_abspath):
+                    os.remove(module_checkout_abspath)
+                else:
+                    os.rmdir(module_checkout_abspath)
+                # END handle link
+            else:
+                # Recreate parent directories.
+                # NOTE: renames() does that now.
+                pass
+            # END handle existence
+        # END handle module
+
+        # Move the module into place if possible.
+        cur_path = self.abspath
+        renamed_module = False
+        if module and osp.exists(cur_path):
+            os.renames(cur_path, module_checkout_abspath)
+            renamed_module = True
+
+            if osp.isfile(osp.join(module_checkout_abspath, ".git")):
+                module_abspath = self._module_abspath(self.repo, self.path, self.name)
+                self._write_git_file_and_module_config(module_checkout_abspath, module_abspath)
+            # END handle git file rewrite
+        # END move physical module
+
+        # Rename the index entry - we have to manipulate the index directly as git-mv
+        # cannot be used on submodules... yeah.
+        previous_sm_path = self.path
+        try:
+            if configuration:
+                try:
+                    ekey = index.entry_key(self.path, 0)
+                    entry = index.entries[ekey]
+                    del index.entries[ekey]
+                    nentry = git.IndexEntry(entry[:3] + (module_checkout_path,) + entry[4:])
+                    index.entries[tekey] = nentry
+                except KeyError as e:
+                    raise InvalidGitRepositoryError("Submodule's entry at %r did not exist" % (self.path)) from e
+                # END handle submodule doesn't exist
+
+                # Update configuration.
+                with self.config_writer(index=index) as writer:  # Auto-write.
+                    writer.set_value("path", module_checkout_path)
+                    self.path = module_checkout_path
+            # END handle configuration flag
+        except Exception:
+            if renamed_module:
+                os.renames(module_checkout_abspath, cur_path)
+            # END undo module renaming
+            raise
+        # END handle undo rename
+
+        # Auto-rename submodule if its name was 'default', that is, the checkout
+        # directory.
+        if previous_sm_path == self.name:
+            self.rename(module_checkout_path)
+
+        return self
+
+    @unbare_repo
+    def remove(
+        self,
+        module: bool = True,
+        force: bool = False,
+        configuration: bool = True,
+        dry_run: bool = False,
+    ) -> "Submodule":
+        """Remove this submodule from the repository. This will remove our entry
+        from the ``.gitmodules`` file and the entry in the ``.git/config`` file.
+
+        :param module:
+            If ``True``, the checked out module we point to will be deleted as well. If
+            that module is currently on a commit outside any branch in the remote, or if
+            it is ahead of its tracking branch, or if there are modified or untracked
+            files in its working tree, then the removal will fail. In case the removal
+            of the repository fails for these reasons, the submodule status will not
+            have been altered.
+
+            If this submodule has child modules of its own, these will be deleted prior
+            to touching the direct submodule.
+
+        :param force:
+            Enforces the deletion of the module even though it contains modifications.
+            This basically enforces a brute-force file system based deletion.
+
+        :param configuration:
+            If ``True``, the submodule is deleted from the configuration, otherwise it
+            isn't. Although this should be enabled most of the time, this flag enables
+            you to safely delete the repository of your submodule.
+
+        :param dry_run:
+            If ``True``, we will not actually do anything, but throw the errors we would
+            usually throw.
+
+        :return:
+            self
+
+        :note:
+            Doesn't work in bare repositories.
+
+        :note:
+            Doesn't work atomically, as failure to remove any part of the submodule will
+            leave an inconsistent state.
+
+        :raise git.exc.InvalidGitRepositoryError:
+            Thrown if the repository cannot be deleted.
+
+        :raise OSError:
+            If directories or files could not be removed.
+        """
+        if not (module or configuration):
+            raise ValueError("Need to specify to delete at least the module, or the configuration")
+        # END handle parameters
+
+        # Recursively remove children of this submodule.
+        nc = 0
+        for csm in self.children():
+            nc += 1
+            csm.remove(module, force, configuration, dry_run)
+            del csm
+
+        if configuration and not dry_run and nc > 0:
+            # Ensure we don't leave the parent repository in a dirty state, and commit
+            # our changes. It's important for recursive, unforced, deletions to work as
+            # expected.
+            self.module().index.commit("Removed at least one of child-modules of '%s'" % self.name)
+        # END handle recursion
+
+        # DELETE REPOSITORY WORKING TREE
+        ################################
+        if module and self.module_exists():
+            mod = self.module()
+            git_dir = mod.git_dir
+            if force:
+                # Take the fast lane and just delete everything in our module path.
+                # TODO: If we run into permission problems, we have a highly
+                # inconsistent state. Delete the .git folders last, start with the
+                # submodules first.
+                mp = self.abspath
+                method: Union[None, Callable[[PathLike], None]] = None
+                if osp.islink(mp):
+                    method = os.remove
+                elif osp.isdir(mp):
+                    method = rmtree
+                elif osp.exists(mp):
+                    raise AssertionError("Cannot forcibly delete repository as it was neither a link, nor a directory")
+                # END handle brutal deletion
+                if not dry_run:
+                    assert method
+                    method(mp)
+                # END apply deletion method
+            else:
+                # Verify we may delete our module.
+                if mod.is_dirty(index=True, working_tree=True, untracked_files=True):
+                    raise InvalidGitRepositoryError(
+                        "Cannot delete module at %s with any modifications, unless force is specified"
+                        % mod.working_tree_dir
+                    )
+                # END check for dirt
+
+                # Figure out whether we have new commits compared to the remotes.
+                # NOTE: If the user pulled all the time, the remote heads might not have
+                # been updated, so commits coming from the remote look as if they come
+                # from us. But we stay strictly read-only and don't fetch beforehand.
+                for remote in mod.remotes:
+                    num_branches_with_new_commits = 0
+                    rrefs = remote.refs
+                    for rref in rrefs:
+                        num_branches_with_new_commits += len(mod.git.cherry(rref)) != 0
+                    # END for each remote ref
+                    # Not a single remote branch contained all our commits.
+                    if len(rrefs) and num_branches_with_new_commits == len(rrefs):
+                        raise InvalidGitRepositoryError(
+                            "Cannot delete module at %s as there are new commits" % mod.working_tree_dir
+                        )
+                    # END handle new commits
+                    # We have to manually delete some references to allow resources to
+                    # be cleaned up immediately when we are done with them, because
+                    # Python's scoping is no more granular than the whole function (loop
+                    # bodies are not scopes). When the objects stay alive longer, they
+                    # can keep handles open. On Windows, this is a problem.
+                    if len(rrefs):
+                        del rref  # skipcq: PYL-W0631
+                    # END handle remotes
+                    del rrefs
+                    del remote
+                # END for each remote
+
+                # Finally delete our own submodule.
+                if not dry_run:
+                    self._clear_cache()
+                    wtd = mod.working_tree_dir
+                    del mod  # Release file-handles (Windows).
+                    gc.collect()
+                    rmtree(str(wtd))
+                # END delete tree if possible
+            # END handle force
+
+            if not dry_run and osp.isdir(git_dir):
+                self._clear_cache()
+                rmtree(git_dir)
+            # END handle separate bare repository
+        # END handle module deletion
+
+        # Void our data so as not to delay invalid access.
+        if not dry_run:
+            self._clear_cache()
+
+        # DELETE CONFIGURATION
+        ######################
+        if configuration and not dry_run:
+            # First the index-entry.
+            parent_index = self.repo.index
+            try:
+                del parent_index.entries[parent_index.entry_key(self.path, 0)]
+            except KeyError:
+                pass
+            # END delete entry
+            parent_index.write()
+
+            # Now git config - we need the config intact, otherwise we can't query
+            # information anymore.
+
+            with self.repo.config_writer() as gcp_writer:
+                gcp_writer.remove_section(sm_section(self.name))
+
+            with self.config_writer() as sc_writer:
+                sc_writer.remove_section()
+        # END delete configuration
+
+        return self
+
+    def set_parent_commit(self, commit: Union[Commit_ish, str, None], check: bool = True) -> "Submodule":
+        """Set this instance to use the given commit whose tree is supposed to
+        contain the ``.gitmodules`` blob.
+
+        :param commit:
+            Commit-ish reference pointing at the root tree, or ``None`` to always point
+            to the most recent commit.
+
+        :param check:
+            If ``True``, relatively expensive checks will be performed to verify
+            validity of the submodule.
+
+        :raise ValueError:
+            If the commit's tree didn't contain the ``.gitmodules`` blob.
+
+        :raise ValueError:
+            If the parent commit didn't store this submodule under the current path.
+
+        :return:
+            self
+        """
+        if commit is None:
+            self._parent_commit = None
+            return self
+        # END handle None
+        pcommit = self.repo.commit(commit)
+        pctree = pcommit.tree
+        if self.k_modules_file not in pctree:
+            raise ValueError("Tree of commit %s did not contain the %s file" % (commit, self.k_modules_file))
+        # END handle exceptions
+
+        prev_pc = self._parent_commit
+        self._parent_commit = pcommit
+
+        if check:
+            parser = self._config_parser(self.repo, self._parent_commit, read_only=True)
+            if not parser.has_section(sm_section(self.name)):
+                self._parent_commit = prev_pc
+                raise ValueError("Submodule at path %r did not exist in parent commit %s" % (self.path, commit))
+            # END handle submodule did not exist
+        # END handle checking mode
+
+        # Update our sha, it could have changed.
+        # If check is False, we might see a parent-commit that doesn't even contain the
+        # submodule anymore. in that case, mark our sha as being NULL.
+        try:
+            self.binsha = pctree[str(self.path)].binsha
+        except KeyError:
+            self.binsha = self.NULL_BIN_SHA
+
+        self._clear_cache()
+        return self
+
+    @unbare_repo
+    def config_writer(
+        self, index: Union["IndexFile", None] = None, write: bool = True
+    ) -> SectionConstraint["SubmoduleConfigParser"]:
+        """
+        :return:
+            A config writer instance allowing you to read and write the data belonging
+            to this submodule into the ``.gitmodules`` file.
+
+        :param index:
+            If not ``None``, an :class:`~git.index.base.IndexFile` instance which should
+            be written. Defaults to the index of the :class:`Submodule`'s parent
+            repository.
+
+        :param write:
+            If ``True``, the index will be written each time a configuration value changes.
+
+        :note:
+            The parameters allow for a more efficient writing of the index, as you can
+            pass in a modified index on your own, prevent automatic writing, and write
+            yourself once the whole operation is complete.
+
+        :raise ValueError:
+            If trying to get a writer on a parent_commit which does not match the
+            current head commit.
+
+        :raise IOError:
+            If the ``.gitmodules`` file/blob could not be read.
+        """
+        writer = self._config_parser_constrained(read_only=False)
+        if index is not None:
+            writer.config._index = index
+        writer.config._auto_write = write
+        return writer
+
+    @unbare_repo
+    def rename(self, new_name: str) -> "Submodule":
+        """Rename this submodule.
+
+        :note:
+            This method takes care of renaming the submodule in various places, such as:
+
+            * ``$parent_git_dir / config``
+            * ``$working_tree_dir / .gitmodules``
+            * (git >= v1.8.0: move submodule repository to new name)
+
+        As ``.gitmodules`` will be changed, you would need to make a commit afterwards.
+        The changed ``.gitmodules`` file will already be added to the index.
+
+        :return:
+            This :class:`Submodule` instance
+        """
+        if self.name == new_name:
+            return self
+
+        # .git/config
+        with self.repo.config_writer() as pw:
+            # As we ourselves didn't write anything about submodules into the parent
+            # .git/config, we will not require it to exist, and just ignore missing
+            # entries.
+            if pw.has_section(sm_section(self.name)):
+                pw.rename_section(sm_section(self.name), sm_section(new_name))
+
+        # .gitmodules
+        with self.config_writer(write=True).config as cw:
+            cw.rename_section(sm_section(self.name), sm_section(new_name))
+
+        self._name = new_name
+
+        # .git/modules
+        mod = self.module()
+        if mod.has_separate_working_tree():
+            destination_module_abspath = self._module_abspath(self.repo, self.path, new_name)
+            source_dir = mod.git_dir
+            # Let's be sure the submodule name is not so obviously tied to a directory.
+            if str(destination_module_abspath).startswith(str(mod.git_dir)):
+                tmp_dir = self._module_abspath(self.repo, self.path, str(uuid.uuid4()))
+                os.renames(source_dir, tmp_dir)
+                source_dir = tmp_dir
+            # END handle self-containment
+            os.renames(source_dir, destination_module_abspath)
+            if mod.working_tree_dir:
+                self._write_git_file_and_module_config(mod.working_tree_dir, destination_module_abspath)
+        # END move separate git repository
+
+        return self
+
+    # } END edit interface
+
+    # { Query Interface
+
+    @unbare_repo
+    def module(self) -> "Repo":
+        """
+        :return:
+            :class:`~git.repo.base.Repo` instance initialized from the repository at our
+            submodule path
+
+        :raise git.exc.InvalidGitRepositoryError:
+            If a repository was not available.
+            This could also mean that it was not yet initialized.
+        """
+        module_checkout_abspath = self.abspath
+        try:
+            repo = git.Repo(module_checkout_abspath)
+            if repo != self.repo:
+                return repo
+            # END handle repo uninitialized
+        except (InvalidGitRepositoryError, NoSuchPathError) as e:
+            raise InvalidGitRepositoryError("No valid repository at %s" % module_checkout_abspath) from e
+        else:
+            raise InvalidGitRepositoryError("Repository at %r was not yet checked out" % module_checkout_abspath)
+        # END handle exceptions
+
+    def module_exists(self) -> bool:
+        """
+        :return:
+            ``True`` if our module exists and is a valid git repository.
+            See the :meth:`module` method.
+        """
+        try:
+            self.module()
+            return True
+        except Exception:
+            return False
+        # END handle exception
+
+    def exists(self) -> bool:
+        """
+        :return:
+            ``True`` if the submodule exists, ``False`` otherwise.
+            Please note that a submodule may exist (in the ``.gitmodules`` file) even
+            though its module doesn't exist on disk.
+        """
+        # Keep attributes for later, and restore them if we have no valid data.
+        # This way we do not actually alter the state of the object.
+        loc = locals()
+        for attr in self._cache_attrs:
+            try:
+                if hasattr(self, attr):
+                    loc[attr] = getattr(self, attr)
+                # END if we have the attribute cache
+            except (cp.NoSectionError, ValueError):
+                # On PY3, this can happen apparently... don't know why this doesn't
+                # happen on PY2.
+                pass
+        # END for each attr
+        self._clear_cache()
+
+        try:
+            try:
+                self.path  # noqa: B018
+                return True
+            except Exception:
+                return False
+            # END handle exceptions
+        finally:
+            for attr in self._cache_attrs:
+                if attr in loc:
+                    setattr(self, attr, loc[attr])
+                # END if we have a cache
+            # END reapply each attribute
+        # END handle object state consistency
+
+    @property
+    def branch(self) -> "Head":
+        """
+        :return:
+            The branch instance that we are to checkout
+
+        :raise git.exc.InvalidGitRepositoryError:
+            If our module is not yet checked out.
+        """
+        return mkhead(self.module(), self._branch_path)
+
+    @property
+    def branch_path(self) -> PathLike:
+        """
+        :return:
+            Full repository-relative path as string to the branch we would checkout from
+            the remote and track
+        """
+        return self._branch_path
+
+    @property
+    def branch_name(self) -> str:
+        """
+        :return:
+            The name of the branch, which is the shortest possible branch name
+        """
+        # Use an instance method, for this we create a temporary Head instance which
+        # uses a repository that is available at least (it makes no difference).
+        return git.Head(self.repo, self._branch_path).name
+
+    @property
+    def url(self) -> str:
+        """:return: The url to the repository our submodule's repository refers to"""
+        return self._url
+
+    @property
+    def parent_commit(self) -> "Commit":
+        """
+        :return:
+            :class:`~git.objects.commit.Commit` instance with the tree containing the
+            ``.gitmodules`` file
+
+        :note:
+            Will always point to the current head's commit if it was not set explicitly.
+        """
+        if self._parent_commit is None:
+            return self.repo.commit()
+        return self._parent_commit
+
+    @property
+    def name(self) -> str:
+        """
+        :return:
+            The name of this submodule. It is used to identify it within the
+            ``.gitmodules`` file.
+
+        :note:
+            By default, this is the name is the path at which to find the submodule, but
+            in GitPython it should be a unique identifier similar to the identifiers
+            used for remotes, which allows to change the path of the submodule easily.
+        """
+        return self._name
+
+    def config_reader(self) -> SectionConstraint[SubmoduleConfigParser]:
+        """
+        :return:
+            ConfigReader instance which allows you to query the configuration values of
+            this submodule, as provided by the ``.gitmodules`` file.
+
+        :note:
+            The config reader will actually read the data directly from the repository
+            and thus does not need nor care about your working tree.
+
+        :note:
+            Should be cached by the caller and only kept as long as needed.
+
+        :raise IOError:
+            If the ``.gitmodules`` file/blob could not be read.
+        """
+        return self._config_parser_constrained(read_only=True)
+
+    def children(self) -> IterableList["Submodule"]:
+        """
+        :return:
+            IterableList(Submodule, ...) An iterable list of :class:`Submodule`
+            instances which are children of this submodule or 0 if the submodule is not
+            checked out.
+        """
+        return self._get_intermediate_items(self)
+
+    # } END query interface
+
+    # { Iterable Interface
+
+    @classmethod
+    def iter_items(
+        cls,
+        repo: "Repo",
+        parent_commit: Union[Commit_ish, str] = "HEAD",
+        *args: Any,
+        **kwargs: Any,
+    ) -> Iterator["Submodule"]:
+        """
+        :return:
+            Iterator yielding :class:`Submodule` instances available in the given
+            repository
+        """
+        try:
+            pc = repo.commit(parent_commit)  # Parent commit instance
+            parser = cls._config_parser(repo, pc, read_only=True)
+        except (IOError, BadName):
+            return
+        # END handle empty iterator
+
+        for sms in parser.sections():
+            n = sm_name(sms)
+            p = parser.get(sms, "path")
+            u = parser.get(sms, "url")
+            b = cls.k_head_default
+            if parser.has_option(sms, cls.k_head_option):
+                b = str(parser.get(sms, cls.k_head_option))
+            # END handle optional information
+
+            # Get the binsha.
+            index = repo.index
+            try:
+                rt = pc.tree  # Root tree
+                sm = rt[p]
+            except KeyError:
+                # Try the index, maybe it was just added.
+                try:
+                    entry = index.entries[index.entry_key(p, 0)]
+                    sm = Submodule(repo, entry.binsha, entry.mode, entry.path)
+                except KeyError:
+                    # The submodule doesn't exist, probably it wasn't removed from the
+                    # .gitmodules file.
+                    continue
+                # END handle keyerror
+            # END handle critical error
+
+            # Make sure we are looking at a submodule object.
+            if type(sm) is not git.objects.submodule.base.Submodule:
+                continue
+
+            # Fill in remaining info - saves time as it doesn't have to be parsed again.
+            sm._name = n
+            if pc != repo.commit():
+                sm._parent_commit = pc
+            # END set only if not most recent!
+            sm._branch_path = git.Head.to_full_path(b)
+            sm._url = u
+
+            yield sm
+        # END for each section
+
+    # } END iterable interface
diff --git a/llm/Lib/site-packages/git/objects/submodule/root.py b/llm/Lib/site-packages/git/objects/submodule/root.py
new file mode 100644
index 0000000000000000000000000000000000000000..d93193fa3c92201967af27ea382490eeb01fb95d
--- /dev/null
+++ b/llm/Lib/site-packages/git/objects/submodule/root.py
@@ -0,0 +1,467 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+__all__ = ["RootModule", "RootUpdateProgress"]
+
+import logging
+
+import git
+from git.exc import InvalidGitRepositoryError
+
+from .base import Submodule, UpdateProgress
+from .util import find_first_remote_branch
+
+# typing -------------------------------------------------------------------
+
+from typing import TYPE_CHECKING, Union
+
+from git.types import Commit_ish
+
+if TYPE_CHECKING:
+    from git.repo import Repo
+    from git.util import IterableList
+
+# ----------------------------------------------------------------------------
+
+_logger = logging.getLogger(__name__)
+
+
+class RootUpdateProgress(UpdateProgress):
+    """Utility class which adds more opcodes to
+    :class:`~git.objects.submodule.base.UpdateProgress`."""
+
+    REMOVE, PATHCHANGE, BRANCHCHANGE, URLCHANGE = [
+        1 << x for x in range(UpdateProgress._num_op_codes, UpdateProgress._num_op_codes + 4)
+    ]
+    _num_op_codes = UpdateProgress._num_op_codes + 4
+
+    __slots__ = ()
+
+
+BEGIN = RootUpdateProgress.BEGIN
+END = RootUpdateProgress.END
+REMOVE = RootUpdateProgress.REMOVE
+BRANCHCHANGE = RootUpdateProgress.BRANCHCHANGE
+URLCHANGE = RootUpdateProgress.URLCHANGE
+PATHCHANGE = RootUpdateProgress.PATHCHANGE
+
+
+class RootModule(Submodule):
+    """A (virtual) root of all submodules in the given repository.
+
+    This can be used to more easily traverse all submodules of the
+    superproject (master repository).
+    """
+
+    __slots__ = ()
+
+    k_root_name = "__ROOT__"
+
+    def __init__(self, repo: "Repo") -> None:
+        # repo, binsha, mode=None, path=None, name = None, parent_commit=None, url=None, ref=None)
+        super().__init__(
+            repo,
+            binsha=self.NULL_BIN_SHA,
+            mode=self.k_default_mode,
+            path="",
+            name=self.k_root_name,
+            parent_commit=repo.head.commit,
+            url="",
+            branch_path=git.Head.to_full_path(self.k_head_default),
+        )
+
+    def _clear_cache(self) -> None:
+        """May not do anything."""
+        pass
+
+    # { Interface
+
+    def update(  # type: ignore[override]
+        self,
+        previous_commit: Union[Commit_ish, str, None] = None,
+        recursive: bool = True,
+        force_remove: bool = False,
+        init: bool = True,
+        to_latest_revision: bool = False,
+        progress: Union[None, "RootUpdateProgress"] = None,
+        dry_run: bool = False,
+        force_reset: bool = False,
+        keep_going: bool = False,
+    ) -> "RootModule":
+        """Update the submodules of this repository to the current HEAD commit.
+
+        This method behaves smartly by determining changes of the path of a submodule's
+        repository, next to changes to the to-be-checked-out commit or the branch to be
+        checked out. This works if the submodule's ID does not change.
+
+        Additionally it will detect addition and removal of submodules, which will be
+        handled gracefully.
+
+        :param previous_commit:
+            If set to a commit-ish, the commit we should use as the previous commit the
+            HEAD pointed to before it was set to the commit it points to now.
+            If ``None``, it defaults to ``HEAD@{1}`` otherwise.
+
+        :param recursive:
+            If ``True``, the children of submodules will be updated as well using the
+            same technique.
+
+        :param force_remove:
+            If submodules have been deleted, they will be forcibly removed. Otherwise
+            the update may fail if a submodule's repository cannot be deleted as changes
+            have been made to it.
+            (See :meth:`Submodule.update <git.objects.submodule.base.Submodule.update>`
+            for more information.)
+
+        :param init:
+            If we encounter a new module which would need to be initialized, then do it.
+
+        :param to_latest_revision:
+            If ``True``, instead of checking out the revision pointed to by this
+            submodule's sha, the checked out tracking branch will be merged with the
+            latest remote branch fetched from the repository's origin.
+
+            Unless `force_reset` is specified, a local tracking branch will never be
+            reset into its past, therefore the remote branch must be in the future for
+            this to have an effect.
+
+        :param force_reset:
+            If ``True``, submodules may checkout or reset their branch even if the
+            repository has pending changes that would be overwritten, or if the local
+            tracking branch is in the future of the remote tracking branch and would be
+            reset into its past.
+
+        :param progress:
+            :class:`RootUpdateProgress` instance, or ``None`` if no progress should be
+            sent.
+
+        :param dry_run:
+            If ``True``, operations will not actually be performed. Progress messages
+            will change accordingly to indicate the WOULD DO state of the operation.
+
+        :param keep_going:
+            If ``True``, we will ignore but log all errors, and keep going recursively.
+            Unless `dry_run` is set as well, `keep_going` could cause
+            subsequent/inherited errors you wouldn't see otherwise.
+            In conjunction with `dry_run`, this can be useful to anticipate all errors
+            when updating submodules.
+
+        :return:
+            self
+        """
+        if self.repo.bare:
+            raise InvalidGitRepositoryError("Cannot update submodules in bare repositories")
+        # END handle bare
+
+        if progress is None:
+            progress = RootUpdateProgress()
+        # END ensure progress is set
+
+        prefix = ""
+        if dry_run:
+            prefix = "DRY-RUN: "
+
+        repo = self.repo
+
+        try:
+            # SETUP BASE COMMIT
+            ###################
+            cur_commit = repo.head.commit
+            if previous_commit is None:
+                try:
+                    previous_commit = repo.commit(repo.head.log_entry(-1).oldhexsha)
+                    if previous_commit.binsha == previous_commit.NULL_BIN_SHA:
+                        raise IndexError
+                    # END handle initial commit
+                except IndexError:
+                    # In new repositories, there is no previous commit.
+                    previous_commit = cur_commit
+                # END exception handling
+            else:
+                previous_commit = repo.commit(previous_commit)  # Obtain commit object.
+            # END handle previous commit
+
+            psms: "IterableList[Submodule]" = self.list_items(repo, parent_commit=previous_commit)
+            sms: "IterableList[Submodule]" = self.list_items(repo)
+            spsms = set(psms)
+            ssms = set(sms)
+
+            # HANDLE REMOVALS
+            ###################
+            rrsm = spsms - ssms
+            len_rrsm = len(rrsm)
+
+            for i, rsm in enumerate(rrsm):
+                op = REMOVE
+                if i == 0:
+                    op |= BEGIN
+                # END handle begin
+
+                # Fake it into thinking its at the current commit to allow deletion
+                # of previous module. Trigger the cache to be updated before that.
+                progress.update(
+                    op,
+                    i,
+                    len_rrsm,
+                    prefix + "Removing submodule %r at %s" % (rsm.name, rsm.abspath),
+                )
+                rsm._parent_commit = repo.head.commit
+                rsm.remove(
+                    configuration=False,
+                    module=True,
+                    force=force_remove,
+                    dry_run=dry_run,
+                )
+
+                if i == len_rrsm - 1:
+                    op |= END
+                # END handle end
+                progress.update(op, i, len_rrsm, prefix + "Done removing submodule %r" % rsm.name)
+            # END for each removed submodule
+
+            # HANDLE PATH RENAMES
+            #####################
+            # URL changes + branch changes.
+            csms = spsms & ssms
+            len_csms = len(csms)
+            for i, csm in enumerate(csms):
+                psm: "Submodule" = psms[csm.name]
+                sm: "Submodule" = sms[csm.name]
+
+                # PATH CHANGES
+                ##############
+                if sm.path != psm.path and psm.module_exists():
+                    progress.update(
+                        BEGIN | PATHCHANGE,
+                        i,
+                        len_csms,
+                        prefix + "Moving repository of submodule %r from %s to %s" % (sm.name, psm.abspath, sm.abspath),
+                    )
+                    # Move the module to the new path.
+                    if not dry_run:
+                        psm.move(sm.path, module=True, configuration=False)
+                    # END handle dry_run
+                    progress.update(
+                        END | PATHCHANGE,
+                        i,
+                        len_csms,
+                        prefix + "Done moving repository of submodule %r" % sm.name,
+                    )
+                # END handle path changes
+
+                if sm.module_exists():
+                    # HANDLE URL CHANGE
+                    ###################
+                    if sm.url != psm.url:
+                        # Add the new remote, remove the old one.
+                        # This way, if the url just changes, the commits will not have
+                        # to be re-retrieved.
+                        nn = "__new_origin__"
+                        smm = sm.module()
+                        rmts = smm.remotes
+
+                        # Don't do anything if we already have the url we search in
+                        # place.
+                        if len([r for r in rmts if r.url == sm.url]) == 0:
+                            progress.update(
+                                BEGIN | URLCHANGE,
+                                i,
+                                len_csms,
+                                prefix + "Changing url of submodule %r from %s to %s" % (sm.name, psm.url, sm.url),
+                            )
+
+                            if not dry_run:
+                                assert nn not in [r.name for r in rmts]
+                                smr = smm.create_remote(nn, sm.url)
+                                smr.fetch(progress=progress)
+
+                                # If we have a tracking branch, it should be available
+                                # in the new remote as well.
+                                if len([r for r in smr.refs if r.remote_head == sm.branch_name]) == 0:
+                                    raise ValueError(
+                                        "Submodule branch named %r was not available in new submodule remote at %r"
+                                        % (sm.branch_name, sm.url)
+                                    )
+                                # END head is not detached
+
+                                # Now delete the changed one.
+                                rmt_for_deletion = None
+                                for remote in rmts:
+                                    if remote.url == psm.url:
+                                        rmt_for_deletion = remote
+                                        break
+                                    # END if urls match
+                                # END for each remote
+
+                                # If we didn't find a matching remote, but have exactly
+                                # one, we can safely use this one.
+                                if rmt_for_deletion is None:
+                                    if len(rmts) == 1:
+                                        rmt_for_deletion = rmts[0]
+                                    else:
+                                        # If we have not found any remote with the
+                                        # original URL we may not have a name. This is a
+                                        # special case, and its okay to fail here.
+                                        # Alternatively we could just generate a unique
+                                        # name and leave all existing ones in place.
+                                        raise InvalidGitRepositoryError(
+                                            "Couldn't find original remote-repo at url %r" % psm.url
+                                        )
+                                    # END handle one single remote
+                                # END handle check we found a remote
+
+                                orig_name = rmt_for_deletion.name
+                                smm.delete_remote(rmt_for_deletion)
+                                # NOTE: Currently we leave tags from the deleted remotes
+                                # as well as separate tracking branches in the possibly
+                                # totally changed repository (someone could have changed
+                                # the url to another project). At some point, one might
+                                # want to clean it up, but the danger is high to remove
+                                # stuff the user has added explicitly.
+
+                                # Rename the new remote back to what it was.
+                                smr.rename(orig_name)
+
+                                # Early on, we verified that the our current tracking
+                                # branch exists in the remote. Now we have to ensure
+                                # that the sha we point to is still contained in the new
+                                # remote tracking branch.
+                                smsha = sm.binsha
+                                found = False
+                                rref = smr.refs[self.branch_name]
+                                for c in rref.commit.traverse():
+                                    if c.binsha == smsha:
+                                        found = True
+                                        break
+                                    # END traverse all commits in search for sha
+                                # END for each commit
+
+                                if not found:
+                                    # Adjust our internal binsha to use the one of the
+                                    # remote this way, it will be checked out in the
+                                    # next step. This will change the submodule relative
+                                    # to us, so the user will be able to commit the
+                                    # change easily.
+                                    _logger.warning(
+                                        "Current sha %s was not contained in the tracking\
+             branch at the new remote, setting it the the remote's tracking branch",
+                                        sm.hexsha,
+                                    )
+                                    sm.binsha = rref.commit.binsha
+                                # END reset binsha
+
+                                # NOTE: All checkout is performed by the base
+                                # implementation of update.
+                            # END handle dry_run
+                            progress.update(
+                                END | URLCHANGE,
+                                i,
+                                len_csms,
+                                prefix + "Done adjusting url of submodule %r" % (sm.name),
+                            )
+                        # END skip remote handling if new url already exists in module
+                    # END handle url
+
+                    # HANDLE PATH CHANGES
+                    #####################
+                    if sm.branch_path != psm.branch_path:
+                        # Finally, create a new tracking branch which tracks the new
+                        # remote branch.
+                        progress.update(
+                            BEGIN | BRANCHCHANGE,
+                            i,
+                            len_csms,
+                            prefix
+                            + "Changing branch of submodule %r from %s to %s"
+                            % (sm.name, psm.branch_path, sm.branch_path),
+                        )
+                        if not dry_run:
+                            smm = sm.module()
+                            smmr = smm.remotes
+                            # As the branch might not exist yet, we will have to fetch
+                            # all remotes to be sure...
+                            for remote in smmr:
+                                remote.fetch(progress=progress)
+                            # END for each remote
+
+                            try:
+                                tbr = git.Head.create(
+                                    smm,
+                                    sm.branch_name,
+                                    logmsg="branch: Created from HEAD",
+                                )
+                            except OSError:
+                                # ...or reuse the existing one.
+                                tbr = git.Head(smm, sm.branch_path)
+                            # END ensure tracking branch exists
+
+                            tbr.set_tracking_branch(find_first_remote_branch(smmr, sm.branch_name))
+                            # NOTE: All head-resetting is done in the base
+                            # implementation of update but we will have to checkout the
+                            # new branch here. As it still points to the currently
+                            # checked out commit, we don't do any harm.
+                            # As we don't want to update working-tree or index, changing
+                            # the ref is all there is to do.
+                            smm.head.reference = tbr
+                        # END handle dry_run
+
+                        progress.update(
+                            END | BRANCHCHANGE,
+                            i,
+                            len_csms,
+                            prefix + "Done changing branch of submodule %r" % sm.name,
+                        )
+                    # END handle branch
+                # END handle
+            # END for each common submodule
+        except Exception as err:
+            if not keep_going:
+                raise
+            _logger.error(str(err))
+        # END handle keep_going
+
+        # FINALLY UPDATE ALL ACTUAL SUBMODULES
+        ######################################
+        for sm in sms:
+            # Update the submodule using the default method.
+            sm.update(
+                recursive=False,
+                init=init,
+                to_latest_revision=to_latest_revision,
+                progress=progress,
+                dry_run=dry_run,
+                force=force_reset,
+                keep_going=keep_going,
+            )
+
+            # Update recursively depth first - question is which inconsistent state will
+            # be better in case it fails somewhere. Defective branch or defective depth.
+            # The RootSubmodule type will never process itself, which was done in the
+            # previous expression.
+            if recursive:
+                # The module would exist by now if we are not in dry_run mode.
+                if sm.module_exists():
+                    type(self)(sm.module()).update(
+                        recursive=True,
+                        force_remove=force_remove,
+                        init=init,
+                        to_latest_revision=to_latest_revision,
+                        progress=progress,
+                        dry_run=dry_run,
+                        force_reset=force_reset,
+                        keep_going=keep_going,
+                    )
+                # END handle dry_run
+            # END handle recursive
+        # END for each submodule to update
+
+        return self
+
+    def module(self) -> "Repo":
+        """:return: The actual repository containing the submodules"""
+        return self.repo
+
+    # } END interface
+
+
+# } END classes
diff --git a/llm/Lib/site-packages/git/objects/submodule/util.py b/llm/Lib/site-packages/git/objects/submodule/util.py
new file mode 100644
index 0000000000000000000000000000000000000000..c021510d88a47a267f530ce4455b682fe8dee0a6
--- /dev/null
+++ b/llm/Lib/site-packages/git/objects/submodule/util.py
@@ -0,0 +1,121 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+__all__ = [
+    "sm_section",
+    "sm_name",
+    "mkhead",
+    "find_first_remote_branch",
+    "SubmoduleConfigParser",
+]
+
+from io import BytesIO
+import weakref
+
+import git
+from git.config import GitConfigParser
+from git.exc import InvalidGitRepositoryError
+
+# typing -----------------------------------------------------------------------
+
+from typing import Any, Sequence, TYPE_CHECKING, Union
+
+from git.types import PathLike
+
+if TYPE_CHECKING:
+    from weakref import ReferenceType
+
+    from git.refs import Head, RemoteReference
+    from git.remote import Remote
+    from git.repo import Repo
+
+    from .base import Submodule
+
+# { Utilities
+
+
+def sm_section(name: str) -> str:
+    """:return: Section title used in ``.gitmodules`` configuration file"""
+    return f'submodule "{name}"'
+
+
+def sm_name(section: str) -> str:
+    """:return: Name of the submodule as parsed from the section name"""
+    section = section.strip()
+    return section[11:-1]
+
+
+def mkhead(repo: "Repo", path: PathLike) -> "Head":
+    """:return: New branch/head instance"""
+    return git.Head(repo, git.Head.to_full_path(path))
+
+
+def find_first_remote_branch(remotes: Sequence["Remote"], branch_name: str) -> "RemoteReference":
+    """Find the remote branch matching the name of the given branch or raise
+    :exc:`~git.exc.InvalidGitRepositoryError`."""
+    for remote in remotes:
+        try:
+            return remote.refs[branch_name]
+        except IndexError:
+            continue
+        # END exception handling
+    # END for remote
+    raise InvalidGitRepositoryError("Didn't find remote branch '%r' in any of the given remotes" % branch_name)
+
+
+# } END utilities
+
+# { Classes
+
+
+class SubmoduleConfigParser(GitConfigParser):
+    """Catches calls to :meth:`~git.config.GitConfigParser.write`, and updates the
+    ``.gitmodules`` blob in the index with the new data, if we have written into a
+    stream.
+
+    Otherwise it would add the local file to the index to make it correspond with the
+    working tree. Additionally, the cache must be cleared.
+
+    Please note that no mutating method will work in bare mode.
+    """
+
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        self._smref: Union["ReferenceType[Submodule]", None] = None
+        self._index = None
+        self._auto_write = True
+        super().__init__(*args, **kwargs)
+
+    # { Interface
+    def set_submodule(self, submodule: "Submodule") -> None:
+        """Set this instance's submodule. It must be called before the first write
+        operation begins."""
+        self._smref = weakref.ref(submodule)
+
+    def flush_to_index(self) -> None:
+        """Flush changes in our configuration file to the index."""
+        assert self._smref is not None
+        # Should always have a file here.
+        assert not isinstance(self._file_or_files, BytesIO)
+
+        sm = self._smref()
+        if sm is not None:
+            index = self._index
+            if index is None:
+                index = sm.repo.index
+            # END handle index
+            index.add([sm.k_modules_file], write=self._auto_write)
+            sm._clear_cache()
+        # END handle weakref
+
+    # } END interface
+
+    # { Overridden Methods
+    def write(self) -> None:  # type: ignore[override]
+        rval: None = super().write()
+        self.flush_to_index()
+        return rval
+
+    # END overridden methods
+
+
+# } END classes
diff --git a/llm/Lib/site-packages/git/objects/tag.py b/llm/Lib/site-packages/git/objects/tag.py
new file mode 100644
index 0000000000000000000000000000000000000000..a3bb0b882b8341e335f76354f1f40d5998f48090
--- /dev/null
+++ b/llm/Lib/site-packages/git/objects/tag.py
@@ -0,0 +1,141 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Provides an :class:`~git.objects.base.Object`-based type for annotated tags.
+
+This defines the :class:`TagObject` class, which represents annotated tags.
+For lightweight tags, see the :mod:`git.refs.tag` module.
+"""
+
+__all__ = ["TagObject"]
+
+import sys
+
+from git.compat import defenc
+from git.util import hex_to_bin
+
+from . import base
+from .util import get_object_type_by_name, parse_actor_and_date
+
+# typing ----------------------------------------------
+
+from typing import List, TYPE_CHECKING, Union
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from typing_extensions import Literal
+
+if TYPE_CHECKING:
+    from git.repo import Repo
+    from git.util import Actor
+
+    from .blob import Blob
+    from .commit import Commit
+    from .tree import Tree
+
+# ---------------------------------------------------
+
+
+class TagObject(base.Object):
+    """Annotated (i.e. non-lightweight) tag carrying additional information about an
+    object we are pointing to.
+
+    See :manpage:`gitglossary(7)` on "tag object":
+    https://git-scm.com/docs/gitglossary#def_tag_object
+    """
+
+    type: Literal["tag"] = "tag"
+
+    __slots__ = (
+        "object",
+        "tag",
+        "tagger",
+        "tagged_date",
+        "tagger_tz_offset",
+        "message",
+    )
+
+    def __init__(
+        self,
+        repo: "Repo",
+        binsha: bytes,
+        object: Union[None, base.Object] = None,
+        tag: Union[None, str] = None,
+        tagger: Union[None, "Actor"] = None,
+        tagged_date: Union[int, None] = None,
+        tagger_tz_offset: Union[int, None] = None,
+        message: Union[str, None] = None,
+    ) -> None:  # @ReservedAssignment
+        """Initialize a tag object with additional data.
+
+        :param repo:
+            Repository this object is located in.
+
+        :param binsha:
+            20 byte SHA1.
+
+        :param object:
+            :class:`~git.objects.base.Object` instance of object we are pointing to.
+
+        :param tag:
+            Name of this tag.
+
+        :param tagger:
+            :class:`~git.util.Actor` identifying the tagger.
+
+        :param tagged_date: int_seconds_since_epoch
+            The DateTime of the tag creation.
+            Use :func:`time.gmtime` to convert it into a different format.
+
+        :param tagger_tz_offset: int_seconds_west_of_utc
+            The timezone that the `tagged_date` is in, in a format similar to
+            :attr:`time.altzone`.
+        """
+        super().__init__(repo, binsha)
+        if object is not None:
+            self.object: Union["Commit", "Blob", "Tree", "TagObject"] = object
+        if tag is not None:
+            self.tag = tag
+        if tagger is not None:
+            self.tagger = tagger
+        if tagged_date is not None:
+            self.tagged_date = tagged_date
+        if tagger_tz_offset is not None:
+            self.tagger_tz_offset = tagger_tz_offset
+        if message is not None:
+            self.message = message
+
+    def _set_cache_(self, attr: str) -> None:
+        """Cache all our attributes at once."""
+        if attr in TagObject.__slots__:
+            ostream = self.repo.odb.stream(self.binsha)
+            lines: List[str] = ostream.read().decode(defenc, "replace").splitlines()
+
+            _obj, hexsha = lines[0].split(" ")
+            _type_token, type_name = lines[1].split(" ")
+            object_type = get_object_type_by_name(type_name.encode("ascii"))
+            self.object = object_type(self.repo, hex_to_bin(hexsha))
+
+            self.tag = lines[2][4:]  # tag <tag name>
+
+            if len(lines) > 3:
+                tagger_info = lines[3]  # tagger <actor> <date>
+                (
+                    self.tagger,
+                    self.tagged_date,
+                    self.tagger_tz_offset,
+                ) = parse_actor_and_date(tagger_info)
+
+            # Line 4 empty - it could mark the beginning of the next header.
+            # In case there really is no message, it would not exist.
+            # Otherwise a newline separates header from message.
+            if len(lines) > 5:
+                self.message = "\n".join(lines[5:])
+            else:
+                self.message = ""
+        # END check our attributes
+        else:
+            super()._set_cache_(attr)
diff --git a/llm/Lib/site-packages/git/objects/tree.py b/llm/Lib/site-packages/git/objects/tree.py
new file mode 100644
index 0000000000000000000000000000000000000000..09184a78155e4ae7317ae33830b0461ba089a4d0
--- /dev/null
+++ b/llm/Lib/site-packages/git/objects/tree.py
@@ -0,0 +1,414 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+__all__ = ["TreeModifier", "Tree"]
+
+import sys
+
+import git.diff as git_diff
+from git.util import IterableList, join_path, to_bin_sha
+
+from . import util
+from .base import IndexObjUnion, IndexObject
+from .blob import Blob
+from .fun import tree_entries_from_data, tree_to_stream
+from .submodule.base import Submodule
+
+# typing -------------------------------------------------
+
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Tuple,
+    TYPE_CHECKING,
+    Type,
+    Union,
+    cast,
+)
+
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from typing_extensions import Literal
+
+from git.types import PathLike
+
+if TYPE_CHECKING:
+    from io import BytesIO
+
+    from git.repo import Repo
+
+TreeCacheTup = Tuple[bytes, int, str]
+
+TraversedTreeTup = Union[Tuple[Union["Tree", None], IndexObjUnion, Tuple["Submodule", "Submodule"]]]
+
+# --------------------------------------------------------
+
+cmp: Callable[[str, str], int] = lambda a, b: (a > b) - (a < b)
+
+
+class TreeModifier:
+    """A utility class providing methods to alter the underlying cache in a list-like
+    fashion.
+
+    Once all adjustments are complete, the :attr:`_cache`, which really is a reference
+    to the cache of a tree, will be sorted. This ensures it will be in a serializable
+    state.
+    """
+
+    __slots__ = ("_cache",)
+
+    def __init__(self, cache: List[TreeCacheTup]) -> None:
+        self._cache = cache
+
+    def _index_by_name(self, name: str) -> int:
+        """:return: index of an item with name, or -1 if not found"""
+        for i, t in enumerate(self._cache):
+            if t[2] == name:
+                return i
+            # END found item
+        # END for each item in cache
+        return -1
+
+    # { Interface
+    def set_done(self) -> "TreeModifier":
+        """Call this method once you are done modifying the tree information.
+
+        This may be called several times, but be aware that each call will cause a sort
+        operation.
+
+        :return:
+            self
+        """
+        self._cache.sort(key=lambda x: (x[2] + "/") if x[1] == Tree.tree_id << 12 else x[2])
+        return self
+
+    # } END interface
+
+    # { Mutators
+    def add(self, sha: bytes, mode: int, name: str, force: bool = False) -> "TreeModifier":
+        """Add the given item to the tree.
+
+        If an item with the given name already exists, nothing will be done, but a
+        :exc:`ValueError` will be raised if the sha and mode of the existing item do not
+        match the one you add, unless `force` is ``True``.
+
+        :param sha:
+            The 20 or 40 byte sha of the item to add.
+
+        :param mode:
+            :class:`int` representing the stat-compatible mode of the item.
+
+        :param force:
+            If ``True``, an item with your name and information will overwrite any
+            existing item with the same name, no matter which information it has.
+
+        :return:
+            self
+        """
+        if "/" in name:
+            raise ValueError("Name must not contain '/' characters")
+        if (mode >> 12) not in Tree._map_id_to_type:
+            raise ValueError("Invalid object type according to mode %o" % mode)
+
+        sha = to_bin_sha(sha)
+        index = self._index_by_name(name)
+
+        item = (sha, mode, name)
+
+        if index == -1:
+            self._cache.append(item)
+        else:
+            if force:
+                self._cache[index] = item
+            else:
+                ex_item = self._cache[index]
+                if ex_item[0] != sha or ex_item[1] != mode:
+                    raise ValueError("Item %r existed with different properties" % name)
+                # END handle mismatch
+            # END handle force
+        # END handle name exists
+        return self
+
+    def add_unchecked(self, binsha: bytes, mode: int, name: str) -> None:
+        """Add the given item to the tree. Its correctness is assumed, so it is the
+        caller's responsibility to ensure that the input is correct.
+
+        For more information on the parameters, see :meth:`add`.
+
+        :param binsha:
+            20 byte binary sha.
+        """
+        assert isinstance(binsha, bytes) and isinstance(mode, int) and isinstance(name, str)
+        tree_cache = (binsha, mode, name)
+
+        self._cache.append(tree_cache)
+
+    def __delitem__(self, name: str) -> None:
+        """Delete an item with the given name if it exists."""
+        index = self._index_by_name(name)
+        if index > -1:
+            del self._cache[index]
+
+    # } END mutators
+
+
+class Tree(IndexObject, git_diff.Diffable, util.Traversable, util.Serializable):
+    R"""Tree objects represent an ordered list of :class:`~git.objects.blob.Blob`\s and
+    other :class:`Tree`\s.
+
+    See :manpage:`gitglossary(7)` on "tree object":
+    https://git-scm.com/docs/gitglossary#def_tree_object
+
+    Subscripting is supported, as with a list or dict:
+
+    * Access a specific blob using the ``tree["filename"]`` notation.
+    * You may likewise access by index, like ``blob = tree[0]``.
+    """
+
+    type: Literal["tree"] = "tree"
+
+    __slots__ = ("_cache",)
+
+    # Actual integer IDs for comparison.
+    commit_id = 0o16  # Equals stat.S_IFDIR | stat.S_IFLNK - a directory link.
+    blob_id = 0o10
+    symlink_id = 0o12
+    tree_id = 0o04
+
+    _map_id_to_type: Dict[int, Type[IndexObjUnion]] = {
+        commit_id: Submodule,
+        blob_id: Blob,
+        symlink_id: Blob,
+        # Tree ID added once Tree is defined.
+    }
+
+    def __init__(
+        self,
+        repo: "Repo",
+        binsha: bytes,
+        mode: int = tree_id << 12,
+        path: Union[PathLike, None] = None,
+    ):
+        super().__init__(repo, binsha, mode, path)
+
+    @classmethod
+    def _get_intermediate_items(
+        cls,
+        index_object: IndexObjUnion,
+    ) -> Union[Tuple["Tree", ...], Tuple[()]]:
+        if index_object.type == "tree":
+            return tuple(index_object._iter_convert_to_object(index_object._cache))
+        return ()
+
+    def _set_cache_(self, attr: str) -> None:
+        if attr == "_cache":
+            # Set the data when we need it.
+            ostream = self.repo.odb.stream(self.binsha)
+            self._cache: List[TreeCacheTup] = tree_entries_from_data(ostream.read())
+        else:
+            super()._set_cache_(attr)
+        # END handle attribute
+
+    def _iter_convert_to_object(self, iterable: Iterable[TreeCacheTup]) -> Iterator[IndexObjUnion]:
+        """Iterable yields tuples of (binsha, mode, name), which will be converted to
+        the respective object representation.
+        """
+        for binsha, mode, name in iterable:
+            path = join_path(self.path, name)
+            try:
+                yield self._map_id_to_type[mode >> 12](self.repo, binsha, mode, path)
+            except KeyError as e:
+                raise TypeError("Unknown mode %o found in tree data for path '%s'" % (mode, path)) from e
+        # END for each item
+
+    def join(self, file: str) -> IndexObjUnion:
+        """Find the named object in this tree's contents.
+
+        :return:
+            :class:`~git.objects.blob.Blob`, :class:`Tree`, or
+            :class:`~git.objects.submodule.base.Submodule`
+
+        :raise KeyError:
+            If the given file or tree does not exist in this tree.
+        """
+        msg = "Blob or Tree named %r not found"
+        if "/" in file:
+            tree = self
+            item = self
+            tokens = file.split("/")
+            for i, token in enumerate(tokens):
+                item = tree[token]
+                if item.type == "tree":
+                    tree = item
+                else:
+                    # Safety assertion - blobs are at the end of the path.
+                    if i != len(tokens) - 1:
+                        raise KeyError(msg % file)
+                    return item
+                # END handle item type
+            # END for each token of split path
+            if item == self:
+                raise KeyError(msg % file)
+            return item
+        else:
+            for info in self._cache:
+                if info[2] == file:  # [2] == name
+                    return self._map_id_to_type[info[1] >> 12](
+                        self.repo, info[0], info[1], join_path(self.path, info[2])
+                    )
+            # END for each obj
+            raise KeyError(msg % file)
+        # END handle long paths
+
+    def __truediv__(self, file: str) -> IndexObjUnion:
+        """The ``/`` operator is another syntax for joining.
+
+        See :meth:`join` for details.
+        """
+        return self.join(file)
+
+    @property
+    def trees(self) -> List["Tree"]:
+        """:return: list(Tree, ...) List of trees directly below this tree"""
+        return [i for i in self if i.type == "tree"]
+
+    @property
+    def blobs(self) -> List[Blob]:
+        """:return: list(Blob, ...) List of blobs directly below this tree"""
+        return [i for i in self if i.type == "blob"]
+
+    @property
+    def cache(self) -> TreeModifier:
+        """
+        :return:
+            An object allowing modification of the internal cache. This can be used to
+            change the tree's contents. When done, make sure you call
+            :meth:`~TreeModifier.set_done` on the tree modifier, or serialization
+            behaviour will be incorrect.
+
+        :note:
+            See :class:`TreeModifier` for more information on how to alter the cache.
+        """
+        return TreeModifier(self._cache)
+
+    def traverse(
+        self,
+        predicate: Callable[[Union[IndexObjUnion, TraversedTreeTup], int], bool] = lambda i, d: True,
+        prune: Callable[[Union[IndexObjUnion, TraversedTreeTup], int], bool] = lambda i, d: False,
+        depth: int = -1,
+        branch_first: bool = True,
+        visit_once: bool = False,
+        ignore_self: int = 1,
+        as_edge: bool = False,
+    ) -> Union[Iterator[IndexObjUnion], Iterator[TraversedTreeTup]]:
+        """For documentation, see
+        `Traversable._traverse() <git.objects.util.Traversable._traverse>`.
+
+        Trees are set to ``visit_once = False`` to gain more performance in the
+        traversal.
+        """
+
+        # # To typecheck instead of using cast.
+        # import itertools
+        # def is_tree_traversed(inp: Tuple) -> TypeGuard[Tuple[Iterator[Union['Tree', 'Blob', 'Submodule']]]]:
+        #     return all(isinstance(x, (Blob, Tree, Submodule)) for x in inp[1])
+
+        # ret = super().traverse(predicate, prune, depth, branch_first, visit_once, ignore_self)
+        # ret_tup = itertools.tee(ret, 2)
+        # assert is_tree_traversed(ret_tup), f"Type is {[type(x) for x in list(ret_tup[0])]}"
+        # return ret_tup[0]
+
+        return cast(
+            Union[Iterator[IndexObjUnion], Iterator[TraversedTreeTup]],
+            super()._traverse(
+                predicate,  # type: ignore[arg-type]
+                prune,  # type: ignore[arg-type]
+                depth,
+                branch_first,
+                visit_once,
+                ignore_self,
+            ),
+        )
+
+    def list_traverse(self, *args: Any, **kwargs: Any) -> IterableList[IndexObjUnion]:
+        """
+        :return:
+            :class:`~git.util.IterableList` with the results of the traversal as
+            produced by :meth:`traverse`
+
+            Tree -> IterableList[Union[Submodule, Tree, Blob]]
+        """
+        return super()._list_traverse(*args, **kwargs)
+
+    # List protocol
+
+    def __getslice__(self, i: int, j: int) -> List[IndexObjUnion]:
+        return list(self._iter_convert_to_object(self._cache[i:j]))
+
+    def __iter__(self) -> Iterator[IndexObjUnion]:
+        return self._iter_convert_to_object(self._cache)
+
+    def __len__(self) -> int:
+        return len(self._cache)
+
+    def __getitem__(self, item: Union[str, int, slice]) -> IndexObjUnion:
+        if isinstance(item, int):
+            info = self._cache[item]
+            return self._map_id_to_type[info[1] >> 12](self.repo, info[0], info[1], join_path(self.path, info[2]))
+
+        if isinstance(item, str):
+            # compatibility
+            return self.join(item)
+        # END index is basestring
+
+        raise TypeError("Invalid index type: %r" % item)
+
+    def __contains__(self, item: Union[IndexObjUnion, PathLike]) -> bool:
+        if isinstance(item, IndexObject):
+            for info in self._cache:
+                if item.binsha == info[0]:
+                    return True
+                # END compare sha
+            # END for each entry
+        # END handle item is index object
+        # compatibility
+
+        # Treat item as repo-relative path.
+        else:
+            path = self.path
+            for info in self._cache:
+                if item == join_path(path, info[2]):
+                    return True
+        # END for each item
+        return False
+
+    def __reversed__(self) -> Iterator[IndexObjUnion]:
+        return reversed(self._iter_convert_to_object(self._cache))  # type: ignore[call-overload]
+
+    def _serialize(self, stream: "BytesIO") -> "Tree":
+        """Serialize this tree into the stream. Assumes sorted tree data.
+
+        :note:
+            We will assume our tree data to be in a sorted state. If this is not the
+            case, serialization will not generate a correct tree representation as these
+            are assumed to be sorted by algorithms.
+        """
+        tree_to_stream(self._cache, stream.write)
+        return self
+
+    def _deserialize(self, stream: "BytesIO") -> "Tree":
+        self._cache = tree_entries_from_data(stream.read())
+        return self
+
+
+# END tree
+
+# Finalize map definition.
+Tree._map_id_to_type[Tree.tree_id] = Tree
diff --git a/llm/Lib/site-packages/git/objects/util.py b/llm/Lib/site-packages/git/objects/util.py
new file mode 100644
index 0000000000000000000000000000000000000000..5c56e61349d992364c00d23e370b8cc386748b75
--- /dev/null
+++ b/llm/Lib/site-packages/git/objects/util.py
@@ -0,0 +1,700 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Utility functions for working with git objects."""
+
+__all__ = [
+    "get_object_type_by_name",
+    "parse_date",
+    "parse_actor_and_date",
+    "ProcessStreamAdapter",
+    "Traversable",
+    "altz_to_utctz_str",
+    "utctz_to_altz",
+    "verify_utctz",
+    "Actor",
+    "tzoffset",
+    "utc",
+]
+
+from abc import ABC, abstractmethod
+import calendar
+from collections import deque
+from datetime import datetime, timedelta, tzinfo
+import re
+from string import digits
+import time
+import warnings
+
+from git.util import Actor, IterableList, IterableObj
+
+# typing ------------------------------------------------------------
+
+from typing import (
+    Any,
+    Callable,
+    Deque,
+    Iterator,
+    NamedTuple,
+    Sequence,
+    TYPE_CHECKING,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+    overload,
+)
+
+from git.types import Has_id_attribute, Literal
+
+if TYPE_CHECKING:
+    from io import BytesIO, StringIO
+    from subprocess import Popen
+
+    from git.types import Protocol, runtime_checkable
+
+    from .blob import Blob
+    from .commit import Commit
+    from .submodule.base import Submodule
+    from .tag import TagObject
+    from .tree import TraversedTreeTup, Tree
+else:
+    Protocol = ABC
+
+    def runtime_checkable(f):
+        return f
+
+
+class TraverseNT(NamedTuple):
+    depth: int
+    item: Union["Traversable", "Blob"]
+    src: Union["Traversable", None]
+
+
+T_TIobj = TypeVar("T_TIobj", bound="TraversableIterableObj")  # For TraversableIterableObj.traverse()
+
+TraversedTup = Union[
+    Tuple[Union["Traversable", None], "Traversable"],  # For Commit, Submodule.
+    "TraversedTreeTup",  # For Tree.traverse().
+]
+
+# --------------------------------------------------------------------
+
+ZERO = timedelta(0)
+
+# { Functions
+
+
+def mode_str_to_int(modestr: Union[bytes, str]) -> int:
+    """Convert mode bits from an octal mode string to an integer mode for git.
+
+    :param modestr:
+        String like ``755`` or ``644`` or ``100644`` - only the last 6 chars will be
+        used.
+
+    :return:
+        String identifying a mode compatible to the mode methods ids of the :mod:`stat`
+        module regarding the rwx permissions for user, group and other, special flags
+        and file system flags, such as whether it is a symlink.
+    """
+    mode = 0
+    for iteration, char in enumerate(reversed(modestr[-6:])):
+        char = cast(Union[str, int], char)
+        mode += int(char) << iteration * 3
+    # END for each char
+    return mode
+
+
+def get_object_type_by_name(
+    object_type_name: bytes,
+) -> Union[Type["Commit"], Type["TagObject"], Type["Tree"], Type["Blob"]]:
+    """Retrieve the Python class GitPython uses to represent a kind of Git object.
+
+    :return:
+        A type suitable to handle the given as `object_type_name`.
+        This type can be called create new instances.
+
+    :param object_type_name:
+        Member of :attr:`Object.TYPES <git.objects.base.Object.TYPES>`.
+
+    :raise ValueError:
+        If `object_type_name` is unknown.
+    """
+    if object_type_name == b"commit":
+        from . import commit
+
+        return commit.Commit
+    elif object_type_name == b"tag":
+        from . import tag
+
+        return tag.TagObject
+    elif object_type_name == b"blob":
+        from . import blob
+
+        return blob.Blob
+    elif object_type_name == b"tree":
+        from . import tree
+
+        return tree.Tree
+    else:
+        raise ValueError("Cannot handle unknown object type: %s" % object_type_name.decode())
+
+
+def utctz_to_altz(utctz: str) -> int:
+    """Convert a git timezone offset into a timezone offset west of UTC in seconds
+    (compatible with :attr:`time.altzone`).
+
+    :param utctz:
+        git utc timezone string, e.g. +0200
+    """
+    int_utctz = int(utctz)
+    seconds = (abs(int_utctz) // 100) * 3600 + (abs(int_utctz) % 100) * 60
+    return seconds if int_utctz < 0 else -seconds
+
+
+def altz_to_utctz_str(altz: float) -> str:
+    """Convert a timezone offset west of UTC in seconds into a Git timezone offset
+    string.
+
+    :param altz:
+        Timezone offset in seconds west of UTC.
+    """
+    hours = abs(altz) // 3600
+    minutes = (abs(altz) % 3600) // 60
+    sign = "-" if altz >= 60 else "+"
+    return "{}{:02}{:02}".format(sign, hours, minutes)
+
+
+def verify_utctz(offset: str) -> str:
+    """
+    :raise ValueError:
+        If `offset` is incorrect.
+
+    :return:
+        `offset`
+    """
+    fmt_exc = ValueError("Invalid timezone offset format: %s" % offset)
+    if len(offset) != 5:
+        raise fmt_exc
+    if offset[0] not in "+-":
+        raise fmt_exc
+    if offset[1] not in digits or offset[2] not in digits or offset[3] not in digits or offset[4] not in digits:
+        raise fmt_exc
+    # END for each char
+    return offset
+
+
+class tzoffset(tzinfo):
+    def __init__(self, secs_west_of_utc: float, name: Union[None, str] = None) -> None:
+        self._offset = timedelta(seconds=-secs_west_of_utc)
+        self._name = name or "fixed"
+
+    def __reduce__(self) -> Tuple[Type["tzoffset"], Tuple[float, str]]:
+        return tzoffset, (-self._offset.total_seconds(), self._name)
+
+    def utcoffset(self, dt: Union[datetime, None]) -> timedelta:
+        return self._offset
+
+    def tzname(self, dt: Union[datetime, None]) -> str:
+        return self._name
+
+    def dst(self, dt: Union[datetime, None]) -> timedelta:
+        return ZERO
+
+
+utc = tzoffset(0, "UTC")
+
+
+def from_timestamp(timestamp: float, tz_offset: float) -> datetime:
+    """Convert a `timestamp` + `tz_offset` into an aware :class:`~datetime.datetime`
+    instance."""
+    utc_dt = datetime.fromtimestamp(timestamp, utc)
+    try:
+        local_dt = utc_dt.astimezone(tzoffset(tz_offset))
+        return local_dt
+    except ValueError:
+        return utc_dt
+
+
+def parse_date(string_date: Union[str, datetime]) -> Tuple[int, int]:
+    """Parse the given date as one of the following:
+
+        * Aware datetime instance
+        * Git internal format: timestamp offset
+        * :rfc:`2822`: ``Thu, 07 Apr 2005 22:13:13 +0200``
+        * ISO 8601: ``2005-04-07T22:13:13`` - The ``T`` can be a space as well.
+
+    :return:
+        Tuple(int(timestamp_UTC), int(offset)), both in seconds since epoch
+
+    :raise ValueError:
+        If the format could not be understood.
+
+    :note:
+        Date can also be ``YYYY.MM.DD``, ``MM/DD/YYYY`` and ``DD.MM.YYYY``.
+    """
+    if isinstance(string_date, datetime):
+        if string_date.tzinfo:
+            utcoffset = cast(timedelta, string_date.utcoffset())  # typeguard, if tzinfoand is not None
+            offset = -int(utcoffset.total_seconds())
+            return int(string_date.astimezone(utc).timestamp()), offset
+        else:
+            raise ValueError(f"string_date datetime object without tzinfo, {string_date}")
+
+    # Git time
+    try:
+        if string_date.count(" ") == 1 and string_date.rfind(":") == -1:
+            timestamp, offset_str = string_date.split()
+            if timestamp.startswith("@"):
+                timestamp = timestamp[1:]
+            timestamp_int = int(timestamp)
+            return timestamp_int, utctz_to_altz(verify_utctz(offset_str))
+        else:
+            offset_str = "+0000"  # Local time by default.
+            if string_date[-5] in "-+":
+                offset_str = verify_utctz(string_date[-5:])
+                string_date = string_date[:-6]  # skip space as well
+            # END split timezone info
+            offset = utctz_to_altz(offset_str)
+
+            # Now figure out the date and time portion - split time.
+            date_formats = []
+            splitter = -1
+            if "," in string_date:
+                date_formats.append("%a, %d %b %Y")
+                splitter = string_date.rfind(" ")
+            else:
+                # ISO plus additional
+                date_formats.append("%Y-%m-%d")
+                date_formats.append("%Y.%m.%d")
+                date_formats.append("%m/%d/%Y")
+                date_formats.append("%d.%m.%Y")
+
+                splitter = string_date.rfind("T")
+                if splitter == -1:
+                    splitter = string_date.rfind(" ")
+                # END handle 'T' and ' '
+            # END handle RFC or ISO
+
+            assert splitter > -1
+
+            # Split date and time.
+            time_part = string_date[splitter + 1 :]  # Skip space.
+            date_part = string_date[:splitter]
+
+            # Parse time.
+            tstruct = time.strptime(time_part, "%H:%M:%S")
+
+            for fmt in date_formats:
+                try:
+                    dtstruct = time.strptime(date_part, fmt)
+                    utctime = calendar.timegm(
+                        (
+                            dtstruct.tm_year,
+                            dtstruct.tm_mon,
+                            dtstruct.tm_mday,
+                            tstruct.tm_hour,
+                            tstruct.tm_min,
+                            tstruct.tm_sec,
+                            dtstruct.tm_wday,
+                            dtstruct.tm_yday,
+                            tstruct.tm_isdst,
+                        )
+                    )
+                    return int(utctime), offset
+                except ValueError:
+                    continue
+                # END exception handling
+            # END for each fmt
+
+            # Still here ? fail.
+            raise ValueError("no format matched")
+        # END handle format
+    except Exception as e:
+        raise ValueError(f"Unsupported date format or type: {string_date}, type={type(string_date)}") from e
+    # END handle exceptions
+
+
+# Precompiled regexes
+_re_actor_epoch = re.compile(r"^.+? (.*) (\d+) ([+-]\d+).*$")
+_re_only_actor = re.compile(r"^.+? (.*)$")
+
+
+def parse_actor_and_date(line: str) -> Tuple[Actor, int, int]:
+    """Parse out the actor (author or committer) info from a line like::
+
+        author Tom Preston-Werner <tom@mojombo.com> 1191999972 -0700
+
+    :return:
+        [Actor, int_seconds_since_epoch, int_timezone_offset]
+    """
+    actor, epoch, offset = "", "0", "0"
+    m = _re_actor_epoch.search(line)
+    if m:
+        actor, epoch, offset = m.groups()
+    else:
+        m = _re_only_actor.search(line)
+        actor = m.group(1) if m else line or ""
+    return (Actor._from_string(actor), int(epoch), utctz_to_altz(offset))
+
+
+# } END functions
+
+
+# { Classes
+
+
+class ProcessStreamAdapter:
+    """Class wiring all calls to the contained Process instance.
+
+    Use this type to hide the underlying process to provide access only to a specified
+    stream. The process is usually wrapped into an :class:`~git.cmd.Git.AutoInterrupt`
+    class to kill it if the instance goes out of scope.
+    """
+
+    __slots__ = ("_proc", "_stream")
+
+    def __init__(self, process: "Popen", stream_name: str) -> None:
+        self._proc = process
+        self._stream: StringIO = getattr(process, stream_name)  # guessed type
+
+    def __getattr__(self, attr: str) -> Any:
+        return getattr(self._stream, attr)
+
+
+@runtime_checkable
+class Traversable(Protocol):
+    """Simple interface to perform depth-first or breadth-first traversals in one
+    direction.
+
+    Subclasses only need to implement one function.
+
+    Instances of the subclass must be hashable.
+
+    Defined subclasses:
+
+    * :class:`Commit <git.objects.Commit>`
+    * :class:`Tree <git.objects.tree.Tree>`
+    * :class:`Submodule <git.objects.submodule.base.Submodule>`
+    """
+
+    __slots__ = ()
+
+    @classmethod
+    @abstractmethod
+    def _get_intermediate_items(cls, item: Any) -> Sequence["Traversable"]:
+        """
+        :return:
+            Tuple of items connected to the given item.
+            Must be implemented in subclass.
+
+        class Commit::     (cls, Commit) -> Tuple[Commit, ...]
+        class Submodule::  (cls, Submodule) -> Iterablelist[Submodule]
+        class Tree::       (cls, Tree) -> Tuple[Tree, ...]
+        """
+        raise NotImplementedError("To be implemented in subclass")
+
+    @abstractmethod
+    def list_traverse(self, *args: Any, **kwargs: Any) -> Any:
+        """Traverse self and collect all items found.
+
+        Calling this directly on the abstract base class, including via a ``super()``
+        proxy, is deprecated. Only overridden implementations should be called.
+        """
+        warnings.warn(
+            "list_traverse() method should only be called from subclasses."
+            " Calling from Traversable abstract class will raise NotImplementedError in 4.0.0."
+            " The concrete subclasses in GitPython itself are 'Commit', 'RootModule', 'Submodule', and 'Tree'.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self._list_traverse(*args, **kwargs)
+
+    def _list_traverse(
+        self, as_edge: bool = False, *args: Any, **kwargs: Any
+    ) -> IterableList[Union["Commit", "Submodule", "Tree", "Blob"]]:
+        """Traverse self and collect all items found.
+
+        :return:
+            :class:`~git.util.IterableList` with the results of the traversal as
+            produced by :meth:`traverse`::
+
+                Commit -> IterableList[Commit]
+                Submodule ->  IterableList[Submodule]
+                Tree -> IterableList[Union[Submodule, Tree, Blob]]
+        """
+        # Commit and Submodule have id.__attribute__ as IterableObj.
+        # Tree has id.__attribute__ inherited from IndexObject.
+        if isinstance(self, Has_id_attribute):
+            id = self._id_attribute_
+        else:
+            # Shouldn't reach here, unless Traversable subclass created with no
+            # _id_attribute_.
+            id = ""
+            # Could add _id_attribute_ to Traversable, or make all Traversable also
+            # Iterable?
+
+        if not as_edge:
+            out: IterableList[Union["Commit", "Submodule", "Tree", "Blob"]] = IterableList(id)
+            out.extend(self.traverse(as_edge=as_edge, *args, **kwargs))  # noqa: B026
+            return out
+            # Overloads in subclasses (mypy doesn't allow typing self: subclass).
+            # Union[IterableList['Commit'], IterableList['Submodule'], IterableList[Union['Submodule', 'Tree', 'Blob']]]
+        else:
+            # Raise DeprecationWarning, it doesn't make sense to use this.
+            out_list: IterableList = IterableList(self.traverse(*args, **kwargs))
+            return out_list
+
+    @abstractmethod
+    def traverse(self, *args: Any, **kwargs: Any) -> Any:
+        """Iterator yielding items found when traversing self.
+
+        Calling this directly on the abstract base class, including via a ``super()``
+        proxy, is deprecated. Only overridden implementations should be called.
+        """
+        warnings.warn(
+            "traverse() method should only be called from subclasses."
+            " Calling from Traversable abstract class will raise NotImplementedError in 4.0.0."
+            " The concrete subclasses in GitPython itself are 'Commit', 'RootModule', 'Submodule', and 'Tree'.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self._traverse(*args, **kwargs)
+
+    def _traverse(
+        self,
+        predicate: Callable[[Union["Traversable", "Blob", TraversedTup], int], bool] = lambda i, d: True,
+        prune: Callable[[Union["Traversable", "Blob", TraversedTup], int], bool] = lambda i, d: False,
+        depth: int = -1,
+        branch_first: bool = True,
+        visit_once: bool = True,
+        ignore_self: int = 1,
+        as_edge: bool = False,
+    ) -> Union[Iterator[Union["Traversable", "Blob"]], Iterator[TraversedTup]]:
+        """Iterator yielding items found when traversing `self`.
+
+        :param predicate:
+            A function ``f(i,d)`` that returns ``False`` if item i at depth ``d`` should
+            not be included in the result.
+
+        :param prune:
+            A function ``f(i,d)`` that returns ``True`` if the search should stop at
+            item ``i`` at depth ``d``. Item ``i`` will not be returned.
+
+        :param depth:
+            Defines at which level the iteration should not go deeper if -1. There is no
+            limit if 0, you would effectively only get `self`, the root of the
+            iteration. If 1, you would only get the first level of
+            predecessors/successors.
+
+        :param branch_first:
+            If ``True``, items will be returned branch first, otherwise depth first.
+
+        :param visit_once:
+            If ``True``, items will only be returned once, although they might be
+            encountered several times. Loops are prevented that way.
+
+        :param ignore_self:
+            If ``True``, `self` will be ignored and automatically pruned from the
+            result. Otherwise it will be the first item to be returned. If `as_edge` is
+            ``True``, the source of the first edge is ``None``.
+
+        :param as_edge:
+            If ``True``, return a pair of items, first being the source, second the
+            destination, i.e. tuple(src, dest) with the edge spanning from source to
+            destination.
+
+        :return:
+            Iterator yielding items found when traversing `self`::
+
+                Commit -> Iterator[Union[Commit, Tuple[Commit, Commit]] Submodule ->
+                Iterator[Submodule, Tuple[Submodule, Submodule]] Tree ->
+                Iterator[Union[Blob, Tree, Submodule,
+                                        Tuple[Union[Submodule, Tree], Union[Blob, Tree,
+                                        Submodule]]]
+
+                ignore_self=True is_edge=True -> Iterator[item] ignore_self=True
+                is_edge=False --> Iterator[item] ignore_self=False is_edge=True ->
+                Iterator[item] | Iterator[Tuple[src, item]] ignore_self=False
+                is_edge=False -> Iterator[Tuple[src, item]]
+        """
+
+        visited = set()
+        stack: Deque[TraverseNT] = deque()
+        stack.append(TraverseNT(0, self, None))  # self is always depth level 0.
+
+        def addToStack(
+            stack: Deque[TraverseNT],
+            src_item: "Traversable",
+            branch_first: bool,
+            depth: int,
+        ) -> None:
+            lst = self._get_intermediate_items(item)
+            if not lst:  # Empty list
+                return
+            if branch_first:
+                stack.extendleft(TraverseNT(depth, i, src_item) for i in lst)
+            else:
+                reviter = (TraverseNT(depth, lst[i], src_item) for i in range(len(lst) - 1, -1, -1))
+                stack.extend(reviter)
+
+        # END addToStack local method
+
+        while stack:
+            d, item, src = stack.pop()  # Depth of item, item, item_source
+
+            if visit_once and item in visited:
+                continue
+
+            if visit_once:
+                visited.add(item)
+
+            rval: Union[TraversedTup, "Traversable", "Blob"]
+            if as_edge:
+                # If as_edge return (src, item) unless rrc is None
+                # (e.g. for first item).
+                rval = (src, item)
+            else:
+                rval = item
+
+            if prune(rval, d):
+                continue
+
+            skipStartItem = ignore_self and (item is self)
+            if not skipStartItem and predicate(rval, d):
+                yield rval
+
+            # Only continue to next level if this is appropriate!
+            nd = d + 1
+            if depth > -1 and nd > depth:
+                continue
+
+            addToStack(stack, item, branch_first, nd)
+        # END for each item on work stack
+
+
+@runtime_checkable
+class Serializable(Protocol):
+    """Defines methods to serialize and deserialize objects from and into a data
+    stream."""
+
+    __slots__ = ()
+
+    # @abstractmethod
+    def _serialize(self, stream: "BytesIO") -> "Serializable":
+        """Serialize the data of this object into the given data stream.
+
+        :note:
+            A serialized object would :meth:`_deserialize` into the same object.
+
+        :param stream:
+            A file-like object.
+
+        :return:
+            self
+        """
+        raise NotImplementedError("To be implemented in subclass")
+
+    # @abstractmethod
+    def _deserialize(self, stream: "BytesIO") -> "Serializable":
+        """Deserialize all information regarding this object from the stream.
+
+        :param stream:
+            A file-like object.
+
+        :return:
+            self
+        """
+        raise NotImplementedError("To be implemented in subclass")
+
+
+class TraversableIterableObj(IterableObj, Traversable):
+    __slots__ = ()
+
+    TIobj_tuple = Tuple[Union[T_TIobj, None], T_TIobj]
+
+    def list_traverse(self: T_TIobj, *args: Any, **kwargs: Any) -> IterableList[T_TIobj]:
+        return super()._list_traverse(*args, **kwargs)
+
+    @overload
+    def traverse(self: T_TIobj) -> Iterator[T_TIobj]: ...
+
+    @overload
+    def traverse(
+        self: T_TIobj,
+        predicate: Callable[[Union[T_TIobj, Tuple[Union[T_TIobj, None], T_TIobj]], int], bool],
+        prune: Callable[[Union[T_TIobj, Tuple[Union[T_TIobj, None], T_TIobj]], int], bool],
+        depth: int,
+        branch_first: bool,
+        visit_once: bool,
+        ignore_self: Literal[True],
+        as_edge: Literal[False],
+    ) -> Iterator[T_TIobj]: ...
+
+    @overload
+    def traverse(
+        self: T_TIobj,
+        predicate: Callable[[Union[T_TIobj, Tuple[Union[T_TIobj, None], T_TIobj]], int], bool],
+        prune: Callable[[Union[T_TIobj, Tuple[Union[T_TIobj, None], T_TIobj]], int], bool],
+        depth: int,
+        branch_first: bool,
+        visit_once: bool,
+        ignore_self: Literal[False],
+        as_edge: Literal[True],
+    ) -> Iterator[Tuple[Union[T_TIobj, None], T_TIobj]]: ...
+
+    @overload
+    def traverse(
+        self: T_TIobj,
+        predicate: Callable[[Union[T_TIobj, TIobj_tuple], int], bool],
+        prune: Callable[[Union[T_TIobj, TIobj_tuple], int], bool],
+        depth: int,
+        branch_first: bool,
+        visit_once: bool,
+        ignore_self: Literal[True],
+        as_edge: Literal[True],
+    ) -> Iterator[Tuple[T_TIobj, T_TIobj]]: ...
+
+    def traverse(
+        self: T_TIobj,
+        predicate: Callable[[Union[T_TIobj, TIobj_tuple], int], bool] = lambda i, d: True,
+        prune: Callable[[Union[T_TIobj, TIobj_tuple], int], bool] = lambda i, d: False,
+        depth: int = -1,
+        branch_first: bool = True,
+        visit_once: bool = True,
+        ignore_self: int = 1,
+        as_edge: bool = False,
+    ) -> Union[Iterator[T_TIobj], Iterator[Tuple[T_TIobj, T_TIobj]], Iterator[TIobj_tuple]]:
+        """For documentation, see :meth:`Traversable._traverse`."""
+
+        ## To typecheck instead of using cast:
+        #
+        # import itertools
+        # from git.types import TypeGuard
+        # def is_commit_traversed(inp: Tuple) -> TypeGuard[Tuple[Iterator[Tuple['Commit', 'Commit']]]]:
+        #     for x in inp[1]:
+        #         if not isinstance(x, tuple) and len(x) != 2:
+        #             if all(isinstance(inner, Commit) for inner in x):
+        #                 continue
+        #     return True
+        #
+        # ret = super(Commit, self).traverse(predicate, prune, depth, branch_first, visit_once, ignore_self, as_edge)
+        # ret_tup = itertools.tee(ret, 2)
+        # assert is_commit_traversed(ret_tup), f"{[type(x) for x in list(ret_tup[0])]}"
+        # return ret_tup[0]
+
+        return cast(
+            Union[Iterator[T_TIobj], Iterator[Tuple[Union[None, T_TIobj], T_TIobj]]],
+            super()._traverse(
+                predicate,  # type: ignore[arg-type]
+                prune,  # type: ignore[arg-type]
+                depth,
+                branch_first,
+                visit_once,
+                ignore_self,
+                as_edge,
+            ),
+        )
diff --git a/llm/Lib/site-packages/git/py.typed b/llm/Lib/site-packages/git/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/git/refs/__init__.py b/llm/Lib/site-packages/git/refs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d6157e6f37422c85b3f2c62479e68da888a8f598
--- /dev/null
+++ b/llm/Lib/site-packages/git/refs/__init__.py
@@ -0,0 +1,21 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+__all__ = [
+    "HEAD",
+    "Head",
+    "RefLog",
+    "RefLogEntry",
+    "Reference",
+    "RemoteReference",
+    "SymbolicReference",
+    "Tag",
+    "TagReference",
+]
+
+from .head import HEAD, Head
+from .log import RefLog, RefLogEntry
+from .reference import Reference
+from .remote import RemoteReference
+from .symbolic import SymbolicReference
+from .tag import Tag, TagReference
diff --git a/llm/Lib/site-packages/git/refs/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/git/refs/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7631afdc77da389c2bce843dc5e3be61c9b087f0
Binary files /dev/null and b/llm/Lib/site-packages/git/refs/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/refs/__pycache__/head.cpython-311.pyc b/llm/Lib/site-packages/git/refs/__pycache__/head.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e559e6e863931d07e4a4fefe2d9f50c16e7946cd
Binary files /dev/null and b/llm/Lib/site-packages/git/refs/__pycache__/head.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/refs/__pycache__/log.cpython-311.pyc b/llm/Lib/site-packages/git/refs/__pycache__/log.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..59cc9be10b7a97752ad907697bcb2cbe8ecc083b
Binary files /dev/null and b/llm/Lib/site-packages/git/refs/__pycache__/log.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/refs/__pycache__/reference.cpython-311.pyc b/llm/Lib/site-packages/git/refs/__pycache__/reference.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..884fc4de4f3caf252a661c01916f3fa82a50cec3
Binary files /dev/null and b/llm/Lib/site-packages/git/refs/__pycache__/reference.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/refs/__pycache__/remote.cpython-311.pyc b/llm/Lib/site-packages/git/refs/__pycache__/remote.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4f14f6abf8b20b19bc10cb8fb66ea6e911af93f5
Binary files /dev/null and b/llm/Lib/site-packages/git/refs/__pycache__/remote.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/refs/__pycache__/symbolic.cpython-311.pyc b/llm/Lib/site-packages/git/refs/__pycache__/symbolic.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..64a34f927ba8a1139b726aed80cc3ebbeb031020
Binary files /dev/null and b/llm/Lib/site-packages/git/refs/__pycache__/symbolic.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/refs/__pycache__/tag.cpython-311.pyc b/llm/Lib/site-packages/git/refs/__pycache__/tag.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..13190bf8b420df44846df9c6cac3573ccea63522
Binary files /dev/null and b/llm/Lib/site-packages/git/refs/__pycache__/tag.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/refs/head.py b/llm/Lib/site-packages/git/refs/head.py
new file mode 100644
index 0000000000000000000000000000000000000000..7e6fc3377ac7d42906f80d0e91f0e8c4e7117838
--- /dev/null
+++ b/llm/Lib/site-packages/git/refs/head.py
@@ -0,0 +1,304 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Some ref-based objects.
+
+Note the distinction between the :class:`HEAD` and :class:`Head` classes.
+"""
+
+__all__ = ["HEAD", "Head"]
+
+from git.config import GitConfigParser, SectionConstraint
+from git.exc import GitCommandError
+from git.util import join_path
+
+from .reference import Reference
+from .symbolic import SymbolicReference
+
+# typing ---------------------------------------------------
+
+from typing import Any, Sequence, TYPE_CHECKING, Union
+
+from git.types import Commit_ish, PathLike
+
+if TYPE_CHECKING:
+    from git.objects import Commit
+    from git.refs import RemoteReference
+    from git.repo import Repo
+
+# -------------------------------------------------------------------
+
+
+def strip_quotes(string: str) -> str:
+    if string.startswith('"') and string.endswith('"'):
+        return string[1:-1]
+    return string
+
+
+class HEAD(SymbolicReference):
+    """Special case of a :class:`~git.refs.symbolic.SymbolicReference` representing the
+    repository's HEAD reference."""
+
+    _HEAD_NAME = "HEAD"
+    _ORIG_HEAD_NAME = "ORIG_HEAD"
+
+    __slots__ = ()
+
+    # TODO: This can be removed once SymbolicReference.commit has static type hints.
+    commit: "Commit"
+
+    def __init__(self, repo: "Repo", path: PathLike = _HEAD_NAME) -> None:
+        if path != self._HEAD_NAME:
+            raise ValueError("HEAD instance must point to %r, got %r" % (self._HEAD_NAME, path))
+        super().__init__(repo, path)
+
+    def orig_head(self) -> SymbolicReference:
+        """
+        :return:
+            :class:`~git.refs.symbolic.SymbolicReference` pointing at the ORIG_HEAD,
+            which is maintained to contain the previous value of HEAD.
+        """
+        return SymbolicReference(self.repo, self._ORIG_HEAD_NAME)
+
+    def reset(
+        self,
+        commit: Union[Commit_ish, SymbolicReference, str] = "HEAD",
+        index: bool = True,
+        working_tree: bool = False,
+        paths: Union[PathLike, Sequence[PathLike], None] = None,
+        **kwargs: Any,
+    ) -> "HEAD":
+        """Reset our HEAD to the given commit optionally synchronizing the index and
+        working tree. The reference we refer to will be set to commit as well.
+
+        :param commit:
+            :class:`~git.objects.commit.Commit`, :class:`~git.refs.reference.Reference`,
+            or string identifying a revision we should reset HEAD to.
+
+        :param index:
+            If ``True``, the index will be set to match the given commit.
+            Otherwise it will not be touched.
+
+        :param working_tree:
+            If ``True``, the working tree will be forcefully adjusted to match the given
+            commit, possibly overwriting uncommitted changes without warning.
+            If `working_tree` is ``True``, `index` must be ``True`` as well.
+
+        :param paths:
+            Single path or list of paths relative to the git root directory
+            that are to be reset. This allows to partially reset individual files.
+
+        :param kwargs:
+            Additional arguments passed to :manpage:`git-reset(1)`.
+
+        :return:
+            self
+        """
+        mode: Union[str, None]
+        mode = "--soft"
+        if index:
+            mode = "--mixed"
+
+            # It appears some git versions declare mixed and paths deprecated.
+            # See http://github.com/Byron/GitPython/issues#issue/2.
+            if paths:
+                mode = None
+            # END special case
+        # END handle index
+
+        if working_tree:
+            mode = "--hard"
+            if not index:
+                raise ValueError("Cannot reset the working tree if the index is not reset as well")
+
+        # END working tree handling
+
+        try:
+            self.repo.git.reset(mode, commit, "--", paths, **kwargs)
+        except GitCommandError as e:
+            # git nowadays may use 1 as status to indicate there are still unstaged
+            # modifications after the reset.
+            if e.status != 1:
+                raise
+        # END handle exception
+
+        return self
+
+
+class Head(Reference):
+    """A Head is a named reference to a :class:`~git.objects.commit.Commit`. Every Head
+    instance contains a name and a :class:`~git.objects.commit.Commit` object.
+
+    Examples::
+
+        >>> repo = Repo("/path/to/repo")
+        >>> head = repo.heads[0]
+
+        >>> head.name
+        'master'
+
+        >>> head.commit
+        <git.Commit "1c09f116cbc2cb4100fb6935bb162daa4723f455">
+
+        >>> head.commit.hexsha
+        '1c09f116cbc2cb4100fb6935bb162daa4723f455'
+    """
+
+    _common_path_default = "refs/heads"
+    k_config_remote = "remote"
+    k_config_remote_ref = "merge"  # Branch to merge from remote.
+
+    @classmethod
+    def delete(cls, repo: "Repo", *heads: "Union[Head, str]", force: bool = False, **kwargs: Any) -> None:
+        """Delete the given heads.
+
+        :param force:
+            If ``True``, the heads will be deleted even if they are not yet merged into
+            the main development stream. Default ``False``.
+        """
+        flag = "-d"
+        if force:
+            flag = "-D"
+        repo.git.branch(flag, *heads)
+
+    def set_tracking_branch(self, remote_reference: Union["RemoteReference", None]) -> "Head":
+        """Configure this branch to track the given remote reference. This will
+        alter this branch's configuration accordingly.
+
+        :param remote_reference:
+            The remote reference to track or None to untrack any references.
+
+        :return:
+            self
+        """
+        from .remote import RemoteReference
+
+        if remote_reference is not None and not isinstance(remote_reference, RemoteReference):
+            raise ValueError("Incorrect parameter type: %r" % remote_reference)
+        # END handle type
+
+        with self.config_writer() as writer:
+            if remote_reference is None:
+                writer.remove_option(self.k_config_remote)
+                writer.remove_option(self.k_config_remote_ref)
+                if len(writer.options()) == 0:
+                    writer.remove_section()
+            else:
+                writer.set_value(self.k_config_remote, remote_reference.remote_name)
+                writer.set_value(
+                    self.k_config_remote_ref,
+                    Head.to_full_path(remote_reference.remote_head),
+                )
+
+        return self
+
+    def tracking_branch(self) -> Union["RemoteReference", None]:
+        """
+        :return:
+            The remote reference we are tracking, or ``None`` if we are not a tracking
+            branch.
+        """
+        from .remote import RemoteReference
+
+        reader = self.config_reader()
+        if reader.has_option(self.k_config_remote) and reader.has_option(self.k_config_remote_ref):
+            ref = Head(
+                self.repo,
+                Head.to_full_path(strip_quotes(reader.get_value(self.k_config_remote_ref))),
+            )
+            remote_refpath = RemoteReference.to_full_path(join_path(reader.get_value(self.k_config_remote), ref.name))
+            return RemoteReference(self.repo, remote_refpath)
+        # END handle have tracking branch
+
+        # We are not a tracking branch.
+        return None
+
+    def rename(self, new_path: PathLike, force: bool = False) -> "Head":
+        """Rename self to a new path.
+
+        :param new_path:
+            Either a simple name or a path, e.g. ``new_name`` or ``features/new_name``.
+            The prefix ``refs/heads`` is implied.
+
+        :param force:
+            If ``True``, the rename will succeed even if a head with the target name
+            already exists.
+
+        :return:
+            self
+
+        :note:
+            Respects the ref log, as git commands are used.
+        """
+        flag = "-m"
+        if force:
+            flag = "-M"
+
+        self.repo.git.branch(flag, self, new_path)
+        self.path = "%s/%s" % (self._common_path_default, new_path)
+        return self
+
+    def checkout(self, force: bool = False, **kwargs: Any) -> Union["HEAD", "Head"]:
+        """Check out this head by setting the HEAD to this reference, by updating the
+        index to reflect the tree we point to and by updating the working tree to
+        reflect the latest index.
+
+        The command will fail if changed working tree files would be overwritten.
+
+        :param force:
+            If ``True``, changes to the index and the working tree will be discarded.
+            If ``False``, :exc:`~git.exc.GitCommandError` will be raised in that
+            situation.
+
+        :param kwargs:
+            Additional keyword arguments to be passed to git checkout, e.g.
+            ``b="new_branch"`` to create a new branch at the given spot.
+
+        :return:
+            The active branch after the checkout operation, usually self unless a new
+            branch has been created.
+            If there is no active branch, as the HEAD is now detached, the HEAD
+            reference will be returned instead.
+
+        :note:
+            By default it is only allowed to checkout heads - everything else will leave
+            the HEAD detached which is allowed and possible, but remains a special state
+            that some tools might not be able to handle.
+        """
+        kwargs["f"] = force
+        if kwargs["f"] is False:
+            kwargs.pop("f")
+
+        self.repo.git.checkout(self, **kwargs)
+        if self.repo.head.is_detached:
+            return self.repo.head
+        else:
+            return self.repo.active_branch
+
+    # { Configuration
+    def _config_parser(self, read_only: bool) -> SectionConstraint[GitConfigParser]:
+        if read_only:
+            parser = self.repo.config_reader()
+        else:
+            parser = self.repo.config_writer()
+        # END handle parser instance
+
+        return SectionConstraint(parser, 'branch "%s"' % self.name)
+
+    def config_reader(self) -> SectionConstraint[GitConfigParser]:
+        """
+        :return:
+            A configuration parser instance constrained to only read this instance's
+            values.
+        """
+        return self._config_parser(read_only=True)
+
+    def config_writer(self) -> SectionConstraint[GitConfigParser]:
+        """
+        :return:
+            A configuration writer instance with read-and write access to options of
+            this head.
+        """
+        return self._config_parser(read_only=False)
+
+    # } END configuration
diff --git a/llm/Lib/site-packages/git/refs/log.py b/llm/Lib/site-packages/git/refs/log.py
new file mode 100644
index 0000000000000000000000000000000000000000..17e3a94b3087b3e82e1be371a7c1d08d7c937040
--- /dev/null
+++ b/llm/Lib/site-packages/git/refs/log.py
@@ -0,0 +1,399 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+__all__ = ["RefLog", "RefLogEntry"]
+
+from mmap import mmap
+import os.path as osp
+import re
+import time as _time
+
+from git.compat import defenc
+from git.objects.util import (
+    Serializable,
+    altz_to_utctz_str,
+    parse_date,
+)
+from git.util import (
+    Actor,
+    LockedFD,
+    LockFile,
+    assure_directory_exists,
+    bin_to_hex,
+    file_contents_ro_filepath,
+    to_native_path,
+)
+
+# typing ------------------------------------------------------------------
+
+from typing import Iterator, List, Tuple, TYPE_CHECKING, Union
+
+from git.types import PathLike
+
+if TYPE_CHECKING:
+    from io import BytesIO
+
+    from git.config import GitConfigParser, SectionConstraint
+    from git.refs import SymbolicReference
+
+# ------------------------------------------------------------------------------
+
+
+class RefLogEntry(Tuple[str, str, Actor, Tuple[int, int], str]):
+    """Named tuple allowing easy access to the revlog data fields."""
+
+    _re_hexsha_only = re.compile(r"^[0-9A-Fa-f]{40}$")
+
+    __slots__ = ()
+
+    def __repr__(self) -> str:
+        """Representation of ourselves in git reflog format."""
+        return self.format()
+
+    def format(self) -> str:
+        """:return: A string suitable to be placed in a reflog file."""
+        act = self.actor
+        time = self.time
+        return "{} {} {} <{}> {!s} {}\t{}\n".format(
+            self.oldhexsha,
+            self.newhexsha,
+            act.name,
+            act.email,
+            time[0],
+            altz_to_utctz_str(time[1]),
+            self.message,
+        )
+
+    @property
+    def oldhexsha(self) -> str:
+        """The hexsha to the commit the ref pointed to before the change."""
+        return self[0]
+
+    @property
+    def newhexsha(self) -> str:
+        """The hexsha to the commit the ref now points to, after the change."""
+        return self[1]
+
+    @property
+    def actor(self) -> Actor:
+        """Actor instance, providing access."""
+        return self[2]
+
+    @property
+    def time(self) -> Tuple[int, int]:
+        """Time as tuple:
+
+        * [0] = ``int(time)``
+        * [1] = ``int(timezone_offset)`` in :attr:`time.altzone` format
+        """
+        return self[3]
+
+    @property
+    def message(self) -> str:
+        """Message describing the operation that acted on the reference."""
+        return self[4]
+
+    @classmethod
+    def new(
+        cls,
+        oldhexsha: str,
+        newhexsha: str,
+        actor: Actor,
+        time: int,
+        tz_offset: int,
+        message: str,
+    ) -> "RefLogEntry":  # skipcq: PYL-W0621
+        """:return: New instance of a :class:`RefLogEntry`"""
+        if not isinstance(actor, Actor):
+            raise ValueError("Need actor instance, got %s" % actor)
+        # END check types
+        return RefLogEntry((oldhexsha, newhexsha, actor, (time, tz_offset), message))
+
+    @classmethod
+    def from_line(cls, line: bytes) -> "RefLogEntry":
+        """:return: New :class:`RefLogEntry` instance from the given revlog line.
+
+        :param line:
+            Line bytes without trailing newline
+
+        :raise ValueError:
+            If `line` could not be parsed.
+        """
+        line_str = line.decode(defenc)
+        fields = line_str.split("\t", 1)
+        if len(fields) == 1:
+            info, msg = fields[0], None
+        elif len(fields) == 2:
+            info, msg = fields
+        else:
+            raise ValueError("Line must have up to two TAB-separated fields." " Got %s" % repr(line_str))
+        # END handle first split
+
+        oldhexsha = info[:40]
+        newhexsha = info[41:81]
+        for hexsha in (oldhexsha, newhexsha):
+            if not cls._re_hexsha_only.match(hexsha):
+                raise ValueError("Invalid hexsha: %r" % (hexsha,))
+            # END if hexsha re doesn't match
+        # END for each hexsha
+
+        email_end = info.find(">", 82)
+        if email_end == -1:
+            raise ValueError("Missing token: >")
+        # END handle missing end brace
+
+        actor = Actor._from_string(info[82 : email_end + 1])
+        time, tz_offset = parse_date(info[email_end + 2 :])  # skipcq: PYL-W0621
+
+        return RefLogEntry((oldhexsha, newhexsha, actor, (time, tz_offset), msg))
+
+
+class RefLog(List[RefLogEntry], Serializable):
+    R"""A reflog contains :class:`RefLogEntry`\s, each of which defines a certain state
+    of the head in question. Custom query methods allow to retrieve log entries by date
+    or by other criteria.
+
+    Reflog entries are ordered. The first added entry is first in the list. The last
+    entry, i.e. the last change of the head or reference, is last in the list.
+    """
+
+    __slots__ = ("_path",)
+
+    def __new__(cls, filepath: Union[PathLike, None] = None) -> "RefLog":
+        inst = super().__new__(cls)
+        return inst
+
+    def __init__(self, filepath: Union[PathLike, None] = None) -> None:
+        """Initialize this instance with an optional filepath, from which we will
+        initialize our data. The path is also used to write changes back using the
+        :meth:`write` method."""
+        self._path = filepath
+        if filepath is not None:
+            self._read_from_file()
+        # END handle filepath
+
+    def _read_from_file(self) -> None:
+        try:
+            fmap = file_contents_ro_filepath(self._path, stream=True, allow_mmap=True)
+        except OSError:
+            # It is possible and allowed that the file doesn't exist!
+            return
+        # END handle invalid log
+
+        try:
+            self._deserialize(fmap)
+        finally:
+            fmap.close()
+        # END handle closing of handle
+
+    # { Interface
+
+    @classmethod
+    def from_file(cls, filepath: PathLike) -> "RefLog":
+        """
+        :return:
+            A new :class:`RefLog` instance containing all entries from the reflog at the
+            given `filepath`.
+
+        :param filepath:
+            Path to reflog.
+
+        :raise ValueError:
+            If the file could not be read or was corrupted in some way.
+        """
+        return cls(filepath)
+
+    @classmethod
+    def path(cls, ref: "SymbolicReference") -> str:
+        """
+        :return:
+            String to absolute path at which the reflog of the given ref instance would
+            be found. The path is not guaranteed to point to a valid file though.
+
+        :param ref:
+            :class:`~git.refs.symbolic.SymbolicReference` instance
+        """
+        return osp.join(ref.repo.git_dir, "logs", to_native_path(ref.path))
+
+    @classmethod
+    def iter_entries(cls, stream: Union[str, "BytesIO", mmap]) -> Iterator[RefLogEntry]:
+        """
+        :return:
+            Iterator yielding :class:`RefLogEntry` instances, one for each line read
+            from the given stream.
+
+        :param stream:
+            File-like object containing the revlog in its native format or string
+            instance pointing to a file to read.
+        """
+        new_entry = RefLogEntry.from_line
+        if isinstance(stream, str):
+            # Default args return mmap since Python 3.
+            _stream = file_contents_ro_filepath(stream)
+            assert isinstance(_stream, mmap)
+        else:
+            _stream = stream
+        # END handle stream type
+        while True:
+            line = _stream.readline()
+            if not line:
+                return
+            yield new_entry(line.strip())
+        # END endless loop
+
+    @classmethod
+    def entry_at(cls, filepath: PathLike, index: int) -> "RefLogEntry":
+        """
+        :return:
+            :class:`RefLogEntry` at the given index.
+
+        :param filepath:
+            Full path to the index file from which to read the entry.
+
+        :param index:
+            Python list compatible index, i.e. it may be negative to specify an entry
+            counted from the end of the list.
+
+        :raise IndexError:
+            If the entry didn't exist.
+
+        :note:
+            This method is faster as it only parses the entry at index, skipping all
+            other lines. Nonetheless, the whole file has to be read if the index is
+            negative.
+        """
+        with open(filepath, "rb") as fp:
+            if index < 0:
+                return RefLogEntry.from_line(fp.readlines()[index].strip())
+            # Read until index is reached.
+
+            for i in range(index + 1):
+                line = fp.readline()
+                if not line:
+                    raise IndexError(f"Index file ended at line {i + 1}, before given index was reached")
+                # END abort on eof
+            # END handle runup
+
+            return RefLogEntry.from_line(line.strip())
+        # END handle index
+
+    def to_file(self, filepath: PathLike) -> None:
+        """Write the contents of the reflog instance to a file at the given filepath.
+
+        :param filepath:
+            Path to file. Parent directories are assumed to exist.
+        """
+        lfd = LockedFD(filepath)
+        assure_directory_exists(filepath, is_file=True)
+
+        fp = lfd.open(write=True, stream=True)
+        try:
+            self._serialize(fp)
+            lfd.commit()
+        except BaseException:
+            lfd.rollback()
+            raise
+        # END handle change
+
+    @classmethod
+    def append_entry(
+        cls,
+        config_reader: Union[Actor, "GitConfigParser", "SectionConstraint", None],
+        filepath: PathLike,
+        oldbinsha: bytes,
+        newbinsha: bytes,
+        message: str,
+        write: bool = True,
+    ) -> "RefLogEntry":
+        """Append a new log entry to the revlog at filepath.
+
+        :param config_reader:
+            Configuration reader of the repository - used to obtain user information.
+            May also be an :class:`~git.util.Actor` instance identifying the committer
+            directly or ``None``.
+
+        :param filepath:
+            Full path to the log file.
+
+        :param oldbinsha:
+            Binary sha of the previous commit.
+
+        :param newbinsha:
+            Binary sha of the current commit.
+
+        :param message:
+            Message describing the change to the reference.
+
+        :param write:
+            If ``True``, the changes will be written right away.
+            Otherwise the change will not be written.
+
+        :return:
+            :class:`RefLogEntry` objects which was appended to the log.
+
+        :note:
+            As we are append-only, concurrent access is not a problem as we do not
+            interfere with readers.
+        """
+
+        if len(oldbinsha) != 20 or len(newbinsha) != 20:
+            raise ValueError("Shas need to be given in binary format")
+        # END handle sha type
+        assure_directory_exists(filepath, is_file=True)
+        first_line = message.split("\n")[0]
+        if isinstance(config_reader, Actor):
+            committer = config_reader  # mypy thinks this is Actor | Gitconfigparser, but why?
+        else:
+            committer = Actor.committer(config_reader)
+        entry = RefLogEntry(
+            (
+                bin_to_hex(oldbinsha).decode("ascii"),
+                bin_to_hex(newbinsha).decode("ascii"),
+                committer,
+                (int(_time.time()), _time.altzone),
+                first_line,
+            )
+        )
+
+        if write:
+            lf = LockFile(filepath)
+            lf._obtain_lock_or_raise()
+            fd = open(filepath, "ab")
+            try:
+                fd.write(entry.format().encode(defenc))
+            finally:
+                fd.close()
+                lf._release_lock()
+            # END handle write operation
+        return entry
+
+    def write(self) -> "RefLog":
+        """Write this instance's data to the file we are originating from.
+
+        :return:
+            self
+        """
+        if self._path is None:
+            raise ValueError("Instance was not initialized with a path, use to_file(...) instead")
+        # END assert path
+        self.to_file(self._path)
+        return self
+
+    # } END interface
+
+    # { Serializable Interface
+
+    def _serialize(self, stream: "BytesIO") -> "RefLog":
+        write = stream.write
+
+        # Write all entries.
+        for e in self:
+            write(e.format().encode(defenc))
+        # END for each entry
+        return self
+
+    def _deserialize(self, stream: "BytesIO") -> "RefLog":
+        self.extend(self.iter_entries(stream))
+        return self
+
+    # } END serializable interface
diff --git a/llm/Lib/site-packages/git/refs/reference.py b/llm/Lib/site-packages/git/refs/reference.py
new file mode 100644
index 0000000000000000000000000000000000000000..e5d473779165482ef8ca920edad1174d29060ce8
--- /dev/null
+++ b/llm/Lib/site-packages/git/refs/reference.py
@@ -0,0 +1,176 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+__all__ = ["Reference"]
+
+from git.util import IterableObj, LazyMixin
+
+from .symbolic import SymbolicReference, T_References
+
+# typing ------------------------------------------------------------------
+
+from typing import Any, Callable, Iterator, TYPE_CHECKING, Type, Union
+
+from git.types import AnyGitObject, PathLike, _T
+
+if TYPE_CHECKING:
+    from git.repo import Repo
+
+# ------------------------------------------------------------------------------
+
+# { Utilities
+
+
+def require_remote_ref_path(func: Callable[..., _T]) -> Callable[..., _T]:
+    """A decorator raising :exc:`ValueError` if we are not a valid remote, based on the
+    path."""
+
+    def wrapper(self: T_References, *args: Any) -> _T:
+        if not self.is_remote():
+            raise ValueError("ref path does not point to a remote reference: %s" % self.path)
+        return func(self, *args)
+
+    # END wrapper
+    wrapper.__name__ = func.__name__
+    return wrapper
+
+
+# } END utilities
+
+
+class Reference(SymbolicReference, LazyMixin, IterableObj):
+    """A named reference to any object.
+
+    Subclasses may apply restrictions though, e.g., a :class:`~git.refs.head.Head` can
+    only point to commits.
+    """
+
+    __slots__ = ()
+
+    _points_to_commits_only = False
+    _resolve_ref_on_create = True
+    _common_path_default = "refs"
+
+    def __init__(self, repo: "Repo", path: PathLike, check_path: bool = True) -> None:
+        """Initialize this instance.
+
+        :param repo:
+            Our parent repository.
+
+        :param path:
+            Path relative to the ``.git/`` directory pointing to the ref in question,
+            e.g. ``refs/heads/master``.
+
+        :param check_path:
+            If ``False``, you can provide any path.
+            Otherwise the path must start with the default path prefix of this type.
+        """
+        if check_path and not str(path).startswith(self._common_path_default + "/"):
+            raise ValueError(f"Cannot instantiate {self.__class__.__name__!r} from path {path}")
+        self.path: str  # SymbolicReference converts to string at the moment.
+        super().__init__(repo, path)
+
+    def __str__(self) -> str:
+        return self.name
+
+    # { Interface
+
+    # @ReservedAssignment
+    def set_object(
+        self,
+        object: Union[AnyGitObject, "SymbolicReference", str],
+        logmsg: Union[str, None] = None,
+    ) -> "Reference":
+        """Special version which checks if the head-log needs an update as well.
+
+        :return:
+            self
+        """
+        oldbinsha = None
+        if logmsg is not None:
+            head = self.repo.head
+            if not head.is_detached and head.ref == self:
+                oldbinsha = self.commit.binsha
+            # END handle commit retrieval
+        # END handle message is set
+
+        super().set_object(object, logmsg)
+
+        if oldbinsha is not None:
+            # From refs/files-backend.c in git-source:
+            # /*
+            #  * Special hack: If a branch is updated directly and HEAD
+            #  * points to it (may happen on the remote side of a push
+            #  * for example) then logically the HEAD reflog should be
+            #  * updated too.
+            #  * A generic solution implies reverse symref information,
+            #  * but finding all symrefs pointing to the given branch
+            #  * would be rather costly for this rare event (the direct
+            #  * update of a branch) to be worth it.  So let's cheat and
+            #  * check with HEAD only which should cover 99% of all usage
+            #  * scenarios (even 100% of the default ones).
+            #  */
+            self.repo.head.log_append(oldbinsha, logmsg)
+        # END check if the head
+
+        return self
+
+    # NOTE: No need to overwrite properties, as the will only work without a the log.
+
+    @property
+    def name(self) -> str:
+        """
+        :return:
+            (shortest) Name of this reference - it may contain path components
+        """
+        # The first two path tokens can be removed as they are
+        # refs/heads or refs/tags or refs/remotes.
+        tokens = self.path.split("/")
+        if len(tokens) < 3:
+            return self.path  # could be refs/HEAD
+        return "/".join(tokens[2:])
+
+    @classmethod
+    def iter_items(
+        cls: Type[T_References],
+        repo: "Repo",
+        common_path: Union[PathLike, None] = None,
+        *args: Any,
+        **kwargs: Any,
+    ) -> Iterator[T_References]:
+        """Equivalent to
+        :meth:`SymbolicReference.iter_items <git.refs.symbolic.SymbolicReference.iter_items>`,
+        but will return non-detached references as well."""
+        return cls._iter_items(repo, common_path)
+
+    # } END interface
+
+    # { Remote Interface
+
+    @property
+    @require_remote_ref_path
+    def remote_name(self) -> str:
+        """
+        :return:
+            Name of the remote we are a reference of, such as ``origin`` for a reference
+            named ``origin/master``.
+        """
+        tokens = self.path.split("/")
+        # /refs/remotes/<remote name>/<branch_name>
+        return tokens[2]
+
+    @property
+    @require_remote_ref_path
+    def remote_head(self) -> str:
+        """
+        :return:
+            Name of the remote head itself, e.g. ``master``.
+
+        :note:
+            The returned name is usually not qualified enough to uniquely identify a
+            branch.
+        """
+        tokens = self.path.split("/")
+        return "/".join(tokens[3:])
+
+    # } END remote interface
diff --git a/llm/Lib/site-packages/git/refs/remote.py b/llm/Lib/site-packages/git/refs/remote.py
new file mode 100644
index 0000000000000000000000000000000000000000..b4f4f7b366282695cf2676de246758edd631b1ca
--- /dev/null
+++ b/llm/Lib/site-packages/git/refs/remote.py
@@ -0,0 +1,79 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Module implementing a remote object allowing easy access to git remotes."""
+
+__all__ = ["RemoteReference"]
+
+import os
+
+from git.util import join_path
+
+from .head import Head
+
+# typing ------------------------------------------------------------------
+
+from typing import Any, Iterator, NoReturn, TYPE_CHECKING, Union
+
+from git.types import PathLike
+
+if TYPE_CHECKING:
+    from git.remote import Remote
+    from git.repo import Repo
+
+# ------------------------------------------------------------------------------
+
+
+class RemoteReference(Head):
+    """A reference pointing to a remote head."""
+
+    _common_path_default = Head._remote_common_path_default
+
+    @classmethod
+    def iter_items(
+        cls,
+        repo: "Repo",
+        common_path: Union[PathLike, None] = None,
+        remote: Union["Remote", None] = None,
+        *args: Any,
+        **kwargs: Any,
+    ) -> Iterator["RemoteReference"]:
+        """Iterate remote references, and if given, constrain them to the given remote."""
+        common_path = common_path or cls._common_path_default
+        if remote is not None:
+            common_path = join_path(common_path, str(remote))
+        # END handle remote constraint
+        # super is Reference
+        return super().iter_items(repo, common_path)
+
+    # The Head implementation of delete also accepts strs, but this implementation does
+    # not. mypy doesn't have a way of representing tightening the types of arguments in
+    # subclasses and recommends Any or "type: ignore".
+    # (See: https://github.com/python/typing/issues/241)
+    @classmethod
+    def delete(cls, repo: "Repo", *refs: "RemoteReference", **kwargs: Any) -> None:  # type: ignore[override]
+        """Delete the given remote references.
+
+        :note:
+            `kwargs` are given for comparability with the base class method as we
+            should not narrow the signature.
+        """
+        repo.git.branch("-d", "-r", *refs)
+        # The official deletion method will ignore remote symbolic refs - these are
+        # generally ignored in the refs/ folder. We don't though and delete remainders
+        # manually.
+        for ref in refs:
+            try:
+                os.remove(os.path.join(repo.common_dir, ref.path))
+            except OSError:
+                pass
+            try:
+                os.remove(os.path.join(repo.git_dir, ref.path))
+            except OSError:
+                pass
+        # END for each ref
+
+    @classmethod
+    def create(cls, *args: Any, **kwargs: Any) -> NoReturn:
+        """Raise :exc:`TypeError`. Defined so the ``create`` method is disabled."""
+        raise TypeError("Cannot explicitly create remote references")
diff --git a/llm/Lib/site-packages/git/refs/symbolic.py b/llm/Lib/site-packages/git/refs/symbolic.py
new file mode 100644
index 0000000000000000000000000000000000000000..510850b2e62f96fefa1782cf5e9637d7d6abd0f2
--- /dev/null
+++ b/llm/Lib/site-packages/git/refs/symbolic.py
@@ -0,0 +1,926 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+__all__ = ["SymbolicReference"]
+
+import os
+
+from gitdb.exc import BadName, BadObject
+
+from git.compat import defenc
+from git.objects.base import Object
+from git.objects.commit import Commit
+from git.refs.log import RefLog
+from git.util import (
+    LockedFD,
+    assure_directory_exists,
+    hex_to_bin,
+    join_path,
+    join_path_native,
+    to_native_path_linux,
+)
+
+# typing ------------------------------------------------------------------
+
+from typing import (
+    Any,
+    Iterator,
+    List,
+    TYPE_CHECKING,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+)
+
+from git.types import AnyGitObject, PathLike
+
+if TYPE_CHECKING:
+    from git.config import GitConfigParser
+    from git.objects.commit import Actor
+    from git.refs import Head, TagReference, RemoteReference, Reference
+    from git.refs.log import RefLogEntry
+    from git.repo import Repo
+
+
+T_References = TypeVar("T_References", bound="SymbolicReference")
+
+# ------------------------------------------------------------------------------
+
+
+def _git_dir(repo: "Repo", path: Union[PathLike, None]) -> PathLike:
+    """Find the git dir that is appropriate for the path."""
+    name = f"{path}"
+    if name in ["HEAD", "ORIG_HEAD", "FETCH_HEAD", "index", "logs"]:
+        return repo.git_dir
+    return repo.common_dir
+
+
+class SymbolicReference:
+    """Special case of a reference that is symbolic.
+
+    This does not point to a specific commit, but to another
+    :class:`~git.refs.head.Head`, which itself specifies a commit.
+
+    A typical example for a symbolic reference is :class:`~git.refs.head.HEAD`.
+    """
+
+    __slots__ = ("repo", "path")
+
+    _resolve_ref_on_create = False
+    _points_to_commits_only = True
+    _common_path_default = ""
+    _remote_common_path_default = "refs/remotes"
+    _id_attribute_ = "name"
+
+    def __init__(self, repo: "Repo", path: PathLike, check_path: bool = False) -> None:
+        self.repo = repo
+        self.path = path
+
+    def __str__(self) -> str:
+        return str(self.path)
+
+    def __repr__(self) -> str:
+        return '<git.%s "%s">' % (self.__class__.__name__, self.path)
+
+    def __eq__(self, other: object) -> bool:
+        if hasattr(other, "path"):
+            other = cast(SymbolicReference, other)
+            return self.path == other.path
+        return False
+
+    def __ne__(self, other: object) -> bool:
+        return not (self == other)
+
+    def __hash__(self) -> int:
+        return hash(self.path)
+
+    @property
+    def name(self) -> str:
+        """
+        :return:
+            In case of symbolic references, the shortest assumable name is the path
+            itself.
+        """
+        return str(self.path)
+
+    @property
+    def abspath(self) -> PathLike:
+        return join_path_native(_git_dir(self.repo, self.path), self.path)
+
+    @classmethod
+    def _get_packed_refs_path(cls, repo: "Repo") -> str:
+        return os.path.join(repo.common_dir, "packed-refs")
+
+    @classmethod
+    def _iter_packed_refs(cls, repo: "Repo") -> Iterator[Tuple[str, str]]:
+        """Return an iterator yielding pairs of sha1/path pairs (as strings) for the
+        corresponding refs.
+
+        :note:
+            The packed refs file will be kept open as long as we iterate.
+        """
+        try:
+            with open(cls._get_packed_refs_path(repo), "rt", encoding="UTF-8") as fp:
+                for line in fp:
+                    line = line.strip()
+                    if not line:
+                        continue
+                    if line.startswith("#"):
+                        # "# pack-refs with: peeled fully-peeled sorted"
+                        # the git source code shows "peeled",
+                        # "fully-peeled" and "sorted" as the keywords
+                        # that can go on this line, as per comments in git file
+                        # refs/packed-backend.c
+                        # I looked at master on 2017-10-11,
+                        # commit 111ef79afe, after tag v2.15.0-rc1
+                        # from repo https://github.com/git/git.git
+                        if line.startswith("# pack-refs with:") and "peeled" not in line:
+                            raise TypeError("PackingType of packed-Refs not understood: %r" % line)
+                        # END abort if we do not understand the packing scheme
+                        continue
+                    # END parse comment
+
+                    # Skip dereferenced tag object entries - previous line was actual
+                    # tag reference for it.
+                    if line[0] == "^":
+                        continue
+
+                    yield cast(Tuple[str, str], tuple(line.split(" ", 1)))
+                # END for each line
+        except OSError:
+            return None
+        # END no packed-refs file handling
+
+    @classmethod
+    def dereference_recursive(cls, repo: "Repo", ref_path: Union[PathLike, None]) -> str:
+        """
+        :return:
+            hexsha stored in the reference at the given `ref_path`, recursively
+            dereferencing all intermediate references as required
+
+        :param repo:
+            The repository containing the reference at `ref_path`.
+        """
+
+        while True:
+            hexsha, ref_path = cls._get_ref_info(repo, ref_path)
+            if hexsha is not None:
+                return hexsha
+        # END recursive dereferencing
+
+    @staticmethod
+    def _check_ref_name_valid(ref_path: PathLike) -> None:
+        """Check a ref name for validity.
+
+        This is based on the rules described in :manpage:`git-check-ref-format(1)`.
+        """
+        previous: Union[str, None] = None
+        one_before_previous: Union[str, None] = None
+        for c in str(ref_path):
+            if c in " ~^:?*[\\":
+                raise ValueError(
+                    f"Invalid reference '{ref_path}': references cannot contain spaces, tildes (~), carets (^),"
+                    f" colons (:), question marks (?), asterisks (*), open brackets ([) or backslashes (\\)"
+                )
+            elif c == ".":
+                if previous is None or previous == "/":
+                    raise ValueError(
+                        f"Invalid reference '{ref_path}': references cannot start with a period (.) or contain '/.'"
+                    )
+                elif previous == ".":
+                    raise ValueError(f"Invalid reference '{ref_path}': references cannot contain '..'")
+            elif c == "/":
+                if previous == "/":
+                    raise ValueError(f"Invalid reference '{ref_path}': references cannot contain '//'")
+                elif previous is None:
+                    raise ValueError(
+                        f"Invalid reference '{ref_path}': references cannot start with forward slashes '/'"
+                    )
+            elif c == "{" and previous == "@":
+                raise ValueError(f"Invalid reference '{ref_path}': references cannot contain '@{{'")
+            elif ord(c) < 32 or ord(c) == 127:
+                raise ValueError(f"Invalid reference '{ref_path}': references cannot contain ASCII control characters")
+
+            one_before_previous = previous
+            previous = c
+
+        if previous == ".":
+            raise ValueError(f"Invalid reference '{ref_path}': references cannot end with a period (.)")
+        elif previous == "/":
+            raise ValueError(f"Invalid reference '{ref_path}': references cannot end with a forward slash (/)")
+        elif previous == "@" and one_before_previous is None:
+            raise ValueError(f"Invalid reference '{ref_path}': references cannot be '@'")
+        elif any(component.endswith(".lock") for component in str(ref_path).split("/")):
+            raise ValueError(
+                f"Invalid reference '{ref_path}': references cannot have slash-separated components that end with"
+                " '.lock'"
+            )
+
+    @classmethod
+    def _get_ref_info_helper(
+        cls, repo: "Repo", ref_path: Union[PathLike, None]
+    ) -> Union[Tuple[str, None], Tuple[None, str]]:
+        """
+        :return:
+            *(str(sha), str(target_ref_path))*, where:
+
+            * *sha* is of the file at rela_path points to if available, or ``None``.
+            * *target_ref_path* is the reference we point to, or ``None``.
+        """
+        if ref_path:
+            cls._check_ref_name_valid(ref_path)
+
+        tokens: Union[None, List[str], Tuple[str, str]] = None
+        repodir = _git_dir(repo, ref_path)
+        try:
+            with open(os.path.join(repodir, str(ref_path)), "rt", encoding="UTF-8") as fp:
+                value = fp.read().rstrip()
+            # Don't only split on spaces, but on whitespace, which allows to parse lines like:
+            # 60b64ef992065e2600bfef6187a97f92398a9144                branch 'master' of git-server:/path/to/repo
+            tokens = value.split()
+            assert len(tokens) != 0
+        except OSError:
+            # Probably we are just packed. Find our entry in the packed refs file.
+            # NOTE: We are not a symbolic ref if we are in a packed file, as these
+            # are excluded explicitly.
+            for sha, path in cls._iter_packed_refs(repo):
+                if path != ref_path:
+                    continue
+                # sha will be used.
+                tokens = sha, path
+                break
+            # END for each packed ref
+        # END handle packed refs
+        if tokens is None:
+            raise ValueError("Reference at %r does not exist" % ref_path)
+
+        # Is it a reference?
+        if tokens[0] == "ref:":
+            return (None, tokens[1])
+
+        # It's a commit.
+        if repo.re_hexsha_only.match(tokens[0]):
+            return (tokens[0], None)
+
+        raise ValueError("Failed to parse reference information from %r" % ref_path)
+
+    @classmethod
+    def _get_ref_info(cls, repo: "Repo", ref_path: Union[PathLike, None]) -> Union[Tuple[str, None], Tuple[None, str]]:
+        """
+        :return:
+            *(str(sha), str(target_ref_path))*, where:
+
+            * *sha* is of the file at rela_path points to if available, or ``None``.
+            * *target_ref_path* is the reference we point to, or ``None``.
+        """
+        return cls._get_ref_info_helper(repo, ref_path)
+
+    def _get_object(self) -> AnyGitObject:
+        """
+        :return:
+            The object our ref currently refers to. Refs can be cached, they will always
+            point to the actual object as it gets re-created on each query.
+        """
+        # We have to be dynamic here as we may be a tag which can point to anything.
+        # Our path will be resolved to the hexsha which will be used accordingly.
+        return Object.new_from_sha(self.repo, hex_to_bin(self.dereference_recursive(self.repo, self.path)))
+
+    def _get_commit(self) -> "Commit":
+        """
+        :return:
+            :class:`~git.objects.commit.Commit` object we point to. This works for
+            detached and non-detached :class:`SymbolicReference` instances. The symbolic
+            reference will be dereferenced recursively.
+        """
+        obj = self._get_object()
+        if obj.type == "tag":
+            obj = obj.object
+        # END dereference tag
+
+        if obj.type != Commit.type:
+            raise TypeError("Symbolic Reference pointed to object %r, commit was required" % obj)
+        # END handle type
+        return obj
+
+    def set_commit(
+        self,
+        commit: Union[Commit, "SymbolicReference", str],
+        logmsg: Union[str, None] = None,
+    ) -> "SymbolicReference":
+        """Like :meth:`set_object`, but restricts the type of object to be a
+        :class:`~git.objects.commit.Commit`.
+
+        :raise ValueError:
+            If `commit` is not a :class:`~git.objects.commit.Commit` object, nor does it
+            point to a commit.
+
+        :return:
+            self
+        """
+        # Check the type - assume the best if it is a base-string.
+        invalid_type = False
+        if isinstance(commit, Object):
+            invalid_type = commit.type != Commit.type
+        elif isinstance(commit, SymbolicReference):
+            invalid_type = commit.object.type != Commit.type
+        else:
+            try:
+                invalid_type = self.repo.rev_parse(commit).type != Commit.type
+            except (BadObject, BadName) as e:
+                raise ValueError("Invalid object: %s" % commit) from e
+            # END handle exception
+        # END verify type
+
+        if invalid_type:
+            raise ValueError("Need commit, got %r" % commit)
+        # END handle raise
+
+        # We leave strings to the rev-parse method below.
+        self.set_object(commit, logmsg)
+
+        return self
+
+    def set_object(
+        self,
+        object: Union[AnyGitObject, "SymbolicReference", str],
+        logmsg: Union[str, None] = None,
+    ) -> "SymbolicReference":
+        """Set the object we point to, possibly dereference our symbolic reference
+        first. If the reference does not exist, it will be created.
+
+        :param object:
+            A refspec, a :class:`SymbolicReference` or an
+            :class:`~git.objects.base.Object` instance.
+
+            * :class:`SymbolicReference` instances will be dereferenced beforehand to
+              obtain the git object they point to.
+            * :class:`~git.objects.base.Object` instances must represent git objects
+              (:class:`~git.types.AnyGitObject`).
+
+        :param logmsg:
+            If not ``None``, the message will be used in the reflog entry to be written.
+            Otherwise the reflog is not altered.
+
+        :note:
+            Plain :class:`SymbolicReference` instances may not actually point to objects
+            by convention.
+
+        :return:
+            self
+        """
+        if isinstance(object, SymbolicReference):
+            object = object.object  # @ReservedAssignment
+        # END resolve references
+
+        is_detached = True
+        try:
+            is_detached = self.is_detached
+        except ValueError:
+            pass
+        # END handle non-existing ones
+
+        if is_detached:
+            return self.set_reference(object, logmsg)
+
+        # set the commit on our reference
+        return self._get_reference().set_object(object, logmsg)
+
+    commit = property(
+        _get_commit,
+        set_commit,  # type: ignore[arg-type]
+        doc="Query or set commits directly",
+    )
+
+    object = property(
+        _get_object,
+        set_object,  # type: ignore[arg-type]
+        doc="Return the object our ref currently refers to",
+    )
+
+    def _get_reference(self) -> "SymbolicReference":
+        """
+        :return:
+            :class:`~git.refs.reference.Reference` object we point to
+
+        :raise TypeError:
+            If this symbolic reference is detached, hence it doesn't point to a
+            reference, but to a commit.
+        """
+        sha, target_ref_path = self._get_ref_info(self.repo, self.path)
+        if target_ref_path is None:
+            raise TypeError("%s is a detached symbolic reference as it points to %r" % (self, sha))
+        return self.from_path(self.repo, target_ref_path)
+
+    def set_reference(
+        self,
+        ref: Union[AnyGitObject, "SymbolicReference", str],
+        logmsg: Union[str, None] = None,
+    ) -> "SymbolicReference":
+        """Set ourselves to the given `ref`.
+
+        It will stay a symbol if the `ref` is a :class:`~git.refs.reference.Reference`.
+
+        Otherwise a git object, specified as a :class:`~git.objects.base.Object`
+        instance or refspec, is assumed. If it is valid, this reference will be set to
+        it, which effectively detaches the reference if it was a purely symbolic one.
+
+        :param ref:
+            A :class:`SymbolicReference` instance, an :class:`~git.objects.base.Object`
+            instance (specifically an :class:`~git.types.AnyGitObject`), or a refspec
+            string. Only if the ref is a :class:`SymbolicReference` instance, we will
+            point to it. Everything else is dereferenced to obtain the actual object.
+
+        :param logmsg:
+            If set to a string, the message will be used in the reflog.
+            Otherwise, a reflog entry is not written for the changed reference.
+            The previous commit of the entry will be the commit we point to now.
+
+            See also: :meth:`log_append`
+
+        :return:
+            self
+
+        :note:
+            This symbolic reference will not be dereferenced. For that, see
+            :meth:`set_object`.
+        """
+        write_value = None
+        obj = None
+        if isinstance(ref, SymbolicReference):
+            write_value = "ref: %s" % ref.path
+        elif isinstance(ref, Object):
+            obj = ref
+            write_value = ref.hexsha
+        elif isinstance(ref, str):
+            try:
+                obj = self.repo.rev_parse(ref + "^{}")  # Optionally dereference tags.
+                write_value = obj.hexsha
+            except (BadObject, BadName) as e:
+                raise ValueError("Could not extract object from %s" % ref) from e
+            # END end try string
+        else:
+            raise ValueError("Unrecognized Value: %r" % ref)
+        # END try commit attribute
+
+        # typecheck
+        if obj is not None and self._points_to_commits_only and obj.type != Commit.type:
+            raise TypeError("Require commit, got %r" % obj)
+        # END verify type
+
+        oldbinsha: bytes = b""
+        if logmsg is not None:
+            try:
+                oldbinsha = self.commit.binsha
+            except ValueError:
+                oldbinsha = Commit.NULL_BIN_SHA
+            # END handle non-existing
+        # END retrieve old hexsha
+
+        fpath = self.abspath
+        assure_directory_exists(fpath, is_file=True)
+
+        lfd = LockedFD(fpath)
+        fd = lfd.open(write=True, stream=True)
+        try:
+            fd.write(write_value.encode("utf-8") + b"\n")
+            lfd.commit()
+        except BaseException:
+            lfd.rollback()
+            raise
+        # Adjust the reflog
+        if logmsg is not None:
+            self.log_append(oldbinsha, logmsg)
+
+        return self
+
+    # Aliased reference
+    reference: Union["Head", "TagReference", "RemoteReference", "Reference"]
+    reference = property(  # type: ignore[assignment]
+        _get_reference,
+        set_reference,  # type: ignore[arg-type]
+        doc="Returns the Reference we point to",
+    )
+    ref = reference
+
+    def is_valid(self) -> bool:
+        """
+        :return:
+            ``True`` if the reference is valid, hence it can be read and points to a
+            valid object or reference.
+        """
+        try:
+            self.object  # noqa: B018
+        except (OSError, ValueError):
+            return False
+        else:
+            return True
+
+    @property
+    def is_detached(self) -> bool:
+        """
+        :return:
+            ``True`` if we are a detached reference, hence we point to a specific commit
+            instead to another reference.
+        """
+        try:
+            self.ref  # noqa: B018
+            return False
+        except TypeError:
+            return True
+
+    def log(self) -> "RefLog":
+        """
+        :return:
+            :class:`~git.refs.log.RefLog` for this reference.
+            Its last entry reflects the latest change applied to this reference.
+
+        :note:
+            As the log is parsed every time, its recommended to cache it for use instead
+            of calling this method repeatedly. It should be considered read-only.
+        """
+        return RefLog.from_file(RefLog.path(self))
+
+    def log_append(
+        self,
+        oldbinsha: bytes,
+        message: Union[str, None],
+        newbinsha: Union[bytes, None] = None,
+    ) -> "RefLogEntry":
+        """Append a logentry to the logfile of this ref.
+
+        :param oldbinsha:
+            Binary sha this ref used to point to.
+
+        :param message:
+            A message describing the change.
+
+        :param newbinsha:
+            The sha the ref points to now. If None, our current commit sha will be used.
+
+        :return:
+            The added :class:`~git.refs.log.RefLogEntry` instance.
+        """
+        # NOTE: We use the committer of the currently active commit - this should be
+        # correct to allow overriding the committer on a per-commit level.
+        # See https://github.com/gitpython-developers/GitPython/pull/146.
+        try:
+            committer_or_reader: Union["Actor", "GitConfigParser"] = self.commit.committer
+        except ValueError:
+            committer_or_reader = self.repo.config_reader()
+        # END handle newly cloned repositories
+        if newbinsha is None:
+            newbinsha = self.commit.binsha
+
+        if message is None:
+            message = ""
+
+        return RefLog.append_entry(committer_or_reader, RefLog.path(self), oldbinsha, newbinsha, message)
+
+    def log_entry(self, index: int) -> "RefLogEntry":
+        """
+        :return:
+            :class:`~git.refs.log.RefLogEntry` at the given index
+
+        :param index:
+            Python list compatible positive or negative index.
+
+        :note:
+            This method must read part of the reflog during execution, hence it should
+            be used sparingly, or only if you need just one index. In that case, it will
+            be faster than the :meth:`log` method.
+        """
+        return RefLog.entry_at(RefLog.path(self), index)
+
+    @classmethod
+    def to_full_path(cls, path: Union[PathLike, "SymbolicReference"]) -> PathLike:
+        """
+        :return:
+            String with a full repository-relative path which can be used to initialize
+            a :class:`~git.refs.reference.Reference` instance, for instance by using
+            :meth:`Reference.from_path <git.refs.reference.Reference.from_path>`.
+        """
+        if isinstance(path, SymbolicReference):
+            path = path.path
+        full_ref_path = path
+        if not cls._common_path_default:
+            return full_ref_path
+        if not str(path).startswith(cls._common_path_default + "/"):
+            full_ref_path = "%s/%s" % (cls._common_path_default, path)
+        return full_ref_path
+
+    @classmethod
+    def delete(cls, repo: "Repo", path: PathLike) -> None:
+        """Delete the reference at the given path.
+
+        :param repo:
+            Repository to delete the reference from.
+
+        :param path:
+            Short or full path pointing to the reference, e.g. ``refs/myreference`` or
+            just ``myreference``, hence ``refs/`` is implied.
+            Alternatively the symbolic reference to be deleted.
+        """
+        full_ref_path = cls.to_full_path(path)
+        abs_path = os.path.join(repo.common_dir, full_ref_path)
+        if os.path.exists(abs_path):
+            os.remove(abs_path)
+        else:
+            # Check packed refs.
+            pack_file_path = cls._get_packed_refs_path(repo)
+            try:
+                with open(pack_file_path, "rb") as reader:
+                    new_lines = []
+                    made_change = False
+                    dropped_last_line = False
+                    for line_bytes in reader:
+                        line = line_bytes.decode(defenc)
+                        _, _, line_ref = line.partition(" ")
+                        line_ref = line_ref.strip()
+                        # Keep line if it is a comment or if the ref to delete is not in
+                        # the line.
+                        # If we deleted the last line and this one is a tag-reference
+                        # object, we drop it as well.
+                        if (line.startswith("#") or full_ref_path != line_ref) and (
+                            not dropped_last_line or dropped_last_line and not line.startswith("^")
+                        ):
+                            new_lines.append(line)
+                            dropped_last_line = False
+                            continue
+                        # END skip comments and lines without our path
+
+                        # Drop this line.
+                        made_change = True
+                        dropped_last_line = True
+
+                # Write the new lines.
+                if made_change:
+                    # Binary writing is required, otherwise Windows will open the file
+                    # in text mode and change LF to CRLF!
+                    with open(pack_file_path, "wb") as fd:
+                        fd.writelines(line.encode(defenc) for line in new_lines)
+
+            except OSError:
+                pass  # It didn't exist at all.
+
+        # Delete the reflog.
+        reflog_path = RefLog.path(cls(repo, full_ref_path))
+        if os.path.isfile(reflog_path):
+            os.remove(reflog_path)
+        # END remove reflog
+
+    @classmethod
+    def _create(
+        cls: Type[T_References],
+        repo: "Repo",
+        path: PathLike,
+        resolve: bool,
+        reference: Union["SymbolicReference", str],
+        force: bool,
+        logmsg: Union[str, None] = None,
+    ) -> T_References:
+        """Internal method used to create a new symbolic reference.
+
+        If `resolve` is ``False``, the reference will be taken as is, creating a proper
+        symbolic reference. Otherwise it will be resolved to the corresponding object
+        and a detached symbolic reference will be created instead.
+        """
+        git_dir = _git_dir(repo, path)
+        full_ref_path = cls.to_full_path(path)
+        abs_ref_path = os.path.join(git_dir, full_ref_path)
+
+        # Figure out target data.
+        target = reference
+        if resolve:
+            target = repo.rev_parse(str(reference))
+
+        if not force and os.path.isfile(abs_ref_path):
+            target_data = str(target)
+            if isinstance(target, SymbolicReference):
+                target_data = str(target.path)
+            if not resolve:
+                target_data = "ref: " + target_data
+            with open(abs_ref_path, "rb") as fd:
+                existing_data = fd.read().decode(defenc).strip()
+            if existing_data != target_data:
+                raise OSError(
+                    "Reference at %r does already exist, pointing to %r, requested was %r"
+                    % (full_ref_path, existing_data, target_data)
+                )
+        # END no force handling
+
+        ref = cls(repo, full_ref_path)
+        ref.set_reference(target, logmsg)
+        return ref
+
+    @classmethod
+    def create(
+        cls: Type[T_References],
+        repo: "Repo",
+        path: PathLike,
+        reference: Union["SymbolicReference", str] = "HEAD",
+        logmsg: Union[str, None] = None,
+        force: bool = False,
+        **kwargs: Any,
+    ) -> T_References:
+        """Create a new symbolic reference: a reference pointing to another reference.
+
+        :param repo:
+            Repository to create the reference in.
+
+        :param path:
+            Full path at which the new symbolic reference is supposed to be created at,
+            e.g. ``NEW_HEAD`` or ``symrefs/my_new_symref``.
+
+        :param reference:
+            The reference which the new symbolic reference should point to.
+            If it is a commit-ish, the symbolic ref will be detached.
+
+        :param force:
+            If ``True``, force creation even if a symbolic reference with that name
+            already exists. Raise :exc:`OSError` otherwise.
+
+        :param logmsg:
+            If not ``None``, the message to append to the reflog.
+            If ``None``, no reflog entry is written.
+
+        :return:
+            Newly created symbolic reference
+
+        :raise OSError:
+            If a (Symbolic)Reference with the same name but different contents already
+            exists.
+
+        :note:
+            This does not alter the current HEAD, index or working tree.
+        """
+        return cls._create(repo, path, cls._resolve_ref_on_create, reference, force, logmsg)
+
+    def rename(self, new_path: PathLike, force: bool = False) -> "SymbolicReference":
+        """Rename self to a new path.
+
+        :param new_path:
+            Either a simple name or a full path, e.g. ``new_name`` or
+            ``features/new_name``.
+            The prefix ``refs/`` is implied for references and will be set as needed.
+            In case this is a symbolic ref, there is no implied prefix.
+
+        :param force:
+            If ``True``, the rename will succeed even if a head with the target name
+            already exists. It will be overwritten in that case.
+
+        :return:
+            self
+
+        :raise OSError:
+            If a file at path but with different contents already exists.
+        """
+        new_path = self.to_full_path(new_path)
+        if self.path == new_path:
+            return self
+
+        new_abs_path = os.path.join(_git_dir(self.repo, new_path), new_path)
+        cur_abs_path = os.path.join(_git_dir(self.repo, self.path), self.path)
+        if os.path.isfile(new_abs_path):
+            if not force:
+                # If they point to the same file, it's not an error.
+                with open(new_abs_path, "rb") as fd1:
+                    f1 = fd1.read().strip()
+                with open(cur_abs_path, "rb") as fd2:
+                    f2 = fd2.read().strip()
+                if f1 != f2:
+                    raise OSError("File at path %r already exists" % new_abs_path)
+                # else: We could remove ourselves and use the other one, but...
+                # ...for clarity, we just continue as usual.
+            # END not force handling
+            os.remove(new_abs_path)
+        # END handle existing target file
+
+        dname = os.path.dirname(new_abs_path)
+        if not os.path.isdir(dname):
+            os.makedirs(dname)
+        # END create directory
+
+        os.rename(cur_abs_path, new_abs_path)
+        self.path = new_path
+
+        return self
+
+    @classmethod
+    def _iter_items(
+        cls: Type[T_References], repo: "Repo", common_path: Union[PathLike, None] = None
+    ) -> Iterator[T_References]:
+        if common_path is None:
+            common_path = cls._common_path_default
+        rela_paths = set()
+
+        # Walk loose refs.
+        # Currently we do not follow links.
+        for root, dirs, files in os.walk(join_path_native(repo.common_dir, common_path)):
+            if "refs" not in root.split(os.sep):  # Skip non-refs subfolders.
+                refs_id = [d for d in dirs if d == "refs"]
+                if refs_id:
+                    dirs[0:] = ["refs"]
+            # END prune non-refs folders
+
+            for f in files:
+                if f == "packed-refs":
+                    continue
+                abs_path = to_native_path_linux(join_path(root, f))
+                rela_paths.add(abs_path.replace(to_native_path_linux(repo.common_dir) + "/", ""))
+            # END for each file in root directory
+        # END for each directory to walk
+
+        # Read packed refs.
+        for _sha, rela_path in cls._iter_packed_refs(repo):
+            if rela_path.startswith(str(common_path)):
+                rela_paths.add(rela_path)
+            # END relative path matches common path
+        # END packed refs reading
+
+        # Yield paths in sorted order.
+        for path in sorted(rela_paths):
+            try:
+                yield cls.from_path(repo, path)
+            except ValueError:
+                continue
+        # END for each sorted relative refpath
+
+    @classmethod
+    def iter_items(
+        cls: Type[T_References],
+        repo: "Repo",
+        common_path: Union[PathLike, None] = None,
+        *args: Any,
+        **kwargs: Any,
+    ) -> Iterator[T_References]:
+        """Find all refs in the repository.
+
+        :param repo:
+            The :class:`~git.repo.base.Repo`.
+
+        :param common_path:
+            Optional keyword argument to the path which is to be shared by all returned
+            Ref objects.
+            Defaults to class specific portion if ``None``, ensuring that only refs
+            suitable for the actual class are returned.
+
+        :return:
+            A list of :class:`SymbolicReference`, each guaranteed to be a symbolic ref
+            which is not detached and pointing to a valid ref.
+
+            The list is lexicographically sorted. The returned objects are instances of
+            concrete subclasses, such as :class:`~git.refs.head.Head` or
+            :class:`~git.refs.tag.TagReference`.
+        """
+        return (r for r in cls._iter_items(repo, common_path) if r.__class__ is SymbolicReference or not r.is_detached)
+
+    @classmethod
+    def from_path(cls: Type[T_References], repo: "Repo", path: PathLike) -> T_References:
+        """Make a symbolic reference from a path.
+
+        :param path:
+            Full ``.git``-directory-relative path name to the Reference to instantiate.
+
+        :note:
+            Use :meth:`to_full_path` if you only have a partial path of a known
+            Reference type.
+
+        :return:
+            Instance of type :class:`~git.refs.reference.Reference`,
+            :class:`~git.refs.head.Head`, or :class:`~git.refs.tag.Tag`, depending on
+            the given path.
+        """
+        if not path:
+            raise ValueError("Cannot create Reference from %r" % path)
+
+        # Names like HEAD are inserted after the refs module is imported - we have an
+        # import dependency cycle and don't want to import these names in-function.
+        from . import HEAD, Head, RemoteReference, TagReference, Reference
+
+        for ref_type in (
+            HEAD,
+            Head,
+            RemoteReference,
+            TagReference,
+            Reference,
+            SymbolicReference,
+        ):
+            try:
+                instance: T_References
+                instance = ref_type(repo, path)
+                if instance.__class__ is SymbolicReference and instance.is_detached:
+                    raise ValueError("SymbolicRef was detached, we drop it")
+                else:
+                    return instance
+
+            except ValueError:
+                pass
+            # END exception handling
+        # END for each type to try
+        raise ValueError("Could not find reference type suitable to handle path %r" % path)
+
+    def is_remote(self) -> bool:
+        """:return: True if this symbolic reference points to a remote branch"""
+        return str(self.path).startswith(self._remote_common_path_default + "/")
diff --git a/llm/Lib/site-packages/git/refs/tag.py b/llm/Lib/site-packages/git/refs/tag.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e38663ae9a3b43bb43dcff9c493551febf6a38e
--- /dev/null
+++ b/llm/Lib/site-packages/git/refs/tag.py
@@ -0,0 +1,155 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Provides a :class:`~git.refs.reference.Reference`-based type for lightweight tags.
+
+This defines the :class:`TagReference` class (and its alias :class:`Tag`), which
+represents lightweight tags. For annotated tags (which are git objects), see the
+:mod:`git.objects.tag` module.
+"""
+
+__all__ = ["TagReference", "Tag"]
+
+from .reference import Reference
+
+# typing ------------------------------------------------------------------
+
+from typing import Any, TYPE_CHECKING, Type, Union
+
+from git.types import AnyGitObject, PathLike
+
+if TYPE_CHECKING:
+    from git.objects import Commit, TagObject
+    from git.refs import SymbolicReference
+    from git.repo import Repo
+
+# ------------------------------------------------------------------------------
+
+
+class TagReference(Reference):
+    """A lightweight tag reference which either points to a commit, a tag object or any
+    other object. In the latter case additional information, like the signature or the
+    tag-creator, is available.
+
+    This tag object will always point to a commit object, but may carry additional
+    information in a tag object::
+
+     tagref = TagReference.list_items(repo)[0]
+     print(tagref.commit.message)
+     if tagref.tag is not None:
+        print(tagref.tag.message)
+    """
+
+    __slots__ = ()
+
+    _common_default = "tags"
+    _common_path_default = Reference._common_path_default + "/" + _common_default
+
+    @property
+    def commit(self) -> "Commit":  # type: ignore[override]  # LazyMixin has unrelated commit method
+        """:return: Commit object the tag ref points to
+
+        :raise ValueError:
+            If the tag points to a tree or blob.
+        """
+        obj = self.object
+        while obj.type != "commit":
+            if obj.type == "tag":
+                # It is a tag object which carries the commit as an object - we can point to anything.
+                obj = obj.object
+            else:
+                raise ValueError(
+                    (
+                        "Cannot resolve commit as tag %s points to a %s object - "
+                        + "use the `.object` property instead to access it"
+                    )
+                    % (self, obj.type)
+                )
+        return obj
+
+    @property
+    def tag(self) -> Union["TagObject", None]:
+        """
+        :return:
+            Tag object this tag ref points to, or ``None`` in case we are a lightweight
+            tag
+        """
+        obj = self.object
+        if obj.type == "tag":
+            return obj
+        return None
+
+    # Make object read-only. It should be reasonably hard to adjust an existing tag.
+    @property
+    def object(self) -> AnyGitObject:  # type: ignore[override]
+        return Reference._get_object(self)
+
+    @classmethod
+    def create(
+        cls: Type["TagReference"],
+        repo: "Repo",
+        path: PathLike,
+        reference: Union[str, "SymbolicReference"] = "HEAD",
+        logmsg: Union[str, None] = None,
+        force: bool = False,
+        **kwargs: Any,
+    ) -> "TagReference":
+        """Create a new tag reference.
+
+        :param repo:
+            The :class:`~git.repo.base.Repo` to create the tag in.
+
+        :param path:
+            The name of the tag, e.g. ``1.0`` or ``releases/1.0``.
+            The prefix ``refs/tags`` is implied.
+
+        :param reference:
+            A reference to the :class:`~git.objects.base.Object` you want to tag.
+            The referenced object can be a commit, tree, or blob.
+
+        :param logmsg:
+            If not ``None``, the message will be used in your tag object. This will also
+            create an additional tag object that allows to obtain that information,
+            e.g.::
+
+                tagref.tag.message
+
+        :param message:
+            Synonym for the `logmsg` parameter. Included for backwards compatibility.
+            `logmsg` takes precedence if both are passed.
+
+        :param force:
+            If ``True``, force creation of a tag even though that tag already exists.
+
+        :param kwargs:
+            Additional keyword arguments to be passed to :manpage:`git-tag(1)`.
+
+        :return:
+            A new :class:`TagReference`.
+        """
+        if "ref" in kwargs and kwargs["ref"]:
+            reference = kwargs["ref"]
+
+        if "message" in kwargs and kwargs["message"]:
+            kwargs["m"] = kwargs["message"]
+            del kwargs["message"]
+
+        if logmsg:
+            kwargs["m"] = logmsg
+
+        if force:
+            kwargs["f"] = True
+
+        args = (path, reference)
+
+        repo.git.tag(*args, **kwargs)
+        return TagReference(repo, "%s/%s" % (cls._common_path_default, path))
+
+    @classmethod
+    def delete(cls, repo: "Repo", *tags: "TagReference") -> None:  # type: ignore[override]
+        """Delete the given existing tag or tags."""
+        repo.git.tag("-d", *tags)
+
+
+# Provide an alias.
+Tag = TagReference
diff --git a/llm/Lib/site-packages/git/remote.py b/llm/Lib/site-packages/git/remote.py
new file mode 100644
index 0000000000000000000000000000000000000000..f2ecd0f360e763aa5415a40543095d43727fc31e
--- /dev/null
+++ b/llm/Lib/site-packages/git/remote.py
@@ -0,0 +1,1241 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Module implementing a remote object allowing easy access to git remotes."""
+
+__all__ = ["RemoteProgress", "PushInfo", "FetchInfo", "Remote"]
+
+import contextlib
+import logging
+import re
+
+from git.cmd import Git, handle_process_output
+from git.compat import defenc, force_text
+from git.config import GitConfigParser, SectionConstraint, cp
+from git.exc import GitCommandError
+from git.refs import Head, Reference, RemoteReference, SymbolicReference, TagReference
+from git.util import (
+    CallableRemoteProgress,
+    IterableList,
+    IterableObj,
+    LazyMixin,
+    RemoteProgress,
+    join_path,
+)
+
+# typing-------------------------------------------------------
+
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    NoReturn,
+    Optional,
+    Sequence,
+    TYPE_CHECKING,
+    Type,
+    Union,
+    cast,
+    overload,
+)
+
+from git.types import AnyGitObject, Literal, PathLike
+
+if TYPE_CHECKING:
+    from git.objects.commit import Commit
+    from git.objects.submodule.base import UpdateProgress
+    from git.repo.base import Repo
+
+flagKeyLiteral = Literal[" ", "!", "+", "-", "*", "=", "t", "?"]
+
+# -------------------------------------------------------------
+
+_logger = logging.getLogger(__name__)
+
+# { Utilities
+
+
+def add_progress(
+    kwargs: Any,
+    git: Git,
+    progress: Union[RemoteProgress, "UpdateProgress", Callable[..., RemoteProgress], None],
+) -> Any:
+    """Add the ``--progress`` flag to the given `kwargs` dict if supported by the git
+    command.
+
+    :note:
+        If the actual progress in the given progress instance is not given, we do not
+        request any progress.
+
+    :return:
+        Possibly altered `kwargs`
+    """
+    if progress is not None:
+        v = git.version_info[:2]
+        if v >= (1, 7):
+            kwargs["progress"] = True
+        # END handle --progress
+    # END handle progress
+    return kwargs
+
+
+# } END utilities
+
+
+@overload
+def to_progress_instance(progress: None) -> RemoteProgress: ...
+
+
+@overload
+def to_progress_instance(progress: Callable[..., Any]) -> CallableRemoteProgress: ...
+
+
+@overload
+def to_progress_instance(progress: RemoteProgress) -> RemoteProgress: ...
+
+
+def to_progress_instance(
+    progress: Union[Callable[..., Any], RemoteProgress, None],
+) -> Union[RemoteProgress, CallableRemoteProgress]:
+    """Given the `progress` return a suitable object derived from
+    :class:`~git.util.RemoteProgress`."""
+    # New API only needs progress as a function.
+    if callable(progress):
+        return CallableRemoteProgress(progress)
+
+    # Where None is passed create a parser that eats the progress.
+    elif progress is None:
+        return RemoteProgress()
+
+    # Assume its the old API with an instance of RemoteProgress.
+    return progress
+
+
+class PushInfo(IterableObj):
+    """
+    Carries information about the result of a push operation of a single head::
+
+        info = remote.push()[0]
+        info.flags          # bitflags providing more information about the result
+        info.local_ref      # Reference pointing to the local reference that was pushed
+                            # It is None if the ref was deleted.
+        info.remote_ref_string # path to the remote reference located on the remote side
+        info.remote_ref # Remote Reference on the local side corresponding to
+                        # the remote_ref_string. It can be a TagReference as well.
+        info.old_commit # commit at which the remote_ref was standing before we pushed
+                        # it to local_ref.commit. Will be None if an error was indicated
+        info.summary    # summary line providing human readable english text about the push
+    """
+
+    __slots__ = (
+        "local_ref",
+        "remote_ref_string",
+        "flags",
+        "_old_commit_sha",
+        "_remote",
+        "summary",
+    )
+
+    _id_attribute_ = "pushinfo"
+
+    (
+        NEW_TAG,
+        NEW_HEAD,
+        NO_MATCH,
+        REJECTED,
+        REMOTE_REJECTED,
+        REMOTE_FAILURE,
+        DELETED,
+        FORCED_UPDATE,
+        FAST_FORWARD,
+        UP_TO_DATE,
+        ERROR,
+    ) = [1 << x for x in range(11)]
+
+    _flag_map = {
+        "X": NO_MATCH,
+        "-": DELETED,
+        "*": 0,
+        "+": FORCED_UPDATE,
+        " ": FAST_FORWARD,
+        "=": UP_TO_DATE,
+        "!": ERROR,
+    }
+
+    def __init__(
+        self,
+        flags: int,
+        local_ref: Union[SymbolicReference, None],
+        remote_ref_string: str,
+        remote: "Remote",
+        old_commit: Optional[str] = None,
+        summary: str = "",
+    ) -> None:
+        """Initialize a new instance.
+
+        local_ref: HEAD | Head | RemoteReference | TagReference | Reference | SymbolicReference | None
+        """
+        self.flags = flags
+        self.local_ref = local_ref
+        self.remote_ref_string = remote_ref_string
+        self._remote = remote
+        self._old_commit_sha = old_commit
+        self.summary = summary
+
+    @property
+    def old_commit(self) -> Union["Commit", None]:
+        return self._old_commit_sha and self._remote.repo.commit(self._old_commit_sha) or None
+
+    @property
+    def remote_ref(self) -> Union[RemoteReference, TagReference]:
+        """
+        :return:
+            Remote :class:`~git.refs.reference.Reference` or
+            :class:`~git.refs.tag.TagReference` in the local repository corresponding to
+            the :attr:`remote_ref_string` kept in this instance.
+        """
+        # Translate heads to a local remote. Tags stay as they are.
+        if self.remote_ref_string.startswith("refs/tags"):
+            return TagReference(self._remote.repo, self.remote_ref_string)
+        elif self.remote_ref_string.startswith("refs/heads"):
+            remote_ref = Reference(self._remote.repo, self.remote_ref_string)
+            return RemoteReference(
+                self._remote.repo,
+                "refs/remotes/%s/%s" % (str(self._remote), remote_ref.name),
+            )
+        else:
+            raise ValueError("Could not handle remote ref: %r" % self.remote_ref_string)
+        # END
+
+    @classmethod
+    def _from_line(cls, remote: "Remote", line: str) -> "PushInfo":
+        """Create a new :class:`PushInfo` instance as parsed from line which is expected
+        to be like refs/heads/master:refs/heads/master 05d2687..1d0568e as bytes."""
+        control_character, from_to, summary = line.split("\t", 3)
+        flags = 0
+
+        # Control character handling
+        try:
+            flags |= cls._flag_map[control_character]
+        except KeyError as e:
+            raise ValueError("Control character %r unknown as parsed from line %r" % (control_character, line)) from e
+        # END handle control character
+
+        # from_to handling
+        from_ref_string, to_ref_string = from_to.split(":")
+        if flags & cls.DELETED:
+            from_ref: Union[SymbolicReference, None] = None
+        else:
+            if from_ref_string == "(delete)":
+                from_ref = None
+            else:
+                from_ref = Reference.from_path(remote.repo, from_ref_string)
+
+        # Commit handling, could be message or commit info
+        old_commit: Optional[str] = None
+        if summary.startswith("["):
+            if "[rejected]" in summary:
+                flags |= cls.REJECTED
+            elif "[remote rejected]" in summary:
+                flags |= cls.REMOTE_REJECTED
+            elif "[remote failure]" in summary:
+                flags |= cls.REMOTE_FAILURE
+            elif "[no match]" in summary:
+                flags |= cls.ERROR
+            elif "[new tag]" in summary:
+                flags |= cls.NEW_TAG
+            elif "[new branch]" in summary:
+                flags |= cls.NEW_HEAD
+            # uptodate encoded in control character
+        else:
+            # Fast-forward or forced update - was encoded in control character,
+            # but we parse the old and new commit.
+            split_token = "..."
+            if control_character == " ":
+                split_token = ".."
+            old_sha, _new_sha = summary.split(" ")[0].split(split_token)
+            # Have to use constructor here as the sha usually is abbreviated.
+            old_commit = old_sha
+        # END message handling
+
+        return PushInfo(flags, from_ref, to_ref_string, remote, old_commit, summary)
+
+    @classmethod
+    def iter_items(cls, repo: "Repo", *args: Any, **kwargs: Any) -> NoReturn:  # -> Iterator['PushInfo']:
+        raise NotImplementedError
+
+
+class PushInfoList(IterableList[PushInfo]):
+    """:class:`~git.util.IterableList` of :class:`PushInfo` objects."""
+
+    def __new__(cls) -> "PushInfoList":
+        return cast(PushInfoList, IterableList.__new__(cls, "push_infos"))
+
+    def __init__(self) -> None:
+        super().__init__("push_infos")
+        self.error: Optional[Exception] = None
+
+    def raise_if_error(self) -> None:
+        """Raise an exception if any ref failed to push."""
+        if self.error:
+            raise self.error
+
+
+class FetchInfo(IterableObj):
+    """
+    Carries information about the results of a fetch operation of a single head::
+
+     info = remote.fetch()[0]
+     info.ref           # Symbolic Reference or RemoteReference to the changed
+                        # remote head or FETCH_HEAD
+     info.flags         # additional flags to be & with enumeration members,
+                        # i.e. info.flags & info.REJECTED
+                        # is 0 if ref is SymbolicReference
+     info.note          # additional notes given by git-fetch intended for the user
+     info.old_commit    # if info.flags & info.FORCED_UPDATE|info.FAST_FORWARD,
+                        # field is set to the previous location of ref, otherwise None
+     info.remote_ref_path # The path from which we fetched on the remote. It's the remote's version of our info.ref
+    """
+
+    __slots__ = ("ref", "old_commit", "flags", "note", "remote_ref_path")
+
+    _id_attribute_ = "fetchinfo"
+
+    (
+        NEW_TAG,
+        NEW_HEAD,
+        HEAD_UPTODATE,
+        TAG_UPDATE,
+        REJECTED,
+        FORCED_UPDATE,
+        FAST_FORWARD,
+        ERROR,
+    ) = [1 << x for x in range(8)]
+
+    _re_fetch_result = re.compile(r"^ *(.) (\[[\w \.$@]+\]|[\w\.$@]+) +(.+) -> ([^ ]+)(    \(.*\)?$)?")
+
+    _flag_map: Dict[flagKeyLiteral, int] = {
+        "!": ERROR,
+        "+": FORCED_UPDATE,
+        "*": 0,
+        "=": HEAD_UPTODATE,
+        " ": FAST_FORWARD,
+        "-": TAG_UPDATE,
+    }
+
+    @classmethod
+    def refresh(cls) -> Literal[True]:
+        """Update information about which :manpage:`git-fetch(1)` flags are supported
+        by the git executable being used.
+
+        Called by the :func:`git.refresh` function in the top level ``__init__``.
+        """
+        # Clear the old values in _flag_map.
+        with contextlib.suppress(KeyError):
+            del cls._flag_map["t"]
+        with contextlib.suppress(KeyError):
+            del cls._flag_map["-"]
+
+        # Set the value given the git version.
+        if Git().version_info[:2] >= (2, 10):
+            cls._flag_map["t"] = cls.TAG_UPDATE
+        else:
+            cls._flag_map["-"] = cls.TAG_UPDATE
+
+        return True
+
+    def __init__(
+        self,
+        ref: SymbolicReference,
+        flags: int,
+        note: str = "",
+        old_commit: Union[AnyGitObject, None] = None,
+        remote_ref_path: Optional[PathLike] = None,
+    ) -> None:
+        """Initialize a new instance."""
+        self.ref = ref
+        self.flags = flags
+        self.note = note
+        self.old_commit = old_commit
+        self.remote_ref_path = remote_ref_path
+
+    def __str__(self) -> str:
+        return self.name
+
+    @property
+    def name(self) -> str:
+        """:return: Name of our remote ref"""
+        return self.ref.name
+
+    @property
+    def commit(self) -> "Commit":
+        """:return: Commit of our remote ref"""
+        return self.ref.commit
+
+    @classmethod
+    def _from_line(cls, repo: "Repo", line: str, fetch_line: str) -> "FetchInfo":
+        """Parse information from the given line as returned by ``git-fetch -v`` and
+        return a new :class:`FetchInfo` object representing this information.
+
+        We can handle a line as follows::
+
+            %c %-*s %-*s -> %s%s
+
+        Where ``c`` is either a space, ``!``, ``+``, ``-``, ``*``, or ``=``:
+
+        - '!' means error
+        - '+' means success forcing update
+        - '-' means a tag was updated
+        - '*' means birth of new branch or tag
+        - '=' means the head was up to date (and not moved)
+        - ' ' means a fast-forward
+
+        `fetch_line` is the corresponding line from FETCH_HEAD, like::
+
+            acb0fa8b94ef421ad60c8507b634759a472cd56c    not-for-merge   branch '0.1.7RC' of /tmp/tmpya0vairemote_repo
+        """
+        match = cls._re_fetch_result.match(line)
+        if match is None:
+            raise ValueError("Failed to parse line: %r" % line)
+
+        # Parse lines.
+        remote_local_ref_str: str
+        (
+            control_character,
+            operation,
+            local_remote_ref,
+            remote_local_ref_str,
+            note,
+        ) = match.groups()
+        control_character = cast(flagKeyLiteral, control_character)
+        try:
+            _new_hex_sha, _fetch_operation, fetch_note = fetch_line.split("\t")
+            ref_type_name, fetch_note = fetch_note.split(" ", 1)
+        except ValueError as e:  # unpack error
+            raise ValueError("Failed to parse FETCH_HEAD line: %r" % fetch_line) from e
+
+        # Parse flags from control_character.
+        flags = 0
+        try:
+            flags |= cls._flag_map[control_character]
+        except KeyError as e:
+            raise ValueError("Control character %r unknown as parsed from line %r" % (control_character, line)) from e
+        # END control char exception handling
+
+        # Parse operation string for more info.
+        # This makes no sense for symbolic refs, but we parse it anyway.
+        old_commit: Union[AnyGitObject, None] = None
+        is_tag_operation = False
+        if "rejected" in operation:
+            flags |= cls.REJECTED
+        if "new tag" in operation:
+            flags |= cls.NEW_TAG
+            is_tag_operation = True
+        if "tag update" in operation:
+            flags |= cls.TAG_UPDATE
+            is_tag_operation = True
+        if "new branch" in operation:
+            flags |= cls.NEW_HEAD
+        if "..." in operation or ".." in operation:
+            split_token = "..."
+            if control_character == " ":
+                split_token = split_token[:-1]
+            old_commit = repo.rev_parse(operation.split(split_token)[0])
+        # END handle refspec
+
+        # Handle FETCH_HEAD and figure out ref type.
+        # If we do not specify a target branch like master:refs/remotes/origin/master,
+        # the fetch result is stored in FETCH_HEAD which destroys the rule we usually
+        # have. In that case we use a symbolic reference which is detached.
+        ref_type: Optional[Type[SymbolicReference]] = None
+        if remote_local_ref_str == "FETCH_HEAD":
+            ref_type = SymbolicReference
+        elif ref_type_name == "tag" or is_tag_operation:
+            # The ref_type_name can be branch, whereas we are still seeing a tag
+            # operation. It happens during testing, which is based on actual git
+            # operations.
+            ref_type = TagReference
+        elif ref_type_name in ("remote-tracking", "branch"):
+            # Note: remote-tracking is just the first part of the
+            # 'remote-tracking branch' token. We don't parse it correctly, but it's
+            # enough to know what to do, and it's new in git 1.7something.
+            ref_type = RemoteReference
+        elif "/" in ref_type_name:
+            # If the fetch spec look something like '+refs/pull/*:refs/heads/pull/*',
+            # and is thus pretty much anything the user wants, we will have trouble
+            # determining what's going on. For now, we assume the local ref is a Head.
+            ref_type = Head
+        else:
+            raise TypeError("Cannot handle reference type: %r" % ref_type_name)
+        # END handle ref type
+
+        # Create ref instance.
+        if ref_type is SymbolicReference:
+            remote_local_ref = ref_type(repo, "FETCH_HEAD")
+        else:
+            # Determine prefix. Tags are usually pulled into refs/tags; they may have
+            # subdirectories. It is not clear sometimes where exactly the item is,
+            # unless we have an absolute path as indicated by the 'ref/' prefix.
+            # Otherwise even a tag could be in refs/remotes, which is when it will have
+            # the 'tags/' subdirectory in its path. We don't want to test for actual
+            # existence, but try to figure everything out analytically.
+            ref_path: Optional[PathLike] = None
+            remote_local_ref_str = remote_local_ref_str.strip()
+
+            if remote_local_ref_str.startswith(Reference._common_path_default + "/"):
+                # Always use actual type if we get absolute paths. This will always be
+                # the case if something is fetched outside of refs/remotes (if its not a
+                # tag).
+                ref_path = remote_local_ref_str
+                if ref_type is not TagReference and not remote_local_ref_str.startswith(
+                    RemoteReference._common_path_default + "/"
+                ):
+                    ref_type = Reference
+                # END downgrade remote reference
+            elif ref_type is TagReference and "tags/" in remote_local_ref_str:
+                # Even though it's a tag, it is located in refs/remotes.
+                ref_path = join_path(RemoteReference._common_path_default, remote_local_ref_str)
+            else:
+                ref_path = join_path(ref_type._common_path_default, remote_local_ref_str)
+            # END obtain refpath
+
+            # Even though the path could be within the git conventions, we make sure we
+            # respect whatever the user wanted, and disabled path checking.
+            remote_local_ref = ref_type(repo, ref_path, check_path=False)
+        # END create ref instance
+
+        note = (note and note.strip()) or ""
+
+        return cls(remote_local_ref, flags, note, old_commit, local_remote_ref)
+
+    @classmethod
+    def iter_items(cls, repo: "Repo", *args: Any, **kwargs: Any) -> NoReturn:  # -> Iterator['FetchInfo']:
+        raise NotImplementedError
+
+
+class Remote(LazyMixin, IterableObj):
+    """Provides easy read and write access to a git remote.
+
+    Everything not part of this interface is considered an option for the current
+    remote, allowing constructs like ``remote.pushurl`` to query the pushurl.
+
+    :note:
+        When querying configuration, the configuration accessor will be cached to speed
+        up subsequent accesses.
+    """
+
+    __slots__ = ("repo", "name", "_config_reader")
+
+    _id_attribute_ = "name"
+
+    unsafe_git_fetch_options = [
+        # This option allows users to execute arbitrary commands.
+        # https://git-scm.com/docs/git-fetch#Documentation/git-fetch.txt---upload-packltupload-packgt
+        "--upload-pack",
+    ]
+    unsafe_git_pull_options = [
+        # This option allows users to execute arbitrary commands.
+        # https://git-scm.com/docs/git-pull#Documentation/git-pull.txt---upload-packltupload-packgt
+        "--upload-pack"
+    ]
+    unsafe_git_push_options = [
+        # This option allows users to execute arbitrary commands.
+        # https://git-scm.com/docs/git-push#Documentation/git-push.txt---execltgit-receive-packgt
+        "--receive-pack",
+        "--exec",
+    ]
+
+    url: str  # Obtained dynamically from _config_reader. See __getattr__ below.
+    """The URL configured for the remote."""
+
+    def __init__(self, repo: "Repo", name: str) -> None:
+        """Initialize a remote instance.
+
+        :param repo:
+            The repository we are a remote of.
+
+        :param name:
+            The name of the remote, e.g. ``origin``.
+        """
+        self.repo = repo
+        self.name = name
+
+    def __getattr__(self, attr: str) -> Any:
+        """Allows to call this instance like ``remote.special(*args, **kwargs)`` to
+        call ``git remote special self.name``."""
+        if attr == "_config_reader":
+            return super().__getattr__(attr)
+
+        # Sometimes, probably due to a bug in Python itself, we are being called even
+        # though a slot of the same name exists.
+        try:
+            return self._config_reader.get(attr)
+        except cp.NoOptionError:
+            return super().__getattr__(attr)
+        # END handle exception
+
+    def _config_section_name(self) -> str:
+        return 'remote "%s"' % self.name
+
+    def _set_cache_(self, attr: str) -> None:
+        if attr == "_config_reader":
+            # NOTE: This is cached as __getattr__ is overridden to return remote config
+            # values implicitly, such as in print(r.pushurl).
+            self._config_reader = SectionConstraint(
+                self.repo.config_reader("repository"),
+                self._config_section_name(),
+            )
+        else:
+            super()._set_cache_(attr)
+
+    def __str__(self) -> str:
+        return self.name
+
+    def __repr__(self) -> str:
+        return '<git.%s "%s">' % (self.__class__.__name__, self.name)
+
+    def __eq__(self, other: object) -> bool:
+        return isinstance(other, type(self)) and self.name == other.name
+
+    def __ne__(self, other: object) -> bool:
+        return not (self == other)
+
+    def __hash__(self) -> int:
+        return hash(self.name)
+
+    def exists(self) -> bool:
+        """
+        :return:
+            ``True`` if this is a valid, existing remote.
+            Valid remotes have an entry in the repository's configuration.
+        """
+        try:
+            self.config_reader.get("url")
+            return True
+        except cp.NoOptionError:
+            # We have the section at least...
+            return True
+        except cp.NoSectionError:
+            return False
+
+    @classmethod
+    def iter_items(cls, repo: "Repo", *args: Any, **kwargs: Any) -> Iterator["Remote"]:
+        """:return: Iterator yielding :class:`Remote` objects of the given repository"""
+        for section in repo.config_reader("repository").sections():
+            if not section.startswith("remote "):
+                continue
+            lbound = section.find('"')
+            rbound = section.rfind('"')
+            if lbound == -1 or rbound == -1:
+                raise ValueError("Remote-Section has invalid format: %r" % section)
+            yield Remote(repo, section[lbound + 1 : rbound])
+        # END for each configuration section
+
+    def set_url(
+        self, new_url: str, old_url: Optional[str] = None, allow_unsafe_protocols: bool = False, **kwargs: Any
+    ) -> "Remote":
+        """Configure URLs on current remote (cf. command ``git remote set-url``).
+
+        This command manages URLs on the remote.
+
+        :param new_url:
+            String being the URL to add as an extra remote URL.
+
+        :param old_url:
+            When set, replaces this URL with `new_url` for the remote.
+
+        :param allow_unsafe_protocols:
+            Allow unsafe protocols to be used, like ``ext``.
+
+        :return:
+            self
+        """
+        if not allow_unsafe_protocols:
+            Git.check_unsafe_protocols(new_url)
+        scmd = "set-url"
+        kwargs["insert_kwargs_after"] = scmd
+        if old_url:
+            self.repo.git.remote(scmd, "--", self.name, new_url, old_url, **kwargs)
+        else:
+            self.repo.git.remote(scmd, "--", self.name, new_url, **kwargs)
+        return self
+
+    def add_url(self, url: str, allow_unsafe_protocols: bool = False, **kwargs: Any) -> "Remote":
+        """Adds a new url on current remote (special case of ``git remote set-url``).
+
+        This command adds new URLs to a given remote, making it possible to have
+        multiple URLs for a single remote.
+
+        :param url:
+            String being the URL to add as an extra remote URL.
+
+        :param allow_unsafe_protocols:
+            Allow unsafe protocols to be used, like ``ext``.
+
+        :return:
+            self
+        """
+        return self.set_url(url, add=True, allow_unsafe_protocols=allow_unsafe_protocols)
+
+    def delete_url(self, url: str, **kwargs: Any) -> "Remote":
+        """Deletes a new url on current remote (special case of ``git remote set-url``).
+
+        This command deletes new URLs to a given remote, making it possible to have
+        multiple URLs for a single remote.
+
+        :param url:
+            String being the URL to delete from the remote.
+
+        :return:
+            self
+        """
+        return self.set_url(url, delete=True)
+
+    @property
+    def urls(self) -> Iterator[str]:
+        """:return: Iterator yielding all configured URL targets on a remote as strings"""
+        try:
+            remote_details = self.repo.git.remote("get-url", "--all", self.name)
+            assert isinstance(remote_details, str)
+            for line in remote_details.split("\n"):
+                yield line
+        except GitCommandError as ex:
+            ## We are on git < 2.7 (i.e TravisCI as of Oct-2016),
+            #  so `get-utl` command does not exist yet!
+            #    see: https://github.com/gitpython-developers/GitPython/pull/528#issuecomment-252976319
+            #    and: http://stackoverflow.com/a/32991784/548792
+            #
+            if "Unknown subcommand: get-url" in str(ex):
+                try:
+                    remote_details = self.repo.git.remote("show", self.name)
+                    assert isinstance(remote_details, str)
+                    for line in remote_details.split("\n"):
+                        if "  Push  URL:" in line:
+                            yield line.split(": ")[-1]
+                except GitCommandError as _ex:
+                    if any(msg in str(_ex) for msg in ["correct access rights", "cannot run ssh"]):
+                        # If ssh is not setup to access this repository, see issue 694.
+                        remote_details = self.repo.git.config("--get-all", "remote.%s.url" % self.name)
+                        assert isinstance(remote_details, str)
+                        for line in remote_details.split("\n"):
+                            yield line
+                    else:
+                        raise _ex
+            else:
+                raise ex
+
+    @property
+    def refs(self) -> IterableList[RemoteReference]:
+        """
+        :return:
+            :class:`~git.util.IterableList` of :class:`~git.refs.remote.RemoteReference`
+            objects.
+
+            It is prefixed, allowing you to omit the remote path portion, e.g.::
+
+                remote.refs.master  # yields RemoteReference('/refs/remotes/origin/master')
+        """
+        out_refs: IterableList[RemoteReference] = IterableList(RemoteReference._id_attribute_, "%s/" % self.name)
+        out_refs.extend(RemoteReference.list_items(self.repo, remote=self.name))
+        return out_refs
+
+    @property
+    def stale_refs(self) -> IterableList[Reference]:
+        """
+        :return:
+            :class:`~git.util.IterableList` of :class:`~git.refs.remote.RemoteReference`
+            objects that do not have a corresponding head in the remote reference
+            anymore as they have been deleted on the remote side, but are still
+            available locally.
+
+            The :class:`~git.util.IterableList` is prefixed, hence the 'origin' must be
+            omitted. See :attr:`refs` property for an example.
+
+            To make things more complicated, it can be possible for the list to include
+            other kinds of references, for example, tag references, if these are stale
+            as well. This is a fix for the issue described here:
+            https://github.com/gitpython-developers/GitPython/issues/260
+        """
+        out_refs: IterableList[Reference] = IterableList(RemoteReference._id_attribute_, "%s/" % self.name)
+        for line in self.repo.git.remote("prune", "--dry-run", self).splitlines()[2:]:
+            # expecting
+            # * [would prune] origin/new_branch
+            token = " * [would prune] "
+            if not line.startswith(token):
+                continue
+            ref_name = line.replace(token, "")
+            # Sometimes, paths start with a full ref name, like refs/tags/foo. See #260.
+            if ref_name.startswith(Reference._common_path_default + "/"):
+                out_refs.append(Reference.from_path(self.repo, ref_name))
+            else:
+                fqhn = "%s/%s" % (RemoteReference._common_path_default, ref_name)
+                out_refs.append(RemoteReference(self.repo, fqhn))
+            # END special case handling
+        # END for each line
+        return out_refs
+
+    @classmethod
+    def create(cls, repo: "Repo", name: str, url: str, allow_unsafe_protocols: bool = False, **kwargs: Any) -> "Remote":
+        """Create a new remote to the given repository.
+
+        :param repo:
+            Repository instance that is to receive the new remote.
+
+        :param name:
+            Desired name of the remote.
+
+        :param url:
+            URL which corresponds to the remote's name.
+
+        :param allow_unsafe_protocols:
+            Allow unsafe protocols to be used, like ``ext``.
+
+        :param kwargs:
+            Additional arguments to be passed to the ``git remote add`` command.
+
+        :return:
+            New :class:`Remote` instance
+
+        :raise git.exc.GitCommandError:
+            In case an origin with that name already exists.
+        """
+        scmd = "add"
+        kwargs["insert_kwargs_after"] = scmd
+        url = Git.polish_url(url)
+        if not allow_unsafe_protocols:
+            Git.check_unsafe_protocols(url)
+        repo.git.remote(scmd, "--", name, url, **kwargs)
+        return cls(repo, name)
+
+    # `add` is an alias.
+    @classmethod
+    def add(cls, repo: "Repo", name: str, url: str, **kwargs: Any) -> "Remote":
+        return cls.create(repo, name, url, **kwargs)
+
+    @classmethod
+    def remove(cls, repo: "Repo", name: str) -> str:
+        """Remove the remote with the given name.
+
+        :return:
+            The passed remote name to remove
+        """
+        repo.git.remote("rm", name)
+        if isinstance(name, cls):
+            name._clear_cache()
+        return name
+
+    # `rm` is an alias.
+    rm = remove
+
+    def rename(self, new_name: str) -> "Remote":
+        """Rename self to the given `new_name`.
+
+        :return:
+            self
+        """
+        if self.name == new_name:
+            return self
+
+        self.repo.git.remote("rename", self.name, new_name)
+        self.name = new_name
+        self._clear_cache()
+
+        return self
+
+    def update(self, **kwargs: Any) -> "Remote":
+        """Fetch all changes for this remote, including new branches which will be
+        forced in (in case your local remote branch is not part the new remote branch's
+        ancestry anymore).
+
+        :param kwargs:
+            Additional arguments passed to ``git remote update``.
+
+        :return:
+            self
+        """
+        scmd = "update"
+        kwargs["insert_kwargs_after"] = scmd
+        self.repo.git.remote(scmd, self.name, **kwargs)
+        return self
+
+    def _get_fetch_info_from_stderr(
+        self,
+        proc: "Git.AutoInterrupt",
+        progress: Union[Callable[..., Any], RemoteProgress, None],
+        kill_after_timeout: Union[None, float] = None,
+    ) -> IterableList["FetchInfo"]:
+        progress = to_progress_instance(progress)
+
+        # Skip first line as it is some remote info we are not interested in.
+        output: IterableList["FetchInfo"] = IterableList("name")
+
+        # Lines which are no progress are fetch info lines.
+        # This also waits for the command to finish.
+        # Skip some progress lines that don't provide relevant information.
+        fetch_info_lines = []
+        # Basically we want all fetch info lines which appear to be in regular form, and
+        # thus have a command character. Everything else we ignore.
+        cmds = set(FetchInfo._flag_map.keys())
+
+        progress_handler = progress.new_message_handler()
+        handle_process_output(
+            proc,
+            None,
+            progress_handler,
+            finalizer=None,
+            decode_streams=True,
+            kill_after_timeout=kill_after_timeout,
+        )
+
+        stderr_text = progress.error_lines and "\n".join(progress.error_lines) or ""
+        proc.wait(stderr=stderr_text)
+        if stderr_text:
+            _logger.warning("Error lines received while fetching: %s", stderr_text)
+
+        for line in progress.other_lines:
+            line = force_text(line)
+            for cmd in cmds:
+                if len(line) > 1 and line[0] == " " and line[1] == cmd:
+                    fetch_info_lines.append(line)
+                    continue
+
+        # Read head information.
+        fetch_head = SymbolicReference(self.repo, "FETCH_HEAD")
+        with open(fetch_head.abspath, "rb") as fp:
+            fetch_head_info = [line.decode(defenc) for line in fp.readlines()]
+
+        l_fil = len(fetch_info_lines)
+        l_fhi = len(fetch_head_info)
+        if l_fil != l_fhi:
+            msg = "Fetch head lines do not match lines provided via progress information\n"
+            msg += "length of progress lines %i should be equal to lines in FETCH_HEAD file %i\n"
+            msg += "Will ignore extra progress lines or fetch head lines."
+            msg %= (l_fil, l_fhi)
+            _logger.debug(msg)
+            _logger.debug(b"info lines: " + str(fetch_info_lines).encode("UTF-8"))
+            _logger.debug(b"head info: " + str(fetch_head_info).encode("UTF-8"))
+            if l_fil < l_fhi:
+                fetch_head_info = fetch_head_info[:l_fil]
+            else:
+                fetch_info_lines = fetch_info_lines[:l_fhi]
+            # END truncate correct list
+        # END sanity check + sanitization
+
+        for err_line, fetch_line in zip(fetch_info_lines, fetch_head_info):
+            try:
+                output.append(FetchInfo._from_line(self.repo, err_line, fetch_line))
+            except ValueError as exc:
+                _logger.debug("Caught error while parsing line: %s", exc)
+                _logger.warning("Git informed while fetching: %s", err_line.strip())
+        return output
+
+    def _get_push_info(
+        self,
+        proc: "Git.AutoInterrupt",
+        progress: Union[Callable[..., Any], RemoteProgress, None],
+        kill_after_timeout: Union[None, float] = None,
+    ) -> PushInfoList:
+        progress = to_progress_instance(progress)
+
+        # Read progress information from stderr.
+        # We hope stdout can hold all the data, it should...
+        # Read the lines manually as it will use carriage returns between the messages
+        # to override the previous one. This is why we read the bytes manually.
+        progress_handler = progress.new_message_handler()
+        output: PushInfoList = PushInfoList()
+
+        def stdout_handler(line: str) -> None:
+            try:
+                output.append(PushInfo._from_line(self, line))
+            except ValueError:
+                # If an error happens, additional info is given which we parse below.
+                pass
+
+        handle_process_output(
+            proc,
+            stdout_handler,
+            progress_handler,
+            finalizer=None,
+            decode_streams=False,
+            kill_after_timeout=kill_after_timeout,
+        )
+        stderr_text = progress.error_lines and "\n".join(progress.error_lines) or ""
+        try:
+            proc.wait(stderr=stderr_text)
+        except Exception as e:
+            # This is different than fetch (which fails if there is any stderr
+            # even if there is an output).
+            if not output:
+                raise
+            elif stderr_text:
+                _logger.warning("Error lines received while fetching: %s", stderr_text)
+                output.error = e
+
+        return output
+
+    def _assert_refspec(self) -> None:
+        """Turns out we can't deal with remotes if the refspec is missing."""
+        config = self.config_reader
+        unset = "placeholder"
+        try:
+            if config.get_value("fetch", default=unset) is unset:
+                msg = "Remote '%s' has no refspec set.\n"
+                msg += "You can set it as follows:"
+                msg += " 'git config --add \"remote.%s.fetch +refs/heads/*:refs/heads/*\"'."
+                raise AssertionError(msg % (self.name, self.name))
+        finally:
+            config.release()
+
+    def fetch(
+        self,
+        refspec: Union[str, List[str], None] = None,
+        progress: Union[RemoteProgress, None, "UpdateProgress"] = None,
+        verbose: bool = True,
+        kill_after_timeout: Union[None, float] = None,
+        allow_unsafe_protocols: bool = False,
+        allow_unsafe_options: bool = False,
+        **kwargs: Any,
+    ) -> IterableList[FetchInfo]:
+        """Fetch the latest changes for this remote.
+
+        :param refspec:
+            A "refspec" is used by fetch and push to describe the mapping
+            between remote ref and local ref. They are combined with a colon in
+            the format ``<src>:<dst>``, preceded by an optional plus sign, ``+``.
+            For example: ``git fetch $URL refs/heads/master:refs/heads/origin`` means
+            "grab the master branch head from the $URL and store it as my origin
+            branch head". And ``git push $URL refs/heads/master:refs/heads/to-upstream``
+            means "publish my master branch head as to-upstream branch at $URL".
+            See also :manpage:`git-push(1)`.
+
+            Taken from the git manual, :manpage:`gitglossary(7)`.
+
+            Fetch supports multiple refspecs (as the underlying :manpage:`git-fetch(1)`
+            does) - supplying a list rather than a string for 'refspec' will make use of
+            this facility.
+
+        :param progress:
+            See the :meth:`push` method.
+
+        :param verbose:
+            Boolean for verbose output.
+
+        :param kill_after_timeout:
+            To specify a timeout in seconds for the git command, after which the process
+            should be killed. It is set to ``None`` by default.
+
+        :param allow_unsafe_protocols:
+            Allow unsafe protocols to be used, like ``ext``.
+
+        :param allow_unsafe_options:
+            Allow unsafe options to be used, like ``--upload-pack``.
+
+        :param kwargs:
+            Additional arguments to be passed to :manpage:`git-fetch(1)`.
+
+        :return:
+            IterableList(FetchInfo, ...) list of :class:`FetchInfo` instances providing
+            detailed information about the fetch results
+
+        :note:
+            As fetch does not provide progress information to non-ttys, we cannot make
+            it available here unfortunately as in the :meth:`push` method.
+        """
+        if refspec is None:
+            # No argument refspec, then ensure the repo's config has a fetch refspec.
+            self._assert_refspec()
+
+        kwargs = add_progress(kwargs, self.repo.git, progress)
+        if isinstance(refspec, list):
+            args: Sequence[Optional[str]] = refspec
+        else:
+            args = [refspec]
+
+        if not allow_unsafe_protocols:
+            for ref in args:
+                if ref:
+                    Git.check_unsafe_protocols(ref)
+
+        if not allow_unsafe_options:
+            Git.check_unsafe_options(options=list(kwargs.keys()), unsafe_options=self.unsafe_git_fetch_options)
+
+        proc = self.repo.git.fetch(
+            "--", self, *args, as_process=True, with_stdout=False, universal_newlines=False, v=verbose, **kwargs
+        )
+        res = self._get_fetch_info_from_stderr(proc, progress, kill_after_timeout=kill_after_timeout)
+        if hasattr(self.repo.odb, "update_cache"):
+            self.repo.odb.update_cache()
+        return res
+
+    def pull(
+        self,
+        refspec: Union[str, List[str], None] = None,
+        progress: Union[RemoteProgress, "UpdateProgress", None] = None,
+        kill_after_timeout: Union[None, float] = None,
+        allow_unsafe_protocols: bool = False,
+        allow_unsafe_options: bool = False,
+        **kwargs: Any,
+    ) -> IterableList[FetchInfo]:
+        """Pull changes from the given branch, being the same as a fetch followed by a
+        merge of branch with your local branch.
+
+        :param refspec:
+            See :meth:`fetch` method.
+
+        :param progress:
+            See :meth:`push` method.
+
+        :param kill_after_timeout:
+            See :meth:`fetch` method.
+
+        :param allow_unsafe_protocols:
+            Allow unsafe protocols to be used, like ``ext``.
+
+        :param allow_unsafe_options:
+            Allow unsafe options to be used, like ``--upload-pack``.
+
+        :param kwargs:
+            Additional arguments to be passed to :manpage:`git-pull(1)`.
+
+        :return:
+            Please see :meth:`fetch` method.
+        """
+        if refspec is None:
+            # No argument refspec, then ensure the repo's config has a fetch refspec.
+            self._assert_refspec()
+        kwargs = add_progress(kwargs, self.repo.git, progress)
+
+        refspec = Git._unpack_args(refspec or [])
+        if not allow_unsafe_protocols:
+            for ref in refspec:
+                Git.check_unsafe_protocols(ref)
+
+        if not allow_unsafe_options:
+            Git.check_unsafe_options(options=list(kwargs.keys()), unsafe_options=self.unsafe_git_pull_options)
+
+        proc = self.repo.git.pull(
+            "--", self, refspec, with_stdout=False, as_process=True, universal_newlines=False, v=True, **kwargs
+        )
+        res = self._get_fetch_info_from_stderr(proc, progress, kill_after_timeout=kill_after_timeout)
+        if hasattr(self.repo.odb, "update_cache"):
+            self.repo.odb.update_cache()
+        return res
+
+    def push(
+        self,
+        refspec: Union[str, List[str], None] = None,
+        progress: Union[RemoteProgress, "UpdateProgress", Callable[..., RemoteProgress], None] = None,
+        kill_after_timeout: Union[None, float] = None,
+        allow_unsafe_protocols: bool = False,
+        allow_unsafe_options: bool = False,
+        **kwargs: Any,
+    ) -> PushInfoList:
+        """Push changes from source branch in refspec to target branch in refspec.
+
+        :param refspec:
+            See :meth:`fetch` method.
+
+        :param progress:
+            Can take one of many value types:
+
+            * ``None``, to discard progress information.
+            * A function (callable) that is called with the progress information.
+              Signature: ``progress(op_code, cur_count, max_count=None, message='')``.
+              See :meth:`RemoteProgress.update <git.util.RemoteProgress.update>` for a
+              description of all arguments given to the function.
+            * An instance of a class derived from :class:`~git.util.RemoteProgress` that
+              overrides the
+              :meth:`RemoteProgress.update <git.util.RemoteProgress.update>` method.
+
+        :note:
+            No further progress information is returned after push returns.
+
+        :param kill_after_timeout:
+            To specify a timeout in seconds for the git command, after which the process
+            should be killed. It is set to ``None`` by default.
+
+        :param allow_unsafe_protocols:
+            Allow unsafe protocols to be used, like ``ext``.
+
+        :param allow_unsafe_options:
+            Allow unsafe options to be used, like ``--receive-pack``.
+
+        :param kwargs:
+            Additional arguments to be passed to :manpage:`git-push(1)`.
+
+        :return:
+            A :class:`PushInfoList` object, where each list member represents an
+            individual head which had been updated on the remote side.
+
+            If the push contains rejected heads, these will have the
+            :const:`PushInfo.ERROR` bit set in their flags.
+
+            If the operation fails completely, the length of the returned
+            :class:`PushInfoList` will be 0.
+
+            Call :meth:`~PushInfoList.raise_if_error` on the returned object to raise on
+            any failure.
+        """
+        kwargs = add_progress(kwargs, self.repo.git, progress)
+
+        refspec = Git._unpack_args(refspec or [])
+        if not allow_unsafe_protocols:
+            for ref in refspec:
+                Git.check_unsafe_protocols(ref)
+
+        if not allow_unsafe_options:
+            Git.check_unsafe_options(options=list(kwargs.keys()), unsafe_options=self.unsafe_git_push_options)
+
+        proc = self.repo.git.push(
+            "--",
+            self,
+            refspec,
+            porcelain=True,
+            as_process=True,
+            universal_newlines=True,
+            kill_after_timeout=kill_after_timeout,
+            **kwargs,
+        )
+        return self._get_push_info(proc, progress, kill_after_timeout=kill_after_timeout)
+
+    @property
+    def config_reader(self) -> SectionConstraint[GitConfigParser]:
+        """
+        :return:
+            :class:`~git.config.GitConfigParser` compatible object able to read options
+            for only our remote. Hence you may simply type ``config.get("pushurl")`` to
+            obtain the information.
+        """
+        return self._config_reader
+
+    def _clear_cache(self) -> None:
+        try:
+            del self._config_reader
+        except AttributeError:
+            pass
+        # END handle exception
+
+    @property
+    def config_writer(self) -> SectionConstraint:
+        """
+        :return:
+            :class:`~git.config.GitConfigParser`-compatible object able to write options
+            for this remote.
+
+        :note:
+            You can only own one writer at a time - delete it to release the
+            configuration file and make it usable by others.
+
+            To assure consistent results, you should only query options through the
+            writer. Once you are done writing, you are free to use the config reader
+            once again.
+        """
+        writer = self.repo.config_writer()
+
+        # Clear our cache to ensure we re-read the possibly changed configuration.
+        self._clear_cache()
+        return SectionConstraint(writer, self._config_section_name())
diff --git a/llm/Lib/site-packages/git/repo/__init__.py b/llm/Lib/site-packages/git/repo/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..66319ef95f5c06956660127d6cb131fa99d3b780
--- /dev/null
+++ b/llm/Lib/site-packages/git/repo/__init__.py
@@ -0,0 +1,8 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""Initialize the repo package."""
+
+__all__ = ["Repo"]
+
+from .base import Repo
diff --git a/llm/Lib/site-packages/git/repo/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/git/repo/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..31c751adc189b5e62211b6a8d19bcf95d2819dfc
Binary files /dev/null and b/llm/Lib/site-packages/git/repo/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/repo/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/git/repo/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6f8525bbc9a8066e839b777e77435558240852f0
Binary files /dev/null and b/llm/Lib/site-packages/git/repo/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/repo/__pycache__/fun.cpython-311.pyc b/llm/Lib/site-packages/git/repo/__pycache__/fun.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..366399ad65b2fe2f4cc2c7e644a141be8a4ae22f
Binary files /dev/null and b/llm/Lib/site-packages/git/repo/__pycache__/fun.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/git/repo/base.py b/llm/Lib/site-packages/git/repo/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..51ea769011b99a365c4f3f1fdceccd832243fdb3
--- /dev/null
+++ b/llm/Lib/site-packages/git/repo/base.py
@@ -0,0 +1,1620 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+from __future__ import annotations
+
+__all__ = ["Repo"]
+
+import gc
+import logging
+import os
+import os.path as osp
+from pathlib import Path
+import re
+import shlex
+import sys
+import warnings
+
+import gitdb
+from gitdb.db.loose import LooseObjectDB
+from gitdb.exc import BadObject
+
+from git.cmd import Git, handle_process_output
+from git.compat import defenc, safe_decode
+from git.config import GitConfigParser
+from git.db import GitCmdObjectDB
+from git.exc import (
+    GitCommandError,
+    InvalidGitRepositoryError,
+    NoSuchPathError,
+)
+from git.index import IndexFile
+from git.objects import Submodule, RootModule, Commit
+from git.refs import HEAD, Head, Reference, TagReference
+from git.remote import Remote, add_progress, to_progress_instance
+from git.util import (
+    Actor,
+    cygpath,
+    expand_path,
+    finalize_process,
+    hex_to_bin,
+    remove_password_if_present,
+)
+
+from .fun import (
+    find_submodule_git_dir,
+    find_worktree_git_dir,
+    is_git_dir,
+    rev_parse,
+    touch,
+)
+
+# typing ------------------------------------------------------
+
+from git.types import (
+    CallableProgress,
+    Commit_ish,
+    Lit_config_levels,
+    PathLike,
+    TBD,
+    Tree_ish,
+    assert_never,
+)
+from typing import (
+    Any,
+    BinaryIO,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    NamedTuple,
+    Optional,
+    Sequence,
+    TYPE_CHECKING,
+    TextIO,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+
+from git.types import ConfigLevels_Tup, TypedDict
+
+if TYPE_CHECKING:
+    from git.objects import Tree
+    from git.objects.submodule.base import UpdateProgress
+    from git.refs.symbolic import SymbolicReference
+    from git.remote import RemoteProgress
+    from git.util import IterableList
+
+# -----------------------------------------------------------
+
+_logger = logging.getLogger(__name__)
+
+
+class BlameEntry(NamedTuple):
+    commit: Dict[str, Commit]
+    linenos: range
+    orig_path: Optional[str]
+    orig_linenos: range
+
+
+class Repo:
+    """Represents a git repository and allows you to query references, create commit
+    information, generate diffs, create and clone repositories, and query the log.
+
+    The following attributes are worth using:
+
+    * :attr:`working_dir` is the working directory of the git command, which is the
+      working tree directory if available or the ``.git`` directory in case of bare
+      repositories.
+
+    * :attr:`working_tree_dir` is the working tree directory, but will return ``None``
+      if we are a bare repository.
+
+    * :attr:`git_dir` is the ``.git`` repository directory, which is always set.
+    """
+
+    DAEMON_EXPORT_FILE = "git-daemon-export-ok"
+
+    # Must exist, or  __del__  will fail in case we raise on `__init__()`.
+    git = cast("Git", None)
+
+    working_dir: PathLike
+    """The working directory of the git command."""
+
+    _working_tree_dir: Optional[PathLike] = None
+
+    git_dir: PathLike
+    """The ``.git`` repository directory."""
+
+    _common_dir: PathLike = ""
+
+    # Precompiled regex
+    re_whitespace = re.compile(r"\s+")
+    re_hexsha_only = re.compile(r"^[0-9A-Fa-f]{40}$")
+    re_hexsha_shortened = re.compile(r"^[0-9A-Fa-f]{4,40}$")
+    re_envvars = re.compile(r"(\$(\{\s?)?[a-zA-Z_]\w*(\}\s?)?|%\s?[a-zA-Z_]\w*\s?%)")
+    re_author_committer_start = re.compile(r"^(author|committer)")
+    re_tab_full_line = re.compile(r"^\t(.*)$")
+
+    unsafe_git_clone_options = [
+        # Executes arbitrary commands:
+        "--upload-pack",
+        "-u",
+        # Can override configuration variables that execute arbitrary commands:
+        "--config",
+        "-c",
+    ]
+    """Options to :manpage:`git-clone(1)` that allow arbitrary commands to be executed.
+
+    The ``--upload-pack``/``-u`` option allows users to execute arbitrary commands
+    directly:
+    https://git-scm.com/docs/git-clone#Documentation/git-clone.txt---upload-packltupload-packgt
+
+    The ``--config``/``-c`` option allows users to override configuration variables like
+    ``protocol.allow`` and ``core.gitProxy`` to execute arbitrary commands:
+    https://git-scm.com/docs/git-clone#Documentation/git-clone.txt---configltkeygtltvaluegt
+    """
+
+    # Invariants
+    config_level: ConfigLevels_Tup = ("system", "user", "global", "repository")
+    """Represents the configuration level of a configuration file."""
+
+    # Subclass configuration
+    GitCommandWrapperType = Git
+    """Subclasses may easily bring in their own custom types by placing a constructor or
+    type here."""
+
+    def __init__(
+        self,
+        path: Optional[PathLike] = None,
+        odbt: Type[LooseObjectDB] = GitCmdObjectDB,
+        search_parent_directories: bool = False,
+        expand_vars: bool = True,
+    ) -> None:
+        R"""Create a new :class:`Repo` instance.
+
+        :param path:
+            The path to either the root git directory or the bare git repo::
+
+                repo = Repo("/Users/mtrier/Development/git-python")
+                repo = Repo("/Users/mtrier/Development/git-python.git")
+                repo = Repo("~/Development/git-python.git")
+                repo = Repo("$REPOSITORIES/Development/git-python.git")
+                repo = Repo(R"C:\Users\mtrier\Development\git-python\.git")
+
+            - In *Cygwin*, `path` may be a ``cygdrive/...`` prefixed path.
+            - If `path` is ``None`` or an empty string, :envvar:`GIT_DIR` is used. If
+              that environment variable is absent or empty, the current directory is
+              used.
+
+        :param odbt:
+            Object DataBase type - a type which is constructed by providing the
+            directory containing the database objects, i.e. ``.git/objects``. It will be
+            used to access all object data.
+
+        :param search_parent_directories:
+            If ``True``, all parent directories will be searched for a valid repo as
+            well.
+
+            Please note that this was the default behaviour in older versions of
+            GitPython, which is considered a bug though.
+
+        :raise git.exc.InvalidGitRepositoryError:
+
+        :raise git.exc.NoSuchPathError:
+
+        :return:
+            :class:`Repo`
+        """
+
+        epath = path or os.getenv("GIT_DIR")
+        if not epath:
+            epath = os.getcwd()
+        if Git.is_cygwin():
+            # Given how the tests are written, this seems more likely to catch Cygwin
+            # git used from Windows than Windows git used from Cygwin. Therefore
+            # changing to Cygwin-style paths is the relevant operation.
+            epath = cygpath(str(epath))
+
+        epath = epath or path or os.getcwd()
+        if not isinstance(epath, str):
+            epath = str(epath)
+        if expand_vars and re.search(self.re_envvars, epath):
+            warnings.warn(
+                "The use of environment variables in paths is deprecated"
+                + "\nfor security reasons and may be removed in the future!!",
+                stacklevel=1,
+            )
+        epath = expand_path(epath, expand_vars)
+        if epath is not None:
+            if not os.path.exists(epath):
+                raise NoSuchPathError(epath)
+
+        # Walk up the path to find the `.git` dir.
+        curpath = epath
+        git_dir = None
+        while curpath:
+            # ABOUT osp.NORMPATH
+            # It's important to normalize the paths, as submodules will otherwise
+            # initialize their repo instances with paths that depend on path-portions
+            # that will not exist after being removed. It's just cleaner.
+            if is_git_dir(curpath):
+                git_dir = curpath
+                # from man git-config : core.worktree
+                # Set the path to the root of the working tree. If GIT_COMMON_DIR
+                # environment variable is set, core.worktree is ignored and not used for
+                # determining the root of working tree. This can be overridden by the
+                # GIT_WORK_TREE environment variable. The value can be an absolute path
+                # or relative to the path to the .git directory, which is either
+                # specified by GIT_DIR, or automatically discovered. If GIT_DIR is
+                # specified but none of GIT_WORK_TREE and core.worktree is specified,
+                # the current working directory is regarded as the top level of your
+                # working tree.
+                self._working_tree_dir = os.path.dirname(git_dir)
+                if os.environ.get("GIT_COMMON_DIR") is None:
+                    gitconf = self._config_reader("repository", git_dir)
+                    if gitconf.has_option("core", "worktree"):
+                        self._working_tree_dir = gitconf.get("core", "worktree")
+                if "GIT_WORK_TREE" in os.environ:
+                    self._working_tree_dir = os.getenv("GIT_WORK_TREE")
+                break
+
+            dotgit = osp.join(curpath, ".git")
+            sm_gitpath = find_submodule_git_dir(dotgit)
+            if sm_gitpath is not None:
+                git_dir = osp.normpath(sm_gitpath)
+
+            sm_gitpath = find_submodule_git_dir(dotgit)
+            if sm_gitpath is None:
+                sm_gitpath = find_worktree_git_dir(dotgit)
+
+            if sm_gitpath is not None:
+                git_dir = expand_path(sm_gitpath, expand_vars)
+                self._working_tree_dir = curpath
+                break
+
+            if not search_parent_directories:
+                break
+            curpath, tail = osp.split(curpath)
+            if not tail:
+                break
+        # END while curpath
+
+        if git_dir is None:
+            raise InvalidGitRepositoryError(epath)
+        self.git_dir = git_dir
+
+        self._bare = False
+        try:
+            self._bare = self.config_reader("repository").getboolean("core", "bare")
+        except Exception:
+            # Let's not assume the option exists, although it should.
+            pass
+
+        try:
+            common_dir = (Path(self.git_dir) / "commondir").read_text().splitlines()[0].strip()
+            self._common_dir = osp.join(self.git_dir, common_dir)
+        except OSError:
+            self._common_dir = ""
+
+        # Adjust the working directory in case we are actually bare - we didn't know
+        # that in the first place.
+        if self._bare:
+            self._working_tree_dir = None
+        # END working dir handling
+
+        self.working_dir: PathLike = self._working_tree_dir or self.common_dir
+        self.git = self.GitCommandWrapperType(self.working_dir)
+
+        # Special handling, in special times.
+        rootpath = osp.join(self.common_dir, "objects")
+        if issubclass(odbt, GitCmdObjectDB):
+            self.odb = odbt(rootpath, self.git)
+        else:
+            self.odb = odbt(rootpath)
+
+    def __enter__(self) -> "Repo":
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        self.close()
+
+    def __del__(self) -> None:
+        try:
+            self.close()
+        except Exception:
+            pass
+
+    def close(self) -> None:
+        if self.git:
+            self.git.clear_cache()
+            # Tempfiles objects on Windows are holding references to open files until
+            # they are collected by the garbage collector, thus preventing deletion.
+            # TODO: Find these references and ensure they are closed and deleted
+            # synchronously rather than forcing a gc collection.
+            if sys.platform == "win32":
+                gc.collect()
+            gitdb.util.mman.collect()
+            if sys.platform == "win32":
+                gc.collect()
+
+    def __eq__(self, rhs: object) -> bool:
+        if isinstance(rhs, Repo):
+            return self.git_dir == rhs.git_dir
+        return False
+
+    def __ne__(self, rhs: object) -> bool:
+        return not self.__eq__(rhs)
+
+    def __hash__(self) -> int:
+        return hash(self.git_dir)
+
+    # Description property
+    def _get_description(self) -> str:
+        filename = osp.join(self.git_dir, "description")
+        with open(filename, "rb") as fp:
+            return fp.read().rstrip().decode(defenc)
+
+    def _set_description(self, descr: str) -> None:
+        filename = osp.join(self.git_dir, "description")
+        with open(filename, "wb") as fp:
+            fp.write((descr + "\n").encode(defenc))
+
+    description = property(_get_description, _set_description, doc="the project's description")
+    del _get_description
+    del _set_description
+
+    @property
+    def working_tree_dir(self) -> Optional[PathLike]:
+        """
+        :return:
+            The working tree directory of our git repository.
+            If this is a bare repository, ``None`` is returned.
+        """
+        return self._working_tree_dir
+
+    @property
+    def common_dir(self) -> PathLike:
+        """
+        :return:
+            The git dir that holds everything except possibly HEAD, FETCH_HEAD,
+            ORIG_HEAD, COMMIT_EDITMSG, index, and logs/.
+        """
+        return self._common_dir or self.git_dir
+
+    @property
+    def bare(self) -> bool:
+        """:return: ``True`` if the repository is bare"""
+        return self._bare
+
+    @property
+    def heads(self) -> "IterableList[Head]":
+        """A list of :class:`~git.refs.head.Head` objects representing the branch heads
+        in this repo.
+
+        :return:
+            ``git.IterableList(Head, ...)``
+        """
+        return Head.list_items(self)
+
+    @property
+    def references(self) -> "IterableList[Reference]":
+        """A list of :class:`~git.refs.reference.Reference` objects representing tags,
+        heads and remote references.
+
+        :return:
+            ``git.IterableList(Reference, ...)``
+        """
+        return Reference.list_items(self)
+
+    # Alias for references.
+    refs = references
+
+    # Alias for heads.
+    branches = heads
+
+    @property
+    def index(self) -> "IndexFile":
+        """
+        :return:
+            A :class:`~git.index.base.IndexFile` representing this repository's index.
+
+        :note:
+            This property can be expensive, as the returned
+            :class:`~git.index.base.IndexFile` will be reinitialized.
+            It is recommended to reuse the object.
+        """
+        return IndexFile(self)
+
+    @property
+    def head(self) -> "HEAD":
+        """
+        :return:
+            :class:`~git.refs.head.HEAD` object pointing to the current head reference
+        """
+        return HEAD(self, "HEAD")
+
+    @property
+    def remotes(self) -> "IterableList[Remote]":
+        """A list of :class:`~git.remote.Remote` objects allowing to access and
+        manipulate remotes.
+
+        :return:
+            ``git.IterableList(Remote, ...)``
+        """
+        return Remote.list_items(self)
+
+    def remote(self, name: str = "origin") -> "Remote":
+        """:return: The remote with the specified name
+
+        :raise ValueError:
+            If no remote with such a name exists.
+        """
+        r = Remote(self, name)
+        if not r.exists():
+            raise ValueError("Remote named '%s' didn't exist" % name)
+        return r
+
+    # { Submodules
+
+    @property
+    def submodules(self) -> "IterableList[Submodule]":
+        """
+        :return:
+            git.IterableList(Submodule, ...) of direct submodules available from the
+            current head
+        """
+        return Submodule.list_items(self)
+
+    def submodule(self, name: str) -> "Submodule":
+        """:return: The submodule with the given name
+
+        :raise ValueError:
+            If no such submodule exists.
+        """
+        try:
+            return self.submodules[name]
+        except IndexError as e:
+            raise ValueError("Didn't find submodule named %r" % name) from e
+        # END exception handling
+
+    def create_submodule(self, *args: Any, **kwargs: Any) -> Submodule:
+        """Create a new submodule.
+
+        :note:
+            For a description of the applicable parameters, see the documentation of
+            :meth:`Submodule.add <git.objects.submodule.base.Submodule.add>`.
+
+        :return:
+            The created submodule.
+        """
+        return Submodule.add(self, *args, **kwargs)
+
+    def iter_submodules(self, *args: Any, **kwargs: Any) -> Iterator[Submodule]:
+        """An iterator yielding Submodule instances.
+
+        See the `~git.objects.util.Traversable` interface for a description of `args`
+        and `kwargs`.
+
+        :return:
+            Iterator
+        """
+        return RootModule(self).traverse(*args, **kwargs)
+
+    def submodule_update(self, *args: Any, **kwargs: Any) -> Iterator[Submodule]:
+        """Update the submodules, keeping the repository consistent as it will
+        take the previous state into consideration.
+
+        :note:
+            For more information, please see the documentation of
+            :meth:`RootModule.update <git.objects.submodule.root.RootModule.update>`.
+        """
+        return RootModule(self).update(*args, **kwargs)
+
+    # }END submodules
+
+    @property
+    def tags(self) -> "IterableList[TagReference]":
+        """A list of :class:`~git.refs.tag.TagReference` objects that are available in
+        this repo.
+
+        :return:
+            ``git.IterableList(TagReference, ...)``
+        """
+        return TagReference.list_items(self)
+
+    def tag(self, path: PathLike) -> TagReference:
+        """
+        :return:
+            :class:`~git.refs.tag.TagReference` object, reference pointing to a
+            :class:`~git.objects.commit.Commit` or tag
+
+        :param path:
+            Path to the tag reference, e.g. ``0.1.5`` or ``tags/0.1.5``.
+        """
+        full_path = self._to_full_tag_path(path)
+        return TagReference(self, full_path)
+
+    @staticmethod
+    def _to_full_tag_path(path: PathLike) -> str:
+        path_str = str(path)
+        if path_str.startswith(TagReference._common_path_default + "/"):
+            return path_str
+        if path_str.startswith(TagReference._common_default + "/"):
+            return Reference._common_path_default + "/" + path_str
+        else:
+            return TagReference._common_path_default + "/" + path_str
+
+    def create_head(
+        self,
+        path: PathLike,
+        commit: Union["SymbolicReference", "str"] = "HEAD",
+        force: bool = False,
+        logmsg: Optional[str] = None,
+    ) -> "Head":
+        """Create a new head within the repository.
+
+        :note:
+            For more documentation, please see the
+            :meth:`Head.create <git.refs.head.Head.create>` method.
+
+        :return:
+            Newly created :class:`~git.refs.head.Head` Reference.
+        """
+        return Head.create(self, path, commit, logmsg, force)
+
+    def delete_head(self, *heads: "Union[str, Head]", **kwargs: Any) -> None:
+        """Delete the given heads.
+
+        :param kwargs:
+            Additional keyword arguments to be passed to :manpage:`git-branch(1)`.
+        """
+        return Head.delete(self, *heads, **kwargs)
+
+    def create_tag(
+        self,
+        path: PathLike,
+        ref: Union[str, "SymbolicReference"] = "HEAD",
+        message: Optional[str] = None,
+        force: bool = False,
+        **kwargs: Any,
+    ) -> TagReference:
+        """Create a new tag reference.
+
+        :note:
+            For more documentation, please see the
+            :meth:`TagReference.create <git.refs.tag.TagReference.create>` method.
+
+        :return:
+            :class:`~git.refs.tag.TagReference` object
+        """
+        return TagReference.create(self, path, ref, message, force, **kwargs)
+
+    def delete_tag(self, *tags: TagReference) -> None:
+        """Delete the given tag references."""
+        return TagReference.delete(self, *tags)
+
+    def create_remote(self, name: str, url: str, **kwargs: Any) -> Remote:
+        """Create a new remote.
+
+        For more information, please see the documentation of the
+        :meth:`Remote.create <git.remote.Remote.create>` method.
+
+        :return:
+            :class:`~git.remote.Remote` reference
+        """
+        return Remote.create(self, name, url, **kwargs)
+
+    def delete_remote(self, remote: "Remote") -> str:
+        """Delete the given remote."""
+        return Remote.remove(self, remote)
+
+    def _get_config_path(self, config_level: Lit_config_levels, git_dir: Optional[PathLike] = None) -> str:
+        if git_dir is None:
+            git_dir = self.git_dir
+        # We do not support an absolute path of the gitconfig on Windows.
+        # Use the global config instead.
+        if sys.platform == "win32" and config_level == "system":
+            config_level = "global"
+
+        if config_level == "system":
+            return "/etc/gitconfig"
+        elif config_level == "user":
+            config_home = os.environ.get("XDG_CONFIG_HOME") or osp.join(os.environ.get("HOME", "~"), ".config")
+            return osp.normpath(osp.expanduser(osp.join(config_home, "git", "config")))
+        elif config_level == "global":
+            return osp.normpath(osp.expanduser("~/.gitconfig"))
+        elif config_level == "repository":
+            repo_dir = self._common_dir or git_dir
+            if not repo_dir:
+                raise NotADirectoryError
+            else:
+                return osp.normpath(osp.join(repo_dir, "config"))
+        else:
+            assert_never(  # type: ignore[unreachable]
+                config_level,
+                ValueError(f"Invalid configuration level: {config_level!r}"),
+            )
+
+    def config_reader(
+        self,
+        config_level: Optional[Lit_config_levels] = None,
+    ) -> GitConfigParser:
+        """
+        :return:
+            :class:`~git.config.GitConfigParser` allowing to read the full git
+            configuration, but not to write it.
+
+            The configuration will include values from the system, user and repository
+            configuration files.
+
+        :param config_level:
+            For possible values, see the :meth:`config_writer` method. If ``None``, all
+            applicable levels will be used. Specify a level in case you know which file
+            you wish to read to prevent reading multiple files.
+
+        :note:
+            On Windows, system configuration cannot currently be read as the path is
+            unknown, instead the global path will be used.
+        """
+        return self._config_reader(config_level=config_level)
+
+    def _config_reader(
+        self,
+        config_level: Optional[Lit_config_levels] = None,
+        git_dir: Optional[PathLike] = None,
+    ) -> GitConfigParser:
+        if config_level is None:
+            files = [
+                self._get_config_path(cast(Lit_config_levels, f), git_dir)
+                for f in self.config_level
+                if cast(Lit_config_levels, f)
+            ]
+        else:
+            files = [self._get_config_path(config_level, git_dir)]
+        return GitConfigParser(files, read_only=True, repo=self)
+
+    def config_writer(self, config_level: Lit_config_levels = "repository") -> GitConfigParser:
+        """
+        :return:
+            A :class:`~git.config.GitConfigParser` allowing to write values of the
+            specified configuration file level. Config writers should be retrieved, used
+            to change the configuration, and written right away as they will lock the
+            configuration file in question and prevent other's to write it.
+
+        :param config_level:
+            One of the following values:
+
+            * ``"system"`` = system wide configuration file
+            * ``"global"`` = user level configuration file
+            * ``"`repository"`` = configuration file for this repository only
+        """
+        return GitConfigParser(self._get_config_path(config_level), read_only=False, repo=self, merge_includes=False)
+
+    def commit(self, rev: Union[str, Commit_ish, None] = None) -> Commit:
+        """The :class:`~git.objects.commit.Commit` object for the specified revision.
+
+        :param rev:
+            Revision specifier, see :manpage:`git-rev-parse(1)` for viable options.
+
+        :return:
+            :class:`~git.objects.commit.Commit`
+        """
+        if rev is None:
+            return self.head.commit
+        return self.rev_parse(str(rev) + "^0")
+
+    def iter_trees(self, *args: Any, **kwargs: Any) -> Iterator["Tree"]:
+        """:return: Iterator yielding :class:`~git.objects.tree.Tree` objects
+
+        :note:
+            Accepts all arguments known to the :meth:`iter_commits` method.
+        """
+        return (c.tree for c in self.iter_commits(*args, **kwargs))
+
+    def tree(self, rev: Union[Tree_ish, str, None] = None) -> "Tree":
+        """The :class:`~git.objects.tree.Tree` object for the given tree-ish revision.
+
+        Examples::
+
+              repo.tree(repo.heads[0])
+
+        :param rev:
+            A revision pointing to a Treeish (being a commit or tree).
+
+        :return:
+            :class:`~git.objects.tree.Tree`
+
+        :note:
+            If you need a non-root level tree, find it by iterating the root tree.
+            Otherwise it cannot know about its path relative to the repository root and
+            subsequent operations might have unexpected results.
+        """
+        if rev is None:
+            return self.head.commit.tree
+        return self.rev_parse(str(rev) + "^{tree}")
+
+    def iter_commits(
+        self,
+        rev: Union[str, Commit, "SymbolicReference", None] = None,
+        paths: Union[PathLike, Sequence[PathLike]] = "",
+        **kwargs: Any,
+    ) -> Iterator[Commit]:
+        """An iterator of :class:`~git.objects.commit.Commit` objects representing the
+        history of a given ref/commit.
+
+        :param rev:
+            Revision specifier, see :manpage:`git-rev-parse(1)` for viable options.
+            If ``None``, the active branch will be used.
+
+        :param paths:
+            An optional path or a list of paths. If set, only commits that include the
+            path or paths will be returned.
+
+        :param kwargs:
+            Arguments to be passed to :manpage:`git-rev-list(1)`.
+            Common ones are ``max_count`` and ``skip``.
+
+        :note:
+            To receive only commits between two named revisions, use the
+            ``"revA...revB"`` revision specifier.
+
+        :return:
+            Iterator of :class:`~git.objects.commit.Commit` objects
+        """
+        if rev is None:
+            rev = self.head.commit
+
+        return Commit.iter_items(self, rev, paths, **kwargs)
+
+    def merge_base(self, *rev: TBD, **kwargs: Any) -> List[Commit]:
+        R"""Find the closest common ancestor for the given revision
+        (:class:`~git.objects.commit.Commit`\s, :class:`~git.refs.tag.Tag`\s,
+        :class:`~git.refs.reference.Reference`\s, etc.).
+
+        :param rev:
+            At least two revs to find the common ancestor for.
+
+        :param kwargs:
+            Additional arguments to be passed to the ``repo.git.merge_base()`` command
+            which does all the work.
+
+        :return:
+            A list of :class:`~git.objects.commit.Commit` objects. If ``--all`` was
+            not passed as a keyword argument, the list will have at max one
+            :class:`~git.objects.commit.Commit`, or is empty if no common merge base
+            exists.
+
+        :raise ValueError:
+            If fewer than two revisions are provided.
+        """
+        if len(rev) < 2:
+            raise ValueError("Please specify at least two revs, got only %i" % len(rev))
+        # END handle input
+
+        res: List[Commit] = []
+        try:
+            lines: List[str] = self.git.merge_base(*rev, **kwargs).splitlines()
+        except GitCommandError as err:
+            if err.status == 128:
+                raise
+            # END handle invalid rev
+            # Status code 1 is returned if there is no merge-base.
+            # (See: https://github.com/git/git/blob/v2.44.0/builtin/merge-base.c#L19)
+            return res
+        # END exception handling
+
+        for line in lines:
+            res.append(self.commit(line))
+        # END for each merge-base
+
+        return res
+
+    def is_ancestor(self, ancestor_rev: Commit, rev: Commit) -> bool:
+        """Check if a commit is an ancestor of another.
+
+        :param ancestor_rev:
+            Rev which should be an ancestor.
+
+        :param rev:
+            Rev to test against `ancestor_rev`.
+
+        :return:
+            ``True`` if `ancestor_rev` is an ancestor to `rev`.
+        """
+        try:
+            self.git.merge_base(ancestor_rev, rev, is_ancestor=True)
+        except GitCommandError as err:
+            if err.status == 1:
+                return False
+            raise
+        return True
+
+    def is_valid_object(self, sha: str, object_type: Union[str, None] = None) -> bool:
+        try:
+            complete_sha = self.odb.partial_to_complete_sha_hex(sha)
+            object_info = self.odb.info(complete_sha)
+            if object_type:
+                if object_info.type == object_type.encode():
+                    return True
+                else:
+                    _logger.debug(
+                        "Commit hash points to an object of type '%s'. Requested were objects of type '%s'",
+                        object_info.type.decode(),
+                        object_type,
+                    )
+                    return False
+            else:
+                return True
+        except BadObject:
+            _logger.debug("Commit hash is invalid.")
+            return False
+
+    def _get_daemon_export(self) -> bool:
+        if self.git_dir:
+            filename = osp.join(self.git_dir, self.DAEMON_EXPORT_FILE)
+        return osp.exists(filename)
+
+    def _set_daemon_export(self, value: object) -> None:
+        if self.git_dir:
+            filename = osp.join(self.git_dir, self.DAEMON_EXPORT_FILE)
+        fileexists = osp.exists(filename)
+        if value and not fileexists:
+            touch(filename)
+        elif not value and fileexists:
+            os.unlink(filename)
+
+    daemon_export = property(
+        _get_daemon_export,
+        _set_daemon_export,
+        doc="If True, git-daemon may export this repository",
+    )
+    del _get_daemon_export
+    del _set_daemon_export
+
+    def _get_alternates(self) -> List[str]:
+        """The list of alternates for this repo from which objects can be retrieved.
+
+        :return:
+            List of strings being pathnames of alternates
+        """
+        if self.git_dir:
+            alternates_path = osp.join(self.git_dir, "objects", "info", "alternates")
+
+        if osp.exists(alternates_path):
+            with open(alternates_path, "rb") as f:
+                alts = f.read().decode(defenc)
+            return alts.strip().splitlines()
+        return []
+
+    def _set_alternates(self, alts: List[str]) -> None:
+        """Set the alternates.
+
+        :param alts:
+            The array of string paths representing the alternates at which git should
+            look for objects, i.e. ``/home/user/repo/.git/objects``.
+
+        :raise git.exc.NoSuchPathError:
+
+        :note:
+            The method does not check for the existence of the paths in `alts`, as the
+            caller is responsible.
+        """
+        alternates_path = osp.join(self.common_dir, "objects", "info", "alternates")
+        if not alts:
+            if osp.isfile(alternates_path):
+                os.remove(alternates_path)
+        else:
+            with open(alternates_path, "wb") as f:
+                f.write("\n".join(alts).encode(defenc))
+
+    alternates = property(
+        _get_alternates,
+        _set_alternates,
+        doc="Retrieve a list of alternates paths or set a list paths to be used as alternates",
+    )
+
+    def is_dirty(
+        self,
+        index: bool = True,
+        working_tree: bool = True,
+        untracked_files: bool = False,
+        submodules: bool = True,
+        path: Optional[PathLike] = None,
+    ) -> bool:
+        """
+        :return:
+            ``True`` if the repository is considered dirty. By default it will react
+            like a :manpage:`git-status(1)` without untracked files, hence it is dirty
+            if the index or the working copy have changes.
+        """
+        if self._bare:
+            # Bare repositories with no associated working directory are
+            # always considered to be clean.
+            return False
+
+        # Start from the one which is fastest to evaluate.
+        default_args = ["--abbrev=40", "--full-index", "--raw"]
+        if not submodules:
+            default_args.append("--ignore-submodules")
+        if path:
+            default_args.extend(["--", str(path)])
+        if index:
+            # diff index against HEAD.
+            if osp.isfile(self.index.path) and len(self.git.diff("--cached", *default_args)):
+                return True
+        # END index handling
+        if working_tree:
+            # diff index against working tree.
+            if len(self.git.diff(*default_args)):
+                return True
+        # END working tree handling
+        if untracked_files:
+            if len(self._get_untracked_files(path, ignore_submodules=not submodules)):
+                return True
+        # END untracked files
+        return False
+
+    @property
+    def untracked_files(self) -> List[str]:
+        """
+        :return:
+            list(str,...)
+
+            Files currently untracked as they have not been staged yet. Paths are
+            relative to the current working directory of the git command.
+
+        :note:
+            Ignored files will not appear here, i.e. files mentioned in ``.gitignore``.
+
+        :note:
+            This property is expensive, as no cache is involved. To process the result,
+            please consider caching it yourself.
+        """
+        return self._get_untracked_files()
+
+    def _get_untracked_files(self, *args: Any, **kwargs: Any) -> List[str]:
+        # Make sure we get all files, not only untracked directories.
+        proc = self.git.status(*args, porcelain=True, untracked_files=True, as_process=True, **kwargs)
+        # Untracked files prefix in porcelain mode
+        prefix = "?? "
+        untracked_files = []
+        for line in proc.stdout:
+            line = line.decode(defenc)
+            if not line.startswith(prefix):
+                continue
+            filename = line[len(prefix) :].rstrip("\n")
+            # Special characters are escaped
+            if filename[0] == filename[-1] == '"':
+                filename = filename[1:-1]
+                # WHATEVER ... it's a mess, but works for me
+                filename = filename.encode("ascii").decode("unicode_escape").encode("latin1").decode(defenc)
+            untracked_files.append(filename)
+        finalize_process(proc)
+        return untracked_files
+
+    def ignored(self, *paths: PathLike) -> List[str]:
+        """Checks if paths are ignored via ``.gitignore``.
+
+        This does so using the :manpage:`git-check-ignore(1)` method.
+
+        :param paths:
+            List of paths to check whether they are ignored or not.
+
+        :return:
+            Subset of those paths which are ignored
+        """
+        try:
+            proc: str = self.git.check_ignore(*paths)
+        except GitCommandError as err:
+            if err.status == 1:
+                # If return code is 1, this means none of the items in *paths are
+                # ignored by Git, so return an empty list.
+                return []
+            else:
+                # Raise the exception on all other return codes.
+                raise
+
+        return proc.replace("\\\\", "\\").replace('"', "").split("\n")
+
+    @property
+    def active_branch(self) -> Head:
+        """The name of the currently active branch.
+
+        :raise TypeError:
+            If HEAD is detached.
+
+        :return:
+            :class:`~git.refs.head.Head` to the active branch
+        """
+        # reveal_type(self.head.reference)  # => Reference
+        return self.head.reference
+
+    def blame_incremental(self, rev: str | HEAD | None, file: str, **kwargs: Any) -> Iterator["BlameEntry"]:
+        """Iterator for blame information for the given file at the given revision.
+
+        Unlike :meth:`blame`, this does not return the actual file's contents, only a
+        stream of :class:`BlameEntry` tuples.
+
+        :param rev:
+            Revision specifier. If ``None``, the blame will include all the latest
+            uncommitted changes. Otherwise, anything successfully parsed by
+            :manpage:`git-rev-parse(1)` is a valid option.
+
+        :return:
+            Lazy iterator of :class:`BlameEntry` tuples, where the commit indicates the
+            commit to blame for the line, and range indicates a span of line numbers in
+            the resulting file.
+
+        If you combine all line number ranges outputted by this command, you should get
+        a continuous range spanning all line numbers in the file.
+        """
+
+        data: bytes = self.git.blame(rev, "--", file, p=True, incremental=True, stdout_as_string=False, **kwargs)
+        commits: Dict[bytes, Commit] = {}
+
+        stream = (line for line in data.split(b"\n") if line)
+        while True:
+            try:
+                # When exhausted, causes a StopIteration, terminating this function.
+                line = next(stream)
+            except StopIteration:
+                return
+            split_line = line.split()
+            hexsha, orig_lineno_b, lineno_b, num_lines_b = split_line
+            lineno = int(lineno_b)
+            num_lines = int(num_lines_b)
+            orig_lineno = int(orig_lineno_b)
+            if hexsha not in commits:
+                # Now read the next few lines and build up a dict of properties for this
+                # commit.
+                props: Dict[bytes, bytes] = {}
+                while True:
+                    try:
+                        line = next(stream)
+                    except StopIteration:
+                        return
+                    if line == b"boundary":
+                        # "boundary" indicates a root commit and occurs instead of the
+                        # "previous" tag.
+                        continue
+
+                    tag, value = line.split(b" ", 1)
+                    props[tag] = value
+                    if tag == b"filename":
+                        # "filename" formally terminates the entry for --incremental.
+                        orig_filename = value
+                        break
+
+                c = Commit(
+                    self,
+                    hex_to_bin(hexsha),
+                    author=Actor(
+                        safe_decode(props[b"author"]),
+                        safe_decode(props[b"author-mail"].lstrip(b"<").rstrip(b">")),
+                    ),
+                    authored_date=int(props[b"author-time"]),
+                    committer=Actor(
+                        safe_decode(props[b"committer"]),
+                        safe_decode(props[b"committer-mail"].lstrip(b"<").rstrip(b">")),
+                    ),
+                    committed_date=int(props[b"committer-time"]),
+                )
+                commits[hexsha] = c
+            else:
+                # Discard all lines until we find "filename" which is guaranteed to be
+                # the last line.
+                while True:
+                    try:
+                        # Will fail if we reach the EOF unexpectedly.
+                        line = next(stream)
+                    except StopIteration:
+                        return
+                    tag, value = line.split(b" ", 1)
+                    if tag == b"filename":
+                        orig_filename = value
+                        break
+
+            yield BlameEntry(
+                commits[hexsha],
+                range(lineno, lineno + num_lines),
+                safe_decode(orig_filename),
+                range(orig_lineno, orig_lineno + num_lines),
+            )
+
+    def blame(
+        self,
+        rev: Union[str, HEAD, None],
+        file: str,
+        incremental: bool = False,
+        rev_opts: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[List[Commit | List[str | bytes] | None]] | Iterator[BlameEntry] | None:
+        """The blame information for the given file at the given revision.
+
+        :param rev:
+            Revision specifier. If ``None``, the blame will include all the latest
+            uncommitted changes. Otherwise, anything successfully parsed by
+            :manpage:`git-rev-parse(1)` is a valid option.
+
+        :return:
+            list: [git.Commit, list: [<line>]]
+
+            A list of lists associating a :class:`~git.objects.commit.Commit` object
+            with a list of lines that changed within the given commit. The
+            :class:`~git.objects.commit.Commit` objects will be given in order of
+            appearance.
+        """
+        if incremental:
+            return self.blame_incremental(rev, file, **kwargs)
+        rev_opts = rev_opts or []
+        data: bytes = self.git.blame(rev, *rev_opts, "--", file, p=True, stdout_as_string=False, **kwargs)
+        commits: Dict[str, Commit] = {}
+        blames: List[List[Commit | List[str | bytes] | None]] = []
+
+        class InfoTD(TypedDict, total=False):
+            sha: str
+            id: str
+            filename: str
+            summary: str
+            author: str
+            author_email: str
+            author_date: int
+            committer: str
+            committer_email: str
+            committer_date: int
+
+        info: InfoTD = {}
+
+        keepends = True
+        for line_bytes in data.splitlines(keepends):
+            try:
+                line_str = line_bytes.rstrip().decode(defenc)
+            except UnicodeDecodeError:
+                firstpart = ""
+                parts = []
+                is_binary = True
+            else:
+                # As we don't have an idea when the binary data ends, as it could
+                # contain multiple newlines in the process. So we rely on being able to
+                # decode to tell us what it is. This can absolutely fail even on text
+                # files, but even if it does, we should be fine treating it as binary
+                # instead.
+                parts = self.re_whitespace.split(line_str, 1)
+                firstpart = parts[0]
+                is_binary = False
+            # END handle decode of line
+
+            if self.re_hexsha_only.search(firstpart):
+                # handles
+                # 634396b2f541a9f2d58b00be1a07f0c358b999b3 1 1 7        - indicates blame-data start
+                # 634396b2f541a9f2d58b00be1a07f0c358b999b3 2 2          - indicates
+                # another line of blame with the same data
+                digits = parts[-1].split(" ")
+                if len(digits) == 3:
+                    info = {"id": firstpart}
+                    blames.append([None, []])
+                elif info["id"] != firstpart:
+                    info = {"id": firstpart}
+                    blames.append([commits.get(firstpart), []])
+                # END blame data initialization
+            else:
+                m = self.re_author_committer_start.search(firstpart)
+                if m:
+                    # handles:
+                    # author Tom Preston-Werner
+                    # author-mail <tom@mojombo.com>
+                    # author-time 1192271832
+                    # author-tz -0700
+                    # committer Tom Preston-Werner
+                    # committer-mail <tom@mojombo.com>
+                    # committer-time 1192271832
+                    # committer-tz -0700  - IGNORED BY US
+                    role = m.group(0)
+                    if role == "author":
+                        if firstpart.endswith("-mail"):
+                            info["author_email"] = parts[-1]
+                        elif firstpart.endswith("-time"):
+                            info["author_date"] = int(parts[-1])
+                        elif role == firstpart:
+                            info["author"] = parts[-1]
+                    elif role == "committer":
+                        if firstpart.endswith("-mail"):
+                            info["committer_email"] = parts[-1]
+                        elif firstpart.endswith("-time"):
+                            info["committer_date"] = int(parts[-1])
+                        elif role == firstpart:
+                            info["committer"] = parts[-1]
+                    # END distinguish mail,time,name
+                else:
+                    # handle
+                    # filename lib/grit.rb
+                    # summary add Blob
+                    # <and rest>
+                    if firstpart.startswith("filename"):
+                        info["filename"] = parts[-1]
+                    elif firstpart.startswith("summary"):
+                        info["summary"] = parts[-1]
+                    elif firstpart == "":
+                        if info:
+                            sha = info["id"]
+                            c = commits.get(sha)
+                            if c is None:
+                                c = Commit(
+                                    self,
+                                    hex_to_bin(sha),
+                                    author=Actor._from_string(f"{info['author']} {info['author_email']}"),
+                                    authored_date=info["author_date"],
+                                    committer=Actor._from_string(f"{info['committer']} {info['committer_email']}"),
+                                    committed_date=info["committer_date"],
+                                )
+                                commits[sha] = c
+                            blames[-1][0] = c
+                            # END if commit objects needs initial creation
+
+                            if blames[-1][1] is not None:
+                                line: str | bytes
+                                if not is_binary:
+                                    if line_str and line_str[0] == "\t":
+                                        line_str = line_str[1:]
+                                    line = line_str
+                                else:
+                                    line = line_bytes
+                                    # NOTE: We are actually parsing lines out of binary
+                                    # data, which can lead to the binary being split up
+                                    # along the newline separator. We will append this
+                                    # to the blame we are currently looking at, even
+                                    # though it should be concatenated with the last
+                                    # line we have seen.
+                                blames[-1][1].append(line)
+
+                            info = {"id": sha}
+                        # END if we collected commit info
+                    # END distinguish filename,summary,rest
+                # END distinguish author|committer vs filename,summary,rest
+            # END distinguish hexsha vs other information
+        return blames
+
+    @classmethod
+    def init(
+        cls,
+        path: Union[PathLike, None] = None,
+        mkdir: bool = True,
+        odbt: Type[GitCmdObjectDB] = GitCmdObjectDB,
+        expand_vars: bool = True,
+        **kwargs: Any,
+    ) -> "Repo":
+        """Initialize a git repository at the given path if specified.
+
+        :param path:
+            The full path to the repo (traditionally ends with ``/<name>.git``). Or
+            ``None``, in which case the repository will be created in the current
+            working directory.
+
+        :param mkdir:
+            If specified, will create the repository directory if it doesn't already
+            exist. Creates the directory with a mode=0755.
+            Only effective if a path is explicitly given.
+
+        :param odbt:
+            Object DataBase type - a type which is constructed by providing the
+            directory containing the database objects, i.e. ``.git/objects``. It will be
+            used to access all object data.
+
+        :param expand_vars:
+            If specified, environment variables will not be escaped. This can lead to
+            information disclosure, allowing attackers to access the contents of
+            environment variables.
+
+        :param kwargs:
+            Keyword arguments serving as additional options to the
+            :manpage:`git-init(1)` command.
+
+        :return:
+            :class:`Repo` (the newly created repo)
+        """
+        if path:
+            path = expand_path(path, expand_vars)
+        if mkdir and path and not osp.exists(path):
+            os.makedirs(path, 0o755)
+
+        # git command automatically chdir into the directory
+        git = cls.GitCommandWrapperType(path)
+        git.init(**kwargs)
+        return cls(path, odbt=odbt)
+
+    @classmethod
+    def _clone(
+        cls,
+        git: "Git",
+        url: PathLike,
+        path: PathLike,
+        odb_default_type: Type[GitCmdObjectDB],
+        progress: Union["RemoteProgress", "UpdateProgress", Callable[..., "RemoteProgress"], None] = None,
+        multi_options: Optional[List[str]] = None,
+        allow_unsafe_protocols: bool = False,
+        allow_unsafe_options: bool = False,
+        **kwargs: Any,
+    ) -> "Repo":
+        odbt = kwargs.pop("odbt", odb_default_type)
+
+        # When pathlib.Path or other class-based path is passed
+        if not isinstance(path, str):
+            path = str(path)
+
+        ## A bug win cygwin's Git, when `--bare` or `--separate-git-dir`
+        #  it prepends the cwd or(?) the `url` into the `path, so::
+        #        git clone --bare  /cygwin/d/foo.git  C:\\Work
+        #  becomes::
+        #        git clone --bare  /cygwin/d/foo.git  /cygwin/d/C:\\Work
+        #
+        clone_path = Git.polish_url(path) if Git.is_cygwin() and "bare" in kwargs else path
+        sep_dir = kwargs.get("separate_git_dir")
+        if sep_dir:
+            kwargs["separate_git_dir"] = Git.polish_url(sep_dir)
+        multi = None
+        if multi_options:
+            multi = shlex.split(" ".join(multi_options))
+
+        if not allow_unsafe_protocols:
+            Git.check_unsafe_protocols(str(url))
+        if not allow_unsafe_options:
+            Git.check_unsafe_options(options=list(kwargs.keys()), unsafe_options=cls.unsafe_git_clone_options)
+        if not allow_unsafe_options and multi_options:
+            Git.check_unsafe_options(options=multi_options, unsafe_options=cls.unsafe_git_clone_options)
+
+        proc = git.clone(
+            multi,
+            "--",
+            Git.polish_url(str(url)),
+            clone_path,
+            with_extended_output=True,
+            as_process=True,
+            v=True,
+            universal_newlines=True,
+            **add_progress(kwargs, git, progress),
+        )
+        if progress:
+            handle_process_output(
+                proc,
+                None,
+                to_progress_instance(progress).new_message_handler(),
+                finalize_process,
+                decode_streams=False,
+            )
+        else:
+            (stdout, stderr) = proc.communicate()
+            cmdline = getattr(proc, "args", "")
+            cmdline = remove_password_if_present(cmdline)
+
+            _logger.debug("Cmd(%s)'s unused stdout: %s", cmdline, stdout)
+            finalize_process(proc, stderr=stderr)
+
+        # Our git command could have a different working dir than our actual
+        # environment, hence we prepend its working dir if required.
+        if not osp.isabs(path):
+            path = osp.join(git._working_dir, path) if git._working_dir is not None else path
+
+        repo = cls(path, odbt=odbt)
+
+        # Retain env values that were passed to _clone().
+        repo.git.update_environment(**git.environment())
+
+        # Adjust remotes - there may be operating systems which use backslashes, These
+        # might be given as initial paths, but when handling the config file that
+        # contains the remote from which we were clones, git stops liking it as it will
+        # escape the backslashes. Hence we undo the escaping just to be sure.
+        if repo.remotes:
+            with repo.remotes[0].config_writer as writer:
+                writer.set_value("url", Git.polish_url(repo.remotes[0].url))
+        # END handle remote repo
+        return repo
+
+    def clone(
+        self,
+        path: PathLike,
+        progress: Optional[CallableProgress] = None,
+        multi_options: Optional[List[str]] = None,
+        allow_unsafe_protocols: bool = False,
+        allow_unsafe_options: bool = False,
+        **kwargs: Any,
+    ) -> "Repo":
+        """Create a clone from this repository.
+
+        :param path:
+            The full path of the new repo (traditionally ends with ``./<name>.git``).
+
+        :param progress:
+            See :meth:`Remote.push <git.remote.Remote.push>`.
+
+        :param multi_options:
+            A list of :manpage:`git-clone(1)` options that can be provided multiple
+            times.
+
+            One option per list item which is passed exactly as specified to clone.
+            For example::
+
+                [
+                    "--config core.filemode=false",
+                    "--config core.ignorecase",
+                    "--recurse-submodule=repo1_path",
+                    "--recurse-submodule=repo2_path",
+                ]
+
+        :param allow_unsafe_protocols:
+            Allow unsafe protocols to be used, like ``ext``.
+
+        :param allow_unsafe_options:
+            Allow unsafe options to be used, like ``--upload-pack``.
+
+        :param kwargs:
+            * ``odbt`` = ObjectDatabase Type, allowing to determine the object database
+              implementation used by the returned :class:`Repo` instance.
+            * All remaining keyword arguments are given to the :manpage:`git-clone(1)`
+              command.
+
+        :return:
+            :class:`Repo` (the newly cloned repo)
+        """
+        return self._clone(
+            self.git,
+            self.common_dir,
+            path,
+            type(self.odb),
+            progress,
+            multi_options,
+            allow_unsafe_protocols=allow_unsafe_protocols,
+            allow_unsafe_options=allow_unsafe_options,
+            **kwargs,
+        )
+
+    @classmethod
+    def clone_from(
+        cls,
+        url: PathLike,
+        to_path: PathLike,
+        progress: CallableProgress = None,
+        env: Optional[Mapping[str, str]] = None,
+        multi_options: Optional[List[str]] = None,
+        allow_unsafe_protocols: bool = False,
+        allow_unsafe_options: bool = False,
+        **kwargs: Any,
+    ) -> "Repo":
+        """Create a clone from the given URL.
+
+        :param url:
+            Valid git url, see: https://git-scm.com/docs/git-clone#URLS
+
+        :param to_path:
+            Path to which the repository should be cloned to.
+
+        :param progress:
+            See :meth:`Remote.push <git.remote.Remote.push>`.
+
+        :param env:
+            Optional dictionary containing the desired environment variables.
+
+            Note: Provided variables will be used to update the execution environment
+            for ``git``. If some variable is not specified in `env` and is defined in
+            :attr:`os.environ`, value from :attr:`os.environ` will be used. If you want
+            to unset some variable, consider providing empty string as its value.
+
+        :param multi_options:
+            See the :meth:`clone` method.
+
+        :param allow_unsafe_protocols:
+            Allow unsafe protocols to be used, like ``ext``.
+
+        :param allow_unsafe_options:
+            Allow unsafe options to be used, like ``--upload-pack``.
+
+        :param kwargs:
+            See the :meth:`clone` method.
+
+        :return:
+            :class:`Repo` instance pointing to the cloned directory.
+        """
+        git = cls.GitCommandWrapperType(os.getcwd())
+        if env is not None:
+            git.update_environment(**env)
+        return cls._clone(
+            git,
+            url,
+            to_path,
+            GitCmdObjectDB,
+            progress,
+            multi_options,
+            allow_unsafe_protocols=allow_unsafe_protocols,
+            allow_unsafe_options=allow_unsafe_options,
+            **kwargs,
+        )
+
+    def archive(
+        self,
+        ostream: Union[TextIO, BinaryIO],
+        treeish: Optional[str] = None,
+        prefix: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Repo:
+        """Archive the tree at the given revision.
+
+        :param ostream:
+            File-compatible stream object to which the archive will be written as bytes.
+
+        :param treeish:
+            The treeish name/id, defaults to active branch.
+
+        :param prefix:
+            The optional prefix to prepend to each filename in the archive.
+
+        :param kwargs:
+            Additional arguments passed to :manpage:`git-archive(1)`:
+
+            * Use the ``format`` argument to define the kind of format. Use specialized
+              ostreams to write any format supported by Python.
+            * You may specify the special ``path`` keyword, which may either be a
+              repository-relative path to a directory or file to place into the archive,
+              or a list or tuple of multiple paths.
+
+        :raise git.exc.GitCommandError:
+            If something went wrong.
+
+        :return:
+            self
+        """
+        if treeish is None:
+            treeish = self.head.commit
+        if prefix and "prefix" not in kwargs:
+            kwargs["prefix"] = prefix
+        kwargs["output_stream"] = ostream
+        path = kwargs.pop("path", [])
+        path = cast(Union[PathLike, List[PathLike], Tuple[PathLike, ...]], path)
+        if not isinstance(path, (tuple, list)):
+            path = [path]
+        # END ensure paths is list (or tuple)
+        self.git.archive("--", treeish, *path, **kwargs)
+        return self
+
+    def has_separate_working_tree(self) -> bool:
+        """
+        :return:
+            True if our :attr:`git_dir` is not at the root of our
+            :attr:`working_tree_dir`, but a ``.git`` file with a platform-agnostic
+            symbolic link. Our :attr:`git_dir` will be wherever the ``.git`` file points
+            to.
+
+        :note:
+            Bare repositories will always return ``False`` here.
+        """
+        if self.bare:
+            return False
+        if self.working_tree_dir:
+            return osp.isfile(osp.join(self.working_tree_dir, ".git"))
+        else:
+            return False  # Or raise Error?
+
+    rev_parse = rev_parse
+
+    def __repr__(self) -> str:
+        clazz = self.__class__
+        return "<%s.%s %r>" % (clazz.__module__, clazz.__name__, self.git_dir)
+
+    def currently_rebasing_on(self) -> Commit | None:
+        """
+        :return:
+            The commit which is currently being replayed while rebasing.
+
+            ``None`` if we are not currently rebasing.
+        """
+        if self.git_dir:
+            rebase_head_file = osp.join(self.git_dir, "REBASE_HEAD")
+        if not osp.isfile(rebase_head_file):
+            return None
+        with open(rebase_head_file, "rt") as f:
+            content = f.readline().strip()
+        return self.commit(content)
diff --git a/llm/Lib/site-packages/git/repo/fun.py b/llm/Lib/site-packages/git/repo/fun.py
new file mode 100644
index 0000000000000000000000000000000000000000..e44d9c64401de93aa3de98079ffac46d7a664e46
--- /dev/null
+++ b/llm/Lib/site-packages/git/repo/fun.py
@@ -0,0 +1,419 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+"""General repository-related functions."""
+
+from __future__ import annotations
+
+__all__ = [
+    "rev_parse",
+    "is_git_dir",
+    "touch",
+    "find_submodule_git_dir",
+    "name_to_object",
+    "short_to_long",
+    "deref_tag",
+    "to_commit",
+    "find_worktree_git_dir",
+]
+
+import os
+import os.path as osp
+from pathlib import Path
+import stat
+from string import digits
+
+from gitdb.exc import BadName, BadObject
+
+from git.cmd import Git
+from git.exc import WorkTreeRepositoryUnsupported
+from git.objects import Object
+from git.refs import SymbolicReference
+from git.util import cygpath, bin_to_hex, hex_to_bin
+
+# Typing ----------------------------------------------------------------------
+
+from typing import Optional, TYPE_CHECKING, Union, cast, overload
+
+from git.types import AnyGitObject, Literal, PathLike
+
+if TYPE_CHECKING:
+    from git.db import GitCmdObjectDB
+    from git.objects import Commit, TagObject
+    from git.refs.reference import Reference
+    from git.refs.tag import Tag
+
+    from .base import Repo
+
+# ----------------------------------------------------------------------------
+
+
+def touch(filename: str) -> str:
+    with open(filename, "ab"):
+        pass
+    return filename
+
+
+def is_git_dir(d: PathLike) -> bool:
+    """This is taken from the git setup.c:is_git_directory function.
+
+    :raise git.exc.WorkTreeRepositoryUnsupported:
+        If it sees a worktree directory. It's quite hacky to do that here, but at least
+        clearly indicates that we don't support it. There is the unlikely danger to
+        throw if we see directories which just look like a worktree dir, but are none.
+    """
+    if osp.isdir(d):
+        if (osp.isdir(osp.join(d, "objects")) or "GIT_OBJECT_DIRECTORY" in os.environ) and osp.isdir(
+            osp.join(d, "refs")
+        ):
+            headref = osp.join(d, "HEAD")
+            return osp.isfile(headref) or (osp.islink(headref) and os.readlink(headref).startswith("refs"))
+        elif (
+            osp.isfile(osp.join(d, "gitdir"))
+            and osp.isfile(osp.join(d, "commondir"))
+            and osp.isfile(osp.join(d, "gitfile"))
+        ):
+            raise WorkTreeRepositoryUnsupported(d)
+    return False
+
+
+def find_worktree_git_dir(dotgit: PathLike) -> Optional[str]:
+    """Search for a gitdir for this worktree."""
+    try:
+        statbuf = os.stat(dotgit)
+    except OSError:
+        return None
+    if not stat.S_ISREG(statbuf.st_mode):
+        return None
+
+    try:
+        lines = Path(dotgit).read_text().splitlines()
+        for key, value in [line.strip().split(": ") for line in lines]:
+            if key == "gitdir":
+                return value
+    except ValueError:
+        pass
+    return None
+
+
+def find_submodule_git_dir(d: PathLike) -> Optional[PathLike]:
+    """Search for a submodule repo."""
+    if is_git_dir(d):
+        return d
+
+    try:
+        with open(d) as fp:
+            content = fp.read().rstrip()
+    except IOError:
+        # It's probably not a file.
+        pass
+    else:
+        if content.startswith("gitdir: "):
+            path = content[8:]
+
+            if Git.is_cygwin():
+                # Cygwin creates submodules prefixed with `/cygdrive/...` suffixes.
+                # Cygwin git understands Cygwin paths much better than Windows ones.
+                # Also the Cygwin tests are assuming Cygwin paths.
+                path = cygpath(path)
+            if not osp.isabs(path):
+                path = osp.normpath(osp.join(osp.dirname(d), path))
+            return find_submodule_git_dir(path)
+    # END handle exception
+    return None
+
+
+def short_to_long(odb: "GitCmdObjectDB", hexsha: str) -> Optional[bytes]:
+    """
+    :return:
+        Long hexadecimal sha1 from the given less than 40 byte hexsha, or ``None`` if no
+        candidate could be found.
+
+    :param hexsha:
+        hexsha with less than 40 bytes.
+    """
+    try:
+        return bin_to_hex(odb.partial_to_complete_sha_hex(hexsha))
+    except BadObject:
+        return None
+    # END exception handling
+
+
+@overload
+def name_to_object(repo: "Repo", name: str, return_ref: Literal[False] = ...) -> AnyGitObject: ...
+
+
+@overload
+def name_to_object(repo: "Repo", name: str, return_ref: Literal[True]) -> Union[AnyGitObject, SymbolicReference]: ...
+
+
+def name_to_object(repo: "Repo", name: str, return_ref: bool = False) -> Union[AnyGitObject, SymbolicReference]:
+    """
+    :return:
+        Object specified by the given name - hexshas (short and long) as well as
+        references are supported.
+
+    :param return_ref:
+        If ``True``, and name specifies a reference, we will return the reference
+        instead of the object. Otherwise it will raise :exc:`~gitdb.exc.BadObject` or
+        :exc:`~gitdb.exc.BadName`.
+    """
+    hexsha: Union[None, str, bytes] = None
+
+    # Is it a hexsha? Try the most common ones, which is 7 to 40.
+    if repo.re_hexsha_shortened.match(name):
+        if len(name) != 40:
+            # Find long sha for short sha.
+            hexsha = short_to_long(repo.odb, name)
+        else:
+            hexsha = name
+        # END handle short shas
+    # END find sha if it matches
+
+    # If we couldn't find an object for what seemed to be a short hexsha, try to find it
+    # as reference anyway, it could be named 'aaa' for instance.
+    if hexsha is None:
+        for base in (
+            "%s",
+            "refs/%s",
+            "refs/tags/%s",
+            "refs/heads/%s",
+            "refs/remotes/%s",
+            "refs/remotes/%s/HEAD",
+        ):
+            try:
+                hexsha = SymbolicReference.dereference_recursive(repo, base % name)
+                if return_ref:
+                    return SymbolicReference(repo, base % name)
+                # END handle symbolic ref
+                break
+            except ValueError:
+                pass
+        # END for each base
+    # END handle hexsha
+
+    # Didn't find any ref, this is an error.
+    if return_ref:
+        raise BadObject("Couldn't find reference named %r" % name)
+    # END handle return ref
+
+    # Tried everything ? fail.
+    if hexsha is None:
+        raise BadName(name)
+    # END assert hexsha was found
+
+    return Object.new_from_sha(repo, hex_to_bin(hexsha))
+
+
+def deref_tag(tag: "Tag") -> AnyGitObject:
+    """Recursively dereference a tag and return the resulting object."""
+    while True:
+        try:
+            tag = tag.object
+        except AttributeError:
+            break
+    # END dereference tag
+    return tag
+
+
+def to_commit(obj: Object) -> "Commit":
+    """Convert the given object to a commit if possible and return it."""
+    if obj.type == "tag":
+        obj = deref_tag(obj)
+
+    if obj.type != "commit":
+        raise ValueError("Cannot convert object %r to type commit" % obj)
+    # END verify type
+    return obj
+
+
+def rev_parse(repo: "Repo", rev: str) -> AnyGitObject:
+    """Parse a revision string. Like :manpage:`git-rev-parse(1)`.
+
+    :return:
+        `~git.objects.base.Object` at the given revision.
+
+        This may be any type of git object:
+
+        * :class:`Commit <git.objects.commit.Commit>`
+        * :class:`TagObject <git.objects.tag.TagObject>`
+        * :class:`Tree <git.objects.tree.Tree>`
+        * :class:`Blob <git.objects.blob.Blob>`
+
+    :param rev:
+        :manpage:`git-rev-parse(1)`-compatible revision specification as string.
+        Please see :manpage:`git-rev-parse(1)` for details.
+
+    :raise gitdb.exc.BadObject:
+        If the given revision could not be found.
+
+    :raise ValueError:
+        If `rev` couldn't be parsed.
+
+    :raise IndexError:
+        If an invalid reflog index is specified.
+    """
+    # Are we in colon search mode?
+    if rev.startswith(":/"):
+        # Colon search mode
+        raise NotImplementedError("commit by message search (regex)")
+    # END handle search
+
+    obj: Optional[AnyGitObject] = None
+    ref = None
+    output_type = "commit"
+    start = 0
+    parsed_to = 0
+    lr = len(rev)
+    while start < lr:
+        if rev[start] not in "^~:@":
+            start += 1
+            continue
+        # END handle start
+
+        token = rev[start]
+
+        if obj is None:
+            # token is a rev name.
+            if start == 0:
+                ref = repo.head.ref
+            else:
+                if token == "@":
+                    ref = cast("Reference", name_to_object(repo, rev[:start], return_ref=True))
+                else:
+                    obj = name_to_object(repo, rev[:start])
+                # END handle token
+            # END handle refname
+        else:
+            if ref is not None:
+                obj = cast("Commit", ref.commit)
+            # END handle ref
+        # END initialize obj on first token
+
+        start += 1
+
+        # Try to parse {type}.
+        if start < lr and rev[start] == "{":
+            end = rev.find("}", start)
+            if end == -1:
+                raise ValueError("Missing closing brace to define type in %s" % rev)
+            output_type = rev[start + 1 : end]  # Exclude brace.
+
+            # Handle type.
+            if output_type == "commit":
+                pass  # Default.
+            elif output_type == "tree":
+                try:
+                    obj = cast(AnyGitObject, obj)
+                    obj = to_commit(obj).tree
+                except (AttributeError, ValueError):
+                    pass  # Error raised later.
+                # END exception handling
+            elif output_type in ("", "blob"):
+                obj = cast("TagObject", obj)
+                if obj and obj.type == "tag":
+                    obj = deref_tag(obj)
+                else:
+                    # Cannot do anything for non-tags.
+                    pass
+                # END handle tag
+            elif token == "@":
+                # try single int
+                assert ref is not None, "Require Reference to access reflog"
+                revlog_index = None
+                try:
+                    # Transform reversed index into the format of our revlog.
+                    revlog_index = -(int(output_type) + 1)
+                except ValueError as e:
+                    # TODO: Try to parse the other date options, using parse_date maybe.
+                    raise NotImplementedError("Support for additional @{...} modes not implemented") from e
+                # END handle revlog index
+
+                try:
+                    entry = ref.log_entry(revlog_index)
+                except IndexError as e:
+                    raise IndexError("Invalid revlog index: %i" % revlog_index) from e
+                # END handle index out of bound
+
+                obj = Object.new_from_sha(repo, hex_to_bin(entry.newhexsha))
+
+                # Make it pass the following checks.
+                output_type = ""
+            else:
+                raise ValueError("Invalid output type: %s ( in %s )" % (output_type, rev))
+            # END handle output type
+
+            # Empty output types don't require any specific type, its just about
+            # dereferencing tags.
+            if output_type and obj and obj.type != output_type:
+                raise ValueError("Could not accommodate requested object type %r, got %s" % (output_type, obj.type))
+            # END verify output type
+
+            start = end + 1  # Skip brace.
+            parsed_to = start
+            continue
+        # END parse type
+
+        # Try to parse a number.
+        num = 0
+        if token != ":":
+            found_digit = False
+            while start < lr:
+                if rev[start] in digits:
+                    num = num * 10 + int(rev[start])
+                    start += 1
+                    found_digit = True
+                else:
+                    break
+                # END handle number
+            # END number parse loop
+
+            # No explicit number given, 1 is the default. It could be 0 though.
+            if not found_digit:
+                num = 1
+            # END set default num
+        # END number parsing only if non-blob mode
+
+        parsed_to = start
+        # Handle hierarchy walk.
+        try:
+            obj = cast(AnyGitObject, obj)
+            if token == "~":
+                obj = to_commit(obj)
+                for _ in range(num):
+                    obj = obj.parents[0]
+                # END for each history item to walk
+            elif token == "^":
+                obj = to_commit(obj)
+                # Must be n'th parent.
+                if num:
+                    obj = obj.parents[num - 1]
+            elif token == ":":
+                if obj.type != "tree":
+                    obj = obj.tree
+                # END get tree type
+                obj = obj[rev[start:]]
+                parsed_to = lr
+            else:
+                raise ValueError("Invalid token: %r" % token)
+            # END end handle tag
+        except (IndexError, AttributeError) as e:
+            raise BadName(
+                f"Invalid revision spec '{rev}' - not enough " f"parent commits to reach '{token}{int(num)}'"
+            ) from e
+        # END exception handling
+    # END parse loop
+
+    # Still no obj? It's probably a simple name.
+    if obj is None:
+        obj = name_to_object(repo, rev)
+        parsed_to = lr
+    # END handle simple name
+
+    if obj is None:
+        raise ValueError("Revision specifier could not be parsed: %s" % rev)
+
+    if parsed_to != lr:
+        raise ValueError("Didn't consume complete rev spec %s, consumed part: %s" % (rev, rev[:parsed_to]))
+
+    return obj
diff --git a/llm/Lib/site-packages/git/types.py b/llm/Lib/site-packages/git/types.py
new file mode 100644
index 0000000000000000000000000000000000000000..5844501468e09e7e2513752850d360a053cf2b33
--- /dev/null
+++ b/llm/Lib/site-packages/git/types.py
@@ -0,0 +1,284 @@
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+import os
+import sys
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    List,
+    NoReturn,
+    Optional,
+    Sequence as Sequence,
+    Tuple,
+    TYPE_CHECKING,
+    Type,
+    TypeVar,
+    Union,
+)
+import warnings
+
+if sys.version_info >= (3, 8):
+    from typing import (
+        Literal,
+        Protocol,
+        SupportsIndex as SupportsIndex,
+        TypedDict,
+        runtime_checkable,
+    )
+else:
+    from typing_extensions import (
+        Literal,
+        Protocol,
+        SupportsIndex as SupportsIndex,
+        TypedDict,
+        runtime_checkable,
+    )
+
+if TYPE_CHECKING:
+    from git.objects import Commit, Tree, TagObject, Blob
+    from git.repo import Repo
+
+PathLike = Union[str, "os.PathLike[str]"]
+"""A :class:`str` (Unicode) based file or directory path."""
+
+TBD = Any
+"""Alias of :class:`~typing.Any`, when a type hint is meant to become more specific."""
+
+_T = TypeVar("_T")
+"""Type variable used internally in GitPython."""
+
+AnyGitObject = Union["Commit", "Tree", "TagObject", "Blob"]
+"""Union of the :class:`~git.objects.base.Object`-based types that represent actual git
+object types.
+
+As noted in :class:`~git.objects.base.Object`, which has further details, these are:
+
+* :class:`Blob <git.objects.blob.Blob>`
+* :class:`Tree <git.objects.tree.Tree>`
+* :class:`Commit <git.objects.commit.Commit>`
+* :class:`TagObject <git.objects.tag.TagObject>`
+
+Those GitPython classes represent the four git object types, per
+:manpage:`gitglossary(7)`:
+
+* "blob": https://git-scm.com/docs/gitglossary#def_blob_object
+* "tree object": https://git-scm.com/docs/gitglossary#def_tree_object
+* "commit object": https://git-scm.com/docs/gitglossary#def_commit_object
+* "tag object": https://git-scm.com/docs/gitglossary#def_tag_object
+
+For more general information on git objects and their types as git understands them:
+
+* "object": https://git-scm.com/docs/gitglossary#def_object
+* "object type": https://git-scm.com/docs/gitglossary#def_object_type
+
+:note:
+    See also the :class:`Tree_ish` and :class:`Commit_ish` unions.
+"""
+
+Tree_ish = Union["Commit", "Tree", "TagObject"]
+"""Union of :class:`~git.objects.base.Object`-based types that are typically tree-ish.
+
+See :manpage:`gitglossary(7)` on "tree-ish":
+https://git-scm.com/docs/gitglossary#def_tree-ish
+
+:note:
+    :class:`~git.objects.tree.Tree` and :class:`~git.objects.commit.Commit` are the
+    classes whose instances are all tree-ish. This union includes them, but also
+    :class:`~git.objects.tag.TagObject`, only **most** of whose instances are tree-ish.
+    Whether a particular :class:`~git.objects.tag.TagObject` peels (recursively
+    dereferences) to a tree or commit, rather than a blob, can in general only be known
+    at runtime. In practice, git tag objects are nearly always used for tagging commits,
+    and such tags are tree-ish because commits are tree-ish.
+
+:note:
+    See also the :class:`AnyGitObject` union of all four classes corresponding to git
+    object types.
+"""
+
+Commit_ish = Union["Commit", "TagObject"]
+"""Union of :class:`~git.objects.base.Object`-based types that are typically commit-ish.
+
+See :manpage:`gitglossary(7)` on "commit-ish":
+https://git-scm.com/docs/gitglossary#def_commit-ish
+
+:note:
+    :class:`~git.objects.commit.Commit` is the only class whose instances are all
+    commit-ish. This union type includes :class:`~git.objects.commit.Commit`, but also
+    :class:`~git.objects.tag.TagObject`, only **most** of whose instances are
+    commit-ish. Whether a particular :class:`~git.objects.tag.TagObject` peels
+    (recursively dereferences) to a commit, rather than a tree or blob, can in general
+    only be known at runtime. In practice, git tag objects are nearly always used for
+    tagging commits, and such tags are of course commit-ish.
+
+:note:
+    See also the :class:`AnyGitObject` union of all four classes corresponding to git
+    object types.
+"""
+
+GitObjectTypeString = Literal["commit", "tag", "blob", "tree"]
+"""Literal strings identifying git object types and the
+:class:`~git.objects.base.Object`-based types that represent them.
+
+See the :attr:`Object.type <git.objects.base.Object.type>` attribute. These are its
+values in :class:`~git.objects.base.Object` subclasses that represent git objects. These
+literals therefore correspond to the types in the :class:`AnyGitObject` union.
+
+These are the same strings git itself uses to identify its four object types.
+See :manpage:`gitglossary(7)` on "object type":
+https://git-scm.com/docs/gitglossary#def_object_type
+"""
+
+Lit_commit_ish: Type[Literal["commit", "tag"]]
+"""Deprecated. Type of literal strings identifying typically-commitish git object types.
+
+Prior to a bugfix, this type had been defined more broadly. Any usage is in practice
+ambiguous and likely to be incorrect. This type has therefore been made a static type
+error to appear in annotations. It is preserved, with a deprecated status, to avoid
+introducing runtime errors in code that refers to it, but it should not be used.
+
+Instead of this type:
+
+* For the type of the string literals associated with :class:`Commit_ish`, use
+  ``Literal["commit", "tag"]`` or create a new type alias for it. That is equivalent to
+  this type as currently defined (but usable in statically checked type annotations).
+
+* For the type of all four string literals associated with :class:`AnyGitObject`, use
+  :class:`GitObjectTypeString`. That is equivalent to the old definition of this type
+  prior to the bugfix (and is also usable in statically checked type annotations).
+"""
+
+
+def _getattr(name: str) -> Any:
+    if name != "Lit_commit_ish":
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+    warnings.warn(
+        "Lit_commit_ish is deprecated. It is currently defined as "
+        '`Literal["commit", "tag"]`, which should be used in its place if desired. It '
+        'had previously been defined as `Literal["commit", "tag", "blob", "tree"]`, '
+        "covering all four git object type strings including those that are never "
+        "commit-ish. For that, use the GitObjectTypeString type instead.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return Literal["commit", "tag"]
+
+
+if not TYPE_CHECKING:  # Preserve static checking for undefined/misspelled attributes.
+    __getattr__ = _getattr
+
+
+def __dir__() -> List[str]:
+    return [*globals(), "Lit_commit_ish"]
+
+
+# Config_levels ---------------------------------------------------------
+
+Lit_config_levels = Literal["system", "global", "user", "repository"]
+"""Type of literal strings naming git configuration levels.
+
+These strings relate to which file a git configuration variable is in.
+"""
+
+ConfigLevels_Tup = Tuple[Literal["system"], Literal["user"], Literal["global"], Literal["repository"]]
+"""Static type of a tuple of the four strings representing configuration levels."""
+
+# Progress parameter type alias -----------------------------------------
+
+CallableProgress = Optional[Callable[[int, Union[str, float], Union[str, float, None], str], None]]
+"""General type of a function or other callable used as a progress reporter for cloning.
+
+This is the type of a function or other callable that reports the progress of a clone,
+when passed as a ``progress`` argument to :meth:`Repo.clone <git.repo.base.Repo.clone>`
+or :meth:`Repo.clone_from <git.repo.base.Repo.clone_from>`.
+
+:note:
+    Those :meth:`~git.repo.base.Repo.clone` and :meth:`~git.repo.base.Repo.clone_from`
+    methods also accept :meth:`~git.util.RemoteProgress` instances, including instances
+    of its :meth:`~git.util.CallableRemoteProgress` subclass.
+
+:note:
+    Unlike objects that match this type, :meth:`~git.util.RemoteProgress` instances are
+    not directly callable, not even when they are instances of
+    :meth:`~git.util.CallableRemoteProgress`, which wraps a callable and forwards
+    information to it but is not itself callable.
+
+:note:
+    This type also allows ``None``, for cloning without reporting progress.
+"""
+
+# -----------------------------------------------------------------------------------
+
+
+def assert_never(inp: NoReturn, raise_error: bool = True, exc: Union[Exception, None] = None) -> None:
+    """For use in exhaustive checking of a literal or enum in if/else chains.
+
+    A call to this function should only be reached if not all members are handled, or if
+    an attempt is made to pass non-members through the chain.
+
+    :param inp:
+        If all members are handled, the argument for `inp` will have the
+        :class:`~typing.Never`/:class:`~typing.NoReturn` type.
+        Otherwise, the type will mismatch and cause a mypy error.
+
+    :param raise_error:
+        If ``True``, will also raise :exc:`ValueError` with a general
+        "unhandled literal" message, or the exception object passed as `exc`.
+
+    :param exc:
+        It not ``None``, this should be an already-constructed exception object, to be
+        raised if `raise_error` is ``True``.
+    """
+    if raise_error:
+        if exc is None:
+            raise ValueError(f"An unhandled literal ({inp!r}) in an if/else chain was found")
+        else:
+            raise exc
+
+
+class Files_TD(TypedDict):
+    """Dictionary with stat counts for the diff of a particular file.
+
+    For the :class:`~git.util.Stats.files` attribute of :class:`~git.util.Stats`
+    objects.
+    """
+
+    insertions: int
+    deletions: int
+    lines: int
+
+
+class Total_TD(TypedDict):
+    """Dictionary with total stats from any number of files.
+
+    For the :class:`~git.util.Stats.total` attribute of :class:`~git.util.Stats`
+    objects.
+    """
+
+    insertions: int
+    deletions: int
+    lines: int
+    files: int
+
+
+class HSH_TD(TypedDict):
+    """Dictionary carrying the same information as a :class:`~git.util.Stats` object."""
+
+    total: Total_TD
+    files: Dict[PathLike, Files_TD]
+
+
+@runtime_checkable
+class Has_Repo(Protocol):
+    """Protocol for having a :attr:`repo` attribute, the repository to operate on."""
+
+    repo: "Repo"
+
+
+@runtime_checkable
+class Has_id_attribute(Protocol):
+    """Protocol for having :attr:`_id_attribute_` used in iteration and traversal."""
+
+    _id_attribute_: str
diff --git a/llm/Lib/site-packages/git/util.py b/llm/Lib/site-packages/git/util.py
new file mode 100644
index 0000000000000000000000000000000000000000..8c1c26012e2e8a19f265480a9011a46e26d010dd
--- /dev/null
+++ b/llm/Lib/site-packages/git/util.py
@@ -0,0 +1,1344 @@
+# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
+#
+# This module is part of GitPython and is released under the
+# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/
+
+import sys
+
+__all__ = [
+    "stream_copy",
+    "join_path",
+    "to_native_path_linux",
+    "join_path_native",
+    "Stats",
+    "IndexFileSHA1Writer",
+    "IterableObj",
+    "IterableList",
+    "BlockingLockFile",
+    "LockFile",
+    "Actor",
+    "get_user_id",
+    "assure_directory_exists",
+    "RemoteProgress",
+    "CallableRemoteProgress",
+    "rmtree",
+    "unbare_repo",
+    "HIDE_WINDOWS_KNOWN_ERRORS",
+]
+
+if sys.platform == "win32":
+    __all__.append("to_native_path_windows")
+
+from abc import abstractmethod
+import contextlib
+from functools import wraps
+import getpass
+import logging
+import os
+import os.path as osp
+import pathlib
+import platform
+import re
+import shutil
+import stat
+import subprocess
+import time
+from urllib.parse import urlsplit, urlunsplit
+import warnings
+
+# NOTE: Unused imports can be improved now that CI testing has fully resumed. Some of
+# these be used indirectly through other GitPython modules, which avoids having to write
+# gitdb all the time in their imports. They are not in __all__, at least currently,
+# because they could be removed or changed at any time, and so should not be considered
+# conceptually public to code outside GitPython. Linters of course do not like it.
+from gitdb.util import (
+    LazyMixin,  # noqa: F401
+    LockedFD,  # noqa: F401
+    bin_to_hex,  # noqa: F401
+    file_contents_ro,  # noqa: F401
+    file_contents_ro_filepath,  # noqa: F401
+    hex_to_bin,  # noqa: F401
+    make_sha,
+    to_bin_sha,  # noqa: F401
+    to_hex_sha,  # noqa: F401
+)
+
+# typing ---------------------------------------------------------
+
+from typing import (
+    Any,
+    AnyStr,
+    BinaryIO,
+    Callable,
+    Dict,
+    Generator,
+    IO,
+    Iterator,
+    List,
+    Optional,
+    Pattern,
+    Sequence,
+    Tuple,
+    TYPE_CHECKING,
+    TypeVar,
+    Union,
+    cast,
+    overload,
+)
+
+if TYPE_CHECKING:
+    from git.cmd import Git
+    from git.config import GitConfigParser, SectionConstraint
+    from git.remote import Remote
+    from git.repo.base import Repo
+
+from git.types import (
+    Files_TD,
+    Has_id_attribute,
+    HSH_TD,
+    Literal,
+    PathLike,
+    Protocol,
+    SupportsIndex,
+    Total_TD,
+    runtime_checkable,
+)
+
+# ---------------------------------------------------------------------
+
+T_IterableObj = TypeVar("T_IterableObj", bound=Union["IterableObj", "Has_id_attribute"], covariant=True)
+# So IterableList[Head] is subtype of IterableList[IterableObj].
+
+_logger = logging.getLogger(__name__)
+
+
+def _read_env_flag(name: str, default: bool) -> bool:
+    """Read a boolean flag from an environment variable.
+
+    :return:
+        The flag, or the `default` value if absent or ambiguous.
+    """
+    try:
+        value = os.environ[name]
+    except KeyError:
+        return default
+
+    _logger.warning(
+        "The %s environment variable is deprecated. Its effect has never been documented and changes without warning.",
+        name,
+    )
+
+    adjusted_value = value.strip().lower()
+
+    if adjusted_value in {"", "0", "false", "no"}:
+        return False
+    if adjusted_value in {"1", "true", "yes"}:
+        return True
+    _logger.warning("%s has unrecognized value %r, treating as %r.", name, value, default)
+    return default
+
+
+def _read_win_env_flag(name: str, default: bool) -> bool:
+    """Read a boolean flag from an environment variable on Windows.
+
+    :return:
+        On Windows, the flag, or the `default` value if absent or ambiguous.
+        On all other operating systems, ``False``.
+
+    :note:
+        This only accesses the environment on Windows.
+    """
+    return sys.platform == "win32" and _read_env_flag(name, default)
+
+
+#: We need an easy way to see if Appveyor TCs start failing,
+#: so the errors marked with this var are considered "acknowledged" ones, awaiting remedy,
+#: till then, we wish to hide them.
+HIDE_WINDOWS_KNOWN_ERRORS = _read_win_env_flag("HIDE_WINDOWS_KNOWN_ERRORS", True)
+HIDE_WINDOWS_FREEZE_ERRORS = _read_win_env_flag("HIDE_WINDOWS_FREEZE_ERRORS", True)
+
+# { Utility Methods
+
+T = TypeVar("T")
+
+
+def unbare_repo(func: Callable[..., T]) -> Callable[..., T]:
+    """Methods with this decorator raise :exc:`~git.exc.InvalidGitRepositoryError` if
+    they encounter a bare repository."""
+
+    from .exc import InvalidGitRepositoryError
+
+    @wraps(func)
+    def wrapper(self: "Remote", *args: Any, **kwargs: Any) -> T:
+        if self.repo.bare:
+            raise InvalidGitRepositoryError("Method '%s' cannot operate on bare repositories" % func.__name__)
+        # END bare method
+        return func(self, *args, **kwargs)
+
+    # END wrapper
+
+    return wrapper
+
+
+@contextlib.contextmanager
+def cwd(new_dir: PathLike) -> Generator[PathLike, None, None]:
+    """Context manager to temporarily change directory.
+
+    This is similar to :func:`contextlib.chdir` introduced in Python 3.11, but the
+    context manager object returned by a single call to this function is not reentrant.
+    """
+    old_dir = os.getcwd()
+    os.chdir(new_dir)
+    try:
+        yield new_dir
+    finally:
+        os.chdir(old_dir)
+
+
+@contextlib.contextmanager
+def patch_env(name: str, value: str) -> Generator[None, None, None]:
+    """Context manager to temporarily patch an environment variable."""
+    old_value = os.getenv(name)
+    os.environ[name] = value
+    try:
+        yield
+    finally:
+        if old_value is None:
+            del os.environ[name]
+        else:
+            os.environ[name] = old_value
+
+
+def rmtree(path: PathLike) -> None:
+    """Remove the given directory tree recursively.
+
+    :note:
+        We use :func:`shutil.rmtree` but adjust its behaviour to see whether files that
+        couldn't be deleted are read-only. Windows will not remove them in that case.
+    """
+
+    def handler(function: Callable, path: PathLike, _excinfo: Any) -> None:
+        """Callback for :func:`shutil.rmtree`.
+
+        This works as either a ``onexc`` or ``onerror`` style callback.
+        """
+        # Is the error an access error?
+        os.chmod(path, stat.S_IWUSR)
+
+        try:
+            function(path)
+        except PermissionError as ex:
+            if HIDE_WINDOWS_KNOWN_ERRORS:
+                from unittest import SkipTest
+
+                raise SkipTest(f"FIXME: fails with: PermissionError\n  {ex}") from ex
+            raise
+
+    if sys.platform != "win32":
+        shutil.rmtree(path)
+    elif sys.version_info >= (3, 12):
+        shutil.rmtree(path, onexc=handler)
+    else:
+        shutil.rmtree(path, onerror=handler)
+
+
+def rmfile(path: PathLike) -> None:
+    """Ensure file deleted also on *Windows* where read-only files need special
+    treatment."""
+    if osp.isfile(path):
+        if sys.platform == "win32":
+            os.chmod(path, 0o777)
+        os.remove(path)
+
+
+def stream_copy(source: BinaryIO, destination: BinaryIO, chunk_size: int = 512 * 1024) -> int:
+    """Copy all data from the `source` stream into the `destination` stream in chunks
+    of size `chunk_size`.
+
+    :return:
+        Number of bytes written
+    """
+    br = 0
+    while True:
+        chunk = source.read(chunk_size)
+        destination.write(chunk)
+        br += len(chunk)
+        if len(chunk) < chunk_size:
+            break
+    # END reading output stream
+    return br
+
+
+def join_path(a: PathLike, *p: PathLike) -> PathLike:
+    R"""Join path tokens together similar to osp.join, but always use ``/`` instead of
+    possibly ``\`` on Windows."""
+    path = str(a)
+    for b in p:
+        b = str(b)
+        if not b:
+            continue
+        if b.startswith("/"):
+            path += b[1:]
+        elif path == "" or path.endswith("/"):
+            path += b
+        else:
+            path += "/" + b
+    # END for each path token to add
+    return path
+
+
+if sys.platform == "win32":
+
+    def to_native_path_windows(path: PathLike) -> PathLike:
+        path = str(path)
+        return path.replace("/", "\\")
+
+    def to_native_path_linux(path: PathLike) -> str:
+        path = str(path)
+        return path.replace("\\", "/")
+
+    to_native_path = to_native_path_windows
+else:
+    # No need for any work on Linux.
+    def to_native_path_linux(path: PathLike) -> str:
+        return str(path)
+
+    to_native_path = to_native_path_linux
+
+
+def join_path_native(a: PathLike, *p: PathLike) -> PathLike:
+    R"""Like :func:`join_path`, but makes sure an OS native path is returned.
+
+    This is only needed to play it safe on Windows and to ensure nice paths that only
+    use ``\``.
+    """
+    return to_native_path(join_path(a, *p))
+
+
+def assure_directory_exists(path: PathLike, is_file: bool = False) -> bool:
+    """Make sure that the directory pointed to by path exists.
+
+    :param is_file:
+        If ``True``, `path` is assumed to be a file and handled correctly.
+        Otherwise it must be a directory.
+
+    :return:
+        ``True`` if the directory was created, ``False`` if it already existed.
+    """
+    if is_file:
+        path = osp.dirname(path)
+    # END handle file
+    if not osp.isdir(path):
+        os.makedirs(path, exist_ok=True)
+        return True
+    return False
+
+
+def _get_exe_extensions() -> Sequence[str]:
+    PATHEXT = os.environ.get("PATHEXT", None)
+    if PATHEXT:
+        return tuple(p.upper() for p in PATHEXT.split(os.pathsep))
+    elif sys.platform == "win32":
+        return (".BAT", "COM", ".EXE")
+    else:
+        return ()
+
+
+def py_where(program: str, path: Optional[PathLike] = None) -> List[str]:
+    """Perform a path search to assist :func:`is_cygwin_git`.
+
+    This is not robust for general use. It is an implementation detail of
+    :func:`is_cygwin_git`. When a search following all shell rules is needed,
+    :func:`shutil.which` can be used instead.
+
+    :note:
+        Neither this function nor :func:`shutil.which` will predict the effect of an
+        executable search on a native Windows system due to a :class:`subprocess.Popen`
+        call without ``shell=True``, because shell and non-shell executable search on
+        Windows differ considerably.
+    """
+    # From: http://stackoverflow.com/a/377028/548792
+    winprog_exts = _get_exe_extensions()
+
+    def is_exec(fpath: str) -> bool:
+        return (
+            osp.isfile(fpath)
+            and os.access(fpath, os.X_OK)
+            and (
+                sys.platform != "win32" or not winprog_exts or any(fpath.upper().endswith(ext) for ext in winprog_exts)
+            )
+        )
+
+    progs = []
+    if not path:
+        path = os.environ["PATH"]
+    for folder in str(path).split(os.pathsep):
+        folder = folder.strip('"')
+        if folder:
+            exe_path = osp.join(folder, program)
+            for f in [exe_path] + ["%s%s" % (exe_path, e) for e in winprog_exts]:
+                if is_exec(f):
+                    progs.append(f)
+    return progs
+
+
+def _cygexpath(drive: Optional[str], path: str) -> str:
+    if osp.isabs(path) and not drive:
+        # Invoked from `cygpath()` directly with `D:Apps\123`?
+        #  It's an error, leave it alone just slashes)
+        p = path  # convert to str if AnyPath given
+    else:
+        p = path and osp.normpath(osp.expandvars(osp.expanduser(path)))
+        if osp.isabs(p):
+            if drive:
+                # Confusing, maybe a remote system should expand vars.
+                p = path
+            else:
+                p = cygpath(p)
+        elif drive:
+            p = "/proc/cygdrive/%s/%s" % (drive.lower(), p)
+    p_str = str(p)  # ensure it is a str and not AnyPath
+    return p_str.replace("\\", "/")
+
+
+_cygpath_parsers: Tuple[Tuple[Pattern[str], Callable, bool], ...] = (
+    # See: https://msdn.microsoft.com/en-us/library/windows/desktop/aa365247(v=vs.85).aspx
+    # and: https://www.cygwin.com/cygwin-ug-net/using.html#unc-paths
+    (
+        re.compile(r"\\\\\?\\UNC\\([^\\]+)\\([^\\]+)(?:\\(.*))?"),
+        (lambda server, share, rest_path: "//%s/%s/%s" % (server, share, rest_path.replace("\\", "/"))),
+        False,
+    ),
+    (re.compile(r"\\\\\?\\(\w):[/\\](.*)"), (_cygexpath), False),
+    (re.compile(r"(\w):[/\\](.*)"), (_cygexpath), False),
+    (re.compile(r"file:(.*)", re.I), (lambda rest_path: rest_path), True),
+    (re.compile(r"(\w{2,}:.*)"), (lambda url: url), False),  # remote URL, do nothing
+)
+
+
+def cygpath(path: str) -> str:
+    """Use :meth:`git.cmd.Git.polish_url` instead, that works on any environment."""
+    path = str(path)  # Ensure is str and not AnyPath.
+    # Fix to use Paths when 3.5 dropped. Or to be just str if only for URLs?
+    if not path.startswith(("/cygdrive", "//", "/proc/cygdrive")):
+        for regex, parser, recurse in _cygpath_parsers:
+            match = regex.match(path)
+            if match:
+                path = parser(*match.groups())
+                if recurse:
+                    path = cygpath(path)
+                break
+        else:
+            path = _cygexpath(None, path)
+
+    return path
+
+
+_decygpath_regex = re.compile(r"(?:/proc)?/cygdrive/(\w)(/.*)?")
+
+
+def decygpath(path: PathLike) -> str:
+    path = str(path)
+    m = _decygpath_regex.match(path)
+    if m:
+        drive, rest_path = m.groups()
+        path = "%s:%s" % (drive.upper(), rest_path or "")
+
+    return path.replace("/", "\\")
+
+
+#: Store boolean flags denoting if a specific Git executable
+#: is from a Cygwin installation (since `cache_lru()` unsupported on PY2).
+_is_cygwin_cache: Dict[str, Optional[bool]] = {}
+
+
+def _is_cygwin_git(git_executable: str) -> bool:
+    is_cygwin = _is_cygwin_cache.get(git_executable)  # type: Optional[bool]
+    if is_cygwin is None:
+        is_cygwin = False
+        try:
+            git_dir = osp.dirname(git_executable)
+            if not git_dir:
+                res = py_where(git_executable)
+                git_dir = osp.dirname(res[0]) if res else ""
+
+            # Just a name given, not a real path.
+            uname_cmd = osp.join(git_dir, "uname")
+            process = subprocess.Popen([uname_cmd], stdout=subprocess.PIPE, universal_newlines=True)
+            uname_out, _ = process.communicate()
+            # retcode = process.poll()
+            is_cygwin = "CYGWIN" in uname_out
+        except Exception as ex:
+            _logger.debug("Failed checking if running in CYGWIN due to: %r", ex)
+        _is_cygwin_cache[git_executable] = is_cygwin
+
+    return is_cygwin
+
+
+@overload
+def is_cygwin_git(git_executable: None) -> Literal[False]: ...
+
+
+@overload
+def is_cygwin_git(git_executable: PathLike) -> bool: ...
+
+
+def is_cygwin_git(git_executable: Union[None, PathLike]) -> bool:
+    if sys.platform == "win32":  # TODO: See if we can use `sys.platform != "cygwin"`.
+        return False
+    elif git_executable is None:
+        return False
+    else:
+        return _is_cygwin_git(str(git_executable))
+
+
+def get_user_id() -> str:
+    """:return: String identifying the currently active system user as ``name@node``"""
+    return "%s@%s" % (getpass.getuser(), platform.node())
+
+
+def finalize_process(proc: Union[subprocess.Popen, "Git.AutoInterrupt"], **kwargs: Any) -> None:
+    """Wait for the process (clone, fetch, pull or push) and handle its errors
+    accordingly."""
+    # TODO: No close proc-streams??
+    proc.wait(**kwargs)
+
+
+@overload
+def expand_path(p: None, expand_vars: bool = ...) -> None: ...
+
+
+@overload
+def expand_path(p: PathLike, expand_vars: bool = ...) -> str:
+    # TODO: Support for Python 3.5 has been dropped, so these overloads can be improved.
+    ...
+
+
+def expand_path(p: Union[None, PathLike], expand_vars: bool = True) -> Optional[PathLike]:
+    if isinstance(p, pathlib.Path):
+        return p.resolve()
+    try:
+        p = osp.expanduser(p)  # type: ignore[arg-type]
+        if expand_vars:
+            p = osp.expandvars(p)
+        return osp.normpath(osp.abspath(p))
+    except Exception:
+        return None
+
+
+def remove_password_if_present(cmdline: Sequence[str]) -> List[str]:
+    """Parse any command line argument and if one of the elements is an URL with a
+    username and/or password, replace them by stars (in-place).
+
+    If nothing is found, this just returns the command line as-is.
+
+    This should be used for every log line that print a command line, as well as
+    exception messages.
+    """
+    new_cmdline = []
+    for index, to_parse in enumerate(cmdline):
+        new_cmdline.append(to_parse)
+        try:
+            url = urlsplit(to_parse)
+            # Remove password from the URL if present.
+            if url.password is None and url.username is None:
+                continue
+
+            if url.password is not None:
+                url = url._replace(netloc=url.netloc.replace(url.password, "*****"))
+            if url.username is not None:
+                url = url._replace(netloc=url.netloc.replace(url.username, "*****"))
+            new_cmdline[index] = urlunsplit(url)
+        except ValueError:
+            # This is not a valid URL.
+            continue
+    return new_cmdline
+
+
+# } END utilities
+
+# { Classes
+
+
+class RemoteProgress:
+    """Handler providing an interface to parse progress information emitted by
+    :manpage:`git-push(1)` and :manpage:`git-fetch(1)` and to dispatch callbacks
+    allowing subclasses to react to the progress."""
+
+    _num_op_codes: int = 9
+    (
+        BEGIN,
+        END,
+        COUNTING,
+        COMPRESSING,
+        WRITING,
+        RECEIVING,
+        RESOLVING,
+        FINDING_SOURCES,
+        CHECKING_OUT,
+    ) = [1 << x for x in range(_num_op_codes)]
+    STAGE_MASK = BEGIN | END
+    OP_MASK = ~STAGE_MASK
+
+    DONE_TOKEN = "done."
+    TOKEN_SEPARATOR = ", "
+
+    __slots__ = (
+        "_cur_line",
+        "_seen_ops",
+        "error_lines",  # Lines that started with 'error:' or 'fatal:'.
+        "other_lines",  # Lines not denoting progress (i.e.g. push-infos).
+    )
+    re_op_absolute = re.compile(r"(remote: )?([\w\s]+):\s+()(\d+)()(.*)")
+    re_op_relative = re.compile(r"(remote: )?([\w\s]+):\s+(\d+)% \((\d+)/(\d+)\)(.*)")
+
+    def __init__(self) -> None:
+        self._seen_ops: List[int] = []
+        self._cur_line: Optional[str] = None
+        self.error_lines: List[str] = []
+        self.other_lines: List[str] = []
+
+    def _parse_progress_line(self, line: AnyStr) -> None:
+        """Parse progress information from the given line as retrieved by
+        :manpage:`git-push(1)` or :manpage:`git-fetch(1)`.
+
+        - Lines that do not contain progress info are stored in :attr:`other_lines`.
+        - Lines that seem to contain an error (i.e. start with ``error:`` or ``fatal:``)
+          are stored in :attr:`error_lines`.
+        """
+        # handle
+        # Counting objects: 4, done.
+        # Compressing objects:  50% (1/2)
+        # Compressing objects: 100% (2/2)
+        # Compressing objects: 100% (2/2), done.
+        if isinstance(line, bytes):  # mypy argues about ternary assignment.
+            line_str = line.decode("utf-8")
+        else:
+            line_str = line
+        self._cur_line = line_str
+
+        if self._cur_line.startswith(("error:", "fatal:")):
+            self.error_lines.append(self._cur_line)
+            return
+
+        cur_count, max_count = None, None
+        match = self.re_op_relative.match(line_str)
+        if match is None:
+            match = self.re_op_absolute.match(line_str)
+
+        if not match:
+            self.line_dropped(line_str)
+            self.other_lines.append(line_str)
+            return
+        # END could not get match
+
+        op_code = 0
+        _remote, op_name, _percent, cur_count, max_count, message = match.groups()
+
+        # Get operation ID.
+        if op_name == "Counting objects":
+            op_code |= self.COUNTING
+        elif op_name == "Compressing objects":
+            op_code |= self.COMPRESSING
+        elif op_name == "Writing objects":
+            op_code |= self.WRITING
+        elif op_name == "Receiving objects":
+            op_code |= self.RECEIVING
+        elif op_name == "Resolving deltas":
+            op_code |= self.RESOLVING
+        elif op_name == "Finding sources":
+            op_code |= self.FINDING_SOURCES
+        elif op_name == "Checking out files":
+            op_code |= self.CHECKING_OUT
+        else:
+            # Note: On Windows it can happen that partial lines are sent.
+            # Hence we get something like "CompreReceiving objects", which is
+            # a blend of "Compressing objects" and "Receiving objects".
+            # This can't really be prevented, so we drop the line verbosely
+            # to make sure we get informed in case the process spits out new
+            # commands at some point.
+            self.line_dropped(line_str)
+            # Note: Don't add this line to the other lines, as we have to silently
+            # drop it.
+            return
+        # END handle op code
+
+        # Figure out stage.
+        if op_code not in self._seen_ops:
+            self._seen_ops.append(op_code)
+            op_code |= self.BEGIN
+        # END begin opcode
+
+        if message is None:
+            message = ""
+        # END message handling
+
+        message = message.strip()
+        if message.endswith(self.DONE_TOKEN):
+            op_code |= self.END
+            message = message[: -len(self.DONE_TOKEN)]
+        # END end message handling
+        message = message.strip(self.TOKEN_SEPARATOR)
+
+        self.update(
+            op_code,
+            cur_count and float(cur_count),
+            max_count and float(max_count),
+            message,
+        )
+
+    def new_message_handler(self) -> Callable[[str], None]:
+        """
+        :return:
+            A progress handler suitable for :func:`~git.cmd.handle_process_output`,
+            passing lines on to this progress handler in a suitable format.
+        """
+
+        def handler(line: AnyStr) -> None:
+            return self._parse_progress_line(line.rstrip())
+
+        # END handler
+
+        return handler
+
+    def line_dropped(self, line: str) -> None:
+        """Called whenever a line could not be understood and was therefore dropped."""
+        pass
+
+    def update(
+        self,
+        op_code: int,
+        cur_count: Union[str, float],
+        max_count: Union[str, float, None] = None,
+        message: str = "",
+    ) -> None:
+        """Called whenever the progress changes.
+
+        :param op_code:
+            Integer allowing to be compared against Operation IDs and stage IDs.
+
+            Stage IDs are :const:`BEGIN` and :const:`END`. :const:`BEGIN` will only be
+            set once for each Operation ID as well as :const:`END`. It may be that
+            :const:`BEGIN` and :const:`END` are set at once in case only one progress
+            message was emitted due to the speed of the operation. Between
+            :const:`BEGIN` and :const:`END`, none of these flags will be set.
+
+            Operation IDs are all held within the :const:`OP_MASK`. Only one Operation
+            ID will be active per call.
+
+        :param cur_count:
+            Current absolute count of items.
+
+        :param max_count:
+            The maximum count of items we expect. It may be ``None`` in case there is no
+            maximum number of items or if it is (yet) unknown.
+
+        :param message:
+            In case of the :const:`WRITING` operation, it contains the amount of bytes
+            transferred. It may possibly be used for other purposes as well.
+
+        :note:
+            You may read the contents of the current line in
+            :attr:`self._cur_line <_cur_line>`.
+        """
+        pass
+
+
+class CallableRemoteProgress(RemoteProgress):
+    """A :class:`RemoteProgress` implementation forwarding updates to any callable.
+
+    :note:
+        Like direct instances of :class:`RemoteProgress`, instances of this
+        :class:`CallableRemoteProgress` class are not themselves directly callable.
+        Rather, instances of this class wrap a callable and forward to it. This should
+        therefore not be confused with :class:`git.types.CallableProgress`.
+    """
+
+    __slots__ = ("_callable",)
+
+    def __init__(self, fn: Callable) -> None:
+        self._callable = fn
+        super().__init__()
+
+    def update(self, *args: Any, **kwargs: Any) -> None:
+        self._callable(*args, **kwargs)
+
+
+class Actor:
+    """Actors hold information about a person acting on the repository. They can be
+    committers and authors or anything with a name and an email as mentioned in the git
+    log entries."""
+
+    # PRECOMPILED REGEX
+    name_only_regex = re.compile(r"<(.*)>")
+    name_email_regex = re.compile(r"(.*) <(.*?)>")
+
+    # ENVIRONMENT VARIABLES
+    # These are read when creating new commits.
+    env_author_name = "GIT_AUTHOR_NAME"
+    env_author_email = "GIT_AUTHOR_EMAIL"
+    env_committer_name = "GIT_COMMITTER_NAME"
+    env_committer_email = "GIT_COMMITTER_EMAIL"
+
+    # CONFIGURATION KEYS
+    conf_name = "name"
+    conf_email = "email"
+
+    __slots__ = ("name", "email")
+
+    def __init__(self, name: Optional[str], email: Optional[str]) -> None:
+        self.name = name
+        self.email = email
+
+    def __eq__(self, other: Any) -> bool:
+        return self.name == other.name and self.email == other.email
+
+    def __ne__(self, other: Any) -> bool:
+        return not (self == other)
+
+    def __hash__(self) -> int:
+        return hash((self.name, self.email))
+
+    def __str__(self) -> str:
+        return self.name if self.name else ""
+
+    def __repr__(self) -> str:
+        return '<git.Actor "%s <%s>">' % (self.name, self.email)
+
+    @classmethod
+    def _from_string(cls, string: str) -> "Actor":
+        """Create an :class:`Actor` from a string.
+
+        :param string:
+            The string, which is expected to be in regular git format::
+
+                John Doe <jdoe@example.com>
+
+        :return:
+            :class:`Actor`
+        """
+        m = cls.name_email_regex.search(string)
+        if m:
+            name, email = m.groups()
+            return Actor(name, email)
+        else:
+            m = cls.name_only_regex.search(string)
+            if m:
+                return Actor(m.group(1), None)
+            # Assume the best and use the whole string as name.
+            return Actor(string, None)
+            # END special case name
+        # END handle name/email matching
+
+    @classmethod
+    def _main_actor(
+        cls,
+        env_name: str,
+        env_email: str,
+        config_reader: Union[None, "GitConfigParser", "SectionConstraint"] = None,
+    ) -> "Actor":
+        actor = Actor("", "")
+        user_id = None  # We use this to avoid multiple calls to getpass.getuser().
+
+        def default_email() -> str:
+            nonlocal user_id
+            if not user_id:
+                user_id = get_user_id()
+            return user_id
+
+        def default_name() -> str:
+            return default_email().split("@")[0]
+
+        for attr, evar, cvar, default in (
+            ("name", env_name, cls.conf_name, default_name),
+            ("email", env_email, cls.conf_email, default_email),
+        ):
+            try:
+                val = os.environ[evar]
+                setattr(actor, attr, val)
+            except KeyError:
+                if config_reader is not None:
+                    try:
+                        val = config_reader.get("user", cvar)
+                    except Exception:
+                        val = default()
+                    setattr(actor, attr, val)
+                # END config-reader handling
+                if not getattr(actor, attr):
+                    setattr(actor, attr, default())
+            # END handle name
+        # END for each item to retrieve
+        return actor
+
+    @classmethod
+    def committer(cls, config_reader: Union[None, "GitConfigParser", "SectionConstraint"] = None) -> "Actor":
+        """
+        :return:
+            :class:`Actor` instance corresponding to the configured committer. It
+            behaves similar to the git implementation, such that the environment will
+            override configuration values of `config_reader`. If no value is set at all,
+            it will be generated.
+
+        :param config_reader:
+            ConfigReader to use to retrieve the values from in case they are not set in
+            the environment.
+        """
+        return cls._main_actor(cls.env_committer_name, cls.env_committer_email, config_reader)
+
+    @classmethod
+    def author(cls, config_reader: Union[None, "GitConfigParser", "SectionConstraint"] = None) -> "Actor":
+        """Same as :meth:`committer`, but defines the main author. It may be specified
+        in the environment, but defaults to the committer."""
+        return cls._main_actor(cls.env_author_name, cls.env_author_email, config_reader)
+
+
+class Stats:
+    """Represents stat information as presented by git at the end of a merge. It is
+    created from the output of a diff operation.
+
+    Example::
+
+     c = Commit( sha1 )
+     s = c.stats
+     s.total         # full-stat-dict
+     s.files         # dict( filepath : stat-dict )
+
+    ``stat-dict``
+
+    A dictionary with the following keys and values::
+
+      deletions = number of deleted lines as int
+      insertions = number of inserted lines as int
+      lines = total number of lines changed as int, or deletions + insertions
+
+    ``full-stat-dict``
+
+    In addition to the items in the stat-dict, it features additional information::
+
+     files = number of changed files as int
+    """
+
+    __slots__ = ("total", "files")
+
+    def __init__(self, total: Total_TD, files: Dict[PathLike, Files_TD]) -> None:
+        self.total = total
+        self.files = files
+
+    @classmethod
+    def _list_from_string(cls, repo: "Repo", text: str) -> "Stats":
+        """Create a :class:`Stats` object from output retrieved by
+        :manpage:`git-diff(1)`.
+
+        :return:
+            :class:`git.Stats`
+        """
+
+        hsh: HSH_TD = {
+            "total": {"insertions": 0, "deletions": 0, "lines": 0, "files": 0},
+            "files": {},
+        }
+        for line in text.splitlines():
+            (raw_insertions, raw_deletions, filename) = line.split("\t")
+            insertions = raw_insertions != "-" and int(raw_insertions) or 0
+            deletions = raw_deletions != "-" and int(raw_deletions) or 0
+            hsh["total"]["insertions"] += insertions
+            hsh["total"]["deletions"] += deletions
+            hsh["total"]["lines"] += insertions + deletions
+            hsh["total"]["files"] += 1
+            files_dict: Files_TD = {
+                "insertions": insertions,
+                "deletions": deletions,
+                "lines": insertions + deletions,
+            }
+            hsh["files"][filename.strip()] = files_dict
+        return Stats(hsh["total"], hsh["files"])
+
+
+class IndexFileSHA1Writer:
+    """Wrapper around a file-like object that remembers the SHA1 of the data written to
+    it. It will write a sha when the stream is closed or if asked for explicitly using
+    :meth:`write_sha`.
+
+    Only useful to the index file.
+
+    :note:
+        Based on the dulwich project.
+    """
+
+    __slots__ = ("f", "sha1")
+
+    def __init__(self, f: IO) -> None:
+        self.f = f
+        self.sha1 = make_sha(b"")
+
+    def write(self, data: AnyStr) -> int:
+        self.sha1.update(data)
+        return self.f.write(data)
+
+    def write_sha(self) -> bytes:
+        sha = self.sha1.digest()
+        self.f.write(sha)
+        return sha
+
+    def close(self) -> bytes:
+        sha = self.write_sha()
+        self.f.close()
+        return sha
+
+    def tell(self) -> int:
+        return self.f.tell()
+
+
+class LockFile:
+    """Provides methods to obtain, check for, and release a file based lock which
+    should be used to handle concurrent access to the same file.
+
+    As we are a utility class to be derived from, we only use protected methods.
+
+    Locks will automatically be released on destruction.
+    """
+
+    __slots__ = ("_file_path", "_owns_lock")
+
+    def __init__(self, file_path: PathLike) -> None:
+        self._file_path = file_path
+        self._owns_lock = False
+
+    def __del__(self) -> None:
+        self._release_lock()
+
+    def _lock_file_path(self) -> str:
+        """:return: Path to lockfile"""
+        return "%s.lock" % (self._file_path)
+
+    def _has_lock(self) -> bool:
+        """
+        :return:
+            True if we have a lock and if the lockfile still exists
+
+        :raise AssertionError:
+            If our lock-file does not exist.
+        """
+        return self._owns_lock
+
+    def _obtain_lock_or_raise(self) -> None:
+        """Create a lock file as flag for other instances, mark our instance as
+        lock-holder.
+
+        :raise IOError:
+            If a lock was already present or a lock file could not be written.
+        """
+        if self._has_lock():
+            return
+        lock_file = self._lock_file_path()
+        if osp.isfile(lock_file):
+            raise IOError(
+                "Lock for file %r did already exist, delete %r in case the lock is illegal"
+                % (self._file_path, lock_file)
+            )
+
+        try:
+            with open(lock_file, mode="w"):
+                pass
+        except OSError as e:
+            raise IOError(str(e)) from e
+
+        self._owns_lock = True
+
+    def _obtain_lock(self) -> None:
+        """The default implementation will raise if a lock cannot be obtained.
+
+        Subclasses may override this method to provide a different implementation.
+        """
+        return self._obtain_lock_or_raise()
+
+    def _release_lock(self) -> None:
+        """Release our lock if we have one."""
+        if not self._has_lock():
+            return
+
+        # If someone removed our file beforehand, lets just flag this issue instead of
+        # failing, to make it more usable.
+        lfp = self._lock_file_path()
+        try:
+            rmfile(lfp)
+        except OSError:
+            pass
+        self._owns_lock = False
+
+
+class BlockingLockFile(LockFile):
+    """The lock file will block until a lock could be obtained, or fail after a
+    specified timeout.
+
+    :note:
+        If the directory containing the lock was removed, an exception will be raised
+        during the blocking period, preventing hangs as the lock can never be obtained.
+    """
+
+    __slots__ = ("_check_interval", "_max_block_time")
+
+    def __init__(
+        self,
+        file_path: PathLike,
+        check_interval_s: float = 0.3,
+        max_block_time_s: int = sys.maxsize,
+    ) -> None:
+        """Configure the instance.
+
+        :param check_interval_s:
+            Period of time to sleep until the lock is checked the next time.
+            By default, it waits a nearly unlimited time.
+
+        :param max_block_time_s:
+            Maximum amount of seconds we may lock.
+        """
+        super().__init__(file_path)
+        self._check_interval = check_interval_s
+        self._max_block_time = max_block_time_s
+
+    def _obtain_lock(self) -> None:
+        """This method blocks until it obtained the lock, or raises :exc:`IOError` if it
+        ran out of time or if the parent directory was not available anymore.
+
+        If this method returns, you are guaranteed to own the lock.
+        """
+        starttime = time.time()
+        maxtime = starttime + float(self._max_block_time)
+        while True:
+            try:
+                super()._obtain_lock()
+            except IOError as e:
+                # synity check: if the directory leading to the lockfile is not
+                # readable anymore, raise an exception
+                curtime = time.time()
+                if not osp.isdir(osp.dirname(self._lock_file_path())):
+                    msg = "Directory containing the lockfile %r was not readable anymore after waiting %g seconds" % (
+                        self._lock_file_path(),
+                        curtime - starttime,
+                    )
+                    raise IOError(msg) from e
+                # END handle missing directory
+
+                if curtime >= maxtime:
+                    msg = "Waited %g seconds for lock at %r" % (
+                        maxtime - starttime,
+                        self._lock_file_path(),
+                    )
+                    raise IOError(msg) from e
+                # END abort if we wait too long
+                time.sleep(self._check_interval)
+            else:
+                break
+        # END endless loop
+
+
+class IterableList(List[T_IterableObj]):
+    """List of iterable objects allowing to query an object by id or by named index::
+
+     heads = repo.heads
+     heads.master
+     heads['master']
+     heads[0]
+
+    Iterable parent objects:
+
+    * :class:`Commit <git.objects.Commit>`
+    * :class:`Submodule <git.objects.submodule.base.Submodule>`
+    * :class:`Reference <git.refs.reference.Reference>`
+    * :class:`FetchInfo <git.remote.FetchInfo>`
+    * :class:`PushInfo <git.remote.PushInfo>`
+
+    Iterable via inheritance:
+
+    * :class:`Head <git.refs.head.Head>`
+    * :class:`TagReference <git.refs.tag.TagReference>`
+    * :class:`RemoteReference <git.refs.remote.RemoteReference>`
+
+    This requires an ``id_attribute`` name to be set which will be queried from its
+    contained items to have a means for comparison.
+
+    A prefix can be specified which is to be used in case the id returned by the items
+    always contains a prefix that does not matter to the user, so it can be left out.
+    """
+
+    __slots__ = ("_id_attr", "_prefix")
+
+    def __new__(cls, id_attr: str, prefix: str = "") -> "IterableList[T_IterableObj]":
+        return super().__new__(cls)
+
+    def __init__(self, id_attr: str, prefix: str = "") -> None:
+        self._id_attr = id_attr
+        self._prefix = prefix
+
+    def __contains__(self, attr: object) -> bool:
+        # First try identity match for performance.
+        try:
+            rval = list.__contains__(self, attr)
+            if rval:
+                return rval
+        except (AttributeError, TypeError):
+            pass
+        # END handle match
+
+        # Otherwise make a full name search.
+        try:
+            getattr(self, cast(str, attr))  # Use cast to silence mypy.
+            return True
+        except (AttributeError, TypeError):
+            return False
+        # END handle membership
+
+    def __getattr__(self, attr: str) -> T_IterableObj:
+        attr = self._prefix + attr
+        for item in self:
+            if getattr(item, self._id_attr) == attr:
+                return item
+        # END for each item
+        return list.__getattribute__(self, attr)
+
+    def __getitem__(self, index: Union[SupportsIndex, int, slice, str]) -> T_IterableObj:  # type: ignore[override]
+        assert isinstance(index, (int, str, slice)), "Index of IterableList should be an int or str"
+
+        if isinstance(index, int):
+            return list.__getitem__(self, index)
+        elif isinstance(index, slice):
+            raise ValueError("Index should be an int or str")
+        else:
+            try:
+                return getattr(self, index)
+            except AttributeError as e:
+                raise IndexError("No item found with id %r" % (self._prefix + index)) from e
+        # END handle getattr
+
+    def __delitem__(self, index: Union[SupportsIndex, int, slice, str]) -> None:
+        assert isinstance(index, (int, str)), "Index of IterableList should be an int or str"
+
+        delindex = cast(int, index)
+        if not isinstance(index, int):
+            delindex = -1
+            name = self._prefix + index
+            for i, item in enumerate(self):
+                if getattr(item, self._id_attr) == name:
+                    delindex = i
+                    break
+                # END search index
+            # END for each item
+            if delindex == -1:
+                raise IndexError("Item with name %s not found" % name)
+            # END handle error
+        # END get index to delete
+        list.__delitem__(self, delindex)
+
+
+@runtime_checkable
+class IterableObj(Protocol):
+    """Defines an interface for iterable items, so there is a uniform way to retrieve
+    and iterate items within the git repository.
+
+    Subclasses:
+
+    * :class:`Submodule <git.objects.submodule.base.Submodule>`
+    * :class:`Commit <git.objects.Commit>`
+    * :class:`Reference <git.refs.reference.Reference>`
+    * :class:`PushInfo <git.remote.PushInfo>`
+    * :class:`FetchInfo <git.remote.FetchInfo>`
+    * :class:`Remote <git.remote.Remote>`
+    """
+
+    __slots__ = ()
+
+    _id_attribute_: str
+
+    @classmethod
+    @abstractmethod
+    def iter_items(cls, repo: "Repo", *args: Any, **kwargs: Any) -> Iterator[T_IterableObj]:
+        # Return-typed to be compatible with subtypes e.g. Remote.
+        """Find (all) items of this type.
+
+        Subclasses can specify `args` and `kwargs` differently, and may use them for
+        filtering. However, when the method is called with no additional positional or
+        keyword arguments, subclasses are obliged to to yield all items.
+
+        :return:
+            Iterator yielding Items
+        """
+        raise NotImplementedError("To be implemented by Subclass")
+
+    @classmethod
+    def list_items(cls, repo: "Repo", *args: Any, **kwargs: Any) -> IterableList[T_IterableObj]:
+        """Find (all) items of this type and collect them into a list.
+
+        For more information about the arguments, see :meth:`iter_items`.
+
+        :note:
+            Favor the :meth:`iter_items` method as it will avoid eagerly collecting all
+            items. When there are many items, that can slow performance and increase
+            memory usage.
+
+        :return:
+            list(Item,...) list of item instances
+        """
+        out_list: IterableList = IterableList(cls._id_attribute_)
+        out_list.extend(cls.iter_items(repo, *args, **kwargs))
+        return out_list
+
+
+class IterableClassWatcher(type):
+    """Metaclass that issues :exc:`DeprecationWarning` when :class:`git.util.Iterable`
+    is subclassed."""
+
+    def __init__(cls, name: str, bases: Tuple, clsdict: Dict) -> None:
+        for base in bases:
+            if type(base) is IterableClassWatcher:
+                warnings.warn(
+                    f"GitPython Iterable subclassed by {name}."
+                    " Iterable is deprecated due to naming clash since v3.1.18"
+                    " and will be removed in 4.0.0."
+                    " Use IterableObj instead.",
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+
+
+class Iterable(metaclass=IterableClassWatcher):
+    """Deprecated, use :class:`IterableObj` instead.
+
+    Defines an interface for iterable items, so there is a uniform way to retrieve
+    and iterate items within the git repository.
+    """
+
+    __slots__ = ()
+
+    _id_attribute_ = "attribute that most suitably identifies your instance"
+
+    @classmethod
+    def iter_items(cls, repo: "Repo", *args: Any, **kwargs: Any) -> Any:
+        """Deprecated, use :class:`IterableObj` instead.
+
+        Find (all) items of this type.
+
+        See :meth:`IterableObj.iter_items` for details on usage.
+
+        :return:
+            Iterator yielding Items
+        """
+        raise NotImplementedError("To be implemented by Subclass")
+
+    @classmethod
+    def list_items(cls, repo: "Repo", *args: Any, **kwargs: Any) -> Any:
+        """Deprecated, use :class:`IterableObj` instead.
+
+        Find (all) items of this type and collect them into a list.
+
+        See :meth:`IterableObj.list_items` for details on usage.
+
+        :return:
+            list(Item,...) list of item instances
+        """
+        out_list: Any = IterableList(cls._id_attribute_)
+        out_list.extend(cls.iter_items(repo, *args, **kwargs))
+        return out_list
+
+
+# } END classes
diff --git a/llm/Lib/site-packages/gitdb-4.0.11.dist-info/AUTHORS b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/AUTHORS
new file mode 100644
index 0000000000000000000000000000000000000000..6c7e9b9971cca907772213fce28eb8e0162a875f
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/AUTHORS
@@ -0,0 +1,4 @@
+Creator: Sebastian Thiel
+
+Contributors:
+  - Ram Rachum (@cool-RR)
diff --git a/llm/Lib/site-packages/gitdb-4.0.11.dist-info/INSTALLER b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/gitdb-4.0.11.dist-info/LICENSE b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..0d6fe8bdb9ee5bb745e2b86c9e8745676ff0ef4a
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/LICENSE
@@ -0,0 +1,42 @@
+Copyright (C) 2010, 2011 Sebastian Thiel and contributors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions 
+are met:
+
+* Redistributions of source code must retain the above copyright 
+notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright 
+notice, this list of conditions and the following disclaimer in the 
+documentation and/or other materials provided with the distribution.
+
+* Neither the name of the GitDB project nor the names of 
+its contributors may be used to endorse or promote products derived 
+from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED 
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+Additional Licenses
+-------------------
+The files at 
+gitdb/test/fixtures/packs/pack-11fdfa9e156ab73caae3b6da867192221f2089c2.idx
+and 
+gitdb/test/fixtures/packs/pack-11fdfa9e156ab73caae3b6da867192221f2089c2.pack 
+are licensed under GNU GPL as part of the git source repository, 
+see http://en.wikipedia.org/wiki/Git_%28software%29 for more information.
+
+They are not required for the actual operation, which is why they are not found 
+in the distribution package.
diff --git a/llm/Lib/site-packages/gitdb-4.0.11.dist-info/METADATA b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..05a6db3cd6c08e5105c25b6b85cc57c0ec654cdc
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/METADATA
@@ -0,0 +1,31 @@
+Metadata-Version: 2.1
+Name: gitdb
+Version: 4.0.11
+Summary: Git Object Database
+Home-page: https://github.com/gitpython-developers/gitdb
+Author: Sebastian Thiel
+Author-email: byronimo@gmail.com
+License: BSD License
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.7
+License-File: LICENSE
+License-File: AUTHORS
+Requires-Dist: smmap <6,>=3.0.1
+
+GitDB is a pure-Python git object database
diff --git a/llm/Lib/site-packages/gitdb-4.0.11.dist-info/RECORD b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..f773ba998efce465fe116e10e16d3acb0290ad3c
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/RECORD
@@ -0,0 +1,57 @@
+gitdb-4.0.11.dist-info/AUTHORS,sha256=aUmmuuKGJrGDzN5i-dDIbj00R1IOPcFTZDWznhEwZuM,66
+gitdb-4.0.11.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+gitdb-4.0.11.dist-info/LICENSE,sha256=79KfWWoI6IV-aOdpSlC82nKDl5LafD8EG8v_XxgAkjk,1984
+gitdb-4.0.11.dist-info/METADATA,sha256=7X3m4N9rVUD2-HtGkVm3olIWk3Ld5m_lkXlDyzuPv14,1180
+gitdb-4.0.11.dist-info/RECORD,,
+gitdb-4.0.11.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
+gitdb-4.0.11.dist-info/top_level.txt,sha256=ss6atT8cG4mQuAYXO6PokJ0r4Mm5cBiDbKsu2e3YHfs,6
+gitdb/__init__.py,sha256=DMI-8DaXN1M41QkJAFg7KP_pnXGi6XbjxM9J_B1s29I,966
+gitdb/__pycache__/__init__.cpython-311.pyc,,
+gitdb/__pycache__/base.cpython-311.pyc,,
+gitdb/__pycache__/const.cpython-311.pyc,,
+gitdb/__pycache__/exc.cpython-311.pyc,,
+gitdb/__pycache__/fun.cpython-311.pyc,,
+gitdb/__pycache__/pack.cpython-311.pyc,,
+gitdb/__pycache__/stream.cpython-311.pyc,,
+gitdb/__pycache__/typ.cpython-311.pyc,,
+gitdb/__pycache__/util.cpython-311.pyc,,
+gitdb/base.py,sha256=krg61c_FKEvn4KAcX6pjH-hlpFfRCcM7mrki4Hnmxew,8023
+gitdb/const.py,sha256=WWmEYKNDdm3J9fxYTFT_B6-QLDSMBClbz0LSBa1D1S8,90
+gitdb/db/__init__.py,sha256=aQTZnxpfk6c76X1ubZzO9pBq4STnL6hCoGxZzXurEZ4,371
+gitdb/db/__pycache__/__init__.cpython-311.pyc,,
+gitdb/db/__pycache__/base.cpython-311.pyc,,
+gitdb/db/__pycache__/git.cpython-311.pyc,,
+gitdb/db/__pycache__/loose.cpython-311.pyc,,
+gitdb/db/__pycache__/mem.cpython-311.pyc,,
+gitdb/db/__pycache__/pack.cpython-311.pyc,,
+gitdb/db/__pycache__/ref.cpython-311.pyc,,
+gitdb/db/base.py,sha256=_qpZ1VzwpoTcU3_-IIXmwIW0p63HXrtJ5jWNgjrLjRY,9061
+gitdb/db/git.py,sha256=b5O01eZsnzldruzEENvqiw8Q7Daz2iETrlAqH0aggdE,2666
+gitdb/db/loose.py,sha256=UPsy-VHJOPBe7ND0224c6ai1ykutzrGxFqK5ZTPRKnk,8036
+gitdb/db/mem.py,sha256=VDscunT4EtRo2GBE52lup1ki3si8enImUSKmSVq8kwc,3343
+gitdb/db/pack.py,sha256=iZPDF6rQ-kCrgbdsZRA83CL-zWsoQaZxo5rcTarjAoQ,7285
+gitdb/db/ref.py,sha256=rGOzF3cAOBW9i0Owz_Iw6c4K5BgbYFwk5btMaXGvCoc,2591
+gitdb/exc.py,sha256=B0N6I2rctCwd0Upoq2laTigbVZNOZ38nfobRcKDBtV4,1496
+gitdb/fun.py,sha256=jw3paQMgxexUn2NENFavLXfABfNvDBRfRCvv2VHkvms,23243
+gitdb/pack.py,sha256=buboXaTzXKEedNX5j1zIUIPhnLmHkDRl7Rg9ftclt14,39228
+gitdb/stream.py,sha256=0-BWcggWWZniMXGGaAe3MR6iH9DBt5ir9YtgE2_rKKw,27541
+gitdb/test/__init__.py,sha256=4cJQwIMepzCxK0hdxDegJGxNVK4dungjbPzCUJc1ZIU,204
+gitdb/test/__pycache__/__init__.cpython-311.pyc,,
+gitdb/test/__pycache__/lib.cpython-311.pyc,,
+gitdb/test/__pycache__/test_base.cpython-311.pyc,,
+gitdb/test/__pycache__/test_example.cpython-311.pyc,,
+gitdb/test/__pycache__/test_pack.cpython-311.pyc,,
+gitdb/test/__pycache__/test_stream.cpython-311.pyc,,
+gitdb/test/__pycache__/test_util.cpython-311.pyc,,
+gitdb/test/lib.py,sha256=iXBcJ3RDAN0uj9NbyEzt90TuCsDFt3SjHA61Ly6Xyxs,5489
+gitdb/test/test_base.py,sha256=tIS3b_YnV5_rPjkneSNzrME-fQDfGKL3sr_4nvujVho,2822
+gitdb/test/test_example.py,sha256=In7WgwvrGCbxPcuLCmkVIs4kdhCJ8rtcEvp115fHeU4,1350
+gitdb/test/test_pack.py,sha256=bbkupZPBFlpjBcPZTZ0OmRrTA9I3-fVdfwLtNa14_3s,9228
+gitdb/test/test_stream.py,sha256=RwSB49q6JHM7EFW413CZQeGRfkK92aQ0IVfTocIa3bo,5727
+gitdb/test/test_util.py,sha256=WQKQBP2uPF4wwNJFlUd9-YE2Q3CmlgpoY4MRk5G0r54,3243
+gitdb/typ.py,sha256=dZlbzfy5RFNHiZHEOwVy-6T-aZ3xLv0mGaJVyxKBd0M,373
+gitdb/util.py,sha256=F3bE24b2QDihz4tqc3Km7wbC6N65EjwFoao-yzrRJSY,12302
+gitdb/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gitdb/utils/__pycache__/__init__.cpython-311.pyc,,
+gitdb/utils/__pycache__/encoding.cpython-311.pyc,,
+gitdb/utils/encoding.py,sha256=ceZZFb86LGJ71cwW6qkq_BFquAlNE7jaafNbwxYRSXk,372
diff --git a/llm/Lib/site-packages/gitdb-4.0.11.dist-info/WHEEL b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..7e688737d490be3643d705bc16b5a77f7bd567b7
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.41.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/gitdb-4.0.11.dist-info/top_level.txt b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..c2023eef06a4fb9bb4a6e90d6405308215059169
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb-4.0.11.dist-info/top_level.txt
@@ -0,0 +1 @@
+gitdb
diff --git a/llm/Lib/site-packages/gitdb/__init__.py b/llm/Lib/site-packages/gitdb/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..803a4283faae0aa85b7f1fb580671d4415817454
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/__init__.py
@@ -0,0 +1,38 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Initialize the object database module"""
+
+import sys
+import os
+
+#{ Initialization
+
+
+def _init_externals():
+    """Initialize external projects by putting them into the path"""
+    if 'PYOXIDIZER' not in os.environ:
+        where = os.path.join(os.path.dirname(__file__), 'ext', 'smmap')
+        if os.path.exists(where):
+            sys.path.append(where)
+
+    import smmap
+    del smmap
+    # END handle imports
+
+#} END initialization
+
+_init_externals()
+
+__author__ = "Sebastian Thiel"
+__contact__ = "byronimo@gmail.com"
+__homepage__ = "https://github.com/gitpython-developers/gitdb"
+version_info = (4, 0, 11)
+__version__ = '.'.join(str(i) for i in version_info)
+
+
+# default imports
+from gitdb.base import *
+from gitdb.db import *
+from gitdb.stream import *
diff --git a/llm/Lib/site-packages/gitdb/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/gitdb/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7377ee1d65454bc4deb54c5463d74cf3f8d6f162
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/gitdb/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5b4ca25a4166344fcb79b81d62b7ed51c821f338
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/__pycache__/const.cpython-311.pyc b/llm/Lib/site-packages/gitdb/__pycache__/const.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1f2b5599b0dd81c911809aa3acc25488b066fd16
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/__pycache__/const.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/__pycache__/exc.cpython-311.pyc b/llm/Lib/site-packages/gitdb/__pycache__/exc.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9c94a2c252a7e86dbc3972c13bebda09252ea2b6
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/__pycache__/exc.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/__pycache__/fun.cpython-311.pyc b/llm/Lib/site-packages/gitdb/__pycache__/fun.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..26a52b25d3694558b6f229575a9d359389a376e4
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/__pycache__/fun.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/__pycache__/pack.cpython-311.pyc b/llm/Lib/site-packages/gitdb/__pycache__/pack.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0387b58a443cea80cd3785e42b3af7394f168b8d
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/__pycache__/pack.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/__pycache__/stream.cpython-311.pyc b/llm/Lib/site-packages/gitdb/__pycache__/stream.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..80ed042527dceaf7715145f6faa887e66bead9d9
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/__pycache__/stream.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/__pycache__/typ.cpython-311.pyc b/llm/Lib/site-packages/gitdb/__pycache__/typ.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d10984663a0dc90ef09b935f97cfca9ddcaa8fb2
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/__pycache__/typ.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/__pycache__/util.cpython-311.pyc b/llm/Lib/site-packages/gitdb/__pycache__/util.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..79c418cb5cddb4603193175c95ed9132147353dd
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/__pycache__/util.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/base.py b/llm/Lib/site-packages/gitdb/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a23a4f71acb85106cff88d7cab619915d67d39e
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/base.py
@@ -0,0 +1,315 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Module with basic data structures - they are designed to be lightweight and fast"""
+from gitdb.util import bin_to_hex
+
+from gitdb.fun import (
+    type_id_to_type_map,
+    type_to_type_id_map
+)
+
+__all__ = ('OInfo', 'OPackInfo', 'ODeltaPackInfo',
+           'OStream', 'OPackStream', 'ODeltaPackStream',
+           'IStream', 'InvalidOInfo', 'InvalidOStream')
+
+#{ ODB Bases
+
+
+class OInfo(tuple):
+
+    """Carries information about an object in an ODB, providing information
+    about the binary sha of the object, the type_string as well as the uncompressed size
+    in bytes.
+
+    It can be accessed using tuple notation and using attribute access notation::
+
+        assert dbi[0] == dbi.binsha
+        assert dbi[1] == dbi.type
+        assert dbi[2] == dbi.size
+
+    The type is designed to be as lightweight as possible."""
+    __slots__ = tuple()
+
+    def __new__(cls, sha, type, size):
+        return tuple.__new__(cls, (sha, type, size))
+
+    def __init__(self, *args):
+        tuple.__init__(self)
+
+    #{ Interface
+    @property
+    def binsha(self):
+        """:return: our sha as binary, 20 bytes"""
+        return self[0]
+
+    @property
+    def hexsha(self):
+        """:return: our sha, hex encoded, 40 bytes"""
+        return bin_to_hex(self[0])
+
+    @property
+    def type(self):
+        return self[1]
+
+    @property
+    def type_id(self):
+        return type_to_type_id_map[self[1]]
+
+    @property
+    def size(self):
+        return self[2]
+    #} END interface
+
+
+class OPackInfo(tuple):
+
+    """As OInfo, but provides a type_id property to retrieve the numerical type id, and
+    does not include a sha.
+
+    Additionally, the pack_offset is the absolute offset into the packfile at which
+    all object information is located. The data_offset property points to the absolute
+    location in the pack at which that actual data stream can be found."""
+    __slots__ = tuple()
+
+    def __new__(cls, packoffset, type, size):
+        return tuple.__new__(cls, (packoffset, type, size))
+
+    def __init__(self, *args):
+        tuple.__init__(self)
+
+    #{ Interface
+
+    @property
+    def pack_offset(self):
+        return self[0]
+
+    @property
+    def type(self):
+        return type_id_to_type_map[self[1]]
+
+    @property
+    def type_id(self):
+        return self[1]
+
+    @property
+    def size(self):
+        return self[2]
+
+    #} END interface
+
+
+class ODeltaPackInfo(OPackInfo):
+
+    """Adds delta specific information,
+    Either the 20 byte sha which points to some object in the database,
+    or the negative offset from the pack_offset, so that pack_offset - delta_info yields
+    the pack offset of the base object"""
+    __slots__ = tuple()
+
+    def __new__(cls, packoffset, type, size, delta_info):
+        return tuple.__new__(cls, (packoffset, type, size, delta_info))
+
+    #{ Interface
+    @property
+    def delta_info(self):
+        return self[3]
+    #} END interface
+
+
+class OStream(OInfo):
+
+    """Base for object streams retrieved from the database, providing additional
+    information about the stream.
+    Generally, ODB streams are read-only as objects are immutable"""
+    __slots__ = tuple()
+
+    def __new__(cls, sha, type, size, stream, *args, **kwargs):
+        """Helps with the initialization of subclasses"""
+        return tuple.__new__(cls, (sha, type, size, stream))
+
+    def __init__(self, *args, **kwargs):
+        tuple.__init__(self)
+
+    #{ Stream Reader Interface
+
+    def read(self, size=-1):
+        return self[3].read(size)
+
+    @property
+    def stream(self):
+        return self[3]
+
+    #} END stream reader interface
+
+
+class ODeltaStream(OStream):
+
+    """Uses size info of its stream, delaying reads"""
+
+    def __new__(cls, sha, type, size, stream, *args, **kwargs):
+        """Helps with the initialization of subclasses"""
+        return tuple.__new__(cls, (sha, type, size, stream))
+
+    #{ Stream Reader Interface
+
+    @property
+    def size(self):
+        return self[3].size
+
+    #} END stream reader interface
+
+
+class OPackStream(OPackInfo):
+
+    """Next to pack object information, a stream outputting an undeltified base object
+    is provided"""
+    __slots__ = tuple()
+
+    def __new__(cls, packoffset, type, size, stream, *args):
+        """Helps with the initialization of subclasses"""
+        return tuple.__new__(cls, (packoffset, type, size, stream))
+
+    #{ Stream Reader Interface
+    def read(self, size=-1):
+        return self[3].read(size)
+
+    @property
+    def stream(self):
+        return self[3]
+    #} END stream reader interface
+
+
+class ODeltaPackStream(ODeltaPackInfo):
+
+    """Provides a stream outputting the uncompressed offset delta information"""
+    __slots__ = tuple()
+
+    def __new__(cls, packoffset, type, size, delta_info, stream):
+        return tuple.__new__(cls, (packoffset, type, size, delta_info, stream))
+
+    #{ Stream Reader Interface
+    def read(self, size=-1):
+        return self[4].read(size)
+
+    @property
+    def stream(self):
+        return self[4]
+    #} END stream reader interface
+
+
+class IStream(list):
+
+    """Represents an input content stream to be fed into the ODB. It is mutable to allow
+    the ODB to record information about the operations outcome right in this instance.
+
+    It provides interfaces for the OStream and a StreamReader to allow the instance
+    to blend in without prior conversion.
+
+    The only method your content stream must support is 'read'"""
+    __slots__ = tuple()
+
+    def __new__(cls, type, size, stream, sha=None):
+        return list.__new__(cls, (sha, type, size, stream, None))
+
+    def __init__(self, type, size, stream, sha=None):
+        list.__init__(self, (sha, type, size, stream, None))
+
+    #{ Interface
+    @property
+    def hexsha(self):
+        """:return: our sha, hex encoded, 40 bytes"""
+        return bin_to_hex(self[0])
+
+    def _error(self):
+        """:return: the error that occurred when processing the stream, or None"""
+        return self[4]
+
+    def _set_error(self, exc):
+        """Set this input stream to the given exc, may be None to reset the error"""
+        self[4] = exc
+
+    error = property(_error, _set_error)
+
+    #} END interface
+
+    #{ Stream Reader Interface
+
+    def read(self, size=-1):
+        """Implements a simple stream reader interface, passing the read call on
+            to our internal stream"""
+        return self[3].read(size)
+
+    #} END stream reader interface
+
+    #{  interface
+
+    def _set_binsha(self, binsha):
+        self[0] = binsha
+
+    def _binsha(self):
+        return self[0]
+
+    binsha = property(_binsha, _set_binsha)
+
+    def _type(self):
+        return self[1]
+
+    def _set_type(self, type):
+        self[1] = type
+
+    type = property(_type, _set_type)
+
+    def _size(self):
+        return self[2]
+
+    def _set_size(self, size):
+        self[2] = size
+
+    size = property(_size, _set_size)
+
+    def _stream(self):
+        return self[3]
+
+    def _set_stream(self, stream):
+        self[3] = stream
+
+    stream = property(_stream, _set_stream)
+
+    #} END odb info interface
+
+
+class InvalidOInfo(tuple):
+
+    """Carries information about a sha identifying an object which is invalid in
+    the queried database. The exception attribute provides more information about
+    the cause of the issue"""
+    __slots__ = tuple()
+
+    def __new__(cls, sha, exc):
+        return tuple.__new__(cls, (sha, exc))
+
+    def __init__(self, sha, exc):
+        tuple.__init__(self, (sha, exc))
+
+    @property
+    def binsha(self):
+        return self[0]
+
+    @property
+    def hexsha(self):
+        return bin_to_hex(self[0])
+
+    @property
+    def error(self):
+        """:return: exception instance explaining the failure"""
+        return self[1]
+
+
+class InvalidOStream(InvalidOInfo):
+
+    """Carries information about an invalid ODB stream"""
+    __slots__ = tuple()
+
+#} END ODB Bases
diff --git a/llm/Lib/site-packages/gitdb/const.py b/llm/Lib/site-packages/gitdb/const.py
new file mode 100644
index 0000000000000000000000000000000000000000..6391d796f3fa3714802c8858960f5cfb3947c230
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/const.py
@@ -0,0 +1,4 @@
+BYTE_SPACE = b' '
+NULL_BYTE = b'\0'
+NULL_HEX_SHA = "0" * 40
+NULL_BIN_SHA = NULL_BYTE * 20
diff --git a/llm/Lib/site-packages/gitdb/db/__init__.py b/llm/Lib/site-packages/gitdb/db/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..20fd2280db7a978d8204e7b1566967ab7d3e772a
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/db/__init__.py
@@ -0,0 +1,11 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+
+from gitdb.db.base import *
+from gitdb.db.loose import *
+from gitdb.db.mem import *
+from gitdb.db.pack import *
+from gitdb.db.git import *
+from gitdb.db.ref import *
diff --git a/llm/Lib/site-packages/gitdb/db/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/gitdb/db/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b8de2235b8c6dea11e927057575bf1169ab1a5cf
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/db/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/db/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/gitdb/db/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cd9167487389d628809425b56ef3654a0e580c6c
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/db/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/db/__pycache__/git.cpython-311.pyc b/llm/Lib/site-packages/gitdb/db/__pycache__/git.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5f0d08228cc78275ce8aab6e81bb29e656eda82a
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/db/__pycache__/git.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/db/__pycache__/loose.cpython-311.pyc b/llm/Lib/site-packages/gitdb/db/__pycache__/loose.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c702751557016838cd6590e8d669c22d6dc03179
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/db/__pycache__/loose.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/db/__pycache__/mem.cpython-311.pyc b/llm/Lib/site-packages/gitdb/db/__pycache__/mem.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e461ba40b85bf4004cda50f05285ff4ecf5f8bb2
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/db/__pycache__/mem.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/db/__pycache__/pack.cpython-311.pyc b/llm/Lib/site-packages/gitdb/db/__pycache__/pack.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eb3e64fde508fb3935e7f5c0c85452150039a417
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/db/__pycache__/pack.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/db/__pycache__/ref.cpython-311.pyc b/llm/Lib/site-packages/gitdb/db/__pycache__/ref.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..932cc103bb2beea4777e9cf308706d748b3ca97e
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/db/__pycache__/ref.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/db/base.py b/llm/Lib/site-packages/gitdb/db/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..7312fe00f3ec772e7abe508b2eeff63c5e79a7e3
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/db/base.py
@@ -0,0 +1,278 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Contains implementations of database retrieveing objects"""
+from gitdb.util import (
+    join,
+    LazyMixin,
+    hex_to_bin
+)
+
+from gitdb.utils.encoding import force_text
+from gitdb.exc import (
+    BadObject,
+    AmbiguousObjectName
+)
+
+from itertools import chain
+from functools import reduce
+
+
+__all__ = ('ObjectDBR', 'ObjectDBW', 'FileDBBase', 'CompoundDB', 'CachingDB')
+
+
+class ObjectDBR:
+
+    """Defines an interface for object database lookup.
+    Objects are identified either by their 20 byte bin sha"""
+
+    def __contains__(self, sha):
+        return self.has_obj
+
+    #{ Query Interface
+    def has_object(self, sha):
+        """
+        Whether the object identified by the given 20 bytes
+            binary sha is contained in the database
+
+        :return: True if the object identified by the given 20 bytes
+            binary sha is contained in the database"""
+        raise NotImplementedError("To be implemented in subclass")
+
+    def info(self, sha):
+        """ :return: OInfo instance
+        :param sha: bytes binary sha
+        :raise BadObject:"""
+        raise NotImplementedError("To be implemented in subclass")
+
+    def stream(self, sha):
+        """:return: OStream instance
+        :param sha: 20 bytes binary sha
+        :raise BadObject:"""
+        raise NotImplementedError("To be implemented in subclass")
+
+    def size(self):
+        """:return: amount of objects in this database"""
+        raise NotImplementedError()
+
+    def sha_iter(self):
+        """Return iterator yielding 20 byte shas for all objects in this data base"""
+        raise NotImplementedError()
+
+    #} END query interface
+
+
+class ObjectDBW:
+
+    """Defines an interface to create objects in the database"""
+
+    def __init__(self, *args, **kwargs):
+        self._ostream = None
+
+    #{ Edit Interface
+    def set_ostream(self, stream):
+        """
+        Adjusts the stream to which all data should be sent when storing new objects
+
+        :param stream: if not None, the stream to use, if None the default stream
+            will be used.
+        :return: previously installed stream, or None if there was no override
+        :raise TypeError: if the stream doesn't have the supported functionality"""
+        cstream = self._ostream
+        self._ostream = stream
+        return cstream
+
+    def ostream(self):
+        """
+        Return the output stream
+
+        :return: overridden output stream this instance will write to, or None
+            if it will write to the default stream"""
+        return self._ostream
+
+    def store(self, istream):
+        """
+        Create a new object in the database
+        :return: the input istream object with its sha set to its corresponding value
+
+        :param istream: IStream compatible instance. If its sha is already set
+            to a value, the object will just be stored in the our database format,
+            in which case the input stream is expected to be in object format ( header + contents ).
+        :raise IOError: if data could not be written"""
+        raise NotImplementedError("To be implemented in subclass")
+
+    #} END edit interface
+
+
+class FileDBBase:
+
+    """Provides basic facilities to retrieve files of interest, including
+    caching facilities to help mapping hexsha's to objects"""
+
+    def __init__(self, root_path):
+        """Initialize this instance to look for its files at the given root path
+        All subsequent operations will be relative to this path
+        :raise InvalidDBRoot:
+        **Note:** The base will not perform any accessablity checking as the base
+            might not yet be accessible, but become accessible before the first
+            access."""
+        super().__init__()
+        self._root_path = root_path
+
+    #{ Interface
+    def root_path(self):
+        """:return: path at which this db operates"""
+        return self._root_path
+
+    def db_path(self, rela_path):
+        """
+        :return: the given relative path relative to our database root, allowing
+            to pontentially access datafiles"""
+        return join(self._root_path, force_text(rela_path))
+    #} END interface
+
+
+class CachingDB:
+
+    """A database which uses caches to speed-up access"""
+
+    #{ Interface
+    def update_cache(self, force=False):
+        """
+        Call this method if the underlying data changed to trigger an update
+        of the internal caching structures.
+
+        :param force: if True, the update must be performed. Otherwise the implementation
+            may decide not to perform an update if it thinks nothing has changed.
+        :return: True if an update was performed as something change indeed"""
+
+    # END interface
+
+
+def _databases_recursive(database, output):
+    """Fill output list with database from db, in order. Deals with Loose, Packed
+    and compound databases."""
+    if isinstance(database, CompoundDB):
+        dbs = database.databases()
+        output.extend(db for db in dbs if not isinstance(db, CompoundDB))
+        for cdb in (db for db in dbs if isinstance(db, CompoundDB)):
+            _databases_recursive(cdb, output)
+    else:
+        output.append(database)
+    # END handle database type
+
+
+class CompoundDB(ObjectDBR, LazyMixin, CachingDB):
+
+    """A database which delegates calls to sub-databases.
+
+    Databases are stored in the lazy-loaded _dbs attribute.
+    Define _set_cache_ to update it with your databases"""
+
+    def _set_cache_(self, attr):
+        if attr == '_dbs':
+            self._dbs = list()
+        elif attr == '_db_cache':
+            self._db_cache = dict()
+        else:
+            super()._set_cache_(attr)
+
+    def _db_query(self, sha):
+        """:return: database containing the given 20 byte sha
+        :raise BadObject:"""
+        # most databases use binary representations, prevent converting
+        # it every time a database is being queried
+        try:
+            return self._db_cache[sha]
+        except KeyError:
+            pass
+        # END first level cache
+
+        for db in self._dbs:
+            if db.has_object(sha):
+                self._db_cache[sha] = db
+                return db
+        # END for each database
+        raise BadObject(sha)
+
+    #{ ObjectDBR interface
+
+    def has_object(self, sha):
+        try:
+            self._db_query(sha)
+            return True
+        except BadObject:
+            return False
+        # END handle exceptions
+
+    def info(self, sha):
+        return self._db_query(sha).info(sha)
+
+    def stream(self, sha):
+        return self._db_query(sha).stream(sha)
+
+    def size(self):
+        """:return: total size of all contained databases"""
+        return reduce(lambda x, y: x + y, (db.size() for db in self._dbs), 0)
+
+    def sha_iter(self):
+        return chain(*(db.sha_iter() for db in self._dbs))
+
+    #} END object DBR Interface
+
+    #{ Interface
+
+    def databases(self):
+        """:return: tuple of database instances we use for lookups"""
+        return tuple(self._dbs)
+
+    def update_cache(self, force=False):
+        # something might have changed, clear everything
+        self._db_cache.clear()
+        stat = False
+        for db in self._dbs:
+            if isinstance(db, CachingDB):
+                stat |= db.update_cache(force)
+            # END if is caching db
+        # END for each database to update
+        return stat
+
+    def partial_to_complete_sha_hex(self, partial_hexsha):
+        """
+        :return: 20 byte binary sha1 from the given less-than-40 byte hexsha (bytes or str)
+        :param partial_hexsha: hexsha with less than 40 byte
+        :raise AmbiguousObjectName: """
+        databases = list()
+        _databases_recursive(self, databases)
+        partial_hexsha = force_text(partial_hexsha)
+        len_partial_hexsha = len(partial_hexsha)
+        if len_partial_hexsha % 2 != 0:
+            partial_binsha = hex_to_bin(partial_hexsha + "0")
+        else:
+            partial_binsha = hex_to_bin(partial_hexsha)
+        # END assure successful binary conversion
+
+        candidate = None
+        for db in databases:
+            full_bin_sha = None
+            try:
+                if hasattr(db, 'partial_to_complete_sha_hex'):
+                    full_bin_sha = db.partial_to_complete_sha_hex(partial_hexsha)
+                else:
+                    full_bin_sha = db.partial_to_complete_sha(partial_binsha, len_partial_hexsha)
+                # END handle database type
+            except BadObject:
+                continue
+            # END ignore bad objects
+            if full_bin_sha:
+                if candidate and candidate != full_bin_sha:
+                    raise AmbiguousObjectName(partial_hexsha)
+                candidate = full_bin_sha
+            # END handle candidate
+        # END for each db
+        if not candidate:
+            raise BadObject(partial_binsha)
+        return candidate
+
+    #} END interface
diff --git a/llm/Lib/site-packages/gitdb/db/git.py b/llm/Lib/site-packages/gitdb/db/git.py
new file mode 100644
index 0000000000000000000000000000000000000000..a1ed1428054f94e5ccda150ce7d8267b31ce55fd
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/db/git.py
@@ -0,0 +1,85 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+from gitdb.db.base import (
+    CompoundDB,
+    ObjectDBW,
+    FileDBBase
+)
+
+from gitdb.db.loose import LooseObjectDB
+from gitdb.db.pack import PackedDB
+from gitdb.db.ref import ReferenceDB
+
+from gitdb.exc import InvalidDBRoot
+
+import os
+
+__all__ = ('GitDB', )
+
+
+class GitDB(FileDBBase, ObjectDBW, CompoundDB):
+
+    """A git-style object database, which contains all objects in the 'objects'
+    subdirectory
+
+    ``IMPORTANT``: The usage of this implementation is highly discouraged as it fails to release file-handles.
+    This can be a problem with long-running processes and/or big repositories.
+    """
+    # Configuration
+    PackDBCls = PackedDB
+    LooseDBCls = LooseObjectDB
+    ReferenceDBCls = ReferenceDB
+
+    # Directories
+    packs_dir = 'pack'
+    loose_dir = ''
+    alternates_dir = os.path.join('info', 'alternates')
+
+    def __init__(self, root_path):
+        """Initialize ourselves on a git objects directory"""
+        super().__init__(root_path)
+
+    def _set_cache_(self, attr):
+        if attr == '_dbs' or attr == '_loose_db':
+            self._dbs = list()
+            loose_db = None
+            for subpath, dbcls in ((self.packs_dir, self.PackDBCls),
+                                   (self.loose_dir, self.LooseDBCls),
+                                   (self.alternates_dir, self.ReferenceDBCls)):
+                path = self.db_path(subpath)
+                if os.path.exists(path):
+                    self._dbs.append(dbcls(path))
+                    if dbcls is self.LooseDBCls:
+                        loose_db = self._dbs[-1]
+                    # END remember loose db
+                # END check path exists
+            # END for each db type
+
+            # should have at least one subdb
+            if not self._dbs:
+                raise InvalidDBRoot(self.root_path())
+            # END handle error
+
+            # we the first one should have the store method
+            assert loose_db is not None and hasattr(loose_db, 'store'), "First database needs store functionality"
+
+            # finally set the value
+            self._loose_db = loose_db
+        else:
+            super()._set_cache_(attr)
+        # END handle attrs
+
+    #{ ObjectDBW interface
+
+    def store(self, istream):
+        return self._loose_db.store(istream)
+
+    def ostream(self):
+        return self._loose_db.ostream()
+
+    def set_ostream(self, ostream):
+        return self._loose_db.set_ostream(ostream)
+
+    #} END objectdbw interface
diff --git a/llm/Lib/site-packages/gitdb/db/loose.py b/llm/Lib/site-packages/gitdb/db/loose.py
new file mode 100644
index 0000000000000000000000000000000000000000..256fec9cf5558494e6bf1dc0995aa1c8b1710d57
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/db/loose.py
@@ -0,0 +1,254 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+from gitdb.db.base import (
+    FileDBBase,
+    ObjectDBR,
+    ObjectDBW
+)
+
+from gitdb.exc import (
+    BadObject,
+    AmbiguousObjectName
+)
+
+from gitdb.stream import (
+    DecompressMemMapReader,
+    FDCompressedSha1Writer,
+    FDStream,
+    Sha1Writer
+)
+
+from gitdb.base import (
+    OStream,
+    OInfo
+)
+
+from gitdb.util import (
+    file_contents_ro_filepath,
+    ENOENT,
+    hex_to_bin,
+    bin_to_hex,
+    exists,
+    chmod,
+    isfile,
+    remove,
+    rename,
+    dirname,
+    basename,
+    join
+)
+
+from gitdb.fun import (
+    chunk_size,
+    loose_object_header_info,
+    write_object,
+    stream_copy
+)
+
+from gitdb.utils.encoding import force_bytes
+
+import tempfile
+import os
+import sys
+
+
+__all__ = ('LooseObjectDB', )
+
+
+class LooseObjectDB(FileDBBase, ObjectDBR, ObjectDBW):
+
+    """A database which operates on loose object files"""
+
+    # CONFIGURATION
+    # chunks in which data will be copied between streams
+    stream_chunk_size = chunk_size
+
+    # On windows we need to keep it writable, otherwise it cannot be removed
+    # either
+    new_objects_mode = int("444", 8)
+    if os.name == 'nt':
+        new_objects_mode = int("644", 8)
+
+    def __init__(self, root_path):
+        super().__init__(root_path)
+        self._hexsha_to_file = dict()
+        # Additional Flags - might be set to 0 after the first failure
+        # Depending on the root, this might work for some mounts, for others not, which
+        # is why it is per instance
+        self._fd_open_flags = getattr(os, 'O_NOATIME', 0)
+
+    #{ Interface
+    def object_path(self, hexsha):
+        """
+        :return: path at which the object with the given hexsha would be stored,
+            relative to the database root"""
+        return join(hexsha[:2], hexsha[2:])
+
+    def readable_db_object_path(self, hexsha):
+        """
+        :return: readable object path to the object identified by hexsha
+        :raise BadObject: If the object file does not exist"""
+        try:
+            return self._hexsha_to_file[hexsha]
+        except KeyError:
+            pass
+        # END ignore cache misses
+
+        # try filesystem
+        path = self.db_path(self.object_path(hexsha))
+        if exists(path):
+            self._hexsha_to_file[hexsha] = path
+            return path
+        # END handle cache
+        raise BadObject(hexsha)
+
+    def partial_to_complete_sha_hex(self, partial_hexsha):
+        """:return: 20 byte binary sha1 string which matches the given name uniquely
+        :param name: hexadecimal partial name (bytes or ascii string)
+        :raise AmbiguousObjectName:
+        :raise BadObject: """
+        candidate = None
+        for binsha in self.sha_iter():
+            if bin_to_hex(binsha).startswith(force_bytes(partial_hexsha)):
+                # it can't ever find the same object twice
+                if candidate is not None:
+                    raise AmbiguousObjectName(partial_hexsha)
+                candidate = binsha
+        # END for each object
+        if candidate is None:
+            raise BadObject(partial_hexsha)
+        return candidate
+
+    #} END interface
+
+    def _map_loose_object(self, sha):
+        """
+        :return: memory map of that file to allow random read access
+        :raise BadObject: if object could not be located"""
+        db_path = self.db_path(self.object_path(bin_to_hex(sha)))
+        try:
+            return file_contents_ro_filepath(db_path, flags=self._fd_open_flags)
+        except OSError as e:
+            if e.errno != ENOENT:
+                # try again without noatime
+                try:
+                    return file_contents_ro_filepath(db_path)
+                except OSError as new_e:
+                    raise BadObject(sha) from new_e
+                # didn't work because of our flag, don't try it again
+                self._fd_open_flags = 0
+            else:
+                raise BadObject(sha) from e
+            # END handle error
+        # END exception handling
+
+    def set_ostream(self, stream):
+        """:raise TypeError: if the stream does not support the Sha1Writer interface"""
+        if stream is not None and not isinstance(stream, Sha1Writer):
+            raise TypeError("Output stream musst support the %s interface" % Sha1Writer.__name__)
+        return super().set_ostream(stream)
+
+    def info(self, sha):
+        m = self._map_loose_object(sha)
+        try:
+            typ, size = loose_object_header_info(m)
+            return OInfo(sha, typ, size)
+        finally:
+            if hasattr(m, 'close'):
+                m.close()
+        # END assure release of system resources
+
+    def stream(self, sha):
+        m = self._map_loose_object(sha)
+        type, size, stream = DecompressMemMapReader.new(m, close_on_deletion=True)
+        return OStream(sha, type, size, stream)
+
+    def has_object(self, sha):
+        try:
+            self.readable_db_object_path(bin_to_hex(sha))
+            return True
+        except BadObject:
+            return False
+        # END check existence
+
+    def store(self, istream):
+        """note: The sha we produce will be hex by nature"""
+        tmp_path = None
+        writer = self.ostream()
+        if writer is None:
+            # open a tmp file to write the data to
+            fd, tmp_path = tempfile.mkstemp(prefix='obj', dir=self._root_path)
+
+            if istream.binsha is None:
+                writer = FDCompressedSha1Writer(fd)
+            else:
+                writer = FDStream(fd)
+            # END handle direct stream copies
+        # END handle custom writer
+
+        try:
+            try:
+                if istream.binsha is not None:
+                    # copy as much as possible, the actual uncompressed item size might
+                    # be smaller than the compressed version
+                    stream_copy(istream.read, writer.write, sys.maxsize, self.stream_chunk_size)
+                else:
+                    # write object with header, we have to make a new one
+                    write_object(istream.type, istream.size, istream.read, writer.write,
+                                 chunk_size=self.stream_chunk_size)
+                # END handle direct stream copies
+            finally:
+                if tmp_path:
+                    writer.close()
+            # END assure target stream is closed
+        except:
+            if tmp_path:
+                os.remove(tmp_path)
+            raise
+        # END assure tmpfile removal on error
+
+        hexsha = None
+        if istream.binsha:
+            hexsha = istream.hexsha
+        else:
+            hexsha = writer.sha(as_hex=True)
+        # END handle sha
+
+        if tmp_path:
+            obj_path = self.db_path(self.object_path(hexsha))
+            obj_dir = dirname(obj_path)
+            os.makedirs(obj_dir, exist_ok=True)
+            # END handle destination directory
+            # rename onto existing doesn't work on NTFS
+            if isfile(obj_path):
+                remove(tmp_path)
+            else:
+                rename(tmp_path, obj_path)
+            # end rename only if needed
+
+            # make sure its readable for all ! It started out as rw-- tmp file
+            # but needs to be rwrr
+            chmod(obj_path, self.new_objects_mode)
+        # END handle dry_run
+
+        istream.binsha = hex_to_bin(hexsha)
+        return istream
+
+    def sha_iter(self):
+        # find all files which look like an object, extract sha from there
+        for root, dirs, files in os.walk(self.root_path()):
+            root_base = basename(root)
+            if len(root_base) != 2:
+                continue
+
+            for f in files:
+                if len(f) != 38:
+                    continue
+                yield hex_to_bin(root_base + f)
+            # END for each file
+        # END for each walk iteration
+
+    def size(self):
+        return len(tuple(self.sha_iter()))
diff --git a/llm/Lib/site-packages/gitdb/db/mem.py b/llm/Lib/site-packages/gitdb/db/mem.py
new file mode 100644
index 0000000000000000000000000000000000000000..d4772fdb5e5d98b14c5fb329f4198e2cc99f8906
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/db/mem.py
@@ -0,0 +1,110 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Contains the MemoryDatabase implementation"""
+from gitdb.db.loose import LooseObjectDB
+from gitdb.db.base import (
+    ObjectDBR,
+    ObjectDBW
+)
+
+from gitdb.base import (
+    OStream,
+    IStream,
+)
+
+from gitdb.exc import (
+    BadObject,
+    UnsupportedOperation
+)
+
+from gitdb.stream import (
+    ZippedStoreShaWriter,
+    DecompressMemMapReader,
+)
+
+from io import BytesIO
+
+__all__ = ("MemoryDB", )
+
+
+class MemoryDB(ObjectDBR, ObjectDBW):
+
+    """A memory database stores everything to memory, providing fast IO and object
+    retrieval. It should be used to buffer results and obtain SHAs before writing
+    it to the actual physical storage, as it allows to query whether object already
+    exists in the target storage before introducing actual IO"""
+
+    def __init__(self):
+        super().__init__()
+        self._db = LooseObjectDB("path/doesnt/matter")
+
+        # maps 20 byte shas to their OStream objects
+        self._cache = dict()
+
+    def set_ostream(self, stream):
+        raise UnsupportedOperation("MemoryDB's always stream into memory")
+
+    def store(self, istream):
+        zstream = ZippedStoreShaWriter()
+        self._db.set_ostream(zstream)
+
+        istream = self._db.store(istream)
+        zstream.close()     # close to flush
+        zstream.seek(0)
+
+        # don't provide a size, the stream is written in object format, hence the
+        # header needs decompression
+        decomp_stream = DecompressMemMapReader(zstream.getvalue(), close_on_deletion=False)
+        self._cache[istream.binsha] = OStream(istream.binsha, istream.type, istream.size, decomp_stream)
+
+        return istream
+
+    def has_object(self, sha):
+        return sha in self._cache
+
+    def info(self, sha):
+        # we always return streams, which are infos as well
+        return self.stream(sha)
+
+    def stream(self, sha):
+        try:
+            ostream = self._cache[sha]
+            # rewind stream for the next one to read
+            ostream.stream.seek(0)
+            return ostream
+        except KeyError as e:
+            raise BadObject(sha) from e
+        # END exception handling
+
+    def size(self):
+        return len(self._cache)
+
+    def sha_iter(self):
+        return self._cache.keys()
+
+    #{ Interface
+    def stream_copy(self, sha_iter, odb):
+        """Copy the streams as identified by sha's yielded by sha_iter into the given odb
+        The streams will be copied directly
+        **Note:** the object will only be written if it did not exist in the target db
+
+        :return: amount of streams actually copied into odb. If smaller than the amount
+            of input shas, one or more objects did already exist in odb"""
+        count = 0
+        for sha in sha_iter:
+            if odb.has_object(sha):
+                continue
+            # END check object existence
+
+            ostream = self.stream(sha)
+            # compressed data including header
+            sio = BytesIO(ostream.stream.data())
+            istream = IStream(ostream.type, ostream.size, sio, sha)
+
+            odb.store(istream)
+            count += 1
+        # END for each sha
+        return count
+    #} END interface
diff --git a/llm/Lib/site-packages/gitdb/db/pack.py b/llm/Lib/site-packages/gitdb/db/pack.py
new file mode 100644
index 0000000000000000000000000000000000000000..274ea59904ee6b83ffa98d13df130e5a1e0d75f2
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/db/pack.py
@@ -0,0 +1,206 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Module containing a database to deal with packs"""
+from gitdb.db.base import (
+    FileDBBase,
+    ObjectDBR,
+    CachingDB
+)
+
+from gitdb.util import LazyMixin
+
+from gitdb.exc import (
+    BadObject,
+    UnsupportedOperation,
+    AmbiguousObjectName
+)
+
+from gitdb.pack import PackEntity
+
+from functools import reduce
+
+import os
+import glob
+
+__all__ = ('PackedDB', )
+
+#{ Utilities
+
+
+class PackedDB(FileDBBase, ObjectDBR, CachingDB, LazyMixin):
+
+    """A database operating on a set of object packs"""
+
+    # sort the priority list every N queries
+    # Higher values are better, performance tests don't show this has
+    # any effect, but it should have one
+    _sort_interval = 500
+
+    def __init__(self, root_path):
+        super().__init__(root_path)
+        # list of lists with three items:
+        # * hits - number of times the pack was hit with a request
+        # * entity - Pack entity instance
+        # * sha_to_index - PackIndexFile.sha_to_index method for direct cache query
+        # self._entities = list()       # lazy loaded list
+        self._hit_count = 0             # amount of hits
+        self._st_mtime = 0              # last modification data of our root path
+
+    def _set_cache_(self, attr):
+        if attr == '_entities':
+            self._entities = list()
+            self.update_cache(force=True)
+        # END handle entities initialization
+
+    def _sort_entities(self):
+        self._entities.sort(key=lambda l: l[0], reverse=True)
+
+    def _pack_info(self, sha):
+        """:return: tuple(entity, index) for an item at the given sha
+        :param sha: 20 or 40 byte sha
+        :raise BadObject:
+        **Note:** This method is not thread-safe, but may be hit in multi-threaded
+            operation. The worst thing that can happen though is a counter that
+            was not incremented, or the list being in wrong order. So we safe
+            the time for locking here, lets see how that goes"""
+        # presort ?
+        if self._hit_count % self._sort_interval == 0:
+            self._sort_entities()
+        # END update sorting
+
+        for item in self._entities:
+            index = item[2](sha)
+            if index is not None:
+                item[0] += 1            # one hit for you
+                self._hit_count += 1    # general hit count
+                return (item[1], index)
+            # END index found in pack
+        # END for each item
+
+        # no hit, see whether we have to update packs
+        # NOTE: considering packs don't change very often, we safe this call
+        # and leave it to the super-caller to trigger that
+        raise BadObject(sha)
+
+    #{ Object DB Read
+
+    def has_object(self, sha):
+        try:
+            self._pack_info(sha)
+            return True
+        except BadObject:
+            return False
+        # END exception handling
+
+    def info(self, sha):
+        entity, index = self._pack_info(sha)
+        return entity.info_at_index(index)
+
+    def stream(self, sha):
+        entity, index = self._pack_info(sha)
+        return entity.stream_at_index(index)
+
+    def sha_iter(self):
+        for entity in self.entities():
+            index = entity.index()
+            sha_by_index = index.sha
+            for index in range(index.size()):
+                yield sha_by_index(index)
+            # END for each index
+        # END for each entity
+
+    def size(self):
+        sizes = [item[1].index().size() for item in self._entities]
+        return reduce(lambda x, y: x + y, sizes, 0)
+
+    #} END object db read
+
+    #{ object db write
+
+    def store(self, istream):
+        """Storing individual objects is not feasible as a pack is designed to
+        hold multiple objects. Writing or rewriting packs for single objects is
+        inefficient"""
+        raise UnsupportedOperation()
+
+    #} END object db write
+
+    #{ Interface
+
+    def update_cache(self, force=False):
+        """
+        Update our cache with the actually existing packs on disk. Add new ones,
+        and remove deleted ones. We keep the unchanged ones
+
+        :param force: If True, the cache will be updated even though the directory
+            does not appear to have changed according to its modification timestamp.
+        :return: True if the packs have been updated so there is new information,
+            False if there was no change to the pack database"""
+        stat = os.stat(self.root_path())
+        if not force and stat.st_mtime <= self._st_mtime:
+            return False
+        # END abort early on no change
+        self._st_mtime = stat.st_mtime
+
+        # packs are supposed to be prefixed with pack- by git-convention
+        # get all pack files, figure out what changed
+        pack_files = set(glob.glob(os.path.join(self.root_path(), "pack-*.pack")))
+        our_pack_files = {item[1].pack().path() for item in self._entities}
+
+        # new packs
+        for pack_file in (pack_files - our_pack_files):
+            # init the hit-counter/priority with the size, a good measure for hit-
+            # probability. Its implemented so that only 12 bytes will be read
+            entity = PackEntity(pack_file)
+            self._entities.append([entity.pack().size(), entity, entity.index().sha_to_index])
+        # END for each new packfile
+
+        # removed packs
+        for pack_file in (our_pack_files - pack_files):
+            del_index = -1
+            for i, item in enumerate(self._entities):
+                if item[1].pack().path() == pack_file:
+                    del_index = i
+                    break
+                # END found index
+            # END for each entity
+            assert del_index != -1
+            del(self._entities[del_index])
+        # END for each removed pack
+
+        # reinitialize prioritiess
+        self._sort_entities()
+        return True
+
+    def entities(self):
+        """:return: list of pack entities operated upon by this database"""
+        return [item[1] for item in self._entities]
+
+    def partial_to_complete_sha(self, partial_binsha, canonical_length):
+        """:return: 20 byte sha as inferred by the given partial binary sha
+        :param partial_binsha: binary sha with less than 20 bytes
+        :param canonical_length: length of the corresponding canonical representation.
+            It is required as binary sha's cannot display whether the original hex sha
+            had an odd or even number of characters
+        :raise AmbiguousObjectName:
+        :raise BadObject: """
+        candidate = None
+        for item in self._entities:
+            item_index = item[1].index().partial_sha_to_index(partial_binsha, canonical_length)
+            if item_index is not None:
+                sha = item[1].index().sha(item_index)
+                if candidate and candidate != sha:
+                    raise AmbiguousObjectName(partial_binsha)
+                candidate = sha
+            # END handle full sha could be found
+        # END for each entity
+
+        if candidate:
+            return candidate
+
+        # still not found ?
+        raise BadObject(partial_binsha)
+
+    #} END interface
diff --git a/llm/Lib/site-packages/gitdb/db/ref.py b/llm/Lib/site-packages/gitdb/db/ref.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd3015602f2967441ca8b27813424b7bfab9160b
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/db/ref.py
@@ -0,0 +1,82 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+import codecs
+from gitdb.db.base import (
+    CompoundDB,
+)
+
+__all__ = ('ReferenceDB', )
+
+
+class ReferenceDB(CompoundDB):
+
+    """A database consisting of database referred to in a file"""
+
+    # Configuration
+    # Specifies the object database to use for the paths found in the alternates
+    # file. If None, it defaults to the GitDB
+    ObjectDBCls = None
+
+    def __init__(self, ref_file):
+        super().__init__()
+        self._ref_file = ref_file
+
+    def _set_cache_(self, attr):
+        if attr == '_dbs':
+            self._dbs = list()
+            self._update_dbs_from_ref_file()
+        else:
+            super()._set_cache_(attr)
+        # END handle attrs
+
+    def _update_dbs_from_ref_file(self):
+        dbcls = self.ObjectDBCls
+        if dbcls is None:
+            # late import
+            from gitdb.db.git import GitDB
+            dbcls = GitDB
+        # END get db type
+
+        # try to get as many as possible, don't fail if some are unavailable
+        ref_paths = list()
+        try:
+            with codecs.open(self._ref_file, 'r', encoding="utf-8") as f:
+                ref_paths = [l.strip() for l in f]
+        except OSError:
+            pass
+        # END handle alternates
+
+        ref_paths_set = set(ref_paths)
+        cur_ref_paths_set = {db.root_path() for db in self._dbs}
+
+        # remove existing
+        for path in (cur_ref_paths_set - ref_paths_set):
+            for i, db in enumerate(self._dbs[:]):
+                if db.root_path() == path:
+                    del(self._dbs[i])
+                    continue
+                # END del matching db
+        # END for each path to remove
+
+        # add new
+        # sort them to maintain order
+        added_paths = sorted(ref_paths_set - cur_ref_paths_set, key=lambda p: ref_paths.index(p))
+        for path in added_paths:
+            try:
+                db = dbcls(path)
+                # force an update to verify path
+                if isinstance(db, CompoundDB):
+                    db.databases()
+                # END verification
+                self._dbs.append(db)
+            except Exception:
+                # ignore invalid paths or issues
+                pass
+        # END for each path to add
+
+    def update_cache(self, force=False):
+        # re-read alternates and update databases
+        self._update_dbs_from_ref_file()
+        return super().update_cache(force)
diff --git a/llm/Lib/site-packages/gitdb/exc.py b/llm/Lib/site-packages/gitdb/exc.py
new file mode 100644
index 0000000000000000000000000000000000000000..752dafdbbc837e577617f9e5f1abaf101d93cdd3
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/exc.py
@@ -0,0 +1,57 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Module with common exceptions"""
+from gitdb.util import to_hex_sha
+
+__all__ = [
+    'AmbiguousObjectName',
+    'BadName',
+    'BadObject',
+    'BadObjectType',
+    'InvalidDBRoot',
+    'ODBError',
+    'ParseError',
+    'UnsupportedOperation',
+    'to_hex_sha',
+]
+
+class ODBError(Exception):
+    """All errors thrown by the object database"""
+
+
+class InvalidDBRoot(ODBError):
+    """Thrown if an object database cannot be initialized at the given path"""
+
+
+class BadObject(ODBError):
+    """The object with the given SHA does not exist. Instantiate with the
+    failed sha"""
+
+    def __str__(self):
+        return "BadObject: %s" % to_hex_sha(self.args[0])
+
+
+class BadName(ODBError):
+    """A name provided to rev_parse wasn't understood"""
+
+    def __str__(self):
+        return "Ref '%s' did not resolve to an object" % self.args[0]
+
+
+class ParseError(ODBError):
+    """Thrown if the parsing of a file failed due to an invalid format"""
+
+
+class AmbiguousObjectName(ODBError):
+    """Thrown if a possibly shortened name does not uniquely represent a single object
+    in the database"""
+
+
+class BadObjectType(ODBError):
+    """The object had an unsupported type"""
+
+
+class UnsupportedOperation(ODBError):
+    """Thrown if the given operation cannot be supported by the object database"""
diff --git a/llm/Lib/site-packages/gitdb/fun.py b/llm/Lib/site-packages/gitdb/fun.py
new file mode 100644
index 0000000000000000000000000000000000000000..a272e5caa85e27b5f7f2c4adf3b396c3ce5c0b21
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/fun.py
@@ -0,0 +1,704 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Contains basic c-functions which usually contain performance critical code
+Keeping this code separate from the beginning makes it easier to out-source
+it into c later, if required"""
+
+import zlib
+from gitdb.util import byte_ord
+decompressobj = zlib.decompressobj
+
+import mmap
+from itertools import islice
+from functools import reduce
+
+from gitdb.const import NULL_BYTE, BYTE_SPACE
+from gitdb.utils.encoding import force_text
+from gitdb.typ import (
+    str_blob_type,
+    str_commit_type,
+    str_tree_type,
+    str_tag_type,
+)
+
+from io import StringIO
+
+# INVARIANTS
+OFS_DELTA = 6
+REF_DELTA = 7
+delta_types = (OFS_DELTA, REF_DELTA)
+
+type_id_to_type_map = {
+    0: b'',             # EXT 1
+    1: str_commit_type,
+    2: str_tree_type,
+    3: str_blob_type,
+    4: str_tag_type,
+    5: b'',             # EXT 2
+    OFS_DELTA: "OFS_DELTA",    # OFFSET DELTA
+    REF_DELTA: "REF_DELTA"     # REFERENCE DELTA
+}
+
+type_to_type_id_map = {
+    str_commit_type: 1,
+    str_tree_type: 2,
+    str_blob_type: 3,
+    str_tag_type: 4,
+    "OFS_DELTA": OFS_DELTA,
+    "REF_DELTA": REF_DELTA,
+}
+
+# used when dealing with larger streams
+chunk_size = 1000 * mmap.PAGESIZE
+
+__all__ = ('is_loose_object', 'loose_object_header_info', 'msb_size', 'pack_object_header_info',
+           'write_object', 'loose_object_header', 'stream_copy', 'apply_delta_data',
+           'is_equal_canonical_sha', 'connect_deltas', 'DeltaChunkList', 'create_pack_object_header')
+
+
+#{ Structures
+
+def _set_delta_rbound(d, size):
+    """Truncate the given delta to the given size
+    :param size: size relative to our target offset, may not be 0, must be smaller or equal
+        to our size
+    :return: d"""
+    d.ts = size
+
+    # NOTE: data is truncated automatically when applying the delta
+    # MUST NOT DO THIS HERE
+    return d
+
+
+def _move_delta_lbound(d, bytes):
+    """Move the delta by the given amount of bytes, reducing its size so that its
+    right bound stays static
+    :param bytes: amount of bytes to move, must be smaller than delta size
+    :return: d"""
+    if bytes == 0:
+        return
+
+    d.to += bytes
+    d.so += bytes
+    d.ts -= bytes
+    if d.data is not None:
+        d.data = d.data[bytes:]
+    # END handle data
+
+    return d
+
+
+def delta_duplicate(src):
+    return DeltaChunk(src.to, src.ts, src.so, src.data)
+
+
+def delta_chunk_apply(dc, bbuf, write):
+    """Apply own data to the target buffer
+    :param bbuf: buffer providing source bytes for copy operations
+    :param write: write method to call with data to write"""
+    if dc.data is None:
+        # COPY DATA FROM SOURCE
+        write(bbuf[dc.so:dc.so + dc.ts])
+    else:
+        # APPEND DATA
+        # what's faster: if + 4 function calls or just a write with a slice ?
+        # Considering data can be larger than 127 bytes now, it should be worth it
+        if dc.ts < len(dc.data):
+            write(dc.data[:dc.ts])
+        else:
+            write(dc.data)
+        # END handle truncation
+    # END handle chunk mode
+
+
+class DeltaChunk:
+
+    """Represents a piece of a delta, it can either add new data, or copy existing
+    one from a source buffer"""
+    __slots__ = (
+        'to',       # start offset in the target buffer in bytes
+                    'ts',       # size of this chunk in the target buffer in bytes
+                    'so',       # start offset in the source buffer in bytes or None
+                    'data',     # chunk of bytes to be added to the target buffer,
+                                # DeltaChunkList to use as base, or None
+    )
+
+    def __init__(self, to, ts, so, data):
+        self.to = to
+        self.ts = ts
+        self.so = so
+        self.data = data
+
+    def __repr__(self):
+        return "DeltaChunk(%i, %i, %s, %s)" % (self.to, self.ts, self.so, self.data or "")
+
+    #{ Interface
+
+    def rbound(self):
+        return self.to + self.ts
+
+    def has_data(self):
+        """:return: True if the instance has data to add to the target stream"""
+        return self.data is not None
+
+    #} END interface
+
+
+def _closest_index(dcl, absofs):
+    """:return: index at which the given absofs should be inserted. The index points
+    to the DeltaChunk with a target buffer absofs that equals or is greater than
+    absofs.
+    **Note:** global method for performance only, it belongs to DeltaChunkList"""
+    lo = 0
+    hi = len(dcl)
+    while lo < hi:
+        mid = (lo + hi) / 2
+        dc = dcl[mid]
+        if dc.to > absofs:
+            hi = mid
+        elif dc.rbound() > absofs or dc.to == absofs:
+            return mid
+        else:
+            lo = mid + 1
+        # END handle bound
+    # END for each delta absofs
+    return len(dcl) - 1
+
+
+def delta_list_apply(dcl, bbuf, write):
+    """Apply the chain's changes and write the final result using the passed
+    write function.
+    :param bbuf: base buffer containing the base of all deltas contained in this
+        list. It will only be used if the chunk in question does not have a base
+        chain.
+    :param write: function taking a string of bytes to write to the output"""
+    for dc in dcl:
+        delta_chunk_apply(dc, bbuf, write)
+    # END for each dc
+
+
+def delta_list_slice(dcl, absofs, size, ndcl):
+    """:return: Subsection of this  list at the given absolute  offset, with the given
+        size in bytes.
+    :return: None"""
+    cdi = _closest_index(dcl, absofs)   # delta start index
+    cd = dcl[cdi]
+    slen = len(dcl)
+    lappend = ndcl.append
+
+    if cd.to != absofs:
+        tcd = DeltaChunk(cd.to, cd.ts, cd.so, cd.data)
+        _move_delta_lbound(tcd, absofs - cd.to)
+        tcd.ts = min(tcd.ts, size)
+        lappend(tcd)
+        size -= tcd.ts
+        cdi += 1
+    # END lbound overlap handling
+
+    while cdi < slen and size:
+        # are we larger than the current block
+        cd = dcl[cdi]
+        if cd.ts <= size:
+            lappend(DeltaChunk(cd.to, cd.ts, cd.so, cd.data))
+            size -= cd.ts
+        else:
+            tcd = DeltaChunk(cd.to, cd.ts, cd.so, cd.data)
+            tcd.ts = size
+            lappend(tcd)
+            size -= tcd.ts
+            break
+        # END hadle size
+        cdi += 1
+    # END for each chunk
+
+
+class DeltaChunkList(list):
+
+    """List with special functionality to deal with DeltaChunks.
+    There are two types of lists we represent. The one was created bottom-up, working
+    towards the latest delta, the other kind was created top-down, working from the
+    latest delta down to the earliest ancestor. This attribute is queryable
+    after all processing with is_reversed."""
+
+    __slots__ = tuple()
+
+    def rbound(self):
+        """:return: rightmost extend in bytes, absolute"""
+        if len(self) == 0:
+            return 0
+        return self[-1].rbound()
+
+    def lbound(self):
+        """:return: leftmost byte at which this chunklist starts"""
+        if len(self) == 0:
+            return 0
+        return self[0].to
+
+    def size(self):
+        """:return: size of bytes as measured by our delta chunks"""
+        return self.rbound() - self.lbound()
+
+    def apply(self, bbuf, write):
+        """Only used by public clients, internally we only use the global routines
+        for performance"""
+        return delta_list_apply(self, bbuf, write)
+
+    def compress(self):
+        """Alter the list to reduce the amount of nodes. Currently we concatenate
+        add-chunks
+        :return: self"""
+        slen = len(self)
+        if slen < 2:
+            return self
+        i = 0
+
+        first_data_index = None
+        while i < slen:
+            dc = self[i]
+            i += 1
+            if dc.data is None:
+                if first_data_index is not None and i - 2 - first_data_index > 1:
+                    # if first_data_index is not None:
+                    nd = StringIO()                     # new data
+                    so = self[first_data_index].to      # start offset in target buffer
+                    for x in range(first_data_index, i - 1):
+                        xdc = self[x]
+                        nd.write(xdc.data[:xdc.ts])
+                    # END collect data
+
+                    del(self[first_data_index:i - 1])
+                    buf = nd.getvalue()
+                    self.insert(first_data_index, DeltaChunk(so, len(buf), 0, buf))
+
+                    slen = len(self)
+                    i = first_data_index + 1
+
+                # END concatenate data
+                first_data_index = None
+                continue
+            # END skip non-data chunks
+
+            if first_data_index is None:
+                first_data_index = i - 1
+        # END iterate list
+
+        # if slen_orig != len(self):
+        #   print "INFO: Reduced delta list len to %f %% of former size" % ((float(len(self)) / slen_orig) * 100)
+        return self
+
+    def check_integrity(self, target_size=-1):
+        """Verify the list has non-overlapping chunks only, and the total size matches
+        target_size
+        :param target_size: if not -1, the total size of the chain must be target_size
+        :raise AssertionError: if the size doesn't match"""
+        if target_size > -1:
+            assert self[-1].rbound() == target_size
+            assert reduce(lambda x, y: x + y, (d.ts for d in self), 0) == target_size
+        # END target size verification
+
+        if len(self) < 2:
+            return
+
+        # check data
+        for dc in self:
+            assert dc.ts > 0
+            if dc.has_data():
+                assert len(dc.data) >= dc.ts
+        # END for each dc
+
+        left = islice(self, 0, len(self) - 1)
+        right = iter(self)
+        right.next()
+        # this is very pythonic - we might have just use index based access here,
+        # but this could actually be faster
+        for lft, rgt in zip(left, right):
+            assert lft.rbound() == rgt.to
+            assert lft.to + lft.ts == rgt.to
+        # END for each pair
+
+
+class TopdownDeltaChunkList(DeltaChunkList):
+
+    """Represents a list which is generated by feeding its ancestor streams one by
+    one"""
+    __slots__ = tuple()
+
+    def connect_with_next_base(self, bdcl):
+        """Connect this chain with the next level of our base delta chunklist.
+        The goal in this game is to mark as many of our chunks rigid, hence they
+        cannot be changed by any of the upcoming bases anymore. Once all our
+        chunks are marked like that, we can stop all processing
+        :param bdcl: data chunk list being one of our bases. They must be fed in
+            consecutively and in order, towards the earliest ancestor delta
+        :return: True if processing was done. Use it to abort processing of
+            remaining streams if False is returned"""
+        nfc = 0                             # number of frozen chunks
+        dci = 0                             # delta chunk index
+        slen = len(self)                    # len of self
+        ccl = list()                        # temporary list
+        while dci < slen:
+            dc = self[dci]
+            dci += 1
+
+            # all add-chunks which are already topmost don't need additional processing
+            if dc.data is not None:
+                nfc += 1
+                continue
+            # END skip add chunks
+
+            # copy chunks
+            # integrate the portion of the base list into ourselves. Lists
+            # dont support efficient insertion ( just one at a time ), but for now
+            # we live with it. Internally, its all just a 32/64bit pointer, and
+            # the portions of moved memory should be smallish. Maybe we just rebuild
+            # ourselves in order to reduce the amount of insertions ...
+            del(ccl[:])
+            delta_list_slice(bdcl, dc.so, dc.ts, ccl)
+
+            # move the target bounds into place to match with our chunk
+            ofs = dc.to - dc.so
+            for cdc in ccl:
+                cdc.to += ofs
+            # END update target bounds
+
+            if len(ccl) == 1:
+                self[dci - 1] = ccl[0]
+            else:
+                # maybe try to compute the expenses here, and pick the right algorithm
+                # It would normally be faster than copying everything physically though
+                # TODO: Use a deque here, and decide by the index whether to extend
+                # or extend left !
+                post_dci = self[dci:]
+                del(self[dci - 1:])           # include deletion of dc
+                self.extend(ccl)
+                self.extend(post_dci)
+
+                slen = len(self)
+                dci += len(ccl) - 1           # deleted dc, added rest
+
+            # END handle chunk replacement
+        # END for each chunk
+
+        if nfc == slen:
+            return False
+        # END handle completeness
+        return True
+
+
+#} END structures
+
+#{ Routines
+
+def is_loose_object(m):
+    """
+    :return: True the file contained in memory map m appears to be a loose object.
+        Only the first two bytes are needed"""
+    b0, b1 = map(ord, m[:2])
+    word = (b0 << 8) + b1
+    return b0 == 0x78 and (word % 31) == 0
+
+
+def loose_object_header_info(m):
+    """
+    :return: tuple(type_string, uncompressed_size_in_bytes) the type string of the
+        object as well as its uncompressed size in bytes.
+    :param m: memory map from which to read the compressed object data"""
+    decompress_size = 8192      # is used in cgit as well
+    hdr = decompressobj().decompress(m, decompress_size)
+    type_name, size = hdr[:hdr.find(NULL_BYTE)].split(BYTE_SPACE)
+
+    return type_name, int(size)
+
+
+def pack_object_header_info(data):
+    """
+    :return: tuple(type_id, uncompressed_size_in_bytes, byte_offset)
+        The type_id should be interpreted according to the ``type_id_to_type_map`` map
+        The byte-offset specifies the start of the actual zlib compressed datastream
+    :param m: random-access memory, like a string or memory map"""
+    c = byte_ord(data[0])           # first byte
+    i = 1                           # next char to read
+    type_id = (c >> 4) & 7          # numeric type
+    size = c & 15                   # starting size
+    s = 4                           # starting bit-shift size
+    while c & 0x80:
+        c = byte_ord(data[i])
+        i += 1
+        size += (c & 0x7f) << s
+        s += 7
+    # END character loop
+    # end performance at expense of maintenance ...
+    return (type_id, size, i)
+
+
+def create_pack_object_header(obj_type, obj_size):
+    """
+    :return: string defining the pack header comprised of the object type
+        and its incompressed size in bytes
+
+    :param obj_type: pack type_id of the object
+    :param obj_size: uncompressed size in bytes of the following object stream"""
+    c = 0       # 1 byte
+    hdr = bytearray()  # output string
+
+    c = (obj_type << 4) | (obj_size & 0xf)
+    obj_size >>= 4
+    while obj_size:
+        hdr.append(c | 0x80)
+        c = obj_size & 0x7f
+        obj_size >>= 7
+    # END until size is consumed
+    hdr.append(c)
+    # end handle interpreter
+    return hdr
+
+
+def msb_size(data, offset=0):
+    """
+    :return: tuple(read_bytes, size) read the msb size from the given random
+        access data starting at the given byte offset"""
+    size = 0
+    i = 0
+    l = len(data)
+    hit_msb = False
+    while i < l:
+        c = data[i + offset]
+        size |= (c & 0x7f) << i * 7
+        i += 1
+        if not c & 0x80:
+            hit_msb = True
+            break
+        # END check msb bit
+    # END while in range
+    # end performance ...
+    if not hit_msb:
+        raise AssertionError("Could not find terminating MSB byte in data stream")
+    return i + offset, size
+
+
+def loose_object_header(type, size):
+    """
+    :return: bytes representing the loose object header, which is immediately
+        followed by the content stream of size 'size'"""
+    return ('%s %i\0' % (force_text(type), size)).encode('ascii')
+
+
+def write_object(type, size, read, write, chunk_size=chunk_size):
+    """
+    Write the object as identified by type, size and source_stream into the
+    target_stream
+
+    :param type: type string of the object
+    :param size: amount of bytes to write from source_stream
+    :param read: read method of a stream providing the content data
+    :param write: write method of the output stream
+    :param close_target_stream: if True, the target stream will be closed when
+        the routine exits, even if an error is thrown
+    :return: The actual amount of bytes written to stream, which includes the header and a trailing newline"""
+    tbw = 0                                             # total num bytes written
+
+    # WRITE HEADER: type SP size NULL
+    tbw += write(loose_object_header(type, size))
+    tbw += stream_copy(read, write, size, chunk_size)
+
+    return tbw
+
+
+def stream_copy(read, write, size, chunk_size):
+    """
+    Copy a stream up to size bytes using the provided read and write methods,
+    in chunks of chunk_size
+
+    **Note:** its much like stream_copy utility, but operates just using methods"""
+    dbw = 0                                             # num data bytes written
+
+    # WRITE ALL DATA UP TO SIZE
+    while True:
+        cs = min(chunk_size, size - dbw)
+        # NOTE: not all write methods return the amount of written bytes, like
+        # mmap.write. Its bad, but we just deal with it ... perhaps its not
+        # even less efficient
+        # data_len = write(read(cs))
+        # dbw += data_len
+        data = read(cs)
+        data_len = len(data)
+        dbw += data_len
+        write(data)
+        if data_len < cs or dbw == size:
+            break
+        # END check for stream end
+    # END duplicate data
+    return dbw
+
+
+def connect_deltas(dstreams):
+    """
+    Read the condensed delta chunk information from dstream and merge its information
+        into a list of existing delta chunks
+
+    :param dstreams: iterable of delta stream objects, the delta to be applied last
+        comes first, then all its ancestors in order
+    :return: DeltaChunkList, containing all operations to apply"""
+    tdcl = None                         # topmost dcl
+
+    dcl = tdcl = TopdownDeltaChunkList()
+    for dsi, ds in enumerate(dstreams):
+        # print "Stream", dsi
+        db = ds.read()
+        delta_buf_size = ds.size
+
+        # read header
+        i, base_size = msb_size(db)
+        i, target_size = msb_size(db, i)
+
+        # interpret opcodes
+        tbw = 0                     # amount of target bytes written
+        while i < delta_buf_size:
+            c = ord(db[i])
+            i += 1
+            if c & 0x80:
+                cp_off, cp_size = 0, 0
+                if (c & 0x01):
+                    cp_off = ord(db[i])
+                    i += 1
+                if (c & 0x02):
+                    cp_off |= (ord(db[i]) << 8)
+                    i += 1
+                if (c & 0x04):
+                    cp_off |= (ord(db[i]) << 16)
+                    i += 1
+                if (c & 0x08):
+                    cp_off |= (ord(db[i]) << 24)
+                    i += 1
+                if (c & 0x10):
+                    cp_size = ord(db[i])
+                    i += 1
+                if (c & 0x20):
+                    cp_size |= (ord(db[i]) << 8)
+                    i += 1
+                if (c & 0x40):
+                    cp_size |= (ord(db[i]) << 16)
+                    i += 1
+
+                if not cp_size:
+                    cp_size = 0x10000
+
+                rbound = cp_off + cp_size
+                if (rbound < cp_size or
+                        rbound > base_size):
+                    break
+
+                dcl.append(DeltaChunk(tbw, cp_size, cp_off, None))
+                tbw += cp_size
+            elif c:
+                # NOTE: in C, the data chunks should probably be concatenated here.
+                # In python, we do it as a post-process
+                dcl.append(DeltaChunk(tbw, c, 0, db[i:i + c]))
+                i += c
+                tbw += c
+            else:
+                raise ValueError("unexpected delta opcode 0")
+            # END handle command byte
+        # END while processing delta data
+
+        dcl.compress()
+
+        # merge the lists !
+        if dsi > 0:
+            if not tdcl.connect_with_next_base(dcl):
+                break
+        # END handle merge
+
+        # prepare next base
+        dcl = DeltaChunkList()
+    # END for each delta stream
+
+    return tdcl
+
+
+def apply_delta_data(src_buf, src_buf_size, delta_buf, delta_buf_size, write):
+    """
+    Apply data from a delta buffer using a source buffer to the target file
+
+    :param src_buf: random access data from which the delta was created
+    :param src_buf_size: size of the source buffer in bytes
+    :param delta_buf_size: size for the delta buffer in bytes
+    :param delta_buf: random access delta data
+    :param write: write method taking a chunk of bytes
+
+    **Note:** transcribed to python from the similar routine in patch-delta.c"""
+    i = 0
+    db = delta_buf
+    while i < delta_buf_size:
+        c = db[i]
+        i += 1
+        if c & 0x80:
+            cp_off, cp_size = 0, 0
+            if (c & 0x01):
+                cp_off = db[i]
+                i += 1
+            if (c & 0x02):
+                cp_off |= (db[i] << 8)
+                i += 1
+            if (c & 0x04):
+                cp_off |= (db[i] << 16)
+                i += 1
+            if (c & 0x08):
+                cp_off |= (db[i] << 24)
+                i += 1
+            if (c & 0x10):
+                cp_size = db[i]
+                i += 1
+            if (c & 0x20):
+                cp_size |= (db[i] << 8)
+                i += 1
+            if (c & 0x40):
+                cp_size |= (db[i] << 16)
+                i += 1
+
+            if not cp_size:
+                cp_size = 0x10000
+
+            rbound = cp_off + cp_size
+            if (rbound < cp_size or
+                    rbound > src_buf_size):
+                break
+            write(src_buf[cp_off:cp_off + cp_size])
+        elif c:
+            write(db[i:i + c])
+            i += c
+        else:
+            raise ValueError("unexpected delta opcode 0")
+        # END handle command byte
+    # END while processing delta data
+
+    # yes, lets use the exact same error message that git uses :)
+    assert i == delta_buf_size, "delta replay has gone wild"
+
+
+def is_equal_canonical_sha(canonical_length, match, sha1):
+    """
+    :return: True if the given lhs and rhs 20 byte binary shas
+        The comparison will take the canonical_length of the match sha into account,
+        hence the comparison will only use the last 4 bytes for uneven canonical representations
+    :param match: less than 20 byte sha
+    :param sha1: 20 byte sha"""
+    binary_length = canonical_length // 2
+    if match[:binary_length] != sha1[:binary_length]:
+        return False
+
+    if canonical_length - binary_length and \
+            (byte_ord(match[-1]) ^ byte_ord(sha1[len(match) - 1])) & 0xf0:
+        return False
+    # END handle uneven canonnical length
+    return True
+
+#} END routines
+
+
+try:
+    from gitdb_speedups._perf import connect_deltas
+except ImportError:
+    pass
diff --git a/llm/Lib/site-packages/gitdb/pack.py b/llm/Lib/site-packages/gitdb/pack.py
new file mode 100644
index 0000000000000000000000000000000000000000..e559e113d4d31135fa72c39d4b5f189997ab211c
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/pack.py
@@ -0,0 +1,1031 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Contains PackIndexFile and PackFile implementations"""
+import zlib
+
+from gitdb.exc import (
+    BadObject,
+    AmbiguousObjectName,
+    UnsupportedOperation,
+    ParseError
+)
+
+from gitdb.util import (
+    mman,
+    LazyMixin,
+    unpack_from,
+    bin_to_hex,
+    byte_ord,
+)
+
+from gitdb.fun import (
+    create_pack_object_header,
+    pack_object_header_info,
+    is_equal_canonical_sha,
+    type_id_to_type_map,
+    write_object,
+    stream_copy,
+    chunk_size,
+    delta_types,
+    OFS_DELTA,
+    REF_DELTA,
+    msb_size
+)
+
+try:
+    from gitdb_speedups._perf import PackIndexFile_sha_to_index
+except ImportError:
+    pass
+# END try c module
+
+from gitdb.base import (      # Amazing !
+    OInfo,
+    OStream,
+    OPackInfo,
+    OPackStream,
+    ODeltaStream,
+    ODeltaPackInfo,
+    ODeltaPackStream,
+)
+
+from gitdb.stream import (
+    DecompressMemMapReader,
+    DeltaApplyReader,
+    Sha1Writer,
+    NullStream,
+    FlexibleSha1Writer
+)
+
+from struct import pack
+from binascii import crc32
+
+from gitdb.const import NULL_BYTE
+
+import tempfile
+import array
+import os
+import sys
+
+__all__ = ('PackIndexFile', 'PackFile', 'PackEntity')
+
+
+#{ Utilities
+
+def pack_object_at(cursor, offset, as_stream):
+    """
+    :return: Tuple(abs_data_offset, PackInfo|PackStream)
+        an object of the correct type according to the type_id  of the object.
+        If as_stream is True, the object will contain a stream, allowing  the
+        data to be read decompressed.
+    :param data: random accessible data containing all required information
+    :parma offset: offset in to the data at which the object information is located
+    :param as_stream: if True, a stream object will be returned that can read
+        the data, otherwise you receive an info object only"""
+    data = cursor.use_region(offset).buffer()
+    type_id, uncomp_size, data_rela_offset = pack_object_header_info(data)
+    total_rela_offset = None                # set later, actual offset until data stream begins
+    delta_info = None
+
+    # OFFSET DELTA
+    if type_id == OFS_DELTA:
+        i = data_rela_offset
+        c = byte_ord(data[i])
+        i += 1
+        delta_offset = c & 0x7f
+        while c & 0x80:
+            c = byte_ord(data[i])
+            i += 1
+            delta_offset += 1
+            delta_offset = (delta_offset << 7) + (c & 0x7f)
+        # END character loop
+        delta_info = delta_offset
+        total_rela_offset = i
+    # REF DELTA
+    elif type_id == REF_DELTA:
+        total_rela_offset = data_rela_offset + 20
+        delta_info = data[data_rela_offset:total_rela_offset]
+    # BASE OBJECT
+    else:
+        # assume its a base object
+        total_rela_offset = data_rela_offset
+    # END handle type id
+    abs_data_offset = offset + total_rela_offset
+    if as_stream:
+        stream = DecompressMemMapReader(data[total_rela_offset:], False, uncomp_size)
+        if delta_info is None:
+            return abs_data_offset, OPackStream(offset, type_id, uncomp_size, stream)
+        else:
+            return abs_data_offset, ODeltaPackStream(offset, type_id, uncomp_size, delta_info, stream)
+    else:
+        if delta_info is None:
+            return abs_data_offset, OPackInfo(offset, type_id, uncomp_size)
+        else:
+            return abs_data_offset, ODeltaPackInfo(offset, type_id, uncomp_size, delta_info)
+        # END handle info
+    # END handle stream
+
+
+def write_stream_to_pack(read, write, zstream, base_crc=None):
+    """Copy a stream as read from read function, zip it, and write the result.
+    Count the number of written bytes and return it
+    :param base_crc: if not None, the crc will be the base for all compressed data
+        we consecutively write and generate a crc32 from. If None, no crc will be generated
+    :return: tuple(no bytes read, no bytes written, crc32) crc might be 0 if base_crc
+        was false"""
+    br = 0      # bytes read
+    bw = 0      # bytes written
+    want_crc = base_crc is not None
+    crc = 0
+    if want_crc:
+        crc = base_crc
+    # END initialize crc
+
+    while True:
+        chunk = read(chunk_size)
+        br += len(chunk)
+        compressed = zstream.compress(chunk)
+        bw += len(compressed)
+        write(compressed)           # cannot assume return value
+
+        if want_crc:
+            crc = crc32(compressed, crc)
+        # END handle crc
+
+        if len(chunk) != chunk_size:
+            break
+    # END copy loop
+
+    compressed = zstream.flush()
+    bw += len(compressed)
+    write(compressed)
+    if want_crc:
+        crc = crc32(compressed, crc)
+    # END handle crc
+
+    return (br, bw, crc)
+
+
+#} END utilities
+
+
+class IndexWriter:
+
+    """Utility to cache index information, allowing to write all information later
+    in one go to the given stream
+    **Note:** currently only writes v2 indices"""
+    __slots__ = '_objs'
+
+    def __init__(self):
+        self._objs = list()
+
+    def append(self, binsha, crc, offset):
+        """Append one piece of object information"""
+        self._objs.append((binsha, crc, offset))
+
+    def write(self, pack_sha, write):
+        """Write the index file using the given write method
+        :param pack_sha: binary sha over the whole pack that we index
+        :return: sha1 binary sha over all index file contents"""
+        # sort for sha1 hash
+        self._objs.sort(key=lambda o: o[0])
+
+        sha_writer = FlexibleSha1Writer(write)
+        sha_write = sha_writer.write
+        sha_write(PackIndexFile.index_v2_signature)
+        sha_write(pack(">L", PackIndexFile.index_version_default))
+
+        # fanout
+        tmplist = list((0,) * 256)                                # fanout or list with 64 bit offsets
+        for t in self._objs:
+            tmplist[byte_ord(t[0][0])] += 1
+        # END prepare fanout
+        for i in range(255):
+            v = tmplist[i]
+            sha_write(pack('>L', v))
+            tmplist[i + 1] += v
+        # END write each fanout entry
+        sha_write(pack('>L', tmplist[255]))
+
+        # sha1 ordered
+        # save calls, that is push them into c
+        sha_write(b''.join(t[0] for t in self._objs))
+
+        # crc32
+        for t in self._objs:
+            sha_write(pack('>L', t[1] & 0xffffffff))
+        # END for each crc
+
+        tmplist = list()
+        # offset 32
+        for t in self._objs:
+            ofs = t[2]
+            if ofs > 0x7fffffff:
+                tmplist.append(ofs)
+                ofs = 0x80000000 + len(tmplist) - 1
+            # END handle 64 bit offsets
+            sha_write(pack('>L', ofs & 0xffffffff))
+        # END for each offset
+
+        # offset 64
+        for ofs in tmplist:
+            sha_write(pack(">Q", ofs))
+        # END for each offset
+
+        # trailer
+        assert(len(pack_sha) == 20)
+        sha_write(pack_sha)
+        sha = sha_writer.sha(as_hex=False)
+        write(sha)
+        return sha
+
+
+class PackIndexFile(LazyMixin):
+
+    """A pack index provides offsets into the corresponding pack, allowing to find
+    locations for offsets faster."""
+
+    # Dont use slots as we dynamically bind functions for each version, need a dict for this
+    # The slots you see here are just to keep track of our instance variables
+    # __slots__ = ('_indexpath', '_fanout_table', '_cursor', '_version',
+    #               '_sha_list_offset', '_crc_list_offset', '_pack_offset', '_pack_64_offset')
+
+    # used in v2 indices
+    _sha_list_offset = 8 + 1024
+    index_v2_signature = b'\xfftOc'
+    index_version_default = 2
+
+    def __init__(self, indexpath):
+        super().__init__()
+        self._indexpath = indexpath
+
+    def close(self):
+        mman.force_map_handle_removal_win(self._indexpath)
+        self._cursor = None
+
+    def _set_cache_(self, attr):
+        if attr == "_packfile_checksum":
+            self._packfile_checksum = self._cursor.map()[-40:-20]
+        elif attr == "_packfile_checksum":
+            self._packfile_checksum = self._cursor.map()[-20:]
+        elif attr == "_cursor":
+            # Note: We don't lock the file when reading as we cannot be sure
+            # that we can actually write to the location - it could be a read-only
+            # alternate for instance
+            self._cursor = mman.make_cursor(self._indexpath).use_region()
+            # We will assume that the index will always fully fit into memory !
+            if mman.window_size() > 0 and self._cursor.file_size() > mman.window_size():
+                raise AssertionError("The index file at %s is too large to fit into a mapped window (%i > %i). This is a limitation of the implementation" % (
+                    self._indexpath, self._cursor.file_size(), mman.window_size()))
+            # END assert window size
+        else:
+            # now its time to initialize everything - if we are here, someone wants
+            # to access the fanout table or related properties
+
+            # CHECK VERSION
+            mmap = self._cursor.map()
+            self._version = (mmap[:4] == self.index_v2_signature and 2) or 1
+            if self._version == 2:
+                version_id = unpack_from(">L", mmap, 4)[0]
+                assert version_id == self._version, "Unsupported index version: %i" % version_id
+            # END assert version
+
+            # SETUP FUNCTIONS
+            # setup our functions according to the actual version
+            for fname in ('entry', 'offset', 'sha', 'crc'):
+                setattr(self, fname, getattr(self, "_%s_v%i" % (fname, self._version)))
+            # END for each function to initialize
+
+            # INITIALIZE DATA
+            # byte offset is 8 if version is 2, 0 otherwise
+            self._initialize()
+        # END handle attributes
+
+    #{ Access V1
+
+    def _entry_v1(self, i):
+        """:return: tuple(offset, binsha, 0)"""
+        return unpack_from(">L20s", self._cursor.map(), 1024 + i * 24) + (0, )
+
+    def _offset_v1(self, i):
+        """see ``_offset_v2``"""
+        return unpack_from(">L", self._cursor.map(), 1024 + i * 24)[0]
+
+    def _sha_v1(self, i):
+        """see ``_sha_v2``"""
+        base = 1024 + (i * 24) + 4
+        return self._cursor.map()[base:base + 20]
+
+    def _crc_v1(self, i):
+        """unsupported"""
+        return 0
+
+    #} END access V1
+
+    #{ Access V2
+    def _entry_v2(self, i):
+        """:return: tuple(offset, binsha, crc)"""
+        return (self._offset_v2(i), self._sha_v2(i), self._crc_v2(i))
+
+    def _offset_v2(self, i):
+        """:return: 32 or 64 byte offset into pack files. 64 byte offsets will only
+            be returned if the pack is larger than 4 GiB, or 2^32"""
+        offset = unpack_from(">L", self._cursor.map(), self._pack_offset + i * 4)[0]
+
+        # if the high-bit is set, this indicates that we have to lookup the offset
+        # in the 64 bit region of the file. The current offset ( lower 31 bits )
+        # are the index into it
+        if offset & 0x80000000:
+            offset = unpack_from(">Q", self._cursor.map(), self._pack_64_offset + (offset & ~0x80000000) * 8)[0]
+        # END handle 64 bit offset
+
+        return offset
+
+    def _sha_v2(self, i):
+        """:return: sha at the given index of this file index instance"""
+        base = self._sha_list_offset + i * 20
+        return self._cursor.map()[base:base + 20]
+
+    def _crc_v2(self, i):
+        """:return: 4 bytes crc for the object at index i"""
+        return unpack_from(">L", self._cursor.map(), self._crc_list_offset + i * 4)[0]
+
+    #} END access V2
+
+    #{ Initialization
+
+    def _initialize(self):
+        """initialize base data"""
+        self._fanout_table = self._read_fanout((self._version == 2) * 8)
+
+        if self._version == 2:
+            self._crc_list_offset = self._sha_list_offset + self.size() * 20
+            self._pack_offset = self._crc_list_offset + self.size() * 4
+            self._pack_64_offset = self._pack_offset + self.size() * 4
+        # END setup base
+
+    def _read_fanout(self, byte_offset):
+        """Generate a fanout table from our data"""
+        d = self._cursor.map()
+        out = list()
+        append = out.append
+        for i in range(256):
+            append(unpack_from('>L', d, byte_offset + i * 4)[0])
+        # END for each entry
+        return out
+
+    #} END initialization
+
+    #{ Properties
+    def version(self):
+        return self._version
+
+    def size(self):
+        """:return: amount of objects referred to by this index"""
+        return self._fanout_table[255]
+
+    def path(self):
+        """:return: path to the packindexfile"""
+        return self._indexpath
+
+    def packfile_checksum(self):
+        """:return: 20 byte sha representing the sha1 hash of the pack file"""
+        return self._cursor.map()[-40:-20]
+
+    def indexfile_checksum(self):
+        """:return: 20 byte sha representing the sha1 hash of this index file"""
+        return self._cursor.map()[-20:]
+
+    def offsets(self):
+        """:return: sequence of all offsets in the order in which they were written
+
+        **Note:** return value can be random accessed, but may be immmutable"""
+        if self._version == 2:
+            # read stream to array, convert to tuple
+            a = array.array('I')    # 4 byte unsigned int, long are 8 byte on 64 bit it appears
+            a.frombytes(self._cursor.map()[self._pack_offset:self._pack_64_offset])
+
+            # networkbyteorder to something array likes more
+            if sys.byteorder == 'little':
+                a.byteswap()
+            return a
+        else:
+            return tuple(self.offset(index) for index in range(self.size()))
+        # END handle version
+
+    def sha_to_index(self, sha):
+        """
+        :return: index usable with the ``offset`` or ``entry`` method, or None
+            if the sha was not found in this pack index
+        :param sha: 20 byte sha to lookup"""
+        first_byte = byte_ord(sha[0])
+        get_sha = self.sha
+        lo = 0                  # lower index, the left bound of the bisection
+        if first_byte != 0:
+            lo = self._fanout_table[first_byte - 1]
+        hi = self._fanout_table[first_byte]     # the upper, right bound of the bisection
+
+        # bisect until we have the sha
+        while lo < hi:
+            mid = (lo + hi) // 2
+            mid_sha = get_sha(mid)
+            if sha < mid_sha:
+                hi = mid
+            elif sha == mid_sha:
+                return mid
+            else:
+                lo = mid + 1
+            # END handle midpoint
+        # END bisect
+        return None
+
+    def partial_sha_to_index(self, partial_bin_sha, canonical_length):
+        """
+        :return: index as in `sha_to_index` or None if the sha was not found in this
+            index file
+        :param partial_bin_sha: an at least two bytes of a partial binary sha as bytes
+        :param canonical_length: length of the original hexadecimal representation of the
+            given partial binary sha
+        :raise AmbiguousObjectName:"""
+        if len(partial_bin_sha) < 2:
+            raise ValueError("Require at least 2 bytes of partial sha")
+
+        assert isinstance(partial_bin_sha, bytes), "partial_bin_sha must be bytes"
+        first_byte = byte_ord(partial_bin_sha[0])
+
+        get_sha = self.sha
+        lo = 0                  # lower index, the left bound of the bisection
+        if first_byte != 0:
+            lo = self._fanout_table[first_byte - 1]
+        hi = self._fanout_table[first_byte]     # the upper, right bound of the bisection
+
+        # fill the partial to full 20 bytes
+        filled_sha = partial_bin_sha + NULL_BYTE * (20 - len(partial_bin_sha))
+
+        # find lowest
+        while lo < hi:
+            mid = (lo + hi) // 2
+            mid_sha = get_sha(mid)
+            if filled_sha < mid_sha:
+                hi = mid
+            elif filled_sha == mid_sha:
+                # perfect match
+                lo = mid
+                break
+            else:
+                lo = mid + 1
+            # END handle midpoint
+        # END bisect
+
+        if lo < self.size():
+            cur_sha = get_sha(lo)
+            if is_equal_canonical_sha(canonical_length, partial_bin_sha, cur_sha):
+                next_sha = None
+                if lo + 1 < self.size():
+                    next_sha = get_sha(lo + 1)
+                if next_sha and next_sha == cur_sha:
+                    raise AmbiguousObjectName(partial_bin_sha)
+                return lo
+            # END if we have a match
+        # END if we found something
+        return None
+
+    if 'PackIndexFile_sha_to_index' in globals():
+        # NOTE: Its just about 25% faster, the major bottleneck might be the attr
+        # accesses
+        def sha_to_index(self, sha):
+            return PackIndexFile_sha_to_index(self, sha)
+    # END redefine heavy-hitter with c version
+
+    #} END properties
+
+
+class PackFile(LazyMixin):
+
+    """A pack is a file written according to the Version 2 for git packs
+
+    As we currently use memory maps, it could be assumed that the maximum size of
+    packs therefore is 32 bit on 32 bit systems. On 64 bit systems, this should be
+    fine though.
+
+    **Note:** at some point, this might be implemented using streams as well, or
+    streams are an alternate path in the case memory maps cannot be created
+    for some reason - one clearly doesn't want to read 10GB at once in that
+    case"""
+
+    __slots__ = ('_packpath', '_cursor', '_size', '_version')
+    pack_signature = 0x5041434b     # 'PACK'
+    pack_version_default = 2
+
+    # offset into our data at which the first object starts
+    first_object_offset = 3 * 4       # header bytes
+    footer_size = 20                # final sha
+
+    def __init__(self, packpath):
+        self._packpath = packpath
+
+    def close(self):
+        mman.force_map_handle_removal_win(self._packpath)
+        self._cursor = None
+
+    def _set_cache_(self, attr):
+        # we fill the whole cache, whichever attribute gets queried first
+        self._cursor = mman.make_cursor(self._packpath).use_region()
+
+        # read the header information
+        type_id, self._version, self._size = unpack_from(">LLL", self._cursor.map(), 0)
+
+        # TODO: figure out whether we should better keep the lock, or maybe
+        # add a .keep file instead ?
+        if type_id != self.pack_signature:
+            raise ParseError("Invalid pack signature: %i" % type_id)
+
+    def _iter_objects(self, start_offset, as_stream=True):
+        """Handle the actual iteration of objects within this pack"""
+        c = self._cursor
+        content_size = c.file_size() - self.footer_size
+        cur_offset = start_offset or self.first_object_offset
+
+        null = NullStream()
+        while cur_offset < content_size:
+            data_offset, ostream = pack_object_at(c, cur_offset, True)
+            # scrub the stream to the end - this decompresses the object, but yields
+            # the amount of compressed bytes we need to get to the next offset
+
+            stream_copy(ostream.read, null.write, ostream.size, chunk_size)
+            assert ostream.stream._br == ostream.size
+            cur_offset += (data_offset - ostream.pack_offset) + ostream.stream.compressed_bytes_read()
+
+            # if a stream is requested, reset it beforehand
+            # Otherwise return the Stream object directly, its derived from the
+            # info object
+            if as_stream:
+                ostream.stream.seek(0)
+            yield ostream
+        # END until we have read everything
+
+    #{ Pack Information
+
+    def size(self):
+        """:return: The amount of objects stored in this pack"""
+        return self._size
+
+    def version(self):
+        """:return: the version of this pack"""
+        return self._version
+
+    def data(self):
+        """
+        :return: read-only data of this pack. It provides random access and usually
+            is a memory map.
+        :note: This method is unsafe as it returns a window into a file which might be larger than than the actual window size"""
+        # can use map as we are starting at offset 0. Otherwise we would have to use buffer()
+        return self._cursor.use_region().map()
+
+    def checksum(self):
+        """:return: 20 byte sha1 hash on all object sha's contained in this file"""
+        return self._cursor.use_region(self._cursor.file_size() - 20).buffer()[:]
+
+    def path(self):
+        """:return: path to the packfile"""
+        return self._packpath
+    #} END pack information
+
+    #{ Pack Specific
+
+    def collect_streams(self, offset):
+        """
+        :return: list of pack streams which are required to build the object
+            at the given offset. The first entry of the list is the object at offset,
+            the last one is either a full object, or a REF_Delta stream. The latter
+            type needs its reference object to be locked up in an ODB to form a valid
+            delta chain.
+            If the object at offset is no delta, the size of the list is 1.
+        :param offset: specifies the first byte of the object within this pack"""
+        out = list()
+        c = self._cursor
+        while True:
+            ostream = pack_object_at(c, offset, True)[1]
+            out.append(ostream)
+            if ostream.type_id == OFS_DELTA:
+                offset = ostream.pack_offset - ostream.delta_info
+            else:
+                # the only thing we can lookup are OFFSET deltas. Everything
+                # else is either an object, or a ref delta, in the latter
+                # case someone else has to find it
+                break
+            # END handle type
+        # END while chaining streams
+        return out
+
+    #} END pack specific
+
+    #{ Read-Database like Interface
+
+    def info(self, offset):
+        """Retrieve information about the object at the given file-absolute offset
+
+        :param offset: byte offset
+        :return: OPackInfo instance, the actual type differs depending on the type_id attribute"""
+        return pack_object_at(self._cursor, offset or self.first_object_offset, False)[1]
+
+    def stream(self, offset):
+        """Retrieve an object at the given file-relative offset as stream along with its information
+
+        :param offset: byte offset
+        :return: OPackStream instance, the actual type differs depending on the type_id attribute"""
+        return pack_object_at(self._cursor, offset or self.first_object_offset, True)[1]
+
+    def stream_iter(self, start_offset=0):
+        """
+        :return: iterator yielding OPackStream compatible instances, allowing
+            to access the data in the pack directly.
+        :param start_offset: offset to the first object to iterate. If 0, iteration
+            starts at the very first object in the pack.
+
+        **Note:** Iterating a pack directly is costly as the datastream has to be decompressed
+        to determine the bounds between the objects"""
+        return self._iter_objects(start_offset, as_stream=True)
+
+    #} END Read-Database like Interface
+
+
+class PackEntity(LazyMixin):
+
+    """Combines the PackIndexFile and the PackFile into one, allowing the
+    actual objects to be resolved and iterated"""
+
+    __slots__ = ('_index',           # our index file
+                 '_pack',            # our pack file
+                 '_offset_map'       # on demand dict mapping one offset to the next consecutive one
+                 )
+
+    IndexFileCls = PackIndexFile
+    PackFileCls = PackFile
+
+    def __init__(self, pack_or_index_path):
+        """Initialize ourselves with the path to the respective pack or index file"""
+        basename, ext = os.path.splitext(pack_or_index_path)
+        self._index = self.IndexFileCls("%s.idx" % basename)            # PackIndexFile instance
+        self._pack = self.PackFileCls("%s.pack" % basename)         # corresponding PackFile instance
+
+    def close(self):
+        self._index.close()
+        self._pack.close()
+
+    def _set_cache_(self, attr):
+        # currently this can only be _offset_map
+        # TODO: make this a simple sorted offset array which can be bisected
+        # to find the respective entry, from which we can take a +1 easily
+        # This might be slower, but should also be much lighter in memory !
+        offsets_sorted = sorted(self._index.offsets())
+        last_offset = len(self._pack.data()) - self._pack.footer_size
+        assert offsets_sorted, "Cannot handle empty indices"
+
+        offset_map = None
+        if len(offsets_sorted) == 1:
+            offset_map = {offsets_sorted[0]: last_offset}
+        else:
+            iter_offsets = iter(offsets_sorted)
+            iter_offsets_plus_one = iter(offsets_sorted)
+            next(iter_offsets_plus_one)
+            consecutive = zip(iter_offsets, iter_offsets_plus_one)
+
+            offset_map = dict(consecutive)
+
+            # the last offset is not yet set
+            offset_map[offsets_sorted[-1]] = last_offset
+        # END handle offset amount
+        self._offset_map = offset_map
+
+    def _sha_to_index(self, sha):
+        """:return: index for the given sha, or raise"""
+        index = self._index.sha_to_index(sha)
+        if index is None:
+            raise BadObject(sha)
+        return index
+
+    def _iter_objects(self, as_stream):
+        """Iterate over all objects in our index and yield their OInfo or OStream instences"""
+        _sha = self._index.sha
+        _object = self._object
+        for index in range(self._index.size()):
+            yield _object(_sha(index), as_stream, index)
+        # END for each index
+
+    def _object(self, sha, as_stream, index=-1):
+        """:return: OInfo or OStream object providing information about the given sha
+        :param index: if not -1, its assumed to be the sha's index in the IndexFile"""
+        # its a little bit redundant here, but it needs to be efficient
+        if index < 0:
+            index = self._sha_to_index(sha)
+        if sha is None:
+            sha = self._index.sha(index)
+        # END assure sha is present ( in output )
+        offset = self._index.offset(index)
+        type_id, uncomp_size, data_rela_offset = pack_object_header_info(self._pack._cursor.use_region(offset).buffer())
+        if as_stream:
+            if type_id not in delta_types:
+                packstream = self._pack.stream(offset)
+                return OStream(sha, packstream.type, packstream.size, packstream.stream)
+            # END handle non-deltas
+
+            # produce a delta stream containing all info
+            # To prevent it from applying the deltas when querying the size,
+            # we extract it from the delta stream ourselves
+            streams = self.collect_streams_at_offset(offset)
+            dstream = DeltaApplyReader.new(streams)
+
+            return ODeltaStream(sha, dstream.type, None, dstream)
+        else:
+            if type_id not in delta_types:
+                return OInfo(sha, type_id_to_type_map[type_id], uncomp_size)
+            # END handle non-deltas
+
+            # deltas are a little tougher - unpack the first bytes to obtain
+            # the actual target size, as opposed to the size of the delta data
+            streams = self.collect_streams_at_offset(offset)
+            buf = streams[0].read(512)
+            offset, src_size = msb_size(buf)
+            offset, target_size = msb_size(buf, offset)
+
+            # collect the streams to obtain the actual object type
+            if streams[-1].type_id in delta_types:
+                raise BadObject(sha, "Could not resolve delta object")
+            return OInfo(sha, streams[-1].type, target_size)
+        # END handle stream
+
+    #{ Read-Database like Interface
+
+    def info(self, sha):
+        """Retrieve information about the object identified by the given sha
+
+        :param sha: 20 byte sha1
+        :raise BadObject:
+        :return: OInfo instance, with 20 byte sha"""
+        return self._object(sha, False)
+
+    def stream(self, sha):
+        """Retrieve an object stream along with its information as identified by the given sha
+
+        :param sha: 20 byte sha1
+        :raise BadObject:
+        :return: OStream instance, with 20 byte sha"""
+        return self._object(sha, True)
+
+    def info_at_index(self, index):
+        """As ``info``, but uses a PackIndexFile compatible index to refer to the object"""
+        return self._object(None, False, index)
+
+    def stream_at_index(self, index):
+        """As ``stream``, but uses a PackIndexFile compatible index to refer to the
+        object"""
+        return self._object(None, True, index)
+
+    #} END Read-Database like Interface
+
+    #{ Interface
+
+    def pack(self):
+        """:return: the underlying pack file instance"""
+        return self._pack
+
+    def index(self):
+        """:return: the underlying pack index file instance"""
+        return self._index
+
+    def is_valid_stream(self, sha, use_crc=False):
+        """
+        Verify that the stream at the given sha is valid.
+
+        :param use_crc: if True, the index' crc is run over the compressed stream of
+            the object, which is much faster than checking the sha1. It is also
+            more prone to unnoticed corruption or manipulation.
+        :param sha: 20 byte sha1 of the object whose stream to verify
+            whether the compressed stream of the object is valid. If it is
+            a delta, this only verifies that the delta's data is valid, not the
+            data of the actual undeltified object, as it depends on more than
+            just this stream.
+            If False, the object will be decompressed and the sha generated. It must
+            match the given sha
+
+        :return: True if the stream is valid
+        :raise UnsupportedOperation: If the index is version 1 only
+        :raise BadObject: sha was not found"""
+        if use_crc:
+            if self._index.version() < 2:
+                raise UnsupportedOperation("Version 1 indices do not contain crc's, verify by sha instead")
+            # END handle index version
+
+            index = self._sha_to_index(sha)
+            offset = self._index.offset(index)
+            next_offset = self._offset_map[offset]
+            crc_value = self._index.crc(index)
+
+            # create the current crc value, on the compressed object data
+            # Read it in chunks, without copying the data
+            crc_update = zlib.crc32
+            pack_data = self._pack.data()
+            cur_pos = offset
+            this_crc_value = 0
+            while cur_pos < next_offset:
+                rbound = min(cur_pos + chunk_size, next_offset)
+                size = rbound - cur_pos
+                this_crc_value = crc_update(pack_data[cur_pos:cur_pos + size], this_crc_value)
+                cur_pos += size
+            # END window size loop
+
+            # crc returns signed 32 bit numbers, the AND op forces it into unsigned
+            # mode ... wow, sneaky, from dulwich.
+            return (this_crc_value & 0xffffffff) == crc_value
+        else:
+            shawriter = Sha1Writer()
+            stream = self._object(sha, as_stream=True)
+            # write a loose object, which is the basis for the sha
+            write_object(stream.type, stream.size, stream.read, shawriter.write)
+
+            assert shawriter.sha(as_hex=False) == sha
+            return shawriter.sha(as_hex=False) == sha
+        # END handle crc/sha verification
+        return True
+
+    def info_iter(self):
+        """
+        :return: Iterator over all objects in this pack. The iterator yields
+            OInfo instances"""
+        return self._iter_objects(as_stream=False)
+
+    def stream_iter(self):
+        """
+        :return: iterator over all objects in this pack. The iterator yields
+            OStream instances"""
+        return self._iter_objects(as_stream=True)
+
+    def collect_streams_at_offset(self, offset):
+        """
+        As the version in the PackFile, but can resolve REF deltas within this pack
+        For more info, see ``collect_streams``
+
+        :param offset: offset into the pack file at which the object can be found"""
+        streams = self._pack.collect_streams(offset)
+
+        # try to resolve the last one if needed. It is assumed to be either
+        # a REF delta, or a base object, as OFFSET deltas are resolved by the pack
+        if streams[-1].type_id == REF_DELTA:
+            stream = streams[-1]
+            while stream.type_id in delta_types:
+                if stream.type_id == REF_DELTA:
+                    # smmap can return memory view objects, which can't be compared as buffers/bytes can ...
+                    if isinstance(stream.delta_info, memoryview):
+                        sindex = self._index.sha_to_index(stream.delta_info.tobytes())
+                    else:
+                        sindex = self._index.sha_to_index(stream.delta_info)
+                    if sindex is None:
+                        break
+                    stream = self._pack.stream(self._index.offset(sindex))
+                    streams.append(stream)
+                else:
+                    # must be another OFS DELTA - this could happen if a REF
+                    # delta we resolve previously points to an OFS delta. Who
+                    # would do that ;) ? We can handle it though
+                    stream = self._pack.stream(stream.delta_info)
+                    streams.append(stream)
+                # END handle ref delta
+            # END resolve ref streams
+        # END resolve streams
+
+        return streams
+
+    def collect_streams(self, sha):
+        """
+        As ``PackFile.collect_streams``, but takes a sha instead of an offset.
+        Additionally, ref_delta streams will be resolved within this pack.
+        If this is not possible, the stream will be left alone, hence it is adivsed
+        to check for unresolved ref-deltas and resolve them before attempting to
+        construct a delta stream.
+
+        :param sha: 20 byte sha1 specifying the object whose related streams you want to collect
+        :return: list of streams, first being the actual object delta, the last being
+            a possibly unresolved base object.
+        :raise BadObject:"""
+        return self.collect_streams_at_offset(self._index.offset(self._sha_to_index(sha)))
+
+    @classmethod
+    def write_pack(cls, object_iter, pack_write, index_write=None,
+                   object_count=None, zlib_compression=zlib.Z_BEST_SPEED):
+        """
+        Create a new pack by putting all objects obtained by the object_iterator
+        into a pack which is written using the pack_write method.
+        The respective index is produced as well if index_write is not Non.
+
+        :param object_iter: iterator yielding odb output objects
+        :param pack_write: function to receive strings to write into the pack stream
+        :param indx_write: if not None, the function writes the index file corresponding
+            to the pack.
+        :param object_count: if you can provide the amount of objects in your iteration,
+            this would be the place to put it. Otherwise we have to pre-iterate and store
+            all items into a list to get the number, which uses more memory than necessary.
+        :param zlib_compression: the zlib compression level to use
+        :return: tuple(pack_sha, index_binsha) binary sha over all the contents of the pack
+            and over all contents of the index. If index_write was None, index_binsha will be None
+
+        **Note:** The destination of the write functions is up to the user. It could
+        be a socket, or a file for instance
+
+        **Note:** writes only undeltified objects"""
+        objs = object_iter
+        if not object_count:
+            if not isinstance(object_iter, (tuple, list)):
+                objs = list(object_iter)
+            # END handle list type
+            object_count = len(objs)
+        # END handle object
+
+        pack_writer = FlexibleSha1Writer(pack_write)
+        pwrite = pack_writer.write
+        ofs = 0                                         # current offset into the pack file
+        index = None
+        wants_index = index_write is not None
+
+        # write header
+        pwrite(pack('>LLL', PackFile.pack_signature, PackFile.pack_version_default, object_count))
+        ofs += 12
+
+        if wants_index:
+            index = IndexWriter()
+        # END handle index header
+
+        actual_count = 0
+        for obj in objs:
+            actual_count += 1
+            crc = 0
+
+            # object header
+            hdr = create_pack_object_header(obj.type_id, obj.size)
+            if index_write:
+                crc = crc32(hdr)
+            else:
+                crc = None
+            # END handle crc
+            pwrite(hdr)
+
+            # data stream
+            zstream = zlib.compressobj(zlib_compression)
+            ostream = obj.stream
+            br, bw, crc = write_stream_to_pack(ostream.read, pwrite, zstream, base_crc=crc)
+            assert(br == obj.size)
+            if wants_index:
+                index.append(obj.binsha, crc, ofs)
+            # END handle index
+
+            ofs += len(hdr) + bw
+            if actual_count == object_count:
+                break
+            # END abort once we are done
+        # END for each object
+
+        if actual_count != object_count:
+            raise ValueError(
+                "Expected to write %i objects into pack, but received only %i from iterators" % (object_count, actual_count))
+        # END count assertion
+
+        # write footer
+        pack_sha = pack_writer.sha(as_hex=False)
+        assert len(pack_sha) == 20
+        pack_write(pack_sha)
+        ofs += len(pack_sha)                            # just for completeness ;)
+
+        index_sha = None
+        if wants_index:
+            index_sha = index.write(pack_sha, index_write)
+        # END handle index
+
+        return pack_sha, index_sha
+
+    @classmethod
+    def create(cls, object_iter, base_dir, object_count=None, zlib_compression=zlib.Z_BEST_SPEED):
+        """Create a new on-disk entity comprised of a properly named pack file and a properly named
+        and corresponding index file. The pack contains all OStream objects contained in object iter.
+        :param base_dir: directory which is to contain the files
+        :return: PackEntity instance initialized with the new pack
+
+        **Note:** for more information on the other parameters see the write_pack method"""
+        pack_fd, pack_path = tempfile.mkstemp('', 'pack', base_dir)
+        index_fd, index_path = tempfile.mkstemp('', 'index', base_dir)
+        pack_write = lambda d: os.write(pack_fd, d)
+        index_write = lambda d: os.write(index_fd, d)
+
+        pack_binsha, index_binsha = cls.write_pack(object_iter, pack_write, index_write, object_count, zlib_compression)
+        os.close(pack_fd)
+        os.close(index_fd)
+
+        fmt = "pack-%s.%s"
+        new_pack_path = os.path.join(base_dir, fmt % (bin_to_hex(pack_binsha), 'pack'))
+        new_index_path = os.path.join(base_dir, fmt % (bin_to_hex(pack_binsha), 'idx'))
+        os.rename(pack_path, new_pack_path)
+        os.rename(index_path, new_index_path)
+
+        return cls(new_pack_path)
+
+    #} END interface
diff --git a/llm/Lib/site-packages/gitdb/stream.py b/llm/Lib/site-packages/gitdb/stream.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e0be84fd10f7173bb3dccea7a59cc6355909ffd
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/stream.py
@@ -0,0 +1,730 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+
+from io import BytesIO
+
+import mmap
+import os
+import sys
+import zlib
+
+from gitdb.fun import (
+    msb_size,
+    stream_copy,
+    apply_delta_data,
+    connect_deltas,
+    delta_types
+)
+
+from gitdb.util import (
+    allocate_memory,
+    LazyMixin,
+    make_sha,
+    write,
+    close,
+)
+
+from gitdb.const import NULL_BYTE, BYTE_SPACE
+from gitdb.utils.encoding import force_bytes
+
+has_perf_mod = False
+try:
+    from gitdb_speedups._perf import apply_delta as c_apply_delta
+    has_perf_mod = True
+except ImportError:
+    pass
+
+__all__ = ('DecompressMemMapReader', 'FDCompressedSha1Writer', 'DeltaApplyReader',
+           'Sha1Writer', 'FlexibleSha1Writer', 'ZippedStoreShaWriter', 'FDCompressedSha1Writer',
+           'FDStream', 'NullStream')
+
+
+#{ RO Streams
+
+class DecompressMemMapReader(LazyMixin):
+
+    """Reads data in chunks from a memory map and decompresses it. The client sees
+    only the uncompressed data, respective file-like read calls are handling on-demand
+    buffered decompression accordingly
+
+    A constraint on the total size of bytes is activated, simulating
+    a logical file within a possibly larger physical memory area
+
+    To read efficiently, you clearly don't want to read individual bytes, instead,
+    read a few kilobytes at least.
+
+    **Note:** The chunk-size should be carefully selected as it will involve quite a bit
+        of string copying due to the way the zlib is implemented. Its very wasteful,
+        hence we try to find a good tradeoff between allocation time and number of
+        times we actually allocate. An own zlib implementation would be good here
+        to better support streamed reading - it would only need to keep the mmap
+        and decompress it into chunks, that's all ... """
+    __slots__ = ('_m', '_zip', '_buf', '_buflen', '_br', '_cws', '_cwe', '_s', '_close',
+                 '_cbr', '_phi')
+
+    max_read_size = 512 * 1024        # currently unused
+
+    def __init__(self, m, close_on_deletion, size=None):
+        """Initialize with mmap for stream reading
+        :param m: must be content data - use new if you have object data and no size"""
+        self._m = m
+        self._zip = zlib.decompressobj()
+        self._buf = None                        # buffer of decompressed bytes
+        self._buflen = 0                        # length of bytes in buffer
+        if size is not None:
+            self._s = size                      # size of uncompressed data to read in total
+        self._br = 0                            # num uncompressed bytes read
+        self._cws = 0                           # start byte of compression window
+        self._cwe = 0                           # end byte of compression window
+        self._cbr = 0                           # number of compressed bytes read
+        self._phi = False                       # is True if we parsed the header info
+        self._close = close_on_deletion         # close the memmap on deletion ?
+
+    def _set_cache_(self, attr):
+        assert attr == '_s'
+        # only happens for size, which is a marker to indicate we still
+        # have to parse the header from the stream
+        self._parse_header_info()
+
+    def __del__(self):
+        self.close()
+
+    def _parse_header_info(self):
+        """If this stream contains object data, parse the header info and skip the
+        stream to a point where each read will yield object content
+
+        :return: parsed type_string, size"""
+        # read header
+        # should really be enough, cgit uses 8192 I believe
+        # And for good reason !! This needs to be that high for the header to be read correctly in all cases
+        maxb = 8192
+        self._s = maxb
+        hdr = self.read(maxb)
+        hdrend = hdr.find(NULL_BYTE)
+        typ, size = hdr[:hdrend].split(BYTE_SPACE)
+        size = int(size)
+        self._s = size
+
+        # adjust internal state to match actual header length that we ignore
+        # The buffer will be depleted first on future reads
+        self._br = 0
+        hdrend += 1
+        self._buf = BytesIO(hdr[hdrend:])
+        self._buflen = len(hdr) - hdrend
+
+        self._phi = True
+
+        return typ, size
+
+    #{ Interface
+
+    @classmethod
+    def new(self, m, close_on_deletion=False):
+        """Create a new DecompressMemMapReader instance for acting as a read-only stream
+        This method parses the object header from m and returns the parsed
+        type and size, as well as the created stream instance.
+
+        :param m: memory map on which to operate. It must be object data ( header + contents )
+        :param close_on_deletion: if True, the memory map will be closed once we are
+            being deleted"""
+        inst = DecompressMemMapReader(m, close_on_deletion, 0)
+        typ, size = inst._parse_header_info()
+        return typ, size, inst
+
+    def data(self):
+        """:return: random access compatible data we are working on"""
+        return self._m
+
+    def close(self):
+        """Close our underlying stream of compressed bytes if this was allowed during initialization
+        :return: True if we closed the underlying stream
+        :note: can be called safely
+        """
+        if self._close:
+            if hasattr(self._m, 'close'):
+                self._m.close()
+            self._close = False
+        # END handle resource freeing
+
+    def compressed_bytes_read(self):
+        """
+        :return: number of compressed bytes read. This includes the bytes it
+            took to decompress the header ( if there was one )"""
+        # ABSTRACT: When decompressing a byte stream, it can be that the first
+        # x bytes which were requested match the first x bytes in the loosely
+        # compressed datastream. This is the worst-case assumption that the reader
+        # does, it assumes that it will get at least X bytes from X compressed bytes
+        # in call cases.
+        # The caveat is that the object, according to our known uncompressed size,
+        # is already complete, but there are still some bytes left in the compressed
+        # stream that contribute to the amount of compressed bytes.
+        # How can we know that we are truly done, and have read all bytes we need
+        # to read ?
+        # Without help, we cannot know, as we need to obtain the status of the
+        # decompression. If it is not finished, we need to decompress more data
+        # until it is finished, to yield the actual number of compressed bytes
+        # belonging to the decompressed object
+        # We are using a custom zlib module for this, if its not present,
+        # we try to put in additional bytes up for decompression if feasible
+        # and check for the unused_data.
+
+        # Only scrub the stream forward if we are officially done with the
+        # bytes we were to have.
+        if self._br == self._s and not self._zip.unused_data:
+            # manipulate the bytes-read to allow our own read method to continue
+            # but keep the window at its current position
+            self._br = 0
+            if hasattr(self._zip, 'status'):
+                while self._zip.status == zlib.Z_OK:
+                    self.read(mmap.PAGESIZE)
+                # END scrub-loop custom zlib
+            else:
+                # pass in additional pages, until we have unused data
+                while not self._zip.unused_data and self._cbr != len(self._m):
+                    self.read(mmap.PAGESIZE)
+                # END scrub-loop default zlib
+            # END handle stream scrubbing
+
+            # reset bytes read, just to be sure
+            self._br = self._s
+        # END handle stream scrubbing
+
+        # unused data ends up in the unconsumed tail, which was removed
+        # from the count already
+        return self._cbr
+
+    #} END interface
+
+    def seek(self, offset, whence=getattr(os, 'SEEK_SET', 0)):
+        """Allows to reset the stream to restart reading
+        :raise ValueError: If offset and whence are not 0"""
+        if offset != 0 or whence != getattr(os, 'SEEK_SET', 0):
+            raise ValueError("Can only seek to position 0")
+        # END handle offset
+
+        self._zip = zlib.decompressobj()
+        self._br = self._cws = self._cwe = self._cbr = 0
+        if self._phi:
+            self._phi = False
+            del(self._s)        # trigger header parsing on first access
+        # END skip header
+
+    def read(self, size=-1):
+        if size < 1:
+            size = self._s - self._br
+        else:
+            size = min(size, self._s - self._br)
+        # END clamp size
+
+        if size == 0:
+            return b''
+        # END handle depletion
+
+        # deplete the buffer, then just continue using the decompress object
+        # which has an own buffer. We just need this to transparently parse the
+        # header from the zlib stream
+        dat = b''
+        if self._buf:
+            if self._buflen >= size:
+                # have enough data
+                dat = self._buf.read(size)
+                self._buflen -= size
+                self._br += size
+                return dat
+            else:
+                dat = self._buf.read()      # ouch, duplicates data
+                size -= self._buflen
+                self._br += self._buflen
+
+                self._buflen = 0
+                self._buf = None
+            # END handle buffer len
+        # END handle buffer
+
+        # decompress some data
+        # Abstract: zlib needs to operate on chunks of our memory map ( which may
+        # be large ), as it will otherwise and always fill in the 'unconsumed_tail'
+        # attribute which possible reads our whole map to the end, forcing
+        # everything to be read from disk even though just a portion was requested.
+        # As this would be a nogo, we workaround it by passing only chunks of data,
+        # moving the window into the memory map along as we decompress, which keeps
+        # the tail smaller than our chunk-size. This causes 'only' the chunk to be
+        # copied once, and another copy of a part of it when it creates the unconsumed
+        # tail. We have to use it to hand in the appropriate amount of bytes during
+        # the next read.
+        tail = self._zip.unconsumed_tail
+        if tail:
+            # move the window, make it as large as size demands. For code-clarity,
+            # we just take the chunk from our map again instead of reusing the unconsumed
+            # tail. The latter one would safe some memory copying, but we could end up
+            # with not getting enough data uncompressed, so we had to sort that out as well.
+            # Now we just assume the worst case, hence the data is uncompressed and the window
+            # needs to be as large as the uncompressed bytes we want to read.
+            self._cws = self._cwe - len(tail)
+            self._cwe = self._cws + size
+        else:
+            cws = self._cws
+            self._cws = self._cwe
+            self._cwe = cws + size
+        # END handle tail
+
+        # if window is too small, make it larger so zip can decompress something
+        if self._cwe - self._cws < 8:
+            self._cwe = self._cws + 8
+        # END adjust winsize
+
+        # takes a slice, but doesn't copy the data, it says ...
+        indata = self._m[self._cws:self._cwe]
+
+        # get the actual window end to be sure we don't use it for computations
+        self._cwe = self._cws + len(indata)
+        dcompdat = self._zip.decompress(indata, size)
+        # update the amount of compressed bytes read
+        # We feed possibly overlapping chunks, which is why the unconsumed tail
+        # has to be taken into consideration, as well as the unused data
+        # if we hit the end of the stream
+        # NOTE: Behavior changed in PY2.7 onward, which requires special handling to make the tests work properly.
+        # They are thorough, and I assume it is truly working.
+        # Why is this logic as convoluted as it is ? Please look at the table in
+        # https://github.com/gitpython-developers/gitdb/issues/19 to learn about the test-results.
+        # Basically, on py2.6, you want to use branch 1, whereas on all other python version, the second branch
+        # will be the one that works.
+        # However, the zlib VERSIONs as well as the platform check is used to further match the entries in the
+        # table in the github issue. This is it ... it was the only way I could make this work everywhere.
+        # IT's CERTAINLY GOING TO BITE US IN THE FUTURE ... .
+        if getattr(zlib, 'ZLIB_RUNTIME_VERSION', zlib.ZLIB_VERSION) in ('1.2.7', '1.2.5') and not sys.platform == 'darwin':
+            unused_datalen = len(self._zip.unconsumed_tail)
+        else:
+            unused_datalen = len(self._zip.unconsumed_tail) + len(self._zip.unused_data)
+        # # end handle very special case ...
+
+        self._cbr += len(indata) - unused_datalen
+        self._br += len(dcompdat)
+
+        if dat:
+            dcompdat = dat + dcompdat
+        # END prepend our cached data
+
+        # it can happen, depending on the compression, that we get less bytes
+        # than ordered as it needs the final portion of the data as well.
+        # Recursively resolve that.
+        # Note: dcompdat can be empty even though we still appear to have bytes
+        # to read, if we are called by compressed_bytes_read - it manipulates
+        # us to empty the stream
+        if dcompdat and (len(dcompdat) - len(dat)) < size and self._br < self._s:
+            dcompdat += self.read(size - len(dcompdat))
+        # END handle special case
+        return dcompdat
+
+
+class DeltaApplyReader(LazyMixin):
+
+    """A reader which dynamically applies pack deltas to a base object, keeping the
+    memory demands to a minimum.
+
+    The size of the final object is only obtainable once all deltas have been
+    applied, unless it is retrieved from a pack index.
+
+    The uncompressed Delta has the following layout (MSB being a most significant
+    bit encoded dynamic size):
+
+    * MSB Source Size - the size of the base against which the delta was created
+    * MSB Target Size - the size of the resulting data after the delta was applied
+    * A list of one byte commands (cmd) which are followed by a specific protocol:
+
+     * cmd & 0x80 - copy delta_data[offset:offset+size]
+
+      * Followed by an encoded offset into the delta data
+      * Followed by an encoded size of the chunk to copy
+
+     *  cmd & 0x7f - insert
+
+      * insert cmd bytes from the delta buffer into the output stream
+
+     * cmd == 0 - invalid operation ( or error in delta stream )
+    """
+    __slots__ = (
+        "_bstream",             # base stream to which to apply the deltas
+        "_dstreams",            # tuple of delta stream readers
+        "_mm_target",           # memory map of the delta-applied data
+        "_size",                # actual number of bytes in _mm_target
+        "_br"                   # number of bytes read
+    )
+
+    #{ Configuration
+    k_max_memory_move = 250 * 1000 * 1000
+    #} END configuration
+
+    def __init__(self, stream_list):
+        """Initialize this instance with a list of streams, the first stream being
+        the delta to apply on top of all following deltas, the last stream being the
+        base object onto which to apply the deltas"""
+        assert len(stream_list) > 1, "Need at least one delta and one base stream"
+
+        self._bstream = stream_list[-1]
+        self._dstreams = tuple(stream_list[:-1])
+        self._br = 0
+
+    def _set_cache_too_slow_without_c(self, attr):
+        # the direct algorithm is fastest and most direct if there is only one
+        # delta. Also, the extra overhead might not be worth it for items smaller
+        # than X - definitely the case in python, every function call costs
+        # huge amounts of time
+        # if len(self._dstreams) * self._bstream.size < self.k_max_memory_move:
+        if len(self._dstreams) == 1:
+            return self._set_cache_brute_(attr)
+
+        # Aggregate all deltas into one delta in reverse order. Hence we take
+        # the last delta, and reverse-merge its ancestor delta, until we receive
+        # the final delta data stream.
+        dcl = connect_deltas(self._dstreams)
+
+        # call len directly, as the (optional) c version doesn't implement the sequence
+        # protocol
+        if dcl.rbound() == 0:
+            self._size = 0
+            self._mm_target = allocate_memory(0)
+            return
+        # END handle empty list
+
+        self._size = dcl.rbound()
+        self._mm_target = allocate_memory(self._size)
+
+        bbuf = allocate_memory(self._bstream.size)
+        stream_copy(self._bstream.read, bbuf.write, self._bstream.size, 256 * mmap.PAGESIZE)
+
+        # APPLY CHUNKS
+        write = self._mm_target.write
+        dcl.apply(bbuf, write)
+
+        self._mm_target.seek(0)
+
+    def _set_cache_brute_(self, attr):
+        """If we are here, we apply the actual deltas"""
+        # TODO: There should be a special case if there is only one stream
+        # Then the default-git algorithm should perform a tad faster, as the
+        # delta is not peaked into, causing less overhead.
+        buffer_info_list = list()
+        max_target_size = 0
+        for dstream in self._dstreams:
+            buf = dstream.read(512)         # read the header information + X
+            offset, src_size = msb_size(buf)
+            offset, target_size = msb_size(buf, offset)
+            buffer_info_list.append((buf[offset:], offset, src_size, target_size))
+            max_target_size = max(max_target_size, target_size)
+        # END for each delta stream
+
+        # sanity check - the first delta to apply should have the same source
+        # size as our actual base stream
+        base_size = self._bstream.size
+        target_size = max_target_size
+
+        # if we have more than 1 delta to apply, we will swap buffers, hence we must
+        # assure that all buffers we use are large enough to hold all the results
+        if len(self._dstreams) > 1:
+            base_size = target_size = max(base_size, max_target_size)
+        # END adjust buffer sizes
+
+        # Allocate private memory map big enough to hold the first base buffer
+        # We need random access to it
+        bbuf = allocate_memory(base_size)
+        stream_copy(self._bstream.read, bbuf.write, base_size, 256 * mmap.PAGESIZE)
+
+        # allocate memory map large enough for the largest (intermediate) target
+        # We will use it as scratch space for all delta ops. If the final
+        # target buffer is smaller than our allocated space, we just use parts
+        # of it upon return.
+        tbuf = allocate_memory(target_size)
+
+        # for each delta to apply, memory map the decompressed delta and
+        # work on the op-codes to reconstruct everything.
+        # For the actual copying, we use a seek and write pattern of buffer
+        # slices.
+        final_target_size = None
+        for (dbuf, offset, src_size, target_size), dstream in zip(reversed(buffer_info_list), reversed(self._dstreams)):
+            # allocate a buffer to hold all delta data - fill in the data for
+            # fast access. We do this as we know that reading individual bytes
+            # from our stream would be slower than necessary ( although possible )
+            # The dbuf buffer contains commands after the first two MSB sizes, the
+            # offset specifies the amount of bytes read to get the sizes.
+            ddata = allocate_memory(dstream.size - offset)
+            ddata.write(dbuf)
+            # read the rest from the stream. The size we give is larger than necessary
+            stream_copy(dstream.read, ddata.write, dstream.size, 256 * mmap.PAGESIZE)
+
+            #######################################################################
+            if 'c_apply_delta' in globals():
+                c_apply_delta(bbuf, ddata, tbuf)
+            else:
+                apply_delta_data(bbuf, src_size, ddata, len(ddata), tbuf.write)
+            #######################################################################
+
+            # finally, swap out source and target buffers. The target is now the
+            # base for the next delta to apply
+            bbuf, tbuf = tbuf, bbuf
+            bbuf.seek(0)
+            tbuf.seek(0)
+            final_target_size = target_size
+        # END for each delta to apply
+
+        # its already seeked to 0, constrain it to the actual size
+        # NOTE: in the end of the loop, it swaps buffers, hence our target buffer
+        # is not tbuf, but bbuf !
+        self._mm_target = bbuf
+        self._size = final_target_size
+
+    #{ Configuration
+    if not has_perf_mod:
+        _set_cache_ = _set_cache_brute_
+    else:
+        _set_cache_ = _set_cache_too_slow_without_c
+
+    #} END configuration
+
+    def read(self, count=0):
+        bl = self._size - self._br      # bytes left
+        if count < 1 or count > bl:
+            count = bl
+        # NOTE: we could check for certain size limits, and possibly
+        # return buffers instead of strings to prevent byte copying
+        data = self._mm_target.read(count)
+        self._br += len(data)
+        return data
+
+    def seek(self, offset, whence=getattr(os, 'SEEK_SET', 0)):
+        """Allows to reset the stream to restart reading
+
+        :raise ValueError: If offset and whence are not 0"""
+        if offset != 0 or whence != getattr(os, 'SEEK_SET', 0):
+            raise ValueError("Can only seek to position 0")
+        # END handle offset
+        self._br = 0
+        self._mm_target.seek(0)
+
+    #{ Interface
+
+    @classmethod
+    def new(cls, stream_list):
+        """
+        Convert the given list of streams into a stream which resolves deltas
+        when reading from it.
+
+        :param stream_list: two or more stream objects, first stream is a Delta
+            to the object that you want to resolve, followed by N additional delta
+            streams. The list's last stream must be a non-delta stream.
+
+        :return: Non-Delta OPackStream object whose stream can be used to obtain
+            the decompressed resolved data
+        :raise ValueError: if the stream list cannot be handled"""
+        if len(stream_list) < 2:
+            raise ValueError("Need at least two streams")
+        # END single object special handling
+
+        if stream_list[-1].type_id in delta_types:
+            raise ValueError(
+                "Cannot resolve deltas if there is no base object stream, last one was type: %s" % stream_list[-1].type)
+        # END check stream
+        return cls(stream_list)
+
+    #} END interface
+
+    #{ OInfo like Interface
+
+    @property
+    def type(self):
+        return self._bstream.type
+
+    @property
+    def type_id(self):
+        return self._bstream.type_id
+
+    @property
+    def size(self):
+        """:return: number of uncompressed bytes in the stream"""
+        return self._size
+
+    #} END oinfo like interface
+
+
+#} END RO streams
+
+
+#{ W Streams
+
+class Sha1Writer:
+
+    """Simple stream writer which produces a sha whenever you like as it degests
+    everything it is supposed to write"""
+    __slots__ = "sha1"
+
+    def __init__(self):
+        self.sha1 = make_sha()
+
+    #{ Stream Interface
+
+    def write(self, data):
+        """:raise IOError: If not all bytes could be written
+        :param data: byte object
+        :return: length of incoming data"""
+
+        self.sha1.update(data)
+
+        return len(data)
+
+    # END stream interface
+
+    #{ Interface
+
+    def sha(self, as_hex=False):
+        """:return: sha so far
+        :param as_hex: if True, sha will be hex-encoded, binary otherwise"""
+        if as_hex:
+            return self.sha1.hexdigest()
+        return self.sha1.digest()
+
+    #} END interface
+
+
+class FlexibleSha1Writer(Sha1Writer):
+
+    """Writer producing a sha1 while passing on the written bytes to the given
+    write function"""
+    __slots__ = 'writer'
+
+    def __init__(self, writer):
+        Sha1Writer.__init__(self)
+        self.writer = writer
+
+    def write(self, data):
+        Sha1Writer.write(self, data)
+        self.writer(data)
+
+
+class ZippedStoreShaWriter(Sha1Writer):
+
+    """Remembers everything someone writes to it and generates a sha"""
+    __slots__ = ('buf', 'zip')
+
+    def __init__(self):
+        Sha1Writer.__init__(self)
+        self.buf = BytesIO()
+        self.zip = zlib.compressobj(zlib.Z_BEST_SPEED)
+
+    def __getattr__(self, attr):
+        return getattr(self.buf, attr)
+
+    def write(self, data):
+        alen = Sha1Writer.write(self, data)
+        self.buf.write(self.zip.compress(data))
+
+        return alen
+
+    def close(self):
+        self.buf.write(self.zip.flush())
+
+    def seek(self, offset, whence=getattr(os, 'SEEK_SET', 0)):
+        """Seeking currently only supports to rewind written data
+        Multiple writes are not supported"""
+        if offset != 0 or whence != getattr(os, 'SEEK_SET', 0):
+            raise ValueError("Can only seek to position 0")
+        # END handle offset
+        self.buf.seek(0)
+
+    def getvalue(self):
+        """:return: string value from the current stream position to the end"""
+        return self.buf.getvalue()
+
+
+class FDCompressedSha1Writer(Sha1Writer):
+
+    """Digests data written to it, making the sha available, then compress the
+    data and write it to the file descriptor
+
+    **Note:** operates on raw file descriptors
+    **Note:** for this to work, you have to use the close-method of this instance"""
+    __slots__ = ("fd", "sha1", "zip")
+
+    # default exception
+    exc = IOError("Failed to write all bytes to filedescriptor")
+
+    def __init__(self, fd):
+        super().__init__()
+        self.fd = fd
+        self.zip = zlib.compressobj(zlib.Z_BEST_SPEED)
+
+    #{ Stream Interface
+
+    def write(self, data):
+        """:raise IOError: If not all bytes could be written
+        :return: length of incoming data"""
+        self.sha1.update(data)
+        cdata = self.zip.compress(data)
+        bytes_written = write(self.fd, cdata)
+
+        if bytes_written != len(cdata):
+            raise self.exc
+
+        return len(data)
+
+    def close(self):
+        remainder = self.zip.flush()
+        if write(self.fd, remainder) != len(remainder):
+            raise self.exc
+        return close(self.fd)
+
+    #} END stream interface
+
+
+class FDStream:
+
+    """A simple wrapper providing the most basic functions on a file descriptor
+    with the fileobject interface. Cannot use os.fdopen as the resulting stream
+    takes ownership"""
+    __slots__ = ("_fd", '_pos')
+
+    def __init__(self, fd):
+        self._fd = fd
+        self._pos = 0
+
+    def write(self, data):
+        self._pos += len(data)
+        os.write(self._fd, data)
+
+    def read(self, count=0):
+        if count == 0:
+            count = os.path.getsize(self._filepath)
+        # END handle read everything
+
+        bytes = os.read(self._fd, count)
+        self._pos += len(bytes)
+        return bytes
+
+    def fileno(self):
+        return self._fd
+
+    def tell(self):
+        return self._pos
+
+    def close(self):
+        close(self._fd)
+
+
+class NullStream:
+
+    """A stream that does nothing but providing a stream interface.
+    Use it like /dev/null"""
+    __slots__ = tuple()
+
+    def read(self, size=0):
+        return ''
+
+    def close(self):
+        pass
+
+    def write(self, data):
+        return len(data)
+
+
+#} END W streams
diff --git a/llm/Lib/site-packages/gitdb/test/__init__.py b/llm/Lib/site-packages/gitdb/test/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..03bd406be478bd82f20b45c589d8d029367c5f1a
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/test/__init__.py
@@ -0,0 +1,4 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
diff --git a/llm/Lib/site-packages/gitdb/test/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/gitdb/test/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..05e655d1a5efa948bd1f55ff63d72f4fb04a3118
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/test/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/test/__pycache__/lib.cpython-311.pyc b/llm/Lib/site-packages/gitdb/test/__pycache__/lib.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ae7d00d809dec9e321d020f21bfa58c9d16505d4
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/test/__pycache__/lib.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/test/__pycache__/test_base.cpython-311.pyc b/llm/Lib/site-packages/gitdb/test/__pycache__/test_base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b13f56412ba6d4eb1b565f9f3926527d6b4a899f
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/test/__pycache__/test_base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/test/__pycache__/test_example.cpython-311.pyc b/llm/Lib/site-packages/gitdb/test/__pycache__/test_example.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2d047dee0f378e387c1eb41666edc5a42e54aff9
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/test/__pycache__/test_example.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/test/__pycache__/test_pack.cpython-311.pyc b/llm/Lib/site-packages/gitdb/test/__pycache__/test_pack.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7fdbbd12502454030337de4c497d783f3217b6b0
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/test/__pycache__/test_pack.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/test/__pycache__/test_stream.cpython-311.pyc b/llm/Lib/site-packages/gitdb/test/__pycache__/test_stream.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..af2b119a8c2032b71a14a6c79e205b28e08fc513
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/test/__pycache__/test_stream.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/test/__pycache__/test_util.cpython-311.pyc b/llm/Lib/site-packages/gitdb/test/__pycache__/test_util.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..58ab42fd457cf7f444bc3247f6f81f43ab8f6f2b
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/test/__pycache__/test_util.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/test/lib.py b/llm/Lib/site-packages/gitdb/test/lib.py
new file mode 100644
index 0000000000000000000000000000000000000000..8e602342ca59ef9d556254c2bb089c1cd4c9bcf2
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/test/lib.py
@@ -0,0 +1,192 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Utilities used in ODB testing"""
+from gitdb import OStream
+
+import sys
+import random
+from array import array
+
+from io import BytesIO
+
+import glob
+import unittest
+import tempfile
+import shutil
+import os
+import gc
+import logging
+from functools import wraps
+
+
+#{ Bases
+
+class TestBase(unittest.TestCase):
+    """Base class for all tests
+
+    TestCase providing access to readonly repositories using the following member variables.
+
+    * gitrepopath
+
+     * read-only base path of the git source repository, i.e. .../git/.git
+    """
+
+    #{ Invvariants
+    k_env_git_repo = "GITDB_TEST_GIT_REPO_BASE"
+    #} END invariants
+
+    @classmethod
+    def setUpClass(cls):
+        try:
+            super().setUpClass()
+        except AttributeError:
+            pass
+
+        cls.gitrepopath = os.environ.get(cls.k_env_git_repo)
+        if not cls.gitrepopath:
+            logging.info(
+                "You can set the %s environment variable to a .git repository of your choice - defaulting to the gitdb repository", cls.k_env_git_repo)
+            ospd = os.path.dirname
+            cls.gitrepopath = os.path.join(ospd(ospd(ospd(__file__))), '.git')
+        # end assure gitrepo is set
+        assert cls.gitrepopath.endswith('.git')
+
+
+#} END bases
+
+#{ Decorators
+
+def with_rw_directory(func):
+    """Create a temporary directory which can be written to, remove it if the
+    test succeeds, but leave it otherwise to aid additional debugging"""
+
+    def wrapper(self):
+        path = tempfile.mktemp(prefix=func.__name__)
+        os.mkdir(path)
+        keep = False
+        try:
+            try:
+                return func(self, path)
+            except Exception:
+                sys.stderr.write(f"Test {type(self).__name__}.{func.__name__} failed, output is at {path!r}\n")
+                keep = True
+                raise
+        finally:
+            # Need to collect here to be sure all handles have been closed. It appears
+            # a windows-only issue. In fact things should be deleted, as well as
+            # memory maps closed, once objects go out of scope. For some reason
+            # though this is not the case here unless we collect explicitly.
+            if not keep:
+                gc.collect()
+                shutil.rmtree(path)
+        # END handle exception
+    # END wrapper
+
+    wrapper.__name__ = func.__name__
+    return wrapper
+
+
+def with_packs_rw(func):
+    """Function that provides a path into which the packs for testing should be
+    copied. Will pass on the path to the actual function afterwards"""
+
+    def wrapper(self, path):
+        src_pack_glob = fixture_path('packs/*')
+        copy_files_globbed(src_pack_glob, path, hard_link_ok=True)
+        return func(self, path)
+    # END wrapper
+
+    wrapper.__name__ = func.__name__
+    return wrapper
+
+#} END decorators
+
+#{ Routines
+
+
+def fixture_path(relapath=''):
+    """:return: absolute path into the fixture directory
+    :param relapath: relative path into the fixtures directory, or ''
+        to obtain the fixture directory itself"""
+    return os.path.join(os.path.dirname(__file__), 'fixtures', relapath)
+
+
+def copy_files_globbed(source_glob, target_dir, hard_link_ok=False):
+    """Copy all files found according to the given source glob into the target directory
+    :param hard_link_ok: if True, hard links will be created if possible. Otherwise
+        the files will be copied"""
+    for src_file in glob.glob(source_glob):
+        if hard_link_ok and hasattr(os, 'link'):
+            target = os.path.join(target_dir, os.path.basename(src_file))
+            try:
+                os.link(src_file, target)
+            except OSError:
+                shutil.copy(src_file, target_dir)
+            # END handle cross device links ( and resulting failure )
+        else:
+            shutil.copy(src_file, target_dir)
+        # END try hard link
+    # END for each file to copy
+
+
+def make_bytes(size_in_bytes, randomize=False):
+    """:return: string with given size in bytes
+    :param randomize: try to produce a very random stream"""
+    actual_size = size_in_bytes // 4
+    producer = range(actual_size)
+    if randomize:
+        producer = list(producer)
+        random.shuffle(producer)
+    # END randomize
+    a = array('i', producer)
+    return a.tobytes()
+
+
+def make_object(type, data):
+    """:return: bytes resembling an uncompressed object"""
+    odata = "blob %i\0" % len(data)
+    return odata.encode("ascii") + data
+
+
+def make_memory_file(size_in_bytes, randomize=False):
+    """:return: tuple(size_of_stream, stream)
+    :param randomize: try to produce a very random stream"""
+    d = make_bytes(size_in_bytes, randomize)
+    return len(d), BytesIO(d)
+
+#} END routines
+
+#{ Stream Utilities
+
+
+class DummyStream:
+
+    def __init__(self):
+        self.was_read = False
+        self.bytes = 0
+        self.closed = False
+
+    def read(self, size):
+        self.was_read = True
+        self.bytes = size
+
+    def close(self):
+        self.closed = True
+
+    def _assert(self):
+        assert self.was_read
+
+
+class DeriveTest(OStream):
+
+    def __init__(self, sha, type, size, stream, *args, **kwargs):
+        self.myarg = kwargs.pop('myarg')
+        self.args = args
+
+    def _assert(self):
+        assert self.args
+        assert self.myarg
+
+#} END stream utilitiess
diff --git a/llm/Lib/site-packages/gitdb/test/test_base.py b/llm/Lib/site-packages/gitdb/test/test_base.py
new file mode 100644
index 0000000000000000000000000000000000000000..8fc9e35bf34b3dc26316067dcb67babacb2d77c6
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/test/test_base.py
@@ -0,0 +1,105 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Test for object db"""
+from gitdb.test.lib import (
+    TestBase,
+    DummyStream,
+    DeriveTest,
+)
+
+from gitdb import (
+    OInfo,
+    OPackInfo,
+    ODeltaPackInfo,
+    OStream,
+    OPackStream,
+    ODeltaPackStream,
+    IStream
+)
+from gitdb.util import (
+    NULL_BIN_SHA
+)
+
+from gitdb.typ import (
+    str_blob_type
+)
+
+
+class TestBaseTypes(TestBase):
+
+    def test_streams(self):
+        # test info
+        sha = NULL_BIN_SHA
+        s = 20
+        blob_id = 3
+
+        info = OInfo(sha, str_blob_type, s)
+        assert info.binsha == sha
+        assert info.type == str_blob_type
+        assert info.type_id == blob_id
+        assert info.size == s
+
+        # test pack info
+        # provides type_id
+        pinfo = OPackInfo(0, blob_id, s)
+        assert pinfo.type == str_blob_type
+        assert pinfo.type_id == blob_id
+        assert pinfo.pack_offset == 0
+
+        dpinfo = ODeltaPackInfo(0, blob_id, s, sha)
+        assert dpinfo.type == str_blob_type
+        assert dpinfo.type_id == blob_id
+        assert dpinfo.delta_info == sha
+        assert dpinfo.pack_offset == 0
+
+        # test ostream
+        stream = DummyStream()
+        ostream = OStream(*(info + (stream, )))
+        assert ostream.stream is stream
+        ostream.read(15)
+        stream._assert()
+        assert stream.bytes == 15
+        ostream.read(20)
+        assert stream.bytes == 20
+
+        # test packstream
+        postream = OPackStream(*(pinfo + (stream, )))
+        assert postream.stream is stream
+        postream.read(10)
+        stream._assert()
+        assert stream.bytes == 10
+
+        # test deltapackstream
+        dpostream = ODeltaPackStream(*(dpinfo + (stream, )))
+        dpostream.stream is stream
+        dpostream.read(5)
+        stream._assert()
+        assert stream.bytes == 5
+
+        # derive with own args
+        DeriveTest(sha, str_blob_type, s, stream, 'mine', myarg=3)._assert()
+
+        # test istream
+        istream = IStream(str_blob_type, s, stream)
+        assert istream.binsha == None
+        istream.binsha = sha
+        assert istream.binsha == sha
+
+        assert len(istream.binsha) == 20
+        assert len(istream.hexsha) == 40
+
+        assert istream.size == s
+        istream.size = s * 2
+        istream.size == s * 2
+        assert istream.type == str_blob_type
+        istream.type = "something"
+        assert istream.type == "something"
+        assert istream.stream is stream
+        istream.stream = None
+        assert istream.stream is None
+
+        assert istream.error is None
+        istream.error = Exception()
+        assert isinstance(istream.error, Exception)
diff --git a/llm/Lib/site-packages/gitdb/test/test_example.py b/llm/Lib/site-packages/gitdb/test/test_example.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b4c9084bb2cb10e58ffe656bc19f9b3142e3e65
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/test/test_example.py
@@ -0,0 +1,43 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Module with examples from the tutorial section of the docs"""
+import os
+from gitdb.test.lib import TestBase
+from gitdb import IStream
+from gitdb.db import LooseObjectDB
+
+from io import BytesIO
+
+
+class TestExamples(TestBase):
+
+    def test_base(self):
+        ldb = LooseObjectDB(os.path.join(self.gitrepopath, 'objects'))
+
+        for sha1 in ldb.sha_iter():
+            oinfo = ldb.info(sha1)
+            ostream = ldb.stream(sha1)
+            assert oinfo[:3] == ostream[:3]
+
+            assert len(ostream.read()) == ostream.size
+            assert ldb.has_object(oinfo.binsha)
+        # END for each sha in database
+        # assure we close all files
+        try:
+            del(ostream)
+            del(oinfo)
+        except UnboundLocalError:
+            pass
+        # END ignore exception if there are no loose objects
+
+        data = b"my data"
+        istream = IStream("blob", len(data), BytesIO(data))
+
+        # the object does not yet have a sha
+        assert istream.binsha is None
+        ldb.store(istream)
+        # now the sha is set
+        assert len(istream.binsha) == 20
+        assert ldb.has_object(istream.binsha)
diff --git a/llm/Lib/site-packages/gitdb/test/test_pack.py b/llm/Lib/site-packages/gitdb/test/test_pack.py
new file mode 100644
index 0000000000000000000000000000000000000000..e7234822805f05373c3122d010424c0f339d5027
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/test/test_pack.py
@@ -0,0 +1,249 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Test everything about packs reading and writing"""
+from gitdb.test.lib import (
+    TestBase,
+    with_rw_directory,
+    fixture_path
+)
+
+from gitdb.stream import DeltaApplyReader
+
+from gitdb.pack import (
+    PackEntity,
+    PackIndexFile,
+    PackFile
+)
+
+from gitdb.base import (
+    OInfo,
+    OStream,
+)
+
+from gitdb.fun import delta_types
+from gitdb.exc import UnsupportedOperation
+from gitdb.util import to_bin_sha
+
+import pytest
+
+import os
+import tempfile
+
+
+#{ Utilities
+def bin_sha_from_filename(filename):
+    return to_bin_sha(os.path.splitext(os.path.basename(filename))[0][5:])
+#} END utilities
+
+
+class TestPack(TestBase):
+
+    packindexfile_v1 = (fixture_path('packs/pack-c0438c19fb16422b6bbcce24387b3264416d485b.idx'), 1, 67)
+    packindexfile_v2 = (fixture_path('packs/pack-11fdfa9e156ab73caae3b6da867192221f2089c2.idx'), 2, 30)
+    packindexfile_v2_3_ascii = (fixture_path('packs/pack-a2bf8e71d8c18879e499335762dd95119d93d9f1.idx'), 2, 42)
+    packfile_v2_1 = (fixture_path('packs/pack-c0438c19fb16422b6bbcce24387b3264416d485b.pack'), 2, packindexfile_v1[2])
+    packfile_v2_2 = (fixture_path('packs/pack-11fdfa9e156ab73caae3b6da867192221f2089c2.pack'), 2, packindexfile_v2[2])
+    packfile_v2_3_ascii = (
+        fixture_path('packs/pack-a2bf8e71d8c18879e499335762dd95119d93d9f1.pack'), 2, packindexfile_v2_3_ascii[2])
+
+    def _assert_index_file(self, index, version, size):
+        assert index.packfile_checksum() != index.indexfile_checksum()
+        assert len(index.packfile_checksum()) == 20
+        assert len(index.indexfile_checksum()) == 20
+        assert index.version() == version
+        assert index.size() == size
+        assert len(index.offsets()) == size
+
+        # get all data of all objects
+        for oidx in range(index.size()):
+            sha = index.sha(oidx)
+            assert oidx == index.sha_to_index(sha)
+
+            entry = index.entry(oidx)
+            assert len(entry) == 3
+
+            assert entry[0] == index.offset(oidx)
+            assert entry[1] == sha
+            assert entry[2] == index.crc(oidx)
+
+            # verify partial sha
+            for l in (4, 8, 11, 17, 20):
+                assert index.partial_sha_to_index(sha[:l], l * 2) == oidx
+
+        # END for each object index in indexfile
+        self.assertRaises(ValueError, index.partial_sha_to_index, "\0", 2)
+
+    def _assert_pack_file(self, pack, version, size):
+        assert pack.version() == 2
+        assert pack.size() == size
+        assert len(pack.checksum()) == 20
+
+        num_obj = 0
+        for obj in pack.stream_iter():
+            num_obj += 1
+            info = pack.info(obj.pack_offset)
+            stream = pack.stream(obj.pack_offset)
+
+            assert info.pack_offset == stream.pack_offset
+            assert info.type_id == stream.type_id
+            assert hasattr(stream, 'read')
+
+            # it should be possible to read from both streams
+            assert obj.read() == stream.read()
+
+            streams = pack.collect_streams(obj.pack_offset)
+            assert streams
+
+            # read the stream
+            try:
+                dstream = DeltaApplyReader.new(streams)
+            except ValueError:
+                # ignore these, old git versions use only ref deltas,
+                # which we haven't resolved ( as we are without an index )
+                # Also ignore non-delta streams
+                continue
+            # END get deltastream
+
+            # read all
+            data = dstream.read()
+            assert len(data) == dstream.size
+
+            # test seek
+            dstream.seek(0)
+            assert dstream.read() == data
+
+            # read chunks
+            # NOTE: the current implementation is safe, it basically transfers
+            # all calls to the underlying memory map
+
+        # END for each object
+        assert num_obj == size
+
+    def test_pack_index(self):
+        # check version 1 and 2
+        for indexfile, version, size in (self.packindexfile_v1, self.packindexfile_v2):
+            index = PackIndexFile(indexfile)
+            self._assert_index_file(index, version, size)
+        # END run tests
+
+    def test_pack(self):
+        # there is this special version 3, but apparently its like 2 ...
+        for packfile, version, size in (self.packfile_v2_3_ascii, self.packfile_v2_1, self.packfile_v2_2):
+            pack = PackFile(packfile)
+            self._assert_pack_file(pack, version, size)
+        # END for each pack to test
+
+    @with_rw_directory
+    def test_pack_entity(self, rw_dir):
+        pack_objs = list()
+        for packinfo, indexinfo in ((self.packfile_v2_1, self.packindexfile_v1),
+                                    (self.packfile_v2_2, self.packindexfile_v2),
+                                    (self.packfile_v2_3_ascii, self.packindexfile_v2_3_ascii)):
+            packfile, version, size = packinfo
+            indexfile, version, size = indexinfo
+            entity = PackEntity(packfile)
+            assert entity.pack().path() == packfile
+            assert entity.index().path() == indexfile
+            pack_objs.extend(entity.stream_iter())
+
+            count = 0
+            for info, stream in zip(entity.info_iter(), entity.stream_iter()):
+                count += 1
+                assert info.binsha == stream.binsha
+                assert len(info.binsha) == 20
+                assert info.type_id == stream.type_id
+                assert info.size == stream.size
+
+                # we return fully resolved items, which is implied by the sha centric access
+                assert not info.type_id in delta_types
+
+                # try all calls
+                assert len(entity.collect_streams(info.binsha))
+                oinfo = entity.info(info.binsha)
+                assert isinstance(oinfo, OInfo)
+                assert oinfo.binsha is not None
+                ostream = entity.stream(info.binsha)
+                assert isinstance(ostream, OStream)
+                assert ostream.binsha is not None
+
+                # verify the stream
+                try:
+                    assert entity.is_valid_stream(info.binsha, use_crc=True)
+                except UnsupportedOperation:
+                    pass
+                # END ignore version issues
+                assert entity.is_valid_stream(info.binsha, use_crc=False)
+            # END for each info, stream tuple
+            assert count == size
+
+        # END for each entity
+
+        # pack writing - write all packs into one
+        # index path can be None
+        pack_path1 = tempfile.mktemp('', "pack1", rw_dir)
+        pack_path2 = tempfile.mktemp('', "pack2", rw_dir)
+        index_path = tempfile.mktemp('', 'index', rw_dir)
+        iteration = 0
+
+        def rewind_streams():
+            for obj in pack_objs:
+                obj.stream.seek(0)
+        # END utility
+        for ppath, ipath, num_obj in zip((pack_path1, pack_path2),
+                                         (index_path, None),
+                                         (len(pack_objs), None)):
+            iwrite = None
+            if ipath:
+                ifile = open(ipath, 'wb')
+                iwrite = ifile.write
+            # END handle ip
+
+            # make sure we rewind the streams ... we work on the same objects over and over again
+            if iteration > 0:
+                rewind_streams()
+            # END rewind streams
+            iteration += 1
+
+            with open(ppath, 'wb') as pfile:
+                pack_sha, index_sha = PackEntity.write_pack(pack_objs, pfile.write, iwrite, object_count=num_obj)
+            assert os.path.getsize(ppath) > 100
+
+            # verify pack
+            pf = PackFile(ppath)
+            assert pf.size() == len(pack_objs)
+            assert pf.version() == PackFile.pack_version_default
+            assert pf.checksum() == pack_sha
+            pf.close()
+
+            # verify index
+            if ipath is not None:
+                ifile.close()
+                assert os.path.getsize(ipath) > 100
+                idx = PackIndexFile(ipath)
+                assert idx.version() == PackIndexFile.index_version_default
+                assert idx.packfile_checksum() == pack_sha
+                assert idx.indexfile_checksum() == index_sha
+                assert idx.size() == len(pack_objs)
+                idx.close()
+            # END verify files exist
+        # END for each packpath, indexpath pair
+
+        # verify the packs thoroughly
+        rewind_streams()
+        entity = PackEntity.create(pack_objs, rw_dir)
+        count = 0
+        for info in entity.info_iter():
+            count += 1
+            for use_crc in range(2):
+                assert entity.is_valid_stream(info.binsha, use_crc)
+            # END for each crc mode
+        # END for each info
+        assert count == len(pack_objs)
+        entity.close()
+
+    def test_pack_64(self):
+        # TODO: hex-edit a pack helping us to verify that we can handle 64 byte offsets
+        # of course without really needing such a huge pack
+        pytest.skip('not implemented')
diff --git a/llm/Lib/site-packages/gitdb/test/test_stream.py b/llm/Lib/site-packages/gitdb/test/test_stream.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e7e941d1cad57e7789de51941ec2c6b3587c1a5
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/test/test_stream.py
@@ -0,0 +1,164 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Test for object db"""
+
+from gitdb.test.lib import (
+    TestBase,
+    DummyStream,
+    make_bytes,
+    make_object,
+    fixture_path
+)
+
+from gitdb import (
+    DecompressMemMapReader,
+    FDCompressedSha1Writer,
+    LooseObjectDB,
+    Sha1Writer,
+    MemoryDB,
+    IStream,
+)
+from gitdb.util import hex_to_bin
+
+import zlib
+from gitdb.typ import (
+    str_blob_type
+)
+
+import tempfile
+import os
+from io import BytesIO
+
+
+class TestStream(TestBase):
+
+    """Test stream classes"""
+
+    data_sizes = (15, 10000, 1000 * 1024 + 512)
+
+    def _assert_stream_reader(self, stream, cdata, rewind_stream=lambda s: None):
+        """Make stream tests - the orig_stream is seekable, allowing it to be
+        rewound and reused
+        :param cdata: the data we expect to read from stream, the contents
+        :param rewind_stream: function called to rewind the stream to make it ready
+            for reuse"""
+        ns = 10
+        assert len(cdata) > ns - 1, "Data must be larger than %i, was %i" % (ns, len(cdata))
+
+        # read in small steps
+        ss = len(cdata) // ns
+        for i in range(ns):
+            data = stream.read(ss)
+            chunk = cdata[i * ss:(i + 1) * ss]
+            assert data == chunk
+        # END for each step
+        rest = stream.read()
+        if rest:
+            assert rest == cdata[-len(rest):]
+        # END handle rest
+
+        if isinstance(stream, DecompressMemMapReader):
+            assert len(stream.data()) == stream.compressed_bytes_read()
+        # END handle special type
+
+        rewind_stream(stream)
+
+        # read everything
+        rdata = stream.read()
+        assert rdata == cdata
+
+        if isinstance(stream, DecompressMemMapReader):
+            assert len(stream.data()) == stream.compressed_bytes_read()
+        # END handle special type
+
+    def test_decompress_reader(self):
+        for close_on_deletion in range(2):
+            for with_size in range(2):
+                for ds in self.data_sizes:
+                    cdata = make_bytes(ds, randomize=False)
+
+                    # zdata = zipped actual data
+                    # cdata = original content data
+
+                    # create reader
+                    if with_size:
+                        # need object data
+                        zdata = zlib.compress(make_object(str_blob_type, cdata))
+                        typ, size, reader = DecompressMemMapReader.new(zdata, close_on_deletion)
+                        assert size == len(cdata)
+                        assert typ == str_blob_type
+
+                        # even if we don't set the size, it will be set automatically on first read
+                        test_reader = DecompressMemMapReader(zdata, close_on_deletion=False)
+                        assert test_reader._s == len(cdata)
+                    else:
+                        # here we need content data
+                        zdata = zlib.compress(cdata)
+                        reader = DecompressMemMapReader(zdata, close_on_deletion, len(cdata))
+                        assert reader._s == len(cdata)
+                    # END get reader
+
+                    self._assert_stream_reader(reader, cdata, lambda r: r.seek(0))
+
+                    # put in a dummy stream for closing
+                    dummy = DummyStream()
+                    reader._m = dummy
+
+                    assert not dummy.closed
+                    del(reader)
+                    assert dummy.closed == close_on_deletion
+                # END for each datasize
+            # END whether size should be used
+        # END whether stream should be closed when deleted
+
+    def test_sha_writer(self):
+        writer = Sha1Writer()
+        assert 2 == writer.write(b"hi")
+        assert len(writer.sha(as_hex=1)) == 40
+        assert len(writer.sha(as_hex=0)) == 20
+
+        # make sure it does something ;)
+        prev_sha = writer.sha()
+        writer.write(b"hi again")
+        assert writer.sha() != prev_sha
+
+    def test_compressed_writer(self):
+        for ds in self.data_sizes:
+            fd, path = tempfile.mkstemp()
+            ostream = FDCompressedSha1Writer(fd)
+            data = make_bytes(ds, randomize=False)
+
+            # for now, just a single write, code doesn't care about chunking
+            assert len(data) == ostream.write(data)
+            ostream.close()
+
+            # its closed already
+            self.assertRaises(OSError, os.close, fd)
+
+            # read everything back, compare to data we zip
+            fd = os.open(path, os.O_RDONLY | getattr(os, 'O_BINARY', 0))
+            written_data = os.read(fd, os.path.getsize(path))
+            assert len(written_data) == os.path.getsize(path)
+            os.close(fd)
+            assert written_data == zlib.compress(data, 1)   # best speed
+
+            os.remove(path)
+        # END for each os
+
+    def test_decompress_reader_special_case(self):
+        odb = LooseObjectDB(fixture_path('objects'))
+        mdb = MemoryDB()
+        for sha in (b'888401851f15db0eed60eb1bc29dec5ddcace911',
+                    b'7bb839852ed5e3a069966281bb08d50012fb309b',):
+            ostream = odb.stream(hex_to_bin(sha))
+
+            # if there is a bug, we will be missing one byte exactly !
+            data = ostream.read()
+            assert len(data) == ostream.size
+
+            # Putting it back in should yield nothing new - after all, we have
+            dump = mdb.store(IStream(ostream.type, ostream.size, BytesIO(data)))
+            assert dump.hexsha == sha
+        # end for each loose object sha to test
diff --git a/llm/Lib/site-packages/gitdb/test/test_util.py b/llm/Lib/site-packages/gitdb/test/test_util.py
new file mode 100644
index 0000000000000000000000000000000000000000..166b33c3a6c8917fc737aefddbc85041aadc1b48
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/test/test_util.py
@@ -0,0 +1,100 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Test for object db"""
+import tempfile
+import os
+
+from gitdb.test.lib import TestBase
+from gitdb.util import (
+    to_hex_sha,
+    to_bin_sha,
+    NULL_HEX_SHA,
+    LockedFD
+)
+
+
+class TestUtils(TestBase):
+
+    def test_basics(self):
+        assert to_hex_sha(NULL_HEX_SHA) == NULL_HEX_SHA
+        assert len(to_bin_sha(NULL_HEX_SHA)) == 20
+        assert to_hex_sha(to_bin_sha(NULL_HEX_SHA)) == NULL_HEX_SHA.encode("ascii")
+
+    def _cmp_contents(self, file_path, data):
+        # raise if data from file at file_path
+        # does not match data string
+        with open(file_path, "rb") as fp:
+            assert fp.read() == data.encode("ascii")
+
+    def test_lockedfd(self):
+        my_file = tempfile.mktemp()
+        orig_data = "hello"
+        new_data = "world"
+        with open(my_file, "wb") as my_file_fp:
+            my_file_fp.write(orig_data.encode("ascii"))
+
+        try:
+            lfd = LockedFD(my_file)
+            lockfilepath = lfd._lockfilepath()
+
+            # cannot end before it was started
+            self.assertRaises(AssertionError, lfd.rollback)
+            self.assertRaises(AssertionError, lfd.commit)
+
+            # open for writing
+            assert not os.path.isfile(lockfilepath)
+            wfd = lfd.open(write=True)
+            assert lfd._fd is wfd
+            assert os.path.isfile(lockfilepath)
+
+            # write data and fail
+            os.write(wfd, new_data.encode("ascii"))
+            lfd.rollback()
+            assert lfd._fd is None
+            self._cmp_contents(my_file, orig_data)
+            assert not os.path.isfile(lockfilepath)
+
+            # additional call doesn't fail
+            lfd.commit()
+            lfd.rollback()
+
+            # test reading
+            lfd = LockedFD(my_file)
+            rfd = lfd.open(write=False)
+            assert os.read(rfd, len(orig_data)) == orig_data.encode("ascii")
+
+            assert os.path.isfile(lockfilepath)
+            # deletion rolls back
+            del(lfd)
+            assert not os.path.isfile(lockfilepath)
+
+            # write data - concurrently
+            lfd = LockedFD(my_file)
+            olfd = LockedFD(my_file)
+            assert not os.path.isfile(lockfilepath)
+            wfdstream = lfd.open(write=True, stream=True)       # this time as stream
+            assert os.path.isfile(lockfilepath)
+            # another one fails
+            self.assertRaises(IOError, olfd.open)
+
+            wfdstream.write(new_data.encode("ascii"))
+            lfd.commit()
+            assert not os.path.isfile(lockfilepath)
+            self._cmp_contents(my_file, new_data)
+
+            # could test automatic _end_writing on destruction
+        finally:
+            os.remove(my_file)
+        # END final cleanup
+
+        # try non-existing file for reading
+        lfd = LockedFD(tempfile.mktemp())
+        try:
+            lfd.open(write=False)
+        except OSError:
+            assert not os.path.exists(lfd._lockfilepath())
+        else:
+            self.fail("expected OSError")
+        # END handle exceptions
diff --git a/llm/Lib/site-packages/gitdb/typ.py b/llm/Lib/site-packages/gitdb/typ.py
new file mode 100644
index 0000000000000000000000000000000000000000..314db50a73ecf8d3266ea513e82f43b71d14a25f
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/typ.py
@@ -0,0 +1,10 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+"""Module containing information about types known to the database"""
+
+str_blob_type = b'blob'
+str_commit_type = b'commit'
+str_tree_type = b'tree'
+str_tag_type = b'tag'
diff --git a/llm/Lib/site-packages/gitdb/util.py b/llm/Lib/site-packages/gitdb/util.py
new file mode 100644
index 0000000000000000000000000000000000000000..bb6d8797a051f810c9538d5dbfd776b0ef22324d
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/util.py
@@ -0,0 +1,398 @@
+# Copyright (C) 2010, 2011 Sebastian Thiel (byronimo@gmail.com) and contributors
+#
+# This module is part of GitDB and is released under
+# the New BSD License: https://opensource.org/license/bsd-3-clause/
+import binascii
+import os
+import mmap
+import sys
+import time
+import errno
+
+from io import BytesIO
+
+from smmap import (
+    StaticWindowMapManager,
+    SlidingWindowMapManager,
+    SlidingWindowMapBuffer
+)
+
+# initialize our global memory manager instance
+# Use it to free cached (and unused) resources.
+mman = SlidingWindowMapManager()
+# END handle mman
+
+import hashlib
+
+try:
+    from struct import unpack_from
+except ImportError:
+    from struct import unpack, calcsize
+    __calcsize_cache = dict()
+
+    def unpack_from(fmt, data, offset=0):
+        try:
+            size = __calcsize_cache[fmt]
+        except KeyError:
+            size = calcsize(fmt)
+            __calcsize_cache[fmt] = size
+        # END exception handling
+        return unpack(fmt, data[offset: offset + size])
+    # END own unpack_from implementation
+
+
+#{ Aliases
+
+hex_to_bin = binascii.a2b_hex
+bin_to_hex = binascii.b2a_hex
+
+# errors
+ENOENT = errno.ENOENT
+
+# os shortcuts
+exists = os.path.exists
+mkdir = os.mkdir
+chmod = os.chmod
+isdir = os.path.isdir
+isfile = os.path.isfile
+rename = os.rename
+dirname = os.path.dirname
+basename = os.path.basename
+join = os.path.join
+read = os.read
+write = os.write
+close = os.close
+fsync = os.fsync
+
+
+def _retry(func, *args, **kwargs):
+    # Wrapper around functions, that are problematic on "Windows". Sometimes
+    # the OS or someone else has still a handle to the file
+    if sys.platform == "win32":
+        for _ in range(10):
+            try:
+                return func(*args, **kwargs)
+            except Exception:
+                time.sleep(0.1)
+        return func(*args, **kwargs)
+    else:
+        return func(*args, **kwargs)
+
+
+def remove(*args, **kwargs):
+    return _retry(os.remove, *args, **kwargs)
+
+
+# Backwards compatibility imports
+from gitdb.const import (
+    NULL_BIN_SHA,
+    NULL_HEX_SHA
+)
+
+#} END Aliases
+
+#{ compatibility stuff ...
+
+
+class _RandomAccessBytesIO:
+
+    """Wrapper to provide required functionality in case memory maps cannot or may
+    not be used. This is only really required in python 2.4"""
+    __slots__ = '_sio'
+
+    def __init__(self, buf=''):
+        self._sio = BytesIO(buf)
+
+    def __getattr__(self, attr):
+        return getattr(self._sio, attr)
+
+    def __len__(self):
+        return len(self.getvalue())
+
+    def __getitem__(self, i):
+        return self.getvalue()[i]
+
+    def __getslice__(self, start, end):
+        return self.getvalue()[start:end]
+
+
+def byte_ord(b):
+    """
+    Return the integer representation of the byte string.  This supports Python
+    3 byte arrays as well as standard strings.
+    """
+    try:
+        return ord(b)
+    except TypeError:
+        return b
+
+#} END compatibility stuff ...
+
+#{ Routines
+
+
+def make_sha(source=b''):
+    """A python2.4 workaround for the sha/hashlib module fiasco
+
+    **Note** From the dulwich project """
+    try:
+        return hashlib.sha1(source)
+    except NameError:
+        import sha
+        sha1 = sha.sha(source)
+        return sha1
+
+
+def allocate_memory(size):
+    """:return: a file-protocol accessible memory block of the given size"""
+    if size == 0:
+        return _RandomAccessBytesIO(b'')
+    # END handle empty chunks gracefully
+
+    try:
+        return mmap.mmap(-1, size)  # read-write by default
+    except OSError:
+        # setup real memory instead
+        # this of course may fail if the amount of memory is not available in
+        # one chunk - would only be the case in python 2.4, being more likely on
+        # 32 bit systems.
+        return _RandomAccessBytesIO(b"\0" * size)
+    # END handle memory allocation
+
+
+def file_contents_ro(fd, stream=False, allow_mmap=True):
+    """:return: read-only contents of the file represented by the file descriptor fd
+
+    :param fd: file descriptor opened for reading
+    :param stream: if False, random access is provided, otherwise the stream interface
+        is provided.
+    :param allow_mmap: if True, its allowed to map the contents into memory, which
+        allows large files to be handled and accessed efficiently. The file-descriptor
+        will change its position if this is False"""
+    try:
+        if allow_mmap:
+            # supports stream and random access
+            try:
+                return mmap.mmap(fd, 0, access=mmap.ACCESS_READ)
+            except OSError:
+                # python 2.4 issue, 0 wants to be the actual size
+                return mmap.mmap(fd, os.fstat(fd).st_size, access=mmap.ACCESS_READ)
+            # END handle python 2.4
+    except OSError:
+        pass
+    # END exception handling
+
+    # read manually
+    contents = os.read(fd, os.fstat(fd).st_size)
+    if stream:
+        return _RandomAccessBytesIO(contents)
+    return contents
+
+
+def file_contents_ro_filepath(filepath, stream=False, allow_mmap=True, flags=0):
+    """Get the file contents at filepath as fast as possible
+
+    :return: random access compatible memory of the given filepath
+    :param stream: see ``file_contents_ro``
+    :param allow_mmap: see ``file_contents_ro``
+    :param flags: additional flags to pass to os.open
+    :raise OSError: If the file could not be opened
+
+    **Note** for now we don't try to use O_NOATIME directly as the right value needs to be
+    shared per database in fact. It only makes a real difference for loose object
+    databases anyway, and they use it with the help of the ``flags`` parameter"""
+    fd = os.open(filepath, os.O_RDONLY | getattr(os, 'O_BINARY', 0) | flags)
+    try:
+        return file_contents_ro(fd, stream, allow_mmap)
+    finally:
+        close(fd)
+    # END assure file is closed
+
+
+def sliding_ro_buffer(filepath, flags=0):
+    """
+    :return: a buffer compatible object which uses our mapped memory manager internally
+        ready to read the whole given filepath"""
+    return SlidingWindowMapBuffer(mman.make_cursor(filepath), flags=flags)
+
+
+def to_hex_sha(sha):
+    """:return: hexified version  of sha"""
+    if len(sha) == 40:
+        return sha
+    return bin_to_hex(sha)
+
+
+def to_bin_sha(sha):
+    if len(sha) == 20:
+        return sha
+    return hex_to_bin(sha)
+
+
+#} END routines
+
+
+#{ Utilities
+
+class LazyMixin:
+
+    """
+    Base class providing an interface to lazily retrieve attribute values upon
+    first access. If slots are used, memory will only be reserved once the attribute
+    is actually accessed and retrieved the first time. All future accesses will
+    return the cached value as stored in the Instance's dict or slot.
+    """
+
+    __slots__ = tuple()
+
+    def __getattr__(self, attr):
+        """
+        Whenever an attribute is requested that we do not know, we allow it
+        to be created and set. Next time the same attribute is requested, it is simply
+        returned from our dict/slots. """
+        self._set_cache_(attr)
+        # will raise in case the cache was not created
+        return object.__getattribute__(self, attr)
+
+    def _set_cache_(self, attr):
+        """
+        This method should be overridden in the derived class.
+        It should check whether the attribute named by attr can be created
+        and cached. Do nothing if you do not know the attribute or call your subclass
+
+        The derived class may create as many additional attributes as it deems
+        necessary in case a git command returns more information than represented
+        in the single attribute."""
+        pass
+
+
+class LockedFD:
+
+    """
+    This class facilitates a safe read and write operation to a file on disk.
+    If we write to 'file', we obtain a lock file at 'file.lock' and write to
+    that instead. If we succeed, the lock file will be renamed to overwrite
+    the original file.
+
+    When reading, we obtain a lock file, but to prevent other writers from
+    succeeding while we are reading the file.
+
+    This type handles error correctly in that it will assure a consistent state
+    on destruction.
+
+    **note** with this setup, parallel reading is not possible"""
+    __slots__ = ("_filepath", '_fd', '_write')
+
+    def __init__(self, filepath):
+        """Initialize an instance with the givne filepath"""
+        self._filepath = filepath
+        self._fd = None
+        self._write = None          # if True, we write a file
+
+    def __del__(self):
+        # will do nothing if the file descriptor is already closed
+        if self._fd is not None:
+            self.rollback()
+
+    def _lockfilepath(self):
+        return "%s.lock" % self._filepath
+
+    def open(self, write=False, stream=False):
+        """
+        Open the file descriptor for reading or writing, both in binary mode.
+
+        :param write: if True, the file descriptor will be opened for writing. Other
+            wise it will be opened read-only.
+        :param stream: if True, the file descriptor will be wrapped into a simple stream
+            object which supports only reading or writing
+        :return: fd to read from or write to. It is still maintained by this instance
+            and must not be closed directly
+        :raise IOError: if the lock could not be retrieved
+        :raise OSError: If the actual file could not be opened for reading
+
+        **note** must only be called once"""
+        if self._write is not None:
+            raise AssertionError("Called %s multiple times" % self.open)
+
+        self._write = write
+
+        # try to open the lock file
+        binary = getattr(os, 'O_BINARY', 0)
+        lockmode = os.O_WRONLY | os.O_CREAT | os.O_EXCL | binary
+        try:
+            fd = os.open(self._lockfilepath(), lockmode, int("600", 8))
+            if not write:
+                os.close(fd)
+            else:
+                self._fd = fd
+            # END handle file descriptor
+        except OSError as e:
+            raise OSError("Lock at %r could not be obtained" % self._lockfilepath()) from e
+        # END handle lock retrieval
+
+        # open actual file if required
+        if self._fd is None:
+            # we could specify exclusive here, as we obtained the lock anyway
+            try:
+                self._fd = os.open(self._filepath, os.O_RDONLY | binary)
+            except:
+                # assure we release our lockfile
+                remove(self._lockfilepath())
+                raise
+            # END handle lockfile
+        # END open descriptor for reading
+
+        if stream:
+            # need delayed import
+            from gitdb.stream import FDStream
+            return FDStream(self._fd)
+        else:
+            return self._fd
+        # END handle stream
+
+    def commit(self):
+        """When done writing, call this function to commit your changes into the
+        actual file.
+        The file descriptor will be closed, and the lockfile handled.
+
+        **Note** can be called multiple times"""
+        self._end_writing(successful=True)
+
+    def rollback(self):
+        """Abort your operation without any changes. The file descriptor will be
+        closed, and the lock released.
+
+        **Note** can be called multiple times"""
+        self._end_writing(successful=False)
+
+    def _end_writing(self, successful=True):
+        """Handle the lock according to the write mode """
+        if self._write is None:
+            raise AssertionError("Cannot end operation if it wasn't started yet")
+
+        if self._fd is None:
+            return
+
+        os.close(self._fd)
+        self._fd = None
+
+        lockfile = self._lockfilepath()
+        if self._write and successful:
+            # on windows, rename does not silently overwrite the existing one
+            if sys.platform == "win32":
+                if isfile(self._filepath):
+                    remove(self._filepath)
+                # END remove if exists
+            # END win32 special handling
+            os.rename(lockfile, self._filepath)
+
+            # assure others can at least read the file - the tmpfile left it at rw--
+            # We may also write that file, on windows that boils down to a remove-
+            # protection as well
+            chmod(self._filepath, int("644", 8))
+        else:
+            # just delete the file so far, we failed
+            remove(lockfile)
+        # END successful handling
+
+#} END utilities
diff --git a/llm/Lib/site-packages/gitdb/utils/__init__.py b/llm/Lib/site-packages/gitdb/utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/gitdb/utils/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/gitdb/utils/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1318f5fa0f44e040e78f50c554fec8dc2eb0efd3
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/utils/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/utils/__pycache__/encoding.cpython-311.pyc b/llm/Lib/site-packages/gitdb/utils/__pycache__/encoding.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..414f0971549d11bf7dd92cb9c15affdbb29e8603
Binary files /dev/null and b/llm/Lib/site-packages/gitdb/utils/__pycache__/encoding.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/gitdb/utils/encoding.py b/llm/Lib/site-packages/gitdb/utils/encoding.py
new file mode 100644
index 0000000000000000000000000000000000000000..b534ef7633e0c21b74a41b9b922083990804a2d8
--- /dev/null
+++ b/llm/Lib/site-packages/gitdb/utils/encoding.py
@@ -0,0 +1,18 @@
+def force_bytes(data, encoding="utf-8"):
+    if isinstance(data, bytes):
+        return data
+
+    if isinstance(data, str):
+        return data.encode(encoding)
+
+    return data
+
+
+def force_text(data, encoding="utf-8"):
+    if isinstance(data, str):
+        return data
+
+    if isinstance(data, bytes):
+        return data.decode(encoding)
+
+    return str(data, encoding)
diff --git a/llm/Lib/site-packages/google/_upb/_message.pyd b/llm/Lib/site-packages/google/_upb/_message.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..0573b4a87e40deb060386885a686258657621262
Binary files /dev/null and b/llm/Lib/site-packages/google/_upb/_message.pyd differ
diff --git a/llm/Lib/site-packages/google/protobuf/__init__.py b/llm/Lib/site-packages/google/protobuf/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..244d140df096bf5381d9227dfc4452d0f124da48
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/__init__.py
@@ -0,0 +1,10 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+# Copyright 2007 Google Inc. All Rights Reserved.
+
+__version__ = '4.25.3'
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..51bf4ac3632c3e2bad6099e567907226fa6dc107
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/any_pb2.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/any_pb2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a34850f212b689af71718c67b1653f52a4d6d5ed
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/any_pb2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/api_pb2.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/api_pb2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f8f31c612c5e3c07265705208f18658781c324c9
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/api_pb2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/descriptor.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/descriptor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a72d082550e581b6ddfc51ca192347e8dc823256
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/descriptor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/descriptor_database.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/descriptor_database.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b6701590ff354538995855014f52c5b946ebdd92
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/descriptor_database.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/descriptor_pb2.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/descriptor_pb2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c52a4f8d9d52f8d7a911ef5107ab0654289702bb
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/descriptor_pb2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/descriptor_pool.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/descriptor_pool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..90863a9baa96938123ca342eb5e4f7ccb7305fde
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/descriptor_pool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/duration_pb2.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/duration_pb2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..87c702b30589ec2751cd9906b2d21f778706bc15
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/duration_pb2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/empty_pb2.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/empty_pb2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7500aee05967e25acd9720a2a5319f6156ab9684
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/empty_pb2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/field_mask_pb2.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/field_mask_pb2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bf0c428a8e3a5acaee01045be8760136c5ecba0f
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/field_mask_pb2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/json_format.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/json_format.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e806445bfbb4edcd77b601106995a51134d2a8c8
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/json_format.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/message.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..65bb47a178d4a9878ceb9436c36dce30035728d4
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/message_factory.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/message_factory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9f6fd6c3333a907a73db144bd65fb978039355f4
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/message_factory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/proto_builder.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/proto_builder.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..82559333e1b5bfc52b0cba9215d779635b9bbf61
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/proto_builder.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/reflection.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/reflection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a3b5b35c74e8356ce14ca11da0da831ca4fa2dc5
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/reflection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/service.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/service.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..99401f2a2cd4901ea0a6fcb90daa1bbd6fb493b6
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/service.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/service_reflection.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/service_reflection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0c02e25cc99fd27f6335b15d8986af524835e0ed
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/service_reflection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/source_context_pb2.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/source_context_pb2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..69ce0b70ace943a05bb67c7ccf8218a4978268e5
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/source_context_pb2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/struct_pb2.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/struct_pb2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d772e87806df8d2788146b24c1f280e24560bf3f
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/struct_pb2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/symbol_database.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/symbol_database.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a12e6658ceb1933d2d74711ba3c8ced0884e5827
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/symbol_database.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/text_encoding.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/text_encoding.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dc8224d8a6bc033cb1d5c533d2ce3d11e5ed7007
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/text_encoding.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/text_format.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/text_format.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cb60396e31852d8c4128544471953e883c79cf34
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/text_format.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/timestamp_pb2.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/timestamp_pb2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cda84596d7ebfc1b218ac6d96d5c24632d418b41
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/timestamp_pb2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/type_pb2.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/type_pb2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d27f21f3b6d4fe57458380f337d4b4e0bc2708c3
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/type_pb2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/unknown_fields.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/unknown_fields.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fd9e4a4c54f3ab97b020b6fd588f48d35e6126e5
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/unknown_fields.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/__pycache__/wrappers_pb2.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/__pycache__/wrappers_pb2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d16f84ca1fc95e2b38aa9a9c55e4ae352cd38b6f
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/__pycache__/wrappers_pb2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/any_pb2.py b/llm/Lib/site-packages/google/protobuf/any_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..f9a7315e168a8a0696c4b0b2671bf98f72647447
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/any_pb2.py
@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/any.proto
+# Protobuf Python Version: 4.25.3
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x19google/protobuf/any.proto\x12\x0fgoogle.protobuf\"6\n\x03\x41ny\x12\x19\n\x08type_url\x18\x01 \x01(\tR\x07typeUrl\x12\x14\n\x05value\x18\x02 \x01(\x0cR\x05valueBv\n\x13\x63om.google.protobufB\x08\x41nyProtoP\x01Z,google.golang.org/protobuf/types/known/anypb\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'google.protobuf.any_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\023com.google.protobufB\010AnyProtoP\001Z,google.golang.org/protobuf/types/known/anypb\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes'
+  _globals['_ANY']._serialized_start=46
+  _globals['_ANY']._serialized_end=100
+# @@protoc_insertion_point(module_scope)
diff --git a/llm/Lib/site-packages/google/protobuf/api_pb2.py b/llm/Lib/site-packages/google/protobuf/api_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..41300b6ef2b38f616482e2eb7aab61f8fda84048
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/api_pb2.py
@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/api.proto
+# Protobuf Python Version: 4.25.3
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import source_context_pb2 as google_dot_protobuf_dot_source__context__pb2
+from google.protobuf import type_pb2 as google_dot_protobuf_dot_type__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x19google/protobuf/api.proto\x12\x0fgoogle.protobuf\x1a$google/protobuf/source_context.proto\x1a\x1agoogle/protobuf/type.proto\"\xc1\x02\n\x03\x41pi\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x31\n\x07methods\x18\x02 \x03(\x0b\x32\x17.google.protobuf.MethodR\x07methods\x12\x31\n\x07options\x18\x03 \x03(\x0b\x32\x17.google.protobuf.OptionR\x07options\x12\x18\n\x07version\x18\x04 \x01(\tR\x07version\x12\x45\n\x0esource_context\x18\x05 \x01(\x0b\x32\x1e.google.protobuf.SourceContextR\rsourceContext\x12.\n\x06mixins\x18\x06 \x03(\x0b\x32\x16.google.protobuf.MixinR\x06mixins\x12/\n\x06syntax\x18\x07 \x01(\x0e\x32\x17.google.protobuf.SyntaxR\x06syntax\"\xb2\x02\n\x06Method\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12(\n\x10request_type_url\x18\x02 \x01(\tR\x0erequestTypeUrl\x12+\n\x11request_streaming\x18\x03 \x01(\x08R\x10requestStreaming\x12*\n\x11response_type_url\x18\x04 \x01(\tR\x0fresponseTypeUrl\x12-\n\x12response_streaming\x18\x05 \x01(\x08R\x11responseStreaming\x12\x31\n\x07options\x18\x06 \x03(\x0b\x32\x17.google.protobuf.OptionR\x07options\x12/\n\x06syntax\x18\x07 \x01(\x0e\x32\x17.google.protobuf.SyntaxR\x06syntax\"/\n\x05Mixin\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x12\n\x04root\x18\x02 \x01(\tR\x04rootBv\n\x13\x63om.google.protobufB\x08\x41piProtoP\x01Z,google.golang.org/protobuf/types/known/apipb\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'google.protobuf.api_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\023com.google.protobufB\010ApiProtoP\001Z,google.golang.org/protobuf/types/known/apipb\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes'
+  _globals['_API']._serialized_start=113
+  _globals['_API']._serialized_end=434
+  _globals['_METHOD']._serialized_start=437
+  _globals['_METHOD']._serialized_end=743
+  _globals['_MIXIN']._serialized_start=745
+  _globals['_MIXIN']._serialized_end=792
+# @@protoc_insertion_point(module_scope)
diff --git a/llm/Lib/site-packages/google/protobuf/compiler/__init__.py b/llm/Lib/site-packages/google/protobuf/compiler/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/google/protobuf/compiler/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/compiler/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1e54b1456f512d0acdf1008212aa115040dd8ef4
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/compiler/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/compiler/__pycache__/plugin_pb2.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/compiler/__pycache__/plugin_pb2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8fcd6670f5d1794b4f8c0d01135c6aee630103f7
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/compiler/__pycache__/plugin_pb2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/compiler/plugin_pb2.py b/llm/Lib/site-packages/google/protobuf/compiler/plugin_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..7b520809b0c96c78528fee09bc4c0ec5348d9a80
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/compiler/plugin_pb2.py
@@ -0,0 +1,36 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/compiler/plugin.proto
+# Protobuf Python Version: 4.25.3
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import descriptor_pb2 as google_dot_protobuf_dot_descriptor__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n%google/protobuf/compiler/plugin.proto\x12\x18google.protobuf.compiler\x1a google/protobuf/descriptor.proto\"c\n\x07Version\x12\x14\n\x05major\x18\x01 \x01(\x05R\x05major\x12\x14\n\x05minor\x18\x02 \x01(\x05R\x05minor\x12\x14\n\x05patch\x18\x03 \x01(\x05R\x05patch\x12\x16\n\x06suffix\x18\x04 \x01(\tR\x06suffix\"\xcf\x02\n\x14\x43odeGeneratorRequest\x12(\n\x10\x66ile_to_generate\x18\x01 \x03(\tR\x0e\x66ileToGenerate\x12\x1c\n\tparameter\x18\x02 \x01(\tR\tparameter\x12\x43\n\nproto_file\x18\x0f \x03(\x0b\x32$.google.protobuf.FileDescriptorProtoR\tprotoFile\x12\\\n\x17source_file_descriptors\x18\x11 \x03(\x0b\x32$.google.protobuf.FileDescriptorProtoR\x15sourceFileDescriptors\x12L\n\x10\x63ompiler_version\x18\x03 \x01(\x0b\x32!.google.protobuf.compiler.VersionR\x0f\x63ompilerVersion\"\xb3\x03\n\x15\x43odeGeneratorResponse\x12\x14\n\x05\x65rror\x18\x01 \x01(\tR\x05\x65rror\x12-\n\x12supported_features\x18\x02 \x01(\x04R\x11supportedFeatures\x12H\n\x04\x66ile\x18\x0f \x03(\x0b\x32\x34.google.protobuf.compiler.CodeGeneratorResponse.FileR\x04\x66ile\x1a\xb1\x01\n\x04\x46ile\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\'\n\x0finsertion_point\x18\x02 \x01(\tR\x0einsertionPoint\x12\x18\n\x07\x63ontent\x18\x0f \x01(\tR\x07\x63ontent\x12R\n\x13generated_code_info\x18\x10 \x01(\x0b\x32\".google.protobuf.GeneratedCodeInfoR\x11generatedCodeInfo\"W\n\x07\x46\x65\x61ture\x12\x10\n\x0c\x46\x45\x41TURE_NONE\x10\x00\x12\x1b\n\x17\x46\x45\x41TURE_PROTO3_OPTIONAL\x10\x01\x12\x1d\n\x19\x46\x45\x41TURE_SUPPORTS_EDITIONS\x10\x02\x42r\n\x1c\x63om.google.protobuf.compilerB\x0cPluginProtosZ)google.golang.org/protobuf/types/pluginpb\xaa\x02\x18Google.Protobuf.Compiler')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'google.protobuf.compiler.plugin_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\034com.google.protobuf.compilerB\014PluginProtosZ)google.golang.org/protobuf/types/pluginpb\252\002\030Google.Protobuf.Compiler'
+  _globals['_VERSION']._serialized_start=101
+  _globals['_VERSION']._serialized_end=200
+  _globals['_CODEGENERATORREQUEST']._serialized_start=203
+  _globals['_CODEGENERATORREQUEST']._serialized_end=538
+  _globals['_CODEGENERATORRESPONSE']._serialized_start=541
+  _globals['_CODEGENERATORRESPONSE']._serialized_end=976
+  _globals['_CODEGENERATORRESPONSE_FILE']._serialized_start=710
+  _globals['_CODEGENERATORRESPONSE_FILE']._serialized_end=887
+  _globals['_CODEGENERATORRESPONSE_FEATURE']._serialized_start=889
+  _globals['_CODEGENERATORRESPONSE_FEATURE']._serialized_end=976
+# @@protoc_insertion_point(module_scope)
diff --git a/llm/Lib/site-packages/google/protobuf/descriptor.py b/llm/Lib/site-packages/google/protobuf/descriptor.py
new file mode 100644
index 0000000000000000000000000000000000000000..5b32e5e1546d1390826ef39d6cd98d42252d5e3b
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/descriptor.py
@@ -0,0 +1,1282 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Descriptors essentially contain exactly the information found in a .proto
+file, in types that make this information accessible in Python.
+"""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+import threading
+import warnings
+
+from google.protobuf.internal import api_implementation
+
+_USE_C_DESCRIPTORS = False
+if api_implementation.Type() != 'python':
+  # Used by MakeDescriptor in cpp mode
+  import binascii
+  import os
+  # pylint: disable=protected-access
+  _message = api_implementation._c_module
+  # TODO: Remove this import after fix api_implementation
+  if _message is None:
+    from google.protobuf.pyext import _message
+  _USE_C_DESCRIPTORS = True
+
+
+class Error(Exception):
+  """Base error for this module."""
+
+
+class TypeTransformationError(Error):
+  """Error transforming between python proto type and corresponding C++ type."""
+
+
+if _USE_C_DESCRIPTORS:
+  # This metaclass allows to override the behavior of code like
+  #     isinstance(my_descriptor, FieldDescriptor)
+  # and make it return True when the descriptor is an instance of the extension
+  # type written in C++.
+  class DescriptorMetaclass(type):
+
+    def __instancecheck__(cls, obj):
+      if super(DescriptorMetaclass, cls).__instancecheck__(obj):
+        return True
+      if isinstance(obj, cls._C_DESCRIPTOR_CLASS):
+        return True
+      return False
+else:
+  # The standard metaclass; nothing changes.
+  DescriptorMetaclass = type
+
+
+class _Lock(object):
+  """Wrapper class of threading.Lock(), which is allowed by 'with'."""
+
+  def __new__(cls):
+    self = object.__new__(cls)
+    self._lock = threading.Lock()  # pylint: disable=protected-access
+    return self
+
+  def __enter__(self):
+    self._lock.acquire()
+
+  def __exit__(self, exc_type, exc_value, exc_tb):
+    self._lock.release()
+
+
+_lock = threading.Lock()
+
+
+def _Deprecated(name):
+  if _Deprecated.count > 0:
+    _Deprecated.count -= 1
+    warnings.warn(
+        'Call to deprecated create function %s(). Note: Create unlinked '
+        'descriptors is going to go away. Please use get/find descriptors from '
+        'generated code or query the descriptor_pool.'
+        % name,
+        category=DeprecationWarning, stacklevel=3)
+
+
+# Deprecated warnings will print 100 times at most which should be enough for
+# users to notice and do not cause timeout.
+_Deprecated.count = 100
+
+
+_internal_create_key = object()
+
+
+class DescriptorBase(metaclass=DescriptorMetaclass):
+
+  """Descriptors base class.
+
+  This class is the base of all descriptor classes. It provides common options
+  related functionality.
+
+  Attributes:
+    has_options:  True if the descriptor has non-default options.  Usually it is
+      not necessary to read this -- just call GetOptions() which will happily
+      return the default instance.  However, it's sometimes useful for
+      efficiency, and also useful inside the protobuf implementation to avoid
+      some bootstrapping issues.
+    file (FileDescriptor): Reference to file info.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    # The class, or tuple of classes, that are considered as "virtual
+    # subclasses" of this descriptor class.
+    _C_DESCRIPTOR_CLASS = ()
+
+  def __init__(self, file, options, serialized_options, options_class_name):
+    """Initialize the descriptor given its options message and the name of the
+    class of the options message. The name of the class is required in case
+    the options message is None and has to be created.
+    """
+    self.file = file
+    self._options = options
+    self._options_class_name = options_class_name
+    self._serialized_options = serialized_options
+
+    # Does this descriptor have non-default options?
+    self.has_options = (self._options is not None) or (
+        self._serialized_options is not None
+    )
+
+  def _SetOptions(self, options, options_class_name):
+    """Sets the descriptor's options
+
+    This function is used in generated proto2 files to update descriptor
+    options. It must not be used outside proto2.
+    """
+    self._options = options
+    self._options_class_name = options_class_name
+
+    # Does this descriptor have non-default options?
+    self.has_options = options is not None
+
+  def GetOptions(self):
+    """Retrieves descriptor options.
+
+    This method returns the options set or creates the default options for the
+    descriptor.
+    """
+    if self._options:
+      return self._options
+
+    from google.protobuf import descriptor_pb2
+    try:
+      options_class = getattr(descriptor_pb2,
+                              self._options_class_name)
+    except AttributeError:
+      raise RuntimeError('Unknown options class name %s!' %
+                         (self._options_class_name))
+
+    if self._serialized_options is None:
+      with _lock:
+        self._options = options_class()
+    else:
+      options = _ParseOptions(options_class(), self._serialized_options)
+      with _lock:
+        self._options = options
+
+    return self._options
+
+
+class _NestedDescriptorBase(DescriptorBase):
+  """Common class for descriptors that can be nested."""
+
+  def __init__(self, options, options_class_name, name, full_name,
+               file, containing_type, serialized_start=None,
+               serialized_end=None, serialized_options=None):
+    """Constructor.
+
+    Args:
+      options: Protocol message options or None to use default message options.
+      options_class_name (str): The class name of the above options.
+      name (str): Name of this protocol message type.
+      full_name (str): Fully-qualified name of this protocol message type, which
+        will include protocol "package" name and the name of any enclosing
+        types.
+      containing_type: if provided, this is a nested descriptor, with this
+        descriptor as parent, otherwise None.
+      serialized_start: The start index (inclusive) in block in the
+        file.serialized_pb that describes this descriptor.
+      serialized_end: The end index (exclusive) in block in the
+        file.serialized_pb that describes this descriptor.
+      serialized_options: Protocol message serialized options or None.
+    """
+    super(_NestedDescriptorBase, self).__init__(
+        file, options, serialized_options, options_class_name
+    )
+
+    self.name = name
+    # TODO: Add function to calculate full_name instead of having it in
+    #             memory?
+    self.full_name = full_name
+    self.containing_type = containing_type
+
+    self._serialized_start = serialized_start
+    self._serialized_end = serialized_end
+
+  def CopyToProto(self, proto):
+    """Copies this to the matching proto in descriptor_pb2.
+
+    Args:
+      proto: An empty proto instance from descriptor_pb2.
+
+    Raises:
+      Error: If self couldn't be serialized, due to to few constructor
+        arguments.
+    """
+    if (self.file is not None and
+        self._serialized_start is not None and
+        self._serialized_end is not None):
+      proto.ParseFromString(self.file.serialized_pb[
+          self._serialized_start:self._serialized_end])
+    else:
+      raise Error('Descriptor does not contain serialization.')
+
+
+class Descriptor(_NestedDescriptorBase):
+
+  """Descriptor for a protocol message type.
+
+  Attributes:
+      name (str): Name of this protocol message type.
+      full_name (str): Fully-qualified name of this protocol message type,
+          which will include protocol "package" name and the name of any
+          enclosing types.
+      containing_type (Descriptor): Reference to the descriptor of the type
+          containing us, or None if this is top-level.
+      fields (list[FieldDescriptor]): Field descriptors for all fields in
+          this type.
+      fields_by_number (dict(int, FieldDescriptor)): Same
+          :class:`FieldDescriptor` objects as in :attr:`fields`, but indexed
+          by "number" attribute in each FieldDescriptor.
+      fields_by_name (dict(str, FieldDescriptor)): Same
+          :class:`FieldDescriptor` objects as in :attr:`fields`, but indexed by
+          "name" attribute in each :class:`FieldDescriptor`.
+      nested_types (list[Descriptor]): Descriptor references
+          for all protocol message types nested within this one.
+      nested_types_by_name (dict(str, Descriptor)): Same Descriptor
+          objects as in :attr:`nested_types`, but indexed by "name" attribute
+          in each Descriptor.
+      enum_types (list[EnumDescriptor]): :class:`EnumDescriptor` references
+          for all enums contained within this type.
+      enum_types_by_name (dict(str, EnumDescriptor)): Same
+          :class:`EnumDescriptor` objects as in :attr:`enum_types`, but
+          indexed by "name" attribute in each EnumDescriptor.
+      enum_values_by_name (dict(str, EnumValueDescriptor)): Dict mapping
+          from enum value name to :class:`EnumValueDescriptor` for that value.
+      extensions (list[FieldDescriptor]): All extensions defined directly
+          within this message type (NOT within a nested type).
+      extensions_by_name (dict(str, FieldDescriptor)): Same FieldDescriptor
+          objects as :attr:`extensions`, but indexed by "name" attribute of each
+          FieldDescriptor.
+      is_extendable (bool):  Does this type define any extension ranges?
+      oneofs (list[OneofDescriptor]): The list of descriptors for oneof fields
+          in this message.
+      oneofs_by_name (dict(str, OneofDescriptor)): Same objects as in
+          :attr:`oneofs`, but indexed by "name" attribute.
+      file (FileDescriptor): Reference to file descriptor.
+      is_map_entry: If the message type is a map entry.
+
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.Descriptor
+
+    def __new__(
+        cls,
+        name=None,
+        full_name=None,
+        filename=None,
+        containing_type=None,
+        fields=None,
+        nested_types=None,
+        enum_types=None,
+        extensions=None,
+        options=None,
+        serialized_options=None,
+        is_extendable=True,
+        extension_ranges=None,
+        oneofs=None,
+        file=None,  # pylint: disable=redefined-builtin
+        serialized_start=None,
+        serialized_end=None,
+        syntax=None,
+        is_map_entry=False,
+        create_key=None):
+      _message.Message._CheckCalledFromGeneratedFile()
+      return _message.default_pool.FindMessageTypeByName(full_name)
+
+  # NOTE: The file argument redefining a builtin is nothing we can
+  # fix right now since we don't know how many clients already rely on the
+  # name of the argument.
+  def __init__(self, name, full_name, filename, containing_type, fields,
+               nested_types, enum_types, extensions, options=None,
+               serialized_options=None,
+               is_extendable=True, extension_ranges=None, oneofs=None,
+               file=None, serialized_start=None, serialized_end=None,  # pylint: disable=redefined-builtin
+               syntax=None, is_map_entry=False, create_key=None):
+    """Arguments to __init__() are as described in the description
+    of Descriptor fields above.
+
+    Note that filename is an obsolete argument, that is not used anymore.
+    Please use file.name to access this as an attribute.
+    """
+    if create_key is not _internal_create_key:
+      _Deprecated('Descriptor')
+
+    super(Descriptor, self).__init__(
+        options, 'MessageOptions', name, full_name, file,
+        containing_type, serialized_start=serialized_start,
+        serialized_end=serialized_end, serialized_options=serialized_options)
+
+    # We have fields in addition to fields_by_name and fields_by_number,
+    # so that:
+    #   1. Clients can index fields by "order in which they're listed."
+    #   2. Clients can easily iterate over all fields with the terse
+    #      syntax: for f in descriptor.fields: ...
+    self.fields = fields
+    for field in self.fields:
+      field.containing_type = self
+    self.fields_by_number = dict((f.number, f) for f in fields)
+    self.fields_by_name = dict((f.name, f) for f in fields)
+    self._fields_by_camelcase_name = None
+
+    self.nested_types = nested_types
+    for nested_type in nested_types:
+      nested_type.containing_type = self
+    self.nested_types_by_name = dict((t.name, t) for t in nested_types)
+
+    self.enum_types = enum_types
+    for enum_type in self.enum_types:
+      enum_type.containing_type = self
+    self.enum_types_by_name = dict((t.name, t) for t in enum_types)
+    self.enum_values_by_name = dict(
+        (v.name, v) for t in enum_types for v in t.values)
+
+    self.extensions = extensions
+    for extension in self.extensions:
+      extension.extension_scope = self
+    self.extensions_by_name = dict((f.name, f) for f in extensions)
+    self.is_extendable = is_extendable
+    self.extension_ranges = extension_ranges
+    self.oneofs = oneofs if oneofs is not None else []
+    self.oneofs_by_name = dict((o.name, o) for o in self.oneofs)
+    for oneof in self.oneofs:
+      oneof.containing_type = self
+    self._deprecated_syntax = syntax or "proto2"
+    self._is_map_entry = is_map_entry
+
+  @property
+  def syntax(self):
+    warnings.warn(
+      'descriptor.syntax is deprecated. It will be removed'
+      ' soon. Most usages are checking field descriptors. Consider to use'
+      ' has_presence, is_packed on field descriptors.'
+    )
+    return self._deprecated_syntax
+
+  @property
+  def fields_by_camelcase_name(self):
+    """Same FieldDescriptor objects as in :attr:`fields`, but indexed by
+    :attr:`FieldDescriptor.camelcase_name`.
+    """
+    if self._fields_by_camelcase_name is None:
+      self._fields_by_camelcase_name = dict(
+          (f.camelcase_name, f) for f in self.fields)
+    return self._fields_by_camelcase_name
+
+  def EnumValueName(self, enum, value):
+    """Returns the string name of an enum value.
+
+    This is just a small helper method to simplify a common operation.
+
+    Args:
+      enum: string name of the Enum.
+      value: int, value of the enum.
+
+    Returns:
+      string name of the enum value.
+
+    Raises:
+      KeyError if either the Enum doesn't exist or the value is not a valid
+        value for the enum.
+    """
+    return self.enum_types_by_name[enum].values_by_number[value].name
+
+  def CopyToProto(self, proto):
+    """Copies this to a descriptor_pb2.DescriptorProto.
+
+    Args:
+      proto: An empty descriptor_pb2.DescriptorProto.
+    """
+    # This function is overridden to give a better doc comment.
+    super(Descriptor, self).CopyToProto(proto)
+
+
+# TODO: We should have aggressive checking here,
+# for example:
+#   * If you specify a repeated field, you should not be allowed
+#     to specify a default value.
+#   * [Other examples here as needed].
+#
+# TODO: for this and other *Descriptor classes, we
+# might also want to lock things down aggressively (e.g.,
+# prevent clients from setting the attributes).  Having
+# stronger invariants here in general will reduce the number
+# of runtime checks we must do in reflection.py...
+class FieldDescriptor(DescriptorBase):
+
+  """Descriptor for a single field in a .proto file.
+
+  Attributes:
+    name (str): Name of this field, exactly as it appears in .proto.
+    full_name (str): Name of this field, including containing scope.  This is
+      particularly relevant for extensions.
+    index (int): Dense, 0-indexed index giving the order that this
+      field textually appears within its message in the .proto file.
+    number (int): Tag number declared for this field in the .proto file.
+
+    type (int): (One of the TYPE_* constants below) Declared type.
+    cpp_type (int): (One of the CPPTYPE_* constants below) C++ type used to
+      represent this field.
+
+    label (int): (One of the LABEL_* constants below) Tells whether this
+      field is optional, required, or repeated.
+    has_default_value (bool): True if this field has a default value defined,
+      otherwise false.
+    default_value (Varies): Default value of this field.  Only
+      meaningful for non-repeated scalar fields.  Repeated fields
+      should always set this to [], and non-repeated composite
+      fields should always set this to None.
+
+    containing_type (Descriptor): Descriptor of the protocol message
+      type that contains this field.  Set by the Descriptor constructor
+      if we're passed into one.
+      Somewhat confusingly, for extension fields, this is the
+      descriptor of the EXTENDED message, not the descriptor
+      of the message containing this field.  (See is_extension and
+      extension_scope below).
+    message_type (Descriptor): If a composite field, a descriptor
+      of the message type contained in this field.  Otherwise, this is None.
+    enum_type (EnumDescriptor): If this field contains an enum, a
+      descriptor of that enum.  Otherwise, this is None.
+
+    is_extension: True iff this describes an extension field.
+    extension_scope (Descriptor): Only meaningful if is_extension is True.
+      Gives the message that immediately contains this extension field.
+      Will be None iff we're a top-level (file-level) extension field.
+
+    options (descriptor_pb2.FieldOptions): Protocol message field options or
+      None to use default field options.
+
+    containing_oneof (OneofDescriptor): If the field is a member of a oneof
+      union, contains its descriptor. Otherwise, None.
+
+    file (FileDescriptor): Reference to file descriptor.
+  """
+
+  # Must be consistent with C++ FieldDescriptor::Type enum in
+  # descriptor.h.
+  #
+  # TODO: Find a way to eliminate this repetition.
+  TYPE_DOUBLE         = 1
+  TYPE_FLOAT          = 2
+  TYPE_INT64          = 3
+  TYPE_UINT64         = 4
+  TYPE_INT32          = 5
+  TYPE_FIXED64        = 6
+  TYPE_FIXED32        = 7
+  TYPE_BOOL           = 8
+  TYPE_STRING         = 9
+  TYPE_GROUP          = 10
+  TYPE_MESSAGE        = 11
+  TYPE_BYTES          = 12
+  TYPE_UINT32         = 13
+  TYPE_ENUM           = 14
+  TYPE_SFIXED32       = 15
+  TYPE_SFIXED64       = 16
+  TYPE_SINT32         = 17
+  TYPE_SINT64         = 18
+  MAX_TYPE            = 18
+
+  # Must be consistent with C++ FieldDescriptor::CppType enum in
+  # descriptor.h.
+  #
+  # TODO: Find a way to eliminate this repetition.
+  CPPTYPE_INT32       = 1
+  CPPTYPE_INT64       = 2
+  CPPTYPE_UINT32      = 3
+  CPPTYPE_UINT64      = 4
+  CPPTYPE_DOUBLE      = 5
+  CPPTYPE_FLOAT       = 6
+  CPPTYPE_BOOL        = 7
+  CPPTYPE_ENUM        = 8
+  CPPTYPE_STRING      = 9
+  CPPTYPE_MESSAGE     = 10
+  MAX_CPPTYPE         = 10
+
+  _PYTHON_TO_CPP_PROTO_TYPE_MAP = {
+      TYPE_DOUBLE: CPPTYPE_DOUBLE,
+      TYPE_FLOAT: CPPTYPE_FLOAT,
+      TYPE_ENUM: CPPTYPE_ENUM,
+      TYPE_INT64: CPPTYPE_INT64,
+      TYPE_SINT64: CPPTYPE_INT64,
+      TYPE_SFIXED64: CPPTYPE_INT64,
+      TYPE_UINT64: CPPTYPE_UINT64,
+      TYPE_FIXED64: CPPTYPE_UINT64,
+      TYPE_INT32: CPPTYPE_INT32,
+      TYPE_SFIXED32: CPPTYPE_INT32,
+      TYPE_SINT32: CPPTYPE_INT32,
+      TYPE_UINT32: CPPTYPE_UINT32,
+      TYPE_FIXED32: CPPTYPE_UINT32,
+      TYPE_BYTES: CPPTYPE_STRING,
+      TYPE_STRING: CPPTYPE_STRING,
+      TYPE_BOOL: CPPTYPE_BOOL,
+      TYPE_MESSAGE: CPPTYPE_MESSAGE,
+      TYPE_GROUP: CPPTYPE_MESSAGE
+      }
+
+  # Must be consistent with C++ FieldDescriptor::Label enum in
+  # descriptor.h.
+  #
+  # TODO: Find a way to eliminate this repetition.
+  LABEL_OPTIONAL      = 1
+  LABEL_REQUIRED      = 2
+  LABEL_REPEATED      = 3
+  MAX_LABEL           = 3
+
+  # Must be consistent with C++ constants kMaxNumber, kFirstReservedNumber,
+  # and kLastReservedNumber in descriptor.h
+  MAX_FIELD_NUMBER = (1 << 29) - 1
+  FIRST_RESERVED_FIELD_NUMBER = 19000
+  LAST_RESERVED_FIELD_NUMBER = 19999
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.FieldDescriptor
+
+    def __new__(cls, name, full_name, index, number, type, cpp_type, label,
+                default_value, message_type, enum_type, containing_type,
+                is_extension, extension_scope, options=None,
+                serialized_options=None,
+                has_default_value=True, containing_oneof=None, json_name=None,
+                file=None, create_key=None):  # pylint: disable=redefined-builtin
+      _message.Message._CheckCalledFromGeneratedFile()
+      if is_extension:
+        return _message.default_pool.FindExtensionByName(full_name)
+      else:
+        return _message.default_pool.FindFieldByName(full_name)
+
+  def __init__(self, name, full_name, index, number, type, cpp_type, label,
+               default_value, message_type, enum_type, containing_type,
+               is_extension, extension_scope, options=None,
+               serialized_options=None,
+               has_default_value=True, containing_oneof=None, json_name=None,
+               file=None, create_key=None):  # pylint: disable=redefined-builtin
+    """The arguments are as described in the description of FieldDescriptor
+    attributes above.
+
+    Note that containing_type may be None, and may be set later if necessary
+    (to deal with circular references between message types, for example).
+    Likewise for extension_scope.
+    """
+    if create_key is not _internal_create_key:
+      _Deprecated('FieldDescriptor')
+
+    super(FieldDescriptor, self).__init__(
+        file, options, serialized_options, 'FieldOptions'
+    )
+    self.name = name
+    self.full_name = full_name
+    self._camelcase_name = None
+    if json_name is None:
+      self.json_name = _ToJsonName(name)
+    else:
+      self.json_name = json_name
+    self.index = index
+    self.number = number
+    self.type = type
+    self.cpp_type = cpp_type
+    self.label = label
+    self.has_default_value = has_default_value
+    self.default_value = default_value
+    self.containing_type = containing_type
+    self.message_type = message_type
+    self.enum_type = enum_type
+    self.is_extension = is_extension
+    self.extension_scope = extension_scope
+    self.containing_oneof = containing_oneof
+    if api_implementation.Type() == 'python':
+      self._cdescriptor = None
+    else:
+      if is_extension:
+        self._cdescriptor = _message.default_pool.FindExtensionByName(full_name)
+      else:
+        self._cdescriptor = _message.default_pool.FindFieldByName(full_name)
+
+  @property
+  def camelcase_name(self):
+    """Camelcase name of this field.
+
+    Returns:
+      str: the name in CamelCase.
+    """
+    if self._camelcase_name is None:
+      self._camelcase_name = _ToCamelCase(self.name)
+    return self._camelcase_name
+
+  @property
+  def has_presence(self):
+    """Whether the field distinguishes between unpopulated and default values.
+
+    Raises:
+      RuntimeError: singular field that is not linked with message nor file.
+    """
+    if self.label == FieldDescriptor.LABEL_REPEATED:
+      return False
+    if (self.cpp_type == FieldDescriptor.CPPTYPE_MESSAGE or
+        self.containing_oneof):
+      return True
+    # self.containing_type is used here instead of self.file for legacy
+    # compatibility. FieldDescriptor.file was added in cl/153110619
+    # Some old/generated code didn't link file to FieldDescriptor.
+    # TODO: remove syntax usage b/240619313
+    return self.containing_type._deprecated_syntax == 'proto2'
+
+  @property
+  def is_packed(self):
+    """Returns if the field is packed."""
+    if self.label != FieldDescriptor.LABEL_REPEATED:
+      return False
+    field_type = self.type
+    if (field_type == FieldDescriptor.TYPE_STRING or
+        field_type == FieldDescriptor.TYPE_GROUP or
+        field_type == FieldDescriptor.TYPE_MESSAGE or
+        field_type == FieldDescriptor.TYPE_BYTES):
+      return False
+    if self.containing_type._deprecated_syntax == 'proto2':
+      return self.has_options and self.GetOptions().packed
+    else:
+      return (not self.has_options or
+              not self.GetOptions().HasField('packed') or
+              self.GetOptions().packed)
+
+  @staticmethod
+  def ProtoTypeToCppProtoType(proto_type):
+    """Converts from a Python proto type to a C++ Proto Type.
+
+    The Python ProtocolBuffer classes specify both the 'Python' datatype and the
+    'C++' datatype - and they're not the same. This helper method should
+    translate from one to another.
+
+    Args:
+      proto_type: the Python proto type (descriptor.FieldDescriptor.TYPE_*)
+    Returns:
+      int: descriptor.FieldDescriptor.CPPTYPE_*, the C++ type.
+    Raises:
+      TypeTransformationError: when the Python proto type isn't known.
+    """
+    try:
+      return FieldDescriptor._PYTHON_TO_CPP_PROTO_TYPE_MAP[proto_type]
+    except KeyError:
+      raise TypeTransformationError('Unknown proto_type: %s' % proto_type)
+
+
+class EnumDescriptor(_NestedDescriptorBase):
+
+  """Descriptor for an enum defined in a .proto file.
+
+  Attributes:
+    name (str): Name of the enum type.
+    full_name (str): Full name of the type, including package name
+      and any enclosing type(s).
+
+    values (list[EnumValueDescriptor]): List of the values
+      in this enum.
+    values_by_name (dict(str, EnumValueDescriptor)): Same as :attr:`values`,
+      but indexed by the "name" field of each EnumValueDescriptor.
+    values_by_number (dict(int, EnumValueDescriptor)): Same as :attr:`values`,
+      but indexed by the "number" field of each EnumValueDescriptor.
+    containing_type (Descriptor): Descriptor of the immediate containing
+      type of this enum, or None if this is an enum defined at the
+      top level in a .proto file.  Set by Descriptor's constructor
+      if we're passed into one.
+    file (FileDescriptor): Reference to file descriptor.
+    options (descriptor_pb2.EnumOptions): Enum options message or
+      None to use default enum options.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.EnumDescriptor
+
+    def __new__(cls, name, full_name, filename, values,
+                containing_type=None, options=None,
+                serialized_options=None, file=None,  # pylint: disable=redefined-builtin
+                serialized_start=None, serialized_end=None, create_key=None):
+      _message.Message._CheckCalledFromGeneratedFile()
+      return _message.default_pool.FindEnumTypeByName(full_name)
+
+  def __init__(self, name, full_name, filename, values,
+               containing_type=None, options=None,
+               serialized_options=None, file=None,  # pylint: disable=redefined-builtin
+               serialized_start=None, serialized_end=None, create_key=None):
+    """Arguments are as described in the attribute description above.
+
+    Note that filename is an obsolete argument, that is not used anymore.
+    Please use file.name to access this as an attribute.
+    """
+    if create_key is not _internal_create_key:
+      _Deprecated('EnumDescriptor')
+
+    super(EnumDescriptor, self).__init__(
+        options, 'EnumOptions', name, full_name, file,
+        containing_type, serialized_start=serialized_start,
+        serialized_end=serialized_end, serialized_options=serialized_options)
+
+    self.values = values
+    for value in self.values:
+      value.file = file
+      value.type = self
+    self.values_by_name = dict((v.name, v) for v in values)
+    # Values are reversed to ensure that the first alias is retained.
+    self.values_by_number = dict((v.number, v) for v in reversed(values))
+
+  @property
+  def is_closed(self):
+    """Returns true whether this is a "closed" enum.
+
+    This means that it:
+    - Has a fixed set of values, rather than being equivalent to an int32.
+    - Encountering values not in this set causes them to be treated as unknown
+      fields.
+    - The first value (i.e., the default) may be nonzero.
+
+    WARNING: Some runtimes currently have a quirk where non-closed enums are
+    treated as closed when used as the type of fields defined in a
+    `syntax = proto2;` file. This quirk is not present in all runtimes; as of
+    writing, we know that:
+
+    - C++, Java, and C++-based Python share this quirk.
+    - UPB and UPB-based Python do not.
+    - PHP and Ruby treat all enums as open regardless of declaration.
+
+    Care should be taken when using this function to respect the target
+    runtime's enum handling quirks.
+    """
+    return self.file._deprecated_syntax == 'proto2'
+
+  def CopyToProto(self, proto):
+    """Copies this to a descriptor_pb2.EnumDescriptorProto.
+
+    Args:
+      proto (descriptor_pb2.EnumDescriptorProto): An empty descriptor proto.
+    """
+    # This function is overridden to give a better doc comment.
+    super(EnumDescriptor, self).CopyToProto(proto)
+
+
+class EnumValueDescriptor(DescriptorBase):
+
+  """Descriptor for a single value within an enum.
+
+  Attributes:
+    name (str): Name of this value.
+    index (int): Dense, 0-indexed index giving the order that this
+      value appears textually within its enum in the .proto file.
+    number (int): Actual number assigned to this enum value.
+    type (EnumDescriptor): :class:`EnumDescriptor` to which this value
+      belongs.  Set by :class:`EnumDescriptor`'s constructor if we're
+      passed into one.
+    options (descriptor_pb2.EnumValueOptions): Enum value options message or
+      None to use default enum value options options.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.EnumValueDescriptor
+
+    def __new__(cls, name, index, number,
+                type=None,  # pylint: disable=redefined-builtin
+                options=None, serialized_options=None, create_key=None):
+      _message.Message._CheckCalledFromGeneratedFile()
+      # There is no way we can build a complete EnumValueDescriptor with the
+      # given parameters (the name of the Enum is not known, for example).
+      # Fortunately generated files just pass it to the EnumDescriptor()
+      # constructor, which will ignore it, so returning None is good enough.
+      return None
+
+  def __init__(self, name, index, number,
+               type=None,  # pylint: disable=redefined-builtin
+               options=None, serialized_options=None, create_key=None):
+    """Arguments are as described in the attribute description above."""
+    if create_key is not _internal_create_key:
+      _Deprecated('EnumValueDescriptor')
+
+    super(EnumValueDescriptor, self).__init__(
+        type.file if type else None,
+        options,
+        serialized_options,
+        'EnumValueOptions',
+    )
+    self.name = name
+    self.index = index
+    self.number = number
+    self.type = type
+
+
+class OneofDescriptor(DescriptorBase):
+  """Descriptor for a oneof field.
+
+  Attributes:
+    name (str): Name of the oneof field.
+    full_name (str): Full name of the oneof field, including package name.
+    index (int): 0-based index giving the order of the oneof field inside
+      its containing type.
+    containing_type (Descriptor): :class:`Descriptor` of the protocol message
+      type that contains this field.  Set by the :class:`Descriptor` constructor
+      if we're passed into one.
+    fields (list[FieldDescriptor]): The list of field descriptors this
+      oneof can contain.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.OneofDescriptor
+
+    def __new__(
+        cls, name, full_name, index, containing_type, fields, options=None,
+        serialized_options=None, create_key=None):
+      _message.Message._CheckCalledFromGeneratedFile()
+      return _message.default_pool.FindOneofByName(full_name)
+
+  def __init__(
+      self, name, full_name, index, containing_type, fields, options=None,
+      serialized_options=None, create_key=None):
+    """Arguments are as described in the attribute description above."""
+    if create_key is not _internal_create_key:
+      _Deprecated('OneofDescriptor')
+
+    super(OneofDescriptor, self).__init__(
+        containing_type.file if containing_type else None,
+        options,
+        serialized_options,
+        'OneofOptions',
+    )
+    self.name = name
+    self.full_name = full_name
+    self.index = index
+    self.containing_type = containing_type
+    self.fields = fields
+
+
+class ServiceDescriptor(_NestedDescriptorBase):
+
+  """Descriptor for a service.
+
+  Attributes:
+    name (str): Name of the service.
+    full_name (str): Full name of the service, including package name.
+    index (int): 0-indexed index giving the order that this services
+      definition appears within the .proto file.
+    methods (list[MethodDescriptor]): List of methods provided by this
+      service.
+    methods_by_name (dict(str, MethodDescriptor)): Same
+      :class:`MethodDescriptor` objects as in :attr:`methods_by_name`, but
+      indexed by "name" attribute in each :class:`MethodDescriptor`.
+    options (descriptor_pb2.ServiceOptions): Service options message or
+      None to use default service options.
+    file (FileDescriptor): Reference to file info.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.ServiceDescriptor
+
+    def __new__(
+        cls,
+        name=None,
+        full_name=None,
+        index=None,
+        methods=None,
+        options=None,
+        serialized_options=None,
+        file=None,  # pylint: disable=redefined-builtin
+        serialized_start=None,
+        serialized_end=None,
+        create_key=None):
+      _message.Message._CheckCalledFromGeneratedFile()  # pylint: disable=protected-access
+      return _message.default_pool.FindServiceByName(full_name)
+
+  def __init__(self, name, full_name, index, methods, options=None,
+               serialized_options=None, file=None,  # pylint: disable=redefined-builtin
+               serialized_start=None, serialized_end=None, create_key=None):
+    if create_key is not _internal_create_key:
+      _Deprecated('ServiceDescriptor')
+
+    super(ServiceDescriptor, self).__init__(
+        options, 'ServiceOptions', name, full_name, file,
+        None, serialized_start=serialized_start,
+        serialized_end=serialized_end, serialized_options=serialized_options)
+    self.index = index
+    self.methods = methods
+    self.methods_by_name = dict((m.name, m) for m in methods)
+    # Set the containing service for each method in this service.
+    for method in self.methods:
+      method.file = self.file
+      method.containing_service = self
+
+  def FindMethodByName(self, name):
+    """Searches for the specified method, and returns its descriptor.
+
+    Args:
+      name (str): Name of the method.
+
+    Returns:
+      MethodDescriptor: The descriptor for the requested method.
+
+    Raises:
+      KeyError: if the method cannot be found in the service.
+    """
+    return self.methods_by_name[name]
+
+  def CopyToProto(self, proto):
+    """Copies this to a descriptor_pb2.ServiceDescriptorProto.
+
+    Args:
+      proto (descriptor_pb2.ServiceDescriptorProto): An empty descriptor proto.
+    """
+    # This function is overridden to give a better doc comment.
+    super(ServiceDescriptor, self).CopyToProto(proto)
+
+
+class MethodDescriptor(DescriptorBase):
+
+  """Descriptor for a method in a service.
+
+  Attributes:
+    name (str): Name of the method within the service.
+    full_name (str): Full name of method.
+    index (int): 0-indexed index of the method inside the service.
+    containing_service (ServiceDescriptor): The service that contains this
+      method.
+    input_type (Descriptor): The descriptor of the message that this method
+      accepts.
+    output_type (Descriptor): The descriptor of the message that this method
+      returns.
+    client_streaming (bool): Whether this method uses client streaming.
+    server_streaming (bool): Whether this method uses server streaming.
+    options (descriptor_pb2.MethodOptions or None): Method options message, or
+      None to use default method options.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.MethodDescriptor
+
+    def __new__(cls,
+                name,
+                full_name,
+                index,
+                containing_service,
+                input_type,
+                output_type,
+                client_streaming=False,
+                server_streaming=False,
+                options=None,
+                serialized_options=None,
+                create_key=None):
+      _message.Message._CheckCalledFromGeneratedFile()  # pylint: disable=protected-access
+      return _message.default_pool.FindMethodByName(full_name)
+
+  def __init__(self,
+               name,
+               full_name,
+               index,
+               containing_service,
+               input_type,
+               output_type,
+               client_streaming=False,
+               server_streaming=False,
+               options=None,
+               serialized_options=None,
+               create_key=None):
+    """The arguments are as described in the description of MethodDescriptor
+    attributes above.
+
+    Note that containing_service may be None, and may be set later if necessary.
+    """
+    if create_key is not _internal_create_key:
+      _Deprecated('MethodDescriptor')
+
+    super(MethodDescriptor, self).__init__(
+        containing_service.file if containing_service else None,
+        options,
+        serialized_options,
+        'MethodOptions',
+    )
+    self.name = name
+    self.full_name = full_name
+    self.index = index
+    self.containing_service = containing_service
+    self.input_type = input_type
+    self.output_type = output_type
+    self.client_streaming = client_streaming
+    self.server_streaming = server_streaming
+
+  def CopyToProto(self, proto):
+    """Copies this to a descriptor_pb2.MethodDescriptorProto.
+
+    Args:
+      proto (descriptor_pb2.MethodDescriptorProto): An empty descriptor proto.
+
+    Raises:
+      Error: If self couldn't be serialized, due to too few constructor
+        arguments.
+    """
+    if self.containing_service is not None:
+      from google.protobuf import descriptor_pb2
+      service_proto = descriptor_pb2.ServiceDescriptorProto()
+      self.containing_service.CopyToProto(service_proto)
+      proto.CopyFrom(service_proto.method[self.index])
+    else:
+      raise Error('Descriptor does not contain a service.')
+
+
+class FileDescriptor(DescriptorBase):
+  """Descriptor for a file. Mimics the descriptor_pb2.FileDescriptorProto.
+
+  Note that :attr:`enum_types_by_name`, :attr:`extensions_by_name`, and
+  :attr:`dependencies` fields are only set by the
+  :py:mod:`google.protobuf.message_factory` module, and not by the generated
+  proto code.
+
+  Attributes:
+    name (str): Name of file, relative to root of source tree.
+    package (str): Name of the package
+    syntax (str): string indicating syntax of the file (can be "proto2" or
+      "proto3")
+    serialized_pb (bytes): Byte string of serialized
+      :class:`descriptor_pb2.FileDescriptorProto`.
+    dependencies (list[FileDescriptor]): List of other :class:`FileDescriptor`
+      objects this :class:`FileDescriptor` depends on.
+    public_dependencies (list[FileDescriptor]): A subset of
+      :attr:`dependencies`, which were declared as "public".
+    message_types_by_name (dict(str, Descriptor)): Mapping from message names
+      to their :class:`Descriptor`.
+    enum_types_by_name (dict(str, EnumDescriptor)): Mapping from enum names to
+      their :class:`EnumDescriptor`.
+    extensions_by_name (dict(str, FieldDescriptor)): Mapping from extension
+      names declared at file scope to their :class:`FieldDescriptor`.
+    services_by_name (dict(str, ServiceDescriptor)): Mapping from services'
+      names to their :class:`ServiceDescriptor`.
+    pool (DescriptorPool): The pool this descriptor belongs to.  When not
+      passed to the constructor, the global default pool is used.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.FileDescriptor
+
+    def __new__(cls, name, package, options=None,
+                serialized_options=None, serialized_pb=None,
+                dependencies=None, public_dependencies=None,
+                syntax=None, pool=None, create_key=None):
+      # FileDescriptor() is called from various places, not only from generated
+      # files, to register dynamic proto files and messages.
+      # pylint: disable=g-explicit-bool-comparison
+      if serialized_pb:
+        return _message.default_pool.AddSerializedFile(serialized_pb)
+      else:
+        return super(FileDescriptor, cls).__new__(cls)
+
+  def __init__(self, name, package, options=None,
+               serialized_options=None, serialized_pb=None,
+               dependencies=None, public_dependencies=None,
+               syntax=None, pool=None, create_key=None):
+    """Constructor."""
+    if create_key is not _internal_create_key:
+      _Deprecated('FileDescriptor')
+
+    super(FileDescriptor, self).__init__(
+        None, options, serialized_options, 'FileOptions'
+    )
+
+    if pool is None:
+      from google.protobuf import descriptor_pool
+      pool = descriptor_pool.Default()
+    self.pool = pool
+    self.message_types_by_name = {}
+    self.name = name
+    self.package = package
+    self._deprecated_syntax = syntax or "proto2"
+    self.serialized_pb = serialized_pb
+
+    self.enum_types_by_name = {}
+    self.extensions_by_name = {}
+    self.services_by_name = {}
+    self.dependencies = (dependencies or [])
+    self.public_dependencies = (public_dependencies or [])
+
+  @property
+  def syntax(self):
+    warnings.warn(
+      'descriptor.syntax is deprecated. It will be removed'
+      ' soon. Most usages are checking field descriptors. Consider to use'
+      ' has_presence, is_packed on field descriptors.'
+    )
+    return self._deprecated_syntax
+
+  def CopyToProto(self, proto):
+    """Copies this to a descriptor_pb2.FileDescriptorProto.
+
+    Args:
+      proto: An empty descriptor_pb2.FileDescriptorProto.
+    """
+    proto.ParseFromString(self.serialized_pb)
+
+
+def _ParseOptions(message, string):
+  """Parses serialized options.
+
+  This helper function is used to parse serialized options in generated
+  proto2 files. It must not be used outside proto2.
+  """
+  message.ParseFromString(string)
+  return message
+
+
+def _ToCamelCase(name):
+  """Converts name to camel-case and returns it."""
+  capitalize_next = False
+  result = []
+
+  for c in name:
+    if c == '_':
+      if result:
+        capitalize_next = True
+    elif capitalize_next:
+      result.append(c.upper())
+      capitalize_next = False
+    else:
+      result += c
+
+  # Lower-case the first letter.
+  if result and result[0].isupper():
+    result[0] = result[0].lower()
+  return ''.join(result)
+
+
+def _OptionsOrNone(descriptor_proto):
+  """Returns the value of the field `options`, or None if it is not set."""
+  if descriptor_proto.HasField('options'):
+    return descriptor_proto.options
+  else:
+    return None
+
+
+def _ToJsonName(name):
+  """Converts name to Json name and returns it."""
+  capitalize_next = False
+  result = []
+
+  for c in name:
+    if c == '_':
+      capitalize_next = True
+    elif capitalize_next:
+      result.append(c.upper())
+      capitalize_next = False
+    else:
+      result += c
+
+  return ''.join(result)
+
+
+def MakeDescriptor(desc_proto, package='', build_file_if_cpp=True,
+                   syntax=None):
+  """Make a protobuf Descriptor given a DescriptorProto protobuf.
+
+  Handles nested descriptors. Note that this is limited to the scope of defining
+  a message inside of another message. Composite fields can currently only be
+  resolved if the message is defined in the same scope as the field.
+
+  Args:
+    desc_proto: The descriptor_pb2.DescriptorProto protobuf message.
+    package: Optional package name for the new message Descriptor (string).
+    build_file_if_cpp: Update the C++ descriptor pool if api matches.
+                       Set to False on recursion, so no duplicates are created.
+    syntax: The syntax/semantics that should be used.  Set to "proto3" to get
+            proto3 field presence semantics.
+  Returns:
+    A Descriptor for protobuf messages.
+  """
+  if api_implementation.Type() != 'python' and build_file_if_cpp:
+    # The C++ implementation requires all descriptors to be backed by the same
+    # definition in the C++ descriptor pool. To do this, we build a
+    # FileDescriptorProto with the same definition as this descriptor and build
+    # it into the pool.
+    from google.protobuf import descriptor_pb2
+    file_descriptor_proto = descriptor_pb2.FileDescriptorProto()
+    file_descriptor_proto.message_type.add().MergeFrom(desc_proto)
+
+    # Generate a random name for this proto file to prevent conflicts with any
+    # imported ones. We need to specify a file name so the descriptor pool
+    # accepts our FileDescriptorProto, but it is not important what that file
+    # name is actually set to.
+    proto_name = binascii.hexlify(os.urandom(16)).decode('ascii')
+
+    if package:
+      file_descriptor_proto.name = os.path.join(package.replace('.', '/'),
+                                                proto_name + '.proto')
+      file_descriptor_proto.package = package
+    else:
+      file_descriptor_proto.name = proto_name + '.proto'
+
+    _message.default_pool.Add(file_descriptor_proto)
+    result = _message.default_pool.FindFileByName(file_descriptor_proto.name)
+
+    if _USE_C_DESCRIPTORS:
+      return result.message_types_by_name[desc_proto.name]
+
+  full_message_name = [desc_proto.name]
+  if package: full_message_name.insert(0, package)
+
+  # Create Descriptors for enum types
+  enum_types = {}
+  for enum_proto in desc_proto.enum_type:
+    full_name = '.'.join(full_message_name + [enum_proto.name])
+    enum_desc = EnumDescriptor(
+        enum_proto.name, full_name, None, [
+            EnumValueDescriptor(enum_val.name, ii, enum_val.number,
+                                create_key=_internal_create_key)
+            for ii, enum_val in enumerate(enum_proto.value)],
+        create_key=_internal_create_key)
+    enum_types[full_name] = enum_desc
+
+  # Create Descriptors for nested types
+  nested_types = {}
+  for nested_proto in desc_proto.nested_type:
+    full_name = '.'.join(full_message_name + [nested_proto.name])
+    # Nested types are just those defined inside of the message, not all types
+    # used by fields in the message, so no loops are possible here.
+    nested_desc = MakeDescriptor(nested_proto,
+                                 package='.'.join(full_message_name),
+                                 build_file_if_cpp=False,
+                                 syntax=syntax)
+    nested_types[full_name] = nested_desc
+
+  fields = []
+  for field_proto in desc_proto.field:
+    full_name = '.'.join(full_message_name + [field_proto.name])
+    enum_desc = None
+    nested_desc = None
+    if field_proto.json_name:
+      json_name = field_proto.json_name
+    else:
+      json_name = None
+    if field_proto.HasField('type_name'):
+      type_name = field_proto.type_name
+      full_type_name = '.'.join(full_message_name +
+                                [type_name[type_name.rfind('.')+1:]])
+      if full_type_name in nested_types:
+        nested_desc = nested_types[full_type_name]
+      elif full_type_name in enum_types:
+        enum_desc = enum_types[full_type_name]
+      # Else type_name references a non-local type, which isn't implemented
+    field = FieldDescriptor(
+        field_proto.name, full_name, field_proto.number - 1,
+        field_proto.number, field_proto.type,
+        FieldDescriptor.ProtoTypeToCppProtoType(field_proto.type),
+        field_proto.label, None, nested_desc, enum_desc, None, False, None,
+        options=_OptionsOrNone(field_proto), has_default_value=False,
+        json_name=json_name, create_key=_internal_create_key)
+    fields.append(field)
+
+  desc_name = '.'.join(full_message_name)
+  return Descriptor(desc_proto.name, desc_name, None, None, fields,
+                    list(nested_types.values()), list(enum_types.values()), [],
+                    options=_OptionsOrNone(desc_proto),
+                    create_key=_internal_create_key)
diff --git a/llm/Lib/site-packages/google/protobuf/descriptor_database.py b/llm/Lib/site-packages/google/protobuf/descriptor_database.py
new file mode 100644
index 0000000000000000000000000000000000000000..46a893e3167a4298307f722f0e7f79cc6384eecf
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/descriptor_database.py
@@ -0,0 +1,154 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Provides a container for DescriptorProtos."""
+
+__author__ = 'matthewtoia@google.com (Matt Toia)'
+
+import warnings
+
+
+class Error(Exception):
+  pass
+
+
+class DescriptorDatabaseConflictingDefinitionError(Error):
+  """Raised when a proto is added with the same name & different descriptor."""
+
+
+class DescriptorDatabase(object):
+  """A container accepting FileDescriptorProtos and maps DescriptorProtos."""
+
+  def __init__(self):
+    self._file_desc_protos_by_file = {}
+    self._file_desc_protos_by_symbol = {}
+
+  def Add(self, file_desc_proto):
+    """Adds the FileDescriptorProto and its types to this database.
+
+    Args:
+      file_desc_proto: The FileDescriptorProto to add.
+    Raises:
+      DescriptorDatabaseConflictingDefinitionError: if an attempt is made to
+        add a proto with the same name but different definition than an
+        existing proto in the database.
+    """
+    proto_name = file_desc_proto.name
+    if proto_name not in self._file_desc_protos_by_file:
+      self._file_desc_protos_by_file[proto_name] = file_desc_proto
+    elif self._file_desc_protos_by_file[proto_name] != file_desc_proto:
+      raise DescriptorDatabaseConflictingDefinitionError(
+          '%s already added, but with different descriptor.' % proto_name)
+    else:
+      return
+
+    # Add all the top-level descriptors to the index.
+    package = file_desc_proto.package
+    for message in file_desc_proto.message_type:
+      for name in _ExtractSymbols(message, package):
+        self._AddSymbol(name, file_desc_proto)
+    for enum in file_desc_proto.enum_type:
+      self._AddSymbol(('.'.join((package, enum.name))), file_desc_proto)
+      for enum_value in enum.value:
+        self._file_desc_protos_by_symbol[
+            '.'.join((package, enum_value.name))] = file_desc_proto
+    for extension in file_desc_proto.extension:
+      self._AddSymbol(('.'.join((package, extension.name))), file_desc_proto)
+    for service in file_desc_proto.service:
+      self._AddSymbol(('.'.join((package, service.name))), file_desc_proto)
+
+  def FindFileByName(self, name):
+    """Finds the file descriptor proto by file name.
+
+    Typically the file name is a relative path ending to a .proto file. The
+    proto with the given name will have to have been added to this database
+    using the Add method or else an error will be raised.
+
+    Args:
+      name: The file name to find.
+
+    Returns:
+      The file descriptor proto matching the name.
+
+    Raises:
+      KeyError if no file by the given name was added.
+    """
+
+    return self._file_desc_protos_by_file[name]
+
+  def FindFileContainingSymbol(self, symbol):
+    """Finds the file descriptor proto containing the specified symbol.
+
+    The symbol should be a fully qualified name including the file descriptor's
+    package and any containing messages. Some examples:
+
+    'some.package.name.Message'
+    'some.package.name.Message.NestedEnum'
+    'some.package.name.Message.some_field'
+
+    The file descriptor proto containing the specified symbol must be added to
+    this database using the Add method or else an error will be raised.
+
+    Args:
+      symbol: The fully qualified symbol name.
+
+    Returns:
+      The file descriptor proto containing the symbol.
+
+    Raises:
+      KeyError if no file contains the specified symbol.
+    """
+    try:
+      return self._file_desc_protos_by_symbol[symbol]
+    except KeyError:
+      # Fields, enum values, and nested extensions are not in
+      # _file_desc_protos_by_symbol. Try to find the top level
+      # descriptor. Non-existent nested symbol under a valid top level
+      # descriptor can also be found. The behavior is the same with
+      # protobuf C++.
+      top_level, _, _ = symbol.rpartition('.')
+      try:
+        return self._file_desc_protos_by_symbol[top_level]
+      except KeyError:
+        # Raise the original symbol as a KeyError for better diagnostics.
+        raise KeyError(symbol)
+
+  def FindFileContainingExtension(self, extendee_name, extension_number):
+    # TODO: implement this API.
+    return None
+
+  def FindAllExtensionNumbers(self, extendee_name):
+    # TODO: implement this API.
+    return []
+
+  def _AddSymbol(self, name, file_desc_proto):
+    if name in self._file_desc_protos_by_symbol:
+      warn_msg = ('Conflict register for file "' + file_desc_proto.name +
+                  '": ' + name +
+                  ' is already defined in file "' +
+                  self._file_desc_protos_by_symbol[name].name + '"')
+      warnings.warn(warn_msg, RuntimeWarning)
+    self._file_desc_protos_by_symbol[name] = file_desc_proto
+
+
+def _ExtractSymbols(desc_proto, package):
+  """Pulls out all the symbols from a descriptor proto.
+
+  Args:
+    desc_proto: The proto to extract symbols from.
+    package: The package containing the descriptor type.
+
+  Yields:
+    The fully qualified name found in the descriptor.
+  """
+  message_name = package + '.' + desc_proto.name if package else desc_proto.name
+  yield message_name
+  for nested_type in desc_proto.nested_type:
+    for symbol in _ExtractSymbols(nested_type, message_name):
+      yield symbol
+  for enum_type in desc_proto.enum_type:
+    yield '.'.join((message_name, enum_type.name))
diff --git a/llm/Lib/site-packages/google/protobuf/descriptor_pb2.py b/llm/Lib/site-packages/google/protobuf/descriptor_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..edb094a65eaa9a0f95ad8496bc1c15b011b1d9c9
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/descriptor_pb2.py
@@ -0,0 +1,2790 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/descriptor.proto
+# Protobuf Python Version: 4.25.3
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+if _descriptor._USE_C_DESCRIPTORS == False:
+  DESCRIPTOR = _descriptor.FileDescriptor(
+    name='google/protobuf/descriptor.proto',
+    package='google.protobuf',
+    syntax='proto2',
+    serialized_options=b'\n\023com.google.protobufB\020DescriptorProtosH\001Z-google.golang.org/protobuf/types/descriptorpb\370\001\001\242\002\003GPB\252\002\032Google.Protobuf.Reflection',
+    create_key=_descriptor._internal_create_key,
+    serialized_pb=b'\n google/protobuf/descriptor.proto\x12\x0fgoogle.protobuf\"M\n\x11\x46ileDescriptorSet\x12\x38\n\x04\x66ile\x18\x01 \x03(\x0b\x32$.google.protobuf.FileDescriptorProtoR\x04\x66ile\"\x98\x05\n\x13\x46ileDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x18\n\x07package\x18\x02 \x01(\tR\x07package\x12\x1e\n\ndependency\x18\x03 \x03(\tR\ndependency\x12+\n\x11public_dependency\x18\n \x03(\x05R\x10publicDependency\x12\'\n\x0fweak_dependency\x18\x0b \x03(\x05R\x0eweakDependency\x12\x43\n\x0cmessage_type\x18\x04 \x03(\x0b\x32 .google.protobuf.DescriptorProtoR\x0bmessageType\x12\x41\n\tenum_type\x18\x05 \x03(\x0b\x32$.google.protobuf.EnumDescriptorProtoR\x08\x65numType\x12\x41\n\x07service\x18\x06 \x03(\x0b\x32\'.google.protobuf.ServiceDescriptorProtoR\x07service\x12\x43\n\textension\x18\x07 \x03(\x0b\x32%.google.protobuf.FieldDescriptorProtoR\textension\x12\x36\n\x07options\x18\x08 \x01(\x0b\x32\x1c.google.protobuf.FileOptionsR\x07options\x12I\n\x10source_code_info\x18\t \x01(\x0b\x32\x1f.google.protobuf.SourceCodeInfoR\x0esourceCodeInfo\x12\x16\n\x06syntax\x18\x0c \x01(\tR\x06syntax\x12\x32\n\x07\x65\x64ition\x18\x0e \x01(\x0e\x32\x18.google.protobuf.EditionR\x07\x65\x64ition\"\xb9\x06\n\x0f\x44\x65scriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12;\n\x05\x66ield\x18\x02 \x03(\x0b\x32%.google.protobuf.FieldDescriptorProtoR\x05\x66ield\x12\x43\n\textension\x18\x06 \x03(\x0b\x32%.google.protobuf.FieldDescriptorProtoR\textension\x12\x41\n\x0bnested_type\x18\x03 \x03(\x0b\x32 .google.protobuf.DescriptorProtoR\nnestedType\x12\x41\n\tenum_type\x18\x04 \x03(\x0b\x32$.google.protobuf.EnumDescriptorProtoR\x08\x65numType\x12X\n\x0f\x65xtension_range\x18\x05 \x03(\x0b\x32/.google.protobuf.DescriptorProto.ExtensionRangeR\x0e\x65xtensionRange\x12\x44\n\noneof_decl\x18\x08 \x03(\x0b\x32%.google.protobuf.OneofDescriptorProtoR\toneofDecl\x12\x39\n\x07options\x18\x07 \x01(\x0b\x32\x1f.google.protobuf.MessageOptionsR\x07options\x12U\n\x0ereserved_range\x18\t \x03(\x0b\x32..google.protobuf.DescriptorProto.ReservedRangeR\rreservedRange\x12#\n\rreserved_name\x18\n \x03(\tR\x0creservedName\x1az\n\x0e\x45xtensionRange\x12\x14\n\x05start\x18\x01 \x01(\x05R\x05start\x12\x10\n\x03\x65nd\x18\x02 \x01(\x05R\x03\x65nd\x12@\n\x07options\x18\x03 \x01(\x0b\x32&.google.protobuf.ExtensionRangeOptionsR\x07options\x1a\x37\n\rReservedRange\x12\x14\n\x05start\x18\x01 \x01(\x05R\x05start\x12\x10\n\x03\x65nd\x18\x02 \x01(\x05R\x03\x65nd\"\xc7\x04\n\x15\x45xtensionRangeOptions\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption\x12Y\n\x0b\x64\x65\x63laration\x18\x02 \x03(\x0b\x32\x32.google.protobuf.ExtensionRangeOptions.DeclarationB\x03\x88\x01\x02R\x0b\x64\x65\x63laration\x12\x37\n\x08\x66\x65\x61tures\x18\x32 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12h\n\x0cverification\x18\x03 \x01(\x0e\x32\x38.google.protobuf.ExtensionRangeOptions.VerificationState:\nUNVERIFIEDR\x0cverification\x1a\x94\x01\n\x0b\x44\x65\x63laration\x12\x16\n\x06number\x18\x01 \x01(\x05R\x06number\x12\x1b\n\tfull_name\x18\x02 \x01(\tR\x08\x66ullName\x12\x12\n\x04type\x18\x03 \x01(\tR\x04type\x12\x1a\n\x08reserved\x18\x05 \x01(\x08R\x08reserved\x12\x1a\n\x08repeated\x18\x06 \x01(\x08R\x08repeatedJ\x04\x08\x04\x10\x05\"4\n\x11VerificationState\x12\x0f\n\x0b\x44\x45\x43LARATION\x10\x00\x12\x0e\n\nUNVERIFIED\x10\x01*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\xc1\x06\n\x14\x46ieldDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x16\n\x06number\x18\x03 \x01(\x05R\x06number\x12\x41\n\x05label\x18\x04 \x01(\x0e\x32+.google.protobuf.FieldDescriptorProto.LabelR\x05label\x12>\n\x04type\x18\x05 \x01(\x0e\x32*.google.protobuf.FieldDescriptorProto.TypeR\x04type\x12\x1b\n\ttype_name\x18\x06 \x01(\tR\x08typeName\x12\x1a\n\x08\x65xtendee\x18\x02 \x01(\tR\x08\x65xtendee\x12#\n\rdefault_value\x18\x07 \x01(\tR\x0c\x64\x65\x66\x61ultValue\x12\x1f\n\x0boneof_index\x18\t \x01(\x05R\noneofIndex\x12\x1b\n\tjson_name\x18\n \x01(\tR\x08jsonName\x12\x37\n\x07options\x18\x08 \x01(\x0b\x32\x1d.google.protobuf.FieldOptionsR\x07options\x12\'\n\x0fproto3_optional\x18\x11 \x01(\x08R\x0eproto3Optional\"\xb6\x02\n\x04Type\x12\x0f\n\x0bTYPE_DOUBLE\x10\x01\x12\x0e\n\nTYPE_FLOAT\x10\x02\x12\x0e\n\nTYPE_INT64\x10\x03\x12\x0f\n\x0bTYPE_UINT64\x10\x04\x12\x0e\n\nTYPE_INT32\x10\x05\x12\x10\n\x0cTYPE_FIXED64\x10\x06\x12\x10\n\x0cTYPE_FIXED32\x10\x07\x12\r\n\tTYPE_BOOL\x10\x08\x12\x0f\n\x0bTYPE_STRING\x10\t\x12\x0e\n\nTYPE_GROUP\x10\n\x12\x10\n\x0cTYPE_MESSAGE\x10\x0b\x12\x0e\n\nTYPE_BYTES\x10\x0c\x12\x0f\n\x0bTYPE_UINT32\x10\r\x12\r\n\tTYPE_ENUM\x10\x0e\x12\x11\n\rTYPE_SFIXED32\x10\x0f\x12\x11\n\rTYPE_SFIXED64\x10\x10\x12\x0f\n\x0bTYPE_SINT32\x10\x11\x12\x0f\n\x0bTYPE_SINT64\x10\x12\"C\n\x05Label\x12\x12\n\x0eLABEL_OPTIONAL\x10\x01\x12\x12\n\x0eLABEL_REPEATED\x10\x03\x12\x12\n\x0eLABEL_REQUIRED\x10\x02\"c\n\x14OneofDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x37\n\x07options\x18\x02 \x01(\x0b\x32\x1d.google.protobuf.OneofOptionsR\x07options\"\xe3\x02\n\x13\x45numDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12?\n\x05value\x18\x02 \x03(\x0b\x32).google.protobuf.EnumValueDescriptorProtoR\x05value\x12\x36\n\x07options\x18\x03 \x01(\x0b\x32\x1c.google.protobuf.EnumOptionsR\x07options\x12]\n\x0ereserved_range\x18\x04 \x03(\x0b\x32\x36.google.protobuf.EnumDescriptorProto.EnumReservedRangeR\rreservedRange\x12#\n\rreserved_name\x18\x05 \x03(\tR\x0creservedName\x1a;\n\x11\x45numReservedRange\x12\x14\n\x05start\x18\x01 \x01(\x05R\x05start\x12\x10\n\x03\x65nd\x18\x02 \x01(\x05R\x03\x65nd\"\x83\x01\n\x18\x45numValueDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x16\n\x06number\x18\x02 \x01(\x05R\x06number\x12;\n\x07options\x18\x03 \x01(\x0b\x32!.google.protobuf.EnumValueOptionsR\x07options\"\xa7\x01\n\x16ServiceDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12>\n\x06method\x18\x02 \x03(\x0b\x32&.google.protobuf.MethodDescriptorProtoR\x06method\x12\x39\n\x07options\x18\x03 \x01(\x0b\x32\x1f.google.protobuf.ServiceOptionsR\x07options\"\x89\x02\n\x15MethodDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x1d\n\ninput_type\x18\x02 \x01(\tR\tinputType\x12\x1f\n\x0boutput_type\x18\x03 \x01(\tR\noutputType\x12\x38\n\x07options\x18\x04 \x01(\x0b\x32\x1e.google.protobuf.MethodOptionsR\x07options\x12\x30\n\x10\x63lient_streaming\x18\x05 \x01(\x08:\x05\x66\x61lseR\x0f\x63lientStreaming\x12\x30\n\x10server_streaming\x18\x06 \x01(\x08:\x05\x66\x61lseR\x0fserverStreaming\"\xca\t\n\x0b\x46ileOptions\x12!\n\x0cjava_package\x18\x01 \x01(\tR\x0bjavaPackage\x12\x30\n\x14java_outer_classname\x18\x08 \x01(\tR\x12javaOuterClassname\x12\x35\n\x13java_multiple_files\x18\n \x01(\x08:\x05\x66\x61lseR\x11javaMultipleFiles\x12\x44\n\x1djava_generate_equals_and_hash\x18\x14 \x01(\x08\x42\x02\x18\x01R\x19javaGenerateEqualsAndHash\x12:\n\x16java_string_check_utf8\x18\x1b \x01(\x08:\x05\x66\x61lseR\x13javaStringCheckUtf8\x12S\n\x0coptimize_for\x18\t \x01(\x0e\x32).google.protobuf.FileOptions.OptimizeMode:\x05SPEEDR\x0boptimizeFor\x12\x1d\n\ngo_package\x18\x0b \x01(\tR\tgoPackage\x12\x35\n\x13\x63\x63_generic_services\x18\x10 \x01(\x08:\x05\x66\x61lseR\x11\x63\x63GenericServices\x12\x39\n\x15java_generic_services\x18\x11 \x01(\x08:\x05\x66\x61lseR\x13javaGenericServices\x12\x35\n\x13py_generic_services\x18\x12 \x01(\x08:\x05\x66\x61lseR\x11pyGenericServices\x12\x37\n\x14php_generic_services\x18* \x01(\x08:\x05\x66\x61lseR\x12phpGenericServices\x12%\n\ndeprecated\x18\x17 \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12.\n\x10\x63\x63_enable_arenas\x18\x1f \x01(\x08:\x04trueR\x0e\x63\x63\x45nableArenas\x12*\n\x11objc_class_prefix\x18$ \x01(\tR\x0fobjcClassPrefix\x12)\n\x10\x63sharp_namespace\x18% \x01(\tR\x0f\x63sharpNamespace\x12!\n\x0cswift_prefix\x18\' \x01(\tR\x0bswiftPrefix\x12(\n\x10php_class_prefix\x18( \x01(\tR\x0ephpClassPrefix\x12#\n\rphp_namespace\x18) \x01(\tR\x0cphpNamespace\x12\x34\n\x16php_metadata_namespace\x18, \x01(\tR\x14phpMetadataNamespace\x12!\n\x0cruby_package\x18- \x01(\tR\x0brubyPackage\x12\x37\n\x08\x66\x65\x61tures\x18\x32 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption\":\n\x0cOptimizeMode\x12\t\n\x05SPEED\x10\x01\x12\r\n\tCODE_SIZE\x10\x02\x12\x10\n\x0cLITE_RUNTIME\x10\x03*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02J\x04\x08&\x10\'\"\xf4\x03\n\x0eMessageOptions\x12<\n\x17message_set_wire_format\x18\x01 \x01(\x08:\x05\x66\x61lseR\x14messageSetWireFormat\x12L\n\x1fno_standard_descriptor_accessor\x18\x02 \x01(\x08:\x05\x66\x61lseR\x1cnoStandardDescriptorAccessor\x12%\n\ndeprecated\x18\x03 \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12\x1b\n\tmap_entry\x18\x07 \x01(\x08R\x08mapEntry\x12V\n&deprecated_legacy_json_field_conflicts\x18\x0b \x01(\x08\x42\x02\x18\x01R\"deprecatedLegacyJsonFieldConflicts\x12\x37\n\x08\x66\x65\x61tures\x18\x0c \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02J\x04\x08\x04\x10\x05J\x04\x08\x05\x10\x06J\x04\x08\x06\x10\x07J\x04\x08\x08\x10\tJ\x04\x08\t\x10\n\"\xad\n\n\x0c\x46ieldOptions\x12\x41\n\x05\x63type\x18\x01 \x01(\x0e\x32#.google.protobuf.FieldOptions.CType:\x06STRINGR\x05\x63type\x12\x16\n\x06packed\x18\x02 \x01(\x08R\x06packed\x12G\n\x06jstype\x18\x06 \x01(\x0e\x32$.google.protobuf.FieldOptions.JSType:\tJS_NORMALR\x06jstype\x12\x19\n\x04lazy\x18\x05 \x01(\x08:\x05\x66\x61lseR\x04lazy\x12.\n\x0funverified_lazy\x18\x0f \x01(\x08:\x05\x66\x61lseR\x0eunverifiedLazy\x12%\n\ndeprecated\x18\x03 \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12\x19\n\x04weak\x18\n \x01(\x08:\x05\x66\x61lseR\x04weak\x12(\n\x0c\x64\x65\x62ug_redact\x18\x10 \x01(\x08:\x05\x66\x61lseR\x0b\x64\x65\x62ugRedact\x12K\n\tretention\x18\x11 \x01(\x0e\x32-.google.protobuf.FieldOptions.OptionRetentionR\tretention\x12H\n\x07targets\x18\x13 \x03(\x0e\x32..google.protobuf.FieldOptions.OptionTargetTypeR\x07targets\x12W\n\x10\x65\x64ition_defaults\x18\x14 \x03(\x0b\x32,.google.protobuf.FieldOptions.EditionDefaultR\x0f\x65\x64itionDefaults\x12\x37\n\x08\x66\x65\x61tures\x18\x15 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption\x1aZ\n\x0e\x45\x64itionDefault\x12\x32\n\x07\x65\x64ition\x18\x03 \x01(\x0e\x32\x18.google.protobuf.EditionR\x07\x65\x64ition\x12\x14\n\x05value\x18\x02 \x01(\tR\x05value\"/\n\x05\x43Type\x12\n\n\x06STRING\x10\x00\x12\x08\n\x04\x43ORD\x10\x01\x12\x10\n\x0cSTRING_PIECE\x10\x02\"5\n\x06JSType\x12\r\n\tJS_NORMAL\x10\x00\x12\r\n\tJS_STRING\x10\x01\x12\r\n\tJS_NUMBER\x10\x02\"U\n\x0fOptionRetention\x12\x15\n\x11RETENTION_UNKNOWN\x10\x00\x12\x15\n\x11RETENTION_RUNTIME\x10\x01\x12\x14\n\x10RETENTION_SOURCE\x10\x02\"\x8c\x02\n\x10OptionTargetType\x12\x17\n\x13TARGET_TYPE_UNKNOWN\x10\x00\x12\x14\n\x10TARGET_TYPE_FILE\x10\x01\x12\x1f\n\x1bTARGET_TYPE_EXTENSION_RANGE\x10\x02\x12\x17\n\x13TARGET_TYPE_MESSAGE\x10\x03\x12\x15\n\x11TARGET_TYPE_FIELD\x10\x04\x12\x15\n\x11TARGET_TYPE_ONEOF\x10\x05\x12\x14\n\x10TARGET_TYPE_ENUM\x10\x06\x12\x1a\n\x16TARGET_TYPE_ENUM_ENTRY\x10\x07\x12\x17\n\x13TARGET_TYPE_SERVICE\x10\x08\x12\x16\n\x12TARGET_TYPE_METHOD\x10\t*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02J\x04\x08\x04\x10\x05J\x04\x08\x12\x10\x13\"\xac\x01\n\x0cOneofOptions\x12\x37\n\x08\x66\x65\x61tures\x18\x01 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\xd1\x02\n\x0b\x45numOptions\x12\x1f\n\x0b\x61llow_alias\x18\x02 \x01(\x08R\nallowAlias\x12%\n\ndeprecated\x18\x03 \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12V\n&deprecated_legacy_json_field_conflicts\x18\x06 \x01(\x08\x42\x02\x18\x01R\"deprecatedLegacyJsonFieldConflicts\x12\x37\n\x08\x66\x65\x61tures\x18\x07 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02J\x04\x08\x05\x10\x06\"\x81\x02\n\x10\x45numValueOptions\x12%\n\ndeprecated\x18\x01 \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12\x37\n\x08\x66\x65\x61tures\x18\x02 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12(\n\x0c\x64\x65\x62ug_redact\x18\x03 \x01(\x08:\x05\x66\x61lseR\x0b\x64\x65\x62ugRedact\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\xd5\x01\n\x0eServiceOptions\x12\x37\n\x08\x66\x65\x61tures\x18\" \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12%\n\ndeprecated\x18! \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\x99\x03\n\rMethodOptions\x12%\n\ndeprecated\x18! \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12q\n\x11idempotency_level\x18\" \x01(\x0e\x32/.google.protobuf.MethodOptions.IdempotencyLevel:\x13IDEMPOTENCY_UNKNOWNR\x10idempotencyLevel\x12\x37\n\x08\x66\x65\x61tures\x18# \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption\"P\n\x10IdempotencyLevel\x12\x17\n\x13IDEMPOTENCY_UNKNOWN\x10\x00\x12\x13\n\x0fNO_SIDE_EFFECTS\x10\x01\x12\x0e\n\nIDEMPOTENT\x10\x02*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\x9a\x03\n\x13UninterpretedOption\x12\x41\n\x04name\x18\x02 \x03(\x0b\x32-.google.protobuf.UninterpretedOption.NamePartR\x04name\x12)\n\x10identifier_value\x18\x03 \x01(\tR\x0fidentifierValue\x12,\n\x12positive_int_value\x18\x04 \x01(\x04R\x10positiveIntValue\x12,\n\x12negative_int_value\x18\x05 \x01(\x03R\x10negativeIntValue\x12!\n\x0c\x64ouble_value\x18\x06 \x01(\x01R\x0b\x64oubleValue\x12!\n\x0cstring_value\x18\x07 \x01(\x0cR\x0bstringValue\x12\'\n\x0f\x61ggregate_value\x18\x08 \x01(\tR\x0e\x61ggregateValue\x1aJ\n\x08NamePart\x12\x1b\n\tname_part\x18\x01 \x02(\tR\x08namePart\x12!\n\x0cis_extension\x18\x02 \x02(\x08R\x0bisExtension\"\xfc\t\n\nFeatureSet\x12\x8b\x01\n\x0e\x66ield_presence\x18\x01 \x01(\x0e\x32).google.protobuf.FeatureSet.FieldPresenceB9\x88\x01\x01\x98\x01\x04\x98\x01\x01\xa2\x01\r\x12\x08\x45XPLICIT\x18\xe6\x07\xa2\x01\r\x12\x08IMPLICIT\x18\xe7\x07\xa2\x01\r\x12\x08\x45XPLICIT\x18\xe8\x07R\rfieldPresence\x12\x66\n\tenum_type\x18\x02 \x01(\x0e\x32$.google.protobuf.FeatureSet.EnumTypeB#\x88\x01\x01\x98\x01\x06\x98\x01\x01\xa2\x01\x0b\x12\x06\x43LOSED\x18\xe6\x07\xa2\x01\t\x12\x04OPEN\x18\xe7\x07R\x08\x65numType\x12\x92\x01\n\x17repeated_field_encoding\x18\x03 \x01(\x0e\x32\x31.google.protobuf.FeatureSet.RepeatedFieldEncodingB\'\x88\x01\x01\x98\x01\x04\x98\x01\x01\xa2\x01\r\x12\x08\x45XPANDED\x18\xe6\x07\xa2\x01\x0b\x12\x06PACKED\x18\xe7\x07R\x15repeatedFieldEncoding\x12x\n\x0futf8_validation\x18\x04 \x01(\x0e\x32*.google.protobuf.FeatureSet.Utf8ValidationB#\x88\x01\x01\x98\x01\x04\x98\x01\x01\xa2\x01\t\x12\x04NONE\x18\xe6\x07\xa2\x01\x0b\x12\x06VERIFY\x18\xe7\x07R\x0eutf8Validation\x12x\n\x10message_encoding\x18\x05 \x01(\x0e\x32+.google.protobuf.FeatureSet.MessageEncodingB \x88\x01\x01\x98\x01\x04\x98\x01\x01\xa2\x01\x14\x12\x0fLENGTH_PREFIXED\x18\xe6\x07R\x0fmessageEncoding\x12|\n\x0bjson_format\x18\x06 \x01(\x0e\x32&.google.protobuf.FeatureSet.JsonFormatB3\x88\x01\x01\x98\x01\x03\x98\x01\x06\x98\x01\x01\xa2\x01\x17\x12\x12LEGACY_BEST_EFFORT\x18\xe6\x07\xa2\x01\n\x12\x05\x41LLOW\x18\xe7\x07R\njsonFormat\"\\\n\rFieldPresence\x12\x1a\n\x16\x46IELD_PRESENCE_UNKNOWN\x10\x00\x12\x0c\n\x08\x45XPLICIT\x10\x01\x12\x0c\n\x08IMPLICIT\x10\x02\x12\x13\n\x0fLEGACY_REQUIRED\x10\x03\"7\n\x08\x45numType\x12\x15\n\x11\x45NUM_TYPE_UNKNOWN\x10\x00\x12\x08\n\x04OPEN\x10\x01\x12\n\n\x06\x43LOSED\x10\x02\"V\n\x15RepeatedFieldEncoding\x12#\n\x1fREPEATED_FIELD_ENCODING_UNKNOWN\x10\x00\x12\n\n\x06PACKED\x10\x01\x12\x0c\n\x08\x45XPANDED\x10\x02\"C\n\x0eUtf8Validation\x12\x1b\n\x17UTF8_VALIDATION_UNKNOWN\x10\x00\x12\x08\n\x04NONE\x10\x01\x12\n\n\x06VERIFY\x10\x02\"S\n\x0fMessageEncoding\x12\x1c\n\x18MESSAGE_ENCODING_UNKNOWN\x10\x00\x12\x13\n\x0fLENGTH_PREFIXED\x10\x01\x12\r\n\tDELIMITED\x10\x02\"H\n\nJsonFormat\x12\x17\n\x13JSON_FORMAT_UNKNOWN\x10\x00\x12\t\n\x05\x41LLOW\x10\x01\x12\x16\n\x12LEGACY_BEST_EFFORT\x10\x02*\x06\x08\xe8\x07\x10\xe9\x07*\x06\x08\xe9\x07\x10\xea\x07*\x06\x08\x8bN\x10\x90NJ\x06\x08\xe7\x07\x10\xe8\x07\"\xfe\x02\n\x12\x46\x65\x61tureSetDefaults\x12X\n\x08\x64\x65\x66\x61ults\x18\x01 \x03(\x0b\x32<.google.protobuf.FeatureSetDefaults.FeatureSetEditionDefaultR\x08\x64\x65\x66\x61ults\x12\x41\n\x0fminimum_edition\x18\x04 \x01(\x0e\x32\x18.google.protobuf.EditionR\x0eminimumEdition\x12\x41\n\x0fmaximum_edition\x18\x05 \x01(\x0e\x32\x18.google.protobuf.EditionR\x0emaximumEdition\x1a\x87\x01\n\x18\x46\x65\x61tureSetEditionDefault\x12\x32\n\x07\x65\x64ition\x18\x03 \x01(\x0e\x32\x18.google.protobuf.EditionR\x07\x65\x64ition\x12\x37\n\x08\x66\x65\x61tures\x18\x02 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\"\xa7\x02\n\x0eSourceCodeInfo\x12\x44\n\x08location\x18\x01 \x03(\x0b\x32(.google.protobuf.SourceCodeInfo.LocationR\x08location\x1a\xce\x01\n\x08Location\x12\x16\n\x04path\x18\x01 \x03(\x05\x42\x02\x10\x01R\x04path\x12\x16\n\x04span\x18\x02 \x03(\x05\x42\x02\x10\x01R\x04span\x12)\n\x10leading_comments\x18\x03 \x01(\tR\x0fleadingComments\x12+\n\x11trailing_comments\x18\x04 \x01(\tR\x10trailingComments\x12:\n\x19leading_detached_comments\x18\x06 \x03(\tR\x17leadingDetachedComments\"\xd0\x02\n\x11GeneratedCodeInfo\x12M\n\nannotation\x18\x01 \x03(\x0b\x32-.google.protobuf.GeneratedCodeInfo.AnnotationR\nannotation\x1a\xeb\x01\n\nAnnotation\x12\x16\n\x04path\x18\x01 \x03(\x05\x42\x02\x10\x01R\x04path\x12\x1f\n\x0bsource_file\x18\x02 \x01(\tR\nsourceFile\x12\x14\n\x05\x62\x65gin\x18\x03 \x01(\x05R\x05\x62\x65gin\x12\x10\n\x03\x65nd\x18\x04 \x01(\x05R\x03\x65nd\x12R\n\x08semantic\x18\x05 \x01(\x0e\x32\x36.google.protobuf.GeneratedCodeInfo.Annotation.SemanticR\x08semantic\"(\n\x08Semantic\x12\x08\n\x04NONE\x10\x00\x12\x07\n\x03SET\x10\x01\x12\t\n\x05\x41LIAS\x10\x02*\xea\x01\n\x07\x45\x64ition\x12\x13\n\x0f\x45\x44ITION_UNKNOWN\x10\x00\x12\x13\n\x0e\x45\x44ITION_PROTO2\x10\xe6\x07\x12\x13\n\x0e\x45\x44ITION_PROTO3\x10\xe7\x07\x12\x11\n\x0c\x45\x44ITION_2023\x10\xe8\x07\x12\x17\n\x13\x45\x44ITION_1_TEST_ONLY\x10\x01\x12\x17\n\x13\x45\x44ITION_2_TEST_ONLY\x10\x02\x12\x1d\n\x17\x45\x44ITION_99997_TEST_ONLY\x10\x9d\x8d\x06\x12\x1d\n\x17\x45\x44ITION_99998_TEST_ONLY\x10\x9e\x8d\x06\x12\x1d\n\x17\x45\x44ITION_99999_TEST_ONLY\x10\x9f\x8d\x06\x42~\n\x13\x63om.google.protobufB\x10\x44\x65scriptorProtosH\x01Z-google.golang.org/protobuf/types/descriptorpb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1aGoogle.Protobuf.Reflection'
+  )
+else:
+  DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n google/protobuf/descriptor.proto\x12\x0fgoogle.protobuf\"M\n\x11\x46ileDescriptorSet\x12\x38\n\x04\x66ile\x18\x01 \x03(\x0b\x32$.google.protobuf.FileDescriptorProtoR\x04\x66ile\"\x98\x05\n\x13\x46ileDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x18\n\x07package\x18\x02 \x01(\tR\x07package\x12\x1e\n\ndependency\x18\x03 \x03(\tR\ndependency\x12+\n\x11public_dependency\x18\n \x03(\x05R\x10publicDependency\x12\'\n\x0fweak_dependency\x18\x0b \x03(\x05R\x0eweakDependency\x12\x43\n\x0cmessage_type\x18\x04 \x03(\x0b\x32 .google.protobuf.DescriptorProtoR\x0bmessageType\x12\x41\n\tenum_type\x18\x05 \x03(\x0b\x32$.google.protobuf.EnumDescriptorProtoR\x08\x65numType\x12\x41\n\x07service\x18\x06 \x03(\x0b\x32\'.google.protobuf.ServiceDescriptorProtoR\x07service\x12\x43\n\textension\x18\x07 \x03(\x0b\x32%.google.protobuf.FieldDescriptorProtoR\textension\x12\x36\n\x07options\x18\x08 \x01(\x0b\x32\x1c.google.protobuf.FileOptionsR\x07options\x12I\n\x10source_code_info\x18\t \x01(\x0b\x32\x1f.google.protobuf.SourceCodeInfoR\x0esourceCodeInfo\x12\x16\n\x06syntax\x18\x0c \x01(\tR\x06syntax\x12\x32\n\x07\x65\x64ition\x18\x0e \x01(\x0e\x32\x18.google.protobuf.EditionR\x07\x65\x64ition\"\xb9\x06\n\x0f\x44\x65scriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12;\n\x05\x66ield\x18\x02 \x03(\x0b\x32%.google.protobuf.FieldDescriptorProtoR\x05\x66ield\x12\x43\n\textension\x18\x06 \x03(\x0b\x32%.google.protobuf.FieldDescriptorProtoR\textension\x12\x41\n\x0bnested_type\x18\x03 \x03(\x0b\x32 .google.protobuf.DescriptorProtoR\nnestedType\x12\x41\n\tenum_type\x18\x04 \x03(\x0b\x32$.google.protobuf.EnumDescriptorProtoR\x08\x65numType\x12X\n\x0f\x65xtension_range\x18\x05 \x03(\x0b\x32/.google.protobuf.DescriptorProto.ExtensionRangeR\x0e\x65xtensionRange\x12\x44\n\noneof_decl\x18\x08 \x03(\x0b\x32%.google.protobuf.OneofDescriptorProtoR\toneofDecl\x12\x39\n\x07options\x18\x07 \x01(\x0b\x32\x1f.google.protobuf.MessageOptionsR\x07options\x12U\n\x0ereserved_range\x18\t \x03(\x0b\x32..google.protobuf.DescriptorProto.ReservedRangeR\rreservedRange\x12#\n\rreserved_name\x18\n \x03(\tR\x0creservedName\x1az\n\x0e\x45xtensionRange\x12\x14\n\x05start\x18\x01 \x01(\x05R\x05start\x12\x10\n\x03\x65nd\x18\x02 \x01(\x05R\x03\x65nd\x12@\n\x07options\x18\x03 \x01(\x0b\x32&.google.protobuf.ExtensionRangeOptionsR\x07options\x1a\x37\n\rReservedRange\x12\x14\n\x05start\x18\x01 \x01(\x05R\x05start\x12\x10\n\x03\x65nd\x18\x02 \x01(\x05R\x03\x65nd\"\xc7\x04\n\x15\x45xtensionRangeOptions\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption\x12Y\n\x0b\x64\x65\x63laration\x18\x02 \x03(\x0b\x32\x32.google.protobuf.ExtensionRangeOptions.DeclarationB\x03\x88\x01\x02R\x0b\x64\x65\x63laration\x12\x37\n\x08\x66\x65\x61tures\x18\x32 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12h\n\x0cverification\x18\x03 \x01(\x0e\x32\x38.google.protobuf.ExtensionRangeOptions.VerificationState:\nUNVERIFIEDR\x0cverification\x1a\x94\x01\n\x0b\x44\x65\x63laration\x12\x16\n\x06number\x18\x01 \x01(\x05R\x06number\x12\x1b\n\tfull_name\x18\x02 \x01(\tR\x08\x66ullName\x12\x12\n\x04type\x18\x03 \x01(\tR\x04type\x12\x1a\n\x08reserved\x18\x05 \x01(\x08R\x08reserved\x12\x1a\n\x08repeated\x18\x06 \x01(\x08R\x08repeatedJ\x04\x08\x04\x10\x05\"4\n\x11VerificationState\x12\x0f\n\x0b\x44\x45\x43LARATION\x10\x00\x12\x0e\n\nUNVERIFIED\x10\x01*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\xc1\x06\n\x14\x46ieldDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x16\n\x06number\x18\x03 \x01(\x05R\x06number\x12\x41\n\x05label\x18\x04 \x01(\x0e\x32+.google.protobuf.FieldDescriptorProto.LabelR\x05label\x12>\n\x04type\x18\x05 \x01(\x0e\x32*.google.protobuf.FieldDescriptorProto.TypeR\x04type\x12\x1b\n\ttype_name\x18\x06 \x01(\tR\x08typeName\x12\x1a\n\x08\x65xtendee\x18\x02 \x01(\tR\x08\x65xtendee\x12#\n\rdefault_value\x18\x07 \x01(\tR\x0c\x64\x65\x66\x61ultValue\x12\x1f\n\x0boneof_index\x18\t \x01(\x05R\noneofIndex\x12\x1b\n\tjson_name\x18\n \x01(\tR\x08jsonName\x12\x37\n\x07options\x18\x08 \x01(\x0b\x32\x1d.google.protobuf.FieldOptionsR\x07options\x12\'\n\x0fproto3_optional\x18\x11 \x01(\x08R\x0eproto3Optional\"\xb6\x02\n\x04Type\x12\x0f\n\x0bTYPE_DOUBLE\x10\x01\x12\x0e\n\nTYPE_FLOAT\x10\x02\x12\x0e\n\nTYPE_INT64\x10\x03\x12\x0f\n\x0bTYPE_UINT64\x10\x04\x12\x0e\n\nTYPE_INT32\x10\x05\x12\x10\n\x0cTYPE_FIXED64\x10\x06\x12\x10\n\x0cTYPE_FIXED32\x10\x07\x12\r\n\tTYPE_BOOL\x10\x08\x12\x0f\n\x0bTYPE_STRING\x10\t\x12\x0e\n\nTYPE_GROUP\x10\n\x12\x10\n\x0cTYPE_MESSAGE\x10\x0b\x12\x0e\n\nTYPE_BYTES\x10\x0c\x12\x0f\n\x0bTYPE_UINT32\x10\r\x12\r\n\tTYPE_ENUM\x10\x0e\x12\x11\n\rTYPE_SFIXED32\x10\x0f\x12\x11\n\rTYPE_SFIXED64\x10\x10\x12\x0f\n\x0bTYPE_SINT32\x10\x11\x12\x0f\n\x0bTYPE_SINT64\x10\x12\"C\n\x05Label\x12\x12\n\x0eLABEL_OPTIONAL\x10\x01\x12\x12\n\x0eLABEL_REPEATED\x10\x03\x12\x12\n\x0eLABEL_REQUIRED\x10\x02\"c\n\x14OneofDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x37\n\x07options\x18\x02 \x01(\x0b\x32\x1d.google.protobuf.OneofOptionsR\x07options\"\xe3\x02\n\x13\x45numDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12?\n\x05value\x18\x02 \x03(\x0b\x32).google.protobuf.EnumValueDescriptorProtoR\x05value\x12\x36\n\x07options\x18\x03 \x01(\x0b\x32\x1c.google.protobuf.EnumOptionsR\x07options\x12]\n\x0ereserved_range\x18\x04 \x03(\x0b\x32\x36.google.protobuf.EnumDescriptorProto.EnumReservedRangeR\rreservedRange\x12#\n\rreserved_name\x18\x05 \x03(\tR\x0creservedName\x1a;\n\x11\x45numReservedRange\x12\x14\n\x05start\x18\x01 \x01(\x05R\x05start\x12\x10\n\x03\x65nd\x18\x02 \x01(\x05R\x03\x65nd\"\x83\x01\n\x18\x45numValueDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x16\n\x06number\x18\x02 \x01(\x05R\x06number\x12;\n\x07options\x18\x03 \x01(\x0b\x32!.google.protobuf.EnumValueOptionsR\x07options\"\xa7\x01\n\x16ServiceDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12>\n\x06method\x18\x02 \x03(\x0b\x32&.google.protobuf.MethodDescriptorProtoR\x06method\x12\x39\n\x07options\x18\x03 \x01(\x0b\x32\x1f.google.protobuf.ServiceOptionsR\x07options\"\x89\x02\n\x15MethodDescriptorProto\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x1d\n\ninput_type\x18\x02 \x01(\tR\tinputType\x12\x1f\n\x0boutput_type\x18\x03 \x01(\tR\noutputType\x12\x38\n\x07options\x18\x04 \x01(\x0b\x32\x1e.google.protobuf.MethodOptionsR\x07options\x12\x30\n\x10\x63lient_streaming\x18\x05 \x01(\x08:\x05\x66\x61lseR\x0f\x63lientStreaming\x12\x30\n\x10server_streaming\x18\x06 \x01(\x08:\x05\x66\x61lseR\x0fserverStreaming\"\xca\t\n\x0b\x46ileOptions\x12!\n\x0cjava_package\x18\x01 \x01(\tR\x0bjavaPackage\x12\x30\n\x14java_outer_classname\x18\x08 \x01(\tR\x12javaOuterClassname\x12\x35\n\x13java_multiple_files\x18\n \x01(\x08:\x05\x66\x61lseR\x11javaMultipleFiles\x12\x44\n\x1djava_generate_equals_and_hash\x18\x14 \x01(\x08\x42\x02\x18\x01R\x19javaGenerateEqualsAndHash\x12:\n\x16java_string_check_utf8\x18\x1b \x01(\x08:\x05\x66\x61lseR\x13javaStringCheckUtf8\x12S\n\x0coptimize_for\x18\t \x01(\x0e\x32).google.protobuf.FileOptions.OptimizeMode:\x05SPEEDR\x0boptimizeFor\x12\x1d\n\ngo_package\x18\x0b \x01(\tR\tgoPackage\x12\x35\n\x13\x63\x63_generic_services\x18\x10 \x01(\x08:\x05\x66\x61lseR\x11\x63\x63GenericServices\x12\x39\n\x15java_generic_services\x18\x11 \x01(\x08:\x05\x66\x61lseR\x13javaGenericServices\x12\x35\n\x13py_generic_services\x18\x12 \x01(\x08:\x05\x66\x61lseR\x11pyGenericServices\x12\x37\n\x14php_generic_services\x18* \x01(\x08:\x05\x66\x61lseR\x12phpGenericServices\x12%\n\ndeprecated\x18\x17 \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12.\n\x10\x63\x63_enable_arenas\x18\x1f \x01(\x08:\x04trueR\x0e\x63\x63\x45nableArenas\x12*\n\x11objc_class_prefix\x18$ \x01(\tR\x0fobjcClassPrefix\x12)\n\x10\x63sharp_namespace\x18% \x01(\tR\x0f\x63sharpNamespace\x12!\n\x0cswift_prefix\x18\' \x01(\tR\x0bswiftPrefix\x12(\n\x10php_class_prefix\x18( \x01(\tR\x0ephpClassPrefix\x12#\n\rphp_namespace\x18) \x01(\tR\x0cphpNamespace\x12\x34\n\x16php_metadata_namespace\x18, \x01(\tR\x14phpMetadataNamespace\x12!\n\x0cruby_package\x18- \x01(\tR\x0brubyPackage\x12\x37\n\x08\x66\x65\x61tures\x18\x32 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption\":\n\x0cOptimizeMode\x12\t\n\x05SPEED\x10\x01\x12\r\n\tCODE_SIZE\x10\x02\x12\x10\n\x0cLITE_RUNTIME\x10\x03*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02J\x04\x08&\x10\'\"\xf4\x03\n\x0eMessageOptions\x12<\n\x17message_set_wire_format\x18\x01 \x01(\x08:\x05\x66\x61lseR\x14messageSetWireFormat\x12L\n\x1fno_standard_descriptor_accessor\x18\x02 \x01(\x08:\x05\x66\x61lseR\x1cnoStandardDescriptorAccessor\x12%\n\ndeprecated\x18\x03 \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12\x1b\n\tmap_entry\x18\x07 \x01(\x08R\x08mapEntry\x12V\n&deprecated_legacy_json_field_conflicts\x18\x0b \x01(\x08\x42\x02\x18\x01R\"deprecatedLegacyJsonFieldConflicts\x12\x37\n\x08\x66\x65\x61tures\x18\x0c \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02J\x04\x08\x04\x10\x05J\x04\x08\x05\x10\x06J\x04\x08\x06\x10\x07J\x04\x08\x08\x10\tJ\x04\x08\t\x10\n\"\xad\n\n\x0c\x46ieldOptions\x12\x41\n\x05\x63type\x18\x01 \x01(\x0e\x32#.google.protobuf.FieldOptions.CType:\x06STRINGR\x05\x63type\x12\x16\n\x06packed\x18\x02 \x01(\x08R\x06packed\x12G\n\x06jstype\x18\x06 \x01(\x0e\x32$.google.protobuf.FieldOptions.JSType:\tJS_NORMALR\x06jstype\x12\x19\n\x04lazy\x18\x05 \x01(\x08:\x05\x66\x61lseR\x04lazy\x12.\n\x0funverified_lazy\x18\x0f \x01(\x08:\x05\x66\x61lseR\x0eunverifiedLazy\x12%\n\ndeprecated\x18\x03 \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12\x19\n\x04weak\x18\n \x01(\x08:\x05\x66\x61lseR\x04weak\x12(\n\x0c\x64\x65\x62ug_redact\x18\x10 \x01(\x08:\x05\x66\x61lseR\x0b\x64\x65\x62ugRedact\x12K\n\tretention\x18\x11 \x01(\x0e\x32-.google.protobuf.FieldOptions.OptionRetentionR\tretention\x12H\n\x07targets\x18\x13 \x03(\x0e\x32..google.protobuf.FieldOptions.OptionTargetTypeR\x07targets\x12W\n\x10\x65\x64ition_defaults\x18\x14 \x03(\x0b\x32,.google.protobuf.FieldOptions.EditionDefaultR\x0f\x65\x64itionDefaults\x12\x37\n\x08\x66\x65\x61tures\x18\x15 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption\x1aZ\n\x0e\x45\x64itionDefault\x12\x32\n\x07\x65\x64ition\x18\x03 \x01(\x0e\x32\x18.google.protobuf.EditionR\x07\x65\x64ition\x12\x14\n\x05value\x18\x02 \x01(\tR\x05value\"/\n\x05\x43Type\x12\n\n\x06STRING\x10\x00\x12\x08\n\x04\x43ORD\x10\x01\x12\x10\n\x0cSTRING_PIECE\x10\x02\"5\n\x06JSType\x12\r\n\tJS_NORMAL\x10\x00\x12\r\n\tJS_STRING\x10\x01\x12\r\n\tJS_NUMBER\x10\x02\"U\n\x0fOptionRetention\x12\x15\n\x11RETENTION_UNKNOWN\x10\x00\x12\x15\n\x11RETENTION_RUNTIME\x10\x01\x12\x14\n\x10RETENTION_SOURCE\x10\x02\"\x8c\x02\n\x10OptionTargetType\x12\x17\n\x13TARGET_TYPE_UNKNOWN\x10\x00\x12\x14\n\x10TARGET_TYPE_FILE\x10\x01\x12\x1f\n\x1bTARGET_TYPE_EXTENSION_RANGE\x10\x02\x12\x17\n\x13TARGET_TYPE_MESSAGE\x10\x03\x12\x15\n\x11TARGET_TYPE_FIELD\x10\x04\x12\x15\n\x11TARGET_TYPE_ONEOF\x10\x05\x12\x14\n\x10TARGET_TYPE_ENUM\x10\x06\x12\x1a\n\x16TARGET_TYPE_ENUM_ENTRY\x10\x07\x12\x17\n\x13TARGET_TYPE_SERVICE\x10\x08\x12\x16\n\x12TARGET_TYPE_METHOD\x10\t*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02J\x04\x08\x04\x10\x05J\x04\x08\x12\x10\x13\"\xac\x01\n\x0cOneofOptions\x12\x37\n\x08\x66\x65\x61tures\x18\x01 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\xd1\x02\n\x0b\x45numOptions\x12\x1f\n\x0b\x61llow_alias\x18\x02 \x01(\x08R\nallowAlias\x12%\n\ndeprecated\x18\x03 \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12V\n&deprecated_legacy_json_field_conflicts\x18\x06 \x01(\x08\x42\x02\x18\x01R\"deprecatedLegacyJsonFieldConflicts\x12\x37\n\x08\x66\x65\x61tures\x18\x07 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02J\x04\x08\x05\x10\x06\"\x81\x02\n\x10\x45numValueOptions\x12%\n\ndeprecated\x18\x01 \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12\x37\n\x08\x66\x65\x61tures\x18\x02 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12(\n\x0c\x64\x65\x62ug_redact\x18\x03 \x01(\x08:\x05\x66\x61lseR\x0b\x64\x65\x62ugRedact\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\xd5\x01\n\x0eServiceOptions\x12\x37\n\x08\x66\x65\x61tures\x18\" \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12%\n\ndeprecated\x18! \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\x99\x03\n\rMethodOptions\x12%\n\ndeprecated\x18! \x01(\x08:\x05\x66\x61lseR\ndeprecated\x12q\n\x11idempotency_level\x18\" \x01(\x0e\x32/.google.protobuf.MethodOptions.IdempotencyLevel:\x13IDEMPOTENCY_UNKNOWNR\x10idempotencyLevel\x12\x37\n\x08\x66\x65\x61tures\x18# \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\x12X\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOptionR\x13uninterpretedOption\"P\n\x10IdempotencyLevel\x12\x17\n\x13IDEMPOTENCY_UNKNOWN\x10\x00\x12\x13\n\x0fNO_SIDE_EFFECTS\x10\x01\x12\x0e\n\nIDEMPOTENT\x10\x02*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\x9a\x03\n\x13UninterpretedOption\x12\x41\n\x04name\x18\x02 \x03(\x0b\x32-.google.protobuf.UninterpretedOption.NamePartR\x04name\x12)\n\x10identifier_value\x18\x03 \x01(\tR\x0fidentifierValue\x12,\n\x12positive_int_value\x18\x04 \x01(\x04R\x10positiveIntValue\x12,\n\x12negative_int_value\x18\x05 \x01(\x03R\x10negativeIntValue\x12!\n\x0c\x64ouble_value\x18\x06 \x01(\x01R\x0b\x64oubleValue\x12!\n\x0cstring_value\x18\x07 \x01(\x0cR\x0bstringValue\x12\'\n\x0f\x61ggregate_value\x18\x08 \x01(\tR\x0e\x61ggregateValue\x1aJ\n\x08NamePart\x12\x1b\n\tname_part\x18\x01 \x02(\tR\x08namePart\x12!\n\x0cis_extension\x18\x02 \x02(\x08R\x0bisExtension\"\xfc\t\n\nFeatureSet\x12\x8b\x01\n\x0e\x66ield_presence\x18\x01 \x01(\x0e\x32).google.protobuf.FeatureSet.FieldPresenceB9\x88\x01\x01\x98\x01\x04\x98\x01\x01\xa2\x01\r\x12\x08\x45XPLICIT\x18\xe6\x07\xa2\x01\r\x12\x08IMPLICIT\x18\xe7\x07\xa2\x01\r\x12\x08\x45XPLICIT\x18\xe8\x07R\rfieldPresence\x12\x66\n\tenum_type\x18\x02 \x01(\x0e\x32$.google.protobuf.FeatureSet.EnumTypeB#\x88\x01\x01\x98\x01\x06\x98\x01\x01\xa2\x01\x0b\x12\x06\x43LOSED\x18\xe6\x07\xa2\x01\t\x12\x04OPEN\x18\xe7\x07R\x08\x65numType\x12\x92\x01\n\x17repeated_field_encoding\x18\x03 \x01(\x0e\x32\x31.google.protobuf.FeatureSet.RepeatedFieldEncodingB\'\x88\x01\x01\x98\x01\x04\x98\x01\x01\xa2\x01\r\x12\x08\x45XPANDED\x18\xe6\x07\xa2\x01\x0b\x12\x06PACKED\x18\xe7\x07R\x15repeatedFieldEncoding\x12x\n\x0futf8_validation\x18\x04 \x01(\x0e\x32*.google.protobuf.FeatureSet.Utf8ValidationB#\x88\x01\x01\x98\x01\x04\x98\x01\x01\xa2\x01\t\x12\x04NONE\x18\xe6\x07\xa2\x01\x0b\x12\x06VERIFY\x18\xe7\x07R\x0eutf8Validation\x12x\n\x10message_encoding\x18\x05 \x01(\x0e\x32+.google.protobuf.FeatureSet.MessageEncodingB \x88\x01\x01\x98\x01\x04\x98\x01\x01\xa2\x01\x14\x12\x0fLENGTH_PREFIXED\x18\xe6\x07R\x0fmessageEncoding\x12|\n\x0bjson_format\x18\x06 \x01(\x0e\x32&.google.protobuf.FeatureSet.JsonFormatB3\x88\x01\x01\x98\x01\x03\x98\x01\x06\x98\x01\x01\xa2\x01\x17\x12\x12LEGACY_BEST_EFFORT\x18\xe6\x07\xa2\x01\n\x12\x05\x41LLOW\x18\xe7\x07R\njsonFormat\"\\\n\rFieldPresence\x12\x1a\n\x16\x46IELD_PRESENCE_UNKNOWN\x10\x00\x12\x0c\n\x08\x45XPLICIT\x10\x01\x12\x0c\n\x08IMPLICIT\x10\x02\x12\x13\n\x0fLEGACY_REQUIRED\x10\x03\"7\n\x08\x45numType\x12\x15\n\x11\x45NUM_TYPE_UNKNOWN\x10\x00\x12\x08\n\x04OPEN\x10\x01\x12\n\n\x06\x43LOSED\x10\x02\"V\n\x15RepeatedFieldEncoding\x12#\n\x1fREPEATED_FIELD_ENCODING_UNKNOWN\x10\x00\x12\n\n\x06PACKED\x10\x01\x12\x0c\n\x08\x45XPANDED\x10\x02\"C\n\x0eUtf8Validation\x12\x1b\n\x17UTF8_VALIDATION_UNKNOWN\x10\x00\x12\x08\n\x04NONE\x10\x01\x12\n\n\x06VERIFY\x10\x02\"S\n\x0fMessageEncoding\x12\x1c\n\x18MESSAGE_ENCODING_UNKNOWN\x10\x00\x12\x13\n\x0fLENGTH_PREFIXED\x10\x01\x12\r\n\tDELIMITED\x10\x02\"H\n\nJsonFormat\x12\x17\n\x13JSON_FORMAT_UNKNOWN\x10\x00\x12\t\n\x05\x41LLOW\x10\x01\x12\x16\n\x12LEGACY_BEST_EFFORT\x10\x02*\x06\x08\xe8\x07\x10\xe9\x07*\x06\x08\xe9\x07\x10\xea\x07*\x06\x08\x8bN\x10\x90NJ\x06\x08\xe7\x07\x10\xe8\x07\"\xfe\x02\n\x12\x46\x65\x61tureSetDefaults\x12X\n\x08\x64\x65\x66\x61ults\x18\x01 \x03(\x0b\x32<.google.protobuf.FeatureSetDefaults.FeatureSetEditionDefaultR\x08\x64\x65\x66\x61ults\x12\x41\n\x0fminimum_edition\x18\x04 \x01(\x0e\x32\x18.google.protobuf.EditionR\x0eminimumEdition\x12\x41\n\x0fmaximum_edition\x18\x05 \x01(\x0e\x32\x18.google.protobuf.EditionR\x0emaximumEdition\x1a\x87\x01\n\x18\x46\x65\x61tureSetEditionDefault\x12\x32\n\x07\x65\x64ition\x18\x03 \x01(\x0e\x32\x18.google.protobuf.EditionR\x07\x65\x64ition\x12\x37\n\x08\x66\x65\x61tures\x18\x02 \x01(\x0b\x32\x1b.google.protobuf.FeatureSetR\x08\x66\x65\x61tures\"\xa7\x02\n\x0eSourceCodeInfo\x12\x44\n\x08location\x18\x01 \x03(\x0b\x32(.google.protobuf.SourceCodeInfo.LocationR\x08location\x1a\xce\x01\n\x08Location\x12\x16\n\x04path\x18\x01 \x03(\x05\x42\x02\x10\x01R\x04path\x12\x16\n\x04span\x18\x02 \x03(\x05\x42\x02\x10\x01R\x04span\x12)\n\x10leading_comments\x18\x03 \x01(\tR\x0fleadingComments\x12+\n\x11trailing_comments\x18\x04 \x01(\tR\x10trailingComments\x12:\n\x19leading_detached_comments\x18\x06 \x03(\tR\x17leadingDetachedComments\"\xd0\x02\n\x11GeneratedCodeInfo\x12M\n\nannotation\x18\x01 \x03(\x0b\x32-.google.protobuf.GeneratedCodeInfo.AnnotationR\nannotation\x1a\xeb\x01\n\nAnnotation\x12\x16\n\x04path\x18\x01 \x03(\x05\x42\x02\x10\x01R\x04path\x12\x1f\n\x0bsource_file\x18\x02 \x01(\tR\nsourceFile\x12\x14\n\x05\x62\x65gin\x18\x03 \x01(\x05R\x05\x62\x65gin\x12\x10\n\x03\x65nd\x18\x04 \x01(\x05R\x03\x65nd\x12R\n\x08semantic\x18\x05 \x01(\x0e\x32\x36.google.protobuf.GeneratedCodeInfo.Annotation.SemanticR\x08semantic\"(\n\x08Semantic\x12\x08\n\x04NONE\x10\x00\x12\x07\n\x03SET\x10\x01\x12\t\n\x05\x41LIAS\x10\x02*\xea\x01\n\x07\x45\x64ition\x12\x13\n\x0f\x45\x44ITION_UNKNOWN\x10\x00\x12\x13\n\x0e\x45\x44ITION_PROTO2\x10\xe6\x07\x12\x13\n\x0e\x45\x44ITION_PROTO3\x10\xe7\x07\x12\x11\n\x0c\x45\x44ITION_2023\x10\xe8\x07\x12\x17\n\x13\x45\x44ITION_1_TEST_ONLY\x10\x01\x12\x17\n\x13\x45\x44ITION_2_TEST_ONLY\x10\x02\x12\x1d\n\x17\x45\x44ITION_99997_TEST_ONLY\x10\x9d\x8d\x06\x12\x1d\n\x17\x45\x44ITION_99998_TEST_ONLY\x10\x9e\x8d\x06\x12\x1d\n\x17\x45\x44ITION_99999_TEST_ONLY\x10\x9f\x8d\x06\x42~\n\x13\x63om.google.protobufB\x10\x44\x65scriptorProtosH\x01Z-google.golang.org/protobuf/types/descriptorpb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1aGoogle.Protobuf.Reflection')
+
+_globals = globals()
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _EDITION = _descriptor.EnumDescriptor(
+    name='Edition',
+    full_name='google.protobuf.Edition',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='EDITION_UNKNOWN', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='EDITION_PROTO2', index=1, number=998,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='EDITION_PROTO3', index=2, number=999,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='EDITION_2023', index=3, number=1000,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='EDITION_1_TEST_ONLY', index=4, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='EDITION_2_TEST_ONLY', index=5, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='EDITION_99997_TEST_ONLY', index=6, number=99997,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='EDITION_99998_TEST_ONLY', index=7, number=99998,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='EDITION_99999_TEST_ONLY', index=8, number=99999,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_EDITION)
+
+  _EXTENSIONRANGEOPTIONS_VERIFICATIONSTATE = _descriptor.EnumDescriptor(
+    name='VerificationState',
+    full_name='google.protobuf.ExtensionRangeOptions.VerificationState',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='DECLARATION', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='UNVERIFIED', index=1, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_EXTENSIONRANGEOPTIONS_VERIFICATIONSTATE)
+
+  _FIELDDESCRIPTORPROTO_TYPE = _descriptor.EnumDescriptor(
+    name='Type',
+    full_name='google.protobuf.FieldDescriptorProto.Type',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_DOUBLE', index=0, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_FLOAT', index=1, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_INT64', index=2, number=3,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_UINT64', index=3, number=4,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_INT32', index=4, number=5,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_FIXED64', index=5, number=6,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_FIXED32', index=6, number=7,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_BOOL', index=7, number=8,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_STRING', index=8, number=9,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_GROUP', index=9, number=10,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_MESSAGE', index=10, number=11,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_BYTES', index=11, number=12,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_UINT32', index=12, number=13,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_ENUM', index=13, number=14,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_SFIXED32', index=14, number=15,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_SFIXED64', index=15, number=16,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_SINT32', index=16, number=17,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TYPE_SINT64', index=17, number=18,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_FIELDDESCRIPTORPROTO_TYPE)
+
+  _FIELDDESCRIPTORPROTO_LABEL = _descriptor.EnumDescriptor(
+    name='Label',
+    full_name='google.protobuf.FieldDescriptorProto.Label',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='LABEL_OPTIONAL', index=0, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='LABEL_REPEATED', index=1, number=3,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='LABEL_REQUIRED', index=2, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_FIELDDESCRIPTORPROTO_LABEL)
+
+  _FILEOPTIONS_OPTIMIZEMODE = _descriptor.EnumDescriptor(
+    name='OptimizeMode',
+    full_name='google.protobuf.FileOptions.OptimizeMode',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='SPEED', index=0, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='CODE_SIZE', index=1, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='LITE_RUNTIME', index=2, number=3,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_FILEOPTIONS_OPTIMIZEMODE)
+
+  _FIELDOPTIONS_CTYPE = _descriptor.EnumDescriptor(
+    name='CType',
+    full_name='google.protobuf.FieldOptions.CType',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='STRING', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='CORD', index=1, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='STRING_PIECE', index=2, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_FIELDOPTIONS_CTYPE)
+
+  _FIELDOPTIONS_JSTYPE = _descriptor.EnumDescriptor(
+    name='JSType',
+    full_name='google.protobuf.FieldOptions.JSType',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='JS_NORMAL', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='JS_STRING', index=1, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='JS_NUMBER', index=2, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_FIELDOPTIONS_JSTYPE)
+
+  _FIELDOPTIONS_OPTIONRETENTION = _descriptor.EnumDescriptor(
+    name='OptionRetention',
+    full_name='google.protobuf.FieldOptions.OptionRetention',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='RETENTION_UNKNOWN', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='RETENTION_RUNTIME', index=1, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='RETENTION_SOURCE', index=2, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_FIELDOPTIONS_OPTIONRETENTION)
+
+  _FIELDOPTIONS_OPTIONTARGETTYPE = _descriptor.EnumDescriptor(
+    name='OptionTargetType',
+    full_name='google.protobuf.FieldOptions.OptionTargetType',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='TARGET_TYPE_UNKNOWN', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TARGET_TYPE_FILE', index=1, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TARGET_TYPE_EXTENSION_RANGE', index=2, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TARGET_TYPE_MESSAGE', index=3, number=3,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TARGET_TYPE_FIELD', index=4, number=4,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TARGET_TYPE_ONEOF', index=5, number=5,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TARGET_TYPE_ENUM', index=6, number=6,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TARGET_TYPE_ENUM_ENTRY', index=7, number=7,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TARGET_TYPE_SERVICE', index=8, number=8,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='TARGET_TYPE_METHOD', index=9, number=9,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_FIELDOPTIONS_OPTIONTARGETTYPE)
+
+  _METHODOPTIONS_IDEMPOTENCYLEVEL = _descriptor.EnumDescriptor(
+    name='IdempotencyLevel',
+    full_name='google.protobuf.MethodOptions.IdempotencyLevel',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='IDEMPOTENCY_UNKNOWN', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='NO_SIDE_EFFECTS', index=1, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='IDEMPOTENT', index=2, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_METHODOPTIONS_IDEMPOTENCYLEVEL)
+
+  _FEATURESET_FIELDPRESENCE = _descriptor.EnumDescriptor(
+    name='FieldPresence',
+    full_name='google.protobuf.FeatureSet.FieldPresence',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='FIELD_PRESENCE_UNKNOWN', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='EXPLICIT', index=1, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='IMPLICIT', index=2, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='LEGACY_REQUIRED', index=3, number=3,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_FEATURESET_FIELDPRESENCE)
+
+  _FEATURESET_ENUMTYPE = _descriptor.EnumDescriptor(
+    name='EnumType',
+    full_name='google.protobuf.FeatureSet.EnumType',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='ENUM_TYPE_UNKNOWN', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='OPEN', index=1, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='CLOSED', index=2, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_FEATURESET_ENUMTYPE)
+
+  _FEATURESET_REPEATEDFIELDENCODING = _descriptor.EnumDescriptor(
+    name='RepeatedFieldEncoding',
+    full_name='google.protobuf.FeatureSet.RepeatedFieldEncoding',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='REPEATED_FIELD_ENCODING_UNKNOWN', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='PACKED', index=1, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='EXPANDED', index=2, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_FEATURESET_REPEATEDFIELDENCODING)
+
+  _FEATURESET_UTF8VALIDATION = _descriptor.EnumDescriptor(
+    name='Utf8Validation',
+    full_name='google.protobuf.FeatureSet.Utf8Validation',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='UTF8_VALIDATION_UNKNOWN', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='NONE', index=1, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='VERIFY', index=2, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_FEATURESET_UTF8VALIDATION)
+
+  _FEATURESET_MESSAGEENCODING = _descriptor.EnumDescriptor(
+    name='MessageEncoding',
+    full_name='google.protobuf.FeatureSet.MessageEncoding',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='MESSAGE_ENCODING_UNKNOWN', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='LENGTH_PREFIXED', index=1, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='DELIMITED', index=2, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_FEATURESET_MESSAGEENCODING)
+
+  _FEATURESET_JSONFORMAT = _descriptor.EnumDescriptor(
+    name='JsonFormat',
+    full_name='google.protobuf.FeatureSet.JsonFormat',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='JSON_FORMAT_UNKNOWN', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='ALLOW', index=1, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='LEGACY_BEST_EFFORT', index=2, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_FEATURESET_JSONFORMAT)
+
+  _GENERATEDCODEINFO_ANNOTATION_SEMANTIC = _descriptor.EnumDescriptor(
+    name='Semantic',
+    full_name='google.protobuf.GeneratedCodeInfo.Annotation.Semantic',
+    filename=None,
+    file=DESCRIPTOR,
+    create_key=_descriptor._internal_create_key,
+    values=[
+      _descriptor.EnumValueDescriptor(
+        name='NONE', index=0, number=0,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='SET', index=1, number=1,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+      _descriptor.EnumValueDescriptor(
+        name='ALIAS', index=2, number=2,
+        serialized_options=None,
+        type=None,
+        create_key=_descriptor._internal_create_key),
+    ],
+    containing_type=None,
+    serialized_options=None,
+  )
+  _sym_db.RegisterEnumDescriptor(_GENERATEDCODEINFO_ANNOTATION_SEMANTIC)
+
+
+  _FILEDESCRIPTORSET = _descriptor.Descriptor(
+    name='FileDescriptorSet',
+    full_name='google.protobuf.FileDescriptorSet',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='file', full_name='google.protobuf.FileDescriptorSet.file', index=0,
+        number=1, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='file', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+
+  _FILEDESCRIPTORPROTO = _descriptor.Descriptor(
+    name='FileDescriptorProto',
+    full_name='google.protobuf.FileDescriptorProto',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='name', full_name='google.protobuf.FileDescriptorProto.name', index=0,
+        number=1, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='name', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='package', full_name='google.protobuf.FileDescriptorProto.package', index=1,
+        number=2, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='package', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='dependency', full_name='google.protobuf.FileDescriptorProto.dependency', index=2,
+        number=3, type=9, cpp_type=9, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='dependency', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='public_dependency', full_name='google.protobuf.FileDescriptorProto.public_dependency', index=3,
+        number=10, type=5, cpp_type=1, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='publicDependency', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='weak_dependency', full_name='google.protobuf.FileDescriptorProto.weak_dependency', index=4,
+        number=11, type=5, cpp_type=1, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='weakDependency', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='message_type', full_name='google.protobuf.FileDescriptorProto.message_type', index=5,
+        number=4, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='messageType', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='enum_type', full_name='google.protobuf.FileDescriptorProto.enum_type', index=6,
+        number=5, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='enumType', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='service', full_name='google.protobuf.FileDescriptorProto.service', index=7,
+        number=6, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='service', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='extension', full_name='google.protobuf.FileDescriptorProto.extension', index=8,
+        number=7, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='extension', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='options', full_name='google.protobuf.FileDescriptorProto.options', index=9,
+        number=8, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='options', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='source_code_info', full_name='google.protobuf.FileDescriptorProto.source_code_info', index=10,
+        number=9, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='sourceCodeInfo', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='syntax', full_name='google.protobuf.FileDescriptorProto.syntax', index=11,
+        number=12, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='syntax', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='edition', full_name='google.protobuf.FileDescriptorProto.edition', index=12,
+        number=14, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='edition', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+
+  _DESCRIPTORPROTO_EXTENSIONRANGE = _descriptor.Descriptor(
+    name='ExtensionRange',
+    full_name='google.protobuf.DescriptorProto.ExtensionRange',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='start', full_name='google.protobuf.DescriptorProto.ExtensionRange.start', index=0,
+        number=1, type=5, cpp_type=1, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='start', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='end', full_name='google.protobuf.DescriptorProto.ExtensionRange.end', index=1,
+        number=2, type=5, cpp_type=1, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='end', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='options', full_name='google.protobuf.DescriptorProto.ExtensionRange.options', index=2,
+        number=3, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='options', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+  _DESCRIPTORPROTO_RESERVEDRANGE = _descriptor.Descriptor(
+    name='ReservedRange',
+    full_name='google.protobuf.DescriptorProto.ReservedRange',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='start', full_name='google.protobuf.DescriptorProto.ReservedRange.start', index=0,
+        number=1, type=5, cpp_type=1, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='start', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='end', full_name='google.protobuf.DescriptorProto.ReservedRange.end', index=1,
+        number=2, type=5, cpp_type=1, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='end', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+  _DESCRIPTORPROTO = _descriptor.Descriptor(
+    name='DescriptorProto',
+    full_name='google.protobuf.DescriptorProto',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='name', full_name='google.protobuf.DescriptorProto.name', index=0,
+        number=1, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='name', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='field', full_name='google.protobuf.DescriptorProto.field', index=1,
+        number=2, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='field', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='extension', full_name='google.protobuf.DescriptorProto.extension', index=2,
+        number=6, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='extension', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='nested_type', full_name='google.protobuf.DescriptorProto.nested_type', index=3,
+        number=3, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='nestedType', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='enum_type', full_name='google.protobuf.DescriptorProto.enum_type', index=4,
+        number=4, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='enumType', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='extension_range', full_name='google.protobuf.DescriptorProto.extension_range', index=5,
+        number=5, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='extensionRange', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='oneof_decl', full_name='google.protobuf.DescriptorProto.oneof_decl', index=6,
+        number=8, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='oneofDecl', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='options', full_name='google.protobuf.DescriptorProto.options', index=7,
+        number=7, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='options', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='reserved_range', full_name='google.protobuf.DescriptorProto.reserved_range', index=8,
+        number=9, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='reservedRange', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='reserved_name', full_name='google.protobuf.DescriptorProto.reserved_name', index=9,
+        number=10, type=9, cpp_type=9, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='reservedName', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[_DESCRIPTORPROTO_EXTENSIONRANGE, _DESCRIPTORPROTO_RESERVEDRANGE, ],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+
+  _EXTENSIONRANGEOPTIONS_DECLARATION = _descriptor.Descriptor(
+    name='Declaration',
+    full_name='google.protobuf.ExtensionRangeOptions.Declaration',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='number', full_name='google.protobuf.ExtensionRangeOptions.Declaration.number', index=0,
+        number=1, type=5, cpp_type=1, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='number', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='full_name', full_name='google.protobuf.ExtensionRangeOptions.Declaration.full_name', index=1,
+        number=2, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='fullName', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='type', full_name='google.protobuf.ExtensionRangeOptions.Declaration.type', index=2,
+        number=3, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='type', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='reserved', full_name='google.protobuf.ExtensionRangeOptions.Declaration.reserved', index=3,
+        number=5, type=8, cpp_type=7, label=1,
+        has_default_value=False, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='reserved', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='repeated', full_name='google.protobuf.ExtensionRangeOptions.Declaration.repeated', index=4,
+        number=6, type=8, cpp_type=7, label=1,
+        has_default_value=False, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='repeated', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+  _EXTENSIONRANGEOPTIONS = _descriptor.Descriptor(
+    name='ExtensionRangeOptions',
+    full_name='google.protobuf.ExtensionRangeOptions',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='uninterpreted_option', full_name='google.protobuf.ExtensionRangeOptions.uninterpreted_option', index=0,
+        number=999, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='uninterpretedOption', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='declaration', full_name='google.protobuf.ExtensionRangeOptions.declaration', index=1,
+        number=2, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=b'\210\001\002', json_name='declaration', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='features', full_name='google.protobuf.ExtensionRangeOptions.features', index=2,
+        number=50, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='features', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='verification', full_name='google.protobuf.ExtensionRangeOptions.verification', index=3,
+        number=3, type=14, cpp_type=8, label=1,
+        has_default_value=True, default_value=1,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='verification', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[_EXTENSIONRANGEOPTIONS_DECLARATION, ],
+    enum_types=[
+      _EXTENSIONRANGEOPTIONS_VERIFICATIONSTATE,
+    ],
+    serialized_options=None,
+    is_extendable=True,
+    syntax='proto2',
+    extension_ranges=[(1000, 536870912), ],
+    oneofs=[
+    ],
+  )
+
+
+  _FIELDDESCRIPTORPROTO = _descriptor.Descriptor(
+    name='FieldDescriptorProto',
+    full_name='google.protobuf.FieldDescriptorProto',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='name', full_name='google.protobuf.FieldDescriptorProto.name', index=0,
+        number=1, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='name', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='number', full_name='google.protobuf.FieldDescriptorProto.number', index=1,
+        number=3, type=5, cpp_type=1, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='number', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='label', full_name='google.protobuf.FieldDescriptorProto.label', index=2,
+        number=4, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=1,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='label', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='type', full_name='google.protobuf.FieldDescriptorProto.type', index=3,
+        number=5, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=1,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='type', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='type_name', full_name='google.protobuf.FieldDescriptorProto.type_name', index=4,
+        number=6, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='typeName', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='extendee', full_name='google.protobuf.FieldDescriptorProto.extendee', index=5,
+        number=2, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='extendee', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='default_value', full_name='google.protobuf.FieldDescriptorProto.default_value', index=6,
+        number=7, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='defaultValue', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='oneof_index', full_name='google.protobuf.FieldDescriptorProto.oneof_index', index=7,
+        number=9, type=5, cpp_type=1, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='oneofIndex', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='json_name', full_name='google.protobuf.FieldDescriptorProto.json_name', index=8,
+        number=10, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='jsonName', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='options', full_name='google.protobuf.FieldDescriptorProto.options', index=9,
+        number=8, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='options', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='proto3_optional', full_name='google.protobuf.FieldDescriptorProto.proto3_optional', index=10,
+        number=17, type=8, cpp_type=7, label=1,
+        has_default_value=False, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='proto3Optional', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+      _FIELDDESCRIPTORPROTO_TYPE,
+      _FIELDDESCRIPTORPROTO_LABEL,
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+
+  _ONEOFDESCRIPTORPROTO = _descriptor.Descriptor(
+    name='OneofDescriptorProto',
+    full_name='google.protobuf.OneofDescriptorProto',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='name', full_name='google.protobuf.OneofDescriptorProto.name', index=0,
+        number=1, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='name', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='options', full_name='google.protobuf.OneofDescriptorProto.options', index=1,
+        number=2, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='options', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+
+  _ENUMDESCRIPTORPROTO_ENUMRESERVEDRANGE = _descriptor.Descriptor(
+    name='EnumReservedRange',
+    full_name='google.protobuf.EnumDescriptorProto.EnumReservedRange',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='start', full_name='google.protobuf.EnumDescriptorProto.EnumReservedRange.start', index=0,
+        number=1, type=5, cpp_type=1, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='start', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='end', full_name='google.protobuf.EnumDescriptorProto.EnumReservedRange.end', index=1,
+        number=2, type=5, cpp_type=1, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='end', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+  _ENUMDESCRIPTORPROTO = _descriptor.Descriptor(
+    name='EnumDescriptorProto',
+    full_name='google.protobuf.EnumDescriptorProto',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='name', full_name='google.protobuf.EnumDescriptorProto.name', index=0,
+        number=1, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='name', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='value', full_name='google.protobuf.EnumDescriptorProto.value', index=1,
+        number=2, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='value', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='options', full_name='google.protobuf.EnumDescriptorProto.options', index=2,
+        number=3, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='options', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='reserved_range', full_name='google.protobuf.EnumDescriptorProto.reserved_range', index=3,
+        number=4, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='reservedRange', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='reserved_name', full_name='google.protobuf.EnumDescriptorProto.reserved_name', index=4,
+        number=5, type=9, cpp_type=9, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='reservedName', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[_ENUMDESCRIPTORPROTO_ENUMRESERVEDRANGE, ],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+
+  _ENUMVALUEDESCRIPTORPROTO = _descriptor.Descriptor(
+    name='EnumValueDescriptorProto',
+    full_name='google.protobuf.EnumValueDescriptorProto',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='name', full_name='google.protobuf.EnumValueDescriptorProto.name', index=0,
+        number=1, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='name', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='number', full_name='google.protobuf.EnumValueDescriptorProto.number', index=1,
+        number=2, type=5, cpp_type=1, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='number', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='options', full_name='google.protobuf.EnumValueDescriptorProto.options', index=2,
+        number=3, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='options', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+
+  _SERVICEDESCRIPTORPROTO = _descriptor.Descriptor(
+    name='ServiceDescriptorProto',
+    full_name='google.protobuf.ServiceDescriptorProto',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='name', full_name='google.protobuf.ServiceDescriptorProto.name', index=0,
+        number=1, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='name', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='method', full_name='google.protobuf.ServiceDescriptorProto.method', index=1,
+        number=2, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='method', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='options', full_name='google.protobuf.ServiceDescriptorProto.options', index=2,
+        number=3, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='options', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+
+  _METHODDESCRIPTORPROTO = _descriptor.Descriptor(
+    name='MethodDescriptorProto',
+    full_name='google.protobuf.MethodDescriptorProto',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='name', full_name='google.protobuf.MethodDescriptorProto.name', index=0,
+        number=1, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='name', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='input_type', full_name='google.protobuf.MethodDescriptorProto.input_type', index=1,
+        number=2, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='inputType', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='output_type', full_name='google.protobuf.MethodDescriptorProto.output_type', index=2,
+        number=3, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='outputType', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='options', full_name='google.protobuf.MethodDescriptorProto.options', index=3,
+        number=4, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='options', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='client_streaming', full_name='google.protobuf.MethodDescriptorProto.client_streaming', index=4,
+        number=5, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='clientStreaming', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='server_streaming', full_name='google.protobuf.MethodDescriptorProto.server_streaming', index=5,
+        number=6, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='serverStreaming', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+
+  _FILEOPTIONS = _descriptor.Descriptor(
+    name='FileOptions',
+    full_name='google.protobuf.FileOptions',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='java_package', full_name='google.protobuf.FileOptions.java_package', index=0,
+        number=1, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='javaPackage', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='java_outer_classname', full_name='google.protobuf.FileOptions.java_outer_classname', index=1,
+        number=8, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='javaOuterClassname', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='java_multiple_files', full_name='google.protobuf.FileOptions.java_multiple_files', index=2,
+        number=10, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='javaMultipleFiles', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='java_generate_equals_and_hash', full_name='google.protobuf.FileOptions.java_generate_equals_and_hash', index=3,
+        number=20, type=8, cpp_type=7, label=1,
+        has_default_value=False, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=b'\030\001', json_name='javaGenerateEqualsAndHash', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='java_string_check_utf8', full_name='google.protobuf.FileOptions.java_string_check_utf8', index=4,
+        number=27, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='javaStringCheckUtf8', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='optimize_for', full_name='google.protobuf.FileOptions.optimize_for', index=5,
+        number=9, type=14, cpp_type=8, label=1,
+        has_default_value=True, default_value=1,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='optimizeFor', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='go_package', full_name='google.protobuf.FileOptions.go_package', index=6,
+        number=11, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='goPackage', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='cc_generic_services', full_name='google.protobuf.FileOptions.cc_generic_services', index=7,
+        number=16, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='ccGenericServices', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='java_generic_services', full_name='google.protobuf.FileOptions.java_generic_services', index=8,
+        number=17, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='javaGenericServices', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='py_generic_services', full_name='google.protobuf.FileOptions.py_generic_services', index=9,
+        number=18, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='pyGenericServices', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='php_generic_services', full_name='google.protobuf.FileOptions.php_generic_services', index=10,
+        number=42, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='phpGenericServices', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='deprecated', full_name='google.protobuf.FileOptions.deprecated', index=11,
+        number=23, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='deprecated', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='cc_enable_arenas', full_name='google.protobuf.FileOptions.cc_enable_arenas', index=12,
+        number=31, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=True,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='ccEnableArenas', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='objc_class_prefix', full_name='google.protobuf.FileOptions.objc_class_prefix', index=13,
+        number=36, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='objcClassPrefix', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='csharp_namespace', full_name='google.protobuf.FileOptions.csharp_namespace', index=14,
+        number=37, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='csharpNamespace', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='swift_prefix', full_name='google.protobuf.FileOptions.swift_prefix', index=15,
+        number=39, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='swiftPrefix', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='php_class_prefix', full_name='google.protobuf.FileOptions.php_class_prefix', index=16,
+        number=40, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='phpClassPrefix', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='php_namespace', full_name='google.protobuf.FileOptions.php_namespace', index=17,
+        number=41, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='phpNamespace', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='php_metadata_namespace', full_name='google.protobuf.FileOptions.php_metadata_namespace', index=18,
+        number=44, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='phpMetadataNamespace', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='ruby_package', full_name='google.protobuf.FileOptions.ruby_package', index=19,
+        number=45, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='rubyPackage', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='features', full_name='google.protobuf.FileOptions.features', index=20,
+        number=50, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='features', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='uninterpreted_option', full_name='google.protobuf.FileOptions.uninterpreted_option', index=21,
+        number=999, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='uninterpretedOption', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+      _FILEOPTIONS_OPTIMIZEMODE,
+    ],
+    serialized_options=None,
+    is_extendable=True,
+    syntax='proto2',
+    extension_ranges=[(1000, 536870912), ],
+    oneofs=[
+    ],
+  )
+
+
+  _MESSAGEOPTIONS = _descriptor.Descriptor(
+    name='MessageOptions',
+    full_name='google.protobuf.MessageOptions',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='message_set_wire_format', full_name='google.protobuf.MessageOptions.message_set_wire_format', index=0,
+        number=1, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='messageSetWireFormat', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='no_standard_descriptor_accessor', full_name='google.protobuf.MessageOptions.no_standard_descriptor_accessor', index=1,
+        number=2, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='noStandardDescriptorAccessor', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='deprecated', full_name='google.protobuf.MessageOptions.deprecated', index=2,
+        number=3, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='deprecated', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='map_entry', full_name='google.protobuf.MessageOptions.map_entry', index=3,
+        number=7, type=8, cpp_type=7, label=1,
+        has_default_value=False, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='mapEntry', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='deprecated_legacy_json_field_conflicts', full_name='google.protobuf.MessageOptions.deprecated_legacy_json_field_conflicts', index=4,
+        number=11, type=8, cpp_type=7, label=1,
+        has_default_value=False, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=b'\030\001', json_name='deprecatedLegacyJsonFieldConflicts', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='features', full_name='google.protobuf.MessageOptions.features', index=5,
+        number=12, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='features', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='uninterpreted_option', full_name='google.protobuf.MessageOptions.uninterpreted_option', index=6,
+        number=999, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='uninterpretedOption', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=True,
+    syntax='proto2',
+    extension_ranges=[(1000, 536870912), ],
+    oneofs=[
+    ],
+  )
+
+
+  _FIELDOPTIONS_EDITIONDEFAULT = _descriptor.Descriptor(
+    name='EditionDefault',
+    full_name='google.protobuf.FieldOptions.EditionDefault',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='edition', full_name='google.protobuf.FieldOptions.EditionDefault.edition', index=0,
+        number=3, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='edition', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='value', full_name='google.protobuf.FieldOptions.EditionDefault.value', index=1,
+        number=2, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='value', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+  _FIELDOPTIONS = _descriptor.Descriptor(
+    name='FieldOptions',
+    full_name='google.protobuf.FieldOptions',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='ctype', full_name='google.protobuf.FieldOptions.ctype', index=0,
+        number=1, type=14, cpp_type=8, label=1,
+        has_default_value=True, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='ctype', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='packed', full_name='google.protobuf.FieldOptions.packed', index=1,
+        number=2, type=8, cpp_type=7, label=1,
+        has_default_value=False, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='packed', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='jstype', full_name='google.protobuf.FieldOptions.jstype', index=2,
+        number=6, type=14, cpp_type=8, label=1,
+        has_default_value=True, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='jstype', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='lazy', full_name='google.protobuf.FieldOptions.lazy', index=3,
+        number=5, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='lazy', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='unverified_lazy', full_name='google.protobuf.FieldOptions.unverified_lazy', index=4,
+        number=15, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='unverifiedLazy', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='deprecated', full_name='google.protobuf.FieldOptions.deprecated', index=5,
+        number=3, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='deprecated', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='weak', full_name='google.protobuf.FieldOptions.weak', index=6,
+        number=10, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='weak', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='debug_redact', full_name='google.protobuf.FieldOptions.debug_redact', index=7,
+        number=16, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='debugRedact', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='retention', full_name='google.protobuf.FieldOptions.retention', index=8,
+        number=17, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='retention', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='targets', full_name='google.protobuf.FieldOptions.targets', index=9,
+        number=19, type=14, cpp_type=8, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='targets', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='edition_defaults', full_name='google.protobuf.FieldOptions.edition_defaults', index=10,
+        number=20, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='editionDefaults', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='features', full_name='google.protobuf.FieldOptions.features', index=11,
+        number=21, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='features', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='uninterpreted_option', full_name='google.protobuf.FieldOptions.uninterpreted_option', index=12,
+        number=999, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='uninterpretedOption', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[_FIELDOPTIONS_EDITIONDEFAULT, ],
+    enum_types=[
+      _FIELDOPTIONS_CTYPE,
+      _FIELDOPTIONS_JSTYPE,
+      _FIELDOPTIONS_OPTIONRETENTION,
+      _FIELDOPTIONS_OPTIONTARGETTYPE,
+    ],
+    serialized_options=None,
+    is_extendable=True,
+    syntax='proto2',
+    extension_ranges=[(1000, 536870912), ],
+    oneofs=[
+    ],
+  )
+
+
+  _ONEOFOPTIONS = _descriptor.Descriptor(
+    name='OneofOptions',
+    full_name='google.protobuf.OneofOptions',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='features', full_name='google.protobuf.OneofOptions.features', index=0,
+        number=1, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='features', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='uninterpreted_option', full_name='google.protobuf.OneofOptions.uninterpreted_option', index=1,
+        number=999, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='uninterpretedOption', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=True,
+    syntax='proto2',
+    extension_ranges=[(1000, 536870912), ],
+    oneofs=[
+    ],
+  )
+
+
+  _ENUMOPTIONS = _descriptor.Descriptor(
+    name='EnumOptions',
+    full_name='google.protobuf.EnumOptions',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='allow_alias', full_name='google.protobuf.EnumOptions.allow_alias', index=0,
+        number=2, type=8, cpp_type=7, label=1,
+        has_default_value=False, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='allowAlias', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='deprecated', full_name='google.protobuf.EnumOptions.deprecated', index=1,
+        number=3, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='deprecated', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='deprecated_legacy_json_field_conflicts', full_name='google.protobuf.EnumOptions.deprecated_legacy_json_field_conflicts', index=2,
+        number=6, type=8, cpp_type=7, label=1,
+        has_default_value=False, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=b'\030\001', json_name='deprecatedLegacyJsonFieldConflicts', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='features', full_name='google.protobuf.EnumOptions.features', index=3,
+        number=7, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='features', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='uninterpreted_option', full_name='google.protobuf.EnumOptions.uninterpreted_option', index=4,
+        number=999, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='uninterpretedOption', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=True,
+    syntax='proto2',
+    extension_ranges=[(1000, 536870912), ],
+    oneofs=[
+    ],
+  )
+
+
+  _ENUMVALUEOPTIONS = _descriptor.Descriptor(
+    name='EnumValueOptions',
+    full_name='google.protobuf.EnumValueOptions',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='deprecated', full_name='google.protobuf.EnumValueOptions.deprecated', index=0,
+        number=1, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='deprecated', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='features', full_name='google.protobuf.EnumValueOptions.features', index=1,
+        number=2, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='features', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='debug_redact', full_name='google.protobuf.EnumValueOptions.debug_redact', index=2,
+        number=3, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='debugRedact', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='uninterpreted_option', full_name='google.protobuf.EnumValueOptions.uninterpreted_option', index=3,
+        number=999, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='uninterpretedOption', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=True,
+    syntax='proto2',
+    extension_ranges=[(1000, 536870912), ],
+    oneofs=[
+    ],
+  )
+
+
+  _SERVICEOPTIONS = _descriptor.Descriptor(
+    name='ServiceOptions',
+    full_name='google.protobuf.ServiceOptions',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='features', full_name='google.protobuf.ServiceOptions.features', index=0,
+        number=34, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='features', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='deprecated', full_name='google.protobuf.ServiceOptions.deprecated', index=1,
+        number=33, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='deprecated', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='uninterpreted_option', full_name='google.protobuf.ServiceOptions.uninterpreted_option', index=2,
+        number=999, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='uninterpretedOption', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=True,
+    syntax='proto2',
+    extension_ranges=[(1000, 536870912), ],
+    oneofs=[
+    ],
+  )
+
+
+  _METHODOPTIONS = _descriptor.Descriptor(
+    name='MethodOptions',
+    full_name='google.protobuf.MethodOptions',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='deprecated', full_name='google.protobuf.MethodOptions.deprecated', index=0,
+        number=33, type=8, cpp_type=7, label=1,
+        has_default_value=True, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='deprecated', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='idempotency_level', full_name='google.protobuf.MethodOptions.idempotency_level', index=1,
+        number=34, type=14, cpp_type=8, label=1,
+        has_default_value=True, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='idempotencyLevel', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='features', full_name='google.protobuf.MethodOptions.features', index=2,
+        number=35, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='features', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='uninterpreted_option', full_name='google.protobuf.MethodOptions.uninterpreted_option', index=3,
+        number=999, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='uninterpretedOption', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+      _METHODOPTIONS_IDEMPOTENCYLEVEL,
+    ],
+    serialized_options=None,
+    is_extendable=True,
+    syntax='proto2',
+    extension_ranges=[(1000, 536870912), ],
+    oneofs=[
+    ],
+  )
+
+
+  _UNINTERPRETEDOPTION_NAMEPART = _descriptor.Descriptor(
+    name='NamePart',
+    full_name='google.protobuf.UninterpretedOption.NamePart',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='name_part', full_name='google.protobuf.UninterpretedOption.NamePart.name_part', index=0,
+        number=1, type=9, cpp_type=9, label=2,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='namePart', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='is_extension', full_name='google.protobuf.UninterpretedOption.NamePart.is_extension', index=1,
+        number=2, type=8, cpp_type=7, label=2,
+        has_default_value=False, default_value=False,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='isExtension', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+  _UNINTERPRETEDOPTION = _descriptor.Descriptor(
+    name='UninterpretedOption',
+    full_name='google.protobuf.UninterpretedOption',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='name', full_name='google.protobuf.UninterpretedOption.name', index=0,
+        number=2, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='name', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='identifier_value', full_name='google.protobuf.UninterpretedOption.identifier_value', index=1,
+        number=3, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='identifierValue', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='positive_int_value', full_name='google.protobuf.UninterpretedOption.positive_int_value', index=2,
+        number=4, type=4, cpp_type=4, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='positiveIntValue', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='negative_int_value', full_name='google.protobuf.UninterpretedOption.negative_int_value', index=3,
+        number=5, type=3, cpp_type=2, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='negativeIntValue', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='double_value', full_name='google.protobuf.UninterpretedOption.double_value', index=4,
+        number=6, type=1, cpp_type=5, label=1,
+        has_default_value=False, default_value=float(0),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='doubleValue', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='string_value', full_name='google.protobuf.UninterpretedOption.string_value', index=5,
+        number=7, type=12, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"",
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='stringValue', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='aggregate_value', full_name='google.protobuf.UninterpretedOption.aggregate_value', index=6,
+        number=8, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='aggregateValue', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[_UNINTERPRETEDOPTION_NAMEPART, ],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+
+  _FEATURESET = _descriptor.Descriptor(
+    name='FeatureSet',
+    full_name='google.protobuf.FeatureSet',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='field_presence', full_name='google.protobuf.FeatureSet.field_presence', index=0,
+        number=1, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=b'\210\001\001\230\001\004\230\001\001\242\001\r\022\010EXPLICIT\030\346\007\242\001\r\022\010IMPLICIT\030\347\007\242\001\r\022\010EXPLICIT\030\350\007', json_name='fieldPresence', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='enum_type', full_name='google.protobuf.FeatureSet.enum_type', index=1,
+        number=2, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=b'\210\001\001\230\001\006\230\001\001\242\001\013\022\006CLOSED\030\346\007\242\001\t\022\004OPEN\030\347\007', json_name='enumType', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='repeated_field_encoding', full_name='google.protobuf.FeatureSet.repeated_field_encoding', index=2,
+        number=3, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=b'\210\001\001\230\001\004\230\001\001\242\001\r\022\010EXPANDED\030\346\007\242\001\013\022\006PACKED\030\347\007', json_name='repeatedFieldEncoding', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='utf8_validation', full_name='google.protobuf.FeatureSet.utf8_validation', index=3,
+        number=4, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=b'\210\001\001\230\001\004\230\001\001\242\001\t\022\004NONE\030\346\007\242\001\013\022\006VERIFY\030\347\007', json_name='utf8Validation', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='message_encoding', full_name='google.protobuf.FeatureSet.message_encoding', index=4,
+        number=5, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=b'\210\001\001\230\001\004\230\001\001\242\001\024\022\017LENGTH_PREFIXED\030\346\007', json_name='messageEncoding', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='json_format', full_name='google.protobuf.FeatureSet.json_format', index=5,
+        number=6, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=b'\210\001\001\230\001\003\230\001\006\230\001\001\242\001\027\022\022LEGACY_BEST_EFFORT\030\346\007\242\001\n\022\005ALLOW\030\347\007', json_name='jsonFormat', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+      _FEATURESET_FIELDPRESENCE,
+      _FEATURESET_ENUMTYPE,
+      _FEATURESET_REPEATEDFIELDENCODING,
+      _FEATURESET_UTF8VALIDATION,
+      _FEATURESET_MESSAGEENCODING,
+      _FEATURESET_JSONFORMAT,
+    ],
+    serialized_options=None,
+    is_extendable=True,
+    syntax='proto2',
+    extension_ranges=[(1000, 1001), (1001, 1002), (9995, 10000), ],
+    oneofs=[
+    ],
+  )
+
+
+  _FEATURESETDEFAULTS_FEATURESETEDITIONDEFAULT = _descriptor.Descriptor(
+    name='FeatureSetEditionDefault',
+    full_name='google.protobuf.FeatureSetDefaults.FeatureSetEditionDefault',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='edition', full_name='google.protobuf.FeatureSetDefaults.FeatureSetEditionDefault.edition', index=0,
+        number=3, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='edition', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='features', full_name='google.protobuf.FeatureSetDefaults.FeatureSetEditionDefault.features', index=1,
+        number=2, type=11, cpp_type=10, label=1,
+        has_default_value=False, default_value=None,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='features', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+  _FEATURESETDEFAULTS = _descriptor.Descriptor(
+    name='FeatureSetDefaults',
+    full_name='google.protobuf.FeatureSetDefaults',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='defaults', full_name='google.protobuf.FeatureSetDefaults.defaults', index=0,
+        number=1, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='defaults', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='minimum_edition', full_name='google.protobuf.FeatureSetDefaults.minimum_edition', index=1,
+        number=4, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='minimumEdition', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='maximum_edition', full_name='google.protobuf.FeatureSetDefaults.maximum_edition', index=2,
+        number=5, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='maximumEdition', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[_FEATURESETDEFAULTS_FEATURESETEDITIONDEFAULT, ],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+
+  _SOURCECODEINFO_LOCATION = _descriptor.Descriptor(
+    name='Location',
+    full_name='google.protobuf.SourceCodeInfo.Location',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='path', full_name='google.protobuf.SourceCodeInfo.Location.path', index=0,
+        number=1, type=5, cpp_type=1, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=b'\020\001', json_name='path', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='span', full_name='google.protobuf.SourceCodeInfo.Location.span', index=1,
+        number=2, type=5, cpp_type=1, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=b'\020\001', json_name='span', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='leading_comments', full_name='google.protobuf.SourceCodeInfo.Location.leading_comments', index=2,
+        number=3, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='leadingComments', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='trailing_comments', full_name='google.protobuf.SourceCodeInfo.Location.trailing_comments', index=3,
+        number=4, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='trailingComments', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='leading_detached_comments', full_name='google.protobuf.SourceCodeInfo.Location.leading_detached_comments', index=4,
+        number=6, type=9, cpp_type=9, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='leadingDetachedComments', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+  _SOURCECODEINFO = _descriptor.Descriptor(
+    name='SourceCodeInfo',
+    full_name='google.protobuf.SourceCodeInfo',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='location', full_name='google.protobuf.SourceCodeInfo.location', index=0,
+        number=1, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='location', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[_SOURCECODEINFO_LOCATION, ],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+
+  _GENERATEDCODEINFO_ANNOTATION = _descriptor.Descriptor(
+    name='Annotation',
+    full_name='google.protobuf.GeneratedCodeInfo.Annotation',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='path', full_name='google.protobuf.GeneratedCodeInfo.Annotation.path', index=0,
+        number=1, type=5, cpp_type=1, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=b'\020\001', json_name='path', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='source_file', full_name='google.protobuf.GeneratedCodeInfo.Annotation.source_file', index=1,
+        number=2, type=9, cpp_type=9, label=1,
+        has_default_value=False, default_value=b"".decode('utf-8'),
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='sourceFile', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='begin', full_name='google.protobuf.GeneratedCodeInfo.Annotation.begin', index=2,
+        number=3, type=5, cpp_type=1, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='begin', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='end', full_name='google.protobuf.GeneratedCodeInfo.Annotation.end', index=3,
+        number=4, type=5, cpp_type=1, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='end', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+      _descriptor.FieldDescriptor(
+        name='semantic', full_name='google.protobuf.GeneratedCodeInfo.Annotation.semantic', index=4,
+        number=5, type=14, cpp_type=8, label=1,
+        has_default_value=False, default_value=0,
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='semantic', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[],
+    enum_types=[
+      _GENERATEDCODEINFO_ANNOTATION_SEMANTIC,
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+  _GENERATEDCODEINFO = _descriptor.Descriptor(
+    name='GeneratedCodeInfo',
+    full_name='google.protobuf.GeneratedCodeInfo',
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    create_key=_descriptor._internal_create_key,
+    fields=[
+      _descriptor.FieldDescriptor(
+        name='annotation', full_name='google.protobuf.GeneratedCodeInfo.annotation', index=0,
+        number=1, type=11, cpp_type=10, label=3,
+        has_default_value=False, default_value=[],
+        message_type=None, enum_type=None, containing_type=None,
+        is_extension=False, extension_scope=None,
+        serialized_options=None, json_name='annotation', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    ],
+    extensions=[
+    ],
+    nested_types=[_GENERATEDCODEINFO_ANNOTATION, ],
+    enum_types=[
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax='proto2',
+    extension_ranges=[],
+    oneofs=[
+    ],
+  )
+
+  _FILEDESCRIPTORSET.fields_by_name['file'].message_type = _FILEDESCRIPTORPROTO
+  _FILEDESCRIPTORPROTO.fields_by_name['message_type'].message_type = _DESCRIPTORPROTO
+  _FILEDESCRIPTORPROTO.fields_by_name['enum_type'].message_type = _ENUMDESCRIPTORPROTO
+  _FILEDESCRIPTORPROTO.fields_by_name['service'].message_type = _SERVICEDESCRIPTORPROTO
+  _FILEDESCRIPTORPROTO.fields_by_name['extension'].message_type = _FIELDDESCRIPTORPROTO
+  _FILEDESCRIPTORPROTO.fields_by_name['options'].message_type = _FILEOPTIONS
+  _FILEDESCRIPTORPROTO.fields_by_name['source_code_info'].message_type = _SOURCECODEINFO
+  _FILEDESCRIPTORPROTO.fields_by_name['edition'].enum_type = _EDITION
+  _DESCRIPTORPROTO_EXTENSIONRANGE.fields_by_name['options'].message_type = _EXTENSIONRANGEOPTIONS
+  _DESCRIPTORPROTO_EXTENSIONRANGE.containing_type = _DESCRIPTORPROTO
+  _DESCRIPTORPROTO_RESERVEDRANGE.containing_type = _DESCRIPTORPROTO
+  _DESCRIPTORPROTO.fields_by_name['field'].message_type = _FIELDDESCRIPTORPROTO
+  _DESCRIPTORPROTO.fields_by_name['extension'].message_type = _FIELDDESCRIPTORPROTO
+  _DESCRIPTORPROTO.fields_by_name['nested_type'].message_type = _DESCRIPTORPROTO
+  _DESCRIPTORPROTO.fields_by_name['enum_type'].message_type = _ENUMDESCRIPTORPROTO
+  _DESCRIPTORPROTO.fields_by_name['extension_range'].message_type = _DESCRIPTORPROTO_EXTENSIONRANGE
+  _DESCRIPTORPROTO.fields_by_name['oneof_decl'].message_type = _ONEOFDESCRIPTORPROTO
+  _DESCRIPTORPROTO.fields_by_name['options'].message_type = _MESSAGEOPTIONS
+  _DESCRIPTORPROTO.fields_by_name['reserved_range'].message_type = _DESCRIPTORPROTO_RESERVEDRANGE
+  _EXTENSIONRANGEOPTIONS_DECLARATION.containing_type = _EXTENSIONRANGEOPTIONS
+  _EXTENSIONRANGEOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+  _EXTENSIONRANGEOPTIONS.fields_by_name['declaration'].message_type = _EXTENSIONRANGEOPTIONS_DECLARATION
+  _EXTENSIONRANGEOPTIONS.fields_by_name['features'].message_type = _FEATURESET
+  _EXTENSIONRANGEOPTIONS.fields_by_name['verification'].enum_type = _EXTENSIONRANGEOPTIONS_VERIFICATIONSTATE
+  _EXTENSIONRANGEOPTIONS_VERIFICATIONSTATE.containing_type = _EXTENSIONRANGEOPTIONS
+  _FIELDDESCRIPTORPROTO.fields_by_name['label'].enum_type = _FIELDDESCRIPTORPROTO_LABEL
+  _FIELDDESCRIPTORPROTO.fields_by_name['type'].enum_type = _FIELDDESCRIPTORPROTO_TYPE
+  _FIELDDESCRIPTORPROTO.fields_by_name['options'].message_type = _FIELDOPTIONS
+  _FIELDDESCRIPTORPROTO_TYPE.containing_type = _FIELDDESCRIPTORPROTO
+  _FIELDDESCRIPTORPROTO_LABEL.containing_type = _FIELDDESCRIPTORPROTO
+  _ONEOFDESCRIPTORPROTO.fields_by_name['options'].message_type = _ONEOFOPTIONS
+  _ENUMDESCRIPTORPROTO_ENUMRESERVEDRANGE.containing_type = _ENUMDESCRIPTORPROTO
+  _ENUMDESCRIPTORPROTO.fields_by_name['value'].message_type = _ENUMVALUEDESCRIPTORPROTO
+  _ENUMDESCRIPTORPROTO.fields_by_name['options'].message_type = _ENUMOPTIONS
+  _ENUMDESCRIPTORPROTO.fields_by_name['reserved_range'].message_type = _ENUMDESCRIPTORPROTO_ENUMRESERVEDRANGE
+  _ENUMVALUEDESCRIPTORPROTO.fields_by_name['options'].message_type = _ENUMVALUEOPTIONS
+  _SERVICEDESCRIPTORPROTO.fields_by_name['method'].message_type = _METHODDESCRIPTORPROTO
+  _SERVICEDESCRIPTORPROTO.fields_by_name['options'].message_type = _SERVICEOPTIONS
+  _METHODDESCRIPTORPROTO.fields_by_name['options'].message_type = _METHODOPTIONS
+  _FILEOPTIONS.fields_by_name['optimize_for'].enum_type = _FILEOPTIONS_OPTIMIZEMODE
+  _FILEOPTIONS.fields_by_name['features'].message_type = _FEATURESET
+  _FILEOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+  _FILEOPTIONS_OPTIMIZEMODE.containing_type = _FILEOPTIONS
+  _MESSAGEOPTIONS.fields_by_name['features'].message_type = _FEATURESET
+  _MESSAGEOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+  _FIELDOPTIONS_EDITIONDEFAULT.fields_by_name['edition'].enum_type = _EDITION
+  _FIELDOPTIONS_EDITIONDEFAULT.containing_type = _FIELDOPTIONS
+  _FIELDOPTIONS.fields_by_name['ctype'].enum_type = _FIELDOPTIONS_CTYPE
+  _FIELDOPTIONS.fields_by_name['jstype'].enum_type = _FIELDOPTIONS_JSTYPE
+  _FIELDOPTIONS.fields_by_name['retention'].enum_type = _FIELDOPTIONS_OPTIONRETENTION
+  _FIELDOPTIONS.fields_by_name['targets'].enum_type = _FIELDOPTIONS_OPTIONTARGETTYPE
+  _FIELDOPTIONS.fields_by_name['edition_defaults'].message_type = _FIELDOPTIONS_EDITIONDEFAULT
+  _FIELDOPTIONS.fields_by_name['features'].message_type = _FEATURESET
+  _FIELDOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+  _FIELDOPTIONS_CTYPE.containing_type = _FIELDOPTIONS
+  _FIELDOPTIONS_JSTYPE.containing_type = _FIELDOPTIONS
+  _FIELDOPTIONS_OPTIONRETENTION.containing_type = _FIELDOPTIONS
+  _FIELDOPTIONS_OPTIONTARGETTYPE.containing_type = _FIELDOPTIONS
+  _ONEOFOPTIONS.fields_by_name['features'].message_type = _FEATURESET
+  _ONEOFOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+  _ENUMOPTIONS.fields_by_name['features'].message_type = _FEATURESET
+  _ENUMOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+  _ENUMVALUEOPTIONS.fields_by_name['features'].message_type = _FEATURESET
+  _ENUMVALUEOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+  _SERVICEOPTIONS.fields_by_name['features'].message_type = _FEATURESET
+  _SERVICEOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+  _METHODOPTIONS.fields_by_name['idempotency_level'].enum_type = _METHODOPTIONS_IDEMPOTENCYLEVEL
+  _METHODOPTIONS.fields_by_name['features'].message_type = _FEATURESET
+  _METHODOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+  _METHODOPTIONS_IDEMPOTENCYLEVEL.containing_type = _METHODOPTIONS
+  _UNINTERPRETEDOPTION_NAMEPART.containing_type = _UNINTERPRETEDOPTION
+  _UNINTERPRETEDOPTION.fields_by_name['name'].message_type = _UNINTERPRETEDOPTION_NAMEPART
+  _FEATURESET.fields_by_name['field_presence'].enum_type = _FEATURESET_FIELDPRESENCE
+  _FEATURESET.fields_by_name['enum_type'].enum_type = _FEATURESET_ENUMTYPE
+  _FEATURESET.fields_by_name['repeated_field_encoding'].enum_type = _FEATURESET_REPEATEDFIELDENCODING
+  _FEATURESET.fields_by_name['utf8_validation'].enum_type = _FEATURESET_UTF8VALIDATION
+  _FEATURESET.fields_by_name['message_encoding'].enum_type = _FEATURESET_MESSAGEENCODING
+  _FEATURESET.fields_by_name['json_format'].enum_type = _FEATURESET_JSONFORMAT
+  _FEATURESET_FIELDPRESENCE.containing_type = _FEATURESET
+  _FEATURESET_ENUMTYPE.containing_type = _FEATURESET
+  _FEATURESET_REPEATEDFIELDENCODING.containing_type = _FEATURESET
+  _FEATURESET_UTF8VALIDATION.containing_type = _FEATURESET
+  _FEATURESET_MESSAGEENCODING.containing_type = _FEATURESET
+  _FEATURESET_JSONFORMAT.containing_type = _FEATURESET
+  _FEATURESETDEFAULTS_FEATURESETEDITIONDEFAULT.fields_by_name['edition'].enum_type = _EDITION
+  _FEATURESETDEFAULTS_FEATURESETEDITIONDEFAULT.fields_by_name['features'].message_type = _FEATURESET
+  _FEATURESETDEFAULTS_FEATURESETEDITIONDEFAULT.containing_type = _FEATURESETDEFAULTS
+  _FEATURESETDEFAULTS.fields_by_name['defaults'].message_type = _FEATURESETDEFAULTS_FEATURESETEDITIONDEFAULT
+  _FEATURESETDEFAULTS.fields_by_name['minimum_edition'].enum_type = _EDITION
+  _FEATURESETDEFAULTS.fields_by_name['maximum_edition'].enum_type = _EDITION
+  _SOURCECODEINFO_LOCATION.containing_type = _SOURCECODEINFO
+  _SOURCECODEINFO.fields_by_name['location'].message_type = _SOURCECODEINFO_LOCATION
+  _GENERATEDCODEINFO_ANNOTATION.fields_by_name['semantic'].enum_type = _GENERATEDCODEINFO_ANNOTATION_SEMANTIC
+  _GENERATEDCODEINFO_ANNOTATION.containing_type = _GENERATEDCODEINFO
+  _GENERATEDCODEINFO_ANNOTATION_SEMANTIC.containing_type = _GENERATEDCODEINFO_ANNOTATION
+  _GENERATEDCODEINFO.fields_by_name['annotation'].message_type = _GENERATEDCODEINFO_ANNOTATION
+  DESCRIPTOR.message_types_by_name['FileDescriptorSet'] = _FILEDESCRIPTORSET
+  DESCRIPTOR.message_types_by_name['FileDescriptorProto'] = _FILEDESCRIPTORPROTO
+  DESCRIPTOR.message_types_by_name['DescriptorProto'] = _DESCRIPTORPROTO
+  DESCRIPTOR.message_types_by_name['ExtensionRangeOptions'] = _EXTENSIONRANGEOPTIONS
+  DESCRIPTOR.message_types_by_name['FieldDescriptorProto'] = _FIELDDESCRIPTORPROTO
+  DESCRIPTOR.message_types_by_name['OneofDescriptorProto'] = _ONEOFDESCRIPTORPROTO
+  DESCRIPTOR.message_types_by_name['EnumDescriptorProto'] = _ENUMDESCRIPTORPROTO
+  DESCRIPTOR.message_types_by_name['EnumValueDescriptorProto'] = _ENUMVALUEDESCRIPTORPROTO
+  DESCRIPTOR.message_types_by_name['ServiceDescriptorProto'] = _SERVICEDESCRIPTORPROTO
+  DESCRIPTOR.message_types_by_name['MethodDescriptorProto'] = _METHODDESCRIPTORPROTO
+  DESCRIPTOR.message_types_by_name['FileOptions'] = _FILEOPTIONS
+  DESCRIPTOR.message_types_by_name['MessageOptions'] = _MESSAGEOPTIONS
+  DESCRIPTOR.message_types_by_name['FieldOptions'] = _FIELDOPTIONS
+  DESCRIPTOR.message_types_by_name['OneofOptions'] = _ONEOFOPTIONS
+  DESCRIPTOR.message_types_by_name['EnumOptions'] = _ENUMOPTIONS
+  DESCRIPTOR.message_types_by_name['EnumValueOptions'] = _ENUMVALUEOPTIONS
+  DESCRIPTOR.message_types_by_name['ServiceOptions'] = _SERVICEOPTIONS
+  DESCRIPTOR.message_types_by_name['MethodOptions'] = _METHODOPTIONS
+  DESCRIPTOR.message_types_by_name['UninterpretedOption'] = _UNINTERPRETEDOPTION
+  DESCRIPTOR.message_types_by_name['FeatureSet'] = _FEATURESET
+  DESCRIPTOR.message_types_by_name['FeatureSetDefaults'] = _FEATURESETDEFAULTS
+  DESCRIPTOR.message_types_by_name['SourceCodeInfo'] = _SOURCECODEINFO
+  DESCRIPTOR.message_types_by_name['GeneratedCodeInfo'] = _GENERATEDCODEINFO
+  DESCRIPTOR.enum_types_by_name['Edition'] = _EDITION
+  _sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+else:
+  _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'google.protobuf.descriptor_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\023com.google.protobufB\020DescriptorProtosH\001Z-google.golang.org/protobuf/types/descriptorpb\370\001\001\242\002\003GPB\252\002\032Google.Protobuf.Reflection'
+  _globals['_EXTENSIONRANGEOPTIONS'].fields_by_name['declaration']._options = None
+  _globals['_EXTENSIONRANGEOPTIONS'].fields_by_name['declaration']._serialized_options = b'\210\001\002'
+  _globals['_FILEOPTIONS'].fields_by_name['java_generate_equals_and_hash']._options = None
+  _globals['_FILEOPTIONS'].fields_by_name['java_generate_equals_and_hash']._serialized_options = b'\030\001'
+  _globals['_MESSAGEOPTIONS'].fields_by_name['deprecated_legacy_json_field_conflicts']._options = None
+  _globals['_MESSAGEOPTIONS'].fields_by_name['deprecated_legacy_json_field_conflicts']._serialized_options = b'\030\001'
+  _globals['_ENUMOPTIONS'].fields_by_name['deprecated_legacy_json_field_conflicts']._options = None
+  _globals['_ENUMOPTIONS'].fields_by_name['deprecated_legacy_json_field_conflicts']._serialized_options = b'\030\001'
+  _globals['_FEATURESET'].fields_by_name['field_presence']._options = None
+  _globals['_FEATURESET'].fields_by_name['field_presence']._serialized_options = b'\210\001\001\230\001\004\230\001\001\242\001\r\022\010EXPLICIT\030\346\007\242\001\r\022\010IMPLICIT\030\347\007\242\001\r\022\010EXPLICIT\030\350\007'
+  _globals['_FEATURESET'].fields_by_name['enum_type']._options = None
+  _globals['_FEATURESET'].fields_by_name['enum_type']._serialized_options = b'\210\001\001\230\001\006\230\001\001\242\001\013\022\006CLOSED\030\346\007\242\001\t\022\004OPEN\030\347\007'
+  _globals['_FEATURESET'].fields_by_name['repeated_field_encoding']._options = None
+  _globals['_FEATURESET'].fields_by_name['repeated_field_encoding']._serialized_options = b'\210\001\001\230\001\004\230\001\001\242\001\r\022\010EXPANDED\030\346\007\242\001\013\022\006PACKED\030\347\007'
+  _globals['_FEATURESET'].fields_by_name['utf8_validation']._options = None
+  _globals['_FEATURESET'].fields_by_name['utf8_validation']._serialized_options = b'\210\001\001\230\001\004\230\001\001\242\001\t\022\004NONE\030\346\007\242\001\013\022\006VERIFY\030\347\007'
+  _globals['_FEATURESET'].fields_by_name['message_encoding']._options = None
+  _globals['_FEATURESET'].fields_by_name['message_encoding']._serialized_options = b'\210\001\001\230\001\004\230\001\001\242\001\024\022\017LENGTH_PREFIXED\030\346\007'
+  _globals['_FEATURESET'].fields_by_name['json_format']._options = None
+  _globals['_FEATURESET'].fields_by_name['json_format']._serialized_options = b'\210\001\001\230\001\003\230\001\006\230\001\001\242\001\027\022\022LEGACY_BEST_EFFORT\030\346\007\242\001\n\022\005ALLOW\030\347\007'
+  _globals['_SOURCECODEINFO_LOCATION'].fields_by_name['path']._options = None
+  _globals['_SOURCECODEINFO_LOCATION'].fields_by_name['path']._serialized_options = b'\020\001'
+  _globals['_SOURCECODEINFO_LOCATION'].fields_by_name['span']._options = None
+  _globals['_SOURCECODEINFO_LOCATION'].fields_by_name['span']._serialized_options = b'\020\001'
+  _globals['_GENERATEDCODEINFO_ANNOTATION'].fields_by_name['path']._options = None
+  _globals['_GENERATEDCODEINFO_ANNOTATION'].fields_by_name['path']._serialized_options = b'\020\001'
+  _globals['_EDITION']._serialized_start=11258
+  _globals['_EDITION']._serialized_end=11492
+  _globals['_FILEDESCRIPTORSET']._serialized_start=53
+  _globals['_FILEDESCRIPTORSET']._serialized_end=130
+  _globals['_FILEDESCRIPTORPROTO']._serialized_start=133
+  _globals['_FILEDESCRIPTORPROTO']._serialized_end=797
+  _globals['_DESCRIPTORPROTO']._serialized_start=800
+  _globals['_DESCRIPTORPROTO']._serialized_end=1625
+  _globals['_DESCRIPTORPROTO_EXTENSIONRANGE']._serialized_start=1446
+  _globals['_DESCRIPTORPROTO_EXTENSIONRANGE']._serialized_end=1568
+  _globals['_DESCRIPTORPROTO_RESERVEDRANGE']._serialized_start=1570
+  _globals['_DESCRIPTORPROTO_RESERVEDRANGE']._serialized_end=1625
+  _globals['_EXTENSIONRANGEOPTIONS']._serialized_start=1628
+  _globals['_EXTENSIONRANGEOPTIONS']._serialized_end=2211
+  _globals['_EXTENSIONRANGEOPTIONS_DECLARATION']._serialized_start=1998
+  _globals['_EXTENSIONRANGEOPTIONS_DECLARATION']._serialized_end=2146
+  _globals['_EXTENSIONRANGEOPTIONS_VERIFICATIONSTATE']._serialized_start=2148
+  _globals['_EXTENSIONRANGEOPTIONS_VERIFICATIONSTATE']._serialized_end=2200
+  _globals['_FIELDDESCRIPTORPROTO']._serialized_start=2214
+  _globals['_FIELDDESCRIPTORPROTO']._serialized_end=3047
+  _globals['_FIELDDESCRIPTORPROTO_TYPE']._serialized_start=2668
+  _globals['_FIELDDESCRIPTORPROTO_TYPE']._serialized_end=2978
+  _globals['_FIELDDESCRIPTORPROTO_LABEL']._serialized_start=2980
+  _globals['_FIELDDESCRIPTORPROTO_LABEL']._serialized_end=3047
+  _globals['_ONEOFDESCRIPTORPROTO']._serialized_start=3049
+  _globals['_ONEOFDESCRIPTORPROTO']._serialized_end=3148
+  _globals['_ENUMDESCRIPTORPROTO']._serialized_start=3151
+  _globals['_ENUMDESCRIPTORPROTO']._serialized_end=3506
+  _globals['_ENUMDESCRIPTORPROTO_ENUMRESERVEDRANGE']._serialized_start=3447
+  _globals['_ENUMDESCRIPTORPROTO_ENUMRESERVEDRANGE']._serialized_end=3506
+  _globals['_ENUMVALUEDESCRIPTORPROTO']._serialized_start=3509
+  _globals['_ENUMVALUEDESCRIPTORPROTO']._serialized_end=3640
+  _globals['_SERVICEDESCRIPTORPROTO']._serialized_start=3643
+  _globals['_SERVICEDESCRIPTORPROTO']._serialized_end=3810
+  _globals['_METHODDESCRIPTORPROTO']._serialized_start=3813
+  _globals['_METHODDESCRIPTORPROTO']._serialized_end=4078
+  _globals['_FILEOPTIONS']._serialized_start=4081
+  _globals['_FILEOPTIONS']._serialized_end=5307
+  _globals['_FILEOPTIONS_OPTIMIZEMODE']._serialized_start=5232
+  _globals['_FILEOPTIONS_OPTIMIZEMODE']._serialized_end=5290
+  _globals['_MESSAGEOPTIONS']._serialized_start=5310
+  _globals['_MESSAGEOPTIONS']._serialized_end=5810
+  _globals['_FIELDOPTIONS']._serialized_start=5813
+  _globals['_FIELDOPTIONS']._serialized_end=7138
+  _globals['_FIELDOPTIONS_EDITIONDEFAULT']._serialized_start=6563
+  _globals['_FIELDOPTIONS_EDITIONDEFAULT']._serialized_end=6653
+  _globals['_FIELDOPTIONS_CTYPE']._serialized_start=6655
+  _globals['_FIELDOPTIONS_CTYPE']._serialized_end=6702
+  _globals['_FIELDOPTIONS_JSTYPE']._serialized_start=6704
+  _globals['_FIELDOPTIONS_JSTYPE']._serialized_end=6757
+  _globals['_FIELDOPTIONS_OPTIONRETENTION']._serialized_start=6759
+  _globals['_FIELDOPTIONS_OPTIONRETENTION']._serialized_end=6844
+  _globals['_FIELDOPTIONS_OPTIONTARGETTYPE']._serialized_start=6847
+  _globals['_FIELDOPTIONS_OPTIONTARGETTYPE']._serialized_end=7115
+  _globals['_ONEOFOPTIONS']._serialized_start=7141
+  _globals['_ONEOFOPTIONS']._serialized_end=7313
+  _globals['_ENUMOPTIONS']._serialized_start=7316
+  _globals['_ENUMOPTIONS']._serialized_end=7653
+  _globals['_ENUMVALUEOPTIONS']._serialized_start=7656
+  _globals['_ENUMVALUEOPTIONS']._serialized_end=7913
+  _globals['_SERVICEOPTIONS']._serialized_start=7916
+  _globals['_SERVICEOPTIONS']._serialized_end=8129
+  _globals['_METHODOPTIONS']._serialized_start=8132
+  _globals['_METHODOPTIONS']._serialized_end=8541
+  _globals['_METHODOPTIONS_IDEMPOTENCYLEVEL']._serialized_start=8450
+  _globals['_METHODOPTIONS_IDEMPOTENCYLEVEL']._serialized_end=8530
+  _globals['_UNINTERPRETEDOPTION']._serialized_start=8544
+  _globals['_UNINTERPRETEDOPTION']._serialized_end=8954
+  _globals['_UNINTERPRETEDOPTION_NAMEPART']._serialized_start=8880
+  _globals['_UNINTERPRETEDOPTION_NAMEPART']._serialized_end=8954
+  _globals['_FEATURESET']._serialized_start=8957
+  _globals['_FEATURESET']._serialized_end=10233
+  _globals['_FEATURESET_FIELDPRESENCE']._serialized_start=9736
+  _globals['_FEATURESET_FIELDPRESENCE']._serialized_end=9828
+  _globals['_FEATURESET_ENUMTYPE']._serialized_start=9830
+  _globals['_FEATURESET_ENUMTYPE']._serialized_end=9885
+  _globals['_FEATURESET_REPEATEDFIELDENCODING']._serialized_start=9887
+  _globals['_FEATURESET_REPEATEDFIELDENCODING']._serialized_end=9973
+  _globals['_FEATURESET_UTF8VALIDATION']._serialized_start=9975
+  _globals['_FEATURESET_UTF8VALIDATION']._serialized_end=10042
+  _globals['_FEATURESET_MESSAGEENCODING']._serialized_start=10044
+  _globals['_FEATURESET_MESSAGEENCODING']._serialized_end=10127
+  _globals['_FEATURESET_JSONFORMAT']._serialized_start=10129
+  _globals['_FEATURESET_JSONFORMAT']._serialized_end=10201
+  _globals['_FEATURESETDEFAULTS']._serialized_start=10236
+  _globals['_FEATURESETDEFAULTS']._serialized_end=10618
+  _globals['_FEATURESETDEFAULTS_FEATURESETEDITIONDEFAULT']._serialized_start=10483
+  _globals['_FEATURESETDEFAULTS_FEATURESETEDITIONDEFAULT']._serialized_end=10618
+  _globals['_SOURCECODEINFO']._serialized_start=10621
+  _globals['_SOURCECODEINFO']._serialized_end=10916
+  _globals['_SOURCECODEINFO_LOCATION']._serialized_start=10710
+  _globals['_SOURCECODEINFO_LOCATION']._serialized_end=10916
+  _globals['_GENERATEDCODEINFO']._serialized_start=10919
+  _globals['_GENERATEDCODEINFO']._serialized_end=11255
+  _globals['_GENERATEDCODEINFO_ANNOTATION']._serialized_start=11020
+  _globals['_GENERATEDCODEINFO_ANNOTATION']._serialized_end=11255
+  _globals['_GENERATEDCODEINFO_ANNOTATION_SEMANTIC']._serialized_start=11215
+  _globals['_GENERATEDCODEINFO_ANNOTATION_SEMANTIC']._serialized_end=11255
+# @@protoc_insertion_point(module_scope)
diff --git a/llm/Lib/site-packages/google/protobuf/descriptor_pool.py b/llm/Lib/site-packages/google/protobuf/descriptor_pool.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2fe59fdcd4dcb3d84725c37f88c517faffc5d59
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/descriptor_pool.py
@@ -0,0 +1,1271 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Provides DescriptorPool to use as a container for proto2 descriptors.
+
+The DescriptorPool is used in conjection with a DescriptorDatabase to maintain
+a collection of protocol buffer descriptors for use when dynamically creating
+message types at runtime.
+
+For most applications protocol buffers should be used via modules generated by
+the protocol buffer compiler tool. This should only be used when the type of
+protocol buffers used in an application or library cannot be predetermined.
+
+Below is a straightforward example on how to use this class::
+
+  pool = DescriptorPool()
+  file_descriptor_protos = [ ... ]
+  for file_descriptor_proto in file_descriptor_protos:
+    pool.Add(file_descriptor_proto)
+  my_message_descriptor = pool.FindMessageTypeByName('some.package.MessageType')
+
+The message descriptor can be used in conjunction with the message_factory
+module in order to create a protocol buffer class that can be encoded and
+decoded.
+
+If you want to get a Python class for the specified proto, use the
+helper functions inside google.protobuf.message_factory
+directly instead of this class.
+"""
+
+__author__ = 'matthewtoia@google.com (Matt Toia)'
+
+import collections
+import warnings
+
+from google.protobuf import descriptor
+from google.protobuf import descriptor_database
+from google.protobuf import text_encoding
+from google.protobuf.internal import python_message
+
+_USE_C_DESCRIPTORS = descriptor._USE_C_DESCRIPTORS  # pylint: disable=protected-access
+
+
+def _Deprecated(func):
+  """Mark functions as deprecated."""
+
+  def NewFunc(*args, **kwargs):
+    warnings.warn(
+        'Call to deprecated function %s(). Note: Do add unlinked descriptors '
+        'to descriptor_pool is wrong. Please use Add() or AddSerializedFile() '
+        'instead. This function will be removed soon.' % func.__name__,
+        category=DeprecationWarning)
+    return func(*args, **kwargs)
+  NewFunc.__name__ = func.__name__
+  NewFunc.__doc__ = func.__doc__
+  NewFunc.__dict__.update(func.__dict__)
+  return NewFunc
+
+
+def _NormalizeFullyQualifiedName(name):
+  """Remove leading period from fully-qualified type name.
+
+  Due to b/13860351 in descriptor_database.py, types in the root namespace are
+  generated with a leading period. This function removes that prefix.
+
+  Args:
+    name (str): The fully-qualified symbol name.
+
+  Returns:
+    str: The normalized fully-qualified symbol name.
+  """
+  return name.lstrip('.')
+
+
+def _OptionsOrNone(descriptor_proto):
+  """Returns the value of the field `options`, or None if it is not set."""
+  if descriptor_proto.HasField('options'):
+    return descriptor_proto.options
+  else:
+    return None
+
+
+def _IsMessageSetExtension(field):
+  return (field.is_extension and
+          field.containing_type.has_options and
+          field.containing_type.GetOptions().message_set_wire_format and
+          field.type == descriptor.FieldDescriptor.TYPE_MESSAGE and
+          field.label == descriptor.FieldDescriptor.LABEL_OPTIONAL)
+
+
+class DescriptorPool(object):
+  """A collection of protobufs dynamically constructed by descriptor protos."""
+
+  if _USE_C_DESCRIPTORS:
+
+   def __new__(cls, descriptor_db=None):
+     # pylint: disable=protected-access
+     return descriptor._message.DescriptorPool(descriptor_db)
+
+  def __init__(
+      self, descriptor_db=None, use_deprecated_legacy_json_field_conflicts=False
+  ):
+    """Initializes a Pool of proto buffs.
+
+    The descriptor_db argument to the constructor is provided to allow
+    specialized file descriptor proto lookup code to be triggered on demand. An
+    example would be an implementation which will read and compile a file
+    specified in a call to FindFileByName() and not require the call to Add()
+    at all. Results from this database will be cached internally here as well.
+
+    Args:
+      descriptor_db: A secondary source of file descriptors.
+      use_deprecated_legacy_json_field_conflicts: Unused, for compatibility with
+        C++.
+    """
+
+    self._internal_db = descriptor_database.DescriptorDatabase()
+    self._descriptor_db = descriptor_db
+    self._descriptors = {}
+    self._enum_descriptors = {}
+    self._service_descriptors = {}
+    self._file_descriptors = {}
+    self._toplevel_extensions = {}
+    self._top_enum_values = {}
+    # We store extensions in two two-level mappings: The first key is the
+    # descriptor of the message being extended, the second key is the extension
+    # full name or its tag number.
+    self._extensions_by_name = collections.defaultdict(dict)
+    self._extensions_by_number = collections.defaultdict(dict)
+
+  def _CheckConflictRegister(self, desc, desc_name, file_name):
+    """Check if the descriptor name conflicts with another of the same name.
+
+    Args:
+      desc: Descriptor of a message, enum, service, extension or enum value.
+      desc_name (str): the full name of desc.
+      file_name (str): The file name of descriptor.
+    """
+    for register, descriptor_type in [
+        (self._descriptors, descriptor.Descriptor),
+        (self._enum_descriptors, descriptor.EnumDescriptor),
+        (self._service_descriptors, descriptor.ServiceDescriptor),
+        (self._toplevel_extensions, descriptor.FieldDescriptor),
+        (self._top_enum_values, descriptor.EnumValueDescriptor)]:
+      if desc_name in register:
+        old_desc = register[desc_name]
+        if isinstance(old_desc, descriptor.EnumValueDescriptor):
+          old_file = old_desc.type.file.name
+        else:
+          old_file = old_desc.file.name
+
+        if not isinstance(desc, descriptor_type) or (
+            old_file != file_name):
+          error_msg = ('Conflict register for file "' + file_name +
+                       '": ' + desc_name +
+                       ' is already defined in file "' +
+                       old_file + '". Please fix the conflict by adding '
+                       'package name on the proto file, or use different '
+                       'name for the duplication.')
+          if isinstance(desc, descriptor.EnumValueDescriptor):
+            error_msg += ('\nNote: enum values appear as '
+                          'siblings of the enum type instead of '
+                          'children of it.')
+
+          raise TypeError(error_msg)
+
+        return
+
+  def Add(self, file_desc_proto):
+    """Adds the FileDescriptorProto and its types to this pool.
+
+    Args:
+      file_desc_proto (FileDescriptorProto): The file descriptor to add.
+    """
+
+    self._internal_db.Add(file_desc_proto)
+
+  def AddSerializedFile(self, serialized_file_desc_proto):
+    """Adds the FileDescriptorProto and its types to this pool.
+
+    Args:
+      serialized_file_desc_proto (bytes): A bytes string, serialization of the
+        :class:`FileDescriptorProto` to add.
+
+    Returns:
+      FileDescriptor: Descriptor for the added file.
+    """
+
+    # pylint: disable=g-import-not-at-top
+    from google.protobuf import descriptor_pb2
+    file_desc_proto = descriptor_pb2.FileDescriptorProto.FromString(
+        serialized_file_desc_proto)
+    file_desc = self._ConvertFileProtoToFileDescriptor(file_desc_proto)
+    file_desc.serialized_pb = serialized_file_desc_proto
+    return file_desc
+
+  # Add Descriptor to descriptor pool is deprecated. Please use Add()
+  # or AddSerializedFile() to add a FileDescriptorProto instead.
+  @_Deprecated
+  def AddDescriptor(self, desc):
+    self._AddDescriptor(desc)
+
+  # Never call this method. It is for internal usage only.
+  def _AddDescriptor(self, desc):
+    """Adds a Descriptor to the pool, non-recursively.
+
+    If the Descriptor contains nested messages or enums, the caller must
+    explicitly register them. This method also registers the FileDescriptor
+    associated with the message.
+
+    Args:
+      desc: A Descriptor.
+    """
+    if not isinstance(desc, descriptor.Descriptor):
+      raise TypeError('Expected instance of descriptor.Descriptor.')
+
+    self._CheckConflictRegister(desc, desc.full_name, desc.file.name)
+
+    self._descriptors[desc.full_name] = desc
+    self._AddFileDescriptor(desc.file)
+
+  # Never call this method. It is for internal usage only.
+  def _AddEnumDescriptor(self, enum_desc):
+    """Adds an EnumDescriptor to the pool.
+
+    This method also registers the FileDescriptor associated with the enum.
+
+    Args:
+      enum_desc: An EnumDescriptor.
+    """
+
+    if not isinstance(enum_desc, descriptor.EnumDescriptor):
+      raise TypeError('Expected instance of descriptor.EnumDescriptor.')
+
+    file_name = enum_desc.file.name
+    self._CheckConflictRegister(enum_desc, enum_desc.full_name, file_name)
+    self._enum_descriptors[enum_desc.full_name] = enum_desc
+
+    # Top enum values need to be indexed.
+    # Count the number of dots to see whether the enum is toplevel or nested
+    # in a message. We cannot use enum_desc.containing_type at this stage.
+    if enum_desc.file.package:
+      top_level = (enum_desc.full_name.count('.')
+                   - enum_desc.file.package.count('.') == 1)
+    else:
+      top_level = enum_desc.full_name.count('.') == 0
+    if top_level:
+      file_name = enum_desc.file.name
+      package = enum_desc.file.package
+      for enum_value in enum_desc.values:
+        full_name = _NormalizeFullyQualifiedName(
+            '.'.join((package, enum_value.name)))
+        self._CheckConflictRegister(enum_value, full_name, file_name)
+        self._top_enum_values[full_name] = enum_value
+    self._AddFileDescriptor(enum_desc.file)
+
+  # Add ServiceDescriptor to descriptor pool is deprecated. Please use Add()
+  # or AddSerializedFile() to add a FileDescriptorProto instead.
+  @_Deprecated
+  def AddServiceDescriptor(self, service_desc):
+    self._AddServiceDescriptor(service_desc)
+
+  # Never call this method. It is for internal usage only.
+  def _AddServiceDescriptor(self, service_desc):
+    """Adds a ServiceDescriptor to the pool.
+
+    Args:
+      service_desc: A ServiceDescriptor.
+    """
+
+    if not isinstance(service_desc, descriptor.ServiceDescriptor):
+      raise TypeError('Expected instance of descriptor.ServiceDescriptor.')
+
+    self._CheckConflictRegister(service_desc, service_desc.full_name,
+                                service_desc.file.name)
+    self._service_descriptors[service_desc.full_name] = service_desc
+
+  # Add ExtensionDescriptor to descriptor pool is deprecated. Please use Add()
+  # or AddSerializedFile() to add a FileDescriptorProto instead.
+  @_Deprecated
+  def AddExtensionDescriptor(self, extension):
+    self._AddExtensionDescriptor(extension)
+
+  # Never call this method. It is for internal usage only.
+  def _AddExtensionDescriptor(self, extension):
+    """Adds a FieldDescriptor describing an extension to the pool.
+
+    Args:
+      extension: A FieldDescriptor.
+
+    Raises:
+      AssertionError: when another extension with the same number extends the
+        same message.
+      TypeError: when the specified extension is not a
+        descriptor.FieldDescriptor.
+    """
+    if not (isinstance(extension, descriptor.FieldDescriptor) and
+            extension.is_extension):
+      raise TypeError('Expected an extension descriptor.')
+
+    if extension.extension_scope is None:
+      self._CheckConflictRegister(
+          extension, extension.full_name, extension.file.name)
+      self._toplevel_extensions[extension.full_name] = extension
+
+    try:
+      existing_desc = self._extensions_by_number[
+          extension.containing_type][extension.number]
+    except KeyError:
+      pass
+    else:
+      if extension is not existing_desc:
+        raise AssertionError(
+            'Extensions "%s" and "%s" both try to extend message type "%s" '
+            'with field number %d.' %
+            (extension.full_name, existing_desc.full_name,
+             extension.containing_type.full_name, extension.number))
+
+    self._extensions_by_number[extension.containing_type][
+        extension.number] = extension
+    self._extensions_by_name[extension.containing_type][
+        extension.full_name] = extension
+
+    # Also register MessageSet extensions with the type name.
+    if _IsMessageSetExtension(extension):
+      self._extensions_by_name[extension.containing_type][
+          extension.message_type.full_name] = extension
+
+    if hasattr(extension.containing_type, '_concrete_class'):
+      python_message._AttachFieldHelpers(
+          extension.containing_type._concrete_class, extension)
+
+  @_Deprecated
+  def AddFileDescriptor(self, file_desc):
+    self._InternalAddFileDescriptor(file_desc)
+
+  # Never call this method. It is for internal usage only.
+  def _InternalAddFileDescriptor(self, file_desc):
+    """Adds a FileDescriptor to the pool, non-recursively.
+
+    If the FileDescriptor contains messages or enums, the caller must explicitly
+    register them.
+
+    Args:
+      file_desc: A FileDescriptor.
+    """
+
+    self._AddFileDescriptor(file_desc)
+
+  def _AddFileDescriptor(self, file_desc):
+    """Adds a FileDescriptor to the pool, non-recursively.
+
+    If the FileDescriptor contains messages or enums, the caller must explicitly
+    register them.
+
+    Args:
+      file_desc: A FileDescriptor.
+    """
+
+    if not isinstance(file_desc, descriptor.FileDescriptor):
+      raise TypeError('Expected instance of descriptor.FileDescriptor.')
+    self._file_descriptors[file_desc.name] = file_desc
+
+  def FindFileByName(self, file_name):
+    """Gets a FileDescriptor by file name.
+
+    Args:
+      file_name (str): The path to the file to get a descriptor for.
+
+    Returns:
+      FileDescriptor: The descriptor for the named file.
+
+    Raises:
+      KeyError: if the file cannot be found in the pool.
+    """
+
+    try:
+      return self._file_descriptors[file_name]
+    except KeyError:
+      pass
+
+    try:
+      file_proto = self._internal_db.FindFileByName(file_name)
+    except KeyError as error:
+      if self._descriptor_db:
+        file_proto = self._descriptor_db.FindFileByName(file_name)
+      else:
+        raise error
+    if not file_proto:
+      raise KeyError('Cannot find a file named %s' % file_name)
+    return self._ConvertFileProtoToFileDescriptor(file_proto)
+
+  def FindFileContainingSymbol(self, symbol):
+    """Gets the FileDescriptor for the file containing the specified symbol.
+
+    Args:
+      symbol (str): The name of the symbol to search for.
+
+    Returns:
+      FileDescriptor: Descriptor for the file that contains the specified
+      symbol.
+
+    Raises:
+      KeyError: if the file cannot be found in the pool.
+    """
+
+    symbol = _NormalizeFullyQualifiedName(symbol)
+    try:
+      return self._InternalFindFileContainingSymbol(symbol)
+    except KeyError:
+      pass
+
+    try:
+      # Try fallback database. Build and find again if possible.
+      self._FindFileContainingSymbolInDb(symbol)
+      return self._InternalFindFileContainingSymbol(symbol)
+    except KeyError:
+      raise KeyError('Cannot find a file containing %s' % symbol)
+
+  def _InternalFindFileContainingSymbol(self, symbol):
+    """Gets the already built FileDescriptor containing the specified symbol.
+
+    Args:
+      symbol (str): The name of the symbol to search for.
+
+    Returns:
+      FileDescriptor: Descriptor for the file that contains the specified
+      symbol.
+
+    Raises:
+      KeyError: if the file cannot be found in the pool.
+    """
+    try:
+      return self._descriptors[symbol].file
+    except KeyError:
+      pass
+
+    try:
+      return self._enum_descriptors[symbol].file
+    except KeyError:
+      pass
+
+    try:
+      return self._service_descriptors[symbol].file
+    except KeyError:
+      pass
+
+    try:
+      return self._top_enum_values[symbol].type.file
+    except KeyError:
+      pass
+
+    try:
+      return self._toplevel_extensions[symbol].file
+    except KeyError:
+      pass
+
+    # Try fields, enum values and nested extensions inside a message.
+    top_name, _, sub_name = symbol.rpartition('.')
+    try:
+      message = self.FindMessageTypeByName(top_name)
+      assert (sub_name in message.extensions_by_name or
+              sub_name in message.fields_by_name or
+              sub_name in message.enum_values_by_name)
+      return message.file
+    except (KeyError, AssertionError):
+      raise KeyError('Cannot find a file containing %s' % symbol)
+
+  def FindMessageTypeByName(self, full_name):
+    """Loads the named descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the descriptor to load.
+
+    Returns:
+      Descriptor: The descriptor for the named type.
+
+    Raises:
+      KeyError: if the message cannot be found in the pool.
+    """
+
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    if full_name not in self._descriptors:
+      self._FindFileContainingSymbolInDb(full_name)
+    return self._descriptors[full_name]
+
+  def FindEnumTypeByName(self, full_name):
+    """Loads the named enum descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the enum descriptor to load.
+
+    Returns:
+      EnumDescriptor: The enum descriptor for the named type.
+
+    Raises:
+      KeyError: if the enum cannot be found in the pool.
+    """
+
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    if full_name not in self._enum_descriptors:
+      self._FindFileContainingSymbolInDb(full_name)
+    return self._enum_descriptors[full_name]
+
+  def FindFieldByName(self, full_name):
+    """Loads the named field descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the field descriptor to load.
+
+    Returns:
+      FieldDescriptor: The field descriptor for the named field.
+
+    Raises:
+      KeyError: if the field cannot be found in the pool.
+    """
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    message_name, _, field_name = full_name.rpartition('.')
+    message_descriptor = self.FindMessageTypeByName(message_name)
+    return message_descriptor.fields_by_name[field_name]
+
+  def FindOneofByName(self, full_name):
+    """Loads the named oneof descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the oneof descriptor to load.
+
+    Returns:
+      OneofDescriptor: The oneof descriptor for the named oneof.
+
+    Raises:
+      KeyError: if the oneof cannot be found in the pool.
+    """
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    message_name, _, oneof_name = full_name.rpartition('.')
+    message_descriptor = self.FindMessageTypeByName(message_name)
+    return message_descriptor.oneofs_by_name[oneof_name]
+
+  def FindExtensionByName(self, full_name):
+    """Loads the named extension descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the extension descriptor to load.
+
+    Returns:
+      FieldDescriptor: The field descriptor for the named extension.
+
+    Raises:
+      KeyError: if the extension cannot be found in the pool.
+    """
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    try:
+      # The proto compiler does not give any link between the FileDescriptor
+      # and top-level extensions unless the FileDescriptorProto is added to
+      # the DescriptorDatabase, but this can impact memory usage.
+      # So we registered these extensions by name explicitly.
+      return self._toplevel_extensions[full_name]
+    except KeyError:
+      pass
+    message_name, _, extension_name = full_name.rpartition('.')
+    try:
+      # Most extensions are nested inside a message.
+      scope = self.FindMessageTypeByName(message_name)
+    except KeyError:
+      # Some extensions are defined at file scope.
+      scope = self._FindFileContainingSymbolInDb(full_name)
+    return scope.extensions_by_name[extension_name]
+
+  def FindExtensionByNumber(self, message_descriptor, number):
+    """Gets the extension of the specified message with the specified number.
+
+    Extensions have to be registered to this pool by calling :func:`Add` or
+    :func:`AddExtensionDescriptor`.
+
+    Args:
+      message_descriptor (Descriptor): descriptor of the extended message.
+      number (int): Number of the extension field.
+
+    Returns:
+      FieldDescriptor: The descriptor for the extension.
+
+    Raises:
+      KeyError: when no extension with the given number is known for the
+        specified message.
+    """
+    try:
+      return self._extensions_by_number[message_descriptor][number]
+    except KeyError:
+      self._TryLoadExtensionFromDB(message_descriptor, number)
+      return self._extensions_by_number[message_descriptor][number]
+
+  def FindAllExtensions(self, message_descriptor):
+    """Gets all the known extensions of a given message.
+
+    Extensions have to be registered to this pool by build related
+    :func:`Add` or :func:`AddExtensionDescriptor`.
+
+    Args:
+      message_descriptor (Descriptor): Descriptor of the extended message.
+
+    Returns:
+      list[FieldDescriptor]: Field descriptors describing the extensions.
+    """
+    # Fallback to descriptor db if FindAllExtensionNumbers is provided.
+    if self._descriptor_db and hasattr(
+        self._descriptor_db, 'FindAllExtensionNumbers'):
+      full_name = message_descriptor.full_name
+      all_numbers = self._descriptor_db.FindAllExtensionNumbers(full_name)
+      for number in all_numbers:
+        if number in self._extensions_by_number[message_descriptor]:
+          continue
+        self._TryLoadExtensionFromDB(message_descriptor, number)
+
+    return list(self._extensions_by_number[message_descriptor].values())
+
+  def _TryLoadExtensionFromDB(self, message_descriptor, number):
+    """Try to Load extensions from descriptor db.
+
+    Args:
+      message_descriptor: descriptor of the extended message.
+      number: the extension number that needs to be loaded.
+    """
+    if not self._descriptor_db:
+      return
+    # Only supported when FindFileContainingExtension is provided.
+    if not hasattr(
+        self._descriptor_db, 'FindFileContainingExtension'):
+      return
+
+    full_name = message_descriptor.full_name
+    file_proto = self._descriptor_db.FindFileContainingExtension(
+        full_name, number)
+
+    if file_proto is None:
+      return
+
+    try:
+      self._ConvertFileProtoToFileDescriptor(file_proto)
+    except:
+      warn_msg = ('Unable to load proto file %s for extension number %d.' %
+                  (file_proto.name, number))
+      warnings.warn(warn_msg, RuntimeWarning)
+
+  def FindServiceByName(self, full_name):
+    """Loads the named service descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the service descriptor to load.
+
+    Returns:
+      ServiceDescriptor: The service descriptor for the named service.
+
+    Raises:
+      KeyError: if the service cannot be found in the pool.
+    """
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    if full_name not in self._service_descriptors:
+      self._FindFileContainingSymbolInDb(full_name)
+    return self._service_descriptors[full_name]
+
+  def FindMethodByName(self, full_name):
+    """Loads the named service method descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the method descriptor to load.
+
+    Returns:
+      MethodDescriptor: The method descriptor for the service method.
+
+    Raises:
+      KeyError: if the method cannot be found in the pool.
+    """
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    service_name, _, method_name = full_name.rpartition('.')
+    service_descriptor = self.FindServiceByName(service_name)
+    return service_descriptor.methods_by_name[method_name]
+
+  def _FindFileContainingSymbolInDb(self, symbol):
+    """Finds the file in descriptor DB containing the specified symbol.
+
+    Args:
+      symbol (str): The name of the symbol to search for.
+
+    Returns:
+      FileDescriptor: The file that contains the specified symbol.
+
+    Raises:
+      KeyError: if the file cannot be found in the descriptor database.
+    """
+    try:
+      file_proto = self._internal_db.FindFileContainingSymbol(symbol)
+    except KeyError as error:
+      if self._descriptor_db:
+        file_proto = self._descriptor_db.FindFileContainingSymbol(symbol)
+      else:
+        raise error
+    if not file_proto:
+      raise KeyError('Cannot find a file containing %s' % symbol)
+    return self._ConvertFileProtoToFileDescriptor(file_proto)
+
+  def _ConvertFileProtoToFileDescriptor(self, file_proto):
+    """Creates a FileDescriptor from a proto or returns a cached copy.
+
+    This method also has the side effect of loading all the symbols found in
+    the file into the appropriate dictionaries in the pool.
+
+    Args:
+      file_proto: The proto to convert.
+
+    Returns:
+      A FileDescriptor matching the passed in proto.
+    """
+    if file_proto.name not in self._file_descriptors:
+      built_deps = list(self._GetDeps(file_proto.dependency))
+      direct_deps = [self.FindFileByName(n) for n in file_proto.dependency]
+      public_deps = [direct_deps[i] for i in file_proto.public_dependency]
+
+      file_descriptor = descriptor.FileDescriptor(
+          pool=self,
+          name=file_proto.name,
+          package=file_proto.package,
+          syntax=file_proto.syntax,
+          options=_OptionsOrNone(file_proto),
+          serialized_pb=file_proto.SerializeToString(),
+          dependencies=direct_deps,
+          public_dependencies=public_deps,
+          # pylint: disable=protected-access
+          create_key=descriptor._internal_create_key)
+      scope = {}
+
+      # This loop extracts all the message and enum types from all the
+      # dependencies of the file_proto. This is necessary to create the
+      # scope of available message types when defining the passed in
+      # file proto.
+      for dependency in built_deps:
+        scope.update(self._ExtractSymbols(
+            dependency.message_types_by_name.values()))
+        scope.update((_PrefixWithDot(enum.full_name), enum)
+                     for enum in dependency.enum_types_by_name.values())
+
+      for message_type in file_proto.message_type:
+        message_desc = self._ConvertMessageDescriptor(
+            message_type, file_proto.package, file_descriptor, scope,
+            file_proto.syntax)
+        file_descriptor.message_types_by_name[message_desc.name] = (
+            message_desc)
+
+      for enum_type in file_proto.enum_type:
+        file_descriptor.enum_types_by_name[enum_type.name] = (
+            self._ConvertEnumDescriptor(enum_type, file_proto.package,
+                                        file_descriptor, None, scope, True))
+
+      for index, extension_proto in enumerate(file_proto.extension):
+        extension_desc = self._MakeFieldDescriptor(
+            extension_proto, file_proto.package, index, file_descriptor,
+            is_extension=True)
+        extension_desc.containing_type = self._GetTypeFromScope(
+            file_descriptor.package, extension_proto.extendee, scope)
+        self._SetFieldType(extension_proto, extension_desc,
+                           file_descriptor.package, scope)
+        file_descriptor.extensions_by_name[extension_desc.name] = (
+            extension_desc)
+
+      for desc_proto in file_proto.message_type:
+        self._SetAllFieldTypes(file_proto.package, desc_proto, scope)
+
+      if file_proto.package:
+        desc_proto_prefix = _PrefixWithDot(file_proto.package)
+      else:
+        desc_proto_prefix = ''
+
+      for desc_proto in file_proto.message_type:
+        desc = self._GetTypeFromScope(
+            desc_proto_prefix, desc_proto.name, scope)
+        file_descriptor.message_types_by_name[desc_proto.name] = desc
+
+      for index, service_proto in enumerate(file_proto.service):
+        file_descriptor.services_by_name[service_proto.name] = (
+            self._MakeServiceDescriptor(service_proto, index, scope,
+                                        file_proto.package, file_descriptor))
+
+      self._file_descriptors[file_proto.name] = file_descriptor
+
+    # Add extensions to the pool
+    def AddExtensionForNested(message_type):
+      for nested in message_type.nested_types:
+        AddExtensionForNested(nested)
+      for extension in message_type.extensions:
+        self._AddExtensionDescriptor(extension)
+
+    file_desc = self._file_descriptors[file_proto.name]
+    for extension in file_desc.extensions_by_name.values():
+      self._AddExtensionDescriptor(extension)
+    for message_type in file_desc.message_types_by_name.values():
+      AddExtensionForNested(message_type)
+
+    return file_desc
+
+  def _ConvertMessageDescriptor(self, desc_proto, package=None, file_desc=None,
+                                scope=None, syntax=None):
+    """Adds the proto to the pool in the specified package.
+
+    Args:
+      desc_proto: The descriptor_pb2.DescriptorProto protobuf message.
+      package: The package the proto should be located in.
+      file_desc: The file containing this message.
+      scope: Dict mapping short and full symbols to message and enum types.
+      syntax: string indicating syntax of the file ("proto2" or "proto3")
+
+    Returns:
+      The added descriptor.
+    """
+
+    if package:
+      desc_name = '.'.join((package, desc_proto.name))
+    else:
+      desc_name = desc_proto.name
+
+    if file_desc is None:
+      file_name = None
+    else:
+      file_name = file_desc.name
+
+    if scope is None:
+      scope = {}
+
+    nested = [
+        self._ConvertMessageDescriptor(
+            nested, desc_name, file_desc, scope, syntax)
+        for nested in desc_proto.nested_type]
+    enums = [
+        self._ConvertEnumDescriptor(enum, desc_name, file_desc, None,
+                                    scope, False)
+        for enum in desc_proto.enum_type]
+    fields = [self._MakeFieldDescriptor(field, desc_name, index, file_desc)
+              for index, field in enumerate(desc_proto.field)]
+    extensions = [
+        self._MakeFieldDescriptor(extension, desc_name, index, file_desc,
+                                  is_extension=True)
+        for index, extension in enumerate(desc_proto.extension)]
+    oneofs = [
+        # pylint: disable=g-complex-comprehension
+        descriptor.OneofDescriptor(
+            desc.name,
+            '.'.join((desc_name, desc.name)),
+            index,
+            None,
+            [],
+            _OptionsOrNone(desc),
+            # pylint: disable=protected-access
+            create_key=descriptor._internal_create_key)
+        for index, desc in enumerate(desc_proto.oneof_decl)
+    ]
+    extension_ranges = [(r.start, r.end) for r in desc_proto.extension_range]
+    if extension_ranges:
+      is_extendable = True
+    else:
+      is_extendable = False
+    desc = descriptor.Descriptor(
+        name=desc_proto.name,
+        full_name=desc_name,
+        filename=file_name,
+        containing_type=None,
+        fields=fields,
+        oneofs=oneofs,
+        nested_types=nested,
+        enum_types=enums,
+        extensions=extensions,
+        options=_OptionsOrNone(desc_proto),
+        is_extendable=is_extendable,
+        extension_ranges=extension_ranges,
+        file=file_desc,
+        serialized_start=None,
+        serialized_end=None,
+        syntax=syntax,
+        is_map_entry=desc_proto.options.map_entry,
+        # pylint: disable=protected-access
+        create_key=descriptor._internal_create_key)
+    for nested in desc.nested_types:
+      nested.containing_type = desc
+    for enum in desc.enum_types:
+      enum.containing_type = desc
+    for field_index, field_desc in enumerate(desc_proto.field):
+      if field_desc.HasField('oneof_index'):
+        oneof_index = field_desc.oneof_index
+        oneofs[oneof_index].fields.append(fields[field_index])
+        fields[field_index].containing_oneof = oneofs[oneof_index]
+
+    scope[_PrefixWithDot(desc_name)] = desc
+    self._CheckConflictRegister(desc, desc.full_name, desc.file.name)
+    self._descriptors[desc_name] = desc
+    return desc
+
+  def _ConvertEnumDescriptor(self, enum_proto, package=None, file_desc=None,
+                             containing_type=None, scope=None, top_level=False):
+    """Make a protobuf EnumDescriptor given an EnumDescriptorProto protobuf.
+
+    Args:
+      enum_proto: The descriptor_pb2.EnumDescriptorProto protobuf message.
+      package: Optional package name for the new message EnumDescriptor.
+      file_desc: The file containing the enum descriptor.
+      containing_type: The type containing this enum.
+      scope: Scope containing available types.
+      top_level: If True, the enum is a top level symbol. If False, the enum
+          is defined inside a message.
+
+    Returns:
+      The added descriptor
+    """
+
+    if package:
+      enum_name = '.'.join((package, enum_proto.name))
+    else:
+      enum_name = enum_proto.name
+
+    if file_desc is None:
+      file_name = None
+    else:
+      file_name = file_desc.name
+
+    values = [self._MakeEnumValueDescriptor(value, index)
+              for index, value in enumerate(enum_proto.value)]
+    desc = descriptor.EnumDescriptor(name=enum_proto.name,
+                                     full_name=enum_name,
+                                     filename=file_name,
+                                     file=file_desc,
+                                     values=values,
+                                     containing_type=containing_type,
+                                     options=_OptionsOrNone(enum_proto),
+                                     # pylint: disable=protected-access
+                                     create_key=descriptor._internal_create_key)
+    scope['.%s' % enum_name] = desc
+    self._CheckConflictRegister(desc, desc.full_name, desc.file.name)
+    self._enum_descriptors[enum_name] = desc
+
+    # Add top level enum values.
+    if top_level:
+      for value in values:
+        full_name = _NormalizeFullyQualifiedName(
+            '.'.join((package, value.name)))
+        self._CheckConflictRegister(value, full_name, file_name)
+        self._top_enum_values[full_name] = value
+
+    return desc
+
+  def _MakeFieldDescriptor(self, field_proto, message_name, index,
+                           file_desc, is_extension=False):
+    """Creates a field descriptor from a FieldDescriptorProto.
+
+    For message and enum type fields, this method will do a look up
+    in the pool for the appropriate descriptor for that type. If it
+    is unavailable, it will fall back to the _source function to
+    create it. If this type is still unavailable, construction will
+    fail.
+
+    Args:
+      field_proto: The proto describing the field.
+      message_name: The name of the containing message.
+      index: Index of the field
+      file_desc: The file containing the field descriptor.
+      is_extension: Indication that this field is for an extension.
+
+    Returns:
+      An initialized FieldDescriptor object
+    """
+
+    if message_name:
+      full_name = '.'.join((message_name, field_proto.name))
+    else:
+      full_name = field_proto.name
+
+    if field_proto.json_name:
+      json_name = field_proto.json_name
+    else:
+      json_name = None
+
+    return descriptor.FieldDescriptor(
+        name=field_proto.name,
+        full_name=full_name,
+        index=index,
+        number=field_proto.number,
+        type=field_proto.type,
+        cpp_type=None,
+        message_type=None,
+        enum_type=None,
+        containing_type=None,
+        label=field_proto.label,
+        has_default_value=False,
+        default_value=None,
+        is_extension=is_extension,
+        extension_scope=None,
+        options=_OptionsOrNone(field_proto),
+        json_name=json_name,
+        file=file_desc,
+        # pylint: disable=protected-access
+        create_key=descriptor._internal_create_key)
+
+  def _SetAllFieldTypes(self, package, desc_proto, scope):
+    """Sets all the descriptor's fields's types.
+
+    This method also sets the containing types on any extensions.
+
+    Args:
+      package: The current package of desc_proto.
+      desc_proto: The message descriptor to update.
+      scope: Enclosing scope of available types.
+    """
+
+    package = _PrefixWithDot(package)
+
+    main_desc = self._GetTypeFromScope(package, desc_proto.name, scope)
+
+    if package == '.':
+      nested_package = _PrefixWithDot(desc_proto.name)
+    else:
+      nested_package = '.'.join([package, desc_proto.name])
+
+    for field_proto, field_desc in zip(desc_proto.field, main_desc.fields):
+      self._SetFieldType(field_proto, field_desc, nested_package, scope)
+
+    for extension_proto, extension_desc in (
+        zip(desc_proto.extension, main_desc.extensions)):
+      extension_desc.containing_type = self._GetTypeFromScope(
+          nested_package, extension_proto.extendee, scope)
+      self._SetFieldType(extension_proto, extension_desc, nested_package, scope)
+
+    for nested_type in desc_proto.nested_type:
+      self._SetAllFieldTypes(nested_package, nested_type, scope)
+
+  def _SetFieldType(self, field_proto, field_desc, package, scope):
+    """Sets the field's type, cpp_type, message_type and enum_type.
+
+    Args:
+      field_proto: Data about the field in proto format.
+      field_desc: The descriptor to modify.
+      package: The package the field's container is in.
+      scope: Enclosing scope of available types.
+    """
+    if field_proto.type_name:
+      desc = self._GetTypeFromScope(package, field_proto.type_name, scope)
+    else:
+      desc = None
+
+    if not field_proto.HasField('type'):
+      if isinstance(desc, descriptor.Descriptor):
+        field_proto.type = descriptor.FieldDescriptor.TYPE_MESSAGE
+      else:
+        field_proto.type = descriptor.FieldDescriptor.TYPE_ENUM
+
+    field_desc.cpp_type = descriptor.FieldDescriptor.ProtoTypeToCppProtoType(
+        field_proto.type)
+
+    if (field_proto.type == descriptor.FieldDescriptor.TYPE_MESSAGE
+        or field_proto.type == descriptor.FieldDescriptor.TYPE_GROUP):
+      field_desc.message_type = desc
+
+    if field_proto.type == descriptor.FieldDescriptor.TYPE_ENUM:
+      field_desc.enum_type = desc
+
+    if field_proto.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+      field_desc.has_default_value = False
+      field_desc.default_value = []
+    elif field_proto.HasField('default_value'):
+      field_desc.has_default_value = True
+      if (field_proto.type == descriptor.FieldDescriptor.TYPE_DOUBLE or
+          field_proto.type == descriptor.FieldDescriptor.TYPE_FLOAT):
+        field_desc.default_value = float(field_proto.default_value)
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_STRING:
+        field_desc.default_value = field_proto.default_value
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_BOOL:
+        field_desc.default_value = field_proto.default_value.lower() == 'true'
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_ENUM:
+        field_desc.default_value = field_desc.enum_type.values_by_name[
+            field_proto.default_value].number
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_BYTES:
+        field_desc.default_value = text_encoding.CUnescape(
+            field_proto.default_value)
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_MESSAGE:
+        field_desc.default_value = None
+      else:
+        # All other types are of the "int" type.
+        field_desc.default_value = int(field_proto.default_value)
+    else:
+      field_desc.has_default_value = False
+      if (field_proto.type == descriptor.FieldDescriptor.TYPE_DOUBLE or
+          field_proto.type == descriptor.FieldDescriptor.TYPE_FLOAT):
+        field_desc.default_value = 0.0
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_STRING:
+        field_desc.default_value = u''
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_BOOL:
+        field_desc.default_value = False
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_ENUM:
+        field_desc.default_value = field_desc.enum_type.values[0].number
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_BYTES:
+        field_desc.default_value = b''
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_MESSAGE:
+        field_desc.default_value = None
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_GROUP:
+        field_desc.default_value = None
+      else:
+        # All other types are of the "int" type.
+        field_desc.default_value = 0
+
+    field_desc.type = field_proto.type
+
+  def _MakeEnumValueDescriptor(self, value_proto, index):
+    """Creates a enum value descriptor object from a enum value proto.
+
+    Args:
+      value_proto: The proto describing the enum value.
+      index: The index of the enum value.
+
+    Returns:
+      An initialized EnumValueDescriptor object.
+    """
+
+    return descriptor.EnumValueDescriptor(
+        name=value_proto.name,
+        index=index,
+        number=value_proto.number,
+        options=_OptionsOrNone(value_proto),
+        type=None,
+        # pylint: disable=protected-access
+        create_key=descriptor._internal_create_key)
+
+  def _MakeServiceDescriptor(self, service_proto, service_index, scope,
+                             package, file_desc):
+    """Make a protobuf ServiceDescriptor given a ServiceDescriptorProto.
+
+    Args:
+      service_proto: The descriptor_pb2.ServiceDescriptorProto protobuf message.
+      service_index: The index of the service in the File.
+      scope: Dict mapping short and full symbols to message and enum types.
+      package: Optional package name for the new message EnumDescriptor.
+      file_desc: The file containing the service descriptor.
+
+    Returns:
+      The added descriptor.
+    """
+
+    if package:
+      service_name = '.'.join((package, service_proto.name))
+    else:
+      service_name = service_proto.name
+
+    methods = [self._MakeMethodDescriptor(method_proto, service_name, package,
+                                          scope, index)
+               for index, method_proto in enumerate(service_proto.method)]
+    desc = descriptor.ServiceDescriptor(
+        name=service_proto.name,
+        full_name=service_name,
+        index=service_index,
+        methods=methods,
+        options=_OptionsOrNone(service_proto),
+        file=file_desc,
+        # pylint: disable=protected-access
+        create_key=descriptor._internal_create_key)
+    self._CheckConflictRegister(desc, desc.full_name, desc.file.name)
+    self._service_descriptors[service_name] = desc
+    return desc
+
+  def _MakeMethodDescriptor(self, method_proto, service_name, package, scope,
+                            index):
+    """Creates a method descriptor from a MethodDescriptorProto.
+
+    Args:
+      method_proto: The proto describing the method.
+      service_name: The name of the containing service.
+      package: Optional package name to look up for types.
+      scope: Scope containing available types.
+      index: Index of the method in the service.
+
+    Returns:
+      An initialized MethodDescriptor object.
+    """
+    full_name = '.'.join((service_name, method_proto.name))
+    input_type = self._GetTypeFromScope(
+        package, method_proto.input_type, scope)
+    output_type = self._GetTypeFromScope(
+        package, method_proto.output_type, scope)
+    return descriptor.MethodDescriptor(
+        name=method_proto.name,
+        full_name=full_name,
+        index=index,
+        containing_service=None,
+        input_type=input_type,
+        output_type=output_type,
+        client_streaming=method_proto.client_streaming,
+        server_streaming=method_proto.server_streaming,
+        options=_OptionsOrNone(method_proto),
+        # pylint: disable=protected-access
+        create_key=descriptor._internal_create_key)
+
+  def _ExtractSymbols(self, descriptors):
+    """Pulls out all the symbols from descriptor protos.
+
+    Args:
+      descriptors: The messages to extract descriptors from.
+    Yields:
+      A two element tuple of the type name and descriptor object.
+    """
+
+    for desc in descriptors:
+      yield (_PrefixWithDot(desc.full_name), desc)
+      for symbol in self._ExtractSymbols(desc.nested_types):
+        yield symbol
+      for enum in desc.enum_types:
+        yield (_PrefixWithDot(enum.full_name), enum)
+
+  def _GetDeps(self, dependencies, visited=None):
+    """Recursively finds dependencies for file protos.
+
+    Args:
+      dependencies: The names of the files being depended on.
+      visited: The names of files already found.
+
+    Yields:
+      Each direct and indirect dependency.
+    """
+
+    visited = visited or set()
+    for dependency in dependencies:
+      if dependency not in visited:
+        visited.add(dependency)
+        dep_desc = self.FindFileByName(dependency)
+        yield dep_desc
+        public_files = [d.name for d in dep_desc.public_dependencies]
+        yield from self._GetDeps(public_files, visited)
+
+  def _GetTypeFromScope(self, package, type_name, scope):
+    """Finds a given type name in the current scope.
+
+    Args:
+      package: The package the proto should be located in.
+      type_name: The name of the type to be found in the scope.
+      scope: Dict mapping short and full symbols to message and enum types.
+
+    Returns:
+      The descriptor for the requested type.
+    """
+    if type_name not in scope:
+      components = _PrefixWithDot(package).split('.')
+      while components:
+        possible_match = '.'.join(components + [type_name])
+        if possible_match in scope:
+          type_name = possible_match
+          break
+        else:
+          components.pop(-1)
+    return scope[type_name]
+
+
+def _PrefixWithDot(name):
+  return name if name.startswith('.') else '.%s' % name
+
+
+if _USE_C_DESCRIPTORS:
+  # TODO: This pool could be constructed from Python code, when we
+  # support a flag like 'use_cpp_generated_pool=True'.
+  # pylint: disable=protected-access
+  _DEFAULT = descriptor._message.default_pool
+else:
+  _DEFAULT = DescriptorPool()
+
+
+def Default():
+  return _DEFAULT
diff --git a/llm/Lib/site-packages/google/protobuf/duration_pb2.py b/llm/Lib/site-packages/google/protobuf/duration_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..d59457936b98c4a5ed7dad7d0e930e49e68a3425
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/duration_pb2.py
@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/duration.proto
+# Protobuf Python Version: 4.25.3
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1egoogle/protobuf/duration.proto\x12\x0fgoogle.protobuf\":\n\x08\x44uration\x12\x18\n\x07seconds\x18\x01 \x01(\x03R\x07seconds\x12\x14\n\x05nanos\x18\x02 \x01(\x05R\x05nanosB\x83\x01\n\x13\x63om.google.protobufB\rDurationProtoP\x01Z1google.golang.org/protobuf/types/known/durationpb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'google.protobuf.duration_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\023com.google.protobufB\rDurationProtoP\001Z1google.golang.org/protobuf/types/known/durationpb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes'
+  _globals['_DURATION']._serialized_start=51
+  _globals['_DURATION']._serialized_end=109
+# @@protoc_insertion_point(module_scope)
diff --git a/llm/Lib/site-packages/google/protobuf/empty_pb2.py b/llm/Lib/site-packages/google/protobuf/empty_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..0aecca35f4e59ecb063cb7fe580d3f230fe23572
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/empty_pb2.py
@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/empty.proto
+# Protobuf Python Version: 4.25.3
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1bgoogle/protobuf/empty.proto\x12\x0fgoogle.protobuf\"\x07\n\x05\x45mptyB}\n\x13\x63om.google.protobufB\nEmptyProtoP\x01Z.google.golang.org/protobuf/types/known/emptypb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'google.protobuf.empty_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\023com.google.protobufB\nEmptyProtoP\001Z.google.golang.org/protobuf/types/known/emptypb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes'
+  _globals['_EMPTY']._serialized_start=48
+  _globals['_EMPTY']._serialized_end=55
+# @@protoc_insertion_point(module_scope)
diff --git a/llm/Lib/site-packages/google/protobuf/field_mask_pb2.py b/llm/Lib/site-packages/google/protobuf/field_mask_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..46428496cc1f080abe0374766d16dc1a77b05802
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/field_mask_pb2.py
@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/field_mask.proto
+# Protobuf Python Version: 4.25.3
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n google/protobuf/field_mask.proto\x12\x0fgoogle.protobuf\"!\n\tFieldMask\x12\x14\n\x05paths\x18\x01 \x03(\tR\x05pathsB\x85\x01\n\x13\x63om.google.protobufB\x0e\x46ieldMaskProtoP\x01Z2google.golang.org/protobuf/types/known/fieldmaskpb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'google.protobuf.field_mask_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\023com.google.protobufB\016FieldMaskProtoP\001Z2google.golang.org/protobuf/types/known/fieldmaskpb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes'
+  _globals['_FIELDMASK']._serialized_start=53
+  _globals['_FIELDMASK']._serialized_end=86
+# @@protoc_insertion_point(module_scope)
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__init__.py b/llm/Lib/site-packages/google/protobuf/internal/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e676e288161e00ae5c266d080ca5018336849a7d
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/__init__.py
@@ -0,0 +1,7 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ac3865ad5f9b6a4477b3fa1b428437f477854f1e
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/_parameterized.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/_parameterized.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9a29b6f08fa0ce8f590cb3258bca26a4718dc552
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/_parameterized.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/api_implementation.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/api_implementation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..42b92824c3a83f3b0bd4a5ae79dac8ceac7e64ba
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/api_implementation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/builder.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/builder.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bb38a68a5e9d91bf1aa069cba84b096869289086
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/builder.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/containers.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/containers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6c83f6db4fe1e98648df8905d84d34eec2627c18
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/containers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/decoder.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/decoder.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2f3d0076b417fa9387b876324243d3a3046d8ba1
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/decoder.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/encoder.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/encoder.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..955e5953ff78f498f86f798c7334873a72853cad
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/encoder.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/enum_type_wrapper.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/enum_type_wrapper.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..762e0e9c672b61cc7ebbfcc97ac36d2d75d356b3
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/enum_type_wrapper.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/extension_dict.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/extension_dict.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7a8edc5ffccb0fbc49f69ac4b2eff51275aa3be9
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/extension_dict.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/field_mask.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/field_mask.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b68fe43678fdf5ec195c9ae9e1554d5b212652f
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/field_mask.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/message_listener.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/message_listener.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..18233113c64a5410230afad4b32e2d518b73adb1
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/message_listener.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/python_message.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/python_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..833104bb6e54cd225c2cb643deb9d5cf362a729e
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/python_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/testing_refleaks.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/testing_refleaks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..84d4e211ce0860d3fc905afb99e554bd3b7a5d88
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/testing_refleaks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/type_checkers.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/type_checkers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..15f221b678df3ed122abd8d0f990332a5a5d82b1
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/type_checkers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/well_known_types.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/well_known_types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5077f4f60e08cbeecfc14b961ac8a02507ab3c21
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/well_known_types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/__pycache__/wire_format.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/wire_format.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..86eb1b6d66ba38cb2563cd37e78474e04935c9a3
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/internal/__pycache__/wire_format.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/internal/_parameterized.py b/llm/Lib/site-packages/google/protobuf/internal/_parameterized.py
new file mode 100644
index 0000000000000000000000000000000000000000..4cb2cb1f7a4503c0ad935927d9fc62dc942411c2
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/_parameterized.py
@@ -0,0 +1,420 @@
+#! /usr/bin/env python
+#
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Adds support for parameterized tests to Python's unittest TestCase class.
+
+A parameterized test is a method in a test case that is invoked with different
+argument tuples.
+
+A simple example:
+
+  class AdditionExample(_parameterized.TestCase):
+    @_parameterized.parameters(
+       (1, 2, 3),
+       (4, 5, 9),
+       (1, 1, 3))
+    def testAddition(self, op1, op2, result):
+      self.assertEqual(result, op1 + op2)
+
+
+Each invocation is a separate test case and properly isolated just
+like a normal test method, with its own setUp/tearDown cycle. In the
+example above, there are three separate testcases, one of which will
+fail due to an assertion error (1 + 1 != 3).
+
+Parameters for individual test cases can be tuples (with positional parameters)
+or dictionaries (with named parameters):
+
+  class AdditionExample(_parameterized.TestCase):
+    @_parameterized.parameters(
+       {'op1': 1, 'op2': 2, 'result': 3},
+       {'op1': 4, 'op2': 5, 'result': 9},
+    )
+    def testAddition(self, op1, op2, result):
+      self.assertEqual(result, op1 + op2)
+
+If a parameterized test fails, the error message will show the
+original test name (which is modified internally) and the arguments
+for the specific invocation, which are part of the string returned by
+the shortDescription() method on test cases.
+
+The id method of the test, used internally by the unittest framework,
+is also modified to show the arguments. To make sure that test names
+stay the same across several invocations, object representations like
+
+  >>> class Foo(object):
+  ...  pass
+  >>> repr(Foo())
+  '<__main__.Foo object at 0x23d8610>'
+
+are turned into '<__main__.Foo>'. For even more descriptive names,
+especially in test logs, you can use the named_parameters decorator. In
+this case, only tuples are supported, and the first parameters has to
+be a string (or an object that returns an apt name when converted via
+str()):
+
+  class NamedExample(_parameterized.TestCase):
+    @_parameterized.named_parameters(
+       ('Normal', 'aa', 'aaa', True),
+       ('EmptyPrefix', '', 'abc', True),
+       ('BothEmpty', '', '', True))
+    def testStartsWith(self, prefix, string, result):
+      self.assertEqual(result, strings.startswith(prefix))
+
+Named tests also have the benefit that they can be run individually
+from the command line:
+
+  $ testmodule.py NamedExample.testStartsWithNormal
+  .
+  --------------------------------------------------------------------
+  Ran 1 test in 0.000s
+
+  OK
+
+Parameterized Classes
+=====================
+If invocation arguments are shared across test methods in a single
+TestCase class, instead of decorating all test methods
+individually, the class itself can be decorated:
+
+  @_parameterized.parameters(
+    (1, 2, 3)
+    (4, 5, 9))
+  class ArithmeticTest(_parameterized.TestCase):
+    def testAdd(self, arg1, arg2, result):
+      self.assertEqual(arg1 + arg2, result)
+
+    def testSubtract(self, arg2, arg2, result):
+      self.assertEqual(result - arg1, arg2)
+
+Inputs from Iterables
+=====================
+If parameters should be shared across several test cases, or are dynamically
+created from other sources, a single non-tuple iterable can be passed into
+the decorator. This iterable will be used to obtain the test cases:
+
+  class AdditionExample(_parameterized.TestCase):
+    @_parameterized.parameters(
+      c.op1, c.op2, c.result for c in testcases
+    )
+    def testAddition(self, op1, op2, result):
+      self.assertEqual(result, op1 + op2)
+
+
+Single-Argument Test Methods
+============================
+If a test method takes only one argument, the single argument does not need to
+be wrapped into a tuple:
+
+  class NegativeNumberExample(_parameterized.TestCase):
+    @_parameterized.parameters(
+       -1, -3, -4, -5
+    )
+    def testIsNegative(self, arg):
+      self.assertTrue(IsNegative(arg))
+"""
+
+__author__ = 'tmarek@google.com (Torsten Marek)'
+
+import functools
+import re
+import types
+import unittest
+import uuid
+
+try:
+  # Since python 3
+  import collections.abc as collections_abc
+except ImportError:
+  # Won't work after python 3.8
+  import collections as collections_abc
+
+ADDR_RE = re.compile(r'\<([a-zA-Z0-9_\-\.]+) object at 0x[a-fA-F0-9]+\>')
+_SEPARATOR = uuid.uuid1().hex
+_FIRST_ARG = object()
+_ARGUMENT_REPR = object()
+
+
+def _CleanRepr(obj):
+  return ADDR_RE.sub(r'<\1>', repr(obj))
+
+
+# Helper function formerly from the unittest module, removed from it in
+# Python 2.7.
+def _StrClass(cls):
+  return '%s.%s' % (cls.__module__, cls.__name__)
+
+
+def _NonStringIterable(obj):
+  return (isinstance(obj, collections_abc.Iterable) and
+          not isinstance(obj, str))
+
+
+def _FormatParameterList(testcase_params):
+  if isinstance(testcase_params, collections_abc.Mapping):
+    return ', '.join('%s=%s' % (argname, _CleanRepr(value))
+                     for argname, value in testcase_params.items())
+  elif _NonStringIterable(testcase_params):
+    return ', '.join(map(_CleanRepr, testcase_params))
+  else:
+    return _FormatParameterList((testcase_params,))
+
+
+class _ParameterizedTestIter(object):
+  """Callable and iterable class for producing new test cases."""
+
+  def __init__(self, test_method, testcases, naming_type):
+    """Returns concrete test functions for a test and a list of parameters.
+
+    The naming_type is used to determine the name of the concrete
+    functions as reported by the unittest framework. If naming_type is
+    _FIRST_ARG, the testcases must be tuples, and the first element must
+    have a string representation that is a valid Python identifier.
+
+    Args:
+      test_method: The decorated test method.
+      testcases: (list of tuple/dict) A list of parameter
+                 tuples/dicts for individual test invocations.
+      naming_type: The test naming type, either _NAMED or _ARGUMENT_REPR.
+    """
+    self._test_method = test_method
+    self.testcases = testcases
+    self._naming_type = naming_type
+
+  def __call__(self, *args, **kwargs):
+    raise RuntimeError('You appear to be running a parameterized test case '
+                       'without having inherited from parameterized.'
+                       'TestCase. This is bad because none of '
+                       'your test cases are actually being run.')
+
+  def __iter__(self):
+    test_method = self._test_method
+    naming_type = self._naming_type
+
+    def MakeBoundParamTest(testcase_params):
+      @functools.wraps(test_method)
+      def BoundParamTest(self):
+        if isinstance(testcase_params, collections_abc.Mapping):
+          test_method(self, **testcase_params)
+        elif _NonStringIterable(testcase_params):
+          test_method(self, *testcase_params)
+        else:
+          test_method(self, testcase_params)
+
+      if naming_type is _FIRST_ARG:
+        # Signal the metaclass that the name of the test function is unique
+        # and descriptive.
+        BoundParamTest.__x_use_name__ = True
+        BoundParamTest.__name__ += str(testcase_params[0])
+        testcase_params = testcase_params[1:]
+      elif naming_type is _ARGUMENT_REPR:
+        # __x_extra_id__ is used to pass naming information to the __new__
+        # method of TestGeneratorMetaclass.
+        # The metaclass will make sure to create a unique, but nondescriptive
+        # name for this test.
+        BoundParamTest.__x_extra_id__ = '(%s)' % (
+            _FormatParameterList(testcase_params),)
+      else:
+        raise RuntimeError('%s is not a valid naming type.' % (naming_type,))
+
+      BoundParamTest.__doc__ = '%s(%s)' % (
+          BoundParamTest.__name__, _FormatParameterList(testcase_params))
+      if test_method.__doc__:
+        BoundParamTest.__doc__ += '\n%s' % (test_method.__doc__,)
+      return BoundParamTest
+    return (MakeBoundParamTest(c) for c in self.testcases)
+
+
+def _IsSingletonList(testcases):
+  """True iff testcases contains only a single non-tuple element."""
+  return len(testcases) == 1 and not isinstance(testcases[0], tuple)
+
+
+def _ModifyClass(class_object, testcases, naming_type):
+  assert not getattr(class_object, '_id_suffix', None), (
+      'Cannot add parameters to %s,'
+      ' which already has parameterized methods.' % (class_object,))
+  class_object._id_suffix = id_suffix = {}
+  # We change the size of __dict__ while we iterate over it,
+  # which Python 3.x will complain about, so use copy().
+  for name, obj in class_object.__dict__.copy().items():
+    if (name.startswith(unittest.TestLoader.testMethodPrefix)
+        and isinstance(obj, types.FunctionType)):
+      delattr(class_object, name)
+      methods = {}
+      _UpdateClassDictForParamTestCase(
+          methods, id_suffix, name,
+          _ParameterizedTestIter(obj, testcases, naming_type))
+      for name, meth in methods.items():
+        setattr(class_object, name, meth)
+
+
+def _ParameterDecorator(naming_type, testcases):
+  """Implementation of the parameterization decorators.
+
+  Args:
+    naming_type: The naming type.
+    testcases: Testcase parameters.
+
+  Returns:
+    A function for modifying the decorated object.
+  """
+  def _Apply(obj):
+    if isinstance(obj, type):
+      _ModifyClass(
+          obj,
+          list(testcases) if not isinstance(testcases, collections_abc.Sequence)
+          else testcases,
+          naming_type)
+      return obj
+    else:
+      return _ParameterizedTestIter(obj, testcases, naming_type)
+
+  if _IsSingletonList(testcases):
+    assert _NonStringIterable(testcases[0]), (
+        'Single parameter argument must be a non-string iterable')
+    testcases = testcases[0]
+
+  return _Apply
+
+
+def parameters(*testcases):  # pylint: disable=invalid-name
+  """A decorator for creating parameterized tests.
+
+  See the module docstring for a usage example.
+  Args:
+    *testcases: Parameters for the decorated method, either a single
+                iterable, or a list of tuples/dicts/objects (for tests
+                with only one argument).
+
+  Returns:
+     A test generator to be handled by TestGeneratorMetaclass.
+  """
+  return _ParameterDecorator(_ARGUMENT_REPR, testcases)
+
+
+def named_parameters(*testcases):  # pylint: disable=invalid-name
+  """A decorator for creating parameterized tests.
+
+  See the module docstring for a usage example. The first element of
+  each parameter tuple should be a string and will be appended to the
+  name of the test method.
+
+  Args:
+    *testcases: Parameters for the decorated method, either a single
+                iterable, or a list of tuples.
+
+  Returns:
+     A test generator to be handled by TestGeneratorMetaclass.
+  """
+  return _ParameterDecorator(_FIRST_ARG, testcases)
+
+
+class TestGeneratorMetaclass(type):
+  """Metaclass for test cases with test generators.
+
+  A test generator is an iterable in a testcase that produces callables. These
+  callables must be single-argument methods. These methods are injected into
+  the class namespace and the original iterable is removed. If the name of the
+  iterable conforms to the test pattern, the injected methods will be picked
+  up as tests by the unittest framework.
+
+  In general, it is supposed to be used in conjunction with the
+  parameters decorator.
+  """
+
+  def __new__(mcs, class_name, bases, dct):
+    dct['_id_suffix'] = id_suffix = {}
+    for name, obj in dct.copy().items():
+      if (name.startswith(unittest.TestLoader.testMethodPrefix) and
+          _NonStringIterable(obj)):
+        iterator = iter(obj)
+        dct.pop(name)
+        _UpdateClassDictForParamTestCase(dct, id_suffix, name, iterator)
+
+    return type.__new__(mcs, class_name, bases, dct)
+
+
+def _UpdateClassDictForParamTestCase(dct, id_suffix, name, iterator):
+  """Adds individual test cases to a dictionary.
+
+  Args:
+    dct: The target dictionary.
+    id_suffix: The dictionary for mapping names to test IDs.
+    name: The original name of the test case.
+    iterator: The iterator generating the individual test cases.
+  """
+  for idx, func in enumerate(iterator):
+    assert callable(func), 'Test generators must yield callables, got %r' % (
+        func,)
+    if getattr(func, '__x_use_name__', False):
+      new_name = func.__name__
+    else:
+      new_name = '%s%s%d' % (name, _SEPARATOR, idx)
+    assert new_name not in dct, (
+        'Name of parameterized test case "%s" not unique' % (new_name,))
+    dct[new_name] = func
+    id_suffix[new_name] = getattr(func, '__x_extra_id__', '')
+
+
+class TestCase(unittest.TestCase, metaclass=TestGeneratorMetaclass):
+  """Base class for test cases using the parameters decorator."""
+
+  def _OriginalName(self):
+    return self._testMethodName.split(_SEPARATOR)[0]
+
+  def __str__(self):
+    return '%s (%s)' % (self._OriginalName(), _StrClass(self.__class__))
+
+  def id(self):  # pylint: disable=invalid-name
+    """Returns the descriptive ID of the test.
+
+    This is used internally by the unittesting framework to get a name
+    for the test to be used in reports.
+
+    Returns:
+      The test id.
+    """
+    return '%s.%s%s' % (_StrClass(self.__class__),
+                        self._OriginalName(),
+                        self._id_suffix.get(self._testMethodName, ''))
+
+
+def CoopTestCase(other_base_class):
+  """Returns a new base class with a cooperative metaclass base.
+
+  This enables the TestCase to be used in combination
+  with other base classes that have custom metaclasses, such as
+  mox.MoxTestBase.
+
+  Only works with metaclasses that do not override type.__new__.
+
+  Example:
+
+    import google3
+    import mox
+
+    from google.protobuf.internal import _parameterized
+
+    class ExampleTest(parameterized.CoopTestCase(mox.MoxTestBase)):
+      ...
+
+  Args:
+    other_base_class: (class) A test case base class.
+
+  Returns:
+    A new class object.
+  """
+  metaclass = type(
+      'CoopMetaclass',
+      (other_base_class.__metaclass__,
+       TestGeneratorMetaclass), {})
+  return metaclass(
+      'CoopTestCase',
+      (other_base_class, TestCase), {})
diff --git a/llm/Lib/site-packages/google/protobuf/internal/api_implementation.py b/llm/Lib/site-packages/google/protobuf/internal/api_implementation.py
new file mode 100644
index 0000000000000000000000000000000000000000..65caf63f8b5583fc4603d695a7e23275ce646031
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/api_implementation.py
@@ -0,0 +1,140 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Determine which implementation of the protobuf API is used in this process.
+"""
+
+import importlib
+import os
+import sys
+import warnings
+
+
+def _ApiVersionToImplementationType(api_version):
+  if api_version == 2:
+    return 'cpp'
+  if api_version == 1:
+    raise ValueError('api_version=1 is no longer supported.')
+  if api_version == 0:
+    return 'python'
+  return None
+
+
+_implementation_type = None
+try:
+  # pylint: disable=g-import-not-at-top
+  from google.protobuf.internal import _api_implementation
+  # The compile-time constants in the _api_implementation module can be used to
+  # switch to a certain implementation of the Python API at build time.
+  _implementation_type = _ApiVersionToImplementationType(
+      _api_implementation.api_version)
+except ImportError:
+  pass  # Unspecified by compiler flags.
+
+
+def _CanImport(mod_name):
+  try:
+    mod = importlib.import_module(mod_name)
+    # Work around a known issue in the classic bootstrap .par import hook.
+    if not mod:
+      raise ImportError(mod_name + ' import succeeded but was None')
+    return True
+  except ImportError:
+    return False
+
+
+if _implementation_type is None:
+  if _CanImport('google._upb._message'):
+    _implementation_type = 'upb'
+  elif _CanImport('google.protobuf.pyext._message'):
+    _implementation_type = 'cpp'
+  else:
+    _implementation_type = 'python'
+
+
+# This environment variable can be used to switch to a certain implementation
+# of the Python API, overriding the compile-time constants in the
+# _api_implementation module. Right now only 'python', 'cpp' and 'upb' are
+# valid values. Any other value will raise error.
+_implementation_type = os.getenv('PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION',
+                                 _implementation_type)
+
+if _implementation_type not in ('python', 'cpp', 'upb'):
+  raise ValueError('PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION {0} is not '
+                   'supported. Please set to \'python\', \'cpp\' or '
+                   '\'upb\'.'.format(_implementation_type))
+
+if 'PyPy' in sys.version and _implementation_type == 'cpp':
+  warnings.warn('PyPy does not work yet with cpp protocol buffers. '
+                'Falling back to the python implementation.')
+  _implementation_type = 'python'
+
+_c_module = None
+
+if _implementation_type == 'cpp':
+  try:
+    # pylint: disable=g-import-not-at-top
+    from google.protobuf.pyext import _message
+    sys.modules['google3.net.proto2.python.internal.cpp._message'] = _message
+    _c_module = _message
+    del _message
+  except ImportError:
+    # TODO: fail back to python
+    warnings.warn(
+        'Selected implementation cpp is not available.')
+    pass
+
+if _implementation_type == 'upb':
+  try:
+    # pylint: disable=g-import-not-at-top
+    from google._upb import _message
+    _c_module = _message
+    del _message
+  except ImportError:
+    warnings.warn('Selected implementation upb is not available. '
+                  'Falling back to the python implementation.')
+    _implementation_type = 'python'
+    pass
+
+# Detect if serialization should be deterministic by default
+try:
+  # The presence of this module in a build allows the proto implementation to
+  # be upgraded merely via build deps.
+  #
+  # NOTE: Merely importing this automatically enables deterministic proto
+  # serialization for C++ code, but we still need to export it as a boolean so
+  # that we can do the same for `_implementation_type == 'python'`.
+  #
+  # NOTE2: It is possible for C++ code to enable deterministic serialization by
+  # default _without_ affecting Python code, if the C++ implementation is not in
+  # use by this module.  That is intended behavior, so we don't actually expose
+  # this boolean outside of this module.
+  #
+  # pylint: disable=g-import-not-at-top,unused-import
+  from google.protobuf import enable_deterministic_proto_serialization
+  _python_deterministic_proto_serialization = True
+except ImportError:
+  _python_deterministic_proto_serialization = False
+
+
+# Usage of this function is discouraged. Clients shouldn't care which
+# implementation of the API is in use. Note that there is no guarantee
+# that differences between APIs will be maintained.
+# Please don't use this function if possible.
+def Type():
+  return _implementation_type
+
+
+# See comment on 'Type' above.
+# TODO: Remove the API, it returns a constant. b/228102101
+def Version():
+  return 2
+
+
+# For internal use only
+def IsPythonDefaultSerializationDeterministic():
+  return _python_deterministic_proto_serialization
diff --git a/llm/Lib/site-packages/google/protobuf/internal/builder.py b/llm/Lib/site-packages/google/protobuf/internal/builder.py
new file mode 100644
index 0000000000000000000000000000000000000000..c22d9947785fec18a7b4c8a9539121b2031fb0e5
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/builder.py
@@ -0,0 +1,118 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Builds descriptors, message classes and services for generated _pb2.py.
+
+This file is only called in python generated _pb2.py files. It builds
+descriptors, message classes and services that users can directly use
+in generated code.
+"""
+
+__author__ = 'jieluo@google.com (Jie Luo)'
+
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf.internal import python_message
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+_sym_db = _symbol_database.Default()
+
+
+def BuildMessageAndEnumDescriptors(file_des, module):
+  """Builds message and enum descriptors.
+
+  Args:
+    file_des: FileDescriptor of the .proto file
+    module: Generated _pb2 module
+  """
+
+  def BuildNestedDescriptors(msg_des, prefix):
+    for (name, nested_msg) in msg_des.nested_types_by_name.items():
+      module_name = prefix + name.upper()
+      module[module_name] = nested_msg
+      BuildNestedDescriptors(nested_msg, module_name + '_')
+    for enum_des in msg_des.enum_types:
+      module[prefix + enum_des.name.upper()] = enum_des
+
+  for (name, msg_des) in file_des.message_types_by_name.items():
+    module_name = '_' + name.upper()
+    module[module_name] = msg_des
+    BuildNestedDescriptors(msg_des, module_name + '_')
+
+
+def BuildTopDescriptorsAndMessages(file_des, module_name, module):
+  """Builds top level descriptors and message classes.
+
+  Args:
+    file_des: FileDescriptor of the .proto file
+    module_name: str, the name of generated _pb2 module
+    module: Generated _pb2 module
+  """
+
+  def BuildMessage(msg_des):
+    create_dict = {}
+    for (name, nested_msg) in msg_des.nested_types_by_name.items():
+      create_dict[name] = BuildMessage(nested_msg)
+    create_dict['DESCRIPTOR'] = msg_des
+    create_dict['__module__'] = module_name
+    message_class = _reflection.GeneratedProtocolMessageType(
+        msg_des.name, (_message.Message,), create_dict)
+    _sym_db.RegisterMessage(message_class)
+    return message_class
+
+  # top level enums
+  for (name, enum_des) in file_des.enum_types_by_name.items():
+    module['_' + name.upper()] = enum_des
+    module[name] = enum_type_wrapper.EnumTypeWrapper(enum_des)
+    for enum_value in enum_des.values:
+      module[enum_value.name] = enum_value.number
+
+  # top level extensions
+  for (name, extension_des) in file_des.extensions_by_name.items():
+    module[name.upper() + '_FIELD_NUMBER'] = extension_des.number
+    module[name] = extension_des
+
+  # services
+  for (name, service) in file_des.services_by_name.items():
+    module['_' + name.upper()] = service
+
+  # Build messages.
+  for (name, msg_des) in file_des.message_types_by_name.items():
+    module[name] = BuildMessage(msg_des)
+
+
+def AddHelpersToExtensions(file_des):
+  """no-op to keep old generated code work with new runtime.
+
+  Args:
+    file_des: FileDescriptor of the .proto file
+  """
+  # TODO: Remove this on-op
+  return
+
+
+def BuildServices(file_des, module_name, module):
+  """Builds services classes and services stub class.
+
+  Args:
+    file_des: FileDescriptor of the .proto file
+    module_name: str, the name of generated _pb2 module
+    module: Generated _pb2 module
+  """
+  # pylint: disable=g-import-not-at-top
+  from google.protobuf import service as _service
+  from google.protobuf import service_reflection
+  # pylint: enable=g-import-not-at-top
+  for (name, service) in file_des.services_by_name.items():
+    module[name] = service_reflection.GeneratedServiceType(
+        name, (_service.Service,),
+        dict(DESCRIPTOR=service, __module__=module_name))
+    stub_name = name + '_Stub'
+    module[stub_name] = service_reflection.GeneratedServiceStubType(
+        stub_name, (module[name],),
+        dict(DESCRIPTOR=service, __module__=module_name))
diff --git a/llm/Lib/site-packages/google/protobuf/internal/containers.py b/llm/Lib/site-packages/google/protobuf/internal/containers.py
new file mode 100644
index 0000000000000000000000000000000000000000..20c6d982fbaa97423f35dcc3a0260860359fc599
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/containers.py
@@ -0,0 +1,687 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Contains container classes to represent different protocol buffer types.
+
+This file defines container classes which represent categories of protocol
+buffer field types which need extra maintenance. Currently these categories
+are:
+
+-   Repeated scalar fields - These are all repeated fields which aren't
+    composite (e.g. they are of simple types like int32, string, etc).
+-   Repeated composite fields - Repeated fields which are composite. This
+    includes groups and nested messages.
+"""
+
+import collections.abc
+import copy
+import pickle
+from typing import (
+    Any,
+    Iterable,
+    Iterator,
+    List,
+    MutableMapping,
+    MutableSequence,
+    NoReturn,
+    Optional,
+    Sequence,
+    TypeVar,
+    Union,
+    overload,
+)
+
+
+_T = TypeVar('_T')
+_K = TypeVar('_K')
+_V = TypeVar('_V')
+
+
+class BaseContainer(Sequence[_T]):
+  """Base container class."""
+
+  # Minimizes memory usage and disallows assignment to other attributes.
+  __slots__ = ['_message_listener', '_values']
+
+  def __init__(self, message_listener: Any) -> None:
+    """
+    Args:
+      message_listener: A MessageListener implementation.
+        The RepeatedScalarFieldContainer will call this object's
+        Modified() method when it is modified.
+    """
+    self._message_listener = message_listener
+    self._values = []
+
+  @overload
+  def __getitem__(self, key: int) -> _T:
+    ...
+
+  @overload
+  def __getitem__(self, key: slice) -> List[_T]:
+    ...
+
+  def __getitem__(self, key):
+    """Retrieves item by the specified key."""
+    return self._values[key]
+
+  def __len__(self) -> int:
+    """Returns the number of elements in the container."""
+    return len(self._values)
+
+  def __ne__(self, other: Any) -> bool:
+    """Checks if another instance isn't equal to this one."""
+    # The concrete classes should define __eq__.
+    return not self == other
+
+  __hash__ = None
+
+  def __repr__(self) -> str:
+    return repr(self._values)
+
+  def sort(self, *args, **kwargs) -> None:
+    # Continue to support the old sort_function keyword argument.
+    # This is expected to be a rare occurrence, so use LBYL to avoid
+    # the overhead of actually catching KeyError.
+    if 'sort_function' in kwargs:
+      kwargs['cmp'] = kwargs.pop('sort_function')
+    self._values.sort(*args, **kwargs)
+
+  def reverse(self) -> None:
+    self._values.reverse()
+
+
+# TODO: Remove this. BaseContainer does *not* conform to
+# MutableSequence, only its subclasses do.
+collections.abc.MutableSequence.register(BaseContainer)
+
+
+class RepeatedScalarFieldContainer(BaseContainer[_T], MutableSequence[_T]):
+  """Simple, type-checked, list-like container for holding repeated scalars."""
+
+  # Disallows assignment to other attributes.
+  __slots__ = ['_type_checker']
+
+  def __init__(
+      self,
+      message_listener: Any,
+      type_checker: Any,
+  ) -> None:
+    """Args:
+
+      message_listener: A MessageListener implementation. The
+      RepeatedScalarFieldContainer will call this object's Modified() method
+      when it is modified.
+      type_checker: A type_checkers.ValueChecker instance to run on elements
+      inserted into this container.
+    """
+    super().__init__(message_listener)
+    self._type_checker = type_checker
+
+  def append(self, value: _T) -> None:
+    """Appends an item to the list. Similar to list.append()."""
+    self._values.append(self._type_checker.CheckValue(value))
+    if not self._message_listener.dirty:
+      self._message_listener.Modified()
+
+  def insert(self, key: int, value: _T) -> None:
+    """Inserts the item at the specified position. Similar to list.insert()."""
+    self._values.insert(key, self._type_checker.CheckValue(value))
+    if not self._message_listener.dirty:
+      self._message_listener.Modified()
+
+  def extend(self, elem_seq: Iterable[_T]) -> None:
+    """Extends by appending the given iterable. Similar to list.extend()."""
+# TODO: Change OSS to raise error too
+    if elem_seq is None:
+      return
+    try:
+      elem_seq_iter = iter(elem_seq)
+    except TypeError:
+      if not elem_seq:
+        warnings.warn('Value is not iterable. Please remove the wrong '
+                      'usage. This will be changed to raise TypeError soon.')
+        return
+      raise
+    new_values = [self._type_checker.CheckValue(elem) for elem in elem_seq_iter]
+    if new_values:
+      self._values.extend(new_values)
+    self._message_listener.Modified()
+
+  def MergeFrom(
+      self,
+      other: Union['RepeatedScalarFieldContainer[_T]', Iterable[_T]],
+  ) -> None:
+    """Appends the contents of another repeated field of the same type to this
+    one. We do not check the types of the individual fields.
+    """
+    self._values.extend(other)
+    self._message_listener.Modified()
+
+  def remove(self, elem: _T):
+    """Removes an item from the list. Similar to list.remove()."""
+    self._values.remove(elem)
+    self._message_listener.Modified()
+
+  def pop(self, key: Optional[int] = -1) -> _T:
+    """Removes and returns an item at a given index. Similar to list.pop()."""
+    value = self._values[key]
+    self.__delitem__(key)
+    return value
+
+  @overload
+  def __setitem__(self, key: int, value: _T) -> None:
+    ...
+
+  @overload
+  def __setitem__(self, key: slice, value: Iterable[_T]) -> None:
+    ...
+
+  def __setitem__(self, key, value) -> None:
+    """Sets the item on the specified position."""
+    if isinstance(key, slice):
+      if key.step is not None:
+        raise ValueError('Extended slices not supported')
+      self._values[key] = map(self._type_checker.CheckValue, value)
+      self._message_listener.Modified()
+    else:
+      self._values[key] = self._type_checker.CheckValue(value)
+      self._message_listener.Modified()
+
+  def __delitem__(self, key: Union[int, slice]) -> None:
+    """Deletes the item at the specified position."""
+    del self._values[key]
+    self._message_listener.Modified()
+
+  def __eq__(self, other: Any) -> bool:
+    """Compares the current instance with another one."""
+    if self is other:
+      return True
+    # Special case for the same type which should be common and fast.
+    if isinstance(other, self.__class__):
+      return other._values == self._values
+    # We are presumably comparing against some other sequence type.
+    return other == self._values
+
+  def __deepcopy__(
+      self,
+      unused_memo: Any = None,
+  ) -> 'RepeatedScalarFieldContainer[_T]':
+    clone = RepeatedScalarFieldContainer(
+        copy.deepcopy(self._message_listener), self._type_checker)
+    clone.MergeFrom(self)
+    return clone
+
+  def __reduce__(self, **kwargs) -> NoReturn:
+    raise pickle.PickleError(
+        "Can't pickle repeated scalar fields, convert to list first")
+
+
+# TODO: Constrain T to be a subtype of Message.
+class RepeatedCompositeFieldContainer(BaseContainer[_T], MutableSequence[_T]):
+  """Simple, list-like container for holding repeated composite fields."""
+
+  # Disallows assignment to other attributes.
+  __slots__ = ['_message_descriptor']
+
+  def __init__(self, message_listener: Any, message_descriptor: Any) -> None:
+    """
+    Note that we pass in a descriptor instead of the generated directly,
+    since at the time we construct a _RepeatedCompositeFieldContainer we
+    haven't yet necessarily initialized the type that will be contained in the
+    container.
+
+    Args:
+      message_listener: A MessageListener implementation.
+        The RepeatedCompositeFieldContainer will call this object's
+        Modified() method when it is modified.
+      message_descriptor: A Descriptor instance describing the protocol type
+        that should be present in this container.  We'll use the
+        _concrete_class field of this descriptor when the client calls add().
+    """
+    super().__init__(message_listener)
+    self._message_descriptor = message_descriptor
+
+  def add(self, **kwargs: Any) -> _T:
+    """Adds a new element at the end of the list and returns it. Keyword
+    arguments may be used to initialize the element.
+    """
+    new_element = self._message_descriptor._concrete_class(**kwargs)
+    new_element._SetListener(self._message_listener)
+    self._values.append(new_element)
+    if not self._message_listener.dirty:
+      self._message_listener.Modified()
+    return new_element
+
+  def append(self, value: _T) -> None:
+    """Appends one element by copying the message."""
+    new_element = self._message_descriptor._concrete_class()
+    new_element._SetListener(self._message_listener)
+    new_element.CopyFrom(value)
+    self._values.append(new_element)
+    if not self._message_listener.dirty:
+      self._message_listener.Modified()
+
+  def insert(self, key: int, value: _T) -> None:
+    """Inserts the item at the specified position by copying."""
+    new_element = self._message_descriptor._concrete_class()
+    new_element._SetListener(self._message_listener)
+    new_element.CopyFrom(value)
+    self._values.insert(key, new_element)
+    if not self._message_listener.dirty:
+      self._message_listener.Modified()
+
+  def extend(self, elem_seq: Iterable[_T]) -> None:
+    """Extends by appending the given sequence of elements of the same type
+
+    as this one, copying each individual message.
+    """
+    message_class = self._message_descriptor._concrete_class
+    listener = self._message_listener
+    values = self._values
+    for message in elem_seq:
+      new_element = message_class()
+      new_element._SetListener(listener)
+      new_element.MergeFrom(message)
+      values.append(new_element)
+    listener.Modified()
+
+  def MergeFrom(
+      self,
+      other: Union['RepeatedCompositeFieldContainer[_T]', Iterable[_T]],
+  ) -> None:
+    """Appends the contents of another repeated field of the same type to this
+    one, copying each individual message.
+    """
+    self.extend(other)
+
+  def remove(self, elem: _T) -> None:
+    """Removes an item from the list. Similar to list.remove()."""
+    self._values.remove(elem)
+    self._message_listener.Modified()
+
+  def pop(self, key: Optional[int] = -1) -> _T:
+    """Removes and returns an item at a given index. Similar to list.pop()."""
+    value = self._values[key]
+    self.__delitem__(key)
+    return value
+
+  @overload
+  def __setitem__(self, key: int, value: _T) -> None:
+    ...
+
+  @overload
+  def __setitem__(self, key: slice, value: Iterable[_T]) -> None:
+    ...
+
+  def __setitem__(self, key, value):
+    # This method is implemented to make RepeatedCompositeFieldContainer
+    # structurally compatible with typing.MutableSequence. It is
+    # otherwise unsupported and will always raise an error.
+    raise TypeError(
+        f'{self.__class__.__name__} object does not support item assignment')
+
+  def __delitem__(self, key: Union[int, slice]) -> None:
+    """Deletes the item at the specified position."""
+    del self._values[key]
+    self._message_listener.Modified()
+
+  def __eq__(self, other: Any) -> bool:
+    """Compares the current instance with another one."""
+    if self is other:
+      return True
+    if not isinstance(other, self.__class__):
+      raise TypeError('Can only compare repeated composite fields against '
+                      'other repeated composite fields.')
+    return self._values == other._values
+
+
+class ScalarMap(MutableMapping[_K, _V]):
+  """Simple, type-checked, dict-like container for holding repeated scalars."""
+
+  # Disallows assignment to other attributes.
+  __slots__ = ['_key_checker', '_value_checker', '_values', '_message_listener',
+               '_entry_descriptor']
+
+  def __init__(
+      self,
+      message_listener: Any,
+      key_checker: Any,
+      value_checker: Any,
+      entry_descriptor: Any,
+  ) -> None:
+    """
+    Args:
+      message_listener: A MessageListener implementation.
+        The ScalarMap will call this object's Modified() method when it
+        is modified.
+      key_checker: A type_checkers.ValueChecker instance to run on keys
+        inserted into this container.
+      value_checker: A type_checkers.ValueChecker instance to run on values
+        inserted into this container.
+      entry_descriptor: The MessageDescriptor of a map entry: key and value.
+    """
+    self._message_listener = message_listener
+    self._key_checker = key_checker
+    self._value_checker = value_checker
+    self._entry_descriptor = entry_descriptor
+    self._values = {}
+
+  def __getitem__(self, key: _K) -> _V:
+    try:
+      return self._values[key]
+    except KeyError:
+      key = self._key_checker.CheckValue(key)
+      val = self._value_checker.DefaultValue()
+      self._values[key] = val
+      return val
+
+  def __contains__(self, item: _K) -> bool:
+    # We check the key's type to match the strong-typing flavor of the API.
+    # Also this makes it easier to match the behavior of the C++ implementation.
+    self._key_checker.CheckValue(item)
+    return item in self._values
+
+  @overload
+  def get(self, key: _K) -> Optional[_V]:
+    ...
+
+  @overload
+  def get(self, key: _K, default: _T) -> Union[_V, _T]:
+    ...
+
+  # We need to override this explicitly, because our defaultdict-like behavior
+  # will make the default implementation (from our base class) always insert
+  # the key.
+  def get(self, key, default=None):
+    if key in self:
+      return self[key]
+    else:
+      return default
+
+  def __setitem__(self, key: _K, value: _V) -> _T:
+    checked_key = self._key_checker.CheckValue(key)
+    checked_value = self._value_checker.CheckValue(value)
+    self._values[checked_key] = checked_value
+    self._message_listener.Modified()
+
+  def __delitem__(self, key: _K) -> None:
+    del self._values[key]
+    self._message_listener.Modified()
+
+  def __len__(self) -> int:
+    return len(self._values)
+
+  def __iter__(self) -> Iterator[_K]:
+    return iter(self._values)
+
+  def __repr__(self) -> str:
+    return repr(self._values)
+
+  def MergeFrom(self, other: 'ScalarMap[_K, _V]') -> None:
+    self._values.update(other._values)
+    self._message_listener.Modified()
+
+  def InvalidateIterators(self) -> None:
+    # It appears that the only way to reliably invalidate iterators to
+    # self._values is to ensure that its size changes.
+    original = self._values
+    self._values = original.copy()
+    original[None] = None
+
+  # This is defined in the abstract base, but we can do it much more cheaply.
+  def clear(self) -> None:
+    self._values.clear()
+    self._message_listener.Modified()
+
+  def GetEntryClass(self) -> Any:
+    return self._entry_descriptor._concrete_class
+
+
+class MessageMap(MutableMapping[_K, _V]):
+  """Simple, type-checked, dict-like container for with submessage values."""
+
+  # Disallows assignment to other attributes.
+  __slots__ = ['_key_checker', '_values', '_message_listener',
+               '_message_descriptor', '_entry_descriptor']
+
+  def __init__(
+      self,
+      message_listener: Any,
+      message_descriptor: Any,
+      key_checker: Any,
+      entry_descriptor: Any,
+  ) -> None:
+    """
+    Args:
+      message_listener: A MessageListener implementation.
+        The ScalarMap will call this object's Modified() method when it
+        is modified.
+      key_checker: A type_checkers.ValueChecker instance to run on keys
+        inserted into this container.
+      value_checker: A type_checkers.ValueChecker instance to run on values
+        inserted into this container.
+      entry_descriptor: The MessageDescriptor of a map entry: key and value.
+    """
+    self._message_listener = message_listener
+    self._message_descriptor = message_descriptor
+    self._key_checker = key_checker
+    self._entry_descriptor = entry_descriptor
+    self._values = {}
+
+  def __getitem__(self, key: _K) -> _V:
+    key = self._key_checker.CheckValue(key)
+    try:
+      return self._values[key]
+    except KeyError:
+      new_element = self._message_descriptor._concrete_class()
+      new_element._SetListener(self._message_listener)
+      self._values[key] = new_element
+      self._message_listener.Modified()
+      return new_element
+
+  def get_or_create(self, key: _K) -> _V:
+    """get_or_create() is an alias for getitem (ie. map[key]).
+
+    Args:
+      key: The key to get or create in the map.
+
+    This is useful in cases where you want to be explicit that the call is
+    mutating the map.  This can avoid lint errors for statements like this
+    that otherwise would appear to be pointless statements:
+
+      msg.my_map[key]
+    """
+    return self[key]
+
+  @overload
+  def get(self, key: _K) -> Optional[_V]:
+    ...
+
+  @overload
+  def get(self, key: _K, default: _T) -> Union[_V, _T]:
+    ...
+
+  # We need to override this explicitly, because our defaultdict-like behavior
+  # will make the default implementation (from our base class) always insert
+  # the key.
+  def get(self, key, default=None):
+    if key in self:
+      return self[key]
+    else:
+      return default
+
+  def __contains__(self, item: _K) -> bool:
+    item = self._key_checker.CheckValue(item)
+    return item in self._values
+
+  def __setitem__(self, key: _K, value: _V) -> NoReturn:
+    raise ValueError('May not set values directly, call my_map[key].foo = 5')
+
+  def __delitem__(self, key: _K) -> None:
+    key = self._key_checker.CheckValue(key)
+    del self._values[key]
+    self._message_listener.Modified()
+
+  def __len__(self) -> int:
+    return len(self._values)
+
+  def __iter__(self) -> Iterator[_K]:
+    return iter(self._values)
+
+  def __repr__(self) -> str:
+    return repr(self._values)
+
+  def MergeFrom(self, other: 'MessageMap[_K, _V]') -> None:
+    # pylint: disable=protected-access
+    for key in other._values:
+      # According to documentation: "When parsing from the wire or when merging,
+      # if there are duplicate map keys the last key seen is used".
+      if key in self:
+        del self[key]
+      self[key].CopyFrom(other[key])
+    # self._message_listener.Modified() not required here, because
+    # mutations to submessages already propagate.
+
+  def InvalidateIterators(self) -> None:
+    # It appears that the only way to reliably invalidate iterators to
+    # self._values is to ensure that its size changes.
+    original = self._values
+    self._values = original.copy()
+    original[None] = None
+
+  # This is defined in the abstract base, but we can do it much more cheaply.
+  def clear(self) -> None:
+    self._values.clear()
+    self._message_listener.Modified()
+
+  def GetEntryClass(self) -> Any:
+    return self._entry_descriptor._concrete_class
+
+
+class _UnknownField:
+  """A parsed unknown field."""
+
+  # Disallows assignment to other attributes.
+  __slots__ = ['_field_number', '_wire_type', '_data']
+
+  def __init__(self, field_number, wire_type, data):
+    self._field_number = field_number
+    self._wire_type = wire_type
+    self._data = data
+    return
+
+  def __lt__(self, other):
+    # pylint: disable=protected-access
+    return self._field_number < other._field_number
+
+  def __eq__(self, other):
+    if self is other:
+      return True
+    # pylint: disable=protected-access
+    return (self._field_number == other._field_number and
+            self._wire_type == other._wire_type and
+            self._data == other._data)
+
+
+class UnknownFieldRef:  # pylint: disable=missing-class-docstring
+
+  def __init__(self, parent, index):
+    self._parent = parent
+    self._index = index
+
+  def _check_valid(self):
+    if not self._parent:
+      raise ValueError('UnknownField does not exist. '
+                       'The parent message might be cleared.')
+    if self._index >= len(self._parent):
+      raise ValueError('UnknownField does not exist. '
+                       'The parent message might be cleared.')
+
+  @property
+  def field_number(self):
+    self._check_valid()
+    # pylint: disable=protected-access
+    return self._parent._internal_get(self._index)._field_number
+
+  @property
+  def wire_type(self):
+    self._check_valid()
+    # pylint: disable=protected-access
+    return self._parent._internal_get(self._index)._wire_type
+
+  @property
+  def data(self):
+    self._check_valid()
+    # pylint: disable=protected-access
+    return self._parent._internal_get(self._index)._data
+
+
+class UnknownFieldSet:
+  """UnknownField container"""
+
+  # Disallows assignment to other attributes.
+  __slots__ = ['_values']
+
+  def __init__(self):
+    self._values = []
+
+  def __getitem__(self, index):
+    if self._values is None:
+      raise ValueError('UnknownFields does not exist. '
+                       'The parent message might be cleared.')
+    size = len(self._values)
+    if index < 0:
+      index += size
+    if index < 0 or index >= size:
+      raise IndexError('index %d out of range'.index)
+
+    return UnknownFieldRef(self, index)
+
+  def _internal_get(self, index):
+    return self._values[index]
+
+  def __len__(self):
+    if self._values is None:
+      raise ValueError('UnknownFields does not exist. '
+                       'The parent message might be cleared.')
+    return len(self._values)
+
+  def _add(self, field_number, wire_type, data):
+    unknown_field = _UnknownField(field_number, wire_type, data)
+    self._values.append(unknown_field)
+    return unknown_field
+
+  def __iter__(self):
+    for i in range(len(self)):
+      yield UnknownFieldRef(self, i)
+
+  def _extend(self, other):
+    if other is None:
+      return
+    # pylint: disable=protected-access
+    self._values.extend(other._values)
+
+  def __eq__(self, other):
+    if self is other:
+      return True
+    # Sort unknown fields because their order shouldn't
+    # affect equality test.
+    values = list(self._values)
+    if other is None:
+      return not values
+    values.sort()
+    # pylint: disable=protected-access
+    other_values = sorted(other._values)
+    return values == other_values
+
+  def _clear(self):
+    for value in self._values:
+      # pylint: disable=protected-access
+      if isinstance(value._data, UnknownFieldSet):
+        value._data._clear()  # pylint: disable=protected-access
+    self._values = None
diff --git a/llm/Lib/site-packages/google/protobuf/internal/decoder.py b/llm/Lib/site-packages/google/protobuf/internal/decoder.py
new file mode 100644
index 0000000000000000000000000000000000000000..acb91aa020ee93afecc26a50b119405114fc7a33
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/decoder.py
@@ -0,0 +1,1044 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Code for decoding protocol buffer primitives.
+
+This code is very similar to encoder.py -- read the docs for that module first.
+
+A "decoder" is a function with the signature:
+  Decode(buffer, pos, end, message, field_dict)
+The arguments are:
+  buffer:     The string containing the encoded message.
+  pos:        The current position in the string.
+  end:        The position in the string where the current message ends.  May be
+              less than len(buffer) if we're reading a sub-message.
+  message:    The message object into which we're parsing.
+  field_dict: message._fields (avoids a hashtable lookup).
+The decoder reads the field and stores it into field_dict, returning the new
+buffer position.  A decoder for a repeated field may proactively decode all of
+the elements of that field, if they appear consecutively.
+
+Note that decoders may throw any of the following:
+  IndexError:  Indicates a truncated message.
+  struct.error:  Unpacking of a fixed-width field failed.
+  message.DecodeError:  Other errors.
+
+Decoders are expected to raise an exception if they are called with pos > end.
+This allows callers to be lax about bounds checking:  it's fineto read past
+"end" as long as you are sure that someone else will notice and throw an
+exception later on.
+
+Something up the call stack is expected to catch IndexError and struct.error
+and convert them to message.DecodeError.
+
+Decoders are constructed using decoder constructors with the signature:
+  MakeDecoder(field_number, is_repeated, is_packed, key, new_default)
+The arguments are:
+  field_number:  The field number of the field we want to decode.
+  is_repeated:   Is the field a repeated field? (bool)
+  is_packed:     Is the field a packed field? (bool)
+  key:           The key to use when looking up the field within field_dict.
+                 (This is actually the FieldDescriptor but nothing in this
+                 file should depend on that.)
+  new_default:   A function which takes a message object as a parameter and
+                 returns a new instance of the default value for this field.
+                 (This is called for repeated fields and sub-messages, when an
+                 instance does not already exist.)
+
+As with encoders, we define a decoder constructor for every type of field.
+Then, for every field of every message class we construct an actual decoder.
+That decoder goes into a dict indexed by tag, so when we decode a message
+we repeatedly read a tag, look up the corresponding decoder, and invoke it.
+"""
+
+__author__ = 'kenton@google.com (Kenton Varda)'
+
+import math
+import struct
+
+from google.protobuf.internal import containers
+from google.protobuf.internal import encoder
+from google.protobuf.internal import wire_format
+from google.protobuf import message
+
+
+# This is not for optimization, but rather to avoid conflicts with local
+# variables named "message".
+_DecodeError = message.DecodeError
+
+
+def _VarintDecoder(mask, result_type):
+  """Return an encoder for a basic varint value (does not include tag).
+
+  Decoded values will be bitwise-anded with the given mask before being
+  returned, e.g. to limit them to 32 bits.  The returned decoder does not
+  take the usual "end" parameter -- the caller is expected to do bounds checking
+  after the fact (often the caller can defer such checking until later).  The
+  decoder returns a (value, new_pos) pair.
+  """
+
+  def DecodeVarint(buffer, pos):
+    result = 0
+    shift = 0
+    while 1:
+      b = buffer[pos]
+      result |= ((b & 0x7f) << shift)
+      pos += 1
+      if not (b & 0x80):
+        result &= mask
+        result = result_type(result)
+        return (result, pos)
+      shift += 7
+      if shift >= 64:
+        raise _DecodeError('Too many bytes when decoding varint.')
+  return DecodeVarint
+
+
+def _SignedVarintDecoder(bits, result_type):
+  """Like _VarintDecoder() but decodes signed values."""
+
+  signbit = 1 << (bits - 1)
+  mask = (1 << bits) - 1
+
+  def DecodeVarint(buffer, pos):
+    result = 0
+    shift = 0
+    while 1:
+      b = buffer[pos]
+      result |= ((b & 0x7f) << shift)
+      pos += 1
+      if not (b & 0x80):
+        result &= mask
+        result = (result ^ signbit) - signbit
+        result = result_type(result)
+        return (result, pos)
+      shift += 7
+      if shift >= 64:
+        raise _DecodeError('Too many bytes when decoding varint.')
+  return DecodeVarint
+
+# All 32-bit and 64-bit values are represented as int.
+_DecodeVarint = _VarintDecoder((1 << 64) - 1, int)
+_DecodeSignedVarint = _SignedVarintDecoder(64, int)
+
+# Use these versions for values which must be limited to 32 bits.
+_DecodeVarint32 = _VarintDecoder((1 << 32) - 1, int)
+_DecodeSignedVarint32 = _SignedVarintDecoder(32, int)
+
+
+def ReadTag(buffer, pos):
+  """Read a tag from the memoryview, and return a (tag_bytes, new_pos) tuple.
+
+  We return the raw bytes of the tag rather than decoding them.  The raw
+  bytes can then be used to look up the proper decoder.  This effectively allows
+  us to trade some work that would be done in pure-python (decoding a varint)
+  for work that is done in C (searching for a byte string in a hash table).
+  In a low-level language it would be much cheaper to decode the varint and
+  use that, but not in Python.
+
+  Args:
+    buffer: memoryview object of the encoded bytes
+    pos: int of the current position to start from
+
+  Returns:
+    Tuple[bytes, int] of the tag data and new position.
+  """
+  start = pos
+  while buffer[pos] & 0x80:
+    pos += 1
+  pos += 1
+
+  tag_bytes = buffer[start:pos].tobytes()
+  return tag_bytes, pos
+
+
+# --------------------------------------------------------------------
+
+
+def _SimpleDecoder(wire_type, decode_value):
+  """Return a constructor for a decoder for fields of a particular type.
+
+  Args:
+      wire_type:  The field's wire type.
+      decode_value:  A function which decodes an individual value, e.g.
+        _DecodeVarint()
+  """
+
+  def SpecificDecoder(field_number, is_repeated, is_packed, key, new_default,
+                      clear_if_default=False):
+    if is_packed:
+      local_DecodeVarint = _DecodeVarint
+      def DecodePackedField(buffer, pos, end, message, field_dict):
+        value = field_dict.get(key)
+        if value is None:
+          value = field_dict.setdefault(key, new_default(message))
+        (endpoint, pos) = local_DecodeVarint(buffer, pos)
+        endpoint += pos
+        if endpoint > end:
+          raise _DecodeError('Truncated message.')
+        while pos < endpoint:
+          (element, pos) = decode_value(buffer, pos)
+          value.append(element)
+        if pos > endpoint:
+          del value[-1]   # Discard corrupt value.
+          raise _DecodeError('Packed element was truncated.')
+        return pos
+      return DecodePackedField
+    elif is_repeated:
+      tag_bytes = encoder.TagBytes(field_number, wire_type)
+      tag_len = len(tag_bytes)
+      def DecodeRepeatedField(buffer, pos, end, message, field_dict):
+        value = field_dict.get(key)
+        if value is None:
+          value = field_dict.setdefault(key, new_default(message))
+        while 1:
+          (element, new_pos) = decode_value(buffer, pos)
+          value.append(element)
+          # Predict that the next tag is another copy of the same repeated
+          # field.
+          pos = new_pos + tag_len
+          if buffer[new_pos:pos] != tag_bytes or new_pos >= end:
+            # Prediction failed.  Return.
+            if new_pos > end:
+              raise _DecodeError('Truncated message.')
+            return new_pos
+      return DecodeRepeatedField
+    else:
+      def DecodeField(buffer, pos, end, message, field_dict):
+        (new_value, pos) = decode_value(buffer, pos)
+        if pos > end:
+          raise _DecodeError('Truncated message.')
+        if clear_if_default and not new_value:
+          field_dict.pop(key, None)
+        else:
+          field_dict[key] = new_value
+        return pos
+      return DecodeField
+
+  return SpecificDecoder
+
+
+def _ModifiedDecoder(wire_type, decode_value, modify_value):
+  """Like SimpleDecoder but additionally invokes modify_value on every value
+  before storing it.  Usually modify_value is ZigZagDecode.
+  """
+
+  # Reusing _SimpleDecoder is slightly slower than copying a bunch of code, but
+  # not enough to make a significant difference.
+
+  def InnerDecode(buffer, pos):
+    (result, new_pos) = decode_value(buffer, pos)
+    return (modify_value(result), new_pos)
+  return _SimpleDecoder(wire_type, InnerDecode)
+
+
+def _StructPackDecoder(wire_type, format):
+  """Return a constructor for a decoder for a fixed-width field.
+
+  Args:
+      wire_type:  The field's wire type.
+      format:  The format string to pass to struct.unpack().
+  """
+
+  value_size = struct.calcsize(format)
+  local_unpack = struct.unpack
+
+  # Reusing _SimpleDecoder is slightly slower than copying a bunch of code, but
+  # not enough to make a significant difference.
+
+  # Note that we expect someone up-stack to catch struct.error and convert
+  # it to _DecodeError -- this way we don't have to set up exception-
+  # handling blocks every time we parse one value.
+
+  def InnerDecode(buffer, pos):
+    new_pos = pos + value_size
+    result = local_unpack(format, buffer[pos:new_pos])[0]
+    return (result, new_pos)
+  return _SimpleDecoder(wire_type, InnerDecode)
+
+
+def _FloatDecoder():
+  """Returns a decoder for a float field.
+
+  This code works around a bug in struct.unpack for non-finite 32-bit
+  floating-point values.
+  """
+
+  local_unpack = struct.unpack
+
+  def InnerDecode(buffer, pos):
+    """Decode serialized float to a float and new position.
+
+    Args:
+      buffer: memoryview of the serialized bytes
+      pos: int, position in the memory view to start at.
+
+    Returns:
+      Tuple[float, int] of the deserialized float value and new position
+      in the serialized data.
+    """
+    # We expect a 32-bit value in little-endian byte order.  Bit 1 is the sign
+    # bit, bits 2-9 represent the exponent, and bits 10-32 are the significand.
+    new_pos = pos + 4
+    float_bytes = buffer[pos:new_pos].tobytes()
+
+    # If this value has all its exponent bits set, then it's non-finite.
+    # In Python 2.4, struct.unpack will convert it to a finite 64-bit value.
+    # To avoid that, we parse it specially.
+    if (float_bytes[3:4] in b'\x7F\xFF' and float_bytes[2:3] >= b'\x80'):
+      # If at least one significand bit is set...
+      if float_bytes[0:3] != b'\x00\x00\x80':
+        return (math.nan, new_pos)
+      # If sign bit is set...
+      if float_bytes[3:4] == b'\xFF':
+        return (-math.inf, new_pos)
+      return (math.inf, new_pos)
+
+    # Note that we expect someone up-stack to catch struct.error and convert
+    # it to _DecodeError -- this way we don't have to set up exception-
+    # handling blocks every time we parse one value.
+    result = local_unpack('<f', float_bytes)[0]
+    return (result, new_pos)
+  return _SimpleDecoder(wire_format.WIRETYPE_FIXED32, InnerDecode)
+
+
+def _DoubleDecoder():
+  """Returns a decoder for a double field.
+
+  This code works around a bug in struct.unpack for not-a-number.
+  """
+
+  local_unpack = struct.unpack
+
+  def InnerDecode(buffer, pos):
+    """Decode serialized double to a double and new position.
+
+    Args:
+      buffer: memoryview of the serialized bytes.
+      pos: int, position in the memory view to start at.
+
+    Returns:
+      Tuple[float, int] of the decoded double value and new position
+      in the serialized data.
+    """
+    # We expect a 64-bit value in little-endian byte order.  Bit 1 is the sign
+    # bit, bits 2-12 represent the exponent, and bits 13-64 are the significand.
+    new_pos = pos + 8
+    double_bytes = buffer[pos:new_pos].tobytes()
+
+    # If this value has all its exponent bits set and at least one significand
+    # bit set, it's not a number.  In Python 2.4, struct.unpack will treat it
+    # as inf or -inf.  To avoid that, we treat it specially.
+    if ((double_bytes[7:8] in b'\x7F\xFF')
+        and (double_bytes[6:7] >= b'\xF0')
+        and (double_bytes[0:7] != b'\x00\x00\x00\x00\x00\x00\xF0')):
+      return (math.nan, new_pos)
+
+    # Note that we expect someone up-stack to catch struct.error and convert
+    # it to _DecodeError -- this way we don't have to set up exception-
+    # handling blocks every time we parse one value.
+    result = local_unpack('<d', double_bytes)[0]
+    return (result, new_pos)
+  return _SimpleDecoder(wire_format.WIRETYPE_FIXED64, InnerDecode)
+
+
+def EnumDecoder(field_number, is_repeated, is_packed, key, new_default,
+                clear_if_default=False):
+  """Returns a decoder for enum field."""
+  enum_type = key.enum_type
+  if is_packed:
+    local_DecodeVarint = _DecodeVarint
+    def DecodePackedField(buffer, pos, end, message, field_dict):
+      """Decode serialized packed enum to its value and a new position.
+
+      Args:
+        buffer: memoryview of the serialized bytes.
+        pos: int, position in the memory view to start at.
+        end: int, end position of serialized data
+        message: Message object to store unknown fields in
+        field_dict: Map[Descriptor, Any] to store decoded values in.
+
+      Returns:
+        int, new position in serialized data.
+      """
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      (endpoint, pos) = local_DecodeVarint(buffer, pos)
+      endpoint += pos
+      if endpoint > end:
+        raise _DecodeError('Truncated message.')
+      while pos < endpoint:
+        value_start_pos = pos
+        (element, pos) = _DecodeSignedVarint32(buffer, pos)
+        # pylint: disable=protected-access
+        if element in enum_type.values_by_number:
+          value.append(element)
+        else:
+          if not message._unknown_fields:
+            message._unknown_fields = []
+          tag_bytes = encoder.TagBytes(field_number,
+                                       wire_format.WIRETYPE_VARINT)
+
+          message._unknown_fields.append(
+              (tag_bytes, buffer[value_start_pos:pos].tobytes()))
+          if message._unknown_field_set is None:
+            message._unknown_field_set = containers.UnknownFieldSet()
+          message._unknown_field_set._add(
+              field_number, wire_format.WIRETYPE_VARINT, element)
+          # pylint: enable=protected-access
+      if pos > endpoint:
+        if element in enum_type.values_by_number:
+          del value[-1]   # Discard corrupt value.
+        else:
+          del message._unknown_fields[-1]
+          # pylint: disable=protected-access
+          del message._unknown_field_set._values[-1]
+          # pylint: enable=protected-access
+        raise _DecodeError('Packed element was truncated.')
+      return pos
+    return DecodePackedField
+  elif is_repeated:
+    tag_bytes = encoder.TagBytes(field_number, wire_format.WIRETYPE_VARINT)
+    tag_len = len(tag_bytes)
+    def DecodeRepeatedField(buffer, pos, end, message, field_dict):
+      """Decode serialized repeated enum to its value and a new position.
+
+      Args:
+        buffer: memoryview of the serialized bytes.
+        pos: int, position in the memory view to start at.
+        end: int, end position of serialized data
+        message: Message object to store unknown fields in
+        field_dict: Map[Descriptor, Any] to store decoded values in.
+
+      Returns:
+        int, new position in serialized data.
+      """
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      while 1:
+        (element, new_pos) = _DecodeSignedVarint32(buffer, pos)
+        # pylint: disable=protected-access
+        if element in enum_type.values_by_number:
+          value.append(element)
+        else:
+          if not message._unknown_fields:
+            message._unknown_fields = []
+          message._unknown_fields.append(
+              (tag_bytes, buffer[pos:new_pos].tobytes()))
+          if message._unknown_field_set is None:
+            message._unknown_field_set = containers.UnknownFieldSet()
+          message._unknown_field_set._add(
+              field_number, wire_format.WIRETYPE_VARINT, element)
+        # pylint: enable=protected-access
+        # Predict that the next tag is another copy of the same repeated
+        # field.
+        pos = new_pos + tag_len
+        if buffer[new_pos:pos] != tag_bytes or new_pos >= end:
+          # Prediction failed.  Return.
+          if new_pos > end:
+            raise _DecodeError('Truncated message.')
+          return new_pos
+    return DecodeRepeatedField
+  else:
+    def DecodeField(buffer, pos, end, message, field_dict):
+      """Decode serialized repeated enum to its value and a new position.
+
+      Args:
+        buffer: memoryview of the serialized bytes.
+        pos: int, position in the memory view to start at.
+        end: int, end position of serialized data
+        message: Message object to store unknown fields in
+        field_dict: Map[Descriptor, Any] to store decoded values in.
+
+      Returns:
+        int, new position in serialized data.
+      """
+      value_start_pos = pos
+      (enum_value, pos) = _DecodeSignedVarint32(buffer, pos)
+      if pos > end:
+        raise _DecodeError('Truncated message.')
+      if clear_if_default and not enum_value:
+        field_dict.pop(key, None)
+        return pos
+      # pylint: disable=protected-access
+      if enum_value in enum_type.values_by_number:
+        field_dict[key] = enum_value
+      else:
+        if not message._unknown_fields:
+          message._unknown_fields = []
+        tag_bytes = encoder.TagBytes(field_number,
+                                     wire_format.WIRETYPE_VARINT)
+        message._unknown_fields.append(
+            (tag_bytes, buffer[value_start_pos:pos].tobytes()))
+        if message._unknown_field_set is None:
+          message._unknown_field_set = containers.UnknownFieldSet()
+        message._unknown_field_set._add(
+            field_number, wire_format.WIRETYPE_VARINT, enum_value)
+        # pylint: enable=protected-access
+      return pos
+    return DecodeField
+
+
+# --------------------------------------------------------------------
+
+
+Int32Decoder = _SimpleDecoder(
+    wire_format.WIRETYPE_VARINT, _DecodeSignedVarint32)
+
+Int64Decoder = _SimpleDecoder(
+    wire_format.WIRETYPE_VARINT, _DecodeSignedVarint)
+
+UInt32Decoder = _SimpleDecoder(wire_format.WIRETYPE_VARINT, _DecodeVarint32)
+UInt64Decoder = _SimpleDecoder(wire_format.WIRETYPE_VARINT, _DecodeVarint)
+
+SInt32Decoder = _ModifiedDecoder(
+    wire_format.WIRETYPE_VARINT, _DecodeVarint32, wire_format.ZigZagDecode)
+SInt64Decoder = _ModifiedDecoder(
+    wire_format.WIRETYPE_VARINT, _DecodeVarint, wire_format.ZigZagDecode)
+
+# Note that Python conveniently guarantees that when using the '<' prefix on
+# formats, they will also have the same size across all platforms (as opposed
+# to without the prefix, where their sizes depend on the C compiler's basic
+# type sizes).
+Fixed32Decoder  = _StructPackDecoder(wire_format.WIRETYPE_FIXED32, '<I')
+Fixed64Decoder  = _StructPackDecoder(wire_format.WIRETYPE_FIXED64, '<Q')
+SFixed32Decoder = _StructPackDecoder(wire_format.WIRETYPE_FIXED32, '<i')
+SFixed64Decoder = _StructPackDecoder(wire_format.WIRETYPE_FIXED64, '<q')
+FloatDecoder = _FloatDecoder()
+DoubleDecoder = _DoubleDecoder()
+
+BoolDecoder = _ModifiedDecoder(
+    wire_format.WIRETYPE_VARINT, _DecodeVarint, bool)
+
+
+def StringDecoder(field_number, is_repeated, is_packed, key, new_default,
+                  clear_if_default=False):
+  """Returns a decoder for a string field."""
+
+  local_DecodeVarint = _DecodeVarint
+
+  def _ConvertToUnicode(memview):
+    """Convert byte to unicode."""
+    byte_str = memview.tobytes()
+    try:
+      value = str(byte_str, 'utf-8')
+    except UnicodeDecodeError as e:
+      # add more information to the error message and re-raise it.
+      e.reason = '%s in field: %s' % (e, key.full_name)
+      raise
+
+    return value
+
+  assert not is_packed
+  if is_repeated:
+    tag_bytes = encoder.TagBytes(field_number,
+                                 wire_format.WIRETYPE_LENGTH_DELIMITED)
+    tag_len = len(tag_bytes)
+    def DecodeRepeatedField(buffer, pos, end, message, field_dict):
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      while 1:
+        (size, pos) = local_DecodeVarint(buffer, pos)
+        new_pos = pos + size
+        if new_pos > end:
+          raise _DecodeError('Truncated string.')
+        value.append(_ConvertToUnicode(buffer[pos:new_pos]))
+        # Predict that the next tag is another copy of the same repeated field.
+        pos = new_pos + tag_len
+        if buffer[new_pos:pos] != tag_bytes or new_pos == end:
+          # Prediction failed.  Return.
+          return new_pos
+    return DecodeRepeatedField
+  else:
+    def DecodeField(buffer, pos, end, message, field_dict):
+      (size, pos) = local_DecodeVarint(buffer, pos)
+      new_pos = pos + size
+      if new_pos > end:
+        raise _DecodeError('Truncated string.')
+      if clear_if_default and not size:
+        field_dict.pop(key, None)
+      else:
+        field_dict[key] = _ConvertToUnicode(buffer[pos:new_pos])
+      return new_pos
+    return DecodeField
+
+
+def BytesDecoder(field_number, is_repeated, is_packed, key, new_default,
+                 clear_if_default=False):
+  """Returns a decoder for a bytes field."""
+
+  local_DecodeVarint = _DecodeVarint
+
+  assert not is_packed
+  if is_repeated:
+    tag_bytes = encoder.TagBytes(field_number,
+                                 wire_format.WIRETYPE_LENGTH_DELIMITED)
+    tag_len = len(tag_bytes)
+    def DecodeRepeatedField(buffer, pos, end, message, field_dict):
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      while 1:
+        (size, pos) = local_DecodeVarint(buffer, pos)
+        new_pos = pos + size
+        if new_pos > end:
+          raise _DecodeError('Truncated string.')
+        value.append(buffer[pos:new_pos].tobytes())
+        # Predict that the next tag is another copy of the same repeated field.
+        pos = new_pos + tag_len
+        if buffer[new_pos:pos] != tag_bytes or new_pos == end:
+          # Prediction failed.  Return.
+          return new_pos
+    return DecodeRepeatedField
+  else:
+    def DecodeField(buffer, pos, end, message, field_dict):
+      (size, pos) = local_DecodeVarint(buffer, pos)
+      new_pos = pos + size
+      if new_pos > end:
+        raise _DecodeError('Truncated string.')
+      if clear_if_default and not size:
+        field_dict.pop(key, None)
+      else:
+        field_dict[key] = buffer[pos:new_pos].tobytes()
+      return new_pos
+    return DecodeField
+
+
+def GroupDecoder(field_number, is_repeated, is_packed, key, new_default):
+  """Returns a decoder for a group field."""
+
+  end_tag_bytes = encoder.TagBytes(field_number,
+                                   wire_format.WIRETYPE_END_GROUP)
+  end_tag_len = len(end_tag_bytes)
+
+  assert not is_packed
+  if is_repeated:
+    tag_bytes = encoder.TagBytes(field_number,
+                                 wire_format.WIRETYPE_START_GROUP)
+    tag_len = len(tag_bytes)
+    def DecodeRepeatedField(buffer, pos, end, message, field_dict):
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      while 1:
+        value = field_dict.get(key)
+        if value is None:
+          value = field_dict.setdefault(key, new_default(message))
+        # Read sub-message.
+        pos = value.add()._InternalParse(buffer, pos, end)
+        # Read end tag.
+        new_pos = pos+end_tag_len
+        if buffer[pos:new_pos] != end_tag_bytes or new_pos > end:
+          raise _DecodeError('Missing group end tag.')
+        # Predict that the next tag is another copy of the same repeated field.
+        pos = new_pos + tag_len
+        if buffer[new_pos:pos] != tag_bytes or new_pos == end:
+          # Prediction failed.  Return.
+          return new_pos
+    return DecodeRepeatedField
+  else:
+    def DecodeField(buffer, pos, end, message, field_dict):
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      # Read sub-message.
+      pos = value._InternalParse(buffer, pos, end)
+      # Read end tag.
+      new_pos = pos+end_tag_len
+      if buffer[pos:new_pos] != end_tag_bytes or new_pos > end:
+        raise _DecodeError('Missing group end tag.')
+      return new_pos
+    return DecodeField
+
+
+def MessageDecoder(field_number, is_repeated, is_packed, key, new_default):
+  """Returns a decoder for a message field."""
+
+  local_DecodeVarint = _DecodeVarint
+
+  assert not is_packed
+  if is_repeated:
+    tag_bytes = encoder.TagBytes(field_number,
+                                 wire_format.WIRETYPE_LENGTH_DELIMITED)
+    tag_len = len(tag_bytes)
+    def DecodeRepeatedField(buffer, pos, end, message, field_dict):
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      while 1:
+        # Read length.
+        (size, pos) = local_DecodeVarint(buffer, pos)
+        new_pos = pos + size
+        if new_pos > end:
+          raise _DecodeError('Truncated message.')
+        # Read sub-message.
+        if value.add()._InternalParse(buffer, pos, new_pos) != new_pos:
+          # The only reason _InternalParse would return early is if it
+          # encountered an end-group tag.
+          raise _DecodeError('Unexpected end-group tag.')
+        # Predict that the next tag is another copy of the same repeated field.
+        pos = new_pos + tag_len
+        if buffer[new_pos:pos] != tag_bytes or new_pos == end:
+          # Prediction failed.  Return.
+          return new_pos
+    return DecodeRepeatedField
+  else:
+    def DecodeField(buffer, pos, end, message, field_dict):
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      # Read length.
+      (size, pos) = local_DecodeVarint(buffer, pos)
+      new_pos = pos + size
+      if new_pos > end:
+        raise _DecodeError('Truncated message.')
+      # Read sub-message.
+      if value._InternalParse(buffer, pos, new_pos) != new_pos:
+        # The only reason _InternalParse would return early is if it encountered
+        # an end-group tag.
+        raise _DecodeError('Unexpected end-group tag.')
+      return new_pos
+    return DecodeField
+
+
+# --------------------------------------------------------------------
+
+MESSAGE_SET_ITEM_TAG = encoder.TagBytes(1, wire_format.WIRETYPE_START_GROUP)
+
+def MessageSetItemDecoder(descriptor):
+  """Returns a decoder for a MessageSet item.
+
+  The parameter is the message Descriptor.
+
+  The message set message looks like this:
+    message MessageSet {
+      repeated group Item = 1 {
+        required int32 type_id = 2;
+        required string message = 3;
+      }
+    }
+  """
+
+  type_id_tag_bytes = encoder.TagBytes(2, wire_format.WIRETYPE_VARINT)
+  message_tag_bytes = encoder.TagBytes(3, wire_format.WIRETYPE_LENGTH_DELIMITED)
+  item_end_tag_bytes = encoder.TagBytes(1, wire_format.WIRETYPE_END_GROUP)
+
+  local_ReadTag = ReadTag
+  local_DecodeVarint = _DecodeVarint
+  local_SkipField = SkipField
+
+  def DecodeItem(buffer, pos, end, message, field_dict):
+    """Decode serialized message set to its value and new position.
+
+    Args:
+      buffer: memoryview of the serialized bytes.
+      pos: int, position in the memory view to start at.
+      end: int, end position of serialized data
+      message: Message object to store unknown fields in
+      field_dict: Map[Descriptor, Any] to store decoded values in.
+
+    Returns:
+      int, new position in serialized data.
+    """
+    message_set_item_start = pos
+    type_id = -1
+    message_start = -1
+    message_end = -1
+
+    # Technically, type_id and message can appear in any order, so we need
+    # a little loop here.
+    while 1:
+      (tag_bytes, pos) = local_ReadTag(buffer, pos)
+      if tag_bytes == type_id_tag_bytes:
+        (type_id, pos) = local_DecodeVarint(buffer, pos)
+      elif tag_bytes == message_tag_bytes:
+        (size, message_start) = local_DecodeVarint(buffer, pos)
+        pos = message_end = message_start + size
+      elif tag_bytes == item_end_tag_bytes:
+        break
+      else:
+        pos = SkipField(buffer, pos, end, tag_bytes)
+        if pos == -1:
+          raise _DecodeError('Missing group end tag.')
+
+    if pos > end:
+      raise _DecodeError('Truncated message.')
+
+    if type_id == -1:
+      raise _DecodeError('MessageSet item missing type_id.')
+    if message_start == -1:
+      raise _DecodeError('MessageSet item missing message.')
+
+    extension = message.Extensions._FindExtensionByNumber(type_id)
+    # pylint: disable=protected-access
+    if extension is not None:
+      value = field_dict.get(extension)
+      if value is None:
+        message_type = extension.message_type
+        if not hasattr(message_type, '_concrete_class'):
+          message_factory.GetMessageClass(message_type)
+        value = field_dict.setdefault(
+            extension, message_type._concrete_class())
+      if value._InternalParse(buffer, message_start,message_end) != message_end:
+        # The only reason _InternalParse would return early is if it encountered
+        # an end-group tag.
+        raise _DecodeError('Unexpected end-group tag.')
+    else:
+      if not message._unknown_fields:
+        message._unknown_fields = []
+      message._unknown_fields.append(
+          (MESSAGE_SET_ITEM_TAG, buffer[message_set_item_start:pos].tobytes()))
+      if message._unknown_field_set is None:
+        message._unknown_field_set = containers.UnknownFieldSet()
+      message._unknown_field_set._add(
+          type_id,
+          wire_format.WIRETYPE_LENGTH_DELIMITED,
+          buffer[message_start:message_end].tobytes())
+      # pylint: enable=protected-access
+
+    return pos
+
+  return DecodeItem
+
+
+def UnknownMessageSetItemDecoder():
+  """Returns a decoder for a Unknown MessageSet item."""
+
+  type_id_tag_bytes = encoder.TagBytes(2, wire_format.WIRETYPE_VARINT)
+  message_tag_bytes = encoder.TagBytes(3, wire_format.WIRETYPE_LENGTH_DELIMITED)
+  item_end_tag_bytes = encoder.TagBytes(1, wire_format.WIRETYPE_END_GROUP)
+
+  def DecodeUnknownItem(buffer):
+    pos = 0
+    end = len(buffer)
+    message_start = -1
+    message_end = -1
+    while 1:
+      (tag_bytes, pos) = ReadTag(buffer, pos)
+      if tag_bytes == type_id_tag_bytes:
+        (type_id, pos) = _DecodeVarint(buffer, pos)
+      elif tag_bytes == message_tag_bytes:
+        (size, message_start) = _DecodeVarint(buffer, pos)
+        pos = message_end = message_start + size
+      elif tag_bytes == item_end_tag_bytes:
+        break
+      else:
+        pos = SkipField(buffer, pos, end, tag_bytes)
+        if pos == -1:
+          raise _DecodeError('Missing group end tag.')
+
+    if pos > end:
+      raise _DecodeError('Truncated message.')
+
+    if type_id == -1:
+      raise _DecodeError('MessageSet item missing type_id.')
+    if message_start == -1:
+      raise _DecodeError('MessageSet item missing message.')
+
+    return (type_id, buffer[message_start:message_end].tobytes())
+
+  return DecodeUnknownItem
+
+# --------------------------------------------------------------------
+
+def MapDecoder(field_descriptor, new_default, is_message_map):
+  """Returns a decoder for a map field."""
+
+  key = field_descriptor
+  tag_bytes = encoder.TagBytes(field_descriptor.number,
+                               wire_format.WIRETYPE_LENGTH_DELIMITED)
+  tag_len = len(tag_bytes)
+  local_DecodeVarint = _DecodeVarint
+  # Can't read _concrete_class yet; might not be initialized.
+  message_type = field_descriptor.message_type
+
+  def DecodeMap(buffer, pos, end, message, field_dict):
+    submsg = message_type._concrete_class()
+    value = field_dict.get(key)
+    if value is None:
+      value = field_dict.setdefault(key, new_default(message))
+    while 1:
+      # Read length.
+      (size, pos) = local_DecodeVarint(buffer, pos)
+      new_pos = pos + size
+      if new_pos > end:
+        raise _DecodeError('Truncated message.')
+      # Read sub-message.
+      submsg.Clear()
+      if submsg._InternalParse(buffer, pos, new_pos) != new_pos:
+        # The only reason _InternalParse would return early is if it
+        # encountered an end-group tag.
+        raise _DecodeError('Unexpected end-group tag.')
+
+      if is_message_map:
+        value[submsg.key].CopyFrom(submsg.value)
+      else:
+        value[submsg.key] = submsg.value
+
+      # Predict that the next tag is another copy of the same repeated field.
+      pos = new_pos + tag_len
+      if buffer[new_pos:pos] != tag_bytes or new_pos == end:
+        # Prediction failed.  Return.
+        return new_pos
+
+  return DecodeMap
+
+# --------------------------------------------------------------------
+# Optimization is not as heavy here because calls to SkipField() are rare,
+# except for handling end-group tags.
+
+def _SkipVarint(buffer, pos, end):
+  """Skip a varint value.  Returns the new position."""
+  # Previously ord(buffer[pos]) raised IndexError when pos is out of range.
+  # With this code, ord(b'') raises TypeError.  Both are handled in
+  # python_message.py to generate a 'Truncated message' error.
+  while ord(buffer[pos:pos+1].tobytes()) & 0x80:
+    pos += 1
+  pos += 1
+  if pos > end:
+    raise _DecodeError('Truncated message.')
+  return pos
+
+def _SkipFixed64(buffer, pos, end):
+  """Skip a fixed64 value.  Returns the new position."""
+
+  pos += 8
+  if pos > end:
+    raise _DecodeError('Truncated message.')
+  return pos
+
+
+def _DecodeFixed64(buffer, pos):
+  """Decode a fixed64."""
+  new_pos = pos + 8
+  return (struct.unpack('<Q', buffer[pos:new_pos])[0], new_pos)
+
+
+def _SkipLengthDelimited(buffer, pos, end):
+  """Skip a length-delimited value.  Returns the new position."""
+
+  (size, pos) = _DecodeVarint(buffer, pos)
+  pos += size
+  if pos > end:
+    raise _DecodeError('Truncated message.')
+  return pos
+
+
+def _SkipGroup(buffer, pos, end):
+  """Skip sub-group.  Returns the new position."""
+
+  while 1:
+    (tag_bytes, pos) = ReadTag(buffer, pos)
+    new_pos = SkipField(buffer, pos, end, tag_bytes)
+    if new_pos == -1:
+      return pos
+    pos = new_pos
+
+
+def _DecodeUnknownFieldSet(buffer, pos, end_pos=None):
+  """Decode UnknownFieldSet.  Returns the UnknownFieldSet and new position."""
+
+  unknown_field_set = containers.UnknownFieldSet()
+  while end_pos is None or pos < end_pos:
+    (tag_bytes, pos) = ReadTag(buffer, pos)
+    (tag, _) = _DecodeVarint(tag_bytes, 0)
+    field_number, wire_type = wire_format.UnpackTag(tag)
+    if wire_type == wire_format.WIRETYPE_END_GROUP:
+      break
+    (data, pos) = _DecodeUnknownField(buffer, pos, wire_type)
+    # pylint: disable=protected-access
+    unknown_field_set._add(field_number, wire_type, data)
+
+  return (unknown_field_set, pos)
+
+
+def _DecodeUnknownField(buffer, pos, wire_type):
+  """Decode a unknown field.  Returns the UnknownField and new position."""
+
+  if wire_type == wire_format.WIRETYPE_VARINT:
+    (data, pos) = _DecodeVarint(buffer, pos)
+  elif wire_type == wire_format.WIRETYPE_FIXED64:
+    (data, pos) = _DecodeFixed64(buffer, pos)
+  elif wire_type == wire_format.WIRETYPE_FIXED32:
+    (data, pos) = _DecodeFixed32(buffer, pos)
+  elif wire_type == wire_format.WIRETYPE_LENGTH_DELIMITED:
+    (size, pos) = _DecodeVarint(buffer, pos)
+    data = buffer[pos:pos+size].tobytes()
+    pos += size
+  elif wire_type == wire_format.WIRETYPE_START_GROUP:
+    (data, pos) = _DecodeUnknownFieldSet(buffer, pos)
+  elif wire_type == wire_format.WIRETYPE_END_GROUP:
+    return (0, -1)
+  else:
+    raise _DecodeError('Wrong wire type in tag.')
+
+  return (data, pos)
+
+
+def _EndGroup(buffer, pos, end):
+  """Skipping an END_GROUP tag returns -1 to tell the parent loop to break."""
+
+  return -1
+
+
+def _SkipFixed32(buffer, pos, end):
+  """Skip a fixed32 value.  Returns the new position."""
+
+  pos += 4
+  if pos > end:
+    raise _DecodeError('Truncated message.')
+  return pos
+
+
+def _DecodeFixed32(buffer, pos):
+  """Decode a fixed32."""
+
+  new_pos = pos + 4
+  return (struct.unpack('<I', buffer[pos:new_pos])[0], new_pos)
+
+
+def _RaiseInvalidWireType(buffer, pos, end):
+  """Skip function for unknown wire types.  Raises an exception."""
+
+  raise _DecodeError('Tag had invalid wire type.')
+
+def _FieldSkipper():
+  """Constructs the SkipField function."""
+
+  WIRETYPE_TO_SKIPPER = [
+      _SkipVarint,
+      _SkipFixed64,
+      _SkipLengthDelimited,
+      _SkipGroup,
+      _EndGroup,
+      _SkipFixed32,
+      _RaiseInvalidWireType,
+      _RaiseInvalidWireType,
+      ]
+
+  wiretype_mask = wire_format.TAG_TYPE_MASK
+
+  def SkipField(buffer, pos, end, tag_bytes):
+    """Skips a field with the specified tag.
+
+    |pos| should point to the byte immediately after the tag.
+
+    Returns:
+        The new position (after the tag value), or -1 if the tag is an end-group
+        tag (in which case the calling loop should break).
+    """
+
+    # The wire type is always in the first byte since varints are little-endian.
+    wire_type = ord(tag_bytes[0:1]) & wiretype_mask
+    return WIRETYPE_TO_SKIPPER[wire_type](buffer, pos, end)
+
+  return SkipField
+
+SkipField = _FieldSkipper()
diff --git a/llm/Lib/site-packages/google/protobuf/internal/encoder.py b/llm/Lib/site-packages/google/protobuf/internal/encoder.py
new file mode 100644
index 0000000000000000000000000000000000000000..df7bf1b537f6a3d5f1f4e10009f7e23be91382dd
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/encoder.py
@@ -0,0 +1,806 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Code for encoding protocol message primitives.
+
+Contains the logic for encoding every logical protocol field type
+into one of the 5 physical wire types.
+
+This code is designed to push the Python interpreter's performance to the
+limits.
+
+The basic idea is that at startup time, for every field (i.e. every
+FieldDescriptor) we construct two functions:  a "sizer" and an "encoder".  The
+sizer takes a value of this field's type and computes its byte size.  The
+encoder takes a writer function and a value.  It encodes the value into byte
+strings and invokes the writer function to write those strings.  Typically the
+writer function is the write() method of a BytesIO.
+
+We try to do as much work as possible when constructing the writer and the
+sizer rather than when calling them.  In particular:
+* We copy any needed global functions to local variables, so that we do not need
+  to do costly global table lookups at runtime.
+* Similarly, we try to do any attribute lookups at startup time if possible.
+* Every field's tag is encoded to bytes at startup, since it can't change at
+  runtime.
+* Whatever component of the field size we can compute at startup, we do.
+* We *avoid* sharing code if doing so would make the code slower and not sharing
+  does not burden us too much.  For example, encoders for repeated fields do
+  not just call the encoders for singular fields in a loop because this would
+  add an extra function call overhead for every loop iteration; instead, we
+  manually inline the single-value encoder into the loop.
+* If a Python function lacks a return statement, Python actually generates
+  instructions to pop the result of the last statement off the stack, push
+  None onto the stack, and then return that.  If we really don't care what
+  value is returned, then we can save two instructions by returning the
+  result of the last statement.  It looks funny but it helps.
+* We assume that type and bounds checking has happened at a higher level.
+"""
+
+__author__ = 'kenton@google.com (Kenton Varda)'
+
+import struct
+
+from google.protobuf.internal import wire_format
+
+
+# This will overflow and thus become IEEE-754 "infinity".  We would use
+# "float('inf')" but it doesn't work on Windows pre-Python-2.6.
+_POS_INF = 1e10000
+_NEG_INF = -_POS_INF
+
+
+def _VarintSize(value):
+  """Compute the size of a varint value."""
+  if value <= 0x7f: return 1
+  if value <= 0x3fff: return 2
+  if value <= 0x1fffff: return 3
+  if value <= 0xfffffff: return 4
+  if value <= 0x7ffffffff: return 5
+  if value <= 0x3ffffffffff: return 6
+  if value <= 0x1ffffffffffff: return 7
+  if value <= 0xffffffffffffff: return 8
+  if value <= 0x7fffffffffffffff: return 9
+  return 10
+
+
+def _SignedVarintSize(value):
+  """Compute the size of a signed varint value."""
+  if value < 0: return 10
+  if value <= 0x7f: return 1
+  if value <= 0x3fff: return 2
+  if value <= 0x1fffff: return 3
+  if value <= 0xfffffff: return 4
+  if value <= 0x7ffffffff: return 5
+  if value <= 0x3ffffffffff: return 6
+  if value <= 0x1ffffffffffff: return 7
+  if value <= 0xffffffffffffff: return 8
+  if value <= 0x7fffffffffffffff: return 9
+  return 10
+
+
+def _TagSize(field_number):
+  """Returns the number of bytes required to serialize a tag with this field
+  number."""
+  # Just pass in type 0, since the type won't affect the tag+type size.
+  return _VarintSize(wire_format.PackTag(field_number, 0))
+
+
+# --------------------------------------------------------------------
+# In this section we define some generic sizers.  Each of these functions
+# takes parameters specific to a particular field type, e.g. int32 or fixed64.
+# It returns another function which in turn takes parameters specific to a
+# particular field, e.g. the field number and whether it is repeated or packed.
+# Look at the next section to see how these are used.
+
+
+def _SimpleSizer(compute_value_size):
+  """A sizer which uses the function compute_value_size to compute the size of
+  each value.  Typically compute_value_size is _VarintSize."""
+
+  def SpecificSizer(field_number, is_repeated, is_packed):
+    tag_size = _TagSize(field_number)
+    if is_packed:
+      local_VarintSize = _VarintSize
+      def PackedFieldSize(value):
+        result = 0
+        for element in value:
+          result += compute_value_size(element)
+        return result + local_VarintSize(result) + tag_size
+      return PackedFieldSize
+    elif is_repeated:
+      def RepeatedFieldSize(value):
+        result = tag_size * len(value)
+        for element in value:
+          result += compute_value_size(element)
+        return result
+      return RepeatedFieldSize
+    else:
+      def FieldSize(value):
+        return tag_size + compute_value_size(value)
+      return FieldSize
+
+  return SpecificSizer
+
+
+def _ModifiedSizer(compute_value_size, modify_value):
+  """Like SimpleSizer, but modify_value is invoked on each value before it is
+  passed to compute_value_size.  modify_value is typically ZigZagEncode."""
+
+  def SpecificSizer(field_number, is_repeated, is_packed):
+    tag_size = _TagSize(field_number)
+    if is_packed:
+      local_VarintSize = _VarintSize
+      def PackedFieldSize(value):
+        result = 0
+        for element in value:
+          result += compute_value_size(modify_value(element))
+        return result + local_VarintSize(result) + tag_size
+      return PackedFieldSize
+    elif is_repeated:
+      def RepeatedFieldSize(value):
+        result = tag_size * len(value)
+        for element in value:
+          result += compute_value_size(modify_value(element))
+        return result
+      return RepeatedFieldSize
+    else:
+      def FieldSize(value):
+        return tag_size + compute_value_size(modify_value(value))
+      return FieldSize
+
+  return SpecificSizer
+
+
+def _FixedSizer(value_size):
+  """Like _SimpleSizer except for a fixed-size field.  The input is the size
+  of one value."""
+
+  def SpecificSizer(field_number, is_repeated, is_packed):
+    tag_size = _TagSize(field_number)
+    if is_packed:
+      local_VarintSize = _VarintSize
+      def PackedFieldSize(value):
+        result = len(value) * value_size
+        return result + local_VarintSize(result) + tag_size
+      return PackedFieldSize
+    elif is_repeated:
+      element_size = value_size + tag_size
+      def RepeatedFieldSize(value):
+        return len(value) * element_size
+      return RepeatedFieldSize
+    else:
+      field_size = value_size + tag_size
+      def FieldSize(value):
+        return field_size
+      return FieldSize
+
+  return SpecificSizer
+
+
+# ====================================================================
+# Here we declare a sizer constructor for each field type.  Each "sizer
+# constructor" is a function that takes (field_number, is_repeated, is_packed)
+# as parameters and returns a sizer, which in turn takes a field value as
+# a parameter and returns its encoded size.
+
+
+Int32Sizer = Int64Sizer = EnumSizer = _SimpleSizer(_SignedVarintSize)
+
+UInt32Sizer = UInt64Sizer = _SimpleSizer(_VarintSize)
+
+SInt32Sizer = SInt64Sizer = _ModifiedSizer(
+    _SignedVarintSize, wire_format.ZigZagEncode)
+
+Fixed32Sizer = SFixed32Sizer = FloatSizer  = _FixedSizer(4)
+Fixed64Sizer = SFixed64Sizer = DoubleSizer = _FixedSizer(8)
+
+BoolSizer = _FixedSizer(1)
+
+
+def StringSizer(field_number, is_repeated, is_packed):
+  """Returns a sizer for a string field."""
+
+  tag_size = _TagSize(field_number)
+  local_VarintSize = _VarintSize
+  local_len = len
+  assert not is_packed
+  if is_repeated:
+    def RepeatedFieldSize(value):
+      result = tag_size * len(value)
+      for element in value:
+        l = local_len(element.encode('utf-8'))
+        result += local_VarintSize(l) + l
+      return result
+    return RepeatedFieldSize
+  else:
+    def FieldSize(value):
+      l = local_len(value.encode('utf-8'))
+      return tag_size + local_VarintSize(l) + l
+    return FieldSize
+
+
+def BytesSizer(field_number, is_repeated, is_packed):
+  """Returns a sizer for a bytes field."""
+
+  tag_size = _TagSize(field_number)
+  local_VarintSize = _VarintSize
+  local_len = len
+  assert not is_packed
+  if is_repeated:
+    def RepeatedFieldSize(value):
+      result = tag_size * len(value)
+      for element in value:
+        l = local_len(element)
+        result += local_VarintSize(l) + l
+      return result
+    return RepeatedFieldSize
+  else:
+    def FieldSize(value):
+      l = local_len(value)
+      return tag_size + local_VarintSize(l) + l
+    return FieldSize
+
+
+def GroupSizer(field_number, is_repeated, is_packed):
+  """Returns a sizer for a group field."""
+
+  tag_size = _TagSize(field_number) * 2
+  assert not is_packed
+  if is_repeated:
+    def RepeatedFieldSize(value):
+      result = tag_size * len(value)
+      for element in value:
+        result += element.ByteSize()
+      return result
+    return RepeatedFieldSize
+  else:
+    def FieldSize(value):
+      return tag_size + value.ByteSize()
+    return FieldSize
+
+
+def MessageSizer(field_number, is_repeated, is_packed):
+  """Returns a sizer for a message field."""
+
+  tag_size = _TagSize(field_number)
+  local_VarintSize = _VarintSize
+  assert not is_packed
+  if is_repeated:
+    def RepeatedFieldSize(value):
+      result = tag_size * len(value)
+      for element in value:
+        l = element.ByteSize()
+        result += local_VarintSize(l) + l
+      return result
+    return RepeatedFieldSize
+  else:
+    def FieldSize(value):
+      l = value.ByteSize()
+      return tag_size + local_VarintSize(l) + l
+    return FieldSize
+
+
+# --------------------------------------------------------------------
+# MessageSet is special: it needs custom logic to compute its size properly.
+
+
+def MessageSetItemSizer(field_number):
+  """Returns a sizer for extensions of MessageSet.
+
+  The message set message looks like this:
+    message MessageSet {
+      repeated group Item = 1 {
+        required int32 type_id = 2;
+        required string message = 3;
+      }
+    }
+  """
+  static_size = (_TagSize(1) * 2 + _TagSize(2) + _VarintSize(field_number) +
+                 _TagSize(3))
+  local_VarintSize = _VarintSize
+
+  def FieldSize(value):
+    l = value.ByteSize()
+    return static_size + local_VarintSize(l) + l
+
+  return FieldSize
+
+
+# --------------------------------------------------------------------
+# Map is special: it needs custom logic to compute its size properly.
+
+
+def MapSizer(field_descriptor, is_message_map):
+  """Returns a sizer for a map field."""
+
+  # Can't look at field_descriptor.message_type._concrete_class because it may
+  # not have been initialized yet.
+  message_type = field_descriptor.message_type
+  message_sizer = MessageSizer(field_descriptor.number, False, False)
+
+  def FieldSize(map_value):
+    total = 0
+    for key in map_value:
+      value = map_value[key]
+      # It's wasteful to create the messages and throw them away one second
+      # later since we'll do the same for the actual encode.  But there's not an
+      # obvious way to avoid this within the current design without tons of code
+      # duplication. For message map, value.ByteSize() should be called to
+      # update the status.
+      entry_msg = message_type._concrete_class(key=key, value=value)
+      total += message_sizer(entry_msg)
+      if is_message_map:
+        value.ByteSize()
+    return total
+
+  return FieldSize
+
+# ====================================================================
+# Encoders!
+
+
+def _VarintEncoder():
+  """Return an encoder for a basic varint value (does not include tag)."""
+
+  local_int2byte = struct.Struct('>B').pack
+
+  def EncodeVarint(write, value, unused_deterministic=None):
+    bits = value & 0x7f
+    value >>= 7
+    while value:
+      write(local_int2byte(0x80|bits))
+      bits = value & 0x7f
+      value >>= 7
+    return write(local_int2byte(bits))
+
+  return EncodeVarint
+
+
+def _SignedVarintEncoder():
+  """Return an encoder for a basic signed varint value (does not include
+  tag)."""
+
+  local_int2byte = struct.Struct('>B').pack
+
+  def EncodeSignedVarint(write, value, unused_deterministic=None):
+    if value < 0:
+      value += (1 << 64)
+    bits = value & 0x7f
+    value >>= 7
+    while value:
+      write(local_int2byte(0x80|bits))
+      bits = value & 0x7f
+      value >>= 7
+    return write(local_int2byte(bits))
+
+  return EncodeSignedVarint
+
+
+_EncodeVarint = _VarintEncoder()
+_EncodeSignedVarint = _SignedVarintEncoder()
+
+
+def _VarintBytes(value):
+  """Encode the given integer as a varint and return the bytes.  This is only
+  called at startup time so it doesn't need to be fast."""
+
+  pieces = []
+  _EncodeVarint(pieces.append, value, True)
+  return b"".join(pieces)
+
+
+def TagBytes(field_number, wire_type):
+  """Encode the given tag and return the bytes.  Only called at startup."""
+
+  return bytes(_VarintBytes(wire_format.PackTag(field_number, wire_type)))
+
+# --------------------------------------------------------------------
+# As with sizers (see above), we have a number of common encoder
+# implementations.
+
+
+def _SimpleEncoder(wire_type, encode_value, compute_value_size):
+  """Return a constructor for an encoder for fields of a particular type.
+
+  Args:
+      wire_type:  The field's wire type, for encoding tags.
+      encode_value:  A function which encodes an individual value, e.g.
+        _EncodeVarint().
+      compute_value_size:  A function which computes the size of an individual
+        value, e.g. _VarintSize().
+  """
+
+  def SpecificEncoder(field_number, is_repeated, is_packed):
+    if is_packed:
+      tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+      local_EncodeVarint = _EncodeVarint
+      def EncodePackedField(write, value, deterministic):
+        write(tag_bytes)
+        size = 0
+        for element in value:
+          size += compute_value_size(element)
+        local_EncodeVarint(write, size, deterministic)
+        for element in value:
+          encode_value(write, element, deterministic)
+      return EncodePackedField
+    elif is_repeated:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeRepeatedField(write, value, deterministic):
+        for element in value:
+          write(tag_bytes)
+          encode_value(write, element, deterministic)
+      return EncodeRepeatedField
+    else:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeField(write, value, deterministic):
+        write(tag_bytes)
+        return encode_value(write, value, deterministic)
+      return EncodeField
+
+  return SpecificEncoder
+
+
+def _ModifiedEncoder(wire_type, encode_value, compute_value_size, modify_value):
+  """Like SimpleEncoder but additionally invokes modify_value on every value
+  before passing it to encode_value.  Usually modify_value is ZigZagEncode."""
+
+  def SpecificEncoder(field_number, is_repeated, is_packed):
+    if is_packed:
+      tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+      local_EncodeVarint = _EncodeVarint
+      def EncodePackedField(write, value, deterministic):
+        write(tag_bytes)
+        size = 0
+        for element in value:
+          size += compute_value_size(modify_value(element))
+        local_EncodeVarint(write, size, deterministic)
+        for element in value:
+          encode_value(write, modify_value(element), deterministic)
+      return EncodePackedField
+    elif is_repeated:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeRepeatedField(write, value, deterministic):
+        for element in value:
+          write(tag_bytes)
+          encode_value(write, modify_value(element), deterministic)
+      return EncodeRepeatedField
+    else:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeField(write, value, deterministic):
+        write(tag_bytes)
+        return encode_value(write, modify_value(value), deterministic)
+      return EncodeField
+
+  return SpecificEncoder
+
+
+def _StructPackEncoder(wire_type, format):
+  """Return a constructor for an encoder for a fixed-width field.
+
+  Args:
+      wire_type:  The field's wire type, for encoding tags.
+      format:  The format string to pass to struct.pack().
+  """
+
+  value_size = struct.calcsize(format)
+
+  def SpecificEncoder(field_number, is_repeated, is_packed):
+    local_struct_pack = struct.pack
+    if is_packed:
+      tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+      local_EncodeVarint = _EncodeVarint
+      def EncodePackedField(write, value, deterministic):
+        write(tag_bytes)
+        local_EncodeVarint(write, len(value) * value_size, deterministic)
+        for element in value:
+          write(local_struct_pack(format, element))
+      return EncodePackedField
+    elif is_repeated:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeRepeatedField(write, value, unused_deterministic=None):
+        for element in value:
+          write(tag_bytes)
+          write(local_struct_pack(format, element))
+      return EncodeRepeatedField
+    else:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeField(write, value, unused_deterministic=None):
+        write(tag_bytes)
+        return write(local_struct_pack(format, value))
+      return EncodeField
+
+  return SpecificEncoder
+
+
+def _FloatingPointEncoder(wire_type, format):
+  """Return a constructor for an encoder for float fields.
+
+  This is like StructPackEncoder, but catches errors that may be due to
+  passing non-finite floating-point values to struct.pack, and makes a
+  second attempt to encode those values.
+
+  Args:
+      wire_type:  The field's wire type, for encoding tags.
+      format:  The format string to pass to struct.pack().
+  """
+
+  value_size = struct.calcsize(format)
+  if value_size == 4:
+    def EncodeNonFiniteOrRaise(write, value):
+      # Remember that the serialized form uses little-endian byte order.
+      if value == _POS_INF:
+        write(b'\x00\x00\x80\x7F')
+      elif value == _NEG_INF:
+        write(b'\x00\x00\x80\xFF')
+      elif value != value:           # NaN
+        write(b'\x00\x00\xC0\x7F')
+      else:
+        raise
+  elif value_size == 8:
+    def EncodeNonFiniteOrRaise(write, value):
+      if value == _POS_INF:
+        write(b'\x00\x00\x00\x00\x00\x00\xF0\x7F')
+      elif value == _NEG_INF:
+        write(b'\x00\x00\x00\x00\x00\x00\xF0\xFF')
+      elif value != value:                         # NaN
+        write(b'\x00\x00\x00\x00\x00\x00\xF8\x7F')
+      else:
+        raise
+  else:
+    raise ValueError('Can\'t encode floating-point values that are '
+                     '%d bytes long (only 4 or 8)' % value_size)
+
+  def SpecificEncoder(field_number, is_repeated, is_packed):
+    local_struct_pack = struct.pack
+    if is_packed:
+      tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+      local_EncodeVarint = _EncodeVarint
+      def EncodePackedField(write, value, deterministic):
+        write(tag_bytes)
+        local_EncodeVarint(write, len(value) * value_size, deterministic)
+        for element in value:
+          # This try/except block is going to be faster than any code that
+          # we could write to check whether element is finite.
+          try:
+            write(local_struct_pack(format, element))
+          except SystemError:
+            EncodeNonFiniteOrRaise(write, element)
+      return EncodePackedField
+    elif is_repeated:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeRepeatedField(write, value, unused_deterministic=None):
+        for element in value:
+          write(tag_bytes)
+          try:
+            write(local_struct_pack(format, element))
+          except SystemError:
+            EncodeNonFiniteOrRaise(write, element)
+      return EncodeRepeatedField
+    else:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeField(write, value, unused_deterministic=None):
+        write(tag_bytes)
+        try:
+          write(local_struct_pack(format, value))
+        except SystemError:
+          EncodeNonFiniteOrRaise(write, value)
+      return EncodeField
+
+  return SpecificEncoder
+
+
+# ====================================================================
+# Here we declare an encoder constructor for each field type.  These work
+# very similarly to sizer constructors, described earlier.
+
+
+Int32Encoder = Int64Encoder = EnumEncoder = _SimpleEncoder(
+    wire_format.WIRETYPE_VARINT, _EncodeSignedVarint, _SignedVarintSize)
+
+UInt32Encoder = UInt64Encoder = _SimpleEncoder(
+    wire_format.WIRETYPE_VARINT, _EncodeVarint, _VarintSize)
+
+SInt32Encoder = SInt64Encoder = _ModifiedEncoder(
+    wire_format.WIRETYPE_VARINT, _EncodeVarint, _VarintSize,
+    wire_format.ZigZagEncode)
+
+# Note that Python conveniently guarantees that when using the '<' prefix on
+# formats, they will also have the same size across all platforms (as opposed
+# to without the prefix, where their sizes depend on the C compiler's basic
+# type sizes).
+Fixed32Encoder  = _StructPackEncoder(wire_format.WIRETYPE_FIXED32, '<I')
+Fixed64Encoder  = _StructPackEncoder(wire_format.WIRETYPE_FIXED64, '<Q')
+SFixed32Encoder = _StructPackEncoder(wire_format.WIRETYPE_FIXED32, '<i')
+SFixed64Encoder = _StructPackEncoder(wire_format.WIRETYPE_FIXED64, '<q')
+FloatEncoder    = _FloatingPointEncoder(wire_format.WIRETYPE_FIXED32, '<f')
+DoubleEncoder   = _FloatingPointEncoder(wire_format.WIRETYPE_FIXED64, '<d')
+
+
+def BoolEncoder(field_number, is_repeated, is_packed):
+  """Returns an encoder for a boolean field."""
+
+  false_byte = b'\x00'
+  true_byte = b'\x01'
+  if is_packed:
+    tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+    local_EncodeVarint = _EncodeVarint
+    def EncodePackedField(write, value, deterministic):
+      write(tag_bytes)
+      local_EncodeVarint(write, len(value), deterministic)
+      for element in value:
+        if element:
+          write(true_byte)
+        else:
+          write(false_byte)
+    return EncodePackedField
+  elif is_repeated:
+    tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_VARINT)
+    def EncodeRepeatedField(write, value, unused_deterministic=None):
+      for element in value:
+        write(tag_bytes)
+        if element:
+          write(true_byte)
+        else:
+          write(false_byte)
+    return EncodeRepeatedField
+  else:
+    tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_VARINT)
+    def EncodeField(write, value, unused_deterministic=None):
+      write(tag_bytes)
+      if value:
+        return write(true_byte)
+      return write(false_byte)
+    return EncodeField
+
+
+def StringEncoder(field_number, is_repeated, is_packed):
+  """Returns an encoder for a string field."""
+
+  tag = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+  local_EncodeVarint = _EncodeVarint
+  local_len = len
+  assert not is_packed
+  if is_repeated:
+    def EncodeRepeatedField(write, value, deterministic):
+      for element in value:
+        encoded = element.encode('utf-8')
+        write(tag)
+        local_EncodeVarint(write, local_len(encoded), deterministic)
+        write(encoded)
+    return EncodeRepeatedField
+  else:
+    def EncodeField(write, value, deterministic):
+      encoded = value.encode('utf-8')
+      write(tag)
+      local_EncodeVarint(write, local_len(encoded), deterministic)
+      return write(encoded)
+    return EncodeField
+
+
+def BytesEncoder(field_number, is_repeated, is_packed):
+  """Returns an encoder for a bytes field."""
+
+  tag = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+  local_EncodeVarint = _EncodeVarint
+  local_len = len
+  assert not is_packed
+  if is_repeated:
+    def EncodeRepeatedField(write, value, deterministic):
+      for element in value:
+        write(tag)
+        local_EncodeVarint(write, local_len(element), deterministic)
+        write(element)
+    return EncodeRepeatedField
+  else:
+    def EncodeField(write, value, deterministic):
+      write(tag)
+      local_EncodeVarint(write, local_len(value), deterministic)
+      return write(value)
+    return EncodeField
+
+
+def GroupEncoder(field_number, is_repeated, is_packed):
+  """Returns an encoder for a group field."""
+
+  start_tag = TagBytes(field_number, wire_format.WIRETYPE_START_GROUP)
+  end_tag = TagBytes(field_number, wire_format.WIRETYPE_END_GROUP)
+  assert not is_packed
+  if is_repeated:
+    def EncodeRepeatedField(write, value, deterministic):
+      for element in value:
+        write(start_tag)
+        element._InternalSerialize(write, deterministic)
+        write(end_tag)
+    return EncodeRepeatedField
+  else:
+    def EncodeField(write, value, deterministic):
+      write(start_tag)
+      value._InternalSerialize(write, deterministic)
+      return write(end_tag)
+    return EncodeField
+
+
+def MessageEncoder(field_number, is_repeated, is_packed):
+  """Returns an encoder for a message field."""
+
+  tag = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+  local_EncodeVarint = _EncodeVarint
+  assert not is_packed
+  if is_repeated:
+    def EncodeRepeatedField(write, value, deterministic):
+      for element in value:
+        write(tag)
+        local_EncodeVarint(write, element.ByteSize(), deterministic)
+        element._InternalSerialize(write, deterministic)
+    return EncodeRepeatedField
+  else:
+    def EncodeField(write, value, deterministic):
+      write(tag)
+      local_EncodeVarint(write, value.ByteSize(), deterministic)
+      return value._InternalSerialize(write, deterministic)
+    return EncodeField
+
+
+# --------------------------------------------------------------------
+# As before, MessageSet is special.
+
+
+def MessageSetItemEncoder(field_number):
+  """Encoder for extensions of MessageSet.
+
+  The message set message looks like this:
+    message MessageSet {
+      repeated group Item = 1 {
+        required int32 type_id = 2;
+        required string message = 3;
+      }
+    }
+  """
+  start_bytes = b"".join([
+      TagBytes(1, wire_format.WIRETYPE_START_GROUP),
+      TagBytes(2, wire_format.WIRETYPE_VARINT),
+      _VarintBytes(field_number),
+      TagBytes(3, wire_format.WIRETYPE_LENGTH_DELIMITED)])
+  end_bytes = TagBytes(1, wire_format.WIRETYPE_END_GROUP)
+  local_EncodeVarint = _EncodeVarint
+
+  def EncodeField(write, value, deterministic):
+    write(start_bytes)
+    local_EncodeVarint(write, value.ByteSize(), deterministic)
+    value._InternalSerialize(write, deterministic)
+    return write(end_bytes)
+
+  return EncodeField
+
+
+# --------------------------------------------------------------------
+# As before, Map is special.
+
+
+def MapEncoder(field_descriptor):
+  """Encoder for extensions of MessageSet.
+
+  Maps always have a wire format like this:
+    message MapEntry {
+      key_type key = 1;
+      value_type value = 2;
+    }
+    repeated MapEntry map = N;
+  """
+  # Can't look at field_descriptor.message_type._concrete_class because it may
+  # not have been initialized yet.
+  message_type = field_descriptor.message_type
+  encode_message = MessageEncoder(field_descriptor.number, False, False)
+
+  def EncodeField(write, value, deterministic):
+    value_keys = sorted(value.keys()) if deterministic else value
+    for key in value_keys:
+      entry_msg = message_type._concrete_class(key=key, value=value[key])
+      encode_message(write, entry_msg, deterministic)
+
+  return EncodeField
diff --git a/llm/Lib/site-packages/google/protobuf/internal/enum_type_wrapper.py b/llm/Lib/site-packages/google/protobuf/internal/enum_type_wrapper.py
new file mode 100644
index 0000000000000000000000000000000000000000..cc65fc0bc865d7d4a77f5d3232b67f18b4bae50b
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/enum_type_wrapper.py
@@ -0,0 +1,101 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""A simple wrapper around enum types to expose utility functions.
+
+Instances are created as properties with the same name as the enum they wrap
+on proto classes.  For usage, see:
+  reflection_test.py
+"""
+
+__author__ = 'rabsatt@google.com (Kevin Rabsatt)'
+
+
+class EnumTypeWrapper(object):
+  """A utility for finding the names of enum values."""
+
+  DESCRIPTOR = None
+
+  # This is a type alias, which mypy typing stubs can type as
+  # a genericized parameter constrained to an int, allowing subclasses
+  # to be typed with more constraint in .pyi stubs
+  # Eg.
+  # def MyGeneratedEnum(Message):
+  #   ValueType = NewType('ValueType', int)
+  #   def Name(self, number: MyGeneratedEnum.ValueType) -> str
+  ValueType = int
+
+  def __init__(self, enum_type):
+    """Inits EnumTypeWrapper with an EnumDescriptor."""
+    self._enum_type = enum_type
+    self.DESCRIPTOR = enum_type  # pylint: disable=invalid-name
+
+  def Name(self, number):  # pylint: disable=invalid-name
+    """Returns a string containing the name of an enum value."""
+    try:
+      return self._enum_type.values_by_number[number].name
+    except KeyError:
+      pass  # fall out to break exception chaining
+
+    if not isinstance(number, int):
+      raise TypeError(
+          'Enum value for {} must be an int, but got {} {!r}.'.format(
+              self._enum_type.name, type(number), number))
+    else:
+      # repr here to handle the odd case when you pass in a boolean.
+      raise ValueError('Enum {} has no name defined for value {!r}'.format(
+          self._enum_type.name, number))
+
+  def Value(self, name):  # pylint: disable=invalid-name
+    """Returns the value corresponding to the given enum name."""
+    try:
+      return self._enum_type.values_by_name[name].number
+    except KeyError:
+      pass  # fall out to break exception chaining
+    raise ValueError('Enum {} has no value defined for name {!r}'.format(
+        self._enum_type.name, name))
+
+  def keys(self):
+    """Return a list of the string names in the enum.
+
+    Returns:
+      A list of strs, in the order they were defined in the .proto file.
+    """
+
+    return [value_descriptor.name
+            for value_descriptor in self._enum_type.values]
+
+  def values(self):
+    """Return a list of the integer values in the enum.
+
+    Returns:
+      A list of ints, in the order they were defined in the .proto file.
+    """
+
+    return [value_descriptor.number
+            for value_descriptor in self._enum_type.values]
+
+  def items(self):
+    """Return a list of the (name, value) pairs of the enum.
+
+    Returns:
+      A list of (str, int) pairs, in the order they were defined
+      in the .proto file.
+    """
+    return [(value_descriptor.name, value_descriptor.number)
+            for value_descriptor in self._enum_type.values]
+
+  def __getattr__(self, name):
+    """Returns the value corresponding to the given enum name."""
+    try:
+      return super(
+          EnumTypeWrapper,
+          self).__getattribute__('_enum_type').values_by_name[name].number
+    except KeyError:
+      pass  # fall out to break exception chaining
+    raise AttributeError('Enum {} has no value defined for name {!r}'.format(
+        self._enum_type.name, name))
diff --git a/llm/Lib/site-packages/google/protobuf/internal/extension_dict.py b/llm/Lib/site-packages/google/protobuf/internal/extension_dict.py
new file mode 100644
index 0000000000000000000000000000000000000000..89e64d32d9351ca73a60f24972aa254cc54863ac
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/extension_dict.py
@@ -0,0 +1,194 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Contains _ExtensionDict class to represent extensions.
+"""
+
+from google.protobuf.internal import type_checkers
+from google.protobuf.descriptor import FieldDescriptor
+
+
+def _VerifyExtensionHandle(message, extension_handle):
+  """Verify that the given extension handle is valid."""
+
+  if not isinstance(extension_handle, FieldDescriptor):
+    raise KeyError('HasExtension() expects an extension handle, got: %s' %
+                   extension_handle)
+
+  if not extension_handle.is_extension:
+    raise KeyError('"%s" is not an extension.' % extension_handle.full_name)
+
+  if not extension_handle.containing_type:
+    raise KeyError('"%s" is missing a containing_type.'
+                   % extension_handle.full_name)
+
+  if extension_handle.containing_type is not message.DESCRIPTOR:
+    raise KeyError('Extension "%s" extends message type "%s", but this '
+                   'message is of type "%s".' %
+                   (extension_handle.full_name,
+                    extension_handle.containing_type.full_name,
+                    message.DESCRIPTOR.full_name))
+
+
+# TODO: Unify error handling of "unknown extension" crap.
+# TODO: Support iteritems()-style iteration over all
+# extensions with the "has" bits turned on?
+class _ExtensionDict(object):
+
+  """Dict-like container for Extension fields on proto instances.
+
+  Note that in all cases we expect extension handles to be
+  FieldDescriptors.
+  """
+
+  def __init__(self, extended_message):
+    """
+    Args:
+      extended_message: Message instance for which we are the Extensions dict.
+    """
+    self._extended_message = extended_message
+
+  def __getitem__(self, extension_handle):
+    """Returns the current value of the given extension handle."""
+
+    _VerifyExtensionHandle(self._extended_message, extension_handle)
+
+    result = self._extended_message._fields.get(extension_handle)
+    if result is not None:
+      return result
+
+    if extension_handle.label == FieldDescriptor.LABEL_REPEATED:
+      result = extension_handle._default_constructor(self._extended_message)
+    elif extension_handle.cpp_type == FieldDescriptor.CPPTYPE_MESSAGE:
+      message_type = extension_handle.message_type
+      if not hasattr(message_type, '_concrete_class'):
+        # pylint: disable=g-import-not-at-top
+        from google.protobuf import message_factory
+        message_factory.GetMessageClass(message_type)
+      if not hasattr(extension_handle.message_type, '_concrete_class'):
+        from google.protobuf import message_factory
+        message_factory.GetMessageClass(extension_handle.message_type)
+      result = extension_handle.message_type._concrete_class()
+      try:
+        result._SetListener(self._extended_message._listener_for_children)
+      except ReferenceError:
+        pass
+    else:
+      # Singular scalar -- just return the default without inserting into the
+      # dict.
+      return extension_handle.default_value
+
+    # Atomically check if another thread has preempted us and, if not, swap
+    # in the new object we just created.  If someone has preempted us, we
+    # take that object and discard ours.
+    # WARNING:  We are relying on setdefault() being atomic.  This is true
+    #   in CPython but we haven't investigated others.  This warning appears
+    #   in several other locations in this file.
+    result = self._extended_message._fields.setdefault(
+        extension_handle, result)
+
+    return result
+
+  def __eq__(self, other):
+    if not isinstance(other, self.__class__):
+      return False
+
+    my_fields = self._extended_message.ListFields()
+    other_fields = other._extended_message.ListFields()
+
+    # Get rid of non-extension fields.
+    my_fields = [field for field in my_fields if field.is_extension]
+    other_fields = [field for field in other_fields if field.is_extension]
+
+    return my_fields == other_fields
+
+  def __ne__(self, other):
+    return not self == other
+
+  def __len__(self):
+    fields = self._extended_message.ListFields()
+    # Get rid of non-extension fields.
+    extension_fields = [field for field in fields if field[0].is_extension]
+    return len(extension_fields)
+
+  def __hash__(self):
+    raise TypeError('unhashable object')
+
+  # Note that this is only meaningful for non-repeated, scalar extension
+  # fields.  Note also that we may have to call _Modified() when we do
+  # successfully set a field this way, to set any necessary "has" bits in the
+  # ancestors of the extended message.
+  def __setitem__(self, extension_handle, value):
+    """If extension_handle specifies a non-repeated, scalar extension
+    field, sets the value of that field.
+    """
+
+    _VerifyExtensionHandle(self._extended_message, extension_handle)
+
+    if (extension_handle.label == FieldDescriptor.LABEL_REPEATED or
+        extension_handle.cpp_type == FieldDescriptor.CPPTYPE_MESSAGE):
+      raise TypeError(
+          'Cannot assign to extension "%s" because it is a repeated or '
+          'composite type.' % extension_handle.full_name)
+
+    # It's slightly wasteful to lookup the type checker each time,
+    # but we expect this to be a vanishingly uncommon case anyway.
+    type_checker = type_checkers.GetTypeChecker(extension_handle)
+    # pylint: disable=protected-access
+    self._extended_message._fields[extension_handle] = (
+        type_checker.CheckValue(value))
+    self._extended_message._Modified()
+
+  def __delitem__(self, extension_handle):
+    self._extended_message.ClearExtension(extension_handle)
+
+  def _FindExtensionByName(self, name):
+    """Tries to find a known extension with the specified name.
+
+    Args:
+      name: Extension full name.
+
+    Returns:
+      Extension field descriptor.
+    """
+    descriptor = self._extended_message.DESCRIPTOR
+    extensions = descriptor.file.pool._extensions_by_name[descriptor]
+    return extensions.get(name, None)
+
+  def _FindExtensionByNumber(self, number):
+    """Tries to find a known extension with the field number.
+
+    Args:
+      number: Extension field number.
+
+    Returns:
+      Extension field descriptor.
+    """
+    descriptor = self._extended_message.DESCRIPTOR
+    extensions = descriptor.file.pool._extensions_by_number[descriptor]
+    return extensions.get(number, None)
+
+  def __iter__(self):
+    # Return a generator over the populated extension fields
+    return (f[0] for f in self._extended_message.ListFields()
+            if f[0].is_extension)
+
+  def __contains__(self, extension_handle):
+    _VerifyExtensionHandle(self._extended_message, extension_handle)
+
+    if extension_handle not in self._extended_message._fields:
+      return False
+
+    if extension_handle.label == FieldDescriptor.LABEL_REPEATED:
+      return bool(self._extended_message._fields.get(extension_handle))
+
+    if extension_handle.cpp_type == FieldDescriptor.CPPTYPE_MESSAGE:
+      value = self._extended_message._fields.get(extension_handle)
+      # pylint: disable=protected-access
+      return value is not None and value._is_present_in_parent
+
+    return True
diff --git a/llm/Lib/site-packages/google/protobuf/internal/field_mask.py b/llm/Lib/site-packages/google/protobuf/internal/field_mask.py
new file mode 100644
index 0000000000000000000000000000000000000000..ae34f08a8adb9fddd0e7b6011e4f359e31ac3796
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/field_mask.py
@@ -0,0 +1,310 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Contains FieldMask class."""
+
+from google.protobuf.descriptor import FieldDescriptor
+
+
+class FieldMask(object):
+  """Class for FieldMask message type."""
+
+  __slots__ = ()
+
+  def ToJsonString(self):
+    """Converts FieldMask to string according to proto3 JSON spec."""
+    camelcase_paths = []
+    for path in self.paths:
+      camelcase_paths.append(_SnakeCaseToCamelCase(path))
+    return ','.join(camelcase_paths)
+
+  def FromJsonString(self, value):
+    """Converts string to FieldMask according to proto3 JSON spec."""
+    if not isinstance(value, str):
+      raise ValueError('FieldMask JSON value not a string: {!r}'.format(value))
+    self.Clear()
+    if value:
+      for path in value.split(','):
+        self.paths.append(_CamelCaseToSnakeCase(path))
+
+  def IsValidForDescriptor(self, message_descriptor):
+    """Checks whether the FieldMask is valid for Message Descriptor."""
+    for path in self.paths:
+      if not _IsValidPath(message_descriptor, path):
+        return False
+    return True
+
+  def AllFieldsFromDescriptor(self, message_descriptor):
+    """Gets all direct fields of Message Descriptor to FieldMask."""
+    self.Clear()
+    for field in message_descriptor.fields:
+      self.paths.append(field.name)
+
+  def CanonicalFormFromMask(self, mask):
+    """Converts a FieldMask to the canonical form.
+
+    Removes paths that are covered by another path. For example,
+    "foo.bar" is covered by "foo" and will be removed if "foo"
+    is also in the FieldMask. Then sorts all paths in alphabetical order.
+
+    Args:
+      mask: The original FieldMask to be converted.
+    """
+    tree = _FieldMaskTree(mask)
+    tree.ToFieldMask(self)
+
+  def Union(self, mask1, mask2):
+    """Merges mask1 and mask2 into this FieldMask."""
+    _CheckFieldMaskMessage(mask1)
+    _CheckFieldMaskMessage(mask2)
+    tree = _FieldMaskTree(mask1)
+    tree.MergeFromFieldMask(mask2)
+    tree.ToFieldMask(self)
+
+  def Intersect(self, mask1, mask2):
+    """Intersects mask1 and mask2 into this FieldMask."""
+    _CheckFieldMaskMessage(mask1)
+    _CheckFieldMaskMessage(mask2)
+    tree = _FieldMaskTree(mask1)
+    intersection = _FieldMaskTree()
+    for path in mask2.paths:
+      tree.IntersectPath(path, intersection)
+    intersection.ToFieldMask(self)
+
+  def MergeMessage(
+      self, source, destination,
+      replace_message_field=False, replace_repeated_field=False):
+    """Merges fields specified in FieldMask from source to destination.
+
+    Args:
+      source: Source message.
+      destination: The destination message to be merged into.
+      replace_message_field: Replace message field if True. Merge message
+          field if False.
+      replace_repeated_field: Replace repeated field if True. Append
+          elements of repeated field if False.
+    """
+    tree = _FieldMaskTree(self)
+    tree.MergeMessage(
+        source, destination, replace_message_field, replace_repeated_field)
+
+
+def _IsValidPath(message_descriptor, path):
+  """Checks whether the path is valid for Message Descriptor."""
+  parts = path.split('.')
+  last = parts.pop()
+  for name in parts:
+    field = message_descriptor.fields_by_name.get(name)
+    if (field is None or
+        field.label == FieldDescriptor.LABEL_REPEATED or
+        field.type != FieldDescriptor.TYPE_MESSAGE):
+      return False
+    message_descriptor = field.message_type
+  return last in message_descriptor.fields_by_name
+
+
+def _CheckFieldMaskMessage(message):
+  """Raises ValueError if message is not a FieldMask."""
+  message_descriptor = message.DESCRIPTOR
+  if (message_descriptor.name != 'FieldMask' or
+      message_descriptor.file.name != 'google/protobuf/field_mask.proto'):
+    raise ValueError('Message {0} is not a FieldMask.'.format(
+        message_descriptor.full_name))
+
+
+def _SnakeCaseToCamelCase(path_name):
+  """Converts a path name from snake_case to camelCase."""
+  result = []
+  after_underscore = False
+  for c in path_name:
+    if c.isupper():
+      raise ValueError(
+          'Fail to print FieldMask to Json string: Path name '
+          '{0} must not contain uppercase letters.'.format(path_name))
+    if after_underscore:
+      if c.islower():
+        result.append(c.upper())
+        after_underscore = False
+      else:
+        raise ValueError(
+            'Fail to print FieldMask to Json string: The '
+            'character after a "_" must be a lowercase letter '
+            'in path name {0}.'.format(path_name))
+    elif c == '_':
+      after_underscore = True
+    else:
+      result += c
+
+  if after_underscore:
+    raise ValueError('Fail to print FieldMask to Json string: Trailing "_" '
+                     'in path name {0}.'.format(path_name))
+  return ''.join(result)
+
+
+def _CamelCaseToSnakeCase(path_name):
+  """Converts a field name from camelCase to snake_case."""
+  result = []
+  for c in path_name:
+    if c == '_':
+      raise ValueError('Fail to parse FieldMask: Path name '
+                       '{0} must not contain "_"s.'.format(path_name))
+    if c.isupper():
+      result += '_'
+      result += c.lower()
+    else:
+      result += c
+  return ''.join(result)
+
+
+class _FieldMaskTree(object):
+  """Represents a FieldMask in a tree structure.
+
+  For example, given a FieldMask "foo.bar,foo.baz,bar.baz",
+  the FieldMaskTree will be:
+      [_root] -+- foo -+- bar
+            |       |
+            |       +- baz
+            |
+            +- bar --- baz
+  In the tree, each leaf node represents a field path.
+  """
+
+  __slots__ = ('_root',)
+
+  def __init__(self, field_mask=None):
+    """Initializes the tree by FieldMask."""
+    self._root = {}
+    if field_mask:
+      self.MergeFromFieldMask(field_mask)
+
+  def MergeFromFieldMask(self, field_mask):
+    """Merges a FieldMask to the tree."""
+    for path in field_mask.paths:
+      self.AddPath(path)
+
+  def AddPath(self, path):
+    """Adds a field path into the tree.
+
+    If the field path to add is a sub-path of an existing field path
+    in the tree (i.e., a leaf node), it means the tree already matches
+    the given path so nothing will be added to the tree. If the path
+    matches an existing non-leaf node in the tree, that non-leaf node
+    will be turned into a leaf node with all its children removed because
+    the path matches all the node's children. Otherwise, a new path will
+    be added.
+
+    Args:
+      path: The field path to add.
+    """
+    node = self._root
+    for name in path.split('.'):
+      if name not in node:
+        node[name] = {}
+      elif not node[name]:
+        # Pre-existing empty node implies we already have this entire tree.
+        return
+      node = node[name]
+    # Remove any sub-trees we might have had.
+    node.clear()
+
+  def ToFieldMask(self, field_mask):
+    """Converts the tree to a FieldMask."""
+    field_mask.Clear()
+    _AddFieldPaths(self._root, '', field_mask)
+
+  def IntersectPath(self, path, intersection):
+    """Calculates the intersection part of a field path with this tree.
+
+    Args:
+      path: The field path to calculates.
+      intersection: The out tree to record the intersection part.
+    """
+    node = self._root
+    for name in path.split('.'):
+      if name not in node:
+        return
+      elif not node[name]:
+        intersection.AddPath(path)
+        return
+      node = node[name]
+    intersection.AddLeafNodes(path, node)
+
+  def AddLeafNodes(self, prefix, node):
+    """Adds leaf nodes begin with prefix to this tree."""
+    if not node:
+      self.AddPath(prefix)
+    for name in node:
+      child_path = prefix + '.' + name
+      self.AddLeafNodes(child_path, node[name])
+
+  def MergeMessage(
+      self, source, destination,
+      replace_message, replace_repeated):
+    """Merge all fields specified by this tree from source to destination."""
+    _MergeMessage(
+        self._root, source, destination, replace_message, replace_repeated)
+
+
+def _StrConvert(value):
+  """Converts value to str if it is not."""
+  # This file is imported by c extension and some methods like ClearField
+  # requires string for the field name. py2/py3 has different text
+  # type and may use unicode.
+  if not isinstance(value, str):
+    return value.encode('utf-8')
+  return value
+
+
+def _MergeMessage(
+    node, source, destination, replace_message, replace_repeated):
+  """Merge all fields specified by a sub-tree from source to destination."""
+  source_descriptor = source.DESCRIPTOR
+  for name in node:
+    child = node[name]
+    field = source_descriptor.fields_by_name[name]
+    if field is None:
+      raise ValueError('Error: Can\'t find field {0} in message {1}.'.format(
+          name, source_descriptor.full_name))
+    if child:
+      # Sub-paths are only allowed for singular message fields.
+      if (field.label == FieldDescriptor.LABEL_REPEATED or
+          field.cpp_type != FieldDescriptor.CPPTYPE_MESSAGE):
+        raise ValueError('Error: Field {0} in message {1} is not a singular '
+                         'message field and cannot have sub-fields.'.format(
+                             name, source_descriptor.full_name))
+      if source.HasField(name):
+        _MergeMessage(
+            child, getattr(source, name), getattr(destination, name),
+            replace_message, replace_repeated)
+      continue
+    if field.label == FieldDescriptor.LABEL_REPEATED:
+      if replace_repeated:
+        destination.ClearField(_StrConvert(name))
+      repeated_source = getattr(source, name)
+      repeated_destination = getattr(destination, name)
+      repeated_destination.MergeFrom(repeated_source)
+    else:
+      if field.cpp_type == FieldDescriptor.CPPTYPE_MESSAGE:
+        if replace_message:
+          destination.ClearField(_StrConvert(name))
+        if source.HasField(name):
+          getattr(destination, name).MergeFrom(getattr(source, name))
+      else:
+        setattr(destination, name, getattr(source, name))
+
+
+def _AddFieldPaths(node, prefix, field_mask):
+  """Adds the field paths descended from node to field_mask."""
+  if not node and prefix:
+    field_mask.paths.append(prefix)
+    return
+  for name in sorted(node):
+    if prefix:
+      child_path = prefix + '.' + name
+    else:
+      child_path = name
+    _AddFieldPaths(node[name], child_path, field_mask)
diff --git a/llm/Lib/site-packages/google/protobuf/internal/message_listener.py b/llm/Lib/site-packages/google/protobuf/internal/message_listener.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff1c127d549dcd8973fdbe67fda09b9ce3460abe
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/message_listener.py
@@ -0,0 +1,55 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Defines a listener interface for observing certain
+state transitions on Message objects.
+
+Also defines a null implementation of this interface.
+"""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+
+class MessageListener(object):
+
+  """Listens for modifications made to a message.  Meant to be registered via
+  Message._SetListener().
+
+  Attributes:
+    dirty:  If True, then calling Modified() would be a no-op.  This can be
+            used to avoid these calls entirely in the common case.
+  """
+
+  def Modified(self):
+    """Called every time the message is modified in such a way that the parent
+    message may need to be updated.  This currently means either:
+    (a) The message was modified for the first time, so the parent message
+        should henceforth mark the message as present.
+    (b) The message's cached byte size became dirty -- i.e. the message was
+        modified for the first time after a previous call to ByteSize().
+        Therefore the parent should also mark its byte size as dirty.
+    Note that (a) implies (b), since new objects start out with a client cached
+    size (zero).  However, we document (a) explicitly because it is important.
+
+    Modified() will *only* be called in response to one of these two events --
+    not every time the sub-message is modified.
+
+    Note that if the listener's |dirty| attribute is true, then calling
+    Modified at the moment would be a no-op, so it can be skipped.  Performance-
+    sensitive callers should check this attribute directly before calling since
+    it will be true most of the time.
+    """
+
+    raise NotImplementedError
+
+
+class NullMessageListener(object):
+
+  """No-op MessageListener implementation."""
+
+  def Modified(self):
+    pass
diff --git a/llm/Lib/site-packages/google/protobuf/internal/python_message.py b/llm/Lib/site-packages/google/protobuf/internal/python_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..40c7764534c121be87da2abb6e7d184c36d74f08
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/python_message.py
@@ -0,0 +1,1546 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+# This code is meant to work on Python 2.4 and above only.
+#
+# TODO: Helpers for verbose, common checks like seeing if a
+# descriptor's cpp_type is CPPTYPE_MESSAGE.
+
+"""Contains a metaclass and helper functions used to create
+protocol message classes from Descriptor objects at runtime.
+
+Recall that a metaclass is the "type" of a class.
+(A class is to a metaclass what an instance is to a class.)
+
+In this case, we use the GeneratedProtocolMessageType metaclass
+to inject all the useful functionality into the classes
+output by the protocol compiler at compile-time.
+
+The upshot of all this is that the real implementation
+details for ALL pure-Python protocol buffers are *here in
+this file*.
+"""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+from io import BytesIO
+import struct
+import sys
+import warnings
+import weakref
+
+from google.protobuf import descriptor as descriptor_mod
+from google.protobuf import message as message_mod
+from google.protobuf import text_format
+# We use "as" to avoid name collisions with variables.
+from google.protobuf.internal import api_implementation
+from google.protobuf.internal import containers
+from google.protobuf.internal import decoder
+from google.protobuf.internal import encoder
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf.internal import extension_dict
+from google.protobuf.internal import message_listener as message_listener_mod
+from google.protobuf.internal import type_checkers
+from google.protobuf.internal import well_known_types
+from google.protobuf.internal import wire_format
+
+_FieldDescriptor = descriptor_mod.FieldDescriptor
+_AnyFullTypeName = 'google.protobuf.Any'
+_ExtensionDict = extension_dict._ExtensionDict
+
+class GeneratedProtocolMessageType(type):
+
+  """Metaclass for protocol message classes created at runtime from Descriptors.
+
+  We add implementations for all methods described in the Message class.  We
+  also create properties to allow getting/setting all fields in the protocol
+  message.  Finally, we create slots to prevent users from accidentally
+  "setting" nonexistent fields in the protocol message, which then wouldn't get
+  serialized / deserialized properly.
+
+  The protocol compiler currently uses this metaclass to create protocol
+  message classes at runtime.  Clients can also manually create their own
+  classes at runtime, as in this example:
+
+  mydescriptor = Descriptor(.....)
+  factory = symbol_database.Default()
+  factory.pool.AddDescriptor(mydescriptor)
+  MyProtoClass = factory.GetPrototype(mydescriptor)
+  myproto_instance = MyProtoClass()
+  myproto.foo_field = 23
+  ...
+  """
+
+  # Must be consistent with the protocol-compiler code in
+  # proto2/compiler/internal/generator.*.
+  _DESCRIPTOR_KEY = 'DESCRIPTOR'
+
+  def __new__(cls, name, bases, dictionary):
+    """Custom allocation for runtime-generated class types.
+
+    We override __new__ because this is apparently the only place
+    where we can meaningfully set __slots__ on the class we're creating(?).
+    (The interplay between metaclasses and slots is not very well-documented).
+
+    Args:
+      name: Name of the class (ignored, but required by the
+        metaclass protocol).
+      bases: Base classes of the class we're constructing.
+        (Should be message.Message).  We ignore this field, but
+        it's required by the metaclass protocol
+      dictionary: The class dictionary of the class we're
+        constructing.  dictionary[_DESCRIPTOR_KEY] must contain
+        a Descriptor object describing this protocol message
+        type.
+
+    Returns:
+      Newly-allocated class.
+
+    Raises:
+      RuntimeError: Generated code only work with python cpp extension.
+    """
+    descriptor = dictionary[GeneratedProtocolMessageType._DESCRIPTOR_KEY]
+
+    if isinstance(descriptor, str):
+      raise RuntimeError('The generated code only work with python cpp '
+                         'extension, but it is using pure python runtime.')
+
+    # If a concrete class already exists for this descriptor, don't try to
+    # create another.  Doing so will break any messages that already exist with
+    # the existing class.
+    #
+    # The C++ implementation appears to have its own internal `PyMessageFactory`
+    # to achieve similar results.
+    #
+    # This most commonly happens in `text_format.py` when using descriptors from
+    # a custom pool; it calls symbol_database.Global().getPrototype() on a
+    # descriptor which already has an existing concrete class.
+    new_class = getattr(descriptor, '_concrete_class', None)
+    if new_class:
+      return new_class
+
+    if descriptor.full_name in well_known_types.WKTBASES:
+      bases += (well_known_types.WKTBASES[descriptor.full_name],)
+    _AddClassAttributesForNestedExtensions(descriptor, dictionary)
+    _AddSlots(descriptor, dictionary)
+
+    superclass = super(GeneratedProtocolMessageType, cls)
+    new_class = superclass.__new__(cls, name, bases, dictionary)
+    return new_class
+
+  def __init__(cls, name, bases, dictionary):
+    """Here we perform the majority of our work on the class.
+    We add enum getters, an __init__ method, implementations
+    of all Message methods, and properties for all fields
+    in the protocol type.
+
+    Args:
+      name: Name of the class (ignored, but required by the
+        metaclass protocol).
+      bases: Base classes of the class we're constructing.
+        (Should be message.Message).  We ignore this field, but
+        it's required by the metaclass protocol
+      dictionary: The class dictionary of the class we're
+        constructing.  dictionary[_DESCRIPTOR_KEY] must contain
+        a Descriptor object describing this protocol message
+        type.
+    """
+    descriptor = dictionary[GeneratedProtocolMessageType._DESCRIPTOR_KEY]
+
+    # If this is an _existing_ class looked up via `_concrete_class` in the
+    # __new__ method above, then we don't need to re-initialize anything.
+    existing_class = getattr(descriptor, '_concrete_class', None)
+    if existing_class:
+      assert existing_class is cls, (
+          'Duplicate `GeneratedProtocolMessageType` created for descriptor %r'
+          % (descriptor.full_name))
+      return
+
+    cls._message_set_decoders_by_tag = {}
+    cls._fields_by_tag = {}
+    if (descriptor.has_options and
+        descriptor.GetOptions().message_set_wire_format):
+      cls._message_set_decoders_by_tag[decoder.MESSAGE_SET_ITEM_TAG] = (
+          decoder.MessageSetItemDecoder(descriptor),
+          None,
+      )
+
+    # Attach stuff to each FieldDescriptor for quick lookup later on.
+    for field in descriptor.fields:
+      _AttachFieldHelpers(cls, field)
+
+    if descriptor.is_extendable and hasattr(descriptor.file, 'pool'):
+      extensions = descriptor.file.pool.FindAllExtensions(descriptor)
+      for ext in extensions:
+        _AttachFieldHelpers(cls, ext)
+
+    descriptor._concrete_class = cls  # pylint: disable=protected-access
+    _AddEnumValues(descriptor, cls)
+    _AddInitMethod(descriptor, cls)
+    _AddPropertiesForFields(descriptor, cls)
+    _AddPropertiesForExtensions(descriptor, cls)
+    _AddStaticMethods(cls)
+    _AddMessageMethods(descriptor, cls)
+    _AddPrivateHelperMethods(descriptor, cls)
+
+    superclass = super(GeneratedProtocolMessageType, cls)
+    superclass.__init__(name, bases, dictionary)
+
+
+# Stateless helpers for GeneratedProtocolMessageType below.
+# Outside clients should not access these directly.
+#
+# I opted not to make any of these methods on the metaclass, to make it more
+# clear that I'm not really using any state there and to keep clients from
+# thinking that they have direct access to these construction helpers.
+
+
+def _PropertyName(proto_field_name):
+  """Returns the name of the public property attribute which
+  clients can use to get and (in some cases) set the value
+  of a protocol message field.
+
+  Args:
+    proto_field_name: The protocol message field name, exactly
+      as it appears (or would appear) in a .proto file.
+  """
+  # TODO: Escape Python keywords (e.g., yield), and test this support.
+  # nnorwitz makes my day by writing:
+  # """
+  # FYI.  See the keyword module in the stdlib. This could be as simple as:
+  #
+  # if keyword.iskeyword(proto_field_name):
+  #   return proto_field_name + "_"
+  # return proto_field_name
+  # """
+  # Kenton says:  The above is a BAD IDEA.  People rely on being able to use
+  #   getattr() and setattr() to reflectively manipulate field values.  If we
+  #   rename the properties, then every such user has to also make sure to apply
+  #   the same transformation.  Note that currently if you name a field "yield",
+  #   you can still access it just fine using getattr/setattr -- it's not even
+  #   that cumbersome to do so.
+  # TODO:  Remove this method entirely if/when everyone agrees with my
+  #   position.
+  return proto_field_name
+
+
+def _AddSlots(message_descriptor, dictionary):
+  """Adds a __slots__ entry to dictionary, containing the names of all valid
+  attributes for this message type.
+
+  Args:
+    message_descriptor: A Descriptor instance describing this message type.
+    dictionary: Class dictionary to which we'll add a '__slots__' entry.
+  """
+  dictionary['__slots__'] = ['_cached_byte_size',
+                             '_cached_byte_size_dirty',
+                             '_fields',
+                             '_unknown_fields',
+                             '_unknown_field_set',
+                             '_is_present_in_parent',
+                             '_listener',
+                             '_listener_for_children',
+                             '__weakref__',
+                             '_oneofs']
+
+
+def _IsMessageSetExtension(field):
+  return (field.is_extension and
+          field.containing_type.has_options and
+          field.containing_type.GetOptions().message_set_wire_format and
+          field.type == _FieldDescriptor.TYPE_MESSAGE and
+          field.label == _FieldDescriptor.LABEL_OPTIONAL)
+
+
+def _IsMapField(field):
+  return (field.type == _FieldDescriptor.TYPE_MESSAGE and
+          field.message_type._is_map_entry)
+
+
+def _IsMessageMapField(field):
+  value_type = field.message_type.fields_by_name['value']
+  return value_type.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE
+
+def _AttachFieldHelpers(cls, field_descriptor):
+  is_repeated = field_descriptor.label == _FieldDescriptor.LABEL_REPEATED
+  field_descriptor._default_constructor = _DefaultValueConstructorForField(
+      field_descriptor
+  )
+
+  def AddFieldByTag(wiretype, is_packed):
+    tag_bytes = encoder.TagBytes(field_descriptor.number, wiretype)
+    cls._fields_by_tag[tag_bytes] = (field_descriptor, is_packed)
+
+  AddFieldByTag(
+      type_checkers.FIELD_TYPE_TO_WIRE_TYPE[field_descriptor.type], False
+  )
+
+  if is_repeated and wire_format.IsTypePackable(field_descriptor.type):
+    # To support wire compatibility of adding packed = true, add a decoder for
+    # packed values regardless of the field's options.
+    AddFieldByTag(wire_format.WIRETYPE_LENGTH_DELIMITED, True)
+
+
+def _MaybeAddEncoder(cls, field_descriptor):
+  if hasattr(field_descriptor, '_encoder'):
+    return
+  is_repeated = (field_descriptor.label == _FieldDescriptor.LABEL_REPEATED)
+  is_map_entry = _IsMapField(field_descriptor)
+  is_packed = field_descriptor.is_packed
+
+  if is_map_entry:
+    field_encoder = encoder.MapEncoder(field_descriptor)
+    sizer = encoder.MapSizer(field_descriptor,
+                             _IsMessageMapField(field_descriptor))
+  elif _IsMessageSetExtension(field_descriptor):
+    field_encoder = encoder.MessageSetItemEncoder(field_descriptor.number)
+    sizer = encoder.MessageSetItemSizer(field_descriptor.number)
+  else:
+    field_encoder = type_checkers.TYPE_TO_ENCODER[field_descriptor.type](
+        field_descriptor.number, is_repeated, is_packed)
+    sizer = type_checkers.TYPE_TO_SIZER[field_descriptor.type](
+        field_descriptor.number, is_repeated, is_packed)
+
+  field_descriptor._sizer = sizer
+  field_descriptor._encoder = field_encoder
+
+
+def _MaybeAddDecoder(cls, field_descriptor):
+  if hasattr(field_descriptor, '_decoders'):
+    return
+
+  is_repeated = field_descriptor.label == _FieldDescriptor.LABEL_REPEATED
+  is_map_entry = _IsMapField(field_descriptor)
+  helper_decoders = {}
+
+  def AddDecoder(is_packed):
+    decode_type = field_descriptor.type
+    if (decode_type == _FieldDescriptor.TYPE_ENUM and
+        not field_descriptor.enum_type.is_closed):
+      decode_type = _FieldDescriptor.TYPE_INT32
+
+    oneof_descriptor = None
+    if field_descriptor.containing_oneof is not None:
+      oneof_descriptor = field_descriptor
+
+    if is_map_entry:
+      is_message_map = _IsMessageMapField(field_descriptor)
+
+      field_decoder = decoder.MapDecoder(
+          field_descriptor, _GetInitializeDefaultForMap(field_descriptor),
+          is_message_map)
+    elif decode_type == _FieldDescriptor.TYPE_STRING:
+      field_decoder = decoder.StringDecoder(
+          field_descriptor.number, is_repeated, is_packed,
+          field_descriptor, field_descriptor._default_constructor,
+          not field_descriptor.has_presence)
+    elif field_descriptor.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+      field_decoder = type_checkers.TYPE_TO_DECODER[decode_type](
+          field_descriptor.number, is_repeated, is_packed,
+          field_descriptor, field_descriptor._default_constructor)
+    else:
+      field_decoder = type_checkers.TYPE_TO_DECODER[decode_type](
+          field_descriptor.number, is_repeated, is_packed,
+          # pylint: disable=protected-access
+          field_descriptor, field_descriptor._default_constructor,
+          not field_descriptor.has_presence)
+
+    helper_decoders[is_packed] = field_decoder
+
+  AddDecoder(False)
+
+  if is_repeated and wire_format.IsTypePackable(field_descriptor.type):
+    # To support wire compatibility of adding packed = true, add a decoder for
+    # packed values regardless of the field's options.
+    AddDecoder(True)
+
+  field_descriptor._decoders = helper_decoders
+
+
+def _AddClassAttributesForNestedExtensions(descriptor, dictionary):
+  extensions = descriptor.extensions_by_name
+  for extension_name, extension_field in extensions.items():
+    assert extension_name not in dictionary
+    dictionary[extension_name] = extension_field
+
+
+def _AddEnumValues(descriptor, cls):
+  """Sets class-level attributes for all enum fields defined in this message.
+
+  Also exporting a class-level object that can name enum values.
+
+  Args:
+    descriptor: Descriptor object for this message type.
+    cls: Class we're constructing for this message type.
+  """
+  for enum_type in descriptor.enum_types:
+    setattr(cls, enum_type.name, enum_type_wrapper.EnumTypeWrapper(enum_type))
+    for enum_value in enum_type.values:
+      setattr(cls, enum_value.name, enum_value.number)
+
+
+def _GetInitializeDefaultForMap(field):
+  if field.label != _FieldDescriptor.LABEL_REPEATED:
+    raise ValueError('map_entry set on non-repeated field %s' % (
+        field.name))
+  fields_by_name = field.message_type.fields_by_name
+  key_checker = type_checkers.GetTypeChecker(fields_by_name['key'])
+
+  value_field = fields_by_name['value']
+  if _IsMessageMapField(field):
+    def MakeMessageMapDefault(message):
+      return containers.MessageMap(
+          message._listener_for_children, value_field.message_type, key_checker,
+          field.message_type)
+    return MakeMessageMapDefault
+  else:
+    value_checker = type_checkers.GetTypeChecker(value_field)
+    def MakePrimitiveMapDefault(message):
+      return containers.ScalarMap(
+          message._listener_for_children, key_checker, value_checker,
+          field.message_type)
+    return MakePrimitiveMapDefault
+
+def _DefaultValueConstructorForField(field):
+  """Returns a function which returns a default value for a field.
+
+  Args:
+    field: FieldDescriptor object for this field.
+
+  The returned function has one argument:
+    message: Message instance containing this field, or a weakref proxy
+      of same.
+
+  That function in turn returns a default value for this field.  The default
+    value may refer back to |message| via a weak reference.
+  """
+
+  if _IsMapField(field):
+    return _GetInitializeDefaultForMap(field)
+
+  if field.label == _FieldDescriptor.LABEL_REPEATED:
+    if field.has_default_value and field.default_value != []:
+      raise ValueError('Repeated field default value not empty list: %s' % (
+          field.default_value))
+    if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+      # We can't look at _concrete_class yet since it might not have
+      # been set.  (Depends on order in which we initialize the classes).
+      message_type = field.message_type
+      def MakeRepeatedMessageDefault(message):
+        return containers.RepeatedCompositeFieldContainer(
+            message._listener_for_children, field.message_type)
+      return MakeRepeatedMessageDefault
+    else:
+      type_checker = type_checkers.GetTypeChecker(field)
+      def MakeRepeatedScalarDefault(message):
+        return containers.RepeatedScalarFieldContainer(
+            message._listener_for_children, type_checker)
+      return MakeRepeatedScalarDefault
+
+  if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+    message_type = field.message_type
+    def MakeSubMessageDefault(message):
+      # _concrete_class may not yet be initialized.
+      if not hasattr(message_type, '_concrete_class'):
+        from google.protobuf import message_factory
+        message_factory.GetMessageClass(message_type)
+      result = message_type._concrete_class()
+      result._SetListener(
+          _OneofListener(message, field)
+          if field.containing_oneof is not None
+          else message._listener_for_children)
+      return result
+    return MakeSubMessageDefault
+
+  def MakeScalarDefault(message):
+    # TODO: This may be broken since there may not be
+    # default_value.  Combine with has_default_value somehow.
+    return field.default_value
+  return MakeScalarDefault
+
+
+def _ReraiseTypeErrorWithFieldName(message_name, field_name):
+  """Re-raise the currently-handled TypeError with the field name added."""
+  exc = sys.exc_info()[1]
+  if len(exc.args) == 1 and type(exc) is TypeError:
+    # simple TypeError; add field name to exception message
+    exc = TypeError('%s for field %s.%s' % (str(exc), message_name, field_name))
+
+  # re-raise possibly-amended exception with original traceback:
+  raise exc.with_traceback(sys.exc_info()[2])
+
+
+def _AddInitMethod(message_descriptor, cls):
+  """Adds an __init__ method to cls."""
+
+  def _GetIntegerEnumValue(enum_type, value):
+    """Convert a string or integer enum value to an integer.
+
+    If the value is a string, it is converted to the enum value in
+    enum_type with the same name.  If the value is not a string, it's
+    returned as-is.  (No conversion or bounds-checking is done.)
+    """
+    if isinstance(value, str):
+      try:
+        return enum_type.values_by_name[value].number
+      except KeyError:
+        raise ValueError('Enum type %s: unknown label "%s"' % (
+            enum_type.full_name, value))
+    return value
+
+  def init(self, **kwargs):
+    self._cached_byte_size = 0
+    self._cached_byte_size_dirty = len(kwargs) > 0
+    self._fields = {}
+    # Contains a mapping from oneof field descriptors to the descriptor
+    # of the currently set field in that oneof field.
+    self._oneofs = {}
+
+    # _unknown_fields is () when empty for efficiency, and will be turned into
+    # a list if fields are added.
+    self._unknown_fields = ()
+    # _unknown_field_set is None when empty for efficiency, and will be
+    # turned into UnknownFieldSet struct if fields are added.
+    self._unknown_field_set = None      # pylint: disable=protected-access
+    self._is_present_in_parent = False
+    self._listener = message_listener_mod.NullMessageListener()
+    self._listener_for_children = _Listener(self)
+    for field_name, field_value in kwargs.items():
+      field = _GetFieldByName(message_descriptor, field_name)
+      if field is None:
+        raise TypeError('%s() got an unexpected keyword argument "%s"' %
+                        (message_descriptor.name, field_name))
+      if field_value is None:
+        # field=None is the same as no field at all.
+        continue
+      if field.label == _FieldDescriptor.LABEL_REPEATED:
+        copy = field._default_constructor(self)
+        if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:  # Composite
+          if _IsMapField(field):
+            if _IsMessageMapField(field):
+              for key in field_value:
+                copy[key].MergeFrom(field_value[key])
+            else:
+              copy.update(field_value)
+          else:
+            for val in field_value:
+              if isinstance(val, dict):
+                copy.add(**val)
+              else:
+                copy.add().MergeFrom(val)
+        else:  # Scalar
+          if field.cpp_type == _FieldDescriptor.CPPTYPE_ENUM:
+            field_value = [_GetIntegerEnumValue(field.enum_type, val)
+                           for val in field_value]
+          copy.extend(field_value)
+        self._fields[field] = copy
+      elif field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+        copy = field._default_constructor(self)
+        new_val = field_value
+        if isinstance(field_value, dict):
+          new_val = field.message_type._concrete_class(**field_value)
+        try:
+          copy.MergeFrom(new_val)
+        except TypeError:
+          _ReraiseTypeErrorWithFieldName(message_descriptor.name, field_name)
+        self._fields[field] = copy
+      else:
+        if field.cpp_type == _FieldDescriptor.CPPTYPE_ENUM:
+          field_value = _GetIntegerEnumValue(field.enum_type, field_value)
+        try:
+          setattr(self, field_name, field_value)
+        except TypeError:
+          _ReraiseTypeErrorWithFieldName(message_descriptor.name, field_name)
+
+  init.__module__ = None
+  init.__doc__ = None
+  cls.__init__ = init
+
+
+def _GetFieldByName(message_descriptor, field_name):
+  """Returns a field descriptor by field name.
+
+  Args:
+    message_descriptor: A Descriptor describing all fields in message.
+    field_name: The name of the field to retrieve.
+  Returns:
+    The field descriptor associated with the field name.
+  """
+  try:
+    return message_descriptor.fields_by_name[field_name]
+  except KeyError:
+    raise ValueError('Protocol message %s has no "%s" field.' %
+                     (message_descriptor.name, field_name))
+
+
+def _AddPropertiesForFields(descriptor, cls):
+  """Adds properties for all fields in this protocol message type."""
+  for field in descriptor.fields:
+    _AddPropertiesForField(field, cls)
+
+  if descriptor.is_extendable:
+    # _ExtensionDict is just an adaptor with no state so we allocate a new one
+    # every time it is accessed.
+    cls.Extensions = property(lambda self: _ExtensionDict(self))
+
+
+def _AddPropertiesForField(field, cls):
+  """Adds a public property for a protocol message field.
+  Clients can use this property to get and (in the case
+  of non-repeated scalar fields) directly set the value
+  of a protocol message field.
+
+  Args:
+    field: A FieldDescriptor for this field.
+    cls: The class we're constructing.
+  """
+  # Catch it if we add other types that we should
+  # handle specially here.
+  assert _FieldDescriptor.MAX_CPPTYPE == 10
+
+  constant_name = field.name.upper() + '_FIELD_NUMBER'
+  setattr(cls, constant_name, field.number)
+
+  if field.label == _FieldDescriptor.LABEL_REPEATED:
+    _AddPropertiesForRepeatedField(field, cls)
+  elif field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+    _AddPropertiesForNonRepeatedCompositeField(field, cls)
+  else:
+    _AddPropertiesForNonRepeatedScalarField(field, cls)
+
+
+class _FieldProperty(property):
+  __slots__ = ('DESCRIPTOR',)
+
+  def __init__(self, descriptor, getter, setter, doc):
+    property.__init__(self, getter, setter, doc=doc)
+    self.DESCRIPTOR = descriptor
+
+
+def _AddPropertiesForRepeatedField(field, cls):
+  """Adds a public property for a "repeated" protocol message field.  Clients
+  can use this property to get the value of the field, which will be either a
+  RepeatedScalarFieldContainer or RepeatedCompositeFieldContainer (see
+  below).
+
+  Note that when clients add values to these containers, we perform
+  type-checking in the case of repeated scalar fields, and we also set any
+  necessary "has" bits as a side-effect.
+
+  Args:
+    field: A FieldDescriptor for this field.
+    cls: The class we're constructing.
+  """
+  proto_field_name = field.name
+  property_name = _PropertyName(proto_field_name)
+
+  def getter(self):
+    field_value = self._fields.get(field)
+    if field_value is None:
+      # Construct a new object to represent this field.
+      field_value = field._default_constructor(self)
+
+      # Atomically check if another thread has preempted us and, if not, swap
+      # in the new object we just created.  If someone has preempted us, we
+      # take that object and discard ours.
+      # WARNING:  We are relying on setdefault() being atomic.  This is true
+      #   in CPython but we haven't investigated others.  This warning appears
+      #   in several other locations in this file.
+      field_value = self._fields.setdefault(field, field_value)
+    return field_value
+  getter.__module__ = None
+  getter.__doc__ = 'Getter for %s.' % proto_field_name
+
+  # We define a setter just so we can throw an exception with a more
+  # helpful error message.
+  def setter(self, new_value):
+    raise AttributeError('Assignment not allowed to repeated field '
+                         '"%s" in protocol message object.' % proto_field_name)
+
+  doc = 'Magic attribute generated for "%s" proto field.' % proto_field_name
+  setattr(cls, property_name, _FieldProperty(field, getter, setter, doc=doc))
+
+
+def _AddPropertiesForNonRepeatedScalarField(field, cls):
+  """Adds a public property for a nonrepeated, scalar protocol message field.
+  Clients can use this property to get and directly set the value of the field.
+  Note that when the client sets the value of a field by using this property,
+  all necessary "has" bits are set as a side-effect, and we also perform
+  type-checking.
+
+  Args:
+    field: A FieldDescriptor for this field.
+    cls: The class we're constructing.
+  """
+  proto_field_name = field.name
+  property_name = _PropertyName(proto_field_name)
+  type_checker = type_checkers.GetTypeChecker(field)
+  default_value = field.default_value
+
+  def getter(self):
+    # TODO: This may be broken since there may not be
+    # default_value.  Combine with has_default_value somehow.
+    return self._fields.get(field, default_value)
+  getter.__module__ = None
+  getter.__doc__ = 'Getter for %s.' % proto_field_name
+
+  def field_setter(self, new_value):
+    # pylint: disable=protected-access
+    # Testing the value for truthiness captures all of the proto3 defaults
+    # (0, 0.0, enum 0, and False).
+    try:
+      new_value = type_checker.CheckValue(new_value)
+    except TypeError as e:
+      raise TypeError(
+          'Cannot set %s to %.1024r: %s' % (field.full_name, new_value, e))
+    if not field.has_presence and not new_value:
+      self._fields.pop(field, None)
+    else:
+      self._fields[field] = new_value
+    # Check _cached_byte_size_dirty inline to improve performance, since scalar
+    # setters are called frequently.
+    if not self._cached_byte_size_dirty:
+      self._Modified()
+
+  if field.containing_oneof:
+    def setter(self, new_value):
+      field_setter(self, new_value)
+      self._UpdateOneofState(field)
+  else:
+    setter = field_setter
+
+  setter.__module__ = None
+  setter.__doc__ = 'Setter for %s.' % proto_field_name
+
+  # Add a property to encapsulate the getter/setter.
+  doc = 'Magic attribute generated for "%s" proto field.' % proto_field_name
+  setattr(cls, property_name, _FieldProperty(field, getter, setter, doc=doc))
+
+
+def _AddPropertiesForNonRepeatedCompositeField(field, cls):
+  """Adds a public property for a nonrepeated, composite protocol message field.
+  A composite field is a "group" or "message" field.
+
+  Clients can use this property to get the value of the field, but cannot
+  assign to the property directly.
+
+  Args:
+    field: A FieldDescriptor for this field.
+    cls: The class we're constructing.
+  """
+  # TODO: Remove duplication with similar method
+  # for non-repeated scalars.
+  proto_field_name = field.name
+  property_name = _PropertyName(proto_field_name)
+
+  def getter(self):
+    field_value = self._fields.get(field)
+    if field_value is None:
+      # Construct a new object to represent this field.
+      field_value = field._default_constructor(self)
+
+      # Atomically check if another thread has preempted us and, if not, swap
+      # in the new object we just created.  If someone has preempted us, we
+      # take that object and discard ours.
+      # WARNING:  We are relying on setdefault() being atomic.  This is true
+      #   in CPython but we haven't investigated others.  This warning appears
+      #   in several other locations in this file.
+      field_value = self._fields.setdefault(field, field_value)
+    return field_value
+  getter.__module__ = None
+  getter.__doc__ = 'Getter for %s.' % proto_field_name
+
+  # We define a setter just so we can throw an exception with a more
+  # helpful error message.
+  def setter(self, new_value):
+    raise AttributeError('Assignment not allowed to composite field '
+                         '"%s" in protocol message object.' % proto_field_name)
+
+  # Add a property to encapsulate the getter.
+  doc = 'Magic attribute generated for "%s" proto field.' % proto_field_name
+  setattr(cls, property_name, _FieldProperty(field, getter, setter, doc=doc))
+
+
+def _AddPropertiesForExtensions(descriptor, cls):
+  """Adds properties for all fields in this protocol message type."""
+  extensions = descriptor.extensions_by_name
+  for extension_name, extension_field in extensions.items():
+    constant_name = extension_name.upper() + '_FIELD_NUMBER'
+    setattr(cls, constant_name, extension_field.number)
+
+  # TODO: Migrate all users of these attributes to functions like
+  #   pool.FindExtensionByNumber(descriptor).
+  if descriptor.file is not None:
+    # TODO: Use cls.MESSAGE_FACTORY.pool when available.
+    pool = descriptor.file.pool
+
+def _AddStaticMethods(cls):
+  # TODO: This probably needs to be thread-safe(?)
+  def RegisterExtension(field_descriptor):
+    field_descriptor.containing_type = cls.DESCRIPTOR
+    # TODO: Use cls.MESSAGE_FACTORY.pool when available.
+    # pylint: disable=protected-access
+    cls.DESCRIPTOR.file.pool._AddExtensionDescriptor(field_descriptor)
+    _AttachFieldHelpers(cls, field_descriptor)
+  cls.RegisterExtension = staticmethod(RegisterExtension)
+
+  def FromString(s):
+    message = cls()
+    message.MergeFromString(s)
+    return message
+  cls.FromString = staticmethod(FromString)
+
+
+def _IsPresent(item):
+  """Given a (FieldDescriptor, value) tuple from _fields, return true if the
+  value should be included in the list returned by ListFields()."""
+
+  if item[0].label == _FieldDescriptor.LABEL_REPEATED:
+    return bool(item[1])
+  elif item[0].cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+    return item[1]._is_present_in_parent
+  else:
+    return True
+
+
+def _AddListFieldsMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+
+  def ListFields(self):
+    all_fields = [item for item in self._fields.items() if _IsPresent(item)]
+    all_fields.sort(key = lambda item: item[0].number)
+    return all_fields
+
+  cls.ListFields = ListFields
+
+
+def _AddHasFieldMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+
+  hassable_fields = {}
+  for field in message_descriptor.fields:
+    if field.label == _FieldDescriptor.LABEL_REPEATED:
+      continue
+    # For proto3, only submessages and fields inside a oneof have presence.
+    if not field.has_presence:
+      continue
+    hassable_fields[field.name] = field
+
+  # Has methods are supported for oneof descriptors.
+  for oneof in message_descriptor.oneofs:
+    hassable_fields[oneof.name] = oneof
+
+  def HasField(self, field_name):
+    try:
+      field = hassable_fields[field_name]
+    except KeyError as exc:
+      raise ValueError('Protocol message %s has no non-repeated field "%s" '
+                       'nor has presence is not available for this field.' % (
+                           message_descriptor.full_name, field_name)) from exc
+
+    if isinstance(field, descriptor_mod.OneofDescriptor):
+      try:
+        return HasField(self, self._oneofs[field].name)
+      except KeyError:
+        return False
+    else:
+      if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+        value = self._fields.get(field)
+        return value is not None and value._is_present_in_parent
+      else:
+        return field in self._fields
+
+  cls.HasField = HasField
+
+
+def _AddClearFieldMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+  def ClearField(self, field_name):
+    try:
+      field = message_descriptor.fields_by_name[field_name]
+    except KeyError:
+      try:
+        field = message_descriptor.oneofs_by_name[field_name]
+        if field in self._oneofs:
+          field = self._oneofs[field]
+        else:
+          return
+      except KeyError:
+        raise ValueError('Protocol message %s has no "%s" field.' %
+                         (message_descriptor.name, field_name))
+
+    if field in self._fields:
+      # To match the C++ implementation, we need to invalidate iterators
+      # for map fields when ClearField() happens.
+      if hasattr(self._fields[field], 'InvalidateIterators'):
+        self._fields[field].InvalidateIterators()
+
+      # Note:  If the field is a sub-message, its listener will still point
+      #   at us.  That's fine, because the worst than can happen is that it
+      #   will call _Modified() and invalidate our byte size.  Big deal.
+      del self._fields[field]
+
+      if self._oneofs.get(field.containing_oneof, None) is field:
+        del self._oneofs[field.containing_oneof]
+
+    # Always call _Modified() -- even if nothing was changed, this is
+    # a mutating method, and thus calling it should cause the field to become
+    # present in the parent message.
+    self._Modified()
+
+  cls.ClearField = ClearField
+
+
+def _AddClearExtensionMethod(cls):
+  """Helper for _AddMessageMethods()."""
+  def ClearExtension(self, field_descriptor):
+    extension_dict._VerifyExtensionHandle(self, field_descriptor)
+
+    # Similar to ClearField(), above.
+    if field_descriptor in self._fields:
+      del self._fields[field_descriptor]
+    self._Modified()
+  cls.ClearExtension = ClearExtension
+
+
+def _AddHasExtensionMethod(cls):
+  """Helper for _AddMessageMethods()."""
+  def HasExtension(self, field_descriptor):
+    extension_dict._VerifyExtensionHandle(self, field_descriptor)
+    if field_descriptor.label == _FieldDescriptor.LABEL_REPEATED:
+      raise KeyError('"%s" is repeated.' % field_descriptor.full_name)
+
+    if field_descriptor.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+      value = self._fields.get(field_descriptor)
+      return value is not None and value._is_present_in_parent
+    else:
+      return field_descriptor in self._fields
+  cls.HasExtension = HasExtension
+
+def _InternalUnpackAny(msg):
+  """Unpacks Any message and returns the unpacked message.
+
+  This internal method is different from public Any Unpack method which takes
+  the target message as argument. _InternalUnpackAny method does not have
+  target message type and need to find the message type in descriptor pool.
+
+  Args:
+    msg: An Any message to be unpacked.
+
+  Returns:
+    The unpacked message.
+  """
+  # TODO: Don't use the factory of generated messages.
+  # To make Any work with custom factories, use the message factory of the
+  # parent message.
+  # pylint: disable=g-import-not-at-top
+  from google.protobuf import symbol_database
+  factory = symbol_database.Default()
+
+  type_url = msg.type_url
+
+  if not type_url:
+    return None
+
+  # TODO: For now we just strip the hostname.  Better logic will be
+  # required.
+  type_name = type_url.split('/')[-1]
+  descriptor = factory.pool.FindMessageTypeByName(type_name)
+
+  if descriptor is None:
+    return None
+
+  message_class = factory.GetPrototype(descriptor)
+  message = message_class()
+
+  message.ParseFromString(msg.value)
+  return message
+
+
+def _AddEqualsMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+  def __eq__(self, other):
+    if (not isinstance(other, message_mod.Message) or
+        other.DESCRIPTOR != self.DESCRIPTOR):
+      return NotImplemented
+
+    if self is other:
+      return True
+
+    if self.DESCRIPTOR.full_name == _AnyFullTypeName:
+      any_a = _InternalUnpackAny(self)
+      any_b = _InternalUnpackAny(other)
+      if any_a and any_b:
+        return any_a == any_b
+
+    if not self.ListFields() == other.ListFields():
+      return False
+
+    # TODO: Fix UnknownFieldSet to consider MessageSet extensions,
+    # then use it for the comparison.
+    unknown_fields = list(self._unknown_fields)
+    unknown_fields.sort()
+    other_unknown_fields = list(other._unknown_fields)
+    other_unknown_fields.sort()
+    return unknown_fields == other_unknown_fields
+
+  cls.__eq__ = __eq__
+
+
+def _AddStrMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+  def __str__(self):
+    return text_format.MessageToString(self)
+  cls.__str__ = __str__
+
+
+def _AddReprMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+  def __repr__(self):
+    return text_format.MessageToString(self)
+  cls.__repr__ = __repr__
+
+
+def _AddUnicodeMethod(unused_message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+
+  def __unicode__(self):
+    return text_format.MessageToString(self, as_utf8=True).decode('utf-8')
+  cls.__unicode__ = __unicode__
+
+
+def _BytesForNonRepeatedElement(value, field_number, field_type):
+  """Returns the number of bytes needed to serialize a non-repeated element.
+  The returned byte count includes space for tag information and any
+  other additional space associated with serializing value.
+
+  Args:
+    value: Value we're serializing.
+    field_number: Field number of this value.  (Since the field number
+      is stored as part of a varint-encoded tag, this has an impact
+      on the total bytes required to serialize the value).
+    field_type: The type of the field.  One of the TYPE_* constants
+      within FieldDescriptor.
+  """
+  try:
+    fn = type_checkers.TYPE_TO_BYTE_SIZE_FN[field_type]
+    return fn(field_number, value)
+  except KeyError:
+    raise message_mod.EncodeError('Unrecognized field type: %d' % field_type)
+
+
+def _AddByteSizeMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+
+  def ByteSize(self):
+    if not self._cached_byte_size_dirty:
+      return self._cached_byte_size
+
+    size = 0
+    descriptor = self.DESCRIPTOR
+    if descriptor._is_map_entry:
+      # Fields of map entry should always be serialized.
+      key_field = descriptor.fields_by_name['key']
+      _MaybeAddEncoder(cls, key_field)
+      size = key_field._sizer(self.key)
+      value_field = descriptor.fields_by_name['value']
+      _MaybeAddEncoder(cls, value_field)
+      size += value_field._sizer(self.value)
+    else:
+      for field_descriptor, field_value in self.ListFields():
+        _MaybeAddEncoder(cls, field_descriptor)
+        size += field_descriptor._sizer(field_value)
+      for tag_bytes, value_bytes in self._unknown_fields:
+        size += len(tag_bytes) + len(value_bytes)
+
+    self._cached_byte_size = size
+    self._cached_byte_size_dirty = False
+    self._listener_for_children.dirty = False
+    return size
+
+  cls.ByteSize = ByteSize
+
+
+def _AddSerializeToStringMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+
+  def SerializeToString(self, **kwargs):
+    # Check if the message has all of its required fields set.
+    if not self.IsInitialized():
+      raise message_mod.EncodeError(
+          'Message %s is missing required fields: %s' % (
+          self.DESCRIPTOR.full_name, ','.join(self.FindInitializationErrors())))
+    return self.SerializePartialToString(**kwargs)
+  cls.SerializeToString = SerializeToString
+
+
+def _AddSerializePartialToStringMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+
+  def SerializePartialToString(self, **kwargs):
+    out = BytesIO()
+    self._InternalSerialize(out.write, **kwargs)
+    return out.getvalue()
+  cls.SerializePartialToString = SerializePartialToString
+
+  def InternalSerialize(self, write_bytes, deterministic=None):
+    if deterministic is None:
+      deterministic = (
+          api_implementation.IsPythonDefaultSerializationDeterministic())
+    else:
+      deterministic = bool(deterministic)
+
+    descriptor = self.DESCRIPTOR
+    if descriptor._is_map_entry:
+      # Fields of map entry should always be serialized.
+      key_field = descriptor.fields_by_name['key']
+      _MaybeAddEncoder(cls, key_field)
+      key_field._encoder(write_bytes, self.key, deterministic)
+      value_field = descriptor.fields_by_name['value']
+      _MaybeAddEncoder(cls, value_field)
+      value_field._encoder(write_bytes, self.value, deterministic)
+    else:
+      for field_descriptor, field_value in self.ListFields():
+        _MaybeAddEncoder(cls, field_descriptor)
+        field_descriptor._encoder(write_bytes, field_value, deterministic)
+      for tag_bytes, value_bytes in self._unknown_fields:
+        write_bytes(tag_bytes)
+        write_bytes(value_bytes)
+  cls._InternalSerialize = InternalSerialize
+
+
+def _AddMergeFromStringMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+  def MergeFromString(self, serialized):
+    serialized = memoryview(serialized)
+    length = len(serialized)
+    try:
+      if self._InternalParse(serialized, 0, length) != length:
+        # The only reason _InternalParse would return early is if it
+        # encountered an end-group tag.
+        raise message_mod.DecodeError('Unexpected end-group tag.')
+    except (IndexError, TypeError):
+      # Now ord(buf[p:p+1]) == ord('') gets TypeError.
+      raise message_mod.DecodeError('Truncated message.')
+    except struct.error as e:
+      raise message_mod.DecodeError(e)
+    return length   # Return this for legacy reasons.
+  cls.MergeFromString = MergeFromString
+
+  local_ReadTag = decoder.ReadTag
+  local_SkipField = decoder.SkipField
+  fields_by_tag = cls._fields_by_tag
+  message_set_decoders_by_tag = cls._message_set_decoders_by_tag
+
+  def InternalParse(self, buffer, pos, end):
+    """Create a message from serialized bytes.
+
+    Args:
+      self: Message, instance of the proto message object.
+      buffer: memoryview of the serialized data.
+      pos: int, position to start in the serialized data.
+      end: int, end position of the serialized data.
+
+    Returns:
+      Message object.
+    """
+    # Guard against internal misuse, since this function is called internally
+    # quite extensively, and its easy to accidentally pass bytes.
+    assert isinstance(buffer, memoryview)
+    self._Modified()
+    field_dict = self._fields
+    # pylint: disable=protected-access
+    unknown_field_set = self._unknown_field_set
+    while pos != end:
+      (tag_bytes, new_pos) = local_ReadTag(buffer, pos)
+      field_decoder, field_des = message_set_decoders_by_tag.get(
+          tag_bytes, (None, None)
+      )
+      if field_decoder:
+        pos = field_decoder(buffer, new_pos, end, self, field_dict)
+        continue
+      field_des, is_packed = fields_by_tag.get(tag_bytes, (None, None))
+      if field_des is None:
+        if not self._unknown_fields:   # pylint: disable=protected-access
+          self._unknown_fields = []    # pylint: disable=protected-access
+        if unknown_field_set is None:
+          # pylint: disable=protected-access
+          self._unknown_field_set = containers.UnknownFieldSet()
+          # pylint: disable=protected-access
+          unknown_field_set = self._unknown_field_set
+        # pylint: disable=protected-access
+        (tag, _) = decoder._DecodeVarint(tag_bytes, 0)
+        field_number, wire_type = wire_format.UnpackTag(tag)
+        if field_number == 0:
+          raise message_mod.DecodeError('Field number 0 is illegal.')
+        # TODO: remove old_pos.
+        old_pos = new_pos
+        (data, new_pos) = decoder._DecodeUnknownField(
+            buffer, new_pos, wire_type)  # pylint: disable=protected-access
+        if new_pos == -1:
+          return pos
+        # pylint: disable=protected-access
+        unknown_field_set._add(field_number, wire_type, data)
+        # TODO: remove _unknown_fields.
+        new_pos = local_SkipField(buffer, old_pos, end, tag_bytes)
+        if new_pos == -1:
+          return pos
+        self._unknown_fields.append(
+            (tag_bytes, buffer[old_pos:new_pos].tobytes()))
+        pos = new_pos
+      else:
+        _MaybeAddDecoder(cls, field_des)
+        field_decoder = field_des._decoders[is_packed]
+        pos = field_decoder(buffer, new_pos, end, self, field_dict)
+        if field_des.containing_oneof:
+          self._UpdateOneofState(field_des)
+    return pos
+  cls._InternalParse = InternalParse
+
+
+def _AddIsInitializedMethod(message_descriptor, cls):
+  """Adds the IsInitialized and FindInitializationError methods to the
+  protocol message class."""
+
+  required_fields = [field for field in message_descriptor.fields
+                           if field.label == _FieldDescriptor.LABEL_REQUIRED]
+
+  def IsInitialized(self, errors=None):
+    """Checks if all required fields of a message are set.
+
+    Args:
+      errors:  A list which, if provided, will be populated with the field
+               paths of all missing required fields.
+
+    Returns:
+      True iff the specified message has all required fields set.
+    """
+
+    # Performance is critical so we avoid HasField() and ListFields().
+
+    for field in required_fields:
+      if (field not in self._fields or
+          (field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE and
+           not self._fields[field]._is_present_in_parent)):
+        if errors is not None:
+          errors.extend(self.FindInitializationErrors())
+        return False
+
+    for field, value in list(self._fields.items()):  # dict can change size!
+      if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+        if field.label == _FieldDescriptor.LABEL_REPEATED:
+          if (field.message_type._is_map_entry):
+            continue
+          for element in value:
+            if not element.IsInitialized():
+              if errors is not None:
+                errors.extend(self.FindInitializationErrors())
+              return False
+        elif value._is_present_in_parent and not value.IsInitialized():
+          if errors is not None:
+            errors.extend(self.FindInitializationErrors())
+          return False
+
+    return True
+
+  cls.IsInitialized = IsInitialized
+
+  def FindInitializationErrors(self):
+    """Finds required fields which are not initialized.
+
+    Returns:
+      A list of strings.  Each string is a path to an uninitialized field from
+      the top-level message, e.g. "foo.bar[5].baz".
+    """
+
+    errors = []  # simplify things
+
+    for field in required_fields:
+      if not self.HasField(field.name):
+        errors.append(field.name)
+
+    for field, value in self.ListFields():
+      if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+        if field.is_extension:
+          name = '(%s)' % field.full_name
+        else:
+          name = field.name
+
+        if _IsMapField(field):
+          if _IsMessageMapField(field):
+            for key in value:
+              element = value[key]
+              prefix = '%s[%s].' % (name, key)
+              sub_errors = element.FindInitializationErrors()
+              errors += [prefix + error for error in sub_errors]
+          else:
+            # ScalarMaps can't have any initialization errors.
+            pass
+        elif field.label == _FieldDescriptor.LABEL_REPEATED:
+          for i in range(len(value)):
+            element = value[i]
+            prefix = '%s[%d].' % (name, i)
+            sub_errors = element.FindInitializationErrors()
+            errors += [prefix + error for error in sub_errors]
+        else:
+          prefix = name + '.'
+          sub_errors = value.FindInitializationErrors()
+          errors += [prefix + error for error in sub_errors]
+
+    return errors
+
+  cls.FindInitializationErrors = FindInitializationErrors
+
+
+def _FullyQualifiedClassName(klass):
+  module = klass.__module__
+  name = getattr(klass, '__qualname__', klass.__name__)
+  if module in (None, 'builtins', '__builtin__'):
+    return name
+  return module + '.' + name
+
+
+def _AddMergeFromMethod(cls):
+  LABEL_REPEATED = _FieldDescriptor.LABEL_REPEATED
+  CPPTYPE_MESSAGE = _FieldDescriptor.CPPTYPE_MESSAGE
+
+  def MergeFrom(self, msg):
+    if not isinstance(msg, cls):
+      raise TypeError(
+          'Parameter to MergeFrom() must be instance of same class: '
+          'expected %s got %s.' % (_FullyQualifiedClassName(cls),
+                                   _FullyQualifiedClassName(msg.__class__)))
+
+    assert msg is not self
+    self._Modified()
+
+    fields = self._fields
+
+    for field, value in msg._fields.items():
+      if field.label == LABEL_REPEATED:
+        field_value = fields.get(field)
+        if field_value is None:
+          # Construct a new object to represent this field.
+          field_value = field._default_constructor(self)
+          fields[field] = field_value
+        field_value.MergeFrom(value)
+      elif field.cpp_type == CPPTYPE_MESSAGE:
+        if value._is_present_in_parent:
+          field_value = fields.get(field)
+          if field_value is None:
+            # Construct a new object to represent this field.
+            field_value = field._default_constructor(self)
+            fields[field] = field_value
+          field_value.MergeFrom(value)
+      else:
+        self._fields[field] = value
+        if field.containing_oneof:
+          self._UpdateOneofState(field)
+
+    if msg._unknown_fields:
+      if not self._unknown_fields:
+        self._unknown_fields = []
+      self._unknown_fields.extend(msg._unknown_fields)
+      # pylint: disable=protected-access
+      if self._unknown_field_set is None:
+        self._unknown_field_set = containers.UnknownFieldSet()
+      self._unknown_field_set._extend(msg._unknown_field_set)
+
+  cls.MergeFrom = MergeFrom
+
+
+def _AddWhichOneofMethod(message_descriptor, cls):
+  def WhichOneof(self, oneof_name):
+    """Returns the name of the currently set field inside a oneof, or None."""
+    try:
+      field = message_descriptor.oneofs_by_name[oneof_name]
+    except KeyError:
+      raise ValueError(
+          'Protocol message has no oneof "%s" field.' % oneof_name)
+
+    nested_field = self._oneofs.get(field, None)
+    if nested_field is not None and self.HasField(nested_field.name):
+      return nested_field.name
+    else:
+      return None
+
+  cls.WhichOneof = WhichOneof
+
+
+def _Clear(self):
+  # Clear fields.
+  self._fields = {}
+  self._unknown_fields = ()
+  # pylint: disable=protected-access
+  if self._unknown_field_set is not None:
+    self._unknown_field_set._clear()
+    self._unknown_field_set = None
+
+  self._oneofs = {}
+  self._Modified()
+
+
+def _UnknownFields(self):
+  warnings.warn(
+      'message.UnknownFields() is deprecated. Please use the add one '
+      'feature unknown_fields.UnknownFieldSet(message) in '
+      'unknown_fields.py instead.'
+  )
+  if self._unknown_field_set is None:  # pylint: disable=protected-access
+    # pylint: disable=protected-access
+    self._unknown_field_set = containers.UnknownFieldSet()
+  return self._unknown_field_set    # pylint: disable=protected-access
+
+
+def _DiscardUnknownFields(self):
+  self._unknown_fields = []
+  self._unknown_field_set = None      # pylint: disable=protected-access
+  for field, value in self.ListFields():
+    if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+      if _IsMapField(field):
+        if _IsMessageMapField(field):
+          for key in value:
+            value[key].DiscardUnknownFields()
+      elif field.label == _FieldDescriptor.LABEL_REPEATED:
+        for sub_message in value:
+          sub_message.DiscardUnknownFields()
+      else:
+        value.DiscardUnknownFields()
+
+
+def _SetListener(self, listener):
+  if listener is None:
+    self._listener = message_listener_mod.NullMessageListener()
+  else:
+    self._listener = listener
+
+
+def _AddMessageMethods(message_descriptor, cls):
+  """Adds implementations of all Message methods to cls."""
+  _AddListFieldsMethod(message_descriptor, cls)
+  _AddHasFieldMethod(message_descriptor, cls)
+  _AddClearFieldMethod(message_descriptor, cls)
+  if message_descriptor.is_extendable:
+    _AddClearExtensionMethod(cls)
+    _AddHasExtensionMethod(cls)
+  _AddEqualsMethod(message_descriptor, cls)
+  _AddStrMethod(message_descriptor, cls)
+  _AddReprMethod(message_descriptor, cls)
+  _AddUnicodeMethod(message_descriptor, cls)
+  _AddByteSizeMethod(message_descriptor, cls)
+  _AddSerializeToStringMethod(message_descriptor, cls)
+  _AddSerializePartialToStringMethod(message_descriptor, cls)
+  _AddMergeFromStringMethod(message_descriptor, cls)
+  _AddIsInitializedMethod(message_descriptor, cls)
+  _AddMergeFromMethod(cls)
+  _AddWhichOneofMethod(message_descriptor, cls)
+  # Adds methods which do not depend on cls.
+  cls.Clear = _Clear
+  cls.UnknownFields = _UnknownFields
+  cls.DiscardUnknownFields = _DiscardUnknownFields
+  cls._SetListener = _SetListener
+
+
+def _AddPrivateHelperMethods(message_descriptor, cls):
+  """Adds implementation of private helper methods to cls."""
+
+  def Modified(self):
+    """Sets the _cached_byte_size_dirty bit to true,
+    and propagates this to our listener iff this was a state change.
+    """
+
+    # Note:  Some callers check _cached_byte_size_dirty before calling
+    #   _Modified() as an extra optimization.  So, if this method is ever
+    #   changed such that it does stuff even when _cached_byte_size_dirty is
+    #   already true, the callers need to be updated.
+    if not self._cached_byte_size_dirty:
+      self._cached_byte_size_dirty = True
+      self._listener_for_children.dirty = True
+      self._is_present_in_parent = True
+      self._listener.Modified()
+
+  def _UpdateOneofState(self, field):
+    """Sets field as the active field in its containing oneof.
+
+    Will also delete currently active field in the oneof, if it is different
+    from the argument. Does not mark the message as modified.
+    """
+    other_field = self._oneofs.setdefault(field.containing_oneof, field)
+    if other_field is not field:
+      del self._fields[other_field]
+      self._oneofs[field.containing_oneof] = field
+
+  cls._Modified = Modified
+  cls.SetInParent = Modified
+  cls._UpdateOneofState = _UpdateOneofState
+
+
+class _Listener(object):
+
+  """MessageListener implementation that a parent message registers with its
+  child message.
+
+  In order to support semantics like:
+
+    foo.bar.baz.moo = 23
+    assert foo.HasField('bar')
+
+  ...child objects must have back references to their parents.
+  This helper class is at the heart of this support.
+  """
+
+  def __init__(self, parent_message):
+    """Args:
+      parent_message: The message whose _Modified() method we should call when
+        we receive Modified() messages.
+    """
+    # This listener establishes a back reference from a child (contained) object
+    # to its parent (containing) object.  We make this a weak reference to avoid
+    # creating cyclic garbage when the client finishes with the 'parent' object
+    # in the tree.
+    if isinstance(parent_message, weakref.ProxyType):
+      self._parent_message_weakref = parent_message
+    else:
+      self._parent_message_weakref = weakref.proxy(parent_message)
+
+    # As an optimization, we also indicate directly on the listener whether
+    # or not the parent message is dirty.  This way we can avoid traversing
+    # up the tree in the common case.
+    self.dirty = False
+
+  def Modified(self):
+    if self.dirty:
+      return
+    try:
+      # Propagate the signal to our parents iff this is the first field set.
+      self._parent_message_weakref._Modified()
+    except ReferenceError:
+      # We can get here if a client has kept a reference to a child object,
+      # and is now setting a field on it, but the child's parent has been
+      # garbage-collected.  This is not an error.
+      pass
+
+
+class _OneofListener(_Listener):
+  """Special listener implementation for setting composite oneof fields."""
+
+  def __init__(self, parent_message, field):
+    """Args:
+      parent_message: The message whose _Modified() method we should call when
+        we receive Modified() messages.
+      field: The descriptor of the field being set in the parent message.
+    """
+    super(_OneofListener, self).__init__(parent_message)
+    self._field = field
+
+  def Modified(self):
+    """Also updates the state of the containing oneof in the parent message."""
+    try:
+      self._parent_message_weakref._UpdateOneofState(self._field)
+      super(_OneofListener, self).Modified()
+    except ReferenceError:
+      pass
diff --git a/llm/Lib/site-packages/google/protobuf/internal/testing_refleaks.py b/llm/Lib/site-packages/google/protobuf/internal/testing_refleaks.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca0f0b96d140afb9cb8b9cf5571c063eefb3087f
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/testing_refleaks.py
@@ -0,0 +1,119 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""A subclass of unittest.TestCase which checks for reference leaks.
+
+To use:
+- Use testing_refleak.BaseTestCase instead of unittest.TestCase
+- Configure and compile Python with --with-pydebug
+
+If sys.gettotalrefcount() is not available (because Python was built without
+the Py_DEBUG option), then this module is a no-op and tests will run normally.
+"""
+
+import copyreg
+import gc
+import sys
+import unittest
+
+
+class LocalTestResult(unittest.TestResult):
+  """A TestResult which forwards events to a parent object, except for Skips."""
+
+  def __init__(self, parent_result):
+    unittest.TestResult.__init__(self)
+    self.parent_result = parent_result
+
+  def addError(self, test, error):
+    self.parent_result.addError(test, error)
+
+  def addFailure(self, test, error):
+    self.parent_result.addFailure(test, error)
+
+  def addSkip(self, test, reason):
+    pass
+
+
+class ReferenceLeakCheckerMixin(object):
+  """A mixin class for TestCase, which checks reference counts."""
+
+  NB_RUNS = 3
+
+  def run(self, result=None):
+    testMethod = getattr(self, self._testMethodName)
+    expecting_failure_method = getattr(testMethod, "__unittest_expecting_failure__", False)
+    expecting_failure_class = getattr(self, "__unittest_expecting_failure__", False)
+    if expecting_failure_class or expecting_failure_method:
+      return
+
+    # python_message.py registers all Message classes to some pickle global
+    # registry, which makes the classes immortal.
+    # We save a copy of this registry, and reset it before we could references.
+    self._saved_pickle_registry = copyreg.dispatch_table.copy()
+
+    # Run the test twice, to warm up the instance attributes.
+    super(ReferenceLeakCheckerMixin, self).run(result=result)
+    super(ReferenceLeakCheckerMixin, self).run(result=result)
+
+    oldrefcount = 0
+    local_result = LocalTestResult(result)
+    num_flakes = 0
+
+    refcount_deltas = []
+    while len(refcount_deltas) < self.NB_RUNS:
+      oldrefcount = self._getRefcounts()
+      super(ReferenceLeakCheckerMixin, self).run(result=local_result)
+      newrefcount = self._getRefcounts()
+      # If the GC was able to collect some objects after the call to run() that
+      # it could not collect before the call, then the counts won't match.
+      if newrefcount < oldrefcount and num_flakes < 2:
+        # This result is (probably) a flake -- garbage collectors aren't very
+        # predictable, but a lower ending refcount is the opposite of the
+        # failure we are testing for. If the result is repeatable, then we will
+        # eventually report it, but not after trying to eliminate it.
+        num_flakes += 1
+        continue
+      num_flakes = 0
+      refcount_deltas.append(newrefcount - oldrefcount)
+    print(refcount_deltas, self)
+
+    try:
+      self.assertEqual(refcount_deltas, [0] * self.NB_RUNS)
+    except Exception:  # pylint: disable=broad-except
+      result.addError(self, sys.exc_info())
+
+  def _getRefcounts(self):
+    copyreg.dispatch_table.clear()
+    copyreg.dispatch_table.update(self._saved_pickle_registry)
+    # It is sometimes necessary to gc.collect() multiple times, to ensure
+    # that all objects can be collected.
+    gc.collect()
+    gc.collect()
+    gc.collect()
+    return sys.gettotalrefcount()
+
+
+if hasattr(sys, 'gettotalrefcount'):
+
+  def TestCase(test_class):
+    new_bases = (ReferenceLeakCheckerMixin,) + test_class.__bases__
+    new_class = type(test_class)(
+        test_class.__name__, new_bases, dict(test_class.__dict__))
+    return new_class
+  SkipReferenceLeakChecker = unittest.skip
+
+else:
+  # When PyDEBUG is not enabled, run the tests normally.
+
+  def TestCase(test_class):
+    return test_class
+
+  def SkipReferenceLeakChecker(reason):
+    del reason  # Don't skip, so don't need a reason.
+    def Same(func):
+      return func
+    return Same
diff --git a/llm/Lib/site-packages/google/protobuf/internal/type_checkers.py b/llm/Lib/site-packages/google/protobuf/internal/type_checkers.py
new file mode 100644
index 0000000000000000000000000000000000000000..e152a43f82ea8bf05144853df26e15ad3a941344
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/type_checkers.py
@@ -0,0 +1,408 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Provides type checking routines.
+
+This module defines type checking utilities in the forms of dictionaries:
+
+VALUE_CHECKERS: A dictionary of field types and a value validation object.
+TYPE_TO_BYTE_SIZE_FN: A dictionary with field types and a size computing
+  function.
+TYPE_TO_SERIALIZE_METHOD: A dictionary with field types and serialization
+  function.
+FIELD_TYPE_TO_WIRE_TYPE: A dictionary with field typed and their
+  corresponding wire types.
+TYPE_TO_DESERIALIZE_METHOD: A dictionary with field types and deserialization
+  function.
+"""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+import ctypes
+import numbers
+
+from google.protobuf.internal import decoder
+from google.protobuf.internal import encoder
+from google.protobuf.internal import wire_format
+from google.protobuf import descriptor
+
+_FieldDescriptor = descriptor.FieldDescriptor
+
+
+def TruncateToFourByteFloat(original):
+  return ctypes.c_float(original).value
+
+
+def ToShortestFloat(original):
+  """Returns the shortest float that has same value in wire."""
+  # All 4 byte floats have between 6 and 9 significant digits, so we
+  # start with 6 as the lower bound.
+  # It has to be iterative because use '.9g' directly can not get rid
+  # of the noises for most values. For example if set a float_field=0.9
+  # use '.9g' will print 0.899999976.
+  precision = 6
+  rounded = float('{0:.{1}g}'.format(original, precision))
+  while TruncateToFourByteFloat(rounded) != original:
+    precision += 1
+    rounded = float('{0:.{1}g}'.format(original, precision))
+  return rounded
+
+
+def GetTypeChecker(field):
+  """Returns a type checker for a message field of the specified types.
+
+  Args:
+    field: FieldDescriptor object for this field.
+
+  Returns:
+    An instance of TypeChecker which can be used to verify the types
+    of values assigned to a field of the specified type.
+  """
+  if (field.cpp_type == _FieldDescriptor.CPPTYPE_STRING and
+      field.type == _FieldDescriptor.TYPE_STRING):
+    return UnicodeValueChecker()
+  if field.cpp_type == _FieldDescriptor.CPPTYPE_ENUM:
+    if field.enum_type.is_closed:
+      return EnumValueChecker(field.enum_type)
+    else:
+      # When open enums are supported, any int32 can be assigned.
+      return _VALUE_CHECKERS[_FieldDescriptor.CPPTYPE_INT32]
+  return _VALUE_CHECKERS[field.cpp_type]
+
+
+# None of the typecheckers below make any attempt to guard against people
+# subclassing builtin types and doing weird things.  We're not trying to
+# protect against malicious clients here, just people accidentally shooting
+# themselves in the foot in obvious ways.
+class TypeChecker(object):
+
+  """Type checker used to catch type errors as early as possible
+  when the client is setting scalar fields in protocol messages.
+  """
+
+  def __init__(self, *acceptable_types):
+    self._acceptable_types = acceptable_types
+
+  def CheckValue(self, proposed_value):
+    """Type check the provided value and return it.
+
+    The returned value might have been normalized to another type.
+    """
+    if not isinstance(proposed_value, self._acceptable_types):
+      message = ('%.1024r has type %s, but expected one of: %s' %
+                 (proposed_value, type(proposed_value), self._acceptable_types))
+      raise TypeError(message)
+    return proposed_value
+
+
+class TypeCheckerWithDefault(TypeChecker):
+
+  def __init__(self, default_value, *acceptable_types):
+    TypeChecker.__init__(self, *acceptable_types)
+    self._default_value = default_value
+
+  def DefaultValue(self):
+    return self._default_value
+
+
+class BoolValueChecker(object):
+  """Type checker used for bool fields."""
+
+  def CheckValue(self, proposed_value):
+    if not hasattr(proposed_value, '__index__') or (
+        type(proposed_value).__module__ == 'numpy' and
+        type(proposed_value).__name__ == 'ndarray'):
+      message = ('%.1024r has type %s, but expected one of: %s' %
+                 (proposed_value, type(proposed_value), (bool, int)))
+      raise TypeError(message)
+    return bool(proposed_value)
+
+  def DefaultValue(self):
+    return False
+
+
+# IntValueChecker and its subclasses perform integer type-checks
+# and bounds-checks.
+class IntValueChecker(object):
+
+  """Checker used for integer fields.  Performs type-check and range check."""
+
+  def CheckValue(self, proposed_value):
+    if not hasattr(proposed_value, '__index__') or (
+        type(proposed_value).__module__ == 'numpy' and
+        type(proposed_value).__name__ == 'ndarray'):
+      message = ('%.1024r has type %s, but expected one of: %s' %
+                 (proposed_value, type(proposed_value), (int,)))
+      raise TypeError(message)
+
+    if not self._MIN <= int(proposed_value) <= self._MAX:
+      raise ValueError('Value out of range: %d' % proposed_value)
+    # We force all values to int to make alternate implementations where the
+    # distinction is more significant (e.g. the C++ implementation) simpler.
+    proposed_value = int(proposed_value)
+    return proposed_value
+
+  def DefaultValue(self):
+    return 0
+
+
+class EnumValueChecker(object):
+
+  """Checker used for enum fields.  Performs type-check and range check."""
+
+  def __init__(self, enum_type):
+    self._enum_type = enum_type
+
+  def CheckValue(self, proposed_value):
+    if not isinstance(proposed_value, numbers.Integral):
+      message = ('%.1024r has type %s, but expected one of: %s' %
+                 (proposed_value, type(proposed_value), (int,)))
+      raise TypeError(message)
+    if int(proposed_value) not in self._enum_type.values_by_number:
+      raise ValueError('Unknown enum value: %d' % proposed_value)
+    return proposed_value
+
+  def DefaultValue(self):
+    return self._enum_type.values[0].number
+
+
+class UnicodeValueChecker(object):
+
+  """Checker used for string fields.
+
+  Always returns a unicode value, even if the input is of type str.
+  """
+
+  def CheckValue(self, proposed_value):
+    if not isinstance(proposed_value, (bytes, str)):
+      message = ('%.1024r has type %s, but expected one of: %s' %
+                 (proposed_value, type(proposed_value), (bytes, str)))
+      raise TypeError(message)
+
+    # If the value is of type 'bytes' make sure that it is valid UTF-8 data.
+    if isinstance(proposed_value, bytes):
+      try:
+        proposed_value = proposed_value.decode('utf-8')
+      except UnicodeDecodeError:
+        raise ValueError('%.1024r has type bytes, but isn\'t valid UTF-8 '
+                         'encoding. Non-UTF-8 strings must be converted to '
+                         'unicode objects before being added.' %
+                         (proposed_value))
+    else:
+      try:
+        proposed_value.encode('utf8')
+      except UnicodeEncodeError:
+        raise ValueError('%.1024r isn\'t a valid unicode string and '
+                         'can\'t be encoded in UTF-8.'%
+                         (proposed_value))
+
+    return proposed_value
+
+  def DefaultValue(self):
+    return u""
+
+
+class Int32ValueChecker(IntValueChecker):
+  # We're sure to use ints instead of longs here since comparison may be more
+  # efficient.
+  _MIN = -2147483648
+  _MAX = 2147483647
+
+
+class Uint32ValueChecker(IntValueChecker):
+  _MIN = 0
+  _MAX = (1 << 32) - 1
+
+
+class Int64ValueChecker(IntValueChecker):
+  _MIN = -(1 << 63)
+  _MAX = (1 << 63) - 1
+
+
+class Uint64ValueChecker(IntValueChecker):
+  _MIN = 0
+  _MAX = (1 << 64) - 1
+
+
+# The max 4 bytes float is about 3.4028234663852886e+38
+_FLOAT_MAX = float.fromhex('0x1.fffffep+127')
+_FLOAT_MIN = -_FLOAT_MAX
+_INF = float('inf')
+_NEG_INF = float('-inf')
+
+
+class DoubleValueChecker(object):
+  """Checker used for double fields.
+
+  Performs type-check and range check.
+  """
+
+  def CheckValue(self, proposed_value):
+    """Check and convert proposed_value to float."""
+    if (not hasattr(proposed_value, '__float__') and
+        not hasattr(proposed_value, '__index__')) or (
+            type(proposed_value).__module__ == 'numpy' and
+            type(proposed_value).__name__ == 'ndarray'):
+      message = ('%.1024r has type %s, but expected one of: int, float' %
+                 (proposed_value, type(proposed_value)))
+      raise TypeError(message)
+    return float(proposed_value)
+
+  def DefaultValue(self):
+    return 0.0
+
+
+class FloatValueChecker(DoubleValueChecker):
+  """Checker used for float fields.
+
+  Performs type-check and range check.
+
+  Values exceeding a 32-bit float will be converted to inf/-inf.
+  """
+
+  def CheckValue(self, proposed_value):
+    """Check and convert proposed_value to float."""
+    converted_value = super().CheckValue(proposed_value)
+    # This inf rounding matches the C++ proto SafeDoubleToFloat logic.
+    if converted_value > _FLOAT_MAX:
+      return _INF
+    if converted_value < _FLOAT_MIN:
+      return _NEG_INF
+
+    return TruncateToFourByteFloat(converted_value)
+
+# Type-checkers for all scalar CPPTYPEs.
+_VALUE_CHECKERS = {
+    _FieldDescriptor.CPPTYPE_INT32: Int32ValueChecker(),
+    _FieldDescriptor.CPPTYPE_INT64: Int64ValueChecker(),
+    _FieldDescriptor.CPPTYPE_UINT32: Uint32ValueChecker(),
+    _FieldDescriptor.CPPTYPE_UINT64: Uint64ValueChecker(),
+    _FieldDescriptor.CPPTYPE_DOUBLE: DoubleValueChecker(),
+    _FieldDescriptor.CPPTYPE_FLOAT: FloatValueChecker(),
+    _FieldDescriptor.CPPTYPE_BOOL: BoolValueChecker(),
+    _FieldDescriptor.CPPTYPE_STRING: TypeCheckerWithDefault(b'', bytes),
+}
+
+
+# Map from field type to a function F, such that F(field_num, value)
+# gives the total byte size for a value of the given type.  This
+# byte size includes tag information and any other additional space
+# associated with serializing "value".
+TYPE_TO_BYTE_SIZE_FN = {
+    _FieldDescriptor.TYPE_DOUBLE: wire_format.DoubleByteSize,
+    _FieldDescriptor.TYPE_FLOAT: wire_format.FloatByteSize,
+    _FieldDescriptor.TYPE_INT64: wire_format.Int64ByteSize,
+    _FieldDescriptor.TYPE_UINT64: wire_format.UInt64ByteSize,
+    _FieldDescriptor.TYPE_INT32: wire_format.Int32ByteSize,
+    _FieldDescriptor.TYPE_FIXED64: wire_format.Fixed64ByteSize,
+    _FieldDescriptor.TYPE_FIXED32: wire_format.Fixed32ByteSize,
+    _FieldDescriptor.TYPE_BOOL: wire_format.BoolByteSize,
+    _FieldDescriptor.TYPE_STRING: wire_format.StringByteSize,
+    _FieldDescriptor.TYPE_GROUP: wire_format.GroupByteSize,
+    _FieldDescriptor.TYPE_MESSAGE: wire_format.MessageByteSize,
+    _FieldDescriptor.TYPE_BYTES: wire_format.BytesByteSize,
+    _FieldDescriptor.TYPE_UINT32: wire_format.UInt32ByteSize,
+    _FieldDescriptor.TYPE_ENUM: wire_format.EnumByteSize,
+    _FieldDescriptor.TYPE_SFIXED32: wire_format.SFixed32ByteSize,
+    _FieldDescriptor.TYPE_SFIXED64: wire_format.SFixed64ByteSize,
+    _FieldDescriptor.TYPE_SINT32: wire_format.SInt32ByteSize,
+    _FieldDescriptor.TYPE_SINT64: wire_format.SInt64ByteSize
+    }
+
+
+# Maps from field types to encoder constructors.
+TYPE_TO_ENCODER = {
+    _FieldDescriptor.TYPE_DOUBLE: encoder.DoubleEncoder,
+    _FieldDescriptor.TYPE_FLOAT: encoder.FloatEncoder,
+    _FieldDescriptor.TYPE_INT64: encoder.Int64Encoder,
+    _FieldDescriptor.TYPE_UINT64: encoder.UInt64Encoder,
+    _FieldDescriptor.TYPE_INT32: encoder.Int32Encoder,
+    _FieldDescriptor.TYPE_FIXED64: encoder.Fixed64Encoder,
+    _FieldDescriptor.TYPE_FIXED32: encoder.Fixed32Encoder,
+    _FieldDescriptor.TYPE_BOOL: encoder.BoolEncoder,
+    _FieldDescriptor.TYPE_STRING: encoder.StringEncoder,
+    _FieldDescriptor.TYPE_GROUP: encoder.GroupEncoder,
+    _FieldDescriptor.TYPE_MESSAGE: encoder.MessageEncoder,
+    _FieldDescriptor.TYPE_BYTES: encoder.BytesEncoder,
+    _FieldDescriptor.TYPE_UINT32: encoder.UInt32Encoder,
+    _FieldDescriptor.TYPE_ENUM: encoder.EnumEncoder,
+    _FieldDescriptor.TYPE_SFIXED32: encoder.SFixed32Encoder,
+    _FieldDescriptor.TYPE_SFIXED64: encoder.SFixed64Encoder,
+    _FieldDescriptor.TYPE_SINT32: encoder.SInt32Encoder,
+    _FieldDescriptor.TYPE_SINT64: encoder.SInt64Encoder,
+    }
+
+
+# Maps from field types to sizer constructors.
+TYPE_TO_SIZER = {
+    _FieldDescriptor.TYPE_DOUBLE: encoder.DoubleSizer,
+    _FieldDescriptor.TYPE_FLOAT: encoder.FloatSizer,
+    _FieldDescriptor.TYPE_INT64: encoder.Int64Sizer,
+    _FieldDescriptor.TYPE_UINT64: encoder.UInt64Sizer,
+    _FieldDescriptor.TYPE_INT32: encoder.Int32Sizer,
+    _FieldDescriptor.TYPE_FIXED64: encoder.Fixed64Sizer,
+    _FieldDescriptor.TYPE_FIXED32: encoder.Fixed32Sizer,
+    _FieldDescriptor.TYPE_BOOL: encoder.BoolSizer,
+    _FieldDescriptor.TYPE_STRING: encoder.StringSizer,
+    _FieldDescriptor.TYPE_GROUP: encoder.GroupSizer,
+    _FieldDescriptor.TYPE_MESSAGE: encoder.MessageSizer,
+    _FieldDescriptor.TYPE_BYTES: encoder.BytesSizer,
+    _FieldDescriptor.TYPE_UINT32: encoder.UInt32Sizer,
+    _FieldDescriptor.TYPE_ENUM: encoder.EnumSizer,
+    _FieldDescriptor.TYPE_SFIXED32: encoder.SFixed32Sizer,
+    _FieldDescriptor.TYPE_SFIXED64: encoder.SFixed64Sizer,
+    _FieldDescriptor.TYPE_SINT32: encoder.SInt32Sizer,
+    _FieldDescriptor.TYPE_SINT64: encoder.SInt64Sizer,
+    }
+
+
+# Maps from field type to a decoder constructor.
+TYPE_TO_DECODER = {
+    _FieldDescriptor.TYPE_DOUBLE: decoder.DoubleDecoder,
+    _FieldDescriptor.TYPE_FLOAT: decoder.FloatDecoder,
+    _FieldDescriptor.TYPE_INT64: decoder.Int64Decoder,
+    _FieldDescriptor.TYPE_UINT64: decoder.UInt64Decoder,
+    _FieldDescriptor.TYPE_INT32: decoder.Int32Decoder,
+    _FieldDescriptor.TYPE_FIXED64: decoder.Fixed64Decoder,
+    _FieldDescriptor.TYPE_FIXED32: decoder.Fixed32Decoder,
+    _FieldDescriptor.TYPE_BOOL: decoder.BoolDecoder,
+    _FieldDescriptor.TYPE_STRING: decoder.StringDecoder,
+    _FieldDescriptor.TYPE_GROUP: decoder.GroupDecoder,
+    _FieldDescriptor.TYPE_MESSAGE: decoder.MessageDecoder,
+    _FieldDescriptor.TYPE_BYTES: decoder.BytesDecoder,
+    _FieldDescriptor.TYPE_UINT32: decoder.UInt32Decoder,
+    _FieldDescriptor.TYPE_ENUM: decoder.EnumDecoder,
+    _FieldDescriptor.TYPE_SFIXED32: decoder.SFixed32Decoder,
+    _FieldDescriptor.TYPE_SFIXED64: decoder.SFixed64Decoder,
+    _FieldDescriptor.TYPE_SINT32: decoder.SInt32Decoder,
+    _FieldDescriptor.TYPE_SINT64: decoder.SInt64Decoder,
+    }
+
+# Maps from field type to expected wiretype.
+FIELD_TYPE_TO_WIRE_TYPE = {
+    _FieldDescriptor.TYPE_DOUBLE: wire_format.WIRETYPE_FIXED64,
+    _FieldDescriptor.TYPE_FLOAT: wire_format.WIRETYPE_FIXED32,
+    _FieldDescriptor.TYPE_INT64: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_UINT64: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_INT32: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_FIXED64: wire_format.WIRETYPE_FIXED64,
+    _FieldDescriptor.TYPE_FIXED32: wire_format.WIRETYPE_FIXED32,
+    _FieldDescriptor.TYPE_BOOL: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_STRING:
+      wire_format.WIRETYPE_LENGTH_DELIMITED,
+    _FieldDescriptor.TYPE_GROUP: wire_format.WIRETYPE_START_GROUP,
+    _FieldDescriptor.TYPE_MESSAGE:
+      wire_format.WIRETYPE_LENGTH_DELIMITED,
+    _FieldDescriptor.TYPE_BYTES:
+      wire_format.WIRETYPE_LENGTH_DELIMITED,
+    _FieldDescriptor.TYPE_UINT32: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_ENUM: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_SFIXED32: wire_format.WIRETYPE_FIXED32,
+    _FieldDescriptor.TYPE_SFIXED64: wire_format.WIRETYPE_FIXED64,
+    _FieldDescriptor.TYPE_SINT32: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_SINT64: wire_format.WIRETYPE_VARINT,
+    }
diff --git a/llm/Lib/site-packages/google/protobuf/internal/well_known_types.py b/llm/Lib/site-packages/google/protobuf/internal/well_known_types.py
new file mode 100644
index 0000000000000000000000000000000000000000..5727bc98c2c060b47b358dfebfe7e19a970ccbc9
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/well_known_types.py
@@ -0,0 +1,567 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Contains well known classes.
+
+This files defines well known classes which need extra maintenance including:
+  - Any
+  - Duration
+  - FieldMask
+  - Struct
+  - Timestamp
+"""
+
+__author__ = 'jieluo@google.com (Jie Luo)'
+
+import calendar
+import collections.abc
+import datetime
+
+from google.protobuf.internal import field_mask
+
+FieldMask = field_mask.FieldMask
+
+_TIMESTAMPFOMAT = '%Y-%m-%dT%H:%M:%S'
+_NANOS_PER_SECOND = 1000000000
+_NANOS_PER_MILLISECOND = 1000000
+_NANOS_PER_MICROSECOND = 1000
+_MILLIS_PER_SECOND = 1000
+_MICROS_PER_SECOND = 1000000
+_SECONDS_PER_DAY = 24 * 3600
+_DURATION_SECONDS_MAX = 315576000000
+
+_EPOCH_DATETIME_NAIVE = datetime.datetime(1970, 1, 1, tzinfo=None)
+_EPOCH_DATETIME_AWARE = _EPOCH_DATETIME_NAIVE.replace(
+    tzinfo=datetime.timezone.utc
+)
+
+
+class Any(object):
+  """Class for Any Message type."""
+
+  __slots__ = ()
+
+  def Pack(self, msg, type_url_prefix='type.googleapis.com/',
+           deterministic=None):
+    """Packs the specified message into current Any message."""
+    if len(type_url_prefix) < 1 or type_url_prefix[-1] != '/':
+      self.type_url = '%s/%s' % (type_url_prefix, msg.DESCRIPTOR.full_name)
+    else:
+      self.type_url = '%s%s' % (type_url_prefix, msg.DESCRIPTOR.full_name)
+    self.value = msg.SerializeToString(deterministic=deterministic)
+
+  def Unpack(self, msg):
+    """Unpacks the current Any message into specified message."""
+    descriptor = msg.DESCRIPTOR
+    if not self.Is(descriptor):
+      return False
+    msg.ParseFromString(self.value)
+    return True
+
+  def TypeName(self):
+    """Returns the protobuf type name of the inner message."""
+    # Only last part is to be used: b/25630112
+    return self.type_url.split('/')[-1]
+
+  def Is(self, descriptor):
+    """Checks if this Any represents the given protobuf type."""
+    return '/' in self.type_url and self.TypeName() == descriptor.full_name
+
+
+class Timestamp(object):
+  """Class for Timestamp message type."""
+
+  __slots__ = ()
+
+  def ToJsonString(self):
+    """Converts Timestamp to RFC 3339 date string format.
+
+    Returns:
+      A string converted from timestamp. The string is always Z-normalized
+      and uses 3, 6 or 9 fractional digits as required to represent the
+      exact time. Example of the return format: '1972-01-01T10:00:20.021Z'
+    """
+    nanos = self.nanos % _NANOS_PER_SECOND
+    total_sec = self.seconds + (self.nanos - nanos) // _NANOS_PER_SECOND
+    seconds = total_sec % _SECONDS_PER_DAY
+    days = (total_sec - seconds) // _SECONDS_PER_DAY
+    dt = datetime.datetime(1970, 1, 1) + datetime.timedelta(days, seconds)
+
+    result = dt.isoformat()
+    if (nanos % 1e9) == 0:
+      # If there are 0 fractional digits, the fractional
+      # point '.' should be omitted when serializing.
+      return result + 'Z'
+    if (nanos % 1e6) == 0:
+      # Serialize 3 fractional digits.
+      return result + '.%03dZ' % (nanos / 1e6)
+    if (nanos % 1e3) == 0:
+      # Serialize 6 fractional digits.
+      return result + '.%06dZ' % (nanos / 1e3)
+    # Serialize 9 fractional digits.
+    return result + '.%09dZ' % nanos
+
+  def FromJsonString(self, value):
+    """Parse a RFC 3339 date string format to Timestamp.
+
+    Args:
+      value: A date string. Any fractional digits (or none) and any offset are
+          accepted as long as they fit into nano-seconds precision.
+          Example of accepted format: '1972-01-01T10:00:20.021-05:00'
+
+    Raises:
+      ValueError: On parsing problems.
+    """
+    if not isinstance(value, str):
+      raise ValueError('Timestamp JSON value not a string: {!r}'.format(value))
+    timezone_offset = value.find('Z')
+    if timezone_offset == -1:
+      timezone_offset = value.find('+')
+    if timezone_offset == -1:
+      timezone_offset = value.rfind('-')
+    if timezone_offset == -1:
+      raise ValueError(
+          'Failed to parse timestamp: missing valid timezone offset.')
+    time_value = value[0:timezone_offset]
+    # Parse datetime and nanos.
+    point_position = time_value.find('.')
+    if point_position == -1:
+      second_value = time_value
+      nano_value = ''
+    else:
+      second_value = time_value[:point_position]
+      nano_value = time_value[point_position + 1:]
+    if 't' in second_value:
+      raise ValueError(
+          'time data \'{0}\' does not match format \'%Y-%m-%dT%H:%M:%S\', '
+          'lowercase \'t\' is not accepted'.format(second_value))
+    date_object = datetime.datetime.strptime(second_value, _TIMESTAMPFOMAT)
+    td = date_object - datetime.datetime(1970, 1, 1)
+    seconds = td.seconds + td.days * _SECONDS_PER_DAY
+    if len(nano_value) > 9:
+      raise ValueError(
+          'Failed to parse Timestamp: nanos {0} more than '
+          '9 fractional digits.'.format(nano_value))
+    if nano_value:
+      nanos = round(float('0.' + nano_value) * 1e9)
+    else:
+      nanos = 0
+    # Parse timezone offsets.
+    if value[timezone_offset] == 'Z':
+      if len(value) != timezone_offset + 1:
+        raise ValueError('Failed to parse timestamp: invalid trailing'
+                         ' data {0}.'.format(value))
+    else:
+      timezone = value[timezone_offset:]
+      pos = timezone.find(':')
+      if pos == -1:
+        raise ValueError(
+            'Invalid timezone offset value: {0}.'.format(timezone))
+      if timezone[0] == '+':
+        seconds -= (int(timezone[1:pos])*60+int(timezone[pos+1:]))*60
+      else:
+        seconds += (int(timezone[1:pos])*60+int(timezone[pos+1:]))*60
+    # Set seconds and nanos
+    self.seconds = int(seconds)
+    self.nanos = int(nanos)
+
+  def GetCurrentTime(self):
+    """Get the current UTC into Timestamp."""
+    self.FromDatetime(datetime.datetime.utcnow())
+
+  def ToNanoseconds(self):
+    """Converts Timestamp to nanoseconds since epoch."""
+    return self.seconds * _NANOS_PER_SECOND + self.nanos
+
+  def ToMicroseconds(self):
+    """Converts Timestamp to microseconds since epoch."""
+    return (self.seconds * _MICROS_PER_SECOND +
+            self.nanos // _NANOS_PER_MICROSECOND)
+
+  def ToMilliseconds(self):
+    """Converts Timestamp to milliseconds since epoch."""
+    return (self.seconds * _MILLIS_PER_SECOND +
+            self.nanos // _NANOS_PER_MILLISECOND)
+
+  def ToSeconds(self):
+    """Converts Timestamp to seconds since epoch."""
+    return self.seconds
+
+  def FromNanoseconds(self, nanos):
+    """Converts nanoseconds since epoch to Timestamp."""
+    self.seconds = nanos // _NANOS_PER_SECOND
+    self.nanos = nanos % _NANOS_PER_SECOND
+
+  def FromMicroseconds(self, micros):
+    """Converts microseconds since epoch to Timestamp."""
+    self.seconds = micros // _MICROS_PER_SECOND
+    self.nanos = (micros % _MICROS_PER_SECOND) * _NANOS_PER_MICROSECOND
+
+  def FromMilliseconds(self, millis):
+    """Converts milliseconds since epoch to Timestamp."""
+    self.seconds = millis // _MILLIS_PER_SECOND
+    self.nanos = (millis % _MILLIS_PER_SECOND) * _NANOS_PER_MILLISECOND
+
+  def FromSeconds(self, seconds):
+    """Converts seconds since epoch to Timestamp."""
+    self.seconds = seconds
+    self.nanos = 0
+
+  def ToDatetime(self, tzinfo=None):
+    """Converts Timestamp to a datetime.
+
+    Args:
+      tzinfo: A datetime.tzinfo subclass; defaults to None.
+
+    Returns:
+      If tzinfo is None, returns a timezone-naive UTC datetime (with no timezone
+      information, i.e. not aware that it's UTC).
+
+      Otherwise, returns a timezone-aware datetime in the input timezone.
+    """
+    # Using datetime.fromtimestamp for this would avoid constructing an extra
+    # timedelta object and possibly an extra datetime. Unfortuantely, that has
+    # the disadvantage of not handling the full precision (on all platforms, see
+    # https://github.com/python/cpython/issues/109849) or full range (on some
+    # platforms, see https://github.com/python/cpython/issues/110042) of
+    # datetime.
+    delta = datetime.timedelta(
+        seconds=self.seconds,
+        microseconds=_RoundTowardZero(self.nanos, _NANOS_PER_MICROSECOND),
+    )
+    if tzinfo is None:
+      return _EPOCH_DATETIME_NAIVE + delta
+    else:
+      # Note the tz conversion has to come after the timedelta arithmetic.
+      return (_EPOCH_DATETIME_AWARE + delta).astimezone(tzinfo)
+
+  def FromDatetime(self, dt):
+    """Converts datetime to Timestamp.
+
+    Args:
+      dt: A datetime. If it's timezone-naive, it's assumed to be in UTC.
+    """
+    # Using this guide: http://wiki.python.org/moin/WorkingWithTime
+    # And this conversion guide: http://docs.python.org/library/time.html
+
+    # Turn the date parameter into a tuple (struct_time) that can then be
+    # manipulated into a long value of seconds.  During the conversion from
+    # struct_time to long, the source date in UTC, and so it follows that the
+    # correct transformation is calendar.timegm()
+    self.seconds = calendar.timegm(dt.utctimetuple())
+    self.nanos = dt.microsecond * _NANOS_PER_MICROSECOND
+
+
+class Duration(object):
+  """Class for Duration message type."""
+
+  __slots__ = ()
+
+  def ToJsonString(self):
+    """Converts Duration to string format.
+
+    Returns:
+      A string converted from self. The string format will contains
+      3, 6, or 9 fractional digits depending on the precision required to
+      represent the exact Duration value. For example: "1s", "1.010s",
+      "1.000000100s", "-3.100s"
+    """
+    _CheckDurationValid(self.seconds, self.nanos)
+    if self.seconds < 0 or self.nanos < 0:
+      result = '-'
+      seconds = - self.seconds + int((0 - self.nanos) // 1e9)
+      nanos = (0 - self.nanos) % 1e9
+    else:
+      result = ''
+      seconds = self.seconds + int(self.nanos // 1e9)
+      nanos = self.nanos % 1e9
+    result += '%d' % seconds
+    if (nanos % 1e9) == 0:
+      # If there are 0 fractional digits, the fractional
+      # point '.' should be omitted when serializing.
+      return result + 's'
+    if (nanos % 1e6) == 0:
+      # Serialize 3 fractional digits.
+      return result + '.%03ds' % (nanos / 1e6)
+    if (nanos % 1e3) == 0:
+      # Serialize 6 fractional digits.
+      return result + '.%06ds' % (nanos / 1e3)
+    # Serialize 9 fractional digits.
+    return result + '.%09ds' % nanos
+
+  def FromJsonString(self, value):
+    """Converts a string to Duration.
+
+    Args:
+      value: A string to be converted. The string must end with 's'. Any
+          fractional digits (or none) are accepted as long as they fit into
+          precision. For example: "1s", "1.01s", "1.0000001s", "-3.100s
+
+    Raises:
+      ValueError: On parsing problems.
+    """
+    if not isinstance(value, str):
+      raise ValueError('Duration JSON value not a string: {!r}'.format(value))
+    if len(value) < 1 or value[-1] != 's':
+      raise ValueError(
+          'Duration must end with letter "s": {0}.'.format(value))
+    try:
+      pos = value.find('.')
+      if pos == -1:
+        seconds = int(value[:-1])
+        nanos = 0
+      else:
+        seconds = int(value[:pos])
+        if value[0] == '-':
+          nanos = int(round(float('-0{0}'.format(value[pos: -1])) *1e9))
+        else:
+          nanos = int(round(float('0{0}'.format(value[pos: -1])) *1e9))
+      _CheckDurationValid(seconds, nanos)
+      self.seconds = seconds
+      self.nanos = nanos
+    except ValueError as e:
+      raise ValueError(
+          'Couldn\'t parse duration: {0} : {1}.'.format(value, e))
+
+  def ToNanoseconds(self):
+    """Converts a Duration to nanoseconds."""
+    return self.seconds * _NANOS_PER_SECOND + self.nanos
+
+  def ToMicroseconds(self):
+    """Converts a Duration to microseconds."""
+    micros = _RoundTowardZero(self.nanos, _NANOS_PER_MICROSECOND)
+    return self.seconds * _MICROS_PER_SECOND + micros
+
+  def ToMilliseconds(self):
+    """Converts a Duration to milliseconds."""
+    millis = _RoundTowardZero(self.nanos, _NANOS_PER_MILLISECOND)
+    return self.seconds * _MILLIS_PER_SECOND + millis
+
+  def ToSeconds(self):
+    """Converts a Duration to seconds."""
+    return self.seconds
+
+  def FromNanoseconds(self, nanos):
+    """Converts nanoseconds to Duration."""
+    self._NormalizeDuration(nanos // _NANOS_PER_SECOND,
+                            nanos % _NANOS_PER_SECOND)
+
+  def FromMicroseconds(self, micros):
+    """Converts microseconds to Duration."""
+    self._NormalizeDuration(
+        micros // _MICROS_PER_SECOND,
+        (micros % _MICROS_PER_SECOND) * _NANOS_PER_MICROSECOND)
+
+  def FromMilliseconds(self, millis):
+    """Converts milliseconds to Duration."""
+    self._NormalizeDuration(
+        millis // _MILLIS_PER_SECOND,
+        (millis % _MILLIS_PER_SECOND) * _NANOS_PER_MILLISECOND)
+
+  def FromSeconds(self, seconds):
+    """Converts seconds to Duration."""
+    self.seconds = seconds
+    self.nanos = 0
+
+  def ToTimedelta(self):
+    """Converts Duration to timedelta."""
+    return datetime.timedelta(
+        seconds=self.seconds, microseconds=_RoundTowardZero(
+            self.nanos, _NANOS_PER_MICROSECOND))
+
+  def FromTimedelta(self, td):
+    """Converts timedelta to Duration."""
+    self._NormalizeDuration(td.seconds + td.days * _SECONDS_PER_DAY,
+                            td.microseconds * _NANOS_PER_MICROSECOND)
+
+  def _NormalizeDuration(self, seconds, nanos):
+    """Set Duration by seconds and nanos."""
+    # Force nanos to be negative if the duration is negative.
+    if seconds < 0 and nanos > 0:
+      seconds += 1
+      nanos -= _NANOS_PER_SECOND
+    self.seconds = seconds
+    self.nanos = nanos
+
+
+def _CheckDurationValid(seconds, nanos):
+  if seconds < -_DURATION_SECONDS_MAX or seconds > _DURATION_SECONDS_MAX:
+    raise ValueError(
+        'Duration is not valid: Seconds {0} must be in range '
+        '[-315576000000, 315576000000].'.format(seconds))
+  if nanos <= -_NANOS_PER_SECOND or nanos >= _NANOS_PER_SECOND:
+    raise ValueError(
+        'Duration is not valid: Nanos {0} must be in range '
+        '[-999999999, 999999999].'.format(nanos))
+  if (nanos < 0 and seconds > 0) or (nanos > 0 and seconds < 0):
+    raise ValueError(
+        'Duration is not valid: Sign mismatch.')
+
+
+def _RoundTowardZero(value, divider):
+  """Truncates the remainder part after division."""
+  # For some languages, the sign of the remainder is implementation
+  # dependent if any of the operands is negative. Here we enforce
+  # "rounded toward zero" semantics. For example, for (-5) / 2 an
+  # implementation may give -3 as the result with the remainder being
+  # 1. This function ensures we always return -2 (closer to zero).
+  result = value // divider
+  remainder = value % divider
+  if result < 0 and remainder > 0:
+    return result + 1
+  else:
+    return result
+
+
+def _SetStructValue(struct_value, value):
+  if value is None:
+    struct_value.null_value = 0
+  elif isinstance(value, bool):
+    # Note: this check must come before the number check because in Python
+    # True and False are also considered numbers.
+    struct_value.bool_value = value
+  elif isinstance(value, str):
+    struct_value.string_value = value
+  elif isinstance(value, (int, float)):
+    struct_value.number_value = value
+  elif isinstance(value, (dict, Struct)):
+    struct_value.struct_value.Clear()
+    struct_value.struct_value.update(value)
+  elif isinstance(value, (list, tuple, ListValue)):
+    struct_value.list_value.Clear()
+    struct_value.list_value.extend(value)
+  else:
+    raise ValueError('Unexpected type')
+
+
+def _GetStructValue(struct_value):
+  which = struct_value.WhichOneof('kind')
+  if which == 'struct_value':
+    return struct_value.struct_value
+  elif which == 'null_value':
+    return None
+  elif which == 'number_value':
+    return struct_value.number_value
+  elif which == 'string_value':
+    return struct_value.string_value
+  elif which == 'bool_value':
+    return struct_value.bool_value
+  elif which == 'list_value':
+    return struct_value.list_value
+  elif which is None:
+    raise ValueError('Value not set')
+
+
+class Struct(object):
+  """Class for Struct message type."""
+
+  __slots__ = ()
+
+  def __getitem__(self, key):
+    return _GetStructValue(self.fields[key])
+
+  def __contains__(self, item):
+    return item in self.fields
+
+  def __setitem__(self, key, value):
+    _SetStructValue(self.fields[key], value)
+
+  def __delitem__(self, key):
+    del self.fields[key]
+
+  def __len__(self):
+    return len(self.fields)
+
+  def __iter__(self):
+    return iter(self.fields)
+
+  def keys(self):  # pylint: disable=invalid-name
+    return self.fields.keys()
+
+  def values(self):  # pylint: disable=invalid-name
+    return [self[key] for key in self]
+
+  def items(self):  # pylint: disable=invalid-name
+    return [(key, self[key]) for key in self]
+
+  def get_or_create_list(self, key):
+    """Returns a list for this key, creating if it didn't exist already."""
+    if not self.fields[key].HasField('list_value'):
+      # Clear will mark list_value modified which will indeed create a list.
+      self.fields[key].list_value.Clear()
+    return self.fields[key].list_value
+
+  def get_or_create_struct(self, key):
+    """Returns a struct for this key, creating if it didn't exist already."""
+    if not self.fields[key].HasField('struct_value'):
+      # Clear will mark struct_value modified which will indeed create a struct.
+      self.fields[key].struct_value.Clear()
+    return self.fields[key].struct_value
+
+  def update(self, dictionary):  # pylint: disable=invalid-name
+    for key, value in dictionary.items():
+      _SetStructValue(self.fields[key], value)
+
+collections.abc.MutableMapping.register(Struct)
+
+
+class ListValue(object):
+  """Class for ListValue message type."""
+
+  __slots__ = ()
+
+  def __len__(self):
+    return len(self.values)
+
+  def append(self, value):
+    _SetStructValue(self.values.add(), value)
+
+  def extend(self, elem_seq):
+    for value in elem_seq:
+      self.append(value)
+
+  def __getitem__(self, index):
+    """Retrieves item by the specified index."""
+    return _GetStructValue(self.values.__getitem__(index))
+
+  def __setitem__(self, index, value):
+    _SetStructValue(self.values.__getitem__(index), value)
+
+  def __delitem__(self, key):
+    del self.values[key]
+
+  def items(self):
+    for i in range(len(self)):
+      yield self[i]
+
+  def add_struct(self):
+    """Appends and returns a struct value as the next value in the list."""
+    struct_value = self.values.add().struct_value
+    # Clear will mark struct_value modified which will indeed create a struct.
+    struct_value.Clear()
+    return struct_value
+
+  def add_list(self):
+    """Appends and returns a list value as the next value in the list."""
+    list_value = self.values.add().list_value
+    # Clear will mark list_value modified which will indeed create a list.
+    list_value.Clear()
+    return list_value
+
+collections.abc.MutableSequence.register(ListValue)
+
+
+# LINT.IfChange(wktbases)
+WKTBASES = {
+    'google.protobuf.Any': Any,
+    'google.protobuf.Duration': Duration,
+    'google.protobuf.FieldMask': FieldMask,
+    'google.protobuf.ListValue': ListValue,
+    'google.protobuf.Struct': Struct,
+    'google.protobuf.Timestamp': Timestamp,
+}
+# LINT.ThenChange(//depot/google.protobuf/compiler/python/pyi_generator.cc:wktbases)
diff --git a/llm/Lib/site-packages/google/protobuf/internal/wire_format.py b/llm/Lib/site-packages/google/protobuf/internal/wire_format.py
new file mode 100644
index 0000000000000000000000000000000000000000..6237dabf950e49d2d6124340c06724f41c1c2c8d
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/internal/wire_format.py
@@ -0,0 +1,245 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Constants and static functions to support protocol buffer wire format."""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+import struct
+from google.protobuf import descriptor
+from google.protobuf import message
+
+
+TAG_TYPE_BITS = 3  # Number of bits used to hold type info in a proto tag.
+TAG_TYPE_MASK = (1 << TAG_TYPE_BITS) - 1  # 0x7
+
+# These numbers identify the wire type of a protocol buffer value.
+# We use the least-significant TAG_TYPE_BITS bits of the varint-encoded
+# tag-and-type to store one of these WIRETYPE_* constants.
+# These values must match WireType enum in //google/protobuf/wire_format.h.
+WIRETYPE_VARINT = 0
+WIRETYPE_FIXED64 = 1
+WIRETYPE_LENGTH_DELIMITED = 2
+WIRETYPE_START_GROUP = 3
+WIRETYPE_END_GROUP = 4
+WIRETYPE_FIXED32 = 5
+_WIRETYPE_MAX = 5
+
+
+# Bounds for various integer types.
+INT32_MAX = int((1 << 31) - 1)
+INT32_MIN = int(-(1 << 31))
+UINT32_MAX = (1 << 32) - 1
+
+INT64_MAX = (1 << 63) - 1
+INT64_MIN = -(1 << 63)
+UINT64_MAX = (1 << 64) - 1
+
+# "struct" format strings that will encode/decode the specified formats.
+FORMAT_UINT32_LITTLE_ENDIAN = '<I'
+FORMAT_UINT64_LITTLE_ENDIAN = '<Q'
+FORMAT_FLOAT_LITTLE_ENDIAN = '<f'
+FORMAT_DOUBLE_LITTLE_ENDIAN = '<d'
+
+
+# We'll have to provide alternate implementations of AppendLittleEndian*() on
+# any architectures where these checks fail.
+if struct.calcsize(FORMAT_UINT32_LITTLE_ENDIAN) != 4:
+  raise AssertionError('Format "I" is not a 32-bit number.')
+if struct.calcsize(FORMAT_UINT64_LITTLE_ENDIAN) != 8:
+  raise AssertionError('Format "Q" is not a 64-bit number.')
+
+
+def PackTag(field_number, wire_type):
+  """Returns an unsigned 32-bit integer that encodes the field number and
+  wire type information in standard protocol message wire format.
+
+  Args:
+    field_number: Expected to be an integer in the range [1, 1 << 29)
+    wire_type: One of the WIRETYPE_* constants.
+  """
+  if not 0 <= wire_type <= _WIRETYPE_MAX:
+    raise message.EncodeError('Unknown wire type: %d' % wire_type)
+  return (field_number << TAG_TYPE_BITS) | wire_type
+
+
+def UnpackTag(tag):
+  """The inverse of PackTag().  Given an unsigned 32-bit number,
+  returns a (field_number, wire_type) tuple.
+  """
+  return (tag >> TAG_TYPE_BITS), (tag & TAG_TYPE_MASK)
+
+
+def ZigZagEncode(value):
+  """ZigZag Transform:  Encodes signed integers so that they can be
+  effectively used with varint encoding.  See wire_format.h for
+  more details.
+  """
+  if value >= 0:
+    return value << 1
+  return (value << 1) ^ (~0)
+
+
+def ZigZagDecode(value):
+  """Inverse of ZigZagEncode()."""
+  if not value & 0x1:
+    return value >> 1
+  return (value >> 1) ^ (~0)
+
+
+
+# The *ByteSize() functions below return the number of bytes required to
+# serialize "field number + type" information and then serialize the value.
+
+
+def Int32ByteSize(field_number, int32):
+  return Int64ByteSize(field_number, int32)
+
+
+def Int32ByteSizeNoTag(int32):
+  return _VarUInt64ByteSizeNoTag(0xffffffffffffffff & int32)
+
+
+def Int64ByteSize(field_number, int64):
+  # Have to convert to uint before calling UInt64ByteSize().
+  return UInt64ByteSize(field_number, 0xffffffffffffffff & int64)
+
+
+def UInt32ByteSize(field_number, uint32):
+  return UInt64ByteSize(field_number, uint32)
+
+
+def UInt64ByteSize(field_number, uint64):
+  return TagByteSize(field_number) + _VarUInt64ByteSizeNoTag(uint64)
+
+
+def SInt32ByteSize(field_number, int32):
+  return UInt32ByteSize(field_number, ZigZagEncode(int32))
+
+
+def SInt64ByteSize(field_number, int64):
+  return UInt64ByteSize(field_number, ZigZagEncode(int64))
+
+
+def Fixed32ByteSize(field_number, fixed32):
+  return TagByteSize(field_number) + 4
+
+
+def Fixed64ByteSize(field_number, fixed64):
+  return TagByteSize(field_number) + 8
+
+
+def SFixed32ByteSize(field_number, sfixed32):
+  return TagByteSize(field_number) + 4
+
+
+def SFixed64ByteSize(field_number, sfixed64):
+  return TagByteSize(field_number) + 8
+
+
+def FloatByteSize(field_number, flt):
+  return TagByteSize(field_number) + 4
+
+
+def DoubleByteSize(field_number, double):
+  return TagByteSize(field_number) + 8
+
+
+def BoolByteSize(field_number, b):
+  return TagByteSize(field_number) + 1
+
+
+def EnumByteSize(field_number, enum):
+  return UInt32ByteSize(field_number, enum)
+
+
+def StringByteSize(field_number, string):
+  return BytesByteSize(field_number, string.encode('utf-8'))
+
+
+def BytesByteSize(field_number, b):
+  return (TagByteSize(field_number)
+          + _VarUInt64ByteSizeNoTag(len(b))
+          + len(b))
+
+
+def GroupByteSize(field_number, message):
+  return (2 * TagByteSize(field_number)  # START and END group.
+          + message.ByteSize())
+
+
+def MessageByteSize(field_number, message):
+  return (TagByteSize(field_number)
+          + _VarUInt64ByteSizeNoTag(message.ByteSize())
+          + message.ByteSize())
+
+
+def MessageSetItemByteSize(field_number, msg):
+  # First compute the sizes of the tags.
+  # There are 2 tags for the beginning and ending of the repeated group, that
+  # is field number 1, one with field number 2 (type_id) and one with field
+  # number 3 (message).
+  total_size = (2 * TagByteSize(1) + TagByteSize(2) + TagByteSize(3))
+
+  # Add the number of bytes for type_id.
+  total_size += _VarUInt64ByteSizeNoTag(field_number)
+
+  message_size = msg.ByteSize()
+
+  # The number of bytes for encoding the length of the message.
+  total_size += _VarUInt64ByteSizeNoTag(message_size)
+
+  # The size of the message.
+  total_size += message_size
+  return total_size
+
+
+def TagByteSize(field_number):
+  """Returns the bytes required to serialize a tag with this field number."""
+  # Just pass in type 0, since the type won't affect the tag+type size.
+  return _VarUInt64ByteSizeNoTag(PackTag(field_number, 0))
+
+
+# Private helper function for the *ByteSize() functions above.
+
+def _VarUInt64ByteSizeNoTag(uint64):
+  """Returns the number of bytes required to serialize a single varint
+  using boundary value comparisons. (unrolled loop optimization -WPierce)
+  uint64 must be unsigned.
+  """
+  if uint64 <= 0x7f: return 1
+  if uint64 <= 0x3fff: return 2
+  if uint64 <= 0x1fffff: return 3
+  if uint64 <= 0xfffffff: return 4
+  if uint64 <= 0x7ffffffff: return 5
+  if uint64 <= 0x3ffffffffff: return 6
+  if uint64 <= 0x1ffffffffffff: return 7
+  if uint64 <= 0xffffffffffffff: return 8
+  if uint64 <= 0x7fffffffffffffff: return 9
+  if uint64 > UINT64_MAX:
+    raise message.EncodeError('Value out of range: %d' % uint64)
+  return 10
+
+
+NON_PACKABLE_TYPES = (
+  descriptor.FieldDescriptor.TYPE_STRING,
+  descriptor.FieldDescriptor.TYPE_GROUP,
+  descriptor.FieldDescriptor.TYPE_MESSAGE,
+  descriptor.FieldDescriptor.TYPE_BYTES
+)
+
+
+def IsTypePackable(field_type):
+  """Return true iff packable = true is valid for fields of this type.
+
+  Args:
+    field_type: a FieldDescriptor::Type value.
+
+  Returns:
+    True iff fields of this type are packable.
+  """
+  return field_type not in NON_PACKABLE_TYPES
diff --git a/llm/Lib/site-packages/google/protobuf/json_format.py b/llm/Lib/site-packages/google/protobuf/json_format.py
new file mode 100644
index 0000000000000000000000000000000000000000..1b6ce9d03d8c4381d576b15f45729423078c0b63
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/json_format.py
@@ -0,0 +1,904 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Contains routines for printing protocol messages in JSON format.
+
+Simple usage example:
+
+  # Create a proto object and serialize it to a json format string.
+  message = my_proto_pb2.MyMessage(foo='bar')
+  json_string = json_format.MessageToJson(message)
+
+  # Parse a json format string to proto object.
+  message = json_format.Parse(json_string, my_proto_pb2.MyMessage())
+"""
+
+__author__ = 'jieluo@google.com (Jie Luo)'
+
+
+import base64
+from collections import OrderedDict
+import json
+import math
+from operator import methodcaller
+import re
+
+from google.protobuf.internal import type_checkers
+from google.protobuf import descriptor
+from google.protobuf import message_factory
+from google.protobuf import symbol_database
+
+
+_INT_TYPES = frozenset([descriptor.FieldDescriptor.CPPTYPE_INT32,
+                        descriptor.FieldDescriptor.CPPTYPE_UINT32,
+                        descriptor.FieldDescriptor.CPPTYPE_INT64,
+                        descriptor.FieldDescriptor.CPPTYPE_UINT64])
+_INT64_TYPES = frozenset([descriptor.FieldDescriptor.CPPTYPE_INT64,
+                          descriptor.FieldDescriptor.CPPTYPE_UINT64])
+_FLOAT_TYPES = frozenset([descriptor.FieldDescriptor.CPPTYPE_FLOAT,
+                          descriptor.FieldDescriptor.CPPTYPE_DOUBLE])
+_INFINITY = 'Infinity'
+_NEG_INFINITY = '-Infinity'
+_NAN = 'NaN'
+
+_UNPAIRED_SURROGATE_PATTERN = re.compile(
+    u'[\ud800-\udbff](?![\udc00-\udfff])|(?<![\ud800-\udbff])[\udc00-\udfff]')
+
+_VALID_EXTENSION_NAME = re.compile(r'\[[a-zA-Z0-9\._]*\]$')
+
+
+class Error(Exception):
+  """Top-level module error for json_format."""
+
+
+class SerializeToJsonError(Error):
+  """Thrown if serialization to JSON fails."""
+
+
+class ParseError(Error):
+  """Thrown in case of parsing error."""
+
+
+def MessageToJson(
+    message,
+    including_default_value_fields=False,
+    preserving_proto_field_name=False,
+    indent=2,
+    sort_keys=False,
+    use_integers_for_enums=False,
+    descriptor_pool=None,
+    float_precision=None,
+    ensure_ascii=True):
+  """Converts protobuf message to JSON format.
+
+  Args:
+    message: The protocol buffers message instance to serialize.
+    including_default_value_fields: If True, singular primitive fields,
+        repeated fields, and map fields will always be serialized.  If
+        False, only serialize non-empty fields.  Singular message fields
+        and oneof fields are not affected by this option.
+    preserving_proto_field_name: If True, use the original proto field
+        names as defined in the .proto file. If False, convert the field
+        names to lowerCamelCase.
+    indent: The JSON object will be pretty-printed with this indent level.
+        An indent level of 0 or negative will only insert newlines. If the
+        indent level is None, no newlines will be inserted.
+    sort_keys: If True, then the output will be sorted by field names.
+    use_integers_for_enums: If true, print integers instead of enum names.
+    descriptor_pool: A Descriptor Pool for resolving types. If None use the
+        default.
+    float_precision: If set, use this to specify float field valid digits.
+    ensure_ascii: If True, strings with non-ASCII characters are escaped.
+        If False, Unicode strings are returned unchanged.
+
+  Returns:
+    A string containing the JSON formatted protocol buffer message.
+  """
+  printer = _Printer(
+      including_default_value_fields,
+      preserving_proto_field_name,
+      use_integers_for_enums,
+      descriptor_pool,
+      float_precision=float_precision)
+  return printer.ToJsonString(message, indent, sort_keys, ensure_ascii)
+
+
+def MessageToDict(
+    message,
+    including_default_value_fields=False,
+    preserving_proto_field_name=False,
+    use_integers_for_enums=False,
+    descriptor_pool=None,
+    float_precision=None):
+  """Converts protobuf message to a dictionary.
+
+  When the dictionary is encoded to JSON, it conforms to proto3 JSON spec.
+
+  Args:
+    message: The protocol buffers message instance to serialize.
+    including_default_value_fields: If True, singular primitive fields,
+        repeated fields, and map fields will always be serialized.  If
+        False, only serialize non-empty fields.  Singular message fields
+        and oneof fields are not affected by this option.
+    preserving_proto_field_name: If True, use the original proto field
+        names as defined in the .proto file. If False, convert the field
+        names to lowerCamelCase.
+    use_integers_for_enums: If true, print integers instead of enum names.
+    descriptor_pool: A Descriptor Pool for resolving types. If None use the
+        default.
+    float_precision: If set, use this to specify float field valid digits.
+
+  Returns:
+    A dict representation of the protocol buffer message.
+  """
+  printer = _Printer(
+      including_default_value_fields,
+      preserving_proto_field_name,
+      use_integers_for_enums,
+      descriptor_pool,
+      float_precision=float_precision)
+  # pylint: disable=protected-access
+  return printer._MessageToJsonObject(message)
+
+
+def _IsMapEntry(field):
+  return (field.type == descriptor.FieldDescriptor.TYPE_MESSAGE and
+          field.message_type.has_options and
+          field.message_type.GetOptions().map_entry)
+
+
+class _Printer(object):
+  """JSON format printer for protocol message."""
+
+  def __init__(
+      self,
+      including_default_value_fields=False,
+      preserving_proto_field_name=False,
+      use_integers_for_enums=False,
+      descriptor_pool=None,
+      float_precision=None):
+    self.including_default_value_fields = including_default_value_fields
+    self.preserving_proto_field_name = preserving_proto_field_name
+    self.use_integers_for_enums = use_integers_for_enums
+    self.descriptor_pool = descriptor_pool
+    if float_precision:
+      self.float_format = '.{}g'.format(float_precision)
+    else:
+      self.float_format = None
+
+  def ToJsonString(self, message, indent, sort_keys, ensure_ascii):
+    js = self._MessageToJsonObject(message)
+    return json.dumps(
+        js, indent=indent, sort_keys=sort_keys, ensure_ascii=ensure_ascii)
+
+  def _MessageToJsonObject(self, message):
+    """Converts message to an object according to Proto3 JSON Specification."""
+    message_descriptor = message.DESCRIPTOR
+    full_name = message_descriptor.full_name
+    if _IsWrapperMessage(message_descriptor):
+      return self._WrapperMessageToJsonObject(message)
+    if full_name in _WKTJSONMETHODS:
+      return methodcaller(_WKTJSONMETHODS[full_name][0], message)(self)
+    js = {}
+    return self._RegularMessageToJsonObject(message, js)
+
+  def _RegularMessageToJsonObject(self, message, js):
+    """Converts normal message according to Proto3 JSON Specification."""
+    fields = message.ListFields()
+
+    try:
+      for field, value in fields:
+        if self.preserving_proto_field_name:
+          name = field.name
+        else:
+          name = field.json_name
+        if _IsMapEntry(field):
+          # Convert a map field.
+          v_field = field.message_type.fields_by_name['value']
+          js_map = {}
+          for key in value:
+            if isinstance(key, bool):
+              if key:
+                recorded_key = 'true'
+              else:
+                recorded_key = 'false'
+            else:
+              recorded_key = str(key)
+            js_map[recorded_key] = self._FieldToJsonObject(
+                v_field, value[key])
+          js[name] = js_map
+        elif field.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+          # Convert a repeated field.
+          js[name] = [self._FieldToJsonObject(field, k)
+                      for k in value]
+        elif field.is_extension:
+          name = '[%s]' % field.full_name
+          js[name] = self._FieldToJsonObject(field, value)
+        else:
+          js[name] = self._FieldToJsonObject(field, value)
+
+      # Serialize default value if including_default_value_fields is True.
+      if self.including_default_value_fields:
+        message_descriptor = message.DESCRIPTOR
+        for field in message_descriptor.fields:
+          # Singular message fields and oneof fields will not be affected.
+          if ((field.label != descriptor.FieldDescriptor.LABEL_REPEATED and
+               field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE) or
+              field.containing_oneof):
+            continue
+          if self.preserving_proto_field_name:
+            name = field.name
+          else:
+            name = field.json_name
+          if name in js:
+            # Skip the field which has been serialized already.
+            continue
+          if _IsMapEntry(field):
+            js[name] = {}
+          elif field.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+            js[name] = []
+          else:
+            js[name] = self._FieldToJsonObject(field, field.default_value)
+
+    except ValueError as e:
+      raise SerializeToJsonError(
+          'Failed to serialize {0} field: {1}.'.format(field.name, e)) from e
+
+    return js
+
+  def _FieldToJsonObject(self, field, value):
+    """Converts field value according to Proto3 JSON Specification."""
+    if field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+      return self._MessageToJsonObject(value)
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_ENUM:
+      if self.use_integers_for_enums:
+        return value
+      if field.enum_type.full_name == 'google.protobuf.NullValue':
+        return None
+      enum_value = field.enum_type.values_by_number.get(value, None)
+      if enum_value is not None:
+        return enum_value.name
+      else:
+        if field.enum_type.is_closed:
+          raise SerializeToJsonError('Enum field contains an integer value '
+                                     'which can not mapped to an enum value.')
+        else:
+          return value
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_STRING:
+      if field.type == descriptor.FieldDescriptor.TYPE_BYTES:
+        # Use base64 Data encoding for bytes
+        return base64.b64encode(value).decode('utf-8')
+      else:
+        return value
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_BOOL:
+      return bool(value)
+    elif field.cpp_type in _INT64_TYPES:
+      return str(value)
+    elif field.cpp_type in _FLOAT_TYPES:
+      if math.isinf(value):
+        if value < 0.0:
+          return _NEG_INFINITY
+        else:
+          return _INFINITY
+      if math.isnan(value):
+        return _NAN
+      if field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_FLOAT:
+        if self.float_format:
+          return float(format(value, self.float_format))
+        else:
+          return type_checkers.ToShortestFloat(value)
+
+    return value
+
+  def _AnyMessageToJsonObject(self, message):
+    """Converts Any message according to Proto3 JSON Specification."""
+    if not message.ListFields():
+      return {}
+    # Must print @type first, use OrderedDict instead of {}
+    js = OrderedDict()
+    type_url = message.type_url
+    js['@type'] = type_url
+    sub_message = _CreateMessageFromTypeUrl(type_url, self.descriptor_pool)
+    sub_message.ParseFromString(message.value)
+    message_descriptor = sub_message.DESCRIPTOR
+    full_name = message_descriptor.full_name
+    if _IsWrapperMessage(message_descriptor):
+      js['value'] = self._WrapperMessageToJsonObject(sub_message)
+      return js
+    if full_name in _WKTJSONMETHODS:
+      js['value'] = methodcaller(_WKTJSONMETHODS[full_name][0],
+                                 sub_message)(self)
+      return js
+    return self._RegularMessageToJsonObject(sub_message, js)
+
+  def _GenericMessageToJsonObject(self, message):
+    """Converts message according to Proto3 JSON Specification."""
+    # Duration, Timestamp and FieldMask have ToJsonString method to do the
+    # convert. Users can also call the method directly.
+    return message.ToJsonString()
+
+  def _ValueMessageToJsonObject(self, message):
+    """Converts Value message according to Proto3 JSON Specification."""
+    which = message.WhichOneof('kind')
+    # If the Value message is not set treat as null_value when serialize
+    # to JSON. The parse back result will be different from original message.
+    if which is None or which == 'null_value':
+      return None
+    if which == 'list_value':
+      return self._ListValueMessageToJsonObject(message.list_value)
+    if which == 'number_value':
+      value = message.number_value
+      if math.isinf(value):
+        raise ValueError('Fail to serialize Infinity for Value.number_value, '
+                         'which would parse as string_value')
+      if math.isnan(value):
+        raise ValueError('Fail to serialize NaN for Value.number_value, '
+                         'which would parse as string_value')
+    else:
+      value = getattr(message, which)
+    oneof_descriptor = message.DESCRIPTOR.fields_by_name[which]
+    return self._FieldToJsonObject(oneof_descriptor, value)
+
+  def _ListValueMessageToJsonObject(self, message):
+    """Converts ListValue message according to Proto3 JSON Specification."""
+    return [self._ValueMessageToJsonObject(value)
+            for value in message.values]
+
+  def _StructMessageToJsonObject(self, message):
+    """Converts Struct message according to Proto3 JSON Specification."""
+    fields = message.fields
+    ret = {}
+    for key in fields:
+      ret[key] = self._ValueMessageToJsonObject(fields[key])
+    return ret
+
+  def _WrapperMessageToJsonObject(self, message):
+    return self._FieldToJsonObject(
+        message.DESCRIPTOR.fields_by_name['value'], message.value)
+
+
+def _IsWrapperMessage(message_descriptor):
+  return message_descriptor.file.name == 'google/protobuf/wrappers.proto'
+
+
+def _DuplicateChecker(js):
+  result = {}
+  for name, value in js:
+    if name in result:
+      raise ParseError('Failed to load JSON: duplicate key {0}.'.format(name))
+    result[name] = value
+  return result
+
+
+def _CreateMessageFromTypeUrl(type_url, descriptor_pool):
+  """Creates a message from a type URL."""
+  db = symbol_database.Default()
+  pool = db.pool if descriptor_pool is None else descriptor_pool
+  type_name = type_url.split('/')[-1]
+  try:
+    message_descriptor = pool.FindMessageTypeByName(type_name)
+  except KeyError as e:
+    raise TypeError(
+        'Can not find message descriptor by type_url: {0}'.format(type_url)
+      ) from e
+  message_class = message_factory.GetMessageClass(message_descriptor)
+  return message_class()
+
+
+def Parse(text,
+          message,
+          ignore_unknown_fields=False,
+          descriptor_pool=None,
+          max_recursion_depth=100):
+  """Parses a JSON representation of a protocol message into a message.
+
+  Args:
+    text: Message JSON representation.
+    message: A protocol buffer message to merge into.
+    ignore_unknown_fields: If True, do not raise errors for unknown fields.
+    descriptor_pool: A Descriptor Pool for resolving types. If None use the
+      default.
+    max_recursion_depth: max recursion depth of JSON message to be
+      deserialized. JSON messages over this depth will fail to be
+      deserialized. Default value is 100.
+
+  Returns:
+    The same message passed as argument.
+
+  Raises::
+    ParseError: On JSON parsing problems.
+  """
+  if not isinstance(text, str):
+    text = text.decode('utf-8')
+  try:
+    js = json.loads(text, object_pairs_hook=_DuplicateChecker)
+  except ValueError as e:
+    raise ParseError('Failed to load JSON: {0}.'.format(str(e))) from e
+  return ParseDict(js, message, ignore_unknown_fields, descriptor_pool,
+                   max_recursion_depth)
+
+
+def ParseDict(js_dict,
+              message,
+              ignore_unknown_fields=False,
+              descriptor_pool=None,
+              max_recursion_depth=100):
+  """Parses a JSON dictionary representation into a message.
+
+  Args:
+    js_dict: Dict representation of a JSON message.
+    message: A protocol buffer message to merge into.
+    ignore_unknown_fields: If True, do not raise errors for unknown fields.
+    descriptor_pool: A Descriptor Pool for resolving types. If None use the
+      default.
+    max_recursion_depth: max recursion depth of JSON message to be
+      deserialized. JSON messages over this depth will fail to be
+      deserialized. Default value is 100.
+
+  Returns:
+    The same message passed as argument.
+  """
+  parser = _Parser(ignore_unknown_fields, descriptor_pool, max_recursion_depth)
+  parser.ConvertMessage(js_dict, message, '')
+  return message
+
+
+_INT_OR_FLOAT = (int, float)
+
+
+class _Parser(object):
+  """JSON format parser for protocol message."""
+
+  def __init__(self, ignore_unknown_fields, descriptor_pool,
+               max_recursion_depth):
+    self.ignore_unknown_fields = ignore_unknown_fields
+    self.descriptor_pool = descriptor_pool
+    self.max_recursion_depth = max_recursion_depth
+    self.recursion_depth = 0
+
+  def ConvertMessage(self, value, message, path):
+    """Convert a JSON object into a message.
+
+    Args:
+      value: A JSON object.
+      message: A WKT or regular protocol message to record the data.
+      path: parent path to log parse error info.
+
+    Raises:
+      ParseError: In case of convert problems.
+    """
+    self.recursion_depth += 1
+    if self.recursion_depth > self.max_recursion_depth:
+      raise ParseError('Message too deep. Max recursion depth is {0}'.format(
+          self.max_recursion_depth))
+    message_descriptor = message.DESCRIPTOR
+    full_name = message_descriptor.full_name
+    if not path:
+      path = message_descriptor.name
+    if _IsWrapperMessage(message_descriptor):
+      self._ConvertWrapperMessage(value, message, path)
+    elif full_name in _WKTJSONMETHODS:
+      methodcaller(_WKTJSONMETHODS[full_name][1], value, message, path)(self)
+    else:
+      self._ConvertFieldValuePair(value, message, path)
+    self.recursion_depth -= 1
+
+  def _ConvertFieldValuePair(self, js, message, path):
+    """Convert field value pairs into regular message.
+
+    Args:
+      js: A JSON object to convert the field value pairs.
+      message: A regular protocol message to record the data.
+      path: parent path to log parse error info.
+
+    Raises:
+      ParseError: In case of problems converting.
+    """
+    names = []
+    message_descriptor = message.DESCRIPTOR
+    fields_by_json_name = dict((f.json_name, f)
+                               for f in message_descriptor.fields)
+    for name in js:
+      try:
+        field = fields_by_json_name.get(name, None)
+        if not field:
+          field = message_descriptor.fields_by_name.get(name, None)
+        if not field and _VALID_EXTENSION_NAME.match(name):
+          if not message_descriptor.is_extendable:
+            raise ParseError(
+                'Message type {0} does not have extensions at {1}'.format(
+                    message_descriptor.full_name, path))
+          identifier = name[1:-1]  # strip [] brackets
+          # pylint: disable=protected-access
+          field = message.Extensions._FindExtensionByName(identifier)
+          # pylint: enable=protected-access
+          if not field:
+            # Try looking for extension by the message type name, dropping the
+            # field name following the final . separator in full_name.
+            identifier = '.'.join(identifier.split('.')[:-1])
+            # pylint: disable=protected-access
+            field = message.Extensions._FindExtensionByName(identifier)
+            # pylint: enable=protected-access
+        if not field:
+          if self.ignore_unknown_fields:
+            continue
+          raise ParseError(
+              ('Message type "{0}" has no field named "{1}" at "{2}".\n'
+               ' Available Fields(except extensions): "{3}"').format(
+                   message_descriptor.full_name, name, path,
+                   [f.json_name for f in message_descriptor.fields]))
+        if name in names:
+          raise ParseError('Message type "{0}" should not have multiple '
+                           '"{1}" fields at "{2}".'.format(
+                               message.DESCRIPTOR.full_name, name, path))
+        names.append(name)
+        value = js[name]
+        # Check no other oneof field is parsed.
+        if field.containing_oneof is not None and value is not None:
+          oneof_name = field.containing_oneof.name
+          if oneof_name in names:
+            raise ParseError('Message type "{0}" should not have multiple '
+                             '"{1}" oneof fields at "{2}".'.format(
+                                 message.DESCRIPTOR.full_name, oneof_name,
+                                 path))
+          names.append(oneof_name)
+
+        if value is None:
+          if (field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE
+              and field.message_type.full_name == 'google.protobuf.Value'):
+            sub_message = getattr(message, field.name)
+            sub_message.null_value = 0
+          elif (field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_ENUM
+                and field.enum_type.full_name == 'google.protobuf.NullValue'):
+            setattr(message, field.name, 0)
+          else:
+            message.ClearField(field.name)
+          continue
+
+        # Parse field value.
+        if _IsMapEntry(field):
+          message.ClearField(field.name)
+          self._ConvertMapFieldValue(value, message, field,
+                                     '{0}.{1}'.format(path, name))
+        elif field.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+          message.ClearField(field.name)
+          if not isinstance(value, list):
+            raise ParseError('repeated field {0} must be in [] which is '
+                             '{1} at {2}'.format(name, value, path))
+          if field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+            # Repeated message field.
+            for index, item in enumerate(value):
+              sub_message = getattr(message, field.name).add()
+              # None is a null_value in Value.
+              if (item is None and
+                  sub_message.DESCRIPTOR.full_name != 'google.protobuf.Value'):
+                raise ParseError('null is not allowed to be used as an element'
+                                 ' in a repeated field at {0}.{1}[{2}]'.format(
+                                     path, name, index))
+              self.ConvertMessage(item, sub_message,
+                                  '{0}.{1}[{2}]'.format(path, name, index))
+          else:
+            # Repeated scalar field.
+            for index, item in enumerate(value):
+              if item is None:
+                raise ParseError('null is not allowed to be used as an element'
+                                 ' in a repeated field at {0}.{1}[{2}]'.format(
+                                     path, name, index))
+              getattr(message, field.name).append(
+                  _ConvertScalarFieldValue(
+                      item, field, '{0}.{1}[{2}]'.format(path, name, index)))
+        elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+          if field.is_extension:
+            sub_message = message.Extensions[field]
+          else:
+            sub_message = getattr(message, field.name)
+          sub_message.SetInParent()
+          self.ConvertMessage(value, sub_message, '{0}.{1}'.format(path, name))
+        else:
+          if field.is_extension:
+            message.Extensions[field] = _ConvertScalarFieldValue(
+                value, field, '{0}.{1}'.format(path, name))
+          else:
+            setattr(
+                message, field.name,
+                _ConvertScalarFieldValue(value, field,
+                                         '{0}.{1}'.format(path, name)))
+      except ParseError as e:
+        if field and field.containing_oneof is None:
+          raise ParseError(
+            'Failed to parse {0} field: {1}.'.format(name, e)
+          ) from e
+        else:
+          raise ParseError(str(e)) from e
+      except ValueError as e:
+        raise ParseError(
+          'Failed to parse {0} field: {1}.'.format(name, e)
+        ) from e
+      except TypeError as e:
+        raise ParseError(
+          'Failed to parse {0} field: {1}.'.format(name, e)
+        ) from e
+
+  def _ConvertAnyMessage(self, value, message, path):
+    """Convert a JSON representation into Any message."""
+    if isinstance(value, dict) and not value:
+      return
+    try:
+      type_url = value['@type']
+    except KeyError as e:
+      raise ParseError(
+        '@type is missing when parsing any message at {0}'.format(path)
+      ) from e
+
+    try:
+      sub_message = _CreateMessageFromTypeUrl(type_url, self.descriptor_pool)
+    except TypeError as e:
+      raise ParseError('{0} at {1}'.format(e, path)) from e
+    message_descriptor = sub_message.DESCRIPTOR
+    full_name = message_descriptor.full_name
+    if _IsWrapperMessage(message_descriptor):
+      self._ConvertWrapperMessage(value['value'], sub_message,
+                                  '{0}.value'.format(path))
+    elif full_name in _WKTJSONMETHODS:
+      methodcaller(_WKTJSONMETHODS[full_name][1], value['value'], sub_message,
+                   '{0}.value'.format(path))(
+                       self)
+    else:
+      del value['@type']
+      self._ConvertFieldValuePair(value, sub_message, path)
+      value['@type'] = type_url
+    # Sets Any message
+    message.value = sub_message.SerializeToString()
+    message.type_url = type_url
+
+  def _ConvertGenericMessage(self, value, message, path):
+    """Convert a JSON representation into message with FromJsonString."""
+    # Duration, Timestamp, FieldMask have a FromJsonString method to do the
+    # conversion. Users can also call the method directly.
+    try:
+      message.FromJsonString(value)
+    except ValueError as e:
+      raise ParseError('{0} at {1}'.format(e, path)) from e
+
+  def _ConvertValueMessage(self, value, message, path):
+    """Convert a JSON representation into Value message."""
+    if isinstance(value, dict):
+      self._ConvertStructMessage(value, message.struct_value, path)
+    elif isinstance(value, list):
+      self._ConvertListValueMessage(value, message.list_value, path)
+    elif value is None:
+      message.null_value = 0
+    elif isinstance(value, bool):
+      message.bool_value = value
+    elif isinstance(value, str):
+      message.string_value = value
+    elif isinstance(value, _INT_OR_FLOAT):
+      message.number_value = value
+    else:
+      raise ParseError('Value {0} has unexpected type {1} at {2}'.format(
+          value, type(value), path))
+
+  def _ConvertListValueMessage(self, value, message, path):
+    """Convert a JSON representation into ListValue message."""
+    if not isinstance(value, list):
+      raise ParseError('ListValue must be in [] which is {0} at {1}'.format(
+          value, path))
+    message.ClearField('values')
+    for index, item in enumerate(value):
+      self._ConvertValueMessage(item, message.values.add(),
+                                '{0}[{1}]'.format(path, index))
+
+  def _ConvertStructMessage(self, value, message, path):
+    """Convert a JSON representation into Struct message."""
+    if not isinstance(value, dict):
+      raise ParseError('Struct must be in a dict which is {0} at {1}'.format(
+          value, path))
+    # Clear will mark the struct as modified so it will be created even if
+    # there are no values.
+    message.Clear()
+    for key in value:
+      self._ConvertValueMessage(value[key], message.fields[key],
+                                '{0}.{1}'.format(path, key))
+    return
+
+  def _ConvertWrapperMessage(self, value, message, path):
+    """Convert a JSON representation into Wrapper message."""
+    field = message.DESCRIPTOR.fields_by_name['value']
+    setattr(
+        message, 'value',
+        _ConvertScalarFieldValue(value, field, path='{0}.value'.format(path)))
+
+  def _ConvertMapFieldValue(self, value, message, field, path):
+    """Convert map field value for a message map field.
+
+    Args:
+      value: A JSON object to convert the map field value.
+      message: A protocol message to record the converted data.
+      field: The descriptor of the map field to be converted.
+      path: parent path to log parse error info.
+
+    Raises:
+      ParseError: In case of convert problems.
+    """
+    if not isinstance(value, dict):
+      raise ParseError(
+          'Map field {0} must be in a dict which is {1} at {2}'.format(
+              field.name, value, path))
+    key_field = field.message_type.fields_by_name['key']
+    value_field = field.message_type.fields_by_name['value']
+    for key in value:
+      key_value = _ConvertScalarFieldValue(key, key_field,
+                                           '{0}.key'.format(path), True)
+      if value_field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+        self.ConvertMessage(value[key],
+                            getattr(message, field.name)[key_value],
+                            '{0}[{1}]'.format(path, key_value))
+      else:
+        getattr(message, field.name)[key_value] = _ConvertScalarFieldValue(
+            value[key], value_field, path='{0}[{1}]'.format(path, key_value))
+
+
+def _ConvertScalarFieldValue(value, field, path, require_str=False):
+  """Convert a single scalar field value.
+
+  Args:
+    value: A scalar value to convert the scalar field value.
+    field: The descriptor of the field to convert.
+    path: parent path to log parse error info.
+    require_str: If True, the field value must be a str.
+
+  Returns:
+    The converted scalar field value
+
+  Raises:
+    ParseError: In case of convert problems.
+  """
+  try:
+    if field.cpp_type in _INT_TYPES:
+      return _ConvertInteger(value)
+    elif field.cpp_type in _FLOAT_TYPES:
+      return _ConvertFloat(value, field)
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_BOOL:
+      return _ConvertBool(value, require_str)
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_STRING:
+      if field.type == descriptor.FieldDescriptor.TYPE_BYTES:
+        if isinstance(value, str):
+          encoded = value.encode('utf-8')
+        else:
+          encoded = value
+        # Add extra padding '='
+        padded_value = encoded + b'=' * (4 - len(encoded) % 4)
+        return base64.urlsafe_b64decode(padded_value)
+      else:
+        # Checking for unpaired surrogates appears to be unreliable,
+        # depending on the specific Python version, so we check manually.
+        if _UNPAIRED_SURROGATE_PATTERN.search(value):
+          raise ParseError('Unpaired surrogate')
+        return value
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_ENUM:
+      # Convert an enum value.
+      enum_value = field.enum_type.values_by_name.get(value, None)
+      if enum_value is None:
+        try:
+          number = int(value)
+          enum_value = field.enum_type.values_by_number.get(number, None)
+        except ValueError as e:
+          raise ParseError('Invalid enum value {0} for enum type {1}'.format(
+              value, field.enum_type.full_name)) from e
+        if enum_value is None:
+          if field.enum_type.is_closed:
+            raise ParseError('Invalid enum value {0} for enum type {1}'.format(
+                value, field.enum_type.full_name))
+          else:
+            return number
+      return enum_value.number
+  except ParseError as e:
+    raise ParseError('{0} at {1}'.format(e, path)) from e
+
+
+def _ConvertInteger(value):
+  """Convert an integer.
+
+  Args:
+    value: A scalar value to convert.
+
+  Returns:
+    The integer value.
+
+  Raises:
+    ParseError: If an integer couldn't be consumed.
+  """
+  if isinstance(value, float) and not value.is_integer():
+    raise ParseError('Couldn\'t parse integer: {0}'.format(value))
+
+  if isinstance(value, str) and value.find(' ') != -1:
+    raise ParseError('Couldn\'t parse integer: "{0}"'.format(value))
+
+  if isinstance(value, bool):
+    raise ParseError('Bool value {0} is not acceptable for '
+                     'integer field'.format(value))
+
+  return int(value)
+
+
+def _ConvertFloat(value, field):
+  """Convert an floating point number."""
+  if isinstance(value, float):
+    if math.isnan(value):
+      raise ParseError('Couldn\'t parse NaN, use quoted "NaN" instead')
+    if math.isinf(value):
+      if value > 0:
+        raise ParseError('Couldn\'t parse Infinity or value too large, '
+                         'use quoted "Infinity" instead')
+      else:
+        raise ParseError('Couldn\'t parse -Infinity or value too small, '
+                         'use quoted "-Infinity" instead')
+    if field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_FLOAT:
+      # pylint: disable=protected-access
+      if value > type_checkers._FLOAT_MAX:
+        raise ParseError('Float value too large')
+      # pylint: disable=protected-access
+      if value < type_checkers._FLOAT_MIN:
+        raise ParseError('Float value too small')
+  if value == 'nan':
+    raise ParseError('Couldn\'t parse float "nan", use "NaN" instead')
+  try:
+    # Assume Python compatible syntax.
+    return float(value)
+  except ValueError as e:
+    # Check alternative spellings.
+    if value == _NEG_INFINITY:
+      return float('-inf')
+    elif value == _INFINITY:
+      return float('inf')
+    elif value == _NAN:
+      return float('nan')
+    else:
+      raise ParseError('Couldn\'t parse float: {0}'.format(value)) from e
+
+
+def _ConvertBool(value, require_str):
+  """Convert a boolean value.
+
+  Args:
+    value: A scalar value to convert.
+    require_str: If True, value must be a str.
+
+  Returns:
+    The bool parsed.
+
+  Raises:
+    ParseError: If a boolean value couldn't be consumed.
+  """
+  if require_str:
+    if value == 'true':
+      return True
+    elif value == 'false':
+      return False
+    else:
+      raise ParseError('Expected "true" or "false", not {0}'.format(value))
+
+  if not isinstance(value, bool):
+    raise ParseError('Expected true or false without quotes')
+  return value
+
+_WKTJSONMETHODS = {
+    'google.protobuf.Any': ['_AnyMessageToJsonObject',
+                            '_ConvertAnyMessage'],
+    'google.protobuf.Duration': ['_GenericMessageToJsonObject',
+                                 '_ConvertGenericMessage'],
+    'google.protobuf.FieldMask': ['_GenericMessageToJsonObject',
+                                  '_ConvertGenericMessage'],
+    'google.protobuf.ListValue': ['_ListValueMessageToJsonObject',
+                                  '_ConvertListValueMessage'],
+    'google.protobuf.Struct': ['_StructMessageToJsonObject',
+                               '_ConvertStructMessage'],
+    'google.protobuf.Timestamp': ['_GenericMessageToJsonObject',
+                                  '_ConvertGenericMessage'],
+    'google.protobuf.Value': ['_ValueMessageToJsonObject',
+                              '_ConvertValueMessage']
+}
diff --git a/llm/Lib/site-packages/google/protobuf/message.py b/llm/Lib/site-packages/google/protobuf/message.py
new file mode 100644
index 0000000000000000000000000000000000000000..29ebd7b0e2e7cdc994ae529eb06c636b336e27f5
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/message.py
@@ -0,0 +1,399 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+# TODO: We should just make these methods all "pure-virtual" and move
+# all implementation out, into reflection.py for now.
+
+
+"""Contains an abstract base class for protocol messages."""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+class Error(Exception):
+  """Base error type for this module."""
+  pass
+
+
+class DecodeError(Error):
+  """Exception raised when deserializing messages."""
+  pass
+
+
+class EncodeError(Error):
+  """Exception raised when serializing messages."""
+  pass
+
+
+class Message(object):
+
+  """Abstract base class for protocol messages.
+
+  Protocol message classes are almost always generated by the protocol
+  compiler.  These generated types subclass Message and implement the methods
+  shown below.
+  """
+
+  # TODO: Link to an HTML document here.
+
+  # TODO: Document that instances of this class will also
+  # have an Extensions attribute with __getitem__ and __setitem__.
+  # Again, not sure how to best convey this.
+
+  # TODO: Document these fields and methods.
+
+  __slots__ = []
+
+  #: The :class:`google.protobuf.Descriptor`
+  # for this message type.
+  DESCRIPTOR = None
+
+  def __deepcopy__(self, memo=None):
+    clone = type(self)()
+    clone.MergeFrom(self)
+    return clone
+
+  def __eq__(self, other_msg):
+    """Recursively compares two messages by value and structure."""
+    raise NotImplementedError
+
+  def __ne__(self, other_msg):
+    # Can't just say self != other_msg, since that would infinitely recurse. :)
+    return not self == other_msg
+
+  def __hash__(self):
+    raise TypeError('unhashable object')
+
+  def __str__(self):
+    """Outputs a human-readable representation of the message."""
+    raise NotImplementedError
+
+  def __unicode__(self):
+    """Outputs a human-readable representation of the message."""
+    raise NotImplementedError
+
+  def MergeFrom(self, other_msg):
+    """Merges the contents of the specified message into current message.
+
+    This method merges the contents of the specified message into the current
+    message. Singular fields that are set in the specified message overwrite
+    the corresponding fields in the current message. Repeated fields are
+    appended. Singular sub-messages and groups are recursively merged.
+
+    Args:
+      other_msg (Message): A message to merge into the current message.
+    """
+    raise NotImplementedError
+
+  def CopyFrom(self, other_msg):
+    """Copies the content of the specified message into the current message.
+
+    The method clears the current message and then merges the specified
+    message using MergeFrom.
+
+    Args:
+      other_msg (Message): A message to copy into the current one.
+    """
+    if self is other_msg:
+      return
+    self.Clear()
+    self.MergeFrom(other_msg)
+
+  def Clear(self):
+    """Clears all data that was set in the message."""
+    raise NotImplementedError
+
+  def SetInParent(self):
+    """Mark this as present in the parent.
+
+    This normally happens automatically when you assign a field of a
+    sub-message, but sometimes you want to make the sub-message
+    present while keeping it empty.  If you find yourself using this,
+    you may want to reconsider your design.
+    """
+    raise NotImplementedError
+
+  def IsInitialized(self):
+    """Checks if the message is initialized.
+
+    Returns:
+      bool: The method returns True if the message is initialized (i.e. all of
+      its required fields are set).
+    """
+    raise NotImplementedError
+
+  # TODO: MergeFromString() should probably return None and be
+  # implemented in terms of a helper that returns the # of bytes read.  Our
+  # deserialization routines would use the helper when recursively
+  # deserializing, but the end user would almost always just want the no-return
+  # MergeFromString().
+
+  def MergeFromString(self, serialized):
+    """Merges serialized protocol buffer data into this message.
+
+    When we find a field in `serialized` that is already present
+    in this message:
+
+    -   If it's a "repeated" field, we append to the end of our list.
+    -   Else, if it's a scalar, we overwrite our field.
+    -   Else, (it's a nonrepeated composite), we recursively merge
+        into the existing composite.
+
+    Args:
+      serialized (bytes): Any object that allows us to call
+        ``memoryview(serialized)`` to access a string of bytes using the
+        buffer interface.
+
+    Returns:
+      int: The number of bytes read from `serialized`.
+      For non-group messages, this will always be `len(serialized)`,
+      but for messages which are actually groups, this will
+      generally be less than `len(serialized)`, since we must
+      stop when we reach an ``END_GROUP`` tag.  Note that if
+      we *do* stop because of an ``END_GROUP`` tag, the number
+      of bytes returned does not include the bytes
+      for the ``END_GROUP`` tag information.
+
+    Raises:
+      DecodeError: if the input cannot be parsed.
+    """
+    # TODO: Document handling of unknown fields.
+    # TODO: When we switch to a helper, this will return None.
+    raise NotImplementedError
+
+  def ParseFromString(self, serialized):
+    """Parse serialized protocol buffer data in binary form into this message.
+
+    Like :func:`MergeFromString()`, except we clear the object first.
+
+    Raises:
+      message.DecodeError if the input cannot be parsed.
+    """
+    self.Clear()
+    return self.MergeFromString(serialized)
+
+  def SerializeToString(self, **kwargs):
+    """Serializes the protocol message to a binary string.
+
+    Keyword Args:
+      deterministic (bool): If true, requests deterministic serialization
+        of the protobuf, with predictable ordering of map keys.
+
+    Returns:
+      A binary string representation of the message if all of the required
+      fields in the message are set (i.e. the message is initialized).
+
+    Raises:
+      EncodeError: if the message isn't initialized (see :func:`IsInitialized`).
+    """
+    raise NotImplementedError
+
+  def SerializePartialToString(self, **kwargs):
+    """Serializes the protocol message to a binary string.
+
+    This method is similar to SerializeToString but doesn't check if the
+    message is initialized.
+
+    Keyword Args:
+      deterministic (bool): If true, requests deterministic serialization
+        of the protobuf, with predictable ordering of map keys.
+
+    Returns:
+      bytes: A serialized representation of the partial message.
+    """
+    raise NotImplementedError
+
+  # TODO: Decide whether we like these better
+  # than auto-generated has_foo() and clear_foo() methods
+  # on the instances themselves.  This way is less consistent
+  # with C++, but it makes reflection-type access easier and
+  # reduces the number of magically autogenerated things.
+  #
+  # TODO: Be sure to document (and test) exactly
+  # which field names are accepted here.  Are we case-sensitive?
+  # What do we do with fields that share names with Python keywords
+  # like 'lambda' and 'yield'?
+  #
+  # nnorwitz says:
+  # """
+  # Typically (in python), an underscore is appended to names that are
+  # keywords. So they would become lambda_ or yield_.
+  # """
+  def ListFields(self):
+    """Returns a list of (FieldDescriptor, value) tuples for present fields.
+
+    A message field is non-empty if HasField() would return true. A singular
+    primitive field is non-empty if HasField() would return true in proto2 or it
+    is non zero in proto3. A repeated field is non-empty if it contains at least
+    one element. The fields are ordered by field number.
+
+    Returns:
+      list[tuple(FieldDescriptor, value)]: field descriptors and values
+      for all fields in the message which are not empty. The values vary by
+      field type.
+    """
+    raise NotImplementedError
+
+  def HasField(self, field_name):
+    """Checks if a certain field is set for the message.
+
+    For a oneof group, checks if any field inside is set. Note that if the
+    field_name is not defined in the message descriptor, :exc:`ValueError` will
+    be raised.
+
+    Args:
+      field_name (str): The name of the field to check for presence.
+
+    Returns:
+      bool: Whether a value has been set for the named field.
+
+    Raises:
+      ValueError: if the `field_name` is not a member of this message.
+    """
+    raise NotImplementedError
+
+  def ClearField(self, field_name):
+    """Clears the contents of a given field.
+
+    Inside a oneof group, clears the field set. If the name neither refers to a
+    defined field or oneof group, :exc:`ValueError` is raised.
+
+    Args:
+      field_name (str): The name of the field to check for presence.
+
+    Raises:
+      ValueError: if the `field_name` is not a member of this message.
+    """
+    raise NotImplementedError
+
+  def WhichOneof(self, oneof_group):
+    """Returns the name of the field that is set inside a oneof group.
+
+    If no field is set, returns None.
+
+    Args:
+      oneof_group (str): the name of the oneof group to check.
+
+    Returns:
+      str or None: The name of the group that is set, or None.
+
+    Raises:
+      ValueError: no group with the given name exists
+    """
+    raise NotImplementedError
+
+  def HasExtension(self, field_descriptor):
+    """Checks if a certain extension is present for this message.
+
+    Extensions are retrieved using the :attr:`Extensions` mapping (if present).
+
+    Args:
+      field_descriptor: The field descriptor for the extension to check.
+
+    Returns:
+      bool: Whether the extension is present for this message.
+
+    Raises:
+      KeyError: if the extension is repeated. Similar to repeated fields,
+        there is no separate notion of presence: a "not present" repeated
+        extension is an empty list.
+    """
+    raise NotImplementedError
+
+  def ClearExtension(self, field_descriptor):
+    """Clears the contents of a given extension.
+
+    Args:
+      field_descriptor: The field descriptor for the extension to clear.
+    """
+    raise NotImplementedError
+
+  def UnknownFields(self):
+    """Returns the UnknownFieldSet.
+
+    Returns:
+      UnknownFieldSet: The unknown fields stored in this message.
+    """
+    raise NotImplementedError
+
+  def DiscardUnknownFields(self):
+    """Clears all fields in the :class:`UnknownFieldSet`.
+
+    This operation is recursive for nested message.
+    """
+    raise NotImplementedError
+
+  def ByteSize(self):
+    """Returns the serialized size of this message.
+
+    Recursively calls ByteSize() on all contained messages.
+
+    Returns:
+      int: The number of bytes required to serialize this message.
+    """
+    raise NotImplementedError
+
+  @classmethod
+  def FromString(cls, s):
+    raise NotImplementedError
+
+# TODO: Remove it in OSS
+  @staticmethod
+  def RegisterExtension(field_descriptor):
+    raise NotImplementedError
+
+  def _SetListener(self, message_listener):
+    """Internal method used by the protocol message implementation.
+    Clients should not call this directly.
+
+    Sets a listener that this message will call on certain state transitions.
+
+    The purpose of this method is to register back-edges from children to
+    parents at runtime, for the purpose of setting "has" bits and
+    byte-size-dirty bits in the parent and ancestor objects whenever a child or
+    descendant object is modified.
+
+    If the client wants to disconnect this Message from the object tree, she
+    explicitly sets callback to None.
+
+    If message_listener is None, unregisters any existing listener.  Otherwise,
+    message_listener must implement the MessageListener interface in
+    internal/message_listener.py, and we discard any listener registered
+    via a previous _SetListener() call.
+    """
+    raise NotImplementedError
+
+  def __getstate__(self):
+    """Support the pickle protocol."""
+    return dict(serialized=self.SerializePartialToString())
+
+  def __setstate__(self, state):
+    """Support the pickle protocol."""
+    self.__init__()
+    serialized = state['serialized']
+    # On Python 3, using encoding='latin1' is required for unpickling
+    # protos pickled by Python 2.
+    if not isinstance(serialized, bytes):
+      serialized = serialized.encode('latin1')
+    self.ParseFromString(serialized)
+
+  def __reduce__(self):
+    message_descriptor = self.DESCRIPTOR
+    if message_descriptor.containing_type is None:
+      return type(self), (), self.__getstate__()
+    # the message type must be nested.
+    # Python does not pickle nested classes; use the symbol_database on the
+    # receiving end.
+    container = message_descriptor
+    return (_InternalConstructMessage, (container.full_name,),
+            self.__getstate__())
+
+
+def _InternalConstructMessage(full_name):
+  """Constructs a nested message."""
+  from google.protobuf import symbol_database  # pylint:disable=g-import-not-at-top
+
+  return symbol_database.Default().GetSymbol(full_name)()
diff --git a/llm/Lib/site-packages/google/protobuf/message_factory.py b/llm/Lib/site-packages/google/protobuf/message_factory.py
new file mode 100644
index 0000000000000000000000000000000000000000..56fff6de676722f417b9b8bb169c1c8e1173e8b1
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/message_factory.py
@@ -0,0 +1,233 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Provides a factory class for generating dynamic messages.
+
+The easiest way to use this class is if you have access to the FileDescriptor
+protos containing the messages you want to create you can just do the following:
+
+message_classes = message_factory.GetMessages(iterable_of_file_descriptors)
+my_proto_instance = message_classes['some.proto.package.MessageName']()
+"""
+
+__author__ = 'matthewtoia@google.com (Matt Toia)'
+
+import warnings
+
+from google.protobuf.internal import api_implementation
+from google.protobuf import descriptor_pool
+from google.protobuf import message
+
+if api_implementation.Type() == 'python':
+  from google.protobuf.internal import python_message as message_impl
+else:
+  from google.protobuf.pyext import cpp_message as message_impl  # pylint: disable=g-import-not-at-top
+
+
+# The type of all Message classes.
+_GENERATED_PROTOCOL_MESSAGE_TYPE = message_impl.GeneratedProtocolMessageType
+
+
+def GetMessageClass(descriptor):
+  """Obtains a proto2 message class based on the passed in descriptor.
+
+  Passing a descriptor with a fully qualified name matching a previous
+  invocation will cause the same class to be returned.
+
+  Args:
+    descriptor: The descriptor to build from.
+
+  Returns:
+    A class describing the passed in descriptor.
+  """
+  concrete_class = getattr(descriptor, '_concrete_class', None)
+  if concrete_class:
+    return concrete_class
+  return _InternalCreateMessageClass(descriptor)
+
+
+def GetMessageClassesForFiles(files, pool):
+  """Gets all the messages from specified files.
+
+  This will find and resolve dependencies, failing if the descriptor
+  pool cannot satisfy them.
+
+  Args:
+    files: The file names to extract messages from.
+    pool: The descriptor pool to find the files including the dependent
+      files.
+
+  Returns:
+    A dictionary mapping proto names to the message classes.
+  """
+  result = {}
+  for file_name in files:
+    file_desc = pool.FindFileByName(file_name)
+    for desc in file_desc.message_types_by_name.values():
+      result[desc.full_name] = GetMessageClass(desc)
+
+    # While the extension FieldDescriptors are created by the descriptor pool,
+    # the python classes created in the factory need them to be registered
+    # explicitly, which is done below.
+    #
+    # The call to RegisterExtension will specifically check if the
+    # extension was already registered on the object and either
+    # ignore the registration if the original was the same, or raise
+    # an error if they were different.
+
+    for extension in file_desc.extensions_by_name.values():
+      extended_class = GetMessageClass(extension.containing_type)
+      if api_implementation.Type() != 'python':
+        # TODO: Remove this check here. Duplicate extension
+        # register check should be in descriptor_pool.
+        if extension is not pool.FindExtensionByNumber(
+            extension.containing_type, extension.number
+        ):
+          raise ValueError('Double registration of Extensions')
+      # Recursively load protos for extension field, in order to be able to
+      # fully represent the extension. This matches the behavior for regular
+      # fields too.
+      if extension.message_type:
+        GetMessageClass(extension.message_type)
+  return result
+
+
+def _InternalCreateMessageClass(descriptor):
+  """Builds a proto2 message class based on the passed in descriptor.
+
+  Args:
+    descriptor: The descriptor to build from.
+
+  Returns:
+    A class describing the passed in descriptor.
+  """
+  descriptor_name = descriptor.name
+  result_class = _GENERATED_PROTOCOL_MESSAGE_TYPE(
+      descriptor_name,
+      (message.Message,),
+      {
+          'DESCRIPTOR': descriptor,
+          # If module not set, it wrongly points to message_factory module.
+          '__module__': None,
+      })
+  for field in descriptor.fields:
+    if field.message_type:
+      GetMessageClass(field.message_type)
+  for extension in result_class.DESCRIPTOR.extensions:
+    extended_class = GetMessageClass(extension.containing_type)
+    if api_implementation.Type() != 'python':
+      # TODO: Remove this check here. Duplicate extension
+      # register check should be in descriptor_pool.
+      pool = extension.containing_type.file.pool
+      if extension is not pool.FindExtensionByNumber(
+          extension.containing_type, extension.number
+      ):
+        raise ValueError('Double registration of Extensions')
+    if extension.message_type:
+      GetMessageClass(extension.message_type)
+  return result_class
+
+
+# Deprecated. Please use GetMessageClass() or GetMessageClassesForFiles()
+# method above instead.
+class MessageFactory(object):
+  """Factory for creating Proto2 messages from descriptors in a pool."""
+
+  def __init__(self, pool=None):
+    """Initializes a new factory."""
+    self.pool = pool or descriptor_pool.DescriptorPool()
+
+  def GetPrototype(self, descriptor):
+    """Obtains a proto2 message class based on the passed in descriptor.
+
+    Passing a descriptor with a fully qualified name matching a previous
+    invocation will cause the same class to be returned.
+
+    Args:
+      descriptor: The descriptor to build from.
+
+    Returns:
+      A class describing the passed in descriptor.
+    """
+    warnings.warn(
+        'MessageFactory class is deprecated. Please use '
+        'GetMessageClass() instead of MessageFactory.GetPrototype. '
+        'MessageFactory class will be removed after 2024.',
+        stacklevel=2,
+    )
+    return GetMessageClass(descriptor)
+
+  def CreatePrototype(self, descriptor):
+    """Builds a proto2 message class based on the passed in descriptor.
+
+    Don't call this function directly, it always creates a new class. Call
+    GetMessageClass() instead.
+
+    Args:
+      descriptor: The descriptor to build from.
+
+    Returns:
+      A class describing the passed in descriptor.
+    """
+    warnings.warn(
+        'Directly call CreatePrototype is wrong. Please use '
+        'GetMessageClass() method instead. Directly use '
+        'CreatePrototype will raise error after July 2023.',
+        stacklevel=2,
+    )
+    return _InternalCreateMessageClass(descriptor)
+
+  def GetMessages(self, files):
+    """Gets all the messages from a specified file.
+
+    This will find and resolve dependencies, failing if the descriptor
+    pool cannot satisfy them.
+
+    Args:
+      files: The file names to extract messages from.
+
+    Returns:
+      A dictionary mapping proto names to the message classes. This will include
+      any dependent messages as well as any messages defined in the same file as
+      a specified message.
+    """
+    warnings.warn(
+        'MessageFactory class is deprecated. Please use '
+        'GetMessageClassesForFiles() instead of '
+        'MessageFactory.GetMessages(). MessageFactory class '
+        'will be removed after 2024.',
+        stacklevel=2,
+    )
+    return GetMessageClassesForFiles(files, self.pool)
+
+
+def GetMessages(file_protos, pool=None):
+  """Builds a dictionary of all the messages available in a set of files.
+
+  Args:
+    file_protos: Iterable of FileDescriptorProto to build messages out of.
+    pool: The descriptor pool to add the file protos.
+
+  Returns:
+    A dictionary mapping proto names to the message classes. This will include
+    any dependent messages as well as any messages defined in the same file as
+    a specified message.
+  """
+  # The cpp implementation of the protocol buffer library requires to add the
+  # message in topological order of the dependency graph.
+  des_pool = pool or descriptor_pool.DescriptorPool()
+  file_by_name = {file_proto.name: file_proto for file_proto in file_protos}
+  def _AddFile(file_proto):
+    for dependency in file_proto.dependency:
+      if dependency in file_by_name:
+        # Remove from elements to be visited, in order to cut cycles.
+        _AddFile(file_by_name.pop(dependency))
+    des_pool.Add(file_proto)
+  while file_by_name:
+    _AddFile(file_by_name.popitem()[1])
+  return GetMessageClassesForFiles(
+      [file_proto.name for file_proto in file_protos], des_pool)
diff --git a/llm/Lib/site-packages/google/protobuf/proto_builder.py b/llm/Lib/site-packages/google/protobuf/proto_builder.py
new file mode 100644
index 0000000000000000000000000000000000000000..803d0040a99b6347d12c1e3891e0928ec8a4751f
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/proto_builder.py
@@ -0,0 +1,111 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Dynamic Protobuf class creator."""
+
+from collections import OrderedDict
+import hashlib
+import os
+
+from google.protobuf import descriptor_pb2
+from google.protobuf import descriptor
+from google.protobuf import descriptor_pool
+from google.protobuf import message_factory
+
+
+def _GetMessageFromFactory(pool, full_name):
+  """Get a proto class from the MessageFactory by name.
+
+  Args:
+    pool: a descriptor pool.
+    full_name: str, the fully qualified name of the proto type.
+  Returns:
+    A class, for the type identified by full_name.
+  Raises:
+    KeyError, if the proto is not found in the factory's descriptor pool.
+  """
+  proto_descriptor = pool.FindMessageTypeByName(full_name)
+  proto_cls = message_factory.GetMessageClass(proto_descriptor)
+  return proto_cls
+
+
+def MakeSimpleProtoClass(fields, full_name=None, pool=None):
+  """Create a Protobuf class whose fields are basic types.
+
+  Note: this doesn't validate field names!
+
+  Args:
+    fields: dict of {name: field_type} mappings for each field in the proto. If
+        this is an OrderedDict the order will be maintained, otherwise the
+        fields will be sorted by name.
+    full_name: optional str, the fully-qualified name of the proto type.
+    pool: optional DescriptorPool instance.
+  Returns:
+    a class, the new protobuf class with a FileDescriptor.
+  """
+  pool_instance = pool or descriptor_pool.DescriptorPool()
+  if full_name is not None:
+    try:
+      proto_cls = _GetMessageFromFactory(pool_instance, full_name)
+      return proto_cls
+    except KeyError:
+      # The factory's DescriptorPool doesn't know about this class yet.
+      pass
+
+  # Get a list of (name, field_type) tuples from the fields dict. If fields was
+  # an OrderedDict we keep the order, but otherwise we sort the field to ensure
+  # consistent ordering.
+  field_items = fields.items()
+  if not isinstance(fields, OrderedDict):
+    field_items = sorted(field_items)
+
+  # Use a consistent file name that is unlikely to conflict with any imported
+  # proto files.
+  fields_hash = hashlib.sha1()
+  for f_name, f_type in field_items:
+    fields_hash.update(f_name.encode('utf-8'))
+    fields_hash.update(str(f_type).encode('utf-8'))
+  proto_file_name = fields_hash.hexdigest() + '.proto'
+
+  # If the proto is anonymous, use the same hash to name it.
+  if full_name is None:
+    full_name = ('net.proto2.python.public.proto_builder.AnonymousProto_' +
+                 fields_hash.hexdigest())
+    try:
+      proto_cls = _GetMessageFromFactory(pool_instance, full_name)
+      return proto_cls
+    except KeyError:
+      # The factory's DescriptorPool doesn't know about this class yet.
+      pass
+
+  # This is the first time we see this proto: add a new descriptor to the pool.
+  pool_instance.Add(
+      _MakeFileDescriptorProto(proto_file_name, full_name, field_items))
+  return _GetMessageFromFactory(pool_instance, full_name)
+
+
+def _MakeFileDescriptorProto(proto_file_name, full_name, field_items):
+  """Populate FileDescriptorProto for MessageFactory's DescriptorPool."""
+  package, name = full_name.rsplit('.', 1)
+  file_proto = descriptor_pb2.FileDescriptorProto()
+  file_proto.name = os.path.join(package.replace('.', '/'), proto_file_name)
+  file_proto.package = package
+  desc_proto = file_proto.message_type.add()
+  desc_proto.name = name
+  for f_number, (f_name, f_type) in enumerate(field_items, 1):
+    field_proto = desc_proto.field.add()
+    field_proto.name = f_name
+    # # If the number falls in the reserved range, reassign it to the correct
+    # # number after the range.
+    if f_number >= descriptor.FieldDescriptor.FIRST_RESERVED_FIELD_NUMBER:
+      f_number += (
+          descriptor.FieldDescriptor.LAST_RESERVED_FIELD_NUMBER -
+          descriptor.FieldDescriptor.FIRST_RESERVED_FIELD_NUMBER + 1)
+    field_proto.number = f_number
+    field_proto.label = descriptor_pb2.FieldDescriptorProto.LABEL_OPTIONAL
+    field_proto.type = f_type
+  return file_proto
diff --git a/llm/Lib/site-packages/google/protobuf/pyext/__init__.py b/llm/Lib/site-packages/google/protobuf/pyext/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/google/protobuf/pyext/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/pyext/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c822c24cc40a9cfde66933bef185aa64d65b02a0
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/pyext/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/pyext/__pycache__/cpp_message.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/pyext/__pycache__/cpp_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1835bd2887a067d2bf965019eee5904832b1c983
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/pyext/__pycache__/cpp_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/pyext/cpp_message.py b/llm/Lib/site-packages/google/protobuf/pyext/cpp_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..623b52fbffc99b9ac0f2401776428bf063ffb7a1
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/pyext/cpp_message.py
@@ -0,0 +1,49 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Protocol message implementation hooks for C++ implementation.
+
+Contains helper functions used to create protocol message classes from
+Descriptor objects at runtime backed by the protocol buffer C++ API.
+"""
+
+__author__ = 'tibell@google.com (Johan Tibell)'
+
+from google.protobuf.internal import api_implementation
+
+
+# pylint: disable=protected-access
+_message = api_implementation._c_module
+# TODO: Remove this import after fix api_implementation
+if _message is None:
+  from google.protobuf.pyext import _message
+
+
+class GeneratedProtocolMessageType(_message.MessageMeta):
+
+  """Metaclass for protocol message classes created at runtime from Descriptors.
+
+  The protocol compiler currently uses this metaclass to create protocol
+  message classes at runtime.  Clients can also manually create their own
+  classes at runtime, as in this example:
+
+  mydescriptor = Descriptor(.....)
+  factory = symbol_database.Default()
+  factory.pool.AddDescriptor(mydescriptor)
+  MyProtoClass = factory.GetPrototype(mydescriptor)
+  myproto_instance = MyProtoClass()
+  myproto.foo_field = 23
+  ...
+
+  The above example will not work for nested types. If you wish to include them,
+  use reflection.MakeClass() instead of manually instantiating the class in
+  order to create the appropriate class structure.
+  """
+
+  # Must be consistent with the protocol-compiler code in
+  # proto2/compiler/internal/generator.*.
+  _DESCRIPTOR_KEY = 'DESCRIPTOR'
diff --git a/llm/Lib/site-packages/google/protobuf/reflection.py b/llm/Lib/site-packages/google/protobuf/reflection.py
new file mode 100644
index 0000000000000000000000000000000000000000..2089f01bca6522f76df5789e2f9fb9173985ba77
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/reflection.py
@@ -0,0 +1,72 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+# This code is meant to work on Python 2.4 and above only.
+
+"""Contains a metaclass and helper functions used to create
+protocol message classes from Descriptor objects at runtime.
+
+Recall that a metaclass is the "type" of a class.
+(A class is to a metaclass what an instance is to a class.)
+
+In this case, we use the GeneratedProtocolMessageType metaclass
+to inject all the useful functionality into the classes
+output by the protocol compiler at compile-time.
+
+The upshot of all this is that the real implementation
+details for ALL pure-Python protocol buffers are *here in
+this file*.
+"""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+
+from google.protobuf import message_factory
+from google.protobuf import symbol_database
+
+# The type of all Message classes.
+# Part of the public interface, but normally only used by message factories.
+GeneratedProtocolMessageType = message_factory._GENERATED_PROTOCOL_MESSAGE_TYPE
+
+MESSAGE_CLASS_CACHE = {}
+
+
+# Deprecated. Please NEVER use reflection.ParseMessage().
+def ParseMessage(descriptor, byte_str):
+  """Generate a new Message instance from this Descriptor and a byte string.
+
+  DEPRECATED: ParseMessage is deprecated because it is using MakeClass().
+  Please use MessageFactory.GetPrototype() instead.
+
+  Args:
+    descriptor: Protobuf Descriptor object
+    byte_str: Serialized protocol buffer byte string
+
+  Returns:
+    Newly created protobuf Message object.
+  """
+  result_class = MakeClass(descriptor)
+  new_msg = result_class()
+  new_msg.ParseFromString(byte_str)
+  return new_msg
+
+
+# Deprecated. Please NEVER use reflection.MakeClass().
+def MakeClass(descriptor):
+  """Construct a class object for a protobuf described by descriptor.
+
+  DEPRECATED: use MessageFactory.GetPrototype() instead.
+
+  Args:
+    descriptor: A descriptor.Descriptor object describing the protobuf.
+  Returns:
+    The Message class object described by the descriptor.
+  """
+  # Original implementation leads to duplicate message classes, which won't play
+  # well with extensions. Message factory info is also missing.
+  # Redirect to message_factory.
+  return message_factory.GetMessageClass(descriptor)
diff --git a/llm/Lib/site-packages/google/protobuf/service.py b/llm/Lib/site-packages/google/protobuf/service.py
new file mode 100644
index 0000000000000000000000000000000000000000..d3e192009fd5fd88713c91d13e98c9da327064e4
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/service.py
@@ -0,0 +1,205 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""DEPRECATED:  Declares the RPC service interfaces.
+
+This module declares the abstract interfaces underlying proto2 RPC
+services.  These are intended to be independent of any particular RPC
+implementation, so that proto2 services can be used on top of a variety
+of implementations.  Starting with version 2.3.0, RPC implementations should
+not try to build on these, but should instead provide code generator plugins
+which generate code specific to the particular RPC implementation.  This way
+the generated code can be more appropriate for the implementation in use
+and can avoid unnecessary layers of indirection.
+"""
+
+__author__ = 'petar@google.com (Petar Petrov)'
+
+
+class RpcException(Exception):
+  """Exception raised on failed blocking RPC method call."""
+  pass
+
+
+class Service(object):
+
+  """Abstract base interface for protocol-buffer-based RPC services.
+
+  Services themselves are abstract classes (implemented either by servers or as
+  stubs), but they subclass this base interface. The methods of this
+  interface can be used to call the methods of the service without knowing
+  its exact type at compile time (analogous to the Message interface).
+  """
+
+  def GetDescriptor():
+    """Retrieves this service's descriptor."""
+    raise NotImplementedError
+
+  def CallMethod(self, method_descriptor, rpc_controller,
+                 request, done):
+    """Calls a method of the service specified by method_descriptor.
+
+    If "done" is None then the call is blocking and the response
+    message will be returned directly.  Otherwise the call is asynchronous
+    and "done" will later be called with the response value.
+
+    In the blocking case, RpcException will be raised on error.
+
+    Preconditions:
+
+    * method_descriptor.service == GetDescriptor
+    * request is of the exact same classes as returned by
+      GetRequestClass(method).
+    * After the call has started, the request must not be modified.
+    * "rpc_controller" is of the correct type for the RPC implementation being
+      used by this Service.  For stubs, the "correct type" depends on the
+      RpcChannel which the stub is using.
+
+    Postconditions:
+
+    * "done" will be called when the method is complete.  This may be
+      before CallMethod() returns or it may be at some point in the future.
+    * If the RPC failed, the response value passed to "done" will be None.
+      Further details about the failure can be found by querying the
+      RpcController.
+    """
+    raise NotImplementedError
+
+  def GetRequestClass(self, method_descriptor):
+    """Returns the class of the request message for the specified method.
+
+    CallMethod() requires that the request is of a particular subclass of
+    Message. GetRequestClass() gets the default instance of this required
+    type.
+
+    Example:
+      method = service.GetDescriptor().FindMethodByName("Foo")
+      request = stub.GetRequestClass(method)()
+      request.ParseFromString(input)
+      service.CallMethod(method, request, callback)
+    """
+    raise NotImplementedError
+
+  def GetResponseClass(self, method_descriptor):
+    """Returns the class of the response message for the specified method.
+
+    This method isn't really needed, as the RpcChannel's CallMethod constructs
+    the response protocol message. It's provided anyway in case it is useful
+    for the caller to know the response type in advance.
+    """
+    raise NotImplementedError
+
+
+class RpcController(object):
+
+  """An RpcController mediates a single method call.
+
+  The primary purpose of the controller is to provide a way to manipulate
+  settings specific to the RPC implementation and to find out about RPC-level
+  errors. The methods provided by the RpcController interface are intended
+  to be a "least common denominator" set of features which we expect all
+  implementations to support.  Specific implementations may provide more
+  advanced features (e.g. deadline propagation).
+  """
+
+  # Client-side methods below
+
+  def Reset(self):
+    """Resets the RpcController to its initial state.
+
+    After the RpcController has been reset, it may be reused in
+    a new call. Must not be called while an RPC is in progress.
+    """
+    raise NotImplementedError
+
+  def Failed(self):
+    """Returns true if the call failed.
+
+    After a call has finished, returns true if the call failed.  The possible
+    reasons for failure depend on the RPC implementation.  Failed() must not
+    be called before a call has finished.  If Failed() returns true, the
+    contents of the response message are undefined.
+    """
+    raise NotImplementedError
+
+  def ErrorText(self):
+    """If Failed is true, returns a human-readable description of the error."""
+    raise NotImplementedError
+
+  def StartCancel(self):
+    """Initiate cancellation.
+
+    Advises the RPC system that the caller desires that the RPC call be
+    canceled.  The RPC system may cancel it immediately, may wait awhile and
+    then cancel it, or may not even cancel the call at all.  If the call is
+    canceled, the "done" callback will still be called and the RpcController
+    will indicate that the call failed at that time.
+    """
+    raise NotImplementedError
+
+  # Server-side methods below
+
+  def SetFailed(self, reason):
+    """Sets a failure reason.
+
+    Causes Failed() to return true on the client side.  "reason" will be
+    incorporated into the message returned by ErrorText().  If you find
+    you need to return machine-readable information about failures, you
+    should incorporate it into your response protocol buffer and should
+    NOT call SetFailed().
+    """
+    raise NotImplementedError
+
+  def IsCanceled(self):
+    """Checks if the client cancelled the RPC.
+
+    If true, indicates that the client canceled the RPC, so the server may
+    as well give up on replying to it.  The server should still call the
+    final "done" callback.
+    """
+    raise NotImplementedError
+
+  def NotifyOnCancel(self, callback):
+    """Sets a callback to invoke on cancel.
+
+    Asks that the given callback be called when the RPC is canceled.  The
+    callback will always be called exactly once.  If the RPC completes without
+    being canceled, the callback will be called after completion.  If the RPC
+    has already been canceled when NotifyOnCancel() is called, the callback
+    will be called immediately.
+
+    NotifyOnCancel() must be called no more than once per request.
+    """
+    raise NotImplementedError
+
+
+class RpcChannel(object):
+
+  """Abstract interface for an RPC channel.
+
+  An RpcChannel represents a communication line to a service which can be used
+  to call that service's methods.  The service may be running on another
+  machine. Normally, you should not use an RpcChannel directly, but instead
+  construct a stub {@link Service} wrapping it.  Example:
+
+  Example:
+    RpcChannel channel = rpcImpl.Channel("remotehost.example.com:1234")
+    RpcController controller = rpcImpl.Controller()
+    MyService service = MyService_Stub(channel)
+    service.MyMethod(controller, request, callback)
+  """
+
+  def CallMethod(self, method_descriptor, rpc_controller,
+                 request, response_class, done):
+    """Calls the method identified by the descriptor.
+
+    Call the given method of the remote service.  The signature of this
+    procedure looks the same as Service.CallMethod(), but the requirements
+    are less strict in one important way:  the request object doesn't have to
+    be of any specific class as long as its descriptor is method.input_type.
+    """
+    raise NotImplementedError
diff --git a/llm/Lib/site-packages/google/protobuf/service_reflection.py b/llm/Lib/site-packages/google/protobuf/service_reflection.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ba3d0b2e448629bc53e1e9c75f0249a0b74c033
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/service_reflection.py
@@ -0,0 +1,272 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Contains metaclasses used to create protocol service and service stub
+classes from ServiceDescriptor objects at runtime.
+
+The GeneratedServiceType and GeneratedServiceStubType metaclasses are used to
+inject all useful functionality into the classes output by the protocol
+compiler at compile-time.
+"""
+
+__author__ = 'petar@google.com (Petar Petrov)'
+
+
+class GeneratedServiceType(type):
+
+  """Metaclass for service classes created at runtime from ServiceDescriptors.
+
+  Implementations for all methods described in the Service class are added here
+  by this class. We also create properties to allow getting/setting all fields
+  in the protocol message.
+
+  The protocol compiler currently uses this metaclass to create protocol service
+  classes at runtime. Clients can also manually create their own classes at
+  runtime, as in this example::
+
+    mydescriptor = ServiceDescriptor(.....)
+    class MyProtoService(service.Service):
+      __metaclass__ = GeneratedServiceType
+      DESCRIPTOR = mydescriptor
+    myservice_instance = MyProtoService()
+    # ...
+  """
+
+  _DESCRIPTOR_KEY = 'DESCRIPTOR'
+
+  def __init__(cls, name, bases, dictionary):
+    """Creates a message service class.
+
+    Args:
+      name: Name of the class (ignored, but required by the metaclass
+        protocol).
+      bases: Base classes of the class being constructed.
+      dictionary: The class dictionary of the class being constructed.
+        dictionary[_DESCRIPTOR_KEY] must contain a ServiceDescriptor object
+        describing this protocol service type.
+    """
+    # Don't do anything if this class doesn't have a descriptor. This happens
+    # when a service class is subclassed.
+    if GeneratedServiceType._DESCRIPTOR_KEY not in dictionary:
+      return
+
+    descriptor = dictionary[GeneratedServiceType._DESCRIPTOR_KEY]
+    service_builder = _ServiceBuilder(descriptor)
+    service_builder.BuildService(cls)
+    cls.DESCRIPTOR = descriptor
+
+
+class GeneratedServiceStubType(GeneratedServiceType):
+
+  """Metaclass for service stubs created at runtime from ServiceDescriptors.
+
+  This class has similar responsibilities as GeneratedServiceType, except that
+  it creates the service stub classes.
+  """
+
+  _DESCRIPTOR_KEY = 'DESCRIPTOR'
+
+  def __init__(cls, name, bases, dictionary):
+    """Creates a message service stub class.
+
+    Args:
+      name: Name of the class (ignored, here).
+      bases: Base classes of the class being constructed.
+      dictionary: The class dictionary of the class being constructed.
+        dictionary[_DESCRIPTOR_KEY] must contain a ServiceDescriptor object
+        describing this protocol service type.
+    """
+    super(GeneratedServiceStubType, cls).__init__(name, bases, dictionary)
+    # Don't do anything if this class doesn't have a descriptor. This happens
+    # when a service stub is subclassed.
+    if GeneratedServiceStubType._DESCRIPTOR_KEY not in dictionary:
+      return
+
+    descriptor = dictionary[GeneratedServiceStubType._DESCRIPTOR_KEY]
+    service_stub_builder = _ServiceStubBuilder(descriptor)
+    service_stub_builder.BuildServiceStub(cls)
+
+
+class _ServiceBuilder(object):
+
+  """This class constructs a protocol service class using a service descriptor.
+
+  Given a service descriptor, this class constructs a class that represents
+  the specified service descriptor. One service builder instance constructs
+  exactly one service class. That means all instances of that class share the
+  same builder.
+  """
+
+  def __init__(self, service_descriptor):
+    """Initializes an instance of the service class builder.
+
+    Args:
+      service_descriptor: ServiceDescriptor to use when constructing the
+        service class.
+    """
+    self.descriptor = service_descriptor
+
+  def BuildService(builder, cls):
+    """Constructs the service class.
+
+    Args:
+      cls: The class that will be constructed.
+    """
+
+    # CallMethod needs to operate with an instance of the Service class. This
+    # internal wrapper function exists only to be able to pass the service
+    # instance to the method that does the real CallMethod work.
+    # Making sure to use exact argument names from the abstract interface in
+    # service.py to match the type signature
+    def _WrapCallMethod(self, method_descriptor, rpc_controller, request, done):
+      return builder._CallMethod(self, method_descriptor, rpc_controller,
+                                 request, done)
+
+    def _WrapGetRequestClass(self, method_descriptor):
+      return builder._GetRequestClass(method_descriptor)
+
+    def _WrapGetResponseClass(self, method_descriptor):
+      return builder._GetResponseClass(method_descriptor)
+
+    builder.cls = cls
+    cls.CallMethod = _WrapCallMethod
+    cls.GetDescriptor = staticmethod(lambda: builder.descriptor)
+    cls.GetDescriptor.__doc__ = 'Returns the service descriptor.'
+    cls.GetRequestClass = _WrapGetRequestClass
+    cls.GetResponseClass = _WrapGetResponseClass
+    for method in builder.descriptor.methods:
+      setattr(cls, method.name, builder._GenerateNonImplementedMethod(method))
+
+  def _CallMethod(self, srvc, method_descriptor,
+                  rpc_controller, request, callback):
+    """Calls the method described by a given method descriptor.
+
+    Args:
+      srvc: Instance of the service for which this method is called.
+      method_descriptor: Descriptor that represent the method to call.
+      rpc_controller: RPC controller to use for this method's execution.
+      request: Request protocol message.
+      callback: A callback to invoke after the method has completed.
+    """
+    if method_descriptor.containing_service != self.descriptor:
+      raise RuntimeError(
+          'CallMethod() given method descriptor for wrong service type.')
+    method = getattr(srvc, method_descriptor.name)
+    return method(rpc_controller, request, callback)
+
+  def _GetRequestClass(self, method_descriptor):
+    """Returns the class of the request protocol message.
+
+    Args:
+      method_descriptor: Descriptor of the method for which to return the
+        request protocol message class.
+
+    Returns:
+      A class that represents the input protocol message of the specified
+      method.
+    """
+    if method_descriptor.containing_service != self.descriptor:
+      raise RuntimeError(
+          'GetRequestClass() given method descriptor for wrong service type.')
+    return method_descriptor.input_type._concrete_class
+
+  def _GetResponseClass(self, method_descriptor):
+    """Returns the class of the response protocol message.
+
+    Args:
+      method_descriptor: Descriptor of the method for which to return the
+        response protocol message class.
+
+    Returns:
+      A class that represents the output protocol message of the specified
+      method.
+    """
+    if method_descriptor.containing_service != self.descriptor:
+      raise RuntimeError(
+          'GetResponseClass() given method descriptor for wrong service type.')
+    return method_descriptor.output_type._concrete_class
+
+  def _GenerateNonImplementedMethod(self, method):
+    """Generates and returns a method that can be set for a service methods.
+
+    Args:
+      method: Descriptor of the service method for which a method is to be
+        generated.
+
+    Returns:
+      A method that can be added to the service class.
+    """
+    return lambda inst, rpc_controller, request, callback: (
+        self._NonImplementedMethod(method.name, rpc_controller, callback))
+
+  def _NonImplementedMethod(self, method_name, rpc_controller, callback):
+    """The body of all methods in the generated service class.
+
+    Args:
+      method_name: Name of the method being executed.
+      rpc_controller: RPC controller used to execute this method.
+      callback: A callback which will be invoked when the method finishes.
+    """
+    rpc_controller.SetFailed('Method %s not implemented.' % method_name)
+    callback(None)
+
+
+class _ServiceStubBuilder(object):
+
+  """Constructs a protocol service stub class using a service descriptor.
+
+  Given a service descriptor, this class constructs a suitable stub class.
+  A stub is just a type-safe wrapper around an RpcChannel which emulates a
+  local implementation of the service.
+
+  One service stub builder instance constructs exactly one class. It means all
+  instances of that class share the same service stub builder.
+  """
+
+  def __init__(self, service_descriptor):
+    """Initializes an instance of the service stub class builder.
+
+    Args:
+      service_descriptor: ServiceDescriptor to use when constructing the
+        stub class.
+    """
+    self.descriptor = service_descriptor
+
+  def BuildServiceStub(self, cls):
+    """Constructs the stub class.
+
+    Args:
+      cls: The class that will be constructed.
+    """
+
+    def _ServiceStubInit(stub, rpc_channel):
+      stub.rpc_channel = rpc_channel
+    self.cls = cls
+    cls.__init__ = _ServiceStubInit
+    for method in self.descriptor.methods:
+      setattr(cls, method.name, self._GenerateStubMethod(method))
+
+  def _GenerateStubMethod(self, method):
+    return (lambda inst, rpc_controller, request, callback=None:
+        self._StubMethod(inst, method, rpc_controller, request, callback))
+
+  def _StubMethod(self, stub, method_descriptor,
+                  rpc_controller, request, callback):
+    """The body of all service methods in the generated stub class.
+
+    Args:
+      stub: Stub instance.
+      method_descriptor: Descriptor of the invoked method.
+      rpc_controller: Rpc controller to execute the method.
+      request: Request protocol message.
+      callback: A callback to execute when the method finishes.
+    Returns:
+      Response message (in case of blocking call).
+    """
+    return stub.rpc_channel.CallMethod(
+        method_descriptor, rpc_controller, request,
+        method_descriptor.output_type._concrete_class, callback)
diff --git a/llm/Lib/site-packages/google/protobuf/source_context_pb2.py b/llm/Lib/site-packages/google/protobuf/source_context_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..3d4e4ffb1e096fbbaac1cea62027ae305c5d6c4b
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/source_context_pb2.py
@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/source_context.proto
+# Protobuf Python Version: 4.25.3
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n$google/protobuf/source_context.proto\x12\x0fgoogle.protobuf\",\n\rSourceContext\x12\x1b\n\tfile_name\x18\x01 \x01(\tR\x08\x66ileNameB\x8a\x01\n\x13\x63om.google.protobufB\x12SourceContextProtoP\x01Z6google.golang.org/protobuf/types/known/sourcecontextpb\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'google.protobuf.source_context_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\023com.google.protobufB\022SourceContextProtoP\001Z6google.golang.org/protobuf/types/known/sourcecontextpb\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes'
+  _globals['_SOURCECONTEXT']._serialized_start=57
+  _globals['_SOURCECONTEXT']._serialized_end=101
+# @@protoc_insertion_point(module_scope)
diff --git a/llm/Lib/site-packages/google/protobuf/struct_pb2.py b/llm/Lib/site-packages/google/protobuf/struct_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..9506369f80a1b7cc0fde38978e3d96093ca7b4f8
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/struct_pb2.py
@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/struct.proto
+# Protobuf Python Version: 4.25.3
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1cgoogle/protobuf/struct.proto\x12\x0fgoogle.protobuf\"\x98\x01\n\x06Struct\x12;\n\x06\x66ields\x18\x01 \x03(\x0b\x32#.google.protobuf.Struct.FieldsEntryR\x06\x66ields\x1aQ\n\x0b\x46ieldsEntry\x12\x10\n\x03key\x18\x01 \x01(\tR\x03key\x12,\n\x05value\x18\x02 \x01(\x0b\x32\x16.google.protobuf.ValueR\x05value:\x02\x38\x01\"\xb2\x02\n\x05Value\x12;\n\nnull_value\x18\x01 \x01(\x0e\x32\x1a.google.protobuf.NullValueH\x00R\tnullValue\x12#\n\x0cnumber_value\x18\x02 \x01(\x01H\x00R\x0bnumberValue\x12#\n\x0cstring_value\x18\x03 \x01(\tH\x00R\x0bstringValue\x12\x1f\n\nbool_value\x18\x04 \x01(\x08H\x00R\tboolValue\x12<\n\x0cstruct_value\x18\x05 \x01(\x0b\x32\x17.google.protobuf.StructH\x00R\x0bstructValue\x12;\n\nlist_value\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x00R\tlistValueB\x06\n\x04kind\";\n\tListValue\x12.\n\x06values\x18\x01 \x03(\x0b\x32\x16.google.protobuf.ValueR\x06values*\x1b\n\tNullValue\x12\x0e\n\nNULL_VALUE\x10\x00\x42\x7f\n\x13\x63om.google.protobufB\x0bStructProtoP\x01Z/google.golang.org/protobuf/types/known/structpb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'google.protobuf.struct_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\023com.google.protobufB\013StructProtoP\001Z/google.golang.org/protobuf/types/known/structpb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes'
+  _globals['_STRUCT_FIELDSENTRY']._options = None
+  _globals['_STRUCT_FIELDSENTRY']._serialized_options = b'8\001'
+  _globals['_NULLVALUE']._serialized_start=574
+  _globals['_NULLVALUE']._serialized_end=601
+  _globals['_STRUCT']._serialized_start=50
+  _globals['_STRUCT']._serialized_end=202
+  _globals['_STRUCT_FIELDSENTRY']._serialized_start=121
+  _globals['_STRUCT_FIELDSENTRY']._serialized_end=202
+  _globals['_VALUE']._serialized_start=205
+  _globals['_VALUE']._serialized_end=511
+  _globals['_LISTVALUE']._serialized_start=513
+  _globals['_LISTVALUE']._serialized_end=572
+# @@protoc_insertion_point(module_scope)
diff --git a/llm/Lib/site-packages/google/protobuf/symbol_database.py b/llm/Lib/site-packages/google/protobuf/symbol_database.py
new file mode 100644
index 0000000000000000000000000000000000000000..1941e8112d577c872acc4cae0bbc4e8298e3e232
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/symbol_database.py
@@ -0,0 +1,197 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""A database of Python protocol buffer generated symbols.
+
+SymbolDatabase is the MessageFactory for messages generated at compile time,
+and makes it easy to create new instances of a registered type, given only the
+type's protocol buffer symbol name.
+
+Example usage::
+
+  db = symbol_database.SymbolDatabase()
+
+  # Register symbols of interest, from one or multiple files.
+  db.RegisterFileDescriptor(my_proto_pb2.DESCRIPTOR)
+  db.RegisterMessage(my_proto_pb2.MyMessage)
+  db.RegisterEnumDescriptor(my_proto_pb2.MyEnum.DESCRIPTOR)
+
+  # The database can be used as a MessageFactory, to generate types based on
+  # their name:
+  types = db.GetMessages(['my_proto.proto'])
+  my_message_instance = types['MyMessage']()
+
+  # The database's underlying descriptor pool can be queried, so it's not
+  # necessary to know a type's filename to be able to generate it:
+  filename = db.pool.FindFileContainingSymbol('MyMessage')
+  my_message_instance = db.GetMessages([filename])['MyMessage']()
+
+  # This functionality is also provided directly via a convenience method:
+  my_message_instance = db.GetSymbol('MyMessage')()
+"""
+
+import warnings
+
+from google.protobuf.internal import api_implementation
+from google.protobuf import descriptor_pool
+from google.protobuf import message_factory
+
+
+class SymbolDatabase():
+  """A database of Python generated symbols."""
+
+  # local cache of registered classes.
+  _classes = {}
+
+  def __init__(self, pool=None):
+    """Initializes a new SymbolDatabase."""
+    self.pool = pool or descriptor_pool.DescriptorPool()
+
+  def GetPrototype(self, descriptor):
+    warnings.warn('SymbolDatabase.GetPrototype() is deprecated. Please '
+                  'use message_factory.GetMessageClass() instead. '
+                  'SymbolDatabase.GetPrototype() will be removed soon.')
+    return message_factory.GetMessageClass(descriptor)
+
+  def CreatePrototype(self, descriptor):
+    warnings.warn('Directly call CreatePrototype() is wrong. Please use '
+                  'message_factory.GetMessageClass() instead. '
+                  'SymbolDatabase.CreatePrototype() will be removed soon.')
+    return message_factory._InternalCreateMessageClass(descriptor)
+
+  def GetMessages(self, files):
+    warnings.warn('SymbolDatabase.GetMessages() is deprecated. Please use '
+                  'message_factory.GetMessageClassedForFiles() instead. '
+                  'SymbolDatabase.GetMessages() will be removed soon.')
+    return message_factory.GetMessageClassedForFiles(files, self.pool)
+
+  def RegisterMessage(self, message):
+    """Registers the given message type in the local database.
+
+    Calls to GetSymbol() and GetMessages() will return messages registered here.
+
+    Args:
+      message: A :class:`google.protobuf.message.Message` subclass (or
+        instance); its descriptor will be registered.
+
+    Returns:
+      The provided message.
+    """
+
+    desc = message.DESCRIPTOR
+    self._classes[desc] = message
+    self.RegisterMessageDescriptor(desc)
+    return message
+
+  def RegisterMessageDescriptor(self, message_descriptor):
+    """Registers the given message descriptor in the local database.
+
+    Args:
+      message_descriptor (Descriptor): the message descriptor to add.
+    """
+    if api_implementation.Type() == 'python':
+      # pylint: disable=protected-access
+      self.pool._AddDescriptor(message_descriptor)
+
+  def RegisterEnumDescriptor(self, enum_descriptor):
+    """Registers the given enum descriptor in the local database.
+
+    Args:
+      enum_descriptor (EnumDescriptor): The enum descriptor to register.
+
+    Returns:
+      EnumDescriptor: The provided descriptor.
+    """
+    if api_implementation.Type() == 'python':
+      # pylint: disable=protected-access
+      self.pool._AddEnumDescriptor(enum_descriptor)
+    return enum_descriptor
+
+  def RegisterServiceDescriptor(self, service_descriptor):
+    """Registers the given service descriptor in the local database.
+
+    Args:
+      service_descriptor (ServiceDescriptor): the service descriptor to
+        register.
+    """
+    if api_implementation.Type() == 'python':
+      # pylint: disable=protected-access
+      self.pool._AddServiceDescriptor(service_descriptor)
+
+  def RegisterFileDescriptor(self, file_descriptor):
+    """Registers the given file descriptor in the local database.
+
+    Args:
+      file_descriptor (FileDescriptor): The file descriptor to register.
+    """
+    if api_implementation.Type() == 'python':
+      # pylint: disable=protected-access
+      self.pool._InternalAddFileDescriptor(file_descriptor)
+
+  def GetSymbol(self, symbol):
+    """Tries to find a symbol in the local database.
+
+    Currently, this method only returns message.Message instances, however, if
+    may be extended in future to support other symbol types.
+
+    Args:
+      symbol (str): a protocol buffer symbol.
+
+    Returns:
+      A Python class corresponding to the symbol.
+
+    Raises:
+      KeyError: if the symbol could not be found.
+    """
+
+    return self._classes[self.pool.FindMessageTypeByName(symbol)]
+
+  def GetMessages(self, files):
+    # TODO: Fix the differences with MessageFactory.
+    """Gets all registered messages from a specified file.
+
+    Only messages already created and registered will be returned; (this is the
+    case for imported _pb2 modules)
+    But unlike MessageFactory, this version also returns already defined nested
+    messages, but does not register any message extensions.
+
+    Args:
+      files (list[str]): The file names to extract messages from.
+
+    Returns:
+      A dictionary mapping proto names to the message classes.
+
+    Raises:
+      KeyError: if a file could not be found.
+    """
+
+    def _GetAllMessages(desc):
+      """Walk a message Descriptor and recursively yields all message names."""
+      yield desc
+      for msg_desc in desc.nested_types:
+        for nested_desc in _GetAllMessages(msg_desc):
+          yield nested_desc
+
+    result = {}
+    for file_name in files:
+      file_desc = self.pool.FindFileByName(file_name)
+      for msg_desc in file_desc.message_types_by_name.values():
+        for desc in _GetAllMessages(msg_desc):
+          try:
+            result[desc.full_name] = self._classes[desc]
+          except KeyError:
+            # This descriptor has no registered class, skip it.
+            pass
+    return result
+
+
+_DEFAULT = SymbolDatabase(pool=descriptor_pool.Default())
+
+
+def Default():
+  """Returns the default SymbolDatabase."""
+  return _DEFAULT
diff --git a/llm/Lib/site-packages/google/protobuf/testdata/__init__.py b/llm/Lib/site-packages/google/protobuf/testdata/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/google/protobuf/testdata/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/testdata/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fe1598db07e14fe2ba388582151ff5d75df882b6
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/testdata/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/text_encoding.py b/llm/Lib/site-packages/google/protobuf/text_encoding.py
new file mode 100644
index 0000000000000000000000000000000000000000..d454987496b8ecbb4fabb580db2b057ddb6d79d0
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/text_encoding.py
@@ -0,0 +1,85 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Encoding related utilities."""
+import re
+
+_cescape_chr_to_symbol_map = {}
+_cescape_chr_to_symbol_map[9] = r'\t'  # optional escape
+_cescape_chr_to_symbol_map[10] = r'\n'  # optional escape
+_cescape_chr_to_symbol_map[13] = r'\r'  # optional escape
+_cescape_chr_to_symbol_map[34] = r'\"'  # necessary escape
+_cescape_chr_to_symbol_map[39] = r"\'"  # optional escape
+_cescape_chr_to_symbol_map[92] = r'\\'  # necessary escape
+
+# Lookup table for unicode
+_cescape_unicode_to_str = [chr(i) for i in range(0, 256)]
+for byte, string in _cescape_chr_to_symbol_map.items():
+  _cescape_unicode_to_str[byte] = string
+
+# Lookup table for non-utf8, with necessary escapes at (o >= 127 or o < 32)
+_cescape_byte_to_str = ([r'\%03o' % i for i in range(0, 32)] +
+                        [chr(i) for i in range(32, 127)] +
+                        [r'\%03o' % i for i in range(127, 256)])
+for byte, string in _cescape_chr_to_symbol_map.items():
+  _cescape_byte_to_str[byte] = string
+del byte, string
+
+
+def CEscape(text, as_utf8) -> str:
+  """Escape a bytes string for use in an text protocol buffer.
+
+  Args:
+    text: A byte string to be escaped.
+    as_utf8: Specifies if result may contain non-ASCII characters.
+        In Python 3 this allows unescaped non-ASCII Unicode characters.
+        In Python 2 the return value will be valid UTF-8 rather than only ASCII.
+  Returns:
+    Escaped string (str).
+  """
+  # Python's text.encode() 'string_escape' or 'unicode_escape' codecs do not
+  # satisfy our needs; they encodes unprintable characters using two-digit hex
+  # escapes whereas our C++ unescaping function allows hex escapes to be any
+  # length.  So, "\0011".encode('string_escape') ends up being "\\x011", which
+  # will be decoded in C++ as a single-character string with char code 0x11.
+  text_is_unicode = isinstance(text, str)
+  if as_utf8 and text_is_unicode:
+    # We're already unicode, no processing beyond control char escapes.
+    return text.translate(_cescape_chr_to_symbol_map)
+  ord_ = ord if text_is_unicode else lambda x: x  # bytes iterate as ints.
+  if as_utf8:
+    return ''.join(_cescape_unicode_to_str[ord_(c)] for c in text)
+  return ''.join(_cescape_byte_to_str[ord_(c)] for c in text)
+
+
+_CUNESCAPE_HEX = re.compile(r'(\\+)x([0-9a-fA-F])(?![0-9a-fA-F])')
+
+
+def CUnescape(text: str) -> bytes:
+  """Unescape a text string with C-style escape sequences to UTF-8 bytes.
+
+  Args:
+    text: The data to parse in a str.
+  Returns:
+    A byte string.
+  """
+
+  def ReplaceHex(m):
+    # Only replace the match if the number of leading back slashes is odd. i.e.
+    # the slash itself is not escaped.
+    if len(m.group(1)) & 1:
+      return m.group(1) + 'x0' + m.group(2)
+    return m.group(0)
+
+  # This is required because the 'string_escape' encoding doesn't
+  # allow single-digit hex escapes (like '\xf').
+  result = _CUNESCAPE_HEX.sub(ReplaceHex, text)
+
+  return (result.encode('utf-8')  # Make it bytes to allow decode.
+          .decode('unicode_escape')
+          # Make it bytes again to return the proper type.
+          .encode('raw_unicode_escape'))
diff --git a/llm/Lib/site-packages/google/protobuf/text_format.py b/llm/Lib/site-packages/google/protobuf/text_format.py
new file mode 100644
index 0000000000000000000000000000000000000000..b448f660f5120f529c615f9db1ab9777b362ba9c
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/text_format.py
@@ -0,0 +1,1834 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Contains routines for printing protocol messages in text format.
+
+Simple usage example::
+
+  # Create a proto object and serialize it to a text proto string.
+  message = my_proto_pb2.MyMessage(foo='bar')
+  text_proto = text_format.MessageToString(message)
+
+  # Parse a text proto string.
+  message = text_format.Parse(text_proto, my_proto_pb2.MyMessage())
+"""
+
+__author__ = 'kenton@google.com (Kenton Varda)'
+
+# TODO Import thread contention leads to test failures.
+import encodings.raw_unicode_escape  # pylint: disable=unused-import
+import encodings.unicode_escape  # pylint: disable=unused-import
+import io
+import math
+import re
+
+from google.protobuf.internal import decoder
+from google.protobuf.internal import type_checkers
+from google.protobuf import descriptor
+from google.protobuf import text_encoding
+from google.protobuf import unknown_fields
+
+# pylint: disable=g-import-not-at-top
+__all__ = ['MessageToString', 'Parse', 'PrintMessage', 'PrintField',
+           'PrintFieldValue', 'Merge', 'MessageToBytes']
+
+_INTEGER_CHECKERS = (type_checkers.Uint32ValueChecker(),
+                     type_checkers.Int32ValueChecker(),
+                     type_checkers.Uint64ValueChecker(),
+                     type_checkers.Int64ValueChecker())
+_FLOAT_INFINITY = re.compile('-?inf(?:inity)?f?$', re.IGNORECASE)
+_FLOAT_NAN = re.compile('nanf?$', re.IGNORECASE)
+_QUOTES = frozenset(("'", '"'))
+_ANY_FULL_TYPE_NAME = 'google.protobuf.Any'
+_DEBUG_STRING_SILENT_MARKER = '\t '
+
+
+class Error(Exception):
+  """Top-level module error for text_format."""
+
+
+class ParseError(Error):
+  """Thrown in case of text parsing or tokenizing error."""
+
+  def __init__(self, message=None, line=None, column=None):
+    if message is not None and line is not None:
+      loc = str(line)
+      if column is not None:
+        loc += ':{0}'.format(column)
+      message = '{0} : {1}'.format(loc, message)
+    if message is not None:
+      super(ParseError, self).__init__(message)
+    else:
+      super(ParseError, self).__init__()
+    self._line = line
+    self._column = column
+
+  def GetLine(self):
+    return self._line
+
+  def GetColumn(self):
+    return self._column
+
+
+class TextWriter(object):
+
+  def __init__(self, as_utf8):
+    self._writer = io.StringIO()
+
+  def write(self, val):
+    return self._writer.write(val)
+
+  def close(self):
+    return self._writer.close()
+
+  def getvalue(self):
+    return self._writer.getvalue()
+
+
+def MessageToString(
+    message,
+    as_utf8=False,
+    as_one_line=False,
+    use_short_repeated_primitives=False,
+    pointy_brackets=False,
+    use_index_order=False,
+    float_format=None,
+    double_format=None,
+    use_field_number=False,
+    descriptor_pool=None,
+    indent=0,
+    message_formatter=None,
+    print_unknown_fields=False,
+    force_colon=False) -> str:
+  """Convert protobuf message to text format.
+
+  Double values can be formatted compactly with 15 digits of
+  precision (which is the most that IEEE 754 "double" can guarantee)
+  using double_format='.15g'. To ensure that converting to text and back to a
+  proto will result in an identical value, double_format='.17g' should be used.
+
+  Args:
+    message: The protocol buffers message.
+    as_utf8: Return unescaped Unicode for non-ASCII characters.
+    as_one_line: Don't introduce newlines between fields.
+    use_short_repeated_primitives: Use short repeated format for primitives.
+    pointy_brackets: If True, use angle brackets instead of curly braces for
+      nesting.
+    use_index_order: If True, fields of a proto message will be printed using
+      the order defined in source code instead of the field number, extensions
+      will be printed at the end of the message and their relative order is
+      determined by the extension number. By default, use the field number
+      order.
+    float_format (str): If set, use this to specify float field formatting
+      (per the "Format Specification Mini-Language"); otherwise, shortest float
+      that has same value in wire will be printed. Also affect double field
+      if double_format is not set but float_format is set.
+    double_format (str): If set, use this to specify double field formatting
+      (per the "Format Specification Mini-Language"); if it is not set but
+      float_format is set, use float_format. Otherwise, use ``str()``
+    use_field_number: If True, print field numbers instead of names.
+    descriptor_pool (DescriptorPool): Descriptor pool used to resolve Any types.
+    indent (int): The initial indent level, in terms of spaces, for pretty
+      print.
+    message_formatter (function(message, indent, as_one_line) -> unicode|None):
+      Custom formatter for selected sub-messages (usually based on message
+      type). Use to pretty print parts of the protobuf for easier diffing.
+    print_unknown_fields: If True, unknown fields will be printed.
+    force_colon: If set, a colon will be added after the field name even if the
+      field is a proto message.
+
+  Returns:
+    str: A string of the text formatted protocol buffer message.
+  """
+  out = TextWriter(as_utf8)
+  printer = _Printer(
+      out,
+      indent,
+      as_utf8,
+      as_one_line,
+      use_short_repeated_primitives,
+      pointy_brackets,
+      use_index_order,
+      float_format,
+      double_format,
+      use_field_number,
+      descriptor_pool,
+      message_formatter,
+      print_unknown_fields=print_unknown_fields,
+      force_colon=force_colon)
+  printer.PrintMessage(message)
+  result = out.getvalue()
+  out.close()
+  if as_one_line:
+    return result.rstrip()
+  return result
+
+
+def MessageToBytes(message, **kwargs) -> bytes:
+  """Convert protobuf message to encoded text format.  See MessageToString."""
+  text = MessageToString(message, **kwargs)
+  if isinstance(text, bytes):
+    return text
+  codec = 'utf-8' if kwargs.get('as_utf8') else 'ascii'
+  return text.encode(codec)
+
+
+def _IsMapEntry(field):
+  return (field.type == descriptor.FieldDescriptor.TYPE_MESSAGE and
+          field.message_type.has_options and
+          field.message_type.GetOptions().map_entry)
+
+
+def PrintMessage(message,
+                 out,
+                 indent=0,
+                 as_utf8=False,
+                 as_one_line=False,
+                 use_short_repeated_primitives=False,
+                 pointy_brackets=False,
+                 use_index_order=False,
+                 float_format=None,
+                 double_format=None,
+                 use_field_number=False,
+                 descriptor_pool=None,
+                 message_formatter=None,
+                 print_unknown_fields=False,
+                 force_colon=False):
+  """Convert the message to text format and write it to the out stream.
+
+  Args:
+    message: The Message object to convert to text format.
+    out: A file handle to write the message to.
+    indent: The initial indent level for pretty print.
+    as_utf8: Return unescaped Unicode for non-ASCII characters.
+    as_one_line: Don't introduce newlines between fields.
+    use_short_repeated_primitives: Use short repeated format for primitives.
+    pointy_brackets: If True, use angle brackets instead of curly braces for
+      nesting.
+    use_index_order: If True, print fields of a proto message using the order
+      defined in source code instead of the field number. By default, use the
+      field number order.
+    float_format: If set, use this to specify float field formatting
+      (per the "Format Specification Mini-Language"); otherwise, shortest
+      float that has same value in wire will be printed. Also affect double
+      field if double_format is not set but float_format is set.
+    double_format: If set, use this to specify double field formatting
+      (per the "Format Specification Mini-Language"); if it is not set but
+      float_format is set, use float_format. Otherwise, str() is used.
+    use_field_number: If True, print field numbers instead of names.
+    descriptor_pool: A DescriptorPool used to resolve Any types.
+    message_formatter: A function(message, indent, as_one_line): unicode|None
+      to custom format selected sub-messages (usually based on message type).
+      Use to pretty print parts of the protobuf for easier diffing.
+    print_unknown_fields: If True, unknown fields will be printed.
+    force_colon: If set, a colon will be added after the field name even if
+      the field is a proto message.
+  """
+  printer = _Printer(
+      out=out, indent=indent, as_utf8=as_utf8,
+      as_one_line=as_one_line,
+      use_short_repeated_primitives=use_short_repeated_primitives,
+      pointy_brackets=pointy_brackets,
+      use_index_order=use_index_order,
+      float_format=float_format,
+      double_format=double_format,
+      use_field_number=use_field_number,
+      descriptor_pool=descriptor_pool,
+      message_formatter=message_formatter,
+      print_unknown_fields=print_unknown_fields,
+      force_colon=force_colon)
+  printer.PrintMessage(message)
+
+
+def PrintField(field,
+               value,
+               out,
+               indent=0,
+               as_utf8=False,
+               as_one_line=False,
+               use_short_repeated_primitives=False,
+               pointy_brackets=False,
+               use_index_order=False,
+               float_format=None,
+               double_format=None,
+               message_formatter=None,
+               print_unknown_fields=False,
+               force_colon=False):
+  """Print a single field name/value pair."""
+  printer = _Printer(out, indent, as_utf8, as_one_line,
+                     use_short_repeated_primitives, pointy_brackets,
+                     use_index_order, float_format, double_format,
+                     message_formatter=message_formatter,
+                     print_unknown_fields=print_unknown_fields,
+                     force_colon=force_colon)
+  printer.PrintField(field, value)
+
+
+def PrintFieldValue(field,
+                    value,
+                    out,
+                    indent=0,
+                    as_utf8=False,
+                    as_one_line=False,
+                    use_short_repeated_primitives=False,
+                    pointy_brackets=False,
+                    use_index_order=False,
+                    float_format=None,
+                    double_format=None,
+                    message_formatter=None,
+                    print_unknown_fields=False,
+                    force_colon=False):
+  """Print a single field value (not including name)."""
+  printer = _Printer(out, indent, as_utf8, as_one_line,
+                     use_short_repeated_primitives, pointy_brackets,
+                     use_index_order, float_format, double_format,
+                     message_formatter=message_formatter,
+                     print_unknown_fields=print_unknown_fields,
+                     force_colon=force_colon)
+  printer.PrintFieldValue(field, value)
+
+
+def _BuildMessageFromTypeName(type_name, descriptor_pool):
+  """Returns a protobuf message instance.
+
+  Args:
+    type_name: Fully-qualified protobuf  message type name string.
+    descriptor_pool: DescriptorPool instance.
+
+  Returns:
+    A Message instance of type matching type_name, or None if the a Descriptor
+    wasn't found matching type_name.
+  """
+  # pylint: disable=g-import-not-at-top
+  if descriptor_pool is None:
+    from google.protobuf import descriptor_pool as pool_mod
+    descriptor_pool = pool_mod.Default()
+  from google.protobuf import message_factory
+  try:
+    message_descriptor = descriptor_pool.FindMessageTypeByName(type_name)
+  except KeyError:
+    return None
+  message_type = message_factory.GetMessageClass(message_descriptor)
+  return message_type()
+
+
+# These values must match WireType enum in //google/protobuf/wire_format.h.
+WIRETYPE_LENGTH_DELIMITED = 2
+WIRETYPE_START_GROUP = 3
+
+
+class _Printer(object):
+  """Text format printer for protocol message."""
+
+  def __init__(
+      self,
+      out,
+      indent=0,
+      as_utf8=False,
+      as_one_line=False,
+      use_short_repeated_primitives=False,
+      pointy_brackets=False,
+      use_index_order=False,
+      float_format=None,
+      double_format=None,
+      use_field_number=False,
+      descriptor_pool=None,
+      message_formatter=None,
+      print_unknown_fields=False,
+      force_colon=False):
+    """Initialize the Printer.
+
+    Double values can be formatted compactly with 15 digits of precision
+    (which is the most that IEEE 754 "double" can guarantee) using
+    double_format='.15g'. To ensure that converting to text and back to a proto
+    will result in an identical value, double_format='.17g' should be used.
+
+    Args:
+      out: To record the text format result.
+      indent: The initial indent level for pretty print.
+      as_utf8: Return unescaped Unicode for non-ASCII characters.
+      as_one_line: Don't introduce newlines between fields.
+      use_short_repeated_primitives: Use short repeated format for primitives.
+      pointy_brackets: If True, use angle brackets instead of curly braces for
+        nesting.
+      use_index_order: If True, print fields of a proto message using the order
+        defined in source code instead of the field number. By default, use the
+        field number order.
+      float_format: If set, use this to specify float field formatting
+        (per the "Format Specification Mini-Language"); otherwise, shortest
+        float that has same value in wire will be printed. Also affect double
+        field if double_format is not set but float_format is set.
+      double_format: If set, use this to specify double field formatting
+        (per the "Format Specification Mini-Language"); if it is not set but
+        float_format is set, use float_format. Otherwise, str() is used.
+      use_field_number: If True, print field numbers instead of names.
+      descriptor_pool: A DescriptorPool used to resolve Any types.
+      message_formatter: A function(message, indent, as_one_line): unicode|None
+        to custom format selected sub-messages (usually based on message type).
+        Use to pretty print parts of the protobuf for easier diffing.
+      print_unknown_fields: If True, unknown fields will be printed.
+      force_colon: If set, a colon will be added after the field name even if
+        the field is a proto message.
+    """
+    self.out = out
+    self.indent = indent
+    self.as_utf8 = as_utf8
+    self.as_one_line = as_one_line
+    self.use_short_repeated_primitives = use_short_repeated_primitives
+    self.pointy_brackets = pointy_brackets
+    self.use_index_order = use_index_order
+    self.float_format = float_format
+    if double_format is not None:
+      self.double_format = double_format
+    else:
+      self.double_format = float_format
+    self.use_field_number = use_field_number
+    self.descriptor_pool = descriptor_pool
+    self.message_formatter = message_formatter
+    self.print_unknown_fields = print_unknown_fields
+    self.force_colon = force_colon
+
+  def _TryPrintAsAnyMessage(self, message):
+    """Serializes if message is a google.protobuf.Any field."""
+    if '/' not in message.type_url:
+      return False
+    packed_message = _BuildMessageFromTypeName(message.TypeName(),
+                                               self.descriptor_pool)
+    if packed_message:
+      packed_message.MergeFromString(message.value)
+      colon = ':' if self.force_colon else ''
+      self.out.write('%s[%s]%s ' % (self.indent * ' ', message.type_url, colon))
+      self._PrintMessageFieldValue(packed_message)
+      self.out.write(' ' if self.as_one_line else '\n')
+      return True
+    else:
+      return False
+
+  def _TryCustomFormatMessage(self, message):
+    formatted = self.message_formatter(message, self.indent, self.as_one_line)
+    if formatted is None:
+      return False
+
+    out = self.out
+    out.write(' ' * self.indent)
+    out.write(formatted)
+    out.write(' ' if self.as_one_line else '\n')
+    return True
+
+  def PrintMessage(self, message):
+    """Convert protobuf message to text format.
+
+    Args:
+      message: The protocol buffers message.
+    """
+    if self.message_formatter and self._TryCustomFormatMessage(message):
+      return
+    if (message.DESCRIPTOR.full_name == _ANY_FULL_TYPE_NAME and
+        self._TryPrintAsAnyMessage(message)):
+      return
+    fields = message.ListFields()
+    if self.use_index_order:
+      fields.sort(
+          key=lambda x: x[0].number if x[0].is_extension else x[0].index)
+    for field, value in fields:
+      if _IsMapEntry(field):
+        for key in sorted(value):
+          # This is slow for maps with submessage entries because it copies the
+          # entire tree.  Unfortunately this would take significant refactoring
+          # of this file to work around.
+          #
+          # TODO: refactor and optimize if this becomes an issue.
+          entry_submsg = value.GetEntryClass()(key=key, value=value[key])
+          self.PrintField(field, entry_submsg)
+      elif field.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+        if (self.use_short_repeated_primitives
+            and field.cpp_type != descriptor.FieldDescriptor.CPPTYPE_MESSAGE
+            and field.cpp_type != descriptor.FieldDescriptor.CPPTYPE_STRING):
+          self._PrintShortRepeatedPrimitivesValue(field, value)
+        else:
+          for element in value:
+            self.PrintField(field, element)
+      else:
+        self.PrintField(field, value)
+
+    if self.print_unknown_fields:
+      self._PrintUnknownFields(unknown_fields.UnknownFieldSet(message))
+
+  def _PrintUnknownFields(self, unknown_field_set):
+    """Print unknown fields."""
+    out = self.out
+    for field in unknown_field_set:
+      out.write(' ' * self.indent)
+      out.write(str(field.field_number))
+      if field.wire_type == WIRETYPE_START_GROUP:
+        if self.as_one_line:
+          out.write(' { ')
+        else:
+          out.write(' {\n')
+          self.indent += 2
+
+        self._PrintUnknownFields(field.data)
+
+        if self.as_one_line:
+          out.write('} ')
+        else:
+          self.indent -= 2
+          out.write(' ' * self.indent + '}\n')
+      elif field.wire_type == WIRETYPE_LENGTH_DELIMITED:
+        try:
+          # If this field is parseable as a Message, it is probably
+          # an embedded message.
+          # pylint: disable=protected-access
+          (embedded_unknown_message, pos) = decoder._DecodeUnknownFieldSet(
+              memoryview(field.data), 0, len(field.data))
+        except Exception:    # pylint: disable=broad-except
+          pos = 0
+
+        if pos == len(field.data):
+          if self.as_one_line:
+            out.write(' { ')
+          else:
+            out.write(' {\n')
+            self.indent += 2
+
+          self._PrintUnknownFields(embedded_unknown_message)
+
+          if self.as_one_line:
+            out.write('} ')
+          else:
+            self.indent -= 2
+            out.write(' ' * self.indent + '}\n')
+        else:
+          # A string or bytes field. self.as_utf8 may not work.
+          out.write(': \"')
+          out.write(text_encoding.CEscape(field.data, False))
+          out.write('\" ' if self.as_one_line else '\"\n')
+      else:
+        # varint, fixed32, fixed64
+        out.write(': ')
+        out.write(str(field.data))
+        out.write(' ' if self.as_one_line else '\n')
+
+  def _PrintFieldName(self, field):
+    """Print field name."""
+    out = self.out
+    out.write(' ' * self.indent)
+    if self.use_field_number:
+      out.write(str(field.number))
+    else:
+      if field.is_extension:
+        out.write('[')
+        if (field.containing_type.GetOptions().message_set_wire_format and
+            field.type == descriptor.FieldDescriptor.TYPE_MESSAGE and
+            field.label == descriptor.FieldDescriptor.LABEL_OPTIONAL):
+          out.write(field.message_type.full_name)
+        else:
+          out.write(field.full_name)
+        out.write(']')
+      elif field.type == descriptor.FieldDescriptor.TYPE_GROUP:
+        # For groups, use the capitalized name.
+        out.write(field.message_type.name)
+      else:
+        out.write(field.name)
+
+    if (self.force_colon or
+        field.cpp_type != descriptor.FieldDescriptor.CPPTYPE_MESSAGE):
+      # The colon is optional in this case, but our cross-language golden files
+      # don't include it. Here, the colon is only included if force_colon is
+      # set to True
+      out.write(':')
+
+  def PrintField(self, field, value):
+    """Print a single field name/value pair."""
+    self._PrintFieldName(field)
+    self.out.write(' ')
+    self.PrintFieldValue(field, value)
+    self.out.write(' ' if self.as_one_line else '\n')
+
+  def _PrintShortRepeatedPrimitivesValue(self, field, value):
+    """"Prints short repeated primitives value."""
+    # Note: this is called only when value has at least one element.
+    self._PrintFieldName(field)
+    self.out.write(' [')
+    for i in range(len(value) - 1):
+      self.PrintFieldValue(field, value[i])
+      self.out.write(', ')
+    self.PrintFieldValue(field, value[-1])
+    self.out.write(']')
+    self.out.write(' ' if self.as_one_line else '\n')
+
+  def _PrintMessageFieldValue(self, value):
+    if self.pointy_brackets:
+      openb = '<'
+      closeb = '>'
+    else:
+      openb = '{'
+      closeb = '}'
+
+    if self.as_one_line:
+      self.out.write('%s ' % openb)
+      self.PrintMessage(value)
+      self.out.write(closeb)
+    else:
+      self.out.write('%s\n' % openb)
+      self.indent += 2
+      self.PrintMessage(value)
+      self.indent -= 2
+      self.out.write(' ' * self.indent + closeb)
+
+  def PrintFieldValue(self, field, value):
+    """Print a single field value (not including name).
+
+    For repeated fields, the value should be a single element.
+
+    Args:
+      field: The descriptor of the field to be printed.
+      value: The value of the field.
+    """
+    out = self.out
+    if field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+      self._PrintMessageFieldValue(value)
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_ENUM:
+      enum_value = field.enum_type.values_by_number.get(value, None)
+      if enum_value is not None:
+        out.write(enum_value.name)
+      else:
+        out.write(str(value))
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_STRING:
+      out.write('\"')
+      if isinstance(value, str) and not self.as_utf8:
+        out_value = value.encode('utf-8')
+      else:
+        out_value = value
+      if field.type == descriptor.FieldDescriptor.TYPE_BYTES:
+        # We always need to escape all binary data in TYPE_BYTES fields.
+        out_as_utf8 = False
+      else:
+        out_as_utf8 = self.as_utf8
+      out.write(text_encoding.CEscape(out_value, out_as_utf8))
+      out.write('\"')
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_BOOL:
+      if value:
+        out.write('true')
+      else:
+        out.write('false')
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_FLOAT:
+      if self.float_format is not None:
+        out.write('{1:{0}}'.format(self.float_format, value))
+      else:
+        if math.isnan(value):
+          out.write(str(value))
+        else:
+          out.write(str(type_checkers.ToShortestFloat(value)))
+    elif (field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_DOUBLE and
+          self.double_format is not None):
+      out.write('{1:{0}}'.format(self.double_format, value))
+    else:
+      out.write(str(value))
+
+
+def Parse(text,
+          message,
+          allow_unknown_extension=False,
+          allow_field_number=False,
+          descriptor_pool=None,
+          allow_unknown_field=False):
+  """Parses a text representation of a protocol message into a message.
+
+  NOTE: for historical reasons this function does not clear the input
+  message. This is different from what the binary msg.ParseFrom(...) does.
+  If text contains a field already set in message, the value is appended if the
+  field is repeated. Otherwise, an error is raised.
+
+  Example::
+
+    a = MyProto()
+    a.repeated_field.append('test')
+    b = MyProto()
+
+    # Repeated fields are combined
+    text_format.Parse(repr(a), b)
+    text_format.Parse(repr(a), b) # repeated_field contains ["test", "test"]
+
+    # Non-repeated fields cannot be overwritten
+    a.singular_field = 1
+    b.singular_field = 2
+    text_format.Parse(repr(a), b) # ParseError
+
+    # Binary version:
+    b.ParseFromString(a.SerializeToString()) # repeated_field is now "test"
+
+  Caller is responsible for clearing the message as needed.
+
+  Args:
+    text (str): Message text representation.
+    message (Message): A protocol buffer message to merge into.
+    allow_unknown_extension: if True, skip over missing extensions and keep
+      parsing
+    allow_field_number: if True, both field number and field name are allowed.
+    descriptor_pool (DescriptorPool): Descriptor pool used to resolve Any types.
+    allow_unknown_field: if True, skip over unknown field and keep
+      parsing. Avoid to use this option if possible. It may hide some
+      errors (e.g. spelling error on field name)
+
+  Returns:
+    Message: The same message passed as argument.
+
+  Raises:
+    ParseError: On text parsing problems.
+  """
+  return ParseLines(text.split(b'\n' if isinstance(text, bytes) else u'\n'),
+                    message,
+                    allow_unknown_extension,
+                    allow_field_number,
+                    descriptor_pool=descriptor_pool,
+                    allow_unknown_field=allow_unknown_field)
+
+
+def Merge(text,
+          message,
+          allow_unknown_extension=False,
+          allow_field_number=False,
+          descriptor_pool=None,
+          allow_unknown_field=False):
+  """Parses a text representation of a protocol message into a message.
+
+  Like Parse(), but allows repeated values for a non-repeated field, and uses
+  the last one. This means any non-repeated, top-level fields specified in text
+  replace those in the message.
+
+  Args:
+    text (str): Message text representation.
+    message (Message): A protocol buffer message to merge into.
+    allow_unknown_extension: if True, skip over missing extensions and keep
+      parsing
+    allow_field_number: if True, both field number and field name are allowed.
+    descriptor_pool (DescriptorPool): Descriptor pool used to resolve Any types.
+    allow_unknown_field: if True, skip over unknown field and keep
+      parsing. Avoid to use this option if possible. It may hide some
+      errors (e.g. spelling error on field name)
+
+  Returns:
+    Message: The same message passed as argument.
+
+  Raises:
+    ParseError: On text parsing problems.
+  """
+  return MergeLines(
+      text.split(b'\n' if isinstance(text, bytes) else u'\n'),
+      message,
+      allow_unknown_extension,
+      allow_field_number,
+      descriptor_pool=descriptor_pool,
+      allow_unknown_field=allow_unknown_field)
+
+
+def ParseLines(lines,
+               message,
+               allow_unknown_extension=False,
+               allow_field_number=False,
+               descriptor_pool=None,
+               allow_unknown_field=False):
+  """Parses a text representation of a protocol message into a message.
+
+  See Parse() for caveats.
+
+  Args:
+    lines: An iterable of lines of a message's text representation.
+    message: A protocol buffer message to merge into.
+    allow_unknown_extension: if True, skip over missing extensions and keep
+      parsing
+    allow_field_number: if True, both field number and field name are allowed.
+    descriptor_pool: A DescriptorPool used to resolve Any types.
+    allow_unknown_field: if True, skip over unknown field and keep
+      parsing. Avoid to use this option if possible. It may hide some
+      errors (e.g. spelling error on field name)
+
+  Returns:
+    The same message passed as argument.
+
+  Raises:
+    ParseError: On text parsing problems.
+  """
+  parser = _Parser(allow_unknown_extension,
+                   allow_field_number,
+                   descriptor_pool=descriptor_pool,
+                   allow_unknown_field=allow_unknown_field)
+  return parser.ParseLines(lines, message)
+
+
+def MergeLines(lines,
+               message,
+               allow_unknown_extension=False,
+               allow_field_number=False,
+               descriptor_pool=None,
+               allow_unknown_field=False):
+  """Parses a text representation of a protocol message into a message.
+
+  See Merge() for more details.
+
+  Args:
+    lines: An iterable of lines of a message's text representation.
+    message: A protocol buffer message to merge into.
+    allow_unknown_extension: if True, skip over missing extensions and keep
+      parsing
+    allow_field_number: if True, both field number and field name are allowed.
+    descriptor_pool: A DescriptorPool used to resolve Any types.
+    allow_unknown_field: if True, skip over unknown field and keep
+      parsing. Avoid to use this option if possible. It may hide some
+      errors (e.g. spelling error on field name)
+
+  Returns:
+    The same message passed as argument.
+
+  Raises:
+    ParseError: On text parsing problems.
+  """
+  parser = _Parser(allow_unknown_extension,
+                   allow_field_number,
+                   descriptor_pool=descriptor_pool,
+                   allow_unknown_field=allow_unknown_field)
+  return parser.MergeLines(lines, message)
+
+
+class _Parser(object):
+  """Text format parser for protocol message."""
+
+  def __init__(self,
+               allow_unknown_extension=False,
+               allow_field_number=False,
+               descriptor_pool=None,
+               allow_unknown_field=False):
+    self.allow_unknown_extension = allow_unknown_extension
+    self.allow_field_number = allow_field_number
+    self.descriptor_pool = descriptor_pool
+    self.allow_unknown_field = allow_unknown_field
+
+  def ParseLines(self, lines, message):
+    """Parses a text representation of a protocol message into a message."""
+    self._allow_multiple_scalars = False
+    self._ParseOrMerge(lines, message)
+    return message
+
+  def MergeLines(self, lines, message):
+    """Merges a text representation of a protocol message into a message."""
+    self._allow_multiple_scalars = True
+    self._ParseOrMerge(lines, message)
+    return message
+
+  def _ParseOrMerge(self, lines, message):
+    """Converts a text representation of a protocol message into a message.
+
+    Args:
+      lines: Lines of a message's text representation.
+      message: A protocol buffer message to merge into.
+
+    Raises:
+      ParseError: On text parsing problems.
+    """
+    # Tokenize expects native str lines.
+    try:
+      str_lines = (
+          line if isinstance(line, str) else line.decode('utf-8')
+          for line in lines)
+      tokenizer = Tokenizer(str_lines)
+    except UnicodeDecodeError as e:
+      raise ParseError from e
+    if message:
+      self.root_type = message.DESCRIPTOR.full_name
+    while not tokenizer.AtEnd():
+      self._MergeField(tokenizer, message)
+
+  def _MergeField(self, tokenizer, message):
+    """Merges a single protocol message field into a message.
+
+    Args:
+      tokenizer: A tokenizer to parse the field name and values.
+      message: A protocol message to record the data.
+
+    Raises:
+      ParseError: In case of text parsing problems.
+    """
+    message_descriptor = message.DESCRIPTOR
+    if (message_descriptor.full_name == _ANY_FULL_TYPE_NAME and
+        tokenizer.TryConsume('[')):
+      type_url_prefix, packed_type_name = self._ConsumeAnyTypeUrl(tokenizer)
+      tokenizer.Consume(']')
+      tokenizer.TryConsume(':')
+      self._DetectSilentMarker(tokenizer, message_descriptor.full_name,
+                               type_url_prefix + '/' + packed_type_name)
+      if tokenizer.TryConsume('<'):
+        expanded_any_end_token = '>'
+      else:
+        tokenizer.Consume('{')
+        expanded_any_end_token = '}'
+      expanded_any_sub_message = _BuildMessageFromTypeName(packed_type_name,
+                                                           self.descriptor_pool)
+      # Direct comparison with None is used instead of implicit bool conversion
+      # to avoid false positives with falsy initial values, e.g. for
+      # google.protobuf.ListValue.
+      if expanded_any_sub_message is None:
+        raise ParseError('Type %s not found in descriptor pool' %
+                         packed_type_name)
+      while not tokenizer.TryConsume(expanded_any_end_token):
+        if tokenizer.AtEnd():
+          raise tokenizer.ParseErrorPreviousToken('Expected "%s".' %
+                                                  (expanded_any_end_token,))
+        self._MergeField(tokenizer, expanded_any_sub_message)
+      deterministic = False
+
+      message.Pack(expanded_any_sub_message,
+                   type_url_prefix=type_url_prefix,
+                   deterministic=deterministic)
+      return
+
+    if tokenizer.TryConsume('['):
+      name = [tokenizer.ConsumeIdentifier()]
+      while tokenizer.TryConsume('.'):
+        name.append(tokenizer.ConsumeIdentifier())
+      name = '.'.join(name)
+
+      if not message_descriptor.is_extendable:
+        raise tokenizer.ParseErrorPreviousToken(
+            'Message type "%s" does not have extensions.' %
+            message_descriptor.full_name)
+      # pylint: disable=protected-access
+      field = message.Extensions._FindExtensionByName(name)
+      # pylint: enable=protected-access
+      if not field:
+        if self.allow_unknown_extension:
+          field = None
+        else:
+          raise tokenizer.ParseErrorPreviousToken(
+              'Extension "%s" not registered. '
+              'Did you import the _pb2 module which defines it? '
+              'If you are trying to place the extension in the MessageSet '
+              'field of another message that is in an Any or MessageSet field, '
+              'that message\'s _pb2 module must be imported as well' % name)
+      elif message_descriptor != field.containing_type:
+        raise tokenizer.ParseErrorPreviousToken(
+            'Extension "%s" does not extend message type "%s".' %
+            (name, message_descriptor.full_name))
+
+      tokenizer.Consume(']')
+
+    else:
+      name = tokenizer.ConsumeIdentifierOrNumber()
+      if self.allow_field_number and name.isdigit():
+        number = ParseInteger(name, True, True)
+        field = message_descriptor.fields_by_number.get(number, None)
+        if not field and message_descriptor.is_extendable:
+          field = message.Extensions._FindExtensionByNumber(number)
+      else:
+        field = message_descriptor.fields_by_name.get(name, None)
+
+        # Group names are expected to be capitalized as they appear in the
+        # .proto file, which actually matches their type names, not their field
+        # names.
+        if not field:
+          field = message_descriptor.fields_by_name.get(name.lower(), None)
+          if field and field.type != descriptor.FieldDescriptor.TYPE_GROUP:
+            field = None
+
+        if (field and field.type == descriptor.FieldDescriptor.TYPE_GROUP and
+            field.message_type.name != name):
+          field = None
+
+      if not field and not self.allow_unknown_field:
+        raise tokenizer.ParseErrorPreviousToken(
+            'Message type "%s" has no field named "%s".' %
+            (message_descriptor.full_name, name))
+
+    if field:
+      if not self._allow_multiple_scalars and field.containing_oneof:
+        # Check if there's a different field set in this oneof.
+        # Note that we ignore the case if the same field was set before, and we
+        # apply _allow_multiple_scalars to non-scalar fields as well.
+        which_oneof = message.WhichOneof(field.containing_oneof.name)
+        if which_oneof is not None and which_oneof != field.name:
+          raise tokenizer.ParseErrorPreviousToken(
+              'Field "%s" is specified along with field "%s", another member '
+              'of oneof "%s" for message type "%s".' %
+              (field.name, which_oneof, field.containing_oneof.name,
+               message_descriptor.full_name))
+
+      if field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+        tokenizer.TryConsume(':')
+        self._DetectSilentMarker(tokenizer, message_descriptor.full_name,
+                                 field.full_name)
+        merger = self._MergeMessageField
+      else:
+        tokenizer.Consume(':')
+        self._DetectSilentMarker(tokenizer, message_descriptor.full_name,
+                                 field.full_name)
+        merger = self._MergeScalarField
+
+      if (field.label == descriptor.FieldDescriptor.LABEL_REPEATED and
+          tokenizer.TryConsume('[')):
+        # Short repeated format, e.g. "foo: [1, 2, 3]"
+        if not tokenizer.TryConsume(']'):
+          while True:
+            merger(tokenizer, message, field)
+            if tokenizer.TryConsume(']'):
+              break
+            tokenizer.Consume(',')
+
+      else:
+        merger(tokenizer, message, field)
+
+    else:  # Proto field is unknown.
+      assert (self.allow_unknown_extension or self.allow_unknown_field)
+      self._SkipFieldContents(tokenizer, name, message_descriptor.full_name)
+
+    # For historical reasons, fields may optionally be separated by commas or
+    # semicolons.
+    if not tokenizer.TryConsume(','):
+      tokenizer.TryConsume(';')
+
+  def _LogSilentMarker(self, immediate_message_type, field_name):
+    pass
+
+  def _DetectSilentMarker(self, tokenizer, immediate_message_type, field_name):
+    if tokenizer.contains_silent_marker_before_current_token:
+      self._LogSilentMarker(immediate_message_type, field_name)
+
+  def _ConsumeAnyTypeUrl(self, tokenizer):
+    """Consumes a google.protobuf.Any type URL and returns the type name."""
+    # Consume "type.googleapis.com/".
+    prefix = [tokenizer.ConsumeIdentifier()]
+    tokenizer.Consume('.')
+    prefix.append(tokenizer.ConsumeIdentifier())
+    tokenizer.Consume('.')
+    prefix.append(tokenizer.ConsumeIdentifier())
+    tokenizer.Consume('/')
+    # Consume the fully-qualified type name.
+    name = [tokenizer.ConsumeIdentifier()]
+    while tokenizer.TryConsume('.'):
+      name.append(tokenizer.ConsumeIdentifier())
+    return '.'.join(prefix), '.'.join(name)
+
+  def _MergeMessageField(self, tokenizer, message, field):
+    """Merges a single scalar field into a message.
+
+    Args:
+      tokenizer: A tokenizer to parse the field value.
+      message: The message of which field is a member.
+      field: The descriptor of the field to be merged.
+
+    Raises:
+      ParseError: In case of text parsing problems.
+    """
+    is_map_entry = _IsMapEntry(field)
+
+    if tokenizer.TryConsume('<'):
+      end_token = '>'
+    else:
+      tokenizer.Consume('{')
+      end_token = '}'
+
+    if field.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+      if field.is_extension:
+        sub_message = message.Extensions[field].add()
+      elif is_map_entry:
+        sub_message = getattr(message, field.name).GetEntryClass()()
+      else:
+        sub_message = getattr(message, field.name).add()
+    else:
+      if field.is_extension:
+        if (not self._allow_multiple_scalars and
+            message.HasExtension(field)):
+          raise tokenizer.ParseErrorPreviousToken(
+              'Message type "%s" should not have multiple "%s" extensions.' %
+              (message.DESCRIPTOR.full_name, field.full_name))
+        sub_message = message.Extensions[field]
+      else:
+        # Also apply _allow_multiple_scalars to message field.
+        # TODO: Change to _allow_singular_overwrites.
+        if (not self._allow_multiple_scalars and
+            message.HasField(field.name)):
+          raise tokenizer.ParseErrorPreviousToken(
+              'Message type "%s" should not have multiple "%s" fields.' %
+              (message.DESCRIPTOR.full_name, field.name))
+        sub_message = getattr(message, field.name)
+      sub_message.SetInParent()
+
+    while not tokenizer.TryConsume(end_token):
+      if tokenizer.AtEnd():
+        raise tokenizer.ParseErrorPreviousToken('Expected "%s".' % (end_token,))
+      self._MergeField(tokenizer, sub_message)
+
+    if is_map_entry:
+      value_cpptype = field.message_type.fields_by_name['value'].cpp_type
+      if value_cpptype == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+        value = getattr(message, field.name)[sub_message.key]
+        value.CopyFrom(sub_message.value)
+      else:
+        getattr(message, field.name)[sub_message.key] = sub_message.value
+
+  def _MergeScalarField(self, tokenizer, message, field):
+    """Merges a single scalar field into a message.
+
+    Args:
+      tokenizer: A tokenizer to parse the field value.
+      message: A protocol message to record the data.
+      field: The descriptor of the field to be merged.
+
+    Raises:
+      ParseError: In case of text parsing problems.
+      RuntimeError: On runtime errors.
+    """
+    _ = self.allow_unknown_extension
+    value = None
+
+    if field.type in (descriptor.FieldDescriptor.TYPE_INT32,
+                      descriptor.FieldDescriptor.TYPE_SINT32,
+                      descriptor.FieldDescriptor.TYPE_SFIXED32):
+      value = _ConsumeInt32(tokenizer)
+    elif field.type in (descriptor.FieldDescriptor.TYPE_INT64,
+                        descriptor.FieldDescriptor.TYPE_SINT64,
+                        descriptor.FieldDescriptor.TYPE_SFIXED64):
+      value = _ConsumeInt64(tokenizer)
+    elif field.type in (descriptor.FieldDescriptor.TYPE_UINT32,
+                        descriptor.FieldDescriptor.TYPE_FIXED32):
+      value = _ConsumeUint32(tokenizer)
+    elif field.type in (descriptor.FieldDescriptor.TYPE_UINT64,
+                        descriptor.FieldDescriptor.TYPE_FIXED64):
+      value = _ConsumeUint64(tokenizer)
+    elif field.type in (descriptor.FieldDescriptor.TYPE_FLOAT,
+                        descriptor.FieldDescriptor.TYPE_DOUBLE):
+      value = tokenizer.ConsumeFloat()
+    elif field.type == descriptor.FieldDescriptor.TYPE_BOOL:
+      value = tokenizer.ConsumeBool()
+    elif field.type == descriptor.FieldDescriptor.TYPE_STRING:
+      value = tokenizer.ConsumeString()
+    elif field.type == descriptor.FieldDescriptor.TYPE_BYTES:
+      value = tokenizer.ConsumeByteString()
+    elif field.type == descriptor.FieldDescriptor.TYPE_ENUM:
+      value = tokenizer.ConsumeEnum(field)
+    else:
+      raise RuntimeError('Unknown field type %d' % field.type)
+
+    if field.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+      if field.is_extension:
+        message.Extensions[field].append(value)
+      else:
+        getattr(message, field.name).append(value)
+    else:
+      if field.is_extension:
+        if (not self._allow_multiple_scalars and
+            field.has_presence and
+            message.HasExtension(field)):
+          raise tokenizer.ParseErrorPreviousToken(
+              'Message type "%s" should not have multiple "%s" extensions.' %
+              (message.DESCRIPTOR.full_name, field.full_name))
+        else:
+          message.Extensions[field] = value
+      else:
+        duplicate_error = False
+        if not self._allow_multiple_scalars:
+          if field.has_presence:
+            duplicate_error = message.HasField(field.name)
+          else:
+            # For field that doesn't represent presence, try best effort to
+            # check multiple scalars by compare to default values.
+            duplicate_error = bool(getattr(message, field.name))
+
+        if duplicate_error:
+          raise tokenizer.ParseErrorPreviousToken(
+              'Message type "%s" should not have multiple "%s" fields.' %
+              (message.DESCRIPTOR.full_name, field.name))
+        else:
+          setattr(message, field.name, value)
+
+  def _SkipFieldContents(self, tokenizer, field_name, immediate_message_type):
+    """Skips over contents (value or message) of a field.
+
+    Args:
+      tokenizer: A tokenizer to parse the field name and values.
+      field_name: The field name currently being parsed.
+      immediate_message_type: The type of the message immediately containing
+        the silent marker.
+    """
+    # Try to guess the type of this field.
+    # If this field is not a message, there should be a ":" between the
+    # field name and the field value and also the field value should not
+    # start with "{" or "<" which indicates the beginning of a message body.
+    # If there is no ":" or there is a "{" or "<" after ":", this field has
+    # to be a message or the input is ill-formed.
+    if tokenizer.TryConsume(
+        ':') and not tokenizer.LookingAt('{') and not tokenizer.LookingAt('<'):
+      self._DetectSilentMarker(tokenizer, immediate_message_type, field_name)
+      if tokenizer.LookingAt('['):
+        self._SkipRepeatedFieldValue(tokenizer)
+      else:
+        self._SkipFieldValue(tokenizer)
+    else:
+      self._DetectSilentMarker(tokenizer, immediate_message_type, field_name)
+      self._SkipFieldMessage(tokenizer, immediate_message_type)
+
+  def _SkipField(self, tokenizer, immediate_message_type):
+    """Skips over a complete field (name and value/message).
+
+    Args:
+      tokenizer: A tokenizer to parse the field name and values.
+      immediate_message_type: The type of the message immediately containing
+        the silent marker.
+    """
+    field_name = ''
+    if tokenizer.TryConsume('['):
+      # Consume extension or google.protobuf.Any type URL
+      field_name += '[' + tokenizer.ConsumeIdentifier()
+      num_identifiers = 1
+      while tokenizer.TryConsume('.'):
+        field_name += '.' + tokenizer.ConsumeIdentifier()
+        num_identifiers += 1
+      # This is possibly a type URL for an Any message.
+      if num_identifiers == 3 and tokenizer.TryConsume('/'):
+        field_name += '/' + tokenizer.ConsumeIdentifier()
+        while tokenizer.TryConsume('.'):
+          field_name += '.' + tokenizer.ConsumeIdentifier()
+      tokenizer.Consume(']')
+      field_name += ']'
+    else:
+      field_name += tokenizer.ConsumeIdentifierOrNumber()
+
+    self._SkipFieldContents(tokenizer, field_name, immediate_message_type)
+
+    # For historical reasons, fields may optionally be separated by commas or
+    # semicolons.
+    if not tokenizer.TryConsume(','):
+      tokenizer.TryConsume(';')
+
+  def _SkipFieldMessage(self, tokenizer, immediate_message_type):
+    """Skips over a field message.
+
+    Args:
+      tokenizer: A tokenizer to parse the field name and values.
+      immediate_message_type: The type of the message immediately containing
+        the silent marker
+    """
+    if tokenizer.TryConsume('<'):
+      delimiter = '>'
+    else:
+      tokenizer.Consume('{')
+      delimiter = '}'
+
+    while not tokenizer.LookingAt('>') and not tokenizer.LookingAt('}'):
+      self._SkipField(tokenizer, immediate_message_type)
+
+    tokenizer.Consume(delimiter)
+
+  def _SkipFieldValue(self, tokenizer):
+    """Skips over a field value.
+
+    Args:
+      tokenizer: A tokenizer to parse the field name and values.
+
+    Raises:
+      ParseError: In case an invalid field value is found.
+    """
+    if (not tokenizer.TryConsumeByteString()and
+        not tokenizer.TryConsumeIdentifier() and
+        not _TryConsumeInt64(tokenizer) and
+        not _TryConsumeUint64(tokenizer) and
+        not tokenizer.TryConsumeFloat()):
+      raise ParseError('Invalid field value: ' + tokenizer.token)
+
+  def _SkipRepeatedFieldValue(self, tokenizer):
+    """Skips over a repeated field value.
+
+    Args:
+      tokenizer: A tokenizer to parse the field value.
+    """
+    tokenizer.Consume('[')
+    if not tokenizer.LookingAt(']'):
+      self._SkipFieldValue(tokenizer)
+      while tokenizer.TryConsume(','):
+        self._SkipFieldValue(tokenizer)
+    tokenizer.Consume(']')
+
+
+class Tokenizer(object):
+  """Protocol buffer text representation tokenizer.
+
+  This class handles the lower level string parsing by splitting it into
+  meaningful tokens.
+
+  It was directly ported from the Java protocol buffer API.
+  """
+
+  _WHITESPACE = re.compile(r'\s+')
+  _COMMENT = re.compile(r'(\s*#.*$)', re.MULTILINE)
+  _WHITESPACE_OR_COMMENT = re.compile(r'(\s|(#.*$))+', re.MULTILINE)
+  _TOKEN = re.compile('|'.join([
+      r'[a-zA-Z_][0-9a-zA-Z_+-]*',  # an identifier
+      r'([0-9+-]|(\.[0-9]))[0-9a-zA-Z_.+-]*',  # a number
+  ] + [  # quoted str for each quote mark
+      # Avoid backtracking! https://stackoverflow.com/a/844267
+      r'{qt}[^{qt}\n\\]*((\\.)+[^{qt}\n\\]*)*({qt}|\\?$)'.format(qt=mark)
+      for mark in _QUOTES
+  ]))
+
+  _IDENTIFIER = re.compile(r'[^\d\W]\w*')
+  _IDENTIFIER_OR_NUMBER = re.compile(r'\w+')
+
+  def __init__(self, lines, skip_comments=True):
+    self._position = 0
+    self._line = -1
+    self._column = 0
+    self._token_start = None
+    self.token = ''
+    self._lines = iter(lines)
+    self._current_line = ''
+    self._previous_line = 0
+    self._previous_column = 0
+    self._more_lines = True
+    self._skip_comments = skip_comments
+    self._whitespace_pattern = (skip_comments and self._WHITESPACE_OR_COMMENT
+                                or self._WHITESPACE)
+    self.contains_silent_marker_before_current_token = False
+
+    self._SkipWhitespace()
+    self.NextToken()
+
+  def LookingAt(self, token):
+    return self.token == token
+
+  def AtEnd(self):
+    """Checks the end of the text was reached.
+
+    Returns:
+      True iff the end was reached.
+    """
+    return not self.token
+
+  def _PopLine(self):
+    while len(self._current_line) <= self._column:
+      try:
+        self._current_line = next(self._lines)
+      except StopIteration:
+        self._current_line = ''
+        self._more_lines = False
+        return
+      else:
+        self._line += 1
+        self._column = 0
+
+  def _SkipWhitespace(self):
+    while True:
+      self._PopLine()
+      match = self._whitespace_pattern.match(self._current_line, self._column)
+      if not match:
+        break
+      self.contains_silent_marker_before_current_token = match.group(0) == (
+          ' ' + _DEBUG_STRING_SILENT_MARKER)
+      length = len(match.group(0))
+      self._column += length
+
+  def TryConsume(self, token):
+    """Tries to consume a given piece of text.
+
+    Args:
+      token: Text to consume.
+
+    Returns:
+      True iff the text was consumed.
+    """
+    if self.token == token:
+      self.NextToken()
+      return True
+    return False
+
+  def Consume(self, token):
+    """Consumes a piece of text.
+
+    Args:
+      token: Text to consume.
+
+    Raises:
+      ParseError: If the text couldn't be consumed.
+    """
+    if not self.TryConsume(token):
+      raise self.ParseError('Expected "%s".' % token)
+
+  def ConsumeComment(self):
+    result = self.token
+    if not self._COMMENT.match(result):
+      raise self.ParseError('Expected comment.')
+    self.NextToken()
+    return result
+
+  def ConsumeCommentOrTrailingComment(self):
+    """Consumes a comment, returns a 2-tuple (trailing bool, comment str)."""
+
+    # Tokenizer initializes _previous_line and _previous_column to 0. As the
+    # tokenizer starts, it looks like there is a previous token on the line.
+    just_started = self._line == 0 and self._column == 0
+
+    before_parsing = self._previous_line
+    comment = self.ConsumeComment()
+
+    # A trailing comment is a comment on the same line than the previous token.
+    trailing = (self._previous_line == before_parsing
+                and not just_started)
+
+    return trailing, comment
+
+  def TryConsumeIdentifier(self):
+    try:
+      self.ConsumeIdentifier()
+      return True
+    except ParseError:
+      return False
+
+  def ConsumeIdentifier(self):
+    """Consumes protocol message field identifier.
+
+    Returns:
+      Identifier string.
+
+    Raises:
+      ParseError: If an identifier couldn't be consumed.
+    """
+    result = self.token
+    if not self._IDENTIFIER.match(result):
+      raise self.ParseError('Expected identifier.')
+    self.NextToken()
+    return result
+
+  def TryConsumeIdentifierOrNumber(self):
+    try:
+      self.ConsumeIdentifierOrNumber()
+      return True
+    except ParseError:
+      return False
+
+  def ConsumeIdentifierOrNumber(self):
+    """Consumes protocol message field identifier.
+
+    Returns:
+      Identifier string.
+
+    Raises:
+      ParseError: If an identifier couldn't be consumed.
+    """
+    result = self.token
+    if not self._IDENTIFIER_OR_NUMBER.match(result):
+      raise self.ParseError('Expected identifier or number, got %s.' % result)
+    self.NextToken()
+    return result
+
+  def TryConsumeInteger(self):
+    try:
+      self.ConsumeInteger()
+      return True
+    except ParseError:
+      return False
+
+  def ConsumeInteger(self):
+    """Consumes an integer number.
+
+    Returns:
+      The integer parsed.
+
+    Raises:
+      ParseError: If an integer couldn't be consumed.
+    """
+    try:
+      result = _ParseAbstractInteger(self.token)
+    except ValueError as e:
+      raise self.ParseError(str(e))
+    self.NextToken()
+    return result
+
+  def TryConsumeFloat(self):
+    try:
+      self.ConsumeFloat()
+      return True
+    except ParseError:
+      return False
+
+  def ConsumeFloat(self):
+    """Consumes an floating point number.
+
+    Returns:
+      The number parsed.
+
+    Raises:
+      ParseError: If a floating point number couldn't be consumed.
+    """
+    try:
+      result = ParseFloat(self.token)
+    except ValueError as e:
+      raise self.ParseError(str(e))
+    self.NextToken()
+    return result
+
+  def ConsumeBool(self):
+    """Consumes a boolean value.
+
+    Returns:
+      The bool parsed.
+
+    Raises:
+      ParseError: If a boolean value couldn't be consumed.
+    """
+    try:
+      result = ParseBool(self.token)
+    except ValueError as e:
+      raise self.ParseError(str(e))
+    self.NextToken()
+    return result
+
+  def TryConsumeByteString(self):
+    try:
+      self.ConsumeByteString()
+      return True
+    except ParseError:
+      return False
+
+  def ConsumeString(self):
+    """Consumes a string value.
+
+    Returns:
+      The string parsed.
+
+    Raises:
+      ParseError: If a string value couldn't be consumed.
+    """
+    the_bytes = self.ConsumeByteString()
+    try:
+      return str(the_bytes, 'utf-8')
+    except UnicodeDecodeError as e:
+      raise self._StringParseError(e)
+
+  def ConsumeByteString(self):
+    """Consumes a byte array value.
+
+    Returns:
+      The array parsed (as a string).
+
+    Raises:
+      ParseError: If a byte array value couldn't be consumed.
+    """
+    the_list = [self._ConsumeSingleByteString()]
+    while self.token and self.token[0] in _QUOTES:
+      the_list.append(self._ConsumeSingleByteString())
+    return b''.join(the_list)
+
+  def _ConsumeSingleByteString(self):
+    """Consume one token of a string literal.
+
+    String literals (whether bytes or text) can come in multiple adjacent
+    tokens which are automatically concatenated, like in C or Python.  This
+    method only consumes one token.
+
+    Returns:
+      The token parsed.
+    Raises:
+      ParseError: When the wrong format data is found.
+    """
+    text = self.token
+    if len(text) < 1 or text[0] not in _QUOTES:
+      raise self.ParseError('Expected string but found: %r' % (text,))
+
+    if len(text) < 2 or text[-1] != text[0]:
+      raise self.ParseError('String missing ending quote: %r' % (text,))
+
+    try:
+      result = text_encoding.CUnescape(text[1:-1])
+    except ValueError as e:
+      raise self.ParseError(str(e))
+    self.NextToken()
+    return result
+
+  def ConsumeEnum(self, field):
+    try:
+      result = ParseEnum(field, self.token)
+    except ValueError as e:
+      raise self.ParseError(str(e))
+    self.NextToken()
+    return result
+
+  def ParseErrorPreviousToken(self, message):
+    """Creates and *returns* a ParseError for the previously read token.
+
+    Args:
+      message: A message to set for the exception.
+
+    Returns:
+      A ParseError instance.
+    """
+    return ParseError(message, self._previous_line + 1,
+                      self._previous_column + 1)
+
+  def ParseError(self, message):
+    """Creates and *returns* a ParseError for the current token."""
+    return ParseError('\'' + self._current_line + '\': ' + message,
+                      self._line + 1, self._column + 1)
+
+  def _StringParseError(self, e):
+    return self.ParseError('Couldn\'t parse string: ' + str(e))
+
+  def NextToken(self):
+    """Reads the next meaningful token."""
+    self._previous_line = self._line
+    self._previous_column = self._column
+    self.contains_silent_marker_before_current_token = False
+
+    self._column += len(self.token)
+    self._SkipWhitespace()
+
+    if not self._more_lines:
+      self.token = ''
+      return
+
+    match = self._TOKEN.match(self._current_line, self._column)
+    if not match and not self._skip_comments:
+      match = self._COMMENT.match(self._current_line, self._column)
+    if match:
+      token = match.group(0)
+      self.token = token
+    else:
+      self.token = self._current_line[self._column]
+
+# Aliased so it can still be accessed by current visibility violators.
+# TODO: Migrate violators to textformat_tokenizer.
+_Tokenizer = Tokenizer  # pylint: disable=invalid-name
+
+
+def _ConsumeInt32(tokenizer):
+  """Consumes a signed 32bit integer number from tokenizer.
+
+  Args:
+    tokenizer: A tokenizer used to parse the number.
+
+  Returns:
+    The integer parsed.
+
+  Raises:
+    ParseError: If a signed 32bit integer couldn't be consumed.
+  """
+  return _ConsumeInteger(tokenizer, is_signed=True, is_long=False)
+
+
+def _ConsumeUint32(tokenizer):
+  """Consumes an unsigned 32bit integer number from tokenizer.
+
+  Args:
+    tokenizer: A tokenizer used to parse the number.
+
+  Returns:
+    The integer parsed.
+
+  Raises:
+    ParseError: If an unsigned 32bit integer couldn't be consumed.
+  """
+  return _ConsumeInteger(tokenizer, is_signed=False, is_long=False)
+
+
+def _TryConsumeInt64(tokenizer):
+  try:
+    _ConsumeInt64(tokenizer)
+    return True
+  except ParseError:
+    return False
+
+
+def _ConsumeInt64(tokenizer):
+  """Consumes a signed 32bit integer number from tokenizer.
+
+  Args:
+    tokenizer: A tokenizer used to parse the number.
+
+  Returns:
+    The integer parsed.
+
+  Raises:
+    ParseError: If a signed 32bit integer couldn't be consumed.
+  """
+  return _ConsumeInteger(tokenizer, is_signed=True, is_long=True)
+
+
+def _TryConsumeUint64(tokenizer):
+  try:
+    _ConsumeUint64(tokenizer)
+    return True
+  except ParseError:
+    return False
+
+
+def _ConsumeUint64(tokenizer):
+  """Consumes an unsigned 64bit integer number from tokenizer.
+
+  Args:
+    tokenizer: A tokenizer used to parse the number.
+
+  Returns:
+    The integer parsed.
+
+  Raises:
+    ParseError: If an unsigned 64bit integer couldn't be consumed.
+  """
+  return _ConsumeInteger(tokenizer, is_signed=False, is_long=True)
+
+
+def _ConsumeInteger(tokenizer, is_signed=False, is_long=False):
+  """Consumes an integer number from tokenizer.
+
+  Args:
+    tokenizer: A tokenizer used to parse the number.
+    is_signed: True if a signed integer must be parsed.
+    is_long: True if a long integer must be parsed.
+
+  Returns:
+    The integer parsed.
+
+  Raises:
+    ParseError: If an integer with given characteristics couldn't be consumed.
+  """
+  try:
+    result = ParseInteger(tokenizer.token, is_signed=is_signed, is_long=is_long)
+  except ValueError as e:
+    raise tokenizer.ParseError(str(e))
+  tokenizer.NextToken()
+  return result
+
+
+def ParseInteger(text, is_signed=False, is_long=False):
+  """Parses an integer.
+
+  Args:
+    text: The text to parse.
+    is_signed: True if a signed integer must be parsed.
+    is_long: True if a long integer must be parsed.
+
+  Returns:
+    The integer value.
+
+  Raises:
+    ValueError: Thrown Iff the text is not a valid integer.
+  """
+  # Do the actual parsing. Exception handling is propagated to caller.
+  result = _ParseAbstractInteger(text)
+
+  # Check if the integer is sane. Exceptions handled by callers.
+  checker = _INTEGER_CHECKERS[2 * int(is_long) + int(is_signed)]
+  checker.CheckValue(result)
+  return result
+
+
+def _ParseAbstractInteger(text):
+  """Parses an integer without checking size/signedness.
+
+  Args:
+    text: The text to parse.
+
+  Returns:
+    The integer value.
+
+  Raises:
+    ValueError: Thrown Iff the text is not a valid integer.
+  """
+  # Do the actual parsing. Exception handling is propagated to caller.
+  orig_text = text
+  c_octal_match = re.match(r'(-?)0(\d+)$', text)
+  if c_octal_match:
+    # Python 3 no longer supports 0755 octal syntax without the 'o', so
+    # we always use the '0o' prefix for multi-digit numbers starting with 0.
+    text = c_octal_match.group(1) + '0o' + c_octal_match.group(2)
+  try:
+    return int(text, 0)
+  except ValueError:
+    raise ValueError('Couldn\'t parse integer: %s' % orig_text)
+
+
+def ParseFloat(text):
+  """Parse a floating point number.
+
+  Args:
+    text: Text to parse.
+
+  Returns:
+    The number parsed.
+
+  Raises:
+    ValueError: If a floating point number couldn't be parsed.
+  """
+  try:
+    # Assume Python compatible syntax.
+    return float(text)
+  except ValueError:
+    # Check alternative spellings.
+    if _FLOAT_INFINITY.match(text):
+      if text[0] == '-':
+        return float('-inf')
+      else:
+        return float('inf')
+    elif _FLOAT_NAN.match(text):
+      return float('nan')
+    else:
+      # assume '1.0f' format
+      try:
+        return float(text.rstrip('f'))
+      except ValueError:
+        raise ValueError('Couldn\'t parse float: %s' % text)
+
+
+def ParseBool(text):
+  """Parse a boolean value.
+
+  Args:
+    text: Text to parse.
+
+  Returns:
+    Boolean values parsed
+
+  Raises:
+    ValueError: If text is not a valid boolean.
+  """
+  if text in ('true', 't', '1', 'True'):
+    return True
+  elif text in ('false', 'f', '0', 'False'):
+    return False
+  else:
+    raise ValueError('Expected "true" or "false".')
+
+
+def ParseEnum(field, value):
+  """Parse an enum value.
+
+  The value can be specified by a number (the enum value), or by
+  a string literal (the enum name).
+
+  Args:
+    field: Enum field descriptor.
+    value: String value.
+
+  Returns:
+    Enum value number.
+
+  Raises:
+    ValueError: If the enum value could not be parsed.
+  """
+  enum_descriptor = field.enum_type
+  try:
+    number = int(value, 0)
+  except ValueError:
+    # Identifier.
+    enum_value = enum_descriptor.values_by_name.get(value, None)
+    if enum_value is None:
+      raise ValueError('Enum type "%s" has no value named %s.' %
+                       (enum_descriptor.full_name, value))
+  else:
+    if not field.enum_type.is_closed:
+      return number
+    enum_value = enum_descriptor.values_by_number.get(number, None)
+    if enum_value is None:
+      raise ValueError('Enum type "%s" has no value with number %d.' %
+                       (enum_descriptor.full_name, number))
+  return enum_value.number
diff --git a/llm/Lib/site-packages/google/protobuf/timestamp_pb2.py b/llm/Lib/site-packages/google/protobuf/timestamp_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..b28a1f5a72bfb40cffc1a1a44d5e4c32ecfc9193
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/timestamp_pb2.py
@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/timestamp.proto
+# Protobuf Python Version: 4.25.3
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1fgoogle/protobuf/timestamp.proto\x12\x0fgoogle.protobuf\";\n\tTimestamp\x12\x18\n\x07seconds\x18\x01 \x01(\x03R\x07seconds\x12\x14\n\x05nanos\x18\x02 \x01(\x05R\x05nanosB\x85\x01\n\x13\x63om.google.protobufB\x0eTimestampProtoP\x01Z2google.golang.org/protobuf/types/known/timestamppb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'google.protobuf.timestamp_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\023com.google.protobufB\016TimestampProtoP\001Z2google.golang.org/protobuf/types/known/timestamppb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes'
+  _globals['_TIMESTAMP']._serialized_start=52
+  _globals['_TIMESTAMP']._serialized_end=111
+# @@protoc_insertion_point(module_scope)
diff --git a/llm/Lib/site-packages/google/protobuf/type_pb2.py b/llm/Lib/site-packages/google/protobuf/type_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..b33c704525003d713023db8bc2595737286a8e38
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/type_pb2.py
@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/type.proto
+# Protobuf Python Version: 4.25.3
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+from google.protobuf import source_context_pb2 as google_dot_protobuf_dot_source__context__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1agoogle/protobuf/type.proto\x12\x0fgoogle.protobuf\x1a\x19google/protobuf/any.proto\x1a$google/protobuf/source_context.proto\"\xa7\x02\n\x04Type\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12.\n\x06\x66ields\x18\x02 \x03(\x0b\x32\x16.google.protobuf.FieldR\x06\x66ields\x12\x16\n\x06oneofs\x18\x03 \x03(\tR\x06oneofs\x12\x31\n\x07options\x18\x04 \x03(\x0b\x32\x17.google.protobuf.OptionR\x07options\x12\x45\n\x0esource_context\x18\x05 \x01(\x0b\x32\x1e.google.protobuf.SourceContextR\rsourceContext\x12/\n\x06syntax\x18\x06 \x01(\x0e\x32\x17.google.protobuf.SyntaxR\x06syntax\x12\x18\n\x07\x65\x64ition\x18\x07 \x01(\tR\x07\x65\x64ition\"\xb4\x06\n\x05\x46ield\x12/\n\x04kind\x18\x01 \x01(\x0e\x32\x1b.google.protobuf.Field.KindR\x04kind\x12\x44\n\x0b\x63\x61rdinality\x18\x02 \x01(\x0e\x32\".google.protobuf.Field.CardinalityR\x0b\x63\x61rdinality\x12\x16\n\x06number\x18\x03 \x01(\x05R\x06number\x12\x12\n\x04name\x18\x04 \x01(\tR\x04name\x12\x19\n\x08type_url\x18\x06 \x01(\tR\x07typeUrl\x12\x1f\n\x0boneof_index\x18\x07 \x01(\x05R\noneofIndex\x12\x16\n\x06packed\x18\x08 \x01(\x08R\x06packed\x12\x31\n\x07options\x18\t \x03(\x0b\x32\x17.google.protobuf.OptionR\x07options\x12\x1b\n\tjson_name\x18\n \x01(\tR\x08jsonName\x12#\n\rdefault_value\x18\x0b \x01(\tR\x0c\x64\x65\x66\x61ultValue\"\xc8\x02\n\x04Kind\x12\x10\n\x0cTYPE_UNKNOWN\x10\x00\x12\x0f\n\x0bTYPE_DOUBLE\x10\x01\x12\x0e\n\nTYPE_FLOAT\x10\x02\x12\x0e\n\nTYPE_INT64\x10\x03\x12\x0f\n\x0bTYPE_UINT64\x10\x04\x12\x0e\n\nTYPE_INT32\x10\x05\x12\x10\n\x0cTYPE_FIXED64\x10\x06\x12\x10\n\x0cTYPE_FIXED32\x10\x07\x12\r\n\tTYPE_BOOL\x10\x08\x12\x0f\n\x0bTYPE_STRING\x10\t\x12\x0e\n\nTYPE_GROUP\x10\n\x12\x10\n\x0cTYPE_MESSAGE\x10\x0b\x12\x0e\n\nTYPE_BYTES\x10\x0c\x12\x0f\n\x0bTYPE_UINT32\x10\r\x12\r\n\tTYPE_ENUM\x10\x0e\x12\x11\n\rTYPE_SFIXED32\x10\x0f\x12\x11\n\rTYPE_SFIXED64\x10\x10\x12\x0f\n\x0bTYPE_SINT32\x10\x11\x12\x0f\n\x0bTYPE_SINT64\x10\x12\"t\n\x0b\x43\x61rdinality\x12\x17\n\x13\x43\x41RDINALITY_UNKNOWN\x10\x00\x12\x18\n\x14\x43\x41RDINALITY_OPTIONAL\x10\x01\x12\x18\n\x14\x43\x41RDINALITY_REQUIRED\x10\x02\x12\x18\n\x14\x43\x41RDINALITY_REPEATED\x10\x03\"\x99\x02\n\x04\x45num\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x38\n\tenumvalue\x18\x02 \x03(\x0b\x32\x1a.google.protobuf.EnumValueR\tenumvalue\x12\x31\n\x07options\x18\x03 \x03(\x0b\x32\x17.google.protobuf.OptionR\x07options\x12\x45\n\x0esource_context\x18\x04 \x01(\x0b\x32\x1e.google.protobuf.SourceContextR\rsourceContext\x12/\n\x06syntax\x18\x05 \x01(\x0e\x32\x17.google.protobuf.SyntaxR\x06syntax\x12\x18\n\x07\x65\x64ition\x18\x06 \x01(\tR\x07\x65\x64ition\"j\n\tEnumValue\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12\x16\n\x06number\x18\x02 \x01(\x05R\x06number\x12\x31\n\x07options\x18\x03 \x03(\x0b\x32\x17.google.protobuf.OptionR\x07options\"H\n\x06Option\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12*\n\x05value\x18\x02 \x01(\x0b\x32\x14.google.protobuf.AnyR\x05value*C\n\x06Syntax\x12\x11\n\rSYNTAX_PROTO2\x10\x00\x12\x11\n\rSYNTAX_PROTO3\x10\x01\x12\x13\n\x0fSYNTAX_EDITIONS\x10\x02\x42{\n\x13\x63om.google.protobufB\tTypeProtoP\x01Z-google.golang.org/protobuf/types/known/typepb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'google.protobuf.type_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\023com.google.protobufB\tTypeProtoP\001Z-google.golang.org/protobuf/types/known/typepb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes'
+  _globals['_SYNTAX']._serialized_start=1699
+  _globals['_SYNTAX']._serialized_end=1766
+  _globals['_TYPE']._serialized_start=113
+  _globals['_TYPE']._serialized_end=408
+  _globals['_FIELD']._serialized_start=411
+  _globals['_FIELD']._serialized_end=1231
+  _globals['_FIELD_KIND']._serialized_start=785
+  _globals['_FIELD_KIND']._serialized_end=1113
+  _globals['_FIELD_CARDINALITY']._serialized_start=1115
+  _globals['_FIELD_CARDINALITY']._serialized_end=1231
+  _globals['_ENUM']._serialized_start=1234
+  _globals['_ENUM']._serialized_end=1515
+  _globals['_ENUMVALUE']._serialized_start=1517
+  _globals['_ENUMVALUE']._serialized_end=1623
+  _globals['_OPTION']._serialized_start=1625
+  _globals['_OPTION']._serialized_end=1697
+# @@protoc_insertion_point(module_scope)
diff --git a/llm/Lib/site-packages/google/protobuf/unknown_fields.py b/llm/Lib/site-packages/google/protobuf/unknown_fields.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b1e549324308500527f0b8d1c051b43efb807a6
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/unknown_fields.py
@@ -0,0 +1,97 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+#
+# Use of this source code is governed by a BSD-style
+# license that can be found in the LICENSE file or at
+# https://developers.google.com/open-source/licenses/bsd
+
+"""Contains Unknown Fields APIs.
+
+Simple usage example:
+  unknown_field_set = UnknownFieldSet(message)
+  for unknown_field in unknown_field_set:
+    wire_type = unknown_field.wire_type
+    field_number = unknown_field.field_number
+    data = unknown_field.data
+"""
+
+
+from google.protobuf.internal import api_implementation
+
+if api_implementation._c_module is not None:  # pylint: disable=protected-access
+  UnknownFieldSet = api_implementation._c_module.UnknownFieldSet  # pylint: disable=protected-access
+else:
+  from google.protobuf.internal import decoder  # pylint: disable=g-import-not-at-top
+  from google.protobuf.internal import wire_format  # pylint: disable=g-import-not-at-top
+
+  class UnknownField:
+    """A parsed unknown field."""
+
+    # Disallows assignment to other attributes.
+    __slots__ = ['_field_number', '_wire_type', '_data']
+
+    def __init__(self, field_number, wire_type, data):
+      self._field_number = field_number
+      self._wire_type = wire_type
+      self._data = data
+      return
+
+    @property
+    def field_number(self):
+      return self._field_number
+
+    @property
+    def wire_type(self):
+      return self._wire_type
+
+    @property
+    def data(self):
+      return self._data
+
+  class UnknownFieldSet:
+    """UnknownField container."""
+
+    # Disallows assignment to other attributes.
+    __slots__ = ['_values']
+
+    def __init__(self, msg):
+
+      def InternalAdd(field_number, wire_type, data):
+        unknown_field = UnknownField(field_number, wire_type, data)
+        self._values.append(unknown_field)
+
+      self._values = []
+      msg_des = msg.DESCRIPTOR
+      # pylint: disable=protected-access
+      unknown_fields = msg._unknown_fields
+      if (msg_des.has_options and
+          msg_des.GetOptions().message_set_wire_format):
+        local_decoder = decoder.UnknownMessageSetItemDecoder()
+        for _, buffer in unknown_fields:
+          (field_number, data) = local_decoder(memoryview(buffer))
+          InternalAdd(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED, data)
+      else:
+        for tag_bytes, buffer in unknown_fields:
+          # pylint: disable=protected-access
+          (tag, _) = decoder._DecodeVarint(tag_bytes, 0)
+          field_number, wire_type = wire_format.UnpackTag(tag)
+          if field_number == 0:
+            raise RuntimeError('Field number 0 is illegal.')
+          (data, _) = decoder._DecodeUnknownField(
+              memoryview(buffer), 0, wire_type)
+          InternalAdd(field_number, wire_type, data)
+
+    def __getitem__(self, index):
+      size = len(self._values)
+      if index < 0:
+        index += size
+      if index < 0 or index >= size:
+        raise IndexError('index %d out of range'.index)
+
+      return self._values[index]
+
+    def __len__(self):
+      return len(self._values)
+
+    def __iter__(self):
+      return iter(self._values)
diff --git a/llm/Lib/site-packages/google/protobuf/util/__init__.py b/llm/Lib/site-packages/google/protobuf/util/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/google/protobuf/util/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/google/protobuf/util/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ac51f98a637318975e63702d3dfc0129555644c4
Binary files /dev/null and b/llm/Lib/site-packages/google/protobuf/util/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/google/protobuf/wrappers_pb2.py b/llm/Lib/site-packages/google/protobuf/wrappers_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..1aa5744a83e243686eb952c69cf9688d0c798eea
--- /dev/null
+++ b/llm/Lib/site-packages/google/protobuf/wrappers_pb2.py
@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/wrappers.proto
+# Protobuf Python Version: 4.25.3
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1egoogle/protobuf/wrappers.proto\x12\x0fgoogle.protobuf\"#\n\x0b\x44oubleValue\x12\x14\n\x05value\x18\x01 \x01(\x01R\x05value\"\"\n\nFloatValue\x12\x14\n\x05value\x18\x01 \x01(\x02R\x05value\"\"\n\nInt64Value\x12\x14\n\x05value\x18\x01 \x01(\x03R\x05value\"#\n\x0bUInt64Value\x12\x14\n\x05value\x18\x01 \x01(\x04R\x05value\"\"\n\nInt32Value\x12\x14\n\x05value\x18\x01 \x01(\x05R\x05value\"#\n\x0bUInt32Value\x12\x14\n\x05value\x18\x01 \x01(\rR\x05value\"!\n\tBoolValue\x12\x14\n\x05value\x18\x01 \x01(\x08R\x05value\"#\n\x0bStringValue\x12\x14\n\x05value\x18\x01 \x01(\tR\x05value\"\"\n\nBytesValue\x12\x14\n\x05value\x18\x01 \x01(\x0cR\x05valueB\x83\x01\n\x13\x63om.google.protobufB\rWrappersProtoP\x01Z1google.golang.org/protobuf/types/known/wrapperspb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'google.protobuf.wrappers_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  _globals['DESCRIPTOR']._options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\023com.google.protobufB\rWrappersProtoP\001Z1google.golang.org/protobuf/types/known/wrapperspb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes'
+  _globals['_DOUBLEVALUE']._serialized_start=51
+  _globals['_DOUBLEVALUE']._serialized_end=86
+  _globals['_FLOATVALUE']._serialized_start=88
+  _globals['_FLOATVALUE']._serialized_end=122
+  _globals['_INT64VALUE']._serialized_start=124
+  _globals['_INT64VALUE']._serialized_end=158
+  _globals['_UINT64VALUE']._serialized_start=160
+  _globals['_UINT64VALUE']._serialized_end=195
+  _globals['_INT32VALUE']._serialized_start=197
+  _globals['_INT32VALUE']._serialized_end=231
+  _globals['_UINT32VALUE']._serialized_start=233
+  _globals['_UINT32VALUE']._serialized_end=268
+  _globals['_BOOLVALUE']._serialized_start=270
+  _globals['_BOOLVALUE']._serialized_end=303
+  _globals['_STRINGVALUE']._serialized_start=305
+  _globals['_STRINGVALUE']._serialized_end=340
+  _globals['_BYTESVALUE']._serialized_start=342
+  _globals['_BYTESVALUE']._serialized_end=376
+# @@protoc_insertion_point(module_scope)
diff --git a/llm/Lib/site-packages/greenlet-3.0.3.dist-info/AUTHORS b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/AUTHORS
new file mode 100644
index 0000000000000000000000000000000000000000..42a5c227b4401333cd40db283d06c4471786afd8
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/AUTHORS
@@ -0,0 +1,51 @@
+Original Authors
+----------------
+* Armin Rigo
+* Christian Tismer
+
+Contributors
+------------
+* Al Stone
+* Alexander Schmidt
+* Alexey Borzenkov
+* Andreas Schwab
+* Armin Ronacher
+* Bin Wang <feisuzhu@163.com>
+* Bob Ippolito
+* ChangBo Guo
+* Christoph Gohlke
+* Denis Bilenko
+* Dirk Mueller
+* Donovan Preston
+* Fantix King
+* Floris Bruynooghe
+* Fredrik Fornwall
+* Gerd Woetzel
+* Giel van Schijndel
+* Gökhan Karabulut
+* Gustavo Niemeyer
+* Guy Rozendorn
+* Hye-Shik Chang
+* Jared Kuolt
+* Jason Madden
+* Josh Snyder
+* Kyle Ambroff
+* Laszlo Boszormenyi
+* Mao Han
+* Marc Abramowitz
+* Marc Schlaich
+* Marcin Bachry
+* Matt Madison
+* Matt Turner
+* Michael Ellerman
+* Michael Matz
+* Ralf Schmitt
+* Robie Basak
+* Ronny Pfannschmidt
+* Samual M. Rushing
+* Tony Bowles
+* Tony Breeds
+* Trevor Bowen
+* Tulio Magno Quites Machado Filho
+* Ulrich Weigand
+* Victor Stinner
diff --git a/llm/Lib/site-packages/greenlet-3.0.3.dist-info/INSTALLER b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/greenlet-3.0.3.dist-info/LICENSE b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..b73a4a10c6fa93a3a6fa47deb3796c590a9dee10
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/LICENSE
@@ -0,0 +1,30 @@
+The following files are derived from Stackless Python and are subject to the
+same license as Stackless Python:
+
+	src/greenlet/slp_platformselect.h
+	files in src/greenlet/platform/ directory
+
+See LICENSE.PSF and http://www.stackless.com/ for details.
+
+Unless otherwise noted, the files in greenlet have been released under the
+following MIT license:
+
+Copyright (c) Armin Rigo, Christian Tismer and contributors
+
+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
+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.
diff --git a/llm/Lib/site-packages/greenlet-3.0.3.dist-info/LICENSE.PSF b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/LICENSE.PSF
new file mode 100644
index 0000000000000000000000000000000000000000..d3b509a2b4119c47ad86af9fc1b400ce2eb09cf1
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/LICENSE.PSF
@@ -0,0 +1,47 @@
+PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
+--------------------------------------------
+
+1. This LICENSE AGREEMENT is between the Python Software Foundation
+("PSF"), and the Individual or Organization ("Licensee") accessing and
+otherwise using this software ("Python") in source or binary form and
+its associated documentation.
+
+2. Subject to the terms and conditions of this License Agreement, PSF hereby
+grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce,
+analyze, test, perform and/or display publicly, prepare derivative works,
+distribute, and otherwise use Python alone or in any derivative version,
+provided, however, that PSF's License Agreement and PSF's notice of copyright,
+i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
+2011 Python Software Foundation; All Rights Reserved" are retained in Python
+alone or in any derivative version prepared by Licensee.
+
+3. In the event Licensee prepares a derivative work that is based on
+or incorporates Python or any part thereof, and wants to make
+the derivative work available to others as provided herein, then
+Licensee hereby agrees to include in any such work a brief summary of
+the changes made to Python.
+
+4. PSF is making Python available to Licensee on an "AS IS"
+basis.  PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
+IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND
+DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
+FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT
+INFRINGE ANY THIRD PARTY RIGHTS.
+
+5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
+FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
+A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON,
+OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
+
+6. This License Agreement will automatically terminate upon a material
+breach of its terms and conditions.
+
+7. Nothing in this License Agreement shall be deemed to create any
+relationship of agency, partnership, or joint venture between PSF and
+Licensee.  This License Agreement does not grant permission to use PSF
+trademarks or trade name in a trademark sense to endorse or promote
+products or services of Licensee, or any third party.
+
+8. By copying, installing or otherwise using Python, Licensee
+agrees to be bound by the terms and conditions of this License
+Agreement.
diff --git a/llm/Lib/site-packages/greenlet-3.0.3.dist-info/METADATA b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..0298776deb829ab0a9e5ac04650a541f05c8ac04
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/METADATA
@@ -0,0 +1,102 @@
+Metadata-Version: 2.1
+Name: greenlet
+Version: 3.0.3
+Summary: Lightweight in-process concurrent programming
+Home-page: https://greenlet.readthedocs.io/
+Author: Alexey Borzenkov
+Author-email: snaury@gmail.com
+Maintainer: Jason Madden
+Maintainer-email: jason@seecoresoftware.com
+License: MIT License
+Project-URL: Bug Tracker, https://github.com/python-greenlet/greenlet/issues
+Project-URL: Source Code, https://github.com/python-greenlet/greenlet/
+Project-URL: Documentation, https://greenlet.readthedocs.io/
+Keywords: greenlet coroutine concurrency threads cooperative
+Platform: any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+License-File: LICENSE.PSF
+License-File: AUTHORS
+Provides-Extra: docs
+Requires-Dist: Sphinx ; extra == 'docs'
+Requires-Dist: furo ; extra == 'docs'
+Provides-Extra: test
+Requires-Dist: objgraph ; extra == 'test'
+Requires-Dist: psutil ; extra == 'test'
+
+.. This file is included into docs/history.rst
+
+
+Greenlets are lightweight coroutines for in-process concurrent
+programming.
+
+The "greenlet" package is a spin-off of `Stackless`_, a version of
+CPython that supports micro-threads called "tasklets". Tasklets run
+pseudo-concurrently (typically in a single or a few OS-level threads)
+and are synchronized with data exchanges on "channels".
+
+A "greenlet", on the other hand, is a still more primitive notion of
+micro-thread with no implicit scheduling; coroutines, in other words.
+This is useful when you want to control exactly when your code runs.
+You can build custom scheduled micro-threads on top of greenlet;
+however, it seems that greenlets are useful on their own as a way to
+make advanced control flow structures. For example, we can recreate
+generators; the difference with Python's own generators is that our
+generators can call nested functions and the nested functions can
+yield values too. (Additionally, you don't need a "yield" keyword. See
+the example in `test_generator.py
+<https://github.com/python-greenlet/greenlet/blob/adca19bf1f287b3395896a8f41f3f4fd1797fdc7/src/greenlet/tests/test_generator.py#L1>`_).
+
+Greenlets are provided as a C extension module for the regular unmodified
+interpreter.
+
+.. _`Stackless`: http://www.stackless.com
+
+
+Who is using Greenlet?
+======================
+
+There are several libraries that use Greenlet as a more flexible
+alternative to Python's built in coroutine support:
+
+ - `Concurrence`_
+ - `Eventlet`_
+ - `Gevent`_
+
+.. _Concurrence: http://opensource.hyves.org/concurrence/
+.. _Eventlet: http://eventlet.net/
+.. _Gevent: http://www.gevent.org/
+
+Getting Greenlet
+================
+
+The easiest way to get Greenlet is to install it with pip::
+
+  pip install greenlet
+
+
+Source code archives and binary distributions are available on the
+python package index at https://pypi.org/project/greenlet
+
+The source code repository is hosted on github:
+https://github.com/python-greenlet/greenlet
+
+Documentation is available on readthedocs.org:
+https://greenlet.readthedocs.io
diff --git a/llm/Lib/site-packages/greenlet-3.0.3.dist-info/RECORD b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..d6a23c75139ed70e6bcc5cbd992cd2837f209aee
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/RECORD
@@ -0,0 +1,116 @@
+../../include/site/python3.11/greenlet/greenlet.h,sha256=sz5pYRSQqedgOt2AMgxLZdTjO-qcr_JMvgiEJR9IAJ8,4755
+greenlet-3.0.3.dist-info/AUTHORS,sha256=swW28t2knVRxRkaEQNZtO7MP9Sgnompb7B6cNgJM8Gk,849
+greenlet-3.0.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+greenlet-3.0.3.dist-info/LICENSE,sha256=dpgx1uXfrywggC-sz_H6-0wgJd2PYlPfpH_K1Z1NCXk,1434
+greenlet-3.0.3.dist-info/LICENSE.PSF,sha256=5f88I8EQ5JTNfXNsEP2W1GJFe6_soxCEDbZScpjH1Gs,2424
+greenlet-3.0.3.dist-info/METADATA,sha256=LjLm176aHpnFw1eMigcZGdnc0OgCO7LKPy21O4WhAp0,3881
+greenlet-3.0.3.dist-info/RECORD,,
+greenlet-3.0.3.dist-info/WHEEL,sha256=ircjsfhzblqgSzO8ow7-0pXK-RVqDqNRGQ8F650AUNM,102
+greenlet-3.0.3.dist-info/top_level.txt,sha256=YSnRsCRoO61JGlP57o8iKL6rdLWDWuiyKD8ekpWUsDc,9
+greenlet/TBrokenGreenlet.cpp,sha256=YgKaHkQV6_dKBrgS0HKDSqZroskv0IwSZDo4bsiwz3w,1029
+greenlet/TExceptionState.cpp,sha256=Ctg2YfyEYNjOYbteRB_oIJa9lNGyC7N1F3h4XqqQdg8,1367
+greenlet/TGreenlet.cpp,sha256=1xwAzGNqO68AZ4D5lD5DHmGPBohM6nv4BYnLatgIL68,25637
+greenlet/TGreenletGlobals.cpp,sha256=qLi1icS1UDSbefTkolz9TycEi_GOUblsEznMp0HFywQ,3268
+greenlet/TMainGreenlet.cpp,sha256=FvWtGJDKb64DLy0n-ddcTF6xJDwczPMKSm9mXSsHJKg,3365
+greenlet/TPythonState.cpp,sha256=QUoIQzF0HYmAJO_nwX5gXSSlMNL1mkxlN24KJCXIrIQ,14861
+greenlet/TStackState.cpp,sha256=VclDR-qiMeJjuiJxL9_u24MJiTgdSaYvr8bWQdTEZjY,7389
+greenlet/TThreadStateDestroy.cpp,sha256=EqZ-GjksrWNC20CY_P0yXN43wVRMYEh659SmRRqBaI4,7214
+greenlet/TUserGreenlet.cpp,sha256=b_Bmh4WZdS6I1yM2AfHRtd535WovtpYMkpfu2GQpaDs,23618
+greenlet/__init__.py,sha256=Dw4tovn18bpPaWQ4SK7jDJe24uV4ao264UfaT0uufxU,1723
+greenlet/__pycache__/__init__.cpython-311.pyc,,
+greenlet/_greenlet.cp311-win_amd64.pyd,sha256=x467oRjf1xR9J7Qa4d6TI1yBtNeDNy4hkb2oivDMPBY,220160
+greenlet/greenlet.cpp,sha256=k9RZolayY79WgjPXwcA3Vcv48MuW7TAtogIZPaDD3gM,48815
+greenlet/greenlet.h,sha256=sz5pYRSQqedgOt2AMgxLZdTjO-qcr_JMvgiEJR9IAJ8,4755
+greenlet/greenlet_allocator.hpp,sha256=kxyWW4Qdwlrc7ufgdb5vd6Y7jhauQ699Kod0mqiO1iM,1582
+greenlet/greenlet_compiler_compat.hpp,sha256=m7wvwrZqBoCQpDMTP-Z7whdXIES7e3AuXBgvPHSsfxg,4140
+greenlet/greenlet_cpython_add_pending.hpp,sha256=apAwIhGlgYrnYn03zWL6Sxy68kltDeb1e0QupZfb3DQ,6043
+greenlet/greenlet_cpython_compat.hpp,sha256=ZpN8gewZeOtd6T-mLidA7zteQ_P4vG8T1za_KPvCijg,3621
+greenlet/greenlet_exceptions.hpp,sha256=Dt8YdaQn8AK9nBfwU9rrDoMlR2Lw5aLTQV6ZAsHmfsw,3683
+greenlet/greenlet_greenlet.hpp,sha256=Ct_EAx4OJL6FvF5g3jV1ybSxnqzLVaRdPi2EcYT1iq4,27728
+greenlet/greenlet_internal.hpp,sha256=ZXH5zemWCN8wH8zAqMUGycvz_3IulRL6Gf2hZA6CknE,2703
+greenlet/greenlet_refs.hpp,sha256=ECkHKV1CVamtzmWWGKXXMpw8lXLeIzastXM9tfqlsNI,33864
+greenlet/greenlet_slp_switch.hpp,sha256=kM1QHA2iV-gH4cFyN6lfIagHQxvJZjWOVJdIxRE3TlQ,3198
+greenlet/greenlet_thread_state.hpp,sha256=0UwJCNd86ifwM2yDd3QrNmHAECL-eNADHubwiB_XGA4,20614
+greenlet/greenlet_thread_state_dict_cleanup.hpp,sha256=tEN0rI1pZiEsdtr7Oda24gr52fGiHnYTLyM8Vme3Gns,3831
+greenlet/greenlet_thread_support.hpp,sha256=XUJ6ljWjf9OYyuOILiz8e_yHvT3fbaUiHdhiPNQUV4s,867
+greenlet/platform/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+greenlet/platform/__pycache__/__init__.cpython-311.pyc,,
+greenlet/platform/setup_switch_x64_masm.cmd,sha256=ZpClUJeU0ujEPSTWNSepP0W2f9XiYQKA8QKSoVou8EU,143
+greenlet/platform/switch_aarch64_gcc.h,sha256=GKC0yWNXnbK2X--X6aguRCMj2Tg7hDU1Zkl3RljDvC8,4307
+greenlet/platform/switch_alpha_unix.h,sha256=Z-SvF8JQV3oxWT8JRbL9RFu4gRFxPdJ7cviM8YayMmw,671
+greenlet/platform/switch_amd64_unix.h,sha256=EcSFCBlodEBhqhKjcJqY_5Dn_jn7pKpkJlOvp7gFXLI,2748
+greenlet/platform/switch_arm32_gcc.h,sha256=Z3KkHszdgq6uU4YN3BxvKMG2AdDnovwCCNrqGWZ1Lyo,2479
+greenlet/platform/switch_arm32_ios.h,sha256=mm5_R9aXB92hyxzFRwB71M60H6AlvHjrpTrc72Pz3l8,1892
+greenlet/platform/switch_arm64_masm.asm,sha256=4kpTtfy7rfcr8j1CpJLAK21EtZpGDAJXWRU68HEy5A8,1245
+greenlet/platform/switch_arm64_masm.obj,sha256=DmLnIB_icoEHAz1naue_pJPTZgR9ElM7-Nmztr-o9_U,746
+greenlet/platform/switch_arm64_msvc.h,sha256=RqK5MHLmXI3Q-FQ7tm32KWnbDNZKnkJdq8CR89cz640,398
+greenlet/platform/switch_csky_gcc.h,sha256=kDikyiPpewP71KoBZQO_MukDTXTXBiC7x-hF0_2DL0w,1331
+greenlet/platform/switch_loongarch64_linux.h,sha256=7M-Dhc4Q8tRbJCJhalDLwU6S9Mx8MjmN1RbTDgIvQTM,779
+greenlet/platform/switch_m68k_gcc.h,sha256=VSa6NpZhvyyvF-Q58CTIWSpEDo4FKygOyTz00whctlw,928
+greenlet/platform/switch_mips_unix.h,sha256=E0tYsqc5anDY1BhenU1l8DW-nVHC_BElzLgJw3TGtPk,1426
+greenlet/platform/switch_ppc64_aix.h,sha256=_BL0iyRr3ZA5iPlr3uk9SJ5sNRWGYLrXcZ5z-CE9anE,3860
+greenlet/platform/switch_ppc64_linux.h,sha256=0rriT5XyxPb0GqsSSn_bP9iQsnjsPbBmu0yqo5goSyQ,3815
+greenlet/platform/switch_ppc_aix.h,sha256=pHA4slEjUFP3J3SYm1TAlNPhgb2G_PAtax5cO8BEe1A,2941
+greenlet/platform/switch_ppc_linux.h,sha256=YwrlKUzxlXuiKMQqr6MFAV1bPzWnmvk6X1AqJZEpOWU,2759
+greenlet/platform/switch_ppc_macosx.h,sha256=L8sB0c00V4G2_5cQCG3zX-23DKq3le_Dcj0sUDcACos,2624
+greenlet/platform/switch_ppc_unix.h,sha256=POy4bRBcH74Chfw4viFE9bVlZ-7BaNsFC0NnXr1L2tg,2652
+greenlet/platform/switch_riscv_unix.h,sha256=jX3vC_xZXiUho8tz4J6Ai8BNQB80yLn03fxkoMztVCU,740
+greenlet/platform/switch_s390_unix.h,sha256=RRlGu957ybmq95qNNY4Qw1mcaoT3eBnW5KbVwu48KX8,2763
+greenlet/platform/switch_sparc_sun_gcc.h,sha256=xZish9GsMHBienUbUMsX1-ZZ-as7hs36sVhYIE3ew8Y,2797
+greenlet/platform/switch_x32_unix.h,sha256=nM98PKtzTWc1lcM7TRMUZJzskVdR1C69U1UqZRWX0GE,1509
+greenlet/platform/switch_x64_masm.asm,sha256=nu6n2sWyXuXfpPx40d9YmLfHXUc1sHgeTvX1kUzuvEM,1841
+greenlet/platform/switch_x64_masm.obj,sha256=GNtTNxYdo7idFUYsQv-mrXWgyT5EJ93-9q90lN6svtQ,1078
+greenlet/platform/switch_x64_msvc.h,sha256=LIeasyKo_vHzspdMzMHbosRhrBfKI4BkQOh4qcTHyJw,1805
+greenlet/platform/switch_x86_msvc.h,sha256=TtGOwinbFfnn6clxMNkCz8i6OmgB6kVRrShoF5iT9to,12838
+greenlet/platform/switch_x86_unix.h,sha256=VplW9H0FF0cZHw1DhJdIUs5q6YLS4cwb2nYwjF83R1s,3059
+greenlet/slp_platformselect.h,sha256=JEnia_2HsTwdqvnnEsDxHQqalYvFJqx_CDsqvNUQYe8,3600
+greenlet/tests/__init__.py,sha256=F282jaIavKrhsYgHJEXtIQXKHdHpe9OJOPTK7R40JzI,9022
+greenlet/tests/__pycache__/__init__.cpython-311.pyc,,
+greenlet/tests/__pycache__/fail_clearing_run_switches.cpython-311.pyc,,
+greenlet/tests/__pycache__/fail_cpp_exception.cpython-311.pyc,,
+greenlet/tests/__pycache__/fail_initialstub_already_started.cpython-311.pyc,,
+greenlet/tests/__pycache__/fail_slp_switch.cpython-311.pyc,,
+greenlet/tests/__pycache__/fail_switch_three_greenlets.cpython-311.pyc,,
+greenlet/tests/__pycache__/fail_switch_three_greenlets2.cpython-311.pyc,,
+greenlet/tests/__pycache__/fail_switch_two_greenlets.cpython-311.pyc,,
+greenlet/tests/__pycache__/leakcheck.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_contextvars.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_cpp.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_extension_interface.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_gc.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_generator.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_generator_nested.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_greenlet.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_greenlet_trash.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_leaks.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_stack_saved.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_throw.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_tracing.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_version.cpython-311.pyc,,
+greenlet/tests/__pycache__/test_weakref.cpython-311.pyc,,
+greenlet/tests/_test_extension.c,sha256=vkeGA-6oeJcGILsD7oIrT1qZop2GaTOHXiNT7mcSl-0,5773
+greenlet/tests/_test_extension.cp311-win_amd64.pyd,sha256=DpTTzao8NjCJi7uCB_EKKJ0mNFVu80Y__OG7P_8rFtg,13824
+greenlet/tests/_test_extension_cpp.cp311-win_amd64.pyd,sha256=TXzaiHa7HiEzHpWLHz5PRkZojVfMgFjaH1eTfI1WAis,15872
+greenlet/tests/_test_extension_cpp.cpp,sha256=e0kVnaB8CCaEhE9yHtNyfqTjevsPDKKx-zgxk7PPK48,6565
+greenlet/tests/fail_clearing_run_switches.py,sha256=o433oA_nUCtOPaMEGc8VEhZIKa71imVHXFw7TsXaP8M,1263
+greenlet/tests/fail_cpp_exception.py,sha256=o_ZbipWikok8Bjc-vjiQvcb5FHh2nVW-McGKMLcMzh0,985
+greenlet/tests/fail_initialstub_already_started.py,sha256=txENn5IyzGx2p-XR1XB7qXmC8JX_4mKDEA8kYBXUQKc,1961
+greenlet/tests/fail_slp_switch.py,sha256=rJBZcZfTWR3e2ERQtPAud6YKShiDsP84PmwOJbp4ey0,524
+greenlet/tests/fail_switch_three_greenlets.py,sha256=zSitV7rkNnaoHYVzAGGLnxz-yPtohXJJzaE8ehFDQ0M,956
+greenlet/tests/fail_switch_three_greenlets2.py,sha256=FPJensn2EJxoropl03JSTVP3kgP33k04h6aDWWozrOk,1285
+greenlet/tests/fail_switch_two_greenlets.py,sha256=1CaI8s3504VbbF1vj1uBYuy-zxBHVzHPIAd1LIc8ONg,817
+greenlet/tests/leakcheck.py,sha256=inbfM7_oVzd8jIKGxCgo4JqpFZaDAnWPkSULJ8vIE1s,11964
+greenlet/tests/test_contextvars.py,sha256=0n5pR_lbpAppc5wFfK0e1SwYLM-fsSFp72B5_ArLPGE,10348
+greenlet/tests/test_cpp.py,sha256=hpxhFAdKJTpAVZP8CBGs1ZcrKdscI9BaDZk4btkI5d4,2736
+greenlet/tests/test_extension_interface.py,sha256=eJ3cwLacdK2WbsrC-4DgeyHdwLRcG4zx7rrkRtqSzC4,3829
+greenlet/tests/test_gc.py,sha256=PCOaRpIyjNnNlDogGL3FZU_lrdXuM-pv1rxeE5TP5mc,2923
+greenlet/tests/test_generator.py,sha256=tONXiTf98VGm347o1b-810daPiwdla5cbpFg6QI1R1g,1240
+greenlet/tests/test_generator_nested.py,sha256=7v4HOYrf1XZP39dk5IUMubdZ8yc3ynwZcqj9GUJyMSA,3718
+greenlet/tests/test_greenlet.py,sha256=95qgDR-xtB0jzEFLirNx7HPUdwHikVMvDdyUoCvyjOo,45354
+greenlet/tests/test_greenlet_trash.py,sha256=P6r-3K4fmXX8foW8BVgthuqVKjicHMDvxfK7Al4x028,7508
+greenlet/tests/test_leaks.py,sha256=wskLqCAvqZ3qTZkam_wXzd-E5zelUjlXS5Ss8KshtZY,17465
+greenlet/tests/test_stack_saved.py,sha256=eyzqNY2VCGuGlxhT_In6TvZ6Okb0AXFZVyBEnK1jDwA,446
+greenlet/tests/test_throw.py,sha256=u2TQ_WvvCd6N6JdXWIxVEcXkKu5fepDlz9dktYdmtng,3712
+greenlet/tests/test_tracing.py,sha256=VlwzMU0C1noospZhuUMyB7MHw200emIvGCN_6G2p2ZU,8250
+greenlet/tests/test_version.py,sha256=O9DpAITsOFgiRcjd4odQ7ejmwx_N9Q1zQENVcbtFHIc,1339
+greenlet/tests/test_weakref.py,sha256=F8M23btEF87bIbpptLNBORosbQqNZGiYeKMqYjWrsak,883
diff --git a/llm/Lib/site-packages/greenlet-3.0.3.dist-info/WHEEL b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..d60b00472b6db035b28a0470c4bc8f72f5db2de0
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.42.0)
+Root-Is-Purelib: false
+Tag: cp311-cp311-win_amd64
+
diff --git a/llm/Lib/site-packages/greenlet-3.0.3.dist-info/top_level.txt b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..46725be4fd5ff62893d8def5f9e356d4d096328a
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet-3.0.3.dist-info/top_level.txt
@@ -0,0 +1 @@
+greenlet
diff --git a/llm/Lib/site-packages/greenlet/TBrokenGreenlet.cpp b/llm/Lib/site-packages/greenlet/TBrokenGreenlet.cpp
new file mode 100644
index 0000000000000000000000000000000000000000..11a3beab8b0db3ccbc493505fb41d3180968dd43
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/TBrokenGreenlet.cpp
@@ -0,0 +1,45 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */
+/**
+ * Implementation of greenlet::UserGreenlet.
+ *
+ * Format with:
+ *  clang-format -i --style=file src/greenlet/greenlet.c
+ *
+ *
+ * Fix missing braces with:
+ *   clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements"
+*/
+
+#include "greenlet_greenlet.hpp"
+
+namespace greenlet {
+
+void* BrokenGreenlet::operator new(size_t UNUSED(count))
+{
+    return allocator.allocate(1);
+}
+
+
+void BrokenGreenlet::operator delete(void* ptr)
+{
+    return allocator.deallocate(static_cast<BrokenGreenlet*>(ptr),
+                                1);
+}
+
+greenlet::PythonAllocator<greenlet::BrokenGreenlet> greenlet::BrokenGreenlet::allocator;
+
+bool
+BrokenGreenlet::force_slp_switch_error() const noexcept
+{
+    return this->_force_slp_switch_error;
+}
+
+UserGreenlet::switchstack_result_t BrokenGreenlet::g_switchstack(void)
+{
+  if (this->_force_switch_error) {
+    return switchstack_result_t(-1);
+  }
+  return UserGreenlet::g_switchstack();
+}
+
+}; //namespace greenlet
diff --git a/llm/Lib/site-packages/greenlet/TExceptionState.cpp b/llm/Lib/site-packages/greenlet/TExceptionState.cpp
new file mode 100644
index 0000000000000000000000000000000000000000..ee6b19177ada3e982f1dab8d1ffde9aad1b30e88
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/TExceptionState.cpp
@@ -0,0 +1,62 @@
+#ifndef GREENLET_EXCEPTION_STATE_CPP
+#define GREENLET_EXCEPTION_STATE_CPP
+
+#include <Python.h>
+#include "greenlet_greenlet.hpp"
+
+namespace greenlet {
+
+
+ExceptionState::ExceptionState()
+{
+    this->clear();
+}
+
+void ExceptionState::operator<<(const PyThreadState *const tstate) noexcept
+{
+    this->exc_info = tstate->exc_info;
+    this->exc_state = tstate->exc_state;
+}
+
+void ExceptionState::operator>>(PyThreadState *const tstate) noexcept
+{
+    tstate->exc_state = this->exc_state;
+    tstate->exc_info =
+        this->exc_info ? this->exc_info : &tstate->exc_state;
+    this->clear();
+}
+
+void ExceptionState::clear() noexcept
+{
+    this->exc_info = nullptr;
+    this->exc_state.exc_value = nullptr;
+#if !GREENLET_PY311
+    this->exc_state.exc_type = nullptr;
+    this->exc_state.exc_traceback = nullptr;
+#endif
+    this->exc_state.previous_item = nullptr;
+}
+
+int ExceptionState::tp_traverse(visitproc visit, void* arg) noexcept
+{
+    Py_VISIT(this->exc_state.exc_value);
+#if !GREENLET_PY311
+    Py_VISIT(this->exc_state.exc_type);
+    Py_VISIT(this->exc_state.exc_traceback);
+#endif
+    return 0;
+}
+
+void ExceptionState::tp_clear() noexcept
+{
+    Py_CLEAR(this->exc_state.exc_value);
+#if !GREENLET_PY311
+    Py_CLEAR(this->exc_state.exc_type);
+    Py_CLEAR(this->exc_state.exc_traceback);
+#endif
+}
+
+
+}; // namespace greenlet
+
+#endif // GREENLET_EXCEPTION_STATE_CPP
diff --git a/llm/Lib/site-packages/greenlet/TGreenlet.cpp b/llm/Lib/site-packages/greenlet/TGreenlet.cpp
new file mode 100644
index 0000000000000000000000000000000000000000..51f899505b9bc76733ec4e55ab650134fa6d3b83
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/TGreenlet.cpp
@@ -0,0 +1,714 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */
+/**
+ * Implementation of greenlet::Greenlet.
+ *
+ * Format with:
+ *  clang-format -i --style=file src/greenlet/greenlet.c
+ *
+ *
+ * Fix missing braces with:
+ *   clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements"
+*/
+
+#include "greenlet_internal.hpp"
+#include "greenlet_greenlet.hpp"
+#include "greenlet_thread_state.hpp"
+
+#include "TGreenletGlobals.cpp"
+#include "TThreadStateDestroy.cpp"
+
+namespace greenlet {
+
+Greenlet::Greenlet(PyGreenlet* p)
+{
+    p ->pimpl = this;
+}
+
+Greenlet::~Greenlet()
+{
+    // XXX: Can't do this. tp_clear is a virtual function, and by the
+    // time we're here, we've sliced off our child classes.
+    //this->tp_clear();
+}
+
+Greenlet::Greenlet(PyGreenlet* p, const StackState& initial_stack)
+    : stack_state(initial_stack)
+{
+    // can't use a delegating constructor because of
+    // MSVC for Python 2.7
+    p->pimpl = this;
+}
+
+bool
+Greenlet::force_slp_switch_error() const noexcept
+{
+    return false;
+}
+
+void
+Greenlet::release_args()
+{
+    this->switch_args.CLEAR();
+}
+
+/**
+ * CAUTION: This will allocate memory and may trigger garbage
+ * collection and arbitrary Python code.
+ */
+OwnedObject
+Greenlet::throw_GreenletExit_during_dealloc(const ThreadState& UNUSED(current_thread_state))
+{
+    // If we're killed because we lost all references in the
+    // middle of a switch, that's ok. Don't reset the args/kwargs,
+    // we still want to pass them to the parent.
+    PyErr_SetString(mod_globs->PyExc_GreenletExit,
+                    "Killing the greenlet because all references have vanished.");
+    // To get here it had to have run before
+    return this->g_switch();
+}
+
+inline void
+Greenlet::slp_restore_state() noexcept
+{
+#ifdef SLP_BEFORE_RESTORE_STATE
+    SLP_BEFORE_RESTORE_STATE();
+#endif
+    this->stack_state.copy_heap_to_stack(
+           this->thread_state()->borrow_current()->stack_state);
+}
+
+
+inline int
+Greenlet::slp_save_state(char *const stackref) noexcept
+{
+    // XXX: This used to happen in the middle, before saving, but
+    // after finding the next owner. Does that matter? This is
+    // only defined for Sparc/GCC where it flushes register
+    // windows to the stack (I think)
+#ifdef SLP_BEFORE_SAVE_STATE
+    SLP_BEFORE_SAVE_STATE();
+#endif
+    return this->stack_state.copy_stack_to_heap(stackref,
+                                                this->thread_state()->borrow_current()->stack_state);
+}
+
+/**
+ * CAUTION: This will allocate memory and may trigger garbage
+ * collection and arbitrary Python code.
+ */
+OwnedObject
+Greenlet::on_switchstack_or_initialstub_failure(
+    Greenlet* target,
+    const Greenlet::switchstack_result_t& err,
+    const bool target_was_me,
+    const bool was_initial_stub)
+{
+    // If we get here, either g_initialstub()
+    // failed, or g_switchstack() failed. Either one of those
+    // cases SHOULD leave us in the original greenlet with a valid stack.
+    if (!PyErr_Occurred()) {
+        PyErr_SetString(
+            PyExc_SystemError,
+            was_initial_stub
+            ? "Failed to switch stacks into a greenlet for the first time."
+            : "Failed to switch stacks into a running greenlet.");
+    }
+    this->release_args();
+
+    if (target && !target_was_me) {
+        target->murder_in_place();
+    }
+
+    assert(!err.the_new_current_greenlet);
+    assert(!err.origin_greenlet);
+    return OwnedObject();
+
+}
+
+OwnedGreenlet
+Greenlet::g_switchstack_success() noexcept
+{
+    PyThreadState* tstate = PyThreadState_GET();
+    // restore the saved state
+    this->python_state >> tstate;
+    this->exception_state >> tstate;
+
+    // The thread state hasn't been changed yet.
+    ThreadState* thread_state = this->thread_state();
+    OwnedGreenlet result(thread_state->get_current());
+    thread_state->set_current(this->self());
+    //assert(thread_state->borrow_current().borrow() == this->_self);
+    return result;
+}
+
+Greenlet::switchstack_result_t
+Greenlet::g_switchstack(void)
+{
+    // if any of these assertions fail, it's likely because we
+    // switched away and tried to switch back to us. Early stages of
+    // switching are not reentrant because we re-use ``this->args()``.
+    // Switching away would happen if we trigger a garbage collection
+    // (by just using some Python APIs that happen to allocate Python
+    // objects) and some garbage had weakref callbacks or __del__ that
+    // switches (people don't write code like that by hand, but with
+    // gevent it's possible without realizing it)
+    assert(this->args() || PyErr_Occurred());
+    { /* save state */
+        if (this->thread_state()->is_current(this->self())) {
+            // Hmm, nothing to do.
+            // TODO: Does this bypass trace events that are
+            // important?
+            return switchstack_result_t(0,
+                                        this, this->thread_state()->borrow_current());
+        }
+        BorrowedGreenlet current = this->thread_state()->borrow_current();
+        PyThreadState* tstate = PyThreadState_GET();
+
+        current->python_state << tstate;
+        current->exception_state << tstate;
+        this->python_state.will_switch_from(tstate);
+        switching_thread_state = this;
+        current->expose_frames();
+    }
+    assert(this->args() || PyErr_Occurred());
+    // If this is the first switch into a greenlet, this will
+    // return twice, once with 1 in the new greenlet, once with 0
+    // in the origin.
+    int err;
+    if (this->force_slp_switch_error()) {
+        err = -1;
+    }
+    else {
+        err = slp_switch();
+    }
+
+    if (err < 0) { /* error */
+        // Tested by
+        // test_greenlet.TestBrokenGreenlets.test_failed_to_slp_switch_into_running
+        //
+        // It's not clear if it's worth trying to clean up and
+        // continue here. Failing to switch stacks is a big deal which
+        // may not be recoverable (who knows what state the stack is in).
+        // Also, we've stolen references in preparation for calling
+        // ``g_switchstack_success()`` and we don't have a clean
+        // mechanism for backing that all out.
+        Py_FatalError("greenlet: Failed low-level slp_switch(). The stack is probably corrupt.");
+    }
+
+    // No stack-based variables are valid anymore.
+
+    // But the global is volatile so we can reload it without the
+    // compiler caching it from earlier.
+    Greenlet* greenlet_that_switched_in = switching_thread_state; // aka this
+    switching_thread_state = nullptr;
+    // except that no stack variables are valid, we would:
+    // assert(this == greenlet_that_switched_in);
+
+    // switchstack success is where we restore the exception state,
+    // etc. It returns the origin greenlet because its convenient.
+
+    OwnedGreenlet origin = greenlet_that_switched_in->g_switchstack_success();
+    assert(greenlet_that_switched_in->args() || PyErr_Occurred());
+    return switchstack_result_t(err, greenlet_that_switched_in, origin);
+}
+
+
+inline void
+Greenlet::check_switch_allowed() const
+{
+    // TODO: Make this take a parameter of the current greenlet,
+    // or current main greenlet, to make the check for
+    // cross-thread switching cheaper. Surely somewhere up the
+    // call stack we've already accessed the thread local variable.
+
+    // We expect to always have a main greenlet now; accessing the thread state
+    // created it. However, if we get here and cleanup has already
+    // begun because we're a greenlet that was running in a
+    // (now dead) thread, these invariants will not hold true. In
+    // fact, accessing `this->thread_state` may not even be possible.
+
+    // If the thread this greenlet was running in is dead,
+    // we'll still have a reference to a main greenlet, but the
+    // thread state pointer we have is bogus.
+    // TODO: Give the objects an API to determine if they belong
+    // to a dead thread.
+
+    const BorrowedMainGreenlet main_greenlet = this->find_main_greenlet_in_lineage();
+
+    if (!main_greenlet) {
+        throw PyErrOccurred(mod_globs->PyExc_GreenletError,
+                            "cannot switch to a garbage collected greenlet");
+    }
+
+    if (!main_greenlet->thread_state()) {
+        throw PyErrOccurred(mod_globs->PyExc_GreenletError,
+                            "cannot switch to a different thread (which happens to have exited)");
+    }
+
+    // The main greenlet we found was from the .parent lineage.
+    // That may or may not have any relationship to the main
+    // greenlet of the running thread. We can't actually access
+    // our this->thread_state members to try to check that,
+    // because it could be in the process of getting destroyed,
+    // but setting the main_greenlet->thread_state member to NULL
+    // may not be visible yet. So we need to check against the
+    // current thread state (once the cheaper checks are out of
+    // the way)
+    const BorrowedMainGreenlet current_main_greenlet = GET_THREAD_STATE().state().borrow_main_greenlet();
+    if (
+        // lineage main greenlet is not this thread's greenlet
+        current_main_greenlet != main_greenlet
+        || (
+            // atteched to some thread
+            this->main_greenlet()
+            // XXX: Same condition as above. Was this supposed to be
+            // this->main_greenlet()?
+            && current_main_greenlet != main_greenlet)
+        // switching into a known dead thread (XXX: which, if we get here,
+        // is bad, because we just accessed the thread state, which is
+        // gone!)
+        || (!current_main_greenlet->thread_state())) {
+        // CAUTION: This may trigger memory allocations, gc, and
+        // arbitrary Python code.
+        throw PyErrOccurred(mod_globs->PyExc_GreenletError,
+                            "cannot switch to a different thread");
+    }
+}
+
+const OwnedObject
+Greenlet::context() const
+{
+    using greenlet::PythonStateContext;
+    OwnedObject result;
+
+    if (this->is_currently_running_in_some_thread()) {
+        /* Currently running greenlet: context is stored in the thread state,
+           not the greenlet object. */
+        if (GET_THREAD_STATE().state().is_current(this->self())) {
+            result = PythonStateContext::context(PyThreadState_GET());
+        }
+        else {
+            throw ValueError(
+                            "cannot get context of a "
+                            "greenlet that is running in a different thread");
+        }
+    }
+    else {
+        /* Greenlet is not running: just return context. */
+        result = this->python_state.context();
+    }
+    if (!result) {
+        result = OwnedObject::None();
+    }
+    return result;
+}
+
+
+void
+Greenlet::context(BorrowedObject given)
+{
+    using greenlet::PythonStateContext;
+    if (!given) {
+        throw AttributeError("can't delete context attribute");
+    }
+    if (given.is_None()) {
+        /* "Empty context" is stored as NULL, not None. */
+        given = nullptr;
+    }
+
+    //checks type, incrs refcnt
+    greenlet::refs::OwnedContext context(given);
+    PyThreadState* tstate = PyThreadState_GET();
+
+    if (this->is_currently_running_in_some_thread()) {
+        if (!GET_THREAD_STATE().state().is_current(this->self())) {
+            throw ValueError("cannot set context of a greenlet"
+                             " that is running in a different thread");
+        }
+
+        /* Currently running greenlet: context is stored in the thread state,
+           not the greenlet object. */
+        OwnedObject octx = OwnedObject::consuming(PythonStateContext::context(tstate));
+        PythonStateContext::context(tstate, context.relinquish_ownership());
+    }
+    else {
+        /* Greenlet is not running: just set context. Note that the
+           greenlet may be dead.*/
+        this->python_state.context() = context;
+    }
+}
+
+/**
+ * CAUTION: May invoke arbitrary Python code.
+ *
+ * Figure out what the result of ``greenlet.switch(arg, kwargs)``
+ * should be and transfers ownership of it to the left-hand-side.
+ *
+ * If switch() was just passed an arg tuple, then we'll just return that.
+ * If only keyword arguments were passed, then we'll pass the keyword
+ * argument dict. Otherwise, we'll create a tuple of (args, kwargs) and
+ * return both.
+ *
+ * CAUTION: This may allocate a new tuple object, which may
+ * cause the Python garbage collector to run, which in turn may
+ * run arbitrary Python code that switches.
+ */
+OwnedObject& operator<<=(OwnedObject& lhs, greenlet::SwitchingArgs& rhs) noexcept
+{
+    // Because this may invoke arbitrary Python code, which could
+    // result in switching back to us, we need to get the
+    // arguments locally on the stack.
+    assert(rhs);
+    OwnedObject args = rhs.args();
+    OwnedObject kwargs = rhs.kwargs();
+    rhs.CLEAR();
+    // We shouldn't be called twice for the same switch.
+    assert(args || kwargs);
+    assert(!rhs);
+
+    if (!kwargs) {
+        lhs = args;
+    }
+    else if (!PyDict_Size(kwargs.borrow())) {
+        lhs = args;
+    }
+    else if (!PySequence_Length(args.borrow())) {
+        lhs = kwargs;
+    }
+    else {
+        // PyTuple_Pack allocates memory, may GC, may run arbitrary
+        // Python code.
+        lhs = OwnedObject::consuming(PyTuple_Pack(2, args.borrow(), kwargs.borrow()));
+    }
+    return lhs;
+}
+
+static OwnedObject
+g_handle_exit(const OwnedObject& greenlet_result)
+{
+    if (!greenlet_result && mod_globs->PyExc_GreenletExit.PyExceptionMatches()) {
+        /* catch and ignore GreenletExit */
+        PyErrFetchParam val;
+        PyErr_Fetch(PyErrFetchParam(), val, PyErrFetchParam());
+        if (!val) {
+            return OwnedObject::None();
+        }
+        return OwnedObject(val);
+    }
+
+    if (greenlet_result) {
+        // package the result into a 1-tuple
+        // PyTuple_Pack increments the reference of its arguments,
+        // so we always need to decref the greenlet result;
+        // the owner will do that.
+        return OwnedObject::consuming(PyTuple_Pack(1, greenlet_result.borrow()));
+    }
+
+    return OwnedObject();
+}
+
+
+
+/**
+ * May run arbitrary Python code.
+ */
+OwnedObject
+Greenlet::g_switch_finish(const switchstack_result_t& err)
+{
+    assert(err.the_new_current_greenlet == this);
+
+    ThreadState& state = *this->thread_state();
+    // Because calling the trace function could do arbitrary things,
+    // including switching away from this greenlet and then maybe
+    // switching back, we need to capture the arguments now so that
+    // they don't change.
+    OwnedObject result;
+    if (this->args()) {
+        result <<= this->args();
+    }
+    else {
+        assert(PyErr_Occurred());
+    }
+    assert(!this->args());
+    try {
+        // Our only caller handles the bad error case
+        assert(err.status >= 0);
+        assert(state.borrow_current() == this->self());
+        if (OwnedObject tracefunc = state.get_tracefunc()) {
+            assert(result || PyErr_Occurred());
+            g_calltrace(tracefunc,
+                        result ? mod_globs->event_switch : mod_globs->event_throw,
+                        err.origin_greenlet,
+                        this->self());
+        }
+        // The above could have invoked arbitrary Python code, but
+        // it couldn't switch back to this object and *also*
+        // throw an exception, so the args won't have changed.
+
+        if (PyErr_Occurred()) {
+            // We get here if we fell of the end of the run() function
+            // raising an exception. The switch itself was
+            // successful, but the function raised.
+            // valgrind reports that memory allocated here can still
+            // be reached after a test run.
+            throw PyErrOccurred::from_current();
+        }
+        return result;
+    }
+    catch (const PyErrOccurred&) {
+        /* Turn switch errors into switch throws */
+        /* Turn trace errors into switch throws */
+        this->release_args();
+        throw;
+    }
+}
+
+void
+Greenlet::g_calltrace(const OwnedObject& tracefunc,
+                      const greenlet::refs::ImmortalEventName& event,
+                      const BorrowedGreenlet& origin,
+                      const BorrowedGreenlet& target)
+{
+    PyErrPieces saved_exc;
+    try {
+        TracingGuard tracing_guard;
+        // TODO: We have saved the active exception (if any) that's
+        // about to be raised. In the 'throw' case, we could provide
+        // the exception to the tracefunction, which seems very helpful.
+        tracing_guard.CallTraceFunction(tracefunc, event, origin, target);
+    }
+    catch (const PyErrOccurred&) {
+        // In case of exceptions trace function is removed,
+        // and any existing exception is replaced with the tracing
+        // exception.
+        GET_THREAD_STATE().state().set_tracefunc(Py_None);
+        throw;
+    }
+
+    saved_exc.PyErrRestore();
+    assert(
+        (event == mod_globs->event_throw && PyErr_Occurred())
+        || (event == mod_globs->event_switch && !PyErr_Occurred())
+    );
+}
+
+void
+Greenlet::murder_in_place()
+{
+    if (this->active()) {
+        assert(!this->is_currently_running_in_some_thread());
+        this->deactivate_and_free();
+    }
+}
+
+inline void
+Greenlet::deactivate_and_free()
+{
+    if (!this->active()) {
+        return;
+    }
+    // Throw away any saved stack.
+    this->stack_state = StackState();
+    assert(!this->stack_state.active());
+    // Throw away any Python references.
+    // We're holding a borrowed reference to the last
+    // frame we executed. Since we borrowed it, the
+    // normal traversal, clear, and dealloc functions
+    // ignore it, meaning it leaks. (The thread state
+    // object can't find it to clear it when that's
+    // deallocated either, because by definition if we
+    // got an object on this list, it wasn't
+    // running and the thread state doesn't have
+    // this frame.)
+    // So here, we *do* clear it.
+    this->python_state.tp_clear(true);
+}
+
+bool
+Greenlet::belongs_to_thread(const ThreadState* thread_state) const
+{
+    if (!this->thread_state() // not running anywhere, or thread
+                              // exited
+        || !thread_state) { // same, or there is no thread state.
+        return false;
+    }
+    return true;
+}
+
+
+void
+Greenlet::deallocing_greenlet_in_thread(const ThreadState* current_thread_state)
+{
+    /* Cannot raise an exception to kill the greenlet if
+       it is not running in the same thread! */
+    if (this->belongs_to_thread(current_thread_state)) {
+        assert(current_thread_state);
+        // To get here it had to have run before
+        /* Send the greenlet a GreenletExit exception. */
+
+        // We don't care about the return value, only whether an
+        // exception happened.
+        this->throw_GreenletExit_during_dealloc(*current_thread_state);
+        return;
+    }
+
+    // Not the same thread! Temporarily save the greenlet
+    // into its thread's deleteme list, *if* it exists.
+    // If that thread has already exited, and processed its pending
+    // cleanup, we'll never be able to clean everything up: we won't
+    // be able to raise an exception.
+    // That's mostly OK! Since we can't add it to a list, our refcount
+    // won't increase, and we'll go ahead with the DECREFs later.
+    ThreadState *const  thread_state = this->thread_state();
+    if (thread_state) {
+        thread_state->delete_when_thread_running(this->self());
+    }
+    else {
+        // The thread is dead, we can't raise an exception.
+        // We need to make it look non-active, though, so that dealloc
+        // finishes killing it.
+        this->deactivate_and_free();
+    }
+    return;
+}
+
+
+int
+Greenlet::tp_traverse(visitproc visit, void* arg)
+{
+
+    int result;
+    if ((result = this->exception_state.tp_traverse(visit, arg)) != 0) {
+        return result;
+    }
+    //XXX: This is ugly. But so is handling everything having to do
+    //with the top frame.
+    bool visit_top_frame = this->was_running_in_dead_thread();
+    // When true, the thread is dead. Our implicit weak reference to the
+    // frame is now all that's left; we consider ourselves to
+    // strongly own it now.
+    if ((result = this->python_state.tp_traverse(visit, arg, visit_top_frame)) != 0) {
+        return result;
+    }
+    return 0;
+}
+
+int
+Greenlet::tp_clear()
+{
+    bool own_top_frame = this->was_running_in_dead_thread();
+    this->exception_state.tp_clear();
+    this->python_state.tp_clear(own_top_frame);
+    return 0;
+}
+
+bool Greenlet::is_currently_running_in_some_thread() const
+{
+    return this->stack_state.active() && !this->python_state.top_frame();
+}
+
+#if GREENLET_PY312
+void GREENLET_NOINLINE(Greenlet::expose_frames)()
+{
+    if (!this->python_state.top_frame()) {
+        return;
+    }
+
+    _PyInterpreterFrame* last_complete_iframe = nullptr;
+    _PyInterpreterFrame* iframe = this->python_state.top_frame()->f_frame;
+    while (iframe) {
+        // We must make a copy before looking at the iframe contents,
+        // since iframe might point to a portion of the greenlet's C stack
+        // that was spilled when switching greenlets.
+        _PyInterpreterFrame iframe_copy;
+        this->stack_state.copy_from_stack(&iframe_copy, iframe, sizeof(*iframe));
+        if (!_PyFrame_IsIncomplete(&iframe_copy)) {
+            // If the iframe were OWNED_BY_CSTACK then it would always be
+            // incomplete. Since it's not incomplete, it's not on the C stack
+            // and we can access it through the original `iframe` pointer
+            // directly.  This is important since GetFrameObject might
+            // lazily _create_ the frame object and we don't want the
+            // interpreter to lose track of it.
+            assert(iframe_copy.owner != FRAME_OWNED_BY_CSTACK);
+
+            // We really want to just write:
+            //     PyFrameObject* frame = _PyFrame_GetFrameObject(iframe);
+            // but _PyFrame_GetFrameObject calls _PyFrame_MakeAndSetFrameObject
+            // which is not a visible symbol in libpython. The easiest
+            // way to get a public function to call it is using
+            // PyFrame_GetBack, which is defined as follows:
+            //     assert(frame != NULL);
+            //     assert(!_PyFrame_IsIncomplete(frame->f_frame));
+            //     PyFrameObject *back = frame->f_back;
+            //     if (back == NULL) {
+            //         _PyInterpreterFrame *prev = frame->f_frame->previous;
+            //         prev = _PyFrame_GetFirstComplete(prev);
+            //         if (prev) {
+            //             back = _PyFrame_GetFrameObject(prev);
+            //         }
+            //     }
+            //     return (PyFrameObject*)Py_XNewRef(back);
+            if (!iframe->frame_obj) {
+                PyFrameObject dummy_frame;
+                _PyInterpreterFrame dummy_iframe;
+                dummy_frame.f_back = nullptr;
+                dummy_frame.f_frame = &dummy_iframe;
+                // force the iframe to be considered complete without
+                // needing to check its code object:
+                dummy_iframe.owner = FRAME_OWNED_BY_GENERATOR;
+                dummy_iframe.previous = iframe;
+                assert(!_PyFrame_IsIncomplete(&dummy_iframe));
+                // Drop the returned reference immediately; the iframe
+                // continues to hold a strong reference
+                Py_XDECREF(PyFrame_GetBack(&dummy_frame));
+                assert(iframe->frame_obj);
+            }
+
+            // This is a complete frame, so make the last one of those we saw
+            // point at it, bypassing any incomplete frames (which may have
+            // been on the C stack) in between the two. We're overwriting
+            // last_complete_iframe->previous and need that to be reversible,
+            // so we store the original previous ptr in the frame object
+            // (which we must have created on a previous iteration through
+            // this loop). The frame object has a bunch of storage that is
+            // only used when its iframe is OWNED_BY_FRAME_OBJECT, which only
+            // occurs when the frame object outlives the frame's execution,
+            // which can't have happened yet because the frame is currently
+            // executing as far as the interpreter is concerned. So, we can
+            // reuse it for our own purposes.
+            assert(iframe->owner == FRAME_OWNED_BY_THREAD
+                   || iframe->owner == FRAME_OWNED_BY_GENERATOR);
+            if (last_complete_iframe) {
+                assert(last_complete_iframe->frame_obj);
+                memcpy(&last_complete_iframe->frame_obj->_f_frame_data[0],
+                       &last_complete_iframe->previous, sizeof(void *));
+                last_complete_iframe->previous = iframe;
+            }
+            last_complete_iframe = iframe;
+        }
+        // Frames that are OWNED_BY_FRAME_OBJECT are linked via the
+        // frame's f_back while all others are linked via the iframe's
+        // previous ptr. Since all the frames we traverse are running
+        // as far as the interpreter is concerned, we don't have to
+        // worry about the OWNED_BY_FRAME_OBJECT case.
+        iframe = iframe_copy.previous;
+    }
+
+    // Give the outermost complete iframe a null previous pointer to
+    // account for any potential incomplete/C-stack iframes between it
+    // and the actual top-of-stack
+    if (last_complete_iframe) {
+        assert(last_complete_iframe->frame_obj);
+        memcpy(&last_complete_iframe->frame_obj->_f_frame_data[0],
+               &last_complete_iframe->previous, sizeof(void *));
+        last_complete_iframe->previous = nullptr;
+    }
+}
+#else
+void Greenlet::expose_frames()
+{
+
+}
+#endif
+
+}; // namespace greenlet
diff --git a/llm/Lib/site-packages/greenlet/TGreenletGlobals.cpp b/llm/Lib/site-packages/greenlet/TGreenletGlobals.cpp
new file mode 100644
index 0000000000000000000000000000000000000000..c71c963b32385a8c1661add1728f98752a4a6d17
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/TGreenletGlobals.cpp
@@ -0,0 +1,94 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */
+/**
+ * Implementation of GreenletGlobals.
+ *
+ * Format with:
+ *  clang-format -i --style=file src/greenlet/greenlet.c
+ *
+ *
+ * Fix missing braces with:
+ *   clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements"
+*/
+#ifndef T_GREENLET_GLOBALS
+#define T_GREENLET_GLOBALS
+
+#include "greenlet_refs.hpp"
+#include "greenlet_exceptions.hpp"
+#include "greenlet_thread_support.hpp"
+#include "greenlet_thread_state.hpp"
+
+namespace greenlet {
+
+// This encapsulates what were previously module global "constants"
+// established at init time.
+// This is a step towards Python3 style module state that allows
+// reloading.
+//
+// In an earlier iteration of this code, we used placement new to be
+// able to allocate this object statically still, so that references
+// to its members don't incur an extra pointer indirection.
+// But under some scenarios, that could result in crashes at
+// shutdown because apparently the destructor was getting run twice?
+class GreenletGlobals
+{
+
+public:
+    const greenlet::refs::ImmortalEventName event_switch;
+    const greenlet::refs::ImmortalEventName event_throw;
+    const greenlet::refs::ImmortalException PyExc_GreenletError;
+    const greenlet::refs::ImmortalException PyExc_GreenletExit;
+    const greenlet::refs::ImmortalObject empty_tuple;
+    const greenlet::refs::ImmortalObject empty_dict;
+    const greenlet::refs::ImmortalString str_run;
+    Mutex* const thread_states_to_destroy_lock;
+    greenlet::cleanup_queue_t thread_states_to_destroy;
+
+    GreenletGlobals() :
+        event_switch("switch"),
+        event_throw("throw"),
+        PyExc_GreenletError("greenlet.error"),
+        PyExc_GreenletExit("greenlet.GreenletExit", PyExc_BaseException),
+        empty_tuple(Require(PyTuple_New(0))),
+        empty_dict(Require(PyDict_New())),
+        str_run("run"),
+        thread_states_to_destroy_lock(new Mutex())
+    {}
+
+    ~GreenletGlobals()
+    {
+        // This object is (currently) effectively immortal, and not
+        // just because of those placement new tricks; if we try to
+        // deallocate the static object we allocated, and overwrote,
+        // we would be doing so at C++ teardown time, which is after
+        // the final Python GIL is released, and we can't use the API
+        // then.
+        // (The members will still be destructed, but they also don't
+        // do any deallocation.)
+    }
+
+    void queue_to_destroy(ThreadState* ts) const
+    {
+        // we're currently accessed through a static const object,
+        // implicitly marking our members as const, so code can't just
+        // call push_back (or pop_back) without casting away the
+        // const.
+        //
+        // Do that for callers.
+        greenlet::cleanup_queue_t& q = const_cast<greenlet::cleanup_queue_t&>(this->thread_states_to_destroy);
+        q.push_back(ts);
+    }
+
+    ThreadState* take_next_to_destroy() const
+    {
+        greenlet::cleanup_queue_t& q = const_cast<greenlet::cleanup_queue_t&>(this->thread_states_to_destroy);
+        ThreadState* result = q.back();
+        q.pop_back();
+        return result;
+    }
+};
+
+}; // namespace greenlet
+
+static const greenlet::GreenletGlobals* mod_globs;
+
+#endif // T_GREENLET_GLOBALS
diff --git a/llm/Lib/site-packages/greenlet/TMainGreenlet.cpp b/llm/Lib/site-packages/greenlet/TMainGreenlet.cpp
new file mode 100644
index 0000000000000000000000000000000000000000..c33aadb3a71c5b1e3af4b12b4ed13bc1af3272a0
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/TMainGreenlet.cpp
@@ -0,0 +1,155 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */
+/**
+ * Implementation of greenlet::MainGreenlet.
+ *
+ * Format with:
+ *  clang-format -i --style=file src/greenlet/greenlet.c
+ *
+ *
+ * Fix missing braces with:
+ *   clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements"
+*/
+
+#include "greenlet_greenlet.hpp"
+#include "greenlet_thread_state.hpp"
+
+
+// Protected by the GIL. Incremented when we create a main greenlet,
+// in a new thread, decremented when it is destroyed.
+static Py_ssize_t G_TOTAL_MAIN_GREENLETS;
+
+namespace greenlet {
+greenlet::PythonAllocator<MainGreenlet> MainGreenlet::allocator;
+
+void* MainGreenlet::operator new(size_t UNUSED(count))
+{
+    return allocator.allocate(1);
+}
+
+
+void MainGreenlet::operator delete(void* ptr)
+{
+    return allocator.deallocate(static_cast<MainGreenlet*>(ptr),
+                                1);
+}
+
+
+MainGreenlet::MainGreenlet(PyGreenlet* p, ThreadState* state)
+    : Greenlet(p, StackState::make_main()),
+      _self(p),
+      _thread_state(state)
+{
+    G_TOTAL_MAIN_GREENLETS++;
+}
+
+MainGreenlet::~MainGreenlet()
+{
+    G_TOTAL_MAIN_GREENLETS--;
+    this->tp_clear();
+}
+
+ThreadState*
+MainGreenlet::thread_state() const noexcept
+{
+    return this->_thread_state;
+}
+
+void
+MainGreenlet::thread_state(ThreadState* t) noexcept
+{
+    assert(!t);
+    this->_thread_state = t;
+}
+
+BorrowedGreenlet
+MainGreenlet::self() const noexcept
+{
+    return BorrowedGreenlet(this->_self.borrow());
+}
+
+
+const BorrowedMainGreenlet
+MainGreenlet::main_greenlet() const
+{
+    return this->_self;
+}
+
+BorrowedMainGreenlet
+MainGreenlet::find_main_greenlet_in_lineage() const
+{
+    return BorrowedMainGreenlet(this->_self);
+}
+
+bool
+MainGreenlet::was_running_in_dead_thread() const noexcept
+{
+    return !this->_thread_state;
+}
+
+OwnedObject
+MainGreenlet::g_switch()
+{
+    try {
+        this->check_switch_allowed();
+    }
+    catch (const PyErrOccurred&) {
+        this->release_args();
+        throw;
+    }
+
+    switchstack_result_t err = this->g_switchstack();
+    if (err.status < 0) {
+        // XXX: This code path is untested, but it is shared
+        // with the UserGreenlet path that is tested.
+        return this->on_switchstack_or_initialstub_failure(
+            this,
+            err,
+            true, // target was me
+            false // was initial stub
+        );
+    }
+
+    return err.the_new_current_greenlet->g_switch_finish(err);
+}
+
+int
+MainGreenlet::tp_traverse(visitproc visit, void* arg)
+{
+    if (this->_thread_state) {
+        // we've already traversed main, (self), don't do it again.
+        int result = this->_thread_state->tp_traverse(visit, arg, false);
+        if (result) {
+            return result;
+        }
+    }
+    return Greenlet::tp_traverse(visit, arg);
+}
+
+const OwnedObject&
+MainGreenlet::run() const
+{
+    throw AttributeError("Main greenlets do not have a run attribute.");
+}
+
+void
+MainGreenlet::run(const BorrowedObject UNUSED(nrun))
+{
+   throw AttributeError("Main greenlets do not have a run attribute.");
+}
+
+void
+MainGreenlet::parent(const BorrowedObject raw_new_parent)
+{
+    if (!raw_new_parent) {
+        throw AttributeError("can't delete attribute");
+    }
+    throw AttributeError("cannot set the parent of a main greenlet");
+}
+
+const OwnedGreenlet
+MainGreenlet::parent() const
+{
+    return OwnedGreenlet(); // null becomes None
+}
+
+}; // namespace greenlet
diff --git a/llm/Lib/site-packages/greenlet/TPythonState.cpp b/llm/Lib/site-packages/greenlet/TPythonState.cpp
new file mode 100644
index 0000000000000000000000000000000000000000..465d41740d71adab2a596fd109bfbbf432cedcab
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/TPythonState.cpp
@@ -0,0 +1,375 @@
+#ifndef GREENLET_PYTHON_STATE_CPP
+#define GREENLET_PYTHON_STATE_CPP
+
+#include <Python.h>
+#include "greenlet_greenlet.hpp"
+
+namespace greenlet {
+
+PythonState::PythonState()
+    : _top_frame()
+#if GREENLET_USE_CFRAME
+    ,cframe(nullptr)
+    ,use_tracing(0)
+#endif
+#if GREENLET_PY312
+    ,py_recursion_depth(0)
+    ,c_recursion_depth(0)
+#else
+    ,recursion_depth(0)
+#endif
+    ,trash_delete_nesting(0)
+#if GREENLET_PY311
+    ,current_frame(nullptr)
+    ,datastack_chunk(nullptr)
+    ,datastack_top(nullptr)
+    ,datastack_limit(nullptr)
+#endif
+{
+#if GREENLET_USE_CFRAME
+    /*
+      The PyThreadState->cframe pointer usually points to memory on
+      the stack, alloceted in a call into PyEval_EvalFrameDefault.
+
+      Initially, before any evaluation begins, it points to the
+      initial PyThreadState object's ``root_cframe`` object, which is
+      statically allocated for the lifetime of the thread.
+
+      A greenlet can last for longer than a call to
+      PyEval_EvalFrameDefault, so we can't set its ``cframe`` pointer
+      to be the current ``PyThreadState->cframe``; nor could we use
+      one from the greenlet parent for the same reason. Yet a further
+      no: we can't allocate one scoped to the greenlet and then
+      destroy it when the greenlet is deallocated, because inside the
+      interpreter the _PyCFrame objects form a linked list, and that too
+      can result in accessing memory beyond its dynamic lifetime (if
+      the greenlet doesn't actually finish before it dies, its entry
+      could still be in the list).
+
+      Using the ``root_cframe`` is problematic, though, because its
+      members are never modified by the interpreter and are set to 0,
+      meaning that its ``use_tracing`` flag is never updated. We don't
+      want to modify that value in the ``root_cframe`` ourself: it
+      *shouldn't* matter much because we should probably never get
+      back to the point where that's the only cframe on the stack;
+      even if it did matter, the major consequence of an incorrect
+      value for ``use_tracing`` is that if its true the interpreter
+      does some extra work --- however, it's just good code hygiene.
+
+      Our solution: before a greenlet runs, after its initial
+      creation, it uses the ``root_cframe`` just to have something to
+      put there. However, once the greenlet is actually switched to
+      for the first time, ``g_initialstub`` (which doesn't actually
+      "return" while the greenlet is running) stores a new _PyCFrame on
+      its local stack, and copies the appropriate values from the
+      currently running _PyCFrame; this is then made the _PyCFrame for the
+      newly-minted greenlet. ``g_initialstub`` then proceeds to call
+      ``glet.run()``, which results in ``PyEval_...`` adding the
+      _PyCFrame to the list. Switches continue as normal. Finally, when
+      the greenlet finishes, the call to ``glet.run()`` returns and
+      the _PyCFrame is taken out of the linked list and the stack value
+      is now unused and free to expire.
+
+      XXX: I think we can do better. If we're deallocing in the same
+      thread, can't we traverse the list and unlink our frame?
+      Can we just keep a reference to the thread state in case we
+      dealloc in another thread? (Is that even possible if we're still
+      running and haven't returned from g_initialstub?)
+    */
+    this->cframe = &PyThreadState_GET()->root_cframe;
+#endif
+}
+
+
+inline void PythonState::may_switch_away() noexcept
+{
+#if GREENLET_PY311
+    // PyThreadState_GetFrame is probably going to have to allocate a
+    // new frame object. That may trigger garbage collection. Because
+    // we call this during the early phases of a switch (it doesn't
+    // matter to which greenlet, as this has a global effect), if a GC
+    // triggers a switch away, two things can happen, both bad:
+    // - We might not get switched back to, halting forward progress.
+    //   this is pathological, but possible.
+    // - We might get switched back to with a different set of
+    //   arguments or a throw instead of a switch. That would corrupt
+    //   our state (specifically, PyErr_Occurred() and this->args()
+    //   would no longer agree).
+    //
+    // Thus, when we call this API, we need to have GC disabled.
+    // This method serves as a bottleneck we call when maybe beginning
+    // a switch. In this way, it is always safe -- no risk of GC -- to
+    // use ``_GetFrame()`` whenever we need to, just as it was in
+    // <=3.10 (because subsequent calls will be cached and not
+    // allocate memory).
+
+    GCDisabledGuard no_gc;
+    Py_XDECREF(PyThreadState_GetFrame(PyThreadState_GET()));
+#endif
+}
+
+void PythonState::operator<<(const PyThreadState *const tstate) noexcept
+{
+    this->_context.steal(tstate->context);
+#if GREENLET_USE_CFRAME
+    /*
+      IMPORTANT: ``cframe`` is a pointer into the STACK. Thus, because
+      the call to ``slp_switch()`` changes the contents of the stack,
+      you cannot read from ``ts_current->cframe`` after that call and
+      necessarily get the same values you get from reading it here.
+      Anything you need to restore from now to then must be saved in a
+      global/threadlocal variable (because we can't use stack
+      variables here either). For things that need to persist across
+      the switch, use `will_switch_from`.
+    */
+    this->cframe = tstate->cframe;
+  #if !GREENLET_PY312
+    this->use_tracing = tstate->cframe->use_tracing;
+  #endif
+#endif // GREENLET_USE_CFRAME
+#if GREENLET_PY311
+  #if GREENLET_PY312
+    this->py_recursion_depth = tstate->py_recursion_limit - tstate->py_recursion_remaining;
+    this->c_recursion_depth = C_RECURSION_LIMIT - tstate->c_recursion_remaining;
+  #else // not 312
+    this->recursion_depth = tstate->recursion_limit - tstate->recursion_remaining;
+  #endif // GREENLET_PY312
+    this->current_frame = tstate->cframe->current_frame;
+    this->datastack_chunk = tstate->datastack_chunk;
+    this->datastack_top = tstate->datastack_top;
+    this->datastack_limit = tstate->datastack_limit;
+
+    PyFrameObject *frame = PyThreadState_GetFrame((PyThreadState *)tstate);
+    Py_XDECREF(frame);  // PyThreadState_GetFrame gives us a new
+                        // reference.
+    this->_top_frame.steal(frame);
+  #if GREENLET_PY312
+    this->trash_delete_nesting = tstate->trash.delete_nesting;
+  #else // not 312
+    this->trash_delete_nesting = tstate->trash_delete_nesting;
+  #endif // GREENLET_PY312
+#else // Not 311
+    this->recursion_depth = tstate->recursion_depth;
+    this->_top_frame.steal(tstate->frame);
+    this->trash_delete_nesting = tstate->trash_delete_nesting;
+#endif // GREENLET_PY311
+}
+
+#if GREENLET_PY312
+void GREENLET_NOINLINE(PythonState::unexpose_frames)()
+{
+    if (!this->top_frame()) {
+        return;
+    }
+
+    // See GreenletState::expose_frames() and the comment on frames_were_exposed
+    // for more information about this logic.
+    _PyInterpreterFrame *iframe = this->_top_frame->f_frame;
+    while (iframe != nullptr) {
+        _PyInterpreterFrame *prev_exposed = iframe->previous;
+        assert(iframe->frame_obj);
+        memcpy(&iframe->previous, &iframe->frame_obj->_f_frame_data[0],
+               sizeof(void *));
+        iframe = prev_exposed;
+    }
+}
+#else
+void PythonState::unexpose_frames()
+{}
+#endif
+
+void PythonState::operator>>(PyThreadState *const tstate) noexcept
+{
+    tstate->context = this->_context.relinquish_ownership();
+    /* Incrementing this value invalidates the contextvars cache,
+       which would otherwise remain valid across switches */
+    tstate->context_ver++;
+#if GREENLET_USE_CFRAME
+    tstate->cframe = this->cframe;
+    /*
+      If we were tracing, we need to keep tracing.
+      There should never be the possibility of hitting the
+      root_cframe here. See note above about why we can't
+      just copy this from ``origin->cframe->use_tracing``.
+    */
+  #if !GREENLET_PY312
+    tstate->cframe->use_tracing = this->use_tracing;
+  #endif
+#endif // GREENLET_USE_CFRAME
+#if GREENLET_PY311
+  #if GREENLET_PY312
+    tstate->py_recursion_remaining = tstate->py_recursion_limit - this->py_recursion_depth;
+    tstate->c_recursion_remaining = C_RECURSION_LIMIT - this->c_recursion_depth;
+    this->unexpose_frames();
+  #else // \/ 3.11
+    tstate->recursion_remaining = tstate->recursion_limit - this->recursion_depth;
+  #endif // GREENLET_PY312
+    tstate->cframe->current_frame = this->current_frame;
+    tstate->datastack_chunk = this->datastack_chunk;
+    tstate->datastack_top = this->datastack_top;
+    tstate->datastack_limit = this->datastack_limit;
+    this->_top_frame.relinquish_ownership();
+  #if GREENLET_PY312
+    tstate->trash.delete_nesting = this->trash_delete_nesting;
+  #else // not 3.12
+    tstate->trash_delete_nesting = this->trash_delete_nesting;
+  #endif // GREENLET_PY312
+#else // not 3.11
+    tstate->frame = this->_top_frame.relinquish_ownership();
+    tstate->recursion_depth = this->recursion_depth;
+    tstate->trash_delete_nesting = this->trash_delete_nesting;
+#endif // GREENLET_PY311
+}
+
+inline void PythonState::will_switch_from(PyThreadState *const origin_tstate) noexcept
+{
+#if GREENLET_USE_CFRAME && !GREENLET_PY312
+    // The weird thing is, we don't actually save this for an
+    // effect on the current greenlet, it's saved for an
+    // effect on the target greenlet. That is, we want
+    // continuity of this setting across the greenlet switch.
+    this->use_tracing = origin_tstate->cframe->use_tracing;
+#endif
+}
+
+void PythonState::set_initial_state(const PyThreadState* const tstate) noexcept
+{
+    this->_top_frame = nullptr;
+#if GREENLET_PY312
+    this->py_recursion_depth = tstate->py_recursion_limit - tstate->py_recursion_remaining;
+    // XXX: TODO: Comment from a reviewer:
+    //     Should this be ``C_RECURSION_LIMIT - tstate->c_recursion_remaining``?
+    // But to me it looks more like that might not be the right
+    // initialization either?
+    this->c_recursion_depth = tstate->py_recursion_limit - tstate->py_recursion_remaining;
+#elif GREENLET_PY311
+    this->recursion_depth = tstate->recursion_limit - tstate->recursion_remaining;
+#else
+    this->recursion_depth = tstate->recursion_depth;
+#endif
+}
+// TODO: Better state management about when we own the top frame.
+int PythonState::tp_traverse(visitproc visit, void* arg, bool own_top_frame) noexcept
+{
+    Py_VISIT(this->_context.borrow());
+    if (own_top_frame) {
+        Py_VISIT(this->_top_frame.borrow());
+    }
+    return 0;
+}
+
+void PythonState::tp_clear(bool own_top_frame) noexcept
+{
+    PythonStateContext::tp_clear();
+    // If we get here owning a frame,
+    // we got dealloc'd without being finished. We may or may not be
+    // in the same thread.
+    if (own_top_frame) {
+        this->_top_frame.CLEAR();
+    }
+}
+
+#if GREENLET_USE_CFRAME
+void PythonState::set_new_cframe(_PyCFrame& frame) noexcept
+{
+    frame = *PyThreadState_GET()->cframe;
+    /* Make the target greenlet refer to the stack value. */
+    this->cframe = &frame;
+    /*
+      And restore the link to the previous frame so this one gets
+      unliked appropriately.
+    */
+    this->cframe->previous = &PyThreadState_GET()->root_cframe;
+}
+#endif
+
+const PythonState::OwnedFrame& PythonState::top_frame() const noexcept
+{
+    return this->_top_frame;
+}
+
+void PythonState::did_finish(PyThreadState* tstate) noexcept
+{
+#if GREENLET_PY311
+    // See https://github.com/gevent/gevent/issues/1924 and
+    // https://github.com/python-greenlet/greenlet/issues/328. In
+    // short, Python 3.11 allocates memory for frames as a sort of
+    // linked list that's kept as part of PyThreadState in the
+    // ``datastack_chunk`` member and friends. These are saved and
+    // restored as part of switching greenlets.
+    //
+    // When we initially switch to a greenlet, we set those to NULL.
+    // That causes the frame management code to treat this like a
+    // brand new thread and start a fresh list of chunks, beginning
+    // with a new "root" chunk. As we make calls in this greenlet,
+    // those chunks get added, and as calls return, they get popped.
+    // But the frame code (pystate.c) is careful to make sure that the
+    // root chunk never gets popped.
+    //
+    // Thus, when a greenlet exits for the last time, there will be at
+    // least a single root chunk that we must be responsible for
+    // deallocating.
+    //
+    // The complex part is that these chunks are allocated and freed
+    // using ``_PyObject_VirtualAlloc``/``Free``. Those aren't public
+    // functions, and they aren't exported for linking. It so happens
+    // that we know they are just thin wrappers around the Arena
+    // allocator, so we can use that directly to deallocate in a
+    // compatible way.
+    //
+    // CAUTION: Check this implementation detail on every major version.
+    //
+    // It might be nice to be able to do this in our destructor, but
+    // can we be sure that no one else is using that memory? Plus, as
+    // described below, our pointers may not even be valid anymore. As
+    // a special case, there is one time that we know we can do this,
+    // and that's from the destructor of the associated UserGreenlet
+    // (NOT main greenlet)
+    PyObjectArenaAllocator alloc;
+    _PyStackChunk* chunk = nullptr;
+    if (tstate) {
+        // We really did finish, we can never be switched to again.
+        chunk = tstate->datastack_chunk;
+        // Unfortunately, we can't do much sanity checking. Our
+        // this->datastack_chunk pointer is out of date (evaluation may
+        // have popped down through it already) so we can't verify that
+        // we deallocate it. I don't think we can even check datastack_top
+        // for the same reason.
+
+        PyObject_GetArenaAllocator(&alloc);
+        tstate->datastack_chunk = nullptr;
+        tstate->datastack_limit = nullptr;
+        tstate->datastack_top = nullptr;
+
+    }
+    else if (this->datastack_chunk) {
+        // The UserGreenlet (NOT the main greenlet!) is being deallocated. If we're
+        // still holding a stack chunk, it's garbage because we know
+        // we can never switch back to let cPython clean it up.
+        // Because the last time we got switched away from, and we
+        // haven't run since then, we know our chain is valid and can
+        // be dealloced.
+        chunk = this->datastack_chunk;
+        PyObject_GetArenaAllocator(&alloc);
+    }
+
+    if (alloc.free && chunk) {
+        // In case the arena mechanism has been torn down already.
+        while (chunk) {
+            _PyStackChunk *prev = chunk->previous;
+            chunk->previous = nullptr;
+            alloc.free(alloc.ctx, chunk, chunk->size);
+            chunk = prev;
+        }
+    }
+
+    this->datastack_chunk = nullptr;
+    this->datastack_limit = nullptr;
+    this->datastack_top = nullptr;
+#endif
+}
+
+
+}; // namespace greenlet
+
+#endif // GREENLET_PYTHON_STATE_CPP
diff --git a/llm/Lib/site-packages/greenlet/TStackState.cpp b/llm/Lib/site-packages/greenlet/TStackState.cpp
new file mode 100644
index 0000000000000000000000000000000000000000..9aab596fbfa96b5d35e954c91cd3a837edbbfcb4
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/TStackState.cpp
@@ -0,0 +1,265 @@
+#ifndef GREENLET_STACK_STATE_CPP
+#define GREENLET_STACK_STATE_CPP
+
+#include "greenlet_greenlet.hpp"
+
+namespace greenlet {
+
+#ifdef GREENLET_USE_STDIO
+#include <iostream>
+using std::cerr;
+using std::endl;
+
+std::ostream& operator<<(std::ostream& os, const StackState& s)
+{
+    os << "StackState(stack_start=" << (void*)s._stack_start
+       << ", stack_stop=" << (void*)s.stack_stop
+       << ", stack_copy=" << (void*)s.stack_copy
+       << ", stack_saved=" << s._stack_saved
+       << ", stack_prev=" << s.stack_prev
+       << ", addr=" << &s
+       << ")";
+    return os;
+}
+#endif
+
+StackState::StackState(void* mark, StackState& current)
+    : _stack_start(nullptr),
+      stack_stop((char*)mark),
+      stack_copy(nullptr),
+      _stack_saved(0),
+      /* Skip a dying greenlet */
+      stack_prev(current._stack_start
+                 ? &current
+                 : current.stack_prev)
+{
+}
+
+StackState::StackState()
+    : _stack_start(nullptr),
+      stack_stop(nullptr),
+      stack_copy(nullptr),
+      _stack_saved(0),
+      stack_prev(nullptr)
+{
+}
+
+StackState::StackState(const StackState& other)
+// can't use a delegating constructor because of
+// MSVC for Python 2.7
+    : _stack_start(nullptr),
+      stack_stop(nullptr),
+      stack_copy(nullptr),
+      _stack_saved(0),
+      stack_prev(nullptr)
+{
+    this->operator=(other);
+}
+
+StackState& StackState::operator=(const StackState& other)
+{
+    if (&other == this) {
+        return *this;
+    }
+    if (other._stack_saved) {
+        throw std::runtime_error("Refusing to steal memory.");
+    }
+
+    //If we have memory allocated, dispose of it
+    this->free_stack_copy();
+
+    this->_stack_start = other._stack_start;
+    this->stack_stop = other.stack_stop;
+    this->stack_copy = other.stack_copy;
+    this->_stack_saved = other._stack_saved;
+    this->stack_prev = other.stack_prev;
+    return *this;
+}
+
+inline void StackState::free_stack_copy() noexcept
+{
+    PyMem_Free(this->stack_copy);
+    this->stack_copy = nullptr;
+    this->_stack_saved = 0;
+}
+
+inline void StackState::copy_heap_to_stack(const StackState& current) noexcept
+{
+
+    /* Restore the heap copy back into the C stack */
+    if (this->_stack_saved != 0) {
+        memcpy(this->_stack_start, this->stack_copy, this->_stack_saved);
+        this->free_stack_copy();
+    }
+    StackState* owner = const_cast<StackState*>(&current);
+    if (!owner->_stack_start) {
+        owner = owner->stack_prev; /* greenlet is dying, skip it */
+    }
+    while (owner && owner->stack_stop <= this->stack_stop) {
+        // cerr << "\tOwner: " << owner << endl;
+        owner = owner->stack_prev; /* find greenlet with more stack */
+    }
+    this->stack_prev = owner;
+    // cerr << "\tFinished with: " << *this << endl;
+}
+
+inline int StackState::copy_stack_to_heap_up_to(const char* const stop) noexcept
+{
+    /* Save more of g's stack into the heap -- at least up to 'stop'
+       g->stack_stop |________|
+                     |        |
+                     |    __ stop       . . . . .
+                     |        |    ==>  .       .
+                     |________|          _______
+                     |        |         |       |
+                     |        |         |       |
+      g->stack_start |        |         |_______| g->stack_copy
+     */
+    intptr_t sz1 = this->_stack_saved;
+    intptr_t sz2 = stop - this->_stack_start;
+    assert(this->_stack_start);
+    if (sz2 > sz1) {
+        char* c = (char*)PyMem_Realloc(this->stack_copy, sz2);
+        if (!c) {
+            PyErr_NoMemory();
+            return -1;
+        }
+        memcpy(c + sz1, this->_stack_start + sz1, sz2 - sz1);
+        this->stack_copy = c;
+        this->_stack_saved = sz2;
+    }
+    return 0;
+}
+
+inline int StackState::copy_stack_to_heap(char* const stackref,
+                                          const StackState& current) noexcept
+{
+    /* must free all the C stack up to target_stop */
+    const char* const target_stop = this->stack_stop;
+
+    StackState* owner = const_cast<StackState*>(&current);
+    assert(owner->_stack_saved == 0); // everything is present on the stack
+    if (!owner->_stack_start) {
+        owner = owner->stack_prev; /* not saved if dying */
+    }
+    else {
+        owner->_stack_start = stackref;
+    }
+
+    while (owner->stack_stop < target_stop) {
+        /* ts_current is entierely within the area to free */
+        if (owner->copy_stack_to_heap_up_to(owner->stack_stop)) {
+            return -1; /* XXX */
+        }
+        owner = owner->stack_prev;
+    }
+    if (owner != this) {
+        if (owner->copy_stack_to_heap_up_to(target_stop)) {
+            return -1; /* XXX */
+        }
+    }
+    return 0;
+}
+
+inline bool StackState::started() const noexcept
+{
+    return this->stack_stop != nullptr;
+}
+
+inline bool StackState::main() const noexcept
+{
+    return this->stack_stop == (char*)-1;
+}
+
+inline bool StackState::active() const noexcept
+{
+    return this->_stack_start != nullptr;
+}
+
+inline void StackState::set_active() noexcept
+{
+    assert(this->_stack_start == nullptr);
+    this->_stack_start = (char*)1;
+}
+
+inline void StackState::set_inactive() noexcept
+{
+    this->_stack_start = nullptr;
+    // XXX: What if we still have memory out there?
+    // That case is actually triggered by
+    // test_issue251_issue252_explicit_reference_not_collectable (greenlet.tests.test_leaks.TestLeaks)
+    // and
+    // test_issue251_issue252_need_to_collect_in_background
+    // (greenlet.tests.test_leaks.TestLeaks)
+    //
+    // Those objects never get deallocated, so the destructor never
+    // runs.
+    // It *seems* safe to clean up the memory here?
+    if (this->_stack_saved) {
+        this->free_stack_copy();
+    }
+}
+
+inline intptr_t StackState::stack_saved() const noexcept
+{
+    return this->_stack_saved;
+}
+
+inline char* StackState::stack_start() const noexcept
+{
+    return this->_stack_start;
+}
+
+
+inline StackState StackState::make_main() noexcept
+{
+    StackState s;
+    s._stack_start = (char*)1;
+    s.stack_stop = (char*)-1;
+    return s;
+}
+
+StackState::~StackState()
+{
+    if (this->_stack_saved != 0) {
+        this->free_stack_copy();
+    }
+}
+
+void StackState::copy_from_stack(void* vdest, const void* vsrc, size_t n) const
+{
+    char* dest = static_cast<char*>(vdest);
+    const char* src = static_cast<const char*>(vsrc);
+    if (src + n <= this->_stack_start
+        || src >= this->_stack_start + this->_stack_saved
+        || this->_stack_saved == 0) {
+        // Nothing we're copying was spilled from the stack
+        memcpy(dest, src, n);
+        return;
+    }
+
+    if (src < this->_stack_start) {
+        // Copy the part before the saved stack.
+        // We know src + n > _stack_start due to the test above.
+        const size_t nbefore = this->_stack_start - src;
+        memcpy(dest, src, nbefore);
+        dest += nbefore;
+        src += nbefore;
+        n -= nbefore;
+    }
+    // We know src >= _stack_start after the before-copy, and
+    // src < _stack_start + _stack_saved due to the first if condition
+    size_t nspilled = std::min<size_t>(n, this->_stack_start + this->_stack_saved - src);
+    memcpy(dest, this->stack_copy + (src - this->_stack_start), nspilled);
+    dest += nspilled;
+    src += nspilled;
+    n -= nspilled;
+    if (n > 0) {
+        // Copy the part after the saved stack
+        memcpy(dest, src, n);
+    }
+}
+
+}; // namespace greenlet
+
+#endif // GREENLET_STACK_STATE_CPP
diff --git a/llm/Lib/site-packages/greenlet/TThreadStateDestroy.cpp b/llm/Lib/site-packages/greenlet/TThreadStateDestroy.cpp
new file mode 100644
index 0000000000000000000000000000000000000000..a149a1a4eec041c3a0d7e080ccf9ab36bd6ba287
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/TThreadStateDestroy.cpp
@@ -0,0 +1,195 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */
+/**
+ * Implementation of the ThreadState destructors.
+ *
+ * Format with:
+ *  clang-format -i --style=file src/greenlet/greenlet.c
+ *
+ *
+ * Fix missing braces with:
+ *   clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements"
+*/
+#ifndef T_THREADSTATE_DESTROY
+#define T_THREADSTATE_DESTROY
+
+#include "greenlet_greenlet.hpp"
+#include "greenlet_thread_state.hpp"
+#include "greenlet_thread_support.hpp"
+#include "greenlet_cpython_add_pending.hpp"
+#include "TGreenletGlobals.cpp"
+
+namespace greenlet {
+
+struct ThreadState_DestroyWithGIL
+{
+    ThreadState_DestroyWithGIL(ThreadState* state)
+    {
+        if (state && state->has_main_greenlet()) {
+            DestroyWithGIL(state);
+        }
+    }
+
+    static int
+    DestroyWithGIL(ThreadState* state)
+    {
+        // Holding the GIL.
+        // Passed a non-shared pointer to the actual thread state.
+        // state -> main greenlet
+        assert(state->has_main_greenlet());
+        PyGreenlet* main(state->borrow_main_greenlet());
+        // When we need to do cross-thread operations, we check this.
+        // A NULL value means the thread died some time ago.
+        // We do this here, rather than in a Python dealloc function
+        // for the greenlet, in case there's still a reference out
+        // there.
+        static_cast<MainGreenlet*>(main->pimpl)->thread_state(nullptr);
+
+        delete state; // Deleting this runs the destructor, DECREFs the main greenlet.
+        return 0;
+    }
+};
+
+
+
+struct ThreadState_DestroyNoGIL
+{
+    // ensure this is actually defined.
+    static_assert(GREENLET_BROKEN_PY_ADD_PENDING == 1 || GREENLET_BROKEN_PY_ADD_PENDING == 0,
+                  "GREENLET_BROKEN_PY_ADD_PENDING not defined correctly.");
+
+#if GREENLET_BROKEN_PY_ADD_PENDING
+    static int _push_pending_call(struct _pending_calls *pending,
+                                  int (*func)(void *), void *arg)
+    {
+        int i = pending->last;
+        int j = (i + 1) % NPENDINGCALLS;
+        if (j == pending->first) {
+            return -1; /* Queue full */
+        }
+        pending->calls[i].func = func;
+        pending->calls[i].arg = arg;
+        pending->last = j;
+        return 0;
+    }
+
+    static int AddPendingCall(int (*func)(void *), void *arg)
+    {
+        _PyRuntimeState *runtime = &_PyRuntime;
+        if (!runtime) {
+            // obviously impossible
+            return 0;
+        }
+        struct _pending_calls *pending = &runtime->ceval.pending;
+        if (!pending->lock) {
+            return 0;
+        }
+        int result = 0;
+        PyThread_acquire_lock(pending->lock, WAIT_LOCK);
+        if (!pending->finishing) {
+            result = _push_pending_call(pending, func, arg);
+        }
+        PyThread_release_lock(pending->lock);
+        SIGNAL_PENDING_CALLS(&runtime->ceval);
+        return result;
+    }
+#else
+    // Python < 3.8 or >= 3.9
+    static int AddPendingCall(int (*func)(void*), void* arg)
+    {
+        return Py_AddPendingCall(func, arg);
+    }
+#endif
+
+    ThreadState_DestroyNoGIL(ThreadState* state)
+    {
+        // We are *NOT* holding the GIL. Our thread is in the middle
+        // of its death throes and the Python thread state is already
+        // gone so we can't use most Python APIs. One that is safe is
+        // ``Py_AddPendingCall``, unless the interpreter itself has
+        // been torn down. There is a limited number of calls that can
+        // be queued: 32 (NPENDINGCALLS) in CPython 3.10, so we
+        // coalesce these calls using our own queue.
+        if (state && state->has_main_greenlet()) {
+            // mark the thread as dead ASAP.
+            // this is racy! If we try to throw or switch to a
+            // greenlet from this thread from some other thread before
+            // we clear the state pointer, it won't realize the state
+            // is dead which can crash the process.
+            PyGreenlet* p = state->borrow_main_greenlet();
+            assert(p->pimpl->thread_state() == state || p->pimpl->thread_state() == nullptr);
+            static_cast<MainGreenlet*>(p->pimpl)->thread_state(nullptr);
+        }
+
+        // NOTE: Because we're not holding the GIL here, some other
+        // Python thread could run and call ``os.fork()``, which would
+        // be bad if that happenend while we are holding the cleanup
+        // lock (it wouldn't function in the child process).
+        // Make a best effort to try to keep the duration we hold the
+        // lock short.
+        // TODO: On platforms that support it, use ``pthread_atfork`` to
+        // drop this lock.
+        LockGuard cleanup_lock(*mod_globs->thread_states_to_destroy_lock);
+
+        if (state && state->has_main_greenlet()) {
+            // Because we don't have the GIL, this is a race condition.
+            if (!PyInterpreterState_Head()) {
+                // We have to leak the thread state, if the
+                // interpreter has shut down when we're getting
+                // deallocated, we can't run the cleanup code that
+                // deleting it would imply.
+                return;
+            }
+
+            mod_globs->queue_to_destroy(state);
+            if (mod_globs->thread_states_to_destroy.size() == 1) {
+                // We added the first item to the queue. We need to schedule
+                // the cleanup.
+                int result = ThreadState_DestroyNoGIL::AddPendingCall(
+                    ThreadState_DestroyNoGIL::DestroyQueueWithGIL,
+                    NULL);
+                if (result < 0) {
+                    // Hmm, what can we do here?
+                    fprintf(stderr,
+                            "greenlet: WARNING: failed in call to Py_AddPendingCall; "
+                            "expect a memory leak.\n");
+                }
+            }
+        }
+    }
+
+    static int
+    DestroyQueueWithGIL(void* UNUSED(arg))
+    {
+        // We're holding the GIL here, so no Python code should be able to
+        // run to call ``os.fork()``.
+        while (1) {
+            ThreadState* to_destroy;
+            {
+                LockGuard cleanup_lock(*mod_globs->thread_states_to_destroy_lock);
+                if (mod_globs->thread_states_to_destroy.empty()) {
+                    break;
+                }
+                to_destroy = mod_globs->take_next_to_destroy();
+            }
+            // Drop the lock while we do the actual deletion.
+            ThreadState_DestroyWithGIL::DestroyWithGIL(to_destroy);
+        }
+        return 0;
+    }
+
+};
+
+}; // namespace greenlet
+
+// The intent when GET_THREAD_STATE() is needed multiple times in a
+// function is to take a reference to its return value in a local
+// variable, to avoid the thread-local indirection. On some platforms
+// (macOS), accessing a thread-local involves a function call (plus an
+// initial function call in each function that uses a thread local);
+// in contrast, static volatile variables are at some pre-computed
+// offset.
+typedef greenlet::ThreadStateCreator<greenlet::ThreadState_DestroyNoGIL> ThreadStateCreator;
+static thread_local ThreadStateCreator g_thread_state_global;
+#define GET_THREAD_STATE() g_thread_state_global
+
+#endif //T_THREADSTATE_DESTROY
diff --git a/llm/Lib/site-packages/greenlet/TUserGreenlet.cpp b/llm/Lib/site-packages/greenlet/TUserGreenlet.cpp
new file mode 100644
index 0000000000000000000000000000000000000000..495a79405ce51fa39534c41d4d479dc2be1fda0c
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/TUserGreenlet.cpp
@@ -0,0 +1,667 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */
+/**
+ * Implementation of greenlet::UserGreenlet.
+ *
+ * Format with:
+ *  clang-format -i --style=file src/greenlet/greenlet.c
+ *
+ *
+ * Fix missing braces with:
+ *   clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements"
+*/
+
+#include "greenlet_internal.hpp"
+#include "greenlet_greenlet.hpp"
+#include "greenlet_thread_state.hpp"
+#include "TThreadStateDestroy.cpp"
+
+
+namespace greenlet {
+using greenlet::refs::BorrowedMainGreenlet;
+greenlet::PythonAllocator<UserGreenlet> UserGreenlet::allocator;
+
+void* UserGreenlet::operator new(size_t UNUSED(count))
+{
+    return allocator.allocate(1);
+}
+
+
+void UserGreenlet::operator delete(void* ptr)
+{
+    return allocator.deallocate(static_cast<UserGreenlet*>(ptr),
+                                1);
+}
+
+
+UserGreenlet::UserGreenlet(PyGreenlet* p, BorrowedGreenlet the_parent)
+    : Greenlet(p), _parent(the_parent)
+{
+    this->_self = p;
+}
+
+UserGreenlet::~UserGreenlet()
+{
+    // Python 3.11: If we don't clear out the raw frame datastack
+    // when deleting an unfinished greenlet,
+    // TestLeaks.test_untracked_memory_doesnt_increase_unfinished_thread_dealloc_in_main fails.
+    this->python_state.did_finish(nullptr);
+    this->tp_clear();
+}
+
+BorrowedGreenlet
+UserGreenlet::self() const noexcept
+{
+    return this->_self;
+}
+
+
+
+const BorrowedMainGreenlet
+UserGreenlet::main_greenlet() const
+{
+    return this->_main_greenlet;
+}
+
+
+BorrowedMainGreenlet
+UserGreenlet::find_main_greenlet_in_lineage() const
+{
+    if (this->started()) {
+        assert(this->_main_greenlet);
+        return BorrowedMainGreenlet(this->_main_greenlet);
+    }
+
+    if (!this->_parent) {
+        /* garbage collected greenlet in chain */
+        // XXX: WHAT?
+        return BorrowedMainGreenlet(nullptr);
+    }
+
+    return this->_parent->find_main_greenlet_in_lineage();
+}
+
+
+/**
+ * CAUTION: This will allocate memory and may trigger garbage
+ * collection and arbitrary Python code.
+ */
+OwnedObject
+UserGreenlet::throw_GreenletExit_during_dealloc(const ThreadState& current_thread_state)
+{
+    /* The dying greenlet cannot be a parent of ts_current
+       because the 'parent' field chain would hold a
+       reference */
+    UserGreenlet::ParentIsCurrentGuard with_current_parent(this, current_thread_state);
+
+    // We don't care about the return value, only whether an
+    // exception happened. Whether or not an exception happens,
+    // we need to restore the parent in case the greenlet gets
+    // resurrected.
+    return Greenlet::throw_GreenletExit_during_dealloc(current_thread_state);
+}
+
+ThreadState*
+UserGreenlet::thread_state() const noexcept
+{
+    // TODO: maybe make this throw, if the thread state isn't there?
+    // if (!this->main_greenlet) {
+    //     throw std::runtime_error("No thread state"); // TODO: Better exception
+    // }
+    if (!this->_main_greenlet) {
+        return nullptr;
+    }
+    return this->_main_greenlet->thread_state();
+}
+
+
+bool
+UserGreenlet::was_running_in_dead_thread() const noexcept
+{
+    return this->_main_greenlet && !this->thread_state();
+}
+
+OwnedObject
+UserGreenlet::g_switch()
+{
+    assert(this->args() || PyErr_Occurred());
+
+    try {
+        this->check_switch_allowed();
+    }
+    catch (const PyErrOccurred&) {
+        this->release_args();
+        throw;
+    }
+
+    // Switching greenlets used to attempt to clean out ones that need
+    // deleted *if* we detected a thread switch. Should it still do
+    // that?
+    // An issue is that if we delete a greenlet from another thread,
+    // it gets queued to this thread, and ``kill_greenlet()`` switches
+    // back into the greenlet
+
+    /* find the real target by ignoring dead greenlets,
+       and if necessary starting a greenlet. */
+    switchstack_result_t err;
+    Greenlet* target = this;
+    // TODO: probably cleaner to handle the case where we do
+    // switch to ourself separately from the other cases.
+    // This can probably even further be simplified if we keep
+    // track of the switching_state we're going for and just call
+    // into g_switch() if it's not ourself. The main problem with that
+    // is that we would be using more stack space.
+    bool target_was_me = true;
+    bool was_initial_stub = false;
+    while (target) {
+        if (target->active()) {
+            if (!target_was_me) {
+                target->args() <<= this->args();
+                assert(!this->args());
+            }
+            err = target->g_switchstack();
+            break;
+        }
+        if (!target->started()) {
+            // We never encounter a main greenlet that's not started.
+            assert(!target->main());
+            UserGreenlet* real_target = static_cast<UserGreenlet*>(target);
+            assert(real_target);
+            void* dummymarker;
+            was_initial_stub = true;
+            if (!target_was_me) {
+                target->args() <<= this->args();
+                assert(!this->args());
+            }
+            try {
+                // This can only throw back to us while we're
+                // still in this greenlet. Once the new greenlet
+                // is bootstrapped, it has its own exception state.
+                err = real_target->g_initialstub(&dummymarker);
+            }
+            catch (const PyErrOccurred&) {
+                this->release_args();
+                throw;
+            }
+            catch (const GreenletStartedWhileInPython&) {
+                // The greenlet was started sometime before this
+                // greenlet actually switched to it, i.e.,
+                // "concurrent" calls to switch() or throw().
+                // We need to retry the switch.
+                // Note that the current greenlet has been reset
+                // to this one (or we wouldn't be running!)
+                continue;
+            }
+            break;
+        }
+
+        target = target->parent();
+        target_was_me = false;
+    }
+    // The ``this`` pointer and all other stack or register based
+    // variables are invalid now, at least where things succeed
+    // above.
+    // But this one, probably not so much? It's not clear if it's
+    // safe to throw an exception at this point.
+
+    if (err.status < 0) {
+        // If we get here, either g_initialstub()
+        // failed, or g_switchstack() failed. Either one of those
+        // cases SHOULD leave us in the original greenlet with a valid
+        // stack.
+        return this->on_switchstack_or_initialstub_failure(target, err, target_was_me, was_initial_stub);
+    }
+
+    // err.the_new_current_greenlet would be the same as ``target``,
+    // if target wasn't probably corrupt.
+    return err.the_new_current_greenlet->g_switch_finish(err);
+}
+
+
+
+Greenlet::switchstack_result_t
+UserGreenlet::g_initialstub(void* mark)
+{
+    OwnedObject run;
+
+    // We need to grab a reference to the current switch arguments
+    // in case we're entered concurrently during the call to
+    // GetAttr() and have to try again.
+    // We'll restore them when we return in that case.
+    // Scope them tightly to avoid ref leaks.
+    {
+        SwitchingArgs args(this->args());
+
+        /* save exception in case getattr clears it */
+        PyErrPieces saved;
+
+        /*
+          self.run is the object to call in the new greenlet.
+          This could run arbitrary python code and switch greenlets!
+        */
+        run = this->_self.PyRequireAttr(mod_globs->str_run);
+        /* restore saved exception */
+        saved.PyErrRestore();
+
+
+        /* recheck that it's safe to switch in case greenlet reparented anywhere above */
+        this->check_switch_allowed();
+
+        /* by the time we got here another start could happen elsewhere,
+         * that means it should now be a regular switch.
+         * This can happen if the Python code is a subclass that implements
+         * __getattribute__ or __getattr__, or makes ``run`` a descriptor;
+         * all of those can run arbitrary code that switches back into
+         * this greenlet.
+         */
+        if (this->stack_state.started()) {
+            // the successful switch cleared these out, we need to
+            // restore our version. They will be copied on up to the
+            // next target.
+            assert(!this->args());
+            this->args() <<= args;
+            throw GreenletStartedWhileInPython();
+        }
+    }
+
+    // Sweet, if we got here, we have the go-ahead and will switch
+    // greenlets.
+    // Nothing we do from here on out should allow for a thread or
+    // greenlet switch: No arbitrary calls to Python, including
+    // decref'ing
+
+#if GREENLET_USE_CFRAME
+    /* OK, we need it, we're about to switch greenlets, save the state. */
+    /*
+      See green_new(). This is a stack-allocated variable used
+      while *self* is in PyObject_Call().
+      We want to defer copying the state info until we're sure
+      we need it and are in a stable place to do so.
+    */
+    _PyCFrame trace_info;
+
+    this->python_state.set_new_cframe(trace_info);
+#endif
+    /* start the greenlet */
+    ThreadState& thread_state = GET_THREAD_STATE().state();
+    this->stack_state = StackState(mark,
+                                   thread_state.borrow_current()->stack_state);
+    this->python_state.set_initial_state(PyThreadState_GET());
+    this->exception_state.clear();
+    this->_main_greenlet = thread_state.get_main_greenlet();
+
+    /* perform the initial switch */
+    switchstack_result_t err = this->g_switchstack();
+    /* returns twice!
+       The 1st time with ``err == 1``: we are in the new greenlet.
+       This one owns a greenlet that used to be current.
+       The 2nd time with ``err <= 0``: back in the caller's
+       greenlet; this happens if the child finishes or switches
+       explicitly to us. Either way, the ``err`` variable is
+       created twice at the same memory location, but possibly
+       having different ``origin`` values. Note that it's not
+       constructed for the second time until the switch actually happens.
+    */
+    if (err.status == 1) {
+        // In the new greenlet.
+
+        // This never returns! Calling inner_bootstrap steals
+        // the contents of our run object within this stack frame, so
+        // it is not valid to do anything with it.
+        try {
+            this->inner_bootstrap(err.origin_greenlet.relinquish_ownership(),
+                                  run.relinquish_ownership());
+        }
+        // Getting a C++ exception here isn't good. It's probably a
+        // bug in the underlying greenlet, meaning it's probably a
+        // C++ extension. We're going to abort anyway, but try to
+        // display some nice information *if* possible. Some obscure
+        // platforms don't properly support this (old 32-bit Arm, see see
+        // https://github.com/python-greenlet/greenlet/issues/385); that's not
+        // great, but should usually be OK because, as mentioned above, we're
+        // terminating anyway.
+        //
+        // The catching is tested by
+        // ``test_cpp.CPPTests.test_unhandled_exception_in_greenlet_aborts``.
+        //
+        // PyErrOccurred can theoretically be thrown by
+        // inner_bootstrap() -> g_switch_finish(), but that should
+        // never make it back to here. It is a std::exception and
+        // would be caught if it is.
+        catch (const std::exception& e) {
+            std::string base = "greenlet: Unhandled C++ exception: ";
+            base += e.what();
+            Py_FatalError(base.c_str());
+        }
+        catch (...) {
+            // Some compilers/runtimes use exceptions internally.
+            // It appears that GCC on Linux with libstdc++ throws an
+            // exception internally at process shutdown time to unwind
+            // stacks and clean up resources. Depending on exactly
+            // where we are when the process exits, that could result
+            // in an unknown exception getting here. If we
+            // Py_FatalError() or abort() here, we interfere with
+            // orderly process shutdown. Throwing the exception on up
+            // is the right thing to do.
+            //
+            // gevent's ``examples/dns_mass_resolve.py`` demonstrates this.
+#ifndef NDEBUG
+            fprintf(stderr,
+                    "greenlet: inner_bootstrap threw unknown exception; "
+                    "is the process terminating?\n");
+#endif
+            throw;
+        }
+        Py_FatalError("greenlet: inner_bootstrap returned with no exception.\n");
+    }
+
+
+    // In contrast, notice that we're keeping the origin greenlet
+    // around as an owned reference; we need it to call the trace
+    // function for the switch back into the parent. It was only
+    // captured at the time the switch actually happened, though,
+    // so we haven't been keeping an extra reference around this
+    // whole time.
+
+    /* back in the parent */
+    if (err.status < 0) {
+        /* start failed badly, restore greenlet state */
+        this->stack_state = StackState();
+        this->_main_greenlet.CLEAR();
+        // CAUTION: This may run arbitrary Python code.
+        run.CLEAR(); // inner_bootstrap didn't run, we own the reference.
+    }
+
+    // In the success case, the spawned code (inner_bootstrap) will
+    // take care of decrefing this, so we relinquish ownership so as
+    // to not double-decref.
+
+    run.relinquish_ownership();
+
+    return err;
+}
+
+
+void
+UserGreenlet::inner_bootstrap(PyGreenlet* origin_greenlet, PyObject* run)
+{
+    // The arguments here would be another great place for move.
+    // As it is, we take them as a reference so that when we clear
+    // them we clear what's on the stack above us. Do that NOW, and
+    // without using a C++ RAII object,
+    // so there's no way that exiting the parent frame can clear it,
+    // or we clear it unexpectedly. This arises in the context of the
+    // interpreter shutting down. See https://github.com/python-greenlet/greenlet/issues/325
+    //PyObject* run = _run.relinquish_ownership();
+
+    /* in the new greenlet */
+    assert(this->thread_state()->borrow_current() == this->_self);
+    // C++ exceptions cannot propagate to the parent greenlet from
+    // here. (TODO: Do we need a catch(...) clause, perhaps on the
+    // function itself? ALl we could do is terminate the program.)
+    // NOTE: On 32-bit Windows, the call chain is extremely
+    // important here in ways that are subtle, having to do with
+    // the depth of the SEH list. The call to restore it MUST NOT
+    // add a new SEH handler to the list, or we'll restore it to
+    // the wrong thing.
+    this->thread_state()->restore_exception_state();
+    /* stack variables from above are no good and also will not unwind! */
+    // EXCEPT: That can't be true, we access run, among others, here.
+
+    this->stack_state.set_active(); /* running */
+
+    // We're about to possibly run Python code again, which
+    // could switch back/away to/from us, so we need to grab the
+    // arguments locally.
+    SwitchingArgs args;
+    args <<= this->args();
+    assert(!this->args());
+
+    // XXX: We could clear this much earlier, right?
+    // Or would that introduce the possibility of running Python
+    // code when we don't want to?
+    // CAUTION: This may run arbitrary Python code.
+    this->_run_callable.CLEAR();
+
+
+    // The first switch we need to manually call the trace
+    // function here instead of in g_switch_finish, because we
+    // never return there.
+    if (OwnedObject tracefunc = this->thread_state()->get_tracefunc()) {
+        OwnedGreenlet trace_origin;
+        trace_origin = origin_greenlet;
+        try {
+            g_calltrace(tracefunc,
+                        args ? mod_globs->event_switch : mod_globs->event_throw,
+                        trace_origin,
+                        this->_self);
+        }
+        catch (const PyErrOccurred&) {
+            /* Turn trace errors into switch throws */
+            args.CLEAR();
+        }
+    }
+
+    // We no longer need the origin, it was only here for
+    // tracing.
+    // We may never actually exit this stack frame so we need
+    // to explicitly clear it.
+    // This could run Python code and switch.
+    Py_CLEAR(origin_greenlet);
+
+    OwnedObject result;
+    if (!args) {
+        /* pending exception */
+        result = NULL;
+    }
+    else {
+        /* call g.run(*args, **kwargs) */
+        // This could result in further switches
+        try {
+            //result = run.PyCall(args.args(), args.kwargs());
+            // CAUTION: Just invoking this, before the function even
+            // runs, may cause memory allocations, which may trigger
+            // GC, which may run arbitrary Python code.
+            result = OwnedObject::consuming(PyObject_Call(run, args.args().borrow(), args.kwargs().borrow()));
+        }
+        catch (...) {
+            // Unhandled C++ exception!
+
+            // If we declare ourselves as noexcept, if we don't catch
+            // this here, most platforms will just abort() the
+            // process. But on 64-bit Windows with older versions of
+            // the C runtime, this can actually corrupt memory and
+            // just return. We see this when compiling with the
+            // Windows 7.0 SDK targeting Windows Server 2008, but not
+            // when using the Appveyor Visual Studio 2019 image. So
+            // this currently only affects Python 2.7 on Windows 64.
+            // That is, the tests pass and the runtime aborts
+            // everywhere else.
+            //
+            // However, if we catch it and try to continue with a
+            // Python error, then all Windows 64 bit platforms corrupt
+            // memory. So all we can do is manually abort, hopefully
+            // with a good error message. (Note that the above was
+            // tested WITHOUT the `/EHr` switch being used at compile
+            // time, so MSVC may have "optimized" out important
+            // checking. Using that switch, we may be in a better
+            // place in terms of memory corruption.) But sometimes it
+            // can't be caught here at all, which is confusing but not
+            // terribly surprising; so again, the G_NOEXCEPT_WIN32
+            // plus "/EHr".
+            //
+            // Hopefully the basic C stdlib is still functional enough
+            // for us to at least print an error.
+            //
+            // It gets more complicated than that, though, on some
+            // platforms, specifically at least Linux/gcc/libstdc++. They use
+            // an exception to unwind the stack when a background
+            // thread exits. (See comments about noexcept.) So this
+            // may not actually represent anything untoward. On those
+            // platforms we allow throws of this to propagate, or
+            // attempt to anyway.
+# if defined(WIN32) || defined(_WIN32)
+            Py_FatalError(
+                "greenlet: Unhandled C++ exception from a greenlet run function. "
+                "Because memory is likely corrupted, terminating process.");
+            std::abort();
+#else
+            throw;
+#endif
+        }
+    }
+    // These lines may run arbitrary code
+    args.CLEAR();
+    Py_CLEAR(run);
+
+    if (!result
+        && mod_globs->PyExc_GreenletExit.PyExceptionMatches()
+        && (this->args())) {
+        // This can happen, for example, if our only reference
+        // goes away after we switch back to the parent.
+        // See test_dealloc_switch_args_not_lost
+        PyErrPieces clear_error;
+        result <<= this->args();
+        result = single_result(result);
+    }
+    this->release_args();
+    this->python_state.did_finish(PyThreadState_GET());
+
+    result = g_handle_exit(result);
+    assert(this->thread_state()->borrow_current() == this->_self);
+
+    /* jump back to parent */
+    this->stack_state.set_inactive(); /* dead */
+
+
+    // TODO: Can we decref some things here? Release our main greenlet
+    // and maybe parent?
+    for (Greenlet* parent = this->_parent;
+         parent;
+         parent = parent->parent()) {
+        // We need to somewhere consume a reference to
+        // the result; in most cases we'll never have control
+        // back in this stack frame again. Calling
+        // green_switch actually adds another reference!
+        // This would probably be clearer with a specific API
+        // to hand results to the parent.
+        parent->args() <<= result;
+        assert(!result);
+        // The parent greenlet now owns the result; in the
+        // typical case we'll never get back here to assign to
+        // result and thus release the reference.
+        try {
+            result = parent->g_switch();
+        }
+        catch (const PyErrOccurred&) {
+            // Ignore, keep passing the error on up.
+        }
+
+        /* Return here means switch to parent failed,
+         * in which case we throw *current* exception
+         * to the next parent in chain.
+         */
+        assert(!result);
+    }
+    /* We ran out of parents, cannot continue */
+    PyErr_WriteUnraisable(this->self().borrow_o());
+    Py_FatalError("greenlet: ran out of parent greenlets while propagating exception; "
+                  "cannot continue");
+    std::abort();
+}
+
+void
+UserGreenlet::run(const BorrowedObject nrun)
+{
+    if (this->started()) {
+        throw AttributeError(
+                        "run cannot be set "
+                        "after the start of the greenlet");
+    }
+    this->_run_callable = nrun;
+}
+
+const OwnedGreenlet
+UserGreenlet::parent() const
+{
+    return this->_parent;
+}
+
+void
+UserGreenlet::parent(const BorrowedObject raw_new_parent)
+{
+    if (!raw_new_parent) {
+        throw AttributeError("can't delete attribute");
+    }
+
+    BorrowedMainGreenlet main_greenlet_of_new_parent;
+    BorrowedGreenlet new_parent(raw_new_parent.borrow()); // could
+                                                          // throw
+                                                          // TypeError!
+    for (BorrowedGreenlet p = new_parent; p; p = p->parent()) {
+        if (p == this->_self) {
+            throw ValueError("cyclic parent chain");
+        }
+        main_greenlet_of_new_parent = p->main_greenlet();
+    }
+
+    if (!main_greenlet_of_new_parent) {
+        throw ValueError("parent must not be garbage collected");
+    }
+
+    if (this->started()
+        && this->_main_greenlet != main_greenlet_of_new_parent) {
+        throw ValueError("parent cannot be on a different thread");
+    }
+
+    this->_parent = new_parent;
+}
+
+void
+UserGreenlet::murder_in_place()
+{
+    this->_main_greenlet.CLEAR();
+    Greenlet::murder_in_place();
+}
+
+bool
+UserGreenlet::belongs_to_thread(const ThreadState* thread_state) const
+{
+    return Greenlet::belongs_to_thread(thread_state) && this->_main_greenlet == thread_state->borrow_main_greenlet();
+}
+
+
+int
+UserGreenlet::tp_traverse(visitproc visit, void* arg)
+{
+    Py_VISIT(this->_parent.borrow_o());
+    Py_VISIT(this->_main_greenlet.borrow_o());
+    Py_VISIT(this->_run_callable.borrow_o());
+
+    return Greenlet::tp_traverse(visit, arg);
+}
+
+int
+UserGreenlet::tp_clear()
+{
+    Greenlet::tp_clear();
+    this->_parent.CLEAR();
+    this->_main_greenlet.CLEAR();
+    this->_run_callable.CLEAR();
+    return 0;
+}
+
+UserGreenlet::ParentIsCurrentGuard::ParentIsCurrentGuard(UserGreenlet* p,
+                                                     const ThreadState& thread_state)
+    : oldparent(p->_parent),
+      greenlet(p)
+{
+    p->_parent = thread_state.get_current();
+}
+
+UserGreenlet::ParentIsCurrentGuard::~ParentIsCurrentGuard()
+{
+    this->greenlet->_parent = oldparent;
+    oldparent.CLEAR();
+}
+
+}; //namespace greenlet
diff --git a/llm/Lib/site-packages/greenlet/__init__.py b/llm/Lib/site-packages/greenlet/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..298a19de02f47540b2be8ae246c761dc2e426ce9
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/__init__.py
@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+"""
+The root of the greenlet package.
+"""
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import print_function
+
+__all__ = [
+    '__version__',
+    '_C_API',
+
+    'GreenletExit',
+    'error',
+
+    'getcurrent',
+    'greenlet',
+
+    'gettrace',
+    'settrace',
+]
+
+# pylint:disable=no-name-in-module
+
+###
+# Metadata
+###
+__version__ = '3.0.3'
+from ._greenlet import _C_API # pylint:disable=no-name-in-module
+
+###
+# Exceptions
+###
+from ._greenlet import GreenletExit
+from ._greenlet import error
+
+###
+# greenlets
+###
+from ._greenlet import getcurrent
+from ._greenlet import greenlet
+
+###
+# tracing
+###
+try:
+    from ._greenlet import gettrace
+    from ._greenlet import settrace
+except ImportError:
+    # Tracing wasn't supported.
+    # XXX: The option to disable it was removed in 1.0,
+    # so this branch should be dead code.
+    pass
+
+###
+# Constants
+# These constants aren't documented and aren't recommended.
+# In 1.0, USE_GC and USE_TRACING are always true, and USE_CONTEXT_VARS
+# is the same as ``sys.version_info[:2] >= 3.7``
+###
+from ._greenlet import GREENLET_USE_CONTEXT_VARS # pylint:disable=unused-import
+from ._greenlet import GREENLET_USE_GC # pylint:disable=unused-import
+from ._greenlet import GREENLET_USE_TRACING # pylint:disable=unused-import
+
+# Controlling the use of the gc module. Provisional API for this greenlet
+# implementation in 2.0.
+from ._greenlet import CLOCKS_PER_SEC # pylint:disable=unused-import
+from ._greenlet import enable_optional_cleanup # pylint:disable=unused-import
+from ._greenlet import get_clocks_used_doing_optional_cleanup # pylint:disable=unused-import
+
+# Other APIS in the _greenlet module are for test support.
diff --git a/llm/Lib/site-packages/greenlet/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/greenlet/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3edaa892662173969e81e36b30d0a852dbd182f8
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/_greenlet.cp311-win_amd64.pyd b/llm/Lib/site-packages/greenlet/_greenlet.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..bac24fdd3eb8f6c737a9c44b36ecf19a31fbf45d
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/_greenlet.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/greenlet/greenlet.cpp b/llm/Lib/site-packages/greenlet/greenlet.cpp
new file mode 100644
index 0000000000000000000000000000000000000000..5a9818e83f220e918579f79f8600dce4ef0f3aae
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet.cpp
@@ -0,0 +1,1494 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */
+/* Format with:
+ *  clang-format -i --style=file src/greenlet/greenlet.c
+ *
+ *
+ * Fix missing braces with:
+ *   clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements"
+*/
+#include <cstdlib>
+#include <string>
+#include <algorithm>
+#include <exception>
+
+
+#define PY_SSIZE_T_CLEAN
+#include <Python.h>
+#include "structmember.h" // PyMemberDef
+
+#include "greenlet_internal.hpp"
+// Code after this point can assume access to things declared in stdint.h,
+// including the fixed-width types. This goes for the platform-specific switch functions
+// as well.
+#include "greenlet_refs.hpp"
+#include "greenlet_slp_switch.hpp"
+#include "greenlet_thread_state.hpp"
+#include "greenlet_thread_support.hpp"
+#include "greenlet_greenlet.hpp"
+
+#include "TGreenletGlobals.cpp"
+#include "TThreadStateDestroy.cpp"
+#include "TGreenlet.cpp"
+#include "TMainGreenlet.cpp"
+#include "TUserGreenlet.cpp"
+#include "TBrokenGreenlet.cpp"
+#include "TExceptionState.cpp"
+#include "TPythonState.cpp"
+#include "TStackState.cpp"
+
+
+using greenlet::LockGuard;
+using greenlet::LockInitError;
+using greenlet::PyErrOccurred;
+using greenlet::Require;
+
+using greenlet::g_handle_exit;
+using greenlet::single_result;
+
+using greenlet::Greenlet;
+using greenlet::UserGreenlet;
+using greenlet::MainGreenlet;
+using greenlet::BrokenGreenlet;
+using greenlet::ThreadState;
+using greenlet::PythonState;
+
+
+
+// ******* Implementation of things from included files
+template<typename T, greenlet::refs::TypeChecker TC>
+greenlet::refs::_BorrowedGreenlet<T, TC>& greenlet::refs::_BorrowedGreenlet<T, TC>::operator=(const greenlet::refs::BorrowedObject& other)
+{
+    this->_set_raw_pointer(static_cast<PyObject*>(other));
+    return *this;
+}
+
+template <typename T, greenlet::refs::TypeChecker TC>
+inline greenlet::refs::_BorrowedGreenlet<T, TC>::operator Greenlet*() const noexcept
+{
+    if (!this->p) {
+        return nullptr;
+    }
+    return reinterpret_cast<PyGreenlet*>(this->p)->pimpl;
+}
+
+template<typename T, greenlet::refs::TypeChecker TC>
+greenlet::refs::_BorrowedGreenlet<T, TC>::_BorrowedGreenlet(const BorrowedObject& p)
+    : BorrowedReference<T, TC>(nullptr)
+{
+
+    this->_set_raw_pointer(p.borrow());
+}
+
+template <typename T, greenlet::refs::TypeChecker TC>
+inline greenlet::refs::_OwnedGreenlet<T, TC>::operator Greenlet*() const noexcept
+{
+    if (!this->p) {
+        return nullptr;
+    }
+    return reinterpret_cast<PyGreenlet*>(this->p)->pimpl;
+}
+
+
+
+#ifdef __clang__
+#    pragma clang diagnostic push
+#    pragma clang diagnostic ignored "-Wmissing-field-initializers"
+#    pragma clang diagnostic ignored "-Wwritable-strings"
+#elif defined(__GNUC__)
+#    pragma GCC diagnostic push
+//  warning: ISO C++ forbids converting a string constant to ‘char*’
+// (The python APIs aren't const correct and accept writable char*)
+#    pragma GCC diagnostic ignored "-Wwrite-strings"
+#endif
+
+
+/***********************************************************
+
+A PyGreenlet is a range of C stack addresses that must be
+saved and restored in such a way that the full range of the
+stack contains valid data when we switch to it.
+
+Stack layout for a greenlet:
+
+               |     ^^^       |
+               |  older data   |
+               |               |
+  stack_stop . |_______________|
+        .      |               |
+        .      | greenlet data |
+        .      |   in stack    |
+        .    * |_______________| . .  _____________  stack_copy + stack_saved
+        .      |               |     |             |
+        .      |     data      |     |greenlet data|
+        .      |   unrelated   |     |    saved    |
+        .      |      to       |     |   in heap   |
+ stack_start . |     this      | . . |_____________| stack_copy
+               |   greenlet    |
+               |               |
+               |  newer data   |
+               |     vvv       |
+
+
+Note that a greenlet's stack data is typically partly at its correct
+place in the stack, and partly saved away in the heap, but always in
+the above configuration: two blocks, the more recent one in the heap
+and the older one still in the stack (either block may be empty).
+
+Greenlets are chained: each points to the previous greenlet, which is
+the one that owns the data currently in the C stack above my
+stack_stop.  The currently running greenlet is the first element of
+this chain.  The main (initial) greenlet is the last one.  Greenlets
+whose stack is entirely in the heap can be skipped from the chain.
+
+The chain is not related to execution order, but only to the order
+in which bits of C stack happen to belong to greenlets at a particular
+point in time.
+
+The main greenlet doesn't have a stack_stop: it is responsible for the
+complete rest of the C stack, and we don't know where it begins.  We
+use (char*) -1, the largest possible address.
+
+States:
+  stack_stop == NULL && stack_start == NULL:  did not start yet
+  stack_stop != NULL && stack_start == NULL:  already finished
+  stack_stop != NULL && stack_start != NULL:  active
+
+The running greenlet's stack_start is undefined but not NULL.
+
+ ***********************************************************/
+
+static PyGreenlet*
+green_create_main(ThreadState* state)
+{
+    PyGreenlet* gmain;
+
+    /* create the main greenlet for this thread */
+    gmain = (PyGreenlet*)PyType_GenericAlloc(&PyGreenlet_Type, 0);
+    if (gmain == NULL) {
+        Py_FatalError("green_create_main failed to alloc");
+        return NULL;
+    }
+    new MainGreenlet(gmain, state);
+
+    assert(Py_REFCNT(gmain) == 1);
+    return gmain;
+}
+
+
+
+/***********************************************************/
+
+/* Some functions must not be inlined:
+   * slp_restore_state, when inlined into slp_switch might cause
+     it to restore stack over its own local variables
+   * slp_save_state, when inlined would add its own local
+     variables to the saved stack, wasting space
+   * slp_switch, cannot be inlined for obvious reasons
+   * g_initialstub, when inlined would receive a pointer into its
+     own stack frame, leading to incomplete stack save/restore
+
+g_initialstub is a member function and declared virtual so that the
+compiler always calls it through a vtable.
+
+slp_save_state and slp_restore_state are also member functions. They
+are called from trampoline functions that themselves are declared as
+not eligible for inlining.
+*/
+
+extern "C" {
+static int GREENLET_NOINLINE(slp_save_state_trampoline)(char* stackref)
+{
+    return switching_thread_state->slp_save_state(stackref);
+}
+static void GREENLET_NOINLINE(slp_restore_state_trampoline)()
+{
+    switching_thread_state->slp_restore_state();
+}
+}
+
+
+/***********************************************************/
+
+static PyGreenlet*
+green_new(PyTypeObject* type, PyObject* UNUSED(args), PyObject* UNUSED(kwds))
+{
+    PyGreenlet* o =
+        (PyGreenlet*)PyBaseObject_Type.tp_new(type, mod_globs->empty_tuple, mod_globs->empty_dict);
+    if (o) {
+        new UserGreenlet(o, GET_THREAD_STATE().state().borrow_current());
+        assert(Py_REFCNT(o) == 1);
+    }
+    return o;
+}
+
+static PyGreenlet*
+green_unswitchable_new(PyTypeObject* type, PyObject* UNUSED(args), PyObject* UNUSED(kwds))
+{
+    PyGreenlet* o =
+        (PyGreenlet*)PyBaseObject_Type.tp_new(type, mod_globs->empty_tuple, mod_globs->empty_dict);
+    if (o) {
+        new BrokenGreenlet(o, GET_THREAD_STATE().state().borrow_current());
+        assert(Py_REFCNT(o) == 1);
+    }
+    return o;
+}
+
+static int
+green_setrun(BorrowedGreenlet self, BorrowedObject nrun, void* c);
+static int
+green_setparent(BorrowedGreenlet self, BorrowedObject nparent, void* c);
+
+static int
+green_init(BorrowedGreenlet self, BorrowedObject args, BorrowedObject kwargs)
+{
+    PyArgParseParam run;
+    PyArgParseParam nparent;
+    static const char* const kwlist[] = {
+        "run",
+        "parent",
+        NULL
+    };
+
+    // recall: The O specifier does NOT increase the reference count.
+    if (!PyArg_ParseTupleAndKeywords(
+             args, kwargs, "|OO:green", (char**)kwlist, &run, &nparent)) {
+        return -1;
+    }
+
+    if (run) {
+        if (green_setrun(self, run, NULL)) {
+            return -1;
+        }
+    }
+    if (nparent && !nparent.is_None()) {
+        return green_setparent(self, nparent, NULL);
+    }
+    return 0;
+}
+
+
+
+static int
+green_traverse(PyGreenlet* self, visitproc visit, void* arg)
+{
+    // We must only visit referenced objects, i.e. only objects
+    // Py_INCREF'ed by this greenlet (directly or indirectly):
+    //
+    // - stack_prev is not visited: holds previous stack pointer, but it's not
+    //    referenced
+    // - frames are not visited as we don't strongly reference them;
+    //    alive greenlets are not garbage collected
+    //    anyway. This can be a problem, however, if this greenlet is
+    //    never allowed to finish, and is referenced from the frame: we
+    //    have an uncollectible cycle in that case. Note that the
+    //    frame object itself is also frequently not even tracked by the GC
+    //    starting with Python 3.7 (frames are allocated by the
+    //    interpreter untracked, and only become tracked when their
+    //    evaluation is finished if they have a refcount > 1). All of
+    //    this is to say that we should probably strongly reference
+    //    the frame object. Doing so, while always allowing GC on a
+    //    greenlet, solves several leaks for us.
+
+    Py_VISIT(self->dict);
+    if (!self->pimpl) {
+        // Hmm. I have seen this at interpreter shutdown time,
+        // I think. That's very odd because this doesn't go away until
+        // we're ``green_dealloc()``, at which point we shouldn't be
+        // traversed anymore.
+        return 0;
+    }
+
+    return self->pimpl->tp_traverse(visit, arg);
+}
+
+static int
+green_is_gc(BorrowedGreenlet self)
+{
+    int result = 0;
+    /* Main greenlet can be garbage collected since it can only
+       become unreachable if the underlying thread exited.
+       Active greenlets --- including those that are suspended ---
+       cannot be garbage collected, however.
+    */
+    if (self->main() || !self->active()) {
+        result = 1;
+    }
+    // The main greenlet pointer will eventually go away after the thread dies.
+    if (self->was_running_in_dead_thread()) {
+        // Our thread is dead! We can never run again. Might as well
+        // GC us. Note that if a tuple containing only us and other
+        // immutable objects had been scanned before this, when we
+        // would have returned 0, the tuple will take itself out of GC
+        // tracking and never be investigated again. So that could
+        // result in both us and the tuple leaking due to an
+        // unreachable/uncollectible reference. The same goes for
+        // dictionaries.
+        //
+        // It's not a great idea to be changing our GC state on the
+        // fly.
+        result = 1;
+    }
+    return result;
+}
+
+
+static int
+green_clear(PyGreenlet* self)
+{
+    /* Greenlet is only cleared if it is about to be collected.
+       Since active greenlets are not garbage collectable, we can
+       be sure that, even if they are deallocated during clear,
+       nothing they reference is in unreachable or finalizers,
+       so even if it switches we are relatively safe. */
+    // XXX: Are we responsible for clearing weakrefs here?
+    Py_CLEAR(self->dict);
+    return self->pimpl->tp_clear();
+}
+
+/**
+ * Returns 0 on failure (the object was resurrected) or 1 on success.
+ **/
+static int
+_green_dealloc_kill_started_non_main_greenlet(BorrowedGreenlet self)
+{
+    /* Hacks hacks hacks copied from instance_dealloc() */
+    /* Temporarily resurrect the greenlet. */
+    assert(self.REFCNT() == 0);
+    Py_SET_REFCNT(self.borrow(), 1);
+    /* Save the current exception, if any. */
+    PyErrPieces saved_err;
+    try {
+        // BY THE TIME WE GET HERE, the state may actually be going
+        // away
+        // if we're shutting down the interpreter and freeing thread
+        // entries,
+        // this could result in freeing greenlets that were leaked. So
+        // we can't try to read the state.
+        self->deallocing_greenlet_in_thread(
+              self->thread_state()
+              ? static_cast<ThreadState*>(GET_THREAD_STATE())
+              : nullptr);
+    }
+    catch (const PyErrOccurred&) {
+        PyErr_WriteUnraisable(self.borrow_o());
+        /* XXX what else should we do? */
+    }
+    /* Check for no resurrection must be done while we keep
+     * our internal reference, otherwise PyFile_WriteObject
+     * causes recursion if using Py_INCREF/Py_DECREF
+     */
+    if (self.REFCNT() == 1 && self->active()) {
+        /* Not resurrected, but still not dead!
+           XXX what else should we do? we complain. */
+        PyObject* f = PySys_GetObject("stderr");
+        Py_INCREF(self.borrow_o()); /* leak! */
+        if (f != NULL) {
+            PyFile_WriteString("GreenletExit did not kill ", f);
+            PyFile_WriteObject(self.borrow_o(), f, 0);
+            PyFile_WriteString("\n", f);
+        }
+    }
+    /* Restore the saved exception. */
+    saved_err.PyErrRestore();
+    /* Undo the temporary resurrection; can't use DECREF here,
+     * it would cause a recursive call.
+     */
+    assert(self.REFCNT() > 0);
+
+    Py_ssize_t refcnt = self.REFCNT() - 1;
+    Py_SET_REFCNT(self.borrow_o(), refcnt);
+    if (refcnt != 0) {
+        /* Resurrected! */
+        _Py_NewReference(self.borrow_o());
+        Py_SET_REFCNT(self.borrow_o(), refcnt);
+        /* Better to use tp_finalizer slot (PEP 442)
+         * and call ``PyObject_CallFinalizerFromDealloc``,
+         * but that's only supported in Python 3.4+; see
+         * Modules/_io/iobase.c for an example.
+         *
+         * The following approach is copied from iobase.c in CPython 2.7.
+         * (along with much of this function in general). Here's their
+         * comment:
+         *
+         * When called from a heap type's dealloc, the type will be
+         * decref'ed on return (see e.g. subtype_dealloc in typeobject.c). */
+        if (PyType_HasFeature(self.TYPE(), Py_TPFLAGS_HEAPTYPE)) {
+            Py_INCREF(self.TYPE());
+        }
+
+        PyObject_GC_Track((PyObject*)self);
+
+        _Py_DEC_REFTOTAL;
+#ifdef COUNT_ALLOCS
+        --Py_TYPE(self)->tp_frees;
+        --Py_TYPE(self)->tp_allocs;
+#endif /* COUNT_ALLOCS */
+        return 0;
+    }
+    return 1;
+}
+
+
+static void
+green_dealloc(PyGreenlet* self)
+{
+    PyObject_GC_UnTrack(self);
+    BorrowedGreenlet me(self);
+    if (me->active()
+        && me->started()
+        && !me->main()) {
+        if (!_green_dealloc_kill_started_non_main_greenlet(me)) {
+            return;
+        }
+    }
+
+    if (self->weakreflist != NULL) {
+        PyObject_ClearWeakRefs((PyObject*)self);
+    }
+    Py_CLEAR(self->dict);
+
+    if (self->pimpl) {
+        // In case deleting this, which frees some memory,
+        // somehow winds up calling back into us. That's usually a
+        //bug in our code.
+        Greenlet* p = self->pimpl;
+        self->pimpl = nullptr;
+        delete p;
+    }
+    // and finally we're done. self is now invalid.
+    Py_TYPE(self)->tp_free((PyObject*)self);
+}
+
+
+
+static OwnedObject
+throw_greenlet(BorrowedGreenlet self, PyErrPieces& err_pieces)
+{
+    PyObject* result = nullptr;
+    err_pieces.PyErrRestore();
+    assert(PyErr_Occurred());
+    if (self->started() && !self->active()) {
+        /* dead greenlet: turn GreenletExit into a regular return */
+        result = g_handle_exit(OwnedObject()).relinquish_ownership();
+    }
+    self->args() <<= result;
+
+    return single_result(self->g_switch());
+}
+
+
+
+PyDoc_STRVAR(
+    green_switch_doc,
+    "switch(*args, **kwargs)\n"
+    "\n"
+    "Switch execution to this greenlet.\n"
+    "\n"
+    "If this greenlet has never been run, then this greenlet\n"
+    "will be switched to using the body of ``self.run(*args, **kwargs)``.\n"
+    "\n"
+    "If the greenlet is active (has been run, but was switch()'ed\n"
+    "out before leaving its run function), then this greenlet will\n"
+    "be resumed and the return value to its switch call will be\n"
+    "None if no arguments are given, the given argument if one\n"
+    "argument is given, or the args tuple and keyword args dict if\n"
+    "multiple arguments are given.\n"
+    "\n"
+    "If the greenlet is dead, or is the current greenlet then this\n"
+    "function will simply return the arguments using the same rules as\n"
+    "above.\n");
+
+static PyObject*
+green_switch(PyGreenlet* self, PyObject* args, PyObject* kwargs)
+{
+    using greenlet::SwitchingArgs;
+    SwitchingArgs switch_args(OwnedObject::owning(args), OwnedObject::owning(kwargs));
+    self->pimpl->may_switch_away();
+    self->pimpl->args() <<= switch_args;
+
+    // If we're switching out of a greenlet, and that switch is the
+    // last thing the greenlet does, the greenlet ought to be able to
+    // go ahead and die at that point. Currently, someone else must
+    // manually switch back to the greenlet so that we "fall off the
+    // end" and can perform cleanup. You'd think we'd be able to
+    // figure out that this is happening using the frame's ``f_lasti``
+    // member, which is supposed to be an index into
+    // ``frame->f_code->co_code``, the bytecode string. However, in
+    // recent interpreters, ``f_lasti`` tends not to be updated thanks
+    // to things like the PREDICT() macros in ceval.c. So it doesn't
+    // really work to do that in many cases. For example, the Python
+    // code:
+    //     def run():
+    //         greenlet.getcurrent().parent.switch()
+    // produces bytecode of len 16, with the actual call to switch()
+    // being at index 10 (in Python 3.10). However, the reported
+    // ``f_lasti`` we actually see is...5! (Which happens to be the
+    // second byte of the CALL_METHOD op for ``getcurrent()``).
+
+    try {
+        //OwnedObject result = single_result(self->pimpl->g_switch());
+        OwnedObject result(single_result(self->pimpl->g_switch()));
+#ifndef NDEBUG
+        // Note that the current greenlet isn't necessarily self. If self
+        // finished, we went to one of its parents.
+        assert(!self->pimpl->args());
+
+        const BorrowedGreenlet& current = GET_THREAD_STATE().state().borrow_current();
+        // It's possible it's never been switched to.
+        assert(!current->args());
+#endif
+        PyObject* p = result.relinquish_ownership();
+
+        if (!p && !PyErr_Occurred()) {
+            // This shouldn't be happening anymore, so the asserts
+            // are there for debug builds. Non-debug builds
+            // crash "gracefully" in this case, although there is an
+            // argument to be made for killing the process in all
+            // cases --- for this to be the case, our switches
+            // probably nested in an incorrect way, so the state is
+            // suspicious. Nothing should be corrupt though, just
+            // confused at the Python level. Letting this propagate is
+            // probably good enough.
+            assert(p || PyErr_Occurred());
+            throw PyErrOccurred(
+                mod_globs->PyExc_GreenletError,
+                "Greenlet.switch() returned NULL without an exception set."
+            );
+        }
+        return p;
+    }
+    catch(const PyErrOccurred&) {
+        return nullptr;
+    }
+}
+
+PyDoc_STRVAR(
+    green_throw_doc,
+    "Switches execution to this greenlet, but immediately raises the\n"
+    "given exception in this greenlet.  If no argument is provided, the "
+    "exception\n"
+    "defaults to `greenlet.GreenletExit`.  The normal exception\n"
+    "propagation rules apply, as described for `switch`.  Note that calling "
+    "this\n"
+    "method is almost equivalent to the following::\n"
+    "\n"
+    "    def raiser():\n"
+    "        raise typ, val, tb\n"
+    "    g_raiser = greenlet(raiser, parent=g)\n"
+    "    g_raiser.switch()\n"
+    "\n"
+    "except that this trick does not work for the\n"
+    "`greenlet.GreenletExit` exception, which would not propagate\n"
+    "from ``g_raiser`` to ``g``.\n");
+
+static PyObject*
+green_throw(PyGreenlet* self, PyObject* args)
+{
+    PyArgParseParam typ(mod_globs->PyExc_GreenletExit);
+    PyArgParseParam val;
+    PyArgParseParam tb;
+
+    if (!PyArg_ParseTuple(args, "|OOO:throw", &typ, &val, &tb)) {
+        return nullptr;
+    }
+
+    assert(typ.borrow() || val.borrow());
+
+    self->pimpl->may_switch_away();
+    try {
+        // Both normalizing the error and the actual throw_greenlet
+        // could throw PyErrOccurred.
+        PyErrPieces err_pieces(typ.borrow(), val.borrow(), tb.borrow());
+
+        return throw_greenlet(self, err_pieces).relinquish_ownership();
+    }
+    catch (const PyErrOccurred&) {
+        return nullptr;
+    }
+}
+
+static int
+green_bool(PyGreenlet* self)
+{
+    return self->pimpl->active();
+}
+
+/**
+ * CAUTION: Allocates memory, may run GC and arbitrary Python code.
+ */
+static PyObject*
+green_getdict(PyGreenlet* self, void* UNUSED(context))
+{
+    if (self->dict == NULL) {
+        self->dict = PyDict_New();
+        if (self->dict == NULL) {
+            return NULL;
+        }
+    }
+    Py_INCREF(self->dict);
+    return self->dict;
+}
+
+static int
+green_setdict(PyGreenlet* self, PyObject* val, void* UNUSED(context))
+{
+    PyObject* tmp;
+
+    if (val == NULL) {
+        PyErr_SetString(PyExc_TypeError, "__dict__ may not be deleted");
+        return -1;
+    }
+    if (!PyDict_Check(val)) {
+        PyErr_SetString(PyExc_TypeError, "__dict__ must be a dictionary");
+        return -1;
+    }
+    tmp = self->dict;
+    Py_INCREF(val);
+    self->dict = val;
+    Py_XDECREF(tmp);
+    return 0;
+}
+
+static bool
+_green_not_dead(BorrowedGreenlet self)
+{
+    // XXX: Where else should we do this?
+    // Probably on entry to most Python-facing functions?
+    if (self->was_running_in_dead_thread()) {
+        self->deactivate_and_free();
+        return false;
+    }
+    return self->active() || !self->started();
+}
+
+
+static PyObject*
+green_getdead(BorrowedGreenlet self, void* UNUSED(context))
+{
+    if (_green_not_dead(self)) {
+        Py_RETURN_FALSE;
+    }
+    else {
+        Py_RETURN_TRUE;
+    }
+}
+
+static PyObject*
+green_get_stack_saved(PyGreenlet* self, void* UNUSED(context))
+{
+    return PyLong_FromSsize_t(self->pimpl->stack_saved());
+}
+
+
+static PyObject*
+green_getrun(BorrowedGreenlet self, void* UNUSED(context))
+{
+    try {
+        OwnedObject result(self->run());
+        return result.relinquish_ownership();
+    }
+    catch(const PyErrOccurred&) {
+        return nullptr;
+    }
+}
+
+
+
+
+
+static int
+green_setrun(BorrowedGreenlet self, BorrowedObject nrun, void* UNUSED(context))
+{
+    try {
+        self->run(nrun);
+        return 0;
+    }
+    catch(const PyErrOccurred&) {
+        return -1;
+    }
+}
+
+static PyObject*
+green_getparent(BorrowedGreenlet self, void* UNUSED(context))
+{
+    return self->parent().acquire_or_None();
+}
+
+
+
+static int
+green_setparent(BorrowedGreenlet self, BorrowedObject nparent, void* UNUSED(context))
+{
+    try {
+        self->parent(nparent);
+    }
+    catch(const PyErrOccurred&) {
+        return -1;
+    }
+    return 0;
+}
+
+
+static PyObject*
+green_getcontext(const PyGreenlet* self, void* UNUSED(context))
+{
+    const Greenlet *const g = self->pimpl;
+    try {
+        OwnedObject result(g->context());
+        return result.relinquish_ownership();
+    }
+    catch(const PyErrOccurred&) {
+        return nullptr;
+    }
+}
+
+static int
+green_setcontext(BorrowedGreenlet self, PyObject* nctx, void* UNUSED(context))
+{
+    try {
+        self->context(nctx);
+        return 0;
+    }
+    catch(const PyErrOccurred&) {
+        return -1;
+    }
+}
+
+
+static PyObject*
+green_getframe(BorrowedGreenlet self, void* UNUSED(context))
+{
+    const PythonState::OwnedFrame& top_frame = self->top_frame();
+    return top_frame.acquire_or_None();
+}
+
+
+static PyObject*
+green_getstate(PyGreenlet* self)
+{
+    PyErr_Format(PyExc_TypeError,
+                 "cannot serialize '%s' object",
+                 Py_TYPE(self)->tp_name);
+    return nullptr;
+}
+
+static PyObject*
+green_repr(BorrowedGreenlet self)
+{
+    /*
+      Return a string like
+      <greenlet.greenlet at 0xdeadbeef [current][active started]|dead main>
+
+      The handling of greenlets across threads is not super good.
+      We mostly use the internal definitions of these terms, but they
+      generally should make sense to users as well.
+     */
+    PyObject* result;
+    int never_started = !self->started() && !self->active();
+
+    const char* const tp_name = Py_TYPE(self)->tp_name;
+
+    if (_green_not_dead(self)) {
+        /* XXX: The otid= is almost useless because you can't correlate it to
+         any thread identifier exposed to Python. We could use
+         PyThreadState_GET()->thread_id, but we'd need to save that in the
+         greenlet, or save the whole PyThreadState object itself.
+
+         As it stands, its only useful for identifying greenlets from the same thread.
+        */
+        const char* state_in_thread;
+        if (self->was_running_in_dead_thread()) {
+            // The thread it was running in is dead!
+            // This can happen, especially at interpreter shut down.
+            // It complicates debugging output because it may be
+            // impossible to access the current thread state at that
+            // time. Thus, don't access the current thread state.
+            state_in_thread = " (thread exited)";
+        }
+        else {
+            state_in_thread = GET_THREAD_STATE().state().is_current(self)
+                ? " current"
+                : (self->started() ? " suspended" : "");
+        }
+        result = PyUnicode_FromFormat(
+            "<%s object at %p (otid=%p)%s%s%s%s>",
+            tp_name,
+            self.borrow_o(),
+            self->thread_state(),
+            state_in_thread,
+            self->active() ? " active" : "",
+            never_started ? " pending" : " started",
+            self->main() ? " main" : ""
+        );
+    }
+    else {
+        result = PyUnicode_FromFormat(
+            "<%s object at %p (otid=%p) %sdead>",
+            tp_name,
+            self.borrow_o(),
+            self->thread_state(),
+            self->was_running_in_dead_thread()
+            ? "(thread exited) "
+            : ""
+            );
+    }
+
+    return result;
+}
+
+/*****************************************************************************
+ * C interface
+ *
+ * These are exported using the CObject API
+ */
+extern "C" {
+static PyGreenlet*
+PyGreenlet_GetCurrent(void)
+{
+    return GET_THREAD_STATE().state().get_current().relinquish_ownership();
+}
+
+static int
+PyGreenlet_SetParent(PyGreenlet* g, PyGreenlet* nparent)
+{
+    return green_setparent((PyGreenlet*)g, (PyObject*)nparent, NULL);
+}
+
+static PyGreenlet*
+PyGreenlet_New(PyObject* run, PyGreenlet* parent)
+{
+    using greenlet::refs::NewDictReference;
+    // In the past, we didn't use green_new and green_init, but that
+    // was a maintenance issue because we duplicated code. This way is
+    // much safer, but slightly slower. If that's a problem, we could
+    // refactor green_init to separate argument parsing from initialization.
+    OwnedGreenlet g = OwnedGreenlet::consuming(green_new(&PyGreenlet_Type, nullptr, nullptr));
+    if (!g) {
+        return NULL;
+    }
+
+    try {
+        NewDictReference kwargs;
+        if (run) {
+            kwargs.SetItem(mod_globs->str_run, run);
+        }
+        if (parent) {
+            kwargs.SetItem("parent", (PyObject*)parent);
+        }
+
+        Require(green_init(g, mod_globs->empty_tuple, kwargs));
+    }
+    catch (const PyErrOccurred&) {
+        return nullptr;
+    }
+
+    return g.relinquish_ownership();
+}
+
+static PyObject*
+PyGreenlet_Switch(PyGreenlet* self, PyObject* args, PyObject* kwargs)
+{
+    if (!PyGreenlet_Check(self)) {
+        PyErr_BadArgument();
+        return NULL;
+    }
+
+    if (args == NULL) {
+        args = mod_globs->empty_tuple;
+    }
+
+    if (kwargs == NULL || !PyDict_Check(kwargs)) {
+        kwargs = NULL;
+    }
+
+    return green_switch(self, args, kwargs);
+}
+
+static PyObject*
+PyGreenlet_Throw(PyGreenlet* self, PyObject* typ, PyObject* val, PyObject* tb)
+{
+    if (!PyGreenlet_Check(self)) {
+        PyErr_BadArgument();
+        return nullptr;
+    }
+    try {
+        PyErrPieces err_pieces(typ, val, tb);
+        return throw_greenlet(self, err_pieces).relinquish_ownership();
+    }
+    catch (const PyErrOccurred&) {
+        return nullptr;
+    }
+}
+
+static int
+Extern_PyGreenlet_MAIN(PyGreenlet* self)
+{
+    if (!PyGreenlet_Check(self)) {
+        PyErr_BadArgument();
+        return -1;
+    }
+    return self->pimpl->main();
+}
+
+static int
+Extern_PyGreenlet_ACTIVE(PyGreenlet* self)
+{
+    if (!PyGreenlet_Check(self)) {
+        PyErr_BadArgument();
+        return -1;
+    }
+    return self->pimpl->active();
+}
+
+static int
+Extern_PyGreenlet_STARTED(PyGreenlet* self)
+{
+    if (!PyGreenlet_Check(self)) {
+        PyErr_BadArgument();
+        return -1;
+    }
+    return self->pimpl->started();
+}
+
+static PyGreenlet*
+Extern_PyGreenlet_GET_PARENT(PyGreenlet* self)
+{
+    if (!PyGreenlet_Check(self)) {
+        PyErr_BadArgument();
+        return NULL;
+    }
+    // This can return NULL even if there is no exception
+    return self->pimpl->parent().acquire();
+}
+} // extern C.
+
+/** End C API ****************************************************************/
+
+static PyMethodDef green_methods[] = {
+    {"switch",
+     reinterpret_cast<PyCFunction>(green_switch),
+     METH_VARARGS | METH_KEYWORDS,
+     green_switch_doc},
+    {"throw", (PyCFunction)green_throw, METH_VARARGS, green_throw_doc},
+    {"__getstate__", (PyCFunction)green_getstate, METH_NOARGS, NULL},
+    {NULL, NULL} /* sentinel */
+};
+
+static PyGetSetDef green_getsets[] = {
+    /* name, getter, setter, doc, context pointer */
+    {"__dict__", (getter)green_getdict, (setter)green_setdict, /*XXX*/ NULL},
+    {"run", (getter)green_getrun, (setter)green_setrun, /*XXX*/ NULL},
+    {"parent", (getter)green_getparent, (setter)green_setparent, /*XXX*/ NULL},
+    {"gr_frame", (getter)green_getframe, NULL, /*XXX*/ NULL},
+    {"gr_context",
+     (getter)green_getcontext,
+     (setter)green_setcontext,
+     /*XXX*/ NULL},
+    {"dead", (getter)green_getdead, NULL, /*XXX*/ NULL},
+    {"_stack_saved", (getter)green_get_stack_saved, NULL, /*XXX*/ NULL},
+    {NULL}
+};
+
+static PyMemberDef green_members[] = {
+    {NULL}
+};
+
+static PyNumberMethods green_as_number = {
+    NULL, /* nb_add */
+    NULL, /* nb_subtract */
+    NULL, /* nb_multiply */
+    NULL,                /* nb_remainder */
+    NULL,                /* nb_divmod */
+    NULL,                /* nb_power */
+    NULL,                /* nb_negative */
+    NULL,                /* nb_positive */
+    NULL,                /* nb_absolute */
+    (inquiry)green_bool, /* nb_bool */
+};
+
+
+PyTypeObject PyGreenlet_Type = {
+    PyVarObject_HEAD_INIT(NULL, 0)
+    "greenlet.greenlet", /* tp_name */
+    sizeof(PyGreenlet),  /* tp_basicsize */
+    0,                   /* tp_itemsize */
+    /* methods */
+    (destructor)green_dealloc, /* tp_dealloc */
+    0,                         /* tp_print */
+    0,                         /* tp_getattr */
+    0,                         /* tp_setattr */
+    0,                         /* tp_compare */
+    (reprfunc)green_repr,      /* tp_repr */
+    &green_as_number,          /* tp_as _number*/
+    0,                         /* tp_as _sequence*/
+    0,                         /* tp_as _mapping*/
+    0,                         /* tp_hash */
+    0,                         /* tp_call */
+    0,                         /* tp_str */
+    0,                         /* tp_getattro */
+    0,                         /* tp_setattro */
+    0,                         /* tp_as_buffer*/
+    G_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */
+    "greenlet(run=None, parent=None) -> greenlet\n\n"
+    "Creates a new greenlet object (without running it).\n\n"
+    " - *run* -- The callable to invoke.\n"
+    " - *parent* -- The parent greenlet. The default is the current "
+    "greenlet.",                        /* tp_doc */
+    (traverseproc)green_traverse, /* tp_traverse */
+    (inquiry)green_clear,         /* tp_clear */
+    0,                                  /* tp_richcompare */
+    offsetof(PyGreenlet, weakreflist),  /* tp_weaklistoffset */
+    0,                                  /* tp_iter */
+    0,                                  /* tp_iternext */
+    green_methods,                      /* tp_methods */
+    green_members,                      /* tp_members */
+    green_getsets,                      /* tp_getset */
+    0,                                  /* tp_base */
+    0,                                  /* tp_dict */
+    0,                                  /* tp_descr_get */
+    0,                                  /* tp_descr_set */
+    offsetof(PyGreenlet, dict),         /* tp_dictoffset */
+    (initproc)green_init,               /* tp_init */
+    PyType_GenericAlloc,                  /* tp_alloc */
+    (newfunc)green_new,                          /* tp_new */
+    PyObject_GC_Del,                   /* tp_free */
+    (inquiry)green_is_gc,         /* tp_is_gc */
+};
+
+
+
+static PyObject*
+green_unswitchable_getforce(PyGreenlet* self, void* UNUSED(context))
+{
+    BrokenGreenlet* broken = dynamic_cast<BrokenGreenlet*>(self->pimpl);
+    return PyBool_FromLong(broken->_force_switch_error);
+}
+
+static int
+green_unswitchable_setforce(PyGreenlet* self, BorrowedObject nforce, void* UNUSED(context))
+{
+    if (!nforce) {
+        PyErr_SetString(
+            PyExc_AttributeError,
+            "Cannot delete force_switch_error"
+        );
+        return -1;
+    }
+    BrokenGreenlet* broken = dynamic_cast<BrokenGreenlet*>(self->pimpl);
+    int is_true = PyObject_IsTrue(nforce);
+    if (is_true == -1) {
+        return -1;
+    }
+    broken->_force_switch_error = is_true;
+    return 0;
+}
+
+static PyObject*
+green_unswitchable_getforceslp(PyGreenlet* self, void* UNUSED(context))
+{
+    BrokenGreenlet* broken = dynamic_cast<BrokenGreenlet*>(self->pimpl);
+    return PyBool_FromLong(broken->_force_slp_switch_error);
+}
+
+static int
+green_unswitchable_setforceslp(PyGreenlet* self, BorrowedObject nforce, void* UNUSED(context))
+{
+    if (!nforce) {
+        PyErr_SetString(
+            PyExc_AttributeError,
+            "Cannot delete force_slp_switch_error"
+        );
+        return -1;
+    }
+    BrokenGreenlet* broken = dynamic_cast<BrokenGreenlet*>(self->pimpl);
+    int is_true = PyObject_IsTrue(nforce);
+    if (is_true == -1) {
+        return -1;
+    }
+    broken->_force_slp_switch_error = is_true;
+    return 0;
+}
+
+static PyGetSetDef green_unswitchable_getsets[] = {
+    /* name, getter, setter, doc, context pointer */
+    {"force_switch_error",
+     (getter)green_unswitchable_getforce,
+     (setter)green_unswitchable_setforce,
+     /*XXX*/ NULL},
+    {"force_slp_switch_error",
+     (getter)green_unswitchable_getforceslp,
+     (setter)green_unswitchable_setforceslp,
+     /*XXX*/ NULL},
+
+    {NULL}
+};
+
+PyTypeObject PyGreenletUnswitchable_Type = {
+    PyVarObject_HEAD_INIT(NULL, 0)
+    "greenlet._greenlet.UnswitchableGreenlet",
+    0,  /* tp_basicsize */
+    0,                   /* tp_itemsize */
+    /* methods */
+    (destructor)green_dealloc, /* tp_dealloc */
+    0,                         /* tp_print */
+    0,                         /* tp_getattr */
+    0,                         /* tp_setattr */
+    0,                         /* tp_compare */
+    0,      /* tp_repr */
+    0,          /* tp_as _number*/
+    0,                         /* tp_as _sequence*/
+    0,                         /* tp_as _mapping*/
+    0,                         /* tp_hash */
+    0,                         /* tp_call */
+    0,                         /* tp_str */
+    0,                         /* tp_getattro */
+    0,                         /* tp_setattro */
+    0,                         /* tp_as_buffer*/
+    G_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */
+    "Undocumented internal class",                        /* tp_doc */
+    (traverseproc)green_traverse, /* tp_traverse */
+    (inquiry)green_clear,         /* tp_clear */
+    0,                                  /* tp_richcompare */
+    0,  /* tp_weaklistoffset */
+    0,                                  /* tp_iter */
+    0,                                  /* tp_iternext */
+    0,                      /* tp_methods */
+    0,                      /* tp_members */
+    green_unswitchable_getsets,                      /* tp_getset */
+    &PyGreenlet_Type,                                  /* tp_base */
+    0,                                  /* tp_dict */
+    0,                                  /* tp_descr_get */
+    0,                                  /* tp_descr_set */
+    0,         /* tp_dictoffset */
+    (initproc)green_init,               /* tp_init */
+    PyType_GenericAlloc,                  /* tp_alloc */
+    (newfunc)green_unswitchable_new,                          /* tp_new */
+    PyObject_GC_Del,                   /* tp_free */
+    (inquiry)green_is_gc,         /* tp_is_gc */
+};
+
+
+PyDoc_STRVAR(mod_getcurrent_doc,
+             "getcurrent() -> greenlet\n"
+             "\n"
+             "Returns the current greenlet (i.e. the one which called this "
+             "function).\n");
+
+static PyObject*
+mod_getcurrent(PyObject* UNUSED(module))
+{
+    return GET_THREAD_STATE().state().get_current().relinquish_ownership_o();
+}
+
+PyDoc_STRVAR(mod_settrace_doc,
+             "settrace(callback) -> object\n"
+             "\n"
+             "Sets a new tracing function and returns the previous one.\n");
+static PyObject*
+mod_settrace(PyObject* UNUSED(module), PyObject* args)
+{
+    PyArgParseParam tracefunc;
+    if (!PyArg_ParseTuple(args, "O", &tracefunc)) {
+        return NULL;
+    }
+    ThreadState& state = GET_THREAD_STATE();
+    OwnedObject previous = state.get_tracefunc();
+    if (!previous) {
+        previous = Py_None;
+    }
+
+    state.set_tracefunc(tracefunc);
+
+    return previous.relinquish_ownership();
+}
+
+PyDoc_STRVAR(mod_gettrace_doc,
+             "gettrace() -> object\n"
+             "\n"
+             "Returns the currently set tracing function, or None.\n");
+
+static PyObject*
+mod_gettrace(PyObject* UNUSED(module))
+{
+    OwnedObject tracefunc = GET_THREAD_STATE().state().get_tracefunc();
+    if (!tracefunc) {
+        tracefunc = Py_None;
+    }
+    return tracefunc.relinquish_ownership();
+}
+
+PyDoc_STRVAR(mod_set_thread_local_doc,
+             "set_thread_local(key, value) -> None\n"
+             "\n"
+             "Set a value in the current thread-local dictionary. Debbuging only.\n");
+
+static PyObject*
+mod_set_thread_local(PyObject* UNUSED(module), PyObject* args)
+{
+    PyArgParseParam key;
+    PyArgParseParam value;
+    PyObject* result = NULL;
+
+    if (PyArg_UnpackTuple(args, "set_thread_local", 2, 2, &key, &value)) {
+        if(PyDict_SetItem(
+                          PyThreadState_GetDict(), // borrow
+                          key,
+                          value) == 0 ) {
+            // success
+            Py_INCREF(Py_None);
+            result = Py_None;
+        }
+    }
+    return result;
+}
+
+PyDoc_STRVAR(mod_get_pending_cleanup_count_doc,
+             "get_pending_cleanup_count() -> Integer\n"
+             "\n"
+             "Get the number of greenlet cleanup operations pending. Testing only.\n");
+
+
+static PyObject*
+mod_get_pending_cleanup_count(PyObject* UNUSED(module))
+{
+    LockGuard cleanup_lock(*mod_globs->thread_states_to_destroy_lock);
+    return PyLong_FromSize_t(mod_globs->thread_states_to_destroy.size());
+}
+
+PyDoc_STRVAR(mod_get_total_main_greenlets_doc,
+             "get_total_main_greenlets() -> Integer\n"
+             "\n"
+             "Quickly return the number of main greenlets that exist. Testing only.\n");
+
+static PyObject*
+mod_get_total_main_greenlets(PyObject* UNUSED(module))
+{
+    return PyLong_FromSize_t(G_TOTAL_MAIN_GREENLETS);
+}
+
+PyDoc_STRVAR(mod_get_clocks_used_doing_optional_cleanup_doc,
+             "get_clocks_used_doing_optional_cleanup() -> Integer\n"
+             "\n"
+             "Get the number of clock ticks the program has used doing optional "
+             "greenlet cleanup.\n"
+             "Beginning in greenlet 2.0, greenlet tries to find and dispose of greenlets\n"
+             "that leaked after a thread exited. This requires invoking Python's garbage collector,\n"
+             "which may have a performance cost proportional to the number of live objects.\n"
+             "This function returns the amount of processor time\n"
+             "greenlet has used to do this. In programs that run with very large amounts of live\n"
+             "objects, this metric can be used to decide whether the cost of doing this cleanup\n"
+             "is worth the memory leak being corrected. If not, you can disable the cleanup\n"
+             "using ``enable_optional_cleanup(False)``.\n"
+             "The units are arbitrary and can only be compared to themselves (similarly to ``time.clock()``);\n"
+             "for example, to see how it scales with your heap. You can attempt to convert them into seconds\n"
+             "by dividing by the value of CLOCKS_PER_SEC."
+             "If cleanup has been disabled, returns None."
+             "\n"
+             "This is an implementation specific, provisional API. It may be changed or removed\n"
+             "in the future.\n"
+             ".. versionadded:: 2.0"
+             );
+static PyObject*
+mod_get_clocks_used_doing_optional_cleanup(PyObject* UNUSED(module))
+{
+    std::clock_t& clocks = ThreadState::clocks_used_doing_gc();
+
+    if (clocks == std::clock_t(-1)) {
+        Py_RETURN_NONE;
+    }
+    // This might not actually work on some implementations; clock_t
+    // is an opaque type.
+    return PyLong_FromSsize_t(clocks);
+}
+
+PyDoc_STRVAR(mod_enable_optional_cleanup_doc,
+             "mod_enable_optional_cleanup(bool) -> None\n"
+             "\n"
+             "Enable or disable optional cleanup operations.\n"
+             "See ``get_clocks_used_doing_optional_cleanup()`` for details.\n"
+             );
+static PyObject*
+mod_enable_optional_cleanup(PyObject* UNUSED(module), PyObject* flag)
+{
+    int is_true = PyObject_IsTrue(flag);
+    if (is_true == -1) {
+        return nullptr;
+    }
+
+    std::clock_t& clocks = ThreadState::clocks_used_doing_gc();
+    if (is_true) {
+        // If we already have a value, we don't want to lose it.
+        if (clocks == std::clock_t(-1)) {
+            clocks = 0;
+        }
+    }
+    else {
+        clocks = std::clock_t(-1);
+    }
+    Py_RETURN_NONE;
+}
+
+PyDoc_STRVAR(mod_get_tstate_trash_delete_nesting_doc,
+             "get_tstate_trash_delete_nesting() -> Integer\n"
+             "\n"
+             "Return the 'trash can' nesting level. Testing only.\n");
+static PyObject*
+mod_get_tstate_trash_delete_nesting(PyObject* UNUSED(module))
+{
+    PyThreadState* tstate = PyThreadState_GET();
+
+#if GREENLET_PY312
+    return PyLong_FromLong(tstate->trash.delete_nesting);
+#else
+    return PyLong_FromLong(tstate->trash_delete_nesting);
+#endif
+}
+
+static PyMethodDef GreenMethods[] = {
+    {"getcurrent",
+     (PyCFunction)mod_getcurrent,
+     METH_NOARGS,
+     mod_getcurrent_doc},
+    {"settrace", (PyCFunction)mod_settrace, METH_VARARGS, mod_settrace_doc},
+    {"gettrace", (PyCFunction)mod_gettrace, METH_NOARGS, mod_gettrace_doc},
+    {"set_thread_local", (PyCFunction)mod_set_thread_local, METH_VARARGS, mod_set_thread_local_doc},
+    {"get_pending_cleanup_count", (PyCFunction)mod_get_pending_cleanup_count, METH_NOARGS, mod_get_pending_cleanup_count_doc},
+    {"get_total_main_greenlets", (PyCFunction)mod_get_total_main_greenlets, METH_NOARGS, mod_get_total_main_greenlets_doc},
+    {"get_clocks_used_doing_optional_cleanup", (PyCFunction)mod_get_clocks_used_doing_optional_cleanup, METH_NOARGS, mod_get_clocks_used_doing_optional_cleanup_doc},
+    {"enable_optional_cleanup", (PyCFunction)mod_enable_optional_cleanup, METH_O, mod_enable_optional_cleanup_doc},
+    {"get_tstate_trash_delete_nesting", (PyCFunction)mod_get_tstate_trash_delete_nesting, METH_NOARGS, mod_get_tstate_trash_delete_nesting_doc},
+    {NULL, NULL} /* Sentinel */
+};
+
+static const char* const copy_on_greentype[] = {
+    "getcurrent",
+    "error",
+    "GreenletExit",
+    "settrace",
+    "gettrace",
+    NULL
+};
+
+static struct PyModuleDef greenlet_module_def = {
+    PyModuleDef_HEAD_INIT,
+    "greenlet._greenlet",
+    NULL,
+    -1,
+    GreenMethods,
+};
+
+
+
+static PyObject*
+greenlet_internal_mod_init() noexcept
+{
+    static void* _PyGreenlet_API[PyGreenlet_API_pointers];
+
+    try {
+        CreatedModule m(greenlet_module_def);
+
+        Require(PyType_Ready(&PyGreenlet_Type));
+        Require(PyType_Ready(&PyGreenletUnswitchable_Type));
+
+        mod_globs = new greenlet::GreenletGlobals;
+        ThreadState::init();
+
+        m.PyAddObject("greenlet", PyGreenlet_Type);
+        m.PyAddObject("UnswitchableGreenlet", PyGreenletUnswitchable_Type);
+        m.PyAddObject("error", mod_globs->PyExc_GreenletError);
+        m.PyAddObject("GreenletExit", mod_globs->PyExc_GreenletExit);
+
+        m.PyAddObject("GREENLET_USE_GC", 1);
+        m.PyAddObject("GREENLET_USE_TRACING", 1);
+        m.PyAddObject("GREENLET_USE_CONTEXT_VARS", 1L);
+        m.PyAddObject("GREENLET_USE_STANDARD_THREADING", 1L);
+
+        OwnedObject clocks_per_sec = OwnedObject::consuming(PyLong_FromSsize_t(CLOCKS_PER_SEC));
+        m.PyAddObject("CLOCKS_PER_SEC", clocks_per_sec);
+
+        /* also publish module-level data as attributes of the greentype. */
+        // XXX: This is weird, and enables a strange pattern of
+        // confusing the class greenlet with the module greenlet; with
+        // the exception of (possibly) ``getcurrent()``, this
+        // shouldn't be encouraged so don't add new items here.
+        for (const char* const* p = copy_on_greentype; *p; p++) {
+            OwnedObject o = m.PyRequireAttr(*p);
+            PyDict_SetItemString(PyGreenlet_Type.tp_dict, *p, o.borrow());
+        }
+
+        /*
+         * Expose C API
+         */
+
+        /* types */
+        _PyGreenlet_API[PyGreenlet_Type_NUM] = (void*)&PyGreenlet_Type;
+
+        /* exceptions */
+        _PyGreenlet_API[PyExc_GreenletError_NUM] = (void*)mod_globs->PyExc_GreenletError;
+        _PyGreenlet_API[PyExc_GreenletExit_NUM] = (void*)mod_globs->PyExc_GreenletExit;
+
+        /* methods */
+        _PyGreenlet_API[PyGreenlet_New_NUM] = (void*)PyGreenlet_New;
+        _PyGreenlet_API[PyGreenlet_GetCurrent_NUM] = (void*)PyGreenlet_GetCurrent;
+        _PyGreenlet_API[PyGreenlet_Throw_NUM] = (void*)PyGreenlet_Throw;
+        _PyGreenlet_API[PyGreenlet_Switch_NUM] = (void*)PyGreenlet_Switch;
+        _PyGreenlet_API[PyGreenlet_SetParent_NUM] = (void*)PyGreenlet_SetParent;
+
+        /* Previously macros, but now need to be functions externally. */
+        _PyGreenlet_API[PyGreenlet_MAIN_NUM] = (void*)Extern_PyGreenlet_MAIN;
+        _PyGreenlet_API[PyGreenlet_STARTED_NUM] = (void*)Extern_PyGreenlet_STARTED;
+        _PyGreenlet_API[PyGreenlet_ACTIVE_NUM] = (void*)Extern_PyGreenlet_ACTIVE;
+        _PyGreenlet_API[PyGreenlet_GET_PARENT_NUM] = (void*)Extern_PyGreenlet_GET_PARENT;
+
+        /* XXX: Note that our module name is ``greenlet._greenlet``, but for
+           backwards compatibility with existing C code, we need the _C_API to
+           be directly in greenlet.
+        */
+        const NewReference c_api_object(Require(
+                                           PyCapsule_New(
+                                               (void*)_PyGreenlet_API,
+                                               "greenlet._C_API",
+                                               NULL)));
+        m.PyAddObject("_C_API", c_api_object);
+        assert(c_api_object.REFCNT() == 2);
+
+        // cerr << "Sizes:"
+        //      << "\n\tGreenlet       : " << sizeof(Greenlet)
+        //      << "\n\tUserGreenlet   : " << sizeof(UserGreenlet)
+        //      << "\n\tMainGreenlet   : " << sizeof(MainGreenlet)
+        //      << "\n\tExceptionState : " << sizeof(greenlet::ExceptionState)
+        //      << "\n\tPythonState    : " << sizeof(greenlet::PythonState)
+        //      << "\n\tStackState     : " << sizeof(greenlet::StackState)
+        //      << "\n\tSwitchingArgs  : " << sizeof(greenlet::SwitchingArgs)
+        //      << "\n\tOwnedObject    : " << sizeof(greenlet::refs::OwnedObject)
+        //      << "\n\tBorrowedObject : " << sizeof(greenlet::refs::BorrowedObject)
+        //      << "\n\tPyGreenlet     : " << sizeof(PyGreenlet)
+        //      << endl;
+
+        return m.borrow(); // But really it's the main reference.
+    }
+    catch (const LockInitError& e) {
+        PyErr_SetString(PyExc_MemoryError, e.what());
+        return NULL;
+    }
+    catch (const PyErrOccurred&) {
+        return NULL;
+    }
+
+}
+
+extern "C" {
+
+PyMODINIT_FUNC
+PyInit__greenlet(void)
+{
+    return greenlet_internal_mod_init();
+}
+
+}; // extern C
+
+#ifdef __clang__
+#    pragma clang diagnostic pop
+#elif defined(__GNUC__)
+#    pragma GCC diagnostic pop
+#endif
diff --git a/llm/Lib/site-packages/greenlet/greenlet.h b/llm/Lib/site-packages/greenlet/greenlet.h
new file mode 100644
index 0000000000000000000000000000000000000000..d02a16e43426fb1c1bb286f1cda463cb9b1185ad
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet.h
@@ -0,0 +1,164 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */
+
+/* Greenlet object interface */
+
+#ifndef Py_GREENLETOBJECT_H
+#define Py_GREENLETOBJECT_H
+
+
+#include <Python.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* This is deprecated and undocumented. It does not change. */
+#define GREENLET_VERSION "1.0.0"
+
+#ifndef GREENLET_MODULE
+#define implementation_ptr_t void*
+#endif
+
+typedef struct _greenlet {
+    PyObject_HEAD
+    PyObject* weakreflist;
+    PyObject* dict;
+    implementation_ptr_t pimpl;
+} PyGreenlet;
+
+#define PyGreenlet_Check(op) (op && PyObject_TypeCheck(op, &PyGreenlet_Type))
+
+
+/* C API functions */
+
+/* Total number of symbols that are exported */
+#define PyGreenlet_API_pointers 12
+
+#define PyGreenlet_Type_NUM 0
+#define PyExc_GreenletError_NUM 1
+#define PyExc_GreenletExit_NUM 2
+
+#define PyGreenlet_New_NUM 3
+#define PyGreenlet_GetCurrent_NUM 4
+#define PyGreenlet_Throw_NUM 5
+#define PyGreenlet_Switch_NUM 6
+#define PyGreenlet_SetParent_NUM 7
+
+#define PyGreenlet_MAIN_NUM 8
+#define PyGreenlet_STARTED_NUM 9
+#define PyGreenlet_ACTIVE_NUM 10
+#define PyGreenlet_GET_PARENT_NUM 11
+
+#ifndef GREENLET_MODULE
+/* This section is used by modules that uses the greenlet C API */
+static void** _PyGreenlet_API = NULL;
+
+#    define PyGreenlet_Type \
+        (*(PyTypeObject*)_PyGreenlet_API[PyGreenlet_Type_NUM])
+
+#    define PyExc_GreenletError \
+        ((PyObject*)_PyGreenlet_API[PyExc_GreenletError_NUM])
+
+#    define PyExc_GreenletExit \
+        ((PyObject*)_PyGreenlet_API[PyExc_GreenletExit_NUM])
+
+/*
+ * PyGreenlet_New(PyObject *args)
+ *
+ * greenlet.greenlet(run, parent=None)
+ */
+#    define PyGreenlet_New                                        \
+        (*(PyGreenlet * (*)(PyObject * run, PyGreenlet * parent)) \
+             _PyGreenlet_API[PyGreenlet_New_NUM])
+
+/*
+ * PyGreenlet_GetCurrent(void)
+ *
+ * greenlet.getcurrent()
+ */
+#    define PyGreenlet_GetCurrent \
+        (*(PyGreenlet * (*)(void)) _PyGreenlet_API[PyGreenlet_GetCurrent_NUM])
+
+/*
+ * PyGreenlet_Throw(
+ *         PyGreenlet *greenlet,
+ *         PyObject *typ,
+ *         PyObject *val,
+ *         PyObject *tb)
+ *
+ * g.throw(...)
+ */
+#    define PyGreenlet_Throw                 \
+        (*(PyObject * (*)(PyGreenlet * self, \
+                          PyObject * typ,    \
+                          PyObject * val,    \
+                          PyObject * tb))    \
+             _PyGreenlet_API[PyGreenlet_Throw_NUM])
+
+/*
+ * PyGreenlet_Switch(PyGreenlet *greenlet, PyObject *args)
+ *
+ * g.switch(*args, **kwargs)
+ */
+#    define PyGreenlet_Switch                                              \
+        (*(PyObject *                                                      \
+           (*)(PyGreenlet * greenlet, PyObject * args, PyObject * kwargs)) \
+             _PyGreenlet_API[PyGreenlet_Switch_NUM])
+
+/*
+ * PyGreenlet_SetParent(PyObject *greenlet, PyObject *new_parent)
+ *
+ * g.parent = new_parent
+ */
+#    define PyGreenlet_SetParent                                 \
+        (*(int (*)(PyGreenlet * greenlet, PyGreenlet * nparent)) \
+             _PyGreenlet_API[PyGreenlet_SetParent_NUM])
+
+/*
+ * PyGreenlet_GetParent(PyObject* greenlet)
+ *
+ * return greenlet.parent;
+ *
+ * This could return NULL even if there is no exception active.
+ * If it does not return NULL, you are responsible for decrementing the
+ * reference count.
+ */
+#     define PyGreenlet_GetParent                                    \
+    (*(PyGreenlet* (*)(PyGreenlet*))                                 \
+     _PyGreenlet_API[PyGreenlet_GET_PARENT_NUM])
+
+/*
+ * deprecated, undocumented alias.
+ */
+#     define PyGreenlet_GET_PARENT PyGreenlet_GetParent
+
+#     define PyGreenlet_MAIN                                         \
+    (*(int (*)(PyGreenlet*))                                         \
+     _PyGreenlet_API[PyGreenlet_MAIN_NUM])
+
+#     define PyGreenlet_STARTED                                      \
+    (*(int (*)(PyGreenlet*))                                         \
+     _PyGreenlet_API[PyGreenlet_STARTED_NUM])
+
+#     define PyGreenlet_ACTIVE                                       \
+    (*(int (*)(PyGreenlet*))                                         \
+     _PyGreenlet_API[PyGreenlet_ACTIVE_NUM])
+
+
+
+
+/* Macro that imports greenlet and initializes C API */
+/* NOTE: This has actually moved to ``greenlet._greenlet._C_API``, but we
+   keep the older definition to be sure older code that might have a copy of
+   the header still works. */
+#    define PyGreenlet_Import()                                               \
+        {                                                                     \
+            _PyGreenlet_API = (void**)PyCapsule_Import("greenlet._C_API", 0); \
+        }
+
+#endif /* GREENLET_MODULE */
+
+#ifdef __cplusplus
+}
+#endif
+#endif /* !Py_GREENLETOBJECT_H */
diff --git a/llm/Lib/site-packages/greenlet/greenlet_allocator.hpp b/llm/Lib/site-packages/greenlet/greenlet_allocator.hpp
new file mode 100644
index 0000000000000000000000000000000000000000..b452f5444262fb3553bee15c4692e06d7fac549c
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet_allocator.hpp
@@ -0,0 +1,63 @@
+#ifndef GREENLET_ALLOCATOR_HPP
+#define GREENLET_ALLOCATOR_HPP
+
+#define PY_SSIZE_T_CLEAN
+#include <Python.h>
+#include <memory>
+#include "greenlet_compiler_compat.hpp"
+
+
+namespace greenlet
+{
+    // This allocator is stateless; all instances are identical.
+    // It can *ONLY* be used when we're sure we're holding the GIL
+    // (Python's allocators require the GIL).
+    template <class T>
+    struct PythonAllocator : public std::allocator<T> {
+
+        PythonAllocator(const PythonAllocator& UNUSED(other))
+            : std::allocator<T>()
+        {
+        }
+
+        PythonAllocator(const std::allocator<T> other)
+            : std::allocator<T>(other)
+        {}
+
+        template <class U>
+        PythonAllocator(const std::allocator<U>& other)
+            : std::allocator<T>(other)
+        {
+        }
+
+        PythonAllocator() : std::allocator<T>() {}
+
+        T* allocate(size_t number_objects, const void* UNUSED(hint)=0)
+        {
+            void* p;
+            if (number_objects == 1)
+                p = PyObject_Malloc(sizeof(T));
+            else
+                p = PyMem_Malloc(sizeof(T) * number_objects);
+            return static_cast<T*>(p);
+        }
+
+        void deallocate(T* t, size_t n)
+        {
+            void* p = t;
+            if (n == 1) {
+                PyObject_Free(p);
+            }
+            else
+                PyMem_Free(p);
+        }
+        // This member is deprecated in C++17 and removed in C++20
+        template< class U >
+        struct rebind {
+            typedef PythonAllocator<U> other;
+        };
+
+    };
+}
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/greenlet_compiler_compat.hpp b/llm/Lib/site-packages/greenlet/greenlet_compiler_compat.hpp
new file mode 100644
index 0000000000000000000000000000000000000000..ee5bbdd20541578e94730a88c8bef2c2ca1b4e95
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet_compiler_compat.hpp
@@ -0,0 +1,95 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */
+#ifndef GREENLET_COMPILER_COMPAT_HPP
+#define GREENLET_COMPILER_COMPAT_HPP
+
+/**
+ * Definitions to aid with compatibility with different compilers.
+ *
+ * .. caution:: Use extreme care with noexcept.
+ * Some compilers and runtimes, specifically gcc/libgcc/libstdc++ on
+ * Linux, implement stack unwinding by throwing an uncatchable
+ * exception, one that specifically does not appear to be an active
+ * exception to the rest of the runtime. If this happens while we're in a noexcept function,
+ * we have violated our dynamic exception contract, and so the runtime
+ * will call std::terminate(), which kills the process with the
+ * unhelpful message "terminate called without an active exception".
+ *
+ * This has happened in this scenario: A background thread is running
+ * a greenlet that has made a native call and released the GIL.
+ * Meanwhile, the main thread finishes and starts shutting down the
+ * interpreter. When the background thread is scheduled again and
+ * attempts to obtain the  GIL, it notices that the interpreter is
+ * exiting and calls ``pthread_exit()``. This in turn starts to unwind
+ * the stack by throwing that exception. But we had the ``PyCall``
+ * functions annotated as noexcept, so the runtime terminated us.
+ *
+ * #2  0x00007fab26fec2b7 in std::terminate() () from /lib/x86_64-linux-gnu/libstdc++.so.6
+ * #3  0x00007fab26febb3c in __gxx_personality_v0 () from /lib/x86_64-linux-gnu/libstdc++.so.6
+ * #4  0x00007fab26f34de6 in ?? () from /lib/x86_64-linux-gnu/libgcc_s.so.1
+ * #6  0x00007fab276a34c6 in __GI___pthread_unwind  at ./nptl/unwind.c:130
+ * #7  0x00007fab2769bd3a in __do_cancel () at ../sysdeps/nptl/pthreadP.h:280
+ * #8  __GI___pthread_exit (value=value@entry=0x0) at ./nptl/pthread_exit.c:36
+ * #9  0x000000000052e567 in PyThread_exit_thread () at ../Python/thread_pthread.h:370
+ * #10 0x00000000004d60b5 in take_gil at ../Python/ceval_gil.h:224
+ * #11 0x00000000004d65f9 in PyEval_RestoreThread  at ../Python/ceval.c:467
+ * #12 0x000000000060cce3 in setipaddr  at ../Modules/socketmodule.c:1203
+ * #13 0x00000000006101cd in socket_gethostbyname
+ */
+
+#include <cstdint>
+
+# if defined(__clang__)
+#  define G_FP_TMPL_STATIC static
+# else
+// GCC has no problem allowing static function pointers, but emits
+// tons of warnings about "whose type uses the anonymous namespace [-Wsubobject-linkage]"
+#  define G_FP_TMPL_STATIC
+# endif
+
+#    define G_NO_COPIES_OF_CLS(Cls) private:     \
+    Cls(const Cls& other) = delete; \
+    Cls& operator=(const Cls& other) = delete
+
+#    define G_NO_ASSIGNMENT_OF_CLS(Cls) private:  \
+    Cls& operator=(const Cls& other) = delete
+
+#    define G_NO_COPY_CONSTRUCTOR_OF_CLS(Cls) private: \
+    Cls(const Cls& other) = delete;
+
+
+// CAUTION: MSVC is stupidly picky:
+//
+// "The compiler ignores, without warning, any __declspec keywords
+// placed after * or & and in front of the variable identifier in a
+// declaration."
+// (https://docs.microsoft.com/en-us/cpp/cpp/declspec?view=msvc-160)
+//
+// So pointer return types must be handled differently (because of the
+// trailing *), or you get inscrutable compiler warnings like "error
+// C2059: syntax error: ''"
+//
+// In C++ 11, there is a standard syntax for attributes, and
+// GCC defines an attribute to use with this: [[gnu:noinline]].
+// In the future, this is expected to become standard.
+
+#if defined(__GNUC__) || defined(__clang__)
+/* We used to check for GCC 4+ or 3.4+, but those compilers are
+   laughably out of date. Just assume they support it. */
+#    define GREENLET_NOINLINE(name) __attribute__((noinline)) name
+#    define GREENLET_NOINLINE_P(rtype, name) rtype __attribute__((noinline)) name
+#    define UNUSED(x) UNUSED_ ## x __attribute__((__unused__))
+#elif defined(_MSC_VER)
+/* We used to check for  && (_MSC_VER >= 1300) but that's also out of date. */
+#    define GREENLET_NOINLINE(name) __declspec(noinline) name
+#    define GREENLET_NOINLINE_P(rtype, name) __declspec(noinline) rtype name
+#    define UNUSED(x) UNUSED_ ## x
+#endif
+
+#if defined(_MSC_VER)
+#    define G_NOEXCEPT_WIN32 noexcept
+#else
+#    define G_NOEXCEPT_WIN32
+#endif
+
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/greenlet_cpython_add_pending.hpp b/llm/Lib/site-packages/greenlet/greenlet_cpython_add_pending.hpp
new file mode 100644
index 0000000000000000000000000000000000000000..0d28efd3d2b045558497f9981d33c94a777f73b7
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet_cpython_add_pending.hpp
@@ -0,0 +1,172 @@
+#ifndef GREENLET_CPYTHON_ADD_PENDING_HPP
+#define GREENLET_CPYTHON_ADD_PENDING_HPP
+
+#if (PY_VERSION_HEX >= 0x30800A0 && PY_VERSION_HEX < 0x3090000) && !(defined(_WIN32) || defined(WIN32))
+// XXX: From Python 3.8a3 [1] up until Python 3.9a6 [2][3],
+// ``Py_AddPendingCall`` would try to produce a Python exception if
+// the interpreter was in the beginning of shutting down when this
+// function is called. However, ``Py_AddPendingCall`` doesn't require
+// the GIL, and we are absolutely not holding it when we make that
+// call. That means that trying to create the Python exception is
+// using the C API in an undefined state; here the C API detects this
+// and aborts the process with an error ("Fatal Python error: Python
+// memory allocator called without holding the GIL": Add ->
+// PyErr_SetString -> PyUnicode_New -> PyObject_Malloc). This arises
+// (obviously) in multi-threaded programs and happens if one thread is
+// exiting and cleaning up its thread-local data while the other
+// thread is trying to shut down the interpreter. A crash on shutdown
+// is still a crash and could result in data loss (e.g., daemon
+// threads are still running, pending signal handlers may be present,
+// buffers may not be flushed, there may be __del__ that need run,
+// etc), so we have to work around it.
+//
+// Of course, we can (and do) check for whether the interpreter is
+// shutting down before calling ``Py_AddPendingCall``, but that's a
+// race condition since we don't hold the GIL, and so we may not
+// actually get the right answer. Plus, ``Py_FinalizeEx`` actually
+// calls ``_Py_FinishPendingCalls`` (which sets the pending->finishing
+// flag, which is used to gate creating the exceptioen) *before*
+// publishing any other data that would let us detect the shutdown
+// (such as runtime->finalizing). So that point is moot.
+//
+// Our solution for those versions is to inline the same code, without
+// the problematic bit that sets the exception. Unfortunately, all of
+// the structure definitions are private/opaque, *and* we can't
+// actually count on being able to include their definitions from
+// ``internal/pycore_*``, because on some platforms those header files
+// are incomplete (i.e., on macOS with macports 3.8, the includes are
+// fine, but on Ubuntu jammy with 3.8 from ppa:deadsnakes or GitHub
+// Actions 3.8 (I think it's Ubuntu 18.04), they con't be used; at
+// least, I couldn't get them to work). So we need to define the
+// structures and _PyRuntime data member ourself. Yet more
+// unfortunately, _PyRuntime  won't link on Windows, so we can only do
+// this on other platforms.
+//
+// [1] https://github.com/python/cpython/commit/842a2f07f2f08a935ef470bfdaeef40f87490cfc
+// [2] https://github.com/python/cpython/commit/cfc3c2f8b34d3864717ab584c5b6c260014ba55a
+// [3] https://github.com/python/cpython/issues/81308
+# define GREENLET_BROKEN_PY_ADD_PENDING 1
+
+// When defining these structures, the important thing is to get
+// binary compatibility, i.e., structure layout. For that, we only
+// need to define fields up to the ones we use; after that they're
+// irrelevant UNLESS the structure is included in another structure
+// *before* the structure we're interested in --- in that case, it
+// must be complete. Ellipsis indicate elided trailing members.
+// Pointer types are changed to void* to keep from having to define
+// more structures.
+
+// From "internal/pycore_atomic.h"
+
+// There are several different definitions of this, including the
+// plain ``int`` version, a ``volatile int`` and an ``_Atomic int``
+// I don't think any of those change the size/layout.
+typedef struct _Py_atomic_int {
+    volatile int _value;
+} _Py_atomic_int;
+
+// This needs too much infrastructure, so we just do a regular store.
+#define _Py_atomic_store_relaxed(ATOMIC_VAL, NEW_VAL) \
+    (ATOMIC_VAL)->_value = NEW_VAL
+
+
+
+// From "internal/pycore_pymem.h"
+#define NUM_GENERATIONS 3
+
+
+struct gc_generation {
+    PyGC_Head head; // We already have this defined.
+    int threshold;
+    int count;
+};
+struct gc_generation_stats {
+    Py_ssize_t collections;
+    Py_ssize_t collected;
+    Py_ssize_t uncollectable;
+};
+
+struct _gc_runtime_state {
+    void *trash_delete_later;
+    int trash_delete_nesting;
+    int enabled;
+    int debug;
+    struct gc_generation generations[NUM_GENERATIONS];
+    void *generation0;
+    struct gc_generation permanent_generation;
+    struct gc_generation_stats generation_stats[NUM_GENERATIONS];
+    int collecting;
+    void *garbage;
+    void *callbacks;
+    Py_ssize_t long_lived_total;
+    Py_ssize_t long_lived_pending;
+};
+
+// From "internal/pycore_pystate.h"
+struct _pending_calls {
+    int finishing;
+    PyThread_type_lock lock;
+    _Py_atomic_int calls_to_do;
+    int async_exc;
+#define NPENDINGCALLS 32
+    struct {
+        int (*func)(void *);
+        void *arg;
+    } calls[NPENDINGCALLS];
+    int first;
+    int last;
+};
+
+struct _ceval_runtime_state {
+    int recursion_limit;
+    int tracing_possible;
+    _Py_atomic_int eval_breaker;
+    _Py_atomic_int gil_drop_request;
+    struct _pending_calls pending;
+    // ...
+};
+
+typedef struct pyruntimestate {
+    int preinitializing;
+    int preinitialized;
+    int core_initialized;
+    int initialized;
+    void *finalizing;
+
+    struct pyinterpreters {
+        PyThread_type_lock mutex;
+        void *head;
+        void *main;
+        int64_t next_id;
+    } interpreters;
+    // XXX Remove this field once we have a tp_* slot.
+    struct _xidregistry {
+        PyThread_type_lock mutex;
+        void *head;
+    } xidregistry;
+
+    unsigned long main_thread;
+
+#define NEXITFUNCS 32
+    void (*exitfuncs[NEXITFUNCS])(void);
+    int nexitfuncs;
+
+    struct _gc_runtime_state gc;
+    struct _ceval_runtime_state ceval;
+    // ...
+} _PyRuntimeState;
+
+#define SIGNAL_PENDING_CALLS(ceval) \
+    do { \
+        _Py_atomic_store_relaxed(&(ceval)->pending.calls_to_do, 1); \
+        _Py_atomic_store_relaxed(&(ceval)->eval_breaker, 1); \
+    } while (0)
+
+extern _PyRuntimeState _PyRuntime;
+
+#else
+# define GREENLET_BROKEN_PY_ADD_PENDING 0
+#endif
+
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/greenlet_cpython_compat.hpp b/llm/Lib/site-packages/greenlet/greenlet_cpython_compat.hpp
new file mode 100644
index 0000000000000000000000000000000000000000..cdc1617f6788957cc575e852dcdb9a917e07ee54
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet_cpython_compat.hpp
@@ -0,0 +1,127 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */
+#ifndef GREENLET_CPYTHON_COMPAT_H
+#define GREENLET_CPYTHON_COMPAT_H
+
+/**
+ * Helpers for compatibility with multiple versions of CPython.
+ */
+
+#define PY_SSIZE_T_CLEAN
+#include "Python.h"
+
+
+#if PY_VERSION_HEX >= 0x30A00B1
+#    define GREENLET_PY310 1
+/*
+Python 3.10 beta 1 changed tstate->use_tracing to a nested cframe member.
+See https://github.com/python/cpython/pull/25276
+We have to save and restore this as well.
+*/
+#    define GREENLET_USE_CFRAME 1
+#else
+#    define GREENLET_USE_CFRAME 0
+#    define GREENLET_PY310 0
+#endif
+
+
+
+#if PY_VERSION_HEX >= 0x30B00A4
+/*
+Greenlet won't compile on anything older than Python 3.11 alpha 4 (see
+https://bugs.python.org/issue46090). Summary of breaking internal changes:
+- Python 3.11 alpha 1 changed how frame objects are represented internally.
+  - https://github.com/python/cpython/pull/30122
+- Python 3.11 alpha 3 changed how recursion limits are stored.
+  - https://github.com/python/cpython/pull/29524
+- Python 3.11 alpha 4 changed how exception state is stored. It also includes a
+  change to help greenlet save and restore the interpreter frame "data stack".
+  - https://github.com/python/cpython/pull/30122
+  - https://github.com/python/cpython/pull/30234
+*/
+#    define GREENLET_PY311 1
+#else
+#    define GREENLET_PY311 0
+#endif
+
+
+#if PY_VERSION_HEX >= 0x30C0000
+#    define GREENLET_PY312 1
+#else
+#    define GREENLET_PY312 0
+#endif
+
+#ifndef Py_SET_REFCNT
+/* Py_REFCNT and Py_SIZE macros are converted to functions
+https://bugs.python.org/issue39573 */
+#    define Py_SET_REFCNT(obj, refcnt) Py_REFCNT(obj) = (refcnt)
+#endif
+
+#ifndef _Py_DEC_REFTOTAL
+/* _Py_DEC_REFTOTAL macro has been removed from Python 3.9 by:
+  https://github.com/python/cpython/commit/49932fec62c616ec88da52642339d83ae719e924
+
+  The symbol we use to replace it was removed by at least 3.12.
+*/
+#    ifdef Py_REF_DEBUG
+#      if GREENLET_PY312
+#         define _Py_DEC_REFTOTAL
+#      else
+#        define _Py_DEC_REFTOTAL _Py_RefTotal--
+#      endif
+#    else
+#        define _Py_DEC_REFTOTAL
+#    endif
+#endif
+// Define these flags like Cython does if we're on an old version.
+#ifndef Py_TPFLAGS_CHECKTYPES
+  #define Py_TPFLAGS_CHECKTYPES 0
+#endif
+#ifndef Py_TPFLAGS_HAVE_INDEX
+  #define Py_TPFLAGS_HAVE_INDEX 0
+#endif
+#ifndef Py_TPFLAGS_HAVE_NEWBUFFER
+  #define Py_TPFLAGS_HAVE_NEWBUFFER 0
+#endif
+
+#ifndef Py_TPFLAGS_HAVE_VERSION_TAG
+   #define Py_TPFLAGS_HAVE_VERSION_TAG 0
+#endif
+
+#define G_TPFLAGS_DEFAULT Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_VERSION_TAG | Py_TPFLAGS_CHECKTYPES | Py_TPFLAGS_HAVE_NEWBUFFER | Py_TPFLAGS_HAVE_GC
+
+
+#if PY_VERSION_HEX < 0x03090000
+// The official version only became available in 3.9
+#    define PyObject_GC_IsTracked(o) _PyObject_GC_IS_TRACKED(o)
+#endif
+
+
+// bpo-43760 added PyThreadState_EnterTracing() to Python 3.11.0a2
+#if PY_VERSION_HEX < 0x030B00A2 && !defined(PYPY_VERSION)
+static inline void PyThreadState_EnterTracing(PyThreadState *tstate)
+{
+    tstate->tracing++;
+#if PY_VERSION_HEX >= 0x030A00A1
+    tstate->cframe->use_tracing = 0;
+#else
+    tstate->use_tracing = 0;
+#endif
+}
+#endif
+
+// bpo-43760 added PyThreadState_LeaveTracing() to Python 3.11.0a2
+#if PY_VERSION_HEX < 0x030B00A2 && !defined(PYPY_VERSION)
+static inline void PyThreadState_LeaveTracing(PyThreadState *tstate)
+{
+    tstate->tracing--;
+    int use_tracing = (tstate->c_tracefunc != NULL
+                       || tstate->c_profilefunc != NULL);
+#if PY_VERSION_HEX >= 0x030A00A1
+    tstate->cframe->use_tracing = use_tracing;
+#else
+    tstate->use_tracing = use_tracing;
+#endif
+}
+#endif
+
+#endif /* GREENLET_CPYTHON_COMPAT_H */
diff --git a/llm/Lib/site-packages/greenlet/greenlet_exceptions.hpp b/llm/Lib/site-packages/greenlet/greenlet_exceptions.hpp
new file mode 100644
index 0000000000000000000000000000000000000000..3807018bdc6dedbd808afc9d197b29ba5733a7fa
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet_exceptions.hpp
@@ -0,0 +1,150 @@
+#ifndef GREENLET_EXCEPTIONS_HPP
+#define GREENLET_EXCEPTIONS_HPP
+
+#define PY_SSIZE_T_CLEAN
+#include <Python.h>
+#include <stdexcept>
+#include <string>
+
+#ifdef __clang__
+#    pragma clang diagnostic push
+#    pragma clang diagnostic ignored "-Wunused-function"
+#endif
+
+namespace greenlet {
+
+    class PyErrOccurred : public std::runtime_error
+    {
+    public:
+
+        // CAUTION: In debug builds, may run arbitrary Python code.
+        static const PyErrOccurred
+        from_current()
+        {
+            assert(PyErr_Occurred());
+#ifndef NDEBUG
+            // This is not exception safe, and
+            // not necessarily safe in general (what if it switches?)
+            // But we only do this in debug mode, where we are in
+            // tight control of what exceptions are getting raised and
+            // can prevent those issues.
+
+            // You can't call PyObject_Str with a pending exception.
+            PyObject* typ;
+            PyObject* val;
+            PyObject* tb;
+
+            PyErr_Fetch(&typ, &val, &tb);
+            PyObject* typs = PyObject_Str(typ);
+            PyObject* vals = PyObject_Str(val ? val : typ);
+            const char* typ_msg = PyUnicode_AsUTF8(typs);
+            const char* val_msg = PyUnicode_AsUTF8(vals);
+            PyErr_Restore(typ, val, tb);
+
+            std::string msg(typ_msg);
+            msg += ": ";
+            msg += val_msg;
+            PyErrOccurred ex(msg);
+            Py_XDECREF(typs);
+            Py_XDECREF(vals);
+
+            return ex;
+#else
+            return PyErrOccurred();
+#endif
+        }
+
+        PyErrOccurred() : std::runtime_error("")
+        {
+            assert(PyErr_Occurred());
+        }
+
+        PyErrOccurred(const std::string& msg) : std::runtime_error(msg)
+        {
+            assert(PyErr_Occurred());
+        }
+
+        PyErrOccurred(PyObject* exc_kind, const char* const msg)
+            : std::runtime_error(msg)
+        {
+            PyErr_SetString(exc_kind, msg);
+        }
+
+        PyErrOccurred(PyObject* exc_kind, const std::string msg)
+            : std::runtime_error(msg)
+        {
+            // This copies the c_str, so we don't have any lifetime
+            // issues to worry about.
+            PyErr_SetString(exc_kind, msg.c_str());
+        }
+    };
+
+    class TypeError : public PyErrOccurred
+    {
+    public:
+        TypeError(const char* const what)
+            : PyErrOccurred(PyExc_TypeError, what)
+        {
+        }
+        TypeError(const std::string what)
+            : PyErrOccurred(PyExc_TypeError, what)
+        {
+        }
+    };
+
+    class ValueError : public PyErrOccurred
+    {
+    public:
+        ValueError(const char* const what)
+            : PyErrOccurred(PyExc_ValueError, what)
+        {
+        }
+    };
+
+    class AttributeError : public PyErrOccurred
+    {
+    public:
+        AttributeError(const char* const what)
+            : PyErrOccurred(PyExc_AttributeError, what)
+        {
+        }
+    };
+
+    /**
+     * Calls `Py_FatalError` when constructed, so you can't actually
+     * throw this. It just makes static analysis easier.
+     */
+    class PyFatalError : public std::runtime_error
+    {
+    public:
+        PyFatalError(const char* const msg)
+            : std::runtime_error(msg)
+        {
+            Py_FatalError(msg);
+        }
+    };
+
+    static inline PyObject*
+    Require(PyObject* p, const std::string& msg="")
+    {
+        if (!p) {
+            throw PyErrOccurred(msg);
+        }
+        return p;
+    };
+
+    static inline void
+    Require(const int retval)
+    {
+        if (retval < 0) {
+            throw PyErrOccurred();
+        }
+    };
+
+
+};
+#ifdef __clang__
+#    pragma clang diagnostic pop
+#endif
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/greenlet_greenlet.hpp b/llm/Lib/site-packages/greenlet/greenlet_greenlet.hpp
new file mode 100644
index 0000000000000000000000000000000000000000..d52ce1fddeab27d1e27e3ce72d771b72f1258515
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet_greenlet.hpp
@@ -0,0 +1,805 @@
+#ifndef GREENLET_GREENLET_HPP
+#define GREENLET_GREENLET_HPP
+/*
+ * Declarations of the core data structures.
+*/
+
+#define PY_SSIZE_T_CLEAN
+#include <Python.h>
+
+#include "greenlet_compiler_compat.hpp"
+#include "greenlet_refs.hpp"
+#include "greenlet_cpython_compat.hpp"
+#include "greenlet_allocator.hpp"
+
+using greenlet::refs::OwnedObject;
+using greenlet::refs::OwnedGreenlet;
+using greenlet::refs::OwnedMainGreenlet;
+using greenlet::refs::BorrowedGreenlet;
+
+#if PY_VERSION_HEX < 0x30B00A6
+#  define _PyCFrame CFrame
+#  define _PyInterpreterFrame _interpreter_frame
+#endif
+
+#if GREENLET_PY312
+#  include "internal/pycore_frame.h"
+#endif
+
+// XXX: TODO: Work to remove all virtual functions
+// for speed of calling and size of objects (no vtable).
+// One pattern is the Curiously Recurring Template
+namespace greenlet
+{
+    class ExceptionState
+    {
+    private:
+        G_NO_COPIES_OF_CLS(ExceptionState);
+
+        // Even though these are borrowed objects, we actually own
+        // them, when they're not null.
+        // XXX: Express that in the API.
+    private:
+        _PyErr_StackItem* exc_info;
+        _PyErr_StackItem exc_state;
+    public:
+        ExceptionState();
+        void operator<<(const PyThreadState *const tstate) noexcept;
+        void operator>>(PyThreadState* tstate) noexcept;
+        void clear() noexcept;
+
+        int tp_traverse(visitproc visit, void* arg) noexcept;
+        void tp_clear() noexcept;
+    };
+
+    template<typename T>
+    void operator<<(const PyThreadState *const tstate, T& exc);
+
+    class PythonStateContext
+    {
+    protected:
+        greenlet::refs::OwnedContext _context;
+    public:
+        inline const greenlet::refs::OwnedContext& context() const
+        {
+            return this->_context;
+        }
+        inline greenlet::refs::OwnedContext& context()
+        {
+            return this->_context;
+        }
+
+        inline void tp_clear()
+        {
+            this->_context.CLEAR();
+        }
+
+        template<typename T>
+        inline static PyObject* context(T* tstate)
+        {
+            return tstate->context;
+        }
+
+        template<typename T>
+        inline static void context(T* tstate, PyObject* new_context)
+        {
+            tstate->context = new_context;
+            tstate->context_ver++;
+        }
+    };
+    class SwitchingArgs;
+    class PythonState : public PythonStateContext
+    {
+    public:
+        typedef greenlet::refs::OwnedReference<struct _frame> OwnedFrame;
+    private:
+        G_NO_COPIES_OF_CLS(PythonState);
+        // We own this if we're suspended (although currently we don't
+        // tp_traverse into it; that's a TODO). If we're running, it's
+        // empty. If we get deallocated and *still* have a frame, it
+        // won't be reachable from the place that normally decref's
+        // it, so we need to do it (hence owning it).
+        OwnedFrame _top_frame;
+#if GREENLET_USE_CFRAME
+        _PyCFrame* cframe;
+        int use_tracing;
+#endif
+#if GREENLET_PY312
+        int py_recursion_depth;
+        int c_recursion_depth;
+#else
+        int recursion_depth;
+#endif
+        int trash_delete_nesting;
+#if GREENLET_PY311
+        _PyInterpreterFrame* current_frame;
+        _PyStackChunk* datastack_chunk;
+        PyObject** datastack_top;
+        PyObject** datastack_limit;
+#endif
+        // The PyInterpreterFrame list on 3.12+ contains some entries that are
+        // on the C stack, which can't be directly accessed while a greenlet is
+        // suspended. In order to keep greenlet gr_frame introspection working,
+        // we adjust stack switching to rewrite the interpreter frame list
+        // to skip these C-stack frames; we call this "exposing" the greenlet's
+        // frames because it makes them valid to work with in Python. Then when
+        // the greenlet is resumed we need to remember to reverse the operation
+        // we did. The C-stack frames are "entry frames" which are a low-level
+        // interpreter detail; they're not needed for introspection, but do
+        // need to be present for the eval loop to work.
+        void unexpose_frames();
+
+    public:
+
+        PythonState();
+        // You can use this for testing whether we have a frame
+        // or not. It returns const so they can't modify it.
+        const OwnedFrame& top_frame() const noexcept;
+
+        inline void operator<<(const PyThreadState *const tstate) noexcept;
+        inline void operator>>(PyThreadState* tstate) noexcept;
+        void clear() noexcept;
+
+        int tp_traverse(visitproc visit, void* arg, bool visit_top_frame) noexcept;
+        void tp_clear(bool own_top_frame) noexcept;
+        void set_initial_state(const PyThreadState* const tstate) noexcept;
+#if GREENLET_USE_CFRAME
+        void set_new_cframe(_PyCFrame& frame) noexcept;
+#endif
+
+        inline void may_switch_away() noexcept;
+        inline void will_switch_from(PyThreadState *const origin_tstate) noexcept;
+        void did_finish(PyThreadState* tstate) noexcept;
+    };
+
+    class StackState
+    {
+        // By having only plain C (POD) members, no virtual functions
+        // or bases, we get a trivial assignment operator generated
+        // for us. However, that's not safe since we do manage memory.
+        // So we declare an assignment operator that only works if we
+        // don't have any memory allocated. (We don't use
+        // std::shared_ptr for reference counting just to keep this
+        // object small)
+    private:
+        char* _stack_start;
+        char* stack_stop;
+        char* stack_copy;
+        intptr_t _stack_saved;
+        StackState* stack_prev;
+        inline int copy_stack_to_heap_up_to(const char* const stop) noexcept;
+        inline void free_stack_copy() noexcept;
+
+    public:
+        /**
+         * Creates a started, but inactive, state, using *current*
+         * as the previous.
+         */
+        StackState(void* mark, StackState& current);
+        /**
+         * Creates an inactive, unstarted, state.
+         */
+        StackState();
+        ~StackState();
+        StackState(const StackState& other);
+        StackState& operator=(const StackState& other);
+        inline void copy_heap_to_stack(const StackState& current) noexcept;
+        inline int copy_stack_to_heap(char* const stackref, const StackState& current) noexcept;
+        inline bool started() const noexcept;
+        inline bool main() const noexcept;
+        inline bool active() const noexcept;
+        inline void set_active() noexcept;
+        inline void set_inactive() noexcept;
+        inline intptr_t stack_saved() const noexcept;
+        inline char* stack_start() const noexcept;
+        static inline StackState make_main() noexcept;
+#ifdef GREENLET_USE_STDIO
+        friend std::ostream& operator<<(std::ostream& os, const StackState& s);
+#endif
+
+        // Fill in [dest, dest + n) with the values that would be at
+        // [src, src + n) while this greenlet is running. This is like memcpy
+        // except that if the greenlet is suspended it accounts for the portion
+        // of the greenlet's stack that was spilled to the heap. `src` may
+        // be on this greenlet's stack, or on the heap, but not on a different
+        // greenlet's stack.
+        void copy_from_stack(void* dest, const void* src, size_t n) const;
+    };
+#ifdef GREENLET_USE_STDIO
+    std::ostream& operator<<(std::ostream& os, const StackState& s);
+#endif
+
+    class SwitchingArgs
+    {
+    private:
+        G_NO_ASSIGNMENT_OF_CLS(SwitchingArgs);
+        // If args and kwargs are both false (NULL), this is a *throw*, not a
+        // switch. PyErr_... must have been called already.
+        OwnedObject _args;
+        OwnedObject _kwargs;
+    public:
+
+        SwitchingArgs()
+        {}
+
+        SwitchingArgs(const OwnedObject& args, const OwnedObject& kwargs)
+            : _args(args),
+              _kwargs(kwargs)
+        {}
+
+        SwitchingArgs(const SwitchingArgs& other)
+            : _args(other._args),
+              _kwargs(other._kwargs)
+        {}
+
+        const OwnedObject& args()
+        {
+            return this->_args;
+        }
+
+        const OwnedObject& kwargs()
+        {
+            return this->_kwargs;
+        }
+
+        /**
+         * Moves ownership from the argument to this object.
+         */
+        SwitchingArgs& operator<<=(SwitchingArgs& other)
+        {
+            if (this != &other) {
+                this->_args = other._args;
+                this->_kwargs = other._kwargs;
+                other.CLEAR();
+            }
+            return *this;
+        }
+
+        /**
+         * Acquires ownership of the argument (consumes the reference).
+         */
+        SwitchingArgs& operator<<=(PyObject* args)
+        {
+            this->_args = OwnedObject::consuming(args);
+            this->_kwargs.CLEAR();
+            return *this;
+        }
+
+        /**
+         * Acquires ownership of the argument.
+         *
+         * Sets the args to be the given value; clears the kwargs.
+         */
+        SwitchingArgs& operator<<=(OwnedObject& args)
+        {
+            assert(&args != &this->_args);
+            this->_args = args;
+            this->_kwargs.CLEAR();
+            args.CLEAR();
+
+            return *this;
+        }
+
+        explicit operator bool() const noexcept
+        {
+            return this->_args || this->_kwargs;
+        }
+
+        inline void CLEAR()
+        {
+            this->_args.CLEAR();
+            this->_kwargs.CLEAR();
+        }
+
+        const std::string as_str() const noexcept
+        {
+            return PyUnicode_AsUTF8(
+                OwnedObject::consuming(
+                    PyUnicode_FromFormat(
+                        "SwitchingArgs(args=%R, kwargs=%R)",
+                        this->_args.borrow(),
+                        this->_kwargs.borrow()
+                    )
+                ).borrow()
+            );
+        }
+    };
+
+    class ThreadState;
+
+    class UserGreenlet;
+    class MainGreenlet;
+
+    class Greenlet
+    {
+    private:
+        G_NO_COPIES_OF_CLS(Greenlet);
+    private:
+        // XXX: Work to remove these.
+        friend class ThreadState;
+        friend class UserGreenlet;
+        friend class MainGreenlet;
+    protected:
+        ExceptionState exception_state;
+        SwitchingArgs switch_args;
+        StackState stack_state;
+        PythonState python_state;
+        Greenlet(PyGreenlet* p, const StackState& initial_state);
+    public:
+        Greenlet(PyGreenlet* p);
+        virtual ~Greenlet();
+
+        const OwnedObject context() const;
+
+        // You MUST call this _very_ early in the switching process to
+        // prepare anything that may need prepared. This might perform
+        // garbage collections or otherwise run arbitrary Python code.
+        //
+        // One specific use of it is for Python 3.11+, preventing
+        // running arbitrary code at unsafe times. See
+        // PythonState::may_switch_away().
+        inline void may_switch_away()
+        {
+            this->python_state.may_switch_away();
+        }
+
+        inline void context(refs::BorrowedObject new_context);
+
+        inline SwitchingArgs& args()
+        {
+            return this->switch_args;
+        }
+
+        virtual const refs::BorrowedMainGreenlet main_greenlet() const = 0;
+
+        inline intptr_t stack_saved() const noexcept
+        {
+            return this->stack_state.stack_saved();
+        }
+
+        // This is used by the macro SLP_SAVE_STATE to compute the
+        // difference in stack sizes. It might be nice to handle the
+        // computation ourself, but the type of the result
+        // varies by platform, so doing it in the macro is the
+        // simplest way.
+        inline const char* stack_start() const noexcept
+        {
+            return this->stack_state.stack_start();
+        }
+
+        virtual OwnedObject throw_GreenletExit_during_dealloc(const ThreadState& current_thread_state);
+        virtual OwnedObject g_switch() = 0;
+        /**
+         * Force the greenlet to appear dead. Used when it's not
+         * possible to throw an exception into a greenlet anymore.
+         *
+         * This losses access to the thread state and the main greenlet.
+         */
+        virtual void murder_in_place();
+
+        /**
+         * Called when somebody notices we were running in a dead
+         * thread to allow cleaning up resources (because we can't
+         * raise GreenletExit into it anymore).
+         * This is very similar to ``murder_in_place()``, except that
+         * it DOES NOT lose the main greenlet or thread state.
+         */
+        inline void deactivate_and_free();
+
+
+        // Called when some thread wants to deallocate a greenlet
+        // object.
+        // The thread may or may not be the same thread the greenlet
+        // was running in.
+        // The thread state will be null if the thread the greenlet
+        // was running in was known to have exited.
+        void deallocing_greenlet_in_thread(const ThreadState* current_state);
+
+        // Must be called on 3.12+ before exposing a suspended greenlet's
+        // frames to user code. This rewrites the linked list of interpreter
+        // frames to skip the ones that are being stored on the C stack (which
+        // can't be safely accessed while the greenlet is suspended because
+        // that stack space might be hosting a different greenlet), and
+        // sets PythonState::frames_were_exposed so we remember to restore
+        // the original list before resuming the greenlet. The C-stack frames
+        // are a low-level interpreter implementation detail; while they're
+        // important to the bytecode eval loop, they're superfluous for
+        // introspection purposes.
+        void expose_frames();
+
+
+        // TODO: Figure out how to make these non-public.
+        inline void slp_restore_state() noexcept;
+        inline int slp_save_state(char *const stackref) noexcept;
+
+        inline bool is_currently_running_in_some_thread() const;
+        virtual bool belongs_to_thread(const ThreadState* state) const;
+
+        inline bool started() const
+        {
+            return this->stack_state.started();
+        }
+        inline bool active() const
+        {
+            return this->stack_state.active();
+        }
+        inline bool main() const
+        {
+            return this->stack_state.main();
+        }
+        virtual refs::BorrowedMainGreenlet find_main_greenlet_in_lineage() const = 0;
+
+        virtual const OwnedGreenlet parent() const = 0;
+        virtual void parent(const refs::BorrowedObject new_parent) = 0;
+
+        inline const PythonState::OwnedFrame& top_frame()
+        {
+            return this->python_state.top_frame();
+        }
+
+        virtual const OwnedObject& run() const = 0;
+        virtual void run(const refs::BorrowedObject nrun) = 0;
+
+
+        virtual int tp_traverse(visitproc visit, void* arg);
+        virtual int tp_clear();
+
+
+        // Return the thread state that the greenlet is running in, or
+        // null if the greenlet is not running or the thread is known
+        // to have exited.
+        virtual ThreadState* thread_state() const noexcept = 0;
+
+        // Return true if the greenlet is known to have been running
+        // (active) in a thread that has now exited.
+        virtual bool was_running_in_dead_thread() const noexcept = 0;
+
+        // Return a borrowed greenlet that is the Python object
+        // this object represents.
+        virtual BorrowedGreenlet self() const noexcept = 0;
+
+        // For testing. If this returns true, we should pretend that
+        // slp_switch() failed.
+        virtual bool force_slp_switch_error() const noexcept;
+
+    protected:
+        inline void release_args();
+
+        // The functions that must not be inlined are declared virtual.
+        // We also mark them as protected, not private, so that the
+        // compiler is forced to call them through a function pointer.
+        // (A sufficiently smart compiler could directly call a private
+        // virtual function since it can never be overridden in a
+        // subclass).
+
+        // Also TODO: Switch away from integer error codes and to enums,
+        // or throw exceptions when possible.
+        struct switchstack_result_t
+        {
+            int status;
+            Greenlet* the_new_current_greenlet;
+            OwnedGreenlet origin_greenlet;
+
+            switchstack_result_t()
+                : status(0),
+                  the_new_current_greenlet(nullptr)
+            {}
+
+            switchstack_result_t(int err)
+                : status(err),
+                  the_new_current_greenlet(nullptr)
+            {}
+
+            switchstack_result_t(int err, Greenlet* state, OwnedGreenlet& origin)
+                : status(err),
+                  the_new_current_greenlet(state),
+                  origin_greenlet(origin)
+            {
+            }
+
+            switchstack_result_t(int err, Greenlet* state, const BorrowedGreenlet& origin)
+                : status(err),
+                  the_new_current_greenlet(state),
+                  origin_greenlet(origin)
+            {
+            }
+
+            switchstack_result_t(const switchstack_result_t& other)
+                : status(other.status),
+                  the_new_current_greenlet(other.the_new_current_greenlet),
+                  origin_greenlet(other.origin_greenlet)
+            {}
+
+            switchstack_result_t& operator=(const switchstack_result_t& other)
+            {
+                this->status = other.status;
+                this->the_new_current_greenlet = other.the_new_current_greenlet;
+                this->origin_greenlet = other.origin_greenlet;
+                return *this;
+            }
+        };
+
+        OwnedObject on_switchstack_or_initialstub_failure(
+            Greenlet* target,
+            const switchstack_result_t& err,
+            const bool target_was_me=false,
+            const bool was_initial_stub=false);
+
+        // Returns the previous greenlet we just switched away from.
+        virtual OwnedGreenlet g_switchstack_success() noexcept;
+
+
+        // Check the preconditions for switching to this greenlet; if they
+        // aren't met, throws PyErrOccurred. Most callers will want to
+        // catch this and clear the arguments
+        inline void check_switch_allowed() const;
+        class GreenletStartedWhileInPython : public std::runtime_error
+        {
+        public:
+            GreenletStartedWhileInPython() : std::runtime_error("")
+            {}
+        };
+
+    protected:
+
+
+        /**
+           Perform a stack switch into this greenlet.
+
+           This temporarily sets the global variable
+           ``switching_thread_state`` to this greenlet; as soon as the
+           call to ``slp_switch`` completes, this is reset to NULL.
+           Consequently, this depends on the GIL.
+
+           TODO: Adopt the stackman model and pass ``slp_switch`` a
+           callback function and context pointer; this eliminates the
+           need for global variables altogether.
+
+           Because the stack switch happens in this function, this
+           function can't use its own stack (local) variables, set
+           before the switch, and then accessed after the switch.
+
+           Further, you con't even access ``g_thread_state_global``
+           before and after the switch from the global variable.
+           Because it is thread local some compilers cache it in a
+           register/on the stack, notably new versions of MSVC; this
+           breaks with strange crashes sometime later, because writing
+           to anything in ``g_thread_state_global`` after the switch
+           is actually writing to random memory. For this reason, we
+           call a non-inlined function to finish the operation. (XXX:
+           The ``/GT`` MSVC compiler argument probably fixes that.)
+
+           It is very important that stack switch is 'atomic', i.e. no
+           calls into other Python code allowed (except very few that
+           are safe), because global variables are very fragile. (This
+           should no longer be the case with thread-local variables.)
+
+        */
+        // Made virtual to facilitate subclassing UserGreenlet for testing.
+        virtual switchstack_result_t g_switchstack(void);
+
+class TracingGuard
+{
+private:
+    PyThreadState* tstate;
+public:
+    TracingGuard()
+        : tstate(PyThreadState_GET())
+    {
+        PyThreadState_EnterTracing(this->tstate);
+    }
+
+    ~TracingGuard()
+    {
+        PyThreadState_LeaveTracing(this->tstate);
+        this->tstate = nullptr;
+    }
+
+    inline void CallTraceFunction(const OwnedObject& tracefunc,
+                                  const greenlet::refs::ImmortalEventName& event,
+                                  const BorrowedGreenlet& origin,
+                                  const BorrowedGreenlet& target)
+    {
+        // TODO: This calls tracefunc(event, (origin, target)). Add a shortcut
+        // function for that that's specialized to avoid the Py_BuildValue
+        // string parsing, or start with just using "ON" format with PyTuple_Pack(2,
+        // origin, target). That seems like what the N format is meant
+        // for.
+        // XXX: Why does event not automatically cast back to a PyObject?
+        // It tries to call the "deleted constructor ImmortalEventName
+        // const" instead.
+        assert(tracefunc);
+        assert(event);
+        assert(origin);
+        assert(target);
+        greenlet::refs::NewReference retval(
+            PyObject_CallFunction(
+                tracefunc.borrow(),
+                "O(OO)",
+                event.borrow(),
+                origin.borrow(),
+                target.borrow()
+            ));
+        if (!retval) {
+            throw PyErrOccurred::from_current();
+        }
+    }
+};
+
+      static void
+      g_calltrace(const OwnedObject& tracefunc,
+                  const greenlet::refs::ImmortalEventName& event,
+                  const greenlet::refs::BorrowedGreenlet& origin,
+                  const BorrowedGreenlet& target);
+    private:
+        OwnedObject g_switch_finish(const switchstack_result_t& err);
+
+    };
+
+    class UserGreenlet : public Greenlet
+    {
+    private:
+        static greenlet::PythonAllocator<UserGreenlet> allocator;
+        BorrowedGreenlet _self;
+        OwnedMainGreenlet _main_greenlet;
+        OwnedObject _run_callable;
+        OwnedGreenlet _parent;
+    public:
+        static void* operator new(size_t UNUSED(count));
+        static void operator delete(void* ptr);
+
+        UserGreenlet(PyGreenlet* p, BorrowedGreenlet the_parent);
+        virtual ~UserGreenlet();
+
+        virtual refs::BorrowedMainGreenlet find_main_greenlet_in_lineage() const;
+        virtual bool was_running_in_dead_thread() const noexcept;
+        virtual ThreadState* thread_state() const noexcept;
+        virtual OwnedObject g_switch();
+        virtual const OwnedObject& run() const
+        {
+            if (this->started() || !this->_run_callable) {
+                throw AttributeError("run");
+            }
+            return this->_run_callable;
+        }
+        virtual void run(const refs::BorrowedObject nrun);
+
+        virtual const OwnedGreenlet parent() const;
+        virtual void parent(const refs::BorrowedObject new_parent);
+
+        virtual const refs::BorrowedMainGreenlet main_greenlet() const;
+
+        virtual BorrowedGreenlet self() const noexcept;
+        virtual void murder_in_place();
+        virtual bool belongs_to_thread(const ThreadState* state) const;
+        virtual int tp_traverse(visitproc visit, void* arg);
+        virtual int tp_clear();
+        class ParentIsCurrentGuard
+        {
+        private:
+            OwnedGreenlet oldparent;
+            UserGreenlet* greenlet;
+            G_NO_COPIES_OF_CLS(ParentIsCurrentGuard);
+        public:
+            ParentIsCurrentGuard(UserGreenlet* p, const ThreadState& thread_state);
+            ~ParentIsCurrentGuard();
+        };
+        virtual OwnedObject throw_GreenletExit_during_dealloc(const ThreadState& current_thread_state);
+    protected:
+        virtual switchstack_result_t g_initialstub(void* mark);
+    private:
+        // This function isn't meant to return.
+        // This accepts raw pointers and the ownership of them at the
+        // same time. The caller should use ``inner_bootstrap(origin.relinquish_ownership())``.
+        void inner_bootstrap(PyGreenlet* origin_greenlet, PyObject* run);
+    };
+
+    class BrokenGreenlet : public UserGreenlet
+    {
+    private:
+        static greenlet::PythonAllocator<BrokenGreenlet> allocator;
+    public:
+        bool _force_switch_error = false;
+        bool _force_slp_switch_error = false;
+
+        static void* operator new(size_t UNUSED(count));
+        static void operator delete(void* ptr);
+        BrokenGreenlet(PyGreenlet* p, BorrowedGreenlet the_parent)
+            : UserGreenlet(p, the_parent)
+        {}
+        virtual ~BrokenGreenlet()
+        {}
+
+        virtual switchstack_result_t g_switchstack(void);
+        virtual bool force_slp_switch_error() const noexcept;
+
+    };
+
+    class MainGreenlet : public Greenlet
+    {
+    private:
+        static greenlet::PythonAllocator<MainGreenlet> allocator;
+        refs::BorrowedMainGreenlet _self;
+        ThreadState* _thread_state;
+        G_NO_COPIES_OF_CLS(MainGreenlet);
+    public:
+        static void* operator new(size_t UNUSED(count));
+        static void operator delete(void* ptr);
+
+        MainGreenlet(refs::BorrowedMainGreenlet::PyType*, ThreadState*);
+        virtual ~MainGreenlet();
+
+
+        virtual const OwnedObject& run() const;
+        virtual void run(const refs::BorrowedObject nrun);
+
+        virtual const OwnedGreenlet parent() const;
+        virtual void parent(const refs::BorrowedObject new_parent);
+
+        virtual const refs::BorrowedMainGreenlet main_greenlet() const;
+
+        virtual refs::BorrowedMainGreenlet find_main_greenlet_in_lineage() const;
+        virtual bool was_running_in_dead_thread() const noexcept;
+        virtual ThreadState* thread_state() const noexcept;
+        void thread_state(ThreadState*) noexcept;
+        virtual OwnedObject g_switch();
+        virtual BorrowedGreenlet self() const noexcept;
+        virtual int tp_traverse(visitproc visit, void* arg);
+    };
+
+    // Instantiate one on the stack to save the GC state,
+    // and then disable GC. When it goes out of scope, GC will be
+    // restored to its original state. Sadly, these APIs are only
+    // available on 3.10+; luckily, we only need them on 3.11+.
+#if GREENLET_PY310
+    class GCDisabledGuard
+    {
+    private:
+        int was_enabled = 0;
+    public:
+        GCDisabledGuard()
+            : was_enabled(PyGC_IsEnabled())
+        {
+            PyGC_Disable();
+        }
+
+        ~GCDisabledGuard()
+        {
+            if (this->was_enabled) {
+                PyGC_Enable();
+            }
+        }
+    };
+#endif
+
+    OwnedObject& operator<<=(OwnedObject& lhs, greenlet::SwitchingArgs& rhs) noexcept;
+
+    //TODO: Greenlet::g_switch() should call this automatically on its
+    //return value. As it is, the module code is calling it.
+    static inline OwnedObject
+    single_result(const OwnedObject& results)
+    {
+        if (results
+            && PyTuple_Check(results.borrow())
+            && PyTuple_GET_SIZE(results.borrow()) == 1) {
+            PyObject* result = PyTuple_GET_ITEM(results.borrow(), 0);
+            assert(result);
+            return OwnedObject::owning(result);
+        }
+        return results;
+    }
+
+
+    static OwnedObject
+    g_handle_exit(const OwnedObject& greenlet_result);
+
+
+    template<typename T>
+    void operator<<(const PyThreadState *const lhs, T& rhs)
+    {
+        rhs.operator<<(lhs);
+    }
+
+} // namespace greenlet ;
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/greenlet_internal.hpp b/llm/Lib/site-packages/greenlet/greenlet_internal.hpp
new file mode 100644
index 0000000000000000000000000000000000000000..c8e38494efa6ca843900d1ea4cd4d9dd7e4a62c9
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet_internal.hpp
@@ -0,0 +1,106 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */
+#ifndef GREENLET_INTERNAL_H
+#define GREENLET_INTERNAL_H
+#ifdef __clang__
+#    pragma clang diagnostic push
+#    pragma clang diagnostic ignored "-Wunused-function"
+#    pragma clang diagnostic ignored "-Wmissing-field-initializers"
+#    pragma clang diagnostic ignored "-Wunused-variable"
+#endif
+
+/**
+ * Implementation helpers.
+ *
+ * C++ templates and inline functions should go here.
+ */
+#define PY_SSIZE_T_CLEAN
+#include "greenlet_compiler_compat.hpp"
+#include "greenlet_cpython_compat.hpp"
+#include "greenlet_exceptions.hpp"
+#include "greenlet_greenlet.hpp"
+#include "greenlet_allocator.hpp"
+
+#include <vector>
+#include <string>
+
+#define GREENLET_MODULE
+struct _greenlet;
+typedef struct _greenlet PyGreenlet;
+namespace greenlet {
+
+    class ThreadState;
+
+};
+
+
+#define implementation_ptr_t greenlet::Greenlet*
+
+
+#include "greenlet.h"
+
+G_FP_TMPL_STATIC inline void
+greenlet::refs::MainGreenletExactChecker(void *p)
+{
+    if (!p) {
+        return;
+    }
+    // We control the class of the main greenlet exactly.
+    if (Py_TYPE(p) != &PyGreenlet_Type) {
+        std::string err("MainGreenlet: Expected exactly a greenlet, not a ");
+        err += Py_TYPE(p)->tp_name;
+        throw greenlet::TypeError(err);
+    }
+
+    // Greenlets from dead threads no longer respond to main() with a
+    // true value; so in that case we need to perform an additional
+    // check.
+    Greenlet* g = ((PyGreenlet*)p)->pimpl;
+    if (g->main()) {
+        return;
+    }
+    if (!dynamic_cast<MainGreenlet*>(g)) {
+        std::string err("MainGreenlet: Expected exactly a main greenlet, not a ");
+        err += Py_TYPE(p)->tp_name;
+        throw greenlet::TypeError(err);
+    }
+}
+
+
+
+template <typename T, greenlet::refs::TypeChecker TC>
+inline greenlet::Greenlet* greenlet::refs::_OwnedGreenlet<T, TC>::operator->() const noexcept
+{
+    return reinterpret_cast<PyGreenlet*>(this->p)->pimpl;
+}
+
+template <typename T, greenlet::refs::TypeChecker TC>
+inline greenlet::Greenlet* greenlet::refs::_BorrowedGreenlet<T, TC>::operator->() const noexcept
+{
+    return reinterpret_cast<PyGreenlet*>(this->p)->pimpl;
+}
+
+#include <memory>
+#include <stdexcept>
+
+
+extern PyTypeObject PyGreenlet_Type;
+
+
+
+/**
+  * Forward declarations needed in multiple files.
+  */
+static PyGreenlet* green_create_main(greenlet::ThreadState*);
+static PyObject* green_switch(PyGreenlet* self, PyObject* args, PyObject* kwargs);
+static int green_is_gc(BorrowedGreenlet self);
+
+#ifdef __clang__
+#    pragma clang diagnostic pop
+#endif
+
+
+#endif
+
+// Local Variables:
+// flycheck-clang-include-path: ("../../include" "/opt/local/Library/Frameworks/Python.framework/Versions/3.10/include/python3.10")
+// End:
diff --git a/llm/Lib/site-packages/greenlet/greenlet_refs.hpp b/llm/Lib/site-packages/greenlet/greenlet_refs.hpp
new file mode 100644
index 0000000000000000000000000000000000000000..72ee68b44c0060962a0836f31e0ad1ff674f8453
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet_refs.hpp
@@ -0,0 +1,1100 @@
+#ifndef GREENLET_REFS_HPP
+#define GREENLET_REFS_HPP
+
+#define PY_SSIZE_T_CLEAN
+#include <Python.h>
+//#include "greenlet_internal.hpp"
+#include "greenlet_compiler_compat.hpp"
+#include "greenlet_cpython_compat.hpp"
+#include "greenlet_exceptions.hpp"
+
+struct _greenlet;
+struct _PyMainGreenlet;
+
+typedef struct _greenlet PyGreenlet;
+extern PyTypeObject PyGreenlet_Type;
+
+
+#ifdef  GREENLET_USE_STDIO
+#include <iostream>
+using std::cerr;
+using std::endl;
+#endif
+
+namespace greenlet
+{
+    class Greenlet;
+
+    namespace refs
+    {
+        // Type checkers throw a TypeError if the argument is not
+        // null, and isn't of the required Python type.
+        // (We can't use most of the defined type checkers
+        // like PyList_Check, etc, directly, because they are
+        // implemented as macros.)
+        typedef void (*TypeChecker)(void*);
+
+        G_FP_TMPL_STATIC inline void
+        NoOpChecker(void*)
+        {
+            return;
+        }
+
+        G_FP_TMPL_STATIC inline void
+        GreenletChecker(void *p)
+        {
+            if (!p) {
+                return;
+            }
+
+            PyTypeObject* typ = Py_TYPE(p);
+            // fast, common path. (PyObject_TypeCheck is a macro or
+            // static inline function, and it also does a
+            // direct comparison of the type pointers, but its fast
+            // path only handles one type)
+            if (typ == &PyGreenlet_Type) {
+                return;
+            }
+
+            if (!PyObject_TypeCheck(p, &PyGreenlet_Type)) {
+                std::string err("GreenletChecker: Expected any type of greenlet, not ");
+                err += Py_TYPE(p)->tp_name;
+                throw TypeError(err);
+            }
+        }
+
+        G_FP_TMPL_STATIC inline void
+        MainGreenletExactChecker(void *p);
+
+        template <typename T, TypeChecker>
+        class PyObjectPointer;
+
+        template<typename T, TypeChecker>
+        class OwnedReference;
+
+
+        template<typename T, TypeChecker>
+        class BorrowedReference;
+
+        typedef BorrowedReference<PyObject, NoOpChecker> BorrowedObject;
+        typedef OwnedReference<PyObject, NoOpChecker> OwnedObject;
+
+        class ImmortalObject;
+        class ImmortalString;
+
+        template<typename T, TypeChecker TC>
+        class _OwnedGreenlet;
+
+        typedef _OwnedGreenlet<PyGreenlet, GreenletChecker> OwnedGreenlet;
+        typedef _OwnedGreenlet<PyGreenlet, MainGreenletExactChecker> OwnedMainGreenlet;
+
+        template<typename T, TypeChecker TC>
+        class _BorrowedGreenlet;
+
+        typedef _BorrowedGreenlet<PyGreenlet, GreenletChecker> BorrowedGreenlet;
+
+        G_FP_TMPL_STATIC inline void
+        ContextExactChecker(void *p)
+        {
+            if (!p) {
+                return;
+            }
+            if (!PyContext_CheckExact(p)) {
+                throw TypeError(
+                    "greenlet context must be a contextvars.Context or None"
+                );
+            }
+        }
+
+        typedef OwnedReference<PyObject, ContextExactChecker> OwnedContext;
+    }
+}
+
+namespace greenlet {
+
+
+    namespace refs {
+    // A set of classes to make reference counting rules in python
+    // code explicit.
+    //
+    // Rules of use:
+    // (1) Functions returning a new reference that the caller of the
+    // function is expected to dispose of should return a
+    // ``OwnedObject`` object. This object automatically releases its
+    // reference when it goes out of scope. It works like a ``std::shared_ptr``
+    // and can be copied or used as a function parameter (but don't do
+    // that). Note that constructing a ``OwnedObject`` from a
+    // PyObject* steals the reference.
+    // (2) Parameters to functions should be either a
+    // ``OwnedObject&``, or, more generally, a ``PyObjectPointer&``.
+    // If the function needs to create its own new reference, it can
+    // do so by copying to a local ``OwnedObject``.
+    // (3) Functions returning an existing pointer that is NOT
+    // incref'd, and which the caller MUST NOT decref,
+    // should return a ``BorrowedObject``.
+
+    //
+    // For a class with a single pointer member, whose constructor
+    // does nothing but copy a pointer parameter into the member, and
+    // which can then be converted back to the pointer type, compilers
+    // generate code that's the same as just passing the pointer.
+    // That is, func(BorrowedObject x) called like ``PyObject* p =
+    // ...; f(p)`` has 0 overhead. Similarly, they "unpack" to the
+    // pointer type with 0 overhead.
+    //
+    // If there are no virtual functions, no complex inheritance (maybe?) and
+    // no destructor, these can be directly used as parameters in
+    // Python callbacks like tp_init: the layout is the same as a
+    // single pointer. Only subclasses with trivial constructors that
+    // do nothing but set the single pointer member are safe to use
+    // that way.
+
+
+    // This is the base class for things that can be done with a
+    // PyObject pointer. It assumes nothing about memory management.
+    // NOTE: Nothing is virtual, so subclasses shouldn't add new
+    // storage fields or try to override these methods.
+    template <typename T=PyObject, TypeChecker TC=NoOpChecker>
+    class PyObjectPointer
+    {
+    public:
+        typedef T PyType;
+    protected:
+        T* p;
+    public:
+        explicit PyObjectPointer(T* it=nullptr) : p(it)
+        {
+            TC(p);
+        }
+
+        // We don't allow automatic casting to PyObject* at this
+        // level, because then we could be passed to Py_DECREF/INCREF,
+        // but we want nothing to do with memory management. If you
+        // know better, then you can use the get() method, like on a
+        // std::shared_ptr. Except we name it borrow() to clarify that
+        // if this is a reference-tracked object, the pointer you get
+        // back will go away when the object does.
+        // TODO: This should probably not exist here, but be moved
+        // down to relevant sub-types.
+
+        inline T* borrow() const noexcept
+        {
+            return this->p;
+        }
+
+        PyObject* borrow_o() const noexcept
+        {
+            return reinterpret_cast<PyObject*>(this->p);
+        }
+
+        inline T* operator->() const noexcept
+        {
+            return this->p;
+        }
+
+        bool is_None() const noexcept
+        {
+            return this->p == Py_None;
+        }
+
+        inline PyObject* acquire_or_None() const noexcept
+        {
+            PyObject* result = this->p ? reinterpret_cast<PyObject*>(this->p) : Py_None;
+            Py_INCREF(result);
+            return result;
+        }
+
+        explicit operator bool() const noexcept
+        {
+            return p != nullptr;
+        }
+
+        inline Py_ssize_t REFCNT() const noexcept
+        {
+            return p ? Py_REFCNT(p) : -42;
+        }
+
+        inline PyTypeObject* TYPE() const noexcept
+        {
+            return p ? Py_TYPE(p) : nullptr;
+        }
+
+        inline OwnedObject PyStr() const noexcept;
+        inline const std::string as_str() const noexcept;
+        inline OwnedObject PyGetAttr(const ImmortalObject& name) const noexcept;
+        inline OwnedObject PyRequireAttr(const char* const name) const;
+        inline OwnedObject PyRequireAttr(const ImmortalString& name) const;
+        inline OwnedObject PyCall(const BorrowedObject& arg) const;
+        inline OwnedObject PyCall(PyGreenlet* arg) const ;
+        inline OwnedObject PyCall(PyObject* arg) const ;
+        // PyObject_Call(this, args, kwargs);
+        inline OwnedObject PyCall(const BorrowedObject args,
+                                  const BorrowedObject kwargs) const;
+        inline OwnedObject PyCall(const OwnedObject& args,
+                                  const OwnedObject& kwargs) const;
+
+    protected:
+        void _set_raw_pointer(void* t)
+        {
+            TC(t);
+            p = reinterpret_cast<T*>(t);
+        }
+        void* _get_raw_pointer() const
+        {
+            return p;
+        }
+    };
+
+#ifdef GREENLET_USE_STDIO
+        template<typename T, TypeChecker TC>
+        std::ostream& operator<<(std::ostream& os, const PyObjectPointer<T, TC>& s)
+        {
+            const std::type_info& t = typeid(s);
+            os << t.name()
+               << "(addr=" << s.borrow()
+               << ", refcnt=" << s.REFCNT()
+               << ", value=" << s.as_str()
+               << ")";
+
+            return os;
+        }
+#endif
+
+    template<typename T, TypeChecker TC>
+    inline bool operator==(const PyObjectPointer<T, TC>& lhs, const void* const rhs) noexcept
+    {
+        return lhs.borrow_o() == rhs;
+    }
+
+    template<typename T, TypeChecker TC, typename X, TypeChecker XC>
+    inline bool operator==(const PyObjectPointer<T, TC>& lhs, const PyObjectPointer<X, XC>& rhs) noexcept
+    {
+        return lhs.borrow_o() == rhs.borrow_o();
+    }
+
+    template<typename T, TypeChecker TC, typename X, TypeChecker XC>
+    inline bool operator!=(const PyObjectPointer<T, TC>& lhs,
+                           const PyObjectPointer<X, XC>& rhs) noexcept
+    {
+        return lhs.borrow_o() != rhs.borrow_o();
+    }
+
+    template<typename T=PyObject, TypeChecker TC=NoOpChecker>
+    class OwnedReference : public PyObjectPointer<T, TC>
+    {
+    private:
+        friend class OwnedList;
+
+    protected:
+        explicit OwnedReference(T* it) : PyObjectPointer<T, TC>(it)
+        {
+        }
+
+    public:
+
+        // Constructors
+
+        static OwnedReference<T, TC> consuming(PyObject* p)
+        {
+            return OwnedReference<T, TC>(reinterpret_cast<T*>(p));
+        }
+
+        static OwnedReference<T, TC> owning(T* p)
+        {
+            OwnedReference<T, TC> result(p);
+            Py_XINCREF(result.p);
+            return result;
+        }
+
+        OwnedReference() : PyObjectPointer<T, TC>(nullptr)
+        {}
+
+        explicit OwnedReference(const PyObjectPointer<>& other)
+            : PyObjectPointer<T, TC>(nullptr)
+        {
+            T* op = other.borrow();
+            TC(op);
+            this->p = other.borrow();
+            Py_XINCREF(this->p);
+        }
+
+        // It would be good to make use of the C++11 distinction
+        // between move and copy operations, e.g., constructing from a
+        // pointer should be a move operation.
+        // In the common case of ``OwnedObject x = Py_SomeFunction()``,
+        // the call to the copy constructor will be elided completely.
+        OwnedReference(const OwnedReference<T, TC>& other)
+            : PyObjectPointer<T, TC>(other.p)
+        {
+            Py_XINCREF(this->p);
+        }
+
+        static OwnedReference<PyObject> None()
+        {
+            Py_INCREF(Py_None);
+            return OwnedReference<PyObject>(Py_None);
+        }
+
+        // We can assign from exactly our type without any extra checking
+        OwnedReference<T, TC>& operator=(const OwnedReference<T, TC>& other)
+        {
+            Py_XINCREF(other.p);
+            const T* tmp = this->p;
+            this->p = other.p;
+            Py_XDECREF(tmp);
+            return *this;
+        }
+
+        OwnedReference<T, TC>& operator=(const BorrowedReference<T, TC> other)
+        {
+            return this->operator=(other.borrow());
+        }
+
+        OwnedReference<T, TC>& operator=(T* const other)
+        {
+            TC(other);
+            Py_XINCREF(other);
+            T* tmp = this->p;
+            this->p = other;
+            Py_XDECREF(tmp);
+            return *this;
+        }
+
+        // We can assign from an arbitrary reference type
+        // if it passes our check.
+        template<typename X, TypeChecker XC>
+        OwnedReference<T, TC>& operator=(const OwnedReference<X, XC>& other)
+        {
+            X* op = other.borrow();
+            TC(op);
+            return this->operator=(reinterpret_cast<T*>(op));
+        }
+
+        inline void steal(T* other)
+        {
+            assert(this->p == nullptr);
+            TC(other);
+            this->p = other;
+        }
+
+        T* relinquish_ownership()
+        {
+            T* result = this->p;
+            this->p = nullptr;
+            return result;
+        }
+
+        T* acquire() const
+        {
+            // Return a new reference.
+            // TODO: This may go away when we have reference objects
+            // throughout the code.
+            Py_XINCREF(this->p);
+            return this->p;
+        }
+
+        // Nothing else declares a destructor, we're the leaf, so we
+        // should be able to get away without virtual.
+        ~OwnedReference()
+        {
+            Py_CLEAR(this->p);
+        }
+
+        void CLEAR()
+        {
+            Py_CLEAR(this->p);
+            assert(this->p == nullptr);
+        }
+    };
+
+    static inline
+    void operator<<=(PyObject*& target, OwnedObject& o)
+    {
+        target = o.relinquish_ownership();
+    }
+
+    class NewReference : public OwnedObject
+    {
+    private:
+        G_NO_COPIES_OF_CLS(NewReference);
+    public:
+        // Consumes the reference. Only use this
+        // for API return values.
+        NewReference(PyObject* it) : OwnedObject(it)
+        {
+        }
+    };
+
+    class NewDictReference : public NewReference
+    {
+    private:
+        G_NO_COPIES_OF_CLS(NewDictReference);
+    public:
+        NewDictReference() : NewReference(PyDict_New())
+        {
+            if (!this->p) {
+                throw PyErrOccurred();
+            }
+        }
+
+        void SetItem(const char* const key, PyObject* value)
+        {
+            Require(PyDict_SetItemString(this->p, key, value));
+        }
+
+        void SetItem(const PyObjectPointer<>& key, PyObject* value)
+        {
+            Require(PyDict_SetItem(this->p, key.borrow_o(), value));
+        }
+    };
+
+    template<typename T=PyGreenlet, TypeChecker TC=GreenletChecker>
+    class _OwnedGreenlet: public OwnedReference<T, TC>
+    {
+    private:
+    protected:
+        _OwnedGreenlet(T* it) : OwnedReference<T, TC>(it)
+        {}
+
+    public:
+        _OwnedGreenlet() : OwnedReference<T, TC>()
+        {}
+
+        _OwnedGreenlet(const _OwnedGreenlet<T, TC>& other) : OwnedReference<T, TC>(other)
+        {
+        }
+        _OwnedGreenlet(OwnedMainGreenlet& other) :
+            OwnedReference<T, TC>(reinterpret_cast<T*>(other.acquire()))
+        {
+        }
+        _OwnedGreenlet(const BorrowedGreenlet& other);
+        // Steals a reference.
+        static _OwnedGreenlet<T, TC> consuming(PyGreenlet* it)
+        {
+            return _OwnedGreenlet<T, TC>(reinterpret_cast<T*>(it));
+        }
+
+        inline _OwnedGreenlet<T, TC>& operator=(const OwnedGreenlet& other)
+        {
+            return this->operator=(other.borrow());
+        }
+
+        inline _OwnedGreenlet<T, TC>& operator=(const BorrowedGreenlet& other);
+
+        _OwnedGreenlet<T, TC>& operator=(const OwnedMainGreenlet& other)
+        {
+            PyGreenlet* owned = other.acquire();
+            Py_XDECREF(this->p);
+            this->p = reinterpret_cast<T*>(owned);
+            return *this;
+        }
+
+        _OwnedGreenlet<T, TC>& operator=(T* const other)
+        {
+            OwnedReference<T, TC>::operator=(other);
+            return *this;
+        }
+
+        T* relinquish_ownership()
+        {
+            T* result = this->p;
+            this->p = nullptr;
+            return result;
+        }
+
+        PyObject* relinquish_ownership_o()
+        {
+            return reinterpret_cast<PyObject*>(relinquish_ownership());
+        }
+
+        inline Greenlet* operator->() const noexcept;
+        inline operator Greenlet*() const noexcept;
+    };
+
+    template <typename T=PyObject, TypeChecker TC=NoOpChecker>
+    class BorrowedReference : public PyObjectPointer<T, TC>
+    {
+    public:
+        // Allow implicit creation from PyObject* pointers as we
+        // transition to using these classes. Also allow automatic
+        // conversion to PyObject* for passing to C API calls and even
+        // for Py_INCREF/DECREF, because we ourselves do no memory management.
+        BorrowedReference(T* it) : PyObjectPointer<T, TC>(it)
+        {}
+
+        BorrowedReference(const PyObjectPointer<T>& ref) : PyObjectPointer<T, TC>(ref.borrow())
+        {}
+
+        BorrowedReference() : PyObjectPointer<T, TC>(nullptr)
+        {}
+
+        operator T*() const
+        {
+            return this->p;
+        }
+    };
+
+    typedef BorrowedReference<PyObject> BorrowedObject;
+    //typedef BorrowedReference<PyGreenlet> BorrowedGreenlet;
+
+    template<typename T=PyGreenlet, TypeChecker TC=GreenletChecker>
+    class _BorrowedGreenlet : public BorrowedReference<T, TC>
+    {
+    public:
+        _BorrowedGreenlet() :
+            BorrowedReference<T, TC>(nullptr)
+        {}
+
+        _BorrowedGreenlet(T* it) :
+            BorrowedReference<T, TC>(it)
+        {}
+
+        _BorrowedGreenlet(const BorrowedObject& it);
+
+        _BorrowedGreenlet(const OwnedGreenlet& it) :
+            BorrowedReference<T, TC>(it.borrow())
+        {}
+
+        _BorrowedGreenlet<T, TC>& operator=(const BorrowedObject& other);
+
+        // We get one of these for PyGreenlet, but one for PyObject
+        // is handy as well
+        operator PyObject*() const
+        {
+            return reinterpret_cast<PyObject*>(this->p);
+        }
+        inline Greenlet* operator->() const noexcept;
+        inline operator Greenlet*() const noexcept;
+    };
+
+    typedef _BorrowedGreenlet<PyGreenlet> BorrowedGreenlet;
+
+    template<typename T, TypeChecker TC>
+    _OwnedGreenlet<T, TC>::_OwnedGreenlet(const BorrowedGreenlet& other)
+        : OwnedReference<T, TC>(reinterpret_cast<T*>(other.borrow()))
+    {
+        Py_XINCREF(this->p);
+    }
+
+
+     class BorrowedMainGreenlet
+            : public _BorrowedGreenlet<PyGreenlet, MainGreenletExactChecker>
+    {
+    public:
+        BorrowedMainGreenlet(const OwnedMainGreenlet& it) :
+            _BorrowedGreenlet<PyGreenlet, MainGreenletExactChecker>(it.borrow())
+        {}
+        BorrowedMainGreenlet(PyGreenlet* it=nullptr)
+            : _BorrowedGreenlet<PyGreenlet, MainGreenletExactChecker>(it)
+        {}
+    };
+
+    template<typename T, TypeChecker TC>
+    _OwnedGreenlet<T, TC>& _OwnedGreenlet<T, TC>::operator=(const BorrowedGreenlet& other)
+    {
+        return this->operator=(other.borrow());
+    }
+
+
+    class ImmortalObject : public PyObjectPointer<>
+    {
+    private:
+        G_NO_ASSIGNMENT_OF_CLS(ImmortalObject);
+    public:
+        explicit ImmortalObject(PyObject* it) : PyObjectPointer<>(it)
+        {
+        }
+
+        ImmortalObject(const ImmortalObject& other)
+            : PyObjectPointer<>(other.p)
+        {
+
+        }
+
+        /**
+         * Become the new owner of the object. Does not change the
+         * reference count.
+         */
+        ImmortalObject& operator=(PyObject* it)
+        {
+            assert(this->p == nullptr);
+            this->p = it;
+            return *this;
+        }
+
+        static ImmortalObject consuming(PyObject* it)
+        {
+            return ImmortalObject(it);
+        }
+
+        inline operator PyObject*() const
+        {
+            return this->p;
+        }
+    };
+
+    class ImmortalString : public ImmortalObject
+    {
+    private:
+        G_NO_COPIES_OF_CLS(ImmortalString);
+        const char* str;
+    public:
+        ImmortalString(const char* const str) :
+            ImmortalObject(str ? Require(PyUnicode_InternFromString(str)) : nullptr)
+        {
+            this->str = str;
+        }
+
+        inline ImmortalString& operator=(const char* const str)
+        {
+            if (!this->p) {
+                this->p = Require(PyUnicode_InternFromString(str));
+                this->str = str;
+            }
+            else {
+                assert(this->str == str);
+            }
+            return *this;
+        }
+
+        inline operator std::string() const
+        {
+            return this->str;
+        }
+
+    };
+
+    class ImmortalEventName : public ImmortalString
+    {
+    private:
+        G_NO_COPIES_OF_CLS(ImmortalEventName);
+    public:
+        ImmortalEventName(const char* const str) : ImmortalString(str)
+        {}
+    };
+
+    class ImmortalException : public ImmortalObject
+    {
+    private:
+        G_NO_COPIES_OF_CLS(ImmortalException);
+    public:
+        ImmortalException(const char* const name, PyObject* base=nullptr) :
+            ImmortalObject(name
+                           // Python 2.7 isn't const correct
+                           ? Require(PyErr_NewException((char*)name, base, nullptr))
+                           : nullptr)
+        {}
+
+        inline bool PyExceptionMatches() const
+        {
+            return PyErr_ExceptionMatches(this->p) > 0;
+        }
+
+    };
+
+    template<typename T, TypeChecker TC>
+    inline OwnedObject PyObjectPointer<T, TC>::PyStr() const noexcept
+    {
+        if (!this->p) {
+            return OwnedObject();
+        }
+        return OwnedObject::consuming(PyObject_Str(reinterpret_cast<PyObject*>(this->p)));
+    }
+
+    template<typename T, TypeChecker TC>
+    inline const std::string PyObjectPointer<T, TC>::as_str() const noexcept
+    {
+        // NOTE: This is not Python exception safe.
+        if (this->p) {
+            // The Python APIs return a cached char* value that's only valid
+            // as long as the original object stays around, and we're
+            // about to (probably) toss it. Hence the copy to std::string.
+            OwnedObject py_str = this->PyStr();
+            if (!py_str) {
+                return "(nil)";
+            }
+            return PyUnicode_AsUTF8(py_str.borrow());
+        }
+        return "(nil)";
+    }
+
+    template<typename T, TypeChecker TC>
+    inline OwnedObject PyObjectPointer<T, TC>::PyGetAttr(const ImmortalObject& name) const noexcept
+    {
+        assert(this->p);
+        return OwnedObject::consuming(PyObject_GetAttr(reinterpret_cast<PyObject*>(this->p), name));
+    }
+
+    template<typename T, TypeChecker TC>
+    inline OwnedObject PyObjectPointer<T, TC>::PyRequireAttr(const char* const name) const
+    {
+        assert(this->p);
+        return OwnedObject::consuming(Require(PyObject_GetAttrString(this->p, name), name));
+    }
+
+    template<typename T, TypeChecker TC>
+    inline OwnedObject PyObjectPointer<T, TC>::PyRequireAttr(const ImmortalString& name) const
+    {
+        assert(this->p);
+        return OwnedObject::consuming(Require(
+                   PyObject_GetAttr(
+                      reinterpret_cast<PyObject*>(this->p),
+                      name
+                   ),
+                   name
+               ));
+    }
+
+    template<typename T, TypeChecker TC>
+    inline OwnedObject PyObjectPointer<T, TC>::PyCall(const BorrowedObject& arg) const
+    {
+        return this->PyCall(arg.borrow());
+    }
+
+    template<typename T, TypeChecker TC>
+    inline OwnedObject PyObjectPointer<T, TC>::PyCall(PyGreenlet* arg) const
+    {
+        return this->PyCall(reinterpret_cast<PyObject*>(arg));
+    }
+
+    template<typename T, TypeChecker TC>
+    inline OwnedObject PyObjectPointer<T, TC>::PyCall(PyObject* arg) const
+    {
+        assert(this->p);
+        return OwnedObject::consuming(PyObject_CallFunctionObjArgs(this->p, arg, NULL));
+    }
+
+    template<typename T, TypeChecker TC>
+    inline OwnedObject PyObjectPointer<T, TC>::PyCall(const BorrowedObject args,
+                                                  const BorrowedObject kwargs) const
+    {
+        assert(this->p);
+        return OwnedObject::consuming(PyObject_Call(this->p, args, kwargs));
+    }
+
+    template<typename T, TypeChecker TC>
+    inline OwnedObject PyObjectPointer<T, TC>::PyCall(const OwnedObject& args,
+                                                  const OwnedObject& kwargs) const
+    {
+        assert(this->p);
+        return OwnedObject::consuming(PyObject_Call(this->p, args.borrow(), kwargs.borrow()));
+    }
+
+    G_FP_TMPL_STATIC inline void
+    ListChecker(void * p)
+    {
+        if (!p) {
+            return;
+        }
+        if (!PyList_Check(p)) {
+            throw TypeError("Expected a list");
+        }
+    }
+
+    class OwnedList : public OwnedReference<PyObject, ListChecker>
+    {
+    private:
+        G_NO_ASSIGNMENT_OF_CLS(OwnedList);
+    public:
+        // TODO: Would like to use move.
+        explicit OwnedList(const OwnedObject& other)
+            : OwnedReference<PyObject, ListChecker>(other)
+        {
+        }
+
+        OwnedList& operator=(const OwnedObject& other)
+        {
+            if (other && PyList_Check(other.p)) {
+                // Valid list. Own a new reference to it, discard the
+                // reference to what we did own.
+                PyObject* new_ptr = other.p;
+                Py_INCREF(new_ptr);
+                Py_XDECREF(this->p);
+                this->p = new_ptr;
+            }
+            else {
+                // Either the other object was NULL (an error) or it
+                // wasn't a list. Either way, we're now invalidated.
+                Py_XDECREF(this->p);
+                this->p = nullptr;
+            }
+            return *this;
+        }
+
+        inline bool empty() const
+        {
+            return PyList_GET_SIZE(p) == 0;
+        }
+
+        inline Py_ssize_t size() const
+        {
+            return PyList_GET_SIZE(p);
+        }
+
+        inline BorrowedObject at(const Py_ssize_t index) const
+        {
+            return PyList_GET_ITEM(p, index);
+        }
+
+        inline void clear()
+        {
+            PyList_SetSlice(p, 0, PyList_GET_SIZE(p), NULL);
+        }
+    };
+
+    // Use this to represent the module object used at module init
+    // time.
+    // This could either be a borrowed (Py2) or new (Py3) reference;
+    // either way, we don't want to do any memory management
+    // on it here, Python itself will handle that.
+    // XXX: Actually, that's not quite right. On Python 3, if an
+    // exception occurs before we return to the interpreter, this will
+    // leak; but all previous versions also had that problem.
+    class CreatedModule : public PyObjectPointer<>
+    {
+    private:
+        G_NO_COPIES_OF_CLS(CreatedModule);
+    public:
+        CreatedModule(PyModuleDef& mod_def) : PyObjectPointer<>(
+            Require(PyModule_Create(&mod_def)))
+        {
+        }
+
+        // PyAddObject(): Add a reference to the object to the module.
+        // On return, the reference count of the object is unchanged.
+        //
+        // The docs warn that PyModule_AddObject only steals the
+        // reference on success, so if it fails after we've incref'd
+        // or allocated, we're responsible for the decref.
+        void PyAddObject(const char* name, const long new_bool)
+        {
+            OwnedObject p = OwnedObject::consuming(Require(PyBool_FromLong(new_bool)));
+            this->PyAddObject(name, p);
+        }
+
+        void PyAddObject(const char* name, const OwnedObject& new_object)
+        {
+            // The caller already owns a reference they will decref
+            // when their variable goes out of scope, we still need to
+            // incref/decref.
+            this->PyAddObject(name, new_object.borrow());
+        }
+
+        void PyAddObject(const char* name, const ImmortalObject& new_object)
+        {
+            this->PyAddObject(name, new_object.borrow());
+        }
+
+        void PyAddObject(const char* name, PyTypeObject& type)
+        {
+            this->PyAddObject(name, reinterpret_cast<PyObject*>(&type));
+        }
+
+        void PyAddObject(const char* name, PyObject* new_object)
+        {
+            Py_INCREF(new_object);
+            try {
+                Require(PyModule_AddObject(this->p, name, new_object));
+            }
+            catch (const PyErrOccurred&) {
+                Py_DECREF(p);
+                throw;
+            }
+        }
+    };
+
+    class PyErrFetchParam : public PyObjectPointer<>
+    {
+        // Not an owned object, because we can't be initialized with
+        // one, and we only sometimes acquire ownership.
+    private:
+        G_NO_COPIES_OF_CLS(PyErrFetchParam);
+    public:
+        // To allow declaring these and passing them to
+        // PyErr_Fetch we implement the empty constructor,
+        // and the address operator.
+        PyErrFetchParam() : PyObjectPointer<>(nullptr)
+        {
+        }
+
+        PyObject** operator&()
+        {
+            return &this->p;
+        }
+
+        // This allows us to pass one directly without the &,
+        // BUT it has higher precedence than the bool operator
+        // if it's not explicit.
+        operator PyObject**()
+        {
+            return &this->p;
+        }
+
+        // We don't want to be able to pass these to Py_DECREF and
+        // such so we don't have the implicit PyObject* conversion.
+
+        inline PyObject* relinquish_ownership()
+        {
+            PyObject* result = this->p;
+            this->p = nullptr;
+            return result;
+        }
+
+        ~PyErrFetchParam()
+        {
+            Py_XDECREF(p);
+        }
+    };
+
+    class OwnedErrPiece : public OwnedObject
+    {
+    private:
+
+    public:
+        // Unlike OwnedObject, this increments the refcount.
+        OwnedErrPiece(PyObject* p=nullptr) : OwnedObject(p)
+        {
+            this->acquire();
+        }
+
+        PyObject** operator&()
+        {
+            return &this->p;
+        }
+
+        inline operator PyObject*() const
+        {
+            return this->p;
+        }
+
+        operator PyTypeObject*() const
+        {
+            return reinterpret_cast<PyTypeObject*>(this->p);
+        }
+    };
+
+    class PyErrPieces
+    {
+    private:
+        OwnedErrPiece type;
+        OwnedErrPiece instance;
+        OwnedErrPiece traceback;
+        bool restored;
+    public:
+        // Takes new references; if we're destroyed before
+        // restoring the error, we drop the references.
+        PyErrPieces(PyObject* t, PyObject* v, PyObject* tb) :
+            type(t),
+            instance(v),
+            traceback(tb),
+            restored(0)
+        {
+            this->normalize();
+        }
+
+        PyErrPieces() :
+            restored(0)
+        {
+            // PyErr_Fetch transfers ownership to us, so
+            // we don't actually need to INCREF; but we *do*
+            // need to DECREF if we're not restored.
+            PyErrFetchParam t, v, tb;
+            PyErr_Fetch(&t, &v, &tb);
+            type.steal(t.relinquish_ownership());
+            instance.steal(v.relinquish_ownership());
+            traceback.steal(tb.relinquish_ownership());
+        }
+
+        void PyErrRestore()
+        {
+            // can only do this once
+            assert(!this->restored);
+            this->restored = true;
+            PyErr_Restore(
+                this->type.relinquish_ownership(),
+                this->instance.relinquish_ownership(),
+                this->traceback.relinquish_ownership());
+            assert(!this->type && !this->instance && !this->traceback);
+        }
+
+    private:
+        void normalize()
+        {
+            // First, check the traceback argument, replacing None,
+            // with NULL
+            if (traceback.is_None()) {
+                traceback = nullptr;
+            }
+
+            if (traceback && !PyTraceBack_Check(traceback.borrow())) {
+                throw PyErrOccurred(PyExc_TypeError,
+                                    "throw() third argument must be a traceback object");
+            }
+
+            if (PyExceptionClass_Check(type)) {
+                // If we just had a type, we'll now have a type and
+                // instance.
+                // The type's refcount will have gone up by one
+                // because of the instance and the instance will have
+                // a refcount of one. Either way, we owned, and still
+                // do own, exactly one reference.
+                PyErr_NormalizeException(&type, &instance, &traceback);
+
+            }
+            else if (PyExceptionInstance_Check(type)) {
+                /* Raising an instance --- usually that means an
+                   object that is a subclass of BaseException, but on
+                   Python 2, that can also mean an arbitrary old-style
+                   object. The value should be a dummy. */
+                if (instance && !instance.is_None()) {
+                    throw PyErrOccurred(
+                                    PyExc_TypeError,
+                                    "instance exception may not have a separate value");
+                }
+                /* Normalize to raise <class>, <instance> */
+                this->instance = this->type;
+                this->type = PyExceptionInstance_Class(instance.borrow());
+
+                /*
+                  It would be tempting to do this:
+
+                Py_ssize_t type_count = Py_REFCNT(Py_TYPE(instance.borrow()));
+                this->type = PyExceptionInstance_Class(instance.borrow());
+                assert(this->type.REFCNT() == type_count + 1);
+
+                But that doesn't work on Python 2 in the case of
+                old-style instances: The result of Py_TYPE is going to
+                be the global shared <type instance> that all
+                old-style classes have, while the return of Instance_Class()
+                will be the Python-level class object. The two are unrelated.
+                */
+            }
+            else {
+                /* Not something you can raise. throw() fails. */
+                PyErr_Format(PyExc_TypeError,
+                     "exceptions must be classes, or instances, not %s",
+                             Py_TYPE(type.borrow())->tp_name);
+                throw PyErrOccurred();
+            }
+        }
+    };
+
+    // PyArg_Parse's O argument returns a borrowed reference.
+    class PyArgParseParam : public BorrowedObject
+    {
+    private:
+        G_NO_COPIES_OF_CLS(PyArgParseParam);
+    public:
+        explicit PyArgParseParam(PyObject* p=nullptr) : BorrowedObject(p)
+        {
+        }
+
+        inline PyObject** operator&()
+        {
+            return &this->p;
+        }
+    };
+
+};};
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/greenlet_slp_switch.hpp b/llm/Lib/site-packages/greenlet/greenlet_slp_switch.hpp
new file mode 100644
index 0000000000000000000000000000000000000000..bd4b7ae1a6ea950b19fa890784021426822ea274
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet_slp_switch.hpp
@@ -0,0 +1,99 @@
+#ifndef GREENLET_SLP_SWITCH_HPP
+#define GREENLET_SLP_SWITCH_HPP
+
+#include "greenlet_compiler_compat.hpp"
+#include "greenlet_refs.hpp"
+
+/*
+ * the following macros are spliced into the OS/compiler
+ * specific code, in order to simplify maintenance.
+ */
+// We can save about 10% of the time it takes to switch greenlets if
+// we thread the thread state through the slp_save_state() and the
+// following slp_restore_state() calls from
+// slp_switch()->g_switchstack() (which already needs to access it).
+//
+// However:
+//
+// that requires changing the prototypes and implementations of the
+// switching functions. If we just change the prototype of
+// slp_switch() to accept the argument and update the macros, without
+// changing the implementation of slp_switch(), we get crashes on
+// 64-bit Linux and 32-bit x86 (for reasons that aren't 100% clear);
+// on the other hand, 64-bit macOS seems to be fine. Also, 64-bit
+// windows is an issue because slp_switch is written fully in assembly
+// and currently ignores its argument so some code would have to be
+// adjusted there to pass the argument on to the
+// ``slp_save_state_asm()`` function (but interestingly, because of
+// the calling convention, the extra argument is just ignored and
+// things function fine, albeit slower, if we just modify
+// ``slp_save_state_asm`()` to fetch the pointer to pass to the
+// macro.)
+//
+// Our compromise is to use a *glabal*, untracked, weak, pointer
+// to the necessary thread state during the process of switching only.
+// This is safe because we're protected by the GIL, and if we're
+// running this code, the thread isn't exiting. This also nets us a
+// 10-12% speed improvement.
+
+static greenlet::Greenlet* volatile switching_thread_state = nullptr;
+
+
+extern "C" {
+static int GREENLET_NOINLINE(slp_save_state_trampoline)(char* stackref);
+static void GREENLET_NOINLINE(slp_restore_state_trampoline)();
+}
+
+
+#define SLP_SAVE_STATE(stackref, stsizediff) \
+do {                                                    \
+    assert(switching_thread_state);  \
+    stackref += STACK_MAGIC;                 \
+    if (slp_save_state_trampoline((char*)stackref))    \
+        return -1;                                     \
+    if (!switching_thread_state->active()) \
+        return 1;                                      \
+    stsizediff = switching_thread_state->stack_start() - (char*)stackref; \
+} while (0)
+
+#define SLP_RESTORE_STATE() slp_restore_state_trampoline()
+
+#define SLP_EVAL
+extern "C" {
+#define slp_switch GREENLET_NOINLINE(slp_switch)
+#include "slp_platformselect.h"
+}
+#undef slp_switch
+
+#ifndef STACK_MAGIC
+#    error \
+        "greenlet needs to be ported to this platform, or taught how to detect your compiler properly."
+#endif /* !STACK_MAGIC */
+
+
+
+#ifdef EXTERNAL_ASM
+/* CCP addition: Make these functions, to be called from assembler.
+ * The token include file for the given platform should enable the
+ * EXTERNAL_ASM define so that this is included.
+ */
+extern "C" {
+intptr_t
+slp_save_state_asm(intptr_t* ref)
+{
+    intptr_t diff;
+    SLP_SAVE_STATE(ref, diff);
+    return diff;
+}
+
+void
+slp_restore_state_asm(void)
+{
+    SLP_RESTORE_STATE();
+}
+
+extern int slp_switch(void);
+};
+#endif
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/greenlet_thread_state.hpp b/llm/Lib/site-packages/greenlet/greenlet_thread_state.hpp
new file mode 100644
index 0000000000000000000000000000000000000000..045371f808f700798a7921e1523f141449c20368
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet_thread_state.hpp
@@ -0,0 +1,543 @@
+#ifndef GREENLET_THREAD_STATE_HPP
+#define GREENLET_THREAD_STATE_HPP
+
+#include <ctime>
+#include <stdexcept>
+
+#include "greenlet_internal.hpp"
+#include "greenlet_refs.hpp"
+#include "greenlet_thread_support.hpp"
+
+using greenlet::refs::BorrowedObject;
+using greenlet::refs::BorrowedGreenlet;
+using greenlet::refs::BorrowedMainGreenlet;
+using greenlet::refs::OwnedMainGreenlet;
+using greenlet::refs::OwnedObject;
+using greenlet::refs::OwnedGreenlet;
+using greenlet::refs::OwnedList;
+using greenlet::refs::PyErrFetchParam;
+using greenlet::refs::PyArgParseParam;
+using greenlet::refs::ImmortalString;
+using greenlet::refs::CreatedModule;
+using greenlet::refs::PyErrPieces;
+using greenlet::refs::NewReference;
+
+namespace greenlet {
+/**
+ * Thread-local state of greenlets.
+ *
+ * Each native thread will get exactly one of these objects,
+ * automatically accessed through the best available thread-local
+ * mechanism the compiler supports (``thread_local`` for C++11
+ * compilers or ``__thread``/``declspec(thread)`` for older GCC/clang
+ * or MSVC, respectively.)
+ *
+ * Previously, we kept thread-local state mostly in a bunch of
+ * ``static volatile`` variables in the main greenlet file.. This had
+ * the problem of requiring extra checks, loops, and great care
+ * accessing these variables if we potentially invoked any Python code
+ * that could release the GIL, because the state could change out from
+ * under us. Making the variables thread-local solves this problem.
+ *
+ * When we detected that a greenlet API accessing the current greenlet
+ * was invoked from a different thread than the greenlet belonged to,
+ * we stored a reference to the greenlet in the Python thread
+ * dictionary for the thread the greenlet belonged to. This could lead
+ * to memory leaks if the thread then exited (because of a reference
+ * cycle, as greenlets referred to the thread dictionary, and deleting
+ * non-current greenlets leaked their frame plus perhaps arguments on
+ * the C stack). If a thread exited while still having running
+ * greenlet objects (perhaps that had just switched back to the main
+ * greenlet), and did not invoke one of the greenlet APIs *in that
+ * thread, immediately before it exited, without some other thread
+ * then being invoked*, such a leak was guaranteed.
+ *
+ * This can be partly solved by using compiler thread-local variables
+ * instead of the Python thread dictionary, thus avoiding a cycle.
+ *
+ * To fully solve this problem, we need a reliable way to know that a
+ * thread is done and we should clean up the main greenlet. On POSIX,
+ * we can use the destructor function of ``pthread_key_create``, but
+ * there's nothing similar on Windows; a C++11 thread local object
+ * reliably invokes its destructor when the thread it belongs to exits
+ * (non-C++11 compilers offer ``__thread`` or ``declspec(thread)`` to
+ * create thread-local variables, but they can't hold C++ objects that
+ * invoke destructors; the C++11 version is the most portable solution
+ * I found). When the thread exits, we can drop references and
+ * otherwise manipulate greenlets and frames that we know can no
+ * longer be switched to. For compilers that don't support C++11
+ * thread locals, we have a solution that uses the python thread
+ * dictionary, though it may not collect everything as promptly as
+ * other compilers do, if some other library is using the thread
+ * dictionary and has a cycle or extra reference.
+ *
+ * There are two small wrinkles. The first is that when the thread
+ * exits, it is too late to actually invoke Python APIs: the Python
+ * thread state is gone, and the GIL is released. To solve *this*
+ * problem, our destructor uses ``Py_AddPendingCall`` to transfer the
+ * destruction work to the main thread. (This is not an issue for the
+ * dictionary solution.)
+ *
+ * The second is that once the thread exits, the thread local object
+ * is invalid and we can't even access a pointer to it, so we can't
+ * pass it to ``Py_AddPendingCall``. This is handled by actually using
+ * a second object that's thread local (ThreadStateCreator) and having
+ * it dynamically allocate this object so it can live until the
+ * pending call runs.
+ */
+
+
+
+class ThreadState {
+private:
+    // As of commit 08ad1dd7012b101db953f492e0021fb08634afad
+    // this class needed 56 bytes in o Py_DEBUG build
+    // on 64-bit macOS 11.
+    // Adding the vector takes us up to 80 bytes ()
+
+    /* Strong reference to the main greenlet */
+    OwnedMainGreenlet main_greenlet;
+
+    /* Strong reference to the current greenlet. */
+    OwnedGreenlet current_greenlet;
+
+    /* Strong reference to the trace function, if any. */
+    OwnedObject tracefunc;
+
+    typedef std::vector<PyGreenlet*, PythonAllocator<PyGreenlet*> > deleteme_t;
+    /* A vector of raw PyGreenlet pointers representing things that need
+       deleted when this thread is running. The vector owns the
+       references, but you need to manually INCREF/DECREF as you use
+       them. We don't use a vector<refs::OwnedGreenlet> because we
+       make copy of this vector, and that would become O(n) as all the
+       refcounts are incremented in the copy.
+    */
+    deleteme_t deleteme;
+
+#ifdef GREENLET_NEEDS_EXCEPTION_STATE_SAVED
+    void* exception_state;
+#endif
+
+    static std::clock_t _clocks_used_doing_gc;
+    static ImmortalString get_referrers_name;
+    static PythonAllocator<ThreadState> allocator;
+
+    G_NO_COPIES_OF_CLS(ThreadState);
+
+public:
+    static void* operator new(size_t UNUSED(count))
+    {
+        return ThreadState::allocator.allocate(1);
+    }
+
+    static void operator delete(void* ptr)
+    {
+        return ThreadState::allocator.deallocate(static_cast<ThreadState*>(ptr),
+                                                 1);
+    }
+
+    static void init()
+    {
+        ThreadState::get_referrers_name = "get_referrers";
+        ThreadState::_clocks_used_doing_gc = 0;
+    }
+
+    ThreadState()
+        : main_greenlet(OwnedMainGreenlet::consuming(green_create_main(this))),
+          current_greenlet(main_greenlet)
+    {
+        if (!this->main_greenlet) {
+            // We failed to create the main greenlet. That's bad.
+            throw PyFatalError("Failed to create main greenlet");
+        }
+        // The main greenlet starts with 1 refs: The returned one. We
+        // then copied it to the current greenlet.
+        assert(this->main_greenlet.REFCNT() == 2);
+
+#ifdef GREENLET_NEEDS_EXCEPTION_STATE_SAVED
+        this->exception_state = slp_get_exception_state();
+#endif
+    }
+
+    inline void restore_exception_state()
+    {
+#ifdef GREENLET_NEEDS_EXCEPTION_STATE_SAVED
+        // It's probably important this be inlined and only call C
+        // functions to avoid adding an SEH frame.
+        slp_set_exception_state(this->exception_state);
+#endif
+    }
+
+    inline bool has_main_greenlet()
+    {
+        return !!this->main_greenlet;
+    }
+
+    // Called from the ThreadStateCreator when we're in non-standard
+    // threading mode. In that case, there is an object in the Python
+    // thread state dictionary that points to us. The main greenlet
+    // also traverses into us, in which case it's crucial not to
+    // traverse back into the main greenlet.
+    int tp_traverse(visitproc visit, void* arg, bool traverse_main=true)
+    {
+        if (traverse_main) {
+            Py_VISIT(main_greenlet.borrow_o());
+        }
+        if (traverse_main || current_greenlet != main_greenlet) {
+            Py_VISIT(current_greenlet.borrow_o());
+        }
+        Py_VISIT(tracefunc.borrow());
+        return 0;
+    }
+
+    inline BorrowedMainGreenlet borrow_main_greenlet() const
+    {
+        assert(this->main_greenlet);
+        assert(this->main_greenlet.REFCNT() >= 2);
+        return this->main_greenlet;
+    };
+
+    inline OwnedMainGreenlet get_main_greenlet()
+    {
+        return this->main_greenlet;
+    }
+
+    /**
+     * In addition to returning a new reference to the currunt
+     * greenlet, this performs any maintenance needed.
+     */
+    inline OwnedGreenlet get_current()
+    {
+        /* green_dealloc() cannot delete greenlets from other threads, so
+           it stores them in the thread dict; delete them now. */
+        this->clear_deleteme_list();
+        //assert(this->current_greenlet->main_greenlet == this->main_greenlet);
+        //assert(this->main_greenlet->main_greenlet == this->main_greenlet);
+        return this->current_greenlet;
+    }
+
+    /**
+     * As for non-const get_current();
+     */
+    inline BorrowedGreenlet borrow_current()
+    {
+        this->clear_deleteme_list();
+        return this->current_greenlet;
+    }
+
+    /**
+     * Does no maintenance.
+     */
+    inline OwnedGreenlet get_current() const
+    {
+        return this->current_greenlet;
+    }
+
+    template<typename T, refs::TypeChecker TC>
+    inline bool is_current(const refs::PyObjectPointer<T, TC>& obj) const
+    {
+        return this->current_greenlet.borrow_o() == obj.borrow_o();
+    }
+
+    inline void set_current(const OwnedGreenlet& target)
+    {
+        this->current_greenlet = target;
+    }
+
+private:
+    /**
+     * Deref and remove the greenlets from the deleteme list. Must be
+     * holding the GIL.
+     *
+     * If *murder* is true, then we must be called from a different
+     * thread than the one that these greenlets were running in.
+     * In that case, if the greenlet was actually running, we destroy
+     * the frame reference and otherwise make it appear dead before
+     * proceeding; otherwise, we would try (and fail) to raise an
+     * exception in it and wind up right back in this list.
+     */
+    inline void clear_deleteme_list(const bool murder=false)
+    {
+        if (!this->deleteme.empty()) {
+            // It's possible we could add items to this list while
+            // running Python code if there's a thread switch, so we
+            // need to defensively copy it before that can happen.
+            deleteme_t copy = this->deleteme;
+            this->deleteme.clear(); // in case things come back on the list
+            for(deleteme_t::iterator it = copy.begin(), end = copy.end();
+                it != end;
+                ++it ) {
+                PyGreenlet* to_del = *it;
+                if (murder) {
+                    // Force each greenlet to appear dead; we can't raise an
+                    // exception into it anymore anyway.
+                    to_del->pimpl->murder_in_place();
+                }
+
+                // The only reference to these greenlets should be in
+                // this list, decreffing them should let them be
+                // deleted again, triggering calls to green_dealloc()
+                // in the correct thread (if we're not murdering).
+                // This may run arbitrary Python code and switch
+                // threads or greenlets!
+                Py_DECREF(to_del);
+                if (PyErr_Occurred()) {
+                    PyErr_WriteUnraisable(nullptr);
+                    PyErr_Clear();
+                }
+            }
+        }
+    }
+
+public:
+
+    /**
+     * Returns a new reference, or a false object.
+     */
+    inline OwnedObject get_tracefunc() const
+    {
+        return tracefunc;
+    };
+
+
+    inline void set_tracefunc(BorrowedObject tracefunc)
+    {
+        assert(tracefunc);
+        if (tracefunc == BorrowedObject(Py_None)) {
+            this->tracefunc.CLEAR();
+        }
+        else {
+            this->tracefunc = tracefunc;
+        }
+    }
+
+    /**
+     * Given a reference to a greenlet that some other thread
+     * attempted to delete (has a refcount of 0) store it for later
+     * deletion when the thread this state belongs to is current.
+     */
+    inline void delete_when_thread_running(PyGreenlet* to_del)
+    {
+        Py_INCREF(to_del);
+        this->deleteme.push_back(to_del);
+    }
+
+    /**
+     * Set to std::clock_t(-1) to disable.
+     */
+    inline static std::clock_t& clocks_used_doing_gc()
+    {
+        return ThreadState::_clocks_used_doing_gc;
+    }
+
+    ~ThreadState()
+    {
+        if (!PyInterpreterState_Head()) {
+            // We shouldn't get here (our callers protect us)
+            // but if we do, all we can do is bail early.
+            return;
+        }
+
+        // We should not have an "origin" greenlet; that only exists
+        // for the temporary time during a switch, which should not
+        // be in progress as the thread dies.
+        //assert(!this->switching_state.origin);
+
+        this->tracefunc.CLEAR();
+
+        // Forcibly GC as much as we can.
+        this->clear_deleteme_list(true);
+
+        // The pending call did this.
+        assert(this->main_greenlet->thread_state() == nullptr);
+
+        // If the main greenlet is the current greenlet,
+        // then we "fell off the end" and the thread died.
+        // It's possible that there is some other greenlet that
+        // switched to us, leaving a reference to the main greenlet
+        // on the stack, somewhere uncollectible. Try to detect that.
+        if (this->current_greenlet == this->main_greenlet && this->current_greenlet) {
+            assert(this->current_greenlet->is_currently_running_in_some_thread());
+            // Drop one reference we hold.
+            this->current_greenlet.CLEAR();
+            assert(!this->current_greenlet);
+            // Only our reference to the main greenlet should be left,
+            // But hold onto the pointer in case we need to do extra cleanup.
+            PyGreenlet* old_main_greenlet = this->main_greenlet.borrow();
+            Py_ssize_t cnt = this->main_greenlet.REFCNT();
+            this->main_greenlet.CLEAR();
+            if (ThreadState::_clocks_used_doing_gc != std::clock_t(-1)
+                && cnt == 2 && Py_REFCNT(old_main_greenlet) == 1) {
+                // Highly likely that the reference is somewhere on
+                // the stack, not reachable by GC. Verify.
+                // XXX: This is O(n) in the total number of objects.
+                // TODO: Add a way to disable this at runtime, and
+                // another way to report on it.
+                std::clock_t begin = std::clock();
+                NewReference gc(PyImport_ImportModule("gc"));
+                if (gc) {
+                    OwnedObject get_referrers = gc.PyRequireAttr(ThreadState::get_referrers_name);
+                    OwnedList refs(get_referrers.PyCall(old_main_greenlet));
+                    if (refs && refs.empty()) {
+                        assert(refs.REFCNT() == 1);
+                        // We found nothing! So we left a dangling
+                        // reference: Probably the last thing some
+                        // other greenlet did was call
+                        // 'getcurrent().parent.switch()' to switch
+                        // back to us. Clean it up. This will be the
+                        // case on CPython 3.7 and newer, as they use
+                        // an internal calling conversion that avoids
+                        // creating method objects and storing them on
+                        // the stack.
+                        Py_DECREF(old_main_greenlet);
+                    }
+                    else if (refs
+                             && refs.size() == 1
+                             && PyCFunction_Check(refs.at(0))
+                             && Py_REFCNT(refs.at(0)) == 2) {
+                        assert(refs.REFCNT() == 1);
+                        // Ok, we found a C method that refers to the
+                        // main greenlet, and its only referenced
+                        // twice, once in the list we just created,
+                        // once from...somewhere else. If we can't
+                        // find where else, then this is a leak.
+                        // This happens in older versions of CPython
+                        // that create a bound method object somewhere
+                        // on the stack that we'll never get back to.
+                        if (PyCFunction_GetFunction(refs.at(0).borrow()) == (PyCFunction)green_switch) {
+                            BorrowedObject function_w = refs.at(0);
+                            refs.clear(); // destroy the reference
+                                          // from the list.
+                            // back to one reference. Can *it* be
+                            // found?
+                            assert(function_w.REFCNT() == 1);
+                            refs = get_referrers.PyCall(function_w);
+                            if (refs && refs.empty()) {
+                                // Nope, it can't be found so it won't
+                                // ever be GC'd. Drop it.
+                                Py_CLEAR(function_w);
+                            }
+                        }
+                    }
+                    std::clock_t end = std::clock();
+                    ThreadState::_clocks_used_doing_gc += (end - begin);
+                }
+            }
+        }
+
+        // We need to make sure this greenlet appears to be dead,
+        // because otherwise deallocing it would fail to raise an
+        // exception in it (the thread is dead) and put it back in our
+        // deleteme list.
+        if (this->current_greenlet) {
+            this->current_greenlet->murder_in_place();
+            this->current_greenlet.CLEAR();
+        }
+
+        if (this->main_greenlet) {
+            // Couldn't have been the main greenlet that was running
+            // when the thread exited (because we already cleared this
+            // pointer if it was). This shouldn't be possible?
+
+            // If the main greenlet was current when the thread died (it
+            // should be, right?) then we cleared its self pointer above
+            // when we cleared the current greenlet's main greenlet pointer.
+            // assert(this->main_greenlet->main_greenlet == this->main_greenlet
+            //        || !this->main_greenlet->main_greenlet);
+            // // self reference, probably gone
+            // this->main_greenlet->main_greenlet.CLEAR();
+
+            // This will actually go away when the ivar is destructed.
+            this->main_greenlet.CLEAR();
+        }
+
+        if (PyErr_Occurred()) {
+            PyErr_WriteUnraisable(NULL);
+            PyErr_Clear();
+        }
+
+    }
+
+};
+
+ImmortalString ThreadState::get_referrers_name(nullptr);
+PythonAllocator<ThreadState> ThreadState::allocator;
+std::clock_t ThreadState::_clocks_used_doing_gc(0);
+
+template<typename Destructor>
+class ThreadStateCreator
+{
+private:
+    // Initialized to 1, and, if still 1, created on access.
+    // Set to 0 on destruction.
+    ThreadState* _state;
+    G_NO_COPIES_OF_CLS(ThreadStateCreator);
+public:
+
+    // Only one of these, auto created per thread
+    ThreadStateCreator() :
+        _state((ThreadState*)1)
+    {
+    }
+
+    ~ThreadStateCreator()
+    {
+        ThreadState* tmp = this->_state;
+        this->_state = nullptr;
+        if (tmp && tmp != (ThreadState*)1) {
+            Destructor x(tmp);
+        }
+    }
+
+    inline ThreadState& state()
+    {
+        // The main greenlet will own this pointer when it is created,
+        // which will be right after this. The plan is to give every
+        // greenlet a pointer to the main greenlet for the thread it
+        // runs in; if we are doing something cross-thread, we need to
+        // access the pointer from the main greenlet. Deleting the
+        // thread, and hence the thread-local storage, will delete the
+        // state pointer in the main greenlet.
+        if (this->_state == (ThreadState*)1) {
+            // XXX: Assuming allocation never fails
+            this->_state = new ThreadState;
+            // For non-standard threading, we need to store an object
+            // in the Python thread state dictionary so that it can be
+            // DECREF'd when the thread ends (ideally; the dict could
+            // last longer) and clean this object up.
+        }
+        if (!this->_state) {
+            throw std::runtime_error("Accessing state after destruction.");
+        }
+        return *this->_state;
+    }
+
+    operator ThreadState&()
+    {
+        return this->state();
+    }
+
+    operator ThreadState*()
+    {
+        return &this->state();
+    }
+
+    inline int tp_traverse(visitproc visit, void* arg)
+    {
+        if (this->_state) {
+            return this->_state->tp_traverse(visit, arg);
+        }
+        return 0;
+    }
+
+};
+
+
+// We can't use the PythonAllocator for this, because we push to it
+// from the thread state destructor, which doesn't have the GIL,
+// and Python's allocators can only be called with the GIL.
+typedef std::vector<ThreadState*> cleanup_queue_t;
+
+}; // namespace greenlet
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/greenlet_thread_state_dict_cleanup.hpp b/llm/Lib/site-packages/greenlet/greenlet_thread_state_dict_cleanup.hpp
new file mode 100644
index 0000000000000000000000000000000000000000..acf39c8f42463bca096458f30087454f0d14bc41
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet_thread_state_dict_cleanup.hpp
@@ -0,0 +1,118 @@
+#ifndef GREENLET_THREAD_STATE_DICT_CLEANUP_HPP
+#define GREENLET_THREAD_STATE_DICT_CLEANUP_HPP
+
+#include "greenlet_internal.hpp"
+#include "greenlet_thread_state.hpp"
+
+#ifdef __clang__
+#    pragma clang diagnostic push
+#    pragma clang diagnostic ignored "-Wmissing-field-initializers"
+#endif
+
+#ifndef G_THREAD_STATE_DICT_CLEANUP_TYPE
+// shut the compiler up if it looks at this file in isolation
+#define ThreadStateCreator int
+#endif
+
+// Define a Python object that goes in the Python thread state dict
+// when the greenlet thread state is created, and which owns the
+// reference to the greenlet thread local state.
+// When the thread state dict is cleaned up, so too is the thread
+// state. This works best if we make sure there are no circular
+// references to the thread state.
+typedef struct _PyGreenletCleanup {
+    PyObject_HEAD
+    ThreadStateCreator* thread_state_creator;
+} PyGreenletCleanup;
+
+static void
+cleanup_do_dealloc(PyGreenletCleanup* self)
+{
+    ThreadStateCreator* tmp = self->thread_state_creator;
+    self->thread_state_creator = nullptr;
+    if (tmp) {
+        delete tmp;
+    }
+}
+
+static void
+cleanup_dealloc(PyGreenletCleanup* self)
+{
+    PyObject_GC_UnTrack(self);
+    cleanup_do_dealloc(self);
+}
+
+static int
+cleanup_clear(PyGreenletCleanup* self)
+{
+    // This method is never called by our test cases.
+    cleanup_do_dealloc(self);
+    return 0;
+}
+
+static int
+cleanup_traverse(PyGreenletCleanup* self, visitproc visit, void* arg)
+{
+    if (self->thread_state_creator) {
+        return self->thread_state_creator->tp_traverse(visit, arg);
+    }
+    return 0;
+}
+
+static int
+cleanup_is_gc(PyGreenlet* UNUSED(self))
+{
+    return 1;
+}
+
+static PyTypeObject PyGreenletCleanup_Type = {
+    PyVarObject_HEAD_INIT(NULL, 0)
+    "greenlet._greenlet.ThreadStateCleanup",
+    sizeof(struct _PyGreenletCleanup),
+    0,                   /* tp_itemsize */
+    /* methods */
+    (destructor)cleanup_dealloc, /* tp_dealloc */
+    0,                         /* tp_print */
+    0,                         /* tp_getattr */
+    0,                         /* tp_setattr */
+    0,                         /* tp_compare */
+    0,                         /* tp_repr */
+    0,                         /* tp_as _number*/
+    0,                         /* tp_as _sequence*/
+    0,                         /* tp_as _mapping*/
+    0,                         /* tp_hash */
+    0,                         /* tp_call */
+    0,                         /* tp_str */
+    0,                         /* tp_getattro */
+    0,                         /* tp_setattro */
+    0,                         /* tp_as_buffer*/
+    G_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */
+    "Internal use only",                        /* tp_doc */
+    (traverseproc)cleanup_traverse, /* tp_traverse */
+    (inquiry)cleanup_clear,         /* tp_clear */
+    0,                                  /* tp_richcompare */
+    // XXX: Don't our flags promise a weakref?
+    0,                           /* tp_weaklistoffset */
+    0,                                  /* tp_iter */
+    0,                                  /* tp_iternext */
+    0,                      /* tp_methods */
+    0,                      /* tp_members */
+    0,                      /* tp_getset */
+    0,                                  /* tp_base */
+    0,                                  /* tp_dict */
+    0,                                  /* tp_descr_get */
+    0,                                  /* tp_descr_set */
+    0,         /* tp_dictoffset */
+    0,               /* tp_init */
+    PyType_GenericAlloc,                  /* tp_alloc */
+    PyType_GenericNew,                          /* tp_new */
+    PyObject_GC_Del,                   /* tp_free */
+    (inquiry)cleanup_is_gc,         /* tp_is_gc */
+};
+
+#ifdef __clang__
+#    pragma clang diagnostic pop
+#endif
+
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/greenlet_thread_support.hpp b/llm/Lib/site-packages/greenlet/greenlet_thread_support.hpp
new file mode 100644
index 0000000000000000000000000000000000000000..3ded7d2b730e79d15c95704491d7020cf58bb92f
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/greenlet_thread_support.hpp
@@ -0,0 +1,31 @@
+#ifndef GREENLET_THREAD_SUPPORT_HPP
+#define GREENLET_THREAD_SUPPORT_HPP
+
+/**
+ * Defines various utility functions to help greenlet integrate well
+ * with threads. This used to be needed when we supported Python
+ * 2.7 on Windows, which used a very old compiler. We wrote an
+ * alternative implementation using Python APIs and POSIX or Windows
+ * APIs, but that's no longer needed. So this file is a shadow of its
+ * former self --- but may be needed in the future.
+ */
+
+#include <stdexcept>
+#include <thread>
+#include <mutex>
+
+#include "greenlet_compiler_compat.hpp"
+
+namespace greenlet {
+    typedef std::mutex Mutex;
+    typedef std::lock_guard<Mutex> LockGuard;
+    class LockInitError : public std::runtime_error
+    {
+    public:
+        LockInitError(const char* what) : std::runtime_error(what)
+        {};
+    };
+};
+
+
+#endif /* GREENLET_THREAD_SUPPORT_HPP */
diff --git a/llm/Lib/site-packages/greenlet/platform/__init__.py b/llm/Lib/site-packages/greenlet/platform/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/greenlet/platform/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/greenlet/platform/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bcf274461e11bdf22bda764e0d86a2a42ed96d69
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/platform/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/platform/setup_switch_x64_masm.cmd b/llm/Lib/site-packages/greenlet/platform/setup_switch_x64_masm.cmd
new file mode 100644
index 0000000000000000000000000000000000000000..092859555c23a6802d44761f96f5d35a456a7e8b
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/setup_switch_x64_masm.cmd
@@ -0,0 +1,2 @@
+call "C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\vcvarsall.bat" amd64
+ml64 /nologo /c /Fo switch_x64_masm.obj switch_x64_masm.asm
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_aarch64_gcc.h b/llm/Lib/site-packages/greenlet/platform/switch_aarch64_gcc.h
new file mode 100644
index 0000000000000000000000000000000000000000..058617c40982fa9deb804b4046c1bc71809eecdb
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_aarch64_gcc.h
@@ -0,0 +1,124 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 07-Sep-16 Add clang support using x register naming. Fredrik Fornwall
+ * 13-Apr-13 Add support for strange GCC caller-save decisions
+ * 08-Apr-13 File creation. Michael Matz
+ *
+ * NOTES
+ *
+ * Simply save all callee saved registers
+ *
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+#define STACK_MAGIC 0
+#define REGS_TO_SAVE "x19", "x20", "x21", "x22", "x23", "x24", "x25", "x26", \
+                     "x27", "x28", "x30" /* aka lr */, \
+                     "v8", "v9", "v10", "v11", \
+                     "v12", "v13", "v14", "v15"
+
+/*
+ * Recall:
+   asm asm-qualifiers ( AssemblerTemplate
+                 : OutputOperands
+                 [ : InputOperands
+                 [ : Clobbers ] ])
+
+ or  (if asm-qualifiers contains 'goto')
+
+   asm asm-qualifiers ( AssemblerTemplate
+                      : OutputOperands
+                      : InputOperands
+                      : Clobbers
+                      : GotoLabels)
+
+ and OutputOperands are
+
+   [ [asmSymbolicName] ] constraint (cvariablename)
+
+ When a name is given, refer to it as ``%[the name]``.
+ When not given, ``%i`` where ``i`` is the zero-based index.
+
+ constraints starting with ``=`` means only writing; ``+`` means
+ reading and writing.
+
+ This is followed by ``r`` (must be register) or ``m`` (must be memory)
+ and these can be combined.
+
+ The ``cvariablename`` is actually an lvalue expression.
+
+ In AArch65, 31 general purpose registers. If named X0... they are
+ 64-bit. If named W0... they are the bottom 32 bits of the
+ corresponding 64 bit register.
+
+ XZR and WZR are hardcoded to 0, and ignore writes.
+
+ Arguments are in X0..X7. C++ uses X0 for ``this``. X0 holds simple return
+ values (?)
+
+ Whenever a W register is written, the top half of the X register is zeroed.
+ */
+
+static int
+slp_switch(void)
+{
+	int err;
+	void *fp;
+        /* Windowz uses a 32-bit long on a 64-bit platform, unlike the rest of
+           the world, and in theory we can be compiled with GCC/llvm on 64-bit
+           windows. So we need a fixed-width type.
+        */
+        int64_t *stackref, stsizediff;
+        __asm__ volatile ("" : : : REGS_TO_SAVE);
+	__asm__ volatile ("str x29, %0" : "=m"(fp) : : );
+        __asm__ ("mov %0, sp" : "=r" (stackref));
+        {
+                SLP_SAVE_STATE(stackref, stsizediff);
+                __asm__ volatile (
+                    "add sp,sp,%0\n"
+                    "add x29,x29,%0\n"
+                    :
+                    : "r" (stsizediff)
+                    );
+		SLP_RESTORE_STATE();
+		/* SLP_SAVE_STATE macro contains some return statements
+		   (of -1 and 1).  It falls through only when
+		   the return value of slp_save_state() is zero, which
+		   is placed in x0.
+		   In that case we (slp_switch) also want to return zero
+		   (also in x0 of course).
+		   Now, some GCC versions (seen with 4.8) think it's a
+		   good idea to save/restore x0 around the call to
+		   slp_restore_state(), instead of simply zeroing it
+		   at the return below.  But slp_restore_state
+		   writes random values to the stack slot used for this
+		   save/restore (from when it once was saved above in
+		   SLP_SAVE_STATE, when it was still uninitialized), so
+		   "restoring" that precious zero actually makes us
+		   return random values.  There are some ways to make
+		   GCC not use that zero value in the normal return path
+		   (e.g. making err volatile, but that costs a little
+		   stack space), and the simplest is to call a function
+		   that returns an unknown value (which happens to be zero),
+		   so the saved/restored value is unused.
+
+                   Thus, this line stores a 0 into the ``err`` variable
+                   (which must be held in a register for this instruction,
+                    of course). The ``w`` qualifier causes the instruction
+                    to use W0 instead of X0, otherwise we get a warning
+                    about a value size mismatch (because err is an int,
+                    and aarch64 platforms are LP64: 32-bit int, 64 bit long
+                   and pointer).
+                */
+           __asm__ volatile ("mov %w0, #0" : "=r" (err));
+        }
+        __asm__ volatile ("ldr x29, %0" : : "m" (fp) :);
+        __asm__ volatile ("" : : : REGS_TO_SAVE);
+        return err;
+}
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_alpha_unix.h b/llm/Lib/site-packages/greenlet/platform/switch_alpha_unix.h
new file mode 100644
index 0000000000000000000000000000000000000000..7e07abfc27d778e815a628b3fa1a6a5642e6555f
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_alpha_unix.h
@@ -0,0 +1,30 @@
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+#define STACK_MAGIC 0
+
+#define REGS_TO_SAVE "$9", "$10", "$11", "$12", "$13", "$14", "$15", \
+		     "$f2", "$f3", "$f4", "$f5", "$f6", "$f7", "$f8", "$f9"
+
+static int
+slp_switch(void)
+{
+  int ret;
+  long *stackref, stsizediff;
+  __asm__ volatile ("" : : : REGS_TO_SAVE);
+  __asm__ volatile ("mov $30, %0" : "=r" (stackref) : );
+  {
+      SLP_SAVE_STATE(stackref, stsizediff);
+      __asm__ volatile (
+	  "addq $30, %0, $30\n\t"
+	  : /* no outputs */
+	  : "r" (stsizediff)
+	  );
+      SLP_RESTORE_STATE();
+  }
+  __asm__ volatile ("" : : : REGS_TO_SAVE);
+  __asm__ volatile ("mov $31, %0" : "=r" (ret) : );
+  return ret;
+}
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_amd64_unix.h b/llm/Lib/site-packages/greenlet/platform/switch_amd64_unix.h
new file mode 100644
index 0000000000000000000000000000000000000000..d4701105fb8f88820b174832db34da5b7c309a0c
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_amd64_unix.h
@@ -0,0 +1,87 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 3-May-13   Ralf Schmitt  <ralf@systemexit.de>
+ *     Add support for strange GCC caller-save decisions
+ *     (ported from switch_aarch64_gcc.h)
+ * 18-Aug-11  Alexey Borzenkov  <snaury@gmail.com>
+ *      Correctly save rbp, csr and cw
+ * 01-Apr-04  Hye-Shik Chang    <perky@FreeBSD.org>
+ *      Ported from i386 to amd64.
+ * 24-Nov-02  Christian Tismer  <tismer@tismer.com>
+ *      needed to add another magic constant to insure
+ *      that f in slp_eval_frame(PyFrameObject *f)
+ *      STACK_REFPLUS will probably be 1 in most cases.
+ *      gets included into the saved stack area.
+ * 17-Sep-02  Christian Tismer  <tismer@tismer.com>
+ *      after virtualizing stack save/restore, the
+ *      stack size shrunk a bit. Needed to introduce
+ *      an adjustment STACK_MAGIC per platform.
+ * 15-Sep-02  Gerd Woetzel       <gerd.woetzel@GMD.DE>
+ *      slightly changed framework for spark
+ * 31-Avr-02  Armin Rigo         <arigo@ulb.ac.be>
+ *      Added ebx, esi and edi register-saves.
+ * 01-Mar-02  Samual M. Rushing  <rushing@ironport.com>
+ *      Ported from i386.
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+/* #define STACK_MAGIC 3 */
+/* the above works fine with gcc 2.96, but 2.95.3 wants this */
+#define STACK_MAGIC 0
+
+#define REGS_TO_SAVE "r12", "r13", "r14", "r15"
+
+static int
+slp_switch(void)
+{
+    int err;
+    void* rbp;
+    void* rbx;
+    unsigned int csr;
+    unsigned short cw;
+    /* This used to be declared 'register', but that does nothing in
+    modern compilers and is explicitly forbidden in some new
+    standards. */
+    long *stackref, stsizediff;
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("fstcw %0" : "=m" (cw));
+    __asm__ volatile ("stmxcsr %0" : "=m" (csr));
+    __asm__ volatile ("movq %%rbp, %0" : "=m" (rbp));
+    __asm__ volatile ("movq %%rbx, %0" : "=m" (rbx));
+    __asm__ ("movq %%rsp, %0" : "=g" (stackref));
+    {
+        SLP_SAVE_STATE(stackref, stsizediff);
+        __asm__ volatile (
+            "addq %0, %%rsp\n"
+            "addq %0, %%rbp\n"
+            :
+            : "r" (stsizediff)
+            );
+        SLP_RESTORE_STATE();
+        __asm__ volatile ("xorq %%rax, %%rax" : "=a" (err));
+    }
+    __asm__ volatile ("movq %0, %%rbx" : : "m" (rbx));
+    __asm__ volatile ("movq %0, %%rbp" : : "m" (rbp));
+    __asm__ volatile ("ldmxcsr %0" : : "m" (csr));
+    __asm__ volatile ("fldcw %0" : : "m" (cw));
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    return err;
+}
+
+#endif
+
+/*
+ * further self-processing support
+ */
+
+/*
+ * if you want to add self-inspection tools, place them
+ * here. See the x86_msvc for the necessary defines.
+ * These features are highly experimental und not
+ * essential yet.
+ */
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_arm32_gcc.h b/llm/Lib/site-packages/greenlet/platform/switch_arm32_gcc.h
new file mode 100644
index 0000000000000000000000000000000000000000..655003aa12ca3ba9bba634a879f702c2789e050e
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_arm32_gcc.h
@@ -0,0 +1,79 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 14-Aug-06 File creation. Ported from Arm Thumb. Sylvain Baro
+ *  3-Sep-06 Commented out saving of r1-r3 (r4 already commented out) as I
+ *           read that these do not need to be saved.  Also added notes and
+ *           errors related to the frame pointer. Richard Tew.
+ *
+ * NOTES
+ *
+ *   It is not possible to detect if fp is used or not, so the supplied
+ *   switch function needs to support it, so that you can remove it if
+ *   it does not apply to you.
+ *
+ * POSSIBLE ERRORS
+ *
+ *   "fp cannot be used in asm here"
+ *
+ *   - Try commenting out "fp" in REGS_TO_SAVE.
+ *
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+#define STACK_MAGIC 0
+#define REG_SP "sp"
+#define REG_SPSP "sp,sp"
+#ifdef __thumb__
+#define REG_FP "r7"
+#define REG_FPFP "r7,r7"
+#define REGS_TO_SAVE_GENERAL "r4", "r5", "r6", "r8", "r9", "r10", "r11", "lr"
+#else
+#define REG_FP "fp"
+#define REG_FPFP "fp,fp"
+#define REGS_TO_SAVE_GENERAL "r4", "r5", "r6", "r7", "r8", "r9", "r10", "lr"
+#endif
+#if defined(__SOFTFP__)
+#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL
+#elif defined(__VFP_FP__)
+#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL, "d8", "d9", "d10", "d11", \
+                                           "d12", "d13", "d14", "d15"
+#elif defined(__MAVERICK__)
+#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL, "mvf4", "mvf5", "mvf6", "mvf7", \
+                                           "mvf8", "mvf9", "mvf10", "mvf11", \
+                                           "mvf12", "mvf13", "mvf14", "mvf15"
+#else
+#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL, "f4", "f5", "f6", "f7"
+#endif
+
+static int
+#ifdef __GNUC__
+__attribute__((optimize("no-omit-frame-pointer")))
+#endif
+slp_switch(void)
+{
+        void *fp;
+        int *stackref, stsizediff;
+        int result;
+        __asm__ volatile ("" : : : REGS_TO_SAVE);
+        __asm__ volatile ("mov r0," REG_FP "\n\tstr r0,%0" : "=m" (fp) : : "r0");
+        __asm__ ("mov %0," REG_SP : "=r" (stackref));
+        {
+                SLP_SAVE_STATE(stackref, stsizediff);
+                __asm__ volatile (
+                    "add " REG_SPSP ",%0\n"
+                    "add " REG_FPFP ",%0\n"
+                    :
+                    : "r" (stsizediff)
+                    );
+                SLP_RESTORE_STATE();
+        }
+        __asm__ volatile ("ldr r0,%1\n\tmov " REG_FP ",r0\n\tmov %0, #0" : "=r" (result) : "m" (fp) : "r0");
+        __asm__ volatile ("" : : : REGS_TO_SAVE);
+        return result;
+}
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_arm32_ios.h b/llm/Lib/site-packages/greenlet/platform/switch_arm32_ios.h
new file mode 100644
index 0000000000000000000000000000000000000000..9e640e15f1a595cd086549041fc944d41d3fc3ae
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_arm32_ios.h
@@ -0,0 +1,67 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 31-May-15 iOS support. Ported from arm32. Proton <feisuzhu@163.com>
+ *
+ * NOTES
+ *
+ *   It is not possible to detect if fp is used or not, so the supplied
+ *   switch function needs to support it, so that you can remove it if
+ *   it does not apply to you.
+ *
+ * POSSIBLE ERRORS
+ *
+ *   "fp cannot be used in asm here"
+ *
+ *   - Try commenting out "fp" in REGS_TO_SAVE.
+ *
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+#define STACK_MAGIC 0
+#define REG_SP "sp"
+#define REG_SPSP "sp,sp"
+#define REG_FP "r7"
+#define REG_FPFP "r7,r7"
+#define REGS_TO_SAVE_GENERAL "r4", "r5", "r6", "r8", "r10", "r11", "lr"
+#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL, "d8", "d9", "d10", "d11", \
+                                           "d12", "d13", "d14", "d15"
+
+static int
+#ifdef __GNUC__
+__attribute__((optimize("no-omit-frame-pointer")))
+#endif
+slp_switch(void)
+{
+        void *fp;
+        int *stackref, stsizediff, result;
+        __asm__ volatile ("" : : : REGS_TO_SAVE);
+        __asm__ volatile ("str " REG_FP ",%0" : "=m" (fp));
+        __asm__ ("mov %0," REG_SP : "=r" (stackref));
+        {
+                SLP_SAVE_STATE(stackref, stsizediff);
+                __asm__ volatile (
+                    "add " REG_SPSP ",%0\n"
+                    "add " REG_FPFP ",%0\n"
+                    :
+                    : "r" (stsizediff)
+                    : REGS_TO_SAVE /* Clobber registers, force compiler to
+                                    * recalculate address of void *fp from REG_SP or REG_FP */
+                );
+                SLP_RESTORE_STATE();
+        }
+        __asm__ volatile (
+            "ldr " REG_FP ", %1\n\t"
+            "mov %0, #0"
+            : "=r" (result)
+            : "m" (fp)
+            : REGS_TO_SAVE /* Force compiler to restore saved registers after this */
+        );
+        return result;
+}
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_arm64_masm.asm b/llm/Lib/site-packages/greenlet/platform/switch_arm64_masm.asm
new file mode 100644
index 0000000000000000000000000000000000000000..29f9c225e296ab9a088318f14de35ca0496d1801
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_arm64_masm.asm
@@ -0,0 +1,53 @@
+  AREA switch_arm64_masm, CODE, READONLY;
+  GLOBAL slp_switch [FUNC]
+  EXTERN slp_save_state_asm
+  EXTERN slp_restore_state_asm
+
+slp_switch    
+    ; push callee saved registers to stack
+    stp    x19, x20, [sp, #-16]!
+    stp    x21, x22, [sp, #-16]!
+    stp    x23, x24, [sp, #-16]!
+    stp    x25, x26, [sp, #-16]!
+    stp    x27, x28, [sp, #-16]!
+    stp    x29, x30, [sp, #-16]!
+    stp    d8, d9, [sp, #-16]!
+    stp    d10, d11, [sp, #-16]!
+    stp    d12, d13, [sp, #-16]!
+    stp    d14, d15, [sp, #-16]!
+
+    ; call slp_save_state_asm with stack pointer
+    mov x0, sp
+    bl    slp_save_state_asm
+
+    ; early return for return value of 1 and -1
+    cmp x0, #-1
+    b.eq RETURN
+    cmp x0, #1
+    b.eq RETURN
+
+    ; increment stack and frame pointer
+    add sp, sp, x0
+    add x29, x29, x0
+
+    bl slp_restore_state_asm
+
+    ; store return value for successful completion of routine
+    mov x0, #0
+
+RETURN
+    ; pop registers from stack
+    ldp d14, d15, [sp], #16
+    ldp d12, d13, [sp], #16
+    ldp d10, d11, [sp], #16
+    ldp d8, d9, [sp], #16
+    ldp x29, x30, [sp], #16
+    ldp x27, x28, [sp], #16
+    ldp x25, x26, [sp], #16
+    ldp x23, x24, [sp], #16
+    ldp x21, x22, [sp], #16
+    ldp x19, x20, [sp], #16
+
+    ret
+
+    END
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_arm64_masm.obj b/llm/Lib/site-packages/greenlet/platform/switch_arm64_masm.obj
new file mode 100644
index 0000000000000000000000000000000000000000..f6f220e4310baaa9756110685ce7d6a2bdf90c37
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/platform/switch_arm64_masm.obj differ
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_arm64_msvc.h b/llm/Lib/site-packages/greenlet/platform/switch_arm64_msvc.h
new file mode 100644
index 0000000000000000000000000000000000000000..7ab7f45be54a99bb2fef01fadb1cd9d1baefe393
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_arm64_msvc.h
@@ -0,0 +1,17 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 21-Oct-21  Niyas Sait  <niyas.sait@linaro.org>
+ *      First version to enable win/arm64 support.
+ */
+
+#define STACK_REFPLUS 1
+#define STACK_MAGIC 0
+
+/* Use the generic support for an external assembly language slp_switch function. */
+#define EXTERNAL_ASM
+
+#ifdef SLP_EVAL
+/* This always uses the external masm assembly file. */
+#endif
\ No newline at end of file
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_csky_gcc.h b/llm/Lib/site-packages/greenlet/platform/switch_csky_gcc.h
new file mode 100644
index 0000000000000000000000000000000000000000..ac469d3a0c68c51c3b12ee08e94c08291472f697
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_csky_gcc.h
@@ -0,0 +1,48 @@
+#ifdef SLP_EVAL
+#define STACK_MAGIC 0
+#define REG_FP "r8"
+#ifdef __CSKYABIV2__
+#define REGS_TO_SAVE_GENERAL "r4", "r5", "r6", "r7", "r9", "r10", "r11", "r15",\
+                             "r16", "r17", "r18", "r19", "r20", "r21", "r22",\
+                             "r23", "r24", "r25"
+
+#if defined (__CSKY_HARD_FLOAT__) || (__CSKY_VDSP__)
+#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL, "vr8", "vr9", "vr10", "vr11", "vr12",\
+                                           "vr13", "vr14", "vr15"
+#else
+#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL
+#endif
+#else
+#define REGS_TO_SAVE "r9", "r10", "r11", "r12", "r13", "r15"
+#endif
+
+
+static int
+#ifdef __GNUC__
+__attribute__((optimize("no-omit-frame-pointer")))
+#endif
+slp_switch(void)
+{
+        int *stackref, stsizediff;
+        int result;
+
+        __asm__ volatile ("" : : : REGS_TO_SAVE);
+        __asm__ ("mov %0, sp" : "=r" (stackref));
+        {
+                SLP_SAVE_STATE(stackref, stsizediff);
+                __asm__ volatile (
+                    "addu sp,%0\n"
+                    "addu "REG_FP",%0\n"
+                    :
+                    : "r" (stsizediff)
+                    );
+		
+                SLP_RESTORE_STATE();
+        }
+        __asm__ volatile ("movi %0, 0" : "=r" (result));
+        __asm__ volatile ("" : : : REGS_TO_SAVE);
+
+        return result;
+}
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_loongarch64_linux.h b/llm/Lib/site-packages/greenlet/platform/switch_loongarch64_linux.h
new file mode 100644
index 0000000000000000000000000000000000000000..9eaf34ef4328ff3c91e0363f793c4a575063cea4
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_loongarch64_linux.h
@@ -0,0 +1,31 @@
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+#define STACK_MAGIC 0
+
+#define REGS_TO_SAVE "s0", "s1", "s2", "s3", "s4", "s5", \
+                    "s6", "s7", "s8", "fp", \
+                    "f24", "f25", "f26", "f27", "f28", "f29", "f30", "f31"
+
+static int
+slp_switch(void)
+{
+    int ret;
+    long *stackref, stsizediff;
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("move %0, $sp" : "=r" (stackref) : );
+    {
+        SLP_SAVE_STATE(stackref, stsizediff);
+        __asm__ volatile (
+            "add.d $sp, $sp, %0\n\t"
+            : /* no outputs */
+            : "r" (stsizediff)
+        );
+        SLP_RESTORE_STATE();
+    }
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("move %0, $zero" : "=r" (ret) : );
+    return ret;
+}
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_m68k_gcc.h b/llm/Lib/site-packages/greenlet/platform/switch_m68k_gcc.h
new file mode 100644
index 0000000000000000000000000000000000000000..da761c2da81825aad0463af2c5864c2d9d8580e2
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_m68k_gcc.h
@@ -0,0 +1,38 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 2014-01-06  Andreas Schwab  <schwab@linux-m68k.org>
+ *      File created.
+ */
+
+#ifdef SLP_EVAL
+
+#define STACK_MAGIC 0
+
+#define REGS_TO_SAVE "%d2", "%d3", "%d4", "%d5", "%d6", "%d7", \
+		     "%a2", "%a3", "%a4"
+
+static int
+slp_switch(void)
+{
+  int err;
+  int *stackref, stsizediff;
+  void *fp, *a5;
+  __asm__ volatile ("" : : : REGS_TO_SAVE);
+  __asm__ volatile ("move.l %%fp, %0" : "=m"(fp));
+  __asm__ volatile ("move.l %%a5, %0" : "=m"(a5));
+  __asm__ ("move.l %%sp, %0" : "=r"(stackref));
+  {
+    SLP_SAVE_STATE(stackref, stsizediff);
+    __asm__ volatile ("add.l %0, %%sp; add.l %0, %%fp" : : "r"(stsizediff));
+    SLP_RESTORE_STATE();
+    __asm__ volatile ("clr.l %0" : "=g" (err));
+  }
+  __asm__ volatile ("move.l %0, %%a5" : : "m"(a5));
+  __asm__ volatile ("move.l %0, %%fp" : : "m"(fp));
+  __asm__ volatile ("" : : : REGS_TO_SAVE);
+  return err;
+}
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_mips_unix.h b/llm/Lib/site-packages/greenlet/platform/switch_mips_unix.h
new file mode 100644
index 0000000000000000000000000000000000000000..b9003e947d3c76cd4a79d6ada2fe78ddd3235361
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_mips_unix.h
@@ -0,0 +1,64 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 20-Sep-14 Matt Madison <madison@bliss-m.org>
+ *      Re-code the saving of the gp register for MIPS64.
+ * 05-Jan-08 Thiemo Seufer  <ths@debian.org>
+ *      Ported from ppc.
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+#define STACK_MAGIC 0
+
+#define REGS_TO_SAVE "$16", "$17", "$18", "$19", "$20", "$21", "$22", \
+       "$23", "$30"
+static int
+slp_switch(void)
+{
+    int err;
+    int *stackref, stsizediff;
+#ifdef __mips64
+    uint64_t gpsave;
+#endif
+    __asm__ __volatile__ ("" : : : REGS_TO_SAVE);
+#ifdef __mips64
+    __asm__ __volatile__ ("sd $28,%0" : "=m" (gpsave) : : );
+#endif
+    __asm__ ("move %0, $29" : "=r" (stackref) : );
+    {
+        SLP_SAVE_STATE(stackref, stsizediff);
+        __asm__ __volatile__ (
+#ifdef __mips64
+            "daddu $29, %0\n"
+#else
+            "addu $29, %0\n"
+#endif
+            : /* no outputs */
+            : "r" (stsizediff)
+            );
+        SLP_RESTORE_STATE();
+    }
+#ifdef __mips64
+    __asm__ __volatile__ ("ld $28,%0" : : "m" (gpsave) : );
+#endif
+    __asm__ __volatile__ ("" : : : REGS_TO_SAVE);
+    __asm__ __volatile__ ("move %0, $0" : "=r" (err));
+    return err;
+}
+
+#endif
+
+/*
+ * further self-processing support
+ */
+
+/*
+ * if you want to add self-inspection tools, place them
+ * here. See the x86_msvc for the necessary defines.
+ * These features are highly experimental und not
+ * essential yet.
+ */
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_ppc64_aix.h b/llm/Lib/site-packages/greenlet/platform/switch_ppc64_aix.h
new file mode 100644
index 0000000000000000000000000000000000000000..e7e0b87764c929c13fa01aa976b53db89562edfd
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_ppc64_aix.h
@@ -0,0 +1,103 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 16-Oct-20  Jesse Gorzinski <jgorzins@us.ibm.com>
+ *      Copied from Linux PPC64 implementation
+ * 04-Sep-18  Alexey Borzenkov  <snaury@gmail.com>
+ *      Workaround a gcc bug using manual save/restore of r30
+ * 21-Mar-18  Tulio Magno Quites Machado Filho  <tuliom@linux.vnet.ibm.com>
+ *      Added r30 to the list of saved registers in order to fully comply with
+ *      both ppc64 ELFv1 ABI and the ppc64le ELFv2 ABI, that classify this
+ *      register as a nonvolatile register used for local variables.
+ * 21-Mar-18  Laszlo Boszormenyi  <gcs@debian.org>
+ *      Save r2 (TOC pointer) manually.
+ * 10-Dec-13  Ulrich Weigand  <uweigand@de.ibm.com>
+ *	Support ELFv2 ABI.  Save float/vector registers.
+ * 09-Mar-12 Michael Ellerman <michael@ellerman.id.au>
+ *      64-bit implementation, copied from 32-bit.
+ * 07-Sep-05 (py-dev mailing list discussion)
+ *      removed 'r31' from the register-saved.  !!!! WARNING !!!!
+ *      It means that this file can no longer be compiled statically!
+ *      It is now only suitable as part of a dynamic library!
+ * 14-Jan-04  Bob Ippolito <bob@redivi.com>
+ *      added cr2-cr4 to the registers to be saved.
+ *      Open questions: Should we save FP registers?
+ *      What about vector registers?
+ *      Differences between darwin and unix?
+ * 24-Nov-02  Christian Tismer  <tismer@tismer.com>
+ *      needed to add another magic constant to insure
+ *      that f in slp_eval_frame(PyFrameObject *f)
+ *      STACK_REFPLUS will probably be 1 in most cases.
+ *      gets included into the saved stack area.
+ * 04-Oct-02  Gustavo Niemeyer <niemeyer@conectiva.com>
+ *      Ported from MacOS version.
+ * 17-Sep-02  Christian Tismer  <tismer@tismer.com>
+ *      after virtualizing stack save/restore, the
+ *      stack size shrunk a bit. Needed to introduce
+ *      an adjustment STACK_MAGIC per platform.
+ * 15-Sep-02  Gerd Woetzel       <gerd.woetzel@GMD.DE>
+ *      slightly changed framework for sparc
+ * 29-Jun-02  Christian Tismer  <tismer@tismer.com>
+ *      Added register 13-29, 31 saves. The same way as
+ *      Armin Rigo did for the x86_unix version.
+ *      This seems to be now fully functional!
+ * 04-Mar-02  Hye-Shik Chang  <perky@fallin.lv>
+ *      Ported from i386.
+ * 31-Jul-12  Trevor Bowen    <trevorbowen@gmail.com>
+ *      Changed memory constraints to register only.
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+#define STACK_MAGIC 6
+
+#if defined(__ALTIVEC__)
+#define ALTIVEC_REGS \
+       "v20", "v21", "v22", "v23", "v24", "v25", "v26", "v27", \
+       "v28", "v29", "v30", "v31",
+#else
+#define ALTIVEC_REGS
+#endif
+
+#define REGS_TO_SAVE "r14", "r15", "r16", "r17", "r18", "r19", "r20",  \
+       "r21", "r22", "r23", "r24", "r25", "r26", "r27", "r28", "r29",  \
+       "r31",                                                    \
+       "fr14", "fr15", "fr16", "fr17", "fr18", "fr19", "fr20", "fr21", \
+       "fr22", "fr23", "fr24", "fr25", "fr26", "fr27", "fr28", "fr29", \
+       "fr30", "fr31", \
+       ALTIVEC_REGS \
+       "cr2", "cr3", "cr4"
+
+static int
+slp_switch(void)
+{
+    int err;
+    long *stackref, stsizediff;
+    void * toc;
+    void * r30;
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("std 2, %0" : "=m" (toc));
+    __asm__ volatile ("std 30, %0" : "=m" (r30));
+    __asm__ ("mr %0, 1" : "=r" (stackref) : );
+    {
+        SLP_SAVE_STATE(stackref, stsizediff);
+        __asm__ volatile (
+            "mr 11, %0\n"
+            "add 1, 1, 11\n"
+            : /* no outputs */
+            : "r" (stsizediff)
+            : "11"
+            );
+        SLP_RESTORE_STATE();
+    }
+    __asm__ volatile ("ld 30, %0" : : "m" (r30));
+    __asm__ volatile ("ld 2, %0" : : "m" (toc));
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("li %0, 0" : "=r" (err));
+    return err;
+}
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_ppc64_linux.h b/llm/Lib/site-packages/greenlet/platform/switch_ppc64_linux.h
new file mode 100644
index 0000000000000000000000000000000000000000..3c324d00c62894f7fdc04dd0c6b52b13c3e3c606
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_ppc64_linux.h
@@ -0,0 +1,105 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 04-Sep-18  Alexey Borzenkov  <snaury@gmail.com>
+ *      Workaround a gcc bug using manual save/restore of r30
+ * 21-Mar-18  Tulio Magno Quites Machado Filho  <tuliom@linux.vnet.ibm.com>
+ *      Added r30 to the list of saved registers in order to fully comply with
+ *      both ppc64 ELFv1 ABI and the ppc64le ELFv2 ABI, that classify this
+ *      register as a nonvolatile register used for local variables.
+ * 21-Mar-18  Laszlo Boszormenyi  <gcs@debian.org>
+ *      Save r2 (TOC pointer) manually.
+ * 10-Dec-13  Ulrich Weigand  <uweigand@de.ibm.com>
+ *	Support ELFv2 ABI.  Save float/vector registers.
+ * 09-Mar-12 Michael Ellerman <michael@ellerman.id.au>
+ *      64-bit implementation, copied from 32-bit.
+ * 07-Sep-05 (py-dev mailing list discussion)
+ *      removed 'r31' from the register-saved.  !!!! WARNING !!!!
+ *      It means that this file can no longer be compiled statically!
+ *      It is now only suitable as part of a dynamic library!
+ * 14-Jan-04  Bob Ippolito <bob@redivi.com>
+ *      added cr2-cr4 to the registers to be saved.
+ *      Open questions: Should we save FP registers?
+ *      What about vector registers?
+ *      Differences between darwin and unix?
+ * 24-Nov-02  Christian Tismer  <tismer@tismer.com>
+ *      needed to add another magic constant to insure
+ *      that f in slp_eval_frame(PyFrameObject *f)
+ *      STACK_REFPLUS will probably be 1 in most cases.
+ *      gets included into the saved stack area.
+ * 04-Oct-02  Gustavo Niemeyer <niemeyer@conectiva.com>
+ *      Ported from MacOS version.
+ * 17-Sep-02  Christian Tismer  <tismer@tismer.com>
+ *      after virtualizing stack save/restore, the
+ *      stack size shrunk a bit. Needed to introduce
+ *      an adjustment STACK_MAGIC per platform.
+ * 15-Sep-02  Gerd Woetzel       <gerd.woetzel@GMD.DE>
+ *      slightly changed framework for sparc
+ * 29-Jun-02  Christian Tismer  <tismer@tismer.com>
+ *      Added register 13-29, 31 saves. The same way as
+ *      Armin Rigo did for the x86_unix version.
+ *      This seems to be now fully functional!
+ * 04-Mar-02  Hye-Shik Chang  <perky@fallin.lv>
+ *      Ported from i386.
+ * 31-Jul-12  Trevor Bowen    <trevorbowen@gmail.com>
+ *      Changed memory constraints to register only.
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+#if _CALL_ELF == 2
+#define STACK_MAGIC 4
+#else
+#define STACK_MAGIC 6
+#endif
+
+#if defined(__ALTIVEC__)
+#define ALTIVEC_REGS \
+       "v20", "v21", "v22", "v23", "v24", "v25", "v26", "v27", \
+       "v28", "v29", "v30", "v31",
+#else
+#define ALTIVEC_REGS
+#endif
+
+#define REGS_TO_SAVE "r14", "r15", "r16", "r17", "r18", "r19", "r20",  \
+       "r21", "r22", "r23", "r24", "r25", "r26", "r27", "r28", "r29",  \
+       "r31",                                                    \
+       "fr14", "fr15", "fr16", "fr17", "fr18", "fr19", "fr20", "fr21", \
+       "fr22", "fr23", "fr24", "fr25", "fr26", "fr27", "fr28", "fr29", \
+       "fr30", "fr31", \
+       ALTIVEC_REGS \
+       "cr2", "cr3", "cr4"
+
+static int
+slp_switch(void)
+{
+    int err;
+    long *stackref, stsizediff;
+    void * toc;
+    void * r30;
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("std 2, %0" : "=m" (toc));
+    __asm__ volatile ("std 30, %0" : "=m" (r30));
+    __asm__ ("mr %0, 1" : "=r" (stackref) : );
+    {
+        SLP_SAVE_STATE(stackref, stsizediff);
+        __asm__ volatile (
+            "mr 11, %0\n"
+            "add 1, 1, 11\n"
+            : /* no outputs */
+            : "r" (stsizediff)
+            : "11"
+            );
+        SLP_RESTORE_STATE();
+    }
+    __asm__ volatile ("ld 30, %0" : : "m" (r30));
+    __asm__ volatile ("ld 2, %0" : : "m" (toc));
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("li %0, 0" : "=r" (err));
+    return err;
+}
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_ppc_aix.h b/llm/Lib/site-packages/greenlet/platform/switch_ppc_aix.h
new file mode 100644
index 0000000000000000000000000000000000000000..6d93c13266a623bc2b0d59ff2db7f7224fe3b347
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_ppc_aix.h
@@ -0,0 +1,87 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 07-Mar-11 Floris Bruynooghe <flub@devork.be>
+ *      Do not add stsizediff to general purpose
+ *      register (GPR) 30 as this is a non-volatile and
+ *      unused by the PowerOpen Environment, therefore
+ *      this was modifying a user register instead of the
+ *      frame pointer (which does not seem to exist).
+ * 07-Sep-05 (py-dev mailing list discussion)
+ *      removed 'r31' from the register-saved.  !!!! WARNING !!!!
+ *      It means that this file can no longer be compiled statically!
+ *      It is now only suitable as part of a dynamic library!
+ * 14-Jan-04  Bob Ippolito <bob@redivi.com>
+ *      added cr2-cr4 to the registers to be saved.
+ *      Open questions: Should we save FP registers?
+ *      What about vector registers?
+ *      Differences between darwin and unix?
+ * 24-Nov-02  Christian Tismer  <tismer@tismer.com>
+ *      needed to add another magic constant to insure
+ *      that f in slp_eval_frame(PyFrameObject *f)
+ *      STACK_REFPLUS will probably be 1 in most cases.
+ *      gets included into the saved stack area.
+ * 04-Oct-02  Gustavo Niemeyer <niemeyer@conectiva.com>
+ *      Ported from MacOS version.
+ * 17-Sep-02  Christian Tismer  <tismer@tismer.com>
+ *      after virtualizing stack save/restore, the
+ *      stack size shrunk a bit. Needed to introduce
+ *      an adjustment STACK_MAGIC per platform.
+ * 15-Sep-02  Gerd Woetzel       <gerd.woetzel@GMD.DE>
+ *      slightly changed framework for sparc
+ * 29-Jun-02  Christian Tismer  <tismer@tismer.com>
+ *      Added register 13-29, 31 saves. The same way as
+ *      Armin Rigo did for the x86_unix version.
+ *      This seems to be now fully functional!
+ * 04-Mar-02  Hye-Shik Chang  <perky@fallin.lv>
+ *      Ported from i386.
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+#define STACK_MAGIC 3
+
+/* !!!!WARNING!!!! need to add "r31" in the next line if this header file
+ * is meant to be compiled non-dynamically!
+ */
+#define REGS_TO_SAVE "r13", "r14", "r15", "r16", "r17", "r18", "r19", "r20", \
+       "r21", "r22", "r23", "r24", "r25", "r26", "r27", "r28", "r29", \
+       "cr2", "cr3", "cr4"
+static int
+slp_switch(void)
+{
+    int err;
+    int *stackref, stsizediff;
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ ("mr %0, 1" : "=r" (stackref) : );
+    {
+        SLP_SAVE_STATE(stackref, stsizediff);
+        __asm__ volatile (
+            "mr 11, %0\n"
+            "add 1, 1, 11\n"
+            : /* no outputs */
+            : "r" (stsizediff)
+            : "11"
+            );
+        SLP_RESTORE_STATE();
+    }
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("li %0, 0" : "=r" (err));
+    return err;
+}
+
+#endif
+
+/*
+ * further self-processing support
+ */
+
+/*
+ * if you want to add self-inspection tools, place them
+ * here. See the x86_msvc for the necessary defines.
+ * These features are highly experimental und not
+ * essential yet.
+ */
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_ppc_linux.h b/llm/Lib/site-packages/greenlet/platform/switch_ppc_linux.h
new file mode 100644
index 0000000000000000000000000000000000000000..e83ad70a5f868265e9b1edaf27cd26feddfdf153
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_ppc_linux.h
@@ -0,0 +1,84 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 07-Sep-05 (py-dev mailing list discussion)
+ *      removed 'r31' from the register-saved.  !!!! WARNING !!!!
+ *      It means that this file can no longer be compiled statically!
+ *      It is now only suitable as part of a dynamic library!
+ * 14-Jan-04  Bob Ippolito <bob@redivi.com>
+ *      added cr2-cr4 to the registers to be saved.
+ *      Open questions: Should we save FP registers?
+ *      What about vector registers?
+ *      Differences between darwin and unix?
+ * 24-Nov-02  Christian Tismer  <tismer@tismer.com>
+ *      needed to add another magic constant to insure
+ *      that f in slp_eval_frame(PyFrameObject *f)
+ *      STACK_REFPLUS will probably be 1 in most cases.
+ *      gets included into the saved stack area.
+ * 04-Oct-02  Gustavo Niemeyer <niemeyer@conectiva.com>
+ *      Ported from MacOS version.
+ * 17-Sep-02  Christian Tismer  <tismer@tismer.com>
+ *      after virtualizing stack save/restore, the
+ *      stack size shrunk a bit. Needed to introduce
+ *      an adjustment STACK_MAGIC per platform.
+ * 15-Sep-02  Gerd Woetzel       <gerd.woetzel@GMD.DE>
+ *      slightly changed framework for sparc
+ * 29-Jun-02  Christian Tismer  <tismer@tismer.com>
+ *      Added register 13-29, 31 saves. The same way as
+ *      Armin Rigo did for the x86_unix version.
+ *      This seems to be now fully functional!
+ * 04-Mar-02  Hye-Shik Chang  <perky@fallin.lv>
+ *      Ported from i386.
+ * 31-Jul-12  Trevor Bowen    <trevorbowen@gmail.com>
+ *      Changed memory constraints to register only.
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+#define STACK_MAGIC 3
+
+/* !!!!WARNING!!!! need to add "r31" in the next line if this header file
+ * is meant to be compiled non-dynamically!
+ */
+#define REGS_TO_SAVE "r13", "r14", "r15", "r16", "r17", "r18", "r19", "r20", \
+       "r21", "r22", "r23", "r24", "r25", "r26", "r27", "r28", "r29", \
+       "cr2", "cr3", "cr4"
+static int
+slp_switch(void)
+{
+    int err;
+    int *stackref, stsizediff;
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ ("mr %0, 1" : "=r" (stackref) : );
+    {
+        SLP_SAVE_STATE(stackref, stsizediff);
+        __asm__ volatile (
+            "mr 11, %0\n"
+            "add 1, 1, 11\n"
+            "add 30, 30, 11\n"
+            : /* no outputs */
+            : "r" (stsizediff)
+            : "11"
+            );
+        SLP_RESTORE_STATE();
+    }
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("li %0, 0" : "=r" (err));
+    return err;
+}
+
+#endif
+
+/*
+ * further self-processing support
+ */
+
+/*
+ * if you want to add self-inspection tools, place them
+ * here. See the x86_msvc for the necessary defines.
+ * These features are highly experimental und not
+ * essential yet.
+ */
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_ppc_macosx.h b/llm/Lib/site-packages/greenlet/platform/switch_ppc_macosx.h
new file mode 100644
index 0000000000000000000000000000000000000000..d6e5a03c24390b9426e95540cc0578d3bf0f2465
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_ppc_macosx.h
@@ -0,0 +1,82 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 07-Sep-05 (py-dev mailing list discussion)
+ *      removed 'r31' from the register-saved.  !!!! WARNING !!!!
+ *      It means that this file can no longer be compiled statically!
+ *      It is now only suitable as part of a dynamic library!
+ * 14-Jan-04  Bob Ippolito <bob@redivi.com>
+ *      added cr2-cr4 to the registers to be saved.
+ *      Open questions: Should we save FP registers?
+ *      What about vector registers?
+ *      Differences between darwin and unix?
+ * 24-Nov-02  Christian Tismer  <tismer@tismer.com>
+ *      needed to add another magic constant to insure
+ *      that f in slp_eval_frame(PyFrameObject *f)
+ *      STACK_REFPLUS will probably be 1 in most cases.
+ *      gets included into the saved stack area.
+ * 17-Sep-02  Christian Tismer  <tismer@tismer.com>
+ *      after virtualizing stack save/restore, the
+ *      stack size shrunk a bit. Needed to introduce
+ *      an adjustment STACK_MAGIC per platform.
+ * 15-Sep-02  Gerd Woetzel       <gerd.woetzel@GMD.DE>
+ *      slightly changed framework for sparc
+ * 29-Jun-02  Christian Tismer  <tismer@tismer.com>
+ *      Added register 13-29, 31 saves. The same way as
+ *      Armin Rigo did for the x86_unix version.
+ *      This seems to be now fully functional!
+ * 04-Mar-02  Hye-Shik Chang  <perky@fallin.lv>
+ *      Ported from i386.
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+#define STACK_MAGIC 3
+
+/* !!!!WARNING!!!! need to add "r31" in the next line if this header file
+ * is meant to be compiled non-dynamically!
+ */
+#define REGS_TO_SAVE "r13", "r14", "r15", "r16", "r17", "r18", "r19", "r20", \
+       "r21", "r22", "r23", "r24", "r25", "r26", "r27", "r28", "r29", \
+       "cr2", "cr3", "cr4"
+
+static int
+slp_switch(void)
+{
+    int err;
+    int *stackref, stsizediff;
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ ("; asm block 2\n\tmr %0, r1" : "=g" (stackref) : );
+    {
+        SLP_SAVE_STATE(stackref, stsizediff);
+        __asm__ volatile (
+            "; asm block 3\n"
+            "\tmr r11, %0\n"
+            "\tadd r1, r1, r11\n"
+            "\tadd r30, r30, r11\n"
+            : /* no outputs */
+            : "g" (stsizediff)
+            : "r11"
+            );
+        SLP_RESTORE_STATE();
+    }
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("li %0, 0" : "=r" (err));
+    return err;
+}
+
+#endif
+
+/*
+ * further self-processing support
+ */
+
+/*
+ * if you want to add self-inspection tools, place them
+ * here. See the x86_msvc for the necessary defines.
+ * These features are highly experimental und not
+ * essential yet.
+ */
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_ppc_unix.h b/llm/Lib/site-packages/greenlet/platform/switch_ppc_unix.h
new file mode 100644
index 0000000000000000000000000000000000000000..ca590a59fc0322d20c56a5fccd4412df6bdec3ae
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_ppc_unix.h
@@ -0,0 +1,82 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 07-Sep-05 (py-dev mailing list discussion)
+ *      removed 'r31' from the register-saved.  !!!! WARNING !!!!
+ *      It means that this file can no longer be compiled statically!
+ *      It is now only suitable as part of a dynamic library!
+ * 14-Jan-04  Bob Ippolito <bob@redivi.com>
+ *      added cr2-cr4 to the registers to be saved.
+ *      Open questions: Should we save FP registers?
+ *      What about vector registers?
+ *      Differences between darwin and unix?
+ * 24-Nov-02  Christian Tismer  <tismer@tismer.com>
+ *      needed to add another magic constant to insure
+ *      that f in slp_eval_frame(PyFrameObject *f)
+ *      STACK_REFPLUS will probably be 1 in most cases.
+ *      gets included into the saved stack area.
+ * 04-Oct-02  Gustavo Niemeyer <niemeyer@conectiva.com>
+ *      Ported from MacOS version.
+ * 17-Sep-02  Christian Tismer  <tismer@tismer.com>
+ *      after virtualizing stack save/restore, the
+ *      stack size shrunk a bit. Needed to introduce
+ *      an adjustment STACK_MAGIC per platform.
+ * 15-Sep-02  Gerd Woetzel       <gerd.woetzel@GMD.DE>
+ *      slightly changed framework for sparc
+ * 29-Jun-02  Christian Tismer  <tismer@tismer.com>
+ *      Added register 13-29, 31 saves. The same way as
+ *      Armin Rigo did for the x86_unix version.
+ *      This seems to be now fully functional!
+ * 04-Mar-02  Hye-Shik Chang  <perky@fallin.lv>
+ *      Ported from i386.
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+#define STACK_MAGIC 3
+
+/* !!!!WARNING!!!! need to add "r31" in the next line if this header file
+ * is meant to be compiled non-dynamically!
+ */
+#define REGS_TO_SAVE "r13", "r14", "r15", "r16", "r17", "r18", "r19", "r20", \
+       "r21", "r22", "r23", "r24", "r25", "r26", "r27", "r28", "r29", \
+       "cr2", "cr3", "cr4"
+static int
+slp_switch(void)
+{
+    int err;
+    int *stackref, stsizediff;
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ ("mr %0, 1" : "=g" (stackref) : );
+    {
+        SLP_SAVE_STATE(stackref, stsizediff);
+        __asm__ volatile (
+            "mr 11, %0\n"
+            "add 1, 1, 11\n"
+            "add 30, 30, 11\n"
+            : /* no outputs */
+            : "g" (stsizediff)
+            : "11"
+            );
+        SLP_RESTORE_STATE();
+    }
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("li %0, 0" : "=r" (err));
+    return err;
+}
+
+#endif
+
+/*
+ * further self-processing support
+ */
+
+/*
+ * if you want to add self-inspection tools, place them
+ * here. See the x86_msvc for the necessary defines.
+ * These features are highly experimental und not
+ * essential yet.
+ */
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_riscv_unix.h b/llm/Lib/site-packages/greenlet/platform/switch_riscv_unix.h
new file mode 100644
index 0000000000000000000000000000000000000000..24df9dbbec6dc619f39af0b1ee7677988dbcb53a
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_riscv_unix.h
@@ -0,0 +1,32 @@
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+#define STACK_MAGIC 0
+
+#define REGS_TO_SAVE "s0", "s1", "s2", "s3", "s4", "s5", \
+		     "s6", "s7", "s8", "s9", "s10", "s11", "fs0", "fs1", \
+		     "fs2", "fs3", "fs4", "fs5", "fs6", "fs7", "fs8", "fs9", \
+		     "fs10", "fs11"
+
+static int
+slp_switch(void)
+{
+  int ret;
+  long *stackref, stsizediff;
+  __asm__ volatile ("" : : : REGS_TO_SAVE);
+  __asm__ volatile ("mv %0, sp" : "=r" (stackref) : );
+  {
+      SLP_SAVE_STATE(stackref, stsizediff);
+      __asm__ volatile (
+	  "add sp, sp, %0\n\t"
+	  : /* no outputs */
+	  : "r" (stsizediff)
+	  );
+      SLP_RESTORE_STATE();
+  }
+  __asm__ volatile ("" : : : REGS_TO_SAVE);
+  __asm__ volatile ("mv %0, zero" : "=r" (ret) : );
+  return ret;
+}
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_s390_unix.h b/llm/Lib/site-packages/greenlet/platform/switch_s390_unix.h
new file mode 100644
index 0000000000000000000000000000000000000000..9199367f8b02d89856ed2be082a3aba6222df205
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_s390_unix.h
@@ -0,0 +1,87 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 25-Jan-12  Alexey Borzenkov <snaury@gmail.com>
+ *      Fixed Linux/S390 port to work correctly with
+ *      different optimization options both on 31-bit
+ *      and 64-bit. Thanks to Stefan Raabe for lots
+ *      of testing.
+ * 24-Nov-02  Christian Tismer  <tismer@tismer.com>
+ *      needed to add another magic constant to insure
+ *      that f in slp_eval_frame(PyFrameObject *f)
+ *      STACK_REFPLUS will probably be 1 in most cases.
+ *      gets included into the saved stack area.
+ * 06-Oct-02  Gustavo Niemeyer <niemeyer@conectiva.com>
+ *      Ported to Linux/S390.
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+#ifdef __s390x__
+#define STACK_MAGIC 20 /* 20 * 8 = 160 bytes of function call area */
+#else
+#define STACK_MAGIC 24 /* 24 * 4 = 96 bytes of function call area */
+#endif
+
+/* Technically, r11-r13 also need saving, but function prolog starts
+   with stm(g) and since there are so many saved registers already
+   it won't be optimized, resulting in all r6-r15 being saved */
+#define REGS_TO_SAVE "r6", "r7", "r8", "r9", "r10", "r14", \
+		     "f0", "f1", "f2", "f3", "f4", "f5", "f6", "f7", \
+		     "f8", "f9", "f10", "f11", "f12", "f13", "f14", "f15"
+
+static int
+slp_switch(void)
+{
+    int ret;
+    long *stackref, stsizediff;
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+#ifdef __s390x__
+    __asm__ volatile ("lgr %0, 15" : "=r" (stackref) : );
+#else
+    __asm__ volatile ("lr %0, 15" : "=r" (stackref) : );
+#endif
+    {
+        SLP_SAVE_STATE(stackref, stsizediff);
+/* N.B.
+   r11 may be used as the frame pointer, and in that case it cannot be
+   clobbered and needs offsetting just like the stack pointer (but in cases
+   where frame pointer isn't used we might clobber it accidentally). What's
+   scary is that r11 is 2nd (and even 1st when GOT is used) callee saved
+   register that gcc would chose for surviving function calls. However,
+   since r6-r10 are clobbered above, their cost for reuse is reduced, so
+   gcc IRA will chose them over r11 (not seeing r11 is implicitly saved),
+   making it relatively safe to offset in all cases. :) */
+        __asm__ volatile (
+#ifdef __s390x__
+            "agr 15, %0\n\t"
+            "agr 11, %0"
+#else
+            "ar 15, %0\n\t"
+            "ar 11, %0"
+#endif
+            : /* no outputs */
+            : "r" (stsizediff)
+            );
+        SLP_RESTORE_STATE();
+    }
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("lhi %0, 0" : "=r" (ret) : );
+    return ret;
+}
+
+#endif
+
+/*
+ * further self-processing support
+ */
+
+/* 
+ * if you want to add self-inspection tools, place them
+ * here. See the x86_msvc for the necessary defines.
+ * These features are highly experimental und not
+ * essential yet.
+ */
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_sparc_sun_gcc.h b/llm/Lib/site-packages/greenlet/platform/switch_sparc_sun_gcc.h
new file mode 100644
index 0000000000000000000000000000000000000000..96990c391724c0dd2b3868ae220c929e16a73959
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_sparc_sun_gcc.h
@@ -0,0 +1,92 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 16-May-15  Alexey Borzenkov <snaury@gmail.com>
+ *      Move stack spilling code inside save/restore functions
+ * 30-Aug-13  Floris Bruynooghe <flub@devork.be>
+        Clean the register windows again before returning.
+        This does not clobber the PIC register as it leaves
+        the current window intact and is required for multi-
+        threaded code to work correctly.
+ * 08-Mar-11  Floris Bruynooghe <flub@devork.be>
+ *      No need to set return value register explicitly
+ *      before the stack and framepointer are adjusted
+ *      as none of the other registers are influenced by
+ *      this.  Also don't needlessly clean the windows
+ *      ('ta %0" :: "i" (ST_CLEAN_WINDOWS)') as that
+ *      clobbers the gcc PIC register (%l7).
+ * 24-Nov-02  Christian Tismer  <tismer@tismer.com>
+ *      needed to add another magic constant to insure
+ *      that f in slp_eval_frame(PyFrameObject *f)
+ *      STACK_REFPLUS will probably be 1 in most cases.
+ *      gets included into the saved stack area.
+ * 17-Sep-02  Christian Tismer  <tismer@tismer.com>
+ *      after virtualizing stack save/restore, the
+ *      stack size shrunk a bit. Needed to introduce
+ *      an adjustment STACK_MAGIC per platform.
+ * 15-Sep-02  Gerd Woetzel       <gerd.woetzel@GMD.DE>
+ *      added support for SunOS sparc with gcc
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+
+#define STACK_MAGIC 0
+
+
+#if defined(__sparcv9)
+#define SLP_FLUSHW __asm__ volatile ("flushw")
+#else
+#define SLP_FLUSHW __asm__ volatile ("ta 3") /* ST_FLUSH_WINDOWS */
+#endif
+
+/* On sparc we need to spill register windows inside save/restore functions */
+#define SLP_BEFORE_SAVE_STATE() SLP_FLUSHW
+#define SLP_BEFORE_RESTORE_STATE() SLP_FLUSHW
+
+
+static int
+slp_switch(void)
+{
+    int err;
+    int *stackref, stsizediff;
+
+    /* Put current stack pointer into stackref.
+     * Register spilling is done in save/restore.
+     */
+    __asm__ volatile ("mov %%sp, %0" : "=r" (stackref));
+
+    {
+        /* Thou shalt put SLP_SAVE_STATE into a local block */
+        /* Copy the current stack onto the heap */
+        SLP_SAVE_STATE(stackref, stsizediff);
+
+        /* Increment stack and frame pointer by stsizediff */
+        __asm__ volatile (
+            "add %0, %%sp, %%sp\n\t"
+            "add %0, %%fp, %%fp"
+            : : "r" (stsizediff));
+
+        /* Copy new stack from it's save store on the heap */
+        SLP_RESTORE_STATE();
+
+        __asm__ volatile ("mov %1, %0" : "=r" (err) : "i" (0));
+        return err;
+    }
+}
+
+#endif
+
+/*
+ * further self-processing support
+ */
+
+/*
+ * if you want to add self-inspection tools, place them
+ * here. See the x86_msvc for the necessary defines.
+ * These features are highly experimental und not
+ * essential yet.
+ */
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_x32_unix.h b/llm/Lib/site-packages/greenlet/platform/switch_x32_unix.h
new file mode 100644
index 0000000000000000000000000000000000000000..893369c7a96aeafcbb030c4e13979d62cb587d08
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_x32_unix.h
@@ -0,0 +1,63 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 17-Aug-12  Fantix King <fantix.king@gmail.com>
+ *      Ported from amd64.
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+#define STACK_MAGIC 0
+
+#define REGS_TO_SAVE "r12", "r13", "r14", "r15"
+
+
+static int
+slp_switch(void)
+{
+    void* ebp;
+    void* ebx;
+    unsigned int csr;
+    unsigned short cw;
+    int err;
+    int *stackref, stsizediff;
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("fstcw %0" : "=m" (cw));
+    __asm__ volatile ("stmxcsr %0" : "=m" (csr));
+    __asm__ volatile ("movl %%ebp, %0" : "=m" (ebp));
+    __asm__ volatile ("movl %%ebx, %0" : "=m" (ebx));
+    __asm__ ("movl %%esp, %0" : "=g" (stackref));
+    {
+        SLP_SAVE_STATE(stackref, stsizediff);
+        __asm__ volatile (
+            "addl %0, %%esp\n"
+            "addl %0, %%ebp\n"
+            :
+            : "r" (stsizediff)
+            );
+        SLP_RESTORE_STATE();
+    }
+    __asm__ volatile ("movl %0, %%ebx" : : "m" (ebx));
+    __asm__ volatile ("movl %0, %%ebp" : : "m" (ebp));
+    __asm__ volatile ("ldmxcsr %0" : : "m" (csr));
+    __asm__ volatile ("fldcw %0" : : "m" (cw));
+    __asm__ volatile ("" : : : REGS_TO_SAVE);
+    __asm__ volatile ("xorl %%eax, %%eax" : "=a" (err));
+    return err;
+}
+
+#endif
+
+/*
+ * further self-processing support
+ */
+
+/*
+ * if you want to add self-inspection tools, place them
+ * here. See the x86_msvc for the necessary defines.
+ * These features are highly experimental und not
+ * essential yet.
+ */
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_x64_masm.asm b/llm/Lib/site-packages/greenlet/platform/switch_x64_masm.asm
new file mode 100644
index 0000000000000000000000000000000000000000..f5c72a27d5a020ce0d21553de5d7b3c6a1db4fdc
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_x64_masm.asm
@@ -0,0 +1,111 @@
+;
+; stack switching code for MASM on x641
+; Kristjan Valur Jonsson, sept 2005
+;
+
+
+;prototypes for our calls
+slp_save_state_asm PROTO
+slp_restore_state_asm PROTO
+
+
+pushxmm MACRO reg
+    sub rsp, 16
+    .allocstack 16
+    movaps [rsp], reg ; faster than movups, but we must be aligned
+    ; .savexmm128 reg, offset  (don't know what offset is, no documentation)
+ENDM
+popxmm MACRO reg
+    movaps reg, [rsp] ; faster than movups, but we must be aligned
+    add rsp, 16
+ENDM
+
+pushreg MACRO reg
+    push reg
+    .pushreg reg
+ENDM
+popreg MACRO reg
+    pop reg
+ENDM
+
+
+.code
+slp_switch PROC FRAME
+    ;realign stack to 16 bytes after return address push, makes the following faster
+    sub rsp,8
+    .allocstack 8
+
+    pushxmm xmm15
+    pushxmm xmm14
+    pushxmm xmm13
+    pushxmm xmm12
+    pushxmm xmm11
+    pushxmm xmm10
+    pushxmm xmm9
+    pushxmm xmm8
+    pushxmm xmm7
+    pushxmm xmm6
+
+    pushreg r15
+    pushreg r14
+    pushreg r13
+    pushreg r12
+
+    pushreg rbp
+    pushreg rbx
+    pushreg rdi
+    pushreg rsi
+
+    sub rsp, 10h ;allocate the singlefunction argument (must be multiple of 16)
+    .allocstack 10h
+.endprolog
+
+    lea rcx, [rsp+10h] ;load stack base that we are saving
+    call slp_save_state_asm ;pass stackpointer, return offset in eax
+    cmp rax, 1
+    je EXIT1
+    cmp rax, -1
+    je EXIT2
+    ;actual stack switch:
+    add rsp, rax
+    call slp_restore_state_asm
+    xor rax, rax ;return 0
+
+EXIT:
+
+    add rsp, 10h
+    popreg rsi
+    popreg rdi
+    popreg rbx
+    popreg rbp
+
+    popreg r12
+    popreg r13
+    popreg r14
+    popreg r15
+
+    popxmm xmm6
+    popxmm xmm7
+    popxmm xmm8
+    popxmm xmm9
+    popxmm xmm10
+    popxmm xmm11
+    popxmm xmm12
+    popxmm xmm13
+    popxmm xmm14
+    popxmm xmm15
+
+    add rsp, 8
+    ret
+
+EXIT1:
+    mov rax, 1
+    jmp EXIT
+
+EXIT2:
+    sar rax, 1
+    jmp EXIT
+
+slp_switch ENDP
+
+END
\ No newline at end of file
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_x64_masm.obj b/llm/Lib/site-packages/greenlet/platform/switch_x64_masm.obj
new file mode 100644
index 0000000000000000000000000000000000000000..64e3e6b898ec765d4e37075f7b1635ad24c9efa2
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/platform/switch_x64_masm.obj differ
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_x64_msvc.h b/llm/Lib/site-packages/greenlet/platform/switch_x64_msvc.h
new file mode 100644
index 0000000000000000000000000000000000000000..601ea56053cfa03bd99dce523d0aaec7f240276b
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_x64_msvc.h
@@ -0,0 +1,60 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 24-Nov-02  Christian Tismer  <tismer@tismer.com>
+ *      needed to add another magic constant to insure
+ *      that f in slp_eval_frame(PyFrameObject *f)
+ *      STACK_REFPLUS will probably be 1 in most cases.
+ *      gets included into the saved stack area.
+ * 26-Sep-02  Christian Tismer  <tismer@tismer.com>
+ *      again as a result of virtualized stack access,
+ *      the compiler used less registers. Needed to
+ *      explicit mention registers in order to get them saved.
+ *      Thanks to Jeff Senn for pointing this out and help.
+ * 17-Sep-02  Christian Tismer  <tismer@tismer.com>
+ *      after virtualizing stack save/restore, the
+ *      stack size shrunk a bit. Needed to introduce
+ *      an adjustment STACK_MAGIC per platform.
+ * 15-Sep-02  Gerd Woetzel       <gerd.woetzel@GMD.DE>
+ *      slightly changed framework for sparc
+ * 01-Mar-02  Christian Tismer  <tismer@tismer.com>
+ *      Initial final version after lots of iterations for i386.
+ */
+
+/* Avoid alloca redefined warning on mingw64 */
+#ifndef alloca
+#define alloca _alloca
+#endif
+
+#define STACK_REFPLUS 1
+#define STACK_MAGIC 0
+
+/* Use the generic support for an external assembly language slp_switch function. */
+#define EXTERNAL_ASM
+
+#ifdef SLP_EVAL
+/* This always uses the external masm assembly file. */
+#endif
+
+/*
+ * further self-processing support
+ */
+
+/* we have IsBadReadPtr available, so we can peek at objects */
+/*
+#define STACKLESS_SPY
+
+#ifdef IMPLEMENT_STACKLESSMODULE
+#include "Windows.h"
+#define CANNOT_READ_MEM(p, bytes) IsBadReadPtr(p, bytes)
+
+static int IS_ON_STACK(void*p)
+{
+    int stackref;
+    intptr_t stackbase = ((intptr_t)&stackref) & 0xfffff000;
+    return (intptr_t)p >= stackbase && (intptr_t)p < stackbase + 0x00100000;
+}
+
+#endif
+*/
\ No newline at end of file
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_x86_msvc.h b/llm/Lib/site-packages/greenlet/platform/switch_x86_msvc.h
new file mode 100644
index 0000000000000000000000000000000000000000..0f3a59f52d1ec6da8f88d1911aa13d600b687350
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_x86_msvc.h
@@ -0,0 +1,326 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 24-Nov-02  Christian Tismer  <tismer@tismer.com>
+ *      needed to add another magic constant to insure
+ *      that f in slp_eval_frame(PyFrameObject *f)
+ *      STACK_REFPLUS will probably be 1 in most cases.
+ *      gets included into the saved stack area.
+ * 26-Sep-02  Christian Tismer  <tismer@tismer.com>
+ *      again as a result of virtualized stack access,
+ *      the compiler used less registers. Needed to
+ *      explicit mention registers in order to get them saved.
+ *      Thanks to Jeff Senn for pointing this out and help.
+ * 17-Sep-02  Christian Tismer  <tismer@tismer.com>
+ *      after virtualizing stack save/restore, the
+ *      stack size shrunk a bit. Needed to introduce
+ *      an adjustment STACK_MAGIC per platform.
+ * 15-Sep-02  Gerd Woetzel       <gerd.woetzel@GMD.DE>
+ *      slightly changed framework for sparc
+ * 01-Mar-02  Christian Tismer  <tismer@tismer.com>
+ *      Initial final version after lots of iterations for i386.
+ */
+
+#define alloca _alloca
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+#define STACK_MAGIC 0
+
+/* Some magic to quell warnings and keep slp_switch() from crashing when built
+   with VC90. Disable global optimizations, and the warning: frame pointer
+   register 'ebp' modified by inline assembly code.
+
+   We used to just disable global optimizations ("g") but upstream stackless
+   Python, as well as stackman, turn off all optimizations.
+
+References:
+https://github.com/stackless-dev/stackman/blob/dbc72fe5207a2055e658c819fdeab9731dee78b9/stackman/platforms/switch_x86_msvc.h
+https://github.com/stackless-dev/stackless/blob/main-slp/Stackless/platf/switch_x86_msvc.h
+*/
+#define WIN32_LEAN_AND_MEAN
+#include <windows.h>
+
+#pragma optimize("", off) /* so that autos are stored on the stack */
+#pragma warning(disable:4731)
+#pragma warning(disable:4733) /* disable warning about modifying FS[0] */
+
+/**
+ * Most modern compilers and environments handle C++ exceptions without any
+ * special help from us. MSVC on 32-bit windows is an exception. There, C++
+ * exceptions are dealt with using Windows' Structured Exception Handling
+ * (SEH).
+ *
+ * SEH is implemented as a singly linked list of <function*, prev*> nodes. The
+ * head of this list is stored in the Thread Information Block, which itself
+ * is pointed to from the FS register. It's the first field in the structure,
+ * or offset 0, so we can access it using assembly FS:[0], or the compiler
+ * intrinsics and field offset information from the headers (as we do below).
+ * Somewhat unusually, the tail of the list doesn't have prev == NULL, it has
+ * prev == 0xFFFFFFFF.
+ *
+ * SEH was designed for C, and traditionally uses the MSVC compiler
+ * intrinsincs __try{}/__except{}. It is also utilized for C++ exceptions by
+ * MSVC; there, every throw of a C++ exception raises a SEH error with the
+ * ExceptionCode 0xE06D7363; the SEH handler list is then traversed to
+ * deal with the exception.
+ *
+ * If the SEH list is corrupt, then when a C++ exception is thrown the program
+ * will abruptly exit with exit code 1. This does not use std::terminate(), so
+ * std::set_terminate() is useless to debug this.
+ *
+ * The SEH list is closely tied to the call stack; entering a function that
+ * uses __try{} or most C++ functions will push a new handler onto the front
+ * of the list. Returning from the function will remove the handler. Saving
+ * and restoring the head node of the SEH list (FS:[0]) per-greenlet is NOT
+ * ENOUGH to make SEH or exceptions work.
+ *
+ * Stack switching breaks SEH because the call stack no longer necessarily
+ * matches the SEH list. For example, given greenlet A that switches to
+ * greenlet B, at the moment of entering greenlet B, we will have any SEH
+ * handlers from greenlet A on the SEH list; greenlet B can then add its own
+ * handlers to the SEH list. When greenlet B switches back to greenlet A,
+ * greenlet B's handlers would still be on the SEH stack, but when switch()
+ * returns control to greenlet A, we have replaced the contents of the stack
+ * in memory, so all the address that greenlet B added to the SEH list are now
+ * invalid: part of the call stack has been unwound, but the SEH list was out
+ * of sync with the call stack. The net effect is that exception handling
+ * stops working.
+ *
+ * Thus, when switching greenlets, we need to be sure that the SEH list
+ * matches the effective call stack, "cutting out" any handlers that were
+ * pushed by the greenlet that switched out and which are no longer valid.
+ *
+ * The easiest way to do this is to capture the SEH list at the time the main
+ * greenlet for a thread is created, and, when initially starting a greenlet,
+ * start a new SEH list for it, which contains nothing but the handler
+ * established for the new greenlet itself, with the tail being the handlers
+ * for the main greenlet. If we then save and restore the SEH per-greenlet,
+ * they won't interfere with each others SEH lists. (No greenlet can unwind
+ * the call stack past the handlers established by the main greenlet).
+ *
+ * By observation, a new thread starts with three SEH handlers on the list. By
+ * the time we get around to creating the main greenlet, though, there can be
+ * many more, established by transient calls that lead to the creation of the
+ * main greenlet. Therefore, 3 is a magic constant telling us when to perform
+ * the initial slice.
+ *
+ * All of this can be debugged using a vectored exception handler, which
+ * operates independently of the SEH handler list, and is called first.
+ * Walking the SEH list at key points can also be helpful.
+ *
+ * References:
+ * https://en.wikipedia.org/wiki/Win32_Thread_Information_Block
+ * https://devblogs.microsoft.com/oldnewthing/20100730-00/?p=13273
+ * https://docs.microsoft.com/en-us/cpp/cpp/try-except-statement?view=msvc-160
+ * https://docs.microsoft.com/en-us/cpp/cpp/structured-exception-handling-c-cpp?view=msvc-160
+ * https://docs.microsoft.com/en-us/windows/win32/debug/structured-exception-handling
+ * https://docs.microsoft.com/en-us/windows/win32/debug/using-a-vectored-exception-handler
+ * https://bytepointer.com/resources/pietrek_crash_course_depths_of_win32_seh.htm
+ */
+#define GREENLET_NEEDS_EXCEPTION_STATE_SAVED
+
+
+typedef struct _GExceptionRegistration {
+    struct _GExceptionRegistration* prev;
+    void* handler_f;
+} GExceptionRegistration;
+
+static void
+slp_set_exception_state(const void *const seh_state)
+{
+    // Because the stack from from which we do this is ALSO a handler, and
+    // that one we want to keep, we need to relink the current SEH handler
+    // frame to point to this one, cutting out the middle men, as it were.
+    //
+    // Entering a try block doesn't change the SEH frame, but entering a
+    // function containing a try block does.
+    GExceptionRegistration* current_seh_state = (GExceptionRegistration*)__readfsdword(FIELD_OFFSET(NT_TIB, ExceptionList));
+    current_seh_state->prev = (GExceptionRegistration*)seh_state;
+}
+
+
+static GExceptionRegistration*
+x86_slp_get_third_oldest_handler()
+{
+    GExceptionRegistration* a = NULL; /* Closest to the top */
+    GExceptionRegistration* b = NULL; /* second */
+    GExceptionRegistration* c = NULL;
+    GExceptionRegistration* seh_state = (GExceptionRegistration*)__readfsdword(FIELD_OFFSET(NT_TIB, ExceptionList));
+    a = b = c = seh_state;
+
+    while (seh_state && seh_state != (GExceptionRegistration*)0xFFFFFFFF) {
+        if ((void*)seh_state->prev < (void*)100) {
+            fprintf(stderr, "\tERROR: Broken SEH chain.\n");
+            return NULL;
+        }
+        a = b;
+        b = c;
+        c = seh_state;
+
+        seh_state = seh_state->prev;
+    }
+    return a ? a : (b ? b : c);
+}
+
+
+static void*
+slp_get_exception_state()
+{
+    // XXX: There appear to be three SEH handlers on the stack already at the
+    // start of the thread. Is that a guarantee? Almost certainly not. Yet in
+    // all observed cases it has been three. This is consistent with
+    // faulthandler off or on, and optimizations off or on. It may not be
+    // consistent with other operating system versions, though: we only have
+    // CI on one or two versions (don't ask what there are).
+    // In theory we could capture the number of handlers on the chain when
+    // PyInit__greenlet is called: there are probably only the default
+    // handlers at that point (unless we're embedded and people have used
+    // __try/__except or a C++ handler)?
+    return x86_slp_get_third_oldest_handler();
+}
+
+static int
+slp_switch(void)
+{
+    /* MASM syntax is typically reversed from other assemblers.
+       It is usually <instruction> <destination> <source>
+     */
+    int *stackref, stsizediff;
+    /* store the structured exception state for this stack */
+    DWORD seh_state = __readfsdword(FIELD_OFFSET(NT_TIB, ExceptionList));
+    __asm mov stackref, esp;
+    /* modify EBX, ESI and EDI in order to get them preserved */
+    __asm mov ebx, ebx;
+    __asm xchg esi, edi;
+    {
+        SLP_SAVE_STATE(stackref, stsizediff);
+        __asm {
+            mov     eax, stsizediff
+            add     esp, eax
+            add     ebp, eax
+        }
+        SLP_RESTORE_STATE();
+    }
+    __writefsdword(FIELD_OFFSET(NT_TIB, ExceptionList), seh_state);
+    return 0;
+}
+
+/* re-enable ebp warning and global optimizations. */
+#pragma optimize("", on)
+#pragma warning(default:4731)
+#pragma warning(default:4733) /* disable warning about modifying FS[0] */
+
+
+#endif
+
+/*
+ * further self-processing support
+ */
+
+/* we have IsBadReadPtr available, so we can peek at objects */
+#define STACKLESS_SPY
+
+#ifdef GREENLET_DEBUG
+
+#define CANNOT_READ_MEM(p, bytes) IsBadReadPtr(p, bytes)
+
+static int IS_ON_STACK(void*p)
+{
+    int stackref;
+    int stackbase = ((int)&stackref) & 0xfffff000;
+    return (int)p >= stackbase && (int)p < stackbase + 0x00100000;
+}
+
+static void
+x86_slp_show_seh_chain()
+{
+    GExceptionRegistration* seh_state = (GExceptionRegistration*)__readfsdword(FIELD_OFFSET(NT_TIB, ExceptionList));
+    fprintf(stderr, "====== SEH Chain ======\n");
+    while (seh_state && seh_state != (GExceptionRegistration*)0xFFFFFFFF) {
+        fprintf(stderr, "\tSEH_chain addr: %p handler: %p prev: %p\n",
+                seh_state,
+                seh_state->handler_f, seh_state->prev);
+        if ((void*)seh_state->prev < (void*)100) {
+            fprintf(stderr, "\tERROR: Broken chain.\n");
+            break;
+        }
+        seh_state = seh_state->prev;
+    }
+    fprintf(stderr, "====== End SEH Chain ======\n");
+    fflush(NULL);
+    return;
+}
+
+//addVectoredExceptionHandler constants:
+//CALL_FIRST means call this exception handler first;
+//CALL_LAST means call this exception handler last
+#define CALL_FIRST 1
+#define CALL_LAST 0
+
+LONG WINAPI
+GreenletVectorHandler(PEXCEPTION_POINTERS ExceptionInfo)
+{
+    // We get one of these for every C++ exception, with code
+    // E06D7363
+    // This is a special value that means "C++ exception from MSVC"
+    // https://devblogs.microsoft.com/oldnewthing/20100730-00/?p=13273
+    //
+    // Install in the module init function with:
+    // AddVectoredExceptionHandler(CALL_FIRST, GreenletVectorHandler);
+    PEXCEPTION_RECORD ExceptionRecord = ExceptionInfo->ExceptionRecord;
+
+    fprintf(stderr,
+            "GOT VECTORED EXCEPTION:\n"
+            "\tExceptionCode   : %p\n"
+            "\tExceptionFlags  : %p\n"
+            "\tExceptionAddr   : %p\n"
+            "\tNumberparams    : %ld\n",
+            ExceptionRecord->ExceptionCode,
+            ExceptionRecord->ExceptionFlags,
+            ExceptionRecord->ExceptionAddress,
+            ExceptionRecord->NumberParameters
+            );
+    if (ExceptionRecord->ExceptionFlags & 1) {
+        fprintf(stderr,  "\t\tEH_NONCONTINUABLE\n" );
+    }
+    if (ExceptionRecord->ExceptionFlags & 2) {
+        fprintf(stderr,  "\t\tEH_UNWINDING\n" );
+    }
+    if (ExceptionRecord->ExceptionFlags & 4) {
+        fprintf(stderr, "\t\tEH_EXIT_UNWIND\n" );
+    }
+    if (ExceptionRecord->ExceptionFlags & 8) {
+        fprintf(stderr,  "\t\tEH_STACK_INVALID\n" );
+    }
+    if (ExceptionRecord->ExceptionFlags & 0x10) {
+        fprintf(stderr,  "\t\tEH_NESTED_CALL\n" );
+    }
+    if (ExceptionRecord->ExceptionFlags & 0x20) {
+        fprintf(stderr,  "\t\tEH_TARGET_UNWIND\n" );
+    }
+    if (ExceptionRecord->ExceptionFlags & 0x40) {
+        fprintf(stderr,  "\t\tEH_COLLIDED_UNWIND\n" );
+    }
+    fprintf(stderr, "\n");
+    fflush(NULL);
+    for(DWORD i = 0; i < ExceptionRecord->NumberParameters; i++) {
+        fprintf(stderr, "\t\t\tParam %ld: %lX\n", i, ExceptionRecord->ExceptionInformation[i]);
+    }
+
+    if (ExceptionRecord->NumberParameters == 3) {
+        fprintf(stderr, "\tAbout to traverse SEH chain\n");
+        // C++ Exception records have 3 params.
+        x86_slp_show_seh_chain();
+    }
+
+    return EXCEPTION_CONTINUE_SEARCH;
+}
+
+
+
+
+#endif
diff --git a/llm/Lib/site-packages/greenlet/platform/switch_x86_unix.h b/llm/Lib/site-packages/greenlet/platform/switch_x86_unix.h
new file mode 100644
index 0000000000000000000000000000000000000000..493fa6baa3b28c74ade1a8d9b6ed2e6a3208e596
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/platform/switch_x86_unix.h
@@ -0,0 +1,105 @@
+/*
+ * this is the internal transfer function.
+ *
+ * HISTORY
+ * 3-May-13   Ralf Schmitt  <ralf@systemexit.de>
+ *     Add support for strange GCC caller-save decisions
+ *     (ported from switch_aarch64_gcc.h)
+ * 19-Aug-11  Alexey Borzenkov  <snaury@gmail.com>
+ *      Correctly save ebp, ebx and cw
+ * 07-Sep-05 (py-dev mailing list discussion)
+ *      removed 'ebx' from the register-saved.  !!!! WARNING !!!!
+ *      It means that this file can no longer be compiled statically!
+ *      It is now only suitable as part of a dynamic library!
+ * 24-Nov-02  Christian Tismer  <tismer@tismer.com>
+ *      needed to add another magic constant to insure
+ *      that f in slp_eval_frame(PyFrameObject *f)
+ *      STACK_REFPLUS will probably be 1 in most cases.
+ *      gets included into the saved stack area.
+ * 17-Sep-02  Christian Tismer  <tismer@tismer.com>
+ *      after virtualizing stack save/restore, the
+ *      stack size shrunk a bit. Needed to introduce
+ *      an adjustment STACK_MAGIC per platform.
+ * 15-Sep-02  Gerd Woetzel       <gerd.woetzel@GMD.DE>
+ *      slightly changed framework for spark
+ * 31-Avr-02  Armin Rigo         <arigo@ulb.ac.be>
+ *      Added ebx, esi and edi register-saves.
+ * 01-Mar-02  Samual M. Rushing  <rushing@ironport.com>
+ *      Ported from i386.
+ */
+
+#define STACK_REFPLUS 1
+
+#ifdef SLP_EVAL
+
+/* #define STACK_MAGIC 3 */
+/* the above works fine with gcc 2.96, but 2.95.3 wants this */
+#define STACK_MAGIC 0
+
+#if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5)
+# define ATTR_NOCLONE __attribute__((noclone))
+#else
+# define ATTR_NOCLONE
+#endif
+
+static int
+slp_switch(void)
+{
+    int err;
+#ifdef _WIN32
+    void *seh;
+#endif
+    void *ebp, *ebx;
+    unsigned short cw;
+    int *stackref, stsizediff;
+    __asm__ volatile ("" : : : "esi", "edi");
+    __asm__ volatile ("fstcw %0" : "=m" (cw));
+    __asm__ volatile ("movl %%ebp, %0" : "=m" (ebp));
+    __asm__ volatile ("movl %%ebx, %0" : "=m" (ebx));
+#ifdef _WIN32
+    __asm__ volatile (
+        "movl %%fs:0x0, %%eax\n"
+        "movl %%eax, %0\n"
+        : "=m" (seh)
+        :
+        : "eax");
+#endif
+    __asm__ ("movl %%esp, %0" : "=g" (stackref));
+    {
+        SLP_SAVE_STATE(stackref, stsizediff);
+        __asm__ volatile (
+            "addl %0, %%esp\n"
+            "addl %0, %%ebp\n"
+            :
+            : "r" (stsizediff)
+            );
+        SLP_RESTORE_STATE();
+        __asm__ volatile ("xorl %%eax, %%eax" : "=a" (err));
+    }
+#ifdef _WIN32
+    __asm__ volatile (
+        "movl %0, %%eax\n"
+        "movl %%eax, %%fs:0x0\n"
+        :
+        : "m" (seh)
+        : "eax");
+#endif
+    __asm__ volatile ("movl %0, %%ebx" : : "m" (ebx));
+    __asm__ volatile ("movl %0, %%ebp" : : "m" (ebp));
+    __asm__ volatile ("fldcw %0" : : "m" (cw));
+    __asm__ volatile ("" : : : "esi", "edi");
+    return err;
+}
+
+#endif
+
+/*
+ * further self-processing support
+ */
+
+/* 
+ * if you want to add self-inspection tools, place them
+ * here. See the x86_msvc for the necessary defines.
+ * These features are highly experimental und not
+ * essential yet.
+ */
diff --git a/llm/Lib/site-packages/greenlet/slp_platformselect.h b/llm/Lib/site-packages/greenlet/slp_platformselect.h
new file mode 100644
index 0000000000000000000000000000000000000000..c959f0f82202ae6f8a233102203131e6990c6fcc
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/slp_platformselect.h
@@ -0,0 +1,71 @@
+/*
+ * Platform Selection for Stackless Python
+ */
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#if   defined(MS_WIN32) && !defined(MS_WIN64) && defined(_M_IX86) && defined(_MSC_VER)
+# include "platform/switch_x86_msvc.h" /* MS Visual Studio on X86 */
+#elif defined(MS_WIN64) && defined(_M_X64) && defined(_MSC_VER) || defined(__MINGW64__)
+# include "platform/switch_x64_msvc.h" /* MS Visual Studio on X64 */
+#elif  defined(MS_WIN64) && defined(_M_ARM64)
+# include "platform/switch_arm64_msvc.h" /* MS Visual Studio on ARM64 */
+#elif defined(__GNUC__) && defined(__amd64__) && defined(__ILP32__)
+# include "platform/switch_x32_unix.h" /* gcc on amd64 with x32 ABI */
+#elif defined(__GNUC__) && defined(__amd64__)
+# include "platform/switch_amd64_unix.h" /* gcc on amd64 */
+#elif defined(__GNUC__) && defined(__i386__)
+# include "platform/switch_x86_unix.h" /* gcc on X86 */
+#elif defined(__GNUC__) && defined(__powerpc64__) && (defined(__linux__) || defined(__FreeBSD__))
+# include "platform/switch_ppc64_linux.h" /* gcc on PowerPC 64-bit */
+#elif defined(__GNUC__) && defined(__PPC__) && (defined(__linux__) || defined(__FreeBSD__))
+# include "platform/switch_ppc_linux.h" /* gcc on PowerPC */
+#elif defined(__GNUC__) && defined(__ppc__) && defined(__APPLE__)
+# include "platform/switch_ppc_macosx.h" /* Apple MacOS X on PowerPC */
+#elif defined(__GNUC__) && defined(__powerpc64__) && defined(_AIX)
+# include "platform/switch_ppc64_aix.h" /* gcc on AIX/PowerPC 64-bit */
+#elif defined(__GNUC__) && defined(_ARCH_PPC) && defined(_AIX)
+# include "platform/switch_ppc_aix.h" /* gcc on AIX/PowerPC */
+#elif defined(__GNUC__) && defined(sparc)
+# include "platform/switch_sparc_sun_gcc.h" /* SunOS sparc with gcc */
+#elif defined(__SUNPRO_C) && defined(sparc) && defined(sun)
+# iiclude "platform/switch_sparc_sun_gcc.h" /* SunStudio on amd64 */
+#elif defined(__SUNPRO_C) && defined(__amd64__) && defined(sun)
+# include "platform/switch_amd64_unix.h" /* SunStudio on amd64 */
+#elif defined(__SUNPRO_C) && defined(__i386__) && defined(sun)
+# include "platform/switch_x86_unix.h" /* SunStudio on x86 */
+#elif defined(__GNUC__) && defined(__s390__) && defined(__linux__)
+# include "platform/switch_s390_unix.h" /* Linux/S390 */
+#elif defined(__GNUC__) && defined(__s390x__) && defined(__linux__)
+# include "platform/switch_s390_unix.h" /* Linux/S390 zSeries (64-bit) */
+#elif defined(__GNUC__) && defined(__arm__)
+# ifdef __APPLE__
+#  include <TargetConditionals.h>
+# endif
+# if TARGET_OS_IPHONE
+#  include "platform/switch_arm32_ios.h" /* iPhone OS on arm32 */
+# else
+#  include "platform/switch_arm32_gcc.h" /* gcc using arm32 */
+# endif
+#elif defined(__GNUC__) && defined(__mips__) && defined(__linux__)
+# include "platform/switch_mips_unix.h" /* Linux/MIPS */
+#elif defined(__GNUC__) && defined(__aarch64__)
+# include "platform/switch_aarch64_gcc.h" /* Aarch64 ABI */
+#elif defined(__GNUC__) && defined(__mc68000__)
+# include "platform/switch_m68k_gcc.h" /* gcc on m68k */
+#elif defined(__GNUC__) && defined(__csky__)
+#include "platform/switch_csky_gcc.h" /* gcc on csky */
+# elif defined(__GNUC__) && defined(__riscv)
+# include "platform/switch_riscv_unix.h" /* gcc on RISC-V */
+#elif defined(__GNUC__) && defined(__alpha__)
+# include "platform/switch_alpha_unix.h" /* gcc on DEC Alpha */
+#elif defined(MS_WIN32) && defined(__llvm__) && defined(__aarch64__)
+# include "platform/switch_aarch64_gcc.h" /* LLVM Aarch64 ABI for Windows */
+#elif defined(__GNUC__) && defined(__loongarch64) && defined(__linux__)
+# include "platform/switch_loongarch64_linux.h" /* LoongArch64 */
+#endif
+
+#ifdef __cplusplus
+};
+#endif
diff --git a/llm/Lib/site-packages/greenlet/tests/__init__.py b/llm/Lib/site-packages/greenlet/tests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e249e3512d9d756d357415d54b6193bf14d4cd3d
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/__init__.py
@@ -0,0 +1,237 @@
+# -*- coding: utf-8 -*-
+"""
+Tests for greenlet.
+
+"""
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import print_function
+
+import sys
+import unittest
+
+from gc import collect
+from gc import get_objects
+from threading import active_count as active_thread_count
+from time import sleep
+from time import time
+
+import psutil
+
+from greenlet import greenlet as RawGreenlet
+from greenlet import getcurrent
+
+from greenlet._greenlet import get_pending_cleanup_count
+from greenlet._greenlet import get_total_main_greenlets
+
+from . import leakcheck
+
+PY312 = sys.version_info[:2] >= (3, 12)
+WIN = sys.platform.startswith("win")
+
+class TestCaseMetaClass(type):
+    # wrap each test method with
+    # a) leak checks
+    def __new__(cls, classname, bases, classDict):
+        # pylint and pep8 fight over what this should be called (mcs or cls).
+        # pylint gets it right, but we can't scope disable pep8, so we go with
+        # its convention.
+        # pylint: disable=bad-mcs-classmethod-argument
+        check_totalrefcount = True
+
+        # Python 3: must copy, we mutate the classDict. Interestingly enough,
+        # it doesn't actually error out, but under 3.6 we wind up wrapping
+        # and re-wrapping the same items over and over and over.
+        for key, value in list(classDict.items()):
+            if key.startswith('test') and callable(value):
+                classDict.pop(key)
+                if check_totalrefcount:
+                    value = leakcheck.wrap_refcount(value)
+                classDict[key] = value
+        return type.__new__(cls, classname, bases, classDict)
+
+
+class TestCase(TestCaseMetaClass(
+        "NewBase",
+        (unittest.TestCase,),
+        {})):
+
+    cleanup_attempt_sleep_duration = 0.001
+    cleanup_max_sleep_seconds = 1
+
+    def wait_for_pending_cleanups(self,
+                                  initial_active_threads=None,
+                                  initial_main_greenlets=None):
+        initial_active_threads = initial_active_threads or self.threads_before_test
+        initial_main_greenlets = initial_main_greenlets or self.main_greenlets_before_test
+        sleep_time = self.cleanup_attempt_sleep_duration
+        # NOTE: This is racy! A Python-level thread object may be dead
+        # and gone, but the C thread may not yet have fired its
+        # destructors and added to the queue. There's no particular
+        # way to know that's about to happen. We try to watch the
+        # Python threads to make sure they, at least, have gone away.
+        # Counting the main greenlets, which we can easily do deterministically,
+        # also helps.
+
+        # Always sleep at least once to let other threads run
+        sleep(sleep_time)
+        quit_after = time() + self.cleanup_max_sleep_seconds
+        # TODO: We could add an API that calls us back when a particular main greenlet is deleted?
+        # It would have to drop the GIL
+        while (
+                get_pending_cleanup_count()
+                or active_thread_count() > initial_active_threads
+                or (not self.expect_greenlet_leak
+                    and get_total_main_greenlets() > initial_main_greenlets)):
+            sleep(sleep_time)
+            if time() > quit_after:
+                print("Time limit exceeded.")
+                print("Threads: Waiting for only", initial_active_threads,
+                      "-->", active_thread_count())
+                print("MGlets : Waiting for only", initial_main_greenlets,
+                      "-->", get_total_main_greenlets())
+                break
+        collect()
+
+    def count_objects(self, kind=list, exact_kind=True):
+        # pylint:disable=unidiomatic-typecheck
+        # Collect the garbage.
+        for _ in range(3):
+            collect()
+        if exact_kind:
+            return sum(
+                1
+                for x in get_objects()
+                if type(x) is kind
+            )
+        # instances
+        return sum(
+            1
+            for x in get_objects()
+            if isinstance(x, kind)
+        )
+
+    greenlets_before_test = 0
+    threads_before_test = 0
+    main_greenlets_before_test = 0
+    expect_greenlet_leak = False
+
+    def count_greenlets(self):
+        """
+        Find all the greenlets and subclasses tracked by the GC.
+        """
+        return self.count_objects(RawGreenlet, False)
+
+    def setUp(self):
+        # Ensure the main greenlet exists, otherwise the first test
+        # gets a false positive leak
+        super().setUp()
+        getcurrent()
+        self.threads_before_test = active_thread_count()
+        self.main_greenlets_before_test = get_total_main_greenlets()
+        self.wait_for_pending_cleanups(self.threads_before_test, self.main_greenlets_before_test)
+        self.greenlets_before_test = self.count_greenlets()
+
+    def tearDown(self):
+        if getattr(self, 'skipTearDown', False):
+            return
+
+        self.wait_for_pending_cleanups(self.threads_before_test, self.main_greenlets_before_test)
+        super().tearDown()
+
+    def get_expected_returncodes_for_aborted_process(self):
+        import signal
+        # The child should be aborted in an unusual way. On POSIX
+        # platforms, this is done with abort() and signal.SIGABRT,
+        # which is reflected in a negative return value; however, on
+        # Windows, even though we observe the child print "Fatal
+        # Python error: Aborted" and in older versions of the C
+        # runtime "This application has requested the Runtime to
+        # terminate it in an unusual way," it always has an exit code
+        # of 3. This is interesting because 3 is the error code for
+        # ERROR_PATH_NOT_FOUND; BUT: the C runtime abort() function
+        # also uses this code.
+        #
+        # If we link to the static C library on Windows, the error
+        # code changes to '0xc0000409' (hex(3221226505)), which
+        # apparently is STATUS_STACK_BUFFER_OVERRUN; but "What this
+        # means is that nowadays when you get a
+        # STATUS_STACK_BUFFER_OVERRUN, it doesn’t actually mean that
+        # there is a stack buffer overrun. It just means that the
+        # application decided to terminate itself with great haste."
+        #
+        #
+        # On windows, we've also seen '0xc0000005' (hex(3221225477)).
+        # That's "Access Violation"
+        #
+        # See
+        # https://devblogs.microsoft.com/oldnewthing/20110519-00/?p=10623
+        # and
+        # https://docs.microsoft.com/en-us/previous-versions/k089yyh0(v=vs.140)?redirectedfrom=MSDN
+        # and
+        # https://devblogs.microsoft.com/oldnewthing/20190108-00/?p=100655
+        expected_exit = (
+            -signal.SIGABRT,
+            # But beginning on Python 3.11, the faulthandler
+            # that prints the C backtraces sometimes segfaults after
+            # reporting the exception but before printing the stack.
+            # This has only been seen on linux/gcc.
+            -signal.SIGSEGV,
+        ) if not WIN else (
+            3,
+            0xc0000409,
+            0xc0000005,
+        )
+        return expected_exit
+
+    def get_process_uss(self):
+        """
+        Return the current process's USS in bytes.
+
+        uss is available on Linux, macOS, Windows. Also known as
+        "Unique Set Size", this is the memory which is unique to a
+        process and which would be freed if the process was terminated
+        right now.
+
+        If this is not supported by ``psutil``, this raises the
+        :exc:`unittest.SkipTest` exception.
+        """
+        try:
+            return psutil.Process().memory_full_info().uss
+        except AttributeError as e:
+            raise unittest.SkipTest("uss not supported") from e
+
+    def run_script(self, script_name, show_output=True):
+        import subprocess
+        import os
+        script = os.path.join(
+            os.path.dirname(__file__),
+            script_name,
+        )
+
+        try:
+            return subprocess.check_output([sys.executable, script],
+                                           encoding='utf-8',
+                                           stderr=subprocess.STDOUT)
+        except subprocess.CalledProcessError as ex:
+            if show_output:
+                print('-----')
+                print('Failed to run script', script)
+                print('~~~~~')
+                print(ex.output)
+                print('------')
+            raise
+
+
+    def assertScriptRaises(self, script_name, exitcodes=None):
+        import subprocess
+        with self.assertRaises(subprocess.CalledProcessError) as exc:
+            output = self.run_script(script_name, show_output=False)
+            __traceback_info__ = output
+            # We're going to fail the assertion if we get here, at least
+            # preserve the output in the traceback.
+
+        if exitcodes is None:
+            exitcodes = self.get_expected_returncodes_for_aborted_process()
+        self.assertIn(exc.exception.returncode, exitcodes)
+        return exc.exception
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5dec9c9bdf736ec23ae0c4854e265f104560a309
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_clearing_run_switches.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_clearing_run_switches.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..65db45d6aef23fb4cfdfbc6466704f151533cae6
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_clearing_run_switches.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_cpp_exception.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_cpp_exception.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f3c9d623018ce3c79e8d792585645963ea2dd49b
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_cpp_exception.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_initialstub_already_started.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_initialstub_already_started.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4873f7e153591814d565306b0796b0e99cf8eb5d
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_initialstub_already_started.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_slp_switch.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_slp_switch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bc79090401927efbbafc71c3f829a7d72057f8d0
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_slp_switch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_three_greenlets.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_three_greenlets.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7b2cb8e6e740cb41ae85f9cb52f54eaae5234893
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_three_greenlets.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_three_greenlets2.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_three_greenlets2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cc1cfdbabd66c99e141e6123baeab6ec77cb01f9
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_three_greenlets2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_two_greenlets.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_two_greenlets.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f692b7b32cd0d7585f1a1e52a92c1bc50a947016
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_two_greenlets.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/leakcheck.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/leakcheck.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..590fc5abffb4c437dbaed3397d591615d9abc714
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/leakcheck.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_contextvars.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_contextvars.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..133f3478be6f8d4edd527ab4f416e6ee549f8d24
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_contextvars.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_cpp.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_cpp.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3c62bd50b596e188489fba03f704e5763eedee71
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_cpp.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_extension_interface.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_extension_interface.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ad846e596168b91c1098673592b2f6c1157cfee4
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_extension_interface.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_gc.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_gc.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ea23441b16339d93710cb69adbd9e7fe9f0dff27
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_gc.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_generator.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_generator.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ba56bafe11619d981c2113797d49dad2e25f779d
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_generator.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_generator_nested.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_generator_nested.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a0933b44217edc1b1c9d1972d2a864ab163eed87
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_generator_nested.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_greenlet.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_greenlet.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4f2929de75ca5ba2a2575b12dfd77397a4554c5c
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_greenlet.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_greenlet_trash.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_greenlet_trash.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3cb6ddf6058c249dd7af95ded5c281e97fabd35f
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_greenlet_trash.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_leaks.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_leaks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6a86bad6493e60fc967bafc45938c6d2d8f0b6f5
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_leaks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_stack_saved.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_stack_saved.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e537f372fd0bb4866f95266c2fad7a8d9d1c0ff9
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_stack_saved.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_throw.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_throw.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e65661caacf81315d108fa0de9a6be4240bb7dbc
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_throw.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_tracing.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_tracing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d305069f589a23718819a86c19c7048ca27e2a5e
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_tracing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_version.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_version.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6777731795b363053c82e8c8e519c3547023f3a3
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_version.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/__pycache__/test_weakref.cpython-311.pyc b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_weakref.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c85883818d0d9de5131282ae4b4e8e047e970a59
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/__pycache__/test_weakref.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/greenlet/tests/_test_extension.c b/llm/Lib/site-packages/greenlet/tests/_test_extension.c
new file mode 100644
index 0000000000000000000000000000000000000000..05e81c03ad92a8dc2e3a577e00432eecb79b0d69
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/_test_extension.c
@@ -0,0 +1,231 @@
+/* This is a set of functions used by test_extension_interface.py to test the
+ * Greenlet C API.
+ */
+
+#include "../greenlet.h"
+
+#ifndef Py_RETURN_NONE
+#    define Py_RETURN_NONE return Py_INCREF(Py_None), Py_None
+#endif
+
+#define TEST_MODULE_NAME "_test_extension"
+
+static PyObject*
+test_switch(PyObject* self, PyObject* greenlet)
+{
+    PyObject* result = NULL;
+
+    if (greenlet == NULL || !PyGreenlet_Check(greenlet)) {
+        PyErr_BadArgument();
+        return NULL;
+    }
+
+    result = PyGreenlet_Switch((PyGreenlet*)greenlet, NULL, NULL);
+    if (result == NULL) {
+        if (!PyErr_Occurred()) {
+            PyErr_SetString(PyExc_AssertionError,
+                            "greenlet.switch() failed for some reason.");
+        }
+        return NULL;
+    }
+    Py_INCREF(result);
+    return result;
+}
+
+static PyObject*
+test_switch_kwargs(PyObject* self, PyObject* args, PyObject* kwargs)
+{
+    PyGreenlet* g = NULL;
+    PyObject* result = NULL;
+
+    PyArg_ParseTuple(args, "O!", &PyGreenlet_Type, &g);
+
+    if (g == NULL || !PyGreenlet_Check(g)) {
+        PyErr_BadArgument();
+        return NULL;
+    }
+
+    result = PyGreenlet_Switch(g, NULL, kwargs);
+    if (result == NULL) {
+        if (!PyErr_Occurred()) {
+            PyErr_SetString(PyExc_AssertionError,
+                            "greenlet.switch() failed for some reason.");
+        }
+        return NULL;
+    }
+    Py_XINCREF(result);
+    return result;
+}
+
+static PyObject*
+test_getcurrent(PyObject* self)
+{
+    PyGreenlet* g = PyGreenlet_GetCurrent();
+    if (g == NULL || !PyGreenlet_Check(g) || !PyGreenlet_ACTIVE(g)) {
+        PyErr_SetString(PyExc_AssertionError,
+                        "getcurrent() returned an invalid greenlet");
+        Py_XDECREF(g);
+        return NULL;
+    }
+    Py_DECREF(g);
+    Py_RETURN_NONE;
+}
+
+static PyObject*
+test_setparent(PyObject* self, PyObject* arg)
+{
+    PyGreenlet* current;
+    PyGreenlet* greenlet = NULL;
+
+    if (arg == NULL || !PyGreenlet_Check(arg)) {
+        PyErr_BadArgument();
+        return NULL;
+    }
+    if ((current = PyGreenlet_GetCurrent()) == NULL) {
+        return NULL;
+    }
+    greenlet = (PyGreenlet*)arg;
+    if (PyGreenlet_SetParent(greenlet, current)) {
+        Py_DECREF(current);
+        return NULL;
+    }
+    Py_DECREF(current);
+    if (PyGreenlet_Switch(greenlet, NULL, NULL) == NULL) {
+        return NULL;
+    }
+    Py_RETURN_NONE;
+}
+
+static PyObject*
+test_new_greenlet(PyObject* self, PyObject* callable)
+{
+    PyObject* result = NULL;
+    PyGreenlet* greenlet = PyGreenlet_New(callable, NULL);
+
+    if (!greenlet) {
+        return NULL;
+    }
+
+    result = PyGreenlet_Switch(greenlet, NULL, NULL);
+    Py_CLEAR(greenlet);
+    if (result == NULL) {
+        return NULL;
+    }
+
+    Py_INCREF(result);
+    return result;
+}
+
+static PyObject*
+test_raise_dead_greenlet(PyObject* self)
+{
+    PyErr_SetString(PyExc_GreenletExit, "test GreenletExit exception.");
+    return NULL;
+}
+
+static PyObject*
+test_raise_greenlet_error(PyObject* self)
+{
+    PyErr_SetString(PyExc_GreenletError, "test greenlet.error exception");
+    return NULL;
+}
+
+static PyObject*
+test_throw(PyObject* self, PyGreenlet* g)
+{
+    const char msg[] = "take that sucka!";
+    PyObject* msg_obj = Py_BuildValue("s", msg);
+    PyGreenlet_Throw(g, PyExc_ValueError, msg_obj, NULL);
+    Py_DECREF(msg_obj);
+    if (PyErr_Occurred()) {
+        return NULL;
+    }
+    Py_RETURN_NONE;
+}
+
+static PyObject*
+test_throw_exact(PyObject* self, PyObject* args)
+{
+    PyGreenlet* g = NULL;
+    PyObject* typ = NULL;
+    PyObject* val = NULL;
+    PyObject* tb = NULL;
+
+    if (!PyArg_ParseTuple(args, "OOOO:throw", &g, &typ, &val, &tb)) {
+        return NULL;
+    }
+
+    PyGreenlet_Throw(g, typ, val, tb);
+    if (PyErr_Occurred()) {
+        return NULL;
+    }
+    Py_RETURN_NONE;
+}
+
+static PyMethodDef test_methods[] = {
+    {"test_switch",
+     (PyCFunction)test_switch,
+     METH_O,
+     "Switch to the provided greenlet sending provided arguments, and \n"
+     "return the results."},
+    {"test_switch_kwargs",
+     (PyCFunction)test_switch_kwargs,
+     METH_VARARGS | METH_KEYWORDS,
+     "Switch to the provided greenlet sending the provided keyword args."},
+    {"test_getcurrent",
+     (PyCFunction)test_getcurrent,
+     METH_NOARGS,
+     "Test PyGreenlet_GetCurrent()"},
+    {"test_setparent",
+     (PyCFunction)test_setparent,
+     METH_O,
+     "Se the parent of the provided greenlet and switch to it."},
+    {"test_new_greenlet",
+     (PyCFunction)test_new_greenlet,
+     METH_O,
+     "Test PyGreenlet_New()"},
+    {"test_raise_dead_greenlet",
+     (PyCFunction)test_raise_dead_greenlet,
+     METH_NOARGS,
+     "Just raise greenlet.GreenletExit"},
+    {"test_raise_greenlet_error",
+     (PyCFunction)test_raise_greenlet_error,
+     METH_NOARGS,
+     "Just raise greenlet.error"},
+    {"test_throw",
+     (PyCFunction)test_throw,
+     METH_O,
+     "Throw a ValueError at the provided greenlet"},
+    {"test_throw_exact",
+     (PyCFunction)test_throw_exact,
+     METH_VARARGS,
+     "Throw exactly the arguments given at the provided greenlet"},
+    {NULL, NULL, 0, NULL}
+};
+
+
+#define INITERROR return NULL
+
+static struct PyModuleDef moduledef = {PyModuleDef_HEAD_INIT,
+                                       TEST_MODULE_NAME,
+                                       NULL,
+                                       0,
+                                       test_methods,
+                                       NULL,
+                                       NULL,
+                                       NULL,
+                                       NULL};
+
+PyMODINIT_FUNC
+PyInit__test_extension(void)
+{
+    PyObject* module = NULL;
+    module = PyModule_Create(&moduledef);
+
+    if (module == NULL) {
+        return NULL;
+    }
+
+    PyGreenlet_Import();
+    return module;
+}
diff --git a/llm/Lib/site-packages/greenlet/tests/_test_extension.cp311-win_amd64.pyd b/llm/Lib/site-packages/greenlet/tests/_test_extension.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..40a851f63d7021c6960aaade0fc30b6d7a8db63e
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/_test_extension.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/greenlet/tests/_test_extension_cpp.cp311-win_amd64.pyd b/llm/Lib/site-packages/greenlet/tests/_test_extension_cpp.cp311-win_amd64.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..ef9ae5074985360bb8b190f624733b0a0ea8e9be
Binary files /dev/null and b/llm/Lib/site-packages/greenlet/tests/_test_extension_cpp.cp311-win_amd64.pyd differ
diff --git a/llm/Lib/site-packages/greenlet/tests/_test_extension_cpp.cpp b/llm/Lib/site-packages/greenlet/tests/_test_extension_cpp.cpp
new file mode 100644
index 0000000000000000000000000000000000000000..5cbe6a7697cb622e93eb796c089bfd24b332df5a
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/_test_extension_cpp.cpp
@@ -0,0 +1,226 @@
+/* This is a set of functions used to test C++ exceptions are not
+ * broken during greenlet switches
+ */
+
+#include "../greenlet.h"
+#include "../greenlet_compiler_compat.hpp"
+#include <exception>
+#include <stdexcept>
+
+struct exception_t {
+    int depth;
+    exception_t(int depth) : depth(depth) {}
+};
+
+/* Functions are called via pointers to prevent inlining */
+static void (*p_test_exception_throw_nonstd)(int depth);
+static void (*p_test_exception_throw_std)();
+static PyObject* (*p_test_exception_switch_recurse)(int depth, int left);
+
+static void
+test_exception_throw_nonstd(int depth)
+{
+    throw exception_t(depth);
+}
+
+static void
+test_exception_throw_std()
+{
+    throw std::runtime_error("Thrown from an extension.");
+}
+
+static PyObject*
+test_exception_switch_recurse(int depth, int left)
+{
+    if (left > 0) {
+        return p_test_exception_switch_recurse(depth, left - 1);
+    }
+
+    PyObject* result = NULL;
+    PyGreenlet* self = PyGreenlet_GetCurrent();
+    if (self == NULL)
+        return NULL;
+
+    try {
+        if (PyGreenlet_Switch(PyGreenlet_GET_PARENT(self), NULL, NULL) == NULL) {
+            Py_DECREF(self);
+            return NULL;
+        }
+        p_test_exception_throw_nonstd(depth);
+        PyErr_SetString(PyExc_RuntimeError,
+                        "throwing C++ exception didn't work");
+    }
+    catch (const exception_t& e) {
+        if (e.depth != depth)
+            PyErr_SetString(PyExc_AssertionError, "depth mismatch");
+        else
+            result = PyLong_FromLong(depth);
+    }
+    catch (...) {
+        PyErr_SetString(PyExc_RuntimeError, "unexpected C++ exception");
+    }
+
+    Py_DECREF(self);
+    return result;
+}
+
+/* test_exception_switch(int depth)
+ * - recurses depth times
+ * - switches to parent inside try/catch block
+ * - throws an exception that (expected to be caught in the same function)
+ * - verifies depth matches (exceptions shouldn't be caught in other greenlets)
+ */
+static PyObject*
+test_exception_switch(PyObject* UNUSED(self), PyObject* args)
+{
+    int depth;
+    if (!PyArg_ParseTuple(args, "i", &depth))
+        return NULL;
+    return p_test_exception_switch_recurse(depth, depth);
+}
+
+
+static PyObject*
+py_test_exception_throw_nonstd(PyObject* self, PyObject* args)
+{
+    if (!PyArg_ParseTuple(args, ""))
+        return NULL;
+    p_test_exception_throw_nonstd(0);
+    PyErr_SetString(PyExc_AssertionError, "unreachable code running after throw");
+    return NULL;
+}
+
+static PyObject*
+py_test_exception_throw_std(PyObject* self, PyObject* args)
+{
+    if (!PyArg_ParseTuple(args, ""))
+        return NULL;
+    p_test_exception_throw_std();
+    PyErr_SetString(PyExc_AssertionError, "unreachable code running after throw");
+    return NULL;
+}
+
+static PyObject*
+py_test_call(PyObject* self, PyObject* arg)
+{
+    PyObject* noargs = PyTuple_New(0);
+    PyObject* ret = PyObject_Call(arg, noargs, nullptr);
+    Py_DECREF(noargs);
+    return ret;
+}
+
+
+
+/* test_exception_switch_and_do_in_g2(g2func)
+ * - creates new greenlet g2 to run g2func
+ * - switches to g2 inside try/catch block
+ * - verifies that no exception has been caught
+ *
+ * it is used together with test_exception_throw to verify that unhandled
+ * exceptions thrown in one greenlet do not propagate to other greenlet nor
+ * segfault the process.
+ */
+static PyObject*
+test_exception_switch_and_do_in_g2(PyObject* self, PyObject* args)
+{
+    PyObject* g2func = NULL;
+    PyObject* result = NULL;
+
+    if (!PyArg_ParseTuple(args, "O", &g2func))
+        return NULL;
+    PyGreenlet* g2 = PyGreenlet_New(g2func, NULL);
+    if (!g2) {
+        return NULL;
+    }
+
+    try {
+        result = PyGreenlet_Switch(g2, NULL, NULL);
+        if (!result) {
+            return NULL;
+        }
+    }
+    catch (const exception_t& e) {
+        /* if we are here the memory can be already corrupted and the program
+         * might crash before below py-level exception might become printed.
+         * -> print something to stderr to make it clear that we had entered
+         *    this catch block.
+         * See comments in inner_bootstrap()
+         */
+#if defined(WIN32) || defined(_WIN32)
+        fprintf(stderr, "C++ exception unexpectedly caught in g1\n");
+        PyErr_SetString(PyExc_AssertionError, "C++ exception unexpectedly caught in g1");
+        Py_XDECREF(result);
+        return NULL;
+#else
+        throw;
+#endif
+    }
+
+    Py_XDECREF(result);
+    Py_RETURN_NONE;
+}
+
+static PyMethodDef test_methods[] = {
+    {"test_exception_switch",
+     (PyCFunction)&test_exception_switch,
+     METH_VARARGS,
+     "Switches to parent twice, to test exception handling and greenlet "
+     "switching."},
+    {"test_exception_switch_and_do_in_g2",
+     (PyCFunction)&test_exception_switch_and_do_in_g2,
+     METH_VARARGS,
+     "Creates new greenlet g2 to run g2func and switches to it inside try/catch "
+     "block. Used together with test_exception_throw to verify that unhandled "
+     "C++ exceptions thrown in a greenlet doe not corrupt memory."},
+    {"test_exception_throw_nonstd",
+     (PyCFunction)&py_test_exception_throw_nonstd,
+     METH_VARARGS,
+     "Throws non-standard C++ exception. Calling this function directly should abort the process."
+    },
+    {"test_exception_throw_std",
+     (PyCFunction)&py_test_exception_throw_std,
+     METH_VARARGS,
+     "Throws standard C++ exception. Calling this function directly should abort the process."
+    },
+    {"test_call",
+     (PyCFunction)&py_test_call,
+     METH_O,
+     "Call the given callable. Unlike calling it directly, this creates a "
+     "new C-level stack frame, which may be helpful in testing."
+    },
+    {NULL, NULL, 0, NULL}
+};
+
+
+static struct PyModuleDef moduledef = {PyModuleDef_HEAD_INIT,
+                                       "greenlet.tests._test_extension_cpp",
+                                       NULL,
+                                       0,
+                                       test_methods,
+                                       NULL,
+                                       NULL,
+                                       NULL,
+                                       NULL};
+
+PyMODINIT_FUNC
+PyInit__test_extension_cpp(void)
+{
+    PyObject* module = NULL;
+
+    module = PyModule_Create(&moduledef);
+
+    if (module == NULL) {
+        return NULL;
+    }
+
+    PyGreenlet_Import();
+    if (_PyGreenlet_API == NULL) {
+        return NULL;
+    }
+
+    p_test_exception_throw_nonstd = test_exception_throw_nonstd;
+    p_test_exception_throw_std = test_exception_throw_std;
+    p_test_exception_switch_recurse = test_exception_switch_recurse;
+
+    return module;
+}
diff --git a/llm/Lib/site-packages/greenlet/tests/fail_clearing_run_switches.py b/llm/Lib/site-packages/greenlet/tests/fail_clearing_run_switches.py
new file mode 100644
index 0000000000000000000000000000000000000000..6dd1492ff9e3b48938562f48b5ded0aea61e0481
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/fail_clearing_run_switches.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+"""
+If we have a run callable passed to the constructor or set as an
+attribute, but we don't actually use that (because ``__getattribute__``
+or the like interferes), then when we clear callable before beginning
+to run, there's an opportunity for Python code to run.
+
+"""
+import greenlet
+
+g = None
+main = greenlet.getcurrent()
+
+results = []
+
+class RunCallable:
+
+    def __del__(self):
+        results.append(('RunCallable', '__del__'))
+        main.switch('from RunCallable')
+
+
+class G(greenlet.greenlet):
+
+    def __getattribute__(self, name):
+        if name == 'run':
+            results.append(('G.__getattribute__', 'run'))
+            return run_func
+        return object.__getattribute__(self, name)
+
+
+def run_func():
+    results.append(('run_func', 'enter'))
+
+
+g = G(RunCallable())
+# Try to start G. It will get to the point where it deletes
+# its run callable C++ variable in inner_bootstrap. That triggers
+# the __del__ method, which switches back to main before g
+# actually even starts running.
+x = g.switch()
+results.append(('main: g.switch()', x))
+# In the C++ code, this results in g->g_switch() appearing to return, even though
+# it has yet to run.
+print('In main with', x, flush=True)
+g.switch()
+print('RESULTS', results)
diff --git a/llm/Lib/site-packages/greenlet/tests/fail_cpp_exception.py b/llm/Lib/site-packages/greenlet/tests/fail_cpp_exception.py
new file mode 100644
index 0000000000000000000000000000000000000000..fa4dc2eb3e8597eedfe943cb02c0c5ee628e3c49
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/fail_cpp_exception.py
@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+"""
+Helper for testing a C++ exception throw aborts the process.
+
+Takes one argument, the name of the function in :mod:`_test_extension_cpp` to call.
+"""
+import sys
+import greenlet
+from greenlet.tests import _test_extension_cpp
+print('fail_cpp_exception is running')
+
+def run_unhandled_exception_in_greenlet_aborts():
+    def _():
+        _test_extension_cpp.test_exception_switch_and_do_in_g2(
+            _test_extension_cpp.test_exception_throw_nonstd
+        )
+    g1 = greenlet.greenlet(_)
+    g1.switch()
+
+
+func_name = sys.argv[1]
+try:
+    func = getattr(_test_extension_cpp, func_name)
+except AttributeError:
+    if func_name == run_unhandled_exception_in_greenlet_aborts.__name__:
+        func = run_unhandled_exception_in_greenlet_aborts
+    elif func_name == 'run_as_greenlet_target':
+        g = greenlet.greenlet(_test_extension_cpp.test_exception_throw_std)
+        func = g.switch
+    else:
+        raise
+print('raising', func, flush=True)
+func()
diff --git a/llm/Lib/site-packages/greenlet/tests/fail_initialstub_already_started.py b/llm/Lib/site-packages/greenlet/tests/fail_initialstub_already_started.py
new file mode 100644
index 0000000000000000000000000000000000000000..c1a44efd2915e84007ceedc8cd04a68ad853d1aa
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/fail_initialstub_already_started.py
@@ -0,0 +1,78 @@
+"""
+Testing initialstub throwing an already started exception.
+"""
+
+import greenlet
+
+a = None
+b = None
+c = None
+main = greenlet.getcurrent()
+
+# If we switch into a dead greenlet,
+# we go looking for its parents.
+# if a parent is not yet started, we start it.
+
+results = []
+
+def a_run(*args):
+    #results.append('A')
+    results.append(('Begin A', args))
+
+
+def c_run():
+    results.append('Begin C')
+    b.switch('From C')
+    results.append('C done')
+
+class A(greenlet.greenlet): pass
+
+class B(greenlet.greenlet):
+    doing_it = False
+    def __getattribute__(self, name):
+        if name == 'run' and not self.doing_it:
+            assert greenlet.getcurrent() is c
+            self.doing_it = True
+            results.append('Switch to b from B.__getattribute__ in '
+                           + type(greenlet.getcurrent()).__name__)
+            b.switch()
+            results.append('B.__getattribute__ back from main in '
+                           + type(greenlet.getcurrent()).__name__)
+        if name == 'run':
+            name = '_B_run'
+        return object.__getattribute__(self, name)
+
+    def _B_run(self, *arg):
+        results.append(('Begin B', arg))
+        results.append('_B_run switching to main')
+        main.switch('From B')
+
+class C(greenlet.greenlet):
+    pass
+a = A(a_run)
+b = B(parent=a)
+c = C(c_run, b)
+
+# Start a child; while running, it will start B,
+# but starting B will ALSO start B.
+result = c.switch()
+results.append(('main from c', result))
+
+# Switch back to C, which was in the middle of switching
+# already. This will throw the ``GreenletStartedWhileInPython``
+# exception, which results in parent A getting started (B is finished)
+c.switch()
+
+results.append(('A dead?', a.dead, 'B dead?', b.dead, 'C dead?', c.dead))
+
+# A and B should both be dead now.
+assert a.dead
+assert b.dead
+assert not c.dead
+
+result = c.switch()
+results.append(('main from c.2', result))
+# Now C is dead
+assert c.dead
+
+print("RESULTS:", results)
diff --git a/llm/Lib/site-packages/greenlet/tests/fail_slp_switch.py b/llm/Lib/site-packages/greenlet/tests/fail_slp_switch.py
new file mode 100644
index 0000000000000000000000000000000000000000..09905269fd24fe1c15dfb24505bbd549141469ff
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/fail_slp_switch.py
@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+"""
+A test helper for seeing what happens when slp_switch()
+fails.
+"""
+# pragma: no cover
+
+import greenlet
+
+
+print('fail_slp_switch is running', flush=True)
+
+runs = []
+def func():
+    runs.append(1)
+    greenlet.getcurrent().parent.switch()
+    runs.append(2)
+    greenlet.getcurrent().parent.switch()
+    runs.append(3)
+
+g = greenlet._greenlet.UnswitchableGreenlet(func)
+g.switch()
+assert runs == [1]
+g.switch()
+assert runs == [1, 2]
+g.force_slp_switch_error = True
+
+# This should crash.
+g.switch()
diff --git a/llm/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets.py b/llm/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets.py
new file mode 100644
index 0000000000000000000000000000000000000000..e151b19a65d059fe8d392cd415811f3c6deb9903
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets.py
@@ -0,0 +1,44 @@
+"""
+Uses a trace function to switch greenlets at unexpected times.
+
+In the trace function, we switch from the current greenlet to another
+greenlet, which switches
+"""
+import greenlet
+
+g1 = None
+g2 = None
+
+switch_to_g2 = False
+
+def tracefunc(*args):
+    print('TRACE', *args)
+    global switch_to_g2
+    if switch_to_g2:
+        switch_to_g2 = False
+        g2.switch()
+    print('\tLEAVE TRACE', *args)
+
+def g1_run():
+    print('In g1_run')
+    global switch_to_g2
+    switch_to_g2 = True
+    from_parent = greenlet.getcurrent().parent.switch()
+    print('Return to g1_run')
+    print('From parent', from_parent)
+
+def g2_run():
+    #g1.switch()
+    greenlet.getcurrent().parent.switch()
+
+greenlet.settrace(tracefunc)
+
+g1 = greenlet.greenlet(g1_run)
+g2 = greenlet.greenlet(g2_run)
+
+# This switch didn't actually finish!
+# And if it did, it would raise TypeError
+# because g1_run() doesn't take any arguments.
+g1.switch(1)
+print('Back in main')
+g1.switch(2)
diff --git a/llm/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets2.py b/llm/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets2.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f6b66bc67109c273616b94b0526129997ff0bd3
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets2.py
@@ -0,0 +1,55 @@
+"""
+Like fail_switch_three_greenlets, but the call into g1_run would actually be
+valid.
+"""
+import greenlet
+
+g1 = None
+g2 = None
+
+switch_to_g2 = True
+
+results = []
+
+def tracefunc(*args):
+    results.append(('trace', args[0]))
+    print('TRACE', *args)
+    global switch_to_g2
+    if switch_to_g2:
+        switch_to_g2 = False
+        g2.switch('g2 from tracefunc')
+    print('\tLEAVE TRACE', *args)
+
+def g1_run(arg):
+    results.append(('g1 arg', arg))
+    print('In g1_run')
+    from_parent = greenlet.getcurrent().parent.switch('from g1_run')
+    results.append(('g1 from parent', from_parent))
+    return 'g1 done'
+
+def g2_run(arg):
+    #g1.switch()
+    results.append(('g2 arg', arg))
+    parent = greenlet.getcurrent().parent.switch('from g2_run')
+    global switch_to_g2
+    switch_to_g2 = False
+    results.append(('g2 from parent', parent))
+    return 'g2 done'
+
+
+greenlet.settrace(tracefunc)
+
+g1 = greenlet.greenlet(g1_run)
+g2 = greenlet.greenlet(g2_run)
+
+x = g1.switch('g1 from main')
+results.append(('main g1', x))
+print('Back in main', x)
+x = g1.switch('g2 from main')
+results.append(('main g2', x))
+print('back in amain again', x)
+x = g1.switch('g1 from main 2')
+results.append(('main g1.2', x))
+x = g2.switch()
+results.append(('main g2.2', x))
+print("RESULTS:", results)
diff --git a/llm/Lib/site-packages/greenlet/tests/fail_switch_two_greenlets.py b/llm/Lib/site-packages/greenlet/tests/fail_switch_two_greenlets.py
new file mode 100644
index 0000000000000000000000000000000000000000..3e52345a609547bc291db58a15efb13e2ed63ac8
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/fail_switch_two_greenlets.py
@@ -0,0 +1,41 @@
+"""
+Uses a trace function to switch greenlets at unexpected times.
+
+In the trace function, we switch from the current greenlet to another
+greenlet, which switches
+"""
+import greenlet
+
+g1 = None
+g2 = None
+
+switch_to_g2 = False
+
+def tracefunc(*args):
+    print('TRACE', *args)
+    global switch_to_g2
+    if switch_to_g2:
+        switch_to_g2 = False
+        g2.switch()
+    print('\tLEAVE TRACE', *args)
+
+def g1_run():
+    print('In g1_run')
+    global switch_to_g2
+    switch_to_g2 = True
+    greenlet.getcurrent().parent.switch()
+    print('Return to g1_run')
+    print('Falling off end of g1_run')
+
+def g2_run():
+    g1.switch()
+    print('Falling off end of g2')
+
+greenlet.settrace(tracefunc)
+
+g1 = greenlet.greenlet(g1_run)
+g2 = greenlet.greenlet(g2_run)
+
+g1.switch()
+print('Falling off end of main')
+g2.switch()
diff --git a/llm/Lib/site-packages/greenlet/tests/leakcheck.py b/llm/Lib/site-packages/greenlet/tests/leakcheck.py
new file mode 100644
index 0000000000000000000000000000000000000000..a5152fb263fdb8ccb251350820b78d8651f45301
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/leakcheck.py
@@ -0,0 +1,319 @@
+# Copyright (c) 2018 gevent community
+# Copyright (c) 2021 greenlet community
+#
+# This was originally part of gevent's test suite. The main author
+# (Jason Madden) vendored a copy of it into greenlet.
+#
+# 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
+# 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.
+from __future__ import print_function
+
+import os
+import sys
+import gc
+
+from functools import wraps
+import unittest
+
+
+import objgraph
+
+# graphviz 0.18 (Nov 7 2021), available only on Python 3.6 and newer,
+# has added type hints (sigh). It wants to use ``typing.Literal`` for
+# some stuff, but that's only available on Python 3.9+. If that's not
+# found, it creates a ``unittest.mock.MagicMock`` object and annotates
+# with that. These are GC'able objects, and doing almost *anything*
+# with them results in an explosion of objects. For example, trying to
+# compare them for equality creates new objects. This causes our
+# leakchecks to fail, with reports like:
+#
+# greenlet.tests.leakcheck.LeakCheckError: refcount increased by [337, 1333, 343, 430, 530, 643, 769]
+# _Call          1820      +546
+# dict           4094       +76
+# MagicProxy      585       +73
+# tuple          2693       +66
+# _CallList        24        +3
+# weakref        1441        +1
+# function       5996        +1
+# type            736        +1
+# cell            592        +1
+# MagicMock         8        +1
+#
+# To avoid this, we *could* filter this type of object out early. In
+# principle it could leak, but we don't use mocks in greenlet, so it
+# doesn't leak from us. However, a further issue is that ``MagicMock``
+# objects have subobjects that are also GC'able, like ``_Call``, and
+# those create new mocks of their own too. So we'd have to filter them
+# as well, and they're not public. That's OK, we can workaround the
+# problem by being very careful to never compare by equality or other
+# user-defined operators, only using object identity or other builtin
+# functions.
+
+RUNNING_ON_GITHUB_ACTIONS = os.environ.get('GITHUB_ACTIONS')
+RUNNING_ON_TRAVIS = os.environ.get('TRAVIS') or RUNNING_ON_GITHUB_ACTIONS
+RUNNING_ON_APPVEYOR = os.environ.get('APPVEYOR')
+RUNNING_ON_CI = RUNNING_ON_TRAVIS or RUNNING_ON_APPVEYOR
+RUNNING_ON_MANYLINUX = os.environ.get('GREENLET_MANYLINUX')
+SKIP_LEAKCHECKS = RUNNING_ON_MANYLINUX or os.environ.get('GREENLET_SKIP_LEAKCHECKS')
+SKIP_FAILING_LEAKCHECKS = os.environ.get('GREENLET_SKIP_FAILING_LEAKCHECKS')
+ONLY_FAILING_LEAKCHECKS = os.environ.get('GREENLET_ONLY_FAILING_LEAKCHECKS')
+
+def ignores_leakcheck(func):
+    """
+    Ignore the given object during leakchecks.
+
+    Can be applied to a method, in which case the method will run, but
+    will not be subject to leak checks.
+
+    If applied to a class, the entire class will be skipped during leakchecks. This
+    is intended to be used for classes that are very slow and cause problems such as
+    test timeouts; typically it will be used for classes that are subclasses of a base
+    class and specify variants of behaviour (such as pool sizes).
+    """
+    func.ignore_leakcheck = True
+    return func
+
+def fails_leakcheck(func):
+    """
+    Mark that the function is known to leak.
+    """
+    func.fails_leakcheck = True
+    if SKIP_FAILING_LEAKCHECKS:
+        func = unittest.skip("Skipping known failures")(func)
+    return func
+
+class LeakCheckError(AssertionError):
+    pass
+
+if hasattr(sys, 'getobjects'):
+    # In a Python build with ``--with-trace-refs``, make objgraph
+    # trace *all* the objects, not just those that are tracked by the
+    # GC
+    class _MockGC(object):
+        def get_objects(self):
+            return sys.getobjects(0) # pylint:disable=no-member
+        def __getattr__(self, name):
+            return getattr(gc, name)
+    objgraph.gc = _MockGC()
+    fails_strict_leakcheck = fails_leakcheck
+else:
+    def fails_strict_leakcheck(func):
+        """
+        Decorator for a function that is known to fail when running
+        strict (``sys.getobjects()``) leakchecks.
+
+        This type of leakcheck finds all objects, even those, such as
+        strings, which are not tracked by the garbage collector.
+        """
+        return func
+
+class ignores_types_in_strict_leakcheck(object):
+    def __init__(self, types):
+        self.types = types
+    def __call__(self, func):
+        func.leakcheck_ignore_types = self.types
+        return func
+
+class _RefCountChecker(object):
+
+    # Some builtin things that we ignore
+    # XXX: Those things were ignored by gevent, but they're important here,
+    # presumably.
+    IGNORED_TYPES = () #(tuple, dict, types.FrameType, types.TracebackType)
+
+    def __init__(self, testcase, function):
+        self.testcase = testcase
+        self.function = function
+        self.deltas = []
+        self.peak_stats = {}
+        self.ignored_types = ()
+
+        # The very first time we are called, we have already been
+        # self.setUp() by the test runner, so we don't need to do it again.
+        self.needs_setUp = False
+
+    def _include_object_p(self, obj):
+        # pylint:disable=too-many-return-statements
+        #
+        # See the comment block at the top. We must be careful to
+        # avoid invoking user-defined operations.
+        if obj is self:
+            return False
+        kind = type(obj)
+        # ``self._include_object_p == obj`` returns NotImplemented
+        # for non-function objects, which causes the interpreter
+        # to try to reverse the order of arguments...which leads
+        # to the explosion of mock objects. We don't want that, so we implement
+        # the check manually.
+        if kind == type(self._include_object_p):
+            try:
+                # pylint:disable=not-callable
+                exact_method_equals = self._include_object_p.__eq__(obj)
+            except AttributeError:
+                # Python 2.7 methods may only have __cmp__, and that raises a
+                # TypeError for non-method arguments
+                # pylint:disable=no-member
+                exact_method_equals = self._include_object_p.__cmp__(obj) == 0
+
+            if exact_method_equals is not NotImplemented and exact_method_equals:
+                return False
+
+        # Similarly, we need to check identity in our __dict__ to avoid mock explosions.
+        for x in self.__dict__.values():
+            if obj is x:
+                return False
+
+
+        if kind in self.ignored_types or kind in self.IGNORED_TYPES:
+            return False
+
+        return True
+
+    def _growth(self):
+        return objgraph.growth(limit=None, peak_stats=self.peak_stats,
+                               filter=self._include_object_p)
+
+    def _report_diff(self, growth):
+        if not growth:
+            return "<Unable to calculate growth>"
+
+        lines = []
+        width = max(len(name) for name, _, _ in growth)
+        for name, count, delta in growth:
+            lines.append('%-*s%9d %+9d' % (width, name, count, delta))
+
+        diff = '\n'.join(lines)
+        return diff
+
+
+    def _run_test(self, args, kwargs):
+        gc_enabled = gc.isenabled()
+        gc.disable()
+
+        if self.needs_setUp:
+            self.testcase.setUp()
+            self.testcase.skipTearDown = False
+        try:
+            self.function(self.testcase, *args, **kwargs)
+        finally:
+            self.testcase.tearDown()
+            self.testcase.doCleanups()
+            self.testcase.skipTearDown = True
+            self.needs_setUp = True
+            if gc_enabled:
+                gc.enable()
+
+    def _growth_after(self):
+        # Grab post snapshot
+        # pylint:disable=no-member
+        if 'urlparse' in sys.modules:
+            sys.modules['urlparse'].clear_cache()
+        if 'urllib.parse' in sys.modules:
+            sys.modules['urllib.parse'].clear_cache()
+
+        return self._growth()
+
+    def _check_deltas(self, growth):
+        # Return false when we have decided there is no leak,
+        # true if we should keep looping, raises an assertion
+        # if we have decided there is a leak.
+
+        deltas = self.deltas
+        if not deltas:
+            # We haven't run yet, no data, keep looping
+            return True
+
+        if gc.garbage:
+            raise LeakCheckError("Generated uncollectable garbage %r" % (gc.garbage,))
+
+
+        # the following configurations are classified as "no leak"
+        # [0, 0]
+        # [x, 0, 0]
+        # [... a, b, c, d]  where a+b+c+d = 0
+        #
+        # the following configurations are classified as "leak"
+        # [... z, z, z]  where z > 0
+
+        if deltas[-2:] == [0, 0] and len(deltas) in (2, 3):
+            return False
+
+        if deltas[-3:] == [0, 0, 0]:
+            return False
+
+        if len(deltas) >= 4 and sum(deltas[-4:]) == 0:
+            return False
+
+        if len(deltas) >= 3 and deltas[-1] > 0 and deltas[-1] == deltas[-2] and deltas[-2] == deltas[-3]:
+            diff = self._report_diff(growth)
+            raise LeakCheckError('refcount increased by %r\n%s' % (deltas, diff))
+
+        # OK, we don't know for sure yet. Let's search for more
+        if sum(deltas[-3:]) <= 0 or sum(deltas[-4:]) <= 0 or deltas[-4:].count(0) >= 2:
+            # this is suspicious, so give a few more runs
+            limit = 11
+        else:
+            limit = 7
+        if len(deltas) >= limit:
+            raise LeakCheckError('refcount increased by %r\n%s'
+                                 % (deltas,
+                                    self._report_diff(growth)))
+
+        # We couldn't decide yet, keep going
+        return True
+
+    def __call__(self, args, kwargs):
+        for _ in range(3):
+            gc.collect()
+
+        expect_failure = getattr(self.function, 'fails_leakcheck', False)
+        if expect_failure:
+            self.testcase.expect_greenlet_leak = True
+        self.ignored_types = getattr(self.function, "leakcheck_ignore_types", ())
+
+        # Capture state before; the incremental will be
+        # updated by each call to _growth_after
+        growth = self._growth()
+
+        try:
+            while self._check_deltas(growth):
+                self._run_test(args, kwargs)
+
+                growth = self._growth_after()
+
+                self.deltas.append(sum((stat[2] for stat in growth)))
+        except LeakCheckError:
+            if not expect_failure:
+                raise
+        else:
+            if expect_failure:
+                raise LeakCheckError("Expected %s to leak but it did not." % (self.function,))
+
+def wrap_refcount(method):
+    if getattr(method, 'ignore_leakcheck', False) or SKIP_LEAKCHECKS:
+        return method
+
+    @wraps(method)
+    def wrapper(self, *args, **kwargs): # pylint:disable=too-many-branches
+        if getattr(self, 'ignore_leakcheck', False):
+            raise unittest.SkipTest("This class ignored during leakchecks")
+        if ONLY_FAILING_LEAKCHECKS and not getattr(method, 'fails_leakcheck', False):
+            raise unittest.SkipTest("Only running tests that fail leakchecks.")
+        return _RefCountChecker(self, method)(args, kwargs)
+
+    return wrapper
diff --git a/llm/Lib/site-packages/greenlet/tests/test_contextvars.py b/llm/Lib/site-packages/greenlet/tests/test_contextvars.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a16f6710aeb3734f15b3c9932a9519b64ba2f5b
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_contextvars.py
@@ -0,0 +1,310 @@
+from __future__ import print_function
+
+import gc
+import sys
+import unittest
+
+from functools import partial
+from unittest import skipUnless
+from unittest import skipIf
+
+from greenlet import greenlet
+from greenlet import getcurrent
+from . import TestCase
+
+
+try:
+    from contextvars import Context
+    from contextvars import ContextVar
+    from contextvars import copy_context
+    # From the documentation:
+    #
+    # Important: Context Variables should be created at the top module
+    # level and never in closures. Context objects hold strong
+    # references to context variables which prevents context variables
+    # from being properly garbage collected.
+    ID_VAR = ContextVar("id", default=None)
+    VAR_VAR = ContextVar("var", default=None)
+    ContextVar = None
+except ImportError:
+    Context = ContextVar = copy_context = None
+
+# We don't support testing if greenlet's built-in context var support is disabled.
+@skipUnless(Context is not None, "ContextVar not supported")
+class ContextVarsTests(TestCase):
+    def _new_ctx_run(self, *args, **kwargs):
+        return copy_context().run(*args, **kwargs)
+
+    def _increment(self, greenlet_id, callback, counts, expect):
+        ctx_var = ID_VAR
+        if expect is None:
+            self.assertIsNone(ctx_var.get())
+        else:
+            self.assertEqual(ctx_var.get(), expect)
+        ctx_var.set(greenlet_id)
+        for _ in range(2):
+            counts[ctx_var.get()] += 1
+            callback()
+
+    def _test_context(self, propagate_by):
+        # pylint:disable=too-many-branches
+        ID_VAR.set(0)
+
+        callback = getcurrent().switch
+        counts = dict((i, 0) for i in range(5))
+
+        lets = [
+            greenlet(partial(
+                partial(
+                    copy_context().run,
+                    self._increment
+                ) if propagate_by == "run" else self._increment,
+                greenlet_id=i,
+                callback=callback,
+                counts=counts,
+                expect=(
+                    i - 1 if propagate_by == "share" else
+                    0 if propagate_by in ("set", "run") else None
+                )
+            ))
+            for i in range(1, 5)
+        ]
+
+        for let in lets:
+            if propagate_by == "set":
+                let.gr_context = copy_context()
+            elif propagate_by == "share":
+                let.gr_context = getcurrent().gr_context
+
+        for i in range(2):
+            counts[ID_VAR.get()] += 1
+            for let in lets:
+                let.switch()
+
+        if propagate_by == "run":
+            # Must leave each context.run() in reverse order of entry
+            for let in reversed(lets):
+                let.switch()
+        else:
+            # No context.run(), so fine to exit in any order.
+            for let in lets:
+                let.switch()
+
+        for let in lets:
+            self.assertTrue(let.dead)
+            # When using run(), we leave the run() as the greenlet dies,
+            # and there's no context "underneath". When not using run(),
+            # gr_context still reflects the context the greenlet was
+            # running in.
+            if propagate_by == 'run':
+                self.assertIsNone(let.gr_context)
+            else:
+                self.assertIsNotNone(let.gr_context)
+
+
+        if propagate_by == "share":
+            self.assertEqual(counts, {0: 1, 1: 1, 2: 1, 3: 1, 4: 6})
+        else:
+            self.assertEqual(set(counts.values()), set([2]))
+
+    def test_context_propagated_by_context_run(self):
+        self._new_ctx_run(self._test_context, "run")
+
+    def test_context_propagated_by_setting_attribute(self):
+        self._new_ctx_run(self._test_context, "set")
+
+    def test_context_not_propagated(self):
+        self._new_ctx_run(self._test_context, None)
+
+    def test_context_shared(self):
+        self._new_ctx_run(self._test_context, "share")
+
+    def test_break_ctxvars(self):
+        let1 = greenlet(copy_context().run)
+        let2 = greenlet(copy_context().run)
+        let1.switch(getcurrent().switch)
+        let2.switch(getcurrent().switch)
+        # Since let2 entered the current context and let1 exits its own, the
+        # interpreter emits:
+        # RuntimeError: cannot exit context: thread state references a different context object
+        let1.switch()
+
+    def test_not_broken_if_using_attribute_instead_of_context_run(self):
+        let1 = greenlet(getcurrent().switch)
+        let2 = greenlet(getcurrent().switch)
+        let1.gr_context = copy_context()
+        let2.gr_context = copy_context()
+        let1.switch()
+        let2.switch()
+        let1.switch()
+        let2.switch()
+
+    def test_context_assignment_while_running(self):
+        # pylint:disable=too-many-statements
+        ID_VAR.set(None)
+
+        def target():
+            self.assertIsNone(ID_VAR.get())
+            self.assertIsNone(gr.gr_context)
+
+            # Context is created on first use
+            ID_VAR.set(1)
+            self.assertIsInstance(gr.gr_context, Context)
+            self.assertEqual(ID_VAR.get(), 1)
+            self.assertEqual(gr.gr_context[ID_VAR], 1)
+
+            # Clearing the context makes it get re-created as another
+            # empty context when next used
+            old_context = gr.gr_context
+            gr.gr_context = None  # assign None while running
+            self.assertIsNone(ID_VAR.get())
+            self.assertIsNone(gr.gr_context)
+            ID_VAR.set(2)
+            self.assertIsInstance(gr.gr_context, Context)
+            self.assertEqual(ID_VAR.get(), 2)
+            self.assertEqual(gr.gr_context[ID_VAR], 2)
+
+            new_context = gr.gr_context
+            getcurrent().parent.switch((old_context, new_context))
+            # parent switches us back to old_context
+
+            self.assertEqual(ID_VAR.get(), 1)
+            gr.gr_context = new_context  # assign non-None while running
+            self.assertEqual(ID_VAR.get(), 2)
+
+            getcurrent().parent.switch()
+            # parent switches us back to no context
+            self.assertIsNone(ID_VAR.get())
+            self.assertIsNone(gr.gr_context)
+            gr.gr_context = old_context
+            self.assertEqual(ID_VAR.get(), 1)
+
+            getcurrent().parent.switch()
+            # parent switches us back to no context
+            self.assertIsNone(ID_VAR.get())
+            self.assertIsNone(gr.gr_context)
+
+        gr = greenlet(target)
+
+        with self.assertRaisesRegex(AttributeError, "can't delete context attribute"):
+            del gr.gr_context
+
+        self.assertIsNone(gr.gr_context)
+        old_context, new_context = gr.switch()
+        self.assertIs(new_context, gr.gr_context)
+        self.assertEqual(old_context[ID_VAR], 1)
+        self.assertEqual(new_context[ID_VAR], 2)
+        self.assertEqual(new_context.run(ID_VAR.get), 2)
+        gr.gr_context = old_context  # assign non-None while suspended
+        gr.switch()
+        self.assertIs(gr.gr_context, new_context)
+        gr.gr_context = None  # assign None while suspended
+        gr.switch()
+        self.assertIs(gr.gr_context, old_context)
+        gr.gr_context = None
+        gr.switch()
+        self.assertIsNone(gr.gr_context)
+
+        # Make sure there are no reference leaks
+        gr = None
+        gc.collect()
+        self.assertEqual(sys.getrefcount(old_context), 2)
+        self.assertEqual(sys.getrefcount(new_context), 2)
+
+    def test_context_assignment_different_thread(self):
+        import threading
+        VAR_VAR.set(None)
+        ctx = Context()
+
+        is_running = threading.Event()
+        should_suspend = threading.Event()
+        did_suspend = threading.Event()
+        should_exit = threading.Event()
+        holder = []
+
+        def greenlet_in_thread_fn():
+            VAR_VAR.set(1)
+            is_running.set()
+            should_suspend.wait(10)
+            VAR_VAR.set(2)
+            getcurrent().parent.switch()
+            holder.append(VAR_VAR.get())
+
+        def thread_fn():
+            gr = greenlet(greenlet_in_thread_fn)
+            gr.gr_context = ctx
+            holder.append(gr)
+            gr.switch()
+            did_suspend.set()
+            should_exit.wait(10)
+            gr.switch()
+            del gr
+            greenlet() # trigger cleanup
+
+        thread = threading.Thread(target=thread_fn, daemon=True)
+        thread.start()
+        is_running.wait(10)
+        gr = holder[0]
+
+        # Can't access or modify context if the greenlet is running
+        # in a different thread
+        with self.assertRaisesRegex(ValueError, "running in a different"):
+            getattr(gr, 'gr_context')
+        with self.assertRaisesRegex(ValueError, "running in a different"):
+            gr.gr_context = None
+
+        should_suspend.set()
+        did_suspend.wait(10)
+
+        # OK to access and modify context if greenlet is suspended
+        self.assertIs(gr.gr_context, ctx)
+        self.assertEqual(gr.gr_context[VAR_VAR], 2)
+        gr.gr_context = None
+
+        should_exit.set()
+        thread.join(10)
+
+        self.assertEqual(holder, [gr, None])
+
+        # Context can still be accessed/modified when greenlet is dead:
+        self.assertIsNone(gr.gr_context)
+        gr.gr_context = ctx
+        self.assertIs(gr.gr_context, ctx)
+
+        # Otherwise we leak greenlets on some platforms.
+        # XXX: Should be able to do this automatically
+        del holder[:]
+        gr = None
+        thread = None
+
+    def test_context_assignment_wrong_type(self):
+        g = greenlet()
+        with self.assertRaisesRegex(TypeError,
+                                    "greenlet context must be a contextvars.Context or None"):
+            g.gr_context = self
+
+
+@skipIf(Context is not None, "ContextVar supported")
+class NoContextVarsTests(TestCase):
+    def test_contextvars_errors(self):
+        let1 = greenlet(getcurrent().switch)
+        self.assertFalse(hasattr(let1, 'gr_context'))
+        with self.assertRaises(AttributeError):
+            getattr(let1, 'gr_context')
+
+        with self.assertRaises(AttributeError):
+            let1.gr_context = None
+
+        let1.switch()
+
+        with self.assertRaises(AttributeError):
+            getattr(let1, 'gr_context')
+
+        with self.assertRaises(AttributeError):
+            let1.gr_context = None
+
+        del let1
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/llm/Lib/site-packages/greenlet/tests/test_cpp.py b/llm/Lib/site-packages/greenlet/tests/test_cpp.py
new file mode 100644
index 0000000000000000000000000000000000000000..2d0cc9c9705cadaa7cfee28ce24944ca5cd1f639
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_cpp.py
@@ -0,0 +1,73 @@
+from __future__ import print_function
+from __future__ import absolute_import
+
+import subprocess
+import unittest
+
+import greenlet
+from . import _test_extension_cpp
+from . import TestCase
+from . import WIN
+
+class CPPTests(TestCase):
+    def test_exception_switch(self):
+        greenlets = []
+        for i in range(4):
+            g = greenlet.greenlet(_test_extension_cpp.test_exception_switch)
+            g.switch(i)
+            greenlets.append(g)
+        for i, g in enumerate(greenlets):
+            self.assertEqual(g.switch(), i)
+
+    def _do_test_unhandled_exception(self, target):
+        import os
+        import sys
+        script = os.path.join(
+            os.path.dirname(__file__),
+            'fail_cpp_exception.py',
+        )
+        args = [sys.executable, script, target.__name__ if not isinstance(target, str) else target]
+        __traceback_info__ = args
+        with self.assertRaises(subprocess.CalledProcessError) as exc:
+            subprocess.check_output(
+                args,
+                encoding='utf-8',
+                stderr=subprocess.STDOUT
+            )
+
+        ex = exc.exception
+        expected_exit = self.get_expected_returncodes_for_aborted_process()
+        self.assertIn(ex.returncode, expected_exit)
+        self.assertIn('fail_cpp_exception is running', ex.output)
+        return ex.output
+
+
+    def test_unhandled_nonstd_exception_aborts(self):
+        # verify that plain unhandled throw aborts
+        self._do_test_unhandled_exception(_test_extension_cpp.test_exception_throw_nonstd)
+
+    def test_unhandled_std_exception_aborts(self):
+        # verify that plain unhandled throw aborts
+        self._do_test_unhandled_exception(_test_extension_cpp.test_exception_throw_std)
+
+    @unittest.skipIf(WIN, "XXX: This does not crash on Windows")
+    # Meaning the exception is getting lost somewhere...
+    def test_unhandled_std_exception_as_greenlet_function_aborts(self):
+        # verify that plain unhandled throw aborts
+        output = self._do_test_unhandled_exception('run_as_greenlet_target')
+        self.assertIn(
+            # We really expect this to be prefixed with "greenlet: Unhandled C++ exception:"
+            # as added by our handler for std::exception (see TUserGreenlet.cpp), but
+            # that's not correct everywhere --- our handler never runs before std::terminate
+            # gets called (for example, on arm32).
+            'Thrown from an extension.',
+            output
+        )
+
+    def test_unhandled_exception_in_greenlet_aborts(self):
+        # verify that unhandled throw called in greenlet aborts too
+        self._do_test_unhandled_exception('run_unhandled_exception_in_greenlet_aborts')
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/llm/Lib/site-packages/greenlet/tests/test_extension_interface.py b/llm/Lib/site-packages/greenlet/tests/test_extension_interface.py
new file mode 100644
index 0000000000000000000000000000000000000000..34b66567fc60d68988858a41c8ca98d29b90ac5e
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_extension_interface.py
@@ -0,0 +1,115 @@
+from __future__ import print_function
+from __future__ import absolute_import
+
+import sys
+
+import greenlet
+from . import _test_extension
+from . import TestCase
+
+# pylint:disable=c-extension-no-member
+
+class CAPITests(TestCase):
+    def test_switch(self):
+        self.assertEqual(
+            50, _test_extension.test_switch(greenlet.greenlet(lambda: 50)))
+
+    def test_switch_kwargs(self):
+        def adder(x, y):
+            return x * y
+        g = greenlet.greenlet(adder)
+        self.assertEqual(6, _test_extension.test_switch_kwargs(g, x=3, y=2))
+
+    def test_setparent(self):
+        # pylint:disable=disallowed-name
+        def foo():
+            def bar():
+                greenlet.getcurrent().parent.switch()
+
+                # This final switch should go back to the main greenlet, since
+                # the test_setparent() function in the C extension should have
+                # reparented this greenlet.
+                greenlet.getcurrent().parent.switch()
+                raise AssertionError("Should never have reached this code")
+            child = greenlet.greenlet(bar)
+            child.switch()
+            greenlet.getcurrent().parent.switch(child)
+            greenlet.getcurrent().parent.throw(
+                AssertionError("Should never reach this code"))
+        foo_child = greenlet.greenlet(foo).switch()
+        self.assertEqual(None, _test_extension.test_setparent(foo_child))
+
+    def test_getcurrent(self):
+        _test_extension.test_getcurrent()
+
+    def test_new_greenlet(self):
+        self.assertEqual(-15, _test_extension.test_new_greenlet(lambda: -15))
+
+    def test_raise_greenlet_dead(self):
+        self.assertRaises(
+            greenlet.GreenletExit, _test_extension.test_raise_dead_greenlet)
+
+    def test_raise_greenlet_error(self):
+        self.assertRaises(
+            greenlet.error, _test_extension.test_raise_greenlet_error)
+
+    def test_throw(self):
+        seen = []
+
+        def foo():         # pylint:disable=disallowed-name
+            try:
+                greenlet.getcurrent().parent.switch()
+            except ValueError:
+                seen.append(sys.exc_info()[1])
+            except greenlet.GreenletExit:
+                raise AssertionError
+        g = greenlet.greenlet(foo)
+        g.switch()
+        _test_extension.test_throw(g)
+        self.assertEqual(len(seen), 1)
+        self.assertTrue(
+            isinstance(seen[0], ValueError),
+            "ValueError was not raised in foo()")
+        self.assertEqual(
+            str(seen[0]),
+            'take that sucka!',
+            "message doesn't match")
+
+    def test_non_traceback_param(self):
+        with self.assertRaises(TypeError) as exc:
+            _test_extension.test_throw_exact(
+                greenlet.getcurrent(),
+                Exception,
+                Exception(),
+                self
+            )
+        self.assertEqual(str(exc.exception),
+                         "throw() third argument must be a traceback object")
+
+    def test_instance_of_wrong_type(self):
+        with self.assertRaises(TypeError) as exc:
+            _test_extension.test_throw_exact(
+                greenlet.getcurrent(),
+                Exception(),
+                BaseException(),
+                None,
+            )
+
+        self.assertEqual(str(exc.exception),
+                         "instance exception may not have a separate value")
+
+    def test_not_throwable(self):
+        with self.assertRaises(TypeError) as exc:
+            _test_extension.test_throw_exact(
+                greenlet.getcurrent(),
+                "abc",
+                None,
+                None,
+            )
+        self.assertEqual(str(exc.exception),
+                         "exceptions must be classes, or instances, not str")
+
+
+if __name__ == '__main__':
+    import unittest
+    unittest.main()
diff --git a/llm/Lib/site-packages/greenlet/tests/test_gc.py b/llm/Lib/site-packages/greenlet/tests/test_gc.py
new file mode 100644
index 0000000000000000000000000000000000000000..994addb9b757954b8355d04ba6ba5b7d6abda0bc
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_gc.py
@@ -0,0 +1,86 @@
+import gc
+
+import weakref
+
+import greenlet
+
+
+from . import TestCase
+from .leakcheck import fails_leakcheck
+# These only work with greenlet gc support
+# which is no longer optional.
+assert greenlet.GREENLET_USE_GC
+
+class GCTests(TestCase):
+    def test_dead_circular_ref(self):
+        o = weakref.ref(greenlet.greenlet(greenlet.getcurrent).switch())
+        gc.collect()
+        if o() is not None:
+            import sys
+            print("O IS NOT NONE.", sys.getrefcount(o()))
+        self.assertIsNone(o())
+        self.assertFalse(gc.garbage, gc.garbage)
+
+    def test_circular_greenlet(self):
+        class circular_greenlet(greenlet.greenlet):
+            self = None
+        o = circular_greenlet()
+        o.self = o
+        o = weakref.ref(o)
+        gc.collect()
+        self.assertIsNone(o())
+        self.assertFalse(gc.garbage, gc.garbage)
+
+    def test_inactive_ref(self):
+        class inactive_greenlet(greenlet.greenlet):
+            def __init__(self):
+                greenlet.greenlet.__init__(self, run=self.run)
+
+            def run(self):
+                pass
+        o = inactive_greenlet()
+        o = weakref.ref(o)
+        gc.collect()
+        self.assertIsNone(o())
+        self.assertFalse(gc.garbage, gc.garbage)
+
+    @fails_leakcheck
+    def test_finalizer_crash(self):
+        # This test is designed to crash when active greenlets
+        # are made garbage collectable, until the underlying
+        # problem is resolved. How does it work:
+        # - order of object creation is important
+        # - array is created first, so it is moved to unreachable first
+        # - we create a cycle between a greenlet and this array
+        # - we create an object that participates in gc, is only
+        #   referenced by a greenlet, and would corrupt gc lists
+        #   on destruction, the easiest is to use an object with
+        #   a finalizer
+        # - because array is the first object in unreachable it is
+        #   cleared first, which causes all references to greenlet
+        #   to disappear and causes greenlet to be destroyed, but since
+        #   it is still live it causes a switch during gc, which causes
+        #   an object with finalizer to be destroyed, which causes stack
+        #   corruption and then a crash
+
+        class object_with_finalizer(object):
+            def __del__(self):
+                pass
+        array = []
+        parent = greenlet.getcurrent()
+        def greenlet_body():
+            greenlet.getcurrent().object = object_with_finalizer()
+            try:
+                parent.switch()
+            except greenlet.GreenletExit:
+                print("Got greenlet exit!")
+            finally:
+                del greenlet.getcurrent().object
+        g = greenlet.greenlet(greenlet_body)
+        g.array = array
+        array.append(g)
+        g.switch()
+        del array
+        del g
+        greenlet.getcurrent()
+        gc.collect()
diff --git a/llm/Lib/site-packages/greenlet/tests/test_generator.py b/llm/Lib/site-packages/greenlet/tests/test_generator.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca4a644b6e300910a78704593da592363d7db8e7
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_generator.py
@@ -0,0 +1,59 @@
+
+from greenlet import greenlet
+
+from . import TestCase
+
+class genlet(greenlet):
+    parent = None
+    def __init__(self, *args, **kwds):
+        self.args = args
+        self.kwds = kwds
+
+    def run(self):
+        fn, = self.fn
+        fn(*self.args, **self.kwds)
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        self.parent = greenlet.getcurrent()
+        result = self.switch()
+        if self:
+            return result
+
+        raise StopIteration
+
+    next = __next__
+
+
+def Yield(value):
+    g = greenlet.getcurrent()
+    while not isinstance(g, genlet):
+        if g is None:
+            raise RuntimeError('yield outside a genlet')
+        g = g.parent
+    g.parent.switch(value)
+
+
+def generator(func):
+    class Generator(genlet):
+        fn = (func,)
+    return Generator
+
+# ____________________________________________________________
+
+
+class GeneratorTests(TestCase):
+    def test_generator(self):
+        seen = []
+
+        def g(n):
+            for i in range(n):
+                seen.append(i)
+                Yield(i)
+        g = generator(g)
+        for _ in range(3):
+            for j in g(5):
+                seen.append(j)
+        self.assertEqual(seen, 3 * [0, 0, 1, 1, 2, 2, 3, 3, 4, 4])
diff --git a/llm/Lib/site-packages/greenlet/tests/test_generator_nested.py b/llm/Lib/site-packages/greenlet/tests/test_generator_nested.py
new file mode 100644
index 0000000000000000000000000000000000000000..8d752a63dd6560995d4d785069a61465e2a729c5
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_generator_nested.py
@@ -0,0 +1,168 @@
+
+from greenlet import greenlet
+from . import TestCase
+from .leakcheck import fails_leakcheck
+
+class genlet(greenlet):
+    parent = None
+    def __init__(self, *args, **kwds):
+        self.args = args
+        self.kwds = kwds
+        self.child = None
+
+    def run(self):
+        # Note the function is packed in a tuple
+        # to avoid creating a bound method for it.
+        fn, = self.fn
+        fn(*self.args, **self.kwds)
+
+    def __iter__(self):
+        return self
+
+    def set_child(self, child):
+        self.child = child
+
+    def __next__(self):
+        if self.child:
+            child = self.child
+            while child.child:
+                tmp = child
+                child = child.child
+                tmp.child = None
+
+            result = child.switch()
+        else:
+            self.parent = greenlet.getcurrent()
+            result = self.switch()
+
+        if self:
+            return result
+
+        raise StopIteration
+
+    next = __next__
+
+def Yield(value, level=1):
+    g = greenlet.getcurrent()
+
+    while level != 0:
+        if not isinstance(g, genlet):
+            raise RuntimeError('yield outside a genlet')
+        if level > 1:
+            g.parent.set_child(g)
+        g = g.parent
+        level -= 1
+
+    g.switch(value)
+
+
+def Genlet(func):
+    class TheGenlet(genlet):
+        fn = (func,)
+    return TheGenlet
+
+# ____________________________________________________________
+
+
+def g1(n, seen):
+    for i in range(n):
+        seen.append(i + 1)
+        yield i
+
+
+def g2(n, seen):
+    for i in range(n):
+        seen.append(i + 1)
+        Yield(i)
+
+g2 = Genlet(g2)
+
+
+def nested(i):
+    Yield(i)
+
+
+def g3(n, seen):
+    for i in range(n):
+        seen.append(i + 1)
+        nested(i)
+g3 = Genlet(g3)
+
+
+def a(n):
+    if n == 0:
+        return
+    for ii in ax(n - 1):
+        Yield(ii)
+    Yield(n)
+ax = Genlet(a)
+
+
+def perms(l):
+    if len(l) > 1:
+        for e in l:
+            # No syntactical sugar for generator expressions
+            x = [Yield([e] + p) for p in perms([x for x in l if x != e])]
+            assert x
+    else:
+        Yield(l)
+perms = Genlet(perms)
+
+
+def gr1(n):
+    for ii in range(1, n):
+        Yield(ii)
+        Yield(ii * ii, 2)
+
+gr1 = Genlet(gr1)
+
+
+def gr2(n, seen):
+    for ii in gr1(n):
+        seen.append(ii)
+
+gr2 = Genlet(gr2)
+
+
+class NestedGeneratorTests(TestCase):
+    def test_layered_genlets(self):
+        seen = []
+        for ii in gr2(5, seen):
+            seen.append(ii)
+        self.assertEqual(seen, [1, 1, 2, 4, 3, 9, 4, 16])
+
+    @fails_leakcheck
+    def test_permutations(self):
+        gen_perms = perms(list(range(4)))
+        permutations = list(gen_perms)
+        self.assertEqual(len(permutations), 4 * 3 * 2 * 1)
+        self.assertIn([0, 1, 2, 3], permutations)
+        self.assertIn([3, 2, 1, 0], permutations)
+        res = []
+        for ii in zip(perms(list(range(4))), perms(list(range(3)))):
+            res.append(ii)
+        self.assertEqual(
+            res,
+            [([0, 1, 2, 3], [0, 1, 2]), ([0, 1, 3, 2], [0, 2, 1]),
+             ([0, 2, 1, 3], [1, 0, 2]), ([0, 2, 3, 1], [1, 2, 0]),
+             ([0, 3, 1, 2], [2, 0, 1]), ([0, 3, 2, 1], [2, 1, 0])])
+        # XXX Test to make sure we are working as a generator expression
+
+    def test_genlet_simple(self):
+        for g in g1, g2, g3:
+            seen = []
+            for _ in range(3):
+                for j in g(5, seen):
+                    seen.append(j)
+            self.assertEqual(seen, 3 * [1, 0, 2, 1, 3, 2, 4, 3, 5, 4])
+
+    def test_genlet_bad(self):
+        try:
+            Yield(10)
+        except RuntimeError:
+            pass
+
+    def test_nested_genlets(self):
+        seen = []
+        for ii in ax(5):
+            seen.append(ii)
diff --git a/llm/Lib/site-packages/greenlet/tests/test_greenlet.py b/llm/Lib/site-packages/greenlet/tests/test_greenlet.py
new file mode 100644
index 0000000000000000000000000000000000000000..51849cd693cf37141dbc48bbe10ea67c8f9dee51
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_greenlet.py
@@ -0,0 +1,1311 @@
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import print_function
+
+import gc
+import sys
+import time
+import threading
+
+from abc import ABCMeta, abstractmethod
+
+import greenlet
+from greenlet import greenlet as RawGreenlet
+from . import TestCase
+from .leakcheck import fails_leakcheck
+
+
+# We manually manage locks in many tests
+# pylint:disable=consider-using-with
+# pylint:disable=too-many-public-methods
+# This module is quite large.
+# TODO: Refactor into separate test files. For example,
+# put all the regression tests that used to produce
+# crashes in test_greenlet_no_crash; put tests that DO deliberately crash
+# the interpreter into test_greenlet_crash.
+# pylint:disable=too-many-lines
+
+class SomeError(Exception):
+    pass
+
+
+def fmain(seen):
+    try:
+        greenlet.getcurrent().parent.switch()
+    except:
+        seen.append(sys.exc_info()[0])
+        raise
+    raise SomeError
+
+
+def send_exception(g, exc):
+    # note: send_exception(g, exc)  can be now done with  g.throw(exc).
+    # the purpose of this test is to explicitly check the propagation rules.
+    def crasher(exc):
+        raise exc
+    g1 = RawGreenlet(crasher, parent=g)
+    g1.switch(exc)
+
+
+class TestGreenlet(TestCase):
+
+    def _do_simple_test(self):
+        lst = []
+
+        def f():
+            lst.append(1)
+            greenlet.getcurrent().parent.switch()
+            lst.append(3)
+        g = RawGreenlet(f)
+        lst.append(0)
+        g.switch()
+        lst.append(2)
+        g.switch()
+        lst.append(4)
+        self.assertEqual(lst, list(range(5)))
+
+    def test_simple(self):
+        self._do_simple_test()
+
+    def test_switch_no_run_raises_AttributeError(self):
+        g = RawGreenlet()
+        with self.assertRaises(AttributeError) as exc:
+            g.switch()
+
+        self.assertIn("run", str(exc.exception))
+
+    def test_throw_no_run_raises_AttributeError(self):
+        g = RawGreenlet()
+        with self.assertRaises(AttributeError) as exc:
+            g.throw(SomeError)
+
+        self.assertIn("run", str(exc.exception))
+
+    def test_parent_equals_None(self):
+        g = RawGreenlet(parent=None)
+        self.assertIsNotNone(g)
+        self.assertIs(g.parent, greenlet.getcurrent())
+
+    def test_run_equals_None(self):
+        g = RawGreenlet(run=None)
+        self.assertIsNotNone(g)
+        self.assertIsNone(g.run)
+
+    def test_two_children(self):
+        lst = []
+
+        def f():
+            lst.append(1)
+            greenlet.getcurrent().parent.switch()
+            lst.extend([1, 1])
+        g = RawGreenlet(f)
+        h = RawGreenlet(f)
+        g.switch()
+        self.assertEqual(len(lst), 1)
+        h.switch()
+        self.assertEqual(len(lst), 2)
+        h.switch()
+        self.assertEqual(len(lst), 4)
+        self.assertEqual(h.dead, True)
+        g.switch()
+        self.assertEqual(len(lst), 6)
+        self.assertEqual(g.dead, True)
+
+    def test_two_recursive_children(self):
+        lst = []
+
+        def f():
+            lst.append('b')
+            greenlet.getcurrent().parent.switch()
+
+        def g():
+            lst.append('a')
+            g = RawGreenlet(f)
+            g.switch()
+            lst.append('c')
+
+        g = RawGreenlet(g)
+        self.assertEqual(sys.getrefcount(g), 2)
+        g.switch()
+        self.assertEqual(lst, ['a', 'b', 'c'])
+        # Just the one in this frame, plus the one on the stack we pass to the function
+        self.assertEqual(sys.getrefcount(g), 2)
+
+    def test_threads(self):
+        success = []
+
+        def f():
+            self._do_simple_test()
+            success.append(True)
+        ths = [threading.Thread(target=f) for i in range(10)]
+        for th in ths:
+            th.start()
+        for th in ths:
+            th.join(10)
+        self.assertEqual(len(success), len(ths))
+
+    def test_exception(self):
+        seen = []
+        g1 = RawGreenlet(fmain)
+        g2 = RawGreenlet(fmain)
+        g1.switch(seen)
+        g2.switch(seen)
+        g2.parent = g1
+
+        self.assertEqual(seen, [])
+        #with self.assertRaises(SomeError):
+        #    p("***Switching back")
+        #    g2.switch()
+        # Creating this as a bound method can reveal bugs that
+        # are hidden on newer versions of Python that avoid creating
+        # bound methods for direct expressions; IOW, don't use the `with`
+        # form!
+        self.assertRaises(SomeError, g2.switch)
+        self.assertEqual(seen, [SomeError])
+
+        value = g2.switch()
+        self.assertEqual(value, ())
+        self.assertEqual(seen, [SomeError])
+
+        value = g2.switch(25)
+        self.assertEqual(value, 25)
+        self.assertEqual(seen, [SomeError])
+
+
+    def test_send_exception(self):
+        seen = []
+        g1 = RawGreenlet(fmain)
+        g1.switch(seen)
+        self.assertRaises(KeyError, send_exception, g1, KeyError)
+        self.assertEqual(seen, [KeyError])
+
+    def test_dealloc(self):
+        seen = []
+        g1 = RawGreenlet(fmain)
+        g2 = RawGreenlet(fmain)
+        g1.switch(seen)
+        g2.switch(seen)
+        self.assertEqual(seen, [])
+        del g1
+        gc.collect()
+        self.assertEqual(seen, [greenlet.GreenletExit])
+        del g2
+        gc.collect()
+        self.assertEqual(seen, [greenlet.GreenletExit, greenlet.GreenletExit])
+
+    def test_dealloc_catches_GreenletExit_throws_other(self):
+        def run():
+            try:
+                greenlet.getcurrent().parent.switch()
+            except greenlet.GreenletExit:
+                raise SomeError from None
+
+        g = RawGreenlet(run)
+        g.switch()
+        # Destroying the only reference to the greenlet causes it
+        # to get GreenletExit; when it in turn raises, even though we're the parent
+        # we don't get the exception, it just gets printed.
+        # When we run on 3.8 only, we can use sys.unraisablehook
+        oldstderr = sys.stderr
+        try:
+            from cStringIO import StringIO
+        except ImportError:
+            from io import StringIO
+        stderr = sys.stderr = StringIO()
+        try:
+            del g
+        finally:
+            sys.stderr = oldstderr
+
+        v = stderr.getvalue()
+        self.assertIn("Exception", v)
+        self.assertIn('ignored', v)
+        self.assertIn("SomeError", v)
+
+
+    def test_dealloc_other_thread(self):
+        seen = []
+        someref = []
+
+        bg_glet_created_running_and_no_longer_ref_in_bg = threading.Event()
+        fg_ref_released = threading.Event()
+        bg_should_be_clear = threading.Event()
+        ok_to_exit_bg_thread = threading.Event()
+
+        def f():
+            g1 = RawGreenlet(fmain)
+            g1.switch(seen)
+            someref.append(g1)
+            del g1
+            gc.collect()
+
+            bg_glet_created_running_and_no_longer_ref_in_bg.set()
+            fg_ref_released.wait(3)
+
+            RawGreenlet()   # trigger release
+            bg_should_be_clear.set()
+            ok_to_exit_bg_thread.wait(3)
+            RawGreenlet() # One more time
+
+        t = threading.Thread(target=f)
+        t.start()
+        bg_glet_created_running_and_no_longer_ref_in_bg.wait(10)
+
+        self.assertEqual(seen, [])
+        self.assertEqual(len(someref), 1)
+        del someref[:]
+        gc.collect()
+        # g1 is not released immediately because it's from another thread
+        self.assertEqual(seen, [])
+        fg_ref_released.set()
+        bg_should_be_clear.wait(3)
+        try:
+            self.assertEqual(seen, [greenlet.GreenletExit])
+        finally:
+            ok_to_exit_bg_thread.set()
+            t.join(10)
+            del seen[:]
+            del someref[:]
+
+    def test_frame(self):
+        def f1():
+            f = sys._getframe(0) # pylint:disable=protected-access
+            self.assertEqual(f.f_back, None)
+            greenlet.getcurrent().parent.switch(f)
+            return "meaning of life"
+        g = RawGreenlet(f1)
+        frame = g.switch()
+        self.assertTrue(frame is g.gr_frame)
+        self.assertTrue(g)
+
+        from_g = g.switch()
+        self.assertFalse(g)
+        self.assertEqual(from_g, 'meaning of life')
+        self.assertEqual(g.gr_frame, None)
+
+    def test_thread_bug(self):
+        def runner(x):
+            g = RawGreenlet(lambda: time.sleep(x))
+            g.switch()
+        t1 = threading.Thread(target=runner, args=(0.2,))
+        t2 = threading.Thread(target=runner, args=(0.3,))
+        t1.start()
+        t2.start()
+        t1.join(10)
+        t2.join(10)
+
+    def test_switch_kwargs(self):
+        def run(a, b):
+            self.assertEqual(a, 4)
+            self.assertEqual(b, 2)
+            return 42
+        x = RawGreenlet(run).switch(a=4, b=2)
+        self.assertEqual(x, 42)
+
+    def test_switch_kwargs_to_parent(self):
+        def run(x):
+            greenlet.getcurrent().parent.switch(x=x)
+            greenlet.getcurrent().parent.switch(2, x=3)
+            return x, x ** 2
+        g = RawGreenlet(run)
+        self.assertEqual({'x': 3}, g.switch(3))
+        self.assertEqual(((2,), {'x': 3}), g.switch())
+        self.assertEqual((3, 9), g.switch())
+
+    def test_switch_to_another_thread(self):
+        data = {}
+        created_event = threading.Event()
+        done_event = threading.Event()
+
+        def run():
+            data['g'] = RawGreenlet(lambda: None)
+            created_event.set()
+            done_event.wait(10)
+        thread = threading.Thread(target=run)
+        thread.start()
+        created_event.wait(10)
+        with self.assertRaises(greenlet.error):
+            data['g'].switch()
+        done_event.set()
+        thread.join(10)
+        # XXX: Should handle this automatically
+        data.clear()
+
+    def test_exc_state(self):
+        def f():
+            try:
+                raise ValueError('fun')
+            except: # pylint:disable=bare-except
+                exc_info = sys.exc_info()
+                RawGreenlet(h).switch()
+                self.assertEqual(exc_info, sys.exc_info())
+
+        def h():
+            self.assertEqual(sys.exc_info(), (None, None, None))
+
+        RawGreenlet(f).switch()
+
+    def test_instance_dict(self):
+        def f():
+            greenlet.getcurrent().test = 42
+        def deldict(g):
+            del g.__dict__
+        def setdict(g, value):
+            g.__dict__ = value
+        g = RawGreenlet(f)
+        self.assertEqual(g.__dict__, {})
+        g.switch()
+        self.assertEqual(g.test, 42)
+        self.assertEqual(g.__dict__, {'test': 42})
+        g.__dict__ = g.__dict__
+        self.assertEqual(g.__dict__, {'test': 42})
+        self.assertRaises(TypeError, deldict, g)
+        self.assertRaises(TypeError, setdict, g, 42)
+
+    def test_running_greenlet_has_no_run(self):
+        has_run = []
+        def func():
+            has_run.append(
+                hasattr(greenlet.getcurrent(), 'run')
+            )
+
+        g = RawGreenlet(func)
+        g.switch()
+        self.assertEqual(has_run, [False])
+
+    def test_deepcopy(self):
+        import copy
+        self.assertRaises(TypeError, copy.copy, RawGreenlet())
+        self.assertRaises(TypeError, copy.deepcopy, RawGreenlet())
+
+    def test_parent_restored_on_kill(self):
+        hub = RawGreenlet(lambda: None)
+        main = greenlet.getcurrent()
+        result = []
+        def worker():
+            try:
+                # Wait to be killed by going back to the test.
+                main.switch()
+            except greenlet.GreenletExit:
+                # Resurrect and switch to parent
+                result.append(greenlet.getcurrent().parent)
+                result.append(greenlet.getcurrent())
+                hub.switch()
+        g = RawGreenlet(worker, parent=hub)
+        g.switch()
+        # delete the only reference, thereby raising GreenletExit
+        del g
+        self.assertTrue(result)
+        self.assertIs(result[0], main)
+        self.assertIs(result[1].parent, hub)
+        # Delete them, thereby breaking the cycle between the greenlet
+        # and the frame, which otherwise would never be collectable
+        # XXX: We should be able to automatically fix this.
+        del result[:]
+        hub = None
+        main = None
+
+    def test_parent_return_failure(self):
+        # No run causes AttributeError on switch
+        g1 = RawGreenlet()
+        # Greenlet that implicitly switches to parent
+        g2 = RawGreenlet(lambda: None, parent=g1)
+        # AttributeError should propagate to us, no fatal errors
+        with self.assertRaises(AttributeError):
+            g2.switch()
+
+    def test_throw_exception_not_lost(self):
+        class mygreenlet(RawGreenlet):
+            def __getattribute__(self, name):
+                try:
+                    raise Exception # pylint:disable=broad-exception-raised
+                except: # pylint:disable=bare-except
+                    pass
+                return RawGreenlet.__getattribute__(self, name)
+        g = mygreenlet(lambda: None)
+        self.assertRaises(SomeError, g.throw, SomeError())
+
+    @fails_leakcheck
+    def _do_test_throw_to_dead_thread_doesnt_crash(self, wait_for_cleanup=False):
+        result = []
+        def worker():
+            greenlet.getcurrent().parent.switch()
+
+        def creator():
+            g = RawGreenlet(worker)
+            g.switch()
+            result.append(g)
+            if wait_for_cleanup:
+                # Let this greenlet eventually be cleaned up.
+                g.switch()
+                greenlet.getcurrent()
+        t = threading.Thread(target=creator)
+        t.start()
+        t.join(10)
+        del t
+        # But, depending on the operating system, the thread
+        # deallocator may not actually have run yet! So we can't be
+        # sure about the error message unless we wait.
+        if wait_for_cleanup:
+            self.wait_for_pending_cleanups()
+        with self.assertRaises(greenlet.error) as exc:
+            result[0].throw(SomeError)
+
+        if not wait_for_cleanup:
+            self.assertIn(
+                str(exc.exception), [
+                    "cannot switch to a different thread (which happens to have exited)",
+                    "cannot switch to a different thread"
+                ]
+            )
+        else:
+            self.assertEqual(
+                str(exc.exception),
+                "cannot switch to a different thread (which happens to have exited)",
+            )
+
+        if hasattr(result[0].gr_frame, 'clear'):
+            # The frame is actually executing (it thinks), we can't clear it.
+            with self.assertRaises(RuntimeError):
+                result[0].gr_frame.clear()
+        # Unfortunately, this doesn't actually clear the references, they're in the
+        # fast local array.
+        if not wait_for_cleanup:
+            result[0].gr_frame.f_locals.clear()
+        else:
+            self.assertIsNone(result[0].gr_frame)
+
+        del creator
+        worker = None
+        del result[:]
+        # XXX: we ought to be able to automatically fix this.
+        # See issue 252
+        self.expect_greenlet_leak = True # direct us not to wait for it to go away
+
+    @fails_leakcheck
+    def test_throw_to_dead_thread_doesnt_crash(self):
+        self._do_test_throw_to_dead_thread_doesnt_crash()
+
+    def test_throw_to_dead_thread_doesnt_crash_wait(self):
+        self._do_test_throw_to_dead_thread_doesnt_crash(True)
+
+    @fails_leakcheck
+    def test_recursive_startup(self):
+        class convoluted(RawGreenlet):
+            def __init__(self):
+                RawGreenlet.__init__(self)
+                self.count = 0
+            def __getattribute__(self, name):
+                if name == 'run' and self.count == 0:
+                    self.count = 1
+                    self.switch(43)
+                return RawGreenlet.__getattribute__(self, name)
+            def run(self, value):
+                while True:
+                    self.parent.switch(value)
+        g = convoluted()
+        self.assertEqual(g.switch(42), 43)
+        # Exits the running greenlet, otherwise it leaks
+        # XXX: We should be able to automatically fix this
+        #g.throw(greenlet.GreenletExit)
+        #del g
+        self.expect_greenlet_leak = True
+
+    def test_threaded_updatecurrent(self):
+        # released when main thread should execute
+        lock1 = threading.Lock()
+        lock1.acquire()
+        # released when another thread should execute
+        lock2 = threading.Lock()
+        lock2.acquire()
+        class finalized(object):
+            def __del__(self):
+                # happens while in green_updatecurrent() in main greenlet
+                # should be very careful not to accidentally call it again
+                # at the same time we must make sure another thread executes
+                lock2.release()
+                lock1.acquire()
+                # now ts_current belongs to another thread
+        def deallocator():
+            greenlet.getcurrent().parent.switch()
+        def fthread():
+            lock2.acquire()
+            greenlet.getcurrent()
+            del g[0]
+            lock1.release()
+            lock2.acquire()
+            greenlet.getcurrent()
+            lock1.release()
+        main = greenlet.getcurrent()
+        g = [RawGreenlet(deallocator)]
+        g[0].bomb = finalized()
+        g[0].switch()
+        t = threading.Thread(target=fthread)
+        t.start()
+        # let another thread grab ts_current and deallocate g[0]
+        lock2.release()
+        lock1.acquire()
+        # this is the corner stone
+        # getcurrent() will notice that ts_current belongs to another thread
+        # and start the update process, which would notice that g[0] should
+        # be deallocated, and that will execute an object's finalizer. Now,
+        # that object will let another thread run so it can grab ts_current
+        # again, which would likely crash the interpreter if there's no
+        # check for this case at the end of green_updatecurrent(). This test
+        # passes if getcurrent() returns correct result, but it's likely
+        # to randomly crash if it's not anyway.
+        self.assertEqual(greenlet.getcurrent(), main)
+        # wait for another thread to complete, just in case
+        t.join(10)
+
+    def test_dealloc_switch_args_not_lost(self):
+        seen = []
+        def worker():
+            # wait for the value
+            value = greenlet.getcurrent().parent.switch()
+            # delete all references to ourself
+            del worker[0]
+            initiator.parent = greenlet.getcurrent().parent
+            # switch to main with the value, but because
+            # ts_current is the last reference to us we
+            # return here immediately, where we resurrect ourself.
+            try:
+                greenlet.getcurrent().parent.switch(value)
+            finally:
+                seen.append(greenlet.getcurrent())
+        def initiator():
+            return 42 # implicitly falls thru to parent
+
+        worker = [RawGreenlet(worker)]
+
+        worker[0].switch() # prime worker
+        initiator = RawGreenlet(initiator, worker[0])
+        value = initiator.switch()
+        self.assertTrue(seen)
+        self.assertEqual(value, 42)
+
+    def test_tuple_subclass(self):
+        # The point of this test is to see what happens when a custom
+        # tuple subclass is used as an object passed directly to the C
+        # function ``green_switch``; part of ``green_switch`` checks
+        # the ``len()`` of the ``args`` tuple, and that can call back
+        # into Python. Here, when it calls back into Python, we
+        # recursively enter ``green_switch`` again.
+
+        # This test is really only relevant on Python 2. The builtin
+        # `apply` function directly passes the given args tuple object
+        # to the underlying function, whereas the Python 3 version
+        # unpacks and repacks into an actual tuple. This could still
+        # happen using the C API on Python 3 though. We should write a
+        # builtin version of apply() ourself.
+        def _apply(func, a, k):
+            func(*a, **k)
+
+        class mytuple(tuple):
+            def __len__(self):
+                greenlet.getcurrent().switch()
+                return tuple.__len__(self)
+        args = mytuple()
+        kwargs = dict(a=42)
+        def switchapply():
+            _apply(greenlet.getcurrent().parent.switch, args, kwargs)
+        g = RawGreenlet(switchapply)
+        self.assertEqual(g.switch(), kwargs)
+
+    def test_abstract_subclasses(self):
+        AbstractSubclass = ABCMeta(
+            'AbstractSubclass',
+            (RawGreenlet,),
+            {'run': abstractmethod(lambda self: None)})
+
+        class BadSubclass(AbstractSubclass):
+            pass
+
+        class GoodSubclass(AbstractSubclass):
+            def run(self):
+                pass
+
+        GoodSubclass() # should not raise
+        self.assertRaises(TypeError, BadSubclass)
+
+    def test_implicit_parent_with_threads(self):
+        if not gc.isenabled():
+            return # cannot test with disabled gc
+        N = gc.get_threshold()[0]
+        if N < 50:
+            return # cannot test with such a small N
+        def attempt():
+            lock1 = threading.Lock()
+            lock1.acquire()
+            lock2 = threading.Lock()
+            lock2.acquire()
+            recycled = [False]
+            def another_thread():
+                lock1.acquire() # wait for gc
+                greenlet.getcurrent() # update ts_current
+                lock2.release() # release gc
+            t = threading.Thread(target=another_thread)
+            t.start()
+            class gc_callback(object):
+                def __del__(self):
+                    lock1.release()
+                    lock2.acquire()
+                    recycled[0] = True
+            class garbage(object):
+                def __init__(self):
+                    self.cycle = self
+                    self.callback = gc_callback()
+            l = []
+            x = range(N*2)
+            current = greenlet.getcurrent()
+            g = garbage()
+            for _ in x:
+                g = None # lose reference to garbage
+                if recycled[0]:
+                    # gc callback called prematurely
+                    t.join(10)
+                    return False
+                last = RawGreenlet()
+                if recycled[0]:
+                    break # yes! gc called in green_new
+                l.append(last) # increase allocation counter
+            else:
+                # gc callback not called when expected
+                gc.collect()
+                if recycled[0]:
+                    t.join(10)
+                return False
+            self.assertEqual(last.parent, current)
+            for g in l:
+                self.assertEqual(g.parent, current)
+            return True
+        for _ in range(5):
+            if attempt():
+                break
+
+    def test_issue_245_reference_counting_subclass_no_threads(self):
+        # https://github.com/python-greenlet/greenlet/issues/245
+        # Before the fix, this crashed pretty reliably on
+        # Python 3.10, at least on macOS; but much less reliably on other
+        # interpreters (memory layout must have changed).
+        # The threaded test crashed more reliably on more interpreters.
+        from greenlet import getcurrent
+        from greenlet import GreenletExit
+
+        class Greenlet(RawGreenlet):
+            pass
+
+        initial_refs = sys.getrefcount(Greenlet)
+        # This has to be an instance variable because
+        # Python 2 raises a SyntaxError if we delete a local
+        # variable referenced in an inner scope.
+        self.glets = [] # pylint:disable=attribute-defined-outside-init
+
+        def greenlet_main():
+            try:
+                getcurrent().parent.switch()
+            except GreenletExit:
+                self.glets.append(getcurrent())
+
+        # Before the
+        for _ in range(10):
+            Greenlet(greenlet_main).switch()
+
+        del self.glets
+        self.assertEqual(sys.getrefcount(Greenlet), initial_refs)
+
+    def test_issue_245_reference_counting_subclass_threads(self):
+        # https://github.com/python-greenlet/greenlet/issues/245
+        from threading import Thread
+        from threading import Event
+
+        from greenlet import getcurrent
+
+        class MyGreenlet(RawGreenlet):
+            pass
+
+        glets = []
+        ref_cleared = Event()
+
+        def greenlet_main():
+            getcurrent().parent.switch()
+
+        def thread_main(greenlet_running_event):
+            mine = MyGreenlet(greenlet_main)
+            glets.append(mine)
+            # The greenlets being deleted must be active
+            mine.switch()
+            # Don't keep any reference to it in this thread
+            del mine
+            # Let main know we published our greenlet.
+            greenlet_running_event.set()
+            # Wait for main to let us know the references are
+            # gone and the greenlet objects no longer reachable
+            ref_cleared.wait(10)
+            # The creating thread must call getcurrent() (or a few other
+            # greenlet APIs) because that's when the thread-local list of dead
+            # greenlets gets cleared.
+            getcurrent()
+
+        # We start with 3 references to the subclass:
+        # - This module
+        # - Its __mro__
+        # - The __subclassess__ attribute of greenlet
+        # - (If we call gc.get_referents(), we find four entries, including
+        #   some other tuple ``(greenlet)`` that I'm not sure about but must be part
+        #   of the machinery.)
+        #
+        # On Python 3.10 it's often enough to just run 3 threads; on Python 2.7,
+        # more threads are needed, and the results are still
+        # non-deterministic. Presumably the memory layouts are different
+        initial_refs = sys.getrefcount(MyGreenlet)
+        thread_ready_events = []
+        for _ in range(
+                initial_refs + 45
+        ):
+            event = Event()
+            thread = Thread(target=thread_main, args=(event,))
+            thread_ready_events.append(event)
+            thread.start()
+
+
+        for done_event in thread_ready_events:
+            done_event.wait(10)
+
+
+        del glets[:]
+        ref_cleared.set()
+        # Let any other thread run; it will crash the interpreter
+        # if not fixed (or silently corrupt memory and we possibly crash
+        # later).
+        self.wait_for_pending_cleanups()
+        self.assertEqual(sys.getrefcount(MyGreenlet), initial_refs)
+
+    def test_falling_off_end_switches_to_unstarted_parent_raises_error(self):
+        def no_args():
+            return 13
+
+        parent_never_started = RawGreenlet(no_args)
+
+        def leaf():
+            return 42
+
+        child = RawGreenlet(leaf, parent_never_started)
+
+        # Because the run function takes to arguments
+        with self.assertRaises(TypeError):
+            child.switch()
+
+    def test_falling_off_end_switches_to_unstarted_parent_works(self):
+        def one_arg(x):
+            return (x, 24)
+
+        parent_never_started = RawGreenlet(one_arg)
+
+        def leaf():
+            return 42
+
+        child = RawGreenlet(leaf, parent_never_started)
+
+        result = child.switch()
+        self.assertEqual(result, (42, 24))
+
+    def test_switch_to_dead_greenlet_with_unstarted_perverse_parent(self):
+        class Parent(RawGreenlet):
+            def __getattribute__(self, name):
+                if name == 'run':
+                    raise SomeError
+
+
+        parent_never_started = Parent()
+        seen = []
+        child = RawGreenlet(lambda: seen.append(42), parent_never_started)
+        # Because we automatically start the parent when the child is
+        # finished
+        with self.assertRaises(SomeError):
+            child.switch()
+
+        self.assertEqual(seen, [42])
+
+        with self.assertRaises(SomeError):
+            child.switch()
+        self.assertEqual(seen, [42])
+
+    def test_switch_to_dead_greenlet_reparent(self):
+        seen = []
+        parent_never_started = RawGreenlet(lambda: seen.append(24))
+        child = RawGreenlet(lambda: seen.append(42))
+
+        child.switch()
+        self.assertEqual(seen, [42])
+
+        child.parent = parent_never_started
+        # This actually is the same as switching to the parent.
+        result = child.switch()
+        self.assertIsNone(result)
+        self.assertEqual(seen, [42, 24])
+
+    def test_can_access_f_back_of_suspended_greenlet(self):
+        # This tests our frame rewriting to work around Python 3.12+ having
+        # some interpreter frames on the C stack. It will crash in the absence
+        # of that logic.
+        main = greenlet.getcurrent()
+
+        def outer():
+            inner()
+
+        def inner():
+            main.switch(sys._getframe(0))
+
+        hub = RawGreenlet(outer)
+        # start it
+        hub.switch()
+
+        # start another greenlet to make sure we aren't relying on
+        # anything in `hub` still being on the C stack
+        unrelated = RawGreenlet(lambda: None)
+        unrelated.switch()
+
+        # now it is suspended
+        self.assertIsNotNone(hub.gr_frame)
+        self.assertEqual(hub.gr_frame.f_code.co_name, "inner")
+        self.assertIsNotNone(hub.gr_frame.f_back)
+        self.assertEqual(hub.gr_frame.f_back.f_code.co_name, "outer")
+        # The next line is what would crash
+        self.assertIsNone(hub.gr_frame.f_back.f_back)
+
+    def test_get_stack_with_nested_c_calls(self):
+        from functools import partial
+        from . import _test_extension_cpp
+
+        def recurse(v):
+            if v > 0:
+                return v * _test_extension_cpp.test_call(partial(recurse, v - 1))
+            return greenlet.getcurrent().parent.switch()
+
+        gr = RawGreenlet(recurse)
+        gr.switch(5)
+        frame = gr.gr_frame
+        for i in range(5):
+            self.assertEqual(frame.f_locals["v"], i)
+            frame = frame.f_back
+        self.assertEqual(frame.f_locals["v"], 5)
+        self.assertIsNone(frame.f_back)
+        self.assertEqual(gr.switch(10), 1200)  # 1200 = 5! * 10
+
+    def test_frames_always_exposed(self):
+        # On Python 3.12 this will crash if we don't set the
+        # gr_frames_always_exposed attribute. More background:
+        # https://github.com/python-greenlet/greenlet/issues/388
+        main = greenlet.getcurrent()
+
+        def outer():
+            inner(sys._getframe(0))
+
+        def inner(frame):
+            main.switch(frame)
+
+        gr = RawGreenlet(outer)
+        frame = gr.switch()
+
+        # Do something else to clobber the part of the C stack used by `gr`,
+        # so we can't skate by on "it just happened to still be there"
+        unrelated = RawGreenlet(lambda: None)
+        unrelated.switch()
+
+        self.assertEqual(frame.f_code.co_name, "outer")
+        # The next line crashes on 3.12 if we haven't exposed the frames.
+        self.assertIsNone(frame.f_back)
+
+
+class TestGreenletSetParentErrors(TestCase):
+    def test_threaded_reparent(self):
+        data = {}
+        created_event = threading.Event()
+        done_event = threading.Event()
+
+        def run():
+            data['g'] = RawGreenlet(lambda: None)
+            created_event.set()
+            done_event.wait(10)
+
+        def blank():
+            greenlet.getcurrent().parent.switch()
+
+        thread = threading.Thread(target=run)
+        thread.start()
+        created_event.wait(10)
+        g = RawGreenlet(blank)
+        g.switch()
+        with self.assertRaises(ValueError) as exc:
+            g.parent = data['g']
+        done_event.set()
+        thread.join(10)
+
+        self.assertEqual(str(exc.exception), "parent cannot be on a different thread")
+
+    def test_unexpected_reparenting(self):
+        another = []
+        def worker():
+            g = RawGreenlet(lambda: None)
+            another.append(g)
+            g.switch()
+        t = threading.Thread(target=worker)
+        t.start()
+        t.join(10)
+        # The first time we switch (running g_initialstub(), which is
+        # when we look up the run attribute) we attempt to change the
+        # parent to one from another thread (which also happens to be
+        # dead). ``g_initialstub()`` should detect this and raise a
+        # greenlet error.
+        #
+        # EXCEPT: With the fix for #252, this is actually detected
+        # sooner, when setting the parent itself. Prior to that fix,
+        # the main greenlet from the background thread kept a valid
+        # value for ``run_info``, and appeared to be a valid parent
+        # until we actually started the greenlet. But now that it's
+        # cleared, this test is catching whether ``green_setparent``
+        # can detect the dead thread.
+        #
+        # Further refactoring once again changes this back to a greenlet.error
+        #
+        # We need to wait for the cleanup to happen, but we're
+        # deliberately leaking a main greenlet here.
+        self.wait_for_pending_cleanups(initial_main_greenlets=self.main_greenlets_before_test + 1)
+
+        class convoluted(RawGreenlet):
+            def __getattribute__(self, name):
+                if name == 'run':
+                    self.parent = another[0] # pylint:disable=attribute-defined-outside-init
+                return RawGreenlet.__getattribute__(self, name)
+        g = convoluted(lambda: None)
+        with self.assertRaises(greenlet.error) as exc:
+            g.switch()
+        self.assertEqual(str(exc.exception),
+                         "cannot switch to a different thread (which happens to have exited)")
+        del another[:]
+
+    def test_unexpected_reparenting_thread_running(self):
+        # Like ``test_unexpected_reparenting``, except the background thread is
+        # actually still alive.
+        another = []
+        switched_to_greenlet = threading.Event()
+        keep_main_alive = threading.Event()
+        def worker():
+            g = RawGreenlet(lambda: None)
+            another.append(g)
+            g.switch()
+            switched_to_greenlet.set()
+            keep_main_alive.wait(10)
+        class convoluted(RawGreenlet):
+            def __getattribute__(self, name):
+                if name == 'run':
+                    self.parent = another[0] # pylint:disable=attribute-defined-outside-init
+                return RawGreenlet.__getattribute__(self, name)
+
+        t = threading.Thread(target=worker)
+        t.start()
+
+        switched_to_greenlet.wait(10)
+        try:
+            g = convoluted(lambda: None)
+
+            with self.assertRaises(greenlet.error) as exc:
+                g.switch()
+            self.assertEqual(str(exc.exception), "cannot switch to a different thread")
+        finally:
+            keep_main_alive.set()
+            t.join(10)
+            # XXX: Should handle this automatically.
+            del another[:]
+
+    def test_cannot_delete_parent(self):
+        worker = RawGreenlet(lambda: None)
+        self.assertIs(worker.parent, greenlet.getcurrent())
+
+        with self.assertRaises(AttributeError) as exc:
+            del worker.parent
+        self.assertEqual(str(exc.exception), "can't delete attribute")
+
+    def test_cannot_delete_parent_of_main(self):
+        with self.assertRaises(AttributeError) as exc:
+            del greenlet.getcurrent().parent
+        self.assertEqual(str(exc.exception), "can't delete attribute")
+
+
+    def test_main_greenlet_parent_is_none(self):
+        # assuming we're in a main greenlet here.
+        self.assertIsNone(greenlet.getcurrent().parent)
+
+    def test_set_parent_wrong_types(self):
+        def bg():
+            # Go back to main.
+            greenlet.getcurrent().parent.switch()
+
+        def check(glet):
+            for p in None, 1, self, "42":
+                with self.assertRaises(TypeError) as exc:
+                    glet.parent = p
+
+                self.assertEqual(
+                    str(exc.exception),
+                    "GreenletChecker: Expected any type of greenlet, not " + type(p).__name__)
+
+        # First, not running
+        g = RawGreenlet(bg)
+        self.assertFalse(g)
+        check(g)
+
+        # Then when running.
+        g.switch()
+        self.assertTrue(g)
+        check(g)
+
+        # Let it finish
+        g.switch()
+
+
+    def test_trivial_cycle(self):
+        glet = RawGreenlet(lambda: None)
+        with self.assertRaises(ValueError) as exc:
+            glet.parent = glet
+        self.assertEqual(str(exc.exception), "cyclic parent chain")
+
+    def test_trivial_cycle_main(self):
+        # This used to produce a ValueError, but we catch it earlier than that now.
+        with self.assertRaises(AttributeError) as exc:
+            greenlet.getcurrent().parent = greenlet.getcurrent()
+        self.assertEqual(str(exc.exception), "cannot set the parent of a main greenlet")
+
+    def test_deeper_cycle(self):
+        g1 = RawGreenlet(lambda: None)
+        g2 = RawGreenlet(lambda: None)
+        g3 = RawGreenlet(lambda: None)
+
+        g1.parent = g2
+        g2.parent = g3
+        with self.assertRaises(ValueError) as exc:
+            g3.parent = g1
+        self.assertEqual(str(exc.exception), "cyclic parent chain")
+
+
+class TestRepr(TestCase):
+
+    def assertEndsWith(self, got, suffix):
+        self.assertTrue(got.endswith(suffix), (got, suffix))
+
+    def test_main_while_running(self):
+        r = repr(greenlet.getcurrent())
+        self.assertEndsWith(r, " current active started main>")
+
+    def test_main_in_background(self):
+        main = greenlet.getcurrent()
+        def run():
+            return repr(main)
+
+        g = RawGreenlet(run)
+        r = g.switch()
+        self.assertEndsWith(r, ' suspended active started main>')
+
+    def test_initial(self):
+        r = repr(RawGreenlet())
+        self.assertEndsWith(r, ' pending>')
+
+    def test_main_from_other_thread(self):
+        main = greenlet.getcurrent()
+
+        class T(threading.Thread):
+            original_main = thread_main = None
+            main_glet = None
+            def run(self):
+                self.original_main = repr(main)
+                self.main_glet = greenlet.getcurrent()
+                self.thread_main = repr(self.main_glet)
+
+        t = T()
+        t.start()
+        t.join(10)
+
+        self.assertEndsWith(t.original_main, ' suspended active started main>')
+        self.assertEndsWith(t.thread_main, ' current active started main>')
+        # give the machinery time to notice the death of the thread,
+        # and clean it up. Note that we don't use
+        # ``expect_greenlet_leak`` or wait_for_pending_cleanups,
+        # because at this point we know we have an extra greenlet
+        # still reachable.
+        for _ in range(3):
+            time.sleep(0.001)
+
+        # In the past, main greenlets, even from dead threads, never
+        # really appear dead. We have fixed that, and we also report
+        # that the thread is dead in the repr. (Do this multiple times
+        # to make sure that we don't self-modify and forget our state
+        # in the C++ code).
+        for _ in range(3):
+            self.assertTrue(t.main_glet.dead)
+            r = repr(t.main_glet)
+            self.assertEndsWith(r, ' (thread exited) dead>')
+
+    def test_dead(self):
+        g = RawGreenlet(lambda: None)
+        g.switch()
+        self.assertEndsWith(repr(g), ' dead>')
+        self.assertNotIn('suspended', repr(g))
+        self.assertNotIn('started', repr(g))
+        self.assertNotIn('active', repr(g))
+
+    def test_formatting_produces_native_str(self):
+        # https://github.com/python-greenlet/greenlet/issues/218
+        # %s formatting on Python 2 was producing unicode, not str.
+
+        g_dead = RawGreenlet(lambda: None)
+        g_not_started = RawGreenlet(lambda: None)
+        g_cur = greenlet.getcurrent()
+
+        for g in g_dead, g_not_started, g_cur:
+
+            self.assertIsInstance(
+                '%s' % (g,),
+                str
+            )
+            self.assertIsInstance(
+                '%r' % (g,),
+                str,
+            )
+
+
+class TestMainGreenlet(TestCase):
+    # Tests some implementation details, and relies on some
+    # implementation details.
+
+    def _check_current_is_main(self):
+        # implementation detail
+        assert 'main' in repr(greenlet.getcurrent())
+
+        t = type(greenlet.getcurrent())
+        assert 'main' not in repr(t)
+        return t
+
+    def test_main_greenlet_type_can_be_subclassed(self):
+        main_type = self._check_current_is_main()
+        subclass = type('subclass', (main_type,), {})
+        self.assertIsNotNone(subclass)
+
+    def test_main_greenlet_is_greenlet(self):
+        self._check_current_is_main()
+        self.assertIsInstance(greenlet.getcurrent(), RawGreenlet)
+
+
+
+class TestBrokenGreenlets(TestCase):
+    # Tests for things that used to, or still do, terminate the interpreter.
+    # This often means doing unsavory things.
+
+    def test_failed_to_initialstub(self):
+        def func():
+            raise AssertionError("Never get here")
+
+
+        g = greenlet._greenlet.UnswitchableGreenlet(func)
+        g.force_switch_error = True
+
+        with self.assertRaisesRegex(SystemError,
+                                    "Failed to switch stacks into a greenlet for the first time."):
+            g.switch()
+
+    def test_failed_to_switch_into_running(self):
+        runs = []
+        def func():
+            runs.append(1)
+            greenlet.getcurrent().parent.switch()
+            runs.append(2)
+            greenlet.getcurrent().parent.switch()
+            runs.append(3) # pragma: no cover
+
+        g = greenlet._greenlet.UnswitchableGreenlet(func)
+        g.switch()
+        self.assertEqual(runs, [1])
+        g.switch()
+        self.assertEqual(runs, [1, 2])
+        g.force_switch_error = True
+
+        with self.assertRaisesRegex(SystemError,
+                                    "Failed to switch stacks into a running greenlet."):
+            g.switch()
+
+        # If we stopped here, we would fail the leakcheck, because we've left
+        # the ``inner_bootstrap()`` C frame and its descendents hanging around,
+        # which have a bunch of Python references. They'll never get cleaned up
+        # if we don't let the greenlet finish.
+        g.force_switch_error = False
+        g.switch()
+        self.assertEqual(runs, [1, 2, 3])
+
+    def test_failed_to_slp_switch_into_running(self):
+        ex = self.assertScriptRaises('fail_slp_switch.py')
+
+        self.assertIn('fail_slp_switch is running', ex.output)
+        self.assertIn(ex.returncode, self.get_expected_returncodes_for_aborted_process())
+
+    def test_reentrant_switch_two_greenlets(self):
+        # Before we started capturing the arguments in g_switch_finish, this could crash.
+        output = self.run_script('fail_switch_two_greenlets.py')
+        self.assertIn('In g1_run', output)
+        self.assertIn('TRACE', output)
+        self.assertIn('LEAVE TRACE', output)
+        self.assertIn('Falling off end of main', output)
+        self.assertIn('Falling off end of g1_run', output)
+        self.assertIn('Falling off end of g2', output)
+
+    def test_reentrant_switch_three_greenlets(self):
+        # On debug builds of greenlet, this used to crash with an assertion error;
+        # on non-debug versions, it ran fine (which it should not do!).
+        # Now it always crashes correctly with a TypeError
+        ex = self.assertScriptRaises('fail_switch_three_greenlets.py', exitcodes=(1,))
+
+        self.assertIn('TypeError', ex.output)
+        self.assertIn('positional arguments', ex.output)
+
+    def test_reentrant_switch_three_greenlets2(self):
+        # This actually passed on debug and non-debug builds. It
+        # should probably have been triggering some debug assertions
+        # but it didn't.
+        #
+        # I think the fixes for the above test also kicked in here.
+        output = self.run_script('fail_switch_three_greenlets2.py')
+        self.assertIn(
+            "RESULTS: [('trace', 'switch'), "
+            "('trace', 'switch'), ('g2 arg', 'g2 from tracefunc'), "
+            "('trace', 'switch'), ('main g1', 'from g2_run'), ('trace', 'switch'), "
+            "('g1 arg', 'g1 from main'), ('trace', 'switch'), ('main g2', 'from g1_run'), "
+            "('trace', 'switch'), ('g1 from parent', 'g1 from main 2'), ('trace', 'switch'), "
+            "('main g1.2', 'g1 done'), ('trace', 'switch'), ('g2 from parent', ()), "
+            "('trace', 'switch'), ('main g2.2', 'g2 done')]",
+            output
+        )
+
+    def test_reentrant_switch_GreenletAlreadyStartedInPython(self):
+        output = self.run_script('fail_initialstub_already_started.py')
+
+        self.assertIn(
+            "RESULTS: ['Begin C', 'Switch to b from B.__getattribute__ in C', "
+            "('Begin B', ()), '_B_run switching to main', ('main from c', 'From B'), "
+            "'B.__getattribute__ back from main in C', ('Begin A', (None,)), "
+            "('A dead?', True, 'B dead?', True, 'C dead?', False), "
+            "'C done', ('main from c.2', None)]",
+            output
+        )
+
+    def test_reentrant_switch_run_callable_has_del(self):
+        output = self.run_script('fail_clearing_run_switches.py')
+        self.assertIn(
+             "RESULTS ["
+            "('G.__getattribute__', 'run'), ('RunCallable', '__del__'), "
+            "('main: g.switch()', 'from RunCallable'), ('run_func', 'enter')"
+            "]",
+            output
+        )
+
+if __name__ == '__main__':
+    import unittest
+    unittest.main()
diff --git a/llm/Lib/site-packages/greenlet/tests/test_greenlet_trash.py b/llm/Lib/site-packages/greenlet/tests/test_greenlet_trash.py
new file mode 100644
index 0000000000000000000000000000000000000000..8d9716e93410575e9aa07bbf23eea42b6a8fbbd5
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_greenlet_trash.py
@@ -0,0 +1,178 @@
+# -*- coding: utf-8 -*-
+"""
+Tests for greenlets interacting with the CPython trash can API.
+
+The CPython trash can API is not designed to be re-entered from a
+single thread. But this can happen using greenlets, if something
+during the object deallocation process switches greenlets, and this second
+greenlet then causes the trash can to get entered again. Here, we do this
+very explicitly, but in other cases (like gevent) it could be arbitrarily more
+complicated: for example, a weakref callback might try to acquire a lock that's
+already held by another greenlet; that would allow a greenlet switch to occur.
+
+See https://github.com/gevent/gevent/issues/1909
+
+This test is fragile and relies on details of the CPython
+implementation (like most of the rest of this package):
+
+    - We enter the trashcan and deferred deallocation after
+      ``_PyTrash_UNWIND_LEVEL`` calls. This constant, defined in
+      CPython's object.c, is generally 50. That's basically how many objects are required to
+      get us into the deferred deallocation situation.
+
+    - The test fails by hitting an ``assert()`` in object.c; if the
+      build didn't enable assert, then we don't catch this.
+
+    - If the test fails in that way, the interpreter crashes.
+"""
+from __future__ import print_function, absolute_import, division
+
+import unittest
+
+class TestTrashCanReEnter(unittest.TestCase):
+
+    def test_it(self):
+        # Try several times to trigger it, because it isn't 100%
+        # reliable.
+        for _ in range(10):
+            self.check_it()
+
+    def check_it(self): # pylint:disable=too-many-statements
+        import greenlet
+        from greenlet._greenlet import get_tstate_trash_delete_nesting # pylint:disable=no-name-in-module
+
+        main = greenlet.getcurrent()
+
+        assert get_tstate_trash_delete_nesting() == 0
+
+        # We expect to be in deferred deallocation after this many
+        # deallocations have occurred. TODO: I wish we had a better way to do
+        # this --- that was before get_tstate_trash_delete_nesting; perhaps
+        # we can use that API to do better?
+        TRASH_UNWIND_LEVEL = 50
+        # How many objects to put in a container; it's the container that
+        # queues objects for deferred deallocation.
+        OBJECTS_PER_CONTAINER = 500
+
+        class Dealloc: # define the class here because we alter class variables each time we run.
+            """
+            An object with a ``__del__`` method. When it starts getting deallocated
+            from a deferred trash can run, it switches greenlets, allocates more objects
+            which then also go in the trash can. If we don't save state appropriately,
+            nesting gets out of order and we can crash the interpreter.
+            """
+
+            #: Has our deallocation actually run and switched greenlets?
+            #: When it does, this will be set to the current greenlet. This should
+            #: be happening in the main greenlet, so we check that down below.
+            SPAWNED = False
+
+            #: Has the background greenlet run?
+            BG_RAN = False
+
+            BG_GLET = None
+
+            #: How many of these things have ever been allocated.
+            CREATED = 0
+
+            #: How many of these things have ever been deallocated.
+            DESTROYED = 0
+
+            #: How many were destroyed not in the main greenlet. There should always
+            #: be some.
+            #: If the test is broken or things change in the trashcan implementation,
+            #: this may not be correct.
+            DESTROYED_BG = 0
+
+            def __init__(self, sequence_number):
+                """
+                :param sequence_number: The ordinal of this object during
+                   one particular creation run. This is used to detect (guess, really)
+                   when we have entered the trash can's deferred deallocation.
+                """
+                self.i = sequence_number
+                Dealloc.CREATED += 1
+
+            def __del__(self):
+                if self.i == TRASH_UNWIND_LEVEL and not self.SPAWNED:
+                    Dealloc.SPAWNED = greenlet.getcurrent()
+                    other = Dealloc.BG_GLET = greenlet.greenlet(background_greenlet)
+                    x = other.switch()
+                    assert x == 42
+                    # It's important that we don't switch back to the greenlet,
+                    # we leave it hanging there in an incomplete state. But we don't let it
+                    # get collected, either. If we complete it now, while we're still
+                    # in the scope of the initial trash can, things work out and we
+                    # don't see the problem. We need this greenlet to complete
+                    # at some point in the future, after we've exited this trash can invocation.
+                    del other
+                elif self.i == 40 and greenlet.getcurrent() is not main:
+                    Dealloc.BG_RAN = True
+                    try:
+                        main.switch(42)
+                    except greenlet.GreenletExit as ex:
+                        # We expect this; all references to us go away
+                        # while we're still running, and we need to finish deleting
+                        # ourself.
+                        Dealloc.BG_RAN = type(ex)
+                        del ex
+
+                # Record the fact that we're dead last of all. This ensures that
+                # we actually get returned too.
+                Dealloc.DESTROYED += 1
+                if greenlet.getcurrent() is not main:
+                    Dealloc.DESTROYED_BG += 1
+
+
+        def background_greenlet():
+            # We direct through a second function, instead of
+            # directly calling ``make_some()``, so that we have complete
+            # control over when these objects are destroyed: we need them
+            # to be destroyed in the context of the background greenlet
+            t = make_some()
+            del t # Triggere deletion.
+
+        def make_some():
+            t = ()
+            i = OBJECTS_PER_CONTAINER
+            while i:
+                # Nest the tuples; it's the recursion that gets us
+                # into trash.
+                t = (Dealloc(i), t)
+                i -= 1
+            return t
+
+
+        some = make_some()
+        self.assertEqual(Dealloc.CREATED, OBJECTS_PER_CONTAINER)
+        self.assertEqual(Dealloc.DESTROYED, 0)
+
+        # If we're going to crash, it should be on the following line.
+        # We only crash if ``assert()`` is enabled, of course.
+        del some
+
+        # For non-debug builds of CPython, we won't crash. The best we can do is check
+        # the nesting level explicitly.
+        self.assertEqual(0, get_tstate_trash_delete_nesting())
+
+        # Discard this, raising GreenletExit into where it is waiting.
+        Dealloc.BG_GLET = None
+        # The same nesting level maintains.
+        self.assertEqual(0, get_tstate_trash_delete_nesting())
+
+        # We definitely cleaned some up in the background
+        self.assertGreater(Dealloc.DESTROYED_BG, 0)
+
+        # Make sure all the cleanups happened.
+        self.assertIs(Dealloc.SPAWNED, main)
+        self.assertTrue(Dealloc.BG_RAN)
+        self.assertEqual(Dealloc.BG_RAN, greenlet.GreenletExit)
+        self.assertEqual(Dealloc.CREATED, Dealloc.DESTROYED )
+        self.assertEqual(Dealloc.CREATED, OBJECTS_PER_CONTAINER * 2)
+
+        import gc
+        gc.collect()
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/llm/Lib/site-packages/greenlet/tests/test_leaks.py b/llm/Lib/site-packages/greenlet/tests/test_leaks.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed1fa717583468aa5f7df2a4f7f93637ebe0131c
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_leaks.py
@@ -0,0 +1,443 @@
+# -*- coding: utf-8 -*-
+"""
+Testing scenarios that may have leaked.
+"""
+from __future__ import print_function, absolute_import, division
+
+import sys
+import gc
+
+import time
+import weakref
+import threading
+
+
+import greenlet
+from . import TestCase
+from .leakcheck import fails_leakcheck
+from .leakcheck import ignores_leakcheck
+from .leakcheck import RUNNING_ON_MANYLINUX
+
+# pylint:disable=protected-access
+
+assert greenlet.GREENLET_USE_GC # Option to disable this was removed in 1.0
+
+class HasFinalizerTracksInstances(object):
+    EXTANT_INSTANCES = set()
+    def __init__(self, msg):
+        self.msg = sys.intern(msg)
+        self.EXTANT_INSTANCES.add(id(self))
+    def __del__(self):
+        self.EXTANT_INSTANCES.remove(id(self))
+    def __repr__(self):
+        return "<HasFinalizerTracksInstances at 0x%x %r>" % (
+            id(self), self.msg
+        )
+    @classmethod
+    def reset(cls):
+        cls.EXTANT_INSTANCES.clear()
+
+
+class TestLeaks(TestCase):
+
+    def test_arg_refs(self):
+        args = ('a', 'b', 'c')
+        refcount_before = sys.getrefcount(args)
+        # pylint:disable=unnecessary-lambda
+        g = greenlet.greenlet(
+            lambda *args: greenlet.getcurrent().parent.switch(*args))
+        for _ in range(100):
+            g.switch(*args)
+        self.assertEqual(sys.getrefcount(args), refcount_before)
+
+    def test_kwarg_refs(self):
+        kwargs = {}
+        # pylint:disable=unnecessary-lambda
+        g = greenlet.greenlet(
+            lambda **kwargs: greenlet.getcurrent().parent.switch(**kwargs))
+        for _ in range(100):
+            g.switch(**kwargs)
+        self.assertEqual(sys.getrefcount(kwargs), 2)
+
+
+    @staticmethod
+    def __recycle_threads():
+        # By introducing a thread that does sleep we allow other threads,
+        # that have triggered their __block condition, but did not have a
+        # chance to deallocate their thread state yet, to finally do so.
+        # The way it works is by requiring a GIL switch (different thread),
+        # which does a GIL release (sleep), which might do a GIL switch
+        # to finished threads and allow them to clean up.
+        def worker():
+            time.sleep(0.001)
+        t = threading.Thread(target=worker)
+        t.start()
+        time.sleep(0.001)
+        t.join(10)
+
+    def test_threaded_leak(self):
+        gg = []
+        def worker():
+            # only main greenlet present
+            gg.append(weakref.ref(greenlet.getcurrent()))
+        for _ in range(2):
+            t = threading.Thread(target=worker)
+            t.start()
+            t.join(10)
+            del t
+        greenlet.getcurrent() # update ts_current
+        self.__recycle_threads()
+        greenlet.getcurrent() # update ts_current
+        gc.collect()
+        greenlet.getcurrent() # update ts_current
+        for g in gg:
+            self.assertIsNone(g())
+
+    def test_threaded_adv_leak(self):
+        gg = []
+        def worker():
+            # main and additional *finished* greenlets
+            ll = greenlet.getcurrent().ll = []
+            def additional():
+                ll.append(greenlet.getcurrent())
+            for _ in range(2):
+                greenlet.greenlet(additional).switch()
+            gg.append(weakref.ref(greenlet.getcurrent()))
+        for _ in range(2):
+            t = threading.Thread(target=worker)
+            t.start()
+            t.join(10)
+            del t
+        greenlet.getcurrent() # update ts_current
+        self.__recycle_threads()
+        greenlet.getcurrent() # update ts_current
+        gc.collect()
+        greenlet.getcurrent() # update ts_current
+        for g in gg:
+            self.assertIsNone(g())
+
+    def assertClocksUsed(self):
+        used = greenlet._greenlet.get_clocks_used_doing_optional_cleanup()
+        self.assertGreaterEqual(used, 0)
+        # we don't lose the value
+        greenlet._greenlet.enable_optional_cleanup(True)
+        used2 = greenlet._greenlet.get_clocks_used_doing_optional_cleanup()
+        self.assertEqual(used, used2)
+        self.assertGreater(greenlet._greenlet.CLOCKS_PER_SEC, 1)
+
+    def _check_issue251(self,
+                        manually_collect_background=True,
+                        explicit_reference_to_switch=False):
+        # See https://github.com/python-greenlet/greenlet/issues/251
+        # Killing a greenlet (probably not the main one)
+        # in one thread from another thread would
+        # result in leaking a list (the ts_delkey list).
+        # We no longer use lists to hold that stuff, though.
+
+        # For the test to be valid, even empty lists have to be tracked by the
+        # GC
+
+        assert gc.is_tracked([])
+        HasFinalizerTracksInstances.reset()
+        greenlet.getcurrent()
+        greenlets_before = self.count_objects(greenlet.greenlet, exact_kind=False)
+
+        background_glet_running = threading.Event()
+        background_glet_killed = threading.Event()
+        background_greenlets = []
+
+        # XXX: Switching this to a greenlet subclass that overrides
+        # run results in all callers failing the leaktest; that
+        # greenlet instance is leaked. There's a bound method for
+        # run() living on the stack of the greenlet in g_initialstub,
+        # and since we don't manually switch back to the background
+        # greenlet to let it "fall off the end" and exit the
+        # g_initialstub function, it never gets cleaned up. Making the
+        # garbage collector aware of this bound method (making it an
+        # attribute of the greenlet structure and traversing into it)
+        # doesn't help, for some reason.
+        def background_greenlet():
+            # Throw control back to the main greenlet.
+            jd = HasFinalizerTracksInstances("DELETING STACK OBJECT")
+            greenlet._greenlet.set_thread_local(
+                'test_leaks_key',
+                HasFinalizerTracksInstances("DELETING THREAD STATE"))
+            # Explicitly keeping 'switch' in a local variable
+            # breaks this test in all versions
+            if explicit_reference_to_switch:
+                s = greenlet.getcurrent().parent.switch
+                s([jd])
+            else:
+                greenlet.getcurrent().parent.switch([jd])
+
+        bg_main_wrefs = []
+
+        def background_thread():
+            glet = greenlet.greenlet(background_greenlet)
+            bg_main_wrefs.append(weakref.ref(glet.parent))
+
+            background_greenlets.append(glet)
+            glet.switch() # Be sure it's active.
+            # Control is ours again.
+            del glet # Delete one reference from the thread it runs in.
+            background_glet_running.set()
+            background_glet_killed.wait(10)
+
+            # To trigger the background collection of the dead
+            # greenlet, thus clearing out the contents of the list, we
+            # need to run some APIs. See issue 252.
+            if manually_collect_background:
+                greenlet.getcurrent()
+
+
+        t = threading.Thread(target=background_thread)
+        t.start()
+        background_glet_running.wait(10)
+        greenlet.getcurrent()
+        lists_before = self.count_objects(list, exact_kind=True)
+
+        assert len(background_greenlets) == 1
+        self.assertFalse(background_greenlets[0].dead)
+        # Delete the last reference to the background greenlet
+        # from a different thread. This puts it in the background thread's
+        # ts_delkey list.
+        del background_greenlets[:]
+        background_glet_killed.set()
+
+        # Now wait for the background thread to die.
+        t.join(10)
+        del t
+        # As part of the fix for 252, we need to cycle the ceval.c
+        # interpreter loop to be sure it has had a chance to process
+        # the pending call.
+        self.wait_for_pending_cleanups()
+
+        lists_after = self.count_objects(list, exact_kind=True)
+        greenlets_after = self.count_objects(greenlet.greenlet, exact_kind=False)
+
+        # On 2.7, we observe that lists_after is smaller than
+        # lists_before. No idea what lists got cleaned up. All the
+        # Python 3 versions match exactly.
+        self.assertLessEqual(lists_after, lists_before)
+        # On versions after 3.6, we've successfully cleaned up the
+        # greenlet references thanks to the internal "vectorcall"
+        # protocol; prior to that, there is a reference path through
+        # the ``greenlet.switch`` method still on the stack that we
+        # can't reach to clean up. The C code goes through terrific
+        # lengths to clean that up.
+        if not explicit_reference_to_switch \
+           and greenlet._greenlet.get_clocks_used_doing_optional_cleanup() is not None:
+            # If cleanup was disabled, though, we may not find it.
+            self.assertEqual(greenlets_after, greenlets_before)
+            if manually_collect_background:
+                # TODO: Figure out how to make this work!
+                # The one on the stack is still leaking somehow
+                # in the non-manually-collect state.
+                self.assertEqual(HasFinalizerTracksInstances.EXTANT_INSTANCES, set())
+        else:
+            # The explicit reference prevents us from collecting it
+            # and it isn't always found by the GC either for some
+            # reason. The entire frame is leaked somehow, on some
+            # platforms (e.g., MacPorts builds of Python (all
+            # versions!)), but not on other platforms (the linux and
+            # windows builds on GitHub actions and Appveyor). So we'd
+            # like to write a test that proves that the main greenlet
+            # sticks around, and we can on my machine (macOS 11.6,
+            # MacPorts builds of everything) but we can't write that
+            # same test on other platforms. However, hopefully iteration
+            # done by leakcheck will find it.
+            pass
+
+        if greenlet._greenlet.get_clocks_used_doing_optional_cleanup() is not None:
+            self.assertClocksUsed()
+
+    def test_issue251_killing_cross_thread_leaks_list(self):
+        self._check_issue251()
+
+    def test_issue251_with_cleanup_disabled(self):
+        greenlet._greenlet.enable_optional_cleanup(False)
+        try:
+            self._check_issue251()
+        finally:
+            greenlet._greenlet.enable_optional_cleanup(True)
+
+    @fails_leakcheck
+    def test_issue251_issue252_need_to_collect_in_background(self):
+        # Between greenlet 1.1.2 and the next version, this was still
+        # failing because the leak of the list still exists when we
+        # don't call a greenlet API before exiting the thread. The
+        # proximate cause is that neither of the two greenlets from
+        # the background thread are actually being destroyed, even
+        # though the GC is in fact visiting both objects. It's not
+        # clear where that leak is? For some reason the thread-local
+        # dict holding it isn't being cleaned up.
+        #
+        # The leak, I think, is in the CPYthon internal function that
+        # calls into green_switch(). The argument tuple is still on
+        # the C stack somewhere and can't be reached? That doesn't
+        # make sense, because the tuple should be collectable when
+        # this object goes away.
+        #
+        # Note that this test sometimes spuriously passes on Linux,
+        # for some reason, but I've never seen it pass on macOS.
+        self._check_issue251(manually_collect_background=False)
+
+    @fails_leakcheck
+    def test_issue251_issue252_need_to_collect_in_background_cleanup_disabled(self):
+        self.expect_greenlet_leak = True
+        greenlet._greenlet.enable_optional_cleanup(False)
+        try:
+            self._check_issue251(manually_collect_background=False)
+        finally:
+            greenlet._greenlet.enable_optional_cleanup(True)
+
+    @fails_leakcheck
+    def test_issue251_issue252_explicit_reference_not_collectable(self):
+        self._check_issue251(
+            manually_collect_background=False,
+            explicit_reference_to_switch=True)
+
+    UNTRACK_ATTEMPTS = 100
+
+    def _only_test_some_versions(self):
+        # We're only looking for this problem specifically on 3.11,
+        # and this set of tests is relatively fragile, depending on
+        # OS and memory management details. So we want to run it on 3.11+
+        # (obviously) but not every older 3.x version in order to reduce
+        # false negatives. At the moment, those false results seem to have
+        # resolved, so we are actually running this on 3.8+
+        assert sys.version_info[0] >= 3
+        if sys.version_info[:2] < (3, 8):
+            self.skipTest('Only observed on 3.11')
+        if RUNNING_ON_MANYLINUX:
+            self.skipTest("Slow and not worth repeating here")
+
+    @ignores_leakcheck
+    # Because we're just trying to track raw memory, not objects, and running
+    # the leakcheck makes an already slow test slower.
+    def test_untracked_memory_doesnt_increase(self):
+        # See https://github.com/gevent/gevent/issues/1924
+        # and https://github.com/python-greenlet/greenlet/issues/328
+        self._only_test_some_versions()
+        def f():
+            return 1
+
+        ITER = 10000
+        def run_it():
+            for _ in range(ITER):
+                greenlet.greenlet(f).switch()
+
+        # Establish baseline
+        for _ in range(3):
+            run_it()
+
+        # uss: (Linux, macOS, Windows): aka "Unique Set Size", this is
+        # the memory which is unique to a process and which would be
+        # freed if the process was terminated right now.
+        uss_before = self.get_process_uss()
+
+        for count in range(self.UNTRACK_ATTEMPTS):
+            uss_before = max(uss_before, self.get_process_uss())
+            run_it()
+
+            uss_after = self.get_process_uss()
+            if uss_after <= uss_before and count > 1:
+                break
+
+        self.assertLessEqual(uss_after, uss_before)
+
+    def _check_untracked_memory_thread(self, deallocate_in_thread=True):
+        self._only_test_some_versions()
+        # Like the above test, but what if there are a bunch of
+        # unfinished greenlets in a thread that dies?
+        # Does it matter if we deallocate in the thread or not?
+        EXIT_COUNT = [0]
+
+        def f():
+            try:
+                greenlet.getcurrent().parent.switch()
+            except greenlet.GreenletExit:
+                EXIT_COUNT[0] += 1
+                raise
+            return 1
+
+        ITER = 10000
+        def run_it():
+            glets = []
+            for _ in range(ITER):
+                # Greenlet starts, switches back to us.
+                # We keep a strong reference to the greenlet though so it doesn't
+                # get a GreenletExit exception.
+                g = greenlet.greenlet(f)
+                glets.append(g)
+                g.switch()
+
+            return glets
+
+        test = self
+
+        class ThreadFunc:
+            uss_before = uss_after = 0
+            glets = ()
+            ITER = 2
+            def __call__(self):
+                self.uss_before = test.get_process_uss()
+
+                for _ in range(self.ITER):
+                    self.glets += tuple(run_it())
+
+                for g in self.glets:
+                    test.assertIn('suspended active', str(g))
+                # Drop them.
+                if deallocate_in_thread:
+                    self.glets = ()
+                self.uss_after = test.get_process_uss()
+
+        # Establish baseline
+        uss_before = uss_after = None
+        for count in range(self.UNTRACK_ATTEMPTS):
+            EXIT_COUNT[0] = 0
+            thread_func = ThreadFunc()
+            t = threading.Thread(target=thread_func)
+            t.start()
+            t.join(30)
+            self.assertFalse(t.is_alive())
+
+            if uss_before is None:
+                uss_before = thread_func.uss_before
+
+            uss_before = max(uss_before, thread_func.uss_before)
+            if deallocate_in_thread:
+                self.assertEqual(thread_func.glets, ())
+                self.assertEqual(EXIT_COUNT[0], ITER * thread_func.ITER)
+
+            del thread_func # Deallocate the greenlets; but this won't raise into them
+            del t
+            if not deallocate_in_thread:
+                self.assertEqual(EXIT_COUNT[0], 0)
+            if deallocate_in_thread:
+                self.wait_for_pending_cleanups()
+
+            uss_after = self.get_process_uss()
+            # See if we achieve a non-growth state at some point. Break when we do.
+            if uss_after <= uss_before and count > 1:
+                break
+
+        self.wait_for_pending_cleanups()
+        uss_after = self.get_process_uss()
+        self.assertLessEqual(uss_after, uss_before, "after attempts %d" % (count,))
+
+    @ignores_leakcheck
+    # Because we're just trying to track raw memory, not objects, and running
+    # the leakcheck makes an already slow test slower.
+    def test_untracked_memory_doesnt_increase_unfinished_thread_dealloc_in_thread(self):
+        self._check_untracked_memory_thread(deallocate_in_thread=True)
+
+    @ignores_leakcheck
+    # Because the main greenlets from the background threads do not exit in a timely fashion,
+    # we fail the object-based leakchecks.
+    def test_untracked_memory_doesnt_increase_unfinished_thread_dealloc_in_main(self):
+        self._check_untracked_memory_thread(deallocate_in_thread=False)
+
+if __name__ == '__main__':
+    __import__('unittest').main()
diff --git a/llm/Lib/site-packages/greenlet/tests/test_stack_saved.py b/llm/Lib/site-packages/greenlet/tests/test_stack_saved.py
new file mode 100644
index 0000000000000000000000000000000000000000..b362bf95a2d476b4fee2ff49cd7a9c4b53362fb5
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_stack_saved.py
@@ -0,0 +1,19 @@
+import greenlet
+from . import TestCase
+
+
+class Test(TestCase):
+
+    def test_stack_saved(self):
+        main = greenlet.getcurrent()
+        self.assertEqual(main._stack_saved, 0)
+
+        def func():
+            main.switch(main._stack_saved)
+
+        g = greenlet.greenlet(func)
+        x = g.switch()
+        self.assertGreater(x, 0)
+        self.assertGreater(g._stack_saved, 0)
+        g.switch()
+        self.assertEqual(g._stack_saved, 0)
diff --git a/llm/Lib/site-packages/greenlet/tests/test_throw.py b/llm/Lib/site-packages/greenlet/tests/test_throw.py
new file mode 100644
index 0000000000000000000000000000000000000000..f4f9a140293d5a09b4503687d835c8e5cc9ad30d
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_throw.py
@@ -0,0 +1,128 @@
+import sys
+
+
+from greenlet import greenlet
+from . import TestCase
+
+def switch(*args):
+    return greenlet.getcurrent().parent.switch(*args)
+
+
+class ThrowTests(TestCase):
+    def test_class(self):
+        def f():
+            try:
+                switch("ok")
+            except RuntimeError:
+                switch("ok")
+                return
+            switch("fail")
+        g = greenlet(f)
+        res = g.switch()
+        self.assertEqual(res, "ok")
+        res = g.throw(RuntimeError)
+        self.assertEqual(res, "ok")
+
+    def test_val(self):
+        def f():
+            try:
+                switch("ok")
+            except RuntimeError:
+                val = sys.exc_info()[1]
+                if str(val) == "ciao":
+                    switch("ok")
+                    return
+            switch("fail")
+
+        g = greenlet(f)
+        res = g.switch()
+        self.assertEqual(res, "ok")
+        res = g.throw(RuntimeError("ciao"))
+        self.assertEqual(res, "ok")
+
+        g = greenlet(f)
+        res = g.switch()
+        self.assertEqual(res, "ok")
+        res = g.throw(RuntimeError, "ciao")
+        self.assertEqual(res, "ok")
+
+    def test_kill(self):
+        def f():
+            switch("ok")
+            switch("fail")
+        g = greenlet(f)
+        res = g.switch()
+        self.assertEqual(res, "ok")
+        res = g.throw()
+        self.assertTrue(isinstance(res, greenlet.GreenletExit))
+        self.assertTrue(g.dead)
+        res = g.throw()    # immediately eaten by the already-dead greenlet
+        self.assertTrue(isinstance(res, greenlet.GreenletExit))
+
+    def test_throw_goes_to_original_parent(self):
+        main = greenlet.getcurrent()
+
+        def f1():
+            try:
+                main.switch("f1 ready to catch")
+            except IndexError:
+                return "caught"
+            return "normal exit"
+
+        def f2():
+            main.switch("from f2")
+
+        g1 = greenlet(f1)
+        g2 = greenlet(f2, parent=g1)
+        with self.assertRaises(IndexError):
+            g2.throw(IndexError)
+        self.assertTrue(g2.dead)
+        self.assertTrue(g1.dead)
+
+        g1 = greenlet(f1)
+        g2 = greenlet(f2, parent=g1)
+        res = g1.switch()
+        self.assertEqual(res, "f1 ready to catch")
+        res = g2.throw(IndexError)
+        self.assertEqual(res, "caught")
+        self.assertTrue(g2.dead)
+        self.assertTrue(g1.dead)
+
+        g1 = greenlet(f1)
+        g2 = greenlet(f2, parent=g1)
+        res = g1.switch()
+        self.assertEqual(res, "f1 ready to catch")
+        res = g2.switch()
+        self.assertEqual(res, "from f2")
+        res = g2.throw(IndexError)
+        self.assertEqual(res, "caught")
+        self.assertTrue(g2.dead)
+        self.assertTrue(g1.dead)
+
+    def test_non_traceback_param(self):
+        with self.assertRaises(TypeError) as exc:
+            greenlet.getcurrent().throw(
+                Exception,
+                Exception(),
+                self
+            )
+        self.assertEqual(str(exc.exception),
+                         "throw() third argument must be a traceback object")
+
+    def test_instance_of_wrong_type(self):
+        with self.assertRaises(TypeError) as exc:
+            greenlet.getcurrent().throw(
+                Exception(),
+                BaseException()
+            )
+
+        self.assertEqual(str(exc.exception),
+                         "instance exception may not have a separate value")
+
+    def test_not_throwable(self):
+        with self.assertRaises(TypeError) as exc:
+            greenlet.getcurrent().throw(
+                "abc"
+            )
+        self.assertEqual(str(exc.exception),
+                         "exceptions must be classes, or instances, not str")
diff --git a/llm/Lib/site-packages/greenlet/tests/test_tracing.py b/llm/Lib/site-packages/greenlet/tests/test_tracing.py
new file mode 100644
index 0000000000000000000000000000000000000000..c044d4b6479b58b354887b921b0ec748881f476f
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_tracing.py
@@ -0,0 +1,291 @@
+from __future__ import print_function
+import sys
+import greenlet
+import unittest
+
+from . import TestCase
+from . import PY312
+
+# https://discuss.python.org/t/cpython-3-12-greenlet-and-tracing-profiling-how-to-not-crash-and-get-correct-results/33144/2
+DEBUG_BUILD_PY312 = (
+    PY312 and hasattr(sys, 'gettotalrefcount'),
+    "Broken on debug builds of Python 3.12"
+)
+
+class SomeError(Exception):
+    pass
+
+class GreenletTracer(object):
+    oldtrace = None
+
+    def __init__(self, error_on_trace=False):
+        self.actions = []
+        self.error_on_trace = error_on_trace
+
+    def __call__(self, *args):
+        self.actions.append(args)
+        if self.error_on_trace:
+            raise SomeError
+
+    def __enter__(self):
+        self.oldtrace = greenlet.settrace(self)
+        return self.actions
+
+    def __exit__(self, *args):
+        greenlet.settrace(self.oldtrace)
+
+
+class TestGreenletTracing(TestCase):
+    """
+    Tests of ``greenlet.settrace()``
+    """
+
+    def test_a_greenlet_tracing(self):
+        main = greenlet.getcurrent()
+        def dummy():
+            pass
+        def dummyexc():
+            raise SomeError()
+
+        with GreenletTracer() as actions:
+            g1 = greenlet.greenlet(dummy)
+            g1.switch()
+            g2 = greenlet.greenlet(dummyexc)
+            self.assertRaises(SomeError, g2.switch)
+
+        self.assertEqual(actions, [
+            ('switch', (main, g1)),
+            ('switch', (g1, main)),
+            ('switch', (main, g2)),
+            ('throw', (g2, main)),
+        ])
+
+    def test_b_exception_disables_tracing(self):
+        main = greenlet.getcurrent()
+        def dummy():
+            main.switch()
+        g = greenlet.greenlet(dummy)
+        g.switch()
+        with GreenletTracer(error_on_trace=True) as actions:
+            self.assertRaises(SomeError, g.switch)
+            self.assertEqual(greenlet.gettrace(), None)
+
+        self.assertEqual(actions, [
+            ('switch', (main, g)),
+        ])
+
+    def test_set_same_tracer_twice(self):
+        # https://github.com/python-greenlet/greenlet/issues/332
+        # Our logic in asserting that the tracefunction should
+        # gain a reference was incorrect if the same tracefunction was set
+        # twice.
+        tracer = GreenletTracer()
+        with tracer:
+            greenlet.settrace(tracer)
+
+
+class PythonTracer(object):
+    oldtrace = None
+
+    def __init__(self):
+        self.actions = []
+
+    def __call__(self, frame, event, arg):
+        # Record the co_name so we have an idea what function we're in.
+        self.actions.append((event, frame.f_code.co_name))
+
+    def __enter__(self):
+        self.oldtrace = sys.setprofile(self)
+        return self.actions
+
+    def __exit__(self, *args):
+        sys.setprofile(self.oldtrace)
+
+def tpt_callback():
+    return 42
+
+class TestPythonTracing(TestCase):
+    """
+    Tests of the interaction of ``sys.settrace()``
+    with greenlet facilities.
+
+    NOTE: Most of this is probably CPython specific.
+    """
+
+    maxDiff = None
+
+    def test_trace_events_trivial(self):
+        with PythonTracer() as actions:
+            tpt_callback()
+        # If we use the sys.settrace instead of setprofile, we get
+        # this:
+
+        # self.assertEqual(actions, [
+        #     ('call', 'tpt_callback'),
+        #     ('call', '__exit__'),
+        # ])
+
+        self.assertEqual(actions, [
+            ('return', '__enter__'),
+            ('call', 'tpt_callback'),
+            ('return', 'tpt_callback'),
+            ('call', '__exit__'),
+            ('c_call', '__exit__'),
+        ])
+
+    def _trace_switch(self, glet):
+        with PythonTracer() as actions:
+            glet.switch()
+        return actions
+
+    def _check_trace_events_func_already_set(self, glet):
+        actions = self._trace_switch(glet)
+        self.assertEqual(actions, [
+            ('return', '__enter__'),
+            ('c_call', '_trace_switch'),
+            ('call', 'run'),
+            ('call', 'tpt_callback'),
+            ('return', 'tpt_callback'),
+            ('return', 'run'),
+            ('c_return', '_trace_switch'),
+            ('call', '__exit__'),
+            ('c_call', '__exit__'),
+        ])
+
+    def test_trace_events_into_greenlet_func_already_set(self):
+        def run():
+            return tpt_callback()
+
+        self._check_trace_events_func_already_set(greenlet.greenlet(run))
+
+    def test_trace_events_into_greenlet_subclass_already_set(self):
+        class X(greenlet.greenlet):
+            def run(self):
+                return tpt_callback()
+        self._check_trace_events_func_already_set(X())
+
+    def _check_trace_events_from_greenlet_sets_profiler(self, g, tracer):
+        g.switch()
+        tpt_callback()
+        tracer.__exit__()
+        self.assertEqual(tracer.actions, [
+            ('return', '__enter__'),
+            ('call', 'tpt_callback'),
+            ('return', 'tpt_callback'),
+            ('return', 'run'),
+            ('call', 'tpt_callback'),
+            ('return', 'tpt_callback'),
+            ('call', '__exit__'),
+            ('c_call', '__exit__'),
+        ])
+
+
+    def test_trace_events_from_greenlet_func_sets_profiler(self):
+        tracer = PythonTracer()
+        def run():
+            tracer.__enter__()
+            return tpt_callback()
+
+        self._check_trace_events_from_greenlet_sets_profiler(greenlet.greenlet(run),
+                                                             tracer)
+
+    def test_trace_events_from_greenlet_subclass_sets_profiler(self):
+        tracer = PythonTracer()
+        class X(greenlet.greenlet):
+            def run(self):
+                tracer.__enter__()
+                return tpt_callback()
+
+        self._check_trace_events_from_greenlet_sets_profiler(X(), tracer)
+
+    @unittest.skipIf(*DEBUG_BUILD_PY312)
+    def test_trace_events_multiple_greenlets_switching(self):
+        tracer = PythonTracer()
+
+        g1 = None
+        g2 = None
+
+        def g1_run():
+            tracer.__enter__()
+            tpt_callback()
+            g2.switch()
+            tpt_callback()
+            return 42
+
+        def g2_run():
+            tpt_callback()
+            tracer.__exit__()
+            tpt_callback()
+            g1.switch()
+
+        g1 = greenlet.greenlet(g1_run)
+        g2 = greenlet.greenlet(g2_run)
+
+        x = g1.switch()
+        self.assertEqual(x, 42)
+        tpt_callback() # ensure not in the trace
+        self.assertEqual(tracer.actions, [
+            ('return', '__enter__'),
+            ('call', 'tpt_callback'),
+            ('return', 'tpt_callback'),
+            ('c_call', 'g1_run'),
+            ('call', 'g2_run'),
+            ('call', 'tpt_callback'),
+            ('return', 'tpt_callback'),
+            ('call', '__exit__'),
+            ('c_call', '__exit__'),
+        ])
+
+    @unittest.skipIf(*DEBUG_BUILD_PY312)
+    def test_trace_events_multiple_greenlets_switching_siblings(self):
+        # Like the first version, but get both greenlets running first
+        # as "siblings" and then establish the tracing.
+        tracer = PythonTracer()
+
+        g1 = None
+        g2 = None
+
+        def g1_run():
+            greenlet.getcurrent().parent.switch()
+            tracer.__enter__()
+            tpt_callback()
+            g2.switch()
+            tpt_callback()
+            return 42
+
+        def g2_run():
+            greenlet.getcurrent().parent.switch()
+
+            tpt_callback()
+            tracer.__exit__()
+            tpt_callback()
+            g1.switch()
+
+        g1 = greenlet.greenlet(g1_run)
+        g2 = greenlet.greenlet(g2_run)
+
+        # Start g1
+        g1.switch()
+        # And it immediately returns control to us.
+        # Start g2
+        g2.switch()
+        # Which also returns. Now kick of the real part of the
+        # test.
+        x = g1.switch()
+        self.assertEqual(x, 42)
+
+        tpt_callback() # ensure not in the trace
+        self.assertEqual(tracer.actions, [
+            ('return', '__enter__'),
+            ('call', 'tpt_callback'),
+            ('return', 'tpt_callback'),
+            ('c_call', 'g1_run'),
+            ('call', 'tpt_callback'),
+            ('return', 'tpt_callback'),
+            ('call', '__exit__'),
+            ('c_call', '__exit__'),
+        ])
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/llm/Lib/site-packages/greenlet/tests/test_version.py b/llm/Lib/site-packages/greenlet/tests/test_version.py
new file mode 100644
index 0000000000000000000000000000000000000000..96c17cf1700fd501df2113713307251fff8d095c
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_version.py
@@ -0,0 +1,41 @@
+#! /usr/bin/env python
+from __future__ import absolute_import
+from __future__ import print_function
+
+import sys
+import os
+from unittest import TestCase as NonLeakingTestCase
+
+import greenlet
+
+# No reason to run this multiple times under leakchecks,
+# it doesn't do anything.
+class VersionTests(NonLeakingTestCase):
+    def test_version(self):
+        def find_dominating_file(name):
+            if os.path.exists(name):
+                return name
+
+            tried = []
+            here = os.path.abspath(os.path.dirname(__file__))
+            for i in range(10):
+                up = ['..'] * i
+                path = [here] + up + [name]
+                fname = os.path.join(*path)
+                fname = os.path.abspath(fname)
+                tried.append(fname)
+                if os.path.exists(fname):
+                    return fname
+            raise AssertionError("Could not find file " + name + "; checked " + str(tried))
+
+        try:
+            setup_py = find_dominating_file('setup.py')
+        except AssertionError as e:
+            self.skipTest("Unable to find setup.py; must be out of tree. " + str(e))
+
+
+        invoke_setup = "%s %s --version" % (sys.executable, setup_py)
+        with os.popen(invoke_setup) as f:
+            sversion = f.read().strip()
+
+        self.assertEqual(sversion, greenlet.__version__)
diff --git a/llm/Lib/site-packages/greenlet/tests/test_weakref.py b/llm/Lib/site-packages/greenlet/tests/test_weakref.py
new file mode 100644
index 0000000000000000000000000000000000000000..05a38a7f103c082289cd65f95ace5695bc3a8842
--- /dev/null
+++ b/llm/Lib/site-packages/greenlet/tests/test_weakref.py
@@ -0,0 +1,35 @@
+import gc
+import weakref
+
+
+import greenlet
+from . import TestCase
+
+class WeakRefTests(TestCase):
+    def test_dead_weakref(self):
+        def _dead_greenlet():
+            g = greenlet.greenlet(lambda: None)
+            g.switch()
+            return g
+        o = weakref.ref(_dead_greenlet())
+        gc.collect()
+        self.assertEqual(o(), None)
+
+    def test_inactive_weakref(self):
+        o = weakref.ref(greenlet.greenlet())
+        gc.collect()
+        self.assertEqual(o(), None)
+
+    def test_dealloc_weakref(self):
+        seen = []
+        def worker():
+            try:
+                greenlet.getcurrent().parent.switch()
+            finally:
+                seen.append(g())
+        g = greenlet.greenlet(worker)
+        g.switch()
+        g2 = greenlet.greenlet(lambda: None, g)
+        g = weakref.ref(g2)
+        g2 = None
+        self.assertEqual(seen, [None])
diff --git a/llm/Lib/site-packages/h11-0.14.0.dist-info/INSTALLER b/llm/Lib/site-packages/h11-0.14.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/h11-0.14.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/h11-0.14.0.dist-info/LICENSE.txt b/llm/Lib/site-packages/h11-0.14.0.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..8f080eae848f759c9173bfc0c79506357ebe5090
--- /dev/null
+++ b/llm/Lib/site-packages/h11-0.14.0.dist-info/LICENSE.txt
@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Nathaniel J. Smith <njs@pobox.com> and other contributors
+
+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 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.
diff --git a/llm/Lib/site-packages/h11-0.14.0.dist-info/METADATA b/llm/Lib/site-packages/h11-0.14.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..cf12a82f193d8a69b9bc7aaa134cdbb8aa5bd938
--- /dev/null
+++ b/llm/Lib/site-packages/h11-0.14.0.dist-info/METADATA
@@ -0,0 +1,193 @@
+Metadata-Version: 2.1
+Name: h11
+Version: 0.14.0
+Summary: A pure-Python, bring-your-own-I/O implementation of HTTP/1.1
+Home-page: https://github.com/python-hyper/h11
+Author: Nathaniel J. Smith
+Author-email: njs@pobox.com
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.7
+License-File: LICENSE.txt
+Requires-Dist: typing-extensions ; python_version < "3.8"
+
+h11
+===
+
+.. image:: https://travis-ci.org/python-hyper/h11.svg?branch=master
+   :target: https://travis-ci.org/python-hyper/h11
+   :alt: Automated test status
+
+.. image:: https://codecov.io/gh/python-hyper/h11/branch/master/graph/badge.svg
+   :target: https://codecov.io/gh/python-hyper/h11
+   :alt: Test coverage
+
+.. image:: https://readthedocs.org/projects/h11/badge/?version=latest
+   :target: http://h11.readthedocs.io/en/latest/?badge=latest
+   :alt: Documentation Status
+
+This is a little HTTP/1.1 library written from scratch in Python,
+heavily inspired by `hyper-h2 <https://hyper-h2.readthedocs.io/>`_.
+
+It's a "bring-your-own-I/O" library; h11 contains no IO code
+whatsoever. This means you can hook h11 up to your favorite network
+API, and that could be anything you want: synchronous, threaded,
+asynchronous, or your own implementation of `RFC 6214
+<https://tools.ietf.org/html/rfc6214>`_ -- h11 won't judge you.
+(Compare this to the current state of the art, where every time a `new
+network API <https://trio.readthedocs.io/>`_ comes along then someone
+gets to start over reimplementing the entire HTTP protocol from
+scratch.) Cory Benfield made an `excellent blog post describing the
+benefits of this approach
+<https://lukasa.co.uk/2015/10/The_New_Hyper/>`_, or if you like video
+then here's his `PyCon 2016 talk on the same theme
+<https://www.youtube.com/watch?v=7cC3_jGwl_U>`_.
+
+This also means that h11 is not immediately useful out of the box:
+it's a toolkit for building programs that speak HTTP, not something
+that could directly replace ``requests`` or ``twisted.web`` or
+whatever. But h11 makes it much easier to implement something like
+``requests`` or ``twisted.web``.
+
+At a high level, working with h11 goes like this:
+
+1) First, create an ``h11.Connection`` object to track the state of a
+   single HTTP/1.1 connection.
+
+2) When you read data off the network, pass it to
+   ``conn.receive_data(...)``; you'll get back a list of objects
+   representing high-level HTTP "events".
+
+3) When you want to send a high-level HTTP event, create the
+   corresponding "event" object and pass it to ``conn.send(...)``;
+   this will give you back some bytes that you can then push out
+   through the network.
+
+For example, a client might instantiate and then send a
+``h11.Request`` object, then zero or more ``h11.Data`` objects for the
+request body (e.g., if this is a POST), and then a
+``h11.EndOfMessage`` to indicate the end of the message. Then the
+server would then send back a ``h11.Response``, some ``h11.Data``, and
+its own ``h11.EndOfMessage``. If either side violates the protocol,
+you'll get a ``h11.ProtocolError`` exception.
+
+h11 is suitable for implementing both servers and clients, and has a
+pleasantly symmetric API: the events you send as a client are exactly
+the ones that you receive as a server and vice-versa.
+
+`Here's an example of a tiny HTTP client
+<https://github.com/python-hyper/h11/blob/master/examples/basic-client.py>`_
+
+It also has `a fine manual <https://h11.readthedocs.io/>`_.
+
+FAQ
+---
+
+*Whyyyyy?*
+
+I wanted to play with HTTP in `Curio
+<https://curio.readthedocs.io/en/latest/tutorial.html>`__ and `Trio
+<https://trio.readthedocs.io>`__, which at the time didn't have any
+HTTP libraries. So I thought, no big deal, Python has, like, a dozen
+different implementations of HTTP, surely I can find one that's
+reusable. I didn't find one, but I did find Cory's call-to-arms
+blog-post. So I figured, well, fine, if I have to implement HTTP from
+scratch, at least I can make sure no-one *else* has to ever again.
+
+*Should I use it?*
+
+Maybe. You should be aware that it's a very young project. But, it's
+feature complete and has an exhaustive test-suite and complete docs,
+so the next step is for people to try using it and see how it goes
+:-). If you do then please let us know -- if nothing else we'll want
+to talk to you before making any incompatible changes!
+
+*What are the features/limitations?*
+
+Roughly speaking, it's trying to be a robust, complete, and non-hacky
+implementation of the first "chapter" of the HTTP/1.1 spec: `RFC 7230:
+HTTP/1.1 Message Syntax and Routing
+<https://tools.ietf.org/html/rfc7230>`_. That is, it mostly focuses on
+implementing HTTP at the level of taking bytes on and off the wire,
+and the headers related to that, and tries to be anal about spec
+conformance. It doesn't know about higher-level concerns like URL
+routing, conditional GETs, cross-origin cookie policies, or content
+negotiation. But it does know how to take care of framing,
+cross-version differences in keep-alive handling, and the "obsolete
+line folding" rule, so you can focus your energies on the hard /
+interesting parts for your application, and it tries to support the
+full specification in the sense that any useful HTTP/1.1 conformant
+application should be able to use h11.
+
+It's pure Python, and has no dependencies outside of the standard
+library.
+
+It has a test suite with 100.0% coverage for both statements and
+branches.
+
+Currently it supports Python 3 (testing on 3.7-3.10) and PyPy 3.
+The last Python 2-compatible version was h11 0.11.x.
+(Originally it had a Cython wrapper for `http-parser
+<https://github.com/nodejs/http-parser>`_ and a beautiful nested state
+machine implemented with ``yield from`` to postprocess the output. But
+I had to take these out -- the new *parser* needs fewer lines-of-code
+than the old *parser wrapper*, is written in pure Python, uses no
+exotic language syntax, and has more features. It's sad, really; that
+old state machine was really slick. I just need a few sentences here
+to mourn that.)
+
+I don't know how fast it is. I haven't benchmarked or profiled it yet,
+so it's probably got a few pointless hot spots, and I've been trying
+to err on the side of simplicity and robustness instead of
+micro-optimization. But at the architectural level I tried hard to
+avoid fundamentally bad decisions, e.g., I believe that all the
+parsing algorithms remain linear-time even in the face of pathological
+input like slowloris, and there are no byte-by-byte loops. (I also
+believe that it maintains bounded memory usage in the face of
+arbitrary/pathological input.)
+
+The whole library is ~800 lines-of-code. You can read and understand
+the whole thing in less than an hour. Most of the energy invested in
+this so far has been spent on trying to keep things simple by
+minimizing special-cases and ad hoc state manipulation; even though it
+is now quite small and simple, I'm still annoyed that I haven't
+figured out how to make it even smaller and simpler. (Unfortunately,
+HTTP does not lend itself to simplicity.)
+
+The API is ~feature complete and I don't expect the general outlines
+to change much, but you can't judge an API's ergonomics until you
+actually document and use it, so I'd expect some changes in the
+details.
+
+*How do I try it?*
+
+.. code-block:: sh
+
+  $ pip install h11
+  $ git clone git@github.com:python-hyper/h11
+  $ cd h11/examples
+  $ python basic-client.py
+
+and go from there.
+
+*License?*
+
+MIT
+
+*Code of conduct?*
+
+Contributors are requested to follow our `code of conduct
+<https://github.com/python-hyper/h11/blob/master/CODE_OF_CONDUCT.md>`_ in
+all project spaces.
diff --git a/llm/Lib/site-packages/h11-0.14.0.dist-info/RECORD b/llm/Lib/site-packages/h11-0.14.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..a055008111c6c3471f71e83f647504177eeb528b
--- /dev/null
+++ b/llm/Lib/site-packages/h11-0.14.0.dist-info/RECORD
@@ -0,0 +1,52 @@
+h11-0.14.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+h11-0.14.0.dist-info/LICENSE.txt,sha256=N9tbuFkm2yikJ6JYZ_ELEjIAOuob5pzLhRE4rbjm82E,1124
+h11-0.14.0.dist-info/METADATA,sha256=B7pZ0m7WBXNs17vl6hUH9bJTL9s37DaGvY31w7jNxSg,8175
+h11-0.14.0.dist-info/RECORD,,
+h11-0.14.0.dist-info/WHEEL,sha256=ewwEueio1C2XeHTvT17n8dZUJgOvyCWCt0WVNLClP9o,92
+h11-0.14.0.dist-info/top_level.txt,sha256=F7dC4jl3zeh8TGHEPaWJrMbeuoWbS379Gwdi-Yvdcis,4
+h11/__init__.py,sha256=iO1KzkSO42yZ6ffg-VMgbx_ZVTWGUY00nRYEWn-s3kY,1507
+h11/__pycache__/__init__.cpython-311.pyc,,
+h11/__pycache__/_abnf.cpython-311.pyc,,
+h11/__pycache__/_connection.cpython-311.pyc,,
+h11/__pycache__/_events.cpython-311.pyc,,
+h11/__pycache__/_headers.cpython-311.pyc,,
+h11/__pycache__/_readers.cpython-311.pyc,,
+h11/__pycache__/_receivebuffer.cpython-311.pyc,,
+h11/__pycache__/_state.cpython-311.pyc,,
+h11/__pycache__/_util.cpython-311.pyc,,
+h11/__pycache__/_version.cpython-311.pyc,,
+h11/__pycache__/_writers.cpython-311.pyc,,
+h11/_abnf.py,sha256=ybixr0xsupnkA6GFAyMubuXF6Tc1lb_hF890NgCsfNc,4815
+h11/_connection.py,sha256=eS2sorMD0zKLCFiB9lW9W9F_Nzny2tjHa4e6s1ujr1c,26539
+h11/_events.py,sha256=LEfuvg1AbhHaVRwxCd0I-pFn9-ezUOaoL8o2Kvy1PBA,11816
+h11/_headers.py,sha256=RqB8cd8CN0blYPzcLe5qeCh-phv6D1U_CHj4hs67lgQ,10230
+h11/_readers.py,sha256=EbSed0jzwVUiD1nOPAeUcVE4Flf3wXkxfb8c06-OTBM,8383
+h11/_receivebuffer.py,sha256=xrspsdsNgWFxRfQcTXxR8RrdjRXXTK0Io5cQYWpJ1Ws,5252
+h11/_state.py,sha256=k1VL6SDbaPkSrZ-49ewCXDpuiUS69_46YhbWjuV1qEY,13300
+h11/_util.py,sha256=LWkkjXyJaFlAy6Lt39w73UStklFT5ovcvo0TkY7RYuk,4888
+h11/_version.py,sha256=LVyTdiZRzIIEv79UyOgbM5iUrJUllEzlCWaJEYBY1zc,686
+h11/_writers.py,sha256=oFKm6PtjeHfbj4RLX7VB7KDc1gIY53gXG3_HR9ltmTA,5081
+h11/py.typed,sha256=sow9soTwP9T_gEAQSVh7Gb8855h04Nwmhs2We-JRgZM,7
+h11/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+h11/tests/__pycache__/__init__.cpython-311.pyc,,
+h11/tests/__pycache__/helpers.cpython-311.pyc,,
+h11/tests/__pycache__/test_against_stdlib_http.cpython-311.pyc,,
+h11/tests/__pycache__/test_connection.cpython-311.pyc,,
+h11/tests/__pycache__/test_events.cpython-311.pyc,,
+h11/tests/__pycache__/test_headers.cpython-311.pyc,,
+h11/tests/__pycache__/test_helpers.cpython-311.pyc,,
+h11/tests/__pycache__/test_io.cpython-311.pyc,,
+h11/tests/__pycache__/test_receivebuffer.cpython-311.pyc,,
+h11/tests/__pycache__/test_state.cpython-311.pyc,,
+h11/tests/__pycache__/test_util.cpython-311.pyc,,
+h11/tests/data/test-file,sha256=ZJ03Rqs98oJw29OHzJg7LlMzyGQaRAY0r3AqBeM2wVU,65
+h11/tests/helpers.py,sha256=a1EVG_p7xU4wRsa3tMPTRxuaKCmretok9sxXWvqfmQA,3355
+h11/tests/test_against_stdlib_http.py,sha256=cojCHgHXFQ8gWhNlEEwl3trmOpN-5uDukRoHnElqo3A,3995
+h11/tests/test_connection.py,sha256=ZbPLDPclKvjgjAhgk-WlCPBaf17c4XUIV2tpaW08jOI,38720
+h11/tests/test_events.py,sha256=LPVLbcV-NvPNK9fW3rraR6Bdpz1hAlsWubMtNaJ5gHg,4657
+h11/tests/test_headers.py,sha256=qd8T1Zenuz5GbD6wklSJ5G8VS7trrYgMV0jT-SMvqg8,5612
+h11/tests/test_helpers.py,sha256=kAo0CEM4LGqmyyP2ZFmhsyq3UFJqoFfAbzu3hbWreRM,794
+h11/tests/test_io.py,sha256=uCZVnjarkRBkudfC1ij-KSCQ71XWJhnkgkgWWkKgYPQ,16386
+h11/tests/test_receivebuffer.py,sha256=3jGbeJM36Akqg_pAhPb7XzIn2NS6RhPg-Ryg8Eu6ytk,3454
+h11/tests/test_state.py,sha256=rqll9WqFsJPE0zSrtCn9LH659mPKsDeXZ-DwXwleuBQ,8928
+h11/tests/test_util.py,sha256=VO5L4nSFe4pgtSwKuv6u_6l0H7UeizF5WKuHTWreg70,2970
diff --git a/llm/Lib/site-packages/h11-0.14.0.dist-info/WHEEL b/llm/Lib/site-packages/h11-0.14.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..5bad85fdc1cd08553756d0fb2c7be8b5ad6af7fb
--- /dev/null
+++ b/llm/Lib/site-packages/h11-0.14.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.37.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/h11-0.14.0.dist-info/top_level.txt b/llm/Lib/site-packages/h11-0.14.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..0d24def711344ec6f4da2108f7d5c9261eb35f8b
--- /dev/null
+++ b/llm/Lib/site-packages/h11-0.14.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+h11
diff --git a/llm/Lib/site-packages/h11/__init__.py b/llm/Lib/site-packages/h11/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..989e92c3458681a6f0be72ae4105ea742750d328
--- /dev/null
+++ b/llm/Lib/site-packages/h11/__init__.py
@@ -0,0 +1,62 @@
+# A highish-level implementation of the HTTP/1.1 wire protocol (RFC 7230),
+# containing no networking code at all, loosely modelled on hyper-h2's generic
+# implementation of HTTP/2 (and in particular the h2.connection.H2Connection
+# class). There's still a bunch of subtle details you need to get right if you
+# want to make this actually useful, because it doesn't implement all the
+# semantics to check that what you're asking to write to the wire is sensible,
+# but at least it gets you out of dealing with the wire itself.
+
+from h11._connection import Connection, NEED_DATA, PAUSED
+from h11._events import (
+    ConnectionClosed,
+    Data,
+    EndOfMessage,
+    Event,
+    InformationalResponse,
+    Request,
+    Response,
+)
+from h11._state import (
+    CLIENT,
+    CLOSED,
+    DONE,
+    ERROR,
+    IDLE,
+    MIGHT_SWITCH_PROTOCOL,
+    MUST_CLOSE,
+    SEND_BODY,
+    SEND_RESPONSE,
+    SERVER,
+    SWITCHED_PROTOCOL,
+)
+from h11._util import LocalProtocolError, ProtocolError, RemoteProtocolError
+from h11._version import __version__
+
+PRODUCT_ID = "python-h11/" + __version__
+
+
+__all__ = (
+    "Connection",
+    "NEED_DATA",
+    "PAUSED",
+    "ConnectionClosed",
+    "Data",
+    "EndOfMessage",
+    "Event",
+    "InformationalResponse",
+    "Request",
+    "Response",
+    "CLIENT",
+    "CLOSED",
+    "DONE",
+    "ERROR",
+    "IDLE",
+    "MUST_CLOSE",
+    "SEND_BODY",
+    "SEND_RESPONSE",
+    "SERVER",
+    "SWITCHED_PROTOCOL",
+    "ProtocolError",
+    "LocalProtocolError",
+    "RemoteProtocolError",
+)
diff --git a/llm/Lib/site-packages/h11/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/h11/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a6eb55246e0511db11304ad92d7b6be25bd3e3da
Binary files /dev/null and b/llm/Lib/site-packages/h11/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/__pycache__/_abnf.cpython-311.pyc b/llm/Lib/site-packages/h11/__pycache__/_abnf.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..45d524434d1919cda8ce707883a421ff54f7863a
Binary files /dev/null and b/llm/Lib/site-packages/h11/__pycache__/_abnf.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/__pycache__/_connection.cpython-311.pyc b/llm/Lib/site-packages/h11/__pycache__/_connection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2ba9986c85dc334bc29772df3644e183cc1095af
Binary files /dev/null and b/llm/Lib/site-packages/h11/__pycache__/_connection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/__pycache__/_events.cpython-311.pyc b/llm/Lib/site-packages/h11/__pycache__/_events.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..83bd7e665d003c72522b9f0b7e6ddc80aaa40715
Binary files /dev/null and b/llm/Lib/site-packages/h11/__pycache__/_events.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/__pycache__/_headers.cpython-311.pyc b/llm/Lib/site-packages/h11/__pycache__/_headers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..20b95ea0dae2eaab3a060d4196fea439eecb256d
Binary files /dev/null and b/llm/Lib/site-packages/h11/__pycache__/_headers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/__pycache__/_readers.cpython-311.pyc b/llm/Lib/site-packages/h11/__pycache__/_readers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..93b5d7825b95ba2745532b5e5ada12df2f4a812b
Binary files /dev/null and b/llm/Lib/site-packages/h11/__pycache__/_readers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/__pycache__/_receivebuffer.cpython-311.pyc b/llm/Lib/site-packages/h11/__pycache__/_receivebuffer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a37a467eef2ff65a7eb778ee714e088775afc093
Binary files /dev/null and b/llm/Lib/site-packages/h11/__pycache__/_receivebuffer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/__pycache__/_state.cpython-311.pyc b/llm/Lib/site-packages/h11/__pycache__/_state.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..efda09243724d5e4d9bfb6dea61d0fe12532da28
Binary files /dev/null and b/llm/Lib/site-packages/h11/__pycache__/_state.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/__pycache__/_util.cpython-311.pyc b/llm/Lib/site-packages/h11/__pycache__/_util.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3f2a26314dd6c9a4fe538c1ec2dfa96e5817d0da
Binary files /dev/null and b/llm/Lib/site-packages/h11/__pycache__/_util.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/__pycache__/_version.cpython-311.pyc b/llm/Lib/site-packages/h11/__pycache__/_version.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d42766049cb1a93a05eba46f29bf2278a597750e
Binary files /dev/null and b/llm/Lib/site-packages/h11/__pycache__/_version.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/__pycache__/_writers.cpython-311.pyc b/llm/Lib/site-packages/h11/__pycache__/_writers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2339157dac1542d3b3509093074bf554b7453995
Binary files /dev/null and b/llm/Lib/site-packages/h11/__pycache__/_writers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/_abnf.py b/llm/Lib/site-packages/h11/_abnf.py
new file mode 100644
index 0000000000000000000000000000000000000000..933587fba22290d7eb7df4c88e12f1e61702b8ce
--- /dev/null
+++ b/llm/Lib/site-packages/h11/_abnf.py
@@ -0,0 +1,132 @@
+# We use native strings for all the re patterns, to take advantage of string
+# formatting, and then convert to bytestrings when compiling the final re
+# objects.
+
+# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#whitespace
+#  OWS            = *( SP / HTAB )
+#                 ; optional whitespace
+OWS = r"[ \t]*"
+
+# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#rule.token.separators
+#   token          = 1*tchar
+#
+#   tchar          = "!" / "#" / "$" / "%" / "&" / "'" / "*"
+#                  / "+" / "-" / "." / "^" / "_" / "`" / "|" / "~"
+#                  / DIGIT / ALPHA
+#                  ; any VCHAR, except delimiters
+token = r"[-!#$%&'*+.^_`|~0-9a-zA-Z]+"
+
+# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#header.fields
+#  field-name     = token
+field_name = token
+
+# The standard says:
+#
+#  field-value    = *( field-content / obs-fold )
+#  field-content  = field-vchar [ 1*( SP / HTAB ) field-vchar ]
+#  field-vchar    = VCHAR / obs-text
+#  obs-fold       = CRLF 1*( SP / HTAB )
+#                 ; obsolete line folding
+#                 ; see Section 3.2.4
+#
+# https://tools.ietf.org/html/rfc5234#appendix-B.1
+#
+#   VCHAR          =  %x21-7E
+#                  ; visible (printing) characters
+#
+# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#rule.quoted-string
+#   obs-text       = %x80-FF
+#
+# However, the standard definition of field-content is WRONG! It disallows
+# fields containing a single visible character surrounded by whitespace,
+# e.g. "foo a bar".
+#
+# See: https://www.rfc-editor.org/errata_search.php?rfc=7230&eid=4189
+#
+# So our definition of field_content attempts to fix it up...
+#
+# Also, we allow lots of control characters, because apparently people assume
+# that they're legal in practice (e.g., google analytics makes cookies with
+# \x01 in them!):
+#   https://github.com/python-hyper/h11/issues/57
+# We still don't allow NUL or whitespace, because those are often treated as
+# meta-characters and letting them through can lead to nasty issues like SSRF.
+vchar = r"[\x21-\x7e]"
+vchar_or_obs_text = r"[^\x00\s]"
+field_vchar = vchar_or_obs_text
+field_content = r"{field_vchar}+(?:[ \t]+{field_vchar}+)*".format(**globals())
+
+# We handle obs-fold at a different level, and our fixed-up field_content
+# already grows to swallow the whole value, so ? instead of *
+field_value = r"({field_content})?".format(**globals())
+
+#  header-field   = field-name ":" OWS field-value OWS
+header_field = (
+    r"(?P<field_name>{field_name})"
+    r":"
+    r"{OWS}"
+    r"(?P<field_value>{field_value})"
+    r"{OWS}".format(**globals())
+)
+
+# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#request.line
+#
+#   request-line   = method SP request-target SP HTTP-version CRLF
+#   method         = token
+#   HTTP-version   = HTTP-name "/" DIGIT "." DIGIT
+#   HTTP-name      = %x48.54.54.50 ; "HTTP", case-sensitive
+#
+# request-target is complicated (see RFC 7230 sec 5.3) -- could be path, full
+# URL, host+port (for connect), or even "*", but in any case we are guaranteed
+# that it contists of the visible printing characters.
+method = token
+request_target = r"{vchar}+".format(**globals())
+http_version = r"HTTP/(?P<http_version>[0-9]\.[0-9])"
+request_line = (
+    r"(?P<method>{method})"
+    r" "
+    r"(?P<target>{request_target})"
+    r" "
+    r"{http_version}".format(**globals())
+)
+
+# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#status.line
+#
+#   status-line = HTTP-version SP status-code SP reason-phrase CRLF
+#   status-code    = 3DIGIT
+#   reason-phrase  = *( HTAB / SP / VCHAR / obs-text )
+status_code = r"[0-9]{3}"
+reason_phrase = r"([ \t]|{vchar_or_obs_text})*".format(**globals())
+status_line = (
+    r"{http_version}"
+    r" "
+    r"(?P<status_code>{status_code})"
+    # However, there are apparently a few too many servers out there that just
+    # leave out the reason phrase:
+    #   https://github.com/scrapy/scrapy/issues/345#issuecomment-281756036
+    #   https://github.com/seanmonstar/httparse/issues/29
+    # so make it optional. ?: is a non-capturing group.
+    r"(?: (?P<reason>{reason_phrase}))?".format(**globals())
+)
+
+HEXDIG = r"[0-9A-Fa-f]"
+# Actually
+#
+#      chunk-size     = 1*HEXDIG
+#
+# but we impose an upper-limit to avoid ridiculosity. len(str(2**64)) == 20
+chunk_size = r"({HEXDIG}){{1,20}}".format(**globals())
+# Actually
+#
+#     chunk-ext      = *( ";" chunk-ext-name [ "=" chunk-ext-val ] )
+#
+# but we aren't parsing the things so we don't really care.
+chunk_ext = r";.*"
+chunk_header = (
+    r"(?P<chunk_size>{chunk_size})"
+    r"(?P<chunk_ext>{chunk_ext})?"
+    r"{OWS}\r\n".format(
+        **globals()
+    )  # Even though the specification does not allow for extra whitespaces,
+    # we are lenient with trailing whitespaces because some servers on the wild use it.
+)
diff --git a/llm/Lib/site-packages/h11/_connection.py b/llm/Lib/site-packages/h11/_connection.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1752707598154d190d69b2c26f3098b74656652
--- /dev/null
+++ b/llm/Lib/site-packages/h11/_connection.py
@@ -0,0 +1,633 @@
+# This contains the main Connection class. Everything in h11 revolves around
+# this.
+from typing import Any, Callable, cast, Dict, List, Optional, Tuple, Type, Union
+
+from ._events import (
+    ConnectionClosed,
+    Data,
+    EndOfMessage,
+    Event,
+    InformationalResponse,
+    Request,
+    Response,
+)
+from ._headers import get_comma_header, has_expect_100_continue, set_comma_header
+from ._readers import READERS, ReadersType
+from ._receivebuffer import ReceiveBuffer
+from ._state import (
+    _SWITCH_CONNECT,
+    _SWITCH_UPGRADE,
+    CLIENT,
+    ConnectionState,
+    DONE,
+    ERROR,
+    MIGHT_SWITCH_PROTOCOL,
+    SEND_BODY,
+    SERVER,
+    SWITCHED_PROTOCOL,
+)
+from ._util import (  # Import the internal things we need
+    LocalProtocolError,
+    RemoteProtocolError,
+    Sentinel,
+)
+from ._writers import WRITERS, WritersType
+
+# Everything in __all__ gets re-exported as part of the h11 public API.
+__all__ = ["Connection", "NEED_DATA", "PAUSED"]
+
+
+class NEED_DATA(Sentinel, metaclass=Sentinel):
+    pass
+
+
+class PAUSED(Sentinel, metaclass=Sentinel):
+    pass
+
+
+# If we ever have this much buffered without it making a complete parseable
+# event, we error out. The only time we really buffer is when reading the
+# request/response line + headers together, so this is effectively the limit on
+# the size of that.
+#
+# Some precedents for defaults:
+# - node.js: 80 * 1024
+# - tomcat: 8 * 1024
+# - IIS: 16 * 1024
+# - Apache: <8 KiB per line>
+DEFAULT_MAX_INCOMPLETE_EVENT_SIZE = 16 * 1024
+
+# RFC 7230's rules for connection lifecycles:
+# - If either side says they want to close the connection, then the connection
+#   must close.
+# - HTTP/1.1 defaults to keep-alive unless someone says Connection: close
+# - HTTP/1.0 defaults to close unless both sides say Connection: keep-alive
+#   (and even this is a mess -- e.g. if you're implementing a proxy then
+#   sending Connection: keep-alive is forbidden).
+#
+# We simplify life by simply not supporting keep-alive with HTTP/1.0 peers. So
+# our rule is:
+# - If someone says Connection: close, we will close
+# - If someone uses HTTP/1.0, we will close.
+def _keep_alive(event: Union[Request, Response]) -> bool:
+    connection = get_comma_header(event.headers, b"connection")
+    if b"close" in connection:
+        return False
+    if getattr(event, "http_version", b"1.1") < b"1.1":
+        return False
+    return True
+
+
+def _body_framing(
+    request_method: bytes, event: Union[Request, Response]
+) -> Tuple[str, Union[Tuple[()], Tuple[int]]]:
+    # Called when we enter SEND_BODY to figure out framing information for
+    # this body.
+    #
+    # These are the only two events that can trigger a SEND_BODY state:
+    assert type(event) in (Request, Response)
+    # Returns one of:
+    #
+    #    ("content-length", count)
+    #    ("chunked", ())
+    #    ("http/1.0", ())
+    #
+    # which are (lookup key, *args) for constructing body reader/writer
+    # objects.
+    #
+    # Reference: https://tools.ietf.org/html/rfc7230#section-3.3.3
+    #
+    # Step 1: some responses always have an empty body, regardless of what the
+    # headers say.
+    if type(event) is Response:
+        if (
+            event.status_code in (204, 304)
+            or request_method == b"HEAD"
+            or (request_method == b"CONNECT" and 200 <= event.status_code < 300)
+        ):
+            return ("content-length", (0,))
+        # Section 3.3.3 also lists another case -- responses with status_code
+        # < 200. For us these are InformationalResponses, not Responses, so
+        # they can't get into this function in the first place.
+        assert event.status_code >= 200
+
+    # Step 2: check for Transfer-Encoding (T-E beats C-L):
+    transfer_encodings = get_comma_header(event.headers, b"transfer-encoding")
+    if transfer_encodings:
+        assert transfer_encodings == [b"chunked"]
+        return ("chunked", ())
+
+    # Step 3: check for Content-Length
+    content_lengths = get_comma_header(event.headers, b"content-length")
+    if content_lengths:
+        return ("content-length", (int(content_lengths[0]),))
+
+    # Step 4: no applicable headers; fallback/default depends on type
+    if type(event) is Request:
+        return ("content-length", (0,))
+    else:
+        return ("http/1.0", ())
+
+
+################################################################
+#
+# The main Connection class
+#
+################################################################
+
+
+class Connection:
+    """An object encapsulating the state of an HTTP connection.
+
+    Args:
+        our_role: If you're implementing a client, pass :data:`h11.CLIENT`. If
+            you're implementing a server, pass :data:`h11.SERVER`.
+
+        max_incomplete_event_size (int):
+            The maximum number of bytes we're willing to buffer of an
+            incomplete event. In practice this mostly sets a limit on the
+            maximum size of the request/response line + headers. If this is
+            exceeded, then :meth:`next_event` will raise
+            :exc:`RemoteProtocolError`.
+
+    """
+
+    def __init__(
+        self,
+        our_role: Type[Sentinel],
+        max_incomplete_event_size: int = DEFAULT_MAX_INCOMPLETE_EVENT_SIZE,
+    ) -> None:
+        self._max_incomplete_event_size = max_incomplete_event_size
+        # State and role tracking
+        if our_role not in (CLIENT, SERVER):
+            raise ValueError("expected CLIENT or SERVER, not {!r}".format(our_role))
+        self.our_role = our_role
+        self.their_role: Type[Sentinel]
+        if our_role is CLIENT:
+            self.their_role = SERVER
+        else:
+            self.their_role = CLIENT
+        self._cstate = ConnectionState()
+
+        # Callables for converting data->events or vice-versa given the
+        # current state
+        self._writer = self._get_io_object(self.our_role, None, WRITERS)
+        self._reader = self._get_io_object(self.their_role, None, READERS)
+
+        # Holds any unprocessed received data
+        self._receive_buffer = ReceiveBuffer()
+        # If this is true, then it indicates that the incoming connection was
+        # closed *after* the end of whatever's in self._receive_buffer:
+        self._receive_buffer_closed = False
+
+        # Extra bits of state that don't fit into the state machine.
+        #
+        # These two are only used to interpret framing headers for figuring
+        # out how to read/write response bodies. their_http_version is also
+        # made available as a convenient public API.
+        self.their_http_version: Optional[bytes] = None
+        self._request_method: Optional[bytes] = None
+        # This is pure flow-control and doesn't at all affect the set of legal
+        # transitions, so no need to bother ConnectionState with it:
+        self.client_is_waiting_for_100_continue = False
+
+    @property
+    def states(self) -> Dict[Type[Sentinel], Type[Sentinel]]:
+        """A dictionary like::
+
+           {CLIENT: <client state>, SERVER: <server state>}
+
+        See :ref:`state-machine` for details.
+
+        """
+        return dict(self._cstate.states)
+
+    @property
+    def our_state(self) -> Type[Sentinel]:
+        """The current state of whichever role we are playing. See
+        :ref:`state-machine` for details.
+        """
+        return self._cstate.states[self.our_role]
+
+    @property
+    def their_state(self) -> Type[Sentinel]:
+        """The current state of whichever role we are NOT playing. See
+        :ref:`state-machine` for details.
+        """
+        return self._cstate.states[self.their_role]
+
+    @property
+    def they_are_waiting_for_100_continue(self) -> bool:
+        return self.their_role is CLIENT and self.client_is_waiting_for_100_continue
+
+    def start_next_cycle(self) -> None:
+        """Attempt to reset our connection state for a new request/response
+        cycle.
+
+        If both client and server are in :data:`DONE` state, then resets them
+        both to :data:`IDLE` state in preparation for a new request/response
+        cycle on this same connection. Otherwise, raises a
+        :exc:`LocalProtocolError`.
+
+        See :ref:`keepalive-and-pipelining`.
+
+        """
+        old_states = dict(self._cstate.states)
+        self._cstate.start_next_cycle()
+        self._request_method = None
+        # self.their_http_version gets left alone, since it presumably lasts
+        # beyond a single request/response cycle
+        assert not self.client_is_waiting_for_100_continue
+        self._respond_to_state_changes(old_states)
+
+    def _process_error(self, role: Type[Sentinel]) -> None:
+        old_states = dict(self._cstate.states)
+        self._cstate.process_error(role)
+        self._respond_to_state_changes(old_states)
+
+    def _server_switch_event(self, event: Event) -> Optional[Type[Sentinel]]:
+        if type(event) is InformationalResponse and event.status_code == 101:
+            return _SWITCH_UPGRADE
+        if type(event) is Response:
+            if (
+                _SWITCH_CONNECT in self._cstate.pending_switch_proposals
+                and 200 <= event.status_code < 300
+            ):
+                return _SWITCH_CONNECT
+        return None
+
+    # All events go through here
+    def _process_event(self, role: Type[Sentinel], event: Event) -> None:
+        # First, pass the event through the state machine to make sure it
+        # succeeds.
+        old_states = dict(self._cstate.states)
+        if role is CLIENT and type(event) is Request:
+            if event.method == b"CONNECT":
+                self._cstate.process_client_switch_proposal(_SWITCH_CONNECT)
+            if get_comma_header(event.headers, b"upgrade"):
+                self._cstate.process_client_switch_proposal(_SWITCH_UPGRADE)
+        server_switch_event = None
+        if role is SERVER:
+            server_switch_event = self._server_switch_event(event)
+        self._cstate.process_event(role, type(event), server_switch_event)
+
+        # Then perform the updates triggered by it.
+
+        if type(event) is Request:
+            self._request_method = event.method
+
+        if role is self.their_role and type(event) in (
+            Request,
+            Response,
+            InformationalResponse,
+        ):
+            event = cast(Union[Request, Response, InformationalResponse], event)
+            self.their_http_version = event.http_version
+
+        # Keep alive handling
+        #
+        # RFC 7230 doesn't really say what one should do if Connection: close
+        # shows up on a 1xx InformationalResponse. I think the idea is that
+        # this is not supposed to happen. In any case, if it does happen, we
+        # ignore it.
+        if type(event) in (Request, Response) and not _keep_alive(
+            cast(Union[Request, Response], event)
+        ):
+            self._cstate.process_keep_alive_disabled()
+
+        # 100-continue
+        if type(event) is Request and has_expect_100_continue(event):
+            self.client_is_waiting_for_100_continue = True
+        if type(event) in (InformationalResponse, Response):
+            self.client_is_waiting_for_100_continue = False
+        if role is CLIENT and type(event) in (Data, EndOfMessage):
+            self.client_is_waiting_for_100_continue = False
+
+        self._respond_to_state_changes(old_states, event)
+
+    def _get_io_object(
+        self,
+        role: Type[Sentinel],
+        event: Optional[Event],
+        io_dict: Union[ReadersType, WritersType],
+    ) -> Optional[Callable[..., Any]]:
+        # event may be None; it's only used when entering SEND_BODY
+        state = self._cstate.states[role]
+        if state is SEND_BODY:
+            # Special case: the io_dict has a dict of reader/writer factories
+            # that depend on the request/response framing.
+            framing_type, args = _body_framing(
+                cast(bytes, self._request_method), cast(Union[Request, Response], event)
+            )
+            return io_dict[SEND_BODY][framing_type](*args)  # type: ignore[index]
+        else:
+            # General case: the io_dict just has the appropriate reader/writer
+            # for this state
+            return io_dict.get((role, state))  # type: ignore[return-value]
+
+    # This must be called after any action that might have caused
+    # self._cstate.states to change.
+    def _respond_to_state_changes(
+        self,
+        old_states: Dict[Type[Sentinel], Type[Sentinel]],
+        event: Optional[Event] = None,
+    ) -> None:
+        # Update reader/writer
+        if self.our_state != old_states[self.our_role]:
+            self._writer = self._get_io_object(self.our_role, event, WRITERS)
+        if self.their_state != old_states[self.their_role]:
+            self._reader = self._get_io_object(self.their_role, event, READERS)
+
+    @property
+    def trailing_data(self) -> Tuple[bytes, bool]:
+        """Data that has been received, but not yet processed, represented as
+        a tuple with two elements, where the first is a byte-string containing
+        the unprocessed data itself, and the second is a bool that is True if
+        the receive connection was closed.
+
+        See :ref:`switching-protocols` for discussion of why you'd want this.
+        """
+        return (bytes(self._receive_buffer), self._receive_buffer_closed)
+
+    def receive_data(self, data: bytes) -> None:
+        """Add data to our internal receive buffer.
+
+        This does not actually do any processing on the data, just stores
+        it. To trigger processing, you have to call :meth:`next_event`.
+
+        Args:
+            data (:term:`bytes-like object`):
+                The new data that was just received.
+
+                Special case: If *data* is an empty byte-string like ``b""``,
+                then this indicates that the remote side has closed the
+                connection (end of file). Normally this is convenient, because
+                standard Python APIs like :meth:`file.read` or
+                :meth:`socket.recv` use ``b""`` to indicate end-of-file, while
+                other failures to read are indicated using other mechanisms
+                like raising :exc:`TimeoutError`. When using such an API you
+                can just blindly pass through whatever you get from ``read``
+                to :meth:`receive_data`, and everything will work.
+
+                But, if you have an API where reading an empty string is a
+                valid non-EOF condition, then you need to be aware of this and
+                make sure to check for such strings and avoid passing them to
+                :meth:`receive_data`.
+
+        Returns:
+            Nothing, but after calling this you should call :meth:`next_event`
+            to parse the newly received data.
+
+        Raises:
+            RuntimeError:
+                Raised if you pass an empty *data*, indicating EOF, and then
+                pass a non-empty *data*, indicating more data that somehow
+                arrived after the EOF.
+
+                (Calling ``receive_data(b"")`` multiple times is fine,
+                and equivalent to calling it once.)
+
+        """
+        if data:
+            if self._receive_buffer_closed:
+                raise RuntimeError("received close, then received more data?")
+            self._receive_buffer += data
+        else:
+            self._receive_buffer_closed = True
+
+    def _extract_next_receive_event(
+        self,
+    ) -> Union[Event, Type[NEED_DATA], Type[PAUSED]]:
+        state = self.their_state
+        # We don't pause immediately when they enter DONE, because even in
+        # DONE state we can still process a ConnectionClosed() event. But
+        # if we have data in our buffer, then we definitely aren't getting
+        # a ConnectionClosed() immediately and we need to pause.
+        if state is DONE and self._receive_buffer:
+            return PAUSED
+        if state is MIGHT_SWITCH_PROTOCOL or state is SWITCHED_PROTOCOL:
+            return PAUSED
+        assert self._reader is not None
+        event = self._reader(self._receive_buffer)
+        if event is None:
+            if not self._receive_buffer and self._receive_buffer_closed:
+                # In some unusual cases (basically just HTTP/1.0 bodies), EOF
+                # triggers an actual protocol event; in that case, we want to
+                # return that event, and then the state will change and we'll
+                # get called again to generate the actual ConnectionClosed().
+                if hasattr(self._reader, "read_eof"):
+                    event = self._reader.read_eof()  # type: ignore[attr-defined]
+                else:
+                    event = ConnectionClosed()
+        if event is None:
+            event = NEED_DATA
+        return event  # type: ignore[no-any-return]
+
+    def next_event(self) -> Union[Event, Type[NEED_DATA], Type[PAUSED]]:
+        """Parse the next event out of our receive buffer, update our internal
+        state, and return it.
+
+        This is a mutating operation -- think of it like calling :func:`next`
+        on an iterator.
+
+        Returns:
+            : One of three things:
+
+            1) An event object -- see :ref:`events`.
+
+            2) The special constant :data:`NEED_DATA`, which indicates that
+               you need to read more data from your socket and pass it to
+               :meth:`receive_data` before this method will be able to return
+               any more events.
+
+            3) The special constant :data:`PAUSED`, which indicates that we
+               are not in a state where we can process incoming data (usually
+               because the peer has finished their part of the current
+               request/response cycle, and you have not yet called
+               :meth:`start_next_cycle`). See :ref:`flow-control` for details.
+
+        Raises:
+            RemoteProtocolError:
+                The peer has misbehaved. You should close the connection
+                (possibly after sending some kind of 4xx response).
+
+        Once this method returns :class:`ConnectionClosed` once, then all
+        subsequent calls will also return :class:`ConnectionClosed`.
+
+        If this method raises any exception besides :exc:`RemoteProtocolError`
+        then that's a bug -- if it happens please file a bug report!
+
+        If this method raises any exception then it also sets
+        :attr:`Connection.their_state` to :data:`ERROR` -- see
+        :ref:`error-handling` for discussion.
+
+        """
+
+        if self.their_state is ERROR:
+            raise RemoteProtocolError("Can't receive data when peer state is ERROR")
+        try:
+            event = self._extract_next_receive_event()
+            if event not in [NEED_DATA, PAUSED]:
+                self._process_event(self.their_role, cast(Event, event))
+            if event is NEED_DATA:
+                if len(self._receive_buffer) > self._max_incomplete_event_size:
+                    # 431 is "Request header fields too large" which is pretty
+                    # much the only situation where we can get here
+                    raise RemoteProtocolError(
+                        "Receive buffer too long", error_status_hint=431
+                    )
+                if self._receive_buffer_closed:
+                    # We're still trying to complete some event, but that's
+                    # never going to happen because no more data is coming
+                    raise RemoteProtocolError("peer unexpectedly closed connection")
+            return event
+        except BaseException as exc:
+            self._process_error(self.their_role)
+            if isinstance(exc, LocalProtocolError):
+                exc._reraise_as_remote_protocol_error()
+            else:
+                raise
+
+    def send(self, event: Event) -> Optional[bytes]:
+        """Convert a high-level event into bytes that can be sent to the peer,
+        while updating our internal state machine.
+
+        Args:
+            event: The :ref:`event <events>` to send.
+
+        Returns:
+            If ``type(event) is ConnectionClosed``, then returns
+            ``None``. Otherwise, returns a :term:`bytes-like object`.
+
+        Raises:
+            LocalProtocolError:
+                Sending this event at this time would violate our
+                understanding of the HTTP/1.1 protocol.
+
+        If this method raises any exception then it also sets
+        :attr:`Connection.our_state` to :data:`ERROR` -- see
+        :ref:`error-handling` for discussion.
+
+        """
+        data_list = self.send_with_data_passthrough(event)
+        if data_list is None:
+            return None
+        else:
+            return b"".join(data_list)
+
+    def send_with_data_passthrough(self, event: Event) -> Optional[List[bytes]]:
+        """Identical to :meth:`send`, except that in situations where
+        :meth:`send` returns a single :term:`bytes-like object`, this instead
+        returns a list of them -- and when sending a :class:`Data` event, this
+        list is guaranteed to contain the exact object you passed in as
+        :attr:`Data.data`. See :ref:`sendfile` for discussion.
+
+        """
+        if self.our_state is ERROR:
+            raise LocalProtocolError("Can't send data when our state is ERROR")
+        try:
+            if type(event) is Response:
+                event = self._clean_up_response_headers_for_sending(event)
+            # We want to call _process_event before calling the writer,
+            # because if someone tries to do something invalid then this will
+            # give a sensible error message, while our writers all just assume
+            # they will only receive valid events. But, _process_event might
+            # change self._writer. So we have to do a little dance:
+            writer = self._writer
+            self._process_event(self.our_role, event)
+            if type(event) is ConnectionClosed:
+                return None
+            else:
+                # In any situation where writer is None, process_event should
+                # have raised ProtocolError
+                assert writer is not None
+                data_list: List[bytes] = []
+                writer(event, data_list.append)
+                return data_list
+        except:
+            self._process_error(self.our_role)
+            raise
+
+    def send_failed(self) -> None:
+        """Notify the state machine that we failed to send the data it gave
+        us.
+
+        This causes :attr:`Connection.our_state` to immediately become
+        :data:`ERROR` -- see :ref:`error-handling` for discussion.
+
+        """
+        self._process_error(self.our_role)
+
+    # When sending a Response, we take responsibility for a few things:
+    #
+    # - Sometimes you MUST set Connection: close. We take care of those
+    #   times. (You can also set it yourself if you want, and if you do then
+    #   we'll respect that and close the connection at the right time. But you
+    #   don't have to worry about that unless you want to.)
+    #
+    # - The user has to set Content-Length if they want it. Otherwise, for
+    #   responses that have bodies (e.g. not HEAD), then we will automatically
+    #   select the right mechanism for streaming a body of unknown length,
+    #   which depends on depending on the peer's HTTP version.
+    #
+    # This function's *only* responsibility is making sure headers are set up
+    # right -- everything downstream just looks at the headers. There are no
+    # side channels.
+    def _clean_up_response_headers_for_sending(self, response: Response) -> Response:
+        assert type(response) is Response
+
+        headers = response.headers
+        need_close = False
+
+        # HEAD requests need some special handling: they always act like they
+        # have Content-Length: 0, and that's how _body_framing treats
+        # them. But their headers are supposed to match what we would send if
+        # the request was a GET. (Technically there is one deviation allowed:
+        # we're allowed to leave out the framing headers -- see
+        # https://tools.ietf.org/html/rfc7231#section-4.3.2 . But it's just as
+        # easy to get them right.)
+        method_for_choosing_headers = cast(bytes, self._request_method)
+        if method_for_choosing_headers == b"HEAD":
+            method_for_choosing_headers = b"GET"
+        framing_type, _ = _body_framing(method_for_choosing_headers, response)
+        if framing_type in ("chunked", "http/1.0"):
+            # This response has a body of unknown length.
+            # If our peer is HTTP/1.1, we use Transfer-Encoding: chunked
+            # If our peer is HTTP/1.0, we use no framing headers, and close the
+            # connection afterwards.
+            #
+            # Make sure to clear Content-Length (in principle user could have
+            # set both and then we ignored Content-Length b/c
+            # Transfer-Encoding overwrote it -- this would be naughty of them,
+            # but the HTTP spec says that if our peer does this then we have
+            # to fix it instead of erroring out, so we'll accord the user the
+            # same respect).
+            headers = set_comma_header(headers, b"content-length", [])
+            if self.their_http_version is None or self.their_http_version < b"1.1":
+                # Either we never got a valid request and are sending back an
+                # error (their_http_version is None), so we assume the worst;
+                # or else we did get a valid HTTP/1.0 request, so we know that
+                # they don't understand chunked encoding.
+                headers = set_comma_header(headers, b"transfer-encoding", [])
+                # This is actually redundant ATM, since currently we
+                # unconditionally disable keep-alive when talking to HTTP/1.0
+                # peers. But let's be defensive just in case we add
+                # Connection: keep-alive support later:
+                if self._request_method != b"HEAD":
+                    need_close = True
+            else:
+                headers = set_comma_header(headers, b"transfer-encoding", [b"chunked"])
+
+        if not self._cstate.keep_alive or need_close:
+            # Make sure Connection: close is set
+            connection = set(get_comma_header(headers, b"connection"))
+            connection.discard(b"keep-alive")
+            connection.add(b"close")
+            headers = set_comma_header(headers, b"connection", sorted(connection))
+
+        return Response(
+            headers=headers,
+            status_code=response.status_code,
+            http_version=response.http_version,
+            reason=response.reason,
+        )
diff --git a/llm/Lib/site-packages/h11/_events.py b/llm/Lib/site-packages/h11/_events.py
new file mode 100644
index 0000000000000000000000000000000000000000..075bf8a469d44d2388b08ec3d009fe55d44cb6eb
--- /dev/null
+++ b/llm/Lib/site-packages/h11/_events.py
@@ -0,0 +1,369 @@
+# High level events that make up HTTP/1.1 conversations. Loosely inspired by
+# the corresponding events in hyper-h2:
+#
+#     http://python-hyper.org/h2/en/stable/api.html#events
+#
+# Don't subclass these. Stuff will break.
+
+import re
+from abc import ABC
+from dataclasses import dataclass, field
+from typing import Any, cast, Dict, List, Tuple, Union
+
+from ._abnf import method, request_target
+from ._headers import Headers, normalize_and_validate
+from ._util import bytesify, LocalProtocolError, validate
+
+# Everything in __all__ gets re-exported as part of the h11 public API.
+__all__ = [
+    "Event",
+    "Request",
+    "InformationalResponse",
+    "Response",
+    "Data",
+    "EndOfMessage",
+    "ConnectionClosed",
+]
+
+method_re = re.compile(method.encode("ascii"))
+request_target_re = re.compile(request_target.encode("ascii"))
+
+
+class Event(ABC):
+    """
+    Base class for h11 events.
+    """
+
+    __slots__ = ()
+
+
+@dataclass(init=False, frozen=True)
+class Request(Event):
+    """The beginning of an HTTP request.
+
+    Fields:
+
+    .. attribute:: method
+
+       An HTTP method, e.g. ``b"GET"`` or ``b"POST"``. Always a byte
+       string. :term:`Bytes-like objects <bytes-like object>` and native
+       strings containing only ascii characters will be automatically
+       converted to byte strings.
+
+    .. attribute:: target
+
+       The target of an HTTP request, e.g. ``b"/index.html"``, or one of the
+       more exotic formats described in `RFC 7320, section 5.3
+       <https://tools.ietf.org/html/rfc7230#section-5.3>`_. Always a byte
+       string. :term:`Bytes-like objects <bytes-like object>` and native
+       strings containing only ascii characters will be automatically
+       converted to byte strings.
+
+    .. attribute:: headers
+
+       Request headers, represented as a list of (name, value) pairs. See
+       :ref:`the header normalization rules <headers-format>` for details.
+
+    .. attribute:: http_version
+
+       The HTTP protocol version, represented as a byte string like
+       ``b"1.1"``. See :ref:`the HTTP version normalization rules
+       <http_version-format>` for details.
+
+    """
+
+    __slots__ = ("method", "headers", "target", "http_version")
+
+    method: bytes
+    headers: Headers
+    target: bytes
+    http_version: bytes
+
+    def __init__(
+        self,
+        *,
+        method: Union[bytes, str],
+        headers: Union[Headers, List[Tuple[bytes, bytes]], List[Tuple[str, str]]],
+        target: Union[bytes, str],
+        http_version: Union[bytes, str] = b"1.1",
+        _parsed: bool = False,
+    ) -> None:
+        super().__init__()
+        if isinstance(headers, Headers):
+            object.__setattr__(self, "headers", headers)
+        else:
+            object.__setattr__(
+                self, "headers", normalize_and_validate(headers, _parsed=_parsed)
+            )
+        if not _parsed:
+            object.__setattr__(self, "method", bytesify(method))
+            object.__setattr__(self, "target", bytesify(target))
+            object.__setattr__(self, "http_version", bytesify(http_version))
+        else:
+            object.__setattr__(self, "method", method)
+            object.__setattr__(self, "target", target)
+            object.__setattr__(self, "http_version", http_version)
+
+        # "A server MUST respond with a 400 (Bad Request) status code to any
+        # HTTP/1.1 request message that lacks a Host header field and to any
+        # request message that contains more than one Host header field or a
+        # Host header field with an invalid field-value."
+        # -- https://tools.ietf.org/html/rfc7230#section-5.4
+        host_count = 0
+        for name, value in self.headers:
+            if name == b"host":
+                host_count += 1
+        if self.http_version == b"1.1" and host_count == 0:
+            raise LocalProtocolError("Missing mandatory Host: header")
+        if host_count > 1:
+            raise LocalProtocolError("Found multiple Host: headers")
+
+        validate(method_re, self.method, "Illegal method characters")
+        validate(request_target_re, self.target, "Illegal target characters")
+
+    # This is an unhashable type.
+    __hash__ = None  # type: ignore
+
+
+@dataclass(init=False, frozen=True)
+class _ResponseBase(Event):
+    __slots__ = ("headers", "http_version", "reason", "status_code")
+
+    headers: Headers
+    http_version: bytes
+    reason: bytes
+    status_code: int
+
+    def __init__(
+        self,
+        *,
+        headers: Union[Headers, List[Tuple[bytes, bytes]], List[Tuple[str, str]]],
+        status_code: int,
+        http_version: Union[bytes, str] = b"1.1",
+        reason: Union[bytes, str] = b"",
+        _parsed: bool = False,
+    ) -> None:
+        super().__init__()
+        if isinstance(headers, Headers):
+            object.__setattr__(self, "headers", headers)
+        else:
+            object.__setattr__(
+                self, "headers", normalize_and_validate(headers, _parsed=_parsed)
+            )
+        if not _parsed:
+            object.__setattr__(self, "reason", bytesify(reason))
+            object.__setattr__(self, "http_version", bytesify(http_version))
+            if not isinstance(status_code, int):
+                raise LocalProtocolError("status code must be integer")
+            # Because IntEnum objects are instances of int, but aren't
+            # duck-compatible (sigh), see gh-72.
+            object.__setattr__(self, "status_code", int(status_code))
+        else:
+            object.__setattr__(self, "reason", reason)
+            object.__setattr__(self, "http_version", http_version)
+            object.__setattr__(self, "status_code", status_code)
+
+        self.__post_init__()
+
+    def __post_init__(self) -> None:
+        pass
+
+    # This is an unhashable type.
+    __hash__ = None  # type: ignore
+
+
+@dataclass(init=False, frozen=True)
+class InformationalResponse(_ResponseBase):
+    """An HTTP informational response.
+
+    Fields:
+
+    .. attribute:: status_code
+
+       The status code of this response, as an integer. For an
+       :class:`InformationalResponse`, this is always in the range [100,
+       200).
+
+    .. attribute:: headers
+
+       Request headers, represented as a list of (name, value) pairs. See
+       :ref:`the header normalization rules <headers-format>` for
+       details.
+
+    .. attribute:: http_version
+
+       The HTTP protocol version, represented as a byte string like
+       ``b"1.1"``. See :ref:`the HTTP version normalization rules
+       <http_version-format>` for details.
+
+    .. attribute:: reason
+
+       The reason phrase of this response, as a byte string. For example:
+       ``b"OK"``, or ``b"Not Found"``.
+
+    """
+
+    def __post_init__(self) -> None:
+        if not (100 <= self.status_code < 200):
+            raise LocalProtocolError(
+                "InformationalResponse status_code should be in range "
+                "[100, 200), not {}".format(self.status_code)
+            )
+
+    # This is an unhashable type.
+    __hash__ = None  # type: ignore
+
+
+@dataclass(init=False, frozen=True)
+class Response(_ResponseBase):
+    """The beginning of an HTTP response.
+
+    Fields:
+
+    .. attribute:: status_code
+
+       The status code of this response, as an integer. For an
+       :class:`Response`, this is always in the range [200,
+       1000).
+
+    .. attribute:: headers
+
+       Request headers, represented as a list of (name, value) pairs. See
+       :ref:`the header normalization rules <headers-format>` for details.
+
+    .. attribute:: http_version
+
+       The HTTP protocol version, represented as a byte string like
+       ``b"1.1"``. See :ref:`the HTTP version normalization rules
+       <http_version-format>` for details.
+
+    .. attribute:: reason
+
+       The reason phrase of this response, as a byte string. For example:
+       ``b"OK"``, or ``b"Not Found"``.
+
+    """
+
+    def __post_init__(self) -> None:
+        if not (200 <= self.status_code < 1000):
+            raise LocalProtocolError(
+                "Response status_code should be in range [200, 1000), not {}".format(
+                    self.status_code
+                )
+            )
+
+    # This is an unhashable type.
+    __hash__ = None  # type: ignore
+
+
+@dataclass(init=False, frozen=True)
+class Data(Event):
+    """Part of an HTTP message body.
+
+    Fields:
+
+    .. attribute:: data
+
+       A :term:`bytes-like object` containing part of a message body. Or, if
+       using the ``combine=False`` argument to :meth:`Connection.send`, then
+       any object that your socket writing code knows what to do with, and for
+       which calling :func:`len` returns the number of bytes that will be
+       written -- see :ref:`sendfile` for details.
+
+    .. attribute:: chunk_start
+
+       A marker that indicates whether this data object is from the start of a
+       chunked transfer encoding chunk. This field is ignored when when a Data
+       event is provided to :meth:`Connection.send`: it is only valid on
+       events emitted from :meth:`Connection.next_event`. You probably
+       shouldn't use this attribute at all; see
+       :ref:`chunk-delimiters-are-bad` for details.
+
+    .. attribute:: chunk_end
+
+       A marker that indicates whether this data object is the last for a
+       given chunked transfer encoding chunk. This field is ignored when when
+       a Data event is provided to :meth:`Connection.send`: it is only valid
+       on events emitted from :meth:`Connection.next_event`. You probably
+       shouldn't use this attribute at all; see
+       :ref:`chunk-delimiters-are-bad` for details.
+
+    """
+
+    __slots__ = ("data", "chunk_start", "chunk_end")
+
+    data: bytes
+    chunk_start: bool
+    chunk_end: bool
+
+    def __init__(
+        self, data: bytes, chunk_start: bool = False, chunk_end: bool = False
+    ) -> None:
+        object.__setattr__(self, "data", data)
+        object.__setattr__(self, "chunk_start", chunk_start)
+        object.__setattr__(self, "chunk_end", chunk_end)
+
+    # This is an unhashable type.
+    __hash__ = None  # type: ignore
+
+
+# XX FIXME: "A recipient MUST ignore (or consider as an error) any fields that
+# are forbidden to be sent in a trailer, since processing them as if they were
+# present in the header section might bypass external security filters."
+# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#chunked.trailer.part
+# Unfortunately, the list of forbidden fields is long and vague :-/
+@dataclass(init=False, frozen=True)
+class EndOfMessage(Event):
+    """The end of an HTTP message.
+
+    Fields:
+
+    .. attribute:: headers
+
+       Default value: ``[]``
+
+       Any trailing headers attached to this message, represented as a list of
+       (name, value) pairs. See :ref:`the header normalization rules
+       <headers-format>` for details.
+
+       Must be empty unless ``Transfer-Encoding: chunked`` is in use.
+
+    """
+
+    __slots__ = ("headers",)
+
+    headers: Headers
+
+    def __init__(
+        self,
+        *,
+        headers: Union[
+            Headers, List[Tuple[bytes, bytes]], List[Tuple[str, str]], None
+        ] = None,
+        _parsed: bool = False,
+    ) -> None:
+        super().__init__()
+        if headers is None:
+            headers = Headers([])
+        elif not isinstance(headers, Headers):
+            headers = normalize_and_validate(headers, _parsed=_parsed)
+
+        object.__setattr__(self, "headers", headers)
+
+    # This is an unhashable type.
+    __hash__ = None  # type: ignore
+
+
+@dataclass(frozen=True)
+class ConnectionClosed(Event):
+    """This event indicates that the sender has closed their outgoing
+    connection.
+
+    Note that this does not necessarily mean that they can't *receive* further
+    data, because TCP connections are composed to two one-way channels which
+    can be closed independently. See :ref:`closing` for details.
+
+    No fields.
+    """
+
+    pass
diff --git a/llm/Lib/site-packages/h11/_headers.py b/llm/Lib/site-packages/h11/_headers.py
new file mode 100644
index 0000000000000000000000000000000000000000..b97d020b634a9f47f5ae6aa3b30e2bd13a6c48c4
--- /dev/null
+++ b/llm/Lib/site-packages/h11/_headers.py
@@ -0,0 +1,278 @@
+import re
+from typing import AnyStr, cast, List, overload, Sequence, Tuple, TYPE_CHECKING, Union
+
+from ._abnf import field_name, field_value
+from ._util import bytesify, LocalProtocolError, validate
+
+if TYPE_CHECKING:
+    from ._events import Request
+
+try:
+    from typing import Literal
+except ImportError:
+    from typing_extensions import Literal  # type: ignore
+
+
+# Facts
+# -----
+#
+# Headers are:
+#   keys: case-insensitive ascii
+#   values: mixture of ascii and raw bytes
+#
+# "Historically, HTTP has allowed field content with text in the ISO-8859-1
+# charset [ISO-8859-1], supporting other charsets only through use of
+# [RFC2047] encoding.  In practice, most HTTP header field values use only a
+# subset of the US-ASCII charset [USASCII]. Newly defined header fields SHOULD
+# limit their field values to US-ASCII octets.  A recipient SHOULD treat other
+# octets in field content (obs-text) as opaque data."
+# And it deprecates all non-ascii values
+#
+# Leading/trailing whitespace in header names is forbidden
+#
+# Values get leading/trailing whitespace stripped
+#
+# Content-Disposition actually needs to contain unicode semantically; to
+# accomplish this it has a terrifically weird way of encoding the filename
+# itself as ascii (and even this still has lots of cross-browser
+# incompatibilities)
+#
+# Order is important:
+# "a proxy MUST NOT change the order of these field values when forwarding a
+# message"
+# (and there are several headers where the order indicates a preference)
+#
+# Multiple occurences of the same header:
+# "A sender MUST NOT generate multiple header fields with the same field name
+# in a message unless either the entire field value for that header field is
+# defined as a comma-separated list [or the header is Set-Cookie which gets a
+# special exception]" - RFC 7230. (cookies are in RFC 6265)
+#
+# So every header aside from Set-Cookie can be merged by b", ".join if it
+# occurs repeatedly. But, of course, they can't necessarily be split by
+# .split(b","), because quoting.
+#
+# Given all this mess (case insensitive, duplicates allowed, order is
+# important, ...), there doesn't appear to be any standard way to handle
+# headers in Python -- they're almost like dicts, but... actually just
+# aren't. For now we punt and just use a super simple representation: headers
+# are a list of pairs
+#
+#   [(name1, value1), (name2, value2), ...]
+#
+# where all entries are bytestrings, names are lowercase and have no
+# leading/trailing whitespace, and values are bytestrings with no
+# leading/trailing whitespace. Searching and updating are done via naive O(n)
+# methods.
+#
+# Maybe a dict-of-lists would be better?
+
+_content_length_re = re.compile(rb"[0-9]+")
+_field_name_re = re.compile(field_name.encode("ascii"))
+_field_value_re = re.compile(field_value.encode("ascii"))
+
+
+class Headers(Sequence[Tuple[bytes, bytes]]):
+    """
+    A list-like interface that allows iterating over headers as byte-pairs
+    of (lowercased-name, value).
+
+    Internally we actually store the representation as three-tuples,
+    including both the raw original casing, in order to preserve casing
+    over-the-wire, and the lowercased name, for case-insensitive comparisions.
+
+    r = Request(
+        method="GET",
+        target="/",
+        headers=[("Host", "example.org"), ("Connection", "keep-alive")],
+        http_version="1.1",
+    )
+    assert r.headers == [
+        (b"host", b"example.org"),
+        (b"connection", b"keep-alive")
+    ]
+    assert r.headers.raw_items() == [
+        (b"Host", b"example.org"),
+        (b"Connection", b"keep-alive")
+    ]
+    """
+
+    __slots__ = "_full_items"
+
+    def __init__(self, full_items: List[Tuple[bytes, bytes, bytes]]) -> None:
+        self._full_items = full_items
+
+    def __bool__(self) -> bool:
+        return bool(self._full_items)
+
+    def __eq__(self, other: object) -> bool:
+        return list(self) == list(other)  # type: ignore
+
+    def __len__(self) -> int:
+        return len(self._full_items)
+
+    def __repr__(self) -> str:
+        return "<Headers(%s)>" % repr(list(self))
+
+    def __getitem__(self, idx: int) -> Tuple[bytes, bytes]:  # type: ignore[override]
+        _, name, value = self._full_items[idx]
+        return (name, value)
+
+    def raw_items(self) -> List[Tuple[bytes, bytes]]:
+        return [(raw_name, value) for raw_name, _, value in self._full_items]
+
+
+HeaderTypes = Union[
+    List[Tuple[bytes, bytes]],
+    List[Tuple[bytes, str]],
+    List[Tuple[str, bytes]],
+    List[Tuple[str, str]],
+]
+
+
+@overload
+def normalize_and_validate(headers: Headers, _parsed: Literal[True]) -> Headers:
+    ...
+
+
+@overload
+def normalize_and_validate(headers: HeaderTypes, _parsed: Literal[False]) -> Headers:
+    ...
+
+
+@overload
+def normalize_and_validate(
+    headers: Union[Headers, HeaderTypes], _parsed: bool = False
+) -> Headers:
+    ...
+
+
+def normalize_and_validate(
+    headers: Union[Headers, HeaderTypes], _parsed: bool = False
+) -> Headers:
+    new_headers = []
+    seen_content_length = None
+    saw_transfer_encoding = False
+    for name, value in headers:
+        # For headers coming out of the parser, we can safely skip some steps,
+        # because it always returns bytes and has already run these regexes
+        # over the data:
+        if not _parsed:
+            name = bytesify(name)
+            value = bytesify(value)
+            validate(_field_name_re, name, "Illegal header name {!r}", name)
+            validate(_field_value_re, value, "Illegal header value {!r}", value)
+        assert isinstance(name, bytes)
+        assert isinstance(value, bytes)
+
+        raw_name = name
+        name = name.lower()
+        if name == b"content-length":
+            lengths = {length.strip() for length in value.split(b",")}
+            if len(lengths) != 1:
+                raise LocalProtocolError("conflicting Content-Length headers")
+            value = lengths.pop()
+            validate(_content_length_re, value, "bad Content-Length")
+            if seen_content_length is None:
+                seen_content_length = value
+                new_headers.append((raw_name, name, value))
+            elif seen_content_length != value:
+                raise LocalProtocolError("conflicting Content-Length headers")
+        elif name == b"transfer-encoding":
+            # "A server that receives a request message with a transfer coding
+            # it does not understand SHOULD respond with 501 (Not
+            # Implemented)."
+            # https://tools.ietf.org/html/rfc7230#section-3.3.1
+            if saw_transfer_encoding:
+                raise LocalProtocolError(
+                    "multiple Transfer-Encoding headers", error_status_hint=501
+                )
+            # "All transfer-coding names are case-insensitive"
+            # -- https://tools.ietf.org/html/rfc7230#section-4
+            value = value.lower()
+            if value != b"chunked":
+                raise LocalProtocolError(
+                    "Only Transfer-Encoding: chunked is supported",
+                    error_status_hint=501,
+                )
+            saw_transfer_encoding = True
+            new_headers.append((raw_name, name, value))
+        else:
+            new_headers.append((raw_name, name, value))
+    return Headers(new_headers)
+
+
+def get_comma_header(headers: Headers, name: bytes) -> List[bytes]:
+    # Should only be used for headers whose value is a list of
+    # comma-separated, case-insensitive values.
+    #
+    # The header name `name` is expected to be lower-case bytes.
+    #
+    # Connection: meets these criteria (including cast insensitivity).
+    #
+    # Content-Length: technically is just a single value (1*DIGIT), but the
+    # standard makes reference to implementations that do multiple values, and
+    # using this doesn't hurt. Ditto, case insensitivity doesn't things either
+    # way.
+    #
+    # Transfer-Encoding: is more complex (allows for quoted strings), so
+    # splitting on , is actually wrong. For example, this is legal:
+    #
+    #    Transfer-Encoding: foo; options="1,2", chunked
+    #
+    # and should be parsed as
+    #
+    #    foo; options="1,2"
+    #    chunked
+    #
+    # but this naive function will parse it as
+    #
+    #    foo; options="1
+    #    2"
+    #    chunked
+    #
+    # However, this is okay because the only thing we are going to do with
+    # any Transfer-Encoding is reject ones that aren't just "chunked", so
+    # both of these will be treated the same anyway.
+    #
+    # Expect: the only legal value is the literal string
+    # "100-continue". Splitting on commas is harmless. Case insensitive.
+    #
+    out: List[bytes] = []
+    for _, found_name, found_raw_value in headers._full_items:
+        if found_name == name:
+            found_raw_value = found_raw_value.lower()
+            for found_split_value in found_raw_value.split(b","):
+                found_split_value = found_split_value.strip()
+                if found_split_value:
+                    out.append(found_split_value)
+    return out
+
+
+def set_comma_header(headers: Headers, name: bytes, new_values: List[bytes]) -> Headers:
+    # The header name `name` is expected to be lower-case bytes.
+    #
+    # Note that when we store the header we use title casing for the header
+    # names, in order to match the conventional HTTP header style.
+    #
+    # Simply calling `.title()` is a blunt approach, but it's correct
+    # here given the cases where we're using `set_comma_header`...
+    #
+    # Connection, Content-Length, Transfer-Encoding.
+    new_headers: List[Tuple[bytes, bytes]] = []
+    for found_raw_name, found_name, found_raw_value in headers._full_items:
+        if found_name != name:
+            new_headers.append((found_raw_name, found_raw_value))
+    for new_value in new_values:
+        new_headers.append((name.title(), new_value))
+    return normalize_and_validate(new_headers)
+
+
+def has_expect_100_continue(request: "Request") -> bool:
+    # https://tools.ietf.org/html/rfc7231#section-5.1.1
+    # "A server that receives a 100-continue expectation in an HTTP/1.0 request
+    # MUST ignore that expectation."
+    if request.http_version < b"1.1":
+        return False
+    expect = get_comma_header(request.headers, b"expect")
+    return b"100-continue" in expect
diff --git a/llm/Lib/site-packages/h11/_readers.py b/llm/Lib/site-packages/h11/_readers.py
new file mode 100644
index 0000000000000000000000000000000000000000..08a9574da4a89d82dfb71b3087b14c8644102dd6
--- /dev/null
+++ b/llm/Lib/site-packages/h11/_readers.py
@@ -0,0 +1,247 @@
+# Code to read HTTP data
+#
+# Strategy: each reader is a callable which takes a ReceiveBuffer object, and
+# either:
+# 1) consumes some of it and returns an Event
+# 2) raises a LocalProtocolError (for consistency -- e.g. we call validate()
+#    and it might raise a LocalProtocolError, so simpler just to always use
+#    this)
+# 3) returns None, meaning "I need more data"
+#
+# If they have a .read_eof attribute, then this will be called if an EOF is
+# received -- but this is optional. Either way, the actual ConnectionClosed
+# event will be generated afterwards.
+#
+# READERS is a dict describing how to pick a reader. It maps states to either:
+# - a reader
+# - or, for body readers, a dict of per-framing reader factories
+
+import re
+from typing import Any, Callable, Dict, Iterable, NoReturn, Optional, Tuple, Type, Union
+
+from ._abnf import chunk_header, header_field, request_line, status_line
+from ._events import Data, EndOfMessage, InformationalResponse, Request, Response
+from ._receivebuffer import ReceiveBuffer
+from ._state import (
+    CLIENT,
+    CLOSED,
+    DONE,
+    IDLE,
+    MUST_CLOSE,
+    SEND_BODY,
+    SEND_RESPONSE,
+    SERVER,
+)
+from ._util import LocalProtocolError, RemoteProtocolError, Sentinel, validate
+
+__all__ = ["READERS"]
+
+header_field_re = re.compile(header_field.encode("ascii"))
+obs_fold_re = re.compile(rb"[ \t]+")
+
+
+def _obsolete_line_fold(lines: Iterable[bytes]) -> Iterable[bytes]:
+    it = iter(lines)
+    last: Optional[bytes] = None
+    for line in it:
+        match = obs_fold_re.match(line)
+        if match:
+            if last is None:
+                raise LocalProtocolError("continuation line at start of headers")
+            if not isinstance(last, bytearray):
+                # Cast to a mutable type, avoiding copy on append to ensure O(n) time
+                last = bytearray(last)
+            last += b" "
+            last += line[match.end() :]
+        else:
+            if last is not None:
+                yield last
+            last = line
+    if last is not None:
+        yield last
+
+
+def _decode_header_lines(
+    lines: Iterable[bytes],
+) -> Iterable[Tuple[bytes, bytes]]:
+    for line in _obsolete_line_fold(lines):
+        matches = validate(header_field_re, line, "illegal header line: {!r}", line)
+        yield (matches["field_name"], matches["field_value"])
+
+
+request_line_re = re.compile(request_line.encode("ascii"))
+
+
+def maybe_read_from_IDLE_client(buf: ReceiveBuffer) -> Optional[Request]:
+    lines = buf.maybe_extract_lines()
+    if lines is None:
+        if buf.is_next_line_obviously_invalid_request_line():
+            raise LocalProtocolError("illegal request line")
+        return None
+    if not lines:
+        raise LocalProtocolError("no request line received")
+    matches = validate(
+        request_line_re, lines[0], "illegal request line: {!r}", lines[0]
+    )
+    return Request(
+        headers=list(_decode_header_lines(lines[1:])), _parsed=True, **matches
+    )
+
+
+status_line_re = re.compile(status_line.encode("ascii"))
+
+
+def maybe_read_from_SEND_RESPONSE_server(
+    buf: ReceiveBuffer,
+) -> Union[InformationalResponse, Response, None]:
+    lines = buf.maybe_extract_lines()
+    if lines is None:
+        if buf.is_next_line_obviously_invalid_request_line():
+            raise LocalProtocolError("illegal request line")
+        return None
+    if not lines:
+        raise LocalProtocolError("no response line received")
+    matches = validate(status_line_re, lines[0], "illegal status line: {!r}", lines[0])
+    http_version = (
+        b"1.1" if matches["http_version"] is None else matches["http_version"]
+    )
+    reason = b"" if matches["reason"] is None else matches["reason"]
+    status_code = int(matches["status_code"])
+    class_: Union[Type[InformationalResponse], Type[Response]] = (
+        InformationalResponse if status_code < 200 else Response
+    )
+    return class_(
+        headers=list(_decode_header_lines(lines[1:])),
+        _parsed=True,
+        status_code=status_code,
+        reason=reason,
+        http_version=http_version,
+    )
+
+
+class ContentLengthReader:
+    def __init__(self, length: int) -> None:
+        self._length = length
+        self._remaining = length
+
+    def __call__(self, buf: ReceiveBuffer) -> Union[Data, EndOfMessage, None]:
+        if self._remaining == 0:
+            return EndOfMessage()
+        data = buf.maybe_extract_at_most(self._remaining)
+        if data is None:
+            return None
+        self._remaining -= len(data)
+        return Data(data=data)
+
+    def read_eof(self) -> NoReturn:
+        raise RemoteProtocolError(
+            "peer closed connection without sending complete message body "
+            "(received {} bytes, expected {})".format(
+                self._length - self._remaining, self._length
+            )
+        )
+
+
+chunk_header_re = re.compile(chunk_header.encode("ascii"))
+
+
+class ChunkedReader:
+    def __init__(self) -> None:
+        self._bytes_in_chunk = 0
+        # After reading a chunk, we have to throw away the trailing \r\n; if
+        # this is >0 then we discard that many bytes before resuming regular
+        # de-chunkification.
+        self._bytes_to_discard = 0
+        self._reading_trailer = False
+
+    def __call__(self, buf: ReceiveBuffer) -> Union[Data, EndOfMessage, None]:
+        if self._reading_trailer:
+            lines = buf.maybe_extract_lines()
+            if lines is None:
+                return None
+            return EndOfMessage(headers=list(_decode_header_lines(lines)))
+        if self._bytes_to_discard > 0:
+            data = buf.maybe_extract_at_most(self._bytes_to_discard)
+            if data is None:
+                return None
+            self._bytes_to_discard -= len(data)
+            if self._bytes_to_discard > 0:
+                return None
+            # else, fall through and read some more
+        assert self._bytes_to_discard == 0
+        if self._bytes_in_chunk == 0:
+            # We need to refill our chunk count
+            chunk_header = buf.maybe_extract_next_line()
+            if chunk_header is None:
+                return None
+            matches = validate(
+                chunk_header_re,
+                chunk_header,
+                "illegal chunk header: {!r}",
+                chunk_header,
+            )
+            # XX FIXME: we discard chunk extensions. Does anyone care?
+            self._bytes_in_chunk = int(matches["chunk_size"], base=16)
+            if self._bytes_in_chunk == 0:
+                self._reading_trailer = True
+                return self(buf)
+            chunk_start = True
+        else:
+            chunk_start = False
+        assert self._bytes_in_chunk > 0
+        data = buf.maybe_extract_at_most(self._bytes_in_chunk)
+        if data is None:
+            return None
+        self._bytes_in_chunk -= len(data)
+        if self._bytes_in_chunk == 0:
+            self._bytes_to_discard = 2
+            chunk_end = True
+        else:
+            chunk_end = False
+        return Data(data=data, chunk_start=chunk_start, chunk_end=chunk_end)
+
+    def read_eof(self) -> NoReturn:
+        raise RemoteProtocolError(
+            "peer closed connection without sending complete message body "
+            "(incomplete chunked read)"
+        )
+
+
+class Http10Reader:
+    def __call__(self, buf: ReceiveBuffer) -> Optional[Data]:
+        data = buf.maybe_extract_at_most(999999999)
+        if data is None:
+            return None
+        return Data(data=data)
+
+    def read_eof(self) -> EndOfMessage:
+        return EndOfMessage()
+
+
+def expect_nothing(buf: ReceiveBuffer) -> None:
+    if buf:
+        raise LocalProtocolError("Got data when expecting EOF")
+    return None
+
+
+ReadersType = Dict[
+    Union[Type[Sentinel], Tuple[Type[Sentinel], Type[Sentinel]]],
+    Union[Callable[..., Any], Dict[str, Callable[..., Any]]],
+]
+
+READERS: ReadersType = {
+    (CLIENT, IDLE): maybe_read_from_IDLE_client,
+    (SERVER, IDLE): maybe_read_from_SEND_RESPONSE_server,
+    (SERVER, SEND_RESPONSE): maybe_read_from_SEND_RESPONSE_server,
+    (CLIENT, DONE): expect_nothing,
+    (CLIENT, MUST_CLOSE): expect_nothing,
+    (CLIENT, CLOSED): expect_nothing,
+    (SERVER, DONE): expect_nothing,
+    (SERVER, MUST_CLOSE): expect_nothing,
+    (SERVER, CLOSED): expect_nothing,
+    SEND_BODY: {
+        "chunked": ChunkedReader,
+        "content-length": ContentLengthReader,
+        "http/1.0": Http10Reader,
+    },
+}
diff --git a/llm/Lib/site-packages/h11/_receivebuffer.py b/llm/Lib/site-packages/h11/_receivebuffer.py
new file mode 100644
index 0000000000000000000000000000000000000000..e5c4e08a56f5081e87103f38b4add6ce1b730204
--- /dev/null
+++ b/llm/Lib/site-packages/h11/_receivebuffer.py
@@ -0,0 +1,153 @@
+import re
+import sys
+from typing import List, Optional, Union
+
+__all__ = ["ReceiveBuffer"]
+
+
+# Operations we want to support:
+# - find next \r\n or \r\n\r\n (\n or \n\n are also acceptable),
+#   or wait until there is one
+# - read at-most-N bytes
+# Goals:
+# - on average, do this fast
+# - worst case, do this in O(n) where n is the number of bytes processed
+# Plan:
+# - store bytearray, offset, how far we've searched for a separator token
+# - use the how-far-we've-searched data to avoid rescanning
+# - while doing a stream of uninterrupted processing, advance offset instead
+#   of constantly copying
+# WARNING:
+# - I haven't benchmarked or profiled any of this yet.
+#
+# Note that starting in Python 3.4, deleting the initial n bytes from a
+# bytearray is amortized O(n), thanks to some excellent work by Antoine
+# Martin:
+#
+#     https://bugs.python.org/issue19087
+#
+# This means that if we only supported 3.4+, we could get rid of the code here
+# involving self._start and self.compress, because it's doing exactly the same
+# thing that bytearray now does internally.
+#
+# BUT unfortunately, we still support 2.7, and reading short segments out of a
+# long buffer MUST be O(bytes read) to avoid DoS issues, so we can't actually
+# delete this code. Yet:
+#
+#     https://pythonclock.org/
+#
+# (Two things to double-check first though: make sure PyPy also has the
+# optimization, and benchmark to make sure it's a win, since we do have a
+# slightly clever thing where we delay calling compress() until we've
+# processed a whole event, which could in theory be slightly more efficient
+# than the internal bytearray support.)
+blank_line_regex = re.compile(b"\n\r?\n", re.MULTILINE)
+
+
+class ReceiveBuffer:
+    def __init__(self) -> None:
+        self._data = bytearray()
+        self._next_line_search = 0
+        self._multiple_lines_search = 0
+
+    def __iadd__(self, byteslike: Union[bytes, bytearray]) -> "ReceiveBuffer":
+        self._data += byteslike
+        return self
+
+    def __bool__(self) -> bool:
+        return bool(len(self))
+
+    def __len__(self) -> int:
+        return len(self._data)
+
+    # for @property unprocessed_data
+    def __bytes__(self) -> bytes:
+        return bytes(self._data)
+
+    def _extract(self, count: int) -> bytearray:
+        # extracting an initial slice of the data buffer and return it
+        out = self._data[:count]
+        del self._data[:count]
+
+        self._next_line_search = 0
+        self._multiple_lines_search = 0
+
+        return out
+
+    def maybe_extract_at_most(self, count: int) -> Optional[bytearray]:
+        """
+        Extract a fixed number of bytes from the buffer.
+        """
+        out = self._data[:count]
+        if not out:
+            return None
+
+        return self._extract(count)
+
+    def maybe_extract_next_line(self) -> Optional[bytearray]:
+        """
+        Extract the first line, if it is completed in the buffer.
+        """
+        # Only search in buffer space that we've not already looked at.
+        search_start_index = max(0, self._next_line_search - 1)
+        partial_idx = self._data.find(b"\r\n", search_start_index)
+
+        if partial_idx == -1:
+            self._next_line_search = len(self._data)
+            return None
+
+        # + 2 is to compensate len(b"\r\n")
+        idx = partial_idx + 2
+
+        return self._extract(idx)
+
+    def maybe_extract_lines(self) -> Optional[List[bytearray]]:
+        """
+        Extract everything up to the first blank line, and return a list of lines.
+        """
+        # Handle the case where we have an immediate empty line.
+        if self._data[:1] == b"\n":
+            self._extract(1)
+            return []
+
+        if self._data[:2] == b"\r\n":
+            self._extract(2)
+            return []
+
+        # Only search in buffer space that we've not already looked at.
+        match = blank_line_regex.search(self._data, self._multiple_lines_search)
+        if match is None:
+            self._multiple_lines_search = max(0, len(self._data) - 2)
+            return None
+
+        # Truncate the buffer and return it.
+        idx = match.span(0)[-1]
+        out = self._extract(idx)
+        lines = out.split(b"\n")
+
+        for line in lines:
+            if line.endswith(b"\r"):
+                del line[-1]
+
+        assert lines[-2] == lines[-1] == b""
+
+        del lines[-2:]
+
+        return lines
+
+    # In theory we should wait until `\r\n` before starting to validate
+    # incoming data. However it's interesting to detect (very) invalid data
+    # early given they might not even contain `\r\n` at all (hence only
+    # timeout will get rid of them).
+    # This is not a 100% effective detection but more of a cheap sanity check
+    # allowing for early abort in some useful cases.
+    # This is especially interesting when peer is messing up with HTTPS and
+    # sent us a TLS stream where we were expecting plain HTTP given all
+    # versions of TLS so far start handshake with a 0x16 message type code.
+    def is_next_line_obviously_invalid_request_line(self) -> bool:
+        try:
+            # HTTP header line must not contain non-printable characters
+            # and should not start with a space
+            return self._data[0] < 0x21
+        except IndexError:
+            return False
diff --git a/llm/Lib/site-packages/h11/_state.py b/llm/Lib/site-packages/h11/_state.py
new file mode 100644
index 0000000000000000000000000000000000000000..3593430a74f21f6e0c2faf495e1627551eebfc30
--- /dev/null
+++ b/llm/Lib/site-packages/h11/_state.py
@@ -0,0 +1,367 @@
+################################################################
+# The core state machine
+################################################################
+#
+# Rule 1: everything that affects the state machine and state transitions must
+# live here in this file. As much as possible goes into the table-based
+# representation, but for the bits that don't quite fit, the actual code and
+# state must nonetheless live here.
+#
+# Rule 2: this file does not know about what role we're playing; it only knows
+# about HTTP request/response cycles in the abstract. This ensures that we
+# don't cheat and apply different rules to local and remote parties.
+#
+#
+# Theory of operation
+# ===================
+#
+# Possibly the simplest way to think about this is that we actually have 5
+# different state machines here. Yes, 5. These are:
+#
+# 1) The client state, with its complicated automaton (see the docs)
+# 2) The server state, with its complicated automaton (see the docs)
+# 3) The keep-alive state, with possible states {True, False}
+# 4) The SWITCH_CONNECT state, with possible states {False, True}
+# 5) The SWITCH_UPGRADE state, with possible states {False, True}
+#
+# For (3)-(5), the first state listed is the initial state.
+#
+# (1)-(3) are stored explicitly in member variables. The last
+# two are stored implicitly in the pending_switch_proposals set as:
+#   (state of 4) == (_SWITCH_CONNECT in pending_switch_proposals)
+#   (state of 5) == (_SWITCH_UPGRADE in pending_switch_proposals)
+#
+# And each of these machines has two different kinds of transitions:
+#
+# a) Event-triggered
+# b) State-triggered
+#
+# Event triggered is the obvious thing that you'd think it is: some event
+# happens, and if it's the right event at the right time then a transition
+# happens. But there are somewhat complicated rules for which machines can
+# "see" which events. (As a rule of thumb, if a machine "sees" an event, this
+# means two things: the event can affect the machine, and if the machine is
+# not in a state where it expects that event then it's an error.) These rules
+# are:
+#
+# 1) The client machine sees all h11.events objects emitted by the client.
+#
+# 2) The server machine sees all h11.events objects emitted by the server.
+#
+#    It also sees the client's Request event.
+#
+#    And sometimes, server events are annotated with a _SWITCH_* event. For
+#    example, we can have a (Response, _SWITCH_CONNECT) event, which is
+#    different from a regular Response event.
+#
+# 3) The keep-alive machine sees the process_keep_alive_disabled() event
+#    (which is derived from Request/Response events), and this event
+#    transitions it from True -> False, or from False -> False. There's no way
+#    to transition back.
+#
+# 4&5) The _SWITCH_* machines transition from False->True when we get a
+#    Request that proposes the relevant type of switch (via
+#    process_client_switch_proposals), and they go from True->False when we
+#    get a Response that has no _SWITCH_* annotation.
+#
+# So that's event-triggered transitions.
+#
+# State-triggered transitions are less standard. What they do here is couple
+# the machines together. The way this works is, when certain *joint*
+# configurations of states are achieved, then we automatically transition to a
+# new *joint* state. So, for example, if we're ever in a joint state with
+#
+#   client: DONE
+#   keep-alive: False
+#
+# then the client state immediately transitions to:
+#
+#   client: MUST_CLOSE
+#
+# This is fundamentally different from an event-based transition, because it
+# doesn't matter how we arrived at the {client: DONE, keep-alive: False} state
+# -- maybe the client transitioned SEND_BODY -> DONE, or keep-alive
+# transitioned True -> False. Either way, once this precondition is satisfied,
+# this transition is immediately triggered.
+#
+# What if two conflicting state-based transitions get enabled at the same
+# time?  In practice there's only one case where this arises (client DONE ->
+# MIGHT_SWITCH_PROTOCOL versus DONE -> MUST_CLOSE), and we resolve it by
+# explicitly prioritizing the DONE -> MIGHT_SWITCH_PROTOCOL transition.
+#
+# Implementation
+# --------------
+#
+# The event-triggered transitions for the server and client machines are all
+# stored explicitly in a table. Ditto for the state-triggered transitions that
+# involve just the server and client state.
+#
+# The transitions for the other machines, and the state-triggered transitions
+# that involve the other machines, are written out as explicit Python code.
+#
+# It'd be nice if there were some cleaner way to do all this. This isn't
+# *too* terrible, but I feel like it could probably be better.
+#
+# WARNING
+# -------
+#
+# The script that generates the state machine diagrams for the docs knows how
+# to read out the EVENT_TRIGGERED_TRANSITIONS and STATE_TRIGGERED_TRANSITIONS
+# tables. But it can't automatically read the transitions that are written
+# directly in Python code. So if you touch those, you need to also update the
+# script to keep it in sync!
+from typing import cast, Dict, Optional, Set, Tuple, Type, Union
+
+from ._events import *
+from ._util import LocalProtocolError, Sentinel
+
+# Everything in __all__ gets re-exported as part of the h11 public API.
+__all__ = [
+    "CLIENT",
+    "SERVER",
+    "IDLE",
+    "SEND_RESPONSE",
+    "SEND_BODY",
+    "DONE",
+    "MUST_CLOSE",
+    "CLOSED",
+    "MIGHT_SWITCH_PROTOCOL",
+    "SWITCHED_PROTOCOL",
+    "ERROR",
+]
+
+
+class CLIENT(Sentinel, metaclass=Sentinel):
+    pass
+
+
+class SERVER(Sentinel, metaclass=Sentinel):
+    pass
+
+
+# States
+class IDLE(Sentinel, metaclass=Sentinel):
+    pass
+
+
+class SEND_RESPONSE(Sentinel, metaclass=Sentinel):
+    pass
+
+
+class SEND_BODY(Sentinel, metaclass=Sentinel):
+    pass
+
+
+class DONE(Sentinel, metaclass=Sentinel):
+    pass
+
+
+class MUST_CLOSE(Sentinel, metaclass=Sentinel):
+    pass
+
+
+class CLOSED(Sentinel, metaclass=Sentinel):
+    pass
+
+
+class ERROR(Sentinel, metaclass=Sentinel):
+    pass
+
+
+# Switch types
+class MIGHT_SWITCH_PROTOCOL(Sentinel, metaclass=Sentinel):
+    pass
+
+
+class SWITCHED_PROTOCOL(Sentinel, metaclass=Sentinel):
+    pass
+
+
+class _SWITCH_UPGRADE(Sentinel, metaclass=Sentinel):
+    pass
+
+
+class _SWITCH_CONNECT(Sentinel, metaclass=Sentinel):
+    pass
+
+
+EventTransitionType = Dict[
+    Type[Sentinel],
+    Dict[
+        Type[Sentinel],
+        Dict[Union[Type[Event], Tuple[Type[Event], Type[Sentinel]]], Type[Sentinel]],
+    ],
+]
+
+EVENT_TRIGGERED_TRANSITIONS: EventTransitionType = {
+    CLIENT: {
+        IDLE: {Request: SEND_BODY, ConnectionClosed: CLOSED},
+        SEND_BODY: {Data: SEND_BODY, EndOfMessage: DONE},
+        DONE: {ConnectionClosed: CLOSED},
+        MUST_CLOSE: {ConnectionClosed: CLOSED},
+        CLOSED: {ConnectionClosed: CLOSED},
+        MIGHT_SWITCH_PROTOCOL: {},
+        SWITCHED_PROTOCOL: {},
+        ERROR: {},
+    },
+    SERVER: {
+        IDLE: {
+            ConnectionClosed: CLOSED,
+            Response: SEND_BODY,
+            # Special case: server sees client Request events, in this form
+            (Request, CLIENT): SEND_RESPONSE,
+        },
+        SEND_RESPONSE: {
+            InformationalResponse: SEND_RESPONSE,
+            Response: SEND_BODY,
+            (InformationalResponse, _SWITCH_UPGRADE): SWITCHED_PROTOCOL,
+            (Response, _SWITCH_CONNECT): SWITCHED_PROTOCOL,
+        },
+        SEND_BODY: {Data: SEND_BODY, EndOfMessage: DONE},
+        DONE: {ConnectionClosed: CLOSED},
+        MUST_CLOSE: {ConnectionClosed: CLOSED},
+        CLOSED: {ConnectionClosed: CLOSED},
+        SWITCHED_PROTOCOL: {},
+        ERROR: {},
+    },
+}
+
+StateTransitionType = Dict[
+    Tuple[Type[Sentinel], Type[Sentinel]], Dict[Type[Sentinel], Type[Sentinel]]
+]
+
+# NB: there are also some special-case state-triggered transitions hard-coded
+# into _fire_state_triggered_transitions below.
+STATE_TRIGGERED_TRANSITIONS: StateTransitionType = {
+    # (Client state, Server state) -> new states
+    # Protocol negotiation
+    (MIGHT_SWITCH_PROTOCOL, SWITCHED_PROTOCOL): {CLIENT: SWITCHED_PROTOCOL},
+    # Socket shutdown
+    (CLOSED, DONE): {SERVER: MUST_CLOSE},
+    (CLOSED, IDLE): {SERVER: MUST_CLOSE},
+    (ERROR, DONE): {SERVER: MUST_CLOSE},
+    (DONE, CLOSED): {CLIENT: MUST_CLOSE},
+    (IDLE, CLOSED): {CLIENT: MUST_CLOSE},
+    (DONE, ERROR): {CLIENT: MUST_CLOSE},
+}
+
+
+class ConnectionState:
+    def __init__(self) -> None:
+        # Extra bits of state that don't quite fit into the state model.
+
+        # If this is False then it enables the automatic DONE -> MUST_CLOSE
+        # transition. Don't set this directly; call .keep_alive_disabled()
+        self.keep_alive = True
+
+        # This is a subset of {UPGRADE, CONNECT}, containing the proposals
+        # made by the client for switching protocols.
+        self.pending_switch_proposals: Set[Type[Sentinel]] = set()
+
+        self.states: Dict[Type[Sentinel], Type[Sentinel]] = {CLIENT: IDLE, SERVER: IDLE}
+
+    def process_error(self, role: Type[Sentinel]) -> None:
+        self.states[role] = ERROR
+        self._fire_state_triggered_transitions()
+
+    def process_keep_alive_disabled(self) -> None:
+        self.keep_alive = False
+        self._fire_state_triggered_transitions()
+
+    def process_client_switch_proposal(self, switch_event: Type[Sentinel]) -> None:
+        self.pending_switch_proposals.add(switch_event)
+        self._fire_state_triggered_transitions()
+
+    def process_event(
+        self,
+        role: Type[Sentinel],
+        event_type: Type[Event],
+        server_switch_event: Optional[Type[Sentinel]] = None,
+    ) -> None:
+        _event_type: Union[Type[Event], Tuple[Type[Event], Type[Sentinel]]] = event_type
+        if server_switch_event is not None:
+            assert role is SERVER
+            if server_switch_event not in self.pending_switch_proposals:
+                raise LocalProtocolError(
+                    "Received server {} event without a pending proposal".format(
+                        server_switch_event
+                    )
+                )
+            _event_type = (event_type, server_switch_event)
+        if server_switch_event is None and _event_type is Response:
+            self.pending_switch_proposals = set()
+        self._fire_event_triggered_transitions(role, _event_type)
+        # Special case: the server state does get to see Request
+        # events.
+        if _event_type is Request:
+            assert role is CLIENT
+            self._fire_event_triggered_transitions(SERVER, (Request, CLIENT))
+        self._fire_state_triggered_transitions()
+
+    def _fire_event_triggered_transitions(
+        self,
+        role: Type[Sentinel],
+        event_type: Union[Type[Event], Tuple[Type[Event], Type[Sentinel]]],
+    ) -> None:
+        state = self.states[role]
+        try:
+            new_state = EVENT_TRIGGERED_TRANSITIONS[role][state][event_type]
+        except KeyError:
+            event_type = cast(Type[Event], event_type)
+            raise LocalProtocolError(
+                "can't handle event type {} when role={} and state={}".format(
+                    event_type.__name__, role, self.states[role]
+                )
+            ) from None
+        self.states[role] = new_state
+
+    def _fire_state_triggered_transitions(self) -> None:
+        # We apply these rules repeatedly until converging on a fixed point
+        while True:
+            start_states = dict(self.states)
+
+            # It could happen that both these special-case transitions are
+            # enabled at the same time:
+            #
+            #    DONE -> MIGHT_SWITCH_PROTOCOL
+            #    DONE -> MUST_CLOSE
+            #
+            # For example, this will always be true of a HTTP/1.0 client
+            # requesting CONNECT.  If this happens, the protocol switch takes
+            # priority. From there the client will either go to
+            # SWITCHED_PROTOCOL, in which case it's none of our business when
+            # they close the connection, or else the server will deny the
+            # request, in which case the client will go back to DONE and then
+            # from there to MUST_CLOSE.
+            if self.pending_switch_proposals:
+                if self.states[CLIENT] is DONE:
+                    self.states[CLIENT] = MIGHT_SWITCH_PROTOCOL
+
+            if not self.pending_switch_proposals:
+                if self.states[CLIENT] is MIGHT_SWITCH_PROTOCOL:
+                    self.states[CLIENT] = DONE
+
+            if not self.keep_alive:
+                for role in (CLIENT, SERVER):
+                    if self.states[role] is DONE:
+                        self.states[role] = MUST_CLOSE
+
+            # Tabular state-triggered transitions
+            joint_state = (self.states[CLIENT], self.states[SERVER])
+            changes = STATE_TRIGGERED_TRANSITIONS.get(joint_state, {})
+            self.states.update(changes)
+
+            if self.states == start_states:
+                # Fixed point reached
+                return
+
+    def start_next_cycle(self) -> None:
+        if self.states != {CLIENT: DONE, SERVER: DONE}:
+            raise LocalProtocolError(
+                "not in a reusable state. self.states={}".format(self.states)
+            )
+        # Can't reach DONE/DONE with any of these active, but still, let's be
+        # sure.
+        assert self.keep_alive
+        assert not self.pending_switch_proposals
+        self.states = {CLIENT: IDLE, SERVER: IDLE}
diff --git a/llm/Lib/site-packages/h11/_util.py b/llm/Lib/site-packages/h11/_util.py
new file mode 100644
index 0000000000000000000000000000000000000000..6718445290770e028ea2f1f662026c9a0b0991db
--- /dev/null
+++ b/llm/Lib/site-packages/h11/_util.py
@@ -0,0 +1,135 @@
+from typing import Any, Dict, NoReturn, Pattern, Tuple, Type, TypeVar, Union
+
+__all__ = [
+    "ProtocolError",
+    "LocalProtocolError",
+    "RemoteProtocolError",
+    "validate",
+    "bytesify",
+]
+
+
+class ProtocolError(Exception):
+    """Exception indicating a violation of the HTTP/1.1 protocol.
+
+    This as an abstract base class, with two concrete base classes:
+    :exc:`LocalProtocolError`, which indicates that you tried to do something
+    that HTTP/1.1 says is illegal, and :exc:`RemoteProtocolError`, which
+    indicates that the remote peer tried to do something that HTTP/1.1 says is
+    illegal. See :ref:`error-handling` for details.
+
+    In addition to the normal :exc:`Exception` features, it has one attribute:
+
+    .. attribute:: error_status_hint
+
+       This gives a suggestion as to what status code a server might use if
+       this error occurred as part of a request.
+
+       For a :exc:`RemoteProtocolError`, this is useful as a suggestion for
+       how you might want to respond to a misbehaving peer, if you're
+       implementing a server.
+
+       For a :exc:`LocalProtocolError`, this can be taken as a suggestion for
+       how your peer might have responded to *you* if h11 had allowed you to
+       continue.
+
+       The default is 400 Bad Request, a generic catch-all for protocol
+       violations.
+
+    """
+
+    def __init__(self, msg: str, error_status_hint: int = 400) -> None:
+        if type(self) is ProtocolError:
+            raise TypeError("tried to directly instantiate ProtocolError")
+        Exception.__init__(self, msg)
+        self.error_status_hint = error_status_hint
+
+
+# Strategy: there are a number of public APIs where a LocalProtocolError can
+# be raised (send(), all the different event constructors, ...), and only one
+# public API where RemoteProtocolError can be raised
+# (receive_data()). Therefore we always raise LocalProtocolError internally,
+# and then receive_data will translate this into a RemoteProtocolError.
+#
+# Internally:
+#   LocalProtocolError is the generic "ProtocolError".
+# Externally:
+#   LocalProtocolError is for local errors and RemoteProtocolError is for
+#   remote errors.
+class LocalProtocolError(ProtocolError):
+    def _reraise_as_remote_protocol_error(self) -> NoReturn:
+        # After catching a LocalProtocolError, use this method to re-raise it
+        # as a RemoteProtocolError. This method must be called from inside an
+        # except: block.
+        #
+        # An easy way to get an equivalent RemoteProtocolError is just to
+        # modify 'self' in place.
+        self.__class__ = RemoteProtocolError  # type: ignore
+        # But the re-raising is somewhat non-trivial -- you might think that
+        # now that we've modified the in-flight exception object, that just
+        # doing 'raise' to re-raise it would be enough. But it turns out that
+        # this doesn't work, because Python tracks the exception type
+        # (exc_info[0]) separately from the exception object (exc_info[1]),
+        # and we only modified the latter. So we really do need to re-raise
+        # the new type explicitly.
+        # On py3, the traceback is part of the exception object, so our
+        # in-place modification preserved it and we can just re-raise:
+        raise self
+
+
+class RemoteProtocolError(ProtocolError):
+    pass
+
+
+def validate(
+    regex: Pattern[bytes], data: bytes, msg: str = "malformed data", *format_args: Any
+) -> Dict[str, bytes]:
+    match = regex.fullmatch(data)
+    if not match:
+        if format_args:
+            msg = msg.format(*format_args)
+        raise LocalProtocolError(msg)
+    return match.groupdict()
+
+
+# Sentinel values
+#
+# - Inherit identity-based comparison and hashing from object
+# - Have a nice repr
+# - Have a *bonus property*: type(sentinel) is sentinel
+#
+# The bonus property is useful if you want to take the return value from
+# next_event() and do some sort of dispatch based on type(event).
+
+_T_Sentinel = TypeVar("_T_Sentinel", bound="Sentinel")
+
+
+class Sentinel(type):
+    def __new__(
+        cls: Type[_T_Sentinel],
+        name: str,
+        bases: Tuple[type, ...],
+        namespace: Dict[str, Any],
+        **kwds: Any
+    ) -> _T_Sentinel:
+        assert bases == (Sentinel,)
+        v = super().__new__(cls, name, bases, namespace, **kwds)
+        v.__class__ = v  # type: ignore
+        return v
+
+    def __repr__(self) -> str:
+        return self.__name__
+
+
+# Used for methods, request targets, HTTP versions, header names, and header
+# values. Accepts ascii-strings, or bytes/bytearray/memoryview/..., and always
+# returns bytes.
+def bytesify(s: Union[bytes, bytearray, memoryview, int, str]) -> bytes:
+    # Fast-path:
+    if type(s) is bytes:
+        return s
+    if isinstance(s, str):
+        s = s.encode("ascii")
+    if isinstance(s, int):
+        raise TypeError("expected bytes-like object, not int")
+    return bytes(s)
diff --git a/llm/Lib/site-packages/h11/_version.py b/llm/Lib/site-packages/h11/_version.py
new file mode 100644
index 0000000000000000000000000000000000000000..4c8911305680c1083b2da9b87ece12bc36f3a9e1
--- /dev/null
+++ b/llm/Lib/site-packages/h11/_version.py
@@ -0,0 +1,16 @@
+# This file must be kept very simple, because it is consumed from several
+# places -- it is imported by h11/__init__.py, execfile'd by setup.py, etc.
+
+# We use a simple scheme:
+#   1.0.0 -> 1.0.0+dev -> 1.1.0 -> 1.1.0+dev
+# where the +dev versions are never released into the wild, they're just what
+# we stick into the VCS in between releases.
+#
+# This is compatible with PEP 440:
+#   http://legacy.python.org/dev/peps/pep-0440/
+# via the use of the "local suffix" "+dev", which is disallowed on index
+# servers and causes 1.0.0+dev to sort after plain 1.0.0, which is what we
+# want. (Contrast with the special suffix 1.0.0.dev, which sorts *before*
+# 1.0.0.)
+
+__version__ = "0.14.0"
diff --git a/llm/Lib/site-packages/h11/_writers.py b/llm/Lib/site-packages/h11/_writers.py
new file mode 100644
index 0000000000000000000000000000000000000000..939cdb912a9debaea07fbf3a9ac04549c44d077c
--- /dev/null
+++ b/llm/Lib/site-packages/h11/_writers.py
@@ -0,0 +1,145 @@
+# Code to read HTTP data
+#
+# Strategy: each writer takes an event + a write-some-bytes function, which is
+# calls.
+#
+# WRITERS is a dict describing how to pick a reader. It maps states to either:
+# - a writer
+# - or, for body writers, a dict of framin-dependent writer factories
+
+from typing import Any, Callable, Dict, List, Tuple, Type, Union
+
+from ._events import Data, EndOfMessage, Event, InformationalResponse, Request, Response
+from ._headers import Headers
+from ._state import CLIENT, IDLE, SEND_BODY, SEND_RESPONSE, SERVER
+from ._util import LocalProtocolError, Sentinel
+
+__all__ = ["WRITERS"]
+
+Writer = Callable[[bytes], Any]
+
+
+def write_headers(headers: Headers, write: Writer) -> None:
+    # "Since the Host field-value is critical information for handling a
+    # request, a user agent SHOULD generate Host as the first header field
+    # following the request-line." - RFC 7230
+    raw_items = headers._full_items
+    for raw_name, name, value in raw_items:
+        if name == b"host":
+            write(b"%s: %s\r\n" % (raw_name, value))
+    for raw_name, name, value in raw_items:
+        if name != b"host":
+            write(b"%s: %s\r\n" % (raw_name, value))
+    write(b"\r\n")
+
+
+def write_request(request: Request, write: Writer) -> None:
+    if request.http_version != b"1.1":
+        raise LocalProtocolError("I only send HTTP/1.1")
+    write(b"%s %s HTTP/1.1\r\n" % (request.method, request.target))
+    write_headers(request.headers, write)
+
+
+# Shared between InformationalResponse and Response
+def write_any_response(
+    response: Union[InformationalResponse, Response], write: Writer
+) -> None:
+    if response.http_version != b"1.1":
+        raise LocalProtocolError("I only send HTTP/1.1")
+    status_bytes = str(response.status_code).encode("ascii")
+    # We don't bother sending ascii status messages like "OK"; they're
+    # optional and ignored by the protocol. (But the space after the numeric
+    # status code is mandatory.)
+    #
+    # XX FIXME: could at least make an effort to pull out the status message
+    # from stdlib's http.HTTPStatus table. Or maybe just steal their enums
+    # (either by import or copy/paste). We already accept them as status codes
+    # since they're of type IntEnum < int.
+    write(b"HTTP/1.1 %s %s\r\n" % (status_bytes, response.reason))
+    write_headers(response.headers, write)
+
+
+class BodyWriter:
+    def __call__(self, event: Event, write: Writer) -> None:
+        if type(event) is Data:
+            self.send_data(event.data, write)
+        elif type(event) is EndOfMessage:
+            self.send_eom(event.headers, write)
+        else:  # pragma: no cover
+            assert False
+
+    def send_data(self, data: bytes, write: Writer) -> None:
+        pass
+
+    def send_eom(self, headers: Headers, write: Writer) -> None:
+        pass
+
+
+#
+# These are all careful not to do anything to 'data' except call len(data) and
+# write(data). This allows us to transparently pass-through funny objects,
+# like placeholder objects referring to files on disk that will be sent via
+# sendfile(2).
+#
+class ContentLengthWriter(BodyWriter):
+    def __init__(self, length: int) -> None:
+        self._length = length
+
+    def send_data(self, data: bytes, write: Writer) -> None:
+        self._length -= len(data)
+        if self._length < 0:
+            raise LocalProtocolError("Too much data for declared Content-Length")
+        write(data)
+
+    def send_eom(self, headers: Headers, write: Writer) -> None:
+        if self._length != 0:
+            raise LocalProtocolError("Too little data for declared Content-Length")
+        if headers:
+            raise LocalProtocolError("Content-Length and trailers don't mix")
+
+
+class ChunkedWriter(BodyWriter):
+    def send_data(self, data: bytes, write: Writer) -> None:
+        # if we encoded 0-length data in the naive way, it would look like an
+        # end-of-message.
+        if not data:
+            return
+        write(b"%x\r\n" % len(data))
+        write(data)
+        write(b"\r\n")
+
+    def send_eom(self, headers: Headers, write: Writer) -> None:
+        write(b"0\r\n")
+        write_headers(headers, write)
+
+
+class Http10Writer(BodyWriter):
+    def send_data(self, data: bytes, write: Writer) -> None:
+        write(data)
+
+    def send_eom(self, headers: Headers, write: Writer) -> None:
+        if headers:
+            raise LocalProtocolError("can't send trailers to HTTP/1.0 client")
+        # no need to close the socket ourselves, that will be taken care of by
+        # Connection: close machinery
+
+
+WritersType = Dict[
+    Union[Tuple[Type[Sentinel], Type[Sentinel]], Type[Sentinel]],
+    Union[
+        Dict[str, Type[BodyWriter]],
+        Callable[[Union[InformationalResponse, Response], Writer], None],
+        Callable[[Request, Writer], None],
+    ],
+]
+
+WRITERS: WritersType = {
+    (CLIENT, IDLE): write_request,
+    (SERVER, IDLE): write_any_response,
+    (SERVER, SEND_RESPONSE): write_any_response,
+    SEND_BODY: {
+        "chunked": ChunkedWriter,
+        "content-length": ContentLengthWriter,
+        "http/1.0": Http10Writer,
+    },
+}
diff --git a/llm/Lib/site-packages/h11/py.typed b/llm/Lib/site-packages/h11/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..f5642f79f21d872f010979dcf6f0c4a415acc19d
--- /dev/null
+++ b/llm/Lib/site-packages/h11/py.typed
@@ -0,0 +1 @@
+Marker
diff --git a/llm/Lib/site-packages/h11/tests/__init__.py b/llm/Lib/site-packages/h11/tests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/h11/tests/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/h11/tests/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..45f38b2810b8d3282761510c7daa4bd0be065776
Binary files /dev/null and b/llm/Lib/site-packages/h11/tests/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/tests/__pycache__/helpers.cpython-311.pyc b/llm/Lib/site-packages/h11/tests/__pycache__/helpers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9a57c7659a78e3a3a6ead546f6a3b43c6142331e
Binary files /dev/null and b/llm/Lib/site-packages/h11/tests/__pycache__/helpers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/tests/__pycache__/test_against_stdlib_http.cpython-311.pyc b/llm/Lib/site-packages/h11/tests/__pycache__/test_against_stdlib_http.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c60f663e9629d99be84f8ec1c43c1c1710eb042b
Binary files /dev/null and b/llm/Lib/site-packages/h11/tests/__pycache__/test_against_stdlib_http.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/tests/__pycache__/test_connection.cpython-311.pyc b/llm/Lib/site-packages/h11/tests/__pycache__/test_connection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e530b588f9e2a6b72261fed604665cbb97ed4bc9
Binary files /dev/null and b/llm/Lib/site-packages/h11/tests/__pycache__/test_connection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/tests/__pycache__/test_events.cpython-311.pyc b/llm/Lib/site-packages/h11/tests/__pycache__/test_events.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e9963cd2a1131d7b19bddd82f4bcff81bb91e91
Binary files /dev/null and b/llm/Lib/site-packages/h11/tests/__pycache__/test_events.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/tests/__pycache__/test_headers.cpython-311.pyc b/llm/Lib/site-packages/h11/tests/__pycache__/test_headers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..44d3c283a73b07b33d9a694798a7a297def1dee5
Binary files /dev/null and b/llm/Lib/site-packages/h11/tests/__pycache__/test_headers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/tests/__pycache__/test_helpers.cpython-311.pyc b/llm/Lib/site-packages/h11/tests/__pycache__/test_helpers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6c077da9339956f064beb7c8cdf83592937f38f6
Binary files /dev/null and b/llm/Lib/site-packages/h11/tests/__pycache__/test_helpers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/tests/__pycache__/test_io.cpython-311.pyc b/llm/Lib/site-packages/h11/tests/__pycache__/test_io.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0c4accf102c1d22c691bd05040a3001feb49ed19
Binary files /dev/null and b/llm/Lib/site-packages/h11/tests/__pycache__/test_io.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/tests/__pycache__/test_receivebuffer.cpython-311.pyc b/llm/Lib/site-packages/h11/tests/__pycache__/test_receivebuffer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5c79efe5f8e1e8fe76f47b193bd468f3ad4e05ff
Binary files /dev/null and b/llm/Lib/site-packages/h11/tests/__pycache__/test_receivebuffer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/tests/__pycache__/test_state.cpython-311.pyc b/llm/Lib/site-packages/h11/tests/__pycache__/test_state.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eee49eec0c6c3d607246904abb4184add7bd3f66
Binary files /dev/null and b/llm/Lib/site-packages/h11/tests/__pycache__/test_state.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/tests/__pycache__/test_util.cpython-311.pyc b/llm/Lib/site-packages/h11/tests/__pycache__/test_util.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e8fdf054526fc491a82957ba5262d88cbd2ea43d
Binary files /dev/null and b/llm/Lib/site-packages/h11/tests/__pycache__/test_util.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h11/tests/data/test-file b/llm/Lib/site-packages/h11/tests/data/test-file
new file mode 100644
index 0000000000000000000000000000000000000000..d0be0a6c5d6c19a35f0e815b83e27f8d833ea88b
--- /dev/null
+++ b/llm/Lib/site-packages/h11/tests/data/test-file
@@ -0,0 +1 @@
+92b12bc045050b55b848d37167a1a63947c364579889ce1d39788e45e9fac9e5
diff --git a/llm/Lib/site-packages/h11/tests/helpers.py b/llm/Lib/site-packages/h11/tests/helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..571be44461b0847c9edb8654c9d528abed0b7800
--- /dev/null
+++ b/llm/Lib/site-packages/h11/tests/helpers.py
@@ -0,0 +1,101 @@
+from typing import cast, List, Type, Union, ValuesView
+
+from .._connection import Connection, NEED_DATA, PAUSED
+from .._events import (
+    ConnectionClosed,
+    Data,
+    EndOfMessage,
+    Event,
+    InformationalResponse,
+    Request,
+    Response,
+)
+from .._state import CLIENT, CLOSED, DONE, MUST_CLOSE, SERVER
+from .._util import Sentinel
+
+try:
+    from typing import Literal
+except ImportError:
+    from typing_extensions import Literal  # type: ignore
+
+
+def get_all_events(conn: Connection) -> List[Event]:
+    got_events = []
+    while True:
+        event = conn.next_event()
+        if event in (NEED_DATA, PAUSED):
+            break
+        event = cast(Event, event)
+        got_events.append(event)
+        if type(event) is ConnectionClosed:
+            break
+    return got_events
+
+
+def receive_and_get(conn: Connection, data: bytes) -> List[Event]:
+    conn.receive_data(data)
+    return get_all_events(conn)
+
+
+# Merges adjacent Data events, converts payloads to bytestrings, and removes
+# chunk boundaries.
+def normalize_data_events(in_events: List[Event]) -> List[Event]:
+    out_events: List[Event] = []
+    for event in in_events:
+        if type(event) is Data:
+            event = Data(data=bytes(event.data), chunk_start=False, chunk_end=False)
+        if out_events and type(out_events[-1]) is type(event) is Data:
+            out_events[-1] = Data(
+                data=out_events[-1].data + event.data,
+                chunk_start=out_events[-1].chunk_start,
+                chunk_end=out_events[-1].chunk_end,
+            )
+        else:
+            out_events.append(event)
+    return out_events
+
+
+# Given that we want to write tests that push some events through a Connection
+# and check that its state updates appropriately... we might as make a habit
+# of pushing them through two Connections with a fake network link in
+# between.
+class ConnectionPair:
+    def __init__(self) -> None:
+        self.conn = {CLIENT: Connection(CLIENT), SERVER: Connection(SERVER)}
+        self.other = {CLIENT: SERVER, SERVER: CLIENT}
+
+    @property
+    def conns(self) -> ValuesView[Connection]:
+        return self.conn.values()
+
+    # expect="match" if expect=send_events; expect=[...] to say what expected
+    def send(
+        self,
+        role: Type[Sentinel],
+        send_events: Union[List[Event], Event],
+        expect: Union[List[Event], Event, Literal["match"]] = "match",
+    ) -> bytes:
+        if not isinstance(send_events, list):
+            send_events = [send_events]
+        data = b""
+        closed = False
+        for send_event in send_events:
+            new_data = self.conn[role].send(send_event)
+            if new_data is None:
+                closed = True
+            else:
+                data += new_data
+        # send uses b"" to mean b"", and None to mean closed
+        # receive uses b"" to mean closed, and None to mean "try again"
+        # so we have to translate between the two conventions
+        if data:
+            self.conn[self.other[role]].receive_data(data)
+        if closed:
+            self.conn[self.other[role]].receive_data(b"")
+        got_events = get_all_events(self.conn[self.other[role]])
+        if expect == "match":
+            expect = send_events
+        if not isinstance(expect, list):
+            expect = [expect]
+        assert got_events == expect
+        return data
diff --git a/llm/Lib/site-packages/h11/tests/test_against_stdlib_http.py b/llm/Lib/site-packages/h11/tests/test_against_stdlib_http.py
new file mode 100644
index 0000000000000000000000000000000000000000..d2ee13149d34c9882432cdebfec87dff9814076d
--- /dev/null
+++ b/llm/Lib/site-packages/h11/tests/test_against_stdlib_http.py
@@ -0,0 +1,115 @@
+import json
+import os.path
+import socket
+import socketserver
+import threading
+from contextlib import closing, contextmanager
+from http.server import SimpleHTTPRequestHandler
+from typing import Callable, Generator
+from urllib.request import urlopen
+
+import h11
+
+
+@contextmanager
+def socket_server(
+    handler: Callable[..., socketserver.BaseRequestHandler]
+) -> Generator[socketserver.TCPServer, None, None]:
+    httpd = socketserver.TCPServer(("127.0.0.1", 0), handler)
+    thread = threading.Thread(
+        target=httpd.serve_forever, kwargs={"poll_interval": 0.01}
+    )
+    thread.daemon = True
+    try:
+        thread.start()
+        yield httpd
+    finally:
+        httpd.shutdown()
+
+
+test_file_path = os.path.join(os.path.dirname(__file__), "data/test-file")
+with open(test_file_path, "rb") as f:
+    test_file_data = f.read()
+
+
+class SingleMindedRequestHandler(SimpleHTTPRequestHandler):
+    def translate_path(self, path: str) -> str:
+        return test_file_path
+
+
+def test_h11_as_client() -> None:
+    with socket_server(SingleMindedRequestHandler) as httpd:
+        with closing(socket.create_connection(httpd.server_address)) as s:
+            c = h11.Connection(h11.CLIENT)
+
+            s.sendall(
+                c.send(  # type: ignore[arg-type]
+                    h11.Request(
+                        method="GET", target="/foo", headers=[("Host", "localhost")]
+                    )
+                )
+            )
+            s.sendall(c.send(h11.EndOfMessage()))  # type: ignore[arg-type]
+
+            data = bytearray()
+            while True:
+                event = c.next_event()
+                print(event)
+                if event is h11.NEED_DATA:
+                    # Use a small read buffer to make things more challenging
+                    # and exercise more paths :-)
+                    c.receive_data(s.recv(10))
+                    continue
+                if type(event) is h11.Response:
+                    assert event.status_code == 200
+                if type(event) is h11.Data:
+                    data += event.data
+                if type(event) is h11.EndOfMessage:
+                    break
+            assert bytes(data) == test_file_data
+
+
+class H11RequestHandler(socketserver.BaseRequestHandler):
+    def handle(self) -> None:
+        with closing(self.request) as s:
+            c = h11.Connection(h11.SERVER)
+            request = None
+            while True:
+                event = c.next_event()
+                if event is h11.NEED_DATA:
+                    # Use a small read buffer to make things more challenging
+                    # and exercise more paths :-)
+                    c.receive_data(s.recv(10))
+                    continue
+                if type(event) is h11.Request:
+                    request = event
+                if type(event) is h11.EndOfMessage:
+                    break
+            assert request is not None
+            info = json.dumps(
+                {
+                    "method": request.method.decode("ascii"),
+                    "target": request.target.decode("ascii"),
+                    "headers": {
+                        name.decode("ascii"): value.decode("ascii")
+                        for (name, value) in request.headers
+                    },
+                }
+            )
+            s.sendall(c.send(h11.Response(status_code=200, headers=[])))  # type: ignore[arg-type]
+            s.sendall(c.send(h11.Data(data=info.encode("ascii"))))
+            s.sendall(c.send(h11.EndOfMessage()))
+
+
+def test_h11_as_server() -> None:
+    with socket_server(H11RequestHandler) as httpd:
+        host, port = httpd.server_address
+        url = "http://{}:{}/some-path".format(host, port)
+        with closing(urlopen(url)) as f:
+            assert f.getcode() == 200
+            data = f.read()
+    info = json.loads(data.decode("ascii"))
+    print(info)
+    assert info["method"] == "GET"
+    assert info["target"] == "/some-path"
+    assert "urllib" in info["headers"]["user-agent"]
diff --git a/llm/Lib/site-packages/h11/tests/test_connection.py b/llm/Lib/site-packages/h11/tests/test_connection.py
new file mode 100644
index 0000000000000000000000000000000000000000..73a27b98bebd949cb3b99e19a3a8a484455b58d7
--- /dev/null
+++ b/llm/Lib/site-packages/h11/tests/test_connection.py
@@ -0,0 +1,1122 @@
+from typing import Any, cast, Dict, List, Optional, Tuple, Type
+
+import pytest
+
+from .._connection import _body_framing, _keep_alive, Connection, NEED_DATA, PAUSED
+from .._events import (
+    ConnectionClosed,
+    Data,
+    EndOfMessage,
+    Event,
+    InformationalResponse,
+    Request,
+    Response,
+)
+from .._state import (
+    CLIENT,
+    CLOSED,
+    DONE,
+    ERROR,
+    IDLE,
+    MIGHT_SWITCH_PROTOCOL,
+    MUST_CLOSE,
+    SEND_BODY,
+    SEND_RESPONSE,
+    SERVER,
+    SWITCHED_PROTOCOL,
+)
+from .._util import LocalProtocolError, RemoteProtocolError, Sentinel
+from .helpers import ConnectionPair, get_all_events, receive_and_get
+
+
+def test__keep_alive() -> None:
+    assert _keep_alive(
+        Request(method="GET", target="/", headers=[("Host", "Example.com")])
+    )
+    assert not _keep_alive(
+        Request(
+            method="GET",
+            target="/",
+            headers=[("Host", "Example.com"), ("Connection", "close")],
+        )
+    )
+    assert not _keep_alive(
+        Request(
+            method="GET",
+            target="/",
+            headers=[("Host", "Example.com"), ("Connection", "a, b, cLOse, foo")],
+        )
+    )
+    assert not _keep_alive(
+        Request(method="GET", target="/", headers=[], http_version="1.0")  # type: ignore[arg-type]
+    )
+
+    assert _keep_alive(Response(status_code=200, headers=[]))  # type: ignore[arg-type]
+    assert not _keep_alive(Response(status_code=200, headers=[("Connection", "close")]))
+    assert not _keep_alive(
+        Response(status_code=200, headers=[("Connection", "a, b, cLOse, foo")])
+    )
+    assert not _keep_alive(Response(status_code=200, headers=[], http_version="1.0"))  # type: ignore[arg-type]
+
+
+def test__body_framing() -> None:
+    def headers(cl: Optional[int], te: bool) -> List[Tuple[str, str]]:
+        headers = []
+        if cl is not None:
+            headers.append(("Content-Length", str(cl)))
+        if te:
+            headers.append(("Transfer-Encoding", "chunked"))
+        return headers
+
+    def resp(
+        status_code: int = 200, cl: Optional[int] = None, te: bool = False
+    ) -> Response:
+        return Response(status_code=status_code, headers=headers(cl, te))
+
+    def req(cl: Optional[int] = None, te: bool = False) -> Request:
+        h = headers(cl, te)
+        h += [("Host", "example.com")]
+        return Request(method="GET", target="/", headers=h)
+
+    # Special cases where the headers are ignored:
+    for kwargs in [{}, {"cl": 100}, {"te": True}, {"cl": 100, "te": True}]:
+        kwargs = cast(Dict[str, Any], kwargs)
+        for meth, r in [
+            (b"HEAD", resp(**kwargs)),
+            (b"GET", resp(status_code=204, **kwargs)),
+            (b"GET", resp(status_code=304, **kwargs)),
+        ]:
+            assert _body_framing(meth, r) == ("content-length", (0,))
+
+    # Transfer-encoding
+    for kwargs in [{"te": True}, {"cl": 100, "te": True}]:
+        kwargs = cast(Dict[str, Any], kwargs)
+        for meth, r in [(None, req(**kwargs)), (b"GET", resp(**kwargs))]:  # type: ignore
+            assert _body_framing(meth, r) == ("chunked", ())
+
+    # Content-Length
+    for meth, r in [(None, req(cl=100)), (b"GET", resp(cl=100))]:  # type: ignore
+        assert _body_framing(meth, r) == ("content-length", (100,))
+
+    # No headers
+    assert _body_framing(None, req()) == ("content-length", (0,))  # type: ignore
+    assert _body_framing(b"GET", resp()) == ("http/1.0", ())
+
+
+def test_Connection_basics_and_content_length() -> None:
+    with pytest.raises(ValueError):
+        Connection("CLIENT")  # type: ignore
+
+    p = ConnectionPair()
+    assert p.conn[CLIENT].our_role is CLIENT
+    assert p.conn[CLIENT].their_role is SERVER
+    assert p.conn[SERVER].our_role is SERVER
+    assert p.conn[SERVER].their_role is CLIENT
+
+    data = p.send(
+        CLIENT,
+        Request(
+            method="GET",
+            target="/",
+            headers=[("Host", "example.com"), ("Content-Length", "10")],
+        ),
+    )
+    assert data == (
+        b"GET / HTTP/1.1\r\n" b"Host: example.com\r\n" b"Content-Length: 10\r\n\r\n"
+    )
+
+    for conn in p.conns:
+        assert conn.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE}
+    assert p.conn[CLIENT].our_state is SEND_BODY
+    assert p.conn[CLIENT].their_state is SEND_RESPONSE
+    assert p.conn[SERVER].our_state is SEND_RESPONSE
+    assert p.conn[SERVER].their_state is SEND_BODY
+
+    assert p.conn[CLIENT].their_http_version is None
+    assert p.conn[SERVER].their_http_version == b"1.1"
+
+    data = p.send(SERVER, InformationalResponse(status_code=100, headers=[]))  # type: ignore[arg-type]
+    assert data == b"HTTP/1.1 100 \r\n\r\n"
+
+    data = p.send(SERVER, Response(status_code=200, headers=[("Content-Length", "11")]))
+    assert data == b"HTTP/1.1 200 \r\nContent-Length: 11\r\n\r\n"
+
+    for conn in p.conns:
+        assert conn.states == {CLIENT: SEND_BODY, SERVER: SEND_BODY}
+
+    assert p.conn[CLIENT].their_http_version == b"1.1"
+    assert p.conn[SERVER].their_http_version == b"1.1"
+
+    data = p.send(CLIENT, Data(data=b"12345"))
+    assert data == b"12345"
+    data = p.send(
+        CLIENT, Data(data=b"67890"), expect=[Data(data=b"67890"), EndOfMessage()]
+    )
+    assert data == b"67890"
+    data = p.send(CLIENT, EndOfMessage(), expect=[])
+    assert data == b""
+
+    for conn in p.conns:
+        assert conn.states == {CLIENT: DONE, SERVER: SEND_BODY}
+
+    data = p.send(SERVER, Data(data=b"1234567890"))
+    assert data == b"1234567890"
+    data = p.send(SERVER, Data(data=b"1"), expect=[Data(data=b"1"), EndOfMessage()])
+    assert data == b"1"
+    data = p.send(SERVER, EndOfMessage(), expect=[])
+    assert data == b""
+
+    for conn in p.conns:
+        assert conn.states == {CLIENT: DONE, SERVER: DONE}
+
+
+def test_chunked() -> None:
+    p = ConnectionPair()
+
+    p.send(
+        CLIENT,
+        Request(
+            method="GET",
+            target="/",
+            headers=[("Host", "example.com"), ("Transfer-Encoding", "chunked")],
+        ),
+    )
+    data = p.send(CLIENT, Data(data=b"1234567890", chunk_start=True, chunk_end=True))
+    assert data == b"a\r\n1234567890\r\n"
+    data = p.send(CLIENT, Data(data=b"abcde", chunk_start=True, chunk_end=True))
+    assert data == b"5\r\nabcde\r\n"
+    data = p.send(CLIENT, Data(data=b""), expect=[])
+    assert data == b""
+    data = p.send(CLIENT, EndOfMessage(headers=[("hello", "there")]))
+    assert data == b"0\r\nhello: there\r\n\r\n"
+
+    p.send(
+        SERVER, Response(status_code=200, headers=[("Transfer-Encoding", "chunked")])
+    )
+    p.send(SERVER, Data(data=b"54321", chunk_start=True, chunk_end=True))
+    p.send(SERVER, Data(data=b"12345", chunk_start=True, chunk_end=True))
+    p.send(SERVER, EndOfMessage())
+
+    for conn in p.conns:
+        assert conn.states == {CLIENT: DONE, SERVER: DONE}
+
+
+def test_chunk_boundaries() -> None:
+    conn = Connection(our_role=SERVER)
+
+    request = (
+        b"POST / HTTP/1.1\r\n"
+        b"Host: example.com\r\n"
+        b"Transfer-Encoding: chunked\r\n"
+        b"\r\n"
+    )
+    conn.receive_data(request)
+    assert conn.next_event() == Request(
+        method="POST",
+        target="/",
+        headers=[("Host", "example.com"), ("Transfer-Encoding", "chunked")],
+    )
+    assert conn.next_event() is NEED_DATA
+
+    conn.receive_data(b"5\r\nhello\r\n")
+    assert conn.next_event() == Data(data=b"hello", chunk_start=True, chunk_end=True)
+
+    conn.receive_data(b"5\r\nhel")
+    assert conn.next_event() == Data(data=b"hel", chunk_start=True, chunk_end=False)
+
+    conn.receive_data(b"l")
+    assert conn.next_event() == Data(data=b"l", chunk_start=False, chunk_end=False)
+
+    conn.receive_data(b"o\r\n")
+    assert conn.next_event() == Data(data=b"o", chunk_start=False, chunk_end=True)
+
+    conn.receive_data(b"5\r\nhello")
+    assert conn.next_event() == Data(data=b"hello", chunk_start=True, chunk_end=True)
+
+    conn.receive_data(b"\r\n")
+    assert conn.next_event() == NEED_DATA
+
+    conn.receive_data(b"0\r\n\r\n")
+    assert conn.next_event() == EndOfMessage()
+
+
+def test_client_talking_to_http10_server() -> None:
+    c = Connection(CLIENT)
+    c.send(Request(method="GET", target="/", headers=[("Host", "example.com")]))
+    c.send(EndOfMessage())
+    assert c.our_state is DONE
+    # No content-length, so Http10 framing for body
+    assert receive_and_get(c, b"HTTP/1.0 200 OK\r\n\r\n") == [
+        Response(status_code=200, headers=[], http_version="1.0", reason=b"OK")  # type: ignore[arg-type]
+    ]
+    assert c.our_state is MUST_CLOSE
+    assert receive_and_get(c, b"12345") == [Data(data=b"12345")]
+    assert receive_and_get(c, b"67890") == [Data(data=b"67890")]
+    assert receive_and_get(c, b"") == [EndOfMessage(), ConnectionClosed()]
+    assert c.their_state is CLOSED
+
+
+def test_server_talking_to_http10_client() -> None:
+    c = Connection(SERVER)
+    # No content-length, so no body
+    # NB: no host header
+    assert receive_and_get(c, b"GET / HTTP/1.0\r\n\r\n") == [
+        Request(method="GET", target="/", headers=[], http_version="1.0"),  # type: ignore[arg-type]
+        EndOfMessage(),
+    ]
+    assert c.their_state is MUST_CLOSE
+
+    # We automatically Connection: close back at them
+    assert (
+        c.send(Response(status_code=200, headers=[]))  # type: ignore[arg-type]
+        == b"HTTP/1.1 200 \r\nConnection: close\r\n\r\n"
+    )
+
+    assert c.send(Data(data=b"12345")) == b"12345"
+    assert c.send(EndOfMessage()) == b""
+    assert c.our_state is MUST_CLOSE
+
+    # Check that it works if they do send Content-Length
+    c = Connection(SERVER)
+    # NB: no host header
+    assert receive_and_get(c, b"POST / HTTP/1.0\r\nContent-Length: 10\r\n\r\n1") == [
+        Request(
+            method="POST",
+            target="/",
+            headers=[("Content-Length", "10")],
+            http_version="1.0",
+        ),
+        Data(data=b"1"),
+    ]
+    assert receive_and_get(c, b"234567890") == [Data(data=b"234567890"), EndOfMessage()]
+    assert c.their_state is MUST_CLOSE
+    assert receive_and_get(c, b"") == [ConnectionClosed()]
+
+
+def test_automatic_transfer_encoding_in_response() -> None:
+    # Check that in responses, the user can specify either Transfer-Encoding:
+    # chunked or no framing at all, and in both cases we automatically select
+    # the right option depending on whether the peer speaks HTTP/1.0 or
+    # HTTP/1.1
+    for user_headers in [
+        [("Transfer-Encoding", "chunked")],
+        [],
+        # In fact, this even works if Content-Length is set,
+        # because if both are set then Transfer-Encoding wins
+        [("Transfer-Encoding", "chunked"), ("Content-Length", "100")],
+    ]:
+        user_headers = cast(List[Tuple[str, str]], user_headers)
+        p = ConnectionPair()
+        p.send(
+            CLIENT,
+            [
+                Request(method="GET", target="/", headers=[("Host", "example.com")]),
+                EndOfMessage(),
+            ],
+        )
+        # When speaking to HTTP/1.1 client, all of the above cases get
+        # normalized to Transfer-Encoding: chunked
+        p.send(
+            SERVER,
+            Response(status_code=200, headers=user_headers),
+            expect=Response(
+                status_code=200, headers=[("Transfer-Encoding", "chunked")]
+            ),
+        )
+
+        # When speaking to HTTP/1.0 client, all of the above cases get
+        # normalized to no-framing-headers
+        c = Connection(SERVER)
+        receive_and_get(c, b"GET / HTTP/1.0\r\n\r\n")
+        assert (
+            c.send(Response(status_code=200, headers=user_headers))
+            == b"HTTP/1.1 200 \r\nConnection: close\r\n\r\n"
+        )
+        assert c.send(Data(data=b"12345")) == b"12345"
+
+
+def test_automagic_connection_close_handling() -> None:
+    p = ConnectionPair()
+    # If the user explicitly sets Connection: close, then we notice and
+    # respect it
+    p.send(
+        CLIENT,
+        [
+            Request(
+                method="GET",
+                target="/",
+                headers=[("Host", "example.com"), ("Connection", "close")],
+            ),
+            EndOfMessage(),
+        ],
+    )
+    for conn in p.conns:
+        assert conn.states[CLIENT] is MUST_CLOSE
+    # And if the client sets it, the server automatically echoes it back
+    p.send(
+        SERVER,
+        # no header here...
+        [Response(status_code=204, headers=[]), EndOfMessage()],  # type: ignore[arg-type]
+        # ...but oh look, it arrived anyway
+        expect=[
+            Response(status_code=204, headers=[("connection", "close")]),
+            EndOfMessage(),
+        ],
+    )
+    for conn in p.conns:
+        assert conn.states == {CLIENT: MUST_CLOSE, SERVER: MUST_CLOSE}
+
+
+def test_100_continue() -> None:
+    def setup() -> ConnectionPair:
+        p = ConnectionPair()
+        p.send(
+            CLIENT,
+            Request(
+                method="GET",
+                target="/",
+                headers=[
+                    ("Host", "example.com"),
+                    ("Content-Length", "100"),
+                    ("Expect", "100-continue"),
+                ],
+            ),
+        )
+        for conn in p.conns:
+            assert conn.client_is_waiting_for_100_continue
+        assert not p.conn[CLIENT].they_are_waiting_for_100_continue
+        assert p.conn[SERVER].they_are_waiting_for_100_continue
+        return p
+
+    # Disabled by 100 Continue
+    p = setup()
+    p.send(SERVER, InformationalResponse(status_code=100, headers=[]))  # type: ignore[arg-type]
+    for conn in p.conns:
+        assert not conn.client_is_waiting_for_100_continue
+        assert not conn.they_are_waiting_for_100_continue
+
+    # Disabled by a real response
+    p = setup()
+    p.send(
+        SERVER, Response(status_code=200, headers=[("Transfer-Encoding", "chunked")])
+    )
+    for conn in p.conns:
+        assert not conn.client_is_waiting_for_100_continue
+        assert not conn.they_are_waiting_for_100_continue
+
+    # Disabled by the client going ahead and sending stuff anyway
+    p = setup()
+    p.send(CLIENT, Data(data=b"12345"))
+    for conn in p.conns:
+        assert not conn.client_is_waiting_for_100_continue
+        assert not conn.they_are_waiting_for_100_continue
+
+
+def test_max_incomplete_event_size_countermeasure() -> None:
+    # Infinitely long headers are definitely not okay
+    c = Connection(SERVER)
+    c.receive_data(b"GET / HTTP/1.0\r\nEndless: ")
+    assert c.next_event() is NEED_DATA
+    with pytest.raises(RemoteProtocolError):
+        while True:
+            c.receive_data(b"a" * 1024)
+            c.next_event()
+
+    # Checking that the same header is accepted / rejected depending on the
+    # max_incomplete_event_size setting:
+    c = Connection(SERVER, max_incomplete_event_size=5000)
+    c.receive_data(b"GET / HTTP/1.0\r\nBig: ")
+    c.receive_data(b"a" * 4000)
+    c.receive_data(b"\r\n\r\n")
+    assert get_all_events(c) == [
+        Request(
+            method="GET", target="/", http_version="1.0", headers=[("big", "a" * 4000)]
+        ),
+        EndOfMessage(),
+    ]
+
+    c = Connection(SERVER, max_incomplete_event_size=4000)
+    c.receive_data(b"GET / HTTP/1.0\r\nBig: ")
+    c.receive_data(b"a" * 4000)
+    with pytest.raises(RemoteProtocolError):
+        c.next_event()
+
+    # Temporarily exceeding the size limit is fine, as long as its done with
+    # complete events:
+    c = Connection(SERVER, max_incomplete_event_size=5000)
+    c.receive_data(b"GET / HTTP/1.0\r\nContent-Length: 10000")
+    c.receive_data(b"\r\n\r\n" + b"a" * 10000)
+    assert get_all_events(c) == [
+        Request(
+            method="GET",
+            target="/",
+            http_version="1.0",
+            headers=[("Content-Length", "10000")],
+        ),
+        Data(data=b"a" * 10000),
+        EndOfMessage(),
+    ]
+
+    c = Connection(SERVER, max_incomplete_event_size=100)
+    # Two pipelined requests to create a way-too-big receive buffer... but
+    # it's fine because we're not checking
+    c.receive_data(
+        b"GET /1 HTTP/1.1\r\nHost: a\r\n\r\n"
+        b"GET /2 HTTP/1.1\r\nHost: b\r\n\r\n" + b"X" * 1000
+    )
+    assert get_all_events(c) == [
+        Request(method="GET", target="/1", headers=[("host", "a")]),
+        EndOfMessage(),
+    ]
+    # Even more data comes in, still no problem
+    c.receive_data(b"X" * 1000)
+    # We can respond and reuse to get the second pipelined request
+    c.send(Response(status_code=200, headers=[]))  # type: ignore[arg-type]
+    c.send(EndOfMessage())
+    c.start_next_cycle()
+    assert get_all_events(c) == [
+        Request(method="GET", target="/2", headers=[("host", "b")]),
+        EndOfMessage(),
+    ]
+    # But once we unpause and try to read the next message, and find that it's
+    # incomplete and the buffer is *still* way too large, then *that's* a
+    # problem:
+    c.send(Response(status_code=200, headers=[]))  # type: ignore[arg-type]
+    c.send(EndOfMessage())
+    c.start_next_cycle()
+    with pytest.raises(RemoteProtocolError):
+        c.next_event()
+
+
+def test_reuse_simple() -> None:
+    p = ConnectionPair()
+    p.send(
+        CLIENT,
+        [Request(method="GET", target="/", headers=[("Host", "a")]), EndOfMessage()],
+    )
+    p.send(
+        SERVER,
+        [
+            Response(status_code=200, headers=[(b"transfer-encoding", b"chunked")]),
+            EndOfMessage(),
+        ],
+    )
+    for conn in p.conns:
+        assert conn.states == {CLIENT: DONE, SERVER: DONE}
+        conn.start_next_cycle()
+
+    p.send(
+        CLIENT,
+        [
+            Request(method="DELETE", target="/foo", headers=[("Host", "a")]),
+            EndOfMessage(),
+        ],
+    )
+    p.send(
+        SERVER,
+        [
+            Response(status_code=404, headers=[(b"transfer-encoding", b"chunked")]),
+            EndOfMessage(),
+        ],
+    )
+
+
+def test_pipelining() -> None:
+    # Client doesn't support pipelining, so we have to do this by hand
+    c = Connection(SERVER)
+    assert c.next_event() is NEED_DATA
+    # 3 requests all bunched up
+    c.receive_data(
+        b"GET /1 HTTP/1.1\r\nHost: a.com\r\nContent-Length: 5\r\n\r\n"
+        b"12345"
+        b"GET /2 HTTP/1.1\r\nHost: a.com\r\nContent-Length: 5\r\n\r\n"
+        b"67890"
+        b"GET /3 HTTP/1.1\r\nHost: a.com\r\n\r\n"
+    )
+    assert get_all_events(c) == [
+        Request(
+            method="GET",
+            target="/1",
+            headers=[("Host", "a.com"), ("Content-Length", "5")],
+        ),
+        Data(data=b"12345"),
+        EndOfMessage(),
+    ]
+    assert c.their_state is DONE
+    assert c.our_state is SEND_RESPONSE
+
+    assert c.next_event() is PAUSED
+
+    c.send(Response(status_code=200, headers=[]))  # type: ignore[arg-type]
+    c.send(EndOfMessage())
+    assert c.their_state is DONE
+    assert c.our_state is DONE
+
+    c.start_next_cycle()
+
+    assert get_all_events(c) == [
+        Request(
+            method="GET",
+            target="/2",
+            headers=[("Host", "a.com"), ("Content-Length", "5")],
+        ),
+        Data(data=b"67890"),
+        EndOfMessage(),
+    ]
+    assert c.next_event() is PAUSED
+    c.send(Response(status_code=200, headers=[]))  # type: ignore[arg-type]
+    c.send(EndOfMessage())
+    c.start_next_cycle()
+
+    assert get_all_events(c) == [
+        Request(method="GET", target="/3", headers=[("Host", "a.com")]),
+        EndOfMessage(),
+    ]
+    # Doesn't pause this time, no trailing data
+    assert c.next_event() is NEED_DATA
+    c.send(Response(status_code=200, headers=[]))  # type: ignore[arg-type]
+    c.send(EndOfMessage())
+
+    # Arrival of more data triggers pause
+    assert c.next_event() is NEED_DATA
+    c.receive_data(b"SADF")
+    assert c.next_event() is PAUSED
+    assert c.trailing_data == (b"SADF", False)
+    # If EOF arrives while paused, we don't see that either:
+    c.receive_data(b"")
+    assert c.trailing_data == (b"SADF", True)
+    assert c.next_event() is PAUSED
+    c.receive_data(b"")
+    assert c.next_event() is PAUSED
+    # Can't call receive_data with non-empty buf after closing it
+    with pytest.raises(RuntimeError):
+        c.receive_data(b"FDSA")
+
+
+def test_protocol_switch() -> None:
+    for (req, deny, accept) in [
+        (
+            Request(
+                method="CONNECT",
+                target="example.com:443",
+                headers=[("Host", "foo"), ("Content-Length", "1")],
+            ),
+            Response(status_code=404, headers=[(b"transfer-encoding", b"chunked")]),
+            Response(status_code=200, headers=[(b"transfer-encoding", b"chunked")]),
+        ),
+        (
+            Request(
+                method="GET",
+                target="/",
+                headers=[("Host", "foo"), ("Content-Length", "1"), ("Upgrade", "a, b")],
+            ),
+            Response(status_code=200, headers=[(b"transfer-encoding", b"chunked")]),
+            InformationalResponse(status_code=101, headers=[("Upgrade", "a")]),
+        ),
+        (
+            Request(
+                method="CONNECT",
+                target="example.com:443",
+                headers=[("Host", "foo"), ("Content-Length", "1"), ("Upgrade", "a, b")],
+            ),
+            Response(status_code=404, headers=[(b"transfer-encoding", b"chunked")]),
+            # Accept CONNECT, not upgrade
+            Response(status_code=200, headers=[(b"transfer-encoding", b"chunked")]),
+        ),
+        (
+            Request(
+                method="CONNECT",
+                target="example.com:443",
+                headers=[("Host", "foo"), ("Content-Length", "1"), ("Upgrade", "a, b")],
+            ),
+            Response(status_code=404, headers=[(b"transfer-encoding", b"chunked")]),
+            # Accept Upgrade, not CONNECT
+            InformationalResponse(status_code=101, headers=[("Upgrade", "b")]),
+        ),
+    ]:
+
+        def setup() -> ConnectionPair:
+            p = ConnectionPair()
+            p.send(CLIENT, req)
+            # No switch-related state change stuff yet; the client has to
+            # finish the request before that kicks in
+            for conn in p.conns:
+                assert conn.states[CLIENT] is SEND_BODY
+            p.send(CLIENT, [Data(data=b"1"), EndOfMessage()])
+            for conn in p.conns:
+                assert conn.states[CLIENT] is MIGHT_SWITCH_PROTOCOL
+            assert p.conn[SERVER].next_event() is PAUSED
+            return p
+
+        # Test deny case
+        p = setup()
+        p.send(SERVER, deny)
+        for conn in p.conns:
+            assert conn.states == {CLIENT: DONE, SERVER: SEND_BODY}
+        p.send(SERVER, EndOfMessage())
+        # Check that re-use is still allowed after a denial
+        for conn in p.conns:
+            conn.start_next_cycle()
+
+        # Test accept case
+        p = setup()
+        p.send(SERVER, accept)
+        for conn in p.conns:
+            assert conn.states == {CLIENT: SWITCHED_PROTOCOL, SERVER: SWITCHED_PROTOCOL}
+            conn.receive_data(b"123")
+            assert conn.next_event() is PAUSED
+            conn.receive_data(b"456")
+            assert conn.next_event() is PAUSED
+            assert conn.trailing_data == (b"123456", False)
+
+        # Pausing in might-switch, then recovery
+        # (weird artificial case where the trailing data actually is valid
+        # HTTP for some reason, because this makes it easier to test the state
+        # logic)
+        p = setup()
+        sc = p.conn[SERVER]
+        sc.receive_data(b"GET / HTTP/1.0\r\n\r\n")
+        assert sc.next_event() is PAUSED
+        assert sc.trailing_data == (b"GET / HTTP/1.0\r\n\r\n", False)
+        sc.send(deny)
+        assert sc.next_event() is PAUSED
+        sc.send(EndOfMessage())
+        sc.start_next_cycle()
+        assert get_all_events(sc) == [
+            Request(method="GET", target="/", headers=[], http_version="1.0"),  # type: ignore[arg-type]
+            EndOfMessage(),
+        ]
+
+        # When we're DONE, have no trailing data, and the connection gets
+        # closed, we report ConnectionClosed(). When we're in might-switch or
+        # switched, we don't.
+        p = setup()
+        sc = p.conn[SERVER]
+        sc.receive_data(b"")
+        assert sc.next_event() is PAUSED
+        assert sc.trailing_data == (b"", True)
+        p.send(SERVER, accept)
+        assert sc.next_event() is PAUSED
+
+        p = setup()
+        sc = p.conn[SERVER]
+        sc.receive_data(b"")
+        assert sc.next_event() is PAUSED
+        sc.send(deny)
+        assert sc.next_event() == ConnectionClosed()
+
+        # You can't send after switching protocols, or while waiting for a
+        # protocol switch
+        p = setup()
+        with pytest.raises(LocalProtocolError):
+            p.conn[CLIENT].send(
+                Request(method="GET", target="/", headers=[("Host", "a")])
+            )
+        p = setup()
+        p.send(SERVER, accept)
+        with pytest.raises(LocalProtocolError):
+            p.conn[SERVER].send(Data(data=b"123"))
+
+
+def test_close_simple() -> None:
+    # Just immediately closing a new connection without anything having
+    # happened yet.
+    for (who_shot_first, who_shot_second) in [(CLIENT, SERVER), (SERVER, CLIENT)]:
+
+        def setup() -> ConnectionPair:
+            p = ConnectionPair()
+            p.send(who_shot_first, ConnectionClosed())
+            for conn in p.conns:
+                assert conn.states == {
+                    who_shot_first: CLOSED,
+                    who_shot_second: MUST_CLOSE,
+                }
+            return p
+
+        # You can keep putting b"" into a closed connection, and you keep
+        # getting ConnectionClosed() out:
+        p = setup()
+        assert p.conn[who_shot_second].next_event() == ConnectionClosed()
+        assert p.conn[who_shot_second].next_event() == ConnectionClosed()
+        p.conn[who_shot_second].receive_data(b"")
+        assert p.conn[who_shot_second].next_event() == ConnectionClosed()
+        # Second party can close...
+        p = setup()
+        p.send(who_shot_second, ConnectionClosed())
+        for conn in p.conns:
+            assert conn.our_state is CLOSED
+            assert conn.their_state is CLOSED
+        # But trying to receive new data on a closed connection is a
+        # RuntimeError (not ProtocolError, because the problem here isn't
+        # violation of HTTP, it's violation of physics)
+        p = setup()
+        with pytest.raises(RuntimeError):
+            p.conn[who_shot_second].receive_data(b"123")
+        # And receiving new data on a MUST_CLOSE connection is a ProtocolError
+        p = setup()
+        p.conn[who_shot_first].receive_data(b"GET")
+        with pytest.raises(RemoteProtocolError):
+            p.conn[who_shot_first].next_event()
+
+
+def test_close_different_states() -> None:
+    req = [
+        Request(method="GET", target="/foo", headers=[("Host", "a")]),
+        EndOfMessage(),
+    ]
+    resp = [
+        Response(status_code=200, headers=[(b"transfer-encoding", b"chunked")]),
+        EndOfMessage(),
+    ]
+
+    # Client before request
+    p = ConnectionPair()
+    p.send(CLIENT, ConnectionClosed())
+    for conn in p.conns:
+        assert conn.states == {CLIENT: CLOSED, SERVER: MUST_CLOSE}
+
+    # Client after request
+    p = ConnectionPair()
+    p.send(CLIENT, req)
+    p.send(CLIENT, ConnectionClosed())
+    for conn in p.conns:
+        assert conn.states == {CLIENT: CLOSED, SERVER: SEND_RESPONSE}
+
+    # Server after request -> not allowed
+    p = ConnectionPair()
+    p.send(CLIENT, req)
+    with pytest.raises(LocalProtocolError):
+        p.conn[SERVER].send(ConnectionClosed())
+    p.conn[CLIENT].receive_data(b"")
+    with pytest.raises(RemoteProtocolError):
+        p.conn[CLIENT].next_event()
+
+    # Server after response
+    p = ConnectionPair()
+    p.send(CLIENT, req)
+    p.send(SERVER, resp)
+    p.send(SERVER, ConnectionClosed())
+    for conn in p.conns:
+        assert conn.states == {CLIENT: MUST_CLOSE, SERVER: CLOSED}
+
+    # Both after closing (ConnectionClosed() is idempotent)
+    p = ConnectionPair()
+    p.send(CLIENT, req)
+    p.send(SERVER, resp)
+    p.send(CLIENT, ConnectionClosed())
+    p.send(SERVER, ConnectionClosed())
+    p.send(CLIENT, ConnectionClosed())
+    p.send(SERVER, ConnectionClosed())
+
+    # In the middle of sending -> not allowed
+    p = ConnectionPair()
+    p.send(
+        CLIENT,
+        Request(
+            method="GET", target="/", headers=[("Host", "a"), ("Content-Length", "10")]
+        ),
+    )
+    with pytest.raises(LocalProtocolError):
+        p.conn[CLIENT].send(ConnectionClosed())
+    p.conn[SERVER].receive_data(b"")
+    with pytest.raises(RemoteProtocolError):
+        p.conn[SERVER].next_event()
+
+
+# Receive several requests and then client shuts down their side of the
+# connection; we can respond to each
+def test_pipelined_close() -> None:
+    c = Connection(SERVER)
+    # 2 requests then a close
+    c.receive_data(
+        b"GET /1 HTTP/1.1\r\nHost: a.com\r\nContent-Length: 5\r\n\r\n"
+        b"12345"
+        b"GET /2 HTTP/1.1\r\nHost: a.com\r\nContent-Length: 5\r\n\r\n"
+        b"67890"
+    )
+    c.receive_data(b"")
+    assert get_all_events(c) == [
+        Request(
+            method="GET",
+            target="/1",
+            headers=[("host", "a.com"), ("content-length", "5")],
+        ),
+        Data(data=b"12345"),
+        EndOfMessage(),
+    ]
+    assert c.states[CLIENT] is DONE
+    c.send(Response(status_code=200, headers=[]))  # type: ignore[arg-type]
+    c.send(EndOfMessage())
+    assert c.states[SERVER] is DONE
+    c.start_next_cycle()
+    assert get_all_events(c) == [
+        Request(
+            method="GET",
+            target="/2",
+            headers=[("host", "a.com"), ("content-length", "5")],
+        ),
+        Data(data=b"67890"),
+        EndOfMessage(),
+        ConnectionClosed(),
+    ]
+    assert c.states == {CLIENT: CLOSED, SERVER: SEND_RESPONSE}
+    c.send(Response(status_code=200, headers=[]))  # type: ignore[arg-type]
+    c.send(EndOfMessage())
+    assert c.states == {CLIENT: CLOSED, SERVER: MUST_CLOSE}
+    c.send(ConnectionClosed())
+    assert c.states == {CLIENT: CLOSED, SERVER: CLOSED}
+
+
+def test_sendfile() -> None:
+    class SendfilePlaceholder:
+        def __len__(self) -> int:
+            return 10
+
+    placeholder = SendfilePlaceholder()
+
+    def setup(
+        header: Tuple[str, str], http_version: str
+    ) -> Tuple[Connection, Optional[List[bytes]]]:
+        c = Connection(SERVER)
+        receive_and_get(
+            c, "GET / HTTP/{}\r\nHost: a\r\n\r\n".format(http_version).encode("ascii")
+        )
+        headers = []
+        if header:
+            headers.append(header)
+        c.send(Response(status_code=200, headers=headers))
+        return c, c.send_with_data_passthrough(Data(data=placeholder))  # type: ignore
+
+    c, data = setup(("Content-Length", "10"), "1.1")
+    assert data == [placeholder]  # type: ignore
+    # Raises an error if the connection object doesn't think we've sent
+    # exactly 10 bytes
+    c.send(EndOfMessage())
+
+    _, data = setup(("Transfer-Encoding", "chunked"), "1.1")
+    assert placeholder in data  # type: ignore
+    data[data.index(placeholder)] = b"x" * 10  # type: ignore
+    assert b"".join(data) == b"a\r\nxxxxxxxxxx\r\n"  # type: ignore
+
+    c, data = setup(None, "1.0")  # type: ignore
+    assert data == [placeholder]  # type: ignore
+    assert c.our_state is SEND_BODY
+
+
+def test_errors() -> None:
+    # After a receive error, you can't receive
+    for role in [CLIENT, SERVER]:
+        c = Connection(our_role=role)
+        c.receive_data(b"gibberish\r\n\r\n")
+        with pytest.raises(RemoteProtocolError):
+            c.next_event()
+        # Now any attempt to receive continues to raise
+        assert c.their_state is ERROR
+        assert c.our_state is not ERROR
+        print(c._cstate.states)
+        with pytest.raises(RemoteProtocolError):
+            c.next_event()
+        # But we can still yell at the client for sending us gibberish
+        if role is SERVER:
+            assert (
+                c.send(Response(status_code=400, headers=[]))  # type: ignore[arg-type]
+                == b"HTTP/1.1 400 \r\nConnection: close\r\n\r\n"
+            )
+
+    # After an error sending, you can no longer send
+    # (This is especially important for things like content-length errors,
+    # where there's complex internal state being modified)
+    def conn(role: Type[Sentinel]) -> Connection:
+        c = Connection(our_role=role)
+        if role is SERVER:
+            # Put it into the state where it *could* send a response...
+            receive_and_get(c, b"GET / HTTP/1.0\r\n\r\n")
+            assert c.our_state is SEND_RESPONSE
+        return c
+
+    for role in [CLIENT, SERVER]:
+        if role is CLIENT:
+            # This HTTP/1.0 request won't be detected as bad until after we go
+            # through the state machine and hit the writing code
+            good = Request(method="GET", target="/", headers=[("Host", "example.com")])
+            bad = Request(
+                method="GET",
+                target="/",
+                headers=[("Host", "example.com")],
+                http_version="1.0",
+            )
+        elif role is SERVER:
+            good = Response(status_code=200, headers=[])  # type: ignore[arg-type,assignment]
+            bad = Response(status_code=200, headers=[], http_version="1.0")  # type: ignore[arg-type,assignment]
+        # Make sure 'good' actually is good
+        c = conn(role)
+        c.send(good)
+        assert c.our_state is not ERROR
+        # Do that again, but this time sending 'bad' first
+        c = conn(role)
+        with pytest.raises(LocalProtocolError):
+            c.send(bad)
+        assert c.our_state is ERROR
+        assert c.their_state is not ERROR
+        # Now 'good' is not so good
+        with pytest.raises(LocalProtocolError):
+            c.send(good)
+
+        # And check send_failed() too
+        c = conn(role)
+        c.send_failed()
+        assert c.our_state is ERROR
+        assert c.their_state is not ERROR
+        # This is idempotent
+        c.send_failed()
+        assert c.our_state is ERROR
+        assert c.their_state is not ERROR
+
+
+def test_idle_receive_nothing() -> None:
+    # At one point this incorrectly raised an error
+    for role in [CLIENT, SERVER]:
+        c = Connection(role)
+        assert c.next_event() is NEED_DATA
+
+
+def test_connection_drop() -> None:
+    c = Connection(SERVER)
+    c.receive_data(b"GET /")
+    assert c.next_event() is NEED_DATA
+    c.receive_data(b"")
+    with pytest.raises(RemoteProtocolError):
+        c.next_event()
+
+
+def test_408_request_timeout() -> None:
+    # Should be able to send this spontaneously as a server without seeing
+    # anything from client
+    p = ConnectionPair()
+    p.send(SERVER, Response(status_code=408, headers=[(b"connection", b"close")]))
+
+
+# This used to raise IndexError
+def test_empty_request() -> None:
+    c = Connection(SERVER)
+    c.receive_data(b"\r\n")
+    with pytest.raises(RemoteProtocolError):
+        c.next_event()
+
+
+# This used to raise IndexError
+def test_empty_response() -> None:
+    c = Connection(CLIENT)
+    c.send(Request(method="GET", target="/", headers=[("Host", "a")]))
+    c.receive_data(b"\r\n")
+    with pytest.raises(RemoteProtocolError):
+        c.next_event()
+
+
+@pytest.mark.parametrize(
+    "data",
+    [
+        b"\x00",
+        b"\x20",
+        b"\x16\x03\x01\x00\xa5",  # Typical start of a TLS Client Hello
+    ],
+)
+def test_early_detection_of_invalid_request(data: bytes) -> None:
+    c = Connection(SERVER)
+    # Early detection should occur before even receiving a `\r\n`
+    c.receive_data(data)
+    with pytest.raises(RemoteProtocolError):
+        c.next_event()
+
+
+@pytest.mark.parametrize(
+    "data",
+    [
+        b"\x00",
+        b"\x20",
+        b"\x16\x03\x03\x00\x31",  # Typical start of a TLS Server Hello
+    ],
+)
+def test_early_detection_of_invalid_response(data: bytes) -> None:
+    c = Connection(CLIENT)
+    # Early detection should occur before even receiving a `\r\n`
+    c.receive_data(data)
+    with pytest.raises(RemoteProtocolError):
+        c.next_event()
+
+
+# This used to give different headers for HEAD and GET.
+# The correct way to handle HEAD is to put whatever headers we *would* have
+# put if it were a GET -- even though we know that for HEAD, those headers
+# will be ignored.
+def test_HEAD_framing_headers() -> None:
+    def setup(method: bytes, http_version: bytes) -> Connection:
+        c = Connection(SERVER)
+        c.receive_data(
+            method + b" / HTTP/" + http_version + b"\r\n" + b"Host: example.com\r\n\r\n"
+        )
+        assert type(c.next_event()) is Request
+        assert type(c.next_event()) is EndOfMessage
+        return c
+
+    for method in [b"GET", b"HEAD"]:
+        # No Content-Length, HTTP/1.1 peer, should use chunked
+        c = setup(method, b"1.1")
+        assert (
+            c.send(Response(status_code=200, headers=[])) == b"HTTP/1.1 200 \r\n"  # type: ignore[arg-type]
+            b"Transfer-Encoding: chunked\r\n\r\n"
+        )
+
+        # No Content-Length, HTTP/1.0 peer, frame with connection: close
+        c = setup(method, b"1.0")
+        assert (
+            c.send(Response(status_code=200, headers=[])) == b"HTTP/1.1 200 \r\n"  # type: ignore[arg-type]
+            b"Connection: close\r\n\r\n"
+        )
+
+        # Content-Length + Transfer-Encoding, TE wins
+        c = setup(method, b"1.1")
+        assert (
+            c.send(
+                Response(
+                    status_code=200,
+                    headers=[
+                        ("Content-Length", "100"),
+                        ("Transfer-Encoding", "chunked"),
+                    ],
+                )
+            )
+            == b"HTTP/1.1 200 \r\n"
+            b"Transfer-Encoding: chunked\r\n\r\n"
+        )
+
+
+def test_special_exceptions_for_lost_connection_in_message_body() -> None:
+    c = Connection(SERVER)
+    c.receive_data(
+        b"POST / HTTP/1.1\r\n" b"Host: example.com\r\n" b"Content-Length: 100\r\n\r\n"
+    )
+    assert type(c.next_event()) is Request
+    assert c.next_event() is NEED_DATA
+    c.receive_data(b"12345")
+    assert c.next_event() == Data(data=b"12345")
+    c.receive_data(b"")
+    with pytest.raises(RemoteProtocolError) as excinfo:
+        c.next_event()
+    assert "received 5 bytes" in str(excinfo.value)
+    assert "expected 100" in str(excinfo.value)
+
+    c = Connection(SERVER)
+    c.receive_data(
+        b"POST / HTTP/1.1\r\n"
+        b"Host: example.com\r\n"
+        b"Transfer-Encoding: chunked\r\n\r\n"
+    )
+    assert type(c.next_event()) is Request
+    assert c.next_event() is NEED_DATA
+    c.receive_data(b"8\r\n012345")
+    assert c.next_event().data == b"012345"  # type: ignore
+    c.receive_data(b"")
+    with pytest.raises(RemoteProtocolError) as excinfo:
+        c.next_event()
+    assert "incomplete chunked read" in str(excinfo.value)
diff --git a/llm/Lib/site-packages/h11/tests/test_events.py b/llm/Lib/site-packages/h11/tests/test_events.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc6c3137063888e05ec4af77bed6c6fd1a3d1594
--- /dev/null
+++ b/llm/Lib/site-packages/h11/tests/test_events.py
@@ -0,0 +1,150 @@
+from http import HTTPStatus
+
+import pytest
+
+from .. import _events
+from .._events import (
+    ConnectionClosed,
+    Data,
+    EndOfMessage,
+    Event,
+    InformationalResponse,
+    Request,
+    Response,
+)
+from .._util import LocalProtocolError
+
+
+def test_events() -> None:
+    with pytest.raises(LocalProtocolError):
+        # Missing Host:
+        req = Request(
+            method="GET", target="/", headers=[("a", "b")], http_version="1.1"
+        )
+    # But this is okay (HTTP/1.0)
+    req = Request(method="GET", target="/", headers=[("a", "b")], http_version="1.0")
+    # fields are normalized
+    assert req.method == b"GET"
+    assert req.target == b"/"
+    assert req.headers == [(b"a", b"b")]
+    assert req.http_version == b"1.0"
+
+    # This is also okay -- has a Host (with weird capitalization, which is ok)
+    req = Request(
+        method="GET",
+        target="/",
+        headers=[("a", "b"), ("hOSt", "example.com")],
+        http_version="1.1",
+    )
+    # we normalize header capitalization
+    assert req.headers == [(b"a", b"b"), (b"host", b"example.com")]
+
+    # Multiple host is bad too
+    with pytest.raises(LocalProtocolError):
+        req = Request(
+            method="GET",
+            target="/",
+            headers=[("Host", "a"), ("Host", "a")],
+            http_version="1.1",
+        )
+    # Even for HTTP/1.0
+    with pytest.raises(LocalProtocolError):
+        req = Request(
+            method="GET",
+            target="/",
+            headers=[("Host", "a"), ("Host", "a")],
+            http_version="1.0",
+        )
+
+    # Header values are validated
+    for bad_char in "\x00\r\n\f\v":
+        with pytest.raises(LocalProtocolError):
+            req = Request(
+                method="GET",
+                target="/",
+                headers=[("Host", "a"), ("Foo", "asd" + bad_char)],
+                http_version="1.0",
+            )
+
+    # But for compatibility we allow non-whitespace control characters, even
+    # though they're forbidden by the spec.
+    Request(
+        method="GET",
+        target="/",
+        headers=[("Host", "a"), ("Foo", "asd\x01\x02\x7f")],
+        http_version="1.0",
+    )
+
+    # Request target is validated
+    for bad_byte in b"\x00\x20\x7f\xee":
+        target = bytearray(b"/")
+        target.append(bad_byte)
+        with pytest.raises(LocalProtocolError):
+            Request(
+                method="GET", target=target, headers=[("Host", "a")], http_version="1.1"
+            )
+
+    # Request method is validated
+    with pytest.raises(LocalProtocolError):
+        Request(
+            method="GET / HTTP/1.1",
+            target=target,
+            headers=[("Host", "a")],
+            http_version="1.1",
+        )
+
+    ir = InformationalResponse(status_code=100, headers=[("Host", "a")])
+    assert ir.status_code == 100
+    assert ir.headers == [(b"host", b"a")]
+    assert ir.http_version == b"1.1"
+
+    with pytest.raises(LocalProtocolError):
+        InformationalResponse(status_code=200, headers=[("Host", "a")])
+
+    resp = Response(status_code=204, headers=[], http_version="1.0")  # type: ignore[arg-type]
+    assert resp.status_code == 204
+    assert resp.headers == []
+    assert resp.http_version == b"1.0"
+
+    with pytest.raises(LocalProtocolError):
+        resp = Response(status_code=100, headers=[], http_version="1.0")  # type: ignore[arg-type]
+
+    with pytest.raises(LocalProtocolError):
+        Response(status_code="100", headers=[], http_version="1.0")  # type: ignore[arg-type]
+
+    with pytest.raises(LocalProtocolError):
+        InformationalResponse(status_code=b"100", headers=[], http_version="1.0")  # type: ignore[arg-type]
+
+    d = Data(data=b"asdf")
+    assert d.data == b"asdf"
+
+    eom = EndOfMessage()
+    assert eom.headers == []
+
+    cc = ConnectionClosed()
+    assert repr(cc) == "ConnectionClosed()"
+
+
+def test_intenum_status_code() -> None:
+    # https://github.com/python-hyper/h11/issues/72
+
+    r = Response(status_code=HTTPStatus.OK, headers=[], http_version="1.0")  # type: ignore[arg-type]
+    assert r.status_code == HTTPStatus.OK
+    assert type(r.status_code) is not type(HTTPStatus.OK)
+    assert type(r.status_code) is int
+
+
+def test_header_casing() -> None:
+    r = Request(
+        method="GET",
+        target="/",
+        headers=[("Host", "example.org"), ("Connection", "keep-alive")],
+        http_version="1.1",
+    )
+    assert len(r.headers) == 2
+    assert r.headers[0] == (b"host", b"example.org")
+    assert r.headers == [(b"host", b"example.org"), (b"connection", b"keep-alive")]
+    assert r.headers.raw_items() == [
+        (b"Host", b"example.org"),
+        (b"Connection", b"keep-alive"),
+    ]
diff --git a/llm/Lib/site-packages/h11/tests/test_headers.py b/llm/Lib/site-packages/h11/tests/test_headers.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba53d088f6f8d22dede47873a03b70a7103da7ea
--- /dev/null
+++ b/llm/Lib/site-packages/h11/tests/test_headers.py
@@ -0,0 +1,157 @@
+import pytest
+
+from .._events import Request
+from .._headers import (
+    get_comma_header,
+    has_expect_100_continue,
+    Headers,
+    normalize_and_validate,
+    set_comma_header,
+)
+from .._util import LocalProtocolError
+
+
+def test_normalize_and_validate() -> None:
+    assert normalize_and_validate([("foo", "bar")]) == [(b"foo", b"bar")]
+    assert normalize_and_validate([(b"foo", b"bar")]) == [(b"foo", b"bar")]
+
+    # no leading/trailing whitespace in names
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([(b"foo ", "bar")])
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([(b" foo", "bar")])
+
+    # no weird characters in names
+    with pytest.raises(LocalProtocolError) as excinfo:
+        normalize_and_validate([(b"foo bar", b"baz")])
+    assert "foo bar" in str(excinfo.value)
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([(b"foo\x00bar", b"baz")])
+    # Not even 8-bit characters:
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([(b"foo\xffbar", b"baz")])
+    # And not even the control characters we allow in values:
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([(b"foo\x01bar", b"baz")])
+
+    # no return or NUL characters in values
+    with pytest.raises(LocalProtocolError) as excinfo:
+        normalize_and_validate([("foo", "bar\rbaz")])
+    assert "bar\\rbaz" in str(excinfo.value)
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([("foo", "bar\nbaz")])
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([("foo", "bar\x00baz")])
+    # no leading/trailing whitespace
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([("foo", "barbaz  ")])
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([("foo", "  barbaz")])
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([("foo", "barbaz\t")])
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([("foo", "\tbarbaz")])
+
+    # content-length
+    assert normalize_and_validate([("Content-Length", "1")]) == [
+        (b"content-length", b"1")
+    ]
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([("Content-Length", "asdf")])
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([("Content-Length", "1x")])
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([("Content-Length", "1"), ("Content-Length", "2")])
+    assert normalize_and_validate(
+        [("Content-Length", "0"), ("Content-Length", "0")]
+    ) == [(b"content-length", b"0")]
+    assert normalize_and_validate([("Content-Length", "0 , 0")]) == [
+        (b"content-length", b"0")
+    ]
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate(
+            [("Content-Length", "1"), ("Content-Length", "1"), ("Content-Length", "2")]
+        )
+    with pytest.raises(LocalProtocolError):
+        normalize_and_validate([("Content-Length", "1 , 1,2")])
+
+    # transfer-encoding
+    assert normalize_and_validate([("Transfer-Encoding", "chunked")]) == [
+        (b"transfer-encoding", b"chunked")
+    ]
+    assert normalize_and_validate([("Transfer-Encoding", "cHuNkEd")]) == [
+        (b"transfer-encoding", b"chunked")
+    ]
+    with pytest.raises(LocalProtocolError) as excinfo:
+        normalize_and_validate([("Transfer-Encoding", "gzip")])
+    assert excinfo.value.error_status_hint == 501  # Not Implemented
+    with pytest.raises(LocalProtocolError) as excinfo:
+        normalize_and_validate(
+            [("Transfer-Encoding", "chunked"), ("Transfer-Encoding", "gzip")]
+        )
+    assert excinfo.value.error_status_hint == 501  # Not Implemented
+
+
+def test_get_set_comma_header() -> None:
+    headers = normalize_and_validate(
+        [
+            ("Connection", "close"),
+            ("whatever", "something"),
+            ("connectiON", "fOo,, , BAR"),
+        ]
+    )
+
+    assert get_comma_header(headers, b"connection") == [b"close", b"foo", b"bar"]
+
+    headers = set_comma_header(headers, b"newthing", ["a", "b"])  # type: ignore
+
+    with pytest.raises(LocalProtocolError):
+        set_comma_header(headers, b"newthing", ["  a", "b"])  # type: ignore
+
+    assert headers == [
+        (b"connection", b"close"),
+        (b"whatever", b"something"),
+        (b"connection", b"fOo,, , BAR"),
+        (b"newthing", b"a"),
+        (b"newthing", b"b"),
+    ]
+
+    headers = set_comma_header(headers, b"whatever", ["different thing"])  # type: ignore
+
+    assert headers == [
+        (b"connection", b"close"),
+        (b"connection", b"fOo,, , BAR"),
+        (b"newthing", b"a"),
+        (b"newthing", b"b"),
+        (b"whatever", b"different thing"),
+    ]
+
+
+def test_has_100_continue() -> None:
+    assert has_expect_100_continue(
+        Request(
+            method="GET",
+            target="/",
+            headers=[("Host", "example.com"), ("Expect", "100-continue")],
+        )
+    )
+    assert not has_expect_100_continue(
+        Request(method="GET", target="/", headers=[("Host", "example.com")])
+    )
+    # Case insensitive
+    assert has_expect_100_continue(
+        Request(
+            method="GET",
+            target="/",
+            headers=[("Host", "example.com"), ("Expect", "100-Continue")],
+        )
+    )
+    # Doesn't work in HTTP/1.0
+    assert not has_expect_100_continue(
+        Request(
+            method="GET",
+            target="/",
+            headers=[("Host", "example.com"), ("Expect", "100-continue")],
+            http_version="1.0",
+        )
+    )
diff --git a/llm/Lib/site-packages/h11/tests/test_helpers.py b/llm/Lib/site-packages/h11/tests/test_helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..c329c767834f73b1dd8991a4ac12d4972a41e98a
--- /dev/null
+++ b/llm/Lib/site-packages/h11/tests/test_helpers.py
@@ -0,0 +1,32 @@
+from .._events import (
+    ConnectionClosed,
+    Data,
+    EndOfMessage,
+    Event,
+    InformationalResponse,
+    Request,
+    Response,
+)
+from .helpers import normalize_data_events
+
+
+def test_normalize_data_events() -> None:
+    assert normalize_data_events(
+        [
+            Data(data=bytearray(b"1")),
+            Data(data=b"2"),
+            Response(status_code=200, headers=[]),  # type: ignore[arg-type]
+            Data(data=b"3"),
+            Data(data=b"4"),
+            EndOfMessage(),
+            Data(data=b"5"),
+            Data(data=b"6"),
+            Data(data=b"7"),
+        ]
+    ) == [
+        Data(data=b"12"),
+        Response(status_code=200, headers=[]),  # type: ignore[arg-type]
+        Data(data=b"34"),
+        EndOfMessage(),
+        Data(data=b"567"),
+    ]
diff --git a/llm/Lib/site-packages/h11/tests/test_io.py b/llm/Lib/site-packages/h11/tests/test_io.py
new file mode 100644
index 0000000000000000000000000000000000000000..2b47c0eac92162646c8b60bd3de65bff1951c895
--- /dev/null
+++ b/llm/Lib/site-packages/h11/tests/test_io.py
@@ -0,0 +1,572 @@
+from typing import Any, Callable, Generator, List
+
+import pytest
+
+from .._events import (
+    ConnectionClosed,
+    Data,
+    EndOfMessage,
+    Event,
+    InformationalResponse,
+    Request,
+    Response,
+)
+from .._headers import Headers, normalize_and_validate
+from .._readers import (
+    _obsolete_line_fold,
+    ChunkedReader,
+    ContentLengthReader,
+    Http10Reader,
+    READERS,
+)
+from .._receivebuffer import ReceiveBuffer
+from .._state import (
+    CLIENT,
+    CLOSED,
+    DONE,
+    IDLE,
+    MIGHT_SWITCH_PROTOCOL,
+    MUST_CLOSE,
+    SEND_BODY,
+    SEND_RESPONSE,
+    SERVER,
+    SWITCHED_PROTOCOL,
+)
+from .._util import LocalProtocolError
+from .._writers import (
+    ChunkedWriter,
+    ContentLengthWriter,
+    Http10Writer,
+    write_any_response,
+    write_headers,
+    write_request,
+    WRITERS,
+)
+from .helpers import normalize_data_events
+
+SIMPLE_CASES = [
+    (
+        (CLIENT, IDLE),
+        Request(
+            method="GET",
+            target="/a",
+            headers=[("Host", "foo"), ("Connection", "close")],
+        ),
+        b"GET /a HTTP/1.1\r\nHost: foo\r\nConnection: close\r\n\r\n",
+    ),
+    (
+        (SERVER, SEND_RESPONSE),
+        Response(status_code=200, headers=[("Connection", "close")], reason=b"OK"),
+        b"HTTP/1.1 200 OK\r\nConnection: close\r\n\r\n",
+    ),
+    (
+        (SERVER, SEND_RESPONSE),
+        Response(status_code=200, headers=[], reason=b"OK"),  # type: ignore[arg-type]
+        b"HTTP/1.1 200 OK\r\n\r\n",
+    ),
+    (
+        (SERVER, SEND_RESPONSE),
+        InformationalResponse(
+            status_code=101, headers=[("Upgrade", "websocket")], reason=b"Upgrade"
+        ),
+        b"HTTP/1.1 101 Upgrade\r\nUpgrade: websocket\r\n\r\n",
+    ),
+    (
+        (SERVER, SEND_RESPONSE),
+        InformationalResponse(status_code=101, headers=[], reason=b"Upgrade"),  # type: ignore[arg-type]
+        b"HTTP/1.1 101 Upgrade\r\n\r\n",
+    ),
+]
+
+
+def dowrite(writer: Callable[..., None], obj: Any) -> bytes:
+    got_list: List[bytes] = []
+    writer(obj, got_list.append)
+    return b"".join(got_list)
+
+
+def tw(writer: Any, obj: Any, expected: Any) -> None:
+    got = dowrite(writer, obj)
+    assert got == expected
+
+
+def makebuf(data: bytes) -> ReceiveBuffer:
+    buf = ReceiveBuffer()
+    buf += data
+    return buf
+
+
+def tr(reader: Any, data: bytes, expected: Any) -> None:
+    def check(got: Any) -> None:
+        assert got == expected
+        # Headers should always be returned as bytes, not e.g. bytearray
+        # https://github.com/python-hyper/wsproto/pull/54#issuecomment-377709478
+        for name, value in getattr(got, "headers", []):
+            assert type(name) is bytes
+            assert type(value) is bytes
+
+    # Simple: consume whole thing
+    buf = makebuf(data)
+    check(reader(buf))
+    assert not buf
+
+    # Incrementally growing buffer
+    buf = ReceiveBuffer()
+    for i in range(len(data)):
+        assert reader(buf) is None
+        buf += data[i : i + 1]
+    check(reader(buf))
+
+    # Trailing data
+    buf = makebuf(data)
+    buf += b"trailing"
+    check(reader(buf))
+    assert bytes(buf) == b"trailing"
+
+
+def test_writers_simple() -> None:
+    for ((role, state), event, binary) in SIMPLE_CASES:
+        tw(WRITERS[role, state], event, binary)
+
+
+def test_readers_simple() -> None:
+    for ((role, state), event, binary) in SIMPLE_CASES:
+        tr(READERS[role, state], binary, event)
+
+
+def test_writers_unusual() -> None:
+    # Simple test of the write_headers utility routine
+    tw(
+        write_headers,
+        normalize_and_validate([("foo", "bar"), ("baz", "quux")]),
+        b"foo: bar\r\nbaz: quux\r\n\r\n",
+    )
+    tw(write_headers, Headers([]), b"\r\n")
+
+    # We understand HTTP/1.0, but we don't speak it
+    with pytest.raises(LocalProtocolError):
+        tw(
+            write_request,
+            Request(
+                method="GET",
+                target="/",
+                headers=[("Host", "foo"), ("Connection", "close")],
+                http_version="1.0",
+            ),
+            None,
+        )
+    with pytest.raises(LocalProtocolError):
+        tw(
+            write_any_response,
+            Response(
+                status_code=200, headers=[("Connection", "close")], http_version="1.0"
+            ),
+            None,
+        )
+
+
+def test_readers_unusual() -> None:
+    # Reading HTTP/1.0
+    tr(
+        READERS[CLIENT, IDLE],
+        b"HEAD /foo HTTP/1.0\r\nSome: header\r\n\r\n",
+        Request(
+            method="HEAD",
+            target="/foo",
+            headers=[("Some", "header")],
+            http_version="1.0",
+        ),
+    )
+
+    # check no-headers, since it's only legal with HTTP/1.0
+    tr(
+        READERS[CLIENT, IDLE],
+        b"HEAD /foo HTTP/1.0\r\n\r\n",
+        Request(method="HEAD", target="/foo", headers=[], http_version="1.0"),  # type: ignore[arg-type]
+    )
+
+    tr(
+        READERS[SERVER, SEND_RESPONSE],
+        b"HTTP/1.0 200 OK\r\nSome: header\r\n\r\n",
+        Response(
+            status_code=200,
+            headers=[("Some", "header")],
+            http_version="1.0",
+            reason=b"OK",
+        ),
+    )
+
+    # single-character header values (actually disallowed by the ABNF in RFC
+    # 7230 -- this is a bug in the standard that we originally copied...)
+    tr(
+        READERS[SERVER, SEND_RESPONSE],
+        b"HTTP/1.0 200 OK\r\n" b"Foo: a a a a a \r\n\r\n",
+        Response(
+            status_code=200,
+            headers=[("Foo", "a a a a a")],
+            http_version="1.0",
+            reason=b"OK",
+        ),
+    )
+
+    # Empty headers -- also legal
+    tr(
+        READERS[SERVER, SEND_RESPONSE],
+        b"HTTP/1.0 200 OK\r\n" b"Foo:\r\n\r\n",
+        Response(
+            status_code=200, headers=[("Foo", "")], http_version="1.0", reason=b"OK"
+        ),
+    )
+
+    tr(
+        READERS[SERVER, SEND_RESPONSE],
+        b"HTTP/1.0 200 OK\r\n" b"Foo: \t \t \r\n\r\n",
+        Response(
+            status_code=200, headers=[("Foo", "")], http_version="1.0", reason=b"OK"
+        ),
+    )
+
+    # Tolerate broken servers that leave off the response code
+    tr(
+        READERS[SERVER, SEND_RESPONSE],
+        b"HTTP/1.0 200\r\n" b"Foo: bar\r\n\r\n",
+        Response(
+            status_code=200, headers=[("Foo", "bar")], http_version="1.0", reason=b""
+        ),
+    )
+
+    # Tolerate headers line endings (\r\n and \n)
+    #    \n\r\b between headers and body
+    tr(
+        READERS[SERVER, SEND_RESPONSE],
+        b"HTTP/1.1 200 OK\r\nSomeHeader: val\n\r\n",
+        Response(
+            status_code=200,
+            headers=[("SomeHeader", "val")],
+            http_version="1.1",
+            reason="OK",
+        ),
+    )
+
+    #   delimited only with \n
+    tr(
+        READERS[SERVER, SEND_RESPONSE],
+        b"HTTP/1.1 200 OK\nSomeHeader1: val1\nSomeHeader2: val2\n\n",
+        Response(
+            status_code=200,
+            headers=[("SomeHeader1", "val1"), ("SomeHeader2", "val2")],
+            http_version="1.1",
+            reason="OK",
+        ),
+    )
+
+    #   mixed \r\n and \n
+    tr(
+        READERS[SERVER, SEND_RESPONSE],
+        b"HTTP/1.1 200 OK\r\nSomeHeader1: val1\nSomeHeader2: val2\n\r\n",
+        Response(
+            status_code=200,
+            headers=[("SomeHeader1", "val1"), ("SomeHeader2", "val2")],
+            http_version="1.1",
+            reason="OK",
+        ),
+    )
+
+    # obsolete line folding
+    tr(
+        READERS[CLIENT, IDLE],
+        b"HEAD /foo HTTP/1.1\r\n"
+        b"Host: example.com\r\n"
+        b"Some: multi-line\r\n"
+        b" header\r\n"
+        b"\tnonsense\r\n"
+        b"    \t   \t\tI guess\r\n"
+        b"Connection: close\r\n"
+        b"More-nonsense: in the\r\n"
+        b"    last header  \r\n\r\n",
+        Request(
+            method="HEAD",
+            target="/foo",
+            headers=[
+                ("Host", "example.com"),
+                ("Some", "multi-line header nonsense I guess"),
+                ("Connection", "close"),
+                ("More-nonsense", "in the last header"),
+            ],
+        ),
+    )
+
+    with pytest.raises(LocalProtocolError):
+        tr(
+            READERS[CLIENT, IDLE],
+            b"HEAD /foo HTTP/1.1\r\n" b"  folded: line\r\n\r\n",
+            None,
+        )
+
+    with pytest.raises(LocalProtocolError):
+        tr(
+            READERS[CLIENT, IDLE],
+            b"HEAD /foo HTTP/1.1\r\n" b"foo  : line\r\n\r\n",
+            None,
+        )
+    with pytest.raises(LocalProtocolError):
+        tr(
+            READERS[CLIENT, IDLE],
+            b"HEAD /foo HTTP/1.1\r\n" b"foo\t: line\r\n\r\n",
+            None,
+        )
+    with pytest.raises(LocalProtocolError):
+        tr(
+            READERS[CLIENT, IDLE],
+            b"HEAD /foo HTTP/1.1\r\n" b"foo\t: line\r\n\r\n",
+            None,
+        )
+    with pytest.raises(LocalProtocolError):
+        tr(READERS[CLIENT, IDLE], b"HEAD /foo HTTP/1.1\r\n" b": line\r\n\r\n", None)
+
+
+def test__obsolete_line_fold_bytes() -> None:
+    # _obsolete_line_fold has a defensive cast to bytearray, which is
+    # necessary to protect against O(n^2) behavior in case anyone ever passes
+    # in regular bytestrings... but right now we never pass in regular
+    # bytestrings. so this test just exists to get some coverage on that
+    # defensive cast.
+    assert list(_obsolete_line_fold([b"aaa", b"bbb", b"  ccc", b"ddd"])) == [
+        b"aaa",
+        bytearray(b"bbb ccc"),
+        b"ddd",
+    ]
+
+
+def _run_reader_iter(
+    reader: Any, buf: bytes, do_eof: bool
+) -> Generator[Any, None, None]:
+    while True:
+        event = reader(buf)
+        if event is None:
+            break
+        yield event
+        # body readers have undefined behavior after returning EndOfMessage,
+        # because this changes the state so they don't get called again
+        if type(event) is EndOfMessage:
+            break
+    if do_eof:
+        assert not buf
+        yield reader.read_eof()
+
+
+def _run_reader(*args: Any) -> List[Event]:
+    events = list(_run_reader_iter(*args))
+    return normalize_data_events(events)
+
+
+def t_body_reader(thunk: Any, data: bytes, expected: Any, do_eof: bool = False) -> None:
+    # Simple: consume whole thing
+    print("Test 1")
+    buf = makebuf(data)
+    assert _run_reader(thunk(), buf, do_eof) == expected
+
+    # Incrementally growing buffer
+    print("Test 2")
+    reader = thunk()
+    buf = ReceiveBuffer()
+    events = []
+    for i in range(len(data)):
+        events += _run_reader(reader, buf, False)
+        buf += data[i : i + 1]
+    events += _run_reader(reader, buf, do_eof)
+    assert normalize_data_events(events) == expected
+
+    is_complete = any(type(event) is EndOfMessage for event in expected)
+    if is_complete and not do_eof:
+        buf = makebuf(data + b"trailing")
+        assert _run_reader(thunk(), buf, False) == expected
+
+
+def test_ContentLengthReader() -> None:
+    t_body_reader(lambda: ContentLengthReader(0), b"", [EndOfMessage()])
+
+    t_body_reader(
+        lambda: ContentLengthReader(10),
+        b"0123456789",
+        [Data(data=b"0123456789"), EndOfMessage()],
+    )
+
+
+def test_Http10Reader() -> None:
+    t_body_reader(Http10Reader, b"", [EndOfMessage()], do_eof=True)
+    t_body_reader(Http10Reader, b"asdf", [Data(data=b"asdf")], do_eof=False)
+    t_body_reader(
+        Http10Reader, b"asdf", [Data(data=b"asdf"), EndOfMessage()], do_eof=True
+    )
+
+
+def test_ChunkedReader() -> None:
+    t_body_reader(ChunkedReader, b"0\r\n\r\n", [EndOfMessage()])
+
+    t_body_reader(
+        ChunkedReader,
+        b"0\r\nSome: header\r\n\r\n",
+        [EndOfMessage(headers=[("Some", "header")])],
+    )
+
+    t_body_reader(
+        ChunkedReader,
+        b"5\r\n01234\r\n"
+        + b"10\r\n0123456789abcdef\r\n"
+        + b"0\r\n"
+        + b"Some: header\r\n\r\n",
+        [
+            Data(data=b"012340123456789abcdef"),
+            EndOfMessage(headers=[("Some", "header")]),
+        ],
+    )
+
+    t_body_reader(
+        ChunkedReader,
+        b"5\r\n01234\r\n" + b"10\r\n0123456789abcdef\r\n" + b"0\r\n\r\n",
+        [Data(data=b"012340123456789abcdef"), EndOfMessage()],
+    )
+
+    # handles upper and lowercase hex
+    t_body_reader(
+        ChunkedReader,
+        b"aA\r\n" + b"x" * 0xAA + b"\r\n" + b"0\r\n\r\n",
+        [Data(data=b"x" * 0xAA), EndOfMessage()],
+    )
+
+    # refuses arbitrarily long chunk integers
+    with pytest.raises(LocalProtocolError):
+        # Technically this is legal HTTP/1.1, but we refuse to process chunk
+        # sizes that don't fit into 20 characters of hex
+        t_body_reader(ChunkedReader, b"9" * 100 + b"\r\nxxx", [Data(data=b"xxx")])
+
+    # refuses garbage in the chunk count
+    with pytest.raises(LocalProtocolError):
+        t_body_reader(ChunkedReader, b"10\x00\r\nxxx", None)
+
+    # handles (and discards) "chunk extensions" omg wtf
+    t_body_reader(
+        ChunkedReader,
+        b"5; hello=there\r\n"
+        + b"xxxxx"
+        + b"\r\n"
+        + b'0; random="junk"; some=more; canbe=lonnnnngg\r\n\r\n',
+        [Data(data=b"xxxxx"), EndOfMessage()],
+    )
+
+    t_body_reader(
+        ChunkedReader,
+        b"5   	 \r\n01234\r\n" + b"0\r\n\r\n",
+        [Data(data=b"01234"), EndOfMessage()],
+    )
+
+
+def test_ContentLengthWriter() -> None:
+    w = ContentLengthWriter(5)
+    assert dowrite(w, Data(data=b"123")) == b"123"
+    assert dowrite(w, Data(data=b"45")) == b"45"
+    assert dowrite(w, EndOfMessage()) == b""
+
+    w = ContentLengthWriter(5)
+    with pytest.raises(LocalProtocolError):
+        dowrite(w, Data(data=b"123456"))
+
+    w = ContentLengthWriter(5)
+    dowrite(w, Data(data=b"123"))
+    with pytest.raises(LocalProtocolError):
+        dowrite(w, Data(data=b"456"))
+
+    w = ContentLengthWriter(5)
+    dowrite(w, Data(data=b"123"))
+    with pytest.raises(LocalProtocolError):
+        dowrite(w, EndOfMessage())
+
+    w = ContentLengthWriter(5)
+    dowrite(w, Data(data=b"123")) == b"123"
+    dowrite(w, Data(data=b"45")) == b"45"
+    with pytest.raises(LocalProtocolError):
+        dowrite(w, EndOfMessage(headers=[("Etag", "asdf")]))
+
+
+def test_ChunkedWriter() -> None:
+    w = ChunkedWriter()
+    assert dowrite(w, Data(data=b"aaa")) == b"3\r\naaa\r\n"
+    assert dowrite(w, Data(data=b"a" * 20)) == b"14\r\n" + b"a" * 20 + b"\r\n"
+
+    assert dowrite(w, Data(data=b"")) == b""
+
+    assert dowrite(w, EndOfMessage()) == b"0\r\n\r\n"
+
+    assert (
+        dowrite(w, EndOfMessage(headers=[("Etag", "asdf"), ("a", "b")]))
+        == b"0\r\nEtag: asdf\r\na: b\r\n\r\n"
+    )
+
+
+def test_Http10Writer() -> None:
+    w = Http10Writer()
+    assert dowrite(w, Data(data=b"1234")) == b"1234"
+    assert dowrite(w, EndOfMessage()) == b""
+
+    with pytest.raises(LocalProtocolError):
+        dowrite(w, EndOfMessage(headers=[("Etag", "asdf")]))
+
+
+def test_reject_garbage_after_request_line() -> None:
+    with pytest.raises(LocalProtocolError):
+        tr(READERS[SERVER, SEND_RESPONSE], b"HTTP/1.0 200 OK\x00xxxx\r\n\r\n", None)
+
+
+def test_reject_garbage_after_response_line() -> None:
+    with pytest.raises(LocalProtocolError):
+        tr(
+            READERS[CLIENT, IDLE],
+            b"HEAD /foo HTTP/1.1 xxxxxx\r\n" b"Host: a\r\n\r\n",
+            None,
+        )
+
+
+def test_reject_garbage_in_header_line() -> None:
+    with pytest.raises(LocalProtocolError):
+        tr(
+            READERS[CLIENT, IDLE],
+            b"HEAD /foo HTTP/1.1\r\n" b"Host: foo\x00bar\r\n\r\n",
+            None,
+        )
+
+
+def test_reject_non_vchar_in_path() -> None:
+    for bad_char in b"\x00\x20\x7f\xee":
+        message = bytearray(b"HEAD /")
+        message.append(bad_char)
+        message.extend(b" HTTP/1.1\r\nHost: foobar\r\n\r\n")
+        with pytest.raises(LocalProtocolError):
+            tr(READERS[CLIENT, IDLE], message, None)
+
+
+# https://github.com/python-hyper/h11/issues/57
+def test_allow_some_garbage_in_cookies() -> None:
+    tr(
+        READERS[CLIENT, IDLE],
+        b"HEAD /foo HTTP/1.1\r\n"
+        b"Host: foo\r\n"
+        b"Set-Cookie: ___utmvafIumyLc=kUd\x01UpAt; path=/; Max-Age=900\r\n"
+        b"\r\n",
+        Request(
+            method="HEAD",
+            target="/foo",
+            headers=[
+                ("Host", "foo"),
+                ("Set-Cookie", "___utmvafIumyLc=kUd\x01UpAt; path=/; Max-Age=900"),
+            ],
+        ),
+    )
+
+
+def test_host_comes_first() -> None:
+    tw(
+        write_headers,
+        normalize_and_validate([("foo", "bar"), ("Host", "example.com")]),
+        b"Host: example.com\r\nfoo: bar\r\n\r\n",
+    )
diff --git a/llm/Lib/site-packages/h11/tests/test_receivebuffer.py b/llm/Lib/site-packages/h11/tests/test_receivebuffer.py
new file mode 100644
index 0000000000000000000000000000000000000000..21a3870b6be9a6a365037326c2085ff2715022cc
--- /dev/null
+++ b/llm/Lib/site-packages/h11/tests/test_receivebuffer.py
@@ -0,0 +1,135 @@
+import re
+from typing import Tuple
+
+import pytest
+
+from .._receivebuffer import ReceiveBuffer
+
+
+def test_receivebuffer() -> None:
+    b = ReceiveBuffer()
+    assert not b
+    assert len(b) == 0
+    assert bytes(b) == b""
+
+    b += b"123"
+    assert b
+    assert len(b) == 3
+    assert bytes(b) == b"123"
+
+    assert bytes(b) == b"123"
+
+    assert b.maybe_extract_at_most(2) == b"12"
+    assert b
+    assert len(b) == 1
+    assert bytes(b) == b"3"
+
+    assert bytes(b) == b"3"
+
+    assert b.maybe_extract_at_most(10) == b"3"
+    assert bytes(b) == b""
+
+    assert b.maybe_extract_at_most(10) is None
+    assert not b
+
+    ################################################################
+    # maybe_extract_until_next
+    ################################################################
+
+    b += b"123\n456\r\n789\r\n"
+
+    assert b.maybe_extract_next_line() == b"123\n456\r\n"
+    assert bytes(b) == b"789\r\n"
+
+    assert b.maybe_extract_next_line() == b"789\r\n"
+    assert bytes(b) == b""
+
+    b += b"12\r"
+    assert b.maybe_extract_next_line() is None
+    assert bytes(b) == b"12\r"
+
+    b += b"345\n\r"
+    assert b.maybe_extract_next_line() is None
+    assert bytes(b) == b"12\r345\n\r"
+
+    # here we stopped at the middle of b"\r\n" delimiter
+
+    b += b"\n6789aaa123\r\n"
+    assert b.maybe_extract_next_line() == b"12\r345\n\r\n"
+    assert b.maybe_extract_next_line() == b"6789aaa123\r\n"
+    assert b.maybe_extract_next_line() is None
+    assert bytes(b) == b""
+
+    ################################################################
+    # maybe_extract_lines
+    ################################################################
+
+    b += b"123\r\na: b\r\nfoo:bar\r\n\r\ntrailing"
+    lines = b.maybe_extract_lines()
+    assert lines == [b"123", b"a: b", b"foo:bar"]
+    assert bytes(b) == b"trailing"
+
+    assert b.maybe_extract_lines() is None
+
+    b += b"\r\n\r"
+    assert b.maybe_extract_lines() is None
+
+    assert b.maybe_extract_at_most(100) == b"trailing\r\n\r"
+    assert not b
+
+    # Empty body case (as happens at the end of chunked encoding if there are
+    # no trailing headers, e.g.)
+    b += b"\r\ntrailing"
+    assert b.maybe_extract_lines() == []
+    assert bytes(b) == b"trailing"
+
+
+@pytest.mark.parametrize(
+    "data",
+    [
+        pytest.param(
+            (
+                b"HTTP/1.1 200 OK\r\n",
+                b"Content-type: text/plain\r\n",
+                b"Connection: close\r\n",
+                b"\r\n",
+                b"Some body",
+            ),
+            id="with_crlf_delimiter",
+        ),
+        pytest.param(
+            (
+                b"HTTP/1.1 200 OK\n",
+                b"Content-type: text/plain\n",
+                b"Connection: close\n",
+                b"\n",
+                b"Some body",
+            ),
+            id="with_lf_only_delimiter",
+        ),
+        pytest.param(
+            (
+                b"HTTP/1.1 200 OK\n",
+                b"Content-type: text/plain\r\n",
+                b"Connection: close\n",
+                b"\n",
+                b"Some body",
+            ),
+            id="with_mixed_crlf_and_lf",
+        ),
+    ],
+)
+def test_receivebuffer_for_invalid_delimiter(data: Tuple[bytes]) -> None:
+    b = ReceiveBuffer()
+
+    for line in data:
+        b += line
+
+    lines = b.maybe_extract_lines()
+
+    assert lines == [
+        b"HTTP/1.1 200 OK",
+        b"Content-type: text/plain",
+        b"Connection: close",
+    ]
+    assert bytes(b) == b"Some body"
diff --git a/llm/Lib/site-packages/h11/tests/test_state.py b/llm/Lib/site-packages/h11/tests/test_state.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc974e636e9f3e9b66022d2095cd670a9acbdcd9
--- /dev/null
+++ b/llm/Lib/site-packages/h11/tests/test_state.py
@@ -0,0 +1,271 @@
+import pytest
+
+from .._events import (
+    ConnectionClosed,
+    Data,
+    EndOfMessage,
+    Event,
+    InformationalResponse,
+    Request,
+    Response,
+)
+from .._state import (
+    _SWITCH_CONNECT,
+    _SWITCH_UPGRADE,
+    CLIENT,
+    CLOSED,
+    ConnectionState,
+    DONE,
+    IDLE,
+    MIGHT_SWITCH_PROTOCOL,
+    MUST_CLOSE,
+    SEND_BODY,
+    SEND_RESPONSE,
+    SERVER,
+    SWITCHED_PROTOCOL,
+)
+from .._util import LocalProtocolError
+
+
+def test_ConnectionState() -> None:
+    cs = ConnectionState()
+
+    # Basic event-triggered transitions
+
+    assert cs.states == {CLIENT: IDLE, SERVER: IDLE}
+
+    cs.process_event(CLIENT, Request)
+    # The SERVER-Request special case:
+    assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE}
+
+    # Illegal transitions raise an error and nothing happens
+    with pytest.raises(LocalProtocolError):
+        cs.process_event(CLIENT, Request)
+    assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE}
+
+    cs.process_event(SERVER, InformationalResponse)
+    assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE}
+
+    cs.process_event(SERVER, Response)
+    assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_BODY}
+
+    cs.process_event(CLIENT, EndOfMessage)
+    cs.process_event(SERVER, EndOfMessage)
+    assert cs.states == {CLIENT: DONE, SERVER: DONE}
+
+    # State-triggered transition
+
+    cs.process_event(SERVER, ConnectionClosed)
+    assert cs.states == {CLIENT: MUST_CLOSE, SERVER: CLOSED}
+
+
+def test_ConnectionState_keep_alive() -> None:
+    # keep_alive = False
+    cs = ConnectionState()
+    cs.process_event(CLIENT, Request)
+    cs.process_keep_alive_disabled()
+    cs.process_event(CLIENT, EndOfMessage)
+    assert cs.states == {CLIENT: MUST_CLOSE, SERVER: SEND_RESPONSE}
+
+    cs.process_event(SERVER, Response)
+    cs.process_event(SERVER, EndOfMessage)
+    assert cs.states == {CLIENT: MUST_CLOSE, SERVER: MUST_CLOSE}
+
+
+def test_ConnectionState_keep_alive_in_DONE() -> None:
+    # Check that if keep_alive is disabled when the CLIENT is already in DONE,
+    # then this is sufficient to immediately trigger the DONE -> MUST_CLOSE
+    # transition
+    cs = ConnectionState()
+    cs.process_event(CLIENT, Request)
+    cs.process_event(CLIENT, EndOfMessage)
+    assert cs.states[CLIENT] is DONE
+    cs.process_keep_alive_disabled()
+    assert cs.states[CLIENT] is MUST_CLOSE
+
+
+def test_ConnectionState_switch_denied() -> None:
+    for switch_type in (_SWITCH_CONNECT, _SWITCH_UPGRADE):
+        for deny_early in (True, False):
+            cs = ConnectionState()
+            cs.process_client_switch_proposal(switch_type)
+            cs.process_event(CLIENT, Request)
+            cs.process_event(CLIENT, Data)
+            assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE}
+
+            assert switch_type in cs.pending_switch_proposals
+
+            if deny_early:
+                # before client reaches DONE
+                cs.process_event(SERVER, Response)
+                assert not cs.pending_switch_proposals
+
+            cs.process_event(CLIENT, EndOfMessage)
+
+            if deny_early:
+                assert cs.states == {CLIENT: DONE, SERVER: SEND_BODY}
+            else:
+                assert cs.states == {
+                    CLIENT: MIGHT_SWITCH_PROTOCOL,
+                    SERVER: SEND_RESPONSE,
+                }
+
+                cs.process_event(SERVER, InformationalResponse)
+                assert cs.states == {
+                    CLIENT: MIGHT_SWITCH_PROTOCOL,
+                    SERVER: SEND_RESPONSE,
+                }
+
+                cs.process_event(SERVER, Response)
+                assert cs.states == {CLIENT: DONE, SERVER: SEND_BODY}
+                assert not cs.pending_switch_proposals
+
+
+_response_type_for_switch = {
+    _SWITCH_UPGRADE: InformationalResponse,
+    _SWITCH_CONNECT: Response,
+    None: Response,
+}
+
+
+def test_ConnectionState_protocol_switch_accepted() -> None:
+    for switch_event in [_SWITCH_UPGRADE, _SWITCH_CONNECT]:
+        cs = ConnectionState()
+        cs.process_client_switch_proposal(switch_event)
+        cs.process_event(CLIENT, Request)
+        cs.process_event(CLIENT, Data)
+        assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE}
+
+        cs.process_event(CLIENT, EndOfMessage)
+        assert cs.states == {CLIENT: MIGHT_SWITCH_PROTOCOL, SERVER: SEND_RESPONSE}
+
+        cs.process_event(SERVER, InformationalResponse)
+        assert cs.states == {CLIENT: MIGHT_SWITCH_PROTOCOL, SERVER: SEND_RESPONSE}
+
+        cs.process_event(SERVER, _response_type_for_switch[switch_event], switch_event)
+        assert cs.states == {CLIENT: SWITCHED_PROTOCOL, SERVER: SWITCHED_PROTOCOL}
+
+
+def test_ConnectionState_double_protocol_switch() -> None:
+    # CONNECT + Upgrade is legal! Very silly, but legal. So we support
+    # it. Because sometimes doing the silly thing is easier than not.
+    for server_switch in [None, _SWITCH_UPGRADE, _SWITCH_CONNECT]:
+        cs = ConnectionState()
+        cs.process_client_switch_proposal(_SWITCH_UPGRADE)
+        cs.process_client_switch_proposal(_SWITCH_CONNECT)
+        cs.process_event(CLIENT, Request)
+        cs.process_event(CLIENT, EndOfMessage)
+        assert cs.states == {CLIENT: MIGHT_SWITCH_PROTOCOL, SERVER: SEND_RESPONSE}
+        cs.process_event(
+            SERVER, _response_type_for_switch[server_switch], server_switch
+        )
+        if server_switch is None:
+            assert cs.states == {CLIENT: DONE, SERVER: SEND_BODY}
+        else:
+            assert cs.states == {CLIENT: SWITCHED_PROTOCOL, SERVER: SWITCHED_PROTOCOL}
+
+
+def test_ConnectionState_inconsistent_protocol_switch() -> None:
+    for client_switches, server_switch in [
+        ([], _SWITCH_CONNECT),
+        ([], _SWITCH_UPGRADE),
+        ([_SWITCH_UPGRADE], _SWITCH_CONNECT),
+        ([_SWITCH_CONNECT], _SWITCH_UPGRADE),
+    ]:
+        cs = ConnectionState()
+        for client_switch in client_switches:  # type: ignore[attr-defined]
+            cs.process_client_switch_proposal(client_switch)
+        cs.process_event(CLIENT, Request)
+        with pytest.raises(LocalProtocolError):
+            cs.process_event(SERVER, Response, server_switch)
+
+
+def test_ConnectionState_keepalive_protocol_switch_interaction() -> None:
+    # keep_alive=False + pending_switch_proposals
+    cs = ConnectionState()
+    cs.process_client_switch_proposal(_SWITCH_UPGRADE)
+    cs.process_event(CLIENT, Request)
+    cs.process_keep_alive_disabled()
+    cs.process_event(CLIENT, Data)
+    assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE}
+
+    # the protocol switch "wins"
+    cs.process_event(CLIENT, EndOfMessage)
+    assert cs.states == {CLIENT: MIGHT_SWITCH_PROTOCOL, SERVER: SEND_RESPONSE}
+
+    # but when the server denies the request, keep_alive comes back into play
+    cs.process_event(SERVER, Response)
+    assert cs.states == {CLIENT: MUST_CLOSE, SERVER: SEND_BODY}
+
+
+def test_ConnectionState_reuse() -> None:
+    cs = ConnectionState()
+
+    with pytest.raises(LocalProtocolError):
+        cs.start_next_cycle()
+
+    cs.process_event(CLIENT, Request)
+    cs.process_event(CLIENT, EndOfMessage)
+
+    with pytest.raises(LocalProtocolError):
+        cs.start_next_cycle()
+
+    cs.process_event(SERVER, Response)
+    cs.process_event(SERVER, EndOfMessage)
+
+    cs.start_next_cycle()
+    assert cs.states == {CLIENT: IDLE, SERVER: IDLE}
+
+    # No keepalive
+
+    cs.process_event(CLIENT, Request)
+    cs.process_keep_alive_disabled()
+    cs.process_event(CLIENT, EndOfMessage)
+    cs.process_event(SERVER, Response)
+    cs.process_event(SERVER, EndOfMessage)
+
+    with pytest.raises(LocalProtocolError):
+        cs.start_next_cycle()
+
+    # One side closed
+
+    cs = ConnectionState()
+    cs.process_event(CLIENT, Request)
+    cs.process_event(CLIENT, EndOfMessage)
+    cs.process_event(CLIENT, ConnectionClosed)
+    cs.process_event(SERVER, Response)
+    cs.process_event(SERVER, EndOfMessage)
+
+    with pytest.raises(LocalProtocolError):
+        cs.start_next_cycle()
+
+    # Succesful protocol switch
+
+    cs = ConnectionState()
+    cs.process_client_switch_proposal(_SWITCH_UPGRADE)
+    cs.process_event(CLIENT, Request)
+    cs.process_event(CLIENT, EndOfMessage)
+    cs.process_event(SERVER, InformationalResponse, _SWITCH_UPGRADE)
+
+    with pytest.raises(LocalProtocolError):
+        cs.start_next_cycle()
+
+    # Failed protocol switch
+
+    cs = ConnectionState()
+    cs.process_client_switch_proposal(_SWITCH_UPGRADE)
+    cs.process_event(CLIENT, Request)
+    cs.process_event(CLIENT, EndOfMessage)
+    cs.process_event(SERVER, Response)
+    cs.process_event(SERVER, EndOfMessage)
+
+    cs.start_next_cycle()
+    assert cs.states == {CLIENT: IDLE, SERVER: IDLE}
+
+
+def test_server_request_is_illegal() -> None:
+    # There used to be a bug in how we handled the Request special case that
+    # made this allowed...
+    cs = ConnectionState()
+    with pytest.raises(LocalProtocolError):
+        cs.process_event(SERVER, Request)
diff --git a/llm/Lib/site-packages/h11/tests/test_util.py b/llm/Lib/site-packages/h11/tests/test_util.py
new file mode 100644
index 0000000000000000000000000000000000000000..79bc095185c79313b238fb034ef746c7f67b9d93
--- /dev/null
+++ b/llm/Lib/site-packages/h11/tests/test_util.py
@@ -0,0 +1,112 @@
+import re
+import sys
+import traceback
+from typing import NoReturn
+
+import pytest
+
+from .._util import (
+    bytesify,
+    LocalProtocolError,
+    ProtocolError,
+    RemoteProtocolError,
+    Sentinel,
+    validate,
+)
+
+
+def test_ProtocolError() -> None:
+    with pytest.raises(TypeError):
+        ProtocolError("abstract base class")
+
+
+def test_LocalProtocolError() -> None:
+    try:
+        raise LocalProtocolError("foo")
+    except LocalProtocolError as e:
+        assert str(e) == "foo"
+        assert e.error_status_hint == 400
+
+    try:
+        raise LocalProtocolError("foo", error_status_hint=418)
+    except LocalProtocolError as e:
+        assert str(e) == "foo"
+        assert e.error_status_hint == 418
+
+    def thunk() -> NoReturn:
+        raise LocalProtocolError("a", error_status_hint=420)
+
+    try:
+        try:
+            thunk()
+        except LocalProtocolError as exc1:
+            orig_traceback = "".join(traceback.format_tb(sys.exc_info()[2]))
+            exc1._reraise_as_remote_protocol_error()
+    except RemoteProtocolError as exc2:
+        assert type(exc2) is RemoteProtocolError
+        assert exc2.args == ("a",)
+        assert exc2.error_status_hint == 420
+        new_traceback = "".join(traceback.format_tb(sys.exc_info()[2]))
+        assert new_traceback.endswith(orig_traceback)
+
+
+def test_validate() -> None:
+    my_re = re.compile(rb"(?P<group1>[0-9]+)\.(?P<group2>[0-9]+)")
+    with pytest.raises(LocalProtocolError):
+        validate(my_re, b"0.")
+
+    groups = validate(my_re, b"0.1")
+    assert groups == {"group1": b"0", "group2": b"1"}
+
+    # successful partial matches are an error - must match whole string
+    with pytest.raises(LocalProtocolError):
+        validate(my_re, b"0.1xx")
+    with pytest.raises(LocalProtocolError):
+        validate(my_re, b"0.1\n")
+
+
+def test_validate_formatting() -> None:
+    my_re = re.compile(rb"foo")
+
+    with pytest.raises(LocalProtocolError) as excinfo:
+        validate(my_re, b"", "oops")
+    assert "oops" in str(excinfo.value)
+
+    with pytest.raises(LocalProtocolError) as excinfo:
+        validate(my_re, b"", "oops {}")
+    assert "oops {}" in str(excinfo.value)
+
+    with pytest.raises(LocalProtocolError) as excinfo:
+        validate(my_re, b"", "oops {} xx", 10)
+    assert "oops 10 xx" in str(excinfo.value)
+
+
+def test_make_sentinel() -> None:
+    class S(Sentinel, metaclass=Sentinel):
+        pass
+
+    assert repr(S) == "S"
+    assert S == S
+    assert type(S).__name__ == "S"
+    assert S in {S}
+    assert type(S) is S
+
+    class S2(Sentinel, metaclass=Sentinel):
+        pass
+
+    assert repr(S2) == "S2"
+    assert S != S2
+    assert S not in {S2}
+    assert type(S) is not type(S2)
+
+
+def test_bytesify() -> None:
+    assert bytesify(b"123") == b"123"
+    assert bytesify(bytearray(b"123")) == b"123"
+    assert bytesify("123") == b"123"
+
+    with pytest.raises(UnicodeEncodeError):
+        bytesify("\u1234")
+
+    with pytest.raises(TypeError):
+        bytesify(10)
diff --git a/llm/Lib/site-packages/h2-4.1.0.dist-info/INSTALLER b/llm/Lib/site-packages/h2-4.1.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/h2-4.1.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/h2-4.1.0.dist-info/LICENSE b/llm/Lib/site-packages/h2-4.1.0.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..db41662749ab7222cefbb4cfe1167be750597a06
--- /dev/null
+++ b/llm/Lib/site-packages/h2-4.1.0.dist-info/LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2020 Cory Benfield and contributors
+
+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
+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.
diff --git a/llm/Lib/site-packages/h2-4.1.0.dist-info/METADATA b/llm/Lib/site-packages/h2-4.1.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..2b850e9cf848654d78e7e8a909120f9f0adc6e87
--- /dev/null
+++ b/llm/Lib/site-packages/h2-4.1.0.dist-info/METADATA
@@ -0,0 +1,106 @@
+Metadata-Version: 2.1
+Name: h2
+Version: 4.1.0
+Summary: HTTP/2 State-Machine based protocol implementation
+Home-page: https://github.com/python-hyper/h2
+Author: Cory Benfield
+Author-email: cory@lukasa.co.uk
+License: MIT License
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.6.1
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: hyperframe (<7,>=6.0)
+Requires-Dist: hpack (<5,>=4.0)
+
+=========================
+h2: HTTP/2 Protocol Stack
+=========================
+
+.. image:: https://github.com/python-hyper/h2/workflows/CI/badge.svg
+    :target: https://github.com/python-hyper/h2/actions
+    :alt: Build Status
+.. image:: https://codecov.io/gh/python-hyper/h2/branch/master/graph/badge.svg
+    :target: https://codecov.io/gh/python-hyper/h2
+    :alt: Code Coverage
+.. image:: https://readthedocs.org/projects/h2/badge/?version=latest
+    :target: https://h2.readthedocs.io/en/latest/
+    :alt: Documentation Status
+.. image:: https://img.shields.io/badge/chat-join_now-brightgreen.svg
+    :target: https://gitter.im/python-hyper/community
+    :alt: Chat community
+
+.. image:: https://raw.github.com/python-hyper/documentation/master/source/logo/hyper-black-bg-white.png
+
+This repository contains a pure-Python implementation of a HTTP/2 protocol
+stack. It's written from the ground up to be embeddable in whatever program you
+choose to use, ensuring that you can speak HTTP/2 regardless of your
+programming paradigm.
+
+You use it like this:
+
+.. code-block:: python
+
+    import h2.connection
+    import h2.config
+
+    config = h2.config.H2Configuration()
+    conn = h2.connection.H2Connection(config=config)
+    conn.send_headers(stream_id=stream_id, headers=headers)
+    conn.send_data(stream_id, data)
+    socket.sendall(conn.data_to_send())
+    events = conn.receive_data(socket_data)
+
+This repository does not provide a parsing layer, a network layer, or any rules
+about concurrency. Instead, it's a purely in-memory solution, defined in terms
+of data actions and HTTP/2 frames. This is one building block of a full Python
+HTTP implementation.
+
+To install it, just run:
+
+.. code-block:: console
+
+    $ python -m pip install h2
+
+Documentation
+=============
+
+Documentation is available at https://h2.readthedocs.io .
+
+Contributing
+============
+
+``h2`` welcomes contributions from anyone! Unlike many other projects we
+are happy to accept cosmetic contributions and small contributions, in addition
+to large feature requests and changes.
+
+Before you contribute (either by opening an issue or filing a pull request),
+please `read the contribution guidelines`_.
+
+.. _read the contribution guidelines: http://python-hyper.org/en/latest/contributing.html
+
+License
+=======
+
+``h2`` is made available under the MIT License. For more details, see the
+``LICENSE`` file in the repository.
+
+Authors
+=======
+
+``h2`` was authored by Cory Benfield and is maintained
+by the members of `python-hyper <https://github.com/orgs/python-hyper/people>`_.
+
+
diff --git a/llm/Lib/site-packages/h2-4.1.0.dist-info/RECORD b/llm/Lib/site-packages/h2-4.1.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..738381a5d87adc220d1efad5eae05ae1881cb206
--- /dev/null
+++ b/llm/Lib/site-packages/h2-4.1.0.dist-info/RECORD
@@ -0,0 +1,28 @@
+h2-4.1.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+h2-4.1.0.dist-info/LICENSE,sha256=emWlrwy6vxwWJRx8ayt8tG0WpyIueZdbm2H81mouPyg,1102
+h2-4.1.0.dist-info/METADATA,sha256=xQTqopWF9r3ZVkT-xCDHAWWZQB3g_zyqgKxCl0ioR6Q,3583
+h2-4.1.0.dist-info/RECORD,,
+h2-4.1.0.dist-info/WHEEL,sha256=OqRkF0eY5GHssMorFjlbTIq072vpHpF60fIQA6lS9xA,92
+h2-4.1.0.dist-info/top_level.txt,sha256=Hiulx8KxI2jFUM1dG7-CZeRkO3j50MBwCLG36Vrq-kI,3
+h2/__init__.py,sha256=inV-bCAUhD_QGjQe5Mk8gl7F85v26UW9W3BHov9vBAA,86
+h2/__pycache__/__init__.cpython-311.pyc,,
+h2/__pycache__/config.cpython-311.pyc,,
+h2/__pycache__/connection.cpython-311.pyc,,
+h2/__pycache__/errors.cpython-311.pyc,,
+h2/__pycache__/events.cpython-311.pyc,,
+h2/__pycache__/exceptions.cpython-311.pyc,,
+h2/__pycache__/frame_buffer.cpython-311.pyc,,
+h2/__pycache__/settings.cpython-311.pyc,,
+h2/__pycache__/stream.cpython-311.pyc,,
+h2/__pycache__/utilities.cpython-311.pyc,,
+h2/__pycache__/windows.cpython-311.pyc,,
+h2/config.py,sha256=kMXdIbOm1vRqLM7aPJGg6EHuJBDo9yS23_I5d9TtiTw,7348
+h2/connection.py,sha256=IsWckfO6JuNDWBV8i7Ry-IrZOcb-2K-VHzfSv7zXC-0,82989
+h2/errors.py,sha256=6KzmbyYSKM9RuCd6nz7P2LtxmlSs5P2mneS_Sa8vTEo,1543
+h2/events.py,sha256=GptETVwff3OpaxRTHP4bvd3gRnn3nDPwqqpRoNl-mpc,21587
+h2/exceptions.py,sha256=OlfeNH_fcGGM0rFlOpD2JGOkW6r0HxDN7nSeGzO-Hz0,5334
+h2/frame_buffer.py,sha256=7i15oPLqfAPPfTDE5A87gggW4FxB7l__vMX4Xe9R7TU,6208
+h2/settings.py,sha256=zRs_bAz9qg21jsp6HQY-TZWncIbCDwEJ_1wZOydmYNc,11690
+h2/stream.py,sha256=b3hApRwvxk4rlUHDrB1ZbwgwPokOaZa8MMZSFREcViE,54533
+h2/utilities.py,sha256=RwgoIQRCmDrRvyUx054TyOKW1Hljdm_ZNz3jx4o9s_E,23246
+h2/windows.py,sha256=N_P9mTi0VZ26-eY2QsvWYi6NLx73xswvUZb7VGod1zk,5595
diff --git a/llm/Lib/site-packages/h2-4.1.0.dist-info/WHEEL b/llm/Lib/site-packages/h2-4.1.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..385faab0525ccdbfd1070a8bebcca3ac8617236e
--- /dev/null
+++ b/llm/Lib/site-packages/h2-4.1.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.36.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/h2-4.1.0.dist-info/top_level.txt b/llm/Lib/site-packages/h2-4.1.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..c48b5634fe43460805dc0ca67824bbb970dd4b04
--- /dev/null
+++ b/llm/Lib/site-packages/h2-4.1.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+h2
diff --git a/llm/Lib/site-packages/h2/__init__.py b/llm/Lib/site-packages/h2/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d3fd0cb674e442db824c01627efe7c9eb9ea596f
--- /dev/null
+++ b/llm/Lib/site-packages/h2/__init__.py
@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+"""
+h2
+~~
+
+A HTTP/2 implementation.
+"""
+__version__ = '4.1.0'
diff --git a/llm/Lib/site-packages/h2/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/h2/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a030a0d6e4fb23add2fb987639de59723b294f1b
Binary files /dev/null and b/llm/Lib/site-packages/h2/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h2/__pycache__/config.cpython-311.pyc b/llm/Lib/site-packages/h2/__pycache__/config.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..868d72ef9437ff0585e18eeee0f20a873629cbaa
Binary files /dev/null and b/llm/Lib/site-packages/h2/__pycache__/config.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h2/__pycache__/connection.cpython-311.pyc b/llm/Lib/site-packages/h2/__pycache__/connection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5de5a814f7e1854734264f4995ceaf8ece5744a7
Binary files /dev/null and b/llm/Lib/site-packages/h2/__pycache__/connection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h2/__pycache__/errors.cpython-311.pyc b/llm/Lib/site-packages/h2/__pycache__/errors.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ab248605f29349432163204bab6bc83c155b341a
Binary files /dev/null and b/llm/Lib/site-packages/h2/__pycache__/errors.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h2/__pycache__/events.cpython-311.pyc b/llm/Lib/site-packages/h2/__pycache__/events.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d7f065131f44d1808f78916965658a53908d77b6
Binary files /dev/null and b/llm/Lib/site-packages/h2/__pycache__/events.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h2/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/h2/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ff4ece027689570e78f8557fa3155c391eb2ebff
Binary files /dev/null and b/llm/Lib/site-packages/h2/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h2/__pycache__/frame_buffer.cpython-311.pyc b/llm/Lib/site-packages/h2/__pycache__/frame_buffer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5c28f590ddf7679d31c4dbf300edf52844d178d4
Binary files /dev/null and b/llm/Lib/site-packages/h2/__pycache__/frame_buffer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h2/__pycache__/settings.cpython-311.pyc b/llm/Lib/site-packages/h2/__pycache__/settings.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..007a098c52d6b87faff7521ab7e347990e5d7b1c
Binary files /dev/null and b/llm/Lib/site-packages/h2/__pycache__/settings.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h2/__pycache__/stream.cpython-311.pyc b/llm/Lib/site-packages/h2/__pycache__/stream.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6cedbb08f1f0151d1488f39787c71ec22d705a6d
Binary files /dev/null and b/llm/Lib/site-packages/h2/__pycache__/stream.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h2/__pycache__/utilities.cpython-311.pyc b/llm/Lib/site-packages/h2/__pycache__/utilities.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a313bd48929e4f119b3ec9171b2a1f34d100d910
Binary files /dev/null and b/llm/Lib/site-packages/h2/__pycache__/utilities.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h2/__pycache__/windows.cpython-311.pyc b/llm/Lib/site-packages/h2/__pycache__/windows.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7fdf9214694a3c0dbed8739ff17e93fcee856c5b
Binary files /dev/null and b/llm/Lib/site-packages/h2/__pycache__/windows.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/h2/config.py b/llm/Lib/site-packages/h2/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..915df55c15ad76c8f59106fa73ca3372fad06486
--- /dev/null
+++ b/llm/Lib/site-packages/h2/config.py
@@ -0,0 +1,195 @@
+# -*- coding: utf-8 -*-
+"""
+h2/config
+~~~~~~~~~
+
+Objects for controlling the configuration of the HTTP/2 stack.
+"""
+
+import sys
+
+
+class _BooleanConfigOption:
+    """
+    Descriptor for handling a boolean config option.  This will block
+    attempts to set boolean config options to non-bools.
+    """
+    def __init__(self, name):
+        self.name = name
+        self.attr_name = '_%s' % self.name
+
+    def __get__(self, instance, owner):
+        return getattr(instance, self.attr_name)
+
+    def __set__(self, instance, value):
+        if not isinstance(value, bool):
+            raise ValueError("%s must be a bool" % self.name)
+        setattr(instance, self.attr_name, value)
+
+
+class DummyLogger:
+    """
+    A Logger object that does not actual logging, hence a DummyLogger.
+
+    For the class the log operation is merely a no-op. The intent is to avoid
+    conditionals being sprinkled throughout the h2 code for calls to
+    logging functions when no logger is passed into the corresponding object.
+    """
+    def __init__(self, *vargs):
+        pass
+
+    def debug(self, *vargs, **kwargs):
+        """
+        No-op logging. Only level needed for now.
+        """
+        pass
+
+    def trace(self, *vargs, **kwargs):
+        """
+        No-op logging. Only level needed for now.
+        """
+        pass
+
+
+class OutputLogger:
+    """
+    A Logger object that prints to stderr or any other file-like object.
+
+    This class is provided for convenience and not part of the stable API.
+
+    :param file: A file-like object passed to the print function.
+        Defaults to ``sys.stderr``.
+    :param trace: Enables trace-level output. Defaults to ``False``.
+    """
+    def __init__(self, file=None, trace_level=False):
+        super().__init__()
+        self.file = file or sys.stderr
+        self.trace_level = trace_level
+
+    def debug(self, fmtstr, *args):
+        print(f"h2 (debug): {fmtstr % args}", file=self.file)
+
+    def trace(self, fmtstr, *args):
+        if self.trace_level:
+            print(f"h2 (trace): {fmtstr % args}", file=self.file)
+
+
+class H2Configuration:
+    """
+    An object that controls the way a single HTTP/2 connection behaves.
+
+    This object allows the users to customize behaviour. In particular, it
+    allows users to enable or disable optional features, or to otherwise handle
+    various unusual behaviours.
+
+    This object has very little behaviour of its own: it mostly just ensures
+    that configuration is self-consistent.
+
+    :param client_side: Whether this object is to be used on the client side of
+        a connection, or on the server side. Affects the logic used by the
+        state machine, the default settings values, the allowable stream IDs,
+        and several other properties. Defaults to ``True``.
+    :type client_side: ``bool``
+
+    :param header_encoding: Controls whether the headers emitted by this object
+        in events are transparently decoded to ``unicode`` strings, and what
+        encoding is used to do that decoding. This defaults to ``None``,
+        meaning that headers will be returned as bytes. To automatically
+        decode headers (that is, to return them as unicode strings), this can
+        be set to the string name of any encoding, e.g. ``'utf-8'``.
+
+        .. versionchanged:: 3.0.0
+           Changed default value from ``'utf-8'`` to ``None``
+
+    :type header_encoding: ``str``, ``False``, or ``None``
+
+    :param validate_outbound_headers: Controls whether the headers emitted
+        by this object are validated against the rules in RFC 7540.
+        Disabling this setting will cause outbound header validation to
+        be skipped, and allow the object to emit headers that may be illegal
+        according to RFC 7540. Defaults to ``True``.
+    :type validate_outbound_headers: ``bool``
+
+    :param normalize_outbound_headers: Controls whether the headers emitted
+        by this object are normalized before sending.  Disabling this setting
+        will cause outbound header normalization to be skipped, and allow
+        the object to emit headers that may be illegal according to
+        RFC 7540. Defaults to ``True``.
+    :type normalize_outbound_headers: ``bool``
+
+    :param validate_inbound_headers: Controls whether the headers received
+        by this object are validated against the rules in RFC 7540.
+        Disabling this setting will cause inbound header validation to
+        be skipped, and allow the object to receive headers that may be illegal
+        according to RFC 7540. Defaults to ``True``.
+    :type validate_inbound_headers: ``bool``
+
+    :param normalize_inbound_headers: Controls whether the headers received by
+        this object are normalized according to the rules of RFC 7540.
+        Disabling this setting may lead to h2 emitting header blocks that
+        some RFCs forbid, e.g. with multiple cookie fields.
+
+        .. versionadded:: 3.0.0
+
+    :type normalize_inbound_headers: ``bool``
+
+    :param logger: A logger that conforms to the requirements for this module,
+        those being no I/O and no context switches, which is needed in order
+        to run in asynchronous operation.
+
+        .. versionadded:: 2.6.0
+
+    :type logger: ``logging.Logger``
+    """
+    client_side = _BooleanConfigOption('client_side')
+    validate_outbound_headers = _BooleanConfigOption(
+        'validate_outbound_headers'
+    )
+    normalize_outbound_headers = _BooleanConfigOption(
+        'normalize_outbound_headers'
+    )
+    validate_inbound_headers = _BooleanConfigOption(
+        'validate_inbound_headers'
+    )
+    normalize_inbound_headers = _BooleanConfigOption(
+        'normalize_inbound_headers'
+    )
+
+    def __init__(self,
+                 client_side=True,
+                 header_encoding=None,
+                 validate_outbound_headers=True,
+                 normalize_outbound_headers=True,
+                 validate_inbound_headers=True,
+                 normalize_inbound_headers=True,
+                 logger=None):
+        self.client_side = client_side
+        self.header_encoding = header_encoding
+        self.validate_outbound_headers = validate_outbound_headers
+        self.normalize_outbound_headers = normalize_outbound_headers
+        self.validate_inbound_headers = validate_inbound_headers
+        self.normalize_inbound_headers = normalize_inbound_headers
+        self.logger = logger or DummyLogger(__name__)
+
+    @property
+    def header_encoding(self):
+        """
+        Controls whether the headers emitted by this object in events are
+        transparently decoded to ``unicode`` strings, and what encoding is used
+        to do that decoding. This defaults to ``None``, meaning that headers
+        will be returned as bytes. To automatically decode headers (that is, to
+        return them as unicode strings), this can be set to the string name of
+        any encoding, e.g. ``'utf-8'``.
+        """
+        return self._header_encoding
+
+    @header_encoding.setter
+    def header_encoding(self, value):
+        """
+        Enforces constraints on the value of header encoding.
+        """
+        if not isinstance(value, (bool, str, type(None))):
+            raise ValueError("header_encoding must be bool, string, or None")
+        if value is True:
+            raise ValueError("header_encoding cannot be True")
+        self._header_encoding = value
diff --git a/llm/Lib/site-packages/h2/connection.py b/llm/Lib/site-packages/h2/connection.py
new file mode 100644
index 0000000000000000000000000000000000000000..25251e20a33a13fe56f20125eed7feaba9223428
--- /dev/null
+++ b/llm/Lib/site-packages/h2/connection.py
@@ -0,0 +1,2048 @@
+# -*- coding: utf-8 -*-
+"""
+h2/connection
+~~~~~~~~~~~~~
+
+An implementation of a HTTP/2 connection.
+"""
+import base64
+
+from enum import Enum, IntEnum
+
+from hyperframe.exceptions import InvalidPaddingError
+from hyperframe.frame import (
+    GoAwayFrame, WindowUpdateFrame, HeadersFrame, DataFrame, PingFrame,
+    PushPromiseFrame, SettingsFrame, RstStreamFrame, PriorityFrame,
+    ContinuationFrame, AltSvcFrame, ExtensionFrame
+)
+from hpack.hpack import Encoder, Decoder
+from hpack.exceptions import HPACKError, OversizedHeaderListError
+
+from .config import H2Configuration
+from .errors import ErrorCodes, _error_code_from_int
+from .events import (
+    WindowUpdated, RemoteSettingsChanged, PingReceived, PingAckReceived,
+    SettingsAcknowledged, ConnectionTerminated, PriorityUpdated,
+    AlternativeServiceAvailable, UnknownFrameReceived
+)
+from .exceptions import (
+    ProtocolError, NoSuchStreamError, FlowControlError, FrameTooLargeError,
+    TooManyStreamsError, StreamClosedError, StreamIDTooLowError,
+    NoAvailableStreamIDError, RFC1122Error, DenialOfServiceError
+)
+from .frame_buffer import FrameBuffer
+from .settings import Settings, SettingCodes
+from .stream import H2Stream, StreamClosedBy
+from .utilities import SizeLimitDict, guard_increment_window
+from .windows import WindowManager
+
+
+class ConnectionState(Enum):
+    IDLE = 0
+    CLIENT_OPEN = 1
+    SERVER_OPEN = 2
+    CLOSED = 3
+
+
+class ConnectionInputs(Enum):
+    SEND_HEADERS = 0
+    SEND_PUSH_PROMISE = 1
+    SEND_DATA = 2
+    SEND_GOAWAY = 3
+    SEND_WINDOW_UPDATE = 4
+    SEND_PING = 5
+    SEND_SETTINGS = 6
+    SEND_RST_STREAM = 7
+    SEND_PRIORITY = 8
+    RECV_HEADERS = 9
+    RECV_PUSH_PROMISE = 10
+    RECV_DATA = 11
+    RECV_GOAWAY = 12
+    RECV_WINDOW_UPDATE = 13
+    RECV_PING = 14
+    RECV_SETTINGS = 15
+    RECV_RST_STREAM = 16
+    RECV_PRIORITY = 17
+    SEND_ALTERNATIVE_SERVICE = 18  # Added in 2.3.0
+    RECV_ALTERNATIVE_SERVICE = 19  # Added in 2.3.0
+
+
+class AllowedStreamIDs(IntEnum):
+    EVEN = 0
+    ODD = 1
+
+
+class H2ConnectionStateMachine:
+    """
+    A single HTTP/2 connection state machine.
+
+    This state machine, while defined in its own class, is logically part of
+    the H2Connection class also defined in this file. The state machine itself
+    maintains very little state directly, instead focusing entirely on managing
+    state transitions.
+    """
+    # For the purposes of this state machine we treat HEADERS and their
+    # associated CONTINUATION frames as a single jumbo frame. The protocol
+    # allows/requires this by preventing other frames from being interleved in
+    # between HEADERS/CONTINUATION frames.
+    #
+    # The _transitions dictionary contains a mapping of tuples of
+    # (state, input) to tuples of (side_effect_function, end_state). This map
+    # contains all allowed transitions: anything not in this map is invalid
+    # and immediately causes a transition to ``closed``.
+
+    _transitions = {
+        # State: idle
+        (ConnectionState.IDLE, ConnectionInputs.SEND_HEADERS):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.IDLE, ConnectionInputs.RECV_HEADERS):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.IDLE, ConnectionInputs.SEND_SETTINGS):
+            (None, ConnectionState.IDLE),
+        (ConnectionState.IDLE, ConnectionInputs.RECV_SETTINGS):
+            (None, ConnectionState.IDLE),
+        (ConnectionState.IDLE, ConnectionInputs.SEND_WINDOW_UPDATE):
+            (None, ConnectionState.IDLE),
+        (ConnectionState.IDLE, ConnectionInputs.RECV_WINDOW_UPDATE):
+            (None, ConnectionState.IDLE),
+        (ConnectionState.IDLE, ConnectionInputs.SEND_PING):
+            (None, ConnectionState.IDLE),
+        (ConnectionState.IDLE, ConnectionInputs.RECV_PING):
+            (None, ConnectionState.IDLE),
+        (ConnectionState.IDLE, ConnectionInputs.SEND_GOAWAY):
+            (None, ConnectionState.CLOSED),
+        (ConnectionState.IDLE, ConnectionInputs.RECV_GOAWAY):
+            (None, ConnectionState.CLOSED),
+        (ConnectionState.IDLE, ConnectionInputs.SEND_PRIORITY):
+            (None, ConnectionState.IDLE),
+        (ConnectionState.IDLE, ConnectionInputs.RECV_PRIORITY):
+            (None, ConnectionState.IDLE),
+        (ConnectionState.IDLE, ConnectionInputs.SEND_ALTERNATIVE_SERVICE):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.IDLE, ConnectionInputs.RECV_ALTERNATIVE_SERVICE):
+            (None, ConnectionState.CLIENT_OPEN),
+
+        # State: open, client side.
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.SEND_HEADERS):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.SEND_DATA):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.SEND_GOAWAY):
+            (None, ConnectionState.CLOSED),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.SEND_WINDOW_UPDATE):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.SEND_PING):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.SEND_SETTINGS):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.SEND_PRIORITY):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.RECV_HEADERS):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.RECV_PUSH_PROMISE):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.RECV_DATA):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.RECV_GOAWAY):
+            (None, ConnectionState.CLOSED),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.RECV_WINDOW_UPDATE):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.RECV_PING):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.RECV_SETTINGS):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.SEND_RST_STREAM):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.RECV_RST_STREAM):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN, ConnectionInputs.RECV_PRIORITY):
+            (None, ConnectionState.CLIENT_OPEN),
+        (ConnectionState.CLIENT_OPEN,
+            ConnectionInputs.RECV_ALTERNATIVE_SERVICE):
+                (None, ConnectionState.CLIENT_OPEN),
+
+        # State: open, server side.
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.SEND_HEADERS):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.SEND_PUSH_PROMISE):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.SEND_DATA):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.SEND_GOAWAY):
+            (None, ConnectionState.CLOSED),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.SEND_WINDOW_UPDATE):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.SEND_PING):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.SEND_SETTINGS):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.SEND_PRIORITY):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.RECV_HEADERS):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.RECV_DATA):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.RECV_GOAWAY):
+            (None, ConnectionState.CLOSED),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.RECV_WINDOW_UPDATE):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.RECV_PING):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.RECV_SETTINGS):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.RECV_PRIORITY):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.SEND_RST_STREAM):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN, ConnectionInputs.RECV_RST_STREAM):
+            (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN,
+            ConnectionInputs.SEND_ALTERNATIVE_SERVICE):
+                (None, ConnectionState.SERVER_OPEN),
+        (ConnectionState.SERVER_OPEN,
+            ConnectionInputs.RECV_ALTERNATIVE_SERVICE):
+                (None, ConnectionState.SERVER_OPEN),
+
+        # State: closed
+        (ConnectionState.CLOSED, ConnectionInputs.SEND_GOAWAY):
+            (None, ConnectionState.CLOSED),
+        (ConnectionState.CLOSED, ConnectionInputs.RECV_GOAWAY):
+            (None, ConnectionState.CLOSED),
+    }
+
+    def __init__(self):
+        self.state = ConnectionState.IDLE
+
+    def process_input(self, input_):
+        """
+        Process a specific input in the state machine.
+        """
+        if not isinstance(input_, ConnectionInputs):
+            raise ValueError("Input must be an instance of ConnectionInputs")
+
+        try:
+            func, target_state = self._transitions[(self.state, input_)]
+        except KeyError:
+            old_state = self.state
+            self.state = ConnectionState.CLOSED
+            raise ProtocolError(
+                "Invalid input %s in state %s" % (input_, old_state)
+            )
+        else:
+            self.state = target_state
+            if func is not None:  # pragma: no cover
+                return func()
+
+            return []
+
+
+class H2Connection:
+    """
+    A low-level HTTP/2 connection object. This handles building and receiving
+    frames and maintains both connection and per-stream state for all streams
+    on this connection.
+
+    This wraps a HTTP/2 Connection state machine implementation, ensuring that
+    frames can only be sent/received when the connection is in a valid state.
+    It also builds stream state machines on demand to ensure that the
+    constraints of those state machines are met as well. Attempts to create
+    frames that cannot be sent will raise a ``ProtocolError``.
+
+    .. versionchanged:: 2.3.0
+       Added the ``header_encoding`` keyword argument.
+
+    .. versionchanged:: 2.5.0
+       Added the ``config`` keyword argument. Deprecated the ``client_side``
+       and ``header_encoding`` parameters.
+
+    .. versionchanged:: 3.0.0
+       Removed deprecated parameters and properties.
+
+    :param config: The configuration for the HTTP/2 connection.
+
+        .. versionadded:: 2.5.0
+
+    :type config: :class:`H2Configuration <h2.config.H2Configuration>`
+    """
+    # The initial maximum outbound frame size. This can be changed by receiving
+    # a settings frame.
+    DEFAULT_MAX_OUTBOUND_FRAME_SIZE = 65535
+
+    # The initial maximum inbound frame size. This is somewhat arbitrarily
+    # chosen.
+    DEFAULT_MAX_INBOUND_FRAME_SIZE = 2**24
+
+    # The highest acceptable stream ID.
+    HIGHEST_ALLOWED_STREAM_ID = 2**31 - 1
+
+    # The largest acceptable window increment.
+    MAX_WINDOW_INCREMENT = 2**31 - 1
+
+    # The initial default value of SETTINGS_MAX_HEADER_LIST_SIZE.
+    DEFAULT_MAX_HEADER_LIST_SIZE = 2**16
+
+    # Keep in memory limited amount of results for streams closes
+    MAX_CLOSED_STREAMS = 2**16
+
+    def __init__(self, config=None):
+        self.state_machine = H2ConnectionStateMachine()
+        self.streams = {}
+        self.highest_inbound_stream_id = 0
+        self.highest_outbound_stream_id = 0
+        self.encoder = Encoder()
+        self.decoder = Decoder()
+
+        # This won't always actually do anything: for versions of HPACK older
+        # than 2.3.0 it does nothing. However, we have to try!
+        self.decoder.max_header_list_size = self.DEFAULT_MAX_HEADER_LIST_SIZE
+
+        #: The configuration for this HTTP/2 connection object.
+        #:
+        #: .. versionadded:: 2.5.0
+        self.config = config
+        if self.config is None:
+            self.config = H2Configuration(
+                client_side=True,
+            )
+
+        # Objects that store settings, including defaults.
+        #
+        # We set the MAX_CONCURRENT_STREAMS value to 100 because its default is
+        # unbounded, and that's a dangerous default because it allows
+        # essentially unbounded resources to be allocated regardless of how
+        # they will be used. 100 should be suitable for the average
+        # application. This default obviously does not apply to the remote
+        # peer's settings: the remote peer controls them!
+        #
+        # We also set MAX_HEADER_LIST_SIZE to a reasonable value. This is to
+        # advertise our defence against CVE-2016-6581. However, not all
+        # versions of HPACK will let us do it. That's ok: we should at least
+        # suggest that we're not vulnerable.
+        self.local_settings = Settings(
+            client=self.config.client_side,
+            initial_values={
+                SettingCodes.MAX_CONCURRENT_STREAMS: 100,
+                SettingCodes.MAX_HEADER_LIST_SIZE:
+                    self.DEFAULT_MAX_HEADER_LIST_SIZE,
+            }
+        )
+        self.remote_settings = Settings(client=not self.config.client_side)
+
+        # The current value of the connection flow control windows on the
+        # connection.
+        self.outbound_flow_control_window = (
+            self.remote_settings.initial_window_size
+        )
+
+        #: The maximum size of a frame that can be emitted by this peer, in
+        #: bytes.
+        self.max_outbound_frame_size = self.remote_settings.max_frame_size
+
+        #: The maximum size of a frame that can be received by this peer, in
+        #: bytes.
+        self.max_inbound_frame_size = self.local_settings.max_frame_size
+
+        # Buffer for incoming data.
+        self.incoming_buffer = FrameBuffer(server=not self.config.client_side)
+
+        # A private variable to store a sequence of received header frames
+        # until completion.
+        self._header_frames = []
+
+        # Data that needs to be sent.
+        self._data_to_send = bytearray()
+
+        # Keeps track of how streams are closed.
+        # Used to ensure that we don't blow up in the face of frames that were
+        # in flight when a RST_STREAM was sent.
+        # Also used to determine whether we should consider a frame received
+        # while a stream is closed as either a stream error or a connection
+        # error.
+        self._closed_streams = SizeLimitDict(
+            size_limit=self.MAX_CLOSED_STREAMS
+        )
+
+        # The flow control window manager for the connection.
+        self._inbound_flow_control_window_manager = WindowManager(
+            max_window_size=self.local_settings.initial_window_size
+        )
+
+        # When in doubt use dict-dispatch.
+        self._frame_dispatch_table = {
+            HeadersFrame: self._receive_headers_frame,
+            PushPromiseFrame: self._receive_push_promise_frame,
+            SettingsFrame: self._receive_settings_frame,
+            DataFrame: self._receive_data_frame,
+            WindowUpdateFrame: self._receive_window_update_frame,
+            PingFrame: self._receive_ping_frame,
+            RstStreamFrame: self._receive_rst_stream_frame,
+            PriorityFrame: self._receive_priority_frame,
+            GoAwayFrame: self._receive_goaway_frame,
+            ContinuationFrame: self._receive_naked_continuation,
+            AltSvcFrame: self._receive_alt_svc_frame,
+            ExtensionFrame: self._receive_unknown_frame
+        }
+
+    def _prepare_for_sending(self, frames):
+        if not frames:
+            return
+        self._data_to_send += b''.join(f.serialize() for f in frames)
+        assert all(f.body_len <= self.max_outbound_frame_size for f in frames)
+
+    def _open_streams(self, remainder):
+        """
+        A common method of counting number of open streams. Returns the number
+        of streams that are open *and* that have (stream ID % 2) == remainder.
+        While it iterates, also deletes any closed streams.
+        """
+        count = 0
+        to_delete = []
+
+        for stream_id, stream in self.streams.items():
+            if stream.open and (stream_id % 2 == remainder):
+                count += 1
+            elif stream.closed:
+                to_delete.append(stream_id)
+
+        for stream_id in to_delete:
+            stream = self.streams.pop(stream_id)
+            self._closed_streams[stream_id] = stream.closed_by
+
+        return count
+
+    @property
+    def open_outbound_streams(self):
+        """
+        The current number of open outbound streams.
+        """
+        outbound_numbers = int(self.config.client_side)
+        return self._open_streams(outbound_numbers)
+
+    @property
+    def open_inbound_streams(self):
+        """
+        The current number of open inbound streams.
+        """
+        inbound_numbers = int(not self.config.client_side)
+        return self._open_streams(inbound_numbers)
+
+    @property
+    def inbound_flow_control_window(self):
+        """
+        The size of the inbound flow control window for the connection. This is
+        rarely publicly useful: instead, use :meth:`remote_flow_control_window
+        <h2.connection.H2Connection.remote_flow_control_window>`. This
+        shortcut is largely present to provide a shortcut to this data.
+        """
+        return self._inbound_flow_control_window_manager.current_window_size
+
+    def _begin_new_stream(self, stream_id, allowed_ids):
+        """
+        Initiate a new stream.
+
+        .. versionchanged:: 2.0.0
+           Removed this function from the public API.
+
+        :param stream_id: The ID of the stream to open.
+        :param allowed_ids: What kind of stream ID is allowed.
+        """
+        self.config.logger.debug(
+            "Attempting to initiate stream ID %d", stream_id
+        )
+        outbound = self._stream_id_is_outbound(stream_id)
+        highest_stream_id = (
+            self.highest_outbound_stream_id if outbound else
+            self.highest_inbound_stream_id
+        )
+
+        if stream_id <= highest_stream_id:
+            raise StreamIDTooLowError(stream_id, highest_stream_id)
+
+        if (stream_id % 2) != int(allowed_ids):
+            raise ProtocolError(
+                "Invalid stream ID for peer."
+            )
+
+        s = H2Stream(
+            stream_id,
+            config=self.config,
+            inbound_window_size=self.local_settings.initial_window_size,
+            outbound_window_size=self.remote_settings.initial_window_size
+        )
+        self.config.logger.debug("Stream ID %d created", stream_id)
+        s.max_inbound_frame_size = self.max_inbound_frame_size
+        s.max_outbound_frame_size = self.max_outbound_frame_size
+
+        self.streams[stream_id] = s
+        self.config.logger.debug("Current streams: %s", self.streams.keys())
+
+        if outbound:
+            self.highest_outbound_stream_id = stream_id
+        else:
+            self.highest_inbound_stream_id = stream_id
+
+        return s
+
+    def initiate_connection(self):
+        """
+        Provides any data that needs to be sent at the start of the connection.
+        Must be called for both clients and servers.
+        """
+        self.config.logger.debug("Initializing connection")
+        self.state_machine.process_input(ConnectionInputs.SEND_SETTINGS)
+        if self.config.client_side:
+            preamble = b'PRI * HTTP/2.0\r\n\r\nSM\r\n\r\n'
+        else:
+            preamble = b''
+
+        f = SettingsFrame(0)
+        for setting, value in self.local_settings.items():
+            f.settings[setting] = value
+        self.config.logger.debug(
+            "Send Settings frame: %s", self.local_settings
+        )
+
+        self._data_to_send += preamble + f.serialize()
+
+    def initiate_upgrade_connection(self, settings_header=None):
+        """
+        Call to initialise the connection object for use with an upgraded
+        HTTP/2 connection (i.e. a connection negotiated using the
+        ``Upgrade: h2c`` HTTP header).
+
+        This method differs from :meth:`initiate_connection
+        <h2.connection.H2Connection.initiate_connection>` in several ways.
+        Firstly, it handles the additional SETTINGS frame that is sent in the
+        ``HTTP2-Settings`` header field. When called on a client connection,
+        this method will return a bytestring that the caller can put in the
+        ``HTTP2-Settings`` field they send on their initial request. When
+        called on a server connection, the user **must** provide the value they
+        received from the client in the ``HTTP2-Settings`` header field to the
+        ``settings_header`` argument, which will be used appropriately.
+
+        Additionally, this method sets up stream 1 in a half-closed state
+        appropriate for this side of the connection, to reflect the fact that
+        the request is already complete.
+
+        Finally, this method also prepares the appropriate preamble to be sent
+        after the upgrade.
+
+        .. versionadded:: 2.3.0
+
+        :param settings_header: (optional, server-only): The value of the
+             ``HTTP2-Settings`` header field received from the client.
+        :type settings_header: ``bytes``
+
+        :returns: For clients, a bytestring to put in the ``HTTP2-Settings``.
+            For servers, returns nothing.
+        :rtype: ``bytes`` or ``None``
+        """
+        self.config.logger.debug(
+            "Upgrade connection. Current settings: %s", self.local_settings
+        )
+
+        frame_data = None
+        # Begin by getting the preamble in place.
+        self.initiate_connection()
+
+        if self.config.client_side:
+            f = SettingsFrame(0)
+            for setting, value in self.local_settings.items():
+                f.settings[setting] = value
+
+            frame_data = f.serialize_body()
+            frame_data = base64.urlsafe_b64encode(frame_data)
+        elif settings_header:
+            # We have a settings header from the client. This needs to be
+            # applied, but we want to throw away the ACK. We do this by
+            # inserting the data into a Settings frame and then passing it to
+            # the state machine, but ignoring the return value.
+            settings_header = base64.urlsafe_b64decode(settings_header)
+            f = SettingsFrame(0)
+            f.parse_body(settings_header)
+            self._receive_settings_frame(f)
+
+        # Set up appropriate state. Stream 1 in a half-closed state:
+        # half-closed(local) for clients, half-closed(remote) for servers.
+        # Additionally, we need to set up the Connection state machine.
+        connection_input = (
+            ConnectionInputs.SEND_HEADERS if self.config.client_side
+            else ConnectionInputs.RECV_HEADERS
+        )
+        self.config.logger.debug("Process input %s", connection_input)
+        self.state_machine.process_input(connection_input)
+
+        # Set up stream 1.
+        self._begin_new_stream(stream_id=1, allowed_ids=AllowedStreamIDs.ODD)
+        self.streams[1].upgrade(self.config.client_side)
+        return frame_data
+
+    def _get_or_create_stream(self, stream_id, allowed_ids):
+        """
+        Gets a stream by its stream ID. Will create one if one does not already
+        exist. Use allowed_ids to circumvent the usual stream ID rules for
+        clients and servers.
+
+        .. versionchanged:: 2.0.0
+           Removed this function from the public API.
+        """
+        try:
+            return self.streams[stream_id]
+        except KeyError:
+            return self._begin_new_stream(stream_id, allowed_ids)
+
+    def _get_stream_by_id(self, stream_id):
+        """
+        Gets a stream by its stream ID. Raises NoSuchStreamError if the stream
+        ID does not correspond to a known stream and is higher than the current
+        maximum: raises if it is lower than the current maximum.
+
+        .. versionchanged:: 2.0.0
+           Removed this function from the public API.
+        """
+        try:
+            return self.streams[stream_id]
+        except KeyError:
+            outbound = self._stream_id_is_outbound(stream_id)
+            highest_stream_id = (
+                self.highest_outbound_stream_id if outbound else
+                self.highest_inbound_stream_id
+            )
+
+            if stream_id > highest_stream_id:
+                raise NoSuchStreamError(stream_id)
+            else:
+                raise StreamClosedError(stream_id)
+
+    def get_next_available_stream_id(self):
+        """
+        Returns an integer suitable for use as the stream ID for the next
+        stream created by this endpoint. For server endpoints, this stream ID
+        will be even. For client endpoints, this stream ID will be odd. If no
+        stream IDs are available, raises :class:`NoAvailableStreamIDError
+        <h2.exceptions.NoAvailableStreamIDError>`.
+
+        .. warning:: The return value from this function does not change until
+                     the stream ID has actually been used by sending or pushing
+                     headers on that stream. For that reason, it should be
+                     called as close as possible to the actual use of the
+                     stream ID.
+
+        .. versionadded:: 2.0.0
+
+        :raises: :class:`NoAvailableStreamIDError
+            <h2.exceptions.NoAvailableStreamIDError>`
+        :returns: The next free stream ID this peer can use to initiate a
+            stream.
+        :rtype: ``int``
+        """
+        # No streams have been opened yet, so return the lowest allowed stream
+        # ID.
+        if not self.highest_outbound_stream_id:
+            next_stream_id = 1 if self.config.client_side else 2
+        else:
+            next_stream_id = self.highest_outbound_stream_id + 2
+        self.config.logger.debug(
+            "Next available stream ID %d", next_stream_id
+        )
+        if next_stream_id > self.HIGHEST_ALLOWED_STREAM_ID:
+            raise NoAvailableStreamIDError("Exhausted allowed stream IDs")
+
+        return next_stream_id
+
+    def send_headers(self, stream_id, headers, end_stream=False,
+                     priority_weight=None, priority_depends_on=None,
+                     priority_exclusive=None):
+        """
+        Send headers on a given stream.
+
+        This function can be used to send request or response headers: the kind
+        that are sent depends on whether this connection has been opened as a
+        client or server connection, and whether the stream was opened by the
+        remote peer or not.
+
+        If this is a client connection, calling ``send_headers`` will send the
+        headers as a request. It will also implicitly open the stream being
+        used. If this is a client connection and ``send_headers`` has *already*
+        been called, this will send trailers instead.
+
+        If this is a server connection, calling ``send_headers`` will send the
+        headers as a response. It is a protocol error for a server to open a
+        stream by sending headers. If this is a server connection and
+        ``send_headers`` has *already* been called, this will send trailers
+        instead.
+
+        When acting as a server, you may call ``send_headers`` any number of
+        times allowed by the following rules, in this order:
+
+        - zero or more times with ``(':status', '1XX')`` (where ``1XX`` is a
+          placeholder for any 100-level status code).
+        - once with any other status header.
+        - zero or one time for trailers.
+
+        That is, you are allowed to send as many informational responses as you
+        like, followed by one complete response and zero or one HTTP trailer
+        blocks.
+
+        Clients may send one or two header blocks: one request block, and
+        optionally one trailer block.
+
+        If it is important to send HPACK "never indexed" header fields (as
+        defined in `RFC 7451 Section 7.1.3
+        <https://tools.ietf.org/html/rfc7541#section-7.1.3>`_), the user may
+        instead provide headers using the HPACK library's :class:`HeaderTuple
+        <hpack:hpack.HeaderTuple>` and :class:`NeverIndexedHeaderTuple
+        <hpack:hpack.NeverIndexedHeaderTuple>` objects.
+
+        This method also allows users to prioritize the stream immediately,
+        by sending priority information on the HEADERS frame directly. To do
+        this, any one of ``priority_weight``, ``priority_depends_on``, or
+        ``priority_exclusive`` must be set to a value that is not ``None``. For
+        more information on the priority fields, see :meth:`prioritize
+        <h2.connection.H2Connection.prioritize>`.
+
+        .. warning:: In HTTP/2, it is mandatory that all the HTTP/2 special
+            headers (that is, ones whose header keys begin with ``:``) appear
+            at the start of the header block, before any normal headers.
+
+        .. versionchanged:: 2.3.0
+           Added support for using :class:`HeaderTuple
+           <hpack:hpack.HeaderTuple>` objects to store headers.
+
+        .. versionchanged:: 2.4.0
+           Added the ability to provide priority keyword arguments:
+           ``priority_weight``, ``priority_depends_on``, and
+           ``priority_exclusive``.
+
+        :param stream_id: The stream ID to send the headers on. If this stream
+            does not currently exist, it will be created.
+        :type stream_id: ``int``
+
+        :param headers: The request/response headers to send.
+        :type headers: An iterable of two tuples of bytestrings or
+            :class:`HeaderTuple <hpack:hpack.HeaderTuple>` objects.
+
+        :param end_stream: Whether this headers frame should end the stream
+            immediately (that is, whether no more data will be sent after this
+            frame). Defaults to ``False``.
+        :type end_stream: ``bool``
+
+        :param priority_weight: Sets the priority weight of the stream. See
+            :meth:`prioritize <h2.connection.H2Connection.prioritize>` for more
+            about how this field works. Defaults to ``None``, which means that
+            no priority information will be sent.
+        :type priority_weight: ``int`` or ``None``
+
+        :param priority_depends_on: Sets which stream this one depends on for
+            priority purposes. See :meth:`prioritize
+            <h2.connection.H2Connection.prioritize>` for more about how this
+            field works. Defaults to ``None``, which means that no priority
+            information will be sent.
+        :type priority_depends_on: ``int`` or ``None``
+
+        :param priority_exclusive: Sets whether this stream exclusively depends
+            on the stream given in ``priority_depends_on`` for priority
+            purposes. See :meth:`prioritize
+            <h2.connection.H2Connection.prioritize>` for more about how this
+            field workds. Defaults to ``None``, which means that no priority
+            information will be sent.
+        :type priority_depends_on: ``bool`` or ``None``
+
+        :returns: Nothing
+        """
+        self.config.logger.debug(
+            "Send headers on stream ID %d", stream_id
+        )
+
+        # Check we can open the stream.
+        if stream_id not in self.streams:
+            max_open_streams = self.remote_settings.max_concurrent_streams
+            if (self.open_outbound_streams + 1) > max_open_streams:
+                raise TooManyStreamsError(
+                    "Max outbound streams is %d, %d open" %
+                    (max_open_streams, self.open_outbound_streams)
+                )
+
+        self.state_machine.process_input(ConnectionInputs.SEND_HEADERS)
+        stream = self._get_or_create_stream(
+            stream_id, AllowedStreamIDs(self.config.client_side)
+        )
+        frames = stream.send_headers(
+            headers, self.encoder, end_stream
+        )
+
+        # We may need to send priority information.
+        priority_present = (
+            (priority_weight is not None) or
+            (priority_depends_on is not None) or
+            (priority_exclusive is not None)
+        )
+
+        if priority_present:
+            if not self.config.client_side:
+                raise RFC1122Error("Servers SHOULD NOT prioritize streams.")
+
+            headers_frame = frames[0]
+            headers_frame.flags.add('PRIORITY')
+            frames[0] = _add_frame_priority(
+                headers_frame,
+                priority_weight,
+                priority_depends_on,
+                priority_exclusive
+            )
+
+        self._prepare_for_sending(frames)
+
+    def send_data(self, stream_id, data, end_stream=False, pad_length=None):
+        """
+        Send data on a given stream.
+
+        This method does no breaking up of data: if the data is larger than the
+        value returned by :meth:`local_flow_control_window
+        <h2.connection.H2Connection.local_flow_control_window>` for this stream
+        then a :class:`FlowControlError <h2.exceptions.FlowControlError>` will
+        be raised. If the data is larger than :data:`max_outbound_frame_size
+        <h2.connection.H2Connection.max_outbound_frame_size>` then a
+        :class:`FrameTooLargeError <h2.exceptions.FrameTooLargeError>` will be
+        raised.
+
+        h2 does this to avoid buffering the data internally. If the user
+        has more data to send than h2 will allow, consider breaking it up
+        and buffering it externally.
+
+        :param stream_id: The ID of the stream on which to send the data.
+        :type stream_id: ``int``
+        :param data: The data to send on the stream.
+        :type data: ``bytes``
+        :param end_stream: (optional) Whether this is the last data to be sent
+            on the stream. Defaults to ``False``.
+        :type end_stream: ``bool``
+        :param pad_length: (optional) Length of the padding to apply to the
+            data frame. Defaults to ``None`` for no use of padding. Note that
+            a value of ``0`` results in padding of length ``0``
+            (with the "padding" flag set on the frame).
+
+            .. versionadded:: 2.6.0
+
+        :type pad_length: ``int``
+        :returns: Nothing
+        """
+        self.config.logger.debug(
+            "Send data on stream ID %d with len %d", stream_id, len(data)
+        )
+        frame_size = len(data)
+        if pad_length is not None:
+            if not isinstance(pad_length, int):
+                raise TypeError("pad_length must be an int")
+            if pad_length < 0 or pad_length > 255:
+                raise ValueError("pad_length must be within range: [0, 255]")
+            # Account for padding bytes plus the 1-byte padding length field.
+            frame_size += pad_length + 1
+        self.config.logger.debug(
+            "Frame size on stream ID %d is %d", stream_id, frame_size
+        )
+
+        if frame_size > self.local_flow_control_window(stream_id):
+            raise FlowControlError(
+                "Cannot send %d bytes, flow control window is %d." %
+                (frame_size, self.local_flow_control_window(stream_id))
+            )
+        elif frame_size > self.max_outbound_frame_size:
+            raise FrameTooLargeError(
+                "Cannot send frame size %d, max frame size is %d" %
+                (frame_size, self.max_outbound_frame_size)
+            )
+
+        self.state_machine.process_input(ConnectionInputs.SEND_DATA)
+        frames = self.streams[stream_id].send_data(
+            data, end_stream, pad_length=pad_length
+        )
+
+        self._prepare_for_sending(frames)
+
+        self.outbound_flow_control_window -= frame_size
+        self.config.logger.debug(
+            "Outbound flow control window size is %d",
+            self.outbound_flow_control_window
+        )
+        assert self.outbound_flow_control_window >= 0
+
+    def end_stream(self, stream_id):
+        """
+        Cleanly end a given stream.
+
+        This method ends a stream by sending an empty DATA frame on that stream
+        with the ``END_STREAM`` flag set.
+
+        :param stream_id: The ID of the stream to end.
+        :type stream_id: ``int``
+        :returns: Nothing
+        """
+        self.config.logger.debug("End stream ID %d", stream_id)
+        self.state_machine.process_input(ConnectionInputs.SEND_DATA)
+        frames = self.streams[stream_id].end_stream()
+        self._prepare_for_sending(frames)
+
+    def increment_flow_control_window(self, increment, stream_id=None):
+        """
+        Increment a flow control window, optionally for a single stream. Allows
+        the remote peer to send more data.
+
+        .. versionchanged:: 2.0.0
+           Rejects attempts to increment the flow control window by out of
+           range values with a ``ValueError``.
+
+        :param increment: The amount to increment the flow control window by.
+        :type increment: ``int``
+        :param stream_id: (optional) The ID of the stream that should have its
+            flow control window opened. If not present or ``None``, the
+            connection flow control window will be opened instead.
+        :type stream_id: ``int`` or ``None``
+        :returns: Nothing
+        :raises: ``ValueError``
+        """
+        if not (1 <= increment <= self.MAX_WINDOW_INCREMENT):
+            raise ValueError(
+                "Flow control increment must be between 1 and %d" %
+                self.MAX_WINDOW_INCREMENT
+            )
+
+        self.state_machine.process_input(ConnectionInputs.SEND_WINDOW_UPDATE)
+
+        if stream_id is not None:
+            stream = self.streams[stream_id]
+            frames = stream.increase_flow_control_window(
+                increment
+            )
+
+            self.config.logger.debug(
+                "Increase stream ID %d flow control window by %d",
+                stream_id, increment
+            )
+        else:
+            self._inbound_flow_control_window_manager.window_opened(increment)
+            f = WindowUpdateFrame(0)
+            f.window_increment = increment
+            frames = [f]
+
+            self.config.logger.debug(
+                "Increase connection flow control window by %d", increment
+            )
+
+        self._prepare_for_sending(frames)
+
+    def push_stream(self, stream_id, promised_stream_id, request_headers):
+        """
+        Push a response to the client by sending a PUSH_PROMISE frame.
+
+        If it is important to send HPACK "never indexed" header fields (as
+        defined in `RFC 7451 Section 7.1.3
+        <https://tools.ietf.org/html/rfc7541#section-7.1.3>`_), the user may
+        instead provide headers using the HPACK library's :class:`HeaderTuple
+        <hpack:hpack.HeaderTuple>` and :class:`NeverIndexedHeaderTuple
+        <hpack:hpack.NeverIndexedHeaderTuple>` objects.
+
+        :param stream_id: The ID of the stream that this push is a response to.
+        :type stream_id: ``int``
+        :param promised_stream_id: The ID of the stream that the pushed
+            response will be sent on.
+        :type promised_stream_id: ``int``
+        :param request_headers: The headers of the request that the pushed
+            response will be responding to.
+        :type request_headers: An iterable of two tuples of bytestrings or
+            :class:`HeaderTuple <hpack:hpack.HeaderTuple>` objects.
+        :returns: Nothing
+        """
+        self.config.logger.debug(
+            "Send Push Promise frame on stream ID %d", stream_id
+        )
+
+        if not self.remote_settings.enable_push:
+            raise ProtocolError("Remote peer has disabled stream push")
+
+        self.state_machine.process_input(ConnectionInputs.SEND_PUSH_PROMISE)
+        stream = self._get_stream_by_id(stream_id)
+
+        # We need to prevent users pushing streams in response to streams that
+        # they themselves have already pushed: see #163 and RFC 7540 § 6.6. The
+        # easiest way to do that is to assert that the stream_id is not even:
+        # this shortcut works because only servers can push and the state
+        # machine will enforce this.
+        if (stream_id % 2) == 0:
+            raise ProtocolError("Cannot recursively push streams.")
+
+        new_stream = self._begin_new_stream(
+            promised_stream_id, AllowedStreamIDs.EVEN
+        )
+        self.streams[promised_stream_id] = new_stream
+
+        frames = stream.push_stream_in_band(
+            promised_stream_id, request_headers, self.encoder
+        )
+        new_frames = new_stream.locally_pushed()
+        self._prepare_for_sending(frames + new_frames)
+
+    def ping(self, opaque_data):
+        """
+        Send a PING frame.
+
+        :param opaque_data: A bytestring of length 8 that will be sent in the
+                            PING frame.
+        :returns: Nothing
+        """
+        self.config.logger.debug("Send Ping frame")
+
+        if not isinstance(opaque_data, bytes) or len(opaque_data) != 8:
+            raise ValueError("Invalid value for ping data: %r" % opaque_data)
+
+        self.state_machine.process_input(ConnectionInputs.SEND_PING)
+        f = PingFrame(0)
+        f.opaque_data = opaque_data
+        self._prepare_for_sending([f])
+
+    def reset_stream(self, stream_id, error_code=0):
+        """
+        Reset a stream.
+
+        This method forcibly closes a stream by sending a RST_STREAM frame for
+        a given stream. This is not a graceful closure. To gracefully end a
+        stream, try the :meth:`end_stream
+        <h2.connection.H2Connection.end_stream>` method.
+
+        :param stream_id: The ID of the stream to reset.
+        :type stream_id: ``int``
+        :param error_code: (optional) The error code to use to reset the
+            stream. Defaults to :data:`ErrorCodes.NO_ERROR
+            <h2.errors.ErrorCodes.NO_ERROR>`.
+        :type error_code: ``int``
+        :returns: Nothing
+        """
+        self.config.logger.debug("Reset stream ID %d", stream_id)
+        self.state_machine.process_input(ConnectionInputs.SEND_RST_STREAM)
+        stream = self._get_stream_by_id(stream_id)
+        frames = stream.reset_stream(error_code)
+        self._prepare_for_sending(frames)
+
+    def close_connection(self, error_code=0, additional_data=None,
+                         last_stream_id=None):
+
+        """
+        Close a connection, emitting a GOAWAY frame.
+
+        .. versionchanged:: 2.4.0
+           Added ``additional_data`` and ``last_stream_id`` arguments.
+
+        :param error_code: (optional) The error code to send in the GOAWAY
+            frame.
+        :param additional_data: (optional) Additional debug data indicating
+            a reason for closing the connection. Must be a bytestring.
+        :param last_stream_id: (optional) The last stream which was processed
+            by the sender. Defaults to ``highest_inbound_stream_id``.
+        :returns: Nothing
+        """
+        self.config.logger.debug("Close connection")
+        self.state_machine.process_input(ConnectionInputs.SEND_GOAWAY)
+
+        # Additional_data must be bytes
+        if additional_data is not None:
+            assert isinstance(additional_data, bytes)
+
+        if last_stream_id is None:
+            last_stream_id = self.highest_inbound_stream_id
+
+        f = GoAwayFrame(
+            stream_id=0,
+            last_stream_id=last_stream_id,
+            error_code=error_code,
+            additional_data=(additional_data or b'')
+        )
+        self._prepare_for_sending([f])
+
+    def update_settings(self, new_settings):
+        """
+        Update the local settings. This will prepare and emit the appropriate
+        SETTINGS frame.
+
+        :param new_settings: A dictionary of {setting: new value}
+        """
+        self.config.logger.debug(
+            "Update connection settings to %s", new_settings
+        )
+        self.state_machine.process_input(ConnectionInputs.SEND_SETTINGS)
+        self.local_settings.update(new_settings)
+        s = SettingsFrame(0)
+        s.settings = new_settings
+        self._prepare_for_sending([s])
+
+    def advertise_alternative_service(self,
+                                      field_value,
+                                      origin=None,
+                                      stream_id=None):
+        """
+        Notify a client about an available Alternative Service.
+
+        An Alternative Service is defined in `RFC 7838
+        <https://tools.ietf.org/html/rfc7838>`_. An Alternative Service
+        notification informs a client that a given origin is also available
+        elsewhere.
+
+        Alternative Services can be advertised in two ways. Firstly, they can
+        be advertised explicitly: that is, a server can say "origin X is also
+        available at Y". To advertise like this, set the ``origin`` argument
+        and not the ``stream_id`` argument. Alternatively, they can be
+        advertised implicitly: that is, a server can say "the origin you're
+        contacting on stream X is also available at Y". To advertise like this,
+        set the ``stream_id`` argument and not the ``origin`` argument.
+
+        The explicit method of advertising can be done as long as the
+        connection is active. The implicit method can only be done after the
+        client has sent the request headers and before the server has sent the
+        response headers: outside of those points, h2 will forbid sending
+        the Alternative Service advertisement by raising a ProtocolError.
+
+        The ``field_value`` parameter is specified in RFC 7838. h2 does
+        not validate or introspect this argument: the user is required to
+        ensure that it's well-formed. ``field_value`` corresponds to RFC 7838's
+        "Alternative Service Field Value".
+
+        .. note:: It is strongly preferred to use the explicit method of
+                  advertising Alternative Services. The implicit method of
+                  advertising Alternative Services has a number of subtleties
+                  and can lead to inconsistencies between the server and
+                  client. h2 allows both mechanisms, but caution is
+                  strongly advised.
+
+        .. versionadded:: 2.3.0
+
+        :param field_value: The RFC 7838 Alternative Service Field Value. This
+            argument is not introspected by h2: the user is responsible
+            for ensuring that it is well-formed.
+        :type field_value: ``bytes``
+
+        :param origin: The origin/authority to which the Alternative Service
+            being advertised applies. Must not be provided at the same time as
+            ``stream_id``.
+        :type origin: ``bytes`` or ``None``
+
+        :param stream_id: The ID of the stream which was sent to the authority
+            for which this Alternative Service advertisement applies. Must not
+            be provided at the same time as ``origin``.
+        :type stream_id: ``int`` or ``None``
+
+        :returns: Nothing.
+        """
+        if not isinstance(field_value, bytes):
+            raise ValueError("Field must be bytestring.")
+
+        if origin is not None and stream_id is not None:
+            raise ValueError("Must not provide both origin and stream_id")
+
+        self.state_machine.process_input(
+            ConnectionInputs.SEND_ALTERNATIVE_SERVICE
+        )
+
+        if origin is not None:
+            # This ALTSVC is sent on stream zero.
+            f = AltSvcFrame(stream_id=0)
+            f.origin = origin
+            f.field = field_value
+            frames = [f]
+        else:
+            stream = self._get_stream_by_id(stream_id)
+            frames = stream.advertise_alternative_service(field_value)
+
+        self._prepare_for_sending(frames)
+
+    def prioritize(self, stream_id, weight=None, depends_on=None,
+                   exclusive=None):
+        """
+        Notify a server about the priority of a stream.
+
+        Stream priorities are a form of guidance to a remote server: they
+        inform the server about how important a given response is, so that the
+        server may allocate its resources (e.g. bandwidth, CPU time, etc.)
+        accordingly. This exists to allow clients to ensure that the most
+        important data arrives earlier, while less important data does not
+        starve out the more important data.
+
+        Stream priorities are explained in depth in `RFC 7540 Section 5.3
+        <https://tools.ietf.org/html/rfc7540#section-5.3>`_.
+
+        This method updates the priority information of a single stream. It may
+        be called well before a stream is actively in use, or well after a
+        stream is closed.
+
+        .. warning:: RFC 7540 allows for servers to change the priority of
+                     streams. However, h2 **does not** allow server
+                     stacks to do this. This is because most clients do not
+                     adequately know how to respond when provided conflicting
+                     priority information, and relatively little utility is
+                     provided by making that functionality available.
+
+        .. note:: h2 **does not** maintain any information about the
+                  RFC 7540 priority tree. That means that h2 does not
+                  prevent incautious users from creating invalid priority
+                  trees, particularly by creating priority loops. While some
+                  basic error checking is provided by h2, users are
+                  strongly recommended to understand their prioritisation
+                  strategies before using the priority tools here.
+
+        .. note:: Priority information is strictly advisory. Servers are
+                  allowed to disregard it entirely. Avoid relying on the idea
+                  that your priority signaling will definitely be obeyed.
+
+        .. versionadded:: 2.4.0
+
+        :param stream_id: The ID of the stream to prioritize.
+        :type stream_id: ``int``
+
+        :param weight: The weight to give the stream. Defaults to ``16``, the
+             default weight of any stream. May be any value between ``1`` and
+             ``256`` inclusive. The relative weight of a stream indicates what
+             proportion of available resources will be allocated to that
+             stream.
+        :type weight: ``int``
+
+        :param depends_on: The ID of the stream on which this stream depends.
+             This stream will only be progressed if it is impossible to
+             progress the parent stream (the one on which this one depends).
+             Passing the value ``0`` means that this stream does not depend on
+             any other. Defaults to ``0``.
+        :type depends_on: ``int``
+
+        :param exclusive: Whether this stream is an exclusive dependency of its
+            "parent" stream (i.e. the stream given by ``depends_on``). If a
+            stream is an exclusive dependency of another, that means that all
+            previously-set children of the parent are moved to become children
+            of the new exclusively-dependent stream. Defaults to ``False``.
+        :type exclusive: ``bool``
+        """
+        if not self.config.client_side:
+            raise RFC1122Error("Servers SHOULD NOT prioritize streams.")
+
+        self.state_machine.process_input(
+            ConnectionInputs.SEND_PRIORITY
+        )
+
+        frame = PriorityFrame(stream_id)
+        frame = _add_frame_priority(frame, weight, depends_on, exclusive)
+
+        self._prepare_for_sending([frame])
+
+    def local_flow_control_window(self, stream_id):
+        """
+        Returns the maximum amount of data that can be sent on stream
+        ``stream_id``.
+
+        This value will never be larger than the total data that can be sent on
+        the connection: even if the given stream allows more data, the
+        connection window provides a logical maximum to the amount of data that
+        can be sent.
+
+        The maximum data that can be sent in a single data frame on a stream
+        is either this value, or the maximum frame size, whichever is
+        *smaller*.
+
+        :param stream_id: The ID of the stream whose flow control window is
+            being queried.
+        :type stream_id: ``int``
+        :returns: The amount of data in bytes that can be sent on the stream
+            before the flow control window is exhausted.
+        :rtype: ``int``
+        """
+        stream = self._get_stream_by_id(stream_id)
+        return min(
+            self.outbound_flow_control_window,
+            stream.outbound_flow_control_window
+        )
+
+    def remote_flow_control_window(self, stream_id):
+        """
+        Returns the maximum amount of data the remote peer can send on stream
+        ``stream_id``.
+
+        This value will never be larger than the total data that can be sent on
+        the connection: even if the given stream allows more data, the
+        connection window provides a logical maximum to the amount of data that
+        can be sent.
+
+        The maximum data that can be sent in a single data frame on a stream
+        is either this value, or the maximum frame size, whichever is
+        *smaller*.
+
+        :param stream_id: The ID of the stream whose flow control window is
+            being queried.
+        :type stream_id: ``int``
+        :returns: The amount of data in bytes that can be received on the
+            stream before the flow control window is exhausted.
+        :rtype: ``int``
+        """
+        stream = self._get_stream_by_id(stream_id)
+        return min(
+            self.inbound_flow_control_window,
+            stream.inbound_flow_control_window
+        )
+
+    def acknowledge_received_data(self, acknowledged_size, stream_id):
+        """
+        Inform the :class:`H2Connection <h2.connection.H2Connection>` that a
+        certain number of flow-controlled bytes have been processed, and that
+        the space should be handed back to the remote peer at an opportune
+        time.
+
+        .. versionadded:: 2.5.0
+
+        :param acknowledged_size: The total *flow-controlled size* of the data
+            that has been processed. Note that this must include the amount of
+            padding that was sent with that data.
+        :type acknowledged_size: ``int``
+        :param stream_id: The ID of the stream on which this data was received.
+        :type stream_id: ``int``
+        :returns: Nothing
+        :rtype: ``None``
+        """
+        self.config.logger.debug(
+            "Ack received data on stream ID %d with size %d",
+            stream_id, acknowledged_size
+        )
+        if stream_id <= 0:
+            raise ValueError(
+                "Stream ID %d is not valid for acknowledge_received_data" %
+                stream_id
+            )
+        if acknowledged_size < 0:
+            raise ValueError("Cannot acknowledge negative data")
+
+        frames = []
+
+        conn_manager = self._inbound_flow_control_window_manager
+        conn_increment = conn_manager.process_bytes(acknowledged_size)
+        if conn_increment:
+            f = WindowUpdateFrame(0)
+            f.window_increment = conn_increment
+            frames.append(f)
+
+        try:
+            stream = self._get_stream_by_id(stream_id)
+        except StreamClosedError:
+            # The stream is already gone. We're not worried about incrementing
+            # the window in this case.
+            pass
+        else:
+            # No point incrementing the windows of closed streams.
+            if stream.open:
+                frames.extend(
+                    stream.acknowledge_received_data(acknowledged_size)
+                )
+
+        self._prepare_for_sending(frames)
+
+    def data_to_send(self, amount=None):
+        """
+        Returns some data for sending out of the internal data buffer.
+
+        This method is analogous to ``read`` on a file-like object, but it
+        doesn't block. Instead, it returns as much data as the user asks for,
+        or less if that much data is not available. It does not perform any
+        I/O, and so uses a different name.
+
+        :param amount: (optional) The maximum amount of data to return. If not
+            set, or set to ``None``, will return as much data as possible.
+        :type amount: ``int``
+        :returns: A bytestring containing the data to send on the wire.
+        :rtype: ``bytes``
+        """
+        if amount is None:
+            data = bytes(self._data_to_send)
+            self._data_to_send = bytearray()
+            return data
+        else:
+            data = bytes(self._data_to_send[:amount])
+            self._data_to_send = self._data_to_send[amount:]
+            return data
+
+    def clear_outbound_data_buffer(self):
+        """
+        Clears the outbound data buffer, such that if this call was immediately
+        followed by a call to
+        :meth:`data_to_send <h2.connection.H2Connection.data_to_send>`, that
+        call would return no data.
+
+        This method should not normally be used, but is made available to avoid
+        exposing implementation details.
+        """
+        self._data_to_send = bytearray()
+
+    def _acknowledge_settings(self):
+        """
+        Acknowledge settings that have been received.
+
+        .. versionchanged:: 2.0.0
+           Removed from public API, removed useless ``event`` parameter, made
+           automatic.
+
+        :returns: Nothing
+        """
+        self.state_machine.process_input(ConnectionInputs.SEND_SETTINGS)
+
+        changes = self.remote_settings.acknowledge()
+
+        if SettingCodes.INITIAL_WINDOW_SIZE in changes:
+            setting = changes[SettingCodes.INITIAL_WINDOW_SIZE]
+            self._flow_control_change_from_settings(
+                setting.original_value,
+                setting.new_value,
+            )
+
+        # HEADER_TABLE_SIZE changes by the remote part affect our encoder: cf.
+        # RFC 7540 Section 6.5.2.
+        if SettingCodes.HEADER_TABLE_SIZE in changes:
+            setting = changes[SettingCodes.HEADER_TABLE_SIZE]
+            self.encoder.header_table_size = setting.new_value
+
+        if SettingCodes.MAX_FRAME_SIZE in changes:
+            setting = changes[SettingCodes.MAX_FRAME_SIZE]
+            self.max_outbound_frame_size = setting.new_value
+            for stream in self.streams.values():
+                stream.max_outbound_frame_size = setting.new_value
+
+        f = SettingsFrame(0)
+        f.flags.add('ACK')
+        return [f]
+
+    def _flow_control_change_from_settings(self, old_value, new_value):
+        """
+        Update flow control windows in response to a change in the value of
+        SETTINGS_INITIAL_WINDOW_SIZE.
+
+        When this setting is changed, it automatically updates all flow control
+        windows by the delta in the settings values. Note that it does not
+        increment the *connection* flow control window, per section 6.9.2 of
+        RFC 7540.
+        """
+        delta = new_value - old_value
+
+        for stream in self.streams.values():
+            stream.outbound_flow_control_window = guard_increment_window(
+                stream.outbound_flow_control_window,
+                delta
+            )
+
+    def _inbound_flow_control_change_from_settings(self, old_value, new_value):
+        """
+        Update remote flow control windows in response to a change in the value
+        of SETTINGS_INITIAL_WINDOW_SIZE.
+
+        When this setting is changed, it automatically updates all remote flow
+        control windows by the delta in the settings values.
+        """
+        delta = new_value - old_value
+
+        for stream in self.streams.values():
+            stream._inbound_flow_control_change_from_settings(delta)
+
+    def receive_data(self, data):
+        """
+        Pass some received HTTP/2 data to the connection for handling.
+
+        :param data: The data received from the remote peer on the network.
+        :type data: ``bytes``
+        :returns: A list of events that the remote peer triggered by sending
+            this data.
+        """
+        self.config.logger.trace(
+            "Process received data on connection. Received data: %r", data
+        )
+
+        events = []
+        self.incoming_buffer.add_data(data)
+        self.incoming_buffer.max_frame_size = self.max_inbound_frame_size
+
+        try:
+            for frame in self.incoming_buffer:
+                events.extend(self._receive_frame(frame))
+        except InvalidPaddingError:
+            self._terminate_connection(ErrorCodes.PROTOCOL_ERROR)
+            raise ProtocolError("Received frame with invalid padding.")
+        except ProtocolError as e:
+            # For whatever reason, receiving the frame caused a protocol error.
+            # We should prepare to emit a GoAway frame before throwing the
+            # exception up further. No need for an event: the exception will
+            # do fine.
+            self._terminate_connection(e.error_code)
+            raise
+
+        return events
+
+    def _receive_frame(self, frame):
+        """
+        Handle a frame received on the connection.
+
+        .. versionchanged:: 2.0.0
+           Removed from the public API.
+        """
+        self.config.logger.trace("Received frame: %s", repr(frame))
+        try:
+            # I don't love using __class__ here, maybe reconsider it.
+            frames, events = self._frame_dispatch_table[frame.__class__](frame)
+        except StreamClosedError as e:
+            # If the stream was closed by RST_STREAM, we just send a RST_STREAM
+            # to the remote peer. Otherwise, this is a connection error, and so
+            # we will re-raise to trigger one.
+            if self._stream_is_closed_by_reset(e.stream_id):
+                f = RstStreamFrame(e.stream_id)
+                f.error_code = e.error_code
+                self._prepare_for_sending([f])
+                events = e._events
+            else:
+                raise
+        except StreamIDTooLowError as e:
+            # The stream ID seems invalid. This may happen when the closed
+            # stream has been cleaned up, or when the remote peer has opened a
+            # new stream with a higher stream ID than this one, forcing it
+            # closed implicitly.
+            #
+            # Check how the stream was closed: depending on the mechanism, it
+            # is either a stream error or a connection error.
+            if self._stream_is_closed_by_reset(e.stream_id):
+                # Closed by RST_STREAM is a stream error.
+                f = RstStreamFrame(e.stream_id)
+                f.error_code = ErrorCodes.STREAM_CLOSED
+                self._prepare_for_sending([f])
+                events = []
+            elif self._stream_is_closed_by_end(e.stream_id):
+                # Closed by END_STREAM is a connection error.
+                raise StreamClosedError(e.stream_id)
+            else:
+                # Closed implicitly, also a connection error, but of type
+                # PROTOCOL_ERROR.
+                raise
+        else:
+            self._prepare_for_sending(frames)
+
+        return events
+
+    def _terminate_connection(self, error_code):
+        """
+        Terminate the connection early. Used in error handling blocks to send
+        GOAWAY frames.
+        """
+        f = GoAwayFrame(0)
+        f.last_stream_id = self.highest_inbound_stream_id
+        f.error_code = error_code
+        self.state_machine.process_input(ConnectionInputs.SEND_GOAWAY)
+        self._prepare_for_sending([f])
+
+    def _receive_headers_frame(self, frame):
+        """
+        Receive a headers frame on the connection.
+        """
+        # If necessary, check we can open the stream. Also validate that the
+        # stream ID is valid.
+        if frame.stream_id not in self.streams:
+            max_open_streams = self.local_settings.max_concurrent_streams
+            if (self.open_inbound_streams + 1) > max_open_streams:
+                raise TooManyStreamsError(
+                    "Max outbound streams is %d, %d open" %
+                    (max_open_streams, self.open_outbound_streams)
+                )
+
+        # Let's decode the headers. We handle headers as bytes internally up
+        # until we hang them off the event, at which point we may optionally
+        # convert them to unicode.
+        headers = _decode_headers(self.decoder, frame.data)
+
+        events = self.state_machine.process_input(
+            ConnectionInputs.RECV_HEADERS
+        )
+        stream = self._get_or_create_stream(
+            frame.stream_id, AllowedStreamIDs(not self.config.client_side)
+        )
+        frames, stream_events = stream.receive_headers(
+            headers,
+            'END_STREAM' in frame.flags,
+            self.config.header_encoding
+        )
+
+        if 'PRIORITY' in frame.flags:
+            p_frames, p_events = self._receive_priority_frame(frame)
+            stream_events[0].priority_updated = p_events[0]
+            stream_events.extend(p_events)
+            assert not p_frames
+
+        return frames, events + stream_events
+
+    def _receive_push_promise_frame(self, frame):
+        """
+        Receive a push-promise frame on the connection.
+        """
+        if not self.local_settings.enable_push:
+            raise ProtocolError("Received pushed stream")
+
+        pushed_headers = _decode_headers(self.decoder, frame.data)
+
+        events = self.state_machine.process_input(
+            ConnectionInputs.RECV_PUSH_PROMISE
+        )
+
+        try:
+            stream = self._get_stream_by_id(frame.stream_id)
+        except NoSuchStreamError:
+            # We need to check if the parent stream was reset by us. If it was
+            # then we presume that the PUSH_PROMISE was in flight when we reset
+            # the parent stream. Rather than accept the new stream, just reset
+            # it.
+            #
+            # If this was closed naturally, however, we should call this a
+            # PROTOCOL_ERROR: pushing a stream on a naturally closed stream is
+            # a real problem because it creates a brand new stream that the
+            # remote peer now believes exists.
+            if (self._stream_closed_by(frame.stream_id) ==
+                    StreamClosedBy.SEND_RST_STREAM):
+                f = RstStreamFrame(frame.promised_stream_id)
+                f.error_code = ErrorCodes.REFUSED_STREAM
+                return [f], events
+
+            raise ProtocolError("Attempted to push on closed stream.")
+
+        # We need to prevent peers pushing streams in response to streams that
+        # they themselves have already pushed: see #163 and RFC 7540 § 6.6. The
+        # easiest way to do that is to assert that the stream_id is not even:
+        # this shortcut works because only servers can push and the state
+        # machine will enforce this.
+        if (frame.stream_id % 2) == 0:
+            raise ProtocolError("Cannot recursively push streams.")
+
+        try:
+            frames, stream_events = stream.receive_push_promise_in_band(
+                frame.promised_stream_id,
+                pushed_headers,
+                self.config.header_encoding,
+            )
+        except StreamClosedError:
+            # The parent stream was reset by us, so we presume that
+            # PUSH_PROMISE was in flight when we reset the parent stream.
+            # So we just reset the new stream.
+            f = RstStreamFrame(frame.promised_stream_id)
+            f.error_code = ErrorCodes.REFUSED_STREAM
+            return [f], events
+
+        new_stream = self._begin_new_stream(
+            frame.promised_stream_id, AllowedStreamIDs.EVEN
+        )
+        self.streams[frame.promised_stream_id] = new_stream
+        new_stream.remotely_pushed(pushed_headers)
+
+        return frames, events + stream_events
+
+    def _handle_data_on_closed_stream(self, events, exc, frame):
+        # This stream is already closed - and yet we received a DATA frame.
+        # The received DATA frame counts towards the connection flow window.
+        # We need to manually to acknowledge the DATA frame to update the flow
+        # window of the connection. Otherwise the whole connection stalls due
+        # the inbound flow window being 0.
+        frames = []
+        conn_manager = self._inbound_flow_control_window_manager
+        conn_increment = conn_manager.process_bytes(
+            frame.flow_controlled_length
+        )
+        if conn_increment:
+            f = WindowUpdateFrame(0)
+            f.window_increment = conn_increment
+            frames.append(f)
+            self.config.logger.debug(
+                "Received DATA frame on closed stream %d - "
+                "auto-emitted a WINDOW_UPDATE by %d",
+                frame.stream_id, conn_increment
+            )
+        f = RstStreamFrame(exc.stream_id)
+        f.error_code = exc.error_code
+        frames.append(f)
+        self.config.logger.debug(
+            "Stream %d already CLOSED or cleaned up - "
+            "auto-emitted a RST_FRAME" % frame.stream_id
+        )
+        return frames, events + exc._events
+
+    def _receive_data_frame(self, frame):
+        """
+        Receive a data frame on the connection.
+        """
+        flow_controlled_length = frame.flow_controlled_length
+
+        events = self.state_machine.process_input(
+            ConnectionInputs.RECV_DATA
+        )
+        self._inbound_flow_control_window_manager.window_consumed(
+            flow_controlled_length
+        )
+
+        try:
+            stream = self._get_stream_by_id(frame.stream_id)
+            frames, stream_events = stream.receive_data(
+                frame.data,
+                'END_STREAM' in frame.flags,
+                flow_controlled_length
+            )
+        except StreamClosedError as e:
+            # This stream is either marked as CLOSED or already gone from our
+            # internal state.
+            return self._handle_data_on_closed_stream(events, e, frame)
+
+        return frames, events + stream_events
+
+    def _receive_settings_frame(self, frame):
+        """
+        Receive a SETTINGS frame on the connection.
+        """
+        events = self.state_machine.process_input(
+            ConnectionInputs.RECV_SETTINGS
+        )
+
+        # This is an ack of the local settings.
+        if 'ACK' in frame.flags:
+            changed_settings = self._local_settings_acked()
+            ack_event = SettingsAcknowledged()
+            ack_event.changed_settings = changed_settings
+            events.append(ack_event)
+            return [], events
+
+        # Add the new settings.
+        self.remote_settings.update(frame.settings)
+        events.append(
+            RemoteSettingsChanged.from_settings(
+                self.remote_settings, frame.settings
+            )
+        )
+        frames = self._acknowledge_settings()
+
+        return frames, events
+
+    def _receive_window_update_frame(self, frame):
+        """
+        Receive a WINDOW_UPDATE frame on the connection.
+        """
+        # hyperframe will take care of validating the window_increment.
+        # If we reach in here, we can assume a valid value.
+
+        events = self.state_machine.process_input(
+            ConnectionInputs.RECV_WINDOW_UPDATE
+        )
+
+        if frame.stream_id:
+            try:
+                stream = self._get_stream_by_id(frame.stream_id)
+                frames, stream_events = stream.receive_window_update(
+                    frame.window_increment
+                )
+            except StreamClosedError:
+                return [], events
+        else:
+            # Increment our local flow control window.
+            self.outbound_flow_control_window = guard_increment_window(
+                self.outbound_flow_control_window,
+                frame.window_increment
+            )
+
+            # FIXME: Should we split this into one event per active stream?
+            window_updated_event = WindowUpdated()
+            window_updated_event.stream_id = 0
+            window_updated_event.delta = frame.window_increment
+            stream_events = [window_updated_event]
+            frames = []
+
+        return frames, events + stream_events
+
+    def _receive_ping_frame(self, frame):
+        """
+        Receive a PING frame on the connection.
+        """
+        events = self.state_machine.process_input(
+            ConnectionInputs.RECV_PING
+        )
+        flags = []
+
+        if 'ACK' in frame.flags:
+            evt = PingAckReceived()
+        else:
+            evt = PingReceived()
+
+            # automatically ACK the PING with the same 'opaque data'
+            f = PingFrame(0)
+            f.flags = {'ACK'}
+            f.opaque_data = frame.opaque_data
+            flags.append(f)
+
+        evt.ping_data = frame.opaque_data
+        events.append(evt)
+
+        return flags, events
+
+    def _receive_rst_stream_frame(self, frame):
+        """
+        Receive a RST_STREAM frame on the connection.
+        """
+        events = self.state_machine.process_input(
+            ConnectionInputs.RECV_RST_STREAM
+        )
+        try:
+            stream = self._get_stream_by_id(frame.stream_id)
+        except NoSuchStreamError:
+            # The stream is missing. That's ok, we just do nothing here.
+            stream_frames = []
+            stream_events = []
+        else:
+            stream_frames, stream_events = stream.stream_reset(frame)
+
+        return stream_frames, events + stream_events
+
+    def _receive_priority_frame(self, frame):
+        """
+        Receive a PRIORITY frame on the connection.
+        """
+        events = self.state_machine.process_input(
+            ConnectionInputs.RECV_PRIORITY
+        )
+
+        event = PriorityUpdated()
+        event.stream_id = frame.stream_id
+        event.depends_on = frame.depends_on
+        event.exclusive = frame.exclusive
+
+        # Weight is an integer between 1 and 256, but the byte only allows
+        # 0 to 255: add one.
+        event.weight = frame.stream_weight + 1
+
+        # A stream may not depend on itself.
+        if event.depends_on == frame.stream_id:
+            raise ProtocolError(
+                "Stream %d may not depend on itself" % frame.stream_id
+            )
+        events.append(event)
+
+        return [], events
+
+    def _receive_goaway_frame(self, frame):
+        """
+        Receive a GOAWAY frame on the connection.
+        """
+        events = self.state_machine.process_input(
+            ConnectionInputs.RECV_GOAWAY
+        )
+
+        # Clear the outbound data buffer: we cannot send further data now.
+        self.clear_outbound_data_buffer()
+
+        # Fire an appropriate ConnectionTerminated event.
+        new_event = ConnectionTerminated()
+        new_event.error_code = _error_code_from_int(frame.error_code)
+        new_event.last_stream_id = frame.last_stream_id
+        new_event.additional_data = (frame.additional_data
+                                     if frame.additional_data else None)
+        events.append(new_event)
+
+        return [], events
+
+    def _receive_naked_continuation(self, frame):
+        """
+        A naked CONTINUATION frame has been received. This is always an error,
+        but the type of error it is depends on the state of the stream and must
+        transition the state of the stream, so we need to pass it to the
+        appropriate stream.
+        """
+        stream = self._get_stream_by_id(frame.stream_id)
+        stream.receive_continuation()
+        assert False, "Should not be reachable"
+
+    def _receive_alt_svc_frame(self, frame):
+        """
+        An ALTSVC frame has been received. This frame, specified in RFC 7838,
+        is used to advertise alternative places where the same service can be
+        reached.
+
+        This frame can optionally be received either on a stream or on stream
+        0, and its semantics are different in each case.
+        """
+        events = self.state_machine.process_input(
+            ConnectionInputs.RECV_ALTERNATIVE_SERVICE
+        )
+        frames = []
+
+        if frame.stream_id:
+            # Given that it makes no sense to receive ALTSVC on a stream
+            # before that stream has been opened with a HEADERS frame, the
+            # ALTSVC frame cannot create a stream. If the stream is not
+            # present, we simply ignore the frame.
+            try:
+                stream = self._get_stream_by_id(frame.stream_id)
+            except (NoSuchStreamError, StreamClosedError):
+                pass
+            else:
+                stream_frames, stream_events = stream.receive_alt_svc(frame)
+                frames.extend(stream_frames)
+                events.extend(stream_events)
+        else:
+            # This frame is sent on stream 0. The origin field on the frame
+            # must be present, though if it isn't it's not a ProtocolError
+            # (annoyingly), we just need to ignore it.
+            if not frame.origin:
+                return frames, events
+
+            # If we're a server, we want to ignore this (RFC 7838 says so).
+            if not self.config.client_side:
+                return frames, events
+
+            event = AlternativeServiceAvailable()
+            event.origin = frame.origin
+            event.field_value = frame.field
+            events.append(event)
+
+        return frames, events
+
+    def _receive_unknown_frame(self, frame):
+        """
+        We have received a frame that we do not understand. This is almost
+        certainly an extension frame, though it's impossible to be entirely
+        sure.
+
+        RFC 7540 § 5.5 says that we MUST ignore unknown frame types: so we
+        do. We do notify the user that we received one, however.
+        """
+        # All we do here is log.
+        self.config.logger.debug(
+            "Received unknown extension frame (ID %d)", frame.stream_id
+        )
+        event = UnknownFrameReceived()
+        event.frame = frame
+        return [], [event]
+
+    def _local_settings_acked(self):
+        """
+        Handle the local settings being ACKed, update internal state.
+        """
+        changes = self.local_settings.acknowledge()
+
+        if SettingCodes.INITIAL_WINDOW_SIZE in changes:
+            setting = changes[SettingCodes.INITIAL_WINDOW_SIZE]
+            self._inbound_flow_control_change_from_settings(
+                setting.original_value,
+                setting.new_value,
+            )
+
+        if SettingCodes.MAX_HEADER_LIST_SIZE in changes:
+            setting = changes[SettingCodes.MAX_HEADER_LIST_SIZE]
+            self.decoder.max_header_list_size = setting.new_value
+
+        if SettingCodes.MAX_FRAME_SIZE in changes:
+            setting = changes[SettingCodes.MAX_FRAME_SIZE]
+            self.max_inbound_frame_size = setting.new_value
+
+        if SettingCodes.HEADER_TABLE_SIZE in changes:
+            setting = changes[SettingCodes.HEADER_TABLE_SIZE]
+            # This is safe across all hpack versions: some versions just won't
+            # respect it.
+            self.decoder.max_allowed_table_size = setting.new_value
+
+        return changes
+
+    def _stream_id_is_outbound(self, stream_id):
+        """
+        Returns ``True`` if the stream ID corresponds to an outbound stream
+        (one initiated by this peer), returns ``False`` otherwise.
+        """
+        return (stream_id % 2 == int(self.config.client_side))
+
+    def _stream_closed_by(self, stream_id):
+        """
+        Returns how the stream was closed.
+
+        The return value will be either a member of
+        ``h2.stream.StreamClosedBy`` or ``None``. If ``None``, the stream was
+        closed implicitly by the peer opening a stream with a higher stream ID
+        before opening this one.
+        """
+        if stream_id in self.streams:
+            return self.streams[stream_id].closed_by
+        if stream_id in self._closed_streams:
+            return self._closed_streams[stream_id]
+        return None
+
+    def _stream_is_closed_by_reset(self, stream_id):
+        """
+        Returns ``True`` if the stream was closed by sending or receiving a
+        RST_STREAM frame. Returns ``False`` otherwise.
+        """
+        return self._stream_closed_by(stream_id) in (
+            StreamClosedBy.RECV_RST_STREAM, StreamClosedBy.SEND_RST_STREAM
+        )
+
+    def _stream_is_closed_by_end(self, stream_id):
+        """
+        Returns ``True`` if the stream was closed by sending or receiving an
+        END_STREAM flag in a HEADERS or DATA frame. Returns ``False``
+        otherwise.
+        """
+        return self._stream_closed_by(stream_id) in (
+            StreamClosedBy.RECV_END_STREAM, StreamClosedBy.SEND_END_STREAM
+        )
+
+
+def _add_frame_priority(frame, weight=None, depends_on=None, exclusive=None):
+    """
+    Adds priority data to a given frame. Does not change any flags set on that
+    frame: if the caller is adding priority information to a HEADERS frame they
+    must set that themselves.
+
+    This method also deliberately sets defaults for anything missing.
+
+    This method validates the input values.
+    """
+    # A stream may not depend on itself.
+    if depends_on == frame.stream_id:
+        raise ProtocolError(
+            "Stream %d may not depend on itself" % frame.stream_id
+        )
+
+    # Weight must be between 1 and 256.
+    if weight is not None:
+        if weight > 256 or weight < 1:
+            raise ProtocolError(
+                "Weight must be between 1 and 256, not %d" % weight
+            )
+        else:
+            # Weight is an integer between 1 and 256, but the byte only allows
+            # 0 to 255: subtract one.
+            weight -= 1
+
+    # Set defaults for anything not provided.
+    weight = weight if weight is not None else 15
+    depends_on = depends_on if depends_on is not None else 0
+    exclusive = exclusive if exclusive is not None else False
+
+    frame.stream_weight = weight
+    frame.depends_on = depends_on
+    frame.exclusive = exclusive
+
+    return frame
+
+
+def _decode_headers(decoder, encoded_header_block):
+    """
+    Decode a HPACK-encoded header block, translating HPACK exceptions into
+    sensible h2 errors.
+
+    This only ever returns bytestring headers: h2 may emit them as
+    unicode later, but internally it processes them as bytestrings only.
+    """
+    try:
+        return decoder.decode(encoded_header_block, raw=True)
+    except OversizedHeaderListError as e:
+        # This is a symptom of a HPACK bomb attack: the user has
+        # disregarded our requirements on how large a header block we'll
+        # accept.
+        raise DenialOfServiceError("Oversized header block: %s" % e)
+    except (HPACKError, IndexError, TypeError, UnicodeDecodeError) as e:
+        # We should only need HPACKError here, but versions of HPACK older
+        # than 2.1.0 throw all three others as well. For maximum
+        # compatibility, catch all of them.
+        raise ProtocolError("Error decoding header block: %s" % e)
diff --git a/llm/Lib/site-packages/h2/errors.py b/llm/Lib/site-packages/h2/errors.py
new file mode 100644
index 0000000000000000000000000000000000000000..303df59769399fbbbc5268a3c166568c1534b2a6
--- /dev/null
+++ b/llm/Lib/site-packages/h2/errors.py
@@ -0,0 +1,75 @@
+# -*- coding: utf-8 -*-
+"""
+h2/errors
+~~~~~~~~~
+
+Global error code registry containing the established HTTP/2 error codes.
+
+The current registry is available at:
+https://tools.ietf.org/html/rfc7540#section-11.4
+"""
+import enum
+
+
+class ErrorCodes(enum.IntEnum):
+    """
+    All known HTTP/2 error codes.
+
+    .. versionadded:: 2.5.0
+    """
+    #: Graceful shutdown.
+    NO_ERROR = 0x0
+
+    #: Protocol error detected.
+    PROTOCOL_ERROR = 0x1
+
+    #: Implementation fault.
+    INTERNAL_ERROR = 0x2
+
+    #: Flow-control limits exceeded.
+    FLOW_CONTROL_ERROR = 0x3
+
+    #: Settings not acknowledged.
+    SETTINGS_TIMEOUT = 0x4
+
+    #: Frame received for closed stream.
+    STREAM_CLOSED = 0x5
+
+    #: Frame size incorrect.
+    FRAME_SIZE_ERROR = 0x6
+
+    #: Stream not processed.
+    REFUSED_STREAM = 0x7
+
+    #: Stream cancelled.
+    CANCEL = 0x8
+
+    #: Compression state not updated.
+    COMPRESSION_ERROR = 0x9
+
+    #: TCP connection error for CONNECT method.
+    CONNECT_ERROR = 0xa
+
+    #: Processing capacity exceeded.
+    ENHANCE_YOUR_CALM = 0xb
+
+    #: Negotiated TLS parameters not acceptable.
+    INADEQUATE_SECURITY = 0xc
+
+    #: Use HTTP/1.1 for the request.
+    HTTP_1_1_REQUIRED = 0xd
+
+
+def _error_code_from_int(code):
+    """
+    Given an integer error code, returns either one of :class:`ErrorCodes
+    <h2.errors.ErrorCodes>` or, if not present in the known set of codes,
+    returns the integer directly.
+    """
+    try:
+        return ErrorCodes(code)
+    except ValueError:
+        return code
+
+
+__all__ = ['ErrorCodes']
diff --git a/llm/Lib/site-packages/h2/events.py b/llm/Lib/site-packages/h2/events.py
new file mode 100644
index 0000000000000000000000000000000000000000..66c3cff4abf0c57aed7ac1344ec8f4b88a0f467f
--- /dev/null
+++ b/llm/Lib/site-packages/h2/events.py
@@ -0,0 +1,634 @@
+# -*- coding: utf-8 -*-
+"""
+h2/events
+~~~~~~~~~
+
+Defines Event types for HTTP/2.
+
+Events are returned by the H2 state machine to allow implementations to keep
+track of events triggered by receiving data. Each time data is provided to the
+H2 state machine it processes the data and returns a list of Event objects.
+"""
+import binascii
+
+from .settings import ChangedSetting, _setting_code_from_int
+
+
+class Event:
+    """
+    Base class for h2 events.
+    """
+    pass
+
+
+class RequestReceived(Event):
+    """
+    The RequestReceived event is fired whenever request headers are received.
+    This event carries the HTTP headers for the given request and the stream ID
+    of the new stream.
+
+    .. versionchanged:: 2.3.0
+       Changed the type of ``headers`` to :class:`HeaderTuple
+       <hpack:hpack.HeaderTuple>`. This has no effect on current users.
+
+    .. versionchanged:: 2.4.0
+       Added ``stream_ended`` and ``priority_updated`` properties.
+    """
+    def __init__(self):
+        #: The Stream ID for the stream this request was made on.
+        self.stream_id = None
+
+        #: The request headers.
+        self.headers = None
+
+        #: If this request also ended the stream, the associated
+        #: :class:`StreamEnded <h2.events.StreamEnded>` event will be available
+        #: here.
+        #:
+        #: .. versionadded:: 2.4.0
+        self.stream_ended = None
+
+        #: If this request also had associated priority information, the
+        #: associated :class:`PriorityUpdated <h2.events.PriorityUpdated>`
+        #: event will be available here.
+        #:
+        #: .. versionadded:: 2.4.0
+        self.priority_updated = None
+
+    def __repr__(self):
+        return "<RequestReceived stream_id:%s, headers:%s>" % (
+            self.stream_id, self.headers
+        )
+
+
+class ResponseReceived(Event):
+    """
+    The ResponseReceived event is fired whenever response headers are received.
+    This event carries the HTTP headers for the given response and the stream
+    ID of the new stream.
+
+    .. versionchanged:: 2.3.0
+       Changed the type of ``headers`` to :class:`HeaderTuple
+       <hpack:hpack.HeaderTuple>`. This has no effect on current users.
+
+   .. versionchanged:: 2.4.0
+      Added ``stream_ended`` and ``priority_updated`` properties.
+    """
+    def __init__(self):
+        #: The Stream ID for the stream this response was made on.
+        self.stream_id = None
+
+        #: The response headers.
+        self.headers = None
+
+        #: If this response also ended the stream, the associated
+        #: :class:`StreamEnded <h2.events.StreamEnded>` event will be available
+        #: here.
+        #:
+        #: .. versionadded:: 2.4.0
+        self.stream_ended = None
+
+        #: If this response also had associated priority information, the
+        #: associated :class:`PriorityUpdated <h2.events.PriorityUpdated>`
+        #: event will be available here.
+        #:
+        #: .. versionadded:: 2.4.0
+        self.priority_updated = None
+
+    def __repr__(self):
+        return "<ResponseReceived stream_id:%s, headers:%s>" % (
+            self.stream_id, self.headers
+        )
+
+
+class TrailersReceived(Event):
+    """
+    The TrailersReceived event is fired whenever trailers are received on a
+    stream. Trailers are a set of headers sent after the body of the
+    request/response, and are used to provide information that wasn't known
+    ahead of time (e.g. content-length). This event carries the HTTP header
+    fields that form the trailers and the stream ID of the stream on which they
+    were received.
+
+    .. versionchanged:: 2.3.0
+       Changed the type of ``headers`` to :class:`HeaderTuple
+       <hpack:hpack.HeaderTuple>`. This has no effect on current users.
+
+    .. versionchanged:: 2.4.0
+       Added ``stream_ended`` and ``priority_updated`` properties.
+    """
+    def __init__(self):
+        #: The Stream ID for the stream on which these trailers were received.
+        self.stream_id = None
+
+        #: The trailers themselves.
+        self.headers = None
+
+        #: Trailers always end streams. This property has the associated
+        #: :class:`StreamEnded <h2.events.StreamEnded>` in it.
+        #:
+        #: .. versionadded:: 2.4.0
+        self.stream_ended = None
+
+        #: If the trailers also set associated priority information, the
+        #: associated :class:`PriorityUpdated <h2.events.PriorityUpdated>`
+        #: event will be available here.
+        #:
+        #: .. versionadded:: 2.4.0
+        self.priority_updated = None
+
+    def __repr__(self):
+        return "<TrailersReceived stream_id:%s, headers:%s>" % (
+            self.stream_id, self.headers
+        )
+
+
+class _HeadersSent(Event):
+    """
+    The _HeadersSent event is fired whenever headers are sent.
+
+    This is an internal event, used to determine validation steps on
+    outgoing header blocks.
+    """
+    pass
+
+
+class _ResponseSent(_HeadersSent):
+    """
+    The _ResponseSent event is fired whenever response headers are sent
+    on a stream.
+
+    This is an internal event, used to determine validation steps on
+    outgoing header blocks.
+    """
+    pass
+
+
+class _RequestSent(_HeadersSent):
+    """
+    The _RequestSent event is fired whenever request headers are sent
+    on a stream.
+
+    This is an internal event, used to determine validation steps on
+    outgoing header blocks.
+    """
+    pass
+
+
+class _TrailersSent(_HeadersSent):
+    """
+    The _TrailersSent event is fired whenever trailers are sent on a
+    stream. Trailers are a set of headers sent after the body of the
+    request/response, and are used to provide information that wasn't known
+    ahead of time (e.g. content-length).
+
+    This is an internal event, used to determine validation steps on
+    outgoing header blocks.
+    """
+    pass
+
+
+class _PushedRequestSent(_HeadersSent):
+    """
+    The _PushedRequestSent event is fired whenever pushed request headers are
+    sent.
+
+    This is an internal event, used to determine validation steps on outgoing
+    header blocks.
+    """
+    pass
+
+
+class InformationalResponseReceived(Event):
+    """
+    The InformationalResponseReceived event is fired when an informational
+    response (that is, one whose status code is a 1XX code) is received from
+    the remote peer.
+
+    The remote peer may send any number of these, from zero upwards. These
+    responses are most commonly sent in response to requests that have the
+    ``expect: 100-continue`` header field present. Most users can safely
+    ignore this event unless you are intending to use the
+    ``expect: 100-continue`` flow, or are for any reason expecting a different
+    1XX status code.
+
+    .. versionadded:: 2.2.0
+
+    .. versionchanged:: 2.3.0
+       Changed the type of ``headers`` to :class:`HeaderTuple
+       <hpack:hpack.HeaderTuple>`. This has no effect on current users.
+
+    .. versionchanged:: 2.4.0
+       Added ``priority_updated`` property.
+    """
+    def __init__(self):
+        #: The Stream ID for the stream this informational response was made
+        #: on.
+        self.stream_id = None
+
+        #: The headers for this informational response.
+        self.headers = None
+
+        #: If this response also had associated priority information, the
+        #: associated :class:`PriorityUpdated <h2.events.PriorityUpdated>`
+        #: event will be available here.
+        #:
+        #: .. versionadded:: 2.4.0
+        self.priority_updated = None
+
+    def __repr__(self):
+        return "<InformationalResponseReceived stream_id:%s, headers:%s>" % (
+            self.stream_id, self.headers
+        )
+
+
+class DataReceived(Event):
+    """
+    The DataReceived event is fired whenever data is received on a stream from
+    the remote peer. The event carries the data itself, and the stream ID on
+    which the data was received.
+
+    .. versionchanged:: 2.4.0
+       Added ``stream_ended`` property.
+    """
+    def __init__(self):
+        #: The Stream ID for the stream this data was received on.
+        self.stream_id = None
+
+        #: The data itself.
+        self.data = None
+
+        #: The amount of data received that counts against the flow control
+        #: window. Note that padding counts against the flow control window, so
+        #: when adjusting flow control you should always use this field rather
+        #: than ``len(data)``.
+        self.flow_controlled_length = None
+
+        #: If this data chunk also completed the stream, the associated
+        #: :class:`StreamEnded <h2.events.StreamEnded>` event will be available
+        #: here.
+        #:
+        #: .. versionadded:: 2.4.0
+        self.stream_ended = None
+
+    def __repr__(self):
+        return (
+            "<DataReceived stream_id:%s, "
+            "flow_controlled_length:%s, "
+            "data:%s>" % (
+                self.stream_id,
+                self.flow_controlled_length,
+                _bytes_representation(self.data[:20]),
+            )
+        )
+
+
+class WindowUpdated(Event):
+    """
+    The WindowUpdated event is fired whenever a flow control window changes
+    size. HTTP/2 defines flow control windows for connections and streams: this
+    event fires for both connections and streams. The event carries the ID of
+    the stream to which it applies (set to zero if the window update applies to
+    the connection), and the delta in the window size.
+    """
+    def __init__(self):
+        #: The Stream ID of the stream whose flow control window was changed.
+        #: May be ``0`` if the connection window was changed.
+        self.stream_id = None
+
+        #: The window delta.
+        self.delta = None
+
+    def __repr__(self):
+        return "<WindowUpdated stream_id:%s, delta:%s>" % (
+            self.stream_id, self.delta
+        )
+
+
+class RemoteSettingsChanged(Event):
+    """
+    The RemoteSettingsChanged event is fired whenever the remote peer changes
+    its settings. It contains a complete inventory of changed settings,
+    including their previous values.
+
+    In HTTP/2, settings changes need to be acknowledged. h2 automatically
+    acknowledges settings changes for efficiency. However, it is possible that
+    the caller may not be happy with the changed setting.
+
+    When this event is received, the caller should confirm that the new
+    settings are acceptable. If they are not acceptable, the user should close
+    the connection with the error code :data:`PROTOCOL_ERROR
+    <h2.errors.ErrorCodes.PROTOCOL_ERROR>`.
+
+    .. versionchanged:: 2.0.0
+       Prior to this version the user needed to acknowledge settings changes.
+       This is no longer the case: h2 now automatically acknowledges
+       them.
+    """
+    def __init__(self):
+        #: A dictionary of setting byte to
+        #: :class:`ChangedSetting <h2.settings.ChangedSetting>`, representing
+        #: the changed settings.
+        self.changed_settings = {}
+
+    @classmethod
+    def from_settings(cls, old_settings, new_settings):
+        """
+        Build a RemoteSettingsChanged event from a set of changed settings.
+
+        :param old_settings: A complete collection of old settings, in the form
+                             of a dictionary of ``{setting: value}``.
+        :param new_settings: All the changed settings and their new values, in
+                             the form of a dictionary of ``{setting: value}``.
+        """
+        e = cls()
+        for setting, new_value in new_settings.items():
+            setting = _setting_code_from_int(setting)
+            original_value = old_settings.get(setting)
+            change = ChangedSetting(setting, original_value, new_value)
+            e.changed_settings[setting] = change
+
+        return e
+
+    def __repr__(self):
+        return "<RemoteSettingsChanged changed_settings:{%s}>" % (
+            ", ".join(repr(cs) for cs in self.changed_settings.values()),
+        )
+
+
+class PingReceived(Event):
+    """
+    The PingReceived event is fired whenever a PING is received. It contains
+    the 'opaque data' of the PING frame. A ping acknowledgment with the same
+    'opaque data' is automatically emitted after receiving a ping.
+
+    .. versionadded:: 3.1.0
+    """
+    def __init__(self):
+        #: The data included on the ping.
+        self.ping_data = None
+
+    def __repr__(self):
+        return "<PingReceived ping_data:%s>" % (
+            _bytes_representation(self.ping_data),
+        )
+
+
+class PingAckReceived(Event):
+    """
+    The PingAckReceived event is fired whenever a PING acknowledgment is
+    received. It contains the 'opaque data' of the PING+ACK frame, allowing the
+    user to correlate PINGs and calculate RTT.
+
+    .. versionadded:: 3.1.0
+
+    .. versionchanged:: 4.0.0
+       Removed deprecated but equivalent ``PingAcknowledged``.
+    """
+    def __init__(self):
+        #: The data included on the ping.
+        self.ping_data = None
+
+    def __repr__(self):
+        return "<PingAckReceived ping_data:%s>" % (
+            _bytes_representation(self.ping_data),
+        )
+
+
+class StreamEnded(Event):
+    """
+    The StreamEnded event is fired whenever a stream is ended by a remote
+    party. The stream may not be fully closed if it has not been closed
+    locally, but no further data or headers should be expected on that stream.
+    """
+    def __init__(self):
+        #: The Stream ID of the stream that was closed.
+        self.stream_id = None
+
+    def __repr__(self):
+        return "<StreamEnded stream_id:%s>" % self.stream_id
+
+
+class StreamReset(Event):
+    """
+    The StreamReset event is fired in two situations. The first is when the
+    remote party forcefully resets the stream. The second is when the remote
+    party has made a protocol error which only affects a single stream. In this
+    case, h2 will terminate the stream early and return this event.
+
+    .. versionchanged:: 2.0.0
+       This event is now fired when h2 automatically resets a stream.
+    """
+    def __init__(self):
+        #: The Stream ID of the stream that was reset.
+        self.stream_id = None
+
+        #: The error code given. Either one of :class:`ErrorCodes
+        #: <h2.errors.ErrorCodes>` or ``int``
+        self.error_code = None
+
+        #: Whether the remote peer sent a RST_STREAM or we did.
+        self.remote_reset = True
+
+    def __repr__(self):
+        return "<StreamReset stream_id:%s, error_code:%s, remote_reset:%s>" % (
+            self.stream_id, self.error_code, self.remote_reset
+        )
+
+
+class PushedStreamReceived(Event):
+    """
+    The PushedStreamReceived event is fired whenever a pushed stream has been
+    received from a remote peer. The event carries on it the new stream ID, the
+    ID of the parent stream, and the request headers pushed by the remote peer.
+    """
+    def __init__(self):
+        #: The Stream ID of the stream created by the push.
+        self.pushed_stream_id = None
+
+        #: The Stream ID of the stream that the push is related to.
+        self.parent_stream_id = None
+
+        #: The request headers, sent by the remote party in the push.
+        self.headers = None
+
+    def __repr__(self):
+        return (
+            "<PushedStreamReceived pushed_stream_id:%s, parent_stream_id:%s, "
+            "headers:%s>" % (
+                self.pushed_stream_id,
+                self.parent_stream_id,
+                self.headers,
+            )
+        )
+
+
+class SettingsAcknowledged(Event):
+    """
+    The SettingsAcknowledged event is fired whenever a settings ACK is received
+    from the remote peer. The event carries on it the settings that were
+    acknowedged, in the same format as
+    :class:`h2.events.RemoteSettingsChanged`.
+    """
+    def __init__(self):
+        #: A dictionary of setting byte to
+        #: :class:`ChangedSetting <h2.settings.ChangedSetting>`, representing
+        #: the changed settings.
+        self.changed_settings = {}
+
+    def __repr__(self):
+        return "<SettingsAcknowledged changed_settings:{%s}>" % (
+            ", ".join(repr(cs) for cs in self.changed_settings.values()),
+        )
+
+
+class PriorityUpdated(Event):
+    """
+    The PriorityUpdated event is fired whenever a stream sends updated priority
+    information. This can occur when the stream is opened, or at any time
+    during the stream lifetime.
+
+    This event is purely advisory, and does not need to be acted on.
+
+    .. versionadded:: 2.0.0
+    """
+    def __init__(self):
+        #: The ID of the stream whose priority information is being updated.
+        self.stream_id = None
+
+        #: The new stream weight. May be the same as the original stream
+        #: weight. An integer between 1 and 256.
+        self.weight = None
+
+        #: The stream ID this stream now depends on. May be ``0``.
+        self.depends_on = None
+
+        #: Whether the stream *exclusively* depends on the parent stream. If it
+        #: does, this stream should inherit the current children of its new
+        #: parent.
+        self.exclusive = None
+
+    def __repr__(self):
+        return (
+            "<PriorityUpdated stream_id:%s, weight:%s, depends_on:%s, "
+            "exclusive:%s>" % (
+                self.stream_id,
+                self.weight,
+                self.depends_on,
+                self.exclusive
+            )
+        )
+
+
+class ConnectionTerminated(Event):
+    """
+    The ConnectionTerminated event is fired when a connection is torn down by
+    the remote peer using a GOAWAY frame. Once received, no further action may
+    be taken on the connection: a new connection must be established.
+    """
+    def __init__(self):
+        #: The error code cited when tearing down the connection. Should be
+        #: one of :class:`ErrorCodes <h2.errors.ErrorCodes>`, but may not be if
+        #: unknown HTTP/2 extensions are being used.
+        self.error_code = None
+
+        #: The stream ID of the last stream the remote peer saw. This can
+        #: provide an indication of what data, if any, never reached the remote
+        #: peer and so can safely be resent.
+        self.last_stream_id = None
+
+        #: Additional debug data that can be appended to GOAWAY frame.
+        self.additional_data = None
+
+    def __repr__(self):
+        return (
+            "<ConnectionTerminated error_code:%s, last_stream_id:%s, "
+            "additional_data:%s>" % (
+                self.error_code,
+                self.last_stream_id,
+                _bytes_representation(
+                    self.additional_data[:20]
+                    if self.additional_data else None)
+            )
+        )
+
+
+class AlternativeServiceAvailable(Event):
+    """
+    The AlternativeServiceAvailable event is fired when the remote peer
+    advertises an `RFC 7838 <https://tools.ietf.org/html/rfc7838>`_ Alternative
+    Service using an ALTSVC frame.
+
+    This event always carries the origin to which the ALTSVC information
+    applies. That origin is either supplied by the server directly, or inferred
+    by h2 from the ``:authority`` pseudo-header field that was sent by
+    the user when initiating a given stream.
+
+    This event also carries what RFC 7838 calls the "Alternative Service Field
+    Value", which is formatted like a HTTP header field and contains the
+    relevant alternative service information. h2 does not parse or in any
+    way modify that information: the user is required to do that.
+
+    This event can only be fired on the client end of a connection.
+
+    .. versionadded:: 2.3.0
+    """
+    def __init__(self):
+        #: The origin to which the alternative service field value applies.
+        #: This field is either supplied by the server directly, or inferred by
+        #: h2 from the ``:authority`` pseudo-header field that was sent
+        #: by the user when initiating the stream on which the frame was
+        #: received.
+        self.origin = None
+
+        #: The ALTSVC field value. This contains information about the HTTP
+        #: alternative service being advertised by the server. h2 does
+        #: not parse this field: it is left exactly as sent by the server. The
+        #: structure of the data in this field is given by `RFC 7838 Section 3
+        #: <https://tools.ietf.org/html/rfc7838#section-3>`_.
+        self.field_value = None
+
+    def __repr__(self):
+        return (
+            "<AlternativeServiceAvailable origin:%s, field_value:%s>" % (
+                self.origin.decode('utf-8', 'ignore'),
+                self.field_value.decode('utf-8', 'ignore'),
+            )
+        )
+
+
+class UnknownFrameReceived(Event):
+    """
+    The UnknownFrameReceived event is fired when the remote peer sends a frame
+    that h2 does not understand. This occurs primarily when the remote
+    peer is employing HTTP/2 extensions that h2 doesn't know anything
+    about.
+
+    RFC 7540 requires that HTTP/2 implementations ignore these frames. h2
+    does so. However, this event is fired to allow implementations to perform
+    special processing on those frames if needed (e.g. if the implementation
+    is capable of handling the frame itself).
+
+    .. versionadded:: 2.7.0
+    """
+    def __init__(self):
+        #: The hyperframe Frame object that encapsulates the received frame.
+        self.frame = None
+
+    def __repr__(self):
+        return "<UnknownFrameReceived>"
+
+
+def _bytes_representation(data):
+    """
+    Converts a bytestring into something that is safe to print on all Python
+    platforms.
+
+    This function is relatively expensive, so it should not be called on the
+    mainline of the code. It's safe to use in things like object repr methods
+    though.
+    """
+    if data is None:
+        return None
+
+    return binascii.hexlify(data).decode('ascii')
diff --git a/llm/Lib/site-packages/h2/exceptions.py b/llm/Lib/site-packages/h2/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..e22bebc0b50f1fcef5da88c2057989f8c92329d3
--- /dev/null
+++ b/llm/Lib/site-packages/h2/exceptions.py
@@ -0,0 +1,187 @@
+# -*- coding: utf-8 -*-
+"""
+h2/exceptions
+~~~~~~~~~~~~~
+
+Exceptions for the HTTP/2 module.
+"""
+import h2.errors
+
+
+class H2Error(Exception):
+    """
+    The base class for all exceptions for the HTTP/2 module.
+    """
+
+
+class ProtocolError(H2Error):
+    """
+    An action was attempted in violation of the HTTP/2 protocol.
+    """
+    #: The error code corresponds to this kind of Protocol Error.
+    error_code = h2.errors.ErrorCodes.PROTOCOL_ERROR
+
+
+class FrameTooLargeError(ProtocolError):
+    """
+    The frame that we tried to send or that we received was too large.
+    """
+    #: The error code corresponds to this kind of Protocol Error.
+    error_code = h2.errors.ErrorCodes.FRAME_SIZE_ERROR
+
+
+class FrameDataMissingError(ProtocolError):
+    """
+    The frame that we received is missing some data.
+
+    .. versionadded:: 2.0.0
+    """
+    #: The error code corresponds to this kind of Protocol Error.
+    error_code = h2.errors.ErrorCodes.FRAME_SIZE_ERROR
+
+
+class TooManyStreamsError(ProtocolError):
+    """
+    An attempt was made to open a stream that would lead to too many concurrent
+    streams.
+    """
+    pass
+
+
+class FlowControlError(ProtocolError):
+    """
+    An attempted action violates flow control constraints.
+    """
+    #: The error code corresponds to this kind of Protocol Error.
+    error_code = h2.errors.ErrorCodes.FLOW_CONTROL_ERROR
+
+
+class StreamIDTooLowError(ProtocolError):
+    """
+    An attempt was made to open a stream that had an ID that is lower than the
+    highest ID we have seen on this connection.
+    """
+    def __init__(self, stream_id, max_stream_id):
+        #: The ID of the stream that we attempted to open.
+        self.stream_id = stream_id
+
+        #: The current highest-seen stream ID.
+        self.max_stream_id = max_stream_id
+
+    def __str__(self):
+        return "StreamIDTooLowError: %d is lower than %d" % (
+            self.stream_id, self.max_stream_id
+        )
+
+
+class NoAvailableStreamIDError(ProtocolError):
+    """
+    There are no available stream IDs left to the connection. All stream IDs
+    have been exhausted.
+
+    .. versionadded:: 2.0.0
+    """
+    pass
+
+
+class NoSuchStreamError(ProtocolError):
+    """
+    A stream-specific action referenced a stream that does not exist.
+
+    .. versionchanged:: 2.0.0
+       Became a subclass of :class:`ProtocolError
+       <h2.exceptions.ProtocolError>`
+    """
+    def __init__(self, stream_id):
+        #: The stream ID corresponds to the non-existent stream.
+        self.stream_id = stream_id
+
+
+class StreamClosedError(NoSuchStreamError):
+    """
+    A more specific form of
+    :class:`NoSuchStreamError <h2.exceptions.NoSuchStreamError>`. Indicates
+    that the stream has since been closed, and that all state relating to that
+    stream has been removed.
+    """
+    def __init__(self, stream_id):
+        #: The stream ID corresponds to the nonexistent stream.
+        self.stream_id = stream_id
+
+        #: The relevant HTTP/2 error code.
+        self.error_code = h2.errors.ErrorCodes.STREAM_CLOSED
+
+        # Any events that internal code may need to fire. Not relevant to
+        # external users that may receive a StreamClosedError.
+        self._events = []
+
+
+class InvalidSettingsValueError(ProtocolError, ValueError):
+    """
+    An attempt was made to set an invalid Settings value.
+
+    .. versionadded:: 2.0.0
+    """
+    def __init__(self, msg, error_code):
+        super(InvalidSettingsValueError, self).__init__(msg)
+        self.error_code = error_code
+
+
+class InvalidBodyLengthError(ProtocolError):
+    """
+    The remote peer sent more or less data that the Content-Length header
+    indicated.
+
+    .. versionadded:: 2.0.0
+    """
+    def __init__(self, expected, actual):
+        self.expected_length = expected
+        self.actual_length = actual
+
+    def __str__(self):
+        return "InvalidBodyLengthError: Expected %d bytes, received %d" % (
+            self.expected_length, self.actual_length
+        )
+
+
+class UnsupportedFrameError(ProtocolError):
+    """
+    The remote peer sent a frame that is unsupported in this context.
+
+    .. versionadded:: 2.1.0
+
+    .. versionchanged:: 4.0.0
+       Removed deprecated KeyError parent class.
+    """
+    pass
+
+
+class RFC1122Error(H2Error):
+    """
+    Emitted when users attempt to do something that is literally allowed by the
+    relevant RFC, but is sufficiently ill-defined that it's unwise to allow
+    users to actually do it.
+
+    While there is some disagreement about whether or not we should be liberal
+    in what accept, it is a truth universally acknowledged that we should be
+    conservative in what emit.
+
+    .. versionadded:: 2.4.0
+    """
+    # shazow says I'm going to regret naming the exception this way. If that
+    # turns out to be true, TELL HIM NOTHING.
+    pass
+
+
+class DenialOfServiceError(ProtocolError):
+    """
+    Emitted when the remote peer exhibits a behaviour that is likely to be an
+    attempt to perform a Denial of Service attack on the implementation. This
+    is a form of ProtocolError that carries a different error code, and allows
+    more easy detection of this kind of behaviour.
+
+    .. versionadded:: 2.5.0
+    """
+    #: The error code corresponds to this kind of
+    #: :class:`ProtocolError <h2.exceptions.ProtocolError>`
+    error_code = h2.errors.ErrorCodes.ENHANCE_YOUR_CALM
diff --git a/llm/Lib/site-packages/h2/frame_buffer.py b/llm/Lib/site-packages/h2/frame_buffer.py
new file mode 100644
index 0000000000000000000000000000000000000000..785775eb563e25ed69664d622c86d71415e9afab
--- /dev/null
+++ b/llm/Lib/site-packages/h2/frame_buffer.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+"""
+h2/frame_buffer
+~~~~~~~~~~~~~~~
+
+A data structure that provides a way to iterate over a byte buffer in terms of
+frames.
+"""
+from hyperframe.exceptions import InvalidFrameError, InvalidDataError
+from hyperframe.frame import (
+    Frame, HeadersFrame, ContinuationFrame, PushPromiseFrame
+)
+
+from .exceptions import (
+    ProtocolError, FrameTooLargeError, FrameDataMissingError
+)
+
+# To avoid a DOS attack based on sending loads of continuation frames, we limit
+# the maximum number we're perpared to receive. In this case, we'll set the
+# limit to 64, which means the largest encoded header block we can receive by
+# default is 262144 bytes long, and the largest possible *at all* is 1073741760
+# bytes long.
+#
+# This value seems reasonable for now, but in future we may want to evaluate
+# making it configurable.
+CONTINUATION_BACKLOG = 64
+
+
+class FrameBuffer:
+    """
+    This is a data structure that expects to act as a buffer for HTTP/2 data
+    that allows iteraton in terms of H2 frames.
+    """
+    def __init__(self, server=False):
+        self.data = b''
+        self.max_frame_size = 0
+        self._preamble = b'PRI * HTTP/2.0\r\n\r\nSM\r\n\r\n' if server else b''
+        self._preamble_len = len(self._preamble)
+        self._headers_buffer = []
+
+    def add_data(self, data):
+        """
+        Add more data to the frame buffer.
+
+        :param data: A bytestring containing the byte buffer.
+        """
+        if self._preamble_len:
+            data_len = len(data)
+            of_which_preamble = min(self._preamble_len, data_len)
+
+            if self._preamble[:of_which_preamble] != data[:of_which_preamble]:
+                raise ProtocolError("Invalid HTTP/2 preamble.")
+
+            data = data[of_which_preamble:]
+            self._preamble_len -= of_which_preamble
+            self._preamble = self._preamble[of_which_preamble:]
+
+        self.data += data
+
+    def _validate_frame_length(self, length):
+        """
+        Confirm that the frame is an appropriate length.
+        """
+        if length > self.max_frame_size:
+            raise FrameTooLargeError(
+                "Received overlong frame: length %d, max %d" %
+                (length, self.max_frame_size)
+            )
+
+    def _update_header_buffer(self, f):
+        """
+        Updates the internal header buffer. Returns a frame that should replace
+        the current one. May throw exceptions if this frame is invalid.
+        """
+        # Check if we're in the middle of a headers block. If we are, this
+        # frame *must* be a CONTINUATION frame with the same stream ID as the
+        # leading HEADERS or PUSH_PROMISE frame. Anything else is a
+        # ProtocolError. If the frame *is* valid, append it to the header
+        # buffer.
+        if self._headers_buffer:
+            stream_id = self._headers_buffer[0].stream_id
+            valid_frame = (
+                f is not None and
+                isinstance(f, ContinuationFrame) and
+                f.stream_id == stream_id
+            )
+            if not valid_frame:
+                raise ProtocolError("Invalid frame during header block.")
+
+            # Append the frame to the buffer.
+            self._headers_buffer.append(f)
+            if len(self._headers_buffer) > CONTINUATION_BACKLOG:
+                raise ProtocolError("Too many continuation frames received.")
+
+            # If this is the end of the header block, then we want to build a
+            # mutant HEADERS frame that's massive. Use the original one we got,
+            # then set END_HEADERS and set its data appopriately. If it's not
+            # the end of the block, lose the current frame: we can't yield it.
+            if 'END_HEADERS' in f.flags:
+                f = self._headers_buffer[0]
+                f.flags.add('END_HEADERS')
+                f.data = b''.join(x.data for x in self._headers_buffer)
+                self._headers_buffer = []
+            else:
+                f = None
+        elif (isinstance(f, (HeadersFrame, PushPromiseFrame)) and
+                'END_HEADERS' not in f.flags):
+            # This is the start of a headers block! Save the frame off and then
+            # act like we didn't receive one.
+            self._headers_buffer.append(f)
+            f = None
+
+        return f
+
+    # The methods below support the iterator protocol.
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        # First, check that we have enough data to successfully parse the
+        # next frame header. If not, bail. Otherwise, parse it.
+        if len(self.data) < 9:
+            raise StopIteration()
+
+        try:
+            f, length = Frame.parse_frame_header(self.data[:9])
+        except (InvalidDataError, InvalidFrameError) as e:  # pragma: no cover
+            raise ProtocolError(
+                "Received frame with invalid header: %s" % str(e)
+            )
+
+        # Next, check that we have enough length to parse the frame body. If
+        # not, bail, leaving the frame header data in the buffer for next time.
+        if len(self.data) < length + 9:
+            raise StopIteration()
+
+        # Confirm the frame has an appropriate length.
+        self._validate_frame_length(length)
+
+        # Try to parse the frame body
+        try:
+            f.parse_body(memoryview(self.data[9:9+length]))
+        except InvalidDataError:
+            raise ProtocolError("Received frame with non-compliant data")
+        except InvalidFrameError:
+            raise FrameDataMissingError("Frame data missing or invalid")
+
+        # At this point, as we know we'll use or discard the entire frame, we
+        # can update the data.
+        self.data = self.data[9+length:]
+
+        # Pass the frame through the header buffer.
+        f = self._update_header_buffer(f)
+
+        # If we got a frame we didn't understand or shouldn't yield, rather
+        # than return None it'd be better if we just tried to get the next
+        # frame in the sequence instead. Recurse back into ourselves to do
+        # that. This is safe because the amount of work we have to do here is
+        # strictly bounded by the length of the buffer.
+        return f if f is not None else self.__next__()
diff --git a/llm/Lib/site-packages/h2/settings.py b/llm/Lib/site-packages/h2/settings.py
new file mode 100644
index 0000000000000000000000000000000000000000..969a162eb6e5ff300bde66aa9075c84335957c90
--- /dev/null
+++ b/llm/Lib/site-packages/h2/settings.py
@@ -0,0 +1,334 @@
+# -*- coding: utf-8 -*-
+"""
+h2/settings
+~~~~~~~~~~~
+
+This module contains a HTTP/2 settings object. This object provides a simple
+API for manipulating HTTP/2 settings, keeping track of both the current active
+state of the settings and the unacknowledged future values of the settings.
+"""
+import collections
+from collections.abc import MutableMapping
+import enum
+
+from hyperframe.frame import SettingsFrame
+
+from h2.errors import ErrorCodes
+from h2.exceptions import InvalidSettingsValueError
+
+
+class SettingCodes(enum.IntEnum):
+    """
+    All known HTTP/2 setting codes.
+
+    .. versionadded:: 2.6.0
+    """
+
+    #: Allows the sender to inform the remote endpoint of the maximum size of
+    #: the header compression table used to decode header blocks, in octets.
+    HEADER_TABLE_SIZE = SettingsFrame.HEADER_TABLE_SIZE
+
+    #: This setting can be used to disable server push. To disable server push
+    #: on a client, set this to 0.
+    ENABLE_PUSH = SettingsFrame.ENABLE_PUSH
+
+    #: Indicates the maximum number of concurrent streams that the sender will
+    #: allow.
+    MAX_CONCURRENT_STREAMS = SettingsFrame.MAX_CONCURRENT_STREAMS
+
+    #: Indicates the sender's initial window size (in octets) for stream-level
+    #: flow control.
+    INITIAL_WINDOW_SIZE = SettingsFrame.INITIAL_WINDOW_SIZE
+
+    #: Indicates the size of the largest frame payload that the sender is
+    #: willing to receive, in octets.
+    MAX_FRAME_SIZE = SettingsFrame.MAX_FRAME_SIZE
+
+    #: This advisory setting informs a peer of the maximum size of header list
+    #: that the sender is prepared to accept, in octets.  The value is based on
+    #: the uncompressed size of header fields, including the length of the name
+    #: and value in octets plus an overhead of 32 octets for each header field.
+    MAX_HEADER_LIST_SIZE = SettingsFrame.MAX_HEADER_LIST_SIZE
+
+    #: This setting can be used to enable the connect protocol. To enable on a
+    #: client set this to 1.
+    ENABLE_CONNECT_PROTOCOL = SettingsFrame.ENABLE_CONNECT_PROTOCOL
+
+
+def _setting_code_from_int(code):
+    """
+    Given an integer setting code, returns either one of :class:`SettingCodes
+    <h2.settings.SettingCodes>` or, if not present in the known set of codes,
+    returns the integer directly.
+    """
+    try:
+        return SettingCodes(code)
+    except ValueError:
+        return code
+
+
+class ChangedSetting:
+
+    def __init__(self, setting, original_value, new_value):
+        #: The setting code given. Either one of :class:`SettingCodes
+        #: <h2.settings.SettingCodes>` or ``int``
+        #:
+        #: .. versionchanged:: 2.6.0
+        self.setting = setting
+
+        #: The original value before being changed.
+        self.original_value = original_value
+
+        #: The new value after being changed.
+        self.new_value = new_value
+
+    def __repr__(self):
+        return (
+            "ChangedSetting(setting=%s, original_value=%s, "
+            "new_value=%s)"
+        ) % (
+            self.setting,
+            self.original_value,
+            self.new_value
+        )
+
+
+class Settings(MutableMapping):
+    """
+    An object that encapsulates HTTP/2 settings state.
+
+    HTTP/2 Settings are a complex beast. Each party, remote and local, has its
+    own settings and a view of the other party's settings. When a settings
+    frame is emitted by a peer it cannot assume that the new settings values
+    are in place until the remote peer acknowledges the setting. In principle,
+    multiple settings changes can be "in flight" at the same time, all with
+    different values.
+
+    This object encapsulates this mess. It provides a dict-like interface to
+    settings, which return the *current* values of the settings in question.
+    Additionally, it keeps track of the stack of proposed values: each time an
+    acknowledgement is sent/received, it updates the current values with the
+    stack of proposed values. On top of all that, it validates the values to
+    make sure they're allowed, and raises :class:`InvalidSettingsValueError
+    <h2.exceptions.InvalidSettingsValueError>` if they are not.
+
+    Finally, this object understands what the default values of the HTTP/2
+    settings are, and sets those defaults appropriately.
+
+    .. versionchanged:: 2.2.0
+       Added the ``initial_values`` parameter.
+
+    .. versionchanged:: 2.5.0
+       Added the ``max_header_list_size`` property.
+
+    :param client: (optional) Whether these settings should be defaulted for a
+        client implementation or a server implementation. Defaults to ``True``.
+    :type client: ``bool``
+    :param initial_values: (optional) Any initial values the user would like
+        set, rather than RFC 7540's defaults.
+    :type initial_vales: ``MutableMapping``
+    """
+    def __init__(self, client=True, initial_values=None):
+        # Backing object for the settings. This is a dictionary of
+        # (setting: [list of values]), where the first value in the list is the
+        # current value of the setting. Strictly this doesn't use lists but
+        # instead uses collections.deque to avoid repeated memory allocations.
+        #
+        # This contains the default values for HTTP/2.
+        self._settings = {
+            SettingCodes.HEADER_TABLE_SIZE: collections.deque([4096]),
+            SettingCodes.ENABLE_PUSH: collections.deque([int(client)]),
+            SettingCodes.INITIAL_WINDOW_SIZE: collections.deque([65535]),
+            SettingCodes.MAX_FRAME_SIZE: collections.deque([16384]),
+            SettingCodes.ENABLE_CONNECT_PROTOCOL: collections.deque([0]),
+        }
+        if initial_values is not None:
+            for key, value in initial_values.items():
+                invalid = _validate_setting(key, value)
+                if invalid:
+                    raise InvalidSettingsValueError(
+                        "Setting %d has invalid value %d" % (key, value),
+                        error_code=invalid
+                    )
+                self._settings[key] = collections.deque([value])
+
+    def acknowledge(self):
+        """
+        The settings have been acknowledged, either by the user (remote
+        settings) or by the remote peer (local settings).
+
+        :returns: A dict of {setting: ChangedSetting} that were applied.
+        """
+        changed_settings = {}
+
+        # If there is more than one setting in the list, we have a setting
+        # value outstanding. Update them.
+        for k, v in self._settings.items():
+            if len(v) > 1:
+                old_setting = v.popleft()
+                new_setting = v[0]
+                changed_settings[k] = ChangedSetting(
+                    k, old_setting, new_setting
+                )
+
+        return changed_settings
+
+    # Provide easy-access to well known settings.
+    @property
+    def header_table_size(self):
+        """
+        The current value of the :data:`HEADER_TABLE_SIZE
+        <h2.settings.SettingCodes.HEADER_TABLE_SIZE>` setting.
+        """
+        return self[SettingCodes.HEADER_TABLE_SIZE]
+
+    @header_table_size.setter
+    def header_table_size(self, value):
+        self[SettingCodes.HEADER_TABLE_SIZE] = value
+
+    @property
+    def enable_push(self):
+        """
+        The current value of the :data:`ENABLE_PUSH
+        <h2.settings.SettingCodes.ENABLE_PUSH>` setting.
+        """
+        return self[SettingCodes.ENABLE_PUSH]
+
+    @enable_push.setter
+    def enable_push(self, value):
+        self[SettingCodes.ENABLE_PUSH] = value
+
+    @property
+    def initial_window_size(self):
+        """
+        The current value of the :data:`INITIAL_WINDOW_SIZE
+        <h2.settings.SettingCodes.INITIAL_WINDOW_SIZE>` setting.
+        """
+        return self[SettingCodes.INITIAL_WINDOW_SIZE]
+
+    @initial_window_size.setter
+    def initial_window_size(self, value):
+        self[SettingCodes.INITIAL_WINDOW_SIZE] = value
+
+    @property
+    def max_frame_size(self):
+        """
+        The current value of the :data:`MAX_FRAME_SIZE
+        <h2.settings.SettingCodes.MAX_FRAME_SIZE>` setting.
+        """
+        return self[SettingCodes.MAX_FRAME_SIZE]
+
+    @max_frame_size.setter
+    def max_frame_size(self, value):
+        self[SettingCodes.MAX_FRAME_SIZE] = value
+
+    @property
+    def max_concurrent_streams(self):
+        """
+        The current value of the :data:`MAX_CONCURRENT_STREAMS
+        <h2.settings.SettingCodes.MAX_CONCURRENT_STREAMS>` setting.
+        """
+        return self.get(SettingCodes.MAX_CONCURRENT_STREAMS, 2**32+1)
+
+    @max_concurrent_streams.setter
+    def max_concurrent_streams(self, value):
+        self[SettingCodes.MAX_CONCURRENT_STREAMS] = value
+
+    @property
+    def max_header_list_size(self):
+        """
+        The current value of the :data:`MAX_HEADER_LIST_SIZE
+        <h2.settings.SettingCodes.MAX_HEADER_LIST_SIZE>` setting. If not set,
+        returns ``None``, which means unlimited.
+
+        .. versionadded:: 2.5.0
+        """
+        return self.get(SettingCodes.MAX_HEADER_LIST_SIZE, None)
+
+    @max_header_list_size.setter
+    def max_header_list_size(self, value):
+        self[SettingCodes.MAX_HEADER_LIST_SIZE] = value
+
+    @property
+    def enable_connect_protocol(self):
+        """
+        The current value of the :data:`ENABLE_CONNECT_PROTOCOL
+        <h2.settings.SettingCodes.ENABLE_CONNECT_PROTOCOL>` setting.
+        """
+        return self[SettingCodes.ENABLE_CONNECT_PROTOCOL]
+
+    @enable_connect_protocol.setter
+    def enable_connect_protocol(self, value):
+        self[SettingCodes.ENABLE_CONNECT_PROTOCOL] = value
+
+    # Implement the MutableMapping API.
+    def __getitem__(self, key):
+        val = self._settings[key][0]
+
+        # Things that were created when a setting was received should stay
+        # KeyError'd.
+        if val is None:
+            raise KeyError
+
+        return val
+
+    def __setitem__(self, key, value):
+        invalid = _validate_setting(key, value)
+        if invalid:
+            raise InvalidSettingsValueError(
+                "Setting %d has invalid value %d" % (key, value),
+                error_code=invalid
+            )
+
+        try:
+            items = self._settings[key]
+        except KeyError:
+            items = collections.deque([None])
+            self._settings[key] = items
+
+        items.append(value)
+
+    def __delitem__(self, key):
+        del self._settings[key]
+
+    def __iter__(self):
+        return self._settings.__iter__()
+
+    def __len__(self):
+        return len(self._settings)
+
+    def __eq__(self, other):
+        if isinstance(other, Settings):
+            return self._settings == other._settings
+        else:
+            return NotImplemented
+
+    def __ne__(self, other):
+        if isinstance(other, Settings):
+            return not self == other
+        else:
+            return NotImplemented
+
+
+def _validate_setting(setting, value):  # noqa: C901
+    """
+    Confirms that a specific setting has a well-formed value. If the setting is
+    invalid, returns an error code. Otherwise, returns 0 (NO_ERROR).
+    """
+    if setting == SettingCodes.ENABLE_PUSH:
+        if value not in (0, 1):
+            return ErrorCodes.PROTOCOL_ERROR
+    elif setting == SettingCodes.INITIAL_WINDOW_SIZE:
+        if not 0 <= value <= 2147483647:  # 2^31 - 1
+            return ErrorCodes.FLOW_CONTROL_ERROR
+    elif setting == SettingCodes.MAX_FRAME_SIZE:
+        if not 16384 <= value <= 16777215:  # 2^14 and 2^24 - 1
+            return ErrorCodes.PROTOCOL_ERROR
+    elif setting == SettingCodes.MAX_HEADER_LIST_SIZE:
+        if value < 0:
+            return ErrorCodes.PROTOCOL_ERROR
+    elif setting == SettingCodes.ENABLE_CONNECT_PROTOCOL:
+        if value not in (0, 1):
+            return ErrorCodes.PROTOCOL_ERROR
+
+    return 0
diff --git a/llm/Lib/site-packages/h2/stream.py b/llm/Lib/site-packages/h2/stream.py
new file mode 100644
index 0000000000000000000000000000000000000000..817636f8eddd0b6a98e9f6bb5c6449ad59287c51
--- /dev/null
+++ b/llm/Lib/site-packages/h2/stream.py
@@ -0,0 +1,1371 @@
+# -*- coding: utf-8 -*-
+"""
+h2/stream
+~~~~~~~~~
+
+An implementation of a HTTP/2 stream.
+"""
+from enum import Enum, IntEnum
+from hpack import HeaderTuple
+from hyperframe.frame import (
+    HeadersFrame, ContinuationFrame, DataFrame, WindowUpdateFrame,
+    RstStreamFrame, PushPromiseFrame, AltSvcFrame
+)
+
+from .errors import ErrorCodes, _error_code_from_int
+from .events import (
+    RequestReceived, ResponseReceived, DataReceived, WindowUpdated,
+    StreamEnded, PushedStreamReceived, StreamReset, TrailersReceived,
+    InformationalResponseReceived, AlternativeServiceAvailable,
+    _ResponseSent, _RequestSent, _TrailersSent, _PushedRequestSent
+)
+from .exceptions import (
+    ProtocolError, StreamClosedError, InvalidBodyLengthError, FlowControlError
+)
+from .utilities import (
+    guard_increment_window, is_informational_response, authority_from_headers,
+    validate_headers, validate_outbound_headers, normalize_outbound_headers,
+    HeaderValidationFlags, extract_method_header, normalize_inbound_headers
+)
+from .windows import WindowManager
+
+
+class StreamState(IntEnum):
+    IDLE = 0
+    RESERVED_REMOTE = 1
+    RESERVED_LOCAL = 2
+    OPEN = 3
+    HALF_CLOSED_REMOTE = 4
+    HALF_CLOSED_LOCAL = 5
+    CLOSED = 6
+
+
+class StreamInputs(Enum):
+    SEND_HEADERS = 0
+    SEND_PUSH_PROMISE = 1
+    SEND_RST_STREAM = 2
+    SEND_DATA = 3
+    SEND_WINDOW_UPDATE = 4
+    SEND_END_STREAM = 5
+    RECV_HEADERS = 6
+    RECV_PUSH_PROMISE = 7
+    RECV_RST_STREAM = 8
+    RECV_DATA = 9
+    RECV_WINDOW_UPDATE = 10
+    RECV_END_STREAM = 11
+    RECV_CONTINUATION = 12  # Added in 2.0.0
+    SEND_INFORMATIONAL_HEADERS = 13  # Added in 2.2.0
+    RECV_INFORMATIONAL_HEADERS = 14  # Added in 2.2.0
+    SEND_ALTERNATIVE_SERVICE = 15  # Added in 2.3.0
+    RECV_ALTERNATIVE_SERVICE = 16  # Added in 2.3.0
+    UPGRADE_CLIENT = 17  # Added 2.3.0
+    UPGRADE_SERVER = 18  # Added 2.3.0
+
+
+class StreamClosedBy(Enum):
+    SEND_END_STREAM = 0
+    RECV_END_STREAM = 1
+    SEND_RST_STREAM = 2
+    RECV_RST_STREAM = 3
+
+
+# This array is initialized once, and is indexed by the stream states above.
+# It indicates whether a stream in the given state is open. The reason we do
+# this is that we potentially check whether a stream in a given state is open
+# quite frequently: given that we check so often, we should do so in the
+# fastest and most performant way possible.
+STREAM_OPEN = [False for _ in range(0, len(StreamState))]
+STREAM_OPEN[StreamState.OPEN] = True
+STREAM_OPEN[StreamState.HALF_CLOSED_LOCAL] = True
+STREAM_OPEN[StreamState.HALF_CLOSED_REMOTE] = True
+
+
+class H2StreamStateMachine:
+    """
+    A single HTTP/2 stream state machine.
+
+    This stream object implements basically the state machine described in
+    RFC 7540 section 5.1.
+
+    :param stream_id: The stream ID of this stream. This is stored primarily
+        for logging purposes.
+    """
+    def __init__(self, stream_id):
+        self.state = StreamState.IDLE
+        self.stream_id = stream_id
+
+        #: Whether this peer is the client side of this stream.
+        self.client = None
+
+        # Whether trailers have been sent/received on this stream or not.
+        self.headers_sent = None
+        self.trailers_sent = None
+        self.headers_received = None
+        self.trailers_received = None
+
+        # How the stream was closed. One of StreamClosedBy.
+        self.stream_closed_by = None
+
+    def process_input(self, input_):
+        """
+        Process a specific input in the state machine.
+        """
+        if not isinstance(input_, StreamInputs):
+            raise ValueError("Input must be an instance of StreamInputs")
+
+        try:
+            func, target_state = _transitions[(self.state, input_)]
+        except KeyError:
+            old_state = self.state
+            self.state = StreamState.CLOSED
+            raise ProtocolError(
+                "Invalid input %s in state %s" % (input_, old_state)
+            )
+        else:
+            previous_state = self.state
+            self.state = target_state
+            if func is not None:
+                try:
+                    return func(self, previous_state)
+                except ProtocolError:
+                    self.state = StreamState.CLOSED
+                    raise
+                except AssertionError as e:  # pragma: no cover
+                    self.state = StreamState.CLOSED
+                    raise ProtocolError(e)
+
+            return []
+
+    def request_sent(self, previous_state):
+        """
+        Fires when a request is sent.
+        """
+        self.client = True
+        self.headers_sent = True
+        event = _RequestSent()
+
+        return [event]
+
+    def response_sent(self, previous_state):
+        """
+        Fires when something that should be a response is sent. This 'response'
+        may actually be trailers.
+        """
+        if not self.headers_sent:
+            if self.client is True or self.client is None:
+                raise ProtocolError("Client cannot send responses.")
+            self.headers_sent = True
+            event = _ResponseSent()
+        else:
+            assert not self.trailers_sent
+            self.trailers_sent = True
+            event = _TrailersSent()
+
+        return [event]
+
+    def request_received(self, previous_state):
+        """
+        Fires when a request is received.
+        """
+        assert not self.headers_received
+        assert not self.trailers_received
+
+        self.client = False
+        self.headers_received = True
+        event = RequestReceived()
+
+        event.stream_id = self.stream_id
+        return [event]
+
+    def response_received(self, previous_state):
+        """
+        Fires when a response is received. Also disambiguates between responses
+        and trailers.
+        """
+        if not self.headers_received:
+            assert self.client is True
+            self.headers_received = True
+            event = ResponseReceived()
+        else:
+            assert not self.trailers_received
+            self.trailers_received = True
+            event = TrailersReceived()
+
+        event.stream_id = self.stream_id
+        return [event]
+
+    def data_received(self, previous_state):
+        """
+        Fires when data is received.
+        """
+        if not self.headers_received:
+            raise ProtocolError("cannot receive data before headers")
+        event = DataReceived()
+        event.stream_id = self.stream_id
+        return [event]
+
+    def window_updated(self, previous_state):
+        """
+        Fires when a window update frame is received.
+        """
+        event = WindowUpdated()
+        event.stream_id = self.stream_id
+        return [event]
+
+    def stream_half_closed(self, previous_state):
+        """
+        Fires when an END_STREAM flag is received in the OPEN state,
+        transitioning this stream to a HALF_CLOSED_REMOTE state.
+        """
+        event = StreamEnded()
+        event.stream_id = self.stream_id
+        return [event]
+
+    def stream_ended(self, previous_state):
+        """
+        Fires when a stream is cleanly ended.
+        """
+        self.stream_closed_by = StreamClosedBy.RECV_END_STREAM
+        event = StreamEnded()
+        event.stream_id = self.stream_id
+        return [event]
+
+    def stream_reset(self, previous_state):
+        """
+        Fired when a stream is forcefully reset.
+        """
+        self.stream_closed_by = StreamClosedBy.RECV_RST_STREAM
+        event = StreamReset()
+        event.stream_id = self.stream_id
+        return [event]
+
+    def send_new_pushed_stream(self, previous_state):
+        """
+        Fires on the newly pushed stream, when pushed by the local peer.
+
+        No event here, but definitionally this peer must be a server.
+        """
+        assert self.client is None
+        self.client = False
+        self.headers_received = True
+        return []
+
+    def recv_new_pushed_stream(self, previous_state):
+        """
+        Fires on the newly pushed stream, when pushed by the remote peer.
+
+        No event here, but definitionally this peer must be a client.
+        """
+        assert self.client is None
+        self.client = True
+        self.headers_sent = True
+        return []
+
+    def send_push_promise(self, previous_state):
+        """
+        Fires on the already-existing stream when a PUSH_PROMISE frame is sent.
+        We may only send PUSH_PROMISE frames if we're a server.
+        """
+        if self.client is True:
+            raise ProtocolError("Cannot push streams from client peers.")
+
+        event = _PushedRequestSent()
+        return [event]
+
+    def recv_push_promise(self, previous_state):
+        """
+        Fires on the already-existing stream when a PUSH_PROMISE frame is
+        received. We may only receive PUSH_PROMISE frames if we're a client.
+
+        Fires a PushedStreamReceived event.
+        """
+        if not self.client:
+            if self.client is None:  # pragma: no cover
+                msg = "Idle streams cannot receive pushes"
+            else:  # pragma: no cover
+                msg = "Cannot receive pushed streams as a server"
+            raise ProtocolError(msg)
+
+        event = PushedStreamReceived()
+        event.parent_stream_id = self.stream_id
+        return [event]
+
+    def send_end_stream(self, previous_state):
+        """
+        Called when an attempt is made to send END_STREAM in the
+        HALF_CLOSED_REMOTE state.
+        """
+        self.stream_closed_by = StreamClosedBy.SEND_END_STREAM
+
+    def send_reset_stream(self, previous_state):
+        """
+        Called when an attempt is made to send RST_STREAM in a non-closed
+        stream state.
+        """
+        self.stream_closed_by = StreamClosedBy.SEND_RST_STREAM
+
+    def reset_stream_on_error(self, previous_state):
+        """
+        Called when we need to forcefully emit another RST_STREAM frame on
+        behalf of the state machine.
+
+        If this is the first time we've done this, we should also hang an event
+        off the StreamClosedError so that the user can be informed. We know
+        it's the first time we've done this if the stream is currently in a
+        state other than CLOSED.
+        """
+        self.stream_closed_by = StreamClosedBy.SEND_RST_STREAM
+
+        error = StreamClosedError(self.stream_id)
+
+        event = StreamReset()
+        event.stream_id = self.stream_id
+        event.error_code = ErrorCodes.STREAM_CLOSED
+        event.remote_reset = False
+        error._events = [event]
+        raise error
+
+    def recv_on_closed_stream(self, previous_state):
+        """
+        Called when an unexpected frame is received on an already-closed
+        stream.
+
+        An endpoint that receives an unexpected frame should treat it as
+        a stream error or connection error with type STREAM_CLOSED, depending
+        on the specific frame. The error handling is done at a higher level:
+        this just raises the appropriate error.
+        """
+        raise StreamClosedError(self.stream_id)
+
+    def send_on_closed_stream(self, previous_state):
+        """
+        Called when an attempt is made to send data on an already-closed
+        stream.
+
+        This essentially overrides the standard logic by throwing a
+        more-specific error: StreamClosedError. This is a ProtocolError, so it
+        matches the standard API of the state machine, but provides more detail
+        to the user.
+        """
+        raise StreamClosedError(self.stream_id)
+
+    def recv_push_on_closed_stream(self, previous_state):
+        """
+        Called when a PUSH_PROMISE frame is received on a full stop
+        stream.
+
+        If the stream was closed by us sending a RST_STREAM frame, then we
+        presume that the PUSH_PROMISE was in flight when we reset the parent
+        stream. Rathen than accept the new stream, we just reset it.
+        Otherwise, we should call this a PROTOCOL_ERROR: pushing a stream on a
+        naturally closed stream is a real problem because it creates a brand
+        new stream that the remote peer now believes exists.
+        """
+        assert self.stream_closed_by is not None
+
+        if self.stream_closed_by == StreamClosedBy.SEND_RST_STREAM:
+            raise StreamClosedError(self.stream_id)
+        else:
+            raise ProtocolError("Attempted to push on closed stream.")
+
+    def send_push_on_closed_stream(self, previous_state):
+        """
+        Called when an attempt is made to push on an already-closed stream.
+
+        This essentially overrides the standard logic by providing a more
+        useful error message. It's necessary because simply indicating that the
+        stream is closed is not enough: there is now a new stream that is not
+        allowed to be there. The only recourse is to tear the whole connection
+        down.
+        """
+        raise ProtocolError("Attempted to push on closed stream.")
+
+    def send_informational_response(self, previous_state):
+        """
+        Called when an informational header block is sent (that is, a block
+        where the :status header has a 1XX value).
+
+        Only enforces that these are sent *before* final headers are sent.
+        """
+        if self.headers_sent:
+            raise ProtocolError("Information response after final response")
+
+        event = _ResponseSent()
+        return [event]
+
+    def recv_informational_response(self, previous_state):
+        """
+        Called when an informational header block is received (that is, a block
+        where the :status header has a 1XX value).
+        """
+        if self.headers_received:
+            raise ProtocolError("Informational response after final response")
+
+        event = InformationalResponseReceived()
+        event.stream_id = self.stream_id
+        return [event]
+
+    def recv_alt_svc(self, previous_state):
+        """
+        Called when receiving an ALTSVC frame.
+
+        RFC 7838 allows us to receive ALTSVC frames at any stream state, which
+        is really absurdly overzealous. For that reason, we want to limit the
+        states in which we can actually receive it. It's really only sensible
+        to receive it after we've sent our own headers and before the server
+        has sent its header block: the server can't guarantee that we have any
+        state around after it completes its header block, and the server
+        doesn't know what origin we're talking about before we've sent ours.
+
+        For that reason, this function applies a few extra checks on both state
+        and some of the little state variables we keep around. If those suggest
+        an unreasonable situation for the ALTSVC frame to have been sent in,
+        we quietly ignore it (as RFC 7838 suggests).
+
+        This function is also *not* always called by the state machine. In some
+        states (IDLE, RESERVED_LOCAL, CLOSED) we don't bother to call it,
+        because we know the frame cannot be valid in that state (IDLE because
+        the server cannot know what origin the stream applies to, CLOSED
+        because the server cannot assume we still have state around,
+        RESERVED_LOCAL because by definition if we're in the RESERVED_LOCAL
+        state then *we* are the server).
+        """
+        # Servers can't receive ALTSVC frames, but RFC 7838 tells us to ignore
+        # them.
+        if self.client is False:
+            return []
+
+        # If we've received the response headers from the server they can't
+        # guarantee we still have any state around. Other implementations
+        # (like nghttp2) ignore ALTSVC in this state, so we will too.
+        if self.headers_received:
+            return []
+
+        # Otherwise, this is a sensible enough frame to have received. Return
+        # the event and let it get populated.
+        return [AlternativeServiceAvailable()]
+
+    def send_alt_svc(self, previous_state):
+        """
+        Called when sending an ALTSVC frame on this stream.
+
+        For consistency with the restrictions we apply on receiving ALTSVC
+        frames in ``recv_alt_svc``, we want to restrict when users can send
+        ALTSVC frames to the situations when we ourselves would accept them.
+
+        That means: when we are a server, when we have received the request
+        headers, and when we have not yet sent our own response headers.
+        """
+        # We should not send ALTSVC after we've sent response headers, as the
+        # client may have disposed of its state.
+        if self.headers_sent:
+            raise ProtocolError(
+                "Cannot send ALTSVC after sending response headers."
+            )
+
+        return
+
+
+# STATE MACHINE
+#
+# The stream state machine is defined here to avoid the need to allocate it
+# repeatedly for each stream. It cannot be defined in the stream class because
+# it needs to be able to reference the callbacks defined on the class, but
+# because Python's scoping rules are weird the class object is not actually in
+# scope during the body of the class object.
+#
+# For the sake of clarity, we reproduce the RFC 7540 state machine here:
+#
+#                          +--------+
+#                  send PP |        | recv PP
+#                 ,--------|  idle  |--------.
+#                /         |        |         \
+#               v          +--------+          v
+#        +----------+          |           +----------+
+#        |          |          | send H /  |          |
+# ,------| reserved |          | recv H    | reserved |------.
+# |      | (local)  |          |           | (remote) |      |
+# |      +----------+          v           +----------+      |
+# |          |             +--------+             |          |
+# |          |     recv ES |        | send ES     |          |
+# |   send H |     ,-------|  open  |-------.     | recv H   |
+# |          |    /        |        |        \    |          |
+# |          v   v         +--------+         v   v          |
+# |      +----------+          |           +----------+      |
+# |      |   half   |          |           |   half   |      |
+# |      |  closed  |          | send R /  |  closed  |      |
+# |      | (remote) |          | recv R    | (local)  |      |
+# |      +----------+          |           +----------+      |
+# |           |                |                 |           |
+# |           | send ES /      |       recv ES / |           |
+# |           | send R /       v        send R / |           |
+# |           | recv R     +--------+   recv R   |           |
+# | send R /  `----------->|        |<-----------'  send R / |
+# | recv R                 | closed |               recv R   |
+# `----------------------->|        |<----------------------'
+#                          +--------+
+#
+#    send:   endpoint sends this frame
+#    recv:   endpoint receives this frame
+#
+#    H:  HEADERS frame (with implied CONTINUATIONs)
+#    PP: PUSH_PROMISE frame (with implied CONTINUATIONs)
+#    ES: END_STREAM flag
+#    R:  RST_STREAM frame
+#
+# For the purposes of this state machine we treat HEADERS and their
+# associated CONTINUATION frames as a single jumbo frame. The protocol
+# allows/requires this by preventing other frames from being interleved in
+# between HEADERS/CONTINUATION frames. However, if a CONTINUATION frame is
+# received without a prior HEADERS frame, it *will* be passed to this state
+# machine. The state machine should always reject that frame, either as an
+# invalid transition or because the stream is closed.
+#
+# There is a confusing relationship around PUSH_PROMISE frames. The state
+# machine above considers them to be frames belonging to the new stream,
+# which is *somewhat* true. However, they are sent with the stream ID of
+# their related stream, and are only sendable in some cases.
+# For this reason, our state machine implementation below allows for
+# PUSH_PROMISE frames both in the IDLE state (as in the diagram), but also
+# in the OPEN, HALF_CLOSED_LOCAL, and HALF_CLOSED_REMOTE states.
+# Essentially, for h2, PUSH_PROMISE frames are effectively sent on
+# two streams.
+#
+# The _transitions dictionary contains a mapping of tuples of
+# (state, input) to tuples of (side_effect_function, end_state). This
+# map contains all allowed transitions: anything not in this map is
+# invalid and immediately causes a transition to ``closed``.
+_transitions = {
+    # State: idle
+    (StreamState.IDLE, StreamInputs.SEND_HEADERS):
+        (H2StreamStateMachine.request_sent, StreamState.OPEN),
+    (StreamState.IDLE, StreamInputs.RECV_HEADERS):
+        (H2StreamStateMachine.request_received, StreamState.OPEN),
+    (StreamState.IDLE, StreamInputs.RECV_DATA):
+        (H2StreamStateMachine.reset_stream_on_error, StreamState.CLOSED),
+    (StreamState.IDLE, StreamInputs.SEND_PUSH_PROMISE):
+        (H2StreamStateMachine.send_new_pushed_stream,
+            StreamState.RESERVED_LOCAL),
+    (StreamState.IDLE, StreamInputs.RECV_PUSH_PROMISE):
+        (H2StreamStateMachine.recv_new_pushed_stream,
+            StreamState.RESERVED_REMOTE),
+    (StreamState.IDLE, StreamInputs.RECV_ALTERNATIVE_SERVICE):
+        (None, StreamState.IDLE),
+    (StreamState.IDLE, StreamInputs.UPGRADE_CLIENT):
+        (H2StreamStateMachine.request_sent, StreamState.HALF_CLOSED_LOCAL),
+    (StreamState.IDLE, StreamInputs.UPGRADE_SERVER):
+        (H2StreamStateMachine.request_received,
+            StreamState.HALF_CLOSED_REMOTE),
+
+    # State: reserved local
+    (StreamState.RESERVED_LOCAL, StreamInputs.SEND_HEADERS):
+        (H2StreamStateMachine.response_sent, StreamState.HALF_CLOSED_REMOTE),
+    (StreamState.RESERVED_LOCAL, StreamInputs.RECV_DATA):
+        (H2StreamStateMachine.reset_stream_on_error, StreamState.CLOSED),
+    (StreamState.RESERVED_LOCAL, StreamInputs.SEND_WINDOW_UPDATE):
+        (None, StreamState.RESERVED_LOCAL),
+    (StreamState.RESERVED_LOCAL, StreamInputs.RECV_WINDOW_UPDATE):
+        (H2StreamStateMachine.window_updated, StreamState.RESERVED_LOCAL),
+    (StreamState.RESERVED_LOCAL, StreamInputs.SEND_RST_STREAM):
+        (H2StreamStateMachine.send_reset_stream, StreamState.CLOSED),
+    (StreamState.RESERVED_LOCAL, StreamInputs.RECV_RST_STREAM):
+        (H2StreamStateMachine.stream_reset, StreamState.CLOSED),
+    (StreamState.RESERVED_LOCAL, StreamInputs.SEND_ALTERNATIVE_SERVICE):
+        (H2StreamStateMachine.send_alt_svc, StreamState.RESERVED_LOCAL),
+    (StreamState.RESERVED_LOCAL, StreamInputs.RECV_ALTERNATIVE_SERVICE):
+        (None, StreamState.RESERVED_LOCAL),
+
+    # State: reserved remote
+    (StreamState.RESERVED_REMOTE, StreamInputs.RECV_HEADERS):
+        (H2StreamStateMachine.response_received,
+            StreamState.HALF_CLOSED_LOCAL),
+    (StreamState.RESERVED_REMOTE, StreamInputs.RECV_DATA):
+        (H2StreamStateMachine.reset_stream_on_error, StreamState.CLOSED),
+    (StreamState.RESERVED_REMOTE, StreamInputs.SEND_WINDOW_UPDATE):
+        (None, StreamState.RESERVED_REMOTE),
+    (StreamState.RESERVED_REMOTE, StreamInputs.RECV_WINDOW_UPDATE):
+        (H2StreamStateMachine.window_updated, StreamState.RESERVED_REMOTE),
+    (StreamState.RESERVED_REMOTE, StreamInputs.SEND_RST_STREAM):
+        (H2StreamStateMachine.send_reset_stream, StreamState.CLOSED),
+    (StreamState.RESERVED_REMOTE, StreamInputs.RECV_RST_STREAM):
+        (H2StreamStateMachine.stream_reset, StreamState.CLOSED),
+    (StreamState.RESERVED_REMOTE, StreamInputs.RECV_ALTERNATIVE_SERVICE):
+        (H2StreamStateMachine.recv_alt_svc, StreamState.RESERVED_REMOTE),
+
+    # State: open
+    (StreamState.OPEN, StreamInputs.SEND_HEADERS):
+        (H2StreamStateMachine.response_sent, StreamState.OPEN),
+    (StreamState.OPEN, StreamInputs.RECV_HEADERS):
+        (H2StreamStateMachine.response_received, StreamState.OPEN),
+    (StreamState.OPEN, StreamInputs.SEND_DATA):
+        (None, StreamState.OPEN),
+    (StreamState.OPEN, StreamInputs.RECV_DATA):
+        (H2StreamStateMachine.data_received, StreamState.OPEN),
+    (StreamState.OPEN, StreamInputs.SEND_END_STREAM):
+        (None, StreamState.HALF_CLOSED_LOCAL),
+    (StreamState.OPEN, StreamInputs.RECV_END_STREAM):
+        (H2StreamStateMachine.stream_half_closed,
+         StreamState.HALF_CLOSED_REMOTE),
+    (StreamState.OPEN, StreamInputs.SEND_WINDOW_UPDATE):
+        (None, StreamState.OPEN),
+    (StreamState.OPEN, StreamInputs.RECV_WINDOW_UPDATE):
+        (H2StreamStateMachine.window_updated, StreamState.OPEN),
+    (StreamState.OPEN, StreamInputs.SEND_RST_STREAM):
+        (H2StreamStateMachine.send_reset_stream, StreamState.CLOSED),
+    (StreamState.OPEN, StreamInputs.RECV_RST_STREAM):
+        (H2StreamStateMachine.stream_reset, StreamState.CLOSED),
+    (StreamState.OPEN, StreamInputs.SEND_PUSH_PROMISE):
+        (H2StreamStateMachine.send_push_promise, StreamState.OPEN),
+    (StreamState.OPEN, StreamInputs.RECV_PUSH_PROMISE):
+        (H2StreamStateMachine.recv_push_promise, StreamState.OPEN),
+    (StreamState.OPEN, StreamInputs.SEND_INFORMATIONAL_HEADERS):
+        (H2StreamStateMachine.send_informational_response, StreamState.OPEN),
+    (StreamState.OPEN, StreamInputs.RECV_INFORMATIONAL_HEADERS):
+        (H2StreamStateMachine.recv_informational_response, StreamState.OPEN),
+    (StreamState.OPEN, StreamInputs.SEND_ALTERNATIVE_SERVICE):
+        (H2StreamStateMachine.send_alt_svc, StreamState.OPEN),
+    (StreamState.OPEN, StreamInputs.RECV_ALTERNATIVE_SERVICE):
+        (H2StreamStateMachine.recv_alt_svc, StreamState.OPEN),
+
+    # State: half-closed remote
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.SEND_HEADERS):
+        (H2StreamStateMachine.response_sent, StreamState.HALF_CLOSED_REMOTE),
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.RECV_HEADERS):
+        (H2StreamStateMachine.reset_stream_on_error, StreamState.CLOSED),
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.SEND_DATA):
+        (None, StreamState.HALF_CLOSED_REMOTE),
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.RECV_DATA):
+        (H2StreamStateMachine.reset_stream_on_error, StreamState.CLOSED),
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.SEND_END_STREAM):
+        (H2StreamStateMachine.send_end_stream, StreamState.CLOSED),
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.SEND_WINDOW_UPDATE):
+        (None, StreamState.HALF_CLOSED_REMOTE),
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.RECV_WINDOW_UPDATE):
+        (H2StreamStateMachine.window_updated, StreamState.HALF_CLOSED_REMOTE),
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.SEND_RST_STREAM):
+        (H2StreamStateMachine.send_reset_stream, StreamState.CLOSED),
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.RECV_RST_STREAM):
+        (H2StreamStateMachine.stream_reset, StreamState.CLOSED),
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.SEND_PUSH_PROMISE):
+        (H2StreamStateMachine.send_push_promise,
+            StreamState.HALF_CLOSED_REMOTE),
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.RECV_PUSH_PROMISE):
+        (H2StreamStateMachine.reset_stream_on_error, StreamState.CLOSED),
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.SEND_INFORMATIONAL_HEADERS):
+        (H2StreamStateMachine.send_informational_response,
+            StreamState.HALF_CLOSED_REMOTE),
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.SEND_ALTERNATIVE_SERVICE):
+        (H2StreamStateMachine.send_alt_svc, StreamState.HALF_CLOSED_REMOTE),
+    (StreamState.HALF_CLOSED_REMOTE, StreamInputs.RECV_ALTERNATIVE_SERVICE):
+        (H2StreamStateMachine.recv_alt_svc, StreamState.HALF_CLOSED_REMOTE),
+
+    # State: half-closed local
+    (StreamState.HALF_CLOSED_LOCAL, StreamInputs.RECV_HEADERS):
+        (H2StreamStateMachine.response_received,
+            StreamState.HALF_CLOSED_LOCAL),
+    (StreamState.HALF_CLOSED_LOCAL, StreamInputs.RECV_DATA):
+        (H2StreamStateMachine.data_received, StreamState.HALF_CLOSED_LOCAL),
+    (StreamState.HALF_CLOSED_LOCAL, StreamInputs.RECV_END_STREAM):
+        (H2StreamStateMachine.stream_ended, StreamState.CLOSED),
+    (StreamState.HALF_CLOSED_LOCAL, StreamInputs.SEND_WINDOW_UPDATE):
+        (None, StreamState.HALF_CLOSED_LOCAL),
+    (StreamState.HALF_CLOSED_LOCAL, StreamInputs.RECV_WINDOW_UPDATE):
+        (H2StreamStateMachine.window_updated, StreamState.HALF_CLOSED_LOCAL),
+    (StreamState.HALF_CLOSED_LOCAL, StreamInputs.SEND_RST_STREAM):
+        (H2StreamStateMachine.send_reset_stream, StreamState.CLOSED),
+    (StreamState.HALF_CLOSED_LOCAL, StreamInputs.RECV_RST_STREAM):
+        (H2StreamStateMachine.stream_reset, StreamState.CLOSED),
+    (StreamState.HALF_CLOSED_LOCAL, StreamInputs.RECV_PUSH_PROMISE):
+        (H2StreamStateMachine.recv_push_promise,
+            StreamState.HALF_CLOSED_LOCAL),
+    (StreamState.HALF_CLOSED_LOCAL, StreamInputs.RECV_INFORMATIONAL_HEADERS):
+        (H2StreamStateMachine.recv_informational_response,
+            StreamState.HALF_CLOSED_LOCAL),
+    (StreamState.HALF_CLOSED_LOCAL, StreamInputs.SEND_ALTERNATIVE_SERVICE):
+        (H2StreamStateMachine.send_alt_svc, StreamState.HALF_CLOSED_LOCAL),
+    (StreamState.HALF_CLOSED_LOCAL, StreamInputs.RECV_ALTERNATIVE_SERVICE):
+        (H2StreamStateMachine.recv_alt_svc, StreamState.HALF_CLOSED_LOCAL),
+
+    # State: closed
+    (StreamState.CLOSED, StreamInputs.RECV_END_STREAM):
+        (None, StreamState.CLOSED),
+    (StreamState.CLOSED, StreamInputs.RECV_ALTERNATIVE_SERVICE):
+        (None, StreamState.CLOSED),
+
+    # RFC 7540 Section 5.1 defines how the end point should react when
+    # receiving a frame on a closed stream with the following statements:
+    #
+    # > An endpoint that receives any frame other than PRIORITY after receiving
+    # > a RST_STREAM MUST treat that as a stream error of type STREAM_CLOSED.
+    # > An endpoint that receives any frames after receiving a frame with the
+    # > END_STREAM flag set MUST treat that as a connection error of type
+    # > STREAM_CLOSED.
+    (StreamState.CLOSED, StreamInputs.RECV_HEADERS):
+        (H2StreamStateMachine.recv_on_closed_stream, StreamState.CLOSED),
+    (StreamState.CLOSED, StreamInputs.RECV_DATA):
+        (H2StreamStateMachine.recv_on_closed_stream, StreamState.CLOSED),
+
+    # > WINDOW_UPDATE or RST_STREAM frames can be received in this state
+    # > for a short period after a DATA or HEADERS frame containing a
+    # > END_STREAM flag is sent, as instructed in RFC 7540 Section 5.1. But we
+    # > don't have access to a clock so we just always allow it.
+    (StreamState.CLOSED, StreamInputs.RECV_WINDOW_UPDATE):
+        (None, StreamState.CLOSED),
+    (StreamState.CLOSED, StreamInputs.RECV_RST_STREAM):
+        (None, StreamState.CLOSED),
+
+    # > A receiver MUST treat the receipt of a PUSH_PROMISE on a stream that is
+    # > neither "open" nor "half-closed (local)" as a connection error of type
+    # > PROTOCOL_ERROR.
+    (StreamState.CLOSED, StreamInputs.RECV_PUSH_PROMISE):
+        (H2StreamStateMachine.recv_push_on_closed_stream, StreamState.CLOSED),
+
+    # Also, users should be forbidden from sending on closed streams.
+    (StreamState.CLOSED, StreamInputs.SEND_HEADERS):
+        (H2StreamStateMachine.send_on_closed_stream, StreamState.CLOSED),
+    (StreamState.CLOSED, StreamInputs.SEND_PUSH_PROMISE):
+        (H2StreamStateMachine.send_push_on_closed_stream, StreamState.CLOSED),
+    (StreamState.CLOSED, StreamInputs.SEND_RST_STREAM):
+        (H2StreamStateMachine.send_on_closed_stream, StreamState.CLOSED),
+    (StreamState.CLOSED, StreamInputs.SEND_DATA):
+        (H2StreamStateMachine.send_on_closed_stream, StreamState.CLOSED),
+    (StreamState.CLOSED, StreamInputs.SEND_WINDOW_UPDATE):
+        (H2StreamStateMachine.send_on_closed_stream, StreamState.CLOSED),
+    (StreamState.CLOSED, StreamInputs.SEND_END_STREAM):
+        (H2StreamStateMachine.send_on_closed_stream, StreamState.CLOSED),
+}
+
+
+class H2Stream:
+    """
+    A low-level HTTP/2 stream object. This handles building and receiving
+    frames and maintains per-stream state.
+
+    This wraps a HTTP/2 Stream state machine implementation, ensuring that
+    frames can only be sent/received when the stream is in a valid state.
+    Attempts to create frames that cannot be sent will raise a
+    ``ProtocolError``.
+    """
+    def __init__(self,
+                 stream_id,
+                 config,
+                 inbound_window_size,
+                 outbound_window_size):
+        self.state_machine = H2StreamStateMachine(stream_id)
+        self.stream_id = stream_id
+        self.max_outbound_frame_size = None
+        self.request_method = None
+
+        # The current value of the outbound stream flow control window
+        self.outbound_flow_control_window = outbound_window_size
+
+        # The flow control manager.
+        self._inbound_window_manager = WindowManager(inbound_window_size)
+
+        # The expected content length, if any.
+        self._expected_content_length = None
+
+        # The actual received content length. Always tracked.
+        self._actual_content_length = 0
+
+        # The authority we believe this stream belongs to.
+        self._authority = None
+
+        # The configuration for this stream.
+        self.config = config
+
+    def __repr__(self):
+        return "<%s id:%d state:%r>" % (
+            type(self).__name__,
+            self.stream_id,
+            self.state_machine.state
+        )
+
+    @property
+    def inbound_flow_control_window(self):
+        """
+        The size of the inbound flow control window for the stream. This is
+        rarely publicly useful: instead, use :meth:`remote_flow_control_window
+        <h2.stream.H2Stream.remote_flow_control_window>`. This shortcut is
+        largely present to provide a shortcut to this data.
+        """
+        return self._inbound_window_manager.current_window_size
+
+    @property
+    def open(self):
+        """
+        Whether the stream is 'open' in any sense: that is, whether it counts
+        against the number of concurrent streams.
+        """
+        # RFC 7540 Section 5.1.2 defines 'open' for this purpose to mean either
+        # the OPEN state or either of the HALF_CLOSED states. Perplexingly,
+        # this excludes the reserved states.
+        # For more detail on why we're doing this in this slightly weird way,
+        # see the comment on ``STREAM_OPEN`` at the top of the file.
+        return STREAM_OPEN[self.state_machine.state]
+
+    @property
+    def closed(self):
+        """
+        Whether the stream is closed.
+        """
+        return self.state_machine.state == StreamState.CLOSED
+
+    @property
+    def closed_by(self):
+        """
+        Returns how the stream was closed, as one of StreamClosedBy.
+        """
+        return self.state_machine.stream_closed_by
+
+    def upgrade(self, client_side):
+        """
+        Called by the connection to indicate that this stream is the initial
+        request/response of an upgraded connection. Places the stream into an
+        appropriate state.
+        """
+        self.config.logger.debug("Upgrading %r", self)
+
+        assert self.stream_id == 1
+        input_ = (
+            StreamInputs.UPGRADE_CLIENT if client_side
+            else StreamInputs.UPGRADE_SERVER
+        )
+
+        # This may return events, we deliberately don't want them.
+        self.state_machine.process_input(input_)
+        return
+
+    def send_headers(self, headers, encoder, end_stream=False):
+        """
+        Returns a list of HEADERS/CONTINUATION frames to emit as either headers
+        or trailers.
+        """
+        self.config.logger.debug("Send headers %s on %r", headers, self)
+
+        # Because encoding headers makes an irreversible change to the header
+        # compression context, we make the state transition before we encode
+        # them.
+
+        # First, check if we're a client. If we are, no problem: if we aren't,
+        # we need to scan the header block to see if this is an informational
+        # response.
+        input_ = StreamInputs.SEND_HEADERS
+        if ((not self.state_machine.client) and
+                is_informational_response(headers)):
+            if end_stream:
+                raise ProtocolError(
+                    "Cannot set END_STREAM on informational responses."
+                )
+
+            input_ = StreamInputs.SEND_INFORMATIONAL_HEADERS
+
+        events = self.state_machine.process_input(input_)
+
+        hf = HeadersFrame(self.stream_id)
+        hdr_validation_flags = self._build_hdr_validation_flags(events)
+        frames = self._build_headers_frames(
+            headers, encoder, hf, hdr_validation_flags
+        )
+
+        if end_stream:
+            # Not a bug: the END_STREAM flag is valid on the initial HEADERS
+            # frame, not the CONTINUATION frames that follow.
+            self.state_machine.process_input(StreamInputs.SEND_END_STREAM)
+            frames[0].flags.add('END_STREAM')
+
+        if self.state_machine.trailers_sent and not end_stream:
+            raise ProtocolError("Trailers must have END_STREAM set.")
+
+        if self.state_machine.client and self._authority is None:
+            self._authority = authority_from_headers(headers)
+
+        # store request method for _initialize_content_length
+        self.request_method = extract_method_header(headers)
+
+        return frames
+
+    def push_stream_in_band(self, related_stream_id, headers, encoder):
+        """
+        Returns a list of PUSH_PROMISE/CONTINUATION frames to emit as a pushed
+        stream header. Called on the stream that has the PUSH_PROMISE frame
+        sent on it.
+        """
+        self.config.logger.debug("Push stream %r", self)
+
+        # Because encoding headers makes an irreversible change to the header
+        # compression context, we make the state transition *first*.
+
+        events = self.state_machine.process_input(
+            StreamInputs.SEND_PUSH_PROMISE
+        )
+
+        ppf = PushPromiseFrame(self.stream_id)
+        ppf.promised_stream_id = related_stream_id
+        hdr_validation_flags = self._build_hdr_validation_flags(events)
+        frames = self._build_headers_frames(
+            headers, encoder, ppf, hdr_validation_flags
+        )
+
+        return frames
+
+    def locally_pushed(self):
+        """
+        Mark this stream as one that was pushed by this peer. Must be called
+        immediately after initialization. Sends no frames, simply updates the
+        state machine.
+        """
+        # This does not trigger any events.
+        events = self.state_machine.process_input(
+            StreamInputs.SEND_PUSH_PROMISE
+        )
+        assert not events
+        return []
+
+    def send_data(self, data, end_stream=False, pad_length=None):
+        """
+        Prepare some data frames. Optionally end the stream.
+
+        .. warning:: Does not perform flow control checks.
+        """
+        self.config.logger.debug(
+            "Send data on %r with end stream set to %s", self, end_stream
+        )
+
+        self.state_machine.process_input(StreamInputs.SEND_DATA)
+
+        df = DataFrame(self.stream_id)
+        df.data = data
+        if end_stream:
+            self.state_machine.process_input(StreamInputs.SEND_END_STREAM)
+            df.flags.add('END_STREAM')
+        if pad_length is not None:
+            df.flags.add('PADDED')
+            df.pad_length = pad_length
+
+        # Subtract flow_controlled_length to account for possible padding
+        self.outbound_flow_control_window -= df.flow_controlled_length
+        assert self.outbound_flow_control_window >= 0
+
+        return [df]
+
+    def end_stream(self):
+        """
+        End a stream without sending data.
+        """
+        self.config.logger.debug("End stream %r", self)
+
+        self.state_machine.process_input(StreamInputs.SEND_END_STREAM)
+        df = DataFrame(self.stream_id)
+        df.flags.add('END_STREAM')
+        return [df]
+
+    def advertise_alternative_service(self, field_value):
+        """
+        Advertise an RFC 7838 alternative service. The semantics of this are
+        better documented in the ``H2Connection`` class.
+        """
+        self.config.logger.debug(
+            "Advertise alternative service of %r for %r", field_value, self
+        )
+        self.state_machine.process_input(StreamInputs.SEND_ALTERNATIVE_SERVICE)
+        asf = AltSvcFrame(self.stream_id)
+        asf.field = field_value
+        return [asf]
+
+    def increase_flow_control_window(self, increment):
+        """
+        Increase the size of the flow control window for the remote side.
+        """
+        self.config.logger.debug(
+            "Increase flow control window for %r by %d",
+            self, increment
+        )
+        self.state_machine.process_input(StreamInputs.SEND_WINDOW_UPDATE)
+        self._inbound_window_manager.window_opened(increment)
+
+        wuf = WindowUpdateFrame(self.stream_id)
+        wuf.window_increment = increment
+        return [wuf]
+
+    def receive_push_promise_in_band(self,
+                                     promised_stream_id,
+                                     headers,
+                                     header_encoding):
+        """
+        Receives a push promise frame sent on this stream, pushing a remote
+        stream. This is called on the stream that has the PUSH_PROMISE sent
+        on it.
+        """
+        self.config.logger.debug(
+            "Receive Push Promise on %r for remote stream %d",
+            self, promised_stream_id
+        )
+        events = self.state_machine.process_input(
+            StreamInputs.RECV_PUSH_PROMISE
+        )
+        events[0].pushed_stream_id = promised_stream_id
+
+        hdr_validation_flags = self._build_hdr_validation_flags(events)
+        events[0].headers = self._process_received_headers(
+            headers, hdr_validation_flags, header_encoding
+        )
+        return [], events
+
+    def remotely_pushed(self, pushed_headers):
+        """
+        Mark this stream as one that was pushed by the remote peer. Must be
+        called immediately after initialization. Sends no frames, simply
+        updates the state machine.
+        """
+        self.config.logger.debug("%r pushed by remote peer", self)
+        events = self.state_machine.process_input(
+            StreamInputs.RECV_PUSH_PROMISE
+        )
+        self._authority = authority_from_headers(pushed_headers)
+        return [], events
+
+    def receive_headers(self, headers, end_stream, header_encoding):
+        """
+        Receive a set of headers (or trailers).
+        """
+        if is_informational_response(headers):
+            if end_stream:
+                raise ProtocolError(
+                    "Cannot set END_STREAM on informational responses"
+                )
+            input_ = StreamInputs.RECV_INFORMATIONAL_HEADERS
+        else:
+            input_ = StreamInputs.RECV_HEADERS
+
+        events = self.state_machine.process_input(input_)
+
+        if end_stream:
+            es_events = self.state_machine.process_input(
+                StreamInputs.RECV_END_STREAM
+            )
+            events[0].stream_ended = es_events[0]
+            events += es_events
+
+        self._initialize_content_length(headers)
+
+        if isinstance(events[0], TrailersReceived):
+            if not end_stream:
+                raise ProtocolError("Trailers must have END_STREAM set")
+
+        hdr_validation_flags = self._build_hdr_validation_flags(events)
+        events[0].headers = self._process_received_headers(
+            headers, hdr_validation_flags, header_encoding
+        )
+        return [], events
+
+    def receive_data(self, data, end_stream, flow_control_len):
+        """
+        Receive some data.
+        """
+        self.config.logger.debug(
+            "Receive data on %r with end stream %s and flow control length "
+            "set to %d", self, end_stream, flow_control_len
+        )
+        events = self.state_machine.process_input(StreamInputs.RECV_DATA)
+        self._inbound_window_manager.window_consumed(flow_control_len)
+        self._track_content_length(len(data), end_stream)
+
+        if end_stream:
+            es_events = self.state_machine.process_input(
+                StreamInputs.RECV_END_STREAM
+            )
+            events[0].stream_ended = es_events[0]
+            events.extend(es_events)
+
+        events[0].data = data
+        events[0].flow_controlled_length = flow_control_len
+        return [], events
+
+    def receive_window_update(self, increment):
+        """
+        Handle a WINDOW_UPDATE increment.
+        """
+        self.config.logger.debug(
+            "Receive Window Update on %r for increment of %d",
+            self, increment
+        )
+        events = self.state_machine.process_input(
+            StreamInputs.RECV_WINDOW_UPDATE
+        )
+        frames = []
+
+        # If we encounter a problem with incrementing the flow control window,
+        # this should be treated as a *stream* error, not a *connection* error.
+        # That means we need to catch the error and forcibly close the stream.
+        if events:
+            events[0].delta = increment
+            try:
+                self.outbound_flow_control_window = guard_increment_window(
+                    self.outbound_flow_control_window,
+                    increment
+                )
+            except FlowControlError:
+                # Ok, this is bad. We're going to need to perform a local
+                # reset.
+                event = StreamReset()
+                event.stream_id = self.stream_id
+                event.error_code = ErrorCodes.FLOW_CONTROL_ERROR
+                event.remote_reset = False
+
+                events = [event]
+                frames = self.reset_stream(event.error_code)
+
+        return frames, events
+
+    def receive_continuation(self):
+        """
+        A naked CONTINUATION frame has been received. This is always an error,
+        but the type of error it is depends on the state of the stream and must
+        transition the state of the stream, so we need to handle it.
+        """
+        self.config.logger.debug("Receive Continuation frame on %r", self)
+        self.state_machine.process_input(
+            StreamInputs.RECV_CONTINUATION
+        )
+        assert False, "Should not be reachable"
+
+    def receive_alt_svc(self, frame):
+        """
+        An Alternative Service frame was received on the stream. This frame
+        inherits the origin associated with this stream.
+        """
+        self.config.logger.debug(
+            "Receive Alternative Service frame on stream %r", self
+        )
+
+        # If the origin is present, RFC 7838 says we have to ignore it.
+        if frame.origin:
+            return [], []
+
+        events = self.state_machine.process_input(
+            StreamInputs.RECV_ALTERNATIVE_SERVICE
+        )
+
+        # There are lots of situations where we want to ignore the ALTSVC
+        # frame. If we need to pay attention, we'll have an event and should
+        # fill it out.
+        if events:
+            assert isinstance(events[0], AlternativeServiceAvailable)
+            events[0].origin = self._authority
+            events[0].field_value = frame.field
+
+        return [], events
+
+    def reset_stream(self, error_code=0):
+        """
+        Close the stream locally. Reset the stream with an error code.
+        """
+        self.config.logger.debug(
+            "Local reset %r with error code: %d", self, error_code
+        )
+        self.state_machine.process_input(StreamInputs.SEND_RST_STREAM)
+
+        rsf = RstStreamFrame(self.stream_id)
+        rsf.error_code = error_code
+        return [rsf]
+
+    def stream_reset(self, frame):
+        """
+        Handle a stream being reset remotely.
+        """
+        self.config.logger.debug(
+            "Remote reset %r with error code: %d", self, frame.error_code
+        )
+        events = self.state_machine.process_input(StreamInputs.RECV_RST_STREAM)
+
+        if events:
+            # We don't fire an event if this stream is already closed.
+            events[0].error_code = _error_code_from_int(frame.error_code)
+
+        return [], events
+
+    def acknowledge_received_data(self, acknowledged_size):
+        """
+        The user has informed us that they've processed some amount of data
+        that was received on this stream. Pass that to the window manager and
+        potentially return some WindowUpdate frames.
+        """
+        self.config.logger.debug(
+            "Acknowledge received data with size %d on %r",
+            acknowledged_size, self
+        )
+        increment = self._inbound_window_manager.process_bytes(
+            acknowledged_size
+        )
+        if increment:
+            f = WindowUpdateFrame(self.stream_id)
+            f.window_increment = increment
+            return [f]
+
+        return []
+
+    def _build_hdr_validation_flags(self, events):
+        """
+        Constructs a set of header validation flags for use when normalizing
+        and validating header blocks.
+        """
+        is_trailer = isinstance(
+            events[0], (_TrailersSent, TrailersReceived)
+        )
+        is_response_header = isinstance(
+            events[0],
+            (
+                _ResponseSent,
+                ResponseReceived,
+                InformationalResponseReceived
+            )
+        )
+        is_push_promise = isinstance(
+            events[0], (PushedStreamReceived, _PushedRequestSent)
+        )
+
+        return HeaderValidationFlags(
+            is_client=self.state_machine.client,
+            is_trailer=is_trailer,
+            is_response_header=is_response_header,
+            is_push_promise=is_push_promise,
+        )
+
+    def _build_headers_frames(self,
+                              headers,
+                              encoder,
+                              first_frame,
+                              hdr_validation_flags):
+        """
+        Helper method to build headers or push promise frames.
+        """
+        # We need to lowercase the header names, and to ensure that secure
+        # header fields are kept out of compression contexts.
+        if self.config.normalize_outbound_headers:
+            headers = normalize_outbound_headers(
+                headers, hdr_validation_flags
+            )
+        if self.config.validate_outbound_headers:
+            headers = validate_outbound_headers(
+                headers, hdr_validation_flags
+            )
+
+        encoded_headers = encoder.encode(headers)
+
+        # Slice into blocks of max_outbound_frame_size. Be careful with this:
+        # it only works right because we never send padded frames or priority
+        # information on the frames. Revisit this if we do.
+        header_blocks = [
+            encoded_headers[i:i+self.max_outbound_frame_size]
+            for i in range(
+                0, len(encoded_headers), self.max_outbound_frame_size
+            )
+        ]
+
+        frames = []
+        first_frame.data = header_blocks[0]
+        frames.append(first_frame)
+
+        for block in header_blocks[1:]:
+            cf = ContinuationFrame(self.stream_id)
+            cf.data = block
+            frames.append(cf)
+
+        frames[-1].flags.add('END_HEADERS')
+        return frames
+
+    def _process_received_headers(self,
+                                  headers,
+                                  header_validation_flags,
+                                  header_encoding):
+        """
+        When headers have been received from the remote peer, run a processing
+        pipeline on them to transform them into the appropriate form for
+        attaching to an event.
+        """
+        if self.config.normalize_inbound_headers:
+            headers = normalize_inbound_headers(
+                headers, header_validation_flags
+            )
+
+        if self.config.validate_inbound_headers:
+            headers = validate_headers(headers, header_validation_flags)
+
+        if header_encoding:
+            headers = _decode_headers(headers, header_encoding)
+
+        # The above steps are all generators, so we need to concretize the
+        # headers now.
+        return list(headers)
+
+    def _initialize_content_length(self, headers):
+        """
+        Checks the headers for a content-length header and initializes the
+        _expected_content_length field from it. It's not an error for no
+        Content-Length header to be present.
+        """
+        if self.request_method == b'HEAD':
+            self._expected_content_length = 0
+            return
+
+        for n, v in headers:
+            if n == b'content-length':
+                try:
+                    self._expected_content_length = int(v, 10)
+                except ValueError:
+                    raise ProtocolError(
+                        "Invalid content-length header: %s" % v
+                    )
+
+                return
+
+    def _track_content_length(self, length, end_stream):
+        """
+        Update the expected content length in response to data being received.
+        Validates that the appropriate amount of data is sent. Always updates
+        the received data, but only validates the length against the
+        content-length header if one was sent.
+
+        :param length: The length of the body chunk received.
+        :param end_stream: If this is the last body chunk received.
+        """
+        self._actual_content_length += length
+        actual = self._actual_content_length
+        expected = self._expected_content_length
+
+        if expected is not None:
+            if expected < actual:
+                raise InvalidBodyLengthError(expected, actual)
+
+            if end_stream and expected != actual:
+                raise InvalidBodyLengthError(expected, actual)
+
+    def _inbound_flow_control_change_from_settings(self, delta):
+        """
+        We changed SETTINGS_INITIAL_WINDOW_SIZE, which means we need to
+        update the target window size for flow control. For our flow control
+        strategy, this means we need to do two things: we need to adjust the
+        current window size, but we also need to set the target maximum window
+        size to the new value.
+        """
+        new_max_size = self._inbound_window_manager.max_window_size + delta
+        self._inbound_window_manager.window_opened(delta)
+        self._inbound_window_manager.max_window_size = new_max_size
+
+
+def _decode_headers(headers, encoding):
+    """
+    Given an iterable of header two-tuples and an encoding, decodes those
+    headers using that encoding while preserving the type of the header tuple.
+    This ensures that the use of ``HeaderTuple`` is preserved.
+    """
+    for header in headers:
+        # This function expects to work on decoded headers, which are always
+        # HeaderTuple objects.
+        assert isinstance(header, HeaderTuple)
+
+        name, value = header
+        name = name.decode(encoding)
+        value = value.decode(encoding)
+        yield header.__class__(name, value)
diff --git a/llm/Lib/site-packages/h2/utilities.py b/llm/Lib/site-packages/h2/utilities.py
new file mode 100644
index 0000000000000000000000000000000000000000..c7a620d8d4a88d11786a9d4e54362aa4174070dc
--- /dev/null
+++ b/llm/Lib/site-packages/h2/utilities.py
@@ -0,0 +1,672 @@
+# -*- coding: utf-8 -*-
+"""
+h2/utilities
+~~~~~~~~~~~~
+
+Utility functions that do not belong in a separate module.
+"""
+import collections
+import re
+from string import whitespace
+
+from hpack import HeaderTuple, NeverIndexedHeaderTuple
+
+from .exceptions import ProtocolError, FlowControlError
+
+UPPER_RE = re.compile(b"[A-Z]")
+
+# A set of headers that are hop-by-hop or connection-specific and thus
+# forbidden in HTTP/2. This list comes from RFC 7540 § 8.1.2.2.
+CONNECTION_HEADERS = frozenset([
+    b'connection', u'connection',
+    b'proxy-connection', u'proxy-connection',
+    b'keep-alive', u'keep-alive',
+    b'transfer-encoding', u'transfer-encoding',
+    b'upgrade', u'upgrade',
+])
+
+
+_ALLOWED_PSEUDO_HEADER_FIELDS = frozenset([
+    b':method', u':method',
+    b':scheme', u':scheme',
+    b':authority', u':authority',
+    b':path', u':path',
+    b':status', u':status',
+    b':protocol', u':protocol',
+])
+
+
+_SECURE_HEADERS = frozenset([
+    # May have basic credentials which are vulnerable to dictionary attacks.
+    b'authorization', u'authorization',
+    b'proxy-authorization', u'proxy-authorization',
+])
+
+
+_REQUEST_ONLY_HEADERS = frozenset([
+    b':scheme', u':scheme',
+    b':path', u':path',
+    b':authority', u':authority',
+    b':method', u':method',
+    b':protocol', u':protocol',
+])
+
+
+_RESPONSE_ONLY_HEADERS = frozenset([b':status', u':status'])
+
+
+# A Set of pseudo headers that are only valid if the method is
+# CONNECT, see RFC 8441 § 5
+_CONNECT_REQUEST_ONLY_HEADERS = frozenset([b':protocol', u':protocol'])
+
+
+_WHITESPACE = frozenset(map(ord, whitespace))
+
+
+def _secure_headers(headers, hdr_validation_flags):
+    """
+    Certain headers are at risk of being attacked during the header compression
+    phase, and so need to be kept out of header compression contexts. This
+    function automatically transforms certain specific headers into HPACK
+    never-indexed fields to ensure they don't get added to header compression
+    contexts.
+
+    This function currently implements two rules:
+
+    - 'authorization' and 'proxy-authorization' fields are automatically made
+      never-indexed.
+    - Any 'cookie' header field shorter than 20 bytes long is made
+      never-indexed.
+
+    These fields are the most at-risk. These rules are inspired by Firefox
+    and nghttp2.
+    """
+    for header in headers:
+        if header[0] in _SECURE_HEADERS:
+            yield NeverIndexedHeaderTuple(*header)
+        elif header[0] in (b'cookie', u'cookie') and len(header[1]) < 20:
+            yield NeverIndexedHeaderTuple(*header)
+        else:
+            yield header
+
+
+def extract_method_header(headers):
+    """
+    Extracts the request method from the headers list.
+    """
+    for k, v in headers:
+        if k in (b':method', u':method'):
+            if not isinstance(v, bytes):
+                return v.encode('utf-8')
+            else:
+                return v
+
+
+def is_informational_response(headers):
+    """
+    Searches a header block for a :status header to confirm that a given
+    collection of headers are an informational response. Assumes the header
+    block is well formed: that is, that the HTTP/2 special headers are first
+    in the block, and so that it can stop looking when it finds the first
+    header field whose name does not begin with a colon.
+
+    :param headers: The HTTP/2 header block.
+    :returns: A boolean indicating if this is an informational response.
+    """
+    for n, v in headers:
+        if isinstance(n, bytes):
+            sigil = b':'
+            status = b':status'
+            informational_start = b'1'
+        else:
+            sigil = u':'
+            status = u':status'
+            informational_start = u'1'
+
+        # If we find a non-special header, we're done here: stop looping.
+        if not n.startswith(sigil):
+            return False
+
+        # This isn't the status header, bail.
+        if n != status:
+            continue
+
+        # If the first digit is a 1, we've got informational headers.
+        return v.startswith(informational_start)
+
+
+def guard_increment_window(current, increment):
+    """
+    Increments a flow control window, guarding against that window becoming too
+    large.
+
+    :param current: The current value of the flow control window.
+    :param increment: The increment to apply to that window.
+    :returns: The new value of the window.
+    :raises: ``FlowControlError``
+    """
+    # The largest value the flow control window may take.
+    LARGEST_FLOW_CONTROL_WINDOW = 2**31 - 1
+
+    new_size = current + increment
+
+    if new_size > LARGEST_FLOW_CONTROL_WINDOW:
+        raise FlowControlError(
+            "May not increment flow control window past %d" %
+            LARGEST_FLOW_CONTROL_WINDOW
+        )
+
+    return new_size
+
+
+def authority_from_headers(headers):
+    """
+    Given a header set, searches for the authority header and returns the
+    value.
+
+    Note that this doesn't terminate early, so should only be called if the
+    headers are for a client request. Otherwise, will loop over the entire
+    header set, which is potentially unwise.
+
+    :param headers: The HTTP header set.
+    :returns: The value of the authority header, or ``None``.
+    :rtype: ``bytes`` or ``None``.
+    """
+    for n, v in headers:
+        # This gets run against headers that come both from HPACK and from the
+        # user, so we may have unicode floating around in here. We only want
+        # bytes.
+        if n in (b':authority', u':authority'):
+            return v.encode('utf-8') if not isinstance(v, bytes) else v
+
+    return None
+
+
+# Flags used by the validate_headers pipeline to determine which checks
+# should be applied to a given set of headers.
+HeaderValidationFlags = collections.namedtuple(
+    'HeaderValidationFlags',
+    ['is_client', 'is_trailer', 'is_response_header', 'is_push_promise']
+)
+
+
+def validate_headers(headers, hdr_validation_flags):
+    """
+    Validates a header sequence against a set of constraints from RFC 7540.
+
+    :param headers: The HTTP header set.
+    :param hdr_validation_flags: An instance of HeaderValidationFlags.
+    """
+    # This validation logic is built on a sequence of generators that are
+    # iterated over to provide the final header list. This reduces some of the
+    # overhead of doing this checking. However, it's worth noting that this
+    # checking remains somewhat expensive, and attempts should be made wherever
+    # possible to reduce the time spent doing them.
+    #
+    # For example, we avoid tuple unpacking in loops because it represents a
+    # fixed cost that we don't want to spend, instead indexing into the header
+    # tuples.
+    headers = _reject_empty_header_names(
+        headers, hdr_validation_flags
+    )
+    headers = _reject_uppercase_header_fields(
+        headers, hdr_validation_flags
+    )
+    headers = _reject_surrounding_whitespace(
+        headers, hdr_validation_flags
+    )
+    headers = _reject_te(
+        headers, hdr_validation_flags
+    )
+    headers = _reject_connection_header(
+        headers, hdr_validation_flags
+    )
+    headers = _reject_pseudo_header_fields(
+        headers, hdr_validation_flags
+    )
+    headers = _check_host_authority_header(
+        headers, hdr_validation_flags
+    )
+    headers = _check_path_header(headers, hdr_validation_flags)
+
+    return headers
+
+
+def _reject_empty_header_names(headers, hdr_validation_flags):
+    """
+    Raises a ProtocolError if any header names are empty (length 0).
+    While hpack decodes such headers without errors, they are semantically
+    forbidden in HTTP, see RFC 7230, stating that they must be at least one
+    character long.
+    """
+    for header in headers:
+        if len(header[0]) == 0:
+            raise ProtocolError("Received header name with zero length.")
+        yield header
+
+
+def _reject_uppercase_header_fields(headers, hdr_validation_flags):
+    """
+    Raises a ProtocolError if any uppercase character is found in a header
+    block.
+    """
+    for header in headers:
+        if UPPER_RE.search(header[0]):
+            raise ProtocolError(
+                "Received uppercase header name %s." % header[0])
+        yield header
+
+
+def _reject_surrounding_whitespace(headers, hdr_validation_flags):
+    """
+    Raises a ProtocolError if any header name or value is surrounded by
+    whitespace characters.
+    """
+    # For compatibility with RFC 7230 header fields, we need to allow the field
+    # value to be an empty string. This is ludicrous, but technically allowed.
+    # The field name may not be empty, though, so we can safely assume that it
+    # must have at least one character in it and throw exceptions if it
+    # doesn't.
+    for header in headers:
+        if header[0][0] in _WHITESPACE or header[0][-1] in _WHITESPACE:
+            raise ProtocolError(
+                "Received header name surrounded by whitespace %r" % header[0])
+        if header[1] and ((header[1][0] in _WHITESPACE) or
+           (header[1][-1] in _WHITESPACE)):
+            raise ProtocolError(
+                "Received header value surrounded by whitespace %r" % header[1]
+            )
+        yield header
+
+
+def _reject_te(headers, hdr_validation_flags):
+    """
+    Raises a ProtocolError if the TE header is present in a header block and
+    its value is anything other than "trailers".
+    """
+    for header in headers:
+        if header[0] in (b'te', u'te'):
+            if header[1].lower() not in (b'trailers', u'trailers'):
+                raise ProtocolError(
+                    "Invalid value for TE header: %s" %
+                    header[1]
+                )
+
+        yield header
+
+
+def _reject_connection_header(headers, hdr_validation_flags):
+    """
+    Raises a ProtocolError if the Connection header is present in a header
+    block.
+    """
+    for header in headers:
+        if header[0] in CONNECTION_HEADERS:
+            raise ProtocolError(
+                "Connection-specific header field present: %s." % header[0]
+            )
+
+        yield header
+
+
+def _custom_startswith(test_string, bytes_prefix, unicode_prefix):
+    """
+    Given a string that might be a bytestring or a Unicode string,
+    return True if it starts with the appropriate prefix.
+    """
+    if isinstance(test_string, bytes):
+        return test_string.startswith(bytes_prefix)
+    else:
+        return test_string.startswith(unicode_prefix)
+
+
+def _assert_header_in_set(string_header, bytes_header, header_set):
+    """
+    Given a set of header names, checks whether the string or byte version of
+    the header name is present. Raises a Protocol error with the appropriate
+    error if it's missing.
+    """
+    if not (string_header in header_set or bytes_header in header_set):
+        raise ProtocolError(
+            "Header block missing mandatory %s header" % string_header
+        )
+
+
+def _reject_pseudo_header_fields(headers, hdr_validation_flags):
+    """
+    Raises a ProtocolError if duplicate pseudo-header fields are found in a
+    header block or if a pseudo-header field appears in a block after an
+    ordinary header field.
+
+    Raises a ProtocolError if pseudo-header fields are found in trailers.
+    """
+    seen_pseudo_header_fields = set()
+    seen_regular_header = False
+    method = None
+
+    for header in headers:
+        if _custom_startswith(header[0], b':', u':'):
+            if header[0] in seen_pseudo_header_fields:
+                raise ProtocolError(
+                    "Received duplicate pseudo-header field %s" % header[0]
+                )
+
+            seen_pseudo_header_fields.add(header[0])
+
+            if seen_regular_header:
+                raise ProtocolError(
+                    "Received pseudo-header field out of sequence: %s" %
+                    header[0]
+                )
+
+            if header[0] not in _ALLOWED_PSEUDO_HEADER_FIELDS:
+                raise ProtocolError(
+                    "Received custom pseudo-header field %s" % header[0]
+                )
+
+            if header[0] in (b':method', u':method'):
+                if not isinstance(header[1], bytes):
+                    method = header[1].encode('utf-8')
+                else:
+                    method = header[1]
+
+        else:
+            seen_regular_header = True
+
+        yield header
+
+    # Check the pseudo-headers we got to confirm they're acceptable.
+    _check_pseudo_header_field_acceptability(
+        seen_pseudo_header_fields, method, hdr_validation_flags
+    )
+
+
+def _check_pseudo_header_field_acceptability(pseudo_headers,
+                                             method,
+                                             hdr_validation_flags):
+    """
+    Given the set of pseudo-headers present in a header block and the
+    validation flags, confirms that RFC 7540 allows them.
+    """
+    # Pseudo-header fields MUST NOT appear in trailers - RFC 7540 § 8.1.2.1
+    if hdr_validation_flags.is_trailer and pseudo_headers:
+        raise ProtocolError(
+            "Received pseudo-header in trailer %s" % pseudo_headers
+        )
+
+    # If ':status' pseudo-header is not there in a response header, reject it.
+    # Similarly, if ':path', ':method', or ':scheme' are not there in a request
+    # header, reject it. Additionally, if a response contains any request-only
+    # headers or vice-versa, reject it.
+    # Relevant RFC section: RFC 7540 § 8.1.2.4
+    # https://tools.ietf.org/html/rfc7540#section-8.1.2.4
+    if hdr_validation_flags.is_response_header:
+        _assert_header_in_set(u':status', b':status', pseudo_headers)
+        invalid_response_headers = pseudo_headers & _REQUEST_ONLY_HEADERS
+        if invalid_response_headers:
+            raise ProtocolError(
+                "Encountered request-only headers %s" %
+                invalid_response_headers
+            )
+    elif (not hdr_validation_flags.is_response_header and
+          not hdr_validation_flags.is_trailer):
+        # This is a request, so we need to have seen :path, :method, and
+        # :scheme.
+        _assert_header_in_set(u':path', b':path', pseudo_headers)
+        _assert_header_in_set(u':method', b':method', pseudo_headers)
+        _assert_header_in_set(u':scheme', b':scheme', pseudo_headers)
+        invalid_request_headers = pseudo_headers & _RESPONSE_ONLY_HEADERS
+        if invalid_request_headers:
+            raise ProtocolError(
+                "Encountered response-only headers %s" %
+                invalid_request_headers
+            )
+        if method != b'CONNECT':
+            invalid_headers = pseudo_headers & _CONNECT_REQUEST_ONLY_HEADERS
+            if invalid_headers:
+                raise ProtocolError(
+                    "Encountered connect-request-only headers %s" %
+                    invalid_headers
+                )
+
+
+def _validate_host_authority_header(headers):
+    """
+    Given the :authority and Host headers from a request block that isn't
+    a trailer, check that:
+     1. At least one of these headers is set.
+     2. If both headers are set, they match.
+
+    :param headers: The HTTP header set.
+    :raises: ``ProtocolError``
+    """
+    # We use None as a sentinel value.  Iterate over the list of headers,
+    # and record the value of these headers (if present).  We don't need
+    # to worry about receiving duplicate :authority headers, as this is
+    # enforced by the _reject_pseudo_header_fields() pipeline.
+    #
+    # TODO: We should also guard against receiving duplicate Host headers,
+    # and against sending duplicate headers.
+    authority_header_val = None
+    host_header_val = None
+
+    for header in headers:
+        if header[0] in (b':authority', u':authority'):
+            authority_header_val = header[1]
+        elif header[0] in (b'host', u'host'):
+            host_header_val = header[1]
+
+        yield header
+
+    # If we have not-None values for these variables, then we know we saw
+    # the corresponding header.
+    authority_present = (authority_header_val is not None)
+    host_present = (host_header_val is not None)
+
+    # It is an error for a request header block to contain neither
+    # an :authority header nor a Host header.
+    if not authority_present and not host_present:
+        raise ProtocolError(
+            "Request header block does not have an :authority or Host header."
+        )
+
+    # If we receive both headers, they should definitely match.
+    if authority_present and host_present:
+        if authority_header_val != host_header_val:
+            raise ProtocolError(
+                "Request header block has mismatched :authority and "
+                "Host headers: %r / %r"
+                % (authority_header_val, host_header_val)
+            )
+
+
+def _check_host_authority_header(headers, hdr_validation_flags):
+    """
+    Raises a ProtocolError if a header block arrives that does not contain an
+    :authority or a Host header, or if a header block contains both fields,
+    but their values do not match.
+    """
+    # We only expect to see :authority and Host headers on request header
+    # blocks that aren't trailers, so skip this validation if this is a
+    # response header or we're looking at trailer blocks.
+    skip_validation = (
+        hdr_validation_flags.is_response_header or
+        hdr_validation_flags.is_trailer
+    )
+    if skip_validation:
+        return headers
+
+    return _validate_host_authority_header(headers)
+
+
+def _check_path_header(headers, hdr_validation_flags):
+    """
+    Raise a ProtocolError if a header block arrives or is sent that contains an
+    empty :path header.
+    """
+    def inner():
+        for header in headers:
+            if header[0] in (b':path', u':path'):
+                if not header[1]:
+                    raise ProtocolError("An empty :path header is forbidden")
+
+            yield header
+
+    # We only expect to see :authority and Host headers on request header
+    # blocks that aren't trailers, so skip this validation if this is a
+    # response header or we're looking at trailer blocks.
+    skip_validation = (
+        hdr_validation_flags.is_response_header or
+        hdr_validation_flags.is_trailer
+    )
+    if skip_validation:
+        return headers
+    else:
+        return inner()
+
+
+def _lowercase_header_names(headers, hdr_validation_flags):
+    """
+    Given an iterable of header two-tuples, rebuilds that iterable with the
+    header names lowercased. This generator produces tuples that preserve the
+    original type of the header tuple for tuple and any ``HeaderTuple``.
+    """
+    for header in headers:
+        if isinstance(header, HeaderTuple):
+            yield header.__class__(header[0].lower(), header[1])
+        else:
+            yield (header[0].lower(), header[1])
+
+
+def _strip_surrounding_whitespace(headers, hdr_validation_flags):
+    """
+    Given an iterable of header two-tuples, strip both leading and trailing
+    whitespace from both header names and header values. This generator
+    produces tuples that preserve the original type of the header tuple for
+    tuple and any ``HeaderTuple``.
+    """
+    for header in headers:
+        if isinstance(header, HeaderTuple):
+            yield header.__class__(header[0].strip(), header[1].strip())
+        else:
+            yield (header[0].strip(), header[1].strip())
+
+
+def _strip_connection_headers(headers, hdr_validation_flags):
+    """
+    Strip any connection headers as per RFC7540 § 8.1.2.2.
+    """
+    for header in headers:
+        if header[0] not in CONNECTION_HEADERS:
+            yield header
+
+
+def _check_sent_host_authority_header(headers, hdr_validation_flags):
+    """
+    Raises an InvalidHeaderBlockError if we try to send a header block
+    that does not contain an :authority or a Host header, or if
+    the header block contains both fields, but their values do not match.
+    """
+    # We only expect to see :authority and Host headers on request header
+    # blocks that aren't trailers, so skip this validation if this is a
+    # response header or we're looking at trailer blocks.
+    skip_validation = (
+        hdr_validation_flags.is_response_header or
+        hdr_validation_flags.is_trailer
+    )
+    if skip_validation:
+        return headers
+
+    return _validate_host_authority_header(headers)
+
+
+def _combine_cookie_fields(headers, hdr_validation_flags):
+    """
+    RFC 7540 § 8.1.2.5 allows HTTP/2 clients to split the Cookie header field,
+    which must normally appear only once, into multiple fields for better
+    compression. However, they MUST be joined back up again when received.
+    This normalization step applies that transform. The side-effect is that
+    all cookie fields now appear *last* in the header block.
+    """
+    # There is a problem here about header indexing. Specifically, it's
+    # possible that all these cookies are sent with different header indexing
+    # values. At this point it shouldn't matter too much, so we apply our own
+    # logic and make them never-indexed.
+    cookies = []
+    for header in headers:
+        if header[0] == b'cookie':
+            cookies.append(header[1])
+        else:
+            yield header
+    if cookies:
+        cookie_val = b'; '.join(cookies)
+        yield NeverIndexedHeaderTuple(b'cookie', cookie_val)
+
+
+def normalize_outbound_headers(headers, hdr_validation_flags):
+    """
+    Normalizes a header sequence that we are about to send.
+
+    :param headers: The HTTP header set.
+    :param hdr_validation_flags: An instance of HeaderValidationFlags.
+    """
+    headers = _lowercase_header_names(headers, hdr_validation_flags)
+    headers = _strip_surrounding_whitespace(headers, hdr_validation_flags)
+    headers = _strip_connection_headers(headers, hdr_validation_flags)
+    headers = _secure_headers(headers, hdr_validation_flags)
+
+    return headers
+
+
+def normalize_inbound_headers(headers, hdr_validation_flags):
+    """
+    Normalizes a header sequence that we have received.
+
+    :param headers: The HTTP header set.
+    :param hdr_validation_flags: An instance of HeaderValidationFlags
+    """
+    headers = _combine_cookie_fields(headers, hdr_validation_flags)
+    return headers
+
+
+def validate_outbound_headers(headers, hdr_validation_flags):
+    """
+    Validates and normalizes a header sequence that we are about to send.
+
+    :param headers: The HTTP header set.
+    :param hdr_validation_flags: An instance of HeaderValidationFlags.
+    """
+    headers = _reject_te(
+        headers, hdr_validation_flags
+    )
+    headers = _reject_connection_header(
+        headers, hdr_validation_flags
+    )
+    headers = _reject_pseudo_header_fields(
+        headers, hdr_validation_flags
+    )
+    headers = _check_sent_host_authority_header(
+        headers, hdr_validation_flags
+    )
+    headers = _check_path_header(headers, hdr_validation_flags)
+
+    return headers
+
+
+class SizeLimitDict(collections.OrderedDict):
+
+    def __init__(self, *args, **kwargs):
+        self._size_limit = kwargs.pop("size_limit", None)
+        super(SizeLimitDict, self).__init__(*args, **kwargs)
+
+        self._check_size_limit()
+
+    def __setitem__(self, key, value):
+        super(SizeLimitDict, self).__setitem__(key, value)
+
+        self._check_size_limit()
+
+    def _check_size_limit(self):
+        if self._size_limit is not None:
+            while len(self) > self._size_limit:
+                self.popitem(last=False)
diff --git a/llm/Lib/site-packages/h2/windows.py b/llm/Lib/site-packages/h2/windows.py
new file mode 100644
index 0000000000000000000000000000000000000000..be4eb438b1a475fe58456a4dbe78c449de00d849
--- /dev/null
+++ b/llm/Lib/site-packages/h2/windows.py
@@ -0,0 +1,139 @@
+# -*- coding: utf-8 -*-
+"""
+h2/windows
+~~~~~~~~~~
+
+Defines tools for managing HTTP/2 flow control windows.
+
+The objects defined in this module are used to automatically manage HTTP/2
+flow control windows. Specifically, they keep track of what the size of the
+window is, how much data has been consumed from that window, and how much data
+the user has already used. It then implements a basic algorithm that attempts
+to manage the flow control window without user input, trying to ensure that it
+does not emit too many WINDOW_UPDATE frames.
+"""
+from __future__ import division
+
+from .exceptions import FlowControlError
+
+
+# The largest acceptable value for a HTTP/2 flow control window.
+LARGEST_FLOW_CONTROL_WINDOW = 2**31 - 1
+
+
+class WindowManager:
+    """
+    A basic HTTP/2 window manager.
+
+    :param max_window_size: The maximum size of the flow control window.
+    :type max_window_size: ``int``
+    """
+    def __init__(self, max_window_size):
+        assert max_window_size <= LARGEST_FLOW_CONTROL_WINDOW
+        self.max_window_size = max_window_size
+        self.current_window_size = max_window_size
+        self._bytes_processed = 0
+
+    def window_consumed(self, size):
+        """
+        We have received a certain number of bytes from the remote peer. This
+        necessarily shrinks the flow control window!
+
+        :param size: The number of flow controlled bytes we received from the
+            remote peer.
+        :type size: ``int``
+        :returns: Nothing.
+        :rtype: ``None``
+        """
+        self.current_window_size -= size
+        if self.current_window_size < 0:
+            raise FlowControlError("Flow control window shrunk below 0")
+
+    def window_opened(self, size):
+        """
+        The flow control window has been incremented, either because of manual
+        flow control management or because of the user changing the flow
+        control settings. This can have the effect of increasing what we
+        consider to be the "maximum" flow control window size.
+
+        This does not increase our view of how many bytes have been processed,
+        only of how much space is in the window.
+
+        :param size: The increment to the flow control window we received.
+        :type size: ``int``
+        :returns: Nothing
+        :rtype: ``None``
+        """
+        self.current_window_size += size
+
+        if self.current_window_size > LARGEST_FLOW_CONTROL_WINDOW:
+            raise FlowControlError(
+                "Flow control window mustn't exceed %d" %
+                LARGEST_FLOW_CONTROL_WINDOW
+            )
+
+        if self.current_window_size > self.max_window_size:
+            self.max_window_size = self.current_window_size
+
+    def process_bytes(self, size):
+        """
+        The application has informed us that it has processed a certain number
+        of bytes. This may cause us to want to emit a window update frame. If
+        we do want to emit a window update frame, this method will return the
+        number of bytes that we should increment the window by.
+
+        :param size: The number of flow controlled bytes that the application
+            has processed.
+        :type size: ``int``
+        :returns: The number of bytes to increment the flow control window by,
+            or ``None``.
+        :rtype: ``int`` or ``None``
+        """
+        self._bytes_processed += size
+        return self._maybe_update_window()
+
+    def _maybe_update_window(self):
+        """
+        Run the algorithm.
+
+        Our current algorithm can be described like this.
+
+        1. If no bytes have been processed, we immediately return 0. There is
+           no meaningful way for us to hand space in the window back to the
+           remote peer, so let's not even try.
+        2. If there is no space in the flow control window, and we have
+           processed at least 1024 bytes (or 1/4 of the window, if the window
+           is smaller), we will emit a window update frame. This is to avoid
+           the risk of blocking a stream altogether.
+        3. If there is space in the flow control window, and we have processed
+           at least 1/2 of the window worth of bytes, we will emit a window
+           update frame. This is to minimise the number of window update frames
+           we have to emit.
+
+        In a healthy system with large flow control windows, this will
+        irregularly emit WINDOW_UPDATE frames. This prevents us starving the
+        connection by emitting eleventy bajillion WINDOW_UPDATE frames,
+        especially in situations where the remote peer is sending a lot of very
+        small DATA frames.
+        """
+        # TODO: Can the window be smaller than 1024 bytes? If not, we can
+        # streamline this algorithm.
+        if not self._bytes_processed:
+            return None
+
+        max_increment = (self.max_window_size - self.current_window_size)
+        increment = 0
+
+        # Note that, even though we may increment less than _bytes_processed,
+        # we still want to set it to zero whenever we emit an increment. This
+        # is because we'll always increment up to the maximum we can.
+        if (self.current_window_size == 0) and (
+                self._bytes_processed > min(1024, self.max_window_size // 4)):
+            increment = min(self._bytes_processed, max_increment)
+            self._bytes_processed = 0
+        elif self._bytes_processed >= (self.max_window_size // 2):
+            increment = min(self._bytes_processed, max_increment)
+            self._bytes_processed = 0
+
+        self.current_window_size += increment
+        return increment
diff --git a/llm/Lib/site-packages/hpack-4.0.0.dist-info/INSTALLER b/llm/Lib/site-packages/hpack-4.0.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/hpack-4.0.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/hpack-4.0.0.dist-info/LICENSE b/llm/Lib/site-packages/hpack-4.0.0.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..d24c351e1889b5b7837e4c9c1dc59334191c7f2c
--- /dev/null
+++ b/llm/Lib/site-packages/hpack-4.0.0.dist-info/LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Cory Benfield
+
+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
+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.
diff --git a/llm/Lib/site-packages/hpack-4.0.0.dist-info/METADATA b/llm/Lib/site-packages/hpack-4.0.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..bda8b9e3bb8d9ea7990eba7897c881447d5ec60c
--- /dev/null
+++ b/llm/Lib/site-packages/hpack-4.0.0.dist-info/METADATA
@@ -0,0 +1,69 @@
+Metadata-Version: 2.1
+Name: hpack
+Version: 4.0.0
+Summary: Pure-Python HPACK header compression
+Home-page: https://github.com/python-hyper/hpack
+Author: Cory Benfield
+Author-email: cory@lukasa.co.uk
+License: MIT License
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.6.1
+Description-Content-Type: text/x-rst
+
+========================================
+hpack: HTTP/2 Header Encoding for Python
+========================================
+
+.. image:: https://github.com/python-hyper/hpack/workflows/CI/badge.svg
+    :target: https://github.com/python-hyper/hpack/actions
+    :alt: Build Status
+.. image:: https://codecov.io/gh/python-hyper/hpack/branch/master/graph/badge.svg
+    :target: https://codecov.io/gh/python-hyper/hpack
+    :alt: Code Coverage
+.. image:: https://readthedocs.org/projects/hpack/badge/?version=latest
+    :target: https://hpack.readthedocs.io/en/latest/
+    :alt: Documentation Status
+.. image:: https://img.shields.io/badge/chat-join_now-brightgreen.svg
+    :target: https://gitter.im/python-hyper/community
+    :alt: Chat community
+
+.. image:: https://raw.github.com/Lukasa/hyper/development/docs/source/images/hyper.png
+
+This module contains a pure-Python HTTP/2 header encoding (HPACK) logic for use
+in Python programs that implement HTTP/2.
+
+Contributing
+============
+
+``hpack`` welcomes contributions from anyone! Unlike many other projects we are
+happy to accept cosmetic contributions and small contributions, in addition to
+large feature requests and changes.
+
+Before you contribute (either by opening an issue or filing a pull request),
+please `read the contribution guidelines`_.
+
+.. _read the contribution guidelines: http://hyper.readthedocs.org/en/development/contributing.html
+
+License
+=======
+
+``hpack`` is made available under the MIT License. For more details, see the
+``LICENSE`` file in the repository.
+
+Authors
+=======
+
+``hpack`` is maintained by Cory Benfield, with contributions from others. For
+more details about the contributors, please see ``CONTRIBUTORS.rst``.
+
+
diff --git a/llm/Lib/site-packages/hpack-4.0.0.dist-info/RECORD b/llm/Lib/site-packages/hpack-4.0.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..2c992cecd0fdabab8f73020618c4422c59d1414f
--- /dev/null
+++ b/llm/Lib/site-packages/hpack-4.0.0.dist-info/RECORD
@@ -0,0 +1,22 @@
+hpack-4.0.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+hpack-4.0.0.dist-info/LICENSE,sha256=djqTQqBN9iBGydx0ilKHk06wpTMcaGOzygruIOGMtO0,1080
+hpack-4.0.0.dist-info/METADATA,sha256=qvjQZKJbV8sOvv6Xp_6VPcp_zuJMWUg81Q5XQYNoyEI,2533
+hpack-4.0.0.dist-info/RECORD,,
+hpack-4.0.0.dist-info/WHEEL,sha256=g4nMs7d-Xl9-xC9XovUrsDHGXt-FT0E17Yqo92DEfvY,92
+hpack-4.0.0.dist-info/top_level.txt,sha256=nyrZLbQo-0nC6ot3YO_109pkUiTtK1M0wUJfLHuQceE,6
+hpack/__init__.py,sha256=1v7RdDmqOTWOFJ4WulrMdwHNBfQNjP0XRlpw5KFya3U,568
+hpack/__pycache__/__init__.cpython-311.pyc,,
+hpack/__pycache__/exceptions.cpython-311.pyc,,
+hpack/__pycache__/hpack.cpython-311.pyc,,
+hpack/__pycache__/huffman.cpython-311.pyc,,
+hpack/__pycache__/huffman_constants.cpython-311.pyc,,
+hpack/__pycache__/huffman_table.cpython-311.pyc,,
+hpack/__pycache__/struct.cpython-311.pyc,,
+hpack/__pycache__/table.cpython-311.pyc,,
+hpack/exceptions.py,sha256=Rrw1Fke5Cfq72OwvwrnS6JucBvw3_bxu3o_ujtAUlrM,974
+hpack/hpack.py,sha256=qoOPcsqMdE6DzqIIoxs-UY-rvMzPn4AStqhFfbHzUBw,22683
+hpack/huffman.py,sha256=0efgsl0EjRoRCI0PuX8G9yK4P48dmOSD5pepMbkxSTY,2443
+hpack/huffman_constants.py,sha256=in1pbqU6HktjFwQ5gltrXZVdL3U4k_QstG9rIQgBWzM,4643
+hpack/huffman_table.py,sha256=5yijIuaylIePwkbhWMXKf3EXspeXKY7hakpvPdSRJkg,168580
+hpack/struct.py,sha256=gw7oxmlVzXyzVEV4Y6uvS3wnGrJ0zOljqH-xLpJqWZc,1050
+hpack/table.py,sha256=kC8SweTJIH3jB_qlEJj069jOkEYQGzQHhwELr-RnGkM,9635
diff --git a/llm/Lib/site-packages/hpack-4.0.0.dist-info/WHEEL b/llm/Lib/site-packages/hpack-4.0.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..b552003ff90e66227ec90d1b159324f140d46001
--- /dev/null
+++ b/llm/Lib/site-packages/hpack-4.0.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/hpack-4.0.0.dist-info/top_level.txt b/llm/Lib/site-packages/hpack-4.0.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..1a0ac4833c6b9b27b4cfd97532cc851564a15a29
--- /dev/null
+++ b/llm/Lib/site-packages/hpack-4.0.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+hpack
diff --git a/llm/Lib/site-packages/hpack/__init__.py b/llm/Lib/site-packages/hpack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..fc26ac5a563768194650ff3a27b9d524756da313
--- /dev/null
+++ b/llm/Lib/site-packages/hpack/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+"""
+hpack
+~~~~~
+
+HTTP/2 header encoding for Python.
+"""
+from .hpack import Encoder, Decoder
+from .struct import HeaderTuple, NeverIndexedHeaderTuple
+from .exceptions import (
+    HPACKError,
+    HPACKDecodingError,
+    InvalidTableIndex,
+    OversizedHeaderListError,
+    InvalidTableSizeError
+)
+
+__all__ = [
+    'Encoder',
+    'Decoder',
+    'HeaderTuple',
+    'NeverIndexedHeaderTuple',
+    'HPACKError',
+    'HPACKDecodingError',
+    'InvalidTableIndex',
+    'OversizedHeaderListError',
+    'InvalidTableSizeError',
+]
+
+__version__ = '4.0.0'
diff --git a/llm/Lib/site-packages/hpack/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/hpack/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ba19055e350c1c17ac48e4eca4f5cda8334b8ed5
Binary files /dev/null and b/llm/Lib/site-packages/hpack/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/hpack/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/hpack/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..af86d693718bfddab3529d8f8a256bf8d70821c7
Binary files /dev/null and b/llm/Lib/site-packages/hpack/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/hpack/__pycache__/hpack.cpython-311.pyc b/llm/Lib/site-packages/hpack/__pycache__/hpack.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..da5bfb82aef69c1cdf9260259483206c266657b1
Binary files /dev/null and b/llm/Lib/site-packages/hpack/__pycache__/hpack.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/hpack/__pycache__/huffman.cpython-311.pyc b/llm/Lib/site-packages/hpack/__pycache__/huffman.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c3eea5fdebe2b5b9cc8c6365bec110835b8952a1
Binary files /dev/null and b/llm/Lib/site-packages/hpack/__pycache__/huffman.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/hpack/__pycache__/huffman_constants.cpython-311.pyc b/llm/Lib/site-packages/hpack/__pycache__/huffman_constants.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d6db8fc764228512be4f0ddd443fc9902cc867ea
Binary files /dev/null and b/llm/Lib/site-packages/hpack/__pycache__/huffman_constants.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/hpack/__pycache__/huffman_table.cpython-311.pyc b/llm/Lib/site-packages/hpack/__pycache__/huffman_table.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6412e9cf58186ce4dc478f6080815b281b0f6757
Binary files /dev/null and b/llm/Lib/site-packages/hpack/__pycache__/huffman_table.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/hpack/__pycache__/struct.cpython-311.pyc b/llm/Lib/site-packages/hpack/__pycache__/struct.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e1d8d165e3bf9b6d347e10f0eb9ef56040792d8
Binary files /dev/null and b/llm/Lib/site-packages/hpack/__pycache__/struct.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/hpack/__pycache__/table.cpython-311.pyc b/llm/Lib/site-packages/hpack/__pycache__/table.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5954361306cde1621467f9e21eb99ba2841336d8
Binary files /dev/null and b/llm/Lib/site-packages/hpack/__pycache__/table.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/hpack/exceptions.py b/llm/Lib/site-packages/hpack/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..571ba98f2cbfcfcb6ae9e19c28501a0a3b2566f1
--- /dev/null
+++ b/llm/Lib/site-packages/hpack/exceptions.py
@@ -0,0 +1,49 @@
+# -*- coding: utf-8 -*-
+"""
+hyper/http20/exceptions
+~~~~~~~~~~~~~~~~~~~~~~~
+
+This defines exceptions used in the HTTP/2 portion of hyper.
+"""
+
+
+class HPACKError(Exception):
+    """
+    The base class for all ``hpack`` exceptions.
+    """
+    pass
+
+
+class HPACKDecodingError(HPACKError):
+    """
+    An error has been encountered while performing HPACK decoding.
+    """
+    pass
+
+
+class InvalidTableIndex(HPACKDecodingError):
+    """
+    An invalid table index was received.
+    """
+    pass
+
+
+class OversizedHeaderListError(HPACKDecodingError):
+    """
+    A header list that was larger than we allow has been received. This may be
+    a DoS attack.
+
+    .. versionadded:: 2.3.0
+    """
+    pass
+
+
+class InvalidTableSizeError(HPACKDecodingError):
+    """
+    An attempt was made to change the decoder table size to a value larger than
+    allowed, or the list was shrunk and the remote peer didn't shrink their
+    table size.
+
+    .. versionadded:: 3.0.0
+    """
+    pass
diff --git a/llm/Lib/site-packages/hpack/hpack.py b/llm/Lib/site-packages/hpack/hpack.py
new file mode 100644
index 0000000000000000000000000000000000000000..cc39bfd6fca65b8b3cc0433e205a0e6e791849b0
--- /dev/null
+++ b/llm/Lib/site-packages/hpack/hpack.py
@@ -0,0 +1,633 @@
+# -*- coding: utf-8 -*-
+"""
+hpack/hpack
+~~~~~~~~~~~
+
+Implements the HPACK header compression algorithm as detailed by the IETF.
+"""
+import logging
+
+from .table import HeaderTable, table_entry_size
+from .exceptions import (
+    HPACKDecodingError, OversizedHeaderListError, InvalidTableSizeError
+)
+from .huffman import HuffmanEncoder
+from .huffman_constants import (
+    REQUEST_CODES, REQUEST_CODES_LENGTH
+)
+from .huffman_table import decode_huffman
+from .struct import HeaderTuple, NeverIndexedHeaderTuple
+
+log = logging.getLogger(__name__)
+
+INDEX_NONE = b'\x00'
+INDEX_NEVER = b'\x10'
+INDEX_INCREMENTAL = b'\x40'
+
+# Precompute 2^i for 1-8 for use in prefix calcs.
+# Zero index is not used but there to save a subtraction
+# as prefix numbers are not zero indexed.
+_PREFIX_BIT_MAX_NUMBERS = [(2 ** i) - 1 for i in range(9)]
+
+try:  # pragma: no cover
+    basestring = basestring
+except NameError:  # pragma: no cover
+    basestring = (str, bytes)
+
+
+# We default the maximum header list we're willing to accept to 64kB. That's a
+# lot of headers, but if applications want to raise it they can do.
+DEFAULT_MAX_HEADER_LIST_SIZE = 2 ** 16
+
+
+def _unicode_if_needed(header, raw):
+    """
+    Provides a header as a unicode string if raw is False, otherwise returns
+    it as a bytestring.
+    """
+    name = bytes(header[0])
+    value = bytes(header[1])
+    if not raw:
+        name = name.decode('utf-8')
+        value = value.decode('utf-8')
+    return header.__class__(name, value)
+
+
+def encode_integer(integer, prefix_bits):
+    """
+    This encodes an integer according to the wacky integer encoding rules
+    defined in the HPACK spec.
+    """
+    log.debug("Encoding %d with %d bits", integer, prefix_bits)
+
+    if integer < 0:
+        raise ValueError(
+            "Can only encode positive integers, got %s" % integer
+        )
+
+    if prefix_bits < 1 or prefix_bits > 8:
+        raise ValueError(
+            "Prefix bits must be between 1 and 8, got %s" % prefix_bits
+        )
+
+    max_number = _PREFIX_BIT_MAX_NUMBERS[prefix_bits]
+
+    if integer < max_number:
+        return bytearray([integer])  # Seriously?
+    else:
+        elements = [max_number]
+        integer -= max_number
+
+        while integer >= 128:
+            elements.append((integer & 127) + 128)
+            integer >>= 7
+
+        elements.append(integer)
+
+        return bytearray(elements)
+
+
+def decode_integer(data, prefix_bits):
+    """
+    This decodes an integer according to the wacky integer encoding rules
+    defined in the HPACK spec. Returns a tuple of the decoded integer and the
+    number of bytes that were consumed from ``data`` in order to get that
+    integer.
+    """
+    if prefix_bits < 1 or prefix_bits > 8:
+        raise ValueError(
+            "Prefix bits must be between 1 and 8, got %s" % prefix_bits
+        )
+
+    max_number = _PREFIX_BIT_MAX_NUMBERS[prefix_bits]
+    index = 1
+    shift = 0
+    mask = (0xFF >> (8 - prefix_bits))
+
+    try:
+        number = data[0] & mask
+        if number == max_number:
+            while True:
+                next_byte = data[index]
+                index += 1
+
+                if next_byte >= 128:
+                    number += (next_byte - 128) << shift
+                else:
+                    number += next_byte << shift
+                    break
+                shift += 7
+
+    except IndexError:
+        raise HPACKDecodingError(
+            "Unable to decode HPACK integer representation from %r" % data
+        )
+
+    log.debug("Decoded %d, consumed %d bytes", number, index)
+
+    return number, index
+
+
+def _dict_to_iterable(header_dict):
+    """
+    This converts a dictionary to an iterable of two-tuples. This is a
+    HPACK-specific function because it pulls "special-headers" out first and
+    then emits them.
+    """
+    assert isinstance(header_dict, dict)
+    keys = sorted(
+        header_dict.keys(),
+        key=lambda k: not _to_bytes(k).startswith(b':')
+    )
+    for key in keys:
+        yield key, header_dict[key]
+
+
+def _to_bytes(string):
+    """
+    Convert string to bytes.
+    """
+    if not isinstance(string, basestring):  # pragma: no cover
+        string = str(string)
+
+    return string if isinstance(string, bytes) else string.encode('utf-8')
+
+
+class Encoder:
+    """
+    An HPACK encoder object. This object takes HTTP headers and emits encoded
+    HTTP/2 header blocks.
+    """
+
+    def __init__(self):
+        self.header_table = HeaderTable()
+        self.huffman_coder = HuffmanEncoder(
+            REQUEST_CODES, REQUEST_CODES_LENGTH
+        )
+        self.table_size_changes = []
+
+    @property
+    def header_table_size(self):
+        """
+        Controls the size of the HPACK header table.
+        """
+        return self.header_table.maxsize
+
+    @header_table_size.setter
+    def header_table_size(self, value):
+        self.header_table.maxsize = value
+        if self.header_table.resized:
+            self.table_size_changes.append(value)
+
+    def encode(self, headers, huffman=True):
+        """
+        Takes a set of headers and encodes them into a HPACK-encoded header
+        block.
+
+        :param headers: The headers to encode. Must be either an iterable of
+                        tuples, an iterable of :class:`HeaderTuple
+                        <hpack.HeaderTuple>`, or a ``dict``.
+
+                        If an iterable of tuples, the tuples may be either
+                        two-tuples or three-tuples. If they are two-tuples, the
+                        tuples must be of the format ``(name, value)``. If they
+                        are three-tuples, they must be of the format
+                        ``(name, value, sensitive)``, where ``sensitive`` is a
+                        boolean value indicating whether the header should be
+                        added to header tables anywhere. If not present,
+                        ``sensitive`` defaults to ``False``.
+
+                        If an iterable of :class:`HeaderTuple
+                        <hpack.HeaderTuple>`, the tuples must always be
+                        two-tuples. Instead of using ``sensitive`` as a third
+                        tuple entry, use :class:`NeverIndexedHeaderTuple
+                        <hpack.NeverIndexedHeaderTuple>` to request that
+                        the field never be indexed.
+
+                        .. warning:: HTTP/2 requires that all special headers
+                            (headers whose names begin with ``:`` characters)
+                            appear at the *start* of the header block. While
+                            this method will ensure that happens for ``dict``
+                            subclasses, callers using any other iterable of
+                            tuples **must** ensure they place their special
+                            headers at the start of the iterable.
+
+                            For efficiency reasons users should prefer to use
+                            iterables of two-tuples: fixing the ordering of
+                            dictionary headers is an expensive operation that
+                            should be avoided if possible.
+
+        :param huffman: (optional) Whether to Huffman-encode any header sent as
+                        a literal value. Except for use when debugging, it is
+                        recommended that this be left enabled.
+
+        :returns: A bytestring containing the HPACK-encoded header block.
+        """
+        # Transforming the headers into a header block is a procedure that can
+        # be modeled as a chain or pipe. First, the headers are encoded. This
+        # encoding can be done a number of ways. If the header name-value pair
+        # are already in the header table we can represent them using the
+        # indexed representation: the same is true if they are in the static
+        # table. Otherwise, a literal representation will be used.
+        header_block = []
+
+        # Turn the headers into a list of tuples if possible. This is the
+        # natural way to interact with them in HPACK. Because dictionaries are
+        # un-ordered, we need to make sure we grab the "special" headers first.
+        if isinstance(headers, dict):
+            headers = _dict_to_iterable(headers)
+
+        # Before we begin, if the header table size has been changed we need
+        # to signal all changes since last emission appropriately.
+        if self.header_table.resized:
+            header_block.append(self._encode_table_size_change())
+            self.header_table.resized = False
+
+        # Add each header to the header block
+        for header in headers:
+            sensitive = False
+            if isinstance(header, HeaderTuple):
+                sensitive = not header.indexable
+            elif len(header) > 2:
+                sensitive = header[2]
+
+            header = (_to_bytes(header[0]), _to_bytes(header[1]))
+            header_block.append(self.add(header, sensitive, huffman))
+
+        header_block = b''.join(header_block)
+
+        log.debug("Encoded header block to %s", header_block)
+
+        return header_block
+
+    def add(self, to_add, sensitive, huffman=False):
+        """
+        This function takes a header key-value tuple and serializes it.
+        """
+        log.debug(
+            "Adding %s to the header table, sensitive:%s, huffman:%s",
+            to_add,
+            sensitive,
+            huffman
+        )
+
+        name, value = to_add
+
+        # Set our indexing mode
+        indexbit = INDEX_INCREMENTAL if not sensitive else INDEX_NEVER
+
+        # Search for a matching header in the header table.
+        match = self.header_table.search(name, value)
+
+        if match is None:
+            # Not in the header table. Encode using the literal syntax,
+            # and add it to the header table.
+            encoded = self._encode_literal(name, value, indexbit, huffman)
+            if not sensitive:
+                self.header_table.add(name, value)
+            return encoded
+
+        # The header is in the table, break out the values. If we matched
+        # perfectly, we can use the indexed representation: otherwise we
+        # can use the indexed literal.
+        index, name, perfect = match
+
+        if perfect:
+            # Indexed representation.
+            encoded = self._encode_indexed(index)
+        else:
+            # Indexed literal. We are going to add header to the
+            # header table unconditionally. It is a future todo to
+            # filter out headers which are known to be ineffective for
+            # indexing since they just take space in the table and
+            # pushed out other valuable headers.
+            encoded = self._encode_indexed_literal(
+                index, value, indexbit, huffman
+            )
+            if not sensitive:
+                self.header_table.add(name, value)
+
+        return encoded
+
+    def _encode_indexed(self, index):
+        """
+        Encodes a header using the indexed representation.
+        """
+        field = encode_integer(index, 7)
+        field[0] |= 0x80  # we set the top bit
+        return bytes(field)
+
+    def _encode_literal(self, name, value, indexbit, huffman=False):
+        """
+        Encodes a header with a literal name and literal value. If ``indexing``
+        is True, the header will be added to the header table: otherwise it
+        will not.
+        """
+        if huffman:
+            name = self.huffman_coder.encode(name)
+            value = self.huffman_coder.encode(value)
+
+        name_len = encode_integer(len(name), 7)
+        value_len = encode_integer(len(value), 7)
+
+        if huffman:
+            name_len[0] |= 0x80
+            value_len[0] |= 0x80
+
+        return b''.join(
+            [indexbit, bytes(name_len), name, bytes(value_len), value]
+        )
+
+    def _encode_indexed_literal(self, index, value, indexbit, huffman=False):
+        """
+        Encodes a header with an indexed name and a literal value and performs
+        incremental indexing.
+        """
+        if indexbit != INDEX_INCREMENTAL:
+            prefix = encode_integer(index, 4)
+        else:
+            prefix = encode_integer(index, 6)
+
+        prefix[0] |= ord(indexbit)
+
+        if huffman:
+            value = self.huffman_coder.encode(value)
+
+        value_len = encode_integer(len(value), 7)
+
+        if huffman:
+            value_len[0] |= 0x80
+
+        return b''.join([bytes(prefix), bytes(value_len), value])
+
+    def _encode_table_size_change(self):
+        """
+        Produces the encoded form of all header table size change context
+        updates.
+        """
+        block = b''
+        for size_bytes in self.table_size_changes:
+            size_bytes = encode_integer(size_bytes, 5)
+            size_bytes[0] |= 0x20
+            block += bytes(size_bytes)
+        self.table_size_changes = []
+        return block
+
+
+class Decoder:
+    """
+    An HPACK decoder object.
+
+    .. versionchanged:: 2.3.0
+       Added ``max_header_list_size`` argument.
+
+    :param max_header_list_size: The maximum decompressed size we will allow
+        for any single header block. This is a protection against DoS attacks
+        that attempt to force the application to expand a relatively small
+        amount of data into a really large header list, allowing enormous
+        amounts of memory to be allocated.
+
+        If this amount of data is exceeded, a `OversizedHeaderListError
+        <hpack.OversizedHeaderListError>` exception will be raised. At this
+        point the connection should be shut down, as the HPACK state will no
+        longer be usable.
+
+        Defaults to 64kB.
+    :type max_header_list_size: ``int``
+    """
+    def __init__(self, max_header_list_size=DEFAULT_MAX_HEADER_LIST_SIZE):
+        self.header_table = HeaderTable()
+
+        #: The maximum decompressed size we will allow for any single header
+        #: block. This is a protection against DoS attacks that attempt to
+        #: force the application to expand a relatively small amount of data
+        #: into a really large header list, allowing enormous amounts of memory
+        #: to be allocated.
+        #:
+        #: If this amount of data is exceeded, a `OversizedHeaderListError
+        #: <hpack.OversizedHeaderListError>` exception will be raised. At this
+        #: point the connection should be shut down, as the HPACK state will no
+        #: longer be usable.
+        #:
+        #: Defaults to 64kB.
+        #:
+        #: .. versionadded:: 2.3.0
+        self.max_header_list_size = max_header_list_size
+
+        #: Maximum allowed header table size.
+        #:
+        #: A HTTP/2 implementation should set this to the most recent value of
+        #: SETTINGS_HEADER_TABLE_SIZE that it sent *and has received an ACK
+        #: for*. Once this setting is set, the actual header table size will be
+        #: checked at the end of each decoding run and whenever it is changed,
+        #: to confirm that it fits in this size.
+        self.max_allowed_table_size = self.header_table.maxsize
+
+    @property
+    def header_table_size(self):
+        """
+        Controls the size of the HPACK header table.
+        """
+        return self.header_table.maxsize
+
+    @header_table_size.setter
+    def header_table_size(self, value):
+        self.header_table.maxsize = value
+
+    def decode(self, data, raw=False):
+        """
+        Takes an HPACK-encoded header block and decodes it into a header set.
+
+        :param data: A bytestring representing a complete HPACK-encoded header
+                     block.
+        :param raw: (optional) Whether to return the headers as tuples of raw
+                    byte strings or to decode them as UTF-8 before returning
+                    them. The default value is False, which returns tuples of
+                    Unicode strings
+        :returns: A list of two-tuples of ``(name, value)`` representing the
+                  HPACK-encoded headers, in the order they were decoded.
+        :raises HPACKDecodingError: If an error is encountered while decoding
+                                    the header block.
+        """
+        log.debug("Decoding %s", data)
+
+        data_mem = memoryview(data)
+        headers = []
+        data_len = len(data)
+        inflated_size = 0
+        current_index = 0
+
+        while current_index < data_len:
+            # Work out what kind of header we're decoding.
+            # If the high bit is 1, it's an indexed field.
+            current = data[current_index]
+            indexed = True if current & 0x80 else False
+
+            # Otherwise, if the second-highest bit is 1 it's a field that does
+            # alter the header table.
+            literal_index = True if current & 0x40 else False
+
+            # Otherwise, if the third-highest bit is 1 it's an encoding context
+            # update.
+            encoding_update = True if current & 0x20 else False
+
+            if indexed:
+                header, consumed = self._decode_indexed(
+                    data_mem[current_index:]
+                )
+            elif literal_index:
+                # It's a literal header that does affect the header table.
+                header, consumed = self._decode_literal_index(
+                    data_mem[current_index:]
+                )
+            elif encoding_update:
+                # It's an update to the encoding context. These are forbidden
+                # in a header block after any actual header.
+                if headers:
+                    raise HPACKDecodingError(
+                        "Table size update not at the start of the block"
+                    )
+                consumed = self._update_encoding_context(
+                    data_mem[current_index:]
+                )
+                header = None
+            else:
+                # It's a literal header that does not affect the header table.
+                header, consumed = self._decode_literal_no_index(
+                    data_mem[current_index:]
+                )
+
+            if header:
+                headers.append(header)
+                inflated_size += table_entry_size(*header)
+
+                if inflated_size > self.max_header_list_size:
+                    raise OversizedHeaderListError(
+                        "A header list larger than %d has been received" %
+                        self.max_header_list_size
+                    )
+
+            current_index += consumed
+
+        # Confirm that the table size is lower than the maximum. We do this
+        # here to ensure that we catch when the max has been *shrunk* and the
+        # remote peer hasn't actually done that.
+        self._assert_valid_table_size()
+
+        try:
+            return [_unicode_if_needed(h, raw) for h in headers]
+        except UnicodeDecodeError:
+            raise HPACKDecodingError("Unable to decode headers as UTF-8.")
+
+    def _assert_valid_table_size(self):
+        """
+        Check that the table size set by the encoder is lower than the maximum
+        we expect to have.
+        """
+        if self.header_table_size > self.max_allowed_table_size:
+            raise InvalidTableSizeError(
+                "Encoder did not shrink table size to within the max"
+            )
+
+    def _update_encoding_context(self, data):
+        """
+        Handles a byte that updates the encoding context.
+        """
+        # We've been asked to resize the header table.
+        new_size, consumed = decode_integer(data, 5)
+        if new_size > self.max_allowed_table_size:
+            raise InvalidTableSizeError(
+                "Encoder exceeded max allowable table size"
+            )
+        self.header_table_size = new_size
+        return consumed
+
+    def _decode_indexed(self, data):
+        """
+        Decodes a header represented using the indexed representation.
+        """
+        index, consumed = decode_integer(data, 7)
+        header = HeaderTuple(*self.header_table.get_by_index(index))
+        log.debug("Decoded %s, consumed %d", header, consumed)
+        return header, consumed
+
+    def _decode_literal_no_index(self, data):
+        return self._decode_literal(data, False)
+
+    def _decode_literal_index(self, data):
+        return self._decode_literal(data, True)
+
+    def _decode_literal(self, data, should_index):
+        """
+        Decodes a header represented with a literal.
+        """
+        total_consumed = 0
+
+        # When should_index is true, if the low six bits of the first byte are
+        # nonzero, the header name is indexed.
+        # When should_index is false, if the low four bits of the first byte
+        # are nonzero the header name is indexed.
+        if should_index:
+            indexed_name = data[0] & 0x3F
+            name_len = 6
+            not_indexable = False
+        else:
+            high_byte = data[0]
+            indexed_name = high_byte & 0x0F
+            name_len = 4
+            not_indexable = high_byte & 0x10
+
+        if indexed_name:
+            # Indexed header name.
+            index, consumed = decode_integer(data, name_len)
+            name = self.header_table.get_by_index(index)[0]
+
+            total_consumed = consumed
+            length = 0
+        else:
+            # Literal header name. The first byte was consumed, so we need to
+            # move forward.
+            data = data[1:]
+
+            length, consumed = decode_integer(data, 7)
+            name = data[consumed:consumed + length]
+            if len(name) != length:
+                raise HPACKDecodingError("Truncated header block")
+
+            if data[0] & 0x80:
+                name = decode_huffman(name)
+            total_consumed = consumed + length + 1  # Since we moved forward 1.
+
+        data = data[consumed + length:]
+
+        # The header value is definitely length-based.
+        length, consumed = decode_integer(data, 7)
+        value = data[consumed:consumed + length]
+        if len(value) != length:
+            raise HPACKDecodingError("Truncated header block")
+
+        if data[0] & 0x80:
+            value = decode_huffman(value)
+
+        # Updated the total consumed length.
+        total_consumed += length + consumed
+
+        # If we have been told never to index the header field, encode that in
+        # the tuple we use.
+        if not_indexable:
+            header = NeverIndexedHeaderTuple(name, value)
+        else:
+            header = HeaderTuple(name, value)
+
+        # If we've been asked to index this, add it to the header table.
+        if should_index:
+            self.header_table.add(name, value)
+
+        log.debug(
+            "Decoded %s, total consumed %d bytes, indexed %s",
+            header,
+            total_consumed,
+            should_index
+        )
+
+        return header, total_consumed
diff --git a/llm/Lib/site-packages/hpack/huffman.py b/llm/Lib/site-packages/hpack/huffman.py
new file mode 100644
index 0000000000000000000000000000000000000000..595d69b6e1d63708ef5840e5b1420702c396bc9a
--- /dev/null
+++ b/llm/Lib/site-packages/hpack/huffman.py
@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*-
+"""
+hpack/huffman_decoder
+~~~~~~~~~~~~~~~~~~~~~
+
+An implementation of a bitwise prefix tree specially built for decoding
+Huffman-coded content where we already know the Huffman table.
+"""
+
+
+class HuffmanEncoder:
+    """
+    Encodes a string according to the Huffman encoding table defined in the
+    HPACK specification.
+    """
+    def __init__(self, huffman_code_list, huffman_code_list_lengths):
+        self.huffman_code_list = huffman_code_list
+        self.huffman_code_list_lengths = huffman_code_list_lengths
+
+    def encode(self, bytes_to_encode):
+        """
+        Given a string of bytes, encodes them according to the HPACK Huffman
+        specification.
+        """
+        # If handed the empty string, just immediately return.
+        if not bytes_to_encode:
+            return b''
+
+        final_num = 0
+        final_int_len = 0
+
+        # Turn each byte into its huffman code. These codes aren't necessarily
+        # octet aligned, so keep track of how far through an octet we are. To
+        # handle this cleanly, just use a single giant integer.
+        for byte in bytes_to_encode:
+            bin_int_len = self.huffman_code_list_lengths[byte]
+            bin_int = self.huffman_code_list[byte] & (
+                2 ** (bin_int_len + 1) - 1
+            )
+            final_num <<= bin_int_len
+            final_num |= bin_int
+            final_int_len += bin_int_len
+
+        # Pad out to an octet with ones.
+        bits_to_be_padded = (8 - (final_int_len % 8)) % 8
+        final_num <<= bits_to_be_padded
+        final_num |= (1 << bits_to_be_padded) - 1
+
+        # Convert the number to hex and strip off the leading '0x' and the
+        # trailing 'L', if present.
+        final_num = hex(final_num)[2:].rstrip('L')
+
+        # If this is odd, prepend a zero.
+        final_num = '0' + final_num if len(final_num) % 2 != 0 else final_num
+
+        # This number should have twice as many digits as bytes. If not, we're
+        # missing some leading zeroes. Work out how many bytes we want and how
+        # many digits we have, then add the missing zero digits to the front.
+        total_bytes = (final_int_len + bits_to_be_padded) // 8
+        expected_digits = total_bytes * 2
+
+        if len(final_num) != expected_digits:
+            missing_digits = expected_digits - len(final_num)
+            final_num = ('0' * missing_digits) + final_num
+
+        return bytes.fromhex(final_num)
diff --git a/llm/Lib/site-packages/hpack/huffman_constants.py b/llm/Lib/site-packages/hpack/huffman_constants.py
new file mode 100644
index 0000000000000000000000000000000000000000..4caf012d4fdfd817a9e13e896666b1dc2878dd91
--- /dev/null
+++ b/llm/Lib/site-packages/hpack/huffman_constants.py
@@ -0,0 +1,289 @@
+# -*- coding: utf-8 -*-
+"""
+hpack/huffman_constants
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Defines the constant Huffman table. This takes up an upsetting amount of space,
+but c'est la vie.
+"""
+# flake8: noqa
+
+REQUEST_CODES = [
+    0x1ff8,
+    0x7fffd8,
+    0xfffffe2,
+    0xfffffe3,
+    0xfffffe4,
+    0xfffffe5,
+    0xfffffe6,
+    0xfffffe7,
+    0xfffffe8,
+    0xffffea,
+    0x3ffffffc,
+    0xfffffe9,
+    0xfffffea,
+    0x3ffffffd,
+    0xfffffeb,
+    0xfffffec,
+    0xfffffed,
+    0xfffffee,
+    0xfffffef,
+    0xffffff0,
+    0xffffff1,
+    0xffffff2,
+    0x3ffffffe,
+    0xffffff3,
+    0xffffff4,
+    0xffffff5,
+    0xffffff6,
+    0xffffff7,
+    0xffffff8,
+    0xffffff9,
+    0xffffffa,
+    0xffffffb,
+    0x14,
+    0x3f8,
+    0x3f9,
+    0xffa,
+    0x1ff9,
+    0x15,
+    0xf8,
+    0x7fa,
+    0x3fa,
+    0x3fb,
+    0xf9,
+    0x7fb,
+    0xfa,
+    0x16,
+    0x17,
+    0x18,
+    0x0,
+    0x1,
+    0x2,
+    0x19,
+    0x1a,
+    0x1b,
+    0x1c,
+    0x1d,
+    0x1e,
+    0x1f,
+    0x5c,
+    0xfb,
+    0x7ffc,
+    0x20,
+    0xffb,
+    0x3fc,
+    0x1ffa,
+    0x21,
+    0x5d,
+    0x5e,
+    0x5f,
+    0x60,
+    0x61,
+    0x62,
+    0x63,
+    0x64,
+    0x65,
+    0x66,
+    0x67,
+    0x68,
+    0x69,
+    0x6a,
+    0x6b,
+    0x6c,
+    0x6d,
+    0x6e,
+    0x6f,
+    0x70,
+    0x71,
+    0x72,
+    0xfc,
+    0x73,
+    0xfd,
+    0x1ffb,
+    0x7fff0,
+    0x1ffc,
+    0x3ffc,
+    0x22,
+    0x7ffd,
+    0x3,
+    0x23,
+    0x4,
+    0x24,
+    0x5,
+    0x25,
+    0x26,
+    0x27,
+    0x6,
+    0x74,
+    0x75,
+    0x28,
+    0x29,
+    0x2a,
+    0x7,
+    0x2b,
+    0x76,
+    0x2c,
+    0x8,
+    0x9,
+    0x2d,
+    0x77,
+    0x78,
+    0x79,
+    0x7a,
+    0x7b,
+    0x7ffe,
+    0x7fc,
+    0x3ffd,
+    0x1ffd,
+    0xffffffc,
+    0xfffe6,
+    0x3fffd2,
+    0xfffe7,
+    0xfffe8,
+    0x3fffd3,
+    0x3fffd4,
+    0x3fffd5,
+    0x7fffd9,
+    0x3fffd6,
+    0x7fffda,
+    0x7fffdb,
+    0x7fffdc,
+    0x7fffdd,
+    0x7fffde,
+    0xffffeb,
+    0x7fffdf,
+    0xffffec,
+    0xffffed,
+    0x3fffd7,
+    0x7fffe0,
+    0xffffee,
+    0x7fffe1,
+    0x7fffe2,
+    0x7fffe3,
+    0x7fffe4,
+    0x1fffdc,
+    0x3fffd8,
+    0x7fffe5,
+    0x3fffd9,
+    0x7fffe6,
+    0x7fffe7,
+    0xffffef,
+    0x3fffda,
+    0x1fffdd,
+    0xfffe9,
+    0x3fffdb,
+    0x3fffdc,
+    0x7fffe8,
+    0x7fffe9,
+    0x1fffde,
+    0x7fffea,
+    0x3fffdd,
+    0x3fffde,
+    0xfffff0,
+    0x1fffdf,
+    0x3fffdf,
+    0x7fffeb,
+    0x7fffec,
+    0x1fffe0,
+    0x1fffe1,
+    0x3fffe0,
+    0x1fffe2,
+    0x7fffed,
+    0x3fffe1,
+    0x7fffee,
+    0x7fffef,
+    0xfffea,
+    0x3fffe2,
+    0x3fffe3,
+    0x3fffe4,
+    0x7ffff0,
+    0x3fffe5,
+    0x3fffe6,
+    0x7ffff1,
+    0x3ffffe0,
+    0x3ffffe1,
+    0xfffeb,
+    0x7fff1,
+    0x3fffe7,
+    0x7ffff2,
+    0x3fffe8,
+    0x1ffffec,
+    0x3ffffe2,
+    0x3ffffe3,
+    0x3ffffe4,
+    0x7ffffde,
+    0x7ffffdf,
+    0x3ffffe5,
+    0xfffff1,
+    0x1ffffed,
+    0x7fff2,
+    0x1fffe3,
+    0x3ffffe6,
+    0x7ffffe0,
+    0x7ffffe1,
+    0x3ffffe7,
+    0x7ffffe2,
+    0xfffff2,
+    0x1fffe4,
+    0x1fffe5,
+    0x3ffffe8,
+    0x3ffffe9,
+    0xffffffd,
+    0x7ffffe3,
+    0x7ffffe4,
+    0x7ffffe5,
+    0xfffec,
+    0xfffff3,
+    0xfffed,
+    0x1fffe6,
+    0x3fffe9,
+    0x1fffe7,
+    0x1fffe8,
+    0x7ffff3,
+    0x3fffea,
+    0x3fffeb,
+    0x1ffffee,
+    0x1ffffef,
+    0xfffff4,
+    0xfffff5,
+    0x3ffffea,
+    0x7ffff4,
+    0x3ffffeb,
+    0x7ffffe6,
+    0x3ffffec,
+    0x3ffffed,
+    0x7ffffe7,
+    0x7ffffe8,
+    0x7ffffe9,
+    0x7ffffea,
+    0x7ffffeb,
+    0xffffffe,
+    0x7ffffec,
+    0x7ffffed,
+    0x7ffffee,
+    0x7ffffef,
+    0x7fffff0,
+    0x3ffffee,
+    0x3fffffff,
+]
+
+REQUEST_CODES_LENGTH = [
+    13, 23, 28, 28, 28, 28, 28, 28, 28, 24, 30, 28, 28, 30, 28, 28,
+    28, 28, 28, 28, 28, 28, 30, 28, 28, 28, 28, 28, 28, 28, 28, 28,
+     6, 10, 10, 12, 13,  6,  8, 11, 10, 10,  8, 11,  8,  6,  6,  6,
+     5,  5,  5,  6,  6,  6,  6,  6,  6,  6,  7,  8, 15,  6, 12, 10,
+    13,  6,  7,  7,  7,  7,  7,  7,  7,  7,  7,  7,  7,  7,  7,  7,
+     7,  7,  7,  7,  7,  7,  7,  7,  8,  7,  8, 13, 19, 13, 14,  6,
+    15,  5,  6,  5,  6,  5,  6,  6,  6,  5,  7,  7,  6,  6,  6,  5,
+     6,  7,  6,  5,  5,  6,  7,  7,  7,  7,  7, 15, 11, 14, 13, 28,
+    20, 22, 20, 20, 22, 22, 22, 23, 22, 23, 23, 23, 23, 23, 24, 23,
+    24, 24, 22, 23, 24, 23, 23, 23, 23, 21, 22, 23, 22, 23, 23, 24,
+    22, 21, 20, 22, 22, 23, 23, 21, 23, 22, 22, 24, 21, 22, 23, 23,
+    21, 21, 22, 21, 23, 22, 23, 23, 20, 22, 22, 22, 23, 22, 22, 23,
+    26, 26, 20, 19, 22, 23, 22, 25, 26, 26, 26, 27, 27, 26, 24, 25,
+    19, 21, 26, 27, 27, 26, 27, 24, 21, 21, 26, 26, 28, 27, 27, 27,
+    20, 24, 20, 21, 22, 21, 21, 23, 22, 22, 25, 25, 24, 24, 26, 23,
+    26, 27, 26, 26, 27, 27, 27, 27, 27, 28, 27, 27, 27, 27, 27, 26,
+    30,
+]
diff --git a/llm/Lib/site-packages/hpack/huffman_table.py b/llm/Lib/site-packages/hpack/huffman_table.py
new file mode 100644
index 0000000000000000000000000000000000000000..c199ef5a3f34c8acc36a7d1e1c5b34cc87018603
--- /dev/null
+++ b/llm/Lib/site-packages/hpack/huffman_table.py
@@ -0,0 +1,4739 @@
+# -*- coding: utf-8 -*-
+"""
+hpack/huffman_table
+~~~~~~~~~~~~~~~~~~~
+
+This implementation of a Huffman decoding table for HTTP/2 is essentially a
+Python port of the work originally done for nghttp2's Huffman decoding. For
+this reason, while this file is made available under the MIT license as is the
+rest of this module, this file is undoubtedly a derivative work of the nghttp2
+file ``nghttp2_hd_huffman_data.c``, obtained from
+https://github.com/tatsuhiro-t/nghttp2/ at commit
+d2b55ad1a245e1d1964579fa3fac36ebf3939e72. That work is made available under
+the Apache 2.0 license under the following terms:
+
+    Copyright (c) 2013 Tatsuhiro Tsujikawa
+
+    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 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.
+
+The essence of this approach is that it builds a finite state machine out of
+4-bit nibbles of Huffman coded data. The input function passes 4 bits worth of
+data to the state machine each time, which uses those 4 bits of data along with
+the current accumulated state data to process the data given.
+
+For the sake of efficiency, the in-memory representation of the states,
+transitions, and result values of the state machine are represented as a long
+list containing three-tuples. This list is enormously long, and viewing it as
+an in-memory representation is not very clear, but it is laid out here in a way
+that is intended to be *somewhat* more clear.
+
+Essentially, the list is structured as 256 collections of 16 entries (one for
+each nibble) of three-tuples. Each collection is called a "node", and the
+zeroth collection is called the "root node". The state machine tracks one
+value: the "state" byte.
+
+For each nibble passed to the state machine, it first multiplies the "state"
+byte by 16 and adds the numerical value of the nibble. This number is the index
+into the large flat list.
+
+The three-tuple that is found by looking up that index consists of three
+values:
+
+- a new state value, used for subsequent decoding
+- a collection of flags, used to determine whether data is emitted or whether
+  the state machine is complete.
+- the byte value to emit, assuming that emitting a byte is required.
+
+The flags are consulted, if necessary a byte is emitted, and then the next
+nibble is used. This continues until the state machine believes it has
+completely Huffman-decoded the data.
+
+This approach has relatively little indirection, and therefore performs
+relatively well, particularly on implementations like PyPy where the cost of
+loops at the Python-level is not too expensive. The total number of loop
+iterations is 4x the number of bytes passed to the decoder.
+"""
+from .exceptions import HPACKDecodingError
+
+
+# This defines the state machine "class" at the top of the file. The reason we
+# do this is to keep the terrifing monster state table at the *bottom* of the
+# file so you don't have to actually *look* at the damn thing.
+def decode_huffman(huffman_string):
+    """
+    Given a bytestring of Huffman-encoded data for HPACK, returns a bytestring
+    of the decompressed data.
+    """
+    if not huffman_string:
+        return b''
+
+    state = 0
+    flags = 0
+    decoded_bytes = bytearray()
+
+    # Perversely, bytearrays are a lot more convenient across Python 2 and
+    # Python 3 because they behave *the same way* on both platforms. Given that
+    # we really do want numerical bytes when we iterate here, let's use a
+    # bytearray.
+    huffman_string = bytearray(huffman_string)
+
+    # This loop is unrolled somewhat. Because we use a nibble, not a byte, we
+    # need to handle each nibble twice. We unroll that: it makes the loop body
+    # a bit longer, but that's ok.
+    for input_byte in huffman_string:
+        index = (state * 16) + (input_byte >> 4)
+        state, flags, output_byte = HUFFMAN_TABLE[index]
+
+        if flags & HUFFMAN_FAIL:
+            raise HPACKDecodingError("Invalid Huffman String")
+
+        if flags & HUFFMAN_EMIT_SYMBOL:
+            decoded_bytes.append(output_byte)
+
+        index = (state * 16) + (input_byte & 0x0F)
+        state, flags, output_byte = HUFFMAN_TABLE[index]
+
+        if flags & HUFFMAN_FAIL:
+            raise HPACKDecodingError("Invalid Huffman String")
+
+        if flags & HUFFMAN_EMIT_SYMBOL:
+            decoded_bytes.append(output_byte)
+
+    if not (flags & HUFFMAN_COMPLETE):
+        raise HPACKDecodingError("Incomplete Huffman string")
+
+    return bytes(decoded_bytes)
+
+
+# Some decoder flags to control state transitions.
+HUFFMAN_COMPLETE = 1
+HUFFMAN_EMIT_SYMBOL = (1 << 1)
+HUFFMAN_FAIL = (1 << 2)
+
+# This is the monster table. Avert your eyes, children.
+HUFFMAN_TABLE = [
+    # Node 0 (Root Node, never emits symbols.)
+    (4, 0, 0),
+    (5, 0, 0),
+    (7, 0, 0),
+    (8, 0, 0),
+    (11, 0, 0),
+    (12, 0, 0),
+    (16, 0, 0),
+    (19, 0, 0),
+    (25, 0, 0),
+    (28, 0, 0),
+    (32, 0, 0),
+    (35, 0, 0),
+    (42, 0, 0),
+    (49, 0, 0),
+    (57, 0, 0),
+    (64, HUFFMAN_COMPLETE, 0),
+
+    # Node 1
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 48),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 49),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 50),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 97),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 99),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 101),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 105),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 111),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 115),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 116),
+    (13, 0, 0),
+    (14, 0, 0),
+    (17, 0, 0),
+    (18, 0, 0),
+    (20, 0, 0),
+    (21, 0, 0),
+
+    # Node 2
+    (1, HUFFMAN_EMIT_SYMBOL, 48),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 48),
+    (1, HUFFMAN_EMIT_SYMBOL, 49),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 49),
+    (1, HUFFMAN_EMIT_SYMBOL, 50),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 50),
+    (1, HUFFMAN_EMIT_SYMBOL, 97),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 97),
+    (1, HUFFMAN_EMIT_SYMBOL, 99),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 99),
+    (1, HUFFMAN_EMIT_SYMBOL, 101),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 101),
+    (1, HUFFMAN_EMIT_SYMBOL, 105),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 105),
+    (1, HUFFMAN_EMIT_SYMBOL, 111),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 111),
+
+    # Node 3
+    (2, HUFFMAN_EMIT_SYMBOL, 48),
+    (9, HUFFMAN_EMIT_SYMBOL, 48),
+    (23, HUFFMAN_EMIT_SYMBOL, 48),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 48),
+    (2, HUFFMAN_EMIT_SYMBOL, 49),
+    (9, HUFFMAN_EMIT_SYMBOL, 49),
+    (23, HUFFMAN_EMIT_SYMBOL, 49),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 49),
+    (2, HUFFMAN_EMIT_SYMBOL, 50),
+    (9, HUFFMAN_EMIT_SYMBOL, 50),
+    (23, HUFFMAN_EMIT_SYMBOL, 50),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 50),
+    (2, HUFFMAN_EMIT_SYMBOL, 97),
+    (9, HUFFMAN_EMIT_SYMBOL, 97),
+    (23, HUFFMAN_EMIT_SYMBOL, 97),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 97),
+
+    # Node 4
+    (3, HUFFMAN_EMIT_SYMBOL, 48),
+    (6, HUFFMAN_EMIT_SYMBOL, 48),
+    (10, HUFFMAN_EMIT_SYMBOL, 48),
+    (15, HUFFMAN_EMIT_SYMBOL, 48),
+    (24, HUFFMAN_EMIT_SYMBOL, 48),
+    (31, HUFFMAN_EMIT_SYMBOL, 48),
+    (41, HUFFMAN_EMIT_SYMBOL, 48),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 48),
+    (3, HUFFMAN_EMIT_SYMBOL, 49),
+    (6, HUFFMAN_EMIT_SYMBOL, 49),
+    (10, HUFFMAN_EMIT_SYMBOL, 49),
+    (15, HUFFMAN_EMIT_SYMBOL, 49),
+    (24, HUFFMAN_EMIT_SYMBOL, 49),
+    (31, HUFFMAN_EMIT_SYMBOL, 49),
+    (41, HUFFMAN_EMIT_SYMBOL, 49),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 49),
+
+    # Node 5
+    (3, HUFFMAN_EMIT_SYMBOL, 50),
+    (6, HUFFMAN_EMIT_SYMBOL, 50),
+    (10, HUFFMAN_EMIT_SYMBOL, 50),
+    (15, HUFFMAN_EMIT_SYMBOL, 50),
+    (24, HUFFMAN_EMIT_SYMBOL, 50),
+    (31, HUFFMAN_EMIT_SYMBOL, 50),
+    (41, HUFFMAN_EMIT_SYMBOL, 50),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 50),
+    (3, HUFFMAN_EMIT_SYMBOL, 97),
+    (6, HUFFMAN_EMIT_SYMBOL, 97),
+    (10, HUFFMAN_EMIT_SYMBOL, 97),
+    (15, HUFFMAN_EMIT_SYMBOL, 97),
+    (24, HUFFMAN_EMIT_SYMBOL, 97),
+    (31, HUFFMAN_EMIT_SYMBOL, 97),
+    (41, HUFFMAN_EMIT_SYMBOL, 97),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 97),
+
+    # Node 6
+    (2, HUFFMAN_EMIT_SYMBOL, 99),
+    (9, HUFFMAN_EMIT_SYMBOL, 99),
+    (23, HUFFMAN_EMIT_SYMBOL, 99),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 99),
+    (2, HUFFMAN_EMIT_SYMBOL, 101),
+    (9, HUFFMAN_EMIT_SYMBOL, 101),
+    (23, HUFFMAN_EMIT_SYMBOL, 101),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 101),
+    (2, HUFFMAN_EMIT_SYMBOL, 105),
+    (9, HUFFMAN_EMIT_SYMBOL, 105),
+    (23, HUFFMAN_EMIT_SYMBOL, 105),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 105),
+    (2, HUFFMAN_EMIT_SYMBOL, 111),
+    (9, HUFFMAN_EMIT_SYMBOL, 111),
+    (23, HUFFMAN_EMIT_SYMBOL, 111),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 111),
+
+    # Node 7
+    (3, HUFFMAN_EMIT_SYMBOL, 99),
+    (6, HUFFMAN_EMIT_SYMBOL, 99),
+    (10, HUFFMAN_EMIT_SYMBOL, 99),
+    (15, HUFFMAN_EMIT_SYMBOL, 99),
+    (24, HUFFMAN_EMIT_SYMBOL, 99),
+    (31, HUFFMAN_EMIT_SYMBOL, 99),
+    (41, HUFFMAN_EMIT_SYMBOL, 99),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 99),
+    (3, HUFFMAN_EMIT_SYMBOL, 101),
+    (6, HUFFMAN_EMIT_SYMBOL, 101),
+    (10, HUFFMAN_EMIT_SYMBOL, 101),
+    (15, HUFFMAN_EMIT_SYMBOL, 101),
+    (24, HUFFMAN_EMIT_SYMBOL, 101),
+    (31, HUFFMAN_EMIT_SYMBOL, 101),
+    (41, HUFFMAN_EMIT_SYMBOL, 101),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 101),
+
+    # Node 8
+    (3, HUFFMAN_EMIT_SYMBOL, 105),
+    (6, HUFFMAN_EMIT_SYMBOL, 105),
+    (10, HUFFMAN_EMIT_SYMBOL, 105),
+    (15, HUFFMAN_EMIT_SYMBOL, 105),
+    (24, HUFFMAN_EMIT_SYMBOL, 105),
+    (31, HUFFMAN_EMIT_SYMBOL, 105),
+    (41, HUFFMAN_EMIT_SYMBOL, 105),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 105),
+    (3, HUFFMAN_EMIT_SYMBOL, 111),
+    (6, HUFFMAN_EMIT_SYMBOL, 111),
+    (10, HUFFMAN_EMIT_SYMBOL, 111),
+    (15, HUFFMAN_EMIT_SYMBOL, 111),
+    (24, HUFFMAN_EMIT_SYMBOL, 111),
+    (31, HUFFMAN_EMIT_SYMBOL, 111),
+    (41, HUFFMAN_EMIT_SYMBOL, 111),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 111),
+
+    # Node 9
+    (1, HUFFMAN_EMIT_SYMBOL, 115),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 115),
+    (1, HUFFMAN_EMIT_SYMBOL, 116),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 116),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 32),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 37),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 45),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 46),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 47),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 51),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 52),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 53),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 54),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 55),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 56),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 57),
+
+    # Node 10
+    (2, HUFFMAN_EMIT_SYMBOL, 115),
+    (9, HUFFMAN_EMIT_SYMBOL, 115),
+    (23, HUFFMAN_EMIT_SYMBOL, 115),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 115),
+    (2, HUFFMAN_EMIT_SYMBOL, 116),
+    (9, HUFFMAN_EMIT_SYMBOL, 116),
+    (23, HUFFMAN_EMIT_SYMBOL, 116),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 116),
+    (1, HUFFMAN_EMIT_SYMBOL, 32),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 32),
+    (1, HUFFMAN_EMIT_SYMBOL, 37),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 37),
+    (1, HUFFMAN_EMIT_SYMBOL, 45),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 45),
+    (1, HUFFMAN_EMIT_SYMBOL, 46),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 46),
+
+    # Node 11
+    (3, HUFFMAN_EMIT_SYMBOL, 115),
+    (6, HUFFMAN_EMIT_SYMBOL, 115),
+    (10, HUFFMAN_EMIT_SYMBOL, 115),
+    (15, HUFFMAN_EMIT_SYMBOL, 115),
+    (24, HUFFMAN_EMIT_SYMBOL, 115),
+    (31, HUFFMAN_EMIT_SYMBOL, 115),
+    (41, HUFFMAN_EMIT_SYMBOL, 115),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 115),
+    (3, HUFFMAN_EMIT_SYMBOL, 116),
+    (6, HUFFMAN_EMIT_SYMBOL, 116),
+    (10, HUFFMAN_EMIT_SYMBOL, 116),
+    (15, HUFFMAN_EMIT_SYMBOL, 116),
+    (24, HUFFMAN_EMIT_SYMBOL, 116),
+    (31, HUFFMAN_EMIT_SYMBOL, 116),
+    (41, HUFFMAN_EMIT_SYMBOL, 116),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 116),
+
+    # Node 12
+    (2, HUFFMAN_EMIT_SYMBOL, 32),
+    (9, HUFFMAN_EMIT_SYMBOL, 32),
+    (23, HUFFMAN_EMIT_SYMBOL, 32),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 32),
+    (2, HUFFMAN_EMIT_SYMBOL, 37),
+    (9, HUFFMAN_EMIT_SYMBOL, 37),
+    (23, HUFFMAN_EMIT_SYMBOL, 37),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 37),
+    (2, HUFFMAN_EMIT_SYMBOL, 45),
+    (9, HUFFMAN_EMIT_SYMBOL, 45),
+    (23, HUFFMAN_EMIT_SYMBOL, 45),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 45),
+    (2, HUFFMAN_EMIT_SYMBOL, 46),
+    (9, HUFFMAN_EMIT_SYMBOL, 46),
+    (23, HUFFMAN_EMIT_SYMBOL, 46),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 46),
+
+    # Node 13
+    (3, HUFFMAN_EMIT_SYMBOL, 32),
+    (6, HUFFMAN_EMIT_SYMBOL, 32),
+    (10, HUFFMAN_EMIT_SYMBOL, 32),
+    (15, HUFFMAN_EMIT_SYMBOL, 32),
+    (24, HUFFMAN_EMIT_SYMBOL, 32),
+    (31, HUFFMAN_EMIT_SYMBOL, 32),
+    (41, HUFFMAN_EMIT_SYMBOL, 32),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 32),
+    (3, HUFFMAN_EMIT_SYMBOL, 37),
+    (6, HUFFMAN_EMIT_SYMBOL, 37),
+    (10, HUFFMAN_EMIT_SYMBOL, 37),
+    (15, HUFFMAN_EMIT_SYMBOL, 37),
+    (24, HUFFMAN_EMIT_SYMBOL, 37),
+    (31, HUFFMAN_EMIT_SYMBOL, 37),
+    (41, HUFFMAN_EMIT_SYMBOL, 37),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 37),
+
+    # Node 14
+    (3, HUFFMAN_EMIT_SYMBOL, 45),
+    (6, HUFFMAN_EMIT_SYMBOL, 45),
+    (10, HUFFMAN_EMIT_SYMBOL, 45),
+    (15, HUFFMAN_EMIT_SYMBOL, 45),
+    (24, HUFFMAN_EMIT_SYMBOL, 45),
+    (31, HUFFMAN_EMIT_SYMBOL, 45),
+    (41, HUFFMAN_EMIT_SYMBOL, 45),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 45),
+    (3, HUFFMAN_EMIT_SYMBOL, 46),
+    (6, HUFFMAN_EMIT_SYMBOL, 46),
+    (10, HUFFMAN_EMIT_SYMBOL, 46),
+    (15, HUFFMAN_EMIT_SYMBOL, 46),
+    (24, HUFFMAN_EMIT_SYMBOL, 46),
+    (31, HUFFMAN_EMIT_SYMBOL, 46),
+    (41, HUFFMAN_EMIT_SYMBOL, 46),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 46),
+
+    # Node 15
+    (1, HUFFMAN_EMIT_SYMBOL, 47),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 47),
+    (1, HUFFMAN_EMIT_SYMBOL, 51),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 51),
+    (1, HUFFMAN_EMIT_SYMBOL, 52),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 52),
+    (1, HUFFMAN_EMIT_SYMBOL, 53),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 53),
+    (1, HUFFMAN_EMIT_SYMBOL, 54),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 54),
+    (1, HUFFMAN_EMIT_SYMBOL, 55),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 55),
+    (1, HUFFMAN_EMIT_SYMBOL, 56),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 56),
+    (1, HUFFMAN_EMIT_SYMBOL, 57),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 57),
+
+    # Node 16
+    (2, HUFFMAN_EMIT_SYMBOL, 47),
+    (9, HUFFMAN_EMIT_SYMBOL, 47),
+    (23, HUFFMAN_EMIT_SYMBOL, 47),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 47),
+    (2, HUFFMAN_EMIT_SYMBOL, 51),
+    (9, HUFFMAN_EMIT_SYMBOL, 51),
+    (23, HUFFMAN_EMIT_SYMBOL, 51),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 51),
+    (2, HUFFMAN_EMIT_SYMBOL, 52),
+    (9, HUFFMAN_EMIT_SYMBOL, 52),
+    (23, HUFFMAN_EMIT_SYMBOL, 52),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 52),
+    (2, HUFFMAN_EMIT_SYMBOL, 53),
+    (9, HUFFMAN_EMIT_SYMBOL, 53),
+    (23, HUFFMAN_EMIT_SYMBOL, 53),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 53),
+
+    # Node 17
+    (3, HUFFMAN_EMIT_SYMBOL, 47),
+    (6, HUFFMAN_EMIT_SYMBOL, 47),
+    (10, HUFFMAN_EMIT_SYMBOL, 47),
+    (15, HUFFMAN_EMIT_SYMBOL, 47),
+    (24, HUFFMAN_EMIT_SYMBOL, 47),
+    (31, HUFFMAN_EMIT_SYMBOL, 47),
+    (41, HUFFMAN_EMIT_SYMBOL, 47),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 47),
+    (3, HUFFMAN_EMIT_SYMBOL, 51),
+    (6, HUFFMAN_EMIT_SYMBOL, 51),
+    (10, HUFFMAN_EMIT_SYMBOL, 51),
+    (15, HUFFMAN_EMIT_SYMBOL, 51),
+    (24, HUFFMAN_EMIT_SYMBOL, 51),
+    (31, HUFFMAN_EMIT_SYMBOL, 51),
+    (41, HUFFMAN_EMIT_SYMBOL, 51),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 51),
+
+    # Node 18
+    (3, HUFFMAN_EMIT_SYMBOL, 52),
+    (6, HUFFMAN_EMIT_SYMBOL, 52),
+    (10, HUFFMAN_EMIT_SYMBOL, 52),
+    (15, HUFFMAN_EMIT_SYMBOL, 52),
+    (24, HUFFMAN_EMIT_SYMBOL, 52),
+    (31, HUFFMAN_EMIT_SYMBOL, 52),
+    (41, HUFFMAN_EMIT_SYMBOL, 52),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 52),
+    (3, HUFFMAN_EMIT_SYMBOL, 53),
+    (6, HUFFMAN_EMIT_SYMBOL, 53),
+    (10, HUFFMAN_EMIT_SYMBOL, 53),
+    (15, HUFFMAN_EMIT_SYMBOL, 53),
+    (24, HUFFMAN_EMIT_SYMBOL, 53),
+    (31, HUFFMAN_EMIT_SYMBOL, 53),
+    (41, HUFFMAN_EMIT_SYMBOL, 53),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 53),
+
+    # Node 19
+    (2, HUFFMAN_EMIT_SYMBOL, 54),
+    (9, HUFFMAN_EMIT_SYMBOL, 54),
+    (23, HUFFMAN_EMIT_SYMBOL, 54),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 54),
+    (2, HUFFMAN_EMIT_SYMBOL, 55),
+    (9, HUFFMAN_EMIT_SYMBOL, 55),
+    (23, HUFFMAN_EMIT_SYMBOL, 55),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 55),
+    (2, HUFFMAN_EMIT_SYMBOL, 56),
+    (9, HUFFMAN_EMIT_SYMBOL, 56),
+    (23, HUFFMAN_EMIT_SYMBOL, 56),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 56),
+    (2, HUFFMAN_EMIT_SYMBOL, 57),
+    (9, HUFFMAN_EMIT_SYMBOL, 57),
+    (23, HUFFMAN_EMIT_SYMBOL, 57),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 57),
+
+    # Node 20
+    (3, HUFFMAN_EMIT_SYMBOL, 54),
+    (6, HUFFMAN_EMIT_SYMBOL, 54),
+    (10, HUFFMAN_EMIT_SYMBOL, 54),
+    (15, HUFFMAN_EMIT_SYMBOL, 54),
+    (24, HUFFMAN_EMIT_SYMBOL, 54),
+    (31, HUFFMAN_EMIT_SYMBOL, 54),
+    (41, HUFFMAN_EMIT_SYMBOL, 54),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 54),
+    (3, HUFFMAN_EMIT_SYMBOL, 55),
+    (6, HUFFMAN_EMIT_SYMBOL, 55),
+    (10, HUFFMAN_EMIT_SYMBOL, 55),
+    (15, HUFFMAN_EMIT_SYMBOL, 55),
+    (24, HUFFMAN_EMIT_SYMBOL, 55),
+    (31, HUFFMAN_EMIT_SYMBOL, 55),
+    (41, HUFFMAN_EMIT_SYMBOL, 55),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 55),
+
+    # Node 21
+    (3, HUFFMAN_EMIT_SYMBOL, 56),
+    (6, HUFFMAN_EMIT_SYMBOL, 56),
+    (10, HUFFMAN_EMIT_SYMBOL, 56),
+    (15, HUFFMAN_EMIT_SYMBOL, 56),
+    (24, HUFFMAN_EMIT_SYMBOL, 56),
+    (31, HUFFMAN_EMIT_SYMBOL, 56),
+    (41, HUFFMAN_EMIT_SYMBOL, 56),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 56),
+    (3, HUFFMAN_EMIT_SYMBOL, 57),
+    (6, HUFFMAN_EMIT_SYMBOL, 57),
+    (10, HUFFMAN_EMIT_SYMBOL, 57),
+    (15, HUFFMAN_EMIT_SYMBOL, 57),
+    (24, HUFFMAN_EMIT_SYMBOL, 57),
+    (31, HUFFMAN_EMIT_SYMBOL, 57),
+    (41, HUFFMAN_EMIT_SYMBOL, 57),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 57),
+
+    # Node 22
+    (26, 0, 0),
+    (27, 0, 0),
+    (29, 0, 0),
+    (30, 0, 0),
+    (33, 0, 0),
+    (34, 0, 0),
+    (36, 0, 0),
+    (37, 0, 0),
+    (43, 0, 0),
+    (46, 0, 0),
+    (50, 0, 0),
+    (53, 0, 0),
+    (58, 0, 0),
+    (61, 0, 0),
+    (65, 0, 0),
+    (68, HUFFMAN_COMPLETE, 0),
+
+    # Node 23
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 61),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 65),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 95),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 98),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 100),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 102),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 103),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 104),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 108),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 109),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 110),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 112),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 114),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 117),
+    (38, 0, 0),
+    (39, 0, 0),
+
+    # Node 24
+    (1, HUFFMAN_EMIT_SYMBOL, 61),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 61),
+    (1, HUFFMAN_EMIT_SYMBOL, 65),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 65),
+    (1, HUFFMAN_EMIT_SYMBOL, 95),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 95),
+    (1, HUFFMAN_EMIT_SYMBOL, 98),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 98),
+    (1, HUFFMAN_EMIT_SYMBOL, 100),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 100),
+    (1, HUFFMAN_EMIT_SYMBOL, 102),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 102),
+    (1, HUFFMAN_EMIT_SYMBOL, 103),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 103),
+    (1, HUFFMAN_EMIT_SYMBOL, 104),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 104),
+
+    # Node 25
+    (2, HUFFMAN_EMIT_SYMBOL, 61),
+    (9, HUFFMAN_EMIT_SYMBOL, 61),
+    (23, HUFFMAN_EMIT_SYMBOL, 61),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 61),
+    (2, HUFFMAN_EMIT_SYMBOL, 65),
+    (9, HUFFMAN_EMIT_SYMBOL, 65),
+    (23, HUFFMAN_EMIT_SYMBOL, 65),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 65),
+    (2, HUFFMAN_EMIT_SYMBOL, 95),
+    (9, HUFFMAN_EMIT_SYMBOL, 95),
+    (23, HUFFMAN_EMIT_SYMBOL, 95),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 95),
+    (2, HUFFMAN_EMIT_SYMBOL, 98),
+    (9, HUFFMAN_EMIT_SYMBOL, 98),
+    (23, HUFFMAN_EMIT_SYMBOL, 98),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 98),
+
+    # Node 26
+    (3, HUFFMAN_EMIT_SYMBOL, 61),
+    (6, HUFFMAN_EMIT_SYMBOL, 61),
+    (10, HUFFMAN_EMIT_SYMBOL, 61),
+    (15, HUFFMAN_EMIT_SYMBOL, 61),
+    (24, HUFFMAN_EMIT_SYMBOL, 61),
+    (31, HUFFMAN_EMIT_SYMBOL, 61),
+    (41, HUFFMAN_EMIT_SYMBOL, 61),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 61),
+    (3, HUFFMAN_EMIT_SYMBOL, 65),
+    (6, HUFFMAN_EMIT_SYMBOL, 65),
+    (10, HUFFMAN_EMIT_SYMBOL, 65),
+    (15, HUFFMAN_EMIT_SYMBOL, 65),
+    (24, HUFFMAN_EMIT_SYMBOL, 65),
+    (31, HUFFMAN_EMIT_SYMBOL, 65),
+    (41, HUFFMAN_EMIT_SYMBOL, 65),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 65),
+
+    # Node 27
+    (3, HUFFMAN_EMIT_SYMBOL, 95),
+    (6, HUFFMAN_EMIT_SYMBOL, 95),
+    (10, HUFFMAN_EMIT_SYMBOL, 95),
+    (15, HUFFMAN_EMIT_SYMBOL, 95),
+    (24, HUFFMAN_EMIT_SYMBOL, 95),
+    (31, HUFFMAN_EMIT_SYMBOL, 95),
+    (41, HUFFMAN_EMIT_SYMBOL, 95),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 95),
+    (3, HUFFMAN_EMIT_SYMBOL, 98),
+    (6, HUFFMAN_EMIT_SYMBOL, 98),
+    (10, HUFFMAN_EMIT_SYMBOL, 98),
+    (15, HUFFMAN_EMIT_SYMBOL, 98),
+    (24, HUFFMAN_EMIT_SYMBOL, 98),
+    (31, HUFFMAN_EMIT_SYMBOL, 98),
+    (41, HUFFMAN_EMIT_SYMBOL, 98),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 98),
+
+    # Node 28
+    (2, HUFFMAN_EMIT_SYMBOL, 100),
+    (9, HUFFMAN_EMIT_SYMBOL, 100),
+    (23, HUFFMAN_EMIT_SYMBOL, 100),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 100),
+    (2, HUFFMAN_EMIT_SYMBOL, 102),
+    (9, HUFFMAN_EMIT_SYMBOL, 102),
+    (23, HUFFMAN_EMIT_SYMBOL, 102),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 102),
+    (2, HUFFMAN_EMIT_SYMBOL, 103),
+    (9, HUFFMAN_EMIT_SYMBOL, 103),
+    (23, HUFFMAN_EMIT_SYMBOL, 103),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 103),
+    (2, HUFFMAN_EMIT_SYMBOL, 104),
+    (9, HUFFMAN_EMIT_SYMBOL, 104),
+    (23, HUFFMAN_EMIT_SYMBOL, 104),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 104),
+
+    # Node 29
+    (3, HUFFMAN_EMIT_SYMBOL, 100),
+    (6, HUFFMAN_EMIT_SYMBOL, 100),
+    (10, HUFFMAN_EMIT_SYMBOL, 100),
+    (15, HUFFMAN_EMIT_SYMBOL, 100),
+    (24, HUFFMAN_EMIT_SYMBOL, 100),
+    (31, HUFFMAN_EMIT_SYMBOL, 100),
+    (41, HUFFMAN_EMIT_SYMBOL, 100),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 100),
+    (3, HUFFMAN_EMIT_SYMBOL, 102),
+    (6, HUFFMAN_EMIT_SYMBOL, 102),
+    (10, HUFFMAN_EMIT_SYMBOL, 102),
+    (15, HUFFMAN_EMIT_SYMBOL, 102),
+    (24, HUFFMAN_EMIT_SYMBOL, 102),
+    (31, HUFFMAN_EMIT_SYMBOL, 102),
+    (41, HUFFMAN_EMIT_SYMBOL, 102),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 102),
+
+    # Node 30
+    (3, HUFFMAN_EMIT_SYMBOL, 103),
+    (6, HUFFMAN_EMIT_SYMBOL, 103),
+    (10, HUFFMAN_EMIT_SYMBOL, 103),
+    (15, HUFFMAN_EMIT_SYMBOL, 103),
+    (24, HUFFMAN_EMIT_SYMBOL, 103),
+    (31, HUFFMAN_EMIT_SYMBOL, 103),
+    (41, HUFFMAN_EMIT_SYMBOL, 103),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 103),
+    (3, HUFFMAN_EMIT_SYMBOL, 104),
+    (6, HUFFMAN_EMIT_SYMBOL, 104),
+    (10, HUFFMAN_EMIT_SYMBOL, 104),
+    (15, HUFFMAN_EMIT_SYMBOL, 104),
+    (24, HUFFMAN_EMIT_SYMBOL, 104),
+    (31, HUFFMAN_EMIT_SYMBOL, 104),
+    (41, HUFFMAN_EMIT_SYMBOL, 104),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 104),
+
+    # Node 31
+    (1, HUFFMAN_EMIT_SYMBOL, 108),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 108),
+    (1, HUFFMAN_EMIT_SYMBOL, 109),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 109),
+    (1, HUFFMAN_EMIT_SYMBOL, 110),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 110),
+    (1, HUFFMAN_EMIT_SYMBOL, 112),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 112),
+    (1, HUFFMAN_EMIT_SYMBOL, 114),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 114),
+    (1, HUFFMAN_EMIT_SYMBOL, 117),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 117),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 58),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 66),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 67),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 68),
+
+    # Node 32
+    (2, HUFFMAN_EMIT_SYMBOL, 108),
+    (9, HUFFMAN_EMIT_SYMBOL, 108),
+    (23, HUFFMAN_EMIT_SYMBOL, 108),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 108),
+    (2, HUFFMAN_EMIT_SYMBOL, 109),
+    (9, HUFFMAN_EMIT_SYMBOL, 109),
+    (23, HUFFMAN_EMIT_SYMBOL, 109),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 109),
+    (2, HUFFMAN_EMIT_SYMBOL, 110),
+    (9, HUFFMAN_EMIT_SYMBOL, 110),
+    (23, HUFFMAN_EMIT_SYMBOL, 110),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 110),
+    (2, HUFFMAN_EMIT_SYMBOL, 112),
+    (9, HUFFMAN_EMIT_SYMBOL, 112),
+    (23, HUFFMAN_EMIT_SYMBOL, 112),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 112),
+
+    # Node 33
+    (3, HUFFMAN_EMIT_SYMBOL, 108),
+    (6, HUFFMAN_EMIT_SYMBOL, 108),
+    (10, HUFFMAN_EMIT_SYMBOL, 108),
+    (15, HUFFMAN_EMIT_SYMBOL, 108),
+    (24, HUFFMAN_EMIT_SYMBOL, 108),
+    (31, HUFFMAN_EMIT_SYMBOL, 108),
+    (41, HUFFMAN_EMIT_SYMBOL, 108),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 108),
+    (3, HUFFMAN_EMIT_SYMBOL, 109),
+    (6, HUFFMAN_EMIT_SYMBOL, 109),
+    (10, HUFFMAN_EMIT_SYMBOL, 109),
+    (15, HUFFMAN_EMIT_SYMBOL, 109),
+    (24, HUFFMAN_EMIT_SYMBOL, 109),
+    (31, HUFFMAN_EMIT_SYMBOL, 109),
+    (41, HUFFMAN_EMIT_SYMBOL, 109),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 109),
+
+    # Node 34
+    (3, HUFFMAN_EMIT_SYMBOL, 110),
+    (6, HUFFMAN_EMIT_SYMBOL, 110),
+    (10, HUFFMAN_EMIT_SYMBOL, 110),
+    (15, HUFFMAN_EMIT_SYMBOL, 110),
+    (24, HUFFMAN_EMIT_SYMBOL, 110),
+    (31, HUFFMAN_EMIT_SYMBOL, 110),
+    (41, HUFFMAN_EMIT_SYMBOL, 110),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 110),
+    (3, HUFFMAN_EMIT_SYMBOL, 112),
+    (6, HUFFMAN_EMIT_SYMBOL, 112),
+    (10, HUFFMAN_EMIT_SYMBOL, 112),
+    (15, HUFFMAN_EMIT_SYMBOL, 112),
+    (24, HUFFMAN_EMIT_SYMBOL, 112),
+    (31, HUFFMAN_EMIT_SYMBOL, 112),
+    (41, HUFFMAN_EMIT_SYMBOL, 112),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 112),
+
+    # Node 35
+    (2, HUFFMAN_EMIT_SYMBOL, 114),
+    (9, HUFFMAN_EMIT_SYMBOL, 114),
+    (23, HUFFMAN_EMIT_SYMBOL, 114),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 114),
+    (2, HUFFMAN_EMIT_SYMBOL, 117),
+    (9, HUFFMAN_EMIT_SYMBOL, 117),
+    (23, HUFFMAN_EMIT_SYMBOL, 117),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 117),
+    (1, HUFFMAN_EMIT_SYMBOL, 58),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 58),
+    (1, HUFFMAN_EMIT_SYMBOL, 66),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 66),
+    (1, HUFFMAN_EMIT_SYMBOL, 67),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 67),
+    (1, HUFFMAN_EMIT_SYMBOL, 68),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 68),
+
+    # Node 36
+    (3, HUFFMAN_EMIT_SYMBOL, 114),
+    (6, HUFFMAN_EMIT_SYMBOL, 114),
+    (10, HUFFMAN_EMIT_SYMBOL, 114),
+    (15, HUFFMAN_EMIT_SYMBOL, 114),
+    (24, HUFFMAN_EMIT_SYMBOL, 114),
+    (31, HUFFMAN_EMIT_SYMBOL, 114),
+    (41, HUFFMAN_EMIT_SYMBOL, 114),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 114),
+    (3, HUFFMAN_EMIT_SYMBOL, 117),
+    (6, HUFFMAN_EMIT_SYMBOL, 117),
+    (10, HUFFMAN_EMIT_SYMBOL, 117),
+    (15, HUFFMAN_EMIT_SYMBOL, 117),
+    (24, HUFFMAN_EMIT_SYMBOL, 117),
+    (31, HUFFMAN_EMIT_SYMBOL, 117),
+    (41, HUFFMAN_EMIT_SYMBOL, 117),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 117),
+
+    # Node 37
+    (2, HUFFMAN_EMIT_SYMBOL, 58),
+    (9, HUFFMAN_EMIT_SYMBOL, 58),
+    (23, HUFFMAN_EMIT_SYMBOL, 58),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 58),
+    (2, HUFFMAN_EMIT_SYMBOL, 66),
+    (9, HUFFMAN_EMIT_SYMBOL, 66),
+    (23, HUFFMAN_EMIT_SYMBOL, 66),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 66),
+    (2, HUFFMAN_EMIT_SYMBOL, 67),
+    (9, HUFFMAN_EMIT_SYMBOL, 67),
+    (23, HUFFMAN_EMIT_SYMBOL, 67),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 67),
+    (2, HUFFMAN_EMIT_SYMBOL, 68),
+    (9, HUFFMAN_EMIT_SYMBOL, 68),
+    (23, HUFFMAN_EMIT_SYMBOL, 68),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 68),
+
+    # Node 38
+    (3, HUFFMAN_EMIT_SYMBOL, 58),
+    (6, HUFFMAN_EMIT_SYMBOL, 58),
+    (10, HUFFMAN_EMIT_SYMBOL, 58),
+    (15, HUFFMAN_EMIT_SYMBOL, 58),
+    (24, HUFFMAN_EMIT_SYMBOL, 58),
+    (31, HUFFMAN_EMIT_SYMBOL, 58),
+    (41, HUFFMAN_EMIT_SYMBOL, 58),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 58),
+    (3, HUFFMAN_EMIT_SYMBOL, 66),
+    (6, HUFFMAN_EMIT_SYMBOL, 66),
+    (10, HUFFMAN_EMIT_SYMBOL, 66),
+    (15, HUFFMAN_EMIT_SYMBOL, 66),
+    (24, HUFFMAN_EMIT_SYMBOL, 66),
+    (31, HUFFMAN_EMIT_SYMBOL, 66),
+    (41, HUFFMAN_EMIT_SYMBOL, 66),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 66),
+
+    # Node 39
+    (3, HUFFMAN_EMIT_SYMBOL, 67),
+    (6, HUFFMAN_EMIT_SYMBOL, 67),
+    (10, HUFFMAN_EMIT_SYMBOL, 67),
+    (15, HUFFMAN_EMIT_SYMBOL, 67),
+    (24, HUFFMAN_EMIT_SYMBOL, 67),
+    (31, HUFFMAN_EMIT_SYMBOL, 67),
+    (41, HUFFMAN_EMIT_SYMBOL, 67),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 67),
+    (3, HUFFMAN_EMIT_SYMBOL, 68),
+    (6, HUFFMAN_EMIT_SYMBOL, 68),
+    (10, HUFFMAN_EMIT_SYMBOL, 68),
+    (15, HUFFMAN_EMIT_SYMBOL, 68),
+    (24, HUFFMAN_EMIT_SYMBOL, 68),
+    (31, HUFFMAN_EMIT_SYMBOL, 68),
+    (41, HUFFMAN_EMIT_SYMBOL, 68),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 68),
+
+    # Node 40
+    (44, 0, 0),
+    (45, 0, 0),
+    (47, 0, 0),
+    (48, 0, 0),
+    (51, 0, 0),
+    (52, 0, 0),
+    (54, 0, 0),
+    (55, 0, 0),
+    (59, 0, 0),
+    (60, 0, 0),
+    (62, 0, 0),
+    (63, 0, 0),
+    (66, 0, 0),
+    (67, 0, 0),
+    (69, 0, 0),
+    (72, HUFFMAN_COMPLETE, 0),
+
+    # Node 41
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 69),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 70),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 71),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 72),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 73),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 74),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 75),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 76),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 77),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 78),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 79),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 80),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 81),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 82),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 83),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 84),
+
+    # Node 42
+    (1, HUFFMAN_EMIT_SYMBOL, 69),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 69),
+    (1, HUFFMAN_EMIT_SYMBOL, 70),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 70),
+    (1, HUFFMAN_EMIT_SYMBOL, 71),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 71),
+    (1, HUFFMAN_EMIT_SYMBOL, 72),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 72),
+    (1, HUFFMAN_EMIT_SYMBOL, 73),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 73),
+    (1, HUFFMAN_EMIT_SYMBOL, 74),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 74),
+    (1, HUFFMAN_EMIT_SYMBOL, 75),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 75),
+    (1, HUFFMAN_EMIT_SYMBOL, 76),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 76),
+
+    # Node 43
+    (2, HUFFMAN_EMIT_SYMBOL, 69),
+    (9, HUFFMAN_EMIT_SYMBOL, 69),
+    (23, HUFFMAN_EMIT_SYMBOL, 69),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 69),
+    (2, HUFFMAN_EMIT_SYMBOL, 70),
+    (9, HUFFMAN_EMIT_SYMBOL, 70),
+    (23, HUFFMAN_EMIT_SYMBOL, 70),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 70),
+    (2, HUFFMAN_EMIT_SYMBOL, 71),
+    (9, HUFFMAN_EMIT_SYMBOL, 71),
+    (23, HUFFMAN_EMIT_SYMBOL, 71),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 71),
+    (2, HUFFMAN_EMIT_SYMBOL, 72),
+    (9, HUFFMAN_EMIT_SYMBOL, 72),
+    (23, HUFFMAN_EMIT_SYMBOL, 72),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 72),
+
+    # Node 44
+    (3, HUFFMAN_EMIT_SYMBOL, 69),
+    (6, HUFFMAN_EMIT_SYMBOL, 69),
+    (10, HUFFMAN_EMIT_SYMBOL, 69),
+    (15, HUFFMAN_EMIT_SYMBOL, 69),
+    (24, HUFFMAN_EMIT_SYMBOL, 69),
+    (31, HUFFMAN_EMIT_SYMBOL, 69),
+    (41, HUFFMAN_EMIT_SYMBOL, 69),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 69),
+    (3, HUFFMAN_EMIT_SYMBOL, 70),
+    (6, HUFFMAN_EMIT_SYMBOL, 70),
+    (10, HUFFMAN_EMIT_SYMBOL, 70),
+    (15, HUFFMAN_EMIT_SYMBOL, 70),
+    (24, HUFFMAN_EMIT_SYMBOL, 70),
+    (31, HUFFMAN_EMIT_SYMBOL, 70),
+    (41, HUFFMAN_EMIT_SYMBOL, 70),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 70),
+
+    # Node 45
+    (3, HUFFMAN_EMIT_SYMBOL, 71),
+    (6, HUFFMAN_EMIT_SYMBOL, 71),
+    (10, HUFFMAN_EMIT_SYMBOL, 71),
+    (15, HUFFMAN_EMIT_SYMBOL, 71),
+    (24, HUFFMAN_EMIT_SYMBOL, 71),
+    (31, HUFFMAN_EMIT_SYMBOL, 71),
+    (41, HUFFMAN_EMIT_SYMBOL, 71),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 71),
+    (3, HUFFMAN_EMIT_SYMBOL, 72),
+    (6, HUFFMAN_EMIT_SYMBOL, 72),
+    (10, HUFFMAN_EMIT_SYMBOL, 72),
+    (15, HUFFMAN_EMIT_SYMBOL, 72),
+    (24, HUFFMAN_EMIT_SYMBOL, 72),
+    (31, HUFFMAN_EMIT_SYMBOL, 72),
+    (41, HUFFMAN_EMIT_SYMBOL, 72),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 72),
+
+    # Node 46
+    (2, HUFFMAN_EMIT_SYMBOL, 73),
+    (9, HUFFMAN_EMIT_SYMBOL, 73),
+    (23, HUFFMAN_EMIT_SYMBOL, 73),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 73),
+    (2, HUFFMAN_EMIT_SYMBOL, 74),
+    (9, HUFFMAN_EMIT_SYMBOL, 74),
+    (23, HUFFMAN_EMIT_SYMBOL, 74),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 74),
+    (2, HUFFMAN_EMIT_SYMBOL, 75),
+    (9, HUFFMAN_EMIT_SYMBOL, 75),
+    (23, HUFFMAN_EMIT_SYMBOL, 75),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 75),
+    (2, HUFFMAN_EMIT_SYMBOL, 76),
+    (9, HUFFMAN_EMIT_SYMBOL, 76),
+    (23, HUFFMAN_EMIT_SYMBOL, 76),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 76),
+
+    # Node 47
+    (3, HUFFMAN_EMIT_SYMBOL, 73),
+    (6, HUFFMAN_EMIT_SYMBOL, 73),
+    (10, HUFFMAN_EMIT_SYMBOL, 73),
+    (15, HUFFMAN_EMIT_SYMBOL, 73),
+    (24, HUFFMAN_EMIT_SYMBOL, 73),
+    (31, HUFFMAN_EMIT_SYMBOL, 73),
+    (41, HUFFMAN_EMIT_SYMBOL, 73),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 73),
+    (3, HUFFMAN_EMIT_SYMBOL, 74),
+    (6, HUFFMAN_EMIT_SYMBOL, 74),
+    (10, HUFFMAN_EMIT_SYMBOL, 74),
+    (15, HUFFMAN_EMIT_SYMBOL, 74),
+    (24, HUFFMAN_EMIT_SYMBOL, 74),
+    (31, HUFFMAN_EMIT_SYMBOL, 74),
+    (41, HUFFMAN_EMIT_SYMBOL, 74),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 74),
+
+    # Node 48
+    (3, HUFFMAN_EMIT_SYMBOL, 75),
+    (6, HUFFMAN_EMIT_SYMBOL, 75),
+    (10, HUFFMAN_EMIT_SYMBOL, 75),
+    (15, HUFFMAN_EMIT_SYMBOL, 75),
+    (24, HUFFMAN_EMIT_SYMBOL, 75),
+    (31, HUFFMAN_EMIT_SYMBOL, 75),
+    (41, HUFFMAN_EMIT_SYMBOL, 75),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 75),
+    (3, HUFFMAN_EMIT_SYMBOL, 76),
+    (6, HUFFMAN_EMIT_SYMBOL, 76),
+    (10, HUFFMAN_EMIT_SYMBOL, 76),
+    (15, HUFFMAN_EMIT_SYMBOL, 76),
+    (24, HUFFMAN_EMIT_SYMBOL, 76),
+    (31, HUFFMAN_EMIT_SYMBOL, 76),
+    (41, HUFFMAN_EMIT_SYMBOL, 76),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 76),
+
+    # Node 49
+    (1, HUFFMAN_EMIT_SYMBOL, 77),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 77),
+    (1, HUFFMAN_EMIT_SYMBOL, 78),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 78),
+    (1, HUFFMAN_EMIT_SYMBOL, 79),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 79),
+    (1, HUFFMAN_EMIT_SYMBOL, 80),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 80),
+    (1, HUFFMAN_EMIT_SYMBOL, 81),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 81),
+    (1, HUFFMAN_EMIT_SYMBOL, 82),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 82),
+    (1, HUFFMAN_EMIT_SYMBOL, 83),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 83),
+    (1, HUFFMAN_EMIT_SYMBOL, 84),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 84),
+
+    # Node 50
+    (2, HUFFMAN_EMIT_SYMBOL, 77),
+    (9, HUFFMAN_EMIT_SYMBOL, 77),
+    (23, HUFFMAN_EMIT_SYMBOL, 77),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 77),
+    (2, HUFFMAN_EMIT_SYMBOL, 78),
+    (9, HUFFMAN_EMIT_SYMBOL, 78),
+    (23, HUFFMAN_EMIT_SYMBOL, 78),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 78),
+    (2, HUFFMAN_EMIT_SYMBOL, 79),
+    (9, HUFFMAN_EMIT_SYMBOL, 79),
+    (23, HUFFMAN_EMIT_SYMBOL, 79),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 79),
+    (2, HUFFMAN_EMIT_SYMBOL, 80),
+    (9, HUFFMAN_EMIT_SYMBOL, 80),
+    (23, HUFFMAN_EMIT_SYMBOL, 80),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 80),
+
+    # Node 51
+    (3, HUFFMAN_EMIT_SYMBOL, 77),
+    (6, HUFFMAN_EMIT_SYMBOL, 77),
+    (10, HUFFMAN_EMIT_SYMBOL, 77),
+    (15, HUFFMAN_EMIT_SYMBOL, 77),
+    (24, HUFFMAN_EMIT_SYMBOL, 77),
+    (31, HUFFMAN_EMIT_SYMBOL, 77),
+    (41, HUFFMAN_EMIT_SYMBOL, 77),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 77),
+    (3, HUFFMAN_EMIT_SYMBOL, 78),
+    (6, HUFFMAN_EMIT_SYMBOL, 78),
+    (10, HUFFMAN_EMIT_SYMBOL, 78),
+    (15, HUFFMAN_EMIT_SYMBOL, 78),
+    (24, HUFFMAN_EMIT_SYMBOL, 78),
+    (31, HUFFMAN_EMIT_SYMBOL, 78),
+    (41, HUFFMAN_EMIT_SYMBOL, 78),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 78),
+
+    # Node 52
+    (3, HUFFMAN_EMIT_SYMBOL, 79),
+    (6, HUFFMAN_EMIT_SYMBOL, 79),
+    (10, HUFFMAN_EMIT_SYMBOL, 79),
+    (15, HUFFMAN_EMIT_SYMBOL, 79),
+    (24, HUFFMAN_EMIT_SYMBOL, 79),
+    (31, HUFFMAN_EMIT_SYMBOL, 79),
+    (41, HUFFMAN_EMIT_SYMBOL, 79),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 79),
+    (3, HUFFMAN_EMIT_SYMBOL, 80),
+    (6, HUFFMAN_EMIT_SYMBOL, 80),
+    (10, HUFFMAN_EMIT_SYMBOL, 80),
+    (15, HUFFMAN_EMIT_SYMBOL, 80),
+    (24, HUFFMAN_EMIT_SYMBOL, 80),
+    (31, HUFFMAN_EMIT_SYMBOL, 80),
+    (41, HUFFMAN_EMIT_SYMBOL, 80),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 80),
+
+    # Node 53
+    (2, HUFFMAN_EMIT_SYMBOL, 81),
+    (9, HUFFMAN_EMIT_SYMBOL, 81),
+    (23, HUFFMAN_EMIT_SYMBOL, 81),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 81),
+    (2, HUFFMAN_EMIT_SYMBOL, 82),
+    (9, HUFFMAN_EMIT_SYMBOL, 82),
+    (23, HUFFMAN_EMIT_SYMBOL, 82),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 82),
+    (2, HUFFMAN_EMIT_SYMBOL, 83),
+    (9, HUFFMAN_EMIT_SYMBOL, 83),
+    (23, HUFFMAN_EMIT_SYMBOL, 83),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 83),
+    (2, HUFFMAN_EMIT_SYMBOL, 84),
+    (9, HUFFMAN_EMIT_SYMBOL, 84),
+    (23, HUFFMAN_EMIT_SYMBOL, 84),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 84),
+
+    # Node 54
+    (3, HUFFMAN_EMIT_SYMBOL, 81),
+    (6, HUFFMAN_EMIT_SYMBOL, 81),
+    (10, HUFFMAN_EMIT_SYMBOL, 81),
+    (15, HUFFMAN_EMIT_SYMBOL, 81),
+    (24, HUFFMAN_EMIT_SYMBOL, 81),
+    (31, HUFFMAN_EMIT_SYMBOL, 81),
+    (41, HUFFMAN_EMIT_SYMBOL, 81),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 81),
+    (3, HUFFMAN_EMIT_SYMBOL, 82),
+    (6, HUFFMAN_EMIT_SYMBOL, 82),
+    (10, HUFFMAN_EMIT_SYMBOL, 82),
+    (15, HUFFMAN_EMIT_SYMBOL, 82),
+    (24, HUFFMAN_EMIT_SYMBOL, 82),
+    (31, HUFFMAN_EMIT_SYMBOL, 82),
+    (41, HUFFMAN_EMIT_SYMBOL, 82),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 82),
+
+    # Node 55
+    (3, HUFFMAN_EMIT_SYMBOL, 83),
+    (6, HUFFMAN_EMIT_SYMBOL, 83),
+    (10, HUFFMAN_EMIT_SYMBOL, 83),
+    (15, HUFFMAN_EMIT_SYMBOL, 83),
+    (24, HUFFMAN_EMIT_SYMBOL, 83),
+    (31, HUFFMAN_EMIT_SYMBOL, 83),
+    (41, HUFFMAN_EMIT_SYMBOL, 83),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 83),
+    (3, HUFFMAN_EMIT_SYMBOL, 84),
+    (6, HUFFMAN_EMIT_SYMBOL, 84),
+    (10, HUFFMAN_EMIT_SYMBOL, 84),
+    (15, HUFFMAN_EMIT_SYMBOL, 84),
+    (24, HUFFMAN_EMIT_SYMBOL, 84),
+    (31, HUFFMAN_EMIT_SYMBOL, 84),
+    (41, HUFFMAN_EMIT_SYMBOL, 84),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 84),
+
+    # Node 56
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 85),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 86),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 87),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 89),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 106),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 107),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 113),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 118),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 119),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 120),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 121),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 122),
+    (70, 0, 0),
+    (71, 0, 0),
+    (73, 0, 0),
+    (74, HUFFMAN_COMPLETE, 0),
+
+    # Node 57
+    (1, HUFFMAN_EMIT_SYMBOL, 85),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 85),
+    (1, HUFFMAN_EMIT_SYMBOL, 86),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 86),
+    (1, HUFFMAN_EMIT_SYMBOL, 87),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 87),
+    (1, HUFFMAN_EMIT_SYMBOL, 89),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 89),
+    (1, HUFFMAN_EMIT_SYMBOL, 106),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 106),
+    (1, HUFFMAN_EMIT_SYMBOL, 107),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 107),
+    (1, HUFFMAN_EMIT_SYMBOL, 113),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 113),
+    (1, HUFFMAN_EMIT_SYMBOL, 118),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 118),
+
+    # Node 58
+    (2, HUFFMAN_EMIT_SYMBOL, 85),
+    (9, HUFFMAN_EMIT_SYMBOL, 85),
+    (23, HUFFMAN_EMIT_SYMBOL, 85),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 85),
+    (2, HUFFMAN_EMIT_SYMBOL, 86),
+    (9, HUFFMAN_EMIT_SYMBOL, 86),
+    (23, HUFFMAN_EMIT_SYMBOL, 86),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 86),
+    (2, HUFFMAN_EMIT_SYMBOL, 87),
+    (9, HUFFMAN_EMIT_SYMBOL, 87),
+    (23, HUFFMAN_EMIT_SYMBOL, 87),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 87),
+    (2, HUFFMAN_EMIT_SYMBOL, 89),
+    (9, HUFFMAN_EMIT_SYMBOL, 89),
+    (23, HUFFMAN_EMIT_SYMBOL, 89),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 89),
+
+    # Node 59
+    (3, HUFFMAN_EMIT_SYMBOL, 85),
+    (6, HUFFMAN_EMIT_SYMBOL, 85),
+    (10, HUFFMAN_EMIT_SYMBOL, 85),
+    (15, HUFFMAN_EMIT_SYMBOL, 85),
+    (24, HUFFMAN_EMIT_SYMBOL, 85),
+    (31, HUFFMAN_EMIT_SYMBOL, 85),
+    (41, HUFFMAN_EMIT_SYMBOL, 85),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 85),
+    (3, HUFFMAN_EMIT_SYMBOL, 86),
+    (6, HUFFMAN_EMIT_SYMBOL, 86),
+    (10, HUFFMAN_EMIT_SYMBOL, 86),
+    (15, HUFFMAN_EMIT_SYMBOL, 86),
+    (24, HUFFMAN_EMIT_SYMBOL, 86),
+    (31, HUFFMAN_EMIT_SYMBOL, 86),
+    (41, HUFFMAN_EMIT_SYMBOL, 86),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 86),
+
+    # Node 60
+    (3, HUFFMAN_EMIT_SYMBOL, 87),
+    (6, HUFFMAN_EMIT_SYMBOL, 87),
+    (10, HUFFMAN_EMIT_SYMBOL, 87),
+    (15, HUFFMAN_EMIT_SYMBOL, 87),
+    (24, HUFFMAN_EMIT_SYMBOL, 87),
+    (31, HUFFMAN_EMIT_SYMBOL, 87),
+    (41, HUFFMAN_EMIT_SYMBOL, 87),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 87),
+    (3, HUFFMAN_EMIT_SYMBOL, 89),
+    (6, HUFFMAN_EMIT_SYMBOL, 89),
+    (10, HUFFMAN_EMIT_SYMBOL, 89),
+    (15, HUFFMAN_EMIT_SYMBOL, 89),
+    (24, HUFFMAN_EMIT_SYMBOL, 89),
+    (31, HUFFMAN_EMIT_SYMBOL, 89),
+    (41, HUFFMAN_EMIT_SYMBOL, 89),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 89),
+
+    # Node 61
+    (2, HUFFMAN_EMIT_SYMBOL, 106),
+    (9, HUFFMAN_EMIT_SYMBOL, 106),
+    (23, HUFFMAN_EMIT_SYMBOL, 106),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 106),
+    (2, HUFFMAN_EMIT_SYMBOL, 107),
+    (9, HUFFMAN_EMIT_SYMBOL, 107),
+    (23, HUFFMAN_EMIT_SYMBOL, 107),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 107),
+    (2, HUFFMAN_EMIT_SYMBOL, 113),
+    (9, HUFFMAN_EMIT_SYMBOL, 113),
+    (23, HUFFMAN_EMIT_SYMBOL, 113),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 113),
+    (2, HUFFMAN_EMIT_SYMBOL, 118),
+    (9, HUFFMAN_EMIT_SYMBOL, 118),
+    (23, HUFFMAN_EMIT_SYMBOL, 118),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 118),
+
+    # Node 62
+    (3, HUFFMAN_EMIT_SYMBOL, 106),
+    (6, HUFFMAN_EMIT_SYMBOL, 106),
+    (10, HUFFMAN_EMIT_SYMBOL, 106),
+    (15, HUFFMAN_EMIT_SYMBOL, 106),
+    (24, HUFFMAN_EMIT_SYMBOL, 106),
+    (31, HUFFMAN_EMIT_SYMBOL, 106),
+    (41, HUFFMAN_EMIT_SYMBOL, 106),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 106),
+    (3, HUFFMAN_EMIT_SYMBOL, 107),
+    (6, HUFFMAN_EMIT_SYMBOL, 107),
+    (10, HUFFMAN_EMIT_SYMBOL, 107),
+    (15, HUFFMAN_EMIT_SYMBOL, 107),
+    (24, HUFFMAN_EMIT_SYMBOL, 107),
+    (31, HUFFMAN_EMIT_SYMBOL, 107),
+    (41, HUFFMAN_EMIT_SYMBOL, 107),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 107),
+
+    # Node 63
+    (3, HUFFMAN_EMIT_SYMBOL, 113),
+    (6, HUFFMAN_EMIT_SYMBOL, 113),
+    (10, HUFFMAN_EMIT_SYMBOL, 113),
+    (15, HUFFMAN_EMIT_SYMBOL, 113),
+    (24, HUFFMAN_EMIT_SYMBOL, 113),
+    (31, HUFFMAN_EMIT_SYMBOL, 113),
+    (41, HUFFMAN_EMIT_SYMBOL, 113),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 113),
+    (3, HUFFMAN_EMIT_SYMBOL, 118),
+    (6, HUFFMAN_EMIT_SYMBOL, 118),
+    (10, HUFFMAN_EMIT_SYMBOL, 118),
+    (15, HUFFMAN_EMIT_SYMBOL, 118),
+    (24, HUFFMAN_EMIT_SYMBOL, 118),
+    (31, HUFFMAN_EMIT_SYMBOL, 118),
+    (41, HUFFMAN_EMIT_SYMBOL, 118),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 118),
+
+    # Node 64
+    (1, HUFFMAN_EMIT_SYMBOL, 119),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 119),
+    (1, HUFFMAN_EMIT_SYMBOL, 120),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 120),
+    (1, HUFFMAN_EMIT_SYMBOL, 121),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 121),
+    (1, HUFFMAN_EMIT_SYMBOL, 122),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 122),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 38),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 42),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 44),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 59),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 88),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 90),
+    (75, 0, 0),
+    (78, 0, 0),
+
+    # Node 65
+    (2, HUFFMAN_EMIT_SYMBOL, 119),
+    (9, HUFFMAN_EMIT_SYMBOL, 119),
+    (23, HUFFMAN_EMIT_SYMBOL, 119),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 119),
+    (2, HUFFMAN_EMIT_SYMBOL, 120),
+    (9, HUFFMAN_EMIT_SYMBOL, 120),
+    (23, HUFFMAN_EMIT_SYMBOL, 120),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 120),
+    (2, HUFFMAN_EMIT_SYMBOL, 121),
+    (9, HUFFMAN_EMIT_SYMBOL, 121),
+    (23, HUFFMAN_EMIT_SYMBOL, 121),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 121),
+    (2, HUFFMAN_EMIT_SYMBOL, 122),
+    (9, HUFFMAN_EMIT_SYMBOL, 122),
+    (23, HUFFMAN_EMIT_SYMBOL, 122),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 122),
+
+    # Node 66
+    (3, HUFFMAN_EMIT_SYMBOL, 119),
+    (6, HUFFMAN_EMIT_SYMBOL, 119),
+    (10, HUFFMAN_EMIT_SYMBOL, 119),
+    (15, HUFFMAN_EMIT_SYMBOL, 119),
+    (24, HUFFMAN_EMIT_SYMBOL, 119),
+    (31, HUFFMAN_EMIT_SYMBOL, 119),
+    (41, HUFFMAN_EMIT_SYMBOL, 119),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 119),
+    (3, HUFFMAN_EMIT_SYMBOL, 120),
+    (6, HUFFMAN_EMIT_SYMBOL, 120),
+    (10, HUFFMAN_EMIT_SYMBOL, 120),
+    (15, HUFFMAN_EMIT_SYMBOL, 120),
+    (24, HUFFMAN_EMIT_SYMBOL, 120),
+    (31, HUFFMAN_EMIT_SYMBOL, 120),
+    (41, HUFFMAN_EMIT_SYMBOL, 120),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 120),
+
+    # Node 67
+    (3, HUFFMAN_EMIT_SYMBOL, 121),
+    (6, HUFFMAN_EMIT_SYMBOL, 121),
+    (10, HUFFMAN_EMIT_SYMBOL, 121),
+    (15, HUFFMAN_EMIT_SYMBOL, 121),
+    (24, HUFFMAN_EMIT_SYMBOL, 121),
+    (31, HUFFMAN_EMIT_SYMBOL, 121),
+    (41, HUFFMAN_EMIT_SYMBOL, 121),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 121),
+    (3, HUFFMAN_EMIT_SYMBOL, 122),
+    (6, HUFFMAN_EMIT_SYMBOL, 122),
+    (10, HUFFMAN_EMIT_SYMBOL, 122),
+    (15, HUFFMAN_EMIT_SYMBOL, 122),
+    (24, HUFFMAN_EMIT_SYMBOL, 122),
+    (31, HUFFMAN_EMIT_SYMBOL, 122),
+    (41, HUFFMAN_EMIT_SYMBOL, 122),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 122),
+
+    # Node 68
+    (1, HUFFMAN_EMIT_SYMBOL, 38),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 38),
+    (1, HUFFMAN_EMIT_SYMBOL, 42),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 42),
+    (1, HUFFMAN_EMIT_SYMBOL, 44),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 44),
+    (1, HUFFMAN_EMIT_SYMBOL, 59),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 59),
+    (1, HUFFMAN_EMIT_SYMBOL, 88),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 88),
+    (1, HUFFMAN_EMIT_SYMBOL, 90),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 90),
+    (76, 0, 0),
+    (77, 0, 0),
+    (79, 0, 0),
+    (81, 0, 0),
+
+    # Node 69
+    (2, HUFFMAN_EMIT_SYMBOL, 38),
+    (9, HUFFMAN_EMIT_SYMBOL, 38),
+    (23, HUFFMAN_EMIT_SYMBOL, 38),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 38),
+    (2, HUFFMAN_EMIT_SYMBOL, 42),
+    (9, HUFFMAN_EMIT_SYMBOL, 42),
+    (23, HUFFMAN_EMIT_SYMBOL, 42),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 42),
+    (2, HUFFMAN_EMIT_SYMBOL, 44),
+    (9, HUFFMAN_EMIT_SYMBOL, 44),
+    (23, HUFFMAN_EMIT_SYMBOL, 44),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 44),
+    (2, HUFFMAN_EMIT_SYMBOL, 59),
+    (9, HUFFMAN_EMIT_SYMBOL, 59),
+    (23, HUFFMAN_EMIT_SYMBOL, 59),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 59),
+
+    # Node 70
+    (3, HUFFMAN_EMIT_SYMBOL, 38),
+    (6, HUFFMAN_EMIT_SYMBOL, 38),
+    (10, HUFFMAN_EMIT_SYMBOL, 38),
+    (15, HUFFMAN_EMIT_SYMBOL, 38),
+    (24, HUFFMAN_EMIT_SYMBOL, 38),
+    (31, HUFFMAN_EMIT_SYMBOL, 38),
+    (41, HUFFMAN_EMIT_SYMBOL, 38),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 38),
+    (3, HUFFMAN_EMIT_SYMBOL, 42),
+    (6, HUFFMAN_EMIT_SYMBOL, 42),
+    (10, HUFFMAN_EMIT_SYMBOL, 42),
+    (15, HUFFMAN_EMIT_SYMBOL, 42),
+    (24, HUFFMAN_EMIT_SYMBOL, 42),
+    (31, HUFFMAN_EMIT_SYMBOL, 42),
+    (41, HUFFMAN_EMIT_SYMBOL, 42),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 42),
+
+    # Node 71
+    (3, HUFFMAN_EMIT_SYMBOL, 44),
+    (6, HUFFMAN_EMIT_SYMBOL, 44),
+    (10, HUFFMAN_EMIT_SYMBOL, 44),
+    (15, HUFFMAN_EMIT_SYMBOL, 44),
+    (24, HUFFMAN_EMIT_SYMBOL, 44),
+    (31, HUFFMAN_EMIT_SYMBOL, 44),
+    (41, HUFFMAN_EMIT_SYMBOL, 44),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 44),
+    (3, HUFFMAN_EMIT_SYMBOL, 59),
+    (6, HUFFMAN_EMIT_SYMBOL, 59),
+    (10, HUFFMAN_EMIT_SYMBOL, 59),
+    (15, HUFFMAN_EMIT_SYMBOL, 59),
+    (24, HUFFMAN_EMIT_SYMBOL, 59),
+    (31, HUFFMAN_EMIT_SYMBOL, 59),
+    (41, HUFFMAN_EMIT_SYMBOL, 59),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 59),
+
+    # Node 72
+    (2, HUFFMAN_EMIT_SYMBOL, 88),
+    (9, HUFFMAN_EMIT_SYMBOL, 88),
+    (23, HUFFMAN_EMIT_SYMBOL, 88),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 88),
+    (2, HUFFMAN_EMIT_SYMBOL, 90),
+    (9, HUFFMAN_EMIT_SYMBOL, 90),
+    (23, HUFFMAN_EMIT_SYMBOL, 90),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 90),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 33),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 34),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 40),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 41),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 63),
+    (80, 0, 0),
+    (82, 0, 0),
+    (84, 0, 0),
+
+    # Node 73
+    (3, HUFFMAN_EMIT_SYMBOL, 88),
+    (6, HUFFMAN_EMIT_SYMBOL, 88),
+    (10, HUFFMAN_EMIT_SYMBOL, 88),
+    (15, HUFFMAN_EMIT_SYMBOL, 88),
+    (24, HUFFMAN_EMIT_SYMBOL, 88),
+    (31, HUFFMAN_EMIT_SYMBOL, 88),
+    (41, HUFFMAN_EMIT_SYMBOL, 88),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 88),
+    (3, HUFFMAN_EMIT_SYMBOL, 90),
+    (6, HUFFMAN_EMIT_SYMBOL, 90),
+    (10, HUFFMAN_EMIT_SYMBOL, 90),
+    (15, HUFFMAN_EMIT_SYMBOL, 90),
+    (24, HUFFMAN_EMIT_SYMBOL, 90),
+    (31, HUFFMAN_EMIT_SYMBOL, 90),
+    (41, HUFFMAN_EMIT_SYMBOL, 90),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 90),
+
+    # Node 74
+    (1, HUFFMAN_EMIT_SYMBOL, 33),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 33),
+    (1, HUFFMAN_EMIT_SYMBOL, 34),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 34),
+    (1, HUFFMAN_EMIT_SYMBOL, 40),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 40),
+    (1, HUFFMAN_EMIT_SYMBOL, 41),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 41),
+    (1, HUFFMAN_EMIT_SYMBOL, 63),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 63),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 39),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 43),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 124),
+    (83, 0, 0),
+    (85, 0, 0),
+    (88, 0, 0),
+
+    # Node 75
+    (2, HUFFMAN_EMIT_SYMBOL, 33),
+    (9, HUFFMAN_EMIT_SYMBOL, 33),
+    (23, HUFFMAN_EMIT_SYMBOL, 33),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 33),
+    (2, HUFFMAN_EMIT_SYMBOL, 34),
+    (9, HUFFMAN_EMIT_SYMBOL, 34),
+    (23, HUFFMAN_EMIT_SYMBOL, 34),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 34),
+    (2, HUFFMAN_EMIT_SYMBOL, 40),
+    (9, HUFFMAN_EMIT_SYMBOL, 40),
+    (23, HUFFMAN_EMIT_SYMBOL, 40),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 40),
+    (2, HUFFMAN_EMIT_SYMBOL, 41),
+    (9, HUFFMAN_EMIT_SYMBOL, 41),
+    (23, HUFFMAN_EMIT_SYMBOL, 41),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 41),
+
+    # Node 76
+    (3, HUFFMAN_EMIT_SYMBOL, 33),
+    (6, HUFFMAN_EMIT_SYMBOL, 33),
+    (10, HUFFMAN_EMIT_SYMBOL, 33),
+    (15, HUFFMAN_EMIT_SYMBOL, 33),
+    (24, HUFFMAN_EMIT_SYMBOL, 33),
+    (31, HUFFMAN_EMIT_SYMBOL, 33),
+    (41, HUFFMAN_EMIT_SYMBOL, 33),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 33),
+    (3, HUFFMAN_EMIT_SYMBOL, 34),
+    (6, HUFFMAN_EMIT_SYMBOL, 34),
+    (10, HUFFMAN_EMIT_SYMBOL, 34),
+    (15, HUFFMAN_EMIT_SYMBOL, 34),
+    (24, HUFFMAN_EMIT_SYMBOL, 34),
+    (31, HUFFMAN_EMIT_SYMBOL, 34),
+    (41, HUFFMAN_EMIT_SYMBOL, 34),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 34),
+
+    # Node 77
+    (3, HUFFMAN_EMIT_SYMBOL, 40),
+    (6, HUFFMAN_EMIT_SYMBOL, 40),
+    (10, HUFFMAN_EMIT_SYMBOL, 40),
+    (15, HUFFMAN_EMIT_SYMBOL, 40),
+    (24, HUFFMAN_EMIT_SYMBOL, 40),
+    (31, HUFFMAN_EMIT_SYMBOL, 40),
+    (41, HUFFMAN_EMIT_SYMBOL, 40),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 40),
+    (3, HUFFMAN_EMIT_SYMBOL, 41),
+    (6, HUFFMAN_EMIT_SYMBOL, 41),
+    (10, HUFFMAN_EMIT_SYMBOL, 41),
+    (15, HUFFMAN_EMIT_SYMBOL, 41),
+    (24, HUFFMAN_EMIT_SYMBOL, 41),
+    (31, HUFFMAN_EMIT_SYMBOL, 41),
+    (41, HUFFMAN_EMIT_SYMBOL, 41),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 41),
+
+    # Node 78
+    (2, HUFFMAN_EMIT_SYMBOL, 63),
+    (9, HUFFMAN_EMIT_SYMBOL, 63),
+    (23, HUFFMAN_EMIT_SYMBOL, 63),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 63),
+    (1, HUFFMAN_EMIT_SYMBOL, 39),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 39),
+    (1, HUFFMAN_EMIT_SYMBOL, 43),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 43),
+    (1, HUFFMAN_EMIT_SYMBOL, 124),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 124),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 35),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 62),
+    (86, 0, 0),
+    (87, 0, 0),
+    (89, 0, 0),
+    (90, 0, 0),
+
+    # Node 79
+    (3, HUFFMAN_EMIT_SYMBOL, 63),
+    (6, HUFFMAN_EMIT_SYMBOL, 63),
+    (10, HUFFMAN_EMIT_SYMBOL, 63),
+    (15, HUFFMAN_EMIT_SYMBOL, 63),
+    (24, HUFFMAN_EMIT_SYMBOL, 63),
+    (31, HUFFMAN_EMIT_SYMBOL, 63),
+    (41, HUFFMAN_EMIT_SYMBOL, 63),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 63),
+    (2, HUFFMAN_EMIT_SYMBOL, 39),
+    (9, HUFFMAN_EMIT_SYMBOL, 39),
+    (23, HUFFMAN_EMIT_SYMBOL, 39),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 39),
+    (2, HUFFMAN_EMIT_SYMBOL, 43),
+    (9, HUFFMAN_EMIT_SYMBOL, 43),
+    (23, HUFFMAN_EMIT_SYMBOL, 43),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 43),
+
+    # Node 80
+    (3, HUFFMAN_EMIT_SYMBOL, 39),
+    (6, HUFFMAN_EMIT_SYMBOL, 39),
+    (10, HUFFMAN_EMIT_SYMBOL, 39),
+    (15, HUFFMAN_EMIT_SYMBOL, 39),
+    (24, HUFFMAN_EMIT_SYMBOL, 39),
+    (31, HUFFMAN_EMIT_SYMBOL, 39),
+    (41, HUFFMAN_EMIT_SYMBOL, 39),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 39),
+    (3, HUFFMAN_EMIT_SYMBOL, 43),
+    (6, HUFFMAN_EMIT_SYMBOL, 43),
+    (10, HUFFMAN_EMIT_SYMBOL, 43),
+    (15, HUFFMAN_EMIT_SYMBOL, 43),
+    (24, HUFFMAN_EMIT_SYMBOL, 43),
+    (31, HUFFMAN_EMIT_SYMBOL, 43),
+    (41, HUFFMAN_EMIT_SYMBOL, 43),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 43),
+
+    # Node 81
+    (2, HUFFMAN_EMIT_SYMBOL, 124),
+    (9, HUFFMAN_EMIT_SYMBOL, 124),
+    (23, HUFFMAN_EMIT_SYMBOL, 124),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 124),
+    (1, HUFFMAN_EMIT_SYMBOL, 35),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 35),
+    (1, HUFFMAN_EMIT_SYMBOL, 62),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 62),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 0),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 36),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 64),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 91),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 93),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 126),
+    (91, 0, 0),
+    (92, 0, 0),
+
+    # Node 82
+    (3, HUFFMAN_EMIT_SYMBOL, 124),
+    (6, HUFFMAN_EMIT_SYMBOL, 124),
+    (10, HUFFMAN_EMIT_SYMBOL, 124),
+    (15, HUFFMAN_EMIT_SYMBOL, 124),
+    (24, HUFFMAN_EMIT_SYMBOL, 124),
+    (31, HUFFMAN_EMIT_SYMBOL, 124),
+    (41, HUFFMAN_EMIT_SYMBOL, 124),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 124),
+    (2, HUFFMAN_EMIT_SYMBOL, 35),
+    (9, HUFFMAN_EMIT_SYMBOL, 35),
+    (23, HUFFMAN_EMIT_SYMBOL, 35),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 35),
+    (2, HUFFMAN_EMIT_SYMBOL, 62),
+    (9, HUFFMAN_EMIT_SYMBOL, 62),
+    (23, HUFFMAN_EMIT_SYMBOL, 62),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 62),
+
+    # Node 83
+    (3, HUFFMAN_EMIT_SYMBOL, 35),
+    (6, HUFFMAN_EMIT_SYMBOL, 35),
+    (10, HUFFMAN_EMIT_SYMBOL, 35),
+    (15, HUFFMAN_EMIT_SYMBOL, 35),
+    (24, HUFFMAN_EMIT_SYMBOL, 35),
+    (31, HUFFMAN_EMIT_SYMBOL, 35),
+    (41, HUFFMAN_EMIT_SYMBOL, 35),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 35),
+    (3, HUFFMAN_EMIT_SYMBOL, 62),
+    (6, HUFFMAN_EMIT_SYMBOL, 62),
+    (10, HUFFMAN_EMIT_SYMBOL, 62),
+    (15, HUFFMAN_EMIT_SYMBOL, 62),
+    (24, HUFFMAN_EMIT_SYMBOL, 62),
+    (31, HUFFMAN_EMIT_SYMBOL, 62),
+    (41, HUFFMAN_EMIT_SYMBOL, 62),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 62),
+
+    # Node 84
+    (1, HUFFMAN_EMIT_SYMBOL, 0),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 0),
+    (1, HUFFMAN_EMIT_SYMBOL, 36),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 36),
+    (1, HUFFMAN_EMIT_SYMBOL, 64),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 64),
+    (1, HUFFMAN_EMIT_SYMBOL, 91),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 91),
+    (1, HUFFMAN_EMIT_SYMBOL, 93),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 93),
+    (1, HUFFMAN_EMIT_SYMBOL, 126),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 126),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 94),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 125),
+    (93, 0, 0),
+    (94, 0, 0),
+
+    # Node 85
+    (2, HUFFMAN_EMIT_SYMBOL, 0),
+    (9, HUFFMAN_EMIT_SYMBOL, 0),
+    (23, HUFFMAN_EMIT_SYMBOL, 0),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 0),
+    (2, HUFFMAN_EMIT_SYMBOL, 36),
+    (9, HUFFMAN_EMIT_SYMBOL, 36),
+    (23, HUFFMAN_EMIT_SYMBOL, 36),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 36),
+    (2, HUFFMAN_EMIT_SYMBOL, 64),
+    (9, HUFFMAN_EMIT_SYMBOL, 64),
+    (23, HUFFMAN_EMIT_SYMBOL, 64),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 64),
+    (2, HUFFMAN_EMIT_SYMBOL, 91),
+    (9, HUFFMAN_EMIT_SYMBOL, 91),
+    (23, HUFFMAN_EMIT_SYMBOL, 91),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 91),
+
+    # Node 86
+    (3, HUFFMAN_EMIT_SYMBOL, 0),
+    (6, HUFFMAN_EMIT_SYMBOL, 0),
+    (10, HUFFMAN_EMIT_SYMBOL, 0),
+    (15, HUFFMAN_EMIT_SYMBOL, 0),
+    (24, HUFFMAN_EMIT_SYMBOL, 0),
+    (31, HUFFMAN_EMIT_SYMBOL, 0),
+    (41, HUFFMAN_EMIT_SYMBOL, 0),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 0),
+    (3, HUFFMAN_EMIT_SYMBOL, 36),
+    (6, HUFFMAN_EMIT_SYMBOL, 36),
+    (10, HUFFMAN_EMIT_SYMBOL, 36),
+    (15, HUFFMAN_EMIT_SYMBOL, 36),
+    (24, HUFFMAN_EMIT_SYMBOL, 36),
+    (31, HUFFMAN_EMIT_SYMBOL, 36),
+    (41, HUFFMAN_EMIT_SYMBOL, 36),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 36),
+
+    # Node 87
+    (3, HUFFMAN_EMIT_SYMBOL, 64),
+    (6, HUFFMAN_EMIT_SYMBOL, 64),
+    (10, HUFFMAN_EMIT_SYMBOL, 64),
+    (15, HUFFMAN_EMIT_SYMBOL, 64),
+    (24, HUFFMAN_EMIT_SYMBOL, 64),
+    (31, HUFFMAN_EMIT_SYMBOL, 64),
+    (41, HUFFMAN_EMIT_SYMBOL, 64),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 64),
+    (3, HUFFMAN_EMIT_SYMBOL, 91),
+    (6, HUFFMAN_EMIT_SYMBOL, 91),
+    (10, HUFFMAN_EMIT_SYMBOL, 91),
+    (15, HUFFMAN_EMIT_SYMBOL, 91),
+    (24, HUFFMAN_EMIT_SYMBOL, 91),
+    (31, HUFFMAN_EMIT_SYMBOL, 91),
+    (41, HUFFMAN_EMIT_SYMBOL, 91),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 91),
+
+    # Node 88
+    (2, HUFFMAN_EMIT_SYMBOL, 93),
+    (9, HUFFMAN_EMIT_SYMBOL, 93),
+    (23, HUFFMAN_EMIT_SYMBOL, 93),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 93),
+    (2, HUFFMAN_EMIT_SYMBOL, 126),
+    (9, HUFFMAN_EMIT_SYMBOL, 126),
+    (23, HUFFMAN_EMIT_SYMBOL, 126),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 126),
+    (1, HUFFMAN_EMIT_SYMBOL, 94),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 94),
+    (1, HUFFMAN_EMIT_SYMBOL, 125),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 125),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 60),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 96),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 123),
+    (95, 0, 0),
+
+    # Node 89
+    (3, HUFFMAN_EMIT_SYMBOL, 93),
+    (6, HUFFMAN_EMIT_SYMBOL, 93),
+    (10, HUFFMAN_EMIT_SYMBOL, 93),
+    (15, HUFFMAN_EMIT_SYMBOL, 93),
+    (24, HUFFMAN_EMIT_SYMBOL, 93),
+    (31, HUFFMAN_EMIT_SYMBOL, 93),
+    (41, HUFFMAN_EMIT_SYMBOL, 93),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 93),
+    (3, HUFFMAN_EMIT_SYMBOL, 126),
+    (6, HUFFMAN_EMIT_SYMBOL, 126),
+    (10, HUFFMAN_EMIT_SYMBOL, 126),
+    (15, HUFFMAN_EMIT_SYMBOL, 126),
+    (24, HUFFMAN_EMIT_SYMBOL, 126),
+    (31, HUFFMAN_EMIT_SYMBOL, 126),
+    (41, HUFFMAN_EMIT_SYMBOL, 126),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 126),
+
+    # Node 90
+    (2, HUFFMAN_EMIT_SYMBOL, 94),
+    (9, HUFFMAN_EMIT_SYMBOL, 94),
+    (23, HUFFMAN_EMIT_SYMBOL, 94),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 94),
+    (2, HUFFMAN_EMIT_SYMBOL, 125),
+    (9, HUFFMAN_EMIT_SYMBOL, 125),
+    (23, HUFFMAN_EMIT_SYMBOL, 125),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 125),
+    (1, HUFFMAN_EMIT_SYMBOL, 60),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 60),
+    (1, HUFFMAN_EMIT_SYMBOL, 96),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 96),
+    (1, HUFFMAN_EMIT_SYMBOL, 123),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 123),
+    (96, 0, 0),
+    (110, 0, 0),
+
+    # Node 91
+    (3, HUFFMAN_EMIT_SYMBOL, 94),
+    (6, HUFFMAN_EMIT_SYMBOL, 94),
+    (10, HUFFMAN_EMIT_SYMBOL, 94),
+    (15, HUFFMAN_EMIT_SYMBOL, 94),
+    (24, HUFFMAN_EMIT_SYMBOL, 94),
+    (31, HUFFMAN_EMIT_SYMBOL, 94),
+    (41, HUFFMAN_EMIT_SYMBOL, 94),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 94),
+    (3, HUFFMAN_EMIT_SYMBOL, 125),
+    (6, HUFFMAN_EMIT_SYMBOL, 125),
+    (10, HUFFMAN_EMIT_SYMBOL, 125),
+    (15, HUFFMAN_EMIT_SYMBOL, 125),
+    (24, HUFFMAN_EMIT_SYMBOL, 125),
+    (31, HUFFMAN_EMIT_SYMBOL, 125),
+    (41, HUFFMAN_EMIT_SYMBOL, 125),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 125),
+
+    # Node 92
+    (2, HUFFMAN_EMIT_SYMBOL, 60),
+    (9, HUFFMAN_EMIT_SYMBOL, 60),
+    (23, HUFFMAN_EMIT_SYMBOL, 60),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 60),
+    (2, HUFFMAN_EMIT_SYMBOL, 96),
+    (9, HUFFMAN_EMIT_SYMBOL, 96),
+    (23, HUFFMAN_EMIT_SYMBOL, 96),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 96),
+    (2, HUFFMAN_EMIT_SYMBOL, 123),
+    (9, HUFFMAN_EMIT_SYMBOL, 123),
+    (23, HUFFMAN_EMIT_SYMBOL, 123),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 123),
+    (97, 0, 0),
+    (101, 0, 0),
+    (111, 0, 0),
+    (133, 0, 0),
+
+    # Node 93
+    (3, HUFFMAN_EMIT_SYMBOL, 60),
+    (6, HUFFMAN_EMIT_SYMBOL, 60),
+    (10, HUFFMAN_EMIT_SYMBOL, 60),
+    (15, HUFFMAN_EMIT_SYMBOL, 60),
+    (24, HUFFMAN_EMIT_SYMBOL, 60),
+    (31, HUFFMAN_EMIT_SYMBOL, 60),
+    (41, HUFFMAN_EMIT_SYMBOL, 60),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 60),
+    (3, HUFFMAN_EMIT_SYMBOL, 96),
+    (6, HUFFMAN_EMIT_SYMBOL, 96),
+    (10, HUFFMAN_EMIT_SYMBOL, 96),
+    (15, HUFFMAN_EMIT_SYMBOL, 96),
+    (24, HUFFMAN_EMIT_SYMBOL, 96),
+    (31, HUFFMAN_EMIT_SYMBOL, 96),
+    (41, HUFFMAN_EMIT_SYMBOL, 96),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 96),
+
+    # Node 94
+    (3, HUFFMAN_EMIT_SYMBOL, 123),
+    (6, HUFFMAN_EMIT_SYMBOL, 123),
+    (10, HUFFMAN_EMIT_SYMBOL, 123),
+    (15, HUFFMAN_EMIT_SYMBOL, 123),
+    (24, HUFFMAN_EMIT_SYMBOL, 123),
+    (31, HUFFMAN_EMIT_SYMBOL, 123),
+    (41, HUFFMAN_EMIT_SYMBOL, 123),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 123),
+    (98, 0, 0),
+    (99, 0, 0),
+    (102, 0, 0),
+    (105, 0, 0),
+    (112, 0, 0),
+    (119, 0, 0),
+    (134, 0, 0),
+    (153, 0, 0),
+
+    # Node 95
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 92),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 195),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 208),
+    (100, 0, 0),
+    (103, 0, 0),
+    (104, 0, 0),
+    (106, 0, 0),
+    (107, 0, 0),
+    (113, 0, 0),
+    (116, 0, 0),
+    (120, 0, 0),
+    (126, 0, 0),
+    (135, 0, 0),
+    (142, 0, 0),
+    (154, 0, 0),
+    (169, 0, 0),
+
+    # Node 96
+    (1, HUFFMAN_EMIT_SYMBOL, 92),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 92),
+    (1, HUFFMAN_EMIT_SYMBOL, 195),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 195),
+    (1, HUFFMAN_EMIT_SYMBOL, 208),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 208),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 128),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 130),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 131),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 162),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 184),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 194),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 224),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 226),
+    (108, 0, 0),
+    (109, 0, 0),
+
+    # Node 97
+    (2, HUFFMAN_EMIT_SYMBOL, 92),
+    (9, HUFFMAN_EMIT_SYMBOL, 92),
+    (23, HUFFMAN_EMIT_SYMBOL, 92),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 92),
+    (2, HUFFMAN_EMIT_SYMBOL, 195),
+    (9, HUFFMAN_EMIT_SYMBOL, 195),
+    (23, HUFFMAN_EMIT_SYMBOL, 195),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 195),
+    (2, HUFFMAN_EMIT_SYMBOL, 208),
+    (9, HUFFMAN_EMIT_SYMBOL, 208),
+    (23, HUFFMAN_EMIT_SYMBOL, 208),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 208),
+    (1, HUFFMAN_EMIT_SYMBOL, 128),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 128),
+    (1, HUFFMAN_EMIT_SYMBOL, 130),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 130),
+
+    # Node 98
+    (3, HUFFMAN_EMIT_SYMBOL, 92),
+    (6, HUFFMAN_EMIT_SYMBOL, 92),
+    (10, HUFFMAN_EMIT_SYMBOL, 92),
+    (15, HUFFMAN_EMIT_SYMBOL, 92),
+    (24, HUFFMAN_EMIT_SYMBOL, 92),
+    (31, HUFFMAN_EMIT_SYMBOL, 92),
+    (41, HUFFMAN_EMIT_SYMBOL, 92),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 92),
+    (3, HUFFMAN_EMIT_SYMBOL, 195),
+    (6, HUFFMAN_EMIT_SYMBOL, 195),
+    (10, HUFFMAN_EMIT_SYMBOL, 195),
+    (15, HUFFMAN_EMIT_SYMBOL, 195),
+    (24, HUFFMAN_EMIT_SYMBOL, 195),
+    (31, HUFFMAN_EMIT_SYMBOL, 195),
+    (41, HUFFMAN_EMIT_SYMBOL, 195),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 195),
+
+    # Node 99
+    (3, HUFFMAN_EMIT_SYMBOL, 208),
+    (6, HUFFMAN_EMIT_SYMBOL, 208),
+    (10, HUFFMAN_EMIT_SYMBOL, 208),
+    (15, HUFFMAN_EMIT_SYMBOL, 208),
+    (24, HUFFMAN_EMIT_SYMBOL, 208),
+    (31, HUFFMAN_EMIT_SYMBOL, 208),
+    (41, HUFFMAN_EMIT_SYMBOL, 208),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 208),
+    (2, HUFFMAN_EMIT_SYMBOL, 128),
+    (9, HUFFMAN_EMIT_SYMBOL, 128),
+    (23, HUFFMAN_EMIT_SYMBOL, 128),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 128),
+    (2, HUFFMAN_EMIT_SYMBOL, 130),
+    (9, HUFFMAN_EMIT_SYMBOL, 130),
+    (23, HUFFMAN_EMIT_SYMBOL, 130),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 130),
+
+    # Node 100
+    (3, HUFFMAN_EMIT_SYMBOL, 128),
+    (6, HUFFMAN_EMIT_SYMBOL, 128),
+    (10, HUFFMAN_EMIT_SYMBOL, 128),
+    (15, HUFFMAN_EMIT_SYMBOL, 128),
+    (24, HUFFMAN_EMIT_SYMBOL, 128),
+    (31, HUFFMAN_EMIT_SYMBOL, 128),
+    (41, HUFFMAN_EMIT_SYMBOL, 128),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 128),
+    (3, HUFFMAN_EMIT_SYMBOL, 130),
+    (6, HUFFMAN_EMIT_SYMBOL, 130),
+    (10, HUFFMAN_EMIT_SYMBOL, 130),
+    (15, HUFFMAN_EMIT_SYMBOL, 130),
+    (24, HUFFMAN_EMIT_SYMBOL, 130),
+    (31, HUFFMAN_EMIT_SYMBOL, 130),
+    (41, HUFFMAN_EMIT_SYMBOL, 130),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 130),
+
+    # Node 101
+    (1, HUFFMAN_EMIT_SYMBOL, 131),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 131),
+    (1, HUFFMAN_EMIT_SYMBOL, 162),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 162),
+    (1, HUFFMAN_EMIT_SYMBOL, 184),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 184),
+    (1, HUFFMAN_EMIT_SYMBOL, 194),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 194),
+    (1, HUFFMAN_EMIT_SYMBOL, 224),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 224),
+    (1, HUFFMAN_EMIT_SYMBOL, 226),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 226),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 153),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 161),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 167),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 172),
+
+    # Node 102
+    (2, HUFFMAN_EMIT_SYMBOL, 131),
+    (9, HUFFMAN_EMIT_SYMBOL, 131),
+    (23, HUFFMAN_EMIT_SYMBOL, 131),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 131),
+    (2, HUFFMAN_EMIT_SYMBOL, 162),
+    (9, HUFFMAN_EMIT_SYMBOL, 162),
+    (23, HUFFMAN_EMIT_SYMBOL, 162),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 162),
+    (2, HUFFMAN_EMIT_SYMBOL, 184),
+    (9, HUFFMAN_EMIT_SYMBOL, 184),
+    (23, HUFFMAN_EMIT_SYMBOL, 184),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 184),
+    (2, HUFFMAN_EMIT_SYMBOL, 194),
+    (9, HUFFMAN_EMIT_SYMBOL, 194),
+    (23, HUFFMAN_EMIT_SYMBOL, 194),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 194),
+
+    # Node 103
+    (3, HUFFMAN_EMIT_SYMBOL, 131),
+    (6, HUFFMAN_EMIT_SYMBOL, 131),
+    (10, HUFFMAN_EMIT_SYMBOL, 131),
+    (15, HUFFMAN_EMIT_SYMBOL, 131),
+    (24, HUFFMAN_EMIT_SYMBOL, 131),
+    (31, HUFFMAN_EMIT_SYMBOL, 131),
+    (41, HUFFMAN_EMIT_SYMBOL, 131),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 131),
+    (3, HUFFMAN_EMIT_SYMBOL, 162),
+    (6, HUFFMAN_EMIT_SYMBOL, 162),
+    (10, HUFFMAN_EMIT_SYMBOL, 162),
+    (15, HUFFMAN_EMIT_SYMBOL, 162),
+    (24, HUFFMAN_EMIT_SYMBOL, 162),
+    (31, HUFFMAN_EMIT_SYMBOL, 162),
+    (41, HUFFMAN_EMIT_SYMBOL, 162),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 162),
+
+    # Node 104
+    (3, HUFFMAN_EMIT_SYMBOL, 184),
+    (6, HUFFMAN_EMIT_SYMBOL, 184),
+    (10, HUFFMAN_EMIT_SYMBOL, 184),
+    (15, HUFFMAN_EMIT_SYMBOL, 184),
+    (24, HUFFMAN_EMIT_SYMBOL, 184),
+    (31, HUFFMAN_EMIT_SYMBOL, 184),
+    (41, HUFFMAN_EMIT_SYMBOL, 184),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 184),
+    (3, HUFFMAN_EMIT_SYMBOL, 194),
+    (6, HUFFMAN_EMIT_SYMBOL, 194),
+    (10, HUFFMAN_EMIT_SYMBOL, 194),
+    (15, HUFFMAN_EMIT_SYMBOL, 194),
+    (24, HUFFMAN_EMIT_SYMBOL, 194),
+    (31, HUFFMAN_EMIT_SYMBOL, 194),
+    (41, HUFFMAN_EMIT_SYMBOL, 194),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 194),
+
+    # Node 105
+    (2, HUFFMAN_EMIT_SYMBOL, 224),
+    (9, HUFFMAN_EMIT_SYMBOL, 224),
+    (23, HUFFMAN_EMIT_SYMBOL, 224),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 224),
+    (2, HUFFMAN_EMIT_SYMBOL, 226),
+    (9, HUFFMAN_EMIT_SYMBOL, 226),
+    (23, HUFFMAN_EMIT_SYMBOL, 226),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 226),
+    (1, HUFFMAN_EMIT_SYMBOL, 153),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 153),
+    (1, HUFFMAN_EMIT_SYMBOL, 161),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 161),
+    (1, HUFFMAN_EMIT_SYMBOL, 167),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 167),
+    (1, HUFFMAN_EMIT_SYMBOL, 172),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 172),
+
+    # Node 106
+    (3, HUFFMAN_EMIT_SYMBOL, 224),
+    (6, HUFFMAN_EMIT_SYMBOL, 224),
+    (10, HUFFMAN_EMIT_SYMBOL, 224),
+    (15, HUFFMAN_EMIT_SYMBOL, 224),
+    (24, HUFFMAN_EMIT_SYMBOL, 224),
+    (31, HUFFMAN_EMIT_SYMBOL, 224),
+    (41, HUFFMAN_EMIT_SYMBOL, 224),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 224),
+    (3, HUFFMAN_EMIT_SYMBOL, 226),
+    (6, HUFFMAN_EMIT_SYMBOL, 226),
+    (10, HUFFMAN_EMIT_SYMBOL, 226),
+    (15, HUFFMAN_EMIT_SYMBOL, 226),
+    (24, HUFFMAN_EMIT_SYMBOL, 226),
+    (31, HUFFMAN_EMIT_SYMBOL, 226),
+    (41, HUFFMAN_EMIT_SYMBOL, 226),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 226),
+
+    # Node 107
+    (2, HUFFMAN_EMIT_SYMBOL, 153),
+    (9, HUFFMAN_EMIT_SYMBOL, 153),
+    (23, HUFFMAN_EMIT_SYMBOL, 153),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 153),
+    (2, HUFFMAN_EMIT_SYMBOL, 161),
+    (9, HUFFMAN_EMIT_SYMBOL, 161),
+    (23, HUFFMAN_EMIT_SYMBOL, 161),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 161),
+    (2, HUFFMAN_EMIT_SYMBOL, 167),
+    (9, HUFFMAN_EMIT_SYMBOL, 167),
+    (23, HUFFMAN_EMIT_SYMBOL, 167),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 167),
+    (2, HUFFMAN_EMIT_SYMBOL, 172),
+    (9, HUFFMAN_EMIT_SYMBOL, 172),
+    (23, HUFFMAN_EMIT_SYMBOL, 172),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 172),
+
+    # Node 108
+    (3, HUFFMAN_EMIT_SYMBOL, 153),
+    (6, HUFFMAN_EMIT_SYMBOL, 153),
+    (10, HUFFMAN_EMIT_SYMBOL, 153),
+    (15, HUFFMAN_EMIT_SYMBOL, 153),
+    (24, HUFFMAN_EMIT_SYMBOL, 153),
+    (31, HUFFMAN_EMIT_SYMBOL, 153),
+    (41, HUFFMAN_EMIT_SYMBOL, 153),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 153),
+    (3, HUFFMAN_EMIT_SYMBOL, 161),
+    (6, HUFFMAN_EMIT_SYMBOL, 161),
+    (10, HUFFMAN_EMIT_SYMBOL, 161),
+    (15, HUFFMAN_EMIT_SYMBOL, 161),
+    (24, HUFFMAN_EMIT_SYMBOL, 161),
+    (31, HUFFMAN_EMIT_SYMBOL, 161),
+    (41, HUFFMAN_EMIT_SYMBOL, 161),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 161),
+
+    # Node 109
+    (3, HUFFMAN_EMIT_SYMBOL, 167),
+    (6, HUFFMAN_EMIT_SYMBOL, 167),
+    (10, HUFFMAN_EMIT_SYMBOL, 167),
+    (15, HUFFMAN_EMIT_SYMBOL, 167),
+    (24, HUFFMAN_EMIT_SYMBOL, 167),
+    (31, HUFFMAN_EMIT_SYMBOL, 167),
+    (41, HUFFMAN_EMIT_SYMBOL, 167),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 167),
+    (3, HUFFMAN_EMIT_SYMBOL, 172),
+    (6, HUFFMAN_EMIT_SYMBOL, 172),
+    (10, HUFFMAN_EMIT_SYMBOL, 172),
+    (15, HUFFMAN_EMIT_SYMBOL, 172),
+    (24, HUFFMAN_EMIT_SYMBOL, 172),
+    (31, HUFFMAN_EMIT_SYMBOL, 172),
+    (41, HUFFMAN_EMIT_SYMBOL, 172),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 172),
+
+    # Node 110
+    (114, 0, 0),
+    (115, 0, 0),
+    (117, 0, 0),
+    (118, 0, 0),
+    (121, 0, 0),
+    (123, 0, 0),
+    (127, 0, 0),
+    (130, 0, 0),
+    (136, 0, 0),
+    (139, 0, 0),
+    (143, 0, 0),
+    (146, 0, 0),
+    (155, 0, 0),
+    (162, 0, 0),
+    (170, 0, 0),
+    (180, 0, 0),
+
+    # Node 111
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 176),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 177),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 179),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 209),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 216),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 217),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 227),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 229),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 230),
+    (122, 0, 0),
+    (124, 0, 0),
+    (125, 0, 0),
+    (128, 0, 0),
+    (129, 0, 0),
+    (131, 0, 0),
+    (132, 0, 0),
+
+    # Node 112
+    (1, HUFFMAN_EMIT_SYMBOL, 176),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 176),
+    (1, HUFFMAN_EMIT_SYMBOL, 177),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 177),
+    (1, HUFFMAN_EMIT_SYMBOL, 179),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 179),
+    (1, HUFFMAN_EMIT_SYMBOL, 209),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 209),
+    (1, HUFFMAN_EMIT_SYMBOL, 216),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 216),
+    (1, HUFFMAN_EMIT_SYMBOL, 217),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 217),
+    (1, HUFFMAN_EMIT_SYMBOL, 227),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 227),
+    (1, HUFFMAN_EMIT_SYMBOL, 229),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 229),
+
+    # Node 113
+    (2, HUFFMAN_EMIT_SYMBOL, 176),
+    (9, HUFFMAN_EMIT_SYMBOL, 176),
+    (23, HUFFMAN_EMIT_SYMBOL, 176),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 176),
+    (2, HUFFMAN_EMIT_SYMBOL, 177),
+    (9, HUFFMAN_EMIT_SYMBOL, 177),
+    (23, HUFFMAN_EMIT_SYMBOL, 177),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 177),
+    (2, HUFFMAN_EMIT_SYMBOL, 179),
+    (9, HUFFMAN_EMIT_SYMBOL, 179),
+    (23, HUFFMAN_EMIT_SYMBOL, 179),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 179),
+    (2, HUFFMAN_EMIT_SYMBOL, 209),
+    (9, HUFFMAN_EMIT_SYMBOL, 209),
+    (23, HUFFMAN_EMIT_SYMBOL, 209),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 209),
+
+    # Node 114
+    (3, HUFFMAN_EMIT_SYMBOL, 176),
+    (6, HUFFMAN_EMIT_SYMBOL, 176),
+    (10, HUFFMAN_EMIT_SYMBOL, 176),
+    (15, HUFFMAN_EMIT_SYMBOL, 176),
+    (24, HUFFMAN_EMIT_SYMBOL, 176),
+    (31, HUFFMAN_EMIT_SYMBOL, 176),
+    (41, HUFFMAN_EMIT_SYMBOL, 176),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 176),
+    (3, HUFFMAN_EMIT_SYMBOL, 177),
+    (6, HUFFMAN_EMIT_SYMBOL, 177),
+    (10, HUFFMAN_EMIT_SYMBOL, 177),
+    (15, HUFFMAN_EMIT_SYMBOL, 177),
+    (24, HUFFMAN_EMIT_SYMBOL, 177),
+    (31, HUFFMAN_EMIT_SYMBOL, 177),
+    (41, HUFFMAN_EMIT_SYMBOL, 177),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 177),
+
+    # Node 115
+    (3, HUFFMAN_EMIT_SYMBOL, 179),
+    (6, HUFFMAN_EMIT_SYMBOL, 179),
+    (10, HUFFMAN_EMIT_SYMBOL, 179),
+    (15, HUFFMAN_EMIT_SYMBOL, 179),
+    (24, HUFFMAN_EMIT_SYMBOL, 179),
+    (31, HUFFMAN_EMIT_SYMBOL, 179),
+    (41, HUFFMAN_EMIT_SYMBOL, 179),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 179),
+    (3, HUFFMAN_EMIT_SYMBOL, 209),
+    (6, HUFFMAN_EMIT_SYMBOL, 209),
+    (10, HUFFMAN_EMIT_SYMBOL, 209),
+    (15, HUFFMAN_EMIT_SYMBOL, 209),
+    (24, HUFFMAN_EMIT_SYMBOL, 209),
+    (31, HUFFMAN_EMIT_SYMBOL, 209),
+    (41, HUFFMAN_EMIT_SYMBOL, 209),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 209),
+
+    # Node 116
+    (2, HUFFMAN_EMIT_SYMBOL, 216),
+    (9, HUFFMAN_EMIT_SYMBOL, 216),
+    (23, HUFFMAN_EMIT_SYMBOL, 216),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 216),
+    (2, HUFFMAN_EMIT_SYMBOL, 217),
+    (9, HUFFMAN_EMIT_SYMBOL, 217),
+    (23, HUFFMAN_EMIT_SYMBOL, 217),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 217),
+    (2, HUFFMAN_EMIT_SYMBOL, 227),
+    (9, HUFFMAN_EMIT_SYMBOL, 227),
+    (23, HUFFMAN_EMIT_SYMBOL, 227),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 227),
+    (2, HUFFMAN_EMIT_SYMBOL, 229),
+    (9, HUFFMAN_EMIT_SYMBOL, 229),
+    (23, HUFFMAN_EMIT_SYMBOL, 229),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 229),
+
+    # Node 117
+    (3, HUFFMAN_EMIT_SYMBOL, 216),
+    (6, HUFFMAN_EMIT_SYMBOL, 216),
+    (10, HUFFMAN_EMIT_SYMBOL, 216),
+    (15, HUFFMAN_EMIT_SYMBOL, 216),
+    (24, HUFFMAN_EMIT_SYMBOL, 216),
+    (31, HUFFMAN_EMIT_SYMBOL, 216),
+    (41, HUFFMAN_EMIT_SYMBOL, 216),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 216),
+    (3, HUFFMAN_EMIT_SYMBOL, 217),
+    (6, HUFFMAN_EMIT_SYMBOL, 217),
+    (10, HUFFMAN_EMIT_SYMBOL, 217),
+    (15, HUFFMAN_EMIT_SYMBOL, 217),
+    (24, HUFFMAN_EMIT_SYMBOL, 217),
+    (31, HUFFMAN_EMIT_SYMBOL, 217),
+    (41, HUFFMAN_EMIT_SYMBOL, 217),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 217),
+
+    # Node 118
+    (3, HUFFMAN_EMIT_SYMBOL, 227),
+    (6, HUFFMAN_EMIT_SYMBOL, 227),
+    (10, HUFFMAN_EMIT_SYMBOL, 227),
+    (15, HUFFMAN_EMIT_SYMBOL, 227),
+    (24, HUFFMAN_EMIT_SYMBOL, 227),
+    (31, HUFFMAN_EMIT_SYMBOL, 227),
+    (41, HUFFMAN_EMIT_SYMBOL, 227),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 227),
+    (3, HUFFMAN_EMIT_SYMBOL, 229),
+    (6, HUFFMAN_EMIT_SYMBOL, 229),
+    (10, HUFFMAN_EMIT_SYMBOL, 229),
+    (15, HUFFMAN_EMIT_SYMBOL, 229),
+    (24, HUFFMAN_EMIT_SYMBOL, 229),
+    (31, HUFFMAN_EMIT_SYMBOL, 229),
+    (41, HUFFMAN_EMIT_SYMBOL, 229),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 229),
+
+    # Node 119
+    (1, HUFFMAN_EMIT_SYMBOL, 230),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 230),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 129),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 132),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 133),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 134),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 136),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 146),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 154),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 156),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 160),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 163),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 164),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 169),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 170),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 173),
+
+    # Node 120
+    (2, HUFFMAN_EMIT_SYMBOL, 230),
+    (9, HUFFMAN_EMIT_SYMBOL, 230),
+    (23, HUFFMAN_EMIT_SYMBOL, 230),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 230),
+    (1, HUFFMAN_EMIT_SYMBOL, 129),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 129),
+    (1, HUFFMAN_EMIT_SYMBOL, 132),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 132),
+    (1, HUFFMAN_EMIT_SYMBOL, 133),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 133),
+    (1, HUFFMAN_EMIT_SYMBOL, 134),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 134),
+    (1, HUFFMAN_EMIT_SYMBOL, 136),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 136),
+    (1, HUFFMAN_EMIT_SYMBOL, 146),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 146),
+
+    # Node 121
+    (3, HUFFMAN_EMIT_SYMBOL, 230),
+    (6, HUFFMAN_EMIT_SYMBOL, 230),
+    (10, HUFFMAN_EMIT_SYMBOL, 230),
+    (15, HUFFMAN_EMIT_SYMBOL, 230),
+    (24, HUFFMAN_EMIT_SYMBOL, 230),
+    (31, HUFFMAN_EMIT_SYMBOL, 230),
+    (41, HUFFMAN_EMIT_SYMBOL, 230),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 230),
+    (2, HUFFMAN_EMIT_SYMBOL, 129),
+    (9, HUFFMAN_EMIT_SYMBOL, 129),
+    (23, HUFFMAN_EMIT_SYMBOL, 129),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 129),
+    (2, HUFFMAN_EMIT_SYMBOL, 132),
+    (9, HUFFMAN_EMIT_SYMBOL, 132),
+    (23, HUFFMAN_EMIT_SYMBOL, 132),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 132),
+
+    # Node 122
+    (3, HUFFMAN_EMIT_SYMBOL, 129),
+    (6, HUFFMAN_EMIT_SYMBOL, 129),
+    (10, HUFFMAN_EMIT_SYMBOL, 129),
+    (15, HUFFMAN_EMIT_SYMBOL, 129),
+    (24, HUFFMAN_EMIT_SYMBOL, 129),
+    (31, HUFFMAN_EMIT_SYMBOL, 129),
+    (41, HUFFMAN_EMIT_SYMBOL, 129),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 129),
+    (3, HUFFMAN_EMIT_SYMBOL, 132),
+    (6, HUFFMAN_EMIT_SYMBOL, 132),
+    (10, HUFFMAN_EMIT_SYMBOL, 132),
+    (15, HUFFMAN_EMIT_SYMBOL, 132),
+    (24, HUFFMAN_EMIT_SYMBOL, 132),
+    (31, HUFFMAN_EMIT_SYMBOL, 132),
+    (41, HUFFMAN_EMIT_SYMBOL, 132),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 132),
+
+    # Node 123
+    (2, HUFFMAN_EMIT_SYMBOL, 133),
+    (9, HUFFMAN_EMIT_SYMBOL, 133),
+    (23, HUFFMAN_EMIT_SYMBOL, 133),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 133),
+    (2, HUFFMAN_EMIT_SYMBOL, 134),
+    (9, HUFFMAN_EMIT_SYMBOL, 134),
+    (23, HUFFMAN_EMIT_SYMBOL, 134),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 134),
+    (2, HUFFMAN_EMIT_SYMBOL, 136),
+    (9, HUFFMAN_EMIT_SYMBOL, 136),
+    (23, HUFFMAN_EMIT_SYMBOL, 136),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 136),
+    (2, HUFFMAN_EMIT_SYMBOL, 146),
+    (9, HUFFMAN_EMIT_SYMBOL, 146),
+    (23, HUFFMAN_EMIT_SYMBOL, 146),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 146),
+
+    # Node 124
+    (3, HUFFMAN_EMIT_SYMBOL, 133),
+    (6, HUFFMAN_EMIT_SYMBOL, 133),
+    (10, HUFFMAN_EMIT_SYMBOL, 133),
+    (15, HUFFMAN_EMIT_SYMBOL, 133),
+    (24, HUFFMAN_EMIT_SYMBOL, 133),
+    (31, HUFFMAN_EMIT_SYMBOL, 133),
+    (41, HUFFMAN_EMIT_SYMBOL, 133),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 133),
+    (3, HUFFMAN_EMIT_SYMBOL, 134),
+    (6, HUFFMAN_EMIT_SYMBOL, 134),
+    (10, HUFFMAN_EMIT_SYMBOL, 134),
+    (15, HUFFMAN_EMIT_SYMBOL, 134),
+    (24, HUFFMAN_EMIT_SYMBOL, 134),
+    (31, HUFFMAN_EMIT_SYMBOL, 134),
+    (41, HUFFMAN_EMIT_SYMBOL, 134),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 134),
+
+    # Node 125
+    (3, HUFFMAN_EMIT_SYMBOL, 136),
+    (6, HUFFMAN_EMIT_SYMBOL, 136),
+    (10, HUFFMAN_EMIT_SYMBOL, 136),
+    (15, HUFFMAN_EMIT_SYMBOL, 136),
+    (24, HUFFMAN_EMIT_SYMBOL, 136),
+    (31, HUFFMAN_EMIT_SYMBOL, 136),
+    (41, HUFFMAN_EMIT_SYMBOL, 136),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 136),
+    (3, HUFFMAN_EMIT_SYMBOL, 146),
+    (6, HUFFMAN_EMIT_SYMBOL, 146),
+    (10, HUFFMAN_EMIT_SYMBOL, 146),
+    (15, HUFFMAN_EMIT_SYMBOL, 146),
+    (24, HUFFMAN_EMIT_SYMBOL, 146),
+    (31, HUFFMAN_EMIT_SYMBOL, 146),
+    (41, HUFFMAN_EMIT_SYMBOL, 146),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 146),
+
+    # Node 126
+    (1, HUFFMAN_EMIT_SYMBOL, 154),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 154),
+    (1, HUFFMAN_EMIT_SYMBOL, 156),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 156),
+    (1, HUFFMAN_EMIT_SYMBOL, 160),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 160),
+    (1, HUFFMAN_EMIT_SYMBOL, 163),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 163),
+    (1, HUFFMAN_EMIT_SYMBOL, 164),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 164),
+    (1, HUFFMAN_EMIT_SYMBOL, 169),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 169),
+    (1, HUFFMAN_EMIT_SYMBOL, 170),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 170),
+    (1, HUFFMAN_EMIT_SYMBOL, 173),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 173),
+
+    # Node 127
+    (2, HUFFMAN_EMIT_SYMBOL, 154),
+    (9, HUFFMAN_EMIT_SYMBOL, 154),
+    (23, HUFFMAN_EMIT_SYMBOL, 154),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 154),
+    (2, HUFFMAN_EMIT_SYMBOL, 156),
+    (9, HUFFMAN_EMIT_SYMBOL, 156),
+    (23, HUFFMAN_EMIT_SYMBOL, 156),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 156),
+    (2, HUFFMAN_EMIT_SYMBOL, 160),
+    (9, HUFFMAN_EMIT_SYMBOL, 160),
+    (23, HUFFMAN_EMIT_SYMBOL, 160),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 160),
+    (2, HUFFMAN_EMIT_SYMBOL, 163),
+    (9, HUFFMAN_EMIT_SYMBOL, 163),
+    (23, HUFFMAN_EMIT_SYMBOL, 163),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 163),
+
+    # Node 128
+    (3, HUFFMAN_EMIT_SYMBOL, 154),
+    (6, HUFFMAN_EMIT_SYMBOL, 154),
+    (10, HUFFMAN_EMIT_SYMBOL, 154),
+    (15, HUFFMAN_EMIT_SYMBOL, 154),
+    (24, HUFFMAN_EMIT_SYMBOL, 154),
+    (31, HUFFMAN_EMIT_SYMBOL, 154),
+    (41, HUFFMAN_EMIT_SYMBOL, 154),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 154),
+    (3, HUFFMAN_EMIT_SYMBOL, 156),
+    (6, HUFFMAN_EMIT_SYMBOL, 156),
+    (10, HUFFMAN_EMIT_SYMBOL, 156),
+    (15, HUFFMAN_EMIT_SYMBOL, 156),
+    (24, HUFFMAN_EMIT_SYMBOL, 156),
+    (31, HUFFMAN_EMIT_SYMBOL, 156),
+    (41, HUFFMAN_EMIT_SYMBOL, 156),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 156),
+
+    # Node 129
+    (3, HUFFMAN_EMIT_SYMBOL, 160),
+    (6, HUFFMAN_EMIT_SYMBOL, 160),
+    (10, HUFFMAN_EMIT_SYMBOL, 160),
+    (15, HUFFMAN_EMIT_SYMBOL, 160),
+    (24, HUFFMAN_EMIT_SYMBOL, 160),
+    (31, HUFFMAN_EMIT_SYMBOL, 160),
+    (41, HUFFMAN_EMIT_SYMBOL, 160),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 160),
+    (3, HUFFMAN_EMIT_SYMBOL, 163),
+    (6, HUFFMAN_EMIT_SYMBOL, 163),
+    (10, HUFFMAN_EMIT_SYMBOL, 163),
+    (15, HUFFMAN_EMIT_SYMBOL, 163),
+    (24, HUFFMAN_EMIT_SYMBOL, 163),
+    (31, HUFFMAN_EMIT_SYMBOL, 163),
+    (41, HUFFMAN_EMIT_SYMBOL, 163),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 163),
+
+    # Node 130
+    (2, HUFFMAN_EMIT_SYMBOL, 164),
+    (9, HUFFMAN_EMIT_SYMBOL, 164),
+    (23, HUFFMAN_EMIT_SYMBOL, 164),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 164),
+    (2, HUFFMAN_EMIT_SYMBOL, 169),
+    (9, HUFFMAN_EMIT_SYMBOL, 169),
+    (23, HUFFMAN_EMIT_SYMBOL, 169),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 169),
+    (2, HUFFMAN_EMIT_SYMBOL, 170),
+    (9, HUFFMAN_EMIT_SYMBOL, 170),
+    (23, HUFFMAN_EMIT_SYMBOL, 170),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 170),
+    (2, HUFFMAN_EMIT_SYMBOL, 173),
+    (9, HUFFMAN_EMIT_SYMBOL, 173),
+    (23, HUFFMAN_EMIT_SYMBOL, 173),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 173),
+
+    # Node 131
+    (3, HUFFMAN_EMIT_SYMBOL, 164),
+    (6, HUFFMAN_EMIT_SYMBOL, 164),
+    (10, HUFFMAN_EMIT_SYMBOL, 164),
+    (15, HUFFMAN_EMIT_SYMBOL, 164),
+    (24, HUFFMAN_EMIT_SYMBOL, 164),
+    (31, HUFFMAN_EMIT_SYMBOL, 164),
+    (41, HUFFMAN_EMIT_SYMBOL, 164),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 164),
+    (3, HUFFMAN_EMIT_SYMBOL, 169),
+    (6, HUFFMAN_EMIT_SYMBOL, 169),
+    (10, HUFFMAN_EMIT_SYMBOL, 169),
+    (15, HUFFMAN_EMIT_SYMBOL, 169),
+    (24, HUFFMAN_EMIT_SYMBOL, 169),
+    (31, HUFFMAN_EMIT_SYMBOL, 169),
+    (41, HUFFMAN_EMIT_SYMBOL, 169),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 169),
+
+    # Node 132
+    (3, HUFFMAN_EMIT_SYMBOL, 170),
+    (6, HUFFMAN_EMIT_SYMBOL, 170),
+    (10, HUFFMAN_EMIT_SYMBOL, 170),
+    (15, HUFFMAN_EMIT_SYMBOL, 170),
+    (24, HUFFMAN_EMIT_SYMBOL, 170),
+    (31, HUFFMAN_EMIT_SYMBOL, 170),
+    (41, HUFFMAN_EMIT_SYMBOL, 170),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 170),
+    (3, HUFFMAN_EMIT_SYMBOL, 173),
+    (6, HUFFMAN_EMIT_SYMBOL, 173),
+    (10, HUFFMAN_EMIT_SYMBOL, 173),
+    (15, HUFFMAN_EMIT_SYMBOL, 173),
+    (24, HUFFMAN_EMIT_SYMBOL, 173),
+    (31, HUFFMAN_EMIT_SYMBOL, 173),
+    (41, HUFFMAN_EMIT_SYMBOL, 173),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 173),
+
+    # Node 133
+    (137, 0, 0),
+    (138, 0, 0),
+    (140, 0, 0),
+    (141, 0, 0),
+    (144, 0, 0),
+    (145, 0, 0),
+    (147, 0, 0),
+    (150, 0, 0),
+    (156, 0, 0),
+    (159, 0, 0),
+    (163, 0, 0),
+    (166, 0, 0),
+    (171, 0, 0),
+    (174, 0, 0),
+    (181, 0, 0),
+    (190, 0, 0),
+
+    # Node 134
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 178),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 181),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 185),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 186),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 187),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 189),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 190),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 196),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 198),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 228),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 232),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 233),
+    (148, 0, 0),
+    (149, 0, 0),
+    (151, 0, 0),
+    (152, 0, 0),
+
+    # Node 135
+    (1, HUFFMAN_EMIT_SYMBOL, 178),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 178),
+    (1, HUFFMAN_EMIT_SYMBOL, 181),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 181),
+    (1, HUFFMAN_EMIT_SYMBOL, 185),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 185),
+    (1, HUFFMAN_EMIT_SYMBOL, 186),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 186),
+    (1, HUFFMAN_EMIT_SYMBOL, 187),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 187),
+    (1, HUFFMAN_EMIT_SYMBOL, 189),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 189),
+    (1, HUFFMAN_EMIT_SYMBOL, 190),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 190),
+    (1, HUFFMAN_EMIT_SYMBOL, 196),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 196),
+
+    # Node 136
+    (2, HUFFMAN_EMIT_SYMBOL, 178),
+    (9, HUFFMAN_EMIT_SYMBOL, 178),
+    (23, HUFFMAN_EMIT_SYMBOL, 178),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 178),
+    (2, HUFFMAN_EMIT_SYMBOL, 181),
+    (9, HUFFMAN_EMIT_SYMBOL, 181),
+    (23, HUFFMAN_EMIT_SYMBOL, 181),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 181),
+    (2, HUFFMAN_EMIT_SYMBOL, 185),
+    (9, HUFFMAN_EMIT_SYMBOL, 185),
+    (23, HUFFMAN_EMIT_SYMBOL, 185),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 185),
+    (2, HUFFMAN_EMIT_SYMBOL, 186),
+    (9, HUFFMAN_EMIT_SYMBOL, 186),
+    (23, HUFFMAN_EMIT_SYMBOL, 186),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 186),
+
+    # Node 137
+    (3, HUFFMAN_EMIT_SYMBOL, 178),
+    (6, HUFFMAN_EMIT_SYMBOL, 178),
+    (10, HUFFMAN_EMIT_SYMBOL, 178),
+    (15, HUFFMAN_EMIT_SYMBOL, 178),
+    (24, HUFFMAN_EMIT_SYMBOL, 178),
+    (31, HUFFMAN_EMIT_SYMBOL, 178),
+    (41, HUFFMAN_EMIT_SYMBOL, 178),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 178),
+    (3, HUFFMAN_EMIT_SYMBOL, 181),
+    (6, HUFFMAN_EMIT_SYMBOL, 181),
+    (10, HUFFMAN_EMIT_SYMBOL, 181),
+    (15, HUFFMAN_EMIT_SYMBOL, 181),
+    (24, HUFFMAN_EMIT_SYMBOL, 181),
+    (31, HUFFMAN_EMIT_SYMBOL, 181),
+    (41, HUFFMAN_EMIT_SYMBOL, 181),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 181),
+
+    # Node 138
+    (3, HUFFMAN_EMIT_SYMBOL, 185),
+    (6, HUFFMAN_EMIT_SYMBOL, 185),
+    (10, HUFFMAN_EMIT_SYMBOL, 185),
+    (15, HUFFMAN_EMIT_SYMBOL, 185),
+    (24, HUFFMAN_EMIT_SYMBOL, 185),
+    (31, HUFFMAN_EMIT_SYMBOL, 185),
+    (41, HUFFMAN_EMIT_SYMBOL, 185),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 185),
+    (3, HUFFMAN_EMIT_SYMBOL, 186),
+    (6, HUFFMAN_EMIT_SYMBOL, 186),
+    (10, HUFFMAN_EMIT_SYMBOL, 186),
+    (15, HUFFMAN_EMIT_SYMBOL, 186),
+    (24, HUFFMAN_EMIT_SYMBOL, 186),
+    (31, HUFFMAN_EMIT_SYMBOL, 186),
+    (41, HUFFMAN_EMIT_SYMBOL, 186),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 186),
+
+    # Node 139
+    (2, HUFFMAN_EMIT_SYMBOL, 187),
+    (9, HUFFMAN_EMIT_SYMBOL, 187),
+    (23, HUFFMAN_EMIT_SYMBOL, 187),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 187),
+    (2, HUFFMAN_EMIT_SYMBOL, 189),
+    (9, HUFFMAN_EMIT_SYMBOL, 189),
+    (23, HUFFMAN_EMIT_SYMBOL, 189),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 189),
+    (2, HUFFMAN_EMIT_SYMBOL, 190),
+    (9, HUFFMAN_EMIT_SYMBOL, 190),
+    (23, HUFFMAN_EMIT_SYMBOL, 190),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 190),
+    (2, HUFFMAN_EMIT_SYMBOL, 196),
+    (9, HUFFMAN_EMIT_SYMBOL, 196),
+    (23, HUFFMAN_EMIT_SYMBOL, 196),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 196),
+
+    # Node 140
+    (3, HUFFMAN_EMIT_SYMBOL, 187),
+    (6, HUFFMAN_EMIT_SYMBOL, 187),
+    (10, HUFFMAN_EMIT_SYMBOL, 187),
+    (15, HUFFMAN_EMIT_SYMBOL, 187),
+    (24, HUFFMAN_EMIT_SYMBOL, 187),
+    (31, HUFFMAN_EMIT_SYMBOL, 187),
+    (41, HUFFMAN_EMIT_SYMBOL, 187),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 187),
+    (3, HUFFMAN_EMIT_SYMBOL, 189),
+    (6, HUFFMAN_EMIT_SYMBOL, 189),
+    (10, HUFFMAN_EMIT_SYMBOL, 189),
+    (15, HUFFMAN_EMIT_SYMBOL, 189),
+    (24, HUFFMAN_EMIT_SYMBOL, 189),
+    (31, HUFFMAN_EMIT_SYMBOL, 189),
+    (41, HUFFMAN_EMIT_SYMBOL, 189),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 189),
+
+    # Node 141
+    (3, HUFFMAN_EMIT_SYMBOL, 190),
+    (6, HUFFMAN_EMIT_SYMBOL, 190),
+    (10, HUFFMAN_EMIT_SYMBOL, 190),
+    (15, HUFFMAN_EMIT_SYMBOL, 190),
+    (24, HUFFMAN_EMIT_SYMBOL, 190),
+    (31, HUFFMAN_EMIT_SYMBOL, 190),
+    (41, HUFFMAN_EMIT_SYMBOL, 190),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 190),
+    (3, HUFFMAN_EMIT_SYMBOL, 196),
+    (6, HUFFMAN_EMIT_SYMBOL, 196),
+    (10, HUFFMAN_EMIT_SYMBOL, 196),
+    (15, HUFFMAN_EMIT_SYMBOL, 196),
+    (24, HUFFMAN_EMIT_SYMBOL, 196),
+    (31, HUFFMAN_EMIT_SYMBOL, 196),
+    (41, HUFFMAN_EMIT_SYMBOL, 196),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 196),
+
+    # Node 142
+    (1, HUFFMAN_EMIT_SYMBOL, 198),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 198),
+    (1, HUFFMAN_EMIT_SYMBOL, 228),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 228),
+    (1, HUFFMAN_EMIT_SYMBOL, 232),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 232),
+    (1, HUFFMAN_EMIT_SYMBOL, 233),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 233),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 1),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 135),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 137),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 138),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 139),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 140),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 141),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 143),
+
+    # Node 143
+    (2, HUFFMAN_EMIT_SYMBOL, 198),
+    (9, HUFFMAN_EMIT_SYMBOL, 198),
+    (23, HUFFMAN_EMIT_SYMBOL, 198),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 198),
+    (2, HUFFMAN_EMIT_SYMBOL, 228),
+    (9, HUFFMAN_EMIT_SYMBOL, 228),
+    (23, HUFFMAN_EMIT_SYMBOL, 228),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 228),
+    (2, HUFFMAN_EMIT_SYMBOL, 232),
+    (9, HUFFMAN_EMIT_SYMBOL, 232),
+    (23, HUFFMAN_EMIT_SYMBOL, 232),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 232),
+    (2, HUFFMAN_EMIT_SYMBOL, 233),
+    (9, HUFFMAN_EMIT_SYMBOL, 233),
+    (23, HUFFMAN_EMIT_SYMBOL, 233),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 233),
+
+    # Node 144
+    (3, HUFFMAN_EMIT_SYMBOL, 198),
+    (6, HUFFMAN_EMIT_SYMBOL, 198),
+    (10, HUFFMAN_EMIT_SYMBOL, 198),
+    (15, HUFFMAN_EMIT_SYMBOL, 198),
+    (24, HUFFMAN_EMIT_SYMBOL, 198),
+    (31, HUFFMAN_EMIT_SYMBOL, 198),
+    (41, HUFFMAN_EMIT_SYMBOL, 198),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 198),
+    (3, HUFFMAN_EMIT_SYMBOL, 228),
+    (6, HUFFMAN_EMIT_SYMBOL, 228),
+    (10, HUFFMAN_EMIT_SYMBOL, 228),
+    (15, HUFFMAN_EMIT_SYMBOL, 228),
+    (24, HUFFMAN_EMIT_SYMBOL, 228),
+    (31, HUFFMAN_EMIT_SYMBOL, 228),
+    (41, HUFFMAN_EMIT_SYMBOL, 228),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 228),
+
+    # Node 145
+    (3, HUFFMAN_EMIT_SYMBOL, 232),
+    (6, HUFFMAN_EMIT_SYMBOL, 232),
+    (10, HUFFMAN_EMIT_SYMBOL, 232),
+    (15, HUFFMAN_EMIT_SYMBOL, 232),
+    (24, HUFFMAN_EMIT_SYMBOL, 232),
+    (31, HUFFMAN_EMIT_SYMBOL, 232),
+    (41, HUFFMAN_EMIT_SYMBOL, 232),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 232),
+    (3, HUFFMAN_EMIT_SYMBOL, 233),
+    (6, HUFFMAN_EMIT_SYMBOL, 233),
+    (10, HUFFMAN_EMIT_SYMBOL, 233),
+    (15, HUFFMAN_EMIT_SYMBOL, 233),
+    (24, HUFFMAN_EMIT_SYMBOL, 233),
+    (31, HUFFMAN_EMIT_SYMBOL, 233),
+    (41, HUFFMAN_EMIT_SYMBOL, 233),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 233),
+
+    # Node 146
+    (1, HUFFMAN_EMIT_SYMBOL, 1),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 1),
+    (1, HUFFMAN_EMIT_SYMBOL, 135),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 135),
+    (1, HUFFMAN_EMIT_SYMBOL, 137),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 137),
+    (1, HUFFMAN_EMIT_SYMBOL, 138),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 138),
+    (1, HUFFMAN_EMIT_SYMBOL, 139),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 139),
+    (1, HUFFMAN_EMIT_SYMBOL, 140),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 140),
+    (1, HUFFMAN_EMIT_SYMBOL, 141),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 141),
+    (1, HUFFMAN_EMIT_SYMBOL, 143),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 143),
+
+    # Node 147
+    (2, HUFFMAN_EMIT_SYMBOL, 1),
+    (9, HUFFMAN_EMIT_SYMBOL, 1),
+    (23, HUFFMAN_EMIT_SYMBOL, 1),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 1),
+    (2, HUFFMAN_EMIT_SYMBOL, 135),
+    (9, HUFFMAN_EMIT_SYMBOL, 135),
+    (23, HUFFMAN_EMIT_SYMBOL, 135),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 135),
+    (2, HUFFMAN_EMIT_SYMBOL, 137),
+    (9, HUFFMAN_EMIT_SYMBOL, 137),
+    (23, HUFFMAN_EMIT_SYMBOL, 137),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 137),
+    (2, HUFFMAN_EMIT_SYMBOL, 138),
+    (9, HUFFMAN_EMIT_SYMBOL, 138),
+    (23, HUFFMAN_EMIT_SYMBOL, 138),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 138),
+
+    # Node 148
+    (3, HUFFMAN_EMIT_SYMBOL, 1),
+    (6, HUFFMAN_EMIT_SYMBOL, 1),
+    (10, HUFFMAN_EMIT_SYMBOL, 1),
+    (15, HUFFMAN_EMIT_SYMBOL, 1),
+    (24, HUFFMAN_EMIT_SYMBOL, 1),
+    (31, HUFFMAN_EMIT_SYMBOL, 1),
+    (41, HUFFMAN_EMIT_SYMBOL, 1),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 1),
+    (3, HUFFMAN_EMIT_SYMBOL, 135),
+    (6, HUFFMAN_EMIT_SYMBOL, 135),
+    (10, HUFFMAN_EMIT_SYMBOL, 135),
+    (15, HUFFMAN_EMIT_SYMBOL, 135),
+    (24, HUFFMAN_EMIT_SYMBOL, 135),
+    (31, HUFFMAN_EMIT_SYMBOL, 135),
+    (41, HUFFMAN_EMIT_SYMBOL, 135),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 135),
+
+    # Node 149
+    (3, HUFFMAN_EMIT_SYMBOL, 137),
+    (6, HUFFMAN_EMIT_SYMBOL, 137),
+    (10, HUFFMAN_EMIT_SYMBOL, 137),
+    (15, HUFFMAN_EMIT_SYMBOL, 137),
+    (24, HUFFMAN_EMIT_SYMBOL, 137),
+    (31, HUFFMAN_EMIT_SYMBOL, 137),
+    (41, HUFFMAN_EMIT_SYMBOL, 137),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 137),
+    (3, HUFFMAN_EMIT_SYMBOL, 138),
+    (6, HUFFMAN_EMIT_SYMBOL, 138),
+    (10, HUFFMAN_EMIT_SYMBOL, 138),
+    (15, HUFFMAN_EMIT_SYMBOL, 138),
+    (24, HUFFMAN_EMIT_SYMBOL, 138),
+    (31, HUFFMAN_EMIT_SYMBOL, 138),
+    (41, HUFFMAN_EMIT_SYMBOL, 138),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 138),
+
+    # Node 150
+    (2, HUFFMAN_EMIT_SYMBOL, 139),
+    (9, HUFFMAN_EMIT_SYMBOL, 139),
+    (23, HUFFMAN_EMIT_SYMBOL, 139),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 139),
+    (2, HUFFMAN_EMIT_SYMBOL, 140),
+    (9, HUFFMAN_EMIT_SYMBOL, 140),
+    (23, HUFFMAN_EMIT_SYMBOL, 140),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 140),
+    (2, HUFFMAN_EMIT_SYMBOL, 141),
+    (9, HUFFMAN_EMIT_SYMBOL, 141),
+    (23, HUFFMAN_EMIT_SYMBOL, 141),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 141),
+    (2, HUFFMAN_EMIT_SYMBOL, 143),
+    (9, HUFFMAN_EMIT_SYMBOL, 143),
+    (23, HUFFMAN_EMIT_SYMBOL, 143),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 143),
+
+    # Node 151
+    (3, HUFFMAN_EMIT_SYMBOL, 139),
+    (6, HUFFMAN_EMIT_SYMBOL, 139),
+    (10, HUFFMAN_EMIT_SYMBOL, 139),
+    (15, HUFFMAN_EMIT_SYMBOL, 139),
+    (24, HUFFMAN_EMIT_SYMBOL, 139),
+    (31, HUFFMAN_EMIT_SYMBOL, 139),
+    (41, HUFFMAN_EMIT_SYMBOL, 139),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 139),
+    (3, HUFFMAN_EMIT_SYMBOL, 140),
+    (6, HUFFMAN_EMIT_SYMBOL, 140),
+    (10, HUFFMAN_EMIT_SYMBOL, 140),
+    (15, HUFFMAN_EMIT_SYMBOL, 140),
+    (24, HUFFMAN_EMIT_SYMBOL, 140),
+    (31, HUFFMAN_EMIT_SYMBOL, 140),
+    (41, HUFFMAN_EMIT_SYMBOL, 140),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 140),
+
+    # Node 152
+    (3, HUFFMAN_EMIT_SYMBOL, 141),
+    (6, HUFFMAN_EMIT_SYMBOL, 141),
+    (10, HUFFMAN_EMIT_SYMBOL, 141),
+    (15, HUFFMAN_EMIT_SYMBOL, 141),
+    (24, HUFFMAN_EMIT_SYMBOL, 141),
+    (31, HUFFMAN_EMIT_SYMBOL, 141),
+    (41, HUFFMAN_EMIT_SYMBOL, 141),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 141),
+    (3, HUFFMAN_EMIT_SYMBOL, 143),
+    (6, HUFFMAN_EMIT_SYMBOL, 143),
+    (10, HUFFMAN_EMIT_SYMBOL, 143),
+    (15, HUFFMAN_EMIT_SYMBOL, 143),
+    (24, HUFFMAN_EMIT_SYMBOL, 143),
+    (31, HUFFMAN_EMIT_SYMBOL, 143),
+    (41, HUFFMAN_EMIT_SYMBOL, 143),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 143),
+
+    # Node 153
+    (157, 0, 0),
+    (158, 0, 0),
+    (160, 0, 0),
+    (161, 0, 0),
+    (164, 0, 0),
+    (165, 0, 0),
+    (167, 0, 0),
+    (168, 0, 0),
+    (172, 0, 0),
+    (173, 0, 0),
+    (175, 0, 0),
+    (177, 0, 0),
+    (182, 0, 0),
+    (185, 0, 0),
+    (191, 0, 0),
+    (207, 0, 0),
+
+    # Node 154
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 147),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 149),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 150),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 151),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 152),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 155),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 157),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 158),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 165),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 166),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 168),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 174),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 175),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 180),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 182),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 183),
+
+    # Node 155
+    (1, HUFFMAN_EMIT_SYMBOL, 147),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 147),
+    (1, HUFFMAN_EMIT_SYMBOL, 149),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 149),
+    (1, HUFFMAN_EMIT_SYMBOL, 150),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 150),
+    (1, HUFFMAN_EMIT_SYMBOL, 151),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 151),
+    (1, HUFFMAN_EMIT_SYMBOL, 152),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 152),
+    (1, HUFFMAN_EMIT_SYMBOL, 155),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 155),
+    (1, HUFFMAN_EMIT_SYMBOL, 157),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 157),
+    (1, HUFFMAN_EMIT_SYMBOL, 158),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 158),
+
+    # Node 156
+    (2, HUFFMAN_EMIT_SYMBOL, 147),
+    (9, HUFFMAN_EMIT_SYMBOL, 147),
+    (23, HUFFMAN_EMIT_SYMBOL, 147),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 147),
+    (2, HUFFMAN_EMIT_SYMBOL, 149),
+    (9, HUFFMAN_EMIT_SYMBOL, 149),
+    (23, HUFFMAN_EMIT_SYMBOL, 149),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 149),
+    (2, HUFFMAN_EMIT_SYMBOL, 150),
+    (9, HUFFMAN_EMIT_SYMBOL, 150),
+    (23, HUFFMAN_EMIT_SYMBOL, 150),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 150),
+    (2, HUFFMAN_EMIT_SYMBOL, 151),
+    (9, HUFFMAN_EMIT_SYMBOL, 151),
+    (23, HUFFMAN_EMIT_SYMBOL, 151),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 151),
+
+    # Node 157
+    (3, HUFFMAN_EMIT_SYMBOL, 147),
+    (6, HUFFMAN_EMIT_SYMBOL, 147),
+    (10, HUFFMAN_EMIT_SYMBOL, 147),
+    (15, HUFFMAN_EMIT_SYMBOL, 147),
+    (24, HUFFMAN_EMIT_SYMBOL, 147),
+    (31, HUFFMAN_EMIT_SYMBOL, 147),
+    (41, HUFFMAN_EMIT_SYMBOL, 147),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 147),
+    (3, HUFFMAN_EMIT_SYMBOL, 149),
+    (6, HUFFMAN_EMIT_SYMBOL, 149),
+    (10, HUFFMAN_EMIT_SYMBOL, 149),
+    (15, HUFFMAN_EMIT_SYMBOL, 149),
+    (24, HUFFMAN_EMIT_SYMBOL, 149),
+    (31, HUFFMAN_EMIT_SYMBOL, 149),
+    (41, HUFFMAN_EMIT_SYMBOL, 149),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 149),
+
+    # Node 158
+    (3, HUFFMAN_EMIT_SYMBOL, 150),
+    (6, HUFFMAN_EMIT_SYMBOL, 150),
+    (10, HUFFMAN_EMIT_SYMBOL, 150),
+    (15, HUFFMAN_EMIT_SYMBOL, 150),
+    (24, HUFFMAN_EMIT_SYMBOL, 150),
+    (31, HUFFMAN_EMIT_SYMBOL, 150),
+    (41, HUFFMAN_EMIT_SYMBOL, 150),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 150),
+    (3, HUFFMAN_EMIT_SYMBOL, 151),
+    (6, HUFFMAN_EMIT_SYMBOL, 151),
+    (10, HUFFMAN_EMIT_SYMBOL, 151),
+    (15, HUFFMAN_EMIT_SYMBOL, 151),
+    (24, HUFFMAN_EMIT_SYMBOL, 151),
+    (31, HUFFMAN_EMIT_SYMBOL, 151),
+    (41, HUFFMAN_EMIT_SYMBOL, 151),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 151),
+
+    # Node 159
+    (2, HUFFMAN_EMIT_SYMBOL, 152),
+    (9, HUFFMAN_EMIT_SYMBOL, 152),
+    (23, HUFFMAN_EMIT_SYMBOL, 152),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 152),
+    (2, HUFFMAN_EMIT_SYMBOL, 155),
+    (9, HUFFMAN_EMIT_SYMBOL, 155),
+    (23, HUFFMAN_EMIT_SYMBOL, 155),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 155),
+    (2, HUFFMAN_EMIT_SYMBOL, 157),
+    (9, HUFFMAN_EMIT_SYMBOL, 157),
+    (23, HUFFMAN_EMIT_SYMBOL, 157),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 157),
+    (2, HUFFMAN_EMIT_SYMBOL, 158),
+    (9, HUFFMAN_EMIT_SYMBOL, 158),
+    (23, HUFFMAN_EMIT_SYMBOL, 158),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 158),
+
+    # Node 160
+    (3, HUFFMAN_EMIT_SYMBOL, 152),
+    (6, HUFFMAN_EMIT_SYMBOL, 152),
+    (10, HUFFMAN_EMIT_SYMBOL, 152),
+    (15, HUFFMAN_EMIT_SYMBOL, 152),
+    (24, HUFFMAN_EMIT_SYMBOL, 152),
+    (31, HUFFMAN_EMIT_SYMBOL, 152),
+    (41, HUFFMAN_EMIT_SYMBOL, 152),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 152),
+    (3, HUFFMAN_EMIT_SYMBOL, 155),
+    (6, HUFFMAN_EMIT_SYMBOL, 155),
+    (10, HUFFMAN_EMIT_SYMBOL, 155),
+    (15, HUFFMAN_EMIT_SYMBOL, 155),
+    (24, HUFFMAN_EMIT_SYMBOL, 155),
+    (31, HUFFMAN_EMIT_SYMBOL, 155),
+    (41, HUFFMAN_EMIT_SYMBOL, 155),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 155),
+
+    # Node 161
+    (3, HUFFMAN_EMIT_SYMBOL, 157),
+    (6, HUFFMAN_EMIT_SYMBOL, 157),
+    (10, HUFFMAN_EMIT_SYMBOL, 157),
+    (15, HUFFMAN_EMIT_SYMBOL, 157),
+    (24, HUFFMAN_EMIT_SYMBOL, 157),
+    (31, HUFFMAN_EMIT_SYMBOL, 157),
+    (41, HUFFMAN_EMIT_SYMBOL, 157),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 157),
+    (3, HUFFMAN_EMIT_SYMBOL, 158),
+    (6, HUFFMAN_EMIT_SYMBOL, 158),
+    (10, HUFFMAN_EMIT_SYMBOL, 158),
+    (15, HUFFMAN_EMIT_SYMBOL, 158),
+    (24, HUFFMAN_EMIT_SYMBOL, 158),
+    (31, HUFFMAN_EMIT_SYMBOL, 158),
+    (41, HUFFMAN_EMIT_SYMBOL, 158),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 158),
+
+    # Node 162
+    (1, HUFFMAN_EMIT_SYMBOL, 165),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 165),
+    (1, HUFFMAN_EMIT_SYMBOL, 166),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 166),
+    (1, HUFFMAN_EMIT_SYMBOL, 168),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 168),
+    (1, HUFFMAN_EMIT_SYMBOL, 174),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 174),
+    (1, HUFFMAN_EMIT_SYMBOL, 175),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 175),
+    (1, HUFFMAN_EMIT_SYMBOL, 180),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 180),
+    (1, HUFFMAN_EMIT_SYMBOL, 182),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 182),
+    (1, HUFFMAN_EMIT_SYMBOL, 183),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 183),
+
+    # Node 163
+    (2, HUFFMAN_EMIT_SYMBOL, 165),
+    (9, HUFFMAN_EMIT_SYMBOL, 165),
+    (23, HUFFMAN_EMIT_SYMBOL, 165),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 165),
+    (2, HUFFMAN_EMIT_SYMBOL, 166),
+    (9, HUFFMAN_EMIT_SYMBOL, 166),
+    (23, HUFFMAN_EMIT_SYMBOL, 166),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 166),
+    (2, HUFFMAN_EMIT_SYMBOL, 168),
+    (9, HUFFMAN_EMIT_SYMBOL, 168),
+    (23, HUFFMAN_EMIT_SYMBOL, 168),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 168),
+    (2, HUFFMAN_EMIT_SYMBOL, 174),
+    (9, HUFFMAN_EMIT_SYMBOL, 174),
+    (23, HUFFMAN_EMIT_SYMBOL, 174),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 174),
+
+    # Node 164
+    (3, HUFFMAN_EMIT_SYMBOL, 165),
+    (6, HUFFMAN_EMIT_SYMBOL, 165),
+    (10, HUFFMAN_EMIT_SYMBOL, 165),
+    (15, HUFFMAN_EMIT_SYMBOL, 165),
+    (24, HUFFMAN_EMIT_SYMBOL, 165),
+    (31, HUFFMAN_EMIT_SYMBOL, 165),
+    (41, HUFFMAN_EMIT_SYMBOL, 165),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 165),
+    (3, HUFFMAN_EMIT_SYMBOL, 166),
+    (6, HUFFMAN_EMIT_SYMBOL, 166),
+    (10, HUFFMAN_EMIT_SYMBOL, 166),
+    (15, HUFFMAN_EMIT_SYMBOL, 166),
+    (24, HUFFMAN_EMIT_SYMBOL, 166),
+    (31, HUFFMAN_EMIT_SYMBOL, 166),
+    (41, HUFFMAN_EMIT_SYMBOL, 166),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 166),
+
+    # Node 165
+    (3, HUFFMAN_EMIT_SYMBOL, 168),
+    (6, HUFFMAN_EMIT_SYMBOL, 168),
+    (10, HUFFMAN_EMIT_SYMBOL, 168),
+    (15, HUFFMAN_EMIT_SYMBOL, 168),
+    (24, HUFFMAN_EMIT_SYMBOL, 168),
+    (31, HUFFMAN_EMIT_SYMBOL, 168),
+    (41, HUFFMAN_EMIT_SYMBOL, 168),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 168),
+    (3, HUFFMAN_EMIT_SYMBOL, 174),
+    (6, HUFFMAN_EMIT_SYMBOL, 174),
+    (10, HUFFMAN_EMIT_SYMBOL, 174),
+    (15, HUFFMAN_EMIT_SYMBOL, 174),
+    (24, HUFFMAN_EMIT_SYMBOL, 174),
+    (31, HUFFMAN_EMIT_SYMBOL, 174),
+    (41, HUFFMAN_EMIT_SYMBOL, 174),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 174),
+
+    # Node 166
+    (2, HUFFMAN_EMIT_SYMBOL, 175),
+    (9, HUFFMAN_EMIT_SYMBOL, 175),
+    (23, HUFFMAN_EMIT_SYMBOL, 175),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 175),
+    (2, HUFFMAN_EMIT_SYMBOL, 180),
+    (9, HUFFMAN_EMIT_SYMBOL, 180),
+    (23, HUFFMAN_EMIT_SYMBOL, 180),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 180),
+    (2, HUFFMAN_EMIT_SYMBOL, 182),
+    (9, HUFFMAN_EMIT_SYMBOL, 182),
+    (23, HUFFMAN_EMIT_SYMBOL, 182),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 182),
+    (2, HUFFMAN_EMIT_SYMBOL, 183),
+    (9, HUFFMAN_EMIT_SYMBOL, 183),
+    (23, HUFFMAN_EMIT_SYMBOL, 183),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 183),
+
+    # Node 167
+    (3, HUFFMAN_EMIT_SYMBOL, 175),
+    (6, HUFFMAN_EMIT_SYMBOL, 175),
+    (10, HUFFMAN_EMIT_SYMBOL, 175),
+    (15, HUFFMAN_EMIT_SYMBOL, 175),
+    (24, HUFFMAN_EMIT_SYMBOL, 175),
+    (31, HUFFMAN_EMIT_SYMBOL, 175),
+    (41, HUFFMAN_EMIT_SYMBOL, 175),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 175),
+    (3, HUFFMAN_EMIT_SYMBOL, 180),
+    (6, HUFFMAN_EMIT_SYMBOL, 180),
+    (10, HUFFMAN_EMIT_SYMBOL, 180),
+    (15, HUFFMAN_EMIT_SYMBOL, 180),
+    (24, HUFFMAN_EMIT_SYMBOL, 180),
+    (31, HUFFMAN_EMIT_SYMBOL, 180),
+    (41, HUFFMAN_EMIT_SYMBOL, 180),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 180),
+
+    # Node 168
+    (3, HUFFMAN_EMIT_SYMBOL, 182),
+    (6, HUFFMAN_EMIT_SYMBOL, 182),
+    (10, HUFFMAN_EMIT_SYMBOL, 182),
+    (15, HUFFMAN_EMIT_SYMBOL, 182),
+    (24, HUFFMAN_EMIT_SYMBOL, 182),
+    (31, HUFFMAN_EMIT_SYMBOL, 182),
+    (41, HUFFMAN_EMIT_SYMBOL, 182),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 182),
+    (3, HUFFMAN_EMIT_SYMBOL, 183),
+    (6, HUFFMAN_EMIT_SYMBOL, 183),
+    (10, HUFFMAN_EMIT_SYMBOL, 183),
+    (15, HUFFMAN_EMIT_SYMBOL, 183),
+    (24, HUFFMAN_EMIT_SYMBOL, 183),
+    (31, HUFFMAN_EMIT_SYMBOL, 183),
+    (41, HUFFMAN_EMIT_SYMBOL, 183),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 183),
+
+    # Node 169
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 188),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 191),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 197),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 231),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 239),
+    (176, 0, 0),
+    (178, 0, 0),
+    (179, 0, 0),
+    (183, 0, 0),
+    (184, 0, 0),
+    (186, 0, 0),
+    (187, 0, 0),
+    (192, 0, 0),
+    (199, 0, 0),
+    (208, 0, 0),
+    (223, 0, 0),
+
+    # Node 170
+    (1, HUFFMAN_EMIT_SYMBOL, 188),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 188),
+    (1, HUFFMAN_EMIT_SYMBOL, 191),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 191),
+    (1, HUFFMAN_EMIT_SYMBOL, 197),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 197),
+    (1, HUFFMAN_EMIT_SYMBOL, 231),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 231),
+    (1, HUFFMAN_EMIT_SYMBOL, 239),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 239),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 9),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 142),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 144),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 145),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 148),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 159),
+
+    # Node 171
+    (2, HUFFMAN_EMIT_SYMBOL, 188),
+    (9, HUFFMAN_EMIT_SYMBOL, 188),
+    (23, HUFFMAN_EMIT_SYMBOL, 188),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 188),
+    (2, HUFFMAN_EMIT_SYMBOL, 191),
+    (9, HUFFMAN_EMIT_SYMBOL, 191),
+    (23, HUFFMAN_EMIT_SYMBOL, 191),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 191),
+    (2, HUFFMAN_EMIT_SYMBOL, 197),
+    (9, HUFFMAN_EMIT_SYMBOL, 197),
+    (23, HUFFMAN_EMIT_SYMBOL, 197),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 197),
+    (2, HUFFMAN_EMIT_SYMBOL, 231),
+    (9, HUFFMAN_EMIT_SYMBOL, 231),
+    (23, HUFFMAN_EMIT_SYMBOL, 231),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 231),
+
+    # Node 172
+    (3, HUFFMAN_EMIT_SYMBOL, 188),
+    (6, HUFFMAN_EMIT_SYMBOL, 188),
+    (10, HUFFMAN_EMIT_SYMBOL, 188),
+    (15, HUFFMAN_EMIT_SYMBOL, 188),
+    (24, HUFFMAN_EMIT_SYMBOL, 188),
+    (31, HUFFMAN_EMIT_SYMBOL, 188),
+    (41, HUFFMAN_EMIT_SYMBOL, 188),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 188),
+    (3, HUFFMAN_EMIT_SYMBOL, 191),
+    (6, HUFFMAN_EMIT_SYMBOL, 191),
+    (10, HUFFMAN_EMIT_SYMBOL, 191),
+    (15, HUFFMAN_EMIT_SYMBOL, 191),
+    (24, HUFFMAN_EMIT_SYMBOL, 191),
+    (31, HUFFMAN_EMIT_SYMBOL, 191),
+    (41, HUFFMAN_EMIT_SYMBOL, 191),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 191),
+
+    # Node 173
+    (3, HUFFMAN_EMIT_SYMBOL, 197),
+    (6, HUFFMAN_EMIT_SYMBOL, 197),
+    (10, HUFFMAN_EMIT_SYMBOL, 197),
+    (15, HUFFMAN_EMIT_SYMBOL, 197),
+    (24, HUFFMAN_EMIT_SYMBOL, 197),
+    (31, HUFFMAN_EMIT_SYMBOL, 197),
+    (41, HUFFMAN_EMIT_SYMBOL, 197),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 197),
+    (3, HUFFMAN_EMIT_SYMBOL, 231),
+    (6, HUFFMAN_EMIT_SYMBOL, 231),
+    (10, HUFFMAN_EMIT_SYMBOL, 231),
+    (15, HUFFMAN_EMIT_SYMBOL, 231),
+    (24, HUFFMAN_EMIT_SYMBOL, 231),
+    (31, HUFFMAN_EMIT_SYMBOL, 231),
+    (41, HUFFMAN_EMIT_SYMBOL, 231),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 231),
+
+    # Node 174
+    (2, HUFFMAN_EMIT_SYMBOL, 239),
+    (9, HUFFMAN_EMIT_SYMBOL, 239),
+    (23, HUFFMAN_EMIT_SYMBOL, 239),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 239),
+    (1, HUFFMAN_EMIT_SYMBOL, 9),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 9),
+    (1, HUFFMAN_EMIT_SYMBOL, 142),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 142),
+    (1, HUFFMAN_EMIT_SYMBOL, 144),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 144),
+    (1, HUFFMAN_EMIT_SYMBOL, 145),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 145),
+    (1, HUFFMAN_EMIT_SYMBOL, 148),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 148),
+    (1, HUFFMAN_EMIT_SYMBOL, 159),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 159),
+
+    # Node 175
+    (3, HUFFMAN_EMIT_SYMBOL, 239),
+    (6, HUFFMAN_EMIT_SYMBOL, 239),
+    (10, HUFFMAN_EMIT_SYMBOL, 239),
+    (15, HUFFMAN_EMIT_SYMBOL, 239),
+    (24, HUFFMAN_EMIT_SYMBOL, 239),
+    (31, HUFFMAN_EMIT_SYMBOL, 239),
+    (41, HUFFMAN_EMIT_SYMBOL, 239),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 239),
+    (2, HUFFMAN_EMIT_SYMBOL, 9),
+    (9, HUFFMAN_EMIT_SYMBOL, 9),
+    (23, HUFFMAN_EMIT_SYMBOL, 9),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 9),
+    (2, HUFFMAN_EMIT_SYMBOL, 142),
+    (9, HUFFMAN_EMIT_SYMBOL, 142),
+    (23, HUFFMAN_EMIT_SYMBOL, 142),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 142),
+
+    # Node 176
+    (3, HUFFMAN_EMIT_SYMBOL, 9),
+    (6, HUFFMAN_EMIT_SYMBOL, 9),
+    (10, HUFFMAN_EMIT_SYMBOL, 9),
+    (15, HUFFMAN_EMIT_SYMBOL, 9),
+    (24, HUFFMAN_EMIT_SYMBOL, 9),
+    (31, HUFFMAN_EMIT_SYMBOL, 9),
+    (41, HUFFMAN_EMIT_SYMBOL, 9),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 9),
+    (3, HUFFMAN_EMIT_SYMBOL, 142),
+    (6, HUFFMAN_EMIT_SYMBOL, 142),
+    (10, HUFFMAN_EMIT_SYMBOL, 142),
+    (15, HUFFMAN_EMIT_SYMBOL, 142),
+    (24, HUFFMAN_EMIT_SYMBOL, 142),
+    (31, HUFFMAN_EMIT_SYMBOL, 142),
+    (41, HUFFMAN_EMIT_SYMBOL, 142),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 142),
+
+    # Node 177
+    (2, HUFFMAN_EMIT_SYMBOL, 144),
+    (9, HUFFMAN_EMIT_SYMBOL, 144),
+    (23, HUFFMAN_EMIT_SYMBOL, 144),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 144),
+    (2, HUFFMAN_EMIT_SYMBOL, 145),
+    (9, HUFFMAN_EMIT_SYMBOL, 145),
+    (23, HUFFMAN_EMIT_SYMBOL, 145),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 145),
+    (2, HUFFMAN_EMIT_SYMBOL, 148),
+    (9, HUFFMAN_EMIT_SYMBOL, 148),
+    (23, HUFFMAN_EMIT_SYMBOL, 148),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 148),
+    (2, HUFFMAN_EMIT_SYMBOL, 159),
+    (9, HUFFMAN_EMIT_SYMBOL, 159),
+    (23, HUFFMAN_EMIT_SYMBOL, 159),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 159),
+
+    # Node 178
+    (3, HUFFMAN_EMIT_SYMBOL, 144),
+    (6, HUFFMAN_EMIT_SYMBOL, 144),
+    (10, HUFFMAN_EMIT_SYMBOL, 144),
+    (15, HUFFMAN_EMIT_SYMBOL, 144),
+    (24, HUFFMAN_EMIT_SYMBOL, 144),
+    (31, HUFFMAN_EMIT_SYMBOL, 144),
+    (41, HUFFMAN_EMIT_SYMBOL, 144),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 144),
+    (3, HUFFMAN_EMIT_SYMBOL, 145),
+    (6, HUFFMAN_EMIT_SYMBOL, 145),
+    (10, HUFFMAN_EMIT_SYMBOL, 145),
+    (15, HUFFMAN_EMIT_SYMBOL, 145),
+    (24, HUFFMAN_EMIT_SYMBOL, 145),
+    (31, HUFFMAN_EMIT_SYMBOL, 145),
+    (41, HUFFMAN_EMIT_SYMBOL, 145),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 145),
+
+    # Node 179
+    (3, HUFFMAN_EMIT_SYMBOL, 148),
+    (6, HUFFMAN_EMIT_SYMBOL, 148),
+    (10, HUFFMAN_EMIT_SYMBOL, 148),
+    (15, HUFFMAN_EMIT_SYMBOL, 148),
+    (24, HUFFMAN_EMIT_SYMBOL, 148),
+    (31, HUFFMAN_EMIT_SYMBOL, 148),
+    (41, HUFFMAN_EMIT_SYMBOL, 148),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 148),
+    (3, HUFFMAN_EMIT_SYMBOL, 159),
+    (6, HUFFMAN_EMIT_SYMBOL, 159),
+    (10, HUFFMAN_EMIT_SYMBOL, 159),
+    (15, HUFFMAN_EMIT_SYMBOL, 159),
+    (24, HUFFMAN_EMIT_SYMBOL, 159),
+    (31, HUFFMAN_EMIT_SYMBOL, 159),
+    (41, HUFFMAN_EMIT_SYMBOL, 159),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 159),
+
+    # Node 180
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 171),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 206),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 215),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 225),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 236),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 237),
+    (188, 0, 0),
+    (189, 0, 0),
+    (193, 0, 0),
+    (196, 0, 0),
+    (200, 0, 0),
+    (203, 0, 0),
+    (209, 0, 0),
+    (216, 0, 0),
+    (224, 0, 0),
+    (238, 0, 0),
+
+    # Node 181
+    (1, HUFFMAN_EMIT_SYMBOL, 171),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 171),
+    (1, HUFFMAN_EMIT_SYMBOL, 206),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 206),
+    (1, HUFFMAN_EMIT_SYMBOL, 215),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 215),
+    (1, HUFFMAN_EMIT_SYMBOL, 225),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 225),
+    (1, HUFFMAN_EMIT_SYMBOL, 236),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 236),
+    (1, HUFFMAN_EMIT_SYMBOL, 237),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 237),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 199),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 207),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 234),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 235),
+
+    # Node 182
+    (2, HUFFMAN_EMIT_SYMBOL, 171),
+    (9, HUFFMAN_EMIT_SYMBOL, 171),
+    (23, HUFFMAN_EMIT_SYMBOL, 171),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 171),
+    (2, HUFFMAN_EMIT_SYMBOL, 206),
+    (9, HUFFMAN_EMIT_SYMBOL, 206),
+    (23, HUFFMAN_EMIT_SYMBOL, 206),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 206),
+    (2, HUFFMAN_EMIT_SYMBOL, 215),
+    (9, HUFFMAN_EMIT_SYMBOL, 215),
+    (23, HUFFMAN_EMIT_SYMBOL, 215),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 215),
+    (2, HUFFMAN_EMIT_SYMBOL, 225),
+    (9, HUFFMAN_EMIT_SYMBOL, 225),
+    (23, HUFFMAN_EMIT_SYMBOL, 225),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 225),
+
+    # Node 183
+    (3, HUFFMAN_EMIT_SYMBOL, 171),
+    (6, HUFFMAN_EMIT_SYMBOL, 171),
+    (10, HUFFMAN_EMIT_SYMBOL, 171),
+    (15, HUFFMAN_EMIT_SYMBOL, 171),
+    (24, HUFFMAN_EMIT_SYMBOL, 171),
+    (31, HUFFMAN_EMIT_SYMBOL, 171),
+    (41, HUFFMAN_EMIT_SYMBOL, 171),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 171),
+    (3, HUFFMAN_EMIT_SYMBOL, 206),
+    (6, HUFFMAN_EMIT_SYMBOL, 206),
+    (10, HUFFMAN_EMIT_SYMBOL, 206),
+    (15, HUFFMAN_EMIT_SYMBOL, 206),
+    (24, HUFFMAN_EMIT_SYMBOL, 206),
+    (31, HUFFMAN_EMIT_SYMBOL, 206),
+    (41, HUFFMAN_EMIT_SYMBOL, 206),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 206),
+
+    # Node 184
+    (3, HUFFMAN_EMIT_SYMBOL, 215),
+    (6, HUFFMAN_EMIT_SYMBOL, 215),
+    (10, HUFFMAN_EMIT_SYMBOL, 215),
+    (15, HUFFMAN_EMIT_SYMBOL, 215),
+    (24, HUFFMAN_EMIT_SYMBOL, 215),
+    (31, HUFFMAN_EMIT_SYMBOL, 215),
+    (41, HUFFMAN_EMIT_SYMBOL, 215),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 215),
+    (3, HUFFMAN_EMIT_SYMBOL, 225),
+    (6, HUFFMAN_EMIT_SYMBOL, 225),
+    (10, HUFFMAN_EMIT_SYMBOL, 225),
+    (15, HUFFMAN_EMIT_SYMBOL, 225),
+    (24, HUFFMAN_EMIT_SYMBOL, 225),
+    (31, HUFFMAN_EMIT_SYMBOL, 225),
+    (41, HUFFMAN_EMIT_SYMBOL, 225),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 225),
+
+    # Node 185
+    (2, HUFFMAN_EMIT_SYMBOL, 236),
+    (9, HUFFMAN_EMIT_SYMBOL, 236),
+    (23, HUFFMAN_EMIT_SYMBOL, 236),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 236),
+    (2, HUFFMAN_EMIT_SYMBOL, 237),
+    (9, HUFFMAN_EMIT_SYMBOL, 237),
+    (23, HUFFMAN_EMIT_SYMBOL, 237),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 237),
+    (1, HUFFMAN_EMIT_SYMBOL, 199),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 199),
+    (1, HUFFMAN_EMIT_SYMBOL, 207),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 207),
+    (1, HUFFMAN_EMIT_SYMBOL, 234),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 234),
+    (1, HUFFMAN_EMIT_SYMBOL, 235),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 235),
+
+    # Node 186
+    (3, HUFFMAN_EMIT_SYMBOL, 236),
+    (6, HUFFMAN_EMIT_SYMBOL, 236),
+    (10, HUFFMAN_EMIT_SYMBOL, 236),
+    (15, HUFFMAN_EMIT_SYMBOL, 236),
+    (24, HUFFMAN_EMIT_SYMBOL, 236),
+    (31, HUFFMAN_EMIT_SYMBOL, 236),
+    (41, HUFFMAN_EMIT_SYMBOL, 236),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 236),
+    (3, HUFFMAN_EMIT_SYMBOL, 237),
+    (6, HUFFMAN_EMIT_SYMBOL, 237),
+    (10, HUFFMAN_EMIT_SYMBOL, 237),
+    (15, HUFFMAN_EMIT_SYMBOL, 237),
+    (24, HUFFMAN_EMIT_SYMBOL, 237),
+    (31, HUFFMAN_EMIT_SYMBOL, 237),
+    (41, HUFFMAN_EMIT_SYMBOL, 237),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 237),
+
+    # Node 187
+    (2, HUFFMAN_EMIT_SYMBOL, 199),
+    (9, HUFFMAN_EMIT_SYMBOL, 199),
+    (23, HUFFMAN_EMIT_SYMBOL, 199),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 199),
+    (2, HUFFMAN_EMIT_SYMBOL, 207),
+    (9, HUFFMAN_EMIT_SYMBOL, 207),
+    (23, HUFFMAN_EMIT_SYMBOL, 207),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 207),
+    (2, HUFFMAN_EMIT_SYMBOL, 234),
+    (9, HUFFMAN_EMIT_SYMBOL, 234),
+    (23, HUFFMAN_EMIT_SYMBOL, 234),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 234),
+    (2, HUFFMAN_EMIT_SYMBOL, 235),
+    (9, HUFFMAN_EMIT_SYMBOL, 235),
+    (23, HUFFMAN_EMIT_SYMBOL, 235),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 235),
+
+    # Node 188
+    (3, HUFFMAN_EMIT_SYMBOL, 199),
+    (6, HUFFMAN_EMIT_SYMBOL, 199),
+    (10, HUFFMAN_EMIT_SYMBOL, 199),
+    (15, HUFFMAN_EMIT_SYMBOL, 199),
+    (24, HUFFMAN_EMIT_SYMBOL, 199),
+    (31, HUFFMAN_EMIT_SYMBOL, 199),
+    (41, HUFFMAN_EMIT_SYMBOL, 199),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 199),
+    (3, HUFFMAN_EMIT_SYMBOL, 207),
+    (6, HUFFMAN_EMIT_SYMBOL, 207),
+    (10, HUFFMAN_EMIT_SYMBOL, 207),
+    (15, HUFFMAN_EMIT_SYMBOL, 207),
+    (24, HUFFMAN_EMIT_SYMBOL, 207),
+    (31, HUFFMAN_EMIT_SYMBOL, 207),
+    (41, HUFFMAN_EMIT_SYMBOL, 207),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 207),
+
+    # Node 189
+    (3, HUFFMAN_EMIT_SYMBOL, 234),
+    (6, HUFFMAN_EMIT_SYMBOL, 234),
+    (10, HUFFMAN_EMIT_SYMBOL, 234),
+    (15, HUFFMAN_EMIT_SYMBOL, 234),
+    (24, HUFFMAN_EMIT_SYMBOL, 234),
+    (31, HUFFMAN_EMIT_SYMBOL, 234),
+    (41, HUFFMAN_EMIT_SYMBOL, 234),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 234),
+    (3, HUFFMAN_EMIT_SYMBOL, 235),
+    (6, HUFFMAN_EMIT_SYMBOL, 235),
+    (10, HUFFMAN_EMIT_SYMBOL, 235),
+    (15, HUFFMAN_EMIT_SYMBOL, 235),
+    (24, HUFFMAN_EMIT_SYMBOL, 235),
+    (31, HUFFMAN_EMIT_SYMBOL, 235),
+    (41, HUFFMAN_EMIT_SYMBOL, 235),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 235),
+
+    # Node 190
+    (194, 0, 0),
+    (195, 0, 0),
+    (197, 0, 0),
+    (198, 0, 0),
+    (201, 0, 0),
+    (202, 0, 0),
+    (204, 0, 0),
+    (205, 0, 0),
+    (210, 0, 0),
+    (213, 0, 0),
+    (217, 0, 0),
+    (220, 0, 0),
+    (225, 0, 0),
+    (231, 0, 0),
+    (239, 0, 0),
+    (246, 0, 0),
+
+    # Node 191
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 192),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 193),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 200),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 201),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 202),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 205),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 210),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 213),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 218),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 219),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 238),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 240),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 242),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 243),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 255),
+    (206, 0, 0),
+
+    # Node 192
+    (1, HUFFMAN_EMIT_SYMBOL, 192),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 192),
+    (1, HUFFMAN_EMIT_SYMBOL, 193),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 193),
+    (1, HUFFMAN_EMIT_SYMBOL, 200),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 200),
+    (1, HUFFMAN_EMIT_SYMBOL, 201),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 201),
+    (1, HUFFMAN_EMIT_SYMBOL, 202),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 202),
+    (1, HUFFMAN_EMIT_SYMBOL, 205),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 205),
+    (1, HUFFMAN_EMIT_SYMBOL, 210),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 210),
+    (1, HUFFMAN_EMIT_SYMBOL, 213),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 213),
+
+    # Node 193
+    (2, HUFFMAN_EMIT_SYMBOL, 192),
+    (9, HUFFMAN_EMIT_SYMBOL, 192),
+    (23, HUFFMAN_EMIT_SYMBOL, 192),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 192),
+    (2, HUFFMAN_EMIT_SYMBOL, 193),
+    (9, HUFFMAN_EMIT_SYMBOL, 193),
+    (23, HUFFMAN_EMIT_SYMBOL, 193),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 193),
+    (2, HUFFMAN_EMIT_SYMBOL, 200),
+    (9, HUFFMAN_EMIT_SYMBOL, 200),
+    (23, HUFFMAN_EMIT_SYMBOL, 200),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 200),
+    (2, HUFFMAN_EMIT_SYMBOL, 201),
+    (9, HUFFMAN_EMIT_SYMBOL, 201),
+    (23, HUFFMAN_EMIT_SYMBOL, 201),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 201),
+
+    # Node 194
+    (3, HUFFMAN_EMIT_SYMBOL, 192),
+    (6, HUFFMAN_EMIT_SYMBOL, 192),
+    (10, HUFFMAN_EMIT_SYMBOL, 192),
+    (15, HUFFMAN_EMIT_SYMBOL, 192),
+    (24, HUFFMAN_EMIT_SYMBOL, 192),
+    (31, HUFFMAN_EMIT_SYMBOL, 192),
+    (41, HUFFMAN_EMIT_SYMBOL, 192),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 192),
+    (3, HUFFMAN_EMIT_SYMBOL, 193),
+    (6, HUFFMAN_EMIT_SYMBOL, 193),
+    (10, HUFFMAN_EMIT_SYMBOL, 193),
+    (15, HUFFMAN_EMIT_SYMBOL, 193),
+    (24, HUFFMAN_EMIT_SYMBOL, 193),
+    (31, HUFFMAN_EMIT_SYMBOL, 193),
+    (41, HUFFMAN_EMIT_SYMBOL, 193),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 193),
+
+    # Node 195
+    (3, HUFFMAN_EMIT_SYMBOL, 200),
+    (6, HUFFMAN_EMIT_SYMBOL, 200),
+    (10, HUFFMAN_EMIT_SYMBOL, 200),
+    (15, HUFFMAN_EMIT_SYMBOL, 200),
+    (24, HUFFMAN_EMIT_SYMBOL, 200),
+    (31, HUFFMAN_EMIT_SYMBOL, 200),
+    (41, HUFFMAN_EMIT_SYMBOL, 200),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 200),
+    (3, HUFFMAN_EMIT_SYMBOL, 201),
+    (6, HUFFMAN_EMIT_SYMBOL, 201),
+    (10, HUFFMAN_EMIT_SYMBOL, 201),
+    (15, HUFFMAN_EMIT_SYMBOL, 201),
+    (24, HUFFMAN_EMIT_SYMBOL, 201),
+    (31, HUFFMAN_EMIT_SYMBOL, 201),
+    (41, HUFFMAN_EMIT_SYMBOL, 201),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 201),
+
+    # Node 196
+    (2, HUFFMAN_EMIT_SYMBOL, 202),
+    (9, HUFFMAN_EMIT_SYMBOL, 202),
+    (23, HUFFMAN_EMIT_SYMBOL, 202),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 202),
+    (2, HUFFMAN_EMIT_SYMBOL, 205),
+    (9, HUFFMAN_EMIT_SYMBOL, 205),
+    (23, HUFFMAN_EMIT_SYMBOL, 205),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 205),
+    (2, HUFFMAN_EMIT_SYMBOL, 210),
+    (9, HUFFMAN_EMIT_SYMBOL, 210),
+    (23, HUFFMAN_EMIT_SYMBOL, 210),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 210),
+    (2, HUFFMAN_EMIT_SYMBOL, 213),
+    (9, HUFFMAN_EMIT_SYMBOL, 213),
+    (23, HUFFMAN_EMIT_SYMBOL, 213),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 213),
+
+    # Node 197
+    (3, HUFFMAN_EMIT_SYMBOL, 202),
+    (6, HUFFMAN_EMIT_SYMBOL, 202),
+    (10, HUFFMAN_EMIT_SYMBOL, 202),
+    (15, HUFFMAN_EMIT_SYMBOL, 202),
+    (24, HUFFMAN_EMIT_SYMBOL, 202),
+    (31, HUFFMAN_EMIT_SYMBOL, 202),
+    (41, HUFFMAN_EMIT_SYMBOL, 202),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 202),
+    (3, HUFFMAN_EMIT_SYMBOL, 205),
+    (6, HUFFMAN_EMIT_SYMBOL, 205),
+    (10, HUFFMAN_EMIT_SYMBOL, 205),
+    (15, HUFFMAN_EMIT_SYMBOL, 205),
+    (24, HUFFMAN_EMIT_SYMBOL, 205),
+    (31, HUFFMAN_EMIT_SYMBOL, 205),
+    (41, HUFFMAN_EMIT_SYMBOL, 205),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 205),
+
+    # Node 198
+    (3, HUFFMAN_EMIT_SYMBOL, 210),
+    (6, HUFFMAN_EMIT_SYMBOL, 210),
+    (10, HUFFMAN_EMIT_SYMBOL, 210),
+    (15, HUFFMAN_EMIT_SYMBOL, 210),
+    (24, HUFFMAN_EMIT_SYMBOL, 210),
+    (31, HUFFMAN_EMIT_SYMBOL, 210),
+    (41, HUFFMAN_EMIT_SYMBOL, 210),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 210),
+    (3, HUFFMAN_EMIT_SYMBOL, 213),
+    (6, HUFFMAN_EMIT_SYMBOL, 213),
+    (10, HUFFMAN_EMIT_SYMBOL, 213),
+    (15, HUFFMAN_EMIT_SYMBOL, 213),
+    (24, HUFFMAN_EMIT_SYMBOL, 213),
+    (31, HUFFMAN_EMIT_SYMBOL, 213),
+    (41, HUFFMAN_EMIT_SYMBOL, 213),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 213),
+
+    # Node 199
+    (1, HUFFMAN_EMIT_SYMBOL, 218),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 218),
+    (1, HUFFMAN_EMIT_SYMBOL, 219),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 219),
+    (1, HUFFMAN_EMIT_SYMBOL, 238),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 238),
+    (1, HUFFMAN_EMIT_SYMBOL, 240),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 240),
+    (1, HUFFMAN_EMIT_SYMBOL, 242),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 242),
+    (1, HUFFMAN_EMIT_SYMBOL, 243),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 243),
+    (1, HUFFMAN_EMIT_SYMBOL, 255),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 255),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 203),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 204),
+
+    # Node 200
+    (2, HUFFMAN_EMIT_SYMBOL, 218),
+    (9, HUFFMAN_EMIT_SYMBOL, 218),
+    (23, HUFFMAN_EMIT_SYMBOL, 218),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 218),
+    (2, HUFFMAN_EMIT_SYMBOL, 219),
+    (9, HUFFMAN_EMIT_SYMBOL, 219),
+    (23, HUFFMAN_EMIT_SYMBOL, 219),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 219),
+    (2, HUFFMAN_EMIT_SYMBOL, 238),
+    (9, HUFFMAN_EMIT_SYMBOL, 238),
+    (23, HUFFMAN_EMIT_SYMBOL, 238),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 238),
+    (2, HUFFMAN_EMIT_SYMBOL, 240),
+    (9, HUFFMAN_EMIT_SYMBOL, 240),
+    (23, HUFFMAN_EMIT_SYMBOL, 240),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 240),
+
+    # Node 201
+    (3, HUFFMAN_EMIT_SYMBOL, 218),
+    (6, HUFFMAN_EMIT_SYMBOL, 218),
+    (10, HUFFMAN_EMIT_SYMBOL, 218),
+    (15, HUFFMAN_EMIT_SYMBOL, 218),
+    (24, HUFFMAN_EMIT_SYMBOL, 218),
+    (31, HUFFMAN_EMIT_SYMBOL, 218),
+    (41, HUFFMAN_EMIT_SYMBOL, 218),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 218),
+    (3, HUFFMAN_EMIT_SYMBOL, 219),
+    (6, HUFFMAN_EMIT_SYMBOL, 219),
+    (10, HUFFMAN_EMIT_SYMBOL, 219),
+    (15, HUFFMAN_EMIT_SYMBOL, 219),
+    (24, HUFFMAN_EMIT_SYMBOL, 219),
+    (31, HUFFMAN_EMIT_SYMBOL, 219),
+    (41, HUFFMAN_EMIT_SYMBOL, 219),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 219),
+
+    # Node 202
+    (3, HUFFMAN_EMIT_SYMBOL, 238),
+    (6, HUFFMAN_EMIT_SYMBOL, 238),
+    (10, HUFFMAN_EMIT_SYMBOL, 238),
+    (15, HUFFMAN_EMIT_SYMBOL, 238),
+    (24, HUFFMAN_EMIT_SYMBOL, 238),
+    (31, HUFFMAN_EMIT_SYMBOL, 238),
+    (41, HUFFMAN_EMIT_SYMBOL, 238),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 238),
+    (3, HUFFMAN_EMIT_SYMBOL, 240),
+    (6, HUFFMAN_EMIT_SYMBOL, 240),
+    (10, HUFFMAN_EMIT_SYMBOL, 240),
+    (15, HUFFMAN_EMIT_SYMBOL, 240),
+    (24, HUFFMAN_EMIT_SYMBOL, 240),
+    (31, HUFFMAN_EMIT_SYMBOL, 240),
+    (41, HUFFMAN_EMIT_SYMBOL, 240),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 240),
+
+    # Node 203
+    (2, HUFFMAN_EMIT_SYMBOL, 242),
+    (9, HUFFMAN_EMIT_SYMBOL, 242),
+    (23, HUFFMAN_EMIT_SYMBOL, 242),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 242),
+    (2, HUFFMAN_EMIT_SYMBOL, 243),
+    (9, HUFFMAN_EMIT_SYMBOL, 243),
+    (23, HUFFMAN_EMIT_SYMBOL, 243),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 243),
+    (2, HUFFMAN_EMIT_SYMBOL, 255),
+    (9, HUFFMAN_EMIT_SYMBOL, 255),
+    (23, HUFFMAN_EMIT_SYMBOL, 255),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 255),
+    (1, HUFFMAN_EMIT_SYMBOL, 203),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 203),
+    (1, HUFFMAN_EMIT_SYMBOL, 204),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 204),
+
+    # Node 204
+    (3, HUFFMAN_EMIT_SYMBOL, 242),
+    (6, HUFFMAN_EMIT_SYMBOL, 242),
+    (10, HUFFMAN_EMIT_SYMBOL, 242),
+    (15, HUFFMAN_EMIT_SYMBOL, 242),
+    (24, HUFFMAN_EMIT_SYMBOL, 242),
+    (31, HUFFMAN_EMIT_SYMBOL, 242),
+    (41, HUFFMAN_EMIT_SYMBOL, 242),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 242),
+    (3, HUFFMAN_EMIT_SYMBOL, 243),
+    (6, HUFFMAN_EMIT_SYMBOL, 243),
+    (10, HUFFMAN_EMIT_SYMBOL, 243),
+    (15, HUFFMAN_EMIT_SYMBOL, 243),
+    (24, HUFFMAN_EMIT_SYMBOL, 243),
+    (31, HUFFMAN_EMIT_SYMBOL, 243),
+    (41, HUFFMAN_EMIT_SYMBOL, 243),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 243),
+
+    # Node 205
+    (3, HUFFMAN_EMIT_SYMBOL, 255),
+    (6, HUFFMAN_EMIT_SYMBOL, 255),
+    (10, HUFFMAN_EMIT_SYMBOL, 255),
+    (15, HUFFMAN_EMIT_SYMBOL, 255),
+    (24, HUFFMAN_EMIT_SYMBOL, 255),
+    (31, HUFFMAN_EMIT_SYMBOL, 255),
+    (41, HUFFMAN_EMIT_SYMBOL, 255),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 255),
+    (2, HUFFMAN_EMIT_SYMBOL, 203),
+    (9, HUFFMAN_EMIT_SYMBOL, 203),
+    (23, HUFFMAN_EMIT_SYMBOL, 203),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 203),
+    (2, HUFFMAN_EMIT_SYMBOL, 204),
+    (9, HUFFMAN_EMIT_SYMBOL, 204),
+    (23, HUFFMAN_EMIT_SYMBOL, 204),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 204),
+
+    # Node 206
+    (3, HUFFMAN_EMIT_SYMBOL, 203),
+    (6, HUFFMAN_EMIT_SYMBOL, 203),
+    (10, HUFFMAN_EMIT_SYMBOL, 203),
+    (15, HUFFMAN_EMIT_SYMBOL, 203),
+    (24, HUFFMAN_EMIT_SYMBOL, 203),
+    (31, HUFFMAN_EMIT_SYMBOL, 203),
+    (41, HUFFMAN_EMIT_SYMBOL, 203),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 203),
+    (3, HUFFMAN_EMIT_SYMBOL, 204),
+    (6, HUFFMAN_EMIT_SYMBOL, 204),
+    (10, HUFFMAN_EMIT_SYMBOL, 204),
+    (15, HUFFMAN_EMIT_SYMBOL, 204),
+    (24, HUFFMAN_EMIT_SYMBOL, 204),
+    (31, HUFFMAN_EMIT_SYMBOL, 204),
+    (41, HUFFMAN_EMIT_SYMBOL, 204),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 204),
+
+    # Node 207
+    (211, 0, 0),
+    (212, 0, 0),
+    (214, 0, 0),
+    (215, 0, 0),
+    (218, 0, 0),
+    (219, 0, 0),
+    (221, 0, 0),
+    (222, 0, 0),
+    (226, 0, 0),
+    (228, 0, 0),
+    (232, 0, 0),
+    (235, 0, 0),
+    (240, 0, 0),
+    (243, 0, 0),
+    (247, 0, 0),
+    (250, 0, 0),
+
+    # Node 208
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 211),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 212),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 214),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 221),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 222),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 223),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 241),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 244),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 245),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 246),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 247),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 248),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 250),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 251),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 252),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 253),
+
+    # Node 209
+    (1, HUFFMAN_EMIT_SYMBOL, 211),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 211),
+    (1, HUFFMAN_EMIT_SYMBOL, 212),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 212),
+    (1, HUFFMAN_EMIT_SYMBOL, 214),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 214),
+    (1, HUFFMAN_EMIT_SYMBOL, 221),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 221),
+    (1, HUFFMAN_EMIT_SYMBOL, 222),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 222),
+    (1, HUFFMAN_EMIT_SYMBOL, 223),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 223),
+    (1, HUFFMAN_EMIT_SYMBOL, 241),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 241),
+    (1, HUFFMAN_EMIT_SYMBOL, 244),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 244),
+
+    # Node 210
+    (2, HUFFMAN_EMIT_SYMBOL, 211),
+    (9, HUFFMAN_EMIT_SYMBOL, 211),
+    (23, HUFFMAN_EMIT_SYMBOL, 211),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 211),
+    (2, HUFFMAN_EMIT_SYMBOL, 212),
+    (9, HUFFMAN_EMIT_SYMBOL, 212),
+    (23, HUFFMAN_EMIT_SYMBOL, 212),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 212),
+    (2, HUFFMAN_EMIT_SYMBOL, 214),
+    (9, HUFFMAN_EMIT_SYMBOL, 214),
+    (23, HUFFMAN_EMIT_SYMBOL, 214),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 214),
+    (2, HUFFMAN_EMIT_SYMBOL, 221),
+    (9, HUFFMAN_EMIT_SYMBOL, 221),
+    (23, HUFFMAN_EMIT_SYMBOL, 221),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 221),
+
+    # Node 211
+    (3, HUFFMAN_EMIT_SYMBOL, 211),
+    (6, HUFFMAN_EMIT_SYMBOL, 211),
+    (10, HUFFMAN_EMIT_SYMBOL, 211),
+    (15, HUFFMAN_EMIT_SYMBOL, 211),
+    (24, HUFFMAN_EMIT_SYMBOL, 211),
+    (31, HUFFMAN_EMIT_SYMBOL, 211),
+    (41, HUFFMAN_EMIT_SYMBOL, 211),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 211),
+    (3, HUFFMAN_EMIT_SYMBOL, 212),
+    (6, HUFFMAN_EMIT_SYMBOL, 212),
+    (10, HUFFMAN_EMIT_SYMBOL, 212),
+    (15, HUFFMAN_EMIT_SYMBOL, 212),
+    (24, HUFFMAN_EMIT_SYMBOL, 212),
+    (31, HUFFMAN_EMIT_SYMBOL, 212),
+    (41, HUFFMAN_EMIT_SYMBOL, 212),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 212),
+
+    # Node 212
+    (3, HUFFMAN_EMIT_SYMBOL, 214),
+    (6, HUFFMAN_EMIT_SYMBOL, 214),
+    (10, HUFFMAN_EMIT_SYMBOL, 214),
+    (15, HUFFMAN_EMIT_SYMBOL, 214),
+    (24, HUFFMAN_EMIT_SYMBOL, 214),
+    (31, HUFFMAN_EMIT_SYMBOL, 214),
+    (41, HUFFMAN_EMIT_SYMBOL, 214),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 214),
+    (3, HUFFMAN_EMIT_SYMBOL, 221),
+    (6, HUFFMAN_EMIT_SYMBOL, 221),
+    (10, HUFFMAN_EMIT_SYMBOL, 221),
+    (15, HUFFMAN_EMIT_SYMBOL, 221),
+    (24, HUFFMAN_EMIT_SYMBOL, 221),
+    (31, HUFFMAN_EMIT_SYMBOL, 221),
+    (41, HUFFMAN_EMIT_SYMBOL, 221),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 221),
+
+    # Node 213
+    (2, HUFFMAN_EMIT_SYMBOL, 222),
+    (9, HUFFMAN_EMIT_SYMBOL, 222),
+    (23, HUFFMAN_EMIT_SYMBOL, 222),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 222),
+    (2, HUFFMAN_EMIT_SYMBOL, 223),
+    (9, HUFFMAN_EMIT_SYMBOL, 223),
+    (23, HUFFMAN_EMIT_SYMBOL, 223),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 223),
+    (2, HUFFMAN_EMIT_SYMBOL, 241),
+    (9, HUFFMAN_EMIT_SYMBOL, 241),
+    (23, HUFFMAN_EMIT_SYMBOL, 241),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 241),
+    (2, HUFFMAN_EMIT_SYMBOL, 244),
+    (9, HUFFMAN_EMIT_SYMBOL, 244),
+    (23, HUFFMAN_EMIT_SYMBOL, 244),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 244),
+
+    # Node 214
+    (3, HUFFMAN_EMIT_SYMBOL, 222),
+    (6, HUFFMAN_EMIT_SYMBOL, 222),
+    (10, HUFFMAN_EMIT_SYMBOL, 222),
+    (15, HUFFMAN_EMIT_SYMBOL, 222),
+    (24, HUFFMAN_EMIT_SYMBOL, 222),
+    (31, HUFFMAN_EMIT_SYMBOL, 222),
+    (41, HUFFMAN_EMIT_SYMBOL, 222),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 222),
+    (3, HUFFMAN_EMIT_SYMBOL, 223),
+    (6, HUFFMAN_EMIT_SYMBOL, 223),
+    (10, HUFFMAN_EMIT_SYMBOL, 223),
+    (15, HUFFMAN_EMIT_SYMBOL, 223),
+    (24, HUFFMAN_EMIT_SYMBOL, 223),
+    (31, HUFFMAN_EMIT_SYMBOL, 223),
+    (41, HUFFMAN_EMIT_SYMBOL, 223),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 223),
+
+    # Node 215
+    (3, HUFFMAN_EMIT_SYMBOL, 241),
+    (6, HUFFMAN_EMIT_SYMBOL, 241),
+    (10, HUFFMAN_EMIT_SYMBOL, 241),
+    (15, HUFFMAN_EMIT_SYMBOL, 241),
+    (24, HUFFMAN_EMIT_SYMBOL, 241),
+    (31, HUFFMAN_EMIT_SYMBOL, 241),
+    (41, HUFFMAN_EMIT_SYMBOL, 241),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 241),
+    (3, HUFFMAN_EMIT_SYMBOL, 244),
+    (6, HUFFMAN_EMIT_SYMBOL, 244),
+    (10, HUFFMAN_EMIT_SYMBOL, 244),
+    (15, HUFFMAN_EMIT_SYMBOL, 244),
+    (24, HUFFMAN_EMIT_SYMBOL, 244),
+    (31, HUFFMAN_EMIT_SYMBOL, 244),
+    (41, HUFFMAN_EMIT_SYMBOL, 244),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 244),
+
+    # Node 216
+    (1, HUFFMAN_EMIT_SYMBOL, 245),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 245),
+    (1, HUFFMAN_EMIT_SYMBOL, 246),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 246),
+    (1, HUFFMAN_EMIT_SYMBOL, 247),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 247),
+    (1, HUFFMAN_EMIT_SYMBOL, 248),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 248),
+    (1, HUFFMAN_EMIT_SYMBOL, 250),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 250),
+    (1, HUFFMAN_EMIT_SYMBOL, 251),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 251),
+    (1, HUFFMAN_EMIT_SYMBOL, 252),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 252),
+    (1, HUFFMAN_EMIT_SYMBOL, 253),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 253),
+
+    # Node 217
+    (2, HUFFMAN_EMIT_SYMBOL, 245),
+    (9, HUFFMAN_EMIT_SYMBOL, 245),
+    (23, HUFFMAN_EMIT_SYMBOL, 245),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 245),
+    (2, HUFFMAN_EMIT_SYMBOL, 246),
+    (9, HUFFMAN_EMIT_SYMBOL, 246),
+    (23, HUFFMAN_EMIT_SYMBOL, 246),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 246),
+    (2, HUFFMAN_EMIT_SYMBOL, 247),
+    (9, HUFFMAN_EMIT_SYMBOL, 247),
+    (23, HUFFMAN_EMIT_SYMBOL, 247),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 247),
+    (2, HUFFMAN_EMIT_SYMBOL, 248),
+    (9, HUFFMAN_EMIT_SYMBOL, 248),
+    (23, HUFFMAN_EMIT_SYMBOL, 248),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 248),
+
+    # Node 218
+    (3, HUFFMAN_EMIT_SYMBOL, 245),
+    (6, HUFFMAN_EMIT_SYMBOL, 245),
+    (10, HUFFMAN_EMIT_SYMBOL, 245),
+    (15, HUFFMAN_EMIT_SYMBOL, 245),
+    (24, HUFFMAN_EMIT_SYMBOL, 245),
+    (31, HUFFMAN_EMIT_SYMBOL, 245),
+    (41, HUFFMAN_EMIT_SYMBOL, 245),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 245),
+    (3, HUFFMAN_EMIT_SYMBOL, 246),
+    (6, HUFFMAN_EMIT_SYMBOL, 246),
+    (10, HUFFMAN_EMIT_SYMBOL, 246),
+    (15, HUFFMAN_EMIT_SYMBOL, 246),
+    (24, HUFFMAN_EMIT_SYMBOL, 246),
+    (31, HUFFMAN_EMIT_SYMBOL, 246),
+    (41, HUFFMAN_EMIT_SYMBOL, 246),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 246),
+
+    # Node 219
+    (3, HUFFMAN_EMIT_SYMBOL, 247),
+    (6, HUFFMAN_EMIT_SYMBOL, 247),
+    (10, HUFFMAN_EMIT_SYMBOL, 247),
+    (15, HUFFMAN_EMIT_SYMBOL, 247),
+    (24, HUFFMAN_EMIT_SYMBOL, 247),
+    (31, HUFFMAN_EMIT_SYMBOL, 247),
+    (41, HUFFMAN_EMIT_SYMBOL, 247),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 247),
+    (3, HUFFMAN_EMIT_SYMBOL, 248),
+    (6, HUFFMAN_EMIT_SYMBOL, 248),
+    (10, HUFFMAN_EMIT_SYMBOL, 248),
+    (15, HUFFMAN_EMIT_SYMBOL, 248),
+    (24, HUFFMAN_EMIT_SYMBOL, 248),
+    (31, HUFFMAN_EMIT_SYMBOL, 248),
+    (41, HUFFMAN_EMIT_SYMBOL, 248),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 248),
+
+    # Node 220
+    (2, HUFFMAN_EMIT_SYMBOL, 250),
+    (9, HUFFMAN_EMIT_SYMBOL, 250),
+    (23, HUFFMAN_EMIT_SYMBOL, 250),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 250),
+    (2, HUFFMAN_EMIT_SYMBOL, 251),
+    (9, HUFFMAN_EMIT_SYMBOL, 251),
+    (23, HUFFMAN_EMIT_SYMBOL, 251),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 251),
+    (2, HUFFMAN_EMIT_SYMBOL, 252),
+    (9, HUFFMAN_EMIT_SYMBOL, 252),
+    (23, HUFFMAN_EMIT_SYMBOL, 252),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 252),
+    (2, HUFFMAN_EMIT_SYMBOL, 253),
+    (9, HUFFMAN_EMIT_SYMBOL, 253),
+    (23, HUFFMAN_EMIT_SYMBOL, 253),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 253),
+
+    # Node 221
+    (3, HUFFMAN_EMIT_SYMBOL, 250),
+    (6, HUFFMAN_EMIT_SYMBOL, 250),
+    (10, HUFFMAN_EMIT_SYMBOL, 250),
+    (15, HUFFMAN_EMIT_SYMBOL, 250),
+    (24, HUFFMAN_EMIT_SYMBOL, 250),
+    (31, HUFFMAN_EMIT_SYMBOL, 250),
+    (41, HUFFMAN_EMIT_SYMBOL, 250),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 250),
+    (3, HUFFMAN_EMIT_SYMBOL, 251),
+    (6, HUFFMAN_EMIT_SYMBOL, 251),
+    (10, HUFFMAN_EMIT_SYMBOL, 251),
+    (15, HUFFMAN_EMIT_SYMBOL, 251),
+    (24, HUFFMAN_EMIT_SYMBOL, 251),
+    (31, HUFFMAN_EMIT_SYMBOL, 251),
+    (41, HUFFMAN_EMIT_SYMBOL, 251),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 251),
+
+    # Node 222
+    (3, HUFFMAN_EMIT_SYMBOL, 252),
+    (6, HUFFMAN_EMIT_SYMBOL, 252),
+    (10, HUFFMAN_EMIT_SYMBOL, 252),
+    (15, HUFFMAN_EMIT_SYMBOL, 252),
+    (24, HUFFMAN_EMIT_SYMBOL, 252),
+    (31, HUFFMAN_EMIT_SYMBOL, 252),
+    (41, HUFFMAN_EMIT_SYMBOL, 252),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 252),
+    (3, HUFFMAN_EMIT_SYMBOL, 253),
+    (6, HUFFMAN_EMIT_SYMBOL, 253),
+    (10, HUFFMAN_EMIT_SYMBOL, 253),
+    (15, HUFFMAN_EMIT_SYMBOL, 253),
+    (24, HUFFMAN_EMIT_SYMBOL, 253),
+    (31, HUFFMAN_EMIT_SYMBOL, 253),
+    (41, HUFFMAN_EMIT_SYMBOL, 253),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 253),
+
+    # Node 223
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 254),
+    (227, 0, 0),
+    (229, 0, 0),
+    (230, 0, 0),
+    (233, 0, 0),
+    (234, 0, 0),
+    (236, 0, 0),
+    (237, 0, 0),
+    (241, 0, 0),
+    (242, 0, 0),
+    (244, 0, 0),
+    (245, 0, 0),
+    (248, 0, 0),
+    (249, 0, 0),
+    (251, 0, 0),
+    (252, 0, 0),
+
+    # Node 224
+    (1, HUFFMAN_EMIT_SYMBOL, 254),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 254),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 2),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 3),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 4),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 5),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 6),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 7),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 8),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 11),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 12),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 14),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 15),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 16),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 17),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 18),
+
+    # Node 225
+    (2, HUFFMAN_EMIT_SYMBOL, 254),
+    (9, HUFFMAN_EMIT_SYMBOL, 254),
+    (23, HUFFMAN_EMIT_SYMBOL, 254),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 254),
+    (1, HUFFMAN_EMIT_SYMBOL, 2),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 2),
+    (1, HUFFMAN_EMIT_SYMBOL, 3),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 3),
+    (1, HUFFMAN_EMIT_SYMBOL, 4),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 4),
+    (1, HUFFMAN_EMIT_SYMBOL, 5),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 5),
+    (1, HUFFMAN_EMIT_SYMBOL, 6),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 6),
+    (1, HUFFMAN_EMIT_SYMBOL, 7),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 7),
+
+    # Node 226
+    (3, HUFFMAN_EMIT_SYMBOL, 254),
+    (6, HUFFMAN_EMIT_SYMBOL, 254),
+    (10, HUFFMAN_EMIT_SYMBOL, 254),
+    (15, HUFFMAN_EMIT_SYMBOL, 254),
+    (24, HUFFMAN_EMIT_SYMBOL, 254),
+    (31, HUFFMAN_EMIT_SYMBOL, 254),
+    (41, HUFFMAN_EMIT_SYMBOL, 254),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 254),
+    (2, HUFFMAN_EMIT_SYMBOL, 2),
+    (9, HUFFMAN_EMIT_SYMBOL, 2),
+    (23, HUFFMAN_EMIT_SYMBOL, 2),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 2),
+    (2, HUFFMAN_EMIT_SYMBOL, 3),
+    (9, HUFFMAN_EMIT_SYMBOL, 3),
+    (23, HUFFMAN_EMIT_SYMBOL, 3),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 3),
+
+    # Node 227
+    (3, HUFFMAN_EMIT_SYMBOL, 2),
+    (6, HUFFMAN_EMIT_SYMBOL, 2),
+    (10, HUFFMAN_EMIT_SYMBOL, 2),
+    (15, HUFFMAN_EMIT_SYMBOL, 2),
+    (24, HUFFMAN_EMIT_SYMBOL, 2),
+    (31, HUFFMAN_EMIT_SYMBOL, 2),
+    (41, HUFFMAN_EMIT_SYMBOL, 2),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 2),
+    (3, HUFFMAN_EMIT_SYMBOL, 3),
+    (6, HUFFMAN_EMIT_SYMBOL, 3),
+    (10, HUFFMAN_EMIT_SYMBOL, 3),
+    (15, HUFFMAN_EMIT_SYMBOL, 3),
+    (24, HUFFMAN_EMIT_SYMBOL, 3),
+    (31, HUFFMAN_EMIT_SYMBOL, 3),
+    (41, HUFFMAN_EMIT_SYMBOL, 3),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 3),
+
+    # Node 228
+    (2, HUFFMAN_EMIT_SYMBOL, 4),
+    (9, HUFFMAN_EMIT_SYMBOL, 4),
+    (23, HUFFMAN_EMIT_SYMBOL, 4),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 4),
+    (2, HUFFMAN_EMIT_SYMBOL, 5),
+    (9, HUFFMAN_EMIT_SYMBOL, 5),
+    (23, HUFFMAN_EMIT_SYMBOL, 5),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 5),
+    (2, HUFFMAN_EMIT_SYMBOL, 6),
+    (9, HUFFMAN_EMIT_SYMBOL, 6),
+    (23, HUFFMAN_EMIT_SYMBOL, 6),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 6),
+    (2, HUFFMAN_EMIT_SYMBOL, 7),
+    (9, HUFFMAN_EMIT_SYMBOL, 7),
+    (23, HUFFMAN_EMIT_SYMBOL, 7),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 7),
+
+    # Node 229
+    (3, HUFFMAN_EMIT_SYMBOL, 4),
+    (6, HUFFMAN_EMIT_SYMBOL, 4),
+    (10, HUFFMAN_EMIT_SYMBOL, 4),
+    (15, HUFFMAN_EMIT_SYMBOL, 4),
+    (24, HUFFMAN_EMIT_SYMBOL, 4),
+    (31, HUFFMAN_EMIT_SYMBOL, 4),
+    (41, HUFFMAN_EMIT_SYMBOL, 4),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 4),
+    (3, HUFFMAN_EMIT_SYMBOL, 5),
+    (6, HUFFMAN_EMIT_SYMBOL, 5),
+    (10, HUFFMAN_EMIT_SYMBOL, 5),
+    (15, HUFFMAN_EMIT_SYMBOL, 5),
+    (24, HUFFMAN_EMIT_SYMBOL, 5),
+    (31, HUFFMAN_EMIT_SYMBOL, 5),
+    (41, HUFFMAN_EMIT_SYMBOL, 5),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 5),
+
+    # Node 230
+    (3, HUFFMAN_EMIT_SYMBOL, 6),
+    (6, HUFFMAN_EMIT_SYMBOL, 6),
+    (10, HUFFMAN_EMIT_SYMBOL, 6),
+    (15, HUFFMAN_EMIT_SYMBOL, 6),
+    (24, HUFFMAN_EMIT_SYMBOL, 6),
+    (31, HUFFMAN_EMIT_SYMBOL, 6),
+    (41, HUFFMAN_EMIT_SYMBOL, 6),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 6),
+    (3, HUFFMAN_EMIT_SYMBOL, 7),
+    (6, HUFFMAN_EMIT_SYMBOL, 7),
+    (10, HUFFMAN_EMIT_SYMBOL, 7),
+    (15, HUFFMAN_EMIT_SYMBOL, 7),
+    (24, HUFFMAN_EMIT_SYMBOL, 7),
+    (31, HUFFMAN_EMIT_SYMBOL, 7),
+    (41, HUFFMAN_EMIT_SYMBOL, 7),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 7),
+
+    # Node 231
+    (1, HUFFMAN_EMIT_SYMBOL, 8),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 8),
+    (1, HUFFMAN_EMIT_SYMBOL, 11),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 11),
+    (1, HUFFMAN_EMIT_SYMBOL, 12),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 12),
+    (1, HUFFMAN_EMIT_SYMBOL, 14),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 14),
+    (1, HUFFMAN_EMIT_SYMBOL, 15),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 15),
+    (1, HUFFMAN_EMIT_SYMBOL, 16),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 16),
+    (1, HUFFMAN_EMIT_SYMBOL, 17),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 17),
+    (1, HUFFMAN_EMIT_SYMBOL, 18),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 18),
+
+    # Node 232
+    (2, HUFFMAN_EMIT_SYMBOL, 8),
+    (9, HUFFMAN_EMIT_SYMBOL, 8),
+    (23, HUFFMAN_EMIT_SYMBOL, 8),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 8),
+    (2, HUFFMAN_EMIT_SYMBOL, 11),
+    (9, HUFFMAN_EMIT_SYMBOL, 11),
+    (23, HUFFMAN_EMIT_SYMBOL, 11),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 11),
+    (2, HUFFMAN_EMIT_SYMBOL, 12),
+    (9, HUFFMAN_EMIT_SYMBOL, 12),
+    (23, HUFFMAN_EMIT_SYMBOL, 12),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 12),
+    (2, HUFFMAN_EMIT_SYMBOL, 14),
+    (9, HUFFMAN_EMIT_SYMBOL, 14),
+    (23, HUFFMAN_EMIT_SYMBOL, 14),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 14),
+
+    # Node 233
+    (3, HUFFMAN_EMIT_SYMBOL, 8),
+    (6, HUFFMAN_EMIT_SYMBOL, 8),
+    (10, HUFFMAN_EMIT_SYMBOL, 8),
+    (15, HUFFMAN_EMIT_SYMBOL, 8),
+    (24, HUFFMAN_EMIT_SYMBOL, 8),
+    (31, HUFFMAN_EMIT_SYMBOL, 8),
+    (41, HUFFMAN_EMIT_SYMBOL, 8),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 8),
+    (3, HUFFMAN_EMIT_SYMBOL, 11),
+    (6, HUFFMAN_EMIT_SYMBOL, 11),
+    (10, HUFFMAN_EMIT_SYMBOL, 11),
+    (15, HUFFMAN_EMIT_SYMBOL, 11),
+    (24, HUFFMAN_EMIT_SYMBOL, 11),
+    (31, HUFFMAN_EMIT_SYMBOL, 11),
+    (41, HUFFMAN_EMIT_SYMBOL, 11),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 11),
+
+    # Node 234
+    (3, HUFFMAN_EMIT_SYMBOL, 12),
+    (6, HUFFMAN_EMIT_SYMBOL, 12),
+    (10, HUFFMAN_EMIT_SYMBOL, 12),
+    (15, HUFFMAN_EMIT_SYMBOL, 12),
+    (24, HUFFMAN_EMIT_SYMBOL, 12),
+    (31, HUFFMAN_EMIT_SYMBOL, 12),
+    (41, HUFFMAN_EMIT_SYMBOL, 12),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 12),
+    (3, HUFFMAN_EMIT_SYMBOL, 14),
+    (6, HUFFMAN_EMIT_SYMBOL, 14),
+    (10, HUFFMAN_EMIT_SYMBOL, 14),
+    (15, HUFFMAN_EMIT_SYMBOL, 14),
+    (24, HUFFMAN_EMIT_SYMBOL, 14),
+    (31, HUFFMAN_EMIT_SYMBOL, 14),
+    (41, HUFFMAN_EMIT_SYMBOL, 14),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 14),
+
+    # Node 235
+    (2, HUFFMAN_EMIT_SYMBOL, 15),
+    (9, HUFFMAN_EMIT_SYMBOL, 15),
+    (23, HUFFMAN_EMIT_SYMBOL, 15),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 15),
+    (2, HUFFMAN_EMIT_SYMBOL, 16),
+    (9, HUFFMAN_EMIT_SYMBOL, 16),
+    (23, HUFFMAN_EMIT_SYMBOL, 16),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 16),
+    (2, HUFFMAN_EMIT_SYMBOL, 17),
+    (9, HUFFMAN_EMIT_SYMBOL, 17),
+    (23, HUFFMAN_EMIT_SYMBOL, 17),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 17),
+    (2, HUFFMAN_EMIT_SYMBOL, 18),
+    (9, HUFFMAN_EMIT_SYMBOL, 18),
+    (23, HUFFMAN_EMIT_SYMBOL, 18),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 18),
+
+    # Node 236
+    (3, HUFFMAN_EMIT_SYMBOL, 15),
+    (6, HUFFMAN_EMIT_SYMBOL, 15),
+    (10, HUFFMAN_EMIT_SYMBOL, 15),
+    (15, HUFFMAN_EMIT_SYMBOL, 15),
+    (24, HUFFMAN_EMIT_SYMBOL, 15),
+    (31, HUFFMAN_EMIT_SYMBOL, 15),
+    (41, HUFFMAN_EMIT_SYMBOL, 15),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 15),
+    (3, HUFFMAN_EMIT_SYMBOL, 16),
+    (6, HUFFMAN_EMIT_SYMBOL, 16),
+    (10, HUFFMAN_EMIT_SYMBOL, 16),
+    (15, HUFFMAN_EMIT_SYMBOL, 16),
+    (24, HUFFMAN_EMIT_SYMBOL, 16),
+    (31, HUFFMAN_EMIT_SYMBOL, 16),
+    (41, HUFFMAN_EMIT_SYMBOL, 16),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 16),
+
+    # Node 237
+    (3, HUFFMAN_EMIT_SYMBOL, 17),
+    (6, HUFFMAN_EMIT_SYMBOL, 17),
+    (10, HUFFMAN_EMIT_SYMBOL, 17),
+    (15, HUFFMAN_EMIT_SYMBOL, 17),
+    (24, HUFFMAN_EMIT_SYMBOL, 17),
+    (31, HUFFMAN_EMIT_SYMBOL, 17),
+    (41, HUFFMAN_EMIT_SYMBOL, 17),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 17),
+    (3, HUFFMAN_EMIT_SYMBOL, 18),
+    (6, HUFFMAN_EMIT_SYMBOL, 18),
+    (10, HUFFMAN_EMIT_SYMBOL, 18),
+    (15, HUFFMAN_EMIT_SYMBOL, 18),
+    (24, HUFFMAN_EMIT_SYMBOL, 18),
+    (31, HUFFMAN_EMIT_SYMBOL, 18),
+    (41, HUFFMAN_EMIT_SYMBOL, 18),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 18),
+
+    # Node 238
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 19),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 20),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 21),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 23),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 24),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 25),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 26),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 27),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 28),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 29),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 30),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 31),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 127),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 220),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 249),
+    (253, 0, 0),
+
+    # Node 239
+    (1, HUFFMAN_EMIT_SYMBOL, 19),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 19),
+    (1, HUFFMAN_EMIT_SYMBOL, 20),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 20),
+    (1, HUFFMAN_EMIT_SYMBOL, 21),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 21),
+    (1, HUFFMAN_EMIT_SYMBOL, 23),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 23),
+    (1, HUFFMAN_EMIT_SYMBOL, 24),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 24),
+    (1, HUFFMAN_EMIT_SYMBOL, 25),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 25),
+    (1, HUFFMAN_EMIT_SYMBOL, 26),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 26),
+    (1, HUFFMAN_EMIT_SYMBOL, 27),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 27),
+
+    # Node 240
+    (2, HUFFMAN_EMIT_SYMBOL, 19),
+    (9, HUFFMAN_EMIT_SYMBOL, 19),
+    (23, HUFFMAN_EMIT_SYMBOL, 19),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 19),
+    (2, HUFFMAN_EMIT_SYMBOL, 20),
+    (9, HUFFMAN_EMIT_SYMBOL, 20),
+    (23, HUFFMAN_EMIT_SYMBOL, 20),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 20),
+    (2, HUFFMAN_EMIT_SYMBOL, 21),
+    (9, HUFFMAN_EMIT_SYMBOL, 21),
+    (23, HUFFMAN_EMIT_SYMBOL, 21),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 21),
+    (2, HUFFMAN_EMIT_SYMBOL, 23),
+    (9, HUFFMAN_EMIT_SYMBOL, 23),
+    (23, HUFFMAN_EMIT_SYMBOL, 23),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 23),
+
+    # Node 241
+    (3, HUFFMAN_EMIT_SYMBOL, 19),
+    (6, HUFFMAN_EMIT_SYMBOL, 19),
+    (10, HUFFMAN_EMIT_SYMBOL, 19),
+    (15, HUFFMAN_EMIT_SYMBOL, 19),
+    (24, HUFFMAN_EMIT_SYMBOL, 19),
+    (31, HUFFMAN_EMIT_SYMBOL, 19),
+    (41, HUFFMAN_EMIT_SYMBOL, 19),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 19),
+    (3, HUFFMAN_EMIT_SYMBOL, 20),
+    (6, HUFFMAN_EMIT_SYMBOL, 20),
+    (10, HUFFMAN_EMIT_SYMBOL, 20),
+    (15, HUFFMAN_EMIT_SYMBOL, 20),
+    (24, HUFFMAN_EMIT_SYMBOL, 20),
+    (31, HUFFMAN_EMIT_SYMBOL, 20),
+    (41, HUFFMAN_EMIT_SYMBOL, 20),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 20),
+
+    # Node 242
+    (3, HUFFMAN_EMIT_SYMBOL, 21),
+    (6, HUFFMAN_EMIT_SYMBOL, 21),
+    (10, HUFFMAN_EMIT_SYMBOL, 21),
+    (15, HUFFMAN_EMIT_SYMBOL, 21),
+    (24, HUFFMAN_EMIT_SYMBOL, 21),
+    (31, HUFFMAN_EMIT_SYMBOL, 21),
+    (41, HUFFMAN_EMIT_SYMBOL, 21),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 21),
+    (3, HUFFMAN_EMIT_SYMBOL, 23),
+    (6, HUFFMAN_EMIT_SYMBOL, 23),
+    (10, HUFFMAN_EMIT_SYMBOL, 23),
+    (15, HUFFMAN_EMIT_SYMBOL, 23),
+    (24, HUFFMAN_EMIT_SYMBOL, 23),
+    (31, HUFFMAN_EMIT_SYMBOL, 23),
+    (41, HUFFMAN_EMIT_SYMBOL, 23),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 23),
+
+    # Node 243
+    (2, HUFFMAN_EMIT_SYMBOL, 24),
+    (9, HUFFMAN_EMIT_SYMBOL, 24),
+    (23, HUFFMAN_EMIT_SYMBOL, 24),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 24),
+    (2, HUFFMAN_EMIT_SYMBOL, 25),
+    (9, HUFFMAN_EMIT_SYMBOL, 25),
+    (23, HUFFMAN_EMIT_SYMBOL, 25),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 25),
+    (2, HUFFMAN_EMIT_SYMBOL, 26),
+    (9, HUFFMAN_EMIT_SYMBOL, 26),
+    (23, HUFFMAN_EMIT_SYMBOL, 26),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 26),
+    (2, HUFFMAN_EMIT_SYMBOL, 27),
+    (9, HUFFMAN_EMIT_SYMBOL, 27),
+    (23, HUFFMAN_EMIT_SYMBOL, 27),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 27),
+
+    # Node 244
+    (3, HUFFMAN_EMIT_SYMBOL, 24),
+    (6, HUFFMAN_EMIT_SYMBOL, 24),
+    (10, HUFFMAN_EMIT_SYMBOL, 24),
+    (15, HUFFMAN_EMIT_SYMBOL, 24),
+    (24, HUFFMAN_EMIT_SYMBOL, 24),
+    (31, HUFFMAN_EMIT_SYMBOL, 24),
+    (41, HUFFMAN_EMIT_SYMBOL, 24),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 24),
+    (3, HUFFMAN_EMIT_SYMBOL, 25),
+    (6, HUFFMAN_EMIT_SYMBOL, 25),
+    (10, HUFFMAN_EMIT_SYMBOL, 25),
+    (15, HUFFMAN_EMIT_SYMBOL, 25),
+    (24, HUFFMAN_EMIT_SYMBOL, 25),
+    (31, HUFFMAN_EMIT_SYMBOL, 25),
+    (41, HUFFMAN_EMIT_SYMBOL, 25),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 25),
+
+    # Node 245
+    (3, HUFFMAN_EMIT_SYMBOL, 26),
+    (6, HUFFMAN_EMIT_SYMBOL, 26),
+    (10, HUFFMAN_EMIT_SYMBOL, 26),
+    (15, HUFFMAN_EMIT_SYMBOL, 26),
+    (24, HUFFMAN_EMIT_SYMBOL, 26),
+    (31, HUFFMAN_EMIT_SYMBOL, 26),
+    (41, HUFFMAN_EMIT_SYMBOL, 26),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 26),
+    (3, HUFFMAN_EMIT_SYMBOL, 27),
+    (6, HUFFMAN_EMIT_SYMBOL, 27),
+    (10, HUFFMAN_EMIT_SYMBOL, 27),
+    (15, HUFFMAN_EMIT_SYMBOL, 27),
+    (24, HUFFMAN_EMIT_SYMBOL, 27),
+    (31, HUFFMAN_EMIT_SYMBOL, 27),
+    (41, HUFFMAN_EMIT_SYMBOL, 27),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 27),
+
+    # Node 246
+    (1, HUFFMAN_EMIT_SYMBOL, 28),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 28),
+    (1, HUFFMAN_EMIT_SYMBOL, 29),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 29),
+    (1, HUFFMAN_EMIT_SYMBOL, 30),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 30),
+    (1, HUFFMAN_EMIT_SYMBOL, 31),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 31),
+    (1, HUFFMAN_EMIT_SYMBOL, 127),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 127),
+    (1, HUFFMAN_EMIT_SYMBOL, 220),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 220),
+    (1, HUFFMAN_EMIT_SYMBOL, 249),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 249),
+    (254, 0, 0),
+    (255, 0, 0),
+
+    # Node 247
+    (2, HUFFMAN_EMIT_SYMBOL, 28),
+    (9, HUFFMAN_EMIT_SYMBOL, 28),
+    (23, HUFFMAN_EMIT_SYMBOL, 28),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 28),
+    (2, HUFFMAN_EMIT_SYMBOL, 29),
+    (9, HUFFMAN_EMIT_SYMBOL, 29),
+    (23, HUFFMAN_EMIT_SYMBOL, 29),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 29),
+    (2, HUFFMAN_EMIT_SYMBOL, 30),
+    (9, HUFFMAN_EMIT_SYMBOL, 30),
+    (23, HUFFMAN_EMIT_SYMBOL, 30),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 30),
+    (2, HUFFMAN_EMIT_SYMBOL, 31),
+    (9, HUFFMAN_EMIT_SYMBOL, 31),
+    (23, HUFFMAN_EMIT_SYMBOL, 31),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 31),
+
+    # Node 248
+    (3, HUFFMAN_EMIT_SYMBOL, 28),
+    (6, HUFFMAN_EMIT_SYMBOL, 28),
+    (10, HUFFMAN_EMIT_SYMBOL, 28),
+    (15, HUFFMAN_EMIT_SYMBOL, 28),
+    (24, HUFFMAN_EMIT_SYMBOL, 28),
+    (31, HUFFMAN_EMIT_SYMBOL, 28),
+    (41, HUFFMAN_EMIT_SYMBOL, 28),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 28),
+    (3, HUFFMAN_EMIT_SYMBOL, 29),
+    (6, HUFFMAN_EMIT_SYMBOL, 29),
+    (10, HUFFMAN_EMIT_SYMBOL, 29),
+    (15, HUFFMAN_EMIT_SYMBOL, 29),
+    (24, HUFFMAN_EMIT_SYMBOL, 29),
+    (31, HUFFMAN_EMIT_SYMBOL, 29),
+    (41, HUFFMAN_EMIT_SYMBOL, 29),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 29),
+
+    # Node 249
+    (3, HUFFMAN_EMIT_SYMBOL, 30),
+    (6, HUFFMAN_EMIT_SYMBOL, 30),
+    (10, HUFFMAN_EMIT_SYMBOL, 30),
+    (15, HUFFMAN_EMIT_SYMBOL, 30),
+    (24, HUFFMAN_EMIT_SYMBOL, 30),
+    (31, HUFFMAN_EMIT_SYMBOL, 30),
+    (41, HUFFMAN_EMIT_SYMBOL, 30),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 30),
+    (3, HUFFMAN_EMIT_SYMBOL, 31),
+    (6, HUFFMAN_EMIT_SYMBOL, 31),
+    (10, HUFFMAN_EMIT_SYMBOL, 31),
+    (15, HUFFMAN_EMIT_SYMBOL, 31),
+    (24, HUFFMAN_EMIT_SYMBOL, 31),
+    (31, HUFFMAN_EMIT_SYMBOL, 31),
+    (41, HUFFMAN_EMIT_SYMBOL, 31),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 31),
+
+    # Node 250
+    (2, HUFFMAN_EMIT_SYMBOL, 127),
+    (9, HUFFMAN_EMIT_SYMBOL, 127),
+    (23, HUFFMAN_EMIT_SYMBOL, 127),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 127),
+    (2, HUFFMAN_EMIT_SYMBOL, 220),
+    (9, HUFFMAN_EMIT_SYMBOL, 220),
+    (23, HUFFMAN_EMIT_SYMBOL, 220),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 220),
+    (2, HUFFMAN_EMIT_SYMBOL, 249),
+    (9, HUFFMAN_EMIT_SYMBOL, 249),
+    (23, HUFFMAN_EMIT_SYMBOL, 249),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 249),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 10),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 13),
+    (0, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 22),
+    (0, HUFFMAN_FAIL, 0),
+
+    # Node 251
+    (3, HUFFMAN_EMIT_SYMBOL, 127),
+    (6, HUFFMAN_EMIT_SYMBOL, 127),
+    (10, HUFFMAN_EMIT_SYMBOL, 127),
+    (15, HUFFMAN_EMIT_SYMBOL, 127),
+    (24, HUFFMAN_EMIT_SYMBOL, 127),
+    (31, HUFFMAN_EMIT_SYMBOL, 127),
+    (41, HUFFMAN_EMIT_SYMBOL, 127),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 127),
+    (3, HUFFMAN_EMIT_SYMBOL, 220),
+    (6, HUFFMAN_EMIT_SYMBOL, 220),
+    (10, HUFFMAN_EMIT_SYMBOL, 220),
+    (15, HUFFMAN_EMIT_SYMBOL, 220),
+    (24, HUFFMAN_EMIT_SYMBOL, 220),
+    (31, HUFFMAN_EMIT_SYMBOL, 220),
+    (41, HUFFMAN_EMIT_SYMBOL, 220),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 220),
+
+    # Node 252
+    (3, HUFFMAN_EMIT_SYMBOL, 249),
+    (6, HUFFMAN_EMIT_SYMBOL, 249),
+    (10, HUFFMAN_EMIT_SYMBOL, 249),
+    (15, HUFFMAN_EMIT_SYMBOL, 249),
+    (24, HUFFMAN_EMIT_SYMBOL, 249),
+    (31, HUFFMAN_EMIT_SYMBOL, 249),
+    (41, HUFFMAN_EMIT_SYMBOL, 249),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 249),
+    (1, HUFFMAN_EMIT_SYMBOL, 10),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 10),
+    (1, HUFFMAN_EMIT_SYMBOL, 13),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 13),
+    (1, HUFFMAN_EMIT_SYMBOL, 22),
+    (22, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 22),
+    (0, HUFFMAN_FAIL, 0),
+    (0, HUFFMAN_FAIL, 0),
+
+    # Node 253
+    (2, HUFFMAN_EMIT_SYMBOL, 10),
+    (9, HUFFMAN_EMIT_SYMBOL, 10),
+    (23, HUFFMAN_EMIT_SYMBOL, 10),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 10),
+    (2, HUFFMAN_EMIT_SYMBOL, 13),
+    (9, HUFFMAN_EMIT_SYMBOL, 13),
+    (23, HUFFMAN_EMIT_SYMBOL, 13),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 13),
+    (2, HUFFMAN_EMIT_SYMBOL, 22),
+    (9, HUFFMAN_EMIT_SYMBOL, 22),
+    (23, HUFFMAN_EMIT_SYMBOL, 22),
+    (40, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 22),
+    (0, HUFFMAN_FAIL, 0),
+    (0, HUFFMAN_FAIL, 0),
+    (0, HUFFMAN_FAIL, 0),
+    (0, HUFFMAN_FAIL, 0),
+
+    # Node 254
+    (3, HUFFMAN_EMIT_SYMBOL, 10),
+    (6, HUFFMAN_EMIT_SYMBOL, 10),
+    (10, HUFFMAN_EMIT_SYMBOL, 10),
+    (15, HUFFMAN_EMIT_SYMBOL, 10),
+    (24, HUFFMAN_EMIT_SYMBOL, 10),
+    (31, HUFFMAN_EMIT_SYMBOL, 10),
+    (41, HUFFMAN_EMIT_SYMBOL, 10),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 10),
+    (3, HUFFMAN_EMIT_SYMBOL, 13),
+    (6, HUFFMAN_EMIT_SYMBOL, 13),
+    (10, HUFFMAN_EMIT_SYMBOL, 13),
+    (15, HUFFMAN_EMIT_SYMBOL, 13),
+    (24, HUFFMAN_EMIT_SYMBOL, 13),
+    (31, HUFFMAN_EMIT_SYMBOL, 13),
+    (41, HUFFMAN_EMIT_SYMBOL, 13),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 13),
+
+    # Node 255
+    (3, HUFFMAN_EMIT_SYMBOL, 22),
+    (6, HUFFMAN_EMIT_SYMBOL, 22),
+    (10, HUFFMAN_EMIT_SYMBOL, 22),
+    (15, HUFFMAN_EMIT_SYMBOL, 22),
+    (24, HUFFMAN_EMIT_SYMBOL, 22),
+    (31, HUFFMAN_EMIT_SYMBOL, 22),
+    (41, HUFFMAN_EMIT_SYMBOL, 22),
+    (56, HUFFMAN_COMPLETE | HUFFMAN_EMIT_SYMBOL, 22),
+    (0, HUFFMAN_FAIL, 0),
+    (0, HUFFMAN_FAIL, 0),
+    (0, HUFFMAN_FAIL, 0),
+    (0, HUFFMAN_FAIL, 0),
+    (0, HUFFMAN_FAIL, 0),
+    (0, HUFFMAN_FAIL, 0),
+    (0, HUFFMAN_FAIL, 0),
+    (0, HUFFMAN_FAIL, 0),
+]
diff --git a/llm/Lib/site-packages/hpack/struct.py b/llm/Lib/site-packages/hpack/struct.py
new file mode 100644
index 0000000000000000000000000000000000000000..fcab9295607282f79499cf1c5c338b717c8cbb30
--- /dev/null
+++ b/llm/Lib/site-packages/hpack/struct.py
@@ -0,0 +1,39 @@
+# -*- coding: utf-8 -*-
+"""
+hpack/struct
+~~~~~~~~~~~~
+
+Contains structures for representing header fields with associated metadata.
+"""
+
+
+class HeaderTuple(tuple):
+    """
+    A data structure that stores a single header field.
+
+    HTTP headers can be thought of as tuples of ``(field name, field value)``.
+    A single header block is a sequence of such tuples.
+
+    In HTTP/2, however, certain bits of additional information are required for
+    compressing these headers: in particular, whether the header field can be
+    safely added to the HPACK compression context.
+
+    This class stores a header that can be added to the compression context. In
+    all other ways it behaves exactly like a tuple.
+    """
+    __slots__ = ()
+
+    indexable = True
+
+    def __new__(cls, *args):
+        return tuple.__new__(cls, args)
+
+
+class NeverIndexedHeaderTuple(HeaderTuple):
+    """
+    A data structure that stores a single header field that cannot be added to
+    a HTTP/2 header compression context.
+    """
+    __slots__ = ()
+
+    indexable = False
diff --git a/llm/Lib/site-packages/hpack/table.py b/llm/Lib/site-packages/hpack/table.py
new file mode 100644
index 0000000000000000000000000000000000000000..2b656f32a117c86e747c272644261041552083f2
--- /dev/null
+++ b/llm/Lib/site-packages/hpack/table.py
@@ -0,0 +1,235 @@
+# -*- coding: utf-8 -*-
+# flake8: noqa
+from collections import deque
+import logging
+
+from .exceptions import InvalidTableIndex
+
+log = logging.getLogger(__name__)
+
+
+def table_entry_size(name, value):
+    """
+    Calculates the size of a single entry
+
+    This size is mostly irrelevant to us and defined
+    specifically to accommodate memory management for
+    lower level implementations. The 32 extra bytes are
+    considered the "maximum" overhead that would be
+    required to represent each entry in the table.
+
+    See RFC7541 Section 4.1
+    """
+    return 32 + len(name) + len(value)
+
+
+class HeaderTable:
+    """
+    Implements the combined static and dynamic header table
+
+    The name and value arguments for all the functions
+    should ONLY be byte strings (b'') however this is not
+    strictly enforced in the interface.
+
+    See RFC7541 Section 2.3
+    """
+    #: Default maximum size of the dynamic table. See
+    #:  RFC7540 Section 6.5.2.
+    DEFAULT_SIZE = 4096
+
+    #: Constant list of static headers. See RFC7541 Section
+    #:  2.3.1 and Appendix A
+    STATIC_TABLE = (
+        (b':authority'                  , b''             ),  # noqa
+        (b':method'                     , b'GET'          ),  # noqa
+        (b':method'                     , b'POST'         ),  # noqa
+        (b':path'                       , b'/'            ),  # noqa
+        (b':path'                       , b'/index.html'  ),  # noqa
+        (b':scheme'                     , b'http'         ),  # noqa
+        (b':scheme'                     , b'https'        ),  # noqa
+        (b':status'                     , b'200'          ),  # noqa
+        (b':status'                     , b'204'          ),  # noqa
+        (b':status'                     , b'206'          ),  # noqa
+        (b':status'                     , b'304'          ),  # noqa
+        (b':status'                     , b'400'          ),  # noqa
+        (b':status'                     , b'404'          ),  # noqa
+        (b':status'                     , b'500'          ),  # noqa
+        (b'accept-charset'              , b''             ),  # noqa
+        (b'accept-encoding'             , b'gzip, deflate'),  # noqa
+        (b'accept-language'             , b''             ),  # noqa
+        (b'accept-ranges'               , b''             ),  # noqa
+        (b'accept'                      , b''             ),  # noqa
+        (b'access-control-allow-origin' , b''             ),  # noqa
+        (b'age'                         , b''             ),  # noqa
+        (b'allow'                       , b''             ),  # noqa
+        (b'authorization'               , b''             ),  # noqa
+        (b'cache-control'               , b''             ),  # noqa
+        (b'content-disposition'         , b''             ),  # noqa
+        (b'content-encoding'            , b''             ),  # noqa
+        (b'content-language'            , b''             ),  # noqa
+        (b'content-length'              , b''             ),  # noqa
+        (b'content-location'            , b''             ),  # noqa
+        (b'content-range'               , b''             ),  # noqa
+        (b'content-type'                , b''             ),  # noqa
+        (b'cookie'                      , b''             ),  # noqa
+        (b'date'                        , b''             ),  # noqa
+        (b'etag'                        , b''             ),  # noqa
+        (b'expect'                      , b''             ),  # noqa
+        (b'expires'                     , b''             ),  # noqa
+        (b'from'                        , b''             ),  # noqa
+        (b'host'                        , b''             ),  # noqa
+        (b'if-match'                    , b''             ),  # noqa
+        (b'if-modified-since'           , b''             ),  # noqa
+        (b'if-none-match'               , b''             ),  # noqa
+        (b'if-range'                    , b''             ),  # noqa
+        (b'if-unmodified-since'         , b''             ),  # noqa
+        (b'last-modified'               , b''             ),  # noqa
+        (b'link'                        , b''             ),  # noqa
+        (b'location'                    , b''             ),  # noqa
+        (b'max-forwards'                , b''             ),  # noqa
+        (b'proxy-authenticate'          , b''             ),  # noqa
+        (b'proxy-authorization'         , b''             ),  # noqa
+        (b'range'                       , b''             ),  # noqa
+        (b'referer'                     , b''             ),  # noqa
+        (b'refresh'                     , b''             ),  # noqa
+        (b'retry-after'                 , b''             ),  # noqa
+        (b'server'                      , b''             ),  # noqa
+        (b'set-cookie'                  , b''             ),  # noqa
+        (b'strict-transport-security'   , b''             ),  # noqa
+        (b'transfer-encoding'           , b''             ),  # noqa
+        (b'user-agent'                  , b''             ),  # noqa
+        (b'vary'                        , b''             ),  # noqa
+        (b'via'                         , b''             ),  # noqa
+        (b'www-authenticate'            , b''             ),  # noqa
+    )  # noqa
+
+    STATIC_TABLE_LENGTH = len(STATIC_TABLE)
+
+    def __init__(self):
+        self._maxsize = HeaderTable.DEFAULT_SIZE
+        self._current_size = 0
+        self.resized = False
+        self.dynamic_entries = deque()
+
+    def get_by_index(self, index):
+        """
+        Returns the entry specified by index
+
+        Note that the table is 1-based ie an index of 0 is
+        invalid.  This is due to the fact that a zero value
+        index signals that a completely unindexed header
+        follows.
+
+        The entry will either be from the static table or
+        the dynamic table depending on the value of index.
+        """
+        original_index = index
+        index -= 1
+        if 0 <= index:
+            if index < HeaderTable.STATIC_TABLE_LENGTH:
+                return HeaderTable.STATIC_TABLE[index]
+
+            index -= HeaderTable.STATIC_TABLE_LENGTH
+            if index < len(self.dynamic_entries):
+                return self.dynamic_entries[index]
+
+        raise InvalidTableIndex("Invalid table index %d" % original_index)
+
+    def __repr__(self):
+        return "HeaderTable(%d, %s, %r)" % (
+            self._maxsize,
+            self.resized,
+            self.dynamic_entries
+        )
+
+    def add(self, name, value):
+        """
+        Adds a new entry to the table
+
+        We reduce the table size if the entry will make the
+        table size greater than maxsize.
+        """
+        # We just clear the table if the entry is too big
+        size = table_entry_size(name, value)
+        if size > self._maxsize:
+            self.dynamic_entries.clear()
+            self._current_size = 0
+        else:
+            # Add new entry
+            self.dynamic_entries.appendleft((name, value))
+            self._current_size += size
+            self._shrink()
+
+    def search(self, name, value):
+        """
+        Searches the table for the entry specified by name
+        and value
+
+        Returns one of the following:
+            - ``None``, no match at all
+            - ``(index, name, None)`` for partial matches on name only.
+            - ``(index, name, value)`` for perfect matches.
+        """
+        partial = None
+
+        header_name_search_result = HeaderTable.STATIC_TABLE_MAPPING.get(name)
+        if header_name_search_result:
+            index = header_name_search_result[1].get(value)
+            if index is not None:
+                return index, name, value
+            else:
+                partial = (header_name_search_result[0], name, None)
+
+        offset = HeaderTable.STATIC_TABLE_LENGTH + 1
+        for (i, (n, v)) in enumerate(self.dynamic_entries):
+            if n == name:
+                if v == value:
+                    return i + offset, n, v
+                elif partial is None:
+                    partial = (i + offset, n, None)
+        return partial
+
+    @property
+    def maxsize(self):
+        return self._maxsize
+
+    @maxsize.setter
+    def maxsize(self, newmax):
+        newmax = int(newmax)
+        log.debug("Resizing header table to %d from %d", newmax, self._maxsize)
+        oldmax = self._maxsize
+        self._maxsize = newmax
+        self.resized = (newmax != oldmax)
+        if newmax <= 0:
+            self.dynamic_entries.clear()
+            self._current_size = 0
+        elif oldmax > newmax:
+            self._shrink()
+
+    def _shrink(self):
+        """
+        Shrinks the dynamic table to be at or below maxsize
+        """
+        cursize = self._current_size
+        while cursize > self._maxsize:
+            name, value = self.dynamic_entries.pop()
+            cursize -= table_entry_size(name, value)
+            log.debug("Evicting %s: %s from the header table", name, value)
+        self._current_size = cursize
+
+
+def _build_static_table_mapping():
+    """
+    Build static table mapping from header name to tuple with next structure:
+    (<minimal index of header>, <mapping from header value to it index>).
+
+    static_table_mapping used for hash searching.
+    """
+    static_table_mapping = {}
+    for index, (name, value) in enumerate(HeaderTable.STATIC_TABLE, 1):
+        header_name_search_result = static_table_mapping.setdefault(name, (index, {}))
+        header_name_search_result[1][value] = index
+    return static_table_mapping
+
+
+HeaderTable.STATIC_TABLE_MAPPING = _build_static_table_mapping()
diff --git a/llm/Lib/site-packages/httpcore-1.0.5.dist-info/INSTALLER b/llm/Lib/site-packages/httpcore-1.0.5.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore-1.0.5.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/httpcore-1.0.5.dist-info/METADATA b/llm/Lib/site-packages/httpcore-1.0.5.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..0e2009536e5bbae76dd8c319d496e1fbbcf0efe6
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore-1.0.5.dist-info/METADATA
@@ -0,0 +1,607 @@
+Metadata-Version: 2.3
+Name: httpcore
+Version: 1.0.5
+Summary: A minimal low-level HTTP client.
+Project-URL: Documentation, https://www.encode.io/httpcore
+Project-URL: Homepage, https://www.encode.io/httpcore/
+Project-URL: Source, https://github.com/encode/httpcore
+Author-email: Tom Christie <tom@tomchristie.com>
+License-Expression: BSD-3-Clause
+License-File: LICENSE.md
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Framework :: AsyncIO
+Classifier: Framework :: Trio
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.8
+Requires-Dist: certifi
+Requires-Dist: h11<0.15,>=0.13
+Provides-Extra: asyncio
+Requires-Dist: anyio<5.0,>=4.0; extra == 'asyncio'
+Provides-Extra: http2
+Requires-Dist: h2<5,>=3; extra == 'http2'
+Provides-Extra: socks
+Requires-Dist: socksio==1.*; extra == 'socks'
+Provides-Extra: trio
+Requires-Dist: trio<0.26.0,>=0.22.0; extra == 'trio'
+Description-Content-Type: text/markdown
+
+# HTTP Core
+
+[![Test Suite](https://github.com/encode/httpcore/workflows/Test%20Suite/badge.svg)](https://github.com/encode/httpcore/actions)
+[![Package version](https://badge.fury.io/py/httpcore.svg)](https://pypi.org/project/httpcore/)
+
+> *Do one thing, and do it well.*
+
+The HTTP Core package provides a minimal low-level HTTP client, which does
+one thing only. Sending HTTP requests.
+
+It does not provide any high level model abstractions over the API,
+does not handle redirects, multipart uploads, building authentication headers,
+transparent HTTP caching, URL parsing, session cookie handling,
+content or charset decoding, handling JSON, environment based configuration
+defaults, or any of that Jazz.
+
+Some things HTTP Core does do:
+
+* Sending HTTP requests.
+* Thread-safe / task-safe connection pooling.
+* HTTP(S) proxy & SOCKS proxy support.
+* Supports HTTP/1.1 and HTTP/2.
+* Provides both sync and async interfaces.
+* Async backend support for `asyncio` and `trio`.
+
+## Requirements
+
+Python 3.8+
+
+## Installation
+
+For HTTP/1.1 only support, install with:
+
+```shell
+$ pip install httpcore
+```
+
+There are also a number of optional extras available...
+
+```shell
+$ pip install httpcore['asyncio,trio,http2,socks']
+```
+
+# Sending requests
+
+Send an HTTP request:
+
+```python
+import httpcore
+
+response = httpcore.request("GET", "https://www.example.com/")
+
+print(response)
+# <Response [200]>
+print(response.status)
+# 200
+print(response.headers)
+# [(b'Accept-Ranges', b'bytes'), (b'Age', b'557328'), (b'Cache-Control', b'max-age=604800'), ...]
+print(response.content)
+# b'<!doctype html>\n<html>\n<head>\n<title>Example Domain</title>\n\n<meta charset="utf-8"/>\n ...'
+```
+
+The top-level `httpcore.request()` function is provided for convenience. In practice whenever you're working with `httpcore` you'll want to use the connection pooling functionality that it provides.
+
+```python
+import httpcore
+
+http = httpcore.ConnectionPool()
+response = http.request("GET", "https://www.example.com/")
+```
+
+Once you're ready to get going, [head over to the documentation](https://www.encode.io/httpcore/).
+
+## Motivation
+
+You *probably* don't want to be using HTTP Core directly. It might make sense if
+you're writing something like a proxy service in Python, and you just want
+something at the lowest possible level, but more typically you'll want to use
+a higher level client library, such as `httpx`.
+
+The motivation for `httpcore` is:
+
+* To provide a reusable low-level client library, that other packages can then build on top of.
+* To provide a *really clear interface split* between the networking code and client logic,
+  so that each is easier to understand and reason about in isolation.
+
+## Dependencies
+
+The `httpcore` package has the following dependencies...
+
+* `h11`
+* `certifi`
+
+And the following optional extras...
+
+* `anyio` - Required by `pip install httpcore['asyncio']`.
+* `trio` - Required by `pip install httpcore['trio']`.
+* `h2` - Required by `pip install httpcore['http2']`.
+* `socksio` - Required by `pip install httpcore['socks']`.
+
+## Versioning
+
+We use [SEMVER for our versioning policy](https://semver.org/).
+
+For changes between package versions please see our [project changelog](CHANGELOG.md).
+
+We recommend pinning your requirements either the most current major version, or a more specific version range:
+
+```python
+pip install 'httpcore==1.*'
+```
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## 1.0.5 (March 27th, 2024)
+
+- Handle `EndOfStream` exception for anyio backend. (#899)
+- Allow trio `0.25.*` series in package dependancies. (#903)
+
+## 1.0.4 (February 21st, 2024)
+
+- Add `target` request extension. (#888)
+- Fix support for connection `Upgrade` and `CONNECT` when some data in the stream has been read. (#882)
+
+## 1.0.3 (February 13th, 2024)
+
+- Fix support for async cancellations. (#880)
+- Fix trace extension when used with socks proxy. (#849)
+- Fix SSL context for connections using the "wss" scheme (#869)
+
+## 1.0.2 (November 10th, 2023)
+
+- Fix `float("inf")` timeouts in `Event.wait` function. (#846)
+
+## 1.0.1 (November 3rd, 2023)
+
+- Fix pool timeout to account for the total time spent retrying. (#823)
+- Raise a neater RuntimeError when the correct async deps are not installed. (#826)
+- Add support for synchronous TLS-in-TLS streams. (#840)
+
+## 1.0.0 (October 6th, 2023)
+
+From version 1.0 our async support is now optional, as the package has minimal dependencies by default.
+
+For async support use either `pip install 'httpcore[asyncio]'` or `pip install 'httpcore[trio]'`.
+
+The project versioning policy is now explicitly governed by SEMVER. See https://semver.org/.
+
+- Async support becomes fully optional. (#809)
+- Add support for Python 3.12. (#807)
+
+## 0.18.0 (September 8th, 2023)
+
+- Add support for HTTPS proxies. (#745, #786)
+- Drop Python 3.7 support. (#727)
+- Handle `sni_hostname` extension with SOCKS proxy. (#774)
+- Handle HTTP/1.1 half-closed connections gracefully. (#641)
+- Change the type of `Extensions` from `Mapping[Str, Any]` to `MutableMapping[Str, Any]`. (#762)
+
+## 0.17.3 (July 5th, 2023)
+
+- Support async cancellations, ensuring that the connection pool is left in a clean state when cancellations occur. (#726)
+- The networking backend interface has [been added to the public API](https://www.encode.io/httpcore/network-backends). Some classes which were previously private implementation detail are now part of the top-level public API. (#699)
+- Graceful handling of HTTP/2 GoAway frames, with requests being transparently retried on a new connection. (#730)
+- Add exceptions when a synchronous `trace callback` is passed to an asynchronous request or an asynchronous `trace callback` is passed to a synchronous request. (#717)
+- Drop Python 3.7 support. (#727)
+
+## 0.17.2 (May 23th, 2023)
+
+- Add `socket_options` argument to `ConnectionPool` and `HTTProxy` classes. (#668)
+- Improve logging with per-module logger names. (#690)
+- Add `sni_hostname` request extension. (#696)
+- Resolve race condition during import of `anyio` package. (#692)
+- Enable TCP_NODELAY for all synchronous sockets. (#651)
+
+## 0.17.1 (May 17th, 2023)
+
+- If 'retries' is set, then allow retries if an SSL handshake error occurs. (#669)
+- Improve correctness of tracebacks on network exceptions, by raising properly chained exceptions. (#678)
+- Prevent connection-hanging behaviour when HTTP/2 connections are closed by a server-sent 'GoAway' frame. (#679)
+- Fix edge-case exception when removing requests from the connection pool. (#680)
+- Fix pool timeout edge-case. (#688)
+
+## 0.17.0 (March 16th, 2023)
+
+- Add DEBUG level logging. (#648)
+- Respect HTTP/2 max concurrent streams when settings updates are sent by server. (#652)
+- Increase the allowable HTTP header size to 100kB. (#647)
+- Add `retries` option to SOCKS proxy classes. (#643)
+
+## 0.16.3 (December 20th, 2022)
+
+- Allow `ws` and `wss` schemes. Allows us to properly support websocket upgrade connections. (#625)
+- Forwarding HTTP proxies use a connection-per-remote-host. Required by some proxy implementations. (#637)
+- Don't raise `RuntimeError` when closing a connection pool with active connections. Removes some error cases when cancellations are used. (#631)
+- Lazy import `anyio`, so that it's no longer a hard dependancy, and isn't imported if unused. (#639)
+
+## 0.16.2 (November 25th, 2022)
+
+- Revert 'Fix async cancellation behaviour', which introduced race conditions. (#627)
+- Raise `RuntimeError` if attempting to us UNIX domain sockets on Windows. (#619)
+
+## 0.16.1 (November 17th, 2022)
+
+- Fix HTTP/1.1 interim informational responses, such as "100 Continue". (#605)
+
+## 0.16.0 (October 11th, 2022)
+
+- Support HTTP/1.1 informational responses. (#581)
+- Fix async cancellation behaviour. (#580)
+- Support `h11` 0.14. (#579)
+
+## 0.15.0 (May 17th, 2022)
+
+- Drop Python 3.6 support (#535)
+- Ensure HTTP proxy CONNECT requests include `timeout` configuration. (#506)
+- Switch to explicit `typing.Optional` for type hints. (#513)
+- For `trio` map OSError exceptions to `ConnectError`. (#543)
+
+## 0.14.7 (February 4th, 2022)
+
+- Requests which raise a PoolTimeout need to be removed from the pool queue. (#502)
+- Fix AttributeError that happened when Socks5Connection were terminated. (#501)
+
+## 0.14.6 (February 1st, 2022)
+
+- Fix SOCKS support for `http://` URLs. (#492)
+- Resolve race condition around exceptions during streaming a response. (#491)
+
+## 0.14.5 (January 18th, 2022)
+
+- SOCKS proxy support. (#478)
+- Add proxy_auth argument to HTTPProxy. (#481)
+- Improve error message on 'RemoteProtocolError' exception when server disconnects without sending a response. (#479)
+
+## 0.14.4 (January 5th, 2022)
+
+- Support HTTP/2 on HTTPS tunnelling proxies. (#468)
+- Fix proxy headers missing on HTTP forwarding. (#456)
+- Only instantiate SSL context if required. (#457)
+- More robust HTTP/2 handling. (#253, #439, #440, #441)
+
+## 0.14.3 (November 17th, 2021)
+
+- Fix race condition when removing closed connections from the pool. (#437)
+
+## 0.14.2 (November 16th, 2021)
+
+- Failed connections no longer remain in the pool. (Pull #433)
+
+## 0.14.1 (November 12th, 2021)
+
+- `max_connections` becomes optional. (Pull #429)
+- `certifi` is now included in the install dependancies. (Pull #428)
+- `h2` is now strictly optional. (Pull #428)
+
+## 0.14.0 (November 11th, 2021)
+
+The 0.14 release is a complete reworking of `httpcore`, comprehensively addressing some underlying issues in the connection pooling, as well as substantially redesigning the API to be more user friendly.
+
+Some of the lower-level API design also makes the components more easily testable in isolation, and the package now has 100% test coverage.
+
+See [discussion #419](https://github.com/encode/httpcore/discussions/419) for a little more background.
+
+There's some other neat bits in there too, such as the "trace" extension, which gives a hook into inspecting the internal events that occur during the request/response cycle. This extension is needed for the HTTPX cli, in order to...
+
+* Log the point at which the connection is established, and the IP/port on which it is made.
+* Determine if the outgoing request should log as HTTP/1.1 or HTTP/2, rather than having to assume it's HTTP/2 if the --http2 flag was passed. (Which may not actually be true.)
+* Log SSL version info / certificate info.
+
+Note that `curio` support is not currently available in 0.14.0. If you're using `httpcore` with `curio` please get in touch, so we can assess if we ought to prioritize it as a feature or not.
+
+## 0.13.7 (September 13th, 2021)
+
+- Fix broken error messaging when URL scheme is missing, or a non HTTP(S) scheme is used. (Pull #403)
+
+## 0.13.6 (June 15th, 2021)
+
+### Fixed
+
+- Close sockets when read or write timeouts occur. (Pull #365)
+
+## 0.13.5 (June 14th, 2021)
+
+### Fixed
+
+- Resolved niggles with AnyIO EOF behaviours. (Pull #358, #362)
+
+## 0.13.4 (June 9th, 2021)
+
+### Added
+
+- Improved error messaging when URL scheme is missing, or a non HTTP(S) scheme is used. (Pull #354)
+
+### Fixed
+
+- Switched to `anyio` as the default backend implementation when running with `asyncio`. Resolves some awkward [TLS timeout issues](https://github.com/encode/httpx/discussions/1511).
+
+## 0.13.3 (May 6th, 2021)
+
+### Added
+
+- Support HTTP/2 prior knowledge, using `httpcore.SyncConnectionPool(http1=False)`. (Pull #333)
+
+### Fixed
+
+- Handle cases where environment does not provide `select.poll` support. (Pull #331)
+
+## 0.13.2 (April 29th, 2021)
+
+### Added
+
+- Improve error message for specific case of `RemoteProtocolError` where server disconnects without sending a response. (Pull #313)
+
+## 0.13.1 (April 28th, 2021)
+
+### Fixed
+
+- More resiliant testing for closed connections. (Pull #311)
+- Don't raise exceptions on ungraceful connection closes. (Pull #310)
+
+## 0.13.0 (April 21st, 2021)
+
+The 0.13 release updates the core API in order to match the HTTPX Transport API,
+introduced in HTTPX 0.18 onwards.
+
+An example of making requests with the new interface is:
+
+```python
+with httpcore.SyncConnectionPool() as http:
+    status_code, headers, stream, extensions = http.handle_request(
+        method=b'GET',
+        url=(b'https', b'example.org', 443, b'/'),
+        headers=[(b'host', b'example.org'), (b'user-agent', b'httpcore')]
+        stream=httpcore.ByteStream(b''),
+        extensions={}
+    )
+    body = stream.read()
+    print(status_code, body)
+```
+
+### Changed
+
+- The `.request()` method is now `handle_request()`. (Pull #296)
+- The `.arequest()` method is now `.handle_async_request()`. (Pull #296)
+- The `headers` argument is no longer optional. (Pull #296)
+- The `stream` argument is no longer optional. (Pull #296)
+- The `ext` argument is now named `extensions`, and is no longer optional. (Pull #296)
+- The `"reason"` extension keyword is now named `"reason_phrase"`. (Pull #296)
+- The `"reason_phrase"` and `"http_version"` extensions now use byte strings for their values. (Pull #296)
+- The `httpcore.PlainByteStream()` class becomes `httpcore.ByteStream()`. (Pull #296)
+
+### Added
+
+- Streams now support a `.read()` interface. (Pull #296)
+
+### Fixed
+
+- Task cancellation no longer leaks connections from the connection pool. (Pull #305)
+
+## 0.12.3 (December 7th, 2020)
+
+### Fixed
+
+- Abort SSL connections on close rather than waiting for remote EOF when using `asyncio`.  (Pull #167)
+- Fix exception raised in case of connect timeouts when using the `anyio` backend. (Pull #236)
+- Fix `Host` header precedence for `:authority` in HTTP/2. (Pull #241, #243)
+- Handle extra edge case when detecting for socket readability when using `asyncio`. (Pull #242, #244)
+- Fix `asyncio` SSL warning when using proxy tunneling. (Pull #249)
+
+## 0.12.2 (November 20th, 2020)
+
+### Fixed
+
+- Properly wrap connect errors on the asyncio backend. (Pull #235)
+- Fix `ImportError` occurring on Python 3.9 when using the HTTP/1.1 sync client in a multithreaded context. (Pull #237)
+
+## 0.12.1 (November 7th, 2020)
+
+### Added
+
+- Add connect retries. (Pull #221)
+
+### Fixed
+
+- Tweak detection of dropped connections, resolving an issue with open files limits on Linux. (Pull #185)
+- Avoid leaking connections when establishing an HTTP tunnel to a proxy has failed. (Pull #223)
+- Properly wrap OS errors when using `trio`. (Pull #225)
+
+## 0.12.0 (October 6th, 2020)
+
+### Changed
+
+- HTTP header casing is now preserved, rather than always sent in lowercase. (#216 and python-hyper/h11#104)
+
+### Added
+
+- Add Python 3.9 to officially supported versions.
+
+### Fixed
+
+- Gracefully handle a stdlib asyncio bug when a connection is closed while it is in a paused-for-reading state. (#201)
+
+## 0.11.1 (September 28nd, 2020)
+
+### Fixed
+
+- Add await to async semaphore release() coroutine (#197)
+- Drop incorrect curio classifier (#192)
+
+## 0.11.0 (September 22nd, 2020)
+
+The Transport API with 0.11.0 has a couple of significant changes.
+
+Firstly we've moved changed the request interface in order to allow extensions, which will later enable us to support features
+such as trailing headers, HTTP/2 server push, and CONNECT/Upgrade connections.
+
+The interface changes from:
+
+```python
+def request(method, url, headers, stream, timeout):
+    return (http_version, status_code, reason, headers, stream)
+```
+
+To instead including an optional dictionary of extensions on the request and response:
+
+```python
+def request(method, url, headers, stream, ext):
+    return (status_code, headers, stream, ext)
+```
+
+Having an open-ended extensions point will allow us to add later support for various optional features, that wouldn't otherwise be supported without these API changes.
+
+In particular:
+
+* Trailing headers support.
+* HTTP/2 Server Push
+* sendfile.
+* Exposing raw connection on CONNECT, Upgrade, HTTP/2 bi-di streaming.
+* Exposing debug information out of the API, including template name, template context.
+
+Currently extensions are limited to:
+
+* request: `timeout` - Optional. Timeout dictionary.
+* response: `http_version` - Optional. Include the HTTP version used on the response.
+* response: `reason` - Optional. Include the reason phrase used on the response. Only valid with HTTP/1.*.
+
+See https://github.com/encode/httpx/issues/1274#issuecomment-694884553 for the history behind this.
+
+Secondly, the async version of `request` is now namespaced as `arequest`.
+
+This allows concrete transports to support both sync and async implementations on the same class.
+
+### Added
+
+- Add curio support. (Pull #168)
+- Add anyio support, with `backend="anyio"`. (Pull #169)
+
+### Changed
+
+- Update the Transport API to use 'ext' for optional extensions. (Pull #190)
+- Update the Transport API to use `.request` and `.arequest` so implementations can support both sync and async. (Pull #189)
+
+## 0.10.2 (August 20th, 2020)
+
+### Added
+
+- Added Unix Domain Socket support. (Pull #139)
+
+### Fixed
+
+- Always include the port on proxy CONNECT requests. (Pull #154)
+- Fix `max_keepalive_connections` configuration. (Pull #153)
+- Fixes behaviour in HTTP/1.1 where server disconnects can be used to signal the end of the response body. (Pull #164)
+
+## 0.10.1 (August 7th, 2020)
+
+- Include `max_keepalive_connections` on `AsyncHTTPProxy`/`SyncHTTPProxy` classes.
+
+## 0.10.0 (August 7th, 2020)
+
+The most notable change in the 0.10.0 release is that HTTP/2 support is now fully optional.
+
+Use either `pip install httpcore` for HTTP/1.1 support only, or `pip install httpcore[http2]` for HTTP/1.1 and HTTP/2 support.
+
+### Added
+
+- HTTP/2 support becomes optional. (Pull #121, #130)
+- Add `local_address=...` support. (Pull #100, #134)
+- Add `PlainByteStream`, `IteratorByteStream`, `AsyncIteratorByteStream`. The `AsyncByteSteam` and `SyncByteStream` classes are now pure interface classes. (#133)
+- Add `LocalProtocolError`, `RemoteProtocolError` exceptions. (Pull #129)
+- Add `UnsupportedProtocol` exception. (Pull #128)
+- Add `.get_connection_info()` method. (Pull #102, #137)
+- Add better TRACE logs. (Pull #101)
+
+### Changed
+
+- `max_keepalive` is deprecated in favour of `max_keepalive_connections`. (Pull #140)
+
+### Fixed
+
+- Improve handling of server disconnects. (Pull #112)
+
+## 0.9.1 (May 27th, 2020)
+
+### Fixed
+
+- Proper host resolution for sync case, including IPv6 support. (Pull #97)
+- Close outstanding connections when connection pool is closed. (Pull #98)
+
+## 0.9.0 (May 21th, 2020)
+
+### Changed
+
+- URL port becomes an `Optional[int]` instead of `int`. (Pull #92)
+
+### Fixed
+
+- Honor HTTP/2 max concurrent streams settings. (Pull #89, #90)
+- Remove incorrect debug log. (Pull #83)
+
+## 0.8.4 (May 11th, 2020)
+
+### Added
+
+- Logging via HTTPCORE_LOG_LEVEL and HTTPX_LOG_LEVEL environment variables
+and TRACE level logging. (Pull #79)
+
+### Fixed
+
+- Reuse of connections on HTTP/2 in close concurrency situations. (Pull #81)
+
+## 0.8.3 (May 6rd, 2020)
+
+### Fixed
+
+- Include `Host` and `Accept` headers on proxy "CONNECT" requests.
+- De-duplicate any headers also contained in proxy_headers.
+- HTTP/2 flag not being passed down to proxy connections.
+
+## 0.8.2 (May 3rd, 2020)
+
+### Fixed
+
+- Fix connections using proxy forwarding requests not being added to the
+connection pool properly. (Pull #70)
+
+## 0.8.1 (April 30th, 2020)
+
+### Changed
+
+- Allow inherintance of both `httpcore.AsyncByteStream`, `httpcore.SyncByteStream` without type conflicts.
+
+## 0.8.0 (April 30th, 2020)
+
+### Fixed
+
+- Fixed tunnel proxy support.
+
+### Added
+
+- New `TimeoutException` base class.
+
+## 0.7.0 (March 5th, 2020)
+
+- First integration with HTTPX.
diff --git a/llm/Lib/site-packages/httpcore-1.0.5.dist-info/RECORD b/llm/Lib/site-packages/httpcore-1.0.5.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..ccd64a91dd36f739cda60c3ce631c7d8db0a8534
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore-1.0.5.dist-info/RECORD
@@ -0,0 +1,68 @@
+httpcore-1.0.5.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+httpcore-1.0.5.dist-info/METADATA,sha256=YgW4guGB2OBYCvLOVSIgUoXRbjO-aWDbHXnYIUaJzTU,20969
+httpcore-1.0.5.dist-info/RECORD,,
+httpcore-1.0.5.dist-info/WHEEL,sha256=uNdcs2TADwSd5pVaP0Z_kcjcvvTUklh2S7bxZMF8Uj0,87
+httpcore-1.0.5.dist-info/licenses/LICENSE.md,sha256=_ctZFUx0y6uhahEkL3dAvqnyPW_rVUeRfYxflKgDkqU,1518
+httpcore/__init__.py,sha256=fBzHStfNOukxTWXQFx6W_fv0MAcKntslGJqhHliu45E,3337
+httpcore/__pycache__/__init__.cpython-311.pyc,,
+httpcore/__pycache__/_api.cpython-311.pyc,,
+httpcore/__pycache__/_exceptions.cpython-311.pyc,,
+httpcore/__pycache__/_models.cpython-311.pyc,,
+httpcore/__pycache__/_ssl.cpython-311.pyc,,
+httpcore/__pycache__/_synchronization.cpython-311.pyc,,
+httpcore/__pycache__/_trace.cpython-311.pyc,,
+httpcore/__pycache__/_utils.cpython-311.pyc,,
+httpcore/_api.py,sha256=IBR18qZQ8ETcghJXC1Gd-30WuKYRS0EyF2eC80_OBQ8,3167
+httpcore/_async/__init__.py,sha256=EWdl2v4thnAHzJpqjU4h2a8DUiGAvNiWrkii9pfhTf0,1221
+httpcore/_async/__pycache__/__init__.cpython-311.pyc,,
+httpcore/_async/__pycache__/connection.cpython-311.pyc,,
+httpcore/_async/__pycache__/connection_pool.cpython-311.pyc,,
+httpcore/_async/__pycache__/http11.cpython-311.pyc,,
+httpcore/_async/__pycache__/http2.cpython-311.pyc,,
+httpcore/_async/__pycache__/http_proxy.cpython-311.pyc,,
+httpcore/_async/__pycache__/interfaces.cpython-311.pyc,,
+httpcore/_async/__pycache__/socks_proxy.cpython-311.pyc,,
+httpcore/_async/connection.py,sha256=63vgzLIgX3bjq-RsjK68UWS_DWNkdvnKP0vJRK3Prfs,8484
+httpcore/_async/connection_pool.py,sha256=vjyIrwkj3QfzndhXOBrlyplJidWnhrj0foAmIpSj5tA,15609
+httpcore/_async/http11.py,sha256=yvohHUXwdJv9gN-dEJv4C5F8_NiyOtcflua1Q3BRjew,13978
+httpcore/_async/http2.py,sha256=_AgUDRcjAIlbncbOjW0I-iqYN1PDgRcFUIGfzZ2fKcI,23881
+httpcore/_async/http_proxy.py,sha256=hl4t-PahlAuCGtKNYRx4LSgjx1ZuspE9oDBaL6BOess,14851
+httpcore/_async/interfaces.py,sha256=J2iq9rs7x3nKS6iCfntjHY0Woast6V_HuXuE8rs3HmA,4486
+httpcore/_async/socks_proxy.py,sha256=T8y927RATyy4A9GMduRVUh13ZeRq8Ts8JP24bFVQ6n8,13934
+httpcore/_backends/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+httpcore/_backends/__pycache__/__init__.cpython-311.pyc,,
+httpcore/_backends/__pycache__/anyio.cpython-311.pyc,,
+httpcore/_backends/__pycache__/auto.cpython-311.pyc,,
+httpcore/_backends/__pycache__/base.cpython-311.pyc,,
+httpcore/_backends/__pycache__/mock.cpython-311.pyc,,
+httpcore/_backends/__pycache__/sync.cpython-311.pyc,,
+httpcore/_backends/__pycache__/trio.cpython-311.pyc,,
+httpcore/_backends/anyio.py,sha256=3SbX3SMTwT4SYmoTWbzWazwZg0mfQ3jDR8lI_n9JKr8,5295
+httpcore/_backends/auto.py,sha256=Q_iQjNuwJseqBxeYJYtiaGzFs08_LGI3K_egYrixEqE,1683
+httpcore/_backends/base.py,sha256=Qsb8b_PSiVP1ldHHGXHxQzJ1Qlzj2r8KR9KQeANkSbE,3218
+httpcore/_backends/mock.py,sha256=S4IADhC6kE22ge_jR_WHlEUkD6QAsXnwz26DSWZLcG4,4179
+httpcore/_backends/sync.py,sha256=LAomvc-MAlot5-S9CCFxnr561aDp9yhyfs_65WeCkZ4,8086
+httpcore/_backends/trio.py,sha256=INOeHEkA8pO6AsSqjColWcayM0FQSyGi1hpaQghjrCs,6078
+httpcore/_exceptions.py,sha256=7zb3KNiG0qmfUNIdFgdaUSbn2Pu3oztghi6Vg7i-LJU,1185
+httpcore/_models.py,sha256=7DlYrkyc2z-orQrnztCUmtBY4gLMz18FjPP9e5Q-fFg,16614
+httpcore/_ssl.py,sha256=srqmSNU4iOUvWF-SrJvb8G_YEbHFELOXQOwdDIBTS9c,187
+httpcore/_sync/__init__.py,sha256=JBDIgXt5la1LCJ1sLQeKhjKFpLnpNr8Svs6z2ni3fgg,1141
+httpcore/_sync/__pycache__/__init__.cpython-311.pyc,,
+httpcore/_sync/__pycache__/connection.cpython-311.pyc,,
+httpcore/_sync/__pycache__/connection_pool.cpython-311.pyc,,
+httpcore/_sync/__pycache__/http11.cpython-311.pyc,,
+httpcore/_sync/__pycache__/http2.cpython-311.pyc,,
+httpcore/_sync/__pycache__/http_proxy.cpython-311.pyc,,
+httpcore/_sync/__pycache__/interfaces.cpython-311.pyc,,
+httpcore/_sync/__pycache__/socks_proxy.cpython-311.pyc,,
+httpcore/_sync/connection.py,sha256=n7YFLjYsRv4cf0CXEIqNsUqR_NPNvFQN8dGqjj0mv9U,8273
+httpcore/_sync/connection_pool.py,sha256=lglrm_FWU9J_fwCNFqgcaWCebgZw49V7KhcS0wBZ-Ok,15277
+httpcore/_sync/http11.py,sha256=9-IgEawTTbkHuOE8O3LODhp3KCJ4tAo5vmyA4UE66pU,13564
+httpcore/_sync/http2.py,sha256=_fPbMtCAVqGXKFYo3OmNNkucDuVTF69vMEbSFE2Jodo,23345
+httpcore/_sync/http_proxy.py,sha256=82oin8vjt2a7YmmVvz7sXEZSBuajK-mHDF-EwnR_pJ0,14613
+httpcore/_sync/interfaces.py,sha256=EM4PTf-rgkclzisFcrTyx1G8FwraoffE8rbckOznX_o,4365
+httpcore/_sync/socks_proxy.py,sha256=T13QSceeEAg1PM9Yh7Nk-DoqI28TIUqDS-9O3OSC9Uc,13707
+httpcore/_synchronization.py,sha256=HjyPscK40YPQ-_nTcoBXd3S6IqbHTNuw7lTaqtgA3s4,9464
+httpcore/_trace.py,sha256=akf5PsWVq3rZjqmXniomU59OY37K7JHoeNDCQ4GU84E,3954
+httpcore/_utils.py,sha256=9QPh5ib4JilWX4dBCC_XO6wdBY4b0kbUGgfV3QfBANc,1525
+httpcore/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
diff --git a/llm/Lib/site-packages/httpcore-1.0.5.dist-info/WHEEL b/llm/Lib/site-packages/httpcore-1.0.5.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..0309176f93ce82503b6ac764edadacb3d3127758
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore-1.0.5.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.22.4
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/httpcore-1.0.5.dist-info/licenses/LICENSE.md b/llm/Lib/site-packages/httpcore-1.0.5.dist-info/licenses/LICENSE.md
new file mode 100644
index 0000000000000000000000000000000000000000..311b2b56c53f678ab95fc0def708c675d521a807
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore-1.0.5.dist-info/licenses/LICENSE.md
@@ -0,0 +1,27 @@
+Copyright © 2020, [Encode OSS Ltd](https://www.encode.io/).
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/llm/Lib/site-packages/httpcore/__init__.py b/llm/Lib/site-packages/httpcore/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..014213bae78a1e06430c6a260dcb213c64e2cf0d
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/__init__.py
@@ -0,0 +1,139 @@
+from ._api import request, stream
+from ._async import (
+    AsyncConnectionInterface,
+    AsyncConnectionPool,
+    AsyncHTTP2Connection,
+    AsyncHTTP11Connection,
+    AsyncHTTPConnection,
+    AsyncHTTPProxy,
+    AsyncSOCKSProxy,
+)
+from ._backends.base import (
+    SOCKET_OPTION,
+    AsyncNetworkBackend,
+    AsyncNetworkStream,
+    NetworkBackend,
+    NetworkStream,
+)
+from ._backends.mock import AsyncMockBackend, AsyncMockStream, MockBackend, MockStream
+from ._backends.sync import SyncBackend
+from ._exceptions import (
+    ConnectError,
+    ConnectionNotAvailable,
+    ConnectTimeout,
+    LocalProtocolError,
+    NetworkError,
+    PoolTimeout,
+    ProtocolError,
+    ProxyError,
+    ReadError,
+    ReadTimeout,
+    RemoteProtocolError,
+    TimeoutException,
+    UnsupportedProtocol,
+    WriteError,
+    WriteTimeout,
+)
+from ._models import URL, Origin, Request, Response
+from ._ssl import default_ssl_context
+from ._sync import (
+    ConnectionInterface,
+    ConnectionPool,
+    HTTP2Connection,
+    HTTP11Connection,
+    HTTPConnection,
+    HTTPProxy,
+    SOCKSProxy,
+)
+
+# The 'httpcore.AnyIOBackend' class is conditional on 'anyio' being installed.
+try:
+    from ._backends.anyio import AnyIOBackend
+except ImportError:  # pragma: nocover
+
+    class AnyIOBackend:  # type: ignore
+        def __init__(self, *args, **kwargs):  # type: ignore
+            msg = (
+                "Attempted to use 'httpcore.AnyIOBackend' but 'anyio' is not installed."
+            )
+            raise RuntimeError(msg)
+
+
+# The 'httpcore.TrioBackend' class is conditional on 'trio' being installed.
+try:
+    from ._backends.trio import TrioBackend
+except ImportError:  # pragma: nocover
+
+    class TrioBackend:  # type: ignore
+        def __init__(self, *args, **kwargs):  # type: ignore
+            msg = "Attempted to use 'httpcore.TrioBackend' but 'trio' is not installed."
+            raise RuntimeError(msg)
+
+
+__all__ = [
+    # top-level requests
+    "request",
+    "stream",
+    # models
+    "Origin",
+    "URL",
+    "Request",
+    "Response",
+    # async
+    "AsyncHTTPConnection",
+    "AsyncConnectionPool",
+    "AsyncHTTPProxy",
+    "AsyncHTTP11Connection",
+    "AsyncHTTP2Connection",
+    "AsyncConnectionInterface",
+    "AsyncSOCKSProxy",
+    # sync
+    "HTTPConnection",
+    "ConnectionPool",
+    "HTTPProxy",
+    "HTTP11Connection",
+    "HTTP2Connection",
+    "ConnectionInterface",
+    "SOCKSProxy",
+    # network backends, implementations
+    "SyncBackend",
+    "AnyIOBackend",
+    "TrioBackend",
+    # network backends, mock implementations
+    "AsyncMockBackend",
+    "AsyncMockStream",
+    "MockBackend",
+    "MockStream",
+    # network backends, interface
+    "AsyncNetworkStream",
+    "AsyncNetworkBackend",
+    "NetworkStream",
+    "NetworkBackend",
+    # util
+    "default_ssl_context",
+    "SOCKET_OPTION",
+    # exceptions
+    "ConnectionNotAvailable",
+    "ProxyError",
+    "ProtocolError",
+    "LocalProtocolError",
+    "RemoteProtocolError",
+    "UnsupportedProtocol",
+    "TimeoutException",
+    "PoolTimeout",
+    "ConnectTimeout",
+    "ReadTimeout",
+    "WriteTimeout",
+    "NetworkError",
+    "ConnectError",
+    "ReadError",
+    "WriteError",
+]
+
+__version__ = "1.0.5"
+
+
+__locals = locals()
+for __name in __all__:
+    if not __name.startswith("__"):
+        setattr(__locals[__name], "__module__", "httpcore")  # noqa
diff --git a/llm/Lib/site-packages/httpcore/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/httpcore/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c8a7fc5c662a70acb4c84973f3127d1c6b015868
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/__pycache__/_api.cpython-311.pyc b/llm/Lib/site-packages/httpcore/__pycache__/_api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5b7fcc31093f48afd95cb37b3ff5dda9a3588a74
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/__pycache__/_api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/__pycache__/_exceptions.cpython-311.pyc b/llm/Lib/site-packages/httpcore/__pycache__/_exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3a9d70604968d3318ea2e0ce284ed4911dfee424
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/__pycache__/_exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/__pycache__/_models.cpython-311.pyc b/llm/Lib/site-packages/httpcore/__pycache__/_models.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a394afa48e8b6344560cdcd427405cd595ee3ff6
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/__pycache__/_models.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/__pycache__/_ssl.cpython-311.pyc b/llm/Lib/site-packages/httpcore/__pycache__/_ssl.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..92ecae8d59bd734fdaa26edbbdc67aad714586c7
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/__pycache__/_ssl.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/__pycache__/_synchronization.cpython-311.pyc b/llm/Lib/site-packages/httpcore/__pycache__/_synchronization.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d487560e37069b9c66a6a7a9f5c735b0ebed05bd
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/__pycache__/_synchronization.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/__pycache__/_trace.cpython-311.pyc b/llm/Lib/site-packages/httpcore/__pycache__/_trace.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..13dc798126e403dcff908e48b1e2ef39883f3c2c
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/__pycache__/_trace.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/__pycache__/_utils.cpython-311.pyc b/llm/Lib/site-packages/httpcore/__pycache__/_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d0fdfeae72d8c4aced5b39cca45ff0bc52b5fc8e
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/__pycache__/_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_api.py b/llm/Lib/site-packages/httpcore/_api.py
new file mode 100644
index 0000000000000000000000000000000000000000..854235f5f6035031f0960d4a4b8834081d5df389
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_api.py
@@ -0,0 +1,92 @@
+from contextlib import contextmanager
+from typing import Iterator, Optional, Union
+
+from ._models import URL, Extensions, HeaderTypes, Response
+from ._sync.connection_pool import ConnectionPool
+
+
+def request(
+    method: Union[bytes, str],
+    url: Union[URL, bytes, str],
+    *,
+    headers: HeaderTypes = None,
+    content: Union[bytes, Iterator[bytes], None] = None,
+    extensions: Optional[Extensions] = None,
+) -> Response:
+    """
+    Sends an HTTP request, returning the response.
+
+    ```
+    response = httpcore.request("GET", "https://www.example.com/")
+    ```
+
+    Arguments:
+        method: The HTTP method for the request. Typically one of `"GET"`,
+            `"OPTIONS"`, `"HEAD"`, `"POST"`, `"PUT"`, `"PATCH"`, or `"DELETE"`.
+        url: The URL of the HTTP request. Either as an instance of `httpcore.URL`,
+            or as str/bytes.
+        headers: The HTTP request headers. Either as a dictionary of str/bytes,
+            or as a list of two-tuples of str/bytes.
+        content: The content of the request body. Either as bytes,
+            or as a bytes iterator.
+        extensions: A dictionary of optional extra information included on the request.
+            Possible keys include `"timeout"`.
+
+    Returns:
+        An instance of `httpcore.Response`.
+    """
+    with ConnectionPool() as pool:
+        return pool.request(
+            method=method,
+            url=url,
+            headers=headers,
+            content=content,
+            extensions=extensions,
+        )
+
+
+@contextmanager
+def stream(
+    method: Union[bytes, str],
+    url: Union[URL, bytes, str],
+    *,
+    headers: HeaderTypes = None,
+    content: Union[bytes, Iterator[bytes], None] = None,
+    extensions: Optional[Extensions] = None,
+) -> Iterator[Response]:
+    """
+    Sends an HTTP request, returning the response within a content manager.
+
+    ```
+    with httpcore.stream("GET", "https://www.example.com/") as response:
+        ...
+    ```
+
+    When using the `stream()` function, the body of the response will not be
+    automatically read. If you want to access the response body you should
+    either use `content = response.read()`, or `for chunk in response.iter_content()`.
+
+    Arguments:
+        method: The HTTP method for the request. Typically one of `"GET"`,
+            `"OPTIONS"`, `"HEAD"`, `"POST"`, `"PUT"`, `"PATCH"`, or `"DELETE"`.
+        url: The URL of the HTTP request. Either as an instance of `httpcore.URL`,
+            or as str/bytes.
+        headers: The HTTP request headers. Either as a dictionary of str/bytes,
+            or as a list of two-tuples of str/bytes.
+        content: The content of the request body. Either as bytes,
+            or as a bytes iterator.
+        extensions: A dictionary of optional extra information included on the request.
+            Possible keys include `"timeout"`.
+
+    Returns:
+        An instance of `httpcore.Response`.
+    """
+    with ConnectionPool() as pool:
+        with pool.stream(
+            method=method,
+            url=url,
+            headers=headers,
+            content=content,
+            extensions=extensions,
+        ) as response:
+            yield response
diff --git a/llm/Lib/site-packages/httpcore/_async/__init__.py b/llm/Lib/site-packages/httpcore/_async/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..88dc7f01e132933728cbcf45c88ce82e85ddf65f
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_async/__init__.py
@@ -0,0 +1,39 @@
+from .connection import AsyncHTTPConnection
+from .connection_pool import AsyncConnectionPool
+from .http11 import AsyncHTTP11Connection
+from .http_proxy import AsyncHTTPProxy
+from .interfaces import AsyncConnectionInterface
+
+try:
+    from .http2 import AsyncHTTP2Connection
+except ImportError:  # pragma: nocover
+
+    class AsyncHTTP2Connection:  # type: ignore
+        def __init__(self, *args, **kwargs) -> None:  # type: ignore
+            raise RuntimeError(
+                "Attempted to use http2 support, but the `h2` package is not "
+                "installed. Use 'pip install httpcore[http2]'."
+            )
+
+
+try:
+    from .socks_proxy import AsyncSOCKSProxy
+except ImportError:  # pragma: nocover
+
+    class AsyncSOCKSProxy:  # type: ignore
+        def __init__(self, *args, **kwargs) -> None:  # type: ignore
+            raise RuntimeError(
+                "Attempted to use SOCKS support, but the `socksio` package is not "
+                "installed. Use 'pip install httpcore[socks]'."
+            )
+
+
+__all__ = [
+    "AsyncHTTPConnection",
+    "AsyncConnectionPool",
+    "AsyncHTTPProxy",
+    "AsyncHTTP11Connection",
+    "AsyncHTTP2Connection",
+    "AsyncConnectionInterface",
+    "AsyncSOCKSProxy",
+]
diff --git a/llm/Lib/site-packages/httpcore/_async/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_async/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4d7487341d161da39143ebc0bd69c78580fd0c60
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_async/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_async/__pycache__/connection.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_async/__pycache__/connection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..14734b4077f0c8343e9fbfb611b3a36daec9a09b
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_async/__pycache__/connection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_async/__pycache__/connection_pool.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_async/__pycache__/connection_pool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ba23e3b0034abca31652c4f17318d39daf33be4c
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_async/__pycache__/connection_pool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_async/__pycache__/http11.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_async/__pycache__/http11.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..04546a24d874ce9b87e7a035d34158e6b650b612
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_async/__pycache__/http11.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_async/__pycache__/http2.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_async/__pycache__/http2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..41ea29dbbcb6d31d7452e04be6711ec0b2f6f9fa
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_async/__pycache__/http2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_async/__pycache__/http_proxy.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_async/__pycache__/http_proxy.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..636f2c415bb7b9d7c326bf8bfef842fcb506210c
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_async/__pycache__/http_proxy.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_async/__pycache__/interfaces.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_async/__pycache__/interfaces.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7cdac48c05a72094ddc2e1937edeca350fefdfc9
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_async/__pycache__/interfaces.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_async/__pycache__/socks_proxy.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_async/__pycache__/socks_proxy.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bc577fb7f049c7f9c6d6dd73b388c2226656214a
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_async/__pycache__/socks_proxy.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_async/connection.py b/llm/Lib/site-packages/httpcore/_async/connection.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f439cf09c5c0ec275f2e6b8ed53e41162884e3a
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_async/connection.py
@@ -0,0 +1,220 @@
+import itertools
+import logging
+import ssl
+from types import TracebackType
+from typing import Iterable, Iterator, Optional, Type
+
+from .._backends.auto import AutoBackend
+from .._backends.base import SOCKET_OPTION, AsyncNetworkBackend, AsyncNetworkStream
+from .._exceptions import ConnectError, ConnectTimeout
+from .._models import Origin, Request, Response
+from .._ssl import default_ssl_context
+from .._synchronization import AsyncLock
+from .._trace import Trace
+from .http11 import AsyncHTTP11Connection
+from .interfaces import AsyncConnectionInterface
+
+RETRIES_BACKOFF_FACTOR = 0.5  # 0s, 0.5s, 1s, 2s, 4s, etc.
+
+
+logger = logging.getLogger("httpcore.connection")
+
+
+def exponential_backoff(factor: float) -> Iterator[float]:
+    """
+    Generate a geometric sequence that has a ratio of 2 and starts with 0.
+
+    For example:
+    - `factor = 2`: `0, 2, 4, 8, 16, 32, 64, ...`
+    - `factor = 3`: `0, 3, 6, 12, 24, 48, 96, ...`
+    """
+    yield 0
+    for n in itertools.count():
+        yield factor * 2**n
+
+
+class AsyncHTTPConnection(AsyncConnectionInterface):
+    def __init__(
+        self,
+        origin: Origin,
+        ssl_context: Optional[ssl.SSLContext] = None,
+        keepalive_expiry: Optional[float] = None,
+        http1: bool = True,
+        http2: bool = False,
+        retries: int = 0,
+        local_address: Optional[str] = None,
+        uds: Optional[str] = None,
+        network_backend: Optional[AsyncNetworkBackend] = None,
+        socket_options: Optional[Iterable[SOCKET_OPTION]] = None,
+    ) -> None:
+        self._origin = origin
+        self._ssl_context = ssl_context
+        self._keepalive_expiry = keepalive_expiry
+        self._http1 = http1
+        self._http2 = http2
+        self._retries = retries
+        self._local_address = local_address
+        self._uds = uds
+
+        self._network_backend: AsyncNetworkBackend = (
+            AutoBackend() if network_backend is None else network_backend
+        )
+        self._connection: Optional[AsyncConnectionInterface] = None
+        self._connect_failed: bool = False
+        self._request_lock = AsyncLock()
+        self._socket_options = socket_options
+
+    async def handle_async_request(self, request: Request) -> Response:
+        if not self.can_handle_request(request.url.origin):
+            raise RuntimeError(
+                f"Attempted to send request to {request.url.origin} on connection to {self._origin}"
+            )
+
+        try:
+            async with self._request_lock:
+                if self._connection is None:
+                    stream = await self._connect(request)
+
+                    ssl_object = stream.get_extra_info("ssl_object")
+                    http2_negotiated = (
+                        ssl_object is not None
+                        and ssl_object.selected_alpn_protocol() == "h2"
+                    )
+                    if http2_negotiated or (self._http2 and not self._http1):
+                        from .http2 import AsyncHTTP2Connection
+
+                        self._connection = AsyncHTTP2Connection(
+                            origin=self._origin,
+                            stream=stream,
+                            keepalive_expiry=self._keepalive_expiry,
+                        )
+                    else:
+                        self._connection = AsyncHTTP11Connection(
+                            origin=self._origin,
+                            stream=stream,
+                            keepalive_expiry=self._keepalive_expiry,
+                        )
+        except BaseException as exc:
+            self._connect_failed = True
+            raise exc
+
+        return await self._connection.handle_async_request(request)
+
+    async def _connect(self, request: Request) -> AsyncNetworkStream:
+        timeouts = request.extensions.get("timeout", {})
+        sni_hostname = request.extensions.get("sni_hostname", None)
+        timeout = timeouts.get("connect", None)
+
+        retries_left = self._retries
+        delays = exponential_backoff(factor=RETRIES_BACKOFF_FACTOR)
+
+        while True:
+            try:
+                if self._uds is None:
+                    kwargs = {
+                        "host": self._origin.host.decode("ascii"),
+                        "port": self._origin.port,
+                        "local_address": self._local_address,
+                        "timeout": timeout,
+                        "socket_options": self._socket_options,
+                    }
+                    async with Trace("connect_tcp", logger, request, kwargs) as trace:
+                        stream = await self._network_backend.connect_tcp(**kwargs)
+                        trace.return_value = stream
+                else:
+                    kwargs = {
+                        "path": self._uds,
+                        "timeout": timeout,
+                        "socket_options": self._socket_options,
+                    }
+                    async with Trace(
+                        "connect_unix_socket", logger, request, kwargs
+                    ) as trace:
+                        stream = await self._network_backend.connect_unix_socket(
+                            **kwargs
+                        )
+                        trace.return_value = stream
+
+                if self._origin.scheme in (b"https", b"wss"):
+                    ssl_context = (
+                        default_ssl_context()
+                        if self._ssl_context is None
+                        else self._ssl_context
+                    )
+                    alpn_protocols = ["http/1.1", "h2"] if self._http2 else ["http/1.1"]
+                    ssl_context.set_alpn_protocols(alpn_protocols)
+
+                    kwargs = {
+                        "ssl_context": ssl_context,
+                        "server_hostname": sni_hostname
+                        or self._origin.host.decode("ascii"),
+                        "timeout": timeout,
+                    }
+                    async with Trace("start_tls", logger, request, kwargs) as trace:
+                        stream = await stream.start_tls(**kwargs)
+                        trace.return_value = stream
+                return stream
+            except (ConnectError, ConnectTimeout):
+                if retries_left <= 0:
+                    raise
+                retries_left -= 1
+                delay = next(delays)
+                async with Trace("retry", logger, request, kwargs) as trace:
+                    await self._network_backend.sleep(delay)
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        return origin == self._origin
+
+    async def aclose(self) -> None:
+        if self._connection is not None:
+            async with Trace("close", logger, None, {}):
+                await self._connection.aclose()
+
+    def is_available(self) -> bool:
+        if self._connection is None:
+            # If HTTP/2 support is enabled, and the resulting connection could
+            # end up as HTTP/2 then we should indicate the connection as being
+            # available to service multiple requests.
+            return (
+                self._http2
+                and (self._origin.scheme == b"https" or not self._http1)
+                and not self._connect_failed
+            )
+        return self._connection.is_available()
+
+    def has_expired(self) -> bool:
+        if self._connection is None:
+            return self._connect_failed
+        return self._connection.has_expired()
+
+    def is_idle(self) -> bool:
+        if self._connection is None:
+            return self._connect_failed
+        return self._connection.is_idle()
+
+    def is_closed(self) -> bool:
+        if self._connection is None:
+            return self._connect_failed
+        return self._connection.is_closed()
+
+    def info(self) -> str:
+        if self._connection is None:
+            return "CONNECTION FAILED" if self._connect_failed else "CONNECTING"
+        return self._connection.info()
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} [{self.info()}]>"
+
+    # These context managers are not used in the standard flow, but are
+    # useful for testing or working with connection instances directly.
+
+    async def __aenter__(self) -> "AsyncHTTPConnection":
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        await self.aclose()
diff --git a/llm/Lib/site-packages/httpcore/_async/connection_pool.py b/llm/Lib/site-packages/httpcore/_async/connection_pool.py
new file mode 100644
index 0000000000000000000000000000000000000000..018b0ba234f52b00a60f6e97481e5b72fc10ddd4
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_async/connection_pool.py
@@ -0,0 +1,380 @@
+import ssl
+import sys
+from types import TracebackType
+from typing import AsyncIterable, AsyncIterator, Iterable, List, Optional, Type
+
+from .._backends.auto import AutoBackend
+from .._backends.base import SOCKET_OPTION, AsyncNetworkBackend
+from .._exceptions import ConnectionNotAvailable, UnsupportedProtocol
+from .._models import Origin, Request, Response
+from .._synchronization import AsyncEvent, AsyncShieldCancellation, AsyncThreadLock
+from .connection import AsyncHTTPConnection
+from .interfaces import AsyncConnectionInterface, AsyncRequestInterface
+
+
+class AsyncPoolRequest:
+    def __init__(self, request: Request) -> None:
+        self.request = request
+        self.connection: Optional[AsyncConnectionInterface] = None
+        self._connection_acquired = AsyncEvent()
+
+    def assign_to_connection(
+        self, connection: Optional[AsyncConnectionInterface]
+    ) -> None:
+        self.connection = connection
+        self._connection_acquired.set()
+
+    def clear_connection(self) -> None:
+        self.connection = None
+        self._connection_acquired = AsyncEvent()
+
+    async def wait_for_connection(
+        self, timeout: Optional[float] = None
+    ) -> AsyncConnectionInterface:
+        if self.connection is None:
+            await self._connection_acquired.wait(timeout=timeout)
+        assert self.connection is not None
+        return self.connection
+
+    def is_queued(self) -> bool:
+        return self.connection is None
+
+
+class AsyncConnectionPool(AsyncRequestInterface):
+    """
+    A connection pool for making HTTP requests.
+    """
+
+    def __init__(
+        self,
+        ssl_context: Optional[ssl.SSLContext] = None,
+        max_connections: Optional[int] = 10,
+        max_keepalive_connections: Optional[int] = None,
+        keepalive_expiry: Optional[float] = None,
+        http1: bool = True,
+        http2: bool = False,
+        retries: int = 0,
+        local_address: Optional[str] = None,
+        uds: Optional[str] = None,
+        network_backend: Optional[AsyncNetworkBackend] = None,
+        socket_options: Optional[Iterable[SOCKET_OPTION]] = None,
+    ) -> None:
+        """
+        A connection pool for making HTTP requests.
+
+        Parameters:
+            ssl_context: An SSL context to use for verifying connections.
+                If not specified, the default `httpcore.default_ssl_context()`
+                will be used.
+            max_connections: The maximum number of concurrent HTTP connections that
+                the pool should allow. Any attempt to send a request on a pool that
+                would exceed this amount will block until a connection is available.
+            max_keepalive_connections: The maximum number of idle HTTP connections
+                that will be maintained in the pool.
+            keepalive_expiry: The duration in seconds that an idle HTTP connection
+                may be maintained for before being expired from the pool.
+            http1: A boolean indicating if HTTP/1.1 requests should be supported
+                by the connection pool. Defaults to True.
+            http2: A boolean indicating if HTTP/2 requests should be supported by
+                the connection pool. Defaults to False.
+            retries: The maximum number of retries when trying to establish a
+                connection.
+            local_address: Local address to connect from. Can also be used to connect
+                using a particular address family. Using `local_address="0.0.0.0"`
+                will connect using an `AF_INET` address (IPv4), while using
+                `local_address="::"` will connect using an `AF_INET6` address (IPv6).
+            uds: Path to a Unix Domain Socket to use instead of TCP sockets.
+            network_backend: A backend instance to use for handling network I/O.
+            socket_options: Socket options that have to be included
+             in the TCP socket when the connection was established.
+        """
+        self._ssl_context = ssl_context
+
+        self._max_connections = (
+            sys.maxsize if max_connections is None else max_connections
+        )
+        self._max_keepalive_connections = (
+            sys.maxsize
+            if max_keepalive_connections is None
+            else max_keepalive_connections
+        )
+        self._max_keepalive_connections = min(
+            self._max_connections, self._max_keepalive_connections
+        )
+
+        self._keepalive_expiry = keepalive_expiry
+        self._http1 = http1
+        self._http2 = http2
+        self._retries = retries
+        self._local_address = local_address
+        self._uds = uds
+
+        self._network_backend = (
+            AutoBackend() if network_backend is None else network_backend
+        )
+        self._socket_options = socket_options
+
+        # The mutable state on a connection pool is the queue of incoming requests,
+        # and the set of connections that are servicing those requests.
+        self._connections: List[AsyncConnectionInterface] = []
+        self._requests: List[AsyncPoolRequest] = []
+
+        # We only mutate the state of the connection pool within an 'optional_thread_lock'
+        # context. This holds a threading lock unless we're running in async mode,
+        # in which case it is a no-op.
+        self._optional_thread_lock = AsyncThreadLock()
+
+    def create_connection(self, origin: Origin) -> AsyncConnectionInterface:
+        return AsyncHTTPConnection(
+            origin=origin,
+            ssl_context=self._ssl_context,
+            keepalive_expiry=self._keepalive_expiry,
+            http1=self._http1,
+            http2=self._http2,
+            retries=self._retries,
+            local_address=self._local_address,
+            uds=self._uds,
+            network_backend=self._network_backend,
+            socket_options=self._socket_options,
+        )
+
+    @property
+    def connections(self) -> List[AsyncConnectionInterface]:
+        """
+        Return a list of the connections currently in the pool.
+
+        For example:
+
+        ```python
+        >>> pool.connections
+        [
+            <AsyncHTTPConnection ['https://example.com:443', HTTP/1.1, ACTIVE, Request Count: 6]>,
+            <AsyncHTTPConnection ['https://example.com:443', HTTP/1.1, IDLE, Request Count: 9]> ,
+            <AsyncHTTPConnection ['http://example.com:80', HTTP/1.1, IDLE, Request Count: 1]>,
+        ]
+        ```
+        """
+        return list(self._connections)
+
+    async def handle_async_request(self, request: Request) -> Response:
+        """
+        Send an HTTP request, and return an HTTP response.
+
+        This is the core implementation that is called into by `.request()` or `.stream()`.
+        """
+        scheme = request.url.scheme.decode()
+        if scheme == "":
+            raise UnsupportedProtocol(
+                "Request URL is missing an 'http://' or 'https://' protocol."
+            )
+        if scheme not in ("http", "https", "ws", "wss"):
+            raise UnsupportedProtocol(
+                f"Request URL has an unsupported protocol '{scheme}://'."
+            )
+
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("pool", None)
+
+        with self._optional_thread_lock:
+            # Add the incoming request to our request queue.
+            pool_request = AsyncPoolRequest(request)
+            self._requests.append(pool_request)
+
+        try:
+            while True:
+                with self._optional_thread_lock:
+                    # Assign incoming requests to available connections,
+                    # closing or creating new connections as required.
+                    closing = self._assign_requests_to_connections()
+                await self._close_connections(closing)
+
+                # Wait until this request has an assigned connection.
+                connection = await pool_request.wait_for_connection(timeout=timeout)
+
+                try:
+                    # Send the request on the assigned connection.
+                    response = await connection.handle_async_request(
+                        pool_request.request
+                    )
+                except ConnectionNotAvailable:
+                    # In some cases a connection may initially be available to
+                    # handle a request, but then become unavailable.
+                    #
+                    # In this case we clear the connection and try again.
+                    pool_request.clear_connection()
+                else:
+                    break  # pragma: nocover
+
+        except BaseException as exc:
+            with self._optional_thread_lock:
+                # For any exception or cancellation we remove the request from
+                # the queue, and then re-assign requests to connections.
+                self._requests.remove(pool_request)
+                closing = self._assign_requests_to_connections()
+
+            await self._close_connections(closing)
+            raise exc from None
+
+        # Return the response. Note that in this case we still have to manage
+        # the point at which the response is closed.
+        assert isinstance(response.stream, AsyncIterable)
+        return Response(
+            status=response.status,
+            headers=response.headers,
+            content=PoolByteStream(
+                stream=response.stream, pool_request=pool_request, pool=self
+            ),
+            extensions=response.extensions,
+        )
+
+    def _assign_requests_to_connections(self) -> List[AsyncConnectionInterface]:
+        """
+        Manage the state of the connection pool, assigning incoming
+        requests to connections as available.
+
+        Called whenever a new request is added or removed from the pool.
+
+        Any closing connections are returned, allowing the I/O for closing
+        those connections to be handled seperately.
+        """
+        closing_connections = []
+
+        # First we handle cleaning up any connections that are closed,
+        # have expired their keep-alive, or surplus idle connections.
+        for connection in list(self._connections):
+            if connection.is_closed():
+                # log: "removing closed connection"
+                self._connections.remove(connection)
+            elif connection.has_expired():
+                # log: "closing expired connection"
+                self._connections.remove(connection)
+                closing_connections.append(connection)
+            elif (
+                connection.is_idle()
+                and len([connection.is_idle() for connection in self._connections])
+                > self._max_keepalive_connections
+            ):
+                # log: "closing idle connection"
+                self._connections.remove(connection)
+                closing_connections.append(connection)
+
+        # Assign queued requests to connections.
+        queued_requests = [request for request in self._requests if request.is_queued()]
+        for pool_request in queued_requests:
+            origin = pool_request.request.url.origin
+            avilable_connections = [
+                connection
+                for connection in self._connections
+                if connection.can_handle_request(origin) and connection.is_available()
+            ]
+            idle_connections = [
+                connection for connection in self._connections if connection.is_idle()
+            ]
+
+            # There are three cases for how we may be able to handle the request:
+            #
+            # 1. There is an existing connection that can handle the request.
+            # 2. We can create a new connection to handle the request.
+            # 3. We can close an idle connection and then create a new connection
+            #    to handle the request.
+            if avilable_connections:
+                # log: "reusing existing connection"
+                connection = avilable_connections[0]
+                pool_request.assign_to_connection(connection)
+            elif len(self._connections) < self._max_connections:
+                # log: "creating new connection"
+                connection = self.create_connection(origin)
+                self._connections.append(connection)
+                pool_request.assign_to_connection(connection)
+            elif idle_connections:
+                # log: "closing idle connection"
+                connection = idle_connections[0]
+                self._connections.remove(connection)
+                closing_connections.append(connection)
+                # log: "creating new connection"
+                connection = self.create_connection(origin)
+                self._connections.append(connection)
+                pool_request.assign_to_connection(connection)
+
+        return closing_connections
+
+    async def _close_connections(self, closing: List[AsyncConnectionInterface]) -> None:
+        # Close connections which have been removed from the pool.
+        with AsyncShieldCancellation():
+            for connection in closing:
+                await connection.aclose()
+
+    async def aclose(self) -> None:
+        # Explicitly close the connection pool.
+        # Clears all existing requests and connections.
+        with self._optional_thread_lock:
+            closing_connections = list(self._connections)
+            self._connections = []
+        await self._close_connections(closing_connections)
+
+    async def __aenter__(self) -> "AsyncConnectionPool":
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        await self.aclose()
+
+    def __repr__(self) -> str:
+        class_name = self.__class__.__name__
+        with self._optional_thread_lock:
+            request_is_queued = [request.is_queued() for request in self._requests]
+            connection_is_idle = [
+                connection.is_idle() for connection in self._connections
+            ]
+
+            num_active_requests = request_is_queued.count(False)
+            num_queued_requests = request_is_queued.count(True)
+            num_active_connections = connection_is_idle.count(False)
+            num_idle_connections = connection_is_idle.count(True)
+
+        requests_info = (
+            f"Requests: {num_active_requests} active, {num_queued_requests} queued"
+        )
+        connection_info = (
+            f"Connections: {num_active_connections} active, {num_idle_connections} idle"
+        )
+
+        return f"<{class_name} [{requests_info} | {connection_info}]>"
+
+
+class PoolByteStream:
+    def __init__(
+        self,
+        stream: AsyncIterable[bytes],
+        pool_request: AsyncPoolRequest,
+        pool: AsyncConnectionPool,
+    ) -> None:
+        self._stream = stream
+        self._pool_request = pool_request
+        self._pool = pool
+        self._closed = False
+
+    async def __aiter__(self) -> AsyncIterator[bytes]:
+        try:
+            async for part in self._stream:
+                yield part
+        except BaseException as exc:
+            await self.aclose()
+            raise exc from None
+
+    async def aclose(self) -> None:
+        if not self._closed:
+            self._closed = True
+            with AsyncShieldCancellation():
+                if hasattr(self._stream, "aclose"):
+                    await self._stream.aclose()
+
+            with self._pool._optional_thread_lock:
+                self._pool._requests.remove(self._pool_request)
+                closing = self._pool._assign_requests_to_connections()
+
+            await self._pool._close_connections(closing)
diff --git a/llm/Lib/site-packages/httpcore/_async/http11.py b/llm/Lib/site-packages/httpcore/_async/http11.py
new file mode 100644
index 0000000000000000000000000000000000000000..0493a923dc19a1a740a3c1a6f8fb3fbfb429d6f5
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_async/http11.py
@@ -0,0 +1,386 @@
+import enum
+import logging
+import ssl
+import time
+from types import TracebackType
+from typing import (
+    Any,
+    AsyncIterable,
+    AsyncIterator,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+import h11
+
+from .._backends.base import AsyncNetworkStream
+from .._exceptions import (
+    ConnectionNotAvailable,
+    LocalProtocolError,
+    RemoteProtocolError,
+    WriteError,
+    map_exceptions,
+)
+from .._models import Origin, Request, Response
+from .._synchronization import AsyncLock, AsyncShieldCancellation
+from .._trace import Trace
+from .interfaces import AsyncConnectionInterface
+
+logger = logging.getLogger("httpcore.http11")
+
+
+# A subset of `h11.Event` types supported by `_send_event`
+H11SendEvent = Union[
+    h11.Request,
+    h11.Data,
+    h11.EndOfMessage,
+]
+
+
+class HTTPConnectionState(enum.IntEnum):
+    NEW = 0
+    ACTIVE = 1
+    IDLE = 2
+    CLOSED = 3
+
+
+class AsyncHTTP11Connection(AsyncConnectionInterface):
+    READ_NUM_BYTES = 64 * 1024
+    MAX_INCOMPLETE_EVENT_SIZE = 100 * 1024
+
+    def __init__(
+        self,
+        origin: Origin,
+        stream: AsyncNetworkStream,
+        keepalive_expiry: Optional[float] = None,
+    ) -> None:
+        self._origin = origin
+        self._network_stream = stream
+        self._keepalive_expiry: Optional[float] = keepalive_expiry
+        self._expire_at: Optional[float] = None
+        self._state = HTTPConnectionState.NEW
+        self._state_lock = AsyncLock()
+        self._request_count = 0
+        self._h11_state = h11.Connection(
+            our_role=h11.CLIENT,
+            max_incomplete_event_size=self.MAX_INCOMPLETE_EVENT_SIZE,
+        )
+
+    async def handle_async_request(self, request: Request) -> Response:
+        if not self.can_handle_request(request.url.origin):
+            raise RuntimeError(
+                f"Attempted to send request to {request.url.origin} on connection "
+                f"to {self._origin}"
+            )
+
+        async with self._state_lock:
+            if self._state in (HTTPConnectionState.NEW, HTTPConnectionState.IDLE):
+                self._request_count += 1
+                self._state = HTTPConnectionState.ACTIVE
+                self._expire_at = None
+            else:
+                raise ConnectionNotAvailable()
+
+        try:
+            kwargs = {"request": request}
+            try:
+                async with Trace(
+                    "send_request_headers", logger, request, kwargs
+                ) as trace:
+                    await self._send_request_headers(**kwargs)
+                async with Trace("send_request_body", logger, request, kwargs) as trace:
+                    await self._send_request_body(**kwargs)
+            except WriteError:
+                # If we get a write error while we're writing the request,
+                # then we supress this error and move on to attempting to
+                # read the response. Servers can sometimes close the request
+                # pre-emptively and then respond with a well formed HTTP
+                # error response.
+                pass
+
+            async with Trace(
+                "receive_response_headers", logger, request, kwargs
+            ) as trace:
+                (
+                    http_version,
+                    status,
+                    reason_phrase,
+                    headers,
+                    trailing_data,
+                ) = await self._receive_response_headers(**kwargs)
+                trace.return_value = (
+                    http_version,
+                    status,
+                    reason_phrase,
+                    headers,
+                )
+
+            network_stream = self._network_stream
+
+            # CONNECT or Upgrade request
+            if (status == 101) or (
+                (request.method == b"CONNECT") and (200 <= status < 300)
+            ):
+                network_stream = AsyncHTTP11UpgradeStream(network_stream, trailing_data)
+
+            return Response(
+                status=status,
+                headers=headers,
+                content=HTTP11ConnectionByteStream(self, request),
+                extensions={
+                    "http_version": http_version,
+                    "reason_phrase": reason_phrase,
+                    "network_stream": network_stream,
+                },
+            )
+        except BaseException as exc:
+            with AsyncShieldCancellation():
+                async with Trace("response_closed", logger, request) as trace:
+                    await self._response_closed()
+            raise exc
+
+    # Sending the request...
+
+    async def _send_request_headers(self, request: Request) -> None:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("write", None)
+
+        with map_exceptions({h11.LocalProtocolError: LocalProtocolError}):
+            event = h11.Request(
+                method=request.method,
+                target=request.url.target,
+                headers=request.headers,
+            )
+        await self._send_event(event, timeout=timeout)
+
+    async def _send_request_body(self, request: Request) -> None:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("write", None)
+
+        assert isinstance(request.stream, AsyncIterable)
+        async for chunk in request.stream:
+            event = h11.Data(data=chunk)
+            await self._send_event(event, timeout=timeout)
+
+        await self._send_event(h11.EndOfMessage(), timeout=timeout)
+
+    async def _send_event(
+        self, event: h11.Event, timeout: Optional[float] = None
+    ) -> None:
+        bytes_to_send = self._h11_state.send(event)
+        if bytes_to_send is not None:
+            await self._network_stream.write(bytes_to_send, timeout=timeout)
+
+    # Receiving the response...
+
+    async def _receive_response_headers(
+        self, request: Request
+    ) -> Tuple[bytes, int, bytes, List[Tuple[bytes, bytes]], bytes]:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("read", None)
+
+        while True:
+            event = await self._receive_event(timeout=timeout)
+            if isinstance(event, h11.Response):
+                break
+            if (
+                isinstance(event, h11.InformationalResponse)
+                and event.status_code == 101
+            ):
+                break
+
+        http_version = b"HTTP/" + event.http_version
+
+        # h11 version 0.11+ supports a `raw_items` interface to get the
+        # raw header casing, rather than the enforced lowercase headers.
+        headers = event.headers.raw_items()
+
+        trailing_data, _ = self._h11_state.trailing_data
+
+        return http_version, event.status_code, event.reason, headers, trailing_data
+
+    async def _receive_response_body(self, request: Request) -> AsyncIterator[bytes]:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("read", None)
+
+        while True:
+            event = await self._receive_event(timeout=timeout)
+            if isinstance(event, h11.Data):
+                yield bytes(event.data)
+            elif isinstance(event, (h11.EndOfMessage, h11.PAUSED)):
+                break
+
+    async def _receive_event(
+        self, timeout: Optional[float] = None
+    ) -> Union[h11.Event, Type[h11.PAUSED]]:
+        while True:
+            with map_exceptions({h11.RemoteProtocolError: RemoteProtocolError}):
+                event = self._h11_state.next_event()
+
+            if event is h11.NEED_DATA:
+                data = await self._network_stream.read(
+                    self.READ_NUM_BYTES, timeout=timeout
+                )
+
+                # If we feed this case through h11 we'll raise an exception like:
+                #
+                #     httpcore.RemoteProtocolError: can't handle event type
+                #     ConnectionClosed when role=SERVER and state=SEND_RESPONSE
+                #
+                # Which is accurate, but not very informative from an end-user
+                # perspective. Instead we handle this case distinctly and treat
+                # it as a ConnectError.
+                if data == b"" and self._h11_state.their_state == h11.SEND_RESPONSE:
+                    msg = "Server disconnected without sending a response."
+                    raise RemoteProtocolError(msg)
+
+                self._h11_state.receive_data(data)
+            else:
+                # mypy fails to narrow the type in the above if statement above
+                return event  # type: ignore[return-value]
+
+    async def _response_closed(self) -> None:
+        async with self._state_lock:
+            if (
+                self._h11_state.our_state is h11.DONE
+                and self._h11_state.their_state is h11.DONE
+            ):
+                self._state = HTTPConnectionState.IDLE
+                self._h11_state.start_next_cycle()
+                if self._keepalive_expiry is not None:
+                    now = time.monotonic()
+                    self._expire_at = now + self._keepalive_expiry
+            else:
+                await self.aclose()
+
+    # Once the connection is no longer required...
+
+    async def aclose(self) -> None:
+        # Note that this method unilaterally closes the connection, and does
+        # not have any kind of locking in place around it.
+        self._state = HTTPConnectionState.CLOSED
+        await self._network_stream.aclose()
+
+    # The AsyncConnectionInterface methods provide information about the state of
+    # the connection, allowing for a connection pooling implementation to
+    # determine when to reuse and when to close the connection...
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        return origin == self._origin
+
+    def is_available(self) -> bool:
+        # Note that HTTP/1.1 connections in the "NEW" state are not treated as
+        # being "available". The control flow which created the connection will
+        # be able to send an outgoing request, but the connection will not be
+        # acquired from the connection pool for any other request.
+        return self._state == HTTPConnectionState.IDLE
+
+    def has_expired(self) -> bool:
+        now = time.monotonic()
+        keepalive_expired = self._expire_at is not None and now > self._expire_at
+
+        # If the HTTP connection is idle but the socket is readable, then the
+        # only valid state is that the socket is about to return b"", indicating
+        # a server-initiated disconnect.
+        server_disconnected = (
+            self._state == HTTPConnectionState.IDLE
+            and self._network_stream.get_extra_info("is_readable")
+        )
+
+        return keepalive_expired or server_disconnected
+
+    def is_idle(self) -> bool:
+        return self._state == HTTPConnectionState.IDLE
+
+    def is_closed(self) -> bool:
+        return self._state == HTTPConnectionState.CLOSED
+
+    def info(self) -> str:
+        origin = str(self._origin)
+        return (
+            f"{origin!r}, HTTP/1.1, {self._state.name}, "
+            f"Request Count: {self._request_count}"
+        )
+
+    def __repr__(self) -> str:
+        class_name = self.__class__.__name__
+        origin = str(self._origin)
+        return (
+            f"<{class_name} [{origin!r}, {self._state.name}, "
+            f"Request Count: {self._request_count}]>"
+        )
+
+    # These context managers are not used in the standard flow, but are
+    # useful for testing or working with connection instances directly.
+
+    async def __aenter__(self) -> "AsyncHTTP11Connection":
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        await self.aclose()
+
+
+class HTTP11ConnectionByteStream:
+    def __init__(self, connection: AsyncHTTP11Connection, request: Request) -> None:
+        self._connection = connection
+        self._request = request
+        self._closed = False
+
+    async def __aiter__(self) -> AsyncIterator[bytes]:
+        kwargs = {"request": self._request}
+        try:
+            async with Trace("receive_response_body", logger, self._request, kwargs):
+                async for chunk in self._connection._receive_response_body(**kwargs):
+                    yield chunk
+        except BaseException as exc:
+            # If we get an exception while streaming the response,
+            # we want to close the response (and possibly the connection)
+            # before raising that exception.
+            with AsyncShieldCancellation():
+                await self.aclose()
+            raise exc
+
+    async def aclose(self) -> None:
+        if not self._closed:
+            self._closed = True
+            async with Trace("response_closed", logger, self._request):
+                await self._connection._response_closed()
+
+
+class AsyncHTTP11UpgradeStream(AsyncNetworkStream):
+    def __init__(self, stream: AsyncNetworkStream, leading_data: bytes) -> None:
+        self._stream = stream
+        self._leading_data = leading_data
+
+    async def read(self, max_bytes: int, timeout: Optional[float] = None) -> bytes:
+        if self._leading_data:
+            buffer = self._leading_data[:max_bytes]
+            self._leading_data = self._leading_data[max_bytes:]
+            return buffer
+        else:
+            return await self._stream.read(max_bytes, timeout)
+
+    async def write(self, buffer: bytes, timeout: Optional[float] = None) -> None:
+        await self._stream.write(buffer, timeout)
+
+    async def aclose(self) -> None:
+        await self._stream.aclose()
+
+    async def start_tls(
+        self,
+        ssl_context: ssl.SSLContext,
+        server_hostname: Optional[str] = None,
+        timeout: Optional[float] = None,
+    ) -> AsyncNetworkStream:
+        return await self._stream.start_tls(ssl_context, server_hostname, timeout)
+
+    def get_extra_info(self, info: str) -> Any:
+        return self._stream.get_extra_info(info)
diff --git a/llm/Lib/site-packages/httpcore/_async/http2.py b/llm/Lib/site-packages/httpcore/_async/http2.py
new file mode 100644
index 0000000000000000000000000000000000000000..c201ee4cbcfb81586678c071246b3ca8dc4aaf37
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_async/http2.py
@@ -0,0 +1,589 @@
+import enum
+import logging
+import time
+import types
+import typing
+
+import h2.config
+import h2.connection
+import h2.events
+import h2.exceptions
+import h2.settings
+
+from .._backends.base import AsyncNetworkStream
+from .._exceptions import (
+    ConnectionNotAvailable,
+    LocalProtocolError,
+    RemoteProtocolError,
+)
+from .._models import Origin, Request, Response
+from .._synchronization import AsyncLock, AsyncSemaphore, AsyncShieldCancellation
+from .._trace import Trace
+from .interfaces import AsyncConnectionInterface
+
+logger = logging.getLogger("httpcore.http2")
+
+
+def has_body_headers(request: Request) -> bool:
+    return any(
+        k.lower() == b"content-length" or k.lower() == b"transfer-encoding"
+        for k, v in request.headers
+    )
+
+
+class HTTPConnectionState(enum.IntEnum):
+    ACTIVE = 1
+    IDLE = 2
+    CLOSED = 3
+
+
+class AsyncHTTP2Connection(AsyncConnectionInterface):
+    READ_NUM_BYTES = 64 * 1024
+    CONFIG = h2.config.H2Configuration(validate_inbound_headers=False)
+
+    def __init__(
+        self,
+        origin: Origin,
+        stream: AsyncNetworkStream,
+        keepalive_expiry: typing.Optional[float] = None,
+    ):
+        self._origin = origin
+        self._network_stream = stream
+        self._keepalive_expiry: typing.Optional[float] = keepalive_expiry
+        self._h2_state = h2.connection.H2Connection(config=self.CONFIG)
+        self._state = HTTPConnectionState.IDLE
+        self._expire_at: typing.Optional[float] = None
+        self._request_count = 0
+        self._init_lock = AsyncLock()
+        self._state_lock = AsyncLock()
+        self._read_lock = AsyncLock()
+        self._write_lock = AsyncLock()
+        self._sent_connection_init = False
+        self._used_all_stream_ids = False
+        self._connection_error = False
+
+        # Mapping from stream ID to response stream events.
+        self._events: typing.Dict[
+            int,
+            typing.Union[
+                h2.events.ResponseReceived,
+                h2.events.DataReceived,
+                h2.events.StreamEnded,
+                h2.events.StreamReset,
+            ],
+        ] = {}
+
+        # Connection terminated events are stored as state since
+        # we need to handle them for all streams.
+        self._connection_terminated: typing.Optional[h2.events.ConnectionTerminated] = (
+            None
+        )
+
+        self._read_exception: typing.Optional[Exception] = None
+        self._write_exception: typing.Optional[Exception] = None
+
+    async def handle_async_request(self, request: Request) -> Response:
+        if not self.can_handle_request(request.url.origin):
+            # This cannot occur in normal operation, since the connection pool
+            # will only send requests on connections that handle them.
+            # It's in place simply for resilience as a guard against incorrect
+            # usage, for anyone working directly with httpcore connections.
+            raise RuntimeError(
+                f"Attempted to send request to {request.url.origin} on connection "
+                f"to {self._origin}"
+            )
+
+        async with self._state_lock:
+            if self._state in (HTTPConnectionState.ACTIVE, HTTPConnectionState.IDLE):
+                self._request_count += 1
+                self._expire_at = None
+                self._state = HTTPConnectionState.ACTIVE
+            else:
+                raise ConnectionNotAvailable()
+
+        async with self._init_lock:
+            if not self._sent_connection_init:
+                try:
+                    kwargs = {"request": request}
+                    async with Trace("send_connection_init", logger, request, kwargs):
+                        await self._send_connection_init(**kwargs)
+                except BaseException as exc:
+                    with AsyncShieldCancellation():
+                        await self.aclose()
+                    raise exc
+
+                self._sent_connection_init = True
+
+                # Initially start with just 1 until the remote server provides
+                # its max_concurrent_streams value
+                self._max_streams = 1
+
+                local_settings_max_streams = (
+                    self._h2_state.local_settings.max_concurrent_streams
+                )
+                self._max_streams_semaphore = AsyncSemaphore(local_settings_max_streams)
+
+                for _ in range(local_settings_max_streams - self._max_streams):
+                    await self._max_streams_semaphore.acquire()
+
+        await self._max_streams_semaphore.acquire()
+
+        try:
+            stream_id = self._h2_state.get_next_available_stream_id()
+            self._events[stream_id] = []
+        except h2.exceptions.NoAvailableStreamIDError:  # pragma: nocover
+            self._used_all_stream_ids = True
+            self._request_count -= 1
+            raise ConnectionNotAvailable()
+
+        try:
+            kwargs = {"request": request, "stream_id": stream_id}
+            async with Trace("send_request_headers", logger, request, kwargs):
+                await self._send_request_headers(request=request, stream_id=stream_id)
+            async with Trace("send_request_body", logger, request, kwargs):
+                await self._send_request_body(request=request, stream_id=stream_id)
+            async with Trace(
+                "receive_response_headers", logger, request, kwargs
+            ) as trace:
+                status, headers = await self._receive_response(
+                    request=request, stream_id=stream_id
+                )
+                trace.return_value = (status, headers)
+
+            return Response(
+                status=status,
+                headers=headers,
+                content=HTTP2ConnectionByteStream(self, request, stream_id=stream_id),
+                extensions={
+                    "http_version": b"HTTP/2",
+                    "network_stream": self._network_stream,
+                    "stream_id": stream_id,
+                },
+            )
+        except BaseException as exc:  # noqa: PIE786
+            with AsyncShieldCancellation():
+                kwargs = {"stream_id": stream_id}
+                async with Trace("response_closed", logger, request, kwargs):
+                    await self._response_closed(stream_id=stream_id)
+
+            if isinstance(exc, h2.exceptions.ProtocolError):
+                # One case where h2 can raise a protocol error is when a
+                # closed frame has been seen by the state machine.
+                #
+                # This happens when one stream is reading, and encounters
+                # a GOAWAY event. Other flows of control may then raise
+                # a protocol error at any point they interact with the 'h2_state'.
+                #
+                # In this case we'll have stored the event, and should raise
+                # it as a RemoteProtocolError.
+                if self._connection_terminated:  # pragma: nocover
+                    raise RemoteProtocolError(self._connection_terminated)
+                # If h2 raises a protocol error in some other state then we
+                # must somehow have made a protocol violation.
+                raise LocalProtocolError(exc)  # pragma: nocover
+
+            raise exc
+
+    async def _send_connection_init(self, request: Request) -> None:
+        """
+        The HTTP/2 connection requires some initial setup before we can start
+        using individual request/response streams on it.
+        """
+        # Need to set these manually here instead of manipulating via
+        # __setitem__() otherwise the H2Connection will emit SettingsUpdate
+        # frames in addition to sending the undesired defaults.
+        self._h2_state.local_settings = h2.settings.Settings(
+            client=True,
+            initial_values={
+                # Disable PUSH_PROMISE frames from the server since we don't do anything
+                # with them for now.  Maybe when we support caching?
+                h2.settings.SettingCodes.ENABLE_PUSH: 0,
+                # These two are taken from h2 for safe defaults
+                h2.settings.SettingCodes.MAX_CONCURRENT_STREAMS: 100,
+                h2.settings.SettingCodes.MAX_HEADER_LIST_SIZE: 65536,
+            },
+        )
+
+        # Some websites (*cough* Yahoo *cough*) balk at this setting being
+        # present in the initial handshake since it's not defined in the original
+        # RFC despite the RFC mandating ignoring settings you don't know about.
+        del self._h2_state.local_settings[
+            h2.settings.SettingCodes.ENABLE_CONNECT_PROTOCOL
+        ]
+
+        self._h2_state.initiate_connection()
+        self._h2_state.increment_flow_control_window(2**24)
+        await self._write_outgoing_data(request)
+
+    # Sending the request...
+
+    async def _send_request_headers(self, request: Request, stream_id: int) -> None:
+        """
+        Send the request headers to a given stream ID.
+        """
+        end_stream = not has_body_headers(request)
+
+        # In HTTP/2 the ':authority' pseudo-header is used instead of 'Host'.
+        # In order to gracefully handle HTTP/1.1 and HTTP/2 we always require
+        # HTTP/1.1 style headers, and map them appropriately if we end up on
+        # an HTTP/2 connection.
+        authority = [v for k, v in request.headers if k.lower() == b"host"][0]
+
+        headers = [
+            (b":method", request.method),
+            (b":authority", authority),
+            (b":scheme", request.url.scheme),
+            (b":path", request.url.target),
+        ] + [
+            (k.lower(), v)
+            for k, v in request.headers
+            if k.lower()
+            not in (
+                b"host",
+                b"transfer-encoding",
+            )
+        ]
+
+        self._h2_state.send_headers(stream_id, headers, end_stream=end_stream)
+        self._h2_state.increment_flow_control_window(2**24, stream_id=stream_id)
+        await self._write_outgoing_data(request)
+
+    async def _send_request_body(self, request: Request, stream_id: int) -> None:
+        """
+        Iterate over the request body sending it to a given stream ID.
+        """
+        if not has_body_headers(request):
+            return
+
+        assert isinstance(request.stream, typing.AsyncIterable)
+        async for data in request.stream:
+            await self._send_stream_data(request, stream_id, data)
+        await self._send_end_stream(request, stream_id)
+
+    async def _send_stream_data(
+        self, request: Request, stream_id: int, data: bytes
+    ) -> None:
+        """
+        Send a single chunk of data in one or more data frames.
+        """
+        while data:
+            max_flow = await self._wait_for_outgoing_flow(request, stream_id)
+            chunk_size = min(len(data), max_flow)
+            chunk, data = data[:chunk_size], data[chunk_size:]
+            self._h2_state.send_data(stream_id, chunk)
+            await self._write_outgoing_data(request)
+
+    async def _send_end_stream(self, request: Request, stream_id: int) -> None:
+        """
+        Send an empty data frame on on a given stream ID with the END_STREAM flag set.
+        """
+        self._h2_state.end_stream(stream_id)
+        await self._write_outgoing_data(request)
+
+    # Receiving the response...
+
+    async def _receive_response(
+        self, request: Request, stream_id: int
+    ) -> typing.Tuple[int, typing.List[typing.Tuple[bytes, bytes]]]:
+        """
+        Return the response status code and headers for a given stream ID.
+        """
+        while True:
+            event = await self._receive_stream_event(request, stream_id)
+            if isinstance(event, h2.events.ResponseReceived):
+                break
+
+        status_code = 200
+        headers = []
+        for k, v in event.headers:
+            if k == b":status":
+                status_code = int(v.decode("ascii", errors="ignore"))
+            elif not k.startswith(b":"):
+                headers.append((k, v))
+
+        return (status_code, headers)
+
+    async def _receive_response_body(
+        self, request: Request, stream_id: int
+    ) -> typing.AsyncIterator[bytes]:
+        """
+        Iterator that returns the bytes of the response body for a given stream ID.
+        """
+        while True:
+            event = await self._receive_stream_event(request, stream_id)
+            if isinstance(event, h2.events.DataReceived):
+                amount = event.flow_controlled_length
+                self._h2_state.acknowledge_received_data(amount, stream_id)
+                await self._write_outgoing_data(request)
+                yield event.data
+            elif isinstance(event, h2.events.StreamEnded):
+                break
+
+    async def _receive_stream_event(
+        self, request: Request, stream_id: int
+    ) -> typing.Union[
+        h2.events.ResponseReceived, h2.events.DataReceived, h2.events.StreamEnded
+    ]:
+        """
+        Return the next available event for a given stream ID.
+
+        Will read more data from the network if required.
+        """
+        while not self._events.get(stream_id):
+            await self._receive_events(request, stream_id)
+        event = self._events[stream_id].pop(0)
+        if isinstance(event, h2.events.StreamReset):
+            raise RemoteProtocolError(event)
+        return event
+
+    async def _receive_events(
+        self, request: Request, stream_id: typing.Optional[int] = None
+    ) -> None:
+        """
+        Read some data from the network until we see one or more events
+        for a given stream ID.
+        """
+        async with self._read_lock:
+            if self._connection_terminated is not None:
+                last_stream_id = self._connection_terminated.last_stream_id
+                if stream_id and last_stream_id and stream_id > last_stream_id:
+                    self._request_count -= 1
+                    raise ConnectionNotAvailable()
+                raise RemoteProtocolError(self._connection_terminated)
+
+            # This conditional is a bit icky. We don't want to block reading if we've
+            # actually got an event to return for a given stream. We need to do that
+            # check *within* the atomic read lock. Though it also need to be optional,
+            # because when we call it from `_wait_for_outgoing_flow` we *do* want to
+            # block until we've available flow control, event when we have events
+            # pending for the stream ID we're attempting to send on.
+            if stream_id is None or not self._events.get(stream_id):
+                events = await self._read_incoming_data(request)
+                for event in events:
+                    if isinstance(event, h2.events.RemoteSettingsChanged):
+                        async with Trace(
+                            "receive_remote_settings", logger, request
+                        ) as trace:
+                            await self._receive_remote_settings_change(event)
+                            trace.return_value = event
+
+                    elif isinstance(
+                        event,
+                        (
+                            h2.events.ResponseReceived,
+                            h2.events.DataReceived,
+                            h2.events.StreamEnded,
+                            h2.events.StreamReset,
+                        ),
+                    ):
+                        if event.stream_id in self._events:
+                            self._events[event.stream_id].append(event)
+
+                    elif isinstance(event, h2.events.ConnectionTerminated):
+                        self._connection_terminated = event
+
+        await self._write_outgoing_data(request)
+
+    async def _receive_remote_settings_change(self, event: h2.events.Event) -> None:
+        max_concurrent_streams = event.changed_settings.get(
+            h2.settings.SettingCodes.MAX_CONCURRENT_STREAMS
+        )
+        if max_concurrent_streams:
+            new_max_streams = min(
+                max_concurrent_streams.new_value,
+                self._h2_state.local_settings.max_concurrent_streams,
+            )
+            if new_max_streams and new_max_streams != self._max_streams:
+                while new_max_streams > self._max_streams:
+                    await self._max_streams_semaphore.release()
+                    self._max_streams += 1
+                while new_max_streams < self._max_streams:
+                    await self._max_streams_semaphore.acquire()
+                    self._max_streams -= 1
+
+    async def _response_closed(self, stream_id: int) -> None:
+        await self._max_streams_semaphore.release()
+        del self._events[stream_id]
+        async with self._state_lock:
+            if self._connection_terminated and not self._events:
+                await self.aclose()
+
+            elif self._state == HTTPConnectionState.ACTIVE and not self._events:
+                self._state = HTTPConnectionState.IDLE
+                if self._keepalive_expiry is not None:
+                    now = time.monotonic()
+                    self._expire_at = now + self._keepalive_expiry
+                if self._used_all_stream_ids:  # pragma: nocover
+                    await self.aclose()
+
+    async def aclose(self) -> None:
+        # Note that this method unilaterally closes the connection, and does
+        # not have any kind of locking in place around it.
+        self._h2_state.close_connection()
+        self._state = HTTPConnectionState.CLOSED
+        await self._network_stream.aclose()
+
+    # Wrappers around network read/write operations...
+
+    async def _read_incoming_data(
+        self, request: Request
+    ) -> typing.List[h2.events.Event]:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("read", None)
+
+        if self._read_exception is not None:
+            raise self._read_exception  # pragma: nocover
+
+        try:
+            data = await self._network_stream.read(self.READ_NUM_BYTES, timeout)
+            if data == b"":
+                raise RemoteProtocolError("Server disconnected")
+        except Exception as exc:
+            # If we get a network error we should:
+            #
+            # 1. Save the exception and just raise it immediately on any future reads.
+            #    (For example, this means that a single read timeout or disconnect will
+            #    immediately close all pending streams. Without requiring multiple
+            #    sequential timeouts.)
+            # 2. Mark the connection as errored, so that we don't accept any other
+            #    incoming requests.
+            self._read_exception = exc
+            self._connection_error = True
+            raise exc
+
+        events: typing.List[h2.events.Event] = self._h2_state.receive_data(data)
+
+        return events
+
+    async def _write_outgoing_data(self, request: Request) -> None:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("write", None)
+
+        async with self._write_lock:
+            data_to_send = self._h2_state.data_to_send()
+
+            if self._write_exception is not None:
+                raise self._write_exception  # pragma: nocover
+
+            try:
+                await self._network_stream.write(data_to_send, timeout)
+            except Exception as exc:  # pragma: nocover
+                # If we get a network error we should:
+                #
+                # 1. Save the exception and just raise it immediately on any future write.
+                #    (For example, this means that a single write timeout or disconnect will
+                #    immediately close all pending streams. Without requiring multiple
+                #    sequential timeouts.)
+                # 2. Mark the connection as errored, so that we don't accept any other
+                #    incoming requests.
+                self._write_exception = exc
+                self._connection_error = True
+                raise exc
+
+    # Flow control...
+
+    async def _wait_for_outgoing_flow(self, request: Request, stream_id: int) -> int:
+        """
+        Returns the maximum allowable outgoing flow for a given stream.
+
+        If the allowable flow is zero, then waits on the network until
+        WindowUpdated frames have increased the flow rate.
+        https://tools.ietf.org/html/rfc7540#section-6.9
+        """
+        local_flow: int = self._h2_state.local_flow_control_window(stream_id)
+        max_frame_size: int = self._h2_state.max_outbound_frame_size
+        flow = min(local_flow, max_frame_size)
+        while flow == 0:
+            await self._receive_events(request)
+            local_flow = self._h2_state.local_flow_control_window(stream_id)
+            max_frame_size = self._h2_state.max_outbound_frame_size
+            flow = min(local_flow, max_frame_size)
+        return flow
+
+    # Interface for connection pooling...
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        return origin == self._origin
+
+    def is_available(self) -> bool:
+        return (
+            self._state != HTTPConnectionState.CLOSED
+            and not self._connection_error
+            and not self._used_all_stream_ids
+            and not (
+                self._h2_state.state_machine.state
+                == h2.connection.ConnectionState.CLOSED
+            )
+        )
+
+    def has_expired(self) -> bool:
+        now = time.monotonic()
+        return self._expire_at is not None and now > self._expire_at
+
+    def is_idle(self) -> bool:
+        return self._state == HTTPConnectionState.IDLE
+
+    def is_closed(self) -> bool:
+        return self._state == HTTPConnectionState.CLOSED
+
+    def info(self) -> str:
+        origin = str(self._origin)
+        return (
+            f"{origin!r}, HTTP/2, {self._state.name}, "
+            f"Request Count: {self._request_count}"
+        )
+
+    def __repr__(self) -> str:
+        class_name = self.__class__.__name__
+        origin = str(self._origin)
+        return (
+            f"<{class_name} [{origin!r}, {self._state.name}, "
+            f"Request Count: {self._request_count}]>"
+        )
+
+    # These context managers are not used in the standard flow, but are
+    # useful for testing or working with connection instances directly.
+
+    async def __aenter__(self) -> "AsyncHTTP2Connection":
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: typing.Optional[typing.Type[BaseException]] = None,
+        exc_value: typing.Optional[BaseException] = None,
+        traceback: typing.Optional[types.TracebackType] = None,
+    ) -> None:
+        await self.aclose()
+
+
+class HTTP2ConnectionByteStream:
+    def __init__(
+        self, connection: AsyncHTTP2Connection, request: Request, stream_id: int
+    ) -> None:
+        self._connection = connection
+        self._request = request
+        self._stream_id = stream_id
+        self._closed = False
+
+    async def __aiter__(self) -> typing.AsyncIterator[bytes]:
+        kwargs = {"request": self._request, "stream_id": self._stream_id}
+        try:
+            async with Trace("receive_response_body", logger, self._request, kwargs):
+                async for chunk in self._connection._receive_response_body(
+                    request=self._request, stream_id=self._stream_id
+                ):
+                    yield chunk
+        except BaseException as exc:
+            # If we get an exception while streaming the response,
+            # we want to close the response (and possibly the connection)
+            # before raising that exception.
+            with AsyncShieldCancellation():
+                await self.aclose()
+            raise exc
+
+    async def aclose(self) -> None:
+        if not self._closed:
+            self._closed = True
+            kwargs = {"stream_id": self._stream_id}
+            async with Trace("response_closed", logger, self._request, kwargs):
+                await self._connection._response_closed(stream_id=self._stream_id)
diff --git a/llm/Lib/site-packages/httpcore/_async/http_proxy.py b/llm/Lib/site-packages/httpcore/_async/http_proxy.py
new file mode 100644
index 0000000000000000000000000000000000000000..4aa7d8741a95dcf18d3f623b855d0fda0c8a7f65
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_async/http_proxy.py
@@ -0,0 +1,368 @@
+import logging
+import ssl
+from base64 import b64encode
+from typing import Iterable, List, Mapping, Optional, Sequence, Tuple, Union
+
+from .._backends.base import SOCKET_OPTION, AsyncNetworkBackend
+from .._exceptions import ProxyError
+from .._models import (
+    URL,
+    Origin,
+    Request,
+    Response,
+    enforce_bytes,
+    enforce_headers,
+    enforce_url,
+)
+from .._ssl import default_ssl_context
+from .._synchronization import AsyncLock
+from .._trace import Trace
+from .connection import AsyncHTTPConnection
+from .connection_pool import AsyncConnectionPool
+from .http11 import AsyncHTTP11Connection
+from .interfaces import AsyncConnectionInterface
+
+HeadersAsSequence = Sequence[Tuple[Union[bytes, str], Union[bytes, str]]]
+HeadersAsMapping = Mapping[Union[bytes, str], Union[bytes, str]]
+
+
+logger = logging.getLogger("httpcore.proxy")
+
+
+def merge_headers(
+    default_headers: Optional[Sequence[Tuple[bytes, bytes]]] = None,
+    override_headers: Optional[Sequence[Tuple[bytes, bytes]]] = None,
+) -> List[Tuple[bytes, bytes]]:
+    """
+    Append default_headers and override_headers, de-duplicating if a key exists
+    in both cases.
+    """
+    default_headers = [] if default_headers is None else list(default_headers)
+    override_headers = [] if override_headers is None else list(override_headers)
+    has_override = set(key.lower() for key, value in override_headers)
+    default_headers = [
+        (key, value)
+        for key, value in default_headers
+        if key.lower() not in has_override
+    ]
+    return default_headers + override_headers
+
+
+def build_auth_header(username: bytes, password: bytes) -> bytes:
+    userpass = username + b":" + password
+    return b"Basic " + b64encode(userpass)
+
+
+class AsyncHTTPProxy(AsyncConnectionPool):
+    """
+    A connection pool that sends requests via an HTTP proxy.
+    """
+
+    def __init__(
+        self,
+        proxy_url: Union[URL, bytes, str],
+        proxy_auth: Optional[Tuple[Union[bytes, str], Union[bytes, str]]] = None,
+        proxy_headers: Union[HeadersAsMapping, HeadersAsSequence, None] = None,
+        ssl_context: Optional[ssl.SSLContext] = None,
+        proxy_ssl_context: Optional[ssl.SSLContext] = None,
+        max_connections: Optional[int] = 10,
+        max_keepalive_connections: Optional[int] = None,
+        keepalive_expiry: Optional[float] = None,
+        http1: bool = True,
+        http2: bool = False,
+        retries: int = 0,
+        local_address: Optional[str] = None,
+        uds: Optional[str] = None,
+        network_backend: Optional[AsyncNetworkBackend] = None,
+        socket_options: Optional[Iterable[SOCKET_OPTION]] = None,
+    ) -> None:
+        """
+        A connection pool for making HTTP requests.
+
+        Parameters:
+            proxy_url: The URL to use when connecting to the proxy server.
+                For example `"http://127.0.0.1:8080/"`.
+            proxy_auth: Any proxy authentication as a two-tuple of
+                (username, password). May be either bytes or ascii-only str.
+            proxy_headers: Any HTTP headers to use for the proxy requests.
+                For example `{"Proxy-Authorization": "Basic <username>:<password>"}`.
+            ssl_context: An SSL context to use for verifying connections.
+                If not specified, the default `httpcore.default_ssl_context()`
+                will be used.
+            proxy_ssl_context: The same as `ssl_context`, but for a proxy server rather than a remote origin.
+            max_connections: The maximum number of concurrent HTTP connections that
+                the pool should allow. Any attempt to send a request on a pool that
+                would exceed this amount will block until a connection is available.
+            max_keepalive_connections: The maximum number of idle HTTP connections
+                that will be maintained in the pool.
+            keepalive_expiry: The duration in seconds that an idle HTTP connection
+                may be maintained for before being expired from the pool.
+            http1: A boolean indicating if HTTP/1.1 requests should be supported
+                by the connection pool. Defaults to True.
+            http2: A boolean indicating if HTTP/2 requests should be supported by
+                the connection pool. Defaults to False.
+            retries: The maximum number of retries when trying to establish
+                a connection.
+            local_address: Local address to connect from. Can also be used to
+                connect using a particular address family. Using
+                `local_address="0.0.0.0"` will connect using an `AF_INET` address
+                (IPv4), while using `local_address="::"` will connect using an
+                `AF_INET6` address (IPv6).
+            uds: Path to a Unix Domain Socket to use instead of TCP sockets.
+            network_backend: A backend instance to use for handling network I/O.
+        """
+        super().__init__(
+            ssl_context=ssl_context,
+            max_connections=max_connections,
+            max_keepalive_connections=max_keepalive_connections,
+            keepalive_expiry=keepalive_expiry,
+            http1=http1,
+            http2=http2,
+            network_backend=network_backend,
+            retries=retries,
+            local_address=local_address,
+            uds=uds,
+            socket_options=socket_options,
+        )
+
+        self._proxy_url = enforce_url(proxy_url, name="proxy_url")
+        if (
+            self._proxy_url.scheme == b"http" and proxy_ssl_context is not None
+        ):  # pragma: no cover
+            raise RuntimeError(
+                "The `proxy_ssl_context` argument is not allowed for the http scheme"
+            )
+
+        self._ssl_context = ssl_context
+        self._proxy_ssl_context = proxy_ssl_context
+        self._proxy_headers = enforce_headers(proxy_headers, name="proxy_headers")
+        if proxy_auth is not None:
+            username = enforce_bytes(proxy_auth[0], name="proxy_auth")
+            password = enforce_bytes(proxy_auth[1], name="proxy_auth")
+            authorization = build_auth_header(username, password)
+            self._proxy_headers = [
+                (b"Proxy-Authorization", authorization)
+            ] + self._proxy_headers
+
+    def create_connection(self, origin: Origin) -> AsyncConnectionInterface:
+        if origin.scheme == b"http":
+            return AsyncForwardHTTPConnection(
+                proxy_origin=self._proxy_url.origin,
+                proxy_headers=self._proxy_headers,
+                remote_origin=origin,
+                keepalive_expiry=self._keepalive_expiry,
+                network_backend=self._network_backend,
+                proxy_ssl_context=self._proxy_ssl_context,
+            )
+        return AsyncTunnelHTTPConnection(
+            proxy_origin=self._proxy_url.origin,
+            proxy_headers=self._proxy_headers,
+            remote_origin=origin,
+            ssl_context=self._ssl_context,
+            proxy_ssl_context=self._proxy_ssl_context,
+            keepalive_expiry=self._keepalive_expiry,
+            http1=self._http1,
+            http2=self._http2,
+            network_backend=self._network_backend,
+        )
+
+
+class AsyncForwardHTTPConnection(AsyncConnectionInterface):
+    def __init__(
+        self,
+        proxy_origin: Origin,
+        remote_origin: Origin,
+        proxy_headers: Union[HeadersAsMapping, HeadersAsSequence, None] = None,
+        keepalive_expiry: Optional[float] = None,
+        network_backend: Optional[AsyncNetworkBackend] = None,
+        socket_options: Optional[Iterable[SOCKET_OPTION]] = None,
+        proxy_ssl_context: Optional[ssl.SSLContext] = None,
+    ) -> None:
+        self._connection = AsyncHTTPConnection(
+            origin=proxy_origin,
+            keepalive_expiry=keepalive_expiry,
+            network_backend=network_backend,
+            socket_options=socket_options,
+            ssl_context=proxy_ssl_context,
+        )
+        self._proxy_origin = proxy_origin
+        self._proxy_headers = enforce_headers(proxy_headers, name="proxy_headers")
+        self._remote_origin = remote_origin
+
+    async def handle_async_request(self, request: Request) -> Response:
+        headers = merge_headers(self._proxy_headers, request.headers)
+        url = URL(
+            scheme=self._proxy_origin.scheme,
+            host=self._proxy_origin.host,
+            port=self._proxy_origin.port,
+            target=bytes(request.url),
+        )
+        proxy_request = Request(
+            method=request.method,
+            url=url,
+            headers=headers,
+            content=request.stream,
+            extensions=request.extensions,
+        )
+        return await self._connection.handle_async_request(proxy_request)
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        return origin == self._remote_origin
+
+    async def aclose(self) -> None:
+        await self._connection.aclose()
+
+    def info(self) -> str:
+        return self._connection.info()
+
+    def is_available(self) -> bool:
+        return self._connection.is_available()
+
+    def has_expired(self) -> bool:
+        return self._connection.has_expired()
+
+    def is_idle(self) -> bool:
+        return self._connection.is_idle()
+
+    def is_closed(self) -> bool:
+        return self._connection.is_closed()
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} [{self.info()}]>"
+
+
+class AsyncTunnelHTTPConnection(AsyncConnectionInterface):
+    def __init__(
+        self,
+        proxy_origin: Origin,
+        remote_origin: Origin,
+        ssl_context: Optional[ssl.SSLContext] = None,
+        proxy_ssl_context: Optional[ssl.SSLContext] = None,
+        proxy_headers: Optional[Sequence[Tuple[bytes, bytes]]] = None,
+        keepalive_expiry: Optional[float] = None,
+        http1: bool = True,
+        http2: bool = False,
+        network_backend: Optional[AsyncNetworkBackend] = None,
+        socket_options: Optional[Iterable[SOCKET_OPTION]] = None,
+    ) -> None:
+        self._connection: AsyncConnectionInterface = AsyncHTTPConnection(
+            origin=proxy_origin,
+            keepalive_expiry=keepalive_expiry,
+            network_backend=network_backend,
+            socket_options=socket_options,
+            ssl_context=proxy_ssl_context,
+        )
+        self._proxy_origin = proxy_origin
+        self._remote_origin = remote_origin
+        self._ssl_context = ssl_context
+        self._proxy_ssl_context = proxy_ssl_context
+        self._proxy_headers = enforce_headers(proxy_headers, name="proxy_headers")
+        self._keepalive_expiry = keepalive_expiry
+        self._http1 = http1
+        self._http2 = http2
+        self._connect_lock = AsyncLock()
+        self._connected = False
+
+    async def handle_async_request(self, request: Request) -> Response:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("connect", None)
+
+        async with self._connect_lock:
+            if not self._connected:
+                target = b"%b:%d" % (self._remote_origin.host, self._remote_origin.port)
+
+                connect_url = URL(
+                    scheme=self._proxy_origin.scheme,
+                    host=self._proxy_origin.host,
+                    port=self._proxy_origin.port,
+                    target=target,
+                )
+                connect_headers = merge_headers(
+                    [(b"Host", target), (b"Accept", b"*/*")], self._proxy_headers
+                )
+                connect_request = Request(
+                    method=b"CONNECT",
+                    url=connect_url,
+                    headers=connect_headers,
+                    extensions=request.extensions,
+                )
+                connect_response = await self._connection.handle_async_request(
+                    connect_request
+                )
+
+                if connect_response.status < 200 or connect_response.status > 299:
+                    reason_bytes = connect_response.extensions.get("reason_phrase", b"")
+                    reason_str = reason_bytes.decode("ascii", errors="ignore")
+                    msg = "%d %s" % (connect_response.status, reason_str)
+                    await self._connection.aclose()
+                    raise ProxyError(msg)
+
+                stream = connect_response.extensions["network_stream"]
+
+                # Upgrade the stream to SSL
+                ssl_context = (
+                    default_ssl_context()
+                    if self._ssl_context is None
+                    else self._ssl_context
+                )
+                alpn_protocols = ["http/1.1", "h2"] if self._http2 else ["http/1.1"]
+                ssl_context.set_alpn_protocols(alpn_protocols)
+
+                kwargs = {
+                    "ssl_context": ssl_context,
+                    "server_hostname": self._remote_origin.host.decode("ascii"),
+                    "timeout": timeout,
+                }
+                async with Trace("start_tls", logger, request, kwargs) as trace:
+                    stream = await stream.start_tls(**kwargs)
+                    trace.return_value = stream
+
+                # Determine if we should be using HTTP/1.1 or HTTP/2
+                ssl_object = stream.get_extra_info("ssl_object")
+                http2_negotiated = (
+                    ssl_object is not None
+                    and ssl_object.selected_alpn_protocol() == "h2"
+                )
+
+                # Create the HTTP/1.1 or HTTP/2 connection
+                if http2_negotiated or (self._http2 and not self._http1):
+                    from .http2 import AsyncHTTP2Connection
+
+                    self._connection = AsyncHTTP2Connection(
+                        origin=self._remote_origin,
+                        stream=stream,
+                        keepalive_expiry=self._keepalive_expiry,
+                    )
+                else:
+                    self._connection = AsyncHTTP11Connection(
+                        origin=self._remote_origin,
+                        stream=stream,
+                        keepalive_expiry=self._keepalive_expiry,
+                    )
+
+                self._connected = True
+        return await self._connection.handle_async_request(request)
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        return origin == self._remote_origin
+
+    async def aclose(self) -> None:
+        await self._connection.aclose()
+
+    def info(self) -> str:
+        return self._connection.info()
+
+    def is_available(self) -> bool:
+        return self._connection.is_available()
+
+    def has_expired(self) -> bool:
+        return self._connection.has_expired()
+
+    def is_idle(self) -> bool:
+        return self._connection.is_idle()
+
+    def is_closed(self) -> bool:
+        return self._connection.is_closed()
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} [{self.info()}]>"
diff --git a/llm/Lib/site-packages/httpcore/_async/interfaces.py b/llm/Lib/site-packages/httpcore/_async/interfaces.py
new file mode 100644
index 0000000000000000000000000000000000000000..c998dd2763262443d67d42c4f0ceb6058688f8f5
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_async/interfaces.py
@@ -0,0 +1,135 @@
+from contextlib import asynccontextmanager
+from typing import AsyncIterator, Optional, Union
+
+from .._models import (
+    URL,
+    Extensions,
+    HeaderTypes,
+    Origin,
+    Request,
+    Response,
+    enforce_bytes,
+    enforce_headers,
+    enforce_url,
+    include_request_headers,
+)
+
+
+class AsyncRequestInterface:
+    async def request(
+        self,
+        method: Union[bytes, str],
+        url: Union[URL, bytes, str],
+        *,
+        headers: HeaderTypes = None,
+        content: Union[bytes, AsyncIterator[bytes], None] = None,
+        extensions: Optional[Extensions] = None,
+    ) -> Response:
+        # Strict type checking on our parameters.
+        method = enforce_bytes(method, name="method")
+        url = enforce_url(url, name="url")
+        headers = enforce_headers(headers, name="headers")
+
+        # Include Host header, and optionally Content-Length or Transfer-Encoding.
+        headers = include_request_headers(headers, url=url, content=content)
+
+        request = Request(
+            method=method,
+            url=url,
+            headers=headers,
+            content=content,
+            extensions=extensions,
+        )
+        response = await self.handle_async_request(request)
+        try:
+            await response.aread()
+        finally:
+            await response.aclose()
+        return response
+
+    @asynccontextmanager
+    async def stream(
+        self,
+        method: Union[bytes, str],
+        url: Union[URL, bytes, str],
+        *,
+        headers: HeaderTypes = None,
+        content: Union[bytes, AsyncIterator[bytes], None] = None,
+        extensions: Optional[Extensions] = None,
+    ) -> AsyncIterator[Response]:
+        # Strict type checking on our parameters.
+        method = enforce_bytes(method, name="method")
+        url = enforce_url(url, name="url")
+        headers = enforce_headers(headers, name="headers")
+
+        # Include Host header, and optionally Content-Length or Transfer-Encoding.
+        headers = include_request_headers(headers, url=url, content=content)
+
+        request = Request(
+            method=method,
+            url=url,
+            headers=headers,
+            content=content,
+            extensions=extensions,
+        )
+        response = await self.handle_async_request(request)
+        try:
+            yield response
+        finally:
+            await response.aclose()
+
+    async def handle_async_request(self, request: Request) -> Response:
+        raise NotImplementedError()  # pragma: nocover
+
+
+class AsyncConnectionInterface(AsyncRequestInterface):
+    async def aclose(self) -> None:
+        raise NotImplementedError()  # pragma: nocover
+
+    def info(self) -> str:
+        raise NotImplementedError()  # pragma: nocover
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        raise NotImplementedError()  # pragma: nocover
+
+    def is_available(self) -> bool:
+        """
+        Return `True` if the connection is currently able to accept an
+        outgoing request.
+
+        An HTTP/1.1 connection will only be available if it is currently idle.
+
+        An HTTP/2 connection will be available so long as the stream ID space is
+        not yet exhausted, and the connection is not in an error state.
+
+        While the connection is being established we may not yet know if it is going
+        to result in an HTTP/1.1 or HTTP/2 connection. The connection should be
+        treated as being available, but might ultimately raise `NewConnectionRequired`
+        required exceptions if multiple requests are attempted over a connection
+        that ends up being established as HTTP/1.1.
+        """
+        raise NotImplementedError()  # pragma: nocover
+
+    def has_expired(self) -> bool:
+        """
+        Return `True` if the connection is in a state where it should be closed.
+
+        This either means that the connection is idle and it has passed the
+        expiry time on its keep-alive, or that server has sent an EOF.
+        """
+        raise NotImplementedError()  # pragma: nocover
+
+    def is_idle(self) -> bool:
+        """
+        Return `True` if the connection is currently idle.
+        """
+        raise NotImplementedError()  # pragma: nocover
+
+    def is_closed(self) -> bool:
+        """
+        Return `True` if the connection has been closed.
+
+        Used when a response is closed to determine if the connection may be
+        returned to the connection pool or not.
+        """
+        raise NotImplementedError()  # pragma: nocover
diff --git a/llm/Lib/site-packages/httpcore/_async/socks_proxy.py b/llm/Lib/site-packages/httpcore/_async/socks_proxy.py
new file mode 100644
index 0000000000000000000000000000000000000000..f839603fe50c7abd402846959122af5361664dd0
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_async/socks_proxy.py
@@ -0,0 +1,342 @@
+import logging
+import ssl
+import typing
+
+from socksio import socks5
+
+from .._backends.auto import AutoBackend
+from .._backends.base import AsyncNetworkBackend, AsyncNetworkStream
+from .._exceptions import ConnectionNotAvailable, ProxyError
+from .._models import URL, Origin, Request, Response, enforce_bytes, enforce_url
+from .._ssl import default_ssl_context
+from .._synchronization import AsyncLock
+from .._trace import Trace
+from .connection_pool import AsyncConnectionPool
+from .http11 import AsyncHTTP11Connection
+from .interfaces import AsyncConnectionInterface
+
+logger = logging.getLogger("httpcore.socks")
+
+
+AUTH_METHODS = {
+    b"\x00": "NO AUTHENTICATION REQUIRED",
+    b"\x01": "GSSAPI",
+    b"\x02": "USERNAME/PASSWORD",
+    b"\xff": "NO ACCEPTABLE METHODS",
+}
+
+REPLY_CODES = {
+    b"\x00": "Succeeded",
+    b"\x01": "General SOCKS server failure",
+    b"\x02": "Connection not allowed by ruleset",
+    b"\x03": "Network unreachable",
+    b"\x04": "Host unreachable",
+    b"\x05": "Connection refused",
+    b"\x06": "TTL expired",
+    b"\x07": "Command not supported",
+    b"\x08": "Address type not supported",
+}
+
+
+async def _init_socks5_connection(
+    stream: AsyncNetworkStream,
+    *,
+    host: bytes,
+    port: int,
+    auth: typing.Optional[typing.Tuple[bytes, bytes]] = None,
+) -> None:
+    conn = socks5.SOCKS5Connection()
+
+    # Auth method request
+    auth_method = (
+        socks5.SOCKS5AuthMethod.NO_AUTH_REQUIRED
+        if auth is None
+        else socks5.SOCKS5AuthMethod.USERNAME_PASSWORD
+    )
+    conn.send(socks5.SOCKS5AuthMethodsRequest([auth_method]))
+    outgoing_bytes = conn.data_to_send()
+    await stream.write(outgoing_bytes)
+
+    # Auth method response
+    incoming_bytes = await stream.read(max_bytes=4096)
+    response = conn.receive_data(incoming_bytes)
+    assert isinstance(response, socks5.SOCKS5AuthReply)
+    if response.method != auth_method:
+        requested = AUTH_METHODS.get(auth_method, "UNKNOWN")
+        responded = AUTH_METHODS.get(response.method, "UNKNOWN")
+        raise ProxyError(
+            f"Requested {requested} from proxy server, but got {responded}."
+        )
+
+    if response.method == socks5.SOCKS5AuthMethod.USERNAME_PASSWORD:
+        # Username/password request
+        assert auth is not None
+        username, password = auth
+        conn.send(socks5.SOCKS5UsernamePasswordRequest(username, password))
+        outgoing_bytes = conn.data_to_send()
+        await stream.write(outgoing_bytes)
+
+        # Username/password response
+        incoming_bytes = await stream.read(max_bytes=4096)
+        response = conn.receive_data(incoming_bytes)
+        assert isinstance(response, socks5.SOCKS5UsernamePasswordReply)
+        if not response.success:
+            raise ProxyError("Invalid username/password")
+
+    # Connect request
+    conn.send(
+        socks5.SOCKS5CommandRequest.from_address(
+            socks5.SOCKS5Command.CONNECT, (host, port)
+        )
+    )
+    outgoing_bytes = conn.data_to_send()
+    await stream.write(outgoing_bytes)
+
+    # Connect response
+    incoming_bytes = await stream.read(max_bytes=4096)
+    response = conn.receive_data(incoming_bytes)
+    assert isinstance(response, socks5.SOCKS5Reply)
+    if response.reply_code != socks5.SOCKS5ReplyCode.SUCCEEDED:
+        reply_code = REPLY_CODES.get(response.reply_code, "UNKOWN")
+        raise ProxyError(f"Proxy Server could not connect: {reply_code}.")
+
+
+class AsyncSOCKSProxy(AsyncConnectionPool):
+    """
+    A connection pool that sends requests via an HTTP proxy.
+    """
+
+    def __init__(
+        self,
+        proxy_url: typing.Union[URL, bytes, str],
+        proxy_auth: typing.Optional[
+            typing.Tuple[typing.Union[bytes, str], typing.Union[bytes, str]]
+        ] = None,
+        ssl_context: typing.Optional[ssl.SSLContext] = None,
+        max_connections: typing.Optional[int] = 10,
+        max_keepalive_connections: typing.Optional[int] = None,
+        keepalive_expiry: typing.Optional[float] = None,
+        http1: bool = True,
+        http2: bool = False,
+        retries: int = 0,
+        network_backend: typing.Optional[AsyncNetworkBackend] = None,
+    ) -> None:
+        """
+        A connection pool for making HTTP requests.
+
+        Parameters:
+            proxy_url: The URL to use when connecting to the proxy server.
+                For example `"http://127.0.0.1:8080/"`.
+            ssl_context: An SSL context to use for verifying connections.
+                If not specified, the default `httpcore.default_ssl_context()`
+                will be used.
+            max_connections: The maximum number of concurrent HTTP connections that
+                the pool should allow. Any attempt to send a request on a pool that
+                would exceed this amount will block until a connection is available.
+            max_keepalive_connections: The maximum number of idle HTTP connections
+                that will be maintained in the pool.
+            keepalive_expiry: The duration in seconds that an idle HTTP connection
+                may be maintained for before being expired from the pool.
+            http1: A boolean indicating if HTTP/1.1 requests should be supported
+                by the connection pool. Defaults to True.
+            http2: A boolean indicating if HTTP/2 requests should be supported by
+                the connection pool. Defaults to False.
+            retries: The maximum number of retries when trying to establish
+                a connection.
+            local_address: Local address to connect from. Can also be used to
+                connect using a particular address family. Using
+                `local_address="0.0.0.0"` will connect using an `AF_INET` address
+                (IPv4), while using `local_address="::"` will connect using an
+                `AF_INET6` address (IPv6).
+            uds: Path to a Unix Domain Socket to use instead of TCP sockets.
+            network_backend: A backend instance to use for handling network I/O.
+        """
+        super().__init__(
+            ssl_context=ssl_context,
+            max_connections=max_connections,
+            max_keepalive_connections=max_keepalive_connections,
+            keepalive_expiry=keepalive_expiry,
+            http1=http1,
+            http2=http2,
+            network_backend=network_backend,
+            retries=retries,
+        )
+        self._ssl_context = ssl_context
+        self._proxy_url = enforce_url(proxy_url, name="proxy_url")
+        if proxy_auth is not None:
+            username, password = proxy_auth
+            username_bytes = enforce_bytes(username, name="proxy_auth")
+            password_bytes = enforce_bytes(password, name="proxy_auth")
+            self._proxy_auth: typing.Optional[typing.Tuple[bytes, bytes]] = (
+                username_bytes,
+                password_bytes,
+            )
+        else:
+            self._proxy_auth = None
+
+    def create_connection(self, origin: Origin) -> AsyncConnectionInterface:
+        return AsyncSocks5Connection(
+            proxy_origin=self._proxy_url.origin,
+            remote_origin=origin,
+            proxy_auth=self._proxy_auth,
+            ssl_context=self._ssl_context,
+            keepalive_expiry=self._keepalive_expiry,
+            http1=self._http1,
+            http2=self._http2,
+            network_backend=self._network_backend,
+        )
+
+
+class AsyncSocks5Connection(AsyncConnectionInterface):
+    def __init__(
+        self,
+        proxy_origin: Origin,
+        remote_origin: Origin,
+        proxy_auth: typing.Optional[typing.Tuple[bytes, bytes]] = None,
+        ssl_context: typing.Optional[ssl.SSLContext] = None,
+        keepalive_expiry: typing.Optional[float] = None,
+        http1: bool = True,
+        http2: bool = False,
+        network_backend: typing.Optional[AsyncNetworkBackend] = None,
+    ) -> None:
+        self._proxy_origin = proxy_origin
+        self._remote_origin = remote_origin
+        self._proxy_auth = proxy_auth
+        self._ssl_context = ssl_context
+        self._keepalive_expiry = keepalive_expiry
+        self._http1 = http1
+        self._http2 = http2
+
+        self._network_backend: AsyncNetworkBackend = (
+            AutoBackend() if network_backend is None else network_backend
+        )
+        self._connect_lock = AsyncLock()
+        self._connection: typing.Optional[AsyncConnectionInterface] = None
+        self._connect_failed = False
+
+    async def handle_async_request(self, request: Request) -> Response:
+        timeouts = request.extensions.get("timeout", {})
+        sni_hostname = request.extensions.get("sni_hostname", None)
+        timeout = timeouts.get("connect", None)
+
+        async with self._connect_lock:
+            if self._connection is None:
+                try:
+                    # Connect to the proxy
+                    kwargs = {
+                        "host": self._proxy_origin.host.decode("ascii"),
+                        "port": self._proxy_origin.port,
+                        "timeout": timeout,
+                    }
+                    async with Trace("connect_tcp", logger, request, kwargs) as trace:
+                        stream = await self._network_backend.connect_tcp(**kwargs)
+                        trace.return_value = stream
+
+                    # Connect to the remote host using socks5
+                    kwargs = {
+                        "stream": stream,
+                        "host": self._remote_origin.host.decode("ascii"),
+                        "port": self._remote_origin.port,
+                        "auth": self._proxy_auth,
+                    }
+                    async with Trace(
+                        "setup_socks5_connection", logger, request, kwargs
+                    ) as trace:
+                        await _init_socks5_connection(**kwargs)
+                        trace.return_value = stream
+
+                    # Upgrade the stream to SSL
+                    if self._remote_origin.scheme == b"https":
+                        ssl_context = (
+                            default_ssl_context()
+                            if self._ssl_context is None
+                            else self._ssl_context
+                        )
+                        alpn_protocols = (
+                            ["http/1.1", "h2"] if self._http2 else ["http/1.1"]
+                        )
+                        ssl_context.set_alpn_protocols(alpn_protocols)
+
+                        kwargs = {
+                            "ssl_context": ssl_context,
+                            "server_hostname": sni_hostname
+                            or self._remote_origin.host.decode("ascii"),
+                            "timeout": timeout,
+                        }
+                        async with Trace("start_tls", logger, request, kwargs) as trace:
+                            stream = await stream.start_tls(**kwargs)
+                            trace.return_value = stream
+
+                    # Determine if we should be using HTTP/1.1 or HTTP/2
+                    ssl_object = stream.get_extra_info("ssl_object")
+                    http2_negotiated = (
+                        ssl_object is not None
+                        and ssl_object.selected_alpn_protocol() == "h2"
+                    )
+
+                    # Create the HTTP/1.1 or HTTP/2 connection
+                    if http2_negotiated or (
+                        self._http2 and not self._http1
+                    ):  # pragma: nocover
+                        from .http2 import AsyncHTTP2Connection
+
+                        self._connection = AsyncHTTP2Connection(
+                            origin=self._remote_origin,
+                            stream=stream,
+                            keepalive_expiry=self._keepalive_expiry,
+                        )
+                    else:
+                        self._connection = AsyncHTTP11Connection(
+                            origin=self._remote_origin,
+                            stream=stream,
+                            keepalive_expiry=self._keepalive_expiry,
+                        )
+                except Exception as exc:
+                    self._connect_failed = True
+                    raise exc
+            elif not self._connection.is_available():  # pragma: nocover
+                raise ConnectionNotAvailable()
+
+        return await self._connection.handle_async_request(request)
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        return origin == self._remote_origin
+
+    async def aclose(self) -> None:
+        if self._connection is not None:
+            await self._connection.aclose()
+
+    def is_available(self) -> bool:
+        if self._connection is None:  # pragma: nocover
+            # If HTTP/2 support is enabled, and the resulting connection could
+            # end up as HTTP/2 then we should indicate the connection as being
+            # available to service multiple requests.
+            return (
+                self._http2
+                and (self._remote_origin.scheme == b"https" or not self._http1)
+                and not self._connect_failed
+            )
+        return self._connection.is_available()
+
+    def has_expired(self) -> bool:
+        if self._connection is None:  # pragma: nocover
+            return self._connect_failed
+        return self._connection.has_expired()
+
+    def is_idle(self) -> bool:
+        if self._connection is None:  # pragma: nocover
+            return self._connect_failed
+        return self._connection.is_idle()
+
+    def is_closed(self) -> bool:
+        if self._connection is None:  # pragma: nocover
+            return self._connect_failed
+        return self._connection.is_closed()
+
+    def info(self) -> str:
+        if self._connection is None:  # pragma: nocover
+            return "CONNECTION FAILED" if self._connect_failed else "CONNECTING"
+        return self._connection.info()
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} [{self.info()}]>"
diff --git a/llm/Lib/site-packages/httpcore/_backends/__init__.py b/llm/Lib/site-packages/httpcore/_backends/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/httpcore/_backends/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_backends/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4c8b8f7548ecf449d76ac10dd445e96efd25de64
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_backends/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_backends/__pycache__/anyio.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_backends/__pycache__/anyio.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f71e98ace3186fb3f226e47a98d54eb781554e93
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_backends/__pycache__/anyio.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_backends/__pycache__/auto.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_backends/__pycache__/auto.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c3facf047e0f7f63c6177067a28a60b8a6d61cd6
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_backends/__pycache__/auto.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_backends/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_backends/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cef5c2de402c5da7f5e7a2805b3241d04b4d7a50
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_backends/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_backends/__pycache__/mock.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_backends/__pycache__/mock.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..958688413b391c321f274ba24542fca85f6a20ab
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_backends/__pycache__/mock.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_backends/__pycache__/sync.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_backends/__pycache__/sync.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..12e4e8d3ef20f7bed569fd102b616b461519470d
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_backends/__pycache__/sync.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_backends/__pycache__/trio.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_backends/__pycache__/trio.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2282b9f43e71fb9df6129d3b1e2097e684da2c1e
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_backends/__pycache__/trio.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_backends/anyio.py b/llm/Lib/site-packages/httpcore/_backends/anyio.py
new file mode 100644
index 0000000000000000000000000000000000000000..5731f5e78c34093233abab90891f5a61c853291e
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_backends/anyio.py
@@ -0,0 +1,147 @@
+import ssl
+import typing
+
+import anyio
+
+from .._exceptions import (
+    ConnectError,
+    ConnectTimeout,
+    ReadError,
+    ReadTimeout,
+    WriteError,
+    WriteTimeout,
+    map_exceptions,
+)
+from .._utils import is_socket_readable
+from .base import SOCKET_OPTION, AsyncNetworkBackend, AsyncNetworkStream
+
+
+class AnyIOStream(AsyncNetworkStream):
+    def __init__(self, stream: anyio.abc.ByteStream) -> None:
+        self._stream = stream
+
+    async def read(
+        self, max_bytes: int, timeout: typing.Optional[float] = None
+    ) -> bytes:
+        exc_map = {
+            TimeoutError: ReadTimeout,
+            anyio.BrokenResourceError: ReadError,
+            anyio.ClosedResourceError: ReadError,
+            anyio.EndOfStream: ReadError,
+        }
+        with map_exceptions(exc_map):
+            with anyio.fail_after(timeout):
+                try:
+                    return await self._stream.receive(max_bytes=max_bytes)
+                except anyio.EndOfStream:  # pragma: nocover
+                    return b""
+
+    async def write(
+        self, buffer: bytes, timeout: typing.Optional[float] = None
+    ) -> None:
+        if not buffer:
+            return
+
+        exc_map = {
+            TimeoutError: WriteTimeout,
+            anyio.BrokenResourceError: WriteError,
+            anyio.ClosedResourceError: WriteError,
+        }
+        with map_exceptions(exc_map):
+            with anyio.fail_after(timeout):
+                await self._stream.send(item=buffer)
+
+    async def aclose(self) -> None:
+        await self._stream.aclose()
+
+    async def start_tls(
+        self,
+        ssl_context: ssl.SSLContext,
+        server_hostname: typing.Optional[str] = None,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncNetworkStream:
+        exc_map = {
+            TimeoutError: ConnectTimeout,
+            anyio.BrokenResourceError: ConnectError,
+            anyio.EndOfStream: ConnectError,
+        }
+        with map_exceptions(exc_map):
+            try:
+                with anyio.fail_after(timeout):
+                    ssl_stream = await anyio.streams.tls.TLSStream.wrap(
+                        self._stream,
+                        ssl_context=ssl_context,
+                        hostname=server_hostname,
+                        standard_compatible=False,
+                        server_side=False,
+                    )
+            except Exception as exc:  # pragma: nocover
+                await self.aclose()
+                raise exc
+        return AnyIOStream(ssl_stream)
+
+    def get_extra_info(self, info: str) -> typing.Any:
+        if info == "ssl_object":
+            return self._stream.extra(anyio.streams.tls.TLSAttribute.ssl_object, None)
+        if info == "client_addr":
+            return self._stream.extra(anyio.abc.SocketAttribute.local_address, None)
+        if info == "server_addr":
+            return self._stream.extra(anyio.abc.SocketAttribute.remote_address, None)
+        if info == "socket":
+            return self._stream.extra(anyio.abc.SocketAttribute.raw_socket, None)
+        if info == "is_readable":
+            sock = self._stream.extra(anyio.abc.SocketAttribute.raw_socket, None)
+            return is_socket_readable(sock)
+        return None
+
+
+class AnyIOBackend(AsyncNetworkBackend):
+    async def connect_tcp(
+        self,
+        host: str,
+        port: int,
+        timeout: typing.Optional[float] = None,
+        local_address: typing.Optional[str] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> AsyncNetworkStream:
+        if socket_options is None:
+            socket_options = []  # pragma: no cover
+        exc_map = {
+            TimeoutError: ConnectTimeout,
+            OSError: ConnectError,
+            anyio.BrokenResourceError: ConnectError,
+        }
+        with map_exceptions(exc_map):
+            with anyio.fail_after(timeout):
+                stream: anyio.abc.ByteStream = await anyio.connect_tcp(
+                    remote_host=host,
+                    remote_port=port,
+                    local_host=local_address,
+                )
+                # By default TCP sockets opened in `asyncio` include TCP_NODELAY.
+                for option in socket_options:
+                    stream._raw_socket.setsockopt(*option)  # type: ignore[attr-defined] # pragma: no cover
+        return AnyIOStream(stream)
+
+    async def connect_unix_socket(
+        self,
+        path: str,
+        timeout: typing.Optional[float] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> AsyncNetworkStream:  # pragma: nocover
+        if socket_options is None:
+            socket_options = []
+        exc_map = {
+            TimeoutError: ConnectTimeout,
+            OSError: ConnectError,
+            anyio.BrokenResourceError: ConnectError,
+        }
+        with map_exceptions(exc_map):
+            with anyio.fail_after(timeout):
+                stream: anyio.abc.ByteStream = await anyio.connect_unix(path)
+                for option in socket_options:
+                    stream._raw_socket.setsockopt(*option)  # type: ignore[attr-defined] # pragma: no cover
+        return AnyIOStream(stream)
+
+    async def sleep(self, seconds: float) -> None:
+        await anyio.sleep(seconds)  # pragma: nocover
diff --git a/llm/Lib/site-packages/httpcore/_backends/auto.py b/llm/Lib/site-packages/httpcore/_backends/auto.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ac05f4da0b1f15a443958dc1ce7d1eb42cde257
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_backends/auto.py
@@ -0,0 +1,51 @@
+import typing
+from typing import Optional
+
+from .._synchronization import current_async_library
+from .base import SOCKET_OPTION, AsyncNetworkBackend, AsyncNetworkStream
+
+
+class AutoBackend(AsyncNetworkBackend):
+    async def _init_backend(self) -> None:
+        if not (hasattr(self, "_backend")):
+            backend = current_async_library()
+            if backend == "trio":
+                from .trio import TrioBackend
+
+                self._backend: AsyncNetworkBackend = TrioBackend()
+            else:
+                from .anyio import AnyIOBackend
+
+                self._backend = AnyIOBackend()
+
+    async def connect_tcp(
+        self,
+        host: str,
+        port: int,
+        timeout: Optional[float] = None,
+        local_address: Optional[str] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> AsyncNetworkStream:
+        await self._init_backend()
+        return await self._backend.connect_tcp(
+            host,
+            port,
+            timeout=timeout,
+            local_address=local_address,
+            socket_options=socket_options,
+        )
+
+    async def connect_unix_socket(
+        self,
+        path: str,
+        timeout: Optional[float] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> AsyncNetworkStream:  # pragma: nocover
+        await self._init_backend()
+        return await self._backend.connect_unix_socket(
+            path, timeout=timeout, socket_options=socket_options
+        )
+
+    async def sleep(self, seconds: float) -> None:  # pragma: nocover
+        await self._init_backend()
+        return await self._backend.sleep(seconds)
diff --git a/llm/Lib/site-packages/httpcore/_backends/base.py b/llm/Lib/site-packages/httpcore/_backends/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..6cadedb5f9367536c8355b583127c4a904c3b8fa
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_backends/base.py
@@ -0,0 +1,103 @@
+import ssl
+import time
+import typing
+
+SOCKET_OPTION = typing.Union[
+    typing.Tuple[int, int, int],
+    typing.Tuple[int, int, typing.Union[bytes, bytearray]],
+    typing.Tuple[int, int, None, int],
+]
+
+
+class NetworkStream:
+    def read(self, max_bytes: int, timeout: typing.Optional[float] = None) -> bytes:
+        raise NotImplementedError()  # pragma: nocover
+
+    def write(self, buffer: bytes, timeout: typing.Optional[float] = None) -> None:
+        raise NotImplementedError()  # pragma: nocover
+
+    def close(self) -> None:
+        raise NotImplementedError()  # pragma: nocover
+
+    def start_tls(
+        self,
+        ssl_context: ssl.SSLContext,
+        server_hostname: typing.Optional[str] = None,
+        timeout: typing.Optional[float] = None,
+    ) -> "NetworkStream":
+        raise NotImplementedError()  # pragma: nocover
+
+    def get_extra_info(self, info: str) -> typing.Any:
+        return None  # pragma: nocover
+
+
+class NetworkBackend:
+    def connect_tcp(
+        self,
+        host: str,
+        port: int,
+        timeout: typing.Optional[float] = None,
+        local_address: typing.Optional[str] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> NetworkStream:
+        raise NotImplementedError()  # pragma: nocover
+
+    def connect_unix_socket(
+        self,
+        path: str,
+        timeout: typing.Optional[float] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> NetworkStream:
+        raise NotImplementedError()  # pragma: nocover
+
+    def sleep(self, seconds: float) -> None:
+        time.sleep(seconds)  # pragma: nocover
+
+
+class AsyncNetworkStream:
+    async def read(
+        self, max_bytes: int, timeout: typing.Optional[float] = None
+    ) -> bytes:
+        raise NotImplementedError()  # pragma: nocover
+
+    async def write(
+        self, buffer: bytes, timeout: typing.Optional[float] = None
+    ) -> None:
+        raise NotImplementedError()  # pragma: nocover
+
+    async def aclose(self) -> None:
+        raise NotImplementedError()  # pragma: nocover
+
+    async def start_tls(
+        self,
+        ssl_context: ssl.SSLContext,
+        server_hostname: typing.Optional[str] = None,
+        timeout: typing.Optional[float] = None,
+    ) -> "AsyncNetworkStream":
+        raise NotImplementedError()  # pragma: nocover
+
+    def get_extra_info(self, info: str) -> typing.Any:
+        return None  # pragma: nocover
+
+
+class AsyncNetworkBackend:
+    async def connect_tcp(
+        self,
+        host: str,
+        port: int,
+        timeout: typing.Optional[float] = None,
+        local_address: typing.Optional[str] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> AsyncNetworkStream:
+        raise NotImplementedError()  # pragma: nocover
+
+    async def connect_unix_socket(
+        self,
+        path: str,
+        timeout: typing.Optional[float] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> AsyncNetworkStream:
+        raise NotImplementedError()  # pragma: nocover
+
+    async def sleep(self, seconds: float) -> None:
+        raise NotImplementedError()  # pragma: nocover
diff --git a/llm/Lib/site-packages/httpcore/_backends/mock.py b/llm/Lib/site-packages/httpcore/_backends/mock.py
new file mode 100644
index 0000000000000000000000000000000000000000..f7aefebf519487bba08cba6af043b00ee453ef81
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_backends/mock.py
@@ -0,0 +1,142 @@
+import ssl
+import typing
+from typing import Optional
+
+from .._exceptions import ReadError
+from .base import (
+    SOCKET_OPTION,
+    AsyncNetworkBackend,
+    AsyncNetworkStream,
+    NetworkBackend,
+    NetworkStream,
+)
+
+
+class MockSSLObject:
+    def __init__(self, http2: bool):
+        self._http2 = http2
+
+    def selected_alpn_protocol(self) -> str:
+        return "h2" if self._http2 else "http/1.1"
+
+
+class MockStream(NetworkStream):
+    def __init__(self, buffer: typing.List[bytes], http2: bool = False) -> None:
+        self._buffer = buffer
+        self._http2 = http2
+        self._closed = False
+
+    def read(self, max_bytes: int, timeout: Optional[float] = None) -> bytes:
+        if self._closed:
+            raise ReadError("Connection closed")
+        if not self._buffer:
+            return b""
+        return self._buffer.pop(0)
+
+    def write(self, buffer: bytes, timeout: Optional[float] = None) -> None:
+        pass
+
+    def close(self) -> None:
+        self._closed = True
+
+    def start_tls(
+        self,
+        ssl_context: ssl.SSLContext,
+        server_hostname: Optional[str] = None,
+        timeout: Optional[float] = None,
+    ) -> NetworkStream:
+        return self
+
+    def get_extra_info(self, info: str) -> typing.Any:
+        return MockSSLObject(http2=self._http2) if info == "ssl_object" else None
+
+    def __repr__(self) -> str:
+        return "<httpcore.MockStream>"
+
+
+class MockBackend(NetworkBackend):
+    def __init__(self, buffer: typing.List[bytes], http2: bool = False) -> None:
+        self._buffer = buffer
+        self._http2 = http2
+
+    def connect_tcp(
+        self,
+        host: str,
+        port: int,
+        timeout: Optional[float] = None,
+        local_address: Optional[str] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> NetworkStream:
+        return MockStream(list(self._buffer), http2=self._http2)
+
+    def connect_unix_socket(
+        self,
+        path: str,
+        timeout: Optional[float] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> NetworkStream:
+        return MockStream(list(self._buffer), http2=self._http2)
+
+    def sleep(self, seconds: float) -> None:
+        pass
+
+
+class AsyncMockStream(AsyncNetworkStream):
+    def __init__(self, buffer: typing.List[bytes], http2: bool = False) -> None:
+        self._buffer = buffer
+        self._http2 = http2
+        self._closed = False
+
+    async def read(self, max_bytes: int, timeout: Optional[float] = None) -> bytes:
+        if self._closed:
+            raise ReadError("Connection closed")
+        if not self._buffer:
+            return b""
+        return self._buffer.pop(0)
+
+    async def write(self, buffer: bytes, timeout: Optional[float] = None) -> None:
+        pass
+
+    async def aclose(self) -> None:
+        self._closed = True
+
+    async def start_tls(
+        self,
+        ssl_context: ssl.SSLContext,
+        server_hostname: Optional[str] = None,
+        timeout: Optional[float] = None,
+    ) -> AsyncNetworkStream:
+        return self
+
+    def get_extra_info(self, info: str) -> typing.Any:
+        return MockSSLObject(http2=self._http2) if info == "ssl_object" else None
+
+    def __repr__(self) -> str:
+        return "<httpcore.AsyncMockStream>"
+
+
+class AsyncMockBackend(AsyncNetworkBackend):
+    def __init__(self, buffer: typing.List[bytes], http2: bool = False) -> None:
+        self._buffer = buffer
+        self._http2 = http2
+
+    async def connect_tcp(
+        self,
+        host: str,
+        port: int,
+        timeout: Optional[float] = None,
+        local_address: Optional[str] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> AsyncNetworkStream:
+        return AsyncMockStream(list(self._buffer), http2=self._http2)
+
+    async def connect_unix_socket(
+        self,
+        path: str,
+        timeout: Optional[float] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> AsyncNetworkStream:
+        return AsyncMockStream(list(self._buffer), http2=self._http2)
+
+    async def sleep(self, seconds: float) -> None:
+        pass
diff --git a/llm/Lib/site-packages/httpcore/_backends/sync.py b/llm/Lib/site-packages/httpcore/_backends/sync.py
new file mode 100644
index 0000000000000000000000000000000000000000..7b7b417dc1983737557015ffc940a0cc5b3f8698
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_backends/sync.py
@@ -0,0 +1,239 @@
+import socket
+import ssl
+import sys
+import typing
+from functools import partial
+
+from .._exceptions import (
+    ConnectError,
+    ConnectTimeout,
+    ExceptionMapping,
+    ReadError,
+    ReadTimeout,
+    WriteError,
+    WriteTimeout,
+    map_exceptions,
+)
+from .._utils import is_socket_readable
+from .base import SOCKET_OPTION, NetworkBackend, NetworkStream
+
+
+class TLSinTLSStream(NetworkStream):  # pragma: no cover
+    """
+    Because the standard `SSLContext.wrap_socket` method does
+    not work for `SSLSocket` objects, we need this class
+    to implement TLS stream using an underlying `SSLObject`
+    instance in order to support TLS on top of TLS.
+    """
+
+    # Defined in RFC 8449
+    TLS_RECORD_SIZE = 16384
+
+    def __init__(
+        self,
+        sock: socket.socket,
+        ssl_context: ssl.SSLContext,
+        server_hostname: typing.Optional[str] = None,
+        timeout: typing.Optional[float] = None,
+    ):
+        self._sock = sock
+        self._incoming = ssl.MemoryBIO()
+        self._outgoing = ssl.MemoryBIO()
+
+        self.ssl_obj = ssl_context.wrap_bio(
+            incoming=self._incoming,
+            outgoing=self._outgoing,
+            server_hostname=server_hostname,
+        )
+
+        self._sock.settimeout(timeout)
+        self._perform_io(self.ssl_obj.do_handshake)
+
+    def _perform_io(
+        self,
+        func: typing.Callable[..., typing.Any],
+    ) -> typing.Any:
+        ret = None
+
+        while True:
+            errno = None
+            try:
+                ret = func()
+            except (ssl.SSLWantReadError, ssl.SSLWantWriteError) as e:
+                errno = e.errno
+
+            self._sock.sendall(self._outgoing.read())
+
+            if errno == ssl.SSL_ERROR_WANT_READ:
+                buf = self._sock.recv(self.TLS_RECORD_SIZE)
+
+                if buf:
+                    self._incoming.write(buf)
+                else:
+                    self._incoming.write_eof()
+            if errno is None:
+                return ret
+
+    def read(self, max_bytes: int, timeout: typing.Optional[float] = None) -> bytes:
+        exc_map: ExceptionMapping = {socket.timeout: ReadTimeout, OSError: ReadError}
+        with map_exceptions(exc_map):
+            self._sock.settimeout(timeout)
+            return typing.cast(
+                bytes, self._perform_io(partial(self.ssl_obj.read, max_bytes))
+            )
+
+    def write(self, buffer: bytes, timeout: typing.Optional[float] = None) -> None:
+        exc_map: ExceptionMapping = {socket.timeout: WriteTimeout, OSError: WriteError}
+        with map_exceptions(exc_map):
+            self._sock.settimeout(timeout)
+            while buffer:
+                nsent = self._perform_io(partial(self.ssl_obj.write, buffer))
+                buffer = buffer[nsent:]
+
+    def close(self) -> None:
+        self._sock.close()
+
+    def start_tls(
+        self,
+        ssl_context: ssl.SSLContext,
+        server_hostname: typing.Optional[str] = None,
+        timeout: typing.Optional[float] = None,
+    ) -> "NetworkStream":
+        raise NotImplementedError()
+
+    def get_extra_info(self, info: str) -> typing.Any:
+        if info == "ssl_object":
+            return self.ssl_obj
+        if info == "client_addr":
+            return self._sock.getsockname()
+        if info == "server_addr":
+            return self._sock.getpeername()
+        if info == "socket":
+            return self._sock
+        if info == "is_readable":
+            return is_socket_readable(self._sock)
+        return None
+
+
+class SyncStream(NetworkStream):
+    def __init__(self, sock: socket.socket) -> None:
+        self._sock = sock
+
+    def read(self, max_bytes: int, timeout: typing.Optional[float] = None) -> bytes:
+        exc_map: ExceptionMapping = {socket.timeout: ReadTimeout, OSError: ReadError}
+        with map_exceptions(exc_map):
+            self._sock.settimeout(timeout)
+            return self._sock.recv(max_bytes)
+
+    def write(self, buffer: bytes, timeout: typing.Optional[float] = None) -> None:
+        if not buffer:
+            return
+
+        exc_map: ExceptionMapping = {socket.timeout: WriteTimeout, OSError: WriteError}
+        with map_exceptions(exc_map):
+            while buffer:
+                self._sock.settimeout(timeout)
+                n = self._sock.send(buffer)
+                buffer = buffer[n:]
+
+    def close(self) -> None:
+        self._sock.close()
+
+    def start_tls(
+        self,
+        ssl_context: ssl.SSLContext,
+        server_hostname: typing.Optional[str] = None,
+        timeout: typing.Optional[float] = None,
+    ) -> NetworkStream:
+        exc_map: ExceptionMapping = {
+            socket.timeout: ConnectTimeout,
+            OSError: ConnectError,
+        }
+        with map_exceptions(exc_map):
+            try:
+                if isinstance(self._sock, ssl.SSLSocket):  # pragma: no cover
+                    # If the underlying socket has already been upgraded
+                    # to the TLS layer (i.e. is an instance of SSLSocket),
+                    # we need some additional smarts to support TLS-in-TLS.
+                    return TLSinTLSStream(
+                        self._sock, ssl_context, server_hostname, timeout
+                    )
+                else:
+                    self._sock.settimeout(timeout)
+                    sock = ssl_context.wrap_socket(
+                        self._sock, server_hostname=server_hostname
+                    )
+            except Exception as exc:  # pragma: nocover
+                self.close()
+                raise exc
+        return SyncStream(sock)
+
+    def get_extra_info(self, info: str) -> typing.Any:
+        if info == "ssl_object" and isinstance(self._sock, ssl.SSLSocket):
+            return self._sock._sslobj  # type: ignore
+        if info == "client_addr":
+            return self._sock.getsockname()
+        if info == "server_addr":
+            return self._sock.getpeername()
+        if info == "socket":
+            return self._sock
+        if info == "is_readable":
+            return is_socket_readable(self._sock)
+        return None
+
+
+class SyncBackend(NetworkBackend):
+    def connect_tcp(
+        self,
+        host: str,
+        port: int,
+        timeout: typing.Optional[float] = None,
+        local_address: typing.Optional[str] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> NetworkStream:
+        # Note that we automatically include `TCP_NODELAY`
+        # in addition to any other custom socket options.
+        if socket_options is None:
+            socket_options = []  # pragma: no cover
+        address = (host, port)
+        source_address = None if local_address is None else (local_address, 0)
+        exc_map: ExceptionMapping = {
+            socket.timeout: ConnectTimeout,
+            OSError: ConnectError,
+        }
+
+        with map_exceptions(exc_map):
+            sock = socket.create_connection(
+                address,
+                timeout,
+                source_address=source_address,
+            )
+            for option in socket_options:
+                sock.setsockopt(*option)  # pragma: no cover
+            sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
+        return SyncStream(sock)
+
+    def connect_unix_socket(
+        self,
+        path: str,
+        timeout: typing.Optional[float] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> NetworkStream:  # pragma: nocover
+        if sys.platform == "win32":
+            raise RuntimeError(
+                "Attempted to connect to a UNIX socket on a Windows system."
+            )
+        if socket_options is None:
+            socket_options = []
+
+        exc_map: ExceptionMapping = {
+            socket.timeout: ConnectTimeout,
+            OSError: ConnectError,
+        }
+        with map_exceptions(exc_map):
+            sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
+            for option in socket_options:
+                sock.setsockopt(*option)
+            sock.settimeout(timeout)
+            sock.connect(path)
+        return SyncStream(sock)
diff --git a/llm/Lib/site-packages/httpcore/_backends/trio.py b/llm/Lib/site-packages/httpcore/_backends/trio.py
new file mode 100644
index 0000000000000000000000000000000000000000..b1626d28e2ded284a65d48a32309ee201d953c5e
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_backends/trio.py
@@ -0,0 +1,161 @@
+import ssl
+import typing
+
+import trio
+
+from .._exceptions import (
+    ConnectError,
+    ConnectTimeout,
+    ExceptionMapping,
+    ReadError,
+    ReadTimeout,
+    WriteError,
+    WriteTimeout,
+    map_exceptions,
+)
+from .base import SOCKET_OPTION, AsyncNetworkBackend, AsyncNetworkStream
+
+
+class TrioStream(AsyncNetworkStream):
+    def __init__(self, stream: trio.abc.Stream) -> None:
+        self._stream = stream
+
+    async def read(
+        self, max_bytes: int, timeout: typing.Optional[float] = None
+    ) -> bytes:
+        timeout_or_inf = float("inf") if timeout is None else timeout
+        exc_map: ExceptionMapping = {
+            trio.TooSlowError: ReadTimeout,
+            trio.BrokenResourceError: ReadError,
+            trio.ClosedResourceError: ReadError,
+        }
+        with map_exceptions(exc_map):
+            with trio.fail_after(timeout_or_inf):
+                data: bytes = await self._stream.receive_some(max_bytes=max_bytes)
+                return data
+
+    async def write(
+        self, buffer: bytes, timeout: typing.Optional[float] = None
+    ) -> None:
+        if not buffer:
+            return
+
+        timeout_or_inf = float("inf") if timeout is None else timeout
+        exc_map: ExceptionMapping = {
+            trio.TooSlowError: WriteTimeout,
+            trio.BrokenResourceError: WriteError,
+            trio.ClosedResourceError: WriteError,
+        }
+        with map_exceptions(exc_map):
+            with trio.fail_after(timeout_or_inf):
+                await self._stream.send_all(data=buffer)
+
+    async def aclose(self) -> None:
+        await self._stream.aclose()
+
+    async def start_tls(
+        self,
+        ssl_context: ssl.SSLContext,
+        server_hostname: typing.Optional[str] = None,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncNetworkStream:
+        timeout_or_inf = float("inf") if timeout is None else timeout
+        exc_map: ExceptionMapping = {
+            trio.TooSlowError: ConnectTimeout,
+            trio.BrokenResourceError: ConnectError,
+        }
+        ssl_stream = trio.SSLStream(
+            self._stream,
+            ssl_context=ssl_context,
+            server_hostname=server_hostname,
+            https_compatible=True,
+            server_side=False,
+        )
+        with map_exceptions(exc_map):
+            try:
+                with trio.fail_after(timeout_or_inf):
+                    await ssl_stream.do_handshake()
+            except Exception as exc:  # pragma: nocover
+                await self.aclose()
+                raise exc
+        return TrioStream(ssl_stream)
+
+    def get_extra_info(self, info: str) -> typing.Any:
+        if info == "ssl_object" and isinstance(self._stream, trio.SSLStream):
+            # Type checkers cannot see `_ssl_object` attribute because trio._ssl.SSLStream uses __getattr__/__setattr__.
+            # Tracked at https://github.com/python-trio/trio/issues/542
+            return self._stream._ssl_object  # type: ignore[attr-defined]
+        if info == "client_addr":
+            return self._get_socket_stream().socket.getsockname()
+        if info == "server_addr":
+            return self._get_socket_stream().socket.getpeername()
+        if info == "socket":
+            stream = self._stream
+            while isinstance(stream, trio.SSLStream):
+                stream = stream.transport_stream
+            assert isinstance(stream, trio.SocketStream)
+            return stream.socket
+        if info == "is_readable":
+            socket = self.get_extra_info("socket")
+            return socket.is_readable()
+        return None
+
+    def _get_socket_stream(self) -> trio.SocketStream:
+        stream = self._stream
+        while isinstance(stream, trio.SSLStream):
+            stream = stream.transport_stream
+        assert isinstance(stream, trio.SocketStream)
+        return stream
+
+
+class TrioBackend(AsyncNetworkBackend):
+    async def connect_tcp(
+        self,
+        host: str,
+        port: int,
+        timeout: typing.Optional[float] = None,
+        local_address: typing.Optional[str] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> AsyncNetworkStream:
+        # By default for TCP sockets, trio enables TCP_NODELAY.
+        # https://trio.readthedocs.io/en/stable/reference-io.html#trio.SocketStream
+        if socket_options is None:
+            socket_options = []  # pragma: no cover
+        timeout_or_inf = float("inf") if timeout is None else timeout
+        exc_map: ExceptionMapping = {
+            trio.TooSlowError: ConnectTimeout,
+            trio.BrokenResourceError: ConnectError,
+            OSError: ConnectError,
+        }
+        with map_exceptions(exc_map):
+            with trio.fail_after(timeout_or_inf):
+                stream: trio.abc.Stream = await trio.open_tcp_stream(
+                    host=host, port=port, local_address=local_address
+                )
+                for option in socket_options:
+                    stream.setsockopt(*option)  # type: ignore[attr-defined] # pragma: no cover
+        return TrioStream(stream)
+
+    async def connect_unix_socket(
+        self,
+        path: str,
+        timeout: typing.Optional[float] = None,
+        socket_options: typing.Optional[typing.Iterable[SOCKET_OPTION]] = None,
+    ) -> AsyncNetworkStream:  # pragma: nocover
+        if socket_options is None:
+            socket_options = []
+        timeout_or_inf = float("inf") if timeout is None else timeout
+        exc_map: ExceptionMapping = {
+            trio.TooSlowError: ConnectTimeout,
+            trio.BrokenResourceError: ConnectError,
+            OSError: ConnectError,
+        }
+        with map_exceptions(exc_map):
+            with trio.fail_after(timeout_or_inf):
+                stream: trio.abc.Stream = await trio.open_unix_socket(path)
+                for option in socket_options:
+                    stream.setsockopt(*option)  # type: ignore[attr-defined] # pragma: no cover
+        return TrioStream(stream)
+
+    async def sleep(self, seconds: float) -> None:
+        await trio.sleep(seconds)  # pragma: nocover
diff --git a/llm/Lib/site-packages/httpcore/_exceptions.py b/llm/Lib/site-packages/httpcore/_exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..81e7fc61ddfe258296d4d08b436fa8627f335dc9
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_exceptions.py
@@ -0,0 +1,81 @@
+import contextlib
+from typing import Iterator, Mapping, Type
+
+ExceptionMapping = Mapping[Type[Exception], Type[Exception]]
+
+
+@contextlib.contextmanager
+def map_exceptions(map: ExceptionMapping) -> Iterator[None]:
+    try:
+        yield
+    except Exception as exc:  # noqa: PIE786
+        for from_exc, to_exc in map.items():
+            if isinstance(exc, from_exc):
+                raise to_exc(exc) from exc
+        raise  # pragma: nocover
+
+
+class ConnectionNotAvailable(Exception):
+    pass
+
+
+class ProxyError(Exception):
+    pass
+
+
+class UnsupportedProtocol(Exception):
+    pass
+
+
+class ProtocolError(Exception):
+    pass
+
+
+class RemoteProtocolError(ProtocolError):
+    pass
+
+
+class LocalProtocolError(ProtocolError):
+    pass
+
+
+# Timeout errors
+
+
+class TimeoutException(Exception):
+    pass
+
+
+class PoolTimeout(TimeoutException):
+    pass
+
+
+class ConnectTimeout(TimeoutException):
+    pass
+
+
+class ReadTimeout(TimeoutException):
+    pass
+
+
+class WriteTimeout(TimeoutException):
+    pass
+
+
+# Network errors
+
+
+class NetworkError(Exception):
+    pass
+
+
+class ConnectError(NetworkError):
+    pass
+
+
+class ReadError(NetworkError):
+    pass
+
+
+class WriteError(NetworkError):
+    pass
diff --git a/llm/Lib/site-packages/httpcore/_models.py b/llm/Lib/site-packages/httpcore/_models.py
new file mode 100644
index 0000000000000000000000000000000000000000..dadee79f695eb8313391594c4930422ae68c996b
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_models.py
@@ -0,0 +1,492 @@
+from typing import (
+    Any,
+    AsyncIterable,
+    AsyncIterator,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    MutableMapping,
+    Optional,
+    Sequence,
+    Tuple,
+    Union,
+)
+from urllib.parse import urlparse
+
+# Functions for typechecking...
+
+
+HeadersAsSequence = Sequence[Tuple[Union[bytes, str], Union[bytes, str]]]
+HeadersAsMapping = Mapping[Union[bytes, str], Union[bytes, str]]
+HeaderTypes = Union[HeadersAsSequence, HeadersAsMapping, None]
+
+Extensions = MutableMapping[str, Any]
+
+
+def enforce_bytes(value: Union[bytes, str], *, name: str) -> bytes:
+    """
+    Any arguments that are ultimately represented as bytes can be specified
+    either as bytes or as strings.
+
+    However we enforce that any string arguments must only contain characters in
+    the plain ASCII range. chr(0)...chr(127). If you need to use characters
+    outside that range then be precise, and use a byte-wise argument.
+    """
+    if isinstance(value, str):
+        try:
+            return value.encode("ascii")
+        except UnicodeEncodeError:
+            raise TypeError(f"{name} strings may not include unicode characters.")
+    elif isinstance(value, bytes):
+        return value
+
+    seen_type = type(value).__name__
+    raise TypeError(f"{name} must be bytes or str, but got {seen_type}.")
+
+
+def enforce_url(value: Union["URL", bytes, str], *, name: str) -> "URL":
+    """
+    Type check for URL parameters.
+    """
+    if isinstance(value, (bytes, str)):
+        return URL(value)
+    elif isinstance(value, URL):
+        return value
+
+    seen_type = type(value).__name__
+    raise TypeError(f"{name} must be a URL, bytes, or str, but got {seen_type}.")
+
+
+def enforce_headers(
+    value: Union[HeadersAsMapping, HeadersAsSequence, None] = None, *, name: str
+) -> List[Tuple[bytes, bytes]]:
+    """
+    Convienence function that ensure all items in request or response headers
+    are either bytes or strings in the plain ASCII range.
+    """
+    if value is None:
+        return []
+    elif isinstance(value, Mapping):
+        return [
+            (
+                enforce_bytes(k, name="header name"),
+                enforce_bytes(v, name="header value"),
+            )
+            for k, v in value.items()
+        ]
+    elif isinstance(value, Sequence):
+        return [
+            (
+                enforce_bytes(k, name="header name"),
+                enforce_bytes(v, name="header value"),
+            )
+            for k, v in value
+        ]
+
+    seen_type = type(value).__name__
+    raise TypeError(
+        f"{name} must be a mapping or sequence of two-tuples, but got {seen_type}."
+    )
+
+
+def enforce_stream(
+    value: Union[bytes, Iterable[bytes], AsyncIterable[bytes], None], *, name: str
+) -> Union[Iterable[bytes], AsyncIterable[bytes]]:
+    if value is None:
+        return ByteStream(b"")
+    elif isinstance(value, bytes):
+        return ByteStream(value)
+    return value
+
+
+# * https://tools.ietf.org/html/rfc3986#section-3.2.3
+# * https://url.spec.whatwg.org/#url-miscellaneous
+# * https://url.spec.whatwg.org/#scheme-state
+DEFAULT_PORTS = {
+    b"ftp": 21,
+    b"http": 80,
+    b"https": 443,
+    b"ws": 80,
+    b"wss": 443,
+}
+
+
+def include_request_headers(
+    headers: List[Tuple[bytes, bytes]],
+    *,
+    url: "URL",
+    content: Union[None, bytes, Iterable[bytes], AsyncIterable[bytes]],
+) -> List[Tuple[bytes, bytes]]:
+    headers_set = set(k.lower() for k, v in headers)
+
+    if b"host" not in headers_set:
+        default_port = DEFAULT_PORTS.get(url.scheme)
+        if url.port is None or url.port == default_port:
+            header_value = url.host
+        else:
+            header_value = b"%b:%d" % (url.host, url.port)
+        headers = [(b"Host", header_value)] + headers
+
+    if (
+        content is not None
+        and b"content-length" not in headers_set
+        and b"transfer-encoding" not in headers_set
+    ):
+        if isinstance(content, bytes):
+            content_length = str(len(content)).encode("ascii")
+            headers += [(b"Content-Length", content_length)]
+        else:
+            headers += [(b"Transfer-Encoding", b"chunked")]  # pragma: nocover
+
+    return headers
+
+
+# Interfaces for byte streams...
+
+
+class ByteStream:
+    """
+    A container for non-streaming content, and that supports both sync and async
+    stream iteration.
+    """
+
+    def __init__(self, content: bytes) -> None:
+        self._content = content
+
+    def __iter__(self) -> Iterator[bytes]:
+        yield self._content
+
+    async def __aiter__(self) -> AsyncIterator[bytes]:
+        yield self._content
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} [{len(self._content)} bytes]>"
+
+
+class Origin:
+    def __init__(self, scheme: bytes, host: bytes, port: int) -> None:
+        self.scheme = scheme
+        self.host = host
+        self.port = port
+
+    def __eq__(self, other: Any) -> bool:
+        return (
+            isinstance(other, Origin)
+            and self.scheme == other.scheme
+            and self.host == other.host
+            and self.port == other.port
+        )
+
+    def __str__(self) -> str:
+        scheme = self.scheme.decode("ascii")
+        host = self.host.decode("ascii")
+        port = str(self.port)
+        return f"{scheme}://{host}:{port}"
+
+
+class URL:
+    """
+    Represents the URL against which an HTTP request may be made.
+
+    The URL may either be specified as a plain string, for convienence:
+
+    ```python
+    url = httpcore.URL("https://www.example.com/")
+    ```
+
+    Or be constructed with explicitily pre-parsed components:
+
+    ```python
+    url = httpcore.URL(scheme=b'https', host=b'www.example.com', port=None, target=b'/')
+    ```
+
+    Using this second more explicit style allows integrations that are using
+    `httpcore` to pass through URLs that have already been parsed in order to use
+    libraries such as `rfc-3986` rather than relying on the stdlib. It also ensures
+    that URL parsing is treated identically at both the networking level and at any
+    higher layers of abstraction.
+
+    The four components are important here, as they allow the URL to be precisely
+    specified in a pre-parsed format. They also allow certain types of request to
+    be created that could not otherwise be expressed.
+
+    For example, an HTTP request to `http://www.example.com/` forwarded via a proxy
+    at `http://localhost:8080`...
+
+    ```python
+    # Constructs an HTTP request with a complete URL as the target:
+    # GET https://www.example.com/ HTTP/1.1
+    url = httpcore.URL(
+        scheme=b'http',
+        host=b'localhost',
+        port=8080,
+        target=b'https://www.example.com/'
+    )
+    request = httpcore.Request(
+        method="GET",
+        url=url
+    )
+    ```
+
+    Another example is constructing an `OPTIONS *` request...
+
+    ```python
+    # Constructs an 'OPTIONS *' HTTP request:
+    # OPTIONS * HTTP/1.1
+    url = httpcore.URL(scheme=b'https', host=b'www.example.com', target=b'*')
+    request = httpcore.Request(method="OPTIONS", url=url)
+    ```
+
+    This kind of request is not possible to formulate with a URL string,
+    because the `/` delimiter is always used to demark the target from the
+    host/port portion of the URL.
+
+    For convenience, string-like arguments may be specified either as strings or
+    as bytes. However, once a request is being issue over-the-wire, the URL
+    components are always ultimately required to be a bytewise representation.
+
+    In order to avoid any ambiguity over character encodings, when strings are used
+    as arguments, they must be strictly limited to the ASCII range `chr(0)`-`chr(127)`.
+    If you require a bytewise representation that is outside this range you must
+    handle the character encoding directly, and pass a bytes instance.
+    """
+
+    def __init__(
+        self,
+        url: Union[bytes, str] = "",
+        *,
+        scheme: Union[bytes, str] = b"",
+        host: Union[bytes, str] = b"",
+        port: Optional[int] = None,
+        target: Union[bytes, str] = b"",
+    ) -> None:
+        """
+        Parameters:
+            url: The complete URL as a string or bytes.
+            scheme: The URL scheme as a string or bytes.
+                Typically either `"http"` or `"https"`.
+            host: The URL host as a string or bytes. Such as `"www.example.com"`.
+            port: The port to connect to. Either an integer or `None`.
+            target: The target of the HTTP request. Such as `"/items?search=red"`.
+        """
+        if url:
+            parsed = urlparse(enforce_bytes(url, name="url"))
+            self.scheme = parsed.scheme
+            self.host = parsed.hostname or b""
+            self.port = parsed.port
+            self.target = (parsed.path or b"/") + (
+                b"?" + parsed.query if parsed.query else b""
+            )
+        else:
+            self.scheme = enforce_bytes(scheme, name="scheme")
+            self.host = enforce_bytes(host, name="host")
+            self.port = port
+            self.target = enforce_bytes(target, name="target")
+
+    @property
+    def origin(self) -> Origin:
+        default_port = {
+            b"http": 80,
+            b"https": 443,
+            b"ws": 80,
+            b"wss": 443,
+            b"socks5": 1080,
+        }[self.scheme]
+        return Origin(
+            scheme=self.scheme, host=self.host, port=self.port or default_port
+        )
+
+    def __eq__(self, other: Any) -> bool:
+        return (
+            isinstance(other, URL)
+            and other.scheme == self.scheme
+            and other.host == self.host
+            and other.port == self.port
+            and other.target == self.target
+        )
+
+    def __bytes__(self) -> bytes:
+        if self.port is None:
+            return b"%b://%b%b" % (self.scheme, self.host, self.target)
+        return b"%b://%b:%d%b" % (self.scheme, self.host, self.port, self.target)
+
+    def __repr__(self) -> str:
+        return (
+            f"{self.__class__.__name__}(scheme={self.scheme!r}, "
+            f"host={self.host!r}, port={self.port!r}, target={self.target!r})"
+        )
+
+
+class Request:
+    """
+    An HTTP request.
+    """
+
+    def __init__(
+        self,
+        method: Union[bytes, str],
+        url: Union[URL, bytes, str],
+        *,
+        headers: HeaderTypes = None,
+        content: Union[bytes, Iterable[bytes], AsyncIterable[bytes], None] = None,
+        extensions: Optional[Extensions] = None,
+    ) -> None:
+        """
+        Parameters:
+            method: The HTTP request method, either as a string or bytes.
+                For example: `GET`.
+            url: The request URL, either as a `URL` instance, or as a string or bytes.
+                For example: `"https://www.example.com".`
+            headers: The HTTP request headers.
+            content: The content of the request body.
+            extensions: A dictionary of optional extra information included on
+                the request. Possible keys include `"timeout"`, and `"trace"`.
+        """
+        self.method: bytes = enforce_bytes(method, name="method")
+        self.url: URL = enforce_url(url, name="url")
+        self.headers: List[Tuple[bytes, bytes]] = enforce_headers(
+            headers, name="headers"
+        )
+        self.stream: Union[Iterable[bytes], AsyncIterable[bytes]] = enforce_stream(
+            content, name="content"
+        )
+        self.extensions = {} if extensions is None else extensions
+
+        if "target" in self.extensions:
+            self.url = URL(
+                scheme=self.url.scheme,
+                host=self.url.host,
+                port=self.url.port,
+                target=self.extensions["target"],
+            )
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} [{self.method!r}]>"
+
+
+class Response:
+    """
+    An HTTP response.
+    """
+
+    def __init__(
+        self,
+        status: int,
+        *,
+        headers: HeaderTypes = None,
+        content: Union[bytes, Iterable[bytes], AsyncIterable[bytes], None] = None,
+        extensions: Optional[Extensions] = None,
+    ) -> None:
+        """
+        Parameters:
+            status: The HTTP status code of the response. For example `200`.
+            headers: The HTTP response headers.
+            content: The content of the response body.
+            extensions: A dictionary of optional extra information included on
+                the responseself.Possible keys include `"http_version"`,
+                `"reason_phrase"`, and `"network_stream"`.
+        """
+        self.status: int = status
+        self.headers: List[Tuple[bytes, bytes]] = enforce_headers(
+            headers, name="headers"
+        )
+        self.stream: Union[Iterable[bytes], AsyncIterable[bytes]] = enforce_stream(
+            content, name="content"
+        )
+        self.extensions = {} if extensions is None else extensions
+
+        self._stream_consumed = False
+
+    @property
+    def content(self) -> bytes:
+        if not hasattr(self, "_content"):
+            if isinstance(self.stream, Iterable):
+                raise RuntimeError(
+                    "Attempted to access 'response.content' on a streaming response. "
+                    "Call 'response.read()' first."
+                )
+            else:
+                raise RuntimeError(
+                    "Attempted to access 'response.content' on a streaming response. "
+                    "Call 'await response.aread()' first."
+                )
+        return self._content
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} [{self.status}]>"
+
+    # Sync interface...
+
+    def read(self) -> bytes:
+        if not isinstance(self.stream, Iterable):  # pragma: nocover
+            raise RuntimeError(
+                "Attempted to read an asynchronous response using 'response.read()'. "
+                "You should use 'await response.aread()' instead."
+            )
+        if not hasattr(self, "_content"):
+            self._content = b"".join([part for part in self.iter_stream()])
+        return self._content
+
+    def iter_stream(self) -> Iterator[bytes]:
+        if not isinstance(self.stream, Iterable):  # pragma: nocover
+            raise RuntimeError(
+                "Attempted to stream an asynchronous response using 'for ... in "
+                "response.iter_stream()'. "
+                "You should use 'async for ... in response.aiter_stream()' instead."
+            )
+        if self._stream_consumed:
+            raise RuntimeError(
+                "Attempted to call 'for ... in response.iter_stream()' more than once."
+            )
+        self._stream_consumed = True
+        for chunk in self.stream:
+            yield chunk
+
+    def close(self) -> None:
+        if not isinstance(self.stream, Iterable):  # pragma: nocover
+            raise RuntimeError(
+                "Attempted to close an asynchronous response using 'response.close()'. "
+                "You should use 'await response.aclose()' instead."
+            )
+        if hasattr(self.stream, "close"):
+            self.stream.close()
+
+    # Async interface...
+
+    async def aread(self) -> bytes:
+        if not isinstance(self.stream, AsyncIterable):  # pragma: nocover
+            raise RuntimeError(
+                "Attempted to read an synchronous response using "
+                "'await response.aread()'. "
+                "You should use 'response.read()' instead."
+            )
+        if not hasattr(self, "_content"):
+            self._content = b"".join([part async for part in self.aiter_stream()])
+        return self._content
+
+    async def aiter_stream(self) -> AsyncIterator[bytes]:
+        if not isinstance(self.stream, AsyncIterable):  # pragma: nocover
+            raise RuntimeError(
+                "Attempted to stream an synchronous response using 'async for ... in "
+                "response.aiter_stream()'. "
+                "You should use 'for ... in response.iter_stream()' instead."
+            )
+        if self._stream_consumed:
+            raise RuntimeError(
+                "Attempted to call 'async for ... in response.aiter_stream()' "
+                "more than once."
+            )
+        self._stream_consumed = True
+        async for chunk in self.stream:
+            yield chunk
+
+    async def aclose(self) -> None:
+        if not isinstance(self.stream, AsyncIterable):  # pragma: nocover
+            raise RuntimeError(
+                "Attempted to close a synchronous response using "
+                "'await response.aclose()'. "
+                "You should use 'response.close()' instead."
+            )
+        if hasattr(self.stream, "aclose"):
+            await self.stream.aclose()
diff --git a/llm/Lib/site-packages/httpcore/_ssl.py b/llm/Lib/site-packages/httpcore/_ssl.py
new file mode 100644
index 0000000000000000000000000000000000000000..c99c5a67945b8a3a3544d481e979c791ab45fe23
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_ssl.py
@@ -0,0 +1,9 @@
+import ssl
+
+import certifi
+
+
+def default_ssl_context() -> ssl.SSLContext:
+    context = ssl.create_default_context()
+    context.load_verify_locations(certifi.where())
+    return context
diff --git a/llm/Lib/site-packages/httpcore/_sync/__init__.py b/llm/Lib/site-packages/httpcore/_sync/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b476d76d9a7ff45de8d18ec22d33d6af2982f92e
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_sync/__init__.py
@@ -0,0 +1,39 @@
+from .connection import HTTPConnection
+from .connection_pool import ConnectionPool
+from .http11 import HTTP11Connection
+from .http_proxy import HTTPProxy
+from .interfaces import ConnectionInterface
+
+try:
+    from .http2 import HTTP2Connection
+except ImportError:  # pragma: nocover
+
+    class HTTP2Connection:  # type: ignore
+        def __init__(self, *args, **kwargs) -> None:  # type: ignore
+            raise RuntimeError(
+                "Attempted to use http2 support, but the `h2` package is not "
+                "installed. Use 'pip install httpcore[http2]'."
+            )
+
+
+try:
+    from .socks_proxy import SOCKSProxy
+except ImportError:  # pragma: nocover
+
+    class SOCKSProxy:  # type: ignore
+        def __init__(self, *args, **kwargs) -> None:  # type: ignore
+            raise RuntimeError(
+                "Attempted to use SOCKS support, but the `socksio` package is not "
+                "installed. Use 'pip install httpcore[socks]'."
+            )
+
+
+__all__ = [
+    "HTTPConnection",
+    "ConnectionPool",
+    "HTTPProxy",
+    "HTTP11Connection",
+    "HTTP2Connection",
+    "ConnectionInterface",
+    "SOCKSProxy",
+]
diff --git a/llm/Lib/site-packages/httpcore/_sync/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_sync/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6789113f9000c49bcbd5b6e16e3eb8ea5fe6f913
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_sync/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_sync/__pycache__/connection.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_sync/__pycache__/connection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fd986de0fd607cb79c92f3eb04062e5d3f82bc21
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_sync/__pycache__/connection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_sync/__pycache__/connection_pool.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_sync/__pycache__/connection_pool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..03ae600454da524fe8e85033d4f8bfc7eff1ca19
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_sync/__pycache__/connection_pool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_sync/__pycache__/http11.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_sync/__pycache__/http11.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2112a9c49ff7159ab701ae882325420fbaa32916
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_sync/__pycache__/http11.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_sync/__pycache__/http2.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_sync/__pycache__/http2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..03e118abeb623d2c6c1342a2f6677331e5a615c9
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_sync/__pycache__/http2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_sync/__pycache__/http_proxy.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_sync/__pycache__/http_proxy.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6fe78362c668b833eb2c7e890909f91518026bcc
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_sync/__pycache__/http_proxy.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_sync/__pycache__/interfaces.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_sync/__pycache__/interfaces.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cf3ea99693b3fbb17ed93a1be4053829dfd667a9
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_sync/__pycache__/interfaces.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_sync/__pycache__/socks_proxy.cpython-311.pyc b/llm/Lib/site-packages/httpcore/_sync/__pycache__/socks_proxy.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..55b94c1d1141daf1005ddc47ffdc26001e76fafd
Binary files /dev/null and b/llm/Lib/site-packages/httpcore/_sync/__pycache__/socks_proxy.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpcore/_sync/connection.py b/llm/Lib/site-packages/httpcore/_sync/connection.py
new file mode 100644
index 0000000000000000000000000000000000000000..c3890f340c2fa4b0af288daaaebfa6e4ff09d0f3
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_sync/connection.py
@@ -0,0 +1,220 @@
+import itertools
+import logging
+import ssl
+from types import TracebackType
+from typing import Iterable, Iterator, Optional, Type
+
+from .._backends.sync import SyncBackend
+from .._backends.base import SOCKET_OPTION, NetworkBackend, NetworkStream
+from .._exceptions import ConnectError, ConnectTimeout
+from .._models import Origin, Request, Response
+from .._ssl import default_ssl_context
+from .._synchronization import Lock
+from .._trace import Trace
+from .http11 import HTTP11Connection
+from .interfaces import ConnectionInterface
+
+RETRIES_BACKOFF_FACTOR = 0.5  # 0s, 0.5s, 1s, 2s, 4s, etc.
+
+
+logger = logging.getLogger("httpcore.connection")
+
+
+def exponential_backoff(factor: float) -> Iterator[float]:
+    """
+    Generate a geometric sequence that has a ratio of 2 and starts with 0.
+
+    For example:
+    - `factor = 2`: `0, 2, 4, 8, 16, 32, 64, ...`
+    - `factor = 3`: `0, 3, 6, 12, 24, 48, 96, ...`
+    """
+    yield 0
+    for n in itertools.count():
+        yield factor * 2**n
+
+
+class HTTPConnection(ConnectionInterface):
+    def __init__(
+        self,
+        origin: Origin,
+        ssl_context: Optional[ssl.SSLContext] = None,
+        keepalive_expiry: Optional[float] = None,
+        http1: bool = True,
+        http2: bool = False,
+        retries: int = 0,
+        local_address: Optional[str] = None,
+        uds: Optional[str] = None,
+        network_backend: Optional[NetworkBackend] = None,
+        socket_options: Optional[Iterable[SOCKET_OPTION]] = None,
+    ) -> None:
+        self._origin = origin
+        self._ssl_context = ssl_context
+        self._keepalive_expiry = keepalive_expiry
+        self._http1 = http1
+        self._http2 = http2
+        self._retries = retries
+        self._local_address = local_address
+        self._uds = uds
+
+        self._network_backend: NetworkBackend = (
+            SyncBackend() if network_backend is None else network_backend
+        )
+        self._connection: Optional[ConnectionInterface] = None
+        self._connect_failed: bool = False
+        self._request_lock = Lock()
+        self._socket_options = socket_options
+
+    def handle_request(self, request: Request) -> Response:
+        if not self.can_handle_request(request.url.origin):
+            raise RuntimeError(
+                f"Attempted to send request to {request.url.origin} on connection to {self._origin}"
+            )
+
+        try:
+            with self._request_lock:
+                if self._connection is None:
+                    stream = self._connect(request)
+
+                    ssl_object = stream.get_extra_info("ssl_object")
+                    http2_negotiated = (
+                        ssl_object is not None
+                        and ssl_object.selected_alpn_protocol() == "h2"
+                    )
+                    if http2_negotiated or (self._http2 and not self._http1):
+                        from .http2 import HTTP2Connection
+
+                        self._connection = HTTP2Connection(
+                            origin=self._origin,
+                            stream=stream,
+                            keepalive_expiry=self._keepalive_expiry,
+                        )
+                    else:
+                        self._connection = HTTP11Connection(
+                            origin=self._origin,
+                            stream=stream,
+                            keepalive_expiry=self._keepalive_expiry,
+                        )
+        except BaseException as exc:
+            self._connect_failed = True
+            raise exc
+
+        return self._connection.handle_request(request)
+
+    def _connect(self, request: Request) -> NetworkStream:
+        timeouts = request.extensions.get("timeout", {})
+        sni_hostname = request.extensions.get("sni_hostname", None)
+        timeout = timeouts.get("connect", None)
+
+        retries_left = self._retries
+        delays = exponential_backoff(factor=RETRIES_BACKOFF_FACTOR)
+
+        while True:
+            try:
+                if self._uds is None:
+                    kwargs = {
+                        "host": self._origin.host.decode("ascii"),
+                        "port": self._origin.port,
+                        "local_address": self._local_address,
+                        "timeout": timeout,
+                        "socket_options": self._socket_options,
+                    }
+                    with Trace("connect_tcp", logger, request, kwargs) as trace:
+                        stream = self._network_backend.connect_tcp(**kwargs)
+                        trace.return_value = stream
+                else:
+                    kwargs = {
+                        "path": self._uds,
+                        "timeout": timeout,
+                        "socket_options": self._socket_options,
+                    }
+                    with Trace(
+                        "connect_unix_socket", logger, request, kwargs
+                    ) as trace:
+                        stream = self._network_backend.connect_unix_socket(
+                            **kwargs
+                        )
+                        trace.return_value = stream
+
+                if self._origin.scheme in (b"https", b"wss"):
+                    ssl_context = (
+                        default_ssl_context()
+                        if self._ssl_context is None
+                        else self._ssl_context
+                    )
+                    alpn_protocols = ["http/1.1", "h2"] if self._http2 else ["http/1.1"]
+                    ssl_context.set_alpn_protocols(alpn_protocols)
+
+                    kwargs = {
+                        "ssl_context": ssl_context,
+                        "server_hostname": sni_hostname
+                        or self._origin.host.decode("ascii"),
+                        "timeout": timeout,
+                    }
+                    with Trace("start_tls", logger, request, kwargs) as trace:
+                        stream = stream.start_tls(**kwargs)
+                        trace.return_value = stream
+                return stream
+            except (ConnectError, ConnectTimeout):
+                if retries_left <= 0:
+                    raise
+                retries_left -= 1
+                delay = next(delays)
+                with Trace("retry", logger, request, kwargs) as trace:
+                    self._network_backend.sleep(delay)
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        return origin == self._origin
+
+    def close(self) -> None:
+        if self._connection is not None:
+            with Trace("close", logger, None, {}):
+                self._connection.close()
+
+    def is_available(self) -> bool:
+        if self._connection is None:
+            # If HTTP/2 support is enabled, and the resulting connection could
+            # end up as HTTP/2 then we should indicate the connection as being
+            # available to service multiple requests.
+            return (
+                self._http2
+                and (self._origin.scheme == b"https" or not self._http1)
+                and not self._connect_failed
+            )
+        return self._connection.is_available()
+
+    def has_expired(self) -> bool:
+        if self._connection is None:
+            return self._connect_failed
+        return self._connection.has_expired()
+
+    def is_idle(self) -> bool:
+        if self._connection is None:
+            return self._connect_failed
+        return self._connection.is_idle()
+
+    def is_closed(self) -> bool:
+        if self._connection is None:
+            return self._connect_failed
+        return self._connection.is_closed()
+
+    def info(self) -> str:
+        if self._connection is None:
+            return "CONNECTION FAILED" if self._connect_failed else "CONNECTING"
+        return self._connection.info()
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} [{self.info()}]>"
+
+    # These context managers are not used in the standard flow, but are
+    # useful for testing or working with connection instances directly.
+
+    def __enter__(self) -> "HTTPConnection":
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        self.close()
diff --git a/llm/Lib/site-packages/httpcore/_sync/connection_pool.py b/llm/Lib/site-packages/httpcore/_sync/connection_pool.py
new file mode 100644
index 0000000000000000000000000000000000000000..8dcf348cac7aef80252d02505931b12dadfd52e3
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_sync/connection_pool.py
@@ -0,0 +1,380 @@
+import ssl
+import sys
+from types import TracebackType
+from typing import Iterable, Iterator, Iterable, List, Optional, Type
+
+from .._backends.sync import SyncBackend
+from .._backends.base import SOCKET_OPTION, NetworkBackend
+from .._exceptions import ConnectionNotAvailable, UnsupportedProtocol
+from .._models import Origin, Request, Response
+from .._synchronization import Event, ShieldCancellation, ThreadLock
+from .connection import HTTPConnection
+from .interfaces import ConnectionInterface, RequestInterface
+
+
+class PoolRequest:
+    def __init__(self, request: Request) -> None:
+        self.request = request
+        self.connection: Optional[ConnectionInterface] = None
+        self._connection_acquired = Event()
+
+    def assign_to_connection(
+        self, connection: Optional[ConnectionInterface]
+    ) -> None:
+        self.connection = connection
+        self._connection_acquired.set()
+
+    def clear_connection(self) -> None:
+        self.connection = None
+        self._connection_acquired = Event()
+
+    def wait_for_connection(
+        self, timeout: Optional[float] = None
+    ) -> ConnectionInterface:
+        if self.connection is None:
+            self._connection_acquired.wait(timeout=timeout)
+        assert self.connection is not None
+        return self.connection
+
+    def is_queued(self) -> bool:
+        return self.connection is None
+
+
+class ConnectionPool(RequestInterface):
+    """
+    A connection pool for making HTTP requests.
+    """
+
+    def __init__(
+        self,
+        ssl_context: Optional[ssl.SSLContext] = None,
+        max_connections: Optional[int] = 10,
+        max_keepalive_connections: Optional[int] = None,
+        keepalive_expiry: Optional[float] = None,
+        http1: bool = True,
+        http2: bool = False,
+        retries: int = 0,
+        local_address: Optional[str] = None,
+        uds: Optional[str] = None,
+        network_backend: Optional[NetworkBackend] = None,
+        socket_options: Optional[Iterable[SOCKET_OPTION]] = None,
+    ) -> None:
+        """
+        A connection pool for making HTTP requests.
+
+        Parameters:
+            ssl_context: An SSL context to use for verifying connections.
+                If not specified, the default `httpcore.default_ssl_context()`
+                will be used.
+            max_connections: The maximum number of concurrent HTTP connections that
+                the pool should allow. Any attempt to send a request on a pool that
+                would exceed this amount will block until a connection is available.
+            max_keepalive_connections: The maximum number of idle HTTP connections
+                that will be maintained in the pool.
+            keepalive_expiry: The duration in seconds that an idle HTTP connection
+                may be maintained for before being expired from the pool.
+            http1: A boolean indicating if HTTP/1.1 requests should be supported
+                by the connection pool. Defaults to True.
+            http2: A boolean indicating if HTTP/2 requests should be supported by
+                the connection pool. Defaults to False.
+            retries: The maximum number of retries when trying to establish a
+                connection.
+            local_address: Local address to connect from. Can also be used to connect
+                using a particular address family. Using `local_address="0.0.0.0"`
+                will connect using an `AF_INET` address (IPv4), while using
+                `local_address="::"` will connect using an `AF_INET6` address (IPv6).
+            uds: Path to a Unix Domain Socket to use instead of TCP sockets.
+            network_backend: A backend instance to use for handling network I/O.
+            socket_options: Socket options that have to be included
+             in the TCP socket when the connection was established.
+        """
+        self._ssl_context = ssl_context
+
+        self._max_connections = (
+            sys.maxsize if max_connections is None else max_connections
+        )
+        self._max_keepalive_connections = (
+            sys.maxsize
+            if max_keepalive_connections is None
+            else max_keepalive_connections
+        )
+        self._max_keepalive_connections = min(
+            self._max_connections, self._max_keepalive_connections
+        )
+
+        self._keepalive_expiry = keepalive_expiry
+        self._http1 = http1
+        self._http2 = http2
+        self._retries = retries
+        self._local_address = local_address
+        self._uds = uds
+
+        self._network_backend = (
+            SyncBackend() if network_backend is None else network_backend
+        )
+        self._socket_options = socket_options
+
+        # The mutable state on a connection pool is the queue of incoming requests,
+        # and the set of connections that are servicing those requests.
+        self._connections: List[ConnectionInterface] = []
+        self._requests: List[PoolRequest] = []
+
+        # We only mutate the state of the connection pool within an 'optional_thread_lock'
+        # context. This holds a threading lock unless we're running in async mode,
+        # in which case it is a no-op.
+        self._optional_thread_lock = ThreadLock()
+
+    def create_connection(self, origin: Origin) -> ConnectionInterface:
+        return HTTPConnection(
+            origin=origin,
+            ssl_context=self._ssl_context,
+            keepalive_expiry=self._keepalive_expiry,
+            http1=self._http1,
+            http2=self._http2,
+            retries=self._retries,
+            local_address=self._local_address,
+            uds=self._uds,
+            network_backend=self._network_backend,
+            socket_options=self._socket_options,
+        )
+
+    @property
+    def connections(self) -> List[ConnectionInterface]:
+        """
+        Return a list of the connections currently in the pool.
+
+        For example:
+
+        ```python
+        >>> pool.connections
+        [
+            <HTTPConnection ['https://example.com:443', HTTP/1.1, ACTIVE, Request Count: 6]>,
+            <HTTPConnection ['https://example.com:443', HTTP/1.1, IDLE, Request Count: 9]> ,
+            <HTTPConnection ['http://example.com:80', HTTP/1.1, IDLE, Request Count: 1]>,
+        ]
+        ```
+        """
+        return list(self._connections)
+
+    def handle_request(self, request: Request) -> Response:
+        """
+        Send an HTTP request, and return an HTTP response.
+
+        This is the core implementation that is called into by `.request()` or `.stream()`.
+        """
+        scheme = request.url.scheme.decode()
+        if scheme == "":
+            raise UnsupportedProtocol(
+                "Request URL is missing an 'http://' or 'https://' protocol."
+            )
+        if scheme not in ("http", "https", "ws", "wss"):
+            raise UnsupportedProtocol(
+                f"Request URL has an unsupported protocol '{scheme}://'."
+            )
+
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("pool", None)
+
+        with self._optional_thread_lock:
+            # Add the incoming request to our request queue.
+            pool_request = PoolRequest(request)
+            self._requests.append(pool_request)
+
+        try:
+            while True:
+                with self._optional_thread_lock:
+                    # Assign incoming requests to available connections,
+                    # closing or creating new connections as required.
+                    closing = self._assign_requests_to_connections()
+                self._close_connections(closing)
+
+                # Wait until this request has an assigned connection.
+                connection = pool_request.wait_for_connection(timeout=timeout)
+
+                try:
+                    # Send the request on the assigned connection.
+                    response = connection.handle_request(
+                        pool_request.request
+                    )
+                except ConnectionNotAvailable:
+                    # In some cases a connection may initially be available to
+                    # handle a request, but then become unavailable.
+                    #
+                    # In this case we clear the connection and try again.
+                    pool_request.clear_connection()
+                else:
+                    break  # pragma: nocover
+
+        except BaseException as exc:
+            with self._optional_thread_lock:
+                # For any exception or cancellation we remove the request from
+                # the queue, and then re-assign requests to connections.
+                self._requests.remove(pool_request)
+                closing = self._assign_requests_to_connections()
+
+            self._close_connections(closing)
+            raise exc from None
+
+        # Return the response. Note that in this case we still have to manage
+        # the point at which the response is closed.
+        assert isinstance(response.stream, Iterable)
+        return Response(
+            status=response.status,
+            headers=response.headers,
+            content=PoolByteStream(
+                stream=response.stream, pool_request=pool_request, pool=self
+            ),
+            extensions=response.extensions,
+        )
+
+    def _assign_requests_to_connections(self) -> List[ConnectionInterface]:
+        """
+        Manage the state of the connection pool, assigning incoming
+        requests to connections as available.
+
+        Called whenever a new request is added or removed from the pool.
+
+        Any closing connections are returned, allowing the I/O for closing
+        those connections to be handled seperately.
+        """
+        closing_connections = []
+
+        # First we handle cleaning up any connections that are closed,
+        # have expired their keep-alive, or surplus idle connections.
+        for connection in list(self._connections):
+            if connection.is_closed():
+                # log: "removing closed connection"
+                self._connections.remove(connection)
+            elif connection.has_expired():
+                # log: "closing expired connection"
+                self._connections.remove(connection)
+                closing_connections.append(connection)
+            elif (
+                connection.is_idle()
+                and len([connection.is_idle() for connection in self._connections])
+                > self._max_keepalive_connections
+            ):
+                # log: "closing idle connection"
+                self._connections.remove(connection)
+                closing_connections.append(connection)
+
+        # Assign queued requests to connections.
+        queued_requests = [request for request in self._requests if request.is_queued()]
+        for pool_request in queued_requests:
+            origin = pool_request.request.url.origin
+            avilable_connections = [
+                connection
+                for connection in self._connections
+                if connection.can_handle_request(origin) and connection.is_available()
+            ]
+            idle_connections = [
+                connection for connection in self._connections if connection.is_idle()
+            ]
+
+            # There are three cases for how we may be able to handle the request:
+            #
+            # 1. There is an existing connection that can handle the request.
+            # 2. We can create a new connection to handle the request.
+            # 3. We can close an idle connection and then create a new connection
+            #    to handle the request.
+            if avilable_connections:
+                # log: "reusing existing connection"
+                connection = avilable_connections[0]
+                pool_request.assign_to_connection(connection)
+            elif len(self._connections) < self._max_connections:
+                # log: "creating new connection"
+                connection = self.create_connection(origin)
+                self._connections.append(connection)
+                pool_request.assign_to_connection(connection)
+            elif idle_connections:
+                # log: "closing idle connection"
+                connection = idle_connections[0]
+                self._connections.remove(connection)
+                closing_connections.append(connection)
+                # log: "creating new connection"
+                connection = self.create_connection(origin)
+                self._connections.append(connection)
+                pool_request.assign_to_connection(connection)
+
+        return closing_connections
+
+    def _close_connections(self, closing: List[ConnectionInterface]) -> None:
+        # Close connections which have been removed from the pool.
+        with ShieldCancellation():
+            for connection in closing:
+                connection.close()
+
+    def close(self) -> None:
+        # Explicitly close the connection pool.
+        # Clears all existing requests and connections.
+        with self._optional_thread_lock:
+            closing_connections = list(self._connections)
+            self._connections = []
+        self._close_connections(closing_connections)
+
+    def __enter__(self) -> "ConnectionPool":
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        self.close()
+
+    def __repr__(self) -> str:
+        class_name = self.__class__.__name__
+        with self._optional_thread_lock:
+            request_is_queued = [request.is_queued() for request in self._requests]
+            connection_is_idle = [
+                connection.is_idle() for connection in self._connections
+            ]
+
+            num_active_requests = request_is_queued.count(False)
+            num_queued_requests = request_is_queued.count(True)
+            num_active_connections = connection_is_idle.count(False)
+            num_idle_connections = connection_is_idle.count(True)
+
+        requests_info = (
+            f"Requests: {num_active_requests} active, {num_queued_requests} queued"
+        )
+        connection_info = (
+            f"Connections: {num_active_connections} active, {num_idle_connections} idle"
+        )
+
+        return f"<{class_name} [{requests_info} | {connection_info}]>"
+
+
+class PoolByteStream:
+    def __init__(
+        self,
+        stream: Iterable[bytes],
+        pool_request: PoolRequest,
+        pool: ConnectionPool,
+    ) -> None:
+        self._stream = stream
+        self._pool_request = pool_request
+        self._pool = pool
+        self._closed = False
+
+    def __iter__(self) -> Iterator[bytes]:
+        try:
+            for part in self._stream:
+                yield part
+        except BaseException as exc:
+            self.close()
+            raise exc from None
+
+    def close(self) -> None:
+        if not self._closed:
+            self._closed = True
+            with ShieldCancellation():
+                if hasattr(self._stream, "close"):
+                    self._stream.close()
+
+            with self._pool._optional_thread_lock:
+                self._pool._requests.remove(self._pool_request)
+                closing = self._pool._assign_requests_to_connections()
+
+            self._pool._close_connections(closing)
diff --git a/llm/Lib/site-packages/httpcore/_sync/http11.py b/llm/Lib/site-packages/httpcore/_sync/http11.py
new file mode 100644
index 0000000000000000000000000000000000000000..a74ff8e8092f94ccc8dc6b72d1dd8cb6fb49b31c
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_sync/http11.py
@@ -0,0 +1,386 @@
+import enum
+import logging
+import ssl
+import time
+from types import TracebackType
+from typing import (
+    Any,
+    Iterable,
+    Iterator,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+import h11
+
+from .._backends.base import NetworkStream
+from .._exceptions import (
+    ConnectionNotAvailable,
+    LocalProtocolError,
+    RemoteProtocolError,
+    WriteError,
+    map_exceptions,
+)
+from .._models import Origin, Request, Response
+from .._synchronization import Lock, ShieldCancellation
+from .._trace import Trace
+from .interfaces import ConnectionInterface
+
+logger = logging.getLogger("httpcore.http11")
+
+
+# A subset of `h11.Event` types supported by `_send_event`
+H11SendEvent = Union[
+    h11.Request,
+    h11.Data,
+    h11.EndOfMessage,
+]
+
+
+class HTTPConnectionState(enum.IntEnum):
+    NEW = 0
+    ACTIVE = 1
+    IDLE = 2
+    CLOSED = 3
+
+
+class HTTP11Connection(ConnectionInterface):
+    READ_NUM_BYTES = 64 * 1024
+    MAX_INCOMPLETE_EVENT_SIZE = 100 * 1024
+
+    def __init__(
+        self,
+        origin: Origin,
+        stream: NetworkStream,
+        keepalive_expiry: Optional[float] = None,
+    ) -> None:
+        self._origin = origin
+        self._network_stream = stream
+        self._keepalive_expiry: Optional[float] = keepalive_expiry
+        self._expire_at: Optional[float] = None
+        self._state = HTTPConnectionState.NEW
+        self._state_lock = Lock()
+        self._request_count = 0
+        self._h11_state = h11.Connection(
+            our_role=h11.CLIENT,
+            max_incomplete_event_size=self.MAX_INCOMPLETE_EVENT_SIZE,
+        )
+
+    def handle_request(self, request: Request) -> Response:
+        if not self.can_handle_request(request.url.origin):
+            raise RuntimeError(
+                f"Attempted to send request to {request.url.origin} on connection "
+                f"to {self._origin}"
+            )
+
+        with self._state_lock:
+            if self._state in (HTTPConnectionState.NEW, HTTPConnectionState.IDLE):
+                self._request_count += 1
+                self._state = HTTPConnectionState.ACTIVE
+                self._expire_at = None
+            else:
+                raise ConnectionNotAvailable()
+
+        try:
+            kwargs = {"request": request}
+            try:
+                with Trace(
+                    "send_request_headers", logger, request, kwargs
+                ) as trace:
+                    self._send_request_headers(**kwargs)
+                with Trace("send_request_body", logger, request, kwargs) as trace:
+                    self._send_request_body(**kwargs)
+            except WriteError:
+                # If we get a write error while we're writing the request,
+                # then we supress this error and move on to attempting to
+                # read the response. Servers can sometimes close the request
+                # pre-emptively and then respond with a well formed HTTP
+                # error response.
+                pass
+
+            with Trace(
+                "receive_response_headers", logger, request, kwargs
+            ) as trace:
+                (
+                    http_version,
+                    status,
+                    reason_phrase,
+                    headers,
+                    trailing_data,
+                ) = self._receive_response_headers(**kwargs)
+                trace.return_value = (
+                    http_version,
+                    status,
+                    reason_phrase,
+                    headers,
+                )
+
+            network_stream = self._network_stream
+
+            # CONNECT or Upgrade request
+            if (status == 101) or (
+                (request.method == b"CONNECT") and (200 <= status < 300)
+            ):
+                network_stream = HTTP11UpgradeStream(network_stream, trailing_data)
+
+            return Response(
+                status=status,
+                headers=headers,
+                content=HTTP11ConnectionByteStream(self, request),
+                extensions={
+                    "http_version": http_version,
+                    "reason_phrase": reason_phrase,
+                    "network_stream": network_stream,
+                },
+            )
+        except BaseException as exc:
+            with ShieldCancellation():
+                with Trace("response_closed", logger, request) as trace:
+                    self._response_closed()
+            raise exc
+
+    # Sending the request...
+
+    def _send_request_headers(self, request: Request) -> None:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("write", None)
+
+        with map_exceptions({h11.LocalProtocolError: LocalProtocolError}):
+            event = h11.Request(
+                method=request.method,
+                target=request.url.target,
+                headers=request.headers,
+            )
+        self._send_event(event, timeout=timeout)
+
+    def _send_request_body(self, request: Request) -> None:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("write", None)
+
+        assert isinstance(request.stream, Iterable)
+        for chunk in request.stream:
+            event = h11.Data(data=chunk)
+            self._send_event(event, timeout=timeout)
+
+        self._send_event(h11.EndOfMessage(), timeout=timeout)
+
+    def _send_event(
+        self, event: h11.Event, timeout: Optional[float] = None
+    ) -> None:
+        bytes_to_send = self._h11_state.send(event)
+        if bytes_to_send is not None:
+            self._network_stream.write(bytes_to_send, timeout=timeout)
+
+    # Receiving the response...
+
+    def _receive_response_headers(
+        self, request: Request
+    ) -> Tuple[bytes, int, bytes, List[Tuple[bytes, bytes]], bytes]:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("read", None)
+
+        while True:
+            event = self._receive_event(timeout=timeout)
+            if isinstance(event, h11.Response):
+                break
+            if (
+                isinstance(event, h11.InformationalResponse)
+                and event.status_code == 101
+            ):
+                break
+
+        http_version = b"HTTP/" + event.http_version
+
+        # h11 version 0.11+ supports a `raw_items` interface to get the
+        # raw header casing, rather than the enforced lowercase headers.
+        headers = event.headers.raw_items()
+
+        trailing_data, _ = self._h11_state.trailing_data
+
+        return http_version, event.status_code, event.reason, headers, trailing_data
+
+    def _receive_response_body(self, request: Request) -> Iterator[bytes]:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("read", None)
+
+        while True:
+            event = self._receive_event(timeout=timeout)
+            if isinstance(event, h11.Data):
+                yield bytes(event.data)
+            elif isinstance(event, (h11.EndOfMessage, h11.PAUSED)):
+                break
+
+    def _receive_event(
+        self, timeout: Optional[float] = None
+    ) -> Union[h11.Event, Type[h11.PAUSED]]:
+        while True:
+            with map_exceptions({h11.RemoteProtocolError: RemoteProtocolError}):
+                event = self._h11_state.next_event()
+
+            if event is h11.NEED_DATA:
+                data = self._network_stream.read(
+                    self.READ_NUM_BYTES, timeout=timeout
+                )
+
+                # If we feed this case through h11 we'll raise an exception like:
+                #
+                #     httpcore.RemoteProtocolError: can't handle event type
+                #     ConnectionClosed when role=SERVER and state=SEND_RESPONSE
+                #
+                # Which is accurate, but not very informative from an end-user
+                # perspective. Instead we handle this case distinctly and treat
+                # it as a ConnectError.
+                if data == b"" and self._h11_state.their_state == h11.SEND_RESPONSE:
+                    msg = "Server disconnected without sending a response."
+                    raise RemoteProtocolError(msg)
+
+                self._h11_state.receive_data(data)
+            else:
+                # mypy fails to narrow the type in the above if statement above
+                return event  # type: ignore[return-value]
+
+    def _response_closed(self) -> None:
+        with self._state_lock:
+            if (
+                self._h11_state.our_state is h11.DONE
+                and self._h11_state.their_state is h11.DONE
+            ):
+                self._state = HTTPConnectionState.IDLE
+                self._h11_state.start_next_cycle()
+                if self._keepalive_expiry is not None:
+                    now = time.monotonic()
+                    self._expire_at = now + self._keepalive_expiry
+            else:
+                self.close()
+
+    # Once the connection is no longer required...
+
+    def close(self) -> None:
+        # Note that this method unilaterally closes the connection, and does
+        # not have any kind of locking in place around it.
+        self._state = HTTPConnectionState.CLOSED
+        self._network_stream.close()
+
+    # The ConnectionInterface methods provide information about the state of
+    # the connection, allowing for a connection pooling implementation to
+    # determine when to reuse and when to close the connection...
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        return origin == self._origin
+
+    def is_available(self) -> bool:
+        # Note that HTTP/1.1 connections in the "NEW" state are not treated as
+        # being "available". The control flow which created the connection will
+        # be able to send an outgoing request, but the connection will not be
+        # acquired from the connection pool for any other request.
+        return self._state == HTTPConnectionState.IDLE
+
+    def has_expired(self) -> bool:
+        now = time.monotonic()
+        keepalive_expired = self._expire_at is not None and now > self._expire_at
+
+        # If the HTTP connection is idle but the socket is readable, then the
+        # only valid state is that the socket is about to return b"", indicating
+        # a server-initiated disconnect.
+        server_disconnected = (
+            self._state == HTTPConnectionState.IDLE
+            and self._network_stream.get_extra_info("is_readable")
+        )
+
+        return keepalive_expired or server_disconnected
+
+    def is_idle(self) -> bool:
+        return self._state == HTTPConnectionState.IDLE
+
+    def is_closed(self) -> bool:
+        return self._state == HTTPConnectionState.CLOSED
+
+    def info(self) -> str:
+        origin = str(self._origin)
+        return (
+            f"{origin!r}, HTTP/1.1, {self._state.name}, "
+            f"Request Count: {self._request_count}"
+        )
+
+    def __repr__(self) -> str:
+        class_name = self.__class__.__name__
+        origin = str(self._origin)
+        return (
+            f"<{class_name} [{origin!r}, {self._state.name}, "
+            f"Request Count: {self._request_count}]>"
+        )
+
+    # These context managers are not used in the standard flow, but are
+    # useful for testing or working with connection instances directly.
+
+    def __enter__(self) -> "HTTP11Connection":
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        self.close()
+
+
+class HTTP11ConnectionByteStream:
+    def __init__(self, connection: HTTP11Connection, request: Request) -> None:
+        self._connection = connection
+        self._request = request
+        self._closed = False
+
+    def __iter__(self) -> Iterator[bytes]:
+        kwargs = {"request": self._request}
+        try:
+            with Trace("receive_response_body", logger, self._request, kwargs):
+                for chunk in self._connection._receive_response_body(**kwargs):
+                    yield chunk
+        except BaseException as exc:
+            # If we get an exception while streaming the response,
+            # we want to close the response (and possibly the connection)
+            # before raising that exception.
+            with ShieldCancellation():
+                self.close()
+            raise exc
+
+    def close(self) -> None:
+        if not self._closed:
+            self._closed = True
+            with Trace("response_closed", logger, self._request):
+                self._connection._response_closed()
+
+
+class HTTP11UpgradeStream(NetworkStream):
+    def __init__(self, stream: NetworkStream, leading_data: bytes) -> None:
+        self._stream = stream
+        self._leading_data = leading_data
+
+    def read(self, max_bytes: int, timeout: Optional[float] = None) -> bytes:
+        if self._leading_data:
+            buffer = self._leading_data[:max_bytes]
+            self._leading_data = self._leading_data[max_bytes:]
+            return buffer
+        else:
+            return self._stream.read(max_bytes, timeout)
+
+    def write(self, buffer: bytes, timeout: Optional[float] = None) -> None:
+        self._stream.write(buffer, timeout)
+
+    def close(self) -> None:
+        self._stream.close()
+
+    def start_tls(
+        self,
+        ssl_context: ssl.SSLContext,
+        server_hostname: Optional[str] = None,
+        timeout: Optional[float] = None,
+    ) -> NetworkStream:
+        return self._stream.start_tls(ssl_context, server_hostname, timeout)
+
+    def get_extra_info(self, info: str) -> Any:
+        return self._stream.get_extra_info(info)
diff --git a/llm/Lib/site-packages/httpcore/_sync/http2.py b/llm/Lib/site-packages/httpcore/_sync/http2.py
new file mode 100644
index 0000000000000000000000000000000000000000..1ee4bbb34fe67e4941f8f844850a019f220796c4
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_sync/http2.py
@@ -0,0 +1,589 @@
+import enum
+import logging
+import time
+import types
+import typing
+
+import h2.config
+import h2.connection
+import h2.events
+import h2.exceptions
+import h2.settings
+
+from .._backends.base import NetworkStream
+from .._exceptions import (
+    ConnectionNotAvailable,
+    LocalProtocolError,
+    RemoteProtocolError,
+)
+from .._models import Origin, Request, Response
+from .._synchronization import Lock, Semaphore, ShieldCancellation
+from .._trace import Trace
+from .interfaces import ConnectionInterface
+
+logger = logging.getLogger("httpcore.http2")
+
+
+def has_body_headers(request: Request) -> bool:
+    return any(
+        k.lower() == b"content-length" or k.lower() == b"transfer-encoding"
+        for k, v in request.headers
+    )
+
+
+class HTTPConnectionState(enum.IntEnum):
+    ACTIVE = 1
+    IDLE = 2
+    CLOSED = 3
+
+
+class HTTP2Connection(ConnectionInterface):
+    READ_NUM_BYTES = 64 * 1024
+    CONFIG = h2.config.H2Configuration(validate_inbound_headers=False)
+
+    def __init__(
+        self,
+        origin: Origin,
+        stream: NetworkStream,
+        keepalive_expiry: typing.Optional[float] = None,
+    ):
+        self._origin = origin
+        self._network_stream = stream
+        self._keepalive_expiry: typing.Optional[float] = keepalive_expiry
+        self._h2_state = h2.connection.H2Connection(config=self.CONFIG)
+        self._state = HTTPConnectionState.IDLE
+        self._expire_at: typing.Optional[float] = None
+        self._request_count = 0
+        self._init_lock = Lock()
+        self._state_lock = Lock()
+        self._read_lock = Lock()
+        self._write_lock = Lock()
+        self._sent_connection_init = False
+        self._used_all_stream_ids = False
+        self._connection_error = False
+
+        # Mapping from stream ID to response stream events.
+        self._events: typing.Dict[
+            int,
+            typing.Union[
+                h2.events.ResponseReceived,
+                h2.events.DataReceived,
+                h2.events.StreamEnded,
+                h2.events.StreamReset,
+            ],
+        ] = {}
+
+        # Connection terminated events are stored as state since
+        # we need to handle them for all streams.
+        self._connection_terminated: typing.Optional[h2.events.ConnectionTerminated] = (
+            None
+        )
+
+        self._read_exception: typing.Optional[Exception] = None
+        self._write_exception: typing.Optional[Exception] = None
+
+    def handle_request(self, request: Request) -> Response:
+        if not self.can_handle_request(request.url.origin):
+            # This cannot occur in normal operation, since the connection pool
+            # will only send requests on connections that handle them.
+            # It's in place simply for resilience as a guard against incorrect
+            # usage, for anyone working directly with httpcore connections.
+            raise RuntimeError(
+                f"Attempted to send request to {request.url.origin} on connection "
+                f"to {self._origin}"
+            )
+
+        with self._state_lock:
+            if self._state in (HTTPConnectionState.ACTIVE, HTTPConnectionState.IDLE):
+                self._request_count += 1
+                self._expire_at = None
+                self._state = HTTPConnectionState.ACTIVE
+            else:
+                raise ConnectionNotAvailable()
+
+        with self._init_lock:
+            if not self._sent_connection_init:
+                try:
+                    kwargs = {"request": request}
+                    with Trace("send_connection_init", logger, request, kwargs):
+                        self._send_connection_init(**kwargs)
+                except BaseException as exc:
+                    with ShieldCancellation():
+                        self.close()
+                    raise exc
+
+                self._sent_connection_init = True
+
+                # Initially start with just 1 until the remote server provides
+                # its max_concurrent_streams value
+                self._max_streams = 1
+
+                local_settings_max_streams = (
+                    self._h2_state.local_settings.max_concurrent_streams
+                )
+                self._max_streams_semaphore = Semaphore(local_settings_max_streams)
+
+                for _ in range(local_settings_max_streams - self._max_streams):
+                    self._max_streams_semaphore.acquire()
+
+        self._max_streams_semaphore.acquire()
+
+        try:
+            stream_id = self._h2_state.get_next_available_stream_id()
+            self._events[stream_id] = []
+        except h2.exceptions.NoAvailableStreamIDError:  # pragma: nocover
+            self._used_all_stream_ids = True
+            self._request_count -= 1
+            raise ConnectionNotAvailable()
+
+        try:
+            kwargs = {"request": request, "stream_id": stream_id}
+            with Trace("send_request_headers", logger, request, kwargs):
+                self._send_request_headers(request=request, stream_id=stream_id)
+            with Trace("send_request_body", logger, request, kwargs):
+                self._send_request_body(request=request, stream_id=stream_id)
+            with Trace(
+                "receive_response_headers", logger, request, kwargs
+            ) as trace:
+                status, headers = self._receive_response(
+                    request=request, stream_id=stream_id
+                )
+                trace.return_value = (status, headers)
+
+            return Response(
+                status=status,
+                headers=headers,
+                content=HTTP2ConnectionByteStream(self, request, stream_id=stream_id),
+                extensions={
+                    "http_version": b"HTTP/2",
+                    "network_stream": self._network_stream,
+                    "stream_id": stream_id,
+                },
+            )
+        except BaseException as exc:  # noqa: PIE786
+            with ShieldCancellation():
+                kwargs = {"stream_id": stream_id}
+                with Trace("response_closed", logger, request, kwargs):
+                    self._response_closed(stream_id=stream_id)
+
+            if isinstance(exc, h2.exceptions.ProtocolError):
+                # One case where h2 can raise a protocol error is when a
+                # closed frame has been seen by the state machine.
+                #
+                # This happens when one stream is reading, and encounters
+                # a GOAWAY event. Other flows of control may then raise
+                # a protocol error at any point they interact with the 'h2_state'.
+                #
+                # In this case we'll have stored the event, and should raise
+                # it as a RemoteProtocolError.
+                if self._connection_terminated:  # pragma: nocover
+                    raise RemoteProtocolError(self._connection_terminated)
+                # If h2 raises a protocol error in some other state then we
+                # must somehow have made a protocol violation.
+                raise LocalProtocolError(exc)  # pragma: nocover
+
+            raise exc
+
+    def _send_connection_init(self, request: Request) -> None:
+        """
+        The HTTP/2 connection requires some initial setup before we can start
+        using individual request/response streams on it.
+        """
+        # Need to set these manually here instead of manipulating via
+        # __setitem__() otherwise the H2Connection will emit SettingsUpdate
+        # frames in addition to sending the undesired defaults.
+        self._h2_state.local_settings = h2.settings.Settings(
+            client=True,
+            initial_values={
+                # Disable PUSH_PROMISE frames from the server since we don't do anything
+                # with them for now.  Maybe when we support caching?
+                h2.settings.SettingCodes.ENABLE_PUSH: 0,
+                # These two are taken from h2 for safe defaults
+                h2.settings.SettingCodes.MAX_CONCURRENT_STREAMS: 100,
+                h2.settings.SettingCodes.MAX_HEADER_LIST_SIZE: 65536,
+            },
+        )
+
+        # Some websites (*cough* Yahoo *cough*) balk at this setting being
+        # present in the initial handshake since it's not defined in the original
+        # RFC despite the RFC mandating ignoring settings you don't know about.
+        del self._h2_state.local_settings[
+            h2.settings.SettingCodes.ENABLE_CONNECT_PROTOCOL
+        ]
+
+        self._h2_state.initiate_connection()
+        self._h2_state.increment_flow_control_window(2**24)
+        self._write_outgoing_data(request)
+
+    # Sending the request...
+
+    def _send_request_headers(self, request: Request, stream_id: int) -> None:
+        """
+        Send the request headers to a given stream ID.
+        """
+        end_stream = not has_body_headers(request)
+
+        # In HTTP/2 the ':authority' pseudo-header is used instead of 'Host'.
+        # In order to gracefully handle HTTP/1.1 and HTTP/2 we always require
+        # HTTP/1.1 style headers, and map them appropriately if we end up on
+        # an HTTP/2 connection.
+        authority = [v for k, v in request.headers if k.lower() == b"host"][0]
+
+        headers = [
+            (b":method", request.method),
+            (b":authority", authority),
+            (b":scheme", request.url.scheme),
+            (b":path", request.url.target),
+        ] + [
+            (k.lower(), v)
+            for k, v in request.headers
+            if k.lower()
+            not in (
+                b"host",
+                b"transfer-encoding",
+            )
+        ]
+
+        self._h2_state.send_headers(stream_id, headers, end_stream=end_stream)
+        self._h2_state.increment_flow_control_window(2**24, stream_id=stream_id)
+        self._write_outgoing_data(request)
+
+    def _send_request_body(self, request: Request, stream_id: int) -> None:
+        """
+        Iterate over the request body sending it to a given stream ID.
+        """
+        if not has_body_headers(request):
+            return
+
+        assert isinstance(request.stream, typing.Iterable)
+        for data in request.stream:
+            self._send_stream_data(request, stream_id, data)
+        self._send_end_stream(request, stream_id)
+
+    def _send_stream_data(
+        self, request: Request, stream_id: int, data: bytes
+    ) -> None:
+        """
+        Send a single chunk of data in one or more data frames.
+        """
+        while data:
+            max_flow = self._wait_for_outgoing_flow(request, stream_id)
+            chunk_size = min(len(data), max_flow)
+            chunk, data = data[:chunk_size], data[chunk_size:]
+            self._h2_state.send_data(stream_id, chunk)
+            self._write_outgoing_data(request)
+
+    def _send_end_stream(self, request: Request, stream_id: int) -> None:
+        """
+        Send an empty data frame on on a given stream ID with the END_STREAM flag set.
+        """
+        self._h2_state.end_stream(stream_id)
+        self._write_outgoing_data(request)
+
+    # Receiving the response...
+
+    def _receive_response(
+        self, request: Request, stream_id: int
+    ) -> typing.Tuple[int, typing.List[typing.Tuple[bytes, bytes]]]:
+        """
+        Return the response status code and headers for a given stream ID.
+        """
+        while True:
+            event = self._receive_stream_event(request, stream_id)
+            if isinstance(event, h2.events.ResponseReceived):
+                break
+
+        status_code = 200
+        headers = []
+        for k, v in event.headers:
+            if k == b":status":
+                status_code = int(v.decode("ascii", errors="ignore"))
+            elif not k.startswith(b":"):
+                headers.append((k, v))
+
+        return (status_code, headers)
+
+    def _receive_response_body(
+        self, request: Request, stream_id: int
+    ) -> typing.Iterator[bytes]:
+        """
+        Iterator that returns the bytes of the response body for a given stream ID.
+        """
+        while True:
+            event = self._receive_stream_event(request, stream_id)
+            if isinstance(event, h2.events.DataReceived):
+                amount = event.flow_controlled_length
+                self._h2_state.acknowledge_received_data(amount, stream_id)
+                self._write_outgoing_data(request)
+                yield event.data
+            elif isinstance(event, h2.events.StreamEnded):
+                break
+
+    def _receive_stream_event(
+        self, request: Request, stream_id: int
+    ) -> typing.Union[
+        h2.events.ResponseReceived, h2.events.DataReceived, h2.events.StreamEnded
+    ]:
+        """
+        Return the next available event for a given stream ID.
+
+        Will read more data from the network if required.
+        """
+        while not self._events.get(stream_id):
+            self._receive_events(request, stream_id)
+        event = self._events[stream_id].pop(0)
+        if isinstance(event, h2.events.StreamReset):
+            raise RemoteProtocolError(event)
+        return event
+
+    def _receive_events(
+        self, request: Request, stream_id: typing.Optional[int] = None
+    ) -> None:
+        """
+        Read some data from the network until we see one or more events
+        for a given stream ID.
+        """
+        with self._read_lock:
+            if self._connection_terminated is not None:
+                last_stream_id = self._connection_terminated.last_stream_id
+                if stream_id and last_stream_id and stream_id > last_stream_id:
+                    self._request_count -= 1
+                    raise ConnectionNotAvailable()
+                raise RemoteProtocolError(self._connection_terminated)
+
+            # This conditional is a bit icky. We don't want to block reading if we've
+            # actually got an event to return for a given stream. We need to do that
+            # check *within* the atomic read lock. Though it also need to be optional,
+            # because when we call it from `_wait_for_outgoing_flow` we *do* want to
+            # block until we've available flow control, event when we have events
+            # pending for the stream ID we're attempting to send on.
+            if stream_id is None or not self._events.get(stream_id):
+                events = self._read_incoming_data(request)
+                for event in events:
+                    if isinstance(event, h2.events.RemoteSettingsChanged):
+                        with Trace(
+                            "receive_remote_settings", logger, request
+                        ) as trace:
+                            self._receive_remote_settings_change(event)
+                            trace.return_value = event
+
+                    elif isinstance(
+                        event,
+                        (
+                            h2.events.ResponseReceived,
+                            h2.events.DataReceived,
+                            h2.events.StreamEnded,
+                            h2.events.StreamReset,
+                        ),
+                    ):
+                        if event.stream_id in self._events:
+                            self._events[event.stream_id].append(event)
+
+                    elif isinstance(event, h2.events.ConnectionTerminated):
+                        self._connection_terminated = event
+
+        self._write_outgoing_data(request)
+
+    def _receive_remote_settings_change(self, event: h2.events.Event) -> None:
+        max_concurrent_streams = event.changed_settings.get(
+            h2.settings.SettingCodes.MAX_CONCURRENT_STREAMS
+        )
+        if max_concurrent_streams:
+            new_max_streams = min(
+                max_concurrent_streams.new_value,
+                self._h2_state.local_settings.max_concurrent_streams,
+            )
+            if new_max_streams and new_max_streams != self._max_streams:
+                while new_max_streams > self._max_streams:
+                    self._max_streams_semaphore.release()
+                    self._max_streams += 1
+                while new_max_streams < self._max_streams:
+                    self._max_streams_semaphore.acquire()
+                    self._max_streams -= 1
+
+    def _response_closed(self, stream_id: int) -> None:
+        self._max_streams_semaphore.release()
+        del self._events[stream_id]
+        with self._state_lock:
+            if self._connection_terminated and not self._events:
+                self.close()
+
+            elif self._state == HTTPConnectionState.ACTIVE and not self._events:
+                self._state = HTTPConnectionState.IDLE
+                if self._keepalive_expiry is not None:
+                    now = time.monotonic()
+                    self._expire_at = now + self._keepalive_expiry
+                if self._used_all_stream_ids:  # pragma: nocover
+                    self.close()
+
+    def close(self) -> None:
+        # Note that this method unilaterally closes the connection, and does
+        # not have any kind of locking in place around it.
+        self._h2_state.close_connection()
+        self._state = HTTPConnectionState.CLOSED
+        self._network_stream.close()
+
+    # Wrappers around network read/write operations...
+
+    def _read_incoming_data(
+        self, request: Request
+    ) -> typing.List[h2.events.Event]:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("read", None)
+
+        if self._read_exception is not None:
+            raise self._read_exception  # pragma: nocover
+
+        try:
+            data = self._network_stream.read(self.READ_NUM_BYTES, timeout)
+            if data == b"":
+                raise RemoteProtocolError("Server disconnected")
+        except Exception as exc:
+            # If we get a network error we should:
+            #
+            # 1. Save the exception and just raise it immediately on any future reads.
+            #    (For example, this means that a single read timeout or disconnect will
+            #    immediately close all pending streams. Without requiring multiple
+            #    sequential timeouts.)
+            # 2. Mark the connection as errored, so that we don't accept any other
+            #    incoming requests.
+            self._read_exception = exc
+            self._connection_error = True
+            raise exc
+
+        events: typing.List[h2.events.Event] = self._h2_state.receive_data(data)
+
+        return events
+
+    def _write_outgoing_data(self, request: Request) -> None:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("write", None)
+
+        with self._write_lock:
+            data_to_send = self._h2_state.data_to_send()
+
+            if self._write_exception is not None:
+                raise self._write_exception  # pragma: nocover
+
+            try:
+                self._network_stream.write(data_to_send, timeout)
+            except Exception as exc:  # pragma: nocover
+                # If we get a network error we should:
+                #
+                # 1. Save the exception and just raise it immediately on any future write.
+                #    (For example, this means that a single write timeout or disconnect will
+                #    immediately close all pending streams. Without requiring multiple
+                #    sequential timeouts.)
+                # 2. Mark the connection as errored, so that we don't accept any other
+                #    incoming requests.
+                self._write_exception = exc
+                self._connection_error = True
+                raise exc
+
+    # Flow control...
+
+    def _wait_for_outgoing_flow(self, request: Request, stream_id: int) -> int:
+        """
+        Returns the maximum allowable outgoing flow for a given stream.
+
+        If the allowable flow is zero, then waits on the network until
+        WindowUpdated frames have increased the flow rate.
+        https://tools.ietf.org/html/rfc7540#section-6.9
+        """
+        local_flow: int = self._h2_state.local_flow_control_window(stream_id)
+        max_frame_size: int = self._h2_state.max_outbound_frame_size
+        flow = min(local_flow, max_frame_size)
+        while flow == 0:
+            self._receive_events(request)
+            local_flow = self._h2_state.local_flow_control_window(stream_id)
+            max_frame_size = self._h2_state.max_outbound_frame_size
+            flow = min(local_flow, max_frame_size)
+        return flow
+
+    # Interface for connection pooling...
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        return origin == self._origin
+
+    def is_available(self) -> bool:
+        return (
+            self._state != HTTPConnectionState.CLOSED
+            and not self._connection_error
+            and not self._used_all_stream_ids
+            and not (
+                self._h2_state.state_machine.state
+                == h2.connection.ConnectionState.CLOSED
+            )
+        )
+
+    def has_expired(self) -> bool:
+        now = time.monotonic()
+        return self._expire_at is not None and now > self._expire_at
+
+    def is_idle(self) -> bool:
+        return self._state == HTTPConnectionState.IDLE
+
+    def is_closed(self) -> bool:
+        return self._state == HTTPConnectionState.CLOSED
+
+    def info(self) -> str:
+        origin = str(self._origin)
+        return (
+            f"{origin!r}, HTTP/2, {self._state.name}, "
+            f"Request Count: {self._request_count}"
+        )
+
+    def __repr__(self) -> str:
+        class_name = self.__class__.__name__
+        origin = str(self._origin)
+        return (
+            f"<{class_name} [{origin!r}, {self._state.name}, "
+            f"Request Count: {self._request_count}]>"
+        )
+
+    # These context managers are not used in the standard flow, but are
+    # useful for testing or working with connection instances directly.
+
+    def __enter__(self) -> "HTTP2Connection":
+        return self
+
+    def __exit__(
+        self,
+        exc_type: typing.Optional[typing.Type[BaseException]] = None,
+        exc_value: typing.Optional[BaseException] = None,
+        traceback: typing.Optional[types.TracebackType] = None,
+    ) -> None:
+        self.close()
+
+
+class HTTP2ConnectionByteStream:
+    def __init__(
+        self, connection: HTTP2Connection, request: Request, stream_id: int
+    ) -> None:
+        self._connection = connection
+        self._request = request
+        self._stream_id = stream_id
+        self._closed = False
+
+    def __iter__(self) -> typing.Iterator[bytes]:
+        kwargs = {"request": self._request, "stream_id": self._stream_id}
+        try:
+            with Trace("receive_response_body", logger, self._request, kwargs):
+                for chunk in self._connection._receive_response_body(
+                    request=self._request, stream_id=self._stream_id
+                ):
+                    yield chunk
+        except BaseException as exc:
+            # If we get an exception while streaming the response,
+            # we want to close the response (and possibly the connection)
+            # before raising that exception.
+            with ShieldCancellation():
+                self.close()
+            raise exc
+
+    def close(self) -> None:
+        if not self._closed:
+            self._closed = True
+            kwargs = {"stream_id": self._stream_id}
+            with Trace("response_closed", logger, self._request, kwargs):
+                self._connection._response_closed(stream_id=self._stream_id)
diff --git a/llm/Lib/site-packages/httpcore/_sync/http_proxy.py b/llm/Lib/site-packages/httpcore/_sync/http_proxy.py
new file mode 100644
index 0000000000000000000000000000000000000000..6acac9a7cd52e255b93e15c7f56ed2f9a79c2310
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_sync/http_proxy.py
@@ -0,0 +1,368 @@
+import logging
+import ssl
+from base64 import b64encode
+from typing import Iterable, List, Mapping, Optional, Sequence, Tuple, Union
+
+from .._backends.base import SOCKET_OPTION, NetworkBackend
+from .._exceptions import ProxyError
+from .._models import (
+    URL,
+    Origin,
+    Request,
+    Response,
+    enforce_bytes,
+    enforce_headers,
+    enforce_url,
+)
+from .._ssl import default_ssl_context
+from .._synchronization import Lock
+from .._trace import Trace
+from .connection import HTTPConnection
+from .connection_pool import ConnectionPool
+from .http11 import HTTP11Connection
+from .interfaces import ConnectionInterface
+
+HeadersAsSequence = Sequence[Tuple[Union[bytes, str], Union[bytes, str]]]
+HeadersAsMapping = Mapping[Union[bytes, str], Union[bytes, str]]
+
+
+logger = logging.getLogger("httpcore.proxy")
+
+
+def merge_headers(
+    default_headers: Optional[Sequence[Tuple[bytes, bytes]]] = None,
+    override_headers: Optional[Sequence[Tuple[bytes, bytes]]] = None,
+) -> List[Tuple[bytes, bytes]]:
+    """
+    Append default_headers and override_headers, de-duplicating if a key exists
+    in both cases.
+    """
+    default_headers = [] if default_headers is None else list(default_headers)
+    override_headers = [] if override_headers is None else list(override_headers)
+    has_override = set(key.lower() for key, value in override_headers)
+    default_headers = [
+        (key, value)
+        for key, value in default_headers
+        if key.lower() not in has_override
+    ]
+    return default_headers + override_headers
+
+
+def build_auth_header(username: bytes, password: bytes) -> bytes:
+    userpass = username + b":" + password
+    return b"Basic " + b64encode(userpass)
+
+
+class HTTPProxy(ConnectionPool):
+    """
+    A connection pool that sends requests via an HTTP proxy.
+    """
+
+    def __init__(
+        self,
+        proxy_url: Union[URL, bytes, str],
+        proxy_auth: Optional[Tuple[Union[bytes, str], Union[bytes, str]]] = None,
+        proxy_headers: Union[HeadersAsMapping, HeadersAsSequence, None] = None,
+        ssl_context: Optional[ssl.SSLContext] = None,
+        proxy_ssl_context: Optional[ssl.SSLContext] = None,
+        max_connections: Optional[int] = 10,
+        max_keepalive_connections: Optional[int] = None,
+        keepalive_expiry: Optional[float] = None,
+        http1: bool = True,
+        http2: bool = False,
+        retries: int = 0,
+        local_address: Optional[str] = None,
+        uds: Optional[str] = None,
+        network_backend: Optional[NetworkBackend] = None,
+        socket_options: Optional[Iterable[SOCKET_OPTION]] = None,
+    ) -> None:
+        """
+        A connection pool for making HTTP requests.
+
+        Parameters:
+            proxy_url: The URL to use when connecting to the proxy server.
+                For example `"http://127.0.0.1:8080/"`.
+            proxy_auth: Any proxy authentication as a two-tuple of
+                (username, password). May be either bytes or ascii-only str.
+            proxy_headers: Any HTTP headers to use for the proxy requests.
+                For example `{"Proxy-Authorization": "Basic <username>:<password>"}`.
+            ssl_context: An SSL context to use for verifying connections.
+                If not specified, the default `httpcore.default_ssl_context()`
+                will be used.
+            proxy_ssl_context: The same as `ssl_context`, but for a proxy server rather than a remote origin.
+            max_connections: The maximum number of concurrent HTTP connections that
+                the pool should allow. Any attempt to send a request on a pool that
+                would exceed this amount will block until a connection is available.
+            max_keepalive_connections: The maximum number of idle HTTP connections
+                that will be maintained in the pool.
+            keepalive_expiry: The duration in seconds that an idle HTTP connection
+                may be maintained for before being expired from the pool.
+            http1: A boolean indicating if HTTP/1.1 requests should be supported
+                by the connection pool. Defaults to True.
+            http2: A boolean indicating if HTTP/2 requests should be supported by
+                the connection pool. Defaults to False.
+            retries: The maximum number of retries when trying to establish
+                a connection.
+            local_address: Local address to connect from. Can also be used to
+                connect using a particular address family. Using
+                `local_address="0.0.0.0"` will connect using an `AF_INET` address
+                (IPv4), while using `local_address="::"` will connect using an
+                `AF_INET6` address (IPv6).
+            uds: Path to a Unix Domain Socket to use instead of TCP sockets.
+            network_backend: A backend instance to use for handling network I/O.
+        """
+        super().__init__(
+            ssl_context=ssl_context,
+            max_connections=max_connections,
+            max_keepalive_connections=max_keepalive_connections,
+            keepalive_expiry=keepalive_expiry,
+            http1=http1,
+            http2=http2,
+            network_backend=network_backend,
+            retries=retries,
+            local_address=local_address,
+            uds=uds,
+            socket_options=socket_options,
+        )
+
+        self._proxy_url = enforce_url(proxy_url, name="proxy_url")
+        if (
+            self._proxy_url.scheme == b"http" and proxy_ssl_context is not None
+        ):  # pragma: no cover
+            raise RuntimeError(
+                "The `proxy_ssl_context` argument is not allowed for the http scheme"
+            )
+
+        self._ssl_context = ssl_context
+        self._proxy_ssl_context = proxy_ssl_context
+        self._proxy_headers = enforce_headers(proxy_headers, name="proxy_headers")
+        if proxy_auth is not None:
+            username = enforce_bytes(proxy_auth[0], name="proxy_auth")
+            password = enforce_bytes(proxy_auth[1], name="proxy_auth")
+            authorization = build_auth_header(username, password)
+            self._proxy_headers = [
+                (b"Proxy-Authorization", authorization)
+            ] + self._proxy_headers
+
+    def create_connection(self, origin: Origin) -> ConnectionInterface:
+        if origin.scheme == b"http":
+            return ForwardHTTPConnection(
+                proxy_origin=self._proxy_url.origin,
+                proxy_headers=self._proxy_headers,
+                remote_origin=origin,
+                keepalive_expiry=self._keepalive_expiry,
+                network_backend=self._network_backend,
+                proxy_ssl_context=self._proxy_ssl_context,
+            )
+        return TunnelHTTPConnection(
+            proxy_origin=self._proxy_url.origin,
+            proxy_headers=self._proxy_headers,
+            remote_origin=origin,
+            ssl_context=self._ssl_context,
+            proxy_ssl_context=self._proxy_ssl_context,
+            keepalive_expiry=self._keepalive_expiry,
+            http1=self._http1,
+            http2=self._http2,
+            network_backend=self._network_backend,
+        )
+
+
+class ForwardHTTPConnection(ConnectionInterface):
+    def __init__(
+        self,
+        proxy_origin: Origin,
+        remote_origin: Origin,
+        proxy_headers: Union[HeadersAsMapping, HeadersAsSequence, None] = None,
+        keepalive_expiry: Optional[float] = None,
+        network_backend: Optional[NetworkBackend] = None,
+        socket_options: Optional[Iterable[SOCKET_OPTION]] = None,
+        proxy_ssl_context: Optional[ssl.SSLContext] = None,
+    ) -> None:
+        self._connection = HTTPConnection(
+            origin=proxy_origin,
+            keepalive_expiry=keepalive_expiry,
+            network_backend=network_backend,
+            socket_options=socket_options,
+            ssl_context=proxy_ssl_context,
+        )
+        self._proxy_origin = proxy_origin
+        self._proxy_headers = enforce_headers(proxy_headers, name="proxy_headers")
+        self._remote_origin = remote_origin
+
+    def handle_request(self, request: Request) -> Response:
+        headers = merge_headers(self._proxy_headers, request.headers)
+        url = URL(
+            scheme=self._proxy_origin.scheme,
+            host=self._proxy_origin.host,
+            port=self._proxy_origin.port,
+            target=bytes(request.url),
+        )
+        proxy_request = Request(
+            method=request.method,
+            url=url,
+            headers=headers,
+            content=request.stream,
+            extensions=request.extensions,
+        )
+        return self._connection.handle_request(proxy_request)
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        return origin == self._remote_origin
+
+    def close(self) -> None:
+        self._connection.close()
+
+    def info(self) -> str:
+        return self._connection.info()
+
+    def is_available(self) -> bool:
+        return self._connection.is_available()
+
+    def has_expired(self) -> bool:
+        return self._connection.has_expired()
+
+    def is_idle(self) -> bool:
+        return self._connection.is_idle()
+
+    def is_closed(self) -> bool:
+        return self._connection.is_closed()
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} [{self.info()}]>"
+
+
+class TunnelHTTPConnection(ConnectionInterface):
+    def __init__(
+        self,
+        proxy_origin: Origin,
+        remote_origin: Origin,
+        ssl_context: Optional[ssl.SSLContext] = None,
+        proxy_ssl_context: Optional[ssl.SSLContext] = None,
+        proxy_headers: Optional[Sequence[Tuple[bytes, bytes]]] = None,
+        keepalive_expiry: Optional[float] = None,
+        http1: bool = True,
+        http2: bool = False,
+        network_backend: Optional[NetworkBackend] = None,
+        socket_options: Optional[Iterable[SOCKET_OPTION]] = None,
+    ) -> None:
+        self._connection: ConnectionInterface = HTTPConnection(
+            origin=proxy_origin,
+            keepalive_expiry=keepalive_expiry,
+            network_backend=network_backend,
+            socket_options=socket_options,
+            ssl_context=proxy_ssl_context,
+        )
+        self._proxy_origin = proxy_origin
+        self._remote_origin = remote_origin
+        self._ssl_context = ssl_context
+        self._proxy_ssl_context = proxy_ssl_context
+        self._proxy_headers = enforce_headers(proxy_headers, name="proxy_headers")
+        self._keepalive_expiry = keepalive_expiry
+        self._http1 = http1
+        self._http2 = http2
+        self._connect_lock = Lock()
+        self._connected = False
+
+    def handle_request(self, request: Request) -> Response:
+        timeouts = request.extensions.get("timeout", {})
+        timeout = timeouts.get("connect", None)
+
+        with self._connect_lock:
+            if not self._connected:
+                target = b"%b:%d" % (self._remote_origin.host, self._remote_origin.port)
+
+                connect_url = URL(
+                    scheme=self._proxy_origin.scheme,
+                    host=self._proxy_origin.host,
+                    port=self._proxy_origin.port,
+                    target=target,
+                )
+                connect_headers = merge_headers(
+                    [(b"Host", target), (b"Accept", b"*/*")], self._proxy_headers
+                )
+                connect_request = Request(
+                    method=b"CONNECT",
+                    url=connect_url,
+                    headers=connect_headers,
+                    extensions=request.extensions,
+                )
+                connect_response = self._connection.handle_request(
+                    connect_request
+                )
+
+                if connect_response.status < 200 or connect_response.status > 299:
+                    reason_bytes = connect_response.extensions.get("reason_phrase", b"")
+                    reason_str = reason_bytes.decode("ascii", errors="ignore")
+                    msg = "%d %s" % (connect_response.status, reason_str)
+                    self._connection.close()
+                    raise ProxyError(msg)
+
+                stream = connect_response.extensions["network_stream"]
+
+                # Upgrade the stream to SSL
+                ssl_context = (
+                    default_ssl_context()
+                    if self._ssl_context is None
+                    else self._ssl_context
+                )
+                alpn_protocols = ["http/1.1", "h2"] if self._http2 else ["http/1.1"]
+                ssl_context.set_alpn_protocols(alpn_protocols)
+
+                kwargs = {
+                    "ssl_context": ssl_context,
+                    "server_hostname": self._remote_origin.host.decode("ascii"),
+                    "timeout": timeout,
+                }
+                with Trace("start_tls", logger, request, kwargs) as trace:
+                    stream = stream.start_tls(**kwargs)
+                    trace.return_value = stream
+
+                # Determine if we should be using HTTP/1.1 or HTTP/2
+                ssl_object = stream.get_extra_info("ssl_object")
+                http2_negotiated = (
+                    ssl_object is not None
+                    and ssl_object.selected_alpn_protocol() == "h2"
+                )
+
+                # Create the HTTP/1.1 or HTTP/2 connection
+                if http2_negotiated or (self._http2 and not self._http1):
+                    from .http2 import HTTP2Connection
+
+                    self._connection = HTTP2Connection(
+                        origin=self._remote_origin,
+                        stream=stream,
+                        keepalive_expiry=self._keepalive_expiry,
+                    )
+                else:
+                    self._connection = HTTP11Connection(
+                        origin=self._remote_origin,
+                        stream=stream,
+                        keepalive_expiry=self._keepalive_expiry,
+                    )
+
+                self._connected = True
+        return self._connection.handle_request(request)
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        return origin == self._remote_origin
+
+    def close(self) -> None:
+        self._connection.close()
+
+    def info(self) -> str:
+        return self._connection.info()
+
+    def is_available(self) -> bool:
+        return self._connection.is_available()
+
+    def has_expired(self) -> bool:
+        return self._connection.has_expired()
+
+    def is_idle(self) -> bool:
+        return self._connection.is_idle()
+
+    def is_closed(self) -> bool:
+        return self._connection.is_closed()
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} [{self.info()}]>"
diff --git a/llm/Lib/site-packages/httpcore/_sync/interfaces.py b/llm/Lib/site-packages/httpcore/_sync/interfaces.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e95be1ec72425178245c32c33874303e0906405
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_sync/interfaces.py
@@ -0,0 +1,135 @@
+from contextlib import contextmanager
+from typing import Iterator, Optional, Union
+
+from .._models import (
+    URL,
+    Extensions,
+    HeaderTypes,
+    Origin,
+    Request,
+    Response,
+    enforce_bytes,
+    enforce_headers,
+    enforce_url,
+    include_request_headers,
+)
+
+
+class RequestInterface:
+    def request(
+        self,
+        method: Union[bytes, str],
+        url: Union[URL, bytes, str],
+        *,
+        headers: HeaderTypes = None,
+        content: Union[bytes, Iterator[bytes], None] = None,
+        extensions: Optional[Extensions] = None,
+    ) -> Response:
+        # Strict type checking on our parameters.
+        method = enforce_bytes(method, name="method")
+        url = enforce_url(url, name="url")
+        headers = enforce_headers(headers, name="headers")
+
+        # Include Host header, and optionally Content-Length or Transfer-Encoding.
+        headers = include_request_headers(headers, url=url, content=content)
+
+        request = Request(
+            method=method,
+            url=url,
+            headers=headers,
+            content=content,
+            extensions=extensions,
+        )
+        response = self.handle_request(request)
+        try:
+            response.read()
+        finally:
+            response.close()
+        return response
+
+    @contextmanager
+    def stream(
+        self,
+        method: Union[bytes, str],
+        url: Union[URL, bytes, str],
+        *,
+        headers: HeaderTypes = None,
+        content: Union[bytes, Iterator[bytes], None] = None,
+        extensions: Optional[Extensions] = None,
+    ) -> Iterator[Response]:
+        # Strict type checking on our parameters.
+        method = enforce_bytes(method, name="method")
+        url = enforce_url(url, name="url")
+        headers = enforce_headers(headers, name="headers")
+
+        # Include Host header, and optionally Content-Length or Transfer-Encoding.
+        headers = include_request_headers(headers, url=url, content=content)
+
+        request = Request(
+            method=method,
+            url=url,
+            headers=headers,
+            content=content,
+            extensions=extensions,
+        )
+        response = self.handle_request(request)
+        try:
+            yield response
+        finally:
+            response.close()
+
+    def handle_request(self, request: Request) -> Response:
+        raise NotImplementedError()  # pragma: nocover
+
+
+class ConnectionInterface(RequestInterface):
+    def close(self) -> None:
+        raise NotImplementedError()  # pragma: nocover
+
+    def info(self) -> str:
+        raise NotImplementedError()  # pragma: nocover
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        raise NotImplementedError()  # pragma: nocover
+
+    def is_available(self) -> bool:
+        """
+        Return `True` if the connection is currently able to accept an
+        outgoing request.
+
+        An HTTP/1.1 connection will only be available if it is currently idle.
+
+        An HTTP/2 connection will be available so long as the stream ID space is
+        not yet exhausted, and the connection is not in an error state.
+
+        While the connection is being established we may not yet know if it is going
+        to result in an HTTP/1.1 or HTTP/2 connection. The connection should be
+        treated as being available, but might ultimately raise `NewConnectionRequired`
+        required exceptions if multiple requests are attempted over a connection
+        that ends up being established as HTTP/1.1.
+        """
+        raise NotImplementedError()  # pragma: nocover
+
+    def has_expired(self) -> bool:
+        """
+        Return `True` if the connection is in a state where it should be closed.
+
+        This either means that the connection is idle and it has passed the
+        expiry time on its keep-alive, or that server has sent an EOF.
+        """
+        raise NotImplementedError()  # pragma: nocover
+
+    def is_idle(self) -> bool:
+        """
+        Return `True` if the connection is currently idle.
+        """
+        raise NotImplementedError()  # pragma: nocover
+
+    def is_closed(self) -> bool:
+        """
+        Return `True` if the connection has been closed.
+
+        Used when a response is closed to determine if the connection may be
+        returned to the connection pool or not.
+        """
+        raise NotImplementedError()  # pragma: nocover
diff --git a/llm/Lib/site-packages/httpcore/_sync/socks_proxy.py b/llm/Lib/site-packages/httpcore/_sync/socks_proxy.py
new file mode 100644
index 0000000000000000000000000000000000000000..502e4d7fef2cae864ad29c869217b5a2e72c2951
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_sync/socks_proxy.py
@@ -0,0 +1,342 @@
+import logging
+import ssl
+import typing
+
+from socksio import socks5
+
+from .._backends.sync import SyncBackend
+from .._backends.base import NetworkBackend, NetworkStream
+from .._exceptions import ConnectionNotAvailable, ProxyError
+from .._models import URL, Origin, Request, Response, enforce_bytes, enforce_url
+from .._ssl import default_ssl_context
+from .._synchronization import Lock
+from .._trace import Trace
+from .connection_pool import ConnectionPool
+from .http11 import HTTP11Connection
+from .interfaces import ConnectionInterface
+
+logger = logging.getLogger("httpcore.socks")
+
+
+AUTH_METHODS = {
+    b"\x00": "NO AUTHENTICATION REQUIRED",
+    b"\x01": "GSSAPI",
+    b"\x02": "USERNAME/PASSWORD",
+    b"\xff": "NO ACCEPTABLE METHODS",
+}
+
+REPLY_CODES = {
+    b"\x00": "Succeeded",
+    b"\x01": "General SOCKS server failure",
+    b"\x02": "Connection not allowed by ruleset",
+    b"\x03": "Network unreachable",
+    b"\x04": "Host unreachable",
+    b"\x05": "Connection refused",
+    b"\x06": "TTL expired",
+    b"\x07": "Command not supported",
+    b"\x08": "Address type not supported",
+}
+
+
+def _init_socks5_connection(
+    stream: NetworkStream,
+    *,
+    host: bytes,
+    port: int,
+    auth: typing.Optional[typing.Tuple[bytes, bytes]] = None,
+) -> None:
+    conn = socks5.SOCKS5Connection()
+
+    # Auth method request
+    auth_method = (
+        socks5.SOCKS5AuthMethod.NO_AUTH_REQUIRED
+        if auth is None
+        else socks5.SOCKS5AuthMethod.USERNAME_PASSWORD
+    )
+    conn.send(socks5.SOCKS5AuthMethodsRequest([auth_method]))
+    outgoing_bytes = conn.data_to_send()
+    stream.write(outgoing_bytes)
+
+    # Auth method response
+    incoming_bytes = stream.read(max_bytes=4096)
+    response = conn.receive_data(incoming_bytes)
+    assert isinstance(response, socks5.SOCKS5AuthReply)
+    if response.method != auth_method:
+        requested = AUTH_METHODS.get(auth_method, "UNKNOWN")
+        responded = AUTH_METHODS.get(response.method, "UNKNOWN")
+        raise ProxyError(
+            f"Requested {requested} from proxy server, but got {responded}."
+        )
+
+    if response.method == socks5.SOCKS5AuthMethod.USERNAME_PASSWORD:
+        # Username/password request
+        assert auth is not None
+        username, password = auth
+        conn.send(socks5.SOCKS5UsernamePasswordRequest(username, password))
+        outgoing_bytes = conn.data_to_send()
+        stream.write(outgoing_bytes)
+
+        # Username/password response
+        incoming_bytes = stream.read(max_bytes=4096)
+        response = conn.receive_data(incoming_bytes)
+        assert isinstance(response, socks5.SOCKS5UsernamePasswordReply)
+        if not response.success:
+            raise ProxyError("Invalid username/password")
+
+    # Connect request
+    conn.send(
+        socks5.SOCKS5CommandRequest.from_address(
+            socks5.SOCKS5Command.CONNECT, (host, port)
+        )
+    )
+    outgoing_bytes = conn.data_to_send()
+    stream.write(outgoing_bytes)
+
+    # Connect response
+    incoming_bytes = stream.read(max_bytes=4096)
+    response = conn.receive_data(incoming_bytes)
+    assert isinstance(response, socks5.SOCKS5Reply)
+    if response.reply_code != socks5.SOCKS5ReplyCode.SUCCEEDED:
+        reply_code = REPLY_CODES.get(response.reply_code, "UNKOWN")
+        raise ProxyError(f"Proxy Server could not connect: {reply_code}.")
+
+
+class SOCKSProxy(ConnectionPool):
+    """
+    A connection pool that sends requests via an HTTP proxy.
+    """
+
+    def __init__(
+        self,
+        proxy_url: typing.Union[URL, bytes, str],
+        proxy_auth: typing.Optional[
+            typing.Tuple[typing.Union[bytes, str], typing.Union[bytes, str]]
+        ] = None,
+        ssl_context: typing.Optional[ssl.SSLContext] = None,
+        max_connections: typing.Optional[int] = 10,
+        max_keepalive_connections: typing.Optional[int] = None,
+        keepalive_expiry: typing.Optional[float] = None,
+        http1: bool = True,
+        http2: bool = False,
+        retries: int = 0,
+        network_backend: typing.Optional[NetworkBackend] = None,
+    ) -> None:
+        """
+        A connection pool for making HTTP requests.
+
+        Parameters:
+            proxy_url: The URL to use when connecting to the proxy server.
+                For example `"http://127.0.0.1:8080/"`.
+            ssl_context: An SSL context to use for verifying connections.
+                If not specified, the default `httpcore.default_ssl_context()`
+                will be used.
+            max_connections: The maximum number of concurrent HTTP connections that
+                the pool should allow. Any attempt to send a request on a pool that
+                would exceed this amount will block until a connection is available.
+            max_keepalive_connections: The maximum number of idle HTTP connections
+                that will be maintained in the pool.
+            keepalive_expiry: The duration in seconds that an idle HTTP connection
+                may be maintained for before being expired from the pool.
+            http1: A boolean indicating if HTTP/1.1 requests should be supported
+                by the connection pool. Defaults to True.
+            http2: A boolean indicating if HTTP/2 requests should be supported by
+                the connection pool. Defaults to False.
+            retries: The maximum number of retries when trying to establish
+                a connection.
+            local_address: Local address to connect from. Can also be used to
+                connect using a particular address family. Using
+                `local_address="0.0.0.0"` will connect using an `AF_INET` address
+                (IPv4), while using `local_address="::"` will connect using an
+                `AF_INET6` address (IPv6).
+            uds: Path to a Unix Domain Socket to use instead of TCP sockets.
+            network_backend: A backend instance to use for handling network I/O.
+        """
+        super().__init__(
+            ssl_context=ssl_context,
+            max_connections=max_connections,
+            max_keepalive_connections=max_keepalive_connections,
+            keepalive_expiry=keepalive_expiry,
+            http1=http1,
+            http2=http2,
+            network_backend=network_backend,
+            retries=retries,
+        )
+        self._ssl_context = ssl_context
+        self._proxy_url = enforce_url(proxy_url, name="proxy_url")
+        if proxy_auth is not None:
+            username, password = proxy_auth
+            username_bytes = enforce_bytes(username, name="proxy_auth")
+            password_bytes = enforce_bytes(password, name="proxy_auth")
+            self._proxy_auth: typing.Optional[typing.Tuple[bytes, bytes]] = (
+                username_bytes,
+                password_bytes,
+            )
+        else:
+            self._proxy_auth = None
+
+    def create_connection(self, origin: Origin) -> ConnectionInterface:
+        return Socks5Connection(
+            proxy_origin=self._proxy_url.origin,
+            remote_origin=origin,
+            proxy_auth=self._proxy_auth,
+            ssl_context=self._ssl_context,
+            keepalive_expiry=self._keepalive_expiry,
+            http1=self._http1,
+            http2=self._http2,
+            network_backend=self._network_backend,
+        )
+
+
+class Socks5Connection(ConnectionInterface):
+    def __init__(
+        self,
+        proxy_origin: Origin,
+        remote_origin: Origin,
+        proxy_auth: typing.Optional[typing.Tuple[bytes, bytes]] = None,
+        ssl_context: typing.Optional[ssl.SSLContext] = None,
+        keepalive_expiry: typing.Optional[float] = None,
+        http1: bool = True,
+        http2: bool = False,
+        network_backend: typing.Optional[NetworkBackend] = None,
+    ) -> None:
+        self._proxy_origin = proxy_origin
+        self._remote_origin = remote_origin
+        self._proxy_auth = proxy_auth
+        self._ssl_context = ssl_context
+        self._keepalive_expiry = keepalive_expiry
+        self._http1 = http1
+        self._http2 = http2
+
+        self._network_backend: NetworkBackend = (
+            SyncBackend() if network_backend is None else network_backend
+        )
+        self._connect_lock = Lock()
+        self._connection: typing.Optional[ConnectionInterface] = None
+        self._connect_failed = False
+
+    def handle_request(self, request: Request) -> Response:
+        timeouts = request.extensions.get("timeout", {})
+        sni_hostname = request.extensions.get("sni_hostname", None)
+        timeout = timeouts.get("connect", None)
+
+        with self._connect_lock:
+            if self._connection is None:
+                try:
+                    # Connect to the proxy
+                    kwargs = {
+                        "host": self._proxy_origin.host.decode("ascii"),
+                        "port": self._proxy_origin.port,
+                        "timeout": timeout,
+                    }
+                    with Trace("connect_tcp", logger, request, kwargs) as trace:
+                        stream = self._network_backend.connect_tcp(**kwargs)
+                        trace.return_value = stream
+
+                    # Connect to the remote host using socks5
+                    kwargs = {
+                        "stream": stream,
+                        "host": self._remote_origin.host.decode("ascii"),
+                        "port": self._remote_origin.port,
+                        "auth": self._proxy_auth,
+                    }
+                    with Trace(
+                        "setup_socks5_connection", logger, request, kwargs
+                    ) as trace:
+                        _init_socks5_connection(**kwargs)
+                        trace.return_value = stream
+
+                    # Upgrade the stream to SSL
+                    if self._remote_origin.scheme == b"https":
+                        ssl_context = (
+                            default_ssl_context()
+                            if self._ssl_context is None
+                            else self._ssl_context
+                        )
+                        alpn_protocols = (
+                            ["http/1.1", "h2"] if self._http2 else ["http/1.1"]
+                        )
+                        ssl_context.set_alpn_protocols(alpn_protocols)
+
+                        kwargs = {
+                            "ssl_context": ssl_context,
+                            "server_hostname": sni_hostname
+                            or self._remote_origin.host.decode("ascii"),
+                            "timeout": timeout,
+                        }
+                        with Trace("start_tls", logger, request, kwargs) as trace:
+                            stream = stream.start_tls(**kwargs)
+                            trace.return_value = stream
+
+                    # Determine if we should be using HTTP/1.1 or HTTP/2
+                    ssl_object = stream.get_extra_info("ssl_object")
+                    http2_negotiated = (
+                        ssl_object is not None
+                        and ssl_object.selected_alpn_protocol() == "h2"
+                    )
+
+                    # Create the HTTP/1.1 or HTTP/2 connection
+                    if http2_negotiated or (
+                        self._http2 and not self._http1
+                    ):  # pragma: nocover
+                        from .http2 import HTTP2Connection
+
+                        self._connection = HTTP2Connection(
+                            origin=self._remote_origin,
+                            stream=stream,
+                            keepalive_expiry=self._keepalive_expiry,
+                        )
+                    else:
+                        self._connection = HTTP11Connection(
+                            origin=self._remote_origin,
+                            stream=stream,
+                            keepalive_expiry=self._keepalive_expiry,
+                        )
+                except Exception as exc:
+                    self._connect_failed = True
+                    raise exc
+            elif not self._connection.is_available():  # pragma: nocover
+                raise ConnectionNotAvailable()
+
+        return self._connection.handle_request(request)
+
+    def can_handle_request(self, origin: Origin) -> bool:
+        return origin == self._remote_origin
+
+    def close(self) -> None:
+        if self._connection is not None:
+            self._connection.close()
+
+    def is_available(self) -> bool:
+        if self._connection is None:  # pragma: nocover
+            # If HTTP/2 support is enabled, and the resulting connection could
+            # end up as HTTP/2 then we should indicate the connection as being
+            # available to service multiple requests.
+            return (
+                self._http2
+                and (self._remote_origin.scheme == b"https" or not self._http1)
+                and not self._connect_failed
+            )
+        return self._connection.is_available()
+
+    def has_expired(self) -> bool:
+        if self._connection is None:  # pragma: nocover
+            return self._connect_failed
+        return self._connection.has_expired()
+
+    def is_idle(self) -> bool:
+        if self._connection is None:  # pragma: nocover
+            return self._connect_failed
+        return self._connection.is_idle()
+
+    def is_closed(self) -> bool:
+        if self._connection is None:  # pragma: nocover
+            return self._connect_failed
+        return self._connection.is_closed()
+
+    def info(self) -> str:
+        if self._connection is None:  # pragma: nocover
+            return "CONNECTION FAILED" if self._connect_failed else "CONNECTING"
+        return self._connection.info()
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} [{self.info()}]>"
diff --git a/llm/Lib/site-packages/httpcore/_synchronization.py b/llm/Lib/site-packages/httpcore/_synchronization.py
new file mode 100644
index 0000000000000000000000000000000000000000..9619a3983518391e4d2d018319e6e7b6943e74c5
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_synchronization.py
@@ -0,0 +1,317 @@
+import threading
+from types import TracebackType
+from typing import Optional, Type
+
+from ._exceptions import ExceptionMapping, PoolTimeout, map_exceptions
+
+# Our async synchronization primatives use either 'anyio' or 'trio' depending
+# on if they're running under asyncio or trio.
+
+try:
+    import trio
+except ImportError:  # pragma: nocover
+    trio = None  # type: ignore
+
+try:
+    import anyio
+except ImportError:  # pragma: nocover
+    anyio = None  # type: ignore
+
+
+def current_async_library() -> str:
+    # Determine if we're running under trio or asyncio.
+    # See https://sniffio.readthedocs.io/en/latest/
+    try:
+        import sniffio
+    except ImportError:  # pragma: nocover
+        environment = "asyncio"
+    else:
+        environment = sniffio.current_async_library()
+
+    if environment not in ("asyncio", "trio"):  # pragma: nocover
+        raise RuntimeError("Running under an unsupported async environment.")
+
+    if environment == "asyncio" and anyio is None:  # pragma: nocover
+        raise RuntimeError(
+            "Running with asyncio requires installation of 'httpcore[asyncio]'."
+        )
+
+    if environment == "trio" and trio is None:  # pragma: nocover
+        raise RuntimeError(
+            "Running with trio requires installation of 'httpcore[trio]'."
+        )
+
+    return environment
+
+
+class AsyncLock:
+    """
+    This is a standard lock.
+
+    In the sync case `Lock` provides thread locking.
+    In the async case `AsyncLock` provides async locking.
+    """
+
+    def __init__(self) -> None:
+        self._backend = ""
+
+    def setup(self) -> None:
+        """
+        Detect if we're running under 'asyncio' or 'trio' and create
+        a lock with the correct implementation.
+        """
+        self._backend = current_async_library()
+        if self._backend == "trio":
+            self._trio_lock = trio.Lock()
+        elif self._backend == "asyncio":
+            self._anyio_lock = anyio.Lock()
+
+    async def __aenter__(self) -> "AsyncLock":
+        if not self._backend:
+            self.setup()
+
+        if self._backend == "trio":
+            await self._trio_lock.acquire()
+        elif self._backend == "asyncio":
+            await self._anyio_lock.acquire()
+
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        if self._backend == "trio":
+            self._trio_lock.release()
+        elif self._backend == "asyncio":
+            self._anyio_lock.release()
+
+
+class AsyncThreadLock:
+    """
+    This is a threading-only lock for no-I/O contexts.
+
+    In the sync case `ThreadLock` provides thread locking.
+    In the async case `AsyncThreadLock` is a no-op.
+    """
+
+    def __enter__(self) -> "AsyncThreadLock":
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        pass
+
+
+class AsyncEvent:
+    def __init__(self) -> None:
+        self._backend = ""
+
+    def setup(self) -> None:
+        """
+        Detect if we're running under 'asyncio' or 'trio' and create
+        a lock with the correct implementation.
+        """
+        self._backend = current_async_library()
+        if self._backend == "trio":
+            self._trio_event = trio.Event()
+        elif self._backend == "asyncio":
+            self._anyio_event = anyio.Event()
+
+    def set(self) -> None:
+        if not self._backend:
+            self.setup()
+
+        if self._backend == "trio":
+            self._trio_event.set()
+        elif self._backend == "asyncio":
+            self._anyio_event.set()
+
+    async def wait(self, timeout: Optional[float] = None) -> None:
+        if not self._backend:
+            self.setup()
+
+        if self._backend == "trio":
+            trio_exc_map: ExceptionMapping = {trio.TooSlowError: PoolTimeout}
+            timeout_or_inf = float("inf") if timeout is None else timeout
+            with map_exceptions(trio_exc_map):
+                with trio.fail_after(timeout_or_inf):
+                    await self._trio_event.wait()
+        elif self._backend == "asyncio":
+            anyio_exc_map: ExceptionMapping = {TimeoutError: PoolTimeout}
+            with map_exceptions(anyio_exc_map):
+                with anyio.fail_after(timeout):
+                    await self._anyio_event.wait()
+
+
+class AsyncSemaphore:
+    def __init__(self, bound: int) -> None:
+        self._bound = bound
+        self._backend = ""
+
+    def setup(self) -> None:
+        """
+        Detect if we're running under 'asyncio' or 'trio' and create
+        a semaphore with the correct implementation.
+        """
+        self._backend = current_async_library()
+        if self._backend == "trio":
+            self._trio_semaphore = trio.Semaphore(
+                initial_value=self._bound, max_value=self._bound
+            )
+        elif self._backend == "asyncio":
+            self._anyio_semaphore = anyio.Semaphore(
+                initial_value=self._bound, max_value=self._bound
+            )
+
+    async def acquire(self) -> None:
+        if not self._backend:
+            self.setup()
+
+        if self._backend == "trio":
+            await self._trio_semaphore.acquire()
+        elif self._backend == "asyncio":
+            await self._anyio_semaphore.acquire()
+
+    async def release(self) -> None:
+        if self._backend == "trio":
+            self._trio_semaphore.release()
+        elif self._backend == "asyncio":
+            self._anyio_semaphore.release()
+
+
+class AsyncShieldCancellation:
+    # For certain portions of our codebase where we're dealing with
+    # closing connections during exception handling we want to shield
+    # the operation from being cancelled.
+    #
+    # with AsyncShieldCancellation():
+    #     ... # clean-up operations, shielded from cancellation.
+
+    def __init__(self) -> None:
+        """
+        Detect if we're running under 'asyncio' or 'trio' and create
+        a shielded scope with the correct implementation.
+        """
+        self._backend = current_async_library()
+
+        if self._backend == "trio":
+            self._trio_shield = trio.CancelScope(shield=True)
+        elif self._backend == "asyncio":
+            self._anyio_shield = anyio.CancelScope(shield=True)
+
+    def __enter__(self) -> "AsyncShieldCancellation":
+        if self._backend == "trio":
+            self._trio_shield.__enter__()
+        elif self._backend == "asyncio":
+            self._anyio_shield.__enter__()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        if self._backend == "trio":
+            self._trio_shield.__exit__(exc_type, exc_value, traceback)
+        elif self._backend == "asyncio":
+            self._anyio_shield.__exit__(exc_type, exc_value, traceback)
+
+
+# Our thread-based synchronization primitives...
+
+
+class Lock:
+    """
+    This is a standard lock.
+
+    In the sync case `Lock` provides thread locking.
+    In the async case `AsyncLock` provides async locking.
+    """
+
+    def __init__(self) -> None:
+        self._lock = threading.Lock()
+
+    def __enter__(self) -> "Lock":
+        self._lock.acquire()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        self._lock.release()
+
+
+class ThreadLock:
+    """
+    This is a threading-only lock for no-I/O contexts.
+
+    In the sync case `ThreadLock` provides thread locking.
+    In the async case `AsyncThreadLock` is a no-op.
+    """
+
+    def __init__(self) -> None:
+        self._lock = threading.Lock()
+
+    def __enter__(self) -> "ThreadLock":
+        self._lock.acquire()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        self._lock.release()
+
+
+class Event:
+    def __init__(self) -> None:
+        self._event = threading.Event()
+
+    def set(self) -> None:
+        self._event.set()
+
+    def wait(self, timeout: Optional[float] = None) -> None:
+        if timeout == float("inf"):  # pragma: no cover
+            timeout = None
+        if not self._event.wait(timeout=timeout):
+            raise PoolTimeout()  # pragma: nocover
+
+
+class Semaphore:
+    def __init__(self, bound: int) -> None:
+        self._semaphore = threading.Semaphore(value=bound)
+
+    def acquire(self) -> None:
+        self._semaphore.acquire()
+
+    def release(self) -> None:
+        self._semaphore.release()
+
+
+class ShieldCancellation:
+    # Thread-synchronous codebases don't support cancellation semantics.
+    # We have this class because we need to mirror the async and sync
+    # cases within our package, but it's just a no-op.
+    def __enter__(self) -> "ShieldCancellation":
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        pass
diff --git a/llm/Lib/site-packages/httpcore/_trace.py b/llm/Lib/site-packages/httpcore/_trace.py
new file mode 100644
index 0000000000000000000000000000000000000000..b122a53e88f17e1e450f63b05ede3e28e8a7992a
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_trace.py
@@ -0,0 +1,105 @@
+import inspect
+import logging
+from types import TracebackType
+from typing import Any, Dict, Optional, Type
+
+from ._models import Request
+
+
+class Trace:
+    def __init__(
+        self,
+        name: str,
+        logger: logging.Logger,
+        request: Optional[Request] = None,
+        kwargs: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        self.name = name
+        self.logger = logger
+        self.trace_extension = (
+            None if request is None else request.extensions.get("trace")
+        )
+        self.debug = self.logger.isEnabledFor(logging.DEBUG)
+        self.kwargs = kwargs or {}
+        self.return_value: Any = None
+        self.should_trace = self.debug or self.trace_extension is not None
+        self.prefix = self.logger.name.split(".")[-1]
+
+    def trace(self, name: str, info: Dict[str, Any]) -> None:
+        if self.trace_extension is not None:
+            prefix_and_name = f"{self.prefix}.{name}"
+            ret = self.trace_extension(prefix_and_name, info)
+            if inspect.iscoroutine(ret):  # pragma: no cover
+                raise TypeError(
+                    "If you are using a synchronous interface, "
+                    "the callback of the `trace` extension should "
+                    "be a normal function instead of an asynchronous function."
+                )
+
+        if self.debug:
+            if not info or "return_value" in info and info["return_value"] is None:
+                message = name
+            else:
+                args = " ".join([f"{key}={value!r}" for key, value in info.items()])
+                message = f"{name} {args}"
+            self.logger.debug(message)
+
+    def __enter__(self) -> "Trace":
+        if self.should_trace:
+            info = self.kwargs
+            self.trace(f"{self.name}.started", info)
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        if self.should_trace:
+            if exc_value is None:
+                info = {"return_value": self.return_value}
+                self.trace(f"{self.name}.complete", info)
+            else:
+                info = {"exception": exc_value}
+                self.trace(f"{self.name}.failed", info)
+
+    async def atrace(self, name: str, info: Dict[str, Any]) -> None:
+        if self.trace_extension is not None:
+            prefix_and_name = f"{self.prefix}.{name}"
+            coro = self.trace_extension(prefix_and_name, info)
+            if not inspect.iscoroutine(coro):  # pragma: no cover
+                raise TypeError(
+                    "If you're using an asynchronous interface, "
+                    "the callback of the `trace` extension should "
+                    "be an asynchronous function rather than a normal function."
+                )
+            await coro
+
+        if self.debug:
+            if not info or "return_value" in info and info["return_value"] is None:
+                message = name
+            else:
+                args = " ".join([f"{key}={value!r}" for key, value in info.items()])
+                message = f"{name} {args}"
+            self.logger.debug(message)
+
+    async def __aenter__(self) -> "Trace":
+        if self.should_trace:
+            info = self.kwargs
+            await self.atrace(f"{self.name}.started", info)
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Optional[Type[BaseException]] = None,
+        exc_value: Optional[BaseException] = None,
+        traceback: Optional[TracebackType] = None,
+    ) -> None:
+        if self.should_trace:
+            if exc_value is None:
+                info = {"return_value": self.return_value}
+                await self.atrace(f"{self.name}.complete", info)
+            else:
+                info = {"exception": exc_value}
+                await self.atrace(f"{self.name}.failed", info)
diff --git a/llm/Lib/site-packages/httpcore/_utils.py b/llm/Lib/site-packages/httpcore/_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..df5dea8fe472697afea4156d2916389e2f70d684
--- /dev/null
+++ b/llm/Lib/site-packages/httpcore/_utils.py
@@ -0,0 +1,36 @@
+import select
+import socket
+import sys
+import typing
+
+
+def is_socket_readable(sock: typing.Optional[socket.socket]) -> bool:
+    """
+    Return whether a socket, as identifed by its file descriptor, is readable.
+    "A socket is readable" means that the read buffer isn't empty, i.e. that calling
+    .recv() on it would immediately return some data.
+    """
+    # NOTE: we want check for readability without actually attempting to read, because
+    # we don't want to block forever if it's not readable.
+
+    # In the case that the socket no longer exists, or cannot return a file
+    # descriptor, we treat it as being readable, as if it the next read operation
+    # on it is ready to return the terminating `b""`.
+    sock_fd = None if sock is None else sock.fileno()
+    if sock_fd is None or sock_fd < 0:  # pragma: nocover
+        return True
+
+    # The implementation below was stolen from:
+    # https://github.com/python-trio/trio/blob/20ee2b1b7376db637435d80e266212a35837ddcc/trio/_socket.py#L471-L478
+    # See also: https://github.com/encode/httpcore/pull/193#issuecomment-703129316
+
+    # Use select.select on Windows, and when poll is unavailable and select.poll
+    # everywhere else. (E.g. When eventlet is in use. See #327)
+    if (
+        sys.platform == "win32" or getattr(select, "poll", None) is None
+    ):  # pragma: nocover
+        rready, _, _ = select.select([sock_fd], [], [], 0)
+        return bool(rready)
+    p = select.poll()
+    p.register(sock_fd, select.POLLIN)
+    return bool(p.poll(0))
diff --git a/llm/Lib/site-packages/httpcore/py.typed b/llm/Lib/site-packages/httpcore/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/httpx-0.27.0.dist-info/INSTALLER b/llm/Lib/site-packages/httpx-0.27.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/httpx-0.27.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/httpx-0.27.0.dist-info/METADATA b/llm/Lib/site-packages/httpx-0.27.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..b5ec37c7d93d878337a46bc27c451e3dfcbc1c0d
--- /dev/null
+++ b/llm/Lib/site-packages/httpx-0.27.0.dist-info/METADATA
@@ -0,0 +1,209 @@
+Metadata-Version: 2.1
+Name: httpx
+Version: 0.27.0
+Summary: The next generation HTTP client.
+Project-URL: Changelog, https://github.com/encode/httpx/blob/master/CHANGELOG.md
+Project-URL: Documentation, https://www.python-httpx.org
+Project-URL: Homepage, https://github.com/encode/httpx
+Project-URL: Source, https://github.com/encode/httpx
+Author-email: Tom Christie <tom@tomchristie.com>
+License-Expression: BSD-3-Clause
+License-File: LICENSE.md
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: AsyncIO
+Classifier: Framework :: Trio
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.8
+Requires-Dist: anyio
+Requires-Dist: certifi
+Requires-Dist: httpcore==1.*
+Requires-Dist: idna
+Requires-Dist: sniffio
+Provides-Extra: brotli
+Requires-Dist: brotli; (platform_python_implementation == 'CPython') and extra == 'brotli'
+Requires-Dist: brotlicffi; (platform_python_implementation != 'CPython') and extra == 'brotli'
+Provides-Extra: cli
+Requires-Dist: click==8.*; extra == 'cli'
+Requires-Dist: pygments==2.*; extra == 'cli'
+Requires-Dist: rich<14,>=10; extra == 'cli'
+Provides-Extra: http2
+Requires-Dist: h2<5,>=3; extra == 'http2'
+Provides-Extra: socks
+Requires-Dist: socksio==1.*; extra == 'socks'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <a href="https://www.python-httpx.org/"><img width="350" height="208" src="https://raw.githubusercontent.com/encode/httpx/master/docs/img/butterfly.png" alt='HTTPX'></a>
+</p>
+
+<p align="center"><strong>HTTPX</strong> <em>- A next-generation HTTP client for Python.</em></p>
+
+<p align="center">
+<a href="https://github.com/encode/httpx/actions">
+    <img src="https://github.com/encode/httpx/workflows/Test%20Suite/badge.svg" alt="Test Suite">
+</a>
+<a href="https://pypi.org/project/httpx/">
+    <img src="https://badge.fury.io/py/httpx.svg" alt="Package version">
+</a>
+</p>
+
+HTTPX is a fully featured HTTP client library for Python 3. It includes **an integrated
+command line client**, has support for both **HTTP/1.1 and HTTP/2**, and provides both **sync
+and async APIs**.
+
+---
+
+Install HTTPX using pip:
+
+```shell
+$ pip install httpx
+```
+
+Now, let's get started:
+
+```pycon
+>>> import httpx
+>>> r = httpx.get('https://www.example.org/')
+>>> r
+<Response [200 OK]>
+>>> r.status_code
+200
+>>> r.headers['content-type']
+'text/html; charset=UTF-8'
+>>> r.text
+'<!doctype html>\n<html>\n<head>\n<title>Example Domain</title>...'
+```
+
+Or, using the command-line client.
+
+```shell
+$ pip install 'httpx[cli]'  # The command line client is an optional dependency.
+```
+
+Which now allows us to use HTTPX directly from the command-line...
+
+<p align="center">
+  <img width="700" src="https://raw.githubusercontent.com/encode/httpx/master/docs/img/httpx-help.png" alt='httpx --help'>
+</p>
+
+Sending a request...
+
+<p align="center">
+  <img width="700" src="https://raw.githubusercontent.com/encode/httpx/master/docs/img/httpx-request.png" alt='httpx http://httpbin.org/json'>
+</p>
+
+## Features
+
+HTTPX builds on the well-established usability of `requests`, and gives you:
+
+* A broadly [requests-compatible API](https://www.python-httpx.org/compatibility/).
+* An integrated command-line client.
+* HTTP/1.1 [and HTTP/2 support](https://www.python-httpx.org/http2/).
+* Standard synchronous interface, but with [async support if you need it](https://www.python-httpx.org/async/).
+* Ability to make requests directly to [WSGI applications](https://www.python-httpx.org/advanced/#calling-into-python-web-apps) or [ASGI applications](https://www.python-httpx.org/async/#calling-into-python-web-apps).
+* Strict timeouts everywhere.
+* Fully type annotated.
+* 100% test coverage.
+
+Plus all the standard features of `requests`...
+
+* International Domains and URLs
+* Keep-Alive & Connection Pooling
+* Sessions with Cookie Persistence
+* Browser-style SSL Verification
+* Basic/Digest Authentication
+* Elegant Key/Value Cookies
+* Automatic Decompression
+* Automatic Content Decoding
+* Unicode Response Bodies
+* Multipart File Uploads
+* HTTP(S) Proxy Support
+* Connection Timeouts
+* Streaming Downloads
+* .netrc Support
+* Chunked Requests
+
+## Installation
+
+Install with pip:
+
+```shell
+$ pip install httpx
+```
+
+Or, to include the optional HTTP/2 support, use:
+
+```shell
+$ pip install httpx[http2]
+```
+
+HTTPX requires Python 3.8+.
+
+## Documentation
+
+Project documentation is available at [https://www.python-httpx.org/](https://www.python-httpx.org/).
+
+For a run-through of all the basics, head over to the [QuickStart](https://www.python-httpx.org/quickstart/).
+
+For more advanced topics, see the [Advanced Usage](https://www.python-httpx.org/advanced/) section, the [async support](https://www.python-httpx.org/async/) section, or the [HTTP/2](https://www.python-httpx.org/http2/) section.
+
+The [Developer Interface](https://www.python-httpx.org/api/) provides a comprehensive API reference.
+
+To find out about tools that integrate with HTTPX, see [Third Party Packages](https://www.python-httpx.org/third_party_packages/).
+
+## Contribute
+
+If you want to contribute with HTTPX check out the [Contributing Guide](https://www.python-httpx.org/contributing/) to learn how to start.
+
+## Dependencies
+
+The HTTPX project relies on these excellent libraries:
+
+* `httpcore` - The underlying transport implementation for `httpx`.
+  * `h11` - HTTP/1.1 support.
+* `certifi` - SSL certificates.
+* `idna` - Internationalized domain name support.
+* `sniffio` - Async library autodetection.
+
+As well as these optional installs:
+
+* `h2` - HTTP/2 support. *(Optional, with `httpx[http2]`)*
+* `socksio` - SOCKS proxy support. *(Optional, with `httpx[socks]`)*
+* `rich` - Rich terminal support. *(Optional, with `httpx[cli]`)*
+* `click` - Command line client support. *(Optional, with `httpx[cli]`)*
+* `brotli` or `brotlicffi` - Decoding for "brotli" compressed responses. *(Optional, with `httpx[brotli]`)*
+
+A huge amount of credit is due to `requests` for the API layout that
+much of this work follows, as well as to `urllib3` for plenty of design
+inspiration around the lower-level networking details.
+
+---
+
+<p align="center"><i>HTTPX is <a href="https://github.com/encode/httpx/blob/master/LICENSE.md">BSD licensed</a> code.<br/>Designed & crafted with care.</i><br/>&mdash; 🦋 &mdash;</p>
+
+## Release Information
+
+### Deprecated
+
+* The `app=...` shortcut has been deprecated. Use the explicit style of `transport=httpx.WSGITransport()` or `transport=httpx.ASGITransport()` instead.
+
+### Fixed
+
+* Respect the `http1` argument while configuring proxy transports. (#3023)
+* Fix RFC 2069 mode digest authentication. (#3045)
+
+
+---
+
+[Full changelog](https://github.com/encode/httpx/blob/master/CHANGELOG.md)
diff --git a/llm/Lib/site-packages/httpx-0.27.0.dist-info/RECORD b/llm/Lib/site-packages/httpx-0.27.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..d6a24eae224f3186864bcf5fb6100eff6afac2e2
--- /dev/null
+++ b/llm/Lib/site-packages/httpx-0.27.0.dist-info/RECORD
@@ -0,0 +1,56 @@
+../../Scripts/httpx.exe,sha256=Lo6SWzHPWarY2iPQPagTfW1QM7ziTu8UtAS4F-_HGmI,108372
+httpx-0.27.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+httpx-0.27.0.dist-info/METADATA,sha256=IU6gbQ_C5MYQcso6ftA80CYv5PFomXiTV4telUS5oRk,7184
+httpx-0.27.0.dist-info/RECORD,,
+httpx-0.27.0.dist-info/WHEEL,sha256=TJPnKdtrSue7xZ_AVGkp9YXcvDrobsjBds1du3Nx6dc,87
+httpx-0.27.0.dist-info/entry_points.txt,sha256=2lVkdQmxLA1pNMgSN2eV89o90HCZezhmNwsy6ryKDSA,37
+httpx-0.27.0.dist-info/licenses/LICENSE.md,sha256=TsWdVE8StfU5o6cW_TIaxYzNgDC0ZSIfLIgCAM3yjY0,1508
+httpx/__init__.py,sha256=oCxVAsePEy5DE9eLhGAAq9H3RBGZUDaUROtGEyzbBRo,3210
+httpx/__pycache__/__init__.cpython-311.pyc,,
+httpx/__pycache__/__version__.cpython-311.pyc,,
+httpx/__pycache__/_api.cpython-311.pyc,,
+httpx/__pycache__/_auth.cpython-311.pyc,,
+httpx/__pycache__/_client.cpython-311.pyc,,
+httpx/__pycache__/_compat.cpython-311.pyc,,
+httpx/__pycache__/_config.cpython-311.pyc,,
+httpx/__pycache__/_content.cpython-311.pyc,,
+httpx/__pycache__/_decoders.cpython-311.pyc,,
+httpx/__pycache__/_exceptions.cpython-311.pyc,,
+httpx/__pycache__/_main.cpython-311.pyc,,
+httpx/__pycache__/_models.cpython-311.pyc,,
+httpx/__pycache__/_multipart.cpython-311.pyc,,
+httpx/__pycache__/_status_codes.cpython-311.pyc,,
+httpx/__pycache__/_types.cpython-311.pyc,,
+httpx/__pycache__/_urlparse.cpython-311.pyc,,
+httpx/__pycache__/_urls.cpython-311.pyc,,
+httpx/__pycache__/_utils.cpython-311.pyc,,
+httpx/__version__.py,sha256=IAHwuJkw3XUFRtOMccAyFbrjpZ3C0udEyrIq2Yrtk5k,108
+httpx/_api.py,sha256=G0EqHYvmusoCiDYvn5i45lJOaQsorhKqLvhnLITCn0Y,12928
+httpx/_auth.py,sha256=G3ithlfScnw0qV2uLmcvQ9iYSpnlV1y72Jk5WXKl5ns,11830
+httpx/_client.py,sha256=YzAIIQkS0iK2mbEjHmMZZm7SOvnxXX4W8N8SpFveuYk,67490
+httpx/_compat.py,sha256=rJERfjHkRvvHFVfltbHyCVcAboNsfEeN6j_00Z2C4k8,1563
+httpx/_config.py,sha256=M5BHACPDt_ZzcKYdqMM1YiS6uHzuWhtbqpu1VL2rKsQ,12204
+httpx/_content.py,sha256=nuK0vo7FLdablYSjXg7kDN6Qh25mTgLxXu5JDoXvQ8U,8047
+httpx/_decoders.py,sha256=HyX51vac2bRb9XWvYpYxXVIQkQpYJuB6ZMAWJhjdNzg,9904
+httpx/_exceptions.py,sha256=vnB78_LL-JhjQKP9nbU6lmxmMyI3b4ImkZc3B_Ik3Ho,7922
+httpx/_main.py,sha256=LcRXtGghiTux7yj0pGXQXx7PNfr3EHE3VcxBcCY4RcE,15635
+httpx/_models.py,sha256=4X3uCAiCm1e7gwnBh777L3lWV6NdjdgfXSg1Nk47JsQ,42303
+httpx/_multipart.py,sha256=CkS8cH5Nau1YrvizDSCRhdK13fltMV2-GnvM3msGRzw,8885
+httpx/_status_codes.py,sha256=n-6km_2zd2bn175zxug8L8xy16Eyx2v0KowqGrhSNf4,5618
+httpx/_transports/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+httpx/_transports/__pycache__/__init__.cpython-311.pyc,,
+httpx/_transports/__pycache__/asgi.cpython-311.pyc,,
+httpx/_transports/__pycache__/base.cpython-311.pyc,,
+httpx/_transports/__pycache__/default.cpython-311.pyc,,
+httpx/_transports/__pycache__/mock.cpython-311.pyc,,
+httpx/_transports/__pycache__/wsgi.cpython-311.pyc,,
+httpx/_transports/asgi.py,sha256=TplpV_7STqay5uvPN_Q1c-K0i9Loy1LX4W0ndBg9fXI,5490
+httpx/_transports/base.py,sha256=Iv2ioumj7e-UBd_wU2i01_3Y4vAJRKLy8t0V99OF3Vc,2472
+httpx/_transports/default.py,sha256=lt9V3TJbSVoWmh4CktSI9Q1eFllFtOxNp7CsP0ZWNzM,13290
+httpx/_transports/mock.py,sha256=I_re3UXInPkN11eA2zACJzBJDvXEEtj-4eral48I7zs,1202
+httpx/_transports/wsgi.py,sha256=HeYO7Th2vKbbE5O3c5Z6Q_si77SF9OLOCW9FVTGZdO0,4795
+httpx/_types.py,sha256=lveH-nW6V3VLKeY-EffHVDkOxCe94Irg-ebo3LxQ13s,3391
+httpx/_urlparse.py,sha256=z1ZFA2PClbW0-TQEh9M_oyctpxuW9nc1ZXDcA9Sv6bs,17720
+httpx/_urls.py,sha256=yCaLvbmxI1j7gWSEYffKvYG2j749OmqI5sFCQrsB2Vk,21783
+httpx/_utils.py,sha256=lByQlK36pmXTJa7WxlWEfB48tcKb9fxI8xEO4ayi1JM,13858
+httpx/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
diff --git a/llm/Lib/site-packages/httpx-0.27.0.dist-info/WHEEL b/llm/Lib/site-packages/httpx-0.27.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..5998f3aab327ceb8cb346647a3461e220359aebf
--- /dev/null
+++ b/llm/Lib/site-packages/httpx-0.27.0.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.21.1
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/httpx-0.27.0.dist-info/entry_points.txt b/llm/Lib/site-packages/httpx-0.27.0.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..8ae96007f7d725813fd02dc1d06d3834ee1939e4
--- /dev/null
+++ b/llm/Lib/site-packages/httpx-0.27.0.dist-info/entry_points.txt
@@ -0,0 +1,2 @@
+[console_scripts]
+httpx = httpx:main
diff --git a/llm/Lib/site-packages/httpx-0.27.0.dist-info/licenses/LICENSE.md b/llm/Lib/site-packages/httpx-0.27.0.dist-info/licenses/LICENSE.md
new file mode 100644
index 0000000000000000000000000000000000000000..ab79d16a3f4c6c894c028d1f7431811e8711b42b
--- /dev/null
+++ b/llm/Lib/site-packages/httpx-0.27.0.dist-info/licenses/LICENSE.md
@@ -0,0 +1,12 @@
+Copyright © 2019, [Encode OSS Ltd](https://www.encode.io/).
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/llm/Lib/site-packages/httpx/__init__.py b/llm/Lib/site-packages/httpx/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f61112f8b20e11be3395d6f9265082ad762a7638
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/__init__.py
@@ -0,0 +1,138 @@
+from .__version__ import __description__, __title__, __version__
+from ._api import delete, get, head, options, patch, post, put, request, stream
+from ._auth import Auth, BasicAuth, DigestAuth, NetRCAuth
+from ._client import USE_CLIENT_DEFAULT, AsyncClient, Client
+from ._config import Limits, Proxy, Timeout, create_ssl_context
+from ._content import ByteStream
+from ._exceptions import (
+    CloseError,
+    ConnectError,
+    ConnectTimeout,
+    CookieConflict,
+    DecodingError,
+    HTTPError,
+    HTTPStatusError,
+    InvalidURL,
+    LocalProtocolError,
+    NetworkError,
+    PoolTimeout,
+    ProtocolError,
+    ProxyError,
+    ReadError,
+    ReadTimeout,
+    RemoteProtocolError,
+    RequestError,
+    RequestNotRead,
+    ResponseNotRead,
+    StreamClosed,
+    StreamConsumed,
+    StreamError,
+    TimeoutException,
+    TooManyRedirects,
+    TransportError,
+    UnsupportedProtocol,
+    WriteError,
+    WriteTimeout,
+)
+from ._models import Cookies, Headers, Request, Response
+from ._status_codes import codes
+from ._transports.asgi import ASGITransport
+from ._transports.base import AsyncBaseTransport, BaseTransport
+from ._transports.default import AsyncHTTPTransport, HTTPTransport
+from ._transports.mock import MockTransport
+from ._transports.wsgi import WSGITransport
+from ._types import AsyncByteStream, SyncByteStream
+from ._urls import URL, QueryParams
+
+try:
+    from ._main import main
+except ImportError:  # pragma: no cover
+
+    def main() -> None:  # type: ignore
+        import sys
+
+        print(
+            "The httpx command line client could not run because the required "
+            "dependencies were not installed.\nMake sure you've installed "
+            "everything with: pip install 'httpx[cli]'"
+        )
+        sys.exit(1)
+
+
+__all__ = [
+    "__description__",
+    "__title__",
+    "__version__",
+    "ASGITransport",
+    "AsyncBaseTransport",
+    "AsyncByteStream",
+    "AsyncClient",
+    "AsyncHTTPTransport",
+    "Auth",
+    "BaseTransport",
+    "BasicAuth",
+    "ByteStream",
+    "Client",
+    "CloseError",
+    "codes",
+    "ConnectError",
+    "ConnectTimeout",
+    "CookieConflict",
+    "Cookies",
+    "create_ssl_context",
+    "DecodingError",
+    "delete",
+    "DigestAuth",
+    "get",
+    "head",
+    "Headers",
+    "HTTPError",
+    "HTTPStatusError",
+    "HTTPTransport",
+    "InvalidURL",
+    "Limits",
+    "LocalProtocolError",
+    "main",
+    "MockTransport",
+    "NetRCAuth",
+    "NetworkError",
+    "options",
+    "patch",
+    "PoolTimeout",
+    "post",
+    "ProtocolError",
+    "Proxy",
+    "ProxyError",
+    "put",
+    "QueryParams",
+    "ReadError",
+    "ReadTimeout",
+    "RemoteProtocolError",
+    "request",
+    "Request",
+    "RequestError",
+    "RequestNotRead",
+    "Response",
+    "ResponseNotRead",
+    "stream",
+    "StreamClosed",
+    "StreamConsumed",
+    "StreamError",
+    "SyncByteStream",
+    "Timeout",
+    "TimeoutException",
+    "TooManyRedirects",
+    "TransportError",
+    "UnsupportedProtocol",
+    "URL",
+    "USE_CLIENT_DEFAULT",
+    "WriteError",
+    "WriteTimeout",
+    "WSGITransport",
+]
+
+
+__locals = locals()
+for __name in __all__:
+    if not __name.startswith("__"):
+        setattr(__locals[__name], "__module__", "httpx")  # noqa
diff --git a/llm/Lib/site-packages/httpx/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0f92fd050423780cef6b54d04fbdcb8306a3928e
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/__version__.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/__version__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e8cd8991ca0a28589859d79b160a62f6df1fede1
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/__version__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_api.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eaf75045cdfdaa83bfc77f511655452dd51f90ee
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_auth.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_auth.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e80e06e6be57fe5f97133e65e75d828d3788849
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_auth.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_client.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_client.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e84a3c99a9c074ea240098a25df3f123314bc640
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_client.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_compat.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_compat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e20607f1b955cc9692927229b066be3cc3484be4
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_compat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_config.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_config.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fdcd9f7dafecc052ceeb5b34da38a3f632d09360
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_config.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_content.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_content.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9724a0737b3e78fc7275446c808a2f6bd1fb31f4
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_content.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_decoders.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_decoders.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..07c94f955c67a9f51657d03d4283ac966d8ec021
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_decoders.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_exceptions.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ee29f3cc348915b3f44b0e37ed3c20edc7c2713b
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_main.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_main.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..92c0789922f4d83e127b7695f7809235f445a909
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_main.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_models.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_models.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..af268cd0d7c34ac11349d61108e65a289a9edad8
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_models.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_multipart.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_multipart.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..683c9a2b8574ab1ebc31f69f695b0f4eb3c3d0f2
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_multipart.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_status_codes.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_status_codes.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..39b8a097e8d3986e34211ccb8528355e16e88679
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_status_codes.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_types.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..59b98c9a269ddc77c265f9c73338e5ee63746791
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_urlparse.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_urlparse.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a41f09136ce95bb5b2cb0cc09861d17b6092cd55
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_urlparse.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_urls.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_urls.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7c2025ea3099658d21c862fbd133ba1ca5d2612e
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_urls.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__pycache__/_utils.cpython-311.pyc b/llm/Lib/site-packages/httpx/__pycache__/_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3c4014fc1d089340040e6d9a9dcb8325a45a1dec
Binary files /dev/null and b/llm/Lib/site-packages/httpx/__pycache__/_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/__version__.py b/llm/Lib/site-packages/httpx/__version__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c121a898dec3f247dbf26abee214cd2dbc9e8615
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/__version__.py
@@ -0,0 +1,3 @@
+__title__ = "httpx"
+__description__ = "A next generation HTTP client, for Python 3."
+__version__ = "0.27.0"
diff --git a/llm/Lib/site-packages/httpx/_api.py b/llm/Lib/site-packages/httpx/_api.py
new file mode 100644
index 0000000000000000000000000000000000000000..b5821cc49e6cc48e1f2c2711fb2ef5ae18f68b78
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_api.py
@@ -0,0 +1,467 @@
+from __future__ import annotations
+
+import typing
+from contextlib import contextmanager
+
+from ._client import Client
+from ._config import DEFAULT_TIMEOUT_CONFIG
+from ._models import Response
+from ._types import (
+    AuthTypes,
+    CertTypes,
+    CookieTypes,
+    HeaderTypes,
+    ProxiesTypes,
+    ProxyTypes,
+    QueryParamTypes,
+    RequestContent,
+    RequestData,
+    RequestFiles,
+    TimeoutTypes,
+    URLTypes,
+    VerifyTypes,
+)
+
+
+def request(
+    method: str,
+    url: URLTypes,
+    *,
+    params: QueryParamTypes | None = None,
+    content: RequestContent | None = None,
+    data: RequestData | None = None,
+    files: RequestFiles | None = None,
+    json: typing.Any | None = None,
+    headers: HeaderTypes | None = None,
+    cookies: CookieTypes | None = None,
+    auth: AuthTypes | None = None,
+    proxy: ProxyTypes | None = None,
+    proxies: ProxiesTypes | None = None,
+    timeout: TimeoutTypes = DEFAULT_TIMEOUT_CONFIG,
+    follow_redirects: bool = False,
+    verify: VerifyTypes = True,
+    cert: CertTypes | None = None,
+    trust_env: bool = True,
+) -> Response:
+    """
+    Sends an HTTP request.
+
+    **Parameters:**
+
+    * **method** - HTTP method for the new `Request` object: `GET`, `OPTIONS`,
+    `HEAD`, `POST`, `PUT`, `PATCH`, or `DELETE`.
+    * **url** - URL for the new `Request` object.
+    * **params** - *(optional)* Query parameters to include in the URL, as a
+    string, dictionary, or sequence of two-tuples.
+    * **content** - *(optional)* Binary content to include in the body of the
+    request, as bytes or a byte iterator.
+    * **data** - *(optional)* Form data to include in the body of the request,
+    as a dictionary.
+    * **files** - *(optional)* A dictionary of upload files to include in the
+    body of the request.
+    * **json** - *(optional)* A JSON serializable object to include in the body
+    of the request.
+    * **headers** - *(optional)* Dictionary of HTTP headers to include in the
+    request.
+    * **cookies** - *(optional)* Dictionary of Cookie items to include in the
+    request.
+    * **auth** - *(optional)* An authentication class to use when sending the
+    request.
+    * **proxy** - *(optional)* A proxy URL where all the traffic should be routed.
+    * **proxies** - *(optional)* A dictionary mapping proxy keys to proxy URLs.
+    * **timeout** - *(optional)* The timeout configuration to use when sending
+    the request.
+    * **follow_redirects** - *(optional)* Enables or disables HTTP redirects.
+    * **verify** - *(optional)* SSL certificates (a.k.a CA bundle) used to
+    verify the identity of requested hosts. Either `True` (default CA bundle),
+    a path to an SSL certificate file, an `ssl.SSLContext`, or `False`
+    (which will disable verification).
+    * **cert** - *(optional)* An SSL certificate used by the requested host
+    to authenticate the client. Either a path to an SSL certificate file, or
+    two-tuple of (certificate file, key file), or a three-tuple of (certificate
+    file, key file, password).
+    * **trust_env** - *(optional)* Enables or disables usage of environment
+    variables for configuration.
+
+    **Returns:** `Response`
+
+    Usage:
+
+    ```
+    >>> import httpx
+    >>> response = httpx.request('GET', 'https://httpbin.org/get')
+    >>> response
+    <Response [200 OK]>
+    ```
+    """
+    with Client(
+        cookies=cookies,
+        proxy=proxy,
+        proxies=proxies,
+        cert=cert,
+        verify=verify,
+        timeout=timeout,
+        trust_env=trust_env,
+    ) as client:
+        return client.request(
+            method=method,
+            url=url,
+            content=content,
+            data=data,
+            files=files,
+            json=json,
+            params=params,
+            headers=headers,
+            auth=auth,
+            follow_redirects=follow_redirects,
+        )
+
+
+@contextmanager
+def stream(
+    method: str,
+    url: URLTypes,
+    *,
+    params: QueryParamTypes | None = None,
+    content: RequestContent | None = None,
+    data: RequestData | None = None,
+    files: RequestFiles | None = None,
+    json: typing.Any | None = None,
+    headers: HeaderTypes | None = None,
+    cookies: CookieTypes | None = None,
+    auth: AuthTypes | None = None,
+    proxy: ProxyTypes | None = None,
+    proxies: ProxiesTypes | None = None,
+    timeout: TimeoutTypes = DEFAULT_TIMEOUT_CONFIG,
+    follow_redirects: bool = False,
+    verify: VerifyTypes = True,
+    cert: CertTypes | None = None,
+    trust_env: bool = True,
+) -> typing.Iterator[Response]:
+    """
+    Alternative to `httpx.request()` that streams the response body
+    instead of loading it into memory at once.
+
+    **Parameters**: See `httpx.request`.
+
+    See also: [Streaming Responses][0]
+
+    [0]: /quickstart#streaming-responses
+    """
+    with Client(
+        cookies=cookies,
+        proxy=proxy,
+        proxies=proxies,
+        cert=cert,
+        verify=verify,
+        timeout=timeout,
+        trust_env=trust_env,
+    ) as client:
+        with client.stream(
+            method=method,
+            url=url,
+            content=content,
+            data=data,
+            files=files,
+            json=json,
+            params=params,
+            headers=headers,
+            auth=auth,
+            follow_redirects=follow_redirects,
+        ) as response:
+            yield response
+
+
+def get(
+    url: URLTypes,
+    *,
+    params: QueryParamTypes | None = None,
+    headers: HeaderTypes | None = None,
+    cookies: CookieTypes | None = None,
+    auth: AuthTypes | None = None,
+    proxy: ProxyTypes | None = None,
+    proxies: ProxiesTypes | None = None,
+    follow_redirects: bool = False,
+    cert: CertTypes | None = None,
+    verify: VerifyTypes = True,
+    timeout: TimeoutTypes = DEFAULT_TIMEOUT_CONFIG,
+    trust_env: bool = True,
+) -> Response:
+    """
+    Sends a `GET` request.
+
+    **Parameters**: See `httpx.request`.
+
+    Note that the `data`, `files`, `json` and `content` parameters are not available
+    on this function, as `GET` requests should not include a request body.
+    """
+    return request(
+        "GET",
+        url,
+        params=params,
+        headers=headers,
+        cookies=cookies,
+        auth=auth,
+        proxy=proxy,
+        proxies=proxies,
+        follow_redirects=follow_redirects,
+        cert=cert,
+        verify=verify,
+        timeout=timeout,
+        trust_env=trust_env,
+    )
+
+
+def options(
+    url: URLTypes,
+    *,
+    params: QueryParamTypes | None = None,
+    headers: HeaderTypes | None = None,
+    cookies: CookieTypes | None = None,
+    auth: AuthTypes | None = None,
+    proxy: ProxyTypes | None = None,
+    proxies: ProxiesTypes | None = None,
+    follow_redirects: bool = False,
+    cert: CertTypes | None = None,
+    verify: VerifyTypes = True,
+    timeout: TimeoutTypes = DEFAULT_TIMEOUT_CONFIG,
+    trust_env: bool = True,
+) -> Response:
+    """
+    Sends an `OPTIONS` request.
+
+    **Parameters**: See `httpx.request`.
+
+    Note that the `data`, `files`, `json` and `content` parameters are not available
+    on this function, as `OPTIONS` requests should not include a request body.
+    """
+    return request(
+        "OPTIONS",
+        url,
+        params=params,
+        headers=headers,
+        cookies=cookies,
+        auth=auth,
+        proxy=proxy,
+        proxies=proxies,
+        follow_redirects=follow_redirects,
+        cert=cert,
+        verify=verify,
+        timeout=timeout,
+        trust_env=trust_env,
+    )
+
+
+def head(
+    url: URLTypes,
+    *,
+    params: QueryParamTypes | None = None,
+    headers: HeaderTypes | None = None,
+    cookies: CookieTypes | None = None,
+    auth: AuthTypes | None = None,
+    proxy: ProxyTypes | None = None,
+    proxies: ProxiesTypes | None = None,
+    follow_redirects: bool = False,
+    cert: CertTypes | None = None,
+    verify: VerifyTypes = True,
+    timeout: TimeoutTypes = DEFAULT_TIMEOUT_CONFIG,
+    trust_env: bool = True,
+) -> Response:
+    """
+    Sends a `HEAD` request.
+
+    **Parameters**: See `httpx.request`.
+
+    Note that the `data`, `files`, `json` and `content` parameters are not available
+    on this function, as `HEAD` requests should not include a request body.
+    """
+    return request(
+        "HEAD",
+        url,
+        params=params,
+        headers=headers,
+        cookies=cookies,
+        auth=auth,
+        proxy=proxy,
+        proxies=proxies,
+        follow_redirects=follow_redirects,
+        cert=cert,
+        verify=verify,
+        timeout=timeout,
+        trust_env=trust_env,
+    )
+
+
+def post(
+    url: URLTypes,
+    *,
+    content: RequestContent | None = None,
+    data: RequestData | None = None,
+    files: RequestFiles | None = None,
+    json: typing.Any | None = None,
+    params: QueryParamTypes | None = None,
+    headers: HeaderTypes | None = None,
+    cookies: CookieTypes | None = None,
+    auth: AuthTypes | None = None,
+    proxy: ProxyTypes | None = None,
+    proxies: ProxiesTypes | None = None,
+    follow_redirects: bool = False,
+    cert: CertTypes | None = None,
+    verify: VerifyTypes = True,
+    timeout: TimeoutTypes = DEFAULT_TIMEOUT_CONFIG,
+    trust_env: bool = True,
+) -> Response:
+    """
+    Sends a `POST` request.
+
+    **Parameters**: See `httpx.request`.
+    """
+    return request(
+        "POST",
+        url,
+        content=content,
+        data=data,
+        files=files,
+        json=json,
+        params=params,
+        headers=headers,
+        cookies=cookies,
+        auth=auth,
+        proxy=proxy,
+        proxies=proxies,
+        follow_redirects=follow_redirects,
+        cert=cert,
+        verify=verify,
+        timeout=timeout,
+        trust_env=trust_env,
+    )
+
+
+def put(
+    url: URLTypes,
+    *,
+    content: RequestContent | None = None,
+    data: RequestData | None = None,
+    files: RequestFiles | None = None,
+    json: typing.Any | None = None,
+    params: QueryParamTypes | None = None,
+    headers: HeaderTypes | None = None,
+    cookies: CookieTypes | None = None,
+    auth: AuthTypes | None = None,
+    proxy: ProxyTypes | None = None,
+    proxies: ProxiesTypes | None = None,
+    follow_redirects: bool = False,
+    cert: CertTypes | None = None,
+    verify: VerifyTypes = True,
+    timeout: TimeoutTypes = DEFAULT_TIMEOUT_CONFIG,
+    trust_env: bool = True,
+) -> Response:
+    """
+    Sends a `PUT` request.
+
+    **Parameters**: See `httpx.request`.
+    """
+    return request(
+        "PUT",
+        url,
+        content=content,
+        data=data,
+        files=files,
+        json=json,
+        params=params,
+        headers=headers,
+        cookies=cookies,
+        auth=auth,
+        proxy=proxy,
+        proxies=proxies,
+        follow_redirects=follow_redirects,
+        cert=cert,
+        verify=verify,
+        timeout=timeout,
+        trust_env=trust_env,
+    )
+
+
+def patch(
+    url: URLTypes,
+    *,
+    content: RequestContent | None = None,
+    data: RequestData | None = None,
+    files: RequestFiles | None = None,
+    json: typing.Any | None = None,
+    params: QueryParamTypes | None = None,
+    headers: HeaderTypes | None = None,
+    cookies: CookieTypes | None = None,
+    auth: AuthTypes | None = None,
+    proxy: ProxyTypes | None = None,
+    proxies: ProxiesTypes | None = None,
+    follow_redirects: bool = False,
+    cert: CertTypes | None = None,
+    verify: VerifyTypes = True,
+    timeout: TimeoutTypes = DEFAULT_TIMEOUT_CONFIG,
+    trust_env: bool = True,
+) -> Response:
+    """
+    Sends a `PATCH` request.
+
+    **Parameters**: See `httpx.request`.
+    """
+    return request(
+        "PATCH",
+        url,
+        content=content,
+        data=data,
+        files=files,
+        json=json,
+        params=params,
+        headers=headers,
+        cookies=cookies,
+        auth=auth,
+        proxy=proxy,
+        proxies=proxies,
+        follow_redirects=follow_redirects,
+        cert=cert,
+        verify=verify,
+        timeout=timeout,
+        trust_env=trust_env,
+    )
+
+
+def delete(
+    url: URLTypes,
+    *,
+    params: QueryParamTypes | None = None,
+    headers: HeaderTypes | None = None,
+    cookies: CookieTypes | None = None,
+    auth: AuthTypes | None = None,
+    proxy: ProxyTypes | None = None,
+    proxies: ProxiesTypes | None = None,
+    follow_redirects: bool = False,
+    cert: CertTypes | None = None,
+    verify: VerifyTypes = True,
+    timeout: TimeoutTypes = DEFAULT_TIMEOUT_CONFIG,
+    trust_env: bool = True,
+) -> Response:
+    """
+    Sends a `DELETE` request.
+
+    **Parameters**: See `httpx.request`.
+
+    Note that the `data`, `files`, `json` and `content` parameters are not available
+    on this function, as `DELETE` requests should not include a request body.
+    """
+    return request(
+        "DELETE",
+        url,
+        params=params,
+        headers=headers,
+        cookies=cookies,
+        auth=auth,
+        proxy=proxy,
+        proxies=proxies,
+        follow_redirects=follow_redirects,
+        cert=cert,
+        verify=verify,
+        timeout=timeout,
+        trust_env=trust_env,
+    )
diff --git a/llm/Lib/site-packages/httpx/_auth.py b/llm/Lib/site-packages/httpx/_auth.py
new file mode 100644
index 0000000000000000000000000000000000000000..903e39961740940faf79872da9347f3bf9624983
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_auth.py
@@ -0,0 +1,345 @@
+from __future__ import annotations
+
+import hashlib
+import os
+import re
+import time
+import typing
+from base64 import b64encode
+from urllib.request import parse_http_list
+
+from ._exceptions import ProtocolError
+from ._models import Cookies, Request, Response
+from ._utils import to_bytes, to_str, unquote
+
+if typing.TYPE_CHECKING:  # pragma: no cover
+    from hashlib import _Hash
+
+
+class Auth:
+    """
+    Base class for all authentication schemes.
+
+    To implement a custom authentication scheme, subclass `Auth` and override
+    the `.auth_flow()` method.
+
+    If the authentication scheme does I/O such as disk access or network calls, or uses
+    synchronization primitives such as locks, you should override `.sync_auth_flow()`
+    and/or `.async_auth_flow()` instead of `.auth_flow()` to provide specialized
+    implementations that will be used by `Client` and `AsyncClient` respectively.
+    """
+
+    requires_request_body = False
+    requires_response_body = False
+
+    def auth_flow(self, request: Request) -> typing.Generator[Request, Response, None]:
+        """
+        Execute the authentication flow.
+
+        To dispatch a request, `yield` it:
+
+        ```
+        yield request
+        ```
+
+        The client will `.send()` the response back into the flow generator. You can
+        access it like so:
+
+        ```
+        response = yield request
+        ```
+
+        A `return` (or reaching the end of the generator) will result in the
+        client returning the last response obtained from the server.
+
+        You can dispatch as many requests as is necessary.
+        """
+        yield request
+
+    def sync_auth_flow(
+        self, request: Request
+    ) -> typing.Generator[Request, Response, None]:
+        """
+        Execute the authentication flow synchronously.
+
+        By default, this defers to `.auth_flow()`. You should override this method
+        when the authentication scheme does I/O and/or uses concurrency primitives.
+        """
+        if self.requires_request_body:
+            request.read()
+
+        flow = self.auth_flow(request)
+        request = next(flow)
+
+        while True:
+            response = yield request
+            if self.requires_response_body:
+                response.read()
+
+            try:
+                request = flow.send(response)
+            except StopIteration:
+                break
+
+    async def async_auth_flow(
+        self, request: Request
+    ) -> typing.AsyncGenerator[Request, Response]:
+        """
+        Execute the authentication flow asynchronously.
+
+        By default, this defers to `.auth_flow()`. You should override this method
+        when the authentication scheme does I/O and/or uses concurrency primitives.
+        """
+        if self.requires_request_body:
+            await request.aread()
+
+        flow = self.auth_flow(request)
+        request = next(flow)
+
+        while True:
+            response = yield request
+            if self.requires_response_body:
+                await response.aread()
+
+            try:
+                request = flow.send(response)
+            except StopIteration:
+                break
+
+
+class FunctionAuth(Auth):
+    """
+    Allows the 'auth' argument to be passed as a simple callable function,
+    that takes the request, and returns a new, modified request.
+    """
+
+    def __init__(self, func: typing.Callable[[Request], Request]) -> None:
+        self._func = func
+
+    def auth_flow(self, request: Request) -> typing.Generator[Request, Response, None]:
+        yield self._func(request)
+
+
+class BasicAuth(Auth):
+    """
+    Allows the 'auth' argument to be passed as a (username, password) pair,
+    and uses HTTP Basic authentication.
+    """
+
+    def __init__(self, username: str | bytes, password: str | bytes) -> None:
+        self._auth_header = self._build_auth_header(username, password)
+
+    def auth_flow(self, request: Request) -> typing.Generator[Request, Response, None]:
+        request.headers["Authorization"] = self._auth_header
+        yield request
+
+    def _build_auth_header(self, username: str | bytes, password: str | bytes) -> str:
+        userpass = b":".join((to_bytes(username), to_bytes(password)))
+        token = b64encode(userpass).decode()
+        return f"Basic {token}"
+
+
+class NetRCAuth(Auth):
+    """
+    Use a 'netrc' file to lookup basic auth credentials based on the url host.
+    """
+
+    def __init__(self, file: str | None = None) -> None:
+        # Lazily import 'netrc'.
+        # There's no need for us to load this module unless 'NetRCAuth' is being used.
+        import netrc
+
+        self._netrc_info = netrc.netrc(file)
+
+    def auth_flow(self, request: Request) -> typing.Generator[Request, Response, None]:
+        auth_info = self._netrc_info.authenticators(request.url.host)
+        if auth_info is None or not auth_info[2]:
+            # The netrc file did not have authentication credentials for this host.
+            yield request
+        else:
+            # Build a basic auth header with credentials from the netrc file.
+            request.headers["Authorization"] = self._build_auth_header(
+                username=auth_info[0], password=auth_info[2]
+            )
+            yield request
+
+    def _build_auth_header(self, username: str | bytes, password: str | bytes) -> str:
+        userpass = b":".join((to_bytes(username), to_bytes(password)))
+        token = b64encode(userpass).decode()
+        return f"Basic {token}"
+
+
+class DigestAuth(Auth):
+    _ALGORITHM_TO_HASH_FUNCTION: dict[str, typing.Callable[[bytes], _Hash]] = {
+        "MD5": hashlib.md5,
+        "MD5-SESS": hashlib.md5,
+        "SHA": hashlib.sha1,
+        "SHA-SESS": hashlib.sha1,
+        "SHA-256": hashlib.sha256,
+        "SHA-256-SESS": hashlib.sha256,
+        "SHA-512": hashlib.sha512,
+        "SHA-512-SESS": hashlib.sha512,
+    }
+
+    def __init__(self, username: str | bytes, password: str | bytes) -> None:
+        self._username = to_bytes(username)
+        self._password = to_bytes(password)
+        self._last_challenge: _DigestAuthChallenge | None = None
+        self._nonce_count = 1
+
+    def auth_flow(self, request: Request) -> typing.Generator[Request, Response, None]:
+        if self._last_challenge:
+            request.headers["Authorization"] = self._build_auth_header(
+                request, self._last_challenge
+            )
+
+        response = yield request
+
+        if response.status_code != 401 or "www-authenticate" not in response.headers:
+            # If the response is not a 401 then we don't
+            # need to build an authenticated request.
+            return
+
+        for auth_header in response.headers.get_list("www-authenticate"):
+            if auth_header.lower().startswith("digest "):
+                break
+        else:
+            # If the response does not include a 'WWW-Authenticate: Digest ...'
+            # header, then we don't need to build an authenticated request.
+            return
+
+        self._last_challenge = self._parse_challenge(request, response, auth_header)
+        self._nonce_count = 1
+
+        request.headers["Authorization"] = self._build_auth_header(
+            request, self._last_challenge
+        )
+        if response.cookies:
+            Cookies(response.cookies).set_cookie_header(request=request)
+        yield request
+
+    def _parse_challenge(
+        self, request: Request, response: Response, auth_header: str
+    ) -> _DigestAuthChallenge:
+        """
+        Returns a challenge from a Digest WWW-Authenticate header.
+        These take the form of:
+        `Digest realm="realm@host.com",qop="auth,auth-int",nonce="abc",opaque="xyz"`
+        """
+        scheme, _, fields = auth_header.partition(" ")
+
+        # This method should only ever have been called with a Digest auth header.
+        assert scheme.lower() == "digest"
+
+        header_dict: dict[str, str] = {}
+        for field in parse_http_list(fields):
+            key, value = field.strip().split("=", 1)
+            header_dict[key] = unquote(value)
+
+        try:
+            realm = header_dict["realm"].encode()
+            nonce = header_dict["nonce"].encode()
+            algorithm = header_dict.get("algorithm", "MD5")
+            opaque = header_dict["opaque"].encode() if "opaque" in header_dict else None
+            qop = header_dict["qop"].encode() if "qop" in header_dict else None
+            return _DigestAuthChallenge(
+                realm=realm, nonce=nonce, algorithm=algorithm, opaque=opaque, qop=qop
+            )
+        except KeyError as exc:
+            message = "Malformed Digest WWW-Authenticate header"
+            raise ProtocolError(message, request=request) from exc
+
+    def _build_auth_header(
+        self, request: Request, challenge: _DigestAuthChallenge
+    ) -> str:
+        hash_func = self._ALGORITHM_TO_HASH_FUNCTION[challenge.algorithm.upper()]
+
+        def digest(data: bytes) -> bytes:
+            return hash_func(data).hexdigest().encode()
+
+        A1 = b":".join((self._username, challenge.realm, self._password))
+
+        path = request.url.raw_path
+        A2 = b":".join((request.method.encode(), path))
+        # TODO: implement auth-int
+        HA2 = digest(A2)
+
+        nc_value = b"%08x" % self._nonce_count
+        cnonce = self._get_client_nonce(self._nonce_count, challenge.nonce)
+        self._nonce_count += 1
+
+        HA1 = digest(A1)
+        if challenge.algorithm.lower().endswith("-sess"):
+            HA1 = digest(b":".join((HA1, challenge.nonce, cnonce)))
+
+        qop = self._resolve_qop(challenge.qop, request=request)
+        if qop is None:
+            # Following RFC 2069
+            digest_data = [HA1, challenge.nonce, HA2]
+        else:
+            # Following RFC 2617/7616
+            digest_data = [HA1, challenge.nonce, nc_value, cnonce, qop, HA2]
+
+        format_args = {
+            "username": self._username,
+            "realm": challenge.realm,
+            "nonce": challenge.nonce,
+            "uri": path,
+            "response": digest(b":".join(digest_data)),
+            "algorithm": challenge.algorithm.encode(),
+        }
+        if challenge.opaque:
+            format_args["opaque"] = challenge.opaque
+        if qop:
+            format_args["qop"] = b"auth"
+            format_args["nc"] = nc_value
+            format_args["cnonce"] = cnonce
+
+        return "Digest " + self._get_header_value(format_args)
+
+    def _get_client_nonce(self, nonce_count: int, nonce: bytes) -> bytes:
+        s = str(nonce_count).encode()
+        s += nonce
+        s += time.ctime().encode()
+        s += os.urandom(8)
+
+        return hashlib.sha1(s).hexdigest()[:16].encode()
+
+    def _get_header_value(self, header_fields: dict[str, bytes]) -> str:
+        NON_QUOTED_FIELDS = ("algorithm", "qop", "nc")
+        QUOTED_TEMPLATE = '{}="{}"'
+        NON_QUOTED_TEMPLATE = "{}={}"
+
+        header_value = ""
+        for i, (field, value) in enumerate(header_fields.items()):
+            if i > 0:
+                header_value += ", "
+            template = (
+                QUOTED_TEMPLATE
+                if field not in NON_QUOTED_FIELDS
+                else NON_QUOTED_TEMPLATE
+            )
+            header_value += template.format(field, to_str(value))
+
+        return header_value
+
+    def _resolve_qop(self, qop: bytes | None, request: Request) -> bytes | None:
+        if qop is None:
+            return None
+        qops = re.split(b", ?", qop)
+        if b"auth" in qops:
+            return b"auth"
+
+        if qops == [b"auth-int"]:
+            raise NotImplementedError("Digest auth-int support is not yet implemented")
+
+        message = f'Unexpected qop value "{qop!r}" in digest auth'
+        raise ProtocolError(message, request=request)
+
+
+class _DigestAuthChallenge(typing.NamedTuple):
+    realm: bytes
+    nonce: bytes
+    algorithm: str
+    opaque: bytes | None
+    qop: bytes | None
diff --git a/llm/Lib/site-packages/httpx/_client.py b/llm/Lib/site-packages/httpx/_client.py
new file mode 100644
index 0000000000000000000000000000000000000000..e2c6702e0c7ecb0d9e12ae41d19a156daaed6981
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_client.py
@@ -0,0 +1,2052 @@
+from __future__ import annotations
+
+import datetime
+import enum
+import logging
+import typing
+import warnings
+from contextlib import asynccontextmanager, contextmanager
+from types import TracebackType
+
+from .__version__ import __version__
+from ._auth import Auth, BasicAuth, FunctionAuth
+from ._config import (
+    DEFAULT_LIMITS,
+    DEFAULT_MAX_REDIRECTS,
+    DEFAULT_TIMEOUT_CONFIG,
+    Limits,
+    Proxy,
+    Timeout,
+)
+from ._decoders import SUPPORTED_DECODERS
+from ._exceptions import (
+    InvalidURL,
+    RemoteProtocolError,
+    TooManyRedirects,
+    request_context,
+)
+from ._models import Cookies, Headers, Request, Response
+from ._status_codes import codes
+from ._transports.asgi import ASGITransport
+from ._transports.base import AsyncBaseTransport, BaseTransport
+from ._transports.default import AsyncHTTPTransport, HTTPTransport
+from ._transports.wsgi import WSGITransport
+from ._types import (
+    AsyncByteStream,
+    AuthTypes,
+    CertTypes,
+    CookieTypes,
+    HeaderTypes,
+    ProxiesTypes,
+    ProxyTypes,
+    QueryParamTypes,
+    RequestContent,
+    RequestData,
+    RequestExtensions,
+    RequestFiles,
+    SyncByteStream,
+    TimeoutTypes,
+    URLTypes,
+    VerifyTypes,
+)
+from ._urls import URL, QueryParams
+from ._utils import (
+    Timer,
+    URLPattern,
+    get_environment_proxies,
+    is_https_redirect,
+    same_origin,
+)
+
+# The type annotation for @classmethod and context managers here follows PEP 484
+# https://www.python.org/dev/peps/pep-0484/#annotating-instance-and-class-methods
+T = typing.TypeVar("T", bound="Client")
+U = typing.TypeVar("U", bound="AsyncClient")
+
+
+class UseClientDefault:
+    """
+    For some parameters such as `auth=...` and `timeout=...` we need to be able
+    to indicate the default "unset" state, in a way that is distinctly different
+    to using `None`.
+
+    The default "unset" state indicates that whatever default is set on the
+    client should be used. This is different to setting `None`, which
+    explicitly disables the parameter, possibly overriding a client default.
+
+    For example we use `timeout=USE_CLIENT_DEFAULT` in the `request()` signature.
+    Omitting the `timeout` parameter will send a request using whatever default
+    timeout has been configured on the client. Including `timeout=None` will
+    ensure no timeout is used.
+
+    Note that user code shouldn't need to use the `USE_CLIENT_DEFAULT` constant,
+    but it is used internally when a parameter is not included.
+    """
+
+
+USE_CLIENT_DEFAULT = UseClientDefault()
+
+
+logger = logging.getLogger("httpx")
+
+USER_AGENT = f"python-httpx/{__version__}"
+ACCEPT_ENCODING = ", ".join(
+    [key for key in SUPPORTED_DECODERS.keys() if key != "identity"]
+)
+
+
+class ClientState(enum.Enum):
+    # UNOPENED:
+    #   The client has been instantiated, but has not been used to send a request,
+    #   or been opened by entering the context of a `with` block.
+    UNOPENED = 1
+    # OPENED:
+    #   The client has either sent a request, or is within a `with` block.
+    OPENED = 2
+    # CLOSED:
+    #   The client has either exited the `with` block, or `close()` has
+    #   been called explicitly.
+    CLOSED = 3
+
+
+class BoundSyncStream(SyncByteStream):
+    """
+    A byte stream that is bound to a given response instance, and that
+    ensures the `response.elapsed` is set once the response is closed.
+    """
+
+    def __init__(
+        self, stream: SyncByteStream, response: Response, timer: Timer
+    ) -> None:
+        self._stream = stream
+        self._response = response
+        self._timer = timer
+
+    def __iter__(self) -> typing.Iterator[bytes]:
+        for chunk in self._stream:
+            yield chunk
+
+    def close(self) -> None:
+        seconds = self._timer.sync_elapsed()
+        self._response.elapsed = datetime.timedelta(seconds=seconds)
+        self._stream.close()
+
+
+class BoundAsyncStream(AsyncByteStream):
+    """
+    An async byte stream that is bound to a given response instance, and that
+    ensures the `response.elapsed` is set once the response is closed.
+    """
+
+    def __init__(
+        self, stream: AsyncByteStream, response: Response, timer: Timer
+    ) -> None:
+        self._stream = stream
+        self._response = response
+        self._timer = timer
+
+    async def __aiter__(self) -> typing.AsyncIterator[bytes]:
+        async for chunk in self._stream:
+            yield chunk
+
+    async def aclose(self) -> None:
+        seconds = await self._timer.async_elapsed()
+        self._response.elapsed = datetime.timedelta(seconds=seconds)
+        await self._stream.aclose()
+
+
+EventHook = typing.Callable[..., typing.Any]
+
+
+class BaseClient:
+    def __init__(
+        self,
+        *,
+        auth: AuthTypes | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        timeout: TimeoutTypes = DEFAULT_TIMEOUT_CONFIG,
+        follow_redirects: bool = False,
+        max_redirects: int = DEFAULT_MAX_REDIRECTS,
+        event_hooks: None | (typing.Mapping[str, list[EventHook]]) = None,
+        base_url: URLTypes = "",
+        trust_env: bool = True,
+        default_encoding: str | typing.Callable[[bytes], str] = "utf-8",
+    ) -> None:
+        event_hooks = {} if event_hooks is None else event_hooks
+
+        self._base_url = self._enforce_trailing_slash(URL(base_url))
+
+        self._auth = self._build_auth(auth)
+        self._params = QueryParams(params)
+        self.headers = Headers(headers)
+        self._cookies = Cookies(cookies)
+        self._timeout = Timeout(timeout)
+        self.follow_redirects = follow_redirects
+        self.max_redirects = max_redirects
+        self._event_hooks = {
+            "request": list(event_hooks.get("request", [])),
+            "response": list(event_hooks.get("response", [])),
+        }
+        self._trust_env = trust_env
+        self._default_encoding = default_encoding
+        self._state = ClientState.UNOPENED
+
+    @property
+    def is_closed(self) -> bool:
+        """
+        Check if the client being closed
+        """
+        return self._state == ClientState.CLOSED
+
+    @property
+    def trust_env(self) -> bool:
+        return self._trust_env
+
+    def _enforce_trailing_slash(self, url: URL) -> URL:
+        if url.raw_path.endswith(b"/"):
+            return url
+        return url.copy_with(raw_path=url.raw_path + b"/")
+
+    def _get_proxy_map(
+        self, proxies: ProxiesTypes | None, allow_env_proxies: bool
+    ) -> dict[str, Proxy | None]:
+        if proxies is None:
+            if allow_env_proxies:
+                return {
+                    key: None if url is None else Proxy(url=url)
+                    for key, url in get_environment_proxies().items()
+                }
+            return {}
+        if isinstance(proxies, dict):
+            new_proxies = {}
+            for key, value in proxies.items():
+                proxy = Proxy(url=value) if isinstance(value, (str, URL)) else value
+                new_proxies[str(key)] = proxy
+            return new_proxies
+        else:
+            proxy = Proxy(url=proxies) if isinstance(proxies, (str, URL)) else proxies
+            return {"all://": proxy}
+
+    @property
+    def timeout(self) -> Timeout:
+        return self._timeout
+
+    @timeout.setter
+    def timeout(self, timeout: TimeoutTypes) -> None:
+        self._timeout = Timeout(timeout)
+
+    @property
+    def event_hooks(self) -> dict[str, list[EventHook]]:
+        return self._event_hooks
+
+    @event_hooks.setter
+    def event_hooks(self, event_hooks: dict[str, list[EventHook]]) -> None:
+        self._event_hooks = {
+            "request": list(event_hooks.get("request", [])),
+            "response": list(event_hooks.get("response", [])),
+        }
+
+    @property
+    def auth(self) -> Auth | None:
+        """
+        Authentication class used when none is passed at the request-level.
+
+        See also [Authentication][0].
+
+        [0]: /quickstart/#authentication
+        """
+        return self._auth
+
+    @auth.setter
+    def auth(self, auth: AuthTypes) -> None:
+        self._auth = self._build_auth(auth)
+
+    @property
+    def base_url(self) -> URL:
+        """
+        Base URL to use when sending requests with relative URLs.
+        """
+        return self._base_url
+
+    @base_url.setter
+    def base_url(self, url: URLTypes) -> None:
+        self._base_url = self._enforce_trailing_slash(URL(url))
+
+    @property
+    def headers(self) -> Headers:
+        """
+        HTTP headers to include when sending requests.
+        """
+        return self._headers
+
+    @headers.setter
+    def headers(self, headers: HeaderTypes) -> None:
+        client_headers = Headers(
+            {
+                b"Accept": b"*/*",
+                b"Accept-Encoding": ACCEPT_ENCODING.encode("ascii"),
+                b"Connection": b"keep-alive",
+                b"User-Agent": USER_AGENT.encode("ascii"),
+            }
+        )
+        client_headers.update(headers)
+        self._headers = client_headers
+
+    @property
+    def cookies(self) -> Cookies:
+        """
+        Cookie values to include when sending requests.
+        """
+        return self._cookies
+
+    @cookies.setter
+    def cookies(self, cookies: CookieTypes) -> None:
+        self._cookies = Cookies(cookies)
+
+    @property
+    def params(self) -> QueryParams:
+        """
+        Query parameters to include in the URL when sending requests.
+        """
+        return self._params
+
+    @params.setter
+    def params(self, params: QueryParamTypes) -> None:
+        self._params = QueryParams(params)
+
+    def build_request(
+        self,
+        method: str,
+        url: URLTypes,
+        *,
+        content: RequestContent | None = None,
+        data: RequestData | None = None,
+        files: RequestFiles | None = None,
+        json: typing.Any | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Request:
+        """
+        Build and return a request instance.
+
+        * The `params`, `headers` and `cookies` arguments
+        are merged with any values set on the client.
+        * The `url` argument is merged with any `base_url` set on the client.
+
+        See also: [Request instances][0]
+
+        [0]: /advanced/#request-instances
+        """
+        url = self._merge_url(url)
+        headers = self._merge_headers(headers)
+        cookies = self._merge_cookies(cookies)
+        params = self._merge_queryparams(params)
+        extensions = {} if extensions is None else extensions
+        if "timeout" not in extensions:
+            timeout = (
+                self.timeout
+                if isinstance(timeout, UseClientDefault)
+                else Timeout(timeout)
+            )
+            extensions = dict(**extensions, timeout=timeout.as_dict())
+        return Request(
+            method,
+            url,
+            content=content,
+            data=data,
+            files=files,
+            json=json,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            extensions=extensions,
+        )
+
+    def _merge_url(self, url: URLTypes) -> URL:
+        """
+        Merge a URL argument together with any 'base_url' on the client,
+        to create the URL used for the outgoing request.
+        """
+        merge_url = URL(url)
+        if merge_url.is_relative_url:
+            # To merge URLs we always append to the base URL. To get this
+            # behaviour correct we always ensure the base URL ends in a '/'
+            # separator, and strip any leading '/' from the merge URL.
+            #
+            # So, eg...
+            #
+            # >>> client = Client(base_url="https://www.example.com/subpath")
+            # >>> client.base_url
+            # URL('https://www.example.com/subpath/')
+            # >>> client.build_request("GET", "/path").url
+            # URL('https://www.example.com/subpath/path')
+            merge_raw_path = self.base_url.raw_path + merge_url.raw_path.lstrip(b"/")
+            return self.base_url.copy_with(raw_path=merge_raw_path)
+        return merge_url
+
+    def _merge_cookies(self, cookies: CookieTypes | None = None) -> CookieTypes | None:
+        """
+        Merge a cookies argument together with any cookies on the client,
+        to create the cookies used for the outgoing request.
+        """
+        if cookies or self.cookies:
+            merged_cookies = Cookies(self.cookies)
+            merged_cookies.update(cookies)
+            return merged_cookies
+        return cookies
+
+    def _merge_headers(self, headers: HeaderTypes | None = None) -> HeaderTypes | None:
+        """
+        Merge a headers argument together with any headers on the client,
+        to create the headers used for the outgoing request.
+        """
+        merged_headers = Headers(self.headers)
+        merged_headers.update(headers)
+        return merged_headers
+
+    def _merge_queryparams(
+        self, params: QueryParamTypes | None = None
+    ) -> QueryParamTypes | None:
+        """
+        Merge a queryparams argument together with any queryparams on the client,
+        to create the queryparams used for the outgoing request.
+        """
+        if params or self.params:
+            merged_queryparams = QueryParams(self.params)
+            return merged_queryparams.merge(params)
+        return params
+
+    def _build_auth(self, auth: AuthTypes | None) -> Auth | None:
+        if auth is None:
+            return None
+        elif isinstance(auth, tuple):
+            return BasicAuth(username=auth[0], password=auth[1])
+        elif isinstance(auth, Auth):
+            return auth
+        elif callable(auth):
+            return FunctionAuth(func=auth)
+        else:
+            raise TypeError(f'Invalid "auth" argument: {auth!r}')
+
+    def _build_request_auth(
+        self,
+        request: Request,
+        auth: AuthTypes | UseClientDefault | None = USE_CLIENT_DEFAULT,
+    ) -> Auth:
+        auth = (
+            self._auth if isinstance(auth, UseClientDefault) else self._build_auth(auth)
+        )
+
+        if auth is not None:
+            return auth
+
+        username, password = request.url.username, request.url.password
+        if username or password:
+            return BasicAuth(username=username, password=password)
+
+        return Auth()
+
+    def _build_redirect_request(self, request: Request, response: Response) -> Request:
+        """
+        Given a request and a redirect response, return a new request that
+        should be used to effect the redirect.
+        """
+        method = self._redirect_method(request, response)
+        url = self._redirect_url(request, response)
+        headers = self._redirect_headers(request, url, method)
+        stream = self._redirect_stream(request, method)
+        cookies = Cookies(self.cookies)
+        return Request(
+            method=method,
+            url=url,
+            headers=headers,
+            cookies=cookies,
+            stream=stream,
+            extensions=request.extensions,
+        )
+
+    def _redirect_method(self, request: Request, response: Response) -> str:
+        """
+        When being redirected we may want to change the method of the request
+        based on certain specs or browser behavior.
+        """
+        method = request.method
+
+        # https://tools.ietf.org/html/rfc7231#section-6.4.4
+        if response.status_code == codes.SEE_OTHER and method != "HEAD":
+            method = "GET"
+
+        # Do what the browsers do, despite standards...
+        # Turn 302s into GETs.
+        if response.status_code == codes.FOUND and method != "HEAD":
+            method = "GET"
+
+        # If a POST is responded to with a 301, turn it into a GET.
+        # This bizarre behaviour is explained in 'requests' issue 1704.
+        if response.status_code == codes.MOVED_PERMANENTLY and method == "POST":
+            method = "GET"
+
+        return method
+
+    def _redirect_url(self, request: Request, response: Response) -> URL:
+        """
+        Return the URL for the redirect to follow.
+        """
+        location = response.headers["Location"]
+
+        try:
+            url = URL(location)
+        except InvalidURL as exc:
+            raise RemoteProtocolError(
+                f"Invalid URL in location header: {exc}.", request=request
+            ) from None
+
+        # Handle malformed 'Location' headers that are "absolute" form, have no host.
+        # See: https://github.com/encode/httpx/issues/771
+        if url.scheme and not url.host:
+            url = url.copy_with(host=request.url.host)
+
+        # Facilitate relative 'Location' headers, as allowed by RFC 7231.
+        # (e.g. '/path/to/resource' instead of 'http://domain.tld/path/to/resource')
+        if url.is_relative_url:
+            url = request.url.join(url)
+
+        # Attach previous fragment if needed (RFC 7231 7.1.2)
+        if request.url.fragment and not url.fragment:
+            url = url.copy_with(fragment=request.url.fragment)
+
+        return url
+
+    def _redirect_headers(self, request: Request, url: URL, method: str) -> Headers:
+        """
+        Return the headers that should be used for the redirect request.
+        """
+        headers = Headers(request.headers)
+
+        if not same_origin(url, request.url):
+            if not is_https_redirect(request.url, url):
+                # Strip Authorization headers when responses are redirected
+                # away from the origin. (Except for direct HTTP to HTTPS redirects.)
+                headers.pop("Authorization", None)
+
+            # Update the Host header.
+            headers["Host"] = url.netloc.decode("ascii")
+
+        if method != request.method and method == "GET":
+            # If we've switch to a 'GET' request, then strip any headers which
+            # are only relevant to the request body.
+            headers.pop("Content-Length", None)
+            headers.pop("Transfer-Encoding", None)
+
+        # We should use the client cookie store to determine any cookie header,
+        # rather than whatever was on the original outgoing request.
+        headers.pop("Cookie", None)
+
+        return headers
+
+    def _redirect_stream(
+        self, request: Request, method: str
+    ) -> SyncByteStream | AsyncByteStream | None:
+        """
+        Return the body that should be used for the redirect request.
+        """
+        if method != request.method and method == "GET":
+            return None
+
+        return request.stream
+
+
+class Client(BaseClient):
+    """
+    An HTTP client, with connection pooling, HTTP/2, redirects, cookie persistence, etc.
+
+    It can be shared between threads.
+
+    Usage:
+
+    ```python
+    >>> client = httpx.Client()
+    >>> response = client.get('https://example.org')
+    ```
+
+    **Parameters:**
+
+    * **auth** - *(optional)* An authentication class to use when sending
+    requests.
+    * **params** - *(optional)* Query parameters to include in request URLs, as
+    a string, dictionary, or sequence of two-tuples.
+    * **headers** - *(optional)* Dictionary of HTTP headers to include when
+    sending requests.
+    * **cookies** - *(optional)* Dictionary of Cookie items to include when
+    sending requests.
+    * **verify** - *(optional)* SSL certificates (a.k.a CA bundle) used to
+    verify the identity of requested hosts. Either `True` (default CA bundle),
+    a path to an SSL certificate file, an `ssl.SSLContext`, or `False`
+    (which will disable verification).
+    * **cert** - *(optional)* An SSL certificate used by the requested host
+    to authenticate the client. Either a path to an SSL certificate file, or
+    two-tuple of (certificate file, key file), or a three-tuple of (certificate
+    file, key file, password).
+    * **http2** - *(optional)* A boolean indicating if HTTP/2 support should be
+    enabled. Defaults to `False`.
+    * **proxy** - *(optional)* A proxy URL where all the traffic should be routed.
+    * **proxies** - *(optional)* A dictionary mapping proxy keys to proxy
+    URLs.
+    * **timeout** - *(optional)* The timeout configuration to use when sending
+    requests.
+    * **limits** - *(optional)* The limits configuration to use.
+    * **max_redirects** - *(optional)* The maximum number of redirect responses
+    that should be followed.
+    * **base_url** - *(optional)* A URL to use as the base when building
+    request URLs.
+    * **transport** - *(optional)* A transport class to use for sending requests
+    over the network.
+    * **app** - *(optional)* An WSGI application to send requests to,
+    rather than sending actual network requests.
+    * **trust_env** - *(optional)* Enables or disables usage of environment
+    variables for configuration.
+    * **default_encoding** - *(optional)* The default encoding to use for decoding
+    response text, if no charset information is included in a response Content-Type
+    header. Set to a callable for automatic character set detection. Default: "utf-8".
+    """
+
+    def __init__(
+        self,
+        *,
+        auth: AuthTypes | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        verify: VerifyTypes = True,
+        cert: CertTypes | None = None,
+        http1: bool = True,
+        http2: bool = False,
+        proxy: ProxyTypes | None = None,
+        proxies: ProxiesTypes | None = None,
+        mounts: None | (typing.Mapping[str, BaseTransport | None]) = None,
+        timeout: TimeoutTypes = DEFAULT_TIMEOUT_CONFIG,
+        follow_redirects: bool = False,
+        limits: Limits = DEFAULT_LIMITS,
+        max_redirects: int = DEFAULT_MAX_REDIRECTS,
+        event_hooks: None | (typing.Mapping[str, list[EventHook]]) = None,
+        base_url: URLTypes = "",
+        transport: BaseTransport | None = None,
+        app: typing.Callable[..., typing.Any] | None = None,
+        trust_env: bool = True,
+        default_encoding: str | typing.Callable[[bytes], str] = "utf-8",
+    ) -> None:
+        super().__init__(
+            auth=auth,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            timeout=timeout,
+            follow_redirects=follow_redirects,
+            max_redirects=max_redirects,
+            event_hooks=event_hooks,
+            base_url=base_url,
+            trust_env=trust_env,
+            default_encoding=default_encoding,
+        )
+
+        if http2:
+            try:
+                import h2  # noqa
+            except ImportError:  # pragma: no cover
+                raise ImportError(
+                    "Using http2=True, but the 'h2' package is not installed. "
+                    "Make sure to install httpx using `pip install httpx[http2]`."
+                ) from None
+
+        if proxies:
+            message = (
+                "The 'proxies' argument is now deprecated."
+                " Use 'proxy' or 'mounts' instead."
+            )
+            warnings.warn(message, DeprecationWarning)
+            if proxy:
+                raise RuntimeError("Use either `proxy` or 'proxies', not both.")
+
+        if app:
+            message = (
+                "The 'app' shortcut is now deprecated."
+                " Use the explicit style 'transport=WSGITransport(app=...)' instead."
+            )
+            warnings.warn(message, DeprecationWarning)
+
+        allow_env_proxies = trust_env and app is None and transport is None
+        proxy_map = self._get_proxy_map(proxies or proxy, allow_env_proxies)
+
+        self._transport = self._init_transport(
+            verify=verify,
+            cert=cert,
+            http1=http1,
+            http2=http2,
+            limits=limits,
+            transport=transport,
+            app=app,
+            trust_env=trust_env,
+        )
+        self._mounts: dict[URLPattern, BaseTransport | None] = {
+            URLPattern(key): None
+            if proxy is None
+            else self._init_proxy_transport(
+                proxy,
+                verify=verify,
+                cert=cert,
+                http1=http1,
+                http2=http2,
+                limits=limits,
+                trust_env=trust_env,
+            )
+            for key, proxy in proxy_map.items()
+        }
+        if mounts is not None:
+            self._mounts.update(
+                {URLPattern(key): transport for key, transport in mounts.items()}
+            )
+
+        self._mounts = dict(sorted(self._mounts.items()))
+
+    def _init_transport(
+        self,
+        verify: VerifyTypes = True,
+        cert: CertTypes | None = None,
+        http1: bool = True,
+        http2: bool = False,
+        limits: Limits = DEFAULT_LIMITS,
+        transport: BaseTransport | None = None,
+        app: typing.Callable[..., typing.Any] | None = None,
+        trust_env: bool = True,
+    ) -> BaseTransport:
+        if transport is not None:
+            return transport
+
+        if app is not None:
+            return WSGITransport(app=app)
+
+        return HTTPTransport(
+            verify=verify,
+            cert=cert,
+            http1=http1,
+            http2=http2,
+            limits=limits,
+            trust_env=trust_env,
+        )
+
+    def _init_proxy_transport(
+        self,
+        proxy: Proxy,
+        verify: VerifyTypes = True,
+        cert: CertTypes | None = None,
+        http1: bool = True,
+        http2: bool = False,
+        limits: Limits = DEFAULT_LIMITS,
+        trust_env: bool = True,
+    ) -> BaseTransport:
+        return HTTPTransport(
+            verify=verify,
+            cert=cert,
+            http1=http1,
+            http2=http2,
+            limits=limits,
+            trust_env=trust_env,
+            proxy=proxy,
+        )
+
+    def _transport_for_url(self, url: URL) -> BaseTransport:
+        """
+        Returns the transport instance that should be used for a given URL.
+        This will either be the standard connection pool, or a proxy.
+        """
+        for pattern, transport in self._mounts.items():
+            if pattern.matches(url):
+                return self._transport if transport is None else transport
+
+        return self._transport
+
+    def request(
+        self,
+        method: str,
+        url: URLTypes,
+        *,
+        content: RequestContent | None = None,
+        data: RequestData | None = None,
+        files: RequestFiles | None = None,
+        json: typing.Any | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault | None = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Build and send a request.
+
+        Equivalent to:
+
+        ```python
+        request = client.build_request(...)
+        response = client.send(request, ...)
+        ```
+
+        See `Client.build_request()`, `Client.send()` and
+        [Merging of configuration][0] for how the various parameters
+        are merged with client-level configuration.
+
+        [0]: /advanced/#merging-of-configuration
+        """
+        if cookies is not None:
+            message = (
+                "Setting per-request cookies=<...> is being deprecated, because "
+                "the expected behaviour on cookie persistence is ambiguous. Set "
+                "cookies directly on the client instance instead."
+            )
+            warnings.warn(message, DeprecationWarning)
+
+        request = self.build_request(
+            method=method,
+            url=url,
+            content=content,
+            data=data,
+            files=files,
+            json=json,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            timeout=timeout,
+            extensions=extensions,
+        )
+        return self.send(request, auth=auth, follow_redirects=follow_redirects)
+
+    @contextmanager
+    def stream(
+        self,
+        method: str,
+        url: URLTypes,
+        *,
+        content: RequestContent | None = None,
+        data: RequestData | None = None,
+        files: RequestFiles | None = None,
+        json: typing.Any | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault | None = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> typing.Iterator[Response]:
+        """
+        Alternative to `httpx.request()` that streams the response body
+        instead of loading it into memory at once.
+
+        **Parameters**: See `httpx.request`.
+
+        See also: [Streaming Responses][0]
+
+        [0]: /quickstart#streaming-responses
+        """
+        request = self.build_request(
+            method=method,
+            url=url,
+            content=content,
+            data=data,
+            files=files,
+            json=json,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            timeout=timeout,
+            extensions=extensions,
+        )
+        response = self.send(
+            request=request,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            stream=True,
+        )
+        try:
+            yield response
+        finally:
+            response.close()
+
+    def send(
+        self,
+        request: Request,
+        *,
+        stream: bool = False,
+        auth: AuthTypes | UseClientDefault | None = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+    ) -> Response:
+        """
+        Send a request.
+
+        The request is sent as-is, unmodified.
+
+        Typically you'll want to build one with `Client.build_request()`
+        so that any client-level configuration is merged into the request,
+        but passing an explicit `httpx.Request()` is supported as well.
+
+        See also: [Request instances][0]
+
+        [0]: /advanced/#request-instances
+        """
+        if self._state == ClientState.CLOSED:
+            raise RuntimeError("Cannot send a request, as the client has been closed.")
+
+        self._state = ClientState.OPENED
+        follow_redirects = (
+            self.follow_redirects
+            if isinstance(follow_redirects, UseClientDefault)
+            else follow_redirects
+        )
+
+        auth = self._build_request_auth(request, auth)
+
+        response = self._send_handling_auth(
+            request,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            history=[],
+        )
+        try:
+            if not stream:
+                response.read()
+
+            return response
+
+        except BaseException as exc:
+            response.close()
+            raise exc
+
+    def _send_handling_auth(
+        self,
+        request: Request,
+        auth: Auth,
+        follow_redirects: bool,
+        history: list[Response],
+    ) -> Response:
+        auth_flow = auth.sync_auth_flow(request)
+        try:
+            request = next(auth_flow)
+
+            while True:
+                response = self._send_handling_redirects(
+                    request,
+                    follow_redirects=follow_redirects,
+                    history=history,
+                )
+                try:
+                    try:
+                        next_request = auth_flow.send(response)
+                    except StopIteration:
+                        return response
+
+                    response.history = list(history)
+                    response.read()
+                    request = next_request
+                    history.append(response)
+
+                except BaseException as exc:
+                    response.close()
+                    raise exc
+        finally:
+            auth_flow.close()
+
+    def _send_handling_redirects(
+        self,
+        request: Request,
+        follow_redirects: bool,
+        history: list[Response],
+    ) -> Response:
+        while True:
+            if len(history) > self.max_redirects:
+                raise TooManyRedirects(
+                    "Exceeded maximum allowed redirects.", request=request
+                )
+
+            for hook in self._event_hooks["request"]:
+                hook(request)
+
+            response = self._send_single_request(request)
+            try:
+                for hook in self._event_hooks["response"]:
+                    hook(response)
+                response.history = list(history)
+
+                if not response.has_redirect_location:
+                    return response
+
+                request = self._build_redirect_request(request, response)
+                history = history + [response]
+
+                if follow_redirects:
+                    response.read()
+                else:
+                    response.next_request = request
+                    return response
+
+            except BaseException as exc:
+                response.close()
+                raise exc
+
+    def _send_single_request(self, request: Request) -> Response:
+        """
+        Sends a single request, without handling any redirections.
+        """
+        transport = self._transport_for_url(request.url)
+        timer = Timer()
+        timer.sync_start()
+
+        if not isinstance(request.stream, SyncByteStream):
+            raise RuntimeError(
+                "Attempted to send an async request with a sync Client instance."
+            )
+
+        with request_context(request=request):
+            response = transport.handle_request(request)
+
+        assert isinstance(response.stream, SyncByteStream)
+
+        response.request = request
+        response.stream = BoundSyncStream(
+            response.stream, response=response, timer=timer
+        )
+        self.cookies.extract_cookies(response)
+        response.default_encoding = self._default_encoding
+
+        logger.info(
+            'HTTP Request: %s %s "%s %d %s"',
+            request.method,
+            request.url,
+            response.http_version,
+            response.status_code,
+            response.reason_phrase,
+        )
+
+        return response
+
+    def get(
+        self,
+        url: URLTypes,
+        *,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send a `GET` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return self.request(
+            "GET",
+            url,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    def options(
+        self,
+        url: URLTypes,
+        *,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send an `OPTIONS` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return self.request(
+            "OPTIONS",
+            url,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    def head(
+        self,
+        url: URLTypes,
+        *,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send a `HEAD` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return self.request(
+            "HEAD",
+            url,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    def post(
+        self,
+        url: URLTypes,
+        *,
+        content: RequestContent | None = None,
+        data: RequestData | None = None,
+        files: RequestFiles | None = None,
+        json: typing.Any | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send a `POST` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return self.request(
+            "POST",
+            url,
+            content=content,
+            data=data,
+            files=files,
+            json=json,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    def put(
+        self,
+        url: URLTypes,
+        *,
+        content: RequestContent | None = None,
+        data: RequestData | None = None,
+        files: RequestFiles | None = None,
+        json: typing.Any | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send a `PUT` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return self.request(
+            "PUT",
+            url,
+            content=content,
+            data=data,
+            files=files,
+            json=json,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    def patch(
+        self,
+        url: URLTypes,
+        *,
+        content: RequestContent | None = None,
+        data: RequestData | None = None,
+        files: RequestFiles | None = None,
+        json: typing.Any | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send a `PATCH` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return self.request(
+            "PATCH",
+            url,
+            content=content,
+            data=data,
+            files=files,
+            json=json,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    def delete(
+        self,
+        url: URLTypes,
+        *,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send a `DELETE` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return self.request(
+            "DELETE",
+            url,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    def close(self) -> None:
+        """
+        Close transport and proxies.
+        """
+        if self._state != ClientState.CLOSED:
+            self._state = ClientState.CLOSED
+
+            self._transport.close()
+            for transport in self._mounts.values():
+                if transport is not None:
+                    transport.close()
+
+    def __enter__(self: T) -> T:
+        if self._state != ClientState.UNOPENED:
+            msg = {
+                ClientState.OPENED: "Cannot open a client instance more than once.",
+                ClientState.CLOSED: (
+                    "Cannot reopen a client instance, once it has been closed."
+                ),
+            }[self._state]
+            raise RuntimeError(msg)
+
+        self._state = ClientState.OPENED
+
+        self._transport.__enter__()
+        for transport in self._mounts.values():
+            if transport is not None:
+                transport.__enter__()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None = None,
+        exc_value: BaseException | None = None,
+        traceback: TracebackType | None = None,
+    ) -> None:
+        self._state = ClientState.CLOSED
+
+        self._transport.__exit__(exc_type, exc_value, traceback)
+        for transport in self._mounts.values():
+            if transport is not None:
+                transport.__exit__(exc_type, exc_value, traceback)
+
+
+class AsyncClient(BaseClient):
+    """
+    An asynchronous HTTP client, with connection pooling, HTTP/2, redirects,
+    cookie persistence, etc.
+
+    It can be shared between tasks.
+
+    Usage:
+
+    ```python
+    >>> async with httpx.AsyncClient() as client:
+    >>>     response = await client.get('https://example.org')
+    ```
+
+    **Parameters:**
+
+    * **auth** - *(optional)* An authentication class to use when sending
+    requests.
+    * **params** - *(optional)* Query parameters to include in request URLs, as
+    a string, dictionary, or sequence of two-tuples.
+    * **headers** - *(optional)* Dictionary of HTTP headers to include when
+    sending requests.
+    * **cookies** - *(optional)* Dictionary of Cookie items to include when
+    sending requests.
+    * **verify** - *(optional)* SSL certificates (a.k.a CA bundle) used to
+    verify the identity of requested hosts. Either `True` (default CA bundle),
+    a path to an SSL certificate file, an `ssl.SSLContext`, or `False`
+    (which will disable verification).
+    * **cert** - *(optional)* An SSL certificate used by the requested host
+    to authenticate the client. Either a path to an SSL certificate file, or
+    two-tuple of (certificate file, key file), or a three-tuple of (certificate
+    file, key file, password).
+    * **http2** - *(optional)* A boolean indicating if HTTP/2 support should be
+    enabled. Defaults to `False`.
+    * **proxy** - *(optional)* A proxy URL where all the traffic should be routed.
+    * **proxies** - *(optional)* A dictionary mapping HTTP protocols to proxy
+    URLs.
+    * **timeout** - *(optional)* The timeout configuration to use when sending
+    requests.
+    * **limits** - *(optional)* The limits configuration to use.
+    * **max_redirects** - *(optional)* The maximum number of redirect responses
+    that should be followed.
+    * **base_url** - *(optional)* A URL to use as the base when building
+    request URLs.
+    * **transport** - *(optional)* A transport class to use for sending requests
+    over the network.
+    * **app** - *(optional)* An ASGI application to send requests to,
+    rather than sending actual network requests.
+    * **trust_env** - *(optional)* Enables or disables usage of environment
+    variables for configuration.
+    * **default_encoding** - *(optional)* The default encoding to use for decoding
+    response text, if no charset information is included in a response Content-Type
+    header. Set to a callable for automatic character set detection. Default: "utf-8".
+    """
+
+    def __init__(
+        self,
+        *,
+        auth: AuthTypes | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        verify: VerifyTypes = True,
+        cert: CertTypes | None = None,
+        http1: bool = True,
+        http2: bool = False,
+        proxy: ProxyTypes | None = None,
+        proxies: ProxiesTypes | None = None,
+        mounts: None | (typing.Mapping[str, AsyncBaseTransport | None]) = None,
+        timeout: TimeoutTypes = DEFAULT_TIMEOUT_CONFIG,
+        follow_redirects: bool = False,
+        limits: Limits = DEFAULT_LIMITS,
+        max_redirects: int = DEFAULT_MAX_REDIRECTS,
+        event_hooks: None
+        | (typing.Mapping[str, list[typing.Callable[..., typing.Any]]]) = None,
+        base_url: URLTypes = "",
+        transport: AsyncBaseTransport | None = None,
+        app: typing.Callable[..., typing.Any] | None = None,
+        trust_env: bool = True,
+        default_encoding: str | typing.Callable[[bytes], str] = "utf-8",
+    ) -> None:
+        super().__init__(
+            auth=auth,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            timeout=timeout,
+            follow_redirects=follow_redirects,
+            max_redirects=max_redirects,
+            event_hooks=event_hooks,
+            base_url=base_url,
+            trust_env=trust_env,
+            default_encoding=default_encoding,
+        )
+
+        if http2:
+            try:
+                import h2  # noqa
+            except ImportError:  # pragma: no cover
+                raise ImportError(
+                    "Using http2=True, but the 'h2' package is not installed. "
+                    "Make sure to install httpx using `pip install httpx[http2]`."
+                ) from None
+
+        if proxies:
+            message = (
+                "The 'proxies' argument is now deprecated."
+                " Use 'proxy' or 'mounts' instead."
+            )
+            warnings.warn(message, DeprecationWarning)
+            if proxy:
+                raise RuntimeError("Use either `proxy` or 'proxies', not both.")
+
+        if app:
+            message = (
+                "The 'app' shortcut is now deprecated."
+                " Use the explicit style 'transport=ASGITransport(app=...)' instead."
+            )
+            warnings.warn(message, DeprecationWarning)
+
+        allow_env_proxies = trust_env and transport is None
+        proxy_map = self._get_proxy_map(proxies or proxy, allow_env_proxies)
+
+        self._transport = self._init_transport(
+            verify=verify,
+            cert=cert,
+            http1=http1,
+            http2=http2,
+            limits=limits,
+            transport=transport,
+            app=app,
+            trust_env=trust_env,
+        )
+
+        self._mounts: dict[URLPattern, AsyncBaseTransport | None] = {
+            URLPattern(key): None
+            if proxy is None
+            else self._init_proxy_transport(
+                proxy,
+                verify=verify,
+                cert=cert,
+                http1=http1,
+                http2=http2,
+                limits=limits,
+                trust_env=trust_env,
+            )
+            for key, proxy in proxy_map.items()
+        }
+        if mounts is not None:
+            self._mounts.update(
+                {URLPattern(key): transport for key, transport in mounts.items()}
+            )
+        self._mounts = dict(sorted(self._mounts.items()))
+
+    def _init_transport(
+        self,
+        verify: VerifyTypes = True,
+        cert: CertTypes | None = None,
+        http1: bool = True,
+        http2: bool = False,
+        limits: Limits = DEFAULT_LIMITS,
+        transport: AsyncBaseTransport | None = None,
+        app: typing.Callable[..., typing.Any] | None = None,
+        trust_env: bool = True,
+    ) -> AsyncBaseTransport:
+        if transport is not None:
+            return transport
+
+        if app is not None:
+            return ASGITransport(app=app)
+
+        return AsyncHTTPTransport(
+            verify=verify,
+            cert=cert,
+            http1=http1,
+            http2=http2,
+            limits=limits,
+            trust_env=trust_env,
+        )
+
+    def _init_proxy_transport(
+        self,
+        proxy: Proxy,
+        verify: VerifyTypes = True,
+        cert: CertTypes | None = None,
+        http1: bool = True,
+        http2: bool = False,
+        limits: Limits = DEFAULT_LIMITS,
+        trust_env: bool = True,
+    ) -> AsyncBaseTransport:
+        return AsyncHTTPTransport(
+            verify=verify,
+            cert=cert,
+            http1=http1,
+            http2=http2,
+            limits=limits,
+            trust_env=trust_env,
+            proxy=proxy,
+        )
+
+    def _transport_for_url(self, url: URL) -> AsyncBaseTransport:
+        """
+        Returns the transport instance that should be used for a given URL.
+        This will either be the standard connection pool, or a proxy.
+        """
+        for pattern, transport in self._mounts.items():
+            if pattern.matches(url):
+                return self._transport if transport is None else transport
+
+        return self._transport
+
+    async def request(
+        self,
+        method: str,
+        url: URLTypes,
+        *,
+        content: RequestContent | None = None,
+        data: RequestData | None = None,
+        files: RequestFiles | None = None,
+        json: typing.Any | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault | None = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Build and send a request.
+
+        Equivalent to:
+
+        ```python
+        request = client.build_request(...)
+        response = await client.send(request, ...)
+        ```
+
+        See `AsyncClient.build_request()`, `AsyncClient.send()`
+        and [Merging of configuration][0] for how the various parameters
+        are merged with client-level configuration.
+
+        [0]: /advanced/#merging-of-configuration
+        """
+
+        if cookies is not None:  # pragma: no cover
+            message = (
+                "Setting per-request cookies=<...> is being deprecated, because "
+                "the expected behaviour on cookie persistence is ambiguous. Set "
+                "cookies directly on the client instance instead."
+            )
+            warnings.warn(message, DeprecationWarning)
+
+        request = self.build_request(
+            method=method,
+            url=url,
+            content=content,
+            data=data,
+            files=files,
+            json=json,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            timeout=timeout,
+            extensions=extensions,
+        )
+        return await self.send(request, auth=auth, follow_redirects=follow_redirects)
+
+    @asynccontextmanager
+    async def stream(
+        self,
+        method: str,
+        url: URLTypes,
+        *,
+        content: RequestContent | None = None,
+        data: RequestData | None = None,
+        files: RequestFiles | None = None,
+        json: typing.Any | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> typing.AsyncIterator[Response]:
+        """
+        Alternative to `httpx.request()` that streams the response body
+        instead of loading it into memory at once.
+
+        **Parameters**: See `httpx.request`.
+
+        See also: [Streaming Responses][0]
+
+        [0]: /quickstart#streaming-responses
+        """
+        request = self.build_request(
+            method=method,
+            url=url,
+            content=content,
+            data=data,
+            files=files,
+            json=json,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            timeout=timeout,
+            extensions=extensions,
+        )
+        response = await self.send(
+            request=request,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            stream=True,
+        )
+        try:
+            yield response
+        finally:
+            await response.aclose()
+
+    async def send(
+        self,
+        request: Request,
+        *,
+        stream: bool = False,
+        auth: AuthTypes | UseClientDefault | None = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+    ) -> Response:
+        """
+        Send a request.
+
+        The request is sent as-is, unmodified.
+
+        Typically you'll want to build one with `AsyncClient.build_request()`
+        so that any client-level configuration is merged into the request,
+        but passing an explicit `httpx.Request()` is supported as well.
+
+        See also: [Request instances][0]
+
+        [0]: /advanced/#request-instances
+        """
+        if self._state == ClientState.CLOSED:
+            raise RuntimeError("Cannot send a request, as the client has been closed.")
+
+        self._state = ClientState.OPENED
+        follow_redirects = (
+            self.follow_redirects
+            if isinstance(follow_redirects, UseClientDefault)
+            else follow_redirects
+        )
+
+        auth = self._build_request_auth(request, auth)
+
+        response = await self._send_handling_auth(
+            request,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            history=[],
+        )
+        try:
+            if not stream:
+                await response.aread()
+
+            return response
+
+        except BaseException as exc:
+            await response.aclose()
+            raise exc
+
+    async def _send_handling_auth(
+        self,
+        request: Request,
+        auth: Auth,
+        follow_redirects: bool,
+        history: list[Response],
+    ) -> Response:
+        auth_flow = auth.async_auth_flow(request)
+        try:
+            request = await auth_flow.__anext__()
+
+            while True:
+                response = await self._send_handling_redirects(
+                    request,
+                    follow_redirects=follow_redirects,
+                    history=history,
+                )
+                try:
+                    try:
+                        next_request = await auth_flow.asend(response)
+                    except StopAsyncIteration:
+                        return response
+
+                    response.history = list(history)
+                    await response.aread()
+                    request = next_request
+                    history.append(response)
+
+                except BaseException as exc:
+                    await response.aclose()
+                    raise exc
+        finally:
+            await auth_flow.aclose()
+
+    async def _send_handling_redirects(
+        self,
+        request: Request,
+        follow_redirects: bool,
+        history: list[Response],
+    ) -> Response:
+        while True:
+            if len(history) > self.max_redirects:
+                raise TooManyRedirects(
+                    "Exceeded maximum allowed redirects.", request=request
+                )
+
+            for hook in self._event_hooks["request"]:
+                await hook(request)
+
+            response = await self._send_single_request(request)
+            try:
+                for hook in self._event_hooks["response"]:
+                    await hook(response)
+
+                response.history = list(history)
+
+                if not response.has_redirect_location:
+                    return response
+
+                request = self._build_redirect_request(request, response)
+                history = history + [response]
+
+                if follow_redirects:
+                    await response.aread()
+                else:
+                    response.next_request = request
+                    return response
+
+            except BaseException as exc:
+                await response.aclose()
+                raise exc
+
+    async def _send_single_request(self, request: Request) -> Response:
+        """
+        Sends a single request, without handling any redirections.
+        """
+        transport = self._transport_for_url(request.url)
+        timer = Timer()
+        await timer.async_start()
+
+        if not isinstance(request.stream, AsyncByteStream):
+            raise RuntimeError(
+                "Attempted to send an sync request with an AsyncClient instance."
+            )
+
+        with request_context(request=request):
+            response = await transport.handle_async_request(request)
+
+        assert isinstance(response.stream, AsyncByteStream)
+        response.request = request
+        response.stream = BoundAsyncStream(
+            response.stream, response=response, timer=timer
+        )
+        self.cookies.extract_cookies(response)
+        response.default_encoding = self._default_encoding
+
+        logger.info(
+            'HTTP Request: %s %s "%s %d %s"',
+            request.method,
+            request.url,
+            response.http_version,
+            response.status_code,
+            response.reason_phrase,
+        )
+
+        return response
+
+    async def get(
+        self,
+        url: URLTypes,
+        *,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault | None = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send a `GET` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return await self.request(
+            "GET",
+            url,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    async def options(
+        self,
+        url: URLTypes,
+        *,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send an `OPTIONS` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return await self.request(
+            "OPTIONS",
+            url,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    async def head(
+        self,
+        url: URLTypes,
+        *,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send a `HEAD` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return await self.request(
+            "HEAD",
+            url,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    async def post(
+        self,
+        url: URLTypes,
+        *,
+        content: RequestContent | None = None,
+        data: RequestData | None = None,
+        files: RequestFiles | None = None,
+        json: typing.Any | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send a `POST` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return await self.request(
+            "POST",
+            url,
+            content=content,
+            data=data,
+            files=files,
+            json=json,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    async def put(
+        self,
+        url: URLTypes,
+        *,
+        content: RequestContent | None = None,
+        data: RequestData | None = None,
+        files: RequestFiles | None = None,
+        json: typing.Any | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send a `PUT` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return await self.request(
+            "PUT",
+            url,
+            content=content,
+            data=data,
+            files=files,
+            json=json,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    async def patch(
+        self,
+        url: URLTypes,
+        *,
+        content: RequestContent | None = None,
+        data: RequestData | None = None,
+        files: RequestFiles | None = None,
+        json: typing.Any | None = None,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send a `PATCH` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return await self.request(
+            "PATCH",
+            url,
+            content=content,
+            data=data,
+            files=files,
+            json=json,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    async def delete(
+        self,
+        url: URLTypes,
+        *,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
+        timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
+        extensions: RequestExtensions | None = None,
+    ) -> Response:
+        """
+        Send a `DELETE` request.
+
+        **Parameters**: See `httpx.request`.
+        """
+        return await self.request(
+            "DELETE",
+            url,
+            params=params,
+            headers=headers,
+            cookies=cookies,
+            auth=auth,
+            follow_redirects=follow_redirects,
+            timeout=timeout,
+            extensions=extensions,
+        )
+
+    async def aclose(self) -> None:
+        """
+        Close transport and proxies.
+        """
+        if self._state != ClientState.CLOSED:
+            self._state = ClientState.CLOSED
+
+            await self._transport.aclose()
+            for proxy in self._mounts.values():
+                if proxy is not None:
+                    await proxy.aclose()
+
+    async def __aenter__(self: U) -> U:
+        if self._state != ClientState.UNOPENED:
+            msg = {
+                ClientState.OPENED: "Cannot open a client instance more than once.",
+                ClientState.CLOSED: (
+                    "Cannot reopen a client instance, once it has been closed."
+                ),
+            }[self._state]
+            raise RuntimeError(msg)
+
+        self._state = ClientState.OPENED
+
+        await self._transport.__aenter__()
+        for proxy in self._mounts.values():
+            if proxy is not None:
+                await proxy.__aenter__()
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None = None,
+        exc_value: BaseException | None = None,
+        traceback: TracebackType | None = None,
+    ) -> None:
+        self._state = ClientState.CLOSED
+
+        await self._transport.__aexit__(exc_type, exc_value, traceback)
+        for proxy in self._mounts.values():
+            if proxy is not None:
+                await proxy.__aexit__(exc_type, exc_value, traceback)
diff --git a/llm/Lib/site-packages/httpx/_compat.py b/llm/Lib/site-packages/httpx/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..493e6210873f325422e0b2087827bd8c95e70e56
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_compat.py
@@ -0,0 +1,41 @@
+"""
+The _compat module is used for code which requires branching between different
+Python environments. It is excluded from the code coverage checks.
+"""
+import ssl
+import sys
+
+# Brotli support is optional
+# The C bindings in `brotli` are recommended for CPython.
+# The CFFI bindings in `brotlicffi` are recommended for PyPy and everything else.
+try:
+    import brotlicffi as brotli
+except ImportError:  # pragma: no cover
+    try:
+        import brotli
+    except ImportError:
+        brotli = None
+
+if sys.version_info >= (3, 10) or ssl.OPENSSL_VERSION_INFO >= (1, 1, 0, 7):
+
+    def set_minimum_tls_version_1_2(context: ssl.SSLContext) -> None:
+        # The OP_NO_SSL* and OP_NO_TLS* become deprecated in favor of
+        # 'SSLContext.minimum_version' from Python 3.7 onwards, however
+        # this attribute is not available unless the ssl module is compiled
+        # with OpenSSL 1.1.0g or newer.
+        # https://docs.python.org/3.10/library/ssl.html#ssl.SSLContext.minimum_version
+        # https://docs.python.org/3.7/library/ssl.html#ssl.SSLContext.minimum_version
+        context.minimum_version = ssl.TLSVersion.TLSv1_2
+
+else:
+
+    def set_minimum_tls_version_1_2(context: ssl.SSLContext) -> None:
+        # If 'minimum_version' isn't available, we configure these options with
+        # the older deprecated variants.
+        context.options |= ssl.OP_NO_SSLv2
+        context.options |= ssl.OP_NO_SSLv3
+        context.options |= ssl.OP_NO_TLSv1
+        context.options |= ssl.OP_NO_TLSv1_1
+
+
+__all__ = ["brotli", "set_minimum_tls_version_1_2"]
diff --git a/llm/Lib/site-packages/httpx/_config.py b/llm/Lib/site-packages/httpx/_config.py
new file mode 100644
index 0000000000000000000000000000000000000000..7636a5dcc5802ff44ca02a0bd0b1fcb51c0bc2c0
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_config.py
@@ -0,0 +1,370 @@
+from __future__ import annotations
+
+import logging
+import os
+import ssl
+import typing
+from pathlib import Path
+
+import certifi
+
+from ._compat import set_minimum_tls_version_1_2
+from ._models import Headers
+from ._types import CertTypes, HeaderTypes, TimeoutTypes, URLTypes, VerifyTypes
+from ._urls import URL
+from ._utils import get_ca_bundle_from_env
+
+DEFAULT_CIPHERS = ":".join(
+    [
+        "ECDHE+AESGCM",
+        "ECDHE+CHACHA20",
+        "DHE+AESGCM",
+        "DHE+CHACHA20",
+        "ECDH+AESGCM",
+        "DH+AESGCM",
+        "ECDH+AES",
+        "DH+AES",
+        "RSA+AESGCM",
+        "RSA+AES",
+        "!aNULL",
+        "!eNULL",
+        "!MD5",
+        "!DSS",
+    ]
+)
+
+
+logger = logging.getLogger("httpx")
+
+
+class UnsetType:
+    pass  # pragma: no cover
+
+
+UNSET = UnsetType()
+
+
+def create_ssl_context(
+    cert: CertTypes | None = None,
+    verify: VerifyTypes = True,
+    trust_env: bool = True,
+    http2: bool = False,
+) -> ssl.SSLContext:
+    return SSLConfig(
+        cert=cert, verify=verify, trust_env=trust_env, http2=http2
+    ).ssl_context
+
+
+class SSLConfig:
+    """
+    SSL Configuration.
+    """
+
+    DEFAULT_CA_BUNDLE_PATH = Path(certifi.where())
+
+    def __init__(
+        self,
+        *,
+        cert: CertTypes | None = None,
+        verify: VerifyTypes = True,
+        trust_env: bool = True,
+        http2: bool = False,
+    ) -> None:
+        self.cert = cert
+        self.verify = verify
+        self.trust_env = trust_env
+        self.http2 = http2
+        self.ssl_context = self.load_ssl_context()
+
+    def load_ssl_context(self) -> ssl.SSLContext:
+        logger.debug(
+            "load_ssl_context verify=%r cert=%r trust_env=%r http2=%r",
+            self.verify,
+            self.cert,
+            self.trust_env,
+            self.http2,
+        )
+
+        if self.verify:
+            return self.load_ssl_context_verify()
+        return self.load_ssl_context_no_verify()
+
+    def load_ssl_context_no_verify(self) -> ssl.SSLContext:
+        """
+        Return an SSL context for unverified connections.
+        """
+        context = self._create_default_ssl_context()
+        context.check_hostname = False
+        context.verify_mode = ssl.CERT_NONE
+        self._load_client_certs(context)
+        return context
+
+    def load_ssl_context_verify(self) -> ssl.SSLContext:
+        """
+        Return an SSL context for verified connections.
+        """
+        if self.trust_env and self.verify is True:
+            ca_bundle = get_ca_bundle_from_env()
+            if ca_bundle is not None:
+                self.verify = ca_bundle
+
+        if isinstance(self.verify, ssl.SSLContext):
+            # Allow passing in our own SSLContext object that's pre-configured.
+            context = self.verify
+            self._load_client_certs(context)
+            return context
+        elif isinstance(self.verify, bool):
+            ca_bundle_path = self.DEFAULT_CA_BUNDLE_PATH
+        elif Path(self.verify).exists():
+            ca_bundle_path = Path(self.verify)
+        else:
+            raise IOError(
+                "Could not find a suitable TLS CA certificate bundle, "
+                "invalid path: {}".format(self.verify)
+            )
+
+        context = self._create_default_ssl_context()
+        context.verify_mode = ssl.CERT_REQUIRED
+        context.check_hostname = True
+
+        # Signal to server support for PHA in TLS 1.3. Raises an
+        # AttributeError if only read-only access is implemented.
+        try:
+            context.post_handshake_auth = True
+        except AttributeError:  # pragma: no cover
+            pass
+
+        # Disable using 'commonName' for SSLContext.check_hostname
+        # when the 'subjectAltName' extension isn't available.
+        try:
+            context.hostname_checks_common_name = False
+        except AttributeError:  # pragma: no cover
+            pass
+
+        if ca_bundle_path.is_file():
+            cafile = str(ca_bundle_path)
+            logger.debug("load_verify_locations cafile=%r", cafile)
+            context.load_verify_locations(cafile=cafile)
+        elif ca_bundle_path.is_dir():
+            capath = str(ca_bundle_path)
+            logger.debug("load_verify_locations capath=%r", capath)
+            context.load_verify_locations(capath=capath)
+
+        self._load_client_certs(context)
+
+        return context
+
+    def _create_default_ssl_context(self) -> ssl.SSLContext:
+        """
+        Creates the default SSLContext object that's used for both verified
+        and unverified connections.
+        """
+        context = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
+        set_minimum_tls_version_1_2(context)
+        context.options |= ssl.OP_NO_COMPRESSION
+        context.set_ciphers(DEFAULT_CIPHERS)
+
+        if ssl.HAS_ALPN:
+            alpn_idents = ["http/1.1", "h2"] if self.http2 else ["http/1.1"]
+            context.set_alpn_protocols(alpn_idents)
+
+        keylogfile = os.environ.get("SSLKEYLOGFILE")
+        if keylogfile and self.trust_env:
+            context.keylog_filename = keylogfile
+
+        return context
+
+    def _load_client_certs(self, ssl_context: ssl.SSLContext) -> None:
+        """
+        Loads client certificates into our SSLContext object
+        """
+        if self.cert is not None:
+            if isinstance(self.cert, str):
+                ssl_context.load_cert_chain(certfile=self.cert)
+            elif isinstance(self.cert, tuple) and len(self.cert) == 2:
+                ssl_context.load_cert_chain(certfile=self.cert[0], keyfile=self.cert[1])
+            elif isinstance(self.cert, tuple) and len(self.cert) == 3:
+                ssl_context.load_cert_chain(
+                    certfile=self.cert[0],
+                    keyfile=self.cert[1],
+                    password=self.cert[2],
+                )
+
+
+class Timeout:
+    """
+    Timeout configuration.
+
+    **Usage**:
+
+    Timeout(None)               # No timeouts.
+    Timeout(5.0)                # 5s timeout on all operations.
+    Timeout(None, connect=5.0)  # 5s timeout on connect, no other timeouts.
+    Timeout(5.0, connect=10.0)  # 10s timeout on connect. 5s timeout elsewhere.
+    Timeout(5.0, pool=None)     # No timeout on acquiring connection from pool.
+                                # 5s timeout elsewhere.
+    """
+
+    def __init__(
+        self,
+        timeout: TimeoutTypes | UnsetType = UNSET,
+        *,
+        connect: None | float | UnsetType = UNSET,
+        read: None | float | UnsetType = UNSET,
+        write: None | float | UnsetType = UNSET,
+        pool: None | float | UnsetType = UNSET,
+    ) -> None:
+        if isinstance(timeout, Timeout):
+            # Passed as a single explicit Timeout.
+            assert connect is UNSET
+            assert read is UNSET
+            assert write is UNSET
+            assert pool is UNSET
+            self.connect = timeout.connect  # type: typing.Optional[float]
+            self.read = timeout.read  # type: typing.Optional[float]
+            self.write = timeout.write  # type: typing.Optional[float]
+            self.pool = timeout.pool  # type: typing.Optional[float]
+        elif isinstance(timeout, tuple):
+            # Passed as a tuple.
+            self.connect = timeout[0]
+            self.read = timeout[1]
+            self.write = None if len(timeout) < 3 else timeout[2]
+            self.pool = None if len(timeout) < 4 else timeout[3]
+        elif not (
+            isinstance(connect, UnsetType)
+            or isinstance(read, UnsetType)
+            or isinstance(write, UnsetType)
+            or isinstance(pool, UnsetType)
+        ):
+            self.connect = connect
+            self.read = read
+            self.write = write
+            self.pool = pool
+        else:
+            if isinstance(timeout, UnsetType):
+                raise ValueError(
+                    "httpx.Timeout must either include a default, or set all "
+                    "four parameters explicitly."
+                )
+            self.connect = timeout if isinstance(connect, UnsetType) else connect
+            self.read = timeout if isinstance(read, UnsetType) else read
+            self.write = timeout if isinstance(write, UnsetType) else write
+            self.pool = timeout if isinstance(pool, UnsetType) else pool
+
+    def as_dict(self) -> dict[str, float | None]:
+        return {
+            "connect": self.connect,
+            "read": self.read,
+            "write": self.write,
+            "pool": self.pool,
+        }
+
+    def __eq__(self, other: typing.Any) -> bool:
+        return (
+            isinstance(other, self.__class__)
+            and self.connect == other.connect
+            and self.read == other.read
+            and self.write == other.write
+            and self.pool == other.pool
+        )
+
+    def __repr__(self) -> str:
+        class_name = self.__class__.__name__
+        if len({self.connect, self.read, self.write, self.pool}) == 1:
+            return f"{class_name}(timeout={self.connect})"
+        return (
+            f"{class_name}(connect={self.connect}, "
+            f"read={self.read}, write={self.write}, pool={self.pool})"
+        )
+
+
+class Limits:
+    """
+    Configuration for limits to various client behaviors.
+
+    **Parameters:**
+
+    * **max_connections** - The maximum number of concurrent connections that may be
+            established.
+    * **max_keepalive_connections** - Allow the connection pool to maintain
+            keep-alive connections below this point. Should be less than or equal
+            to `max_connections`.
+    * **keepalive_expiry** - Time limit on idle keep-alive connections in seconds.
+    """
+
+    def __init__(
+        self,
+        *,
+        max_connections: int | None = None,
+        max_keepalive_connections: int | None = None,
+        keepalive_expiry: float | None = 5.0,
+    ) -> None:
+        self.max_connections = max_connections
+        self.max_keepalive_connections = max_keepalive_connections
+        self.keepalive_expiry = keepalive_expiry
+
+    def __eq__(self, other: typing.Any) -> bool:
+        return (
+            isinstance(other, self.__class__)
+            and self.max_connections == other.max_connections
+            and self.max_keepalive_connections == other.max_keepalive_connections
+            and self.keepalive_expiry == other.keepalive_expiry
+        )
+
+    def __repr__(self) -> str:
+        class_name = self.__class__.__name__
+        return (
+            f"{class_name}(max_connections={self.max_connections}, "
+            f"max_keepalive_connections={self.max_keepalive_connections}, "
+            f"keepalive_expiry={self.keepalive_expiry})"
+        )
+
+
+class Proxy:
+    def __init__(
+        self,
+        url: URLTypes,
+        *,
+        ssl_context: ssl.SSLContext | None = None,
+        auth: tuple[str, str] | None = None,
+        headers: HeaderTypes | None = None,
+    ) -> None:
+        url = URL(url)
+        headers = Headers(headers)
+
+        if url.scheme not in ("http", "https", "socks5"):
+            raise ValueError(f"Unknown scheme for proxy URL {url!r}")
+
+        if url.username or url.password:
+            # Remove any auth credentials from the URL.
+            auth = (url.username, url.password)
+            url = url.copy_with(username=None, password=None)
+
+        self.url = url
+        self.auth = auth
+        self.headers = headers
+        self.ssl_context = ssl_context
+
+    @property
+    def raw_auth(self) -> tuple[bytes, bytes] | None:
+        # The proxy authentication as raw bytes.
+        return (
+            None
+            if self.auth is None
+            else (self.auth[0].encode("utf-8"), self.auth[1].encode("utf-8"))
+        )
+
+    def __repr__(self) -> str:
+        # The authentication is represented with the password component masked.
+        auth = (self.auth[0], "********") if self.auth else None
+
+        # Build a nice concise representation.
+        url_str = f"{str(self.url)!r}"
+        auth_str = f", auth={auth!r}" if auth else ""
+        headers_str = f", headers={dict(self.headers)!r}" if self.headers else ""
+        return f"Proxy({url_str}{auth_str}{headers_str})"
+
+
+DEFAULT_TIMEOUT_CONFIG = Timeout(timeout=5.0)
+DEFAULT_LIMITS = Limits(max_connections=100, max_keepalive_connections=20)
+DEFAULT_MAX_REDIRECTS = 20
diff --git a/llm/Lib/site-packages/httpx/_content.py b/llm/Lib/site-packages/httpx/_content.py
new file mode 100644
index 0000000000000000000000000000000000000000..10b574bb3d7d8dfc62057407426d4b2a962c300c
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_content.py
@@ -0,0 +1,236 @@
+from __future__ import annotations
+
+import inspect
+import warnings
+from json import dumps as json_dumps
+from typing import (
+    Any,
+    AsyncIterable,
+    AsyncIterator,
+    Iterable,
+    Iterator,
+    Mapping,
+)
+from urllib.parse import urlencode
+
+from ._exceptions import StreamClosed, StreamConsumed
+from ._multipart import MultipartStream
+from ._types import (
+    AsyncByteStream,
+    RequestContent,
+    RequestData,
+    RequestFiles,
+    ResponseContent,
+    SyncByteStream,
+)
+from ._utils import peek_filelike_length, primitive_value_to_str
+
+
+class ByteStream(AsyncByteStream, SyncByteStream):
+    def __init__(self, stream: bytes) -> None:
+        self._stream = stream
+
+    def __iter__(self) -> Iterator[bytes]:
+        yield self._stream
+
+    async def __aiter__(self) -> AsyncIterator[bytes]:
+        yield self._stream
+
+
+class IteratorByteStream(SyncByteStream):
+    CHUNK_SIZE = 65_536
+
+    def __init__(self, stream: Iterable[bytes]) -> None:
+        self._stream = stream
+        self._is_stream_consumed = False
+        self._is_generator = inspect.isgenerator(stream)
+
+    def __iter__(self) -> Iterator[bytes]:
+        if self._is_stream_consumed and self._is_generator:
+            raise StreamConsumed()
+
+        self._is_stream_consumed = True
+        if hasattr(self._stream, "read"):
+            # File-like interfaces should use 'read' directly.
+            chunk = self._stream.read(self.CHUNK_SIZE)
+            while chunk:
+                yield chunk
+                chunk = self._stream.read(self.CHUNK_SIZE)
+        else:
+            # Otherwise iterate.
+            for part in self._stream:
+                yield part
+
+
+class AsyncIteratorByteStream(AsyncByteStream):
+    CHUNK_SIZE = 65_536
+
+    def __init__(self, stream: AsyncIterable[bytes]) -> None:
+        self._stream = stream
+        self._is_stream_consumed = False
+        self._is_generator = inspect.isasyncgen(stream)
+
+    async def __aiter__(self) -> AsyncIterator[bytes]:
+        if self._is_stream_consumed and self._is_generator:
+            raise StreamConsumed()
+
+        self._is_stream_consumed = True
+        if hasattr(self._stream, "aread"):
+            # File-like interfaces should use 'aread' directly.
+            chunk = await self._stream.aread(self.CHUNK_SIZE)
+            while chunk:
+                yield chunk
+                chunk = await self._stream.aread(self.CHUNK_SIZE)
+        else:
+            # Otherwise iterate.
+            async for part in self._stream:
+                yield part
+
+
+class UnattachedStream(AsyncByteStream, SyncByteStream):
+    """
+    If a request or response is serialized using pickle, then it is no longer
+    attached to a stream for I/O purposes. Any stream operations should result
+    in `httpx.StreamClosed`.
+    """
+
+    def __iter__(self) -> Iterator[bytes]:
+        raise StreamClosed()
+
+    async def __aiter__(self) -> AsyncIterator[bytes]:
+        raise StreamClosed()
+        yield b""  # pragma: no cover
+
+
+def encode_content(
+    content: str | bytes | Iterable[bytes] | AsyncIterable[bytes],
+) -> tuple[dict[str, str], SyncByteStream | AsyncByteStream]:
+    if isinstance(content, (bytes, str)):
+        body = content.encode("utf-8") if isinstance(content, str) else content
+        content_length = len(body)
+        headers = {"Content-Length": str(content_length)} if body else {}
+        return headers, ByteStream(body)
+
+    elif isinstance(content, Iterable) and not isinstance(content, dict):
+        # `not isinstance(content, dict)` is a bit oddly specific, but it
+        # catches a case that's easy for users to make in error, and would
+        # otherwise pass through here, like any other bytes-iterable,
+        # because `dict` happens to be iterable. See issue #2491.
+        content_length_or_none = peek_filelike_length(content)
+
+        if content_length_or_none is None:
+            headers = {"Transfer-Encoding": "chunked"}
+        else:
+            headers = {"Content-Length": str(content_length_or_none)}
+        return headers, IteratorByteStream(content)  # type: ignore
+
+    elif isinstance(content, AsyncIterable):
+        headers = {"Transfer-Encoding": "chunked"}
+        return headers, AsyncIteratorByteStream(content)
+
+    raise TypeError(f"Unexpected type for 'content', {type(content)!r}")
+
+
+def encode_urlencoded_data(
+    data: RequestData,
+) -> tuple[dict[str, str], ByteStream]:
+    plain_data = []
+    for key, value in data.items():
+        if isinstance(value, (list, tuple)):
+            plain_data.extend([(key, primitive_value_to_str(item)) for item in value])
+        else:
+            plain_data.append((key, primitive_value_to_str(value)))
+    body = urlencode(plain_data, doseq=True).encode("utf-8")
+    content_length = str(len(body))
+    content_type = "application/x-www-form-urlencoded"
+    headers = {"Content-Length": content_length, "Content-Type": content_type}
+    return headers, ByteStream(body)
+
+
+def encode_multipart_data(
+    data: RequestData, files: RequestFiles, boundary: bytes | None
+) -> tuple[dict[str, str], MultipartStream]:
+    multipart = MultipartStream(data=data, files=files, boundary=boundary)
+    headers = multipart.get_headers()
+    return headers, multipart
+
+
+def encode_text(text: str) -> tuple[dict[str, str], ByteStream]:
+    body = text.encode("utf-8")
+    content_length = str(len(body))
+    content_type = "text/plain; charset=utf-8"
+    headers = {"Content-Length": content_length, "Content-Type": content_type}
+    return headers, ByteStream(body)
+
+
+def encode_html(html: str) -> tuple[dict[str, str], ByteStream]:
+    body = html.encode("utf-8")
+    content_length = str(len(body))
+    content_type = "text/html; charset=utf-8"
+    headers = {"Content-Length": content_length, "Content-Type": content_type}
+    return headers, ByteStream(body)
+
+
+def encode_json(json: Any) -> tuple[dict[str, str], ByteStream]:
+    body = json_dumps(json).encode("utf-8")
+    content_length = str(len(body))
+    content_type = "application/json"
+    headers = {"Content-Length": content_length, "Content-Type": content_type}
+    return headers, ByteStream(body)
+
+
+def encode_request(
+    content: RequestContent | None = None,
+    data: RequestData | None = None,
+    files: RequestFiles | None = None,
+    json: Any | None = None,
+    boundary: bytes | None = None,
+) -> tuple[dict[str, str], SyncByteStream | AsyncByteStream]:
+    """
+    Handles encoding the given `content`, `data`, `files`, and `json`,
+    returning a two-tuple of (<headers>, <stream>).
+    """
+    if data is not None and not isinstance(data, Mapping):
+        # We prefer to separate `content=<bytes|str|byte iterator|bytes aiterator>`
+        # for raw request content, and `data=<form data>` for url encoded or
+        # multipart form content.
+        #
+        # However for compat with requests, we *do* still support
+        # `data=<bytes...>` usages. We deal with that case here, treating it
+        # as if `content=<...>` had been supplied instead.
+        message = "Use 'content=<...>' to upload raw bytes/text content."
+        warnings.warn(message, DeprecationWarning)
+        return encode_content(data)
+
+    if content is not None:
+        return encode_content(content)
+    elif files:
+        return encode_multipart_data(data or {}, files, boundary)
+    elif data:
+        return encode_urlencoded_data(data)
+    elif json is not None:
+        return encode_json(json)
+
+    return {}, ByteStream(b"")
+
+
+def encode_response(
+    content: ResponseContent | None = None,
+    text: str | None = None,
+    html: str | None = None,
+    json: Any | None = None,
+) -> tuple[dict[str, str], SyncByteStream | AsyncByteStream]:
+    """
+    Handles encoding the given `content`, returning a two-tuple of
+    (<headers>, <stream>).
+    """
+    if content is not None:
+        return encode_content(content)
+    elif text is not None:
+        return encode_text(text)
+    elif html is not None:
+        return encode_html(html)
+    elif json is not None:
+        return encode_json(json)
+
+    return {}, ByteStream(b"")
diff --git a/llm/Lib/site-packages/httpx/_decoders.py b/llm/Lib/site-packages/httpx/_decoders.py
new file mode 100644
index 0000000000000000000000000000000000000000..31c72c7f7a3c75cc356709c5faa532df5361e3e0
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_decoders.py
@@ -0,0 +1,329 @@
+"""
+Handlers for Content-Encoding.
+
+See: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Encoding
+"""
+from __future__ import annotations
+
+import codecs
+import io
+import typing
+import zlib
+
+from ._compat import brotli
+from ._exceptions import DecodingError
+
+
+class ContentDecoder:
+    def decode(self, data: bytes) -> bytes:
+        raise NotImplementedError()  # pragma: no cover
+
+    def flush(self) -> bytes:
+        raise NotImplementedError()  # pragma: no cover
+
+
+class IdentityDecoder(ContentDecoder):
+    """
+    Handle unencoded data.
+    """
+
+    def decode(self, data: bytes) -> bytes:
+        return data
+
+    def flush(self) -> bytes:
+        return b""
+
+
+class DeflateDecoder(ContentDecoder):
+    """
+    Handle 'deflate' decoding.
+
+    See: https://stackoverflow.com/questions/1838699
+    """
+
+    def __init__(self) -> None:
+        self.first_attempt = True
+        self.decompressor = zlib.decompressobj()
+
+    def decode(self, data: bytes) -> bytes:
+        was_first_attempt = self.first_attempt
+        self.first_attempt = False
+        try:
+            return self.decompressor.decompress(data)
+        except zlib.error as exc:
+            if was_first_attempt:
+                self.decompressor = zlib.decompressobj(-zlib.MAX_WBITS)
+                return self.decode(data)
+            raise DecodingError(str(exc)) from exc
+
+    def flush(self) -> bytes:
+        try:
+            return self.decompressor.flush()
+        except zlib.error as exc:  # pragma: no cover
+            raise DecodingError(str(exc)) from exc
+
+
+class GZipDecoder(ContentDecoder):
+    """
+    Handle 'gzip' decoding.
+
+    See: https://stackoverflow.com/questions/1838699
+    """
+
+    def __init__(self) -> None:
+        self.decompressor = zlib.decompressobj(zlib.MAX_WBITS | 16)
+
+    def decode(self, data: bytes) -> bytes:
+        try:
+            return self.decompressor.decompress(data)
+        except zlib.error as exc:
+            raise DecodingError(str(exc)) from exc
+
+    def flush(self) -> bytes:
+        try:
+            return self.decompressor.flush()
+        except zlib.error as exc:  # pragma: no cover
+            raise DecodingError(str(exc)) from exc
+
+
+class BrotliDecoder(ContentDecoder):
+    """
+    Handle 'brotli' decoding.
+
+    Requires `pip install brotlipy`. See: https://brotlipy.readthedocs.io/
+        or   `pip install brotli`. See https://github.com/google/brotli
+    Supports both 'brotlipy' and 'Brotli' packages since they share an import
+    name. The top branches are for 'brotlipy' and bottom branches for 'Brotli'
+    """
+
+    def __init__(self) -> None:
+        if brotli is None:  # pragma: no cover
+            raise ImportError(
+                "Using 'BrotliDecoder', but neither of the 'brotlicffi' or 'brotli' "
+                "packages have been installed. "
+                "Make sure to install httpx using `pip install httpx[brotli]`."
+            ) from None
+
+        self.decompressor = brotli.Decompressor()
+        self.seen_data = False
+        self._decompress: typing.Callable[[bytes], bytes]
+        if hasattr(self.decompressor, "decompress"):
+            # The 'brotlicffi' package.
+            self._decompress = self.decompressor.decompress  # pragma: no cover
+        else:
+            # The 'brotli' package.
+            self._decompress = self.decompressor.process  # pragma: no cover
+
+    def decode(self, data: bytes) -> bytes:
+        if not data:
+            return b""
+        self.seen_data = True
+        try:
+            return self._decompress(data)
+        except brotli.error as exc:
+            raise DecodingError(str(exc)) from exc
+
+    def flush(self) -> bytes:
+        if not self.seen_data:
+            return b""
+        try:
+            if hasattr(self.decompressor, "finish"):
+                # Only available in the 'brotlicffi' package.
+
+                # As the decompressor decompresses eagerly, this
+                # will never actually emit any data. However, it will potentially throw
+                # errors if a truncated or damaged data stream has been used.
+                self.decompressor.finish()  # pragma: no cover
+            return b""
+        except brotli.error as exc:  # pragma: no cover
+            raise DecodingError(str(exc)) from exc
+
+
+class MultiDecoder(ContentDecoder):
+    """
+    Handle the case where multiple encodings have been applied.
+    """
+
+    def __init__(self, children: typing.Sequence[ContentDecoder]) -> None:
+        """
+        'children' should be a sequence of decoders in the order in which
+        each was applied.
+        """
+        # Note that we reverse the order for decoding.
+        self.children = list(reversed(children))
+
+    def decode(self, data: bytes) -> bytes:
+        for child in self.children:
+            data = child.decode(data)
+        return data
+
+    def flush(self) -> bytes:
+        data = b""
+        for child in self.children:
+            data = child.decode(data) + child.flush()
+        return data
+
+
+class ByteChunker:
+    """
+    Handles returning byte content in fixed-size chunks.
+    """
+
+    def __init__(self, chunk_size: int | None = None) -> None:
+        self._buffer = io.BytesIO()
+        self._chunk_size = chunk_size
+
+    def decode(self, content: bytes) -> list[bytes]:
+        if self._chunk_size is None:
+            return [content] if content else []
+
+        self._buffer.write(content)
+        if self._buffer.tell() >= self._chunk_size:
+            value = self._buffer.getvalue()
+            chunks = [
+                value[i : i + self._chunk_size]
+                for i in range(0, len(value), self._chunk_size)
+            ]
+            if len(chunks[-1]) == self._chunk_size:
+                self._buffer.seek(0)
+                self._buffer.truncate()
+                return chunks
+            else:
+                self._buffer.seek(0)
+                self._buffer.write(chunks[-1])
+                self._buffer.truncate()
+                return chunks[:-1]
+        else:
+            return []
+
+    def flush(self) -> list[bytes]:
+        value = self._buffer.getvalue()
+        self._buffer.seek(0)
+        self._buffer.truncate()
+        return [value] if value else []
+
+
+class TextChunker:
+    """
+    Handles returning text content in fixed-size chunks.
+    """
+
+    def __init__(self, chunk_size: int | None = None) -> None:
+        self._buffer = io.StringIO()
+        self._chunk_size = chunk_size
+
+    def decode(self, content: str) -> list[str]:
+        if self._chunk_size is None:
+            return [content] if content else []
+
+        self._buffer.write(content)
+        if self._buffer.tell() >= self._chunk_size:
+            value = self._buffer.getvalue()
+            chunks = [
+                value[i : i + self._chunk_size]
+                for i in range(0, len(value), self._chunk_size)
+            ]
+            if len(chunks[-1]) == self._chunk_size:
+                self._buffer.seek(0)
+                self._buffer.truncate()
+                return chunks
+            else:
+                self._buffer.seek(0)
+                self._buffer.write(chunks[-1])
+                self._buffer.truncate()
+                return chunks[:-1]
+        else:
+            return []
+
+    def flush(self) -> list[str]:
+        value = self._buffer.getvalue()
+        self._buffer.seek(0)
+        self._buffer.truncate()
+        return [value] if value else []
+
+
+class TextDecoder:
+    """
+    Handles incrementally decoding bytes into text
+    """
+
+    def __init__(self, encoding: str = "utf-8") -> None:
+        self.decoder = codecs.getincrementaldecoder(encoding)(errors="replace")
+
+    def decode(self, data: bytes) -> str:
+        return self.decoder.decode(data)
+
+    def flush(self) -> str:
+        return self.decoder.decode(b"", True)
+
+
+class LineDecoder:
+    """
+    Handles incrementally reading lines from text.
+
+    Has the same behaviour as the stdllib splitlines,
+    but handling the input iteratively.
+    """
+
+    def __init__(self) -> None:
+        self.buffer: list[str] = []
+        self.trailing_cr: bool = False
+
+    def decode(self, text: str) -> list[str]:
+        # See https://docs.python.org/3/library/stdtypes.html#str.splitlines
+        NEWLINE_CHARS = "\n\r\x0b\x0c\x1c\x1d\x1e\x85\u2028\u2029"
+
+        # We always push a trailing `\r` into the next decode iteration.
+        if self.trailing_cr:
+            text = "\r" + text
+            self.trailing_cr = False
+        if text.endswith("\r"):
+            self.trailing_cr = True
+            text = text[:-1]
+
+        if not text:
+            # NOTE: the edge case input of empty text doesn't occur in practice,
+            # because other httpx internals filter out this value
+            return []  # pragma: no cover
+
+        trailing_newline = text[-1] in NEWLINE_CHARS
+        lines = text.splitlines()
+
+        if len(lines) == 1 and not trailing_newline:
+            # No new lines, buffer the input and continue.
+            self.buffer.append(lines[0])
+            return []
+
+        if self.buffer:
+            # Include any existing buffer in the first portion of the
+            # splitlines result.
+            lines = ["".join(self.buffer) + lines[0]] + lines[1:]
+            self.buffer = []
+
+        if not trailing_newline:
+            # If the last segment of splitlines is not newline terminated,
+            # then drop it from our output and start a new buffer.
+            self.buffer = [lines.pop()]
+
+        return lines
+
+    def flush(self) -> list[str]:
+        if not self.buffer and not self.trailing_cr:
+            return []
+
+        lines = ["".join(self.buffer)]
+        self.buffer = []
+        self.trailing_cr = False
+        return lines
+
+
+SUPPORTED_DECODERS = {
+    "identity": IdentityDecoder,
+    "gzip": GZipDecoder,
+    "deflate": DeflateDecoder,
+    "br": BrotliDecoder,
+}
+
+
+if brotli is None:
+    SUPPORTED_DECODERS.pop("br")  # pragma: no cover
diff --git a/llm/Lib/site-packages/httpx/_exceptions.py b/llm/Lib/site-packages/httpx/_exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..11424621c044057c849a950c6b3bfdfb0f2801fe
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_exceptions.py
@@ -0,0 +1,347 @@
+"""
+Our exception hierarchy:
+
+* HTTPError
+  x RequestError
+    + TransportError
+      - TimeoutException
+        · ConnectTimeout
+        · ReadTimeout
+        · WriteTimeout
+        · PoolTimeout
+      - NetworkError
+        · ConnectError
+        · ReadError
+        · WriteError
+        · CloseError
+      - ProtocolError
+        · LocalProtocolError
+        · RemoteProtocolError
+      - ProxyError
+      - UnsupportedProtocol
+    + DecodingError
+    + TooManyRedirects
+  x HTTPStatusError
+* InvalidURL
+* CookieConflict
+* StreamError
+  x StreamConsumed
+  x StreamClosed
+  x ResponseNotRead
+  x RequestNotRead
+"""
+from __future__ import annotations
+
+import contextlib
+import typing
+
+if typing.TYPE_CHECKING:
+    from ._models import Request, Response  # pragma: no cover
+
+
+class HTTPError(Exception):
+    """
+    Base class for `RequestError` and `HTTPStatusError`.
+
+    Useful for `try...except` blocks when issuing a request,
+    and then calling `.raise_for_status()`.
+
+    For example:
+
+    ```
+    try:
+        response = httpx.get("https://www.example.com")
+        response.raise_for_status()
+    except httpx.HTTPError as exc:
+        print(f"HTTP Exception for {exc.request.url} - {exc}")
+    ```
+    """
+
+    def __init__(self, message: str) -> None:
+        super().__init__(message)
+        self._request: Request | None = None
+
+    @property
+    def request(self) -> Request:
+        if self._request is None:
+            raise RuntimeError("The .request property has not been set.")
+        return self._request
+
+    @request.setter
+    def request(self, request: Request) -> None:
+        self._request = request
+
+
+class RequestError(HTTPError):
+    """
+    Base class for all exceptions that may occur when issuing a `.request()`.
+    """
+
+    def __init__(self, message: str, *, request: Request | None = None) -> None:
+        super().__init__(message)
+        # At the point an exception is raised we won't typically have a request
+        # instance to associate it with.
+        #
+        # The 'request_context' context manager is used within the Client and
+        # Response methods in order to ensure that any raised exceptions
+        # have a `.request` property set on them.
+        self._request = request
+
+
+class TransportError(RequestError):
+    """
+    Base class for all exceptions that occur at the level of the Transport API.
+    """
+
+
+# Timeout exceptions...
+
+
+class TimeoutException(TransportError):
+    """
+    The base class for timeout errors.
+
+    An operation has timed out.
+    """
+
+
+class ConnectTimeout(TimeoutException):
+    """
+    Timed out while connecting to the host.
+    """
+
+
+class ReadTimeout(TimeoutException):
+    """
+    Timed out while receiving data from the host.
+    """
+
+
+class WriteTimeout(TimeoutException):
+    """
+    Timed out while sending data to the host.
+    """
+
+
+class PoolTimeout(TimeoutException):
+    """
+    Timed out waiting to acquire a connection from the pool.
+    """
+
+
+# Core networking exceptions...
+
+
+class NetworkError(TransportError):
+    """
+    The base class for network-related errors.
+
+    An error occurred while interacting with the network.
+    """
+
+
+class ReadError(NetworkError):
+    """
+    Failed to receive data from the network.
+    """
+
+
+class WriteError(NetworkError):
+    """
+    Failed to send data through the network.
+    """
+
+
+class ConnectError(NetworkError):
+    """
+    Failed to establish a connection.
+    """
+
+
+class CloseError(NetworkError):
+    """
+    Failed to close a connection.
+    """
+
+
+# Other transport exceptions...
+
+
+class ProxyError(TransportError):
+    """
+    An error occurred while establishing a proxy connection.
+    """
+
+
+class UnsupportedProtocol(TransportError):
+    """
+    Attempted to make a request to an unsupported protocol.
+
+    For example issuing a request to `ftp://www.example.com`.
+    """
+
+
+class ProtocolError(TransportError):
+    """
+    The protocol was violated.
+    """
+
+
+class LocalProtocolError(ProtocolError):
+    """
+    A protocol was violated by the client.
+
+    For example if the user instantiated a `Request` instance explicitly,
+    failed to include the mandatory `Host:` header, and then issued it directly
+    using `client.send()`.
+    """
+
+
+class RemoteProtocolError(ProtocolError):
+    """
+    The protocol was violated by the server.
+
+    For example, returning malformed HTTP.
+    """
+
+
+# Other request exceptions...
+
+
+class DecodingError(RequestError):
+    """
+    Decoding of the response failed, due to a malformed encoding.
+    """
+
+
+class TooManyRedirects(RequestError):
+    """
+    Too many redirects.
+    """
+
+
+# Client errors
+
+
+class HTTPStatusError(HTTPError):
+    """
+    The response had an error HTTP status of 4xx or 5xx.
+
+    May be raised when calling `response.raise_for_status()`
+    """
+
+    def __init__(self, message: str, *, request: Request, response: Response) -> None:
+        super().__init__(message)
+        self.request = request
+        self.response = response
+
+
+class InvalidURL(Exception):
+    """
+    URL is improperly formed or cannot be parsed.
+    """
+
+    def __init__(self, message: str) -> None:
+        super().__init__(message)
+
+
+class CookieConflict(Exception):
+    """
+    Attempted to lookup a cookie by name, but multiple cookies existed.
+
+    Can occur when calling `response.cookies.get(...)`.
+    """
+
+    def __init__(self, message: str) -> None:
+        super().__init__(message)
+
+
+# Stream exceptions...
+
+# These may occur as the result of a programming error, by accessing
+# the request/response stream in an invalid manner.
+
+
+class StreamError(RuntimeError):
+    """
+    The base class for stream exceptions.
+
+    The developer made an error in accessing the request stream in
+    an invalid way.
+    """
+
+    def __init__(self, message: str) -> None:
+        super().__init__(message)
+
+
+class StreamConsumed(StreamError):
+    """
+    Attempted to read or stream content, but the content has already
+    been streamed.
+    """
+
+    def __init__(self) -> None:
+        message = (
+            "Attempted to read or stream some content, but the content has "
+            "already been streamed. For requests, this could be due to passing "
+            "a generator as request content, and then receiving a redirect "
+            "response or a secondary request as part of an authentication flow."
+            "For responses, this could be due to attempting to stream the response "
+            "content more than once."
+        )
+        super().__init__(message)
+
+
+class StreamClosed(StreamError):
+    """
+    Attempted to read or stream response content, but the request has been
+    closed.
+    """
+
+    def __init__(self) -> None:
+        message = (
+            "Attempted to read or stream content, but the stream has " "been closed."
+        )
+        super().__init__(message)
+
+
+class ResponseNotRead(StreamError):
+    """
+    Attempted to access streaming response content, without having called `read()`.
+    """
+
+    def __init__(self) -> None:
+        message = (
+            "Attempted to access streaming response content,"
+            " without having called `read()`."
+        )
+        super().__init__(message)
+
+
+class RequestNotRead(StreamError):
+    """
+    Attempted to access streaming request content, without having called `read()`.
+    """
+
+    def __init__(self) -> None:
+        message = (
+            "Attempted to access streaming request content,"
+            " without having called `read()`."
+        )
+        super().__init__(message)
+
+
+@contextlib.contextmanager
+def request_context(
+    request: Request | None = None,
+) -> typing.Iterator[None]:
+    """
+    A context manager that can be used to attach the given request context
+    to any `RequestError` exceptions that are raised within the block.
+    """
+    try:
+        yield
+    except RequestError as exc:
+        if request is not None:
+            exc.request = request
+        raise exc
diff --git a/llm/Lib/site-packages/httpx/_main.py b/llm/Lib/site-packages/httpx/_main.py
new file mode 100644
index 0000000000000000000000000000000000000000..72657f8ca3cd882249aa5c85fbcd42685ff2da74
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_main.py
@@ -0,0 +1,509 @@
+from __future__ import annotations
+
+import functools
+import json
+import sys
+import typing
+
+import click
+import httpcore
+import pygments.lexers
+import pygments.util
+import rich.console
+import rich.markup
+import rich.progress
+import rich.syntax
+import rich.table
+
+from ._client import Client
+from ._exceptions import RequestError
+from ._models import Response
+from ._status_codes import codes
+
+
+def print_help() -> None:
+    console = rich.console.Console()
+
+    console.print("[bold]HTTPX :butterfly:", justify="center")
+    console.print()
+    console.print("A next generation HTTP client.", justify="center")
+    console.print()
+    console.print(
+        "Usage: [bold]httpx[/bold] [cyan]<URL> [OPTIONS][/cyan] ", justify="left"
+    )
+    console.print()
+
+    table = rich.table.Table.grid(padding=1, pad_edge=True)
+    table.add_column("Parameter", no_wrap=True, justify="left", style="bold")
+    table.add_column("Description")
+    table.add_row(
+        "-m, --method [cyan]METHOD",
+        "Request method, such as GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD.\n"
+        "[Default: GET, or POST if a request body is included]",
+    )
+    table.add_row(
+        "-p, --params [cyan]<NAME VALUE> ...",
+        "Query parameters to include in the request URL.",
+    )
+    table.add_row(
+        "-c, --content [cyan]TEXT", "Byte content to include in the request body."
+    )
+    table.add_row(
+        "-d, --data [cyan]<NAME VALUE> ...", "Form data to include in the request body."
+    )
+    table.add_row(
+        "-f, --files [cyan]<NAME FILENAME> ...",
+        "Form files to include in the request body.",
+    )
+    table.add_row("-j, --json [cyan]TEXT", "JSON data to include in the request body.")
+    table.add_row(
+        "-h, --headers [cyan]<NAME VALUE> ...",
+        "Include additional HTTP headers in the request.",
+    )
+    table.add_row(
+        "--cookies [cyan]<NAME VALUE> ...", "Cookies to include in the request."
+    )
+    table.add_row(
+        "--auth [cyan]<USER PASS>",
+        "Username and password to include in the request. Specify '-' for the password"
+        " to use a password prompt. Note that using --verbose/-v will expose"
+        " the Authorization header, including the password encoding"
+        " in a trivially reversible format.",
+    )
+
+    table.add_row(
+        "--proxy [cyan]URL",
+        "Send the request via a proxy. Should be the URL giving the proxy address.",
+    )
+
+    table.add_row(
+        "--timeout [cyan]FLOAT",
+        "Timeout value to use for network operations, such as establishing the"
+        " connection, reading some data, etc... [Default: 5.0]",
+    )
+
+    table.add_row("--follow-redirects", "Automatically follow redirects.")
+    table.add_row("--no-verify", "Disable SSL verification.")
+    table.add_row(
+        "--http2", "Send the request using HTTP/2, if the remote server supports it."
+    )
+
+    table.add_row(
+        "--download [cyan]FILE",
+        "Save the response content as a file, rather than displaying it.",
+    )
+
+    table.add_row("-v, --verbose", "Verbose output. Show request as well as response.")
+    table.add_row("--help", "Show this message and exit.")
+    console.print(table)
+
+
+def get_lexer_for_response(response: Response) -> str:
+    content_type = response.headers.get("Content-Type")
+    if content_type is not None:
+        mime_type, _, _ = content_type.partition(";")
+        try:
+            return typing.cast(
+                str, pygments.lexers.get_lexer_for_mimetype(mime_type.strip()).name
+            )
+        except pygments.util.ClassNotFound:  # pragma: no cover
+            pass
+    return ""  # pragma: no cover
+
+
+def format_request_headers(request: httpcore.Request, http2: bool = False) -> str:
+    version = "HTTP/2" if http2 else "HTTP/1.1"
+    headers = [
+        (name.lower() if http2 else name, value) for name, value in request.headers
+    ]
+    method = request.method.decode("ascii")
+    target = request.url.target.decode("ascii")
+    lines = [f"{method} {target} {version}"] + [
+        f"{name.decode('ascii')}: {value.decode('ascii')}" for name, value in headers
+    ]
+    return "\n".join(lines)
+
+
+def format_response_headers(
+    http_version: bytes,
+    status: int,
+    reason_phrase: bytes | None,
+    headers: list[tuple[bytes, bytes]],
+) -> str:
+    version = http_version.decode("ascii")
+    reason = (
+        codes.get_reason_phrase(status)
+        if reason_phrase is None
+        else reason_phrase.decode("ascii")
+    )
+    lines = [f"{version} {status} {reason}"] + [
+        f"{name.decode('ascii')}: {value.decode('ascii')}" for name, value in headers
+    ]
+    return "\n".join(lines)
+
+
+def print_request_headers(request: httpcore.Request, http2: bool = False) -> None:
+    console = rich.console.Console()
+    http_text = format_request_headers(request, http2=http2)
+    syntax = rich.syntax.Syntax(http_text, "http", theme="ansi_dark", word_wrap=True)
+    console.print(syntax)
+    syntax = rich.syntax.Syntax("", "http", theme="ansi_dark", word_wrap=True)
+    console.print(syntax)
+
+
+def print_response_headers(
+    http_version: bytes,
+    status: int,
+    reason_phrase: bytes | None,
+    headers: list[tuple[bytes, bytes]],
+) -> None:
+    console = rich.console.Console()
+    http_text = format_response_headers(http_version, status, reason_phrase, headers)
+    syntax = rich.syntax.Syntax(http_text, "http", theme="ansi_dark", word_wrap=True)
+    console.print(syntax)
+    syntax = rich.syntax.Syntax("", "http", theme="ansi_dark", word_wrap=True)
+    console.print(syntax)
+
+
+def print_response(response: Response) -> None:
+    console = rich.console.Console()
+    lexer_name = get_lexer_for_response(response)
+    if lexer_name:
+        if lexer_name.lower() == "json":
+            try:
+                data = response.json()
+                text = json.dumps(data, indent=4)
+            except ValueError:  # pragma: no cover
+                text = response.text
+        else:
+            text = response.text
+
+        syntax = rich.syntax.Syntax(text, lexer_name, theme="ansi_dark", word_wrap=True)
+        console.print(syntax)
+    else:
+        console.print(f"<{len(response.content)} bytes of binary data>")
+
+
+_PCTRTT = typing.Tuple[typing.Tuple[str, str], ...]
+_PCTRTTT = typing.Tuple[_PCTRTT, ...]
+_PeerCertRetDictType = typing.Dict[str, typing.Union[str, _PCTRTTT, _PCTRTT]]
+
+
+def format_certificate(cert: _PeerCertRetDictType) -> str:  # pragma: no cover
+    lines = []
+    for key, value in cert.items():
+        if isinstance(value, (list, tuple)):
+            lines.append(f"*   {key}:")
+            for item in value:
+                if key in ("subject", "issuer"):
+                    for sub_item in item:
+                        lines.append(f"*     {sub_item[0]}: {sub_item[1]!r}")
+                elif isinstance(item, tuple) and len(item) == 2:
+                    lines.append(f"*     {item[0]}: {item[1]!r}")
+                else:
+                    lines.append(f"*     {item!r}")
+        else:
+            lines.append(f"*   {key}: {value!r}")
+    return "\n".join(lines)
+
+
+def trace(
+    name: str, info: typing.Mapping[str, typing.Any], verbose: bool = False
+) -> None:
+    console = rich.console.Console()
+    if name == "connection.connect_tcp.started" and verbose:
+        host = info["host"]
+        console.print(f"* Connecting to {host!r}")
+    elif name == "connection.connect_tcp.complete" and verbose:
+        stream = info["return_value"]
+        server_addr = stream.get_extra_info("server_addr")
+        console.print(f"* Connected to {server_addr[0]!r} on port {server_addr[1]}")
+    elif name == "connection.start_tls.complete" and verbose:  # pragma: no cover
+        stream = info["return_value"]
+        ssl_object = stream.get_extra_info("ssl_object")
+        version = ssl_object.version()
+        cipher = ssl_object.cipher()
+        server_cert = ssl_object.getpeercert()
+        alpn = ssl_object.selected_alpn_protocol()
+        console.print(f"* SSL established using {version!r} / {cipher[0]!r}")
+        console.print(f"* Selected ALPN protocol: {alpn!r}")
+        if server_cert:
+            console.print("* Server certificate:")
+            console.print(format_certificate(server_cert))
+    elif name == "http11.send_request_headers.started" and verbose:
+        request = info["request"]
+        print_request_headers(request, http2=False)
+    elif name == "http2.send_request_headers.started" and verbose:  # pragma: no cover
+        request = info["request"]
+        print_request_headers(request, http2=True)
+    elif name == "http11.receive_response_headers.complete":
+        http_version, status, reason_phrase, headers = info["return_value"]
+        print_response_headers(http_version, status, reason_phrase, headers)
+    elif name == "http2.receive_response_headers.complete":  # pragma: no cover
+        status, headers = info["return_value"]
+        http_version = b"HTTP/2"
+        reason_phrase = None
+        print_response_headers(http_version, status, reason_phrase, headers)
+
+
+def download_response(response: Response, download: typing.BinaryIO) -> None:
+    console = rich.console.Console()
+    console.print()
+    content_length = response.headers.get("Content-Length")
+    with rich.progress.Progress(
+        "[progress.description]{task.description}",
+        "[progress.percentage]{task.percentage:>3.0f}%",
+        rich.progress.BarColumn(bar_width=None),
+        rich.progress.DownloadColumn(),
+        rich.progress.TransferSpeedColumn(),
+    ) as progress:
+        description = f"Downloading [bold]{rich.markup.escape(download.name)}"
+        download_task = progress.add_task(
+            description,
+            total=int(content_length or 0),
+            start=content_length is not None,
+        )
+        for chunk in response.iter_bytes():
+            download.write(chunk)
+            progress.update(download_task, completed=response.num_bytes_downloaded)
+
+
+def validate_json(
+    ctx: click.Context,
+    param: click.Option | click.Parameter,
+    value: typing.Any,
+) -> typing.Any:
+    if value is None:
+        return None
+
+    try:
+        return json.loads(value)
+    except json.JSONDecodeError:  # pragma: no cover
+        raise click.BadParameter("Not valid JSON")
+
+
+def validate_auth(
+    ctx: click.Context,
+    param: click.Option | click.Parameter,
+    value: typing.Any,
+) -> typing.Any:
+    if value == (None, None):
+        return None
+
+    username, password = value
+    if password == "-":  # pragma: no cover
+        password = click.prompt("Password", hide_input=True)
+    return (username, password)
+
+
+def handle_help(
+    ctx: click.Context,
+    param: click.Option | click.Parameter,
+    value: typing.Any,
+) -> None:
+    if not value or ctx.resilient_parsing:
+        return
+
+    print_help()
+    ctx.exit()
+
+
+@click.command(add_help_option=False)
+@click.argument("url", type=str)
+@click.option(
+    "--method",
+    "-m",
+    "method",
+    type=str,
+    help=(
+        "Request method, such as GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD. "
+        "[Default: GET, or POST if a request body is included]"
+    ),
+)
+@click.option(
+    "--params",
+    "-p",
+    "params",
+    type=(str, str),
+    multiple=True,
+    help="Query parameters to include in the request URL.",
+)
+@click.option(
+    "--content",
+    "-c",
+    "content",
+    type=str,
+    help="Byte content to include in the request body.",
+)
+@click.option(
+    "--data",
+    "-d",
+    "data",
+    type=(str, str),
+    multiple=True,
+    help="Form data to include in the request body.",
+)
+@click.option(
+    "--files",
+    "-f",
+    "files",
+    type=(str, click.File(mode="rb")),
+    multiple=True,
+    help="Form files to include in the request body.",
+)
+@click.option(
+    "--json",
+    "-j",
+    "json",
+    type=str,
+    callback=validate_json,
+    help="JSON data to include in the request body.",
+)
+@click.option(
+    "--headers",
+    "-h",
+    "headers",
+    type=(str, str),
+    multiple=True,
+    help="Include additional HTTP headers in the request.",
+)
+@click.option(
+    "--cookies",
+    "cookies",
+    type=(str, str),
+    multiple=True,
+    help="Cookies to include in the request.",
+)
+@click.option(
+    "--auth",
+    "auth",
+    type=(str, str),
+    default=(None, None),
+    callback=validate_auth,
+    help=(
+        "Username and password to include in the request. "
+        "Specify '-' for the password to use a password prompt. "
+        "Note that using --verbose/-v will expose the Authorization header, "
+        "including the password encoding in a trivially reversible format."
+    ),
+)
+@click.option(
+    "--proxy",
+    "proxy",
+    type=str,
+    default=None,
+    help="Send the request via a proxy. Should be the URL giving the proxy address.",
+)
+@click.option(
+    "--timeout",
+    "timeout",
+    type=float,
+    default=5.0,
+    help=(
+        "Timeout value to use for network operations, such as establishing the "
+        "connection, reading some data, etc... [Default: 5.0]"
+    ),
+)
+@click.option(
+    "--follow-redirects",
+    "follow_redirects",
+    is_flag=True,
+    default=False,
+    help="Automatically follow redirects.",
+)
+@click.option(
+    "--no-verify",
+    "verify",
+    is_flag=True,
+    default=True,
+    help="Disable SSL verification.",
+)
+@click.option(
+    "--http2",
+    "http2",
+    type=bool,
+    is_flag=True,
+    default=False,
+    help="Send the request using HTTP/2, if the remote server supports it.",
+)
+@click.option(
+    "--download",
+    type=click.File("wb"),
+    help="Save the response content as a file, rather than displaying it.",
+)
+@click.option(
+    "--verbose",
+    "-v",
+    type=bool,
+    is_flag=True,
+    default=False,
+    help="Verbose. Show request as well as response.",
+)
+@click.option(
+    "--help",
+    is_flag=True,
+    is_eager=True,
+    expose_value=False,
+    callback=handle_help,
+    help="Show this message and exit.",
+)
+def main(
+    url: str,
+    method: str,
+    params: list[tuple[str, str]],
+    content: str,
+    data: list[tuple[str, str]],
+    files: list[tuple[str, click.File]],
+    json: str,
+    headers: list[tuple[str, str]],
+    cookies: list[tuple[str, str]],
+    auth: tuple[str, str] | None,
+    proxy: str,
+    timeout: float,
+    follow_redirects: bool,
+    verify: bool,
+    http2: bool,
+    download: typing.BinaryIO | None,
+    verbose: bool,
+) -> None:
+    """
+    An HTTP command line client.
+    Sends a request and displays the response.
+    """
+    if not method:
+        method = "POST" if content or data or files or json else "GET"
+
+    try:
+        with Client(
+            proxy=proxy,
+            timeout=timeout,
+            verify=verify,
+            http2=http2,
+        ) as client:
+            with client.stream(
+                method,
+                url,
+                params=list(params),
+                content=content,
+                data=dict(data),
+                files=files,  # type: ignore
+                json=json,
+                headers=headers,
+                cookies=dict(cookies),
+                auth=auth,
+                follow_redirects=follow_redirects,
+                extensions={"trace": functools.partial(trace, verbose=verbose)},
+            ) as response:
+                if download is not None:
+                    download_response(response, download)
+                else:
+                    response.read()
+                    if response.content:
+                        print_response(response)
+
+    except RequestError as exc:
+        console = rich.console.Console()
+        console.print(f"[red]{type(exc).__name__}[/red]: {exc}")
+        sys.exit(1)
+
+    sys.exit(0 if response.is_success else 1)
diff --git a/llm/Lib/site-packages/httpx/_models.py b/llm/Lib/site-packages/httpx/_models.py
new file mode 100644
index 0000000000000000000000000000000000000000..cd76705f1ab17a92052b8af55c56b7a1a33d9922
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_models.py
@@ -0,0 +1,1209 @@
+from __future__ import annotations
+
+import datetime
+import email.message
+import json as jsonlib
+import typing
+import urllib.request
+from collections.abc import Mapping
+from http.cookiejar import Cookie, CookieJar
+
+from ._content import ByteStream, UnattachedStream, encode_request, encode_response
+from ._decoders import (
+    SUPPORTED_DECODERS,
+    ByteChunker,
+    ContentDecoder,
+    IdentityDecoder,
+    LineDecoder,
+    MultiDecoder,
+    TextChunker,
+    TextDecoder,
+)
+from ._exceptions import (
+    CookieConflict,
+    HTTPStatusError,
+    RequestNotRead,
+    ResponseNotRead,
+    StreamClosed,
+    StreamConsumed,
+    request_context,
+)
+from ._multipart import get_multipart_boundary_from_content_type
+from ._status_codes import codes
+from ._types import (
+    AsyncByteStream,
+    CookieTypes,
+    HeaderTypes,
+    QueryParamTypes,
+    RequestContent,
+    RequestData,
+    RequestExtensions,
+    RequestFiles,
+    ResponseContent,
+    ResponseExtensions,
+    SyncByteStream,
+)
+from ._urls import URL
+from ._utils import (
+    is_known_encoding,
+    normalize_header_key,
+    normalize_header_value,
+    obfuscate_sensitive_headers,
+    parse_content_type_charset,
+    parse_header_links,
+)
+
+
+class Headers(typing.MutableMapping[str, str]):
+    """
+    HTTP headers, as a case-insensitive multi-dict.
+    """
+
+    def __init__(
+        self,
+        headers: HeaderTypes | None = None,
+        encoding: str | None = None,
+    ) -> None:
+        if headers is None:
+            self._list = []  # type: typing.List[typing.Tuple[bytes, bytes, bytes]]
+        elif isinstance(headers, Headers):
+            self._list = list(headers._list)
+        elif isinstance(headers, Mapping):
+            self._list = [
+                (
+                    normalize_header_key(k, lower=False, encoding=encoding),
+                    normalize_header_key(k, lower=True, encoding=encoding),
+                    normalize_header_value(v, encoding),
+                )
+                for k, v in headers.items()
+            ]
+        else:
+            self._list = [
+                (
+                    normalize_header_key(k, lower=False, encoding=encoding),
+                    normalize_header_key(k, lower=True, encoding=encoding),
+                    normalize_header_value(v, encoding),
+                )
+                for k, v in headers
+            ]
+
+        self._encoding = encoding
+
+    @property
+    def encoding(self) -> str:
+        """
+        Header encoding is mandated as ascii, but we allow fallbacks to utf-8
+        or iso-8859-1.
+        """
+        if self._encoding is None:
+            for encoding in ["ascii", "utf-8"]:
+                for key, value in self.raw:
+                    try:
+                        key.decode(encoding)
+                        value.decode(encoding)
+                    except UnicodeDecodeError:
+                        break
+                else:
+                    # The else block runs if 'break' did not occur, meaning
+                    # all values fitted the encoding.
+                    self._encoding = encoding
+                    break
+            else:
+                # The ISO-8859-1 encoding covers all 256 code points in a byte,
+                # so will never raise decode errors.
+                self._encoding = "iso-8859-1"
+        return self._encoding
+
+    @encoding.setter
+    def encoding(self, value: str) -> None:
+        self._encoding = value
+
+    @property
+    def raw(self) -> list[tuple[bytes, bytes]]:
+        """
+        Returns a list of the raw header items, as byte pairs.
+        """
+        return [(raw_key, value) for raw_key, _, value in self._list]
+
+    def keys(self) -> typing.KeysView[str]:
+        return {key.decode(self.encoding): None for _, key, value in self._list}.keys()
+
+    def values(self) -> typing.ValuesView[str]:
+        values_dict: dict[str, str] = {}
+        for _, key, value in self._list:
+            str_key = key.decode(self.encoding)
+            str_value = value.decode(self.encoding)
+            if str_key in values_dict:
+                values_dict[str_key] += f", {str_value}"
+            else:
+                values_dict[str_key] = str_value
+        return values_dict.values()
+
+    def items(self) -> typing.ItemsView[str, str]:
+        """
+        Return `(key, value)` items of headers. Concatenate headers
+        into a single comma separated value when a key occurs multiple times.
+        """
+        values_dict: dict[str, str] = {}
+        for _, key, value in self._list:
+            str_key = key.decode(self.encoding)
+            str_value = value.decode(self.encoding)
+            if str_key in values_dict:
+                values_dict[str_key] += f", {str_value}"
+            else:
+                values_dict[str_key] = str_value
+        return values_dict.items()
+
+    def multi_items(self) -> list[tuple[str, str]]:
+        """
+        Return a list of `(key, value)` pairs of headers. Allow multiple
+        occurrences of the same key without concatenating into a single
+        comma separated value.
+        """
+        return [
+            (key.decode(self.encoding), value.decode(self.encoding))
+            for _, key, value in self._list
+        ]
+
+    def get(self, key: str, default: typing.Any = None) -> typing.Any:
+        """
+        Return a header value. If multiple occurrences of the header occur
+        then concatenate them together with commas.
+        """
+        try:
+            return self[key]
+        except KeyError:
+            return default
+
+    def get_list(self, key: str, split_commas: bool = False) -> list[str]:
+        """
+        Return a list of all header values for a given key.
+        If `split_commas=True` is passed, then any comma separated header
+        values are split into multiple return strings.
+        """
+        get_header_key = key.lower().encode(self.encoding)
+
+        values = [
+            item_value.decode(self.encoding)
+            for _, item_key, item_value in self._list
+            if item_key.lower() == get_header_key
+        ]
+
+        if not split_commas:
+            return values
+
+        split_values = []
+        for value in values:
+            split_values.extend([item.strip() for item in value.split(",")])
+        return split_values
+
+    def update(self, headers: HeaderTypes | None = None) -> None:  # type: ignore
+        headers = Headers(headers)
+        for key in headers.keys():
+            if key in self:
+                self.pop(key)
+        self._list.extend(headers._list)
+
+    def copy(self) -> Headers:
+        return Headers(self, encoding=self.encoding)
+
+    def __getitem__(self, key: str) -> str:
+        """
+        Return a single header value.
+
+        If there are multiple headers with the same key, then we concatenate
+        them with commas. See: https://tools.ietf.org/html/rfc7230#section-3.2.2
+        """
+        normalized_key = key.lower().encode(self.encoding)
+
+        items = [
+            header_value.decode(self.encoding)
+            for _, header_key, header_value in self._list
+            if header_key == normalized_key
+        ]
+
+        if items:
+            return ", ".join(items)
+
+        raise KeyError(key)
+
+    def __setitem__(self, key: str, value: str) -> None:
+        """
+        Set the header `key` to `value`, removing any duplicate entries.
+        Retains insertion order.
+        """
+        set_key = key.encode(self._encoding or "utf-8")
+        set_value = value.encode(self._encoding or "utf-8")
+        lookup_key = set_key.lower()
+
+        found_indexes = [
+            idx
+            for idx, (_, item_key, _) in enumerate(self._list)
+            if item_key == lookup_key
+        ]
+
+        for idx in reversed(found_indexes[1:]):
+            del self._list[idx]
+
+        if found_indexes:
+            idx = found_indexes[0]
+            self._list[idx] = (set_key, lookup_key, set_value)
+        else:
+            self._list.append((set_key, lookup_key, set_value))
+
+    def __delitem__(self, key: str) -> None:
+        """
+        Remove the header `key`.
+        """
+        del_key = key.lower().encode(self.encoding)
+
+        pop_indexes = [
+            idx
+            for idx, (_, item_key, _) in enumerate(self._list)
+            if item_key.lower() == del_key
+        ]
+
+        if not pop_indexes:
+            raise KeyError(key)
+
+        for idx in reversed(pop_indexes):
+            del self._list[idx]
+
+    def __contains__(self, key: typing.Any) -> bool:
+        header_key = key.lower().encode(self.encoding)
+        return header_key in [key for _, key, _ in self._list]
+
+    def __iter__(self) -> typing.Iterator[typing.Any]:
+        return iter(self.keys())
+
+    def __len__(self) -> int:
+        return len(self._list)
+
+    def __eq__(self, other: typing.Any) -> bool:
+        try:
+            other_headers = Headers(other)
+        except ValueError:
+            return False
+
+        self_list = [(key, value) for _, key, value in self._list]
+        other_list = [(key, value) for _, key, value in other_headers._list]
+        return sorted(self_list) == sorted(other_list)
+
+    def __repr__(self) -> str:
+        class_name = self.__class__.__name__
+
+        encoding_str = ""
+        if self.encoding != "ascii":
+            encoding_str = f", encoding={self.encoding!r}"
+
+        as_list = list(obfuscate_sensitive_headers(self.multi_items()))
+        as_dict = dict(as_list)
+
+        no_duplicate_keys = len(as_dict) == len(as_list)
+        if no_duplicate_keys:
+            return f"{class_name}({as_dict!r}{encoding_str})"
+        return f"{class_name}({as_list!r}{encoding_str})"
+
+
+class Request:
+    def __init__(
+        self,
+        method: str | bytes,
+        url: URL | str,
+        *,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        cookies: CookieTypes | None = None,
+        content: RequestContent | None = None,
+        data: RequestData | None = None,
+        files: RequestFiles | None = None,
+        json: typing.Any | None = None,
+        stream: SyncByteStream | AsyncByteStream | None = None,
+        extensions: RequestExtensions | None = None,
+    ) -> None:
+        self.method = (
+            method.decode("ascii").upper()
+            if isinstance(method, bytes)
+            else method.upper()
+        )
+        self.url = URL(url)
+        if params is not None:
+            self.url = self.url.copy_merge_params(params=params)
+        self.headers = Headers(headers)
+        self.extensions = {} if extensions is None else extensions
+
+        if cookies:
+            Cookies(cookies).set_cookie_header(self)
+
+        if stream is None:
+            content_type: str | None = self.headers.get("content-type")
+            headers, stream = encode_request(
+                content=content,
+                data=data,
+                files=files,
+                json=json,
+                boundary=get_multipart_boundary_from_content_type(
+                    content_type=content_type.encode(self.headers.encoding)
+                    if content_type
+                    else None
+                ),
+            )
+            self._prepare(headers)
+            self.stream = stream
+            # Load the request body, except for streaming content.
+            if isinstance(stream, ByteStream):
+                self.read()
+        else:
+            # There's an important distinction between `Request(content=...)`,
+            # and `Request(stream=...)`.
+            #
+            # Using `content=...` implies automatically populated `Host` and content
+            # headers, of either `Content-Length: ...` or `Transfer-Encoding: chunked`.
+            #
+            # Using `stream=...` will not automatically include *any*
+            # auto-populated headers.
+            #
+            # As an end-user you don't really need `stream=...`. It's only
+            # useful when:
+            #
+            # * Preserving the request stream when copying requests, eg for redirects.
+            # * Creating request instances on the *server-side* of the transport API.
+            self.stream = stream
+
+    def _prepare(self, default_headers: dict[str, str]) -> None:
+        for key, value in default_headers.items():
+            # Ignore Transfer-Encoding if the Content-Length has been set explicitly.
+            if key.lower() == "transfer-encoding" and "Content-Length" in self.headers:
+                continue
+            self.headers.setdefault(key, value)
+
+        auto_headers: list[tuple[bytes, bytes]] = []
+
+        has_host = "Host" in self.headers
+        has_content_length = (
+            "Content-Length" in self.headers or "Transfer-Encoding" in self.headers
+        )
+
+        if not has_host and self.url.host:
+            auto_headers.append((b"Host", self.url.netloc))
+        if not has_content_length and self.method in ("POST", "PUT", "PATCH"):
+            auto_headers.append((b"Content-Length", b"0"))
+
+        self.headers = Headers(auto_headers + self.headers.raw)
+
+    @property
+    def content(self) -> bytes:
+        if not hasattr(self, "_content"):
+            raise RequestNotRead()
+        return self._content
+
+    def read(self) -> bytes:
+        """
+        Read and return the request content.
+        """
+        if not hasattr(self, "_content"):
+            assert isinstance(self.stream, typing.Iterable)
+            self._content = b"".join(self.stream)
+            if not isinstance(self.stream, ByteStream):
+                # If a streaming request has been read entirely into memory, then
+                # we can replace the stream with a raw bytes implementation,
+                # to ensure that any non-replayable streams can still be used.
+                self.stream = ByteStream(self._content)
+        return self._content
+
+    async def aread(self) -> bytes:
+        """
+        Read and return the request content.
+        """
+        if not hasattr(self, "_content"):
+            assert isinstance(self.stream, typing.AsyncIterable)
+            self._content = b"".join([part async for part in self.stream])
+            if not isinstance(self.stream, ByteStream):
+                # If a streaming request has been read entirely into memory, then
+                # we can replace the stream with a raw bytes implementation,
+                # to ensure that any non-replayable streams can still be used.
+                self.stream = ByteStream(self._content)
+        return self._content
+
+    def __repr__(self) -> str:
+        class_name = self.__class__.__name__
+        url = str(self.url)
+        return f"<{class_name}({self.method!r}, {url!r})>"
+
+    def __getstate__(self) -> dict[str, typing.Any]:
+        return {
+            name: value
+            for name, value in self.__dict__.items()
+            if name not in ["extensions", "stream"]
+        }
+
+    def __setstate__(self, state: dict[str, typing.Any]) -> None:
+        for name, value in state.items():
+            setattr(self, name, value)
+        self.extensions = {}
+        self.stream = UnattachedStream()
+
+
+class Response:
+    def __init__(
+        self,
+        status_code: int,
+        *,
+        headers: HeaderTypes | None = None,
+        content: ResponseContent | None = None,
+        text: str | None = None,
+        html: str | None = None,
+        json: typing.Any = None,
+        stream: SyncByteStream | AsyncByteStream | None = None,
+        request: Request | None = None,
+        extensions: ResponseExtensions | None = None,
+        history: list[Response] | None = None,
+        default_encoding: str | typing.Callable[[bytes], str] = "utf-8",
+    ) -> None:
+        self.status_code = status_code
+        self.headers = Headers(headers)
+
+        self._request: Request | None = request
+
+        # When follow_redirects=False and a redirect is received,
+        # the client will set `response.next_request`.
+        self.next_request: Request | None = None
+
+        self.extensions: ResponseExtensions = {} if extensions is None else extensions
+        self.history = [] if history is None else list(history)
+
+        self.is_closed = False
+        self.is_stream_consumed = False
+
+        self.default_encoding = default_encoding
+
+        if stream is None:
+            headers, stream = encode_response(content, text, html, json)
+            self._prepare(headers)
+            self.stream = stream
+            if isinstance(stream, ByteStream):
+                # Load the response body, except for streaming content.
+                self.read()
+        else:
+            # There's an important distinction between `Response(content=...)`,
+            # and `Response(stream=...)`.
+            #
+            # Using `content=...` implies automatically populated content headers,
+            # of either `Content-Length: ...` or `Transfer-Encoding: chunked`.
+            #
+            # Using `stream=...` will not automatically include any content headers.
+            #
+            # As an end-user you don't really need `stream=...`. It's only
+            # useful when creating response instances having received a stream
+            # from the transport API.
+            self.stream = stream
+
+        self._num_bytes_downloaded = 0
+
+    def _prepare(self, default_headers: dict[str, str]) -> None:
+        for key, value in default_headers.items():
+            # Ignore Transfer-Encoding if the Content-Length has been set explicitly.
+            if key.lower() == "transfer-encoding" and "content-length" in self.headers:
+                continue
+            self.headers.setdefault(key, value)
+
+    @property
+    def elapsed(self) -> datetime.timedelta:
+        """
+        Returns the time taken for the complete request/response
+        cycle to complete.
+        """
+        if not hasattr(self, "_elapsed"):
+            raise RuntimeError(
+                "'.elapsed' may only be accessed after the response "
+                "has been read or closed."
+            )
+        return self._elapsed
+
+    @elapsed.setter
+    def elapsed(self, elapsed: datetime.timedelta) -> None:
+        self._elapsed = elapsed
+
+    @property
+    def request(self) -> Request:
+        """
+        Returns the request instance associated to the current response.
+        """
+        if self._request is None:
+            raise RuntimeError(
+                "The request instance has not been set on this response."
+            )
+        return self._request
+
+    @request.setter
+    def request(self, value: Request) -> None:
+        self._request = value
+
+    @property
+    def http_version(self) -> str:
+        try:
+            http_version: bytes = self.extensions["http_version"]
+        except KeyError:
+            return "HTTP/1.1"
+        else:
+            return http_version.decode("ascii", errors="ignore")
+
+    @property
+    def reason_phrase(self) -> str:
+        try:
+            reason_phrase: bytes = self.extensions["reason_phrase"]
+        except KeyError:
+            return codes.get_reason_phrase(self.status_code)
+        else:
+            return reason_phrase.decode("ascii", errors="ignore")
+
+    @property
+    def url(self) -> URL:
+        """
+        Returns the URL for which the request was made.
+        """
+        return self.request.url
+
+    @property
+    def content(self) -> bytes:
+        if not hasattr(self, "_content"):
+            raise ResponseNotRead()
+        return self._content
+
+    @property
+    def text(self) -> str:
+        if not hasattr(self, "_text"):
+            content = self.content
+            if not content:
+                self._text = ""
+            else:
+                decoder = TextDecoder(encoding=self.encoding or "utf-8")
+                self._text = "".join([decoder.decode(self.content), decoder.flush()])
+        return self._text
+
+    @property
+    def encoding(self) -> str | None:
+        """
+        Return an encoding to use for decoding the byte content into text.
+        The priority for determining this is given by...
+
+        * `.encoding = <>` has been set explicitly.
+        * The encoding as specified by the charset parameter in the Content-Type header.
+        * The encoding as determined by `default_encoding`, which may either be
+          a string like "utf-8" indicating the encoding to use, or may be a callable
+          which enables charset autodetection.
+        """
+        if not hasattr(self, "_encoding"):
+            encoding = self.charset_encoding
+            if encoding is None or not is_known_encoding(encoding):
+                if isinstance(self.default_encoding, str):
+                    encoding = self.default_encoding
+                elif hasattr(self, "_content"):
+                    encoding = self.default_encoding(self._content)
+            self._encoding = encoding or "utf-8"
+        return self._encoding
+
+    @encoding.setter
+    def encoding(self, value: str) -> None:
+        """
+        Set the encoding to use for decoding the byte content into text.
+
+        If the `text` attribute has been accessed, attempting to set the
+        encoding will throw a ValueError.
+        """
+        if hasattr(self, "_text"):
+            raise ValueError(
+                "Setting encoding after `text` has been accessed is not allowed."
+            )
+        self._encoding = value
+
+    @property
+    def charset_encoding(self) -> str | None:
+        """
+        Return the encoding, as specified by the Content-Type header.
+        """
+        content_type = self.headers.get("Content-Type")
+        if content_type is None:
+            return None
+
+        return parse_content_type_charset(content_type)
+
+    def _get_content_decoder(self) -> ContentDecoder:
+        """
+        Returns a decoder instance which can be used to decode the raw byte
+        content, depending on the Content-Encoding used in the response.
+        """
+        if not hasattr(self, "_decoder"):
+            decoders: list[ContentDecoder] = []
+            values = self.headers.get_list("content-encoding", split_commas=True)
+            for value in values:
+                value = value.strip().lower()
+                try:
+                    decoder_cls = SUPPORTED_DECODERS[value]
+                    decoders.append(decoder_cls())
+                except KeyError:
+                    continue
+
+            if len(decoders) == 1:
+                self._decoder = decoders[0]
+            elif len(decoders) > 1:
+                self._decoder = MultiDecoder(children=decoders)
+            else:
+                self._decoder = IdentityDecoder()
+
+        return self._decoder
+
+    @property
+    def is_informational(self) -> bool:
+        """
+        A property which is `True` for 1xx status codes, `False` otherwise.
+        """
+        return codes.is_informational(self.status_code)
+
+    @property
+    def is_success(self) -> bool:
+        """
+        A property which is `True` for 2xx status codes, `False` otherwise.
+        """
+        return codes.is_success(self.status_code)
+
+    @property
+    def is_redirect(self) -> bool:
+        """
+        A property which is `True` for 3xx status codes, `False` otherwise.
+
+        Note that not all responses with a 3xx status code indicate a URL redirect.
+
+        Use `response.has_redirect_location` to determine responses with a properly
+        formed URL redirection.
+        """
+        return codes.is_redirect(self.status_code)
+
+    @property
+    def is_client_error(self) -> bool:
+        """
+        A property which is `True` for 4xx status codes, `False` otherwise.
+        """
+        return codes.is_client_error(self.status_code)
+
+    @property
+    def is_server_error(self) -> bool:
+        """
+        A property which is `True` for 5xx status codes, `False` otherwise.
+        """
+        return codes.is_server_error(self.status_code)
+
+    @property
+    def is_error(self) -> bool:
+        """
+        A property which is `True` for 4xx and 5xx status codes, `False` otherwise.
+        """
+        return codes.is_error(self.status_code)
+
+    @property
+    def has_redirect_location(self) -> bool:
+        """
+        Returns True for 3xx responses with a properly formed URL redirection,
+        `False` otherwise.
+        """
+        return (
+            self.status_code
+            in (
+                # 301 (Cacheable redirect. Method may change to GET.)
+                codes.MOVED_PERMANENTLY,
+                # 302 (Uncacheable redirect. Method may change to GET.)
+                codes.FOUND,
+                # 303 (Client should make a GET or HEAD request.)
+                codes.SEE_OTHER,
+                # 307 (Equiv. 302, but retain method)
+                codes.TEMPORARY_REDIRECT,
+                # 308 (Equiv. 301, but retain method)
+                codes.PERMANENT_REDIRECT,
+            )
+            and "Location" in self.headers
+        )
+
+    def raise_for_status(self) -> Response:
+        """
+        Raise the `HTTPStatusError` if one occurred.
+        """
+        request = self._request
+        if request is None:
+            raise RuntimeError(
+                "Cannot call `raise_for_status` as the request "
+                "instance has not been set on this response."
+            )
+
+        if self.is_success:
+            return self
+
+        if self.has_redirect_location:
+            message = (
+                "{error_type} '{0.status_code} {0.reason_phrase}' for url '{0.url}'\n"
+                "Redirect location: '{0.headers[location]}'\n"
+                "For more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/{0.status_code}"
+            )
+        else:
+            message = (
+                "{error_type} '{0.status_code} {0.reason_phrase}' for url '{0.url}'\n"
+                "For more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/{0.status_code}"
+            )
+
+        status_class = self.status_code // 100
+        error_types = {
+            1: "Informational response",
+            3: "Redirect response",
+            4: "Client error",
+            5: "Server error",
+        }
+        error_type = error_types.get(status_class, "Invalid status code")
+        message = message.format(self, error_type=error_type)
+        raise HTTPStatusError(message, request=request, response=self)
+
+    def json(self, **kwargs: typing.Any) -> typing.Any:
+        return jsonlib.loads(self.content, **kwargs)
+
+    @property
+    def cookies(self) -> Cookies:
+        if not hasattr(self, "_cookies"):
+            self._cookies = Cookies()
+            self._cookies.extract_cookies(self)
+        return self._cookies
+
+    @property
+    def links(self) -> dict[str | None, dict[str, str]]:
+        """
+        Returns the parsed header links of the response, if any
+        """
+        header = self.headers.get("link")
+        if header is None:
+            return {}
+
+        return {
+            (link.get("rel") or link.get("url")): link
+            for link in parse_header_links(header)
+        }
+
+    @property
+    def num_bytes_downloaded(self) -> int:
+        return self._num_bytes_downloaded
+
+    def __repr__(self) -> str:
+        return f"<Response [{self.status_code} {self.reason_phrase}]>"
+
+    def __getstate__(self) -> dict[str, typing.Any]:
+        return {
+            name: value
+            for name, value in self.__dict__.items()
+            if name not in ["extensions", "stream", "is_closed", "_decoder"]
+        }
+
+    def __setstate__(self, state: dict[str, typing.Any]) -> None:
+        for name, value in state.items():
+            setattr(self, name, value)
+        self.is_closed = True
+        self.extensions = {}
+        self.stream = UnattachedStream()
+
+    def read(self) -> bytes:
+        """
+        Read and return the response content.
+        """
+        if not hasattr(self, "_content"):
+            self._content = b"".join(self.iter_bytes())
+        return self._content
+
+    def iter_bytes(self, chunk_size: int | None = None) -> typing.Iterator[bytes]:
+        """
+        A byte-iterator over the decoded response content.
+        This allows us to handle gzip, deflate, and brotli encoded responses.
+        """
+        if hasattr(self, "_content"):
+            chunk_size = len(self._content) if chunk_size is None else chunk_size
+            for i in range(0, len(self._content), max(chunk_size, 1)):
+                yield self._content[i : i + chunk_size]
+        else:
+            decoder = self._get_content_decoder()
+            chunker = ByteChunker(chunk_size=chunk_size)
+            with request_context(request=self._request):
+                for raw_bytes in self.iter_raw():
+                    decoded = decoder.decode(raw_bytes)
+                    for chunk in chunker.decode(decoded):
+                        yield chunk
+                decoded = decoder.flush()
+                for chunk in chunker.decode(decoded):
+                    yield chunk  # pragma: no cover
+                for chunk in chunker.flush():
+                    yield chunk
+
+    def iter_text(self, chunk_size: int | None = None) -> typing.Iterator[str]:
+        """
+        A str-iterator over the decoded response content
+        that handles both gzip, deflate, etc but also detects the content's
+        string encoding.
+        """
+        decoder = TextDecoder(encoding=self.encoding or "utf-8")
+        chunker = TextChunker(chunk_size=chunk_size)
+        with request_context(request=self._request):
+            for byte_content in self.iter_bytes():
+                text_content = decoder.decode(byte_content)
+                for chunk in chunker.decode(text_content):
+                    yield chunk
+            text_content = decoder.flush()
+            for chunk in chunker.decode(text_content):
+                yield chunk  # pragma: no cover
+            for chunk in chunker.flush():
+                yield chunk
+
+    def iter_lines(self) -> typing.Iterator[str]:
+        decoder = LineDecoder()
+        with request_context(request=self._request):
+            for text in self.iter_text():
+                for line in decoder.decode(text):
+                    yield line
+            for line in decoder.flush():
+                yield line
+
+    def iter_raw(self, chunk_size: int | None = None) -> typing.Iterator[bytes]:
+        """
+        A byte-iterator over the raw response content.
+        """
+        if self.is_stream_consumed:
+            raise StreamConsumed()
+        if self.is_closed:
+            raise StreamClosed()
+        if not isinstance(self.stream, SyncByteStream):
+            raise RuntimeError("Attempted to call a sync iterator on an async stream.")
+
+        self.is_stream_consumed = True
+        self._num_bytes_downloaded = 0
+        chunker = ByteChunker(chunk_size=chunk_size)
+
+        with request_context(request=self._request):
+            for raw_stream_bytes in self.stream:
+                self._num_bytes_downloaded += len(raw_stream_bytes)
+                for chunk in chunker.decode(raw_stream_bytes):
+                    yield chunk
+
+        for chunk in chunker.flush():
+            yield chunk
+
+        self.close()
+
+    def close(self) -> None:
+        """
+        Close the response and release the connection.
+        Automatically called if the response body is read to completion.
+        """
+        if not isinstance(self.stream, SyncByteStream):
+            raise RuntimeError("Attempted to call an sync close on an async stream.")
+
+        if not self.is_closed:
+            self.is_closed = True
+            with request_context(request=self._request):
+                self.stream.close()
+
+    async def aread(self) -> bytes:
+        """
+        Read and return the response content.
+        """
+        if not hasattr(self, "_content"):
+            self._content = b"".join([part async for part in self.aiter_bytes()])
+        return self._content
+
+    async def aiter_bytes(
+        self, chunk_size: int | None = None
+    ) -> typing.AsyncIterator[bytes]:
+        """
+        A byte-iterator over the decoded response content.
+        This allows us to handle gzip, deflate, and brotli encoded responses.
+        """
+        if hasattr(self, "_content"):
+            chunk_size = len(self._content) if chunk_size is None else chunk_size
+            for i in range(0, len(self._content), max(chunk_size, 1)):
+                yield self._content[i : i + chunk_size]
+        else:
+            decoder = self._get_content_decoder()
+            chunker = ByteChunker(chunk_size=chunk_size)
+            with request_context(request=self._request):
+                async for raw_bytes in self.aiter_raw():
+                    decoded = decoder.decode(raw_bytes)
+                    for chunk in chunker.decode(decoded):
+                        yield chunk
+                decoded = decoder.flush()
+                for chunk in chunker.decode(decoded):
+                    yield chunk  # pragma: no cover
+                for chunk in chunker.flush():
+                    yield chunk
+
+    async def aiter_text(
+        self, chunk_size: int | None = None
+    ) -> typing.AsyncIterator[str]:
+        """
+        A str-iterator over the decoded response content
+        that handles both gzip, deflate, etc but also detects the content's
+        string encoding.
+        """
+        decoder = TextDecoder(encoding=self.encoding or "utf-8")
+        chunker = TextChunker(chunk_size=chunk_size)
+        with request_context(request=self._request):
+            async for byte_content in self.aiter_bytes():
+                text_content = decoder.decode(byte_content)
+                for chunk in chunker.decode(text_content):
+                    yield chunk
+            text_content = decoder.flush()
+            for chunk in chunker.decode(text_content):
+                yield chunk  # pragma: no cover
+            for chunk in chunker.flush():
+                yield chunk
+
+    async def aiter_lines(self) -> typing.AsyncIterator[str]:
+        decoder = LineDecoder()
+        with request_context(request=self._request):
+            async for text in self.aiter_text():
+                for line in decoder.decode(text):
+                    yield line
+            for line in decoder.flush():
+                yield line
+
+    async def aiter_raw(
+        self, chunk_size: int | None = None
+    ) -> typing.AsyncIterator[bytes]:
+        """
+        A byte-iterator over the raw response content.
+        """
+        if self.is_stream_consumed:
+            raise StreamConsumed()
+        if self.is_closed:
+            raise StreamClosed()
+        if not isinstance(self.stream, AsyncByteStream):
+            raise RuntimeError("Attempted to call an async iterator on an sync stream.")
+
+        self.is_stream_consumed = True
+        self._num_bytes_downloaded = 0
+        chunker = ByteChunker(chunk_size=chunk_size)
+
+        with request_context(request=self._request):
+            async for raw_stream_bytes in self.stream:
+                self._num_bytes_downloaded += len(raw_stream_bytes)
+                for chunk in chunker.decode(raw_stream_bytes):
+                    yield chunk
+
+        for chunk in chunker.flush():
+            yield chunk
+
+        await self.aclose()
+
+    async def aclose(self) -> None:
+        """
+        Close the response and release the connection.
+        Automatically called if the response body is read to completion.
+        """
+        if not isinstance(self.stream, AsyncByteStream):
+            raise RuntimeError("Attempted to call an async close on an sync stream.")
+
+        if not self.is_closed:
+            self.is_closed = True
+            with request_context(request=self._request):
+                await self.stream.aclose()
+
+
+class Cookies(typing.MutableMapping[str, str]):
+    """
+    HTTP Cookies, as a mutable mapping.
+    """
+
+    def __init__(self, cookies: CookieTypes | None = None) -> None:
+        if cookies is None or isinstance(cookies, dict):
+            self.jar = CookieJar()
+            if isinstance(cookies, dict):
+                for key, value in cookies.items():
+                    self.set(key, value)
+        elif isinstance(cookies, list):
+            self.jar = CookieJar()
+            for key, value in cookies:
+                self.set(key, value)
+        elif isinstance(cookies, Cookies):
+            self.jar = CookieJar()
+            for cookie in cookies.jar:
+                self.jar.set_cookie(cookie)
+        else:
+            self.jar = cookies
+
+    def extract_cookies(self, response: Response) -> None:
+        """
+        Loads any cookies based on the response `Set-Cookie` headers.
+        """
+        urllib_response = self._CookieCompatResponse(response)
+        urllib_request = self._CookieCompatRequest(response.request)
+
+        self.jar.extract_cookies(urllib_response, urllib_request)  # type: ignore
+
+    def set_cookie_header(self, request: Request) -> None:
+        """
+        Sets an appropriate 'Cookie:' HTTP header on the `Request`.
+        """
+        urllib_request = self._CookieCompatRequest(request)
+        self.jar.add_cookie_header(urllib_request)
+
+    def set(self, name: str, value: str, domain: str = "", path: str = "/") -> None:
+        """
+        Set a cookie value by name. May optionally include domain and path.
+        """
+        kwargs = {
+            "version": 0,
+            "name": name,
+            "value": value,
+            "port": None,
+            "port_specified": False,
+            "domain": domain,
+            "domain_specified": bool(domain),
+            "domain_initial_dot": domain.startswith("."),
+            "path": path,
+            "path_specified": bool(path),
+            "secure": False,
+            "expires": None,
+            "discard": True,
+            "comment": None,
+            "comment_url": None,
+            "rest": {"HttpOnly": None},
+            "rfc2109": False,
+        }
+        cookie = Cookie(**kwargs)  # type: ignore
+        self.jar.set_cookie(cookie)
+
+    def get(  # type: ignore
+        self,
+        name: str,
+        default: str | None = None,
+        domain: str | None = None,
+        path: str | None = None,
+    ) -> str | None:
+        """
+        Get a cookie by name. May optionally include domain and path
+        in order to specify exactly which cookie to retrieve.
+        """
+        value = None
+        for cookie in self.jar:
+            if cookie.name == name:
+                if domain is None or cookie.domain == domain:
+                    if path is None or cookie.path == path:
+                        if value is not None:
+                            message = f"Multiple cookies exist with name={name}"
+                            raise CookieConflict(message)
+                        value = cookie.value
+
+        if value is None:
+            return default
+        return value
+
+    def delete(
+        self,
+        name: str,
+        domain: str | None = None,
+        path: str | None = None,
+    ) -> None:
+        """
+        Delete a cookie by name. May optionally include domain and path
+        in order to specify exactly which cookie to delete.
+        """
+        if domain is not None and path is not None:
+            return self.jar.clear(domain, path, name)
+
+        remove = [
+            cookie
+            for cookie in self.jar
+            if cookie.name == name
+            and (domain is None or cookie.domain == domain)
+            and (path is None or cookie.path == path)
+        ]
+
+        for cookie in remove:
+            self.jar.clear(cookie.domain, cookie.path, cookie.name)
+
+    def clear(self, domain: str | None = None, path: str | None = None) -> None:
+        """
+        Delete all cookies. Optionally include a domain and path in
+        order to only delete a subset of all the cookies.
+        """
+        args = []
+        if domain is not None:
+            args.append(domain)
+        if path is not None:
+            assert domain is not None
+            args.append(path)
+        self.jar.clear(*args)
+
+    def update(self, cookies: CookieTypes | None = None) -> None:  # type: ignore
+        cookies = Cookies(cookies)
+        for cookie in cookies.jar:
+            self.jar.set_cookie(cookie)
+
+    def __setitem__(self, name: str, value: str) -> None:
+        return self.set(name, value)
+
+    def __getitem__(self, name: str) -> str:
+        value = self.get(name)
+        if value is None:
+            raise KeyError(name)
+        return value
+
+    def __delitem__(self, name: str) -> None:
+        return self.delete(name)
+
+    def __len__(self) -> int:
+        return len(self.jar)
+
+    def __iter__(self) -> typing.Iterator[str]:
+        return (cookie.name for cookie in self.jar)
+
+    def __bool__(self) -> bool:
+        for _ in self.jar:
+            return True
+        return False
+
+    def __repr__(self) -> str:
+        cookies_repr = ", ".join(
+            [
+                f"<Cookie {cookie.name}={cookie.value} for {cookie.domain} />"
+                for cookie in self.jar
+            ]
+        )
+
+        return f"<Cookies[{cookies_repr}]>"
+
+    class _CookieCompatRequest(urllib.request.Request):
+        """
+        Wraps a `Request` instance up in a compatibility interface suitable
+        for use with `CookieJar` operations.
+        """
+
+        def __init__(self, request: Request) -> None:
+            super().__init__(
+                url=str(request.url),
+                headers=dict(request.headers),
+                method=request.method,
+            )
+            self.request = request
+
+        def add_unredirected_header(self, key: str, value: str) -> None:
+            super().add_unredirected_header(key, value)
+            self.request.headers[key] = value
+
+    class _CookieCompatResponse:
+        """
+        Wraps a `Request` instance up in a compatibility interface suitable
+        for use with `CookieJar` operations.
+        """
+
+        def __init__(self, response: Response) -> None:
+            self.response = response
+
+        def info(self) -> email.message.Message:
+            info = email.message.Message()
+            for key, value in self.response.headers.multi_items():
+                # Note that setting `info[key]` here is an "append" operation,
+                # not a "replace" operation.
+                # https://docs.python.org/3/library/email.compat32-message.html#email.message.Message.__setitem__
+                info[key] = value
+            return info
diff --git a/llm/Lib/site-packages/httpx/_multipart.py b/llm/Lib/site-packages/httpx/_multipart.py
new file mode 100644
index 0000000000000000000000000000000000000000..8edb622778afe1d1c832cc9857a8acd4bf2125f4
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_multipart.py
@@ -0,0 +1,269 @@
+from __future__ import annotations
+
+import io
+import os
+import typing
+from pathlib import Path
+
+from ._types import (
+    AsyncByteStream,
+    FileContent,
+    FileTypes,
+    RequestData,
+    RequestFiles,
+    SyncByteStream,
+)
+from ._utils import (
+    format_form_param,
+    guess_content_type,
+    peek_filelike_length,
+    primitive_value_to_str,
+    to_bytes,
+)
+
+
+def get_multipart_boundary_from_content_type(
+    content_type: bytes | None,
+) -> bytes | None:
+    if not content_type or not content_type.startswith(b"multipart/form-data"):
+        return None
+    # parse boundary according to
+    # https://www.rfc-editor.org/rfc/rfc2046#section-5.1.1
+    if b";" in content_type:
+        for section in content_type.split(b";"):
+            if section.strip().lower().startswith(b"boundary="):
+                return section.strip()[len(b"boundary=") :].strip(b'"')
+    return None
+
+
+class DataField:
+    """
+    A single form field item, within a multipart form field.
+    """
+
+    def __init__(self, name: str, value: str | bytes | int | float | None) -> None:
+        if not isinstance(name, str):
+            raise TypeError(
+                f"Invalid type for name. Expected str, got {type(name)}: {name!r}"
+            )
+        if value is not None and not isinstance(value, (str, bytes, int, float)):
+            raise TypeError(
+                "Invalid type for value. Expected primitive type,"
+                f" got {type(value)}: {value!r}"
+            )
+        self.name = name
+        self.value: str | bytes = (
+            value if isinstance(value, bytes) else primitive_value_to_str(value)
+        )
+
+    def render_headers(self) -> bytes:
+        if not hasattr(self, "_headers"):
+            name = format_form_param("name", self.name)
+            self._headers = b"".join(
+                [b"Content-Disposition: form-data; ", name, b"\r\n\r\n"]
+            )
+
+        return self._headers
+
+    def render_data(self) -> bytes:
+        if not hasattr(self, "_data"):
+            self._data = to_bytes(self.value)
+
+        return self._data
+
+    def get_length(self) -> int:
+        headers = self.render_headers()
+        data = self.render_data()
+        return len(headers) + len(data)
+
+    def render(self) -> typing.Iterator[bytes]:
+        yield self.render_headers()
+        yield self.render_data()
+
+
+class FileField:
+    """
+    A single file field item, within a multipart form field.
+    """
+
+    CHUNK_SIZE = 64 * 1024
+
+    def __init__(self, name: str, value: FileTypes) -> None:
+        self.name = name
+
+        fileobj: FileContent
+
+        headers: dict[str, str] = {}
+        content_type: str | None = None
+
+        # This large tuple based API largely mirror's requests' API
+        # It would be good to think of better APIs for this that we could
+        # include in httpx 2.0 since variable length tuples(especially of 4 elements)
+        # are quite unwieldly
+        if isinstance(value, tuple):
+            if len(value) == 2:
+                # neither the 3rd parameter (content_type) nor the 4th (headers)
+                # was included
+                filename, fileobj = value
+            elif len(value) == 3:
+                filename, fileobj, content_type = value
+            else:
+                # all 4 parameters included
+                filename, fileobj, content_type, headers = value  # type: ignore
+        else:
+            filename = Path(str(getattr(value, "name", "upload"))).name
+            fileobj = value
+
+        if content_type is None:
+            content_type = guess_content_type(filename)
+
+        has_content_type_header = any("content-type" in key.lower() for key in headers)
+        if content_type is not None and not has_content_type_header:
+            # note that unlike requests, we ignore the content_type provided in the 3rd
+            # tuple element if it is also included in the headers requests does
+            # the opposite (it overwrites the headerwith the 3rd tuple element)
+            headers["Content-Type"] = content_type
+
+        if isinstance(fileobj, io.StringIO):
+            raise TypeError(
+                "Multipart file uploads require 'io.BytesIO', not 'io.StringIO'."
+            )
+        if isinstance(fileobj, io.TextIOBase):
+            raise TypeError(
+                "Multipart file uploads must be opened in binary mode, not text mode."
+            )
+
+        self.filename = filename
+        self.file = fileobj
+        self.headers = headers
+
+    def get_length(self) -> int | None:
+        headers = self.render_headers()
+
+        if isinstance(self.file, (str, bytes)):
+            return len(headers) + len(to_bytes(self.file))
+
+        file_length = peek_filelike_length(self.file)
+
+        # If we can't determine the filesize without reading it into memory,
+        # then return `None` here, to indicate an unknown file length.
+        if file_length is None:
+            return None
+
+        return len(headers) + file_length
+
+    def render_headers(self) -> bytes:
+        if not hasattr(self, "_headers"):
+            parts = [
+                b"Content-Disposition: form-data; ",
+                format_form_param("name", self.name),
+            ]
+            if self.filename:
+                filename = format_form_param("filename", self.filename)
+                parts.extend([b"; ", filename])
+            for header_name, header_value in self.headers.items():
+                key, val = f"\r\n{header_name}: ".encode(), header_value.encode()
+                parts.extend([key, val])
+            parts.append(b"\r\n\r\n")
+            self._headers = b"".join(parts)
+
+        return self._headers
+
+    def render_data(self) -> typing.Iterator[bytes]:
+        if isinstance(self.file, (str, bytes)):
+            yield to_bytes(self.file)
+            return
+
+        if hasattr(self.file, "seek"):
+            try:
+                self.file.seek(0)
+            except io.UnsupportedOperation:
+                pass
+
+        chunk = self.file.read(self.CHUNK_SIZE)
+        while chunk:
+            yield to_bytes(chunk)
+            chunk = self.file.read(self.CHUNK_SIZE)
+
+    def render(self) -> typing.Iterator[bytes]:
+        yield self.render_headers()
+        yield from self.render_data()
+
+
+class MultipartStream(SyncByteStream, AsyncByteStream):
+    """
+    Request content as streaming multipart encoded form data.
+    """
+
+    def __init__(
+        self,
+        data: RequestData,
+        files: RequestFiles,
+        boundary: bytes | None = None,
+    ) -> None:
+        if boundary is None:
+            boundary = os.urandom(16).hex().encode("ascii")
+
+        self.boundary = boundary
+        self.content_type = "multipart/form-data; boundary=%s" % boundary.decode(
+            "ascii"
+        )
+        self.fields = list(self._iter_fields(data, files))
+
+    def _iter_fields(
+        self, data: RequestData, files: RequestFiles
+    ) -> typing.Iterator[FileField | DataField]:
+        for name, value in data.items():
+            if isinstance(value, (tuple, list)):
+                for item in value:
+                    yield DataField(name=name, value=item)
+            else:
+                yield DataField(name=name, value=value)
+
+        file_items = files.items() if isinstance(files, typing.Mapping) else files
+        for name, value in file_items:
+            yield FileField(name=name, value=value)
+
+    def iter_chunks(self) -> typing.Iterator[bytes]:
+        for field in self.fields:
+            yield b"--%s\r\n" % self.boundary
+            yield from field.render()
+            yield b"\r\n"
+        yield b"--%s--\r\n" % self.boundary
+
+    def get_content_length(self) -> int | None:
+        """
+        Return the length of the multipart encoded content, or `None` if
+        any of the files have a length that cannot be determined upfront.
+        """
+        boundary_length = len(self.boundary)
+        length = 0
+
+        for field in self.fields:
+            field_length = field.get_length()
+            if field_length is None:
+                return None
+
+            length += 2 + boundary_length + 2  # b"--{boundary}\r\n"
+            length += field_length
+            length += 2  # b"\r\n"
+
+        length += 2 + boundary_length + 4  # b"--{boundary}--\r\n"
+        return length
+
+    # Content stream interface.
+
+    def get_headers(self) -> dict[str, str]:
+        content_length = self.get_content_length()
+        content_type = self.content_type
+        if content_length is None:
+            return {"Transfer-Encoding": "chunked", "Content-Type": content_type}
+        return {"Content-Length": str(content_length), "Content-Type": content_type}
+
+    def __iter__(self) -> typing.Iterator[bytes]:
+        for chunk in self.iter_chunks():
+            yield chunk
+
+    async def __aiter__(self) -> typing.AsyncIterator[bytes]:
+        for chunk in self.iter_chunks():
+            yield chunk
diff --git a/llm/Lib/site-packages/httpx/_status_codes.py b/llm/Lib/site-packages/httpx/_status_codes.py
new file mode 100644
index 0000000000000000000000000000000000000000..4cde4e6845c4528cfda25a54cffcca5c8cd2858a
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_status_codes.py
@@ -0,0 +1,160 @@
+from __future__ import annotations
+
+from enum import IntEnum
+
+
+class codes(IntEnum):
+    """HTTP status codes and reason phrases
+
+    Status codes from the following RFCs are all observed:
+
+        * RFC 7231: Hypertext Transfer Protocol (HTTP/1.1), obsoletes 2616
+        * RFC 6585: Additional HTTP Status Codes
+        * RFC 3229: Delta encoding in HTTP
+        * RFC 4918: HTTP Extensions for WebDAV, obsoletes 2518
+        * RFC 5842: Binding Extensions to WebDAV
+        * RFC 7238: Permanent Redirect
+        * RFC 2295: Transparent Content Negotiation in HTTP
+        * RFC 2774: An HTTP Extension Framework
+        * RFC 7540: Hypertext Transfer Protocol Version 2 (HTTP/2)
+        * RFC 2324: Hyper Text Coffee Pot Control Protocol (HTCPCP/1.0)
+        * RFC 7725: An HTTP Status Code to Report Legal Obstacles
+        * RFC 8297: An HTTP Status Code for Indicating Hints
+        * RFC 8470: Using Early Data in HTTP
+    """
+
+    def __new__(cls, value: int, phrase: str = "") -> codes:
+        obj = int.__new__(cls, value)
+        obj._value_ = value
+
+        obj.phrase = phrase  # type: ignore[attr-defined]
+        return obj
+
+    def __str__(self) -> str:
+        return str(self.value)
+
+    @classmethod
+    def get_reason_phrase(cls, value: int) -> str:
+        try:
+            return codes(value).phrase  # type: ignore
+        except ValueError:
+            return ""
+
+    @classmethod
+    def is_informational(cls, value: int) -> bool:
+        """
+        Returns `True` for 1xx status codes, `False` otherwise.
+        """
+        return 100 <= value <= 199
+
+    @classmethod
+    def is_success(cls, value: int) -> bool:
+        """
+        Returns `True` for 2xx status codes, `False` otherwise.
+        """
+        return 200 <= value <= 299
+
+    @classmethod
+    def is_redirect(cls, value: int) -> bool:
+        """
+        Returns `True` for 3xx status codes, `False` otherwise.
+        """
+        return 300 <= value <= 399
+
+    @classmethod
+    def is_client_error(cls, value: int) -> bool:
+        """
+        Returns `True` for 4xx status codes, `False` otherwise.
+        """
+        return 400 <= value <= 499
+
+    @classmethod
+    def is_server_error(cls, value: int) -> bool:
+        """
+        Returns `True` for 5xx status codes, `False` otherwise.
+        """
+        return 500 <= value <= 599
+
+    @classmethod
+    def is_error(cls, value: int) -> bool:
+        """
+        Returns `True` for 4xx or 5xx status codes, `False` otherwise.
+        """
+        return 400 <= value <= 599
+
+    # informational
+    CONTINUE = 100, "Continue"
+    SWITCHING_PROTOCOLS = 101, "Switching Protocols"
+    PROCESSING = 102, "Processing"
+    EARLY_HINTS = 103, "Early Hints"
+
+    # success
+    OK = 200, "OK"
+    CREATED = 201, "Created"
+    ACCEPTED = 202, "Accepted"
+    NON_AUTHORITATIVE_INFORMATION = 203, "Non-Authoritative Information"
+    NO_CONTENT = 204, "No Content"
+    RESET_CONTENT = 205, "Reset Content"
+    PARTIAL_CONTENT = 206, "Partial Content"
+    MULTI_STATUS = 207, "Multi-Status"
+    ALREADY_REPORTED = 208, "Already Reported"
+    IM_USED = 226, "IM Used"
+
+    # redirection
+    MULTIPLE_CHOICES = 300, "Multiple Choices"
+    MOVED_PERMANENTLY = 301, "Moved Permanently"
+    FOUND = 302, "Found"
+    SEE_OTHER = 303, "See Other"
+    NOT_MODIFIED = 304, "Not Modified"
+    USE_PROXY = 305, "Use Proxy"
+    TEMPORARY_REDIRECT = 307, "Temporary Redirect"
+    PERMANENT_REDIRECT = 308, "Permanent Redirect"
+
+    # client error
+    BAD_REQUEST = 400, "Bad Request"
+    UNAUTHORIZED = 401, "Unauthorized"
+    PAYMENT_REQUIRED = 402, "Payment Required"
+    FORBIDDEN = 403, "Forbidden"
+    NOT_FOUND = 404, "Not Found"
+    METHOD_NOT_ALLOWED = 405, "Method Not Allowed"
+    NOT_ACCEPTABLE = 406, "Not Acceptable"
+    PROXY_AUTHENTICATION_REQUIRED = 407, "Proxy Authentication Required"
+    REQUEST_TIMEOUT = 408, "Request Timeout"
+    CONFLICT = 409, "Conflict"
+    GONE = 410, "Gone"
+    LENGTH_REQUIRED = 411, "Length Required"
+    PRECONDITION_FAILED = 412, "Precondition Failed"
+    REQUEST_ENTITY_TOO_LARGE = 413, "Request Entity Too Large"
+    REQUEST_URI_TOO_LONG = 414, "Request-URI Too Long"
+    UNSUPPORTED_MEDIA_TYPE = 415, "Unsupported Media Type"
+    REQUESTED_RANGE_NOT_SATISFIABLE = 416, "Requested Range Not Satisfiable"
+    EXPECTATION_FAILED = 417, "Expectation Failed"
+    IM_A_TEAPOT = 418, "I'm a teapot"
+    MISDIRECTED_REQUEST = 421, "Misdirected Request"
+    UNPROCESSABLE_ENTITY = 422, "Unprocessable Entity"
+    LOCKED = 423, "Locked"
+    FAILED_DEPENDENCY = 424, "Failed Dependency"
+    TOO_EARLY = 425, "Too Early"
+    UPGRADE_REQUIRED = 426, "Upgrade Required"
+    PRECONDITION_REQUIRED = 428, "Precondition Required"
+    TOO_MANY_REQUESTS = 429, "Too Many Requests"
+    REQUEST_HEADER_FIELDS_TOO_LARGE = 431, "Request Header Fields Too Large"
+    UNAVAILABLE_FOR_LEGAL_REASONS = 451, "Unavailable For Legal Reasons"
+
+    # server errors
+    INTERNAL_SERVER_ERROR = 500, "Internal Server Error"
+    NOT_IMPLEMENTED = 501, "Not Implemented"
+    BAD_GATEWAY = 502, "Bad Gateway"
+    SERVICE_UNAVAILABLE = 503, "Service Unavailable"
+    GATEWAY_TIMEOUT = 504, "Gateway Timeout"
+    HTTP_VERSION_NOT_SUPPORTED = 505, "HTTP Version Not Supported"
+    VARIANT_ALSO_NEGOTIATES = 506, "Variant Also Negotiates"
+    INSUFFICIENT_STORAGE = 507, "Insufficient Storage"
+    LOOP_DETECTED = 508, "Loop Detected"
+    NOT_EXTENDED = 510, "Not Extended"
+    NETWORK_AUTHENTICATION_REQUIRED = 511, "Network Authentication Required"
+
+
+# Include lower-case styles for `requests` compatibility.
+for code in codes:
+    setattr(codes, code._name_.lower(), int(code))
diff --git a/llm/Lib/site-packages/httpx/_transports/__init__.py b/llm/Lib/site-packages/httpx/_transports/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/httpx/_transports/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/httpx/_transports/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..038cbec06729a7a55e5b0ffe6cc1655fa2258ead
Binary files /dev/null and b/llm/Lib/site-packages/httpx/_transports/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/_transports/__pycache__/asgi.cpython-311.pyc b/llm/Lib/site-packages/httpx/_transports/__pycache__/asgi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fc9f5aa0aff8ac208ae7bfe8dfa76f369862ee66
Binary files /dev/null and b/llm/Lib/site-packages/httpx/_transports/__pycache__/asgi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/_transports/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/httpx/_transports/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..154b7b2adc58580db2751b1aad9c07dd0a11bd0b
Binary files /dev/null and b/llm/Lib/site-packages/httpx/_transports/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/_transports/__pycache__/default.cpython-311.pyc b/llm/Lib/site-packages/httpx/_transports/__pycache__/default.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0338bad628606851ade30a99e3a24925e99d545f
Binary files /dev/null and b/llm/Lib/site-packages/httpx/_transports/__pycache__/default.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/_transports/__pycache__/mock.cpython-311.pyc b/llm/Lib/site-packages/httpx/_transports/__pycache__/mock.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6fcc2854274ffb95d2ee0dacd1d7fa7b8b2bd46a
Binary files /dev/null and b/llm/Lib/site-packages/httpx/_transports/__pycache__/mock.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/_transports/__pycache__/wsgi.cpython-311.pyc b/llm/Lib/site-packages/httpx/_transports/__pycache__/wsgi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..877678b5839232643ca7822bcb42be9ec5663831
Binary files /dev/null and b/llm/Lib/site-packages/httpx/_transports/__pycache__/wsgi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/httpx/_transports/asgi.py b/llm/Lib/site-packages/httpx/_transports/asgi.py
new file mode 100644
index 0000000000000000000000000000000000000000..9543a12861cf7f792e93aa839fb81112e6f9b031
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_transports/asgi.py
@@ -0,0 +1,181 @@
+from __future__ import annotations
+
+import typing
+
+import sniffio
+
+from .._models import Request, Response
+from .._types import AsyncByteStream
+from .base import AsyncBaseTransport
+
+if typing.TYPE_CHECKING:  # pragma: no cover
+    import asyncio
+
+    import trio
+
+    Event = typing.Union[asyncio.Event, trio.Event]
+
+
+_Message = typing.Dict[str, typing.Any]
+_Receive = typing.Callable[[], typing.Awaitable[_Message]]
+_Send = typing.Callable[
+    [typing.Dict[str, typing.Any]], typing.Coroutine[None, None, None]
+]
+_ASGIApp = typing.Callable[
+    [typing.Dict[str, typing.Any], _Receive, _Send], typing.Coroutine[None, None, None]
+]
+
+
+def create_event() -> Event:
+    if sniffio.current_async_library() == "trio":
+        import trio
+
+        return trio.Event()
+    else:
+        import asyncio
+
+        return asyncio.Event()
+
+
+class ASGIResponseStream(AsyncByteStream):
+    def __init__(self, body: list[bytes]) -> None:
+        self._body = body
+
+    async def __aiter__(self) -> typing.AsyncIterator[bytes]:
+        yield b"".join(self._body)
+
+
+class ASGITransport(AsyncBaseTransport):
+    """
+    A custom AsyncTransport that handles sending requests directly to an ASGI app.
+    The simplest way to use this functionality is to use the `app` argument.
+
+    ```
+    client = httpx.AsyncClient(app=app)
+    ```
+
+    Alternatively, you can setup the transport instance explicitly.
+    This allows you to include any additional configuration arguments specific
+    to the ASGITransport class:
+
+    ```
+    transport = httpx.ASGITransport(
+        app=app,
+        root_path="/submount",
+        client=("1.2.3.4", 123)
+    )
+    client = httpx.AsyncClient(transport=transport)
+    ```
+
+    Arguments:
+
+    * `app` - The ASGI application.
+    * `raise_app_exceptions` - Boolean indicating if exceptions in the application
+       should be raised. Default to `True`. Can be set to `False` for use cases
+       such as testing the content of a client 500 response.
+    * `root_path` - The root path on which the ASGI application should be mounted.
+    * `client` - A two-tuple indicating the client IP and port of incoming requests.
+    ```
+    """
+
+    def __init__(
+        self,
+        app: _ASGIApp,
+        raise_app_exceptions: bool = True,
+        root_path: str = "",
+        client: tuple[str, int] = ("127.0.0.1", 123),
+    ) -> None:
+        self.app = app
+        self.raise_app_exceptions = raise_app_exceptions
+        self.root_path = root_path
+        self.client = client
+
+    async def handle_async_request(
+        self,
+        request: Request,
+    ) -> Response:
+        assert isinstance(request.stream, AsyncByteStream)
+
+        # ASGI scope.
+        scope = {
+            "type": "http",
+            "asgi": {"version": "3.0"},
+            "http_version": "1.1",
+            "method": request.method,
+            "headers": [(k.lower(), v) for (k, v) in request.headers.raw],
+            "scheme": request.url.scheme,
+            "path": request.url.path,
+            "raw_path": request.url.raw_path.split(b"?")[0],
+            "query_string": request.url.query,
+            "server": (request.url.host, request.url.port),
+            "client": self.client,
+            "root_path": self.root_path,
+        }
+
+        # Request.
+        request_body_chunks = request.stream.__aiter__()
+        request_complete = False
+
+        # Response.
+        status_code = None
+        response_headers = None
+        body_parts = []
+        response_started = False
+        response_complete = create_event()
+
+        # ASGI callables.
+
+        async def receive() -> dict[str, typing.Any]:
+            nonlocal request_complete
+
+            if request_complete:
+                await response_complete.wait()
+                return {"type": "http.disconnect"}
+
+            try:
+                body = await request_body_chunks.__anext__()
+            except StopAsyncIteration:
+                request_complete = True
+                return {"type": "http.request", "body": b"", "more_body": False}
+            return {"type": "http.request", "body": body, "more_body": True}
+
+        async def send(message: dict[str, typing.Any]) -> None:
+            nonlocal status_code, response_headers, response_started
+
+            if message["type"] == "http.response.start":
+                assert not response_started
+
+                status_code = message["status"]
+                response_headers = message.get("headers", [])
+                response_started = True
+
+            elif message["type"] == "http.response.body":
+                assert not response_complete.is_set()
+                body = message.get("body", b"")
+                more_body = message.get("more_body", False)
+
+                if body and request.method != "HEAD":
+                    body_parts.append(body)
+
+                if not more_body:
+                    response_complete.set()
+
+        try:
+            await self.app(scope, receive, send)
+        except Exception:  # noqa: PIE-786
+            if self.raise_app_exceptions:
+                raise
+
+            response_complete.set()
+            if status_code is None:
+                status_code = 500
+            if response_headers is None:
+                response_headers = {}
+
+        assert response_complete.is_set()
+        assert status_code is not None
+        assert response_headers is not None
+
+        stream = ASGIResponseStream(body_parts)
+
+        return Response(status_code, headers=response_headers, stream=stream)
diff --git a/llm/Lib/site-packages/httpx/_transports/base.py b/llm/Lib/site-packages/httpx/_transports/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b6dc3c239151fa80fdc7b9605a63fa7f4915c61
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_transports/base.py
@@ -0,0 +1,84 @@
+from __future__ import annotations
+
+import typing
+from types import TracebackType
+
+from .._models import Request, Response
+
+T = typing.TypeVar("T", bound="BaseTransport")
+A = typing.TypeVar("A", bound="AsyncBaseTransport")
+
+
+class BaseTransport:
+    def __enter__(self: T) -> T:
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None = None,
+        exc_value: BaseException | None = None,
+        traceback: TracebackType | None = None,
+    ) -> None:
+        self.close()
+
+    def handle_request(self, request: Request) -> Response:
+        """
+        Send a single HTTP request and return a response.
+
+        Developers shouldn't typically ever need to call into this API directly,
+        since the Client class provides all the higher level user-facing API
+        niceties.
+
+        In order to properly release any network resources, the response
+        stream should *either* be consumed immediately, with a call to
+        `response.stream.read()`, or else the `handle_request` call should
+        be followed with a try/finally block to ensuring the stream is
+        always closed.
+
+        Example usage:
+
+            with httpx.HTTPTransport() as transport:
+                req = httpx.Request(
+                    method=b"GET",
+                    url=(b"https", b"www.example.com", 443, b"/"),
+                    headers=[(b"Host", b"www.example.com")],
+                )
+                resp = transport.handle_request(req)
+                body = resp.stream.read()
+                print(resp.status_code, resp.headers, body)
+
+
+        Takes a `Request` instance as the only argument.
+
+        Returns a `Response` instance.
+        """
+        raise NotImplementedError(
+            "The 'handle_request' method must be implemented."
+        )  # pragma: no cover
+
+    def close(self) -> None:
+        pass
+
+
+class AsyncBaseTransport:
+    async def __aenter__(self: A) -> A:
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None = None,
+        exc_value: BaseException | None = None,
+        traceback: TracebackType | None = None,
+    ) -> None:
+        await self.aclose()
+
+    async def handle_async_request(
+        self,
+        request: Request,
+    ) -> Response:
+        raise NotImplementedError(
+            "The 'handle_async_request' method must be implemented."
+        )  # pragma: no cover
+
+    async def aclose(self) -> None:
+        pass
diff --git a/llm/Lib/site-packages/httpx/_transports/default.py b/llm/Lib/site-packages/httpx/_transports/default.py
new file mode 100644
index 0000000000000000000000000000000000000000..14476a3ce3effdfa76bec5d47062a1f6242dc8bb
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_transports/default.py
@@ -0,0 +1,385 @@
+"""
+Custom transports, with nicely configured defaults.
+
+The following additional keyword arguments are currently supported by httpcore...
+
+* uds: str
+* local_address: str
+* retries: int
+
+Example usages...
+
+# Disable HTTP/2 on a single specific domain.
+mounts = {
+    "all://": httpx.HTTPTransport(http2=True),
+    "all://*example.org": httpx.HTTPTransport()
+}
+
+# Using advanced httpcore configuration, with connection retries.
+transport = httpx.HTTPTransport(retries=1)
+client = httpx.Client(transport=transport)
+
+# Using advanced httpcore configuration, with unix domain sockets.
+transport = httpx.HTTPTransport(uds="socket.uds")
+client = httpx.Client(transport=transport)
+"""
+from __future__ import annotations
+
+import contextlib
+import typing
+from types import TracebackType
+
+import httpcore
+
+from .._config import DEFAULT_LIMITS, Limits, Proxy, create_ssl_context
+from .._exceptions import (
+    ConnectError,
+    ConnectTimeout,
+    LocalProtocolError,
+    NetworkError,
+    PoolTimeout,
+    ProtocolError,
+    ProxyError,
+    ReadError,
+    ReadTimeout,
+    RemoteProtocolError,
+    TimeoutException,
+    UnsupportedProtocol,
+    WriteError,
+    WriteTimeout,
+)
+from .._models import Request, Response
+from .._types import AsyncByteStream, CertTypes, ProxyTypes, SyncByteStream, VerifyTypes
+from .._urls import URL
+from .base import AsyncBaseTransport, BaseTransport
+
+T = typing.TypeVar("T", bound="HTTPTransport")
+A = typing.TypeVar("A", bound="AsyncHTTPTransport")
+
+SOCKET_OPTION = typing.Union[
+    typing.Tuple[int, int, int],
+    typing.Tuple[int, int, typing.Union[bytes, bytearray]],
+    typing.Tuple[int, int, None, int],
+]
+
+
+@contextlib.contextmanager
+def map_httpcore_exceptions() -> typing.Iterator[None]:
+    try:
+        yield
+    except Exception as exc:
+        mapped_exc = None
+
+        for from_exc, to_exc in HTTPCORE_EXC_MAP.items():
+            if not isinstance(exc, from_exc):
+                continue
+            # We want to map to the most specific exception we can find.
+            # Eg if `exc` is an `httpcore.ReadTimeout`, we want to map to
+            # `httpx.ReadTimeout`, not just `httpx.TimeoutException`.
+            if mapped_exc is None or issubclass(to_exc, mapped_exc):
+                mapped_exc = to_exc
+
+        if mapped_exc is None:  # pragma: no cover
+            raise
+
+        message = str(exc)
+        raise mapped_exc(message) from exc
+
+
+HTTPCORE_EXC_MAP = {
+    httpcore.TimeoutException: TimeoutException,
+    httpcore.ConnectTimeout: ConnectTimeout,
+    httpcore.ReadTimeout: ReadTimeout,
+    httpcore.WriteTimeout: WriteTimeout,
+    httpcore.PoolTimeout: PoolTimeout,
+    httpcore.NetworkError: NetworkError,
+    httpcore.ConnectError: ConnectError,
+    httpcore.ReadError: ReadError,
+    httpcore.WriteError: WriteError,
+    httpcore.ProxyError: ProxyError,
+    httpcore.UnsupportedProtocol: UnsupportedProtocol,
+    httpcore.ProtocolError: ProtocolError,
+    httpcore.LocalProtocolError: LocalProtocolError,
+    httpcore.RemoteProtocolError: RemoteProtocolError,
+}
+
+
+class ResponseStream(SyncByteStream):
+    def __init__(self, httpcore_stream: typing.Iterable[bytes]) -> None:
+        self._httpcore_stream = httpcore_stream
+
+    def __iter__(self) -> typing.Iterator[bytes]:
+        with map_httpcore_exceptions():
+            for part in self._httpcore_stream:
+                yield part
+
+    def close(self) -> None:
+        if hasattr(self._httpcore_stream, "close"):
+            self._httpcore_stream.close()
+
+
+class HTTPTransport(BaseTransport):
+    def __init__(
+        self,
+        verify: VerifyTypes = True,
+        cert: CertTypes | None = None,
+        http1: bool = True,
+        http2: bool = False,
+        limits: Limits = DEFAULT_LIMITS,
+        trust_env: bool = True,
+        proxy: ProxyTypes | None = None,
+        uds: str | None = None,
+        local_address: str | None = None,
+        retries: int = 0,
+        socket_options: typing.Iterable[SOCKET_OPTION] | None = None,
+    ) -> None:
+        ssl_context = create_ssl_context(verify=verify, cert=cert, trust_env=trust_env)
+        proxy = Proxy(url=proxy) if isinstance(proxy, (str, URL)) else proxy
+
+        if proxy is None:
+            self._pool = httpcore.ConnectionPool(
+                ssl_context=ssl_context,
+                max_connections=limits.max_connections,
+                max_keepalive_connections=limits.max_keepalive_connections,
+                keepalive_expiry=limits.keepalive_expiry,
+                http1=http1,
+                http2=http2,
+                uds=uds,
+                local_address=local_address,
+                retries=retries,
+                socket_options=socket_options,
+            )
+        elif proxy.url.scheme in ("http", "https"):
+            self._pool = httpcore.HTTPProxy(
+                proxy_url=httpcore.URL(
+                    scheme=proxy.url.raw_scheme,
+                    host=proxy.url.raw_host,
+                    port=proxy.url.port,
+                    target=proxy.url.raw_path,
+                ),
+                proxy_auth=proxy.raw_auth,
+                proxy_headers=proxy.headers.raw,
+                ssl_context=ssl_context,
+                proxy_ssl_context=proxy.ssl_context,
+                max_connections=limits.max_connections,
+                max_keepalive_connections=limits.max_keepalive_connections,
+                keepalive_expiry=limits.keepalive_expiry,
+                http1=http1,
+                http2=http2,
+                socket_options=socket_options,
+            )
+        elif proxy.url.scheme == "socks5":
+            try:
+                import socksio  # noqa
+            except ImportError:  # pragma: no cover
+                raise ImportError(
+                    "Using SOCKS proxy, but the 'socksio' package is not installed. "
+                    "Make sure to install httpx using `pip install httpx[socks]`."
+                ) from None
+
+            self._pool = httpcore.SOCKSProxy(
+                proxy_url=httpcore.URL(
+                    scheme=proxy.url.raw_scheme,
+                    host=proxy.url.raw_host,
+                    port=proxy.url.port,
+                    target=proxy.url.raw_path,
+                ),
+                proxy_auth=proxy.raw_auth,
+                ssl_context=ssl_context,
+                max_connections=limits.max_connections,
+                max_keepalive_connections=limits.max_keepalive_connections,
+                keepalive_expiry=limits.keepalive_expiry,
+                http1=http1,
+                http2=http2,
+            )
+        else:  # pragma: no cover
+            raise ValueError(
+                "Proxy protocol must be either 'http', 'https', or 'socks5',"
+                f" but got {proxy.url.scheme!r}."
+            )
+
+    def __enter__(self: T) -> T:  # Use generics for subclass support.
+        self._pool.__enter__()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None = None,
+        exc_value: BaseException | None = None,
+        traceback: TracebackType | None = None,
+    ) -> None:
+        with map_httpcore_exceptions():
+            self._pool.__exit__(exc_type, exc_value, traceback)
+
+    def handle_request(
+        self,
+        request: Request,
+    ) -> Response:
+        assert isinstance(request.stream, SyncByteStream)
+
+        req = httpcore.Request(
+            method=request.method,
+            url=httpcore.URL(
+                scheme=request.url.raw_scheme,
+                host=request.url.raw_host,
+                port=request.url.port,
+                target=request.url.raw_path,
+            ),
+            headers=request.headers.raw,
+            content=request.stream,
+            extensions=request.extensions,
+        )
+        with map_httpcore_exceptions():
+            resp = self._pool.handle_request(req)
+
+        assert isinstance(resp.stream, typing.Iterable)
+
+        return Response(
+            status_code=resp.status,
+            headers=resp.headers,
+            stream=ResponseStream(resp.stream),
+            extensions=resp.extensions,
+        )
+
+    def close(self) -> None:
+        self._pool.close()
+
+
+class AsyncResponseStream(AsyncByteStream):
+    def __init__(self, httpcore_stream: typing.AsyncIterable[bytes]) -> None:
+        self._httpcore_stream = httpcore_stream
+
+    async def __aiter__(self) -> typing.AsyncIterator[bytes]:
+        with map_httpcore_exceptions():
+            async for part in self._httpcore_stream:
+                yield part
+
+    async def aclose(self) -> None:
+        if hasattr(self._httpcore_stream, "aclose"):
+            await self._httpcore_stream.aclose()
+
+
+class AsyncHTTPTransport(AsyncBaseTransport):
+    def __init__(
+        self,
+        verify: VerifyTypes = True,
+        cert: CertTypes | None = None,
+        http1: bool = True,
+        http2: bool = False,
+        limits: Limits = DEFAULT_LIMITS,
+        trust_env: bool = True,
+        proxy: ProxyTypes | None = None,
+        uds: str | None = None,
+        local_address: str | None = None,
+        retries: int = 0,
+        socket_options: typing.Iterable[SOCKET_OPTION] | None = None,
+    ) -> None:
+        ssl_context = create_ssl_context(verify=verify, cert=cert, trust_env=trust_env)
+        proxy = Proxy(url=proxy) if isinstance(proxy, (str, URL)) else proxy
+
+        if proxy is None:
+            self._pool = httpcore.AsyncConnectionPool(
+                ssl_context=ssl_context,
+                max_connections=limits.max_connections,
+                max_keepalive_connections=limits.max_keepalive_connections,
+                keepalive_expiry=limits.keepalive_expiry,
+                http1=http1,
+                http2=http2,
+                uds=uds,
+                local_address=local_address,
+                retries=retries,
+                socket_options=socket_options,
+            )
+        elif proxy.url.scheme in ("http", "https"):
+            self._pool = httpcore.AsyncHTTPProxy(
+                proxy_url=httpcore.URL(
+                    scheme=proxy.url.raw_scheme,
+                    host=proxy.url.raw_host,
+                    port=proxy.url.port,
+                    target=proxy.url.raw_path,
+                ),
+                proxy_auth=proxy.raw_auth,
+                proxy_headers=proxy.headers.raw,
+                ssl_context=ssl_context,
+                max_connections=limits.max_connections,
+                max_keepalive_connections=limits.max_keepalive_connections,
+                keepalive_expiry=limits.keepalive_expiry,
+                http1=http1,
+                http2=http2,
+                socket_options=socket_options,
+            )
+        elif proxy.url.scheme == "socks5":
+            try:
+                import socksio  # noqa
+            except ImportError:  # pragma: no cover
+                raise ImportError(
+                    "Using SOCKS proxy, but the 'socksio' package is not installed. "
+                    "Make sure to install httpx using `pip install httpx[socks]`."
+                ) from None
+
+            self._pool = httpcore.AsyncSOCKSProxy(
+                proxy_url=httpcore.URL(
+                    scheme=proxy.url.raw_scheme,
+                    host=proxy.url.raw_host,
+                    port=proxy.url.port,
+                    target=proxy.url.raw_path,
+                ),
+                proxy_auth=proxy.raw_auth,
+                ssl_context=ssl_context,
+                max_connections=limits.max_connections,
+                max_keepalive_connections=limits.max_keepalive_connections,
+                keepalive_expiry=limits.keepalive_expiry,
+                http1=http1,
+                http2=http2,
+            )
+        else:  # pragma: no cover
+            raise ValueError(
+                "Proxy protocol must be either 'http', 'https', or 'socks5',"
+                " but got {proxy.url.scheme!r}."
+            )
+
+    async def __aenter__(self: A) -> A:  # Use generics for subclass support.
+        await self._pool.__aenter__()
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None = None,
+        exc_value: BaseException | None = None,
+        traceback: TracebackType | None = None,
+    ) -> None:
+        with map_httpcore_exceptions():
+            await self._pool.__aexit__(exc_type, exc_value, traceback)
+
+    async def handle_async_request(
+        self,
+        request: Request,
+    ) -> Response:
+        assert isinstance(request.stream, AsyncByteStream)
+
+        req = httpcore.Request(
+            method=request.method,
+            url=httpcore.URL(
+                scheme=request.url.raw_scheme,
+                host=request.url.raw_host,
+                port=request.url.port,
+                target=request.url.raw_path,
+            ),
+            headers=request.headers.raw,
+            content=request.stream,
+            extensions=request.extensions,
+        )
+        with map_httpcore_exceptions():
+            resp = await self._pool.handle_async_request(req)
+
+        assert isinstance(resp.stream, typing.AsyncIterable)
+
+        return Response(
+            status_code=resp.status,
+            headers=resp.headers,
+            stream=AsyncResponseStream(resp.stream),
+            extensions=resp.extensions,
+        )
+
+    async def aclose(self) -> None:
+        await self._pool.aclose()
diff --git a/llm/Lib/site-packages/httpx/_transports/mock.py b/llm/Lib/site-packages/httpx/_transports/mock.py
new file mode 100644
index 0000000000000000000000000000000000000000..5abea837312b22f502ef18675e1a1f7b2b84a1dc
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_transports/mock.py
@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+import typing
+
+from .._models import Request, Response
+from .base import AsyncBaseTransport, BaseTransport
+
+SyncHandler = typing.Callable[[Request], Response]
+AsyncHandler = typing.Callable[[Request], typing.Coroutine[None, None, Response]]
+
+
+class MockTransport(AsyncBaseTransport, BaseTransport):
+    def __init__(self, handler: SyncHandler | AsyncHandler) -> None:
+        self.handler = handler
+
+    def handle_request(
+        self,
+        request: Request,
+    ) -> Response:
+        request.read()
+        response = self.handler(request)
+        if not isinstance(response, Response):  # pragma: no cover
+            raise TypeError("Cannot use an async handler in a sync Client")
+        return response
+
+    async def handle_async_request(
+        self,
+        request: Request,
+    ) -> Response:
+        await request.aread()
+        response = self.handler(request)
+
+        # Allow handler to *optionally* be an `async` function.
+        # If it is, then the `response` variable need to be awaited to actually
+        # return the result.
+
+        if not isinstance(response, Response):
+            response = await response
+
+        return response
diff --git a/llm/Lib/site-packages/httpx/_transports/wsgi.py b/llm/Lib/site-packages/httpx/_transports/wsgi.py
new file mode 100644
index 0000000000000000000000000000000000000000..cd03a9417baf8148369e9dc7e2809595ecdee47b
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_transports/wsgi.py
@@ -0,0 +1,146 @@
+from __future__ import annotations
+
+import io
+import itertools
+import sys
+import typing
+
+from .._models import Request, Response
+from .._types import SyncByteStream
+from .base import BaseTransport
+
+if typing.TYPE_CHECKING:
+    from _typeshed import OptExcInfo  # pragma: no cover
+    from _typeshed.wsgi import WSGIApplication  # pragma: no cover
+
+_T = typing.TypeVar("_T")
+
+
+def _skip_leading_empty_chunks(body: typing.Iterable[_T]) -> typing.Iterable[_T]:
+    body = iter(body)
+    for chunk in body:
+        if chunk:
+            return itertools.chain([chunk], body)
+    return []
+
+
+class WSGIByteStream(SyncByteStream):
+    def __init__(self, result: typing.Iterable[bytes]) -> None:
+        self._close = getattr(result, "close", None)
+        self._result = _skip_leading_empty_chunks(result)
+
+    def __iter__(self) -> typing.Iterator[bytes]:
+        for part in self._result:
+            yield part
+
+    def close(self) -> None:
+        if self._close is not None:
+            self._close()
+
+
+class WSGITransport(BaseTransport):
+    """
+    A custom transport that handles sending requests directly to an WSGI app.
+    The simplest way to use this functionality is to use the `app` argument.
+
+    ```
+    client = httpx.Client(app=app)
+    ```
+
+    Alternatively, you can setup the transport instance explicitly.
+    This allows you to include any additional configuration arguments specific
+    to the WSGITransport class:
+
+    ```
+    transport = httpx.WSGITransport(
+        app=app,
+        script_name="/submount",
+        remote_addr="1.2.3.4"
+    )
+    client = httpx.Client(transport=transport)
+    ```
+
+    Arguments:
+
+    * `app` - The WSGI application.
+    * `raise_app_exceptions` - Boolean indicating if exceptions in the application
+       should be raised. Default to `True`. Can be set to `False` for use cases
+       such as testing the content of a client 500 response.
+    * `script_name` - The root path on which the WSGI application should be mounted.
+    * `remote_addr` - A string indicating the client IP of incoming requests.
+    ```
+    """
+
+    def __init__(
+        self,
+        app: WSGIApplication,
+        raise_app_exceptions: bool = True,
+        script_name: str = "",
+        remote_addr: str = "127.0.0.1",
+        wsgi_errors: typing.TextIO | None = None,
+    ) -> None:
+        self.app = app
+        self.raise_app_exceptions = raise_app_exceptions
+        self.script_name = script_name
+        self.remote_addr = remote_addr
+        self.wsgi_errors = wsgi_errors
+
+    def handle_request(self, request: Request) -> Response:
+        request.read()
+        wsgi_input = io.BytesIO(request.content)
+
+        port = request.url.port or {"http": 80, "https": 443}[request.url.scheme]
+        environ = {
+            "wsgi.version": (1, 0),
+            "wsgi.url_scheme": request.url.scheme,
+            "wsgi.input": wsgi_input,
+            "wsgi.errors": self.wsgi_errors or sys.stderr,
+            "wsgi.multithread": True,
+            "wsgi.multiprocess": False,
+            "wsgi.run_once": False,
+            "REQUEST_METHOD": request.method,
+            "SCRIPT_NAME": self.script_name,
+            "PATH_INFO": request.url.path,
+            "QUERY_STRING": request.url.query.decode("ascii"),
+            "SERVER_NAME": request.url.host,
+            "SERVER_PORT": str(port),
+            "SERVER_PROTOCOL": "HTTP/1.1",
+            "REMOTE_ADDR": self.remote_addr,
+        }
+        for header_key, header_value in request.headers.raw:
+            key = header_key.decode("ascii").upper().replace("-", "_")
+            if key not in ("CONTENT_TYPE", "CONTENT_LENGTH"):
+                key = "HTTP_" + key
+            environ[key] = header_value.decode("ascii")
+
+        seen_status = None
+        seen_response_headers = None
+        seen_exc_info = None
+
+        def start_response(
+            status: str,
+            response_headers: list[tuple[str, str]],
+            exc_info: OptExcInfo | None = None,
+        ) -> typing.Callable[[bytes], typing.Any]:
+            nonlocal seen_status, seen_response_headers, seen_exc_info
+            seen_status = status
+            seen_response_headers = response_headers
+            seen_exc_info = exc_info
+            return lambda _: None
+
+        result = self.app(environ, start_response)
+
+        stream = WSGIByteStream(result)
+
+        assert seen_status is not None
+        assert seen_response_headers is not None
+        if seen_exc_info and seen_exc_info[0] and self.raise_app_exceptions:
+            raise seen_exc_info[1]
+
+        status_code = int(seen_status.split()[0])
+        headers = [
+            (key.encode("ascii"), value.encode("ascii"))
+            for key, value in seen_response_headers
+        ]
+
+        return Response(status_code, headers=headers, stream=stream)
diff --git a/llm/Lib/site-packages/httpx/_types.py b/llm/Lib/site-packages/httpx/_types.py
new file mode 100644
index 0000000000000000000000000000000000000000..649d101d54a232a05bbdc16f2f44cb4882118667
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_types.py
@@ -0,0 +1,134 @@
+"""
+Type definitions for type checking purposes.
+"""
+
+import ssl
+from http.cookiejar import CookieJar
+from typing import (
+    IO,
+    TYPE_CHECKING,
+    Any,
+    AsyncIterable,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    MutableMapping,
+    NamedTuple,
+    Optional,
+    Sequence,
+    Tuple,
+    Union,
+)
+
+if TYPE_CHECKING:  # pragma: no cover
+    from ._auth import Auth  # noqa: F401
+    from ._config import Proxy, Timeout  # noqa: F401
+    from ._models import Cookies, Headers, Request  # noqa: F401
+    from ._urls import URL, QueryParams  # noqa: F401
+
+
+PrimitiveData = Optional[Union[str, int, float, bool]]
+
+RawURL = NamedTuple(
+    "RawURL",
+    [
+        ("raw_scheme", bytes),
+        ("raw_host", bytes),
+        ("port", Optional[int]),
+        ("raw_path", bytes),
+    ],
+)
+
+URLTypes = Union["URL", str]
+
+QueryParamTypes = Union[
+    "QueryParams",
+    Mapping[str, Union[PrimitiveData, Sequence[PrimitiveData]]],
+    List[Tuple[str, PrimitiveData]],
+    Tuple[Tuple[str, PrimitiveData], ...],
+    str,
+    bytes,
+]
+
+HeaderTypes = Union[
+    "Headers",
+    Mapping[str, str],
+    Mapping[bytes, bytes],
+    Sequence[Tuple[str, str]],
+    Sequence[Tuple[bytes, bytes]],
+]
+
+CookieTypes = Union["Cookies", CookieJar, Dict[str, str], List[Tuple[str, str]]]
+
+CertTypes = Union[
+    # certfile
+    str,
+    # (certfile, keyfile)
+    Tuple[str, Optional[str]],
+    # (certfile, keyfile, password)
+    Tuple[str, Optional[str], Optional[str]],
+]
+VerifyTypes = Union[str, bool, ssl.SSLContext]
+TimeoutTypes = Union[
+    Optional[float],
+    Tuple[Optional[float], Optional[float], Optional[float], Optional[float]],
+    "Timeout",
+]
+ProxyTypes = Union[URLTypes, "Proxy"]
+ProxiesTypes = Union[ProxyTypes, Dict[URLTypes, Union[None, ProxyTypes]]]
+
+AuthTypes = Union[
+    Tuple[Union[str, bytes], Union[str, bytes]],
+    Callable[["Request"], "Request"],
+    "Auth",
+]
+
+RequestContent = Union[str, bytes, Iterable[bytes], AsyncIterable[bytes]]
+ResponseContent = Union[str, bytes, Iterable[bytes], AsyncIterable[bytes]]
+ResponseExtensions = MutableMapping[str, Any]
+
+RequestData = Mapping[str, Any]
+
+FileContent = Union[IO[bytes], bytes, str]
+FileTypes = Union[
+    # file (or bytes)
+    FileContent,
+    # (filename, file (or bytes))
+    Tuple[Optional[str], FileContent],
+    # (filename, file (or bytes), content_type)
+    Tuple[Optional[str], FileContent, Optional[str]],
+    # (filename, file (or bytes), content_type, headers)
+    Tuple[Optional[str], FileContent, Optional[str], Mapping[str, str]],
+]
+RequestFiles = Union[Mapping[str, FileTypes], Sequence[Tuple[str, FileTypes]]]
+
+RequestExtensions = MutableMapping[str, Any]
+
+
+class SyncByteStream:
+    def __iter__(self) -> Iterator[bytes]:
+        raise NotImplementedError(
+            "The '__iter__' method must be implemented."
+        )  # pragma: no cover
+        yield b""  # pragma: no cover
+
+    def close(self) -> None:
+        """
+        Subclasses can override this method to release any network resources
+        after a request/response cycle is complete.
+        """
+
+
+class AsyncByteStream:
+    async def __aiter__(self) -> AsyncIterator[bytes]:
+        raise NotImplementedError(
+            "The '__aiter__' method must be implemented."
+        )  # pragma: no cover
+        yield b""  # pragma: no cover
+
+    async def aclose(self) -> None:
+        pass
diff --git a/llm/Lib/site-packages/httpx/_urlparse.py b/llm/Lib/site-packages/httpx/_urlparse.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a4b55b38c0780d6ab9e28b779076c91e880d598
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_urlparse.py
@@ -0,0 +1,502 @@
+"""
+An implementation of `urlparse` that provides URL validation and normalization
+as described by RFC3986.
+
+We rely on this implementation rather than the one in Python's stdlib, because:
+
+* It provides more complete URL validation.
+* It properly differentiates between an empty querystring and an absent querystring,
+  to distinguish URLs with a trailing '?'.
+* It handles scheme, hostname, port, and path normalization.
+* It supports IDNA hostnames, normalizing them to their encoded form.
+* The API supports passing individual components, as well as the complete URL string.
+
+Previously we relied on the excellent `rfc3986` package to handle URL parsing and
+validation, but this module provides a simpler alternative, with less indirection
+required.
+"""
+from __future__ import annotations
+
+import ipaddress
+import re
+import typing
+
+import idna
+
+from ._exceptions import InvalidURL
+
+MAX_URL_LENGTH = 65536
+
+# https://datatracker.ietf.org/doc/html/rfc3986.html#section-2.3
+UNRESERVED_CHARACTERS = (
+    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~"
+)
+SUB_DELIMS = "!$&'()*+,;="
+
+PERCENT_ENCODED_REGEX = re.compile("%[A-Fa-f0-9]{2}")
+
+
+# {scheme}:      (optional)
+# //{authority}  (optional)
+# {path}
+# ?{query}       (optional)
+# #{fragment}    (optional)
+URL_REGEX = re.compile(
+    (
+        r"(?:(?P<scheme>{scheme}):)?"
+        r"(?://(?P<authority>{authority}))?"
+        r"(?P<path>{path})"
+        r"(?:\?(?P<query>{query}))?"
+        r"(?:#(?P<fragment>{fragment}))?"
+    ).format(
+        scheme="([a-zA-Z][a-zA-Z0-9+.-]*)?",
+        authority="[^/?#]*",
+        path="[^?#]*",
+        query="[^#]*",
+        fragment=".*",
+    )
+)
+
+# {userinfo}@    (optional)
+# {host}
+# :{port}        (optional)
+AUTHORITY_REGEX = re.compile(
+    (
+        r"(?:(?P<userinfo>{userinfo})@)?" r"(?P<host>{host})" r":?(?P<port>{port})?"
+    ).format(
+        userinfo=".*",  # Any character sequence.
+        host="(\\[.*\\]|[^:@]*)",  # Either any character sequence excluding ':' or '@',
+        # or an IPv6 address enclosed within square brackets.
+        port=".*",  # Any character sequence.
+    )
+)
+
+
+# If we call urlparse with an individual component, then we need to regex
+# validate that component individually.
+# Note that we're duplicating the same strings as above. Shock! Horror!!
+COMPONENT_REGEX = {
+    "scheme": re.compile("([a-zA-Z][a-zA-Z0-9+.-]*)?"),
+    "authority": re.compile("[^/?#]*"),
+    "path": re.compile("[^?#]*"),
+    "query": re.compile("[^#]*"),
+    "fragment": re.compile(".*"),
+    "userinfo": re.compile("[^@]*"),
+    "host": re.compile("(\\[.*\\]|[^:]*)"),
+    "port": re.compile(".*"),
+}
+
+
+# We use these simple regexs as a first pass before handing off to
+# the stdlib 'ipaddress' module for IP address validation.
+IPv4_STYLE_HOSTNAME = re.compile(r"^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$")
+IPv6_STYLE_HOSTNAME = re.compile(r"^\[.*\]$")
+
+
+class ParseResult(typing.NamedTuple):
+    scheme: str
+    userinfo: str
+    host: str
+    port: int | None
+    path: str
+    query: str | None
+    fragment: str | None
+
+    @property
+    def authority(self) -> str:
+        return "".join(
+            [
+                f"{self.userinfo}@" if self.userinfo else "",
+                f"[{self.host}]" if ":" in self.host else self.host,
+                f":{self.port}" if self.port is not None else "",
+            ]
+        )
+
+    @property
+    def netloc(self) -> str:
+        return "".join(
+            [
+                f"[{self.host}]" if ":" in self.host else self.host,
+                f":{self.port}" if self.port is not None else "",
+            ]
+        )
+
+    def copy_with(self, **kwargs: str | None) -> ParseResult:
+        if not kwargs:
+            return self
+
+        defaults = {
+            "scheme": self.scheme,
+            "authority": self.authority,
+            "path": self.path,
+            "query": self.query,
+            "fragment": self.fragment,
+        }
+        defaults.update(kwargs)
+        return urlparse("", **defaults)
+
+    def __str__(self) -> str:
+        authority = self.authority
+        return "".join(
+            [
+                f"{self.scheme}:" if self.scheme else "",
+                f"//{authority}" if authority else "",
+                self.path,
+                f"?{self.query}" if self.query is not None else "",
+                f"#{self.fragment}" if self.fragment is not None else "",
+            ]
+        )
+
+
+def urlparse(url: str = "", **kwargs: str | None) -> ParseResult:
+    # Initial basic checks on allowable URLs.
+    # ---------------------------------------
+
+    # Hard limit the maximum allowable URL length.
+    if len(url) > MAX_URL_LENGTH:
+        raise InvalidURL("URL too long")
+
+    # If a URL includes any ASCII control characters including \t, \r, \n,
+    # then treat it as invalid.
+    if any(char.isascii() and not char.isprintable() for char in url):
+        raise InvalidURL("Invalid non-printable ASCII character in URL")
+
+    # Some keyword arguments require special handling.
+    # ------------------------------------------------
+
+    # Coerce "port" to a string, if it is provided as an integer.
+    if "port" in kwargs:
+        port = kwargs["port"]
+        kwargs["port"] = str(port) if isinstance(port, int) else port
+
+    # Replace "netloc" with "host and "port".
+    if "netloc" in kwargs:
+        netloc = kwargs.pop("netloc") or ""
+        kwargs["host"], _, kwargs["port"] = netloc.partition(":")
+
+    # Replace "username" and/or "password" with "userinfo".
+    if "username" in kwargs or "password" in kwargs:
+        username = quote(kwargs.pop("username", "") or "")
+        password = quote(kwargs.pop("password", "") or "")
+        kwargs["userinfo"] = f"{username}:{password}" if password else username
+
+    # Replace "raw_path" with "path" and "query".
+    if "raw_path" in kwargs:
+        raw_path = kwargs.pop("raw_path") or ""
+        kwargs["path"], seperator, kwargs["query"] = raw_path.partition("?")
+        if not seperator:
+            kwargs["query"] = None
+
+    # Ensure that IPv6 "host" addresses are always escaped with "[...]".
+    if "host" in kwargs:
+        host = kwargs.get("host") or ""
+        if ":" in host and not (host.startswith("[") and host.endswith("]")):
+            kwargs["host"] = f"[{host}]"
+
+    # If any keyword arguments are provided, ensure they are valid.
+    # -------------------------------------------------------------
+
+    for key, value in kwargs.items():
+        if value is not None:
+            if len(value) > MAX_URL_LENGTH:
+                raise InvalidURL(f"URL component '{key}' too long")
+
+            # If a component includes any ASCII control characters including \t, \r, \n,
+            # then treat it as invalid.
+            if any(char.isascii() and not char.isprintable() for char in value):
+                raise InvalidURL(
+                    f"Invalid non-printable ASCII character in URL component '{key}'"
+                )
+
+            # Ensure that keyword arguments match as a valid regex.
+            if not COMPONENT_REGEX[key].fullmatch(value):
+                raise InvalidURL(f"Invalid URL component '{key}'")
+
+    # The URL_REGEX will always match, but may have empty components.
+    url_match = URL_REGEX.match(url)
+    assert url_match is not None
+    url_dict = url_match.groupdict()
+
+    # * 'scheme', 'authority', and 'path' may be empty strings.
+    # * 'query' may be 'None', indicating no trailing "?" portion.
+    #   Any string including the empty string, indicates a trailing "?".
+    # * 'fragment' may be 'None', indicating no trailing "#" portion.
+    #   Any string including the empty string, indicates a trailing "#".
+    scheme = kwargs.get("scheme", url_dict["scheme"]) or ""
+    authority = kwargs.get("authority", url_dict["authority"]) or ""
+    path = kwargs.get("path", url_dict["path"]) or ""
+    query = kwargs.get("query", url_dict["query"])
+    fragment = kwargs.get("fragment", url_dict["fragment"])
+
+    # The AUTHORITY_REGEX will always match, but may have empty components.
+    authority_match = AUTHORITY_REGEX.match(authority)
+    assert authority_match is not None
+    authority_dict = authority_match.groupdict()
+
+    # * 'userinfo' and 'host' may be empty strings.
+    # * 'port' may be 'None'.
+    userinfo = kwargs.get("userinfo", authority_dict["userinfo"]) or ""
+    host = kwargs.get("host", authority_dict["host"]) or ""
+    port = kwargs.get("port", authority_dict["port"])
+
+    # Normalize and validate each component.
+    # We end up with a parsed representation of the URL,
+    # with components that are plain ASCII bytestrings.
+    parsed_scheme: str = scheme.lower()
+    parsed_userinfo: str = quote(userinfo, safe=SUB_DELIMS + ":")
+    parsed_host: str = encode_host(host)
+    parsed_port: int | None = normalize_port(port, scheme)
+
+    has_scheme = parsed_scheme != ""
+    has_authority = (
+        parsed_userinfo != "" or parsed_host != "" or parsed_port is not None
+    )
+    validate_path(path, has_scheme=has_scheme, has_authority=has_authority)
+    if has_authority:
+        path = normalize_path(path)
+
+    # The GEN_DELIMS set is... : / ? # [ ] @
+    # These do not need to be percent-quoted unless they serve as delimiters for the
+    # specific component.
+
+    # For 'path' we need to drop ? and # from the GEN_DELIMS set.
+    parsed_path: str = quote(path, safe=SUB_DELIMS + ":/[]@")
+    # For 'query' we need to drop '#' from the GEN_DELIMS set.
+    parsed_query: str | None = (
+        None if query is None else quote(query, safe=SUB_DELIMS + ":/?[]@")
+    )
+    # For 'fragment' we can include all of the GEN_DELIMS set.
+    parsed_fragment: str | None = (
+        None if fragment is None else quote(fragment, safe=SUB_DELIMS + ":/?#[]@")
+    )
+
+    # The parsed ASCII bytestrings are our canonical form.
+    # All properties of the URL are derived from these.
+    return ParseResult(
+        parsed_scheme,
+        parsed_userinfo,
+        parsed_host,
+        parsed_port,
+        parsed_path,
+        parsed_query,
+        parsed_fragment,
+    )
+
+
+def encode_host(host: str) -> str:
+    if not host:
+        return ""
+
+    elif IPv4_STYLE_HOSTNAME.match(host):
+        # Validate IPv4 hostnames like #.#.#.#
+        #
+        # From https://datatracker.ietf.org/doc/html/rfc3986/#section-3.2.2
+        #
+        # IPv4address = dec-octet "." dec-octet "." dec-octet "." dec-octet
+        try:
+            ipaddress.IPv4Address(host)
+        except ipaddress.AddressValueError:
+            raise InvalidURL(f"Invalid IPv4 address: {host!r}")
+        return host
+
+    elif IPv6_STYLE_HOSTNAME.match(host):
+        # Validate IPv6 hostnames like [...]
+        #
+        # From https://datatracker.ietf.org/doc/html/rfc3986/#section-3.2.2
+        #
+        # "A host identified by an Internet Protocol literal address, version 6
+        # [RFC3513] or later, is distinguished by enclosing the IP literal
+        # within square brackets ("[" and "]").  This is the only place where
+        # square bracket characters are allowed in the URI syntax."
+        try:
+            ipaddress.IPv6Address(host[1:-1])
+        except ipaddress.AddressValueError:
+            raise InvalidURL(f"Invalid IPv6 address: {host!r}")
+        return host[1:-1]
+
+    elif host.isascii():
+        # Regular ASCII hostnames
+        #
+        # From https://datatracker.ietf.org/doc/html/rfc3986/#section-3.2.2
+        #
+        # reg-name    = *( unreserved / pct-encoded / sub-delims )
+        return quote(host.lower(), safe=SUB_DELIMS)
+
+    # IDNA hostnames
+    try:
+        return idna.encode(host.lower()).decode("ascii")
+    except idna.IDNAError:
+        raise InvalidURL(f"Invalid IDNA hostname: {host!r}")
+
+
+def normalize_port(port: str | int | None, scheme: str) -> int | None:
+    # From https://tools.ietf.org/html/rfc3986#section-3.2.3
+    #
+    # "A scheme may define a default port.  For example, the "http" scheme
+    # defines a default port of "80", corresponding to its reserved TCP
+    # port number.  The type of port designated by the port number (e.g.,
+    # TCP, UDP, SCTP) is defined by the URI scheme.  URI producers and
+    # normalizers should omit the port component and its ":" delimiter if
+    # port is empty or if its value would be the same as that of the
+    # scheme's default."
+    if port is None or port == "":
+        return None
+
+    try:
+        port_as_int = int(port)
+    except ValueError:
+        raise InvalidURL(f"Invalid port: {port!r}")
+
+    # See https://url.spec.whatwg.org/#url-miscellaneous
+    default_port = {"ftp": 21, "http": 80, "https": 443, "ws": 80, "wss": 443}.get(
+        scheme
+    )
+    if port_as_int == default_port:
+        return None
+    return port_as_int
+
+
+def validate_path(path: str, has_scheme: bool, has_authority: bool) -> None:
+    """
+    Path validation rules that depend on if the URL contains
+    a scheme or authority component.
+
+    See https://datatracker.ietf.org/doc/html/rfc3986.html#section-3.3
+    """
+    if has_authority:
+        # If a URI contains an authority component, then the path component
+        # must either be empty or begin with a slash ("/") character."
+        if path and not path.startswith("/"):
+            raise InvalidURL("For absolute URLs, path must be empty or begin with '/'")
+    else:
+        # If a URI does not contain an authority component, then the path cannot begin
+        # with two slash characters ("//").
+        if path.startswith("//"):
+            raise InvalidURL(
+                "URLs with no authority component cannot have a path starting with '//'"
+            )
+        # In addition, a URI reference (Section 4.1) may be a relative-path reference,
+        # in which case the first path segment cannot contain a colon (":") character.
+        if path.startswith(":") and not has_scheme:
+            raise InvalidURL(
+                "URLs with no scheme component cannot have a path starting with ':'"
+            )
+
+
+def normalize_path(path: str) -> str:
+    """
+    Drop "." and ".." segments from a URL path.
+
+    For example:
+
+        normalize_path("/path/./to/somewhere/..") == "/path/to"
+    """
+    # https://datatracker.ietf.org/doc/html/rfc3986#section-5.2.4
+    components = path.split("/")
+    output: list[str] = []
+    for component in components:
+        if component == ".":
+            pass
+        elif component == "..":
+            if output and output != [""]:
+                output.pop()
+        else:
+            output.append(component)
+    return "/".join(output)
+
+
+def percent_encode(char: str) -> str:
+    """
+    Replace a single character with the percent-encoded representation.
+
+    Characters outside the ASCII range are represented with their a percent-encoded
+    representation of their UTF-8 byte sequence.
+
+    For example:
+
+        percent_encode(" ") == "%20"
+    """
+    return "".join([f"%{byte:02x}" for byte in char.encode("utf-8")]).upper()
+
+
+def is_safe(string: str, safe: str = "/") -> bool:
+    """
+    Determine if a given string is already quote-safe.
+    """
+    NON_ESCAPED_CHARS = UNRESERVED_CHARACTERS + safe + "%"
+
+    # All characters must already be non-escaping or '%'
+    for char in string:
+        if char not in NON_ESCAPED_CHARS:
+            return False
+
+    return True
+
+
+def percent_encoded(string: str, safe: str = "/") -> str:
+    """
+    Use percent-encoding to quote a string.
+    """
+    if is_safe(string, safe=safe):
+        return string
+
+    NON_ESCAPED_CHARS = UNRESERVED_CHARACTERS + safe
+    return "".join(
+        [char if char in NON_ESCAPED_CHARS else percent_encode(char) for char in string]
+    )
+
+
+def quote(string: str, safe: str = "/") -> str:
+    """
+    Use percent-encoding to quote a string, omitting existing '%xx' escape sequences.
+
+    See: https://www.rfc-editor.org/rfc/rfc3986#section-2.1
+
+    * `string`: The string to be percent-escaped.
+    * `safe`: A string containing characters that may be treated as safe, and do not
+        need to be escaped. Unreserved characters are always treated as safe.
+        See: https://www.rfc-editor.org/rfc/rfc3986#section-2.3
+    """
+    parts = []
+    current_position = 0
+    for match in re.finditer(PERCENT_ENCODED_REGEX, string):
+        start_position, end_position = match.start(), match.end()
+        matched_text = match.group(0)
+        # Add any text up to the '%xx' escape sequence.
+        if start_position != current_position:
+            leading_text = string[current_position:start_position]
+            parts.append(percent_encoded(leading_text, safe=safe))
+
+        # Add the '%xx' escape sequence.
+        parts.append(matched_text)
+        current_position = end_position
+
+    # Add any text after the final '%xx' escape sequence.
+    if current_position != len(string):
+        trailing_text = string[current_position:]
+        parts.append(percent_encoded(trailing_text, safe=safe))
+
+    return "".join(parts)
+
+
+def urlencode(items: list[tuple[str, str]]) -> str:
+    """
+    We can use a much simpler version of the stdlib urlencode here because
+    we don't need to handle a bunch of different typing cases, such as bytes vs str.
+
+    https://github.com/python/cpython/blob/b2f7b2ef0b5421e01efb8c7bee2ef95d3bab77eb/Lib/urllib/parse.py#L926
+
+    Note that we use '%20' encoding for spaces. and '%2F  for '/'.
+    This is slightly different than `requests`, but is the behaviour that browsers use.
+
+    See
+    - https://github.com/encode/httpx/issues/2536
+    - https://github.com/encode/httpx/issues/2721
+    - https://docs.python.org/3/library/urllib.parse.html#urllib.parse.urlencode
+    """
+    return "&".join(
+        [
+            percent_encoded(k, safe="") + "=" + percent_encoded(v, safe="")
+            for k, v in items
+        ]
+    )
diff --git a/llm/Lib/site-packages/httpx/_urls.py b/llm/Lib/site-packages/httpx/_urls.py
new file mode 100644
index 0000000000000000000000000000000000000000..43dedd5644c6aef93004f0e2c82bd2576792109b
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_urls.py
@@ -0,0 +1,646 @@
+from __future__ import annotations
+
+import typing
+from urllib.parse import parse_qs, unquote
+
+import idna
+
+from ._types import QueryParamTypes, RawURL, URLTypes
+from ._urlparse import urlencode, urlparse
+from ._utils import primitive_value_to_str
+
+
+class URL:
+    """
+    url = httpx.URL("HTTPS://jo%40email.com:a%20secret@müller.de:1234/pa%20th?search=ab#anchorlink")
+
+    assert url.scheme == "https"
+    assert url.username == "jo@email.com"
+    assert url.password == "a secret"
+    assert url.userinfo == b"jo%40email.com:a%20secret"
+    assert url.host == "müller.de"
+    assert url.raw_host == b"xn--mller-kva.de"
+    assert url.port == 1234
+    assert url.netloc == b"xn--mller-kva.de:1234"
+    assert url.path == "/pa th"
+    assert url.query == b"?search=ab"
+    assert url.raw_path == b"/pa%20th?search=ab"
+    assert url.fragment == "anchorlink"
+
+    The components of a URL are broken down like this:
+
+       https://jo%40email.com:a%20secret@müller.de:1234/pa%20th?search=ab#anchorlink
+    [scheme]   [  username  ] [password] [ host ][port][ path ] [ query ] [fragment]
+               [       userinfo        ] [   netloc   ][    raw_path    ]
+
+    Note that:
+
+    * `url.scheme` is normalized to always be lowercased.
+
+    * `url.host` is normalized to always be lowercased. Internationalized domain
+      names are represented in unicode, without IDNA encoding applied. For instance:
+
+      url = httpx.URL("http://中国.icom.museum")
+      assert url.host == "中国.icom.museum"
+      url = httpx.URL("http://xn--fiqs8s.icom.museum")
+      assert url.host == "中国.icom.museum"
+
+    * `url.raw_host` is normalized to always be lowercased, and is IDNA encoded.
+
+      url = httpx.URL("http://中国.icom.museum")
+      assert url.raw_host == b"xn--fiqs8s.icom.museum"
+      url = httpx.URL("http://xn--fiqs8s.icom.museum")
+      assert url.raw_host == b"xn--fiqs8s.icom.museum"
+
+    * `url.port` is either None or an integer. URLs that include the default port for
+      "http", "https", "ws", "wss", and "ftp" schemes have their port
+      normalized to `None`.
+
+      assert httpx.URL("http://example.com") == httpx.URL("http://example.com:80")
+      assert httpx.URL("http://example.com").port is None
+      assert httpx.URL("http://example.com:80").port is None
+
+    * `url.userinfo` is raw bytes, without URL escaping. Usually you'll want to work
+      with `url.username` and `url.password` instead, which handle the URL escaping.
+
+    * `url.raw_path` is raw bytes of both the path and query, without URL escaping.
+      This portion is used as the target when constructing HTTP requests. Usually you'll
+      want to work with `url.path` instead.
+
+    * `url.query` is raw bytes, without URL escaping. A URL query string portion can
+      only be properly URL escaped when decoding the parameter names and values
+      themselves.
+    """
+
+    def __init__(self, url: URL | str = "", **kwargs: typing.Any) -> None:
+        if kwargs:
+            allowed = {
+                "scheme": str,
+                "username": str,
+                "password": str,
+                "userinfo": bytes,
+                "host": str,
+                "port": int,
+                "netloc": bytes,
+                "path": str,
+                "query": bytes,
+                "raw_path": bytes,
+                "fragment": str,
+                "params": object,
+            }
+
+            # Perform type checking for all supported keyword arguments.
+            for key, value in kwargs.items():
+                if key not in allowed:
+                    message = f"{key!r} is an invalid keyword argument for URL()"
+                    raise TypeError(message)
+                if value is not None and not isinstance(value, allowed[key]):
+                    expected = allowed[key].__name__
+                    seen = type(value).__name__
+                    message = f"Argument {key!r} must be {expected} but got {seen}"
+                    raise TypeError(message)
+                if isinstance(value, bytes):
+                    kwargs[key] = value.decode("ascii")
+
+            if "params" in kwargs:
+                # Replace any "params" keyword with the raw "query" instead.
+                #
+                # Ensure that empty params use `kwargs["query"] = None` rather
+                # than `kwargs["query"] = ""`, so that generated URLs do not
+                # include an empty trailing "?".
+                params = kwargs.pop("params")
+                kwargs["query"] = None if not params else str(QueryParams(params))
+
+        if isinstance(url, str):
+            self._uri_reference = urlparse(url, **kwargs)
+        elif isinstance(url, URL):
+            self._uri_reference = url._uri_reference.copy_with(**kwargs)
+        else:
+            raise TypeError(
+                "Invalid type for url.  Expected str or httpx.URL,"
+                f" got {type(url)}: {url!r}"
+            )
+
+    @property
+    def scheme(self) -> str:
+        """
+        The URL scheme, such as "http", "https".
+        Always normalised to lowercase.
+        """
+        return self._uri_reference.scheme
+
+    @property
+    def raw_scheme(self) -> bytes:
+        """
+        The raw bytes representation of the URL scheme, such as b"http", b"https".
+        Always normalised to lowercase.
+        """
+        return self._uri_reference.scheme.encode("ascii")
+
+    @property
+    def userinfo(self) -> bytes:
+        """
+        The URL userinfo as a raw bytestring.
+        For example: b"jo%40email.com:a%20secret".
+        """
+        return self._uri_reference.userinfo.encode("ascii")
+
+    @property
+    def username(self) -> str:
+        """
+        The URL username as a string, with URL decoding applied.
+        For example: "jo@email.com"
+        """
+        userinfo = self._uri_reference.userinfo
+        return unquote(userinfo.partition(":")[0])
+
+    @property
+    def password(self) -> str:
+        """
+        The URL password as a string, with URL decoding applied.
+        For example: "a secret"
+        """
+        userinfo = self._uri_reference.userinfo
+        return unquote(userinfo.partition(":")[2])
+
+    @property
+    def host(self) -> str:
+        """
+        The URL host as a string.
+        Always normalized to lowercase, with IDNA hosts decoded into unicode.
+
+        Examples:
+
+        url = httpx.URL("http://www.EXAMPLE.org")
+        assert url.host == "www.example.org"
+
+        url = httpx.URL("http://中国.icom.museum")
+        assert url.host == "中国.icom.museum"
+
+        url = httpx.URL("http://xn--fiqs8s.icom.museum")
+        assert url.host == "中国.icom.museum"
+
+        url = httpx.URL("https://[::ffff:192.168.0.1]")
+        assert url.host == "::ffff:192.168.0.1"
+        """
+        host: str = self._uri_reference.host
+
+        if host.startswith("xn--"):
+            host = idna.decode(host)
+
+        return host
+
+    @property
+    def raw_host(self) -> bytes:
+        """
+        The raw bytes representation of the URL host.
+        Always normalized to lowercase, and IDNA encoded.
+
+        Examples:
+
+        url = httpx.URL("http://www.EXAMPLE.org")
+        assert url.raw_host == b"www.example.org"
+
+        url = httpx.URL("http://中国.icom.museum")
+        assert url.raw_host == b"xn--fiqs8s.icom.museum"
+
+        url = httpx.URL("http://xn--fiqs8s.icom.museum")
+        assert url.raw_host == b"xn--fiqs8s.icom.museum"
+
+        url = httpx.URL("https://[::ffff:192.168.0.1]")
+        assert url.raw_host == b"::ffff:192.168.0.1"
+        """
+        return self._uri_reference.host.encode("ascii")
+
+    @property
+    def port(self) -> int | None:
+        """
+        The URL port as an integer.
+
+        Note that the URL class performs port normalization as per the WHATWG spec.
+        Default ports for "http", "https", "ws", "wss", and "ftp" schemes are always
+        treated as `None`.
+
+        For example:
+
+        assert httpx.URL("http://www.example.com") == httpx.URL("http://www.example.com:80")
+        assert httpx.URL("http://www.example.com:80").port is None
+        """
+        return self._uri_reference.port
+
+    @property
+    def netloc(self) -> bytes:
+        """
+        Either `<host>` or `<host>:<port>` as bytes.
+        Always normalized to lowercase, and IDNA encoded.
+
+        This property may be used for generating the value of a request
+        "Host" header.
+        """
+        return self._uri_reference.netloc.encode("ascii")
+
+    @property
+    def path(self) -> str:
+        """
+        The URL path as a string. Excluding the query string, and URL decoded.
+
+        For example:
+
+        url = httpx.URL("https://example.com/pa%20th")
+        assert url.path == "/pa th"
+        """
+        path = self._uri_reference.path or "/"
+        return unquote(path)
+
+    @property
+    def query(self) -> bytes:
+        """
+        The URL query string, as raw bytes, excluding the leading b"?".
+
+        This is necessarily a bytewise interface, because we cannot
+        perform URL decoding of this representation until we've parsed
+        the keys and values into a QueryParams instance.
+
+        For example:
+
+        url = httpx.URL("https://example.com/?filter=some%20search%20terms")
+        assert url.query == b"filter=some%20search%20terms"
+        """
+        query = self._uri_reference.query or ""
+        return query.encode("ascii")
+
+    @property
+    def params(self) -> QueryParams:
+        """
+        The URL query parameters, neatly parsed and packaged into an immutable
+        multidict representation.
+        """
+        return QueryParams(self._uri_reference.query)
+
+    @property
+    def raw_path(self) -> bytes:
+        """
+        The complete URL path and query string as raw bytes.
+        Used as the target when constructing HTTP requests.
+
+        For example:
+
+        GET /users?search=some%20text HTTP/1.1
+        Host: www.example.org
+        Connection: close
+        """
+        path = self._uri_reference.path or "/"
+        if self._uri_reference.query is not None:
+            path += "?" + self._uri_reference.query
+        return path.encode("ascii")
+
+    @property
+    def fragment(self) -> str:
+        """
+        The URL fragments, as used in HTML anchors.
+        As a string, without the leading '#'.
+        """
+        return unquote(self._uri_reference.fragment or "")
+
+    @property
+    def raw(self) -> RawURL:
+        """
+        Provides the (scheme, host, port, target) for the outgoing request.
+
+        In older versions of `httpx` this was used in the low-level transport API.
+        We no longer use `RawURL`, and this property will be deprecated
+        in a future release.
+        """
+        return RawURL(
+            self.raw_scheme,
+            self.raw_host,
+            self.port,
+            self.raw_path,
+        )
+
+    @property
+    def is_absolute_url(self) -> bool:
+        """
+        Return `True` for absolute URLs such as 'http://example.com/path',
+        and `False` for relative URLs such as '/path'.
+        """
+        # We don't use `.is_absolute` from `rfc3986` because it treats
+        # URLs with a fragment portion as not absolute.
+        # What we actually care about is if the URL provides
+        # a scheme and hostname to which connections should be made.
+        return bool(self._uri_reference.scheme and self._uri_reference.host)
+
+    @property
+    def is_relative_url(self) -> bool:
+        """
+        Return `False` for absolute URLs such as 'http://example.com/path',
+        and `True` for relative URLs such as '/path'.
+        """
+        return not self.is_absolute_url
+
+    def copy_with(self, **kwargs: typing.Any) -> URL:
+        """
+        Copy this URL, returning a new URL with some components altered.
+        Accepts the same set of parameters as the components that are made
+        available via properties on the `URL` class.
+
+        For example:
+
+        url = httpx.URL("https://www.example.com").copy_with(
+            username="jo@gmail.com", password="a secret"
+        )
+        assert url == "https://jo%40email.com:a%20secret@www.example.com"
+        """
+        return URL(self, **kwargs)
+
+    def copy_set_param(self, key: str, value: typing.Any = None) -> URL:
+        return self.copy_with(params=self.params.set(key, value))
+
+    def copy_add_param(self, key: str, value: typing.Any = None) -> URL:
+        return self.copy_with(params=self.params.add(key, value))
+
+    def copy_remove_param(self, key: str) -> URL:
+        return self.copy_with(params=self.params.remove(key))
+
+    def copy_merge_params(self, params: QueryParamTypes) -> URL:
+        return self.copy_with(params=self.params.merge(params))
+
+    def join(self, url: URLTypes) -> URL:
+        """
+        Return an absolute URL, using this URL as the base.
+
+        Eg.
+
+        url = httpx.URL("https://www.example.com/test")
+        url = url.join("/new/path")
+        assert url == "https://www.example.com/new/path"
+        """
+        from urllib.parse import urljoin
+
+        return URL(urljoin(str(self), str(URL(url))))
+
+    def __hash__(self) -> int:
+        return hash(str(self))
+
+    def __eq__(self, other: typing.Any) -> bool:
+        return isinstance(other, (URL, str)) and str(self) == str(URL(other))
+
+    def __str__(self) -> str:
+        return str(self._uri_reference)
+
+    def __repr__(self) -> str:
+        scheme, userinfo, host, port, path, query, fragment = self._uri_reference
+
+        if ":" in userinfo:
+            # Mask any password component.
+            userinfo = f'{userinfo.split(":")[0]}:[secure]'
+
+        authority = "".join(
+            [
+                f"{userinfo}@" if userinfo else "",
+                f"[{host}]" if ":" in host else host,
+                f":{port}" if port is not None else "",
+            ]
+        )
+        url = "".join(
+            [
+                f"{self.scheme}:" if scheme else "",
+                f"//{authority}" if authority else "",
+                path,
+                f"?{query}" if query is not None else "",
+                f"#{fragment}" if fragment is not None else "",
+            ]
+        )
+
+        return f"{self.__class__.__name__}({url!r})"
+
+
+class QueryParams(typing.Mapping[str, str]):
+    """
+    URL query parameters, as a multi-dict.
+    """
+
+    def __init__(self, *args: QueryParamTypes | None, **kwargs: typing.Any) -> None:
+        assert len(args) < 2, "Too many arguments."
+        assert not (args and kwargs), "Cannot mix named and unnamed arguments."
+
+        value = args[0] if args else kwargs
+
+        if value is None or isinstance(value, (str, bytes)):
+            value = value.decode("ascii") if isinstance(value, bytes) else value
+            self._dict = parse_qs(value, keep_blank_values=True)
+        elif isinstance(value, QueryParams):
+            self._dict = {k: list(v) for k, v in value._dict.items()}
+        else:
+            dict_value: dict[typing.Any, list[typing.Any]] = {}
+            if isinstance(value, (list, tuple)):
+                # Convert list inputs like:
+                #     [("a", "123"), ("a", "456"), ("b", "789")]
+                # To a dict representation, like:
+                #     {"a": ["123", "456"], "b": ["789"]}
+                for item in value:
+                    dict_value.setdefault(item[0], []).append(item[1])
+            else:
+                # Convert dict inputs like:
+                #    {"a": "123", "b": ["456", "789"]}
+                # To dict inputs where values are always lists, like:
+                #    {"a": ["123"], "b": ["456", "789"]}
+                dict_value = {
+                    k: list(v) if isinstance(v, (list, tuple)) else [v]
+                    for k, v in value.items()
+                }
+
+            # Ensure that keys and values are neatly coerced to strings.
+            # We coerce values `True` and `False` to JSON-like "true" and "false"
+            # representations, and coerce `None` values to the empty string.
+            self._dict = {
+                str(k): [primitive_value_to_str(item) for item in v]
+                for k, v in dict_value.items()
+            }
+
+    def keys(self) -> typing.KeysView[str]:
+        """
+        Return all the keys in the query params.
+
+        Usage:
+
+        q = httpx.QueryParams("a=123&a=456&b=789")
+        assert list(q.keys()) == ["a", "b"]
+        """
+        return self._dict.keys()
+
+    def values(self) -> typing.ValuesView[str]:
+        """
+        Return all the values in the query params. If a key occurs more than once
+        only the first item for that key is returned.
+
+        Usage:
+
+        q = httpx.QueryParams("a=123&a=456&b=789")
+        assert list(q.values()) == ["123", "789"]
+        """
+        return {k: v[0] for k, v in self._dict.items()}.values()
+
+    def items(self) -> typing.ItemsView[str, str]:
+        """
+        Return all items in the query params. If a key occurs more than once
+        only the first item for that key is returned.
+
+        Usage:
+
+        q = httpx.QueryParams("a=123&a=456&b=789")
+        assert list(q.items()) == [("a", "123"), ("b", "789")]
+        """
+        return {k: v[0] for k, v in self._dict.items()}.items()
+
+    def multi_items(self) -> list[tuple[str, str]]:
+        """
+        Return all items in the query params. Allow duplicate keys to occur.
+
+        Usage:
+
+        q = httpx.QueryParams("a=123&a=456&b=789")
+        assert list(q.multi_items()) == [("a", "123"), ("a", "456"), ("b", "789")]
+        """
+        multi_items: list[tuple[str, str]] = []
+        for k, v in self._dict.items():
+            multi_items.extend([(k, i) for i in v])
+        return multi_items
+
+    def get(self, key: typing.Any, default: typing.Any = None) -> typing.Any:
+        """
+        Get a value from the query param for a given key. If the key occurs
+        more than once, then only the first value is returned.
+
+        Usage:
+
+        q = httpx.QueryParams("a=123&a=456&b=789")
+        assert q.get("a") == "123"
+        """
+        if key in self._dict:
+            return self._dict[str(key)][0]
+        return default
+
+    def get_list(self, key: str) -> list[str]:
+        """
+        Get all values from the query param for a given key.
+
+        Usage:
+
+        q = httpx.QueryParams("a=123&a=456&b=789")
+        assert q.get_list("a") == ["123", "456"]
+        """
+        return list(self._dict.get(str(key), []))
+
+    def set(self, key: str, value: typing.Any = None) -> QueryParams:
+        """
+        Return a new QueryParams instance, setting the value of a key.
+
+        Usage:
+
+        q = httpx.QueryParams("a=123")
+        q = q.set("a", "456")
+        assert q == httpx.QueryParams("a=456")
+        """
+        q = QueryParams()
+        q._dict = dict(self._dict)
+        q._dict[str(key)] = [primitive_value_to_str(value)]
+        return q
+
+    def add(self, key: str, value: typing.Any = None) -> QueryParams:
+        """
+        Return a new QueryParams instance, setting or appending the value of a key.
+
+        Usage:
+
+        q = httpx.QueryParams("a=123")
+        q = q.add("a", "456")
+        assert q == httpx.QueryParams("a=123&a=456")
+        """
+        q = QueryParams()
+        q._dict = dict(self._dict)
+        q._dict[str(key)] = q.get_list(key) + [primitive_value_to_str(value)]
+        return q
+
+    def remove(self, key: str) -> QueryParams:
+        """
+        Return a new QueryParams instance, removing the value of a key.
+
+        Usage:
+
+        q = httpx.QueryParams("a=123")
+        q = q.remove("a")
+        assert q == httpx.QueryParams("")
+        """
+        q = QueryParams()
+        q._dict = dict(self._dict)
+        q._dict.pop(str(key), None)
+        return q
+
+    def merge(self, params: QueryParamTypes | None = None) -> QueryParams:
+        """
+        Return a new QueryParams instance, updated with.
+
+        Usage:
+
+        q = httpx.QueryParams("a=123")
+        q = q.merge({"b": "456"})
+        assert q == httpx.QueryParams("a=123&b=456")
+
+        q = httpx.QueryParams("a=123")
+        q = q.merge({"a": "456", "b": "789"})
+        assert q == httpx.QueryParams("a=456&b=789")
+        """
+        q = QueryParams(params)
+        q._dict = {**self._dict, **q._dict}
+        return q
+
+    def __getitem__(self, key: typing.Any) -> str:
+        return self._dict[key][0]
+
+    def __contains__(self, key: typing.Any) -> bool:
+        return key in self._dict
+
+    def __iter__(self) -> typing.Iterator[typing.Any]:
+        return iter(self.keys())
+
+    def __len__(self) -> int:
+        return len(self._dict)
+
+    def __bool__(self) -> bool:
+        return bool(self._dict)
+
+    def __hash__(self) -> int:
+        return hash(str(self))
+
+    def __eq__(self, other: typing.Any) -> bool:
+        if not isinstance(other, self.__class__):
+            return False
+        return sorted(self.multi_items()) == sorted(other.multi_items())
+
+    def __str__(self) -> str:
+        """
+        Note that we use '%20' encoding for spaces, and treat '/' as a safe
+        character.
+
+        See https://github.com/encode/httpx/issues/2536 and
+        https://docs.python.org/3/library/urllib.parse.html#urllib.parse.urlencode
+        """
+        return urlencode(self.multi_items())
+
+    def __repr__(self) -> str:
+        class_name = self.__class__.__name__
+        query_string = str(self)
+        return f"{class_name}({query_string!r})"
+
+    def update(self, params: QueryParamTypes | None = None) -> None:
+        raise RuntimeError(
+            "QueryParams are immutable since 0.18.0. "
+            "Use `q = q.merge(...)` to create an updated copy."
+        )
+
+    def __setitem__(self, key: str, value: str) -> None:
+        raise RuntimeError(
+            "QueryParams are immutable since 0.18.0. "
+            "Use `q = q.set(key, value)` to create an updated copy."
+        )
diff --git a/llm/Lib/site-packages/httpx/_utils.py b/llm/Lib/site-packages/httpx/_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9ece1943878d0182d87ca77569fe3bf47e3bba8
--- /dev/null
+++ b/llm/Lib/site-packages/httpx/_utils.py
@@ -0,0 +1,440 @@
+from __future__ import annotations
+
+import codecs
+import email.message
+import ipaddress
+import mimetypes
+import os
+import re
+import time
+import typing
+from pathlib import Path
+from urllib.request import getproxies
+
+import sniffio
+
+from ._types import PrimitiveData
+
+if typing.TYPE_CHECKING:  # pragma: no cover
+    from ._urls import URL
+
+
+_HTML5_FORM_ENCODING_REPLACEMENTS = {'"': "%22", "\\": "\\\\"}
+_HTML5_FORM_ENCODING_REPLACEMENTS.update(
+    {chr(c): "%{:02X}".format(c) for c in range(0x1F + 1) if c != 0x1B}
+)
+_HTML5_FORM_ENCODING_RE = re.compile(
+    r"|".join([re.escape(c) for c in _HTML5_FORM_ENCODING_REPLACEMENTS.keys()])
+)
+
+
+def normalize_header_key(
+    value: str | bytes,
+    lower: bool,
+    encoding: str | None = None,
+) -> bytes:
+    """
+    Coerce str/bytes into a strictly byte-wise HTTP header key.
+    """
+    if isinstance(value, bytes):
+        bytes_value = value
+    else:
+        bytes_value = value.encode(encoding or "ascii")
+
+    return bytes_value.lower() if lower else bytes_value
+
+
+def normalize_header_value(value: str | bytes, encoding: str | None = None) -> bytes:
+    """
+    Coerce str/bytes into a strictly byte-wise HTTP header value.
+    """
+    if isinstance(value, bytes):
+        return value
+    return value.encode(encoding or "ascii")
+
+
+def primitive_value_to_str(value: PrimitiveData) -> str:
+    """
+    Coerce a primitive data type into a string value.
+
+    Note that we prefer JSON-style 'true'/'false' for boolean values here.
+    """
+    if value is True:
+        return "true"
+    elif value is False:
+        return "false"
+    elif value is None:
+        return ""
+    return str(value)
+
+
+def is_known_encoding(encoding: str) -> bool:
+    """
+    Return `True` if `encoding` is a known codec.
+    """
+    try:
+        codecs.lookup(encoding)
+    except LookupError:
+        return False
+    return True
+
+
+def format_form_param(name: str, value: str) -> bytes:
+    """
+    Encode a name/value pair within a multipart form.
+    """
+
+    def replacer(match: typing.Match[str]) -> str:
+        return _HTML5_FORM_ENCODING_REPLACEMENTS[match.group(0)]
+
+    value = _HTML5_FORM_ENCODING_RE.sub(replacer, value)
+    return f'{name}="{value}"'.encode()
+
+
+def get_ca_bundle_from_env() -> str | None:
+    if "SSL_CERT_FILE" in os.environ:
+        ssl_file = Path(os.environ["SSL_CERT_FILE"])
+        if ssl_file.is_file():
+            return str(ssl_file)
+    if "SSL_CERT_DIR" in os.environ:
+        ssl_path = Path(os.environ["SSL_CERT_DIR"])
+        if ssl_path.is_dir():
+            return str(ssl_path)
+    return None
+
+
+def parse_header_links(value: str) -> list[dict[str, str]]:
+    """
+    Returns a list of parsed link headers, for more info see:
+    https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Link
+    The generic syntax of those is:
+    Link: < uri-reference >; param1=value1; param2="value2"
+    So for instance:
+    Link; '<http:/.../front.jpeg>; type="image/jpeg",<http://.../back.jpeg>;'
+    would return
+        [
+            {"url": "http:/.../front.jpeg", "type": "image/jpeg"},
+            {"url": "http://.../back.jpeg"},
+        ]
+    :param value: HTTP Link entity-header field
+    :return: list of parsed link headers
+    """
+    links: list[dict[str, str]] = []
+    replace_chars = " '\""
+    value = value.strip(replace_chars)
+    if not value:
+        return links
+    for val in re.split(", *<", value):
+        try:
+            url, params = val.split(";", 1)
+        except ValueError:
+            url, params = val, ""
+        link = {"url": url.strip("<> '\"")}
+        for param in params.split(";"):
+            try:
+                key, value = param.split("=")
+            except ValueError:
+                break
+            link[key.strip(replace_chars)] = value.strip(replace_chars)
+        links.append(link)
+    return links
+
+
+def parse_content_type_charset(content_type: str) -> str | None:
+    # We used to use `cgi.parse_header()` here, but `cgi` became a dead battery.
+    # See: https://peps.python.org/pep-0594/#cgi
+    msg = email.message.Message()
+    msg["content-type"] = content_type
+    return msg.get_content_charset(failobj=None)
+
+
+SENSITIVE_HEADERS = {"authorization", "proxy-authorization"}
+
+
+def obfuscate_sensitive_headers(
+    items: typing.Iterable[tuple[typing.AnyStr, typing.AnyStr]],
+) -> typing.Iterator[tuple[typing.AnyStr, typing.AnyStr]]:
+    for k, v in items:
+        if to_str(k.lower()) in SENSITIVE_HEADERS:
+            v = to_bytes_or_str("[secure]", match_type_of=v)
+        yield k, v
+
+
+def port_or_default(url: URL) -> int | None:
+    if url.port is not None:
+        return url.port
+    return {"http": 80, "https": 443}.get(url.scheme)
+
+
+def same_origin(url: URL, other: URL) -> bool:
+    """
+    Return 'True' if the given URLs share the same origin.
+    """
+    return (
+        url.scheme == other.scheme
+        and url.host == other.host
+        and port_or_default(url) == port_or_default(other)
+    )
+
+
+def is_https_redirect(url: URL, location: URL) -> bool:
+    """
+    Return 'True' if 'location' is a HTTPS upgrade of 'url'
+    """
+    if url.host != location.host:
+        return False
+
+    return (
+        url.scheme == "http"
+        and port_or_default(url) == 80
+        and location.scheme == "https"
+        and port_or_default(location) == 443
+    )
+
+
+def get_environment_proxies() -> dict[str, str | None]:
+    """Gets proxy information from the environment"""
+
+    # urllib.request.getproxies() falls back on System
+    # Registry and Config for proxies on Windows and macOS.
+    # We don't want to propagate non-HTTP proxies into
+    # our configuration such as 'TRAVIS_APT_PROXY'.
+    proxy_info = getproxies()
+    mounts: dict[str, str | None] = {}
+
+    for scheme in ("http", "https", "all"):
+        if proxy_info.get(scheme):
+            hostname = proxy_info[scheme]
+            mounts[f"{scheme}://"] = (
+                hostname if "://" in hostname else f"http://{hostname}"
+            )
+
+    no_proxy_hosts = [host.strip() for host in proxy_info.get("no", "").split(",")]
+    for hostname in no_proxy_hosts:
+        # See https://curl.haxx.se/libcurl/c/CURLOPT_NOPROXY.html for details
+        # on how names in `NO_PROXY` are handled.
+        if hostname == "*":
+            # If NO_PROXY=* is used or if "*" occurs as any one of the comma
+            # separated hostnames, then we should just bypass any information
+            # from HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, and always ignore
+            # proxies.
+            return {}
+        elif hostname:
+            # NO_PROXY=.google.com is marked as "all://*.google.com,
+            #   which disables "www.google.com" but not "google.com"
+            # NO_PROXY=google.com is marked as "all://*google.com,
+            #   which disables "www.google.com" and "google.com".
+            #   (But not "wwwgoogle.com")
+            # NO_PROXY can include domains, IPv6, IPv4 addresses and "localhost"
+            #   NO_PROXY=example.com,::1,localhost,192.168.0.0/16
+            if "://" in hostname:
+                mounts[hostname] = None
+            elif is_ipv4_hostname(hostname):
+                mounts[f"all://{hostname}"] = None
+            elif is_ipv6_hostname(hostname):
+                mounts[f"all://[{hostname}]"] = None
+            elif hostname.lower() == "localhost":
+                mounts[f"all://{hostname}"] = None
+            else:
+                mounts[f"all://*{hostname}"] = None
+
+    return mounts
+
+
+def to_bytes(value: str | bytes, encoding: str = "utf-8") -> bytes:
+    return value.encode(encoding) if isinstance(value, str) else value
+
+
+def to_str(value: str | bytes, encoding: str = "utf-8") -> str:
+    return value if isinstance(value, str) else value.decode(encoding)
+
+
+def to_bytes_or_str(value: str, match_type_of: typing.AnyStr) -> typing.AnyStr:
+    return value if isinstance(match_type_of, str) else value.encode()
+
+
+def unquote(value: str) -> str:
+    return value[1:-1] if value[0] == value[-1] == '"' else value
+
+
+def guess_content_type(filename: str | None) -> str | None:
+    if filename:
+        return mimetypes.guess_type(filename)[0] or "application/octet-stream"
+    return None
+
+
+def peek_filelike_length(stream: typing.Any) -> int | None:
+    """
+    Given a file-like stream object, return its length in number of bytes
+    without reading it into memory.
+    """
+    try:
+        # Is it an actual file?
+        fd = stream.fileno()
+        # Yup, seems to be an actual file.
+        length = os.fstat(fd).st_size
+    except (AttributeError, OSError):
+        # No... Maybe it's something that supports random access, like `io.BytesIO`?
+        try:
+            # Assuming so, go to end of stream to figure out its length,
+            # then put it back in place.
+            offset = stream.tell()
+            length = stream.seek(0, os.SEEK_END)
+            stream.seek(offset)
+        except (AttributeError, OSError):
+            # Not even that? Sorry, we're doomed...
+            return None
+
+    return length
+
+
+class Timer:
+    async def _get_time(self) -> float:
+        library = sniffio.current_async_library()
+        if library == "trio":
+            import trio
+
+            return trio.current_time()
+        else:
+            import asyncio
+
+            return asyncio.get_event_loop().time()
+
+    def sync_start(self) -> None:
+        self.started = time.perf_counter()
+
+    async def async_start(self) -> None:
+        self.started = await self._get_time()
+
+    def sync_elapsed(self) -> float:
+        now = time.perf_counter()
+        return now - self.started
+
+    async def async_elapsed(self) -> float:
+        now = await self._get_time()
+        return now - self.started
+
+
+class URLPattern:
+    """
+    A utility class currently used for making lookups against proxy keys...
+
+    # Wildcard matching...
+    >>> pattern = URLPattern("all://")
+    >>> pattern.matches(httpx.URL("http://example.com"))
+    True
+
+    # Witch scheme matching...
+    >>> pattern = URLPattern("https://")
+    >>> pattern.matches(httpx.URL("https://example.com"))
+    True
+    >>> pattern.matches(httpx.URL("http://example.com"))
+    False
+
+    # With domain matching...
+    >>> pattern = URLPattern("https://example.com")
+    >>> pattern.matches(httpx.URL("https://example.com"))
+    True
+    >>> pattern.matches(httpx.URL("http://example.com"))
+    False
+    >>> pattern.matches(httpx.URL("https://other.com"))
+    False
+
+    # Wildcard scheme, with domain matching...
+    >>> pattern = URLPattern("all://example.com")
+    >>> pattern.matches(httpx.URL("https://example.com"))
+    True
+    >>> pattern.matches(httpx.URL("http://example.com"))
+    True
+    >>> pattern.matches(httpx.URL("https://other.com"))
+    False
+
+    # With port matching...
+    >>> pattern = URLPattern("https://example.com:1234")
+    >>> pattern.matches(httpx.URL("https://example.com:1234"))
+    True
+    >>> pattern.matches(httpx.URL("https://example.com"))
+    False
+    """
+
+    def __init__(self, pattern: str) -> None:
+        from ._urls import URL
+
+        if pattern and ":" not in pattern:
+            raise ValueError(
+                f"Proxy keys should use proper URL forms rather "
+                f"than plain scheme strings. "
+                f'Instead of "{pattern}", use "{pattern}://"'
+            )
+
+        url = URL(pattern)
+        self.pattern = pattern
+        self.scheme = "" if url.scheme == "all" else url.scheme
+        self.host = "" if url.host == "*" else url.host
+        self.port = url.port
+        if not url.host or url.host == "*":
+            self.host_regex: typing.Pattern[str] | None = None
+        elif url.host.startswith("*."):
+            # *.example.com should match "www.example.com", but not "example.com"
+            domain = re.escape(url.host[2:])
+            self.host_regex = re.compile(f"^.+\\.{domain}$")
+        elif url.host.startswith("*"):
+            # *example.com should match "www.example.com" and "example.com"
+            domain = re.escape(url.host[1:])
+            self.host_regex = re.compile(f"^(.+\\.)?{domain}$")
+        else:
+            # example.com should match "example.com" but not "www.example.com"
+            domain = re.escape(url.host)
+            self.host_regex = re.compile(f"^{domain}$")
+
+    def matches(self, other: URL) -> bool:
+        if self.scheme and self.scheme != other.scheme:
+            return False
+        if (
+            self.host
+            and self.host_regex is not None
+            and not self.host_regex.match(other.host)
+        ):
+            return False
+        if self.port is not None and self.port != other.port:
+            return False
+        return True
+
+    @property
+    def priority(self) -> tuple[int, int, int]:
+        """
+        The priority allows URLPattern instances to be sortable, so that
+        we can match from most specific to least specific.
+        """
+        # URLs with a port should take priority over URLs without a port.
+        port_priority = 0 if self.port is not None else 1
+        # Longer hostnames should match first.
+        host_priority = -len(self.host)
+        # Longer schemes should match first.
+        scheme_priority = -len(self.scheme)
+        return (port_priority, host_priority, scheme_priority)
+
+    def __hash__(self) -> int:
+        return hash(self.pattern)
+
+    def __lt__(self, other: URLPattern) -> bool:
+        return self.priority < other.priority
+
+    def __eq__(self, other: typing.Any) -> bool:
+        return isinstance(other, URLPattern) and self.pattern == other.pattern
+
+
+def is_ipv4_hostname(hostname: str) -> bool:
+    try:
+        ipaddress.IPv4Address(hostname.split("/")[0])
+    except Exception:
+        return False
+    return True
+
+
+def is_ipv6_hostname(hostname: str) -> bool:
+    try:
+        ipaddress.IPv6Address(hostname.split("/")[0])
+    except Exception:
+        return False
+    return True
diff --git a/llm/Lib/site-packages/httpx/py.typed b/llm/Lib/site-packages/httpx/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/INSTALLER b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/LICENSE b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..261eeb9e9f8b2b4b0d119366dda99c6fd7d35c64
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/LICENSE
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/METADATA b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..34b08eaddcc0e2db0c01cf82187d4c7bf64b5c44
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/METADATA
@@ -0,0 +1,296 @@
+Metadata-Version: 2.1
+Name: huggingface-hub
+Version: 0.22.2
+Summary: Client library to download and publish models, datasets and other repos on the huggingface.co hub
+Home-page: https://github.com/huggingface/huggingface_hub
+Author: Hugging Face, Inc.
+Author-email: julien@huggingface.co
+License: Apache
+Keywords: model-hub machine-learning models natural-language-processing deep-learning pytorch pretrained-models
+Platform: UNKNOWN
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: filelock
+Requires-Dist: fsspec >=2023.5.0
+Requires-Dist: packaging >=20.9
+Requires-Dist: pyyaml >=5.1
+Requires-Dist: requests
+Requires-Dist: tqdm >=4.42.1
+Requires-Dist: typing-extensions >=3.7.4.3
+Provides-Extra: all
+Requires-Dist: InquirerPy ==0.3.4 ; extra == 'all'
+Requires-Dist: aiohttp ; extra == 'all'
+Requires-Dist: minijinja >=1.0 ; extra == 'all'
+Requires-Dist: jedi ; extra == 'all'
+Requires-Dist: Jinja2 ; extra == 'all'
+Requires-Dist: pytest ; extra == 'all'
+Requires-Dist: pytest-cov ; extra == 'all'
+Requires-Dist: pytest-env ; extra == 'all'
+Requires-Dist: pytest-xdist ; extra == 'all'
+Requires-Dist: pytest-vcr ; extra == 'all'
+Requires-Dist: pytest-asyncio ; extra == 'all'
+Requires-Dist: pytest-rerunfailures ; extra == 'all'
+Requires-Dist: urllib3 <2.0 ; extra == 'all'
+Requires-Dist: soundfile ; extra == 'all'
+Requires-Dist: Pillow ; extra == 'all'
+Requires-Dist: gradio ; extra == 'all'
+Requires-Dist: numpy ; extra == 'all'
+Requires-Dist: ruff >=0.3.0 ; extra == 'all'
+Requires-Dist: mypy ==1.5.1 ; extra == 'all'
+Requires-Dist: typing-extensions >=4.8.0 ; extra == 'all'
+Requires-Dist: types-PyYAML ; extra == 'all'
+Requires-Dist: types-requests ; extra == 'all'
+Requires-Dist: types-simplejson ; extra == 'all'
+Requires-Dist: types-toml ; extra == 'all'
+Requires-Dist: types-tqdm ; extra == 'all'
+Requires-Dist: types-urllib3 ; extra == 'all'
+Provides-Extra: cli
+Requires-Dist: InquirerPy ==0.3.4 ; extra == 'cli'
+Provides-Extra: dev
+Requires-Dist: InquirerPy ==0.3.4 ; extra == 'dev'
+Requires-Dist: aiohttp ; extra == 'dev'
+Requires-Dist: minijinja >=1.0 ; extra == 'dev'
+Requires-Dist: jedi ; extra == 'dev'
+Requires-Dist: Jinja2 ; extra == 'dev'
+Requires-Dist: pytest ; extra == 'dev'
+Requires-Dist: pytest-cov ; extra == 'dev'
+Requires-Dist: pytest-env ; extra == 'dev'
+Requires-Dist: pytest-xdist ; extra == 'dev'
+Requires-Dist: pytest-vcr ; extra == 'dev'
+Requires-Dist: pytest-asyncio ; extra == 'dev'
+Requires-Dist: pytest-rerunfailures ; extra == 'dev'
+Requires-Dist: urllib3 <2.0 ; extra == 'dev'
+Requires-Dist: soundfile ; extra == 'dev'
+Requires-Dist: Pillow ; extra == 'dev'
+Requires-Dist: gradio ; extra == 'dev'
+Requires-Dist: numpy ; extra == 'dev'
+Requires-Dist: ruff >=0.3.0 ; extra == 'dev'
+Requires-Dist: mypy ==1.5.1 ; extra == 'dev'
+Requires-Dist: typing-extensions >=4.8.0 ; extra == 'dev'
+Requires-Dist: types-PyYAML ; extra == 'dev'
+Requires-Dist: types-requests ; extra == 'dev'
+Requires-Dist: types-simplejson ; extra == 'dev'
+Requires-Dist: types-toml ; extra == 'dev'
+Requires-Dist: types-tqdm ; extra == 'dev'
+Requires-Dist: types-urllib3 ; extra == 'dev'
+Provides-Extra: fastai
+Requires-Dist: toml ; extra == 'fastai'
+Requires-Dist: fastai >=2.4 ; extra == 'fastai'
+Requires-Dist: fastcore >=1.3.27 ; extra == 'fastai'
+Provides-Extra: hf_transfer
+Requires-Dist: hf-transfer >=0.1.4 ; extra == 'hf_transfer'
+Provides-Extra: inference
+Requires-Dist: aiohttp ; extra == 'inference'
+Requires-Dist: minijinja >=1.0 ; extra == 'inference'
+Provides-Extra: quality
+Requires-Dist: ruff >=0.3.0 ; extra == 'quality'
+Requires-Dist: mypy ==1.5.1 ; extra == 'quality'
+Provides-Extra: tensorflow
+Requires-Dist: tensorflow ; extra == 'tensorflow'
+Requires-Dist: pydot ; extra == 'tensorflow'
+Requires-Dist: graphviz ; extra == 'tensorflow'
+Provides-Extra: tensorflow-testing
+Requires-Dist: tensorflow ; extra == 'tensorflow-testing'
+Requires-Dist: keras <3.0 ; extra == 'tensorflow-testing'
+Provides-Extra: testing
+Requires-Dist: InquirerPy ==0.3.4 ; extra == 'testing'
+Requires-Dist: aiohttp ; extra == 'testing'
+Requires-Dist: minijinja >=1.0 ; extra == 'testing'
+Requires-Dist: jedi ; extra == 'testing'
+Requires-Dist: Jinja2 ; extra == 'testing'
+Requires-Dist: pytest ; extra == 'testing'
+Requires-Dist: pytest-cov ; extra == 'testing'
+Requires-Dist: pytest-env ; extra == 'testing'
+Requires-Dist: pytest-xdist ; extra == 'testing'
+Requires-Dist: pytest-vcr ; extra == 'testing'
+Requires-Dist: pytest-asyncio ; extra == 'testing'
+Requires-Dist: pytest-rerunfailures ; extra == 'testing'
+Requires-Dist: urllib3 <2.0 ; extra == 'testing'
+Requires-Dist: soundfile ; extra == 'testing'
+Requires-Dist: Pillow ; extra == 'testing'
+Requires-Dist: gradio ; extra == 'testing'
+Requires-Dist: numpy ; extra == 'testing'
+Provides-Extra: torch
+Requires-Dist: torch ; extra == 'torch'
+Requires-Dist: safetensors ; extra == 'torch'
+Provides-Extra: typing
+Requires-Dist: typing-extensions >=4.8.0 ; extra == 'typing'
+Requires-Dist: types-PyYAML ; extra == 'typing'
+Requires-Dist: types-requests ; extra == 'typing'
+Requires-Dist: types-simplejson ; extra == 'typing'
+Requires-Dist: types-toml ; extra == 'typing'
+Requires-Dist: types-tqdm ; extra == 'typing'
+Requires-Dist: types-urllib3 ; extra == 'typing'
+
+<p align="center">
+  <br/>
+    <img alt="huggingface_hub library logo" src="https://huggingface.co/datasets/huggingface/documentation-images/raw/main/huggingface_hub.svg" width="376" height="59" style="max-width: 100%;">
+  <br/>
+</p>
+
+<p align="center">
+    <i>The official Python client for the Huggingface Hub.</i>
+</p>
+
+<p align="center">
+    <a href="https://huggingface.co/docs/huggingface_hub/en/index"><img alt="Documentation" src="https://img.shields.io/website/http/huggingface.co/docs/huggingface_hub/index.svg?down_color=red&down_message=offline&up_message=online&label=doc"></a>
+    <a href="https://github.com/huggingface/huggingface_hub/releases"><img alt="GitHub release" src="https://img.shields.io/github/release/huggingface/huggingface_hub.svg"></a>
+    <a href="https://github.com/huggingface/huggingface_hub"><img alt="PyPi version" src="https://img.shields.io/pypi/pyversions/huggingface_hub.svg"></a>
+    <a href="https://pypi.org/project/huggingface-hub"><img alt="downloads" src="https://static.pepy.tech/badge/huggingface_hub/month"></a>
+    <a href="https://codecov.io/gh/huggingface/huggingface_hub"><img alt="Code coverage" src="https://codecov.io/gh/huggingface/huggingface_hub/branch/main/graph/badge.svg?token=RXP95LE2XL"></a>
+</p>
+
+<h4 align="center">
+    <p>
+        <b>English</b> |
+        <a href="https://github.com/huggingface/huggingface_hub/blob/main/README_de.md">Deutsch</a> |
+        <a href="https://github.com/huggingface/huggingface_hub/blob/main/README_hi.md">हिंदी</a> |
+        <a href="https://github.com/huggingface/huggingface_hub/blob/main/README_ko.md">한국어</a> |
+        <a href="https://github.com/huggingface/huggingface_hub/blob/main/README_cn.md">中文（简体）</a>
+    <p>
+</h4>
+---
+
+**Documentation**: <a href="https://hf.co/docs/huggingface_hub" target="_blank">https://hf.co/docs/huggingface_hub</a>
+
+**Source Code**: <a href="https://github.com/huggingface/huggingface_hub" target="_blank">https://github.com/huggingface/huggingface_hub</a>
+
+---
+
+## Welcome to the huggingface_hub library
+
+The `huggingface_hub` library allows you to interact with the [Hugging Face Hub](https://huggingface.co/), a platform democratizing open-source Machine Learning for creators and collaborators. Discover pre-trained models and datasets for your projects or play with the thousands of machine learning apps hosted on the Hub. You can also create and share your own models, datasets and demos with the community. The `huggingface_hub` library provides a simple way to do all these things with Python.
+
+## Key features
+
+- [Download files](https://huggingface.co/docs/huggingface_hub/en/guides/download) from the Hub.
+- [Upload files](https://huggingface.co/docs/huggingface_hub/en/guides/upload) to the Hub.
+- [Manage your repositories](https://huggingface.co/docs/huggingface_hub/en/guides/repository).
+- [Run Inference](https://huggingface.co/docs/huggingface_hub/en/guides/inference) on deployed models.
+- [Search](https://huggingface.co/docs/huggingface_hub/en/guides/search) for models, datasets and Spaces.
+- [Share Model Cards](https://huggingface.co/docs/huggingface_hub/en/guides/model-cards) to document your models.
+- [Engage with the community](https://huggingface.co/docs/huggingface_hub/en/guides/community) through PRs and comments.
+
+## Installation
+
+Install the `huggingface_hub` package with [pip](https://pypi.org/project/huggingface-hub/):
+
+```bash
+pip install huggingface_hub
+```
+
+If you prefer, you can also install it with [conda](https://huggingface.co/docs/huggingface_hub/en/installation#install-with-conda).
+
+In order to keep the package minimal by default, `huggingface_hub` comes with optional dependencies useful for some use cases. For example, if you want have a complete experience for Inference, run:
+
+```bash
+pip install huggingface_hub[inference]
+```
+
+To learn more installation and optional dependencies, check out the [installation guide](https://huggingface.co/docs/huggingface_hub/en/installation).
+
+## Quick start
+
+### Download files
+
+Download a single file
+
+```py
+from huggingface_hub import hf_hub_download
+
+hf_hub_download(repo_id="tiiuae/falcon-7b-instruct", filename="config.json")
+```
+
+Or an entire repository
+
+```py
+from huggingface_hub import snapshot_download
+
+snapshot_download("stabilityai/stable-diffusion-2-1")
+```
+
+Files will be downloaded in a local cache folder. More details in [this guide](https://huggingface.co/docs/huggingface_hub/en/guides/manage-cache).
+
+### Login
+
+The Hugging Face Hub uses tokens to authenticate applications (see [docs](https://huggingface.co/docs/hub/security-tokens)). To login your machine, run the following CLI:
+
+```bash
+huggingface-cli login
+# or using an environment variable
+huggingface-cli login --token $HUGGINGFACE_TOKEN
+```
+
+### Create a repository
+
+```py
+from huggingface_hub import create_repo
+
+create_repo(repo_id="super-cool-model")
+```
+
+### Upload files
+
+Upload a single file
+
+```py
+from huggingface_hub import upload_file
+
+upload_file(
+    path_or_fileobj="/home/lysandre/dummy-test/README.md",
+    path_in_repo="README.md",
+    repo_id="lysandre/test-model",
+)
+```
+
+Or an entire folder
+
+```py
+from huggingface_hub import upload_folder
+
+upload_folder(
+    folder_path="/path/to/local/space",
+    repo_id="username/my-cool-space",
+    repo_type="space",
+)
+```
+
+For details in the [upload guide](https://huggingface.co/docs/huggingface_hub/en/guides/upload).
+
+## Integrating to the Hub.
+
+We're partnering with cool open source ML libraries to provide free model hosting and versioning. You can find the existing integrations [here](https://huggingface.co/docs/hub/libraries).
+
+The advantages are:
+
+- Free model or dataset hosting for libraries and their users.
+- Built-in file versioning, even with very large files, thanks to a git-based approach.
+- Serverless inference API for all models publicly available.
+- In-browser widgets to play with the uploaded models.
+- Anyone can upload a new model for your library, they just need to add the corresponding tag for the model to be discoverable.
+- Fast downloads! We use Cloudfront (a CDN) to geo-replicate downloads so they're blazing fast from anywhere on the globe.
+- Usage stats and more features to come.
+
+If you would like to integrate your library, feel free to open an issue to begin the discussion. We wrote a [step-by-step guide](https://huggingface.co/docs/hub/adding-a-library) with ❤️ showing how to do this integration.
+
+## Contributions (feature requests, bugs, etc.) are super welcome 💙💚💛💜🧡❤️
+
+Everyone is welcome to contribute, and we value everybody's contribution. Code is not the only way to help the community.
+Answering questions, helping others, reaching out and improving the documentations are immensely valuable to the community.
+We wrote a [contribution guide](https://github.com/huggingface/huggingface_hub/blob/main/CONTRIBUTING.md) to summarize
+how to get started to contribute to this repository.
+
+
diff --git a/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/RECORD b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..c7c2b883ec33cc2b52b346942ccd5a2bd76bec94
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/RECORD
@@ -0,0 +1,221 @@
+../../Scripts/huggingface-cli.exe,sha256=3nkHI4RBCizEtXTbJ8XFymkFPMNdgsDv09eZIDk4m7I,108407
+huggingface_hub-0.22.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+huggingface_hub-0.22.2.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+huggingface_hub-0.22.2.dist-info/METADATA,sha256=9S0T9nMXn6Q7cesvjVBiSk4oEid8LZ3gT9fuJLGrWNk,12869
+huggingface_hub-0.22.2.dist-info/RECORD,,
+huggingface_hub-0.22.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+huggingface_hub-0.22.2.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+huggingface_hub-0.22.2.dist-info/entry_points.txt,sha256=Y3Z2L02rBG7va_iE6RPXolIgwOdwUFONyRN3kXMxZ0g,131
+huggingface_hub-0.22.2.dist-info/top_level.txt,sha256=8KzlQJAY4miUvjAssOAJodqKOw3harNzuiwGQ9qLSSk,16
+huggingface_hub/__init__.py,sha256=lDulrtedaTz17qYF0AzTHuRanxwgeGlVdq6TxmIcuQQ,31075
+huggingface_hub/__pycache__/__init__.cpython-311.pyc,,
+huggingface_hub/__pycache__/_commit_api.cpython-311.pyc,,
+huggingface_hub/__pycache__/_commit_scheduler.cpython-311.pyc,,
+huggingface_hub/__pycache__/_inference_endpoints.cpython-311.pyc,,
+huggingface_hub/__pycache__/_login.cpython-311.pyc,,
+huggingface_hub/__pycache__/_multi_commits.cpython-311.pyc,,
+huggingface_hub/__pycache__/_snapshot_download.cpython-311.pyc,,
+huggingface_hub/__pycache__/_space_api.cpython-311.pyc,,
+huggingface_hub/__pycache__/_tensorboard_logger.cpython-311.pyc,,
+huggingface_hub/__pycache__/_webhooks_payload.cpython-311.pyc,,
+huggingface_hub/__pycache__/_webhooks_server.cpython-311.pyc,,
+huggingface_hub/__pycache__/community.cpython-311.pyc,,
+huggingface_hub/__pycache__/constants.cpython-311.pyc,,
+huggingface_hub/__pycache__/errors.cpython-311.pyc,,
+huggingface_hub/__pycache__/fastai_utils.cpython-311.pyc,,
+huggingface_hub/__pycache__/file_download.cpython-311.pyc,,
+huggingface_hub/__pycache__/hf_api.cpython-311.pyc,,
+huggingface_hub/__pycache__/hf_file_system.cpython-311.pyc,,
+huggingface_hub/__pycache__/hub_mixin.cpython-311.pyc,,
+huggingface_hub/__pycache__/inference_api.cpython-311.pyc,,
+huggingface_hub/__pycache__/keras_mixin.cpython-311.pyc,,
+huggingface_hub/__pycache__/lfs.cpython-311.pyc,,
+huggingface_hub/__pycache__/repocard.cpython-311.pyc,,
+huggingface_hub/__pycache__/repocard_data.cpython-311.pyc,,
+huggingface_hub/__pycache__/repository.cpython-311.pyc,,
+huggingface_hub/_commit_api.py,sha256=_6NggUJsCBdspCJjXbvZYXH6vLBOnkG6I2E1kc8aJm8,29194
+huggingface_hub/_commit_scheduler.py,sha256=FgfjYv3E0oK3iBxDdy45Y7t78FWkmjnBR4dRd5aZviU,13653
+huggingface_hub/_inference_endpoints.py,sha256=wGcnxZNFCbMK77SA90fPsZ9bqNGwPopSVr-sTbdw3o8,15763
+huggingface_hub/_login.py,sha256=jNTFCnou-eZAtMWl1PDuyZhmpW3O-f4qff9m5hU0UGk,15364
+huggingface_hub/_multi_commits.py,sha256=rtN0AaHzamXi1cvr1r2MlqR6y-laZxgRo-30J_I3RwM,12519
+huggingface_hub/_snapshot_download.py,sha256=lXsSWaDSOP0hH5_9tOSBazNAtWSBhN8dMcjrLY7hNIc,15677
+huggingface_hub/_space_api.py,sha256=Mae_lqTRyTWyszI5mlObJ2fn9slPxkFPcFTEVADoNQM,5255
+huggingface_hub/_tensorboard_logger.py,sha256=uqmkKBKyj6_9XfWq563afgARenZ7-fjEHb16rgY24-Y,7166
+huggingface_hub/_webhooks_payload.py,sha256=cF9iWOOacOZfqKGcuVhykDgAZHrHON7VMuLwwehl6O8,2832
+huggingface_hub/_webhooks_server.py,sha256=fDbyDu28qhJJQb8tKpH1C8l4cJSvC3Gr2sUo1DbIoD8,15197
+huggingface_hub/commands/__init__.py,sha256=AkbM2a-iGh0Vq_xAWhK3mu3uZ44km8-X5uWjKcvcrUQ,928
+huggingface_hub/commands/__pycache__/__init__.cpython-311.pyc,,
+huggingface_hub/commands/__pycache__/_cli_utils.cpython-311.pyc,,
+huggingface_hub/commands/__pycache__/delete_cache.cpython-311.pyc,,
+huggingface_hub/commands/__pycache__/download.cpython-311.pyc,,
+huggingface_hub/commands/__pycache__/env.cpython-311.pyc,,
+huggingface_hub/commands/__pycache__/huggingface_cli.cpython-311.pyc,,
+huggingface_hub/commands/__pycache__/lfs.cpython-311.pyc,,
+huggingface_hub/commands/__pycache__/scan_cache.cpython-311.pyc,,
+huggingface_hub/commands/__pycache__/upload.cpython-311.pyc,,
+huggingface_hub/commands/__pycache__/user.cpython-311.pyc,,
+huggingface_hub/commands/_cli_utils.py,sha256=qRdl9opi3yJxIVNCnrmte-jFWmYbjVqd8gBlin8NNzY,1971
+huggingface_hub/commands/delete_cache.py,sha256=Rb1BtIltJPnQ-th7tcK_L4mFqfk785t3KXV77xXKBP4,16131
+huggingface_hub/commands/download.py,sha256=yGq9SlTRHR6TBrky_VBIyo68e0gnMLgYPBYIBG7d9bQ,9167
+huggingface_hub/commands/env.py,sha256=yYl4DSS14V8t244nAi0t77Izx5LIdgS_dy6xiV5VQME,1226
+huggingface_hub/commands/huggingface_cli.py,sha256=o862C98OcZoyqCzY7mNpia1h0KaLJUgSb0y10ot8sxA,1924
+huggingface_hub/commands/lfs.py,sha256=6E769AoRxUDiIOapn1_QvTbNtdUnUiouu2F4Gopp4do,7318
+huggingface_hub/commands/scan_cache.py,sha256=4o_jQsZloicRa-P8gncUBncVyWswpSF9T6KGlNrGodk,5183
+huggingface_hub/commands/upload.py,sha256=Mr69qO60otqCVw0sVSBPykUTkL9HO-pkCyulSD2mROM,13622
+huggingface_hub/commands/user.py,sha256=QApZJOCQEHADhjunM3hlQ72uqHsearCiCE4SdpzGdcc,6893
+huggingface_hub/community.py,sha256=SBaOfI-3atCzRbO0gDS8BYxctbdvD4G0X6D0GfY8Fgc,12203
+huggingface_hub/constants.py,sha256=8r0JaNMhLR8X6pC6TnNBLQ-TVcHEbRWk1sJ-LSIj444,7821
+huggingface_hub/errors.py,sha256=jCYKeSOsQNfH2t3TsW8kIAXXS1aWl9PaAq3prFfz4CI,704
+huggingface_hub/fastai_utils.py,sha256=5I7zAfgHJU_mZnxnf9wgWTHrCRu_EAV8VTangDVfE_o,16676
+huggingface_hub/file_download.py,sha256=DmOEVmhEsRnX8M0kZmLPLC76eptMT0riTwtThFioV8Q,77476
+huggingface_hub/hf_api.py,sha256=dJsdtW6WJW04h84BE46FOg8Pp34AgYhg-NbMg9WrReY,367303
+huggingface_hub/hf_file_system.py,sha256=JUCT-VZBesDCB-uN__fvQt3uprGQETGnUlzjC7StQLM,37272
+huggingface_hub/hub_mixin.py,sha256=xkUTJiP5TiAiVj6ts9Thffcm4wufZS3jMWil3LB2uvw,30423
+huggingface_hub/inference/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+huggingface_hub/inference/__pycache__/__init__.cpython-311.pyc,,
+huggingface_hub/inference/__pycache__/_client.cpython-311.pyc,,
+huggingface_hub/inference/__pycache__/_common.cpython-311.pyc,,
+huggingface_hub/inference/__pycache__/_templating.cpython-311.pyc,,
+huggingface_hub/inference/__pycache__/_types.cpython-311.pyc,,
+huggingface_hub/inference/_client.py,sha256=D4O07nYFo7v5lXZ7id3zubV6u8_RxhTVStoeAgEBs-E,104854
+huggingface_hub/inference/_common.py,sha256=BOOBNpF0_V8fDXsi2q5eQ9i4KIlPS6VfMxYxLSgkRdM,16570
+huggingface_hub/inference/_generated/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+huggingface_hub/inference/_generated/__pycache__/__init__.cpython-311.pyc,,
+huggingface_hub/inference/_generated/__pycache__/_async_client.cpython-311.pyc,,
+huggingface_hub/inference/_generated/_async_client.py,sha256=d7fvZyyBNnG9zivHS7rCwaR7TlETN7JENR-M_ZEo_3c,108053
+huggingface_hub/inference/_generated/types/__init__.py,sha256=SoKeNQ8JjBgKkQIgBTsWJe4-Z75Ebz6WkdL4ZQ27yNc,4450
+huggingface_hub/inference/_generated/types/__pycache__/__init__.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/audio_classification.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/audio_to_audio.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/automatic_speech_recognition.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/base.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/chat_completion.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/depth_estimation.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/document_question_answering.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/feature_extraction.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/fill_mask.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/image_classification.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/image_segmentation.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/image_to_image.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/image_to_text.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/object_detection.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/question_answering.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/sentence_similarity.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/summarization.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/table_question_answering.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/text2text_generation.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/text_classification.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/text_generation.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/text_to_audio.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/text_to_image.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/token_classification.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/translation.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/video_classification.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/visual_question_answering.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/zero_shot_classification.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/zero_shot_image_classification.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/__pycache__/zero_shot_object_detection.cpython-311.pyc,,
+huggingface_hub/inference/_generated/types/audio_classification.py,sha256=wk4kUTLQZoXWLpiUOpKRHRRE-JYqqJlzGVe62VACR-0,1347
+huggingface_hub/inference/_generated/types/audio_to_audio.py,sha256=n7GeCepzt254yoSLsdjrI1j4fzYgjWzxoaKE5gZJc48,881
+huggingface_hub/inference/_generated/types/automatic_speech_recognition.py,sha256=-7UHu5QTGwSrJFnrbMgzeUFpJQOGyTmfK_QHgtnx6j8,5352
+huggingface_hub/inference/_generated/types/base.py,sha256=Cq4gUVtwwLmWyiIIq4NSL8kRk0EWk9QWWHc5Vup2LVg,6213
+huggingface_hub/inference/_generated/types/chat_completion.py,sha256=cI-gWOgqEBnwhxwn21OShkKOs3mbjjzJ1Ow2pzLQEwc,3616
+huggingface_hub/inference/_generated/types/depth_estimation.py,sha256=lmLmd8S313ZMCG94RblwquL0UN_0hJmXAhWUqSIrtwc,898
+huggingface_hub/inference/_generated/types/document_question_answering.py,sha256=_hBzK4Pu9X_zXsgOO4JNSloIKuVfE5m7eGwEw5YTfZ4,3264
+huggingface_hub/inference/_generated/types/feature_extraction.py,sha256=KerTrRR5YR02X0qBDzrtK8953amCGf_adSUbfWOozD4,664
+huggingface_hub/inference/_generated/types/fill_mask.py,sha256=JcYIbTDXc4f7k2FNY3fCWtJ9ke3HUZFz2pDOOrDuxOs,1714
+huggingface_hub/inference/_generated/types/image_classification.py,sha256=W1QVfc0j7t6qbxjICUQDwygRx43yPPGZKyStogHkHqg,1359
+huggingface_hub/inference/_generated/types/image_segmentation.py,sha256=nVQc5Qhv37qqmTn_M8xegpNgk14ozKelsGIYC8hba_0,1803
+huggingface_hub/inference/_generated/types/image_to_image.py,sha256=MbubS9pD8bFP9LoI4QoQxJwpUGeNXi5iSEk8Ymhbh0M,1797
+huggingface_hub/inference/_generated/types/image_to_text.py,sha256=mloLf-LO7oR_2HbPY1-XMM18BfjMODytRaxTXYkIXoY,4827
+huggingface_hub/inference/_generated/types/object_detection.py,sha256=F8ly6GSE8dupsekPVf6G5nI8teZAIP4iXw6u3zm1JiE,1569
+huggingface_hub/inference/_generated/types/question_answering.py,sha256=xLDy5oA-k9JPncSU6NqPAPb8rWPerfTbU857G3e7JZ0,2884
+huggingface_hub/inference/_generated/types/sentence_similarity.py,sha256=edH-TWfnZ4J0zJD-zqfcRMLwOV0dTt1g5Y0caYnVuPc,1018
+huggingface_hub/inference/_generated/types/summarization.py,sha256=RWCXh7yftI_JWvLsr7JiDpQPexq1klYP158tUICUcbM,1574
+huggingface_hub/inference/_generated/types/table_question_answering.py,sha256=PuVZlR6dI6FEUK7pjMSVMtzkDgrcxdKjfcnDbVmPdSs,1569
+huggingface_hub/inference/_generated/types/text2text_generation.py,sha256=SZYfdhyraG5vZ2Jzm1C8k9w9IYLxMtm5UUu1tU2oOQk,1604
+huggingface_hub/inference/_generated/types/text_classification.py,sha256=vC7B1sBzZ4gdLjE2i2Y7w5cpdaFwQKK1dlWqW0asjIk,1347
+huggingface_hub/inference/_generated/types/text_generation.py,sha256=VHhkhEj-yEVGuy4BYgDNzmAPBPJWL3N1B4n4SUOymNk,5866
+huggingface_hub/inference/_generated/types/text_to_audio.py,sha256=cgvECsiwsycgP9Tfs_GU1CJfo9AngVn6x9s4fHCP-g4,4819
+huggingface_hub/inference/_generated/types/text_to_image.py,sha256=oBGeJ-S9WfsMxVQlvEOll9yaCyMXZ277wsYFD8bt87U,1931
+huggingface_hub/inference/_generated/types/token_classification.py,sha256=7oL8AZOTWtf2bYD2T3236GDNMtUl7FtydaB6We7wbfw,1890
+huggingface_hub/inference/_generated/types/translation.py,sha256=MruCx6yhzQGlxSdBRXCVoEhRzRSa5Ks4bjZ1PDrlTeQ,1562
+huggingface_hub/inference/_generated/types/video_classification.py,sha256=BI2_PP-pxLT6w9TuX6QCZz4BsG-ZukTXnW6fWMchI5M,1579
+huggingface_hub/inference/_generated/types/visual_question_answering.py,sha256=0PHNnjwxxHvG3SjOz7O7DckbBeGYDsRmlagG11qIkkM,1667
+huggingface_hub/inference/_generated/types/zero_shot_classification.py,sha256=u6jfFCqDv9XqeAN5E9_Xf7jqMZgqTRFF_S9PtWbiBUk,1963
+huggingface_hub/inference/_generated/types/zero_shot_image_classification.py,sha256=qVH6Ms0FjF8TraGy4BYiS8lmvGq9xiIDdXqGFynLHMA,1689
+huggingface_hub/inference/_generated/types/zero_shot_object_detection.py,sha256=PU4OOlQ2aAOosW2JlG2Z27MEQpmE6BxcygH_ns3w1KQ,1662
+huggingface_hub/inference/_templating.py,sha256=_X7CoUjOmMh5KBXx-WGey-z3uh_fP1QT36X638UZpZw,4051
+huggingface_hub/inference/_types.py,sha256=C73l5-RO8P1UMBHF8OAO9CRUq7Xdv33pcADoJsGMPSU,1782
+huggingface_hub/inference_api.py,sha256=UXOKu_Ez2I3hDsjguqCcCrj03WFDndehpngYiIAucdg,8331
+huggingface_hub/keras_mixin.py,sha256=8L0FEIWy_kmKsGI5d61q_33dGYbmLGhy4kZbqn-YFns,19681
+huggingface_hub/lfs.py,sha256=p61RJK13gtgdu0og4KHFosy_GWYDFsQJa0JJoLYSLAk,19592
+huggingface_hub/repocard.py,sha256=oUrGim27nCHkevPDZDbUp68uKTxB8xbdoyeqv24pexc,34605
+huggingface_hub/repocard_data.py,sha256=1hIkI8xp0EmW2aR3LtHMrjIMk_W-KJxHslMjpNMwVPg,31911
+huggingface_hub/repository.py,sha256=8oNhKNvJRye3dr67cTn8faKkBSiWFgvj7bIBlOpI-8U,54489
+huggingface_hub/serialization/__init__.py,sha256=W74TaCtYnMfpvGEQr1SS-OBmqPUFnM9AeWT9hTJCG9Y,910
+huggingface_hub/serialization/__pycache__/__init__.cpython-311.pyc,,
+huggingface_hub/serialization/__pycache__/_base.cpython-311.pyc,,
+huggingface_hub/serialization/__pycache__/_numpy.cpython-311.pyc,,
+huggingface_hub/serialization/__pycache__/_tensorflow.cpython-311.pyc,,
+huggingface_hub/serialization/__pycache__/_torch.cpython-311.pyc,,
+huggingface_hub/serialization/_base.py,sha256=AgO-16i-vyosbERnLSCFYgaXbVqQDM7xfIne8gsWrLQ,7133
+huggingface_hub/serialization/_numpy.py,sha256=idULJp1js6L6E8o-MiGVqNa4lBfXS2cfAmqivnpsaYs,2671
+huggingface_hub/serialization/_tensorflow.py,sha256=Rf4kw1NYxEaoUXB8aLtQLHrTjgobaEAJdzO0w0kbP58,3559
+huggingface_hub/serialization/_torch.py,sha256=xYR6e_G9laMTroWLiQRABSuloTQuuRSQNyYHdT_rmXU,7687
+huggingface_hub/templates/datasetcard_template.md,sha256=W-EMqR6wndbrnZorkVv56URWPG49l7MATGeI015kTvs,5503
+huggingface_hub/templates/modelcard_template.md,sha256=4AqArS3cqdtbit5Bo-DhjcnDFR-pza5hErLLTPM4Yuc,6870
+huggingface_hub/utils/__init__.py,sha256=XYIIkKiDeoy8dQQegBYSfILOzdt8NW_cfquY7omX0fQ,3478
+huggingface_hub/utils/__pycache__/__init__.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_cache_assets.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_cache_manager.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_chunk_utils.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_datetime.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_deprecation.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_errors.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_experimental.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_fixes.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_git_credential.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_headers.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_hf_folder.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_http.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_pagination.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_paths.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_runtime.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_safetensors.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_subprocess.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_telemetry.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_token.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_typing.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/_validators.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/endpoint_helpers.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/insecure_hashlib.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/logging.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/sha.cpython-311.pyc,,
+huggingface_hub/utils/__pycache__/tqdm.cpython-311.pyc,,
+huggingface_hub/utils/_cache_assets.py,sha256=kai77HPQMfYpROouMBQCr_gdBCaeTm996Sqj0dExbNg,5728
+huggingface_hub/utils/_cache_manager.py,sha256=Fs1XVP1UGzUTogMfMfEi_MfpURzHyW__djX0s2oLmrY,29307
+huggingface_hub/utils/_chunk_utils.py,sha256=kRCaj5228_vKcyLWspd8Xq01f17Jz6ds5Sr9ed5d_RU,2130
+huggingface_hub/utils/_datetime.py,sha256=DHnktKm1taeOe2XCBgNU4pVck5d70qu8FJ7nACD6C3k,2554
+huggingface_hub/utils/_deprecation.py,sha256=HZhRGGUX_QMKBBBwHHlffLtmCSK01TOpeXHefZbPfwI,4872
+huggingface_hub/utils/_errors.py,sha256=N5nUkCCaj8393wntazeTcKNrwDZfsDVHVMxxreHPfaE,15141
+huggingface_hub/utils/_experimental.py,sha256=crCPH6k6-11wwH2GZuZzZzZbjUotay49ywV1SSJhMHM,2395
+huggingface_hub/utils/_fixes.py,sha256=EqG7u36J9C3NtL5VukDilca90GV9idrENzsEVhtdbI4,2829
+huggingface_hub/utils/_git_credential.py,sha256=SDdsiREr1TcAR2Ze2TB0E5cYzVJgvDZrs60od9lAsMc,4596
+huggingface_hub/utils/_headers.py,sha256=T_C1RA0bqEYL0oiE4WdFMAKXEUPHN-D43vchjiwKcZ4,9643
+huggingface_hub/utils/_hf_folder.py,sha256=gWH-TT9h_6X_CyrtLTtKNEawf9kKlCHraFiOu09BuLk,3613
+huggingface_hub/utils/_http.py,sha256=VQcukUKXXDlDQwyG-LGVtAIr3DprVC-R_HcXZzbAfak,13543
+huggingface_hub/utils/_pagination.py,sha256=hzLFLd8i_DKkPRVYzOx2CxLt5lcocEiAxDJriQUjAjY,1841
+huggingface_hub/utils/_paths.py,sha256=Ah_diO-gSWw9TYylJl_HNB2XXftgIi36HNlKAYQHCms,4398
+huggingface_hub/utils/_runtime.py,sha256=6PxkDPWj3ltRlE2-zAr3vZTXfi1OUjxILsmRN-s_wZY,10851
+huggingface_hub/utils/_safetensors.py,sha256=EE9v9HflWBUqIegn0dCGHgNu9G9Db3v2aszvG4ldPF8,4876
+huggingface_hub/utils/_subprocess.py,sha256=34ETD8JvLzm16NRZHciaCLXdE9aRyxuDdOA5gdNvMJ8,4617
+huggingface_hub/utils/_telemetry.py,sha256=jHAdgWNcL9nVvMT3ec3i78O-cwL09GnlifuokzpQjMI,4641
+huggingface_hub/utils/_token.py,sha256=cxBZaafW2IsJ2dKWd55v7056zycW1ewp_nPk8dNcSO4,5476
+huggingface_hub/utils/_typing.py,sha256=pXh7GtVtSBD_Fvvthex9BRTAJZ6bWScUOw06oJS0Lek,2025
+huggingface_hub/utils/_validators.py,sha256=otFT4xT3s_E_-jrzH4NR7xWgK7UlRkwk_KAI9XK1mb0,9359
+huggingface_hub/utils/endpoint_helpers.py,sha256=n_VguR_L2Vl6Mi_4PFO2iAd5xaPeQRiD8KRBpzs4nMw,9536
+huggingface_hub/utils/insecure_hashlib.py,sha256=OjxlvtSQHpbLp9PWSrXBDJ0wHjxCBU-SQJgucEEXDbU,1058
+huggingface_hub/utils/logging.py,sha256=Cp03s0uEl3kDM9XHQW9a8GAoExODQ-e7kEtgMt-_To8,4728
+huggingface_hub/utils/sha.py,sha256=QLlIwPCyz46MmUc_4L8xl87KfYoBks9kPgsMZ5JCz-o,902
+huggingface_hub/utils/tqdm.py,sha256=2H80n_kDpvp7P4i7MaYR47t41i0l6ODi5mab1oof1dk,6335
diff --git a/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/REQUESTED b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/REQUESTED
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/WHEEL b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..bab98d675883cc7567a79df485cd7b4f015e376f
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/entry_points.txt b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..eb3dafd90f19de60b3e520aeaf8132402980214d
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/entry_points.txt
@@ -0,0 +1,6 @@
+[console_scripts]
+huggingface-cli = huggingface_hub.commands.huggingface_cli:main
+
+[fsspec.specs]
+hf=huggingface_hub.HfFileSystem
+
diff --git a/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/top_level.txt b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..6b964ccca3c1b6766042b3fe3b2707ba25372924
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub-0.22.2.dist-info/top_level.txt
@@ -0,0 +1 @@
+huggingface_hub
diff --git a/llm/Lib/site-packages/huggingface_hub/__init__.py b/llm/Lib/site-packages/huggingface_hub/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..db124d36d239f7855cb7a65dbe6830a395c51191
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/__init__.py
@@ -0,0 +1,884 @@
+# Copyright 2020 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# ***********
+# `huggingface_hub` init has 2 modes:
+# - Normal usage:
+#       If imported to use it, all modules and functions are lazy-loaded. This means
+#       they exist at top level in module but are imported only the first time they are
+#       used. This way, `from huggingface_hub import something` will import `something`
+#       quickly without the hassle of importing all the features from `huggingface_hub`.
+# - Static check:
+#       If statically analyzed, all modules and functions are loaded normally. This way
+#       static typing check works properly as well as autocomplete in text editors and
+#       IDEs.
+#
+# The static model imports are done inside the `if TYPE_CHECKING:` statement at
+# the bottom of this file. Since module/functions imports are duplicated, it is
+# mandatory to make sure to add them twice when adding one. This is checked in the
+# `make quality` command.
+#
+# To update the static imports, please run the following command and commit the changes.
+# ```
+# # Use script
+# python utils/check_static_imports.py --update-file
+#
+# # Or run style on codebase
+# make style
+# ```
+#
+# ***********
+# Lazy loader vendored from https://github.com/scientific-python/lazy_loader
+import importlib
+import os
+import sys
+from typing import TYPE_CHECKING
+
+
+__version__ = "0.22.2"
+
+# Alphabetical order of definitions is ensured in tests
+# WARNING: any comment added in this dictionary definition will be lost when
+# re-generating the file !
+_SUBMOD_ATTRS = {
+    "_commit_scheduler": [
+        "CommitScheduler",
+    ],
+    "_inference_endpoints": [
+        "InferenceEndpoint",
+        "InferenceEndpointError",
+        "InferenceEndpointStatus",
+        "InferenceEndpointTimeoutError",
+        "InferenceEndpointType",
+    ],
+    "_login": [
+        "interpreter_login",
+        "login",
+        "logout",
+        "notebook_login",
+    ],
+    "_multi_commits": [
+        "MultiCommitException",
+        "plan_multi_commits",
+    ],
+    "_snapshot_download": [
+        "snapshot_download",
+    ],
+    "_space_api": [
+        "SpaceHardware",
+        "SpaceRuntime",
+        "SpaceStage",
+        "SpaceStorage",
+        "SpaceVariable",
+    ],
+    "_tensorboard_logger": [
+        "HFSummaryWriter",
+    ],
+    "_webhooks_payload": [
+        "WebhookPayload",
+        "WebhookPayloadComment",
+        "WebhookPayloadDiscussion",
+        "WebhookPayloadDiscussionChanges",
+        "WebhookPayloadEvent",
+        "WebhookPayloadMovedTo",
+        "WebhookPayloadRepo",
+        "WebhookPayloadUrl",
+        "WebhookPayloadWebhook",
+    ],
+    "_webhooks_server": [
+        "WebhooksServer",
+        "webhook_endpoint",
+    ],
+    "community": [
+        "Discussion",
+        "DiscussionComment",
+        "DiscussionCommit",
+        "DiscussionEvent",
+        "DiscussionStatusChange",
+        "DiscussionTitleChange",
+        "DiscussionWithDetails",
+    ],
+    "constants": [
+        "CONFIG_NAME",
+        "FLAX_WEIGHTS_NAME",
+        "HUGGINGFACE_CO_URL_HOME",
+        "HUGGINGFACE_CO_URL_TEMPLATE",
+        "PYTORCH_WEIGHTS_NAME",
+        "REPO_TYPE_DATASET",
+        "REPO_TYPE_MODEL",
+        "REPO_TYPE_SPACE",
+        "TF2_WEIGHTS_NAME",
+        "TF_WEIGHTS_NAME",
+    ],
+    "fastai_utils": [
+        "_save_pretrained_fastai",
+        "from_pretrained_fastai",
+        "push_to_hub_fastai",
+    ],
+    "file_download": [
+        "HfFileMetadata",
+        "_CACHED_NO_EXIST",
+        "cached_download",
+        "get_hf_file_metadata",
+        "hf_hub_download",
+        "hf_hub_url",
+        "try_to_load_from_cache",
+    ],
+    "hf_api": [
+        "Collection",
+        "CollectionItem",
+        "CommitInfo",
+        "CommitOperation",
+        "CommitOperationAdd",
+        "CommitOperationCopy",
+        "CommitOperationDelete",
+        "GitCommitInfo",
+        "GitRefInfo",
+        "GitRefs",
+        "HfApi",
+        "RepoUrl",
+        "User",
+        "UserLikes",
+        "accept_access_request",
+        "add_collection_item",
+        "add_space_secret",
+        "add_space_variable",
+        "cancel_access_request",
+        "change_discussion_status",
+        "comment_discussion",
+        "create_branch",
+        "create_collection",
+        "create_commit",
+        "create_commits_on_pr",
+        "create_discussion",
+        "create_inference_endpoint",
+        "create_pull_request",
+        "create_repo",
+        "create_tag",
+        "dataset_info",
+        "delete_branch",
+        "delete_collection",
+        "delete_collection_item",
+        "delete_file",
+        "delete_folder",
+        "delete_inference_endpoint",
+        "delete_repo",
+        "delete_space_secret",
+        "delete_space_storage",
+        "delete_space_variable",
+        "delete_tag",
+        "duplicate_space",
+        "edit_discussion_comment",
+        "file_exists",
+        "get_collection",
+        "get_dataset_tags",
+        "get_discussion_details",
+        "get_full_repo_name",
+        "get_inference_endpoint",
+        "get_model_tags",
+        "get_paths_info",
+        "get_repo_discussions",
+        "get_safetensors_metadata",
+        "get_space_runtime",
+        "get_space_variables",
+        "get_token_permission",
+        "grant_access",
+        "like",
+        "list_accepted_access_requests",
+        "list_collections",
+        "list_datasets",
+        "list_files_info",
+        "list_inference_endpoints",
+        "list_liked_repos",
+        "list_metrics",
+        "list_models",
+        "list_pending_access_requests",
+        "list_rejected_access_requests",
+        "list_repo_commits",
+        "list_repo_files",
+        "list_repo_likers",
+        "list_repo_refs",
+        "list_repo_tree",
+        "list_spaces",
+        "merge_pull_request",
+        "model_info",
+        "move_repo",
+        "parse_safetensors_file_metadata",
+        "pause_inference_endpoint",
+        "pause_space",
+        "preupload_lfs_files",
+        "reject_access_request",
+        "rename_discussion",
+        "repo_exists",
+        "repo_info",
+        "repo_type_and_id_from_hf_id",
+        "request_space_hardware",
+        "request_space_storage",
+        "restart_space",
+        "resume_inference_endpoint",
+        "revision_exists",
+        "run_as_future",
+        "scale_to_zero_inference_endpoint",
+        "set_space_sleep_time",
+        "space_info",
+        "super_squash_history",
+        "unlike",
+        "update_collection_item",
+        "update_collection_metadata",
+        "update_inference_endpoint",
+        "update_repo_visibility",
+        "upload_file",
+        "upload_folder",
+        "whoami",
+    ],
+    "hf_file_system": [
+        "HfFileSystem",
+        "HfFileSystemFile",
+        "HfFileSystemResolvedPath",
+        "HfFileSystemStreamFile",
+    ],
+    "hub_mixin": [
+        "ModelHubMixin",
+        "PyTorchModelHubMixin",
+    ],
+    "inference._client": [
+        "InferenceClient",
+        "InferenceTimeoutError",
+    ],
+    "inference._generated._async_client": [
+        "AsyncInferenceClient",
+    ],
+    "inference._generated.types": [
+        "AudioClassificationInput",
+        "AudioClassificationOutputElement",
+        "AudioClassificationParameters",
+        "AudioToAudioInput",
+        "AudioToAudioOutputElement",
+        "AutomaticSpeechRecognitionGenerationParameters",
+        "AutomaticSpeechRecognitionInput",
+        "AutomaticSpeechRecognitionOutput",
+        "AutomaticSpeechRecognitionOutputChunk",
+        "AutomaticSpeechRecognitionParameters",
+        "ChatCompletionInput",
+        "ChatCompletionInputMessage",
+        "ChatCompletionOutput",
+        "ChatCompletionOutputChoice",
+        "ChatCompletionOutputChoiceMessage",
+        "ChatCompletionStreamOutput",
+        "ChatCompletionStreamOutputChoice",
+        "ChatCompletionStreamOutputDelta",
+        "DepthEstimationInput",
+        "DepthEstimationOutput",
+        "DocumentQuestionAnsweringInput",
+        "DocumentQuestionAnsweringInputData",
+        "DocumentQuestionAnsweringOutputElement",
+        "DocumentQuestionAnsweringParameters",
+        "FeatureExtractionInput",
+        "FillMaskInput",
+        "FillMaskOutputElement",
+        "FillMaskParameters",
+        "ImageClassificationInput",
+        "ImageClassificationOutputElement",
+        "ImageClassificationParameters",
+        "ImageSegmentationInput",
+        "ImageSegmentationOutputElement",
+        "ImageSegmentationParameters",
+        "ImageToImageInput",
+        "ImageToImageOutput",
+        "ImageToImageParameters",
+        "ImageToImageTargetSize",
+        "ImageToTextGenerationParameters",
+        "ImageToTextInput",
+        "ImageToTextOutput",
+        "ImageToTextParameters",
+        "ObjectDetectionBoundingBox",
+        "ObjectDetectionInput",
+        "ObjectDetectionOutputElement",
+        "ObjectDetectionParameters",
+        "QuestionAnsweringInput",
+        "QuestionAnsweringInputData",
+        "QuestionAnsweringOutputElement",
+        "QuestionAnsweringParameters",
+        "SentenceSimilarityInput",
+        "SentenceSimilarityInputData",
+        "SummarizationGenerationParameters",
+        "SummarizationInput",
+        "SummarizationOutput",
+        "TableQuestionAnsweringInput",
+        "TableQuestionAnsweringInputData",
+        "TableQuestionAnsweringOutputElement",
+        "Text2TextGenerationInput",
+        "Text2TextGenerationOutput",
+        "Text2TextGenerationParameters",
+        "TextClassificationInput",
+        "TextClassificationOutputElement",
+        "TextClassificationParameters",
+        "TextGenerationInput",
+        "TextGenerationOutput",
+        "TextGenerationOutputDetails",
+        "TextGenerationOutputSequenceDetails",
+        "TextGenerationOutputToken",
+        "TextGenerationParameters",
+        "TextGenerationPrefillToken",
+        "TextGenerationStreamDetails",
+        "TextGenerationStreamOutput",
+        "TextToAudioGenerationParameters",
+        "TextToAudioInput",
+        "TextToAudioOutput",
+        "TextToAudioParameters",
+        "TextToImageInput",
+        "TextToImageOutput",
+        "TextToImageParameters",
+        "TextToImageTargetSize",
+        "TokenClassificationInput",
+        "TokenClassificationOutputElement",
+        "TokenClassificationParameters",
+        "TranslationGenerationParameters",
+        "TranslationInput",
+        "TranslationOutput",
+        "VideoClassificationInput",
+        "VideoClassificationOutputElement",
+        "VideoClassificationParameters",
+        "VisualQuestionAnsweringInput",
+        "VisualQuestionAnsweringInputData",
+        "VisualQuestionAnsweringOutputElement",
+        "VisualQuestionAnsweringParameters",
+        "ZeroShotClassificationInput",
+        "ZeroShotClassificationInputData",
+        "ZeroShotClassificationOutputElement",
+        "ZeroShotClassificationParameters",
+        "ZeroShotImageClassificationInput",
+        "ZeroShotImageClassificationInputData",
+        "ZeroShotImageClassificationOutputElement",
+        "ZeroShotImageClassificationParameters",
+        "ZeroShotObjectDetectionBoundingBox",
+        "ZeroShotObjectDetectionInput",
+        "ZeroShotObjectDetectionInputData",
+        "ZeroShotObjectDetectionOutputElement",
+    ],
+    "inference_api": [
+        "InferenceApi",
+    ],
+    "keras_mixin": [
+        "KerasModelHubMixin",
+        "from_pretrained_keras",
+        "push_to_hub_keras",
+        "save_pretrained_keras",
+    ],
+    "repocard": [
+        "DatasetCard",
+        "ModelCard",
+        "RepoCard",
+        "SpaceCard",
+        "metadata_eval_result",
+        "metadata_load",
+        "metadata_save",
+        "metadata_update",
+    ],
+    "repocard_data": [
+        "CardData",
+        "DatasetCardData",
+        "EvalResult",
+        "ModelCardData",
+        "SpaceCardData",
+    ],
+    "repository": [
+        "Repository",
+    ],
+    "serialization": [
+        "StateDictSplit",
+        "split_numpy_state_dict_into_shards",
+        "split_state_dict_into_shards_factory",
+        "split_tf_state_dict_into_shards",
+        "split_torch_state_dict_into_shards",
+    ],
+    "utils": [
+        "CacheNotFound",
+        "CachedFileInfo",
+        "CachedRepoInfo",
+        "CachedRevisionInfo",
+        "CorruptedCacheException",
+        "DeleteCacheStrategy",
+        "HFCacheInfo",
+        "HfFolder",
+        "cached_assets_path",
+        "configure_http_backend",
+        "dump_environment_info",
+        "get_session",
+        "get_token",
+        "logging",
+        "scan_cache_dir",
+    ],
+    "utils.endpoint_helpers": [
+        "DatasetFilter",
+        "ModelFilter",
+    ],
+}
+
+
+def _attach(package_name, submodules=None, submod_attrs=None):
+    """Attach lazily loaded submodules, functions, or other attributes.
+
+    Typically, modules import submodules and attributes as follows:
+
+    ```py
+    import mysubmodule
+    import anothersubmodule
+
+    from .foo import someattr
+    ```
+
+    The idea is to replace a package's `__getattr__`, `__dir__`, and
+    `__all__`, such that all imports work exactly the way they would
+    with normal imports, except that the import occurs upon first use.
+
+    The typical way to call this function, replacing the above imports, is:
+
+    ```python
+    __getattr__, __dir__, __all__ = lazy.attach(
+        __name__,
+        ['mysubmodule', 'anothersubmodule'],
+        {'foo': ['someattr']}
+    )
+    ```
+    This functionality requires Python 3.7 or higher.
+
+    Args:
+        package_name (`str`):
+            Typically use `__name__`.
+        submodules (`set`):
+            List of submodules to attach.
+        submod_attrs (`dict`):
+            Dictionary of submodule -> list of attributes / functions.
+            These attributes are imported as they are used.
+
+    Returns:
+        __getattr__, __dir__, __all__
+
+    """
+    if submod_attrs is None:
+        submod_attrs = {}
+
+    if submodules is None:
+        submodules = set()
+    else:
+        submodules = set(submodules)
+
+    attr_to_modules = {attr: mod for mod, attrs in submod_attrs.items() for attr in attrs}
+
+    __all__ = list(submodules | attr_to_modules.keys())
+
+    def __getattr__(name):
+        if name in submodules:
+            return importlib.import_module(f"{package_name}.{name}")
+        elif name in attr_to_modules:
+            submod_path = f"{package_name}.{attr_to_modules[name]}"
+            submod = importlib.import_module(submod_path)
+            attr = getattr(submod, name)
+
+            # If the attribute lives in a file (module) with the same
+            # name as the attribute, ensure that the attribute and *not*
+            # the module is accessible on the package.
+            if name == attr_to_modules[name]:
+                pkg = sys.modules[package_name]
+                pkg.__dict__[name] = attr
+
+            return attr
+        else:
+            raise AttributeError(f"No {package_name} attribute {name}")
+
+    def __dir__():
+        return __all__
+
+    if os.environ.get("EAGER_IMPORT", ""):
+        for attr in set(attr_to_modules.keys()) | submodules:
+            __getattr__(attr)
+
+    return __getattr__, __dir__, list(__all__)
+
+
+__getattr__, __dir__, __all__ = _attach(__name__, submodules=[], submod_attrs=_SUBMOD_ATTRS)
+
+# WARNING: any content below this statement is generated automatically. Any manual edit
+# will be lost when re-generating this file !
+#
+# To update the static imports, please run the following command and commit the changes.
+# ```
+# # Use script
+# python utils/check_static_imports.py --update-file
+#
+# # Or run style on codebase
+# make style
+# ```
+if TYPE_CHECKING:  # pragma: no cover
+    from ._commit_scheduler import CommitScheduler  # noqa: F401
+    from ._inference_endpoints import (
+        InferenceEndpoint,  # noqa: F401
+        InferenceEndpointError,  # noqa: F401
+        InferenceEndpointStatus,  # noqa: F401
+        InferenceEndpointTimeoutError,  # noqa: F401
+        InferenceEndpointType,  # noqa: F401
+    )
+    from ._login import (
+        interpreter_login,  # noqa: F401
+        login,  # noqa: F401
+        logout,  # noqa: F401
+        notebook_login,  # noqa: F401
+    )
+    from ._multi_commits import (
+        MultiCommitException,  # noqa: F401
+        plan_multi_commits,  # noqa: F401
+    )
+    from ._snapshot_download import snapshot_download  # noqa: F401
+    from ._space_api import (
+        SpaceHardware,  # noqa: F401
+        SpaceRuntime,  # noqa: F401
+        SpaceStage,  # noqa: F401
+        SpaceStorage,  # noqa: F401
+        SpaceVariable,  # noqa: F401
+    )
+    from ._tensorboard_logger import HFSummaryWriter  # noqa: F401
+    from ._webhooks_payload import (
+        WebhookPayload,  # noqa: F401
+        WebhookPayloadComment,  # noqa: F401
+        WebhookPayloadDiscussion,  # noqa: F401
+        WebhookPayloadDiscussionChanges,  # noqa: F401
+        WebhookPayloadEvent,  # noqa: F401
+        WebhookPayloadMovedTo,  # noqa: F401
+        WebhookPayloadRepo,  # noqa: F401
+        WebhookPayloadUrl,  # noqa: F401
+        WebhookPayloadWebhook,  # noqa: F401
+    )
+    from ._webhooks_server import (
+        WebhooksServer,  # noqa: F401
+        webhook_endpoint,  # noqa: F401
+    )
+    from .community import (
+        Discussion,  # noqa: F401
+        DiscussionComment,  # noqa: F401
+        DiscussionCommit,  # noqa: F401
+        DiscussionEvent,  # noqa: F401
+        DiscussionStatusChange,  # noqa: F401
+        DiscussionTitleChange,  # noqa: F401
+        DiscussionWithDetails,  # noqa: F401
+    )
+    from .constants import (
+        CONFIG_NAME,  # noqa: F401
+        FLAX_WEIGHTS_NAME,  # noqa: F401
+        HUGGINGFACE_CO_URL_HOME,  # noqa: F401
+        HUGGINGFACE_CO_URL_TEMPLATE,  # noqa: F401
+        PYTORCH_WEIGHTS_NAME,  # noqa: F401
+        REPO_TYPE_DATASET,  # noqa: F401
+        REPO_TYPE_MODEL,  # noqa: F401
+        REPO_TYPE_SPACE,  # noqa: F401
+        TF2_WEIGHTS_NAME,  # noqa: F401
+        TF_WEIGHTS_NAME,  # noqa: F401
+    )
+    from .fastai_utils import (
+        _save_pretrained_fastai,  # noqa: F401
+        from_pretrained_fastai,  # noqa: F401
+        push_to_hub_fastai,  # noqa: F401
+    )
+    from .file_download import (
+        _CACHED_NO_EXIST,  # noqa: F401
+        HfFileMetadata,  # noqa: F401
+        cached_download,  # noqa: F401
+        get_hf_file_metadata,  # noqa: F401
+        hf_hub_download,  # noqa: F401
+        hf_hub_url,  # noqa: F401
+        try_to_load_from_cache,  # noqa: F401
+    )
+    from .hf_api import (
+        Collection,  # noqa: F401
+        CollectionItem,  # noqa: F401
+        CommitInfo,  # noqa: F401
+        CommitOperation,  # noqa: F401
+        CommitOperationAdd,  # noqa: F401
+        CommitOperationCopy,  # noqa: F401
+        CommitOperationDelete,  # noqa: F401
+        GitCommitInfo,  # noqa: F401
+        GitRefInfo,  # noqa: F401
+        GitRefs,  # noqa: F401
+        HfApi,  # noqa: F401
+        RepoUrl,  # noqa: F401
+        User,  # noqa: F401
+        UserLikes,  # noqa: F401
+        accept_access_request,  # noqa: F401
+        add_collection_item,  # noqa: F401
+        add_space_secret,  # noqa: F401
+        add_space_variable,  # noqa: F401
+        cancel_access_request,  # noqa: F401
+        change_discussion_status,  # noqa: F401
+        comment_discussion,  # noqa: F401
+        create_branch,  # noqa: F401
+        create_collection,  # noqa: F401
+        create_commit,  # noqa: F401
+        create_commits_on_pr,  # noqa: F401
+        create_discussion,  # noqa: F401
+        create_inference_endpoint,  # noqa: F401
+        create_pull_request,  # noqa: F401
+        create_repo,  # noqa: F401
+        create_tag,  # noqa: F401
+        dataset_info,  # noqa: F401
+        delete_branch,  # noqa: F401
+        delete_collection,  # noqa: F401
+        delete_collection_item,  # noqa: F401
+        delete_file,  # noqa: F401
+        delete_folder,  # noqa: F401
+        delete_inference_endpoint,  # noqa: F401
+        delete_repo,  # noqa: F401
+        delete_space_secret,  # noqa: F401
+        delete_space_storage,  # noqa: F401
+        delete_space_variable,  # noqa: F401
+        delete_tag,  # noqa: F401
+        duplicate_space,  # noqa: F401
+        edit_discussion_comment,  # noqa: F401
+        file_exists,  # noqa: F401
+        get_collection,  # noqa: F401
+        get_dataset_tags,  # noqa: F401
+        get_discussion_details,  # noqa: F401
+        get_full_repo_name,  # noqa: F401
+        get_inference_endpoint,  # noqa: F401
+        get_model_tags,  # noqa: F401
+        get_paths_info,  # noqa: F401
+        get_repo_discussions,  # noqa: F401
+        get_safetensors_metadata,  # noqa: F401
+        get_space_runtime,  # noqa: F401
+        get_space_variables,  # noqa: F401
+        get_token_permission,  # noqa: F401
+        grant_access,  # noqa: F401
+        like,  # noqa: F401
+        list_accepted_access_requests,  # noqa: F401
+        list_collections,  # noqa: F401
+        list_datasets,  # noqa: F401
+        list_files_info,  # noqa: F401
+        list_inference_endpoints,  # noqa: F401
+        list_liked_repos,  # noqa: F401
+        list_metrics,  # noqa: F401
+        list_models,  # noqa: F401
+        list_pending_access_requests,  # noqa: F401
+        list_rejected_access_requests,  # noqa: F401
+        list_repo_commits,  # noqa: F401
+        list_repo_files,  # noqa: F401
+        list_repo_likers,  # noqa: F401
+        list_repo_refs,  # noqa: F401
+        list_repo_tree,  # noqa: F401
+        list_spaces,  # noqa: F401
+        merge_pull_request,  # noqa: F401
+        model_info,  # noqa: F401
+        move_repo,  # noqa: F401
+        parse_safetensors_file_metadata,  # noqa: F401
+        pause_inference_endpoint,  # noqa: F401
+        pause_space,  # noqa: F401
+        preupload_lfs_files,  # noqa: F401
+        reject_access_request,  # noqa: F401
+        rename_discussion,  # noqa: F401
+        repo_exists,  # noqa: F401
+        repo_info,  # noqa: F401
+        repo_type_and_id_from_hf_id,  # noqa: F401
+        request_space_hardware,  # noqa: F401
+        request_space_storage,  # noqa: F401
+        restart_space,  # noqa: F401
+        resume_inference_endpoint,  # noqa: F401
+        revision_exists,  # noqa: F401
+        run_as_future,  # noqa: F401
+        scale_to_zero_inference_endpoint,  # noqa: F401
+        set_space_sleep_time,  # noqa: F401
+        space_info,  # noqa: F401
+        super_squash_history,  # noqa: F401
+        unlike,  # noqa: F401
+        update_collection_item,  # noqa: F401
+        update_collection_metadata,  # noqa: F401
+        update_inference_endpoint,  # noqa: F401
+        update_repo_visibility,  # noqa: F401
+        upload_file,  # noqa: F401
+        upload_folder,  # noqa: F401
+        whoami,  # noqa: F401
+    )
+    from .hf_file_system import (
+        HfFileSystem,  # noqa: F401
+        HfFileSystemFile,  # noqa: F401
+        HfFileSystemResolvedPath,  # noqa: F401
+        HfFileSystemStreamFile,  # noqa: F401
+    )
+    from .hub_mixin import (
+        ModelHubMixin,  # noqa: F401
+        PyTorchModelHubMixin,  # noqa: F401
+    )
+    from .inference._client import (
+        InferenceClient,  # noqa: F401
+        InferenceTimeoutError,  # noqa: F401
+    )
+    from .inference._generated._async_client import AsyncInferenceClient  # noqa: F401
+    from .inference._generated.types import (
+        AudioClassificationInput,  # noqa: F401
+        AudioClassificationOutputElement,  # noqa: F401
+        AudioClassificationParameters,  # noqa: F401
+        AudioToAudioInput,  # noqa: F401
+        AudioToAudioOutputElement,  # noqa: F401
+        AutomaticSpeechRecognitionGenerationParameters,  # noqa: F401
+        AutomaticSpeechRecognitionInput,  # noqa: F401
+        AutomaticSpeechRecognitionOutput,  # noqa: F401
+        AutomaticSpeechRecognitionOutputChunk,  # noqa: F401
+        AutomaticSpeechRecognitionParameters,  # noqa: F401
+        ChatCompletionInput,  # noqa: F401
+        ChatCompletionInputMessage,  # noqa: F401
+        ChatCompletionOutput,  # noqa: F401
+        ChatCompletionOutputChoice,  # noqa: F401
+        ChatCompletionOutputChoiceMessage,  # noqa: F401
+        ChatCompletionStreamOutput,  # noqa: F401
+        ChatCompletionStreamOutputChoice,  # noqa: F401
+        ChatCompletionStreamOutputDelta,  # noqa: F401
+        DepthEstimationInput,  # noqa: F401
+        DepthEstimationOutput,  # noqa: F401
+        DocumentQuestionAnsweringInput,  # noqa: F401
+        DocumentQuestionAnsweringInputData,  # noqa: F401
+        DocumentQuestionAnsweringOutputElement,  # noqa: F401
+        DocumentQuestionAnsweringParameters,  # noqa: F401
+        FeatureExtractionInput,  # noqa: F401
+        FillMaskInput,  # noqa: F401
+        FillMaskOutputElement,  # noqa: F401
+        FillMaskParameters,  # noqa: F401
+        ImageClassificationInput,  # noqa: F401
+        ImageClassificationOutputElement,  # noqa: F401
+        ImageClassificationParameters,  # noqa: F401
+        ImageSegmentationInput,  # noqa: F401
+        ImageSegmentationOutputElement,  # noqa: F401
+        ImageSegmentationParameters,  # noqa: F401
+        ImageToImageInput,  # noqa: F401
+        ImageToImageOutput,  # noqa: F401
+        ImageToImageParameters,  # noqa: F401
+        ImageToImageTargetSize,  # noqa: F401
+        ImageToTextGenerationParameters,  # noqa: F401
+        ImageToTextInput,  # noqa: F401
+        ImageToTextOutput,  # noqa: F401
+        ImageToTextParameters,  # noqa: F401
+        ObjectDetectionBoundingBox,  # noqa: F401
+        ObjectDetectionInput,  # noqa: F401
+        ObjectDetectionOutputElement,  # noqa: F401
+        ObjectDetectionParameters,  # noqa: F401
+        QuestionAnsweringInput,  # noqa: F401
+        QuestionAnsweringInputData,  # noqa: F401
+        QuestionAnsweringOutputElement,  # noqa: F401
+        QuestionAnsweringParameters,  # noqa: F401
+        SentenceSimilarityInput,  # noqa: F401
+        SentenceSimilarityInputData,  # noqa: F401
+        SummarizationGenerationParameters,  # noqa: F401
+        SummarizationInput,  # noqa: F401
+        SummarizationOutput,  # noqa: F401
+        TableQuestionAnsweringInput,  # noqa: F401
+        TableQuestionAnsweringInputData,  # noqa: F401
+        TableQuestionAnsweringOutputElement,  # noqa: F401
+        Text2TextGenerationInput,  # noqa: F401
+        Text2TextGenerationOutput,  # noqa: F401
+        Text2TextGenerationParameters,  # noqa: F401
+        TextClassificationInput,  # noqa: F401
+        TextClassificationOutputElement,  # noqa: F401
+        TextClassificationParameters,  # noqa: F401
+        TextGenerationInput,  # noqa: F401
+        TextGenerationOutput,  # noqa: F401
+        TextGenerationOutputDetails,  # noqa: F401
+        TextGenerationOutputSequenceDetails,  # noqa: F401
+        TextGenerationOutputToken,  # noqa: F401
+        TextGenerationParameters,  # noqa: F401
+        TextGenerationPrefillToken,  # noqa: F401
+        TextGenerationStreamDetails,  # noqa: F401
+        TextGenerationStreamOutput,  # noqa: F401
+        TextToAudioGenerationParameters,  # noqa: F401
+        TextToAudioInput,  # noqa: F401
+        TextToAudioOutput,  # noqa: F401
+        TextToAudioParameters,  # noqa: F401
+        TextToImageInput,  # noqa: F401
+        TextToImageOutput,  # noqa: F401
+        TextToImageParameters,  # noqa: F401
+        TextToImageTargetSize,  # noqa: F401
+        TokenClassificationInput,  # noqa: F401
+        TokenClassificationOutputElement,  # noqa: F401
+        TokenClassificationParameters,  # noqa: F401
+        TranslationGenerationParameters,  # noqa: F401
+        TranslationInput,  # noqa: F401
+        TranslationOutput,  # noqa: F401
+        VideoClassificationInput,  # noqa: F401
+        VideoClassificationOutputElement,  # noqa: F401
+        VideoClassificationParameters,  # noqa: F401
+        VisualQuestionAnsweringInput,  # noqa: F401
+        VisualQuestionAnsweringInputData,  # noqa: F401
+        VisualQuestionAnsweringOutputElement,  # noqa: F401
+        VisualQuestionAnsweringParameters,  # noqa: F401
+        ZeroShotClassificationInput,  # noqa: F401
+        ZeroShotClassificationInputData,  # noqa: F401
+        ZeroShotClassificationOutputElement,  # noqa: F401
+        ZeroShotClassificationParameters,  # noqa: F401
+        ZeroShotImageClassificationInput,  # noqa: F401
+        ZeroShotImageClassificationInputData,  # noqa: F401
+        ZeroShotImageClassificationOutputElement,  # noqa: F401
+        ZeroShotImageClassificationParameters,  # noqa: F401
+        ZeroShotObjectDetectionBoundingBox,  # noqa: F401
+        ZeroShotObjectDetectionInput,  # noqa: F401
+        ZeroShotObjectDetectionInputData,  # noqa: F401
+        ZeroShotObjectDetectionOutputElement,  # noqa: F401
+    )
+    from .inference_api import InferenceApi  # noqa: F401
+    from .keras_mixin import (
+        KerasModelHubMixin,  # noqa: F401
+        from_pretrained_keras,  # noqa: F401
+        push_to_hub_keras,  # noqa: F401
+        save_pretrained_keras,  # noqa: F401
+    )
+    from .repocard import (
+        DatasetCard,  # noqa: F401
+        ModelCard,  # noqa: F401
+        RepoCard,  # noqa: F401
+        SpaceCard,  # noqa: F401
+        metadata_eval_result,  # noqa: F401
+        metadata_load,  # noqa: F401
+        metadata_save,  # noqa: F401
+        metadata_update,  # noqa: F401
+    )
+    from .repocard_data import (
+        CardData,  # noqa: F401
+        DatasetCardData,  # noqa: F401
+        EvalResult,  # noqa: F401
+        ModelCardData,  # noqa: F401
+        SpaceCardData,  # noqa: F401
+    )
+    from .repository import Repository  # noqa: F401
+    from .serialization import (
+        StateDictSplit,  # noqa: F401
+        split_numpy_state_dict_into_shards,  # noqa: F401
+        split_state_dict_into_shards_factory,  # noqa: F401
+        split_tf_state_dict_into_shards,  # noqa: F401
+        split_torch_state_dict_into_shards,  # noqa: F401
+    )
+    from .utils import (
+        CachedFileInfo,  # noqa: F401
+        CachedRepoInfo,  # noqa: F401
+        CachedRevisionInfo,  # noqa: F401
+        CacheNotFound,  # noqa: F401
+        CorruptedCacheException,  # noqa: F401
+        DeleteCacheStrategy,  # noqa: F401
+        HFCacheInfo,  # noqa: F401
+        HfFolder,  # noqa: F401
+        cached_assets_path,  # noqa: F401
+        configure_http_backend,  # noqa: F401
+        dump_environment_info,  # noqa: F401
+        get_session,  # noqa: F401
+        get_token,  # noqa: F401
+        logging,  # noqa: F401
+        scan_cache_dir,  # noqa: F401
+    )
+    from .utils.endpoint_helpers import (
+        DatasetFilter,  # noqa: F401
+        ModelFilter,  # noqa: F401
+    )
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..701b8a81ab5bf24c1f89c4b50bd1593ddd98253b
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/_commit_api.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/_commit_api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..df409ef6f8cb2eb88e07edb65cc730be24cfb9fe
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/_commit_api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/_commit_scheduler.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/_commit_scheduler.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..76e9241e37a36ca8f727ffcc860da37621d07735
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/_commit_scheduler.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/_inference_endpoints.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/_inference_endpoints.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..383be3a5bd93bc5bbf2bd5e974736629b2b2924c
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/_inference_endpoints.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/_login.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/_login.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..78d075add92d90f041e1758cea724de4ef72f0f9
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/_login.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/_multi_commits.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/_multi_commits.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0bf2471c8c29c82790be581497a520d398941850
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/_multi_commits.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/_snapshot_download.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/_snapshot_download.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fff10896e218eef4188a81c9acc3ef53eff5b162
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/_snapshot_download.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/_space_api.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/_space_api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..84e73d3eb188ba24c39a6269c739d37ebe894f5f
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/_space_api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/_tensorboard_logger.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/_tensorboard_logger.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..85b1ffb9b6d4f2e27a2b84456d2a6ede123b22d8
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/_tensorboard_logger.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/_webhooks_payload.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/_webhooks_payload.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cfc58c6eaf0df06c577521c86f8b970d94a7634e
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/_webhooks_payload.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/_webhooks_server.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/_webhooks_server.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b53fc794464198be3bd421b8c69437c754b16ac
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/_webhooks_server.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/community.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/community.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b23f632dd22c7b25fb2ef447ed36d8fae6ca97e1
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/community.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/constants.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/constants.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..754a3943b4c522b87cc449f282975809ba4aced3
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/constants.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/errors.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/errors.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..50ea3949ea75efd4793344b7f1ce1a1773a41250
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/errors.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/fastai_utils.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/fastai_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fbb9e2a543f938c4d563be977f778710e1ff9b29
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/fastai_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/file_download.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/file_download.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a4a54c6f64c7b924ca4e733df000c20dbee1bf9e
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/file_download.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/hf_api.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/hf_api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..616fe42b00ff90f00e7ded8f319b1571e2726792
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/hf_api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/hf_file_system.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/hf_file_system.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c48284fa97840954600c0c758b6dd459dae49f70
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/hf_file_system.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/hub_mixin.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/hub_mixin.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ec55b351e53208247334c8d3436109ae0afcc2fa
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/hub_mixin.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/inference_api.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/inference_api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..78844f45a3d600f8ab4f002f23abbdfa338ebe22
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/inference_api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/keras_mixin.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/keras_mixin.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e403a3896293ed0cfee0228b3ab71e183c4735a9
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/keras_mixin.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/lfs.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/lfs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d76648c560c4762c39c87a2c03081e1d9d6e908d
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/lfs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/repocard.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/repocard.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e5ff54889fa7ce92a60edb75470e252a73042782
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/repocard.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/repocard_data.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/repocard_data.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6c99a3342a07cc522bc12dae4a68b329c37ce3ab
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/repocard_data.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/__pycache__/repository.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/__pycache__/repository.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dc006eff65dc5264dc69482b0e8e9b012f182cf2
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/__pycache__/repository.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/_commit_api.py b/llm/Lib/site-packages/huggingface_hub/_commit_api.py
new file mode 100644
index 0000000000000000000000000000000000000000..b807106bab7c5881982502f343b5ebe111f61511
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/_commit_api.py
@@ -0,0 +1,698 @@
+"""
+Type definitions and utilities for the `create_commit` API
+"""
+
+import base64
+import io
+import os
+import warnings
+from collections import defaultdict
+from contextlib import contextmanager
+from dataclasses import dataclass, field
+from itertools import groupby
+from pathlib import Path, PurePosixPath
+from typing import TYPE_CHECKING, Any, BinaryIO, Dict, Iterable, Iterator, List, Literal, Optional, Tuple, Union
+
+from tqdm.contrib.concurrent import thread_map
+
+from huggingface_hub import get_session
+
+from .constants import ENDPOINT, HF_HUB_ENABLE_HF_TRANSFER
+from .file_download import hf_hub_url
+from .lfs import UploadInfo, lfs_upload, post_lfs_batch_info
+from .utils import (
+    EntryNotFoundError,
+    chunk_iterable,
+    hf_raise_for_status,
+    logging,
+    tqdm_stream_file,
+    validate_hf_hub_args,
+)
+from .utils import tqdm as hf_tqdm
+
+
+if TYPE_CHECKING:
+    from .hf_api import RepoFile
+
+
+logger = logging.get_logger(__name__)
+
+
+UploadMode = Literal["lfs", "regular"]
+
+# Max is 1,000 per request on the Hub for HfApi.get_paths_info
+# Otherwise we get:
+# HfHubHTTPError: 413 Client Error: Payload Too Large for url: https://huggingface.co/api/datasets/xxx (Request ID: xxx)\n\ntoo many parameters
+# See https://github.com/huggingface/huggingface_hub/issues/1503
+FETCH_LFS_BATCH_SIZE = 500
+
+
+@dataclass
+class CommitOperationDelete:
+    """
+    Data structure holding necessary info to delete a file or a folder from a repository
+    on the Hub.
+
+    Args:
+        path_in_repo (`str`):
+            Relative filepath in the repo, for example: `"checkpoints/1fec34a/weights.bin"`
+            for a file or `"checkpoints/1fec34a/"` for a folder.
+        is_folder (`bool` or `Literal["auto"]`, *optional*)
+            Whether the Delete Operation applies to a folder or not. If "auto", the path
+            type (file or folder) is guessed automatically by looking if path ends with
+            a "/" (folder) or not (file). To explicitly set the path type, you can set
+            `is_folder=True` or `is_folder=False`.
+    """
+
+    path_in_repo: str
+    is_folder: Union[bool, Literal["auto"]] = "auto"
+
+    def __post_init__(self):
+        self.path_in_repo = _validate_path_in_repo(self.path_in_repo)
+
+        if self.is_folder == "auto":
+            self.is_folder = self.path_in_repo.endswith("/")
+        if not isinstance(self.is_folder, bool):
+            raise ValueError(
+                f"Wrong value for `is_folder`. Must be one of [`True`, `False`, `'auto'`]. Got '{self.is_folder}'."
+            )
+
+
+@dataclass
+class CommitOperationCopy:
+    """
+    Data structure holding necessary info to copy a file in a repository on the Hub.
+
+    Limitations:
+      - Only LFS files can be copied. To copy a regular file, you need to download it locally and re-upload it
+      - Cross-repository copies are not supported.
+
+    Note: you can combine a [`CommitOperationCopy`] and a [`CommitOperationDelete`] to rename an LFS file on the Hub.
+
+    Args:
+        src_path_in_repo (`str`):
+            Relative filepath in the repo of the file to be copied, e.g. `"checkpoints/1fec34a/weights.bin"`.
+        path_in_repo (`str`):
+            Relative filepath in the repo where to copy the file, e.g. `"checkpoints/1fec34a/weights_copy.bin"`.
+        src_revision (`str`, *optional*):
+            The git revision of the file to be copied. Can be any valid git revision.
+            Default to the target commit revision.
+    """
+
+    src_path_in_repo: str
+    path_in_repo: str
+    src_revision: Optional[str] = None
+
+    def __post_init__(self):
+        self.src_path_in_repo = _validate_path_in_repo(self.src_path_in_repo)
+        self.path_in_repo = _validate_path_in_repo(self.path_in_repo)
+
+
+@dataclass
+class CommitOperationAdd:
+    """
+    Data structure holding necessary info to upload a file to a repository on the Hub.
+
+    Args:
+        path_in_repo (`str`):
+            Relative filepath in the repo, for example: `"checkpoints/1fec34a/weights.bin"`
+        path_or_fileobj (`str`, `Path`, `bytes`, or `BinaryIO`):
+            Either:
+            - a path to a local file (as `str` or `pathlib.Path`) to upload
+            - a buffer of bytes (`bytes`) holding the content of the file to upload
+            - a "file object" (subclass of `io.BufferedIOBase`), typically obtained
+                with `open(path, "rb")`. It must support `seek()` and `tell()` methods.
+
+    Raises:
+        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If `path_or_fileobj` is not one of `str`, `Path`, `bytes` or `io.BufferedIOBase`.
+        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If `path_or_fileobj` is a `str` or `Path` but not a path to an existing file.
+        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If `path_or_fileobj` is a `io.BufferedIOBase` but it doesn't support both
+            `seek()` and `tell()`.
+    """
+
+    path_in_repo: str
+    path_or_fileobj: Union[str, Path, bytes, BinaryIO]
+    upload_info: UploadInfo = field(init=False, repr=False)
+
+    # Internal attributes
+
+    # set to "lfs" or "regular" once known
+    _upload_mode: Optional[UploadMode] = field(init=False, repr=False, default=None)
+
+    # set to True if .gitignore rules prevent the file from being uploaded as LFS
+    # (server-side check)
+    _should_ignore: Optional[bool] = field(init=False, repr=False, default=None)
+
+    # set to True once the file has been uploaded as LFS
+    _is_uploaded: bool = field(init=False, repr=False, default=False)
+
+    # set to True once the file has been committed
+    _is_committed: bool = field(init=False, repr=False, default=False)
+
+    def __post_init__(self) -> None:
+        """Validates `path_or_fileobj` and compute `upload_info`."""
+        self.path_in_repo = _validate_path_in_repo(self.path_in_repo)
+
+        # Validate `path_or_fileobj` value
+        if isinstance(self.path_or_fileobj, Path):
+            self.path_or_fileobj = str(self.path_or_fileobj)
+        if isinstance(self.path_or_fileobj, str):
+            path_or_fileobj = os.path.normpath(os.path.expanduser(self.path_or_fileobj))
+            if not os.path.isfile(path_or_fileobj):
+                raise ValueError(f"Provided path: '{path_or_fileobj}' is not a file on the local file system")
+        elif not isinstance(self.path_or_fileobj, (io.BufferedIOBase, bytes)):
+            # ^^ Inspired from: https://stackoverflow.com/questions/44584829/how-to-determine-if-file-is-opened-in-binary-or-text-mode
+            raise ValueError(
+                "path_or_fileobj must be either an instance of str, bytes or"
+                " io.BufferedIOBase. If you passed a file-like object, make sure it is"
+                " in binary mode."
+            )
+        if isinstance(self.path_or_fileobj, io.BufferedIOBase):
+            try:
+                self.path_or_fileobj.tell()
+                self.path_or_fileobj.seek(0, os.SEEK_CUR)
+            except (OSError, AttributeError) as exc:
+                raise ValueError(
+                    "path_or_fileobj is a file-like object but does not implement seek() and tell()"
+                ) from exc
+
+        # Compute "upload_info" attribute
+        if isinstance(self.path_or_fileobj, str):
+            self.upload_info = UploadInfo.from_path(self.path_or_fileobj)
+        elif isinstance(self.path_or_fileobj, bytes):
+            self.upload_info = UploadInfo.from_bytes(self.path_or_fileobj)
+        else:
+            self.upload_info = UploadInfo.from_fileobj(self.path_or_fileobj)
+
+    @contextmanager
+    def as_file(self, with_tqdm: bool = False) -> Iterator[BinaryIO]:
+        """
+        A context manager that yields a file-like object allowing to read the underlying
+        data behind `path_or_fileobj`.
+
+        Args:
+            with_tqdm (`bool`, *optional*, defaults to `False`):
+                If True, iterating over the file object will display a progress bar. Only
+                works if the file-like object is a path to a file. Pure bytes and buffers
+                are not supported.
+
+        Example:
+
+        ```python
+        >>> operation = CommitOperationAdd(
+        ...        path_in_repo="remote/dir/weights.h5",
+        ...        path_or_fileobj="./local/weights.h5",
+        ... )
+        CommitOperationAdd(path_in_repo='remote/dir/weights.h5', path_or_fileobj='./local/weights.h5')
+
+        >>> with operation.as_file() as file:
+        ...     content = file.read()
+
+        >>> with operation.as_file(with_tqdm=True) as file:
+        ...     while True:
+        ...         data = file.read(1024)
+        ...         if not data:
+        ...              break
+        config.json: 100%|█████████████████████████| 8.19k/8.19k [00:02<00:00, 3.72kB/s]
+
+        >>> with operation.as_file(with_tqdm=True) as file:
+        ...     requests.put(..., data=file)
+        config.json: 100%|█████████████████████████| 8.19k/8.19k [00:02<00:00, 3.72kB/s]
+        ```
+        """
+        if isinstance(self.path_or_fileobj, str) or isinstance(self.path_or_fileobj, Path):
+            if with_tqdm:
+                with tqdm_stream_file(self.path_or_fileobj) as file:
+                    yield file
+            else:
+                with open(self.path_or_fileobj, "rb") as file:
+                    yield file
+        elif isinstance(self.path_or_fileobj, bytes):
+            yield io.BytesIO(self.path_or_fileobj)
+        elif isinstance(self.path_or_fileobj, io.BufferedIOBase):
+            prev_pos = self.path_or_fileobj.tell()
+            yield self.path_or_fileobj
+            self.path_or_fileobj.seek(prev_pos, io.SEEK_SET)
+
+    def b64content(self) -> bytes:
+        """
+        The base64-encoded content of `path_or_fileobj`
+
+        Returns: `bytes`
+        """
+        with self.as_file() as file:
+            return base64.b64encode(file.read())
+
+
+def _validate_path_in_repo(path_in_repo: str) -> str:
+    # Validate `path_in_repo` value to prevent a server-side issue
+    if path_in_repo.startswith("/"):
+        path_in_repo = path_in_repo[1:]
+    if path_in_repo == "." or path_in_repo == ".." or path_in_repo.startswith("../"):
+        raise ValueError(f"Invalid `path_in_repo` in CommitOperation: '{path_in_repo}'")
+    if path_in_repo.startswith("./"):
+        path_in_repo = path_in_repo[2:]
+    if any(part == ".git" for part in path_in_repo.split("/")):
+        raise ValueError(
+            "Invalid `path_in_repo` in CommitOperation: cannot update files under a '.git/' folder (path:"
+            f" '{path_in_repo}')."
+        )
+    return path_in_repo
+
+
+CommitOperation = Union[CommitOperationAdd, CommitOperationCopy, CommitOperationDelete]
+
+
+def _warn_on_overwriting_operations(operations: List[CommitOperation]) -> None:
+    """
+    Warn user when a list of operations is expected to overwrite itself in a single
+    commit.
+
+    Rules:
+    - If a filepath is updated by multiple `CommitOperationAdd` operations, a warning
+      message is triggered.
+    - If a filepath is updated at least once by a `CommitOperationAdd` and then deleted
+      by a `CommitOperationDelete`, a warning is triggered.
+    - If a `CommitOperationDelete` deletes a filepath that is then updated by a
+      `CommitOperationAdd`, no warning is triggered. This is usually useless (no need to
+      delete before upload) but can happen if a user deletes an entire folder and then
+      add new files to it.
+    """
+    nb_additions_per_path: Dict[str, int] = defaultdict(int)
+    for operation in operations:
+        path_in_repo = operation.path_in_repo
+        if isinstance(operation, CommitOperationAdd):
+            if nb_additions_per_path[path_in_repo] > 0:
+                warnings.warn(
+                    "About to update multiple times the same file in the same commit:"
+                    f" '{path_in_repo}'. This can cause undesired inconsistencies in"
+                    " your repo."
+                )
+            nb_additions_per_path[path_in_repo] += 1
+            for parent in PurePosixPath(path_in_repo).parents:
+                # Also keep track of number of updated files per folder
+                # => warns if deleting a folder overwrite some contained files
+                nb_additions_per_path[str(parent)] += 1
+        if isinstance(operation, CommitOperationDelete):
+            if nb_additions_per_path[str(PurePosixPath(path_in_repo))] > 0:
+                if operation.is_folder:
+                    warnings.warn(
+                        "About to delete a folder containing files that have just been"
+                        f" updated within the same commit: '{path_in_repo}'. This can"
+                        " cause undesired inconsistencies in your repo."
+                    )
+                else:
+                    warnings.warn(
+                        "About to delete a file that have just been updated within the"
+                        f" same commit: '{path_in_repo}'. This can cause undesired"
+                        " inconsistencies in your repo."
+                    )
+
+
+@validate_hf_hub_args
+def _upload_lfs_files(
+    *,
+    additions: List[CommitOperationAdd],
+    repo_type: str,
+    repo_id: str,
+    headers: Dict[str, str],
+    endpoint: Optional[str] = None,
+    num_threads: int = 5,
+    revision: Optional[str] = None,
+):
+    """
+    Uploads the content of `additions` to the Hub using the large file storage protocol.
+
+    Relevant external documentation:
+        - LFS Batch API: https://github.com/git-lfs/git-lfs/blob/main/docs/api/batch.md
+
+    Args:
+        additions (`List` of `CommitOperationAdd`):
+            The files to be uploaded
+        repo_type (`str`):
+            Type of the repo to upload to: `"model"`, `"dataset"` or `"space"`.
+        repo_id (`str`):
+            A namespace (user or an organization) and a repo name separated
+            by a `/`.
+        headers (`Dict[str, str]`):
+            Headers to use for the request, including authorization headers and user agent.
+        num_threads (`int`, *optional*):
+            The number of concurrent threads to use when uploading. Defaults to 5.
+        revision (`str`, *optional*):
+            The git revision to upload to.
+
+    Raises: `RuntimeError` if an upload failed for any reason
+
+    Raises: `ValueError` if the server returns malformed responses
+
+    Raises: `requests.HTTPError` if the LFS batch endpoint returned an HTTP
+        error
+
+    """
+    # Step 1: retrieve upload instructions from the LFS batch endpoint.
+    #         Upload instructions are retrieved by chunk of 256 files to avoid reaching
+    #         the payload limit.
+    batch_actions: List[Dict] = []
+    for chunk in chunk_iterable(additions, chunk_size=256):
+        batch_actions_chunk, batch_errors_chunk = post_lfs_batch_info(
+            upload_infos=[op.upload_info for op in chunk],
+            repo_id=repo_id,
+            repo_type=repo_type,
+            revision=revision,
+            endpoint=endpoint,
+            headers=headers,
+            token=None,  # already passed in 'headers'
+        )
+
+        # If at least 1 error, we do not retrieve information for other chunks
+        if batch_errors_chunk:
+            message = "\n".join(
+                [
+                    f'Encountered error for file with OID {err.get("oid")}: `{err.get("error", {}).get("message")}'
+                    for err in batch_errors_chunk
+                ]
+            )
+            raise ValueError(f"LFS batch endpoint returned errors:\n{message}")
+
+        batch_actions += batch_actions_chunk
+    oid2addop = {add_op.upload_info.sha256.hex(): add_op for add_op in additions}
+
+    # Step 2: ignore files that have already been uploaded
+    filtered_actions = []
+    for action in batch_actions:
+        if action.get("actions") is None:
+            logger.debug(
+                f"Content of file {oid2addop[action['oid']].path_in_repo} is already"
+                " present upstream - skipping upload."
+            )
+        else:
+            filtered_actions.append(action)
+
+    if len(filtered_actions) == 0:
+        logger.debug("No LFS files to upload.")
+        return
+
+    # Step 3: upload files concurrently according to these instructions
+    def _wrapped_lfs_upload(batch_action) -> None:
+        try:
+            operation = oid2addop[batch_action["oid"]]
+            lfs_upload(operation=operation, lfs_batch_action=batch_action, headers=headers, endpoint=endpoint)
+        except Exception as exc:
+            raise RuntimeError(f"Error while uploading '{operation.path_in_repo}' to the Hub.") from exc
+
+    if HF_HUB_ENABLE_HF_TRANSFER:
+        logger.debug(f"Uploading {len(filtered_actions)} LFS files to the Hub using `hf_transfer`.")
+        for action in hf_tqdm(filtered_actions):
+            _wrapped_lfs_upload(action)
+    elif len(filtered_actions) == 1:
+        logger.debug("Uploading 1 LFS file to the Hub")
+        _wrapped_lfs_upload(filtered_actions[0])
+    else:
+        logger.debug(
+            f"Uploading {len(filtered_actions)} LFS files to the Hub using up to {num_threads} threads concurrently"
+        )
+        thread_map(
+            _wrapped_lfs_upload,
+            filtered_actions,
+            desc=f"Upload {len(filtered_actions)} LFS files",
+            max_workers=num_threads,
+            tqdm_class=hf_tqdm,
+        )
+
+
+def _validate_preupload_info(preupload_info: dict):
+    files = preupload_info.get("files")
+    if not isinstance(files, list):
+        raise ValueError("preupload_info is improperly formatted")
+    for file_info in files:
+        if not (
+            isinstance(file_info, dict)
+            and isinstance(file_info.get("path"), str)
+            and isinstance(file_info.get("uploadMode"), str)
+            and (file_info["uploadMode"] in ("lfs", "regular"))
+        ):
+            raise ValueError("preupload_info is improperly formatted:")
+    return preupload_info
+
+
+@validate_hf_hub_args
+def _fetch_upload_modes(
+    additions: Iterable[CommitOperationAdd],
+    repo_type: str,
+    repo_id: str,
+    headers: Dict[str, str],
+    revision: str,
+    endpoint: Optional[str] = None,
+    create_pr: bool = False,
+    gitignore_content: Optional[str] = None,
+) -> None:
+    """
+    Requests the Hub "preupload" endpoint to determine whether each input file should be uploaded as a regular git blob
+    or as git LFS blob. Input `additions` are mutated in-place with the upload mode.
+
+    Args:
+        additions (`Iterable` of :class:`CommitOperationAdd`):
+            Iterable of :class:`CommitOperationAdd` describing the files to
+            upload to the Hub.
+        repo_type (`str`):
+            Type of the repo to upload to: `"model"`, `"dataset"` or `"space"`.
+        repo_id (`str`):
+            A namespace (user or an organization) and a repo name separated
+            by a `/`.
+        headers (`Dict[str, str]`):
+            Headers to use for the request, including authorization headers and user agent.
+        revision (`str`):
+            The git revision to upload the files to. Can be any valid git revision.
+        gitignore_content (`str`, *optional*):
+            The content of the `.gitignore` file to know which files should be ignored. The order of priority
+            is to first check if `gitignore_content` is passed, then check if the `.gitignore` file is present
+            in the list of files to commit and finally default to the `.gitignore` file already hosted on the Hub
+            (if any).
+    Raises:
+        [`~utils.HfHubHTTPError`]
+            If the Hub API returned an error.
+        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If the Hub API response is improperly formatted.
+    """
+    endpoint = endpoint if endpoint is not None else ENDPOINT
+
+    # Fetch upload mode (LFS or regular) chunk by chunk.
+    upload_modes: Dict[str, UploadMode] = {}
+    should_ignore_info: Dict[str, bool] = {}
+
+    for chunk in chunk_iterable(additions, 256):
+        payload: Dict = {
+            "files": [
+                {
+                    "path": op.path_in_repo,
+                    "sample": base64.b64encode(op.upload_info.sample).decode("ascii"),
+                    "size": op.upload_info.size,
+                    "sha": op.upload_info.sha256.hex(),
+                }
+                for op in chunk
+            ]
+        }
+        if gitignore_content is not None:
+            payload["gitIgnore"] = gitignore_content
+
+        resp = get_session().post(
+            f"{endpoint}/api/{repo_type}s/{repo_id}/preupload/{revision}",
+            json=payload,
+            headers=headers,
+            params={"create_pr": "1"} if create_pr else None,
+        )
+        hf_raise_for_status(resp)
+        preupload_info = _validate_preupload_info(resp.json())
+        upload_modes.update(**{file["path"]: file["uploadMode"] for file in preupload_info["files"]})
+        should_ignore_info.update(**{file["path"]: file["shouldIgnore"] for file in preupload_info["files"]})
+
+    # Set upload mode for each addition operation
+    for addition in additions:
+        addition._upload_mode = upload_modes[addition.path_in_repo]
+        addition._should_ignore = should_ignore_info[addition.path_in_repo]
+
+    # Empty files cannot be uploaded as LFS (S3 would fail with a 501 Not Implemented)
+    # => empty files are uploaded as "regular" to still allow users to commit them.
+    for addition in additions:
+        if addition.upload_info.size == 0:
+            addition._upload_mode = "regular"
+
+
+@validate_hf_hub_args
+def _fetch_files_to_copy(
+    copies: Iterable[CommitOperationCopy],
+    repo_type: str,
+    repo_id: str,
+    headers: Dict[str, str],
+    revision: str,
+    endpoint: Optional[str] = None,
+) -> Dict[Tuple[str, Optional[str]], Union["RepoFile", bytes]]:
+    """
+    Fetch information about the files to copy.
+
+    For LFS files, we only need their metadata (file size and sha256) while for regular files
+    we need to download the raw content from the Hub.
+
+    Args:
+        copies (`Iterable` of :class:`CommitOperationCopy`):
+            Iterable of :class:`CommitOperationCopy` describing the files to
+            copy on the Hub.
+        repo_type (`str`):
+            Type of the repo to upload to: `"model"`, `"dataset"` or `"space"`.
+        repo_id (`str`):
+            A namespace (user or an organization) and a repo name separated
+            by a `/`.
+        headers (`Dict[str, str]`):
+            Headers to use for the request, including authorization headers and user agent.
+        revision (`str`):
+            The git revision to upload the files to. Can be any valid git revision.
+
+    Returns: `Dict[Tuple[str, Optional[str]], Union[RepoFile, bytes]]]`
+        Key is the file path and revision of the file to copy.
+        Value is the raw content as bytes (for regular files) or the file information as a RepoFile (for LFS files).
+
+    Raises:
+        [`~utils.HfHubHTTPError`]
+            If the Hub API returned an error.
+        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If the Hub API response is improperly formatted.
+    """
+    from .hf_api import HfApi, RepoFolder
+
+    hf_api = HfApi(endpoint=endpoint, headers=headers)
+    files_to_copy: Dict[Tuple[str, Optional[str]], Union["RepoFile", bytes]] = {}
+    for src_revision, operations in groupby(copies, key=lambda op: op.src_revision):
+        operations = list(operations)  # type: ignore
+        paths = [op.src_path_in_repo for op in operations]
+        for offset in range(0, len(paths), FETCH_LFS_BATCH_SIZE):
+            src_repo_files = hf_api.get_paths_info(
+                repo_id=repo_id,
+                paths=paths[offset : offset + FETCH_LFS_BATCH_SIZE],
+                revision=src_revision or revision,
+                repo_type=repo_type,
+            )
+            for src_repo_file in src_repo_files:
+                if isinstance(src_repo_file, RepoFolder):
+                    raise NotImplementedError("Copying a folder is not implemented.")
+                if src_repo_file.lfs:
+                    files_to_copy[(src_repo_file.path, src_revision)] = src_repo_file
+                else:
+                    # TODO: (optimization) download regular files to copy concurrently
+                    url = hf_hub_url(
+                        endpoint=endpoint,
+                        repo_type=repo_type,
+                        repo_id=repo_id,
+                        revision=src_revision or revision,
+                        filename=src_repo_file.path,
+                    )
+                    response = get_session().get(url, headers=headers)
+                    hf_raise_for_status(response)
+                    files_to_copy[(src_repo_file.path, src_revision)] = response.content
+        for operation in operations:
+            if (operation.src_path_in_repo, src_revision) not in files_to_copy:
+                raise EntryNotFoundError(
+                    f"Cannot copy {operation.src_path_in_repo} at revision "
+                    f"{src_revision or revision}: file is missing on repo."
+                )
+    return files_to_copy
+
+
+def _prepare_commit_payload(
+    operations: Iterable[CommitOperation],
+    files_to_copy: Dict[Tuple[str, Optional[str]], Union["RepoFile", bytes]],
+    commit_message: str,
+    commit_description: Optional[str] = None,
+    parent_commit: Optional[str] = None,
+) -> Iterable[Dict[str, Any]]:
+    """
+    Builds the payload to POST to the `/commit` API of the Hub.
+
+    Payload is returned as an iterator so that it can be streamed as a ndjson in the
+    POST request.
+
+    For more information, see:
+        - https://github.com/huggingface/huggingface_hub/issues/1085#issuecomment-1265208073
+        - http://ndjson.org/
+    """
+    commit_description = commit_description if commit_description is not None else ""
+
+    # 1. Send a header item with the commit metadata
+    header_value = {"summary": commit_message, "description": commit_description}
+    if parent_commit is not None:
+        header_value["parentCommit"] = parent_commit
+    yield {"key": "header", "value": header_value}
+
+    nb_ignored_files = 0
+
+    # 2. Send operations, one per line
+    for operation in operations:
+        # Skip ignored files
+        if isinstance(operation, CommitOperationAdd) and operation._should_ignore:
+            logger.debug(f"Skipping file '{operation.path_in_repo}' in commit (ignored by gitignore file).")
+            nb_ignored_files += 1
+            continue
+
+        # 2.a. Case adding a regular file
+        if isinstance(operation, CommitOperationAdd) and operation._upload_mode == "regular":
+            yield {
+                "key": "file",
+                "value": {
+                    "content": operation.b64content().decode(),
+                    "path": operation.path_in_repo,
+                    "encoding": "base64",
+                },
+            }
+        # 2.b. Case adding an LFS file
+        elif isinstance(operation, CommitOperationAdd) and operation._upload_mode == "lfs":
+            yield {
+                "key": "lfsFile",
+                "value": {
+                    "path": operation.path_in_repo,
+                    "algo": "sha256",
+                    "oid": operation.upload_info.sha256.hex(),
+                    "size": operation.upload_info.size,
+                },
+            }
+        # 2.c. Case deleting a file or folder
+        elif isinstance(operation, CommitOperationDelete):
+            yield {
+                "key": "deletedFolder" if operation.is_folder else "deletedFile",
+                "value": {"path": operation.path_in_repo},
+            }
+        # 2.d. Case copying a file or folder
+        elif isinstance(operation, CommitOperationCopy):
+            file_to_copy = files_to_copy[(operation.src_path_in_repo, operation.src_revision)]
+            if isinstance(file_to_copy, bytes):
+                yield {
+                    "key": "file",
+                    "value": {
+                        "content": base64.b64encode(file_to_copy).decode(),
+                        "path": operation.path_in_repo,
+                        "encoding": "base64",
+                    },
+                }
+            elif file_to_copy.lfs:
+                yield {
+                    "key": "lfsFile",
+                    "value": {
+                        "path": operation.path_in_repo,
+                        "algo": "sha256",
+                        "oid": file_to_copy.lfs.sha256,
+                    },
+                }
+            else:
+                raise ValueError(
+                    "Malformed files_to_copy (should be raw file content as bytes or RepoFile objects with LFS info."
+                )
+        # 2.e. Never expected to happen
+        else:
+            raise ValueError(
+                f"Unknown operation to commit. Operation: {operation}. Upload mode:"
+                f" {getattr(operation, '_upload_mode', None)}"
+            )
+
+    if nb_ignored_files > 0:
+        logger.info(f"Skipped {nb_ignored_files} file(s) in commit (ignored by gitignore file).")
diff --git a/llm/Lib/site-packages/huggingface_hub/_commit_scheduler.py b/llm/Lib/site-packages/huggingface_hub/_commit_scheduler.py
new file mode 100644
index 0000000000000000000000000000000000000000..80d8dac7866a4eeef888d36cfbb974aa06a9930b
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/_commit_scheduler.py
@@ -0,0 +1,327 @@
+import atexit
+import logging
+import os
+import time
+from concurrent.futures import Future
+from dataclasses import dataclass
+from io import SEEK_END, SEEK_SET, BytesIO
+from pathlib import Path
+from threading import Lock, Thread
+from typing import Dict, List, Optional, Union
+
+from .hf_api import IGNORE_GIT_FOLDER_PATTERNS, CommitInfo, CommitOperationAdd, HfApi
+from .utils import filter_repo_objects
+
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass(frozen=True)
+class _FileToUpload:
+    """Temporary dataclass to store info about files to upload. Not meant to be used directly."""
+
+    local_path: Path
+    path_in_repo: str
+    size_limit: int
+    last_modified: float
+
+
+class CommitScheduler:
+    """
+    Scheduler to upload a local folder to the Hub at regular intervals (e.g. push to hub every 5 minutes).
+
+    The scheduler is started when instantiated and run indefinitely. At the end of your script, a last commit is
+    triggered. Checkout the [upload guide](https://huggingface.co/docs/huggingface_hub/guides/upload#scheduled-uploads)
+    to learn more about how to use it.
+
+    Args:
+        repo_id (`str`):
+            The id of the repo to commit to.
+        folder_path (`str` or `Path`):
+            Path to the local folder to upload regularly.
+        every (`int` or `float`, *optional*):
+            The number of minutes between each commit. Defaults to 5 minutes.
+        path_in_repo (`str`, *optional*):
+            Relative path of the directory in the repo, for example: `"checkpoints/"`. Defaults to the root folder
+            of the repository.
+        repo_type (`str`, *optional*):
+            The type of the repo to commit to. Defaults to `model`.
+        revision (`str`, *optional*):
+            The revision of the repo to commit to. Defaults to `main`.
+        private (`bool`, *optional*):
+            Whether to make the repo private. Defaults to `False`. This value is ignored if the repo already exist.
+        token (`str`, *optional*):
+            The token to use to commit to the repo. Defaults to the token saved on the machine.
+        allow_patterns (`List[str]` or `str`, *optional*):
+            If provided, only files matching at least one pattern are uploaded.
+        ignore_patterns (`List[str]` or `str`, *optional*):
+            If provided, files matching any of the patterns are not uploaded.
+        squash_history (`bool`, *optional*):
+            Whether to squash the history of the repo after each commit. Defaults to `False`. Squashing commits is
+            useful to avoid degraded performances on the repo when it grows too large.
+        hf_api (`HfApi`, *optional*):
+            The [`HfApi`] client to use to commit to the Hub. Can be set with custom settings (user agent, token,...).
+
+    Example:
+    ```py
+    >>> from pathlib import Path
+    >>> from huggingface_hub import CommitScheduler
+
+    # Scheduler uploads every 10 minutes
+    >>> csv_path = Path("watched_folder/data.csv")
+    >>> CommitScheduler(repo_id="test_scheduler", repo_type="dataset", folder_path=csv_path.parent, every=10)
+
+    >>> with csv_path.open("a") as f:
+    ...     f.write("first line")
+
+    # Some time later (...)
+    >>> with csv_path.open("a") as f:
+    ...     f.write("second line")
+    ```
+    """
+
+    def __init__(
+        self,
+        *,
+        repo_id: str,
+        folder_path: Union[str, Path],
+        every: Union[int, float] = 5,
+        path_in_repo: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        private: bool = False,
+        token: Optional[str] = None,
+        allow_patterns: Optional[Union[List[str], str]] = None,
+        ignore_patterns: Optional[Union[List[str], str]] = None,
+        squash_history: bool = False,
+        hf_api: Optional["HfApi"] = None,
+    ) -> None:
+        self.api = hf_api or HfApi(token=token)
+
+        # Folder
+        self.folder_path = Path(folder_path).expanduser().resolve()
+        self.path_in_repo = path_in_repo or ""
+        self.allow_patterns = allow_patterns
+
+        if ignore_patterns is None:
+            ignore_patterns = []
+        elif isinstance(ignore_patterns, str):
+            ignore_patterns = [ignore_patterns]
+        self.ignore_patterns = ignore_patterns + IGNORE_GIT_FOLDER_PATTERNS
+
+        if self.folder_path.is_file():
+            raise ValueError(f"'folder_path' must be a directory, not a file: '{self.folder_path}'.")
+        self.folder_path.mkdir(parents=True, exist_ok=True)
+
+        # Repository
+        repo_url = self.api.create_repo(repo_id=repo_id, private=private, repo_type=repo_type, exist_ok=True)
+        self.repo_id = repo_url.repo_id
+        self.repo_type = repo_type
+        self.revision = revision
+        self.token = token
+
+        # Keep track of already uploaded files
+        self.last_uploaded: Dict[Path, float] = {}  # key is local path, value is timestamp
+
+        # Scheduler
+        if not every > 0:
+            raise ValueError(f"'every' must be a positive integer, not '{every}'.")
+        self.lock = Lock()
+        self.every = every
+        self.squash_history = squash_history
+
+        logger.info(f"Scheduled job to push '{self.folder_path}' to '{self.repo_id}' every {self.every} minutes.")
+        self._scheduler_thread = Thread(target=self._run_scheduler, daemon=True)
+        self._scheduler_thread.start()
+        atexit.register(self._push_to_hub)
+
+        self.__stopped = False
+
+    def stop(self) -> None:
+        """Stop the scheduler.
+
+        A stopped scheduler cannot be restarted. Mostly for tests purposes.
+        """
+        self.__stopped = True
+
+    def _run_scheduler(self) -> None:
+        """Dumb thread waiting between each scheduled push to Hub."""
+        while True:
+            self.last_future = self.trigger()
+            time.sleep(self.every * 60)
+            if self.__stopped:
+                break
+
+    def trigger(self) -> Future:
+        """Trigger a `push_to_hub` and return a future.
+
+        This method is automatically called every `every` minutes. You can also call it manually to trigger a commit
+        immediately, without waiting for the next scheduled commit.
+        """
+        return self.api.run_as_future(self._push_to_hub)
+
+    def _push_to_hub(self) -> Optional[CommitInfo]:
+        if self.__stopped:  # If stopped, already scheduled commits are ignored
+            return None
+
+        logger.info("(Background) scheduled commit triggered.")
+        try:
+            value = self.push_to_hub()
+            if self.squash_history:
+                logger.info("(Background) squashing repo history.")
+                self.api.super_squash_history(repo_id=self.repo_id, repo_type=self.repo_type, branch=self.revision)
+            return value
+        except Exception as e:
+            logger.error(f"Error while pushing to Hub: {e}")  # Depending on the setup, error might be silenced
+            raise
+
+    def push_to_hub(self) -> Optional[CommitInfo]:
+        """
+        Push folder to the Hub and return the commit info.
+
+        <Tip warning={true}>
+
+        This method is not meant to be called directly. It is run in the background by the scheduler, respecting a
+        queue mechanism to avoid concurrent commits. Making a direct call to the method might lead to concurrency
+        issues.
+
+        </Tip>
+
+        The default behavior of `push_to_hub` is to assume an append-only folder. It lists all files in the folder and
+        uploads only changed files. If no changes are found, the method returns without committing anything. If you want
+        to change this behavior, you can inherit from [`CommitScheduler`] and override this method. This can be useful
+        for example to compress data together in a single file before committing. For more details and examples, check
+        out our [integration guide](https://huggingface.co/docs/huggingface_hub/main/en/guides/upload#scheduled-uploads).
+        """
+        # Check files to upload (with lock)
+        with self.lock:
+            logger.debug("Listing files to upload for scheduled commit.")
+
+            # List files from folder (taken from `_prepare_upload_folder_additions`)
+            relpath_to_abspath = {
+                path.relative_to(self.folder_path).as_posix(): path
+                for path in sorted(self.folder_path.glob("**/*"))  # sorted to be deterministic
+                if path.is_file()
+            }
+            prefix = f"{self.path_in_repo.strip('/')}/" if self.path_in_repo else ""
+
+            # Filter with pattern + filter out unchanged files + retrieve current file size
+            files_to_upload: List[_FileToUpload] = []
+            for relpath in filter_repo_objects(
+                relpath_to_abspath.keys(), allow_patterns=self.allow_patterns, ignore_patterns=self.ignore_patterns
+            ):
+                local_path = relpath_to_abspath[relpath]
+                stat = local_path.stat()
+                if self.last_uploaded.get(local_path) is None or self.last_uploaded[local_path] != stat.st_mtime:
+                    files_to_upload.append(
+                        _FileToUpload(
+                            local_path=local_path,
+                            path_in_repo=prefix + relpath,
+                            size_limit=stat.st_size,
+                            last_modified=stat.st_mtime,
+                        )
+                    )
+
+        # Return if nothing to upload
+        if len(files_to_upload) == 0:
+            logger.debug("Dropping schedule commit: no changed file to upload.")
+            return None
+
+        # Convert `_FileToUpload` as `CommitOperationAdd` (=> compute file shas + limit to file size)
+        logger.debug("Removing unchanged files since previous scheduled commit.")
+        add_operations = [
+            CommitOperationAdd(
+                # Cap the file to its current size, even if the user append data to it while a scheduled commit is happening
+                path_or_fileobj=PartialFileIO(file_to_upload.local_path, size_limit=file_to_upload.size_limit),
+                path_in_repo=file_to_upload.path_in_repo,
+            )
+            for file_to_upload in files_to_upload
+        ]
+
+        # Upload files (append mode expected - no need for lock)
+        logger.debug("Uploading files for scheduled commit.")
+        commit_info = self.api.create_commit(
+            repo_id=self.repo_id,
+            repo_type=self.repo_type,
+            operations=add_operations,
+            commit_message="Scheduled Commit",
+            revision=self.revision,
+        )
+
+        # Successful commit: keep track of the latest "last_modified" for each file
+        for file in files_to_upload:
+            self.last_uploaded[file.local_path] = file.last_modified
+        return commit_info
+
+
+class PartialFileIO(BytesIO):
+    """A file-like object that reads only the first part of a file.
+
+    Useful to upload a file to the Hub when the user might still be appending data to it. Only the first part of the
+    file is uploaded (i.e. the part that was available when the filesystem was first scanned).
+
+    In practice, only used internally by the CommitScheduler to regularly push a folder to the Hub with minimal
+    disturbance for the user. The object is passed to `CommitOperationAdd`.
+
+    Only supports `read`, `tell` and `seek` methods.
+
+    Args:
+        file_path (`str` or `Path`):
+            Path to the file to read.
+        size_limit (`int`):
+            The maximum number of bytes to read from the file. If the file is larger than this, only the first part
+            will be read (and uploaded).
+    """
+
+    def __init__(self, file_path: Union[str, Path], size_limit: int) -> None:
+        self._file_path = Path(file_path)
+        self._file = self._file_path.open("rb")
+        self._size_limit = min(size_limit, os.fstat(self._file.fileno()).st_size)
+
+    def __del__(self) -> None:
+        self._file.close()
+        return super().__del__()
+
+    def __repr__(self) -> str:
+        return f"<PartialFileIO file_path={self._file_path} size_limit={self._size_limit}>"
+
+    def __len__(self) -> int:
+        return self._size_limit
+
+    def __getattribute__(self, name: str):
+        if name.startswith("_") or name in ("read", "tell", "seek"):  # only 3 public methods supported
+            return super().__getattribute__(name)
+        raise NotImplementedError(f"PartialFileIO does not support '{name}'.")
+
+    def tell(self) -> int:
+        """Return the current file position."""
+        return self._file.tell()
+
+    def seek(self, __offset: int, __whence: int = SEEK_SET) -> int:
+        """Change the stream position to the given offset.
+
+        Behavior is the same as a regular file, except that the position is capped to the size limit.
+        """
+        if __whence == SEEK_END:
+            # SEEK_END => set from the truncated end
+            __offset = len(self) + __offset
+            __whence = SEEK_SET
+
+        pos = self._file.seek(__offset, __whence)
+        if pos > self._size_limit:
+            return self._file.seek(self._size_limit)
+        return pos
+
+    def read(self, __size: Optional[int] = -1) -> bytes:
+        """Read at most `__size` bytes from the file.
+
+        Behavior is the same as a regular file, except that it is capped to the size limit.
+        """
+        current = self._file.tell()
+        if __size is None or __size < 0:
+            # Read until file limit
+            truncated_size = self._size_limit - current
+        else:
+            # Read until file limit or __size
+            truncated_size = min(__size, self._size_limit - current)
+        return self._file.read(truncated_size)
diff --git a/llm/Lib/site-packages/huggingface_hub/_inference_endpoints.py b/llm/Lib/site-packages/huggingface_hub/_inference_endpoints.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b81a796c6379c9b6bf40e0933933ceb8ba6c739
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/_inference_endpoints.py
@@ -0,0 +1,384 @@
+import time
+from dataclasses import dataclass, field
+from datetime import datetime
+from enum import Enum
+from typing import TYPE_CHECKING, Dict, Optional, Union
+
+from .inference._client import InferenceClient
+from .inference._generated._async_client import AsyncInferenceClient
+from .utils import logging, parse_datetime
+
+
+if TYPE_CHECKING:
+    from .hf_api import HfApi
+
+
+logger = logging.get_logger(__name__)
+
+
+class InferenceEndpointError(Exception):
+    """Generic exception when dealing with Inference Endpoints."""
+
+
+class InferenceEndpointTimeoutError(InferenceEndpointError, TimeoutError):
+    """Exception for timeouts while waiting for Inference Endpoint."""
+
+
+class InferenceEndpointStatus(str, Enum):
+    PENDING = "pending"
+    INITIALIZING = "initializing"
+    UPDATING = "updating"
+    UPDATE_FAILED = "updateFailed"
+    RUNNING = "running"
+    PAUSED = "paused"
+    FAILED = "failed"
+    SCALED_TO_ZERO = "scaledToZero"
+
+
+class InferenceEndpointType(str, Enum):
+    PUBlIC = "public"
+    PROTECTED = "protected"
+    PRIVATE = "private"
+
+
+@dataclass
+class InferenceEndpoint:
+    """
+    Contains information about a deployed Inference Endpoint.
+
+    Args:
+        name (`str`):
+            The unique name of the Inference Endpoint.
+        namespace (`str`):
+            The namespace where the Inference Endpoint is located.
+        repository (`str`):
+            The name of the model repository deployed on this Inference Endpoint.
+        status ([`InferenceEndpointStatus`]):
+            The current status of the Inference Endpoint.
+        url (`str`, *optional*):
+            The URL of the Inference Endpoint, if available. Only a deployed Inference Endpoint will have a URL.
+        framework (`str`):
+            The machine learning framework used for the model.
+        revision (`str`):
+            The specific model revision deployed on the Inference Endpoint.
+        task (`str`):
+            The task associated with the deployed model.
+        created_at (`datetime.datetime`):
+            The timestamp when the Inference Endpoint was created.
+        updated_at (`datetime.datetime`):
+            The timestamp of the last update of the Inference Endpoint.
+        type ([`InferenceEndpointType`]):
+            The type of the Inference Endpoint (public, protected, private).
+        raw (`Dict`):
+            The raw dictionary data returned from the API.
+        token (`str` or `bool`, *optional*):
+            Authentication token for the Inference Endpoint, if set when requesting the API. Will default to the
+            locally saved token if not provided. Pass `token=False` if you don't want to send your token to the server.
+
+    Example:
+        ```python
+        >>> from huggingface_hub import get_inference_endpoint
+        >>> endpoint = get_inference_endpoint("my-text-to-image")
+        >>> endpoint
+        InferenceEndpoint(name='my-text-to-image', ...)
+
+        # Get status
+        >>> endpoint.status
+        'running'
+        >>> endpoint.url
+        'https://my-text-to-image.region.vendor.endpoints.huggingface.cloud'
+
+        # Run inference
+        >>> endpoint.client.text_to_image(...)
+
+        # Pause endpoint to save $$$
+        >>> endpoint.pause()
+
+        # ...
+        # Resume and wait for deployment
+        >>> endpoint.resume()
+        >>> endpoint.wait()
+        >>> endpoint.client.text_to_image(...)
+        ```
+    """
+
+    # Field in __repr__
+    name: str = field(init=False)
+    namespace: str
+    repository: str = field(init=False)
+    status: InferenceEndpointStatus = field(init=False)
+    url: Optional[str] = field(init=False)
+
+    # Other fields
+    framework: str = field(repr=False, init=False)
+    revision: str = field(repr=False, init=False)
+    task: str = field(repr=False, init=False)
+    created_at: datetime = field(repr=False, init=False)
+    updated_at: datetime = field(repr=False, init=False)
+    type: InferenceEndpointType = field(repr=False, init=False)
+
+    # Raw dict from the API
+    raw: Dict = field(repr=False)
+
+    # Internal fields
+    _token: Union[str, bool, None] = field(repr=False, compare=False)
+    _api: "HfApi" = field(repr=False, compare=False)
+
+    @classmethod
+    def from_raw(
+        cls, raw: Dict, namespace: str, token: Union[str, bool, None] = None, api: Optional["HfApi"] = None
+    ) -> "InferenceEndpoint":
+        """Initialize object from raw dictionary."""
+        if api is None:
+            from .hf_api import HfApi
+
+            api = HfApi()
+        if token is None:
+            token = api.token
+
+        # All other fields are populated in __post_init__
+        return cls(raw=raw, namespace=namespace, _token=token, _api=api)
+
+    def __post_init__(self) -> None:
+        """Populate fields from raw dictionary."""
+        self._populate_from_raw()
+
+    @property
+    def client(self) -> InferenceClient:
+        """Returns a client to make predictions on this Inference Endpoint.
+
+        Returns:
+            [`InferenceClient`]: an inference client pointing to the deployed endpoint.
+
+        Raises:
+            [`InferenceEndpointError`]: If the Inference Endpoint is not yet deployed.
+        """
+        if self.url is None:
+            raise InferenceEndpointError(
+                "Cannot create a client for this Inference Endpoint as it is not yet deployed. "
+                "Please wait for the Inference Endpoint to be deployed using `endpoint.wait()` and try again."
+            )
+        return InferenceClient(model=self.url, token=self._token)
+
+    @property
+    def async_client(self) -> AsyncInferenceClient:
+        """Returns a client to make predictions on this Inference Endpoint.
+
+        Returns:
+            [`AsyncInferenceClient`]: an asyncio-compatible inference client pointing to the deployed endpoint.
+
+        Raises:
+            [`InferenceEndpointError`]: If the Inference Endpoint is not yet deployed.
+        """
+        if self.url is None:
+            raise InferenceEndpointError(
+                "Cannot create a client for this Inference Endpoint as it is not yet deployed. "
+                "Please wait for the Inference Endpoint to be deployed using `endpoint.wait()` and try again."
+            )
+        return AsyncInferenceClient(model=self.url, token=self._token)
+
+    def wait(self, timeout: Optional[int] = None, refresh_every: int = 5) -> "InferenceEndpoint":
+        """Wait for the Inference Endpoint to be deployed.
+
+        Information from the server will be fetched every 1s. If the Inference Endpoint is not deployed after `timeout`
+        seconds, a [`InferenceEndpointTimeoutError`] will be raised. The [`InferenceEndpoint`] will be mutated in place with the latest
+        data.
+
+        Args:
+            timeout (`int`, *optional*):
+                The maximum time to wait for the Inference Endpoint to be deployed, in seconds. If `None`, will wait
+                indefinitely.
+            refresh_every (`int`, *optional*):
+                The time to wait between each fetch of the Inference Endpoint status, in seconds. Defaults to 5s.
+
+        Returns:
+            [`InferenceEndpoint`]: the same Inference Endpoint, mutated in place with the latest data.
+
+        Raises:
+            [`InferenceEndpointError`]
+                If the Inference Endpoint ended up in a failed state.
+            [`InferenceEndpointTimeoutError`]
+                If the Inference Endpoint is not deployed after `timeout` seconds.
+        """
+        if self.url is not None:  # Means the endpoint is deployed
+            logger.info("Inference Endpoint is ready to be used.")
+            return self
+
+        if timeout is not None and timeout < 0:
+            raise ValueError("`timeout` cannot be negative.")
+        if refresh_every <= 0:
+            raise ValueError("`refresh_every` must be positive.")
+
+        start = time.time()
+        while True:
+            self.fetch()
+            if self.url is not None:  # Means the endpoint is deployed
+                logger.info("Inference Endpoint is ready to be used.")
+                return self
+            if self.status == InferenceEndpointStatus.FAILED:
+                raise InferenceEndpointError(
+                    f"Inference Endpoint {self.name} failed to deploy. Please check the logs for more information."
+                )
+            if timeout is not None:
+                if time.time() - start > timeout:
+                    raise InferenceEndpointTimeoutError("Timeout while waiting for Inference Endpoint to be deployed.")
+            logger.info(f"Inference Endpoint is not deployed yet ({self.status}). Waiting {refresh_every}s...")
+            time.sleep(refresh_every)
+
+    def fetch(self) -> "InferenceEndpoint":
+        """Fetch latest information about the Inference Endpoint.
+
+        Returns:
+            [`InferenceEndpoint`]: the same Inference Endpoint, mutated in place with the latest data.
+        """
+        obj = self._api.get_inference_endpoint(name=self.name, namespace=self.namespace, token=self._token)  # type: ignore [arg-type]
+        self.raw = obj.raw
+        self._populate_from_raw()
+        return self
+
+    def update(
+        self,
+        *,
+        # Compute update
+        accelerator: Optional[str] = None,
+        instance_size: Optional[str] = None,
+        instance_type: Optional[str] = None,
+        min_replica: Optional[int] = None,
+        max_replica: Optional[int] = None,
+        # Model update
+        repository: Optional[str] = None,
+        framework: Optional[str] = None,
+        revision: Optional[str] = None,
+        task: Optional[str] = None,
+    ) -> "InferenceEndpoint":
+        """Update the Inference Endpoint.
+
+        This method allows the update of either the compute configuration, the deployed model, or both. All arguments are
+        optional but at least one must be provided.
+
+        This is an alias for [`HfApi.update_inference_endpoint`]. The current object is mutated in place with the
+        latest data from the server.
+
+        Args:
+            accelerator (`str`, *optional*):
+                The hardware accelerator to be used for inference (e.g. `"cpu"`).
+            instance_size (`str`, *optional*):
+                The size or type of the instance to be used for hosting the model (e.g. `"large"`).
+            instance_type (`str`, *optional*):
+                The cloud instance type where the Inference Endpoint will be deployed (e.g. `"c6i"`).
+            min_replica (`int`, *optional*):
+                The minimum number of replicas (instances) to keep running for the Inference Endpoint.
+            max_replica (`int`, *optional*):
+                The maximum number of replicas (instances) to scale to for the Inference Endpoint.
+
+            repository (`str`, *optional*):
+                The name of the model repository associated with the Inference Endpoint (e.g. `"gpt2"`).
+            framework (`str`, *optional*):
+                The machine learning framework used for the model (e.g. `"custom"`).
+            revision (`str`, *optional*):
+                The specific model revision to deploy on the Inference Endpoint (e.g. `"6c0e6080953db56375760c0471a8c5f2929baf11"`).
+            task (`str`, *optional*):
+                The task on which to deploy the model (e.g. `"text-classification"`).
+
+        Returns:
+            [`InferenceEndpoint`]: the same Inference Endpoint, mutated in place with the latest data.
+        """
+        # Make API call
+        obj = self._api.update_inference_endpoint(
+            name=self.name,
+            namespace=self.namespace,
+            accelerator=accelerator,
+            instance_size=instance_size,
+            instance_type=instance_type,
+            min_replica=min_replica,
+            max_replica=max_replica,
+            repository=repository,
+            framework=framework,
+            revision=revision,
+            task=task,
+            token=self._token,  # type: ignore [arg-type]
+        )
+
+        # Mutate current object
+        self.raw = obj.raw
+        self._populate_from_raw()
+        return self
+
+    def pause(self) -> "InferenceEndpoint":
+        """Pause the Inference Endpoint.
+
+        A paused Inference Endpoint will not be charged. It can be resumed at any time using [`InferenceEndpoint.resume`].
+        This is different than scaling the Inference Endpoint to zero with [`InferenceEndpoint.scale_to_zero`], which
+        would be automatically restarted when a request is made to it.
+
+        This is an alias for [`HfApi.pause_inference_endpoint`]. The current object is mutated in place with the
+        latest data from the server.
+
+        Returns:
+            [`InferenceEndpoint`]: the same Inference Endpoint, mutated in place with the latest data.
+        """
+        obj = self._api.pause_inference_endpoint(name=self.name, namespace=self.namespace, token=self._token)  # type: ignore [arg-type]
+        self.raw = obj.raw
+        self._populate_from_raw()
+        return self
+
+    def resume(self) -> "InferenceEndpoint":
+        """Resume the Inference Endpoint.
+
+        This is an alias for [`HfApi.resume_inference_endpoint`]. The current object is mutated in place with the
+        latest data from the server.
+
+        Returns:
+            [`InferenceEndpoint`]: the same Inference Endpoint, mutated in place with the latest data.
+        """
+        obj = self._api.resume_inference_endpoint(name=self.name, namespace=self.namespace, token=self._token)  # type: ignore [arg-type]
+        self.raw = obj.raw
+        self._populate_from_raw()
+        return self
+
+    def scale_to_zero(self) -> "InferenceEndpoint":
+        """Scale Inference Endpoint to zero.
+
+        An Inference Endpoint scaled to zero will not be charged. It will be resume on the next request to it, with a
+        cold start delay. This is different than pausing the Inference Endpoint with [`InferenceEndpoint.pause`], which
+        would require a manual resume with [`InferenceEndpoint.resume`].
+
+        This is an alias for [`HfApi.scale_to_zero_inference_endpoint`]. The current object is mutated in place with the
+        latest data from the server.
+
+        Returns:
+            [`InferenceEndpoint`]: the same Inference Endpoint, mutated in place with the latest data.
+        """
+        obj = self._api.scale_to_zero_inference_endpoint(name=self.name, namespace=self.namespace, token=self._token)  # type: ignore [arg-type]
+        self.raw = obj.raw
+        self._populate_from_raw()
+        return self
+
+    def delete(self) -> None:
+        """Delete the Inference Endpoint.
+
+        This operation is not reversible. If you don't want to be charged for an Inference Endpoint, it is preferable
+        to pause it with [`InferenceEndpoint.pause`] or scale it to zero with [`InferenceEndpoint.scale_to_zero`].
+
+        This is an alias for [`HfApi.delete_inference_endpoint`].
+        """
+        self._api.delete_inference_endpoint(name=self.name, namespace=self.namespace, token=self._token)  # type: ignore [arg-type]
+
+    def _populate_from_raw(self) -> None:
+        """Populate fields from raw dictionary.
+
+        Called in __post_init__ + each time the Inference Endpoint is updated.
+        """
+        # Repr fields
+        self.name = self.raw["name"]
+        self.repository = self.raw["model"]["repository"]
+        self.status = self.raw["status"]["state"]
+        self.url = self.raw["status"].get("url")
+
+        # Other fields
+        self.framework = self.raw["model"]["framework"]
+        self.revision = self.raw["model"]["revision"]
+        self.task = self.raw["model"]["task"]
+        self.created_at = parse_datetime(self.raw["status"]["createdAt"])
+        self.updated_at = parse_datetime(self.raw["status"]["updatedAt"])
+        self.type = self.raw["type"]
diff --git a/llm/Lib/site-packages/huggingface_hub/_login.py b/llm/Lib/site-packages/huggingface_hub/_login.py
new file mode 100644
index 0000000000000000000000000000000000000000..0f4fa02535cb9b91ff3dec01c4878850317b3895
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/_login.py
@@ -0,0 +1,396 @@
+# Copyright 2020 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains methods to login to the Hub."""
+
+import os
+import subprocess
+from functools import partial
+from getpass import getpass
+from pathlib import Path
+from typing import Optional
+
+from . import constants
+from .commands._cli_utils import ANSI
+from .utils import (
+    capture_output,
+    get_token,
+    is_google_colab,
+    is_notebook,
+    list_credential_helpers,
+    logging,
+    run_subprocess,
+    set_git_credential,
+    unset_git_credential,
+)
+from .utils._token import _get_token_from_environment, _get_token_from_google_colab
+
+
+logger = logging.get_logger(__name__)
+
+_HF_LOGO_ASCII = """
+    _|    _|  _|    _|    _|_|_|    _|_|_|  _|_|_|  _|      _|    _|_|_|      _|_|_|_|    _|_|      _|_|_|  _|_|_|_|
+    _|    _|  _|    _|  _|        _|          _|    _|_|    _|  _|            _|        _|    _|  _|        _|
+    _|_|_|_|  _|    _|  _|  _|_|  _|  _|_|    _|    _|  _|  _|  _|  _|_|      _|_|_|    _|_|_|_|  _|        _|_|_|
+    _|    _|  _|    _|  _|    _|  _|    _|    _|    _|    _|_|  _|    _|      _|        _|    _|  _|        _|
+    _|    _|    _|_|      _|_|_|    _|_|_|  _|_|_|  _|      _|    _|_|_|      _|        _|    _|    _|_|_|  _|_|_|_|
+"""
+
+
+def login(
+    token: Optional[str] = None,
+    add_to_git_credential: bool = False,
+    new_session: bool = True,
+    write_permission: bool = False,
+) -> None:
+    """Login the machine to access the Hub.
+
+    The `token` is persisted in cache and set as a git credential. Once done, the machine
+    is logged in and the access token will be available across all `huggingface_hub`
+    components. If `token` is not provided, it will be prompted to the user either with
+    a widget (in a notebook) or via the terminal.
+
+    To login from outside of a script, one can also use `huggingface-cli login` which is
+    a cli command that wraps [`login`].
+
+    <Tip>
+
+    [`login`] is a drop-in replacement method for [`notebook_login`] as it wraps and
+    extends its capabilities.
+
+    </Tip>
+
+    <Tip>
+
+    When the token is not passed, [`login`] will automatically detect if the script runs
+    in a notebook or not. However, this detection might not be accurate due to the
+    variety of notebooks that exists nowadays. If that is the case, you can always force
+    the UI by using [`notebook_login`] or [`interpreter_login`].
+
+    </Tip>
+
+    Args:
+        token (`str`, *optional*):
+            User access token to generate from https://huggingface.co/settings/token.
+        add_to_git_credential (`bool`, defaults to `False`):
+            If `True`, token will be set as git credential. If no git credential helper
+            is configured, a warning will be displayed to the user. If `token` is `None`,
+            the value of `add_to_git_credential` is ignored and will be prompted again
+            to the end user.
+        new_session (`bool`, defaults to `True`):
+            If `True`, will request a token even if one is already saved on the machine.
+        write_permission (`bool`, defaults to `False`):
+            If `True`, requires a token with write permission.
+    Raises:
+        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If an organization token is passed. Only personal account tokens are valid
+            to login.
+        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If token is invalid.
+        [`ImportError`](https://docs.python.org/3/library/exceptions.html#ImportError)
+            If running in a notebook but `ipywidgets` is not installed.
+    """
+    if token is not None:
+        if not add_to_git_credential:
+            print(
+                "Token has not been saved to git credential helper. Pass"
+                " `add_to_git_credential=True` if you want to set the git"
+                " credential as well."
+            )
+        _login(token, add_to_git_credential=add_to_git_credential, write_permission=write_permission)
+    elif is_notebook():
+        notebook_login(new_session=new_session, write_permission=write_permission)
+    else:
+        interpreter_login(new_session=new_session, write_permission=write_permission)
+
+
+def logout() -> None:
+    """Logout the machine from the Hub.
+
+    Token is deleted from the machine and removed from git credential.
+    """
+    if get_token() is None:
+        print("Not logged in!")
+        return
+
+    # Delete token from git credentials
+    unset_git_credential()
+
+    # Delete token file
+    try:
+        Path(constants.HF_TOKEN_PATH).unlink()
+    except FileNotFoundError:
+        pass
+
+    # Check if still logged in
+    if _get_token_from_google_colab() is not None:
+        raise EnvironmentError(
+            "You are automatically logged in using a Google Colab secret.\n"
+            "To log out, you must unset the `HF_TOKEN` secret in your Colab settings."
+        )
+    if _get_token_from_environment() is not None:
+        raise EnvironmentError(
+            "Token has been deleted from your machine but you are still logged in.\n"
+            "To log out, you must clear out both `HF_TOKEN` and `HUGGING_FACE_HUB_TOKEN` environment variables."
+        )
+
+    print("Successfully logged out.")
+
+
+###
+# Interpreter-based login (text)
+###
+
+
+def interpreter_login(new_session: bool = True, write_permission: bool = False) -> None:
+    """
+    Displays a prompt to login to the HF website and store the token.
+
+    This is equivalent to [`login`] without passing a token when not run in a notebook.
+    [`interpreter_login`] is useful if you want to force the use of the terminal prompt
+    instead of a notebook widget.
+
+    For more details, see [`login`].
+
+    Args:
+        new_session (`bool`, defaults to `True`):
+            If `True`, will request a token even if one is already saved on the machine.
+        write_permission (`bool`, defaults to `False`):
+            If `True`, requires a token with write permission.
+
+    """
+    if not new_session and _current_token_okay(write_permission=write_permission):
+        print("User is already logged in.")
+        return
+
+    from .commands.delete_cache import _ask_for_confirmation_no_tui
+
+    print(_HF_LOGO_ASCII)
+    if get_token() is not None:
+        print(
+            "    A token is already saved on your machine. Run `huggingface-cli"
+            " whoami` to get more information or `huggingface-cli logout` if you want"
+            " to log out."
+        )
+        print("    Setting a new token will erase the existing one.")
+
+    print("    To login, `huggingface_hub` requires a token generated from https://huggingface.co/settings/tokens .")
+    if os.name == "nt":
+        print("Token can be pasted using 'Right-Click'.")
+    token = getpass("Enter your token (input will not be visible): ")
+    add_to_git_credential = _ask_for_confirmation_no_tui("Add token as git credential?")
+
+    _login(token=token, add_to_git_credential=add_to_git_credential, write_permission=write_permission)
+
+
+###
+# Notebook-based login (widget)
+###
+
+NOTEBOOK_LOGIN_PASSWORD_HTML = """<center> <img
+src=https://huggingface.co/front/assets/huggingface_logo-noborder.svg
+alt='Hugging Face'> <br> Immediately click login after typing your password or
+it might be stored in plain text in this notebook file. </center>"""
+
+
+NOTEBOOK_LOGIN_TOKEN_HTML_START = """<center> <img
+src=https://huggingface.co/front/assets/huggingface_logo-noborder.svg
+alt='Hugging Face'> <br> Copy a token from <a
+href="https://huggingface.co/settings/tokens" target="_blank">your Hugging Face
+tokens page</a> and paste it below. <br> Immediately click login after copying
+your token or it might be stored in plain text in this notebook file. </center>"""
+
+
+NOTEBOOK_LOGIN_TOKEN_HTML_END = """
+<b>Pro Tip:</b> If you don't already have one, you can create a dedicated
+'notebooks' token with 'write' access, that you can then easily reuse for all
+notebooks. </center>"""
+
+
+def notebook_login(new_session: bool = True, write_permission: bool = False) -> None:
+    """
+    Displays a widget to login to the HF website and store the token.
+
+    This is equivalent to [`login`] without passing a token when run in a notebook.
+    [`notebook_login`] is useful if you want to force the use of the notebook widget
+    instead of a prompt in the terminal.
+
+    For more details, see [`login`].
+
+    Args:
+        new_session (`bool`, defaults to `True`):
+            If `True`, will request a token even if one is already saved on the machine.
+        write_permission (`bool`, defaults to `False`):
+            If `True`, requires a token with write permission.
+    """
+    try:
+        import ipywidgets.widgets as widgets  # type: ignore
+        from IPython.display import display  # type: ignore
+    except ImportError:
+        raise ImportError(
+            "The `notebook_login` function can only be used in a notebook (Jupyter or"
+            " Colab) and you need the `ipywidgets` module: `pip install ipywidgets`."
+        )
+    if not new_session and _current_token_okay(write_permission=write_permission):
+        print("User is already logged in.")
+        return
+
+    box_layout = widgets.Layout(display="flex", flex_flow="column", align_items="center", width="50%")
+
+    token_widget = widgets.Password(description="Token:")
+    git_checkbox_widget = widgets.Checkbox(value=True, description="Add token as git credential?")
+    token_finish_button = widgets.Button(description="Login")
+
+    login_token_widget = widgets.VBox(
+        [
+            widgets.HTML(NOTEBOOK_LOGIN_TOKEN_HTML_START),
+            token_widget,
+            git_checkbox_widget,
+            token_finish_button,
+            widgets.HTML(NOTEBOOK_LOGIN_TOKEN_HTML_END),
+        ],
+        layout=box_layout,
+    )
+    display(login_token_widget)
+
+    # On click events
+    def login_token_event(t, write_permission: bool = False):
+        """
+        Event handler for the login button.
+
+        Args:
+            write_permission (`bool`, defaults to `False`):
+                If `True`, requires a token with write permission.
+        """
+        token = token_widget.value
+        add_to_git_credential = git_checkbox_widget.value
+        # Erase token and clear value to make sure it's not saved in the notebook.
+        token_widget.value = ""
+        # Hide inputs
+        login_token_widget.children = [widgets.Label("Connecting...")]
+        try:
+            with capture_output() as captured:
+                _login(token, add_to_git_credential=add_to_git_credential, write_permission=write_permission)
+            message = captured.getvalue()
+        except Exception as error:
+            message = str(error)
+        # Print result (success message or error)
+        login_token_widget.children = [widgets.Label(line) for line in message.split("\n") if line.strip()]
+
+    token_finish_button.on_click(partial(login_token_event, write_permission=write_permission))
+
+
+###
+# Login private helpers
+###
+
+
+def _login(token: str, add_to_git_credential: bool, write_permission: bool = False) -> None:
+    from .hf_api import get_token_permission  # avoid circular import
+
+    if token.startswith("api_org"):
+        raise ValueError("You must use your personal account token, not an organization token.")
+
+    permission = get_token_permission(token)
+    if permission is None:
+        raise ValueError("Invalid token passed!")
+    elif write_permission and permission != "write":
+        raise ValueError(
+            "Token is valid but is 'read-only' and a 'write' token is required.\nPlease provide a new token with"
+            " correct permission."
+        )
+    print(f"Token is valid (permission: {permission}).")
+
+    if add_to_git_credential:
+        if _is_git_credential_helper_configured():
+            set_git_credential(token)
+            print(
+                "Your token has been saved in your configured git credential helpers"
+                + f" ({','.join(list_credential_helpers())})."
+            )
+        else:
+            print("Token has not been saved to git credential helper.")
+
+    # Save token
+    path = Path(constants.HF_TOKEN_PATH)
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(token)
+    print(f"Your token has been saved to {constants.HF_TOKEN_PATH}")
+    print("Login successful")
+
+
+def _current_token_okay(write_permission: bool = False):
+    """Check if the current token is valid.
+
+    Args:
+        write_permission (`bool`, defaults to `False`):
+            If `True`, requires a token with write permission.
+
+    Returns:
+        `bool`: `True` if the current token is valid, `False` otherwise.
+    """
+    from .hf_api import get_token_permission  # avoid circular import
+
+    permission = get_token_permission()
+    if permission is None or (write_permission and permission != "write"):
+        return False
+    return True
+
+
+def _is_git_credential_helper_configured() -> bool:
+    """Check if a git credential helper is configured.
+
+    Warns user if not the case (except for Google Colab where "store" is set by default
+    by `huggingface_hub`).
+    """
+    helpers = list_credential_helpers()
+    if len(helpers) > 0:
+        return True  # Do not warn: at least 1 helper is set
+
+    # Only in Google Colab to avoid the warning message
+    # See https://github.com/huggingface/huggingface_hub/issues/1043#issuecomment-1247010710
+    if is_google_colab():
+        _set_store_as_git_credential_helper_globally()
+        return True  # Do not warn: "store" is used by default in Google Colab
+
+    # Otherwise, warn user
+    print(
+        ANSI.red(
+            "Cannot authenticate through git-credential as no helper is defined on your"
+            " machine.\nYou might have to re-authenticate when pushing to the Hugging"
+            " Face Hub.\nRun the following command in your terminal in case you want to"
+            " set the 'store' credential helper as default.\n\ngit config --global"
+            " credential.helper store\n\nRead"
+            " https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage for more"
+            " details."
+        )
+    )
+    return False
+
+
+def _set_store_as_git_credential_helper_globally() -> None:
+    """Set globally the credential.helper to `store`.
+
+    To be used only in Google Colab as we assume the user doesn't care about the git
+    credential config. It is the only particular case where we don't want to display the
+    warning message in [`notebook_login()`].
+
+    Related:
+    - https://github.com/huggingface/huggingface_hub/issues/1043
+    - https://github.com/huggingface/huggingface_hub/issues/1051
+    - https://git-scm.com/docs/git-credential-store
+    """
+    try:
+        run_subprocess("git config --global credential.helper store")
+    except subprocess.CalledProcessError as exc:
+        raise EnvironmentError(exc.stderr)
diff --git a/llm/Lib/site-packages/huggingface_hub/_multi_commits.py b/llm/Lib/site-packages/huggingface_hub/_multi_commits.py
new file mode 100644
index 0000000000000000000000000000000000000000..57c911bf0408081f18213db54e2ef38c819267bf
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/_multi_commits.py
@@ -0,0 +1,306 @@
+# coding=utf-8
+# Copyright 2023-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains utilities to multi-commits (i.e. push changes iteratively on a PR)."""
+
+import re
+from dataclasses import dataclass, field
+from typing import TYPE_CHECKING, Iterable, List, Optional, Set, Tuple, Union
+
+from ._commit_api import CommitOperationAdd, CommitOperationDelete
+from .community import DiscussionWithDetails
+from .utils import experimental
+from .utils._cache_manager import _format_size
+from .utils.insecure_hashlib import sha256
+
+
+if TYPE_CHECKING:
+    from .hf_api import HfApi
+
+
+class MultiCommitException(Exception):
+    """Base exception for any exception happening while doing a multi-commit."""
+
+
+MULTI_COMMIT_PR_DESCRIPTION_TEMPLATE = """
+## {commit_message}
+
+{commit_description}
+
+**Multi commit ID:** {multi_commit_id}
+
+Scheduled commits:
+
+{multi_commit_strategy}
+
+_This is a PR opened using the `huggingface_hub` library in the context of a multi-commit. PR can be commented as a usual PR. However, please be aware that manually updating the PR description, changing the PR status, or pushing new commits, is not recommended as it might corrupt the commit process. Learn more about multi-commits [in this guide](https://huggingface.co/docs/huggingface_hub/main/guides/upload)._
+"""
+
+MULTI_COMMIT_PR_COMPLETION_COMMENT_TEMPLATE = """
+Multi-commit is now completed! You can ping the repo owner to review the changes. This PR can now be commented or modified without risking to corrupt it.
+
+_This is a comment posted using the `huggingface_hub` library in the context of a multi-commit. Learn more about multi-commits [in this guide](https://huggingface.co/docs/huggingface_hub/main/guides/upload)._
+"""
+
+MULTI_COMMIT_PR_CLOSING_COMMENT_TEMPLATE = """
+`create_pr=False` has been passed so PR is automatically merged.
+
+_This is a comment posted using the `huggingface_hub` library in the context of a multi-commit. Learn more about multi-commits [in this guide](https://huggingface.co/docs/huggingface_hub/main/guides/upload)._
+"""
+
+MULTI_COMMIT_PR_CLOSE_COMMENT_FAILURE_NO_CHANGES_TEMPLATE = """
+Cannot merge Pull Requests as no changes are associated. This PR will be closed automatically.
+
+_This is a comment posted using the `huggingface_hub` library in the context of a multi-commit. Learn more about multi-commits [in this guide](https://huggingface.co/docs/huggingface_hub/main/guides/upload)._
+"""
+
+MULTI_COMMIT_PR_CLOSE_COMMENT_FAILURE_BAD_REQUEST_TEMPLATE = """
+An error occurred while trying to merge the Pull Request: `{error_message}`.
+
+_This is a comment posted using the `huggingface_hub` library in the context of a multi-commit. Learn more about multi-commits [in this guide](https://huggingface.co/docs/huggingface_hub/main/guides/upload)._
+"""
+
+
+STEP_ID_REGEX = re.compile(r"- \[(?P<completed>[ |x])\].*(?P<step_id>[a-fA-F0-9]{64})", flags=re.MULTILINE)
+
+
+@experimental
+def plan_multi_commits(
+    operations: Iterable[Union[CommitOperationAdd, CommitOperationDelete]],
+    max_operations_per_commit: int = 50,
+    max_upload_size_per_commit: int = 2 * 1024 * 1024 * 1024,
+) -> Tuple[List[List[CommitOperationAdd]], List[List[CommitOperationDelete]]]:
+    """Split a list of operations in a list of commits to perform.
+
+    Implementation follows a sub-optimal (yet simple) algorithm:
+    1. Delete operations are grouped together by commits of maximum `max_operations_per_commits` operations.
+    2. All additions exceeding `max_upload_size_per_commit` are committed 1 by 1.
+    3. All remaining additions are grouped together and split each time the `max_operations_per_commit` or the
+       `max_upload_size_per_commit` limit is reached.
+
+    We do not try to optimize the splitting to get the lowest number of commits as this is a NP-hard problem (see
+    [bin packing problem](https://en.wikipedia.org/wiki/Bin_packing_problem)). For our use case, it is not problematic
+    to use a sub-optimal solution so we favored an easy-to-explain implementation.
+
+    Args:
+        operations (`List` of [`~hf_api.CommitOperation`]):
+            The list of operations to split into commits.
+        max_operations_per_commit (`int`):
+            Maximum number of operations in a single commit. Defaults to 50.
+        max_upload_size_per_commit (`int`):
+            Maximum size to upload (in bytes) in a single commit. Defaults to 2GB. Files bigger than this limit are
+            uploaded, 1 per commit.
+
+    Returns:
+        `Tuple[List[List[CommitOperationAdd]], List[List[CommitOperationDelete]]]`: a tuple. First item is a list of
+        lists of [`CommitOperationAdd`] representing the addition commits to push. The second item is a list of lists
+        of [`CommitOperationDelete`] representing the deletion commits.
+
+    <Tip warning={true}>
+
+    `plan_multi_commits` is experimental. Its API and behavior is subject to change in the future without prior notice.
+
+    </Tip>
+
+    Example:
+    ```python
+    >>> from huggingface_hub import HfApi, plan_multi_commits
+    >>> addition_commits, deletion_commits = plan_multi_commits(
+    ...     operations=[
+    ...          CommitOperationAdd(...),
+    ...          CommitOperationAdd(...),
+    ...          CommitOperationDelete(...),
+    ...          CommitOperationDelete(...),
+    ...          CommitOperationAdd(...),
+    ...     ],
+    ... )
+    >>> HfApi().create_commits_on_pr(
+    ...     repo_id="my-cool-model",
+    ...     addition_commits=addition_commits,
+    ...     deletion_commits=deletion_commits,
+    ...     (...)
+    ...     verbose=True,
+    ... )
+    ```
+
+    <Tip warning={true}>
+
+    The initial order of the operations is not guaranteed! All deletions will be performed before additions. If you are
+    not updating multiple times the same file, you are fine.
+
+    </Tip>
+    """
+    addition_commits: List[List[CommitOperationAdd]] = []
+    deletion_commits: List[List[CommitOperationDelete]] = []
+
+    additions: List[CommitOperationAdd] = []
+    additions_size = 0
+    deletions: List[CommitOperationDelete] = []
+    for op in operations:
+        if isinstance(op, CommitOperationDelete):
+            # Group delete operations together
+            deletions.append(op)
+            if len(deletions) >= max_operations_per_commit:
+                deletion_commits.append(deletions)
+                deletions = []
+
+        elif op.upload_info.size >= max_upload_size_per_commit:
+            # Upload huge files 1 by 1
+            addition_commits.append([op])
+
+        elif additions_size + op.upload_info.size < max_upload_size_per_commit:
+            # Group other additions and split if size limit is reached (either max_nb_files or max_upload_size)
+            additions.append(op)
+            additions_size += op.upload_info.size
+
+        else:
+            addition_commits.append(additions)
+            additions = [op]
+            additions_size = op.upload_info.size
+
+        if len(additions) >= max_operations_per_commit:
+            addition_commits.append(additions)
+            additions = []
+            additions_size = 0
+
+    if len(additions) > 0:
+        addition_commits.append(additions)
+    if len(deletions) > 0:
+        deletion_commits.append(deletions)
+
+    return addition_commits, deletion_commits
+
+
+@dataclass
+class MultiCommitStep:
+    """Dataclass containing a list of CommitOperation to commit at once.
+
+    A [`MultiCommitStep`] is one atomic part of a [`MultiCommitStrategy`]. Each step is identified by its own
+    deterministic ID based on the list of commit operations (hexadecimal sha256). ID is persistent between re-runs if
+    the list of commits is kept the same.
+    """
+
+    operations: List[Union[CommitOperationAdd, CommitOperationDelete]]
+
+    id: str = field(init=False)
+    completed: bool = False
+
+    def __post_init__(self) -> None:
+        if len(self.operations) == 0:
+            raise ValueError("A MultiCommitStep must have at least 1 commit operation, got 0.")
+
+        # Generate commit id
+        sha = sha256()
+        for op in self.operations:
+            if isinstance(op, CommitOperationAdd):
+                sha.update(b"ADD")
+                sha.update(op.path_in_repo.encode())
+                sha.update(op.upload_info.sha256)
+            elif isinstance(op, CommitOperationDelete):
+                sha.update(b"DELETE")
+                sha.update(op.path_in_repo.encode())
+                sha.update(str(op.is_folder).encode())
+            else:
+                NotImplementedError()
+        self.id = sha.hexdigest()
+
+    def __str__(self) -> str:
+        """Format a step for PR description.
+
+        Formatting can be changed in the future as long as it is single line, starts with `- [ ]`/`- [x]` and contains
+        `self.id`. Must be able to match `STEP_ID_REGEX`.
+        """
+        additions = [op for op in self.operations if isinstance(op, CommitOperationAdd)]
+        file_deletions = [op for op in self.operations if isinstance(op, CommitOperationDelete) and not op.is_folder]
+        folder_deletions = [op for op in self.operations if isinstance(op, CommitOperationDelete) and op.is_folder]
+        if len(additions) > 0:
+            return (
+                f"- [{'x' if self.completed else ' '}] Upload {len(additions)} file(s) "
+                f"totalling {_format_size(sum(add.upload_info.size for add in additions))}"
+                f" ({self.id})"
+            )
+        else:
+            return (
+                f"- [{'x' if self.completed else ' '}] Delete {len(file_deletions)} file(s) and"
+                f" {len(folder_deletions)} folder(s) ({self.id})"
+            )
+
+
+@dataclass
+class MultiCommitStrategy:
+    """Dataclass containing a list of [`MultiCommitStep`] to commit iteratively.
+
+    A strategy is identified by its own deterministic ID based on the list of its steps (hexadecimal sha256). ID is
+    persistent between re-runs if the list of commits is kept the same.
+    """
+
+    addition_commits: List[MultiCommitStep]
+    deletion_commits: List[MultiCommitStep]
+
+    id: str = field(init=False)
+    all_steps: Set[str] = field(init=False)
+
+    def __post_init__(self) -> None:
+        self.all_steps = {step.id for step in self.addition_commits + self.deletion_commits}
+        if len(self.all_steps) < len(self.addition_commits) + len(self.deletion_commits):
+            raise ValueError("Got duplicate commits in MultiCommitStrategy. All commits must be unique.")
+
+        if len(self.all_steps) == 0:
+            raise ValueError("A MultiCommitStrategy must have at least 1 commit, got 0.")
+
+        # Generate strategy id
+        sha = sha256()
+        for step in self.addition_commits + self.deletion_commits:
+            sha.update("new step".encode())
+            sha.update(step.id.encode())
+        self.id = sha.hexdigest()
+
+
+def multi_commit_create_pull_request(
+    api: "HfApi",
+    repo_id: str,
+    commit_message: str,
+    commit_description: Optional[str],
+    strategy: MultiCommitStrategy,
+    token: Optional[str],
+    repo_type: Optional[str],
+) -> DiscussionWithDetails:
+    return api.create_pull_request(
+        repo_id=repo_id,
+        title=f"[WIP] {commit_message} (multi-commit {strategy.id})",
+        description=multi_commit_generate_comment(
+            commit_message=commit_message, commit_description=commit_description, strategy=strategy
+        ),
+        token=token,
+        repo_type=repo_type,
+    )
+
+
+def multi_commit_generate_comment(
+    commit_message: str,
+    commit_description: Optional[str],
+    strategy: MultiCommitStrategy,
+) -> str:
+    return MULTI_COMMIT_PR_DESCRIPTION_TEMPLATE.format(
+        commit_message=commit_message,
+        commit_description=commit_description or "",
+        multi_commit_id=strategy.id,
+        multi_commit_strategy="\n".join(
+            str(commit) for commit in strategy.deletion_commits + strategy.addition_commits
+        ),
+    )
+
+
+def multi_commit_parse_pr_description(description: str) -> Set[str]:
+    return {match[1] for match in STEP_ID_REGEX.findall(description)}
diff --git a/llm/Lib/site-packages/huggingface_hub/_snapshot_download.py b/llm/Lib/site-packages/huggingface_hub/_snapshot_download.py
new file mode 100644
index 0000000000000000000000000000000000000000..cbf57ea23308a3a688c6dae75a603df82f24c156
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/_snapshot_download.py
@@ -0,0 +1,327 @@
+import os
+from pathlib import Path
+from typing import Dict, List, Literal, Optional, Union
+
+import requests
+from tqdm.auto import tqdm as base_tqdm
+from tqdm.contrib.concurrent import thread_map
+
+from .constants import (
+    DEFAULT_ETAG_TIMEOUT,
+    DEFAULT_REVISION,
+    HF_HUB_CACHE,
+    HF_HUB_ENABLE_HF_TRANSFER,
+    REPO_TYPES,
+)
+from .file_download import REGEX_COMMIT_HASH, hf_hub_download, repo_folder_name
+from .hf_api import DatasetInfo, HfApi, ModelInfo, SpaceInfo
+from .utils import (
+    GatedRepoError,
+    LocalEntryNotFoundError,
+    OfflineModeIsEnabled,
+    RepositoryNotFoundError,
+    RevisionNotFoundError,
+    filter_repo_objects,
+    logging,
+    validate_hf_hub_args,
+)
+from .utils import tqdm as hf_tqdm
+
+
+logger = logging.get_logger(__name__)
+
+
+@validate_hf_hub_args
+def snapshot_download(
+    repo_id: str,
+    *,
+    repo_type: Optional[str] = None,
+    revision: Optional[str] = None,
+    cache_dir: Union[str, Path, None] = None,
+    local_dir: Union[str, Path, None] = None,
+    local_dir_use_symlinks: Union[bool, Literal["auto"]] = "auto",
+    library_name: Optional[str] = None,
+    library_version: Optional[str] = None,
+    user_agent: Optional[Union[Dict, str]] = None,
+    proxies: Optional[Dict] = None,
+    etag_timeout: float = DEFAULT_ETAG_TIMEOUT,
+    resume_download: bool = False,
+    force_download: bool = False,
+    token: Optional[Union[bool, str]] = None,
+    local_files_only: bool = False,
+    allow_patterns: Optional[Union[List[str], str]] = None,
+    ignore_patterns: Optional[Union[List[str], str]] = None,
+    max_workers: int = 8,
+    tqdm_class: Optional[base_tqdm] = None,
+    headers: Optional[Dict[str, str]] = None,
+    endpoint: Optional[str] = None,
+) -> str:
+    """Download repo files.
+
+    Download a whole snapshot of a repo's files at the specified revision. This is useful when you want all files from
+    a repo, because you don't know which ones you will need a priori. All files are nested inside a folder in order
+    to keep their actual filename relative to that folder. You can also filter which files to download using
+    `allow_patterns` and `ignore_patterns`.
+
+    If `local_dir` is provided, the file structure from the repo will be replicated in this location. You can configure
+    how you want to move those files:
+      - If `local_dir_use_symlinks="auto"` (default), files are downloaded and stored in the cache directory as blob
+        files. Small files (<5MB) are duplicated in `local_dir` while a symlink is created for bigger files. The goal
+        is to be able to manually edit and save small files without corrupting the cache while saving disk space for
+        binary files. The 5MB threshold can be configured with the `HF_HUB_LOCAL_DIR_AUTO_SYMLINK_THRESHOLD`
+        environment variable.
+      - If `local_dir_use_symlinks=True`, files are downloaded, stored in the cache directory and symlinked in `local_dir`.
+        This is optimal in term of disk usage but files must not be manually edited.
+      - If `local_dir_use_symlinks=False` and the blob files exist in the cache directory, they are duplicated in the
+        local dir. This means disk usage is not optimized.
+      - Finally, if `local_dir_use_symlinks=False` and the blob files do not exist in the cache directory, then the
+        files are downloaded and directly placed under `local_dir`. This means if you need to download them again later,
+        they will be re-downloaded entirely.
+
+    An alternative would be to clone the repo but this requires git and git-lfs to be installed and properly
+    configured. It is also not possible to filter which files to download when cloning a repository using git.
+
+    Args:
+        repo_id (`str`):
+            A user or an organization name and a repo name separated by a `/`.
+        repo_type (`str`, *optional*):
+            Set to `"dataset"` or `"space"` if downloading from a dataset or space,
+            `None` or `"model"` if downloading from a model. Default is `None`.
+        revision (`str`, *optional*):
+            An optional Git revision id which can be a branch name, a tag, or a
+            commit hash.
+        cache_dir (`str`, `Path`, *optional*):
+            Path to the folder where cached files are stored.
+        local_dir (`str` or `Path`, *optional*):
+            If provided, the downloaded files will be placed under this directory, either as symlinks (default) or
+            regular files (see description for more details).
+        local_dir_use_symlinks (`"auto"` or `bool`, defaults to `"auto"`):
+            To be used with `local_dir`. If set to "auto", the cache directory will be used and the file will be either
+            duplicated or symlinked to the local directory depending on its size. It set to `True`, a symlink will be
+            created, no matter the file size. If set to `False`, the file will either be duplicated from cache (if
+            already exists) or downloaded from the Hub and not cached. See description for more details.
+        library_name (`str`, *optional*):
+            The name of the library to which the object corresponds.
+        library_version (`str`, *optional*):
+            The version of the library.
+        user_agent (`str`, `dict`, *optional*):
+            The user-agent info in the form of a dictionary or a string.
+        proxies (`dict`, *optional*):
+            Dictionary mapping protocol to the URL of the proxy passed to
+            `requests.request`.
+        etag_timeout (`float`, *optional*, defaults to `10`):
+            When fetching ETag, how many seconds to wait for the server to send
+            data before giving up which is passed to `requests.request`.
+        resume_download (`bool`, *optional*, defaults to `False):
+            If `True`, resume a previously interrupted download.
+        force_download (`bool`, *optional*, defaults to `False`):
+            Whether the file should be downloaded even if it already exists in the local cache.
+        token (`str`, `bool`, *optional*):
+            A token to be used for the download.
+                - If `True`, the token is read from the HuggingFace config
+                  folder.
+                - If a string, it's used as the authentication token.
+        headers (`dict`, *optional*):
+            Additional headers to include in the request. Those headers take precedence over the others.
+        local_files_only (`bool`, *optional*, defaults to `False`):
+            If `True`, avoid downloading the file and return the path to the
+            local cached file if it exists.
+        allow_patterns (`List[str]` or `str`, *optional*):
+            If provided, only files matching at least one pattern are downloaded.
+        ignore_patterns (`List[str]` or `str`, *optional*):
+            If provided, files matching any of the patterns are not downloaded.
+        max_workers (`int`, *optional*):
+            Number of concurrent threads to download files (1 thread = 1 file download).
+            Defaults to 8.
+        tqdm_class (`tqdm`, *optional*):
+            If provided, overwrites the default behavior for the progress bar. Passed
+            argument must inherit from `tqdm.auto.tqdm` or at least mimic its behavior.
+            Note that the `tqdm_class` is not passed to each individual download.
+            Defaults to the custom HF progress bar that can be disabled by setting
+            `HF_HUB_DISABLE_PROGRESS_BARS` environment variable.
+
+    Returns:
+        Local folder path (string) of repo snapshot
+
+    <Tip>
+
+    Raises the following errors:
+
+    - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError)
+      if `token=True` and the token cannot be found.
+    - [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError) if
+      ETag cannot be determined.
+    - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+      if some parameter value is invalid
+
+    </Tip>
+    """
+    if cache_dir is None:
+        cache_dir = HF_HUB_CACHE
+    if revision is None:
+        revision = DEFAULT_REVISION
+    if isinstance(cache_dir, Path):
+        cache_dir = str(cache_dir)
+
+    if repo_type is None:
+        repo_type = "model"
+    if repo_type not in REPO_TYPES:
+        raise ValueError(f"Invalid repo type: {repo_type}. Accepted repo types are: {str(REPO_TYPES)}")
+
+    storage_folder = os.path.join(cache_dir, repo_folder_name(repo_id=repo_id, repo_type=repo_type))
+
+    repo_info: Union[ModelInfo, DatasetInfo, SpaceInfo, None] = None
+    api_call_error: Optional[Exception] = None
+    if not local_files_only:
+        # try/except logic to handle different errors => taken from `hf_hub_download`
+        try:
+            # if we have internet connection we want to list files to download
+            api = HfApi(
+                library_name=library_name,
+                library_version=library_version,
+                user_agent=user_agent,
+                endpoint=endpoint,
+                headers=headers,
+            )
+            repo_info = api.repo_info(repo_id=repo_id, repo_type=repo_type, revision=revision, token=token)
+        except (requests.exceptions.SSLError, requests.exceptions.ProxyError):
+            # Actually raise for those subclasses of ConnectionError
+            raise
+        except (
+            requests.exceptions.ConnectionError,
+            requests.exceptions.Timeout,
+            OfflineModeIsEnabled,
+        ) as error:
+            # Internet connection is down
+            # => will try to use local files only
+            api_call_error = error
+            pass
+        except RevisionNotFoundError:
+            # The repo was found but the revision doesn't exist on the Hub (never existed or got deleted)
+            raise
+        except requests.HTTPError as error:
+            # Multiple reasons for an http error:
+            # - Repository is private and invalid/missing token sent
+            # - Repository is gated and invalid/missing token sent
+            # - Hub is down (error 500 or 504)
+            # => let's switch to 'local_files_only=True' to check if the files are already cached.
+            #    (if it's not the case, the error will be re-raised)
+            api_call_error = error
+            pass
+
+    # At this stage, if `repo_info` is None it means either:
+    # - internet connection is down
+    # - internet connection is deactivated (local_files_only=True or HF_HUB_OFFLINE=True)
+    # - repo is private/gated and invalid/missing token sent
+    # - Hub is down
+    # => let's look if we can find the appropriate folder in the cache:
+    #    - if the specified revision is a commit hash, look inside "snapshots".
+    #    - f the specified revision is a branch or tag, look inside "refs".
+    if repo_info is None:
+        # Try to get which commit hash corresponds to the specified revision
+        commit_hash = None
+        if REGEX_COMMIT_HASH.match(revision):
+            commit_hash = revision
+        else:
+            ref_path = os.path.join(storage_folder, "refs", revision)
+            if os.path.exists(ref_path):
+                # retrieve commit_hash from refs file
+                with open(ref_path) as f:
+                    commit_hash = f.read()
+
+        # Try to locate snapshot folder for this commit hash
+        if commit_hash is not None:
+            snapshot_folder = os.path.join(storage_folder, "snapshots", commit_hash)
+            if os.path.exists(snapshot_folder):
+                # Snapshot folder exists => let's return it
+                # (but we can't check if all the files are actually there)
+                return snapshot_folder
+
+        # If we couldn't find the appropriate folder on disk, raise an error.
+        if local_files_only:
+            raise LocalEntryNotFoundError(
+                "Cannot find an appropriate cached snapshot folder for the specified revision on the local disk and "
+                "outgoing traffic has been disabled. To enable repo look-ups and downloads online, pass "
+                "'local_files_only=False' as input."
+            )
+        elif isinstance(api_call_error, OfflineModeIsEnabled):
+            raise LocalEntryNotFoundError(
+                "Cannot find an appropriate cached snapshot folder for the specified revision on the local disk and "
+                "outgoing traffic has been disabled. To enable repo look-ups and downloads online, set "
+                "'HF_HUB_OFFLINE=0' as environment variable."
+            ) from api_call_error
+        elif isinstance(api_call_error, RepositoryNotFoundError) or isinstance(api_call_error, GatedRepoError):
+            # Repo not found => let's raise the actual error
+            raise api_call_error
+        else:
+            # Otherwise: most likely a connection issue or Hub downtime => let's warn the user
+            raise LocalEntryNotFoundError(
+                "An error happened while trying to locate the files on the Hub and we cannot find the appropriate"
+                " snapshot folder for the specified revision on the local disk. Please check your internet connection"
+                " and try again."
+            ) from api_call_error
+
+    # At this stage, internet connection is up and running
+    # => let's download the files!
+    assert repo_info.sha is not None, "Repo info returned from server must have a revision sha."
+    assert repo_info.siblings is not None, "Repo info returned from server must have a siblings list."
+    filtered_repo_files = list(
+        filter_repo_objects(
+            items=[f.rfilename for f in repo_info.siblings],
+            allow_patterns=allow_patterns,
+            ignore_patterns=ignore_patterns,
+        )
+    )
+    commit_hash = repo_info.sha
+    snapshot_folder = os.path.join(storage_folder, "snapshots", commit_hash)
+    # if passed revision is not identical to commit_hash
+    # then revision has to be a branch name or tag name.
+    # In that case store a ref.
+    if revision != commit_hash:
+        ref_path = os.path.join(storage_folder, "refs", revision)
+        os.makedirs(os.path.dirname(ref_path), exist_ok=True)
+        with open(ref_path, "w") as f:
+            f.write(commit_hash)
+
+    # we pass the commit_hash to hf_hub_download
+    # so no network call happens if we already
+    # have the file locally.
+    def _inner_hf_hub_download(repo_file: str):
+        return hf_hub_download(
+            repo_id,
+            filename=repo_file,
+            repo_type=repo_type,
+            revision=commit_hash,
+            endpoint=endpoint,
+            cache_dir=cache_dir,
+            local_dir=local_dir,
+            local_dir_use_symlinks=local_dir_use_symlinks,
+            library_name=library_name,
+            library_version=library_version,
+            user_agent=user_agent,
+            proxies=proxies,
+            etag_timeout=etag_timeout,
+            resume_download=resume_download,
+            force_download=force_download,
+            token=token,
+            headers=headers,
+        )
+
+    if HF_HUB_ENABLE_HF_TRANSFER:
+        # when using hf_transfer we don't want extra parallelism
+        # from the one hf_transfer provides
+        for file in filtered_repo_files:
+            _inner_hf_hub_download(file)
+    else:
+        thread_map(
+            _inner_hf_hub_download,
+            filtered_repo_files,
+            desc=f"Fetching {len(filtered_repo_files)} files",
+            max_workers=max_workers,
+            # User can use its own tqdm class or the default one from `huggingface_hub.utils`
+            tqdm_class=tqdm_class or hf_tqdm,
+        )
+
+    if local_dir is not None:
+        return str(os.path.realpath(local_dir))
+    return snapshot_folder
diff --git a/llm/Lib/site-packages/huggingface_hub/_space_api.py b/llm/Lib/site-packages/huggingface_hub/_space_api.py
new file mode 100644
index 0000000000000000000000000000000000000000..da70bd05a66a96b450f04eab9171aa9b5f7420c7
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/_space_api.py
@@ -0,0 +1,155 @@
+# coding=utf-8
+# Copyright 2019-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from dataclasses import dataclass
+from datetime import datetime
+from enum import Enum
+from typing import Dict, Optional
+
+from huggingface_hub.utils import parse_datetime
+
+
+class SpaceStage(str, Enum):
+    """
+    Enumeration of possible stage of a Space on the Hub.
+
+    Value can be compared to a string:
+    ```py
+    assert SpaceStage.BUILDING == "BUILDING"
+    ```
+
+    Taken from https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (private url).
+    """
+
+    # Copied from moon-landing > server > repo_types > SpaceInfo.ts (private repo)
+    NO_APP_FILE = "NO_APP_FILE"
+    CONFIG_ERROR = "CONFIG_ERROR"
+    BUILDING = "BUILDING"
+    BUILD_ERROR = "BUILD_ERROR"
+    RUNNING = "RUNNING"
+    RUNNING_BUILDING = "RUNNING_BUILDING"
+    RUNTIME_ERROR = "RUNTIME_ERROR"
+    DELETING = "DELETING"
+    STOPPED = "STOPPED"
+    PAUSED = "PAUSED"
+
+
+class SpaceHardware(str, Enum):
+    """
+    Enumeration of hardwares available to run your Space on the Hub.
+
+    Value can be compared to a string:
+    ```py
+    assert SpaceHardware.CPU_BASIC == "cpu-basic"
+    ```
+
+    Taken from https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L73 (private url).
+    """
+
+    CPU_BASIC = "cpu-basic"
+    CPU_UPGRADE = "cpu-upgrade"
+    T4_SMALL = "t4-small"
+    T4_MEDIUM = "t4-medium"
+    ZERO_A10G = "zero-a10g"
+    A10G_SMALL = "a10g-small"
+    A10G_LARGE = "a10g-large"
+    A10G_LARGEX2 = "a10g-largex2"
+    A10G_LARGEX4 = "a10g-largex4"
+    A100_LARGE = "a100-large"
+
+
+class SpaceStorage(str, Enum):
+    """
+    Enumeration of persistent storage available for your Space on the Hub.
+
+    Value can be compared to a string:
+    ```py
+    assert SpaceStorage.SMALL == "small"
+    ```
+
+    Taken from https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (private url).
+    """
+
+    SMALL = "small"
+    MEDIUM = "medium"
+    LARGE = "large"
+
+
+@dataclass
+class SpaceRuntime:
+    """
+    Contains information about the current runtime of a Space.
+
+    Args:
+        stage (`str`):
+            Current stage of the space. Example: RUNNING.
+        hardware (`str` or `None`):
+            Current hardware of the space. Example: "cpu-basic". Can be `None` if Space
+            is `BUILDING` for the first time.
+        requested_hardware (`str` or `None`):
+            Requested hardware. Can be different than `hardware` especially if the request
+            has just been made. Example: "t4-medium". Can be `None` if no hardware has
+            been requested yet.
+        sleep_time (`int` or `None`):
+            Number of seconds the Space will be kept alive after the last request. By default (if value is `None`), the
+            Space will never go to sleep if it's running on an upgraded hardware, while it will go to sleep after 48
+            hours on a free 'cpu-basic' hardware. For more details, see https://huggingface.co/docs/hub/spaces-gpus#sleep-time.
+        raw (`dict`):
+            Raw response from the server. Contains more information about the Space
+            runtime like number of replicas, number of cpu, memory size,...
+    """
+
+    stage: SpaceStage
+    hardware: Optional[SpaceHardware]
+    requested_hardware: Optional[SpaceHardware]
+    sleep_time: Optional[int]
+    storage: Optional[SpaceStorage]
+    raw: Dict
+
+    def __init__(self, data: Dict) -> None:
+        self.stage = data["stage"]
+        self.hardware = data.get("hardware", {}).get("current")
+        self.requested_hardware = data.get("hardware", {}).get("requested")
+        self.sleep_time = data.get("gcTimeout")
+        self.storage = data.get("storage")
+        self.raw = data
+
+
+@dataclass
+class SpaceVariable:
+    """
+    Contains information about the current variables of a Space.
+
+    Args:
+        key (`str`):
+            Variable key. Example: `"MODEL_REPO_ID"`
+        value (`str`):
+            Variable value. Example: `"the_model_repo_id"`.
+        description (`str` or None):
+            Description of the variable. Example: `"Model Repo ID of the implemented model"`.
+        updatedAt (`datetime` or None):
+            datetime of the last update of the variable (if the variable has been updated at least once).
+    """
+
+    key: str
+    value: str
+    description: Optional[str]
+    updated_at: Optional[datetime]
+
+    def __init__(self, key: str, values: Dict) -> None:
+        self.key = key
+        self.value = values["value"]
+        self.description = values.get("description")
+        updated_at = values.get("updatedAt")
+        self.updated_at = parse_datetime(updated_at) if updated_at is not None else None
diff --git a/llm/Lib/site-packages/huggingface_hub/_tensorboard_logger.py b/llm/Lib/site-packages/huggingface_hub/_tensorboard_logger.py
new file mode 100644
index 0000000000000000000000000000000000000000..09f6aa5dbdb48049baaec12751318a0a8a87e7ae
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/_tensorboard_logger.py
@@ -0,0 +1,169 @@
+# Copyright 2023 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains a logger to push training logs to the Hub, using Tensorboard."""
+
+from pathlib import Path
+from typing import TYPE_CHECKING, List, Optional, Union
+
+from huggingface_hub._commit_scheduler import CommitScheduler
+
+from .utils import experimental, is_tensorboard_available
+
+
+if is_tensorboard_available():
+    from tensorboardX import SummaryWriter
+
+    # TODO: clarify: should we import from torch.utils.tensorboard ?
+
+else:
+    SummaryWriter = object  # Dummy class to avoid failing at import. Will raise on instance creation.
+
+if TYPE_CHECKING:
+    from tensorboardX import SummaryWriter
+
+
+class HFSummaryWriter(SummaryWriter):
+    """
+    Wrapper around the tensorboard's `SummaryWriter` to push training logs to the Hub.
+
+    Data is logged locally and then pushed to the Hub asynchronously. Pushing data to the Hub is done in a separate
+    thread to avoid blocking the training script. In particular, if the upload fails for any reason (e.g. a connection
+    issue), the main script will not be interrupted. Data is automatically pushed to the Hub every `commit_every`
+    minutes (default to every 5 minutes).
+
+    <Tip warning={true}>
+
+    `HFSummaryWriter` is experimental. Its API is subject to change in the future without prior notice.
+
+    </Tip>
+
+    Args:
+        repo_id (`str`):
+            The id of the repo to which the logs will be pushed.
+        logdir (`str`, *optional*):
+            The directory where the logs will be written. If not specified, a local directory will be created by the
+            underlying `SummaryWriter` object.
+        commit_every (`int` or `float`, *optional*):
+            The frequency (in minutes) at which the logs will be pushed to the Hub. Defaults to 5 minutes.
+        squash_history (`bool`, *optional*):
+            Whether to squash the history of the repo after each commit. Defaults to `False`. Squashing commits is
+            useful to avoid degraded performances on the repo when it grows too large.
+        repo_type (`str`, *optional*):
+            The type of the repo to which the logs will be pushed. Defaults to "model".
+        repo_revision (`str`, *optional*):
+            The revision of the repo to which the logs will be pushed. Defaults to "main".
+        repo_private (`bool`, *optional*):
+            Whether to create a private repo or not. Defaults to False. This argument is ignored if the repo already
+            exists.
+        path_in_repo (`str`, *optional*):
+            The path to the folder in the repo where the logs will be pushed. Defaults to "tensorboard/".
+        repo_allow_patterns (`List[str]` or `str`, *optional*):
+            A list of patterns to include in the upload. Defaults to `"*.tfevents.*"`. Check out the
+            [upload guide](https://huggingface.co/docs/huggingface_hub/guides/upload#upload-a-folder) for more details.
+        repo_ignore_patterns (`List[str]` or `str`, *optional*):
+            A list of patterns to exclude in the upload. Check out the
+            [upload guide](https://huggingface.co/docs/huggingface_hub/guides/upload#upload-a-folder) for more details.
+        token (`str`, *optional*):
+            Authentication token. Will default to the stored token. See https://huggingface.co/settings/token for more
+            details
+        kwargs:
+            Additional keyword arguments passed to `SummaryWriter`.
+
+    Examples:
+    ```py
+    >>> from huggingface_hub import HFSummaryWriter
+
+    # Logs are automatically pushed every 15 minutes
+    >>> logger = HFSummaryWriter(repo_id="test_hf_logger", commit_every=15)
+    >>> logger.add_scalar("a", 1)
+    >>> logger.add_scalar("b", 2)
+    ...
+
+    # You can also trigger a push manually
+    >>> logger.scheduler.trigger()
+    ```
+
+    ```py
+    >>> from huggingface_hub import HFSummaryWriter
+
+    # Logs are automatically pushed every 5 minutes (default) + when exiting the context manager
+    >>> with HFSummaryWriter(repo_id="test_hf_logger") as logger:
+    ...     logger.add_scalar("a", 1)
+    ...     logger.add_scalar("b", 2)
+    ```
+    """
+
+    @experimental
+    def __new__(cls, *args, **kwargs) -> "HFSummaryWriter":
+        if not is_tensorboard_available():
+            raise ImportError(
+                "You must have `tensorboard` installed to use `HFSummaryWriter`. Please run `pip install --upgrade"
+                " tensorboardX` first."
+            )
+        return super().__new__(cls)
+
+    def __init__(
+        self,
+        repo_id: str,
+        *,
+        logdir: Optional[str] = None,
+        commit_every: Union[int, float] = 5,
+        squash_history: bool = False,
+        repo_type: Optional[str] = None,
+        repo_revision: Optional[str] = None,
+        repo_private: bool = False,
+        path_in_repo: Optional[str] = "tensorboard",
+        repo_allow_patterns: Optional[Union[List[str], str]] = "*.tfevents.*",
+        repo_ignore_patterns: Optional[Union[List[str], str]] = None,
+        token: Optional[str] = None,
+        **kwargs,
+    ):
+        # Initialize SummaryWriter
+        super().__init__(logdir=logdir, **kwargs)
+
+        # Check logdir has been correctly initialized and fail early otherwise. In practice, SummaryWriter takes care of it.
+        if not isinstance(self.logdir, str):
+            raise ValueError(f"`self.logdir` must be a string. Got '{self.logdir}' of type {type(self.logdir)}.")
+
+        # Append logdir name to `path_in_repo`
+        if path_in_repo is None or path_in_repo == "":
+            path_in_repo = Path(self.logdir).name
+        else:
+            path_in_repo = path_in_repo.strip("/") + "/" + Path(self.logdir).name
+
+        # Initialize scheduler
+        self.scheduler = CommitScheduler(
+            folder_path=self.logdir,
+            path_in_repo=path_in_repo,
+            repo_id=repo_id,
+            repo_type=repo_type,
+            revision=repo_revision,
+            private=repo_private,
+            token=token,
+            allow_patterns=repo_allow_patterns,
+            ignore_patterns=repo_ignore_patterns,
+            every=commit_every,
+            squash_history=squash_history,
+        )
+
+        # Exposing some high-level info at root level
+        self.repo_id = self.scheduler.repo_id
+        self.repo_type = self.scheduler.repo_type
+        self.repo_revision = self.scheduler.revision
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        """Push to hub in a non-blocking way when exiting the logger's context manager."""
+        super().__exit__(exc_type, exc_val, exc_tb)
+        future = self.scheduler.trigger()
+        future.result()
diff --git a/llm/Lib/site-packages/huggingface_hub/_webhooks_payload.py b/llm/Lib/site-packages/huggingface_hub/_webhooks_payload.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ea669fe09a82252cb788ad390066a894cedf0f5
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/_webhooks_payload.py
@@ -0,0 +1,116 @@
+# coding=utf-8
+# Copyright 2023-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains data structures to parse the webhooks payload."""
+
+from typing import List, Literal, Optional
+
+from pydantic import BaseModel
+
+
+# This is an adaptation of the ReportV3 interface implemented in moon-landing. V0, V1 and V2 have been ignored as they
+# are not in used anymore. To keep in sync when format is updated in
+# https://github.com/huggingface/moon-landing/blob/main/server/lib/HFWebhooks.ts (internal link).
+
+
+WebhookEvent_T = Literal[
+    "create",
+    "delete",
+    "move",
+    "update",
+]
+RepoChangeEvent_T = Literal[
+    "add",
+    "move",
+    "remove",
+    "update",
+]
+RepoType_T = Literal[
+    "dataset",
+    "model",
+    "space",
+]
+DiscussionStatus_T = Literal[
+    "closed",
+    "draft",
+    "open",
+    "merged",
+]
+SupportedWebhookVersion = Literal[3]
+
+
+class ObjectId(BaseModel):
+    id: str
+
+
+class WebhookPayloadUrl(BaseModel):
+    web: str
+    api: Optional[str] = None
+
+
+class WebhookPayloadMovedTo(BaseModel):
+    name: str
+    owner: ObjectId
+
+
+class WebhookPayloadWebhook(ObjectId):
+    version: SupportedWebhookVersion
+
+
+class WebhookPayloadEvent(BaseModel):
+    action: WebhookEvent_T
+    scope: str
+
+
+class WebhookPayloadDiscussionChanges(BaseModel):
+    base: str
+    mergeCommitId: Optional[str] = None
+
+
+class WebhookPayloadComment(ObjectId):
+    author: ObjectId
+    hidden: bool
+    content: Optional[str] = None
+    url: WebhookPayloadUrl
+
+
+class WebhookPayloadDiscussion(ObjectId):
+    num: int
+    author: ObjectId
+    url: WebhookPayloadUrl
+    title: str
+    isPullRequest: bool
+    status: DiscussionStatus_T
+    changes: Optional[WebhookPayloadDiscussionChanges] = None
+    pinned: Optional[bool] = None
+
+
+class WebhookPayloadRepo(ObjectId):
+    owner: ObjectId
+    head_sha: Optional[str] = None
+    name: str
+    private: bool
+    subdomain: Optional[str] = None
+    tags: Optional[List[str]] = None
+    type: Literal["dataset", "model", "space"]
+    url: WebhookPayloadUrl
+
+
+class WebhookPayload(BaseModel):
+    event: WebhookPayloadEvent
+    repo: WebhookPayloadRepo
+    discussion: Optional[WebhookPayloadDiscussion] = None
+    comment: Optional[WebhookPayloadComment] = None
+    webhook: WebhookPayloadWebhook
+    movedTo: Optional[WebhookPayloadMovedTo] = None
diff --git a/llm/Lib/site-packages/huggingface_hub/_webhooks_server.py b/llm/Lib/site-packages/huggingface_hub/_webhooks_server.py
new file mode 100644
index 0000000000000000000000000000000000000000..fefb038848221691c1b49df9f7a6c921295f6a71
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/_webhooks_server.py
@@ -0,0 +1,380 @@
+# coding=utf-8
+# Copyright 2023-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains `WebhooksServer` and `webhook_endpoint` to create a webhook server easily."""
+
+import atexit
+import inspect
+import os
+from functools import wraps
+from typing import TYPE_CHECKING, Any, Callable, Dict, Optional
+
+from .utils import experimental, is_gradio_available
+from .utils._deprecation import _deprecate_method
+
+
+if TYPE_CHECKING:
+    import gradio as gr
+
+
+from fastapi import FastAPI, Request
+from fastapi.responses import JSONResponse
+
+
+_global_app: Optional["WebhooksServer"] = None
+_is_local = os.getenv("SYSTEM") != "spaces"
+
+
+@experimental
+class WebhooksServer:
+    """
+    The [`WebhooksServer`] class lets you create an instance of a Gradio app that can receive Huggingface webhooks.
+    These webhooks can be registered using the [`~WebhooksServer.add_webhook`] decorator. Webhook endpoints are added to
+    the app as a POST endpoint to the FastAPI router. Once all the webhooks are registered, the `run` method has to be
+    called to start the app.
+
+    It is recommended to accept [`WebhookPayload`] as the first argument of the webhook function. It is a Pydantic
+    model that contains all the information about the webhook event. The data will be parsed automatically for you.
+
+    Check out the [webhooks guide](../guides/webhooks_server) for a step-by-step tutorial on how to setup your
+    WebhooksServer and deploy it on a Space.
+
+    <Tip warning={true}>
+
+    `WebhooksServer` is experimental. Its API is subject to change in the future.
+
+    </Tip>
+
+    <Tip warning={true}>
+
+    You must have `gradio` installed to use `WebhooksServer` (`pip install --upgrade gradio`).
+
+    </Tip>
+
+    Args:
+        ui (`gradio.Blocks`, optional):
+            A Gradio UI instance to be used as the Space landing page. If `None`, a UI displaying instructions
+            about the configured webhooks is created.
+        webhook_secret (`str`, optional):
+            A secret key to verify incoming webhook requests. You can set this value to any secret you want as long as
+            you also configure it in your [webhooks settings panel](https://huggingface.co/settings/webhooks). You
+            can also set this value as the `WEBHOOK_SECRET` environment variable. If no secret is provided, the
+            webhook endpoints are opened without any security.
+
+    Example:
+
+        ```python
+        import gradio as gr
+        from huggingface_hub import WebhooksServer, WebhookPayload
+
+        with gr.Blocks() as ui:
+            ...
+
+        app = WebhooksServer(ui=ui, webhook_secret="my_secret_key")
+
+        @app.add_webhook("/say_hello")
+        async def hello(payload: WebhookPayload):
+            return {"message": "hello"}
+
+        app.run()
+        ```
+    """
+
+    def __new__(cls, *args, **kwargs) -> "WebhooksServer":
+        if not is_gradio_available():
+            raise ImportError(
+                "You must have `gradio` installed to use `WebhooksServer`. Please run `pip install --upgrade gradio`"
+                " first."
+            )
+        return super().__new__(cls)
+
+    def __init__(
+        self,
+        ui: Optional["gr.Blocks"] = None,
+        webhook_secret: Optional[str] = None,
+    ) -> None:
+        self._ui = ui
+
+        self.webhook_secret = webhook_secret or os.getenv("WEBHOOK_SECRET")
+        self.registered_webhooks: Dict[str, Callable] = {}
+        _warn_on_empty_secret(self.webhook_secret)
+
+    def add_webhook(self, path: Optional[str] = None) -> Callable:
+        """
+        Decorator to add a webhook to the [`WebhooksServer`] server.
+
+        Args:
+            path (`str`, optional):
+                The URL path to register the webhook function. If not provided, the function name will be used as the
+                path. In any case, all webhooks are registered under `/webhooks`.
+
+        Raises:
+            ValueError: If the provided path is already registered as a webhook.
+
+        Example:
+            ```python
+            from huggingface_hub import WebhooksServer, WebhookPayload
+
+            app = WebhooksServer()
+
+            @app.add_webhook
+            async def trigger_training(payload: WebhookPayload):
+                if payload.repo.type == "dataset" and payload.event.action == "update":
+                    # Trigger a training job if a dataset is updated
+                    ...
+
+            app.run()
+        ```
+        """
+        # Usage: directly as decorator. Example: `@app.add_webhook`
+        if callable(path):
+            # If path is a function, it means it was used as a decorator without arguments
+            return self.add_webhook()(path)
+
+        # Usage: provide a path. Example: `@app.add_webhook(...)`
+        @wraps(FastAPI.post)
+        def _inner_post(*args, **kwargs):
+            func = args[0]
+            abs_path = f"/webhooks/{(path or func.__name__).strip('/')}"
+            if abs_path in self.registered_webhooks:
+                raise ValueError(f"Webhook {abs_path} already exists.")
+            self.registered_webhooks[abs_path] = func
+
+        return _inner_post
+
+    def launch(self, prevent_thread_lock: bool = False, **launch_kwargs: Any) -> None:
+        """Launch the Gradio app and register webhooks to the underlying FastAPI server.
+
+        Input parameters are forwarded to Gradio when launching the app.
+        """
+        ui = self._ui or self._get_default_ui()
+
+        # Start Gradio App
+        #   - as non-blocking so that webhooks can be added afterwards
+        #   - as shared if launch locally (to debug webhooks)
+        launch_kwargs.setdefault("share", _is_local)
+        self.fastapi_app, _, _ = ui.launch(prevent_thread_lock=True, **launch_kwargs)
+
+        # Register webhooks to FastAPI app
+        for path, func in self.registered_webhooks.items():
+            # Add secret check if required
+            if self.webhook_secret is not None:
+                func = _wrap_webhook_to_check_secret(func, webhook_secret=self.webhook_secret)
+
+            # Add route to FastAPI app
+            self.fastapi_app.post(path)(func)
+
+        # Print instructions and block main thread
+        url = (ui.share_url or ui.local_url).strip("/")
+        message = "\nWebhooks are correctly setup and ready to use:"
+        message += "\n" + "\n".join(f"  - POST {url}{webhook}" for webhook in self.registered_webhooks)
+        message += "\nGo to https://huggingface.co/settings/webhooks to setup your webhooks."
+        print(message)
+
+        if not prevent_thread_lock:
+            ui.block_thread()
+
+    @_deprecate_method(version="0.23", message="Use `WebhooksServer.launch` instead.")
+    def run(self) -> None:
+        return self.launch()
+
+    def _get_default_ui(self) -> "gr.Blocks":
+        """Default UI if not provided (lists webhooks and provides basic instructions)."""
+        import gradio as gr
+
+        with gr.Blocks() as ui:
+            gr.Markdown("# This is an app to process 🤗 Webhooks")
+            gr.Markdown(
+                "Webhooks are a foundation for MLOps-related features. They allow you to listen for new changes on"
+                " specific repos or to all repos belonging to particular set of users/organizations (not just your"
+                " repos, but any repo). Check out this [guide](https://huggingface.co/docs/hub/webhooks) to get to"
+                " know more about webhooks on the Huggingface Hub."
+            )
+            gr.Markdown(
+                f"{len(self.registered_webhooks)} webhook(s) are registered:"
+                + "\n\n"
+                + "\n ".join(
+                    f"- [{webhook_path}]({_get_webhook_doc_url(webhook.__name__, webhook_path)})"
+                    for webhook_path, webhook in self.registered_webhooks.items()
+                )
+            )
+            gr.Markdown(
+                "Go to https://huggingface.co/settings/webhooks to setup your webhooks."
+                + "\nYou app is running locally. Please look at the logs to check the full URL you need to set."
+                if _is_local
+                else (
+                    "\nThis app is running on a Space. You can find the corresponding URL in the options menu"
+                    " (top-right) > 'Embed the Space'. The URL looks like 'https://{username}-{repo_name}.hf.space'."
+                )
+            )
+        return ui
+
+
+@experimental
+def webhook_endpoint(path: Optional[str] = None) -> Callable:
+    """Decorator to start a [`WebhooksServer`] and register the decorated function as a webhook endpoint.
+
+    This is a helper to get started quickly. If you need more flexibility (custom landing page or webhook secret),
+    you can use [`WebhooksServer`] directly. You can register multiple webhook endpoints (to the same server) by using
+    this decorator multiple times.
+
+    Check out the [webhooks guide](../guides/webhooks_server) for a step-by-step tutorial on how to setup your
+    server and deploy it on a Space.
+
+    <Tip warning={true}>
+
+    `webhook_endpoint` is experimental. Its API is subject to change in the future.
+
+    </Tip>
+
+    <Tip warning={true}>
+
+    You must have `gradio` installed to use `webhook_endpoint` (`pip install --upgrade gradio`).
+
+    </Tip>
+
+    Args:
+        path (`str`, optional):
+            The URL path to register the webhook function. If not provided, the function name will be used as the path.
+            In any case, all webhooks are registered under `/webhooks`.
+
+    Examples:
+        The default usage is to register a function as a webhook endpoint. The function name will be used as the path.
+        The server will be started automatically at exit (i.e. at the end of the script).
+
+        ```python
+        from huggingface_hub import webhook_endpoint, WebhookPayload
+
+        @webhook_endpoint
+        async def trigger_training(payload: WebhookPayload):
+            if payload.repo.type == "dataset" and payload.event.action == "update":
+                # Trigger a training job if a dataset is updated
+                ...
+
+        # Server is automatically started at the end of the script.
+        ```
+
+        Advanced usage: register a function as a webhook endpoint and start the server manually. This is useful if you
+        are running it in a notebook.
+
+        ```python
+        from huggingface_hub import webhook_endpoint, WebhookPayload
+
+        @webhook_endpoint
+        async def trigger_training(payload: WebhookPayload):
+            if payload.repo.type == "dataset" and payload.event.action == "update":
+                # Trigger a training job if a dataset is updated
+                ...
+
+        # Start the server manually
+        trigger_training.run()
+        ```
+    """
+    if callable(path):
+        # If path is a function, it means it was used as a decorator without arguments
+        return webhook_endpoint()(path)
+
+    @wraps(WebhooksServer.add_webhook)
+    def _inner(func: Callable) -> Callable:
+        app = _get_global_app()
+        app.add_webhook(path)(func)
+        if len(app.registered_webhooks) == 1:
+            # Register `app.run` to run at exit (only once)
+            atexit.register(app.run)
+
+        @wraps(app.run)
+        def _run_now():
+            # Run the app directly (without waiting atexit)
+            atexit.unregister(app.run)
+            app.run()
+
+        func.run = _run_now  # type: ignore
+        return func
+
+    return _inner
+
+
+def _get_global_app() -> WebhooksServer:
+    global _global_app
+    if _global_app is None:
+        _global_app = WebhooksServer()
+    return _global_app
+
+
+def _warn_on_empty_secret(webhook_secret: Optional[str]) -> None:
+    if webhook_secret is None:
+        print("Webhook secret is not defined. This means your webhook endpoints will be open to everyone.")
+        print(
+            "To add a secret, set `WEBHOOK_SECRET` as environment variable or pass it at initialization: "
+            "\n\t`app = WebhooksServer(webhook_secret='my_secret', ...)`"
+        )
+        print(
+            "For more details about webhook secrets, please refer to"
+            " https://huggingface.co/docs/hub/webhooks#webhook-secret."
+        )
+    else:
+        print("Webhook secret is correctly defined.")
+
+
+def _get_webhook_doc_url(webhook_name: str, webhook_path: str) -> str:
+    """Returns the anchor to a given webhook in the docs (experimental)"""
+    return "/docs#/default/" + webhook_name + webhook_path.replace("/", "_") + "_post"
+
+
+def _wrap_webhook_to_check_secret(func: Callable, webhook_secret: str) -> Callable:
+    """Wraps a webhook function to check the webhook secret before calling the function.
+
+    This is a hacky way to add the `request` parameter to the function signature. Since FastAPI based itself on route
+    parameters to inject the values to the function, we need to hack the function signature to retrieve the `Request`
+    object (and hence the headers). A far cleaner solution would be to use a middleware. However, since
+    `fastapi==0.90.1`, a middleware cannot be added once the app has started. And since the FastAPI app is started by
+    Gradio internals (and not by us), we cannot add a middleware.
+
+    This method is called only when a secret has been defined by the user. If a request is sent without the
+    "x-webhook-secret", the function will return a 401 error (unauthorized). If the header is sent but is incorrect,
+    the function will return a 403 error (forbidden).
+
+    Inspired by https://stackoverflow.com/a/33112180.
+    """
+    initial_sig = inspect.signature(func)
+
+    @wraps(func)
+    async def _protected_func(request: Request, **kwargs):
+        request_secret = request.headers.get("x-webhook-secret")
+        if request_secret is None:
+            return JSONResponse({"error": "x-webhook-secret header not set."}, status_code=401)
+        if request_secret != webhook_secret:
+            return JSONResponse({"error": "Invalid webhook secret."}, status_code=403)
+
+        # Inject `request` in kwargs if required
+        if "request" in initial_sig.parameters:
+            kwargs["request"] = request
+
+        # Handle both sync and async routes
+        if inspect.iscoroutinefunction(func):
+            return await func(**kwargs)
+        else:
+            return func(**kwargs)
+
+    # Update signature to include request
+    if "request" not in initial_sig.parameters:
+        _protected_func.__signature__ = initial_sig.replace(  # type: ignore
+            parameters=(
+                inspect.Parameter(name="request", kind=inspect.Parameter.POSITIONAL_OR_KEYWORD, annotation=Request),
+            )
+            + tuple(initial_sig.parameters.values())
+        )
+
+    # Return protected route
+    return _protected_func
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/__init__.py b/llm/Lib/site-packages/huggingface_hub/commands/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..49d088214505b9604964ab142e7f8a5b38ccd5ef
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/commands/__init__.py
@@ -0,0 +1,27 @@
+# Copyright 2020 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from abc import ABC, abstractmethod
+from argparse import _SubParsersAction
+
+
+class BaseHuggingfaceCLICommand(ABC):
+    @staticmethod
+    @abstractmethod
+    def register_subcommand(parser: _SubParsersAction):
+        raise NotImplementedError()
+
+    @abstractmethod
+    def run(self):
+        raise NotImplementedError()
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7401d7b27460adb668a9346d784366b83e107d75
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/_cli_utils.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/_cli_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..165da328e17afcd24fcdd0cc66764f243a8bac36
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/_cli_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/delete_cache.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/delete_cache.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..98e432d3b6c9d6dd98c2eff0acb6c6dff7cfc5e5
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/delete_cache.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/download.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/download.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9e2e64756c181bf37ab67d84ae2accdecb5477b8
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/download.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/env.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/env.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e6ae798ca9f85cbd0af7d26aaee04cff6c3c5f54
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/env.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/huggingface_cli.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/huggingface_cli.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ecb90524afb7a6eb53ccd82dcd9f4320fd819d9a
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/huggingface_cli.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/lfs.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/lfs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b53cd6cac94a2303b4326e9cdb3e1f47a698216
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/lfs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/scan_cache.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/scan_cache.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9d43cccc43f7bf0fb43b40b7df68f8c09fba3987
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/scan_cache.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/upload.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/upload.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c5d73a47a8ffa906b784984eff9a543e907b672e
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/upload.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/user.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/user.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e6ed910f4ec1e1c50322d9ce1d5d11a9e805ed18
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/commands/__pycache__/user.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/_cli_utils.py b/llm/Lib/site-packages/huggingface_hub/commands/_cli_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..7a1f8601618f07cbfb9782b30e85349818766a94
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/commands/_cli_utils.py
@@ -0,0 +1,64 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains a utility for good-looking prints."""
+
+import os
+from typing import List, Union
+
+
+class ANSI:
+    """
+    Helper for en.wikipedia.org/wiki/ANSI_escape_code
+    """
+
+    _bold = "\u001b[1m"
+    _gray = "\u001b[90m"
+    _red = "\u001b[31m"
+    _reset = "\u001b[0m"
+
+    @classmethod
+    def bold(cls, s: str) -> str:
+        return cls._format(s, cls._bold)
+
+    @classmethod
+    def gray(cls, s: str) -> str:
+        return cls._format(s, cls._gray)
+
+    @classmethod
+    def red(cls, s: str) -> str:
+        return cls._format(s, cls._bold + cls._red)
+
+    @classmethod
+    def _format(cls, s: str, code: str) -> str:
+        if os.environ.get("NO_COLOR"):
+            # See https://no-color.org/
+            return s
+        return f"{code}{s}{cls._reset}"
+
+
+def tabulate(rows: List[List[Union[str, int]]], headers: List[str]) -> str:
+    """
+    Inspired by:
+
+    - stackoverflow.com/a/8356620/593036
+    - stackoverflow.com/questions/9535954/printing-lists-as-tabular-data
+    """
+    col_widths = [max(len(str(x)) for x in col) for col in zip(*rows, headers)]
+    row_format = ("{{:{}}} " * len(headers)).format(*col_widths)
+    lines = []
+    lines.append(row_format.format(*headers))
+    lines.append(row_format.format(*["-" * w for w in col_widths]))
+    for row in rows:
+        lines.append(row_format.format(*row))
+    return "\n".join(lines)
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/delete_cache.py b/llm/Lib/site-packages/huggingface_hub/commands/delete_cache.py
new file mode 100644
index 0000000000000000000000000000000000000000..b2fc44d31c8f59e6c517dd6df71466a319e5ea0e
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/commands/delete_cache.py
@@ -0,0 +1,428 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains command to delete some revisions from the HF cache directory.
+
+Usage:
+    huggingface-cli delete-cache
+    huggingface-cli delete-cache --disable-tui
+    huggingface-cli delete-cache --dir ~/.cache/huggingface/hub
+
+NOTE:
+    This command is based on `InquirerPy` to build the multiselect menu in the terminal.
+    This dependency has to be installed with `pip install huggingface_hub[cli]`. Since
+    we want to avoid as much as possible cross-platform issues, I chose a library that
+    is built on top of `python-prompt-toolkit` which seems to be a reference in terminal
+    GUI (actively maintained on both Unix and Windows, 7.9k stars).
+
+    For the moment, the TUI feature is in beta.
+
+    See:
+    - https://github.com/kazhala/InquirerPy
+    - https://inquirerpy.readthedocs.io/en/latest/
+    - https://github.com/prompt-toolkit/python-prompt-toolkit
+
+    Other solutions could have been:
+    - `simple_term_menu`: would be good as well for our use case but some issues suggest
+      that Windows is less supported.
+      See: https://github.com/IngoMeyer441/simple-term-menu
+    - `PyInquirer`: very similar to `InquirerPy` but older and not maintained anymore.
+      In particular, no support of Python3.10.
+      See: https://github.com/CITGuru/PyInquirer
+    - `pick` (or `pickpack`): easy to use and flexible but built on top of Python's
+      standard library `curses` that is specific to Unix (not implemented on Windows).
+      See https://github.com/wong2/pick and https://github.com/anafvana/pickpack.
+    - `inquirer`: lot of traction (700 stars) but explicitly states "experimental
+      support of Windows". Not built on top of `python-prompt-toolkit`.
+      See https://github.com/magmax/python-inquirer
+
+TODO: add support for `huggingface-cli delete-cache aaaaaa bbbbbb cccccc (...)` ?
+TODO: add "--keep-last" arg to delete revisions that are not on `main` ref
+TODO: add "--filter" arg to filter repositories by name ?
+TODO: add "--sort" arg to sort by size ?
+TODO: add "--limit" arg to limit to X repos ?
+TODO: add "-y" arg for immediate deletion ?
+See discussions in https://github.com/huggingface/huggingface_hub/issues/1025.
+"""
+
+import os
+from argparse import Namespace, _SubParsersAction
+from functools import wraps
+from tempfile import mkstemp
+from typing import Any, Callable, Iterable, List, Optional, Union
+
+from ..utils import CachedRepoInfo, CachedRevisionInfo, HFCacheInfo, scan_cache_dir
+from . import BaseHuggingfaceCLICommand
+from ._cli_utils import ANSI
+
+
+try:
+    from InquirerPy import inquirer
+    from InquirerPy.base.control import Choice
+    from InquirerPy.separator import Separator
+
+    _inquirer_py_available = True
+except ImportError:
+    _inquirer_py_available = False
+
+
+def require_inquirer_py(fn: Callable) -> Callable:
+    """Decorator to flag methods that require `InquirerPy`."""
+
+    # TODO: refactor this + imports in a unified pattern across codebase
+    @wraps(fn)
+    def _inner(*args, **kwargs):
+        if not _inquirer_py_available:
+            raise ImportError(
+                "The `delete-cache` command requires extra dependencies to work with"
+                " the TUI.\nPlease run `pip install huggingface_hub[cli]` to install"
+                " them.\nOtherwise, disable TUI using the `--disable-tui` flag."
+            )
+
+        return fn(*args, **kwargs)
+
+    return _inner
+
+
+# Possibility for the user to cancel deletion
+_CANCEL_DELETION_STR = "CANCEL_DELETION"
+
+
+class DeleteCacheCommand(BaseHuggingfaceCLICommand):
+    @staticmethod
+    def register_subcommand(parser: _SubParsersAction):
+        delete_cache_parser = parser.add_parser("delete-cache", help="Delete revisions from the cache directory.")
+
+        delete_cache_parser.add_argument(
+            "--dir",
+            type=str,
+            default=None,
+            help="cache directory (optional). Default to the default HuggingFace cache.",
+        )
+
+        delete_cache_parser.add_argument(
+            "--disable-tui",
+            action="store_true",
+            help=(
+                "Disable Terminal User Interface (TUI) mode. Useful if your"
+                " platform/terminal doesn't support the multiselect menu."
+            ),
+        )
+
+        delete_cache_parser.set_defaults(func=DeleteCacheCommand)
+
+    def __init__(self, args: Namespace) -> None:
+        self.cache_dir: Optional[str] = args.dir
+        self.disable_tui: bool = args.disable_tui
+
+    def run(self):
+        """Run `delete-cache` command with or without TUI."""
+        # Scan cache directory
+        hf_cache_info = scan_cache_dir(self.cache_dir)
+
+        # Manual review from the user
+        if self.disable_tui:
+            selected_hashes = _manual_review_no_tui(hf_cache_info, preselected=[])
+        else:
+            selected_hashes = _manual_review_tui(hf_cache_info, preselected=[])
+
+        # If deletion is not cancelled
+        if len(selected_hashes) > 0 and _CANCEL_DELETION_STR not in selected_hashes:
+            confirm_message = _get_expectations_str(hf_cache_info, selected_hashes) + " Confirm deletion ?"
+
+            # Confirm deletion
+            if self.disable_tui:
+                confirmed = _ask_for_confirmation_no_tui(confirm_message)
+            else:
+                confirmed = _ask_for_confirmation_tui(confirm_message)
+
+            # Deletion is confirmed
+            if confirmed:
+                strategy = hf_cache_info.delete_revisions(*selected_hashes)
+                print("Start deletion.")
+                strategy.execute()
+                print(
+                    f"Done. Deleted {len(strategy.repos)} repo(s) and"
+                    f" {len(strategy.snapshots)} revision(s) for a total of"
+                    f" {strategy.expected_freed_size_str}."
+                )
+                return
+
+        # Deletion is cancelled
+        print("Deletion is cancelled. Do nothing.")
+
+
+@require_inquirer_py
+def _manual_review_tui(hf_cache_info: HFCacheInfo, preselected: List[str]) -> List[str]:
+    """Ask the user for a manual review of the revisions to delete.
+
+    Displays a multi-select menu in the terminal (TUI).
+    """
+    # Define multiselect list
+    choices = _get_tui_choices_from_scan(repos=hf_cache_info.repos, preselected=preselected)
+    checkbox = inquirer.checkbox(
+        message="Select revisions to delete:",
+        choices=choices,  # List of revisions with some pre-selection
+        cycle=False,  # No loop between top and bottom
+        height=100,  # Large list if possible
+        # We use the instruction to display to the user the expected effect of the
+        # deletion.
+        instruction=_get_expectations_str(
+            hf_cache_info,
+            selected_hashes=[c.value for c in choices if isinstance(c, Choice) and c.enabled],
+        ),
+        # We use the long instruction to should keybindings instructions to the user
+        long_instruction="Press <space> to select, <enter> to validate and <ctrl+c> to quit without modification.",
+        # Message that is displayed once the user validates its selection.
+        transformer=lambda result: f"{len(result)} revision(s) selected.",
+    )
+
+    # Add a callback to update the information line when a revision is
+    # selected/unselected
+    def _update_expectations(_) -> None:
+        # Hacky way to dynamically set an instruction message to the checkbox when
+        # a revision hash is selected/unselected.
+        checkbox._instruction = _get_expectations_str(
+            hf_cache_info,
+            selected_hashes=[choice["value"] for choice in checkbox.content_control.choices if choice["enabled"]],
+        )
+
+    checkbox.kb_func_lookup["toggle"].append({"func": _update_expectations})
+
+    # Finally display the form to the user.
+    try:
+        return checkbox.execute()
+    except KeyboardInterrupt:
+        return []  # Quit without deletion
+
+
+@require_inquirer_py
+def _ask_for_confirmation_tui(message: str, default: bool = True) -> bool:
+    """Ask for confirmation using Inquirer."""
+    return inquirer.confirm(message, default=default).execute()
+
+
+def _get_tui_choices_from_scan(repos: Iterable[CachedRepoInfo], preselected: List[str]) -> List:
+    """Build a list of choices from the scanned repos.
+
+    Args:
+        repos (*Iterable[`CachedRepoInfo`]*):
+            List of scanned repos on which we want to delete revisions.
+        preselected (*List[`str`]*):
+            List of revision hashes that will be preselected.
+
+    Return:
+        The list of choices to pass to `inquirer.checkbox`.
+    """
+    choices: List[Union[Choice, Separator]] = []
+
+    # First choice is to cancel the deletion. If selected, nothing will be deleted,
+    # no matter the other selected items.
+    choices.append(
+        Choice(
+            _CANCEL_DELETION_STR,
+            name="None of the following (if selected, nothing will be deleted).",
+            enabled=False,
+        )
+    )
+
+    # Display a separator per repo and a Choice for each revisions of the repo
+    for repo in sorted(repos, key=_repo_sorting_order):
+        # Repo as separator
+        choices.append(
+            Separator(
+                f"\n{repo.repo_type.capitalize()} {repo.repo_id} ({repo.size_on_disk_str},"
+                f" used {repo.last_accessed_str})"
+            )
+        )
+        for revision in sorted(repo.revisions, key=_revision_sorting_order):
+            # Revision as choice
+            choices.append(
+                Choice(
+                    revision.commit_hash,
+                    name=(
+                        f"{revision.commit_hash[:8]}:"
+                        f" {', '.join(sorted(revision.refs)) or '(detached)'} #"
+                        f" modified {revision.last_modified_str}"
+                    ),
+                    enabled=revision.commit_hash in preselected,
+                )
+            )
+
+    # Return choices
+    return choices
+
+
+def _manual_review_no_tui(hf_cache_info: HFCacheInfo, preselected: List[str]) -> List[str]:
+    """Ask the user for a manual review of the revisions to delete.
+
+    Used when TUI is disabled. Manual review happens in a separate tmp file that the
+    user can manually edit.
+    """
+    # 1. Generate temporary file with delete commands.
+    fd, tmp_path = mkstemp(suffix=".txt")  # suffix to make it easier to find by editors
+    os.close(fd)
+
+    lines = []
+    for repo in sorted(hf_cache_info.repos, key=_repo_sorting_order):
+        lines.append(
+            f"\n# {repo.repo_type.capitalize()} {repo.repo_id} ({repo.size_on_disk_str},"
+            f" used {repo.last_accessed_str})"
+        )
+        for revision in sorted(repo.revisions, key=_revision_sorting_order):
+            lines.append(
+                # Deselect by prepending a '#'
+                f"{'' if revision.commit_hash in preselected else '#'}   "
+                f" {revision.commit_hash} # Refs:"
+                # Print `refs` as comment on same line
+                f" {', '.join(sorted(revision.refs)) or '(detached)'} # modified"
+                # Print `last_modified` as comment on same line
+                f" {revision.last_modified_str}"
+            )
+
+    with open(tmp_path, "w") as f:
+        f.write(_MANUAL_REVIEW_NO_TUI_INSTRUCTIONS)
+        f.write("\n".join(lines))
+
+    # 2. Prompt instructions to user.
+    instructions = f"""
+    TUI is disabled. In order to select which revisions you want to delete, please edit
+    the following file using the text editor of your choice. Instructions for manual
+    editing are located at the beginning of the file. Edit the file, save it and confirm
+    to continue.
+    File to edit: {ANSI.bold(tmp_path)}
+    """
+    print("\n".join(line.strip() for line in instructions.strip().split("\n")))
+
+    # 3. Wait for user confirmation.
+    while True:
+        selected_hashes = _read_manual_review_tmp_file(tmp_path)
+        if _ask_for_confirmation_no_tui(
+            _get_expectations_str(hf_cache_info, selected_hashes) + " Continue ?",
+            default=False,
+        ):
+            break
+
+    # 4. Return selected_hashes
+    os.remove(tmp_path)
+    return selected_hashes
+
+
+def _ask_for_confirmation_no_tui(message: str, default: bool = True) -> bool:
+    """Ask for confirmation using pure-python."""
+    YES = ("y", "yes", "1")
+    NO = ("n", "no", "0")
+    DEFAULT = ""
+    ALL = YES + NO + (DEFAULT,)
+    full_message = message + (" (Y/n) " if default else " (y/N) ")
+    while True:
+        answer = input(full_message).lower()
+        if answer == DEFAULT:
+            return default
+        if answer in YES:
+            return True
+        if answer in NO:
+            return False
+        print(f"Invalid input. Must be one of {ALL}")
+
+
+def _get_expectations_str(hf_cache_info: HFCacheInfo, selected_hashes: List[str]) -> str:
+    """Format a string to display to the user how much space would be saved.
+
+    Example:
+    ```
+    >>> _get_expectations_str(hf_cache_info, selected_hashes)
+    '7 revisions selected counting for 4.3G.'
+    ```
+    """
+    if _CANCEL_DELETION_STR in selected_hashes:
+        return "Nothing will be deleted."
+    strategy = hf_cache_info.delete_revisions(*selected_hashes)
+    return f"{len(selected_hashes)} revisions selected counting for {strategy.expected_freed_size_str}."
+
+
+def _read_manual_review_tmp_file(tmp_path: str) -> List[str]:
+    """Read the manually reviewed instruction file and return a list of revision hash.
+
+    Example:
+        ```txt
+        # This is the tmp file content
+        ###
+
+        # Commented out line
+        123456789 # revision hash
+
+        # Something else
+        #      a_newer_hash # 2 days ago
+            an_older_hash # 3 days ago
+        ```
+
+        ```py
+        >>> _read_manual_review_tmp_file(tmp_path)
+        ['123456789', 'an_older_hash']
+        ```
+    """
+    with open(tmp_path) as f:
+        content = f.read()
+
+    # Split lines
+    lines = [line.strip() for line in content.split("\n")]
+
+    # Filter commented lines
+    selected_lines = [line for line in lines if not line.startswith("#")]
+
+    # Select only before comment
+    selected_hashes = [line.split("#")[0].strip() for line in selected_lines]
+
+    # Return revision hashes
+    return [hash for hash in selected_hashes if len(hash) > 0]
+
+
+_MANUAL_REVIEW_NO_TUI_INSTRUCTIONS = f"""
+# INSTRUCTIONS
+# ------------
+# This is a temporary file created by running `huggingface-cli delete-cache` with the
+# `--disable-tui` option. It contains a set of revisions that can be deleted from your
+# local cache directory.
+#
+# Please manually review the revisions you want to delete:
+#   - Revision hashes can be commented out with '#'.
+#   - Only non-commented revisions in this file will be deleted.
+#   - Revision hashes that are removed from this file are ignored as well.
+#   - If `{_CANCEL_DELETION_STR}` line is uncommented, the all cache deletion is cancelled and
+#     no changes will be applied.
+#
+# Once you've manually reviewed this file, please confirm deletion in the terminal. This
+# file will be automatically removed once done.
+# ------------
+
+# KILL SWITCH
+# ------------
+# Un-comment following line to completely cancel the deletion process
+# {_CANCEL_DELETION_STR}
+# ------------
+
+# REVISIONS
+# ------------
+""".strip()
+
+
+def _repo_sorting_order(repo: CachedRepoInfo) -> Any:
+    # First split by Dataset/Model, then sort by last accessed (oldest first)
+    return (repo.repo_type, repo.last_accessed)
+
+
+def _revision_sorting_order(revision: CachedRevisionInfo) -> Any:
+    # Sort by last modified (oldest first)
+    return revision.last_modified
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/download.py b/llm/Lib/site-packages/huggingface_hub/commands/download.py
new file mode 100644
index 0000000000000000000000000000000000000000..1de7738a14fa7dc9fc89577013532c44b50caf02
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/commands/download.py
@@ -0,0 +1,215 @@
+# coding=utf-8
+# Copyright 2023-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains command to download files from the Hub with the CLI.
+
+Usage:
+    huggingface-cli download --help
+
+    # Download file
+    huggingface-cli download gpt2 config.json
+
+    # Download entire repo
+    huggingface-cli download fffiloni/zeroscope --repo-type=space --revision=refs/pr/78
+
+    # Download repo with filters
+    huggingface-cli download gpt2 --include="*.safetensors"
+
+    # Download with token
+    huggingface-cli download Wauplin/private-model --token=hf_***
+
+    # Download quietly (no progress bar, no warnings, only the returned path)
+    huggingface-cli download gpt2 config.json --quiet
+
+    # Download to local dir
+    huggingface-cli download gpt2 --local-dir=./models/gpt2
+"""
+
+import warnings
+from argparse import Namespace, _SubParsersAction
+from typing import List, Literal, Optional, Union
+
+from huggingface_hub import logging
+from huggingface_hub._snapshot_download import snapshot_download
+from huggingface_hub.commands import BaseHuggingfaceCLICommand
+from huggingface_hub.constants import HF_HUB_ENABLE_HF_TRANSFER
+from huggingface_hub.file_download import hf_hub_download
+from huggingface_hub.utils import disable_progress_bars, enable_progress_bars
+
+
+logger = logging.get_logger(__name__)
+
+
+class DownloadCommand(BaseHuggingfaceCLICommand):
+    @staticmethod
+    def register_subcommand(parser: _SubParsersAction):
+        download_parser = parser.add_parser("download", help="Download files from the Hub")
+        download_parser.add_argument(
+            "repo_id", type=str, help="ID of the repo to download from (e.g. `username/repo-name`)."
+        )
+        download_parser.add_argument(
+            "filenames", type=str, nargs="*", help="Files to download (e.g. `config.json`, `data/metadata.jsonl`)."
+        )
+        download_parser.add_argument(
+            "--repo-type",
+            choices=["model", "dataset", "space"],
+            default="model",
+            help="Type of repo to download from (defaults to 'model').",
+        )
+        download_parser.add_argument(
+            "--revision",
+            type=str,
+            help="An optional Git revision id which can be a branch name, a tag, or a commit hash.",
+        )
+        download_parser.add_argument(
+            "--include", nargs="*", type=str, help="Glob patterns to match files to download."
+        )
+        download_parser.add_argument(
+            "--exclude", nargs="*", type=str, help="Glob patterns to exclude from files to download."
+        )
+        download_parser.add_argument(
+            "--cache-dir", type=str, help="Path to the directory where to save the downloaded files."
+        )
+        download_parser.add_argument(
+            "--local-dir",
+            type=str,
+            help=(
+                "If set, the downloaded file will be placed under this directory either as a symlink (default) or a"
+                " regular file. Check out"
+                " https://huggingface.co/docs/huggingface_hub/guides/download#download-files-to-local-folder for more"
+                " details."
+            ),
+        )
+        download_parser.add_argument(
+            "--local-dir-use-symlinks",
+            choices=["auto", "True", "False"],
+            default="auto",
+            help=(
+                "To be used with `local_dir`. If set to 'auto', the cache directory will be used and the file will be"
+                " either duplicated or symlinked to the local directory depending on its size. It set to `True`, a"
+                " symlink will be created, no matter the file size. If set to `False`, the file will either be"
+                " duplicated from cache (if already exists) or downloaded from the Hub and not cached."
+            ),
+        )
+        download_parser.add_argument(
+            "--force-download",
+            action="store_true",
+            help="If True, the files will be downloaded even if they are already cached.",
+        )
+        download_parser.add_argument(
+            "--resume-download", action="store_true", help="If True, resume a previously interrupted download."
+        )
+        download_parser.add_argument(
+            "--token", type=str, help="A User Access Token generated from https://huggingface.co/settings/tokens"
+        )
+        download_parser.add_argument(
+            "--quiet",
+            action="store_true",
+            help="If True, progress bars are disabled and only the path to the download files is printed.",
+        )
+        download_parser.set_defaults(func=DownloadCommand)
+
+    def __init__(self, args: Namespace) -> None:
+        self.token = args.token
+        self.repo_id: str = args.repo_id
+        self.filenames: List[str] = args.filenames
+        self.repo_type: str = args.repo_type
+        self.revision: Optional[str] = args.revision
+        self.include: Optional[List[str]] = args.include
+        self.exclude: Optional[List[str]] = args.exclude
+        self.cache_dir: Optional[str] = args.cache_dir
+        self.local_dir: Optional[str] = args.local_dir
+        self.force_download: bool = args.force_download
+        self.resume_download: bool = args.resume_download
+        self.quiet: bool = args.quiet
+
+        # Raise if local_dir_use_symlinks is invalid
+        self.local_dir_use_symlinks: Union[Literal["auto"], bool]
+        use_symlinks_lowercase = args.local_dir_use_symlinks.lower()
+        if use_symlinks_lowercase == "true":
+            self.local_dir_use_symlinks = True
+        elif use_symlinks_lowercase == "false":
+            self.local_dir_use_symlinks = False
+        elif use_symlinks_lowercase == "auto":
+            self.local_dir_use_symlinks = "auto"
+        else:
+            raise ValueError(
+                f"'{args.local_dir_use_symlinks}' is not a valid value for `local_dir_use_symlinks`. It must be either"
+                " 'auto', 'True' or 'False'."
+            )
+
+    def run(self) -> None:
+        if self.quiet:
+            disable_progress_bars()
+            with warnings.catch_warnings():
+                warnings.simplefilter("ignore")
+                print(self._download())  # Print path to downloaded files
+            enable_progress_bars()
+        else:
+            logging.set_verbosity_info()
+            print(self._download())  # Print path to downloaded files
+            logging.set_verbosity_warning()
+
+    def _download(self) -> str:
+        # Warn user if patterns are ignored
+        if len(self.filenames) > 0:
+            if self.include is not None and len(self.include) > 0:
+                warnings.warn("Ignoring `--include` since filenames have being explicitly set.")
+            if self.exclude is not None and len(self.exclude) > 0:
+                warnings.warn("Ignoring `--exclude` since filenames have being explicitly set.")
+
+        if not HF_HUB_ENABLE_HF_TRANSFER:
+            logger.info(
+                "Consider using `hf_transfer` for faster downloads. This solution comes with some limitations. See"
+                " https://huggingface.co/docs/huggingface_hub/hf_transfer for more details."
+            )
+
+        # Single file to download: use `hf_hub_download`
+        if len(self.filenames) == 1:
+            return hf_hub_download(
+                repo_id=self.repo_id,
+                repo_type=self.repo_type,
+                revision=self.revision,
+                filename=self.filenames[0],
+                cache_dir=self.cache_dir,
+                resume_download=self.resume_download,
+                force_download=self.force_download,
+                token=self.token,
+                local_dir=self.local_dir,
+                local_dir_use_symlinks=self.local_dir_use_symlinks,
+                library_name="huggingface-cli",
+            )
+
+        # Otherwise: use `snapshot_download` to ensure all files comes from same revision
+        elif len(self.filenames) == 0:
+            allow_patterns = self.include
+            ignore_patterns = self.exclude
+        else:
+            allow_patterns = self.filenames
+            ignore_patterns = None
+
+        return snapshot_download(
+            repo_id=self.repo_id,
+            repo_type=self.repo_type,
+            revision=self.revision,
+            allow_patterns=allow_patterns,
+            ignore_patterns=ignore_patterns,
+            resume_download=self.resume_download,
+            force_download=self.force_download,
+            cache_dir=self.cache_dir,
+            token=self.token,
+            local_dir=self.local_dir,
+            local_dir_use_symlinks=self.local_dir_use_symlinks,
+            library_name="huggingface-cli",
+        )
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/env.py b/llm/Lib/site-packages/huggingface_hub/commands/env.py
new file mode 100644
index 0000000000000000000000000000000000000000..23f2828bbfebda0a633b4b3c6883432e4a534c79
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/commands/env.py
@@ -0,0 +1,36 @@
+# Copyright 2022 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains command to print information about the environment.
+
+Usage:
+    huggingface-cli env
+"""
+
+from argparse import _SubParsersAction
+
+from ..utils import dump_environment_info
+from . import BaseHuggingfaceCLICommand
+
+
+class EnvironmentCommand(BaseHuggingfaceCLICommand):
+    def __init__(self, args):
+        self.args = args
+
+    @staticmethod
+    def register_subcommand(parser: _SubParsersAction):
+        env_parser = parser.add_parser("env", help="Print information about the environment.")
+        env_parser.set_defaults(func=EnvironmentCommand)
+
+    def run(self) -> None:
+        dump_environment_info()
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/huggingface_cli.py b/llm/Lib/site-packages/huggingface_hub/commands/huggingface_cli.py
new file mode 100644
index 0000000000000000000000000000000000000000..39b6dfe49ab681f80dea6751e473843e5f685ff3
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/commands/huggingface_cli.py
@@ -0,0 +1,53 @@
+#!/usr/bin/env python
+# Copyright 2020 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from argparse import ArgumentParser
+
+from huggingface_hub.commands.delete_cache import DeleteCacheCommand
+from huggingface_hub.commands.download import DownloadCommand
+from huggingface_hub.commands.env import EnvironmentCommand
+from huggingface_hub.commands.lfs import LfsCommands
+from huggingface_hub.commands.scan_cache import ScanCacheCommand
+from huggingface_hub.commands.upload import UploadCommand
+from huggingface_hub.commands.user import UserCommands
+
+
+def main():
+    parser = ArgumentParser("huggingface-cli", usage="huggingface-cli <command> [<args>]")
+    commands_parser = parser.add_subparsers(help="huggingface-cli command helpers")
+
+    # Register commands
+    EnvironmentCommand.register_subcommand(commands_parser)
+    UserCommands.register_subcommand(commands_parser)
+    UploadCommand.register_subcommand(commands_parser)
+    DownloadCommand.register_subcommand(commands_parser)
+    LfsCommands.register_subcommand(commands_parser)
+    ScanCacheCommand.register_subcommand(commands_parser)
+    DeleteCacheCommand.register_subcommand(commands_parser)
+
+    # Let's go
+    args = parser.parse_args()
+
+    if not hasattr(args, "func"):
+        parser.print_help()
+        exit(1)
+
+    # Run
+    service = args.func(args)
+    service.run()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/lfs.py b/llm/Lib/site-packages/huggingface_hub/commands/lfs.py
new file mode 100644
index 0000000000000000000000000000000000000000..4dbf3cf55c67beebf4e6959ef180b30e29341a7c
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/commands/lfs.py
@@ -0,0 +1,199 @@
+"""
+Implementation of a custom transfer agent for the transfer type "multipart" for
+git-lfs.
+
+Inspired by:
+github.com/cbartz/git-lfs-swift-transfer-agent/blob/master/git_lfs_swift_transfer.py
+
+Spec is: github.com/git-lfs/git-lfs/blob/master/docs/custom-transfers.md
+
+
+To launch debugger while developing:
+
+``` [lfs "customtransfer.multipart"]
+path = /path/to/huggingface_hub/.env/bin/python args = -m debugpy --listen 5678
+--wait-for-client
+/path/to/huggingface_hub/src/huggingface_hub/commands/huggingface_cli.py
+lfs-multipart-upload ```"""
+
+import json
+import os
+import subprocess
+import sys
+from argparse import _SubParsersAction
+from typing import Dict, List, Optional
+
+from huggingface_hub.commands import BaseHuggingfaceCLICommand
+from huggingface_hub.lfs import LFS_MULTIPART_UPLOAD_COMMAND, SliceFileObj
+
+from ..utils import get_session, hf_raise_for_status, logging
+
+
+logger = logging.get_logger(__name__)
+
+
+class LfsCommands(BaseHuggingfaceCLICommand):
+    """
+    Implementation of a custom transfer agent for the transfer type "multipart"
+    for git-lfs. This lets users upload large files >5GB 🔥. Spec for LFS custom
+    transfer agent is:
+    https://github.com/git-lfs/git-lfs/blob/master/docs/custom-transfers.md
+
+    This introduces two commands to the CLI:
+
+    1. $ huggingface-cli lfs-enable-largefiles
+
+    This should be executed once for each model repo that contains a model file
+    >5GB. It's documented in the error message you get if you just try to git
+    push a 5GB file without having enabled it before.
+
+    2. $ huggingface-cli lfs-multipart-upload
+
+    This command is called by lfs directly and is not meant to be called by the
+    user.
+    """
+
+    @staticmethod
+    def register_subcommand(parser: _SubParsersAction):
+        enable_parser = parser.add_parser(
+            "lfs-enable-largefiles", help="Configure your repository to enable upload of files > 5GB."
+        )
+        enable_parser.add_argument("path", type=str, help="Local path to repository you want to configure.")
+        enable_parser.set_defaults(func=lambda args: LfsEnableCommand(args))
+
+        # Command will get called by git-lfs, do not call it directly.
+        upload_parser = parser.add_parser(LFS_MULTIPART_UPLOAD_COMMAND, add_help=False)
+        upload_parser.set_defaults(func=lambda args: LfsUploadCommand(args))
+
+
+class LfsEnableCommand:
+    def __init__(self, args):
+        self.args = args
+
+    def run(self):
+        local_path = os.path.abspath(self.args.path)
+        if not os.path.isdir(local_path):
+            print("This does not look like a valid git repo.")
+            exit(1)
+        subprocess.run(
+            "git config lfs.customtransfer.multipart.path huggingface-cli".split(),
+            check=True,
+            cwd=local_path,
+        )
+        subprocess.run(
+            f"git config lfs.customtransfer.multipart.args {LFS_MULTIPART_UPLOAD_COMMAND}".split(),
+            check=True,
+            cwd=local_path,
+        )
+        print("Local repo set up for largefiles")
+
+
+def write_msg(msg: Dict):
+    """Write out the message in Line delimited JSON."""
+    msg_str = json.dumps(msg) + "\n"
+    sys.stdout.write(msg_str)
+    sys.stdout.flush()
+
+
+def read_msg() -> Optional[Dict]:
+    """Read Line delimited JSON from stdin."""
+    msg = json.loads(sys.stdin.readline().strip())
+
+    if "terminate" in (msg.get("type"), msg.get("event")):
+        # terminate message received
+        return None
+
+    if msg.get("event") not in ("download", "upload"):
+        logger.critical("Received unexpected message")
+        sys.exit(1)
+
+    return msg
+
+
+class LfsUploadCommand:
+    def __init__(self, args) -> None:
+        self.args = args
+
+    def run(self) -> None:
+        # Immediately after invoking a custom transfer process, git-lfs
+        # sends initiation data to the process over stdin.
+        # This tells the process useful information about the configuration.
+        init_msg = json.loads(sys.stdin.readline().strip())
+        if not (init_msg.get("event") == "init" and init_msg.get("operation") == "upload"):
+            write_msg({"error": {"code": 32, "message": "Wrong lfs init operation"}})
+            sys.exit(1)
+
+        # The transfer process should use the information it needs from the
+        # initiation structure, and also perform any one-off setup tasks it
+        # needs to do. It should then respond on stdout with a simple empty
+        # confirmation structure, as follows:
+        write_msg({})
+
+        # After the initiation exchange, git-lfs will send any number of
+        # transfer requests to the stdin of the transfer process, in a serial sequence.
+        while True:
+            msg = read_msg()
+            if msg is None:
+                # When all transfers have been processed, git-lfs will send
+                # a terminate event to the stdin of the transfer process.
+                # On receiving this message the transfer process should
+                # clean up and terminate. No response is expected.
+                sys.exit(0)
+
+            oid = msg["oid"]
+            filepath = msg["path"]
+            completion_url = msg["action"]["href"]
+            header = msg["action"]["header"]
+            chunk_size = int(header.pop("chunk_size"))
+            presigned_urls: List[str] = list(header.values())
+
+            # Send a "started" progress event to allow other workers to start.
+            # Otherwise they're delayed until first "progress" event is reported,
+            # i.e. after the first 5GB by default (!)
+            write_msg(
+                {
+                    "event": "progress",
+                    "oid": oid,
+                    "bytesSoFar": 1,
+                    "bytesSinceLast": 0,
+                }
+            )
+
+            parts = []
+            with open(filepath, "rb") as file:
+                for i, presigned_url in enumerate(presigned_urls):
+                    with SliceFileObj(
+                        file,
+                        seek_from=i * chunk_size,
+                        read_limit=chunk_size,
+                    ) as data:
+                        r = get_session().put(presigned_url, data=data)
+                        hf_raise_for_status(r)
+                        parts.append(
+                            {
+                                "etag": r.headers.get("etag"),
+                                "partNumber": i + 1,
+                            }
+                        )
+                        # In order to support progress reporting while data is uploading / downloading,
+                        # the transfer process should post messages to stdout
+                        write_msg(
+                            {
+                                "event": "progress",
+                                "oid": oid,
+                                "bytesSoFar": (i + 1) * chunk_size,
+                                "bytesSinceLast": chunk_size,
+                            }
+                        )
+                        # Not precise but that's ok.
+
+            r = get_session().post(
+                completion_url,
+                json={
+                    "oid": oid,
+                    "parts": parts,
+                },
+            )
+            hf_raise_for_status(r)
+
+            write_msg({"event": "complete", "oid": oid})
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/scan_cache.py b/llm/Lib/site-packages/huggingface_hub/commands/scan_cache.py
new file mode 100644
index 0000000000000000000000000000000000000000..d0ab3399be86799fe2cd79f1feb515994a0f479f
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/commands/scan_cache.py
@@ -0,0 +1,139 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains command to scan the HF cache directory.
+
+Usage:
+    huggingface-cli scan-cache
+    huggingface-cli scan-cache -v
+    huggingface-cli scan-cache -vvv
+    huggingface-cli scan-cache --dir ~/.cache/huggingface/hub
+"""
+
+import time
+from argparse import Namespace, _SubParsersAction
+from typing import Optional
+
+from ..utils import CacheNotFound, HFCacheInfo, scan_cache_dir
+from . import BaseHuggingfaceCLICommand
+from ._cli_utils import ANSI, tabulate
+
+
+class ScanCacheCommand(BaseHuggingfaceCLICommand):
+    @staticmethod
+    def register_subcommand(parser: _SubParsersAction):
+        scan_cache_parser = parser.add_parser("scan-cache", help="Scan cache directory.")
+
+        scan_cache_parser.add_argument(
+            "--dir",
+            type=str,
+            default=None,
+            help="cache directory to scan (optional). Default to the default HuggingFace cache.",
+        )
+        scan_cache_parser.add_argument(
+            "-v",
+            "--verbose",
+            action="count",
+            default=0,
+            help="show a more verbose output",
+        )
+        scan_cache_parser.set_defaults(func=ScanCacheCommand)
+
+    def __init__(self, args: Namespace) -> None:
+        self.verbosity: int = args.verbose
+        self.cache_dir: Optional[str] = args.dir
+
+    def run(self):
+        try:
+            t0 = time.time()
+            hf_cache_info = scan_cache_dir(self.cache_dir)
+            t1 = time.time()
+        except CacheNotFound as exc:
+            cache_dir = exc.cache_dir
+            print(f"Cache directory not found: {cache_dir}")
+            return
+
+        self._print_hf_cache_info_as_table(hf_cache_info)
+
+        print(
+            f"\nDone in {round(t1-t0,1)}s. Scanned {len(hf_cache_info.repos)} repo(s)"
+            f" for a total of {ANSI.red(hf_cache_info.size_on_disk_str)}."
+        )
+        if len(hf_cache_info.warnings) > 0:
+            message = f"Got {len(hf_cache_info.warnings)} warning(s) while scanning."
+            if self.verbosity >= 3:
+                print(ANSI.gray(message))
+                for warning in hf_cache_info.warnings:
+                    print(ANSI.gray(warning))
+            else:
+                print(ANSI.gray(message + " Use -vvv to print details."))
+
+    def _print_hf_cache_info_as_table(self, hf_cache_info: HFCacheInfo) -> None:
+        if self.verbosity == 0:
+            print(
+                tabulate(
+                    rows=[
+                        [
+                            repo.repo_id,
+                            repo.repo_type,
+                            "{:>12}".format(repo.size_on_disk_str),
+                            repo.nb_files,
+                            repo.last_accessed_str,
+                            repo.last_modified_str,
+                            ", ".join(sorted(repo.refs)),
+                            str(repo.repo_path),
+                        ]
+                        for repo in sorted(hf_cache_info.repos, key=lambda repo: repo.repo_path)
+                    ],
+                    headers=[
+                        "REPO ID",
+                        "REPO TYPE",
+                        "SIZE ON DISK",
+                        "NB FILES",
+                        "LAST_ACCESSED",
+                        "LAST_MODIFIED",
+                        "REFS",
+                        "LOCAL PATH",
+                    ],
+                )
+            )
+        else:
+            print(
+                tabulate(
+                    rows=[
+                        [
+                            repo.repo_id,
+                            repo.repo_type,
+                            revision.commit_hash,
+                            "{:>12}".format(revision.size_on_disk_str),
+                            revision.nb_files,
+                            revision.last_modified_str,
+                            ", ".join(sorted(revision.refs)),
+                            str(revision.snapshot_path),
+                        ]
+                        for repo in sorted(hf_cache_info.repos, key=lambda repo: repo.repo_path)
+                        for revision in sorted(repo.revisions, key=lambda revision: revision.commit_hash)
+                    ],
+                    headers=[
+                        "REPO ID",
+                        "REPO TYPE",
+                        "REVISION",
+                        "SIZE ON DISK",
+                        "NB FILES",
+                        "LAST_MODIFIED",
+                        "REFS",
+                        "LOCAL PATH",
+                    ],
+                )
+            )
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/upload.py b/llm/Lib/site-packages/huggingface_hub/commands/upload.py
new file mode 100644
index 0000000000000000000000000000000000000000..a42dd0f8824d067b1c7952080a075c6f67cee7c4
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/commands/upload.py
@@ -0,0 +1,298 @@
+# coding=utf-8
+# Copyright 2023-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains command to upload a repo or file with the CLI.
+
+Usage:
+    # Upload file (implicit)
+    huggingface-cli upload my-cool-model ./my-cool-model.safetensors
+
+    # Upload file (explicit)
+    huggingface-cli upload my-cool-model ./my-cool-model.safetensors  model.safetensors
+
+    # Upload directory (implicit). If `my-cool-model/` is a directory it will be uploaded, otherwise an exception is raised.
+    huggingface-cli upload my-cool-model
+
+    # Upload directory (explicit)
+    huggingface-cli upload my-cool-model ./models/my-cool-model .
+
+    # Upload filtered directory (example: tensorboard logs except for the last run)
+    huggingface-cli upload my-cool-model ./model/training /logs --include "*.tfevents.*" --exclude "*20230905*"
+
+    # Upload private dataset
+    huggingface-cli upload Wauplin/my-cool-dataset ./data . --repo-type=dataset --private
+
+    # Upload with token
+    huggingface-cli upload Wauplin/my-cool-model --token=hf_****
+
+    # Sync local Space with Hub (upload new files, delete removed files)
+    huggingface-cli upload Wauplin/space-example --repo-type=space --exclude="/logs/*" --delete="*" --commit-message="Sync local Space with Hub"
+
+    # Schedule commits every 30 minutes
+    huggingface-cli upload Wauplin/my-cool-model --every=30
+"""
+
+import os
+import time
+import warnings
+from argparse import Namespace, _SubParsersAction
+from typing import List, Optional
+
+from huggingface_hub import logging
+from huggingface_hub._commit_scheduler import CommitScheduler
+from huggingface_hub.commands import BaseHuggingfaceCLICommand
+from huggingface_hub.constants import HF_HUB_ENABLE_HF_TRANSFER
+from huggingface_hub.hf_api import HfApi
+from huggingface_hub.utils import RevisionNotFoundError, disable_progress_bars, enable_progress_bars
+
+
+logger = logging.get_logger(__name__)
+
+
+class UploadCommand(BaseHuggingfaceCLICommand):
+    @staticmethod
+    def register_subcommand(parser: _SubParsersAction):
+        upload_parser = parser.add_parser("upload", help="Upload a file or a folder to a repo on the Hub")
+        upload_parser.add_argument(
+            "repo_id", type=str, help="The ID of the repo to upload to (e.g. `username/repo-name`)."
+        )
+        upload_parser.add_argument(
+            "local_path", nargs="?", help="Local path to the file or folder to upload. Defaults to current directory."
+        )
+        upload_parser.add_argument(
+            "path_in_repo",
+            nargs="?",
+            help="Path of the file or folder in the repo. Defaults to the relative path of the file or folder.",
+        )
+        upload_parser.add_argument(
+            "--repo-type",
+            choices=["model", "dataset", "space"],
+            default="model",
+            help="Type of the repo to upload to (e.g. `dataset`).",
+        )
+        upload_parser.add_argument(
+            "--revision",
+            type=str,
+            help=(
+                "An optional Git revision to push to. It can be a branch name or a PR reference. If revision does not"
+                " exist and `--create-pr` is not set, a branch will be automatically created."
+            ),
+        )
+        upload_parser.add_argument(
+            "--private",
+            action="store_true",
+            help=(
+                "Whether to create a private repo if repo doesn't exist on the Hub. Ignored if the repo already"
+                " exists."
+            ),
+        )
+        upload_parser.add_argument("--include", nargs="*", type=str, help="Glob patterns to match files to upload.")
+        upload_parser.add_argument(
+            "--exclude", nargs="*", type=str, help="Glob patterns to exclude from files to upload."
+        )
+        upload_parser.add_argument(
+            "--delete",
+            nargs="*",
+            type=str,
+            help="Glob patterns for file to be deleted from the repo while committing.",
+        )
+        upload_parser.add_argument(
+            "--commit-message", type=str, help="The summary / title / first line of the generated commit."
+        )
+        upload_parser.add_argument("--commit-description", type=str, help="The description of the generated commit.")
+        upload_parser.add_argument(
+            "--create-pr", action="store_true", help="Whether to upload content as a new Pull Request."
+        )
+        upload_parser.add_argument(
+            "--every",
+            type=float,
+            help="If set, a background job is scheduled to create commits every `every` minutes.",
+        )
+        upload_parser.add_argument(
+            "--token", type=str, help="A User Access Token generated from https://huggingface.co/settings/tokens"
+        )
+        upload_parser.add_argument(
+            "--quiet",
+            action="store_true",
+            help="If True, progress bars are disabled and only the path to the uploaded files is printed.",
+        )
+        upload_parser.set_defaults(func=UploadCommand)
+
+    def __init__(self, args: Namespace) -> None:
+        self.repo_id: str = args.repo_id
+        self.repo_type: Optional[str] = args.repo_type
+        self.revision: Optional[str] = args.revision
+        self.private: bool = args.private
+
+        self.include: Optional[List[str]] = args.include
+        self.exclude: Optional[List[str]] = args.exclude
+        self.delete: Optional[List[str]] = args.delete
+
+        self.commit_message: Optional[str] = args.commit_message
+        self.commit_description: Optional[str] = args.commit_description
+        self.create_pr: bool = args.create_pr
+        self.api: HfApi = HfApi(token=args.token, library_name="huggingface-cli")
+        self.quiet: bool = args.quiet  # disable warnings and progress bars
+
+        # Check `--every` is valid
+        if args.every is not None and args.every <= 0:
+            raise ValueError(f"`every` must be a positive value (got '{args.every}')")
+        self.every: Optional[float] = args.every
+
+        # Resolve `local_path` and `path_in_repo`
+        repo_name: str = args.repo_id.split("/")[-1]  # e.g. "Wauplin/my-cool-model" => "my-cool-model"
+        self.local_path: str
+        self.path_in_repo: str
+        if args.local_path is None and os.path.isfile(repo_name):
+            # Implicit case 1: user provided only a repo_id which happen to be a local file as well => upload it with same name
+            self.local_path = repo_name
+            self.path_in_repo = repo_name
+        elif args.local_path is None and os.path.isdir(repo_name):
+            # Implicit case 2: user provided only a repo_id which happen to be a local folder as well => upload it at root
+            self.local_path = repo_name
+            self.path_in_repo = "."
+        elif args.local_path is None:
+            # Implicit case 3: user provided only a repo_id that does not match a local file or folder
+            # => the user must explicitly provide a local_path => raise exception
+            raise ValueError(f"'{repo_name}' is not a local file or folder. Please set `local_path` explicitly.")
+        elif args.path_in_repo is None and os.path.isfile(args.local_path):
+            # Explicit local path to file, no path in repo => upload it at root with same name
+            self.local_path = args.local_path
+            self.path_in_repo = os.path.basename(args.local_path)
+        elif args.path_in_repo is None:
+            # Explicit local path to folder, no path in repo => upload at root
+            self.local_path = args.local_path
+            self.path_in_repo = "."
+        else:
+            # Finally, if both paths are explicit
+            self.local_path = args.local_path
+            self.path_in_repo = args.path_in_repo
+
+    def run(self) -> None:
+        if self.quiet:
+            disable_progress_bars()
+            with warnings.catch_warnings():
+                warnings.simplefilter("ignore")
+                print(self._upload())
+            enable_progress_bars()
+        else:
+            logging.set_verbosity_info()
+            print(self._upload())
+            logging.set_verbosity_warning()
+
+    def _upload(self) -> str:
+        if os.path.isfile(self.local_path):
+            if self.include is not None and len(self.include) > 0:
+                warnings.warn("Ignoring `--include` since a single file is uploaded.")
+            if self.exclude is not None and len(self.exclude) > 0:
+                warnings.warn("Ignoring `--exclude` since a single file is uploaded.")
+            if self.delete is not None and len(self.delete) > 0:
+                warnings.warn("Ignoring `--delete` since a single file is uploaded.")
+
+        if not HF_HUB_ENABLE_HF_TRANSFER:
+            logger.info(
+                "Consider using `hf_transfer` for faster uploads. This solution comes with some limitations. See"
+                " https://huggingface.co/docs/huggingface_hub/hf_transfer for more details."
+            )
+
+        # Schedule commits if `every` is set
+        if self.every is not None:
+            if os.path.isfile(self.local_path):
+                # If file => watch entire folder + use allow_patterns
+                folder_path = os.path.dirname(self.local_path)
+                path_in_repo = (
+                    self.path_in_repo[: -len(self.local_path)]  # remove filename from path_in_repo
+                    if self.path_in_repo.endswith(self.local_path)
+                    else self.path_in_repo
+                )
+                allow_patterns = [self.local_path]
+                ignore_patterns = []
+            else:
+                folder_path = self.local_path
+                path_in_repo = self.path_in_repo
+                allow_patterns = self.include or []
+                ignore_patterns = self.exclude or []
+                if self.delete is not None and len(self.delete) > 0:
+                    warnings.warn("Ignoring `--delete` when uploading with scheduled commits.")
+
+            scheduler = CommitScheduler(
+                folder_path=folder_path,
+                repo_id=self.repo_id,
+                repo_type=self.repo_type,
+                revision=self.revision,
+                allow_patterns=allow_patterns,
+                ignore_patterns=ignore_patterns,
+                path_in_repo=path_in_repo,
+                private=self.private,
+                every=self.every,
+                hf_api=self.api,
+            )
+            print(f"Scheduling commits every {self.every} minutes to {scheduler.repo_id}.")
+            try:  # Block main thread until KeyboardInterrupt
+                while True:
+                    time.sleep(100)
+            except KeyboardInterrupt:
+                scheduler.stop()
+                return "Stopped scheduled commits."
+
+        # Otherwise, create repo and proceed with the upload
+        if not os.path.isfile(self.local_path) and not os.path.isdir(self.local_path):
+            raise FileNotFoundError(f"No such file or directory: '{self.local_path}'.")
+        repo_id = self.api.create_repo(
+            repo_id=self.repo_id,
+            repo_type=self.repo_type,
+            exist_ok=True,
+            private=self.private,
+            space_sdk="gradio" if self.repo_type == "space" else None,
+            # ^ We don't want it to fail when uploading to a Space => let's set Gradio by default.
+            # ^ I'd rather not add CLI args to set it explicitly as we already have `huggingface-cli repo create` for that.
+        ).repo_id
+
+        # Check if branch already exists and if not, create it
+        if self.revision is not None and not self.create_pr:
+            try:
+                self.api.repo_info(repo_id=repo_id, repo_type=self.repo_type, revision=self.revision)
+            except RevisionNotFoundError:
+                logger.info(f"Branch '{self.revision}' not found. Creating it...")
+                self.api.create_branch(repo_id=repo_id, repo_type=self.repo_type, branch=self.revision, exist_ok=True)
+                # ^ `exist_ok=True` to avoid race concurrency issues
+
+        # File-based upload
+        if os.path.isfile(self.local_path):
+            return self.api.upload_file(
+                path_or_fileobj=self.local_path,
+                path_in_repo=self.path_in_repo,
+                repo_id=repo_id,
+                repo_type=self.repo_type,
+                revision=self.revision,
+                commit_message=self.commit_message,
+                commit_description=self.commit_description,
+                create_pr=self.create_pr,
+            )
+
+        # Folder-based upload
+        else:
+            return self.api.upload_folder(
+                folder_path=self.local_path,
+                path_in_repo=self.path_in_repo,
+                repo_id=repo_id,
+                repo_type=self.repo_type,
+                revision=self.revision,
+                commit_message=self.commit_message,
+                commit_description=self.commit_description,
+                create_pr=self.create_pr,
+                allow_patterns=self.include,
+                ignore_patterns=self.exclude,
+                delete_patterns=self.delete,
+            )
diff --git a/llm/Lib/site-packages/huggingface_hub/commands/user.py b/llm/Lib/site-packages/huggingface_hub/commands/user.py
new file mode 100644
index 0000000000000000000000000000000000000000..8cde3ac04c8a0773cad0a767a8d14b36dce4ee2e
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/commands/user.py
@@ -0,0 +1,188 @@
+# Copyright 2020 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import subprocess
+from argparse import _SubParsersAction
+
+from requests.exceptions import HTTPError
+
+from huggingface_hub.commands import BaseHuggingfaceCLICommand
+from huggingface_hub.constants import (
+    ENDPOINT,
+    REPO_TYPES,
+    REPO_TYPES_URL_PREFIXES,
+    SPACES_SDK_TYPES,
+)
+from huggingface_hub.hf_api import HfApi
+
+from .._login import (  # noqa: F401 # for backward compatibility  # noqa: F401 # for backward compatibility
+    NOTEBOOK_LOGIN_PASSWORD_HTML,
+    NOTEBOOK_LOGIN_TOKEN_HTML_END,
+    NOTEBOOK_LOGIN_TOKEN_HTML_START,
+    login,
+    logout,
+    notebook_login,
+)
+from ..utils import get_token
+from ._cli_utils import ANSI
+
+
+class UserCommands(BaseHuggingfaceCLICommand):
+    @staticmethod
+    def register_subcommand(parser: _SubParsersAction):
+        login_parser = parser.add_parser("login", help="Log in using a token from huggingface.co/settings/tokens")
+        login_parser.add_argument(
+            "--token",
+            type=str,
+            help="Token generated from https://huggingface.co/settings/tokens",
+        )
+        login_parser.add_argument(
+            "--add-to-git-credential",
+            action="store_true",
+            help="Optional: Save token to git credential helper.",
+        )
+        login_parser.set_defaults(func=lambda args: LoginCommand(args))
+        whoami_parser = parser.add_parser("whoami", help="Find out which huggingface.co account you are logged in as.")
+        whoami_parser.set_defaults(func=lambda args: WhoamiCommand(args))
+        logout_parser = parser.add_parser("logout", help="Log out")
+        logout_parser.set_defaults(func=lambda args: LogoutCommand(args))
+
+        # new system: git-based repo system
+        repo_parser = parser.add_parser("repo", help="{create} Commands to interact with your huggingface.co repos.")
+        repo_subparsers = repo_parser.add_subparsers(help="huggingface.co repos related commands")
+        repo_create_parser = repo_subparsers.add_parser("create", help="Create a new repo on huggingface.co")
+        repo_create_parser.add_argument(
+            "name",
+            type=str,
+            help="Name for your repo. Will be namespaced under your username to build the repo id.",
+        )
+        repo_create_parser.add_argument(
+            "--type",
+            type=str,
+            help='Optional: repo_type: set to "dataset" or "space" if creating a dataset or space, default is model.',
+        )
+        repo_create_parser.add_argument("--organization", type=str, help="Optional: organization namespace.")
+        repo_create_parser.add_argument(
+            "--space_sdk",
+            type=str,
+            help='Optional: Hugging Face Spaces SDK type. Required when --type is set to "space".',
+            choices=SPACES_SDK_TYPES,
+        )
+        repo_create_parser.add_argument(
+            "-y",
+            "--yes",
+            action="store_true",
+            help="Optional: answer Yes to the prompt",
+        )
+        repo_create_parser.set_defaults(func=lambda args: RepoCreateCommand(args))
+
+
+class BaseUserCommand:
+    def __init__(self, args):
+        self.args = args
+        self._api = HfApi()
+
+
+class LoginCommand(BaseUserCommand):
+    def run(self):
+        login(token=self.args.token, add_to_git_credential=self.args.add_to_git_credential)
+
+
+class LogoutCommand(BaseUserCommand):
+    def run(self):
+        logout()
+
+
+class WhoamiCommand(BaseUserCommand):
+    def run(self):
+        token = get_token()
+        if token is None:
+            print("Not logged in")
+            exit()
+        try:
+            info = self._api.whoami(token)
+            print(info["name"])
+            orgs = [org["name"] for org in info["orgs"]]
+            if orgs:
+                print(ANSI.bold("orgs: "), ",".join(orgs))
+
+            if ENDPOINT != "https://huggingface.co":
+                print(f"Authenticated through private endpoint: {ENDPOINT}")
+        except HTTPError as e:
+            print(e)
+            print(ANSI.red(e.response.text))
+            exit(1)
+
+
+class RepoCreateCommand(BaseUserCommand):
+    def run(self):
+        token = get_token()
+        if token is None:
+            print("Not logged in")
+            exit(1)
+        try:
+            stdout = subprocess.check_output(["git", "--version"]).decode("utf-8")
+            print(ANSI.gray(stdout.strip()))
+        except FileNotFoundError:
+            print("Looks like you do not have git installed, please install.")
+
+        try:
+            stdout = subprocess.check_output(["git-lfs", "--version"]).decode("utf-8")
+            print(ANSI.gray(stdout.strip()))
+        except FileNotFoundError:
+            print(
+                ANSI.red(
+                    "Looks like you do not have git-lfs installed, please install."
+                    " You can install from https://git-lfs.github.com/."
+                    " Then run `git lfs install` (you only have to do this once)."
+                )
+            )
+        print("")
+
+        user = self._api.whoami(token)["name"]
+        namespace = self.args.organization if self.args.organization is not None else user
+
+        repo_id = f"{namespace}/{self.args.name}"
+
+        if self.args.type not in REPO_TYPES:
+            print("Invalid repo --type")
+            exit(1)
+
+        if self.args.type in REPO_TYPES_URL_PREFIXES:
+            prefixed_repo_id = REPO_TYPES_URL_PREFIXES[self.args.type] + repo_id
+        else:
+            prefixed_repo_id = repo_id
+
+        print(f"You are about to create {ANSI.bold(prefixed_repo_id)}")
+
+        if not self.args.yes:
+            choice = input("Proceed? [Y/n] ").lower()
+            if not (choice == "" or choice == "y" or choice == "yes"):
+                print("Abort")
+                exit()
+        try:
+            url = self._api.create_repo(
+                repo_id=repo_id,
+                token=token,
+                repo_type=self.args.type,
+                space_sdk=self.args.space_sdk,
+            )
+        except HTTPError as e:
+            print(e)
+            print(ANSI.red(e.response.text))
+            exit(1)
+        print("\nYour repo now lives at:")
+        print(f"  {ANSI.bold(url)}")
+        print("\nYou can clone it locally with the command below, and commit/push as usual.")
+        print(f"\n  git clone {url}")
+        print("")
diff --git a/llm/Lib/site-packages/huggingface_hub/community.py b/llm/Lib/site-packages/huggingface_hub/community.py
new file mode 100644
index 0000000000000000000000000000000000000000..387b0cc12174cafd9f4080d05cbc748e59a51b81
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/community.py
@@ -0,0 +1,355 @@
+"""
+Data structures to interact with Discussions and Pull Requests on the Hub.
+
+See [the Discussions and Pull Requests guide](https://huggingface.co/docs/hub/repositories-pull-requests-discussions)
+for more information on Pull Requests, Discussions, and the community tab.
+"""
+
+from dataclasses import dataclass
+from datetime import datetime
+from typing import List, Literal, Optional, Union
+
+from .constants import REPO_TYPE_MODEL
+from .utils import parse_datetime
+
+
+DiscussionStatus = Literal["open", "closed", "merged", "draft"]
+
+
+@dataclass
+class Discussion:
+    """
+    A Discussion or Pull Request on the Hub.
+
+    This dataclass is not intended to be instantiated directly.
+
+    Attributes:
+        title (`str`):
+            The title of the Discussion / Pull Request
+        status (`str`):
+            The status of the Discussion / Pull Request.
+            It must be one of:
+                * `"open"`
+                * `"closed"`
+                * `"merged"` (only for Pull Requests )
+                * `"draft"` (only for Pull Requests )
+        num (`int`):
+            The number of the Discussion / Pull Request.
+        repo_id (`str`):
+            The id (`"{namespace}/{repo_name}"`) of the repo on which
+            the Discussion / Pull Request was open.
+        repo_type (`str`):
+            The type of the repo on which the Discussion / Pull Request was open.
+            Possible values are: `"model"`, `"dataset"`, `"space"`.
+        author (`str`):
+            The username of the Discussion / Pull Request author.
+            Can be `"deleted"` if the user has been deleted since.
+        is_pull_request (`bool`):
+            Whether or not this is a Pull Request.
+        created_at (`datetime`):
+            The `datetime` of creation of the Discussion / Pull Request.
+        endpoint (`str`):
+            Endpoint of the Hub. Default is https://huggingface.co.
+        git_reference (`str`, *optional*):
+            (property) Git reference to which changes can be pushed if this is a Pull Request, `None` otherwise.
+        url (`str`):
+            (property) URL of the discussion on the Hub.
+    """
+
+    title: str
+    status: DiscussionStatus
+    num: int
+    repo_id: str
+    repo_type: str
+    author: str
+    is_pull_request: bool
+    created_at: datetime
+    endpoint: str
+
+    @property
+    def git_reference(self) -> Optional[str]:
+        """
+        If this is a Pull Request , returns the git reference to which changes can be pushed.
+        Returns `None` otherwise.
+        """
+        if self.is_pull_request:
+            return f"refs/pr/{self.num}"
+        return None
+
+    @property
+    def url(self) -> str:
+        """Returns the URL of the discussion on the Hub."""
+        if self.repo_type is None or self.repo_type == REPO_TYPE_MODEL:
+            return f"{self.endpoint}/{self.repo_id}/discussions/{self.num}"
+        return f"{self.endpoint}/{self.repo_type}s/{self.repo_id}/discussions/{self.num}"
+
+
+@dataclass
+class DiscussionWithDetails(Discussion):
+    """
+    Subclass of [`Discussion`].
+
+    Attributes:
+        title (`str`):
+            The title of the Discussion / Pull Request
+        status (`str`):
+            The status of the Discussion / Pull Request.
+            It can be one of:
+                * `"open"`
+                * `"closed"`
+                * `"merged"` (only for Pull Requests )
+                * `"draft"` (only for Pull Requests )
+        num (`int`):
+            The number of the Discussion / Pull Request.
+        repo_id (`str`):
+            The id (`"{namespace}/{repo_name}"`) of the repo on which
+            the Discussion / Pull Request was open.
+        repo_type (`str`):
+            The type of the repo on which the Discussion / Pull Request was open.
+            Possible values are: `"model"`, `"dataset"`, `"space"`.
+        author (`str`):
+            The username of the Discussion / Pull Request author.
+            Can be `"deleted"` if the user has been deleted since.
+        is_pull_request (`bool`):
+            Whether or not this is a Pull Request.
+        created_at (`datetime`):
+            The `datetime` of creation of the Discussion / Pull Request.
+        events (`list` of [`DiscussionEvent`])
+            The list of [`DiscussionEvents`] in this Discussion or Pull Request.
+        conflicting_files (`Union[List[str], bool, None]`, *optional*):
+            A list of conflicting files if this is a Pull Request.
+            `None` if `self.is_pull_request` is `False`.
+            `True` if there are conflicting files but the list can't be retrieved.
+        target_branch (`str`, *optional*):
+            The branch into which changes are to be merged if this is a
+            Pull Request . `None`  if `self.is_pull_request` is `False`.
+        merge_commit_oid (`str`, *optional*):
+            If this is a merged Pull Request , this is set to the OID / SHA of
+            the merge commit, `None` otherwise.
+        diff (`str`, *optional*):
+            The git diff if this is a Pull Request , `None` otherwise.
+        endpoint (`str`):
+            Endpoint of the Hub. Default is https://huggingface.co.
+        git_reference (`str`, *optional*):
+            (property) Git reference to which changes can be pushed if this is a Pull Request, `None` otherwise.
+        url (`str`):
+            (property) URL of the discussion on the Hub.
+    """
+
+    events: List["DiscussionEvent"]
+    conflicting_files: Union[List[str], bool, None]
+    target_branch: Optional[str]
+    merge_commit_oid: Optional[str]
+    diff: Optional[str]
+
+
+@dataclass
+class DiscussionEvent:
+    """
+    An event in a Discussion or Pull Request.
+
+    Use concrete classes:
+        * [`DiscussionComment`]
+        * [`DiscussionStatusChange`]
+        * [`DiscussionCommit`]
+        * [`DiscussionTitleChange`]
+
+    Attributes:
+        id (`str`):
+            The ID of the event. An hexadecimal string.
+        type (`str`):
+            The type of the event.
+        created_at (`datetime`):
+            A [`datetime`](https://docs.python.org/3/library/datetime.html?highlight=datetime#datetime.datetime)
+            object holding the creation timestamp for the event.
+        author (`str`):
+            The username of the Discussion / Pull Request author.
+            Can be `"deleted"` if the user has been deleted since.
+    """
+
+    id: str
+    type: str
+    created_at: datetime
+    author: str
+
+    _event: dict
+    """Stores the original event data, in case we need to access it later."""
+
+
+@dataclass
+class DiscussionComment(DiscussionEvent):
+    """A comment in a Discussion / Pull Request.
+
+    Subclass of [`DiscussionEvent`].
+
+
+    Attributes:
+        id (`str`):
+            The ID of the event. An hexadecimal string.
+        type (`str`):
+            The type of the event.
+        created_at (`datetime`):
+            A [`datetime`](https://docs.python.org/3/library/datetime.html?highlight=datetime#datetime.datetime)
+            object holding the creation timestamp for the event.
+        author (`str`):
+            The username of the Discussion / Pull Request author.
+            Can be `"deleted"` if the user has been deleted since.
+        content (`str`):
+            The raw markdown content of the comment. Mentions, links and images are not rendered.
+        edited (`bool`):
+            Whether or not this comment has been edited.
+        hidden (`bool`):
+            Whether or not this comment has been hidden.
+    """
+
+    content: str
+    edited: bool
+    hidden: bool
+
+    @property
+    def rendered(self) -> str:
+        """The rendered comment, as a HTML string"""
+        return self._event["data"]["latest"]["html"]
+
+    @property
+    def last_edited_at(self) -> datetime:
+        """The last edit time, as a `datetime` object."""
+        return parse_datetime(self._event["data"]["latest"]["updatedAt"])
+
+    @property
+    def last_edited_by(self) -> str:
+        """The last edit time, as a `datetime` object."""
+        return self._event["data"]["latest"].get("author", {}).get("name", "deleted")
+
+    @property
+    def edit_history(self) -> List[dict]:
+        """The edit history of the comment"""
+        return self._event["data"]["history"]
+
+    @property
+    def number_of_edits(self) -> int:
+        return len(self.edit_history)
+
+
+@dataclass
+class DiscussionStatusChange(DiscussionEvent):
+    """A change of status in a Discussion / Pull Request.
+
+    Subclass of [`DiscussionEvent`].
+
+    Attributes:
+        id (`str`):
+            The ID of the event. An hexadecimal string.
+        type (`str`):
+            The type of the event.
+        created_at (`datetime`):
+            A [`datetime`](https://docs.python.org/3/library/datetime.html?highlight=datetime#datetime.datetime)
+            object holding the creation timestamp for the event.
+        author (`str`):
+            The username of the Discussion / Pull Request author.
+            Can be `"deleted"` if the user has been deleted since.
+        new_status (`str`):
+            The status of the Discussion / Pull Request after the change.
+            It can be one of:
+                * `"open"`
+                * `"closed"`
+                * `"merged"` (only for Pull Requests )
+    """
+
+    new_status: str
+
+
+@dataclass
+class DiscussionCommit(DiscussionEvent):
+    """A commit in a Pull Request.
+
+    Subclass of [`DiscussionEvent`].
+
+    Attributes:
+        id (`str`):
+            The ID of the event. An hexadecimal string.
+        type (`str`):
+            The type of the event.
+        created_at (`datetime`):
+            A [`datetime`](https://docs.python.org/3/library/datetime.html?highlight=datetime#datetime.datetime)
+            object holding the creation timestamp for the event.
+        author (`str`):
+            The username of the Discussion / Pull Request author.
+            Can be `"deleted"` if the user has been deleted since.
+        summary (`str`):
+            The summary of the commit.
+        oid (`str`):
+            The OID / SHA of the commit, as a hexadecimal string.
+    """
+
+    summary: str
+    oid: str
+
+
+@dataclass
+class DiscussionTitleChange(DiscussionEvent):
+    """A rename event in a Discussion / Pull Request.
+
+    Subclass of [`DiscussionEvent`].
+
+    Attributes:
+        id (`str`):
+            The ID of the event. An hexadecimal string.
+        type (`str`):
+            The type of the event.
+        created_at (`datetime`):
+            A [`datetime`](https://docs.python.org/3/library/datetime.html?highlight=datetime#datetime.datetime)
+            object holding the creation timestamp for the event.
+        author (`str`):
+            The username of the Discussion / Pull Request author.
+            Can be `"deleted"` if the user has been deleted since.
+        old_title (`str`):
+            The previous title for the Discussion / Pull Request.
+        new_title (`str`):
+            The new title.
+    """
+
+    old_title: str
+    new_title: str
+
+
+def deserialize_event(event: dict) -> DiscussionEvent:
+    """Instantiates a [`DiscussionEvent`] from a dict"""
+    event_id: str = event["id"]
+    event_type: str = event["type"]
+    created_at = parse_datetime(event["createdAt"])
+
+    common_args = dict(
+        id=event_id,
+        type=event_type,
+        created_at=created_at,
+        author=event.get("author", {}).get("name", "deleted"),
+        _event=event,
+    )
+
+    if event_type == "comment":
+        return DiscussionComment(
+            **common_args,
+            edited=event["data"]["edited"],
+            hidden=event["data"]["hidden"],
+            content=event["data"]["latest"]["raw"],
+        )
+    if event_type == "status-change":
+        return DiscussionStatusChange(
+            **common_args,
+            new_status=event["data"]["status"],
+        )
+    if event_type == "commit":
+        return DiscussionCommit(
+            **common_args,
+            summary=event["data"]["subject"],
+            oid=event["data"]["oid"],
+        )
+    if event_type == "title-change":
+        return DiscussionTitleChange(
+            **common_args,
+            old_title=event["data"]["from"],
+            new_title=event["data"]["to"],
+        )
+
+    return DiscussionEvent(**common_args)
diff --git a/llm/Lib/site-packages/huggingface_hub/constants.py b/llm/Lib/site-packages/huggingface_hub/constants.py
new file mode 100644
index 0000000000000000000000000000000000000000..ddebb6258078e21aec93f9a11e062d44620db2c1
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/constants.py
@@ -0,0 +1,215 @@
+import os
+import re
+import typing
+from typing import Literal, Optional, Tuple
+
+
+# Possible values for env variables
+
+
+ENV_VARS_TRUE_VALUES = {"1", "ON", "YES", "TRUE"}
+ENV_VARS_TRUE_AND_AUTO_VALUES = ENV_VARS_TRUE_VALUES.union({"AUTO"})
+
+
+def _is_true(value: Optional[str]) -> bool:
+    if value is None:
+        return False
+    return value.upper() in ENV_VARS_TRUE_VALUES
+
+
+def _as_int(value: Optional[str]) -> Optional[int]:
+    if value is None:
+        return None
+    return int(value)
+
+
+# Constants for file downloads
+
+PYTORCH_WEIGHTS_NAME = "pytorch_model.bin"
+TF2_WEIGHTS_NAME = "tf_model.h5"
+TF_WEIGHTS_NAME = "model.ckpt"
+FLAX_WEIGHTS_NAME = "flax_model.msgpack"
+CONFIG_NAME = "config.json"
+REPOCARD_NAME = "README.md"
+DEFAULT_ETAG_TIMEOUT = 10
+DEFAULT_DOWNLOAD_TIMEOUT = 10
+DEFAULT_REQUEST_TIMEOUT = 10
+DOWNLOAD_CHUNK_SIZE = 10 * 1024 * 1024
+HF_TRANSFER_CONCURRENCY = 100
+
+# Constants for safetensors repos
+
+SAFETENSORS_SINGLE_FILE = "model.safetensors"
+SAFETENSORS_INDEX_FILE = "model.safetensors.index.json"
+SAFETENSORS_MAX_HEADER_LENGTH = 25_000_000
+
+# Git-related constants
+
+DEFAULT_REVISION = "main"
+REGEX_COMMIT_OID = re.compile(r"[A-Fa-f0-9]{5,40}")
+
+HUGGINGFACE_CO_URL_HOME = "https://huggingface.co/"
+
+_staging_mode = _is_true(os.environ.get("HUGGINGFACE_CO_STAGING"))
+
+_HF_DEFAULT_ENDPOINT = "https://huggingface.co"
+_HF_DEFAULT_STAGING_ENDPOINT = "https://hub-ci.huggingface.co"
+ENDPOINT = os.getenv("HF_ENDPOINT") or (_HF_DEFAULT_STAGING_ENDPOINT if _staging_mode else _HF_DEFAULT_ENDPOINT)
+
+HUGGINGFACE_CO_URL_TEMPLATE = ENDPOINT + "/{repo_id}/resolve/{revision}/{filename}"
+HUGGINGFACE_HEADER_X_REPO_COMMIT = "X-Repo-Commit"
+HUGGINGFACE_HEADER_X_LINKED_ETAG = "X-Linked-Etag"
+HUGGINGFACE_HEADER_X_LINKED_SIZE = "X-Linked-Size"
+
+INFERENCE_ENDPOINT = os.environ.get("HF_INFERENCE_ENDPOINT", "https://api-inference.huggingface.co")
+
+# See https://huggingface.co/docs/inference-endpoints/index
+INFERENCE_ENDPOINTS_ENDPOINT = "https://api.endpoints.huggingface.cloud/v2"
+
+
+REPO_ID_SEPARATOR = "--"
+# ^ this substring is not allowed in repo_ids on hf.co
+# and is the canonical one we use for serialization of repo ids elsewhere.
+
+
+REPO_TYPE_DATASET = "dataset"
+REPO_TYPE_SPACE = "space"
+REPO_TYPE_MODEL = "model"
+REPO_TYPES = [None, REPO_TYPE_MODEL, REPO_TYPE_DATASET, REPO_TYPE_SPACE]
+SPACES_SDK_TYPES = ["gradio", "streamlit", "docker", "static"]
+
+REPO_TYPES_URL_PREFIXES = {
+    REPO_TYPE_DATASET: "datasets/",
+    REPO_TYPE_SPACE: "spaces/",
+}
+REPO_TYPES_MAPPING = {
+    "datasets": REPO_TYPE_DATASET,
+    "spaces": REPO_TYPE_SPACE,
+    "models": REPO_TYPE_MODEL,
+}
+
+DiscussionTypeFilter = Literal["all", "discussion", "pull_request"]
+DISCUSSION_TYPES: Tuple[DiscussionTypeFilter, ...] = typing.get_args(DiscussionTypeFilter)
+DiscussionStatusFilter = Literal["all", "open", "closed"]
+DISCUSSION_STATUS: Tuple[DiscussionTypeFilter, ...] = typing.get_args(DiscussionStatusFilter)
+
+# default cache
+default_home = os.path.join(os.path.expanduser("~"), ".cache")
+HF_HOME = os.path.expanduser(
+    os.getenv(
+        "HF_HOME",
+        os.path.join(os.getenv("XDG_CACHE_HOME", default_home), "huggingface"),
+    )
+)
+hf_cache_home = HF_HOME  # for backward compatibility. TODO: remove this in 1.0.0
+
+default_cache_path = os.path.join(HF_HOME, "hub")
+default_assets_cache_path = os.path.join(HF_HOME, "assets")
+
+# Legacy env variables
+HUGGINGFACE_HUB_CACHE = os.getenv("HUGGINGFACE_HUB_CACHE", default_cache_path)
+HUGGINGFACE_ASSETS_CACHE = os.getenv("HUGGINGFACE_ASSETS_CACHE", default_assets_cache_path)
+
+# New env variables
+HF_HUB_CACHE = os.getenv("HF_HUB_CACHE", HUGGINGFACE_HUB_CACHE)
+HF_ASSETS_CACHE = os.getenv("HF_ASSETS_CACHE", HUGGINGFACE_ASSETS_CACHE)
+
+HF_HUB_OFFLINE = _is_true(os.environ.get("HF_HUB_OFFLINE") or os.environ.get("TRANSFORMERS_OFFLINE"))
+
+# Opt-out from telemetry requests
+HF_HUB_DISABLE_TELEMETRY = (
+    _is_true(os.environ.get("HF_HUB_DISABLE_TELEMETRY"))  # HF-specific env variable
+    or _is_true(os.environ.get("DISABLE_TELEMETRY"))
+    or _is_true(os.environ.get("DO_NOT_TRACK"))  # https://consoledonottrack.com/
+)
+
+# In the past, token was stored in a hardcoded location
+# `_OLD_HF_TOKEN_PATH` is deprecated and will be removed "at some point".
+# See https://github.com/huggingface/huggingface_hub/issues/1232
+_OLD_HF_TOKEN_PATH = os.path.expanduser("~/.huggingface/token")
+HF_TOKEN_PATH = os.path.join(HF_HOME, "token")
+
+
+if _staging_mode:
+    # In staging mode, we use a different cache to ensure we don't mix up production and staging data or tokens
+    _staging_home = os.path.join(os.path.expanduser("~"), ".cache", "huggingface_staging")
+    HUGGINGFACE_HUB_CACHE = os.path.join(_staging_home, "hub")
+    _OLD_HF_TOKEN_PATH = os.path.join(_staging_home, "_old_token")
+    HF_TOKEN_PATH = os.path.join(_staging_home, "token")
+
+# Here, `True` will disable progress bars globally without possibility of enabling it
+# programmatically. `False` will enable them without possibility of disabling them.
+# If environment variable is not set (None), then the user is free to enable/disable
+# them programmatically.
+# TL;DR: env variable has priority over code
+__HF_HUB_DISABLE_PROGRESS_BARS = os.environ.get("HF_HUB_DISABLE_PROGRESS_BARS")
+HF_HUB_DISABLE_PROGRESS_BARS: Optional[bool] = (
+    _is_true(__HF_HUB_DISABLE_PROGRESS_BARS) if __HF_HUB_DISABLE_PROGRESS_BARS is not None else None
+)
+
+# Disable warning on machines that do not support symlinks (e.g. Windows non-developer)
+HF_HUB_DISABLE_SYMLINKS_WARNING: bool = _is_true(os.environ.get("HF_HUB_DISABLE_SYMLINKS_WARNING"))
+
+# Disable warning when using experimental features
+HF_HUB_DISABLE_EXPERIMENTAL_WARNING: bool = _is_true(os.environ.get("HF_HUB_DISABLE_EXPERIMENTAL_WARNING"))
+
+# Disable sending the cached token by default is all HTTP requests to the Hub
+HF_HUB_DISABLE_IMPLICIT_TOKEN: bool = _is_true(os.environ.get("HF_HUB_DISABLE_IMPLICIT_TOKEN"))
+
+# Enable fast-download using external dependency "hf_transfer"
+# See:
+# - https://pypi.org/project/hf-transfer/
+# - https://github.com/huggingface/hf_transfer (private)
+HF_HUB_ENABLE_HF_TRANSFER: bool = _is_true(os.environ.get("HF_HUB_ENABLE_HF_TRANSFER"))
+
+
+# Used if download to `local_dir` and `local_dir_use_symlinks="auto"`
+# Files smaller than 5MB are copy-pasted while bigger files are symlinked. The idea is to save disk-usage by symlinking
+# huge files (i.e. LFS files most of the time) while allowing small files to be manually edited in local folder.
+HF_HUB_LOCAL_DIR_AUTO_SYMLINK_THRESHOLD: int = (
+    _as_int(os.environ.get("HF_HUB_LOCAL_DIR_AUTO_SYMLINK_THRESHOLD")) or 5 * 1024 * 1024
+)
+
+# Used to override the etag timeout on a system level
+HF_HUB_ETAG_TIMEOUT: int = _as_int(os.environ.get("HF_HUB_ETAG_TIMEOUT")) or DEFAULT_ETAG_TIMEOUT
+
+# Used to override the get request timeout on a system level
+HF_HUB_DOWNLOAD_TIMEOUT: int = _as_int(os.environ.get("HF_HUB_DOWNLOAD_TIMEOUT")) or DEFAULT_DOWNLOAD_TIMEOUT
+
+# List frameworks that are handled by the InferenceAPI service. Useful to scan endpoints and check which models are
+# deployed and running. Since 95% of the models are using the top 4 frameworks listed below, we scan only those by
+# default. We still keep the full list of supported frameworks in case we want to scan all of them.
+MAIN_INFERENCE_API_FRAMEWORKS = [
+    "diffusers",
+    "sentence-transformers",
+    "text-generation-inference",
+    "transformers",
+]
+
+ALL_INFERENCE_API_FRAMEWORKS = MAIN_INFERENCE_API_FRAMEWORKS + [
+    "adapter-transformers",
+    "allennlp",
+    "asteroid",
+    "bertopic",
+    "doctr",
+    "espnet",
+    "fairseq",
+    "fastai",
+    "fasttext",
+    "flair",
+    "generic",
+    "k2",
+    "keras",
+    "mindspore",
+    "nemo",
+    "open_clip",
+    "paddlenlp",
+    "peft",
+    "pyannote-audio",
+    "sklearn",
+    "spacy",
+    "span-marker",
+    "speechbrain",
+    "stanza",
+    "timm",
+]
diff --git a/llm/Lib/site-packages/huggingface_hub/errors.py b/llm/Lib/site-packages/huggingface_hub/errors.py
new file mode 100644
index 0000000000000000000000000000000000000000..7975b39d1f9b1ef3b576c34434a62abf634299f9
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/errors.py
@@ -0,0 +1,38 @@
+"""Contains all custom errors."""
+
+from requests import HTTPError
+
+
+# INFERENCE CLIENT ERRORS
+
+
+class InferenceTimeoutError(HTTPError, TimeoutError):
+    """Error raised when a model is unavailable or the request times out."""
+
+
+# TEXT GENERATION ERRORS
+
+
+class TextGenerationError(HTTPError):
+    """Generic error raised if text-generation went wrong."""
+
+
+# Text Generation Inference Errors
+class ValidationError(TextGenerationError):
+    """Server-side validation error."""
+
+
+class GenerationError(TextGenerationError):
+    pass
+
+
+class OverloadedError(TextGenerationError):
+    pass
+
+
+class IncompleteGenerationError(TextGenerationError):
+    pass
+
+
+class UnknownError(TextGenerationError):
+    pass
diff --git a/llm/Lib/site-packages/huggingface_hub/fastai_utils.py b/llm/Lib/site-packages/huggingface_hub/fastai_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..e586e8663c39e8d5bab3f57f667dbd878514e59d
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/fastai_utils.py
@@ -0,0 +1,425 @@
+import json
+import os
+from pathlib import Path
+from pickle import DEFAULT_PROTOCOL, PicklingError
+from typing import Any, Dict, List, Optional, Union
+
+from packaging import version
+
+from huggingface_hub import snapshot_download
+from huggingface_hub.constants import CONFIG_NAME
+from huggingface_hub.hf_api import HfApi
+from huggingface_hub.utils import (
+    SoftTemporaryDirectory,
+    get_fastai_version,
+    get_fastcore_version,
+    get_python_version,
+)
+
+from .utils import logging, validate_hf_hub_args
+from .utils._runtime import _PY_VERSION  # noqa: F401 # for backward compatibility...
+
+
+logger = logging.get_logger(__name__)
+
+
+def _check_fastai_fastcore_versions(
+    fastai_min_version: str = "2.4",
+    fastcore_min_version: str = "1.3.27",
+):
+    """
+    Checks that the installed fastai and fastcore versions are compatible for pickle serialization.
+
+    Args:
+        fastai_min_version (`str`, *optional*):
+            The minimum fastai version supported.
+        fastcore_min_version (`str`, *optional*):
+            The minimum fastcore version supported.
+
+    <Tip>
+    Raises the following error:
+
+        - [`ImportError`](https://docs.python.org/3/library/exceptions.html#ImportError)
+          if the fastai or fastcore libraries are not available or are of an invalid version.
+
+    </Tip>
+    """
+
+    if (get_fastcore_version() or get_fastai_version()) == "N/A":
+        raise ImportError(
+            f"fastai>={fastai_min_version} and fastcore>={fastcore_min_version} are"
+            f" required. Currently using fastai=={get_fastai_version()} and"
+            f" fastcore=={get_fastcore_version()}."
+        )
+
+    current_fastai_version = version.Version(get_fastai_version())
+    current_fastcore_version = version.Version(get_fastcore_version())
+
+    if current_fastai_version < version.Version(fastai_min_version):
+        raise ImportError(
+            "`push_to_hub_fastai` and `from_pretrained_fastai` require a"
+            f" fastai>={fastai_min_version} version, but you are using fastai version"
+            f" {get_fastai_version()} which is incompatible. Upgrade with `pip install"
+            " fastai==2.5.6`."
+        )
+
+    if current_fastcore_version < version.Version(fastcore_min_version):
+        raise ImportError(
+            "`push_to_hub_fastai` and `from_pretrained_fastai` require a"
+            f" fastcore>={fastcore_min_version} version, but you are using fastcore"
+            f" version {get_fastcore_version()} which is incompatible. Upgrade with"
+            " `pip install fastcore==1.3.27`."
+        )
+
+
+def _check_fastai_fastcore_pyproject_versions(
+    storage_folder: str,
+    fastai_min_version: str = "2.4",
+    fastcore_min_version: str = "1.3.27",
+):
+    """
+    Checks that the `pyproject.toml` file in the directory `storage_folder` has fastai and fastcore versions
+    that are compatible with `from_pretrained_fastai` and `push_to_hub_fastai`. If `pyproject.toml` does not exist
+    or does not contain versions for fastai and fastcore, then it logs a warning.
+
+    Args:
+        storage_folder (`str`):
+            Folder to look for the `pyproject.toml` file.
+        fastai_min_version (`str`, *optional*):
+            The minimum fastai version supported.
+        fastcore_min_version (`str`, *optional*):
+            The minimum fastcore version supported.
+
+    <Tip>
+    Raises the following errors:
+
+        - [`ImportError`](https://docs.python.org/3/library/exceptions.html#ImportError)
+          if the `toml` module is not installed.
+        - [`ImportError`](https://docs.python.org/3/library/exceptions.html#ImportError)
+          if the `pyproject.toml` indicates a lower than minimum supported version of fastai or fastcore.
+
+    </Tip>
+    """
+
+    try:
+        import toml
+    except ModuleNotFoundError:
+        raise ImportError(
+            "`push_to_hub_fastai` and `from_pretrained_fastai` require the toml module."
+            " Install it with `pip install toml`."
+        )
+
+    # Checks that a `pyproject.toml`, with `build-system` and `requires` sections, exists in the repository. If so, get a list of required packages.
+    if not os.path.isfile(f"{storage_folder}/pyproject.toml"):
+        logger.warning(
+            "There is no `pyproject.toml` in the repository that contains the fastai"
+            " `Learner`. The `pyproject.toml` would allow us to verify that your fastai"
+            " and fastcore versions are compatible with those of the model you want to"
+            " load."
+        )
+        return
+    pyproject_toml = toml.load(f"{storage_folder}/pyproject.toml")
+
+    if "build-system" not in pyproject_toml.keys():
+        logger.warning(
+            "There is no `build-system` section in the pyproject.toml of the repository"
+            " that contains the fastai `Learner`. The `build-system` would allow us to"
+            " verify that your fastai and fastcore versions are compatible with those"
+            " of the model you want to load."
+        )
+        return
+    build_system_toml = pyproject_toml["build-system"]
+
+    if "requires" not in build_system_toml.keys():
+        logger.warning(
+            "There is no `requires` section in the pyproject.toml of the repository"
+            " that contains the fastai `Learner`. The `requires` would allow us to"
+            " verify that your fastai and fastcore versions are compatible with those"
+            " of the model you want to load."
+        )
+        return
+    package_versions = build_system_toml["requires"]
+
+    # Extracts contains fastai and fastcore versions from `pyproject.toml` if available.
+    # If the package is specified but not the version (e.g. "fastai" instead of "fastai=2.4"), the default versions are the highest.
+    fastai_packages = [pck for pck in package_versions if pck.startswith("fastai")]
+    if len(fastai_packages) == 0:
+        logger.warning("The repository does not have a fastai version specified in the `pyproject.toml`.")
+    # fastai_version is an empty string if not specified
+    else:
+        fastai_version = str(fastai_packages[0]).partition("=")[2]
+        if fastai_version != "" and version.Version(fastai_version) < version.Version(fastai_min_version):
+            raise ImportError(
+                "`from_pretrained_fastai` requires"
+                f" fastai>={fastai_min_version} version but the model to load uses"
+                f" {fastai_version} which is incompatible."
+            )
+
+    fastcore_packages = [pck for pck in package_versions if pck.startswith("fastcore")]
+    if len(fastcore_packages) == 0:
+        logger.warning("The repository does not have a fastcore version specified in the `pyproject.toml`.")
+    # fastcore_version is an empty string if not specified
+    else:
+        fastcore_version = str(fastcore_packages[0]).partition("=")[2]
+        if fastcore_version != "" and version.Version(fastcore_version) < version.Version(fastcore_min_version):
+            raise ImportError(
+                "`from_pretrained_fastai` requires"
+                f" fastcore>={fastcore_min_version} version, but you are using fastcore"
+                f" version {fastcore_version} which is incompatible."
+            )
+
+
+README_TEMPLATE = """---
+tags:
+- fastai
+---
+
+# Amazing!
+
+🥳 Congratulations on hosting your fastai model on the Hugging Face Hub!
+
+# Some next steps
+1. Fill out this model card with more information (see the template below and the [documentation here](https://huggingface.co/docs/hub/model-repos))!
+
+2. Create a demo in Gradio or Streamlit using 🤗 Spaces ([documentation here](https://huggingface.co/docs/hub/spaces)).
+
+3. Join the fastai community on the [Fastai Discord](https://discord.com/invite/YKrxeNn)!
+
+Greetings fellow fastlearner 🤝! Don't forget to delete this content from your model card.
+
+
+---
+
+
+# Model card
+
+## Model description
+More information needed
+
+## Intended uses & limitations
+More information needed
+
+## Training and evaluation data
+More information needed
+"""
+
+PYPROJECT_TEMPLATE = f"""[build-system]
+requires = ["setuptools>=40.8.0", "wheel", "python={get_python_version()}", "fastai={get_fastai_version()}", "fastcore={get_fastcore_version()}"]
+build-backend = "setuptools.build_meta:__legacy__"
+"""
+
+
+def _create_model_card(repo_dir: Path):
+    """
+    Creates a model card for the repository.
+
+    Args:
+        repo_dir (`Path`):
+            Directory where model card is created.
+    """
+    readme_path = repo_dir / "README.md"
+
+    if not readme_path.exists():
+        with readme_path.open("w", encoding="utf-8") as f:
+            f.write(README_TEMPLATE)
+
+
+def _create_model_pyproject(repo_dir: Path):
+    """
+    Creates a `pyproject.toml` for the repository.
+
+    Args:
+        repo_dir (`Path`):
+            Directory where `pyproject.toml` is created.
+    """
+    pyproject_path = repo_dir / "pyproject.toml"
+
+    if not pyproject_path.exists():
+        with pyproject_path.open("w", encoding="utf-8") as f:
+            f.write(PYPROJECT_TEMPLATE)
+
+
+def _save_pretrained_fastai(
+    learner,
+    save_directory: Union[str, Path],
+    config: Optional[Dict[str, Any]] = None,
+):
+    """
+    Saves a fastai learner to `save_directory` in pickle format using the default pickle protocol for the version of python used.
+
+    Args:
+        learner (`Learner`):
+            The `fastai.Learner` you'd like to save.
+        save_directory (`str` or `Path`):
+            Specific directory in which you want to save the fastai learner.
+        config (`dict`, *optional*):
+            Configuration object. Will be uploaded as a .json file. Example: 'https://huggingface.co/espejelomar/fastai-pet-breeds-classification/blob/main/config.json'.
+
+    <Tip>
+
+    Raises the following error:
+
+        - [`RuntimeError`](https://docs.python.org/3/library/exceptions.html#RuntimeError)
+          if the config file provided is not a dictionary.
+
+    </Tip>
+    """
+    _check_fastai_fastcore_versions()
+
+    os.makedirs(save_directory, exist_ok=True)
+
+    # if the user provides config then we update it with the fastai and fastcore versions in CONFIG_TEMPLATE.
+    if config is not None:
+        if not isinstance(config, dict):
+            raise RuntimeError(f"Provided config should be a dict. Got: '{type(config)}'")
+        path = os.path.join(save_directory, CONFIG_NAME)
+        with open(path, "w") as f:
+            json.dump(config, f)
+
+    _create_model_card(Path(save_directory))
+    _create_model_pyproject(Path(save_directory))
+
+    # learner.export saves the model in `self.path`.
+    learner.path = Path(save_directory)
+    os.makedirs(save_directory, exist_ok=True)
+    try:
+        learner.export(
+            fname="model.pkl",
+            pickle_protocol=DEFAULT_PROTOCOL,
+        )
+    except PicklingError:
+        raise PicklingError(
+            "You are using a lambda function, i.e., an anonymous function. `pickle`"
+            " cannot pickle function objects and requires that all functions have"
+            " names. One possible solution is to name the function."
+        )
+
+
+@validate_hf_hub_args
+def from_pretrained_fastai(
+    repo_id: str,
+    revision: Optional[str] = None,
+):
+    """
+    Load pretrained fastai model from the Hub or from a local directory.
+
+    Args:
+        repo_id (`str`):
+            The location where the pickled fastai.Learner is. It can be either of the two:
+                - Hosted on the Hugging Face Hub. E.g.: 'espejelomar/fatai-pet-breeds-classification' or 'distilgpt2'.
+                  You can add a `revision` by appending `@` at the end of `repo_id`. E.g.: `dbmdz/bert-base-german-cased@main`.
+                  Revision is the specific model version to use. Since we use a git-based system for storing models and other
+                  artifacts on the Hugging Face Hub, it can be a branch name, a tag name, or a commit id.
+                - Hosted locally. `repo_id` would be a directory containing the pickle and a pyproject.toml
+                  indicating the fastai and fastcore versions used to build the `fastai.Learner`. E.g.: `./my_model_directory/`.
+        revision (`str`, *optional*):
+            Revision at which the repo's files are downloaded. See documentation of `snapshot_download`.
+
+    Returns:
+        The `fastai.Learner` model in the `repo_id` repo.
+    """
+    _check_fastai_fastcore_versions()
+
+    # Load the `repo_id` repo.
+    # `snapshot_download` returns the folder where the model was stored.
+    # `cache_dir` will be the default '/root/.cache/huggingface/hub'
+    if not os.path.isdir(repo_id):
+        storage_folder = snapshot_download(
+            repo_id=repo_id,
+            revision=revision,
+            library_name="fastai",
+            library_version=get_fastai_version(),
+        )
+    else:
+        storage_folder = repo_id
+
+    _check_fastai_fastcore_pyproject_versions(storage_folder)
+
+    from fastai.learner import load_learner  # type: ignore
+
+    return load_learner(os.path.join(storage_folder, "model.pkl"))
+
+
+@validate_hf_hub_args
+def push_to_hub_fastai(
+    learner,
+    *,
+    repo_id: str,
+    commit_message: str = "Push FastAI model using huggingface_hub.",
+    private: bool = False,
+    token: Optional[str] = None,
+    config: Optional[dict] = None,
+    branch: Optional[str] = None,
+    create_pr: Optional[bool] = None,
+    allow_patterns: Optional[Union[List[str], str]] = None,
+    ignore_patterns: Optional[Union[List[str], str]] = None,
+    delete_patterns: Optional[Union[List[str], str]] = None,
+    api_endpoint: Optional[str] = None,
+):
+    """
+    Upload learner checkpoint files to the Hub.
+
+    Use `allow_patterns` and `ignore_patterns` to precisely filter which files should be pushed to the hub. Use
+    `delete_patterns` to delete existing remote files in the same commit. See [`upload_folder`] reference for more
+    details.
+
+    Args:
+        learner (`Learner`):
+            The `fastai.Learner' you'd like to push to the Hub.
+        repo_id (`str`):
+            The repository id for your model in Hub in the format of "namespace/repo_name". The namespace can be your individual account or an organization to which you have write access (for example, 'stanfordnlp/stanza-de').
+        commit_message (`str`, *optional*):
+            Message to commit while pushing. Will default to :obj:`"add model"`.
+        private (`bool`, *optional*, defaults to `False`):
+            Whether or not the repository created should be private.
+        token (`str`, *optional*):
+            The Hugging Face account token to use as HTTP bearer authorization for remote files. If :obj:`None`, the token will be asked by a prompt.
+        config (`dict`, *optional*):
+            Configuration object to be saved alongside the model weights.
+        branch (`str`, *optional*):
+            The git branch on which to push the model. This defaults to
+            the default branch as specified in your repository, which
+            defaults to `"main"`.
+        create_pr (`boolean`, *optional*):
+            Whether or not to create a Pull Request from `branch` with that commit.
+            Defaults to `False`.
+        api_endpoint (`str`, *optional*):
+            The API endpoint to use when pushing the model to the hub.
+        allow_patterns (`List[str]` or `str`, *optional*):
+            If provided, only files matching at least one pattern are pushed.
+        ignore_patterns (`List[str]` or `str`, *optional*):
+            If provided, files matching any of the patterns are not pushed.
+        delete_patterns (`List[str]` or `str`, *optional*):
+            If provided, remote files matching any of the patterns will be deleted from the repo.
+
+    Returns:
+        The url of the commit of your model in the given repository.
+
+    <Tip>
+
+    Raises the following error:
+
+        - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+          if the user is not log on to the Hugging Face Hub.
+
+    </Tip>
+    """
+    _check_fastai_fastcore_versions()
+    api = HfApi(endpoint=api_endpoint)
+    repo_id = api.create_repo(repo_id=repo_id, token=token, private=private, exist_ok=True).repo_id
+
+    # Push the files to the repo in a single commit
+    with SoftTemporaryDirectory() as tmp:
+        saved_path = Path(tmp) / repo_id
+        _save_pretrained_fastai(learner, saved_path, config=config)
+        return api.upload_folder(
+            repo_id=repo_id,
+            token=token,
+            folder_path=saved_path,
+            commit_message=commit_message,
+            revision=branch,
+            create_pr=create_pr,
+            allow_patterns=allow_patterns,
+            ignore_patterns=ignore_patterns,
+            delete_patterns=delete_patterns,
+        )
diff --git a/llm/Lib/site-packages/huggingface_hub/file_download.py b/llm/Lib/site-packages/huggingface_hub/file_download.py
new file mode 100644
index 0000000000000000000000000000000000000000..566ef3246a8877c103b4f6f16c4e5d418bd62bbc
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/file_download.py
@@ -0,0 +1,1770 @@
+import copy
+import errno
+import fnmatch
+import inspect
+import io
+import json
+import os
+import re
+import shutil
+import stat
+import tempfile
+import time
+import uuid
+import warnings
+from contextlib import contextmanager
+from dataclasses import dataclass
+from functools import partial
+from pathlib import Path
+from typing import Any, BinaryIO, Dict, Generator, Literal, Optional, Tuple, Union
+from urllib.parse import quote, urlparse
+
+import requests
+
+from huggingface_hub import constants
+
+from . import __version__  # noqa: F401 # for backward compatibility
+from .constants import (
+    DEFAULT_ETAG_TIMEOUT,
+    DEFAULT_REQUEST_TIMEOUT,
+    DEFAULT_REVISION,
+    DOWNLOAD_CHUNK_SIZE,
+    ENDPOINT,
+    HF_HUB_CACHE,
+    HF_HUB_DISABLE_SYMLINKS_WARNING,
+    HF_HUB_DOWNLOAD_TIMEOUT,
+    HF_HUB_ENABLE_HF_TRANSFER,
+    HF_HUB_ETAG_TIMEOUT,
+    HF_TRANSFER_CONCURRENCY,
+    HUGGINGFACE_CO_URL_TEMPLATE,
+    HUGGINGFACE_HEADER_X_LINKED_ETAG,
+    HUGGINGFACE_HEADER_X_LINKED_SIZE,
+    HUGGINGFACE_HEADER_X_REPO_COMMIT,
+    HUGGINGFACE_HUB_CACHE,  # noqa: F401 # for backward compatibility
+    REPO_ID_SEPARATOR,
+    REPO_TYPES,
+    REPO_TYPES_URL_PREFIXES,
+)
+from .utils import (
+    EntryNotFoundError,
+    FileMetadataError,
+    GatedRepoError,
+    LocalEntryNotFoundError,
+    OfflineModeIsEnabled,
+    RepositoryNotFoundError,
+    RevisionNotFoundError,
+    SoftTemporaryDirectory,
+    WeakFileLock,
+    build_hf_headers,
+    get_fastai_version,  # noqa: F401 # for backward compatibility
+    get_fastcore_version,  # noqa: F401 # for backward compatibility
+    get_graphviz_version,  # noqa: F401 # for backward compatibility
+    get_jinja_version,  # noqa: F401 # for backward compatibility
+    get_pydot_version,  # noqa: F401 # for backward compatibility
+    get_session,
+    get_tf_version,  # noqa: F401 # for backward compatibility
+    get_torch_version,  # noqa: F401 # for backward compatibility
+    hf_raise_for_status,
+    is_fastai_available,  # noqa: F401 # for backward compatibility
+    is_fastcore_available,  # noqa: F401 # for backward compatibility
+    is_graphviz_available,  # noqa: F401 # for backward compatibility
+    is_jinja_available,  # noqa: F401 # for backward compatibility
+    is_pydot_available,  # noqa: F401 # for backward compatibility
+    is_tf_available,  # noqa: F401 # for backward compatibility
+    is_torch_available,  # noqa: F401 # for backward compatibility
+    logging,
+    reset_sessions,
+    tqdm,
+    validate_hf_hub_args,
+)
+from .utils._runtime import _PY_VERSION  # noqa: F401 # for backward compatibility
+from .utils._typing import HTTP_METHOD_T
+from .utils.insecure_hashlib import sha256
+
+
+logger = logging.get_logger(__name__)
+
+# Regex to get filename from a "Content-Disposition" header for CDN-served files
+HEADER_FILENAME_PATTERN = re.compile(r'filename="(?P<filename>.*?)";')
+
+
+_are_symlinks_supported_in_dir: Dict[str, bool] = {}
+
+
+def are_symlinks_supported(cache_dir: Union[str, Path, None] = None) -> bool:
+    """Return whether the symlinks are supported on the machine.
+
+    Since symlinks support can change depending on the mounted disk, we need to check
+    on the precise cache folder. By default, the default HF cache directory is checked.
+
+    Args:
+        cache_dir (`str`, `Path`, *optional*):
+            Path to the folder where cached files are stored.
+
+    Returns: [bool] Whether symlinks are supported in the directory.
+    """
+    # Defaults to HF cache
+    if cache_dir is None:
+        cache_dir = HF_HUB_CACHE
+    cache_dir = str(Path(cache_dir).expanduser().resolve())  # make it unique
+
+    # Check symlink compatibility only once (per cache directory) at first time use
+    if cache_dir not in _are_symlinks_supported_in_dir:
+        _are_symlinks_supported_in_dir[cache_dir] = True
+
+        os.makedirs(cache_dir, exist_ok=True)
+        with SoftTemporaryDirectory(dir=cache_dir) as tmpdir:
+            src_path = Path(tmpdir) / "dummy_file_src"
+            src_path.touch()
+            dst_path = Path(tmpdir) / "dummy_file_dst"
+
+            # Relative source path as in `_create_symlink``
+            relative_src = os.path.relpath(src_path, start=os.path.dirname(dst_path))
+            try:
+                os.symlink(relative_src, dst_path)
+            except OSError:
+                # Likely running on Windows
+                _are_symlinks_supported_in_dir[cache_dir] = False
+
+                if not HF_HUB_DISABLE_SYMLINKS_WARNING:
+                    message = (
+                        "`huggingface_hub` cache-system uses symlinks by default to"
+                        " efficiently store duplicated files but your machine does not"
+                        f" support them in {cache_dir}. Caching files will still work"
+                        " but in a degraded version that might require more space on"
+                        " your disk. This warning can be disabled by setting the"
+                        " `HF_HUB_DISABLE_SYMLINKS_WARNING` environment variable. For"
+                        " more details, see"
+                        " https://huggingface.co/docs/huggingface_hub/how-to-cache#limitations."
+                    )
+                    if os.name == "nt":
+                        message += (
+                            "\nTo support symlinks on Windows, you either need to"
+                            " activate Developer Mode or to run Python as an"
+                            " administrator. In order to see activate developer mode,"
+                            " see this article:"
+                            " https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development"
+                        )
+                    warnings.warn(message)
+
+    return _are_symlinks_supported_in_dir[cache_dir]
+
+
+# Return value when trying to load a file from cache but the file does not exist in the distant repo.
+_CACHED_NO_EXIST = object()
+_CACHED_NO_EXIST_T = Any
+REGEX_COMMIT_HASH = re.compile(r"^[0-9a-f]{40}$")
+
+
+@dataclass(frozen=True)
+class HfFileMetadata:
+    """Data structure containing information about a file versioned on the Hub.
+
+    Returned by [`get_hf_file_metadata`] based on a URL.
+
+    Args:
+        commit_hash (`str`, *optional*):
+            The commit_hash related to the file.
+        etag (`str`, *optional*):
+            Etag of the file on the server.
+        location (`str`):
+            Location where to download the file. Can be a Hub url or not (CDN).
+        size (`size`):
+            Size of the file. In case of an LFS file, contains the size of the actual
+            LFS file, not the pointer.
+    """
+
+    commit_hash: Optional[str]
+    etag: Optional[str]
+    location: str
+    size: Optional[int]
+
+
+@validate_hf_hub_args
+def hf_hub_url(
+    repo_id: str,
+    filename: str,
+    *,
+    subfolder: Optional[str] = None,
+    repo_type: Optional[str] = None,
+    revision: Optional[str] = None,
+    endpoint: Optional[str] = None,
+) -> str:
+    """Construct the URL of a file from the given information.
+
+    The resolved address can either be a huggingface.co-hosted url, or a link to
+    Cloudfront (a Content Delivery Network, or CDN) for large files which are
+    more than a few MBs.
+
+    Args:
+        repo_id (`str`):
+            A namespace (user or an organization) name and a repo name separated
+            by a `/`.
+        filename (`str`):
+            The name of the file in the repo.
+        subfolder (`str`, *optional*):
+            An optional value corresponding to a folder inside the repo.
+        repo_type (`str`, *optional*):
+            Set to `"dataset"` or `"space"` if downloading from a dataset or space,
+            `None` or `"model"` if downloading from a model. Default is `None`.
+        revision (`str`, *optional*):
+            An optional Git revision id which can be a branch name, a tag, or a
+            commit hash.
+
+    Example:
+
+    ```python
+    >>> from huggingface_hub import hf_hub_url
+
+    >>> hf_hub_url(
+    ...     repo_id="julien-c/EsperBERTo-small", filename="pytorch_model.bin"
+    ... )
+    'https://huggingface.co/julien-c/EsperBERTo-small/resolve/main/pytorch_model.bin'
+    ```
+
+    <Tip>
+
+    Notes:
+
+        Cloudfront is replicated over the globe so downloads are way faster for
+        the end user (and it also lowers our bandwidth costs).
+
+        Cloudfront aggressively caches files by default (default TTL is 24
+        hours), however this is not an issue here because we implement a
+        git-based versioning system on huggingface.co, which means that we store
+        the files on S3/Cloudfront in a content-addressable way (i.e., the file
+        name is its hash). Using content-addressable filenames means cache can't
+        ever be stale.
+
+        In terms of client-side caching from this library, we base our caching
+        on the objects' entity tag (`ETag`), which is an identifier of a
+        specific version of a resource [1]_. An object's ETag is: its git-sha1
+        if stored in git, or its sha256 if stored in git-lfs.
+
+    </Tip>
+
+    References:
+
+    -  [1] https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag
+    """
+    if subfolder == "":
+        subfolder = None
+    if subfolder is not None:
+        filename = f"{subfolder}/{filename}"
+
+    if repo_type not in REPO_TYPES:
+        raise ValueError("Invalid repo type")
+
+    if repo_type in REPO_TYPES_URL_PREFIXES:
+        repo_id = REPO_TYPES_URL_PREFIXES[repo_type] + repo_id
+
+    if revision is None:
+        revision = DEFAULT_REVISION
+    url = HUGGINGFACE_CO_URL_TEMPLATE.format(
+        repo_id=repo_id, revision=quote(revision, safe=""), filename=quote(filename)
+    )
+    # Update endpoint if provided
+    if endpoint is not None and url.startswith(ENDPOINT):
+        url = endpoint + url[len(ENDPOINT) :]
+    return url
+
+
+def url_to_filename(url: str, etag: Optional[str] = None) -> str:
+    """Generate a local filename from a url.
+
+    Convert `url` into a hashed filename in a reproducible way. If `etag` is
+    specified, append its hash to the url's, delimited by a period. If the url
+    ends with .h5 (Keras HDF5 weights) adds '.h5' to the name so that TF 2.0 can
+    identify it as a HDF5 file (see
+    https://github.com/tensorflow/tensorflow/blob/00fad90125b18b80fe054de1055770cfb8fe4ba3/tensorflow/python/keras/engine/network.py#L1380)
+
+    Args:
+        url (`str`):
+            The address to the file.
+        etag (`str`, *optional*):
+            The ETag of the file.
+
+    Returns:
+        The generated filename.
+    """
+    url_bytes = url.encode("utf-8")
+    filename = sha256(url_bytes).hexdigest()
+
+    if etag:
+        etag_bytes = etag.encode("utf-8")
+        filename += "." + sha256(etag_bytes).hexdigest()
+
+    if url.endswith(".h5"):
+        filename += ".h5"
+
+    return filename
+
+
+def filename_to_url(
+    filename,
+    cache_dir: Optional[str] = None,
+    legacy_cache_layout: bool = False,
+) -> Tuple[str, str]:
+    """
+    Return the url and etag (which may be `None`) stored for `filename`. Raise
+    `EnvironmentError` if `filename` or its stored metadata do not exist.
+
+    Args:
+        filename (`str`):
+            The name of the file
+        cache_dir (`str`, *optional*):
+            The cache directory to use instead of the default one.
+        legacy_cache_layout (`bool`, *optional*, defaults to `False`):
+            If `True`, uses the legacy file cache layout i.e. just call `hf_hub_url`
+            then `cached_download`. This is deprecated as the new cache layout is
+            more powerful.
+    """
+    if not legacy_cache_layout:
+        warnings.warn(
+            "`filename_to_url` uses the legacy way cache file layout",
+            FutureWarning,
+        )
+
+    if cache_dir is None:
+        cache_dir = HF_HUB_CACHE
+    if isinstance(cache_dir, Path):
+        cache_dir = str(cache_dir)
+
+    cache_path = os.path.join(cache_dir, filename)
+    if not os.path.exists(cache_path):
+        raise EnvironmentError(f"file {cache_path} not found")
+
+    meta_path = cache_path + ".json"
+    if not os.path.exists(meta_path):
+        raise EnvironmentError(f"file {meta_path} not found")
+
+    with open(meta_path, encoding="utf-8") as meta_file:
+        metadata = json.load(meta_file)
+    url = metadata["url"]
+    etag = metadata["etag"]
+
+    return url, etag
+
+
+def _request_wrapper(
+    method: HTTP_METHOD_T, url: str, *, follow_relative_redirects: bool = False, **params
+) -> requests.Response:
+    """Wrapper around requests methods to follow relative redirects if `follow_relative_redirects=True` even when
+    `allow_redirection=False`.
+
+    Args:
+        method (`str`):
+            HTTP method, such as 'GET' or 'HEAD'.
+        url (`str`):
+            The URL of the resource to fetch.
+        follow_relative_redirects (`bool`, *optional*, defaults to `False`)
+            If True, relative redirection (redirection to the same site) will be resolved even when `allow_redirection`
+            kwarg is set to False. Useful when we want to follow a redirection to a renamed repository without
+            following redirection to a CDN.
+        **params (`dict`, *optional*):
+            Params to pass to `requests.request`.
+    """
+    # Recursively follow relative redirects
+    if follow_relative_redirects:
+        response = _request_wrapper(
+            method=method,
+            url=url,
+            follow_relative_redirects=False,
+            **params,
+        )
+
+        # If redirection, we redirect only relative paths.
+        # This is useful in case of a renamed repository.
+        if 300 <= response.status_code <= 399:
+            parsed_target = urlparse(response.headers["Location"])
+            if parsed_target.netloc == "":
+                # This means it is a relative 'location' headers, as allowed by RFC 7231.
+                # (e.g. '/path/to/resource' instead of 'http://domain.tld/path/to/resource')
+                # We want to follow this relative redirect !
+                #
+                # Highly inspired by `resolve_redirects` from requests library.
+                # See https://github.com/psf/requests/blob/main/requests/sessions.py#L159
+                next_url = urlparse(url)._replace(path=parsed_target.path).geturl()
+                return _request_wrapper(method=method, url=next_url, follow_relative_redirects=True, **params)
+        return response
+
+    # Perform request and return if status_code is not in the retry list.
+    response = get_session().request(method=method, url=url, **params)
+    hf_raise_for_status(response)
+    return response
+
+
+def http_get(
+    url: str,
+    temp_file: BinaryIO,
+    *,
+    proxies: Optional[Dict] = None,
+    resume_size: float = 0,
+    headers: Optional[Dict[str, str]] = None,
+    expected_size: Optional[int] = None,
+    displayed_filename: Optional[str] = None,
+    _nb_retries: int = 5,
+    _tqdm_bar: Optional[tqdm] = None,
+) -> None:
+    """
+    Download a remote file. Do not gobble up errors, and will return errors tailored to the Hugging Face Hub.
+
+    If ConnectionError (SSLError) or ReadTimeout happen while streaming data from the server, it is most likely a
+    transient error (network outage?). We log a warning message and try to resume the download a few times before
+    giving up. The method gives up after 5 attempts if no new data has being received from the server.
+
+    Args:
+        url (`str`):
+            The URL of the file to download.
+        temp_file (`BinaryIO`):
+            The file-like object where to save the file.
+        proxies (`dict`, *optional*):
+            Dictionary mapping protocol to the URL of the proxy passed to `requests.request`.
+        resume_size (`float`, *optional*):
+            The number of bytes already downloaded. If set to 0 (default), the whole file is download. If set to a
+            positive number, the download will resume at the given position.
+        headers (`dict`, *optional*):
+            Dictionary of HTTP Headers to send with the request.
+        expected_size (`int`, *optional*):
+            The expected size of the file to download. If set, the download will raise an error if the size of the
+            received content is different from the expected one.
+        displayed_filename (`str`, *optional*):
+            The filename of the file that is being downloaded. Value is used only to display a nice progress bar. If
+            not set, the filename is guessed from the URL or the `Content-Disposition` header.
+    """
+    hf_transfer = None
+    if HF_HUB_ENABLE_HF_TRANSFER:
+        if resume_size != 0:
+            warnings.warn("'hf_transfer' does not support `resume_size`: falling back to regular download method")
+        elif proxies is not None:
+            warnings.warn("'hf_transfer' does not support `proxies`: falling back to regular download method")
+        else:
+            try:
+                import hf_transfer  # type: ignore[no-redef]
+            except ImportError:
+                raise ValueError(
+                    "Fast download using 'hf_transfer' is enabled"
+                    " (HF_HUB_ENABLE_HF_TRANSFER=1) but 'hf_transfer' package is not"
+                    " available in your environment. Try `pip install hf_transfer`."
+                )
+
+    initial_headers = headers
+    headers = copy.deepcopy(headers) or {}
+    if resume_size > 0:
+        headers["Range"] = "bytes=%d-" % (resume_size,)
+
+    r = _request_wrapper(
+        method="GET", url=url, stream=True, proxies=proxies, headers=headers, timeout=HF_HUB_DOWNLOAD_TIMEOUT
+    )
+    hf_raise_for_status(r)
+    content_length = r.headers.get("Content-Length")
+
+    # NOTE: 'total' is the total number of bytes to download, not the number of bytes in the file.
+    #       If the file is compressed, the number of bytes in the saved file will be higher than 'total'.
+    total = resume_size + int(content_length) if content_length is not None else None
+
+    if displayed_filename is None:
+        displayed_filename = url
+        content_disposition = r.headers.get("Content-Disposition")
+        if content_disposition is not None:
+            match = HEADER_FILENAME_PATTERN.search(content_disposition)
+            if match is not None:
+                # Means file is on CDN
+                displayed_filename = match.groupdict()["filename"]
+
+    # Truncate filename if too long to display
+    if len(displayed_filename) > 40:
+        displayed_filename = f"(…){displayed_filename[-40:]}"
+
+    consistency_error_message = (
+        f"Consistency check failed: file should be of size {expected_size} but has size"
+        f" {{actual_size}} ({displayed_filename}).\nWe are sorry for the inconvenience. Please retry download and"
+        " pass `force_download=True, resume_download=False` as argument.\nIf the issue persists, please let us"
+        " know by opening an issue on https://github.com/huggingface/huggingface_hub."
+    )
+
+    # Stream file to buffer
+    progress = _tqdm_bar
+    if progress is None:
+        progress = tqdm(
+            unit="B",
+            unit_scale=True,
+            total=total,
+            initial=resume_size,
+            desc=displayed_filename,
+            disable=True if (logger.getEffectiveLevel() == logging.NOTSET) else None,
+            # ^ set `disable=None` rather than `disable=False` by default to disable progress bar when no TTY attached
+            # see https://github.com/huggingface/huggingface_hub/pull/2000
+        )
+
+    if hf_transfer and total is not None and total > 5 * DOWNLOAD_CHUNK_SIZE:
+        supports_callback = "callback" in inspect.signature(hf_transfer.download).parameters
+        if not supports_callback:
+            warnings.warn(
+                "You are using an outdated version of `hf_transfer`. "
+                "Consider upgrading to latest version to enable progress bars "
+                "using `pip install -U hf_transfer`."
+            )
+        try:
+            hf_transfer.download(
+                url=url,
+                filename=temp_file.name,
+                max_files=HF_TRANSFER_CONCURRENCY,
+                chunk_size=DOWNLOAD_CHUNK_SIZE,
+                headers=headers,
+                parallel_failures=3,
+                max_retries=5,
+                **({"callback": progress.update} if supports_callback else {}),
+            )
+        except Exception as e:
+            raise RuntimeError(
+                "An error occurred while downloading using `hf_transfer`. Consider"
+                " disabling HF_HUB_ENABLE_HF_TRANSFER for better error handling."
+            ) from e
+        if not supports_callback:
+            progress.update(total)
+        if expected_size is not None and expected_size != os.path.getsize(temp_file.name):
+            raise EnvironmentError(
+                consistency_error_message.format(
+                    actual_size=os.path.getsize(temp_file.name),
+                )
+            )
+        return
+    new_resume_size = resume_size
+    try:
+        for chunk in r.iter_content(chunk_size=DOWNLOAD_CHUNK_SIZE):
+            if chunk:  # filter out keep-alive new chunks
+                progress.update(len(chunk))
+                temp_file.write(chunk)
+                new_resume_size += len(chunk)
+                # Some data has been downloaded from the server so we reset the number of retries.
+                _nb_retries = 5
+    except (requests.ConnectionError, requests.ReadTimeout) as e:
+        # If ConnectionError (SSLError) or ReadTimeout happen while streaming data from the server, it is most likely
+        # a transient error (network outage?). We log a warning message and try to resume the download a few times
+        # before giving up. Tre retry mechanism is basic but should be enough in most cases.
+        if _nb_retries <= 0:
+            logger.warning("Error while downloading from %s: %s\nMax retries exceeded.", url, str(e))
+            raise
+        logger.warning("Error while downloading from %s: %s\nTrying to resume download...", url, str(e))
+        time.sleep(1)
+        reset_sessions()  # In case of SSLError it's best to reset the shared requests.Session objects
+        return http_get(
+            url=url,
+            temp_file=temp_file,
+            proxies=proxies,
+            resume_size=new_resume_size,
+            headers=initial_headers,
+            expected_size=expected_size,
+            _nb_retries=_nb_retries - 1,
+            _tqdm_bar=_tqdm_bar,
+        )
+
+    progress.close()
+
+    if expected_size is not None and expected_size != temp_file.tell():
+        raise EnvironmentError(
+            consistency_error_message.format(
+                actual_size=temp_file.tell(),
+            )
+        )
+
+
+@validate_hf_hub_args
+def cached_download(
+    url: str,
+    *,
+    library_name: Optional[str] = None,
+    library_version: Optional[str] = None,
+    cache_dir: Union[str, Path, None] = None,
+    user_agent: Union[Dict, str, None] = None,
+    force_download: bool = False,
+    force_filename: Optional[str] = None,
+    proxies: Optional[Dict] = None,
+    etag_timeout: float = DEFAULT_ETAG_TIMEOUT,
+    resume_download: bool = False,
+    token: Union[bool, str, None] = None,
+    local_files_only: bool = False,
+    legacy_cache_layout: bool = False,
+) -> str:
+    """
+    Download from a given URL and cache it if it's not already present in the
+    local cache.
+
+    Given a URL, this function looks for the corresponding file in the local
+    cache. If it's not there, download it. Then return the path to the cached
+    file.
+
+    Will raise errors tailored to the Hugging Face Hub.
+
+    Args:
+        url (`str`):
+            The path to the file to be downloaded.
+        library_name (`str`, *optional*):
+            The name of the library to which the object corresponds.
+        library_version (`str`, *optional*):
+            The version of the library.
+        cache_dir (`str`, `Path`, *optional*):
+            Path to the folder where cached files are stored.
+        user_agent (`dict`, `str`, *optional*):
+            The user-agent info in the form of a dictionary or a string.
+        force_download (`bool`, *optional*, defaults to `False`):
+            Whether the file should be downloaded even if it already exists in
+            the local cache.
+        force_filename (`str`, *optional*):
+            Use this name instead of a generated file name.
+        proxies (`dict`, *optional*):
+            Dictionary mapping protocol to the URL of the proxy passed to
+            `requests.request`.
+        etag_timeout (`float`, *optional* defaults to `10`):
+            When fetching ETag, how many seconds to wait for the server to send
+            data before giving up which is passed to `requests.request`.
+        resume_download (`bool`, *optional*, defaults to `False`):
+            If `True`, resume a previously interrupted download.
+        token (`bool`, `str`, *optional*):
+            A token to be used for the download.
+                - If `True`, the token is read from the HuggingFace config
+                  folder.
+                - If a string, it's used as the authentication token.
+        local_files_only (`bool`, *optional*, defaults to `False`):
+            If `True`, avoid downloading the file and return the path to the
+            local cached file if it exists.
+        legacy_cache_layout (`bool`, *optional*, defaults to `False`):
+            Set this parameter to `True` to mention that you'd like to continue
+            the old cache layout. Putting this to `True` manually will not raise
+            any warning when using `cached_download`. We recommend using
+            `hf_hub_download` to take advantage of the new cache.
+
+    Returns:
+        Local path (string) of file or if networking is off, last version of
+        file cached on disk.
+
+    <Tip>
+
+    Raises the following errors:
+
+        - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError)
+          if `token=True` and the token cannot be found.
+        - [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError)
+          if ETag cannot be determined.
+        - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+          if some parameter value is invalid
+        - [`~utils.RepositoryNotFoundError`]
+          If the repository to download from cannot be found. This may be because it doesn't exist,
+          or because it is set to `private` and you do not have access.
+        - [`~utils.RevisionNotFoundError`]
+          If the revision to download from cannot be found.
+        - [`~utils.EntryNotFoundError`]
+          If the file to download cannot be found.
+        - [`~utils.LocalEntryNotFoundError`]
+          If network is disabled or unavailable and file is not found in cache.
+
+    </Tip>
+    """
+    if HF_HUB_ETAG_TIMEOUT != DEFAULT_ETAG_TIMEOUT:
+        # Respect environment variable above user value
+        etag_timeout = HF_HUB_ETAG_TIMEOUT
+
+    if not legacy_cache_layout:
+        warnings.warn(
+            "'cached_download' is the legacy way to download files from the HF hub, please consider upgrading to"
+            " 'hf_hub_download'",
+            FutureWarning,
+        )
+
+    if cache_dir is None:
+        cache_dir = HF_HUB_CACHE
+    if isinstance(cache_dir, Path):
+        cache_dir = str(cache_dir)
+
+    os.makedirs(cache_dir, exist_ok=True)
+
+    headers = build_hf_headers(
+        token=token,
+        library_name=library_name,
+        library_version=library_version,
+        user_agent=user_agent,
+    )
+
+    url_to_download = url
+    etag = None
+    expected_size = None
+    if not local_files_only:
+        try:
+            # Temporary header: we want the full (decompressed) content size returned to be able to check the
+            # downloaded file size
+            headers["Accept-Encoding"] = "identity"
+            r = _request_wrapper(
+                method="HEAD",
+                url=url,
+                headers=headers,
+                allow_redirects=False,
+                follow_relative_redirects=True,
+                proxies=proxies,
+                timeout=etag_timeout,
+            )
+            headers.pop("Accept-Encoding", None)
+            hf_raise_for_status(r)
+            etag = r.headers.get(HUGGINGFACE_HEADER_X_LINKED_ETAG) or r.headers.get("ETag")
+            # We favor a custom header indicating the etag of the linked resource, and
+            # we fallback to the regular etag header.
+            # If we don't have any of those, raise an error.
+            if etag is None:
+                raise FileMetadataError(
+                    "Distant resource does not have an ETag, we won't be able to reliably ensure reproducibility."
+                )
+            # We get the expected size of the file, to check the download went well.
+            expected_size = _int_or_none(r.headers.get("Content-Length"))
+            # In case of a redirect, save an extra redirect on the request.get call,
+            # and ensure we download the exact atomic version even if it changed
+            # between the HEAD and the GET (unlikely, but hey).
+            # Useful for lfs blobs that are stored on a CDN.
+            if 300 <= r.status_code <= 399:
+                url_to_download = r.headers["Location"]
+                headers.pop("authorization", None)
+                expected_size = None  # redirected -> can't know the expected size
+        except (requests.exceptions.SSLError, requests.exceptions.ProxyError):
+            # Actually raise for those subclasses of ConnectionError
+            raise
+        except (
+            requests.exceptions.ConnectionError,
+            requests.exceptions.Timeout,
+            OfflineModeIsEnabled,
+        ):
+            # Otherwise, our Internet connection is down.
+            # etag is None
+            pass
+
+    filename = force_filename if force_filename is not None else url_to_filename(url, etag)
+
+    # get cache path to put the file
+    cache_path = os.path.join(cache_dir, filename)
+
+    # etag is None == we don't have a connection or we passed local_files_only.
+    # try to get the last downloaded one
+    if etag is None:
+        if os.path.exists(cache_path) and not force_download:
+            return cache_path
+        else:
+            matching_files = [
+                file
+                for file in fnmatch.filter(os.listdir(cache_dir), filename.split(".")[0] + ".*")
+                if not file.endswith(".json") and not file.endswith(".lock")
+            ]
+            if len(matching_files) > 0 and not force_download and force_filename is None:
+                return os.path.join(cache_dir, matching_files[-1])
+            else:
+                # If files cannot be found and local_files_only=True,
+                # the models might've been found if local_files_only=False
+                # Notify the user about that
+                if local_files_only:
+                    raise LocalEntryNotFoundError(
+                        "Cannot find the requested files in the cached path and"
+                        " outgoing traffic has been disabled. To enable model look-ups"
+                        " and downloads online, set 'local_files_only' to False."
+                    )
+                else:
+                    raise LocalEntryNotFoundError(
+                        "Connection error, and we cannot find the requested files in"
+                        " the cached path. Please try again or make sure your Internet"
+                        " connection is on."
+                    )
+
+    # From now on, etag is not None.
+    if os.path.exists(cache_path) and not force_download:
+        return cache_path
+
+    # Prevent parallel downloads of the same file with a lock.
+    lock_path = cache_path + ".lock"
+
+    # Some Windows versions do not allow for paths longer than 255 characters.
+    # In this case, we must specify it is an extended path by using the "\\?\" prefix.
+    if os.name == "nt" and len(os.path.abspath(lock_path)) > 255:
+        lock_path = "\\\\?\\" + os.path.abspath(lock_path)
+
+    if os.name == "nt" and len(os.path.abspath(cache_path)) > 255:
+        cache_path = "\\\\?\\" + os.path.abspath(cache_path)
+
+    with WeakFileLock(lock_path):
+        # If the download just completed while the lock was activated.
+        if os.path.exists(cache_path) and not force_download:
+            # Even if returning early like here, the lock will be released.
+            return cache_path
+
+        if resume_download:
+            incomplete_path = cache_path + ".incomplete"
+
+            @contextmanager
+            def _resumable_file_manager() -> Generator[io.BufferedWriter, None, None]:
+                with open(incomplete_path, "ab") as f:
+                    yield f
+
+            temp_file_manager = _resumable_file_manager
+            if os.path.exists(incomplete_path):
+                resume_size = os.stat(incomplete_path).st_size
+            else:
+                resume_size = 0
+        else:
+            temp_file_manager = partial(  # type: ignore
+                tempfile.NamedTemporaryFile, mode="wb", dir=cache_dir, delete=False
+            )
+            resume_size = 0
+
+        # Download to temporary file, then copy to cache dir once finished.
+        # Otherwise you get corrupt cache entries if the download gets interrupted.
+        with temp_file_manager() as temp_file:
+            logger.info("downloading %s to %s", url, temp_file.name)
+
+            http_get(
+                url_to_download,
+                temp_file,
+                proxies=proxies,
+                resume_size=resume_size,
+                headers=headers,
+                expected_size=expected_size,
+            )
+
+        logger.info("storing %s in cache at %s", url, cache_path)
+        _chmod_and_replace(temp_file.name, cache_path)
+
+        if force_filename is None:
+            logger.info("creating metadata file for %s", cache_path)
+            meta = {"url": url, "etag": etag}
+            meta_path = cache_path + ".json"
+            with open(meta_path, "w") as meta_file:
+                json.dump(meta, meta_file)
+
+    return cache_path
+
+
+def _normalize_etag(etag: Optional[str]) -> Optional[str]:
+    """Normalize ETag HTTP header, so it can be used to create nice filepaths.
+
+    The HTTP spec allows two forms of ETag:
+      ETag: W/"<etag_value>"
+      ETag: "<etag_value>"
+
+    For now, we only expect the second form from the server, but we want to be future-proof so we support both. For
+    more context, see `TestNormalizeEtag` tests and https://github.com/huggingface/huggingface_hub/pull/1428.
+
+    Args:
+        etag (`str`, *optional*): HTTP header
+
+    Returns:
+        `str` or `None`: string that can be used as a nice directory name.
+        Returns `None` if input is None.
+    """
+    if etag is None:
+        return None
+    return etag.lstrip("W/").strip('"')
+
+
+def _create_relative_symlink(src: str, dst: str, new_blob: bool = False) -> None:
+    """Alias method used in `transformers` conversion script."""
+    return _create_symlink(src=src, dst=dst, new_blob=new_blob)
+
+
+def _create_symlink(src: str, dst: str, new_blob: bool = False) -> None:
+    """Create a symbolic link named dst pointing to src.
+
+    By default, it will try to create a symlink using a relative path. Relative paths have 2 advantages:
+    - If the cache_folder is moved (example: back-up on a shared drive), relative paths within the cache folder will
+      not break.
+    - Relative paths seems to be better handled on Windows. Issue was reported 3 times in less than a week when
+      changing from relative to absolute paths. See https://github.com/huggingface/huggingface_hub/issues/1398,
+      https://github.com/huggingface/diffusers/issues/2729 and https://github.com/huggingface/transformers/pull/22228.
+      NOTE: The issue with absolute paths doesn't happen on admin mode.
+    When creating a symlink from the cache to a local folder, it is possible that a relative path cannot be created.
+    This happens when paths are not on the same volume. In that case, we use absolute paths.
+
+
+    The result layout looks something like
+        └── [ 128]  snapshots
+            ├── [ 128]  2439f60ef33a0d46d85da5001d52aeda5b00ce9f
+            │   ├── [  52]  README.md -> ../../../blobs/d7edf6bd2a681fb0175f7735299831ee1b22b812
+            │   └── [  76]  pytorch_model.bin -> ../../../blobs/403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
+
+    If symlinks cannot be created on this platform (most likely to be Windows), the workaround is to avoid symlinks by
+    having the actual file in `dst`. If it is a new file (`new_blob=True`), we move it to `dst`. If it is not a new file
+    (`new_blob=False`), we don't know if the blob file is already referenced elsewhere. To avoid breaking existing
+    cache, the file is duplicated on the disk.
+
+    In case symlinks are not supported, a warning message is displayed to the user once when loading `huggingface_hub`.
+    The warning message can be disabled with the `DISABLE_SYMLINKS_WARNING` environment variable.
+    """
+    try:
+        os.remove(dst)
+    except OSError:
+        pass
+
+    abs_src = os.path.abspath(os.path.expanduser(src))
+    abs_dst = os.path.abspath(os.path.expanduser(dst))
+    abs_dst_folder = os.path.dirname(abs_dst)
+
+    # Use relative_dst in priority
+    try:
+        relative_src = os.path.relpath(abs_src, abs_dst_folder)
+    except ValueError:
+        # Raised on Windows if src and dst are not on the same volume. This is the case when creating a symlink to a
+        # local_dir instead of within the cache directory.
+        # See https://docs.python.org/3/library/os.path.html#os.path.relpath
+        relative_src = None
+
+    try:
+        commonpath = os.path.commonpath([abs_src, abs_dst])
+        _support_symlinks = are_symlinks_supported(commonpath)
+    except ValueError:
+        # Raised if src and dst are not on the same volume. Symlinks will still work on Linux/Macos.
+        # See https://docs.python.org/3/library/os.path.html#os.path.commonpath
+        _support_symlinks = os.name != "nt"
+    except PermissionError:
+        # Permission error means src and dst are not in the same volume (e.g. destination path has been provided
+        # by the user via `local_dir`. Let's test symlink support there)
+        _support_symlinks = are_symlinks_supported(abs_dst_folder)
+    except OSError as e:
+        # OS error (errno=30) means that the commonpath is readonly on Linux/MacOS.
+        if e.errno == errno.EROFS:
+            _support_symlinks = are_symlinks_supported(abs_dst_folder)
+        else:
+            raise
+
+    # Symlinks are supported => let's create a symlink.
+    if _support_symlinks:
+        src_rel_or_abs = relative_src or abs_src
+        logger.debug(f"Creating pointer from {src_rel_or_abs} to {abs_dst}")
+        try:
+            os.symlink(src_rel_or_abs, abs_dst)
+            return
+        except FileExistsError:
+            if os.path.islink(abs_dst) and os.path.realpath(abs_dst) == os.path.realpath(abs_src):
+                # `abs_dst` already exists and is a symlink to the `abs_src` blob. It is most likely that the file has
+                # been cached twice concurrently (exactly between `os.remove` and `os.symlink`). Do nothing.
+                return
+            else:
+                # Very unlikely to happen. Means a file `dst` has been created exactly between `os.remove` and
+                # `os.symlink` and is not a symlink to the `abs_src` blob file. Raise exception.
+                raise
+        except PermissionError:
+            # Permission error means src and dst are not in the same volume (e.g. download to local dir) and symlink
+            # is supported on both volumes but not between them. Let's just make a hard copy in that case.
+            pass
+
+    # Symlinks are not supported => let's move or copy the file.
+    if new_blob:
+        logger.info(f"Symlink not supported. Moving file from {abs_src} to {abs_dst}")
+        shutil.move(abs_src, abs_dst)
+    else:
+        logger.info(f"Symlink not supported. Copying file from {abs_src} to {abs_dst}")
+        shutil.copyfile(abs_src, abs_dst)
+
+
+def _cache_commit_hash_for_specific_revision(storage_folder: str, revision: str, commit_hash: str) -> None:
+    """Cache reference between a revision (tag, branch or truncated commit hash) and the corresponding commit hash.
+
+    Does nothing if `revision` is already a proper `commit_hash` or reference is already cached.
+    """
+    if revision != commit_hash:
+        ref_path = Path(storage_folder) / "refs" / revision
+        ref_path.parent.mkdir(parents=True, exist_ok=True)
+        if not ref_path.exists() or commit_hash != ref_path.read_text():
+            # Update ref only if has been updated. Could cause useless error in case
+            # repo is already cached and user doesn't have write access to cache folder.
+            # See https://github.com/huggingface/huggingface_hub/issues/1216.
+            ref_path.write_text(commit_hash)
+
+
+@validate_hf_hub_args
+def repo_folder_name(*, repo_id: str, repo_type: str) -> str:
+    """Return a serialized version of a hf.co repo name and type, safe for disk storage
+    as a single non-nested folder.
+
+    Example: models--julien-c--EsperBERTo-small
+    """
+    # remove all `/` occurrences to correctly convert repo to directory name
+    parts = [f"{repo_type}s", *repo_id.split("/")]
+    return REPO_ID_SEPARATOR.join(parts)
+
+
+def _check_disk_space(expected_size: int, target_dir: Union[str, Path]) -> None:
+    """Check disk usage and log a warning if there is not enough disk space to download the file.
+
+    Args:
+        expected_size (`int`):
+            The expected size of the file in bytes.
+        target_dir (`str`):
+            The directory where the file will be stored after downloading.
+    """
+
+    target_dir = Path(target_dir)  # format as `Path`
+    for path in [target_dir] + list(target_dir.parents):  # first check target_dir, then each parents one by one
+        try:
+            target_dir_free = shutil.disk_usage(path).free
+            if target_dir_free < expected_size:
+                warnings.warn(
+                    "Not enough free disk space to download the file. "
+                    f"The expected file size is: {expected_size / 1e6:.2f} MB. "
+                    f"The target location {target_dir} only has {target_dir_free / 1e6:.2f} MB free disk space."
+                )
+            return
+        except OSError:  # raise on anything: file does not exist or space disk cannot be checked
+            pass
+
+
+@validate_hf_hub_args
+def hf_hub_download(
+    repo_id: str,
+    filename: str,
+    *,
+    subfolder: Optional[str] = None,
+    repo_type: Optional[str] = None,
+    revision: Optional[str] = None,
+    library_name: Optional[str] = None,
+    library_version: Optional[str] = None,
+    cache_dir: Union[str, Path, None] = None,
+    local_dir: Union[str, Path, None] = None,
+    local_dir_use_symlinks: Union[bool, Literal["auto"]] = "auto",
+    user_agent: Union[Dict, str, None] = None,
+    force_download: bool = False,
+    force_filename: Optional[str] = None,
+    proxies: Optional[Dict] = None,
+    etag_timeout: float = DEFAULT_ETAG_TIMEOUT,
+    resume_download: bool = False,
+    token: Union[bool, str, None] = None,
+    local_files_only: bool = False,
+    headers: Optional[Dict[str, str]] = None,
+    legacy_cache_layout: bool = False,
+    endpoint: Optional[str] = None,
+) -> str:
+    """Download a given file if it's not already present in the local cache.
+
+    The new cache file layout looks like this:
+    - The cache directory contains one subfolder per repo_id (namespaced by repo type)
+    - inside each repo folder:
+        - refs is a list of the latest known revision => commit_hash pairs
+        - blobs contains the actual file blobs (identified by their git-sha or sha256, depending on
+          whether they're LFS files or not)
+        - snapshots contains one subfolder per commit, each "commit" contains the subset of the files
+          that have been resolved at that particular commit. Each filename is a symlink to the blob
+          at that particular commit.
+
+    If `local_dir` is provided, the file structure from the repo will be replicated in this location. You can configure
+    how you want to move those files:
+      - If `local_dir_use_symlinks="auto"` (default), files are downloaded and stored in the cache directory as blob
+        files. Small files (<5MB) are duplicated in `local_dir` while a symlink is created for bigger files. The goal
+        is to be able to manually edit and save small files without corrupting the cache while saving disk space for
+        binary files. The 5MB threshold can be configured with the `HF_HUB_LOCAL_DIR_AUTO_SYMLINK_THRESHOLD`
+        environment variable.
+      - If `local_dir_use_symlinks=True`, files are downloaded, stored in the cache directory and symlinked in `local_dir`.
+        This is optimal in term of disk usage but files must not be manually edited.
+      - If `local_dir_use_symlinks=False` and the blob files exist in the cache directory, they are duplicated in the
+        local dir. This means disk usage is not optimized.
+      - Finally, if `local_dir_use_symlinks=False` and the blob files do not exist in the cache directory, then the
+        files are downloaded and directly placed under `local_dir`. This means if you need to download them again later,
+        they will be re-downloaded entirely.
+
+    ```
+    [  96]  .
+    └── [ 160]  models--julien-c--EsperBERTo-small
+        ├── [ 160]  blobs
+        │   ├── [321M]  403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
+        │   ├── [ 398]  7cb18dc9bafbfcf74629a4b760af1b160957a83e
+        │   └── [1.4K]  d7edf6bd2a681fb0175f7735299831ee1b22b812
+        ├── [  96]  refs
+        │   └── [  40]  main
+        └── [ 128]  snapshots
+            ├── [ 128]  2439f60ef33a0d46d85da5001d52aeda5b00ce9f
+            │   ├── [  52]  README.md -> ../../blobs/d7edf6bd2a681fb0175f7735299831ee1b22b812
+            │   └── [  76]  pytorch_model.bin -> ../../blobs/403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
+            └── [ 128]  bbc77c8132af1cc5cf678da3f1ddf2de43606d48
+                ├── [  52]  README.md -> ../../blobs/7cb18dc9bafbfcf74629a4b760af1b160957a83e
+                └── [  76]  pytorch_model.bin -> ../../blobs/403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
+    ```
+
+    Args:
+        repo_id (`str`):
+            A user or an organization name and a repo name separated by a `/`.
+        filename (`str`):
+            The name of the file in the repo.
+        subfolder (`str`, *optional*):
+            An optional value corresponding to a folder inside the model repo.
+        repo_type (`str`, *optional*):
+            Set to `"dataset"` or `"space"` if downloading from a dataset or space,
+            `None` or `"model"` if downloading from a model. Default is `None`.
+        revision (`str`, *optional*):
+            An optional Git revision id which can be a branch name, a tag, or a
+            commit hash.
+        library_name (`str`, *optional*):
+            The name of the library to which the object corresponds.
+        library_version (`str`, *optional*):
+            The version of the library.
+        cache_dir (`str`, `Path`, *optional*):
+            Path to the folder where cached files are stored.
+        local_dir (`str` or `Path`, *optional*):
+            If provided, the downloaded file will be placed under this directory, either as a symlink (default) or
+            a regular file (see description for more details).
+        local_dir_use_symlinks (`"auto"` or `bool`, defaults to `"auto"`):
+            To be used with `local_dir`. If set to "auto", the cache directory will be used and the file will be either
+            duplicated or symlinked to the local directory depending on its size. It set to `True`, a symlink will be
+            created, no matter the file size. If set to `False`, the file will either be duplicated from cache (if
+            already exists) or downloaded from the Hub and not cached. See description for more details.
+        user_agent (`dict`, `str`, *optional*):
+            The user-agent info in the form of a dictionary or a string.
+        force_download (`bool`, *optional*, defaults to `False`):
+            Whether the file should be downloaded even if it already exists in
+            the local cache.
+        proxies (`dict`, *optional*):
+            Dictionary mapping protocol to the URL of the proxy passed to
+            `requests.request`.
+        etag_timeout (`float`, *optional*, defaults to `10`):
+            When fetching ETag, how many seconds to wait for the server to send
+            data before giving up which is passed to `requests.request`.
+        resume_download (`bool`, *optional*, defaults to `False`):
+            If `True`, resume a previously interrupted download.
+        token (`str`, `bool`, *optional*):
+            A token to be used for the download.
+                - If `True`, the token is read from the HuggingFace config
+                  folder.
+                - If a string, it's used as the authentication token.
+        local_files_only (`bool`, *optional*, defaults to `False`):
+            If `True`, avoid downloading the file and return the path to the
+            local cached file if it exists.
+        headers (`dict`, *optional*):
+            Additional headers to be sent with the request.
+        legacy_cache_layout (`bool`, *optional*, defaults to `False`):
+            If `True`, uses the legacy file cache layout i.e. just call [`hf_hub_url`]
+            then `cached_download`. This is deprecated as the new cache layout is
+            more powerful.
+
+    Returns:
+        Local path (string) of file or if networking is off, last version of
+        file cached on disk.
+
+    <Tip>
+
+    Raises the following errors:
+
+        - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError)
+          if `token=True` and the token cannot be found.
+        - [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError)
+          if ETag cannot be determined.
+        - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+          if some parameter value is invalid
+        - [`~utils.RepositoryNotFoundError`]
+          If the repository to download from cannot be found. This may be because it doesn't exist,
+          or because it is set to `private` and you do not have access.
+        - [`~utils.RevisionNotFoundError`]
+          If the revision to download from cannot be found.
+        - [`~utils.EntryNotFoundError`]
+          If the file to download cannot be found.
+        - [`~utils.LocalEntryNotFoundError`]
+          If network is disabled or unavailable and file is not found in cache.
+
+    </Tip>
+    """
+    if HF_HUB_ETAG_TIMEOUT != DEFAULT_ETAG_TIMEOUT:
+        # Respect environment variable above user value
+        etag_timeout = HF_HUB_ETAG_TIMEOUT
+
+    if force_filename is not None:
+        warnings.warn(
+            "The `force_filename` parameter is deprecated as a new caching system, "
+            "which keeps the filenames as they are on the Hub, is now in place.",
+            FutureWarning,
+        )
+        legacy_cache_layout = True
+
+    if legacy_cache_layout:
+        url = hf_hub_url(
+            repo_id,
+            filename,
+            subfolder=subfolder,
+            repo_type=repo_type,
+            revision=revision,
+            endpoint=endpoint,
+        )
+
+        return cached_download(
+            url,
+            library_name=library_name,
+            library_version=library_version,
+            cache_dir=cache_dir,
+            user_agent=user_agent,
+            force_download=force_download,
+            force_filename=force_filename,
+            proxies=proxies,
+            etag_timeout=etag_timeout,
+            resume_download=resume_download,
+            token=token,
+            local_files_only=local_files_only,
+            legacy_cache_layout=legacy_cache_layout,
+        )
+
+    if cache_dir is None:
+        cache_dir = HF_HUB_CACHE
+    if revision is None:
+        revision = DEFAULT_REVISION
+    if isinstance(cache_dir, Path):
+        cache_dir = str(cache_dir)
+    if isinstance(local_dir, Path):
+        local_dir = str(local_dir)
+    locks_dir = os.path.join(cache_dir, ".locks")
+
+    if subfolder == "":
+        subfolder = None
+    if subfolder is not None:
+        # This is used to create a URL, and not a local path, hence the forward slash.
+        filename = f"{subfolder}/{filename}"
+
+    if repo_type is None:
+        repo_type = "model"
+    if repo_type not in REPO_TYPES:
+        raise ValueError(f"Invalid repo type: {repo_type}. Accepted repo types are: {str(REPO_TYPES)}")
+
+    storage_folder = os.path.join(cache_dir, repo_folder_name(repo_id=repo_id, repo_type=repo_type))
+
+    # cross platform transcription of filename, to be used as a local file path.
+    relative_filename = os.path.join(*filename.split("/"))
+    if os.name == "nt":
+        if relative_filename.startswith("..\\") or "\\..\\" in relative_filename:
+            raise ValueError(
+                f"Invalid filename: cannot handle filename '{relative_filename}' on Windows. Please ask the repository"
+                " owner to rename this file."
+            )
+
+    # if user provides a commit_hash and they already have the file on disk,
+    # shortcut everything.
+    if REGEX_COMMIT_HASH.match(revision):
+        pointer_path = _get_pointer_path(storage_folder, revision, relative_filename)
+        if os.path.exists(pointer_path):
+            if local_dir is not None:
+                return _to_local_dir(pointer_path, local_dir, relative_filename, use_symlinks=local_dir_use_symlinks)
+            return pointer_path
+
+    url = hf_hub_url(repo_id, filename, repo_type=repo_type, revision=revision, endpoint=endpoint)
+
+    headers = build_hf_headers(
+        token=token,
+        library_name=library_name,
+        library_version=library_version,
+        user_agent=user_agent,
+        headers=headers,
+    )
+
+    url_to_download = url
+    etag = None
+    commit_hash = None
+    expected_size = None
+    head_call_error: Optional[Exception] = None
+    if not local_files_only:
+        try:
+            try:
+                metadata = get_hf_file_metadata(
+                    url=url,
+                    token=token,
+                    proxies=proxies,
+                    timeout=etag_timeout,
+                    library_name=library_name,
+                    library_version=library_version,
+                    user_agent=user_agent,
+                )
+            except EntryNotFoundError as http_error:
+                # Cache the non-existence of the file and raise
+                commit_hash = http_error.response.headers.get(HUGGINGFACE_HEADER_X_REPO_COMMIT)
+                if commit_hash is not None and not legacy_cache_layout:
+                    no_exist_file_path = Path(storage_folder) / ".no_exist" / commit_hash / relative_filename
+                    no_exist_file_path.parent.mkdir(parents=True, exist_ok=True)
+                    no_exist_file_path.touch()
+                    _cache_commit_hash_for_specific_revision(storage_folder, revision, commit_hash)
+                raise
+
+            # Commit hash must exist
+            commit_hash = metadata.commit_hash
+            if commit_hash is None:
+                raise FileMetadataError(
+                    "Distant resource does not seem to be on huggingface.co. It is possible that a configuration issue"
+                    " prevents you from downloading resources from https://huggingface.co. Please check your firewall"
+                    " and proxy settings and make sure your SSL certificates are updated."
+                )
+
+            # Etag must exist
+            etag = metadata.etag
+            # We favor a custom header indicating the etag of the linked resource, and
+            # we fallback to the regular etag header.
+            # If we don't have any of those, raise an error.
+            if etag is None:
+                raise FileMetadataError(
+                    "Distant resource does not have an ETag, we won't be able to reliably ensure reproducibility."
+                )
+
+            # Expected (uncompressed) size
+            expected_size = metadata.size
+
+            # In case of a redirect, save an extra redirect on the request.get call,
+            # and ensure we download the exact atomic version even if it changed
+            # between the HEAD and the GET (unlikely, but hey).
+            #
+            # If url domain is different => we are downloading from a CDN => url is signed => don't send auth
+            # If url domain is the same => redirect due to repo rename AND downloading a regular file => keep auth
+            if metadata.location != url:
+                url_to_download = metadata.location
+                if urlparse(url).netloc != urlparse(url_to_download).netloc:
+                    # Remove authorization header when downloading a LFS blob
+                    headers.pop("authorization", None)
+        except (requests.exceptions.SSLError, requests.exceptions.ProxyError):
+            # Actually raise for those subclasses of ConnectionError
+            raise
+        except (
+            requests.exceptions.ConnectionError,
+            requests.exceptions.Timeout,
+            OfflineModeIsEnabled,
+        ) as error:
+            # Otherwise, our Internet connection is down.
+            # etag is None
+            head_call_error = error
+            pass
+        except (RevisionNotFoundError, EntryNotFoundError):
+            # The repo was found but the revision or entry doesn't exist on the Hub (never existed or got deleted)
+            raise
+        except requests.HTTPError as error:
+            # Multiple reasons for an http error:
+            # - Repository is private and invalid/missing token sent
+            # - Repository is gated and invalid/missing token sent
+            # - Hub is down (error 500 or 504)
+            # => let's switch to 'local_files_only=True' to check if the files are already cached.
+            #    (if it's not the case, the error will be re-raised)
+            head_call_error = error
+            pass
+        except FileMetadataError as error:
+            # Multiple reasons for a FileMetadataError:
+            # - Wrong network configuration (proxy, firewall, SSL certificates)
+            # - Inconsistency on the Hub
+            # => let's switch to 'local_files_only=True' to check if the files are already cached.
+            #    (if it's not the case, the error will be re-raised)
+            head_call_error = error
+            pass
+
+    assert (
+        local_files_only or etag is not None or head_call_error is not None
+    ), "etag is empty due to uncovered problems"
+
+    # etag can be None for several reasons:
+    # 1. we passed local_files_only.
+    # 2. we don't have a connection
+    # 3. Hub is down (HTTP 500 or 504)
+    # 4. repo is not found -for example private or gated- and invalid/missing token sent
+    # 5. Hub is blocked by a firewall or proxy is not set correctly.
+    # => Try to get the last downloaded one from the specified revision.
+    #
+    # If the specified revision is a commit hash, look inside "snapshots".
+    # If the specified revision is a branch or tag, look inside "refs".
+    if etag is None:
+        # In those cases, we cannot force download.
+        if force_download:
+            if local_files_only:
+                raise ValueError("Cannot pass 'force_download=True' and 'local_files_only=True' at the same time.")
+            elif isinstance(head_call_error, OfflineModeIsEnabled):
+                raise ValueError(
+                    "Cannot pass 'force_download=True' when offline mode is enabled."
+                ) from head_call_error
+            else:
+                raise ValueError("Force download failed due to the above error.") from head_call_error
+
+        # Try to get "commit_hash" from "revision"
+        commit_hash = None
+        if REGEX_COMMIT_HASH.match(revision):
+            commit_hash = revision
+        else:
+            ref_path = os.path.join(storage_folder, "refs", revision)
+            if os.path.isfile(ref_path):
+                with open(ref_path) as f:
+                    commit_hash = f.read()
+
+        # Return pointer file if exists
+        if commit_hash is not None:
+            pointer_path = _get_pointer_path(storage_folder, commit_hash, relative_filename)
+            if os.path.exists(pointer_path):
+                if local_dir is not None:
+                    return _to_local_dir(
+                        pointer_path, local_dir, relative_filename, use_symlinks=local_dir_use_symlinks
+                    )
+                return pointer_path
+
+        # If we couldn't find an appropriate file on disk, raise an error.
+        # If files cannot be found and local_files_only=True,
+        # the models might've been found if local_files_only=False
+        # Notify the user about that
+        if local_files_only:
+            raise LocalEntryNotFoundError(
+                "Cannot find the requested files in the disk cache and outgoing traffic has been disabled. To enable"
+                " hf.co look-ups and downloads online, set 'local_files_only' to False."
+            )
+        elif isinstance(head_call_error, RepositoryNotFoundError) or isinstance(head_call_error, GatedRepoError):
+            # Repo not found or gated => let's raise the actual error
+            raise head_call_error
+        else:
+            # Otherwise: most likely a connection issue or Hub downtime => let's warn the user
+            raise LocalEntryNotFoundError(
+                "An error happened while trying to locate the file on the Hub and we cannot find the requested files"
+                " in the local cache. Please check your connection and try again or make sure your Internet connection"
+                " is on."
+            ) from head_call_error
+
+    # From now on, etag and commit_hash are not None.
+    assert etag is not None, "etag must have been retrieved from server"
+    assert commit_hash is not None, "commit_hash must have been retrieved from server"
+    blob_path = os.path.join(storage_folder, "blobs", etag)
+    pointer_path = _get_pointer_path(storage_folder, commit_hash, relative_filename)
+
+    os.makedirs(os.path.dirname(blob_path), exist_ok=True)
+    os.makedirs(os.path.dirname(pointer_path), exist_ok=True)
+    # if passed revision is not identical to commit_hash
+    # then revision has to be a branch name or tag name.
+    # In that case store a ref.
+    _cache_commit_hash_for_specific_revision(storage_folder, revision, commit_hash)
+
+    if os.path.exists(pointer_path) and not force_download:
+        if local_dir is not None:
+            return _to_local_dir(pointer_path, local_dir, relative_filename, use_symlinks=local_dir_use_symlinks)
+        return pointer_path
+
+    if os.path.exists(blob_path) and not force_download:
+        # we have the blob already, but not the pointer
+        if local_dir is not None:  # to local dir
+            return _to_local_dir(blob_path, local_dir, relative_filename, use_symlinks=local_dir_use_symlinks)
+        else:  # or in snapshot cache
+            _create_symlink(blob_path, pointer_path, new_blob=False)
+            return pointer_path
+
+    # Prevent parallel downloads of the same file with a lock.
+    # etag could be duplicated across repos,
+    lock_path = os.path.join(locks_dir, repo_folder_name(repo_id=repo_id, repo_type=repo_type), f"{etag}.lock")
+
+    # Some Windows versions do not allow for paths longer than 255 characters.
+    # In this case, we must specify it is an extended path by using the "\\?\" prefix.
+    if os.name == "nt" and len(os.path.abspath(lock_path)) > 255:
+        lock_path = "\\\\?\\" + os.path.abspath(lock_path)
+
+    if os.name == "nt" and len(os.path.abspath(blob_path)) > 255:
+        blob_path = "\\\\?\\" + os.path.abspath(blob_path)
+
+    Path(lock_path).parent.mkdir(parents=True, exist_ok=True)
+    with WeakFileLock(lock_path):
+        # If the download just completed while the lock was activated.
+        if os.path.exists(pointer_path) and not force_download:
+            # Even if returning early like here, the lock will be released.
+            if local_dir is not None:
+                return _to_local_dir(pointer_path, local_dir, relative_filename, use_symlinks=local_dir_use_symlinks)
+            return pointer_path
+
+        if resume_download:
+            incomplete_path = blob_path + ".incomplete"
+
+            @contextmanager
+            def _resumable_file_manager() -> Generator[io.BufferedWriter, None, None]:
+                with open(incomplete_path, "ab") as f:
+                    yield f
+
+            temp_file_manager = _resumable_file_manager
+            if os.path.exists(incomplete_path):
+                resume_size = os.stat(incomplete_path).st_size
+            else:
+                resume_size = 0
+        else:
+            temp_file_manager = partial(  # type: ignore
+                tempfile.NamedTemporaryFile, mode="wb", dir=cache_dir, delete=False
+            )
+            resume_size = 0
+
+        # Download to temporary file, then copy to cache dir once finished.
+        # Otherwise you get corrupt cache entries if the download gets interrupted.
+        with temp_file_manager() as temp_file:
+            logger.info("downloading %s to %s", url, temp_file.name)
+
+            if expected_size is not None:  # might be None if HTTP header not set correctly
+                # Check tmp path
+                _check_disk_space(expected_size, os.path.dirname(temp_file.name))
+
+                # Check destination
+                _check_disk_space(expected_size, os.path.dirname(blob_path))
+                if local_dir is not None:
+                    _check_disk_space(expected_size, local_dir)
+
+            http_get(
+                url_to_download,
+                temp_file,
+                proxies=proxies,
+                resume_size=resume_size,
+                headers=headers,
+                expected_size=expected_size,
+                displayed_filename=filename,
+            )
+
+        if local_dir is None:
+            logger.debug(f"Storing {url} in cache at {blob_path}")
+            _chmod_and_replace(temp_file.name, blob_path)
+            _create_symlink(blob_path, pointer_path, new_blob=True)
+        else:
+            local_dir_filepath = os.path.join(local_dir, relative_filename)
+            os.makedirs(os.path.dirname(local_dir_filepath), exist_ok=True)
+
+            # If "auto" (default) copy-paste small files to ease manual editing but symlink big files to save disk
+            # In both cases, blob file is cached.
+            is_big_file = os.stat(temp_file.name).st_size > constants.HF_HUB_LOCAL_DIR_AUTO_SYMLINK_THRESHOLD
+            if local_dir_use_symlinks is True or (local_dir_use_symlinks == "auto" and is_big_file):
+                logger.debug(f"Storing {url} in cache at {blob_path}")
+                _chmod_and_replace(temp_file.name, blob_path)
+                logger.debug("Create symlink to local dir")
+                _create_symlink(blob_path, local_dir_filepath, new_blob=False)
+            elif local_dir_use_symlinks == "auto" and not is_big_file:
+                logger.debug(f"Storing {url} in cache at {blob_path}")
+                _chmod_and_replace(temp_file.name, blob_path)
+                logger.debug("Duplicate in local dir (small file and use_symlink set to 'auto')")
+                shutil.copyfile(blob_path, local_dir_filepath)
+            else:
+                logger.debug(f"Storing {url} in local_dir at {local_dir_filepath} (not cached).")
+                _chmod_and_replace(temp_file.name, local_dir_filepath)
+            pointer_path = local_dir_filepath  # for return value
+
+    return pointer_path
+
+
+@validate_hf_hub_args
+def try_to_load_from_cache(
+    repo_id: str,
+    filename: str,
+    cache_dir: Union[str, Path, None] = None,
+    revision: Optional[str] = None,
+    repo_type: Optional[str] = None,
+) -> Union[str, _CACHED_NO_EXIST_T, None]:
+    """
+    Explores the cache to return the latest cached file for a given revision if found.
+
+    This function will not raise any exception if the file in not cached.
+
+    Args:
+        cache_dir (`str` or `os.PathLike`):
+            The folder where the cached files lie.
+        repo_id (`str`):
+            The ID of the repo on huggingface.co.
+        filename (`str`):
+            The filename to look for inside `repo_id`.
+        revision (`str`, *optional*):
+            The specific model version to use. Will default to `"main"` if it's not provided and no `commit_hash` is
+            provided either.
+        repo_type (`str`, *optional*):
+            The type of the repository. Will default to `"model"`.
+
+    Returns:
+        `Optional[str]` or `_CACHED_NO_EXIST`:
+            Will return `None` if the file was not cached. Otherwise:
+            - The exact path to the cached file if it's found in the cache
+            - A special value `_CACHED_NO_EXIST` if the file does not exist at the given commit hash and this fact was
+              cached.
+
+    Example:
+
+    ```python
+    from huggingface_hub import try_to_load_from_cache, _CACHED_NO_EXIST
+
+    filepath = try_to_load_from_cache()
+    if isinstance(filepath, str):
+        # file exists and is cached
+        ...
+    elif filepath is _CACHED_NO_EXIST:
+        # non-existence of file is cached
+        ...
+    else:
+        # file is not cached
+        ...
+    ```
+    """
+    if revision is None:
+        revision = "main"
+    if repo_type is None:
+        repo_type = "model"
+    if repo_type not in REPO_TYPES:
+        raise ValueError(f"Invalid repo type: {repo_type}. Accepted repo types are: {str(REPO_TYPES)}")
+    if cache_dir is None:
+        cache_dir = HF_HUB_CACHE
+
+    object_id = repo_id.replace("/", "--")
+    repo_cache = os.path.join(cache_dir, f"{repo_type}s--{object_id}")
+    if not os.path.isdir(repo_cache):
+        # No cache for this model
+        return None
+
+    refs_dir = os.path.join(repo_cache, "refs")
+    snapshots_dir = os.path.join(repo_cache, "snapshots")
+    no_exist_dir = os.path.join(repo_cache, ".no_exist")
+
+    # Resolve refs (for instance to convert main to the associated commit sha)
+    if os.path.isdir(refs_dir):
+        revision_file = os.path.join(refs_dir, revision)
+        if os.path.isfile(revision_file):
+            with open(revision_file) as f:
+                revision = f.read()
+
+    # Check if file is cached as "no_exist"
+    if os.path.isfile(os.path.join(no_exist_dir, revision, filename)):
+        return _CACHED_NO_EXIST
+
+    # Check if revision folder exists
+    if not os.path.exists(snapshots_dir):
+        return None
+    cached_shas = os.listdir(snapshots_dir)
+    if revision not in cached_shas:
+        # No cache for this revision and we won't try to return a random revision
+        return None
+
+    # Check if file exists in cache
+    cached_file = os.path.join(snapshots_dir, revision, filename)
+    return cached_file if os.path.isfile(cached_file) else None
+
+
+@validate_hf_hub_args
+def get_hf_file_metadata(
+    url: str,
+    token: Union[bool, str, None] = None,
+    proxies: Optional[Dict] = None,
+    timeout: Optional[float] = DEFAULT_REQUEST_TIMEOUT,
+    library_name: Optional[str] = None,
+    library_version: Optional[str] = None,
+    user_agent: Union[Dict, str, None] = None,
+    headers: Optional[Dict[str, str]] = None,
+) -> HfFileMetadata:
+    """Fetch metadata of a file versioned on the Hub for a given url.
+
+    Args:
+        url (`str`):
+            File url, for example returned by [`hf_hub_url`].
+        token (`str` or `bool`, *optional*):
+            A token to be used for the download.
+                - If `True`, the token is read from the HuggingFace config
+                  folder.
+                - If `False` or `None`, no token is provided.
+                - If a string, it's used as the authentication token.
+        proxies (`dict`, *optional*):
+            Dictionary mapping protocol to the URL of the proxy passed to
+            `requests.request`.
+        timeout (`float`, *optional*, defaults to 10):
+            How many seconds to wait for the server to send metadata before giving up.
+        library_name (`str`, *optional*):
+            The name of the library to which the object corresponds.
+        library_version (`str`, *optional*):
+            The version of the library.
+        user_agent (`dict`, `str`, *optional*):
+            The user-agent info in the form of a dictionary or a string.
+        headers (`dict`, *optional*):
+            Additional headers to be sent with the request.
+
+    Returns:
+        A [`HfFileMetadata`] object containing metadata such as location, etag, size and
+        commit_hash.
+    """
+    headers = build_hf_headers(
+        token=token,
+        library_name=library_name,
+        library_version=library_version,
+        user_agent=user_agent,
+        headers=headers,
+    )
+    headers["Accept-Encoding"] = "identity"  # prevent any compression => we want to know the real size of the file
+
+    # Retrieve metadata
+    r = _request_wrapper(
+        method="HEAD",
+        url=url,
+        headers=headers,
+        allow_redirects=False,
+        follow_relative_redirects=True,
+        proxies=proxies,
+        timeout=timeout,
+    )
+    hf_raise_for_status(r)
+
+    # Return
+    return HfFileMetadata(
+        commit_hash=r.headers.get(HUGGINGFACE_HEADER_X_REPO_COMMIT),
+        # We favor a custom header indicating the etag of the linked resource, and
+        # we fallback to the regular etag header.
+        etag=_normalize_etag(r.headers.get(HUGGINGFACE_HEADER_X_LINKED_ETAG) or r.headers.get("ETag")),
+        # Either from response headers (if redirected) or defaults to request url
+        # Do not use directly `url`, as `_request_wrapper` might have followed relative
+        # redirects.
+        location=r.headers.get("Location") or r.request.url,  # type: ignore
+        size=_int_or_none(r.headers.get(HUGGINGFACE_HEADER_X_LINKED_SIZE) or r.headers.get("Content-Length")),
+    )
+
+
+def _int_or_none(value: Optional[str]) -> Optional[int]:
+    try:
+        return int(value)  # type: ignore
+    except (TypeError, ValueError):
+        return None
+
+
+def _chmod_and_replace(src: str, dst: str) -> None:
+    """Set correct permission before moving a blob from tmp directory to cache dir.
+
+    Do not take into account the `umask` from the process as there is no convenient way
+    to get it that is thread-safe.
+
+    See:
+    - About umask: https://docs.python.org/3/library/os.html#os.umask
+    - Thread-safety: https://stackoverflow.com/a/70343066
+    - About solution: https://github.com/huggingface/huggingface_hub/pull/1220#issuecomment-1326211591
+    - Fix issue: https://github.com/huggingface/huggingface_hub/issues/1141
+    - Fix issue: https://github.com/huggingface/huggingface_hub/issues/1215
+    """
+    # Get umask by creating a temporary file in the cached repo folder.
+    tmp_file = Path(dst).parent.parent / f"tmp_{uuid.uuid4()}"
+    try:
+        tmp_file.touch()
+        cache_dir_mode = Path(tmp_file).stat().st_mode
+        os.chmod(src, stat.S_IMODE(cache_dir_mode))
+    finally:
+        tmp_file.unlink()
+
+    shutil.move(src, dst)
+
+
+def _get_pointer_path(storage_folder: str, revision: str, relative_filename: str) -> str:
+    # Using `os.path.abspath` instead of `Path.resolve()` to avoid resolving symlinks
+    snapshot_path = os.path.join(storage_folder, "snapshots")
+    pointer_path = os.path.join(snapshot_path, revision, relative_filename)
+    if Path(os.path.abspath(snapshot_path)) not in Path(os.path.abspath(pointer_path)).parents:
+        raise ValueError(
+            "Invalid pointer path: cannot create pointer path in snapshot folder if"
+            f" `storage_folder='{storage_folder}'`, `revision='{revision}'` and"
+            f" `relative_filename='{relative_filename}'`."
+        )
+    return pointer_path
+
+
+def _to_local_dir(
+    path: str, local_dir: str, relative_filename: str, use_symlinks: Union[bool, Literal["auto"]]
+) -> str:
+    """Place a file in a local dir (different than cache_dir).
+
+    Either symlink to blob file in cache or duplicate file depending on `use_symlinks` and file size.
+    """
+    # Using `os.path.abspath` instead of `Path.resolve()` to avoid resolving symlinks
+    local_dir_filepath = os.path.join(local_dir, relative_filename)
+    if Path(os.path.abspath(local_dir)) not in Path(os.path.abspath(local_dir_filepath)).parents:
+        raise ValueError(
+            f"Cannot copy file '{relative_filename}' to local dir '{local_dir}': file would not be in the local"
+            " directory."
+        )
+
+    os.makedirs(os.path.dirname(local_dir_filepath), exist_ok=True)
+    real_blob_path = os.path.realpath(path)
+
+    # If "auto" (default) copy-paste small files to ease manual editing but symlink big files to save disk
+    if use_symlinks == "auto":
+        use_symlinks = os.stat(real_blob_path).st_size > constants.HF_HUB_LOCAL_DIR_AUTO_SYMLINK_THRESHOLD
+
+    if use_symlinks:
+        _create_symlink(real_blob_path, local_dir_filepath, new_blob=False)
+    else:
+        shutil.copyfile(real_blob_path, local_dir_filepath)
+    return local_dir_filepath
diff --git a/llm/Lib/site-packages/huggingface_hub/hf_api.py b/llm/Lib/site-packages/huggingface_hub/hf_api.py
new file mode 100644
index 0000000000000000000000000000000000000000..9e77228a8d870f77e46ed486d37240443fdfd62e
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/hf_api.py
@@ -0,0 +1,8627 @@
+# coding=utf-8
+# Copyright 2019-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from __future__ import annotations
+
+import inspect
+import json
+import re
+import struct
+import warnings
+from concurrent.futures import Future, ThreadPoolExecutor
+from dataclasses import asdict, dataclass, field
+from datetime import datetime
+from functools import wraps
+from itertools import islice
+from pathlib import Path
+from typing import (
+    Any,
+    BinaryIO,
+    Callable,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Literal,
+    Optional,
+    Tuple,
+    TypeVar,
+    Union,
+    overload,
+)
+from urllib.parse import quote
+
+import requests
+from requests.exceptions import HTTPError
+from tqdm.auto import tqdm as base_tqdm
+from tqdm.contrib.concurrent import thread_map
+
+from ._commit_api import (
+    CommitOperation,
+    CommitOperationAdd,
+    CommitOperationCopy,
+    CommitOperationDelete,
+    _fetch_files_to_copy,
+    _fetch_upload_modes,
+    _prepare_commit_payload,
+    _upload_lfs_files,
+    _warn_on_overwriting_operations,
+)
+from ._inference_endpoints import InferenceEndpoint, InferenceEndpointType
+from ._multi_commits import (
+    MULTI_COMMIT_PR_CLOSE_COMMENT_FAILURE_BAD_REQUEST_TEMPLATE,
+    MULTI_COMMIT_PR_CLOSE_COMMENT_FAILURE_NO_CHANGES_TEMPLATE,
+    MULTI_COMMIT_PR_CLOSING_COMMENT_TEMPLATE,
+    MULTI_COMMIT_PR_COMPLETION_COMMENT_TEMPLATE,
+    MultiCommitException,
+    MultiCommitStep,
+    MultiCommitStrategy,
+    multi_commit_create_pull_request,
+    multi_commit_generate_comment,
+    multi_commit_parse_pr_description,
+    plan_multi_commits,
+)
+from ._space_api import SpaceHardware, SpaceRuntime, SpaceStorage, SpaceVariable
+from .community import (
+    Discussion,
+    DiscussionComment,
+    DiscussionStatusChange,
+    DiscussionTitleChange,
+    DiscussionWithDetails,
+    deserialize_event,
+)
+from .constants import (
+    DEFAULT_ETAG_TIMEOUT,
+    DEFAULT_REQUEST_TIMEOUT,
+    DEFAULT_REVISION,
+    DISCUSSION_STATUS,
+    DISCUSSION_TYPES,
+    ENDPOINT,
+    INFERENCE_ENDPOINTS_ENDPOINT,
+    REGEX_COMMIT_OID,
+    REPO_TYPE_MODEL,
+    REPO_TYPES,
+    REPO_TYPES_MAPPING,
+    REPO_TYPES_URL_PREFIXES,
+    SAFETENSORS_INDEX_FILE,
+    SAFETENSORS_MAX_HEADER_LENGTH,
+    SAFETENSORS_SINGLE_FILE,
+    SPACES_SDK_TYPES,
+    DiscussionStatusFilter,
+    DiscussionTypeFilter,
+)
+from .file_download import HfFileMetadata, get_hf_file_metadata, hf_hub_url
+from .repocard_data import DatasetCardData, ModelCardData, SpaceCardData
+from .utils import (  # noqa: F401 # imported for backward compatibility
+    IGNORE_GIT_FOLDER_PATTERNS,
+    BadRequestError,
+    EntryNotFoundError,
+    GatedRepoError,
+    HfFolder,
+    HfHubHTTPError,
+    LocalTokenNotFoundError,
+    NotASafetensorsRepoError,
+    RepositoryNotFoundError,
+    RevisionNotFoundError,
+    SafetensorsFileMetadata,
+    SafetensorsParsingError,
+    SafetensorsRepoMetadata,
+    TensorInfo,
+    build_hf_headers,
+    experimental,
+    filter_repo_objects,
+    fix_hf_endpoint_in_url,
+    get_session,
+    hf_raise_for_status,
+    logging,
+    paginate,
+    parse_datetime,
+    validate_hf_hub_args,
+)
+from .utils import tqdm as hf_tqdm
+from .utils._deprecation import _deprecate_arguments, _deprecate_method
+from .utils._typing import CallableT
+from .utils.endpoint_helpers import (
+    DatasetFilter,
+    ModelFilter,
+    _is_emission_within_treshold,
+)
+
+
+R = TypeVar("R")  # Return type
+CollectionItemType_T = Literal["model", "dataset", "space", "paper"]
+
+USERNAME_PLACEHOLDER = "hf_user"
+_REGEX_DISCUSSION_URL = re.compile(r".*/discussions/(\d+)$")
+
+_CREATE_COMMIT_NO_REPO_ERROR_MESSAGE = (
+    "\nNote: Creating a commit assumes that the repo already exists on the"
+    " Huggingface Hub. Please use `create_repo` if it's not the case."
+)
+
+logger = logging.get_logger(__name__)
+
+
+def repo_type_and_id_from_hf_id(hf_id: str, hub_url: Optional[str] = None) -> Tuple[Optional[str], Optional[str], str]:
+    """
+    Returns the repo type and ID from a huggingface.co URL linking to a
+    repository
+
+    Args:
+        hf_id (`str`):
+            An URL or ID of a repository on the HF hub. Accepted values are:
+
+            - https://huggingface.co/<repo_type>/<namespace>/<repo_id>
+            - https://huggingface.co/<namespace>/<repo_id>
+            - hf://<repo_type>/<namespace>/<repo_id>
+            - hf://<namespace>/<repo_id>
+            - <repo_type>/<namespace>/<repo_id>
+            - <namespace>/<repo_id>
+            - <repo_id>
+        hub_url (`str`, *optional*):
+            The URL of the HuggingFace Hub, defaults to https://huggingface.co
+
+    Returns:
+        A tuple with three items: repo_type (`str` or `None`), namespace (`str` or
+        `None`) and repo_id (`str`).
+
+    Raises:
+        - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If URL cannot be parsed.
+        - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If `repo_type` is unknown.
+    """
+    input_hf_id = hf_id
+
+    hub_url = re.sub(r"https?://", "", hub_url if hub_url is not None else ENDPOINT)
+    is_hf_url = hub_url in hf_id and "@" not in hf_id
+
+    HFFS_PREFIX = "hf://"
+    if hf_id.startswith(HFFS_PREFIX):  # Remove "hf://" prefix if exists
+        hf_id = hf_id[len(HFFS_PREFIX) :]
+
+    url_segments = hf_id.split("/")
+    is_hf_id = len(url_segments) <= 3
+
+    namespace: Optional[str]
+    if is_hf_url:
+        namespace, repo_id = url_segments[-2:]
+        if namespace == hub_url:
+            namespace = None
+        if len(url_segments) > 2 and hub_url not in url_segments[-3]:
+            repo_type = url_segments[-3]
+        elif namespace in REPO_TYPES_MAPPING:
+            # Mean canonical dataset or model
+            repo_type = REPO_TYPES_MAPPING[namespace]
+            namespace = None
+        else:
+            repo_type = None
+    elif is_hf_id:
+        if len(url_segments) == 3:
+            # Passed <repo_type>/<user>/<model_id> or <repo_type>/<org>/<model_id>
+            repo_type, namespace, repo_id = url_segments[-3:]
+        elif len(url_segments) == 2:
+            if url_segments[0] in REPO_TYPES_MAPPING:
+                # Passed '<model_id>' or 'datasets/<dataset_id>' for a canonical model or dataset
+                repo_type = REPO_TYPES_MAPPING[url_segments[0]]
+                namespace = None
+                repo_id = hf_id.split("/")[-1]
+            else:
+                # Passed <user>/<model_id> or <org>/<model_id>
+                namespace, repo_id = hf_id.split("/")[-2:]
+                repo_type = None
+        else:
+            # Passed <model_id>
+            repo_id = url_segments[0]
+            namespace, repo_type = None, None
+    else:
+        raise ValueError(f"Unable to retrieve user and repo ID from the passed HF ID: {hf_id}")
+
+    # Check if repo type is known (mapping "spaces" => "space" + empty value => `None`)
+    if repo_type in REPO_TYPES_MAPPING:
+        repo_type = REPO_TYPES_MAPPING[repo_type]
+    if repo_type == "":
+        repo_type = None
+    if repo_type not in REPO_TYPES:
+        raise ValueError(f"Unknown `repo_type`: '{repo_type}' ('{input_hf_id}')")
+
+    return repo_type, namespace, repo_id
+
+
+@dataclass
+class LastCommitInfo(dict):
+    oid: str
+    title: str
+    date: datetime
+
+    def __post_init__(self):  # hack to make LastCommitInfo backward compatible
+        self.update(asdict(self))
+
+
+@dataclass
+class BlobLfsInfo(dict):
+    size: int
+    sha256: str
+    pointer_size: int
+
+    def __post_init__(self):  # hack to make BlobLfsInfo backward compatible
+        self.update(asdict(self))
+
+
+@dataclass
+class BlobSecurityInfo(dict):
+    safe: bool
+    av_scan: Optional[Dict]
+    pickle_import_scan: Optional[Dict]
+
+    def __post_init__(self):  # hack to make BlogSecurityInfo backward compatible
+        self.update(asdict(self))
+
+
+@dataclass
+class TransformersInfo(dict):
+    auto_model: str
+    custom_class: Optional[str] = None
+    # possible `pipeline_tag` values: https://github.com/huggingface/huggingface.js/blob/3ee32554b8620644a6287e786b2a83bf5caf559c/packages/tasks/src/pipelines.ts#L72
+    pipeline_tag: Optional[str] = None
+    processor: Optional[str] = None
+
+    def __post_init__(self):  # hack to make TransformersInfo backward compatible
+        self.update(asdict(self))
+
+
+@dataclass
+class SafeTensorsInfo(dict):
+    parameters: List[Dict[str, int]]
+    total: int
+
+    def __post_init__(self):  # hack to make SafeTensorsInfo backward compatible
+        self.update(asdict(self))
+
+
+@dataclass
+class CommitInfo(str):
+    """Data structure containing information about a newly created commit.
+
+    Returned by any method that creates a commit on the Hub: [`create_commit`], [`upload_file`], [`upload_folder`],
+    [`delete_file`], [`delete_folder`]. It inherits from `str` for backward compatibility but using methods specific
+    to `str` is deprecated.
+
+    Attributes:
+        commit_url (`str`):
+            Url where to find the commit.
+
+        commit_message (`str`):
+            The summary (first line) of the commit that has been created.
+
+        commit_description (`str`):
+            Description of the commit that has been created. Can be empty.
+
+        oid (`str`):
+            Commit hash id. Example: `"91c54ad1727ee830252e457677f467be0bfd8a57"`.
+
+        pr_url (`str`, *optional*):
+            Url to the PR that has been created, if any. Populated when `create_pr=True`
+            is passed.
+
+        pr_revision (`str`, *optional*):
+            Revision of the PR that has been created, if any. Populated when
+            `create_pr=True` is passed. Example: `"refs/pr/1"`.
+
+        pr_num (`int`, *optional*):
+            Number of the PR discussion that has been created, if any. Populated when
+            `create_pr=True` is passed. Can be passed as `discussion_num` in
+            [`get_discussion_details`]. Example: `1`.
+
+        _url (`str`, *optional*):
+            Legacy url for `str` compatibility. Can be the url to the uploaded file on the Hub (if returned by
+            [`upload_file`]), to the uploaded folder on the Hub (if returned by [`upload_folder`]) or to the commit on
+            the Hub (if returned by [`create_commit`]). Defaults to `commit_url`. It is deprecated to use this
+            attribute. Please use `commit_url` instead.
+    """
+
+    commit_url: str
+    commit_message: str
+    commit_description: str
+    oid: str
+    pr_url: Optional[str] = None
+
+    # Computed from `pr_url` in `__post_init__`
+    pr_revision: Optional[str] = field(init=False)
+    pr_num: Optional[str] = field(init=False)
+
+    # legacy url for `str` compatibility (ex: url to uploaded file, url to uploaded folder, url to PR, etc.)
+    _url: str = field(repr=False, default=None)  # type: ignore  # defaults to `commit_url`
+
+    def __new__(cls, *args, commit_url: str, _url: Optional[str] = None, **kwargs):
+        return str.__new__(cls, _url or commit_url)
+
+    def __post_init__(self):
+        """Populate pr-related fields after initialization.
+
+        See https://docs.python.org/3.10/library/dataclasses.html#post-init-processing.
+        """
+        if self.pr_url is not None:
+            self.pr_revision = _parse_revision_from_pr_url(self.pr_url)
+            self.pr_num = int(self.pr_revision.split("/")[-1])
+        else:
+            self.pr_revision = None
+            self.pr_num = None
+
+
+@dataclass
+class AccessRequest:
+    """Data structure containing information about a user access request.
+
+    Attributes:
+        username (`str`):
+            Username of the user who requested access.
+        fullname (`str`):
+            Fullname of the user who requested access.
+        email (`str`):
+            Email of the user who requested access.
+        timestamp (`datetime`):
+            Timestamp of the request.
+        status (`Literal["pending", "accepted", "rejected"]`):
+            Status of the request. Can be one of `["pending", "accepted", "rejected"]`.
+        fields (`Dict[str, Any]`, *optional*):
+            Additional fields filled by the user in the gate form.
+    """
+
+    username: str
+    fullname: str
+    email: str
+    timestamp: datetime
+    status: Literal["pending", "accepted", "rejected"]
+
+    # Additional fields filled by the user in the gate form
+    fields: Optional[Dict[str, Any]] = None
+
+
+class RepoUrl(str):
+    """Subclass of `str` describing a repo URL on the Hub.
+
+    `RepoUrl` is returned by `HfApi.create_repo`. It inherits from `str` for backward
+    compatibility. At initialization, the URL is parsed to populate properties:
+    - endpoint (`str`)
+    - namespace (`Optional[str]`)
+    - repo_name (`str`)
+    - repo_id (`str`)
+    - repo_type (`Literal["model", "dataset", "space"]`)
+    - url (`str`)
+
+    Args:
+        url (`Any`):
+            String value of the repo url.
+        endpoint (`str`, *optional*):
+            Endpoint of the Hub. Defaults to <https://huggingface.co>.
+
+    Example:
+    ```py
+    >>> RepoUrl('https://huggingface.co/gpt2')
+    RepoUrl('https://huggingface.co/gpt2', endpoint='https://huggingface.co', repo_type='model', repo_id='gpt2')
+
+    >>> RepoUrl('https://hub-ci.huggingface.co/datasets/dummy_user/dummy_dataset', endpoint='https://hub-ci.huggingface.co')
+    RepoUrl('https://hub-ci.huggingface.co/datasets/dummy_user/dummy_dataset', endpoint='https://hub-ci.huggingface.co', repo_type='dataset', repo_id='dummy_user/dummy_dataset')
+
+    >>> RepoUrl('hf://datasets/my-user/my-dataset')
+    RepoUrl('hf://datasets/my-user/my-dataset', endpoint='https://huggingface.co', repo_type='dataset', repo_id='user/dataset')
+
+    >>> HfApi.create_repo("dummy_model")
+    RepoUrl('https://huggingface.co/Wauplin/dummy_model', endpoint='https://huggingface.co', repo_type='model', repo_id='Wauplin/dummy_model')
+    ```
+
+    Raises:
+        - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If URL cannot be parsed.
+        - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If `repo_type` is unknown.
+    """
+
+    def __new__(cls, url: Any, endpoint: Optional[str] = None):
+        url = fix_hf_endpoint_in_url(url, endpoint=endpoint)
+        return super(RepoUrl, cls).__new__(cls, url)
+
+    def __init__(self, url: Any, endpoint: Optional[str] = None) -> None:
+        super().__init__()
+        # Parse URL
+        self.endpoint = endpoint or ENDPOINT
+        repo_type, namespace, repo_name = repo_type_and_id_from_hf_id(self, hub_url=self.endpoint)
+
+        # Populate fields
+        self.namespace = namespace
+        self.repo_name = repo_name
+        self.repo_id = repo_name if namespace is None else f"{namespace}/{repo_name}"
+        self.repo_type = repo_type or REPO_TYPE_MODEL
+        self.url = str(self)  # just in case it's needed
+
+    def __repr__(self) -> str:
+        return f"RepoUrl('{self}', endpoint='{self.endpoint}', repo_type='{self.repo_type}', repo_id='{self.repo_id}')"
+
+
+@dataclass
+class RepoSibling:
+    """
+    Contains basic information about a repo file inside a repo on the Hub.
+
+    <Tip>
+
+    All attributes of this class are optional except `rfilename`. This is because only the file names are returned when
+    listing repositories on the Hub (with [`list_models`], [`list_datasets`] or [`list_spaces`]). If you need more
+    information like file size, blob id or lfs details, you must request them specifically from one repo at a time
+    (using [`model_info`], [`dataset_info`] or [`space_info`]) as it adds more constraints on the backend server to
+    retrieve these.
+
+    </Tip>
+
+    Attributes:
+        rfilename (str):
+            file name, relative to the repo root.
+        size (`int`, *optional*):
+            The file's size, in bytes. This attribute is defined when `files_metadata` argument of [`repo_info`] is set
+            to `True`. It's `None` otherwise.
+        blob_id (`str`, *optional*):
+            The file's git OID. This attribute is defined when `files_metadata` argument of [`repo_info`] is set to
+            `True`. It's `None` otherwise.
+        lfs (`BlobLfsInfo`, *optional*):
+            The file's LFS metadata. This attribute is defined when`files_metadata` argument of [`repo_info`] is set to
+            `True` and the file is stored with Git LFS. It's `None` otherwise.
+    """
+
+    rfilename: str
+    size: Optional[int] = None
+    blob_id: Optional[str] = None
+    lfs: Optional[BlobLfsInfo] = None
+
+
+@dataclass
+class RepoFile:
+    """
+    Contains information about a file on the Hub.
+
+    Attributes:
+        path (str):
+            file path relative to the repo root.
+        size (`int`):
+            The file's size, in bytes.
+        blob_id (`str`):
+            The file's git OID.
+        lfs (`BlobLfsInfo`):
+            The file's LFS metadata.
+        last_commit (`LastCommitInfo`, *optional*):
+            The file's last commit metadata. Only defined if [`list_files_info`], [`list_repo_tree`] and [`get_paths_info`]
+            are called with `expand=True`.
+        security (`BlobSecurityInfo`, *optional*):
+            The file's security scan metadata. Only defined if [`list_files_info`], [`list_repo_tree`] and [`get_paths_info`]
+            are called with `expand=True`.
+    """
+
+    path: str
+    size: int
+    blob_id: str
+    lfs: Optional[BlobLfsInfo] = None
+    last_commit: Optional[LastCommitInfo] = None
+    security: Optional[BlobSecurityInfo] = None
+
+    def __init__(self, **kwargs):
+        self.path = kwargs.pop("path")
+        self.size = kwargs.pop("size")
+        self.blob_id = kwargs.pop("oid")
+        lfs = kwargs.pop("lfs", None)
+        if lfs is not None:
+            lfs = BlobLfsInfo(size=lfs["size"], sha256=lfs["oid"], pointer_size=lfs["pointerSize"])
+        self.lfs = lfs
+        last_commit = kwargs.pop("lastCommit", None) or kwargs.pop("last_commit", None)
+        if last_commit is not None:
+            last_commit = LastCommitInfo(
+                oid=last_commit["id"], title=last_commit["title"], date=parse_datetime(last_commit["date"])
+            )
+        self.last_commit = last_commit
+        security = kwargs.pop("security", None)
+        if security is not None:
+            security = BlobSecurityInfo(
+                safe=security["safe"], av_scan=security["avScan"], pickle_import_scan=security["pickleImportScan"]
+            )
+        self.security = security
+
+        # backwards compatibility
+        self.rfilename = self.path
+        self.lastCommit = self.last_commit
+
+
+@dataclass
+class RepoFolder:
+    """
+    Contains information about a folder on the Hub.
+
+    Attributes:
+        path (str):
+            folder path relative to the repo root.
+        tree_id (`str`):
+            The folder's git OID.
+        last_commit (`LastCommitInfo`, *optional*):
+            The folder's last commit metadata. Only defined if [`list_repo_tree`] and [`get_paths_info`]
+            are called with `expand=True`.
+    """
+
+    path: str
+    tree_id: str
+    last_commit: Optional[LastCommitInfo] = None
+
+    def __init__(self, **kwargs):
+        self.path = kwargs.pop("path")
+        self.tree_id = kwargs.pop("oid")
+        last_commit = kwargs.pop("lastCommit", None) or kwargs.pop("last_commit", None)
+        if last_commit is not None:
+            last_commit = LastCommitInfo(
+                oid=last_commit["id"], title=last_commit["title"], date=parse_datetime(last_commit["date"])
+            )
+        self.last_commit = last_commit
+
+
+@dataclass
+class ModelInfo:
+    """
+    Contains information about a model on the Hub.
+
+    <Tip>
+
+    Most attributes of this class are optional. This is because the data returned by the Hub depends on the query made.
+    In general, the more specific the query, the more information is returned. On the contrary, when listing models
+    using [`list_models`] only a subset of the attributes are returned.
+
+    </Tip>
+
+    Attributes:
+        id (`str`):
+            ID of model.
+        author (`str`, *optional*):
+            Author of the model.
+        sha (`str`, *optional*):
+            Repo SHA at this particular revision.
+        created_at (`datetime`, *optional*):
+            Date of creation of the repo on the Hub. Note that the lowest value is `2022-03-02T23:29:04.000Z`,
+            corresponding to the date when we began to store creation dates.
+        last_modified (`datetime`, *optional*):
+            Date of last commit to the repo.
+        private (`bool`):
+            Is the repo private.
+        disabled (`bool`, *optional*):
+            Is the repo disabled.
+        gated (`Literal["auto", "manual", False]`, *optional*):
+            Is the repo gated.
+            If so, whether there is manual or automatic approval.
+        downloads (`int`):
+            Number of downloads of the model.
+        likes (`int`):
+            Number of likes of the model.
+        library_name (`str`, *optional*):
+            Library associated with the model.
+        tags (`List[str]`):
+            List of tags of the model. Compared to `card_data.tags`, contains extra tags computed by the Hub
+            (e.g. supported libraries, model's arXiv).
+        pipeline_tag (`str`, *optional*):
+            Pipeline tag associated with the model.
+        mask_token (`str`, *optional*):
+            Mask token used by the model.
+        widget_data (`Any`, *optional*):
+            Widget data associated with the model.
+        model_index (`Dict`, *optional*):
+            Model index for evaluation.
+        config (`Dict`, *optional*):
+            Model configuration.
+        transformers_info (`TransformersInfo`, *optional*):
+            Transformers-specific info (auto class, processor, etc.) associated with the model.
+        card_data (`ModelCardData`, *optional*):
+            Model Card Metadata  as a [`huggingface_hub.repocard_data.ModelCardData`] object.
+        siblings (`List[RepoSibling]`):
+            List of [`huggingface_hub.hf_api.RepoSibling`] objects that constitute the model.
+        spaces (`List[str]`, *optional*):
+            List of spaces using the model.
+        safetensors (`SafeTensorsInfo`, *optional*):
+            Model's safetensors information.
+    """
+
+    id: str
+    author: Optional[str]
+    sha: Optional[str]
+    created_at: Optional[datetime]
+    last_modified: Optional[datetime]
+    private: bool
+    gated: Optional[Literal["auto", "manual", False]]
+    disabled: Optional[bool]
+    downloads: int
+    likes: int
+    library_name: Optional[str]
+    tags: List[str]
+    pipeline_tag: Optional[str]
+    mask_token: Optional[str]
+    card_data: Optional[ModelCardData]
+    widget_data: Optional[Any]
+    model_index: Optional[Dict]
+    config: Optional[Dict]
+    transformers_info: Optional[TransformersInfo]
+    siblings: Optional[List[RepoSibling]]
+    spaces: Optional[List[str]]
+    safetensors: Optional[SafeTensorsInfo]
+
+    def __init__(self, **kwargs):
+        self.id = kwargs.pop("id")
+        self.author = kwargs.pop("author", None)
+        self.sha = kwargs.pop("sha", None)
+        last_modified = kwargs.pop("lastModified", None) or kwargs.pop("last_modified", None)
+        self.last_modified = parse_datetime(last_modified) if last_modified else None
+        created_at = kwargs.pop("createdAt", None) or kwargs.pop("created_at", None)
+        self.created_at = parse_datetime(created_at) if created_at else None
+        self.private = kwargs.pop("private")
+        self.gated = kwargs.pop("gated", None)
+        self.disabled = kwargs.pop("disabled", None)
+        self.downloads = kwargs.pop("downloads")
+        self.likes = kwargs.pop("likes")
+        self.library_name = kwargs.pop("library_name", None)
+        self.tags = kwargs.pop("tags")
+        self.pipeline_tag = kwargs.pop("pipeline_tag", None)
+        self.mask_token = kwargs.pop("mask_token", None)
+        card_data = kwargs.pop("cardData", None) or kwargs.pop("card_data", None)
+        self.card_data = (
+            ModelCardData(**card_data, ignore_metadata_errors=True) if isinstance(card_data, dict) else card_data
+        )
+
+        self.widget_data = kwargs.pop("widgetData", None)
+        self.model_index = kwargs.pop("model-index", None) or kwargs.pop("model_index", None)
+        self.config = kwargs.pop("config", None)
+        transformers_info = kwargs.pop("transformersInfo", None) or kwargs.pop("transformers_info", None)
+        self.transformers_info = TransformersInfo(**transformers_info) if transformers_info else None
+        siblings = kwargs.pop("siblings", None)
+        self.siblings = (
+            [
+                RepoSibling(
+                    rfilename=sibling["rfilename"],
+                    size=sibling.get("size"),
+                    blob_id=sibling.get("blobId"),
+                    lfs=(
+                        BlobLfsInfo(
+                            size=sibling["lfs"]["size"],
+                            sha256=sibling["lfs"]["sha256"],
+                            pointer_size=sibling["lfs"]["pointerSize"],
+                        )
+                        if sibling.get("lfs")
+                        else None
+                    ),
+                )
+                for sibling in siblings
+            ]
+            if siblings
+            else None
+        )
+        self.spaces = kwargs.pop("spaces", None)
+        safetensors = kwargs.pop("safetensors", None)
+        self.safetensors = SafeTensorsInfo(**safetensors) if safetensors else None
+
+        # backwards compatibility
+        self.lastModified = self.last_modified
+        self.cardData = self.card_data
+        self.transformersInfo = self.transformers_info
+        self.__dict__.update(**kwargs)
+
+
+@dataclass
+class DatasetInfo:
+    """
+    Contains information about a dataset on the Hub.
+
+    <Tip>
+
+    Most attributes of this class are optional. This is because the data returned by the Hub depends on the query made.
+    In general, the more specific the query, the more information is returned. On the contrary, when listing datasets
+    using [`list_datasets`] only a subset of the attributes are returned.
+
+    </Tip>
+
+    Attributes:
+        id (`str`):
+            ID of dataset.
+        author (`str`):
+            Author of the dataset.
+        sha (`str`):
+            Repo SHA at this particular revision.
+        created_at (`datetime`, *optional*):
+            Date of creation of the repo on the Hub. Note that the lowest value is `2022-03-02T23:29:04.000Z`,
+            corresponding to the date when we began to store creation dates.
+        last_modified (`datetime`, *optional*):
+            Date of last commit to the repo.
+        private (`bool`):
+            Is the repo private.
+        disabled (`bool`, *optional*):
+            Is the repo disabled.
+        gated (`Literal["auto", "manual", False]`, *optional*):
+            Is the repo gated.
+            If so, whether there is manual or automatic approval.
+        downloads (`int`):
+            Number of downloads of the dataset.
+        likes (`int`):
+            Number of likes of the dataset.
+        tags (`List[str]`):
+            List of tags of the dataset.
+        card_data (`DatasetCardData`, *optional*):
+            Model Card Metadata  as a [`huggingface_hub.repocard_data.DatasetCardData`] object.
+        siblings (`List[RepoSibling]`):
+            List of [`huggingface_hub.hf_api.RepoSibling`] objects that constitute the dataset.
+    """
+
+    id: str
+    author: Optional[str]
+    sha: Optional[str]
+    created_at: Optional[datetime]
+    last_modified: Optional[datetime]
+    private: bool
+    gated: Optional[Literal["auto", "manual", False]]
+    disabled: Optional[bool]
+    downloads: int
+    likes: int
+    paperswithcode_id: Optional[str]
+    tags: List[str]
+    card_data: Optional[DatasetCardData]
+    siblings: Optional[List[RepoSibling]]
+
+    def __init__(self, **kwargs):
+        self.id = kwargs.pop("id")
+        self.author = kwargs.pop("author", None)
+        self.sha = kwargs.pop("sha", None)
+        created_at = kwargs.pop("createdAt", None) or kwargs.pop("created_at", None)
+        self.created_at = parse_datetime(created_at) if created_at else None
+        last_modified = kwargs.pop("lastModified", None) or kwargs.pop("last_modified", None)
+        self.last_modified = parse_datetime(last_modified) if last_modified else None
+        self.private = kwargs.pop("private")
+        self.gated = kwargs.pop("gated", None)
+        self.disabled = kwargs.pop("disabled", None)
+        self.downloads = kwargs.pop("downloads")
+        self.likes = kwargs.pop("likes")
+        self.paperswithcode_id = kwargs.pop("paperswithcode_id", None)
+        self.tags = kwargs.pop("tags")
+        card_data = kwargs.pop("cardData", None) or kwargs.pop("card_data", None)
+        self.card_data = (
+            DatasetCardData(**card_data, ignore_metadata_errors=True) if isinstance(card_data, dict) else card_data
+        )
+        siblings = kwargs.pop("siblings", None)
+        self.siblings = (
+            [
+                RepoSibling(
+                    rfilename=sibling["rfilename"],
+                    size=sibling.get("size"),
+                    blob_id=sibling.get("blobId"),
+                    lfs=(
+                        BlobLfsInfo(
+                            size=sibling["lfs"]["size"],
+                            sha256=sibling["lfs"]["sha256"],
+                            pointer_size=sibling["lfs"]["pointerSize"],
+                        )
+                        if sibling.get("lfs")
+                        else None
+                    ),
+                )
+                for sibling in siblings
+            ]
+            if siblings
+            else None
+        )
+
+        # backwards compatibility
+        self.lastModified = self.last_modified
+        self.cardData = self.card_data
+        self.__dict__.update(**kwargs)
+
+
+@dataclass
+class SpaceInfo:
+    """
+    Contains information about a Space on the Hub.
+
+    <Tip>
+
+    Most attributes of this class are optional. This is because the data returned by the Hub depends on the query made.
+    In general, the more specific the query, the more information is returned. On the contrary, when listing spaces
+    using [`list_spaces`] only a subset of the attributes are returned.
+
+    </Tip>
+
+    Attributes:
+        id (`str`):
+            ID of the Space.
+        author (`str`, *optional*):
+            Author of the Space.
+        sha (`str`, *optional*):
+            Repo SHA at this particular revision.
+        created_at (`datetime`, *optional*):
+            Date of creation of the repo on the Hub. Note that the lowest value is `2022-03-02T23:29:04.000Z`,
+            corresponding to the date when we began to store creation dates.
+        last_modified (`datetime`, *optional*):
+            Date of last commit to the repo.
+        private (`bool`):
+            Is the repo private.
+        gated (`Literal["auto", "manual", False]`, *optional*):
+            Is the repo gated.
+            If so, whether there is manual or automatic approval.
+        disabled (`bool`, *optional*):
+            Is the Space disabled.
+        host (`str`, *optional*):
+            Host URL of the Space.
+        subdomain (`str`, *optional*):
+            Subdomain of the Space.
+        likes (`int`):
+            Number of likes of the Space.
+        tags (`List[str]`):
+            List of tags of the Space.
+        siblings (`List[RepoSibling]`):
+            List of [`huggingface_hub.hf_api.RepoSibling`] objects that constitute the Space.
+        card_data (`SpaceCardData`, *optional*):
+            Space Card Metadata  as a [`huggingface_hub.repocard_data.SpaceCardData`] object.
+        runtime (`SpaceRuntime`, *optional*):
+            Space runtime information as a [`huggingface_hub.hf_api.SpaceRuntime`] object.
+        sdk (`str`, *optional*):
+            SDK used by the Space.
+        models (`List[str]`, *optional*):
+            List of models used by the Space.
+        datasets (`List[str]`, *optional*):
+            List of datasets used by the Space.
+    """
+
+    id: str
+    author: Optional[str]
+    sha: Optional[str]
+    created_at: Optional[datetime]
+    last_modified: Optional[datetime]
+    private: bool
+    gated: Optional[Literal["auto", "manual", False]]
+    disabled: Optional[bool]
+    host: Optional[str]
+    subdomain: Optional[str]
+    likes: int
+    sdk: Optional[str]
+    tags: List[str]
+    siblings: Optional[List[RepoSibling]]
+    card_data: Optional[SpaceCardData]
+    runtime: Optional[SpaceRuntime]
+    models: Optional[List[str]]
+    datasets: Optional[List[str]]
+
+    def __init__(self, **kwargs):
+        self.id = kwargs.pop("id")
+        self.author = kwargs.pop("author", None)
+        self.sha = kwargs.pop("sha", None)
+        created_at = kwargs.pop("createdAt", None) or kwargs.pop("created_at", None)
+        self.created_at = parse_datetime(created_at) if created_at else None
+        last_modified = kwargs.pop("lastModified", None) or kwargs.pop("last_modified", None)
+        self.last_modified = parse_datetime(last_modified) if last_modified else None
+        self.private = kwargs.pop("private")
+        self.gated = kwargs.pop("gated", None)
+        self.disabled = kwargs.pop("disabled", None)
+        self.host = kwargs.pop("host", None)
+        self.subdomain = kwargs.pop("subdomain", None)
+        self.likes = kwargs.pop("likes")
+        self.sdk = kwargs.pop("sdk", None)
+        self.tags = kwargs.pop("tags")
+        card_data = kwargs.pop("cardData", None) or kwargs.pop("card_data", None)
+        self.card_data = (
+            SpaceCardData(**card_data, ignore_metadata_errors=True) if isinstance(card_data, dict) else card_data
+        )
+        siblings = kwargs.pop("siblings", None)
+        self.siblings = (
+            [
+                RepoSibling(
+                    rfilename=sibling["rfilename"],
+                    size=sibling.get("size"),
+                    blob_id=sibling.get("blobId"),
+                    lfs=(
+                        BlobLfsInfo(
+                            size=sibling["lfs"]["size"],
+                            sha256=sibling["lfs"]["sha256"],
+                            pointer_size=sibling["lfs"]["pointerSize"],
+                        )
+                        if sibling.get("lfs")
+                        else None
+                    ),
+                )
+                for sibling in siblings
+            ]
+            if siblings
+            else None
+        )
+        runtime = kwargs.pop("runtime", None)
+        self.runtime = SpaceRuntime(runtime) if runtime else None
+        self.models = kwargs.pop("models", None)
+        self.datasets = kwargs.pop("datasets", None)
+
+        # backwards compatibility
+        self.lastModified = self.last_modified
+        self.cardData = self.card_data
+        self.__dict__.update(**kwargs)
+
+
+@dataclass
+class MetricInfo:
+    """
+    Contains information about a metric on the Hub.
+
+    Attributes:
+        id (`str`):
+            ID of the metric. E.g. `"accuracy"`.
+        space_id (`str`):
+            ID of the space associated with the metric. E.g. `"Accuracy"`.
+        description (`str`):
+            Description of the metric.
+    """
+
+    id: str
+    space_id: str
+    description: Optional[str]
+
+    def __init__(self, **kwargs):
+        self.id = kwargs.pop("id")
+        self.space_id = kwargs.pop("spaceId")
+        self.description = kwargs.pop("description", None)
+        # backwards compatibility
+        self.spaceId = self.space_id
+        self.__dict__.update(**kwargs)
+
+
+@dataclass
+class CollectionItem:
+    """
+    Contains information about an item of a Collection (model, dataset, Space or paper).
+
+    Attributes:
+        item_object_id (`str`):
+            Unique ID of the item in the collection.
+        item_id (`str`):
+            ID of the underlying object on the Hub. Can be either a repo_id or a paper id
+            e.g. `"jbilcke-hf/ai-comic-factory"`, `"2307.09288"`.
+        item_type (`str`):
+            Type of the underlying object. Can be one of `"model"`, `"dataset"`, `"space"` or `"paper"`.
+        position (`int`):
+            Position of the item in the collection.
+        note (`str`, *optional*):
+            Note associated with the item, as plain text.
+    """
+
+    item_object_id: str  # id in database
+    item_id: str  # repo_id or paper id
+    item_type: str
+    position: int
+    note: Optional[str] = None
+
+    def __init__(
+        self, _id: str, id: str, type: CollectionItemType_T, position: int, note: Optional[Dict] = None, **kwargs
+    ) -> None:
+        self.item_object_id: str = _id  # id in database
+        self.item_id: str = id  # repo_id or paper id
+        self.item_type: CollectionItemType_T = type
+        self.position: int = position
+        self.note: str = note["text"] if note is not None else None
+
+
+@dataclass
+class Collection:
+    """
+    Contains information about a Collection on the Hub.
+
+    Attributes:
+        slug (`str`):
+            Slug of the collection. E.g. `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.
+        title (`str`):
+            Title of the collection. E.g. `"Recent models"`.
+        owner (`str`):
+            Owner of the collection. E.g. `"TheBloke"`.
+        items (`List[CollectionItem]`):
+            List of items in the collection.
+        last_updated (`datetime`):
+            Date of the last update of the collection.
+        position (`int`):
+            Position of the collection in the list of collections of the owner.
+        private (`bool`):
+            Whether the collection is private or not.
+        theme (`str`):
+            Theme of the collection. E.g. `"green"`.
+        upvotes (`int`):
+            Number of upvotes of the collection.
+        description (`str`, *optional*):
+            Description of the collection, as plain text.
+        url (`str`):
+            (property) URL of the collection on the Hub.
+    """
+
+    slug: str
+    title: str
+    owner: str
+    items: List[CollectionItem]
+    last_updated: datetime
+    position: int
+    private: bool
+    theme: str
+    upvotes: int
+    description: Optional[str] = None
+
+    def __init__(self, **kwargs) -> None:
+        self.slug = kwargs.pop("slug")
+        self.title = kwargs.pop("title")
+        self.owner = kwargs.pop("owner")
+        self.items = [CollectionItem(**item) for item in kwargs.pop("items")]
+        self.last_updated = parse_datetime(kwargs.pop("lastUpdated"))
+        self.position = kwargs.pop("position")
+        self.private = kwargs.pop("private")
+        self.theme = kwargs.pop("theme")
+        self.upvotes = kwargs.pop("upvotes")
+        self.description = kwargs.pop("description", None)
+        endpoint = kwargs.pop("endpoint", None)
+        if endpoint is None:
+            endpoint = ENDPOINT
+        self._url = f"{endpoint}/collections/{self.slug}"
+
+    @property
+    def url(self) -> str:
+        """Returns the URL of the collection on the Hub."""
+        return self._url
+
+
+@dataclass
+class GitRefInfo:
+    """
+    Contains information about a git reference for a repo on the Hub.
+
+    Attributes:
+        name (`str`):
+            Name of the reference (e.g. tag name or branch name).
+        ref (`str`):
+            Full git ref on the Hub (e.g. `"refs/heads/main"` or `"refs/tags/v1.0"`).
+        target_commit (`str`):
+            OID of the target commit for the ref (e.g. `"e7da7f221d5bf496a48136c0cd264e630fe9fcc8"`)
+    """
+
+    name: str
+    ref: str
+    target_commit: str
+
+
+@dataclass
+class GitRefs:
+    """
+    Contains information about all git references for a repo on the Hub.
+
+    Object is returned by [`list_repo_refs`].
+
+    Attributes:
+        branches (`List[GitRefInfo]`):
+            A list of [`GitRefInfo`] containing information about branches on the repo.
+        converts (`List[GitRefInfo]`):
+            A list of [`GitRefInfo`] containing information about "convert" refs on the repo.
+            Converts are refs used (internally) to push preprocessed data in Dataset repos.
+        tags (`List[GitRefInfo]`):
+            A list of [`GitRefInfo`] containing information about tags on the repo.
+        pull_requests (`List[GitRefInfo]`, *optional*):
+            A list of [`GitRefInfo`] containing information about pull requests on the repo.
+            Only returned if `include_prs=True` is set.
+    """
+
+    branches: List[GitRefInfo]
+    converts: List[GitRefInfo]
+    tags: List[GitRefInfo]
+    pull_requests: Optional[List[GitRefInfo]] = None
+
+
+@dataclass
+class GitCommitInfo:
+    """
+    Contains information about a git commit for a repo on the Hub. Check out [`list_repo_commits`] for more details.
+
+    Attributes:
+        commit_id (`str`):
+            OID of the commit (e.g. `"e7da7f221d5bf496a48136c0cd264e630fe9fcc8"`)
+        authors (`List[str]`):
+            List of authors of the commit.
+        created_at (`datetime`):
+            Datetime when the commit was created.
+        title (`str`):
+            Title of the commit. This is a free-text value entered by the authors.
+        message (`str`):
+            Description of the commit. This is a free-text value entered by the authors.
+        formatted_title (`str`):
+            Title of the commit formatted as HTML. Only returned if `formatted=True` is set.
+        formatted_message (`str`):
+            Description of the commit formatted as HTML. Only returned if `formatted=True` is set.
+    """
+
+    commit_id: str
+
+    authors: List[str]
+    created_at: datetime
+    title: str
+    message: str
+
+    formatted_title: Optional[str]
+    formatted_message: Optional[str]
+
+
+@dataclass
+class UserLikes:
+    """
+    Contains information about a user likes on the Hub.
+
+    Attributes:
+        user (`str`):
+            Name of the user for which we fetched the likes.
+        total (`int`):
+            Total number of likes.
+        datasets (`List[str]`):
+            List of datasets liked by the user (as repo_ids).
+        models (`List[str]`):
+            List of models liked by the user (as repo_ids).
+        spaces (`List[str]`):
+            List of spaces liked by the user (as repo_ids).
+    """
+
+    # Metadata
+    user: str
+    total: int
+
+    # User likes
+    datasets: List[str]
+    models: List[str]
+    spaces: List[str]
+
+
+@dataclass
+class User:
+    """
+    Contains information about a user on the Hub.
+
+    Attributes:
+        avatar_url (`str`):
+            URL of the user's avatar.
+        username (`str`):
+            Name of the user on the Hub (unique).
+        fullname (`str`):
+            User's full name.
+    """
+
+    # Metadata
+    avatar_url: str
+    username: str
+    fullname: str
+
+
+def future_compatible(fn: CallableT) -> CallableT:
+    """Wrap a method of `HfApi` to handle `run_as_future=True`.
+
+    A method flagged as "future_compatible" will be called in a thread if `run_as_future=True` and return a
+    `concurrent.futures.Future` instance. Otherwise, it will be called normally and return the result.
+    """
+    sig = inspect.signature(fn)
+    args_params = list(sig.parameters)[1:]  # remove "self" from list
+
+    @wraps(fn)
+    def _inner(self, *args, **kwargs):
+        # Get `run_as_future` value if provided (default to False)
+        if "run_as_future" in kwargs:
+            run_as_future = kwargs["run_as_future"]
+            kwargs["run_as_future"] = False  # avoid recursion error
+        else:
+            run_as_future = False
+            for param, value in zip(args_params, args):
+                if param == "run_as_future":
+                    run_as_future = value
+                    break
+
+        # Call the function in a thread if `run_as_future=True`
+        if run_as_future:
+            return self.run_as_future(fn, self, *args, **kwargs)
+
+        # Otherwise, call the function normally
+        return fn(self, *args, **kwargs)
+
+    _inner.is_future_compatible = True  # type: ignore
+    return _inner  # type: ignore
+
+
+class HfApi:
+    def __init__(
+        self,
+        endpoint: Optional[str] = None,
+        token: Union[str, bool, None] = None,
+        library_name: Optional[str] = None,
+        library_version: Optional[str] = None,
+        user_agent: Union[Dict, str, None] = None,
+        headers: Optional[Dict[str, str]] = None,
+    ) -> None:
+        """Create a HF client to interact with the Hub via HTTP.
+
+        The client is initialized with some high-level settings used in all requests
+        made to the Hub (HF endpoint, authentication, user agents...). Using the `HfApi`
+        client is preferred but not mandatory as all of its public methods are exposed
+        directly at the root of `huggingface_hub`.
+
+        Args:
+            token (`str` or `bool`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+                Pass `token=False` if you don't want to send your token to the server.
+            library_name (`str`, *optional*):
+                The name of the library that is making the HTTP request. Will be added to
+                the user-agent header. Example: `"transformers"`.
+            library_version (`str`, *optional*):
+                The version of the library that is making the HTTP request. Will be added
+                to the user-agent header. Example: `"4.24.0"`.
+            user_agent (`str`, `dict`, *optional*):
+                The user agent info in the form of a dictionary or a single string. It will
+                be completed with information about the installed packages.
+            headers (`dict`, *optional*):
+                Additional headers to be sent with each request. Example: `{"X-My-Header": "value"}`.
+                Headers passed here are taking precedence over the default headers.
+        """
+        self.endpoint = endpoint if endpoint is not None else ENDPOINT
+        self.token = token
+        self.library_name = library_name
+        self.library_version = library_version
+        self.user_agent = user_agent
+        self.headers = headers
+        self._thread_pool: Optional[ThreadPoolExecutor] = None
+
+    def run_as_future(self, fn: Callable[..., R], *args, **kwargs) -> Future[R]:
+        """
+        Run a method in the background and return a Future instance.
+
+        The main goal is to run methods without blocking the main thread (e.g. to push data during a training).
+        Background jobs are queued to preserve order but are not ran in parallel. If you need to speed-up your scripts
+        by parallelizing lots of call to the API, you must setup and use your own [ThreadPoolExecutor](https://docs.python.org/3/library/concurrent.futures.html#threadpoolexecutor).
+
+        Note: Most-used methods like [`upload_file`], [`upload_folder`] and [`create_commit`] have a `run_as_future: bool`
+        argument to directly call them in the background. This is equivalent to calling `api.run_as_future(...)` on them
+        but less verbose.
+
+        Args:
+            fn (`Callable`):
+                The method to run in the background.
+            *args, **kwargs:
+                Arguments with which the method will be called.
+
+        Return:
+            `Future`: a [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects) instance to
+            get the result of the task.
+
+        Example:
+            ```py
+            >>> from huggingface_hub import HfApi
+            >>> api = HfApi()
+            >>> future = api.run_as_future(api.whoami) # instant
+            >>> future.done()
+            False
+            >>> future.result() # wait until complete and return result
+            (...)
+            >>> future.done()
+            True
+            ```
+        """
+        if self._thread_pool is None:
+            self._thread_pool = ThreadPoolExecutor(max_workers=1)
+        self._thread_pool
+        return self._thread_pool.submit(fn, *args, **kwargs)
+
+    @validate_hf_hub_args
+    def whoami(self, token: Optional[str] = None) -> Dict:
+        """
+        Call HF API to know "whoami".
+
+        Args:
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if
+                not provided.
+        """
+        r = get_session().get(
+            f"{self.endpoint}/api/whoami-v2",
+            headers=self._build_hf_headers(
+                # If `token` is provided and not `None`, it will be used by default.
+                # Otherwise, the token must be retrieved from cache or env variable.
+                token=(token or self.token or True),
+            ),
+        )
+        try:
+            hf_raise_for_status(r)
+        except HTTPError as e:
+            raise HTTPError(
+                "Invalid user token. If you didn't pass a user token, make sure you "
+                "are properly logged in by executing `huggingface-cli login`, and "
+                "if you did pass a user token, double-check it's correct.",
+                request=e.request,
+                response=e.response,
+            ) from e
+        return r.json()
+
+    def get_token_permission(self, token: Optional[str] = None) -> Literal["read", "write", None]:
+        """
+        Check if a given `token` is valid and return its permissions.
+
+        For more details about tokens, please refer to https://huggingface.co/docs/hub/security-tokens#what-are-user-access-tokens.
+
+        Args:
+            token (`str`, *optional*):
+                The token to check for validity. Defaults to the one saved locally.
+
+        Returns:
+            `Literal["read", "write", None]`: Permission granted by the token ("read" or "write"). Returns `None` if no
+            token passed or token is invalid.
+        """
+        try:
+            return self.whoami(token=token)["auth"]["accessToken"]["role"]
+        except (LocalTokenNotFoundError, HTTPError):
+            return None
+
+    def get_model_tags(self) -> Dict:
+        """
+        List all valid model tags as a nested namespace object
+        """
+        path = f"{self.endpoint}/api/models-tags-by-type"
+        r = get_session().get(path)
+        hf_raise_for_status(r)
+        return r.json()
+
+    def get_dataset_tags(self) -> Dict:
+        """
+        List all valid dataset tags as a nested namespace object.
+        """
+        path = f"{self.endpoint}/api/datasets-tags-by-type"
+        r = get_session().get(path)
+        hf_raise_for_status(r)
+        return r.json()
+
+    @validate_hf_hub_args
+    def list_models(
+        self,
+        *,
+        filter: Union[ModelFilter, str, Iterable[str], None] = None,
+        author: Optional[str] = None,
+        library: Optional[Union[str, List[str]]] = None,
+        language: Optional[Union[str, List[str]]] = None,
+        model_name: Optional[str] = None,
+        task: Optional[Union[str, List[str]]] = None,
+        trained_dataset: Optional[Union[str, List[str]]] = None,
+        tags: Optional[Union[str, List[str]]] = None,
+        search: Optional[str] = None,
+        emissions_thresholds: Optional[Tuple[float, float]] = None,
+        sort: Union[Literal["last_modified"], str, None] = None,
+        direction: Optional[Literal[-1]] = None,
+        limit: Optional[int] = None,
+        full: Optional[bool] = None,
+        cardData: bool = False,
+        fetch_config: bool = False,
+        token: Optional[Union[bool, str]] = None,
+        pipeline_tag: Optional[str] = None,
+    ) -> Iterable[ModelInfo]:
+        """
+        List models hosted on the Huggingface Hub, given some filters.
+
+        Args:
+            filter ([`ModelFilter`] or `str` or `Iterable`, *optional*):
+                A string or [`ModelFilter`] which can be used to identify models
+                on the Hub.
+            author (`str`, *optional*):
+                A string which identify the author (user or organization) of the
+                returned models
+            library (`str` or `List`, *optional*):
+                A string or list of strings of foundational libraries models were
+                originally trained from, such as pytorch, tensorflow, or allennlp.
+            language (`str` or `List`, *optional*):
+                A string or list of strings of languages, both by name and country
+                code, such as "en" or "English"
+            model_name (`str`, *optional*):
+                A string that contain complete or partial names for models on the
+                Hub, such as "bert" or "bert-base-cased"
+            task (`str` or `List`, *optional*):
+                A string or list of strings of tasks models were designed for, such
+                as: "fill-mask" or "automatic-speech-recognition"
+            trained_dataset (`str` or `List`, *optional*):
+                A string tag or a list of string tags of the trained dataset for a
+                model on the Hub.
+            tags (`str` or `List`, *optional*):
+                A string tag or a list of tags to filter models on the Hub by, such
+                as `text-generation` or `spacy`.
+            search (`str`, *optional*):
+                A string that will be contained in the returned model ids.
+            emissions_thresholds (`Tuple`, *optional*):
+                A tuple of two ints or floats representing a minimum and maximum
+                carbon footprint to filter the resulting models with in grams.
+            sort (`Literal["last_modified"]` or `str`, *optional*):
+                The key with which to sort the resulting models. Possible values
+                are the properties of the [`huggingface_hub.hf_api.ModelInfo`] class.
+            direction (`Literal[-1]` or `int`, *optional*):
+                Direction in which to sort. The value `-1` sorts by descending
+                order while all other values sort by ascending order.
+            limit (`int`, *optional*):
+                The limit on the number of models fetched. Leaving this option
+                to `None` fetches all models.
+            full (`bool`, *optional*):
+                Whether to fetch all model data, including the `last_modified`,
+                the `sha`, the files and the `tags`. This is set to `True` by
+                default when using a filter.
+            cardData (`bool`, *optional*):
+                Whether to grab the metadata for the model as well. Can contain
+                useful information such as carbon emissions, metrics, and
+                datasets trained on.
+            fetch_config (`bool`, *optional*):
+                Whether to fetch the model configs as well. This is not included
+                in `full` due to its size.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+            pipeline_tag (`str`, *optional*):
+                A string pipeline tag to filter models on the Hub by, such as `summarization`
+
+
+        Returns:
+            `Iterable[ModelInfo]`: an iterable of [`huggingface_hub.hf_api.ModelInfo`] objects.
+
+        Example usage with the `filter` argument:
+
+        ```python
+        >>> from huggingface_hub import HfApi
+
+        >>> api = HfApi()
+
+        >>> # List all models
+        >>> api.list_models()
+
+        >>> # List only the text classification models
+        >>> api.list_models(filter="text-classification")
+
+        >>> # List only models from the AllenNLP library
+        >>> api.list_models(filter="allennlp")
+        ```
+
+        Example usage with the `search` argument:
+
+        ```python
+        >>> from huggingface_hub import HfApi
+
+        >>> api = HfApi()
+
+        >>> # List all models with "bert" in their name
+        >>> api.list_models(search="bert")
+
+        >>> # List all models with "bert" in their name made by google
+        >>> api.list_models(search="bert", author="google")
+        ```
+        """
+        if emissions_thresholds is not None and cardData is None:
+            raise ValueError("`emissions_thresholds` were passed without setting `cardData=True`.")
+
+        path = f"{self.endpoint}/api/models"
+        headers = self._build_hf_headers(token=token)
+        params = {}
+        filter_list = []
+
+        if filter is not None:
+            if isinstance(filter, ModelFilter):
+                params = self._unpack_model_filter(filter)
+            else:
+                params.update({"filter": filter})
+
+            params.update({"full": True})
+
+        # Build the filter list
+        if author:
+            params.update({"author": author})
+        if model_name:
+            params.update({"search": model_name})
+        if library:
+            filter_list.extend([library] if isinstance(library, str) else library)
+        if task:
+            filter_list.extend([task] if isinstance(task, str) else task)
+        if trained_dataset:
+            if not isinstance(trained_dataset, (list, tuple)):
+                trained_dataset = [trained_dataset]
+            for dataset in trained_dataset:
+                if not dataset.startswith("dataset:"):
+                    dataset = f"dataset:{dataset}"
+                filter_list.append(dataset)
+        if language:
+            filter_list.extend([language] if isinstance(language, str) else language)
+        if tags:
+            filter_list.extend([tags] if isinstance(tags, str) else tags)
+
+        if search:
+            params.update({"search": search})
+        if sort is not None:
+            params.update({"sort": "lastModified" if sort == "last_modified" else sort})
+        if direction is not None:
+            params.update({"direction": direction})
+        if limit is not None:
+            params.update({"limit": limit})
+        if full is not None:
+            if full:
+                params.update({"full": True})
+            elif "full" in params:
+                del params["full"]
+        if fetch_config:
+            params.update({"config": True})
+        if cardData:
+            params.update({"cardData": True})
+        if pipeline_tag:
+            params.update({"pipeline_tag": pipeline_tag})
+
+        filter_value = params.get("filter", [])
+        if filter_value:
+            filter_list.extend([filter_value] if isinstance(filter_value, str) else list(filter_value))
+        params.update({"filter": filter_list})
+
+        # `items` is a generator
+        items = paginate(path, params=params, headers=headers)
+        if limit is not None:
+            items = islice(items, limit)  # Do not iterate over all pages
+        for item in items:
+            if "siblings" not in item:
+                item["siblings"] = None
+            model_info = ModelInfo(**item)
+            if emissions_thresholds is None or _is_emission_within_treshold(model_info, *emissions_thresholds):
+                yield model_info
+
+    def _unpack_model_filter(self, model_filter: ModelFilter):
+        """
+        Unpacks a [`ModelFilter`] into something readable for `list_models`
+        """
+        model_str = ""
+
+        # Handling author
+        if model_filter.author:
+            model_str = f"{model_filter.author}/"
+
+        # Handling model_name
+        if model_filter.model_name:
+            model_str += model_filter.model_name
+
+        filter_list: List[str] = []
+
+        # Handling tasks
+        if model_filter.task:
+            filter_list.extend([model_filter.task] if isinstance(model_filter.task, str) else model_filter.task)
+
+        # Handling dataset
+        if model_filter.trained_dataset:
+            if not isinstance(model_filter.trained_dataset, (list, tuple)):
+                model_filter.trained_dataset = [model_filter.trained_dataset]
+            for dataset in model_filter.trained_dataset:
+                if "dataset:" not in dataset:
+                    dataset = f"dataset:{dataset}"
+                filter_list.append(dataset)
+
+        # Handling library
+        if model_filter.library:
+            filter_list.extend(
+                [model_filter.library] if isinstance(model_filter.library, str) else model_filter.library
+            )
+
+        # Handling tags
+        if model_filter.tags:
+            filter_list.extend([model_filter.tags] if isinstance(model_filter.tags, str) else model_filter.tags)
+
+        query_dict: Dict[str, Any] = {}
+        if model_str:
+            query_dict["search"] = model_str
+        if isinstance(model_filter.language, list):
+            filter_list.extend(model_filter.language)
+        elif isinstance(model_filter.language, str):
+            filter_list.append(model_filter.language)
+        query_dict["filter"] = tuple(filter_list)
+        return query_dict
+
+    @validate_hf_hub_args
+    def list_datasets(
+        self,
+        *,
+        filter: Union[DatasetFilter, str, Iterable[str], None] = None,
+        author: Optional[str] = None,
+        benchmark: Optional[Union[str, List[str]]] = None,
+        dataset_name: Optional[str] = None,
+        language_creators: Optional[Union[str, List[str]]] = None,
+        language: Optional[Union[str, List[str]]] = None,
+        multilinguality: Optional[Union[str, List[str]]] = None,
+        size_categories: Optional[Union[str, List[str]]] = None,
+        task_categories: Optional[Union[str, List[str]]] = None,
+        task_ids: Optional[Union[str, List[str]]] = None,
+        search: Optional[str] = None,
+        sort: Optional[Union[Literal["last_modified"], str]] = None,
+        direction: Optional[Literal[-1]] = None,
+        limit: Optional[int] = None,
+        full: Optional[bool] = None,
+        token: Optional[str] = None,
+    ) -> Iterable[DatasetInfo]:
+        """
+        List datasets hosted on the Huggingface Hub, given some filters.
+
+        Args:
+            filter ([`DatasetFilter`] or `str` or `Iterable`, *optional*):
+                A string or [`DatasetFilter`] which can be used to identify
+                datasets on the hub.
+            author (`str`, *optional*):
+                A string which identify the author of the returned datasets.
+            benchmark (`str` or `List`, *optional*):
+                A string or list of strings that can be used to identify datasets on
+                the Hub by their official benchmark.
+            dataset_name (`str`, *optional*):
+                A string or list of strings that can be used to identify datasets on
+                the Hub by its name, such as `SQAC` or `wikineural`
+            language_creators (`str` or `List`, *optional*):
+                A string or list of strings that can be used to identify datasets on
+                the Hub with how the data was curated, such as `crowdsourced` or
+                `machine_generated`.
+            language (`str` or `List`, *optional*):
+                A string or list of strings representing a two-character language to
+                filter datasets by on the Hub.
+            multilinguality (`str` or `List`, *optional*):
+                A string or list of strings representing a filter for datasets that
+                contain multiple languages.
+            size_categories (`str` or `List`, *optional*):
+                A string or list of strings that can be used to identify datasets on
+                the Hub by the size of the dataset such as `100K<n<1M` or
+                `1M<n<10M`.
+            task_categories (`str` or `List`, *optional*):
+                A string or list of strings that can be used to identify datasets on
+                the Hub by the designed task, such as `audio_classification` or
+                `named_entity_recognition`.
+            task_ids (`str` or `List`, *optional*):
+                A string or list of strings that can be used to identify datasets on
+                the Hub by the specific task such as `speech_emotion_recognition` or
+                `paraphrase`.
+            search (`str`, *optional*):
+                A string that will be contained in the returned datasets.
+            sort (`Literal["last_modified"]` or `str`, *optional*):
+                The key with which to sort the resulting datasets. Possible
+                values are the properties of the [`huggingface_hub.hf_api.DatasetInfo`] class.
+            direction (`Literal[-1]` or `int`, *optional*):
+                Direction in which to sort. The value `-1` sorts by descending
+                order while all other values sort by ascending order.
+            limit (`int`, *optional*):
+                The limit on the number of datasets fetched. Leaving this option
+                to `None` fetches all datasets.
+            full (`bool`, *optional*):
+                Whether to fetch all dataset data, including the `last_modified`,
+                the `card_data` and  the files. Can contain useful information such as the
+                PapersWithCode ID.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+
+        Returns:
+            `Iterable[DatasetInfo]`: an iterable of [`huggingface_hub.hf_api.DatasetInfo`] objects.
+
+        Example usage with the `filter` argument:
+
+        ```python
+        >>> from huggingface_hub import HfApi
+
+        >>> api = HfApi()
+
+        >>> # List all datasets
+        >>> api.list_datasets()
+
+
+        >>> # List only the text classification datasets
+        >>> api.list_datasets(filter="task_categories:text-classification")
+
+
+        >>> # List only the datasets in russian for language modeling
+        >>> api.list_datasets(
+        ...     filter=("language:ru", "task_ids:language-modeling")
+        ... )
+
+        >>> api.list_datasets(filter=filt)
+        ```
+
+        Example usage with the `search` argument:
+
+        ```python
+        >>> from huggingface_hub import HfApi
+
+        >>> api = HfApi()
+
+        >>> # List all datasets with "text" in their name
+        >>> api.list_datasets(search="text")
+
+        >>> # List all datasets with "text" in their name made by google
+        >>> api.list_datasets(search="text", author="google")
+        ```
+        """
+        path = f"{self.endpoint}/api/datasets"
+        headers = self._build_hf_headers(token=token)
+        params = {}
+        filter_list = []
+
+        if filter is not None:
+            if isinstance(filter, DatasetFilter):
+                params = self._unpack_dataset_filter(filter)
+            else:
+                params.update({"filter": filter})
+
+        # Build the filter list
+        if author:
+            params.update({"author": author})
+        if dataset_name:
+            params.update({"search": dataset_name})
+
+        for attr in (
+            benchmark,
+            language_creators,
+            language,
+            multilinguality,
+            size_categories,
+            task_categories,
+            task_ids,
+        ):
+            if attr:
+                if not isinstance(attr, (list, tuple)):
+                    attr = [attr]
+                for data in attr:
+                    if not data.startswith(f"{attr}:"):
+                        data = f"{attr}:{data}"
+                    filter_list.append(data)
+
+        if search:
+            params.update({"search": search})
+        if sort is not None:
+            params.update({"sort": "lastModified" if sort == "last_modified" else sort})
+        if direction is not None:
+            params.update({"direction": direction})
+        if limit is not None:
+            params.update({"limit": limit})
+        if full:
+            params.update({"full": True})
+
+        filter_value = params.get("filter", [])
+        if filter_value:
+            filter_list.extend([filter_value] if isinstance(filter_value, str) else list(filter_value))
+        params.update({"filter": filter_list})
+
+        items = paginate(path, params=params, headers=headers)
+        if limit is not None:
+            items = islice(items, limit)  # Do not iterate over all pages
+        for item in items:
+            if "siblings" not in item:
+                item["siblings"] = None
+            yield DatasetInfo(**item)
+
+    def _unpack_dataset_filter(self, dataset_filter: DatasetFilter):
+        """
+        Unpacks a [`DatasetFilter`] into something readable for `list_datasets`
+        """
+        dataset_str = ""
+
+        # Handling author
+        if dataset_filter.author:
+            dataset_str = f"{dataset_filter.author}/"
+
+        # Handling dataset_name
+        if dataset_filter.dataset_name:
+            dataset_str += dataset_filter.dataset_name
+
+        filter_list = []
+        data_attributes = [
+            "benchmark",
+            "language_creators",
+            "language",
+            "multilinguality",
+            "size_categories",
+            "task_categories",
+            "task_ids",
+        ]
+
+        for attr in data_attributes:
+            curr_attr = getattr(dataset_filter, attr)
+            if curr_attr is not None:
+                if not isinstance(curr_attr, (list, tuple)):
+                    curr_attr = [curr_attr]
+                for data in curr_attr:
+                    if f"{attr}:" not in data:
+                        data = f"{attr}:{data}"
+                    filter_list.append(data)
+
+        query_dict: Dict[str, Any] = {}
+        if dataset_str is not None:
+            query_dict["search"] = dataset_str
+        query_dict["filter"] = tuple(filter_list)
+        return query_dict
+
+    def list_metrics(self) -> List[MetricInfo]:
+        """
+        Get the public list of all the metrics on huggingface.co
+
+        Returns:
+            `List[MetricInfo]`: a list of [`MetricInfo`] objects which.
+        """
+        path = f"{self.endpoint}/api/metrics"
+        r = get_session().get(path)
+        hf_raise_for_status(r)
+        d = r.json()
+        return [MetricInfo(**x) for x in d]
+
+    @validate_hf_hub_args
+    def list_spaces(
+        self,
+        *,
+        filter: Union[str, Iterable[str], None] = None,
+        author: Optional[str] = None,
+        search: Optional[str] = None,
+        sort: Union[Literal["last_modified"], str, None] = None,
+        direction: Optional[Literal[-1]] = None,
+        limit: Optional[int] = None,
+        datasets: Union[str, Iterable[str], None] = None,
+        models: Union[str, Iterable[str], None] = None,
+        linked: bool = False,
+        full: Optional[bool] = None,
+        token: Optional[str] = None,
+    ) -> Iterable[SpaceInfo]:
+        """
+        List spaces hosted on the Huggingface Hub, given some filters.
+
+        Args:
+            filter (`str` or `Iterable`, *optional*):
+                A string tag or list of tags that can be used to identify Spaces on the Hub.
+            author (`str`, *optional*):
+                A string which identify the author of the returned Spaces.
+            search (`str`, *optional*):
+                A string that will be contained in the returned Spaces.
+            sort (`Literal["last_modified"]` or `str`, *optional*):
+                The key with which to sort the resulting Spaces. Possible
+                values are the properties of the [`huggingface_hub.hf_api.SpaceInfo`]` class.
+            direction (`Literal[-1]` or `int`, *optional*):
+                Direction in which to sort. The value `-1` sorts by descending
+                order while all other values sort by ascending order.
+            limit (`int`, *optional*):
+                The limit on the number of Spaces fetched. Leaving this option
+                to `None` fetches all Spaces.
+            datasets (`str` or `Iterable`, *optional*):
+                Whether to return Spaces that make use of a dataset.
+                The name of a specific dataset can be passed as a string.
+            models (`str` or `Iterable`, *optional*):
+                Whether to return Spaces that make use of a model.
+                The name of a specific model can be passed as a string.
+            linked (`bool`, *optional*):
+                Whether to return Spaces that make use of either a model or a dataset.
+            full (`bool`, *optional*):
+                Whether to fetch all Spaces data, including the `last_modified`, `siblings`
+                and `card_data` fields.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+
+        Returns:
+            `Iterable[SpaceInfo]`: an iterable of [`huggingface_hub.hf_api.SpaceInfo`] objects.
+        """
+        path = f"{self.endpoint}/api/spaces"
+        headers = self._build_hf_headers(token=token)
+        params: Dict[str, Any] = {}
+        if filter is not None:
+            params.update({"filter": filter})
+        if author is not None:
+            params.update({"author": author})
+        if search is not None:
+            params.update({"search": search})
+        if sort is not None:
+            params.update({"sort": "lastModified" if sort == "last_modified" else sort})
+        if direction is not None:
+            params.update({"direction": direction})
+        if limit is not None:
+            params.update({"limit": limit})
+        if full:
+            params.update({"full": True})
+        if linked:
+            params.update({"linked": True})
+        if datasets is not None:
+            params.update({"datasets": datasets})
+        if models is not None:
+            params.update({"models": models})
+
+        items = paginate(path, params=params, headers=headers)
+        if limit is not None:
+            items = islice(items, limit)  # Do not iterate over all pages
+        for item in items:
+            if "siblings" not in item:
+                item["siblings"] = None
+            yield SpaceInfo(**item)
+
+    @validate_hf_hub_args
+    def like(
+        self,
+        repo_id: str,
+        *,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+    ) -> None:
+        """
+        Like a given repo on the Hub (e.g. set as favorite).
+
+        See also [`unlike`] and [`list_liked_repos`].
+
+        Args:
+            repo_id (`str`):
+                The repository to like. Example: `"user/my-cool-model"`.
+
+            token (`str`, *optional*):
+                Authentication token. Will default to the stored token.
+
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if liking a dataset or space, `None` or
+                `"model"` if liking a model. Default is `None`.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If repository is not found (error 404): wrong repo_id/repo_type, private
+                but not authenticated or repo does not exist.
+
+        Example:
+        ```python
+        >>> from huggingface_hub import like, list_liked_repos, unlike
+        >>> like("gpt2")
+        >>> "gpt2" in list_liked_repos().models
+        True
+        >>> unlike("gpt2")
+        >>> "gpt2" in list_liked_repos().models
+        False
+        ```
+        """
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+        response = get_session().post(
+            url=f"{self.endpoint}/api/{repo_type}s/{repo_id}/like",
+            headers=self._build_hf_headers(token=token),
+        )
+        hf_raise_for_status(response)
+
+    @validate_hf_hub_args
+    def unlike(
+        self,
+        repo_id: str,
+        *,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+    ) -> None:
+        """
+        Unlike a given repo on the Hub (e.g. remove from favorite list).
+
+        See also [`like`] and [`list_liked_repos`].
+
+        Args:
+            repo_id (`str`):
+                The repository to unlike. Example: `"user/my-cool-model"`.
+
+            token (`str`, *optional*):
+                Authentication token. Will default to the stored token.
+
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if unliking a dataset or space, `None` or
+                `"model"` if unliking a model. Default is `None`.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If repository is not found (error 404): wrong repo_id/repo_type, private
+                but not authenticated or repo does not exist.
+
+        Example:
+        ```python
+        >>> from huggingface_hub import like, list_liked_repos, unlike
+        >>> like("gpt2")
+        >>> "gpt2" in list_liked_repos().models
+        True
+        >>> unlike("gpt2")
+        >>> "gpt2" in list_liked_repos().models
+        False
+        ```
+        """
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+        response = get_session().delete(
+            url=f"{self.endpoint}/api/{repo_type}s/{repo_id}/like", headers=self._build_hf_headers(token=token)
+        )
+        hf_raise_for_status(response)
+
+    @validate_hf_hub_args
+    def list_liked_repos(
+        self,
+        user: Optional[str] = None,
+        *,
+        token: Optional[str] = None,
+    ) -> UserLikes:
+        """
+        List all public repos liked by a user on huggingface.co.
+
+        This list is public so token is optional. If `user` is not passed, it defaults to
+        the logged in user.
+
+        See also [`like`] and [`unlike`].
+
+        Args:
+            user (`str`, *optional*):
+                Name of the user for which you want to fetch the likes.
+            token (`str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                Used only if `user` is not passed to implicitly determine the current
+                user name.
+
+        Returns:
+            [`UserLikes`]: object containing the user name and 3 lists of repo ids (1 for
+            models, 1 for datasets and 1 for Spaces).
+
+        Raises:
+            [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+                If `user` is not passed and no token found (either from argument or from machine).
+
+        Example:
+        ```python
+        >>> from huggingface_hub import list_liked_repos
+
+        >>> likes = list_liked_repos("julien-c")
+
+        >>> likes.user
+        "julien-c"
+
+        >>> likes.models
+        ["osanseviero/streamlit_1.15", "Xhaheen/ChatGPT_HF", ...]
+        ```
+        """
+        # User is either provided explicitly or retrieved from current token.
+        if user is None:
+            me = self.whoami(token=token)
+            if me["type"] == "user":
+                user = me["name"]
+            else:
+                raise ValueError(
+                    "Cannot list liked repos. You must provide a 'user' as input or be logged in as a user."
+                )
+
+        path = f"{self.endpoint}/api/users/{user}/likes"
+        headers = self._build_hf_headers(token=token)
+
+        likes = list(paginate(path, params={}, headers=headers))
+        # Looping over a list of items similar to:
+        #   {
+        #       'createdAt': '2021-09-09T21:53:27.000Z',
+        #       'repo': {
+        #           'name': 'PaddlePaddle/PaddleOCR',
+        #           'type': 'space'
+        #        }
+        #   }
+        # Let's loop 3 times over the received list. Less efficient but more straightforward to read.
+        return UserLikes(
+            user=user,
+            total=len(likes),
+            models=[like["repo"]["name"] for like in likes if like["repo"]["type"] == "model"],
+            datasets=[like["repo"]["name"] for like in likes if like["repo"]["type"] == "dataset"],
+            spaces=[like["repo"]["name"] for like in likes if like["repo"]["type"] == "space"],
+        )
+
+    @validate_hf_hub_args
+    def list_repo_likers(
+        self,
+        repo_id: str,
+        *,
+        repo_type: Optional[str] = None,
+        token: Optional[str] = None,
+    ) -> List[User]:
+        """
+        List all users who liked a given repo on the hugging Face Hub.
+
+        See also [`like`] and [`list_liked_repos`].
+
+        Args:
+            repo_id (`str`):
+                The repository to retrieve . Example: `"user/my-cool-model"`.
+
+            token (`str`, *optional*):
+                Authentication token. Will default to the stored token.
+
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+
+        Returns:
+            `List[User]`: a list of [`User`] objects.
+        """
+
+        # Construct the API endpoint
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+        path = f"{self.endpoint}/api/{repo_type}s/{repo_id}/likers"
+        headers = self._build_hf_headers(token=token)
+
+        # Make the request
+        response = get_session().get(path, headers=headers)
+        hf_raise_for_status(response)
+
+        # Parse the results into User objects
+        likers_data = response.json()
+        return [
+            User(
+                username=user_data["user"],
+                fullname=user_data["fullname"],
+                avatar_url=user_data["avatarUrl"],
+            )
+            for user_data in likers_data
+        ]
+
+    @validate_hf_hub_args
+    def model_info(
+        self,
+        repo_id: str,
+        *,
+        revision: Optional[str] = None,
+        timeout: Optional[float] = None,
+        securityStatus: Optional[bool] = None,
+        files_metadata: bool = False,
+        token: Optional[Union[bool, str]] = None,
+    ) -> ModelInfo:
+        """
+        Get info on one specific model on huggingface.co
+
+        Model can be private if you pass an acceptable token or are logged in.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            revision (`str`, *optional*):
+                The revision of the model repository from which to get the
+                information.
+            timeout (`float`, *optional*):
+                Whether to set a timeout for the request to the Hub.
+            securityStatus (`bool`, *optional*):
+                Whether to retrieve the security status from the model
+                repository as well.
+            files_metadata (`bool`, *optional*):
+                Whether or not to retrieve metadata for files in the repository
+                (size, LFS metadata, etc). Defaults to `False`.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+
+        Returns:
+            [`huggingface_hub.hf_api.ModelInfo`]: The model repository information.
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+            - [`~utils.RevisionNotFoundError`]
+              If the revision to download from cannot be found.
+
+        </Tip>
+        """
+        headers = self._build_hf_headers(token=token)
+        path = (
+            f"{self.endpoint}/api/models/{repo_id}"
+            if revision is None
+            else (f"{self.endpoint}/api/models/{repo_id}/revision/{quote(revision, safe='')}")
+        )
+        params = {}
+        if securityStatus:
+            params["securityStatus"] = True
+        if files_metadata:
+            params["blobs"] = True
+        r = get_session().get(path, headers=headers, timeout=timeout, params=params)
+        hf_raise_for_status(r)
+        data = r.json()
+        return ModelInfo(**data)
+
+    @validate_hf_hub_args
+    def dataset_info(
+        self,
+        repo_id: str,
+        *,
+        revision: Optional[str] = None,
+        timeout: Optional[float] = None,
+        files_metadata: bool = False,
+        token: Optional[Union[bool, str]] = None,
+    ) -> DatasetInfo:
+        """
+        Get info on one specific dataset on huggingface.co.
+
+        Dataset can be private if you pass an acceptable token.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            revision (`str`, *optional*):
+                The revision of the dataset repository from which to get the
+                information.
+            timeout (`float`, *optional*):
+                Whether to set a timeout for the request to the Hub.
+            files_metadata (`bool`, *optional*):
+                Whether or not to retrieve metadata for files in the repository
+                (size, LFS metadata, etc). Defaults to `False`.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+
+        Returns:
+            [`hf_api.DatasetInfo`]: The dataset repository information.
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+            - [`~utils.RevisionNotFoundError`]
+              If the revision to download from cannot be found.
+
+        </Tip>
+        """
+        headers = self._build_hf_headers(token=token)
+        path = (
+            f"{self.endpoint}/api/datasets/{repo_id}"
+            if revision is None
+            else (f"{self.endpoint}/api/datasets/{repo_id}/revision/{quote(revision, safe='')}")
+        )
+        params = {}
+        if files_metadata:
+            params["blobs"] = True
+
+        r = get_session().get(path, headers=headers, timeout=timeout, params=params)
+        hf_raise_for_status(r)
+        data = r.json()
+        return DatasetInfo(**data)
+
+    @validate_hf_hub_args
+    def space_info(
+        self,
+        repo_id: str,
+        *,
+        revision: Optional[str] = None,
+        timeout: Optional[float] = None,
+        files_metadata: bool = False,
+        token: Optional[Union[bool, str]] = None,
+    ) -> SpaceInfo:
+        """
+        Get info on one specific Space on huggingface.co.
+
+        Space can be private if you pass an acceptable token.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            revision (`str`, *optional*):
+                The revision of the space repository from which to get the
+                information.
+            timeout (`float`, *optional*):
+                Whether to set a timeout for the request to the Hub.
+            files_metadata (`bool`, *optional*):
+                Whether or not to retrieve metadata for files in the repository
+                (size, LFS metadata, etc). Defaults to `False`.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+
+        Returns:
+            [`~hf_api.SpaceInfo`]: The space repository information.
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+            - [`~utils.RevisionNotFoundError`]
+              If the revision to download from cannot be found.
+
+        </Tip>
+        """
+        headers = self._build_hf_headers(token=token)
+        path = (
+            f"{self.endpoint}/api/spaces/{repo_id}"
+            if revision is None
+            else (f"{self.endpoint}/api/spaces/{repo_id}/revision/{quote(revision, safe='')}")
+        )
+        params = {}
+        if files_metadata:
+            params["blobs"] = True
+
+        r = get_session().get(path, headers=headers, timeout=timeout, params=params)
+        hf_raise_for_status(r)
+        data = r.json()
+        return SpaceInfo(**data)
+
+    @validate_hf_hub_args
+    def repo_info(
+        self,
+        repo_id: str,
+        *,
+        revision: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        timeout: Optional[float] = None,
+        files_metadata: bool = False,
+        token: Optional[Union[bool, str]] = None,
+    ) -> Union[ModelInfo, DatasetInfo, SpaceInfo]:
+        """
+        Get the info object for a given repo of a given type.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            revision (`str`, *optional*):
+                The revision of the repository from which to get the
+                information.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if getting repository info from a dataset or a space,
+                `None` or `"model"` if getting repository info from a model. Default is `None`.
+            timeout (`float`, *optional*):
+                Whether to set a timeout for the request to the Hub.
+            files_metadata (`bool`, *optional*):
+                Whether or not to retrieve metadata for files in the repository
+                (size, LFS metadata, etc). Defaults to `False`.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+
+        Returns:
+            `Union[SpaceInfo, DatasetInfo, ModelInfo]`: The repository information, as a
+            [`huggingface_hub.hf_api.DatasetInfo`], [`huggingface_hub.hf_api.ModelInfo`]
+            or [`huggingface_hub.hf_api.SpaceInfo`] object.
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+            - [`~utils.RevisionNotFoundError`]
+              If the revision to download from cannot be found.
+
+        </Tip>
+        """
+        if repo_type is None or repo_type == "model":
+            method = self.model_info
+        elif repo_type == "dataset":
+            method = self.dataset_info  # type: ignore
+        elif repo_type == "space":
+            method = self.space_info  # type: ignore
+        else:
+            raise ValueError("Unsupported repo type.")
+        return method(
+            repo_id,
+            revision=revision,
+            token=token,
+            timeout=timeout,
+            files_metadata=files_metadata,
+        )
+
+    @validate_hf_hub_args
+    def repo_exists(
+        self,
+        repo_id: str,
+        *,
+        repo_type: Optional[str] = None,
+        token: Optional[str] = None,
+    ) -> bool:
+        """
+        Checks if a repository exists on the Hugging Face Hub.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if getting repository info from a dataset or a space,
+                `None` or `"model"` if getting repository info from a model. Default is `None`.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+
+        Returns:
+            True if the repository exists, False otherwise.
+
+        Examples:
+            ```py
+            >>> from huggingface_hub import repo_exists
+            >>> repo_exists("google/gemma-7b")
+            True
+            >>> repo_exists("google/not-a-repo")
+            False
+            ```
+        """
+        try:
+            self.repo_info(repo_id=repo_id, repo_type=repo_type, token=token)
+            return True
+        except GatedRepoError:
+            return True  # we don't have access but it exists
+        except RepositoryNotFoundError:
+            return False
+
+    @validate_hf_hub_args
+    def revision_exists(
+        self,
+        repo_id: str,
+        revision: str,
+        *,
+        repo_type: Optional[str] = None,
+        token: Optional[str] = None,
+    ) -> bool:
+        """
+        Checks if a specific revision exists on a repo on the Hugging Face Hub.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            revision (`str`):
+                The revision of the repository to check.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if getting repository info from a dataset or a space,
+                `None` or `"model"` if getting repository info from a model. Default is `None`.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+
+        Returns:
+            True if the repository and the revision exists, False otherwise.
+
+        Examples:
+            ```py
+            >>> from huggingface_hub import revision_exists
+            >>> revision_exists("google/gemma-7b", "float16")
+            True
+            >>> revision_exists("google/gemma-7b", "not-a-revision")
+            False
+            ```
+        """
+        try:
+            self.repo_info(repo_id=repo_id, revision=revision, repo_type=repo_type, token=token)
+            return True
+        except RevisionNotFoundError:
+            return False
+        except RepositoryNotFoundError:
+            return False
+
+    @validate_hf_hub_args
+    def file_exists(
+        self,
+        repo_id: str,
+        filename: str,
+        *,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        token: Union[str, bool, None] = None,
+    ) -> bool:
+        """
+        Checks if a file exists in a repository on the Hugging Face Hub.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            filename (`str`):
+                The name of the file to check, for example:
+                `"config.json"`
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if getting repository info from a dataset or a space,
+                `None` or `"model"` if getting repository info from a model. Default is `None`.
+            revision (`str`, *optional*):
+                The revision of the repository from which to get the information. Defaults to `"main"` branch.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+
+        Returns:
+            True if the file exists, False otherwise.
+
+        Examples:
+            ```py
+            >>> from huggingface_hub import file_exists
+            >>> file_exists("bigcode/starcoder", "config.json")
+            True
+            >>> file_exists("bigcode/starcoder", "not-a-file")
+            False
+            >>> file_exists("bigcode/not-a-repo", "config.json")
+            False
+            ```
+        """
+        url = hf_hub_url(
+            repo_id=repo_id, repo_type=repo_type, revision=revision, filename=filename, endpoint=self.endpoint
+        )
+        try:
+            if token is None:
+                token = self.token
+            get_hf_file_metadata(url, token=token)
+            return True
+        except GatedRepoError:  # raise specifically on gated repo
+            raise
+        except (RepositoryNotFoundError, EntryNotFoundError, RevisionNotFoundError):
+            return False
+
+    @validate_hf_hub_args
+    @_deprecate_method(version="0.23", message="Use `list_repo_tree` and `get_paths_info` instead.")
+    def list_files_info(
+        self,
+        repo_id: str,
+        paths: Union[List[str], str, None] = None,
+        *,
+        expand: bool = False,
+        revision: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        token: Optional[Union[bool, str]] = None,
+    ) -> Iterable[RepoFile]:
+        """
+        List files on a repo and get information about them.
+
+        Takes as input a list of paths. Those paths can be either files or folders. Two server endpoints are called:
+        1. POST "/paths-info" to get information about the provided paths. Called once.
+        2. GET  "/tree?recursive=True" to paginate over the input folders. Called only if a folder path is provided as
+           input. Will be called multiple times to follow pagination.
+        If no path is provided as input, step 1. is ignored and all files from the repo are listed.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated by a `/`.
+            paths (`Union[List[str], str, None]`, *optional*):
+                The paths to get information about. Paths to files are directly resolved. Paths to folders are resolved
+                recursively which means that information is returned about all files in the folder and its subfolders.
+                If `None`, all files are returned (the default). If a path do not exist, it is ignored without raising
+                an exception.
+            expand (`bool`, *optional*, defaults to `False`):
+                Whether to fetch more information about the files (e.g. last commit and security scan results). This
+                operation is more expensive for the server so only 50 results are returned per page (instead of 1000).
+                As pagination is implemented in `huggingface_hub`, this is transparent for you except for the time it
+                takes to get the results.
+            revision (`str`, *optional*):
+                The revision of the repository from which to get the information. Defaults to `"main"` branch.
+            repo_type (`str`, *optional*):
+                The type of the repository from which to get the information (`"model"`, `"dataset"` or `"space"`.
+                Defaults to `"model"`.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
+                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
+                retrieved from the cache. If `False`, token is not sent in the request header.
+
+        Returns:
+            `Iterable[RepoFile]`:
+                The information about the files, as an iterable of [`RepoFile`] objects. The order of the files is
+                not guaranteed.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If repository is not found (error 404): wrong repo_id/repo_type, private but not authenticated or repo
+                does not exist.
+            [`~utils.RevisionNotFoundError`]:
+                If revision is not found (error 404) on the repo.
+
+        Examples:
+
+            Get information about files on a repo.
+            ```py
+            >>> from huggingface_hub import list_files_info
+            >>> files_info = list_files_info("lysandre/arxiv-nlp", ["README.md", "config.json"])
+            >>> files_info
+            <generator object HfApi.list_files_info at 0x7f93b848e730>
+            >>> list(files_info)
+            [
+                RepoFile(path='README.md', size=391, blob_id='43bd404b159de6fba7c2f4d3264347668d43af25', lfs=None, last_commit=None, security=None),
+                RepoFile(path='config.json', size=554, blob_id='2f9618c3a19b9a61add74f70bfb121335aeef666', lfs=None, last_commit=None, security=None)
+            ]
+            ```
+
+            Get even more information about files on a repo (last commit and security scan results)
+            ```py
+            >>> from huggingface_hub import list_files_info
+            >>> files_info = list_files_info("prompthero/openjourney-v4", expand=True)
+            >>> list(files_info)
+            [
+                RepoFile(
+                    path='safety_checker/pytorch_model.bin',
+                    size=1216064769,
+                    blob_id='c8835557a0d3af583cb06c7c154b7e54a069c41d',
+                    lfs={
+                        'size': 1216064769,
+                        'sha256': '16d28f2b37109f222cdc33620fdd262102ac32112be0352a7f77e9614b35a394',
+                        'pointer_size': 135
+                    },
+                    last_commit={
+                        'oid': '47b62b20b20e06b9de610e840282b7e6c3d51190',
+                        'title': 'Upload diffusers weights (#48)',
+                        'date': datetime.datetime(2023, 3, 21, 10, 5, 27, tzinfo=datetime.timezone.utc)
+                    },
+                    security={
+                        'safe': True,
+                        'av_scan': {
+                            'virusFound': False,
+                            'virusNames': None
+                        },
+                        'pickle_import_scan': {
+                            'highestSafetyLevel': 'innocuous',
+                            'imports': [
+                                {'module': 'torch', 'name': 'FloatStorage', 'safety': 'innocuous'},
+                                {'module': 'collections', 'name': 'OrderedDict', 'safety': 'innocuous'},
+                                {'module': 'torch', 'name': 'LongStorage', 'safety': 'innocuous'},
+                                {'module': 'torch._utils', 'name': '_rebuild_tensor_v2', 'safety': 'innocuous'}
+                            ]
+                        }
+                    }
+                ),
+                RepoFile(
+                    path='scheduler/scheduler_config.json',
+                    size=465,
+                    blob_id='70d55e3e9679f41cbc66222831b38d5abce683dd',
+                    lfs=None,
+                    last_commit={
+                        'oid': '47b62b20b20e06b9de610e840282b7e6c3d51190',
+                        'title': 'Upload diffusers weights (#48)',
+                        'date': datetime.datetime(2023, 3, 21, 10, 5, 27, tzinfo=datetime.timezone.utc)},
+                        security={
+                            'safe': True,
+                            'av_scan': {
+                                'virusFound': False,
+                                'virusNames': None
+                            },
+                            'pickle_import_scan': None
+                        }
+                ),
+                ...
+            ]
+            ```
+
+            List LFS files from the "vae/" folder in "stabilityai/stable-diffusion-2" repository.
+
+            ```py
+            >>> from huggingface_hub import list_files_info
+            >>> [info.path for info in list_files_info("stabilityai/stable-diffusion-2", "vae") if info.lfs is not None]
+            ['vae/diffusion_pytorch_model.bin', 'vae/diffusion_pytorch_model.safetensors']
+            ```
+
+            List all files on a repo.
+            ```py
+            >>> from huggingface_hub import list_files_info
+            >>> [info.path for info in list_files_info("glue", repo_type="dataset")]
+            ['.gitattributes', 'README.md', 'dataset_infos.json', 'glue.py']
+            ```
+        """
+        repo_type = repo_type or REPO_TYPE_MODEL
+        revision = quote(revision, safe="") if revision is not None else DEFAULT_REVISION
+        headers = self._build_hf_headers(token=token)
+
+        folder_paths = []
+        if paths is None:
+            # `paths` is not provided => list all files from the repo
+            folder_paths.append("")
+        elif paths == []:
+            # corner case: server would return a 400 error if `paths` is an empty list. Let's return early.
+            return
+        else:
+            # `paths` is provided => get info about those
+            response = get_session().post(
+                f"{self.endpoint}/api/{repo_type}s/{repo_id}/paths-info/{revision}",
+                data={
+                    "paths": paths if isinstance(paths, list) else [paths],
+                    "expand": expand,
+                },
+                headers=headers,
+            )
+            hf_raise_for_status(response)
+            paths_info = response.json()
+
+            # List top-level files first
+            for path_info in paths_info:
+                if path_info["type"] == "file":
+                    yield RepoFile(**path_info)
+                else:
+                    folder_paths.append(path_info["path"])
+
+        # List files in subdirectories
+        for path in folder_paths:
+            encoded_path = "/" + quote(path, safe="") if path else ""
+            tree_url = f"{self.endpoint}/api/{repo_type}s/{repo_id}/tree/{revision}{encoded_path}"
+            for subpath_info in paginate(path=tree_url, headers=headers, params={"recursive": True, "expand": expand}):
+                if subpath_info["type"] == "file":
+                    yield RepoFile(**subpath_info)
+
+    @validate_hf_hub_args
+    def list_repo_files(
+        self,
+        repo_id: str,
+        *,
+        revision: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        token: Optional[Union[bool, str]] = None,
+    ) -> List[str]:
+        """
+        Get the list of files in a given repo.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated by a `/`.
+            revision (`str`, *optional*):
+                The revision of the model repository from which to get the information.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or space, `None` or `"model"` if uploading to
+                a model. Default is `None`.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
+                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
+                retrieved from the cache. If `False`, token is not sent in the request header.
+
+        Returns:
+            `List[str]`: the list of files in a given repository.
+        """
+        return [
+            f.rfilename
+            for f in self.list_repo_tree(
+                repo_id=repo_id, recursive=True, revision=revision, repo_type=repo_type, token=token
+            )
+            if isinstance(f, RepoFile)
+        ]
+
+    @validate_hf_hub_args
+    def list_repo_tree(
+        self,
+        repo_id: str,
+        path_in_repo: Optional[str] = None,
+        *,
+        recursive: bool = False,
+        expand: bool = False,
+        revision: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        token: Optional[Union[bool, str]] = None,
+    ) -> Iterable[Union[RepoFile, RepoFolder]]:
+        """
+        List a repo tree's files and folders and get information about them.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated by a `/`.
+            path_in_repo (`str`, *optional*):
+                Relative path of the tree (folder) in the repo, for example:
+                `"checkpoints/1fec34a/results"`. Will default to the root tree (folder) of the repository.
+            recursive (`bool`, *optional*, defaults to `False`):
+                Whether to list tree's files and folders recursively.
+            expand (`bool`, *optional*, defaults to `False`):
+                Whether to fetch more information about the tree's files and folders (e.g. last commit and files' security scan results). This
+                operation is more expensive for the server so only 50 results are returned per page (instead of 1000).
+                As pagination is implemented in `huggingface_hub`, this is transparent for you except for the time it
+                takes to get the results.
+            revision (`str`, *optional*):
+                The revision of the repository from which to get the tree. Defaults to `"main"` branch.
+            repo_type (`str`, *optional*):
+                The type of the repository from which to get the tree (`"model"`, `"dataset"` or `"space"`.
+                Defaults to `"model"`.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
+                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
+                retrieved from the cache. If `False`, token is not sent in the request header.
+
+        Returns:
+            `Iterable[Union[RepoFile, RepoFolder]]`:
+                The information about the tree's files and folders, as an iterable of [`RepoFile`] and [`RepoFolder`] objects. The order of the files and folders is
+                not guaranteed.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If repository is not found (error 404): wrong repo_id/repo_type, private but not authenticated or repo
+                does not exist.
+            [`~utils.RevisionNotFoundError`]:
+                If revision is not found (error 404) on the repo.
+            [`~utils.EntryNotFoundError`]:
+                If the tree (folder) does not exist (error 404) on the repo.
+
+        Examples:
+
+            Get information about a repo's tree.
+            ```py
+            >>> from huggingface_hub import list_repo_tree
+            >>> repo_tree = list_repo_tree("lysandre/arxiv-nlp")
+            >>> repo_tree
+            <generator object HfApi.list_repo_tree at 0x7fa4088e1ac0>
+            >>> list(repo_tree)
+            [
+                RepoFile(path='.gitattributes', size=391, blob_id='ae8c63daedbd4206d7d40126955d4e6ab1c80f8f', lfs=None, last_commit=None, security=None),
+                RepoFile(path='README.md', size=391, blob_id='43bd404b159de6fba7c2f4d3264347668d43af25', lfs=None, last_commit=None, security=None),
+                RepoFile(path='config.json', size=554, blob_id='2f9618c3a19b9a61add74f70bfb121335aeef666', lfs=None, last_commit=None, security=None),
+                RepoFile(
+                    path='flax_model.msgpack', size=497764107, blob_id='8095a62ccb4d806da7666fcda07467e2d150218e',
+                    lfs={'size': 497764107, 'sha256': 'd88b0d6a6ff9c3f8151f9d3228f57092aaea997f09af009eefd7373a77b5abb9', 'pointer_size': 134}, last_commit=None, security=None
+                ),
+                RepoFile(path='merges.txt', size=456318, blob_id='226b0752cac7789c48f0cb3ec53eda48b7be36cc', lfs=None, last_commit=None, security=None),
+                RepoFile(
+                    path='pytorch_model.bin', size=548123560, blob_id='64eaa9c526867e404b68f2c5d66fd78e27026523',
+                    lfs={'size': 548123560, 'sha256': '9be78edb5b928eba33aa88f431551348f7466ba9f5ef3daf1d552398722a5436', 'pointer_size': 134}, last_commit=None, security=None
+                ),
+                RepoFile(path='vocab.json', size=898669, blob_id='b00361fece0387ca34b4b8b8539ed830d644dbeb', lfs=None, last_commit=None, security=None)]
+            ]
+            ```
+
+            Get even more information about a repo's tree (last commit and files' security scan results)
+            ```py
+            >>> from huggingface_hub import list_repo_tree
+            >>> repo_tree = list_repo_tree("prompthero/openjourney-v4", expand=True)
+            >>> list(repo_tree)
+            [
+                RepoFolder(
+                    path='feature_extractor',
+                    tree_id='aa536c4ea18073388b5b0bc791057a7296a00398',
+                    last_commit={
+                        'oid': '47b62b20b20e06b9de610e840282b7e6c3d51190',
+                        'title': 'Upload diffusers weights (#48)',
+                        'date': datetime.datetime(2023, 3, 21, 9, 5, 27, tzinfo=datetime.timezone.utc)
+                    }
+                ),
+                RepoFolder(
+                    path='safety_checker',
+                    tree_id='65aef9d787e5557373fdf714d6c34d4fcdd70440',
+                    last_commit={
+                        'oid': '47b62b20b20e06b9de610e840282b7e6c3d51190',
+                        'title': 'Upload diffusers weights (#48)',
+                        'date': datetime.datetime(2023, 3, 21, 9, 5, 27, tzinfo=datetime.timezone.utc)
+                    }
+                ),
+                RepoFile(
+                    path='model_index.json',
+                    size=582,
+                    blob_id='d3d7c1e8c3e78eeb1640b8e2041ee256e24c9ee1',
+                    lfs=None,
+                    last_commit={
+                        'oid': 'b195ed2d503f3eb29637050a886d77bd81d35f0e',
+                        'title': 'Fix deprecation warning by changing `CLIPFeatureExtractor` to `CLIPImageProcessor`. (#54)',
+                        'date': datetime.datetime(2023, 5, 15, 21, 41, 59, tzinfo=datetime.timezone.utc)
+                    },
+                    security={
+                        'safe': True,
+                        'av_scan': {'virusFound': False, 'virusNames': None},
+                        'pickle_import_scan': None
+                    }
+                )
+                ...
+            ]
+            ```
+        """
+        repo_type = repo_type or REPO_TYPE_MODEL
+        revision = quote(revision, safe="") if revision is not None else DEFAULT_REVISION
+        headers = self._build_hf_headers(token=token)
+
+        encoded_path_in_repo = "/" + quote(path_in_repo, safe="") if path_in_repo else ""
+        tree_url = f"{self.endpoint}/api/{repo_type}s/{repo_id}/tree/{revision}{encoded_path_in_repo}"
+        for path_info in paginate(path=tree_url, headers=headers, params={"recursive": recursive, "expand": expand}):
+            yield (RepoFile(**path_info) if path_info["type"] == "file" else RepoFolder(**path_info))
+
+    @validate_hf_hub_args
+    def list_repo_refs(
+        self,
+        repo_id: str,
+        *,
+        repo_type: Optional[str] = None,
+        include_pull_requests: bool = False,
+        token: Optional[Union[bool, str]] = None,
+    ) -> GitRefs:
+        """
+        Get the list of refs of a given repo (both tags and branches).
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if listing refs from a dataset or a Space,
+                `None` or `"model"` if listing from a model. Default is `None`.
+            include_pull_requests (`bool`, *optional*):
+                Whether to include refs from pull requests in the list. Defaults to `False`.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import HfApi
+        >>> api = HfApi()
+        >>> api.list_repo_refs("gpt2")
+        GitRefs(branches=[GitRefInfo(name='main', ref='refs/heads/main', target_commit='e7da7f221d5bf496a48136c0cd264e630fe9fcc8')], converts=[], tags=[])
+
+        >>> api.list_repo_refs("bigcode/the-stack", repo_type='dataset')
+        GitRefs(
+            branches=[
+                GitRefInfo(name='main', ref='refs/heads/main', target_commit='18edc1591d9ce72aa82f56c4431b3c969b210ae3'),
+                GitRefInfo(name='v1.1.a1', ref='refs/heads/v1.1.a1', target_commit='f9826b862d1567f3822d3d25649b0d6d22ace714')
+            ],
+            converts=[],
+            tags=[
+                GitRefInfo(name='v1.0', ref='refs/tags/v1.0', target_commit='c37a8cd1e382064d8aced5e05543c5f7753834da')
+            ]
+        )
+        ```
+
+        Returns:
+            [`GitRefs`]: object containing all information about branches and tags for a
+            repo on the Hub.
+        """
+        repo_type = repo_type or REPO_TYPE_MODEL
+        response = get_session().get(
+            f"{self.endpoint}/api/{repo_type}s/{repo_id}/refs",
+            headers=self._build_hf_headers(token=token),
+            params={"include_prs": 1} if include_pull_requests else {},
+        )
+        hf_raise_for_status(response)
+        data = response.json()
+
+        def _format_as_git_ref_info(item: Dict) -> GitRefInfo:
+            return GitRefInfo(name=item["name"], ref=item["ref"], target_commit=item["targetCommit"])
+
+        return GitRefs(
+            branches=[_format_as_git_ref_info(item) for item in data["branches"]],
+            converts=[_format_as_git_ref_info(item) for item in data["converts"]],
+            tags=[_format_as_git_ref_info(item) for item in data["tags"]],
+            pull_requests=[_format_as_git_ref_info(item) for item in data["pullRequests"]]
+            if include_pull_requests
+            else None,
+        )
+
+    @validate_hf_hub_args
+    def list_repo_commits(
+        self,
+        repo_id: str,
+        *,
+        repo_type: Optional[str] = None,
+        token: Optional[Union[bool, str]] = None,
+        revision: Optional[str] = None,
+        formatted: bool = False,
+    ) -> List[GitCommitInfo]:
+        """
+        Get the list of commits of a given revision for a repo on the Hub.
+
+        Commits are sorted by date (last commit first).
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated by a `/`.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if listing commits from a dataset or a Space, `None` or `"model"` if
+                listing from a model. Default is `None`.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+            revision (`str`, *optional*):
+                The git revision to commit from. Defaults to the head of the `"main"` branch.
+            formatted (`bool`):
+                Whether to return the HTML-formatted title and description of the commits. Defaults to False.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import HfApi
+        >>> api = HfApi()
+
+        # Commits are sorted by date (last commit first)
+        >>> initial_commit = api.list_repo_commits("gpt2")[-1]
+
+        # Initial commit is always a system commit containing the `.gitattributes` file.
+        >>> initial_commit
+        GitCommitInfo(
+            commit_id='9b865efde13a30c13e0a33e536cf3e4a5a9d71d8',
+            authors=['system'],
+            created_at=datetime.datetime(2019, 2, 18, 10, 36, 15, tzinfo=datetime.timezone.utc),
+            title='initial commit',
+            message='',
+            formatted_title=None,
+            formatted_message=None
+        )
+
+        # Create an empty branch by deriving from initial commit
+        >>> api.create_branch("gpt2", "new_empty_branch", revision=initial_commit.commit_id)
+        ```
+
+        Returns:
+            List[[`GitCommitInfo`]]: list of objects containing information about the commits for a repo on the Hub.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If repository is not found (error 404): wrong repo_id/repo_type, private but not authenticated or repo
+                does not exist.
+            [`~utils.RevisionNotFoundError`]:
+                If revision is not found (error 404) on the repo.
+        """
+        repo_type = repo_type or REPO_TYPE_MODEL
+        revision = quote(revision, safe="") if revision is not None else DEFAULT_REVISION
+
+        # Paginate over results and return the list of commits.
+        return [
+            GitCommitInfo(
+                commit_id=item["id"],
+                authors=[author["user"] for author in item["authors"]],
+                created_at=parse_datetime(item["date"]),
+                title=item["title"],
+                message=item["message"],
+                formatted_title=item.get("formatted", {}).get("title"),
+                formatted_message=item.get("formatted", {}).get("message"),
+            )
+            for item in paginate(
+                f"{self.endpoint}/api/{repo_type}s/{repo_id}/commits/{revision}",
+                headers=self._build_hf_headers(token=token),
+                params={"expand[]": "formatted"} if formatted else {},
+            )
+        ]
+
+    @validate_hf_hub_args
+    def get_paths_info(
+        self,
+        repo_id: str,
+        paths: Union[List[str], str],
+        *,
+        expand: bool = False,
+        revision: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        token: Optional[Union[bool, str]] = None,
+    ) -> List[Union[RepoFile, RepoFolder]]:
+        """
+        Get information about a repo's paths.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated by a `/`.
+            paths (`Union[List[str], str]`, *optional*):
+                The paths to get information about. If a path do not exist, it is ignored without raising
+                an exception.
+            expand (`bool`, *optional*, defaults to `False`):
+                Whether to fetch more information about the paths (e.g. last commit and files' security scan results). This
+                operation is more expensive for the server so only 50 results are returned per page (instead of 1000).
+                As pagination is implemented in `huggingface_hub`, this is transparent for you except for the time it
+                takes to get the results.
+            revision (`str`, *optional*):
+                The revision of the repository from which to get the information. Defaults to `"main"` branch.
+            repo_type (`str`, *optional*):
+                The type of the repository from which to get the information (`"model"`, `"dataset"` or `"space"`.
+                Defaults to `"model"`.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
+                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
+                retrieved from the cache. If `False`, token is not sent in the request header.
+
+        Returns:
+            `List[Union[RepoFile, RepoFolder]]`:
+                The information about the paths, as a list of [`RepoFile`] and [`RepoFolder`] objects.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If repository is not found (error 404): wrong repo_id/repo_type, private but not authenticated or repo
+                does not exist.
+            [`~utils.RevisionNotFoundError`]:
+                If revision is not found (error 404) on the repo.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import get_paths_info
+        >>> paths_info = get_paths_info("allenai/c4", ["README.md", "en"], repo_type="dataset")
+        >>> paths_info
+        [
+            RepoFile(path='README.md', size=2379, blob_id='f84cb4c97182890fc1dbdeaf1a6a468fd27b4fff', lfs=None, last_commit=None, security=None),
+            RepoFolder(path='en', tree_id='dc943c4c40f53d02b31ced1defa7e5f438d5862e', last_commit=None)
+        ]
+        ```
+        """
+        repo_type = repo_type or REPO_TYPE_MODEL
+        revision = quote(revision, safe="") if revision is not None else DEFAULT_REVISION
+        headers = self._build_hf_headers(token=token)
+
+        response = get_session().post(
+            f"{self.endpoint}/api/{repo_type}s/{repo_id}/paths-info/{revision}",
+            data={
+                "paths": paths if isinstance(paths, list) else [paths],
+                "expand": expand,
+            },
+            headers=headers,
+        )
+        hf_raise_for_status(response)
+        paths_info = response.json()
+        return [
+            RepoFile(**path_info) if path_info["type"] == "file" else RepoFolder(**path_info)
+            for path_info in paths_info
+        ]
+
+    @validate_hf_hub_args
+    def super_squash_history(
+        self,
+        repo_id: str,
+        *,
+        branch: Optional[str] = None,
+        commit_message: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        token: Optional[str] = None,
+    ) -> None:
+        """Squash commit history on a branch for a repo on the Hub.
+
+        Squashing the repo history is useful when you know you'll make hundreds of commits and you don't want to
+        clutter the history. Squashing commits can only be performed from the head of a branch.
+
+        <Tip warning={true}>
+
+        Once squashed, the commit history cannot be retrieved. This is a non-revertible operation.
+
+        </Tip>
+
+        <Tip warning={true}>
+
+        Once the history of a branch has been squashed, it is not possible to merge it back into another branch since
+        their history will have diverged.
+
+        </Tip>
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated by a `/`.
+            branch (`str`, *optional*):
+                The branch to squash. Defaults to the head of the `"main"` branch.
+            commit_message (`str`, *optional*):
+                The commit message to use for the squashed commit.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if listing commits from a dataset or a Space, `None` or `"model"` if
+                listing from a model. Default is `None`.
+            token (`str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token). If the machine is logged in
+                (through `huggingface-cli login` or [`~huggingface_hub.login`]), token can be automatically retrieved
+                from the cache.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If repository is not found (error 404): wrong repo_id/repo_type, private but not authenticated or repo
+                does not exist.
+            [`~utils.RevisionNotFoundError`]:
+                If the branch to squash cannot be found.
+            [`~utils.BadRequestError`]:
+                If invalid reference for a branch. You cannot squash history on tags.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import HfApi
+        >>> api = HfApi()
+
+        # Create repo
+        >>> repo_id = api.create_repo("test-squash").repo_id
+
+        # Make a lot of commits.
+        >>> api.upload_file(repo_id=repo_id, path_in_repo="file.txt", path_or_fileobj=b"content")
+        >>> api.upload_file(repo_id=repo_id, path_in_repo="lfs.bin", path_or_fileobj=b"content")
+        >>> api.upload_file(repo_id=repo_id, path_in_repo="file.txt", path_or_fileobj=b"another_content")
+
+        # Squash history
+        >>> api.super_squash_history(repo_id=repo_id)
+        ```
+        """
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+        if repo_type not in REPO_TYPES:
+            raise ValueError("Invalid repo type")
+        if branch is None:
+            branch = DEFAULT_REVISION
+
+        # Prepare request
+        url = f"{self.endpoint}/api/{repo_type}s/{repo_id}/super-squash/{branch}"
+        headers = self._build_hf_headers(token=token)
+        commit_message = commit_message or f"Super-squash branch '{branch}' using huggingface_hub"
+
+        # Super-squash
+        response = get_session().post(url=url, headers=headers, json={"message": commit_message})
+        hf_raise_for_status(response)
+
+    @validate_hf_hub_args
+    def create_repo(
+        self,
+        repo_id: str,
+        *,
+        token: Optional[str] = None,
+        private: bool = False,
+        repo_type: Optional[str] = None,
+        exist_ok: bool = False,
+        space_sdk: Optional[str] = None,
+        space_hardware: Optional[SpaceHardware] = None,
+        space_storage: Optional[SpaceStorage] = None,
+        space_sleep_time: Optional[int] = None,
+        space_secrets: Optional[List[Dict[str, str]]] = None,
+        space_variables: Optional[List[Dict[str, str]]] = None,
+    ) -> RepoUrl:
+        """Create an empty repo on the HuggingFace Hub.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token)
+            private (`bool`, *optional*, defaults to `False`):
+                Whether the model repo should be private.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+            exist_ok (`bool`, *optional*, defaults to `False`):
+                If `True`, do not raise an error if repo already exists.
+            space_sdk (`str`, *optional*):
+                Choice of SDK to use if repo_type is "space". Can be "streamlit", "gradio", "docker", or "static".
+            space_hardware (`SpaceHardware` or `str`, *optional*):
+                Choice of Hardware if repo_type is "space". See [`SpaceHardware`] for a complete list.
+            space_storage (`SpaceStorage` or `str`, *optional*):
+                Choice of persistent storage tier. Example: `"small"`. See [`SpaceStorage`] for a complete list.
+            space_sleep_time (`int`, *optional*):
+                Number of seconds of inactivity to wait before a Space is put to sleep. Set to `-1` if you don't want
+                your Space to sleep (default behavior for upgraded hardware). For free hardware, you can't configure
+                the sleep time (value is fixed to 48 hours of inactivity).
+                See https://huggingface.co/docs/hub/spaces-gpus#sleep-time for more details.
+            space_secrets (`List[Dict[str, str]]`, *optional*):
+                A list of secret keys to set in your Space. Each item is in the form `{"key": ..., "value": ..., "description": ...}` where description is optional.
+                For more details, see https://huggingface.co/docs/hub/spaces-overview#managing-secrets.
+            space_variables (`List[Dict[str, str]]`, *optional*):
+                A list of public environment variables to set in your Space. Each item is in the form `{"key": ..., "value": ..., "description": ...}` where description is optional.
+                For more details, see https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables.
+
+        Returns:
+            [`RepoUrl`]: URL to the newly created repo. Value is a subclass of `str` containing
+            attributes like `endpoint`, `repo_type` and `repo_id`.
+        """
+        organization, name = repo_id.split("/") if "/" in repo_id else (None, repo_id)
+
+        path = f"{self.endpoint}/api/repos/create"
+
+        if repo_type not in REPO_TYPES:
+            raise ValueError("Invalid repo type")
+
+        json: Dict[str, Any] = {"name": name, "organization": organization, "private": private}
+        if repo_type is not None:
+            json["type"] = repo_type
+        if repo_type == "space":
+            if space_sdk is None:
+                raise ValueError(
+                    "No space_sdk provided. `create_repo` expects space_sdk to be one"
+                    f" of {SPACES_SDK_TYPES} when repo_type is 'space'`"
+                )
+            if space_sdk not in SPACES_SDK_TYPES:
+                raise ValueError(f"Invalid space_sdk. Please choose one of {SPACES_SDK_TYPES}.")
+            json["sdk"] = space_sdk
+
+        if space_sdk is not None and repo_type != "space":
+            warnings.warn("Ignoring provided space_sdk because repo_type is not 'space'.")
+
+        function_args = [
+            "space_hardware",
+            "space_storage",
+            "space_sleep_time",
+            "space_secrets",
+            "space_variables",
+        ]
+        json_keys = ["hardware", "storageTier", "sleepTimeSeconds", "secrets", "variables"]
+        values = [space_hardware, space_storage, space_sleep_time, space_secrets, space_variables]
+
+        if repo_type == "space":
+            json.update({k: v for k, v in zip(json_keys, values) if v is not None})
+        else:
+            provided_space_args = [key for key, value in zip(function_args, values) if value is not None]
+
+            if provided_space_args:
+                warnings.warn(f"Ignoring provided {', '.join(provided_space_args)} because repo_type is not 'space'.")
+
+        if getattr(self, "_lfsmultipartthresh", None):
+            # Testing purposes only.
+            # See https://github.com/huggingface/huggingface_hub/pull/733/files#r820604472
+            json["lfsmultipartthresh"] = self._lfsmultipartthresh  # type: ignore
+        headers = self._build_hf_headers(token=token)
+
+        while True:
+            r = get_session().post(path, headers=headers, json=json)
+            if r.status_code == 409 and "Cannot create repo: another conflicting operation is in progress" in r.text:
+                # Since https://github.com/huggingface/moon-landing/pull/7272 (private repo), it is not possible to
+                # concurrently create repos on the Hub for a same user. This is rarely an issue, except when running
+                # tests. To avoid any inconvenience, we retry to create the repo for this specific error.
+                # NOTE: This could have being fixed directly in the tests but adding it here should fixed CIs for all
+                # dependent libraries.
+                # NOTE: If a fix is implemented server-side, we should be able to remove this retry mechanism.
+                logger.debug("Create repo failed due to a concurrency issue. Retrying...")
+                continue
+            break
+
+        try:
+            hf_raise_for_status(r)
+        except HTTPError as err:
+            if exist_ok and err.response.status_code == 409:
+                # Repo already exists and `exist_ok=True`
+                pass
+            elif exist_ok and err.response.status_code == 403:
+                # No write permission on the namespace but repo might already exist
+                try:
+                    self.repo_info(repo_id=repo_id, repo_type=repo_type, token=token)
+                    if repo_type is None or repo_type == REPO_TYPE_MODEL:
+                        return RepoUrl(f"{self.endpoint}/{repo_id}")
+                    return RepoUrl(f"{self.endpoint}/{repo_type}/{repo_id}")
+                except HfHubHTTPError:
+                    raise
+            else:
+                raise
+
+        d = r.json()
+        return RepoUrl(d["url"], endpoint=self.endpoint)
+
+    @validate_hf_hub_args
+    def delete_repo(
+        self,
+        repo_id: str,
+        *,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        missing_ok: bool = False,
+    ) -> None:
+        """
+        Delete a repo from the HuggingFace Hub. CAUTION: this is irreversible.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token)
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model.
+            missing_ok (`bool`, *optional*, defaults to `False`):
+                If `True`, do not raise an error if repo does not exist.
+
+        Raises:
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to delete from cannot be found and `missing_ok` is set to False (default).
+        """
+        organization, name = repo_id.split("/") if "/" in repo_id else (None, repo_id)
+
+        path = f"{self.endpoint}/api/repos/delete"
+
+        if repo_type not in REPO_TYPES:
+            raise ValueError("Invalid repo type")
+
+        json = {"name": name, "organization": organization}
+        if repo_type is not None:
+            json["type"] = repo_type
+
+        headers = self._build_hf_headers(token=token)
+        r = get_session().delete(path, headers=headers, json=json)
+        try:
+            hf_raise_for_status(r)
+        except RepositoryNotFoundError:
+            if not missing_ok:
+                raise
+
+    @validate_hf_hub_args
+    @_deprecate_arguments(
+        version="0.24.0", deprecated_args=("organization", "name"), custom_message="Use `repo_id` instead."
+    )
+    def update_repo_visibility(
+        self,
+        repo_id: str,
+        private: bool = False,
+        *,
+        token: Optional[str] = None,
+        organization: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        name: Optional[str] = None,
+    ) -> Dict[str, bool]:
+        """Update the visibility setting of a repository.
+
+        Args:
+            repo_id (`str`, *optional*):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            private (`bool`, *optional*, defaults to `False`):
+                Whether the model repo should be private.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token)
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+
+        Returns:
+            The HTTP response in json.
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+
+        </Tip>
+        """
+        if repo_type not in REPO_TYPES:
+            raise ValueError("Invalid repo type")
+
+        organization, name = repo_id.split("/") if "/" in repo_id else (None, repo_id)
+
+        if organization is None:
+            namespace = self.whoami(token)["name"]
+        else:
+            namespace = organization
+
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL  # default repo type
+
+        r = get_session().put(
+            url=f"{self.endpoint}/api/{repo_type}s/{namespace}/{name}/settings",
+            headers=self._build_hf_headers(token=token),
+            json={"private": private},
+        )
+        hf_raise_for_status(r)
+        return r.json()
+
+    def move_repo(
+        self,
+        from_id: str,
+        to_id: str,
+        *,
+        repo_type: Optional[str] = None,
+        token: Optional[str] = None,
+    ):
+        """
+        Moving a repository from namespace1/repo_name1 to namespace2/repo_name2
+
+        Note there are certain limitations. For more information about moving
+        repositories, please see
+        https://hf.co/docs/hub/repositories-settings#renaming-or-transferring-a-repo.
+
+        Args:
+            from_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`. Original repository identifier.
+            to_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`. Final repository identifier.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token)
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+
+        </Tip>
+        """
+        if len(from_id.split("/")) != 2:
+            raise ValueError(f"Invalid repo_id: {from_id}. It should have a namespace (:namespace:/:repo_name:)")
+
+        if len(to_id.split("/")) != 2:
+            raise ValueError(f"Invalid repo_id: {to_id}. It should have a namespace (:namespace:/:repo_name:)")
+
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL  # Hub won't accept `None`.
+
+        json = {"fromRepo": from_id, "toRepo": to_id, "type": repo_type}
+
+        path = f"{self.endpoint}/api/repos/move"
+        headers = self._build_hf_headers(token=token)
+        r = get_session().post(path, headers=headers, json=json)
+        try:
+            hf_raise_for_status(r)
+        except HfHubHTTPError as e:
+            e.append_to_message(
+                "\nFor additional documentation please see"
+                " https://hf.co/docs/hub/repositories-settings#renaming-or-transferring-a-repo."
+            )
+            raise
+
+    @overload
+    def create_commit(  # type: ignore
+        self,
+        repo_id: str,
+        operations: Iterable[CommitOperation],
+        *,
+        commit_message: str,
+        commit_description: Optional[str] = None,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        num_threads: int = 5,
+        parent_commit: Optional[str] = None,
+        run_as_future: Literal[False] = ...,
+    ) -> CommitInfo: ...
+
+    @overload
+    def create_commit(
+        self,
+        repo_id: str,
+        operations: Iterable[CommitOperation],
+        *,
+        commit_message: str,
+        commit_description: Optional[str] = None,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        num_threads: int = 5,
+        parent_commit: Optional[str] = None,
+        run_as_future: Literal[True] = ...,
+    ) -> Future[CommitInfo]: ...
+
+    @validate_hf_hub_args
+    @future_compatible
+    def create_commit(
+        self,
+        repo_id: str,
+        operations: Iterable[CommitOperation],
+        *,
+        commit_message: str,
+        commit_description: Optional[str] = None,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        num_threads: int = 5,
+        parent_commit: Optional[str] = None,
+        run_as_future: bool = False,
+    ) -> Union[CommitInfo, Future[CommitInfo]]:
+        """
+        Creates a commit in the given repo, deleting & uploading files as needed.
+
+        <Tip warning={true}>
+
+        The input list of `CommitOperation` will be mutated during the commit process. Do not reuse the same objects
+        for multiple commits.
+
+        </Tip>
+
+        <Tip warning={true}>
+
+        `create_commit` assumes that the repo already exists on the Hub. If you get a
+        Client error 404, please make sure you are authenticated and that `repo_id` and
+        `repo_type` are set correctly. If repo does not exist, create it first using
+        [`~hf_api.create_repo`].
+
+        </Tip>
+
+        <Tip warning={true}>
+
+        `create_commit` is limited to 25k LFS files and a 1GB payload for regular files.
+
+        </Tip>
+
+        Args:
+            repo_id (`str`):
+                The repository in which the commit will be created, for example:
+                `"username/custom_transformers"`
+
+            operations (`Iterable` of [`~hf_api.CommitOperation`]):
+                An iterable of operations to include in the commit, either:
+
+                    - [`~hf_api.CommitOperationAdd`] to upload a file
+                    - [`~hf_api.CommitOperationDelete`] to delete a file
+                    - [`~hf_api.CommitOperationCopy`] to copy a file
+
+                Operation objects will be mutated to include information relative to the upload. Do not reuse the
+                same objects for multiple commits.
+
+            commit_message (`str`):
+                The summary (first line) of the commit that will be created.
+
+            commit_description (`str`, *optional*):
+                The description of the commit that will be created
+
+            token (`str`, *optional*):
+                Authentication token, obtained with `HfApi.login` method. Will
+                default to the stored token.
+
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+
+            revision (`str`, *optional*):
+                The git revision to commit from. Defaults to the head of the `"main"` branch.
+
+            create_pr (`boolean`, *optional*):
+                Whether or not to create a Pull Request with that commit. Defaults to `False`.
+                If `revision` is not set, PR is opened against the `"main"` branch. If
+                `revision` is set and is a branch, PR is opened against this branch. If
+                `revision` is set and is not a branch name (example: a commit oid), an
+                `RevisionNotFoundError` is returned by the server.
+
+            num_threads (`int`, *optional*):
+                Number of concurrent threads for uploading files. Defaults to 5.
+                Setting it to 2 means at most 2 files will be uploaded concurrently.
+
+            parent_commit (`str`, *optional*):
+                The OID / SHA of the parent commit, as a hexadecimal string.
+                Shorthands (7 first characters) are also supported. If specified and `create_pr` is `False`,
+                the commit will fail if `revision` does not point to `parent_commit`. If specified and `create_pr`
+                is `True`, the pull request will be created from `parent_commit`. Specifying `parent_commit`
+                ensures the repo has not changed before committing the changes, and can be especially useful
+                if the repo is updated / committed to concurrently.
+            run_as_future (`bool`, *optional*):
+                Whether or not to run this method in the background. Background jobs are run sequentially without
+                blocking the main thread. Passing `run_as_future=True` will return a [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects)
+                object. Defaults to `False`.
+
+        Returns:
+            [`CommitInfo`] or `Future`:
+                Instance of [`CommitInfo`] containing information about the newly created commit (commit hash, commit
+                url, pr url, commit message,...). If `run_as_future=True` is passed, returns a Future object which will
+                contain the result when executed.
+
+        Raises:
+            [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+                If commit message is empty.
+            [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+                If parent commit is not a valid commit OID.
+            [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+                If a README.md file with an invalid metadata section is committed. In this case, the commit will fail
+                early, before trying to upload any file.
+            [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+                If `create_pr` is `True` and revision is neither `None` nor `"main"`.
+            [`~utils.RepositoryNotFoundError`]:
+                If repository is not found (error 404): wrong repo_id/repo_type, private
+                but not authenticated or repo does not exist.
+        """
+        if parent_commit is not None and not REGEX_COMMIT_OID.fullmatch(parent_commit):
+            raise ValueError(
+                f"`parent_commit` is not a valid commit OID. It must match the following regex: {REGEX_COMMIT_OID}"
+            )
+
+        if commit_message is None or len(commit_message) == 0:
+            raise ValueError("`commit_message` can't be empty, please pass a value.")
+
+        commit_description = commit_description if commit_description is not None else ""
+        repo_type = repo_type if repo_type is not None else REPO_TYPE_MODEL
+        if repo_type not in REPO_TYPES:
+            raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
+        unquoted_revision = revision or DEFAULT_REVISION
+        revision = quote(unquoted_revision, safe="")
+        create_pr = create_pr if create_pr is not None else False
+
+        headers = self._build_hf_headers(token=token)
+
+        operations = list(operations)
+        additions = [op for op in operations if isinstance(op, CommitOperationAdd)]
+        copies = [op for op in operations if isinstance(op, CommitOperationCopy)]
+        nb_additions = len(additions)
+        nb_copies = len(copies)
+        nb_deletions = len(operations) - nb_additions - nb_copies
+
+        for addition in additions:
+            if addition._is_committed:
+                raise ValueError(
+                    f"CommitOperationAdd {addition} has already being committed and cannot be reused. Please create a"
+                    " new CommitOperationAdd object if you want to create a new commit."
+                )
+
+        logger.debug(
+            f"About to commit to the hub: {len(additions)} addition(s), {len(copies)} copie(s) and"
+            f" {nb_deletions} deletion(s)."
+        )
+
+        # If updating a README.md file, make sure the metadata format is valid
+        # It's better to fail early than to fail after all the files have been uploaded.
+        for addition in additions:
+            if addition.path_in_repo == "README.md":
+                with addition.as_file() as file:
+                    response = get_session().post(
+                        f"{ENDPOINT}/api/validate-yaml",
+                        json={"content": file.read().decode(), "repoType": repo_type},
+                        headers=headers,
+                    )
+                    # Handle warnings (example: empty metadata)
+                    response_content = response.json()
+                    message = "\n".join(
+                        [f"- {warning.get('message')}" for warning in response_content.get("warnings", [])]
+                    )
+                    if message:
+                        warnings.warn(f"Warnings while validating metadata in README.md:\n{message}")
+
+                    # Raise on errors
+                    try:
+                        hf_raise_for_status(response)
+                    except BadRequestError as e:
+                        errors = response_content.get("errors", [])
+                        message = "\n".join([f"- {error.get('message')}" for error in errors])
+                        raise ValueError(f"Invalid metadata in README.md.\n{message}") from e
+
+        # If updating twice the same file or update then delete a file in a single commit
+        _warn_on_overwriting_operations(operations)
+
+        self.preupload_lfs_files(
+            repo_id=repo_id,
+            additions=additions,
+            token=token,
+            repo_type=repo_type,
+            revision=unquoted_revision,  # first-class methods take unquoted revision
+            create_pr=create_pr,
+            num_threads=num_threads,
+            free_memory=False,  # do not remove `CommitOperationAdd.path_or_fileobj` on LFS files for "normal" users
+        )
+        files_to_copy = _fetch_files_to_copy(
+            copies=copies,
+            repo_type=repo_type,
+            repo_id=repo_id,
+            headers=headers,
+            revision=revision,
+            endpoint=self.endpoint,
+        )
+        commit_payload = _prepare_commit_payload(
+            operations=operations,
+            files_to_copy=files_to_copy,
+            commit_message=commit_message,
+            commit_description=commit_description,
+            parent_commit=parent_commit,
+        )
+        commit_url = f"{self.endpoint}/api/{repo_type}s/{repo_id}/commit/{revision}"
+
+        def _payload_as_ndjson() -> Iterable[bytes]:
+            for item in commit_payload:
+                yield json.dumps(item).encode()
+                yield b"\n"
+
+        headers = {
+            # See https://github.com/huggingface/huggingface_hub/issues/1085#issuecomment-1265208073
+            "Content-Type": "application/x-ndjson",
+            **headers,
+        }
+        data = b"".join(_payload_as_ndjson())
+        params = {"create_pr": "1"} if create_pr else None
+
+        try:
+            commit_resp = get_session().post(url=commit_url, headers=headers, data=data, params=params)
+            hf_raise_for_status(commit_resp, endpoint_name="commit")
+        except RepositoryNotFoundError as e:
+            e.append_to_message(_CREATE_COMMIT_NO_REPO_ERROR_MESSAGE)
+            raise
+        except EntryNotFoundError as e:
+            if nb_deletions > 0 and "A file with this name doesn't exist" in str(e):
+                e.append_to_message(
+                    "\nMake sure to differentiate file and folder paths in delete"
+                    " operations with a trailing '/' or using `is_folder=True/False`."
+                )
+            raise
+
+        # Mark additions as committed (cannot be reused in another commit)
+        for addition in additions:
+            addition._is_committed = True
+
+        commit_data = commit_resp.json()
+        return CommitInfo(
+            commit_url=commit_data["commitUrl"],
+            commit_message=commit_message,
+            commit_description=commit_description,
+            oid=commit_data["commitOid"],
+            pr_url=commit_data["pullRequestUrl"] if create_pr else None,
+        )
+
+    @experimental
+    @validate_hf_hub_args
+    def create_commits_on_pr(
+        self,
+        *,
+        repo_id: str,
+        addition_commits: List[List[CommitOperationAdd]],
+        deletion_commits: List[List[CommitOperationDelete]],
+        commit_message: str,
+        commit_description: Optional[str] = None,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        merge_pr: bool = True,
+        num_threads: int = 5,  # TODO: use to multithread uploads
+        verbose: bool = False,
+    ) -> str:
+        """Push changes to the Hub in multiple commits.
+
+        Commits are pushed to a draft PR branch. If the upload fails or gets interrupted, it can be resumed. Progress
+        is tracked in the PR description. At the end of the process, the PR is set as open and the title is updated to
+        match the initial commit message. If `merge_pr=True` is passed, the PR is merged automatically.
+
+        All deletion commits are pushed first, followed by the addition commits. The order of the commits is not
+        guaranteed as we might implement parallel commits in the future. Be sure that your are not updating several
+        times the same file.
+
+        <Tip warning={true}>
+
+        `create_commits_on_pr` is experimental.  Its API and behavior is subject to change in the future without prior notice.
+
+        </Tip>
+
+        <Tip warning={true}>
+
+        `create_commits_on_pr` assumes that the repo already exists on the Hub. If you get a Client error 404, please
+        make sure you are authenticated and that `repo_id` and `repo_type` are set correctly. If repo does not exist,
+        create it first using [`~hf_api.create_repo`].
+
+        </Tip>
+
+        Args:
+            repo_id (`str`):
+                The repository in which the commits will be pushed. Example: `"username/my-cool-model"`.
+
+            addition_commits (`List` of `List` of [`~hf_api.CommitOperationAdd`]):
+                A list containing lists of [`~hf_api.CommitOperationAdd`]. Each sublist will result in a commit on the
+                PR.
+
+            deletion_commits
+                A list containing lists of [`~hf_api.CommitOperationDelete`]. Each sublist will result in a commit on
+                the PR. Deletion commits are pushed before addition commits.
+
+            commit_message (`str`):
+                The summary (first line) of the commit that will be created. Will also be the title of the PR.
+
+            commit_description (`str`, *optional*):
+                The description of the commit that will be created. The description will be added to the PR.
+
+            token (`str`, *optional*):
+                Authentication token, obtained with `HfApi.login` method. Will default to the stored token.
+
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or space, `None` or `"model"` if uploading to
+                a model. Default is `None`.
+
+            merge_pr (`bool`):
+                If set to `True`, the Pull Request is merged at the end of the process. Defaults to `True`.
+
+            num_threads (`int`, *optional*):
+                Number of concurrent threads for uploading files. Defaults to 5.
+
+            verbose (`bool`):
+                If set to `True`, process will run on verbose mode i.e. print information about the ongoing tasks.
+                Defaults to `False`.
+
+        Returns:
+            `str`: URL to the created PR.
+
+        Example:
+        ```python
+        >>> from huggingface_hub import HfApi, plan_multi_commits
+        >>> addition_commits, deletion_commits = plan_multi_commits(
+        ...     operations=[
+        ...          CommitOperationAdd(...),
+        ...          CommitOperationAdd(...),
+        ...          CommitOperationDelete(...),
+        ...          CommitOperationDelete(...),
+        ...          CommitOperationAdd(...),
+        ...     ],
+        ... )
+        >>> HfApi().create_commits_on_pr(
+        ...     repo_id="my-cool-model",
+        ...     addition_commits=addition_commits,
+        ...     deletion_commits=deletion_commits,
+        ...     (...)
+        ...     verbose=True,
+        ... )
+        ```
+
+        Raises:
+            [`MultiCommitException`]:
+                If an unexpected issue occur in the process: empty commits, unexpected commits in a PR, unexpected PR
+                description, etc.
+        """
+        logger = logging.get_logger(__name__ + ".create_commits_on_pr")
+        if verbose:
+            logger.setLevel("INFO")
+
+        # 1. Get strategy ID
+        logger.info(
+            f"Will create {len(deletion_commits)} deletion commit(s) and {len(addition_commits)} addition commit(s),"
+            f" totalling {sum(len(ops) for ops in addition_commits+deletion_commits)} atomic operations."
+        )
+        strategy = MultiCommitStrategy(
+            addition_commits=[MultiCommitStep(operations=operations) for operations in addition_commits],  # type: ignore
+            deletion_commits=[MultiCommitStep(operations=operations) for operations in deletion_commits],  # type: ignore
+        )
+        logger.info(f"Multi-commits strategy with ID {strategy.id}.")
+
+        # 2. Get or create a PR with this strategy ID
+        for discussion in self.get_repo_discussions(repo_id=repo_id, repo_type=repo_type, token=token):
+            # search for a draft PR with strategy ID
+            if discussion.is_pull_request and discussion.status == "draft" and strategy.id in discussion.title:
+                pr = self.get_discussion_details(
+                    repo_id=repo_id, discussion_num=discussion.num, repo_type=repo_type, token=token
+                )
+                logger.info(f"PR already exists: {pr.url}. Will resume process where it stopped.")
+                break
+        else:
+            # did not find a PR matching the strategy ID
+            pr = multi_commit_create_pull_request(
+                self,
+                repo_id=repo_id,
+                commit_message=commit_message,
+                commit_description=commit_description,
+                strategy=strategy,
+                token=token,
+                repo_type=repo_type,
+            )
+            logger.info(f"New PR created: {pr.url}")
+
+        # 3. Parse PR description to check consistency with strategy (e.g. same commits are scheduled)
+        for event in pr.events:
+            if isinstance(event, DiscussionComment):
+                pr_comment = event
+                break
+        else:
+            raise MultiCommitException(f"PR #{pr.num} must have at least 1 comment")
+
+        description_commits = multi_commit_parse_pr_description(pr_comment.content)
+        if len(description_commits) != len(strategy.all_steps):
+            raise MultiCommitException(
+                f"Corrupted multi-commit PR #{pr.num}: got {len(description_commits)} steps in"
+                f" description but {len(strategy.all_steps)} in strategy."
+            )
+        for step_id in strategy.all_steps:
+            if step_id not in description_commits:
+                raise MultiCommitException(
+                    f"Corrupted multi-commit PR #{pr.num}: expected step {step_id} but didn't find"
+                    f" it (have {', '.join(description_commits)})."
+                )
+
+        # 4. Retrieve commit history (and check consistency)
+        commits_on_main_branch = {
+            commit.commit_id
+            for commit in self.list_repo_commits(
+                repo_id=repo_id, repo_type=repo_type, token=token, revision=DEFAULT_REVISION
+            )
+        }
+        pr_commits = [
+            commit
+            for commit in self.list_repo_commits(
+                repo_id=repo_id, repo_type=repo_type, token=token, revision=pr.git_reference
+            )
+            if commit.commit_id not in commits_on_main_branch
+        ]
+        if len(pr_commits) > 0:
+            logger.info(f"Found {len(pr_commits)} existing commits on the PR.")
+
+        # At this point `pr_commits` is a list of commits pushed to the PR. We expect all of these commits (if any) to have
+        # a step_id as title. We raise exception if an unexpected commit has been pushed.
+        if len(pr_commits) > len(strategy.all_steps):
+            raise MultiCommitException(
+                f"Corrupted multi-commit PR #{pr.num}: scheduled {len(strategy.all_steps)} steps but"
+                f" {len(pr_commits)} commits have already been pushed to the PR."
+            )
+
+        # Check which steps are already completed
+        remaining_additions = {step.id: step for step in strategy.addition_commits}
+        remaining_deletions = {step.id: step for step in strategy.deletion_commits}
+        for commit in pr_commits:
+            if commit.title in remaining_additions:
+                step = remaining_additions.pop(commit.title)
+                step.completed = True
+            elif commit.title in remaining_deletions:
+                step = remaining_deletions.pop(commit.title)
+                step.completed = True
+
+        if len(remaining_deletions) > 0 and len(remaining_additions) < len(strategy.addition_commits):
+            raise MultiCommitException(
+                f"Corrupted multi-commit PR #{pr.num}: some addition commits have already been pushed to the PR but"
+                " deletion commits are not all completed yet."
+            )
+        nb_remaining = len(remaining_deletions) + len(remaining_additions)
+        if len(pr_commits) > 0:
+            logger.info(
+                f"{nb_remaining} commits remaining ({len(remaining_deletions)} deletion commits and"
+                f" {len(remaining_additions)} addition commits)"
+            )
+
+        # 5. Push remaining commits to the PR + update description
+        # TODO: multi-thread this
+        for step in list(remaining_deletions.values()) + list(remaining_additions.values()):
+            # Push new commit
+            self.create_commit(
+                repo_id=repo_id,
+                repo_type=repo_type,
+                token=token,
+                commit_message=step.id,
+                revision=pr.git_reference,
+                num_threads=num_threads,
+                operations=step.operations,
+                create_pr=False,
+            )
+            step.completed = True
+            nb_remaining -= 1
+            logger.info(f"  step {step.id} completed (still {nb_remaining} to go).")
+
+            # Update PR description
+            self.edit_discussion_comment(
+                repo_id=repo_id,
+                repo_type=repo_type,
+                token=token,
+                discussion_num=pr.num,
+                comment_id=pr_comment.id,
+                new_content=multi_commit_generate_comment(
+                    commit_message=commit_message, commit_description=commit_description, strategy=strategy
+                ),
+            )
+        logger.info("All commits have been pushed.")
+
+        # 6. Update PR (and merge)
+        self.rename_discussion(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            token=token,
+            discussion_num=pr.num,
+            new_title=commit_message,
+        )
+        self.change_discussion_status(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            token=token,
+            discussion_num=pr.num,
+            new_status="open",
+            comment=MULTI_COMMIT_PR_COMPLETION_COMMENT_TEMPLATE,
+        )
+        logger.info("PR is now open for reviews.")
+
+        if merge_pr:  # User don't want a PR => merge it
+            try:
+                self.merge_pull_request(
+                    repo_id=repo_id,
+                    repo_type=repo_type,
+                    token=token,
+                    discussion_num=pr.num,
+                    comment=MULTI_COMMIT_PR_CLOSING_COMMENT_TEMPLATE,
+                )
+                logger.info("PR has been automatically merged (`merge_pr=True` was passed).")
+            except BadRequestError as error:
+                if error.server_message is not None and "no associated changes" in error.server_message:
+                    # PR cannot be merged as no changes are associated. We close the PR without merging with a comment to
+                    # explain.
+                    self.change_discussion_status(
+                        repo_id=repo_id,
+                        repo_type=repo_type,
+                        token=token,
+                        discussion_num=pr.num,
+                        comment=MULTI_COMMIT_PR_CLOSE_COMMENT_FAILURE_NO_CHANGES_TEMPLATE,
+                        new_status="closed",
+                    )
+                    logger.warning("Couldn't merge the PR: no associated changes.")
+                else:
+                    # PR cannot be merged for another reason (conflicting files for example). We comment the PR to explain
+                    # and re-raise the exception.
+                    self.comment_discussion(
+                        repo_id=repo_id,
+                        repo_type=repo_type,
+                        token=token,
+                        discussion_num=pr.num,
+                        comment=MULTI_COMMIT_PR_CLOSE_COMMENT_FAILURE_BAD_REQUEST_TEMPLATE.format(
+                            error_message=error.server_message
+                        ),
+                    )
+                    raise MultiCommitException(
+                        f"Couldn't merge Pull Request in multi-commit: {error.server_message}"
+                    ) from error
+
+        return pr.url
+
+    def preupload_lfs_files(
+        self,
+        repo_id: str,
+        additions: Iterable[CommitOperationAdd],
+        *,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        num_threads: int = 5,
+        free_memory: bool = True,
+        gitignore_content: Optional[str] = None,
+    ):
+        """Pre-upload LFS files to S3 in preparation on a future commit.
+
+        This method is useful if you are generating the files to upload on-the-fly and you don't want to store them
+        in memory before uploading them all at once.
+
+        <Tip warning={true}>
+
+        This is a power-user method. You shouldn't need to call it directly to make a normal commit.
+        Use [`create_commit`] directly instead.
+
+        </Tip>
+
+        <Tip warning={true}>
+
+        Commit operations will be mutated during the process. In particular, the attached `path_or_fileobj` will be
+        removed after the upload to save memory (and replaced by an empty `bytes` object). Do not reuse the same
+        objects except to pass them to [`create_commit`]. If you don't want to remove the attached content from the
+        commit operation object, pass `free_memory=False`.
+
+        </Tip>
+
+        Args:
+            repo_id (`str`):
+                The repository in which you will commit the files, for example: `"username/custom_transformers"`.
+
+            operations (`Iterable` of [`CommitOperationAdd`]):
+                The list of files to upload. Warning: the objects in this list will be mutated to include information
+                relative to the upload. Do not reuse the same objects for multiple commits.
+
+            token (`str`, *optional*):
+                Authentication token. Will default to the stored token.
+
+            repo_type (`str`, *optional*):
+                The type of repository to upload to (e.g. `"model"` -default-, `"dataset"` or `"space"`).
+
+            revision (`str`, *optional*):
+                The git revision to commit from. Defaults to the head of the `"main"` branch.
+
+            create_pr (`boolean`, *optional*):
+                Whether or not you plan to create a Pull Request with that commit. Defaults to `False`.
+
+            num_threads (`int`, *optional*):
+                Number of concurrent threads for uploading files. Defaults to 5.
+                Setting it to 2 means at most 2 files will be uploaded concurrently.
+
+            gitignore_content (`str`, *optional*):
+                The content of the `.gitignore` file to know which files should be ignored. The order of priority
+                is to first check if `gitignore_content` is passed, then check if the `.gitignore` file is present
+                in the list of files to commit and finally default to the `.gitignore` file already hosted on the Hub
+                (if any).
+
+        Example:
+        ```py
+        >>> from huggingface_hub import CommitOperationAdd, preupload_lfs_files, create_commit, create_repo
+
+        >>> repo_id = create_repo("test_preupload").repo_id
+
+        # Generate and preupload LFS files one by one
+        >>> operations = [] # List of all `CommitOperationAdd` objects that will be generated
+        >>> for i in range(5):
+        ...     content = ... # generate binary content
+        ...     addition = CommitOperationAdd(path_in_repo=f"shard_{i}_of_5.bin", path_or_fileobj=content)
+        ...     preupload_lfs_files(repo_id, additions=[addition]) # upload + free memory
+        ...     operations.append(addition)
+
+        # Create commit
+        >>> create_commit(repo_id, operations=operations, commit_message="Commit all shards")
+        ```
+        """
+        repo_type = repo_type if repo_type is not None else REPO_TYPE_MODEL
+        if repo_type not in REPO_TYPES:
+            raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
+        revision = quote(revision, safe="") if revision is not None else DEFAULT_REVISION
+        create_pr = create_pr if create_pr is not None else False
+        headers = self._build_hf_headers(token=token)
+
+        # Check if a `gitignore` file is being committed to the Hub.
+        additions = list(additions)
+        if gitignore_content is None:
+            for addition in additions:
+                if addition.path_in_repo == ".gitignore":
+                    with addition.as_file() as f:
+                        gitignore_content = f.read().decode()
+                        break
+
+        # Filter out already uploaded files
+        new_additions = [addition for addition in additions if not addition._is_uploaded]
+
+        # Check which new files are LFS
+        try:
+            _fetch_upload_modes(
+                additions=new_additions,
+                repo_type=repo_type,
+                repo_id=repo_id,
+                headers=headers,
+                revision=revision,
+                endpoint=self.endpoint,
+                create_pr=create_pr or False,
+                gitignore_content=gitignore_content,
+            )
+        except RepositoryNotFoundError as e:
+            e.append_to_message(_CREATE_COMMIT_NO_REPO_ERROR_MESSAGE)
+            raise
+
+        # Filter out regular files
+        new_lfs_additions = [addition for addition in new_additions if addition._upload_mode == "lfs"]
+
+        # Filter out files listed in .gitignore
+        new_lfs_additions_to_upload = []
+        for addition in new_lfs_additions:
+            if addition._should_ignore:
+                logger.debug(f"Skipping upload for LFS file '{addition.path_in_repo}' (ignored by gitignore file).")
+            else:
+                new_lfs_additions_to_upload.append(addition)
+        if len(new_lfs_additions) != len(new_lfs_additions_to_upload):
+            logger.info(
+                f"Skipped upload for {len(new_lfs_additions) - len(new_lfs_additions_to_upload)} LFS file(s) "
+                "(ignored by gitignore file)."
+            )
+
+        # Upload new LFS files
+        _upload_lfs_files(
+            additions=new_lfs_additions_to_upload,
+            repo_type=repo_type,
+            repo_id=repo_id,
+            headers=headers,
+            endpoint=self.endpoint,
+            num_threads=num_threads,
+            # If `create_pr`, we don't want to check user permission on the revision as users with read permission
+            # should still be able to create PRs even if they don't have write permission on the target branch of the
+            # PR (i.e. `revision`).
+            revision=revision if not create_pr else None,
+        )
+        for addition in new_lfs_additions_to_upload:
+            addition._is_uploaded = True
+            if free_memory:
+                addition.path_or_fileobj = b""
+
+    @overload
+    def upload_file(  # type: ignore
+        self,
+        *,
+        path_or_fileobj: Union[str, Path, bytes, BinaryIO],
+        path_in_repo: str,
+        repo_id: str,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        commit_message: Optional[str] = None,
+        commit_description: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        parent_commit: Optional[str] = None,
+        run_as_future: Literal[False] = ...,
+    ) -> CommitInfo: ...
+
+    @overload
+    def upload_file(
+        self,
+        *,
+        path_or_fileobj: Union[str, Path, bytes, BinaryIO],
+        path_in_repo: str,
+        repo_id: str,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        commit_message: Optional[str] = None,
+        commit_description: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        parent_commit: Optional[str] = None,
+        run_as_future: Literal[True] = ...,
+    ) -> Future[CommitInfo]: ...
+
+    @validate_hf_hub_args
+    @future_compatible
+    def upload_file(
+        self,
+        *,
+        path_or_fileobj: Union[str, Path, bytes, BinaryIO],
+        path_in_repo: str,
+        repo_id: str,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        commit_message: Optional[str] = None,
+        commit_description: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        parent_commit: Optional[str] = None,
+        run_as_future: bool = False,
+    ) -> Union[CommitInfo, Future[CommitInfo]]:
+        """
+        Upload a local file (up to 50 GB) to the given repo. The upload is done
+        through a HTTP post request, and doesn't require git or git-lfs to be
+        installed.
+
+        Args:
+            path_or_fileobj (`str`, `Path`, `bytes`, or `IO`):
+                Path to a file on the local machine or binary data stream /
+                fileobj / buffer.
+            path_in_repo (`str`):
+                Relative filepath in the repo, for example:
+                `"checkpoints/1fec34a/weights.bin"`
+            repo_id (`str`):
+                The repository to which the file will be uploaded, for example:
+                `"username/custom_transformers"`
+            token (`str`, *optional*):
+                Authentication token, obtained with `HfApi.login` method. Will
+                default to the stored token.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+            revision (`str`, *optional*):
+                The git revision to commit from. Defaults to the head of the `"main"` branch.
+            commit_message (`str`, *optional*):
+                The summary / title / first line of the generated commit
+            commit_description (`str` *optional*)
+                The description of the generated commit
+            create_pr (`boolean`, *optional*):
+                Whether or not to create a Pull Request with that commit. Defaults to `False`.
+                If `revision` is not set, PR is opened against the `"main"` branch. If
+                `revision` is set and is a branch, PR is opened against this branch. If
+                `revision` is set and is not a branch name (example: a commit oid), an
+                `RevisionNotFoundError` is returned by the server.
+            parent_commit (`str`, *optional*):
+                The OID / SHA of the parent commit, as a hexadecimal string. Shorthands (7 first characters) are also supported.
+                If specified and `create_pr` is `False`, the commit will fail if `revision` does not point to `parent_commit`.
+                If specified and `create_pr` is `True`, the pull request will be created from `parent_commit`.
+                Specifying `parent_commit` ensures the repo has not changed before committing the changes, and can be
+                especially useful if the repo is updated / committed to concurrently.
+            run_as_future (`bool`, *optional*):
+                Whether or not to run this method in the background. Background jobs are run sequentially without
+                blocking the main thread. Passing `run_as_future=True` will return a [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects)
+                object. Defaults to `False`.
+
+
+        Returns:
+            [`CommitInfo`] or `Future`:
+                Instance of [`CommitInfo`] containing information about the newly created commit (commit hash, commit
+                url, pr url, commit message,...). If `run_as_future=True` is passed, returns a Future object which will
+                contain the result when executed.
+        <Tip>
+
+        Raises the following errors:
+
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+              if the HuggingFace API returned an error
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              if some parameter value is invalid
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+            - [`~utils.RevisionNotFoundError`]
+              If the revision to download from cannot be found.
+
+        </Tip>
+
+        <Tip warning={true}>
+
+        `upload_file` assumes that the repo already exists on the Hub. If you get a
+        Client error 404, please make sure you are authenticated and that `repo_id` and
+        `repo_type` are set correctly. If repo does not exist, create it first using
+        [`~hf_api.create_repo`].
+
+        </Tip>
+
+        Example:
+
+        ```python
+        >>> from huggingface_hub import upload_file
+
+        >>> with open("./local/filepath", "rb") as fobj:
+        ...     upload_file(
+        ...         path_or_fileobj=fileobj,
+        ...         path_in_repo="remote/file/path.h5",
+        ...         repo_id="username/my-dataset",
+        ...         repo_type="dataset",
+        ...         token="my_token",
+        ...     )
+        "https://huggingface.co/datasets/username/my-dataset/blob/main/remote/file/path.h5"
+
+        >>> upload_file(
+        ...     path_or_fileobj=".\\\\local\\\\file\\\\path",
+        ...     path_in_repo="remote/file/path.h5",
+        ...     repo_id="username/my-model",
+        ...     token="my_token",
+        ... )
+        "https://huggingface.co/username/my-model/blob/main/remote/file/path.h5"
+
+        >>> upload_file(
+        ...     path_or_fileobj=".\\\\local\\\\file\\\\path",
+        ...     path_in_repo="remote/file/path.h5",
+        ...     repo_id="username/my-model",
+        ...     token="my_token",
+        ...     create_pr=True,
+        ... )
+        "https://huggingface.co/username/my-model/blob/refs%2Fpr%2F1/remote/file/path.h5"
+        ```
+        """
+        if repo_type not in REPO_TYPES:
+            raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
+
+        commit_message = (
+            commit_message if commit_message is not None else f"Upload {path_in_repo} with huggingface_hub"
+        )
+        operation = CommitOperationAdd(
+            path_or_fileobj=path_or_fileobj,
+            path_in_repo=path_in_repo,
+        )
+
+        commit_info = self.create_commit(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            operations=[operation],
+            commit_message=commit_message,
+            commit_description=commit_description,
+            token=token,
+            revision=revision,
+            create_pr=create_pr,
+            parent_commit=parent_commit,
+        )
+
+        if commit_info.pr_url is not None:
+            revision = quote(_parse_revision_from_pr_url(commit_info.pr_url), safe="")
+        if repo_type in REPO_TYPES_URL_PREFIXES:
+            repo_id = REPO_TYPES_URL_PREFIXES[repo_type] + repo_id
+        revision = revision if revision is not None else DEFAULT_REVISION
+
+        return CommitInfo(
+            commit_url=commit_info.commit_url,
+            commit_message=commit_info.commit_message,
+            commit_description=commit_info.commit_description,
+            oid=commit_info.oid,
+            pr_url=commit_info.pr_url,
+            # Similar to `hf_hub_url` but it's "blob" instead of "resolve"
+            # TODO: remove this in v1.0
+            _url=f"{self.endpoint}/{repo_id}/blob/{revision}/{path_in_repo}",
+        )
+
+    @overload
+    def upload_folder(  # type: ignore
+        self,
+        *,
+        repo_id: str,
+        folder_path: Union[str, Path],
+        path_in_repo: Optional[str] = None,
+        commit_message: Optional[str] = None,
+        commit_description: Optional[str] = None,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        parent_commit: Optional[str] = None,
+        allow_patterns: Optional[Union[List[str], str]] = None,
+        ignore_patterns: Optional[Union[List[str], str]] = None,
+        delete_patterns: Optional[Union[List[str], str]] = None,
+        multi_commits: Literal[False] = ...,
+        multi_commits_verbose: bool = False,
+        run_as_future: Literal[False] = ...,
+    ) -> CommitInfo: ...
+
+    @overload
+    def upload_folder(  # type: ignore
+        self,
+        *,
+        repo_id: str,
+        folder_path: Union[str, Path],
+        path_in_repo: Optional[str] = None,
+        commit_message: Optional[str] = None,
+        commit_description: Optional[str] = None,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        parent_commit: Optional[str] = None,
+        allow_patterns: Optional[Union[List[str], str]] = None,
+        ignore_patterns: Optional[Union[List[str], str]] = None,
+        delete_patterns: Optional[Union[List[str], str]] = None,
+        multi_commits: Literal[True] = ...,
+        multi_commits_verbose: bool = False,
+        run_as_future: Literal[False] = ...,
+    ) -> str:  # Only the PR url in multi-commits mode
+        ...
+
+    @overload
+    def upload_folder(  # type: ignore
+        self,
+        *,
+        repo_id: str,
+        folder_path: Union[str, Path],
+        path_in_repo: Optional[str] = None,
+        commit_message: Optional[str] = None,
+        commit_description: Optional[str] = None,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        parent_commit: Optional[str] = None,
+        allow_patterns: Optional[Union[List[str], str]] = None,
+        ignore_patterns: Optional[Union[List[str], str]] = None,
+        delete_patterns: Optional[Union[List[str], str]] = None,
+        multi_commits: Literal[False] = ...,
+        multi_commits_verbose: bool = False,
+        run_as_future: Literal[True] = ...,
+    ) -> Future[CommitInfo]: ...
+
+    @overload
+    def upload_folder(
+        self,
+        *,
+        repo_id: str,
+        folder_path: Union[str, Path],
+        path_in_repo: Optional[str] = None,
+        commit_message: Optional[str] = None,
+        commit_description: Optional[str] = None,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        parent_commit: Optional[str] = None,
+        allow_patterns: Optional[Union[List[str], str]] = None,
+        ignore_patterns: Optional[Union[List[str], str]] = None,
+        delete_patterns: Optional[Union[List[str], str]] = None,
+        multi_commits: Literal[True] = ...,
+        multi_commits_verbose: bool = False,
+        run_as_future: Literal[True] = ...,
+    ) -> Future[str]:  # Only the PR url in multi-commits mode
+        ...
+
+    @validate_hf_hub_args
+    @future_compatible
+    def upload_folder(
+        self,
+        *,
+        repo_id: str,
+        folder_path: Union[str, Path],
+        path_in_repo: Optional[str] = None,
+        commit_message: Optional[str] = None,
+        commit_description: Optional[str] = None,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        parent_commit: Optional[str] = None,
+        allow_patterns: Optional[Union[List[str], str]] = None,
+        ignore_patterns: Optional[Union[List[str], str]] = None,
+        delete_patterns: Optional[Union[List[str], str]] = None,
+        multi_commits: bool = False,
+        multi_commits_verbose: bool = False,
+        run_as_future: bool = False,
+    ) -> Union[CommitInfo, str, Future[CommitInfo], Future[str]]:
+        """
+        Upload a local folder to the given repo. The upload is done through a HTTP requests, and doesn't require git or
+        git-lfs to be installed.
+
+        The structure of the folder will be preserved. Files with the same name already present in the repository will
+        be overwritten. Others will be left untouched.
+
+        Use the `allow_patterns` and `ignore_patterns` arguments to specify which files to upload. These parameters
+        accept either a single pattern or a list of patterns. Patterns are Standard Wildcards (globbing patterns) as
+        documented [here](https://tldp.org/LDP/GNU-Linux-Tools-Summary/html/x11655.htm). If both `allow_patterns` and
+        `ignore_patterns` are provided, both constraints apply. By default, all files from the folder are uploaded.
+
+        Use the `delete_patterns` argument to specify remote files you want to delete. Input type is the same as for
+        `allow_patterns` (see above). If `path_in_repo` is also provided, the patterns are matched against paths
+        relative to this folder. For example, `upload_folder(..., path_in_repo="experiment", delete_patterns="logs/*")`
+        will delete any remote file under `./experiment/logs/`. Note that the `.gitattributes` file will not be deleted
+        even if it matches the patterns.
+
+        Any `.git/` folder present in any subdirectory will be ignored. However, please be aware that the `.gitignore`
+        file is not taken into account.
+
+        Uses `HfApi.create_commit` under the hood.
+
+        Args:
+            repo_id (`str`):
+                The repository to which the file will be uploaded, for example:
+                `"username/custom_transformers"`
+            folder_path (`str` or `Path`):
+                Path to the folder to upload on the local file system
+            path_in_repo (`str`, *optional*):
+                Relative path of the directory in the repo, for example:
+                `"checkpoints/1fec34a/results"`. Will default to the root folder of the repository.
+            token (`str`, *optional*):
+                Authentication token, obtained with `HfApi.login` method. Will
+                default to the stored token.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+            revision (`str`, *optional*):
+                The git revision to commit from. Defaults to the head of the `"main"` branch.
+            commit_message (`str`, *optional*):
+                The summary / title / first line of the generated commit. Defaults to:
+                `f"Upload {path_in_repo} with huggingface_hub"`
+            commit_description (`str` *optional*):
+                The description of the generated commit
+            create_pr (`boolean`, *optional*):
+                Whether or not to create a Pull Request with that commit. Defaults to `False`. If `revision` is not
+                set, PR is opened against the `"main"` branch. If `revision` is set and is a branch, PR is opened
+                against this branch. If `revision` is set and is not a branch name (example: a commit oid), an
+                `RevisionNotFoundError` is returned by the server. If both `multi_commits` and `create_pr` are True,
+                the PR created in the multi-commit process is kept opened.
+            parent_commit (`str`, *optional*):
+                The OID / SHA of the parent commit, as a hexadecimal string. Shorthands (7 first characters) are also supported.
+                If specified and `create_pr` is `False`, the commit will fail if `revision` does not point to `parent_commit`.
+                If specified and `create_pr` is `True`, the pull request will be created from `parent_commit`.
+                Specifying `parent_commit` ensures the repo has not changed before committing the changes, and can be
+                especially useful if the repo is updated / committed to concurrently.
+            allow_patterns (`List[str]` or `str`, *optional*):
+                If provided, only files matching at least one pattern are uploaded.
+            ignore_patterns (`List[str]` or `str`, *optional*):
+                If provided, files matching any of the patterns are not uploaded.
+            delete_patterns (`List[str]` or `str`, *optional*):
+                If provided, remote files matching any of the patterns will be deleted from the repo while committing
+                new files. This is useful if you don't know which files have already been uploaded.
+                Note: to avoid discrepancies the `.gitattributes` file is not deleted even if it matches the pattern.
+            multi_commits (`bool`):
+                If True, changes are pushed to a PR using a multi-commit process. Defaults to `False`.
+            multi_commits_verbose (`bool`):
+                If True and `multi_commits` is used, more information will be displayed to the user.
+            run_as_future (`bool`, *optional*):
+                Whether or not to run this method in the background. Background jobs are run sequentially without
+                blocking the main thread. Passing `run_as_future=True` will return a [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects)
+                object. Defaults to `False`.
+
+        Returns:
+            [`CommitInfo`] or `Future`:
+                Instance of [`CommitInfo`] containing information about the newly created commit (commit hash, commit
+                url, pr url, commit message,...). If `run_as_future=True` is passed, returns a Future object which will
+                contain the result when executed.
+            [`str`] or `Future`:
+                If `multi_commits=True`, returns the url of the PR created to push the changes. If `run_as_future=True`
+                is passed, returns a Future object which will contain the result when executed.
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+            if the HuggingFace API returned an error
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            if some parameter value is invalid
+
+        </Tip>
+
+        <Tip warning={true}>
+
+        `upload_folder` assumes that the repo already exists on the Hub. If you get a Client error 404, please make
+        sure you are authenticated and that `repo_id` and `repo_type` are set correctly. If repo does not exist, create
+        it first using [`~hf_api.create_repo`].
+
+        </Tip>
+
+        <Tip warning={true}>
+
+        `multi_commits` is experimental. Its API and behavior is subject to change in the future without prior notice.
+
+        </Tip>
+
+        Example:
+
+        ```python
+        # Upload checkpoints folder except the log files
+        >>> upload_folder(
+        ...     folder_path="local/checkpoints",
+        ...     path_in_repo="remote/experiment/checkpoints",
+        ...     repo_id="username/my-dataset",
+        ...     repo_type="datasets",
+        ...     token="my_token",
+        ...     ignore_patterns="**/logs/*.txt",
+        ... )
+        # "https://huggingface.co/datasets/username/my-dataset/tree/main/remote/experiment/checkpoints"
+
+        # Upload checkpoints folder including logs while deleting existing logs from the repo
+        # Useful if you don't know exactly which log files have already being pushed
+        >>> upload_folder(
+        ...     folder_path="local/checkpoints",
+        ...     path_in_repo="remote/experiment/checkpoints",
+        ...     repo_id="username/my-dataset",
+        ...     repo_type="datasets",
+        ...     token="my_token",
+        ...     delete_patterns="**/logs/*.txt",
+        ... )
+        "https://huggingface.co/datasets/username/my-dataset/tree/main/remote/experiment/checkpoints"
+
+        # Upload checkpoints folder while creating a PR
+        >>> upload_folder(
+        ...     folder_path="local/checkpoints",
+        ...     path_in_repo="remote/experiment/checkpoints",
+        ...     repo_id="username/my-dataset",
+        ...     repo_type="datasets",
+        ...     token="my_token",
+        ...     create_pr=True,
+        ... )
+        "https://huggingface.co/datasets/username/my-dataset/tree/refs%2Fpr%2F1/remote/experiment/checkpoints"
+
+        ```
+        """
+        if repo_type not in REPO_TYPES:
+            raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
+
+        if multi_commits:
+            if revision is not None and revision != DEFAULT_REVISION:
+                raise ValueError("Cannot use `multi_commit` to commit changes other than the main branch.")
+
+        # By default, upload folder to the root directory in repo.
+        if path_in_repo is None:
+            path_in_repo = ""
+
+        # Do not upload .git folder
+        if ignore_patterns is None:
+            ignore_patterns = []
+        elif isinstance(ignore_patterns, str):
+            ignore_patterns = [ignore_patterns]
+        ignore_patterns += IGNORE_GIT_FOLDER_PATTERNS
+
+        delete_operations = self._prepare_upload_folder_deletions(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            revision=DEFAULT_REVISION if create_pr else revision,
+            token=token,
+            path_in_repo=path_in_repo,
+            delete_patterns=delete_patterns,
+        )
+        add_operations = _prepare_upload_folder_additions(
+            folder_path,
+            path_in_repo,
+            allow_patterns=allow_patterns,
+            ignore_patterns=ignore_patterns,
+        )
+
+        # Optimize operations: if some files will be overwritten, we don't need to delete them first
+        if len(add_operations) > 0:
+            added_paths = set(op.path_in_repo for op in add_operations)
+            delete_operations = [
+                delete_op for delete_op in delete_operations if delete_op.path_in_repo not in added_paths
+            ]
+        commit_operations = delete_operations + add_operations
+
+        commit_message = commit_message or "Upload folder using huggingface_hub"
+        if multi_commits:
+            addition_commits, deletion_commits = plan_multi_commits(operations=commit_operations)
+            pr_url = self.create_commits_on_pr(
+                repo_id=repo_id,
+                repo_type=repo_type,
+                addition_commits=addition_commits,
+                deletion_commits=deletion_commits,
+                commit_message=commit_message,
+                commit_description=commit_description,
+                token=token,
+                merge_pr=not create_pr,
+                verbose=multi_commits_verbose,
+            )
+            # Defining a CommitInfo object is not really relevant in this case
+            # Let's return early with pr_url only (as string).
+            return pr_url
+
+        commit_info = self.create_commit(
+            repo_type=repo_type,
+            repo_id=repo_id,
+            operations=commit_operations,
+            commit_message=commit_message,
+            commit_description=commit_description,
+            token=token,
+            revision=revision,
+            create_pr=create_pr,
+            parent_commit=parent_commit,
+        )
+
+        # Create url to uploaded folder (for legacy return value)
+        if create_pr and commit_info.pr_url is not None:
+            revision = quote(_parse_revision_from_pr_url(commit_info.pr_url), safe="")
+        if repo_type in REPO_TYPES_URL_PREFIXES:
+            repo_id = REPO_TYPES_URL_PREFIXES[repo_type] + repo_id
+        revision = revision if revision is not None else DEFAULT_REVISION
+
+        return CommitInfo(
+            commit_url=commit_info.commit_url,
+            commit_message=commit_info.commit_message,
+            commit_description=commit_info.commit_description,
+            oid=commit_info.oid,
+            pr_url=commit_info.pr_url,
+            # Similar to `hf_hub_url` but it's "tree" instead of "resolve"
+            # TODO: remove this in v1.0
+            _url=f"{self.endpoint}/{repo_id}/tree/{revision}/{path_in_repo}",
+        )
+
+    @validate_hf_hub_args
+    def delete_file(
+        self,
+        path_in_repo: str,
+        repo_id: str,
+        *,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        commit_message: Optional[str] = None,
+        commit_description: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        parent_commit: Optional[str] = None,
+    ) -> CommitInfo:
+        """
+        Deletes a file in the given repo.
+
+        Args:
+            path_in_repo (`str`):
+                Relative filepath in the repo, for example:
+                `"checkpoints/1fec34a/weights.bin"`
+            repo_id (`str`):
+                The repository from which the file will be deleted, for example:
+                `"username/custom_transformers"`
+            token (`str`, *optional*):
+                Authentication token, obtained with `HfApi.login` method. Will
+                default to the stored token.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if the file is in a dataset or
+                space, `None` or `"model"` if in a model. Default is `None`.
+            revision (`str`, *optional*):
+                The git revision to commit from. Defaults to the head of the `"main"` branch.
+            commit_message (`str`, *optional*):
+                The summary / title / first line of the generated commit. Defaults to
+                `f"Delete {path_in_repo} with huggingface_hub"`.
+            commit_description (`str` *optional*)
+                The description of the generated commit
+            create_pr (`boolean`, *optional*):
+                Whether or not to create a Pull Request with that commit. Defaults to `False`.
+                If `revision` is not set, PR is opened against the `"main"` branch. If
+                `revision` is set and is a branch, PR is opened against this branch. If
+                `revision` is set and is not a branch name (example: a commit oid), an
+                `RevisionNotFoundError` is returned by the server.
+            parent_commit (`str`, *optional*):
+                The OID / SHA of the parent commit, as a hexadecimal string. Shorthands (7 first characters) are also supported.
+                If specified and `create_pr` is `False`, the commit will fail if `revision` does not point to `parent_commit`.
+                If specified and `create_pr` is `True`, the pull request will be created from `parent_commit`.
+                Specifying `parent_commit` ensures the repo has not changed before committing the changes, and can be
+                especially useful if the repo is updated / committed to concurrently.
+
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+              if the HuggingFace API returned an error
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              if some parameter value is invalid
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+            - [`~utils.RevisionNotFoundError`]
+              If the revision to download from cannot be found.
+            - [`~utils.EntryNotFoundError`]
+              If the file to download cannot be found.
+
+        </Tip>
+
+        """
+        commit_message = (
+            commit_message if commit_message is not None else f"Delete {path_in_repo} with huggingface_hub"
+        )
+
+        operations = [CommitOperationDelete(path_in_repo=path_in_repo)]
+
+        return self.create_commit(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            token=token,
+            operations=operations,
+            revision=revision,
+            commit_message=commit_message,
+            commit_description=commit_description,
+            create_pr=create_pr,
+            parent_commit=parent_commit,
+        )
+
+    @validate_hf_hub_args
+    def delete_folder(
+        self,
+        path_in_repo: str,
+        repo_id: str,
+        *,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        commit_message: Optional[str] = None,
+        commit_description: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        parent_commit: Optional[str] = None,
+    ) -> CommitInfo:
+        """
+        Deletes a folder in the given repo.
+
+        Simple wrapper around [`create_commit`] method.
+
+        Args:
+            path_in_repo (`str`):
+                Relative folder path in the repo, for example: `"checkpoints/1fec34a"`.
+            repo_id (`str`):
+                The repository from which the folder will be deleted, for example:
+                `"username/custom_transformers"`
+            token (`str`, *optional*):
+                Authentication token, obtained with `HfApi.login` method. Will default
+                to the stored token.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if the folder is in a dataset or
+                space, `None` or `"model"` if in a model. Default is `None`.
+            revision (`str`, *optional*):
+                The git revision to commit from. Defaults to the head of the `"main"` branch.
+            commit_message (`str`, *optional*):
+                The summary / title / first line of the generated commit. Defaults to
+                `f"Delete folder {path_in_repo} with huggingface_hub"`.
+            commit_description (`str` *optional*)
+                The description of the generated commit.
+            create_pr (`boolean`, *optional*):
+                Whether or not to create a Pull Request with that commit. Defaults to `False`.
+                If `revision` is not set, PR is opened against the `"main"` branch. If
+                `revision` is set and is a branch, PR is opened against this branch. If
+                `revision` is set and is not a branch name (example: a commit oid), an
+                `RevisionNotFoundError` is returned by the server.
+            parent_commit (`str`, *optional*):
+                The OID / SHA of the parent commit, as a hexadecimal string. Shorthands (7 first characters) are also supported.
+                If specified and `create_pr` is `False`, the commit will fail if `revision` does not point to `parent_commit`.
+                If specified and `create_pr` is `True`, the pull request will be created from `parent_commit`.
+                Specifying `parent_commit` ensures the repo has not changed before committing the changes, and can be
+                especially useful if the repo is updated / committed to concurrently.
+        """
+        return self.create_commit(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            token=token,
+            operations=[CommitOperationDelete(path_in_repo=path_in_repo, is_folder=True)],
+            revision=revision,
+            commit_message=(
+                commit_message if commit_message is not None else f"Delete folder {path_in_repo} with huggingface_hub"
+            ),
+            commit_description=commit_description,
+            create_pr=create_pr,
+            parent_commit=parent_commit,
+        )
+
+    @validate_hf_hub_args
+    def get_hf_file_metadata(
+        self,
+        *,
+        url: str,
+        token: Union[bool, str, None] = None,
+        proxies: Optional[Dict] = None,
+        timeout: Optional[float] = DEFAULT_REQUEST_TIMEOUT,
+    ) -> HfFileMetadata:
+        """Fetch metadata of a file versioned on the Hub for a given url.
+
+        Args:
+            url (`str`):
+                File url, for example returned by [`hf_hub_url`].
+            token (`str` or `bool`, *optional*):
+                A token to be used for the download.
+                    - If `True`, the token is read from the HuggingFace config
+                    folder.
+                    - If `False` or `None`, no token is provided.
+                    - If a string, it's used as the authentication token.
+            proxies (`dict`, *optional*):
+                Dictionary mapping protocol to the URL of the proxy passed to `requests.request`.
+            timeout (`float`, *optional*, defaults to 10):
+                How many seconds to wait for the server to send metadata before giving up.
+
+        Returns:
+            A [`HfFileMetadata`] object containing metadata such as location, etag, size and commit_hash.
+        """
+        if token is None:
+            # Cannot do `token = token or self.token` as token can be `False`.
+            token = self.token
+
+        return get_hf_file_metadata(
+            url=url,
+            token=token,
+            proxies=proxies,
+            timeout=timeout,
+            library_name=self.library_name,
+            library_version=self.library_version,
+            user_agent=self.user_agent,
+        )
+
+    @validate_hf_hub_args
+    def hf_hub_download(
+        self,
+        repo_id: str,
+        filename: str,
+        *,
+        subfolder: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        cache_dir: Union[str, Path, None] = None,
+        local_dir: Union[str, Path, None] = None,
+        local_dir_use_symlinks: Union[bool, Literal["auto"]] = "auto",
+        force_download: bool = False,
+        force_filename: Optional[str] = None,
+        proxies: Optional[Dict] = None,
+        etag_timeout: float = DEFAULT_ETAG_TIMEOUT,
+        resume_download: bool = False,
+        token: Optional[Union[str, bool]] = None,
+        local_files_only: bool = False,
+        legacy_cache_layout: bool = False,
+    ) -> str:
+        """Download a given file if it's not already present in the local cache.
+
+        The new cache file layout looks like this:
+        - The cache directory contains one subfolder per repo_id (namespaced by repo type)
+        - inside each repo folder:
+            - refs is a list of the latest known revision => commit_hash pairs
+            - blobs contains the actual file blobs (identified by their git-sha or sha256, depending on
+            whether they're LFS files or not)
+            - snapshots contains one subfolder per commit, each "commit" contains the subset of the files
+            that have been resolved at that particular commit. Each filename is a symlink to the blob
+            at that particular commit.
+
+        If `local_dir` is provided, the file structure from the repo will be replicated in this location. You can configure
+        how you want to move those files:
+        - If `local_dir_use_symlinks="auto"` (default), files are downloaded and stored in the cache directory as blob
+            files. Small files (<5MB) are duplicated in `local_dir` while a symlink is created for bigger files. The goal
+            is to be able to manually edit and save small files without corrupting the cache while saving disk space for
+            binary files. The 5MB threshold can be configured with the `HF_HUB_LOCAL_DIR_AUTO_SYMLINK_THRESHOLD`
+            environment variable.
+        - If `local_dir_use_symlinks=True`, files are downloaded, stored in the cache directory and symlinked in `local_dir`.
+            This is optimal in term of disk usage but files must not be manually edited.
+        - If `local_dir_use_symlinks=False` and the blob files exist in the cache directory, they are duplicated in the
+            local dir. This means disk usage is not optimized.
+        - Finally, if `local_dir_use_symlinks=False` and the blob files do not exist in the cache directory, then the
+            files are downloaded and directly placed under `local_dir`. This means if you need to download them again later,
+            they will be re-downloaded entirely.
+
+        ```
+        [  96]  .
+        └── [ 160]  models--julien-c--EsperBERTo-small
+            ├── [ 160]  blobs
+            │   ├── [321M]  403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
+            │   ├── [ 398]  7cb18dc9bafbfcf74629a4b760af1b160957a83e
+            │   └── [1.4K]  d7edf6bd2a681fb0175f7735299831ee1b22b812
+            ├── [  96]  refs
+            │   └── [  40]  main
+            └── [ 128]  snapshots
+                ├── [ 128]  2439f60ef33a0d46d85da5001d52aeda5b00ce9f
+                │   ├── [  52]  README.md -> ../../blobs/d7edf6bd2a681fb0175f7735299831ee1b22b812
+                │   └── [  76]  pytorch_model.bin -> ../../blobs/403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
+                └── [ 128]  bbc77c8132af1cc5cf678da3f1ddf2de43606d48
+                    ├── [  52]  README.md -> ../../blobs/7cb18dc9bafbfcf74629a4b760af1b160957a83e
+                    └── [  76]  pytorch_model.bin -> ../../blobs/403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
+        ```
+
+        Args:
+            repo_id (`str`):
+                A user or an organization name and a repo name separated by a `/`.
+            filename (`str`):
+                The name of the file in the repo.
+            subfolder (`str`, *optional*):
+                An optional value corresponding to a folder inside the model repo.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if downloading from a dataset or space,
+                `None` or `"model"` if downloading from a model. Default is `None`.
+            revision (`str`, *optional*):
+                An optional Git revision id which can be a branch name, a tag, or a
+                commit hash.
+            cache_dir (`str`, `Path`, *optional*):
+                Path to the folder where cached files are stored.
+            local_dir (`str` or `Path`, *optional*):
+                If provided, the downloaded file will be placed under this directory, either as a symlink (default) or
+                a regular file (see description for more details).
+            local_dir_use_symlinks (`"auto"` or `bool`, defaults to `"auto"`):
+                To be used with `local_dir`. If set to "auto", the cache directory will be used and the file will be either
+                duplicated or symlinked to the local directory depending on its size. It set to `True`, a symlink will be
+                created, no matter the file size. If set to `False`, the file will either be duplicated from cache (if
+                already exists) or downloaded from the Hub and not cached. See description for more details.
+            force_download (`bool`, *optional*, defaults to `False`):
+                Whether the file should be downloaded even if it already exists in
+                the local cache.
+            proxies (`dict`, *optional*):
+                Dictionary mapping protocol to the URL of the proxy passed to
+                `requests.request`.
+            etag_timeout (`float`, *optional*, defaults to `10`):
+                When fetching ETag, how many seconds to wait for the server to send
+                data before giving up which is passed to `requests.request`.
+            resume_download (`bool`, *optional*, defaults to `False`):
+                If `True`, resume a previously interrupted download.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+            local_files_only (`bool`, *optional*, defaults to `False`):
+                If `True`, avoid downloading the file and return the path to the
+                local cached file if it exists.
+            legacy_cache_layout (`bool`, *optional*, defaults to `False`):
+                If `True`, uses the legacy file cache layout i.e. just call [`hf_hub_url`]
+                then `cached_download`. This is deprecated as the new cache layout is
+                more powerful.
+
+        Returns:
+            Local path (string) of file or if networking is off, last version of
+            file cached on disk.
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError)
+            if `token=True` and the token cannot be found.
+            - [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError)
+            if ETag cannot be determined.
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            if some parameter value is invalid
+            - [`~utils.RepositoryNotFoundError`]
+            If the repository to download from cannot be found. This may be because it doesn't exist,
+            or because it is set to `private` and you do not have access.
+            - [`~utils.RevisionNotFoundError`]
+            If the revision to download from cannot be found.
+            - [`~utils.EntryNotFoundError`]
+            If the file to download cannot be found.
+            - [`~utils.LocalEntryNotFoundError`]
+            If network is disabled or unavailable and file is not found in cache.
+
+        </Tip>
+        """
+        from .file_download import hf_hub_download
+
+        if token is None:
+            # Cannot do `token = token or self.token` as token can be `False`.
+            token = self.token
+
+        return hf_hub_download(
+            repo_id=repo_id,
+            filename=filename,
+            subfolder=subfolder,
+            repo_type=repo_type,
+            revision=revision,
+            endpoint=self.endpoint,
+            library_name=self.library_name,
+            library_version=self.library_version,
+            cache_dir=cache_dir,
+            local_dir=local_dir,
+            local_dir_use_symlinks=local_dir_use_symlinks,
+            user_agent=self.user_agent,
+            force_download=force_download,
+            force_filename=force_filename,
+            proxies=proxies,
+            etag_timeout=etag_timeout,
+            resume_download=resume_download,
+            token=token,
+            headers=self.headers,
+            local_files_only=local_files_only,
+            legacy_cache_layout=legacy_cache_layout,
+        )
+
+    @validate_hf_hub_args
+    def snapshot_download(
+        self,
+        repo_id: str,
+        *,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        cache_dir: Union[str, Path, None] = None,
+        local_dir: Union[str, Path, None] = None,
+        local_dir_use_symlinks: Union[bool, Literal["auto"]] = "auto",
+        proxies: Optional[Dict] = None,
+        etag_timeout: float = DEFAULT_ETAG_TIMEOUT,
+        resume_download: bool = False,
+        force_download: bool = False,
+        token: Optional[Union[str, bool]] = None,
+        local_files_only: bool = False,
+        allow_patterns: Optional[Union[List[str], str]] = None,
+        ignore_patterns: Optional[Union[List[str], str]] = None,
+        max_workers: int = 8,
+        tqdm_class: Optional[base_tqdm] = None,
+    ) -> str:
+        """Download repo files.
+
+        Download a whole snapshot of a repo's files at the specified revision. This is useful when you want all files from
+        a repo, because you don't know which ones you will need a priori. All files are nested inside a folder in order
+        to keep their actual filename relative to that folder. You can also filter which files to download using
+        `allow_patterns` and `ignore_patterns`.
+
+        If `local_dir` is provided, the file structure from the repo will be replicated in this location. You can configure
+        how you want to move those files:
+        - If `local_dir_use_symlinks="auto"` (default), files are downloaded and stored in the cache directory as blob
+            files. Small files (<5MB) are duplicated in `local_dir` while a symlink is created for bigger files. The goal
+            is to be able to manually edit and save small files without corrupting the cache while saving disk space for
+            binary files. The 5MB threshold can be configured with the `HF_HUB_LOCAL_DIR_AUTO_SYMLINK_THRESHOLD`
+            environment variable.
+        - If `local_dir_use_symlinks=True`, files are downloaded, stored in the cache directory and symlinked in `local_dir`.
+            This is optimal in term of disk usage but files must not be manually edited.
+        - If `local_dir_use_symlinks=False` and the blob files exist in the cache directory, they are duplicated in the
+            local dir. This means disk usage is not optimized.
+        - Finally, if `local_dir_use_symlinks=False` and the blob files do not exist in the cache directory, then the
+            files are downloaded and directly placed under `local_dir`. This means if you need to download them again later,
+            they will be re-downloaded entirely.
+
+        An alternative would be to clone the repo but this requires git and git-lfs to be installed and properly
+        configured. It is also not possible to filter which files to download when cloning a repository using git.
+
+        Args:
+            repo_id (`str`):
+                A user or an organization name and a repo name separated by a `/`.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if downloading from a dataset or space,
+                `None` or `"model"` if downloading from a model. Default is `None`.
+            revision (`str`, *optional*):
+                An optional Git revision id which can be a branch name, a tag, or a
+                commit hash.
+            cache_dir (`str`, `Path`, *optional*):
+                Path to the folder where cached files are stored.
+            local_dir (`str` or `Path`, *optional*):
+                If provided, the downloaded files will be placed under this directory, either as symlinks (default) or
+                regular files (see description for more details).
+            local_dir_use_symlinks (`"auto"` or `bool`, defaults to `"auto"`):
+                To be used with `local_dir`. If set to "auto", the cache directory will be used and the file will be either
+                duplicated or symlinked to the local directory depending on its size. It set to `True`, a symlink will be
+                created, no matter the file size. If set to `False`, the file will either be duplicated from cache (if
+                already exists) or downloaded from the Hub and not cached. See description for more details.
+            proxies (`dict`, *optional*):
+                Dictionary mapping protocol to the URL of the proxy passed to
+                `requests.request`.
+            etag_timeout (`float`, *optional*, defaults to `10`):
+                When fetching ETag, how many seconds to wait for the server to send
+                data before giving up which is passed to `requests.request`.
+            resume_download (`bool`, *optional*, defaults to `False):
+                If `True`, resume a previously interrupted download.
+            force_download (`bool`, *optional*, defaults to `False`):
+                Whether the file should be downloaded even if it already exists in the local cache.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+            local_files_only (`bool`, *optional*, defaults to `False`):
+                If `True`, avoid downloading the file and return the path to the
+                local cached file if it exists.
+            allow_patterns (`List[str]` or `str`, *optional*):
+                If provided, only files matching at least one pattern are downloaded.
+            ignore_patterns (`List[str]` or `str`, *optional*):
+                If provided, files matching any of the patterns are not downloaded.
+            max_workers (`int`, *optional*):
+                Number of concurrent threads to download files (1 thread = 1 file download).
+                Defaults to 8.
+            tqdm_class (`tqdm`, *optional*):
+                If provided, overwrites the default behavior for the progress bar. Passed
+                argument must inherit from `tqdm.auto.tqdm` or at least mimic its behavior.
+                Note that the `tqdm_class` is not passed to each individual download.
+                Defaults to the custom HF progress bar that can be disabled by setting
+                `HF_HUB_DISABLE_PROGRESS_BARS` environment variable.
+
+        Returns:
+            Local folder path (string) of repo snapshot
+
+        <Tip>
+
+        Raises the following errors:
+
+        - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError)
+        if `token=True` and the token cannot be found.
+        - [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError) if
+        ETag cannot be determined.
+        - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+        if some parameter value is invalid
+
+        </Tip>
+        """
+        from ._snapshot_download import snapshot_download
+
+        if token is None:
+            # Cannot do `token = token or self.token` as token can be `False`.
+            token = self.token
+
+        return snapshot_download(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            revision=revision,
+            endpoint=self.endpoint,
+            cache_dir=cache_dir,
+            local_dir=local_dir,
+            local_dir_use_symlinks=local_dir_use_symlinks,
+            library_name=self.library_name,
+            library_version=self.library_version,
+            user_agent=self.user_agent,
+            proxies=proxies,
+            etag_timeout=etag_timeout,
+            resume_download=resume_download,
+            force_download=force_download,
+            token=token,
+            local_files_only=local_files_only,
+            allow_patterns=allow_patterns,
+            ignore_patterns=ignore_patterns,
+            max_workers=max_workers,
+            tqdm_class=tqdm_class,
+        )
+
+    def get_safetensors_metadata(
+        self,
+        repo_id: str,
+        *,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        token: Optional[str] = None,
+    ) -> SafetensorsRepoMetadata:
+        """
+        Parse metadata for a safetensors repo on the Hub.
+
+        We first check if the repo has a single safetensors file or a sharded safetensors repo. If it's a single
+        safetensors file, we parse the metadata from this file. If it's a sharded safetensors repo, we parse the
+        metadata from the index file and then parse the metadata from each shard.
+
+        To parse metadata from a single safetensors file, use [`parse_safetensors_file_metadata`].
+
+        For more details regarding the safetensors format, check out https://huggingface.co/docs/safetensors/index#format.
+
+        Args:
+            repo_id (`str`):
+                A user or an organization name and a repo name separated by a `/`.
+            filename (`str`):
+                The name of the file in the repo.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if the file is in a dataset or space, `None` or `"model"` if in a
+                model. Default is `None`.
+            revision (`str`, *optional*):
+                The git revision to fetch the file from. Can be a branch name, a tag, or a commit hash. Defaults to the
+                head of the `"main"` branch.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
+                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
+                retrieved from the cache. If `False`, token is not sent in the request header.
+
+        Returns:
+            [`SafetensorsRepoMetadata`]: information related to safetensors repo.
+
+        Raises:
+            - [`NotASafetensorsRepoError`]: if the repo is not a safetensors repo i.e. doesn't have either a
+              `model.safetensors` or a `model.safetensors.index.json` file.
+            - [`SafetensorsParsingError`]: if a safetensors file header couldn't be parsed correctly.
+
+        Example:
+            ```py
+            # Parse repo with single weights file
+            >>> metadata = get_safetensors_metadata("bigscience/bloomz-560m")
+            >>> metadata
+            SafetensorsRepoMetadata(
+                metadata=None,
+                sharded=False,
+                weight_map={'h.0.input_layernorm.bias': 'model.safetensors', ...},
+                files_metadata={'model.safetensors': SafetensorsFileMetadata(...)}
+            )
+            >>> metadata.files_metadata["model.safetensors"].metadata
+            {'format': 'pt'}
+
+            # Parse repo with sharded model
+            >>> metadata = get_safetensors_metadata("bigscience/bloom")
+            Parse safetensors files: 100%|██████████████████████████████████████████| 72/72 [00:12<00:00,  5.78it/s]
+            >>> metadata
+            SafetensorsRepoMetadata(metadata={'total_size': 352494542848}, sharded=True, weight_map={...}, files_metadata={...})
+            >>> len(metadata.files_metadata)
+            72  # All safetensors files have been fetched
+
+            # Parse repo with sharded model
+            >>> get_safetensors_metadata("runwayml/stable-diffusion-v1-5")
+            NotASafetensorsRepoError: 'runwayml/stable-diffusion-v1-5' is not a safetensors repo. Couldn't find 'model.safetensors.index.json' or 'model.safetensors' files.
+            ```
+        """
+        if self.file_exists(  # Single safetensors file => non-sharded model
+            repo_id=repo_id, filename=SAFETENSORS_SINGLE_FILE, repo_type=repo_type, revision=revision, token=token
+        ):
+            file_metadata = self.parse_safetensors_file_metadata(
+                repo_id=repo_id, filename=SAFETENSORS_SINGLE_FILE, repo_type=repo_type, revision=revision, token=token
+            )
+            return SafetensorsRepoMetadata(
+                metadata=None,
+                sharded=False,
+                weight_map={tensor_name: SAFETENSORS_SINGLE_FILE for tensor_name in file_metadata.tensors.keys()},
+                files_metadata={SAFETENSORS_SINGLE_FILE: file_metadata},
+            )
+        elif self.file_exists(  # Multiple safetensors files => sharded with index
+            repo_id=repo_id, filename=SAFETENSORS_INDEX_FILE, repo_type=repo_type, revision=revision, token=token
+        ):
+            # Fetch index
+            index_file = self.hf_hub_download(
+                repo_id=repo_id, filename=SAFETENSORS_INDEX_FILE, repo_type=repo_type, revision=revision, token=token
+            )
+            with open(index_file) as f:
+                index = json.load(f)
+
+            weight_map = index.get("weight_map", {})
+
+            # Fetch metadata per shard
+            files_metadata = {}
+
+            def _parse(filename: str) -> None:
+                files_metadata[filename] = self.parse_safetensors_file_metadata(
+                    repo_id=repo_id, filename=filename, repo_type=repo_type, revision=revision, token=token
+                )
+
+            thread_map(
+                _parse,
+                set(weight_map.values()),
+                desc="Parse safetensors files",
+                tqdm_class=hf_tqdm,
+            )
+
+            return SafetensorsRepoMetadata(
+                metadata=index.get("metadata", None),
+                sharded=True,
+                weight_map=weight_map,
+                files_metadata=files_metadata,
+            )
+        else:
+            # Not a safetensors repo
+            raise NotASafetensorsRepoError(
+                f"'{repo_id}' is not a safetensors repo. Couldn't find '{SAFETENSORS_INDEX_FILE}' or '{SAFETENSORS_SINGLE_FILE}' files."
+            )
+
+    def parse_safetensors_file_metadata(
+        self,
+        repo_id: str,
+        filename: str,
+        *,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        token: Optional[str] = None,
+    ) -> SafetensorsFileMetadata:
+        """
+        Parse metadata from a safetensors file on the Hub.
+
+        To parse metadata from all safetensors files in a repo at once, use [`get_safetensors_metadata`].
+
+        For more details regarding the safetensors format, check out https://huggingface.co/docs/safetensors/index#format.
+
+        Args:
+            repo_id (`str`):
+                A user or an organization name and a repo name separated by a `/`.
+            filename (`str`):
+                The name of the file in the repo.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if the file is in a dataset or space, `None` or `"model"` if in a
+                model. Default is `None`.
+            revision (`str`, *optional*):
+                The git revision to fetch the file from. Can be a branch name, a tag, or a commit hash. Defaults to the
+                head of the `"main"` branch.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
+                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
+                retrieved from the cache. If `False`, token is not sent in the request header.
+
+        Returns:
+            [`SafetensorsFileMetadata`]: information related to a safetensors file.
+
+        Raises:
+            - [`NotASafetensorsRepoError`]: if the repo is not a safetensors repo i.e. doesn't have either a
+              `model.safetensors` or a `model.safetensors.index.json` file.
+            - [`SafetensorsParsingError`]: if a safetensors file header couldn't be parsed correctly.
+        """
+        url = hf_hub_url(
+            repo_id=repo_id, filename=filename, repo_type=repo_type, revision=revision, endpoint=self.endpoint
+        )
+        _headers = self._build_hf_headers(token=token)
+
+        # 1. Fetch first 100kb
+        # Empirically, 97% of safetensors files have a metadata size < 100kb (over the top 1000 models on the Hub).
+        # We assume fetching 100kb is faster than making 2 GET requests. Therefore we always fetch the first 100kb to
+        # avoid the 2nd GET in most cases.
+        # See https://github.com/huggingface/huggingface_hub/pull/1855#discussion_r1404286419.
+        response = get_session().get(url, headers={**_headers, "range": "bytes=0-100000"})
+        hf_raise_for_status(response)
+
+        # 2. Parse metadata size
+        metadata_size = struct.unpack("<Q", response.content[:8])[0]
+        if metadata_size > SAFETENSORS_MAX_HEADER_LENGTH:
+            raise SafetensorsParsingError(
+                f"Failed to parse safetensors header for '{filename}' (repo '{repo_id}', revision "
+                f"'{revision or DEFAULT_REVISION}'): safetensors header is too big. Maximum supported size is "
+                f"{SAFETENSORS_MAX_HEADER_LENGTH} bytes (got {metadata_size})."
+            )
+
+        # 3.a. Get metadata from payload
+        if metadata_size <= 100000:
+            metadata_as_bytes = response.content[8 : 8 + metadata_size]
+        else:  # 3.b. Request full metadata
+            response = get_session().get(url, headers={**_headers, "range": f"bytes=8-{metadata_size+7}"})
+            hf_raise_for_status(response)
+            metadata_as_bytes = response.content
+
+        # 4. Parse json header
+        try:
+            metadata_as_dict = json.loads(metadata_as_bytes.decode(errors="ignore"))
+        except json.JSONDecodeError as e:
+            raise SafetensorsParsingError(
+                f"Failed to parse safetensors header for '{filename}' (repo '{repo_id}', revision "
+                f"'{revision or DEFAULT_REVISION}'): header is not json-encoded string. Please make sure this is a "
+                "correctly formatted safetensors file."
+            ) from e
+
+        try:
+            return SafetensorsFileMetadata(
+                metadata=metadata_as_dict.get("__metadata__", {}),
+                tensors={
+                    key: TensorInfo(
+                        dtype=tensor["dtype"],
+                        shape=tensor["shape"],
+                        data_offsets=tuple(tensor["data_offsets"]),  # type: ignore
+                    )
+                    for key, tensor in metadata_as_dict.items()
+                    if key != "__metadata__"
+                },
+            )
+        except (KeyError, IndexError) as e:
+            raise SafetensorsParsingError(
+                f"Failed to parse safetensors header for '{filename}' (repo '{repo_id}', revision "
+                f"'{revision or DEFAULT_REVISION}'): header format not recognized. Please make sure this is a correctly"
+                " formatted safetensors file."
+            ) from e
+
+    @validate_hf_hub_args
+    def create_branch(
+        self,
+        repo_id: str,
+        *,
+        branch: str,
+        revision: Optional[str] = None,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        exist_ok: bool = False,
+    ) -> None:
+        """
+        Create a new branch for a repo on the Hub, starting from the specified revision (defaults to `main`).
+        To find a revision suiting your needs, you can use [`list_repo_refs`] or [`list_repo_commits`].
+
+        Args:
+            repo_id (`str`):
+                The repository in which the branch will be created.
+                Example: `"user/my-cool-model"`.
+
+            branch (`str`):
+                The name of the branch to create.
+
+            revision (`str`, *optional*):
+                The git revision to create the branch from. It can be a branch name or
+                the OID/SHA of a commit, as a hexadecimal string. Defaults to the head
+                of the `"main"` branch.
+
+            token (`str`, *optional*):
+                Authentication token. Will default to the stored token.
+
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if creating a branch on a dataset or
+                space, `None` or `"model"` if tagging a model. Default is `None`.
+
+            exist_ok (`bool`, *optional*, defaults to `False`):
+                If `True`, do not raise an error if branch already exists.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If repository is not found (error 404): wrong repo_id/repo_type, private
+                but not authenticated or repo does not exist.
+            [`~utils.BadRequestError`]:
+                If invalid reference for a branch. Ex: `refs/pr/5` or 'refs/foo/bar'.
+            [`~utils.HfHubHTTPError`]:
+                If the branch already exists on the repo (error 409) and `exist_ok` is
+                set to `False`.
+        """
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+        branch = quote(branch, safe="")
+
+        # Prepare request
+        branch_url = f"{self.endpoint}/api/{repo_type}s/{repo_id}/branch/{branch}"
+        headers = self._build_hf_headers(token=token)
+        payload = {}
+        if revision is not None:
+            payload["startingPoint"] = revision
+
+        # Create branch
+        response = get_session().post(url=branch_url, headers=headers, json=payload)
+        try:
+            hf_raise_for_status(response)
+        except HfHubHTTPError as e:
+            if not (e.response.status_code == 409 and exist_ok):
+                raise
+
+    @validate_hf_hub_args
+    def delete_branch(
+        self,
+        repo_id: str,
+        *,
+        branch: str,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+    ) -> None:
+        """
+        Delete a branch from a repo on the Hub.
+
+        Args:
+            repo_id (`str`):
+                The repository in which a branch will be deleted.
+                Example: `"user/my-cool-model"`.
+
+            branch (`str`):
+                The name of the branch to delete.
+
+            token (`str`, *optional*):
+                Authentication token. Will default to the stored token.
+
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if creating a branch on a dataset or
+                space, `None` or `"model"` if tagging a model. Default is `None`.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If repository is not found (error 404): wrong repo_id/repo_type, private
+                but not authenticated or repo does not exist.
+            [`~utils.HfHubHTTPError`]:
+                If trying to delete a protected branch. Ex: `main` cannot be deleted.
+            [`~utils.HfHubHTTPError`]:
+                If trying to delete a branch that does not exist.
+
+        """
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+        branch = quote(branch, safe="")
+
+        # Prepare request
+        branch_url = f"{self.endpoint}/api/{repo_type}s/{repo_id}/branch/{branch}"
+        headers = self._build_hf_headers(token=token)
+
+        # Delete branch
+        response = get_session().delete(url=branch_url, headers=headers)
+        hf_raise_for_status(response)
+
+    @validate_hf_hub_args
+    def create_tag(
+        self,
+        repo_id: str,
+        *,
+        tag: str,
+        tag_message: Optional[str] = None,
+        revision: Optional[str] = None,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        exist_ok: bool = False,
+    ) -> None:
+        """
+        Tag a given commit of a repo on the Hub.
+
+        Args:
+            repo_id (`str`):
+                The repository in which a commit will be tagged.
+                Example: `"user/my-cool-model"`.
+
+            tag (`str`):
+                The name of the tag to create.
+
+            tag_message (`str`, *optional*):
+                The description of the tag to create.
+
+            revision (`str`, *optional*):
+                The git revision to tag. It can be a branch name or the OID/SHA of a
+                commit, as a hexadecimal string. Shorthands (7 first characters) are
+                also supported. Defaults to the head of the `"main"` branch.
+
+            token (`str`, *optional*):
+                Authentication token. Will default to the stored token.
+
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if tagging a dataset or
+                space, `None` or `"model"` if tagging a model. Default is
+                `None`.
+
+            exist_ok (`bool`, *optional*, defaults to `False`):
+                If `True`, do not raise an error if tag already exists.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If repository is not found (error 404): wrong repo_id/repo_type, private
+                but not authenticated or repo does not exist.
+            [`~utils.RevisionNotFoundError`]:
+                If revision is not found (error 404) on the repo.
+            [`~utils.HfHubHTTPError`]:
+                If the branch already exists on the repo (error 409) and `exist_ok` is
+                set to `False`.
+        """
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+        revision = quote(revision, safe="") if revision is not None else DEFAULT_REVISION
+
+        # Prepare request
+        tag_url = f"{self.endpoint}/api/{repo_type}s/{repo_id}/tag/{revision}"
+        headers = self._build_hf_headers(token=token)
+        payload = {"tag": tag}
+        if tag_message is not None:
+            payload["message"] = tag_message
+
+        # Tag
+        response = get_session().post(url=tag_url, headers=headers, json=payload)
+        try:
+            hf_raise_for_status(response)
+        except HfHubHTTPError as e:
+            if not (e.response.status_code == 409 and exist_ok):
+                raise
+
+    @validate_hf_hub_args
+    def delete_tag(
+        self,
+        repo_id: str,
+        *,
+        tag: str,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+    ) -> None:
+        """
+        Delete a tag from a repo on the Hub.
+
+        Args:
+            repo_id (`str`):
+                The repository in which a tag will be deleted.
+                Example: `"user/my-cool-model"`.
+
+            tag (`str`):
+                The name of the tag to delete.
+
+            token (`str`, *optional*):
+                Authentication token. Will default to the stored token.
+
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if tagging a dataset or space, `None` or
+                `"model"` if tagging a model. Default is `None`.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If repository is not found (error 404): wrong repo_id/repo_type, private
+                but not authenticated or repo does not exist.
+            [`~utils.RevisionNotFoundError`]:
+                If tag is not found.
+        """
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+        tag = quote(tag, safe="")
+
+        # Prepare request
+        tag_url = f"{self.endpoint}/api/{repo_type}s/{repo_id}/tag/{tag}"
+        headers = self._build_hf_headers(token=token)
+
+        # Un-tag
+        response = get_session().delete(url=tag_url, headers=headers)
+        hf_raise_for_status(response)
+
+    @validate_hf_hub_args
+    def get_full_repo_name(
+        self,
+        model_id: str,
+        *,
+        organization: Optional[str] = None,
+        token: Optional[Union[bool, str]] = None,
+    ):
+        """
+        Returns the repository name for a given model ID and optional
+        organization.
+
+        Args:
+            model_id (`str`):
+                The name of the model.
+            organization (`str`, *optional*):
+                If passed, the repository name will be in the organization
+                namespace instead of the user namespace.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+
+        Returns:
+            `str`: The repository name in the user's namespace
+            ({username}/{model_id}) if no organization is passed, and under the
+            organization namespace ({organization}/{model_id}) otherwise.
+        """
+        if organization is None:
+            if "/" in model_id:
+                username = model_id.split("/")[0]
+            else:
+                username = self.whoami(token=token)["name"]  # type: ignore
+            return f"{username}/{model_id}"
+        else:
+            return f"{organization}/{model_id}"
+
+    @validate_hf_hub_args
+    def get_repo_discussions(
+        self,
+        repo_id: str,
+        *,
+        author: Optional[str] = None,
+        discussion_type: Optional[DiscussionTypeFilter] = None,
+        discussion_status: Optional[DiscussionStatusFilter] = None,
+        repo_type: Optional[str] = None,
+        token: Optional[str] = None,
+    ) -> Iterator[Discussion]:
+        """
+        Fetches Discussions and Pull Requests for the given repo.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            author (`str`, *optional*):
+                Pass a value to filter by discussion author. `None` means no filter.
+                Default is `None`.
+            discussion_type (`str`, *optional*):
+                Set to `"pull_request"` to fetch only pull requests, `"discussion"`
+                to fetch only discussions. Set to `"all"` or `None` to fetch both.
+                Default is `None`.
+            discussion_status (`str`, *optional*):
+                Set to `"open"` (respectively `"closed"`) to fetch only open
+                (respectively closed) discussions. Set to `"all"` or `None`
+                to fetch both.
+                Default is `None`.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if fetching from a dataset or
+                space, `None` or `"model"` if fetching from a model. Default is
+                `None`.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token).
+
+        Returns:
+            `Iterator[Discussion]`: An iterator of [`Discussion`] objects.
+
+        Example:
+            Collecting all discussions of a repo in a list:
+
+            ```python
+            >>> from huggingface_hub import get_repo_discussions
+            >>> discussions_list = list(get_repo_discussions(repo_id="bert-base-uncased"))
+            ```
+
+            Iterating over discussions of a repo:
+
+            ```python
+            >>> from huggingface_hub import get_repo_discussions
+            >>> for discussion in get_repo_discussions(repo_id="bert-base-uncased"):
+            ...     print(discussion.num, discussion.title)
+            ```
+        """
+        if repo_type not in REPO_TYPES:
+            raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+        if discussion_type is not None and discussion_type not in DISCUSSION_TYPES:
+            raise ValueError(f"Invalid discussion_type, must be one of {DISCUSSION_TYPES}")
+        if discussion_status is not None and discussion_status not in DISCUSSION_STATUS:
+            raise ValueError(f"Invalid discussion_status, must be one of {DISCUSSION_STATUS}")
+
+        headers = self._build_hf_headers(token=token)
+        path = f"{self.endpoint}/api/{repo_type}s/{repo_id}/discussions"
+
+        params: Dict[str, Union[str, int]] = {}
+        if discussion_type is not None:
+            params["type"] = discussion_type
+        if discussion_status is not None:
+            params["status"] = discussion_status
+        if author is not None:
+            params["author"] = author
+
+        def _fetch_discussion_page(page_index: int):
+            params["p"] = page_index
+            resp = get_session().get(path, headers=headers, params=params)
+            hf_raise_for_status(resp)
+            paginated_discussions = resp.json()
+            total = paginated_discussions["count"]
+            start = paginated_discussions["start"]
+            discussions = paginated_discussions["discussions"]
+            has_next = (start + len(discussions)) < total
+            return discussions, has_next
+
+        has_next, page_index = True, 0
+
+        while has_next:
+            discussions, has_next = _fetch_discussion_page(page_index=page_index)
+            for discussion in discussions:
+                yield Discussion(
+                    title=discussion["title"],
+                    num=discussion["num"],
+                    author=discussion.get("author", {}).get("name", "deleted"),
+                    created_at=parse_datetime(discussion["createdAt"]),
+                    status=discussion["status"],
+                    repo_id=discussion["repo"]["name"],
+                    repo_type=discussion["repo"]["type"],
+                    is_pull_request=discussion["isPullRequest"],
+                    endpoint=self.endpoint,
+                )
+            page_index = page_index + 1
+
+    @validate_hf_hub_args
+    def get_discussion_details(
+        self,
+        repo_id: str,
+        discussion_num: int,
+        *,
+        repo_type: Optional[str] = None,
+        token: Optional[str] = None,
+    ) -> DiscussionWithDetails:
+        """Fetches a Discussion's / Pull Request 's details from the Hub.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            discussion_num (`int`):
+                The number of the Discussion or Pull Request . Must be a strictly positive integer.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token)
+
+        Returns: [`DiscussionWithDetails`]
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+              if the HuggingFace API returned an error
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              if some parameter value is invalid
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+
+        </Tip>
+        """
+        if not isinstance(discussion_num, int) or discussion_num <= 0:
+            raise ValueError("Invalid discussion_num, must be a positive integer")
+        if repo_type not in REPO_TYPES:
+            raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+
+        path = f"{self.endpoint}/api/{repo_type}s/{repo_id}/discussions/{discussion_num}"
+        headers = self._build_hf_headers(token=token)
+        resp = get_session().get(path, params={"diff": "1"}, headers=headers)
+        hf_raise_for_status(resp)
+
+        discussion_details = resp.json()
+        is_pull_request = discussion_details["isPullRequest"]
+
+        target_branch = discussion_details["changes"]["base"] if is_pull_request else None
+        conflicting_files = discussion_details["filesWithConflicts"] if is_pull_request else None
+        merge_commit_oid = discussion_details["changes"].get("mergeCommitId", None) if is_pull_request else None
+
+        return DiscussionWithDetails(
+            title=discussion_details["title"],
+            num=discussion_details["num"],
+            author=discussion_details.get("author", {}).get("name", "deleted"),
+            created_at=parse_datetime(discussion_details["createdAt"]),
+            status=discussion_details["status"],
+            repo_id=discussion_details["repo"]["name"],
+            repo_type=discussion_details["repo"]["type"],
+            is_pull_request=discussion_details["isPullRequest"],
+            events=[deserialize_event(evt) for evt in discussion_details["events"]],
+            conflicting_files=conflicting_files,
+            target_branch=target_branch,
+            merge_commit_oid=merge_commit_oid,
+            diff=discussion_details.get("diff"),
+            endpoint=self.endpoint,
+        )
+
+    @validate_hf_hub_args
+    def create_discussion(
+        self,
+        repo_id: str,
+        title: str,
+        *,
+        token: Optional[str] = None,
+        description: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        pull_request: bool = False,
+    ) -> DiscussionWithDetails:
+        """Creates a Discussion or Pull Request.
+
+        Pull Requests created programmatically will be in `"draft"` status.
+
+        Creating a Pull Request with changes can also be done at once with [`HfApi.create_commit`].
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            title (`str`):
+                The title of the discussion. It can be up to 200 characters long,
+                and must be at least 3 characters long. Leading and trailing whitespaces
+                will be stripped.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token)
+            description (`str`, *optional*):
+                An optional description for the Pull Request.
+                Defaults to `"Discussion opened with the huggingface_hub Python library"`
+            pull_request (`bool`, *optional*):
+                Whether to create a Pull Request or discussion. If `True`, creates a Pull Request.
+                If `False`, creates a discussion. Defaults to `False`.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+
+        Returns: [`DiscussionWithDetails`]
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+              if the HuggingFace API returned an error
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              if some parameter value is invalid
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+
+        </Tip>"""
+        if repo_type not in REPO_TYPES:
+            raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+
+        if description is not None:
+            description = description.strip()
+        description = (
+            description
+            if description
+            else (
+                f"{'Pull Request' if pull_request else 'Discussion'} opened with the"
+                " [huggingface_hub Python"
+                " library](https://huggingface.co/docs/huggingface_hub)"
+            )
+        )
+
+        headers = self._build_hf_headers(token=token)
+        resp = get_session().post(
+            f"{self.endpoint}/api/{repo_type}s/{repo_id}/discussions",
+            json={
+                "title": title.strip(),
+                "description": description,
+                "pullRequest": pull_request,
+            },
+            headers=headers,
+        )
+        hf_raise_for_status(resp)
+        num = resp.json()["num"]
+        return self.get_discussion_details(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            discussion_num=num,
+            token=token,
+        )
+
+    @validate_hf_hub_args
+    def create_pull_request(
+        self,
+        repo_id: str,
+        title: str,
+        *,
+        token: Optional[str] = None,
+        description: Optional[str] = None,
+        repo_type: Optional[str] = None,
+    ) -> DiscussionWithDetails:
+        """Creates a Pull Request . Pull Requests created programmatically will be in `"draft"` status.
+
+        Creating a Pull Request with changes can also be done at once with [`HfApi.create_commit`];
+
+        This is a wrapper around [`HfApi.create_discussion`].
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            title (`str`):
+                The title of the discussion. It can be up to 200 characters long,
+                and must be at least 3 characters long. Leading and trailing whitespaces
+                will be stripped.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token)
+            description (`str`, *optional*):
+                An optional description for the Pull Request.
+                Defaults to `"Discussion opened with the huggingface_hub Python library"`
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+
+        Returns: [`DiscussionWithDetails`]
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+              if the HuggingFace API returned an error
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              if some parameter value is invalid
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+
+        </Tip>"""
+        return self.create_discussion(
+            repo_id=repo_id,
+            title=title,
+            token=token,
+            description=description,
+            repo_type=repo_type,
+            pull_request=True,
+        )
+
+    def _post_discussion_changes(
+        self,
+        *,
+        repo_id: str,
+        discussion_num: int,
+        resource: str,
+        body: Optional[dict] = None,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+    ) -> requests.Response:
+        """Internal utility to POST changes to a Discussion or Pull Request"""
+        if not isinstance(discussion_num, int) or discussion_num <= 0:
+            raise ValueError("Invalid discussion_num, must be a positive integer")
+        if repo_type not in REPO_TYPES:
+            raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+        repo_id = f"{repo_type}s/{repo_id}"
+
+        path = f"{self.endpoint}/api/{repo_id}/discussions/{discussion_num}/{resource}"
+
+        headers = self._build_hf_headers(token=token)
+        resp = requests.post(path, headers=headers, json=body)
+        hf_raise_for_status(resp)
+        return resp
+
+    @validate_hf_hub_args
+    def comment_discussion(
+        self,
+        repo_id: str,
+        discussion_num: int,
+        comment: str,
+        *,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+    ) -> DiscussionComment:
+        """Creates a new comment on the given Discussion.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            discussion_num (`int`):
+                The number of the Discussion or Pull Request . Must be a strictly positive integer.
+            comment (`str`):
+                The content of the comment to create. Comments support markdown formatting.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token)
+
+        Returns:
+            [`DiscussionComment`]: the newly created comment
+
+
+        Examples:
+            ```python
+
+            >>> comment = \"\"\"
+            ... Hello @otheruser!
+            ...
+            ... # This is a title
+            ...
+            ... **This is bold**, *this is italic* and ~this is strikethrough~
+            ... And [this](http://url) is a link
+            ... \"\"\"
+
+            >>> HfApi().comment_discussion(
+            ...     repo_id="username/repo_name",
+            ...     discussion_num=34
+            ...     comment=comment
+            ... )
+            # DiscussionComment(id='deadbeef0000000', type='comment', ...)
+
+            ```
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+              if the HuggingFace API returned an error
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              if some parameter value is invalid
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+
+        </Tip>
+        """
+        resp = self._post_discussion_changes(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            discussion_num=discussion_num,
+            token=token,
+            resource="comment",
+            body={"comment": comment},
+        )
+        return deserialize_event(resp.json()["newMessage"])  # type: ignore
+
+    @validate_hf_hub_args
+    def rename_discussion(
+        self,
+        repo_id: str,
+        discussion_num: int,
+        new_title: str,
+        *,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+    ) -> DiscussionTitleChange:
+        """Renames a Discussion.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            discussion_num (`int`):
+                The number of the Discussion or Pull Request . Must be a strictly positive integer.
+            new_title (`str`):
+                The new title for the discussion
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token)
+
+        Returns:
+            [`DiscussionTitleChange`]: the title change event
+
+
+        Examples:
+            ```python
+            >>> new_title = "New title, fixing a typo"
+            >>> HfApi().rename_discussion(
+            ...     repo_id="username/repo_name",
+            ...     discussion_num=34
+            ...     new_title=new_title
+            ... )
+            # DiscussionTitleChange(id='deadbeef0000000', type='title-change', ...)
+
+            ```
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+              if the HuggingFace API returned an error
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              if some parameter value is invalid
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+
+        </Tip>
+        """
+        resp = self._post_discussion_changes(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            discussion_num=discussion_num,
+            token=token,
+            resource="title",
+            body={"title": new_title},
+        )
+        return deserialize_event(resp.json()["newTitle"])  # type: ignore
+
+    @validate_hf_hub_args
+    def change_discussion_status(
+        self,
+        repo_id: str,
+        discussion_num: int,
+        new_status: Literal["open", "closed"],
+        *,
+        token: Optional[str] = None,
+        comment: Optional[str] = None,
+        repo_type: Optional[str] = None,
+    ) -> DiscussionStatusChange:
+        """Closes or re-opens a Discussion or Pull Request.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            discussion_num (`int`):
+                The number of the Discussion or Pull Request . Must be a strictly positive integer.
+            new_status (`str`):
+                The new status for the discussion, either `"open"` or `"closed"`.
+            comment (`str`, *optional*):
+                An optional comment to post with the status change.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token)
+
+        Returns:
+            [`DiscussionStatusChange`]: the status change event
+
+
+        Examples:
+            ```python
+            >>> new_title = "New title, fixing a typo"
+            >>> HfApi().rename_discussion(
+            ...     repo_id="username/repo_name",
+            ...     discussion_num=34
+            ...     new_title=new_title
+            ... )
+            # DiscussionStatusChange(id='deadbeef0000000', type='status-change', ...)
+
+            ```
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+              if the HuggingFace API returned an error
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              if some parameter value is invalid
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+
+        </Tip>
+        """
+        if new_status not in ["open", "closed"]:
+            raise ValueError("Invalid status, valid statuses are: 'open' and 'closed'")
+        body: Dict[str, str] = {"status": new_status}
+        if comment and comment.strip():
+            body["comment"] = comment.strip()
+        resp = self._post_discussion_changes(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            discussion_num=discussion_num,
+            token=token,
+            resource="status",
+            body=body,
+        )
+        return deserialize_event(resp.json()["newStatus"])  # type: ignore
+
+    @validate_hf_hub_args
+    def merge_pull_request(
+        self,
+        repo_id: str,
+        discussion_num: int,
+        *,
+        token: Optional[str] = None,
+        comment: Optional[str] = None,
+        repo_type: Optional[str] = None,
+    ):
+        """Merges a Pull Request.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            discussion_num (`int`):
+                The number of the Discussion or Pull Request . Must be a strictly positive integer.
+            comment (`str`, *optional*):
+                An optional comment to post with the status change.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token)
+
+        Returns:
+            [`DiscussionStatusChange`]: the status change event
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+              if the HuggingFace API returned an error
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              if some parameter value is invalid
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+
+        </Tip>
+        """
+        self._post_discussion_changes(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            discussion_num=discussion_num,
+            token=token,
+            resource="merge",
+            body={"comment": comment.strip()} if comment and comment.strip() else None,
+        )
+
+    @validate_hf_hub_args
+    def edit_discussion_comment(
+        self,
+        repo_id: str,
+        discussion_num: int,
+        comment_id: str,
+        new_content: str,
+        *,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+    ) -> DiscussionComment:
+        """Edits a comment on a Discussion / Pull Request.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            discussion_num (`int`):
+                The number of the Discussion or Pull Request . Must be a strictly positive integer.
+            comment_id (`str`):
+                The ID of the comment to edit.
+            new_content (`str`):
+                The new content of the comment. Comments support markdown formatting.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token)
+
+        Returns:
+            [`DiscussionComment`]: the edited comment
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+              if the HuggingFace API returned an error
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              if some parameter value is invalid
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+
+        </Tip>
+        """
+        resp = self._post_discussion_changes(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            discussion_num=discussion_num,
+            token=token,
+            resource=f"comment/{comment_id.lower()}/edit",
+            body={"content": new_content},
+        )
+        return deserialize_event(resp.json()["updatedComment"])  # type: ignore
+
+    @validate_hf_hub_args
+    def hide_discussion_comment(
+        self,
+        repo_id: str,
+        discussion_num: int,
+        comment_id: str,
+        *,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+    ) -> DiscussionComment:
+        """Hides a comment on a Discussion / Pull Request.
+
+        <Tip warning={true}>
+        Hidden comments' content cannot be retrieved anymore. Hiding a comment is irreversible.
+        </Tip>
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated
+                by a `/`.
+            discussion_num (`int`):
+                The number of the Discussion or Pull Request . Must be a strictly positive integer.
+            comment_id (`str`):
+                The ID of the comment to edit.
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or
+                space, `None` or `"model"` if uploading to a model. Default is
+                `None`.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token)
+
+        Returns:
+            [`DiscussionComment`]: the hidden comment
+
+        <Tip>
+
+        Raises the following errors:
+
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+              if the HuggingFace API returned an error
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              if some parameter value is invalid
+            - [`~utils.RepositoryNotFoundError`]
+              If the repository to download from cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+
+        </Tip>
+        """
+        warnings.warn(
+            "Hidden comments' content cannot be retrieved anymore. Hiding a comment is irreversible.",
+            UserWarning,
+        )
+        resp = self._post_discussion_changes(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            discussion_num=discussion_num,
+            token=token,
+            resource=f"comment/{comment_id.lower()}/hide",
+        )
+        return deserialize_event(resp.json()["updatedComment"])  # type: ignore
+
+    @validate_hf_hub_args
+    def add_space_secret(
+        self, repo_id: str, key: str, value: str, *, description: Optional[str] = None, token: Optional[str] = None
+    ) -> None:
+        """Adds or updates a secret in a Space.
+
+        Secrets allow to set secret keys or tokens to a Space without hardcoding them.
+        For more details, see https://huggingface.co/docs/hub/spaces-overview#managing-secrets.
+
+        Args:
+            repo_id (`str`):
+                ID of the repo to update. Example: `"bigcode/in-the-stack"`.
+            key (`str`):
+                Secret key. Example: `"GITHUB_API_KEY"`
+            value (`str`):
+                Secret value. Example: `"your_github_api_key"`.
+            description (`str`, *optional*):
+                Secret description. Example: `"Github API key to access the Github API"`.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+        """
+        payload = {"key": key, "value": value}
+        if description is not None:
+            payload["description"] = description
+        r = get_session().post(
+            f"{self.endpoint}/api/spaces/{repo_id}/secrets",
+            headers=self._build_hf_headers(token=token),
+            json=payload,
+        )
+        hf_raise_for_status(r)
+
+    @validate_hf_hub_args
+    def delete_space_secret(self, repo_id: str, key: str, *, token: Optional[str] = None) -> None:
+        """Deletes a secret from a Space.
+
+        Secrets allow to set secret keys or tokens to a Space without hardcoding them.
+        For more details, see https://huggingface.co/docs/hub/spaces-overview#managing-secrets.
+
+        Args:
+            repo_id (`str`):
+                ID of the repo to update. Example: `"bigcode/in-the-stack"`.
+            key (`str`):
+                Secret key. Example: `"GITHUB_API_KEY"`.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+        """
+        r = get_session().delete(
+            f"{self.endpoint}/api/spaces/{repo_id}/secrets",
+            headers=self._build_hf_headers(token=token),
+            json={"key": key},
+        )
+        hf_raise_for_status(r)
+
+    @validate_hf_hub_args
+    def get_space_variables(self, repo_id: str, *, token: Optional[str] = None) -> Dict[str, SpaceVariable]:
+        """Gets all variables from a Space.
+
+        Variables allow to set environment variables to a Space without hardcoding them.
+        For more details, see https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables
+
+        Args:
+            repo_id (`str`):
+                ID of the repo to query. Example: `"bigcode/in-the-stack"`.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+        """
+        r = get_session().get(
+            f"{self.endpoint}/api/spaces/{repo_id}/variables",
+            headers=self._build_hf_headers(token=token),
+        )
+        hf_raise_for_status(r)
+        return {k: SpaceVariable(k, v) for k, v in r.json().items()}
+
+    @validate_hf_hub_args
+    def add_space_variable(
+        self, repo_id: str, key: str, value: str, *, description: Optional[str] = None, token: Optional[str] = None
+    ) -> Dict[str, SpaceVariable]:
+        """Adds or updates a variable in a Space.
+
+        Variables allow to set environment variables to a Space without hardcoding them.
+        For more details, see https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables
+
+        Args:
+            repo_id (`str`):
+                ID of the repo to update. Example: `"bigcode/in-the-stack"`.
+            key (`str`):
+                Variable key. Example: `"MODEL_REPO_ID"`
+            value (`str`):
+                Variable value. Example: `"the_model_repo_id"`.
+            description (`str`):
+                Description of the variable. Example: `"Model Repo ID of the implemented model"`.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+        """
+        payload = {"key": key, "value": value}
+        if description is not None:
+            payload["description"] = description
+        r = get_session().post(
+            f"{self.endpoint}/api/spaces/{repo_id}/variables",
+            headers=self._build_hf_headers(token=token),
+            json=payload,
+        )
+        hf_raise_for_status(r)
+        return {k: SpaceVariable(k, v) for k, v in r.json().items()}
+
+    @validate_hf_hub_args
+    def delete_space_variable(
+        self, repo_id: str, key: str, *, token: Optional[str] = None
+    ) -> Dict[str, SpaceVariable]:
+        """Deletes a variable from a Space.
+
+        Variables allow to set environment variables to a Space without hardcoding them.
+        For more details, see https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables
+
+        Args:
+            repo_id (`str`):
+                ID of the repo to update. Example: `"bigcode/in-the-stack"`.
+            key (`str`):
+                Variable key. Example: `"MODEL_REPO_ID"`
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+        """
+        r = get_session().delete(
+            f"{self.endpoint}/api/spaces/{repo_id}/variables",
+            headers=self._build_hf_headers(token=token),
+            json={"key": key},
+        )
+        hf_raise_for_status(r)
+        return {k: SpaceVariable(k, v) for k, v in r.json().items()}
+
+    @validate_hf_hub_args
+    def get_space_runtime(self, repo_id: str, *, token: Optional[str] = None) -> SpaceRuntime:
+        """Gets runtime information about a Space.
+
+        Args:
+            repo_id (`str`):
+                ID of the repo to update. Example: `"bigcode/in-the-stack"`.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if
+                not provided.
+        Returns:
+            [`SpaceRuntime`]: Runtime information about a Space including Space stage and hardware.
+        """
+        r = get_session().get(
+            f"{self.endpoint}/api/spaces/{repo_id}/runtime", headers=self._build_hf_headers(token=token)
+        )
+        hf_raise_for_status(r)
+        return SpaceRuntime(r.json())
+
+    @validate_hf_hub_args
+    def request_space_hardware(
+        self,
+        repo_id: str,
+        hardware: SpaceHardware,
+        *,
+        token: Optional[str] = None,
+        sleep_time: Optional[int] = None,
+    ) -> SpaceRuntime:
+        """Request new hardware for a Space.
+
+        Args:
+            repo_id (`str`):
+                ID of the repo to update. Example: `"bigcode/in-the-stack"`.
+            hardware (`str` or [`SpaceHardware`]):
+                Hardware on which to run the Space. Example: `"t4-medium"`.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+            sleep_time (`int`, *optional*):
+                Number of seconds of inactivity to wait before a Space is put to sleep. Set to `-1` if you don't want
+                your Space to sleep (default behavior for upgraded hardware). For free hardware, you can't configure
+                the sleep time (value is fixed to 48 hours of inactivity).
+                See https://huggingface.co/docs/hub/spaces-gpus#sleep-time for more details.
+        Returns:
+            [`SpaceRuntime`]: Runtime information about a Space including Space stage and hardware.
+
+        <Tip>
+
+        It is also possible to request hardware directly when creating the Space repo! See [`create_repo`] for details.
+
+        </Tip>
+        """
+        if sleep_time is not None and hardware == SpaceHardware.CPU_BASIC:
+            warnings.warn(
+                "If your Space runs on the default 'cpu-basic' hardware, it will go to sleep if inactive for more"
+                " than 48 hours. This value is not configurable. If you don't want your Space to deactivate or if"
+                " you want to set a custom sleep time, you need to upgrade to a paid Hardware.",
+                UserWarning,
+            )
+        payload: Dict[str, Any] = {"flavor": hardware}
+        if sleep_time is not None:
+            payload["sleepTimeSeconds"] = sleep_time
+        r = get_session().post(
+            f"{self.endpoint}/api/spaces/{repo_id}/hardware",
+            headers=self._build_hf_headers(token=token),
+            json=payload,
+        )
+        hf_raise_for_status(r)
+        return SpaceRuntime(r.json())
+
+    @validate_hf_hub_args
+    def set_space_sleep_time(self, repo_id: str, sleep_time: int, *, token: Optional[str] = None) -> SpaceRuntime:
+        """Set a custom sleep time for a Space running on upgraded hardware..
+
+        Your Space will go to sleep after X seconds of inactivity. You are not billed when your Space is in "sleep"
+        mode. If a new visitor lands on your Space, it will "wake it up". Only upgraded hardware can have a
+        configurable sleep time. To know more about the sleep stage, please refer to
+        https://huggingface.co/docs/hub/spaces-gpus#sleep-time.
+
+        Args:
+            repo_id (`str`):
+                ID of the repo to update. Example: `"bigcode/in-the-stack"`.
+            sleep_time (`int`, *optional*):
+                Number of seconds of inactivity to wait before a Space is put to sleep. Set to `-1` if you don't want
+                your Space to pause (default behavior for upgraded hardware). For free hardware, you can't configure
+                the sleep time (value is fixed to 48 hours of inactivity).
+                See https://huggingface.co/docs/hub/spaces-gpus#sleep-time for more details.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+        Returns:
+            [`SpaceRuntime`]: Runtime information about a Space including Space stage and hardware.
+
+        <Tip>
+
+        It is also possible to set a custom sleep time when requesting hardware with [`request_space_hardware`].
+
+        </Tip>
+        """
+        r = get_session().post(
+            f"{self.endpoint}/api/spaces/{repo_id}/sleeptime",
+            headers=self._build_hf_headers(token=token),
+            json={"seconds": sleep_time},
+        )
+        hf_raise_for_status(r)
+        runtime = SpaceRuntime(r.json())
+
+        hardware = runtime.requested_hardware or runtime.hardware
+        if hardware == SpaceHardware.CPU_BASIC:
+            warnings.warn(
+                "If your Space runs on the default 'cpu-basic' hardware, it will go to sleep if inactive for more"
+                " than 48 hours. This value is not configurable. If you don't want your Space to deactivate or if"
+                " you want to set a custom sleep time, you need to upgrade to a paid Hardware.",
+                UserWarning,
+            )
+        return runtime
+
+    @validate_hf_hub_args
+    def pause_space(self, repo_id: str, *, token: Optional[str] = None) -> SpaceRuntime:
+        """Pause your Space.
+
+        A paused Space stops executing until manually restarted by its owner. This is different from the sleeping
+        state in which free Spaces go after 48h of inactivity. Paused time is not billed to your account, no matter the
+        hardware you've selected. To restart your Space, use [`restart_space`] and go to your Space settings page.
+
+        For more details, please visit [the docs](https://huggingface.co/docs/hub/spaces-gpus#pause).
+
+        Args:
+            repo_id (`str`):
+                ID of the Space to pause. Example: `"Salesforce/BLIP2"`.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+
+        Returns:
+            [`SpaceRuntime`]: Runtime information about your Space including `stage=PAUSED` and requested hardware.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If your Space is not found (error 404). Most probably wrong repo_id or your space is private but you
+                are not authenticated.
+            [`~utils.HfHubHTTPError`]:
+                403 Forbidden: only the owner of a Space can pause it. If you want to manage a Space that you don't
+                own, either ask the owner by opening a Discussion or duplicate the Space.
+            [`~utils.BadRequestError`]:
+                If your Space is a static Space. Static Spaces are always running and never billed. If you want to hide
+                a static Space, you can set it to private.
+        """
+        r = get_session().post(
+            f"{self.endpoint}/api/spaces/{repo_id}/pause", headers=self._build_hf_headers(token=token)
+        )
+        hf_raise_for_status(r)
+        return SpaceRuntime(r.json())
+
+    @validate_hf_hub_args
+    def restart_space(
+        self, repo_id: str, *, token: Optional[str] = None, factory_reboot: bool = False
+    ) -> SpaceRuntime:
+        """Restart your Space.
+
+        This is the only way to programmatically restart a Space if you've put it on Pause (see [`pause_space`]). You
+        must be the owner of the Space to restart it. If you are using an upgraded hardware, your account will be
+        billed as soon as the Space is restarted. You can trigger a restart no matter the current state of a Space.
+
+        For more details, please visit [the docs](https://huggingface.co/docs/hub/spaces-gpus#pause).
+
+        Args:
+            repo_id (`str`):
+                ID of the Space to restart. Example: `"Salesforce/BLIP2"`.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+            factory_reboot (`bool`, *optional*):
+                If `True`, the Space will be rebuilt from scratch without caching any requirements.
+
+        Returns:
+            [`SpaceRuntime`]: Runtime information about your Space.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If your Space is not found (error 404). Most probably wrong repo_id or your space is private but you
+                are not authenticated.
+            [`~utils.HfHubHTTPError`]:
+                403 Forbidden: only the owner of a Space can restart it. If you want to restart a Space that you don't
+                own, either ask the owner by opening a Discussion or duplicate the Space.
+            [`~utils.BadRequestError`]:
+                If your Space is a static Space. Static Spaces are always running and never billed. If you want to hide
+                a static Space, you can set it to private.
+        """
+        params = {}
+        if factory_reboot:
+            params["factory"] = "true"
+        r = get_session().post(
+            f"{self.endpoint}/api/spaces/{repo_id}/restart", headers=self._build_hf_headers(token=token), params=params
+        )
+        hf_raise_for_status(r)
+        return SpaceRuntime(r.json())
+
+    @validate_hf_hub_args
+    def duplicate_space(
+        self,
+        from_id: str,
+        to_id: Optional[str] = None,
+        *,
+        private: Optional[bool] = None,
+        token: Optional[str] = None,
+        exist_ok: bool = False,
+        hardware: Optional[SpaceHardware] = None,
+        storage: Optional[SpaceStorage] = None,
+        sleep_time: Optional[int] = None,
+        secrets: Optional[List[Dict[str, str]]] = None,
+        variables: Optional[List[Dict[str, str]]] = None,
+    ) -> RepoUrl:
+        """Duplicate a Space.
+
+        Programmatically duplicate a Space. The new Space will be created in your account and will be in the same state
+        as the original Space (running or paused). You can duplicate a Space no matter the current state of a Space.
+
+        Args:
+            from_id (`str`):
+                ID of the Space to duplicate. Example: `"pharma/CLIP-Interrogator"`.
+            to_id (`str`, *optional*):
+                ID of the new Space. Example: `"dog/CLIP-Interrogator"`. If not provided, the new Space will have the same
+                name as the original Space, but in your account.
+            private (`bool`, *optional*):
+                Whether the new Space should be private or not. Defaults to the same privacy as the original Space.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+            exist_ok (`bool`, *optional*, defaults to `False`):
+                If `True`, do not raise an error if repo already exists.
+            hardware (`SpaceHardware` or `str`, *optional*):
+                Choice of Hardware. Example: `"t4-medium"`. See [`SpaceHardware`] for a complete list.
+            storage (`SpaceStorage` or `str`, *optional*):
+                Choice of persistent storage tier. Example: `"small"`. See [`SpaceStorage`] for a complete list.
+            sleep_time (`int`, *optional*):
+                Number of seconds of inactivity to wait before a Space is put to sleep. Set to `-1` if you don't want
+                your Space to sleep (default behavior for upgraded hardware). For free hardware, you can't configure
+                the sleep time (value is fixed to 48 hours of inactivity).
+                See https://huggingface.co/docs/hub/spaces-gpus#sleep-time for more details.
+            secrets (`List[Dict[str, str]]`, *optional*):
+                A list of secret keys to set in your Space. Each item is in the form `{"key": ..., "value": ..., "description": ...}` where description is optional.
+                For more details, see https://huggingface.co/docs/hub/spaces-overview#managing-secrets.
+            variables (`List[Dict[str, str]]`, *optional*):
+                A list of public environment variables to set in your Space. Each item is in the form `{"key": ..., "value": ..., "description": ...}` where description is optional.
+                For more details, see https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables.
+
+        Returns:
+            [`RepoUrl`]: URL to the newly created repo. Value is a subclass of `str` containing
+            attributes like `endpoint`, `repo_type` and `repo_id`.
+
+        Raises:
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+              if the HuggingFace API returned an error
+            - [`~utils.RepositoryNotFoundError`]
+              If one of `from_id` or `to_id` cannot be found. This may be because it doesn't exist,
+              or because it is set to `private` and you do not have access.
+
+        Example:
+        ```python
+        >>> from huggingface_hub import duplicate_space
+
+        # Duplicate a Space to your account
+        >>> duplicate_space("multimodalart/dreambooth-training")
+        RepoUrl('https://huggingface.co/spaces/nateraw/dreambooth-training',...)
+
+        # Can set custom destination id and visibility flag.
+        >>> duplicate_space("multimodalart/dreambooth-training", to_id="my-dreambooth", private=True)
+        RepoUrl('https://huggingface.co/spaces/nateraw/my-dreambooth',...)
+        ```
+        """
+        # Parse to_id if provided
+        parsed_to_id = RepoUrl(to_id) if to_id is not None else None
+
+        # Infer target repo_id
+        to_namespace = (  # set namespace manually or default to username
+            parsed_to_id.namespace
+            if parsed_to_id is not None and parsed_to_id.namespace is not None
+            else self.whoami(token)["name"]
+        )
+        to_repo_name = parsed_to_id.repo_name if to_id is not None else RepoUrl(from_id).repo_name  # type: ignore
+
+        # repository must be a valid repo_id (namespace/repo_name).
+        payload: Dict[str, Any] = {"repository": f"{to_namespace}/{to_repo_name}"}
+
+        keys = ["private", "hardware", "storageTier", "sleepTimeSeconds", "secrets", "variables"]
+        values = [private, hardware, storage, sleep_time, secrets, variables]
+        payload.update({k: v for k, v in zip(keys, values) if v is not None})
+
+        if sleep_time is not None and hardware == SpaceHardware.CPU_BASIC:
+            warnings.warn(
+                "If your Space runs on the default 'cpu-basic' hardware, it will go to sleep if inactive for more"
+                " than 48 hours. This value is not configurable. If you don't want your Space to deactivate or if"
+                " you want to set a custom sleep time, you need to upgrade to a paid Hardware.",
+                UserWarning,
+            )
+
+        r = get_session().post(
+            f"{self.endpoint}/api/spaces/{from_id}/duplicate",
+            headers=self._build_hf_headers(token=token),
+            json=payload,
+        )
+
+        try:
+            hf_raise_for_status(r)
+        except HTTPError as err:
+            if exist_ok and err.response.status_code == 409:
+                # Repo already exists and `exist_ok=True`
+                pass
+            else:
+                raise
+
+        return RepoUrl(r.json()["url"], endpoint=self.endpoint)
+
+    @validate_hf_hub_args
+    def request_space_storage(
+        self,
+        repo_id: str,
+        storage: SpaceStorage,
+        *,
+        token: Optional[str] = None,
+    ) -> SpaceRuntime:
+        """Request persistent storage for a Space.
+
+        Args:
+            repo_id (`str`):
+                ID of the Space to update. Example: `"HuggingFaceH4/open_llm_leaderboard"`.
+            storage (`str` or [`SpaceStorage`]):
+               Storage tier. Either 'small', 'medium', or 'large'.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+        Returns:
+            [`SpaceRuntime`]: Runtime information about a Space including Space stage and hardware.
+
+        <Tip>
+
+        It is not possible to decrease persistent storage after its granted. To do so, you must delete it
+        via [`delete_space_storage`].
+
+        </Tip>
+        """
+        payload: Dict[str, SpaceStorage] = {"tier": storage}
+        r = get_session().post(
+            f"{self.endpoint}/api/spaces/{repo_id}/storage",
+            headers=self._build_hf_headers(token=token),
+            json=payload,
+        )
+        hf_raise_for_status(r)
+        return SpaceRuntime(r.json())
+
+    @validate_hf_hub_args
+    def delete_space_storage(
+        self,
+        repo_id: str,
+        *,
+        token: Optional[str] = None,
+    ) -> SpaceRuntime:
+        """Delete persistent storage for a Space.
+
+        Args:
+            repo_id (`str`):
+                ID of the Space to update. Example: `"HuggingFaceH4/open_llm_leaderboard"`.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+        Returns:
+            [`SpaceRuntime`]: Runtime information about a Space including Space stage and hardware.
+        Raises:
+            [`BadRequestError`]
+                If space has no persistent storage.
+
+        """
+        r = get_session().delete(
+            f"{self.endpoint}/api/spaces/{repo_id}/storage",
+            headers=self._build_hf_headers(token=token),
+        )
+        hf_raise_for_status(r)
+        return SpaceRuntime(r.json())
+
+    #######################
+    # Inference Endpoints #
+    #######################
+
+    def list_inference_endpoints(
+        self, namespace: Optional[str] = None, *, token: Optional[str] = None
+    ) -> List[InferenceEndpoint]:
+        """Lists all inference endpoints for the given namespace.
+
+        Args:
+            namespace (`str`, *optional*):
+                The namespace to list endpoints for. Defaults to the current user. Set to `"*"` to list all endpoints
+                from all namespaces (i.e. personal namespace and all orgs the user belongs to).
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token).
+
+        Returns:
+            List[`InferenceEndpoint`]: A list of all inference endpoints for the given namespace.
+
+        Example:
+        ```python
+        >>> from huggingface_hub import HfApi
+        >>> api = HfApi()
+        >>> api.list_inference_endpoints()
+        [InferenceEndpoint(name='my-endpoint', ...), ...]
+        ```
+        """
+        # Special case: list all endpoints for all namespaces the user has access to
+        if namespace == "*":
+            user = self.whoami(token=token)
+
+            # List personal endpoints first
+            endpoints: List[InferenceEndpoint] = list_inference_endpoints(namespace=self._get_namespace(token=token))
+
+            # Then list endpoints for all orgs the user belongs to and ignore 401 errors (no billing or no access)
+            for org in user.get("orgs", []):
+                try:
+                    endpoints += list_inference_endpoints(namespace=org["name"], token=token)
+                except HfHubHTTPError as error:
+                    if error.response.status_code == 401:  # Either no billing or user don't have access)
+                        logger.debug("Cannot list Inference Endpoints for org '%s': %s", org["name"], error)
+                    pass
+
+            return endpoints
+
+        # Normal case: list endpoints for a specific namespace
+        namespace = namespace or self._get_namespace(token=token)
+
+        response = get_session().get(
+            f"{INFERENCE_ENDPOINTS_ENDPOINT}/endpoint/{namespace}",
+            headers=self._build_hf_headers(token=token),
+        )
+        hf_raise_for_status(response)
+
+        return [
+            InferenceEndpoint.from_raw(endpoint, namespace=namespace, token=token)
+            for endpoint in response.json()["items"]
+        ]
+
+    def create_inference_endpoint(
+        self,
+        name: str,
+        *,
+        repository: str,
+        framework: str,
+        accelerator: str,
+        instance_size: str,
+        instance_type: str,
+        region: str,
+        vendor: str,
+        account_id: Optional[str] = None,
+        min_replica: int = 0,
+        max_replica: int = 1,
+        revision: Optional[str] = None,
+        task: Optional[str] = None,
+        custom_image: Optional[Dict] = None,
+        type: InferenceEndpointType = InferenceEndpointType.PROTECTED,
+        namespace: Optional[str] = None,
+        token: Optional[str] = None,
+    ) -> InferenceEndpoint:
+        """Create a new Inference Endpoint.
+
+        Args:
+            name (`str`):
+                The unique name for the new Inference Endpoint.
+            repository (`str`):
+                The name of the model repository associated with the Inference Endpoint (e.g. `"gpt2"`).
+            framework (`str`):
+                The machine learning framework used for the model (e.g. `"custom"`).
+            accelerator (`str`):
+                The hardware accelerator to be used for inference (e.g. `"cpu"`).
+            instance_size (`str`):
+                The size or type of the instance to be used for hosting the model (e.g. `"large"`).
+            instance_type (`str`):
+                The cloud instance type where the Inference Endpoint will be deployed (e.g. `"c6i"`).
+            region (`str`):
+                The cloud region in which the Inference Endpoint will be created (e.g. `"us-east-1"`).
+            vendor (`str`):
+                The cloud provider or vendor where the Inference Endpoint will be hosted (e.g. `"aws"`).
+            account_id (`str`, *optional*):
+                The account ID used to link a VPC to a private Inference Endpoint (if applicable).
+            min_replica (`int`, *optional*):
+                The minimum number of replicas (instances) to keep running for the Inference Endpoint. Defaults to 0.
+            max_replica (`int`, *optional*):
+                The maximum number of replicas (instances) to scale to for the Inference Endpoint. Defaults to 1.
+            revision (`str`, *optional*):
+                The specific model revision to deploy on the Inference Endpoint (e.g. `"6c0e6080953db56375760c0471a8c5f2929baf11"`).
+            task (`str`, *optional*):
+                The task on which to deploy the model (e.g. `"text-classification"`).
+            custom_image (`Dict`, *optional*):
+                A custom Docker image to use for the Inference Endpoint. This is useful if you want to deploy an
+                Inference Endpoint running on the `text-generation-inference` (TGI) framework (see examples).
+            type ([`InferenceEndpointType]`, *optional*):
+                The type of the Inference Endpoint, which can be `"protected"` (default), `"public"` or `"private"`.
+            namespace (`str`, *optional*):
+                The namespace where the Inference Endpoint will be created. Defaults to the current user's namespace.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token).
+
+            Returns:
+                [`InferenceEndpoint`]: information about the updated Inference Endpoint.
+
+            Example:
+            ```python
+            >>> from huggingface_hub import HfApi
+            >>> api = HfApi()
+            >>> create_inference_endpoint(
+            ...     "my-endpoint-name",
+            ...     repository="gpt2",
+            ...     framework="pytorch",
+            ...     task="text-generation",
+            ...     accelerator="cpu",
+            ...     vendor="aws",
+            ...     region="us-east-1",
+            ...     type="protected",
+            ...     instance_size="medium",
+            ...     instance_type="c6i",
+            ... )
+            >>> endpoint
+            InferenceEndpoint(name='my-endpoint-name', status="pending",...)
+
+            # Run inference on the endpoint
+            >>> endpoint.client.text_generation(...)
+            "..."
+            ```
+
+            ```python
+            # Start an Inference Endpoint running Zephyr-7b-beta on TGI
+            >>> from huggingface_hub import HfApi
+            >>> api = HfApi()
+            >>> create_inference_endpoint(
+            ...     "aws-zephyr-7b-beta-0486",
+            ...     repository="HuggingFaceH4/zephyr-7b-beta",
+            ...     framework="pytorch",
+            ...     task="text-generation",
+            ...     accelerator="gpu",
+            ...     vendor="aws",
+            ...     region="us-east-1",
+            ...     type="protected",
+            ...     instance_size="medium",
+            ...     instance_type="g5.2xlarge",
+            ...     custom_image={
+            ...         "health_route": "/health",
+            ...         "env": {
+            ...             "MAX_BATCH_PREFILL_TOKENS": "2048",
+            ...             "MAX_INPUT_LENGTH": "1024",
+            ...             "MAX_TOTAL_TOKENS": "1512",
+            ...             "MODEL_ID": "/repository"
+            ...         },
+            ...         "url": "ghcr.io/huggingface/text-generation-inference:1.1.0",
+            ...     },
+            ... )
+
+            ```
+        """
+        namespace = namespace or self._get_namespace(token=token)
+
+        image = {"custom": custom_image} if custom_image is not None else {"huggingface": {}}
+        payload: Dict = {
+            "accountId": account_id,
+            "compute": {
+                "accelerator": accelerator,
+                "instanceSize": instance_size,
+                "instanceType": instance_type,
+                "scaling": {
+                    "maxReplica": max_replica,
+                    "minReplica": min_replica,
+                },
+            },
+            "model": {
+                "framework": framework,
+                "repository": repository,
+                "revision": revision,
+                "task": task,
+                "image": image,
+            },
+            "name": name,
+            "provider": {
+                "region": region,
+                "vendor": vendor,
+            },
+            "type": type,
+        }
+
+        response = get_session().post(
+            f"{INFERENCE_ENDPOINTS_ENDPOINT}/endpoint/{namespace}",
+            headers=self._build_hf_headers(token=token),
+            json=payload,
+        )
+        hf_raise_for_status(response)
+
+        return InferenceEndpoint.from_raw(response.json(), namespace=namespace, token=token)
+
+    def get_inference_endpoint(
+        self, name: str, *, namespace: Optional[str] = None, token: Optional[str] = None
+    ) -> InferenceEndpoint:
+        """Get information about an Inference Endpoint.
+
+        Args:
+            name (`str`):
+                The name of the Inference Endpoint to retrieve information about.
+            namespace (`str`, *optional*):
+                The namespace in which the Inference Endpoint is located. Defaults to the current user.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token).
+
+        Returns:
+            [`InferenceEndpoint`]: information about the requested Inference Endpoint.
+
+        Example:
+        ```python
+        >>> from huggingface_hub import HfApi
+        >>> api = HfApi()
+        >>> endpoint = api.get_inference_endpoint("my-text-to-image")
+        >>> endpoint
+        InferenceEndpoint(name='my-text-to-image', ...)
+
+        # Get status
+        >>> endpoint.status
+        'running'
+        >>> endpoint.url
+        'https://my-text-to-image.region.vendor.endpoints.huggingface.cloud'
+
+        # Run inference
+        >>> endpoint.client.text_to_image(...)
+        ```
+        """
+        namespace = namespace or self._get_namespace(token=token)
+
+        response = get_session().get(
+            f"{INFERENCE_ENDPOINTS_ENDPOINT}/endpoint/{namespace}/{name}",
+            headers=self._build_hf_headers(token=token),
+        )
+        hf_raise_for_status(response)
+
+        return InferenceEndpoint.from_raw(response.json(), namespace=namespace, token=token)
+
+    def update_inference_endpoint(
+        self,
+        name: str,
+        *,
+        # Compute update
+        accelerator: Optional[str] = None,
+        instance_size: Optional[str] = None,
+        instance_type: Optional[str] = None,
+        min_replica: Optional[int] = None,
+        max_replica: Optional[int] = None,
+        # Model update
+        repository: Optional[str] = None,
+        framework: Optional[str] = None,
+        revision: Optional[str] = None,
+        task: Optional[str] = None,
+        # Other
+        namespace: Optional[str] = None,
+        token: Optional[str] = None,
+    ) -> InferenceEndpoint:
+        """Update an Inference Endpoint.
+
+        This method allows the update of either the compute configuration, the deployed model, or both. All arguments are
+        optional but at least one must be provided.
+
+        For convenience, you can also update an Inference Endpoint using [`InferenceEndpoint.update`].
+
+        Args:
+            name (`str`):
+                The name of the Inference Endpoint to update.
+
+            accelerator (`str`, *optional*):
+                The hardware accelerator to be used for inference (e.g. `"cpu"`).
+            instance_size (`str`, *optional*):
+                The size or type of the instance to be used for hosting the model (e.g. `"large"`).
+            instance_type (`str`, *optional*):
+                The cloud instance type where the Inference Endpoint will be deployed (e.g. `"c6i"`).
+            min_replica (`int`, *optional*):
+                The minimum number of replicas (instances) to keep running for the Inference Endpoint.
+            max_replica (`int`, *optional*):
+                The maximum number of replicas (instances) to scale to for the Inference Endpoint.
+
+            repository (`str`, *optional*):
+                The name of the model repository associated with the Inference Endpoint (e.g. `"gpt2"`).
+            framework (`str`, *optional*):
+                The machine learning framework used for the model (e.g. `"custom"`).
+            revision (`str`, *optional*):
+                The specific model revision to deploy on the Inference Endpoint (e.g. `"6c0e6080953db56375760c0471a8c5f2929baf11"`).
+            task (`str`, *optional*):
+                The task on which to deploy the model (e.g. `"text-classification"`).
+
+            namespace (`str`, *optional*):
+                The namespace where the Inference Endpoint will be updated. Defaults to the current user's namespace.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token).
+
+        Returns:
+            [`InferenceEndpoint`]: information about the updated Inference Endpoint.
+        """
+        namespace = namespace or self._get_namespace(token=token)
+
+        payload: Dict = {}
+        if any(value is not None for value in (accelerator, instance_size, instance_type, min_replica, max_replica)):
+            payload["compute"] = {
+                "accelerator": accelerator,
+                "instanceSize": instance_size,
+                "instanceType": instance_type,
+                "scaling": {
+                    "maxReplica": max_replica,
+                    "minReplica": min_replica,
+                },
+            }
+        if any(value is not None for value in (repository, framework, revision, task)):
+            payload["model"] = {
+                "framework": framework,
+                "repository": repository,
+                "revision": revision,
+                "task": task,
+                "image": {"huggingface": {}},
+            }
+
+        response = get_session().put(
+            f"{INFERENCE_ENDPOINTS_ENDPOINT}/endpoint/{namespace}/{name}",
+            headers=self._build_hf_headers(token=token),
+            json=payload,
+        )
+        hf_raise_for_status(response)
+
+        return InferenceEndpoint.from_raw(response.json(), namespace=namespace, token=token)
+
+    def delete_inference_endpoint(
+        self, name: str, *, namespace: Optional[str] = None, token: Optional[str] = None
+    ) -> None:
+        """Delete an Inference Endpoint.
+
+        This operation is not reversible. If you don't want to be charged for an Inference Endpoint, it is preferable
+        to pause it with [`pause_inference_endpoint`] or scale it to zero with [`scale_to_zero_inference_endpoint`].
+
+        For convenience, you can also delete an Inference Endpoint using [`InferenceEndpoint.delete`].
+
+        Args:
+            name (`str`):
+                The name of the Inference Endpoint to delete.
+            namespace (`str`, *optional*):
+                The namespace in which the Inference Endpoint is located. Defaults to the current user.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token).
+        """
+        namespace = namespace or self._get_namespace(token=token)
+        response = get_session().delete(
+            f"{INFERENCE_ENDPOINTS_ENDPOINT}/endpoint/{namespace}/{name}",
+            headers=self._build_hf_headers(token=token),
+        )
+        hf_raise_for_status(response)
+
+    def pause_inference_endpoint(
+        self, name: str, *, namespace: Optional[str] = None, token: Optional[str] = None
+    ) -> InferenceEndpoint:
+        """Pause an Inference Endpoint.
+
+        A paused Inference Endpoint will not be charged. It can be resumed at any time using [`resume_inference_endpoint`].
+        This is different than scaling the Inference Endpoint to zero with [`scale_to_zero_inference_endpoint`], which
+        would be automatically restarted when a request is made to it.
+
+        For convenience, you can also pause an Inference Endpoint using [`pause_inference_endpoint`].
+
+        Args:
+            name (`str`):
+                The name of the Inference Endpoint to pause.
+            namespace (`str`, *optional*):
+                The namespace in which the Inference Endpoint is located. Defaults to the current user.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token).
+
+        Returns:
+            [`InferenceEndpoint`]: information about the paused Inference Endpoint.
+        """
+        namespace = namespace or self._get_namespace(token=token)
+
+        response = get_session().post(
+            f"{INFERENCE_ENDPOINTS_ENDPOINT}/endpoint/{namespace}/{name}/pause",
+            headers=self._build_hf_headers(token=token),
+        )
+        hf_raise_for_status(response)
+
+        return InferenceEndpoint.from_raw(response.json(), namespace=namespace, token=token)
+
+    def resume_inference_endpoint(
+        self, name: str, *, namespace: Optional[str] = None, token: Optional[str] = None
+    ) -> InferenceEndpoint:
+        """Resume an Inference Endpoint.
+
+        For convenience, you can also resume an Inference Endpoint using [`InferenceEndpoint.resume`].
+
+        Args:
+            name (`str`):
+                The name of the Inference Endpoint to resume.
+            namespace (`str`, *optional*):
+                The namespace in which the Inference Endpoint is located. Defaults to the current user.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token).
+
+        Returns:
+            [`InferenceEndpoint`]: information about the resumed Inference Endpoint.
+        """
+        namespace = namespace or self._get_namespace(token=token)
+
+        response = get_session().post(
+            f"{INFERENCE_ENDPOINTS_ENDPOINT}/endpoint/{namespace}/{name}/resume",
+            headers=self._build_hf_headers(token=token),
+        )
+        hf_raise_for_status(response)
+
+        return InferenceEndpoint.from_raw(response.json(), namespace=namespace, token=token)
+
+    def scale_to_zero_inference_endpoint(
+        self, name: str, *, namespace: Optional[str] = None, token: Optional[str] = None
+    ) -> InferenceEndpoint:
+        """Scale Inference Endpoint to zero.
+
+        An Inference Endpoint scaled to zero will not be charged. It will be resume on the next request to it, with a
+        cold start delay. This is different than pausing the Inference Endpoint with [`pause_inference_endpoint`], which
+        would require a manual resume with [`resume_inference_endpoint`].
+
+        For convenience, you can also scale an Inference Endpoint to zero using [`InferenceEndpoint.scale_to_zero`].
+
+        Args:
+            name (`str`):
+                The name of the Inference Endpoint to scale to zero.
+            namespace (`str`, *optional*):
+                The namespace in which the Inference Endpoint is located. Defaults to the current user.
+            token (`str`, *optional*):
+                An authentication token (See https://huggingface.co/settings/token).
+
+        Returns:
+            [`InferenceEndpoint`]: information about the scaled-to-zero Inference Endpoint.
+        """
+        namespace = namespace or self._get_namespace(token=token)
+
+        response = get_session().post(
+            f"{INFERENCE_ENDPOINTS_ENDPOINT}/endpoint/{namespace}/{name}/scale-to-zero",
+            headers=self._build_hf_headers(token=token),
+        )
+        hf_raise_for_status(response)
+
+        return InferenceEndpoint.from_raw(response.json(), namespace=namespace, token=token)
+
+    def _get_namespace(self, token: Optional[str] = None) -> str:
+        """Get the default namespace for the current user."""
+        me = self.whoami(token=token)
+        if me["type"] == "user":
+            return me["name"]
+        else:
+            raise ValueError(
+                "Cannot determine default namespace. You must provide a 'namespace' as input or be logged in as a"
+                " user."
+            )
+
+    ########################
+    # Collection Endpoints #
+    ########################
+    @validate_hf_hub_args
+    def list_collections(
+        self,
+        *,
+        owner: Union[List[str], str, None] = None,
+        item: Union[List[str], str, None] = None,
+        sort: Optional[Literal["lastModified", "trending", "upvotes"]] = None,
+        limit: Optional[int] = None,
+        token: Optional[Union[bool, str]] = None,
+    ) -> Iterable[Collection]:
+        """List collections on the Huggingface Hub, given some filters.
+
+        <Tip warning={true}>
+
+        When listing collections, the item list per collection is truncated to 4 items maximum. To retrieve all items
+        from a collection, you must use [`get_collection`].
+
+        </Tip>
+
+        Args:
+            owner (`List[str]` or `str`, *optional*):
+                Filter by owner's username.
+            item (`List[str]` or `str`, *optional*):
+                Filter collections containing a particular items. Example: `"models/teknium/OpenHermes-2.5-Mistral-7B"`, `"datasets/squad"` or `"papers/2311.12983"`.
+            sort (`Literal["lastModified", "trending", "upvotes"]`, *optional*):
+                Sort collections by last modified, trending or upvotes.
+            limit (`int`, *optional*):
+                Maximum number of collections to be returned.
+            token (`bool` or `str`, *optional*):
+                An authentication token (see https://huggingface.co/settings/token).
+
+        Returns:
+            `Iterable[Collection]`: an iterable of [`Collection`] objects.
+        """
+        # Construct the API endpoint
+        path = f"{self.endpoint}/api/collections"
+        headers = self._build_hf_headers(token=token)
+        params: Dict = {}
+        if owner is not None:
+            params.update({"owner": owner})
+        if item is not None:
+            params.update({"item": item})
+        if sort is not None:
+            params.update({"sort": sort})
+        if limit is not None:
+            params.update({"limit": limit})
+
+        # Paginate over the results until limit is reached
+        items = paginate(path, headers=headers, params=params)
+        if limit is not None:
+            items = islice(items, limit)  # Do not iterate over all pages
+
+        # Parse as Collection and return
+        for position, collection_data in enumerate(items):
+            yield Collection(position=position, **collection_data)
+
+    def get_collection(self, collection_slug: str, *, token: Optional[str] = None) -> Collection:
+        """Gets information about a Collection on the Hub.
+
+        Args:
+            collection_slug (`str`):
+                Slug of the collection of the Hub. Example: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+
+        Returns: [`Collection`]
+
+        Example:
+
+        ```py
+        >>> from huggingface_hub import get_collection
+        >>> collection = get_collection("TheBloke/recent-models-64f9a55bb3115b4f513ec026")
+        >>> collection.title
+        'Recent models'
+        >>> len(collection.items)
+        37
+        >>> collection.items[0]
+        CollectionItem(
+            item_object_id='651446103cd773a050bf64c2',
+            item_id='TheBloke/U-Amethyst-20B-AWQ',
+            item_type='model',
+            position=88,
+            note=None
+        )
+        ```
+        """
+        r = get_session().get(
+            f"{self.endpoint}/api/collections/{collection_slug}", headers=self._build_hf_headers(token=token)
+        )
+        hf_raise_for_status(r)
+        return Collection(**{**r.json(), "endpoint": self.endpoint})
+
+    def create_collection(
+        self,
+        title: str,
+        *,
+        namespace: Optional[str] = None,
+        description: Optional[str] = None,
+        private: bool = False,
+        exists_ok: bool = False,
+        token: Optional[str] = None,
+    ) -> Collection:
+        """Create a new Collection on the Hub.
+
+        Args:
+            title (`str`):
+                Title of the collection to create. Example: `"Recent models"`.
+            namespace (`str`, *optional*):
+                Namespace of the collection to create (username or org). Will default to the owner name.
+            description (`str`, *optional*):
+                Description of the collection to create.
+            private (`bool`, *optional*):
+                Whether the collection should be private or not. Defaults to `False` (i.e. public collection).
+            exists_ok (`bool`, *optional*):
+                If `True`, do not raise an error if collection already exists.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+
+        Returns: [`Collection`]
+
+        Example:
+
+        ```py
+        >>> from huggingface_hub import create_collection
+        >>> collection = create_collection(
+        ...     title="ICCV 2023",
+        ...     description="Portfolio of models, papers and demos I presented at ICCV 2023",
+        ... )
+        >>> collection.slug
+        "username/iccv-2023-64f9a55bb3115b4f513ec026"
+        ```
+        """
+        if namespace is None:
+            namespace = self.whoami(token)["name"]
+
+        payload = {
+            "title": title,
+            "namespace": namespace,
+            "private": private,
+        }
+        if description is not None:
+            payload["description"] = description
+
+        r = get_session().post(
+            f"{self.endpoint}/api/collections", headers=self._build_hf_headers(token=token), json=payload
+        )
+        try:
+            hf_raise_for_status(r)
+        except HTTPError as err:
+            if exists_ok and err.response.status_code == 409:
+                # Collection already exists and `exists_ok=True`
+                slug = r.json()["slug"]
+                return self.get_collection(slug, token=token)
+            else:
+                raise
+        return Collection(**{**r.json(), "endpoint": self.endpoint})
+
+    def update_collection_metadata(
+        self,
+        collection_slug: str,
+        *,
+        title: Optional[str] = None,
+        description: Optional[str] = None,
+        position: Optional[int] = None,
+        private: Optional[bool] = None,
+        theme: Optional[str] = None,
+        token: Optional[str] = None,
+    ) -> Collection:
+        """Update metadata of a collection on the Hub.
+
+        All arguments are optional. Only provided metadata will be updated.
+
+        Args:
+            collection_slug (`str`):
+                Slug of the collection to update. Example: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.
+            title (`str`):
+                Title of the collection to update.
+            description (`str`, *optional*):
+                Description of the collection to update.
+            position (`int`, *optional*):
+                New position of the collection in the list of collections of the user.
+            private (`bool`, *optional*):
+                Whether the collection should be private or not.
+            theme (`str`, *optional*):
+                Theme of the collection on the Hub.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+
+        Returns: [`Collection`]
+
+        Example:
+
+        ```py
+        >>> from huggingface_hub import update_collection_metadata
+        >>> collection = update_collection_metadata(
+        ...     collection_slug="username/iccv-2023-64f9a55bb3115b4f513ec026",
+        ...     title="ICCV Oct. 2023"
+        ...     description="Portfolio of models, datasets, papers and demos I presented at ICCV Oct. 2023",
+        ...     private=False,
+        ...     theme="pink",
+        ... )
+        >>> collection.slug
+        "username/iccv-oct-2023-64f9a55bb3115b4f513ec026"
+        # ^collection slug got updated but not the trailing ID
+        ```
+        """
+        payload = {
+            "position": position,
+            "private": private,
+            "theme": theme,
+            "title": title,
+            "description": description,
+        }
+        r = get_session().patch(
+            f"{self.endpoint}/api/collections/{collection_slug}",
+            headers=self._build_hf_headers(token=token),
+            # Only send not-none values to the API
+            json={key: value for key, value in payload.items() if value is not None},
+        )
+        hf_raise_for_status(r)
+        return Collection(**{**r.json()["data"], "endpoint": self.endpoint})
+
+    def delete_collection(
+        self, collection_slug: str, *, missing_ok: bool = False, token: Optional[str] = None
+    ) -> None:
+        """Delete a collection on the Hub.
+
+        Args:
+            collection_slug (`str`):
+                Slug of the collection to delete. Example: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.
+            missing_ok (`bool`, *optional*):
+                If `True`, do not raise an error if collection doesn't exists.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+
+        Example:
+
+        ```py
+        >>> from huggingface_hub import delete_collection
+        >>> collection = delete_collection("username/useless-collection-64f9a55bb3115b4f513ec026", missing_ok=True)
+        ```
+
+        <Tip warning={true}>
+
+        This is a non-revertible action. A deleted collection cannot be restored.
+
+        </Tip>
+        """
+        r = get_session().delete(
+            f"{self.endpoint}/api/collections/{collection_slug}", headers=self._build_hf_headers(token=token)
+        )
+        try:
+            hf_raise_for_status(r)
+        except HTTPError as err:
+            if missing_ok and err.response.status_code == 404:
+                # Collection doesn't exists and `missing_ok=True`
+                return
+            else:
+                raise
+
+    def add_collection_item(
+        self,
+        collection_slug: str,
+        item_id: str,
+        item_type: CollectionItemType_T,
+        *,
+        note: Optional[str] = None,
+        exists_ok: bool = False,
+        token: Optional[str] = None,
+    ) -> Collection:
+        """Add an item to a collection on the Hub.
+
+        Args:
+            collection_slug (`str`):
+                Slug of the collection to update. Example: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.
+            item_id (`str`):
+                ID of the item to add to the collection. It can be the ID of a repo on the Hub (e.g. `"facebook/bart-large-mnli"`)
+                or a paper id (e.g. `"2307.09288"`).
+            item_type (`str`):
+                Type of the item to add. Can be one of `"model"`, `"dataset"`, `"space"` or `"paper"`.
+            note (`str`, *optional*):
+                A note to attach to the item in the collection. The maximum size for a note is 500 characters.
+            exists_ok (`bool`, *optional*):
+                If `True`, do not raise an error if item already exists.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+
+        Returns: [`Collection`]
+
+        Raises:
+            `HTTPError`:
+                HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
+                or `admin` role in the organization the repo belongs to or if you passed a `read` token.
+            `HTTPError`:
+                HTTP 404 if the item you try to add to the collection does not exist on the Hub.
+            `HTTPError`:
+                HTTP 409 if the item you try to add to the collection is already in the collection (and exists_ok=False)
+
+        Example:
+
+        ```py
+        >>> from huggingface_hub import add_collection_item
+        >>> collection = add_collection_item(
+        ...     collection_slug="davanstrien/climate-64f99dc2a5067f6b65531bab",
+        ...     item_id="pierre-loic/climate-news-articles",
+        ...     item_type="dataset"
+        ... )
+        >>> collection.items[-1].item_id
+        "pierre-loic/climate-news-articles"
+        # ^item got added to the collection on last position
+
+        # Add item with a note
+        >>> add_collection_item(
+        ...     collection_slug="davanstrien/climate-64f99dc2a5067f6b65531bab",
+        ...     item_id="datasets/climate_fever",
+        ...     item_type="dataset"
+        ...     note="This dataset adopts the FEVER methodology that consists of 1,535 real-world claims regarding climate-change collected on the internet."
+        ... )
+        (...)
+        ```
+        """
+        payload: Dict[str, Any] = {"item": {"id": item_id, "type": item_type}}
+        if note is not None:
+            payload["note"] = note
+        r = get_session().post(
+            f"{self.endpoint}/api/collections/{collection_slug}/items",
+            headers=self._build_hf_headers(token=token),
+            json=payload,
+        )
+        try:
+            hf_raise_for_status(r)
+        except HTTPError as err:
+            if exists_ok and err.response.status_code == 409:
+                # Item already exists and `exists_ok=True`
+                return self.get_collection(collection_slug, token=token)
+            else:
+                raise
+        return Collection(**{**r.json(), "endpoint": self.endpoint})
+
+    def update_collection_item(
+        self,
+        collection_slug: str,
+        item_object_id: str,
+        *,
+        note: Optional[str] = None,
+        position: Optional[int] = None,
+        token: Optional[str] = None,
+    ) -> None:
+        """Update an item in a collection.
+
+        Args:
+            collection_slug (`str`):
+                Slug of the collection to update. Example: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.
+            item_object_id (`str`):
+                ID of the item in the collection. This is not the id of the item on the Hub (repo_id or paper id).
+                It must be retrieved from a [`CollectionItem`] object. Example: `collection.items[0].item_object_id`.
+            note (`str`, *optional*):
+                A note to attach to the item in the collection. The maximum size for a note is 500 characters.
+            position (`int`, *optional*):
+                New position of the item in the collection.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+
+        Example:
+
+        ```py
+        >>> from huggingface_hub import get_collection, update_collection_item
+
+        # Get collection first
+        >>> collection = get_collection("TheBloke/recent-models-64f9a55bb3115b4f513ec026")
+
+        # Update item based on its ID (add note + update position)
+        >>> update_collection_item(
+        ...     collection_slug="TheBloke/recent-models-64f9a55bb3115b4f513ec026",
+        ...     item_object_id=collection.items[-1].item_object_id,
+        ...     note="Newly updated model!"
+        ...     position=0,
+        ... )
+        ```
+        """
+        payload = {"position": position, "note": note}
+        r = get_session().patch(
+            f"{self.endpoint}/api/collections/{collection_slug}/items/{item_object_id}",
+            headers=self._build_hf_headers(token=token),
+            # Only send not-none values to the API
+            json={key: value for key, value in payload.items() if value is not None},
+        )
+        hf_raise_for_status(r)
+
+    def delete_collection_item(
+        self,
+        collection_slug: str,
+        item_object_id: str,
+        *,
+        missing_ok: bool = False,
+        token: Optional[str] = None,
+    ) -> None:
+        """Delete an item from a collection.
+
+        Args:
+            collection_slug (`str`):
+                Slug of the collection to update. Example: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.
+            item_object_id (`str`):
+                ID of the item in the collection. This is not the id of the item on the Hub (repo_id or paper id).
+                It must be retrieved from a [`CollectionItem`] object. Example: `collection.items[0]._id`.
+            missing_ok (`bool`, *optional*):
+                If `True`, do not raise an error if item doesn't exists.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+
+        Example:
+
+        ```py
+        >>> from huggingface_hub import get_collection, delete_collection_item
+
+        # Get collection first
+        >>> collection = get_collection("TheBloke/recent-models-64f9a55bb3115b4f513ec026")
+
+        # Delete item based on its ID
+        >>> delete_collection_item(
+        ...     collection_slug="TheBloke/recent-models-64f9a55bb3115b4f513ec026",
+        ...     item_object_id=collection.items[-1].item_object_id,
+        ... )
+        ```
+        """
+        r = get_session().delete(
+            f"{self.endpoint}/api/collections/{collection_slug}/items/{item_object_id}",
+            headers=self._build_hf_headers(token=token),
+        )
+        try:
+            hf_raise_for_status(r)
+        except HTTPError as err:
+            if missing_ok and err.response.status_code == 404:
+                # Item already deleted and `missing_ok=True`
+                return
+            else:
+                raise
+
+    ##########################
+    # Manage access requests #
+    ##########################
+
+    @validate_hf_hub_args
+    def list_pending_access_requests(
+        self, repo_id: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+    ) -> List[AccessRequest]:
+        """
+        Get pending access requests for a given gated repo.
+
+        A pending request means the user has requested access to the repo but the request has not been processed yet.
+        If the approval mode is automatic, this list should be empty. Pending requests can be accepted or rejected
+        using [`accept_access_request`] and [`reject_access_request`].
+
+        For more info about gated repos, see https://huggingface.co/docs/hub/models-gated.
+
+        Args:
+            repo_id (`str`):
+                The id of the repo to get access requests for.
+            repo_type (`str`, *optional*):
+                The type of the repo to get access requests for. Must be one of `model`, `dataset` or `space`.
+                Defaults to `model`.
+            token (`str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+
+        Returns:
+            `List[AccessRequest]`: A list of [`AccessRequest`] objects. Each time contains a `username`, `email`,
+            `status` and `timestamp` attribute. If the gated repo has a custom form, the `fields` attribute will
+            be populated with user's answers.
+
+        Raises:
+            `HTTPError`:
+                HTTP 400 if the repo is not gated.
+            `HTTPError`:
+                HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
+                or `admin` role in the organization the repo belongs to or if you passed a `read` token.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import list_pending_access_requests, accept_access_request
+
+        # List pending requests
+        >>> requests = list_pending_access_requests("meta-llama/Llama-2-7b")
+        >>> len(requests)
+        411
+        >>> requests[0]
+        [
+            AccessRequest(
+                username='clem',
+                fullname='Clem 🤗',
+                email='***',
+                timestamp=datetime.datetime(2023, 11, 23, 18, 4, 53, 828000, tzinfo=datetime.timezone.utc),
+                status='pending',
+                fields=None,
+            ),
+            ...
+        ]
+
+        # Accept Clem's request
+        >>> accept_access_request("meta-llama/Llama-2-7b", "clem")
+        ```
+        """
+        return self._list_access_requests(repo_id, "pending", repo_type=repo_type, token=token)
+
+    @validate_hf_hub_args
+    def list_accepted_access_requests(
+        self, repo_id: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+    ) -> List[AccessRequest]:
+        """
+        Get accepted access requests for a given gated repo.
+
+        An accepted request means the user has requested access to the repo and the request has been accepted. The user
+        can download any file of the repo. If the approval mode is automatic, this list should contains by default all
+        requests. Accepted requests can be cancelled or rejected at any time using [`cancel_access_request`] and
+        [`reject_access_request`]. A cancelled request will go back to the pending list while a rejected request will
+        go to the rejected list. In both cases, the user will lose access to the repo.
+
+        For more info about gated repos, see https://huggingface.co/docs/hub/models-gated.
+
+        Args:
+            repo_id (`str`):
+                The id of the repo to get access requests for.
+            repo_type (`str`, *optional*):
+                The type of the repo to get access requests for. Must be one of `model`, `dataset` or `space`.
+                Defaults to `model`.
+            token (`str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+
+        Returns:
+            `List[AccessRequest]`: A list of [`AccessRequest`] objects. Each time contains a `username`, `email`,
+            `status` and `timestamp` attribute. If the gated repo has a custom form, the `fields` attribute will
+            be populated with user's answers.
+
+        Raises:
+            `HTTPError`:
+                HTTP 400 if the repo is not gated.
+            `HTTPError`:
+                HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
+                or `admin` role in the organization the repo belongs to or if you passed a `read` token.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import list_accepted_access_requests
+
+        >>> requests = list_accepted_access_requests("meta-llama/Llama-2-7b")
+        >>> len(requests)
+        411
+        >>> requests[0]
+        [
+            AccessRequest(
+                username='clem',
+                fullname='Clem 🤗',
+                email='***',
+                timestamp=datetime.datetime(2023, 11, 23, 18, 4, 53, 828000, tzinfo=datetime.timezone.utc),
+                status='accepted',
+                fields=None,
+            ),
+            ...
+        ]
+        ```
+        """
+        return self._list_access_requests(repo_id, "accepted", repo_type=repo_type, token=token)
+
+    @validate_hf_hub_args
+    def list_rejected_access_requests(
+        self, repo_id: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+    ) -> List[AccessRequest]:
+        """
+        Get rejected access requests for a given gated repo.
+
+        A rejected request means the user has requested access to the repo and the request has been explicitly rejected
+        by a repo owner (either you or another user from your organization). The user cannot download any file of the
+        repo. Rejected requests can be accepted or cancelled at any time using [`accept_access_request`] and
+        [`cancel_access_request`]. A cancelled request will go back to the pending list while an accepted request will
+        go to the accepted list.
+
+        For more info about gated repos, see https://huggingface.co/docs/hub/models-gated.
+
+        Args:
+            repo_id (`str`):
+                The id of the repo to get access requests for.
+            repo_type (`str`, *optional*):
+                The type of the repo to get access requests for. Must be one of `model`, `dataset` or `space`.
+                Defaults to `model`.
+            token (`str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+
+        Returns:
+            `List[AccessRequest]`: A list of [`AccessRequest`] objects. Each time contains a `username`, `email`,
+            `status` and `timestamp` attribute. If the gated repo has a custom form, the `fields` attribute will
+            be populated with user's answers.
+
+        Raises:
+            `HTTPError`:
+                HTTP 400 if the repo is not gated.
+            `HTTPError`:
+                HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
+                or `admin` role in the organization the repo belongs to or if you passed a `read` token.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import list_rejected_access_requests
+
+        >>> requests = list_rejected_access_requests("meta-llama/Llama-2-7b")
+        >>> len(requests)
+        411
+        >>> requests[0]
+        [
+            AccessRequest(
+                username='clem',
+                fullname='Clem 🤗',
+                email='***',
+                timestamp=datetime.datetime(2023, 11, 23, 18, 4, 53, 828000, tzinfo=datetime.timezone.utc),
+                status='rejected',
+                fields=None,
+            ),
+            ...
+        ]
+        ```
+        """
+        return self._list_access_requests(repo_id, "rejected", repo_type=repo_type, token=token)
+
+    def _list_access_requests(
+        self,
+        repo_id: str,
+        status: Literal["accepted", "rejected", "pending"],
+        repo_type: Optional[str] = None,
+        token: Optional[str] = None,
+    ) -> List[AccessRequest]:
+        if repo_type not in REPO_TYPES:
+            raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+
+        response = get_session().get(
+            f"{ENDPOINT}/api/{repo_type}s/{repo_id}/user-access-request/{status}",
+            headers=self._build_hf_headers(token=token),
+        )
+        hf_raise_for_status(response)
+        return [
+            AccessRequest(
+                username=request["user"]["user"],
+                fullname=request["user"]["fullname"],
+                email=request["user"]["email"],
+                status=request["status"],
+                timestamp=parse_datetime(request["timestamp"]),
+                fields=request.get("fields"),  # only if custom fields in form
+            )
+            for request in response.json()
+        ]
+
+    @validate_hf_hub_args
+    def cancel_access_request(
+        self, repo_id: str, user: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+    ) -> None:
+        """
+        Cancel an access request from a user for a given gated repo.
+
+        A cancelled request will go back to the pending list and the user will lose access to the repo.
+
+        For more info about gated repos, see https://huggingface.co/docs/hub/models-gated.
+
+        Args:
+            repo_id (`str`):
+                The id of the repo to cancel access request for.
+            user (`str`):
+                The username of the user which access request should be cancelled.
+            repo_type (`str`, *optional*):
+                The type of the repo to cancel access request for. Must be one of `model`, `dataset` or `space`.
+                Defaults to `model`.
+            token (`str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+
+        Raises:
+            `HTTPError`:
+                HTTP 400 if the repo is not gated.
+            `HTTPError`:
+                HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
+                or `admin` role in the organization the repo belongs to or if you passed a `read` token.
+            `HTTPError`:
+                HTTP 404 if the user does not exist on the Hub.
+            `HTTPError`:
+                HTTP 404 if the user access request cannot be found.
+            `HTTPError`:
+                HTTP 404 if the user access request is already in the pending list.
+        """
+        self._handle_access_request(repo_id, user, "pending", repo_type=repo_type, token=token)
+
+    @validate_hf_hub_args
+    def accept_access_request(
+        self, repo_id: str, user: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+    ) -> None:
+        """
+        Accept an access request from a user for a given gated repo.
+
+        Once the request is accepted, the user will be able to download any file of the repo and access the community
+        tab. If the approval mode is automatic, you don't have to accept requests manually. An accepted request can be
+        cancelled or rejected at any time using [`cancel_access_request`] and [`reject_access_request`].
+
+        For more info about gated repos, see https://huggingface.co/docs/hub/models-gated.
+
+        Args:
+            repo_id (`str`):
+                The id of the repo to accept access request for.
+            user (`str`):
+                The username of the user which access request should be accepted.
+            repo_type (`str`, *optional*):
+                The type of the repo to accept access request for. Must be one of `model`, `dataset` or `space`.
+                Defaults to `model`.
+            token (`str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+
+        Raises:
+            `HTTPError`:
+                HTTP 400 if the repo is not gated.
+            `HTTPError`:
+                HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
+                or `admin` role in the organization the repo belongs to or if you passed a `read` token.
+            `HTTPError`:
+                HTTP 404 if the user does not exist on the Hub.
+            `HTTPError`:
+                HTTP 404 if the user access request cannot be found.
+            `HTTPError`:
+                HTTP 404 if the user access request is already in the accepted list.
+        """
+        self._handle_access_request(repo_id, user, "accepted", repo_type=repo_type, token=token)
+
+    @validate_hf_hub_args
+    def reject_access_request(
+        self, repo_id: str, user: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+    ) -> None:
+        """
+        Reject an access request from a user for a given gated repo.
+
+        A rejected request will go to the rejected list. The user cannot download any file of the repo. Rejected
+        requests can be accepted or cancelled at any time using [`accept_access_request`] and [`cancel_access_request`].
+        A cancelled request will go back to the pending list while an accepted request will go to the accepted list.
+
+        For more info about gated repos, see https://huggingface.co/docs/hub/models-gated.
+
+        Args:
+            repo_id (`str`):
+                The id of the repo to reject access request for.
+            user (`str`):
+                The username of the user which access request should be rejected.
+            repo_type (`str`, *optional*):
+                The type of the repo to reject access request for. Must be one of `model`, `dataset` or `space`.
+                Defaults to `model`.
+            token (`str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+
+        Raises:
+            `HTTPError`:
+                HTTP 400 if the repo is not gated.
+            `HTTPError`:
+                HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
+                or `admin` role in the organization the repo belongs to or if you passed a `read` token.
+            `HTTPError`:
+                HTTP 404 if the user does not exist on the Hub.
+            `HTTPError`:
+                HTTP 404 if the user access request cannot be found.
+            `HTTPError`:
+                HTTP 404 if the user access request is already in the rejected list.
+        """
+        self._handle_access_request(repo_id, user, "rejected", repo_type=repo_type, token=token)
+
+    @validate_hf_hub_args
+    def _handle_access_request(
+        self,
+        repo_id: str,
+        user: str,
+        status: Literal["accepted", "rejected", "pending"],
+        repo_type: Optional[str] = None,
+        token: Optional[str] = None,
+    ) -> None:
+        if repo_type not in REPO_TYPES:
+            raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+
+        response = get_session().post(
+            f"{ENDPOINT}/api/{repo_type}s/{repo_id}/user-access-request/handle",
+            headers=self._build_hf_headers(token=token),
+            json={"user": user, "status": status},
+        )
+        hf_raise_for_status(response)
+
+    @validate_hf_hub_args
+    def grant_access(
+        self, repo_id: str, user: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+    ) -> None:
+        """
+        Grant access to a user for a given gated repo.
+
+        Granting access don't require for the user to send an access request by themselves. The user is automatically
+        added to the accepted list meaning they can download the files You can revoke the granted access at any time
+        using [`cancel_access_request`] or [`reject_access_request`].
+
+        For more info about gated repos, see https://huggingface.co/docs/hub/models-gated.
+
+        Args:
+            repo_id (`str`):
+                The id of the repo to grant access to.
+            user (`str`):
+                The username of the user to grant access.
+            repo_type (`str`, *optional*):
+                The type of the repo to grant access to. Must be one of `model`, `dataset` or `space`.
+                Defaults to `model`.
+            token (`str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+
+        Raises:
+            `HTTPError`:
+                HTTP 400 if the repo is not gated.
+            `HTTPError`:
+                HTTP 400 if the user already has access to the repo.
+            `HTTPError`:
+                HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
+                or `admin` role in the organization the repo belongs to or if you passed a `read` token.
+            `HTTPError`:
+                HTTP 404 if the user does not exist on the Hub.
+        """
+        if repo_type not in REPO_TYPES:
+            raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
+        if repo_type is None:
+            repo_type = REPO_TYPE_MODEL
+
+        response = get_session().post(
+            f"{ENDPOINT}/api/models/{repo_id}/user-access-request/grant",
+            headers=self._build_hf_headers(token=token),
+            json={"user": user},
+        )
+        hf_raise_for_status(response)
+        return response.json()
+
+    #############
+    # Internals #
+    #############
+
+    def _build_hf_headers(
+        self,
+        token: Optional[Union[bool, str]] = None,
+        is_write_action: bool = False,
+        library_name: Optional[str] = None,
+        library_version: Optional[str] = None,
+        user_agent: Union[Dict, str, None] = None,
+    ) -> Dict[str, str]:
+        """
+        Alias for [`build_hf_headers`] that uses the token from [`HfApi`] client
+        when `token` is not provided.
+        """
+        if token is None:
+            # Cannot do `token = token or self.token` as token can be `False`.
+            token = self.token
+        return build_hf_headers(
+            token=token,
+            is_write_action=is_write_action,
+            library_name=library_name or self.library_name,
+            library_version=library_version or self.library_version,
+            user_agent=user_agent or self.user_agent,
+            headers=self.headers,
+        )
+
+    def _prepare_upload_folder_deletions(
+        self,
+        repo_id: str,
+        repo_type: Optional[str],
+        revision: Optional[str],
+        token: Optional[str],
+        path_in_repo: str,
+        delete_patterns: Optional[Union[List[str], str]],
+    ) -> List[CommitOperationDelete]:
+        """Generate the list of Delete operations for a commit to delete files from a repo.
+
+        List remote files and match them against the `delete_patterns` constraints. Returns a list of [`CommitOperationDelete`]
+        with the matching items.
+
+        Note: `.gitattributes` file is essential to make a repo work properly on the Hub. This file will always be
+              kept even if it matches the `delete_patterns` constraints.
+        """
+        if delete_patterns is None:
+            # If no delete patterns, no need to list and filter remote files
+            return []
+
+        # List remote files
+        filenames = self.list_repo_files(repo_id=repo_id, revision=revision, repo_type=repo_type, token=token)
+
+        # Compute relative path in repo
+        if path_in_repo and path_in_repo not in (".", "./"):
+            path_in_repo = path_in_repo.strip("/") + "/"  # harmonize
+            relpath_to_abspath = {
+                file[len(path_in_repo) :]: file for file in filenames if file.startswith(path_in_repo)
+            }
+        else:
+            relpath_to_abspath = {file: file for file in filenames}
+
+        # Apply filter on relative paths and return
+        return [
+            CommitOperationDelete(path_in_repo=relpath_to_abspath[relpath], is_folder=False)
+            for relpath in filter_repo_objects(relpath_to_abspath.keys(), allow_patterns=delete_patterns)
+            if relpath_to_abspath[relpath] != ".gitattributes"
+        ]
+
+
+def _prepare_upload_folder_additions(
+    folder_path: Union[str, Path],
+    path_in_repo: str,
+    allow_patterns: Optional[Union[List[str], str]] = None,
+    ignore_patterns: Optional[Union[List[str], str]] = None,
+) -> List[CommitOperationAdd]:
+    """Generate the list of Add operations for a commit to upload a folder.
+
+    Files not matching the `allow_patterns` (allowlist) and `ignore_patterns` (denylist)
+    constraints are discarded.
+    """
+    folder_path = Path(folder_path).expanduser().resolve()
+    if not folder_path.is_dir():
+        raise ValueError(f"Provided path: '{folder_path}' is not a directory")
+
+    # List files from folder
+    relpath_to_abspath = {
+        path.relative_to(folder_path).as_posix(): path
+        for path in sorted(folder_path.glob("**/*"))  # sorted to be deterministic
+        if path.is_file()
+    }
+
+    # Filter files and return
+    # Patterns are applied on the path relative to `folder_path`. `path_in_repo` is prefixed after the filtering.
+    prefix = f"{path_in_repo.strip('/')}/" if path_in_repo else ""
+    return [
+        CommitOperationAdd(
+            path_or_fileobj=relpath_to_abspath[relpath],  # absolute path on disk
+            path_in_repo=prefix + relpath,  # "absolute" path in repo
+        )
+        for relpath in filter_repo_objects(
+            relpath_to_abspath.keys(), allow_patterns=allow_patterns, ignore_patterns=ignore_patterns
+        )
+    ]
+
+
+def _parse_revision_from_pr_url(pr_url: str) -> str:
+    """Safely parse revision number from a PR url.
+
+    Example:
+    ```py
+    >>> _parse_revision_from_pr_url("https://huggingface.co/bigscience/bloom/discussions/2")
+    "refs/pr/2"
+    ```
+    """
+    re_match = re.match(_REGEX_DISCUSSION_URL, pr_url)
+    if re_match is None:
+        raise RuntimeError(f"Unexpected response from the hub, expected a Pull Request URL but got: '{pr_url}'")
+    return f"refs/pr/{re_match[1]}"
+
+
+api = HfApi()
+
+whoami = api.whoami
+get_token_permission = api.get_token_permission
+
+list_models = api.list_models
+model_info = api.model_info
+
+list_datasets = api.list_datasets
+dataset_info = api.dataset_info
+
+list_spaces = api.list_spaces
+space_info = api.space_info
+
+repo_exists = api.repo_exists
+revision_exists = api.revision_exists
+file_exists = api.file_exists
+repo_info = api.repo_info
+list_repo_files = api.list_repo_files
+list_repo_refs = api.list_repo_refs
+list_repo_commits = api.list_repo_commits
+list_files_info = api.list_files_info
+list_repo_tree = api.list_repo_tree
+get_paths_info = api.get_paths_info
+
+list_metrics = api.list_metrics
+
+get_model_tags = api.get_model_tags
+get_dataset_tags = api.get_dataset_tags
+
+create_commit = api.create_commit
+create_repo = api.create_repo
+delete_repo = api.delete_repo
+update_repo_visibility = api.update_repo_visibility
+super_squash_history = api.super_squash_history
+move_repo = api.move_repo
+upload_file = api.upload_file
+upload_folder = api.upload_folder
+delete_file = api.delete_file
+delete_folder = api.delete_folder
+create_commits_on_pr = api.create_commits_on_pr
+preupload_lfs_files = api.preupload_lfs_files
+create_branch = api.create_branch
+delete_branch = api.delete_branch
+create_tag = api.create_tag
+delete_tag = api.delete_tag
+get_full_repo_name = api.get_full_repo_name
+
+# Safetensors helpers
+get_safetensors_metadata = api.get_safetensors_metadata
+parse_safetensors_file_metadata = api.parse_safetensors_file_metadata
+
+# Background jobs
+run_as_future = api.run_as_future
+
+# Activity API
+list_liked_repos = api.list_liked_repos
+list_repo_likers = api.list_repo_likers
+like = api.like
+unlike = api.unlike
+
+# Community API
+get_discussion_details = api.get_discussion_details
+get_repo_discussions = api.get_repo_discussions
+create_discussion = api.create_discussion
+create_pull_request = api.create_pull_request
+change_discussion_status = api.change_discussion_status
+comment_discussion = api.comment_discussion
+edit_discussion_comment = api.edit_discussion_comment
+rename_discussion = api.rename_discussion
+merge_pull_request = api.merge_pull_request
+
+# Space API
+add_space_secret = api.add_space_secret
+delete_space_secret = api.delete_space_secret
+get_space_variables = api.get_space_variables
+add_space_variable = api.add_space_variable
+delete_space_variable = api.delete_space_variable
+get_space_runtime = api.get_space_runtime
+request_space_hardware = api.request_space_hardware
+set_space_sleep_time = api.set_space_sleep_time
+pause_space = api.pause_space
+restart_space = api.restart_space
+duplicate_space = api.duplicate_space
+request_space_storage = api.request_space_storage
+delete_space_storage = api.delete_space_storage
+
+# Inference Endpoint API
+list_inference_endpoints = api.list_inference_endpoints
+create_inference_endpoint = api.create_inference_endpoint
+get_inference_endpoint = api.get_inference_endpoint
+update_inference_endpoint = api.update_inference_endpoint
+delete_inference_endpoint = api.delete_inference_endpoint
+pause_inference_endpoint = api.pause_inference_endpoint
+resume_inference_endpoint = api.resume_inference_endpoint
+scale_to_zero_inference_endpoint = api.scale_to_zero_inference_endpoint
+
+# Collections API
+get_collection = api.get_collection
+list_collections = api.list_collections
+create_collection = api.create_collection
+update_collection_metadata = api.update_collection_metadata
+delete_collection = api.delete_collection
+add_collection_item = api.add_collection_item
+update_collection_item = api.update_collection_item
+delete_collection_item = api.delete_collection_item
+delete_collection_item = api.delete_collection_item
+
+# Access requests API
+list_pending_access_requests = api.list_pending_access_requests
+list_accepted_access_requests = api.list_accepted_access_requests
+list_rejected_access_requests = api.list_rejected_access_requests
+cancel_access_request = api.cancel_access_request
+accept_access_request = api.accept_access_request
+reject_access_request = api.reject_access_request
+grant_access = api.grant_access
diff --git a/llm/Lib/site-packages/huggingface_hub/hf_file_system.py b/llm/Lib/site-packages/huggingface_hub/hf_file_system.py
new file mode 100644
index 0000000000000000000000000000000000000000..e6843b7074d946d7675d4414a91c19519e178227
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/hf_file_system.py
@@ -0,0 +1,867 @@
+import copy
+import os
+import re
+import tempfile
+from collections import deque
+from dataclasses import dataclass, field
+from datetime import datetime
+from itertools import chain
+from pathlib import Path
+from typing import Any, Dict, List, NoReturn, Optional, Tuple, Union
+from urllib.parse import quote, unquote
+
+import fsspec
+from fsspec.callbacks import _DEFAULT_CALLBACK, NoOpCallback, TqdmCallback
+from fsspec.utils import isfilelike
+from requests import Response
+
+from ._commit_api import CommitOperationCopy, CommitOperationDelete
+from .constants import (
+    DEFAULT_REVISION,
+    ENDPOINT,
+    REPO_TYPE_MODEL,
+    REPO_TYPES_MAPPING,
+    REPO_TYPES_URL_PREFIXES,
+)
+from .file_download import hf_hub_url, http_get
+from .hf_api import HfApi, LastCommitInfo, RepoFile
+from .utils import (
+    EntryNotFoundError,
+    HFValidationError,
+    RepositoryNotFoundError,
+    RevisionNotFoundError,
+    hf_raise_for_status,
+    http_backoff,
+)
+
+
+# Regex used to match special revisions with "/" in them (see #1710)
+SPECIAL_REFS_REVISION_REGEX = re.compile(
+    r"""
+    (^refs\/convert\/\w+)     # `refs/convert/parquet` revisions
+    |
+    (^refs\/pr\/\d+)          # PR revisions
+    """,
+    re.VERBOSE,
+)
+
+
+@dataclass
+class HfFileSystemResolvedPath:
+    """Data structure containing information about a resolved Hugging Face file system path."""
+
+    repo_type: str
+    repo_id: str
+    revision: str
+    path_in_repo: str
+    # The part placed after '@' in the initial path. It can be a quoted or unquoted refs revision.
+    # Used to reconstruct the unresolved path to return to the user.
+    _raw_revision: Optional[str] = field(default=None, repr=False)
+
+    def unresolve(self) -> str:
+        repo_path = REPO_TYPES_URL_PREFIXES.get(self.repo_type, "") + self.repo_id
+        if self._raw_revision:
+            return f"{repo_path}@{self._raw_revision}/{self.path_in_repo}".rstrip("/")
+        elif self.revision != DEFAULT_REVISION:
+            return f"{repo_path}@{safe_revision(self.revision)}/{self.path_in_repo}".rstrip("/")
+        else:
+            return f"{repo_path}/{self.path_in_repo}".rstrip("/")
+
+
+class HfFileSystem(fsspec.AbstractFileSystem):
+    """
+    Access a remote Hugging Face Hub repository as if were a local file system.
+
+    Args:
+        token (`str`, *optional*):
+            Authentication token, obtained with [`HfApi.login`] method. Will default to the stored token.
+
+    Usage:
+
+    ```python
+    >>> from huggingface_hub import HfFileSystem
+
+    >>> fs = HfFileSystem()
+
+    >>> # List files
+    >>> fs.glob("my-username/my-model/*.bin")
+    ['my-username/my-model/pytorch_model.bin']
+    >>> fs.ls("datasets/my-username/my-dataset", detail=False)
+    ['datasets/my-username/my-dataset/.gitattributes', 'datasets/my-username/my-dataset/README.md', 'datasets/my-username/my-dataset/data.json']
+
+    >>> # Read/write files
+    >>> with fs.open("my-username/my-model/pytorch_model.bin") as f:
+    ...     data = f.read()
+    >>> with fs.open("my-username/my-model/pytorch_model.bin", "wb") as f:
+    ...     f.write(data)
+    ```
+    """
+
+    root_marker = ""
+    protocol = "hf"
+
+    def __init__(
+        self,
+        *args,
+        endpoint: Optional[str] = None,
+        token: Optional[str] = None,
+        **storage_options,
+    ):
+        super().__init__(*args, **storage_options)
+        self.endpoint = endpoint or ENDPOINT
+        self.token = token
+        self._api = HfApi(endpoint=endpoint, token=token)
+        # Maps (repo_type, repo_id, revision) to a 2-tuple with:
+        #  * the 1st element indicating whether the repositoy and the revision exist
+        #  * the 2nd element being the exception raised if the repository or revision doesn't exist
+        self._repo_and_revision_exists_cache: Dict[
+            Tuple[str, str, Optional[str]], Tuple[bool, Optional[Exception]]
+        ] = {}
+
+    def _repo_and_revision_exist(
+        self, repo_type: str, repo_id: str, revision: Optional[str]
+    ) -> Tuple[bool, Optional[Exception]]:
+        if (repo_type, repo_id, revision) not in self._repo_and_revision_exists_cache:
+            try:
+                self._api.repo_info(repo_id, revision=revision, repo_type=repo_type)
+            except (RepositoryNotFoundError, HFValidationError) as e:
+                self._repo_and_revision_exists_cache[(repo_type, repo_id, revision)] = False, e
+                self._repo_and_revision_exists_cache[(repo_type, repo_id, None)] = False, e
+            except RevisionNotFoundError as e:
+                self._repo_and_revision_exists_cache[(repo_type, repo_id, revision)] = False, e
+                self._repo_and_revision_exists_cache[(repo_type, repo_id, None)] = True, None
+            else:
+                self._repo_and_revision_exists_cache[(repo_type, repo_id, revision)] = True, None
+                self._repo_and_revision_exists_cache[(repo_type, repo_id, None)] = True, None
+        return self._repo_and_revision_exists_cache[(repo_type, repo_id, revision)]
+
+    def resolve_path(self, path: str, revision: Optional[str] = None) -> HfFileSystemResolvedPath:
+        def _align_revision_in_path_with_revision(
+            revision_in_path: Optional[str], revision: Optional[str]
+        ) -> Optional[str]:
+            if revision is not None:
+                if revision_in_path is not None and revision_in_path != revision:
+                    raise ValueError(
+                        f'Revision specified in path ("{revision_in_path}") and in `revision` argument ("{revision}")'
+                        " are not the same."
+                    )
+            else:
+                revision = revision_in_path
+            return revision
+
+        path = self._strip_protocol(path)
+        if not path:
+            # can't list repositories at root
+            raise NotImplementedError("Access to repositories lists is not implemented.")
+        elif path.split("/")[0] + "/" in REPO_TYPES_URL_PREFIXES.values():
+            if "/" not in path:
+                # can't list repositories at the repository type level
+                raise NotImplementedError("Access to repositories lists is not implemented.")
+            repo_type, path = path.split("/", 1)
+            repo_type = REPO_TYPES_MAPPING[repo_type]
+        else:
+            repo_type = REPO_TYPE_MODEL
+        if path.count("/") > 0:
+            if "@" in path:
+                repo_id, revision_in_path = path.split("@", 1)
+                if "/" in revision_in_path:
+                    match = SPECIAL_REFS_REVISION_REGEX.search(revision_in_path)
+                    if match is not None and revision in (None, match.group()):
+                        # Handle `refs/convert/parquet` and PR revisions separately
+                        path_in_repo = SPECIAL_REFS_REVISION_REGEX.sub("", revision_in_path).lstrip("/")
+                        revision_in_path = match.group()
+                    else:
+                        revision_in_path, path_in_repo = revision_in_path.split("/", 1)
+                else:
+                    path_in_repo = ""
+                revision = _align_revision_in_path_with_revision(unquote(revision_in_path), revision)
+                repo_and_revision_exist, err = self._repo_and_revision_exist(repo_type, repo_id, revision)
+                if not repo_and_revision_exist:
+                    _raise_file_not_found(path, err)
+            else:
+                revision_in_path = None
+                repo_id_with_namespace = "/".join(path.split("/")[:2])
+                path_in_repo_with_namespace = "/".join(path.split("/")[2:])
+                repo_id_without_namespace = path.split("/")[0]
+                path_in_repo_without_namespace = "/".join(path.split("/")[1:])
+                repo_id = repo_id_with_namespace
+                path_in_repo = path_in_repo_with_namespace
+                repo_and_revision_exist, err = self._repo_and_revision_exist(repo_type, repo_id, revision)
+                if not repo_and_revision_exist:
+                    if isinstance(err, (RepositoryNotFoundError, HFValidationError)):
+                        repo_id = repo_id_without_namespace
+                        path_in_repo = path_in_repo_without_namespace
+                        repo_and_revision_exist, _ = self._repo_and_revision_exist(repo_type, repo_id, revision)
+                        if not repo_and_revision_exist:
+                            _raise_file_not_found(path, err)
+                    else:
+                        _raise_file_not_found(path, err)
+        else:
+            repo_id = path
+            path_in_repo = ""
+            if "@" in path:
+                repo_id, revision_in_path = path.split("@", 1)
+                revision = _align_revision_in_path_with_revision(unquote(revision_in_path), revision)
+            else:
+                revision_in_path = None
+            repo_and_revision_exist, _ = self._repo_and_revision_exist(repo_type, repo_id, revision)
+            if not repo_and_revision_exist:
+                raise NotImplementedError("Access to repositories lists is not implemented.")
+
+        revision = revision if revision is not None else DEFAULT_REVISION
+        return HfFileSystemResolvedPath(repo_type, repo_id, revision, path_in_repo, _raw_revision=revision_in_path)
+
+    def invalidate_cache(self, path: Optional[str] = None) -> None:
+        if not path:
+            self.dircache.clear()
+            self._repo_and_revision_exists_cache.clear()
+        else:
+            path = self.resolve_path(path).unresolve()
+            while path:
+                self.dircache.pop(path, None)
+                path = self._parent(path)
+
+    def _open(
+        self,
+        path: str,
+        mode: str = "rb",
+        revision: Optional[str] = None,
+        block_size: Optional[int] = None,
+        **kwargs,
+    ) -> "HfFileSystemFile":
+        if "a" in mode:
+            raise NotImplementedError("Appending to remote files is not yet supported.")
+        if block_size == 0:
+            return HfFileSystemStreamFile(self, path, mode=mode, revision=revision, block_size=block_size, **kwargs)
+        else:
+            return HfFileSystemFile(self, path, mode=mode, revision=revision, block_size=block_size, **kwargs)
+
+    def _rm(self, path: str, revision: Optional[str] = None, **kwargs) -> None:
+        resolved_path = self.resolve_path(path, revision=revision)
+        self._api.delete_file(
+            path_in_repo=resolved_path.path_in_repo,
+            repo_id=resolved_path.repo_id,
+            token=self.token,
+            repo_type=resolved_path.repo_type,
+            revision=resolved_path.revision,
+            commit_message=kwargs.get("commit_message"),
+            commit_description=kwargs.get("commit_description"),
+        )
+        self.invalidate_cache(path=resolved_path.unresolve())
+
+    def rm(
+        self,
+        path: str,
+        recursive: bool = False,
+        maxdepth: Optional[int] = None,
+        revision: Optional[str] = None,
+        **kwargs,
+    ) -> None:
+        resolved_path = self.resolve_path(path, revision=revision)
+        paths = self.expand_path(path, recursive=recursive, maxdepth=maxdepth, revision=revision)
+        paths_in_repo = [self.resolve_path(path).path_in_repo for path in paths if not self.isdir(path)]
+        operations = [CommitOperationDelete(path_in_repo=path_in_repo) for path_in_repo in paths_in_repo]
+        commit_message = f"Delete {path} "
+        commit_message += "recursively " if recursive else ""
+        commit_message += f"up to depth {maxdepth} " if maxdepth is not None else ""
+        # TODO: use `commit_description` to list all the deleted paths?
+        self._api.create_commit(
+            repo_id=resolved_path.repo_id,
+            repo_type=resolved_path.repo_type,
+            token=self.token,
+            operations=operations,
+            revision=resolved_path.revision,
+            commit_message=kwargs.get("commit_message", commit_message),
+            commit_description=kwargs.get("commit_description"),
+        )
+        self.invalidate_cache(path=resolved_path.unresolve())
+
+    def ls(
+        self, path: str, detail: bool = True, refresh: bool = False, revision: Optional[str] = None, **kwargs
+    ) -> List[Union[str, Dict[str, Any]]]:
+        """List the contents of a directory."""
+        resolved_path = self.resolve_path(path, revision=revision)
+        path = resolved_path.unresolve()
+        kwargs = {"expand_info": detail, **kwargs}
+        try:
+            out = self._ls_tree(path, refresh=refresh, revision=revision, **kwargs)
+        except EntryNotFoundError:
+            # Path could be a file
+            if not resolved_path.path_in_repo:
+                _raise_file_not_found(path, None)
+            out = self._ls_tree(self._parent(path), refresh=refresh, revision=revision, **kwargs)
+            out = [o for o in out if o["name"] == path]
+            if len(out) == 0:
+                _raise_file_not_found(path, None)
+        return out if detail else [o["name"] for o in out]
+
+    def _ls_tree(
+        self,
+        path: str,
+        recursive: bool = False,
+        refresh: bool = False,
+        revision: Optional[str] = None,
+        expand_info: bool = True,
+    ):
+        resolved_path = self.resolve_path(path, revision=revision)
+        path = resolved_path.unresolve()
+        root_path = HfFileSystemResolvedPath(
+            resolved_path.repo_type,
+            resolved_path.repo_id,
+            resolved_path.revision,
+            path_in_repo="",
+            _raw_revision=resolved_path._raw_revision,
+        ).unresolve()
+
+        out = []
+        if path in self.dircache and not refresh:
+            cached_path_infos = self.dircache[path]
+            out.extend(cached_path_infos)
+            dirs_not_in_dircache = []
+            if recursive:
+                # Use BFS to traverse the cache and build the "recursive "output
+                # (The Hub uses a so-called "tree first" strategy for the tree endpoint but we sort the output to follow the spec so the result is (eventually) the same)
+                dirs_to_visit = deque(
+                    [path_info for path_info in cached_path_infos if path_info["type"] == "directory"]
+                )
+                while dirs_to_visit:
+                    dir_info = dirs_to_visit.popleft()
+                    if dir_info["name"] not in self.dircache:
+                        dirs_not_in_dircache.append(dir_info["name"])
+                    else:
+                        cached_path_infos = self.dircache[dir_info["name"]]
+                        out.extend(cached_path_infos)
+                        dirs_to_visit.extend(
+                            [path_info for path_info in cached_path_infos if path_info["type"] == "directory"]
+                        )
+
+            dirs_not_expanded = []
+            if expand_info:
+                # Check if there are directories with non-expanded entries
+                dirs_not_expanded = [self._parent(o["name"]) for o in out if o["last_commit"] is None]
+
+            if (recursive and dirs_not_in_dircache) or (expand_info and dirs_not_expanded):
+                # If the dircache is incomplete, find the common path of the missing and non-expanded entries
+                # and extend the output with the result of `_ls_tree(common_path, recursive=True)`
+                common_prefix = os.path.commonprefix(dirs_not_in_dircache + dirs_not_expanded)
+                # Get the parent directory if the common prefix itself is not a directory
+                common_path = (
+                    common_prefix.rstrip("/")
+                    if common_prefix.endswith("/")
+                    or common_prefix == root_path
+                    or common_prefix in chain(dirs_not_in_dircache, dirs_not_expanded)
+                    else self._parent(common_prefix)
+                )
+                out = [o for o in out if not o["name"].startswith(common_path + "/")]
+                for cached_path in self.dircache:
+                    if cached_path.startswith(common_path + "/"):
+                        self.dircache.pop(cached_path, None)
+                self.dircache.pop(common_path, None)
+                out.extend(
+                    self._ls_tree(
+                        common_path,
+                        recursive=recursive,
+                        refresh=True,
+                        revision=revision,
+                        expand_info=expand_info,
+                    )
+                )
+        else:
+            tree = self._api.list_repo_tree(
+                resolved_path.repo_id,
+                resolved_path.path_in_repo,
+                recursive=recursive,
+                expand=expand_info,
+                revision=resolved_path.revision,
+                repo_type=resolved_path.repo_type,
+            )
+            for path_info in tree:
+                if isinstance(path_info, RepoFile):
+                    cache_path_info = {
+                        "name": root_path + "/" + path_info.path,
+                        "size": path_info.size,
+                        "type": "file",
+                        "blob_id": path_info.blob_id,
+                        "lfs": path_info.lfs,
+                        "last_commit": path_info.last_commit,
+                        "security": path_info.security,
+                    }
+                else:
+                    cache_path_info = {
+                        "name": root_path + "/" + path_info.path,
+                        "size": 0,
+                        "type": "directory",
+                        "tree_id": path_info.tree_id,
+                        "last_commit": path_info.last_commit,
+                    }
+                parent_path = self._parent(cache_path_info["name"])
+                self.dircache.setdefault(parent_path, []).append(cache_path_info)
+                out.append(cache_path_info)
+        return copy.deepcopy(out)  # copy to not let users modify the dircache
+
+    def glob(self, path, **kwargs):
+        # Set expand_info=False by default to get a x10 speed boost
+        kwargs = {"expand_info": kwargs.get("detail", False), **kwargs}
+        path = self.resolve_path(path, revision=kwargs.get("revision")).unresolve()
+        return super().glob(path, **kwargs)
+
+    def find(
+        self,
+        path: str,
+        maxdepth: Optional[int] = None,
+        withdirs: bool = False,
+        detail: bool = False,
+        refresh: bool = False,
+        revision: Optional[str] = None,
+        **kwargs,
+    ) -> Union[List[str], Dict[str, Dict[str, Any]]]:
+        if maxdepth:
+            return super().find(
+                path, maxdepth=maxdepth, withdirs=withdirs, detail=detail, refresh=refresh, revision=revision, **kwargs
+            )
+        resolved_path = self.resolve_path(path, revision=revision)
+        path = resolved_path.unresolve()
+        kwargs = {"expand_info": detail, **kwargs}
+        try:
+            out = self._ls_tree(path, recursive=True, refresh=refresh, revision=resolved_path.revision, **kwargs)
+        except EntryNotFoundError:
+            # Path could be a file
+            if self.info(path, revision=revision, **kwargs)["type"] == "file":
+                out = {path: {}}
+            else:
+                out = {}
+        else:
+            if not withdirs:
+                out = [o for o in out if o["type"] != "directory"]
+            else:
+                # If `withdirs=True`, include the directory itself to be consistent with the spec
+                path_info = self.info(path, revision=resolved_path.revision, **kwargs)
+                out = [path_info] + out if path_info["type"] == "directory" else out
+            out = {o["name"]: o for o in out}
+        names = sorted(out)
+        if not detail:
+            return names
+        else:
+            return {name: out[name] for name in names}
+
+    def cp_file(self, path1: str, path2: str, revision: Optional[str] = None, **kwargs) -> None:
+        resolved_path1 = self.resolve_path(path1, revision=revision)
+        resolved_path2 = self.resolve_path(path2, revision=revision)
+
+        same_repo = (
+            resolved_path1.repo_type == resolved_path2.repo_type and resolved_path1.repo_id == resolved_path2.repo_id
+        )
+
+        if same_repo:
+            commit_message = f"Copy {path1} to {path2}"
+            self._api.create_commit(
+                repo_id=resolved_path1.repo_id,
+                repo_type=resolved_path1.repo_type,
+                revision=resolved_path2.revision,
+                commit_message=kwargs.get("commit_message", commit_message),
+                commit_description=kwargs.get("commit_description", ""),
+                operations=[
+                    CommitOperationCopy(
+                        src_path_in_repo=resolved_path1.path_in_repo,
+                        path_in_repo=resolved_path2.path_in_repo,
+                        src_revision=resolved_path1.revision,
+                    )
+                ],
+            )
+        else:
+            with self.open(path1, "rb", revision=resolved_path1.revision) as f:
+                content = f.read()
+            commit_message = f"Copy {path1} to {path2}"
+            self._api.upload_file(
+                path_or_fileobj=content,
+                path_in_repo=resolved_path2.path_in_repo,
+                repo_id=resolved_path2.repo_id,
+                token=self.token,
+                repo_type=resolved_path2.repo_type,
+                revision=resolved_path2.revision,
+                commit_message=kwargs.get("commit_message", commit_message),
+                commit_description=kwargs.get("commit_description"),
+            )
+        self.invalidate_cache(path=resolved_path1.unresolve())
+        self.invalidate_cache(path=resolved_path2.unresolve())
+
+    def modified(self, path: str, **kwargs) -> datetime:
+        info = self.info(path, **kwargs)
+        return info["last_commit"]["date"]
+
+    def info(self, path: str, refresh: bool = False, revision: Optional[str] = None, **kwargs) -> Dict[str, Any]:
+        resolved_path = self.resolve_path(path, revision=revision)
+        path = resolved_path.unresolve()
+        expand_info = kwargs.get(
+            "expand_info", True
+        )  # don't expose it as a parameter in the public API to follow the spec
+        if not resolved_path.path_in_repo:
+            # Path is the root directory
+            out = {
+                "name": path,
+                "size": 0,
+                "type": "directory",
+            }
+            if expand_info:
+                last_commit = self._api.list_repo_commits(
+                    resolved_path.repo_id, repo_type=resolved_path.repo_type, revision=resolved_path.revision
+                )[-1]
+                out = {
+                    **out,
+                    "tree_id": None,  # TODO: tree_id of the root directory?
+                    "last_commit": LastCommitInfo(
+                        oid=last_commit.commit_id, title=last_commit.title, date=last_commit.created_at
+                    ),
+                }
+        else:
+            out = None
+            parent_path = self._parent(path)
+            if parent_path in self.dircache:
+                # Check if the path is in the cache
+                out1 = [o for o in self.dircache[parent_path] if o["name"] == path]
+                if not out1:
+                    _raise_file_not_found(path, None)
+                out = out1[0]
+            if refresh or out is None or (expand_info and out and out["last_commit"] is None):
+                paths_info = self._api.get_paths_info(
+                    resolved_path.repo_id,
+                    resolved_path.path_in_repo,
+                    expand=expand_info,
+                    revision=resolved_path.revision,
+                    repo_type=resolved_path.repo_type,
+                )
+                if not paths_info:
+                    _raise_file_not_found(path, None)
+                path_info = paths_info[0]
+                root_path = HfFileSystemResolvedPath(
+                    resolved_path.repo_type,
+                    resolved_path.repo_id,
+                    resolved_path.revision,
+                    path_in_repo="",
+                    _raw_revision=resolved_path._raw_revision,
+                ).unresolve()
+                if isinstance(path_info, RepoFile):
+                    out = {
+                        "name": root_path + "/" + path_info.path,
+                        "size": path_info.size,
+                        "type": "file",
+                        "blob_id": path_info.blob_id,
+                        "lfs": path_info.lfs,
+                        "last_commit": path_info.last_commit,
+                        "security": path_info.security,
+                    }
+                else:
+                    out = {
+                        "name": root_path + "/" + path_info.path,
+                        "size": 0,
+                        "type": "directory",
+                        "tree_id": path_info.tree_id,
+                        "last_commit": path_info.last_commit,
+                    }
+                if not expand_info:
+                    out = {k: out[k] for k in ["name", "size", "type"]}
+        assert out is not None
+        return copy.deepcopy(out)  # copy to not let users modify the dircache
+
+    def exists(self, path, **kwargs):
+        """Is there a file at the given path"""
+        try:
+            self.info(path, **{**kwargs, "expand_info": False})
+            return True
+        except:  # noqa: E722
+            # any exception allowed bar FileNotFoundError?
+            return False
+
+    def isdir(self, path):
+        """Is this entry directory-like?"""
+        try:
+            return self.info(path, expand_info=False)["type"] == "directory"
+        except OSError:
+            return False
+
+    def isfile(self, path):
+        """Is this entry file-like?"""
+        try:
+            return self.info(path, expand_info=False)["type"] == "file"
+        except:  # noqa: E722
+            return False
+
+    def url(self, path: str) -> str:
+        """Get the HTTP URL of the given path"""
+        resolved_path = self.resolve_path(path)
+        url = hf_hub_url(
+            resolved_path.repo_id,
+            resolved_path.path_in_repo,
+            repo_type=resolved_path.repo_type,
+            revision=resolved_path.revision,
+            endpoint=self.endpoint,
+        )
+        if self.isdir(path):
+            url = url.replace("/resolve/", "/tree/", 1)
+        return url
+
+    def get_file(self, rpath, lpath, callback=_DEFAULT_CALLBACK, outfile=None, **kwargs) -> None:
+        """Copy single remote file to local."""
+        revision = kwargs.get("revision")
+        unhandled_kwargs = set(kwargs.keys()) - {"revision"}
+        if not isinstance(callback, (NoOpCallback, TqdmCallback)) or len(unhandled_kwargs) > 0:
+            # for now, let's not handle custom callbacks
+            # and let's not handle custom kwargs
+            return super().get_file(rpath, lpath, callback=callback, outfile=outfile, **kwargs)
+
+        # Taken from https://github.com/fsspec/filesystem_spec/blob/47b445ae4c284a82dd15e0287b1ffc410e8fc470/fsspec/spec.py#L883
+        if isfilelike(lpath):
+            outfile = lpath
+        elif self.isdir(rpath):
+            os.makedirs(lpath, exist_ok=True)
+            return None
+
+        if isinstance(lpath, (str, Path)):  # otherwise, let's assume it's a file-like object
+            os.makedirs(os.path.dirname(lpath), exist_ok=True)
+
+        # Open file if not already open
+        close_file = False
+        if outfile is None:
+            outfile = open(lpath, "wb")
+            close_file = True
+        initial_pos = outfile.tell()
+
+        # Custom implementation of `get_file` to use `http_get`.
+        resolve_remote_path = self.resolve_path(rpath, revision=revision)
+        expected_size = self.info(rpath, revision=revision)["size"]
+        callback.set_size(expected_size)
+        try:
+            http_get(
+                url=hf_hub_url(
+                    repo_id=resolve_remote_path.repo_id,
+                    revision=resolve_remote_path.revision,
+                    filename=resolve_remote_path.path_in_repo,
+                    repo_type=resolve_remote_path.repo_type,
+                    endpoint=self.endpoint,
+                ),
+                temp_file=outfile,
+                displayed_filename=rpath,
+                expected_size=expected_size,
+                resume_size=0,
+                headers=self._api._build_hf_headers(),
+                _tqdm_bar=callback.tqdm if isinstance(callback, TqdmCallback) else None,
+            )
+            outfile.seek(initial_pos)
+        finally:
+            # Close file only if we opened it ourselves
+            if close_file:
+                outfile.close()
+
+    @property
+    def transaction(self):
+        """A context within which files are committed together upon exit
+
+        Requires the file class to implement `.commit()` and `.discard()`
+        for the normal and exception cases.
+        """
+        # Taken from https://github.com/fsspec/filesystem_spec/blob/3fbb6fee33b46cccb015607630843dea049d3243/fsspec/spec.py#L231
+        # See https://github.com/huggingface/huggingface_hub/issues/1733
+        raise NotImplementedError("Transactional commits are not supported.")
+
+    def start_transaction(self):
+        """Begin write transaction for deferring files, non-context version"""
+        # Taken from https://github.com/fsspec/filesystem_spec/blob/3fbb6fee33b46cccb015607630843dea049d3243/fsspec/spec.py#L241
+        # See https://github.com/huggingface/huggingface_hub/issues/1733
+        raise NotImplementedError("Transactional commits are not supported.")
+
+
+class HfFileSystemFile(fsspec.spec.AbstractBufferedFile):
+    def __init__(self, fs: HfFileSystem, path: str, revision: Optional[str] = None, **kwargs):
+        try:
+            self.resolved_path = fs.resolve_path(path, revision=revision)
+        except FileNotFoundError as e:
+            if "w" in kwargs.get("mode", ""):
+                raise FileNotFoundError(
+                    f"{e}.\nMake sure the repository and revision exist before writing data."
+                ) from e
+            raise
+        super().__init__(fs, self.resolved_path.unresolve(), **kwargs)
+        self.fs: HfFileSystem
+
+    def __del__(self):
+        if not hasattr(self, "resolved_path"):
+            # Means that the constructor failed. Nothing to do.
+            return
+        return super().__del__()
+
+    def _fetch_range(self, start: int, end: int) -> bytes:
+        headers = {
+            "range": f"bytes={start}-{end - 1}",
+            **self.fs._api._build_hf_headers(),
+        }
+        url = hf_hub_url(
+            repo_id=self.resolved_path.repo_id,
+            revision=self.resolved_path.revision,
+            filename=self.resolved_path.path_in_repo,
+            repo_type=self.resolved_path.repo_type,
+            endpoint=self.fs.endpoint,
+        )
+        r = http_backoff("GET", url, headers=headers, retry_on_status_codes=(502, 503, 504))
+        hf_raise_for_status(r)
+        return r.content
+
+    def _initiate_upload(self) -> None:
+        self.temp_file = tempfile.NamedTemporaryFile(prefix="hffs-", delete=False)
+
+    def _upload_chunk(self, final: bool = False) -> None:
+        self.buffer.seek(0)
+        block = self.buffer.read()
+        self.temp_file.write(block)
+        if final:
+            self.temp_file.close()
+            self.fs._api.upload_file(
+                path_or_fileobj=self.temp_file.name,
+                path_in_repo=self.resolved_path.path_in_repo,
+                repo_id=self.resolved_path.repo_id,
+                token=self.fs.token,
+                repo_type=self.resolved_path.repo_type,
+                revision=self.resolved_path.revision,
+                commit_message=self.kwargs.get("commit_message"),
+                commit_description=self.kwargs.get("commit_description"),
+            )
+            os.remove(self.temp_file.name)
+            self.fs.invalidate_cache(
+                path=self.resolved_path.unresolve(),
+            )
+
+    def read(self, length=-1):
+        """Read remote file.
+
+        If `length` is not provided or is -1, the entire file is downloaded and read. On POSIX systems and if
+        `hf_transfer` is not enabled, the file is loaded in memory directly. Otherwise, the file is downloaded to a
+        temporary file and read from there.
+        """
+        if self.mode == "rb" and (length is None or length == -1) and self.loc == 0:
+            with self.fs.open(self.path, "rb", block_size=0) as f:  # block_size=0 enables fast streaming
+                return f.read()
+        return super().read(length)
+
+    def url(self) -> str:
+        return self.fs.url(self.path)
+
+
+class HfFileSystemStreamFile(fsspec.spec.AbstractBufferedFile):
+    def __init__(
+        self,
+        fs: HfFileSystem,
+        path: str,
+        mode: str = "rb",
+        revision: Optional[str] = None,
+        block_size: int = 0,
+        cache_type: str = "none",
+        **kwargs,
+    ):
+        if block_size != 0:
+            raise ValueError(f"HfFileSystemStreamFile only supports block_size=0 but got {block_size}")
+        if cache_type != "none":
+            raise ValueError(f"HfFileSystemStreamFile only supports cache_type='none' but got {cache_type}")
+        if "w" in mode:
+            raise ValueError(f"HfFileSystemStreamFile only supports reading but got mode='{mode}'")
+        try:
+            self.resolved_path = fs.resolve_path(path, revision=revision)
+        except FileNotFoundError as e:
+            if "w" in kwargs.get("mode", ""):
+                raise FileNotFoundError(
+                    f"{e}.\nMake sure the repository and revision exist before writing data."
+                ) from e
+        # avoid an unnecessary .info() call to instantiate .details
+        self.details = {"name": self.resolved_path.unresolve(), "size": None}
+        super().__init__(
+            fs, self.resolved_path.unresolve(), mode=mode, block_size=block_size, cache_type=cache_type, **kwargs
+        )
+        self.response: Optional[Response] = None
+        self.fs: HfFileSystem
+
+    def seek(self, loc: int, whence: int = 0):
+        if loc == 0 and whence == 1:
+            return
+        if loc == self.loc and whence == 0:
+            return
+        raise ValueError("Cannot seek streaming HF file")
+
+    def read(self, length: int = -1):
+        read_args = (length,) if length >= 0 else ()
+        if self.response is None or self.response.raw.isclosed():
+            url = hf_hub_url(
+                repo_id=self.resolved_path.repo_id,
+                revision=self.resolved_path.revision,
+                filename=self.resolved_path.path_in_repo,
+                repo_type=self.resolved_path.repo_type,
+                endpoint=self.fs.endpoint,
+            )
+            self.response = http_backoff(
+                "GET",
+                url,
+                headers=self.fs._api._build_hf_headers(),
+                retry_on_status_codes=(502, 503, 504),
+                stream=True,
+            )
+            hf_raise_for_status(self.response)
+        try:
+            out = self.response.raw.read(*read_args)
+        except Exception:
+            self.response.close()
+
+            # Retry by recreating the connection
+            url = hf_hub_url(
+                repo_id=self.resolved_path.repo_id,
+                revision=self.resolved_path.revision,
+                filename=self.resolved_path.path_in_repo,
+                repo_type=self.resolved_path.repo_type,
+                endpoint=self.fs.endpoint,
+            )
+            self.response = http_backoff(
+                "GET",
+                url,
+                headers={"Range": "bytes=%d-" % self.loc, **self.fs._api._build_hf_headers()},
+                retry_on_status_codes=(502, 503, 504),
+                stream=True,
+            )
+            hf_raise_for_status(self.response)
+            try:
+                out = self.response.raw.read(*read_args)
+            except Exception:
+                self.response.close()
+                raise
+        self.loc += len(out)
+        return out
+
+    def url(self) -> str:
+        return self.fs.url(self.path)
+
+    def __del__(self):
+        if not hasattr(self, "resolved_path"):
+            # Means that the constructor failed. Nothing to do.
+            return
+        return super().__del__()
+
+    def __reduce__(self):
+        return reopen, (self.fs, self.path, self.mode, self.blocksize, self.cache.name)
+
+
+def safe_revision(revision: str) -> str:
+    return revision if SPECIAL_REFS_REVISION_REGEX.match(revision) else safe_quote(revision)
+
+
+def safe_quote(s: str) -> str:
+    return quote(s, safe="")
+
+
+def _raise_file_not_found(path: str, err: Optional[Exception]) -> NoReturn:
+    msg = path
+    if isinstance(err, RepositoryNotFoundError):
+        msg = f"{path} (repository not found)"
+    elif isinstance(err, RevisionNotFoundError):
+        msg = f"{path} (revision not found)"
+    elif isinstance(err, HFValidationError):
+        msg = f"{path} (invalid repository id)"
+    raise FileNotFoundError(msg) from err
+
+
+def reopen(fs: HfFileSystem, path: str, mode: str, block_size: int, cache_type: str):
+    return fs.open(path, mode=mode, block_size=block_size, cache_type=cache_type)
diff --git a/llm/Lib/site-packages/huggingface_hub/hub_mixin.py b/llm/Lib/site-packages/huggingface_hub/hub_mixin.py
new file mode 100644
index 0000000000000000000000000000000000000000..eb42ef4e23b31148d90d6533f3debc91d6ce84d0
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/hub_mixin.py
@@ -0,0 +1,704 @@
+import inspect
+import json
+import os
+from dataclasses import asdict, dataclass, is_dataclass
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Type, TypeVar, Union, get_args
+
+from .constants import CONFIG_NAME, PYTORCH_WEIGHTS_NAME, SAFETENSORS_SINGLE_FILE
+from .file_download import hf_hub_download
+from .hf_api import HfApi
+from .repocard import ModelCard, ModelCardData
+from .utils import (
+    EntryNotFoundError,
+    HfHubHTTPError,
+    SoftTemporaryDirectory,
+    is_jsonable,
+    is_safetensors_available,
+    is_torch_available,
+    logging,
+    validate_hf_hub_args,
+)
+from .utils._deprecation import _deprecate_arguments
+
+
+if TYPE_CHECKING:
+    from _typeshed import DataclassInstance
+
+if is_torch_available():
+    import torch  # type: ignore
+
+if is_safetensors_available():
+    from safetensors.torch import load_model as load_model_as_safetensor
+    from safetensors.torch import save_model as save_model_as_safetensor
+
+
+logger = logging.get_logger(__name__)
+
+# Generic variable that is either ModelHubMixin or a subclass thereof
+T = TypeVar("T", bound="ModelHubMixin")
+
+DEFAULT_MODEL_CARD = """
+---
+# For reference on model card metadata, see the spec: https://github.com/huggingface/hub-docs/blob/main/modelcard.md?plain=1
+# Doc / guide: https://huggingface.co/docs/hub/model-cards
+{{ card_data }}
+---
+
+This model has been pushed to the Hub using **{{ library_name }}**:
+- Repo: {{ repo_url | default("[More Information Needed]", true) }}
+- Docs: {{ docs_url | default("[More Information Needed]", true) }}
+"""
+
+
+@dataclass
+class MixinInfo:
+    library_name: Optional[str] = None
+    tags: Optional[List[str]] = None
+    repo_url: Optional[str] = None
+    docs_url: Optional[str] = None
+
+
+class ModelHubMixin:
+    """
+    A generic mixin to integrate ANY machine learning framework with the Hub.
+
+    To integrate your framework, your model class must inherit from this class. Custom logic for saving/loading models
+    have to be overwritten in  [`_from_pretrained`] and [`_save_pretrained`]. [`PyTorchModelHubMixin`] is a good example
+    of mixin integration with the Hub. Check out our [integration guide](../guides/integrations) for more instructions.
+
+    When inheriting from [`ModelHubMixin`], you can define class-level attributes. These attributes are not passed to
+    `__init__` but to the class definition itself. This is useful to define metadata about the library integrating
+    [`ModelHubMixin`].
+
+    Args:
+        library_name (`str`, *optional*):
+            Name of the library integrating ModelHubMixin. Used to generate model card.
+        tags (`List[str]`, *optional*):
+            Tags to be added to the model card. Used to generate model card.
+        repo_url (`str`, *optional*):
+            URL of the library repository. Used to generate model card.
+        docs_url (`str`, *optional*):
+            URL of the library documentation. Used to generate model card.
+
+    Example:
+
+    ```python
+    >>> from huggingface_hub import ModelHubMixin
+
+    # Inherit from ModelHubMixin
+    >>> class MyCustomModel(
+    ...         ModelHubMixin,
+    ...         library_name="my-library",
+    ...         tags=["x-custom-tag"],
+    ...         repo_url="https://github.com/huggingface/my-cool-library",
+    ...         docs_url="https://huggingface.co/docs/my-cool-library",
+    ...         # ^ optional metadata to generate model card
+    ...     ):
+    ...     def __init__(self, size: int = 512, device: str = "cpu"):
+    ...         # define how to initialize your model
+    ...         super().__init__()
+    ...         ...
+    ...
+    ...     def _save_pretrained(self, save_directory: Path) -> None:
+    ...         # define how to serialize your model
+    ...         ...
+    ...
+    ...     @classmethod
+    ...     def from_pretrained(
+    ...         cls: Type[T],
+    ...         pretrained_model_name_or_path: Union[str, Path],
+    ...         *,
+    ...         force_download: bool = False,
+    ...         resume_download: bool = False,
+    ...         proxies: Optional[Dict] = None,
+    ...         token: Optional[Union[str, bool]] = None,
+    ...         cache_dir: Optional[Union[str, Path]] = None,
+    ...         local_files_only: bool = False,
+    ...         revision: Optional[str] = None,
+    ...         **model_kwargs,
+    ...     ) -> T:
+    ...         # define how to deserialize your model
+    ...         ...
+
+    >>> model = MyCustomModel(size=256, device="gpu")
+
+    # Save model weights to local directory
+    >>> model.save_pretrained("my-awesome-model")
+
+    # Push model weights to the Hub
+    >>> model.push_to_hub("my-awesome-model")
+
+    # Download and initialize weights from the Hub
+    >>> reloaded_model = MyCustomModel.from_pretrained("username/my-awesome-model")
+    >>> reloaded_model._hub_mixin_config
+    {"size": 256, "device": "gpu"}
+
+    # Model card has been correctly populated
+    >>> from huggingface_hub import ModelCard
+    >>> card = ModelCard.load("username/my-awesome-model")
+    >>> card.data.tags
+    ["x-custom-tag", "pytorch_model_hub_mixin", "model_hub_mixin"]
+    >>> card.data.library_name
+    "my-library"
+    ```
+    """
+
+    _hub_mixin_config: Optional[Union[dict, "DataclassInstance"]] = None
+    # ^ optional config attribute automatically set in `from_pretrained`
+    _hub_mixin_info: MixinInfo
+    # ^ information about the library integrating ModelHubMixin (used to generate model card)
+    _hub_mixin_init_parameters: Dict[str, inspect.Parameter]
+    _hub_mixin_jsonable_default_values: Dict[str, Any]
+    _hub_mixin_inject_config: bool
+    # ^ internal values to handle config
+
+    def __init_subclass__(
+        cls,
+        *,
+        library_name: Optional[str] = None,
+        tags: Optional[List[str]] = None,
+        repo_url: Optional[str] = None,
+        docs_url: Optional[str] = None,
+    ) -> None:
+        """Inspect __init__ signature only once when subclassing + handle modelcard."""
+        super().__init_subclass__()
+
+        # Will be reused when creating modelcard
+        tags = tags or []
+        tags.append("model_hub_mixin")
+        cls._hub_mixin_info = MixinInfo(
+            library_name=library_name,
+            tags=tags,
+            repo_url=repo_url,
+            docs_url=docs_url,
+        )
+
+        # Inspect __init__ signature to handle config
+        cls._hub_mixin_init_parameters = dict(inspect.signature(cls.__init__).parameters)
+        cls._hub_mixin_jsonable_default_values = {
+            param.name: param.default
+            for param in cls._hub_mixin_init_parameters.values()
+            if param.default is not inspect.Parameter.empty and is_jsonable(param.default)
+        }
+        cls._hub_mixin_inject_config = "config" in inspect.signature(cls._from_pretrained).parameters
+
+    def __new__(cls, *args, **kwargs) -> "ModelHubMixin":
+        """Create a new instance of the class and handle config.
+
+        3 cases:
+        - If `self._hub_mixin_config` is already set, do nothing.
+        - If `config` is passed as a dataclass, set it as `self._hub_mixin_config`.
+        - Otherwise, build `self._hub_mixin_config` from default values and passed values.
+        """
+        instance = super().__new__(cls)
+
+        # If `config` is already set, return early
+        if instance._hub_mixin_config is not None:
+            return instance
+
+        # Infer passed values
+        passed_values = {
+            **{
+                key: value
+                for key, value in zip(
+                    # [1:] to skip `self` parameter
+                    list(cls._hub_mixin_init_parameters)[1:],
+                    args,
+                )
+            },
+            **kwargs,
+        }
+
+        # If config passed as dataclass => set it and return early
+        if is_dataclass(passed_values.get("config")):
+            instance._hub_mixin_config = passed_values["config"]
+            return instance
+
+        # Otherwise, build config from default + passed values
+        init_config = {
+            # default values
+            **cls._hub_mixin_jsonable_default_values,
+            # passed values
+            **{key: value for key, value in passed_values.items() if is_jsonable(value)},
+        }
+        init_config.pop("config", {})
+
+        # Populate `init_config` with provided config
+        provided_config = passed_values.get("config")
+        if isinstance(provided_config, dict):
+            init_config.update(provided_config)
+
+        # Set `config` attribute and return
+        if init_config != {}:
+            instance._hub_mixin_config = init_config
+        return instance
+
+    def save_pretrained(
+        self,
+        save_directory: Union[str, Path],
+        *,
+        config: Optional[Union[dict, "DataclassInstance"]] = None,
+        repo_id: Optional[str] = None,
+        push_to_hub: bool = False,
+        **push_to_hub_kwargs,
+    ) -> Optional[str]:
+        """
+        Save weights in local directory.
+
+        Args:
+            save_directory (`str` or `Path`):
+                Path to directory in which the model weights and configuration will be saved.
+            config (`dict` or `DataclassInstance`, *optional*):
+                Model configuration specified as a key/value dictionary or a dataclass instance.
+            push_to_hub (`bool`, *optional*, defaults to `False`):
+                Whether or not to push your model to the Huggingface Hub after saving it.
+            repo_id (`str`, *optional*):
+                ID of your repository on the Hub. Used only if `push_to_hub=True`. Will default to the folder name if
+                not provided.
+            kwargs:
+                Additional key word arguments passed along to the [`~ModelHubMixin.push_to_hub`] method.
+        """
+        save_directory = Path(save_directory)
+        save_directory.mkdir(parents=True, exist_ok=True)
+
+        # Remove config.json if already exists. After `_save_pretrained` we don't want to overwrite config.json
+        # as it might have been saved by the custom `_save_pretrained` already. However we do want to overwrite
+        # an existing config.json if it was not saved by `_save_pretrained`.
+        config_path = save_directory / CONFIG_NAME
+        config_path.unlink(missing_ok=True)
+
+        # save model weights/files (framework-specific)
+        self._save_pretrained(save_directory)
+
+        # save config (if provided and if not serialized yet in `_save_pretrained`)
+        if config is None:
+            config = self._hub_mixin_config
+        if config is not None:
+            if is_dataclass(config):
+                config = asdict(config)  # type: ignore[arg-type]
+            if not config_path.exists():
+                config_str = json.dumps(config, sort_keys=True, indent=2)
+                config_path.write_text(config_str)
+
+        # save model card
+        model_card_path = save_directory / "README.md"
+        if not model_card_path.exists():  # do not overwrite if already exists
+            self.generate_model_card().save(save_directory / "README.md")
+
+        # push to the Hub if required
+        if push_to_hub:
+            kwargs = push_to_hub_kwargs.copy()  # soft-copy to avoid mutating input
+            if config is not None:  # kwarg for `push_to_hub`
+                kwargs["config"] = config
+            if repo_id is None:
+                repo_id = save_directory.name  # Defaults to `save_directory` name
+            return self.push_to_hub(repo_id=repo_id, **kwargs)
+        return None
+
+    def _save_pretrained(self, save_directory: Path) -> None:
+        """
+        Overwrite this method in subclass to define how to save your model.
+        Check out our [integration guide](../guides/integrations) for instructions.
+
+        Args:
+            save_directory (`str` or `Path`):
+                Path to directory in which the model weights and configuration will be saved.
+        """
+        raise NotImplementedError
+
+    @classmethod
+    @validate_hf_hub_args
+    def from_pretrained(
+        cls: Type[T],
+        pretrained_model_name_or_path: Union[str, Path],
+        *,
+        force_download: bool = False,
+        resume_download: bool = False,
+        proxies: Optional[Dict] = None,
+        token: Optional[Union[str, bool]] = None,
+        cache_dir: Optional[Union[str, Path]] = None,
+        local_files_only: bool = False,
+        revision: Optional[str] = None,
+        **model_kwargs,
+    ) -> T:
+        """
+        Download a model from the Huggingface Hub and instantiate it.
+
+        Args:
+            pretrained_model_name_or_path (`str`, `Path`):
+                - Either the `model_id` (string) of a model hosted on the Hub, e.g. `bigscience/bloom`.
+                - Or a path to a `directory` containing model weights saved using
+                    [`~transformers.PreTrainedModel.save_pretrained`], e.g., `../path/to/my_model_directory/`.
+            revision (`str`, *optional*):
+                Revision of the model on the Hub. Can be a branch name, a git tag or any commit id.
+                Defaults to the latest commit on `main` branch.
+            force_download (`bool`, *optional*, defaults to `False`):
+                Whether to force (re-)downloading the model weights and configuration files from the Hub, overriding
+                the existing cache.
+            resume_download (`bool`, *optional*, defaults to `False`):
+                Whether to delete incompletely received files. Will attempt to resume the download if such a file exists.
+            proxies (`Dict[str, str]`, *optional*):
+                A dictionary of proxy servers to use by protocol or endpoint, e.g., `{'http': 'foo.bar:3128',
+                'http://hostname': 'foo.bar:4012'}`. The proxies are used on every request.
+            token (`str` or `bool`, *optional*):
+                The token to use as HTTP bearer authorization for remote files. By default, it will use the token
+                cached when running `huggingface-cli login`.
+            cache_dir (`str`, `Path`, *optional*):
+                Path to the folder where cached files are stored.
+            local_files_only (`bool`, *optional*, defaults to `False`):
+                If `True`, avoid downloading the file and return the path to the local cached file if it exists.
+            model_kwargs (`Dict`, *optional*):
+                Additional kwargs to pass to the model during initialization.
+        """
+        model_id = str(pretrained_model_name_or_path)
+        config_file: Optional[str] = None
+        if os.path.isdir(model_id):
+            if CONFIG_NAME in os.listdir(model_id):
+                config_file = os.path.join(model_id, CONFIG_NAME)
+            else:
+                logger.warning(f"{CONFIG_NAME} not found in {Path(model_id).resolve()}")
+        else:
+            try:
+                config_file = hf_hub_download(
+                    repo_id=model_id,
+                    filename=CONFIG_NAME,
+                    revision=revision,
+                    cache_dir=cache_dir,
+                    force_download=force_download,
+                    proxies=proxies,
+                    resume_download=resume_download,
+                    token=token,
+                    local_files_only=local_files_only,
+                )
+            except HfHubHTTPError as e:
+                logger.info(f"{CONFIG_NAME} not found on the HuggingFace Hub: {str(e)}")
+
+        # Read config
+        config = None
+        if config_file is not None:
+            with open(config_file, "r", encoding="utf-8") as f:
+                config = json.load(f)
+
+            # Populate model_kwargs from config
+            for param in cls._hub_mixin_init_parameters.values():
+                if param.name not in model_kwargs and param.name in config:
+                    model_kwargs[param.name] = config[param.name]
+
+            # Check if `config` argument was passed at init
+            if "config" in cls._hub_mixin_init_parameters:
+                # Check if `config` argument is a dataclass
+                config_annotation = cls._hub_mixin_init_parameters["config"].annotation
+                if config_annotation is inspect.Parameter.empty:
+                    pass  # no annotation
+                elif is_dataclass(config_annotation):
+                    config = _load_dataclass(config_annotation, config)
+                else:
+                    # if Optional/Union annotation => check if a dataclass is in the Union
+                    for _sub_annotation in get_args(config_annotation):
+                        if is_dataclass(_sub_annotation):
+                            config = _load_dataclass(_sub_annotation, config)
+                            break
+
+                # Forward config to model initialization
+                model_kwargs["config"] = config
+
+            # Inject config if `**kwargs` are expected
+            if is_dataclass(cls):
+                for key in cls.__dataclass_fields__:
+                    if key not in model_kwargs and key in config:
+                        model_kwargs[key] = config[key]
+            elif any(param.kind == inspect.Parameter.VAR_KEYWORD for param in cls._hub_mixin_init_parameters.values()):
+                for key, value in config.items():
+                    if key not in model_kwargs:
+                        model_kwargs[key] = value
+
+            # Finally, also inject if `_from_pretrained` expects it
+            if cls._hub_mixin_inject_config:
+                model_kwargs["config"] = config
+
+        instance = cls._from_pretrained(
+            model_id=str(model_id),
+            revision=revision,
+            cache_dir=cache_dir,
+            force_download=force_download,
+            proxies=proxies,
+            resume_download=resume_download,
+            local_files_only=local_files_only,
+            token=token,
+            **model_kwargs,
+        )
+
+        # Implicitly set the config as instance attribute if not already set by the class
+        # This way `config` will be available when calling `save_pretrained` or `push_to_hub`.
+        if config is not None and (getattr(instance, "_hub_mixin_config", None) in (None, {})):
+            instance._hub_mixin_config = config
+
+        return instance
+
+    @classmethod
+    def _from_pretrained(
+        cls: Type[T],
+        *,
+        model_id: str,
+        revision: Optional[str],
+        cache_dir: Optional[Union[str, Path]],
+        force_download: bool,
+        proxies: Optional[Dict],
+        resume_download: bool,
+        local_files_only: bool,
+        token: Optional[Union[str, bool]],
+        **model_kwargs,
+    ) -> T:
+        """Overwrite this method in subclass to define how to load your model from pretrained.
+
+        Use [`hf_hub_download`] or [`snapshot_download`] to download files from the Hub before loading them. Most
+        args taken as input can be directly passed to those 2 methods. If needed, you can add more arguments to this
+        method using "model_kwargs". For example [`PyTorchModelHubMixin._from_pretrained`] takes as input a `map_location`
+        parameter to set on which device the model should be loaded.
+
+        Check out our [integration guide](../guides/integrations) for more instructions.
+
+        Args:
+            model_id (`str`):
+                ID of the model to load from the Huggingface Hub (e.g. `bigscience/bloom`).
+            revision (`str`, *optional*):
+                Revision of the model on the Hub. Can be a branch name, a git tag or any commit id. Defaults to the
+                latest commit on `main` branch.
+            force_download (`bool`, *optional*, defaults to `False`):
+                Whether to force (re-)downloading the model weights and configuration files from the Hub, overriding
+                the existing cache.
+            resume_download (`bool`, *optional*, defaults to `False`):
+                Whether to delete incompletely received files. Will attempt to resume the download if such a file exists.
+            proxies (`Dict[str, str]`, *optional*):
+                A dictionary of proxy servers to use by protocol or endpoint (e.g., `{'http': 'foo.bar:3128',
+                'http://hostname': 'foo.bar:4012'}`).
+            token (`str` or `bool`, *optional*):
+                The token to use as HTTP bearer authorization for remote files. By default, it will use the token
+                cached when running `huggingface-cli login`.
+            cache_dir (`str`, `Path`, *optional*):
+                Path to the folder where cached files are stored.
+            local_files_only (`bool`, *optional*, defaults to `False`):
+                If `True`, avoid downloading the file and return the path to the local cached file if it exists.
+            model_kwargs:
+                Additional keyword arguments passed along to the [`~ModelHubMixin._from_pretrained`] method.
+        """
+        raise NotImplementedError
+
+    @_deprecate_arguments(
+        version="0.23.0",
+        deprecated_args=["api_endpoint"],
+        custom_message="Use `HF_ENDPOINT` environment variable instead.",
+    )
+    @validate_hf_hub_args
+    def push_to_hub(
+        self,
+        repo_id: str,
+        *,
+        config: Optional[Union[dict, "DataclassInstance"]] = None,
+        commit_message: str = "Push model using huggingface_hub.",
+        private: bool = False,
+        token: Optional[str] = None,
+        branch: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        allow_patterns: Optional[Union[List[str], str]] = None,
+        ignore_patterns: Optional[Union[List[str], str]] = None,
+        delete_patterns: Optional[Union[List[str], str]] = None,
+        # TODO: remove once deprecated
+        api_endpoint: Optional[str] = None,
+    ) -> str:
+        """
+        Upload model checkpoint to the Hub.
+
+        Use `allow_patterns` and `ignore_patterns` to precisely filter which files should be pushed to the hub. Use
+        `delete_patterns` to delete existing remote files in the same commit. See [`upload_folder`] reference for more
+        details.
+
+        Args:
+            repo_id (`str`):
+                ID of the repository to push to (example: `"username/my-model"`).
+            config (`dict` or `DataclassInstance`, *optional*):
+                Model configuration specified as a key/value dictionary or a dataclass instance.
+            commit_message (`str`, *optional*):
+                Message to commit while pushing.
+            private (`bool`, *optional*, defaults to `False`):
+                Whether the repository created should be private.
+            api_endpoint (`str`, *optional*):
+                The API endpoint to use when pushing the model to the hub.
+            token (`str`, *optional*):
+                The token to use as HTTP bearer authorization for remote files. By default, it will use the token
+                cached when running `huggingface-cli login`.
+            branch (`str`, *optional*):
+                The git branch on which to push the model. This defaults to `"main"`.
+            create_pr (`boolean`, *optional*):
+                Whether or not to create a Pull Request from `branch` with that commit. Defaults to `False`.
+            allow_patterns (`List[str]` or `str`, *optional*):
+                If provided, only files matching at least one pattern are pushed.
+            ignore_patterns (`List[str]` or `str`, *optional*):
+                If provided, files matching any of the patterns are not pushed.
+            delete_patterns (`List[str]` or `str`, *optional*):
+                If provided, remote files matching any of the patterns will be deleted from the repo.
+
+        Returns:
+            The url of the commit of your model in the given repository.
+        """
+        api = HfApi(endpoint=api_endpoint, token=token)
+        repo_id = api.create_repo(repo_id=repo_id, private=private, exist_ok=True).repo_id
+
+        # Push the files to the repo in a single commit
+        with SoftTemporaryDirectory() as tmp:
+            saved_path = Path(tmp) / repo_id
+            self.save_pretrained(saved_path, config=config)
+            return api.upload_folder(
+                repo_id=repo_id,
+                repo_type="model",
+                folder_path=saved_path,
+                commit_message=commit_message,
+                revision=branch,
+                create_pr=create_pr,
+                allow_patterns=allow_patterns,
+                ignore_patterns=ignore_patterns,
+                delete_patterns=delete_patterns,
+            )
+
+    def generate_model_card(self, *args, **kwargs) -> ModelCard:
+        card = ModelCard.from_template(
+            card_data=ModelCardData(**asdict(self._hub_mixin_info)),
+            template_str=DEFAULT_MODEL_CARD,
+        )
+        return card
+
+
+class PyTorchModelHubMixin(ModelHubMixin):
+    """
+    Implementation of [`ModelHubMixin`] to provide model Hub upload/download capabilities to PyTorch models. The model
+    is set in evaluation mode by default using `model.eval()` (dropout modules are deactivated). To train the model,
+    you should first set it back in training mode with `model.train()`.
+
+    Example:
+
+    ```python
+    >>> import torch
+    >>> import torch.nn as nn
+    >>> from huggingface_hub import PyTorchModelHubMixin
+
+    >>> class MyModel(
+    ...         nn.Module,
+    ...         PyTorchModelHubMixin,
+    ...         library_name="keras-nlp",
+    ...         repo_url="https://github.com/keras-team/keras-nlp",
+    ...         docs_url="https://keras.io/keras_nlp/",
+    ...         # ^ optional metadata to generate model card
+    ...     ):
+    ...     def __init__(self, hidden_size: int = 512, vocab_size: int = 30000, output_size: int = 4):
+    ...         super().__init__()
+    ...         self.param = nn.Parameter(torch.rand(hidden_size, vocab_size))
+    ...         self.linear = nn.Linear(output_size, vocab_size)
+
+    ...     def forward(self, x):
+    ...         return self.linear(x + self.param)
+    >>> model = MyModel(hidden_size=256)
+
+    # Save model weights to local directory
+    >>> model.save_pretrained("my-awesome-model")
+
+    # Push model weights to the Hub
+    >>> model.push_to_hub("my-awesome-model")
+
+    # Download and initialize weights from the Hub
+    >>> model = MyModel.from_pretrained("username/my-awesome-model")
+    >>> model.hidden_size
+    256
+    ```
+    """
+
+    def __init_subclass__(cls, *args, tags: Optional[List[str]] = None, **kwargs) -> None:
+        tags = tags or []
+        tags.append("pytorch_model_hub_mixin")
+        kwargs["tags"] = tags
+        return super().__init_subclass__(*args, **kwargs)
+
+    def _save_pretrained(self, save_directory: Path) -> None:
+        """Save weights from a Pytorch model to a local directory."""
+        model_to_save = self.module if hasattr(self, "module") else self  # type: ignore
+        save_model_as_safetensor(model_to_save, str(save_directory / SAFETENSORS_SINGLE_FILE))
+
+    @classmethod
+    def _from_pretrained(
+        cls,
+        *,
+        model_id: str,
+        revision: Optional[str],
+        cache_dir: Optional[Union[str, Path]],
+        force_download: bool,
+        proxies: Optional[Dict],
+        resume_download: bool,
+        local_files_only: bool,
+        token: Union[str, bool, None],
+        map_location: str = "cpu",
+        strict: bool = False,
+        **model_kwargs,
+    ):
+        """Load Pytorch pretrained weights and return the loaded model."""
+        model = cls(**model_kwargs)
+        if os.path.isdir(model_id):
+            print("Loading weights from local directory")
+            model_file = os.path.join(model_id, SAFETENSORS_SINGLE_FILE)
+            return cls._load_as_safetensor(model, model_file, map_location, strict)
+        else:
+            try:
+                model_file = hf_hub_download(
+                    repo_id=model_id,
+                    filename=SAFETENSORS_SINGLE_FILE,
+                    revision=revision,
+                    cache_dir=cache_dir,
+                    force_download=force_download,
+                    proxies=proxies,
+                    resume_download=resume_download,
+                    token=token,
+                    local_files_only=local_files_only,
+                )
+                return cls._load_as_safetensor(model, model_file, map_location, strict)
+            except EntryNotFoundError:
+                model_file = hf_hub_download(
+                    repo_id=model_id,
+                    filename=PYTORCH_WEIGHTS_NAME,
+                    revision=revision,
+                    cache_dir=cache_dir,
+                    force_download=force_download,
+                    proxies=proxies,
+                    resume_download=resume_download,
+                    token=token,
+                    local_files_only=local_files_only,
+                )
+                return cls._load_as_pickle(model, model_file, map_location, strict)
+
+    @classmethod
+    def _load_as_pickle(cls, model: T, model_file: str, map_location: str, strict: bool) -> T:
+        state_dict = torch.load(model_file, map_location=torch.device(map_location))
+        model.load_state_dict(state_dict, strict=strict)  # type: ignore
+        model.eval()  # type: ignore
+        return model
+
+    @classmethod
+    def _load_as_safetensor(cls, model: T, model_file: str, map_location: str, strict: bool) -> T:
+        load_model_as_safetensor(model, model_file, strict=strict)  # type: ignore [arg-type]
+        if map_location != "cpu":
+            # TODO: remove this once https://github.com/huggingface/safetensors/pull/449 is merged.
+            logger.warning(
+                "Loading model weights on other devices than 'cpu' is not supported natively."
+                " This means that the model is loaded on 'cpu' first and then copied to the device."
+                " This leads to a slower loading time."
+                " Support for loading directly on other devices is planned to be added in future releases."
+                " See https://github.com/huggingface/huggingface_hub/pull/2086 for more details."
+            )
+            model.to(map_location)  # type: ignore [attr-defined]
+        return model
+
+
+def _load_dataclass(datacls: Type["DataclassInstance"], data: dict) -> "DataclassInstance":
+    """Load a dataclass instance from a dictionary.
+
+    Fields not expected by the dataclass are ignored.
+    """
+    return datacls(**{k: v for k, v in data.items() if k in datacls.__dataclass_fields__})
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/__init__.py b/llm/Lib/site-packages/huggingface_hub/inference/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b3b10645f2552f2dac4e95777416707e9bb455de
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/_client.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/_client.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e3d73fe23754c3723a793f641f280767ce8661dd
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/_client.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/_common.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/_common.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e7d5d215751522522497362840ac537b5b4f4e3
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/_common.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/_templating.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/_templating.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4def7340f9f3f8b3123356b4f685560e0f0a0ff5
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/_templating.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/_types.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/_types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bfeaea6cb43b9797e266141054c8b0407de17250
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/__pycache__/_types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_client.py b/llm/Lib/site-packages/huggingface_hub/inference/_client.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e9f5faa5b3890a1a17da6f981df3f6052ace841
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_client.py
@@ -0,0 +1,2354 @@
+# coding=utf-8
+# Copyright 2023-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Related resources:
+#    https://huggingface.co/tasks
+#    https://huggingface.co/docs/huggingface.js/inference/README
+#    https://github.com/huggingface/huggingface.js/tree/main/packages/inference/src
+#    https://github.com/huggingface/text-generation-inference/tree/main/clients/python
+#    https://github.com/huggingface/text-generation-inference/blob/main/clients/python/text_generation/client.py
+#    https://huggingface.slack.com/archives/C03E4DQ9LAJ/p1680169099087869
+#    https://github.com/huggingface/unity-api#tasks
+#
+# Some TODO:
+# - add all tasks
+#
+# NOTE: the philosophy of this client is "let's make it as easy as possible to use it, even if less optimized". Some
+# examples of how it translates:
+# - Timeout / Server unavailable is handled by the client in a single "timeout" parameter.
+# - Files can be provided as bytes, file paths, or URLs and the client will try to "guess" the type.
+# - Images are parsed as PIL.Image for easier manipulation.
+# - Provides a "recommended model" for each task => suboptimal but user-wise quicker to get a first script running.
+# - Only the main parameters are publicly exposed. Power users can always read the docs for more options.
+import base64
+import logging
+import time
+import warnings
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    Iterable,
+    List,
+    Literal,
+    Optional,
+    Union,
+    overload,
+)
+
+from requests import HTTPError
+from requests.structures import CaseInsensitiveDict
+
+from huggingface_hub.constants import ALL_INFERENCE_API_FRAMEWORKS, INFERENCE_ENDPOINT, MAIN_INFERENCE_API_FRAMEWORKS
+from huggingface_hub.errors import InferenceTimeoutError
+from huggingface_hub.inference._common import (
+    TASKS_EXPECTING_IMAGES,
+    ContentT,
+    ModelStatus,
+    _b64_encode,
+    _b64_to_image,
+    _bytes_to_dict,
+    _bytes_to_image,
+    _bytes_to_list,
+    _fetch_recommended_models,
+    _import_numpy,
+    _is_chat_completion_server,
+    _is_tgi_server,
+    _open_as_binary,
+    _set_as_non_chat_completion_server,
+    _set_as_non_tgi,
+    _stream_chat_completion_response_from_bytes,
+    _stream_chat_completion_response_from_text_generation,
+    _stream_text_generation_response,
+    raise_text_generation_error,
+)
+from huggingface_hub.inference._generated.types import (
+    AudioClassificationOutputElement,
+    AudioToAudioOutputElement,
+    AutomaticSpeechRecognitionOutput,
+    ChatCompletionOutput,
+    ChatCompletionOutputChoice,
+    ChatCompletionOutputChoiceMessage,
+    ChatCompletionStreamOutput,
+    DocumentQuestionAnsweringOutputElement,
+    FillMaskOutputElement,
+    ImageClassificationOutputElement,
+    ImageSegmentationOutputElement,
+    ImageToTextOutput,
+    ObjectDetectionOutputElement,
+    QuestionAnsweringOutputElement,
+    SummarizationOutput,
+    TableQuestionAnsweringOutputElement,
+    TextClassificationOutputElement,
+    TextGenerationOutput,
+    TextGenerationStreamOutput,
+    TokenClassificationOutputElement,
+    TranslationOutput,
+    VisualQuestionAnsweringOutputElement,
+    ZeroShotClassificationOutputElement,
+    ZeroShotImageClassificationOutputElement,
+)
+from huggingface_hub.inference._templating import render_chat_prompt
+from huggingface_hub.inference._types import (
+    ConversationalOutput,  # soon to be removed
+)
+from huggingface_hub.utils import (
+    BadRequestError,
+    build_hf_headers,
+    get_session,
+    hf_raise_for_status,
+)
+
+
+if TYPE_CHECKING:
+    import numpy as np
+    from PIL import Image
+
+logger = logging.getLogger(__name__)
+
+
+class InferenceClient:
+    """
+    Initialize a new Inference Client.
+
+    [`InferenceClient`] aims to provide a unified experience to perform inference. The client can be used
+    seamlessly with either the (free) Inference API or self-hosted Inference Endpoints.
+
+    Args:
+        model (`str`, `optional`):
+            The model to run inference with. Can be a model id hosted on the Hugging Face Hub, e.g. `bigcode/starcoder`
+            or a URL to a deployed Inference Endpoint. Defaults to None, in which case a recommended model is
+            automatically selected for the task.
+        token (`str` or `bool`, *optional*):
+            Hugging Face token. Will default to the locally saved token if not provided.
+            Pass `token=False` if you don't want to send your token to the server.
+        timeout (`float`, `optional`):
+            The maximum number of seconds to wait for a response from the server. Loading a new model in Inference
+            API can take up to several minutes. Defaults to None, meaning it will loop until the server is available.
+        headers (`Dict[str, str]`, `optional`):
+            Additional headers to send to the server. By default only the authorization and user-agent headers are sent.
+            Values in this dictionary will override the default values.
+        cookies (`Dict[str, str]`, `optional`):
+            Additional cookies to send to the server.
+    """
+
+    def __init__(
+        self,
+        model: Optional[str] = None,
+        token: Union[str, bool, None] = None,
+        timeout: Optional[float] = None,
+        headers: Optional[Dict[str, str]] = None,
+        cookies: Optional[Dict[str, str]] = None,
+    ) -> None:
+        self.model: Optional[str] = model
+        self.token: Union[str, bool, None] = token
+        self.headers = CaseInsensitiveDict(build_hf_headers(token=token))  # contains 'authorization' + 'user-agent'
+        if headers is not None:
+            self.headers.update(headers)
+        self.cookies = cookies
+        self.timeout = timeout
+
+    def __repr__(self):
+        return f"<InferenceClient(model='{self.model if self.model else ''}', timeout={self.timeout})>"
+
+    @overload
+    def post(  # type: ignore[misc]
+        self,
+        *,
+        json: Optional[Union[str, Dict, List]] = None,
+        data: Optional[ContentT] = None,
+        model: Optional[str] = None,
+        task: Optional[str] = None,
+        stream: Literal[False] = ...,
+    ) -> bytes: ...
+
+    @overload
+    def post(  # type: ignore[misc]
+        self,
+        *,
+        json: Optional[Union[str, Dict, List]] = None,
+        data: Optional[ContentT] = None,
+        model: Optional[str] = None,
+        task: Optional[str] = None,
+        stream: Literal[True] = ...,
+    ) -> Iterable[bytes]: ...
+
+    @overload
+    def post(
+        self,
+        *,
+        json: Optional[Union[str, Dict, List]] = None,
+        data: Optional[ContentT] = None,
+        model: Optional[str] = None,
+        task: Optional[str] = None,
+        stream: bool = False,
+    ) -> Union[bytes, Iterable[bytes]]: ...
+
+    def post(
+        self,
+        *,
+        json: Optional[Union[str, Dict, List]] = None,
+        data: Optional[ContentT] = None,
+        model: Optional[str] = None,
+        task: Optional[str] = None,
+        stream: bool = False,
+    ) -> Union[bytes, Iterable[bytes]]:
+        """
+        Make a POST request to the inference server.
+
+        Args:
+            json (`Union[str, Dict, List]`, *optional*):
+                The JSON data to send in the request body, specific to each task. Defaults to None.
+            data (`Union[str, Path, bytes, BinaryIO]`, *optional*):
+                The content to send in the request body, specific to each task.
+                It can be raw bytes, a pointer to an opened file, a local file path,
+                or a URL to an online resource (image, audio file,...). If both `json` and `data` are passed,
+                `data` will take precedence. At least `json` or `data` must be provided. Defaults to None.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. Will override the model defined at the instance level. Defaults to None.
+            task (`str`, *optional*):
+                The task to perform on the inference. All available tasks can be found
+                [here](https://huggingface.co/tasks). Used only to default to a recommended model if `model` is not
+                provided. At least `model` or `task` must be provided. Defaults to None.
+            stream (`bool`, *optional*):
+                Whether to iterate over streaming APIs.
+
+        Returns:
+            bytes: The raw bytes returned by the server.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+        """
+        url = self._resolve_url(model, task)
+
+        if data is not None and json is not None:
+            warnings.warn("Ignoring `json` as `data` is passed as binary.")
+
+        # Set Accept header if relevant
+        headers = self.headers.copy()
+        if task in TASKS_EXPECTING_IMAGES and "Accept" not in headers:
+            headers["Accept"] = "image/png"
+
+        t0 = time.time()
+        timeout = self.timeout
+        while True:
+            with _open_as_binary(data) as data_as_binary:
+                try:
+                    response = get_session().post(
+                        url,
+                        json=json,
+                        data=data_as_binary,
+                        headers=headers,
+                        cookies=self.cookies,
+                        timeout=self.timeout,
+                        stream=stream,
+                    )
+                except TimeoutError as error:
+                    # Convert any `TimeoutError` to a `InferenceTimeoutError`
+                    raise InferenceTimeoutError(f"Inference call timed out: {url}") from error  # type: ignore
+
+            try:
+                hf_raise_for_status(response)
+                return response.iter_lines() if stream else response.content
+            except HTTPError as error:
+                if error.response.status_code == 422 and task is not None:
+                    error.args = (
+                        f"{error.args[0]}\nMake sure '{task}' task is supported by the model.",
+                    ) + error.args[1:]
+                if error.response.status_code == 503:
+                    # If Model is unavailable, either raise a TimeoutError...
+                    if timeout is not None and time.time() - t0 > timeout:
+                        raise InferenceTimeoutError(
+                            f"Model not loaded on the server: {url}. Please retry with a higher timeout (current:"
+                            f" {self.timeout}).",
+                            request=error.request,
+                            response=error.response,
+                        ) from error
+                    # ...or wait 1s and retry
+                    logger.info(f"Waiting for model to be loaded on the server: {error}")
+                    time.sleep(1)
+                    if timeout is not None:
+                        timeout = max(self.timeout - (time.time() - t0), 1)  # type: ignore
+                    continue
+                raise
+
+    def audio_classification(
+        self,
+        audio: ContentT,
+        *,
+        model: Optional[str] = None,
+    ) -> List[AudioClassificationOutputElement]:
+        """
+        Perform audio classification on the provided audio content.
+
+        Args:
+            audio (Union[str, Path, bytes, BinaryIO]):
+                The audio content to classify. It can be raw audio bytes, a local audio file, or a URL pointing to an
+                audio file.
+            model (`str`, *optional*):
+                The model to use for audio classification. Can be a model ID hosted on the Hugging Face Hub
+                or a URL to a deployed Inference Endpoint. If not provided, the default recommended model for
+                audio classification will be used.
+
+        Returns:
+            `List[AudioClassificationOutputElement]`: List of [`AudioClassificationOutputElement`] items containing the predicted labels and their confidence.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.audio_classification("audio.flac")
+        [
+            AudioClassificationOutputElement(score=0.4976358711719513, label='hap'),
+            AudioClassificationOutputElement(score=0.3677836060523987, label='neu'),
+            ...
+        ]
+        ```
+        """
+        response = self.post(data=audio, model=model, task="audio-classification")
+        return AudioClassificationOutputElement.parse_obj_as_list(response)
+
+    def audio_to_audio(
+        self,
+        audio: ContentT,
+        *,
+        model: Optional[str] = None,
+    ) -> List[AudioToAudioOutputElement]:
+        """
+        Performs multiple tasks related to audio-to-audio depending on the model (eg: speech enhancement, source separation).
+
+        Args:
+            audio (Union[str, Path, bytes, BinaryIO]):
+                The audio content for the model. It can be raw audio bytes, a local audio file, or a URL pointing to an
+                audio file.
+            model (`str`, *optional*):
+                The model can be any model which takes an audio file and returns another audio file. Can be a model ID hosted on the Hugging Face Hub
+                or a URL to a deployed Inference Endpoint. If not provided, the default recommended model for
+                audio_to_audio will be used.
+
+        Returns:
+            `List[AudioToAudioOutputElement]`: A list of [`AudioToAudioOutputElement`] items containing audios label, content-type, and audio content in blob.
+
+        Raises:
+            `InferenceTimeoutError`:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> audio_output = client.audio_to_audio("audio.flac")
+        >>> for i, item in enumerate(audio_output):
+        >>>     with open(f"output_{i}.flac", "wb") as f:
+                    f.write(item.blob)
+        ```
+        """
+        response = self.post(data=audio, model=model, task="audio-to-audio")
+        audio_output = AudioToAudioOutputElement.parse_obj_as_list(response)
+        for item in audio_output:
+            item.blob = base64.b64decode(item.blob)
+        return audio_output
+
+    def automatic_speech_recognition(
+        self,
+        audio: ContentT,
+        *,
+        model: Optional[str] = None,
+    ) -> AutomaticSpeechRecognitionOutput:
+        """
+        Perform automatic speech recognition (ASR or audio-to-text) on the given audio content.
+
+        Args:
+            audio (Union[str, Path, bytes, BinaryIO]):
+                The content to transcribe. It can be raw audio bytes, local audio file, or a URL to an audio file.
+            model (`str`, *optional*):
+                The model to use for ASR. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. If not provided, the default recommended model for ASR will be used.
+
+        Returns:
+            [`AutomaticSpeechRecognitionOutput`]: An item containing the transcribed text and optionally the timestamp chunks.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.automatic_speech_recognition("hello_world.flac").text
+        "hello world"
+        ```
+        """
+        response = self.post(data=audio, model=model, task="automatic-speech-recognition")
+        return AutomaticSpeechRecognitionOutput.parse_obj_as_instance(response)
+
+    @overload
+    def chat_completion(  # type: ignore
+        self,
+        messages: List[Dict[str, str]],
+        *,
+        model: Optional[str] = None,
+        stream: Literal[False] = False,
+        max_tokens: int = 20,
+        seed: Optional[int] = None,
+        stop: Optional[Union[List[str], str]] = None,
+        temperature: float = 1.0,
+        top_p: Optional[float] = None,
+    ) -> ChatCompletionOutput: ...
+
+    @overload
+    def chat_completion(  # type: ignore
+        self,
+        messages: List[Dict[str, str]],
+        *,
+        model: Optional[str] = None,
+        stream: Literal[True] = True,
+        max_tokens: int = 20,
+        seed: Optional[int] = None,
+        stop: Optional[Union[List[str], str]] = None,
+        temperature: float = 1.0,
+        top_p: Optional[float] = None,
+    ) -> Iterable[ChatCompletionStreamOutput]: ...
+
+    @overload
+    def chat_completion(
+        self,
+        messages: List[Dict[str, str]],
+        *,
+        model: Optional[str] = None,
+        stream: bool = False,
+        max_tokens: int = 20,
+        seed: Optional[int] = None,
+        stop: Optional[Union[List[str], str]] = None,
+        temperature: float = 1.0,
+        top_p: Optional[float] = None,
+    ) -> Union[ChatCompletionOutput, Iterable[ChatCompletionStreamOutput]]: ...
+
+    def chat_completion(
+        self,
+        messages: List[Dict[str, str]],
+        *,
+        model: Optional[str] = None,
+        stream: bool = False,
+        max_tokens: int = 20,
+        seed: Optional[int] = None,
+        stop: Optional[Union[List[str], str]] = None,
+        temperature: float = 1.0,
+        top_p: Optional[float] = None,
+    ) -> Union[ChatCompletionOutput, Iterable[ChatCompletionStreamOutput]]:
+        """
+        A method for completing conversations using a specified language model.
+
+        <Tip>
+
+        If the model is served by a server supporting chat-completion, the method will directly call the server's
+        `/v1/chat/completions` endpoint. If the server does not support chat-completion, the method will render the
+        chat template client-side based on the information fetched from the Hub API. In this case, you will need to
+        have `minijinja` template engine installed. Run `pip install "huggingface_hub[inference]"` or `pip install minijinja`
+        to install it.
+
+        </Tip>
+
+        Args:
+            messages (List[Union[`SystemMessage`, `UserMessage`, `AssistantMessage`]]):
+                Conversation history consisting of roles and content pairs.
+            model (`str`, *optional*):
+                The model to use for chat-completion. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. If not provided, the default recommended model for chat-based text-generation will be used.
+                See https://huggingface.co/tasks/text-generation for more details.
+            frequency_penalty (`float`, optional):
+                Penalizes new tokens based on their existing frequency
+                in the text so far. Range: [-2.0, 2.0]. Defaults to 0.0.
+            max_tokens (`int`, optional):
+                Maximum number of tokens allowed in the response. Defaults to 20.
+            seed (Optional[`int`], optional):
+                Seed for reproducible control flow. Defaults to None.
+            stop (Optional[`str`], optional):
+                Up to four strings which trigger the end of the response.
+                Defaults to None.
+            stream (`bool`, optional):
+                Enable realtime streaming of responses. Defaults to False.
+            temperature (`float`, optional):
+                Controls randomness of the generations. Lower values ensure
+                less random completions. Range: [0, 2]. Defaults to 1.0.
+            top_p (`float`, optional):
+                Fraction of the most likely next words to sample from.
+                Must be between 0 and 1. Defaults to 1.0.
+
+        Returns:
+            `Union[ChatCompletionOutput, Iterable[ChatCompletionStreamOutput]]`:
+            Generated text returned from the server:
+            - if `stream=False`, the generated text is returned as a [`ChatCompletionOutput`] (default).
+            - if `stream=True`, the generated text is returned token by token as a sequence of [`ChatCompletionStreamOutput`].
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> messages = [{"role": "user", "content": "What is the capital of France?"}]
+        >>> client = InferenceClient("HuggingFaceH4/zephyr-7b-beta")
+        >>> client.chat_completion(messages, max_tokens=100)
+        ChatCompletionOutput(
+            choices=[
+                ChatCompletionOutputChoice(
+                    finish_reason='eos_token',
+                    index=0,
+                    message=ChatCompletionOutputChoiceMessage(
+                        content='The capital of France is Paris. The official name of the city is "Ville de Paris" (City of Paris) and the name of the country\'s governing body, which is located in Paris, is "La République française" (The French Republic). \nI hope that helps! Let me know if you need any further information.'
+                    )
+                )
+            ],
+            created=1710498360
+        )
+
+        >>> for token in client.chat_completion(messages, max_tokens=10, stream=True):
+        ...     print(token)
+        ChatCompletionStreamOutput(choices=[ChatCompletionStreamOutputChoice(delta=ChatCompletionStreamOutputDelta(content='The', role='assistant'), index=0, finish_reason=None)], created=1710498504)
+        ChatCompletionStreamOutput(choices=[ChatCompletionStreamOutputChoice(delta=ChatCompletionStreamOutputDelta(content=' capital', role='assistant'), index=0, finish_reason=None)], created=1710498504)
+        (...)
+        ChatCompletionStreamOutput(choices=[ChatCompletionStreamOutputChoice(delta=ChatCompletionStreamOutputDelta(content=' may', role='assistant'), index=0, finish_reason=None)], created=1710498504)
+        ChatCompletionStreamOutput(choices=[ChatCompletionStreamOutputChoice(delta=ChatCompletionStreamOutputDelta(content=None, role=None), index=0, finish_reason='length')], created=1710498504)
+        ```
+        """
+        # determine model
+        model = model or self.model or self.get_recommended_model("text-generation")
+
+        if _is_chat_completion_server(model):
+            # First, let's consider the server has a `/v1/chat/completions` endpoint.
+            # If that's the case, we don't have to render the chat template client-side.
+            model_url = self._resolve_url(model)
+            if not model_url.endswith("/chat/completions"):
+                model_url += "/v1/chat/completions"
+
+            try:
+                data = self.post(
+                    model=model_url,
+                    json=dict(
+                        model="tgi",  # random string
+                        messages=messages,
+                        max_tokens=max_tokens,
+                        seed=seed,
+                        stop=stop,
+                        temperature=temperature,
+                        top_p=top_p,
+                        stream=stream,
+                    ),
+                    stream=stream,
+                )
+            except HTTPError:
+                # Let's consider the server is not a chat completion server.
+                # Then we call again `chat_completion` which will render the chat template client side.
+                # (can be HTTP 500, HTTP 400, HTTP 404 depending on the server)
+                _set_as_non_chat_completion_server(model)
+                return self.chat_completion(
+                    messages=messages,
+                    model=model,
+                    stream=stream,
+                    max_tokens=max_tokens,
+                    seed=seed,
+                    stop=stop,
+                    temperature=temperature,
+                    top_p=top_p,
+                )
+
+            if stream:
+                return _stream_chat_completion_response_from_bytes(data)  # type: ignore[arg-type]
+
+            return ChatCompletionOutput.parse_obj_as_instance(data)  # type: ignore[arg-type]
+
+        # At this point, we know the server is not a chat completion server.
+        # We need to render the chat template client side based on the information we can fetch from
+        # the Hub API.
+
+        model_id = None
+        if model.startswith(("http://", "https://")):
+            # If URL, we need to know which model is served. This is not always possible.
+            # A workaround is to list the user Inference Endpoints and check if one of them correspond to the model URL.
+            # If not, we raise an error.
+            # TODO: fix when we have a proper API for this (at least for Inference Endpoints)
+            # TODO: what if Sagemaker URL?
+            # TODO: what if Azure URL?
+            from ..hf_api import HfApi
+
+            for endpoint in HfApi(token=self.token).list_inference_endpoints():
+                if endpoint.url == model:
+                    model_id = endpoint.repository
+                    break
+        else:
+            model_id = model
+
+        if model_id is None:
+            # If we don't have the model ID, we can't fetch the chat template.
+            # We raise an error.
+            raise ValueError(
+                "Request can't be processed as the model ID can't be inferred from model URL. "
+                "This is needed to fetch the chat template from the Hub since the model is not "
+                "served with a Chat-completion API."
+            )
+
+        # fetch chat template + tokens
+        prompt = render_chat_prompt(model_id=model_id, token=self.token, messages=messages)
+
+        # generate response
+        stop_sequences = [stop] if isinstance(stop, str) else stop
+        text_generation_output = self.text_generation(
+            prompt=prompt,
+            details=True,
+            stream=stream,
+            model=model,
+            max_new_tokens=max_tokens,
+            seed=seed,
+            stop_sequences=stop_sequences,
+            temperature=temperature,
+            top_p=top_p,
+        )
+
+        created = int(time.time())
+
+        if stream:
+            return _stream_chat_completion_response_from_text_generation(text_generation_output)  # type: ignore [arg-type]
+
+        if isinstance(text_generation_output, TextGenerationOutput):
+            # General use case => format ChatCompletionOutput from text generation details
+            content: str = text_generation_output.generated_text
+            finish_reason: str = text_generation_output.details.finish_reason  # type: ignore[union-attr]
+        else:
+            # Corner case: if server doesn't support details (e.g. if not a TGI server), we only receive an output string.
+            # In such a case, `finish_reason` is set to `"unk"`.
+            content = text_generation_output  # type: ignore[assignment]
+            finish_reason = "unk"
+
+        return ChatCompletionOutput(
+            created=created,
+            choices=[
+                ChatCompletionOutputChoice(
+                    finish_reason=finish_reason,  # type: ignore
+                    index=0,
+                    message=ChatCompletionOutputChoiceMessage(
+                        content=content,
+                        role="assistant",
+                    ),
+                )
+            ],
+        )
+
+    def conversational(
+        self,
+        text: str,
+        generated_responses: Optional[List[str]] = None,
+        past_user_inputs: Optional[List[str]] = None,
+        *,
+        parameters: Optional[Dict[str, Any]] = None,
+        model: Optional[str] = None,
+    ) -> ConversationalOutput:
+        """
+        Generate conversational responses based on the given input text (i.e. chat with the API).
+
+        <Tip warning={true}>
+
+        [`InferenceClient.conversational`] API is deprecated and will be removed in a future release. Please use
+        [`InferenceClient.chat_completion`] instead.
+
+        </Tip>
+
+        Args:
+            text (`str`):
+                The last input from the user in the conversation.
+            generated_responses (`List[str]`, *optional*):
+                A list of strings corresponding to the earlier replies from the model. Defaults to None.
+            past_user_inputs (`List[str]`, *optional*):
+                A list of strings corresponding to the earlier replies from the user. Should be the same length as
+                `generated_responses`. Defaults to None.
+            parameters (`Dict[str, Any]`, *optional*):
+                Additional parameters for the conversational task. Defaults to None. For more details about the available
+                parameters, please refer to [this page](https://huggingface.co/docs/api-inference/detailed_parameters#conversational-task)
+            model (`str`, *optional*):
+                The model to use for the conversational task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended conversational model will be used.
+                Defaults to None.
+
+        Returns:
+            `Dict`: The generated conversational output.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> output = client.conversational("Hi, who are you?")
+        >>> output
+        {'generated_text': 'I am the one who knocks.', 'conversation': {'generated_responses': ['I am the one who knocks.'], 'past_user_inputs': ['Hi, who are you?']}, 'warnings': ['Setting `pad_token_id` to `eos_token_id`:50256 for open-end generation.']}
+        >>> client.conversational(
+        ...     "Wow, that's scary!",
+        ...     generated_responses=output["conversation"]["generated_responses"],
+        ...     past_user_inputs=output["conversation"]["past_user_inputs"],
+        ... )
+        ```
+        """
+        warnings.warn(
+            "'InferenceClient.conversational' is deprecated and will be removed starting from huggingface_hub>=0.25. "
+            "Please use the more appropriate 'InferenceClient.chat_completion' API instead.",
+            FutureWarning,
+        )
+        payload: Dict[str, Any] = {"inputs": {"text": text}}
+        if generated_responses is not None:
+            payload["inputs"]["generated_responses"] = generated_responses
+        if past_user_inputs is not None:
+            payload["inputs"]["past_user_inputs"] = past_user_inputs
+        if parameters is not None:
+            payload["parameters"] = parameters
+        response = self.post(json=payload, model=model, task="conversational")
+        return _bytes_to_dict(response)  # type: ignore
+
+    def document_question_answering(
+        self,
+        image: ContentT,
+        question: str,
+        *,
+        model: Optional[str] = None,
+    ) -> List[DocumentQuestionAnsweringOutputElement]:
+        """
+        Answer questions on document images.
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The input image for the context. It can be raw bytes, an image file, or a URL to an online image.
+            question (`str`):
+                Question to be answered.
+            model (`str`, *optional*):
+                The model to use for the document question answering task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended document question answering model will be used.
+                Defaults to None.
+
+        Returns:
+            `List[DocumentQuestionAnsweringOutputElement]`: a list of [`DocumentQuestionAnsweringOutputElement`] items containing the predicted label, associated probability, word ids, and page number.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.document_question_answering(image="https://huggingface.co/spaces/impira/docquery/resolve/2359223c1837a7587402bda0f2643382a6eefeab/invoice.png", question="What is the invoice number?")
+        [DocumentQuestionAnsweringOutputElement(score=0.42515629529953003, answer='us-001', start=16, end=16)]
+        ```
+        """
+        payload: Dict[str, Any] = {"question": question, "image": _b64_encode(image)}
+        response = self.post(json=payload, model=model, task="document-question-answering")
+        return DocumentQuestionAnsweringOutputElement.parse_obj_as_list(response)
+
+    def feature_extraction(self, text: str, *, model: Optional[str] = None) -> "np.ndarray":
+        """
+        Generate embeddings for a given text.
+
+        Args:
+            text (`str`):
+                The text to embed.
+            model (`str`, *optional*):
+                The model to use for the conversational task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended conversational model will be used.
+                Defaults to None.
+
+        Returns:
+            `np.ndarray`: The embedding representing the input text as a float32 numpy array.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.feature_extraction("Hi, who are you?")
+        array([[ 2.424802  ,  2.93384   ,  1.1750331 , ...,  1.240499, -0.13776633, -0.7889173 ],
+        [-0.42943227, -0.6364878 , -1.693462  , ...,  0.41978157, -2.4336355 ,  0.6162071 ],
+        ...,
+        [ 0.28552425, -0.928395  , -1.2077185 , ...,  0.76810825, -2.1069427 ,  0.6236161 ]], dtype=float32)
+        ```
+        """
+        response = self.post(json={"inputs": text}, model=model, task="feature-extraction")
+        np = _import_numpy()
+        return np.array(_bytes_to_dict(response), dtype="float32")
+
+    def fill_mask(self, text: str, *, model: Optional[str] = None) -> List[FillMaskOutputElement]:
+        """
+        Fill in a hole with a missing word (token to be precise).
+
+        Args:
+            text (`str`):
+                a string to be filled from, must contain the [MASK] token (check model card for exact name of the mask).
+            model (`str`, *optional*):
+                The model to use for the fill mask task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended fill mask model will be used.
+                Defaults to None.
+
+        Returns:
+            `List[FillMaskOutputElement]`: a list of [`FillMaskOutputElement`] items containing the predicted label, associated
+            probability, token reference, and completed text.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.fill_mask("The goal of life is <mask>.")
+        [
+            FillMaskOutputElement(score=0.06897063553333282, token=11098, token_str=' happiness', sequence='The goal of life is happiness.'),
+            FillMaskOutputElement(score=0.06554922461509705, token=45075, token_str=' immortality', sequence='The goal of life is immortality.')
+        ]
+        ```
+        """
+        response = self.post(json={"inputs": text}, model=model, task="fill-mask")
+        return FillMaskOutputElement.parse_obj_as_list(response)
+
+    def image_classification(
+        self,
+        image: ContentT,
+        *,
+        model: Optional[str] = None,
+    ) -> List[ImageClassificationOutputElement]:
+        """
+        Perform image classification on the given image using the specified model.
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The image to classify. It can be raw bytes, an image file, or a URL to an online image.
+            model (`str`, *optional*):
+                The model to use for image classification. Can be a model ID hosted on the Hugging Face Hub or a URL to a
+                deployed Inference Endpoint. If not provided, the default recommended model for image classification will be used.
+
+        Returns:
+            `List[ImageClassificationOutputElement]`: a list of [`ImageClassificationOutputElement`] items containing the predicted label and associated probability.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.image_classification("https://upload.wikimedia.org/wikipedia/commons/thumb/4/43/Cute_dog.jpg/320px-Cute_dog.jpg")
+        [ImageClassificationOutputElement(score=0.9779096841812134, label='Blenheim spaniel'), ...]
+        ```
+        """
+        response = self.post(data=image, model=model, task="image-classification")
+        return ImageClassificationOutputElement.parse_obj_as_list(response)
+
+    def image_segmentation(
+        self,
+        image: ContentT,
+        *,
+        model: Optional[str] = None,
+    ) -> List[ImageSegmentationOutputElement]:
+        """
+        Perform image segmentation on the given image using the specified model.
+
+        <Tip warning={true}>
+
+        You must have `PIL` installed if you want to work with images (`pip install Pillow`).
+
+        </Tip>
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The image to segment. It can be raw bytes, an image file, or a URL to an online image.
+            model (`str`, *optional*):
+                The model to use for image segmentation. Can be a model ID hosted on the Hugging Face Hub or a URL to a
+                deployed Inference Endpoint. If not provided, the default recommended model for image segmentation will be used.
+
+        Returns:
+            `List[ImageSegmentationOutputElement]`: A list of [`ImageSegmentationOutputElement`] items containing the segmented masks and associated attributes.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.image_segmentation("cat.jpg"):
+        [ImageSegmentationOutputElement(score=0.989008, label='LABEL_184', mask=<PIL.PngImagePlugin.PngImageFile image mode=L size=400x300 at 0x7FDD2B129CC0>), ...]
+        ```
+        """
+        response = self.post(data=image, model=model, task="image-segmentation")
+        output = ImageSegmentationOutputElement.parse_obj_as_list(response)
+        for item in output:
+            item.mask = _b64_to_image(item.mask)
+        return output
+
+    def image_to_image(
+        self,
+        image: ContentT,
+        prompt: Optional[str] = None,
+        *,
+        negative_prompt: Optional[str] = None,
+        height: Optional[int] = None,
+        width: Optional[int] = None,
+        num_inference_steps: Optional[int] = None,
+        guidance_scale: Optional[float] = None,
+        model: Optional[str] = None,
+        **kwargs,
+    ) -> "Image":
+        """
+        Perform image-to-image translation using a specified model.
+
+        <Tip warning={true}>
+
+        You must have `PIL` installed if you want to work with images (`pip install Pillow`).
+
+        </Tip>
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The input image for translation. It can be raw bytes, an image file, or a URL to an online image.
+            prompt (`str`, *optional*):
+                The text prompt to guide the image generation.
+            negative_prompt (`str`, *optional*):
+                A negative prompt to guide the translation process.
+            height (`int`, *optional*):
+                The height in pixels of the generated image.
+            width (`int`, *optional*):
+                The width in pixels of the generated image.
+            num_inference_steps (`int`, *optional*):
+                The number of denoising steps. More denoising steps usually lead to a higher quality image at the
+                expense of slower inference.
+            guidance_scale (`float`, *optional*):
+                Higher guidance scale encourages to generate images that are closely linked to the text `prompt`,
+                usually at the expense of lower image quality.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            `Image`: The translated image.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> image = client.image_to_image("cat.jpg", prompt="turn the cat into a tiger")
+        >>> image.save("tiger.jpg")
+        ```
+        """
+        parameters = {
+            "prompt": prompt,
+            "negative_prompt": negative_prompt,
+            "height": height,
+            "width": width,
+            "num_inference_steps": num_inference_steps,
+            "guidance_scale": guidance_scale,
+            **kwargs,
+        }
+        if all(parameter is None for parameter in parameters.values()):
+            # Either only an image to send => send as raw bytes
+            data = image
+            payload: Optional[Dict[str, Any]] = None
+        else:
+            # Or an image + some parameters => use base64 encoding
+            data = None
+            payload = {"inputs": _b64_encode(image)}
+            for key, value in parameters.items():
+                if value is not None:
+                    payload.setdefault("parameters", {})[key] = value
+
+        response = self.post(json=payload, data=data, model=model, task="image-to-image")
+        return _bytes_to_image(response)
+
+    def image_to_text(self, image: ContentT, *, model: Optional[str] = None) -> ImageToTextOutput:
+        """
+        Takes an input image and return text.
+
+        Models can have very different outputs depending on your use case (image captioning, optical character recognition
+        (OCR), Pix2Struct, etc). Please have a look to the model card to learn more about a model's specificities.
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The input image to caption. It can be raw bytes, an image file, or a URL to an online image..
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            [`ImageToTextOutput`]: The generated text.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.image_to_text("cat.jpg")
+        'a cat standing in a grassy field '
+        >>> client.image_to_text("https://upload.wikimedia.org/wikipedia/commons/thumb/4/43/Cute_dog.jpg/320px-Cute_dog.jpg")
+        'a dog laying on the grass next to a flower pot '
+        ```
+        """
+        response = self.post(data=image, model=model, task="image-to-text")
+        return ImageToTextOutput.parse_obj_as_instance(response)
+
+    def list_deployed_models(
+        self, frameworks: Union[None, str, Literal["all"], List[str]] = None
+    ) -> Dict[str, List[str]]:
+        """
+        List models currently deployed on the Inference API service.
+
+        This helper checks deployed models framework by framework. By default, it will check the 4 main frameworks that
+        are supported and account for 95% of the hosted models. However, if you want a complete list of models you can
+        specify `frameworks="all"` as input. Alternatively, if you know before-hand which framework you are interested
+        in, you can also restrict to search to this one (e.g. `frameworks="text-generation-inference"`). The more
+        frameworks are checked, the more time it will take.
+
+        <Tip>
+
+        This endpoint is mostly useful for discoverability. If you already know which model you want to use and want to
+        check its availability, you can directly use [`~InferenceClient.get_model_status`].
+
+        </Tip>
+
+        Args:
+            frameworks (`Literal["all"]` or `List[str]` or `str`, *optional*):
+                The frameworks to filter on. By default only a subset of the available frameworks are tested. If set to
+                "all", all available frameworks will be tested. It is also possible to provide a single framework or a
+                custom set of frameworks to check.
+
+        Returns:
+            `Dict[str, List[str]]`: A dictionary mapping task names to a sorted list of model IDs.
+
+        Example:
+        ```python
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+
+        # Discover zero-shot-classification models currently deployed
+        >>> models = client.list_deployed_models()
+        >>> models["zero-shot-classification"]
+        ['Narsil/deberta-large-mnli-zero-cls', 'facebook/bart-large-mnli', ...]
+
+        # List from only 1 framework
+        >>> client.list_deployed_models("text-generation-inference")
+        {'text-generation': ['bigcode/starcoder', 'meta-llama/Llama-2-70b-chat-hf', ...], ...}
+        ```
+        """
+        # Resolve which frameworks to check
+        if frameworks is None:
+            frameworks = MAIN_INFERENCE_API_FRAMEWORKS
+        elif frameworks == "all":
+            frameworks = ALL_INFERENCE_API_FRAMEWORKS
+        elif isinstance(frameworks, str):
+            frameworks = [frameworks]
+        frameworks = list(set(frameworks))
+
+        # Fetch them iteratively
+        models_by_task: Dict[str, List[str]] = {}
+
+        def _unpack_response(framework: str, items: List[Dict]) -> None:
+            for model in items:
+                if framework == "sentence-transformers":
+                    # Model running with the `sentence-transformers` framework can work with both tasks even if not
+                    # branded as such in the API response
+                    models_by_task.setdefault("feature-extraction", []).append(model["model_id"])
+                    models_by_task.setdefault("sentence-similarity", []).append(model["model_id"])
+                else:
+                    models_by_task.setdefault(model["task"], []).append(model["model_id"])
+
+        for framework in frameworks:
+            response = get_session().get(f"{INFERENCE_ENDPOINT}/framework/{framework}", headers=self.headers)
+            hf_raise_for_status(response)
+            _unpack_response(framework, response.json())
+
+        # Sort alphabetically for discoverability and return
+        for task, models in models_by_task.items():
+            models_by_task[task] = sorted(set(models), key=lambda x: x.lower())
+        return models_by_task
+
+    def object_detection(
+        self,
+        image: ContentT,
+        *,
+        model: Optional[str] = None,
+    ) -> List[ObjectDetectionOutputElement]:
+        """
+        Perform object detection on the given image using the specified model.
+
+        <Tip warning={true}>
+
+        You must have `PIL` installed if you want to work with images (`pip install Pillow`).
+
+        </Tip>
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The image to detect objects on. It can be raw bytes, an image file, or a URL to an online image.
+            model (`str`, *optional*):
+                The model to use for object detection. Can be a model ID hosted on the Hugging Face Hub or a URL to a
+                deployed Inference Endpoint. If not provided, the default recommended model for object detection (DETR) will be used.
+
+        Returns:
+            `List[ObjectDetectionOutputElement]`: A list of [`ObjectDetectionOutputElement`] items containing the bounding boxes and associated attributes.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+            `ValueError`:
+                If the request output is not a List.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.object_detection("people.jpg"):
+        [ObjectDetectionOutputElement(score=0.9486683011054993, label='person', box=ObjectDetectionBoundingBox(xmin=59, ymin=39, xmax=420, ymax=510)), ...]
+        ```
+        """
+        # detect objects
+        response = self.post(data=image, model=model, task="object-detection")
+        return ObjectDetectionOutputElement.parse_obj_as_list(response)
+
+    def question_answering(
+        self, question: str, context: str, *, model: Optional[str] = None
+    ) -> QuestionAnsweringOutputElement:
+        """
+        Retrieve the answer to a question from a given text.
+
+        Args:
+            question (`str`):
+                Question to be answered.
+            context (`str`):
+                The context of the question.
+            model (`str`):
+                The model to use for the question answering task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint.
+
+        Returns:
+            [`QuestionAnsweringOutputElement`]: an question answering output containing the score, start index, end index, and answer.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.question_answering(question="What's my name?", context="My name is Clara and I live in Berkeley.")
+        QuestionAnsweringOutputElement(score=0.9326562285423279, start=11, end=16, answer='Clara')
+        ```
+        """
+
+        payload: Dict[str, Any] = {"question": question, "context": context}
+        response = self.post(
+            json=payload,
+            model=model,
+            task="question-answering",
+        )
+        return QuestionAnsweringOutputElement.parse_obj_as_instance(response)
+
+    def sentence_similarity(
+        self, sentence: str, other_sentences: List[str], *, model: Optional[str] = None
+    ) -> List[float]:
+        """
+        Compute the semantic similarity between a sentence and a list of other sentences by comparing their embeddings.
+
+        Args:
+            sentence (`str`):
+                The main sentence to compare to others.
+            other_sentences (`List[str]`):
+                The list of sentences to compare to.
+            model (`str`, *optional*):
+                The model to use for the conversational task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended conversational model will be used.
+                Defaults to None.
+
+        Returns:
+            `List[float]`: The embedding representing the input text.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.sentence_similarity(
+        ...     "Machine learning is so easy.",
+        ...     other_sentences=[
+        ...         "Deep learning is so straightforward.",
+        ...         "This is so difficult, like rocket science.",
+        ...         "I can't believe how much I struggled with this.",
+        ...     ],
+        ... )
+        [0.7785726189613342, 0.45876261591911316, 0.2906220555305481]
+        ```
+        """
+        response = self.post(
+            json={"inputs": {"source_sentence": sentence, "sentences": other_sentences}},
+            model=model,
+            task="sentence-similarity",
+        )
+        return _bytes_to_list(response)
+
+    def summarization(
+        self,
+        text: str,
+        *,
+        parameters: Optional[Dict[str, Any]] = None,
+        model: Optional[str] = None,
+    ) -> SummarizationOutput:
+        """
+        Generate a summary of a given text using a specified model.
+
+        Args:
+            text (`str`):
+                The input text to summarize.
+            parameters (`Dict[str, Any]`, *optional*):
+                Additional parameters for summarization. Check out this [page](https://huggingface.co/docs/api-inference/detailed_parameters#summarization-task)
+                for more details.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            [`SummarizationOutput`]: The generated summary text.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.summarization("The Eiffel tower...")
+        SummarizationOutput(generated_text="The Eiffel tower is one of the most famous landmarks in the world....")
+        ```
+        """
+        payload: Dict[str, Any] = {"inputs": text}
+        if parameters is not None:
+            payload["parameters"] = parameters
+        response = self.post(json=payload, model=model, task="summarization")
+        return SummarizationOutput.parse_obj_as_list(response)[0]
+
+    def table_question_answering(
+        self, table: Dict[str, Any], query: str, *, model: Optional[str] = None
+    ) -> TableQuestionAnsweringOutputElement:
+        """
+        Retrieve the answer to a question from information given in a table.
+
+        Args:
+            table (`str`):
+                A table of data represented as a dict of lists where entries are headers and the lists are all the
+                values, all lists must have the same size.
+            query (`str`):
+                The query in plain text that you want to ask the table.
+            model (`str`):
+                The model to use for the table-question-answering task. Can be a model ID hosted on the Hugging Face
+                Hub or a URL to a deployed Inference Endpoint.
+
+        Returns:
+            [`TableQuestionAnsweringOutputElement`]: a table question answering output containing the answer, coordinates, cells and the aggregator used.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> query = "How many stars does the transformers repository have?"
+        >>> table = {"Repository": ["Transformers", "Datasets", "Tokenizers"], "Stars": ["36542", "4512", "3934"]}
+        >>> client.table_question_answering(table, query, model="google/tapas-base-finetuned-wtq")
+        TableQuestionAnsweringOutputElement(answer='36542', coordinates=[[0, 1]], cells=['36542'], aggregator='AVERAGE')
+        ```
+        """
+        response = self.post(
+            json={
+                "query": query,
+                "table": table,
+            },
+            model=model,
+            task="table-question-answering",
+        )
+        return TableQuestionAnsweringOutputElement.parse_obj_as_instance(response)
+
+    def tabular_classification(self, table: Dict[str, Any], *, model: Optional[str] = None) -> List[str]:
+        """
+        Classifying a target category (a group) based on a set of attributes.
+
+        Args:
+            table (`Dict[str, Any]`):
+                Set of attributes to classify.
+            model (`str`, *optional*):
+                The model to use for the tabular classification task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended tabular classification model will be used.
+                Defaults to None.
+
+        Returns:
+            `List`: a list of labels, one per row in the initial table.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> table = {
+        ...     "fixed_acidity": ["7.4", "7.8", "10.3"],
+        ...     "volatile_acidity": ["0.7", "0.88", "0.32"],
+        ...     "citric_acid": ["0", "0", "0.45"],
+        ...     "residual_sugar": ["1.9", "2.6", "6.4"],
+        ...     "chlorides": ["0.076", "0.098", "0.073"],
+        ...     "free_sulfur_dioxide": ["11", "25", "5"],
+        ...     "total_sulfur_dioxide": ["34", "67", "13"],
+        ...     "density": ["0.9978", "0.9968", "0.9976"],
+        ...     "pH": ["3.51", "3.2", "3.23"],
+        ...     "sulphates": ["0.56", "0.68", "0.82"],
+        ...     "alcohol": ["9.4", "9.8", "12.6"],
+        ... }
+        >>> client.tabular_classification(table=table, model="julien-c/wine-quality")
+        ["5", "5", "5"]
+        ```
+        """
+        response = self.post(json={"table": table}, model=model, task="tabular-classification")
+        return _bytes_to_list(response)
+
+    def tabular_regression(self, table: Dict[str, Any], *, model: Optional[str] = None) -> List[float]:
+        """
+        Predicting a numerical target value given a set of attributes/features in a table.
+
+        Args:
+            table (`Dict[str, Any]`):
+                Set of attributes stored in a table. The attributes used to predict the target can be both numerical and categorical.
+            model (`str`, *optional*):
+                The model to use for the tabular regression task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended tabular regression model will be used.
+                Defaults to None.
+
+        Returns:
+            `List`: a list of predicted numerical target values.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> table = {
+        ...     "Height": ["11.52", "12.48", "12.3778"],
+        ...     "Length1": ["23.2", "24", "23.9"],
+        ...     "Length2": ["25.4", "26.3", "26.5"],
+        ...     "Length3": ["30", "31.2", "31.1"],
+        ...     "Species": ["Bream", "Bream", "Bream"],
+        ...     "Width": ["4.02", "4.3056", "4.6961"],
+        ... }
+        >>> client.tabular_regression(table, model="scikit-learn/Fish-Weight")
+        [110, 120, 130]
+        ```
+        """
+        response = self.post(json={"table": table}, model=model, task="tabular-regression")
+        return _bytes_to_list(response)
+
+    def text_classification(self, text: str, *, model: Optional[str] = None) -> List[TextClassificationOutputElement]:
+        """
+        Perform text classification (e.g. sentiment-analysis) on the given text.
+
+        Args:
+            text (`str`):
+                A string to be classified.
+            model (`str`, *optional*):
+                The model to use for the text classification task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended text classification model will be used.
+                Defaults to None.
+
+        Returns:
+            `List[TextClassificationOutputElement]`: a list of [`TextClassificationOutputElement`] items containing the predicted label and associated probability.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.text_classification("I like you")
+        [
+            TextClassificationOutputElement(label='POSITIVE', score=0.9998695850372314),
+            TextClassificationOutputElement(label='NEGATIVE', score=0.0001304351753788069),
+        ]
+        ```
+        """
+        response = self.post(json={"inputs": text}, model=model, task="text-classification")
+        return TextClassificationOutputElement.parse_obj_as_list(response)[0]  # type: ignore [return-value]
+
+    @overload
+    def text_generation(  # type: ignore
+        self,
+        prompt: str,
+        *,
+        details: Literal[False] = ...,
+        stream: Literal[False] = ...,
+        model: Optional[str] = None,
+        do_sample: bool = False,
+        max_new_tokens: int = 20,
+        best_of: Optional[int] = None,
+        repetition_penalty: Optional[float] = None,
+        return_full_text: bool = False,
+        seed: Optional[int] = None,
+        stop_sequences: Optional[List[str]] = None,
+        temperature: Optional[float] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        truncate: Optional[int] = None,
+        typical_p: Optional[float] = None,
+        watermark: bool = False,
+    ) -> str: ...
+
+    @overload
+    def text_generation(  # type: ignore
+        self,
+        prompt: str,
+        *,
+        details: Literal[True] = ...,
+        stream: Literal[False] = ...,
+        model: Optional[str] = None,
+        do_sample: bool = False,
+        max_new_tokens: int = 20,
+        best_of: Optional[int] = None,
+        repetition_penalty: Optional[float] = None,
+        return_full_text: bool = False,
+        seed: Optional[int] = None,
+        stop_sequences: Optional[List[str]] = None,
+        temperature: Optional[float] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        truncate: Optional[int] = None,
+        typical_p: Optional[float] = None,
+        watermark: bool = False,
+    ) -> TextGenerationOutput: ...
+
+    @overload
+    def text_generation(  # type: ignore
+        self,
+        prompt: str,
+        *,
+        details: Literal[False] = ...,
+        stream: Literal[True] = ...,
+        model: Optional[str] = None,
+        do_sample: bool = False,
+        max_new_tokens: int = 20,
+        best_of: Optional[int] = None,
+        repetition_penalty: Optional[float] = None,
+        return_full_text: bool = False,
+        seed: Optional[int] = None,
+        stop_sequences: Optional[List[str]] = None,
+        temperature: Optional[float] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        truncate: Optional[int] = None,
+        typical_p: Optional[float] = None,
+        watermark: bool = False,
+    ) -> Iterable[str]: ...
+
+    @overload
+    def text_generation(  # type: ignore
+        self,
+        prompt: str,
+        *,
+        details: Literal[True] = ...,
+        stream: Literal[True] = ...,
+        model: Optional[str] = None,
+        do_sample: bool = False,
+        max_new_tokens: int = 20,
+        best_of: Optional[int] = None,
+        repetition_penalty: Optional[float] = None,
+        return_full_text: bool = False,
+        seed: Optional[int] = None,
+        stop_sequences: Optional[List[str]] = None,
+        temperature: Optional[float] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        truncate: Optional[int] = None,
+        typical_p: Optional[float] = None,
+        watermark: bool = False,
+    ) -> Iterable[TextGenerationStreamOutput]: ...
+
+    @overload
+    def text_generation(
+        self,
+        prompt: str,
+        *,
+        details: Literal[True] = ...,
+        stream: bool = ...,
+        model: Optional[str] = None,
+        do_sample: bool = False,
+        max_new_tokens: int = 20,
+        best_of: Optional[int] = None,
+        repetition_penalty: Optional[float] = None,
+        return_full_text: bool = False,
+        seed: Optional[int] = None,
+        stop_sequences: Optional[List[str]] = None,
+        temperature: Optional[float] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        truncate: Optional[int] = None,
+        typical_p: Optional[float] = None,
+        watermark: bool = False,
+    ) -> Union[TextGenerationOutput, Iterable[TextGenerationStreamOutput]]: ...
+
+    def text_generation(
+        self,
+        prompt: str,
+        *,
+        details: bool = False,
+        stream: bool = False,
+        model: Optional[str] = None,
+        do_sample: bool = False,
+        max_new_tokens: int = 20,
+        best_of: Optional[int] = None,
+        repetition_penalty: Optional[float] = None,
+        return_full_text: bool = False,
+        seed: Optional[int] = None,
+        stop_sequences: Optional[List[str]] = None,
+        temperature: Optional[float] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        truncate: Optional[int] = None,
+        typical_p: Optional[float] = None,
+        watermark: bool = False,
+        decoder_input_details: bool = False,
+    ) -> Union[str, TextGenerationOutput, Iterable[str], Iterable[TextGenerationStreamOutput]]:
+        """
+        Given a prompt, generate the following text.
+
+        API endpoint is supposed to run with the `text-generation-inference` backend (TGI). This backend is the
+        go-to solution to run large language models at scale. However, for some smaller models (e.g. "gpt2") the
+        default `transformers` + `api-inference` solution is still in use. Both approaches have very similar APIs, but
+        not exactly the same. This method is compatible with both approaches but some parameters are only available for
+        `text-generation-inference`. If some parameters are ignored, a warning message is triggered but the process
+        continues correctly.
+
+        To learn more about the TGI project, please refer to https://github.com/huggingface/text-generation-inference.
+
+        Args:
+            prompt (`str`):
+                Input text.
+            details (`bool`, *optional*):
+                By default, text_generation returns a string. Pass `details=True` if you want a detailed output (tokens,
+                probabilities, seed, finish reason, etc.). Only available for models running on with the
+                `text-generation-inference` backend.
+            stream (`bool`, *optional*):
+                By default, text_generation returns the full generated text. Pass `stream=True` if you want a stream of
+                tokens to be returned. Only available for models running on with the `text-generation-inference`
+                backend.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+            do_sample (`bool`):
+                Activate logits sampling
+            max_new_tokens (`int`):
+                Maximum number of generated tokens
+            best_of (`int`):
+                Generate best_of sequences and return the one if the highest token logprobs
+            repetition_penalty (`float`):
+                The parameter for repetition penalty. 1.0 means no penalty. See [this
+                paper](https://arxiv.org/pdf/1909.05858.pdf) for more details.
+            return_full_text (`bool`):
+                Whether to prepend the prompt to the generated text
+            seed (`int`):
+                Random sampling seed
+            stop_sequences (`List[str]`):
+                Stop generating tokens if a member of `stop_sequences` is generated
+            temperature (`float`):
+                The value used to module the logits distribution.
+            top_k (`int`):
+                The number of highest probability vocabulary tokens to keep for top-k-filtering.
+            top_p (`float`):
+                If set to < 1, only the smallest set of most probable tokens with probabilities that add up to `top_p` or
+                higher are kept for generation.
+            truncate (`int`):
+                Truncate inputs tokens to the given size
+            typical_p (`float`):
+                Typical Decoding mass
+                See [Typical Decoding for Natural Language Generation](https://arxiv.org/abs/2202.00666) for more information
+            watermark (`bool`):
+                Watermarking with [A Watermark for Large Language Models](https://arxiv.org/abs/2301.10226)
+            decoder_input_details (`bool`):
+                Return the decoder input token logprobs and ids. You must set `details=True` as well for it to be taken
+                into account. Defaults to `False`.
+
+        Returns:
+            `Union[str, TextGenerationOutput, Iterable[str], Iterable[TextGenerationStreamOutput]]`:
+            Generated text returned from the server:
+            - if `stream=False` and `details=False`, the generated text is returned as a `str` (default)
+            - if `stream=True` and `details=False`, the generated text is returned token by token as a `Iterable[str]`
+            - if `stream=False` and `details=True`, the generated text is returned with more details as a [`~huggingface_hub.TextGenerationOutput`]
+            - if `details=True` and `stream=True`, the generated text is returned token by token as a iterable of [`~huggingface_hub.TextGenerationStreamOutput`]
+
+        Raises:
+            `ValidationError`:
+                If input values are not valid. No HTTP call is made to the server.
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+
+        # Case 1: generate text
+        >>> client.text_generation("The huggingface_hub library is ", max_new_tokens=12)
+        '100% open source and built to be easy to use.'
+
+        # Case 2: iterate over the generated tokens. Useful for large generation.
+        >>> for token in client.text_generation("The huggingface_hub library is ", max_new_tokens=12, stream=True):
+        ...     print(token)
+        100
+        %
+        open
+        source
+        and
+        built
+        to
+        be
+        easy
+        to
+        use
+        .
+
+        # Case 3: get more details about the generation process.
+        >>> client.text_generation("The huggingface_hub library is ", max_new_tokens=12, details=True)
+        TextGenerationOutput(
+            generated_text='100% open source and built to be easy to use.',
+            details=TextGenerationDetails(
+                finish_reason='length',
+                generated_tokens=12,
+                seed=None,
+                prefill=[
+                    TextGenerationPrefillToken(id=487, text='The', logprob=None),
+                    TextGenerationPrefillToken(id=53789, text=' hugging', logprob=-13.171875),
+                    (...)
+                    TextGenerationPrefillToken(id=204, text=' ', logprob=-7.0390625)
+                ],
+                tokens=[
+                    TokenElement(id=1425, text='100', logprob=-1.0175781, special=False),
+                    TokenElement(id=16, text='%', logprob=-0.0463562, special=False),
+                    (...)
+                    TokenElement(id=25, text='.', logprob=-0.5703125, special=False)
+                ],
+                best_of_sequences=None
+            )
+        )
+
+        # Case 4: iterate over the generated tokens with more details.
+        # Last object is more complete, containing the full generated text and the finish reason.
+        >>> for details in client.text_generation("The huggingface_hub library is ", max_new_tokens=12, details=True, stream=True):
+        ...     print(details)
+        ...
+        TextGenerationStreamOutput(token=TokenElement(id=1425, text='100', logprob=-1.0175781, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=16, text='%', logprob=-0.0463562, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=1314, text=' open', logprob=-1.3359375, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=3178, text=' source', logprob=-0.28100586, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=273, text=' and', logprob=-0.5961914, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=3426, text=' built', logprob=-1.9423828, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=271, text=' to', logprob=-1.4121094, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=314, text=' be', logprob=-1.5224609, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=1833, text=' easy', logprob=-2.1132812, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=271, text=' to', logprob=-0.08520508, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=745, text=' use', logprob=-0.39453125, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(
+            id=25,
+            text='.',
+            logprob=-0.5703125,
+            special=False),
+            generated_text='100% open source and built to be easy to use.',
+            details=TextGenerationStreamDetails(finish_reason='length', generated_tokens=12, seed=None)
+        )
+        ```
+        """
+        if decoder_input_details and not details:
+            warnings.warn(
+                "`decoder_input_details=True` has been passed to the server but `details=False` is set meaning that"
+                " the output from the server will be truncated."
+            )
+            decoder_input_details = False
+
+        # Build payload
+        payload = {
+            "inputs": prompt,
+            "parameters": {
+                "best_of": best_of,
+                "decoder_input_details": decoder_input_details,
+                "details": details,
+                "do_sample": do_sample,
+                "max_new_tokens": max_new_tokens,
+                "repetition_penalty": repetition_penalty,
+                "return_full_text": return_full_text,
+                "seed": seed,
+                "stop": stop_sequences if stop_sequences is not None else [],
+                "temperature": temperature,
+                "top_k": top_k,
+                "top_p": top_p,
+                "truncate": truncate,
+                "typical_p": typical_p,
+                "watermark": watermark,
+            },
+            "stream": stream,
+        }
+
+        # Remove some parameters if not a TGI server
+        if not _is_tgi_server(model):
+            parameters: Dict = payload["parameters"]  # type: ignore [assignment]
+
+            ignored_parameters = []
+            for key in "watermark", "details", "decoder_input_details", "best_of", "stop", "return_full_text":
+                if parameters[key] is not None:
+                    ignored_parameters.append(key)
+                del parameters[key]
+            if len(ignored_parameters) > 0:
+                warnings.warn(
+                    "API endpoint/model for text-generation is not served via TGI. Ignoring parameters"
+                    f" {ignored_parameters}.",
+                    UserWarning,
+                )
+            if details:
+                warnings.warn(
+                    "API endpoint/model for text-generation is not served via TGI. Parameter `details=True` will"
+                    " be ignored meaning only the generated text will be returned.",
+                    UserWarning,
+                )
+                details = False
+            if stream:
+                raise ValueError(
+                    "API endpoint/model for text-generation is not served via TGI. Cannot return output as a stream."
+                    " Please pass `stream=False` as input."
+                )
+
+        # Handle errors separately for more precise error messages
+        try:
+            bytes_output = self.post(json=payload, model=model, task="text-generation", stream=stream)  # type: ignore
+        except HTTPError as e:
+            if isinstance(e, BadRequestError) and "The following `model_kwargs` are not used by the model" in str(e):
+                _set_as_non_tgi(model)
+                return self.text_generation(  # type: ignore
+                    prompt=prompt,
+                    details=details,
+                    stream=stream,
+                    model=model,
+                    do_sample=do_sample,
+                    max_new_tokens=max_new_tokens,
+                    best_of=best_of,
+                    repetition_penalty=repetition_penalty,
+                    return_full_text=return_full_text,
+                    seed=seed,
+                    stop_sequences=stop_sequences,
+                    temperature=temperature,
+                    top_k=top_k,
+                    top_p=top_p,
+                    truncate=truncate,
+                    typical_p=typical_p,
+                    watermark=watermark,
+                    decoder_input_details=decoder_input_details,
+                )
+            raise_text_generation_error(e)
+
+        # Parse output
+        if stream:
+            return _stream_text_generation_response(bytes_output, details)  # type: ignore
+
+        data = _bytes_to_dict(bytes_output)[0]  # type: ignore[arg-type]
+        return TextGenerationOutput.parse_obj_as_instance(data) if details else data["generated_text"]
+
+    def text_to_image(
+        self,
+        prompt: str,
+        *,
+        negative_prompt: Optional[str] = None,
+        height: Optional[float] = None,
+        width: Optional[float] = None,
+        num_inference_steps: Optional[float] = None,
+        guidance_scale: Optional[float] = None,
+        model: Optional[str] = None,
+        **kwargs,
+    ) -> "Image":
+        """
+        Generate an image based on a given text using a specified model.
+
+        <Tip warning={true}>
+
+        You must have `PIL` installed if you want to work with images (`pip install Pillow`).
+
+        </Tip>
+
+        Args:
+            prompt (`str`):
+                The prompt to generate an image from.
+            negative_prompt (`str`, *optional*):
+                An optional negative prompt for the image generation.
+            height (`float`, *optional*):
+                The height in pixels of the image to generate.
+            width (`float`, *optional*):
+                The width in pixels of the image to generate.
+            num_inference_steps (`int`, *optional*):
+                The number of denoising steps. More denoising steps usually lead to a higher quality image at the
+                expense of slower inference.
+            guidance_scale (`float`, *optional*):
+                Higher guidance scale encourages to generate images that are closely linked to the text `prompt`,
+                usually at the expense of lower image quality.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            `Image`: The generated image.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+
+        >>> image = client.text_to_image("An astronaut riding a horse on the moon.")
+        >>> image.save("astronaut.png")
+
+        >>> image = client.text_to_image(
+        ...     "An astronaut riding a horse on the moon.",
+        ...     negative_prompt="low resolution, blurry",
+        ...     model="stabilityai/stable-diffusion-2-1",
+        ... )
+        >>> image.save("better_astronaut.png")
+        ```
+        """
+        payload = {"inputs": prompt}
+        parameters = {
+            "negative_prompt": negative_prompt,
+            "height": height,
+            "width": width,
+            "num_inference_steps": num_inference_steps,
+            "guidance_scale": guidance_scale,
+            **kwargs,
+        }
+        for key, value in parameters.items():
+            if value is not None:
+                payload.setdefault("parameters", {})[key] = value  # type: ignore
+        response = self.post(json=payload, model=model, task="text-to-image")
+        return _bytes_to_image(response)
+
+    def text_to_speech(self, text: str, *, model: Optional[str] = None) -> bytes:
+        """
+        Synthesize an audio of a voice pronouncing a given text.
+
+        Args:
+            text (`str`):
+                The text to synthesize.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            `bytes`: The generated audio.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from pathlib import Path
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+
+        >>> audio = client.text_to_speech("Hello world")
+        >>> Path("hello_world.flac").write_bytes(audio)
+        ```
+        """
+        return self.post(json={"inputs": text}, model=model, task="text-to-speech")
+
+    def token_classification(
+        self, text: str, *, model: Optional[str] = None
+    ) -> List[TokenClassificationOutputElement]:
+        """
+        Perform token classification on the given text.
+        Usually used for sentence parsing, either grammatical, or Named Entity Recognition (NER) to understand keywords contained within text.
+
+        Args:
+            text (`str`):
+                A string to be classified.
+            model (`str`, *optional*):
+                The model to use for the token classification task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended token classification model will be used.
+                Defaults to None.
+
+        Returns:
+            `List[TokenClassificationOutputElement]`: List of [`TokenClassificationOutputElement`] items containing the entity group, confidence score, word, start and end index.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.token_classification("My name is Sarah Jessica Parker but you can call me Jessica")
+        [
+            TokenClassificationOutputElement(
+                entity_group='PER',
+                score=0.9971321225166321,
+                word='Sarah Jessica Parker',
+                start=11,
+                end=31,
+            ),
+            TokenClassificationOutputElement(
+                entity_group='PER',
+                score=0.9773476123809814,
+                word='Jessica',
+                start=52,
+                end=59,
+            )
+        ]
+        ```
+        """
+        payload: Dict[str, Any] = {"inputs": text}
+        response = self.post(
+            json=payload,
+            model=model,
+            task="token-classification",
+        )
+        return TokenClassificationOutputElement.parse_obj_as_list(response)
+
+    def translation(
+        self, text: str, *, model: Optional[str] = None, src_lang: Optional[str] = None, tgt_lang: Optional[str] = None
+    ) -> TranslationOutput:
+        """
+        Convert text from one language to another.
+
+        Check out https://huggingface.co/tasks/translation for more information on how to choose the best model for
+        your specific use case. Source and target languages usually depend on the model.
+        However, it is possible to specify source and target languages for certain models. If you are working with one of these models,
+        you can use `src_lang` and `tgt_lang` arguments to pass the relevant information.
+        You can find this information in the model card.
+
+        Args:
+            text (`str`):
+                A string to be translated.
+            model (`str`, *optional*):
+                The model to use for the translation task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended translation model will be used.
+                Defaults to None.
+            src_lang (`str`, *optional*):
+                Source language of the translation task, i.e. input language. Cannot be passed without `tgt_lang`.
+            tgt_lang (`str`, *optional*):
+                Target language of the translation task, i.e. output language. Cannot be passed without `src_lang`.
+
+        Returns:
+            [`TranslationOutput`]: The generated translated text.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+            `ValueError`:
+                If only one of the `src_lang` and `tgt_lang` arguments are provided.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.translation("My name is Wolfgang and I live in Berlin")
+        'Mein Name ist Wolfgang und ich lebe in Berlin.'
+        >>> client.translation("My name is Wolfgang and I live in Berlin", model="Helsinki-NLP/opus-mt-en-fr")
+        TranslationOutput(translation_text='Je m\'appelle Wolfgang et je vis à Berlin.')
+        ```
+
+        Specifying languages:
+        ```py
+        >>> client.translation("My name is Sarah Jessica Parker but you can call me Jessica", model="facebook/mbart-large-50-many-to-many-mmt", src_lang="en_XX", tgt_lang="fr_XX")
+        "Mon nom est Sarah Jessica Parker mais vous pouvez m\'appeler Jessica"
+        ```
+        """
+        # Throw error if only one of `src_lang` and `tgt_lang` was given
+        if src_lang is not None and tgt_lang is None:
+            raise ValueError("You cannot specify `src_lang` without specifying `tgt_lang`.")
+
+        if src_lang is None and tgt_lang is not None:
+            raise ValueError("You cannot specify `tgt_lang` without specifying `src_lang`.")
+
+        # If both `src_lang` and `tgt_lang` are given, pass them to the request body
+        payload: Dict = {"inputs": text}
+        if src_lang and tgt_lang:
+            payload["parameters"] = {"src_lang": src_lang, "tgt_lang": tgt_lang}
+        response = self.post(json=payload, model=model, task="translation")
+        return TranslationOutput.parse_obj_as_list(response)[0]
+
+    def visual_question_answering(
+        self,
+        image: ContentT,
+        question: str,
+        *,
+        model: Optional[str] = None,
+    ) -> List[VisualQuestionAnsweringOutputElement]:
+        """
+        Answering open-ended questions based on an image.
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The input image for the context. It can be raw bytes, an image file, or a URL to an online image.
+            question (`str`):
+                Question to be answered.
+            model (`str`, *optional*):
+                The model to use for the visual question answering task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended visual question answering model will be used.
+                Defaults to None.
+
+        Returns:
+            `List[VisualQuestionAnsweringOutputElement]`: a list of [`VisualQuestionAnsweringOutputElement`] items containing the predicted label and associated probability.
+
+        Raises:
+            `InferenceTimeoutError`:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.visual_question_answering(
+        ...     image="https://huggingface.co/datasets/mishig/sample_images/resolve/main/tiger.jpg",
+        ...     question="What is the animal doing?"
+        ... )
+        [
+            VisualQuestionAnsweringOutputElement(score=0.778609573841095, answer='laying down'),
+            VisualQuestionAnsweringOutputElement(score=0.6957435607910156, answer='sitting'),
+        ]
+        ```
+        """
+        payload: Dict[str, Any] = {"question": question, "image": _b64_encode(image)}
+        response = self.post(json=payload, model=model, task="visual-question-answering")
+        return VisualQuestionAnsweringOutputElement.parse_obj_as_list(response)
+
+    def zero_shot_classification(
+        self, text: str, labels: List[str], *, multi_label: bool = False, model: Optional[str] = None
+    ) -> List[ZeroShotClassificationOutputElement]:
+        """
+        Provide as input a text and a set of candidate labels to classify the input text.
+
+        Args:
+            text (`str`):
+                The input text to classify.
+            labels (`List[str]`):
+                List of string possible labels. There must be at least 2 labels.
+            multi_label (`bool`):
+                Boolean that is set to True if classes can overlap.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            `List[ZeroShotClassificationOutputElement]`: List of [`ZeroShotClassificationOutputElement`] items containing the predicted labels and their confidence.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> text = (
+        ...     "A new model offers an explanation for how the Galilean satellites formed around the solar system's"
+        ...     "largest world. Konstantin Batygin did not set out to solve one of the solar system's most puzzling"
+        ...     " mysteries when he went for a run up a hill in Nice, France."
+        ... )
+        >>> labels = ["space & cosmos", "scientific discovery", "microbiology", "robots", "archeology"]
+        >>> client.zero_shot_classification(text, labels)
+        [
+            ZeroShotClassificationOutputElement(label='scientific discovery', score=0.7961668968200684),
+            ZeroShotClassificationOutputElement(label='space & cosmos', score=0.18570658564567566),
+            ZeroShotClassificationOutputElement(label='microbiology', score=0.00730885099619627),
+            ZeroShotClassificationOutputElement(label='archeology', score=0.006258360575884581),
+            ZeroShotClassificationOutputElement(label='robots', score=0.004559356719255447),
+        ]
+        >>> client.zero_shot_classification(text, labels, multi_label=True)
+        [
+            ZeroShotClassificationOutputElement(label='scientific discovery', score=0.9829297661781311),
+            ZeroShotClassificationOutputElement(label='space & cosmos', score=0.755190908908844),
+            ZeroShotClassificationOutputElement(label='microbiology', score=0.0005462635890580714),
+            ZeroShotClassificationOutputElement(label='archeology', score=0.00047131875180639327),
+            ZeroShotClassificationOutputElement(label='robots', score=0.00030448526376858354),
+        ]
+        ```
+        """
+        # Raise ValueError if input is less than 2 labels
+        if len(labels) < 2:
+            raise ValueError("You must specify at least 2 classes to compare.")
+
+        response = self.post(
+            json={
+                "inputs": text,
+                "parameters": {
+                    "candidate_labels": ",".join(labels),
+                    "multi_label": multi_label,
+                },
+            },
+            model=model,
+            task="zero-shot-classification",
+        )
+        output = _bytes_to_dict(response)
+        return [
+            ZeroShotClassificationOutputElement.parse_obj_as_instance({"label": label, "score": score})
+            for label, score in zip(output["labels"], output["scores"])
+        ]
+
+    def zero_shot_image_classification(
+        self, image: ContentT, labels: List[str], *, model: Optional[str] = None
+    ) -> List[ZeroShotImageClassificationOutputElement]:
+        """
+        Provide input image and text labels to predict text labels for the image.
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The input image to caption. It can be raw bytes, an image file, or a URL to an online image.
+            labels (`List[str]`):
+                List of string possible labels. There must be at least 2 labels.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            `List[ZeroShotImageClassificationOutputElement]`: List of [`ZeroShotImageClassificationOutputElement`] items containing the predicted labels and their confidence.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `HTTPError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+
+        >>> client.zero_shot_image_classification(
+        ...     "https://upload.wikimedia.org/wikipedia/commons/thumb/4/43/Cute_dog.jpg/320px-Cute_dog.jpg",
+        ...     labels=["dog", "cat", "horse"],
+        ... )
+        [ZeroShotImageClassificationOutputElement(label='dog', score=0.956),...]
+        ```
+        """
+        # Raise ValueError if input is less than 2 labels
+        if len(labels) < 2:
+            raise ValueError("You must specify at least 2 classes to compare.")
+
+        response = self.post(
+            json={"image": _b64_encode(image), "parameters": {"candidate_labels": ",".join(labels)}},
+            model=model,
+            task="zero-shot-image-classification",
+        )
+        return ZeroShotImageClassificationOutputElement.parse_obj_as_list(response)
+
+    def _resolve_url(self, model: Optional[str] = None, task: Optional[str] = None) -> str:
+        model = model or self.model
+
+        # If model is already a URL, ignore `task` and return directly
+        if model is not None and (model.startswith("http://") or model.startswith("https://")):
+            return model
+
+        # # If no model but task is set => fetch the recommended one for this task
+        if model is None:
+            if task is None:
+                raise ValueError(
+                    "You must specify at least a model (repo_id or URL) or a task, either when instantiating"
+                    " `InferenceClient` or when making a request."
+                )
+            model = self.get_recommended_model(task)
+            logger.info(
+                f"Using recommended model {model} for task {task}. Note that it is"
+                f" encouraged to explicitly set `model='{model}'` as the recommended"
+                " models list might get updated without prior notice."
+            )
+
+        # Compute InferenceAPI url
+        return (
+            # Feature-extraction and sentence-similarity are the only cases where we handle models with several tasks.
+            f"{INFERENCE_ENDPOINT}/pipeline/{task}/{model}"
+            if task in ("feature-extraction", "sentence-similarity")
+            # Otherwise, we use the default endpoint
+            else f"{INFERENCE_ENDPOINT}/models/{model}"
+        )
+
+    @staticmethod
+    def get_recommended_model(task: str) -> str:
+        """
+        Get the model Hugging Face recommends for the input task.
+
+        Args:
+            task (`str`):
+                The Hugging Face task to get which model Hugging Face recommends.
+                All available tasks can be found [here](https://huggingface.co/tasks).
+
+        Returns:
+            `str`: Name of the model recommended for the input task.
+
+        Raises:
+            `ValueError`: If Hugging Face has no recommendation for the input task.
+        """
+        model = _fetch_recommended_models().get(task)
+        if model is None:
+            raise ValueError(
+                f"Task {task} has no recommended model. Please specify a model"
+                " explicitly. Visit https://huggingface.co/tasks for more info."
+            )
+        return model
+
+    def get_model_status(self, model: Optional[str] = None) -> ModelStatus:
+        """
+        Get the status of a model hosted on the Inference API.
+
+        <Tip>
+
+        This endpoint is mostly useful when you already know which model you want to use and want to check its
+        availability. If you want to discover already deployed models, you should rather use [`~InferenceClient.list_deployed_models`].
+
+        </Tip>
+
+        Args:
+            model (`str`, *optional*):
+                Identifier of the model for witch the status gonna be checked. If model is not provided,
+                the model associated with this instance of [`InferenceClient`] will be used. Only InferenceAPI service can be checked so the
+                identifier cannot be a URL.
+
+
+        Returns:
+            [`ModelStatus`]: An instance of ModelStatus dataclass, containing information,
+                         about the state of the model: load, state, compute type and framework.
+
+        Example:
+        ```py
+        >>> from huggingface_hub import InferenceClient
+        >>> client = InferenceClient()
+        >>> client.get_model_status("bigcode/starcoder")
+        ModelStatus(loaded=True, state='Loaded', compute_type='gpu', framework='text-generation-inference')
+        ```
+        """
+        model = model or self.model
+        if model is None:
+            raise ValueError("Model id not provided.")
+        if model.startswith("https://"):
+            raise NotImplementedError("Model status is only available for Inference API endpoints.")
+        url = f"{INFERENCE_ENDPOINT}/status/{model}"
+
+        response = get_session().get(url, headers=self.headers)
+        hf_raise_for_status(response)
+        response_data = response.json()
+
+        if "error" in response_data:
+            raise ValueError(response_data["error"])
+
+        return ModelStatus(
+            loaded=response_data["loaded"],
+            state=response_data["state"],
+            compute_type=response_data["compute_type"],
+            framework=response_data["framework"],
+        )
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_common.py b/llm/Lib/site-packages/huggingface_hub/inference/_common.py
new file mode 100644
index 0000000000000000000000000000000000000000..01ea32572dfe8561abb4ee211bb71a7acc2cd173
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_common.py
@@ -0,0 +1,482 @@
+# coding=utf-8
+# Copyright 2023-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains utilities used by both the sync and async inference clients."""
+
+import base64
+import io
+import json
+import logging
+import time
+from contextlib import contextmanager
+from dataclasses import dataclass
+from pathlib import Path
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterable,
+    BinaryIO,
+    ContextManager,
+    Dict,
+    Generator,
+    Iterable,
+    List,
+    Literal,
+    NoReturn,
+    Optional,
+    Set,
+    Union,
+    overload,
+)
+
+from requests import HTTPError
+
+from huggingface_hub.errors import (
+    GenerationError,
+    IncompleteGenerationError,
+    OverloadedError,
+    TextGenerationError,
+    UnknownError,
+    ValidationError,
+)
+
+from ..constants import ENDPOINT
+from ..utils import (
+    build_hf_headers,
+    get_session,
+    hf_raise_for_status,
+    is_aiohttp_available,
+    is_numpy_available,
+    is_pillow_available,
+)
+from ._generated.types import (
+    ChatCompletionStreamOutput,
+    ChatCompletionStreamOutputChoice,
+    ChatCompletionStreamOutputDelta,
+    TextGenerationStreamOutput,
+)
+
+
+if TYPE_CHECKING:
+    from aiohttp import ClientResponse, ClientSession
+    from PIL import Image
+
+# TYPES
+UrlT = str
+PathT = Union[str, Path]
+BinaryT = Union[bytes, BinaryIO]
+ContentT = Union[BinaryT, PathT, UrlT]
+
+# Use to set a Accept: image/png header
+TASKS_EXPECTING_IMAGES = {"text-to-image", "image-to-image"}
+
+logger = logging.getLogger(__name__)
+
+
+# Add dataclass for ModelStatus. We use this dataclass in get_model_status function.
+@dataclass
+class ModelStatus:
+    """
+    This Dataclass represents the the model status in the Hugging Face Inference API.
+
+    Args:
+        loaded (`bool`):
+            If the model is currently loaded into Hugging Face's InferenceAPI. Models
+            are loaded on-demand, leading to the user's first request taking longer.
+            If a model is loaded, you can be assured that it is in a healthy state.
+        state (`str`):
+            The current state of the model. This can be 'Loaded', 'Loadable', 'TooBig'.
+            If a model's state is 'Loadable', it's not too big and has a supported
+            backend. Loadable models are automatically loaded when the user first
+            requests inference on the endpoint. This means it is transparent for the
+            user to load a model, except that the first call takes longer to complete.
+        compute_type (`Dict`):
+            Information about the compute resource the model is using or will use, such as 'gpu' type and number of
+            replicas.
+        framework (`str`):
+            The name of the framework that the model was built with, such as 'transformers'
+            or 'text-generation-inference'.
+    """
+
+    loaded: bool
+    state: str
+    compute_type: Dict
+    framework: str
+
+
+## IMPORT UTILS
+
+
+def _import_aiohttp():
+    # Make sure `aiohttp` is installed on the machine.
+    if not is_aiohttp_available():
+        raise ImportError("Please install aiohttp to use `AsyncInferenceClient` (`pip install aiohttp`).")
+    import aiohttp
+
+    return aiohttp
+
+
+def _import_numpy():
+    """Make sure `numpy` is installed on the machine."""
+    if not is_numpy_available():
+        raise ImportError("Please install numpy to use deal with embeddings (`pip install numpy`).")
+    import numpy
+
+    return numpy
+
+
+def _import_pil_image():
+    """Make sure `PIL` is installed on the machine."""
+    if not is_pillow_available():
+        raise ImportError(
+            "Please install Pillow to use deal with images (`pip install Pillow`). If you don't want the image to be"
+            " post-processed, use `client.post(...)` and get the raw response from the server."
+        )
+    from PIL import Image
+
+    return Image
+
+
+## RECOMMENDED MODELS
+
+# Will be globally fetched only once (see '_fetch_recommended_models')
+_RECOMMENDED_MODELS: Optional[Dict[str, Optional[str]]] = None
+
+
+def _fetch_recommended_models() -> Dict[str, Optional[str]]:
+    global _RECOMMENDED_MODELS
+    if _RECOMMENDED_MODELS is None:
+        response = get_session().get(f"{ENDPOINT}/api/tasks", headers=build_hf_headers())
+        hf_raise_for_status(response)
+        _RECOMMENDED_MODELS = {
+            task: _first_or_none(details["widgetModels"]) for task, details in response.json().items()
+        }
+    return _RECOMMENDED_MODELS
+
+
+def _first_or_none(items: List[Any]) -> Optional[Any]:
+    try:
+        return items[0] or None
+    except IndexError:
+        return None
+
+
+## ENCODING / DECODING UTILS
+
+
+@overload
+def _open_as_binary(
+    content: ContentT,
+) -> ContextManager[BinaryT]: ...  # means "if input is not None, output is not None"
+
+
+@overload
+def _open_as_binary(
+    content: Literal[None],
+) -> ContextManager[Literal[None]]: ...  # means "if input is None, output is None"
+
+
+@contextmanager  # type: ignore
+def _open_as_binary(content: Optional[ContentT]) -> Generator[Optional[BinaryT], None, None]:
+    """Open `content` as a binary file, either from a URL, a local path, or raw bytes.
+
+    Do nothing if `content` is None,
+
+    TODO: handle a PIL.Image as input
+    TODO: handle base64 as input
+    """
+    # If content is a string => must be either a URL or a path
+    if isinstance(content, str):
+        if content.startswith("https://") or content.startswith("http://"):
+            logger.debug(f"Downloading content from {content}")
+            yield get_session().get(content).content  # TODO: retrieve as stream and pipe to post request ?
+            return
+        content = Path(content)
+        if not content.exists():
+            raise FileNotFoundError(
+                f"File not found at {content}. If `data` is a string, it must either be a URL or a path to a local"
+                " file. To pass raw content, please encode it as bytes first."
+            )
+
+    # If content is a Path => open it
+    if isinstance(content, Path):
+        logger.debug(f"Opening content from {content}")
+        with content.open("rb") as f:
+            yield f
+    else:
+        # Otherwise: already a file-like object or None
+        yield content
+
+
+def _b64_encode(content: ContentT) -> str:
+    """Encode a raw file (image, audio) into base64. Can be byes, an opened file, a path or a URL."""
+    with _open_as_binary(content) as data:
+        data_as_bytes = data if isinstance(data, bytes) else data.read()
+        return base64.b64encode(data_as_bytes).decode()
+
+
+def _b64_to_image(encoded_image: str) -> "Image":
+    """Parse a base64-encoded string into a PIL Image."""
+    Image = _import_pil_image()
+    return Image.open(io.BytesIO(base64.b64decode(encoded_image)))
+
+
+def _bytes_to_list(content: bytes) -> List:
+    """Parse bytes from a Response object into a Python list.
+
+    Expects the response body to be JSON-encoded data.
+
+    NOTE: This is exactly the same implementation as `_bytes_to_dict` and will not complain if the returned data is a
+    dictionary. The only advantage of having both is to help the user (and mypy) understand what kind of data to expect.
+    """
+    return json.loads(content.decode())
+
+
+def _bytes_to_dict(content: bytes) -> Dict:
+    """Parse bytes from a Response object into a Python dictionary.
+
+    Expects the response body to be JSON-encoded data.
+
+    NOTE: This is exactly the same implementation as `_bytes_to_list` and will not complain if the returned data is a
+    list. The only advantage of having both is to help the user (and mypy) understand what kind of data to expect.
+    """
+    return json.loads(content.decode())
+
+
+def _bytes_to_image(content: bytes) -> "Image":
+    """Parse bytes from a Response object into a PIL Image.
+
+    Expects the response body to be raw bytes. To deal with b64 encoded images, use `_b64_to_image` instead.
+    """
+    Image = _import_pil_image()
+    return Image.open(io.BytesIO(content))
+
+
+## STREAMING UTILS
+
+
+def _stream_text_generation_response(
+    bytes_output_as_lines: Iterable[bytes], details: bool
+) -> Union[Iterable[str], Iterable[TextGenerationStreamOutput]]:
+    """Used in `InferenceClient.text_generation`."""
+    # Parse ServerSentEvents
+    for byte_payload in bytes_output_as_lines:
+        output = _format_text_generation_stream_output(byte_payload, details)
+        if output is not None:
+            yield output
+
+
+async def _async_stream_text_generation_response(
+    bytes_output_as_lines: AsyncIterable[bytes], details: bool
+) -> Union[AsyncIterable[str], AsyncIterable[TextGenerationStreamOutput]]:
+    """Used in `AsyncInferenceClient.text_generation`."""
+    # Parse ServerSentEvents
+    async for byte_payload in bytes_output_as_lines:
+        output = _format_text_generation_stream_output(byte_payload, details)
+        if output is not None:
+            yield output
+
+
+def _format_text_generation_stream_output(
+    byte_payload: bytes, details: bool
+) -> Optional[Union[str, TextGenerationStreamOutput]]:
+    if not byte_payload.startswith(b"data:"):
+        return None  # empty line
+
+    # Decode payload
+    payload = byte_payload.decode("utf-8")
+    json_payload = json.loads(payload.lstrip("data:").rstrip("/n"))
+
+    # Either an error as being returned
+    if json_payload.get("error") is not None:
+        raise _parse_text_generation_error(json_payload["error"], json_payload.get("error_type"))
+
+    # Or parse token payload
+    output = TextGenerationStreamOutput.parse_obj_as_instance(json_payload)
+    return output.token.text if not details else output
+
+
+def _stream_chat_completion_response_from_text_generation(
+    text_generation_output: Iterable[TextGenerationStreamOutput],
+) -> Iterable[ChatCompletionStreamOutput]:
+    """Used in `InferenceClient.chat_completion`."""
+    created = int(time.time())
+    for item in text_generation_output:
+        yield _format_chat_completion_stream_output_from_text_generation(item, created)
+
+
+async def _async_stream_chat_completion_response_from_text_generation(
+    text_generation_output: AsyncIterable[TextGenerationStreamOutput],
+) -> AsyncIterable[ChatCompletionStreamOutput]:
+    """Used in `AsyncInferenceClient.chat_completion`."""
+    created = int(time.time())
+    async for item in text_generation_output:
+        yield _format_chat_completion_stream_output_from_text_generation(item, created)
+
+
+def _format_chat_completion_stream_output_from_text_generation(
+    item: TextGenerationStreamOutput, created: int
+) -> ChatCompletionStreamOutput:
+    if item.details is None:
+        # new token generated => return delta
+        return ChatCompletionStreamOutput(
+            choices=[
+                ChatCompletionStreamOutputChoice(
+                    delta=ChatCompletionStreamOutputDelta(
+                        role="assistant",
+                        content=item.token.text,
+                    ),
+                    finish_reason=None,
+                    index=0,
+                )
+            ],
+            created=created,
+        )
+    else:
+        # generation is completed => return finish reason
+        return ChatCompletionStreamOutput(
+            choices=[
+                ChatCompletionStreamOutputChoice(
+                    delta=ChatCompletionStreamOutputDelta(),
+                    finish_reason=item.details.finish_reason,
+                    index=0,
+                )
+            ],
+            created=created,
+        )
+
+
+def _stream_chat_completion_response_from_bytes(
+    bytes_lines: Iterable[bytes],
+) -> Iterable[ChatCompletionStreamOutput]:
+    """Used in `InferenceClient.chat_completion` if model is served with TGI."""
+    for item in bytes_lines:
+        output = _format_chat_completion_stream_output_from_text_generation_from_bytes(item)
+        if output is not None:
+            yield output
+
+
+async def _async_stream_chat_completion_response_from_bytes(
+    bytes_lines: AsyncIterable[bytes],
+) -> AsyncIterable[ChatCompletionStreamOutput]:
+    """Used in `AsyncInferenceClient.chat_completion`."""
+    async for item in bytes_lines:
+        output = _format_chat_completion_stream_output_from_text_generation_from_bytes(item)
+        if output is not None:
+            yield output
+
+
+def _format_chat_completion_stream_output_from_text_generation_from_bytes(
+    byte_payload: bytes,
+) -> Optional[ChatCompletionStreamOutput]:
+    if not byte_payload.startswith(b"data:"):
+        return None  # empty line
+
+    # Decode payload
+    payload = byte_payload.decode("utf-8")
+    json_payload = json.loads(payload.lstrip("data:").rstrip("/n"))
+    return ChatCompletionStreamOutput.parse_obj_as_instance(json_payload)
+
+
+async def _async_yield_from(client: "ClientSession", response: "ClientResponse") -> AsyncIterable[bytes]:
+    async for byte_payload in response.content:
+        yield byte_payload
+    await client.close()
+
+
+# "TGI servers" are servers running with the `text-generation-inference` backend.
+# This backend is the go-to solution to run large language models at scale. However,
+# for some smaller models (e.g. "gpt2") the default `transformers` + `api-inference`
+# solution is still in use.
+#
+# Both approaches have very similar APIs, but not exactly the same. What we do first in
+# the `text_generation` method is to assume the model is served via TGI. If we realize
+# it's not the case (i.e. we receive an HTTP 400 Bad Request), we fallback to the
+# default API with a warning message. We remember for each model if it's a TGI server
+# or not using `_NON_TGI_SERVERS` global variable.
+#
+# In addition, TGI servers have a built-in API route for chat-completion, which is not
+# available on the default API. We use this route to provide a more consistent behavior
+# when available.
+#
+# For more details, see https://github.com/huggingface/text-generation-inference and
+# https://huggingface.co/docs/api-inference/detailed_parameters#text-generation-task.
+
+_NON_TGI_SERVERS: Set[Optional[str]] = set()
+
+
+def _set_as_non_tgi(model: Optional[str]) -> None:
+    _NON_TGI_SERVERS.add(model)
+
+
+def _is_tgi_server(model: Optional[str]) -> bool:
+    return model not in _NON_TGI_SERVERS
+
+
+_NON_CHAT_COMPLETION_SERVER: Set[str] = set()
+
+
+def _set_as_non_chat_completion_server(model: str) -> None:
+    print("Set as non chat completion", model)
+    _NON_CHAT_COMPLETION_SERVER.add(model)
+
+
+def _is_chat_completion_server(model: str) -> bool:
+    return model not in _NON_CHAT_COMPLETION_SERVER
+
+
+# TEXT GENERATION ERRORS
+# ----------------------
+# Text-generation errors are parsed separately to handle as much as possible the errors returned by the text generation
+# inference project (https://github.com/huggingface/text-generation-inference).
+# ----------------------
+
+
+def raise_text_generation_error(http_error: HTTPError) -> NoReturn:
+    """
+    Try to parse text-generation-inference error message and raise HTTPError in any case.
+
+    Args:
+        error (`HTTPError`):
+            The HTTPError that have been raised.
+    """
+    # Try to parse a Text Generation Inference error
+
+    try:
+        # Hacky way to retrieve payload in case of aiohttp error
+        payload = getattr(http_error, "response_error_payload", None) or http_error.response.json()
+        error = payload.get("error")
+        error_type = payload.get("error_type")
+    except Exception:  # no payload
+        raise http_error
+
+    # If error_type => more information than `hf_raise_for_status`
+    if error_type is not None:
+        exception = _parse_text_generation_error(error, error_type)
+        raise exception from http_error
+
+    # Otherwise, fallback to default error
+    raise http_error
+
+
+def _parse_text_generation_error(error: Optional[str], error_type: Optional[str]) -> TextGenerationError:
+    if error_type == "generation":
+        return GenerationError(error)  # type: ignore
+    if error_type == "incomplete_generation":
+        return IncompleteGenerationError(error)  # type: ignore
+    if error_type == "overloaded":
+        return OverloadedError(error)  # type: ignore
+    if error_type == "validation":
+        return ValidationError(error)  # type: ignore
+    return UnknownError(error)  # type: ignore
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/__init__.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ab49a7f0b92248ffb2fa5901c246bfff436ae3db
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/__pycache__/_async_client.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/__pycache__/_async_client.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..234b4bf16ef50af8154080a271ca14ba8ff629b0
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/__pycache__/_async_client.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/_async_client.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/_async_client.py
new file mode 100644
index 0000000000000000000000000000000000000000..f1e5032d1c0e6683b93e80bd7a123fb0a6126e3c
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/_async_client.py
@@ -0,0 +1,2389 @@
+# coding=utf-8
+# Copyright 2023-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# WARNING
+# This entire file has been adapted from the sync-client code in `src/huggingface_hub/inference/_client.py`.
+# Any change in InferenceClient will be automatically reflected in AsyncInferenceClient.
+# To re-generate the code, run `make style` or `python ./utils/generate_async_inference_client.py --update`.
+# WARNING
+import asyncio
+import base64
+import logging
+import time
+import warnings
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterable,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    Union,
+    overload,
+)
+
+from requests.structures import CaseInsensitiveDict
+
+from huggingface_hub.constants import ALL_INFERENCE_API_FRAMEWORKS, INFERENCE_ENDPOINT, MAIN_INFERENCE_API_FRAMEWORKS
+from huggingface_hub.errors import InferenceTimeoutError
+from huggingface_hub.inference._common import (
+    TASKS_EXPECTING_IMAGES,
+    ContentT,
+    ModelStatus,
+    _async_stream_chat_completion_response_from_bytes,
+    _async_stream_chat_completion_response_from_text_generation,
+    _async_stream_text_generation_response,
+    _b64_encode,
+    _b64_to_image,
+    _bytes_to_dict,
+    _bytes_to_image,
+    _bytes_to_list,
+    _fetch_recommended_models,
+    _import_numpy,
+    _is_chat_completion_server,
+    _is_tgi_server,
+    _open_as_binary,
+    _set_as_non_chat_completion_server,
+    _set_as_non_tgi,
+    raise_text_generation_error,
+)
+from huggingface_hub.inference._generated.types import (
+    AudioClassificationOutputElement,
+    AudioToAudioOutputElement,
+    AutomaticSpeechRecognitionOutput,
+    ChatCompletionOutput,
+    ChatCompletionOutputChoice,
+    ChatCompletionOutputChoiceMessage,
+    ChatCompletionStreamOutput,
+    DocumentQuestionAnsweringOutputElement,
+    FillMaskOutputElement,
+    ImageClassificationOutputElement,
+    ImageSegmentationOutputElement,
+    ImageToTextOutput,
+    ObjectDetectionOutputElement,
+    QuestionAnsweringOutputElement,
+    SummarizationOutput,
+    TableQuestionAnsweringOutputElement,
+    TextClassificationOutputElement,
+    TextGenerationOutput,
+    TextGenerationStreamOutput,
+    TokenClassificationOutputElement,
+    TranslationOutput,
+    VisualQuestionAnsweringOutputElement,
+    ZeroShotClassificationOutputElement,
+    ZeroShotImageClassificationOutputElement,
+)
+from huggingface_hub.inference._templating import render_chat_prompt
+from huggingface_hub.inference._types import (
+    ConversationalOutput,  # soon to be removed
+)
+from huggingface_hub.utils import (
+    build_hf_headers,
+)
+
+from .._common import _async_yield_from, _import_aiohttp
+
+
+if TYPE_CHECKING:
+    import numpy as np
+    from PIL import Image
+
+logger = logging.getLogger(__name__)
+
+
+class AsyncInferenceClient:
+    """
+    Initialize a new Inference Client.
+
+    [`InferenceClient`] aims to provide a unified experience to perform inference. The client can be used
+    seamlessly with either the (free) Inference API or self-hosted Inference Endpoints.
+
+    Args:
+        model (`str`, `optional`):
+            The model to run inference with. Can be a model id hosted on the Hugging Face Hub, e.g. `bigcode/starcoder`
+            or a URL to a deployed Inference Endpoint. Defaults to None, in which case a recommended model is
+            automatically selected for the task.
+        token (`str` or `bool`, *optional*):
+            Hugging Face token. Will default to the locally saved token if not provided.
+            Pass `token=False` if you don't want to send your token to the server.
+        timeout (`float`, `optional`):
+            The maximum number of seconds to wait for a response from the server. Loading a new model in Inference
+            API can take up to several minutes. Defaults to None, meaning it will loop until the server is available.
+        headers (`Dict[str, str]`, `optional`):
+            Additional headers to send to the server. By default only the authorization and user-agent headers are sent.
+            Values in this dictionary will override the default values.
+        cookies (`Dict[str, str]`, `optional`):
+            Additional cookies to send to the server.
+    """
+
+    def __init__(
+        self,
+        model: Optional[str] = None,
+        token: Union[str, bool, None] = None,
+        timeout: Optional[float] = None,
+        headers: Optional[Dict[str, str]] = None,
+        cookies: Optional[Dict[str, str]] = None,
+    ) -> None:
+        self.model: Optional[str] = model
+        self.token: Union[str, bool, None] = token
+        self.headers = CaseInsensitiveDict(build_hf_headers(token=token))  # contains 'authorization' + 'user-agent'
+        if headers is not None:
+            self.headers.update(headers)
+        self.cookies = cookies
+        self.timeout = timeout
+
+    def __repr__(self):
+        return f"<InferenceClient(model='{self.model if self.model else ''}', timeout={self.timeout})>"
+
+    @overload
+    async def post(  # type: ignore[misc]
+        self,
+        *,
+        json: Optional[Union[str, Dict, List]] = None,
+        data: Optional[ContentT] = None,
+        model: Optional[str] = None,
+        task: Optional[str] = None,
+        stream: Literal[False] = ...,
+    ) -> bytes: ...
+
+    @overload
+    async def post(  # type: ignore[misc]
+        self,
+        *,
+        json: Optional[Union[str, Dict, List]] = None,
+        data: Optional[ContentT] = None,
+        model: Optional[str] = None,
+        task: Optional[str] = None,
+        stream: Literal[True] = ...,
+    ) -> AsyncIterable[bytes]: ...
+
+    @overload
+    async def post(
+        self,
+        *,
+        json: Optional[Union[str, Dict, List]] = None,
+        data: Optional[ContentT] = None,
+        model: Optional[str] = None,
+        task: Optional[str] = None,
+        stream: bool = False,
+    ) -> Union[bytes, AsyncIterable[bytes]]: ...
+
+    async def post(
+        self,
+        *,
+        json: Optional[Union[str, Dict, List]] = None,
+        data: Optional[ContentT] = None,
+        model: Optional[str] = None,
+        task: Optional[str] = None,
+        stream: bool = False,
+    ) -> Union[bytes, AsyncIterable[bytes]]:
+        """
+        Make a POST request to the inference server.
+
+        Args:
+            json (`Union[str, Dict, List]`, *optional*):
+                The JSON data to send in the request body, specific to each task. Defaults to None.
+            data (`Union[str, Path, bytes, BinaryIO]`, *optional*):
+                The content to send in the request body, specific to each task.
+                It can be raw bytes, a pointer to an opened file, a local file path,
+                or a URL to an online resource (image, audio file,...). If both `json` and `data` are passed,
+                `data` will take precedence. At least `json` or `data` must be provided. Defaults to None.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. Will override the model defined at the instance level. Defaults to None.
+            task (`str`, *optional*):
+                The task to perform on the inference. All available tasks can be found
+                [here](https://huggingface.co/tasks). Used only to default to a recommended model if `model` is not
+                provided. At least `model` or `task` must be provided. Defaults to None.
+            stream (`bool`, *optional*):
+                Whether to iterate over streaming APIs.
+
+        Returns:
+            bytes: The raw bytes returned by the server.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+        """
+
+        aiohttp = _import_aiohttp()
+
+        url = self._resolve_url(model, task)
+
+        if data is not None and json is not None:
+            warnings.warn("Ignoring `json` as `data` is passed as binary.")
+
+        # Set Accept header if relevant
+        headers = self.headers.copy()
+        if task in TASKS_EXPECTING_IMAGES and "Accept" not in headers:
+            headers["Accept"] = "image/png"
+
+        t0 = time.time()
+        timeout = self.timeout
+        while True:
+            with _open_as_binary(data) as data_as_binary:
+                # Do not use context manager as we don't want to close the connection immediately when returning
+                # a stream
+                client = aiohttp.ClientSession(
+                    headers=headers, cookies=self.cookies, timeout=aiohttp.ClientTimeout(self.timeout)
+                )
+
+                try:
+                    response = await client.post(url, json=json, data=data_as_binary)
+                    response_error_payload = None
+                    if response.status != 200:
+                        try:
+                            response_error_payload = await response.json()  # get payload before connection closed
+                        except Exception:
+                            pass
+                    response.raise_for_status()
+                    if stream:
+                        return _async_yield_from(client, response)
+                    else:
+                        content = await response.read()
+                        await client.close()
+                        return content
+                except asyncio.TimeoutError as error:
+                    await client.close()
+                    # Convert any `TimeoutError` to a `InferenceTimeoutError`
+                    raise InferenceTimeoutError(f"Inference call timed out: {url}") from error  # type: ignore
+                except aiohttp.ClientResponseError as error:
+                    error.response_error_payload = response_error_payload
+                    await client.close()
+                    if response.status == 422 and task is not None:
+                        error.message += f". Make sure '{task}' task is supported by the model."
+                    if response.status == 503:
+                        # If Model is unavailable, either raise a TimeoutError...
+                        if timeout is not None and time.time() - t0 > timeout:
+                            raise InferenceTimeoutError(
+                                f"Model not loaded on the server: {url}. Please retry with a higher timeout"
+                                f" (current: {self.timeout}).",
+                                request=error.request,
+                                response=error.response,
+                            ) from error
+                        # ...or wait 1s and retry
+                        logger.info(f"Waiting for model to be loaded on the server: {error}")
+                        time.sleep(1)
+                        if timeout is not None:
+                            timeout = max(self.timeout - (time.time() - t0), 1)  # type: ignore
+                        continue
+                    raise error
+
+    async def audio_classification(
+        self,
+        audio: ContentT,
+        *,
+        model: Optional[str] = None,
+    ) -> List[AudioClassificationOutputElement]:
+        """
+        Perform audio classification on the provided audio content.
+
+        Args:
+            audio (Union[str, Path, bytes, BinaryIO]):
+                The audio content to classify. It can be raw audio bytes, a local audio file, or a URL pointing to an
+                audio file.
+            model (`str`, *optional*):
+                The model to use for audio classification. Can be a model ID hosted on the Hugging Face Hub
+                or a URL to a deployed Inference Endpoint. If not provided, the default recommended model for
+                audio classification will be used.
+
+        Returns:
+            `List[AudioClassificationOutputElement]`: List of [`AudioClassificationOutputElement`] items containing the predicted labels and their confidence.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.audio_classification("audio.flac")
+        [
+            AudioClassificationOutputElement(score=0.4976358711719513, label='hap'),
+            AudioClassificationOutputElement(score=0.3677836060523987, label='neu'),
+            ...
+        ]
+        ```
+        """
+        response = await self.post(data=audio, model=model, task="audio-classification")
+        return AudioClassificationOutputElement.parse_obj_as_list(response)
+
+    async def audio_to_audio(
+        self,
+        audio: ContentT,
+        *,
+        model: Optional[str] = None,
+    ) -> List[AudioToAudioOutputElement]:
+        """
+        Performs multiple tasks related to audio-to-audio depending on the model (eg: speech enhancement, source separation).
+
+        Args:
+            audio (Union[str, Path, bytes, BinaryIO]):
+                The audio content for the model. It can be raw audio bytes, a local audio file, or a URL pointing to an
+                audio file.
+            model (`str`, *optional*):
+                The model can be any model which takes an audio file and returns another audio file. Can be a model ID hosted on the Hugging Face Hub
+                or a URL to a deployed Inference Endpoint. If not provided, the default recommended model for
+                audio_to_audio will be used.
+
+        Returns:
+            `List[AudioToAudioOutputElement]`: A list of [`AudioToAudioOutputElement`] items containing audios label, content-type, and audio content in blob.
+
+        Raises:
+            `InferenceTimeoutError`:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> audio_output = await client.audio_to_audio("audio.flac")
+        >>> async for i, item in enumerate(audio_output):
+        >>>     with open(f"output_{i}.flac", "wb") as f:
+                    f.write(item.blob)
+        ```
+        """
+        response = await self.post(data=audio, model=model, task="audio-to-audio")
+        audio_output = AudioToAudioOutputElement.parse_obj_as_list(response)
+        for item in audio_output:
+            item.blob = base64.b64decode(item.blob)
+        return audio_output
+
+    async def automatic_speech_recognition(
+        self,
+        audio: ContentT,
+        *,
+        model: Optional[str] = None,
+    ) -> AutomaticSpeechRecognitionOutput:
+        """
+        Perform automatic speech recognition (ASR or audio-to-text) on the given audio content.
+
+        Args:
+            audio (Union[str, Path, bytes, BinaryIO]):
+                The content to transcribe. It can be raw audio bytes, local audio file, or a URL to an audio file.
+            model (`str`, *optional*):
+                The model to use for ASR. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. If not provided, the default recommended model for ASR will be used.
+
+        Returns:
+            [`AutomaticSpeechRecognitionOutput`]: An item containing the transcribed text and optionally the timestamp chunks.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.automatic_speech_recognition("hello_world.flac").text
+        "hello world"
+        ```
+        """
+        response = await self.post(data=audio, model=model, task="automatic-speech-recognition")
+        return AutomaticSpeechRecognitionOutput.parse_obj_as_instance(response)
+
+    @overload
+    async def chat_completion(  # type: ignore
+        self,
+        messages: List[Dict[str, str]],
+        *,
+        model: Optional[str] = None,
+        stream: Literal[False] = False,
+        max_tokens: int = 20,
+        seed: Optional[int] = None,
+        stop: Optional[Union[List[str], str]] = None,
+        temperature: float = 1.0,
+        top_p: Optional[float] = None,
+    ) -> ChatCompletionOutput: ...
+
+    @overload
+    async def chat_completion(  # type: ignore
+        self,
+        messages: List[Dict[str, str]],
+        *,
+        model: Optional[str] = None,
+        stream: Literal[True] = True,
+        max_tokens: int = 20,
+        seed: Optional[int] = None,
+        stop: Optional[Union[List[str], str]] = None,
+        temperature: float = 1.0,
+        top_p: Optional[float] = None,
+    ) -> AsyncIterable[ChatCompletionStreamOutput]: ...
+
+    @overload
+    async def chat_completion(
+        self,
+        messages: List[Dict[str, str]],
+        *,
+        model: Optional[str] = None,
+        stream: bool = False,
+        max_tokens: int = 20,
+        seed: Optional[int] = None,
+        stop: Optional[Union[List[str], str]] = None,
+        temperature: float = 1.0,
+        top_p: Optional[float] = None,
+    ) -> Union[ChatCompletionOutput, AsyncIterable[ChatCompletionStreamOutput]]: ...
+
+    async def chat_completion(
+        self,
+        messages: List[Dict[str, str]],
+        *,
+        model: Optional[str] = None,
+        stream: bool = False,
+        max_tokens: int = 20,
+        seed: Optional[int] = None,
+        stop: Optional[Union[List[str], str]] = None,
+        temperature: float = 1.0,
+        top_p: Optional[float] = None,
+    ) -> Union[ChatCompletionOutput, AsyncIterable[ChatCompletionStreamOutput]]:
+        """
+        A method for completing conversations using a specified language model.
+
+        <Tip>
+
+        If the model is served by a server supporting chat-completion, the method will directly call the server's
+        `/v1/chat/completions` endpoint. If the server does not support chat-completion, the method will render the
+        chat template client-side based on the information fetched from the Hub API. In this case, you will need to
+        have `minijinja` template engine installed. Run `pip install "huggingface_hub[inference]"` or `pip install minijinja`
+        to install it.
+
+        </Tip>
+
+        Args:
+            messages (List[Union[`SystemMessage`, `UserMessage`, `AssistantMessage`]]):
+                Conversation history consisting of roles and content pairs.
+            model (`str`, *optional*):
+                The model to use for chat-completion. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. If not provided, the default recommended model for chat-based text-generation will be used.
+                See https://huggingface.co/tasks/text-generation for more details.
+            frequency_penalty (`float`, optional):
+                Penalizes new tokens based on their existing frequency
+                in the text so far. Range: [-2.0, 2.0]. Defaults to 0.0.
+            max_tokens (`int`, optional):
+                Maximum number of tokens allowed in the response. Defaults to 20.
+            seed (Optional[`int`], optional):
+                Seed for reproducible control flow. Defaults to None.
+            stop (Optional[`str`], optional):
+                Up to four strings which trigger the end of the response.
+                Defaults to None.
+            stream (`bool`, optional):
+                Enable realtime streaming of responses. Defaults to False.
+            temperature (`float`, optional):
+                Controls randomness of the generations. Lower values ensure
+                less random completions. Range: [0, 2]. Defaults to 1.0.
+            top_p (`float`, optional):
+                Fraction of the most likely next words to sample from.
+                Must be between 0 and 1. Defaults to 1.0.
+
+        Returns:
+            `Union[ChatCompletionOutput, Iterable[ChatCompletionStreamOutput]]`:
+            Generated text returned from the server:
+            - if `stream=False`, the generated text is returned as a [`ChatCompletionOutput`] (default).
+            - if `stream=True`, the generated text is returned token by token as a sequence of [`ChatCompletionStreamOutput`].
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> messages = [{"role": "user", "content": "What is the capital of France?"}]
+        >>> client = AsyncInferenceClient("HuggingFaceH4/zephyr-7b-beta")
+        >>> await client.chat_completion(messages, max_tokens=100)
+        ChatCompletionOutput(
+            choices=[
+                ChatCompletionOutputChoice(
+                    finish_reason='eos_token',
+                    index=0,
+                    message=ChatCompletionOutputChoiceMessage(
+                        content='The capital of France is Paris. The official name of the city is "Ville de Paris" (City of Paris) and the name of the country\'s governing body, which is located in Paris, is "La République française" (The French Republic). \nI hope that helps! Let me know if you need any further information.'
+                    )
+                )
+            ],
+            created=1710498360
+        )
+
+        >>> async for token in await client.chat_completion(messages, max_tokens=10, stream=True):
+        ...     print(token)
+        ChatCompletionStreamOutput(choices=[ChatCompletionStreamOutputChoice(delta=ChatCompletionStreamOutputDelta(content='The', role='assistant'), index=0, finish_reason=None)], created=1710498504)
+        ChatCompletionStreamOutput(choices=[ChatCompletionStreamOutputChoice(delta=ChatCompletionStreamOutputDelta(content=' capital', role='assistant'), index=0, finish_reason=None)], created=1710498504)
+        (...)
+        ChatCompletionStreamOutput(choices=[ChatCompletionStreamOutputChoice(delta=ChatCompletionStreamOutputDelta(content=' may', role='assistant'), index=0, finish_reason=None)], created=1710498504)
+        ChatCompletionStreamOutput(choices=[ChatCompletionStreamOutputChoice(delta=ChatCompletionStreamOutputDelta(content=None, role=None), index=0, finish_reason='length')], created=1710498504)
+        ```
+        """
+        # determine model
+        model = model or self.model or self.get_recommended_model("text-generation")
+
+        if _is_chat_completion_server(model):
+            # First, let's consider the server has a `/v1/chat/completions` endpoint.
+            # If that's the case, we don't have to render the chat template client-side.
+            model_url = self._resolve_url(model)
+            if not model_url.endswith("/chat/completions"):
+                model_url += "/v1/chat/completions"
+
+            try:
+                data = await self.post(
+                    model=model_url,
+                    json=dict(
+                        model="tgi",  # random string
+                        messages=messages,
+                        max_tokens=max_tokens,
+                        seed=seed,
+                        stop=stop,
+                        temperature=temperature,
+                        top_p=top_p,
+                        stream=stream,
+                    ),
+                    stream=stream,
+                )
+            except _import_aiohttp().ClientResponseError:
+                # Let's consider the server is not a chat completion server.
+                # Then we call again `chat_completion` which will render the chat template client side.
+                # (can be HTTP 500, HTTP 400, HTTP 404 depending on the server)
+                _set_as_non_chat_completion_server(model)
+                return await self.chat_completion(
+                    messages=messages,
+                    model=model,
+                    stream=stream,
+                    max_tokens=max_tokens,
+                    seed=seed,
+                    stop=stop,
+                    temperature=temperature,
+                    top_p=top_p,
+                )
+
+            if stream:
+                return _async_stream_chat_completion_response_from_bytes(data)  # type: ignore[arg-type]
+
+            return ChatCompletionOutput.parse_obj_as_instance(data)  # type: ignore[arg-type]
+
+        # At this point, we know the server is not a chat completion server.
+        # We need to render the chat template client side based on the information we can fetch from
+        # the Hub API.
+
+        model_id = None
+        if model.startswith(("http://", "https://")):
+            # If URL, we need to know which model is served. This is not always possible.
+            # A workaround is to list the user Inference Endpoints and check if one of them correspond to the model URL.
+            # If not, we raise an error.
+            # TODO: fix when we have a proper API for this (at least for Inference Endpoints)
+            # TODO: what if Sagemaker URL?
+            # TODO: what if Azure URL?
+            from ..hf_api import HfApi
+
+            for endpoint in HfApi(token=self.token).list_inference_endpoints():
+                if endpoint.url == model:
+                    model_id = endpoint.repository
+                    break
+        else:
+            model_id = model
+
+        if model_id is None:
+            # If we don't have the model ID, we can't fetch the chat template.
+            # We raise an error.
+            raise ValueError(
+                "Request can't be processed as the model ID can't be inferred from model URL. "
+                "This is needed to fetch the chat template from the Hub since the model is not "
+                "served with a Chat-completion API."
+            )
+
+        # fetch chat template + tokens
+        prompt = render_chat_prompt(model_id=model_id, token=self.token, messages=messages)
+
+        # generate response
+        stop_sequences = [stop] if isinstance(stop, str) else stop
+        text_generation_output = await self.text_generation(
+            prompt=prompt,
+            details=True,
+            stream=stream,
+            model=model,
+            max_new_tokens=max_tokens,
+            seed=seed,
+            stop_sequences=stop_sequences,
+            temperature=temperature,
+            top_p=top_p,
+        )
+
+        created = int(time.time())
+
+        if stream:
+            return _async_stream_chat_completion_response_from_text_generation(text_generation_output)  # type: ignore [arg-type]
+
+        if isinstance(text_generation_output, TextGenerationOutput):
+            # General use case => format ChatCompletionOutput from text generation details
+            content: str = text_generation_output.generated_text
+            finish_reason: str = text_generation_output.details.finish_reason  # type: ignore[union-attr]
+        else:
+            # Corner case: if server doesn't support details (e.g. if not a TGI server), we only receive an output string.
+            # In such a case, `finish_reason` is set to `"unk"`.
+            content = text_generation_output  # type: ignore[assignment]
+            finish_reason = "unk"
+
+        return ChatCompletionOutput(
+            created=created,
+            choices=[
+                ChatCompletionOutputChoice(
+                    finish_reason=finish_reason,  # type: ignore
+                    index=0,
+                    message=ChatCompletionOutputChoiceMessage(
+                        content=content,
+                        role="assistant",
+                    ),
+                )
+            ],
+        )
+
+    async def conversational(
+        self,
+        text: str,
+        generated_responses: Optional[List[str]] = None,
+        past_user_inputs: Optional[List[str]] = None,
+        *,
+        parameters: Optional[Dict[str, Any]] = None,
+        model: Optional[str] = None,
+    ) -> ConversationalOutput:
+        """
+        Generate conversational responses based on the given input text (i.e. chat with the API).
+
+        <Tip warning={true}>
+
+        [`InferenceClient.conversational`] API is deprecated and will be removed in a future release. Please use
+        [`InferenceClient.chat_completion`] instead.
+
+        </Tip>
+
+        Args:
+            text (`str`):
+                The last input from the user in the conversation.
+            generated_responses (`List[str]`, *optional*):
+                A list of strings corresponding to the earlier replies from the model. Defaults to None.
+            past_user_inputs (`List[str]`, *optional*):
+                A list of strings corresponding to the earlier replies from the user. Should be the same length as
+                `generated_responses`. Defaults to None.
+            parameters (`Dict[str, Any]`, *optional*):
+                Additional parameters for the conversational task. Defaults to None. For more details about the available
+                parameters, please refer to [this page](https://huggingface.co/docs/api-inference/detailed_parameters#conversational-task)
+            model (`str`, *optional*):
+                The model to use for the conversational task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended conversational model will be used.
+                Defaults to None.
+
+        Returns:
+            `Dict`: The generated conversational output.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> output = await client.conversational("Hi, who are you?")
+        >>> output
+        {'generated_text': 'I am the one who knocks.', 'conversation': {'generated_responses': ['I am the one who knocks.'], 'past_user_inputs': ['Hi, who are you?']}, 'warnings': ['Setting `pad_token_id` to `eos_token_id`:50256 async for open-end generation.']}
+        >>> await client.conversational(
+        ...     "Wow, that's scary!",
+        ...     generated_responses=output["conversation"]["generated_responses"],
+        ...     past_user_inputs=output["conversation"]["past_user_inputs"],
+        ... )
+        ```
+        """
+        warnings.warn(
+            "'InferenceClient.conversational' is deprecated and will be removed starting from huggingface_hub>=0.25. "
+            "Please use the more appropriate 'InferenceClient.chat_completion' API instead.",
+            FutureWarning,
+        )
+        payload: Dict[str, Any] = {"inputs": {"text": text}}
+        if generated_responses is not None:
+            payload["inputs"]["generated_responses"] = generated_responses
+        if past_user_inputs is not None:
+            payload["inputs"]["past_user_inputs"] = past_user_inputs
+        if parameters is not None:
+            payload["parameters"] = parameters
+        response = await self.post(json=payload, model=model, task="conversational")
+        return _bytes_to_dict(response)  # type: ignore
+
+    async def document_question_answering(
+        self,
+        image: ContentT,
+        question: str,
+        *,
+        model: Optional[str] = None,
+    ) -> List[DocumentQuestionAnsweringOutputElement]:
+        """
+        Answer questions on document images.
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The input image for the context. It can be raw bytes, an image file, or a URL to an online image.
+            question (`str`):
+                Question to be answered.
+            model (`str`, *optional*):
+                The model to use for the document question answering task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended document question answering model will be used.
+                Defaults to None.
+
+        Returns:
+            `List[DocumentQuestionAnsweringOutputElement]`: a list of [`DocumentQuestionAnsweringOutputElement`] items containing the predicted label, associated probability, word ids, and page number.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.document_question_answering(image="https://huggingface.co/spaces/impira/docquery/resolve/2359223c1837a7587402bda0f2643382a6eefeab/invoice.png", question="What is the invoice number?")
+        [DocumentQuestionAnsweringOutputElement(score=0.42515629529953003, answer='us-001', start=16, end=16)]
+        ```
+        """
+        payload: Dict[str, Any] = {"question": question, "image": _b64_encode(image)}
+        response = await self.post(json=payload, model=model, task="document-question-answering")
+        return DocumentQuestionAnsweringOutputElement.parse_obj_as_list(response)
+
+    async def feature_extraction(self, text: str, *, model: Optional[str] = None) -> "np.ndarray":
+        """
+        Generate embeddings for a given text.
+
+        Args:
+            text (`str`):
+                The text to embed.
+            model (`str`, *optional*):
+                The model to use for the conversational task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended conversational model will be used.
+                Defaults to None.
+
+        Returns:
+            `np.ndarray`: The embedding representing the input text as a float32 numpy array.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.feature_extraction("Hi, who are you?")
+        array([[ 2.424802  ,  2.93384   ,  1.1750331 , ...,  1.240499, -0.13776633, -0.7889173 ],
+        [-0.42943227, -0.6364878 , -1.693462  , ...,  0.41978157, -2.4336355 ,  0.6162071 ],
+        ...,
+        [ 0.28552425, -0.928395  , -1.2077185 , ...,  0.76810825, -2.1069427 ,  0.6236161 ]], dtype=float32)
+        ```
+        """
+        response = await self.post(json={"inputs": text}, model=model, task="feature-extraction")
+        np = _import_numpy()
+        return np.array(_bytes_to_dict(response), dtype="float32")
+
+    async def fill_mask(self, text: str, *, model: Optional[str] = None) -> List[FillMaskOutputElement]:
+        """
+        Fill in a hole with a missing word (token to be precise).
+
+        Args:
+            text (`str`):
+                a string to be filled from, must contain the [MASK] token (check model card for exact name of the mask).
+            model (`str`, *optional*):
+                The model to use for the fill mask task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended fill mask model will be used.
+                Defaults to None.
+
+        Returns:
+            `List[FillMaskOutputElement]`: a list of [`FillMaskOutputElement`] items containing the predicted label, associated
+            probability, token reference, and completed text.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.fill_mask("The goal of life is <mask>.")
+        [
+            FillMaskOutputElement(score=0.06897063553333282, token=11098, token_str=' happiness', sequence='The goal of life is happiness.'),
+            FillMaskOutputElement(score=0.06554922461509705, token=45075, token_str=' immortality', sequence='The goal of life is immortality.')
+        ]
+        ```
+        """
+        response = await self.post(json={"inputs": text}, model=model, task="fill-mask")
+        return FillMaskOutputElement.parse_obj_as_list(response)
+
+    async def image_classification(
+        self,
+        image: ContentT,
+        *,
+        model: Optional[str] = None,
+    ) -> List[ImageClassificationOutputElement]:
+        """
+        Perform image classification on the given image using the specified model.
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The image to classify. It can be raw bytes, an image file, or a URL to an online image.
+            model (`str`, *optional*):
+                The model to use for image classification. Can be a model ID hosted on the Hugging Face Hub or a URL to a
+                deployed Inference Endpoint. If not provided, the default recommended model for image classification will be used.
+
+        Returns:
+            `List[ImageClassificationOutputElement]`: a list of [`ImageClassificationOutputElement`] items containing the predicted label and associated probability.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.image_classification("https://upload.wikimedia.org/wikipedia/commons/thumb/4/43/Cute_dog.jpg/320px-Cute_dog.jpg")
+        [ImageClassificationOutputElement(score=0.9779096841812134, label='Blenheim spaniel'), ...]
+        ```
+        """
+        response = await self.post(data=image, model=model, task="image-classification")
+        return ImageClassificationOutputElement.parse_obj_as_list(response)
+
+    async def image_segmentation(
+        self,
+        image: ContentT,
+        *,
+        model: Optional[str] = None,
+    ) -> List[ImageSegmentationOutputElement]:
+        """
+        Perform image segmentation on the given image using the specified model.
+
+        <Tip warning={true}>
+
+        You must have `PIL` installed if you want to work with images (`pip install Pillow`).
+
+        </Tip>
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The image to segment. It can be raw bytes, an image file, or a URL to an online image.
+            model (`str`, *optional*):
+                The model to use for image segmentation. Can be a model ID hosted on the Hugging Face Hub or a URL to a
+                deployed Inference Endpoint. If not provided, the default recommended model for image segmentation will be used.
+
+        Returns:
+            `List[ImageSegmentationOutputElement]`: A list of [`ImageSegmentationOutputElement`] items containing the segmented masks and associated attributes.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.image_segmentation("cat.jpg"):
+        [ImageSegmentationOutputElement(score=0.989008, label='LABEL_184', mask=<PIL.PngImagePlugin.PngImageFile image mode=L size=400x300 at 0x7FDD2B129CC0>), ...]
+        ```
+        """
+        response = await self.post(data=image, model=model, task="image-segmentation")
+        output = ImageSegmentationOutputElement.parse_obj_as_list(response)
+        for item in output:
+            item.mask = _b64_to_image(item.mask)
+        return output
+
+    async def image_to_image(
+        self,
+        image: ContentT,
+        prompt: Optional[str] = None,
+        *,
+        negative_prompt: Optional[str] = None,
+        height: Optional[int] = None,
+        width: Optional[int] = None,
+        num_inference_steps: Optional[int] = None,
+        guidance_scale: Optional[float] = None,
+        model: Optional[str] = None,
+        **kwargs,
+    ) -> "Image":
+        """
+        Perform image-to-image translation using a specified model.
+
+        <Tip warning={true}>
+
+        You must have `PIL` installed if you want to work with images (`pip install Pillow`).
+
+        </Tip>
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The input image for translation. It can be raw bytes, an image file, or a URL to an online image.
+            prompt (`str`, *optional*):
+                The text prompt to guide the image generation.
+            negative_prompt (`str`, *optional*):
+                A negative prompt to guide the translation process.
+            height (`int`, *optional*):
+                The height in pixels of the generated image.
+            width (`int`, *optional*):
+                The width in pixels of the generated image.
+            num_inference_steps (`int`, *optional*):
+                The number of denoising steps. More denoising steps usually lead to a higher quality image at the
+                expense of slower inference.
+            guidance_scale (`float`, *optional*):
+                Higher guidance scale encourages to generate images that are closely linked to the text `prompt`,
+                usually at the expense of lower image quality.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            `Image`: The translated image.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> image = await client.image_to_image("cat.jpg", prompt="turn the cat into a tiger")
+        >>> image.save("tiger.jpg")
+        ```
+        """
+        parameters = {
+            "prompt": prompt,
+            "negative_prompt": negative_prompt,
+            "height": height,
+            "width": width,
+            "num_inference_steps": num_inference_steps,
+            "guidance_scale": guidance_scale,
+            **kwargs,
+        }
+        if all(parameter is None for parameter in parameters.values()):
+            # Either only an image to send => send as raw bytes
+            data = image
+            payload: Optional[Dict[str, Any]] = None
+        else:
+            # Or an image + some parameters => use base64 encoding
+            data = None
+            payload = {"inputs": _b64_encode(image)}
+            for key, value in parameters.items():
+                if value is not None:
+                    payload.setdefault("parameters", {})[key] = value
+
+        response = await self.post(json=payload, data=data, model=model, task="image-to-image")
+        return _bytes_to_image(response)
+
+    async def image_to_text(self, image: ContentT, *, model: Optional[str] = None) -> ImageToTextOutput:
+        """
+        Takes an input image and return text.
+
+        Models can have very different outputs depending on your use case (image captioning, optical character recognition
+        (OCR), Pix2Struct, etc). Please have a look to the model card to learn more about a model's specificities.
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The input image to caption. It can be raw bytes, an image file, or a URL to an online image..
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            [`ImageToTextOutput`]: The generated text.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.image_to_text("cat.jpg")
+        'a cat standing in a grassy field '
+        >>> await client.image_to_text("https://upload.wikimedia.org/wikipedia/commons/thumb/4/43/Cute_dog.jpg/320px-Cute_dog.jpg")
+        'a dog laying on the grass next to a flower pot '
+        ```
+        """
+        response = await self.post(data=image, model=model, task="image-to-text")
+        return ImageToTextOutput.parse_obj_as_instance(response)
+
+    async def list_deployed_models(
+        self, frameworks: Union[None, str, Literal["all"], List[str]] = None
+    ) -> Dict[str, List[str]]:
+        """
+        List models currently deployed on the Inference API service.
+
+        This helper checks deployed models framework by framework. By default, it will check the 4 main frameworks that
+        are supported and account for 95% of the hosted models. However, if you want a complete list of models you can
+        specify `frameworks="all"` as input. Alternatively, if you know before-hand which framework you are interested
+        in, you can also restrict to search to this one (e.g. `frameworks="text-generation-inference"`). The more
+        frameworks are checked, the more time it will take.
+
+        <Tip>
+
+        This endpoint is mostly useful for discoverability. If you already know which model you want to use and want to
+        check its availability, you can directly use [`~InferenceClient.get_model_status`].
+
+        </Tip>
+
+        Args:
+            frameworks (`Literal["all"]` or `List[str]` or `str`, *optional*):
+                The frameworks to filter on. By default only a subset of the available frameworks are tested. If set to
+                "all", all available frameworks will be tested. It is also possible to provide a single framework or a
+                custom set of frameworks to check.
+
+        Returns:
+            `Dict[str, List[str]]`: A dictionary mapping task names to a sorted list of model IDs.
+
+        Example:
+        ```py
+        # Must be run in an async contextthon
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+
+        # Discover zero-shot-classification models currently deployed
+        >>> models = await client.list_deployed_models()
+        >>> models["zero-shot-classification"]
+        ['Narsil/deberta-large-mnli-zero-cls', 'facebook/bart-large-mnli', ...]
+
+        # List from only 1 framework
+        >>> await client.list_deployed_models("text-generation-inference")
+        {'text-generation': ['bigcode/starcoder', 'meta-llama/Llama-2-70b-chat-hf', ...], ...}
+        ```
+        """
+        # Resolve which frameworks to check
+        if frameworks is None:
+            frameworks = MAIN_INFERENCE_API_FRAMEWORKS
+        elif frameworks == "all":
+            frameworks = ALL_INFERENCE_API_FRAMEWORKS
+        elif isinstance(frameworks, str):
+            frameworks = [frameworks]
+        frameworks = list(set(frameworks))
+
+        # Fetch them iteratively
+        models_by_task: Dict[str, List[str]] = {}
+
+        def _unpack_response(framework: str, items: List[Dict]) -> None:
+            for model in items:
+                if framework == "sentence-transformers":
+                    # Model running with the `sentence-transformers` framework can work with both tasks even if not
+                    # branded as such in the API response
+                    models_by_task.setdefault("feature-extraction", []).append(model["model_id"])
+                    models_by_task.setdefault("sentence-similarity", []).append(model["model_id"])
+                else:
+                    models_by_task.setdefault(model["task"], []).append(model["model_id"])
+
+        async def _fetch_framework(framework: str) -> None:
+            async with _import_aiohttp().ClientSession(headers=self.headers) as client:
+                response = await client.get(f"{INFERENCE_ENDPOINT}/framework/{framework}")
+                response.raise_for_status()
+                _unpack_response(framework, await response.json())
+
+        import asyncio
+
+        await asyncio.gather(*[_fetch_framework(framework) for framework in frameworks])
+
+        # Sort alphabetically for discoverability and return
+        for task, models in models_by_task.items():
+            models_by_task[task] = sorted(set(models), key=lambda x: x.lower())
+        return models_by_task
+
+    async def object_detection(
+        self,
+        image: ContentT,
+        *,
+        model: Optional[str] = None,
+    ) -> List[ObjectDetectionOutputElement]:
+        """
+        Perform object detection on the given image using the specified model.
+
+        <Tip warning={true}>
+
+        You must have `PIL` installed if you want to work with images (`pip install Pillow`).
+
+        </Tip>
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The image to detect objects on. It can be raw bytes, an image file, or a URL to an online image.
+            model (`str`, *optional*):
+                The model to use for object detection. Can be a model ID hosted on the Hugging Face Hub or a URL to a
+                deployed Inference Endpoint. If not provided, the default recommended model for object detection (DETR) will be used.
+
+        Returns:
+            `List[ObjectDetectionOutputElement]`: A list of [`ObjectDetectionOutputElement`] items containing the bounding boxes and associated attributes.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+            `ValueError`:
+                If the request output is not a List.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.object_detection("people.jpg"):
+        [ObjectDetectionOutputElement(score=0.9486683011054993, label='person', box=ObjectDetectionBoundingBox(xmin=59, ymin=39, xmax=420, ymax=510)), ...]
+        ```
+        """
+        # detect objects
+        response = await self.post(data=image, model=model, task="object-detection")
+        return ObjectDetectionOutputElement.parse_obj_as_list(response)
+
+    async def question_answering(
+        self, question: str, context: str, *, model: Optional[str] = None
+    ) -> QuestionAnsweringOutputElement:
+        """
+        Retrieve the answer to a question from a given text.
+
+        Args:
+            question (`str`):
+                Question to be answered.
+            context (`str`):
+                The context of the question.
+            model (`str`):
+                The model to use for the question answering task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint.
+
+        Returns:
+            [`QuestionAnsweringOutputElement`]: an question answering output containing the score, start index, end index, and answer.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.question_answering(question="What's my name?", context="My name is Clara and I live in Berkeley.")
+        QuestionAnsweringOutputElement(score=0.9326562285423279, start=11, end=16, answer='Clara')
+        ```
+        """
+
+        payload: Dict[str, Any] = {"question": question, "context": context}
+        response = await self.post(
+            json=payload,
+            model=model,
+            task="question-answering",
+        )
+        return QuestionAnsweringOutputElement.parse_obj_as_instance(response)
+
+    async def sentence_similarity(
+        self, sentence: str, other_sentences: List[str], *, model: Optional[str] = None
+    ) -> List[float]:
+        """
+        Compute the semantic similarity between a sentence and a list of other sentences by comparing their embeddings.
+
+        Args:
+            sentence (`str`):
+                The main sentence to compare to others.
+            other_sentences (`List[str]`):
+                The list of sentences to compare to.
+            model (`str`, *optional*):
+                The model to use for the conversational task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended conversational model will be used.
+                Defaults to None.
+
+        Returns:
+            `List[float]`: The embedding representing the input text.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.sentence_similarity(
+        ...     "Machine learning is so easy.",
+        ...     other_sentences=[
+        ...         "Deep learning is so straightforward.",
+        ...         "This is so difficult, like rocket science.",
+        ...         "I can't believe how much I struggled with this.",
+        ...     ],
+        ... )
+        [0.7785726189613342, 0.45876261591911316, 0.2906220555305481]
+        ```
+        """
+        response = await self.post(
+            json={"inputs": {"source_sentence": sentence, "sentences": other_sentences}},
+            model=model,
+            task="sentence-similarity",
+        )
+        return _bytes_to_list(response)
+
+    async def summarization(
+        self,
+        text: str,
+        *,
+        parameters: Optional[Dict[str, Any]] = None,
+        model: Optional[str] = None,
+    ) -> SummarizationOutput:
+        """
+        Generate a summary of a given text using a specified model.
+
+        Args:
+            text (`str`):
+                The input text to summarize.
+            parameters (`Dict[str, Any]`, *optional*):
+                Additional parameters for summarization. Check out this [page](https://huggingface.co/docs/api-inference/detailed_parameters#summarization-task)
+                for more details.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            [`SummarizationOutput`]: The generated summary text.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.summarization("The Eiffel tower...")
+        SummarizationOutput(generated_text="The Eiffel tower is one of the most famous landmarks in the world....")
+        ```
+        """
+        payload: Dict[str, Any] = {"inputs": text}
+        if parameters is not None:
+            payload["parameters"] = parameters
+        response = await self.post(json=payload, model=model, task="summarization")
+        return SummarizationOutput.parse_obj_as_list(response)[0]
+
+    async def table_question_answering(
+        self, table: Dict[str, Any], query: str, *, model: Optional[str] = None
+    ) -> TableQuestionAnsweringOutputElement:
+        """
+        Retrieve the answer to a question from information given in a table.
+
+        Args:
+            table (`str`):
+                A table of data represented as a dict of lists where entries are headers and the lists are all the
+                values, all lists must have the same size.
+            query (`str`):
+                The query in plain text that you want to ask the table.
+            model (`str`):
+                The model to use for the table-question-answering task. Can be a model ID hosted on the Hugging Face
+                Hub or a URL to a deployed Inference Endpoint.
+
+        Returns:
+            [`TableQuestionAnsweringOutputElement`]: a table question answering output containing the answer, coordinates, cells and the aggregator used.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> query = "How many stars does the transformers repository have?"
+        >>> table = {"Repository": ["Transformers", "Datasets", "Tokenizers"], "Stars": ["36542", "4512", "3934"]}
+        >>> await client.table_question_answering(table, query, model="google/tapas-base-finetuned-wtq")
+        TableQuestionAnsweringOutputElement(answer='36542', coordinates=[[0, 1]], cells=['36542'], aggregator='AVERAGE')
+        ```
+        """
+        response = await self.post(
+            json={
+                "query": query,
+                "table": table,
+            },
+            model=model,
+            task="table-question-answering",
+        )
+        return TableQuestionAnsweringOutputElement.parse_obj_as_instance(response)
+
+    async def tabular_classification(self, table: Dict[str, Any], *, model: Optional[str] = None) -> List[str]:
+        """
+        Classifying a target category (a group) based on a set of attributes.
+
+        Args:
+            table (`Dict[str, Any]`):
+                Set of attributes to classify.
+            model (`str`, *optional*):
+                The model to use for the tabular classification task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended tabular classification model will be used.
+                Defaults to None.
+
+        Returns:
+            `List`: a list of labels, one per row in the initial table.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> table = {
+        ...     "fixed_acidity": ["7.4", "7.8", "10.3"],
+        ...     "volatile_acidity": ["0.7", "0.88", "0.32"],
+        ...     "citric_acid": ["0", "0", "0.45"],
+        ...     "residual_sugar": ["1.9", "2.6", "6.4"],
+        ...     "chlorides": ["0.076", "0.098", "0.073"],
+        ...     "free_sulfur_dioxide": ["11", "25", "5"],
+        ...     "total_sulfur_dioxide": ["34", "67", "13"],
+        ...     "density": ["0.9978", "0.9968", "0.9976"],
+        ...     "pH": ["3.51", "3.2", "3.23"],
+        ...     "sulphates": ["0.56", "0.68", "0.82"],
+        ...     "alcohol": ["9.4", "9.8", "12.6"],
+        ... }
+        >>> await client.tabular_classification(table=table, model="julien-c/wine-quality")
+        ["5", "5", "5"]
+        ```
+        """
+        response = await self.post(json={"table": table}, model=model, task="tabular-classification")
+        return _bytes_to_list(response)
+
+    async def tabular_regression(self, table: Dict[str, Any], *, model: Optional[str] = None) -> List[float]:
+        """
+        Predicting a numerical target value given a set of attributes/features in a table.
+
+        Args:
+            table (`Dict[str, Any]`):
+                Set of attributes stored in a table. The attributes used to predict the target can be both numerical and categorical.
+            model (`str`, *optional*):
+                The model to use for the tabular regression task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended tabular regression model will be used.
+                Defaults to None.
+
+        Returns:
+            `List`: a list of predicted numerical target values.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> table = {
+        ...     "Height": ["11.52", "12.48", "12.3778"],
+        ...     "Length1": ["23.2", "24", "23.9"],
+        ...     "Length2": ["25.4", "26.3", "26.5"],
+        ...     "Length3": ["30", "31.2", "31.1"],
+        ...     "Species": ["Bream", "Bream", "Bream"],
+        ...     "Width": ["4.02", "4.3056", "4.6961"],
+        ... }
+        >>> await client.tabular_regression(table, model="scikit-learn/Fish-Weight")
+        [110, 120, 130]
+        ```
+        """
+        response = await self.post(json={"table": table}, model=model, task="tabular-regression")
+        return _bytes_to_list(response)
+
+    async def text_classification(
+        self, text: str, *, model: Optional[str] = None
+    ) -> List[TextClassificationOutputElement]:
+        """
+        Perform text classification (e.g. sentiment-analysis) on the given text.
+
+        Args:
+            text (`str`):
+                A string to be classified.
+            model (`str`, *optional*):
+                The model to use for the text classification task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended text classification model will be used.
+                Defaults to None.
+
+        Returns:
+            `List[TextClassificationOutputElement]`: a list of [`TextClassificationOutputElement`] items containing the predicted label and associated probability.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.text_classification("I like you")
+        [
+            TextClassificationOutputElement(label='POSITIVE', score=0.9998695850372314),
+            TextClassificationOutputElement(label='NEGATIVE', score=0.0001304351753788069),
+        ]
+        ```
+        """
+        response = await self.post(json={"inputs": text}, model=model, task="text-classification")
+        return TextClassificationOutputElement.parse_obj_as_list(response)[0]  # type: ignore [return-value]
+
+    @overload
+    async def text_generation(  # type: ignore
+        self,
+        prompt: str,
+        *,
+        details: Literal[False] = ...,
+        stream: Literal[False] = ...,
+        model: Optional[str] = None,
+        do_sample: bool = False,
+        max_new_tokens: int = 20,
+        best_of: Optional[int] = None,
+        repetition_penalty: Optional[float] = None,
+        return_full_text: bool = False,
+        seed: Optional[int] = None,
+        stop_sequences: Optional[List[str]] = None,
+        temperature: Optional[float] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        truncate: Optional[int] = None,
+        typical_p: Optional[float] = None,
+        watermark: bool = False,
+    ) -> str: ...
+
+    @overload
+    async def text_generation(  # type: ignore
+        self,
+        prompt: str,
+        *,
+        details: Literal[True] = ...,
+        stream: Literal[False] = ...,
+        model: Optional[str] = None,
+        do_sample: bool = False,
+        max_new_tokens: int = 20,
+        best_of: Optional[int] = None,
+        repetition_penalty: Optional[float] = None,
+        return_full_text: bool = False,
+        seed: Optional[int] = None,
+        stop_sequences: Optional[List[str]] = None,
+        temperature: Optional[float] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        truncate: Optional[int] = None,
+        typical_p: Optional[float] = None,
+        watermark: bool = False,
+    ) -> TextGenerationOutput: ...
+
+    @overload
+    async def text_generation(  # type: ignore
+        self,
+        prompt: str,
+        *,
+        details: Literal[False] = ...,
+        stream: Literal[True] = ...,
+        model: Optional[str] = None,
+        do_sample: bool = False,
+        max_new_tokens: int = 20,
+        best_of: Optional[int] = None,
+        repetition_penalty: Optional[float] = None,
+        return_full_text: bool = False,
+        seed: Optional[int] = None,
+        stop_sequences: Optional[List[str]] = None,
+        temperature: Optional[float] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        truncate: Optional[int] = None,
+        typical_p: Optional[float] = None,
+        watermark: bool = False,
+    ) -> AsyncIterable[str]: ...
+
+    @overload
+    async def text_generation(  # type: ignore
+        self,
+        prompt: str,
+        *,
+        details: Literal[True] = ...,
+        stream: Literal[True] = ...,
+        model: Optional[str] = None,
+        do_sample: bool = False,
+        max_new_tokens: int = 20,
+        best_of: Optional[int] = None,
+        repetition_penalty: Optional[float] = None,
+        return_full_text: bool = False,
+        seed: Optional[int] = None,
+        stop_sequences: Optional[List[str]] = None,
+        temperature: Optional[float] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        truncate: Optional[int] = None,
+        typical_p: Optional[float] = None,
+        watermark: bool = False,
+    ) -> AsyncIterable[TextGenerationStreamOutput]: ...
+
+    @overload
+    async def text_generation(
+        self,
+        prompt: str,
+        *,
+        details: Literal[True] = ...,
+        stream: bool = ...,
+        model: Optional[str] = None,
+        do_sample: bool = False,
+        max_new_tokens: int = 20,
+        best_of: Optional[int] = None,
+        repetition_penalty: Optional[float] = None,
+        return_full_text: bool = False,
+        seed: Optional[int] = None,
+        stop_sequences: Optional[List[str]] = None,
+        temperature: Optional[float] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        truncate: Optional[int] = None,
+        typical_p: Optional[float] = None,
+        watermark: bool = False,
+    ) -> Union[TextGenerationOutput, AsyncIterable[TextGenerationStreamOutput]]: ...
+
+    async def text_generation(
+        self,
+        prompt: str,
+        *,
+        details: bool = False,
+        stream: bool = False,
+        model: Optional[str] = None,
+        do_sample: bool = False,
+        max_new_tokens: int = 20,
+        best_of: Optional[int] = None,
+        repetition_penalty: Optional[float] = None,
+        return_full_text: bool = False,
+        seed: Optional[int] = None,
+        stop_sequences: Optional[List[str]] = None,
+        temperature: Optional[float] = None,
+        top_k: Optional[int] = None,
+        top_p: Optional[float] = None,
+        truncate: Optional[int] = None,
+        typical_p: Optional[float] = None,
+        watermark: bool = False,
+        decoder_input_details: bool = False,
+    ) -> Union[str, TextGenerationOutput, AsyncIterable[str], AsyncIterable[TextGenerationStreamOutput]]:
+        """
+        Given a prompt, generate the following text.
+
+        API endpoint is supposed to run with the `text-generation-inference` backend (TGI). This backend is the
+        go-to solution to run large language models at scale. However, for some smaller models (e.g. "gpt2") the
+        default `transformers` + `api-inference` solution is still in use. Both approaches have very similar APIs, but
+        not exactly the same. This method is compatible with both approaches but some parameters are only available for
+        `text-generation-inference`. If some parameters are ignored, a warning message is triggered but the process
+        continues correctly.
+
+        To learn more about the TGI project, please refer to https://github.com/huggingface/text-generation-inference.
+
+        Args:
+            prompt (`str`):
+                Input text.
+            details (`bool`, *optional*):
+                By default, text_generation returns a string. Pass `details=True` if you want a detailed output (tokens,
+                probabilities, seed, finish reason, etc.). Only available for models running on with the
+                `text-generation-inference` backend.
+            stream (`bool`, *optional*):
+                By default, text_generation returns the full generated text. Pass `stream=True` if you want a stream of
+                tokens to be returned. Only available for models running on with the `text-generation-inference`
+                backend.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+            do_sample (`bool`):
+                Activate logits sampling
+            max_new_tokens (`int`):
+                Maximum number of generated tokens
+            best_of (`int`):
+                Generate best_of sequences and return the one if the highest token logprobs
+            repetition_penalty (`float`):
+                The parameter for repetition penalty. 1.0 means no penalty. See [this
+                paper](https://arxiv.org/pdf/1909.05858.pdf) for more details.
+            return_full_text (`bool`):
+                Whether to prepend the prompt to the generated text
+            seed (`int`):
+                Random sampling seed
+            stop_sequences (`List[str]`):
+                Stop generating tokens if a member of `stop_sequences` is generated
+            temperature (`float`):
+                The value used to module the logits distribution.
+            top_k (`int`):
+                The number of highest probability vocabulary tokens to keep for top-k-filtering.
+            top_p (`float`):
+                If set to < 1, only the smallest set of most probable tokens with probabilities that add up to `top_p` or
+                higher are kept for generation.
+            truncate (`int`):
+                Truncate inputs tokens to the given size
+            typical_p (`float`):
+                Typical Decoding mass
+                See [Typical Decoding for Natural Language Generation](https://arxiv.org/abs/2202.00666) for more information
+            watermark (`bool`):
+                Watermarking with [A Watermark for Large Language Models](https://arxiv.org/abs/2301.10226)
+            decoder_input_details (`bool`):
+                Return the decoder input token logprobs and ids. You must set `details=True` as well for it to be taken
+                into account. Defaults to `False`.
+
+        Returns:
+            `Union[str, TextGenerationOutput, Iterable[str], Iterable[TextGenerationStreamOutput]]`:
+            Generated text returned from the server:
+            - if `stream=False` and `details=False`, the generated text is returned as a `str` (default)
+            - if `stream=True` and `details=False`, the generated text is returned token by token as a `Iterable[str]`
+            - if `stream=False` and `details=True`, the generated text is returned with more details as a [`~huggingface_hub.TextGenerationOutput`]
+            - if `details=True` and `stream=True`, the generated text is returned token by token as a iterable of [`~huggingface_hub.TextGenerationStreamOutput`]
+
+        Raises:
+            `ValidationError`:
+                If input values are not valid. No HTTP call is made to the server.
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+
+        # Case 1: generate text
+        >>> await client.text_generation("The huggingface_hub library is ", max_new_tokens=12)
+        '100% open source and built to be easy to use.'
+
+        # Case 2: iterate over the generated tokens. Useful async for large generation.
+        >>> async for token in await client.text_generation("The huggingface_hub library is ", max_new_tokens=12, stream=True):
+        ...     print(token)
+        100
+        %
+        open
+        source
+        and
+        built
+        to
+        be
+        easy
+        to
+        use
+        .
+
+        # Case 3: get more details about the generation process.
+        >>> await client.text_generation("The huggingface_hub library is ", max_new_tokens=12, details=True)
+        TextGenerationOutput(
+            generated_text='100% open source and built to be easy to use.',
+            details=TextGenerationDetails(
+                finish_reason='length',
+                generated_tokens=12,
+                seed=None,
+                prefill=[
+                    TextGenerationPrefillToken(id=487, text='The', logprob=None),
+                    TextGenerationPrefillToken(id=53789, text=' hugging', logprob=-13.171875),
+                    (...)
+                    TextGenerationPrefillToken(id=204, text=' ', logprob=-7.0390625)
+                ],
+                tokens=[
+                    TokenElement(id=1425, text='100', logprob=-1.0175781, special=False),
+                    TokenElement(id=16, text='%', logprob=-0.0463562, special=False),
+                    (...)
+                    TokenElement(id=25, text='.', logprob=-0.5703125, special=False)
+                ],
+                best_of_sequences=None
+            )
+        )
+
+        # Case 4: iterate over the generated tokens with more details.
+        # Last object is more complete, containing the full generated text and the finish reason.
+        >>> async for details in await client.text_generation("The huggingface_hub library is ", max_new_tokens=12, details=True, stream=True):
+        ...     print(details)
+        ...
+        TextGenerationStreamOutput(token=TokenElement(id=1425, text='100', logprob=-1.0175781, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=16, text='%', logprob=-0.0463562, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=1314, text=' open', logprob=-1.3359375, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=3178, text=' source', logprob=-0.28100586, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=273, text=' and', logprob=-0.5961914, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=3426, text=' built', logprob=-1.9423828, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=271, text=' to', logprob=-1.4121094, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=314, text=' be', logprob=-1.5224609, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=1833, text=' easy', logprob=-2.1132812, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=271, text=' to', logprob=-0.08520508, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(id=745, text=' use', logprob=-0.39453125, special=False), generated_text=None, details=None)
+        TextGenerationStreamOutput(token=TokenElement(
+            id=25,
+            text='.',
+            logprob=-0.5703125,
+            special=False),
+            generated_text='100% open source and built to be easy to use.',
+            details=TextGenerationStreamDetails(finish_reason='length', generated_tokens=12, seed=None)
+        )
+        ```
+        """
+        if decoder_input_details and not details:
+            warnings.warn(
+                "`decoder_input_details=True` has been passed to the server but `details=False` is set meaning that"
+                " the output from the server will be truncated."
+            )
+            decoder_input_details = False
+
+        # Build payload
+        payload = {
+            "inputs": prompt,
+            "parameters": {
+                "best_of": best_of,
+                "decoder_input_details": decoder_input_details,
+                "details": details,
+                "do_sample": do_sample,
+                "max_new_tokens": max_new_tokens,
+                "repetition_penalty": repetition_penalty,
+                "return_full_text": return_full_text,
+                "seed": seed,
+                "stop": stop_sequences if stop_sequences is not None else [],
+                "temperature": temperature,
+                "top_k": top_k,
+                "top_p": top_p,
+                "truncate": truncate,
+                "typical_p": typical_p,
+                "watermark": watermark,
+            },
+            "stream": stream,
+        }
+
+        # Remove some parameters if not a TGI server
+        if not _is_tgi_server(model):
+            parameters: Dict = payload["parameters"]  # type: ignore [assignment]
+
+            ignored_parameters = []
+            for key in "watermark", "details", "decoder_input_details", "best_of", "stop", "return_full_text":
+                if parameters[key] is not None:
+                    ignored_parameters.append(key)
+                del parameters[key]
+            if len(ignored_parameters) > 0:
+                warnings.warn(
+                    "API endpoint/model for text-generation is not served via TGI. Ignoring parameters"
+                    f" {ignored_parameters}.",
+                    UserWarning,
+                )
+            if details:
+                warnings.warn(
+                    "API endpoint/model for text-generation is not served via TGI. Parameter `details=True` will"
+                    " be ignored meaning only the generated text will be returned.",
+                    UserWarning,
+                )
+                details = False
+            if stream:
+                raise ValueError(
+                    "API endpoint/model for text-generation is not served via TGI. Cannot return output as a stream."
+                    " Please pass `stream=False` as input."
+                )
+
+        # Handle errors separately for more precise error messages
+        try:
+            bytes_output = await self.post(json=payload, model=model, task="text-generation", stream=stream)  # type: ignore
+        except _import_aiohttp().ClientResponseError as e:
+            error_message = getattr(e, "response_error_payload", {}).get("error", "")
+            if e.code == 400 and "The following `model_kwargs` are not used by the model" in error_message:
+                _set_as_non_tgi(model)
+                return await self.text_generation(  # type: ignore
+                    prompt=prompt,
+                    details=details,
+                    stream=stream,
+                    model=model,
+                    do_sample=do_sample,
+                    max_new_tokens=max_new_tokens,
+                    best_of=best_of,
+                    repetition_penalty=repetition_penalty,
+                    return_full_text=return_full_text,
+                    seed=seed,
+                    stop_sequences=stop_sequences,
+                    temperature=temperature,
+                    top_k=top_k,
+                    top_p=top_p,
+                    truncate=truncate,
+                    typical_p=typical_p,
+                    watermark=watermark,
+                    decoder_input_details=decoder_input_details,
+                )
+            raise_text_generation_error(e)
+
+        # Parse output
+        if stream:
+            return _async_stream_text_generation_response(bytes_output, details)  # type: ignore
+
+        data = _bytes_to_dict(bytes_output)[0]  # type: ignore[arg-type]
+        return TextGenerationOutput.parse_obj_as_instance(data) if details else data["generated_text"]
+
+    async def text_to_image(
+        self,
+        prompt: str,
+        *,
+        negative_prompt: Optional[str] = None,
+        height: Optional[float] = None,
+        width: Optional[float] = None,
+        num_inference_steps: Optional[float] = None,
+        guidance_scale: Optional[float] = None,
+        model: Optional[str] = None,
+        **kwargs,
+    ) -> "Image":
+        """
+        Generate an image based on a given text using a specified model.
+
+        <Tip warning={true}>
+
+        You must have `PIL` installed if you want to work with images (`pip install Pillow`).
+
+        </Tip>
+
+        Args:
+            prompt (`str`):
+                The prompt to generate an image from.
+            negative_prompt (`str`, *optional*):
+                An optional negative prompt for the image generation.
+            height (`float`, *optional*):
+                The height in pixels of the image to generate.
+            width (`float`, *optional*):
+                The width in pixels of the image to generate.
+            num_inference_steps (`int`, *optional*):
+                The number of denoising steps. More denoising steps usually lead to a higher quality image at the
+                expense of slower inference.
+            guidance_scale (`float`, *optional*):
+                Higher guidance scale encourages to generate images that are closely linked to the text `prompt`,
+                usually at the expense of lower image quality.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            `Image`: The generated image.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+
+        >>> image = await client.text_to_image("An astronaut riding a horse on the moon.")
+        >>> image.save("astronaut.png")
+
+        >>> image = await client.text_to_image(
+        ...     "An astronaut riding a horse on the moon.",
+        ...     negative_prompt="low resolution, blurry",
+        ...     model="stabilityai/stable-diffusion-2-1",
+        ... )
+        >>> image.save("better_astronaut.png")
+        ```
+        """
+        payload = {"inputs": prompt}
+        parameters = {
+            "negative_prompt": negative_prompt,
+            "height": height,
+            "width": width,
+            "num_inference_steps": num_inference_steps,
+            "guidance_scale": guidance_scale,
+            **kwargs,
+        }
+        for key, value in parameters.items():
+            if value is not None:
+                payload.setdefault("parameters", {})[key] = value  # type: ignore
+        response = await self.post(json=payload, model=model, task="text-to-image")
+        return _bytes_to_image(response)
+
+    async def text_to_speech(self, text: str, *, model: Optional[str] = None) -> bytes:
+        """
+        Synthesize an audio of a voice pronouncing a given text.
+
+        Args:
+            text (`str`):
+                The text to synthesize.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            `bytes`: The generated audio.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from pathlib import Path
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+
+        >>> audio = await client.text_to_speech("Hello world")
+        >>> Path("hello_world.flac").write_bytes(audio)
+        ```
+        """
+        return await self.post(json={"inputs": text}, model=model, task="text-to-speech")
+
+    async def token_classification(
+        self, text: str, *, model: Optional[str] = None
+    ) -> List[TokenClassificationOutputElement]:
+        """
+        Perform token classification on the given text.
+        Usually used for sentence parsing, either grammatical, or Named Entity Recognition (NER) to understand keywords contained within text.
+
+        Args:
+            text (`str`):
+                A string to be classified.
+            model (`str`, *optional*):
+                The model to use for the token classification task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended token classification model will be used.
+                Defaults to None.
+
+        Returns:
+            `List[TokenClassificationOutputElement]`: List of [`TokenClassificationOutputElement`] items containing the entity group, confidence score, word, start and end index.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.token_classification("My name is Sarah Jessica Parker but you can call me Jessica")
+        [
+            TokenClassificationOutputElement(
+                entity_group='PER',
+                score=0.9971321225166321,
+                word='Sarah Jessica Parker',
+                start=11,
+                end=31,
+            ),
+            TokenClassificationOutputElement(
+                entity_group='PER',
+                score=0.9773476123809814,
+                word='Jessica',
+                start=52,
+                end=59,
+            )
+        ]
+        ```
+        """
+        payload: Dict[str, Any] = {"inputs": text}
+        response = await self.post(
+            json=payload,
+            model=model,
+            task="token-classification",
+        )
+        return TokenClassificationOutputElement.parse_obj_as_list(response)
+
+    async def translation(
+        self, text: str, *, model: Optional[str] = None, src_lang: Optional[str] = None, tgt_lang: Optional[str] = None
+    ) -> TranslationOutput:
+        """
+        Convert text from one language to another.
+
+        Check out https://huggingface.co/tasks/translation for more information on how to choose the best model for
+        your specific use case. Source and target languages usually depend on the model.
+        However, it is possible to specify source and target languages for certain models. If you are working with one of these models,
+        you can use `src_lang` and `tgt_lang` arguments to pass the relevant information.
+        You can find this information in the model card.
+
+        Args:
+            text (`str`):
+                A string to be translated.
+            model (`str`, *optional*):
+                The model to use for the translation task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended translation model will be used.
+                Defaults to None.
+            src_lang (`str`, *optional*):
+                Source language of the translation task, i.e. input language. Cannot be passed without `tgt_lang`.
+            tgt_lang (`str`, *optional*):
+                Target language of the translation task, i.e. output language. Cannot be passed without `src_lang`.
+
+        Returns:
+            [`TranslationOutput`]: The generated translated text.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+            `ValueError`:
+                If only one of the `src_lang` and `tgt_lang` arguments are provided.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.translation("My name is Wolfgang and I live in Berlin")
+        'Mein Name ist Wolfgang und ich lebe in Berlin.'
+        >>> await client.translation("My name is Wolfgang and I live in Berlin", model="Helsinki-NLP/opus-mt-en-fr")
+        TranslationOutput(translation_text='Je m\'appelle Wolfgang et je vis à Berlin.')
+        ```
+
+        Specifying languages:
+        ```py
+        >>> client.translation("My name is Sarah Jessica Parker but you can call me Jessica", model="facebook/mbart-large-50-many-to-many-mmt", src_lang="en_XX", tgt_lang="fr_XX")
+        "Mon nom est Sarah Jessica Parker mais vous pouvez m\'appeler Jessica"
+        ```
+        """
+        # Throw error if only one of `src_lang` and `tgt_lang` was given
+        if src_lang is not None and tgt_lang is None:
+            raise ValueError("You cannot specify `src_lang` without specifying `tgt_lang`.")
+
+        if src_lang is None and tgt_lang is not None:
+            raise ValueError("You cannot specify `tgt_lang` without specifying `src_lang`.")
+
+        # If both `src_lang` and `tgt_lang` are given, pass them to the request body
+        payload: Dict = {"inputs": text}
+        if src_lang and tgt_lang:
+            payload["parameters"] = {"src_lang": src_lang, "tgt_lang": tgt_lang}
+        response = await self.post(json=payload, model=model, task="translation")
+        return TranslationOutput.parse_obj_as_list(response)[0]
+
+    async def visual_question_answering(
+        self,
+        image: ContentT,
+        question: str,
+        *,
+        model: Optional[str] = None,
+    ) -> List[VisualQuestionAnsweringOutputElement]:
+        """
+        Answering open-ended questions based on an image.
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The input image for the context. It can be raw bytes, an image file, or a URL to an online image.
+            question (`str`):
+                Question to be answered.
+            model (`str`, *optional*):
+                The model to use for the visual question answering task. Can be a model ID hosted on the Hugging Face Hub or a URL to
+                a deployed Inference Endpoint. If not provided, the default recommended visual question answering model will be used.
+                Defaults to None.
+
+        Returns:
+            `List[VisualQuestionAnsweringOutputElement]`: a list of [`VisualQuestionAnsweringOutputElement`] items containing the predicted label and associated probability.
+
+        Raises:
+            `InferenceTimeoutError`:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.visual_question_answering(
+        ...     image="https://huggingface.co/datasets/mishig/sample_images/resolve/main/tiger.jpg",
+        ...     question="What is the animal doing?"
+        ... )
+        [
+            VisualQuestionAnsweringOutputElement(score=0.778609573841095, answer='laying down'),
+            VisualQuestionAnsweringOutputElement(score=0.6957435607910156, answer='sitting'),
+        ]
+        ```
+        """
+        payload: Dict[str, Any] = {"question": question, "image": _b64_encode(image)}
+        response = await self.post(json=payload, model=model, task="visual-question-answering")
+        return VisualQuestionAnsweringOutputElement.parse_obj_as_list(response)
+
+    async def zero_shot_classification(
+        self, text: str, labels: List[str], *, multi_label: bool = False, model: Optional[str] = None
+    ) -> List[ZeroShotClassificationOutputElement]:
+        """
+        Provide as input a text and a set of candidate labels to classify the input text.
+
+        Args:
+            text (`str`):
+                The input text to classify.
+            labels (`List[str]`):
+                List of string possible labels. There must be at least 2 labels.
+            multi_label (`bool`):
+                Boolean that is set to True if classes can overlap.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            `List[ZeroShotClassificationOutputElement]`: List of [`ZeroShotClassificationOutputElement`] items containing the predicted labels and their confidence.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> text = (
+        ...     "A new model offers an explanation async for how the Galilean satellites formed around the solar system's"
+        ...     "largest world. Konstantin Batygin did not set out to solve one of the solar system's most puzzling"
+        ...     " mysteries when he went async for a run up a hill in Nice, France."
+        ... )
+        >>> labels = ["space & cosmos", "scientific discovery", "microbiology", "robots", "archeology"]
+        >>> await client.zero_shot_classification(text, labels)
+        [
+            ZeroShotClassificationOutputElement(label='scientific discovery', score=0.7961668968200684),
+            ZeroShotClassificationOutputElement(label='space & cosmos', score=0.18570658564567566),
+            ZeroShotClassificationOutputElement(label='microbiology', score=0.00730885099619627),
+            ZeroShotClassificationOutputElement(label='archeology', score=0.006258360575884581),
+            ZeroShotClassificationOutputElement(label='robots', score=0.004559356719255447),
+        ]
+        >>> await client.zero_shot_classification(text, labels, multi_label=True)
+        [
+            ZeroShotClassificationOutputElement(label='scientific discovery', score=0.9829297661781311),
+            ZeroShotClassificationOutputElement(label='space & cosmos', score=0.755190908908844),
+            ZeroShotClassificationOutputElement(label='microbiology', score=0.0005462635890580714),
+            ZeroShotClassificationOutputElement(label='archeology', score=0.00047131875180639327),
+            ZeroShotClassificationOutputElement(label='robots', score=0.00030448526376858354),
+        ]
+        ```
+        """
+        # Raise ValueError if input is less than 2 labels
+        if len(labels) < 2:
+            raise ValueError("You must specify at least 2 classes to compare.")
+
+        response = await self.post(
+            json={
+                "inputs": text,
+                "parameters": {
+                    "candidate_labels": ",".join(labels),
+                    "multi_label": multi_label,
+                },
+            },
+            model=model,
+            task="zero-shot-classification",
+        )
+        output = _bytes_to_dict(response)
+        return [
+            ZeroShotClassificationOutputElement.parse_obj_as_instance({"label": label, "score": score})
+            for label, score in zip(output["labels"], output["scores"])
+        ]
+
+    async def zero_shot_image_classification(
+        self, image: ContentT, labels: List[str], *, model: Optional[str] = None
+    ) -> List[ZeroShotImageClassificationOutputElement]:
+        """
+        Provide input image and text labels to predict text labels for the image.
+
+        Args:
+            image (`Union[str, Path, bytes, BinaryIO]`):
+                The input image to caption. It can be raw bytes, an image file, or a URL to an online image.
+            labels (`List[str]`):
+                List of string possible labels. There must be at least 2 labels.
+            model (`str`, *optional*):
+                The model to use for inference. Can be a model ID hosted on the Hugging Face Hub or a URL to a deployed
+                Inference Endpoint. This parameter overrides the model defined at the instance level. Defaults to None.
+
+        Returns:
+            `List[ZeroShotImageClassificationOutputElement]`: List of [`ZeroShotImageClassificationOutputElement`] items containing the predicted labels and their confidence.
+
+        Raises:
+            [`InferenceTimeoutError`]:
+                If the model is unavailable or the request times out.
+            `aiohttp.ClientResponseError`:
+                If the request fails with an HTTP error status code other than HTTP 503.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+
+        >>> await client.zero_shot_image_classification(
+        ...     "https://upload.wikimedia.org/wikipedia/commons/thumb/4/43/Cute_dog.jpg/320px-Cute_dog.jpg",
+        ...     labels=["dog", "cat", "horse"],
+        ... )
+        [ZeroShotImageClassificationOutputElement(label='dog', score=0.956),...]
+        ```
+        """
+        # Raise ValueError if input is less than 2 labels
+        if len(labels) < 2:
+            raise ValueError("You must specify at least 2 classes to compare.")
+
+        response = await self.post(
+            json={"image": _b64_encode(image), "parameters": {"candidate_labels": ",".join(labels)}},
+            model=model,
+            task="zero-shot-image-classification",
+        )
+        return ZeroShotImageClassificationOutputElement.parse_obj_as_list(response)
+
+    def _resolve_url(self, model: Optional[str] = None, task: Optional[str] = None) -> str:
+        model = model or self.model
+
+        # If model is already a URL, ignore `task` and return directly
+        if model is not None and (model.startswith("http://") or model.startswith("https://")):
+            return model
+
+        # # If no model but task is set => fetch the recommended one for this task
+        if model is None:
+            if task is None:
+                raise ValueError(
+                    "You must specify at least a model (repo_id or URL) or a task, either when instantiating"
+                    " `InferenceClient` or when making a request."
+                )
+            model = self.get_recommended_model(task)
+            logger.info(
+                f"Using recommended model {model} for task {task}. Note that it is"
+                f" encouraged to explicitly set `model='{model}'` as the recommended"
+                " models list might get updated without prior notice."
+            )
+
+        # Compute InferenceAPI url
+        return (
+            # Feature-extraction and sentence-similarity are the only cases where we handle models with several tasks.
+            f"{INFERENCE_ENDPOINT}/pipeline/{task}/{model}"
+            if task in ("feature-extraction", "sentence-similarity")
+            # Otherwise, we use the default endpoint
+            else f"{INFERENCE_ENDPOINT}/models/{model}"
+        )
+
+    @staticmethod
+    def get_recommended_model(task: str) -> str:
+        """
+        Get the model Hugging Face recommends for the input task.
+
+        Args:
+            task (`str`):
+                The Hugging Face task to get which model Hugging Face recommends.
+                All available tasks can be found [here](https://huggingface.co/tasks).
+
+        Returns:
+            `str`: Name of the model recommended for the input task.
+
+        Raises:
+            `ValueError`: If Hugging Face has no recommendation for the input task.
+        """
+        model = _fetch_recommended_models().get(task)
+        if model is None:
+            raise ValueError(
+                f"Task {task} has no recommended model. Please specify a model"
+                " explicitly. Visit https://huggingface.co/tasks for more info."
+            )
+        return model
+
+    async def get_model_status(self, model: Optional[str] = None) -> ModelStatus:
+        """
+        Get the status of a model hosted on the Inference API.
+
+        <Tip>
+
+        This endpoint is mostly useful when you already know which model you want to use and want to check its
+        availability. If you want to discover already deployed models, you should rather use [`~InferenceClient.list_deployed_models`].
+
+        </Tip>
+
+        Args:
+            model (`str`, *optional*):
+                Identifier of the model for witch the status gonna be checked. If model is not provided,
+                the model associated with this instance of [`InferenceClient`] will be used. Only InferenceAPI service can be checked so the
+                identifier cannot be a URL.
+
+
+        Returns:
+            [`ModelStatus`]: An instance of ModelStatus dataclass, containing information,
+                         about the state of the model: load, state, compute type and framework.
+
+        Example:
+        ```py
+        # Must be run in an async context
+        >>> from huggingface_hub import AsyncInferenceClient
+        >>> client = AsyncInferenceClient()
+        >>> await client.get_model_status("bigcode/starcoder")
+        ModelStatus(loaded=True, state='Loaded', compute_type='gpu', framework='text-generation-inference')
+        ```
+        """
+        model = model or self.model
+        if model is None:
+            raise ValueError("Model id not provided.")
+        if model.startswith("https://"):
+            raise NotImplementedError("Model status is only available for Inference API endpoints.")
+        url = f"{INFERENCE_ENDPOINT}/status/{model}"
+
+        async with _import_aiohttp().ClientSession(headers=self.headers) as client:
+            response = await client.get(url)
+            response.raise_for_status()
+            response_data = await response.json()
+
+        if "error" in response_data:
+            raise ValueError(response_data["error"])
+
+        return ModelStatus(
+            loaded=response_data["loaded"],
+            state=response_data["state"],
+            compute_type=response_data["compute_type"],
+            framework=response_data["framework"],
+        )
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__init__.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ece102c4d7a7d1a6c5ee46e066a0a3b867e342e0
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__init__.py
@@ -0,0 +1,115 @@
+# This file is auto-generated by `utils/generate_inference_types.py`.
+# Do not modify it manually.
+#
+# ruff: noqa: F401
+
+from .audio_classification import (
+    AudioClassificationInput,
+    AudioClassificationOutputElement,
+    AudioClassificationParameters,
+)
+from .audio_to_audio import AudioToAudioInput, AudioToAudioOutputElement
+from .automatic_speech_recognition import (
+    AutomaticSpeechRecognitionGenerationParameters,
+    AutomaticSpeechRecognitionInput,
+    AutomaticSpeechRecognitionOutput,
+    AutomaticSpeechRecognitionOutputChunk,
+    AutomaticSpeechRecognitionParameters,
+)
+from .base import BaseInferenceType
+from .chat_completion import (
+    ChatCompletionInput,
+    ChatCompletionInputMessage,
+    ChatCompletionOutput,
+    ChatCompletionOutputChoice,
+    ChatCompletionOutputChoiceMessage,
+    ChatCompletionStreamOutput,
+    ChatCompletionStreamOutputChoice,
+    ChatCompletionStreamOutputDelta,
+)
+from .depth_estimation import DepthEstimationInput, DepthEstimationOutput
+from .document_question_answering import (
+    DocumentQuestionAnsweringInput,
+    DocumentQuestionAnsweringInputData,
+    DocumentQuestionAnsweringOutputElement,
+    DocumentQuestionAnsweringParameters,
+)
+from .feature_extraction import FeatureExtractionInput
+from .fill_mask import FillMaskInput, FillMaskOutputElement, FillMaskParameters
+from .image_classification import (
+    ImageClassificationInput,
+    ImageClassificationOutputElement,
+    ImageClassificationParameters,
+)
+from .image_segmentation import ImageSegmentationInput, ImageSegmentationOutputElement, ImageSegmentationParameters
+from .image_to_image import ImageToImageInput, ImageToImageOutput, ImageToImageParameters, ImageToImageTargetSize
+from .image_to_text import ImageToTextGenerationParameters, ImageToTextInput, ImageToTextOutput, ImageToTextParameters
+from .object_detection import (
+    ObjectDetectionBoundingBox,
+    ObjectDetectionInput,
+    ObjectDetectionOutputElement,
+    ObjectDetectionParameters,
+)
+from .question_answering import (
+    QuestionAnsweringInput,
+    QuestionAnsweringInputData,
+    QuestionAnsweringOutputElement,
+    QuestionAnsweringParameters,
+)
+from .sentence_similarity import SentenceSimilarityInput, SentenceSimilarityInputData
+from .summarization import SummarizationGenerationParameters, SummarizationInput, SummarizationOutput
+from .table_question_answering import (
+    TableQuestionAnsweringInput,
+    TableQuestionAnsweringInputData,
+    TableQuestionAnsweringOutputElement,
+)
+from .text2text_generation import Text2TextGenerationInput, Text2TextGenerationOutput, Text2TextGenerationParameters
+from .text_classification import TextClassificationInput, TextClassificationOutputElement, TextClassificationParameters
+from .text_generation import (
+    TextGenerationInput,
+    TextGenerationOutput,
+    TextGenerationOutputDetails,
+    TextGenerationOutputSequenceDetails,
+    TextGenerationOutputToken,
+    TextGenerationParameters,
+    TextGenerationPrefillToken,
+    TextGenerationStreamDetails,
+    TextGenerationStreamOutput,
+)
+from .text_to_audio import TextToAudioGenerationParameters, TextToAudioInput, TextToAudioOutput, TextToAudioParameters
+from .text_to_image import TextToImageInput, TextToImageOutput, TextToImageParameters, TextToImageTargetSize
+from .token_classification import (
+    TokenClassificationInput,
+    TokenClassificationOutputElement,
+    TokenClassificationParameters,
+)
+from .translation import TranslationGenerationParameters, TranslationInput, TranslationOutput
+from .video_classification import (
+    VideoClassificationInput,
+    VideoClassificationOutputElement,
+    VideoClassificationParameters,
+)
+from .visual_question_answering import (
+    VisualQuestionAnsweringInput,
+    VisualQuestionAnsweringInputData,
+    VisualQuestionAnsweringOutputElement,
+    VisualQuestionAnsweringParameters,
+)
+from .zero_shot_classification import (
+    ZeroShotClassificationInput,
+    ZeroShotClassificationInputData,
+    ZeroShotClassificationOutputElement,
+    ZeroShotClassificationParameters,
+)
+from .zero_shot_image_classification import (
+    ZeroShotImageClassificationInput,
+    ZeroShotImageClassificationInputData,
+    ZeroShotImageClassificationOutputElement,
+    ZeroShotImageClassificationParameters,
+)
+from .zero_shot_object_detection import (
+    ZeroShotObjectDetectionBoundingBox,
+    ZeroShotObjectDetectionInput,
+    ZeroShotObjectDetectionInputData,
+    ZeroShotObjectDetectionOutputElement,
+)
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e9f457f1bc8cd553239724d9e3234072c248d532
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/audio_classification.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/audio_classification.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3da4d66daafbe9fa046f21d3bc9f9862f136ac99
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/audio_classification.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/audio_to_audio.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/audio_to_audio.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9d61f1caba65403bf7dd82903f8c2f87fb930523
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/audio_to_audio.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/automatic_speech_recognition.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/automatic_speech_recognition.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..68127d9000c99bd1eae270ac2b683eff2872fb5a
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/automatic_speech_recognition.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..41217dbecfb498af9ca104f8d1726799f741dba3
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/chat_completion.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/chat_completion.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1bb4405e347c19de8ac1f52b057c1e3dedca0c6e
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/chat_completion.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/depth_estimation.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/depth_estimation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..60e4a4f06a03438b24ab7e03f4b566559a86f831
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/depth_estimation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/document_question_answering.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/document_question_answering.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a581acacf947ec03bf5fdbf3f8ffbf7ddb7a62cf
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/document_question_answering.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/feature_extraction.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/feature_extraction.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1cdc962ebf06897e9cf809520855d7bea5d1966a
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/feature_extraction.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/fill_mask.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/fill_mask.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8b5ab020f01bfd307000827f07562a480acc0830
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/fill_mask.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/image_classification.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/image_classification.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4385f15e78ee81170b3d7a25edaa4c4eca28dbd8
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/image_classification.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/image_segmentation.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/image_segmentation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a1fe03506e13900ddca841fed310ce9f6e491990
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/image_segmentation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/image_to_image.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/image_to_image.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a4808ea7ce81b4bd0f174325c68958d518a2246e
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/image_to_image.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/image_to_text.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/image_to_text.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5b3ad895b5eab360a7bbfcf3ddbed3725b7e16a6
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/image_to_text.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/object_detection.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/object_detection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d26c88f8bdc8779eb771b9d5dc3ca7fa3c9153c1
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/object_detection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/question_answering.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/question_answering.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fdece5046fad3e40958ef6ebddd3b54d78d69ef5
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/question_answering.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/sentence_similarity.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/sentence_similarity.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6766e2e8d150d050695415cfc72d16ca989a562f
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/sentence_similarity.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/summarization.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/summarization.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9d8210863a4aa45b5e9b7d82e764307d2c5f6ade
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/summarization.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/table_question_answering.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/table_question_answering.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ba7f233df5c941a974bf25083a73be40697cddc7
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/table_question_answering.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text2text_generation.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text2text_generation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c04a6c77730ecb6369d84c5809e6ecde4e2453b2
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text2text_generation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text_classification.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text_classification.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6ee3f5891cb8ec33e4b8e2e3ee5a7fe948499ec9
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text_classification.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text_generation.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text_generation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f1fd77875facfc73709ef8c1a7117279b33ed4ae
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text_generation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text_to_audio.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text_to_audio.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..843cfa44ef6efe8a54bd7a479ff320b519160c5c
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text_to_audio.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text_to_image.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text_to_image.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..85f04a2c0d3291d4559f07f99a3bc59b347eecf0
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/text_to_image.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/token_classification.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/token_classification.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cad0caca88aeddebf180347cfb8c3d7e214d7b0c
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/token_classification.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/translation.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/translation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e1046638e87a99735a05074e23a9dc537df8c73e
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/translation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/video_classification.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/video_classification.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..52621be06b806ac7b6484b0ff2224732f79cd3f3
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/video_classification.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/visual_question_answering.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/visual_question_answering.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..468d40f486d24628a802998cfe91ac18d75def42
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/visual_question_answering.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/zero_shot_classification.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/zero_shot_classification.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a10019f612323af882718dfdb063c57f0cfd433f
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/zero_shot_classification.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/zero_shot_image_classification.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/zero_shot_image_classification.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f3715dd5153d760479977d8706f5bca1e53a4c97
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/zero_shot_image_classification.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/zero_shot_object_detection.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/zero_shot_object_detection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..553dacb2f56df10ede68aabff2c878da27594885
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/__pycache__/zero_shot_object_detection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/audio_classification.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/audio_classification.py
new file mode 100644
index 0000000000000000000000000000000000000000..914ba44960b5edca2f182bd1c3f15e9f01bce3b9
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/audio_classification.py
@@ -0,0 +1,43 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Literal, Optional
+
+from .base import BaseInferenceType
+
+
+ClassificationOutputTransform = Literal["sigmoid", "softmax", "none"]
+
+
+@dataclass
+class AudioClassificationParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Audio Classification
+    """
+
+    function_to_apply: Optional["ClassificationOutputTransform"] = None
+    top_k: Optional[int] = None
+    """When specified, limits the output to the top K most probable classes."""
+
+
+@dataclass
+class AudioClassificationInput(BaseInferenceType):
+    """Inputs for Audio Classification inference"""
+
+    inputs: Any
+    """The input audio data"""
+    parameters: Optional[AudioClassificationParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class AudioClassificationOutputElement(BaseInferenceType):
+    """Outputs for Audio Classification inference"""
+
+    label: str
+    """The predicted class label."""
+    score: float
+    """The corresponding probability."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/audio_to_audio.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/audio_to_audio.py
new file mode 100644
index 0000000000000000000000000000000000000000..4f473ed106c7d168784ae8e96db18f46237d065e
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/audio_to_audio.py
@@ -0,0 +1,31 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class AudioToAudioInput(BaseInferenceType):
+    """Inputs for Audio to Audio inference"""
+
+    inputs: Any
+    """The input audio data"""
+
+
+@dataclass
+class AudioToAudioOutputElement(BaseInferenceType):
+    """Outputs of inference for the Audio To Audio task
+    A generated audio file with its label.
+    """
+
+    blob: Any
+    """The generated audio file."""
+    content_type: str
+    """The content type of audio file."""
+    label: str
+    """The label of the audio file."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/automatic_speech_recognition.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/automatic_speech_recognition.py
new file mode 100644
index 0000000000000000000000000000000000000000..24a5238ab6b33ea13df79a1ea197b4f07b39c1ec
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/automatic_speech_recognition.py
@@ -0,0 +1,116 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, List, Literal, Optional, Union
+
+from .base import BaseInferenceType
+
+
+EarlyStoppingEnum = Literal["never"]
+
+
+@dataclass
+class AutomaticSpeechRecognitionGenerationParameters(BaseInferenceType):
+    """Parametrization of the text generation process
+    Ad-hoc parametrization of the text generation process
+    """
+
+    do_sample: Optional[bool] = None
+    """Whether to use sampling instead of greedy decoding when generating new tokens."""
+    early_stopping: Optional[Union[bool, "EarlyStoppingEnum"]] = None
+    """Controls the stopping condition for beam-based methods."""
+    epsilon_cutoff: Optional[float] = None
+    """If set to float strictly between 0 and 1, only tokens with a conditional probability
+    greater than epsilon_cutoff will be sampled. In the paper, suggested values range from
+    3e-4 to 9e-4, depending on the size of the model. See [Truncation Sampling as Language
+    Model Desmoothing](https://hf.co/papers/2210.15191) for more details.
+    """
+    eta_cutoff: Optional[float] = None
+    """Eta sampling is a hybrid of locally typical sampling and epsilon sampling. If set to
+    float strictly between 0 and 1, a token is only considered if it is greater than either
+    eta_cutoff or sqrt(eta_cutoff) * exp(-entropy(softmax(next_token_logits))). The latter
+    term is intuitively the expected next token probability, scaled by sqrt(eta_cutoff). In
+    the paper, suggested values range from 3e-4 to 2e-3, depending on the size of the model.
+    See [Truncation Sampling as Language Model Desmoothing](https://hf.co/papers/2210.15191)
+    for more details.
+    """
+    max_length: Optional[int] = None
+    """The maximum length (in tokens) of the generated text, including the input."""
+    max_new_tokens: Optional[int] = None
+    """The maximum number of tokens to generate. Takes precedence over maxLength."""
+    min_length: Optional[int] = None
+    """The minimum length (in tokens) of the generated text, including the input."""
+    min_new_tokens: Optional[int] = None
+    """The minimum number of tokens to generate. Takes precedence over maxLength."""
+    num_beam_groups: Optional[int] = None
+    """Number of groups to divide num_beams into in order to ensure diversity among different
+    groups of beams. See [this paper](https://hf.co/papers/1610.02424) for more details.
+    """
+    num_beams: Optional[int] = None
+    """Number of beams to use for beam search."""
+    penalty_alpha: Optional[float] = None
+    """The value balances the model confidence and the degeneration penalty in contrastive
+    search decoding.
+    """
+    temperature: Optional[float] = None
+    """The value used to modulate the next token probabilities."""
+    top_k: Optional[int] = None
+    """The number of highest probability vocabulary tokens to keep for top-k-filtering."""
+    top_p: Optional[float] = None
+    """If set to float < 1, only the smallest set of most probable tokens with probabilities
+    that add up to top_p or higher are kept for generation.
+    """
+    typical_p: Optional[float] = None
+    """Local typicality measures how similar the conditional probability of predicting a target
+    token next is to the expected conditional probability of predicting a random token next,
+    given the partial text already generated. If set to float < 1, the smallest set of the
+    most locally typical tokens with probabilities that add up to typical_p or higher are
+    kept for generation. See [this paper](https://hf.co/papers/2202.00666) for more details.
+    """
+    use_cache: Optional[bool] = None
+    """Whether the model should use the past last key/values attentions to speed up decoding"""
+
+
+@dataclass
+class AutomaticSpeechRecognitionParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Automatic Speech Recognition
+    """
+
+    generate: Optional[AutomaticSpeechRecognitionGenerationParameters] = None
+    """Parametrization of the text generation process"""
+    return_timestamps: Optional[bool] = None
+    """Whether to output corresponding timestamps with the generated text"""
+
+
+@dataclass
+class AutomaticSpeechRecognitionInput(BaseInferenceType):
+    """Inputs for Automatic Speech Recognition inference"""
+
+    inputs: Any
+    """The input audio data"""
+    parameters: Optional[AutomaticSpeechRecognitionParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class AutomaticSpeechRecognitionOutputChunk(BaseInferenceType):
+    text: str
+    """A chunk of text identified by the model"""
+    timestamps: List[float]
+    """The start and end timestamps corresponding with the text"""
+
+
+@dataclass
+class AutomaticSpeechRecognitionOutput(BaseInferenceType):
+    """Outputs of inference for the Automatic Speech Recognition task"""
+
+    text: str
+    """The recognized text."""
+    chunks: Optional[List[AutomaticSpeechRecognitionOutputChunk]] = None
+    """When returnTimestamps is enabled, chunks contains a list of audio chunks identified by
+    the model.
+    """
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/base.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..8783484d2d466a74c1c634508c39a7e9cb2851a3
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/base.py
@@ -0,0 +1,149 @@
+# Copyright 2024 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains a base class for all inference types."""
+
+import inspect
+import json
+import warnings
+from dataclasses import asdict, dataclass
+from typing import Any, Dict, List, Type, TypeVar, Union, get_args
+
+
+T = TypeVar("T", bound="BaseInferenceType")
+
+
+@dataclass
+class BaseInferenceType(dict):
+    """Base class for all inference types.
+
+    Object is a dataclass and a dict for backward compatibility but plan is to remove the dict part in the future.
+
+    Handle parsing from dict, list and json strings in a permissive way to ensure future-compatibility (e.g. all fields
+    are made optional, and non-expected fields are added as dict attributes).
+    """
+
+    @classmethod
+    def parse_obj_as_list(cls: Type[T], data: Union[bytes, str, List, Dict]) -> List[T]:
+        """Alias to parse server response and return a single instance.
+
+        See `parse_obj` for more details.
+        """
+        output = cls.parse_obj(data)
+        if not isinstance(output, list):
+            raise ValueError(f"Invalid input data for {cls}. Expected a list, but got {type(output)}.")
+        return output
+
+    @classmethod
+    def parse_obj_as_instance(cls: Type[T], data: Union[bytes, str, List, Dict]) -> T:
+        """Alias to parse server response and return a single instance.
+
+        See `parse_obj` for more details.
+        """
+        output = cls.parse_obj(data)
+        if isinstance(output, list):
+            raise ValueError(f"Invalid input data for {cls}. Expected a single instance, but got a list.")
+        return output
+
+    @classmethod
+    def parse_obj(cls: Type[T], data: Union[bytes, str, List, Dict]) -> Union[List[T], T]:
+        """Parse server response as a dataclass or list of dataclasses.
+
+        To enable future-compatibility, we want to handle cases where the server return more fields than expected.
+        In such cases, we don't want to raise an error but still create the dataclass object. Remaining fields are
+        added as dict attributes.
+        """
+        # Parse server response (from bytes)
+        if isinstance(data, bytes):
+            data = data.decode()
+        if isinstance(data, str):
+            data = json.loads(data)
+
+        # If a list, parse each item individually
+        if isinstance(data, List):
+            return [cls.parse_obj(d) for d in data]  # type: ignore [misc]
+
+        # At this point, we expect a dict
+        if not isinstance(data, dict):
+            raise ValueError(f"Invalid data type: {type(data)}")
+
+        init_values = {}
+        other_values = {}
+        for key, value in data.items():
+            key = normalize_key(key)
+            if key in cls.__dataclass_fields__ and cls.__dataclass_fields__[key].init:
+                if isinstance(value, dict) or isinstance(value, list):
+                    field_type = cls.__dataclass_fields__[key].type
+
+                    # if `field_type` is a `BaseInferenceType`, parse it
+                    if inspect.isclass(field_type) and issubclass(field_type, BaseInferenceType):
+                        value = field_type.parse_obj(value)
+
+                    # otherwise, recursively parse nested dataclasses (if possible)
+                    # `get_args` returns handle Union and Optional for us
+                    else:
+                        expected_types = get_args(field_type)
+                        for expected_type in expected_types:
+                            if getattr(expected_type, "_name", None) == "List":
+                                expected_type = get_args(expected_type)[
+                                    0
+                                ]  # assume same type for all items in the list
+                            if inspect.isclass(expected_type) and issubclass(expected_type, BaseInferenceType):
+                                value = expected_type.parse_obj(value)
+                                break
+                init_values[key] = value
+            else:
+                other_values[key] = value
+
+        # Make all missing fields default to None
+        # => ensure that dataclass initialization will never fail even if the server does not return all fields.
+        for key in cls.__dataclass_fields__:
+            if key not in init_values:
+                init_values[key] = None
+
+        # Initialize dataclass with expected values
+        item = cls(**init_values)
+
+        # Add remaining fields as dict attributes
+        item.update(other_values)
+        return item
+
+    def __post_init__(self):
+        self.update(asdict(self))
+
+    def __setitem__(self, __key: Any, __value: Any) -> None:
+        # Hacky way to keep dataclass values in sync when dict is updated
+        super().__setitem__(__key, __value)
+        if __key in self.__dataclass_fields__ and getattr(self, __key, None) != __value:
+            self.__setattr__(__key, __value)
+        return
+
+    def __setattr__(self, __name: str, __value: Any) -> None:
+        # Hacky way to keep dict values is sync when dataclass is updated
+        super().__setattr__(__name, __value)
+        if self.get(__name) != __value:
+            self[__name] = __value
+        return
+
+    def __getitem__(self, __key: Any) -> Any:
+        warnings.warn(
+            f"Accessing '{self.__class__.__name__}' values through dict is deprecated and "
+            "will be removed from version '0.25'. Use dataclass attributes instead.",
+            FutureWarning,
+        )
+        return super().__getitem__(__key)
+
+
+def normalize_key(key: str) -> str:
+    # e.g "content-type" -> "content_type", "Accept" -> "accept"
+    return key.replace("-", "_").replace(" ", "_").lower()
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/chat_completion.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/chat_completion.py
new file mode 100644
index 0000000000000000000000000000000000000000..43e24f814b5ea8c4fea6d0ea00d6fef3883da8d1
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/chat_completion.py
@@ -0,0 +1,106 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import List, Literal, Optional, Union
+
+from .base import BaseInferenceType
+
+
+ChatCompletionMessageRole = Literal["assistant", "system", "user"]
+
+
+@dataclass
+class ChatCompletionInputMessage(BaseInferenceType):
+    content: str
+    """The content of the message."""
+    role: "ChatCompletionMessageRole"
+
+
+@dataclass
+class ChatCompletionInput(BaseInferenceType):
+    """Inputs for ChatCompletion inference"""
+
+    messages: List[ChatCompletionInputMessage]
+    frequency_penalty: Optional[float] = None
+    """Number between -2.0 and 2.0. Positive values penalize new tokens based on their existing
+    frequency in the text so far, decreasing the model's likelihood to repeat the same line
+    verbatim.
+    """
+    max_tokens: Optional[int] = None
+    """The maximum number of tokens that can be generated in the chat completion."""
+    seed: Optional[int] = None
+    """The random sampling seed."""
+    stop: Optional[Union[List[str], str]] = None
+    """Stop generating tokens if a stop token is generated."""
+    stream: Optional[bool] = None
+    """If set, partial message deltas will be sent."""
+    temperature: Optional[float] = None
+    """The value used to modulate the logits distribution."""
+    top_p: Optional[float] = None
+    """If set to < 1, only the smallest set of most probable tokens with probabilities that add
+    up to `top_p` or higher are kept for generation.
+    """
+
+
+ChatCompletionFinishReason = Literal["length", "eos_token", "stop_sequence"]
+
+
+@dataclass
+class ChatCompletionOutputChoiceMessage(BaseInferenceType):
+    content: str
+    """The content of the chat completion message."""
+    role: "ChatCompletionMessageRole"
+
+
+@dataclass
+class ChatCompletionOutputChoice(BaseInferenceType):
+    finish_reason: "ChatCompletionFinishReason"
+    """The reason why the generation was stopped."""
+    index: int
+    """The index of the choice in the list of choices."""
+    message: ChatCompletionOutputChoiceMessage
+
+
+@dataclass
+class ChatCompletionOutput(BaseInferenceType):
+    """Outputs for Chat Completion inference"""
+
+    choices: List[ChatCompletionOutputChoice]
+    """A list of chat completion choices."""
+    created: int
+    """The Unix timestamp (in seconds) of when the chat completion was created."""
+
+
+@dataclass
+class ChatCompletionStreamOutputDelta(BaseInferenceType):
+    """A chat completion delta generated by streamed model responses."""
+
+    content: Optional[str] = None
+    """The contents of the chunk message."""
+    role: Optional[str] = None
+    """The role of the author of this message."""
+
+
+@dataclass
+class ChatCompletionStreamOutputChoice(BaseInferenceType):
+    delta: ChatCompletionStreamOutputDelta
+    """A chat completion delta generated by streamed model responses."""
+    index: int
+    """The index of the choice in the list of choices."""
+    finish_reason: Optional["ChatCompletionFinishReason"] = None
+    """The reason why the generation was stopped."""
+
+
+@dataclass
+class ChatCompletionStreamOutput(BaseInferenceType):
+    """Chat Completion Stream Output"""
+
+    choices: List[ChatCompletionStreamOutputChoice]
+    """A list of chat completion choices."""
+    created: int
+    """The Unix timestamp (in seconds) of when the chat completion was created. Each chunk has
+    the same timestamp.
+    """
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/depth_estimation.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/depth_estimation.py
new file mode 100644
index 0000000000000000000000000000000000000000..fbaa5feeadff9721ba543cb77121b98c17e3ee8c
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/depth_estimation.py
@@ -0,0 +1,29 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Dict, Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class DepthEstimationInput(BaseInferenceType):
+    """Inputs for Depth Estimation inference"""
+
+    inputs: Any
+    """The input image data"""
+    parameters: Optional[Dict[str, Any]] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class DepthEstimationOutput(BaseInferenceType):
+    """Outputs of inference for the Depth Estimation task"""
+
+    depth: Any
+    """The predicted depth as an image"""
+    predicted_depth: Any
+    """The predicted depth as a tensor"""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/document_question_answering.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/document_question_answering.py
new file mode 100644
index 0000000000000000000000000000000000000000..c68be4bde00a98fbce46a2ef6a93bb549d4d920b
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/document_question_answering.py
@@ -0,0 +1,85 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, List, Optional, Union
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class DocumentQuestionAnsweringInputData(BaseInferenceType):
+    """One (document, question) pair to answer"""
+
+    image: Any
+    """The image on which the question is asked"""
+    question: str
+    """A question to ask of the document"""
+
+
+@dataclass
+class DocumentQuestionAnsweringParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Document Question Answering
+    """
+
+    doc_stride: Optional[int] = None
+    """If the words in the document are too long to fit with the question for the model, it will
+    be split in several chunks with some overlap. This argument controls the size of that
+    overlap.
+    """
+    handle_impossible_answer: Optional[bool] = None
+    """Whether to accept impossible as an answer"""
+    lang: Optional[str] = None
+    """Language to use while running OCR. Defaults to english."""
+    max_answer_len: Optional[int] = None
+    """The maximum length of predicted answers (e.g., only answers with a shorter length are
+    considered).
+    """
+    max_question_len: Optional[int] = None
+    """The maximum length of the question after tokenization. It will be truncated if needed."""
+    max_seq_len: Optional[int] = None
+    """The maximum length of the total sentence (context + question) in tokens of each chunk
+    passed to the model. The context will be split in several chunks (using doc_stride as
+    overlap) if needed.
+    """
+    top_k: Optional[int] = None
+    """The number of answers to return (will be chosen by order of likelihood). Can return less
+    than top_k answers if there are not enough options available within the context.
+    """
+    word_boxes: Optional[List[Union[List[float], str]]] = None
+    """A list of words and bounding boxes (normalized 0->1000). If provided, the inference will
+    skip the OCR step and use the provided bounding boxes instead.
+    """
+
+
+@dataclass
+class DocumentQuestionAnsweringInput(BaseInferenceType):
+    """Inputs for Document Question Answering inference"""
+
+    inputs: DocumentQuestionAnsweringInputData
+    """One (document, question) pair to answer"""
+    parameters: Optional[DocumentQuestionAnsweringParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class DocumentQuestionAnsweringOutputElement(BaseInferenceType):
+    """Outputs of inference for the Document Question Answering task"""
+
+    answer: str
+    """The answer to the question."""
+    end: int
+    """The end word index of the answer (in the OCR’d version of the input or provided word
+    boxes).
+    """
+    score: float
+    """The probability associated to the answer."""
+    start: int
+    """The start word index of the answer (in the OCR’d version of the input or provided word
+    boxes).
+    """
+    words: List[int]
+    """The index of each word/box pair that is in the answer"""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/feature_extraction.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/feature_extraction.py
new file mode 100644
index 0000000000000000000000000000000000000000..df563e671a68926df1d96898879ae775f0d20a6c
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/feature_extraction.py
@@ -0,0 +1,19 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Dict, Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class FeatureExtractionInput(BaseInferenceType):
+    """Inputs for Text Embedding inference"""
+
+    inputs: str
+    """The text to get the embeddings of"""
+    parameters: Optional[Dict[str, Any]] = None
+    """Additional inference parameters"""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/fill_mask.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/fill_mask.py
new file mode 100644
index 0000000000000000000000000000000000000000..e1fddf96fbb7c76c8ffee0c170c6554c8b4e2bf8
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/fill_mask.py
@@ -0,0 +1,50 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, List, Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class FillMaskParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Fill Mask
+    """
+
+    targets: Optional[List[str]] = None
+    """When passed, the model will limit the scores to the passed targets instead of looking up
+    in the whole vocabulary. If the provided targets are not in the model vocab, they will be
+    tokenized and the first resulting token will be used (with a warning, and that might be
+    slower).
+    """
+    top_k: Optional[int] = None
+    """When passed, overrides the number of predictions to return."""
+
+
+@dataclass
+class FillMaskInput(BaseInferenceType):
+    """Inputs for Fill Mask inference"""
+
+    inputs: str
+    """The text with masked tokens"""
+    parameters: Optional[FillMaskParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class FillMaskOutputElement(BaseInferenceType):
+    """Outputs of inference for the Fill Mask task"""
+
+    score: float
+    """The corresponding probability"""
+    sequence: str
+    """The corresponding input with the mask token prediction."""
+    token: int
+    """The predicted token id (to replace the masked one)."""
+    token_str: Any
+    fill_mask_output_token_str: Optional[str] = None
+    """The predicted token (to replace the masked one)."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/image_classification.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/image_classification.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd52db005a0be62e7f063c0a16569a1fc2b273da
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/image_classification.py
@@ -0,0 +1,43 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Literal, Optional
+
+from .base import BaseInferenceType
+
+
+ClassificationOutputTransform = Literal["sigmoid", "softmax", "none"]
+
+
+@dataclass
+class ImageClassificationParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Image Classification
+    """
+
+    function_to_apply: Optional["ClassificationOutputTransform"] = None
+    top_k: Optional[int] = None
+    """When specified, limits the output to the top K most probable classes."""
+
+
+@dataclass
+class ImageClassificationInput(BaseInferenceType):
+    """Inputs for Image Classification inference"""
+
+    inputs: Any
+    """The input image data"""
+    parameters: Optional[ImageClassificationParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class ImageClassificationOutputElement(BaseInferenceType):
+    """Outputs of inference for the Image Classification task"""
+
+    label: str
+    """The predicted class label."""
+    score: float
+    """The corresponding probability."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/image_segmentation.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/image_segmentation.py
new file mode 100644
index 0000000000000000000000000000000000000000..67dd7c28b3cddd21d495ada70b7689a098accfd6
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/image_segmentation.py
@@ -0,0 +1,52 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Literal, Optional
+
+from .base import BaseInferenceType
+
+
+ImageSegmentationSubtask = Literal["instance", "panoptic", "semantic"]
+
+
+@dataclass
+class ImageSegmentationParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Image Segmentation
+    """
+
+    mask_threshold: Optional[float] = None
+    """Threshold to use when turning the predicted masks into binary values."""
+    overlap_mask_area_threshold: Optional[float] = None
+    """Mask overlap threshold to eliminate small, disconnected segments."""
+    subtask: Optional["ImageSegmentationSubtask"] = None
+    """Segmentation task to be performed, depending on model capabilities."""
+    threshold: Optional[float] = None
+    """Probability threshold to filter out predicted masks."""
+
+
+@dataclass
+class ImageSegmentationInput(BaseInferenceType):
+    """Inputs for Image Segmentation inference"""
+
+    inputs: Any
+    """The input image data"""
+    parameters: Optional[ImageSegmentationParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class ImageSegmentationOutputElement(BaseInferenceType):
+    """Outputs of inference for the Image Segmentation task
+    A predicted mask / segment
+    """
+
+    label: str
+    """The label of the predicted segment"""
+    mask: Any
+    """The corresponding mask as a black-and-white image"""
+    score: Optional[float] = None
+    """The score or confidence degreee the model has"""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/image_to_image.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/image_to_image.py
new file mode 100644
index 0000000000000000000000000000000000000000..8c208ede6f7f2fb73b5dd059fe71bc8d2c4ca140
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/image_to_image.py
@@ -0,0 +1,55 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, List, Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class ImageToImageTargetSize(BaseInferenceType):
+    """The size in pixel of the output image"""
+
+    height: int
+    width: int
+
+
+@dataclass
+class ImageToImageParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Image To Image
+    """
+
+    guidance_scale: Optional[float] = None
+    """For diffusion models. A higher guidance scale value encourages the model to generate
+    images closely linked to the text prompt at the expense of lower image quality.
+    """
+    negative_prompt: Optional[List[str]] = None
+    """One or several prompt to guide what NOT to include in image generation."""
+    num_inference_steps: Optional[int] = None
+    """For diffusion models. The number of denoising steps. More denoising steps usually lead to
+    a higher quality image at the expense of slower inference.
+    """
+    target_size: Optional[ImageToImageTargetSize] = None
+    """The size in pixel of the output image"""
+
+
+@dataclass
+class ImageToImageInput(BaseInferenceType):
+    """Inputs for Image To Image inference"""
+
+    inputs: Any
+    """The input image data"""
+    parameters: Optional[ImageToImageParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class ImageToImageOutput(BaseInferenceType):
+    """Outputs of inference for the Image To Image task"""
+
+    image: Any
+    """The output image"""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/image_to_text.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/image_to_text.py
new file mode 100644
index 0000000000000000000000000000000000000000..0ebb9a9bc667bdb0d2afd7bb8e482fc18f6634d7
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/image_to_text.py
@@ -0,0 +1,105 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Literal, Optional, Union
+
+from .base import BaseInferenceType
+
+
+EarlyStoppingEnum = Literal["never"]
+
+
+@dataclass
+class ImageToTextGenerationParameters(BaseInferenceType):
+    """Parametrization of the text generation process
+    Ad-hoc parametrization of the text generation process
+    """
+
+    do_sample: Optional[bool] = None
+    """Whether to use sampling instead of greedy decoding when generating new tokens."""
+    early_stopping: Optional[Union[bool, "EarlyStoppingEnum"]] = None
+    """Controls the stopping condition for beam-based methods."""
+    epsilon_cutoff: Optional[float] = None
+    """If set to float strictly between 0 and 1, only tokens with a conditional probability
+    greater than epsilon_cutoff will be sampled. In the paper, suggested values range from
+    3e-4 to 9e-4, depending on the size of the model. See [Truncation Sampling as Language
+    Model Desmoothing](https://hf.co/papers/2210.15191) for more details.
+    """
+    eta_cutoff: Optional[float] = None
+    """Eta sampling is a hybrid of locally typical sampling and epsilon sampling. If set to
+    float strictly between 0 and 1, a token is only considered if it is greater than either
+    eta_cutoff or sqrt(eta_cutoff) * exp(-entropy(softmax(next_token_logits))). The latter
+    term is intuitively the expected next token probability, scaled by sqrt(eta_cutoff). In
+    the paper, suggested values range from 3e-4 to 2e-3, depending on the size of the model.
+    See [Truncation Sampling as Language Model Desmoothing](https://hf.co/papers/2210.15191)
+    for more details.
+    """
+    max_length: Optional[int] = None
+    """The maximum length (in tokens) of the generated text, including the input."""
+    max_new_tokens: Optional[int] = None
+    """The maximum number of tokens to generate. Takes precedence over maxLength."""
+    min_length: Optional[int] = None
+    """The minimum length (in tokens) of the generated text, including the input."""
+    min_new_tokens: Optional[int] = None
+    """The minimum number of tokens to generate. Takes precedence over maxLength."""
+    num_beam_groups: Optional[int] = None
+    """Number of groups to divide num_beams into in order to ensure diversity among different
+    groups of beams. See [this paper](https://hf.co/papers/1610.02424) for more details.
+    """
+    num_beams: Optional[int] = None
+    """Number of beams to use for beam search."""
+    penalty_alpha: Optional[float] = None
+    """The value balances the model confidence and the degeneration penalty in contrastive
+    search decoding.
+    """
+    temperature: Optional[float] = None
+    """The value used to modulate the next token probabilities."""
+    top_k: Optional[int] = None
+    """The number of highest probability vocabulary tokens to keep for top-k-filtering."""
+    top_p: Optional[float] = None
+    """If set to float < 1, only the smallest set of most probable tokens with probabilities
+    that add up to top_p or higher are kept for generation.
+    """
+    typical_p: Optional[float] = None
+    """Local typicality measures how similar the conditional probability of predicting a target
+    token next is to the expected conditional probability of predicting a random token next,
+    given the partial text already generated. If set to float < 1, the smallest set of the
+    most locally typical tokens with probabilities that add up to typical_p or higher are
+    kept for generation. See [this paper](https://hf.co/papers/2202.00666) for more details.
+    """
+    use_cache: Optional[bool] = None
+    """Whether the model should use the past last key/values attentions to speed up decoding"""
+
+
+@dataclass
+class ImageToTextParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Image To Text
+    """
+
+    generate: Optional[ImageToTextGenerationParameters] = None
+    """Parametrization of the text generation process"""
+    max_new_tokens: Optional[int] = None
+    """The amount of maximum tokens to generate."""
+
+
+@dataclass
+class ImageToTextInput(BaseInferenceType):
+    """Inputs for Image To Text inference"""
+
+    inputs: Any
+    """The input image data"""
+    parameters: Optional[ImageToTextParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class ImageToTextOutput(BaseInferenceType):
+    """Outputs of inference for the Image To Text task"""
+
+    generated_text: Any
+    image_to_text_output_generated_text: Optional[str] = None
+    """The generated text."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/object_detection.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/object_detection.py
new file mode 100644
index 0000000000000000000000000000000000000000..42b03a841b793fd4cb301bf51695bd35054a6af2
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/object_detection.py
@@ -0,0 +1,55 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class ObjectDetectionParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Object Detection
+    """
+
+    threshold: Optional[float] = None
+    """The probability necessary to make a prediction."""
+
+
+@dataclass
+class ObjectDetectionInput(BaseInferenceType):
+    """Inputs for Object Detection inference"""
+
+    inputs: Any
+    """The input image data"""
+    parameters: Optional[ObjectDetectionParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class ObjectDetectionBoundingBox(BaseInferenceType):
+    """The predicted bounding box. Coordinates are relative to the top left corner of the input
+    image.
+    """
+
+    xmax: int
+    xmin: int
+    ymax: int
+    ymin: int
+
+
+@dataclass
+class ObjectDetectionOutputElement(BaseInferenceType):
+    """Outputs of inference for the Object Detection task"""
+
+    box: ObjectDetectionBoundingBox
+    """The predicted bounding box. Coordinates are relative to the top left corner of the input
+    image.
+    """
+    label: str
+    """The predicted label for the bounding box"""
+    score: float
+    """The associated score / probability"""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/question_answering.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/question_answering.py
new file mode 100644
index 0000000000000000000000000000000000000000..3810fc594af5cf0712cb0cb0db077383220b175a
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/question_answering.py
@@ -0,0 +1,77 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class QuestionAnsweringInputData(BaseInferenceType):
+    """One (context, question) pair to answer"""
+
+    context: str
+    """The context to be used for answering the question"""
+    question: str
+    """The question to be answered"""
+
+
+@dataclass
+class QuestionAnsweringParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Question Answering
+    """
+
+    align_to_words: Optional[bool] = None
+    """Attempts to align the answer to real words. Improves quality on space separated
+    languages. Might hurt on non-space-separated languages (like Japanese or Chinese)
+    """
+    doc_stride: Optional[int] = None
+    """If the context is too long to fit with the question for the model, it will be split in
+    several chunks with some overlap. This argument controls the size of that overlap.
+    """
+    handle_impossible_answer: Optional[bool] = None
+    """Whether to accept impossible as an answer."""
+    max_answer_len: Optional[int] = None
+    """The maximum length of predicted answers (e.g., only answers with a shorter length are
+    considered).
+    """
+    max_question_len: Optional[int] = None
+    """The maximum length of the question after tokenization. It will be truncated if needed."""
+    max_seq_len: Optional[int] = None
+    """The maximum length of the total sentence (context + question) in tokens of each chunk
+    passed to the model. The context will be split in several chunks (using docStride as
+    overlap) if needed.
+    """
+    top_k: Optional[int] = None
+    """The number of answers to return (will be chosen by order of likelihood). Note that we
+    return less than topk answers if there are not enough options available within the
+    context.
+    """
+
+
+@dataclass
+class QuestionAnsweringInput(BaseInferenceType):
+    """Inputs for Question Answering inference"""
+
+    inputs: QuestionAnsweringInputData
+    """One (context, question) pair to answer"""
+    parameters: Optional[QuestionAnsweringParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class QuestionAnsweringOutputElement(BaseInferenceType):
+    """Outputs of inference for the Question Answering task"""
+
+    answer: str
+    """The answer to the question."""
+    end: int
+    """The character position in the input where the answer ends."""
+    score: float
+    """The probability associated to the answer."""
+    start: int
+    """The character position in the input where the answer begins."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/sentence_similarity.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/sentence_similarity.py
new file mode 100644
index 0000000000000000000000000000000000000000..944bfccbf76e8c322dbf95a286746c6e1e25a55b
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/sentence_similarity.py
@@ -0,0 +1,28 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Dict, List, Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class SentenceSimilarityInputData(BaseInferenceType):
+    sentences: List[str]
+    """A list of strings which will be compared against the source_sentence."""
+    source_sentence: str
+    """The string that you wish to compare the other strings with. This can be a phrase,
+    sentence, or longer passage, depending on the model being used.
+    """
+
+
+@dataclass
+class SentenceSimilarityInput(BaseInferenceType):
+    """Inputs for Sentence similarity inference"""
+
+    inputs: SentenceSimilarityInputData
+    parameters: Optional[Dict[str, Any]] = None
+    """Additional inference parameters"""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/summarization.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/summarization.py
new file mode 100644
index 0000000000000000000000000000000000000000..a6a00e53264bd9a53a24d2ee7b12f428c068a117
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/summarization.py
@@ -0,0 +1,46 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Dict, Literal, Optional
+
+from .base import BaseInferenceType
+
+
+SummarizationGenerationTruncationStrategy = Literal["do_not_truncate", "longest_first", "only_first", "only_second"]
+
+
+@dataclass
+class SummarizationGenerationParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Text2text Generation
+    """
+
+    clean_up_tokenization_spaces: Optional[bool] = None
+    """Whether to clean up the potential extra spaces in the text output."""
+    generate_parameters: Optional[Dict[str, Any]] = None
+    """Additional parametrization of the text generation algorithm"""
+    truncation: Optional["SummarizationGenerationTruncationStrategy"] = None
+    """The truncation strategy to use"""
+
+
+@dataclass
+class SummarizationInput(BaseInferenceType):
+    """Inputs for Summarization inference
+    Inputs for Text2text Generation inference
+    """
+
+    inputs: str
+    """The input text data"""
+    parameters: Optional[SummarizationGenerationParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class SummarizationOutput(BaseInferenceType):
+    """Outputs of inference for the Summarization task"""
+
+    summary_text: str
+    """The summarized text."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/table_question_answering.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/table_question_answering.py
new file mode 100644
index 0000000000000000000000000000000000000000..6cb9fff641fd4ed2d8e797e59ae7b5f21f94c838
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/table_question_answering.py
@@ -0,0 +1,45 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Dict, List, Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class TableQuestionAnsweringInputData(BaseInferenceType):
+    """One (table, question) pair to answer"""
+
+    question: str
+    """The question to be answered about the table"""
+    table: Dict[str, List[str]]
+    """The table to serve as context for the questions"""
+
+
+@dataclass
+class TableQuestionAnsweringInput(BaseInferenceType):
+    """Inputs for Table Question Answering inference"""
+
+    inputs: TableQuestionAnsweringInputData
+    """One (table, question) pair to answer"""
+    parameters: Optional[Dict[str, Any]] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class TableQuestionAnsweringOutputElement(BaseInferenceType):
+    """Outputs of inference for the Table Question Answering task"""
+
+    answer: str
+    """The answer of the question given the table. If there is an aggregator, the answer will be
+    preceded by `AGGREGATOR >`.
+    """
+    cells: List[str]
+    """List of strings made up of the answer cell values."""
+    coordinates: List[List[int]]
+    """Coordinates of the cells of the answers."""
+    aggregator: Optional[str] = None
+    """If the model has an aggregator, this returns the aggregator."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text2text_generation.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text2text_generation.py
new file mode 100644
index 0000000000000000000000000000000000000000..955494c5ef6b86e12b3927dfd90e44a5db25c2e6
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text2text_generation.py
@@ -0,0 +1,45 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Dict, Literal, Optional
+
+from .base import BaseInferenceType
+
+
+Text2TextGenerationTruncationStrategy = Literal["do_not_truncate", "longest_first", "only_first", "only_second"]
+
+
+@dataclass
+class Text2TextGenerationParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Text2text Generation
+    """
+
+    clean_up_tokenization_spaces: Optional[bool] = None
+    """Whether to clean up the potential extra spaces in the text output."""
+    generate_parameters: Optional[Dict[str, Any]] = None
+    """Additional parametrization of the text generation algorithm"""
+    truncation: Optional["Text2TextGenerationTruncationStrategy"] = None
+    """The truncation strategy to use"""
+
+
+@dataclass
+class Text2TextGenerationInput(BaseInferenceType):
+    """Inputs for Text2text Generation inference"""
+
+    inputs: str
+    """The input text data"""
+    parameters: Optional[Text2TextGenerationParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class Text2TextGenerationOutput(BaseInferenceType):
+    """Outputs of inference for the Text2text Generation task"""
+
+    generated_text: Any
+    text2_text_generation_output_generated_text: Optional[str] = None
+    """The generated text."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text_classification.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text_classification.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf61a4eebcf367b4ab15e8970bfac8e1d8f8458d
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text_classification.py
@@ -0,0 +1,43 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Literal, Optional
+
+from .base import BaseInferenceType
+
+
+ClassificationOutputTransform = Literal["sigmoid", "softmax", "none"]
+
+
+@dataclass
+class TextClassificationParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Text Classification
+    """
+
+    function_to_apply: Optional["ClassificationOutputTransform"] = None
+    top_k: Optional[int] = None
+    """When specified, limits the output to the top K most probable classes."""
+
+
+@dataclass
+class TextClassificationInput(BaseInferenceType):
+    """Inputs for Text Classification inference"""
+
+    inputs: str
+    """The text to classify"""
+    parameters: Optional[TextClassificationParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class TextClassificationOutputElement(BaseInferenceType):
+    """Outputs of inference for the Text Classification task"""
+
+    label: str
+    """The predicted class label."""
+    score: float
+    """The corresponding probability."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text_generation.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text_generation.py
new file mode 100644
index 0000000000000000000000000000000000000000..2866985071741b26d69c1afc8902738cff10ef03
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text_generation.py
@@ -0,0 +1,161 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import List, Literal, Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class TextGenerationParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Text Generation
+    """
+
+    best_of: Optional[int] = None
+    """The number of sampling queries to run. Only the best one (in terms of total logprob) will
+    be returned.
+    """
+    decoder_input_details: Optional[bool] = None
+    """Whether or not to output decoder input details"""
+    details: Optional[bool] = None
+    """Whether or not to output details"""
+    do_sample: Optional[bool] = None
+    """Whether to use logits sampling instead of greedy decoding when generating new tokens."""
+    max_new_tokens: Optional[int] = None
+    """The maximum number of tokens to generate."""
+    repetition_penalty: Optional[float] = None
+    """The parameter for repetition penalty. A value of 1.0 means no penalty. See [this
+    paper](https://hf.co/papers/1909.05858) for more details.
+    """
+    return_full_text: Optional[bool] = None
+    """Whether to prepend the prompt to the generated text."""
+    seed: Optional[int] = None
+    """The random sampling seed."""
+    stop_sequences: Optional[List[str]] = None
+    """Stop generating tokens if a member of `stop_sequences` is generated."""
+    temperature: Optional[float] = None
+    """The value used to modulate the logits distribution."""
+    top_k: Optional[int] = None
+    """The number of highest probability vocabulary tokens to keep for top-k-filtering."""
+    top_p: Optional[float] = None
+    """If set to < 1, only the smallest set of most probable tokens with probabilities that add
+    up to `top_p` or higher are kept for generation.
+    """
+    truncate: Optional[int] = None
+    """Truncate input tokens to the given size."""
+    typical_p: Optional[float] = None
+    """Typical Decoding mass. See [Typical Decoding for Natural Language
+    Generation](https://hf.co/papers/2202.00666) for more information
+    """
+    watermark: Optional[bool] = None
+    """Watermarking with [A Watermark for Large Language Models](https://hf.co/papers/2301.10226)"""
+
+
+@dataclass
+class TextGenerationInput(BaseInferenceType):
+    """Inputs for Text Generation inference"""
+
+    inputs: str
+    """The text to initialize generation with"""
+    parameters: Optional[TextGenerationParameters] = None
+    """Additional inference parameters"""
+    stream: Optional[bool] = None
+    """Whether to stream output tokens"""
+
+
+TextGenerationFinishReason = Literal["length", "eos_token", "stop_sequence"]
+
+
+@dataclass
+class TextGenerationPrefillToken(BaseInferenceType):
+    id: int
+    logprob: float
+    text: str
+    """The text associated with that token"""
+
+
+@dataclass
+class TextGenerationOutputToken(BaseInferenceType):
+    """Generated token."""
+
+    id: int
+    special: bool
+    """Whether or not that token is a special one"""
+    text: str
+    """The text associated with that token"""
+    logprob: Optional[float] = None
+
+
+@dataclass
+class TextGenerationOutputSequenceDetails(BaseInferenceType):
+    finish_reason: "TextGenerationFinishReason"
+    generated_text: str
+    """The generated text"""
+    generated_tokens: int
+    """The number of generated tokens"""
+    prefill: List[TextGenerationPrefillToken]
+    tokens: List[TextGenerationOutputToken]
+    """The generated tokens and associated details"""
+    seed: Optional[int] = None
+    """The random seed used for generation"""
+    top_tokens: Optional[List[List[TextGenerationOutputToken]]] = None
+    """Most likely tokens"""
+
+
+@dataclass
+class TextGenerationOutputDetails(BaseInferenceType):
+    """When enabled, details about the generation"""
+
+    finish_reason: "TextGenerationFinishReason"
+    """The reason why the generation was stopped."""
+    generated_tokens: int
+    """The number of generated tokens"""
+    prefill: List[TextGenerationPrefillToken]
+    tokens: List[TextGenerationOutputToken]
+    """The generated tokens and associated details"""
+    best_of_sequences: Optional[List[TextGenerationOutputSequenceDetails]] = None
+    """Details about additional sequences when best_of is provided"""
+    seed: Optional[int] = None
+    """The random seed used for generation"""
+    top_tokens: Optional[List[List[TextGenerationOutputToken]]] = None
+    """Most likely tokens"""
+
+
+@dataclass
+class TextGenerationOutput(BaseInferenceType):
+    """Outputs for Text Generation inference"""
+
+    generated_text: str
+    """The generated text"""
+    details: Optional[TextGenerationOutputDetails] = None
+    """When enabled, details about the generation"""
+
+
+@dataclass
+class TextGenerationStreamDetails(BaseInferenceType):
+    """Generation details. Only available when the generation is finished."""
+
+    finish_reason: "TextGenerationFinishReason"
+    """The reason why the generation was stopped."""
+    generated_tokens: int
+    """The number of generated tokens"""
+    seed: int
+    """The random seed used for generation"""
+
+
+@dataclass
+class TextGenerationStreamOutput(BaseInferenceType):
+    """Text Generation Stream Output"""
+
+    token: TextGenerationOutputToken
+    """Generated token."""
+    details: Optional[TextGenerationStreamDetails] = None
+    """Generation details. Only available when the generation is finished."""
+    generated_text: Optional[str] = None
+    """The complete generated text. Only available when the generation is finished."""
+    index: Optional[int] = None
+    """The token index within the stream. Optional to support older clients that omit it."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text_to_audio.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text_to_audio.py
new file mode 100644
index 0000000000000000000000000000000000000000..dd8369de4b26cf8ef38cf8cfbafdc1a8bb12d552
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text_to_audio.py
@@ -0,0 +1,105 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Literal, Optional, Union
+
+from .base import BaseInferenceType
+
+
+EarlyStoppingEnum = Literal["never"]
+
+
+@dataclass
+class TextToAudioGenerationParameters(BaseInferenceType):
+    """Parametrization of the text generation process
+    Ad-hoc parametrization of the text generation process
+    """
+
+    do_sample: Optional[bool] = None
+    """Whether to use sampling instead of greedy decoding when generating new tokens."""
+    early_stopping: Optional[Union[bool, "EarlyStoppingEnum"]] = None
+    """Controls the stopping condition for beam-based methods."""
+    epsilon_cutoff: Optional[float] = None
+    """If set to float strictly between 0 and 1, only tokens with a conditional probability
+    greater than epsilon_cutoff will be sampled. In the paper, suggested values range from
+    3e-4 to 9e-4, depending on the size of the model. See [Truncation Sampling as Language
+    Model Desmoothing](https://hf.co/papers/2210.15191) for more details.
+    """
+    eta_cutoff: Optional[float] = None
+    """Eta sampling is a hybrid of locally typical sampling and epsilon sampling. If set to
+    float strictly between 0 and 1, a token is only considered if it is greater than either
+    eta_cutoff or sqrt(eta_cutoff) * exp(-entropy(softmax(next_token_logits))). The latter
+    term is intuitively the expected next token probability, scaled by sqrt(eta_cutoff). In
+    the paper, suggested values range from 3e-4 to 2e-3, depending on the size of the model.
+    See [Truncation Sampling as Language Model Desmoothing](https://hf.co/papers/2210.15191)
+    for more details.
+    """
+    max_length: Optional[int] = None
+    """The maximum length (in tokens) of the generated text, including the input."""
+    max_new_tokens: Optional[int] = None
+    """The maximum number of tokens to generate. Takes precedence over maxLength."""
+    min_length: Optional[int] = None
+    """The minimum length (in tokens) of the generated text, including the input."""
+    min_new_tokens: Optional[int] = None
+    """The minimum number of tokens to generate. Takes precedence over maxLength."""
+    num_beam_groups: Optional[int] = None
+    """Number of groups to divide num_beams into in order to ensure diversity among different
+    groups of beams. See [this paper](https://hf.co/papers/1610.02424) for more details.
+    """
+    num_beams: Optional[int] = None
+    """Number of beams to use for beam search."""
+    penalty_alpha: Optional[float] = None
+    """The value balances the model confidence and the degeneration penalty in contrastive
+    search decoding.
+    """
+    temperature: Optional[float] = None
+    """The value used to modulate the next token probabilities."""
+    top_k: Optional[int] = None
+    """The number of highest probability vocabulary tokens to keep for top-k-filtering."""
+    top_p: Optional[float] = None
+    """If set to float < 1, only the smallest set of most probable tokens with probabilities
+    that add up to top_p or higher are kept for generation.
+    """
+    typical_p: Optional[float] = None
+    """Local typicality measures how similar the conditional probability of predicting a target
+    token next is to the expected conditional probability of predicting a random token next,
+    given the partial text already generated. If set to float < 1, the smallest set of the
+    most locally typical tokens with probabilities that add up to typical_p or higher are
+    kept for generation. See [this paper](https://hf.co/papers/2202.00666) for more details.
+    """
+    use_cache: Optional[bool] = None
+    """Whether the model should use the past last key/values attentions to speed up decoding"""
+
+
+@dataclass
+class TextToAudioParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Text To Audio
+    """
+
+    generate: Optional[TextToAudioGenerationParameters] = None
+    """Parametrization of the text generation process"""
+
+
+@dataclass
+class TextToAudioInput(BaseInferenceType):
+    """Inputs for Text To Audio inference"""
+
+    inputs: str
+    """The input text data"""
+    parameters: Optional[TextToAudioParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class TextToAudioOutput(BaseInferenceType):
+    """Outputs of inference for the Text To Audio task"""
+
+    audio: Any
+    """The generated audio waveform."""
+    sampling_rate: Any
+    text_to_audio_output_sampling_rate: Optional[float] = None
+    """The sampling rate of the generated audio waveform."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text_to_image.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text_to_image.py
new file mode 100644
index 0000000000000000000000000000000000000000..40e53ab016d3a6f2098d26eadab9cf51805c31b1
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/text_to_image.py
@@ -0,0 +1,57 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, List, Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class TextToImageTargetSize(BaseInferenceType):
+    """The size in pixel of the output image"""
+
+    height: int
+    width: int
+
+
+@dataclass
+class TextToImageParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Text To Image
+    """
+
+    guidance_scale: Optional[float] = None
+    """For diffusion models. A higher guidance scale value encourages the model to generate
+    images closely linked to the text prompt at the expense of lower image quality.
+    """
+    negative_prompt: Optional[List[str]] = None
+    """One or several prompt to guide what NOT to include in image generation."""
+    num_inference_steps: Optional[int] = None
+    """For diffusion models. The number of denoising steps. More denoising steps usually lead to
+    a higher quality image at the expense of slower inference.
+    """
+    scheduler: Optional[str] = None
+    """For diffusion models. Override the scheduler with a compatible one"""
+    target_size: Optional[TextToImageTargetSize] = None
+    """The size in pixel of the output image"""
+
+
+@dataclass
+class TextToImageInput(BaseInferenceType):
+    """Inputs for Text To Image inference"""
+
+    inputs: str
+    """The input text data (sometimes called "prompt\""""
+    parameters: Optional[TextToImageParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class TextToImageOutput(BaseInferenceType):
+    """Outputs of inference for the Text To Image task"""
+
+    image: Any
+    """The generated image"""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/token_classification.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/token_classification.py
new file mode 100644
index 0000000000000000000000000000000000000000..2d60ea27eedbfe28096435c84e4002c0d9a64bc6
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/token_classification.py
@@ -0,0 +1,53 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, List, Literal, Optional
+
+from .base import BaseInferenceType
+
+
+TokenClassificationAggregationStrategy = Literal["none", "simple", "first", "average", "max"]
+
+
+@dataclass
+class TokenClassificationParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Token Classification
+    """
+
+    aggregation_strategy: Optional["TokenClassificationAggregationStrategy"] = None
+    """The strategy used to fuse tokens based on model predictions"""
+    ignore_labels: Optional[List[str]] = None
+    """A list of labels to ignore"""
+    stride: Optional[int] = None
+    """The number of overlapping tokens between chunks when splitting the input text."""
+
+
+@dataclass
+class TokenClassificationInput(BaseInferenceType):
+    """Inputs for Token Classification inference"""
+
+    inputs: str
+    """The input text data"""
+    parameters: Optional[TokenClassificationParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class TokenClassificationOutputElement(BaseInferenceType):
+    """Outputs of inference for the Token Classification task"""
+
+    label: Any
+    score: float
+    """The associated score / probability"""
+    end: Optional[int] = None
+    """The character position in the input where this group ends."""
+    entity_group: Optional[str] = None
+    """The predicted label for that group of tokens"""
+    start: Optional[int] = None
+    """The character position in the input where this group begins."""
+    word: Optional[str] = None
+    """The corresponding text"""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/translation.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/translation.py
new file mode 100644
index 0000000000000000000000000000000000000000..e06ad2b72d35dcf814b110112cd882cb4b4cc616
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/translation.py
@@ -0,0 +1,46 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Dict, Literal, Optional
+
+from .base import BaseInferenceType
+
+
+TranslationGenerationTruncationStrategy = Literal["do_not_truncate", "longest_first", "only_first", "only_second"]
+
+
+@dataclass
+class TranslationGenerationParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Text2text Generation
+    """
+
+    clean_up_tokenization_spaces: Optional[bool] = None
+    """Whether to clean up the potential extra spaces in the text output."""
+    generate_parameters: Optional[Dict[str, Any]] = None
+    """Additional parametrization of the text generation algorithm"""
+    truncation: Optional["TranslationGenerationTruncationStrategy"] = None
+    """The truncation strategy to use"""
+
+
+@dataclass
+class TranslationInput(BaseInferenceType):
+    """Inputs for Translation inference
+    Inputs for Text2text Generation inference
+    """
+
+    inputs: str
+    """The input text data"""
+    parameters: Optional[TranslationGenerationParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class TranslationOutput(BaseInferenceType):
+    """Outputs of inference for the Translation task"""
+
+    translation_text: str
+    """The translated text."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/video_classification.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/video_classification.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c5a9d55a81fab6fc71e1226e7776a7a68ee688f
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/video_classification.py
@@ -0,0 +1,47 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Literal, Optional
+
+from .base import BaseInferenceType
+
+
+ClassificationOutputTransform = Literal["sigmoid", "softmax", "none"]
+
+
+@dataclass
+class VideoClassificationParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Video Classification
+    """
+
+    frame_sampling_rate: Optional[int] = None
+    """The sampling rate used to select frames from the video."""
+    function_to_apply: Optional["ClassificationOutputTransform"] = None
+    num_frames: Optional[int] = None
+    """The number of sampled frames to consider for classification."""
+    top_k: Optional[int] = None
+    """When specified, limits the output to the top K most probable classes."""
+
+
+@dataclass
+class VideoClassificationInput(BaseInferenceType):
+    """Inputs for Video Classification inference"""
+
+    inputs: Any
+    """The input video data"""
+    parameters: Optional[VideoClassificationParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class VideoClassificationOutputElement(BaseInferenceType):
+    """Outputs of inference for the Video Classification task"""
+
+    label: str
+    """The predicted class label."""
+    score: float
+    """The corresponding probability."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/visual_question_answering.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/visual_question_answering.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ab7c14d8ab032c2e9bf24c835520182cb1b5e5f
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/visual_question_answering.py
@@ -0,0 +1,53 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class VisualQuestionAnsweringInputData(BaseInferenceType):
+    """One (image, question) pair to answer"""
+
+    image: Any
+    """The image."""
+    question: Any
+    """The question to answer based on the image."""
+
+
+@dataclass
+class VisualQuestionAnsweringParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Visual Question Answering
+    """
+
+    top_k: Optional[int] = None
+    """The number of answers to return (will be chosen by order of likelihood). Note that we
+    return less than topk answers if there are not enough options available within the
+    context.
+    """
+
+
+@dataclass
+class VisualQuestionAnsweringInput(BaseInferenceType):
+    """Inputs for Visual Question Answering inference"""
+
+    inputs: VisualQuestionAnsweringInputData
+    """One (image, question) pair to answer"""
+    parameters: Optional[VisualQuestionAnsweringParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class VisualQuestionAnsweringOutputElement(BaseInferenceType):
+    """Outputs of inference for the Visual Question Answering task"""
+
+    label: Any
+    score: float
+    """The associated score / probability"""
+    answer: Optional[str] = None
+    """The answer to the question"""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/zero_shot_classification.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/zero_shot_classification.py
new file mode 100644
index 0000000000000000000000000000000000000000..6c55ebf218ca3314993aacd7eaa8c1910b5ab63e
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/zero_shot_classification.py
@@ -0,0 +1,56 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import List, Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class ZeroShotClassificationInputData(BaseInferenceType):
+    """The input text data, with candidate labels"""
+
+    candidate_labels: List[str]
+    """The set of possible class labels to classify the text into."""
+    text: str
+    """The text to classify"""
+
+
+@dataclass
+class ZeroShotClassificationParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Zero Shot Classification
+    """
+
+    hypothesis_template: Optional[str] = None
+    """The sentence used in conjunction with candidateLabels to attempt the text classification
+    by replacing the placeholder with the candidate labels.
+    """
+    multi_label: Optional[bool] = None
+    """Whether multiple candidate labels can be true. If false, the scores are normalized such
+    that the sum of the label likelihoods for each sequence is 1. If true, the labels are
+    considered independent and probabilities are normalized for each candidate.
+    """
+
+
+@dataclass
+class ZeroShotClassificationInput(BaseInferenceType):
+    """Inputs for Zero Shot Classification inference"""
+
+    inputs: ZeroShotClassificationInputData
+    """The input text data, with candidate labels"""
+    parameters: Optional[ZeroShotClassificationParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class ZeroShotClassificationOutputElement(BaseInferenceType):
+    """Outputs of inference for the Zero Shot Classification task"""
+
+    label: str
+    """The predicted class label."""
+    score: float
+    """The corresponding probability."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/zero_shot_image_classification.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/zero_shot_image_classification.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d635187d7ed2f92eb239dc1e4ee4754394dad4c
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/zero_shot_image_classification.py
@@ -0,0 +1,51 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, List, Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class ZeroShotImageClassificationInputData(BaseInferenceType):
+    """The input image data, with candidate labels"""
+
+    candidate_labels: List[str]
+    """The candidate labels for this image"""
+    image: Any
+    """The image data to classify"""
+
+
+@dataclass
+class ZeroShotImageClassificationParameters(BaseInferenceType):
+    """Additional inference parameters
+    Additional inference parameters for Zero Shot Image Classification
+    """
+
+    hypothesis_template: Optional[str] = None
+    """The sentence used in conjunction with candidateLabels to attempt the text classification
+    by replacing the placeholder with the candidate labels.
+    """
+
+
+@dataclass
+class ZeroShotImageClassificationInput(BaseInferenceType):
+    """Inputs for Zero Shot Image Classification inference"""
+
+    inputs: ZeroShotImageClassificationInputData
+    """The input image data, with candidate labels"""
+    parameters: Optional[ZeroShotImageClassificationParameters] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class ZeroShotImageClassificationOutputElement(BaseInferenceType):
+    """Outputs of inference for the Zero Shot Image Classification task"""
+
+    label: str
+    """The predicted class label."""
+    score: float
+    """The corresponding probability."""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/zero_shot_object_detection.py b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/zero_shot_object_detection.py
new file mode 100644
index 0000000000000000000000000000000000000000..42a21568c9c652eb307cf2bd44ee9aa06ab4df7b
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_generated/types/zero_shot_object_detection.py
@@ -0,0 +1,55 @@
+# Inference code generated from the JSON schema spec in @huggingface/tasks.
+#
+# See:
+#   - script: https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/scripts/inference-codegen.ts
+#   - specs:  https://github.com/huggingface/huggingface.js/tree/main/packages/tasks/src/tasks.
+from dataclasses import dataclass
+from typing import Any, Dict, List, Optional
+
+from .base import BaseInferenceType
+
+
+@dataclass
+class ZeroShotObjectDetectionInputData(BaseInferenceType):
+    """The input image data, with candidate labels"""
+
+    candidate_labels: List[str]
+    """The candidate labels for this image"""
+    image: Any
+    """The image data to generate bounding boxes from"""
+
+
+@dataclass
+class ZeroShotObjectDetectionInput(BaseInferenceType):
+    """Inputs for Zero Shot Object Detection inference"""
+
+    inputs: ZeroShotObjectDetectionInputData
+    """The input image data, with candidate labels"""
+    parameters: Optional[Dict[str, Any]] = None
+    """Additional inference parameters"""
+
+
+@dataclass
+class ZeroShotObjectDetectionBoundingBox(BaseInferenceType):
+    """The predicted bounding box. Coordinates are relative to the top left corner of the input
+    image.
+    """
+
+    xmax: int
+    xmin: int
+    ymax: int
+    ymin: int
+
+
+@dataclass
+class ZeroShotObjectDetectionOutputElement(BaseInferenceType):
+    """Outputs of inference for the Zero Shot Object Detection task"""
+
+    box: ZeroShotObjectDetectionBoundingBox
+    """The predicted bounding box. Coordinates are relative to the top left corner of the input
+    image.
+    """
+    label: str
+    """A candidate label"""
+    score: float
+    """The associated score / probability"""
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_templating.py b/llm/Lib/site-packages/huggingface_hub/inference/_templating.py
new file mode 100644
index 0000000000000000000000000000000000000000..10c349c24d676c75989b08bcf28181a497056a2e
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_templating.py
@@ -0,0 +1,105 @@
+from functools import lru_cache
+from typing import Callable, Dict, List, Optional, Union
+
+from ..utils import HfHubHTTPError, RepositoryNotFoundError, is_minijinja_available
+
+
+class TemplateError(Exception):
+    """Any error raised while trying to fetch or render a chat template."""
+
+
+def _import_minijinja():
+    if not is_minijinja_available():
+        raise ImportError("Cannot render template. Please install minijinja using `pip install minijinja`.")
+    import minijinja  # noqa: F401
+
+    return minijinja
+
+
+def render_chat_prompt(
+    *,
+    model_id: str,
+    messages: List[Dict[str, str]],
+    token: Union[str, bool, None] = None,
+    add_generation_prompt: bool = True,
+    **kwargs,
+) -> str:
+    """Render a chat prompt using a model's chat template.
+
+    Args:
+        model_id (`str`):
+            The model id.
+        messages (`List[Dict[str, str]]`):
+            The list of messages to render.
+        token (`str` or `bool`, *optional*):
+            Hugging Face token. Will default to the locally saved token if not provided.
+
+    Returns:
+        `str`: The rendered chat prompt.
+
+    Raises:
+        `TemplateError`: If there's any issue while fetching, compiling or rendering the chat template.
+    """
+    minijinja = _import_minijinja()
+    template = _fetch_and_compile_template(model_id=model_id, token=token)
+
+    try:
+        return template(messages=messages, add_generation_prompt=add_generation_prompt, **kwargs)
+    except minijinja.TemplateError as e:
+        raise TemplateError(f"Error while trying to render chat prompt for model '{model_id}': {e}") from e
+
+
+@lru_cache  # TODO: lru_cache for raised exceptions
+def _fetch_and_compile_template(*, model_id: str, token: Union[str, None]) -> Callable:
+    """Fetch and compile a model's chat template.
+
+    Method is cached to avoid fetching the same model's config multiple times.
+
+    Args:
+        model_id (`str`):
+            The model id.
+        token (`str` or `bool`, *optional*):
+            Hugging Face token. Will default to the locally saved token if not provided.
+
+    Returns:
+        `Callable`: A callable that takes a list of messages and returns the rendered chat prompt.
+    """
+    from huggingface_hub.hf_api import HfApi
+
+    minijinja = _import_minijinja()
+
+    # 1. fetch config from API
+    try:
+        config = HfApi(token=token).model_info(model_id).config
+    except RepositoryNotFoundError as e:
+        raise TemplateError(f"Cannot render chat template: model '{model_id}' not found.") from e
+    except HfHubHTTPError as e:
+        raise TemplateError(f"Error while trying to fetch chat template for model '{model_id}': {e}") from e
+
+    # 2. check config validity
+    if config is None:
+        raise TemplateError(f"Config not found for model '{model_id}'.")
+    tokenizer_config = config.get("tokenizer_config")
+    if tokenizer_config is None:
+        raise TemplateError(f"Tokenizer config not found for model '{model_id}'.")
+    if tokenizer_config.get("chat_template") is None:
+        raise TemplateError(f"Chat template not found in tokenizer_config for model '{model_id}'.")
+    chat_template = tokenizer_config["chat_template"]
+    if not isinstance(chat_template, str):
+        raise TemplateError(f"Chat template must be a string, not '{type(chat_template)}' (model: {model_id}).")
+
+    special_tokens: Dict[str, Optional[str]] = {}
+    for key, value in tokenizer_config.items():
+        if "token" in key:
+            if isinstance(value, str):
+                special_tokens[key] = value
+            elif isinstance(value, dict) and value.get("__type") == "AddedToken":
+                special_tokens[key] = value.get("content")
+
+    # 3. compile template and return
+    env = minijinja.Environment()
+    try:
+        env.add_template("chat_template", chat_template)
+    except minijinja.TemplateError as e:
+        raise TemplateError(f"Error while trying to compile chat template for model '{model_id}': {e}") from e
+    return lambda **kwargs: env.render_template("chat_template", **kwargs, **special_tokens)
diff --git a/llm/Lib/site-packages/huggingface_hub/inference/_types.py b/llm/Lib/site-packages/huggingface_hub/inference/_types.py
new file mode 100644
index 0000000000000000000000000000000000000000..70c2137210c436c29398921178b6e8f45b6a4182
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference/_types.py
@@ -0,0 +1,52 @@
+# coding=utf-8
+# Copyright 2023-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import List, TypedDict
+
+
+# Legacy types
+# Types are now generated from the JSON schema spec in @huggingface/tasks.
+# See ./src/huggingface_hub/inference/_generated/types
+
+
+class ConversationalOutputConversation(TypedDict):
+    """Dictionary containing the "conversation" part of a [`~InferenceClient.conversational`] task.
+
+    Args:
+        generated_responses (`List[str]`):
+            A list of the responses from the model.
+        past_user_inputs (`List[str]`):
+            A list of the inputs from the user. Must be the same length as `generated_responses`.
+    """
+
+    generated_responses: List[str]
+    past_user_inputs: List[str]
+
+
+class ConversationalOutput(TypedDict):
+    """Dictionary containing the output of a  [`~InferenceClient.conversational`] task.
+
+    Args:
+        generated_text (`str`):
+            The last response from the model.
+        conversation (`ConversationalOutputConversation`):
+            The past conversation.
+        warnings (`List[str]`):
+            A list of warnings associated with the process.
+    """
+
+    conversation: ConversationalOutputConversation
+    generated_text: str
+    warnings: List[str]
diff --git a/llm/Lib/site-packages/huggingface_hub/inference_api.py b/llm/Lib/site-packages/huggingface_hub/inference_api.py
new file mode 100644
index 0000000000000000000000000000000000000000..c889a6d8720a5242f50f81955916df3cb33357e1
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/inference_api.py
@@ -0,0 +1,217 @@
+import io
+from typing import Any, Dict, List, Optional, Union
+
+from .constants import INFERENCE_ENDPOINT
+from .hf_api import HfApi
+from .utils import build_hf_headers, get_session, is_pillow_available, logging, validate_hf_hub_args
+from .utils._deprecation import _deprecate_method
+
+
+logger = logging.get_logger(__name__)
+
+
+ALL_TASKS = [
+    # NLP
+    "text-classification",
+    "token-classification",
+    "table-question-answering",
+    "question-answering",
+    "zero-shot-classification",
+    "translation",
+    "summarization",
+    "conversational",
+    "feature-extraction",
+    "text-generation",
+    "text2text-generation",
+    "fill-mask",
+    "sentence-similarity",
+    # Audio
+    "text-to-speech",
+    "automatic-speech-recognition",
+    "audio-to-audio",
+    "audio-classification",
+    "voice-activity-detection",
+    # Computer vision
+    "image-classification",
+    "object-detection",
+    "image-segmentation",
+    "text-to-image",
+    "image-to-image",
+    # Others
+    "tabular-classification",
+    "tabular-regression",
+]
+
+
+class InferenceApi:
+    """Client to configure requests and make calls to the HuggingFace Inference API.
+
+    Example:
+
+    ```python
+    >>> from huggingface_hub.inference_api import InferenceApi
+
+    >>> # Mask-fill example
+    >>> inference = InferenceApi("bert-base-uncased")
+    >>> inference(inputs="The goal of life is [MASK].")
+    [{'sequence': 'the goal of life is life.', 'score': 0.10933292657136917, 'token': 2166, 'token_str': 'life'}]
+
+    >>> # Question Answering example
+    >>> inference = InferenceApi("deepset/roberta-base-squad2")
+    >>> inputs = {
+    ...     "question": "What's my name?",
+    ...     "context": "My name is Clara and I live in Berkeley.",
+    ... }
+    >>> inference(inputs)
+    {'score': 0.9326569437980652, 'start': 11, 'end': 16, 'answer': 'Clara'}
+
+    >>> # Zero-shot example
+    >>> inference = InferenceApi("typeform/distilbert-base-uncased-mnli")
+    >>> inputs = "Hi, I recently bought a device from your company but it is not working as advertised and I would like to get reimbursed!"
+    >>> params = {"candidate_labels": ["refund", "legal", "faq"]}
+    >>> inference(inputs, params)
+    {'sequence': 'Hi, I recently bought a device from your company but it is not working as advertised and I would like to get reimbursed!', 'labels': ['refund', 'faq', 'legal'], 'scores': [0.9378499388694763, 0.04914155602455139, 0.013008488342165947]}
+
+    >>> # Overriding configured task
+    >>> inference = InferenceApi("bert-base-uncased", task="feature-extraction")
+
+    >>> # Text-to-image
+    >>> inference = InferenceApi("stabilityai/stable-diffusion-2-1")
+    >>> inference("cat")
+    <PIL.PngImagePlugin.PngImageFile image (...)>
+
+    >>> # Return as raw response to parse the output yourself
+    >>> inference = InferenceApi("mio/amadeus")
+    >>> response = inference("hello world", raw_response=True)
+    >>> response.headers
+    {"Content-Type": "audio/flac", ...}
+    >>> response.content # raw bytes from server
+    b'(...)'
+    ```
+    """
+
+    @validate_hf_hub_args
+    @_deprecate_method(
+        version="1.0",
+        message=(
+            "`InferenceApi` client is deprecated in favor of the more feature-complete `InferenceClient`. Check out"
+            " this guide to learn how to convert your script to use it:"
+            " https://huggingface.co/docs/huggingface_hub/guides/inference#legacy-inferenceapi-client."
+        ),
+    )
+    def __init__(
+        self,
+        repo_id: str,
+        task: Optional[str] = None,
+        token: Optional[str] = None,
+        gpu: bool = False,
+    ):
+        """Inits headers and API call information.
+
+        Args:
+            repo_id (``str``):
+                Id of repository (e.g. `user/bert-base-uncased`).
+            task (``str``, `optional`, defaults ``None``):
+                Whether to force a task instead of using task specified in the
+                repository.
+            token (`str`, `optional`):
+                The API token to use as HTTP bearer authorization. This is not
+                the authentication token. You can find the token in
+                https://huggingface.co/settings/token. Alternatively, you can
+                find both your organizations and personal API tokens using
+                `HfApi().whoami(token)`.
+            gpu (`bool`, `optional`, defaults `False`):
+                Whether to use GPU instead of CPU for inference(requires Startup
+                plan at least).
+        """
+        self.options = {"wait_for_model": True, "use_gpu": gpu}
+        self.headers = build_hf_headers(token=token)
+
+        # Configure task
+        model_info = HfApi(token=token).model_info(repo_id=repo_id)
+        if not model_info.pipeline_tag and not task:
+            raise ValueError(
+                "Task not specified in the repository. Please add it to the model card"
+                " using pipeline_tag"
+                " (https://huggingface.co/docs#how-is-a-models-type-of-inference-api-and-widget-determined)"
+            )
+
+        if task and task != model_info.pipeline_tag:
+            if task not in ALL_TASKS:
+                raise ValueError(f"Invalid task {task}. Make sure it's valid.")
+
+            logger.warning(
+                "You're using a different task than the one specified in the"
+                " repository. Be sure to know what you're doing :)"
+            )
+            self.task = task
+        else:
+            assert model_info.pipeline_tag is not None, "Pipeline tag cannot be None"
+            self.task = model_info.pipeline_tag
+
+        self.api_url = f"{INFERENCE_ENDPOINT}/pipeline/{self.task}/{repo_id}"
+
+    def __repr__(self):
+        # Do not add headers to repr to avoid leaking token.
+        return f"InferenceAPI(api_url='{self.api_url}', task='{self.task}', options={self.options})"
+
+    def __call__(
+        self,
+        inputs: Optional[Union[str, Dict, List[str], List[List[str]]]] = None,
+        params: Optional[Dict] = None,
+        data: Optional[bytes] = None,
+        raw_response: bool = False,
+    ) -> Any:
+        """Make a call to the Inference API.
+
+        Args:
+            inputs (`str` or `Dict` or `List[str]` or `List[List[str]]`, *optional*):
+                Inputs for the prediction.
+            params (`Dict`, *optional*):
+                Additional parameters for the models. Will be sent as `parameters` in the
+                payload.
+            data (`bytes`, *optional*):
+                Bytes content of the request. In this case, leave `inputs` and `params` empty.
+            raw_response (`bool`, defaults to `False`):
+                If `True`, the raw `Response` object is returned. You can parse its content
+                as preferred. By default, the content is parsed into a more practical format
+                (json dictionary or PIL Image for example).
+        """
+        # Build payload
+        payload: Dict[str, Any] = {
+            "options": self.options,
+        }
+        if inputs:
+            payload["inputs"] = inputs
+        if params:
+            payload["parameters"] = params
+
+        # Make API call
+        response = get_session().post(self.api_url, headers=self.headers, json=payload, data=data)
+
+        # Let the user handle the response
+        if raw_response:
+            return response
+
+        # By default, parse the response for the user.
+        content_type = response.headers.get("Content-Type") or ""
+        if content_type.startswith("image"):
+            if not is_pillow_available():
+                raise ImportError(
+                    f"Task '{self.task}' returned as image but Pillow is not installed."
+                    " Please install it (`pip install Pillow`) or pass"
+                    " `raw_response=True` to get the raw `Response` object and parse"
+                    " the image by yourself."
+                )
+
+            from PIL import Image
+
+            return Image.open(io.BytesIO(response.content))
+        elif content_type == "application/json":
+            return response.json()
+        else:
+            raise NotImplementedError(
+                f"{content_type} output type is not implemented yet. You can pass"
+                " `raw_response=True` to get the raw `Response` object and parse the"
+                " output by yourself."
+            )
diff --git a/llm/Lib/site-packages/huggingface_hub/keras_mixin.py b/llm/Lib/site-packages/huggingface_hub/keras_mixin.py
new file mode 100644
index 0000000000000000000000000000000000000000..5584ce84a250b18d3620089e6f6240a37bb47baa
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/keras_mixin.py
@@ -0,0 +1,502 @@
+import collections.abc as collections
+import json
+import os
+import warnings
+from functools import wraps
+from pathlib import Path
+from shutil import copytree
+from typing import Any, Dict, List, Optional, Union
+
+from huggingface_hub import ModelHubMixin, snapshot_download
+from huggingface_hub.utils import (
+    get_tf_version,
+    is_graphviz_available,
+    is_pydot_available,
+    is_tf_available,
+    yaml_dump,
+)
+
+from .constants import CONFIG_NAME
+from .hf_api import HfApi
+from .utils import SoftTemporaryDirectory, logging, validate_hf_hub_args
+from .utils._typing import CallableT
+
+
+logger = logging.get_logger(__name__)
+
+keras = None
+if is_tf_available():
+    # Depending on which version of TensorFlow is installed, we need to import
+    # keras from the correct location.
+    # See https://github.com/tensorflow/tensorflow/releases/tag/v2.16.1.
+    # Note: saving a keras model only works with Keras<3.0.
+    try:
+        import tf_keras as keras  # type: ignore
+    except ImportError:
+        import tensorflow as tf  # type: ignore
+
+        keras = tf.keras
+
+
+def _requires_keras_2_model(fn: CallableT) -> CallableT:
+    # Wrapper to raise if user tries to save a Keras 3.x model
+    @wraps(fn)
+    def _inner(model, *args, **kwargs):
+        if not hasattr(model, "history"):  # hacky way to check if model is Keras 2.x
+            raise NotImplementedError(
+                f"Cannot use '{fn.__name__}': Keras 3.x is not supported."
+                " Please save models manually and upload them using `upload_folder` or `huggingface-cli upload`."
+            )
+        return fn(model, *args, **kwargs)
+
+    return _inner  # type: ignore [return-value]
+
+
+def _flatten_dict(dictionary, parent_key=""):
+    """Flatten a nested dictionary.
+    Reference: https://stackoverflow.com/a/6027615/10319735
+
+    Args:
+        dictionary (`dict`):
+            The nested dictionary to be flattened.
+        parent_key (`str`):
+            The parent key to be prefixed to the children keys.
+            Necessary for recursing over the nested dictionary.
+
+    Returns:
+        The flattened dictionary.
+    """
+    items = []
+    for key, value in dictionary.items():
+        new_key = f"{parent_key}.{key}" if parent_key else key
+        if isinstance(value, collections.MutableMapping):
+            items.extend(
+                _flatten_dict(
+                    value,
+                    new_key,
+                ).items()
+            )
+        else:
+            items.append((new_key, value))
+    return dict(items)
+
+
+def _create_hyperparameter_table(model):
+    """Parse hyperparameter dictionary into a markdown table."""
+    table = None
+    if model.optimizer is not None:
+        optimizer_params = model.optimizer.get_config()
+        # flatten the configuration
+        optimizer_params = _flatten_dict(optimizer_params)
+        optimizer_params["training_precision"] = keras.mixed_precision.global_policy().name
+        table = "| Hyperparameters | Value |\n| :-- | :-- |\n"
+        for key, value in optimizer_params.items():
+            table += f"| {key} | {value} |\n"
+    return table
+
+
+def _plot_network(model, save_directory):
+    keras.utils.plot_model(
+        model,
+        to_file=f"{save_directory}/model.png",
+        show_shapes=False,
+        show_dtype=False,
+        show_layer_names=True,
+        rankdir="TB",
+        expand_nested=False,
+        dpi=96,
+        layer_range=None,
+    )
+
+
+def _create_model_card(
+    model,
+    repo_dir: Path,
+    plot_model: bool = True,
+    metadata: Optional[dict] = None,
+):
+    """
+    Creates a model card for the repository.
+
+    Do not overwrite an existing README.md file.
+    """
+    readme_path = repo_dir / "README.md"
+    if readme_path.exists():
+        return
+
+    hyperparameters = _create_hyperparameter_table(model)
+    if plot_model and is_graphviz_available() and is_pydot_available():
+        _plot_network(model, repo_dir)
+    if metadata is None:
+        metadata = {}
+    metadata["library_name"] = "keras"
+    model_card: str = "---\n"
+    model_card += yaml_dump(metadata, default_flow_style=False)
+    model_card += "---\n"
+    model_card += "\n## Model description\n\nMore information needed\n"
+    model_card += "\n## Intended uses & limitations\n\nMore information needed\n"
+    model_card += "\n## Training and evaluation data\n\nMore information needed\n"
+    if hyperparameters is not None:
+        model_card += "\n## Training procedure\n"
+        model_card += "\n### Training hyperparameters\n"
+        model_card += "\nThe following hyperparameters were used during training:\n\n"
+        model_card += hyperparameters
+        model_card += "\n"
+    if plot_model and os.path.exists(f"{repo_dir}/model.png"):
+        model_card += "\n ## Model Plot\n"
+        model_card += "\n<details>"
+        model_card += "\n<summary>View Model Plot</summary>\n"
+        path_to_plot = "./model.png"
+        model_card += f"\n![Model Image]({path_to_plot})\n"
+        model_card += "\n</details>"
+
+    readme_path.write_text(model_card)
+
+
+@_requires_keras_2_model
+def save_pretrained_keras(
+    model,
+    save_directory: Union[str, Path],
+    config: Optional[Dict[str, Any]] = None,
+    include_optimizer: bool = False,
+    plot_model: bool = True,
+    tags: Optional[Union[list, str]] = None,
+    **model_save_kwargs,
+):
+    """
+    Saves a Keras model to save_directory in SavedModel format. Use this if
+    you're using the Functional or Sequential APIs.
+
+    Args:
+        model (`Keras.Model`):
+            The [Keras
+            model](https://www.tensorflow.org/api_docs/python/tf/keras/Model)
+            you'd like to save. The model must be compiled and built.
+        save_directory (`str` or `Path`):
+            Specify directory in which you want to save the Keras model.
+        config (`dict`, *optional*):
+            Configuration object to be saved alongside the model weights.
+        include_optimizer(`bool`, *optional*, defaults to `False`):
+            Whether or not to include optimizer in serialization.
+        plot_model (`bool`, *optional*, defaults to `True`):
+            Setting this to `True` will plot the model and put it in the model
+            card. Requires graphviz and pydot to be installed.
+        tags (Union[`str`,`list`], *optional*):
+            List of tags that are related to model or string of a single tag. See example tags
+            [here](https://github.com/huggingface/hub-docs/blob/main/modelcard.md?plain=1).
+        model_save_kwargs(`dict`, *optional*):
+            model_save_kwargs will be passed to
+            [`tf.keras.models.save_model()`](https://www.tensorflow.org/api_docs/python/tf/keras/models/save_model).
+    """
+    if keras is None:
+        raise ImportError("Called a Tensorflow-specific function but could not import it.")
+
+    if not model.built:
+        raise ValueError("Model should be built before trying to save")
+
+    save_directory = Path(save_directory)
+    save_directory.mkdir(parents=True, exist_ok=True)
+
+    # saving config
+    if config:
+        if not isinstance(config, dict):
+            raise RuntimeError(f"Provided config to save_pretrained_keras should be a dict. Got: '{type(config)}'")
+
+        with (save_directory / CONFIG_NAME).open("w") as f:
+            json.dump(config, f)
+
+    metadata = {}
+    if isinstance(tags, list):
+        metadata["tags"] = tags
+    elif isinstance(tags, str):
+        metadata["tags"] = [tags]
+
+    task_name = model_save_kwargs.pop("task_name", None)
+    if task_name is not None:
+        warnings.warn(
+            "`task_name` input argument is deprecated. Pass `tags` instead.",
+            FutureWarning,
+        )
+        if "tags" in metadata:
+            metadata["tags"].append(task_name)
+        else:
+            metadata["tags"] = [task_name]
+
+    if model.history is not None:
+        if model.history.history != {}:
+            path = save_directory / "history.json"
+            if path.exists():
+                warnings.warn(
+                    "`history.json` file already exists, it will be overwritten by the history of this version.",
+                    UserWarning,
+                )
+            with path.open("w", encoding="utf-8") as f:
+                json.dump(model.history.history, f, indent=2, sort_keys=True)
+
+    _create_model_card(model, save_directory, plot_model, metadata)
+    keras.models.save_model(model, save_directory, include_optimizer=include_optimizer, **model_save_kwargs)
+
+
+def from_pretrained_keras(*args, **kwargs) -> "KerasModelHubMixin":
+    r"""
+    Instantiate a pretrained Keras model from a pre-trained model from the Hub.
+    The model is expected to be in `SavedModel` format.
+
+    Args:
+        pretrained_model_name_or_path (`str` or `os.PathLike`):
+            Can be either:
+                - A string, the `model id` of a pretrained model hosted inside a
+                  model repo on huggingface.co. Valid model ids can be located
+                  at the root-level, like `bert-base-uncased`, or namespaced
+                  under a user or organization name, like
+                  `dbmdz/bert-base-german-cased`.
+                - You can add `revision` by appending `@` at the end of model_id
+                  simply like this: `dbmdz/bert-base-german-cased@main` Revision
+                  is the specific model version to use. It can be a branch name,
+                  a tag name, or a commit id, since we use a git-based system
+                  for storing models and other artifacts on huggingface.co, so
+                  `revision` can be any identifier allowed by git.
+                - A path to a `directory` containing model weights saved using
+                  [`~transformers.PreTrainedModel.save_pretrained`], e.g.,
+                  `./my_model_directory/`.
+                - `None` if you are both providing the configuration and state
+                  dictionary (resp. with keyword arguments `config` and
+                  `state_dict`).
+        force_download (`bool`, *optional*, defaults to `False`):
+            Whether to force the (re-)download of the model weights and
+            configuration files, overriding the cached versions if they exist.
+        resume_download (`bool`, *optional*, defaults to `False`):
+            Whether to delete incompletely received files. Will attempt to
+            resume the download if such a file exists.
+        proxies (`Dict[str, str]`, *optional*):
+            A dictionary of proxy servers to use by protocol or endpoint, e.g.,
+            `{'http': 'foo.bar:3128', 'http://hostname': 'foo.bar:4012'}`. The
+            proxies are used on each request.
+        token (`str` or `bool`, *optional*):
+            The token to use as HTTP bearer authorization for remote files. If
+            `True`, will use the token generated when running `transformers-cli
+            login` (stored in `~/.huggingface`).
+        cache_dir (`Union[str, os.PathLike]`, *optional*):
+            Path to a directory in which a downloaded pretrained model
+            configuration should be cached if the standard cache should not be
+            used.
+        local_files_only(`bool`, *optional*, defaults to `False`):
+            Whether to only look at local files (i.e., do not try to download
+            the model).
+        model_kwargs (`Dict`, *optional*):
+            model_kwargs will be passed to the model during initialization
+
+    <Tip>
+
+    Passing `token=True` is required when you want to use a private
+    model.
+
+    </Tip>
+    """
+    return KerasModelHubMixin.from_pretrained(*args, **kwargs)
+
+
+@validate_hf_hub_args
+@_requires_keras_2_model
+def push_to_hub_keras(
+    model,
+    repo_id: str,
+    *,
+    config: Optional[dict] = None,
+    commit_message: str = "Push Keras model using huggingface_hub.",
+    private: bool = False,
+    api_endpoint: Optional[str] = None,
+    token: Optional[str] = None,
+    branch: Optional[str] = None,
+    create_pr: Optional[bool] = None,
+    allow_patterns: Optional[Union[List[str], str]] = None,
+    ignore_patterns: Optional[Union[List[str], str]] = None,
+    delete_patterns: Optional[Union[List[str], str]] = None,
+    log_dir: Optional[str] = None,
+    include_optimizer: bool = False,
+    tags: Optional[Union[list, str]] = None,
+    plot_model: bool = True,
+    **model_save_kwargs,
+):
+    """
+    Upload model checkpoint to the Hub.
+
+    Use `allow_patterns` and `ignore_patterns` to precisely filter which files should be pushed to the hub. Use
+    `delete_patterns` to delete existing remote files in the same commit. See [`upload_folder`] reference for more
+    details.
+
+    Args:
+        model (`Keras.Model`):
+            The [Keras model](`https://www.tensorflow.org/api_docs/python/tf/keras/Model`) you'd like to push to the
+            Hub. The model must be compiled and built.
+        repo_id (`str`):
+                ID of the repository to push to (example: `"username/my-model"`).
+        commit_message (`str`, *optional*, defaults to "Add Keras model"):
+            Message to commit while pushing.
+        private (`bool`, *optional*, defaults to `False`):
+            Whether the repository created should be private.
+        api_endpoint (`str`, *optional*):
+            The API endpoint to use when pushing the model to the hub.
+        token (`str`, *optional*):
+            The token to use as HTTP bearer authorization for remote files. If
+            not set, will use the token set when logging in with
+            `huggingface-cli login` (stored in `~/.huggingface`).
+        branch (`str`, *optional*):
+            The git branch on which to push the model. This defaults to
+            the default branch as specified in your repository, which
+            defaults to `"main"`.
+        create_pr (`boolean`, *optional*):
+            Whether or not to create a Pull Request from `branch` with that commit.
+            Defaults to `False`.
+        config (`dict`, *optional*):
+            Configuration object to be saved alongside the model weights.
+        allow_patterns (`List[str]` or `str`, *optional*):
+            If provided, only files matching at least one pattern are pushed.
+        ignore_patterns (`List[str]` or `str`, *optional*):
+            If provided, files matching any of the patterns are not pushed.
+        delete_patterns (`List[str]` or `str`, *optional*):
+            If provided, remote files matching any of the patterns will be deleted from the repo.
+        log_dir (`str`, *optional*):
+            TensorBoard logging directory to be pushed. The Hub automatically
+            hosts and displays a TensorBoard instance if log files are included
+            in the repository.
+        include_optimizer (`bool`, *optional*, defaults to `False`):
+            Whether or not to include optimizer during serialization.
+        tags (Union[`list`, `str`], *optional*):
+            List of tags that are related to model or string of a single tag. See example tags
+            [here](https://github.com/huggingface/hub-docs/blob/main/modelcard.md?plain=1).
+        plot_model (`bool`, *optional*, defaults to `True`):
+            Setting this to `True` will plot the model and put it in the model
+            card. Requires graphviz and pydot to be installed.
+        model_save_kwargs(`dict`, *optional*):
+            model_save_kwargs will be passed to
+            [`tf.keras.models.save_model()`](https://www.tensorflow.org/api_docs/python/tf/keras/models/save_model).
+
+    Returns:
+        The url of the commit of your model in the given repository.
+    """
+    api = HfApi(endpoint=api_endpoint)
+    repo_id = api.create_repo(repo_id=repo_id, token=token, private=private, exist_ok=True).repo_id
+
+    # Push the files to the repo in a single commit
+    with SoftTemporaryDirectory() as tmp:
+        saved_path = Path(tmp) / repo_id
+        save_pretrained_keras(
+            model,
+            saved_path,
+            config=config,
+            include_optimizer=include_optimizer,
+            tags=tags,
+            plot_model=plot_model,
+            **model_save_kwargs,
+        )
+
+        # If `log_dir` provided, delete remote logs and upload new ones
+        if log_dir is not None:
+            delete_patterns = (
+                []
+                if delete_patterns is None
+                else (
+                    [delete_patterns]  # convert `delete_patterns` to a list
+                    if isinstance(delete_patterns, str)
+                    else delete_patterns
+                )
+            )
+            delete_patterns.append("logs/*")
+            copytree(log_dir, saved_path / "logs")
+
+        return api.upload_folder(
+            repo_type="model",
+            repo_id=repo_id,
+            folder_path=saved_path,
+            commit_message=commit_message,
+            token=token,
+            revision=branch,
+            create_pr=create_pr,
+            allow_patterns=allow_patterns,
+            ignore_patterns=ignore_patterns,
+            delete_patterns=delete_patterns,
+        )
+
+
+class KerasModelHubMixin(ModelHubMixin):
+    """
+    Implementation of [`ModelHubMixin`] to provide model Hub upload/download
+    capabilities to Keras models.
+
+
+    ```python
+    >>> import tensorflow as tf
+    >>> from huggingface_hub import KerasModelHubMixin
+
+
+    >>> class MyModel(tf.keras.Model, KerasModelHubMixin):
+    ...     def __init__(self, **kwargs):
+    ...         super().__init__()
+    ...         self.config = kwargs.pop("config", None)
+    ...         self.dummy_inputs = ...
+    ...         self.layer = ...
+
+    ...     def call(self, *args):
+    ...         return ...
+
+
+    >>> # Initialize and compile the model as you normally would
+    >>> model = MyModel()
+    >>> model.compile(...)
+    >>> # Build the graph by training it or passing dummy inputs
+    >>> _ = model(model.dummy_inputs)
+    >>> # Save model weights to local directory
+    >>> model.save_pretrained("my-awesome-model")
+    >>> # Push model weights to the Hub
+    >>> model.push_to_hub("my-awesome-model")
+    >>> # Download and initialize weights from the Hub
+    >>> model = MyModel.from_pretrained("username/super-cool-model")
+    ```
+    """
+
+    def _save_pretrained(self, save_directory):
+        save_pretrained_keras(self, save_directory)
+
+    @classmethod
+    def _from_pretrained(
+        cls,
+        model_id,
+        revision,
+        cache_dir,
+        force_download,
+        proxies,
+        resume_download,
+        local_files_only,
+        token,
+        config: Optional[Dict[str, Any]] = None,
+        **model_kwargs,
+    ):
+        """Here we just call [`from_pretrained_keras`] function so both the mixin and
+        functional APIs stay in sync.
+
+                TODO - Some args above aren't used since we are calling
+                snapshot_download instead of hf_hub_download.
+        """
+        if keras is None:
+            raise ImportError("Called a TensorFlow-specific function but could not import it.")
+
+        # Root is either a local filepath matching model_id or a cached snapshot
+        if not os.path.isdir(model_id):
+            storage_folder = snapshot_download(
+                repo_id=model_id,
+                revision=revision,
+                cache_dir=cache_dir,
+                library_name="keras",
+                library_version=get_tf_version(),
+            )
+        else:
+            storage_folder = model_id
+
+        # TODO: change this in a future PR. We are not returning a KerasModelHubMixin instance here...
+        model = keras.models.load_model(storage_folder)
+
+        # For now, we add a new attribute, config, to store the config loaded from the hub/a local dir.
+        model.config = config
+
+        return model
diff --git a/llm/Lib/site-packages/huggingface_hub/lfs.py b/llm/Lib/site-packages/huggingface_hub/lfs.py
new file mode 100644
index 0000000000000000000000000000000000000000..d6fb9e210b522ab6f6730a3ab52c90d0e692e9d5
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/lfs.py
@@ -0,0 +1,541 @@
+# coding=utf-8
+# Copyright 2019-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Git LFS related type definitions and utilities"""
+
+import inspect
+import io
+import os
+import re
+import warnings
+from contextlib import AbstractContextManager
+from dataclasses import dataclass
+from math import ceil
+from os.path import getsize
+from pathlib import Path
+from typing import TYPE_CHECKING, BinaryIO, Dict, Iterable, List, Optional, Tuple, TypedDict
+from urllib.parse import unquote
+
+from huggingface_hub.constants import ENDPOINT, HF_HUB_ENABLE_HF_TRANSFER, REPO_TYPES_URL_PREFIXES
+
+from .utils import (
+    build_hf_headers,
+    fix_hf_endpoint_in_url,
+    get_session,
+    hf_raise_for_status,
+    http_backoff,
+    logging,
+    tqdm,
+    validate_hf_hub_args,
+)
+from .utils.sha import sha256, sha_fileobj
+
+
+if TYPE_CHECKING:
+    from ._commit_api import CommitOperationAdd
+
+logger = logging.get_logger(__name__)
+
+OID_REGEX = re.compile(r"^[0-9a-f]{40}$")
+
+LFS_MULTIPART_UPLOAD_COMMAND = "lfs-multipart-upload"
+
+LFS_HEADERS = {
+    "Accept": "application/vnd.git-lfs+json",
+    "Content-Type": "application/vnd.git-lfs+json",
+}
+
+
+@dataclass
+class UploadInfo:
+    """
+    Dataclass holding required information to determine whether a blob
+    should be uploaded to the hub using the LFS protocol or the regular protocol
+
+    Args:
+        sha256 (`bytes`):
+            SHA256 hash of the blob
+        size (`int`):
+            Size in bytes of the blob
+        sample (`bytes`):
+            First 512 bytes of the blob
+    """
+
+    sha256: bytes
+    size: int
+    sample: bytes
+
+    @classmethod
+    def from_path(cls, path: str):
+        size = getsize(path)
+        with io.open(path, "rb") as file:
+            sample = file.peek(512)[:512]
+            sha = sha_fileobj(file)
+        return cls(size=size, sha256=sha, sample=sample)
+
+    @classmethod
+    def from_bytes(cls, data: bytes):
+        sha = sha256(data).digest()
+        return cls(size=len(data), sample=data[:512], sha256=sha)
+
+    @classmethod
+    def from_fileobj(cls, fileobj: BinaryIO):
+        sample = fileobj.read(512)
+        fileobj.seek(0, io.SEEK_SET)
+        sha = sha_fileobj(fileobj)
+        size = fileobj.tell()
+        fileobj.seek(0, io.SEEK_SET)
+        return cls(size=size, sha256=sha, sample=sample)
+
+
+@validate_hf_hub_args
+def post_lfs_batch_info(
+    upload_infos: Iterable[UploadInfo],
+    token: Optional[str],
+    repo_type: str,
+    repo_id: str,
+    revision: Optional[str] = None,
+    endpoint: Optional[str] = None,
+    headers: Optional[Dict[str, str]] = None,
+) -> Tuple[List[dict], List[dict]]:
+    """
+    Requests the LFS batch endpoint to retrieve upload instructions
+
+    Learn more: https://github.com/git-lfs/git-lfs/blob/main/docs/api/batch.md
+
+    Args:
+        upload_infos (`Iterable` of `UploadInfo`):
+            `UploadInfo` for the files that are being uploaded, typically obtained
+            from `CommitOperationAdd.upload_info`
+        repo_type (`str`):
+            Type of the repo to upload to: `"model"`, `"dataset"` or `"space"`.
+        repo_id (`str`):
+            A namespace (user or an organization) and a repo name separated
+            by a `/`.
+        revision (`str`, *optional*):
+            The git revision to upload to.
+        headers (`dict`, *optional*):
+            Additional headers to include in the request
+
+    Returns:
+        `LfsBatchInfo`: 2-tuple:
+            - First element is the list of upload instructions from the server
+            - Second element is an list of errors, if any
+
+    Raises:
+        `ValueError`: If an argument is invalid or the server response is malformed
+
+        `HTTPError`: If the server returned an error
+    """
+    endpoint = endpoint if endpoint is not None else ENDPOINT
+    url_prefix = ""
+    if repo_type in REPO_TYPES_URL_PREFIXES:
+        url_prefix = REPO_TYPES_URL_PREFIXES[repo_type]
+    batch_url = f"{endpoint}/{url_prefix}{repo_id}.git/info/lfs/objects/batch"
+    payload: Dict = {
+        "operation": "upload",
+        "transfers": ["basic", "multipart"],
+        "objects": [
+            {
+                "oid": upload.sha256.hex(),
+                "size": upload.size,
+            }
+            for upload in upload_infos
+        ],
+        "hash_algo": "sha256",
+    }
+    if revision is not None:
+        payload["ref"] = {"name": unquote(revision)}  # revision has been previously 'quoted'
+
+    headers = {
+        **LFS_HEADERS,
+        **build_hf_headers(token=token),
+        **(headers or {}),
+    }
+    resp = get_session().post(batch_url, headers=headers, json=payload)
+    hf_raise_for_status(resp)
+    batch_info = resp.json()
+
+    objects = batch_info.get("objects", None)
+    if not isinstance(objects, list):
+        raise ValueError("Malformed response from server")
+
+    return (
+        [_validate_batch_actions(obj) for obj in objects if "error" not in obj],
+        [_validate_batch_error(obj) for obj in objects if "error" in obj],
+    )
+
+
+class PayloadPartT(TypedDict):
+    partNumber: int
+    etag: str
+
+
+class CompletionPayloadT(TypedDict):
+    """Payload that will be sent to the Hub when uploading multi-part."""
+
+    oid: str
+    parts: List[PayloadPartT]
+
+
+def lfs_upload(
+    operation: "CommitOperationAdd",
+    lfs_batch_action: Dict,
+    token: Optional[str] = None,
+    headers: Optional[Dict[str, str]] = None,
+    endpoint: Optional[str] = None,
+) -> None:
+    """
+    Handles uploading a given object to the Hub with the LFS protocol.
+
+    Can be a No-op if the content of the file is already present on the hub large file storage.
+
+    Args:
+        operation (`CommitOperationAdd`):
+            The add operation triggering this upload.
+        lfs_batch_action (`dict`):
+            Upload instructions from the LFS batch endpoint for this object. See [`~utils.lfs.post_lfs_batch_info`] for
+            more details.
+        headers (`dict`, *optional*):
+            Headers to include in the request, including authentication and user agent headers.
+
+    Raises:
+        - `ValueError` if `lfs_batch_action` is improperly formatted
+        - `HTTPError` if the upload resulted in an error
+    """
+    # 0. If LFS file is already present, skip upload
+    _validate_batch_actions(lfs_batch_action)
+    actions = lfs_batch_action.get("actions")
+    if actions is None:
+        # The file was already uploaded
+        logger.debug(f"Content of file {operation.path_in_repo} is already present upstream - skipping upload")
+        return
+
+    # 1. Validate server response (check required keys in dict)
+    upload_action = lfs_batch_action["actions"]["upload"]
+    _validate_lfs_action(upload_action)
+    verify_action = lfs_batch_action["actions"].get("verify")
+    if verify_action is not None:
+        _validate_lfs_action(verify_action)
+
+    # 2. Upload file (either single part or multi-part)
+    header = upload_action.get("header", {})
+    chunk_size = header.get("chunk_size")
+    upload_url = fix_hf_endpoint_in_url(upload_action["href"], endpoint=endpoint)
+    if chunk_size is not None:
+        try:
+            chunk_size = int(chunk_size)
+        except (ValueError, TypeError):
+            raise ValueError(
+                f"Malformed response from LFS batch endpoint: `chunk_size` should be an integer. Got '{chunk_size}'."
+            )
+        _upload_multi_part(operation=operation, header=header, chunk_size=chunk_size, upload_url=upload_url)
+    else:
+        _upload_single_part(operation=operation, upload_url=upload_url)
+
+    # 3. Verify upload went well
+    if verify_action is not None:
+        _validate_lfs_action(verify_action)
+        verify_url = fix_hf_endpoint_in_url(verify_action["href"], endpoint)
+        verify_resp = get_session().post(
+            verify_url,
+            headers=build_hf_headers(token=token, headers=headers),
+            json={"oid": operation.upload_info.sha256.hex(), "size": operation.upload_info.size},
+        )
+        hf_raise_for_status(verify_resp)
+    logger.debug(f"{operation.path_in_repo}: Upload successful")
+
+
+def _validate_lfs_action(lfs_action: dict):
+    """validates response from the LFS batch endpoint"""
+    if not (
+        isinstance(lfs_action.get("href"), str)
+        and (lfs_action.get("header") is None or isinstance(lfs_action.get("header"), dict))
+    ):
+        raise ValueError("lfs_action is improperly formatted")
+    return lfs_action
+
+
+def _validate_batch_actions(lfs_batch_actions: dict):
+    """validates response from the LFS batch endpoint"""
+    if not (isinstance(lfs_batch_actions.get("oid"), str) and isinstance(lfs_batch_actions.get("size"), int)):
+        raise ValueError("lfs_batch_actions is improperly formatted")
+
+    upload_action = lfs_batch_actions.get("actions", {}).get("upload")
+    verify_action = lfs_batch_actions.get("actions", {}).get("verify")
+    if upload_action is not None:
+        _validate_lfs_action(upload_action)
+    if verify_action is not None:
+        _validate_lfs_action(verify_action)
+    return lfs_batch_actions
+
+
+def _validate_batch_error(lfs_batch_error: dict):
+    """validates response from the LFS batch endpoint"""
+    if not (isinstance(lfs_batch_error.get("oid"), str) and isinstance(lfs_batch_error.get("size"), int)):
+        raise ValueError("lfs_batch_error is improperly formatted")
+    error_info = lfs_batch_error.get("error")
+    if not (
+        isinstance(error_info, dict)
+        and isinstance(error_info.get("message"), str)
+        and isinstance(error_info.get("code"), int)
+    ):
+        raise ValueError("lfs_batch_error is improperly formatted")
+    return lfs_batch_error
+
+
+def _upload_single_part(operation: "CommitOperationAdd", upload_url: str) -> None:
+    """
+    Uploads `fileobj` as a single PUT HTTP request (basic LFS transfer protocol)
+
+    Args:
+        upload_url (`str`):
+            The URL to PUT the file to.
+        fileobj:
+            The file-like object holding the data to upload.
+
+    Returns: `requests.Response`
+
+    Raises: `requests.HTTPError` if the upload resulted in an error
+    """
+    with operation.as_file(with_tqdm=True) as fileobj:
+        # S3 might raise a transient 500 error -> let's retry if that happens
+        response = http_backoff("PUT", upload_url, data=fileobj, retry_on_status_codes=(500, 502, 503, 504))
+        hf_raise_for_status(response)
+
+
+def _upload_multi_part(operation: "CommitOperationAdd", header: Dict, chunk_size: int, upload_url: str) -> None:
+    """
+    Uploads file using HF multipart LFS transfer protocol.
+    """
+    # 1. Get upload URLs for each part
+    sorted_parts_urls = _get_sorted_parts_urls(header=header, upload_info=operation.upload_info, chunk_size=chunk_size)
+
+    # 2. Upload parts (either with hf_transfer or in pure Python)
+    use_hf_transfer = HF_HUB_ENABLE_HF_TRANSFER
+    if (
+        HF_HUB_ENABLE_HF_TRANSFER
+        and not isinstance(operation.path_or_fileobj, str)
+        and not isinstance(operation.path_or_fileobj, Path)
+    ):
+        warnings.warn(
+            "hf_transfer is enabled but does not support uploading from bytes or BinaryIO, falling back to regular"
+            " upload"
+        )
+        use_hf_transfer = False
+
+    response_headers = (
+        _upload_parts_hf_transfer(operation=operation, sorted_parts_urls=sorted_parts_urls, chunk_size=chunk_size)
+        if use_hf_transfer
+        else _upload_parts_iteratively(operation=operation, sorted_parts_urls=sorted_parts_urls, chunk_size=chunk_size)
+    )
+
+    # 3. Send completion request
+    completion_res = get_session().post(
+        upload_url,
+        json=_get_completion_payload(response_headers, operation.upload_info.sha256.hex()),
+        headers=LFS_HEADERS,
+    )
+    hf_raise_for_status(completion_res)
+
+
+def _get_sorted_parts_urls(header: Dict, upload_info: UploadInfo, chunk_size: int) -> List[str]:
+    sorted_part_upload_urls = [
+        upload_url
+        for _, upload_url in sorted(
+            [
+                (int(part_num, 10), upload_url)
+                for part_num, upload_url in header.items()
+                if part_num.isdigit() and len(part_num) > 0
+            ],
+            key=lambda t: t[0],
+        )
+    ]
+    num_parts = len(sorted_part_upload_urls)
+    if num_parts != ceil(upload_info.size / chunk_size):
+        raise ValueError("Invalid server response to upload large LFS file")
+    return sorted_part_upload_urls
+
+
+def _get_completion_payload(response_headers: List[Dict], oid: str) -> CompletionPayloadT:
+    parts: List[PayloadPartT] = []
+    for part_number, header in enumerate(response_headers):
+        etag = header.get("etag")
+        if etag is None or etag == "":
+            raise ValueError(f"Invalid etag (`{etag}`) returned for part {part_number + 1}")
+        parts.append(
+            {
+                "partNumber": part_number + 1,
+                "etag": etag,
+            }
+        )
+    return {"oid": oid, "parts": parts}
+
+
+def _upload_parts_iteratively(
+    operation: "CommitOperationAdd", sorted_parts_urls: List[str], chunk_size: int
+) -> List[Dict]:
+    headers = []
+    with operation.as_file(with_tqdm=True) as fileobj:
+        for part_idx, part_upload_url in enumerate(sorted_parts_urls):
+            with SliceFileObj(
+                fileobj,
+                seek_from=chunk_size * part_idx,
+                read_limit=chunk_size,
+            ) as fileobj_slice:
+                # S3 might raise a transient 500 error -> let's retry if that happens
+                part_upload_res = http_backoff(
+                    "PUT", part_upload_url, data=fileobj_slice, retry_on_status_codes=(500, 502, 503, 504)
+                )
+                hf_raise_for_status(part_upload_res)
+                headers.append(part_upload_res.headers)
+    return headers  # type: ignore
+
+
+def _upload_parts_hf_transfer(
+    operation: "CommitOperationAdd", sorted_parts_urls: List[str], chunk_size: int
+) -> List[Dict]:
+    # Upload file using an external Rust-based package. Upload is faster but support less features (no progress bars).
+    try:
+        from hf_transfer import multipart_upload
+    except ImportError:
+        raise ValueError(
+            "Fast uploading using 'hf_transfer' is enabled (HF_HUB_ENABLE_HF_TRANSFER=1) but 'hf_transfer' package is"
+            " not available in your environment. Try `pip install hf_transfer`."
+        )
+
+    supports_callback = "callback" in inspect.signature(multipart_upload).parameters
+    if not supports_callback:
+        warnings.warn(
+            "You are using an outdated version of `hf_transfer`. Consider upgrading to latest version to enable progress bars using `pip install -U hf_transfer`."
+        )
+
+    total = operation.upload_info.size
+    desc = operation.path_in_repo
+    if len(desc) > 40:
+        desc = f"(…){desc[-40:]}"
+
+    # set `disable=None` rather than `disable=False` by default to disable progress bar when no TTY attached
+    # see https://github.com/huggingface/huggingface_hub/pull/2000
+    disable = True if (logger.getEffectiveLevel() == logging.NOTSET) else None
+
+    with tqdm(unit="B", unit_scale=True, total=total, initial=0, desc=desc, disable=disable) as progress:
+        try:
+            output = multipart_upload(
+                file_path=operation.path_or_fileobj,
+                parts_urls=sorted_parts_urls,
+                chunk_size=chunk_size,
+                max_files=128,
+                parallel_failures=127,  # could be removed
+                max_retries=5,
+                **({"callback": progress.update} if supports_callback else {}),
+            )
+        except Exception as e:
+            raise RuntimeError(
+                "An error occurred while uploading using `hf_transfer`. Consider disabling HF_HUB_ENABLE_HF_TRANSFER for"
+                " better error handling."
+            ) from e
+        if not supports_callback:
+            progress.update(total)
+        return output
+
+
+class SliceFileObj(AbstractContextManager):
+    """
+    Utility context manager to read a *slice* of a seekable file-like object as a seekable, file-like object.
+
+    This is NOT thread safe
+
+    Inspired by stackoverflow.com/a/29838711/593036
+
+    Credits to @julien-c
+
+    Args:
+        fileobj (`BinaryIO`):
+            A file-like object to slice. MUST implement `tell()` and `seek()` (and `read()` of course).
+            `fileobj` will be reset to its original position when exiting the context manager.
+        seek_from (`int`):
+            The start of the slice (offset from position 0 in bytes).
+        read_limit (`int`):
+            The maximum number of bytes to read from the slice.
+
+    Attributes:
+        previous_position (`int`):
+            The previous position
+
+    Examples:
+
+    Reading 200 bytes with an offset of 128 bytes from a file (ie bytes 128 to 327):
+    ```python
+    >>> with open("path/to/file", "rb") as file:
+    ...     with SliceFileObj(file, seek_from=128, read_limit=200) as fslice:
+    ...         fslice.read(...)
+    ```
+
+    Reading a file in chunks of 512 bytes
+    ```python
+    >>> import os
+    >>> chunk_size = 512
+    >>> file_size = os.getsize("path/to/file")
+    >>> with open("path/to/file", "rb") as file:
+    ...     for chunk_idx in range(ceil(file_size / chunk_size)):
+    ...         with SliceFileObj(file, seek_from=chunk_idx * chunk_size, read_limit=chunk_size) as fslice:
+    ...             chunk = fslice.read(...)
+
+    ```
+    """
+
+    def __init__(self, fileobj: BinaryIO, seek_from: int, read_limit: int):
+        self.fileobj = fileobj
+        self.seek_from = seek_from
+        self.read_limit = read_limit
+
+    def __enter__(self):
+        self._previous_position = self.fileobj.tell()
+        end_of_stream = self.fileobj.seek(0, os.SEEK_END)
+        self._len = min(self.read_limit, end_of_stream - self.seek_from)
+        # ^^ The actual number of bytes that can be read from the slice
+        self.fileobj.seek(self.seek_from, io.SEEK_SET)
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        self.fileobj.seek(self._previous_position, io.SEEK_SET)
+
+    def read(self, n: int = -1):
+        pos = self.tell()
+        if pos >= self._len:
+            return b""
+        remaining_amount = self._len - pos
+        data = self.fileobj.read(remaining_amount if n < 0 else min(n, remaining_amount))
+        return data
+
+    def tell(self) -> int:
+        return self.fileobj.tell() - self.seek_from
+
+    def seek(self, offset: int, whence: int = os.SEEK_SET) -> int:
+        start = self.seek_from
+        end = start + self._len
+        if whence in (os.SEEK_SET, os.SEEK_END):
+            offset = start + offset if whence == os.SEEK_SET else end + offset
+            offset = max(start, min(offset, end))
+            whence = os.SEEK_SET
+        elif whence == os.SEEK_CUR:
+            cur_pos = self.fileobj.tell()
+            offset = max(start - cur_pos, min(offset, end - cur_pos))
+        else:
+            raise ValueError(f"whence value {whence} is not supported")
+        return self.fileobj.seek(offset, whence) - self.seek_from
+
+    def __iter__(self):
+        yield self.read(n=4 * 1024 * 1024)
diff --git a/llm/Lib/site-packages/huggingface_hub/repocard.py b/llm/Lib/site-packages/huggingface_hub/repocard.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ea7fc136cef1e9d78d3c4f44b1516a1ebe64158
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/repocard.py
@@ -0,0 +1,828 @@
+import os
+import re
+from pathlib import Path
+from typing import Any, Dict, Literal, Optional, Type, Union
+
+import requests
+import yaml
+
+from huggingface_hub.file_download import hf_hub_download
+from huggingface_hub.hf_api import upload_file
+from huggingface_hub.repocard_data import (
+    CardData,
+    DatasetCardData,
+    EvalResult,
+    ModelCardData,
+    SpaceCardData,
+    eval_results_to_model_index,
+    model_index_to_eval_results,
+)
+from huggingface_hub.utils import get_session, is_jinja_available, yaml_dump
+
+from .constants import REPOCARD_NAME
+from .utils import EntryNotFoundError, SoftTemporaryDirectory, logging, validate_hf_hub_args
+
+
+logger = logging.get_logger(__name__)
+
+
+TEMPLATE_MODELCARD_PATH = Path(__file__).parent / "templates" / "modelcard_template.md"
+TEMPLATE_DATASETCARD_PATH = Path(__file__).parent / "templates" / "datasetcard_template.md"
+
+# exact same regex as in the Hub server. Please keep in sync.
+# See https://github.com/huggingface/moon-landing/blob/main/server/lib/ViewMarkdown.ts#L18
+REGEX_YAML_BLOCK = re.compile(r"^(\s*---[\r\n]+)([\S\s]*?)([\r\n]+---(\r\n|\n|$))")
+
+
+class RepoCard:
+    card_data_class = CardData
+    default_template_path = TEMPLATE_MODELCARD_PATH
+    repo_type = "model"
+
+    def __init__(self, content: str, ignore_metadata_errors: bool = False):
+        """Initialize a RepoCard from string content. The content should be a
+        Markdown file with a YAML block at the beginning and a Markdown body.
+
+        Args:
+            content (`str`): The content of the Markdown file.
+
+        Example:
+            ```python
+            >>> from huggingface_hub.repocard import RepoCard
+            >>> text = '''
+            ... ---
+            ... language: en
+            ... license: mit
+            ... ---
+            ...
+            ... # My repo
+            ... '''
+            >>> card = RepoCard(text)
+            >>> card.data.to_dict()
+            {'language': 'en', 'license': 'mit'}
+            >>> card.text
+            '\\n# My repo\\n'
+
+            ```
+        <Tip>
+        Raises the following error:
+
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              when the content of the repo card metadata is not a dictionary.
+
+        </Tip>
+        """
+
+        # Set the content of the RepoCard, as well as underlying .data and .text attributes.
+        # See the `content` property setter for more details.
+        self.ignore_metadata_errors = ignore_metadata_errors
+        self.content = content
+
+    @property
+    def content(self):
+        """The content of the RepoCard, including the YAML block and the Markdown body."""
+        line_break = _detect_line_ending(self._content) or "\n"
+        return f"---{line_break}{self.data.to_yaml(line_break=line_break)}{line_break}---{line_break}{self.text}"
+
+    @content.setter
+    def content(self, content: str):
+        """Set the content of the RepoCard."""
+        self._content = content
+
+        match = REGEX_YAML_BLOCK.search(content)
+        if match:
+            # Metadata found in the YAML block
+            yaml_block = match.group(2)
+            self.text = content[match.end() :]
+            data_dict = yaml.safe_load(yaml_block)
+
+            if data_dict is None:
+                data_dict = {}
+
+            # The YAML block's data should be a dictionary
+            if not isinstance(data_dict, dict):
+                raise ValueError("repo card metadata block should be a dict")
+        else:
+            # Model card without metadata... create empty metadata
+            logger.warning("Repo card metadata block was not found. Setting CardData to empty.")
+            data_dict = {}
+            self.text = content
+
+        self.data = self.card_data_class(**data_dict, ignore_metadata_errors=self.ignore_metadata_errors)
+
+    def __str__(self):
+        return self.content
+
+    def save(self, filepath: Union[Path, str]):
+        r"""Save a RepoCard to a file.
+
+        Args:
+            filepath (`Union[Path, str]`): Filepath to the markdown file to save.
+
+        Example:
+            ```python
+            >>> from huggingface_hub.repocard import RepoCard
+            >>> card = RepoCard("---\nlanguage: en\n---\n# This is a test repo card")
+            >>> card.save("/tmp/test.md")
+
+            ```
+        """
+        filepath = Path(filepath)
+        filepath.parent.mkdir(parents=True, exist_ok=True)
+        # Preserve newlines as in the existing file.
+        with open(filepath, mode="w", newline="", encoding="utf-8") as f:
+            f.write(str(self))
+
+    @classmethod
+    def load(
+        cls,
+        repo_id_or_path: Union[str, Path],
+        repo_type: Optional[str] = None,
+        token: Optional[str] = None,
+        ignore_metadata_errors: bool = False,
+    ):
+        """Initialize a RepoCard from a Hugging Face Hub repo's README.md or a local filepath.
+
+        Args:
+            repo_id_or_path (`Union[str, Path]`):
+                The repo ID associated with a Hugging Face Hub repo or a local filepath.
+            repo_type (`str`, *optional*):
+                The type of Hugging Face repo to push to. Defaults to None, which will use use "model". Other options
+                are "dataset" and "space". Not used when loading from a local filepath. If this is called from a child
+                class, the default value will be the child class's `repo_type`.
+            token (`str`, *optional*):
+                Authentication token, obtained with `huggingface_hub.HfApi.login` method. Will default to the stored token.
+            ignore_metadata_errors (`str`):
+                If True, errors while parsing the metadata section will be ignored. Some information might be lost during
+                the process. Use it at your own risk.
+
+        Returns:
+            [`huggingface_hub.repocard.RepoCard`]: The RepoCard (or subclass) initialized from the repo's
+                README.md file or filepath.
+
+        Example:
+            ```python
+            >>> from huggingface_hub.repocard import RepoCard
+            >>> card = RepoCard.load("nateraw/food")
+            >>> assert card.data.tags == ["generated_from_trainer", "image-classification", "pytorch"]
+
+            ```
+        """
+
+        if Path(repo_id_or_path).exists():
+            card_path = Path(repo_id_or_path)
+        elif isinstance(repo_id_or_path, str):
+            card_path = Path(
+                hf_hub_download(
+                    repo_id_or_path,
+                    REPOCARD_NAME,
+                    repo_type=repo_type or cls.repo_type,
+                    token=token,
+                )
+            )
+        else:
+            raise ValueError(f"Cannot load RepoCard: path not found on disk ({repo_id_or_path}).")
+
+        # Preserve newlines in the existing file.
+        with card_path.open(mode="r", newline="", encoding="utf-8") as f:
+            return cls(f.read(), ignore_metadata_errors=ignore_metadata_errors)
+
+    def validate(self, repo_type: Optional[str] = None):
+        """Validates card against Hugging Face Hub's card validation logic.
+        Using this function requires access to the internet, so it is only called
+        internally by [`huggingface_hub.repocard.RepoCard.push_to_hub`].
+
+        Args:
+            repo_type (`str`, *optional*, defaults to "model"):
+                The type of Hugging Face repo to push to. Options are "model", "dataset", and "space".
+                If this function is called from a child class, the default will be the child class's `repo_type`.
+
+        <Tip>
+        Raises the following errors:
+
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              if the card fails validation checks.
+            - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
+              if the request to the Hub API fails for any other reason.
+
+        </Tip>
+        """
+
+        # If repo type is provided, otherwise, use the repo type of the card.
+        repo_type = repo_type or self.repo_type
+
+        body = {
+            "repoType": repo_type,
+            "content": str(self),
+        }
+        headers = {"Accept": "text/plain"}
+
+        try:
+            r = get_session().post("https://huggingface.co/api/validate-yaml", body, headers=headers)
+            r.raise_for_status()
+        except requests.exceptions.HTTPError as exc:
+            if r.status_code == 400:
+                raise ValueError(r.text)
+            else:
+                raise exc
+
+    def push_to_hub(
+        self,
+        repo_id: str,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        commit_message: Optional[str] = None,
+        commit_description: Optional[str] = None,
+        revision: Optional[str] = None,
+        create_pr: Optional[bool] = None,
+        parent_commit: Optional[str] = None,
+    ):
+        """Push a RepoCard to a Hugging Face Hub repo.
+
+        Args:
+            repo_id (`str`):
+                The repo ID of the Hugging Face Hub repo to push to. Example: "nateraw/food".
+            token (`str`, *optional*):
+                Authentication token, obtained with `huggingface_hub.HfApi.login` method. Will default to
+                the stored token.
+            repo_type (`str`, *optional*, defaults to "model"):
+                The type of Hugging Face repo to push to. Options are "model", "dataset", and "space". If this
+                function is called by a child class, it will default to the child class's `repo_type`.
+            commit_message (`str`, *optional*):
+                The summary / title / first line of the generated commit.
+            commit_description (`str`, *optional*)
+                The description of the generated commit.
+            revision (`str`, *optional*):
+                The git revision to commit from. Defaults to the head of the `"main"` branch.
+            create_pr (`bool`, *optional*):
+                Whether or not to create a Pull Request with this commit. Defaults to `False`.
+            parent_commit (`str`, *optional*):
+                The OID / SHA of the parent commit, as a hexadecimal string. Shorthands (7 first characters) are also supported.
+                If specified and `create_pr` is `False`, the commit will fail if `revision` does not point to `parent_commit`.
+                If specified and `create_pr` is `True`, the pull request will be created from `parent_commit`.
+                Specifying `parent_commit` ensures the repo has not changed before committing the changes, and can be
+                especially useful if the repo is updated / committed to concurrently.
+        Returns:
+            `str`: URL of the commit which updated the card metadata.
+        """
+
+        # If repo type is provided, otherwise, use the repo type of the card.
+        repo_type = repo_type or self.repo_type
+
+        # Validate card before pushing to hub
+        self.validate(repo_type=repo_type)
+
+        with SoftTemporaryDirectory() as tmpdir:
+            tmp_path = Path(tmpdir) / REPOCARD_NAME
+            tmp_path.write_text(str(self))
+            url = upload_file(
+                path_or_fileobj=str(tmp_path),
+                path_in_repo=REPOCARD_NAME,
+                repo_id=repo_id,
+                token=token,
+                repo_type=repo_type,
+                commit_message=commit_message,
+                commit_description=commit_description,
+                create_pr=create_pr,
+                revision=revision,
+                parent_commit=parent_commit,
+            )
+        return url
+
+    @classmethod
+    def from_template(
+        cls,
+        card_data: CardData,
+        template_path: Optional[str] = None,
+        template_str: Optional[str] = None,
+        **template_kwargs,
+    ):
+        """Initialize a RepoCard from a template. By default, it uses the default template.
+
+        Templates are Jinja2 templates that can be customized by passing keyword arguments.
+
+        Args:
+            card_data (`huggingface_hub.CardData`):
+                A huggingface_hub.CardData instance containing the metadata you want to include in the YAML
+                header of the repo card on the Hugging Face Hub.
+            template_path (`str`, *optional*):
+                A path to a markdown file with optional Jinja template variables that can be filled
+                in with `template_kwargs`. Defaults to the default template.
+
+        Returns:
+            [`huggingface_hub.repocard.RepoCard`]: A RepoCard instance with the specified card data and content from the
+            template.
+        """
+        if is_jinja_available():
+            import jinja2
+        else:
+            raise ImportError(
+                "Using RepoCard.from_template requires Jinja2 to be installed. Please"
+                " install it with `pip install Jinja2`."
+            )
+
+        kwargs = card_data.to_dict().copy()
+        kwargs.update(template_kwargs)  # Template_kwargs have priority
+
+        if template_path is not None:
+            template_str = Path(template_path).read_text()
+        if template_str is None:
+            template_str = Path(cls.default_template_path).read_text()
+        template = jinja2.Template(template_str)
+        content = template.render(card_data=card_data.to_yaml(), **kwargs)
+        return cls(content)
+
+
+class ModelCard(RepoCard):
+    card_data_class = ModelCardData
+    default_template_path = TEMPLATE_MODELCARD_PATH
+    repo_type = "model"
+
+    @classmethod
+    def from_template(  # type: ignore # violates Liskov property but easier to use
+        cls,
+        card_data: ModelCardData,
+        template_path: Optional[str] = None,
+        template_str: Optional[str] = None,
+        **template_kwargs,
+    ):
+        """Initialize a ModelCard from a template. By default, it uses the default template, which can be found here:
+        https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/templates/modelcard_template.md
+
+        Templates are Jinja2 templates that can be customized by passing keyword arguments.
+
+        Args:
+            card_data (`huggingface_hub.ModelCardData`):
+                A huggingface_hub.ModelCardData instance containing the metadata you want to include in the YAML
+                header of the model card on the Hugging Face Hub.
+            template_path (`str`, *optional*):
+                A path to a markdown file with optional Jinja template variables that can be filled
+                in with `template_kwargs`. Defaults to the default template.
+
+        Returns:
+            [`huggingface_hub.ModelCard`]: A ModelCard instance with the specified card data and content from the
+            template.
+
+        Example:
+            ```python
+            >>> from huggingface_hub import ModelCard, ModelCardData, EvalResult
+
+            >>> # Using the Default Template
+            >>> card_data = ModelCardData(
+            ...     language='en',
+            ...     license='mit',
+            ...     library_name='timm',
+            ...     tags=['image-classification', 'resnet'],
+            ...     datasets=['beans'],
+            ...     metrics=['accuracy'],
+            ... )
+            >>> card = ModelCard.from_template(
+            ...     card_data,
+            ...     model_description='This model does x + y...'
+            ... )
+
+            >>> # Including Evaluation Results
+            >>> card_data = ModelCardData(
+            ...     language='en',
+            ...     tags=['image-classification', 'resnet'],
+            ...     eval_results=[
+            ...         EvalResult(
+            ...             task_type='image-classification',
+            ...             dataset_type='beans',
+            ...             dataset_name='Beans',
+            ...             metric_type='accuracy',
+            ...             metric_value=0.9,
+            ...         ),
+            ...     ],
+            ...     model_name='my-cool-model',
+            ... )
+            >>> card = ModelCard.from_template(card_data)
+
+            >>> # Using a Custom Template
+            >>> card_data = ModelCardData(
+            ...     language='en',
+            ...     tags=['image-classification', 'resnet']
+            ... )
+            >>> card = ModelCard.from_template(
+            ...     card_data=card_data,
+            ...     template_path='./src/huggingface_hub/templates/modelcard_template.md',
+            ...     custom_template_var='custom value',  # will be replaced in template if it exists
+            ... )
+
+            ```
+        """
+        return super().from_template(card_data, template_path, template_str, **template_kwargs)
+
+
+class DatasetCard(RepoCard):
+    card_data_class = DatasetCardData
+    default_template_path = TEMPLATE_DATASETCARD_PATH
+    repo_type = "dataset"
+
+    @classmethod
+    def from_template(  # type: ignore # violates Liskov property but easier to use
+        cls,
+        card_data: DatasetCardData,
+        template_path: Optional[str] = None,
+        template_str: Optional[str] = None,
+        **template_kwargs,
+    ):
+        """Initialize a DatasetCard from a template. By default, it uses the default template, which can be found here:
+        https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/templates/datasetcard_template.md
+
+        Templates are Jinja2 templates that can be customized by passing keyword arguments.
+
+        Args:
+            card_data (`huggingface_hub.DatasetCardData`):
+                A huggingface_hub.DatasetCardData instance containing the metadata you want to include in the YAML
+                header of the dataset card on the Hugging Face Hub.
+            template_path (`str`, *optional*):
+                A path to a markdown file with optional Jinja template variables that can be filled
+                in with `template_kwargs`. Defaults to the default template.
+
+        Returns:
+            [`huggingface_hub.DatasetCard`]: A DatasetCard instance with the specified card data and content from the
+            template.
+
+        Example:
+            ```python
+            >>> from huggingface_hub import DatasetCard, DatasetCardData
+
+            >>> # Using the Default Template
+            >>> card_data = DatasetCardData(
+            ...     language='en',
+            ...     license='mit',
+            ...     annotations_creators='crowdsourced',
+            ...     task_categories=['text-classification'],
+            ...     task_ids=['sentiment-classification', 'text-scoring'],
+            ...     multilinguality='monolingual',
+            ...     pretty_name='My Text Classification Dataset',
+            ... )
+            >>> card = DatasetCard.from_template(
+            ...     card_data,
+            ...     pretty_name=card_data.pretty_name,
+            ... )
+
+            >>> # Using a Custom Template
+            >>> card_data = DatasetCardData(
+            ...     language='en',
+            ...     license='mit',
+            ... )
+            >>> card = DatasetCard.from_template(
+            ...     card_data=card_data,
+            ...     template_path='./src/huggingface_hub/templates/datasetcard_template.md',
+            ...     custom_template_var='custom value',  # will be replaced in template if it exists
+            ... )
+
+            ```
+        """
+        return super().from_template(card_data, template_path, template_str, **template_kwargs)
+
+
+class SpaceCard(RepoCard):
+    card_data_class = SpaceCardData
+    default_template_path = TEMPLATE_MODELCARD_PATH
+    repo_type = "space"
+
+
+def _detect_line_ending(content: str) -> Literal["\r", "\n", "\r\n", None]:  # noqa: F722
+    """Detect the line ending of a string. Used by RepoCard to avoid making huge diff on newlines.
+
+    Uses same implementation as in Hub server, keep it in sync.
+
+    Returns:
+        str: The detected line ending of the string.
+    """
+    cr = content.count("\r")
+    lf = content.count("\n")
+    crlf = content.count("\r\n")
+    if cr + lf == 0:
+        return None
+    if crlf == cr and crlf == lf:
+        return "\r\n"
+    if cr > lf:
+        return "\r"
+    else:
+        return "\n"
+
+
+def metadata_load(local_path: Union[str, Path]) -> Optional[Dict]:
+    content = Path(local_path).read_text()
+    match = REGEX_YAML_BLOCK.search(content)
+    if match:
+        yaml_block = match.group(2)
+        data = yaml.safe_load(yaml_block)
+        if data is None or isinstance(data, dict):
+            return data
+        raise ValueError("repo card metadata block should be a dict")
+    else:
+        return None
+
+
+def metadata_save(local_path: Union[str, Path], data: Dict) -> None:
+    """
+    Save the metadata dict in the upper YAML part Trying to preserve newlines as
+    in the existing file. Docs about open() with newline="" parameter:
+    https://docs.python.org/3/library/functions.html?highlight=open#open Does
+    not work with "^M" linebreaks, which are replaced by \n
+    """
+    line_break = "\n"
+    content = ""
+    # try to detect existing newline character
+    if os.path.exists(local_path):
+        with open(local_path, "r", newline="", encoding="utf8") as readme:
+            content = readme.read()
+            if isinstance(readme.newlines, tuple):
+                line_break = readme.newlines[0]
+            elif isinstance(readme.newlines, str):
+                line_break = readme.newlines
+
+    # creates a new file if it not
+    with open(local_path, "w", newline="", encoding="utf8") as readme:
+        data_yaml = yaml_dump(data, sort_keys=False, line_break=line_break)
+        # sort_keys: keep dict order
+        match = REGEX_YAML_BLOCK.search(content)
+        if match:
+            output = content[: match.start()] + f"---{line_break}{data_yaml}---{line_break}" + content[match.end() :]
+        else:
+            output = f"---{line_break}{data_yaml}---{line_break}{content}"
+
+        readme.write(output)
+        readme.close()
+
+
+def metadata_eval_result(
+    *,
+    model_pretty_name: str,
+    task_pretty_name: str,
+    task_id: str,
+    metrics_pretty_name: str,
+    metrics_id: str,
+    metrics_value: Any,
+    dataset_pretty_name: str,
+    dataset_id: str,
+    metrics_config: Optional[str] = None,
+    metrics_verified: bool = False,
+    dataset_config: Optional[str] = None,
+    dataset_split: Optional[str] = None,
+    dataset_revision: Optional[str] = None,
+    metrics_verification_token: Optional[str] = None,
+) -> Dict:
+    """
+    Creates a metadata dict with the result from a model evaluated on a dataset.
+
+    Args:
+        model_pretty_name (`str`):
+            The name of the model in natural language.
+        task_pretty_name (`str`):
+            The name of a task in natural language.
+        task_id (`str`):
+            Example: automatic-speech-recognition. A task id.
+        metrics_pretty_name (`str`):
+            A name for the metric in natural language. Example: Test WER.
+        metrics_id (`str`):
+            Example: wer. A metric id from https://hf.co/metrics.
+        metrics_value (`Any`):
+            The value from the metric. Example: 20.0 or "20.0 ± 1.2".
+        dataset_pretty_name (`str`):
+            The name of the dataset in natural language.
+        dataset_id (`str`):
+            Example: common_voice. A dataset id from https://hf.co/datasets.
+        metrics_config (`str`, *optional*):
+            The name of the metric configuration used in `load_metric()`.
+            Example: bleurt-large-512 in `load_metric("bleurt", "bleurt-large-512")`.
+        metrics_verified (`bool`, *optional*, defaults to `False`):
+            Indicates whether the metrics originate from Hugging Face's [evaluation service](https://huggingface.co/spaces/autoevaluate/model-evaluator) or not. Automatically computed by Hugging Face, do not set.
+        dataset_config (`str`, *optional*):
+            Example: fr. The name of the dataset configuration used in `load_dataset()`.
+        dataset_split (`str`, *optional*):
+            Example: test. The name of the dataset split used in `load_dataset()`.
+        dataset_revision (`str`, *optional*):
+            Example: 5503434ddd753f426f4b38109466949a1217c2bb. The name of the dataset dataset revision
+            used in `load_dataset()`.
+        metrics_verification_token (`bool`, *optional*):
+            A JSON Web Token that is used to verify whether the metrics originate from Hugging Face's [evaluation service](https://huggingface.co/spaces/autoevaluate/model-evaluator) or not.
+
+    Returns:
+        `dict`: a metadata dict with the result from a model evaluated on a dataset.
+
+    Example:
+        ```python
+        >>> from huggingface_hub import metadata_eval_result
+        >>> results = metadata_eval_result(
+        ...         model_pretty_name="RoBERTa fine-tuned on ReactionGIF",
+        ...         task_pretty_name="Text Classification",
+        ...         task_id="text-classification",
+        ...         metrics_pretty_name="Accuracy",
+        ...         metrics_id="accuracy",
+        ...         metrics_value=0.2662102282047272,
+        ...         dataset_pretty_name="ReactionJPEG",
+        ...         dataset_id="julien-c/reactionjpeg",
+        ...         dataset_config="default",
+        ...         dataset_split="test",
+        ... )
+        >>> results == {
+        ...     'model-index': [
+        ...         {
+        ...             'name': 'RoBERTa fine-tuned on ReactionGIF',
+        ...             'results': [
+        ...                 {
+        ...                     'task': {
+        ...                         'type': 'text-classification',
+        ...                         'name': 'Text Classification'
+        ...                     },
+        ...                     'dataset': {
+        ...                         'name': 'ReactionJPEG',
+        ...                         'type': 'julien-c/reactionjpeg',
+        ...                         'config': 'default',
+        ...                         'split': 'test'
+        ...                     },
+        ...                     'metrics': [
+        ...                         {
+        ...                             'type': 'accuracy',
+        ...                             'value': 0.2662102282047272,
+        ...                             'name': 'Accuracy',
+        ...                             'verified': False
+        ...                         }
+        ...                     ]
+        ...                 }
+        ...             ]
+        ...         }
+        ...     ]
+        ... }
+        True
+
+        ```
+    """
+
+    return {
+        "model-index": eval_results_to_model_index(
+            model_name=model_pretty_name,
+            eval_results=[
+                EvalResult(
+                    task_name=task_pretty_name,
+                    task_type=task_id,
+                    metric_name=metrics_pretty_name,
+                    metric_type=metrics_id,
+                    metric_value=metrics_value,
+                    dataset_name=dataset_pretty_name,
+                    dataset_type=dataset_id,
+                    metric_config=metrics_config,
+                    verified=metrics_verified,
+                    verify_token=metrics_verification_token,
+                    dataset_config=dataset_config,
+                    dataset_split=dataset_split,
+                    dataset_revision=dataset_revision,
+                )
+            ],
+        )
+    }
+
+
+@validate_hf_hub_args
+def metadata_update(
+    repo_id: str,
+    metadata: Dict,
+    *,
+    repo_type: Optional[str] = None,
+    overwrite: bool = False,
+    token: Optional[str] = None,
+    commit_message: Optional[str] = None,
+    commit_description: Optional[str] = None,
+    revision: Optional[str] = None,
+    create_pr: bool = False,
+    parent_commit: Optional[str] = None,
+) -> str:
+    """
+    Updates the metadata in the README.md of a repository on the Hugging Face Hub.
+    If the README.md file doesn't exist yet, a new one is created with metadata and an
+    the default ModelCard or DatasetCard template. For `space` repo, an error is thrown
+    as a Space cannot exist without a `README.md` file.
+
+    Args:
+        repo_id (`str`):
+            The name of the repository.
+        metadata (`dict`):
+            A dictionary containing the metadata to be updated.
+        repo_type (`str`, *optional*):
+            Set to `"dataset"` or `"space"` if updating to a dataset or space,
+            `None` or `"model"` if updating to a model. Default is `None`.
+        overwrite (`bool`, *optional*, defaults to `False`):
+            If set to `True` an existing field can be overwritten, otherwise
+            attempting to overwrite an existing field will cause an error.
+        token (`str`, *optional*):
+            The Hugging Face authentication token.
+        commit_message (`str`, *optional*):
+            The summary / title / first line of the generated commit. Defaults to
+            `f"Update metadata with huggingface_hub"`
+        commit_description (`str` *optional*)
+            The description of the generated commit
+        revision (`str`, *optional*):
+            The git revision to commit from. Defaults to the head of the
+            `"main"` branch.
+        create_pr (`boolean`, *optional*):
+            Whether or not to create a Pull Request from `revision` with that commit.
+            Defaults to `False`.
+        parent_commit (`str`, *optional*):
+            The OID / SHA of the parent commit, as a hexadecimal string. Shorthands (7 first characters) are also supported.
+            If specified and `create_pr` is `False`, the commit will fail if `revision` does not point to `parent_commit`.
+            If specified and `create_pr` is `True`, the pull request will be created from `parent_commit`.
+            Specifying `parent_commit` ensures the repo has not changed before committing the changes, and can be
+            especially useful if the repo is updated / committed to concurrently.
+    Returns:
+        `str`: URL of the commit which updated the card metadata.
+
+    Example:
+        ```python
+        >>> from huggingface_hub import metadata_update
+        >>> metadata = {'model-index': [{'name': 'RoBERTa fine-tuned on ReactionGIF',
+        ...             'results': [{'dataset': {'name': 'ReactionGIF',
+        ...                                      'type': 'julien-c/reactiongif'},
+        ...                           'metrics': [{'name': 'Recall',
+        ...                                        'type': 'recall',
+        ...                                        'value': 0.7762102282047272}],
+        ...                          'task': {'name': 'Text Classification',
+        ...                                   'type': 'text-classification'}}]}]}
+        >>> url = metadata_update("hf-internal-testing/reactiongif-roberta-card", metadata)
+
+        ```
+    """
+    commit_message = commit_message if commit_message is not None else "Update metadata with huggingface_hub"
+
+    # Card class given repo_type
+    card_class: Type[RepoCard]
+    if repo_type is None or repo_type == "model":
+        card_class = ModelCard
+    elif repo_type == "dataset":
+        card_class = DatasetCard
+    elif repo_type == "space":
+        card_class = RepoCard
+    else:
+        raise ValueError(f"Unknown repo_type: {repo_type}")
+
+    # Either load repo_card from the Hub or create an empty one.
+    # NOTE: Will not create the repo if it doesn't exist.
+    try:
+        card = card_class.load(repo_id, token=token, repo_type=repo_type)
+    except EntryNotFoundError:
+        if repo_type == "space":
+            raise ValueError("Cannot update metadata on a Space that doesn't contain a `README.md` file.")
+
+        # Initialize a ModelCard or DatasetCard from default template and no data.
+        card = card_class.from_template(CardData())
+
+    for key, value in metadata.items():
+        if key == "model-index":
+            # if the new metadata doesn't include a name, either use existing one or repo name
+            if "name" not in value[0]:
+                value[0]["name"] = getattr(card, "model_name", repo_id)
+            model_name, new_results = model_index_to_eval_results(value)
+            if card.data.eval_results is None:
+                card.data.eval_results = new_results
+                card.data.model_name = model_name
+            else:
+                existing_results = card.data.eval_results
+
+                # Iterate over new results
+                #   Iterate over existing results
+                #       If both results describe the same metric but value is different:
+                #           If overwrite=True: overwrite the metric value
+                #           Else: raise ValueError
+                #       Else: append new result to existing ones.
+                for new_result in new_results:
+                    result_found = False
+                    for existing_result in existing_results:
+                        if new_result.is_equal_except_value(existing_result):
+                            if new_result != existing_result and not overwrite:
+                                raise ValueError(
+                                    "You passed a new value for the existing metric"
+                                    f" 'name: {new_result.metric_name}, type: "
+                                    f"{new_result.metric_type}'. Set `overwrite=True`"
+                                    " to overwrite existing metrics."
+                                )
+                            result_found = True
+                            existing_result.metric_value = new_result.metric_value
+                            if existing_result.verified is True:
+                                existing_result.verify_token = new_result.verify_token
+                    if not result_found:
+                        card.data.eval_results.append(new_result)
+        else:
+            # Any metadata that is not a result metric
+            if card.data.get(key) is not None and not overwrite and card.data.get(key) != value:
+                raise ValueError(
+                    f"You passed a new value for the existing meta data field '{key}'."
+                    " Set `overwrite=True` to overwrite existing metadata."
+                )
+            else:
+                card.data[key] = value
+
+    return card.push_to_hub(
+        repo_id,
+        token=token,
+        repo_type=repo_type,
+        commit_message=commit_message,
+        commit_description=commit_description,
+        create_pr=create_pr,
+        revision=revision,
+        parent_commit=parent_commit,
+    )
diff --git a/llm/Lib/site-packages/huggingface_hub/repocard_data.py b/llm/Lib/site-packages/huggingface_hub/repocard_data.py
new file mode 100644
index 0000000000000000000000000000000000000000..c85c450cdbad00f1e2850fab431b3b22862a8539
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/repocard_data.py
@@ -0,0 +1,729 @@
+import copy
+from collections import defaultdict
+from dataclasses import dataclass
+from typing import Any, Dict, List, Optional, Tuple, Union
+
+from huggingface_hub.utils import logging, yaml_dump
+
+
+logger = logging.get_logger(__name__)
+
+
+@dataclass
+class EvalResult:
+    """
+    Flattened representation of individual evaluation results found in model-index of Model Cards.
+
+    For more information on the model-index spec, see https://github.com/huggingface/hub-docs/blob/main/modelcard.md?plain=1.
+
+    Args:
+        task_type (`str`):
+            The task identifier. Example: "image-classification".
+        dataset_type (`str`):
+            The dataset identifier. Example: "common_voice". Use dataset id from https://hf.co/datasets.
+        dataset_name (`str`):
+            A pretty name for the dataset. Example: "Common Voice (French)".
+        metric_type (`str`):
+            The metric identifier. Example: "wer". Use metric id from https://hf.co/metrics.
+        metric_value (`Any`):
+            The metric value. Example: 0.9 or "20.0 ± 1.2".
+        task_name (`str`, *optional*):
+            A pretty name for the task. Example: "Speech Recognition".
+        dataset_config (`str`, *optional*):
+            The name of the dataset configuration used in `load_dataset()`.
+            Example: fr in `load_dataset("common_voice", "fr")`. See the `datasets` docs for more info:
+            https://hf.co/docs/datasets/package_reference/loading_methods#datasets.load_dataset.name
+        dataset_split (`str`, *optional*):
+            The split used in `load_dataset()`. Example: "test".
+        dataset_revision (`str`, *optional*):
+            The revision (AKA Git Sha) of the dataset used in `load_dataset()`.
+            Example: 5503434ddd753f426f4b38109466949a1217c2bb
+        dataset_args (`Dict[str, Any]`, *optional*):
+            The arguments passed during `Metric.compute()`. Example for `bleu`: `{"max_order": 4}`
+        metric_name (`str`, *optional*):
+            A pretty name for the metric. Example: "Test WER".
+        metric_config (`str`, *optional*):
+            The name of the metric configuration used in `load_metric()`.
+            Example: bleurt-large-512 in `load_metric("bleurt", "bleurt-large-512")`.
+            See the `datasets` docs for more info: https://huggingface.co/docs/datasets/v2.1.0/en/loading#load-configurations
+        metric_args (`Dict[str, Any]`, *optional*):
+            The arguments passed during `Metric.compute()`. Example for `bleu`: max_order: 4
+        verified (`bool`, *optional*):
+            Indicates whether the metrics originate from Hugging Face's [evaluation service](https://huggingface.co/spaces/autoevaluate/model-evaluator) or not. Automatically computed by Hugging Face, do not set.
+        verify_token (`str`, *optional*):
+            A JSON Web Token that is used to verify whether the metrics originate from Hugging Face's [evaluation service](https://huggingface.co/spaces/autoevaluate/model-evaluator) or not.
+        source_name (`str`, *optional*):
+            The name of the source of the evaluation result. Example: "Open LLM Leaderboard".
+        source_url (`str`, *optional*):
+            The URL of the source of the evaluation result. Example: "https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard".
+    """
+
+    # Required
+
+    # The task identifier
+    # Example: automatic-speech-recognition
+    task_type: str
+
+    # The dataset identifier
+    # Example: common_voice. Use dataset id from https://hf.co/datasets
+    dataset_type: str
+
+    # A pretty name for the dataset.
+    # Example: Common Voice (French)
+    dataset_name: str
+
+    # The metric identifier
+    # Example: wer. Use metric id from https://hf.co/metrics
+    metric_type: str
+
+    # Value of the metric.
+    # Example: 20.0 or "20.0 ± 1.2"
+    metric_value: Any
+
+    # Optional
+
+    # A pretty name for the task.
+    # Example: Speech Recognition
+    task_name: Optional[str] = None
+
+    # The name of the dataset configuration used in `load_dataset()`.
+    # Example: fr in `load_dataset("common_voice", "fr")`.
+    # See the `datasets` docs for more info:
+    # https://huggingface.co/docs/datasets/package_reference/loading_methods#datasets.load_dataset.name
+    dataset_config: Optional[str] = None
+
+    # The split used in `load_dataset()`.
+    # Example: test
+    dataset_split: Optional[str] = None
+
+    # The revision (AKA Git Sha) of the dataset used in `load_dataset()`.
+    # Example: 5503434ddd753f426f4b38109466949a1217c2bb
+    dataset_revision: Optional[str] = None
+
+    # The arguments passed during `Metric.compute()`.
+    # Example for `bleu`: max_order: 4
+    dataset_args: Optional[Dict[str, Any]] = None
+
+    # A pretty name for the metric.
+    # Example: Test WER
+    metric_name: Optional[str] = None
+
+    # The name of the metric configuration used in `load_metric()`.
+    # Example: bleurt-large-512 in `load_metric("bleurt", "bleurt-large-512")`.
+    # See the `datasets` docs for more info: https://huggingface.co/docs/datasets/v2.1.0/en/loading#load-configurations
+    metric_config: Optional[str] = None
+
+    # The arguments passed during `Metric.compute()`.
+    # Example for `bleu`: max_order: 4
+    metric_args: Optional[Dict[str, Any]] = None
+
+    # Indicates whether the metrics originate from Hugging Face's [evaluation service](https://huggingface.co/spaces/autoevaluate/model-evaluator) or not. Automatically computed by Hugging Face, do not set.
+    verified: Optional[bool] = None
+
+    # A JSON Web Token that is used to verify whether the metrics originate from Hugging Face's [evaluation service](https://huggingface.co/spaces/autoevaluate/model-evaluator) or not.
+    verify_token: Optional[str] = None
+
+    # The name of the source of the evaluation result.
+    # Example: Open LLM Leaderboard
+    source_name: Optional[str] = None
+
+    # The URL of the source of the evaluation result.
+    # Example: https://huggingface.co/spaces/HuggingFaceH4/open_llm_leaderboard
+    source_url: Optional[str] = None
+
+    @property
+    def unique_identifier(self) -> tuple:
+        """Returns a tuple that uniquely identifies this evaluation."""
+        return (
+            self.task_type,
+            self.dataset_type,
+            self.dataset_config,
+            self.dataset_split,
+            self.dataset_revision,
+        )
+
+    def is_equal_except_value(self, other: "EvalResult") -> bool:
+        """
+        Return True if `self` and `other` describe exactly the same metric but with a
+        different value.
+        """
+        for key, _ in self.__dict__.items():
+            if key == "metric_value":
+                continue
+            # For metrics computed by Hugging Face's evaluation service, `verify_token` is derived from `metric_value`,
+            # so we exclude it here in the comparison.
+            if key != "verify_token" and getattr(self, key) != getattr(other, key):
+                return False
+        return True
+
+    def __post_init__(self) -> None:
+        if self.source_name is not None and self.source_url is None:
+            raise ValueError("If `source_name` is provided, `source_url` must also be provided.")
+
+
+@dataclass
+class CardData:
+    """Structure containing metadata from a RepoCard.
+
+    [`CardData`] is the parent class of [`ModelCardData`] and [`DatasetCardData`].
+
+    Metadata can be exported as a dictionary or YAML. Export can be customized to alter the representation of the data
+    (example: flatten evaluation results). `CardData` behaves as a dictionary (can get, pop, set values) but do not
+    inherit from `dict` to allow this export step.
+    """
+
+    def __init__(self, ignore_metadata_errors: bool = False, **kwargs):
+        self.__dict__.update(kwargs)
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Converts CardData to a dict.
+
+        Returns:
+            `dict`: CardData represented as a dictionary ready to be dumped to a YAML
+            block for inclusion in a README.md file.
+        """
+
+        data_dict = copy.deepcopy(self.__dict__)
+        self._to_dict(data_dict)
+        return _remove_none(data_dict)
+
+    def _to_dict(self, data_dict):
+        """Use this method in child classes to alter the dict representation of the data. Alter the dict in-place.
+
+        Args:
+            data_dict (`dict`): The raw dict representation of the card data.
+        """
+        pass
+
+    def to_yaml(self, line_break=None) -> str:
+        """Dumps CardData to a YAML block for inclusion in a README.md file.
+
+        Args:
+            line_break (str, *optional*):
+                The line break to use when dumping to yaml.
+
+        Returns:
+            `str`: CardData represented as a YAML block.
+        """
+        return yaml_dump(self.to_dict(), sort_keys=False, line_break=line_break).strip()
+
+    def __repr__(self):
+        return repr(self.__dict__)
+
+    def __str__(self):
+        return self.to_yaml()
+
+    def get(self, key: str, default: Any = None) -> Any:
+        """Get value for a given metadata key."""
+        return self.__dict__.get(key, default)
+
+    def pop(self, key: str, default: Any = None) -> Any:
+        """Pop value for a given metadata key."""
+        return self.__dict__.pop(key, default)
+
+    def __getitem__(self, key: str) -> Any:
+        """Get value for a given metadata key."""
+        return self.__dict__[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        """Set value for a given metadata key."""
+        self.__dict__[key] = value
+
+    def __contains__(self, key: str) -> bool:
+        """Check if a given metadata key is set."""
+        return key in self.__dict__
+
+    def __len__(self) -> int:
+        """Return the number of metadata keys set."""
+        return len(self.__dict__)
+
+
+class ModelCardData(CardData):
+    """Model Card Metadata that is used by Hugging Face Hub when included at the top of your README.md
+
+    Args:
+        language (`Union[str, List[str]]`, *optional*):
+            Language of model's training data or metadata. It must be an ISO 639-1, 639-2 or
+            639-3 code (two/three letters), or a special value like "code", "multilingual". Defaults to `None`.
+        license (`str`, *optional*):
+            License of this model. Example: apache-2.0 or any license from
+            https://huggingface.co/docs/hub/repositories-licenses. Defaults to None.
+        library_name (`str`, *optional*):
+            Name of library used by this model. Example: keras or any library from
+            https://github.com/huggingface/huggingface.js/blob/main/packages/tasks/src/model-libraries.ts.
+            Defaults to None.
+        tags (`List[str]`, *optional*):
+            List of tags to add to your model that can be used when filtering on the Hugging
+            Face Hub. Defaults to None.
+        base_model (`str` or `List[str]`, *optional*):
+            The identifier of the base model from which the model derives. This is applicable for example if your model is a
+            fine-tune or adapter of an existing model. The value must be the ID of a model on the Hub (or a list of IDs
+            if your model derives from multiple models). Defaults to None.
+        datasets (`List[str]`, *optional*):
+            List of datasets that were used to train this model. Should be a dataset ID
+            found on https://hf.co/datasets. Defaults to None.
+        metrics (`List[str]`, *optional*):
+            List of metrics used to evaluate this model. Should be a metric name that can be found
+            at https://hf.co/metrics. Example: 'accuracy'. Defaults to None.
+        eval_results (`Union[List[EvalResult], EvalResult]`, *optional*):
+            List of `huggingface_hub.EvalResult` that define evaluation results of the model. If provided,
+            `model_name` is used to as a name on PapersWithCode's leaderboards. Defaults to `None`.
+        model_name (`str`, *optional*):
+            A name for this model. It is used along with
+            `eval_results` to construct the `model-index` within the card's metadata. The name
+            you supply here is what will be used on PapersWithCode's leaderboards. If None is provided
+            then the repo name is used as a default. Defaults to None.
+        ignore_metadata_errors (`str`):
+            If True, errors while parsing the metadata section will be ignored. Some information might be lost during
+            the process. Use it at your own risk.
+        kwargs (`dict`, *optional*):
+            Additional metadata that will be added to the model card. Defaults to None.
+
+    Example:
+        ```python
+        >>> from huggingface_hub import ModelCardData
+        >>> card_data = ModelCardData(
+        ...     language="en",
+        ...     license="mit",
+        ...     library_name="timm",
+        ...     tags=['image-classification', 'resnet'],
+        ... )
+        >>> card_data.to_dict()
+        {'language': 'en', 'license': 'mit', 'library_name': 'timm', 'tags': ['image-classification', 'resnet']}
+
+        ```
+    """
+
+    def __init__(
+        self,
+        *,
+        language: Optional[Union[str, List[str]]] = None,
+        license: Optional[str] = None,
+        library_name: Optional[str] = None,
+        tags: Optional[List[str]] = None,
+        base_model: Optional[Union[str, List[str]]] = None,
+        datasets: Optional[List[str]] = None,
+        metrics: Optional[List[str]] = None,
+        eval_results: Optional[List[EvalResult]] = None,
+        model_name: Optional[str] = None,
+        ignore_metadata_errors: bool = False,
+        **kwargs,
+    ):
+        self.language = language
+        self.license = license
+        self.library_name = library_name
+        self.tags = _to_unique_list(tags)
+        self.base_model = base_model
+        self.datasets = datasets
+        self.metrics = metrics
+        self.eval_results = eval_results
+        self.model_name = model_name
+
+        model_index = kwargs.pop("model-index", None)
+        if model_index:
+            try:
+                model_name, eval_results = model_index_to_eval_results(model_index)
+                self.model_name = model_name
+                self.eval_results = eval_results
+            except (KeyError, TypeError) as error:
+                if ignore_metadata_errors:
+                    logger.warning("Invalid model-index. Not loading eval results into CardData.")
+                else:
+                    raise ValueError(
+                        f"Invalid `model_index` in metadata cannot be parsed: {error.__class__} {error}. Pass"
+                        " `ignore_metadata_errors=True` to ignore this error while loading a Model Card. Warning:"
+                        " some information will be lost. Use it at your own risk."
+                    )
+
+        super().__init__(**kwargs)
+
+        if self.eval_results:
+            if type(self.eval_results) == EvalResult:
+                self.eval_results = [self.eval_results]
+            if self.model_name is None:
+                raise ValueError("Passing `eval_results` requires `model_name` to be set.")
+
+    def _to_dict(self, data_dict):
+        """Format the internal data dict. In this case, we convert eval results to a valid model index"""
+        if self.eval_results is not None:
+            data_dict["model-index"] = eval_results_to_model_index(self.model_name, self.eval_results)
+            del data_dict["eval_results"], data_dict["model_name"]
+
+
+class DatasetCardData(CardData):
+    """Dataset Card Metadata that is used by Hugging Face Hub when included at the top of your README.md
+
+    Args:
+        language (`List[str]`, *optional*):
+            Language of dataset's data or metadata. It must be an ISO 639-1, 639-2 or
+            639-3 code (two/three letters), or a special value like "code", "multilingual".
+        license (`Union[str, List[str]]`, *optional*):
+            License(s) of this dataset. Example: apache-2.0 or any license from
+            https://huggingface.co/docs/hub/repositories-licenses.
+        annotations_creators (`Union[str, List[str]]`, *optional*):
+            How the annotations for the dataset were created.
+            Options are: 'found', 'crowdsourced', 'expert-generated', 'machine-generated', 'no-annotation', 'other'.
+        language_creators (`Union[str, List[str]]`, *optional*):
+            How the text-based data in the dataset was created.
+            Options are: 'found', 'crowdsourced', 'expert-generated', 'machine-generated', 'other'
+        multilinguality (`Union[str, List[str]]`, *optional*):
+            Whether the dataset is multilingual.
+            Options are: 'monolingual', 'multilingual', 'translation', 'other'.
+        size_categories (`Union[str, List[str]]`, *optional*):
+            The number of examples in the dataset. Options are: 'n<1K', '1K<n<10K', '10K<n<100K',
+            '100K<n<1M', '1M<n<10M', '10M<n<100M', '100M<n<1B', '1B<n<10B', '10B<n<100B', '100B<n<1T', 'n>1T', and 'other'.
+        source_datasets (`List[str]]`, *optional*):
+            Indicates whether the dataset is an original dataset or extended from another existing dataset.
+            Options are: 'original' and 'extended'.
+        task_categories (`Union[str, List[str]]`, *optional*):
+            What categories of task does the dataset support?
+        task_ids (`Union[str, List[str]]`, *optional*):
+            What specific tasks does the dataset support?
+        paperswithcode_id (`str`, *optional*):
+            ID of the dataset on PapersWithCode.
+        pretty_name (`str`, *optional*):
+            A more human-readable name for the dataset. (ex. "Cats vs. Dogs")
+        train_eval_index (`Dict`, *optional*):
+            A dictionary that describes the necessary spec for doing evaluation on the Hub.
+            If not provided, it will be gathered from the 'train-eval-index' key of the kwargs.
+        config_names (`Union[str, List[str]]`, *optional*):
+            A list of the available dataset configs for the dataset.
+    """
+
+    def __init__(
+        self,
+        *,
+        language: Optional[Union[str, List[str]]] = None,
+        license: Optional[Union[str, List[str]]] = None,
+        annotations_creators: Optional[Union[str, List[str]]] = None,
+        language_creators: Optional[Union[str, List[str]]] = None,
+        multilinguality: Optional[Union[str, List[str]]] = None,
+        size_categories: Optional[Union[str, List[str]]] = None,
+        source_datasets: Optional[List[str]] = None,
+        task_categories: Optional[Union[str, List[str]]] = None,
+        task_ids: Optional[Union[str, List[str]]] = None,
+        paperswithcode_id: Optional[str] = None,
+        pretty_name: Optional[str] = None,
+        train_eval_index: Optional[Dict] = None,
+        config_names: Optional[Union[str, List[str]]] = None,
+        ignore_metadata_errors: bool = False,
+        **kwargs,
+    ):
+        self.annotations_creators = annotations_creators
+        self.language_creators = language_creators
+        self.language = language
+        self.license = license
+        self.multilinguality = multilinguality
+        self.size_categories = size_categories
+        self.source_datasets = source_datasets
+        self.task_categories = task_categories
+        self.task_ids = task_ids
+        self.paperswithcode_id = paperswithcode_id
+        self.pretty_name = pretty_name
+        self.config_names = config_names
+
+        # TODO - maybe handle this similarly to EvalResult?
+        self.train_eval_index = train_eval_index or kwargs.pop("train-eval-index", None)
+        super().__init__(**kwargs)
+
+    def _to_dict(self, data_dict):
+        data_dict["train-eval-index"] = data_dict.pop("train_eval_index")
+
+
+class SpaceCardData(CardData):
+    """Space Card Metadata that is used by Hugging Face Hub when included at the top of your README.md
+
+    To get an exhaustive reference of Spaces configuration, please visit https://huggingface.co/docs/hub/spaces-config-reference#spaces-configuration-reference.
+
+    Args:
+        title (`str`, *optional*)
+            Title of the Space.
+        sdk (`str`, *optional*)
+            SDK of the Space (one of `gradio`, `streamlit`, `docker`, or `static`).
+        sdk_version (`str`, *optional*)
+            Version of the used SDK (if Gradio/Streamlit sdk).
+        python_version (`str`, *optional*)
+            Python version used in the Space (if Gradio/Streamlit sdk).
+        app_file (`str`, *optional*)
+            Path to your main application file (which contains either gradio or streamlit Python code, or static html code).
+            Path is relative to the root of the repository.
+        app_port (`str`, *optional*)
+            Port on which your application is running. Used only if sdk is `docker`.
+        license (`str`, *optional*)
+            License of this model. Example: apache-2.0 or any license from
+            https://huggingface.co/docs/hub/repositories-licenses.
+        duplicated_from (`str`, *optional*)
+            ID of the original Space if this is a duplicated Space.
+        models (List[`str`], *optional*)
+            List of models related to this Space. Should be a dataset ID found on https://hf.co/models.
+        datasets (`List[str]`, *optional*)
+            List of datasets related to this Space. Should be a dataset ID found on https://hf.co/datasets.
+        tags (`List[str]`, *optional*)
+            List of tags to add to your Space that can be used when filtering on the Hub.
+        ignore_metadata_errors (`str`):
+            If True, errors while parsing the metadata section will be ignored. Some information might be lost during
+            the process. Use it at your own risk.
+        kwargs (`dict`, *optional*):
+            Additional metadata that will be added to the space card.
+
+    Example:
+        ```python
+        >>> from huggingface_hub import SpaceCardData
+        >>> card_data = SpaceCardData(
+        ...     title="Dreambooth Training",
+        ...     license="mit",
+        ...     sdk="gradio",
+        ...     duplicated_from="multimodalart/dreambooth-training"
+        ... )
+        >>> card_data.to_dict()
+        {'title': 'Dreambooth Training', 'sdk': 'gradio', 'license': 'mit', 'duplicated_from': 'multimodalart/dreambooth-training'}
+        ```
+    """
+
+    def __init__(
+        self,
+        *,
+        title: Optional[str] = None,
+        sdk: Optional[str] = None,
+        sdk_version: Optional[str] = None,
+        python_version: Optional[str] = None,
+        app_file: Optional[str] = None,
+        app_port: Optional[int] = None,
+        license: Optional[str] = None,
+        duplicated_from: Optional[str] = None,
+        models: Optional[List[str]] = None,
+        datasets: Optional[List[str]] = None,
+        tags: Optional[List[str]] = None,
+        ignore_metadata_errors: bool = False,
+        **kwargs,
+    ):
+        self.title = title
+        self.sdk = sdk
+        self.sdk_version = sdk_version
+        self.python_version = python_version
+        self.app_file = app_file
+        self.app_port = app_port
+        self.license = license
+        self.duplicated_from = duplicated_from
+        self.models = models
+        self.datasets = datasets
+        self.tags = _to_unique_list(tags)
+        super().__init__(**kwargs)
+
+
+def model_index_to_eval_results(model_index: List[Dict[str, Any]]) -> Tuple[str, List[EvalResult]]:
+    """Takes in a model index and returns the model name and a list of `huggingface_hub.EvalResult` objects.
+
+    A detailed spec of the model index can be found here:
+    https://github.com/huggingface/hub-docs/blob/main/modelcard.md?plain=1
+
+    Args:
+        model_index (`List[Dict[str, Any]]`):
+            A model index data structure, likely coming from a README.md file on the
+            Hugging Face Hub.
+
+    Returns:
+        model_name (`str`):
+            The name of the model as found in the model index. This is used as the
+            identifier for the model on leaderboards like PapersWithCode.
+        eval_results (`List[EvalResult]`):
+            A list of `huggingface_hub.EvalResult` objects containing the metrics
+            reported in the provided model_index.
+
+    Example:
+        ```python
+        >>> from huggingface_hub.repocard_data import model_index_to_eval_results
+        >>> # Define a minimal model index
+        >>> model_index = [
+        ...     {
+        ...         "name": "my-cool-model",
+        ...         "results": [
+        ...             {
+        ...                 "task": {
+        ...                     "type": "image-classification"
+        ...                 },
+        ...                 "dataset": {
+        ...                     "type": "beans",
+        ...                     "name": "Beans"
+        ...                 },
+        ...                 "metrics": [
+        ...                     {
+        ...                         "type": "accuracy",
+        ...                         "value": 0.9
+        ...                     }
+        ...                 ]
+        ...             }
+        ...         ]
+        ...     }
+        ... ]
+        >>> model_name, eval_results = model_index_to_eval_results(model_index)
+        >>> model_name
+        'my-cool-model'
+        >>> eval_results[0].task_type
+        'image-classification'
+        >>> eval_results[0].metric_type
+        'accuracy'
+
+        ```
+    """
+
+    eval_results = []
+    for elem in model_index:
+        name = elem["name"]
+        results = elem["results"]
+        for result in results:
+            task_type = result["task"]["type"]
+            task_name = result["task"].get("name")
+            dataset_type = result["dataset"]["type"]
+            dataset_name = result["dataset"]["name"]
+            dataset_config = result["dataset"].get("config")
+            dataset_split = result["dataset"].get("split")
+            dataset_revision = result["dataset"].get("revision")
+            dataset_args = result["dataset"].get("args")
+            source_name = result.get("source", {}).get("name")
+            source_url = result.get("source", {}).get("url")
+
+            for metric in result["metrics"]:
+                metric_type = metric["type"]
+                metric_value = metric["value"]
+                metric_name = metric.get("name")
+                metric_args = metric.get("args")
+                metric_config = metric.get("config")
+                verified = metric.get("verified")
+                verify_token = metric.get("verifyToken")
+
+                eval_result = EvalResult(
+                    task_type=task_type,  # Required
+                    dataset_type=dataset_type,  # Required
+                    dataset_name=dataset_name,  # Required
+                    metric_type=metric_type,  # Required
+                    metric_value=metric_value,  # Required
+                    task_name=task_name,
+                    dataset_config=dataset_config,
+                    dataset_split=dataset_split,
+                    dataset_revision=dataset_revision,
+                    dataset_args=dataset_args,
+                    metric_name=metric_name,
+                    metric_args=metric_args,
+                    metric_config=metric_config,
+                    verified=verified,
+                    verify_token=verify_token,
+                    source_name=source_name,
+                    source_url=source_url,
+                )
+                eval_results.append(eval_result)
+    return name, eval_results
+
+
+def _remove_none(obj):
+    """
+    Recursively remove `None` values from a dict. Borrowed from: https://stackoverflow.com/a/20558778
+    """
+    if isinstance(obj, (list, tuple, set)):
+        return type(obj)(_remove_none(x) for x in obj if x is not None)
+    elif isinstance(obj, dict):
+        return type(obj)((_remove_none(k), _remove_none(v)) for k, v in obj.items() if k is not None and v is not None)
+    else:
+        return obj
+
+
+def eval_results_to_model_index(model_name: str, eval_results: List[EvalResult]) -> List[Dict[str, Any]]:
+    """Takes in given model name and list of `huggingface_hub.EvalResult` and returns a
+    valid model-index that will be compatible with the format expected by the
+    Hugging Face Hub.
+
+    Args:
+        model_name (`str`):
+            Name of the model (ex. "my-cool-model"). This is used as the identifier
+            for the model on leaderboards like PapersWithCode.
+        eval_results (`List[EvalResult]`):
+            List of `huggingface_hub.EvalResult` objects containing the metrics to be
+            reported in the model-index.
+
+    Returns:
+        model_index (`List[Dict[str, Any]]`): The eval_results converted to a model-index.
+
+    Example:
+        ```python
+        >>> from huggingface_hub.repocard_data import eval_results_to_model_index, EvalResult
+        >>> # Define minimal eval_results
+        >>> eval_results = [
+        ...     EvalResult(
+        ...         task_type="image-classification",  # Required
+        ...         dataset_type="beans",  # Required
+        ...         dataset_name="Beans",  # Required
+        ...         metric_type="accuracy",  # Required
+        ...         metric_value=0.9,  # Required
+        ...     )
+        ... ]
+        >>> eval_results_to_model_index("my-cool-model", eval_results)
+        [{'name': 'my-cool-model', 'results': [{'task': {'type': 'image-classification'}, 'dataset': {'name': 'Beans', 'type': 'beans'}, 'metrics': [{'type': 'accuracy', 'value': 0.9}]}]}]
+
+        ```
+    """
+
+    # Metrics are reported on a unique task-and-dataset basis.
+    # Here, we make a map of those pairs and the associated EvalResults.
+    task_and_ds_types_map: Dict[Any, List[EvalResult]] = defaultdict(list)
+    for eval_result in eval_results:
+        task_and_ds_types_map[eval_result.unique_identifier].append(eval_result)
+
+    # Use the map from above to generate the model index data.
+    model_index_data = []
+    for results in task_and_ds_types_map.values():
+        # All items from `results` share same metadata
+        sample_result = results[0]
+        data = {
+            "task": {
+                "type": sample_result.task_type,
+                "name": sample_result.task_name,
+            },
+            "dataset": {
+                "name": sample_result.dataset_name,
+                "type": sample_result.dataset_type,
+                "config": sample_result.dataset_config,
+                "split": sample_result.dataset_split,
+                "revision": sample_result.dataset_revision,
+                "args": sample_result.dataset_args,
+            },
+            "metrics": [
+                {
+                    "type": result.metric_type,
+                    "value": result.metric_value,
+                    "name": result.metric_name,
+                    "config": result.metric_config,
+                    "args": result.metric_args,
+                    "verified": result.verified,
+                    "verifyToken": result.verify_token,
+                }
+                for result in results
+            ],
+        }
+        if sample_result.source_url is not None:
+            source = {
+                "url": sample_result.source_url,
+            }
+            if sample_result.source_name is not None:
+                source["name"] = sample_result.source_name
+            data["source"] = source
+        model_index_data.append(data)
+
+    # TODO - Check if there cases where this list is longer than one?
+    # Finally, the model index itself is list of dicts.
+    model_index = [
+        {
+            "name": model_name,
+            "results": model_index_data,
+        }
+    ]
+    return _remove_none(model_index)
+
+
+def _to_unique_list(tags: Optional[List[str]]) -> Optional[List[str]]:
+    if tags is None:
+        return tags
+    unique_tags = []  # make tags unique + keep order explicitly
+    for tag in tags:
+        if tag not in unique_tags:
+            unique_tags.append(tag)
+    return unique_tags
diff --git a/llm/Lib/site-packages/huggingface_hub/repository.py b/llm/Lib/site-packages/huggingface_hub/repository.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7aff2eb66318803ee8c2fa4e3cccb29e0036801
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/repository.py
@@ -0,0 +1,1476 @@
+import atexit
+import os
+import re
+import subprocess
+import threading
+import time
+from contextlib import contextmanager
+from pathlib import Path
+from typing import Callable, Dict, Iterator, List, Optional, Tuple, TypedDict, Union
+from urllib.parse import urlparse
+
+from huggingface_hub.constants import REPO_TYPES_URL_PREFIXES, REPOCARD_NAME
+from huggingface_hub.repocard import metadata_load, metadata_save
+
+from .hf_api import HfApi, repo_type_and_id_from_hf_id
+from .lfs import LFS_MULTIPART_UPLOAD_COMMAND
+from .utils import (
+    SoftTemporaryDirectory,
+    get_token,
+    logging,
+    run_subprocess,
+    tqdm,
+    validate_hf_hub_args,
+)
+from .utils._deprecation import _deprecate_method
+
+
+logger = logging.get_logger(__name__)
+
+
+class CommandInProgress:
+    """
+    Utility to follow commands launched asynchronously.
+    """
+
+    def __init__(
+        self,
+        title: str,
+        is_done_method: Callable,
+        status_method: Callable,
+        process: subprocess.Popen,
+        post_method: Optional[Callable] = None,
+    ):
+        self.title = title
+        self._is_done = is_done_method
+        self._status = status_method
+        self._process = process
+        self._stderr = ""
+        self._stdout = ""
+        self._post_method = post_method
+
+    @property
+    def is_done(self) -> bool:
+        """
+        Whether the process is done.
+        """
+        result = self._is_done()
+
+        if result and self._post_method is not None:
+            self._post_method()
+            self._post_method = None
+
+        return result
+
+    @property
+    def status(self) -> int:
+        """
+        The exit code/status of the current action. Will return `0` if the
+        command has completed successfully, and a number between 1 and 255 if
+        the process errored-out.
+
+        Will return -1 if the command is still ongoing.
+        """
+        return self._status()
+
+    @property
+    def failed(self) -> bool:
+        """
+        Whether the process errored-out.
+        """
+        return self.status > 0
+
+    @property
+    def stderr(self) -> str:
+        """
+        The current output message on the standard error.
+        """
+        if self._process.stderr is not None:
+            self._stderr += self._process.stderr.read()
+        return self._stderr
+
+    @property
+    def stdout(self) -> str:
+        """
+        The current output message on the standard output.
+        """
+        if self._process.stdout is not None:
+            self._stdout += self._process.stdout.read()
+        return self._stdout
+
+    def __repr__(self):
+        status = self.status
+
+        if status == -1:
+            status = "running"
+
+        return (
+            f"[{self.title} command, status code: {status},"
+            f" {'in progress.' if not self.is_done else 'finished.'} PID:"
+            f" {self._process.pid}]"
+        )
+
+
+def is_git_repo(folder: Union[str, Path]) -> bool:
+    """
+    Check if the folder is the root or part of a git repository
+
+    Args:
+        folder (`str`):
+            The folder in which to run the command.
+
+    Returns:
+        `bool`: `True` if the repository is part of a repository, `False`
+        otherwise.
+    """
+    folder_exists = os.path.exists(os.path.join(folder, ".git"))
+    git_branch = subprocess.run("git branch".split(), cwd=folder, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+    return folder_exists and git_branch.returncode == 0
+
+
+def is_local_clone(folder: Union[str, Path], remote_url: str) -> bool:
+    """
+    Check if the folder is a local clone of the remote_url
+
+    Args:
+        folder (`str` or `Path`):
+            The folder in which to run the command.
+        remote_url (`str`):
+            The url of a git repository.
+
+    Returns:
+        `bool`: `True` if the repository is a local clone of the remote
+        repository specified, `False` otherwise.
+    """
+    if not is_git_repo(folder):
+        return False
+
+    remotes = run_subprocess("git remote -v", folder).stdout
+
+    # Remove token for the test with remotes.
+    remote_url = re.sub(r"https://.*@", "https://", remote_url)
+    remotes = [re.sub(r"https://.*@", "https://", remote) for remote in remotes.split()]
+    return remote_url in remotes
+
+
+def is_tracked_with_lfs(filename: Union[str, Path]) -> bool:
+    """
+    Check if the file passed is tracked with git-lfs.
+
+    Args:
+        filename (`str` or `Path`):
+            The filename to check.
+
+    Returns:
+        `bool`: `True` if the file passed is tracked with git-lfs, `False`
+        otherwise.
+    """
+    folder = Path(filename).parent
+    filename = Path(filename).name
+
+    try:
+        p = run_subprocess("git check-attr -a".split() + [filename], folder)
+        attributes = p.stdout.strip()
+    except subprocess.CalledProcessError as exc:
+        if not is_git_repo(folder):
+            return False
+        else:
+            raise OSError(exc.stderr)
+
+    if len(attributes) == 0:
+        return False
+
+    found_lfs_tag = {"diff": False, "merge": False, "filter": False}
+
+    for attribute in attributes.split("\n"):
+        for tag in found_lfs_tag.keys():
+            if tag in attribute and "lfs" in attribute:
+                found_lfs_tag[tag] = True
+
+    return all(found_lfs_tag.values())
+
+
+def is_git_ignored(filename: Union[str, Path]) -> bool:
+    """
+    Check if file is git-ignored. Supports nested .gitignore files.
+
+    Args:
+        filename (`str` or `Path`):
+            The filename to check.
+
+    Returns:
+        `bool`: `True` if the file passed is ignored by `git`, `False`
+        otherwise.
+    """
+    folder = Path(filename).parent
+    filename = Path(filename).name
+
+    try:
+        p = run_subprocess("git check-ignore".split() + [filename], folder, check=False)
+        # Will return exit code 1 if not gitignored
+        is_ignored = not bool(p.returncode)
+    except subprocess.CalledProcessError as exc:
+        raise OSError(exc.stderr)
+
+    return is_ignored
+
+
+def is_binary_file(filename: Union[str, Path]) -> bool:
+    """
+    Check if file is a binary file.
+
+    Args:
+        filename (`str` or `Path`):
+            The filename to check.
+
+    Returns:
+        `bool`: `True` if the file passed is a binary file, `False` otherwise.
+    """
+    try:
+        with open(filename, "rb") as f:
+            content = f.read(10 * (1024**2))  # Read a maximum of 10MB
+
+        # Code sample taken from the following stack overflow thread
+        # https://stackoverflow.com/questions/898669/how-can-i-detect-if-a-file-is-binary-non-text-in-python/7392391#7392391
+        text_chars = bytearray({7, 8, 9, 10, 12, 13, 27} | set(range(0x20, 0x100)) - {0x7F})
+        return bool(content.translate(None, text_chars))
+    except UnicodeDecodeError:
+        return True
+
+
+def files_to_be_staged(pattern: str = ".", folder: Union[str, Path, None] = None) -> List[str]:
+    """
+    Returns a list of filenames that are to be staged.
+
+    Args:
+        pattern (`str` or `Path`):
+            The pattern of filenames to check. Put `.` to get all files.
+        folder (`str` or `Path`):
+            The folder in which to run the command.
+
+    Returns:
+        `List[str]`: List of files that are to be staged.
+    """
+    try:
+        p = run_subprocess("git ls-files --exclude-standard -mo".split() + [pattern], folder)
+        if len(p.stdout.strip()):
+            files = p.stdout.strip().split("\n")
+        else:
+            files = []
+    except subprocess.CalledProcessError as exc:
+        raise EnvironmentError(exc.stderr)
+
+    return files
+
+
+def is_tracked_upstream(folder: Union[str, Path]) -> bool:
+    """
+    Check if the current checked-out branch is tracked upstream.
+
+    Args:
+        folder (`str` or `Path`):
+            The folder in which to run the command.
+
+    Returns:
+        `bool`: `True` if the current checked-out branch is tracked upstream,
+        `False` otherwise.
+    """
+    try:
+        run_subprocess("git rev-parse --symbolic-full-name --abbrev-ref @{u}", folder)
+        return True
+    except subprocess.CalledProcessError as exc:
+        if "HEAD" in exc.stderr:
+            raise OSError("No branch checked out")
+
+        return False
+
+
+def commits_to_push(folder: Union[str, Path], upstream: Optional[str] = None) -> int:
+    """
+        Check the number of commits that would be pushed upstream
+
+        Args:
+            folder (`str` or `Path`):
+                The folder in which to run the command.
+            upstream (`str`, *optional*):
+    The name of the upstream repository with which the comparison should be
+    made.
+
+        Returns:
+            `int`: Number of commits that would be pushed upstream were a `git
+            push` to proceed.
+    """
+    try:
+        result = run_subprocess(f"git cherry -v {upstream or ''}", folder)
+        return len(result.stdout.split("\n")) - 1
+    except subprocess.CalledProcessError as exc:
+        raise EnvironmentError(exc.stderr)
+
+
+class PbarT(TypedDict):
+    # Used to store an opened progress bar in `_lfs_log_progress`
+    bar: tqdm
+    past_bytes: int
+
+
+@contextmanager
+def _lfs_log_progress():
+    """
+    This is a context manager that will log the Git LFS progress of cleaning,
+    smudging, pulling and pushing.
+    """
+
+    if logger.getEffectiveLevel() >= logging.ERROR:
+        try:
+            yield
+        except Exception:
+            pass
+        return
+
+    def output_progress(stopping_event: threading.Event):
+        """
+        To be launched as a separate thread with an event meaning it should stop
+        the tail.
+        """
+        # Key is tuple(state, filename), value is a dict(tqdm bar and a previous value)
+        pbars: Dict[Tuple[str, str], PbarT] = {}
+
+        def close_pbars():
+            for pbar in pbars.values():
+                pbar["bar"].update(pbar["bar"].total - pbar["past_bytes"])
+                pbar["bar"].refresh()
+                pbar["bar"].close()
+
+        def tail_file(filename) -> Iterator[str]:
+            """
+            Creates a generator to be iterated through, which will return each
+            line one by one. Will stop tailing the file if the stopping_event is
+            set.
+            """
+            with open(filename, "r") as file:
+                current_line = ""
+                while True:
+                    if stopping_event.is_set():
+                        close_pbars()
+                        break
+
+                    line_bit = file.readline()
+                    if line_bit is not None and not len(line_bit.strip()) == 0:
+                        current_line += line_bit
+                        if current_line.endswith("\n"):
+                            yield current_line
+                            current_line = ""
+                    else:
+                        time.sleep(1)
+
+        # If the file isn't created yet, wait for a few seconds before trying again.
+        # Can be interrupted with the stopping_event.
+        while not os.path.exists(os.environ["GIT_LFS_PROGRESS"]):
+            if stopping_event.is_set():
+                close_pbars()
+                return
+
+            time.sleep(2)
+
+        for line in tail_file(os.environ["GIT_LFS_PROGRESS"]):
+            try:
+                state, file_progress, byte_progress, filename = line.split()
+            except ValueError as error:
+                # Try/except to ease debugging. See https://github.com/huggingface/huggingface_hub/issues/1373.
+                raise ValueError(f"Cannot unpack LFS progress line:\n{line}") from error
+            description = f"{state.capitalize()} file {filename}"
+
+            current_bytes, total_bytes = byte_progress.split("/")
+            current_bytes_int = int(current_bytes)
+            total_bytes_int = int(total_bytes)
+
+            pbar = pbars.get((state, filename))
+            if pbar is None:
+                # Initialize progress bar
+                pbars[(state, filename)] = {
+                    "bar": tqdm(
+                        desc=description,
+                        initial=current_bytes_int,
+                        total=total_bytes_int,
+                        unit="B",
+                        unit_scale=True,
+                        unit_divisor=1024,
+                    ),
+                    "past_bytes": int(current_bytes),
+                }
+            else:
+                # Update progress bar
+                pbar["bar"].update(current_bytes_int - pbar["past_bytes"])
+                pbar["past_bytes"] = current_bytes_int
+
+    current_lfs_progress_value = os.environ.get("GIT_LFS_PROGRESS", "")
+
+    with SoftTemporaryDirectory() as tmpdir:
+        os.environ["GIT_LFS_PROGRESS"] = os.path.join(tmpdir, "lfs_progress")
+        logger.debug(f"Following progress in {os.environ['GIT_LFS_PROGRESS']}")
+
+        exit_event = threading.Event()
+        x = threading.Thread(target=output_progress, args=(exit_event,), daemon=True)
+        x.start()
+
+        try:
+            yield
+        finally:
+            exit_event.set()
+            x.join()
+
+            os.environ["GIT_LFS_PROGRESS"] = current_lfs_progress_value
+
+
+class Repository:
+    """
+    Helper class to wrap the git and git-lfs commands.
+
+    The aim is to facilitate interacting with huggingface.co hosted model or
+    dataset repos, though not a lot here (if any) is actually specific to
+    huggingface.co.
+
+    <Tip warning={true}>
+
+    [`Repository`] is deprecated in favor of the http-based alternatives implemented in
+    [`HfApi`]. Given its large adoption in legacy code, the complete removal of
+    [`Repository`] will only happen in release `v1.0`. For more details, please read
+    https://huggingface.co/docs/huggingface_hub/concepts/git_vs_http.
+
+    </Tip>
+    """
+
+    command_queue: List[CommandInProgress]
+
+    @validate_hf_hub_args
+    @_deprecate_method(
+        version="1.0",
+        message=(
+            "Please prefer the http-based alternatives instead. Given its large adoption in legacy code, the complete"
+            " removal is only planned on next major release.\nFor more details, please read"
+            " https://huggingface.co/docs/huggingface_hub/concepts/git_vs_http."
+        ),
+    )
+    def __init__(
+        self,
+        local_dir: Union[str, Path],
+        clone_from: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        token: Union[bool, str] = True,
+        git_user: Optional[str] = None,
+        git_email: Optional[str] = None,
+        revision: Optional[str] = None,
+        skip_lfs_files: bool = False,
+        client: Optional[HfApi] = None,
+    ):
+        """
+        Instantiate a local clone of a git repo.
+
+        If `clone_from` is set, the repo will be cloned from an existing remote repository.
+        If the remote repo does not exist, a `EnvironmentError` exception will be thrown.
+        Please create the remote repo first using [`create_repo`].
+
+        `Repository` uses the local git credentials by default. If explicitly set, the `token`
+        or the `git_user`/`git_email` pair will be used instead.
+
+        Args:
+            local_dir (`str` or `Path`):
+                path (e.g. `'my_trained_model/'`) to the local directory, where
+                the `Repository` will be initialized.
+            clone_from (`str`, *optional*):
+                Either a repository url or `repo_id`.
+                Example:
+                - `"https://huggingface.co/philschmid/playground-tests"`
+                - `"philschmid/playground-tests"`
+            repo_type (`str`, *optional*):
+                To set when cloning a repo from a repo_id. Default is model.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token).
+                If `None` or `True` and machine is logged in (through `huggingface-cli login`
+                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
+                If `False`, token is not sent in the request header.
+            git_user (`str`, *optional*):
+                will override the `git config user.name` for committing and
+                pushing files to the hub.
+            git_email (`str`, *optional*):
+                will override the `git config user.email` for committing and
+                pushing files to the hub.
+            revision (`str`, *optional*):
+                Revision to checkout after initializing the repository. If the
+                revision doesn't exist, a branch will be created with that
+                revision name from the default branch's current HEAD.
+            skip_lfs_files (`bool`, *optional*, defaults to `False`):
+                whether to skip git-LFS files or not.
+            client (`HfApi`, *optional*):
+                Instance of [`HfApi`] to use when calling the HF Hub API. A new
+                instance will be created if this is left to `None`.
+
+        Raises:
+            - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError)
+              if the remote repository set in `clone_from` does not exist.
+        """
+        if isinstance(local_dir, Path):
+            local_dir = str(local_dir)
+        os.makedirs(local_dir, exist_ok=True)
+        self.local_dir = os.path.join(os.getcwd(), local_dir)
+        self._repo_type = repo_type
+        self.command_queue = []
+        self.skip_lfs_files = skip_lfs_files
+        self.client = client if client is not None else HfApi()
+
+        self.check_git_versions()
+
+        if isinstance(token, str):
+            self.huggingface_token: Optional[str] = token
+        elif token is False:
+            self.huggingface_token = None
+        else:
+            # if `True` -> explicit use of the cached token
+            # if `None` -> implicit use of the cached token
+            self.huggingface_token = get_token()
+
+        if clone_from is not None:
+            self.clone_from(repo_url=clone_from)
+        else:
+            if is_git_repo(self.local_dir):
+                logger.debug("[Repository] is a valid git repo")
+            else:
+                raise ValueError("If not specifying `clone_from`, you need to pass Repository a valid git clone.")
+
+        if self.huggingface_token is not None and (git_email is None or git_user is None):
+            user = self.client.whoami(self.huggingface_token)
+
+            if git_email is None:
+                git_email = user["email"]
+
+            if git_user is None:
+                git_user = user["fullname"]
+
+        if git_user is not None or git_email is not None:
+            self.git_config_username_and_email(git_user, git_email)
+
+        self.lfs_enable_largefiles()
+        self.git_credential_helper_store()
+
+        if revision is not None:
+            self.git_checkout(revision, create_branch_ok=True)
+
+        # This ensures that all commands exit before exiting the Python runtime.
+        # This will ensure all pushes register on the hub, even if other errors happen in subsequent operations.
+        atexit.register(self.wait_for_commands)
+
+    @property
+    def current_branch(self) -> str:
+        """
+        Returns the current checked out branch.
+
+        Returns:
+            `str`: Current checked out branch.
+        """
+        try:
+            result = run_subprocess("git rev-parse --abbrev-ref HEAD", self.local_dir).stdout.strip()
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+        return result
+
+    def check_git_versions(self):
+        """
+        Checks that `git` and `git-lfs` can be run.
+
+        Raises:
+            - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError)
+              if `git` or `git-lfs` are not installed.
+        """
+        try:
+            git_version = run_subprocess("git --version", self.local_dir).stdout.strip()
+        except FileNotFoundError:
+            raise EnvironmentError("Looks like you do not have git installed, please install.")
+
+        try:
+            lfs_version = run_subprocess("git-lfs --version", self.local_dir).stdout.strip()
+        except FileNotFoundError:
+            raise EnvironmentError(
+                "Looks like you do not have git-lfs installed, please install."
+                " You can install from https://git-lfs.github.com/."
+                " Then run `git lfs install` (you only have to do this once)."
+            )
+        logger.info(git_version + "\n" + lfs_version)
+
+    @validate_hf_hub_args
+    def clone_from(self, repo_url: str, token: Union[bool, str, None] = None):
+        """
+        Clone from a remote. If the folder already exists, will try to clone the
+        repository within it.
+
+        If this folder is a git repository with linked history, will try to
+        update the repository.
+
+        Args:
+            repo_url (`str`):
+                The URL from which to clone the repository
+            token (`Union[str, bool]`, *optional*):
+                Whether to use the authentication token. It can be:
+                 - a string which is the token itself
+                 - `False`, which would not use the authentication token
+                 - `True`, which would fetch the authentication token from the
+                   local folder and use it (you should be logged in for this to
+                   work).
+                - `None`, which would retrieve the value of
+                  `self.huggingface_token`.
+
+        <Tip>
+
+        Raises the following error:
+
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+              if an organization token (starts with "api_org") is passed. Use must use
+              your own personal access token (see https://hf.co/settings/tokens).
+
+            - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError)
+              if you are trying to clone the repository in a non-empty folder, or if the
+              `git` operations raise errors.
+
+        </Tip>
+        """
+        token = (
+            token  # str -> use it
+            if isinstance(token, str)
+            else (
+                None  # `False` -> explicit no token
+                if token is False
+                else self.huggingface_token  # `None` or `True` -> use default
+            )
+        )
+        if token is not None and token.startswith("api_org"):
+            raise ValueError(
+                "You must use your personal access token, not an Organization token"
+                " (see https://hf.co/settings/tokens)."
+            )
+
+        hub_url = self.client.endpoint
+        if hub_url in repo_url or ("http" not in repo_url and len(repo_url.split("/")) <= 2):
+            repo_type, namespace, repo_name = repo_type_and_id_from_hf_id(repo_url, hub_url=hub_url)
+            repo_id = f"{namespace}/{repo_name}" if namespace is not None else repo_name
+
+            if repo_type is not None:
+                self._repo_type = repo_type
+
+            repo_url = hub_url + "/"
+
+            if self._repo_type in REPO_TYPES_URL_PREFIXES:
+                repo_url += REPO_TYPES_URL_PREFIXES[self._repo_type]
+
+            if token is not None:
+                # Add token in git url when provided
+                scheme = urlparse(repo_url).scheme
+                repo_url = repo_url.replace(f"{scheme}://", f"{scheme}://user:{token}@")
+
+            repo_url += repo_id
+
+        # For error messages, it's cleaner to show the repo url without the token.
+        clean_repo_url = re.sub(r"(https?)://.*@", r"\1://", repo_url)
+        try:
+            run_subprocess("git lfs install", self.local_dir)
+
+            # checks if repository is initialized in a empty repository or in one with files
+            if len(os.listdir(self.local_dir)) == 0:
+                logger.warning(f"Cloning {clean_repo_url} into local empty directory.")
+
+                with _lfs_log_progress():
+                    env = os.environ.copy()
+
+                    if self.skip_lfs_files:
+                        env.update({"GIT_LFS_SKIP_SMUDGE": "1"})
+
+                    run_subprocess(
+                        # 'git lfs clone' is deprecated (will display a warning in the terminal)
+                        # but we still use it as it provides a nicer UX when downloading large
+                        # files (shows progress).
+                        f"{'git clone' if self.skip_lfs_files else 'git lfs clone'} {repo_url} .",
+                        self.local_dir,
+                        env=env,
+                    )
+            else:
+                # Check if the folder is the root of a git repository
+                if not is_git_repo(self.local_dir):
+                    raise EnvironmentError(
+                        "Tried to clone a repository in a non-empty folder that isn't"
+                        f" a git repository ('{self.local_dir}'). If you really want to"
+                        f" do this, do it manually:\n cd {self.local_dir} && git init"
+                        " && git remote add origin && git pull origin main\n or clone"
+                        " repo to a new folder and move your existing files there"
+                        " afterwards."
+                    )
+
+                if is_local_clone(self.local_dir, repo_url):
+                    logger.warning(
+                        f"{self.local_dir} is already a clone of {clean_repo_url}."
+                        " Make sure you pull the latest changes with"
+                        " `repo.git_pull()`."
+                    )
+                else:
+                    output = run_subprocess("git remote get-url origin", self.local_dir, check=False)
+
+                    error_msg = (
+                        f"Tried to clone {clean_repo_url} in an unrelated git"
+                        " repository.\nIf you believe this is an error, please add"
+                        f" a remote with the following URL: {clean_repo_url}."
+                    )
+                    if output.returncode == 0:
+                        clean_local_remote_url = re.sub(r"https://.*@", "https://", output.stdout)
+                        error_msg += f"\nLocal path has its origin defined as: {clean_local_remote_url}"
+                    raise EnvironmentError(error_msg)
+
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+    def git_config_username_and_email(self, git_user: Optional[str] = None, git_email: Optional[str] = None):
+        """
+        Sets git username and email (only in the current repo).
+
+        Args:
+            git_user (`str`, *optional*):
+                The username to register through `git`.
+            git_email (`str`, *optional*):
+                The email to register through `git`.
+        """
+        try:
+            if git_user is not None:
+                run_subprocess("git config user.name".split() + [git_user], self.local_dir)
+
+            if git_email is not None:
+                run_subprocess(f"git config user.email {git_email}".split(), self.local_dir)
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+    def git_credential_helper_store(self):
+        """
+        Sets the git credential helper to `store`
+        """
+        try:
+            run_subprocess("git config credential.helper store", self.local_dir)
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+    def git_head_hash(self) -> str:
+        """
+        Get commit sha on top of HEAD.
+
+        Returns:
+            `str`: The current checked out commit SHA.
+        """
+        try:
+            p = run_subprocess("git rev-parse HEAD", self.local_dir)
+            return p.stdout.strip()
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+    def git_remote_url(self) -> str:
+        """
+        Get URL to origin remote.
+
+        Returns:
+            `str`: The URL of the `origin` remote.
+        """
+        try:
+            p = run_subprocess("git config --get remote.origin.url", self.local_dir)
+            url = p.stdout.strip()
+            # Strip basic auth info.
+            return re.sub(r"https://.*@", "https://", url)
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+    def git_head_commit_url(self) -> str:
+        """
+        Get URL to last commit on HEAD. We assume it's been pushed, and the url
+        scheme is the same one as for GitHub or HuggingFace.
+
+        Returns:
+            `str`: The URL to the current checked-out commit.
+        """
+        sha = self.git_head_hash()
+        url = self.git_remote_url()
+        if url.endswith("/"):
+            url = url[:-1]
+        return f"{url}/commit/{sha}"
+
+    def list_deleted_files(self) -> List[str]:
+        """
+        Returns a list of the files that are deleted in the working directory or
+        index.
+
+        Returns:
+            `List[str]`: A list of files that have been deleted in the working
+            directory or index.
+        """
+        try:
+            git_status = run_subprocess("git status -s", self.local_dir).stdout.strip()
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+        if len(git_status) == 0:
+            return []
+
+        # Receives a status like the following
+        #  D .gitignore
+        #  D new_file.json
+        # AD new_file1.json
+        # ?? new_file2.json
+        # ?? new_file4.json
+
+        # Strip each line of whitespaces
+        modified_files_statuses = [status.strip() for status in git_status.split("\n")]
+
+        # Only keep files that are deleted using the D prefix
+        deleted_files_statuses = [status for status in modified_files_statuses if "D" in status.split()[0]]
+
+        # Remove the D prefix and strip to keep only the relevant filename
+        deleted_files = [status.split()[-1].strip() for status in deleted_files_statuses]
+
+        return deleted_files
+
+    def lfs_track(self, patterns: Union[str, List[str]], filename: bool = False):
+        """
+        Tell git-lfs to track files according to a pattern.
+
+        Setting the `filename` argument to `True` will treat the arguments as
+        literal filenames, not as patterns. Any special glob characters in the
+        filename will be escaped when writing to the `.gitattributes` file.
+
+        Args:
+            patterns (`Union[str, List[str]]`):
+                The pattern, or list of patterns, to track with git-lfs.
+            filename (`bool`, *optional*, defaults to `False`):
+                Whether to use the patterns as literal filenames.
+        """
+        if isinstance(patterns, str):
+            patterns = [patterns]
+        try:
+            for pattern in patterns:
+                run_subprocess(
+                    f"git lfs track {'--filename' if filename else ''} {pattern}",
+                    self.local_dir,
+                )
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+    def lfs_untrack(self, patterns: Union[str, List[str]]):
+        """
+        Tell git-lfs to untrack those files.
+
+        Args:
+            patterns (`Union[str, List[str]]`):
+                The pattern, or list of patterns, to untrack with git-lfs.
+        """
+        if isinstance(patterns, str):
+            patterns = [patterns]
+        try:
+            for pattern in patterns:
+                run_subprocess("git lfs untrack".split() + [pattern], self.local_dir)
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+    def lfs_enable_largefiles(self):
+        """
+        HF-specific. This enables upload support of files >5GB.
+        """
+        try:
+            lfs_config = "git config lfs.customtransfer.multipart"
+            run_subprocess(f"{lfs_config}.path huggingface-cli", self.local_dir)
+            run_subprocess(
+                f"{lfs_config}.args {LFS_MULTIPART_UPLOAD_COMMAND}",
+                self.local_dir,
+            )
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+    def auto_track_binary_files(self, pattern: str = ".") -> List[str]:
+        """
+        Automatically track binary files with git-lfs.
+
+        Args:
+            pattern (`str`, *optional*, defaults to "."):
+                The pattern with which to track files that are binary.
+
+        Returns:
+            `List[str]`: List of filenames that are now tracked due to being
+            binary files
+        """
+        files_to_be_tracked_with_lfs = []
+
+        deleted_files = self.list_deleted_files()
+
+        for filename in files_to_be_staged(pattern, folder=self.local_dir):
+            if filename in deleted_files:
+                continue
+
+            path_to_file = os.path.join(os.getcwd(), self.local_dir, filename)
+
+            if not (is_tracked_with_lfs(path_to_file) or is_git_ignored(path_to_file)):
+                size_in_mb = os.path.getsize(path_to_file) / (1024 * 1024)
+
+                if size_in_mb >= 10:
+                    logger.warning(
+                        "Parsing a large file to check if binary or not. Tracking large"
+                        " files using `repository.auto_track_large_files` is"
+                        " recommended so as to not load the full file in memory."
+                    )
+
+                is_binary = is_binary_file(path_to_file)
+
+                if is_binary:
+                    self.lfs_track(filename)
+                    files_to_be_tracked_with_lfs.append(filename)
+
+        # Cleanup the .gitattributes if files were deleted
+        self.lfs_untrack(deleted_files)
+
+        return files_to_be_tracked_with_lfs
+
+    def auto_track_large_files(self, pattern: str = ".") -> List[str]:
+        """
+        Automatically track large files (files that weigh more than 10MBs) with
+        git-lfs.
+
+        Args:
+            pattern (`str`, *optional*, defaults to "."):
+                The pattern with which to track files that are above 10MBs.
+
+        Returns:
+            `List[str]`: List of filenames that are now tracked due to their
+            size.
+        """
+        files_to_be_tracked_with_lfs = []
+
+        deleted_files = self.list_deleted_files()
+
+        for filename in files_to_be_staged(pattern, folder=self.local_dir):
+            if filename in deleted_files:
+                continue
+
+            path_to_file = os.path.join(os.getcwd(), self.local_dir, filename)
+            size_in_mb = os.path.getsize(path_to_file) / (1024 * 1024)
+
+            if size_in_mb >= 10 and not is_tracked_with_lfs(path_to_file) and not is_git_ignored(path_to_file):
+                self.lfs_track(filename)
+                files_to_be_tracked_with_lfs.append(filename)
+
+        # Cleanup the .gitattributes if files were deleted
+        self.lfs_untrack(deleted_files)
+
+        return files_to_be_tracked_with_lfs
+
+    def lfs_prune(self, recent=False):
+        """
+        git lfs prune
+
+        Args:
+            recent (`bool`, *optional*, defaults to `False`):
+                Whether to prune files even if they were referenced by recent
+                commits. See the following
+                [link](https://github.com/git-lfs/git-lfs/blob/f3d43f0428a84fc4f1e5405b76b5a73ec2437e65/docs/man/git-lfs-prune.1.ronn#recent-files)
+                for more information.
+        """
+        try:
+            with _lfs_log_progress():
+                result = run_subprocess(f"git lfs prune {'--recent' if recent else ''}", self.local_dir)
+                logger.info(result.stdout)
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+    def git_pull(self, rebase: bool = False, lfs: bool = False):
+        """
+        git pull
+
+        Args:
+            rebase (`bool`, *optional*, defaults to `False`):
+                Whether to rebase the current branch on top of the upstream
+                branch after fetching.
+            lfs (`bool`, *optional*, defaults to `False`):
+                Whether to fetch the LFS files too. This option only changes the
+                behavior when a repository was cloned without fetching the LFS
+                files; calling `repo.git_pull(lfs=True)` will then fetch the LFS
+                file from the remote repository.
+        """
+        command = "git pull" if not lfs else "git lfs pull"
+        if rebase:
+            command += " --rebase"
+        try:
+            with _lfs_log_progress():
+                result = run_subprocess(command, self.local_dir)
+                logger.info(result.stdout)
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+    def git_add(self, pattern: str = ".", auto_lfs_track: bool = False):
+        """
+        git add
+
+        Setting the `auto_lfs_track` parameter to `True` will automatically
+        track files that are larger than 10MB with `git-lfs`.
+
+        Args:
+            pattern (`str`, *optional*, defaults to "."):
+                The pattern with which to add files to staging.
+            auto_lfs_track (`bool`, *optional*, defaults to `False`):
+                Whether to automatically track large and binary files with
+                git-lfs. Any file over 10MB in size, or in binary format, will
+                be automatically tracked.
+        """
+        if auto_lfs_track:
+            # Track files according to their size (>=10MB)
+            tracked_files = self.auto_track_large_files(pattern)
+
+            # Read the remaining files and track them if they're binary
+            tracked_files.extend(self.auto_track_binary_files(pattern))
+
+            if tracked_files:
+                logger.warning(
+                    f"Adding files tracked by Git LFS: {tracked_files}. This may take a"
+                    " bit of time if the files are large."
+                )
+
+        try:
+            result = run_subprocess("git add -v".split() + [pattern], self.local_dir)
+            logger.info(f"Adding to index:\n{result.stdout}\n")
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+    def git_commit(self, commit_message: str = "commit files to HF hub"):
+        """
+        git commit
+
+        Args:
+            commit_message (`str`, *optional*, defaults to "commit files to HF hub"):
+                The message attributed to the commit.
+        """
+        try:
+            result = run_subprocess("git commit -v -m".split() + [commit_message], self.local_dir)
+            logger.info(f"Committed:\n{result.stdout}\n")
+        except subprocess.CalledProcessError as exc:
+            if len(exc.stderr) > 0:
+                raise EnvironmentError(exc.stderr)
+            else:
+                raise EnvironmentError(exc.stdout)
+
+    def git_push(
+        self,
+        upstream: Optional[str] = None,
+        blocking: bool = True,
+        auto_lfs_prune: bool = False,
+    ) -> Union[str, Tuple[str, CommandInProgress]]:
+        """
+        git push
+
+        If used without setting `blocking`, will return url to commit on remote
+        repo. If used with `blocking=True`, will return a tuple containing the
+        url to commit and the command object to follow for information about the
+        process.
+
+        Args:
+            upstream (`str`, *optional*):
+                Upstream to which this should push. If not specified, will push
+                to the lastly defined upstream or to the default one (`origin
+                main`).
+            blocking (`bool`, *optional*, defaults to `True`):
+                Whether the function should return only when the push has
+                finished. Setting this to `False` will return an
+                `CommandInProgress` object which has an `is_done` property. This
+                property will be set to `True` when the push is finished.
+            auto_lfs_prune (`bool`, *optional*, defaults to `False`):
+                Whether to automatically prune files once they have been pushed
+                to the remote.
+        """
+        command = "git push"
+
+        if upstream:
+            command += f" --set-upstream {upstream}"
+
+        number_of_commits = commits_to_push(self.local_dir, upstream)
+
+        if number_of_commits > 1:
+            logger.warning(f"Several commits ({number_of_commits}) will be pushed upstream.")
+            if blocking:
+                logger.warning("The progress bars may be unreliable.")
+
+        try:
+            with _lfs_log_progress():
+                process = subprocess.Popen(
+                    command.split(),
+                    stderr=subprocess.PIPE,
+                    stdout=subprocess.PIPE,
+                    encoding="utf-8",
+                    cwd=self.local_dir,
+                )
+
+                if blocking:
+                    stdout, stderr = process.communicate()
+                    return_code = process.poll()
+                    process.kill()
+
+                    if len(stderr):
+                        logger.warning(stderr)
+
+                    if return_code:
+                        raise subprocess.CalledProcessError(return_code, process.args, output=stdout, stderr=stderr)
+
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+        if not blocking:
+
+            def status_method():
+                status = process.poll()
+                if status is None:
+                    return -1
+                else:
+                    return status
+
+            command_in_progress = CommandInProgress(
+                "push",
+                is_done_method=lambda: process.poll() is not None,
+                status_method=status_method,
+                process=process,
+                post_method=self.lfs_prune if auto_lfs_prune else None,
+            )
+
+            self.command_queue.append(command_in_progress)
+
+            return self.git_head_commit_url(), command_in_progress
+
+        if auto_lfs_prune:
+            self.lfs_prune()
+
+        return self.git_head_commit_url()
+
+    def git_checkout(self, revision: str, create_branch_ok: bool = False):
+        """
+        git checkout a given revision
+
+        Specifying `create_branch_ok` to `True` will create the branch to the
+        given revision if that revision doesn't exist.
+
+        Args:
+            revision (`str`):
+                The revision to checkout.
+            create_branch_ok (`str`, *optional*, defaults to `False`):
+                Whether creating a branch named with the `revision` passed at
+                the current checked-out reference if `revision` isn't an
+                existing revision is allowed.
+        """
+        try:
+            result = run_subprocess(f"git checkout {revision}", self.local_dir)
+            logger.warning(f"Checked out {revision} from {self.current_branch}.")
+            logger.warning(result.stdout)
+        except subprocess.CalledProcessError as exc:
+            if not create_branch_ok:
+                raise EnvironmentError(exc.stderr)
+            else:
+                try:
+                    result = run_subprocess(f"git checkout -b {revision}", self.local_dir)
+                    logger.warning(
+                        f"Revision `{revision}` does not exist. Created and checked out branch `{revision}`."
+                    )
+                    logger.warning(result.stdout)
+                except subprocess.CalledProcessError as exc:
+                    raise EnvironmentError(exc.stderr)
+
+    def tag_exists(self, tag_name: str, remote: Optional[str] = None) -> bool:
+        """
+        Check if a tag exists or not.
+
+        Args:
+            tag_name (`str`):
+                The name of the tag to check.
+            remote (`str`, *optional*):
+                Whether to check if the tag exists on a remote. This parameter
+                should be the identifier of the remote.
+
+        Returns:
+            `bool`: Whether the tag exists.
+        """
+        if remote:
+            try:
+                result = run_subprocess(f"git ls-remote origin refs/tags/{tag_name}", self.local_dir).stdout.strip()
+            except subprocess.CalledProcessError as exc:
+                raise EnvironmentError(exc.stderr)
+
+            return len(result) != 0
+        else:
+            try:
+                git_tags = run_subprocess("git tag", self.local_dir).stdout.strip()
+            except subprocess.CalledProcessError as exc:
+                raise EnvironmentError(exc.stderr)
+
+            git_tags = git_tags.split("\n")
+            return tag_name in git_tags
+
+    def delete_tag(self, tag_name: str, remote: Optional[str] = None) -> bool:
+        """
+        Delete a tag, both local and remote, if it exists
+
+        Args:
+            tag_name (`str`):
+                The tag name to delete.
+            remote (`str`, *optional*):
+                The remote on which to delete the tag.
+
+        Returns:
+             `bool`: `True` if deleted, `False` if the tag didn't exist.
+                If remote is not passed, will just be updated locally
+        """
+        delete_locally = True
+        delete_remotely = True
+
+        if not self.tag_exists(tag_name):
+            delete_locally = False
+
+        if not self.tag_exists(tag_name, remote=remote):
+            delete_remotely = False
+
+        if delete_locally:
+            try:
+                run_subprocess(["git", "tag", "-d", tag_name], self.local_dir).stdout.strip()
+            except subprocess.CalledProcessError as exc:
+                raise EnvironmentError(exc.stderr)
+
+        if remote and delete_remotely:
+            try:
+                run_subprocess(f"git push {remote} --delete {tag_name}", self.local_dir).stdout.strip()
+            except subprocess.CalledProcessError as exc:
+                raise EnvironmentError(exc.stderr)
+
+        return True
+
+    def add_tag(self, tag_name: str, message: Optional[str] = None, remote: Optional[str] = None):
+        """
+        Add a tag at the current head and push it
+
+        If remote is None, will just be updated locally
+
+        If no message is provided, the tag will be lightweight. if a message is
+        provided, the tag will be annotated.
+
+        Args:
+            tag_name (`str`):
+                The name of the tag to be added.
+            message (`str`, *optional*):
+                The message that accompanies the tag. The tag will turn into an
+                annotated tag if a message is passed.
+            remote (`str`, *optional*):
+                The remote on which to add the tag.
+        """
+        if message:
+            tag_args = ["git", "tag", "-a", tag_name, "-m", message]
+        else:
+            tag_args = ["git", "tag", tag_name]
+
+        try:
+            run_subprocess(tag_args, self.local_dir).stdout.strip()
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+        if remote:
+            try:
+                run_subprocess(f"git push {remote} {tag_name}", self.local_dir).stdout.strip()
+            except subprocess.CalledProcessError as exc:
+                raise EnvironmentError(exc.stderr)
+
+    def is_repo_clean(self) -> bool:
+        """
+        Return whether or not the git status is clean or not
+
+        Returns:
+            `bool`: `True` if the git status is clean, `False` otherwise.
+        """
+        try:
+            git_status = run_subprocess("git status --porcelain", self.local_dir).stdout.strip()
+        except subprocess.CalledProcessError as exc:
+            raise EnvironmentError(exc.stderr)
+
+        return len(git_status) == 0
+
+    def push_to_hub(
+        self,
+        commit_message: str = "commit files to HF hub",
+        blocking: bool = True,
+        clean_ok: bool = True,
+        auto_lfs_prune: bool = False,
+    ) -> Union[None, str, Tuple[str, CommandInProgress]]:
+        """
+        Helper to add, commit, and push files to remote repository on the
+        HuggingFace Hub. Will automatically track large files (>10MB).
+
+        Args:
+            commit_message (`str`):
+                Message to use for the commit.
+            blocking (`bool`, *optional*, defaults to `True`):
+                Whether the function should return only when the `git push` has
+                finished.
+            clean_ok (`bool`, *optional*, defaults to `True`):
+                If True, this function will return None if the repo is
+                untouched. Default behavior is to fail because the git command
+                fails.
+            auto_lfs_prune (`bool`, *optional*, defaults to `False`):
+                Whether to automatically prune files once they have been pushed
+                to the remote.
+        """
+        if clean_ok and self.is_repo_clean():
+            logger.info("Repo currently clean. Ignoring push_to_hub")
+            return None
+        self.git_add(auto_lfs_track=True)
+        self.git_commit(commit_message)
+        return self.git_push(
+            upstream=f"origin {self.current_branch}",
+            blocking=blocking,
+            auto_lfs_prune=auto_lfs_prune,
+        )
+
+    @contextmanager
+    def commit(
+        self,
+        commit_message: str,
+        branch: Optional[str] = None,
+        track_large_files: bool = True,
+        blocking: bool = True,
+        auto_lfs_prune: bool = False,
+    ):
+        """
+        Context manager utility to handle committing to a repository. This
+        automatically tracks large files (>10Mb) with git-lfs. Set the
+        `track_large_files` argument to `False` if you wish to ignore that
+        behavior.
+
+        Args:
+            commit_message (`str`):
+                Message to use for the commit.
+            branch (`str`, *optional*):
+                The branch on which the commit will appear. This branch will be
+                checked-out before any operation.
+            track_large_files (`bool`, *optional*, defaults to `True`):
+                Whether to automatically track large files or not. Will do so by
+                default.
+            blocking (`bool`, *optional*, defaults to `True`):
+                Whether the function should return only when the `git push` has
+                finished.
+            auto_lfs_prune (`bool`, defaults to `True`):
+                Whether to automatically prune files once they have been pushed
+                to the remote.
+
+        Examples:
+
+        ```python
+        >>> with Repository(
+        ...     "text-files",
+        ...     clone_from="<user>/text-files",
+        ...     token=True,
+        >>> ).commit("My first file :)"):
+        ...     with open("file.txt", "w+") as f:
+        ...         f.write(json.dumps({"hey": 8}))
+
+        >>> import torch
+
+        >>> model = torch.nn.Transformer()
+        >>> with Repository(
+        ...     "torch-model",
+        ...     clone_from="<user>/torch-model",
+        ...     token=True,
+        >>> ).commit("My cool model :)"):
+        ...     torch.save(model.state_dict(), "model.pt")
+        ```
+
+        """
+
+        files_to_stage = files_to_be_staged(".", folder=self.local_dir)
+
+        if len(files_to_stage):
+            files_in_msg = str(files_to_stage[:5])[:-1] + ", ...]" if len(files_to_stage) > 5 else str(files_to_stage)
+            logger.error(
+                "There exists some updated files in the local repository that are not"
+                f" committed: {files_in_msg}. This may lead to errors if checking out"
+                " a branch. These files and their modifications will be added to the"
+                " current commit."
+            )
+
+        if branch is not None:
+            self.git_checkout(branch, create_branch_ok=True)
+
+        if is_tracked_upstream(self.local_dir):
+            logger.warning("Pulling changes ...")
+            self.git_pull(rebase=True)
+        else:
+            logger.warning(f"The current branch has no upstream branch. Will push to 'origin {self.current_branch}'")
+
+        current_working_directory = os.getcwd()
+        os.chdir(os.path.join(current_working_directory, self.local_dir))
+
+        try:
+            yield self
+        finally:
+            self.git_add(auto_lfs_track=track_large_files)
+
+            try:
+                self.git_commit(commit_message)
+            except OSError as e:
+                # If no changes are detected, there is nothing to commit.
+                if "nothing to commit" not in str(e):
+                    raise e
+
+            try:
+                self.git_push(
+                    upstream=f"origin {self.current_branch}",
+                    blocking=blocking,
+                    auto_lfs_prune=auto_lfs_prune,
+                )
+            except OSError as e:
+                # If no changes are detected, there is nothing to commit.
+                if "could not read Username" in str(e):
+                    raise OSError("Couldn't authenticate user for push. Did you set `token` to `True`?") from e
+                else:
+                    raise e
+
+            os.chdir(current_working_directory)
+
+    def repocard_metadata_load(self) -> Optional[Dict]:
+        filepath = os.path.join(self.local_dir, REPOCARD_NAME)
+        if os.path.isfile(filepath):
+            return metadata_load(filepath)
+        return None
+
+    def repocard_metadata_save(self, data: Dict) -> None:
+        return metadata_save(os.path.join(self.local_dir, REPOCARD_NAME), data)
+
+    @property
+    def commands_failed(self):
+        """
+        Returns the asynchronous commands that failed.
+        """
+        return [c for c in self.command_queue if c.status > 0]
+
+    @property
+    def commands_in_progress(self):
+        """
+        Returns the asynchronous commands that are currently in progress.
+        """
+        return [c for c in self.command_queue if not c.is_done]
+
+    def wait_for_commands(self):
+        """
+        Blocking method: blocks all subsequent execution until all commands have
+        been processed.
+        """
+        index = 0
+        for command_failed in self.commands_failed:
+            logger.error(f"The {command_failed.title} command with PID {command_failed._process.pid} failed.")
+            logger.error(command_failed.stderr)
+
+        while self.commands_in_progress:
+            if index % 10 == 0:
+                logger.warning(
+                    f"Waiting for the following commands to finish before shutting down: {self.commands_in_progress}."
+                )
+
+            index += 1
+
+            time.sleep(1)
diff --git a/llm/Lib/site-packages/huggingface_hub/serialization/__init__.py b/llm/Lib/site-packages/huggingface_hub/serialization/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0bb6c2d0a1556d8119d3b400a9adcff73b34e6e5
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/serialization/__init__.py
@@ -0,0 +1,20 @@
+# Copyright 2024 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ruff: noqa: F401
+"""Contains helpers to serialize tensors."""
+
+from ._base import StateDictSplit, split_state_dict_into_shards_factory
+from ._numpy import split_numpy_state_dict_into_shards
+from ._tensorflow import split_tf_state_dict_into_shards
+from ._torch import split_torch_state_dict_into_shards
diff --git a/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..24ecff943b1903a72173e644a0a069a9db66b77c
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/_base.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/_base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ed7e2503d16a2c7ac4e1da815ebaa35de952bd7b
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/_base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/_numpy.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/_numpy.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7f2c58f570c9a11c2773380dac39542d4103bb2d
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/_numpy.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/_tensorflow.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/_tensorflow.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dfed76266743dfd03bd55e7536eabe47082e9e3a
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/_tensorflow.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/_torch.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/_torch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5f298c7ec79935620e53d1ea5901a9784fdc3814
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/serialization/__pycache__/_torch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/serialization/_base.py b/llm/Lib/site-packages/huggingface_hub/serialization/_base.py
new file mode 100644
index 0000000000000000000000000000000000000000..a7f7bba89263d31d5facb1ebed66c5f701dba973
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/serialization/_base.py
@@ -0,0 +1,169 @@
+# Copyright 2024 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains helpers to split tensors into shards."""
+
+from dataclasses import dataclass, field
+from typing import Any, Callable, Dict, List, Optional, TypeVar
+
+from .. import logging
+
+
+TensorT = TypeVar("TensorT")
+TensorSizeFn_T = Callable[[TensorT], int]
+StorageIDFn_T = Callable[[TensorT], Optional[Any]]
+
+MAX_SHARD_SIZE = 5_000_000_000  # 5GB
+FILENAME_PATTERN = "model{suffix}.safetensors"
+
+logger = logging.get_logger(__file__)
+
+
+@dataclass
+class StateDictSplit:
+    is_sharded: bool = field(init=False)
+    metadata: Dict[str, Any]
+    filename_to_tensors: Dict[str, List[str]]
+    tensor_to_filename: Dict[str, str]
+
+    def __post_init__(self):
+        self.is_sharded = len(self.filename_to_tensors) > 1
+
+
+def split_state_dict_into_shards_factory(
+    state_dict: Dict[str, TensorT],
+    *,
+    get_tensor_size: TensorSizeFn_T,
+    get_storage_id: StorageIDFn_T = lambda tensor: None,
+    filename_pattern: str = FILENAME_PATTERN,
+    max_shard_size: int = MAX_SHARD_SIZE,
+) -> StateDictSplit:
+    """
+    Split a model state dictionary in shards so that each shard is smaller than a given size.
+
+    The shards are determined by iterating through the `state_dict` in the order of its keys. There is no optimization
+    made to make each shard as close as possible to the maximum size passed. For example, if the limit is 10GB and we
+    have tensors of sizes [6GB, 6GB, 2GB, 6GB, 2GB, 2GB] they will get sharded as [6GB], [6+2GB], [6+2+2GB] and not
+    [6+2+2GB], [6+2GB], [6GB].
+
+    <Tip warning={true}>
+
+    If one of the model's tensor is bigger than `max_shard_size`, it will end up in its own shard which will have a
+    size greater than `max_shard_size`.
+
+    </Tip>
+
+    Args:
+        state_dict (`Dict[str, Tensor]`):
+            The state dictionary to save.
+        get_tensor_size (`Callable[[Tensor], int]`):
+            A function that returns the size of a tensor in bytes.
+        get_storage_id (`Callable[[Tensor], Optional[Any]]`, *optional*):
+            A function that returns a unique identifier to a tensor storage. Multiple different tensors can share the
+            same underlying storage. This identifier is guaranteed to be unique and constant for this tensor's storage
+            during its lifetime. Two tensor storages with non-overlapping lifetimes may have the same id.
+        filename_pattern (`str`, *optional*):
+            The pattern to generate the files names in which the model will be saved. Pattern must be a string that
+            can be formatted with `filename_pattern.format(suffix=...)` and must contain the keyword `suffix`
+            Defaults to `"model{suffix}.safetensors"`.
+        max_shard_size (`int` or `str`, *optional*):
+            The maximum size of each shard, in bytes. Defaults to 5GB.
+
+    Returns:
+        [`StateDictSplit`]: A `StateDictSplit` object containing the shards and the index to retrieve them.
+    """
+    storage_id_to_tensors: Dict[Any, List[str]] = {}
+
+    shard_list: List[Dict[str, TensorT]] = []
+    current_shard: Dict[str, TensorT] = {}
+    current_shard_size = 0
+    total_size = 0
+
+    for key, tensor in state_dict.items():
+        # when bnb serialization is used the weights in the state dict can be strings
+        # check: https://github.com/huggingface/transformers/pull/24416 for more details
+        if isinstance(tensor, str):
+            logger.info("Skipping tensor %s as it is a string (bnb serialization)", key)
+            continue
+
+        # If a `tensor` shares the same underlying storage as another tensor, we put `tensor` in the same `block`
+        storage_id = get_storage_id(tensor)
+        if storage_id is not None:
+            if storage_id in storage_id_to_tensors:
+                # We skip this tensor for now and will reassign to correct shard later
+                storage_id_to_tensors[storage_id].append(key)
+                continue
+            else:
+                # This is the first tensor with this storage_id, we create a new entry
+                # in the storage_id_to_tensors dict => we will assign the shard id later
+                storage_id_to_tensors[storage_id] = [key]
+
+        # Compute tensor size
+        tensor_size = get_tensor_size(tensor)
+
+        # If this tensor is bigger than the maximal size, we put it in its own shard
+        if tensor_size > max_shard_size:
+            total_size += tensor_size
+            shard_list.append({key: tensor})
+            continue
+
+        # If this tensor is going to tip up over the maximal size, we split.
+        # Current shard already has some tensors, we add it to the list of shards and create a new one.
+        if current_shard_size + tensor_size > max_shard_size:
+            shard_list.append(current_shard)
+            current_shard = {}
+            current_shard_size = 0
+
+        # Add the tensor to the current shard
+        current_shard[key] = tensor
+        current_shard_size += tensor_size
+        total_size += tensor_size
+
+    # Add the last shard
+    if len(current_shard) > 0:
+        shard_list.append(current_shard)
+    nb_shards = len(shard_list)
+
+    # Loop over the tensors that share the same storage and assign them together
+    for storage_id, keys in storage_id_to_tensors.items():
+        # Let's try to find the shard where the first tensor of this storage is and put all tensors in the same shard
+        for shard in shard_list:
+            if keys[0] in shard:
+                for key in keys:
+                    shard[key] = state_dict[key]
+                break
+
+    # If we only have one shard, we return it => no need to build the index
+    if nb_shards == 1:
+        filename = filename_pattern.format(suffix="")
+        return StateDictSplit(
+            metadata={"total_size": total_size},
+            filename_to_tensors={filename: list(state_dict.keys())},
+            tensor_to_filename={key: filename for key in state_dict.keys()},
+        )
+
+    # Now that each tensor is assigned to a shard, let's assign a filename to each shard
+    tensor_name_to_filename = {}
+    filename_to_tensors = {}
+    for idx, shard in enumerate(shard_list):
+        filename = filename_pattern.format(suffix=f"-{idx+1:05d}-of-{nb_shards:05d}")
+        for key in shard:
+            tensor_name_to_filename[key] = filename
+        filename_to_tensors[filename] = list(shard.keys())
+
+    # Build the index and return
+    return StateDictSplit(
+        metadata={"total_size": total_size},
+        filename_to_tensors=filename_to_tensors,
+        tensor_to_filename=tensor_name_to_filename,
+    )
diff --git a/llm/Lib/site-packages/huggingface_hub/serialization/_numpy.py b/llm/Lib/site-packages/huggingface_hub/serialization/_numpy.py
new file mode 100644
index 0000000000000000000000000000000000000000..214c77d9acde2a14069f403ed337e6c8c57047ad
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/serialization/_numpy.py
@@ -0,0 +1,68 @@
+# Copyright 2024 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains numpy-specific helpers."""
+
+from typing import TYPE_CHECKING, Dict
+
+from ._base import FILENAME_PATTERN, MAX_SHARD_SIZE, StateDictSplit, split_state_dict_into_shards_factory
+
+
+if TYPE_CHECKING:
+    import numpy as np
+
+
+def split_numpy_state_dict_into_shards(
+    state_dict: Dict[str, "np.ndarray"],
+    *,
+    filename_pattern: str = FILENAME_PATTERN,
+    max_shard_size: int = MAX_SHARD_SIZE,
+) -> StateDictSplit:
+    """
+    Split a model state dictionary in shards so that each shard is smaller than a given size.
+
+    The shards are determined by iterating through the `state_dict` in the order of its keys. There is no optimization
+    made to make each shard as close as possible to the maximum size passed. For example, if the limit is 10GB and we
+    have tensors of sizes [6GB, 6GB, 2GB, 6GB, 2GB, 2GB] they will get sharded as [6GB], [6+2GB], [6+2+2GB] and not
+    [6+2+2GB], [6+2GB], [6GB].
+
+    <Tip warning={true}>
+
+    If one of the model's tensor is bigger than `max_shard_size`, it will end up in its own shard which will have a
+    size greater than `max_shard_size`.
+
+    </Tip>
+
+    Args:
+        state_dict (`Dict[str, np.ndarray]`):
+            The state dictionary to save.
+        filename_pattern (`str`, *optional*):
+            The pattern to generate the files names in which the model will be saved. Pattern must be a string that
+            can be formatted with `filename_pattern.format(suffix=...)` and must contain the keyword `suffix`
+            Defaults to `"model{suffix}.safetensors"`.
+        max_shard_size (`int` or `str`, *optional*):
+            The maximum size of each shard, in bytes. Defaults to 5GB.
+
+    Returns:
+        [`StateDictSplit`]: A `StateDictSplit` object containing the shards and the index to retrieve them.
+    """
+    return split_state_dict_into_shards_factory(
+        state_dict,
+        max_shard_size=max_shard_size,
+        filename_pattern=filename_pattern,
+        get_tensor_size=get_tensor_size,
+    )
+
+
+def get_tensor_size(tensor: "np.ndarray") -> int:
+    return tensor.nbytes
diff --git a/llm/Lib/site-packages/huggingface_hub/serialization/_tensorflow.py b/llm/Lib/site-packages/huggingface_hub/serialization/_tensorflow.py
new file mode 100644
index 0000000000000000000000000000000000000000..f8d752c083063d3e9772b69982e8f979fbda53ea
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/serialization/_tensorflow.py
@@ -0,0 +1,94 @@
+# Copyright 2024 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains tensorflow-specific helpers."""
+
+import math
+import re
+from typing import TYPE_CHECKING, Dict
+
+from ._base import MAX_SHARD_SIZE, StateDictSplit, split_state_dict_into_shards_factory
+
+
+if TYPE_CHECKING:
+    import tensorflow as tf
+
+
+def split_tf_state_dict_into_shards(
+    state_dict: Dict[str, "tf.Tensor"],
+    *,
+    filename_pattern: str = "tf_model{suffix}.h5",
+    max_shard_size: int = MAX_SHARD_SIZE,
+) -> StateDictSplit:
+    """
+    Split a model state dictionary in shards so that each shard is smaller than a given size.
+
+    The shards are determined by iterating through the `state_dict` in the order of its keys. There is no optimization
+    made to make each shard as close as possible to the maximum size passed. For example, if the limit is 10GB and we
+    have tensors of sizes [6GB, 6GB, 2GB, 6GB, 2GB, 2GB] they will get sharded as [6GB], [6+2GB], [6+2+2GB] and not
+    [6+2+2GB], [6+2GB], [6GB].
+
+    <Tip warning={true}>
+
+    If one of the model's tensor is bigger than `max_shard_size`, it will end up in its own shard which will have a
+    size greater than `max_shard_size`.
+
+    </Tip>
+
+    Args:
+        state_dict (`Dict[str, Tensor]`):
+            The state dictionary to save.
+        filename_pattern (`str`, *optional*):
+            The pattern to generate the files names in which the model will be saved. Pattern must be a string that
+            can be formatted with `filename_pattern.format(suffix=...)` and must contain the keyword `suffix`
+            Defaults to `"tf_model{suffix}.h5"`.
+        max_shard_size (`int` or `str`, *optional*):
+            The maximum size of each shard, in bytes. Defaults to 5GB.
+
+    Returns:
+        [`StateDictSplit`]: A `StateDictSplit` object containing the shards and the index to retrieve them.
+    """
+    return split_state_dict_into_shards_factory(
+        state_dict,
+        max_shard_size=max_shard_size,
+        filename_pattern=filename_pattern,
+        get_tensor_size=get_tensor_size,
+    )
+
+
+def get_tensor_size(tensor: "tf.Tensor") -> int:
+    # Return `math.ceil` since dtype byte size can be a float (e.g., 0.125 for tf.bool).
+    # Better to overestimate than underestimate.
+    return math.ceil(tensor.numpy().size * _dtype_byte_size_tf(tensor.dtype))
+
+
+def _dtype_byte_size_tf(dtype) -> float:
+    """
+    Returns the size (in bytes) occupied by one parameter of type `dtype`.
+    Taken from https://github.com/huggingface/transformers/blob/74d9d0cebb0263a3f8ab9c280569170cc74651d0/src/transformers/modeling_tf_utils.py#L608.
+    NOTE: why not `tensor.numpy().nbytes`?
+    Example:
+    ```py
+    >>> _dtype_byte_size(tf.float32)
+    4
+    ```
+    """
+    import tensorflow as tf
+
+    if dtype == tf.bool:
+        return 1 / 8
+    bit_search = re.search(r"[^\d](\d+)$", dtype.name)
+    if bit_search is None:
+        raise ValueError(f"`dtype` is not a valid dtype: {dtype}.")
+    bit_size = int(bit_search.groups()[0])
+    return bit_size // 8
diff --git a/llm/Lib/site-packages/huggingface_hub/serialization/_torch.py b/llm/Lib/site-packages/huggingface_hub/serialization/_torch.py
new file mode 100644
index 0000000000000000000000000000000000000000..00ab7e2c80d7a8fde928588c284213fca2100cf3
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/serialization/_torch.py
@@ -0,0 +1,200 @@
+# Copyright 2024 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains pytorch-specific helpers."""
+
+import importlib
+from functools import lru_cache
+from typing import TYPE_CHECKING, Dict, Tuple
+
+from ._base import FILENAME_PATTERN, MAX_SHARD_SIZE, StateDictSplit, split_state_dict_into_shards_factory
+
+
+if TYPE_CHECKING:
+    import torch
+
+
+def split_torch_state_dict_into_shards(
+    state_dict: Dict[str, "torch.Tensor"],
+    *,
+    filename_pattern: str = FILENAME_PATTERN,
+    max_shard_size: int = MAX_SHARD_SIZE,
+) -> StateDictSplit:
+    """
+    Split a model state dictionary in shards so that each shard is smaller than a given size.
+
+    The shards are determined by iterating through the `state_dict` in the order of its keys. There is no optimization
+    made to make each shard as close as possible to the maximum size passed. For example, if the limit is 10GB and we
+    have tensors of sizes [6GB, 6GB, 2GB, 6GB, 2GB, 2GB] they will get sharded as [6GB], [6+2GB], [6+2+2GB] and not
+    [6+2+2GB], [6+2GB], [6GB].
+
+    <Tip warning={true}>
+
+    If one of the model's tensor is bigger than `max_shard_size`, it will end up in its own shard which will have a
+    size greater than `max_shard_size`.
+
+    </Tip>
+
+    Args:
+        state_dict (`Dict[str, torch.Tensor]`):
+            The state dictionary to save.
+        filename_pattern (`str`, *optional*):
+            The pattern to generate the files names in which the model will be saved. Pattern must be a string that
+            can be formatted with `filename_pattern.format(suffix=...)` and must contain the keyword `suffix`
+            Defaults to `"model{suffix}.safetensors"`.
+        max_shard_size (`int` or `str`, *optional*):
+            The maximum size of each shard, in bytes. Defaults to 5GB.
+
+    Returns:
+        [`StateDictSplit`]: A `StateDictSplit` object containing the shards and the index to retrieve them.
+
+    Example:
+    ```py
+    >>> import json
+    >>> import os
+    >>> from safetensors.torch import save_file as safe_save_file
+    >>> from huggingface_hub import split_torch_state_dict_into_shards
+
+    >>> def save_state_dict(state_dict: Dict[str, torch.Tensor], save_directory: str):
+    ...     state_dict_split = split_torch_state_dict_into_shards(state_dict)
+    ...     for filename, tensors in state_dict_split.filename_to_tensors.values():
+    ...         shard = {tensor: state_dict[tensor] for tensor in tensors}
+    ...         safe_save_file(
+    ...             shard,
+    ...             os.path.join(save_directory, filename),
+    ...             metadata={"format": "pt"},
+    ...         )
+    ...     if state_dict_split.is_sharded:
+    ...         index = {
+    ...             "metadata": state_dict_split.metadata,
+    ...             "weight_map": state_dict_split.tensor_to_filename,
+    ...         }
+    ...         with open(os.path.join(save_directory, "model.safetensors.index.json"), "w") as f:
+    ...             f.write(json.dumps(index, indent=2))
+    ```
+    """
+    return split_state_dict_into_shards_factory(
+        state_dict,
+        max_shard_size=max_shard_size,
+        filename_pattern=filename_pattern,
+        get_tensor_size=get_tensor_size,
+        get_storage_id=get_storage_id,
+    )
+
+
+def get_storage_id(tensor: "torch.Tensor") -> Tuple["torch.device", int, int]:
+    """
+    Return unique identifier to a tensor storage.
+
+    Multiple different tensors can share the same underlying storage. For
+    example, "meta" tensors all share the same storage, and thus their identifier will all be equal. This identifier is
+    guaranteed to be unique and constant for this tensor's storage during its lifetime. Two tensor storages with
+    non-overlapping lifetimes may have the same id.
+
+    Taken from https://github.com/huggingface/transformers/blob/1ecf5f7c982d761b4daaa96719d162c324187c64/src/transformers/pytorch_utils.py#L278.
+    """
+    if tensor.device.type == "xla" and is_torch_tpu_available():
+        # NOTE: xla tensors dont have storage
+        # use some other unique id to distinguish.
+        # this is a XLA tensor, it must be created using torch_xla's
+        # device. So the following import is safe:
+        import torch_xla
+
+        unique_id = torch_xla._XLAC._xla_get_tensor_id(tensor)
+    else:
+        unique_id = storage_ptr(tensor)
+
+    return tensor.device, unique_id, get_storage_size(tensor)
+
+
+def get_tensor_size(tensor: "torch.Tensor") -> int:
+    return tensor.numel() * tensor.element_size()
+
+
+@lru_cache()
+def is_torch_tpu_available(check_device=True):
+    """
+    Checks if `torch_xla` is installed and potentially if a TPU is in the environment
+
+    Taken from https://github.com/huggingface/transformers/blob/1ecf5f7c982d761b4daaa96719d162c324187c64/src/transformers/utils/import_utils.py#L463.
+    """
+    if importlib.util.find_spec("torch_xla") is not None:
+        if check_device:
+            # We need to check if `xla_device` can be found, will raise a RuntimeError if not
+            try:
+                import torch_xla.core.xla_model as xm
+
+                _ = xm.xla_device()
+                return True
+            except RuntimeError:
+                return False
+        return True
+    return False
+
+
+def storage_ptr(tensor: "torch.Tensor") -> int:
+    """
+    Taken from https://github.com/huggingface/safetensors/blob/08db34094e9e59e2f9218f2df133b7b4aaff5a99/bindings/python/py_src/safetensors/torch.py#L11C1-L20C21.
+    """
+    try:
+        return tensor.untyped_storage().data_ptr()
+    except Exception:
+        # Fallback for torch==1.10
+        try:
+            return tensor.storage().data_ptr()
+        except NotImplementedError:
+            # Fallback for meta storage
+            return 0
+
+
+def get_storage_size(tensor: "torch.Tensor") -> int:
+    """
+    Taken from https://github.com/huggingface/safetensors/blob/08db34094e9e59e2f9218f2df133b7b4aaff5a99/bindings/python/py_src/safetensors/torch.py#L31C1-L41C59
+    """
+    try:
+        return tensor.untyped_storage().nbytes()
+    except AttributeError:
+        # Fallback for torch==1.10
+        try:
+            return tensor.storage().size() * _get_dtype_size(tensor.dtype)
+        except NotImplementedError:
+            # Fallback for meta storage
+            # On torch >=2.0 this is the tensor size
+            return tensor.nelement() * _get_dtype_size(tensor.dtype)
+
+
+@lru_cache()
+def _get_dtype_size(dtype: "torch.dtype") -> int:
+    """
+    Taken from https://github.com/huggingface/safetensors/blob/08db34094e9e59e2f9218f2df133b7b4aaff5a99/bindings/python/py_src/safetensors/torch.py#L344
+    """
+    import torch
+
+    # torch.float8 formats require 2.1; we do not support these dtypes on earlier versions
+    _float8_e4m3fn = getattr(torch, "float8_e4m3fn", None)
+    _float8_e5m2 = getattr(torch, "float8_e5m2", None)
+    _SIZE = {
+        torch.int64: 8,
+        torch.float32: 4,
+        torch.int32: 4,
+        torch.bfloat16: 2,
+        torch.float16: 2,
+        torch.int16: 2,
+        torch.uint8: 1,
+        torch.int8: 1,
+        torch.bool: 1,
+        torch.float64: 8,
+        _float8_e4m3fn: 1,
+        _float8_e5m2: 1,
+    }
+    return _SIZE[dtype]
diff --git a/llm/Lib/site-packages/huggingface_hub/templates/datasetcard_template.md b/llm/Lib/site-packages/huggingface_hub/templates/datasetcard_template.md
new file mode 100644
index 0000000000000000000000000000000000000000..9af29ebbed93653ec74a8952e314e7554323ef15
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/templates/datasetcard_template.md
@@ -0,0 +1,143 @@
+---
+# For reference on dataset card metadata, see the spec: https://github.com/huggingface/hub-docs/blob/main/datasetcard.md?plain=1
+# Doc / guide: https://huggingface.co/docs/hub/datasets-cards
+{{ card_data }}
+---
+
+# Dataset Card for {{ pretty_name | default("Dataset Name", true) }}
+
+<!-- Provide a quick summary of the dataset. -->
+
+{{ dataset_summary | default("", true) }}
+
+## Dataset Details
+
+### Dataset Description
+
+<!-- Provide a longer summary of what this dataset is. -->
+
+{{ dataset_description | default("", true) }}
+
+- **Curated by:** {{ curators | default("[More Information Needed]", true)}}
+- **Funded by [optional]:** {{ funded_by | default("[More Information Needed]", true)}}
+- **Shared by [optional]:** {{ shared_by | default("[More Information Needed]", true)}}
+- **Language(s) (NLP):** {{ language | default("[More Information Needed]", true)}}
+- **License:** {{ license | default("[More Information Needed]", true)}}
+
+### Dataset Sources [optional]
+
+<!-- Provide the basic links for the dataset. -->
+
+- **Repository:** {{ repo | default("[More Information Needed]", true)}}
+- **Paper [optional]:** {{ paper | default("[More Information Needed]", true)}}
+- **Demo [optional]:** {{ demo | default("[More Information Needed]", true)}}
+
+## Uses
+
+<!-- Address questions around how the dataset is intended to be used. -->
+
+### Direct Use
+
+<!-- This section describes suitable use cases for the dataset. -->
+
+{{ direct_use | default("[More Information Needed]", true)}}
+
+### Out-of-Scope Use
+
+<!-- This section addresses misuse, malicious use, and uses that the dataset will not work well for. -->
+
+{{ out_of_scope_use | default("[More Information Needed]", true)}}
+
+## Dataset Structure
+
+<!-- This section provides a description of the dataset fields, and additional information about the dataset structure such as criteria used to create the splits, relationships between data points, etc. -->
+
+{{ dataset_structure | default("[More Information Needed]", true)}}
+
+## Dataset Creation
+
+### Curation Rationale
+
+<!-- Motivation for the creation of this dataset. -->
+
+{{ curation_rationale_section | default("[More Information Needed]", true)}}
+
+### Source Data
+
+<!-- This section describes the source data (e.g. news text and headlines, social media posts, translated sentences, ...). -->
+
+#### Data Collection and Processing
+
+<!-- This section describes the data collection and processing process such as data selection criteria, filtering and normalization methods, tools and libraries used, etc. -->
+
+{{ data_collection_and_processing_section | default("[More Information Needed]", true)}}
+
+#### Who are the source data producers?
+
+<!-- This section describes the people or systems who originally created the data. It should also include self-reported demographic or identity information for the source data creators if this information is available. -->
+
+{{ source_data_producers_section | default("[More Information Needed]", true)}}
+
+### Annotations [optional]
+
+<!-- If the dataset contains annotations which are not part of the initial data collection, use this section to describe them. -->
+
+#### Annotation process
+
+<!-- This section describes the annotation process such as annotation tools used in the process, the amount of data annotated, annotation guidelines provided to the annotators, interannotator statistics, annotation validation, etc. -->
+
+{{ annotation_process_section | default("[More Information Needed]", true)}}
+
+#### Who are the annotators?
+
+<!-- This section describes the people or systems who created the annotations. -->
+
+{{ who_are_annotators_section | default("[More Information Needed]", true)}}
+
+#### Personal and Sensitive Information
+
+<!-- State whether the dataset contains data that might be considered personal, sensitive, or private (e.g., data that reveals addresses, uniquely identifiable names or aliases, racial or ethnic origins, sexual orientations, religious beliefs, political opinions, financial or health data, etc.). If efforts were made to anonymize the data, describe the anonymization process. -->
+
+{{ personal_and_sensitive_information | default("[More Information Needed]", true)}}
+
+## Bias, Risks, and Limitations
+
+<!-- This section is meant to convey both technical and sociotechnical limitations. -->
+
+{{ bias_risks_limitations | default("[More Information Needed]", true)}}
+
+### Recommendations
+
+<!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. -->
+
+{{ bias_recommendations | default("Users should be made aware of the risks, biases and limitations of the dataset. More information needed for further recommendations.", true)}}
+
+## Citation [optional]
+
+<!-- If there is a paper or blog post introducing the dataset, the APA and Bibtex information for that should go in this section. -->
+
+**BibTeX:**
+
+{{ citation_bibtex | default("[More Information Needed]", true)}}
+
+**APA:**
+
+{{ citation_apa | default("[More Information Needed]", true)}}
+
+## Glossary [optional]
+
+<!-- If relevant, include terms and calculations in this section that can help readers understand the dataset or dataset card. -->
+
+{{ glossary | default("[More Information Needed]", true)}}
+
+## More Information [optional]
+
+{{ more_information | default("[More Information Needed]", true)}}
+
+## Dataset Card Authors [optional]
+
+{{ dataset_card_authors | default("[More Information Needed]", true)}}
+
+## Dataset Card Contact
+
+{{ dataset_card_contact | default("[More Information Needed]", true)}}
diff --git a/llm/Lib/site-packages/huggingface_hub/templates/modelcard_template.md b/llm/Lib/site-packages/huggingface_hub/templates/modelcard_template.md
new file mode 100644
index 0000000000000000000000000000000000000000..79ca15e4547debac763b390ef8e4b715e6f6403f
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/templates/modelcard_template.md
@@ -0,0 +1,200 @@
+---
+# For reference on model card metadata, see the spec: https://github.com/huggingface/hub-docs/blob/main/modelcard.md?plain=1
+# Doc / guide: https://huggingface.co/docs/hub/model-cards
+{{ card_data }}
+---
+
+# Model Card for {{ model_id | default("Model ID", true) }}
+
+<!-- Provide a quick summary of what the model is/does. -->
+
+{{ model_summary | default("", true) }}
+
+## Model Details
+
+### Model Description
+
+<!-- Provide a longer summary of what this model is. -->
+
+{{ model_description | default("", true) }}
+
+- **Developed by:** {{ developers | default("[More Information Needed]", true)}}
+- **Funded by [optional]:** {{ funded_by | default("[More Information Needed]", true)}}
+- **Shared by [optional]:** {{ shared_by | default("[More Information Needed]", true)}}
+- **Model type:** {{ model_type | default("[More Information Needed]", true)}}
+- **Language(s) (NLP):** {{ language | default("[More Information Needed]", true)}}
+- **License:** {{ license | default("[More Information Needed]", true)}}
+- **Finetuned from model [optional]:** {{ base_model | default("[More Information Needed]", true)}}
+
+### Model Sources [optional]
+
+<!-- Provide the basic links for the model. -->
+
+- **Repository:** {{ repo | default("[More Information Needed]", true)}}
+- **Paper [optional]:** {{ paper | default("[More Information Needed]", true)}}
+- **Demo [optional]:** {{ demo | default("[More Information Needed]", true)}}
+
+## Uses
+
+<!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. -->
+
+### Direct Use
+
+<!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
+
+{{ direct_use | default("[More Information Needed]", true)}}
+
+### Downstream Use [optional]
+
+<!-- This section is for the model use when fine-tuned for a task, or when plugged into a larger ecosystem/app -->
+
+{{ downstream_use | default("[More Information Needed]", true)}}
+
+### Out-of-Scope Use
+
+<!-- This section addresses misuse, malicious use, and uses that the model will not work well for. -->
+
+{{ out_of_scope_use | default("[More Information Needed]", true)}}
+
+## Bias, Risks, and Limitations
+
+<!-- This section is meant to convey both technical and sociotechnical limitations. -->
+
+{{ bias_risks_limitations | default("[More Information Needed]", true)}}
+
+### Recommendations
+
+<!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. -->
+
+{{ bias_recommendations | default("Users (both direct and downstream) should be made aware of the risks, biases and limitations of the model. More information needed for further recommendations.", true)}}
+
+## How to Get Started with the Model
+
+Use the code below to get started with the model.
+
+{{ get_started_code | default("[More Information Needed]", true)}}
+
+## Training Details
+
+### Training Data
+
+<!-- This should link to a Dataset Card, perhaps with a short stub of information on what the training data is all about as well as documentation related to data pre-processing or additional filtering. -->
+
+{{ training_data | default("[More Information Needed]", true)}}
+
+### Training Procedure
+
+<!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->
+
+#### Preprocessing [optional]
+
+{{ preprocessing | default("[More Information Needed]", true)}}
+
+
+#### Training Hyperparameters
+
+- **Training regime:** {{ training_regime | default("[More Information Needed]", true)}} <!--fp32, fp16 mixed precision, bf16 mixed precision, bf16 non-mixed precision, fp16 non-mixed precision, fp8 mixed precision -->
+
+#### Speeds, Sizes, Times [optional]
+
+<!-- This section provides information about throughput, start/end time, checkpoint size if relevant, etc. -->
+
+{{ speeds_sizes_times | default("[More Information Needed]", true)}}
+
+## Evaluation
+
+<!-- This section describes the evaluation protocols and provides the results. -->
+
+### Testing Data, Factors & Metrics
+
+#### Testing Data
+
+<!-- This should link to a Dataset Card if possible. -->
+
+{{ testing_data | default("[More Information Needed]", true)}}
+
+#### Factors
+
+<!-- These are the things the evaluation is disaggregating by, e.g., subpopulations or domains. -->
+
+{{ testing_factors | default("[More Information Needed]", true)}}
+
+#### Metrics
+
+<!-- These are the evaluation metrics being used, ideally with a description of why. -->
+
+{{ testing_metrics | default("[More Information Needed]", true)}}
+
+### Results
+
+{{ results | default("[More Information Needed]", true)}}
+
+#### Summary
+
+{{ results_summary | default("", true) }}
+
+## Model Examination [optional]
+
+<!-- Relevant interpretability work for the model goes here -->
+
+{{ model_examination | default("[More Information Needed]", true)}}
+
+## Environmental Impact
+
+<!-- Total emissions (in grams of CO2eq) and additional considerations, such as electricity usage, go here. Edit the suggested text below accordingly -->
+
+Carbon emissions can be estimated using the [Machine Learning Impact calculator](https://mlco2.github.io/impact#compute) presented in [Lacoste et al. (2019)](https://arxiv.org/abs/1910.09700).
+
+- **Hardware Type:** {{ hardware_type | default("[More Information Needed]", true)}}
+- **Hours used:** {{ hours_used | default("[More Information Needed]", true)}}
+- **Cloud Provider:** {{ cloud_provider | default("[More Information Needed]", true)}}
+- **Compute Region:** {{ cloud_region | default("[More Information Needed]", true)}}
+- **Carbon Emitted:** {{ co2_emitted | default("[More Information Needed]", true)}}
+
+## Technical Specifications [optional]
+
+### Model Architecture and Objective
+
+{{ model_specs | default("[More Information Needed]", true)}}
+
+### Compute Infrastructure
+
+{{ compute_infrastructure | default("[More Information Needed]", true)}}
+
+#### Hardware
+
+{{ hardware_requirements | default("[More Information Needed]", true)}}
+
+#### Software
+
+{{ software | default("[More Information Needed]", true)}}
+
+## Citation [optional]
+
+<!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->
+
+**BibTeX:**
+
+{{ citation_bibtex | default("[More Information Needed]", true)}}
+
+**APA:**
+
+{{ citation_apa | default("[More Information Needed]", true)}}
+
+## Glossary [optional]
+
+<!-- If relevant, include terms and calculations in this section that can help readers understand the model or model card. -->
+
+{{ glossary | default("[More Information Needed]", true)}}
+
+## More Information [optional]
+
+{{ more_information | default("[More Information Needed]", true)}}
+
+## Model Card Authors [optional]
+
+{{ model_card_authors | default("[More Information Needed]", true)}}
+
+## Model Card Contact
+
+{{ model_card_contact | default("[More Information Needed]", true)}}
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__init__.py b/llm/Lib/site-packages/huggingface_hub/utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..97c236ecec3233c863facf2207a0038cb173bcea
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/__init__.py
@@ -0,0 +1,122 @@
+#!/usr/bin/env python
+# coding=utf-8
+# Copyright 2021 The HuggingFace Inc. team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License
+
+# ruff: noqa: F401
+
+from . import tqdm as _tqdm  # _tqdm is the module
+from ._cache_assets import cached_assets_path
+from ._cache_manager import (
+    CachedFileInfo,
+    CachedRepoInfo,
+    CachedRevisionInfo,
+    CacheNotFound,
+    CorruptedCacheException,
+    DeleteCacheStrategy,
+    HFCacheInfo,
+    scan_cache_dir,
+)
+from ._chunk_utils import chunk_iterable
+from ._datetime import parse_datetime
+from ._errors import (
+    BadRequestError,
+    DisabledRepoError,
+    EntryNotFoundError,
+    FileMetadataError,
+    GatedRepoError,
+    HfHubHTTPError,
+    LocalEntryNotFoundError,
+    RepositoryNotFoundError,
+    RevisionNotFoundError,
+    hf_raise_for_status,
+)
+from ._experimental import experimental
+from ._fixes import SoftTemporaryDirectory, WeakFileLock, yaml_dump
+from ._git_credential import list_credential_helpers, set_git_credential, unset_git_credential
+from ._headers import LocalTokenNotFoundError, build_hf_headers, get_token_to_send
+from ._hf_folder import HfFolder
+from ._http import (
+    OfflineModeIsEnabled,
+    configure_http_backend,
+    fix_hf_endpoint_in_url,
+    get_session,
+    http_backoff,
+    reset_sessions,
+)
+from ._pagination import paginate
+from ._paths import IGNORE_GIT_FOLDER_PATTERNS, filter_repo_objects
+from ._runtime import (
+    dump_environment_info,
+    get_aiohttp_version,
+    get_fastai_version,
+    get_fastcore_version,
+    get_gradio_version,
+    get_graphviz_version,
+    get_hf_hub_version,
+    get_hf_transfer_version,
+    get_jinja_version,
+    get_minijinja_version,
+    get_numpy_version,
+    get_pillow_version,
+    get_pydantic_version,
+    get_pydot_version,
+    get_python_version,
+    get_tensorboard_version,
+    get_tf_version,
+    get_torch_version,
+    is_aiohttp_available,
+    is_fastai_available,
+    is_fastcore_available,
+    is_google_colab,
+    is_gradio_available,
+    is_graphviz_available,
+    is_hf_transfer_available,
+    is_jinja_available,
+    is_minijinja_available,
+    is_notebook,
+    is_numpy_available,
+    is_package_available,
+    is_pillow_available,
+    is_pydantic_available,
+    is_pydot_available,
+    is_safetensors_available,
+    is_tensorboard_available,
+    is_tf_available,
+    is_torch_available,
+)
+from ._safetensors import (
+    NotASafetensorsRepoError,
+    SafetensorsFileMetadata,
+    SafetensorsParsingError,
+    SafetensorsRepoMetadata,
+    TensorInfo,
+)
+from ._subprocess import capture_output, run_interactive_subprocess, run_subprocess
+from ._telemetry import send_telemetry
+from ._token import get_token
+from ._typing import is_jsonable
+from ._validators import (
+    HFValidationError,
+    smoothly_deprecate_use_auth_token,
+    validate_hf_hub_args,
+    validate_repo_id,
+)
+from .tqdm import (
+    are_progress_bars_disabled,
+    disable_progress_bars,
+    enable_progress_bars,
+    tqdm,
+    tqdm_stream_file,
+)
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..30b827e8dc1b87f150d685cd8163775c9cf32fc5
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_cache_assets.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_cache_assets.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..54ffacda10737fb8305f247478560d8aa60949a8
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_cache_assets.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_cache_manager.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_cache_manager.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..74f39510412478708f7700c9935363d247ef64af
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_cache_manager.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_chunk_utils.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_chunk_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7cc75ba3bc9d082f04e42ce29612cdb622b36f86
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_chunk_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_datetime.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_datetime.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..111c7c7804dd371bb629e78da4a26aae7f6ae889
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_datetime.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_deprecation.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_deprecation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..759ee95e91f548ea9549b41595dadbfc7f3a7667
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_deprecation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_errors.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_errors.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fae78d7d8bf88865d883b82e6da18a1ba596ee06
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_errors.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_experimental.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_experimental.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e5c83cf2f27a3024b1c8da0cde92c5297c44e046
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_experimental.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_fixes.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_fixes.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b095e5d7cc1f9961bffffeba0a8b98f4835b988e
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_fixes.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_git_credential.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_git_credential.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cc68bb6b5a5c92360aee0ee42c09836bdde0bc98
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_git_credential.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_headers.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_headers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2eb20a887b6f47f22490b410af345bb14d5b2e42
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_headers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_hf_folder.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_hf_folder.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..215969945bd2db2b4aa4a26fe67aa89d618f10a3
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_hf_folder.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_http.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_http.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..318120e1f84c4d97247185eb4156ce6a6d779eb3
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_http.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_pagination.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_pagination.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f48d64bdd69efce4a972984e4e05b27746f17ded
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_pagination.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_paths.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_paths.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0176add9a6af32f74d120c5b02cd6d1c17a990f8
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_paths.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_runtime.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_runtime.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c8821332ac3024c39d6f3e0f61822453570720a5
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_runtime.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_safetensors.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_safetensors.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2bd1341cbe9bae68e17d07e2b8921bd83dd051e0
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_safetensors.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_subprocess.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_subprocess.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..10d54d5eb628d465da34c84102a0fe9cc5630640
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_subprocess.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_telemetry.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_telemetry.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c25673cfbd1bf6e908ddb9f46a2e54ca70d85c71
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_telemetry.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_token.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_token.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..536071d34e976905b2ce902231610b8f82e04a09
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_token.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_typing.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_typing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9f39af45e694542f3c661d5270ae3777efae60b2
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_typing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_validators.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_validators.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..88b5939a322c3491f23467bba9f79c9f6ec83541
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/_validators.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/endpoint_helpers.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/endpoint_helpers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f2b670f46a9804805c8bfd8330c9632aa00d9ac8
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/endpoint_helpers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/insecure_hashlib.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/insecure_hashlib.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a797b2cb2f79bb7e27800c469b74078570660b3c
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/insecure_hashlib.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/logging.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/logging.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..97d9fbd2670db383a0351e3777773750456f7cb7
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/logging.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/sha.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/sha.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c276d3a267e10861d0217d539ef143c2b272d6d2
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/sha.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/tqdm.cpython-311.pyc b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/tqdm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1b8a0d9653b0718bdbf20281fe83ad02ac1418b3
Binary files /dev/null and b/llm/Lib/site-packages/huggingface_hub/utils/__pycache__/tqdm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_cache_assets.py b/llm/Lib/site-packages/huggingface_hub/utils/_cache_assets.py
new file mode 100644
index 0000000000000000000000000000000000000000..e5d435df9b0bb0c67c0bcb5ef65711e9aef367f6
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_cache_assets.py
@@ -0,0 +1,135 @@
+# coding=utf-8
+# Copyright 2019-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from pathlib import Path
+from typing import Union
+
+from ..constants import HF_ASSETS_CACHE
+
+
+def cached_assets_path(
+    library_name: str,
+    namespace: str = "default",
+    subfolder: str = "default",
+    *,
+    assets_dir: Union[str, Path, None] = None,
+):
+    """Return a folder path to cache arbitrary files.
+
+    `huggingface_hub` provides a canonical folder path to store assets. This is the
+    recommended way to integrate cache in a downstream library as it will benefit from
+    the builtins tools to scan and delete the cache properly.
+
+    The distinction is made between files cached from the Hub and assets. Files from the
+    Hub are cached in a git-aware manner and entirely managed by `huggingface_hub`. See
+    [related documentation](https://huggingface.co/docs/huggingface_hub/how-to-cache).
+    All other files that a downstream library caches are considered to be "assets"
+    (files downloaded from external sources, extracted from a .tar archive, preprocessed
+    for training,...).
+
+    Once the folder path is generated, it is guaranteed to exist and to be a directory.
+    The path is based on 3 levels of depth: the library name, a namespace and a
+    subfolder. Those 3 levels grants flexibility while allowing `huggingface_hub` to
+    expect folders when scanning/deleting parts of the assets cache. Within a library,
+    it is expected that all namespaces share the same subset of subfolder names but this
+    is not a mandatory rule. The downstream library has then full control on which file
+    structure to adopt within its cache. Namespace and subfolder are optional (would
+    default to a `"default/"` subfolder) but library name is mandatory as we want every
+    downstream library to manage its own cache.
+
+    Expected tree:
+    ```text
+        assets/
+        └── datasets/
+        │   ├── SQuAD/
+        │   │   ├── downloaded/
+        │   │   ├── extracted/
+        │   │   └── processed/
+        │   ├── Helsinki-NLP--tatoeba_mt/
+        │       ├── downloaded/
+        │       ├── extracted/
+        │       └── processed/
+        └── transformers/
+            ├── default/
+            │   ├── something/
+            ├── bert-base-cased/
+            │   ├── default/
+            │   └── training/
+        hub/
+        └── models--julien-c--EsperBERTo-small/
+            ├── blobs/
+            │   ├── (...)
+            │   ├── (...)
+            ├── refs/
+            │   └── (...)
+            └── [ 128]  snapshots/
+                ├── 2439f60ef33a0d46d85da5001d52aeda5b00ce9f/
+                │   ├── (...)
+                └── bbc77c8132af1cc5cf678da3f1ddf2de43606d48/
+                    └── (...)
+    ```
+
+
+    Args:
+        library_name (`str`):
+            Name of the library that will manage the cache folder. Example: `"dataset"`.
+        namespace (`str`, *optional*, defaults to "default"):
+            Namespace to which the data belongs. Example: `"SQuAD"`.
+        subfolder (`str`, *optional*, defaults to "default"):
+            Subfolder in which the data will be stored. Example: `extracted`.
+        assets_dir (`str`, `Path`, *optional*):
+            Path to the folder where assets are cached. This must not be the same folder
+            where Hub files are cached. Defaults to `HF_HOME / "assets"` if not provided.
+            Can also be set with `HF_ASSETS_CACHE` environment variable.
+
+    Returns:
+        Path to the cache folder (`Path`).
+
+    Example:
+    ```py
+    >>> from huggingface_hub import cached_assets_path
+
+    >>> cached_assets_path(library_name="datasets", namespace="SQuAD", subfolder="download")
+    PosixPath('/home/wauplin/.cache/huggingface/extra/datasets/SQuAD/download')
+
+    >>> cached_assets_path(library_name="datasets", namespace="SQuAD", subfolder="extracted")
+    PosixPath('/home/wauplin/.cache/huggingface/extra/datasets/SQuAD/extracted')
+
+    >>> cached_assets_path(library_name="datasets", namespace="Helsinki-NLP/tatoeba_mt")
+    PosixPath('/home/wauplin/.cache/huggingface/extra/datasets/Helsinki-NLP--tatoeba_mt/default')
+
+    >>> cached_assets_path(library_name="datasets", assets_dir="/tmp/tmp123456")
+    PosixPath('/tmp/tmp123456/datasets/default/default')
+    ```
+    """
+    # Resolve assets_dir
+    if assets_dir is None:
+        assets_dir = HF_ASSETS_CACHE
+    assets_dir = Path(assets_dir).expanduser().resolve()
+
+    # Avoid names that could create path issues
+    for part in (" ", "/", "\\"):
+        library_name = library_name.replace(part, "--")
+        namespace = namespace.replace(part, "--")
+        subfolder = subfolder.replace(part, "--")
+
+    # Path to subfolder is created
+    path = assets_dir / library_name / namespace / subfolder
+    try:
+        path.mkdir(exist_ok=True, parents=True)
+    except (FileExistsError, NotADirectoryError):
+        raise ValueError(f"Corrupted assets folder: cannot create directory because of an existing file ({path}).")
+
+    # Return
+    return path
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_cache_manager.py b/llm/Lib/site-packages/huggingface_hub/utils/_cache_manager.py
new file mode 100644
index 0000000000000000000000000000000000000000..78ce8fdadc58ac3112324be25c02cbb56637f86e
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_cache_manager.py
@@ -0,0 +1,813 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains utilities to manage the HF cache directory."""
+
+import os
+import shutil
+import time
+from collections import defaultdict
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Dict, FrozenSet, List, Literal, Optional, Set, Union
+
+from ..constants import HF_HUB_CACHE
+from . import logging
+
+
+logger = logging.get_logger(__name__)
+
+REPO_TYPE_T = Literal["model", "dataset", "space"]
+
+# List of OS-created helper files that need to be ignored
+FILES_TO_IGNORE = [".DS_Store"]
+
+
+class CacheNotFound(Exception):
+    """Exception thrown when the Huggingface cache is not found."""
+
+    cache_dir: Union[str, Path]
+
+    def __init__(self, msg: str, cache_dir: Union[str, Path], *args, **kwargs):
+        super().__init__(msg, *args, **kwargs)
+        self.cache_dir = cache_dir
+
+
+class CorruptedCacheException(Exception):
+    """Exception for any unexpected structure in the Huggingface cache-system."""
+
+
+@dataclass(frozen=True)
+class CachedFileInfo:
+    """Frozen data structure holding information about a single cached file.
+
+    Args:
+        file_name (`str`):
+            Name of the file. Example: `config.json`.
+        file_path (`Path`):
+            Path of the file in the `snapshots` directory. The file path is a symlink
+            referring to a blob in the `blobs` folder.
+        blob_path (`Path`):
+            Path of the blob file. This is equivalent to `file_path.resolve()`.
+        size_on_disk (`int`):
+            Size of the blob file in bytes.
+        blob_last_accessed (`float`):
+            Timestamp of the last time the blob file has been accessed (from any
+            revision).
+        blob_last_modified (`float`):
+            Timestamp of the last time the blob file has been modified/created.
+
+    <Tip warning={true}>
+
+    `blob_last_accessed` and `blob_last_modified` reliability can depend on the OS you
+    are using. See [python documentation](https://docs.python.org/3/library/os.html#os.stat_result)
+    for more details.
+
+    </Tip>
+    """
+
+    file_name: str
+    file_path: Path
+    blob_path: Path
+    size_on_disk: int
+
+    blob_last_accessed: float
+    blob_last_modified: float
+
+    @property
+    def blob_last_accessed_str(self) -> str:
+        """
+        (property) Timestamp of the last time the blob file has been accessed (from any
+        revision), returned as a human-readable string.
+
+        Example: "2 weeks ago".
+        """
+        return _format_timesince(self.blob_last_accessed)
+
+    @property
+    def blob_last_modified_str(self) -> str:
+        """
+        (property) Timestamp of the last time the blob file has been modified, returned
+        as a human-readable string.
+
+        Example: "2 weeks ago".
+        """
+        return _format_timesince(self.blob_last_modified)
+
+    @property
+    def size_on_disk_str(self) -> str:
+        """
+        (property) Size of the blob file as a human-readable string.
+
+        Example: "42.2K".
+        """
+        return _format_size(self.size_on_disk)
+
+
+@dataclass(frozen=True)
+class CachedRevisionInfo:
+    """Frozen data structure holding information about a revision.
+
+    A revision correspond to a folder in the `snapshots` folder and is populated with
+    the exact tree structure as the repo on the Hub but contains only symlinks. A
+    revision can be either referenced by 1 or more `refs` or be "detached" (no refs).
+
+    Args:
+        commit_hash (`str`):
+            Hash of the revision (unique).
+            Example: `"9338f7b671827df886678df2bdd7cc7b4f36dffd"`.
+        snapshot_path (`Path`):
+            Path to the revision directory in the `snapshots` folder. It contains the
+            exact tree structure as the repo on the Hub.
+        files: (`FrozenSet[CachedFileInfo]`):
+            Set of [`~CachedFileInfo`] describing all files contained in the snapshot.
+        refs (`FrozenSet[str]`):
+            Set of `refs` pointing to this revision. If the revision has no `refs`, it
+            is considered detached.
+            Example: `{"main", "2.4.0"}` or `{"refs/pr/1"}`.
+        size_on_disk (`int`):
+            Sum of the blob file sizes that are symlink-ed by the revision.
+        last_modified (`float`):
+            Timestamp of the last time the revision has been created/modified.
+
+    <Tip warning={true}>
+
+    `last_accessed` cannot be determined correctly on a single revision as blob files
+    are shared across revisions.
+
+    </Tip>
+
+    <Tip warning={true}>
+
+    `size_on_disk` is not necessarily the sum of all file sizes because of possible
+    duplicated files. Besides, only blobs are taken into account, not the (negligible)
+    size of folders and symlinks.
+
+    </Tip>
+    """
+
+    commit_hash: str
+    snapshot_path: Path
+    size_on_disk: int
+    files: FrozenSet[CachedFileInfo]
+    refs: FrozenSet[str]
+
+    last_modified: float
+
+    @property
+    def last_modified_str(self) -> str:
+        """
+        (property) Timestamp of the last time the revision has been modified, returned
+        as a human-readable string.
+
+        Example: "2 weeks ago".
+        """
+        return _format_timesince(self.last_modified)
+
+    @property
+    def size_on_disk_str(self) -> str:
+        """
+        (property) Sum of the blob file sizes as a human-readable string.
+
+        Example: "42.2K".
+        """
+        return _format_size(self.size_on_disk)
+
+    @property
+    def nb_files(self) -> int:
+        """
+        (property) Total number of files in the revision.
+        """
+        return len(self.files)
+
+
+@dataclass(frozen=True)
+class CachedRepoInfo:
+    """Frozen data structure holding information about a cached repository.
+
+    Args:
+        repo_id (`str`):
+            Repo id of the repo on the Hub. Example: `"google/fleurs"`.
+        repo_type (`Literal["dataset", "model", "space"]`):
+            Type of the cached repo.
+        repo_path (`Path`):
+            Local path to the cached repo.
+        size_on_disk (`int`):
+            Sum of the blob file sizes in the cached repo.
+        nb_files (`int`):
+            Total number of blob files in the cached repo.
+        revisions (`FrozenSet[CachedRevisionInfo]`):
+            Set of [`~CachedRevisionInfo`] describing all revisions cached in the repo.
+        last_accessed (`float`):
+            Timestamp of the last time a blob file of the repo has been accessed.
+        last_modified (`float`):
+            Timestamp of the last time a blob file of the repo has been modified/created.
+
+    <Tip warning={true}>
+
+    `size_on_disk` is not necessarily the sum of all revisions sizes because of
+    duplicated files. Besides, only blobs are taken into account, not the (negligible)
+    size of folders and symlinks.
+
+    </Tip>
+
+    <Tip warning={true}>
+
+    `last_accessed` and `last_modified` reliability can depend on the OS you are using.
+    See [python documentation](https://docs.python.org/3/library/os.html#os.stat_result)
+    for more details.
+
+    </Tip>
+    """
+
+    repo_id: str
+    repo_type: REPO_TYPE_T
+    repo_path: Path
+    size_on_disk: int
+    nb_files: int
+    revisions: FrozenSet[CachedRevisionInfo]
+
+    last_accessed: float
+    last_modified: float
+
+    @property
+    def last_accessed_str(self) -> str:
+        """
+        (property) Last time a blob file of the repo has been accessed, returned as a
+        human-readable string.
+
+        Example: "2 weeks ago".
+        """
+        return _format_timesince(self.last_accessed)
+
+    @property
+    def last_modified_str(self) -> str:
+        """
+        (property) Last time a blob file of the repo has been modified, returned as a
+        human-readable string.
+
+        Example: "2 weeks ago".
+        """
+        return _format_timesince(self.last_modified)
+
+    @property
+    def size_on_disk_str(self) -> str:
+        """
+        (property) Sum of the blob file sizes as a human-readable string.
+
+        Example: "42.2K".
+        """
+        return _format_size(self.size_on_disk)
+
+    @property
+    def refs(self) -> Dict[str, CachedRevisionInfo]:
+        """
+        (property) Mapping between `refs` and revision data structures.
+        """
+        return {ref: revision for revision in self.revisions for ref in revision.refs}
+
+
+@dataclass(frozen=True)
+class DeleteCacheStrategy:
+    """Frozen data structure holding the strategy to delete cached revisions.
+
+    This object is not meant to be instantiated programmatically but to be returned by
+    [`~utils.HFCacheInfo.delete_revisions`]. See documentation for usage example.
+
+    Args:
+        expected_freed_size (`float`):
+            Expected freed size once strategy is executed.
+        blobs (`FrozenSet[Path]`):
+            Set of blob file paths to be deleted.
+        refs (`FrozenSet[Path]`):
+            Set of reference file paths to be deleted.
+        repos (`FrozenSet[Path]`):
+            Set of entire repo paths to be deleted.
+        snapshots (`FrozenSet[Path]`):
+            Set of snapshots to be deleted (directory of symlinks).
+    """
+
+    expected_freed_size: int
+    blobs: FrozenSet[Path]
+    refs: FrozenSet[Path]
+    repos: FrozenSet[Path]
+    snapshots: FrozenSet[Path]
+
+    @property
+    def expected_freed_size_str(self) -> str:
+        """
+        (property) Expected size that will be freed as a human-readable string.
+
+        Example: "42.2K".
+        """
+        return _format_size(self.expected_freed_size)
+
+    def execute(self) -> None:
+        """Execute the defined strategy.
+
+        <Tip warning={true}>
+
+        If this method is interrupted, the cache might get corrupted. Deletion order is
+        implemented so that references and symlinks are deleted before the actual blob
+        files.
+
+        </Tip>
+
+        <Tip warning={true}>
+
+        This method is irreversible. If executed, cached files are erased and must be
+        downloaded again.
+
+        </Tip>
+        """
+        # Deletion order matters. Blobs are deleted in last so that the user can't end
+        # up in a state where a `ref`` refers to a missing snapshot or a snapshot
+        # symlink refers to a deleted blob.
+
+        # Delete entire repos
+        for path in self.repos:
+            _try_delete_path(path, path_type="repo")
+
+        # Delete snapshot directories
+        for path in self.snapshots:
+            _try_delete_path(path, path_type="snapshot")
+
+        # Delete refs files
+        for path in self.refs:
+            _try_delete_path(path, path_type="ref")
+
+        # Delete blob files
+        for path in self.blobs:
+            _try_delete_path(path, path_type="blob")
+
+        logger.info(f"Cache deletion done. Saved {self.expected_freed_size_str}.")
+
+
+@dataclass(frozen=True)
+class HFCacheInfo:
+    """Frozen data structure holding information about the entire cache-system.
+
+    This data structure is returned by [`scan_cache_dir`] and is immutable.
+
+    Args:
+        size_on_disk (`int`):
+            Sum of all valid repo sizes in the cache-system.
+        repos (`FrozenSet[CachedRepoInfo]`):
+            Set of [`~CachedRepoInfo`] describing all valid cached repos found on the
+            cache-system while scanning.
+        warnings (`List[CorruptedCacheException]`):
+            List of [`~CorruptedCacheException`] that occurred while scanning the cache.
+            Those exceptions are captured so that the scan can continue. Corrupted repos
+            are skipped from the scan.
+
+    <Tip warning={true}>
+
+    Here `size_on_disk` is equal to the sum of all repo sizes (only blobs). However if
+    some cached repos are corrupted, their sizes are not taken into account.
+
+    </Tip>
+    """
+
+    size_on_disk: int
+    repos: FrozenSet[CachedRepoInfo]
+    warnings: List[CorruptedCacheException]
+
+    @property
+    def size_on_disk_str(self) -> str:
+        """
+        (property) Sum of all valid repo sizes in the cache-system as a human-readable
+        string.
+
+        Example: "42.2K".
+        """
+        return _format_size(self.size_on_disk)
+
+    def delete_revisions(self, *revisions: str) -> DeleteCacheStrategy:
+        """Prepare the strategy to delete one or more revisions cached locally.
+
+        Input revisions can be any revision hash. If a revision hash is not found in the
+        local cache, a warning is thrown but no error is raised. Revisions can be from
+        different cached repos since hashes are unique across repos,
+
+        Examples:
+        ```py
+        >>> from huggingface_hub import scan_cache_dir
+        >>> cache_info = scan_cache_dir()
+        >>> delete_strategy = cache_info.delete_revisions(
+        ...     "81fd1d6e7847c99f5862c9fb81387956d99ec7aa"
+        ... )
+        >>> print(f"Will free {delete_strategy.expected_freed_size_str}.")
+        Will free 7.9K.
+        >>> delete_strategy.execute()
+        Cache deletion done. Saved 7.9K.
+        ```
+
+        ```py
+        >>> from huggingface_hub import scan_cache_dir
+        >>> scan_cache_dir().delete_revisions(
+        ...     "81fd1d6e7847c99f5862c9fb81387956d99ec7aa",
+        ...     "e2983b237dccf3ab4937c97fa717319a9ca1a96d",
+        ...     "6c0e6080953db56375760c0471a8c5f2929baf11",
+        ... ).execute()
+        Cache deletion done. Saved 8.6G.
+        ```
+
+        <Tip warning={true}>
+
+        `delete_revisions` returns a [`~utils.DeleteCacheStrategy`] object that needs to
+        be executed. The [`~utils.DeleteCacheStrategy`] is not meant to be modified but
+        allows having a dry run before actually executing the deletion.
+
+        </Tip>
+        """
+        hashes_to_delete: Set[str] = set(revisions)
+
+        repos_with_revisions: Dict[CachedRepoInfo, Set[CachedRevisionInfo]] = defaultdict(set)
+
+        for repo in self.repos:
+            for revision in repo.revisions:
+                if revision.commit_hash in hashes_to_delete:
+                    repos_with_revisions[repo].add(revision)
+                    hashes_to_delete.remove(revision.commit_hash)
+
+        if len(hashes_to_delete) > 0:
+            logger.warning(f"Revision(s) not found - cannot delete them: {', '.join(hashes_to_delete)}")
+
+        delete_strategy_blobs: Set[Path] = set()
+        delete_strategy_refs: Set[Path] = set()
+        delete_strategy_repos: Set[Path] = set()
+        delete_strategy_snapshots: Set[Path] = set()
+        delete_strategy_expected_freed_size = 0
+
+        for affected_repo, revisions_to_delete in repos_with_revisions.items():
+            other_revisions = affected_repo.revisions - revisions_to_delete
+
+            # If no other revisions, it means all revisions are deleted
+            # -> delete the entire cached repo
+            if len(other_revisions) == 0:
+                delete_strategy_repos.add(affected_repo.repo_path)
+                delete_strategy_expected_freed_size += affected_repo.size_on_disk
+                continue
+
+            # Some revisions of the repo will be deleted but not all. We need to filter
+            # which blob files will not be linked anymore.
+            for revision_to_delete in revisions_to_delete:
+                # Snapshot dir
+                delete_strategy_snapshots.add(revision_to_delete.snapshot_path)
+
+                # Refs dir
+                for ref in revision_to_delete.refs:
+                    delete_strategy_refs.add(affected_repo.repo_path / "refs" / ref)
+
+                # Blobs dir
+                for file in revision_to_delete.files:
+                    if file.blob_path not in delete_strategy_blobs:
+                        is_file_alone = True
+                        for revision in other_revisions:
+                            for rev_file in revision.files:
+                                if file.blob_path == rev_file.blob_path:
+                                    is_file_alone = False
+                                    break
+                            if not is_file_alone:
+                                break
+
+                        # Blob file not referenced by remaining revisions -> delete
+                        if is_file_alone:
+                            delete_strategy_blobs.add(file.blob_path)
+                            delete_strategy_expected_freed_size += file.size_on_disk
+
+        # Return the strategy instead of executing it.
+        return DeleteCacheStrategy(
+            blobs=frozenset(delete_strategy_blobs),
+            refs=frozenset(delete_strategy_refs),
+            repos=frozenset(delete_strategy_repos),
+            snapshots=frozenset(delete_strategy_snapshots),
+            expected_freed_size=delete_strategy_expected_freed_size,
+        )
+
+
+def scan_cache_dir(cache_dir: Optional[Union[str, Path]] = None) -> HFCacheInfo:
+    """Scan the entire HF cache-system and return a [`~HFCacheInfo`] structure.
+
+    Use `scan_cache_dir` in order to programmatically scan your cache-system. The cache
+    will be scanned repo by repo. If a repo is corrupted, a [`~CorruptedCacheException`]
+    will be thrown internally but captured and returned in the [`~HFCacheInfo`]
+    structure. Only valid repos get a proper report.
+
+    ```py
+    >>> from huggingface_hub import scan_cache_dir
+
+    >>> hf_cache_info = scan_cache_dir()
+    HFCacheInfo(
+        size_on_disk=3398085269,
+        repos=frozenset({
+            CachedRepoInfo(
+                repo_id='t5-small',
+                repo_type='model',
+                repo_path=PosixPath(...),
+                size_on_disk=970726914,
+                nb_files=11,
+                revisions=frozenset({
+                    CachedRevisionInfo(
+                        commit_hash='d78aea13fa7ecd06c29e3e46195d6341255065d5',
+                        size_on_disk=970726339,
+                        snapshot_path=PosixPath(...),
+                        files=frozenset({
+                            CachedFileInfo(
+                                file_name='config.json',
+                                size_on_disk=1197
+                                file_path=PosixPath(...),
+                                blob_path=PosixPath(...),
+                            ),
+                            CachedFileInfo(...),
+                            ...
+                        }),
+                    ),
+                    CachedRevisionInfo(...),
+                    ...
+                }),
+            ),
+            CachedRepoInfo(...),
+            ...
+        }),
+        warnings=[
+            CorruptedCacheException("Snapshots dir doesn't exist in cached repo: ..."),
+            CorruptedCacheException(...),
+            ...
+        ],
+    )
+    ```
+
+    You can also print a detailed report directly from the `huggingface-cli` using:
+    ```text
+    > huggingface-cli scan-cache
+    REPO ID                     REPO TYPE SIZE ON DISK NB FILES REFS                LOCAL PATH
+    --------------------------- --------- ------------ -------- ------------------- -------------------------------------------------------------------------
+    glue                        dataset         116.3K       15 1.17.0, main, 2.4.0 /Users/lucain/.cache/huggingface/hub/datasets--glue
+    google/fleurs               dataset          64.9M        6 main, refs/pr/1     /Users/lucain/.cache/huggingface/hub/datasets--google--fleurs
+    Jean-Baptiste/camembert-ner model           441.0M        7 main                /Users/lucain/.cache/huggingface/hub/models--Jean-Baptiste--camembert-ner
+    bert-base-cased             model             1.9G       13 main                /Users/lucain/.cache/huggingface/hub/models--bert-base-cased
+    t5-base                     model            10.1K        3 main                /Users/lucain/.cache/huggingface/hub/models--t5-base
+    t5-small                    model           970.7M       11 refs/pr/1, main     /Users/lucain/.cache/huggingface/hub/models--t5-small
+
+    Done in 0.0s. Scanned 6 repo(s) for a total of 3.4G.
+    Got 1 warning(s) while scanning. Use -vvv to print details.
+    ```
+
+    Args:
+        cache_dir (`str` or `Path`, `optional`):
+            Cache directory to cache. Defaults to the default HF cache directory.
+
+    <Tip warning={true}>
+
+    Raises:
+
+        `CacheNotFound`
+          If the cache directory does not exist.
+
+        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+          If the cache directory is a file, instead of a directory.
+
+    </Tip>
+
+    Returns: a [`~HFCacheInfo`] object.
+    """
+    if cache_dir is None:
+        cache_dir = HF_HUB_CACHE
+
+    cache_dir = Path(cache_dir).expanduser().resolve()
+    if not cache_dir.exists():
+        raise CacheNotFound(
+            f"Cache directory not found: {cache_dir}. Please use `cache_dir` argument or set `HF_HUB_CACHE` environment variable.",
+            cache_dir=cache_dir,
+        )
+
+    if cache_dir.is_file():
+        raise ValueError(
+            f"Scan cache expects a directory but found a file: {cache_dir}. Please use `cache_dir` argument or set `HF_HUB_CACHE` environment variable."
+        )
+
+    repos: Set[CachedRepoInfo] = set()
+    warnings: List[CorruptedCacheException] = []
+    for repo_path in cache_dir.iterdir():
+        if repo_path.name == ".locks":  # skip './.locks/' folder
+            continue
+        try:
+            repos.add(_scan_cached_repo(repo_path))
+        except CorruptedCacheException as e:
+            warnings.append(e)
+
+    return HFCacheInfo(
+        repos=frozenset(repos),
+        size_on_disk=sum(repo.size_on_disk for repo in repos),
+        warnings=warnings,
+    )
+
+
+def _scan_cached_repo(repo_path: Path) -> CachedRepoInfo:
+    """Scan a single cache repo and return information about it.
+
+    Any unexpected behavior will raise a [`~CorruptedCacheException`].
+    """
+    if not repo_path.is_dir():
+        raise CorruptedCacheException(f"Repo path is not a directory: {repo_path}")
+
+    if "--" not in repo_path.name:
+        raise CorruptedCacheException(f"Repo path is not a valid HuggingFace cache directory: {repo_path}")
+
+    repo_type, repo_id = repo_path.name.split("--", maxsplit=1)
+    repo_type = repo_type[:-1]  # "models" -> "model"
+    repo_id = repo_id.replace("--", "/")  # google/fleurs -> "google/fleurs"
+
+    if repo_type not in {"dataset", "model", "space"}:
+        raise CorruptedCacheException(
+            f"Repo type must be `dataset`, `model` or `space`, found `{repo_type}` ({repo_path})."
+        )
+
+    blob_stats: Dict[Path, os.stat_result] = {}  # Key is blob_path, value is blob stats
+
+    snapshots_path = repo_path / "snapshots"
+    refs_path = repo_path / "refs"
+
+    if not snapshots_path.exists() or not snapshots_path.is_dir():
+        raise CorruptedCacheException(f"Snapshots dir doesn't exist in cached repo: {snapshots_path}")
+
+    # Scan over `refs` directory
+
+    # key is revision hash, value is set of refs
+    refs_by_hash: Dict[str, Set[str]] = defaultdict(set)
+    if refs_path.exists():
+        # Example of `refs` directory
+        # ── refs
+        #     ├── main
+        #     └── refs
+        #         └── pr
+        #             └── 1
+        if refs_path.is_file():
+            raise CorruptedCacheException(f"Refs directory cannot be a file: {refs_path}")
+
+        for ref_path in refs_path.glob("**/*"):
+            # glob("**/*") iterates over all files and directories -> skip directories
+            if ref_path.is_dir():
+                continue
+
+            ref_name = str(ref_path.relative_to(refs_path))
+            with ref_path.open() as f:
+                commit_hash = f.read()
+
+            refs_by_hash[commit_hash].add(ref_name)
+
+    # Scan snapshots directory
+    cached_revisions: Set[CachedRevisionInfo] = set()
+    for revision_path in snapshots_path.iterdir():
+        # Ignore OS-created helper files
+        if revision_path.name in FILES_TO_IGNORE:
+            continue
+        if revision_path.is_file():
+            raise CorruptedCacheException(f"Snapshots folder corrupted. Found a file: {revision_path}")
+
+        cached_files = set()
+        for file_path in revision_path.glob("**/*"):
+            # glob("**/*") iterates over all files and directories -> skip directories
+            if file_path.is_dir():
+                continue
+
+            blob_path = Path(file_path).resolve()
+            if not blob_path.exists():
+                raise CorruptedCacheException(f"Blob missing (broken symlink): {blob_path}")
+
+            if blob_path not in blob_stats:
+                blob_stats[blob_path] = blob_path.stat()
+
+            cached_files.add(
+                CachedFileInfo(
+                    file_name=file_path.name,
+                    file_path=file_path,
+                    size_on_disk=blob_stats[blob_path].st_size,
+                    blob_path=blob_path,
+                    blob_last_accessed=blob_stats[blob_path].st_atime,
+                    blob_last_modified=blob_stats[blob_path].st_mtime,
+                )
+            )
+
+        # Last modified is either the last modified blob file or the revision folder
+        # itself if it is empty
+        if len(cached_files) > 0:
+            revision_last_modified = max(blob_stats[file.blob_path].st_mtime for file in cached_files)
+        else:
+            revision_last_modified = revision_path.stat().st_mtime
+
+        cached_revisions.add(
+            CachedRevisionInfo(
+                commit_hash=revision_path.name,
+                files=frozenset(cached_files),
+                refs=frozenset(refs_by_hash.pop(revision_path.name, set())),
+                size_on_disk=sum(
+                    blob_stats[blob_path].st_size for blob_path in set(file.blob_path for file in cached_files)
+                ),
+                snapshot_path=revision_path,
+                last_modified=revision_last_modified,
+            )
+        )
+
+    # Check that all refs referred to an existing revision
+    if len(refs_by_hash) > 0:
+        raise CorruptedCacheException(
+            f"Reference(s) refer to missing commit hashes: {dict(refs_by_hash)} ({repo_path})."
+        )
+
+    # Last modified is either the last modified blob file or the repo folder itself if
+    # no blob files has been found. Same for last accessed.
+    if len(blob_stats) > 0:
+        repo_last_accessed = max(stat.st_atime for stat in blob_stats.values())
+        repo_last_modified = max(stat.st_mtime for stat in blob_stats.values())
+    else:
+        repo_stats = repo_path.stat()
+        repo_last_accessed = repo_stats.st_atime
+        repo_last_modified = repo_stats.st_mtime
+
+    # Build and return frozen structure
+    return CachedRepoInfo(
+        nb_files=len(blob_stats),
+        repo_id=repo_id,
+        repo_path=repo_path,
+        repo_type=repo_type,  # type: ignore
+        revisions=frozenset(cached_revisions),
+        size_on_disk=sum(stat.st_size for stat in blob_stats.values()),
+        last_accessed=repo_last_accessed,
+        last_modified=repo_last_modified,
+    )
+
+
+def _format_size(num: int) -> str:
+    """Format size in bytes into a human-readable string.
+
+    Taken from https://stackoverflow.com/a/1094933
+    """
+    num_f = float(num)
+    for unit in ["", "K", "M", "G", "T", "P", "E", "Z"]:
+        if abs(num_f) < 1000.0:
+            return f"{num_f:3.1f}{unit}"
+        num_f /= 1000.0
+    return f"{num_f:.1f}Y"
+
+
+_TIMESINCE_CHUNKS = (
+    # Label, divider, max value
+    ("second", 1, 60),
+    ("minute", 60, 60),
+    ("hour", 60 * 60, 24),
+    ("day", 60 * 60 * 24, 6),
+    ("week", 60 * 60 * 24 * 7, 6),
+    ("month", 60 * 60 * 24 * 30, 11),
+    ("year", 60 * 60 * 24 * 365, None),
+)
+
+
+def _format_timesince(ts: float) -> str:
+    """Format timestamp in seconds into a human-readable string, relative to now.
+
+    Vaguely inspired by Django's `timesince` formatter.
+    """
+    delta = time.time() - ts
+    if delta < 20:
+        return "a few seconds ago"
+    for label, divider, max_value in _TIMESINCE_CHUNKS:  # noqa: B007
+        value = round(delta / divider)
+        if max_value is not None and value <= max_value:
+            break
+    return f"{value} {label}{'s' if value > 1 else ''} ago"
+
+
+def _try_delete_path(path: Path, path_type: str) -> None:
+    """Try to delete a local file or folder.
+
+    If the path does not exists, error is logged as a warning and then ignored.
+
+    Args:
+        path (`Path`)
+            Path to delete. Can be a file or a folder.
+        path_type (`str`)
+            What path are we deleting ? Only for logging purposes. Example: "snapshot".
+    """
+    logger.info(f"Delete {path_type}: {path}")
+    try:
+        if path.is_file():
+            os.remove(path)
+        else:
+            shutil.rmtree(path)
+    except FileNotFoundError:
+        logger.warning(f"Couldn't delete {path_type}: file not found ({path})", exc_info=True)
+    except PermissionError:
+        logger.warning(f"Couldn't delete {path_type}: permission denied ({path})", exc_info=True)
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_chunk_utils.py b/llm/Lib/site-packages/huggingface_hub/utils/_chunk_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..b0af032ae6a68f03676ad7fdb8e483248d9853f8
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_chunk_utils.py
@@ -0,0 +1,65 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains a utility to iterate by chunks over an iterator."""
+
+import itertools
+from typing import Iterable, TypeVar
+
+
+T = TypeVar("T")
+
+
+def chunk_iterable(iterable: Iterable[T], chunk_size: int) -> Iterable[Iterable[T]]:
+    """Iterates over an iterator chunk by chunk.
+
+    Taken from https://stackoverflow.com/a/8998040.
+    See also https://github.com/huggingface/huggingface_hub/pull/920#discussion_r938793088.
+
+    Args:
+        iterable (`Iterable`):
+            The iterable on which we want to iterate.
+        chunk_size (`int`):
+            Size of the chunks. Must be a strictly positive integer (e.g. >0).
+
+    Example:
+
+    ```python
+    >>> from huggingface_hub.utils import chunk_iterable
+
+    >>> for items in chunk_iterable(range(17), chunk_size=8):
+    ...     print(items)
+    # [0, 1, 2, 3, 4, 5, 6, 7]
+    # [8, 9, 10, 11, 12, 13, 14, 15]
+    # [16] # smaller last chunk
+    ```
+
+    Raises:
+        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If `chunk_size` <= 0.
+
+    <Tip warning={true}>
+        The last chunk can be smaller than `chunk_size`.
+    </Tip>
+    """
+    if not isinstance(chunk_size, int) or chunk_size <= 0:
+        raise ValueError("`chunk_size` must be a strictly positive integer (>0).")
+
+    iterator = iter(iterable)
+    while True:
+        try:
+            next_item = next(iterator)
+        except StopIteration:
+            return
+        yield itertools.chain((next_item,), itertools.islice(iterator, chunk_size - 1))
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_datetime.py b/llm/Lib/site-packages/huggingface_hub/utils/_datetime.py
new file mode 100644
index 0000000000000000000000000000000000000000..e544884b8793d8d409303cafd34586523fc3fb1c
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_datetime.py
@@ -0,0 +1,62 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains utilities to handle datetimes in Huggingface Hub."""
+
+from datetime import datetime, timezone
+
+
+def parse_datetime(date_string: str) -> datetime:
+    """
+    Parses a date_string returned from the server to a datetime object.
+
+    This parser is a weak-parser is the sense that it handles only a single format of
+    date_string. It is expected that the server format will never change. The
+    implementation depends only on the standard lib to avoid an external dependency
+    (python-dateutil). See full discussion about this decision on PR:
+    https://github.com/huggingface/huggingface_hub/pull/999.
+
+    Example:
+        ```py
+        > parse_datetime('2022-08-19T07:19:38.123Z')
+        datetime.datetime(2022, 8, 19, 7, 19, 38, 123000, tzinfo=timezone.utc)
+        ```
+
+    Args:
+        date_string (`str`):
+            A string representing a datetime returned by the Hub server.
+            String is expected to follow '%Y-%m-%dT%H:%M:%S.%fZ' pattern.
+
+    Returns:
+        A python datetime object.
+
+    Raises:
+        :class:`ValueError`:
+            If `date_string` cannot be parsed.
+    """
+    try:
+        # Datetime ending with a Z means "UTC". We parse the date and then explicitly
+        # set the timezone to UTC.
+        # See https://en.wikipedia.org/wiki/ISO_8601#Coordinated_Universal_Time_(UTC)
+        # Taken from https://stackoverflow.com/a/3168394.
+        if len(date_string) == 30:
+            # Means timezoned-timestamp with nanoseconds precision. We need to truncate the last 3 digits.
+            date_string = date_string[:-4] + "Z"
+        dt = datetime.strptime(date_string, "%Y-%m-%dT%H:%M:%S.%fZ")
+        return dt.replace(tzinfo=timezone.utc)  # Set explicit timezone
+    except ValueError as e:
+        raise ValueError(
+            f"Cannot parse '{date_string}' as a datetime. Date string is expected to"
+            " follow '%Y-%m-%dT%H:%M:%S.%fZ' pattern."
+        ) from e
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_deprecation.py b/llm/Lib/site-packages/huggingface_hub/utils/_deprecation.py
new file mode 100644
index 0000000000000000000000000000000000000000..4cb8d6e418c76accd1ecd61158b4bdd265e12f71
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_deprecation.py
@@ -0,0 +1,136 @@
+import warnings
+from functools import wraps
+from inspect import Parameter, signature
+from typing import Iterable, Optional
+
+
+def _deprecate_positional_args(*, version: str):
+    """Decorator for methods that issues warnings for positional arguments.
+    Using the keyword-only argument syntax in pep 3102, arguments after the
+    * will issue a warning when passed as a positional argument.
+
+    Args:
+        version (`str`):
+            The version when positional arguments will result in error.
+    """
+
+    def _inner_deprecate_positional_args(f):
+        sig = signature(f)
+        kwonly_args = []
+        all_args = []
+        for name, param in sig.parameters.items():
+            if param.kind == Parameter.POSITIONAL_OR_KEYWORD:
+                all_args.append(name)
+            elif param.kind == Parameter.KEYWORD_ONLY:
+                kwonly_args.append(name)
+
+        @wraps(f)
+        def inner_f(*args, **kwargs):
+            extra_args = len(args) - len(all_args)
+            if extra_args <= 0:
+                return f(*args, **kwargs)
+            # extra_args > 0
+            args_msg = [
+                f"{name}='{arg}'" if isinstance(arg, str) else f"{name}={arg}"
+                for name, arg in zip(kwonly_args[:extra_args], args[-extra_args:])
+            ]
+            args_msg = ", ".join(args_msg)
+            warnings.warn(
+                f"Deprecated positional argument(s) used in '{f.__name__}': pass"
+                f" {args_msg} as keyword args. From version {version} passing these"
+                " as positional arguments will result in an error,",
+                FutureWarning,
+            )
+            kwargs.update(zip(sig.parameters, args))
+            return f(**kwargs)
+
+        return inner_f
+
+    return _inner_deprecate_positional_args
+
+
+def _deprecate_arguments(
+    *,
+    version: str,
+    deprecated_args: Iterable[str],
+    custom_message: Optional[str] = None,
+):
+    """Decorator to issue warnings when using deprecated arguments.
+
+    TODO: could be useful to be able to set a custom error message.
+
+    Args:
+        version (`str`):
+            The version when deprecated arguments will result in error.
+        deprecated_args (`List[str]`):
+            List of the arguments to be deprecated.
+        custom_message (`str`, *optional*):
+            Warning message that is raised. If not passed, a default warning message
+            will be created.
+    """
+
+    def _inner_deprecate_positional_args(f):
+        sig = signature(f)
+
+        @wraps(f)
+        def inner_f(*args, **kwargs):
+            # Check for used deprecated arguments
+            used_deprecated_args = []
+            for _, parameter in zip(args, sig.parameters.values()):
+                if parameter.name in deprecated_args:
+                    used_deprecated_args.append(parameter.name)
+            for kwarg_name, kwarg_value in kwargs.items():
+                if (
+                    # If argument is deprecated but still used
+                    kwarg_name in deprecated_args
+                    # And then the value is not the default value
+                    and kwarg_value != sig.parameters[kwarg_name].default
+                ):
+                    used_deprecated_args.append(kwarg_name)
+
+            # Warn and proceed
+            if len(used_deprecated_args) > 0:
+                message = (
+                    f"Deprecated argument(s) used in '{f.__name__}':"
+                    f" {', '.join(used_deprecated_args)}. Will not be supported from"
+                    f" version '{version}'."
+                )
+                if custom_message is not None:
+                    message += "\n\n" + custom_message
+                warnings.warn(message, FutureWarning)
+            return f(*args, **kwargs)
+
+        return inner_f
+
+    return _inner_deprecate_positional_args
+
+
+def _deprecate_method(*, version: str, message: Optional[str] = None):
+    """Decorator to issue warnings when using a deprecated method.
+
+    Args:
+        version (`str`):
+            The version when deprecated arguments will result in error.
+        message (`str`, *optional*):
+            Warning message that is raised. If not passed, a default warning message
+            will be created.
+    """
+
+    def _inner_deprecate_method(f):
+        name = f.__name__
+        if name == "__init__":
+            name = f.__qualname__.split(".")[0]  # class name instead of method name
+
+        @wraps(f)
+        def inner_f(*args, **kwargs):
+            warning_message = (
+                f"'{name}' (from '{f.__module__}') is deprecated and will be removed from version '{version}'."
+            )
+            if message is not None:
+                warning_message += " " + message
+            warnings.warn(warning_message, FutureWarning)
+            return f(*args, **kwargs)
+
+        return inner_f
+
+    return _inner_deprecate_method
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_errors.py b/llm/Lib/site-packages/huggingface_hub/utils/_errors.py
new file mode 100644
index 0000000000000000000000000000000000000000..70e97f0c24101243bce003f0ca55d852c02a48cd
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_errors.py
@@ -0,0 +1,397 @@
+import re
+from typing import Optional
+
+from requests import HTTPError, Response
+
+from ._fixes import JSONDecodeError
+
+
+REPO_API_REGEX = re.compile(
+    r"""
+        # staging or production endpoint
+        ^https://[^/]+
+        (
+            # on /api/repo_type/repo_id
+            /api/(models|datasets|spaces)/(.+)
+            |
+            # or /repo_id/resolve/revision/...
+            /(.+)/resolve/(.+)
+        )
+    """,
+    flags=re.VERBOSE,
+)
+
+
+class FileMetadataError(OSError):
+    """Error triggered when the metadata of a file on the Hub cannot be retrieved (missing ETag or commit_hash).
+
+    Inherits from `OSError` for backward compatibility.
+    """
+
+
+class HfHubHTTPError(HTTPError):
+    """
+    HTTPError to inherit from for any custom HTTP Error raised in HF Hub.
+
+    Any HTTPError is converted at least into a `HfHubHTTPError`. If some information is
+    sent back by the server, it will be added to the error message.
+
+    Added details:
+    - Request id from "X-Request-Id" header if exists.
+    - Server error message from the header "X-Error-Message".
+    - Server error message if we can found one in the response body.
+
+    Example:
+    ```py
+        import requests
+        from huggingface_hub.utils import get_session, hf_raise_for_status, HfHubHTTPError
+
+        response = get_session().post(...)
+        try:
+            hf_raise_for_status(response)
+        except HfHubHTTPError as e:
+            print(str(e)) # formatted message
+            e.request_id, e.server_message # details returned by server
+
+            # Complete the error message with additional information once it's raised
+            e.append_to_message("\n`create_commit` expects the repository to exist.")
+            raise
+    ```
+    """
+
+    request_id: Optional[str] = None
+    server_message: Optional[str] = None
+
+    def __init__(self, message: str, response: Optional[Response] = None):
+        # Parse server information if any.
+        if response is not None:
+            self.request_id = response.headers.get("X-Request-Id")
+            try:
+                server_data = response.json()
+            except JSONDecodeError:
+                server_data = {}
+
+            # Retrieve server error message from multiple sources
+            server_message_from_headers = response.headers.get("X-Error-Message")
+            server_message_from_body = server_data.get("error")
+            server_multiple_messages_from_body = "\n".join(
+                error["message"] for error in server_data.get("errors", []) if "message" in error
+            )
+
+            # Concatenate error messages
+            _server_message = ""
+            if server_message_from_headers is not None:  # from headers
+                _server_message += server_message_from_headers + "\n"
+            if server_message_from_body is not None:  # from body "error"
+                if isinstance(server_message_from_body, list):
+                    server_message_from_body = "\n".join(server_message_from_body)
+                if server_message_from_body not in _server_message:
+                    _server_message += server_message_from_body + "\n"
+            if server_multiple_messages_from_body is not None:  # from body "errors"
+                if server_multiple_messages_from_body not in _server_message:
+                    _server_message += server_multiple_messages_from_body + "\n"
+            _server_message = _server_message.strip()
+
+            # Set message to `HfHubHTTPError` (if any)
+            if _server_message != "":
+                self.server_message = _server_message
+
+        super().__init__(
+            _format_error_message(
+                message,
+                request_id=self.request_id,
+                server_message=self.server_message,
+            ),
+            response=response,  # type: ignore
+            request=response.request if response is not None else None,  # type: ignore
+        )
+
+    def append_to_message(self, additional_message: str) -> None:
+        """Append additional information to the `HfHubHTTPError` initial message."""
+        self.args = (self.args[0] + additional_message,) + self.args[1:]
+
+
+class RepositoryNotFoundError(HfHubHTTPError):
+    """
+    Raised when trying to access a hf.co URL with an invalid repository name, or
+    with a private repo name the user does not have access to.
+
+    Example:
+
+    ```py
+    >>> from huggingface_hub import model_info
+    >>> model_info("<non_existent_repository>")
+    (...)
+    huggingface_hub.utils._errors.RepositoryNotFoundError: 401 Client Error. (Request ID: PvMw_VjBMjVdMz53WKIzP)
+
+    Repository Not Found for url: https://huggingface.co/api/models/%3Cnon_existent_repository%3E.
+    Please make sure you specified the correct `repo_id` and `repo_type`.
+    If the repo is private, make sure you are authenticated.
+    Invalid username or password.
+    ```
+    """
+
+
+class GatedRepoError(RepositoryNotFoundError):
+    """
+    Raised when trying to access a gated repository for which the user is not on the
+    authorized list.
+
+    Note: derives from `RepositoryNotFoundError` to ensure backward compatibility.
+
+    Example:
+
+    ```py
+    >>> from huggingface_hub import model_info
+    >>> model_info("<gated_repository>")
+    (...)
+    huggingface_hub.utils._errors.GatedRepoError: 403 Client Error. (Request ID: ViT1Bf7O_026LGSQuVqfa)
+
+    Cannot access gated repo for url https://huggingface.co/api/models/ardent-figment/gated-model.
+    Access to model ardent-figment/gated-model is restricted and you are not in the authorized list.
+    Visit https://huggingface.co/ardent-figment/gated-model to ask for access.
+    ```
+    """
+
+
+class DisabledRepoError(HfHubHTTPError):
+    """
+    Raised when trying to access a repository that has been disabled by its author.
+
+    Example:
+
+    ```py
+    >>> from huggingface_hub import dataset_info
+    >>> dataset_info("laion/laion-art")
+    (...)
+    huggingface_hub.utils._errors.DisabledRepoError: 403 Client Error. (Request ID: Root=1-659fc3fa-3031673e0f92c71a2260dbe2;bc6f4dfb-b30a-4862-af0a-5cfe827610d8)
+
+    Cannot access repository for url https://huggingface.co/api/datasets/laion/laion-art.
+    Access to this resource is disabled.
+    ```
+    """
+
+
+class RevisionNotFoundError(HfHubHTTPError):
+    """
+    Raised when trying to access a hf.co URL with a valid repository but an invalid
+    revision.
+
+    Example:
+
+    ```py
+    >>> from huggingface_hub import hf_hub_download
+    >>> hf_hub_download('bert-base-cased', 'config.json', revision='<non-existent-revision>')
+    (...)
+    huggingface_hub.utils._errors.RevisionNotFoundError: 404 Client Error. (Request ID: Mwhe_c3Kt650GcdKEFomX)
+
+    Revision Not Found for url: https://huggingface.co/bert-base-cased/resolve/%3Cnon-existent-revision%3E/config.json.
+    ```
+    """
+
+
+class EntryNotFoundError(HfHubHTTPError):
+    """
+    Raised when trying to access a hf.co URL with a valid repository and revision
+    but an invalid filename.
+
+    Example:
+
+    ```py
+    >>> from huggingface_hub import hf_hub_download
+    >>> hf_hub_download('bert-base-cased', '<non-existent-file>')
+    (...)
+    huggingface_hub.utils._errors.EntryNotFoundError: 404 Client Error. (Request ID: 53pNl6M0MxsnG5Sw8JA6x)
+
+    Entry Not Found for url: https://huggingface.co/bert-base-cased/resolve/main/%3Cnon-existent-file%3E.
+    ```
+    """
+
+
+class LocalEntryNotFoundError(EntryNotFoundError, FileNotFoundError, ValueError):
+    """
+    Raised when trying to access a file or snapshot that is not on the disk when network is
+    disabled or unavailable (connection issue). The entry may exist on the Hub.
+
+    Note: `ValueError` type is to ensure backward compatibility.
+    Note: `LocalEntryNotFoundError` derives from `HTTPError` because of `EntryNotFoundError`
+          even when it is not a network issue.
+
+    Example:
+
+    ```py
+    >>> from huggingface_hub import hf_hub_download
+    >>> hf_hub_download('bert-base-cased', '<non-cached-file>',  local_files_only=True)
+    (...)
+    huggingface_hub.utils._errors.LocalEntryNotFoundError: Cannot find the requested files in the disk cache and outgoing traffic has been disabled. To enable hf.co look-ups and downloads online, set 'local_files_only' to False.
+    ```
+    """
+
+    def __init__(self, message: str):
+        super().__init__(message, response=None)
+
+
+class BadRequestError(HfHubHTTPError, ValueError):
+    """
+    Raised by `hf_raise_for_status` when the server returns a HTTP 400 error.
+
+    Example:
+
+    ```py
+    >>> resp = requests.post("hf.co/api/check", ...)
+    >>> hf_raise_for_status(resp, endpoint_name="check")
+    huggingface_hub.utils._errors.BadRequestError: Bad request for check endpoint: {details} (Request ID: XXX)
+    ```
+    """
+
+
+def hf_raise_for_status(response: Response, endpoint_name: Optional[str] = None) -> None:
+    """
+    Internal version of `response.raise_for_status()` that will refine a
+    potential HTTPError. Raised exception will be an instance of `HfHubHTTPError`.
+
+    This helper is meant to be the unique method to raise_for_status when making a call
+    to the Hugging Face Hub.
+
+    Example:
+    ```py
+        import requests
+        from huggingface_hub.utils import get_session, hf_raise_for_status, HfHubHTTPError
+
+        response = get_session().post(...)
+        try:
+            hf_raise_for_status(response)
+        except HfHubHTTPError as e:
+            print(str(e)) # formatted message
+            e.request_id, e.server_message # details returned by server
+
+            # Complete the error message with additional information once it's raised
+            e.append_to_message("\n`create_commit` expects the repository to exist.")
+            raise
+    ```
+
+    Args:
+        response (`Response`):
+            Response from the server.
+        endpoint_name (`str`, *optional*):
+            Name of the endpoint that has been called. If provided, the error message
+            will be more complete.
+
+    <Tip warning={true}>
+
+    Raises when the request has failed:
+
+        - [`~utils.RepositoryNotFoundError`]
+            If the repository to download from cannot be found. This may be because it
+            doesn't exist, because `repo_type` is not set correctly, or because the repo
+            is `private` and you do not have access.
+        - [`~utils.GatedRepoError`]
+            If the repository exists but is gated and the user is not on the authorized
+            list.
+        - [`~utils.RevisionNotFoundError`]
+            If the repository exists but the revision couldn't be find.
+        - [`~utils.EntryNotFoundError`]
+            If the repository exists but the entry (e.g. the requested file) couldn't be
+            find.
+        - [`~utils.BadRequestError`]
+            If request failed with a HTTP 400 BadRequest error.
+        - [`~utils.HfHubHTTPError`]
+            If request failed for a reason not listed above.
+
+    </Tip>
+    """
+    try:
+        response.raise_for_status()
+    except HTTPError as e:
+        error_code = response.headers.get("X-Error-Code")
+        error_message = response.headers.get("X-Error-Message")
+
+        if error_code == "RevisionNotFound":
+            message = f"{response.status_code} Client Error." + "\n\n" + f"Revision Not Found for url: {response.url}."
+            raise RevisionNotFoundError(message, response) from e
+
+        elif error_code == "EntryNotFound":
+            message = f"{response.status_code} Client Error." + "\n\n" + f"Entry Not Found for url: {response.url}."
+            raise EntryNotFoundError(message, response) from e
+
+        elif error_code == "GatedRepo":
+            message = (
+                f"{response.status_code} Client Error." + "\n\n" + f"Cannot access gated repo for url {response.url}."
+            )
+            raise GatedRepoError(message, response) from e
+
+        elif error_message == "Access to this resource is disabled.":
+            message = (
+                f"{response.status_code} Client Error."
+                + "\n\n"
+                + f"Cannot access repository for url {response.url}."
+                + "\n"
+                + "Access to this resource is disabled."
+            )
+            raise DisabledRepoError(message, response) from e
+
+        elif error_code == "RepoNotFound" or (
+            response.status_code == 401
+            and response.request is not None
+            and response.request.url is not None
+            and REPO_API_REGEX.search(response.request.url) is not None
+        ):
+            # 401 is misleading as it is returned for:
+            #    - private and gated repos if user is not authenticated
+            #    - missing repos
+            # => for now, we process them as `RepoNotFound` anyway.
+            # See https://gist.github.com/Wauplin/46c27ad266b15998ce56a6603796f0b9
+            message = (
+                f"{response.status_code} Client Error."
+                + "\n\n"
+                + f"Repository Not Found for url: {response.url}."
+                + "\nPlease make sure you specified the correct `repo_id` and"
+                " `repo_type`.\nIf you are trying to access a private or gated repo,"
+                " make sure you are authenticated."
+            )
+            raise RepositoryNotFoundError(message, response) from e
+
+        elif response.status_code == 400:
+            message = (
+                f"\n\nBad request for {endpoint_name} endpoint:" if endpoint_name is not None else "\n\nBad request:"
+            )
+            raise BadRequestError(message, response=response) from e
+
+        elif response.status_code == 403:
+            message = (
+                f"\n\n{response.status_code} Forbidden: {error_message}."
+                + f"\nCannot access content at: {response.url}."
+                + "\nIf you are trying to create or update content,"
+                + "make sure you have a token with the `write` role."
+            )
+            raise HfHubHTTPError(message, response=response) from e
+
+        # Convert `HTTPError` into a `HfHubHTTPError` to display request information
+        # as well (request id and/or server error message)
+        raise HfHubHTTPError(str(e), response=response) from e
+
+
+def _format_error_message(message: str, request_id: Optional[str], server_message: Optional[str]) -> str:
+    """
+    Format the `HfHubHTTPError` error message based on initial message and information
+    returned by the server.
+
+    Used when initializing `HfHubHTTPError`.
+    """
+    # Add message from response body
+    if server_message is not None and len(server_message) > 0 and server_message.lower() not in message.lower():
+        if "\n\n" in message:
+            message += "\n" + server_message
+        else:
+            message += "\n\n" + server_message
+
+    # Add Request ID
+    if request_id is not None and str(request_id).lower() not in message.lower():
+        request_id_message = f" (Request ID: {request_id})"
+        if "\n" in message:
+            newline_index = message.index("\n")
+            message = message[:newline_index] + request_id_message + message[newline_index:]
+        else:
+            message += request_id_message
+
+    return message
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_experimental.py b/llm/Lib/site-packages/huggingface_hub/utils/_experimental.py
new file mode 100644
index 0000000000000000000000000000000000000000..34141eba09123c06fbca55c929a19a0264e5788e
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_experimental.py
@@ -0,0 +1,66 @@
+# coding=utf-8
+# Copyright 2023-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains utilities to flag a feature as "experimental" in Huggingface Hub."""
+
+import warnings
+from functools import wraps
+from typing import Callable
+
+from .. import constants
+
+
+def experimental(fn: Callable) -> Callable:
+    """Decorator to flag a feature as experimental.
+
+    An experimental feature trigger a warning when used as it might be subject to breaking changes in the future.
+    Warnings can be disabled by setting the environment variable `HF_EXPERIMENTAL_WARNING` to `0`.
+
+    Args:
+        fn (`Callable`):
+            The function to flag as experimental.
+
+    Returns:
+        `Callable`: The decorated function.
+
+    Example:
+
+    ```python
+    >>> from huggingface_hub.utils import experimental
+
+    >>> @experimental
+    ... def my_function():
+    ...     print("Hello world!")
+
+    >>> my_function()
+    UserWarning: 'my_function' is experimental and might be subject to breaking changes in the future. You can disable
+    this warning by setting `HF_HUB_DISABLE_EXPERIMENTAL_WARNING=1` as environment variable.
+    Hello world!
+    ```
+    """
+    # For classes, put the "experimental" around the "__new__" method => __new__ will be removed in warning message
+    name = fn.__qualname__[: -len(".__new__")] if fn.__qualname__.endswith(".__new__") else fn.__qualname__
+
+    @wraps(fn)
+    def _inner_fn(*args, **kwargs):
+        if not constants.HF_HUB_DISABLE_EXPERIMENTAL_WARNING:
+            warnings.warn(
+                f"'{name}' is experimental and might be subject to breaking changes in the future."
+                " You can disable this warning by setting `HF_HUB_DISABLE_EXPERIMENTAL_WARNING=1` as environment"
+                " variable.",
+                UserWarning,
+            )
+        return fn(*args, **kwargs)
+
+    return _inner_fn
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_fixes.py b/llm/Lib/site-packages/huggingface_hub/utils/_fixes.py
new file mode 100644
index 0000000000000000000000000000000000000000..1edcbc1eeedc8d89a8c9b9ff8a4cbe4371ce2576
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_fixes.py
@@ -0,0 +1,93 @@
+# JSONDecodeError was introduced in requests=2.27 released in 2022.
+# This allows us to support older requests for users
+# More information: https://github.com/psf/requests/pull/5856
+try:
+    from requests import JSONDecodeError  # type: ignore  # noqa: F401
+except ImportError:
+    try:
+        from simplejson import JSONDecodeError  # type: ignore # noqa: F401
+    except ImportError:
+        from json import JSONDecodeError  # type: ignore  # noqa: F401
+import contextlib
+import os
+import shutil
+import stat
+import tempfile
+from functools import partial
+from pathlib import Path
+from typing import Callable, Generator, Optional, Union
+
+import yaml
+from filelock import BaseFileLock, FileLock
+
+
+# Wrap `yaml.dump` to set `allow_unicode=True` by default.
+#
+# Example:
+# ```py
+# >>> yaml.dump({"emoji": "👀", "some unicode": "日本か"})
+# 'emoji: "\\U0001F440"\nsome unicode: "\\u65E5\\u672C\\u304B"\n'
+#
+# >>> yaml_dump({"emoji": "👀", "some unicode": "日本か"})
+# 'emoji: "👀"\nsome unicode: "日本か"\n'
+# ```
+yaml_dump: Callable[..., str] = partial(yaml.dump, stream=None, allow_unicode=True)  # type: ignore
+
+
+@contextlib.contextmanager
+def SoftTemporaryDirectory(
+    suffix: Optional[str] = None,
+    prefix: Optional[str] = None,
+    dir: Optional[Union[Path, str]] = None,
+    **kwargs,
+) -> Generator[Path, None, None]:
+    """
+    Context manager to create a temporary directory and safely delete it.
+
+    If tmp directory cannot be deleted normally, we set the WRITE permission and retry.
+    If cleanup still fails, we give up but don't raise an exception. This is equivalent
+    to  `tempfile.TemporaryDirectory(..., ignore_cleanup_errors=True)` introduced in
+    Python 3.10.
+
+    See https://www.scivision.dev/python-tempfile-permission-error-windows/.
+    """
+    tmpdir = tempfile.TemporaryDirectory(prefix=prefix, suffix=suffix, dir=dir, **kwargs)
+    yield Path(tmpdir.name).resolve()
+
+    try:
+        # First once with normal cleanup
+        shutil.rmtree(tmpdir.name)
+    except Exception:
+        # If failed, try to set write permission and retry
+        try:
+            shutil.rmtree(tmpdir.name, onerror=_set_write_permission_and_retry)
+        except Exception:
+            pass
+
+    # And finally, cleanup the tmpdir.
+    # If it fails again, give up but do not throw error
+    try:
+        tmpdir.cleanup()
+    except Exception:
+        pass
+
+
+def _set_write_permission_and_retry(func, path, excinfo):
+    os.chmod(path, stat.S_IWRITE)
+    func(path)
+
+
+@contextlib.contextmanager
+def WeakFileLock(lock_file: Union[str, Path]) -> Generator[BaseFileLock, None, None]:
+    lock = FileLock(lock_file)
+    lock.acquire()
+
+    yield lock
+
+    try:
+        return lock.release()
+    except OSError:
+        try:
+            Path(lock_file).unlink()
+        except OSError:
+            pass
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_git_credential.py b/llm/Lib/site-packages/huggingface_hub/utils/_git_credential.py
new file mode 100644
index 0000000000000000000000000000000000000000..a8ed77f4e49ca88ff4fa9aba48cbf00195036013
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_git_credential.py
@@ -0,0 +1,121 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains utilities to manage Git credentials."""
+
+import re
+import subprocess
+from typing import List, Optional
+
+from ..constants import ENDPOINT
+from ._subprocess import run_interactive_subprocess, run_subprocess
+
+
+GIT_CREDENTIAL_REGEX = re.compile(
+    r"""
+        ^\s* # start of line
+        credential\.helper # credential.helper value
+        \s*=\s* # separator
+        (\w+) # the helper name (group 1)
+        (\s|$) # whitespace or end of line
+    """,
+    flags=re.MULTILINE | re.IGNORECASE | re.VERBOSE,
+)
+
+
+def list_credential_helpers(folder: Optional[str] = None) -> List[str]:
+    """Return the list of git credential helpers configured.
+
+    See https://git-scm.com/docs/gitcredentials.
+
+    Credentials are saved in all configured helpers (store, cache, macOS keychain,...).
+    Calls "`git credential approve`" internally. See https://git-scm.com/docs/git-credential.
+
+    Args:
+        folder (`str`, *optional*):
+            The folder in which to check the configured helpers.
+    """
+    try:
+        output = run_subprocess("git config --list", folder=folder).stdout
+        parsed = _parse_credential_output(output)
+        return parsed
+    except subprocess.CalledProcessError as exc:
+        raise EnvironmentError(exc.stderr)
+
+
+def set_git_credential(token: str, username: str = "hf_user", folder: Optional[str] = None) -> None:
+    """Save a username/token pair in git credential for HF Hub registry.
+
+    Credentials are saved in all configured helpers (store, cache, macOS keychain,...).
+    Calls "`git credential approve`" internally. See https://git-scm.com/docs/git-credential.
+
+    Args:
+        username (`str`, defaults to `"hf_user"`):
+            A git username. Defaults to `"hf_user"`, the default user used in the Hub.
+        token (`str`, defaults to `"hf_user"`):
+            A git password. In practice, the User Access Token for the Hub.
+            See https://huggingface.co/settings/tokens.
+        folder (`str`, *optional*):
+            The folder in which to check the configured helpers.
+    """
+    with run_interactive_subprocess("git credential approve", folder=folder) as (
+        stdin,
+        _,
+    ):
+        stdin.write(f"url={ENDPOINT}\nusername={username.lower()}\npassword={token}\n\n")
+        stdin.flush()
+
+
+def unset_git_credential(username: str = "hf_user", folder: Optional[str] = None) -> None:
+    """Erase credentials from git credential for HF Hub registry.
+
+    Credentials are erased from the configured helpers (store, cache, macOS
+    keychain,...), if any. If `username` is not provided, any credential configured for
+    HF Hub endpoint is erased.
+    Calls "`git credential erase`" internally. See https://git-scm.com/docs/git-credential.
+
+    Args:
+        username (`str`, defaults to `"hf_user"`):
+            A git username. Defaults to `"hf_user"`, the default user used in the Hub.
+        folder (`str`, *optional*):
+            The folder in which to check the configured helpers.
+    """
+    with run_interactive_subprocess("git credential reject", folder=folder) as (
+        stdin,
+        _,
+    ):
+        standard_input = f"url={ENDPOINT}\n"
+        if username is not None:
+            standard_input += f"username={username.lower()}\n"
+        standard_input += "\n"
+
+        stdin.write(standard_input)
+        stdin.flush()
+
+
+def _parse_credential_output(output: str) -> List[str]:
+    """Parse the output of `git credential fill` to extract the password.
+
+    Args:
+        output (`str`):
+            The output of `git credential fill`.
+    """
+    # NOTE: If user has set an helper for a custom URL, it will not we caught here.
+    #       Example: `credential.https://huggingface.co.helper=store`
+    #       See: https://github.com/huggingface/huggingface_hub/pull/1138#discussion_r1013324508
+    return sorted(  # Sort for nice printing
+        set(  # Might have some duplicates
+            match[0] for match in GIT_CREDENTIAL_REGEX.findall(output)
+        )
+    )
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_headers.py b/llm/Lib/site-packages/huggingface_hub/utils/_headers.py
new file mode 100644
index 0000000000000000000000000000000000000000..fdcaf06e9d19de202a6e84b8bde212d4482d1b07
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_headers.py
@@ -0,0 +1,241 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains utilities to handle headers to send in calls to Huggingface Hub."""
+
+from typing import Dict, Optional, Union
+
+from .. import constants
+from ._runtime import (
+    get_fastai_version,
+    get_fastcore_version,
+    get_hf_hub_version,
+    get_python_version,
+    get_tf_version,
+    get_torch_version,
+    is_fastai_available,
+    is_fastcore_available,
+    is_tf_available,
+    is_torch_available,
+)
+from ._token import get_token
+from ._validators import validate_hf_hub_args
+
+
+class LocalTokenNotFoundError(EnvironmentError):
+    """Raised if local token is required but not found."""
+
+
+@validate_hf_hub_args
+def build_hf_headers(
+    *,
+    token: Optional[Union[bool, str]] = None,
+    is_write_action: bool = False,
+    library_name: Optional[str] = None,
+    library_version: Optional[str] = None,
+    user_agent: Union[Dict, str, None] = None,
+    headers: Optional[Dict[str, str]] = None,
+) -> Dict[str, str]:
+    """
+    Build headers dictionary to send in a HF Hub call.
+
+    By default, authorization token is always provided either from argument (explicit
+    use) or retrieved from the cache (implicit use). To explicitly avoid sending the
+    token to the Hub, set `token=False` or set the `HF_HUB_DISABLE_IMPLICIT_TOKEN`
+    environment variable.
+
+    In case of an API call that requires write access, an error is thrown if token is
+    `None` or token is an organization token (starting with `"api_org***"`).
+
+    In addition to the auth header, a user-agent is added to provide information about
+    the installed packages (versions of python, huggingface_hub, torch, tensorflow,
+    fastai and fastcore).
+
+    Args:
+        token (`str`, `bool`, *optional*):
+            The token to be sent in authorization header for the Hub call:
+                - if a string, it is used as the Hugging Face token
+                - if `True`, the token is read from the machine (cache or env variable)
+                - if `False`, authorization header is not set
+                - if `None`, the token is read from the machine only except if
+                  `HF_HUB_DISABLE_IMPLICIT_TOKEN` env variable is set.
+        is_write_action (`bool`, default to `False`):
+            Set to True if the API call requires a write access. If `True`, the token
+            will be validated (cannot be `None`, cannot start by `"api_org***"`).
+        library_name (`str`, *optional*):
+            The name of the library that is making the HTTP request. Will be added to
+            the user-agent header.
+        library_version (`str`, *optional*):
+            The version of the library that is making the HTTP request. Will be added
+            to the user-agent header.
+        user_agent (`str`, `dict`, *optional*):
+            The user agent info in the form of a dictionary or a single string. It will
+            be completed with information about the installed packages.
+        headers (`dict`, *optional*):
+            Additional headers to include in the request. Those headers take precedence
+            over the ones generated by this function.
+
+    Returns:
+        A `Dict` of headers to pass in your API call.
+
+    Example:
+    ```py
+        >>> build_hf_headers(token="hf_***") # explicit token
+        {"authorization": "Bearer hf_***", "user-agent": ""}
+
+        >>> build_hf_headers(token=True) # explicitly use cached token
+        {"authorization": "Bearer hf_***",...}
+
+        >>> build_hf_headers(token=False) # explicitly don't use cached token
+        {"user-agent": ...}
+
+        >>> build_hf_headers() # implicit use of the cached token
+        {"authorization": "Bearer hf_***",...}
+
+        # HF_HUB_DISABLE_IMPLICIT_TOKEN=True # to set as env variable
+        >>> build_hf_headers() # token is not sent
+        {"user-agent": ...}
+
+        >>> build_hf_headers(token="api_org_***", is_write_action=True)
+        ValueError: You must use your personal account token for write-access methods.
+
+        >>> build_hf_headers(library_name="transformers", library_version="1.2.3")
+        {"authorization": ..., "user-agent": "transformers/1.2.3; hf_hub/0.10.2; python/3.10.4; tensorflow/1.55"}
+    ```
+
+    Raises:
+        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If organization token is passed and "write" access is required.
+        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            If "write" access is required but token is not passed and not saved locally.
+        [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError)
+            If `token=True` but token is not saved locally.
+    """
+    # Get auth token to send
+    token_to_send = get_token_to_send(token)
+    _validate_token_to_send(token_to_send, is_write_action=is_write_action)
+
+    # Combine headers
+    hf_headers = {
+        "user-agent": _http_user_agent(
+            library_name=library_name,
+            library_version=library_version,
+            user_agent=user_agent,
+        )
+    }
+    if token_to_send is not None:
+        hf_headers["authorization"] = f"Bearer {token_to_send}"
+    if headers is not None:
+        hf_headers.update(headers)
+    return hf_headers
+
+
+def get_token_to_send(token: Optional[Union[bool, str]]) -> Optional[str]:
+    """Select the token to send from either `token` or the cache."""
+    # Case token is explicitly provided
+    if isinstance(token, str):
+        return token
+
+    # Case token is explicitly forbidden
+    if token is False:
+        return None
+
+    # Token is not provided: we get it from local cache
+    cached_token = get_token()
+
+    # Case token is explicitly required
+    if token is True:
+        if cached_token is None:
+            raise LocalTokenNotFoundError(
+                "Token is required (`token=True`), but no token found. You"
+                " need to provide a token or be logged in to Hugging Face with"
+                " `huggingface-cli login` or `huggingface_hub.login`. See"
+                " https://huggingface.co/settings/tokens."
+            )
+        return cached_token
+
+    # Case implicit use of the token is forbidden by env variable
+    if constants.HF_HUB_DISABLE_IMPLICIT_TOKEN:
+        return None
+
+    # Otherwise: we use the cached token as the user has not explicitly forbidden it
+    return cached_token
+
+
+def _validate_token_to_send(token: Optional[str], is_write_action: bool) -> None:
+    if is_write_action:
+        if token is None:
+            raise ValueError(
+                "Token is required (write-access action) but no token found. You need"
+                " to provide a token or be logged in to Hugging Face with"
+                " `huggingface-cli login` or `huggingface_hub.login`. See"
+                " https://huggingface.co/settings/tokens."
+            )
+        if token.startswith("api_org"):
+            raise ValueError(
+                "You must use your personal account token for write-access methods. To"
+                " generate a write-access token, go to"
+                " https://huggingface.co/settings/tokens"
+            )
+
+
+def _http_user_agent(
+    *,
+    library_name: Optional[str] = None,
+    library_version: Optional[str] = None,
+    user_agent: Union[Dict, str, None] = None,
+) -> str:
+    """Format a user-agent string containing information about the installed packages.
+
+    Args:
+        library_name (`str`, *optional*):
+            The name of the library that is making the HTTP request.
+        library_version (`str`, *optional*):
+            The version of the library that is making the HTTP request.
+        user_agent (`str`, `dict`, *optional*):
+            The user agent info in the form of a dictionary or a single string.
+
+    Returns:
+        The formatted user-agent string.
+    """
+    if library_name is not None:
+        ua = f"{library_name}/{library_version}"
+    else:
+        ua = "unknown/None"
+    ua += f"; hf_hub/{get_hf_hub_version()}"
+    ua += f"; python/{get_python_version()}"
+
+    if not constants.HF_HUB_DISABLE_TELEMETRY:
+        if is_torch_available():
+            ua += f"; torch/{get_torch_version()}"
+        if is_tf_available():
+            ua += f"; tensorflow/{get_tf_version()}"
+        if is_fastai_available():
+            ua += f"; fastai/{get_fastai_version()}"
+        if is_fastcore_available():
+            ua += f"; fastcore/{get_fastcore_version()}"
+
+    if isinstance(user_agent, dict):
+        ua += "; " + "; ".join(f"{k}/{v}" for k, v in user_agent.items())
+    elif isinstance(user_agent, str):
+        ua += "; " + user_agent
+
+    return _deduplicate_user_agent(ua)
+
+
+def _deduplicate_user_agent(user_agent: str) -> str:
+    """Deduplicate redundant information in the generated user-agent."""
+    # Split around ";" > Strip whitespaces > Store as dict keys (ensure unicity) > format back as string
+    # Order is implicitly preserved by dictionary structure (see https://stackoverflow.com/a/53657523).
+    return "; ".join({key.strip(): None for key in user_agent.split(";")}.keys())
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_hf_folder.py b/llm/Lib/site-packages/huggingface_hub/utils/_hf_folder.py
new file mode 100644
index 0000000000000000000000000000000000000000..502b22658b44d2221b535cbd943348bb93213245
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_hf_folder.py
@@ -0,0 +1,96 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contain helper class to retrieve/store token from/to local cache."""
+
+import warnings
+from pathlib import Path
+from typing import Optional
+
+from .. import constants
+from ._token import get_token
+
+
+class HfFolder:
+    path_token = Path(constants.HF_TOKEN_PATH)
+    # Private attribute. Will be removed in v0.15
+    _old_path_token = Path(constants._OLD_HF_TOKEN_PATH)
+
+    # TODO: deprecate when adapted in transformers/datasets/gradio
+    # @_deprecate_method(version="1.0", message="Use `huggingface_hub.login` instead.")
+    @classmethod
+    def save_token(cls, token: str) -> None:
+        """
+        Save token, creating folder as needed.
+
+        Token is saved in the huggingface home folder. You can configure it by setting
+        the `HF_HOME` environment variable.
+
+        Args:
+            token (`str`):
+                The token to save to the [`HfFolder`]
+        """
+        cls.path_token.parent.mkdir(parents=True, exist_ok=True)
+        cls.path_token.write_text(token)
+
+    # TODO: deprecate when adapted in transformers/datasets/gradio
+    # @_deprecate_method(version="1.0", message="Use `huggingface_hub.get_token` instead.")
+    @classmethod
+    def get_token(cls) -> Optional[str]:
+        """
+        Get token or None if not existent.
+
+        This method is deprecated in favor of [`huggingface_hub.get_token`] but is kept for backward compatibility.
+        Its behavior is the same as [`huggingface_hub.get_token`].
+
+        Returns:
+            `str` or `None`: The token, `None` if it doesn't exist.
+        """
+        # 0. Check if token exist in old path but not new location
+        try:
+            cls._copy_to_new_path_and_warn()
+        except Exception:  # if not possible (e.g. PermissionError), do not raise
+            pass
+
+        return get_token()
+
+    # TODO: deprecate when adapted in transformers/datasets/gradio
+    # @_deprecate_method(version="1.0", message="Use `huggingface_hub.logout` instead.")
+    @classmethod
+    def delete_token(cls) -> None:
+        """
+        Deletes the token from storage. Does not fail if token does not exist.
+        """
+        try:
+            cls.path_token.unlink()
+        except FileNotFoundError:
+            pass
+
+        try:
+            cls._old_path_token.unlink()
+        except FileNotFoundError:
+            pass
+
+    @classmethod
+    def _copy_to_new_path_and_warn(cls):
+        if cls._old_path_token.exists() and not cls.path_token.exists():
+            cls.save_token(cls._old_path_token.read_text())
+            warnings.warn(
+                f"A token has been found in `{cls._old_path_token}`. This is the old"
+                " path where tokens were stored. The new location is"
+                f" `{cls.path_token}` which is configurable using `HF_HOME` environment"
+                " variable. Your token has been copied to this new location. You can"
+                " now safely delete the old token file manually or use"
+                " `huggingface-cli logout`."
+            )
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_http.py b/llm/Lib/site-packages/huggingface_hub/utils/_http.py
new file mode 100644
index 0000000000000000000000000000000000000000..081d84a4f455e5b47c2f0f6483550dc1c8ac7a36
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_http.py
@@ -0,0 +1,321 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains utilities to handle HTTP requests in Huggingface Hub."""
+
+import io
+import os
+import threading
+import time
+import uuid
+from functools import lru_cache
+from http import HTTPStatus
+from typing import Callable, Optional, Tuple, Type, Union
+
+import requests
+from requests import Response
+from requests.adapters import HTTPAdapter
+from requests.models import PreparedRequest
+
+from .. import constants
+from . import logging
+from ._typing import HTTP_METHOD_T
+
+
+logger = logging.get_logger(__name__)
+
+# Both headers are used by the Hub to debug failed requests.
+# `X_AMZN_TRACE_ID` is better as it also works to debug on Cloudfront and ALB.
+# If `X_AMZN_TRACE_ID` is set, the Hub will use it as well.
+X_AMZN_TRACE_ID = "X-Amzn-Trace-Id"
+X_REQUEST_ID = "x-request-id"
+
+
+class OfflineModeIsEnabled(ConnectionError):
+    """Raised when a request is made but `HF_HUB_OFFLINE=1` is set as environment variable."""
+
+
+class UniqueRequestIdAdapter(HTTPAdapter):
+    X_AMZN_TRACE_ID = "X-Amzn-Trace-Id"
+
+    def add_headers(self, request, **kwargs):
+        super().add_headers(request, **kwargs)
+
+        # Add random request ID => easier for server-side debug
+        if X_AMZN_TRACE_ID not in request.headers:
+            request.headers[X_AMZN_TRACE_ID] = request.headers.get(X_REQUEST_ID) or str(uuid.uuid4())
+
+        # Add debug log
+        has_token = str(request.headers.get("authorization", "")).startswith("Bearer hf_")
+        logger.debug(
+            f"Request {request.headers[X_AMZN_TRACE_ID]}: {request.method} {request.url} (authenticated: {has_token})"
+        )
+
+    def send(self, request: PreparedRequest, *args, **kwargs) -> Response:
+        """Catch any RequestException to append request id to the error message for debugging."""
+        try:
+            return super().send(request, *args, **kwargs)
+        except requests.RequestException as e:
+            request_id = request.headers.get(X_AMZN_TRACE_ID)
+            if request_id is not None:
+                # Taken from https://stackoverflow.com/a/58270258
+                e.args = (*e.args, f"(Request ID: {request_id})")
+            raise
+
+
+class OfflineAdapter(HTTPAdapter):
+    def send(self, request: PreparedRequest, *args, **kwargs) -> Response:
+        raise OfflineModeIsEnabled(
+            f"Cannot reach {request.url}: offline mode is enabled. To disable it, please unset the `HF_HUB_OFFLINE` environment variable."
+        )
+
+
+def _default_backend_factory() -> requests.Session:
+    session = requests.Session()
+    if constants.HF_HUB_OFFLINE:
+        session.mount("http://", OfflineAdapter())
+        session.mount("https://", OfflineAdapter())
+    else:
+        session.mount("http://", UniqueRequestIdAdapter())
+        session.mount("https://", UniqueRequestIdAdapter())
+    return session
+
+
+BACKEND_FACTORY_T = Callable[[], requests.Session]
+_GLOBAL_BACKEND_FACTORY: BACKEND_FACTORY_T = _default_backend_factory
+
+
+def configure_http_backend(backend_factory: BACKEND_FACTORY_T = _default_backend_factory) -> None:
+    """
+    Configure the HTTP backend by providing a `backend_factory`. Any HTTP calls made by `huggingface_hub` will use a
+    Session object instantiated by this factory. This can be useful if you are running your scripts in a specific
+    environment requiring custom configuration (e.g. custom proxy or certifications).
+
+    Use [`get_session`] to get a configured Session. Since `requests.Session` is not guaranteed to be thread-safe,
+    `huggingface_hub` creates 1 Session instance per thread. They are all instantiated using the same `backend_factory`
+    set in [`configure_http_backend`]. A LRU cache is used to cache the created sessions (and connections) between
+    calls. Max size is 128 to avoid memory leaks if thousands of threads are spawned.
+
+    See [this issue](https://github.com/psf/requests/issues/2766) to know more about thread-safety in `requests`.
+
+    Example:
+    ```py
+    import requests
+    from huggingface_hub import configure_http_backend, get_session
+
+    # Create a factory function that returns a Session with configured proxies
+    def backend_factory() -> requests.Session:
+        session = requests.Session()
+        session.proxies = {"http": "http://10.10.1.10:3128", "https": "https://10.10.1.11:1080"}
+        return session
+
+    # Set it as the default session factory
+    configure_http_backend(backend_factory=backend_factory)
+
+    # In practice, this is mostly done internally in `huggingface_hub`
+    session = get_session()
+    ```
+    """
+    global _GLOBAL_BACKEND_FACTORY
+    _GLOBAL_BACKEND_FACTORY = backend_factory
+    reset_sessions()
+
+
+def get_session() -> requests.Session:
+    """
+    Get a `requests.Session` object, using the session factory from the user.
+
+    Use [`get_session`] to get a configured Session. Since `requests.Session` is not guaranteed to be thread-safe,
+    `huggingface_hub` creates 1 Session instance per thread. They are all instantiated using the same `backend_factory`
+    set in [`configure_http_backend`]. A LRU cache is used to cache the created sessions (and connections) between
+    calls. Max size is 128 to avoid memory leaks if thousands of threads are spawned.
+
+    See [this issue](https://github.com/psf/requests/issues/2766) to know more about thread-safety in `requests`.
+
+    Example:
+    ```py
+    import requests
+    from huggingface_hub import configure_http_backend, get_session
+
+    # Create a factory function that returns a Session with configured proxies
+    def backend_factory() -> requests.Session:
+        session = requests.Session()
+        session.proxies = {"http": "http://10.10.1.10:3128", "https": "https://10.10.1.11:1080"}
+        return session
+
+    # Set it as the default session factory
+    configure_http_backend(backend_factory=backend_factory)
+
+    # In practice, this is mostly done internally in `huggingface_hub`
+    session = get_session()
+    ```
+    """
+    return _get_session_from_cache(process_id=os.getpid(), thread_id=threading.get_ident())
+
+
+def reset_sessions() -> None:
+    """Reset the cache of sessions.
+
+    Mostly used internally when sessions are reconfigured or an SSLError is raised.
+    See [`configure_http_backend`] for more details.
+    """
+    _get_session_from_cache.cache_clear()
+
+
+@lru_cache
+def _get_session_from_cache(process_id: int, thread_id: int) -> requests.Session:
+    """
+    Create a new session per thread using global factory. Using LRU cache (maxsize 128) to avoid memory leaks when
+    using thousands of threads. Cache is cleared when `configure_http_backend` is called.
+    """
+    return _GLOBAL_BACKEND_FACTORY()
+
+
+def http_backoff(
+    method: HTTP_METHOD_T,
+    url: str,
+    *,
+    max_retries: int = 5,
+    base_wait_time: float = 1,
+    max_wait_time: float = 8,
+    retry_on_exceptions: Union[Type[Exception], Tuple[Type[Exception], ...]] = (
+        requests.Timeout,
+        requests.ConnectionError,
+    ),
+    retry_on_status_codes: Union[int, Tuple[int, ...]] = HTTPStatus.SERVICE_UNAVAILABLE,
+    **kwargs,
+) -> Response:
+    """Wrapper around requests to retry calls on an endpoint, with exponential backoff.
+
+    Endpoint call is retried on exceptions (ex: connection timeout, proxy error,...)
+    and/or on specific status codes (ex: service unavailable). If the call failed more
+    than `max_retries`, the exception is thrown or `raise_for_status` is called on the
+    response object.
+
+    Re-implement mechanisms from the `backoff` library to avoid adding an external
+    dependencies to `hugging_face_hub`. See https://github.com/litl/backoff.
+
+    Args:
+        method (`Literal["GET", "OPTIONS", "HEAD", "POST", "PUT", "PATCH", "DELETE"]`):
+            HTTP method to perform.
+        url (`str`):
+            The URL of the resource to fetch.
+        max_retries (`int`, *optional*, defaults to `5`):
+            Maximum number of retries, defaults to 5 (no retries).
+        base_wait_time (`float`, *optional*, defaults to `1`):
+            Duration (in seconds) to wait before retrying the first time.
+            Wait time between retries then grows exponentially, capped by
+            `max_wait_time`.
+        max_wait_time (`float`, *optional*, defaults to `8`):
+            Maximum duration (in seconds) to wait before retrying.
+        retry_on_exceptions (`Type[Exception]` or `Tuple[Type[Exception]]`, *optional*):
+            Define which exceptions must be caught to retry the request. Can be a single type or a tuple of types.
+            By default, retry on `requests.Timeout` and `requests.ConnectionError`.
+        retry_on_status_codes (`int` or `Tuple[int]`, *optional*, defaults to `503`):
+            Define on which status codes the request must be retried. By default, only
+            HTTP 503 Service Unavailable is retried.
+        **kwargs (`dict`, *optional*):
+            kwargs to pass to `requests.request`.
+
+    Example:
+    ```
+    >>> from huggingface_hub.utils import http_backoff
+
+    # Same usage as "requests.request".
+    >>> response = http_backoff("GET", "https://www.google.com")
+    >>> response.raise_for_status()
+
+    # If you expect a Gateway Timeout from time to time
+    >>> http_backoff("PUT", upload_url, data=data, retry_on_status_codes=504)
+    >>> response.raise_for_status()
+    ```
+
+    <Tip warning={true}>
+
+    When using `requests` it is possible to stream data by passing an iterator to the
+    `data` argument. On http backoff this is a problem as the iterator is not reset
+    after a failed call. This issue is mitigated for file objects or any IO streams
+    by saving the initial position of the cursor (with `data.tell()`) and resetting the
+    cursor between each call (with `data.seek()`). For arbitrary iterators, http backoff
+    will fail. If this is a hard constraint for you, please let us know by opening an
+    issue on [Github](https://github.com/huggingface/huggingface_hub).
+
+    </Tip>
+    """
+    if isinstance(retry_on_exceptions, type):  # Tuple from single exception type
+        retry_on_exceptions = (retry_on_exceptions,)
+
+    if isinstance(retry_on_status_codes, int):  # Tuple from single status code
+        retry_on_status_codes = (retry_on_status_codes,)
+
+    nb_tries = 0
+    sleep_time = base_wait_time
+
+    # If `data` is used and is a file object (or any IO), it will be consumed on the
+    # first HTTP request. We need to save the initial position so that the full content
+    # of the file is re-sent on http backoff. See warning tip in docstring.
+    io_obj_initial_pos = None
+    if "data" in kwargs and isinstance(kwargs["data"], io.IOBase):
+        io_obj_initial_pos = kwargs["data"].tell()
+
+    session = get_session()
+    while True:
+        nb_tries += 1
+        try:
+            # If `data` is used and is a file object (or any IO), set back cursor to
+            # initial position.
+            if io_obj_initial_pos is not None:
+                kwargs["data"].seek(io_obj_initial_pos)
+
+            # Perform request and return if status_code is not in the retry list.
+            response = session.request(method=method, url=url, **kwargs)
+            if response.status_code not in retry_on_status_codes:
+                return response
+
+            # Wrong status code returned (HTTP 503 for instance)
+            logger.warning(f"HTTP Error {response.status_code} thrown while requesting {method} {url}")
+            if nb_tries > max_retries:
+                response.raise_for_status()  # Will raise uncaught exception
+                # We return response to avoid infinite loop in the corner case where the
+                # user ask for retry on a status code that doesn't raise_for_status.
+                return response
+
+        except retry_on_exceptions as err:
+            logger.warning(f"'{err}' thrown while requesting {method} {url}")
+
+            if isinstance(err, requests.ConnectionError):
+                reset_sessions()  # In case of SSLError it's best to reset the shared requests.Session objects
+
+            if nb_tries > max_retries:
+                raise err
+
+        # Sleep for X seconds
+        logger.warning(f"Retrying in {sleep_time}s [Retry {nb_tries}/{max_retries}].")
+        time.sleep(sleep_time)
+
+        # Update sleep time for next retry
+        sleep_time = min(max_wait_time, sleep_time * 2)  # Exponential backoff
+
+
+def fix_hf_endpoint_in_url(url: str, endpoint: Optional[str]) -> str:
+    """Replace the default endpoint in a URL by a custom one.
+
+    This is useful when using a proxy and the Hugging Face Hub returns a URL with the default endpoint.
+    """
+    endpoint = endpoint or constants.ENDPOINT
+    # check if a proxy has been set => if yes, update the returned URL to use the proxy
+    if endpoint not in (None, constants._HF_DEFAULT_ENDPOINT, constants._HF_DEFAULT_STAGING_ENDPOINT):
+        url = url.replace(constants._HF_DEFAULT_ENDPOINT, endpoint)
+        url = url.replace(constants._HF_DEFAULT_STAGING_ENDPOINT, endpoint)
+    return url
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_pagination.py b/llm/Lib/site-packages/huggingface_hub/utils/_pagination.py
new file mode 100644
index 0000000000000000000000000000000000000000..f7ab4fe7cba9bd13f01d9c81854a00fd30b7f0d9
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_pagination.py
@@ -0,0 +1,52 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains utilities to handle pagination on Huggingface Hub."""
+
+from typing import Dict, Iterable, Optional
+
+import requests
+
+from . import get_session, hf_raise_for_status, logging
+
+
+logger = logging.get_logger(__name__)
+
+
+def paginate(path: str, params: Dict, headers: Dict) -> Iterable:
+    """Fetch a list of models/datasets/spaces and paginate through results.
+
+    This is using the same "Link" header format as GitHub.
+    See:
+    - https://requests.readthedocs.io/en/latest/api/#requests.Response.links
+    - https://docs.github.com/en/rest/guides/traversing-with-pagination#link-header
+    """
+    session = get_session()
+    r = session.get(path, params=params, headers=headers)
+    hf_raise_for_status(r)
+    yield from r.json()
+
+    # Follow pages
+    # Next link already contains query params
+    next_page = _get_next_page(r)
+    while next_page is not None:
+        logger.debug(f"Pagination detected. Requesting next page: {next_page}")
+        r = session.get(next_page, headers=headers)
+        hf_raise_for_status(r)
+        yield from r.json()
+        next_page = _get_next_page(r)
+
+
+def _get_next_page(response: requests.Response) -> Optional[str]:
+    return response.links.get("next", {}).get("url")
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_paths.py b/llm/Lib/site-packages/huggingface_hub/utils/_paths.py
new file mode 100644
index 0000000000000000000000000000000000000000..411d7d52bb3edc2be948d85267e21ce2be91d460
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_paths.py
@@ -0,0 +1,118 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains utilities to handle paths in Huggingface Hub."""
+
+from fnmatch import fnmatch
+from pathlib import Path
+from typing import Callable, Generator, Iterable, List, Optional, TypeVar, Union
+
+
+T = TypeVar("T")
+
+IGNORE_GIT_FOLDER_PATTERNS = [".git", ".git/*", "*/.git", "**/.git/**"]
+
+
+def filter_repo_objects(
+    items: Iterable[T],
+    *,
+    allow_patterns: Optional[Union[List[str], str]] = None,
+    ignore_patterns: Optional[Union[List[str], str]] = None,
+    key: Optional[Callable[[T], str]] = None,
+) -> Generator[T, None, None]:
+    """Filter repo objects based on an allowlist and a denylist.
+
+    Input must be a list of paths (`str` or `Path`) or a list of arbitrary objects.
+    In the later case, `key` must be provided and specifies a function of one argument
+    that is used to extract a path from each element in iterable.
+
+    Patterns are Unix shell-style wildcards which are NOT regular expressions. See
+    https://docs.python.org/3/library/fnmatch.html for more details.
+
+    Args:
+        items (`Iterable`):
+            List of items to filter.
+        allow_patterns (`str` or `List[str]`, *optional*):
+            Patterns constituting the allowlist. If provided, item paths must match at
+            least one pattern from the allowlist.
+        ignore_patterns (`str` or `List[str]`, *optional*):
+            Patterns constituting the denylist. If provided, item paths must not match
+            any patterns from the denylist.
+        key (`Callable[[T], str]`, *optional*):
+            Single-argument function to extract a path from each item. If not provided,
+            the `items` must already be `str` or `Path`.
+
+    Returns:
+        Filtered list of objects, as a generator.
+
+    Raises:
+        :class:`ValueError`:
+            If `key` is not provided and items are not `str` or `Path`.
+
+    Example usage with paths:
+    ```python
+    >>> # Filter only PDFs that are not hidden.
+    >>> list(filter_repo_objects(
+    ...     ["aaa.PDF", "bbb.jpg", ".ccc.pdf", ".ddd.png"],
+    ...     allow_patterns=["*.pdf"],
+    ...     ignore_patterns=[".*"],
+    ... ))
+    ["aaa.pdf"]
+    ```
+
+    Example usage with objects:
+    ```python
+    >>> list(filter_repo_objects(
+    ... [
+    ...     CommitOperationAdd(path_or_fileobj="/tmp/aaa.pdf", path_in_repo="aaa.pdf")
+    ...     CommitOperationAdd(path_or_fileobj="/tmp/bbb.jpg", path_in_repo="bbb.jpg")
+    ...     CommitOperationAdd(path_or_fileobj="/tmp/.ccc.pdf", path_in_repo=".ccc.pdf")
+    ...     CommitOperationAdd(path_or_fileobj="/tmp/.ddd.png", path_in_repo=".ddd.png")
+    ... ],
+    ... allow_patterns=["*.pdf"],
+    ... ignore_patterns=[".*"],
+    ... key=lambda x: x.repo_in_path
+    ... ))
+    [CommitOperationAdd(path_or_fileobj="/tmp/aaa.pdf", path_in_repo="aaa.pdf")]
+    ```
+    """
+    if isinstance(allow_patterns, str):
+        allow_patterns = [allow_patterns]
+
+    if isinstance(ignore_patterns, str):
+        ignore_patterns = [ignore_patterns]
+
+    if key is None:
+
+        def _identity(item: T) -> str:
+            if isinstance(item, str):
+                return item
+            if isinstance(item, Path):
+                return str(item)
+            raise ValueError(f"Please provide `key` argument in `filter_repo_objects`: `{item}` is not a string.")
+
+        key = _identity  # Items must be `str` or `Path`, otherwise raise ValueError
+
+    for item in items:
+        path = key(item)
+
+        # Skip if there's an allowlist and path doesn't match any
+        if allow_patterns is not None and not any(fnmatch(path, r) for r in allow_patterns):
+            continue
+
+        # Skip if there's a denylist and path matches any
+        if ignore_patterns is not None and any(fnmatch(path, r) for r in ignore_patterns):
+            continue
+
+        yield item
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_runtime.py b/llm/Lib/site-packages/huggingface_hub/utils/_runtime.py
new file mode 100644
index 0000000000000000000000000000000000000000..21f852736c841be1caa747f8dc6c8657c0e3d8f2
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_runtime.py
@@ -0,0 +1,372 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Check presence of installed packages at runtime."""
+
+import importlib.metadata
+import platform
+import sys
+import warnings
+from typing import Any, Dict
+
+from .. import __version__, constants
+
+
+_PY_VERSION: str = sys.version.split()[0].rstrip("+")
+
+_package_versions = {}
+
+_CANDIDATES = {
+    "aiohttp": {"aiohttp"},
+    "fastai": {"fastai"},
+    "fastcore": {"fastcore"},
+    "gradio": {"gradio"},
+    "graphviz": {"graphviz"},
+    "hf_transfer": {"hf_transfer"},
+    "jinja": {"Jinja2"},
+    "keras": {"keras"},
+    "minijinja": {"minijinja"},
+    "numpy": {"numpy"},
+    "pillow": {"Pillow"},
+    "pydantic": {"pydantic"},
+    "pydot": {"pydot"},
+    "safetensors": {"safetensors"},
+    "tensorboard": {"tensorboardX"},
+    "tensorflow": (
+        "tensorflow",
+        "tensorflow-cpu",
+        "tensorflow-gpu",
+        "tf-nightly",
+        "tf-nightly-cpu",
+        "tf-nightly-gpu",
+        "intel-tensorflow",
+        "intel-tensorflow-avx512",
+        "tensorflow-rocm",
+        "tensorflow-macos",
+    ),
+    "torch": {"torch"},
+}
+
+# Check once at runtime
+for candidate_name, package_names in _CANDIDATES.items():
+    _package_versions[candidate_name] = "N/A"
+    for name in package_names:
+        try:
+            _package_versions[candidate_name] = importlib.metadata.version(name)
+            break
+        except importlib.metadata.PackageNotFoundError:
+            pass
+
+
+def _get_version(package_name: str) -> str:
+    return _package_versions.get(package_name, "N/A")
+
+
+def is_package_available(package_name: str) -> bool:
+    return _get_version(package_name) != "N/A"
+
+
+# Python
+def get_python_version() -> str:
+    return _PY_VERSION
+
+
+# Huggingface Hub
+def get_hf_hub_version() -> str:
+    return __version__
+
+
+# aiohttp
+def is_aiohttp_available() -> bool:
+    return is_package_available("aiohttp")
+
+
+def get_aiohttp_version() -> str:
+    return _get_version("aiohttp")
+
+
+# FastAI
+def is_fastai_available() -> bool:
+    return is_package_available("fastai")
+
+
+def get_fastai_version() -> str:
+    return _get_version("fastai")
+
+
+# Fastcore
+def is_fastcore_available() -> bool:
+    return is_package_available("fastcore")
+
+
+def get_fastcore_version() -> str:
+    return _get_version("fastcore")
+
+
+# FastAI
+def is_gradio_available() -> bool:
+    return is_package_available("gradio")
+
+
+def get_gradio_version() -> str:
+    return _get_version("gradio")
+
+
+# Graphviz
+def is_graphviz_available() -> bool:
+    return is_package_available("graphviz")
+
+
+def get_graphviz_version() -> str:
+    return _get_version("graphviz")
+
+
+# hf_transfer
+def is_hf_transfer_available() -> bool:
+    return is_package_available("hf_transfer")
+
+
+def get_hf_transfer_version() -> str:
+    return _get_version("hf_transfer")
+
+
+# keras
+def is_keras_available() -> bool:
+    return is_package_available("keras")
+
+
+def get_keras_version() -> str:
+    return _get_version("keras")
+
+
+# Minijinja
+def is_minijinja_available() -> bool:
+    return is_package_available("minijinja")
+
+
+def get_minijinja_version() -> str:
+    return _get_version("minijinja")
+
+
+# Numpy
+def is_numpy_available() -> bool:
+    return is_package_available("numpy")
+
+
+def get_numpy_version() -> str:
+    return _get_version("numpy")
+
+
+# Jinja
+def is_jinja_available() -> bool:
+    return is_package_available("jinja")
+
+
+def get_jinja_version() -> str:
+    return _get_version("jinja")
+
+
+# Pillow
+def is_pillow_available() -> bool:
+    return is_package_available("pillow")
+
+
+def get_pillow_version() -> str:
+    return _get_version("pillow")
+
+
+# Pydantic
+def is_pydantic_available() -> bool:
+    if not is_package_available("pydantic"):
+        return False
+    # For Pydantic, we add an extra check to test whether it is correctly installed or not. If both pydantic 2.x and
+    # typing_extensions<=4.5.0 are installed, then pydantic will fail at import time. This should not happen when
+    # it is installed with `pip install huggingface_hub[inference]` but it can happen when it is installed manually
+    # by the user in an environment that we don't control.
+    #
+    # Usually we won't need to do this kind of check on optional dependencies. However, pydantic is a special case
+    # as it is automatically imported when doing `from huggingface_hub import ...` even if the user doesn't use it.
+    #
+    # See https://github.com/huggingface/huggingface_hub/pull/1829 for more details.
+    try:
+        from pydantic import validator  # noqa: F401
+    except ImportError:
+        # Example: "ImportError: cannot import name 'TypeAliasType' from 'typing_extensions'"
+        warnings.warn(
+            "Pydantic is installed but cannot be imported. Please check your installation. `huggingface_hub` will "
+            "default to not using Pydantic. Error message: '{e}'"
+        )
+        return False
+    return True
+
+
+def get_pydantic_version() -> str:
+    return _get_version("pydantic")
+
+
+# Pydot
+def is_pydot_available() -> bool:
+    return is_package_available("pydot")
+
+
+def get_pydot_version() -> str:
+    return _get_version("pydot")
+
+
+# Tensorboard
+def is_tensorboard_available() -> bool:
+    return is_package_available("tensorboard")
+
+
+def get_tensorboard_version() -> str:
+    return _get_version("tensorboard")
+
+
+# Tensorflow
+def is_tf_available() -> bool:
+    return is_package_available("tensorflow")
+
+
+def get_tf_version() -> str:
+    return _get_version("tensorflow")
+
+
+# Torch
+def is_torch_available() -> bool:
+    return is_package_available("torch")
+
+
+def get_torch_version() -> str:
+    return _get_version("torch")
+
+
+# Safetensors
+def is_safetensors_available() -> bool:
+    return is_package_available("safetensors")
+
+
+# Shell-related helpers
+try:
+    # Set to `True` if script is running in a Google Colab notebook.
+    # If running in Google Colab, git credential store is set globally which makes the
+    # warning disappear. See https://github.com/huggingface/huggingface_hub/issues/1043
+    #
+    # Taken from https://stackoverflow.com/a/63519730.
+    _is_google_colab = "google.colab" in str(get_ipython())  # type: ignore # noqa: F821
+except NameError:
+    _is_google_colab = False
+
+
+def is_notebook() -> bool:
+    """Return `True` if code is executed in a notebook (Jupyter, Colab, QTconsole).
+
+    Taken from https://stackoverflow.com/a/39662359.
+    Adapted to make it work with Google colab as well.
+    """
+    try:
+        shell_class = get_ipython().__class__  # type: ignore # noqa: F821
+        for parent_class in shell_class.__mro__:  # e.g. "is subclass of"
+            if parent_class.__name__ == "ZMQInteractiveShell":
+                return True  # Jupyter notebook, Google colab or qtconsole
+        return False
+    except NameError:
+        return False  # Probably standard Python interpreter
+
+
+def is_google_colab() -> bool:
+    """Return `True` if code is executed in a Google colab.
+
+    Taken from https://stackoverflow.com/a/63519730.
+    """
+    return _is_google_colab
+
+
+def dump_environment_info() -> Dict[str, Any]:
+    """Dump information about the machine to help debugging issues.
+
+    Similar helper exist in:
+    - `datasets` (https://github.com/huggingface/datasets/blob/main/src/datasets/commands/env.py)
+    - `diffusers` (https://github.com/huggingface/diffusers/blob/main/src/diffusers/commands/env.py)
+    - `transformers` (https://github.com/huggingface/transformers/blob/main/src/transformers/commands/env.py)
+    """
+    from huggingface_hub import get_token, whoami
+    from huggingface_hub.utils import list_credential_helpers
+
+    token = get_token()
+
+    # Generic machine info
+    info: Dict[str, Any] = {
+        "huggingface_hub version": get_hf_hub_version(),
+        "Platform": platform.platform(),
+        "Python version": get_python_version(),
+    }
+
+    # Interpreter info
+    try:
+        shell_class = get_ipython().__class__  # type: ignore # noqa: F821
+        info["Running in iPython ?"] = "Yes"
+        info["iPython shell"] = shell_class.__name__
+    except NameError:
+        info["Running in iPython ?"] = "No"
+    info["Running in notebook ?"] = "Yes" if is_notebook() else "No"
+    info["Running in Google Colab ?"] = "Yes" if is_google_colab() else "No"
+
+    # Login info
+    info["Token path ?"] = constants.HF_TOKEN_PATH
+    info["Has saved token ?"] = token is not None
+    if token is not None:
+        try:
+            info["Who am I ?"] = whoami()["name"]
+        except Exception:
+            pass
+
+    try:
+        info["Configured git credential helpers"] = ", ".join(list_credential_helpers())
+    except Exception:
+        pass
+
+    # Installed dependencies
+    info["FastAI"] = get_fastai_version()
+    info["Tensorflow"] = get_tf_version()
+    info["Torch"] = get_torch_version()
+    info["Jinja2"] = get_jinja_version()
+    info["Graphviz"] = get_graphviz_version()
+    info["keras"] = get_keras_version()
+    info["Pydot"] = get_pydot_version()
+    info["Pillow"] = get_pillow_version()
+    info["hf_transfer"] = get_hf_transfer_version()
+    info["gradio"] = get_gradio_version()
+    info["tensorboard"] = get_tensorboard_version()
+    info["numpy"] = get_numpy_version()
+    info["pydantic"] = get_pydantic_version()
+    info["aiohttp"] = get_aiohttp_version()
+
+    # Environment variables
+    info["ENDPOINT"] = constants.ENDPOINT
+    info["HF_HUB_CACHE"] = constants.HF_HUB_CACHE
+    info["HF_ASSETS_CACHE"] = constants.HF_ASSETS_CACHE
+    info["HF_TOKEN_PATH"] = constants.HF_TOKEN_PATH
+    info["HF_HUB_OFFLINE"] = constants.HF_HUB_OFFLINE
+    info["HF_HUB_DISABLE_TELEMETRY"] = constants.HF_HUB_DISABLE_TELEMETRY
+    info["HF_HUB_DISABLE_PROGRESS_BARS"] = constants.HF_HUB_DISABLE_PROGRESS_BARS
+    info["HF_HUB_DISABLE_SYMLINKS_WARNING"] = constants.HF_HUB_DISABLE_SYMLINKS_WARNING
+    info["HF_HUB_DISABLE_EXPERIMENTAL_WARNING"] = constants.HF_HUB_DISABLE_EXPERIMENTAL_WARNING
+    info["HF_HUB_DISABLE_IMPLICIT_TOKEN"] = constants.HF_HUB_DISABLE_IMPLICIT_TOKEN
+    info["HF_HUB_ENABLE_HF_TRANSFER"] = constants.HF_HUB_ENABLE_HF_TRANSFER
+    info["HF_HUB_ETAG_TIMEOUT"] = constants.HF_HUB_ETAG_TIMEOUT
+    info["HF_HUB_DOWNLOAD_TIMEOUT"] = constants.HF_HUB_DOWNLOAD_TIMEOUT
+
+    print("\nCopy-and-paste the text below in your GitHub issue.\n")
+    print("\n".join([f"- {prop}: {val}" for prop, val in info.items()]) + "\n")
+    return info
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_safetensors.py b/llm/Lib/site-packages/huggingface_hub/utils/_safetensors.py
new file mode 100644
index 0000000000000000000000000000000000000000..d37e8f76fee25976d48ad591fe8afb277ae6ef38
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_safetensors.py
@@ -0,0 +1,124 @@
+import functools
+import operator
+from collections import defaultdict
+from dataclasses import dataclass, field
+from typing import Dict, List, Literal, Optional, Tuple
+
+
+FILENAME_T = str
+TENSOR_NAME_T = str
+DTYPE_T = Literal["F64", "F32", "F16", "BF16", "I64", "I32", "I16", "I8", "U8", "BOOL"]
+
+
+class SafetensorsParsingError(Exception):
+    """Raised when failing to parse a safetensors file metadata.
+
+    This can be the case if the file is not a safetensors file or does not respect the specification.
+    """
+
+
+class NotASafetensorsRepoError(Exception):
+    """Raised when a repo is not a Safetensors repo i.e. doesn't have either a `model.safetensors` or a
+    `model.safetensors.index.json` file.
+    """
+
+
+@dataclass
+class TensorInfo:
+    """Information about a tensor.
+
+    For more details regarding the safetensors format, check out https://huggingface.co/docs/safetensors/index#format.
+
+    Attributes:
+        dtype (`str`):
+            The data type of the tensor ("F64", "F32", "F16", "BF16", "I64", "I32", "I16", "I8", "U8", "BOOL").
+        shape (`List[int]`):
+            The shape of the tensor.
+        data_offsets (`Tuple[int, int]`):
+            The offsets of the data in the file as a tuple `[BEGIN, END]`.
+        parameter_count (`int`):
+            The number of parameters in the tensor.
+    """
+
+    dtype: DTYPE_T
+    shape: List[int]
+    data_offsets: Tuple[int, int]
+    parameter_count: int = field(init=False)
+
+    def __post_init__(self) -> None:
+        # Taken from https://stackoverflow.com/a/13840436
+        try:
+            self.parameter_count = functools.reduce(operator.mul, self.shape)
+        except TypeError:
+            self.parameter_count = 1  # scalar value has no shape
+
+
+@dataclass
+class SafetensorsFileMetadata:
+    """Metadata for a Safetensors file hosted on the Hub.
+
+    This class is returned by [`parse_safetensors_file_metadata`].
+
+    For more details regarding the safetensors format, check out https://huggingface.co/docs/safetensors/index#format.
+
+    Attributes:
+        metadata (`Dict`):
+            The metadata contained in the file.
+        tensors (`Dict[str, TensorInfo]`):
+            A map of all tensors. Keys are tensor names and values are information about the corresponding tensor, as a
+            [`TensorInfo`] object.
+        parameter_count (`Dict[str, int]`):
+            A map of the number of parameters per data type. Keys are data types and values are the number of parameters
+            of that data type.
+    """
+
+    metadata: Dict[str, str]
+    tensors: Dict[TENSOR_NAME_T, TensorInfo]
+    parameter_count: Dict[DTYPE_T, int] = field(init=False)
+
+    def __post_init__(self) -> None:
+        parameter_count: Dict[DTYPE_T, int] = defaultdict(int)
+        for tensor in self.tensors.values():
+            parameter_count[tensor.dtype] += tensor.parameter_count
+        self.parameter_count = dict(parameter_count)
+
+
+@dataclass
+class SafetensorsRepoMetadata:
+    """Metadata for a Safetensors repo.
+
+    A repo is considered to be a Safetensors repo if it contains either a 'model.safetensors' weight file (non-shared
+    model) or a 'model.safetensors.index.json' index file (sharded model) at its root.
+
+    This class is returned by [`get_safetensors_metadata`].
+
+    For more details regarding the safetensors format, check out https://huggingface.co/docs/safetensors/index#format.
+
+    Attributes:
+        metadata (`Dict`, *optional*):
+            The metadata contained in the 'model.safetensors.index.json' file, if it exists. Only populated for sharded
+            models.
+        sharded (`bool`):
+            Whether the repo contains a sharded model or not.
+        weight_map (`Dict[str, str]`):
+            A map of all weights. Keys are tensor names and values are filenames of the files containing the tensors.
+        files_metadata (`Dict[str, SafetensorsFileMetadata]`):
+            A map of all files metadata. Keys are filenames and values are the metadata of the corresponding file, as
+            a [`SafetensorsFileMetadata`] object.
+        parameter_count (`Dict[str, int]`):
+            A map of the number of parameters per data type. Keys are data types and values are the number of parameters
+            of that data type.
+    """
+
+    metadata: Optional[Dict]
+    sharded: bool
+    weight_map: Dict[TENSOR_NAME_T, FILENAME_T]  # tensor name -> filename
+    files_metadata: Dict[FILENAME_T, SafetensorsFileMetadata]  # filename -> metadata
+    parameter_count: Dict[DTYPE_T, int] = field(init=False)
+
+    def __post_init__(self) -> None:
+        parameter_count: Dict[DTYPE_T, int] = defaultdict(int)
+        for file_metadata in self.files_metadata.values():
+            for dtype, nb_parameters_ in file_metadata.parameter_count.items():
+                parameter_count[dtype] += nb_parameters_
+        self.parameter_count = dict(parameter_count)
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_subprocess.py b/llm/Lib/site-packages/huggingface_hub/utils/_subprocess.py
new file mode 100644
index 0000000000000000000000000000000000000000..a09e0d58868ecd699ea3a3e503a8a702d25c8ea5
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_subprocess.py
@@ -0,0 +1,143 @@
+#!/usr/bin/env python
+# coding=utf-8
+# Copyright 2021 The HuggingFace Inc. team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License
+"""Contains utilities to easily handle subprocesses in `huggingface_hub`."""
+
+import os
+import subprocess
+import sys
+from contextlib import contextmanager
+from io import StringIO
+from pathlib import Path
+from typing import IO, Generator, List, Optional, Tuple, Union
+
+from .logging import get_logger
+
+
+logger = get_logger(__name__)
+
+
+@contextmanager
+def capture_output() -> Generator[StringIO, None, None]:
+    """Capture output that is printed to terminal.
+
+    Taken from https://stackoverflow.com/a/34738440
+
+    Example:
+    ```py
+    >>> with capture_output() as output:
+    ...     print("hello world")
+    >>> assert output.getvalue() == "hello world\n"
+    ```
+    """
+    output = StringIO()
+    previous_output = sys.stdout
+    sys.stdout = output
+    yield output
+    sys.stdout = previous_output
+
+
+def run_subprocess(
+    command: Union[str, List[str]],
+    folder: Optional[Union[str, Path]] = None,
+    check=True,
+    **kwargs,
+) -> subprocess.CompletedProcess:
+    """
+    Method to run subprocesses. Calling this will capture the `stderr` and `stdout`,
+    please call `subprocess.run` manually in case you would like for them not to
+    be captured.
+
+    Args:
+        command (`str` or `List[str]`):
+            The command to execute as a string or list of strings.
+        folder (`str`, *optional*):
+            The folder in which to run the command. Defaults to current working
+            directory (from `os.getcwd()`).
+        check (`bool`, *optional*, defaults to `True`):
+            Setting `check` to `True` will raise a `subprocess.CalledProcessError`
+            when the subprocess has a non-zero exit code.
+        kwargs (`Dict[str]`):
+            Keyword arguments to be passed to the `subprocess.run` underlying command.
+
+    Returns:
+        `subprocess.CompletedProcess`: The completed process.
+    """
+    if isinstance(command, str):
+        command = command.split()
+
+    if isinstance(folder, Path):
+        folder = str(folder)
+
+    return subprocess.run(
+        command,
+        stderr=subprocess.PIPE,
+        stdout=subprocess.PIPE,
+        check=check,
+        encoding="utf-8",
+        errors="replace",  # if not utf-8, replace char by �
+        cwd=folder or os.getcwd(),
+        **kwargs,
+    )
+
+
+@contextmanager
+def run_interactive_subprocess(
+    command: Union[str, List[str]],
+    folder: Optional[Union[str, Path]] = None,
+    **kwargs,
+) -> Generator[Tuple[IO[str], IO[str]], None, None]:
+    """Run a subprocess in an interactive mode in a context manager.
+
+    Args:
+        command (`str` or `List[str]`):
+            The command to execute as a string or list of strings.
+        folder (`str`, *optional*):
+            The folder in which to run the command. Defaults to current working
+            directory (from `os.getcwd()`).
+        kwargs (`Dict[str]`):
+            Keyword arguments to be passed to the `subprocess.run` underlying command.
+
+    Returns:
+        `Tuple[IO[str], IO[str]]`: A tuple with `stdin` and `stdout` to interact
+        with the process (input and output are utf-8 encoded).
+
+    Example:
+    ```python
+    with _interactive_subprocess("git credential-store get") as (stdin, stdout):
+        # Write to stdin
+        stdin.write("url=hf.co\nusername=obama\n".encode("utf-8"))
+        stdin.flush()
+
+        # Read from stdout
+        output = stdout.read().decode("utf-8")
+    ```
+    """
+    if isinstance(command, str):
+        command = command.split()
+
+    with subprocess.Popen(
+        command,
+        stdin=subprocess.PIPE,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.STDOUT,
+        encoding="utf-8",
+        errors="replace",  # if not utf-8, replace char by �
+        cwd=folder or os.getcwd(),
+        **kwargs,
+    ) as process:
+        assert process.stdin is not None, "subprocess is opened as subprocess.PIPE"
+        assert process.stdout is not None, "subprocess is opened as subprocess.PIPE"
+        yield process.stdin, process.stdout
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_telemetry.py b/llm/Lib/site-packages/huggingface_hub/utils/_telemetry.py
new file mode 100644
index 0000000000000000000000000000000000000000..5de988e2795188324f69232d1beb68191591715d
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_telemetry.py
@@ -0,0 +1,118 @@
+from queue import Queue
+from threading import Lock, Thread
+from typing import Dict, Optional, Union
+from urllib.parse import quote
+
+from .. import constants, logging
+from . import build_hf_headers, get_session, hf_raise_for_status
+
+
+logger = logging.get_logger(__name__)
+
+# Telemetry is sent by a separate thread to avoid blocking the main thread.
+# A daemon thread is started once and consume tasks from the _TELEMETRY_QUEUE.
+# If the thread stops for some reason -shouldn't happen-, we restart a new one.
+_TELEMETRY_THREAD: Optional[Thread] = None
+_TELEMETRY_THREAD_LOCK = Lock()  # Lock to avoid starting multiple threads in parallel
+_TELEMETRY_QUEUE: Queue = Queue()
+
+
+def send_telemetry(
+    topic: str,
+    *,
+    library_name: Optional[str] = None,
+    library_version: Optional[str] = None,
+    user_agent: Union[Dict, str, None] = None,
+) -> None:
+    """
+    Sends telemetry that helps tracking usage of different HF libraries.
+
+    This usage data helps us debug issues and prioritize new features. However, we understand that not everyone wants
+    to share additional information, and we respect your privacy. You can disable telemetry collection by setting the
+    `HF_HUB_DISABLE_TELEMETRY=1` as environment variable. Telemetry is also disabled in offline mode (i.e. when setting
+    `HF_HUB_OFFLINE=1`).
+
+    Telemetry collection is run in a separate thread to minimize impact for the user.
+
+    Args:
+        topic (`str`):
+            Name of the topic that is monitored. The topic is directly used to build the URL. If you want to monitor
+            subtopics, just use "/" separation. Examples: "gradio", "transformers/examples",...
+        library_name (`str`, *optional*):
+            The name of the library that is making the HTTP request. Will be added to the user-agent header.
+        library_version (`str`, *optional*):
+            The version of the library that is making the HTTP request. Will be added to the user-agent header.
+        user_agent (`str`, `dict`, *optional*):
+            The user agent info in the form of a dictionary or a single string. It will be completed with information about the installed packages.
+
+    Example:
+    ```py
+    >>> from huggingface_hub.utils import send_telemetry
+
+    # Send telemetry without library information
+    >>> send_telemetry("ping")
+
+    # Send telemetry to subtopic with library information
+    >>> send_telemetry("gradio/local_link", library_name="gradio", library_version="3.22.1")
+
+    # Send telemetry with additional data
+    >>> send_telemetry(
+    ...     topic="examples",
+    ...     library_name="transformers",
+    ...     library_version="4.26.0",
+    ...     user_agent={"pipeline": "text_classification", "framework": "flax"},
+    ... )
+    ```
+    """
+    if constants.HF_HUB_OFFLINE or constants.HF_HUB_DISABLE_TELEMETRY:
+        return
+
+    _start_telemetry_thread()  # starts thread only if doesn't exist yet
+    _TELEMETRY_QUEUE.put(
+        {"topic": topic, "library_name": library_name, "library_version": library_version, "user_agent": user_agent}
+    )
+
+
+def _start_telemetry_thread():
+    """Start a daemon thread to consume tasks from the telemetry queue.
+
+    If the thread is interrupted, start a new one.
+    """
+    with _TELEMETRY_THREAD_LOCK:  # avoid to start multiple threads if called concurrently
+        global _TELEMETRY_THREAD
+        if _TELEMETRY_THREAD is None or not _TELEMETRY_THREAD.is_alive():
+            _TELEMETRY_THREAD = Thread(target=_telemetry_worker, daemon=True)
+            _TELEMETRY_THREAD.start()
+
+
+def _telemetry_worker():
+    """Wait for a task and consume it."""
+    while True:
+        kwargs = _TELEMETRY_QUEUE.get()
+        _send_telemetry_in_thread(**kwargs)
+        _TELEMETRY_QUEUE.task_done()
+
+
+def _send_telemetry_in_thread(
+    topic: str,
+    *,
+    library_name: Optional[str] = None,
+    library_version: Optional[str] = None,
+    user_agent: Union[Dict, str, None] = None,
+) -> None:
+    """Contains the actual data sending data to the Hub."""
+    path = "/".join(quote(part) for part in topic.split("/") if len(part) > 0)
+    try:
+        r = get_session().head(
+            f"{constants.ENDPOINT}/api/telemetry/{path}",
+            headers=build_hf_headers(
+                token=False,  # no need to send a token for telemetry
+                library_name=library_name,
+                library_version=library_version,
+                user_agent=user_agent,
+            ),
+        )
+        hf_raise_for_status(r)
+    except Exception as e:
+        # We don't want to error in case of connection errors of any kind.
+        logger.debug(f"Error while sending telemetry: {e}")
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_token.py b/llm/Lib/site-packages/huggingface_hub/utils/_token.py
new file mode 100644
index 0000000000000000000000000000000000000000..3218bb45c0737f67912c9c257734c463f5871255
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_token.py
@@ -0,0 +1,130 @@
+# Copyright 2023 The HuggingFace Team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains an helper to get the token from machine (env variable, secret or config file)."""
+
+import os
+import warnings
+from pathlib import Path
+from threading import Lock
+from typing import Optional
+
+from .. import constants
+from ._runtime import is_google_colab
+
+
+_IS_GOOGLE_COLAB_CHECKED = False
+_GOOGLE_COLAB_SECRET_LOCK = Lock()
+_GOOGLE_COLAB_SECRET: Optional[str] = None
+
+
+def get_token() -> Optional[str]:
+    """
+    Get token if user is logged in.
+
+    Note: in most cases, you should use [`huggingface_hub.utils.build_hf_headers`] instead. This method is only useful
+          if you want to retrieve the token for other purposes than sending an HTTP request.
+
+    Token is retrieved in priority from the `HF_TOKEN` environment variable. Otherwise, we read the token file located
+    in the Hugging Face home folder. Returns None if user is not logged in. To log in, use [`login`] or
+    `huggingface-cli login`.
+
+    Returns:
+        `str` or `None`: The token, `None` if it doesn't exist.
+    """
+    return _get_token_from_google_colab() or _get_token_from_environment() or _get_token_from_file()
+
+
+def _get_token_from_google_colab() -> Optional[str]:
+    """Get token from Google Colab secrets vault using `google.colab.userdata.get(...)`.
+
+    Token is read from the vault only once per session and then stored in a global variable to avoid re-requesting
+    access to the vault.
+    """
+    if not is_google_colab():
+        return None
+
+    # `google.colab.userdata` is not thread-safe
+    # This can lead to a deadlock if multiple threads try to access it at the same time
+    # (typically when using `snapshot_download`)
+    # => use a lock
+    # See https://github.com/huggingface/huggingface_hub/issues/1952 for more details.
+    with _GOOGLE_COLAB_SECRET_LOCK:
+        global _GOOGLE_COLAB_SECRET
+        global _IS_GOOGLE_COLAB_CHECKED
+
+        if _IS_GOOGLE_COLAB_CHECKED:  # request access only once
+            return _GOOGLE_COLAB_SECRET
+
+        try:
+            from google.colab import userdata
+            from google.colab.errors import Error as ColabError
+        except ImportError:
+            return None
+
+        try:
+            token = userdata.get("HF_TOKEN")
+            _GOOGLE_COLAB_SECRET = _clean_token(token)
+        except userdata.NotebookAccessError:
+            # Means the user has a secret call `HF_TOKEN` and got a popup "please grand access to HF_TOKEN" and refused it
+            # => warn user but ignore error => do not re-request access to user
+            warnings.warn(
+                "\nAccess to the secret `HF_TOKEN` has not been granted on this notebook."
+                "\nYou will not be requested again."
+                "\nPlease restart the session if you want to be prompted again."
+            )
+            _GOOGLE_COLAB_SECRET = None
+        except userdata.SecretNotFoundError:
+            # Means the user did not define a `HF_TOKEN` secret => warn
+            warnings.warn(
+                "\nThe secret `HF_TOKEN` does not exist in your Colab secrets."
+                "\nTo authenticate with the Hugging Face Hub, create a token in your settings tab "
+                "(https://huggingface.co/settings/tokens), set it as secret in your Google Colab and restart your session."
+                "\nYou will be able to reuse this secret in all of your notebooks."
+                "\nPlease note that authentication is recommended but still optional to access public models or datasets."
+            )
+            _GOOGLE_COLAB_SECRET = None
+        except ColabError as e:
+            # Something happen but we don't know what => recommend to open a GitHub issue
+            warnings.warn(
+                f"\nError while fetching `HF_TOKEN` secret value from your vault: '{str(e)}'."
+                "\nYou are not authenticated with the Hugging Face Hub in this notebook."
+                "\nIf the error persists, please let us know by opening an issue on GitHub "
+                "(https://github.com/huggingface/huggingface_hub/issues/new)."
+            )
+            _GOOGLE_COLAB_SECRET = None
+
+        _IS_GOOGLE_COLAB_CHECKED = True
+        return _GOOGLE_COLAB_SECRET
+
+
+def _get_token_from_environment() -> Optional[str]:
+    # `HF_TOKEN` has priority (keep `HUGGING_FACE_HUB_TOKEN` for backward compatibility)
+    return _clean_token(os.environ.get("HF_TOKEN") or os.environ.get("HUGGING_FACE_HUB_TOKEN"))
+
+
+def _get_token_from_file() -> Optional[str]:
+    try:
+        return _clean_token(Path(constants.HF_TOKEN_PATH).read_text())
+    except FileNotFoundError:
+        return None
+
+
+def _clean_token(token: Optional[str]) -> Optional[str]:
+    """Clean token by removing trailing and leading spaces and newlines.
+
+    If token is an empty string, return None.
+    """
+    if token is None:
+        return None
+    return token.replace("\r", "").replace("\n", "").strip() or None
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_typing.py b/llm/Lib/site-packages/huggingface_hub/utils/_typing.py
new file mode 100644
index 0000000000000000000000000000000000000000..ae502b825bcb900ea076ffe1b0fe1078569821c5
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_typing.py
@@ -0,0 +1,50 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Handle typing imports based on system compatibility."""
+
+from typing import Any, Callable, Literal, TypeVar
+
+
+HTTP_METHOD_T = Literal["GET", "OPTIONS", "HEAD", "POST", "PUT", "PATCH", "DELETE"]
+
+# type hint meaning "function signature not changed by decorator"
+CallableT = TypeVar("CallableT", bound=Callable)
+
+_JSON_SERIALIZABLE_TYPES = (int, float, str, bool, type(None))
+
+
+def is_jsonable(obj: Any) -> bool:
+    """Check if an object is JSON serializable.
+
+    This is a weak check, as it does not check for the actual JSON serialization, but only for the types of the object.
+    It works correctly for basic use cases but do not guarantee an exhaustive check.
+
+    Object is considered to be recursively json serializable if:
+    - it is an instance of int, float, str, bool, or NoneType
+    - it is a list or tuple and all its items are json serializable
+    - it is a dict and all its keys are strings and all its values are json serializable
+    """
+    try:
+        if isinstance(obj, _JSON_SERIALIZABLE_TYPES):
+            return True
+        if isinstance(obj, (list, tuple)):
+            return all(is_jsonable(item) for item in obj)
+        if isinstance(obj, dict):
+            return all(isinstance(key, str) and is_jsonable(value) for key, value in obj.items())
+        if hasattr(obj, "__json__"):
+            return True
+        return False
+    except RecursionError:
+        return False
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/_validators.py b/llm/Lib/site-packages/huggingface_hub/utils/_validators.py
new file mode 100644
index 0000000000000000000000000000000000000000..f58d38919791127b871b5d1accb9b38b064e1075
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/_validators.py
@@ -0,0 +1,231 @@
+# coding=utf-8
+# Copyright 2022-present, the HuggingFace Inc. team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Contains utilities to validate argument values in `huggingface_hub`."""
+
+import inspect
+import re
+import warnings
+from functools import wraps
+from itertools import chain
+from typing import Any, Dict
+
+from ._typing import CallableT
+
+
+REPO_ID_REGEX = re.compile(
+    r"""
+    ^
+    (\b[\w\-.]+\b/)? # optional namespace (username or organization)
+    \b               # starts with a word boundary
+    [\w\-.]{1,96}    # repo_name: alphanumeric + . _ -
+    \b               # ends with a word boundary
+    $
+    """,
+    flags=re.VERBOSE,
+)
+
+
+class HFValidationError(ValueError):
+    """Generic exception thrown by `huggingface_hub` validators.
+
+    Inherits from [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError).
+    """
+
+
+def validate_hf_hub_args(fn: CallableT) -> CallableT:
+    """Validate values received as argument for any public method of `huggingface_hub`.
+
+    The goal of this decorator is to harmonize validation of arguments reused
+    everywhere. By default, all defined validators are tested.
+
+    Validators:
+        - [`~utils.validate_repo_id`]: `repo_id` must be `"repo_name"`
+          or `"namespace/repo_name"`. Namespace is a username or an organization.
+        - [`~utils.smoothly_deprecate_use_auth_token`]: Use `token` instead of
+          `use_auth_token` (only if `use_auth_token` is not expected by the decorated
+          function - in practice, always the case in `huggingface_hub`).
+
+    Example:
+    ```py
+    >>> from huggingface_hub.utils import validate_hf_hub_args
+
+    >>> @validate_hf_hub_args
+    ... def my_cool_method(repo_id: str):
+    ...     print(repo_id)
+
+    >>> my_cool_method(repo_id="valid_repo_id")
+    valid_repo_id
+
+    >>> my_cool_method("other..repo..id")
+    huggingface_hub.utils._validators.HFValidationError: Cannot have -- or .. in repo_id: 'other..repo..id'.
+
+    >>> my_cool_method(repo_id="other..repo..id")
+    huggingface_hub.utils._validators.HFValidationError: Cannot have -- or .. in repo_id: 'other..repo..id'.
+
+    >>> @validate_hf_hub_args
+    ... def my_cool_auth_method(token: str):
+    ...     print(token)
+
+    >>> my_cool_auth_method(token="a token")
+    "a token"
+
+    >>> my_cool_auth_method(use_auth_token="a use_auth_token")
+    "a use_auth_token"
+
+    >>> my_cool_auth_method(token="a token", use_auth_token="a use_auth_token")
+    UserWarning: Both `token` and `use_auth_token` are passed (...)
+    "a token"
+    ```
+
+    Raises:
+        [`~utils.HFValidationError`]:
+            If an input is not valid.
+    """
+    # TODO: add an argument to opt-out validation for specific argument?
+    signature = inspect.signature(fn)
+
+    # Should the validator switch `use_auth_token` values to `token`? In practice, always
+    # True in `huggingface_hub`. Might not be the case in a downstream library.
+    check_use_auth_token = "use_auth_token" not in signature.parameters and "token" in signature.parameters
+
+    @wraps(fn)
+    def _inner_fn(*args, **kwargs):
+        has_token = False
+        for arg_name, arg_value in chain(
+            zip(signature.parameters, args),  # Args values
+            kwargs.items(),  # Kwargs values
+        ):
+            if arg_name in ["repo_id", "from_id", "to_id"]:
+                validate_repo_id(arg_value)
+
+            elif arg_name == "token" and arg_value is not None:
+                has_token = True
+
+        if check_use_auth_token:
+            kwargs = smoothly_deprecate_use_auth_token(fn_name=fn.__name__, has_token=has_token, kwargs=kwargs)
+
+        return fn(*args, **kwargs)
+
+    return _inner_fn  # type: ignore
+
+
+def validate_repo_id(repo_id: str) -> None:
+    """Validate `repo_id` is valid.
+
+    This is not meant to replace the proper validation made on the Hub but rather to
+    avoid local inconsistencies whenever possible (example: passing `repo_type` in the
+    `repo_id` is forbidden).
+
+    Rules:
+    - Between 1 and 96 characters.
+    - Either "repo_name" or "namespace/repo_name"
+    - [a-zA-Z0-9] or "-", "_", "."
+    - "--" and ".." are forbidden
+
+    Valid: `"foo"`, `"foo/bar"`, `"123"`, `"Foo-BAR_foo.bar123"`
+
+    Not valid: `"datasets/foo/bar"`, `".repo_id"`, `"foo--bar"`, `"foo.git"`
+
+    Example:
+    ```py
+    >>> from huggingface_hub.utils import validate_repo_id
+    >>> validate_repo_id(repo_id="valid_repo_id")
+    >>> validate_repo_id(repo_id="other..repo..id")
+    huggingface_hub.utils._validators.HFValidationError: Cannot have -- or .. in repo_id: 'other..repo..id'.
+    ```
+
+    Discussed in https://github.com/huggingface/huggingface_hub/issues/1008.
+    In moon-landing (internal repository):
+    - https://github.com/huggingface/moon-landing/blob/main/server/lib/Names.ts#L27
+    - https://github.com/huggingface/moon-landing/blob/main/server/views/components/NewRepoForm/NewRepoForm.svelte#L138
+    """
+    if not isinstance(repo_id, str):
+        # Typically, a Path is not a repo_id
+        raise HFValidationError(f"Repo id must be a string, not {type(repo_id)}: '{repo_id}'.")
+
+    if repo_id.count("/") > 1:
+        raise HFValidationError(
+            "Repo id must be in the form 'repo_name' or 'namespace/repo_name':"
+            f" '{repo_id}'. Use `repo_type` argument if needed."
+        )
+
+    if not REPO_ID_REGEX.match(repo_id):
+        raise HFValidationError(
+            "Repo id must use alphanumeric chars or '-', '_', '.', '--' and '..' are"
+            " forbidden, '-' and '.' cannot start or end the name, max length is 96:"
+            f" '{repo_id}'."
+        )
+
+    if "--" in repo_id or ".." in repo_id:
+        raise HFValidationError(f"Cannot have -- or .. in repo_id: '{repo_id}'.")
+
+    if repo_id.endswith(".git"):
+        raise HFValidationError(f"Repo_id cannot end by '.git': '{repo_id}'.")
+
+
+def smoothly_deprecate_use_auth_token(fn_name: str, has_token: bool, kwargs: Dict[str, Any]) -> Dict[str, Any]:
+    """Smoothly deprecate `use_auth_token` in the `huggingface_hub` codebase.
+
+    The long-term goal is to remove any mention of `use_auth_token` in the codebase in
+    favor of a unique and less verbose `token` argument. This will be done a few steps:
+
+    0. Step 0: methods that require a read-access to the Hub use the `use_auth_token`
+       argument (`str`, `bool` or `None`). Methods requiring write-access have a `token`
+       argument (`str`, `None`). This implicit rule exists to be able to not send the
+       token when not necessary (`use_auth_token=False`) even if logged in.
+
+    1. Step 1: we want to harmonize everything and use `token` everywhere (supporting
+       `token=False` for read-only methods). In order not to break existing code, if
+       `use_auth_token` is passed to a function, the `use_auth_token` value is passed
+       as `token` instead, without any warning.
+       a. Corner case: if both `use_auth_token` and `token` values are passed, a warning
+          is thrown and the `use_auth_token` value is ignored.
+
+    2. Step 2: Once it is release, we should push downstream libraries to switch from
+       `use_auth_token` to `token` as much as possible, but without throwing a warning
+       (e.g. manually create issues on the corresponding repos).
+
+    3. Step 3: After a transitional period (6 months e.g. until April 2023?), we update
+       `huggingface_hub` to throw a warning on `use_auth_token`. Hopefully, very few
+       users will be impacted as it would have already been fixed.
+       In addition, unit tests in `huggingface_hub` must be adapted to expect warnings
+       to be thrown (but still use `use_auth_token` as before).
+
+    4. Step 4: After a normal deprecation cycle (3 releases ?), remove this validator.
+       `use_auth_token` will definitely not be supported.
+       In addition, we update unit tests in `huggingface_hub` to use `token` everywhere.
+
+    This has been discussed in:
+    - https://github.com/huggingface/huggingface_hub/issues/1094.
+    - https://github.com/huggingface/huggingface_hub/pull/928
+    - (related) https://github.com/huggingface/huggingface_hub/pull/1064
+    """
+    new_kwargs = kwargs.copy()  # do not mutate input !
+
+    use_auth_token = new_kwargs.pop("use_auth_token", None)  # remove from kwargs
+    if use_auth_token is not None:
+        if has_token:
+            warnings.warn(
+                "Both `token` and `use_auth_token` are passed to"
+                f" `{fn_name}` with non-None values. `token` is now the"
+                " preferred argument to pass a User Access Token."
+                " `use_auth_token` value will be ignored."
+            )
+        else:
+            # `token` argument is not passed and a non-None value is passed in
+            # `use_auth_token` => use `use_auth_token` value as `token` kwarg.
+            new_kwargs["token"] = use_auth_token
+
+    return new_kwargs
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/endpoint_helpers.py b/llm/Lib/site-packages/huggingface_hub/utils/endpoint_helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..ac52ce85a0f45932aeefc702eb44828ad2e17871
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/endpoint_helpers.py
@@ -0,0 +1,250 @@
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""
+Helpful utility functions and classes in relation to exploring API endpoints
+with the aim for a user-friendly interface.
+"""
+
+import math
+import re
+import warnings
+from dataclasses import dataclass
+from typing import TYPE_CHECKING, List, Optional, Union
+
+from ..repocard_data import ModelCardData
+
+
+if TYPE_CHECKING:
+    from ..hf_api import ModelInfo
+
+
+def _is_emission_within_treshold(model_info: "ModelInfo", minimum_threshold: float, maximum_threshold: float) -> bool:
+    """Checks if a model's emission is within a given threshold.
+
+    Args:
+        model_info (`ModelInfo`):
+            A model info object containing the model's emission information.
+        minimum_threshold (`float`):
+            A minimum carbon threshold to filter by, such as 1.
+        maximum_threshold (`float`):
+            A maximum carbon threshold to filter by, such as 10.
+
+    Returns:
+        `bool`: Whether the model's emission is within the given threshold.
+    """
+    if minimum_threshold is None and maximum_threshold is None:
+        raise ValueError("Both `minimum_threshold` and `maximum_threshold` cannot both be `None`")
+    if minimum_threshold is None:
+        minimum_threshold = -1
+    if maximum_threshold is None:
+        maximum_threshold = math.inf
+
+    card_data = getattr(model_info, "card_data", None)
+    if card_data is None or not isinstance(card_data, (dict, ModelCardData)):
+        return False
+
+    # Get CO2 emission metadata
+    emission = card_data.get("co2_eq_emissions", None)
+    if isinstance(emission, dict):
+        emission = emission["emissions"]
+    if not emission:
+        return False
+
+    # Filter out if value is missing or out of range
+    matched = re.search(r"\d+\.\d+|\d+", str(emission))
+    if matched is None:
+        return False
+
+    emission_value = float(matched.group(0))
+    return minimum_threshold <= emission_value <= maximum_threshold
+
+
+@dataclass
+class DatasetFilter:
+    """
+    A class that converts human-readable dataset search parameters into ones
+    compatible with the REST API. For all parameters capitalization does not
+    matter.
+
+    <Tip warning={true}>
+
+        The `DatasetFilter` class is deprecated and will be removed in huggingface_hub>=0.24. Please pass the filter parameters as keyword arguments directly to [`list_datasets`].
+
+    </Tip>
+
+    Args:
+        author (`str`, *optional*):
+            A string that can be used to identify datasets on
+            the Hub by the original uploader (author or organization), such as
+            `facebook` or `huggingface`.
+        benchmark (`str` or `List`, *optional*):
+            A string or list of strings that can be used to identify datasets on
+            the Hub by their official benchmark.
+        dataset_name (`str`, *optional*):
+            A string or list of strings that can be used to identify datasets on
+            the Hub by its name, such as `SQAC` or `wikineural`
+        language_creators (`str` or `List`, *optional*):
+            A string or list of strings that can be used to identify datasets on
+            the Hub with how the data was curated, such as `crowdsourced` or
+            `machine_generated`.
+        language (`str` or `List`, *optional*):
+            A string or list of strings representing a two-character language to
+            filter datasets by on the Hub.
+        multilinguality (`str` or `List`, *optional*):
+            A string or list of strings representing a filter for datasets that
+            contain multiple languages.
+        size_categories (`str` or `List`, *optional*):
+            A string or list of strings that can be used to identify datasets on
+            the Hub by the size of the dataset such as `100K<n<1M` or
+            `1M<n<10M`.
+        task_categories (`str` or `List`, *optional*):
+            A string or list of strings that can be used to identify datasets on
+            the Hub by the designed task, such as `audio_classification` or
+            `named_entity_recognition`.
+        task_ids (`str` or `List`, *optional*):
+            A string or list of strings that can be used to identify datasets on
+            the Hub by the specific task such as `speech_emotion_recognition` or
+            `paraphrase`.
+
+    Examples:
+
+    ```py
+    >>> from huggingface_hub import DatasetFilter
+
+    >>> # Using author
+    >>> new_filter = DatasetFilter(author="facebook")
+
+    >>> # Using benchmark
+    >>> new_filter = DatasetFilter(benchmark="raft")
+
+    >>> # Using dataset_name
+    >>> new_filter = DatasetFilter(dataset_name="wikineural")
+
+    >>> # Using language_creator
+    >>> new_filter = DatasetFilter(language_creator="crowdsourced")
+
+    >>> # Using language
+    >>> new_filter = DatasetFilter(language="en")
+
+    >>> # Using multilinguality
+    >>> new_filter = DatasetFilter(multilinguality="multilingual")
+
+    >>> # Using size_categories
+    >>> new_filter = DatasetFilter(size_categories="100K<n<1M")
+
+    >>> # Using task_categories
+    >>> new_filter = DatasetFilter(task_categories="audio_classification")
+
+    >>> # Using task_ids
+    >>> new_filter = DatasetFilter(task_ids="paraphrase")
+    ```
+    """
+
+    author: Optional[str] = None
+    benchmark: Optional[Union[str, List[str]]] = None
+    dataset_name: Optional[str] = None
+    language_creators: Optional[Union[str, List[str]]] = None
+    language: Optional[Union[str, List[str]]] = None
+    multilinguality: Optional[Union[str, List[str]]] = None
+    size_categories: Optional[Union[str, List[str]]] = None
+    task_categories: Optional[Union[str, List[str]]] = None
+    task_ids: Optional[Union[str, List[str]]] = None
+
+    def __post_init__(self):
+        warnings.warn(
+            "'DatasetFilter' is deprecated and will be removed in huggingface_hub>=0.24. Please pass the filter parameters as keyword arguments directly to the `list_datasets` method.",
+            category=FutureWarning,
+        )
+
+
+@dataclass
+class ModelFilter:
+    """
+    A class that converts human-readable model search parameters into ones
+    compatible with the REST API. For all parameters capitalization does not
+    matter.
+
+    <Tip warning={true}>
+
+        The `ModelFilter` class is deprecated and will be removed in huggingface_hub>=0.24. Please pass the filter parameters as keyword arguments directly to [`list_models`].
+
+    </Tip>
+
+    Args:
+        author (`str`, *optional*):
+            A string that can be used to identify models on the Hub by the
+            original uploader (author or organization), such as `facebook` or
+            `huggingface`.
+        library (`str` or `List`, *optional*):
+            A string or list of strings of foundational libraries models were
+            originally trained from, such as pytorch, tensorflow, or allennlp.
+        language (`str` or `List`, *optional*):
+            A string or list of strings of languages, both by name and country
+            code, such as "en" or "English"
+        model_name (`str`, *optional*):
+            A string that contain complete or partial names for models on the
+            Hub, such as "bert" or "bert-base-cased"
+        task (`str` or `List`, *optional*):
+            A string or list of strings of tasks models were designed for, such
+            as: "fill-mask" or "automatic-speech-recognition"
+        tags (`str` or `List`, *optional*):
+            A string tag or a list of tags to filter models on the Hub by, such
+            as `text-generation` or `spacy`.
+        trained_dataset (`str` or `List`, *optional*):
+            A string tag or a list of string tags of the trained dataset for a
+            model on the Hub.
+
+    Examples:
+
+    ```python
+    >>> from huggingface_hub import ModelFilter
+
+    >>> # For the author_or_organization
+    >>> new_filter = ModelFilter(author_or_organization="facebook")
+
+    >>> # For the library
+    >>> new_filter = ModelFilter(library="pytorch")
+
+    >>> # For the language
+    >>> new_filter = ModelFilter(language="french")
+
+    >>> # For the model_name
+    >>> new_filter = ModelFilter(model_name="bert")
+
+    >>> # For the task
+    >>> new_filter = ModelFilter(task="text-classification")
+
+    >>> from huggingface_hub import HfApi
+
+    >>> api = HfApi()
+    # To list model tags
+
+    >>> new_filter = ModelFilter(tags="benchmark:raft")
+
+    >>> # Related to the dataset
+    >>> new_filter = ModelFilter(trained_dataset="common_voice")
+    ```
+    """
+
+    author: Optional[str] = None
+    library: Optional[Union[str, List[str]]] = None
+    language: Optional[Union[str, List[str]]] = None
+    model_name: Optional[str] = None
+    task: Optional[Union[str, List[str]]] = None
+    trained_dataset: Optional[Union[str, List[str]]] = None
+    tags: Optional[Union[str, List[str]]] = None
+
+    def __post_init__(self):
+        warnings.warn(
+            "'ModelFilter' is deprecated and will be removed in huggingface_hub>=0.24. Please pass the filter parameters as keyword arguments directly to the `list_models` method.",
+            FutureWarning,
+        )
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/insecure_hashlib.py b/llm/Lib/site-packages/huggingface_hub/utils/insecure_hashlib.py
new file mode 100644
index 0000000000000000000000000000000000000000..f232ee0adcfc52dcc18b5ea4d9c913b206521f71
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/insecure_hashlib.py
@@ -0,0 +1,34 @@
+# Taken from https://github.com/mlflow/mlflow/pull/10119
+#
+# DO NOT use this function for security purposes (e.g., password hashing).
+#
+# In Python >= 3.9, insecure hashing algorithms such as MD5 fail in FIPS-compliant
+# environments unless `usedforsecurity=False` is explicitly passed.
+#
+# References:
+# - https://github.com/mlflow/mlflow/issues/9905
+# - https://github.com/mlflow/mlflow/pull/10119
+# - https://docs.python.org/3/library/hashlib.html
+# - https://github.com/huggingface/transformers/pull/27038
+#
+# Usage:
+#     ```python
+#     # Use
+#     from huggingface_hub.utils.insecure_hashlib import sha256
+#     # instead of
+#     from hashlib import sha256
+#
+#     # Use
+#     from huggingface_hub.utils import insecure_hashlib
+#     # instead of
+#     import hashlib
+#     ```
+import functools
+import hashlib
+import sys
+
+
+_kwargs = {"usedforsecurity": False} if sys.version_info >= (3, 9) else {}
+md5 = functools.partial(hashlib.md5, **_kwargs)
+sha1 = functools.partial(hashlib.sha1, **_kwargs)
+sha256 = functools.partial(hashlib.sha256, **_kwargs)
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/logging.py b/llm/Lib/site-packages/huggingface_hub/utils/logging.py
new file mode 100644
index 0000000000000000000000000000000000000000..3aafdf148135397556b4bb762862377eafdafd14
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/logging.py
@@ -0,0 +1,182 @@
+# coding=utf-8
+# Copyright 2020 Optuna, Hugging Face
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Logging utilities."""
+
+import logging
+import os
+from logging import (
+    CRITICAL,  # NOQA
+    DEBUG,  # NOQA
+    ERROR,  # NOQA
+    FATAL,  # NOQA
+    INFO,  # NOQA
+    NOTSET,  # NOQA
+    WARN,  # NOQA
+    WARNING,  # NOQA
+)
+from typing import Optional
+
+
+log_levels = {
+    "debug": logging.DEBUG,
+    "info": logging.INFO,
+    "warning": logging.WARNING,
+    "error": logging.ERROR,
+    "critical": logging.CRITICAL,
+}
+
+_default_log_level = logging.WARNING
+
+
+def _get_library_name() -> str:
+    return __name__.split(".")[0]
+
+
+def _get_library_root_logger() -> logging.Logger:
+    return logging.getLogger(_get_library_name())
+
+
+def _get_default_logging_level():
+    """
+    If `HF_HUB_VERBOSITY` env var is set to one of the valid choices return that as the new default level. If it is not
+    - fall back to `_default_log_level`
+    """
+    env_level_str = os.getenv("HF_HUB_VERBOSITY", None)
+    if env_level_str:
+        if env_level_str in log_levels:
+            return log_levels[env_level_str]
+        else:
+            logging.getLogger().warning(
+                f"Unknown option HF_HUB_VERBOSITY={env_level_str}, has to be one of: { ', '.join(log_levels.keys()) }"
+            )
+    return _default_log_level
+
+
+def _configure_library_root_logger() -> None:
+    library_root_logger = _get_library_root_logger()
+    library_root_logger.addHandler(logging.StreamHandler())
+    library_root_logger.setLevel(_get_default_logging_level())
+
+
+def _reset_library_root_logger() -> None:
+    library_root_logger = _get_library_root_logger()
+    library_root_logger.setLevel(logging.NOTSET)
+
+
+def get_logger(name: Optional[str] = None) -> logging.Logger:
+    """
+        Returns a logger with the specified name. This function is not supposed
+        to be directly accessed by library users.
+
+        Args:
+            name (`str`, *optional*):
+                The name of the logger to get, usually the filename
+
+        Example:
+
+    ```python
+    >>> from huggingface_hub import get_logger
+
+    >>> logger = get_logger(__file__)
+    >>> logger.set_verbosity_info()
+    ```
+    """
+
+    if name is None:
+        name = _get_library_name()
+
+    return logging.getLogger(name)
+
+
+def get_verbosity() -> int:
+    """Return the current level for the HuggingFace Hub's root logger.
+
+    Returns:
+        Logging level, e.g., `huggingface_hub.logging.DEBUG` and
+        `huggingface_hub.logging.INFO`.
+
+    <Tip>
+
+    HuggingFace Hub has following logging levels:
+
+    - `huggingface_hub.logging.CRITICAL`, `huggingface_hub.logging.FATAL`
+    - `huggingface_hub.logging.ERROR`
+    - `huggingface_hub.logging.WARNING`, `huggingface_hub.logging.WARN`
+    - `huggingface_hub.logging.INFO`
+    - `huggingface_hub.logging.DEBUG`
+
+    </Tip>
+    """
+    return _get_library_root_logger().getEffectiveLevel()
+
+
+def set_verbosity(verbosity: int) -> None:
+    """
+    Sets the level for the HuggingFace Hub's root logger.
+
+    Args:
+        verbosity (`int`):
+            Logging level, e.g., `huggingface_hub.logging.DEBUG` and
+            `huggingface_hub.logging.INFO`.
+    """
+    _get_library_root_logger().setLevel(verbosity)
+
+
+def set_verbosity_info():
+    """
+    Sets the verbosity to `logging.INFO`.
+    """
+    return set_verbosity(INFO)
+
+
+def set_verbosity_warning():
+    """
+    Sets the verbosity to `logging.WARNING`.
+    """
+    return set_verbosity(WARNING)
+
+
+def set_verbosity_debug():
+    """
+    Sets the verbosity to `logging.DEBUG`.
+    """
+    return set_verbosity(DEBUG)
+
+
+def set_verbosity_error():
+    """
+    Sets the verbosity to `logging.ERROR`.
+    """
+    return set_verbosity(ERROR)
+
+
+def disable_propagation() -> None:
+    """
+    Disable propagation of the library log outputs. Note that log propagation is
+    disabled by default.
+    """
+    _get_library_root_logger().propagate = False
+
+
+def enable_propagation() -> None:
+    """
+    Enable propagation of the library log outputs. Please disable the
+    HuggingFace Hub's default handler to prevent double logging if the root
+    logger has been configured.
+    """
+    _get_library_root_logger().propagate = True
+
+
+_configure_library_root_logger()
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/sha.py b/llm/Lib/site-packages/huggingface_hub/utils/sha.py
new file mode 100644
index 0000000000000000000000000000000000000000..233ab074e69a47de9a443a458ce44e1429a1e22c
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/sha.py
@@ -0,0 +1,29 @@
+"""Utilities to efficiently compute the SHA 256 hash of a bunch of bytes."""
+
+from typing import BinaryIO, Optional
+
+from .insecure_hashlib import sha256
+
+
+def sha_fileobj(fileobj: BinaryIO, chunk_size: Optional[int] = None) -> bytes:
+    """
+    Computes the sha256 hash of the given file object, by chunks of size `chunk_size`.
+
+    Args:
+        fileobj (file-like object):
+            The File object to compute sha256 for, typically obtained with `open(path, "rb")`
+        chunk_size (`int`, *optional*):
+            The number of bytes to read from `fileobj` at once, defaults to 1MB.
+
+    Returns:
+        `bytes`: `fileobj`'s sha256 hash as bytes
+    """
+    chunk_size = chunk_size if chunk_size is not None else 1024 * 1024
+
+    sha = sha256()
+    while True:
+        chunk = fileobj.read(chunk_size)
+        sha.update(chunk)
+        if not chunk:
+            break
+    return sha.digest()
diff --git a/llm/Lib/site-packages/huggingface_hub/utils/tqdm.py b/llm/Lib/site-packages/huggingface_hub/utils/tqdm.py
new file mode 100644
index 0000000000000000000000000000000000000000..da1e421a21e65c04b7c53efd8f95d8df4f663473
--- /dev/null
+++ b/llm/Lib/site-packages/huggingface_hub/utils/tqdm.py
@@ -0,0 +1,187 @@
+#!/usr/bin/env python
+# coding=utf-8
+# Copyright 2021 The HuggingFace Inc. team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License
+"""Utility helpers to handle progress bars in `huggingface_hub`.
+
+Example:
+    1. Use `huggingface_hub.utils.tqdm` as you would use `tqdm.tqdm` or `tqdm.auto.tqdm`.
+    2. To disable progress bars, either use `disable_progress_bars()` helper or set the
+       environment variable `HF_HUB_DISABLE_PROGRESS_BARS` to 1.
+    3. To re-enable progress bars, use `enable_progress_bars()`.
+    4. To check whether progress bars are disabled, use `are_progress_bars_disabled()`.
+
+NOTE: Environment variable `HF_HUB_DISABLE_PROGRESS_BARS` has the priority.
+
+Example:
+    ```py
+    from huggingface_hub.utils import (
+        are_progress_bars_disabled,
+        disable_progress_bars,
+        enable_progress_bars,
+        tqdm,
+    )
+
+    # Disable progress bars globally
+    disable_progress_bars()
+
+    # Use as normal `tqdm`
+    for _ in tqdm(range(5)):
+       do_something()
+
+    # Still not showing progress bars, as `disable=False` is overwritten to `True`.
+    for _ in tqdm(range(5), disable=False):
+       do_something()
+
+    are_progress_bars_disabled() # True
+
+    # Re-enable progress bars globally
+    enable_progress_bars()
+
+    # Progress bar will be shown !
+    for _ in tqdm(range(5)):
+       do_something()
+    ```
+"""
+
+import io
+import warnings
+from contextlib import contextmanager
+from pathlib import Path
+from typing import Iterator, Optional, Union
+
+from tqdm.auto import tqdm as old_tqdm
+
+from ..constants import HF_HUB_DISABLE_PROGRESS_BARS
+
+
+# `HF_HUB_DISABLE_PROGRESS_BARS` is `Optional[bool]` while `_hf_hub_progress_bars_disabled`
+# is a `bool`. If `HF_HUB_DISABLE_PROGRESS_BARS` is set to True or False, it has priority.
+# If `HF_HUB_DISABLE_PROGRESS_BARS` is None, it means the user have not set the
+# environment variable and is free to enable/disable progress bars programmatically.
+# TL;DR: env variable has priority over code.
+#
+# By default, progress bars are enabled.
+_hf_hub_progress_bars_disabled: bool = HF_HUB_DISABLE_PROGRESS_BARS or False
+
+
+def disable_progress_bars() -> None:
+    """
+    Disable globally progress bars used in `huggingface_hub` except if `HF_HUB_DISABLE_PROGRESS_BARS` environment
+    variable has been set.
+
+    Use [`~utils.enable_progress_bars`] to re-enable them.
+    """
+    if HF_HUB_DISABLE_PROGRESS_BARS is False:
+        warnings.warn(
+            "Cannot disable progress bars: environment variable `HF_HUB_DISABLE_PROGRESS_BARS=0` is set and has"
+            " priority."
+        )
+        return
+    global _hf_hub_progress_bars_disabled
+    _hf_hub_progress_bars_disabled = True
+
+
+def enable_progress_bars() -> None:
+    """
+    Enable globally progress bars used in `huggingface_hub` except if `HF_HUB_DISABLE_PROGRESS_BARS` environment
+    variable has been set.
+
+    Use [`~utils.disable_progress_bars`] to disable them.
+    """
+    if HF_HUB_DISABLE_PROGRESS_BARS is True:
+        warnings.warn(
+            "Cannot enable progress bars: environment variable `HF_HUB_DISABLE_PROGRESS_BARS=1` is set and has"
+            " priority."
+        )
+        return
+    global _hf_hub_progress_bars_disabled
+    _hf_hub_progress_bars_disabled = False
+
+
+def are_progress_bars_disabled() -> bool:
+    """Return whether progress bars are globally disabled or not.
+
+    Progress bars used in `huggingface_hub` can be enable or disabled globally using [`~utils.enable_progress_bars`]
+    and [`~utils.disable_progress_bars`] or by setting `HF_HUB_DISABLE_PROGRESS_BARS` as environment variable.
+    """
+    global _hf_hub_progress_bars_disabled
+    return _hf_hub_progress_bars_disabled
+
+
+class tqdm(old_tqdm):
+    """
+    Class to override `disable` argument in case progress bars are globally disabled.
+
+    Taken from https://github.com/tqdm/tqdm/issues/619#issuecomment-619639324.
+    """
+
+    def __init__(self, *args, **kwargs):
+        if are_progress_bars_disabled():
+            kwargs["disable"] = True
+        super().__init__(*args, **kwargs)
+
+    def __delattr__(self, attr: str) -> None:
+        """Fix for https://github.com/huggingface/huggingface_hub/issues/1603"""
+        try:
+            super().__delattr__(attr)
+        except AttributeError:
+            if attr != "_lock":
+                raise
+
+
+@contextmanager
+def tqdm_stream_file(path: Union[Path, str]) -> Iterator[io.BufferedReader]:
+    """
+    Open a file as binary and wrap the `read` method to display a progress bar when it's streamed.
+
+    First implemented in `transformers` in 2019 but removed when switched to git-lfs. Used in `huggingface_hub` to show
+    progress bar when uploading an LFS file to the Hub. See github.com/huggingface/transformers/pull/2078#discussion_r354739608
+    for implementation details.
+
+    Note: currently implementation handles only files stored on disk as it is the most common use case. Could be
+          extended to stream any `BinaryIO` object but we might have to debug some corner cases.
+
+    Example:
+    ```py
+    >>> with tqdm_stream_file("config.json") as f:
+    >>>     requests.put(url, data=f)
+    config.json: 100%|█████████████████████████| 8.19k/8.19k [00:02<00:00, 3.72kB/s]
+    ```
+    """
+    if isinstance(path, str):
+        path = Path(path)
+
+    with path.open("rb") as f:
+        total_size = path.stat().st_size
+        pbar = tqdm(
+            unit="B",
+            unit_scale=True,
+            total=total_size,
+            initial=0,
+            desc=path.name,
+        )
+
+        f_read = f.read
+
+        def _inner_read(size: Optional[int] = -1) -> bytes:
+            data = f_read(size)
+            pbar.update(len(data))
+            return data
+
+        f.read = _inner_read  # type: ignore
+
+        yield f
+
+        pbar.close()
diff --git a/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/INSTALLER b/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/LICENSE b/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..d24c351e1889b5b7837e4c9c1dc59334191c7f2c
--- /dev/null
+++ b/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Cory Benfield
+
+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
+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.
diff --git a/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/METADATA b/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..68a0218eff23b8163f60987632cbd5f3efd67e22
--- /dev/null
+++ b/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/METADATA
@@ -0,0 +1,73 @@
+Metadata-Version: 2.1
+Name: hyperframe
+Version: 6.0.1
+Summary: HTTP/2 framing layer for Python
+Home-page: https://github.com/python-hyper/hyperframe/
+Author: Cory Benfield
+Author-email: cory@lukasa.co.uk
+License: MIT License
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.6.1
+Description-Content-Type: text/x-rst
+
+======================================
+hyperframe: Pure-Python HTTP/2 framing
+======================================
+
+.. image:: https://github.com/python-hyper/hyperframe/workflows/CI/badge.svg
+    :target: https://github.com/python-hyper/hyperframe/actions
+    :alt: Build Status
+.. image:: https://codecov.io/gh/python-hyper/hyperframe/branch/master/graph/badge.svg
+    :target: https://codecov.io/gh/python-hyper/hyperframe
+    :alt: Code Coverage
+.. image:: https://readthedocs.org/projects/hyperframe/badge/?version=latest
+    :target: https://hyperframe.readthedocs.io/en/latest/
+    :alt: Documentation Status
+.. image:: https://img.shields.io/badge/chat-join_now-brightgreen.svg
+    :target: https://gitter.im/python-hyper/community
+    :alt: Chat community
+
+This library contains the HTTP/2 framing code used in the `hyper`_ project. It
+provides a pure-Python codebase that is capable of decoding a binary stream
+into HTTP/2 frames.
+
+This library is used directly by `hyper`_ and a number of other projects to
+provide HTTP/2 frame decoding logic.
+
+Contributing
+============
+
+hyperframe welcomes contributions from anyone! Unlike many other projects we
+are happy to accept cosmetic contributions and small contributions, in addition
+to large feature requests and changes.
+
+Before you contribute (either by opening an issue or filing a pull request),
+please `read the contribution guidelines`_.
+
+.. _read the contribution guidelines: http://hyper.readthedocs.org/en/development/contributing.html
+
+License
+=======
+
+hyperframe is made available under the MIT License. For more details, see the
+``LICENSE`` file in the repository.
+
+Authors
+=======
+
+hyperframe is maintained by Cory Benfield, with contributions from others. For
+more details about the contributors, please see ``CONTRIBUTORS.rst``.
+
+.. _hyper: http://python-hyper.org/
+
+
diff --git a/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/RECORD b/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..bcb642e50032df67f54cf45bbbb1fc7376fe922a
--- /dev/null
+++ b/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/RECORD
@@ -0,0 +1,15 @@
+hyperframe-6.0.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+hyperframe-6.0.1.dist-info/LICENSE,sha256=djqTQqBN9iBGydx0ilKHk06wpTMcaGOzygruIOGMtO0,1080
+hyperframe-6.0.1.dist-info/METADATA,sha256=XnsPRyOH2AV1DTg_TAcQjPgpDC1PY27R6ULErLxmuXI,2681
+hyperframe-6.0.1.dist-info/RECORD,,
+hyperframe-6.0.1.dist-info/WHEEL,sha256=OqRkF0eY5GHssMorFjlbTIq072vpHpF60fIQA6lS9xA,92
+hyperframe-6.0.1.dist-info/top_level.txt,sha256=aIXWNxzKF_jwE8lyWG5Paqn5RP7PDBYeguraia-oHJE,11
+hyperframe/__init__.py,sha256=PU-Ys-1uB09DyuTKVqwHCUOi4ssg1RV_yrCCqCzIraA,136
+hyperframe/__pycache__/__init__.cpython-311.pyc,,
+hyperframe/__pycache__/exceptions.cpython-311.pyc,,
+hyperframe/__pycache__/flags.cpython-311.pyc,,
+hyperframe/__pycache__/frame.cpython-311.pyc,,
+hyperframe/exceptions.py,sha256=HEcJVI7kLuTeugt-yGHGq-pzb4pFbDAnARToFiwKnTY,1607
+hyperframe/flags.py,sha256=28hP4RjxBL3I5Ks9-xF12zTf9G0Xh8Ja_iJLqDc7O44,1386
+hyperframe/frame.py,sha256=5C_73047zn0qMBelEakVcp9uvvXJIbLkCX7If_g9BIk,31981
+hyperframe/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
diff --git a/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/WHEEL b/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..385faab0525ccdbfd1070a8bebcca3ac8617236e
--- /dev/null
+++ b/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.36.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/top_level.txt b/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..b21bb7c4d81d810d4cf96c8d59f2b0f6a54e6eab
--- /dev/null
+++ b/llm/Lib/site-packages/hyperframe-6.0.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+hyperframe
diff --git a/llm/Lib/site-packages/hyperframe/__init__.py b/llm/Lib/site-packages/hyperframe/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf5ba1cb222218f982e02d20dbe862e7a485bca1
--- /dev/null
+++ b/llm/Lib/site-packages/hyperframe/__init__.py
@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+"""
+hyperframe
+~~~~~~~~~~
+
+A module for providing a pure-Python HTTP/2 framing layer.
+"""
+__version__ = '6.0.1'
diff --git a/llm/Lib/site-packages/hyperframe/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/hyperframe/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1f05d0e28c81d4851e86ea1901167565ac0b3145
Binary files /dev/null and b/llm/Lib/site-packages/hyperframe/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/hyperframe/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/hyperframe/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a8914bb46a6b41b5acb5c333908b870ba813ca7f
Binary files /dev/null and b/llm/Lib/site-packages/hyperframe/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/hyperframe/__pycache__/flags.cpython-311.pyc b/llm/Lib/site-packages/hyperframe/__pycache__/flags.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bec33eb974a5a5bce0c401fec56e8861dda947fe
Binary files /dev/null and b/llm/Lib/site-packages/hyperframe/__pycache__/flags.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/hyperframe/__pycache__/frame.cpython-311.pyc b/llm/Lib/site-packages/hyperframe/__pycache__/frame.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bbb61823f83e19f38e0a2f5bf69b20e80e8a288c
Binary files /dev/null and b/llm/Lib/site-packages/hyperframe/__pycache__/frame.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/hyperframe/exceptions.py b/llm/Lib/site-packages/hyperframe/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..d6adab25c8f79ffb177131243338d702741eec4f
--- /dev/null
+++ b/llm/Lib/site-packages/hyperframe/exceptions.py
@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*-
+"""
+hyperframe/exceptions
+~~~~~~~~~~~~~~~~~~~~~
+
+Defines the exceptions that can be thrown by hyperframe.
+"""
+
+
+class HyperframeError(Exception):
+    """
+    The base class for all exceptions for the hyperframe module.
+
+    .. versionadded:: 6.0.0
+    """
+
+
+class UnknownFrameError(HyperframeError):
+    """
+    A frame of unknown type was received.
+
+    .. versionchanged:: 6.0.0
+        Changed base class from `ValueError` to :class:`HyperframeError`
+    """
+    def __init__(self, frame_type: int, length: int) -> None:
+        #: The type byte of the unknown frame that was received.
+        self.frame_type = frame_type
+
+        #: The length of the data portion of the unknown frame.
+        self.length = length
+
+    def __str__(self) -> str:
+        return (
+            "UnknownFrameError: Unknown frame type 0x%X received, "
+            "length %d bytes" % (self.frame_type, self.length)
+        )
+
+
+class InvalidPaddingError(HyperframeError):
+    """
+    A frame with invalid padding was received.
+
+    .. versionchanged:: 6.0.0
+        Changed base class from `ValueError` to :class:`HyperframeError`
+    """
+    pass
+
+
+class InvalidFrameError(HyperframeError):
+    """
+    Parsing a frame failed because the data was not laid out appropriately.
+
+    .. versionadded:: 3.0.2
+
+    .. versionchanged:: 6.0.0
+        Changed base class from `ValueError` to :class:`HyperframeError`
+    """
+    pass
+
+
+class InvalidDataError(HyperframeError):
+    """
+    Content or data of a frame was is invalid or violates the specification.
+
+    .. versionadded:: 6.0.0
+    """
+    pass
diff --git a/llm/Lib/site-packages/hyperframe/flags.py b/llm/Lib/site-packages/hyperframe/flags.py
new file mode 100644
index 0000000000000000000000000000000000000000..f00cb997277733120394a9502944d3bb3b4a8bbc
--- /dev/null
+++ b/llm/Lib/site-packages/hyperframe/flags.py
@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*-
+"""
+hyperframe/flags
+~~~~~~~~~~~~~~~~
+
+Defines basic Flag and Flags data structures.
+"""
+from collections.abc import MutableSet
+from typing import NamedTuple, Iterable, Set, Iterator
+
+
+class Flag(NamedTuple):
+    name: str
+    bit: int
+
+
+class Flags(MutableSet):  # type: ignore
+    """
+    A simple MutableSet implementation that will only accept known flags as
+    elements.
+
+    Will behave like a regular set(), except that a ValueError will be thrown
+    when .add()ing unexpected flags.
+    """
+    def __init__(self, defined_flags: Iterable[Flag]):
+        self._valid_flags = set(flag.name for flag in defined_flags)
+        self._flags: Set[str] = set()
+
+    def __repr__(self) -> str:
+        return repr(sorted(list(self._flags)))
+
+    def __contains__(self, x: object) -> bool:
+        return self._flags.__contains__(x)
+
+    def __iter__(self) -> Iterator[str]:
+        return self._flags.__iter__()
+
+    def __len__(self) -> int:
+        return self._flags.__len__()
+
+    def discard(self, value: str) -> None:
+        return self._flags.discard(value)
+
+    def add(self, value: str) -> None:
+        if value not in self._valid_flags:
+            raise ValueError(
+                "Unexpected flag: {}. Valid flags are: {}".format(
+                    value, self._valid_flags
+                )
+            )
+        return self._flags.add(value)
diff --git a/llm/Lib/site-packages/hyperframe/frame.py b/llm/Lib/site-packages/hyperframe/frame.py
new file mode 100644
index 0000000000000000000000000000000000000000..f4e75e35e3aa9368a4f483e517114f1e1700bfc3
--- /dev/null
+++ b/llm/Lib/site-packages/hyperframe/frame.py
@@ -0,0 +1,969 @@
+# -*- coding: utf-8 -*-
+"""
+hyperframe/frame
+~~~~~~~~~~~~~~~~
+
+Defines framing logic for HTTP/2. Provides both classes to represent framed
+data and logic for aiding the connection when it comes to reading from the
+socket.
+"""
+import struct
+import binascii
+
+from .exceptions import (
+    UnknownFrameError, InvalidPaddingError, InvalidFrameError, InvalidDataError
+)
+from .flags import Flag, Flags
+from typing import Optional, Tuple, List, Iterable, Any, Dict, Type
+
+
+# The maximum initial length of a frame. Some frames have shorter maximum
+# lengths.
+FRAME_MAX_LEN = (2 ** 14)
+
+# The maximum allowed length of a frame.
+FRAME_MAX_ALLOWED_LEN = (2 ** 24) - 1
+
+# Stream association enumerations.
+_STREAM_ASSOC_HAS_STREAM = "has-stream"
+_STREAM_ASSOC_NO_STREAM = "no-stream"
+_STREAM_ASSOC_EITHER = "either"
+
+# Structs for packing and unpacking
+_STRUCT_HBBBL = struct.Struct(">HBBBL")
+_STRUCT_LL = struct.Struct(">LL")
+_STRUCT_HL = struct.Struct(">HL")
+_STRUCT_LB = struct.Struct(">LB")
+_STRUCT_L = struct.Struct(">L")
+_STRUCT_H = struct.Struct(">H")
+_STRUCT_B = struct.Struct(">B")
+
+
+class Frame:
+    """
+    The base class for all HTTP/2 frames.
+    """
+    #: The flags defined on this type of frame.
+    defined_flags: List[Flag] = []
+
+    #: The byte used to define the type of the frame.
+    type: Optional[int] = None
+
+    # If 'has-stream', the frame's stream_id must be non-zero. If 'no-stream',
+    # it must be zero. If 'either', it's not checked.
+    stream_association: Optional[str] = None
+
+    def __init__(self, stream_id: int, flags: Iterable[str] = ()) -> None:
+        #: The stream identifier for the stream this frame was received on.
+        #: Set to 0 for frames sent on the connection (stream-id 0).
+        self.stream_id = stream_id
+
+        #: The flags set for this frame.
+        self.flags = Flags(self.defined_flags)
+
+        #: The frame length, excluding the nine-byte header.
+        self.body_len = 0
+
+        for flag in flags:
+            self.flags.add(flag)
+
+        if (not self.stream_id and
+           self.stream_association == _STREAM_ASSOC_HAS_STREAM):
+            raise InvalidDataError(
+                'Stream ID must be non-zero for {}'.format(
+                    type(self).__name__,
+                )
+            )
+        if (self.stream_id and
+           self.stream_association == _STREAM_ASSOC_NO_STREAM):
+            raise InvalidDataError(
+                'Stream ID must be zero for {} with stream_id={}'.format(
+                    type(self).__name__,
+                    self.stream_id,
+                )
+            )
+
+    def __repr__(self) -> str:
+        return (
+            "{}(stream_id={}, flags={}): {}"
+        ).format(
+            type(self).__name__,
+            self.stream_id,
+            repr(self.flags),
+            self._body_repr(),
+        )
+
+    def _body_repr(self) -> str:
+        # More specific implementation may be provided by subclasses of Frame.
+        # This fallback shows the serialized (and truncated) body content.
+        return _raw_data_repr(self.serialize_body())
+
+    @staticmethod
+    def explain(data: memoryview) -> Tuple["Frame", int]:
+        """
+        Takes a bytestring and tries to parse a single frame and print it.
+
+        This function is only provided for debugging purposes.
+
+        :param data: A memoryview object containing the raw data of at least
+                     one complete frame (header and body).
+
+        .. versionadded:: 6.0.0
+        """
+        frame, length = Frame.parse_frame_header(data[:9])
+        frame.parse_body(data[9:9 + length])
+        print(frame)
+        return frame, length
+
+    @staticmethod
+    def parse_frame_header(header: memoryview, strict: bool = False) -> Tuple["Frame", int]:
+        """
+        Takes a 9-byte frame header and returns a tuple of the appropriate
+        Frame object and the length that needs to be read from the socket.
+
+        This populates the flags field, and determines how long the body is.
+
+        :param header: A memoryview object containing the 9-byte frame header
+                       data of a frame. Must not contain more or less.
+
+        :param strict: Whether to raise an exception when encountering a frame
+            not defined by spec and implemented by hyperframe.
+
+        :raises hyperframe.exceptions.UnknownFrameError: If a frame of unknown
+            type is received.
+
+        .. versionchanged:: 5.0.0
+            Added :param:`strict` to accommodate :class:`ExtensionFrame`
+        """
+        try:
+            fields = _STRUCT_HBBBL.unpack(header)
+        except struct.error:
+            raise InvalidFrameError("Invalid frame header")
+
+        # First 24 bits are frame length.
+        length = (fields[0] << 8) + fields[1]
+        type = fields[2]
+        flags = fields[3]
+        stream_id = fields[4] & 0x7FFFFFFF
+
+        try:
+            frame = FRAMES[type](stream_id)
+        except KeyError:
+            if strict:
+                raise UnknownFrameError(type, length)
+            frame = ExtensionFrame(type=type, stream_id=stream_id)
+
+        frame.parse_flags(flags)
+        return (frame, length)
+
+    def parse_flags(self, flag_byte: int) -> Flags:
+        for flag, flag_bit in self.defined_flags:
+            if flag_byte & flag_bit:
+                self.flags.add(flag)
+
+        return self.flags
+
+    def serialize(self) -> bytes:
+        """
+        Convert a frame into a bytestring, representing the serialized form of
+        the frame.
+        """
+        body = self.serialize_body()
+        self.body_len = len(body)
+
+        # Build the common frame header.
+        # First, get the flags.
+        flags = 0
+
+        for flag, flag_bit in self.defined_flags:
+            if flag in self.flags:
+                flags |= flag_bit
+
+        header = _STRUCT_HBBBL.pack(
+            (self.body_len >> 8) & 0xFFFF,  # Length spread over top 24 bits
+            self.body_len & 0xFF,
+            self.type,
+            flags,
+            self.stream_id & 0x7FFFFFFF  # Stream ID is 32 bits.
+        )
+
+        return header + body
+
+    def serialize_body(self) -> bytes:
+        raise NotImplementedError()
+
+    def parse_body(self, data: memoryview) -> None:
+        """
+        Given the body of a frame, parses it into frame data. This populates
+        the non-header parts of the frame: that is, it does not populate the
+        stream ID or flags.
+
+        :param data: A memoryview object containing the body data of the frame.
+                     Must not contain *more* data than the length returned by
+                     :meth:`parse_frame_header
+                     <hyperframe.frame.Frame.parse_frame_header>`.
+        """
+        raise NotImplementedError()
+
+
+class Padding:
+    """
+    Mixin for frames that contain padding. Defines extra fields that can be
+    used and set by frames that can be padded.
+    """
+    def __init__(self, stream_id: int, pad_length: int = 0, **kwargs: Any) -> None:
+        super().__init__(stream_id, **kwargs)  # type: ignore
+
+        #: The length of the padding to use.
+        self.pad_length = pad_length
+
+    def serialize_padding_data(self) -> bytes:
+        if 'PADDED' in self.flags:  # type: ignore
+            return _STRUCT_B.pack(self.pad_length)
+        return b''
+
+    def parse_padding_data(self, data: memoryview) -> int:
+        if 'PADDED' in self.flags:  # type: ignore
+            try:
+                self.pad_length = struct.unpack('!B', data[:1])[0]
+            except struct.error:
+                raise InvalidFrameError("Invalid Padding data")
+            return 1
+        return 0
+
+    #: .. deprecated:: 5.2.1
+    #:    Use self.pad_length instead.
+    @property
+    def total_padding(self) -> int:  # pragma: no cover
+        import warnings
+        warnings.warn(
+            "total_padding contains the same information as pad_length.",
+            DeprecationWarning
+        )
+        return self.pad_length
+
+
+class Priority:
+    """
+    Mixin for frames that contain priority data. Defines extra fields that can
+    be used and set by frames that contain priority data.
+    """
+    def __init__(self,
+                 stream_id: int,
+                 depends_on: int = 0x0,
+                 stream_weight: int = 0x0,
+                 exclusive: bool = False,
+                 **kwargs: Any) -> None:
+        super().__init__(stream_id, **kwargs)  # type: ignore
+
+        #: The stream ID of the stream on which this stream depends.
+        self.depends_on = depends_on
+
+        #: The weight of the stream. This is an integer between 0 and 256.
+        self.stream_weight = stream_weight
+
+        #: Whether the exclusive bit was set.
+        self.exclusive = exclusive
+
+    def serialize_priority_data(self) -> bytes:
+        return _STRUCT_LB.pack(
+            self.depends_on + (0x80000000 if self.exclusive else 0),
+            self.stream_weight
+        )
+
+    def parse_priority_data(self, data: memoryview) -> int:
+        try:
+            self.depends_on, self.stream_weight = _STRUCT_LB.unpack(data[:5])
+        except struct.error:
+            raise InvalidFrameError("Invalid Priority data")
+
+        self.exclusive = True if self.depends_on >> 31 else False
+        self.depends_on &= 0x7FFFFFFF
+        return 5
+
+
+class DataFrame(Padding, Frame):
+    """
+    DATA frames convey arbitrary, variable-length sequences of octets
+    associated with a stream. One or more DATA frames are used, for instance,
+    to carry HTTP request or response payloads.
+    """
+    #: The flags defined for DATA frames.
+    defined_flags = [
+        Flag('END_STREAM', 0x01),
+        Flag('PADDED', 0x08),
+    ]
+
+    #: The type byte for data frames.
+    type = 0x0
+
+    stream_association = _STREAM_ASSOC_HAS_STREAM
+
+    def __init__(self, stream_id: int, data: bytes = b'', **kwargs: Any) -> None:
+        super().__init__(stream_id, **kwargs)
+
+        #: The data contained on this frame.
+        self.data = data
+
+    def serialize_body(self) -> bytes:
+        padding_data = self.serialize_padding_data()
+        padding = b'\0' * self.pad_length
+        if isinstance(self.data, memoryview):
+            self.data = self.data.tobytes()
+        return b''.join([padding_data, self.data, padding])
+
+    def parse_body(self, data: memoryview) -> None:
+        padding_data_length = self.parse_padding_data(data)
+        self.data = (
+            data[padding_data_length:len(data)-self.pad_length].tobytes()
+        )
+        self.body_len = len(data)
+
+        if self.pad_length and self.pad_length >= self.body_len:
+            raise InvalidPaddingError("Padding is too long.")
+
+    @property
+    def flow_controlled_length(self) -> int:
+        """
+        The length of the frame that needs to be accounted for when considering
+        flow control.
+        """
+        padding_len = 0
+        if 'PADDED' in self.flags:
+            # Account for extra 1-byte padding length field, which is still
+            # present if possibly zero-valued.
+            padding_len = self.pad_length + 1
+        return len(self.data) + padding_len
+
+
+class PriorityFrame(Priority, Frame):
+    """
+    The PRIORITY frame specifies the sender-advised priority of a stream. It
+    can be sent at any time for an existing stream. This enables
+    reprioritisation of existing streams.
+    """
+    #: The flags defined for PRIORITY frames.
+    defined_flags: List[Flag] = []
+
+    #: The type byte defined for PRIORITY frames.
+    type = 0x02
+
+    stream_association = _STREAM_ASSOC_HAS_STREAM
+
+    def _body_repr(self) -> str:
+        return "exclusive={}, depends_on={}, stream_weight={}".format(
+            self.exclusive,
+            self.depends_on,
+            self.stream_weight
+        )
+
+    def serialize_body(self) -> bytes:
+        return self.serialize_priority_data()
+
+    def parse_body(self, data: memoryview) -> None:
+        if len(data) > 5:
+            raise InvalidFrameError(
+                "PRIORITY must have 5 byte body: actual length %s." %
+                len(data)
+            )
+
+        self.parse_priority_data(data)
+        self.body_len = 5
+
+
+class RstStreamFrame(Frame):
+    """
+    The RST_STREAM frame allows for abnormal termination of a stream. When sent
+    by the initiator of a stream, it indicates that they wish to cancel the
+    stream or that an error condition has occurred. When sent by the receiver
+    of a stream, it indicates that either the receiver is rejecting the stream,
+    requesting that the stream be cancelled or that an error condition has
+    occurred.
+    """
+    #: The flags defined for RST_STREAM frames.
+    defined_flags: List[Flag] = []
+
+    #: The type byte defined for RST_STREAM frames.
+    type = 0x03
+
+    stream_association = _STREAM_ASSOC_HAS_STREAM
+
+    def __init__(self, stream_id: int, error_code: int = 0, **kwargs: Any) -> None:
+        super().__init__(stream_id, **kwargs)
+
+        #: The error code used when resetting the stream.
+        self.error_code = error_code
+
+    def _body_repr(self) -> str:
+        return "error_code={}".format(
+            self.error_code,
+        )
+
+    def serialize_body(self) -> bytes:
+        return _STRUCT_L.pack(self.error_code)
+
+    def parse_body(self, data: memoryview) -> None:
+        if len(data) != 4:
+            raise InvalidFrameError(
+                "RST_STREAM must have 4 byte body: actual length %s." %
+                len(data)
+            )
+
+        try:
+            self.error_code = _STRUCT_L.unpack(data)[0]
+        except struct.error:  # pragma: no cover
+            raise InvalidFrameError("Invalid RST_STREAM body")
+
+        self.body_len = 4
+
+
+class SettingsFrame(Frame):
+    """
+    The SETTINGS frame conveys configuration parameters that affect how
+    endpoints communicate. The parameters are either constraints on peer
+    behavior or preferences.
+
+    Settings are not negotiated. Settings describe characteristics of the
+    sending peer, which are used by the receiving peer. Different values for
+    the same setting can be advertised by each peer. For example, a client
+    might set a high initial flow control window, whereas a server might set a
+    lower value to conserve resources.
+    """
+    #: The flags defined for SETTINGS frames.
+    defined_flags = [Flag('ACK', 0x01)]
+
+    #: The type byte defined for SETTINGS frames.
+    type = 0x04
+
+    stream_association = _STREAM_ASSOC_NO_STREAM
+
+    # We need to define the known settings, they may as well be class
+    # attributes.
+    #: The byte that signals the SETTINGS_HEADER_TABLE_SIZE setting.
+    HEADER_TABLE_SIZE = 0x01
+    #: The byte that signals the SETTINGS_ENABLE_PUSH setting.
+    ENABLE_PUSH = 0x02
+    #: The byte that signals the SETTINGS_MAX_CONCURRENT_STREAMS setting.
+    MAX_CONCURRENT_STREAMS = 0x03
+    #: The byte that signals the SETTINGS_INITIAL_WINDOW_SIZE setting.
+    INITIAL_WINDOW_SIZE = 0x04
+    #: The byte that signals the SETTINGS_MAX_FRAME_SIZE setting.
+    MAX_FRAME_SIZE = 0x05
+    #: The byte that signals the SETTINGS_MAX_HEADER_LIST_SIZE setting.
+    MAX_HEADER_LIST_SIZE = 0x06
+    #: The byte that signals SETTINGS_ENABLE_CONNECT_PROTOCOL setting.
+    ENABLE_CONNECT_PROTOCOL = 0x08
+
+    def __init__(self, stream_id: int = 0, settings: Optional[Dict[int, int]] = None, **kwargs: Any) -> None:
+        super().__init__(stream_id, **kwargs)
+
+        if settings and "ACK" in kwargs.get("flags", ()):
+            raise InvalidDataError(
+                "Settings must be empty if ACK flag is set."
+            )
+
+        #: A dictionary of the setting type byte to the value of the setting.
+        self.settings = settings or {}
+
+    def _body_repr(self) -> str:
+        return "settings={}".format(
+            self.settings,
+        )
+
+    def serialize_body(self) -> bytes:
+        return b''.join([_STRUCT_HL.pack(setting & 0xFF, value)
+                         for setting, value in self.settings.items()])
+
+    def parse_body(self, data: memoryview) -> None:
+        if 'ACK' in self.flags and len(data) > 0:
+            raise InvalidDataError(
+                "SETTINGS ack frame must not have payload: got %s bytes" %
+                len(data)
+            )
+
+        body_len = 0
+        for i in range(0, len(data), 6):
+            try:
+                name, value = _STRUCT_HL.unpack(data[i:i+6])
+            except struct.error:
+                raise InvalidFrameError("Invalid SETTINGS body")
+
+            self.settings[name] = value
+            body_len += 6
+
+        self.body_len = body_len
+
+
+class PushPromiseFrame(Padding, Frame):
+    """
+    The PUSH_PROMISE frame is used to notify the peer endpoint in advance of
+    streams the sender intends to initiate.
+    """
+    #: The flags defined for PUSH_PROMISE frames.
+    defined_flags = [
+        Flag('END_HEADERS', 0x04),
+        Flag('PADDED', 0x08)
+    ]
+
+    #: The type byte defined for PUSH_PROMISE frames.
+    type = 0x05
+
+    stream_association = _STREAM_ASSOC_HAS_STREAM
+
+    def __init__(self, stream_id: int, promised_stream_id: int = 0, data: bytes = b'', **kwargs: Any) -> None:
+        super().__init__(stream_id, **kwargs)
+
+        #: The stream ID that is promised by this frame.
+        self.promised_stream_id = promised_stream_id
+
+        #: The HPACK-encoded header block for the simulated request on the new
+        #: stream.
+        self.data = data
+
+    def _body_repr(self) -> str:
+        return "promised_stream_id={}, data={}".format(
+            self.promised_stream_id,
+            _raw_data_repr(self.data),
+        )
+
+    def serialize_body(self) -> bytes:
+        padding_data = self.serialize_padding_data()
+        padding = b'\0' * self.pad_length
+        data = _STRUCT_L.pack(self.promised_stream_id)
+        return b''.join([padding_data, data, self.data, padding])
+
+    def parse_body(self, data: memoryview) -> None:
+        padding_data_length = self.parse_padding_data(data)
+
+        try:
+            self.promised_stream_id = _STRUCT_L.unpack(
+                data[padding_data_length:padding_data_length + 4]
+            )[0]
+        except struct.error:
+            raise InvalidFrameError("Invalid PUSH_PROMISE body")
+
+        self.data = (
+            data[padding_data_length + 4:len(data)-self.pad_length].tobytes()
+        )
+        self.body_len = len(data)
+
+        if self.promised_stream_id == 0 or self.promised_stream_id % 2 != 0:
+            raise InvalidDataError(
+                "Invalid PUSH_PROMISE promised stream id: %s" %
+                self.promised_stream_id
+            )
+
+        if self.pad_length and self.pad_length >= self.body_len:
+            raise InvalidPaddingError("Padding is too long.")
+
+
+class PingFrame(Frame):
+    """
+    The PING frame is a mechanism for measuring a minimal round-trip time from
+    the sender, as well as determining whether an idle connection is still
+    functional. PING frames can be sent from any endpoint.
+    """
+    #: The flags defined for PING frames.
+    defined_flags = [Flag('ACK', 0x01)]
+
+    #: The type byte defined for PING frames.
+    type = 0x06
+
+    stream_association = _STREAM_ASSOC_NO_STREAM
+
+    def __init__(self, stream_id: int = 0, opaque_data: bytes = b'', **kwargs: Any) -> None:
+        super().__init__(stream_id, **kwargs)
+
+        #: The opaque data sent in this PING frame, as a bytestring.
+        self.opaque_data = opaque_data
+
+    def _body_repr(self) -> str:
+        return "opaque_data={!r}".format(
+            self.opaque_data,
+        )
+
+    def serialize_body(self) -> bytes:
+        if len(self.opaque_data) > 8:
+            raise InvalidFrameError(
+                "PING frame may not have more than 8 bytes of data, got %r" %
+                self.opaque_data
+            )
+
+        data = self.opaque_data
+        data += b'\x00' * (8 - len(self.opaque_data))
+        return data
+
+    def parse_body(self, data: memoryview) -> None:
+        if len(data) != 8:
+            raise InvalidFrameError(
+                "PING frame must have 8 byte length: got %s" % len(data)
+            )
+
+        self.opaque_data = data.tobytes()
+        self.body_len = 8
+
+
+class GoAwayFrame(Frame):
+    """
+    The GOAWAY frame informs the remote peer to stop creating streams on this
+    connection. It can be sent from the client or the server. Once sent, the
+    sender will ignore frames sent on new streams for the remainder of the
+    connection.
+    """
+    #: The flags defined for GOAWAY frames.
+    defined_flags: List[Flag] = []
+
+    #: The type byte defined for GOAWAY frames.
+    type = 0x07
+
+    stream_association = _STREAM_ASSOC_NO_STREAM
+
+    def __init__(self,
+                 stream_id: int = 0,
+                 last_stream_id: int = 0,
+                 error_code: int = 0,
+                 additional_data: bytes = b'',
+                 **kwargs: Any) -> None:
+        super().__init__(stream_id, **kwargs)
+
+        #: The last stream ID definitely seen by the remote peer.
+        self.last_stream_id = last_stream_id
+
+        #: The error code for connection teardown.
+        self.error_code = error_code
+
+        #: Any additional data sent in the GOAWAY.
+        self.additional_data = additional_data
+
+    def _body_repr(self) -> str:
+        return "last_stream_id={}, error_code={}, additional_data={!r}".format(
+            self.last_stream_id,
+            self.error_code,
+            self.additional_data,
+        )
+
+    def serialize_body(self) -> bytes:
+        data = _STRUCT_LL.pack(
+            self.last_stream_id & 0x7FFFFFFF,
+            self.error_code
+        )
+        data += self.additional_data
+
+        return data
+
+    def parse_body(self, data: memoryview) -> None:
+        try:
+            self.last_stream_id, self.error_code = _STRUCT_LL.unpack(
+                data[:8]
+            )
+        except struct.error:
+            raise InvalidFrameError("Invalid GOAWAY body.")
+
+        self.body_len = len(data)
+
+        if len(data) > 8:
+            self.additional_data = data[8:].tobytes()
+
+
+class WindowUpdateFrame(Frame):
+    """
+    The WINDOW_UPDATE frame is used to implement flow control.
+
+    Flow control operates at two levels: on each individual stream and on the
+    entire connection.
+
+    Both types of flow control are hop by hop; that is, only between the two
+    endpoints. Intermediaries do not forward WINDOW_UPDATE frames between
+    dependent connections. However, throttling of data transfer by any receiver
+    can indirectly cause the propagation of flow control information toward the
+    original sender.
+    """
+    #: The flags defined for WINDOW_UPDATE frames.
+    defined_flags: List[Flag] = []
+
+    #: The type byte defined for WINDOW_UPDATE frames.
+    type = 0x08
+
+    stream_association = _STREAM_ASSOC_EITHER
+
+    def __init__(self, stream_id: int, window_increment: int = 0, **kwargs: Any) -> None:
+        super().__init__(stream_id, **kwargs)
+
+        #: The amount the flow control window is to be incremented.
+        self.window_increment = window_increment
+
+    def _body_repr(self) -> str:
+        return "window_increment={}".format(
+            self.window_increment,
+        )
+
+    def serialize_body(self) -> bytes:
+        return _STRUCT_L.pack(self.window_increment & 0x7FFFFFFF)
+
+    def parse_body(self, data: memoryview) -> None:
+        if len(data) > 4:
+            raise InvalidFrameError(
+                "WINDOW_UPDATE frame must have 4 byte length: got %s" %
+                len(data)
+            )
+
+        try:
+            self.window_increment = _STRUCT_L.unpack(data)[0]
+        except struct.error:
+            raise InvalidFrameError("Invalid WINDOW_UPDATE body")
+
+        if not 1 <= self.window_increment <= 2**31-1:
+            raise InvalidDataError(
+                "WINDOW_UPDATE increment must be between 1 to 2^31-1"
+            )
+
+        self.body_len = 4
+
+
+class HeadersFrame(Padding, Priority, Frame):
+    """
+    The HEADERS frame carries name-value pairs. It is used to open a stream.
+    HEADERS frames can be sent on a stream in the "open" or "half closed
+    (remote)" states.
+
+    The HeadersFrame class is actually basically a data frame in this
+    implementation, because of the requirement to control the sizes of frames.
+    A header block fragment that doesn't fit in an entire HEADERS frame needs
+    to be followed with CONTINUATION frames. From the perspective of the frame
+    building code the header block is an opaque data segment.
+    """
+    #: The flags defined for HEADERS frames.
+    defined_flags = [
+        Flag('END_STREAM', 0x01),
+        Flag('END_HEADERS', 0x04),
+        Flag('PADDED', 0x08),
+        Flag('PRIORITY', 0x20),
+    ]
+
+    #: The type byte defined for HEADERS frames.
+    type = 0x01
+
+    stream_association = _STREAM_ASSOC_HAS_STREAM
+
+    def __init__(self, stream_id: int, data: bytes = b'', **kwargs: Any) -> None:
+        super().__init__(stream_id, **kwargs)
+
+        #: The HPACK-encoded header block.
+        self.data = data
+
+    def _body_repr(self) -> str:
+        return "exclusive={}, depends_on={}, stream_weight={}, data={}".format(
+            self.exclusive,
+            self.depends_on,
+            self.stream_weight,
+            _raw_data_repr(self.data),
+        )
+
+    def serialize_body(self) -> bytes:
+        padding_data = self.serialize_padding_data()
+        padding = b'\0' * self.pad_length
+
+        if 'PRIORITY' in self.flags:
+            priority_data = self.serialize_priority_data()
+        else:
+            priority_data = b''
+
+        return b''.join([padding_data, priority_data, self.data, padding])
+
+    def parse_body(self, data: memoryview) -> None:
+        padding_data_length = self.parse_padding_data(data)
+        data = data[padding_data_length:]
+
+        if 'PRIORITY' in self.flags:
+            priority_data_length = self.parse_priority_data(data)
+        else:
+            priority_data_length = 0
+
+        self.body_len = len(data)
+        self.data = (
+            data[priority_data_length:len(data)-self.pad_length].tobytes()
+        )
+
+        if self.pad_length and self.pad_length >= self.body_len:
+            raise InvalidPaddingError("Padding is too long.")
+
+
+class ContinuationFrame(Frame):
+    """
+    The CONTINUATION frame is used to continue a sequence of header block
+    fragments. Any number of CONTINUATION frames can be sent on an existing
+    stream, as long as the preceding frame on the same stream is one of
+    HEADERS, PUSH_PROMISE or CONTINUATION without the END_HEADERS flag set.
+
+    Much like the HEADERS frame, hyper treats this as an opaque data frame with
+    different flags and a different type.
+    """
+    #: The flags defined for CONTINUATION frames.
+    defined_flags = [Flag('END_HEADERS', 0x04)]
+
+    #: The type byte defined for CONTINUATION frames.
+    type = 0x09
+
+    stream_association = _STREAM_ASSOC_HAS_STREAM
+
+    def __init__(self, stream_id: int, data: bytes = b'', **kwargs: Any) -> None:
+        super().__init__(stream_id, **kwargs)
+
+        #: The HPACK-encoded header block.
+        self.data = data
+
+    def _body_repr(self) -> str:
+        return "data={}".format(
+            _raw_data_repr(self.data),
+        )
+
+    def serialize_body(self) -> bytes:
+        return self.data
+
+    def parse_body(self, data: memoryview) -> None:
+        self.data = data.tobytes()
+        self.body_len = len(data)
+
+
+class AltSvcFrame(Frame):
+    """
+    The ALTSVC frame is used to advertise alternate services that the current
+    host, or a different one, can understand. This frame is standardised as
+    part of RFC 7838.
+
+    This frame does no work to validate that the ALTSVC field parameter is
+    acceptable per the rules of RFC 7838.
+
+    .. note:: If the ``stream_id`` of this frame is nonzero, the origin field
+              must have zero length. Conversely, if the ``stream_id`` of this
+              frame is zero, the origin field must have nonzero length. Put
+              another way, a valid ALTSVC frame has ``stream_id != 0`` XOR
+              ``len(origin) != 0``.
+    """
+    type = 0xA
+
+    stream_association = _STREAM_ASSOC_EITHER
+
+    def __init__(self, stream_id: int, origin: bytes = b'', field: bytes = b'', **kwargs: Any) -> None:
+        super().__init__(stream_id, **kwargs)
+
+        if not isinstance(origin, bytes):
+            raise InvalidDataError("AltSvc origin must be bytestring.")
+        if not isinstance(field, bytes):
+            raise InvalidDataError("AltSvc field must be a bytestring.")
+        self.origin = origin
+        self.field = field
+
+    def _body_repr(self) -> str:
+        return "origin={!r}, field={!r}".format(
+            self.origin,
+            self.field,
+        )
+
+    def serialize_body(self) -> bytes:
+        origin_len = _STRUCT_H.pack(len(self.origin))
+        return b''.join([origin_len, self.origin, self.field])
+
+    def parse_body(self, data: memoryview) -> None:
+        try:
+            origin_len = _STRUCT_H.unpack(data[0:2])[0]
+            self.origin = data[2:2+origin_len].tobytes()
+
+            if len(self.origin) != origin_len:
+                raise InvalidFrameError("Invalid ALTSVC frame body.")
+
+            self.field = data[2+origin_len:].tobytes()
+        except (struct.error, ValueError):
+            raise InvalidFrameError("Invalid ALTSVC frame body.")
+
+        self.body_len = len(data)
+
+
+class ExtensionFrame(Frame):
+    """
+    ExtensionFrame is used to wrap frames which are not natively interpretable
+    by hyperframe.
+
+    Although certain byte prefixes are ordained by specification to have
+    certain contextual meanings, frames with other prefixes are not prohibited,
+    and may be used to communicate arbitrary meaning between HTTP/2 peers.
+
+    Thus, hyperframe, rather than raising an exception when such a frame is
+    encountered, wraps it in a generic frame to be properly acted upon by
+    upstream consumers which might have additional context on how to use it.
+
+    .. versionadded:: 5.0.0
+    """
+
+    stream_association = _STREAM_ASSOC_EITHER
+
+    def __init__(self, type: int, stream_id: int, flag_byte: int = 0x0, body: bytes = b'', **kwargs: Any) -> None:
+        super().__init__(stream_id, **kwargs)
+        self.type = type
+        self.flag_byte = flag_byte
+        self.body = body
+
+    def _body_repr(self) -> str:
+        return "type={}, flag_byte={}, body={}".format(
+            self.type,
+            self.flag_byte,
+            _raw_data_repr(self.body),
+        )
+
+    def parse_flags(self, flag_byte: int) -> None:  # type: ignore
+        """
+        For extension frames, we parse the flags by just storing a flag byte.
+        """
+        self.flag_byte = flag_byte
+
+    def parse_body(self, data: memoryview) -> None:
+        self.body = data.tobytes()
+        self.body_len = len(data)
+
+    def serialize(self) -> bytes:
+        """
+        A broad override of the serialize method that ensures that the data
+        comes back out exactly as it came in. This should not be used in most
+        user code: it exists only as a helper method if frames need to be
+        reconstituted.
+        """
+        # Build the frame header.
+        # First, get the flags.
+        flags = self.flag_byte
+
+        header = _STRUCT_HBBBL.pack(
+            (self.body_len >> 8) & 0xFFFF,  # Length spread over top 24 bits
+            self.body_len & 0xFF,
+            self.type,
+            flags,
+            self.stream_id & 0x7FFFFFFF  # Stream ID is 32 bits.
+        )
+
+        return header + self.body
+
+
+def _raw_data_repr(data: Optional[bytes]) -> str:
+    if not data:
+        return "None"
+    r = binascii.hexlify(data).decode('ascii')
+    if len(r) > 20:
+        r = r[:20] + "..."
+    return "<hex:" + r + ">"
+
+
+_FRAME_CLASSES: List[Type[Frame]] = [
+    DataFrame,
+    HeadersFrame,
+    PriorityFrame,
+    RstStreamFrame,
+    SettingsFrame,
+    PushPromiseFrame,
+    PingFrame,
+    GoAwayFrame,
+    WindowUpdateFrame,
+    ContinuationFrame,
+    AltSvcFrame,
+]
+#: FRAMES maps the type byte for each frame to the class used to represent that
+#: frame.
+FRAMES = {cls.type: cls for cls in _FRAME_CLASSES}
diff --git a/llm/Lib/site-packages/hyperframe/py.typed b/llm/Lib/site-packages/hyperframe/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/idna-3.7.dist-info/INSTALLER b/llm/Lib/site-packages/idna-3.7.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/idna-3.7.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/idna-3.7.dist-info/LICENSE.md b/llm/Lib/site-packages/idna-3.7.dist-info/LICENSE.md
new file mode 100644
index 0000000000000000000000000000000000000000..19b6b45242c16a1025465309eec2ca5009319de3
--- /dev/null
+++ b/llm/Lib/site-packages/idna-3.7.dist-info/LICENSE.md
@@ -0,0 +1,31 @@
+BSD 3-Clause License
+
+Copyright (c) 2013-2024, Kim Davies and contributors.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/llm/Lib/site-packages/idna-3.7.dist-info/METADATA b/llm/Lib/site-packages/idna-3.7.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..b28f6ecdd5b297640bc7edac00381de90447b34b
--- /dev/null
+++ b/llm/Lib/site-packages/idna-3.7.dist-info/METADATA
@@ -0,0 +1,243 @@
+Metadata-Version: 2.1
+Name: idna
+Version: 3.7
+Summary: Internationalized Domain Names in Applications (IDNA)
+Author-email: Kim Davies <kim+pypi@gumleaf.org>
+Requires-Python: >=3.5
+Description-Content-Type: text/x-rst
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Internet :: Name Service (DNS)
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Project-URL: Changelog, https://github.com/kjd/idna/blob/master/HISTORY.rst
+Project-URL: Issue tracker, https://github.com/kjd/idna/issues
+Project-URL: Source, https://github.com/kjd/idna
+
+Internationalized Domain Names in Applications (IDNA)
+=====================================================
+
+Support for the Internationalized Domain Names in
+Applications (IDNA) protocol as specified in `RFC 5891
+<https://tools.ietf.org/html/rfc5891>`_. This is the latest version of
+the protocol and is sometimes referred to as “IDNA 2008”.
+
+This library also provides support for Unicode Technical
+Standard 46, `Unicode IDNA Compatibility Processing
+<https://unicode.org/reports/tr46/>`_.
+
+This acts as a suitable replacement for the “encodings.idna”
+module that comes with the Python standard library, but which
+only supports the older superseded IDNA specification (`RFC 3490
+<https://tools.ietf.org/html/rfc3490>`_).
+
+Basic functions are simply executed:
+
+.. code-block:: pycon
+
+    >>> import idna
+    >>> idna.encode('ドメイン.テスト')
+    b'xn--eckwd4c7c.xn--zckzah'
+    >>> print(idna.decode('xn--eckwd4c7c.xn--zckzah'))
+    ドメイン.テスト
+
+
+Installation
+------------
+
+This package is available for installation from PyPI:
+
+.. code-block:: bash
+
+    $ python3 -m pip install idna
+
+
+Usage
+-----
+
+For typical usage, the ``encode`` and ``decode`` functions will take a
+domain name argument and perform a conversion to A-labels or U-labels
+respectively.
+
+.. code-block:: pycon
+
+    >>> import idna
+    >>> idna.encode('ドメイン.テスト')
+    b'xn--eckwd4c7c.xn--zckzah'
+    >>> print(idna.decode('xn--eckwd4c7c.xn--zckzah'))
+    ドメイン.テスト
+
+You may use the codec encoding and decoding methods using the
+``idna.codec`` module:
+
+.. code-block:: pycon
+
+    >>> import idna.codec
+    >>> print('домен.испытание'.encode('idna2008'))
+    b'xn--d1acufc.xn--80akhbyknj4f'
+    >>> print(b'xn--d1acufc.xn--80akhbyknj4f'.decode('idna2008'))
+    домен.испытание
+
+Conversions can be applied at a per-label basis using the ``ulabel`` or
+``alabel`` functions if necessary:
+
+.. code-block:: pycon
+
+    >>> idna.alabel('测试')
+    b'xn--0zwm56d'
+
+Compatibility Mapping (UTS #46)
++++++++++++++++++++++++++++++++
+
+As described in `RFC 5895 <https://tools.ietf.org/html/rfc5895>`_, the
+IDNA specification does not normalize input from different potential
+ways a user may input a domain name. This functionality, known as
+a “mapping”, is considered by the specification to be a local
+user-interface issue distinct from IDNA conversion functionality.
+
+This library provides one such mapping that was developed by the
+Unicode Consortium. Known as `Unicode IDNA Compatibility Processing
+<https://unicode.org/reports/tr46/>`_, it provides for both a regular
+mapping for typical applications, as well as a transitional mapping to
+help migrate from older IDNA 2003 applications.
+
+For example, “Königsgäßchen” is not a permissible label as *LATIN
+CAPITAL LETTER K* is not allowed (nor are capital letters in general).
+UTS 46 will convert this into lower case prior to applying the IDNA
+conversion.
+
+.. code-block:: pycon
+
+    >>> import idna
+    >>> idna.encode('Königsgäßchen')
+    ...
+    idna.core.InvalidCodepoint: Codepoint U+004B at position 1 of 'Königsgäßchen' not allowed
+    >>> idna.encode('Königsgäßchen', uts46=True)
+    b'xn--knigsgchen-b4a3dun'
+    >>> print(idna.decode('xn--knigsgchen-b4a3dun'))
+    königsgäßchen
+
+Transitional processing provides conversions to help transition from
+the older 2003 standard to the current standard. For example, in the
+original IDNA specification, the *LATIN SMALL LETTER SHARP S* (ß) was
+converted into two *LATIN SMALL LETTER S* (ss), whereas in the current
+IDNA specification this conversion is not performed.
+
+.. code-block:: pycon
+
+    >>> idna.encode('Königsgäßchen', uts46=True, transitional=True)
+    'xn--knigsgsschen-lcb0w'
+
+Implementers should use transitional processing with caution, only in
+rare cases where conversion from legacy labels to current labels must be
+performed (i.e. IDNA implementations that pre-date 2008). For typical
+applications that just need to convert labels, transitional processing
+is unlikely to be beneficial and could produce unexpected incompatible
+results.
+
+``encodings.idna`` Compatibility
+++++++++++++++++++++++++++++++++
+
+Function calls from the Python built-in ``encodings.idna`` module are
+mapped to their IDNA 2008 equivalents using the ``idna.compat`` module.
+Simply substitute the ``import`` clause in your code to refer to the new
+module name.
+
+Exceptions
+----------
+
+All errors raised during the conversion following the specification
+should raise an exception derived from the ``idna.IDNAError`` base
+class.
+
+More specific exceptions that may be generated as ``idna.IDNABidiError``
+when the error reflects an illegal combination of left-to-right and
+right-to-left characters in a label; ``idna.InvalidCodepoint`` when
+a specific codepoint is an illegal character in an IDN label (i.e.
+INVALID); and ``idna.InvalidCodepointContext`` when the codepoint is
+illegal based on its positional context (i.e. it is CONTEXTO or CONTEXTJ
+but the contextual requirements are not satisfied.)
+
+Building and Diagnostics
+------------------------
+
+The IDNA and UTS 46 functionality relies upon pre-calculated lookup
+tables for performance. These tables are derived from computing against
+eligibility criteria in the respective standards. These tables are
+computed using the command-line script ``tools/idna-data``.
+
+This tool will fetch relevant codepoint data from the Unicode repository
+and perform the required calculations to identify eligibility. There are
+three main modes:
+
+* ``idna-data make-libdata``. Generates ``idnadata.py`` and
+  ``uts46data.py``, the pre-calculated lookup tables used for IDNA and
+  UTS 46 conversions. Implementers who wish to track this library against
+  a different Unicode version may use this tool to manually generate a
+  different version of the ``idnadata.py`` and ``uts46data.py`` files.
+
+* ``idna-data make-table``. Generate a table of the IDNA disposition
+  (e.g. PVALID, CONTEXTJ, CONTEXTO) in the format found in Appendix
+  B.1 of RFC 5892 and the pre-computed tables published by `IANA
+  <https://www.iana.org/>`_.
+
+* ``idna-data U+0061``. Prints debugging output on the various
+  properties associated with an individual Unicode codepoint (in this
+  case, U+0061), that are used to assess the IDNA and UTS 46 status of a
+  codepoint. This is helpful in debugging or analysis.
+
+The tool accepts a number of arguments, described using ``idna-data
+-h``. Most notably, the ``--version`` argument allows the specification
+of the version of Unicode to be used in computing the table data. For
+example, ``idna-data --version 9.0.0 make-libdata`` will generate
+library data against Unicode 9.0.0.
+
+
+Additional Notes
+----------------
+
+* **Packages**. The latest tagged release version is published in the
+  `Python Package Index <https://pypi.org/project/idna/>`_.
+
+* **Version support**. This library supports Python 3.5 and higher.
+  As this library serves as a low-level toolkit for a variety of
+  applications, many of which strive for broad compatibility with older
+  Python versions, there is no rush to remove older interpreter support.
+  Removing support for older versions should be well justified in that the
+  maintenance burden has become too high.
+
+* **Python 2**. Python 2 is supported by version 2.x of this library.
+  While active development of the version 2.x series has ended, notable
+  issues being corrected may be backported to 2.x. Use "idna<3" in your
+  requirements file if you need this library for a Python 2 application.
+
+* **Testing**. The library has a test suite based on each rule of the
+  IDNA specification, as well as tests that are provided as part of the
+  Unicode Technical Standard 46, `Unicode IDNA Compatibility Processing
+  <https://unicode.org/reports/tr46/>`_.
+
+* **Emoji**. It is an occasional request to support emoji domains in
+  this library. Encoding of symbols like emoji is expressly prohibited by
+  the technical standard IDNA 2008 and emoji domains are broadly phased
+  out across the domain industry due to associated security risks. For
+  now, applications that need to support these non-compliant labels
+  may wish to consider trying the encode/decode operation in this library
+  first, and then falling back to using `encodings.idna`. See `the Github
+  project <https://github.com/kjd/idna/issues/18>`_ for more discussion.
+
diff --git a/llm/Lib/site-packages/idna-3.7.dist-info/RECORD b/llm/Lib/site-packages/idna-3.7.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..bf84d391871877abb21c05d3860956aceae9df04
--- /dev/null
+++ b/llm/Lib/site-packages/idna-3.7.dist-info/RECORD
@@ -0,0 +1,22 @@
+idna-3.7.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+idna-3.7.dist-info/LICENSE.md,sha256=pZ8LDvNjWHQQmkRhykT_enDVBpboFHZ7-vch1Mmw2w8,1541
+idna-3.7.dist-info/METADATA,sha256=OixCk-dKLZkPy-MfviOmiPvwJ1O2K_8rqCrFjC_uxy4,9888
+idna-3.7.dist-info/RECORD,,
+idna-3.7.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+idna/__init__.py,sha256=KJQN1eQBr8iIK5SKrJ47lXvxG0BJ7Lm38W4zT0v_8lk,849
+idna/__pycache__/__init__.cpython-311.pyc,,
+idna/__pycache__/codec.cpython-311.pyc,,
+idna/__pycache__/compat.cpython-311.pyc,,
+idna/__pycache__/core.cpython-311.pyc,,
+idna/__pycache__/idnadata.cpython-311.pyc,,
+idna/__pycache__/intranges.cpython-311.pyc,,
+idna/__pycache__/package_data.cpython-311.pyc,,
+idna/__pycache__/uts46data.cpython-311.pyc,,
+idna/codec.py,sha256=PS6m-XmdST7Wj7J7ulRMakPDt5EBJyYrT3CPtjh-7t4,3426
+idna/compat.py,sha256=0_sOEUMT4CVw9doD3vyRhX80X19PwqFoUBs7gWsFME4,321
+idna/core.py,sha256=lyhpoe2vulEaB_65xhXmoKgO-xUqFDvcwxu5hpNNO4E,12663
+idna/idnadata.py,sha256=dqRwytzkjIHMBa2R1lYvHDwACenZPt8eGVu1Y8UBE-E,78320
+idna/intranges.py,sha256=YBr4fRYuWH7kTKS2tXlFjM24ZF1Pdvcir-aywniInqg,1881
+idna/package_data.py,sha256=Tkt0KnIeyIlnHddOaz9WSkkislNgokJAuE-p5GorMqo,21
+idna/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+idna/uts46data.py,sha256=1KuksWqLuccPXm2uyRVkhfiFLNIhM_H2m4azCcnOqEU,206503
diff --git a/llm/Lib/site-packages/idna-3.7.dist-info/WHEEL b/llm/Lib/site-packages/idna-3.7.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..3b5e64b5e6c4a210201d1676a891fd57b15cda99
--- /dev/null
+++ b/llm/Lib/site-packages/idna-3.7.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: flit 3.9.0
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/idna/__init__.py b/llm/Lib/site-packages/idna/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a40eeafcc914108ca79c5d83d6e81da1b29c6e80
--- /dev/null
+++ b/llm/Lib/site-packages/idna/__init__.py
@@ -0,0 +1,44 @@
+from .package_data import __version__
+from .core import (
+    IDNABidiError,
+    IDNAError,
+    InvalidCodepoint,
+    InvalidCodepointContext,
+    alabel,
+    check_bidi,
+    check_hyphen_ok,
+    check_initial_combiner,
+    check_label,
+    check_nfc,
+    decode,
+    encode,
+    ulabel,
+    uts46_remap,
+    valid_contextj,
+    valid_contexto,
+    valid_label_length,
+    valid_string_length,
+)
+from .intranges import intranges_contain
+
+__all__ = [
+    "IDNABidiError",
+    "IDNAError",
+    "InvalidCodepoint",
+    "InvalidCodepointContext",
+    "alabel",
+    "check_bidi",
+    "check_hyphen_ok",
+    "check_initial_combiner",
+    "check_label",
+    "check_nfc",
+    "decode",
+    "encode",
+    "intranges_contain",
+    "ulabel",
+    "uts46_remap",
+    "valid_contextj",
+    "valid_contexto",
+    "valid_label_length",
+    "valid_string_length",
+]
diff --git a/llm/Lib/site-packages/idna/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/idna/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3fafa585af0abd19e531a91e0f4432f3b3e13619
Binary files /dev/null and b/llm/Lib/site-packages/idna/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/idna/__pycache__/codec.cpython-311.pyc b/llm/Lib/site-packages/idna/__pycache__/codec.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ec2da16a3798922d9a82dc06e738318978bafeee
Binary files /dev/null and b/llm/Lib/site-packages/idna/__pycache__/codec.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/idna/__pycache__/compat.cpython-311.pyc b/llm/Lib/site-packages/idna/__pycache__/compat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f3212ba8b2f2caea0dd32ccf0a2f906431ee61b8
Binary files /dev/null and b/llm/Lib/site-packages/idna/__pycache__/compat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/idna/__pycache__/core.cpython-311.pyc b/llm/Lib/site-packages/idna/__pycache__/core.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6b8420f1e6dadfb88a6b5966f199b0743080dc3f
Binary files /dev/null and b/llm/Lib/site-packages/idna/__pycache__/core.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/idna/__pycache__/idnadata.cpython-311.pyc b/llm/Lib/site-packages/idna/__pycache__/idnadata.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..43cdf8fe4da1bec6283c61904215591d35dbd089
Binary files /dev/null and b/llm/Lib/site-packages/idna/__pycache__/idnadata.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/idna/__pycache__/intranges.cpython-311.pyc b/llm/Lib/site-packages/idna/__pycache__/intranges.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..694cc8bf2aaa548d995f351b7aa78ce5775abb6d
Binary files /dev/null and b/llm/Lib/site-packages/idna/__pycache__/intranges.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/idna/__pycache__/package_data.cpython-311.pyc b/llm/Lib/site-packages/idna/__pycache__/package_data.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ed168c8517615f1c23f7c30de77bf69bff841057
Binary files /dev/null and b/llm/Lib/site-packages/idna/__pycache__/package_data.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/idna/__pycache__/uts46data.cpython-311.pyc b/llm/Lib/site-packages/idna/__pycache__/uts46data.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..90a57ddbc156e7e14a2aaa232203fa36907cbb9a
Binary files /dev/null and b/llm/Lib/site-packages/idna/__pycache__/uts46data.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/idna/codec.py b/llm/Lib/site-packages/idna/codec.py
new file mode 100644
index 0000000000000000000000000000000000000000..c855a4de6d781815acf2334306f41b7a036c45d4
--- /dev/null
+++ b/llm/Lib/site-packages/idna/codec.py
@@ -0,0 +1,118 @@
+from .core import encode, decode, alabel, ulabel, IDNAError
+import codecs
+import re
+from typing import Any, Tuple, Optional
+
+_unicode_dots_re = re.compile('[\u002e\u3002\uff0e\uff61]')
+
+class Codec(codecs.Codec):
+
+    def encode(self, data: str, errors: str = 'strict') -> Tuple[bytes, int]:
+        if errors != 'strict':
+            raise IDNAError('Unsupported error handling \"{}\"'.format(errors))
+
+        if not data:
+            return b"", 0
+
+        return encode(data), len(data)
+
+    def decode(self, data: bytes, errors: str = 'strict') -> Tuple[str, int]:
+        if errors != 'strict':
+            raise IDNAError('Unsupported error handling \"{}\"'.format(errors))
+
+        if not data:
+            return '', 0
+
+        return decode(data), len(data)
+
+class IncrementalEncoder(codecs.BufferedIncrementalEncoder):
+    def _buffer_encode(self, data: str, errors: str, final: bool) -> Tuple[bytes, int]:
+        if errors != 'strict':
+            raise IDNAError('Unsupported error handling \"{}\"'.format(errors))
+
+        if not data:
+            return b'', 0
+
+        labels = _unicode_dots_re.split(data)
+        trailing_dot = b''
+        if labels:
+            if not labels[-1]:
+                trailing_dot = b'.'
+                del labels[-1]
+            elif not final:
+                # Keep potentially unfinished label until the next call
+                del labels[-1]
+                if labels:
+                    trailing_dot = b'.'
+
+        result = []
+        size = 0
+        for label in labels:
+            result.append(alabel(label))
+            if size:
+                size += 1
+            size += len(label)
+
+        # Join with U+002E
+        result_bytes = b'.'.join(result) + trailing_dot
+        size += len(trailing_dot)
+        return result_bytes, size
+
+class IncrementalDecoder(codecs.BufferedIncrementalDecoder):
+    def _buffer_decode(self, data: Any, errors: str, final: bool) -> Tuple[str, int]:
+        if errors != 'strict':
+            raise IDNAError('Unsupported error handling \"{}\"'.format(errors))
+
+        if not data:
+            return ('', 0)
+
+        if not isinstance(data, str):
+            data = str(data, 'ascii')
+
+        labels = _unicode_dots_re.split(data)
+        trailing_dot = ''
+        if labels:
+            if not labels[-1]:
+                trailing_dot = '.'
+                del labels[-1]
+            elif not final:
+                # Keep potentially unfinished label until the next call
+                del labels[-1]
+                if labels:
+                    trailing_dot = '.'
+
+        result = []
+        size = 0
+        for label in labels:
+            result.append(ulabel(label))
+            if size:
+                size += 1
+            size += len(label)
+
+        result_str = '.'.join(result) + trailing_dot
+        size += len(trailing_dot)
+        return (result_str, size)
+
+
+class StreamWriter(Codec, codecs.StreamWriter):
+    pass
+
+
+class StreamReader(Codec, codecs.StreamReader):
+    pass
+
+
+def search_function(name: str) -> Optional[codecs.CodecInfo]:
+    if name != 'idna2008':
+        return None
+    return codecs.CodecInfo(
+        name=name,
+        encode=Codec().encode,
+        decode=Codec().decode,
+        incrementalencoder=IncrementalEncoder,
+        incrementaldecoder=IncrementalDecoder,
+        streamwriter=StreamWriter,
+        streamreader=StreamReader,
+    )
+
+codecs.register(search_function)
diff --git a/llm/Lib/site-packages/idna/compat.py b/llm/Lib/site-packages/idna/compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..786e6bda63699b72d588ba91dd73df017570aee5
--- /dev/null
+++ b/llm/Lib/site-packages/idna/compat.py
@@ -0,0 +1,13 @@
+from .core import *
+from .codec import *
+from typing import Any, Union
+
+def ToASCII(label: str) -> bytes:
+    return encode(label)
+
+def ToUnicode(label: Union[bytes, bytearray]) -> str:
+    return decode(label)
+
+def nameprep(s: Any) -> None:
+    raise NotImplementedError('IDNA 2008 does not utilise nameprep protocol')
+
diff --git a/llm/Lib/site-packages/idna/core.py b/llm/Lib/site-packages/idna/core.py
new file mode 100644
index 0000000000000000000000000000000000000000..0dae61acdbccad9a08f1a82cf14839037873dc56
--- /dev/null
+++ b/llm/Lib/site-packages/idna/core.py
@@ -0,0 +1,395 @@
+from . import idnadata
+import bisect
+import unicodedata
+import re
+from typing import Union, Optional
+from .intranges import intranges_contain
+
+_virama_combining_class = 9
+_alabel_prefix = b'xn--'
+_unicode_dots_re = re.compile('[\u002e\u3002\uff0e\uff61]')
+
+class IDNAError(UnicodeError):
+    """ Base exception for all IDNA-encoding related problems """
+    pass
+
+
+class IDNABidiError(IDNAError):
+    """ Exception when bidirectional requirements are not satisfied """
+    pass
+
+
+class InvalidCodepoint(IDNAError):
+    """ Exception when a disallowed or unallocated codepoint is used """
+    pass
+
+
+class InvalidCodepointContext(IDNAError):
+    """ Exception when the codepoint is not valid in the context it is used """
+    pass
+
+
+def _combining_class(cp: int) -> int:
+    v = unicodedata.combining(chr(cp))
+    if v == 0:
+        if not unicodedata.name(chr(cp)):
+            raise ValueError('Unknown character in unicodedata')
+    return v
+
+def _is_script(cp: str, script: str) -> bool:
+    return intranges_contain(ord(cp), idnadata.scripts[script])
+
+def _punycode(s: str) -> bytes:
+    return s.encode('punycode')
+
+def _unot(s: int) -> str:
+    return 'U+{:04X}'.format(s)
+
+
+def valid_label_length(label: Union[bytes, str]) -> bool:
+    if len(label) > 63:
+        return False
+    return True
+
+
+def valid_string_length(label: Union[bytes, str], trailing_dot: bool) -> bool:
+    if len(label) > (254 if trailing_dot else 253):
+        return False
+    return True
+
+
+def check_bidi(label: str, check_ltr: bool = False) -> bool:
+    # Bidi rules should only be applied if string contains RTL characters
+    bidi_label = False
+    for (idx, cp) in enumerate(label, 1):
+        direction = unicodedata.bidirectional(cp)
+        if direction == '':
+            # String likely comes from a newer version of Unicode
+            raise IDNABidiError('Unknown directionality in label {} at position {}'.format(repr(label), idx))
+        if direction in ['R', 'AL', 'AN']:
+            bidi_label = True
+    if not bidi_label and not check_ltr:
+        return True
+
+    # Bidi rule 1
+    direction = unicodedata.bidirectional(label[0])
+    if direction in ['R', 'AL']:
+        rtl = True
+    elif direction == 'L':
+        rtl = False
+    else:
+        raise IDNABidiError('First codepoint in label {} must be directionality L, R or AL'.format(repr(label)))
+
+    valid_ending = False
+    number_type = None  # type: Optional[str]
+    for (idx, cp) in enumerate(label, 1):
+        direction = unicodedata.bidirectional(cp)
+
+        if rtl:
+            # Bidi rule 2
+            if not direction in ['R', 'AL', 'AN', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']:
+                raise IDNABidiError('Invalid direction for codepoint at position {} in a right-to-left label'.format(idx))
+            # Bidi rule 3
+            if direction in ['R', 'AL', 'EN', 'AN']:
+                valid_ending = True
+            elif direction != 'NSM':
+                valid_ending = False
+            # Bidi rule 4
+            if direction in ['AN', 'EN']:
+                if not number_type:
+                    number_type = direction
+                else:
+                    if number_type != direction:
+                        raise IDNABidiError('Can not mix numeral types in a right-to-left label')
+        else:
+            # Bidi rule 5
+            if not direction in ['L', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']:
+                raise IDNABidiError('Invalid direction for codepoint at position {} in a left-to-right label'.format(idx))
+            # Bidi rule 6
+            if direction in ['L', 'EN']:
+                valid_ending = True
+            elif direction != 'NSM':
+                valid_ending = False
+
+    if not valid_ending:
+        raise IDNABidiError('Label ends with illegal codepoint directionality')
+
+    return True
+
+
+def check_initial_combiner(label: str) -> bool:
+    if unicodedata.category(label[0])[0] == 'M':
+        raise IDNAError('Label begins with an illegal combining character')
+    return True
+
+
+def check_hyphen_ok(label: str) -> bool:
+    if label[2:4] == '--':
+        raise IDNAError('Label has disallowed hyphens in 3rd and 4th position')
+    if label[0] == '-' or label[-1] == '-':
+        raise IDNAError('Label must not start or end with a hyphen')
+    return True
+
+
+def check_nfc(label: str) -> None:
+    if unicodedata.normalize('NFC', label) != label:
+        raise IDNAError('Label must be in Normalization Form C')
+
+
+def valid_contextj(label: str, pos: int) -> bool:
+    cp_value = ord(label[pos])
+
+    if cp_value == 0x200c:
+
+        if pos > 0:
+            if _combining_class(ord(label[pos - 1])) == _virama_combining_class:
+                return True
+
+        ok = False
+        for i in range(pos-1, -1, -1):
+            joining_type = idnadata.joining_types.get(ord(label[i]))
+            if joining_type == ord('T'):
+                continue
+            elif joining_type in [ord('L'), ord('D')]:
+                ok = True
+                break
+            else:
+                break
+
+        if not ok:
+            return False
+
+        ok = False
+        for i in range(pos+1, len(label)):
+            joining_type = idnadata.joining_types.get(ord(label[i]))
+            if joining_type == ord('T'):
+                continue
+            elif joining_type in [ord('R'), ord('D')]:
+                ok = True
+                break
+            else:
+                break
+        return ok
+
+    if cp_value == 0x200d:
+
+        if pos > 0:
+            if _combining_class(ord(label[pos - 1])) == _virama_combining_class:
+                return True
+        return False
+
+    else:
+
+        return False
+
+
+def valid_contexto(label: str, pos: int, exception: bool = False) -> bool:
+    cp_value = ord(label[pos])
+
+    if cp_value == 0x00b7:
+        if 0 < pos < len(label)-1:
+            if ord(label[pos - 1]) == 0x006c and ord(label[pos + 1]) == 0x006c:
+                return True
+        return False
+
+    elif cp_value == 0x0375:
+        if pos < len(label)-1 and len(label) > 1:
+            return _is_script(label[pos + 1], 'Greek')
+        return False
+
+    elif cp_value == 0x05f3 or cp_value == 0x05f4:
+        if pos > 0:
+            return _is_script(label[pos - 1], 'Hebrew')
+        return False
+
+    elif cp_value == 0x30fb:
+        for cp in label:
+            if cp == '\u30fb':
+                continue
+            if _is_script(cp, 'Hiragana') or _is_script(cp, 'Katakana') or _is_script(cp, 'Han'):
+                return True
+        return False
+
+    elif 0x660 <= cp_value <= 0x669:
+        for cp in label:
+            if 0x6f0 <= ord(cp) <= 0x06f9:
+                return False
+        return True
+
+    elif 0x6f0 <= cp_value <= 0x6f9:
+        for cp in label:
+            if 0x660 <= ord(cp) <= 0x0669:
+                return False
+        return True
+
+    return False
+
+
+def check_label(label: Union[str, bytes, bytearray]) -> None:
+    if isinstance(label, (bytes, bytearray)):
+        label = label.decode('utf-8')
+    if len(label) == 0:
+        raise IDNAError('Empty Label')
+
+    check_nfc(label)
+    check_hyphen_ok(label)
+    check_initial_combiner(label)
+
+    for (pos, cp) in enumerate(label):
+        cp_value = ord(cp)
+        if intranges_contain(cp_value, idnadata.codepoint_classes['PVALID']):
+            continue
+        elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTJ']):
+            if not valid_contextj(label, pos):
+                raise InvalidCodepointContext('Joiner {} not allowed at position {} in {}'.format(
+                    _unot(cp_value), pos+1, repr(label)))
+        elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTO']):
+            if not valid_contexto(label, pos):
+                raise InvalidCodepointContext('Codepoint {} not allowed at position {} in {}'.format(_unot(cp_value), pos+1, repr(label)))
+        else:
+            raise InvalidCodepoint('Codepoint {} at position {} of {} not allowed'.format(_unot(cp_value), pos+1, repr(label)))
+
+    check_bidi(label)
+
+
+def alabel(label: str) -> bytes:
+    try:
+        label_bytes = label.encode('ascii')
+        ulabel(label_bytes)
+        if not valid_label_length(label_bytes):
+            raise IDNAError('Label too long')
+        return label_bytes
+    except UnicodeEncodeError:
+        pass
+
+    check_label(label)
+    label_bytes = _alabel_prefix + _punycode(label)
+
+    if not valid_label_length(label_bytes):
+        raise IDNAError('Label too long')
+
+    return label_bytes
+
+
+def ulabel(label: Union[str, bytes, bytearray]) -> str:
+    if not isinstance(label, (bytes, bytearray)):
+        try:
+            label_bytes = label.encode('ascii')
+        except UnicodeEncodeError:
+            check_label(label)
+            return label
+    else:
+        label_bytes = label
+
+    label_bytes = label_bytes.lower()
+    if label_bytes.startswith(_alabel_prefix):
+        label_bytes = label_bytes[len(_alabel_prefix):]
+        if not label_bytes:
+            raise IDNAError('Malformed A-label, no Punycode eligible content found')
+        if label_bytes.decode('ascii')[-1] == '-':
+            raise IDNAError('A-label must not end with a hyphen')
+    else:
+        check_label(label_bytes)
+        return label_bytes.decode('ascii')
+
+    try:
+        label = label_bytes.decode('punycode')
+    except UnicodeError:
+        raise IDNAError('Invalid A-label')
+    check_label(label)
+    return label
+
+
+def uts46_remap(domain: str, std3_rules: bool = True, transitional: bool = False) -> str:
+    """Re-map the characters in the string according to UTS46 processing."""
+    from .uts46data import uts46data
+    output = ''
+
+    for pos, char in enumerate(domain):
+        code_point = ord(char)
+        try:
+            uts46row = uts46data[code_point if code_point < 256 else
+                bisect.bisect_left(uts46data, (code_point, 'Z')) - 1]
+            status = uts46row[1]
+            replacement = None  # type: Optional[str]
+            if len(uts46row) == 3:
+                replacement = uts46row[2]
+            if (status == 'V' or
+                    (status == 'D' and not transitional) or
+                    (status == '3' and not std3_rules and replacement is None)):
+                output += char
+            elif replacement is not None and (status == 'M' or
+                    (status == '3' and not std3_rules) or
+                    (status == 'D' and transitional)):
+                output += replacement
+            elif status != 'I':
+                raise IndexError()
+        except IndexError:
+            raise InvalidCodepoint(
+                'Codepoint {} not allowed at position {} in {}'.format(
+                _unot(code_point), pos + 1, repr(domain)))
+
+    return unicodedata.normalize('NFC', output)
+
+
+def encode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool = False, std3_rules: bool = False, transitional: bool = False) -> bytes:
+    if not isinstance(s, str):
+        try:
+            s = str(s, 'ascii')
+        except UnicodeDecodeError:
+            raise IDNAError('should pass a unicode string to the function rather than a byte string.')
+    if uts46:
+        s = uts46_remap(s, std3_rules, transitional)
+    trailing_dot = False
+    result = []
+    if strict:
+        labels = s.split('.')
+    else:
+        labels = _unicode_dots_re.split(s)
+    if not labels or labels == ['']:
+        raise IDNAError('Empty domain')
+    if labels[-1] == '':
+        del labels[-1]
+        trailing_dot = True
+    for label in labels:
+        s = alabel(label)
+        if s:
+            result.append(s)
+        else:
+            raise IDNAError('Empty label')
+    if trailing_dot:
+        result.append(b'')
+    s = b'.'.join(result)
+    if not valid_string_length(s, trailing_dot):
+        raise IDNAError('Domain too long')
+    return s
+
+
+def decode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool = False, std3_rules: bool = False) -> str:
+    try:
+        if not isinstance(s, str):
+            s = str(s, 'ascii')
+    except UnicodeDecodeError:
+        raise IDNAError('Invalid ASCII in A-label')
+    if uts46:
+        s = uts46_remap(s, std3_rules, False)
+    trailing_dot = False
+    result = []
+    if not strict:
+        labels = _unicode_dots_re.split(s)
+    else:
+        labels = s.split('.')
+    if not labels or labels == ['']:
+        raise IDNAError('Empty domain')
+    if not labels[-1]:
+        del labels[-1]
+        trailing_dot = True
+    for label in labels:
+        s = ulabel(label)
+        if s:
+            result.append(s)
+        else:
+            raise IDNAError('Empty label')
+    if trailing_dot:
+        result.append('')
+    return '.'.join(result)
diff --git a/llm/Lib/site-packages/idna/idnadata.py b/llm/Lib/site-packages/idna/idnadata.py
new file mode 100644
index 0000000000000000000000000000000000000000..c61dcf977e57ec0d139e828a7c5a9cd86e55b43a
--- /dev/null
+++ b/llm/Lib/site-packages/idna/idnadata.py
@@ -0,0 +1,4245 @@
+# This file is automatically generated by tools/idna-data
+
+__version__ = '15.1.0'
+scripts = {
+    'Greek': (
+        0x37000000374,
+        0x37500000378,
+        0x37a0000037e,
+        0x37f00000380,
+        0x38400000385,
+        0x38600000387,
+        0x3880000038b,
+        0x38c0000038d,
+        0x38e000003a2,
+        0x3a3000003e2,
+        0x3f000000400,
+        0x1d2600001d2b,
+        0x1d5d00001d62,
+        0x1d6600001d6b,
+        0x1dbf00001dc0,
+        0x1f0000001f16,
+        0x1f1800001f1e,
+        0x1f2000001f46,
+        0x1f4800001f4e,
+        0x1f5000001f58,
+        0x1f5900001f5a,
+        0x1f5b00001f5c,
+        0x1f5d00001f5e,
+        0x1f5f00001f7e,
+        0x1f8000001fb5,
+        0x1fb600001fc5,
+        0x1fc600001fd4,
+        0x1fd600001fdc,
+        0x1fdd00001ff0,
+        0x1ff200001ff5,
+        0x1ff600001fff,
+        0x212600002127,
+        0xab650000ab66,
+        0x101400001018f,
+        0x101a0000101a1,
+        0x1d2000001d246,
+    ),
+    'Han': (
+        0x2e8000002e9a,
+        0x2e9b00002ef4,
+        0x2f0000002fd6,
+        0x300500003006,
+        0x300700003008,
+        0x30210000302a,
+        0x30380000303c,
+        0x340000004dc0,
+        0x4e000000a000,
+        0xf9000000fa6e,
+        0xfa700000fada,
+        0x16fe200016fe4,
+        0x16ff000016ff2,
+        0x200000002a6e0,
+        0x2a7000002b73a,
+        0x2b7400002b81e,
+        0x2b8200002cea2,
+        0x2ceb00002ebe1,
+        0x2ebf00002ee5e,
+        0x2f8000002fa1e,
+        0x300000003134b,
+        0x31350000323b0,
+    ),
+    'Hebrew': (
+        0x591000005c8,
+        0x5d0000005eb,
+        0x5ef000005f5,
+        0xfb1d0000fb37,
+        0xfb380000fb3d,
+        0xfb3e0000fb3f,
+        0xfb400000fb42,
+        0xfb430000fb45,
+        0xfb460000fb50,
+    ),
+    'Hiragana': (
+        0x304100003097,
+        0x309d000030a0,
+        0x1b0010001b120,
+        0x1b1320001b133,
+        0x1b1500001b153,
+        0x1f2000001f201,
+    ),
+    'Katakana': (
+        0x30a1000030fb,
+        0x30fd00003100,
+        0x31f000003200,
+        0x32d0000032ff,
+        0x330000003358,
+        0xff660000ff70,
+        0xff710000ff9e,
+        0x1aff00001aff4,
+        0x1aff50001affc,
+        0x1affd0001afff,
+        0x1b0000001b001,
+        0x1b1200001b123,
+        0x1b1550001b156,
+        0x1b1640001b168,
+    ),
+}
+joining_types = {
+    0xad: 84,
+    0x300: 84,
+    0x301: 84,
+    0x302: 84,
+    0x303: 84,
+    0x304: 84,
+    0x305: 84,
+    0x306: 84,
+    0x307: 84,
+    0x308: 84,
+    0x309: 84,
+    0x30a: 84,
+    0x30b: 84,
+    0x30c: 84,
+    0x30d: 84,
+    0x30e: 84,
+    0x30f: 84,
+    0x310: 84,
+    0x311: 84,
+    0x312: 84,
+    0x313: 84,
+    0x314: 84,
+    0x315: 84,
+    0x316: 84,
+    0x317: 84,
+    0x318: 84,
+    0x319: 84,
+    0x31a: 84,
+    0x31b: 84,
+    0x31c: 84,
+    0x31d: 84,
+    0x31e: 84,
+    0x31f: 84,
+    0x320: 84,
+    0x321: 84,
+    0x322: 84,
+    0x323: 84,
+    0x324: 84,
+    0x325: 84,
+    0x326: 84,
+    0x327: 84,
+    0x328: 84,
+    0x329: 84,
+    0x32a: 84,
+    0x32b: 84,
+    0x32c: 84,
+    0x32d: 84,
+    0x32e: 84,
+    0x32f: 84,
+    0x330: 84,
+    0x331: 84,
+    0x332: 84,
+    0x333: 84,
+    0x334: 84,
+    0x335: 84,
+    0x336: 84,
+    0x337: 84,
+    0x338: 84,
+    0x339: 84,
+    0x33a: 84,
+    0x33b: 84,
+    0x33c: 84,
+    0x33d: 84,
+    0x33e: 84,
+    0x33f: 84,
+    0x340: 84,
+    0x341: 84,
+    0x342: 84,
+    0x343: 84,
+    0x344: 84,
+    0x345: 84,
+    0x346: 84,
+    0x347: 84,
+    0x348: 84,
+    0x349: 84,
+    0x34a: 84,
+    0x34b: 84,
+    0x34c: 84,
+    0x34d: 84,
+    0x34e: 84,
+    0x34f: 84,
+    0x350: 84,
+    0x351: 84,
+    0x352: 84,
+    0x353: 84,
+    0x354: 84,
+    0x355: 84,
+    0x356: 84,
+    0x357: 84,
+    0x358: 84,
+    0x359: 84,
+    0x35a: 84,
+    0x35b: 84,
+    0x35c: 84,
+    0x35d: 84,
+    0x35e: 84,
+    0x35f: 84,
+    0x360: 84,
+    0x361: 84,
+    0x362: 84,
+    0x363: 84,
+    0x364: 84,
+    0x365: 84,
+    0x366: 84,
+    0x367: 84,
+    0x368: 84,
+    0x369: 84,
+    0x36a: 84,
+    0x36b: 84,
+    0x36c: 84,
+    0x36d: 84,
+    0x36e: 84,
+    0x36f: 84,
+    0x483: 84,
+    0x484: 84,
+    0x485: 84,
+    0x486: 84,
+    0x487: 84,
+    0x488: 84,
+    0x489: 84,
+    0x591: 84,
+    0x592: 84,
+    0x593: 84,
+    0x594: 84,
+    0x595: 84,
+    0x596: 84,
+    0x597: 84,
+    0x598: 84,
+    0x599: 84,
+    0x59a: 84,
+    0x59b: 84,
+    0x59c: 84,
+    0x59d: 84,
+    0x59e: 84,
+    0x59f: 84,
+    0x5a0: 84,
+    0x5a1: 84,
+    0x5a2: 84,
+    0x5a3: 84,
+    0x5a4: 84,
+    0x5a5: 84,
+    0x5a6: 84,
+    0x5a7: 84,
+    0x5a8: 84,
+    0x5a9: 84,
+    0x5aa: 84,
+    0x5ab: 84,
+    0x5ac: 84,
+    0x5ad: 84,
+    0x5ae: 84,
+    0x5af: 84,
+    0x5b0: 84,
+    0x5b1: 84,
+    0x5b2: 84,
+    0x5b3: 84,
+    0x5b4: 84,
+    0x5b5: 84,
+    0x5b6: 84,
+    0x5b7: 84,
+    0x5b8: 84,
+    0x5b9: 84,
+    0x5ba: 84,
+    0x5bb: 84,
+    0x5bc: 84,
+    0x5bd: 84,
+    0x5bf: 84,
+    0x5c1: 84,
+    0x5c2: 84,
+    0x5c4: 84,
+    0x5c5: 84,
+    0x5c7: 84,
+    0x610: 84,
+    0x611: 84,
+    0x612: 84,
+    0x613: 84,
+    0x614: 84,
+    0x615: 84,
+    0x616: 84,
+    0x617: 84,
+    0x618: 84,
+    0x619: 84,
+    0x61a: 84,
+    0x61c: 84,
+    0x620: 68,
+    0x622: 82,
+    0x623: 82,
+    0x624: 82,
+    0x625: 82,
+    0x626: 68,
+    0x627: 82,
+    0x628: 68,
+    0x629: 82,
+    0x62a: 68,
+    0x62b: 68,
+    0x62c: 68,
+    0x62d: 68,
+    0x62e: 68,
+    0x62f: 82,
+    0x630: 82,
+    0x631: 82,
+    0x632: 82,
+    0x633: 68,
+    0x634: 68,
+    0x635: 68,
+    0x636: 68,
+    0x637: 68,
+    0x638: 68,
+    0x639: 68,
+    0x63a: 68,
+    0x63b: 68,
+    0x63c: 68,
+    0x63d: 68,
+    0x63e: 68,
+    0x63f: 68,
+    0x640: 67,
+    0x641: 68,
+    0x642: 68,
+    0x643: 68,
+    0x644: 68,
+    0x645: 68,
+    0x646: 68,
+    0x647: 68,
+    0x648: 82,
+    0x649: 68,
+    0x64a: 68,
+    0x64b: 84,
+    0x64c: 84,
+    0x64d: 84,
+    0x64e: 84,
+    0x64f: 84,
+    0x650: 84,
+    0x651: 84,
+    0x652: 84,
+    0x653: 84,
+    0x654: 84,
+    0x655: 84,
+    0x656: 84,
+    0x657: 84,
+    0x658: 84,
+    0x659: 84,
+    0x65a: 84,
+    0x65b: 84,
+    0x65c: 84,
+    0x65d: 84,
+    0x65e: 84,
+    0x65f: 84,
+    0x66e: 68,
+    0x66f: 68,
+    0x670: 84,
+    0x671: 82,
+    0x672: 82,
+    0x673: 82,
+    0x675: 82,
+    0x676: 82,
+    0x677: 82,
+    0x678: 68,
+    0x679: 68,
+    0x67a: 68,
+    0x67b: 68,
+    0x67c: 68,
+    0x67d: 68,
+    0x67e: 68,
+    0x67f: 68,
+    0x680: 68,
+    0x681: 68,
+    0x682: 68,
+    0x683: 68,
+    0x684: 68,
+    0x685: 68,
+    0x686: 68,
+    0x687: 68,
+    0x688: 82,
+    0x689: 82,
+    0x68a: 82,
+    0x68b: 82,
+    0x68c: 82,
+    0x68d: 82,
+    0x68e: 82,
+    0x68f: 82,
+    0x690: 82,
+    0x691: 82,
+    0x692: 82,
+    0x693: 82,
+    0x694: 82,
+    0x695: 82,
+    0x696: 82,
+    0x697: 82,
+    0x698: 82,
+    0x699: 82,
+    0x69a: 68,
+    0x69b: 68,
+    0x69c: 68,
+    0x69d: 68,
+    0x69e: 68,
+    0x69f: 68,
+    0x6a0: 68,
+    0x6a1: 68,
+    0x6a2: 68,
+    0x6a3: 68,
+    0x6a4: 68,
+    0x6a5: 68,
+    0x6a6: 68,
+    0x6a7: 68,
+    0x6a8: 68,
+    0x6a9: 68,
+    0x6aa: 68,
+    0x6ab: 68,
+    0x6ac: 68,
+    0x6ad: 68,
+    0x6ae: 68,
+    0x6af: 68,
+    0x6b0: 68,
+    0x6b1: 68,
+    0x6b2: 68,
+    0x6b3: 68,
+    0x6b4: 68,
+    0x6b5: 68,
+    0x6b6: 68,
+    0x6b7: 68,
+    0x6b8: 68,
+    0x6b9: 68,
+    0x6ba: 68,
+    0x6bb: 68,
+    0x6bc: 68,
+    0x6bd: 68,
+    0x6be: 68,
+    0x6bf: 68,
+    0x6c0: 82,
+    0x6c1: 68,
+    0x6c2: 68,
+    0x6c3: 82,
+    0x6c4: 82,
+    0x6c5: 82,
+    0x6c6: 82,
+    0x6c7: 82,
+    0x6c8: 82,
+    0x6c9: 82,
+    0x6ca: 82,
+    0x6cb: 82,
+    0x6cc: 68,
+    0x6cd: 82,
+    0x6ce: 68,
+    0x6cf: 82,
+    0x6d0: 68,
+    0x6d1: 68,
+    0x6d2: 82,
+    0x6d3: 82,
+    0x6d5: 82,
+    0x6d6: 84,
+    0x6d7: 84,
+    0x6d8: 84,
+    0x6d9: 84,
+    0x6da: 84,
+    0x6db: 84,
+    0x6dc: 84,
+    0x6df: 84,
+    0x6e0: 84,
+    0x6e1: 84,
+    0x6e2: 84,
+    0x6e3: 84,
+    0x6e4: 84,
+    0x6e7: 84,
+    0x6e8: 84,
+    0x6ea: 84,
+    0x6eb: 84,
+    0x6ec: 84,
+    0x6ed: 84,
+    0x6ee: 82,
+    0x6ef: 82,
+    0x6fa: 68,
+    0x6fb: 68,
+    0x6fc: 68,
+    0x6ff: 68,
+    0x70f: 84,
+    0x710: 82,
+    0x711: 84,
+    0x712: 68,
+    0x713: 68,
+    0x714: 68,
+    0x715: 82,
+    0x716: 82,
+    0x717: 82,
+    0x718: 82,
+    0x719: 82,
+    0x71a: 68,
+    0x71b: 68,
+    0x71c: 68,
+    0x71d: 68,
+    0x71e: 82,
+    0x71f: 68,
+    0x720: 68,
+    0x721: 68,
+    0x722: 68,
+    0x723: 68,
+    0x724: 68,
+    0x725: 68,
+    0x726: 68,
+    0x727: 68,
+    0x728: 82,
+    0x729: 68,
+    0x72a: 82,
+    0x72b: 68,
+    0x72c: 82,
+    0x72d: 68,
+    0x72e: 68,
+    0x72f: 82,
+    0x730: 84,
+    0x731: 84,
+    0x732: 84,
+    0x733: 84,
+    0x734: 84,
+    0x735: 84,
+    0x736: 84,
+    0x737: 84,
+    0x738: 84,
+    0x739: 84,
+    0x73a: 84,
+    0x73b: 84,
+    0x73c: 84,
+    0x73d: 84,
+    0x73e: 84,
+    0x73f: 84,
+    0x740: 84,
+    0x741: 84,
+    0x742: 84,
+    0x743: 84,
+    0x744: 84,
+    0x745: 84,
+    0x746: 84,
+    0x747: 84,
+    0x748: 84,
+    0x749: 84,
+    0x74a: 84,
+    0x74d: 82,
+    0x74e: 68,
+    0x74f: 68,
+    0x750: 68,
+    0x751: 68,
+    0x752: 68,
+    0x753: 68,
+    0x754: 68,
+    0x755: 68,
+    0x756: 68,
+    0x757: 68,
+    0x758: 68,
+    0x759: 82,
+    0x75a: 82,
+    0x75b: 82,
+    0x75c: 68,
+    0x75d: 68,
+    0x75e: 68,
+    0x75f: 68,
+    0x760: 68,
+    0x761: 68,
+    0x762: 68,
+    0x763: 68,
+    0x764: 68,
+    0x765: 68,
+    0x766: 68,
+    0x767: 68,
+    0x768: 68,
+    0x769: 68,
+    0x76a: 68,
+    0x76b: 82,
+    0x76c: 82,
+    0x76d: 68,
+    0x76e: 68,
+    0x76f: 68,
+    0x770: 68,
+    0x771: 82,
+    0x772: 68,
+    0x773: 82,
+    0x774: 82,
+    0x775: 68,
+    0x776: 68,
+    0x777: 68,
+    0x778: 82,
+    0x779: 82,
+    0x77a: 68,
+    0x77b: 68,
+    0x77c: 68,
+    0x77d: 68,
+    0x77e: 68,
+    0x77f: 68,
+    0x7a6: 84,
+    0x7a7: 84,
+    0x7a8: 84,
+    0x7a9: 84,
+    0x7aa: 84,
+    0x7ab: 84,
+    0x7ac: 84,
+    0x7ad: 84,
+    0x7ae: 84,
+    0x7af: 84,
+    0x7b0: 84,
+    0x7ca: 68,
+    0x7cb: 68,
+    0x7cc: 68,
+    0x7cd: 68,
+    0x7ce: 68,
+    0x7cf: 68,
+    0x7d0: 68,
+    0x7d1: 68,
+    0x7d2: 68,
+    0x7d3: 68,
+    0x7d4: 68,
+    0x7d5: 68,
+    0x7d6: 68,
+    0x7d7: 68,
+    0x7d8: 68,
+    0x7d9: 68,
+    0x7da: 68,
+    0x7db: 68,
+    0x7dc: 68,
+    0x7dd: 68,
+    0x7de: 68,
+    0x7df: 68,
+    0x7e0: 68,
+    0x7e1: 68,
+    0x7e2: 68,
+    0x7e3: 68,
+    0x7e4: 68,
+    0x7e5: 68,
+    0x7e6: 68,
+    0x7e7: 68,
+    0x7e8: 68,
+    0x7e9: 68,
+    0x7ea: 68,
+    0x7eb: 84,
+    0x7ec: 84,
+    0x7ed: 84,
+    0x7ee: 84,
+    0x7ef: 84,
+    0x7f0: 84,
+    0x7f1: 84,
+    0x7f2: 84,
+    0x7f3: 84,
+    0x7fa: 67,
+    0x7fd: 84,
+    0x816: 84,
+    0x817: 84,
+    0x818: 84,
+    0x819: 84,
+    0x81b: 84,
+    0x81c: 84,
+    0x81d: 84,
+    0x81e: 84,
+    0x81f: 84,
+    0x820: 84,
+    0x821: 84,
+    0x822: 84,
+    0x823: 84,
+    0x825: 84,
+    0x826: 84,
+    0x827: 84,
+    0x829: 84,
+    0x82a: 84,
+    0x82b: 84,
+    0x82c: 84,
+    0x82d: 84,
+    0x840: 82,
+    0x841: 68,
+    0x842: 68,
+    0x843: 68,
+    0x844: 68,
+    0x845: 68,
+    0x846: 82,
+    0x847: 82,
+    0x848: 68,
+    0x849: 82,
+    0x84a: 68,
+    0x84b: 68,
+    0x84c: 68,
+    0x84d: 68,
+    0x84e: 68,
+    0x84f: 68,
+    0x850: 68,
+    0x851: 68,
+    0x852: 68,
+    0x853: 68,
+    0x854: 82,
+    0x855: 68,
+    0x856: 82,
+    0x857: 82,
+    0x858: 82,
+    0x859: 84,
+    0x85a: 84,
+    0x85b: 84,
+    0x860: 68,
+    0x862: 68,
+    0x863: 68,
+    0x864: 68,
+    0x865: 68,
+    0x867: 82,
+    0x868: 68,
+    0x869: 82,
+    0x86a: 82,
+    0x870: 82,
+    0x871: 82,
+    0x872: 82,
+    0x873: 82,
+    0x874: 82,
+    0x875: 82,
+    0x876: 82,
+    0x877: 82,
+    0x878: 82,
+    0x879: 82,
+    0x87a: 82,
+    0x87b: 82,
+    0x87c: 82,
+    0x87d: 82,
+    0x87e: 82,
+    0x87f: 82,
+    0x880: 82,
+    0x881: 82,
+    0x882: 82,
+    0x883: 67,
+    0x884: 67,
+    0x885: 67,
+    0x886: 68,
+    0x889: 68,
+    0x88a: 68,
+    0x88b: 68,
+    0x88c: 68,
+    0x88d: 68,
+    0x88e: 82,
+    0x898: 84,
+    0x899: 84,
+    0x89a: 84,
+    0x89b: 84,
+    0x89c: 84,
+    0x89d: 84,
+    0x89e: 84,
+    0x89f: 84,
+    0x8a0: 68,
+    0x8a1: 68,
+    0x8a2: 68,
+    0x8a3: 68,
+    0x8a4: 68,
+    0x8a5: 68,
+    0x8a6: 68,
+    0x8a7: 68,
+    0x8a8: 68,
+    0x8a9: 68,
+    0x8aa: 82,
+    0x8ab: 82,
+    0x8ac: 82,
+    0x8ae: 82,
+    0x8af: 68,
+    0x8b0: 68,
+    0x8b1: 82,
+    0x8b2: 82,
+    0x8b3: 68,
+    0x8b4: 68,
+    0x8b5: 68,
+    0x8b6: 68,
+    0x8b7: 68,
+    0x8b8: 68,
+    0x8b9: 82,
+    0x8ba: 68,
+    0x8bb: 68,
+    0x8bc: 68,
+    0x8bd: 68,
+    0x8be: 68,
+    0x8bf: 68,
+    0x8c0: 68,
+    0x8c1: 68,
+    0x8c2: 68,
+    0x8c3: 68,
+    0x8c4: 68,
+    0x8c5: 68,
+    0x8c6: 68,
+    0x8c7: 68,
+    0x8c8: 68,
+    0x8ca: 84,
+    0x8cb: 84,
+    0x8cc: 84,
+    0x8cd: 84,
+    0x8ce: 84,
+    0x8cf: 84,
+    0x8d0: 84,
+    0x8d1: 84,
+    0x8d2: 84,
+    0x8d3: 84,
+    0x8d4: 84,
+    0x8d5: 84,
+    0x8d6: 84,
+    0x8d7: 84,
+    0x8d8: 84,
+    0x8d9: 84,
+    0x8da: 84,
+    0x8db: 84,
+    0x8dc: 84,
+    0x8dd: 84,
+    0x8de: 84,
+    0x8df: 84,
+    0x8e0: 84,
+    0x8e1: 84,
+    0x8e3: 84,
+    0x8e4: 84,
+    0x8e5: 84,
+    0x8e6: 84,
+    0x8e7: 84,
+    0x8e8: 84,
+    0x8e9: 84,
+    0x8ea: 84,
+    0x8eb: 84,
+    0x8ec: 84,
+    0x8ed: 84,
+    0x8ee: 84,
+    0x8ef: 84,
+    0x8f0: 84,
+    0x8f1: 84,
+    0x8f2: 84,
+    0x8f3: 84,
+    0x8f4: 84,
+    0x8f5: 84,
+    0x8f6: 84,
+    0x8f7: 84,
+    0x8f8: 84,
+    0x8f9: 84,
+    0x8fa: 84,
+    0x8fb: 84,
+    0x8fc: 84,
+    0x8fd: 84,
+    0x8fe: 84,
+    0x8ff: 84,
+    0x900: 84,
+    0x901: 84,
+    0x902: 84,
+    0x93a: 84,
+    0x93c: 84,
+    0x941: 84,
+    0x942: 84,
+    0x943: 84,
+    0x944: 84,
+    0x945: 84,
+    0x946: 84,
+    0x947: 84,
+    0x948: 84,
+    0x94d: 84,
+    0x951: 84,
+    0x952: 84,
+    0x953: 84,
+    0x954: 84,
+    0x955: 84,
+    0x956: 84,
+    0x957: 84,
+    0x962: 84,
+    0x963: 84,
+    0x981: 84,
+    0x9bc: 84,
+    0x9c1: 84,
+    0x9c2: 84,
+    0x9c3: 84,
+    0x9c4: 84,
+    0x9cd: 84,
+    0x9e2: 84,
+    0x9e3: 84,
+    0x9fe: 84,
+    0xa01: 84,
+    0xa02: 84,
+    0xa3c: 84,
+    0xa41: 84,
+    0xa42: 84,
+    0xa47: 84,
+    0xa48: 84,
+    0xa4b: 84,
+    0xa4c: 84,
+    0xa4d: 84,
+    0xa51: 84,
+    0xa70: 84,
+    0xa71: 84,
+    0xa75: 84,
+    0xa81: 84,
+    0xa82: 84,
+    0xabc: 84,
+    0xac1: 84,
+    0xac2: 84,
+    0xac3: 84,
+    0xac4: 84,
+    0xac5: 84,
+    0xac7: 84,
+    0xac8: 84,
+    0xacd: 84,
+    0xae2: 84,
+    0xae3: 84,
+    0xafa: 84,
+    0xafb: 84,
+    0xafc: 84,
+    0xafd: 84,
+    0xafe: 84,
+    0xaff: 84,
+    0xb01: 84,
+    0xb3c: 84,
+    0xb3f: 84,
+    0xb41: 84,
+    0xb42: 84,
+    0xb43: 84,
+    0xb44: 84,
+    0xb4d: 84,
+    0xb55: 84,
+    0xb56: 84,
+    0xb62: 84,
+    0xb63: 84,
+    0xb82: 84,
+    0xbc0: 84,
+    0xbcd: 84,
+    0xc00: 84,
+    0xc04: 84,
+    0xc3c: 84,
+    0xc3e: 84,
+    0xc3f: 84,
+    0xc40: 84,
+    0xc46: 84,
+    0xc47: 84,
+    0xc48: 84,
+    0xc4a: 84,
+    0xc4b: 84,
+    0xc4c: 84,
+    0xc4d: 84,
+    0xc55: 84,
+    0xc56: 84,
+    0xc62: 84,
+    0xc63: 84,
+    0xc81: 84,
+    0xcbc: 84,
+    0xcbf: 84,
+    0xcc6: 84,
+    0xccc: 84,
+    0xccd: 84,
+    0xce2: 84,
+    0xce3: 84,
+    0xd00: 84,
+    0xd01: 84,
+    0xd3b: 84,
+    0xd3c: 84,
+    0xd41: 84,
+    0xd42: 84,
+    0xd43: 84,
+    0xd44: 84,
+    0xd4d: 84,
+    0xd62: 84,
+    0xd63: 84,
+    0xd81: 84,
+    0xdca: 84,
+    0xdd2: 84,
+    0xdd3: 84,
+    0xdd4: 84,
+    0xdd6: 84,
+    0xe31: 84,
+    0xe34: 84,
+    0xe35: 84,
+    0xe36: 84,
+    0xe37: 84,
+    0xe38: 84,
+    0xe39: 84,
+    0xe3a: 84,
+    0xe47: 84,
+    0xe48: 84,
+    0xe49: 84,
+    0xe4a: 84,
+    0xe4b: 84,
+    0xe4c: 84,
+    0xe4d: 84,
+    0xe4e: 84,
+    0xeb1: 84,
+    0xeb4: 84,
+    0xeb5: 84,
+    0xeb6: 84,
+    0xeb7: 84,
+    0xeb8: 84,
+    0xeb9: 84,
+    0xeba: 84,
+    0xebb: 84,
+    0xebc: 84,
+    0xec8: 84,
+    0xec9: 84,
+    0xeca: 84,
+    0xecb: 84,
+    0xecc: 84,
+    0xecd: 84,
+    0xece: 84,
+    0xf18: 84,
+    0xf19: 84,
+    0xf35: 84,
+    0xf37: 84,
+    0xf39: 84,
+    0xf71: 84,
+    0xf72: 84,
+    0xf73: 84,
+    0xf74: 84,
+    0xf75: 84,
+    0xf76: 84,
+    0xf77: 84,
+    0xf78: 84,
+    0xf79: 84,
+    0xf7a: 84,
+    0xf7b: 84,
+    0xf7c: 84,
+    0xf7d: 84,
+    0xf7e: 84,
+    0xf80: 84,
+    0xf81: 84,
+    0xf82: 84,
+    0xf83: 84,
+    0xf84: 84,
+    0xf86: 84,
+    0xf87: 84,
+    0xf8d: 84,
+    0xf8e: 84,
+    0xf8f: 84,
+    0xf90: 84,
+    0xf91: 84,
+    0xf92: 84,
+    0xf93: 84,
+    0xf94: 84,
+    0xf95: 84,
+    0xf96: 84,
+    0xf97: 84,
+    0xf99: 84,
+    0xf9a: 84,
+    0xf9b: 84,
+    0xf9c: 84,
+    0xf9d: 84,
+    0xf9e: 84,
+    0xf9f: 84,
+    0xfa0: 84,
+    0xfa1: 84,
+    0xfa2: 84,
+    0xfa3: 84,
+    0xfa4: 84,
+    0xfa5: 84,
+    0xfa6: 84,
+    0xfa7: 84,
+    0xfa8: 84,
+    0xfa9: 84,
+    0xfaa: 84,
+    0xfab: 84,
+    0xfac: 84,
+    0xfad: 84,
+    0xfae: 84,
+    0xfaf: 84,
+    0xfb0: 84,
+    0xfb1: 84,
+    0xfb2: 84,
+    0xfb3: 84,
+    0xfb4: 84,
+    0xfb5: 84,
+    0xfb6: 84,
+    0xfb7: 84,
+    0xfb8: 84,
+    0xfb9: 84,
+    0xfba: 84,
+    0xfbb: 84,
+    0xfbc: 84,
+    0xfc6: 84,
+    0x102d: 84,
+    0x102e: 84,
+    0x102f: 84,
+    0x1030: 84,
+    0x1032: 84,
+    0x1033: 84,
+    0x1034: 84,
+    0x1035: 84,
+    0x1036: 84,
+    0x1037: 84,
+    0x1039: 84,
+    0x103a: 84,
+    0x103d: 84,
+    0x103e: 84,
+    0x1058: 84,
+    0x1059: 84,
+    0x105e: 84,
+    0x105f: 84,
+    0x1060: 84,
+    0x1071: 84,
+    0x1072: 84,
+    0x1073: 84,
+    0x1074: 84,
+    0x1082: 84,
+    0x1085: 84,
+    0x1086: 84,
+    0x108d: 84,
+    0x109d: 84,
+    0x135d: 84,
+    0x135e: 84,
+    0x135f: 84,
+    0x1712: 84,
+    0x1713: 84,
+    0x1714: 84,
+    0x1732: 84,
+    0x1733: 84,
+    0x1752: 84,
+    0x1753: 84,
+    0x1772: 84,
+    0x1773: 84,
+    0x17b4: 84,
+    0x17b5: 84,
+    0x17b7: 84,
+    0x17b8: 84,
+    0x17b9: 84,
+    0x17ba: 84,
+    0x17bb: 84,
+    0x17bc: 84,
+    0x17bd: 84,
+    0x17c6: 84,
+    0x17c9: 84,
+    0x17ca: 84,
+    0x17cb: 84,
+    0x17cc: 84,
+    0x17cd: 84,
+    0x17ce: 84,
+    0x17cf: 84,
+    0x17d0: 84,
+    0x17d1: 84,
+    0x17d2: 84,
+    0x17d3: 84,
+    0x17dd: 84,
+    0x1807: 68,
+    0x180a: 67,
+    0x180b: 84,
+    0x180c: 84,
+    0x180d: 84,
+    0x180f: 84,
+    0x1820: 68,
+    0x1821: 68,
+    0x1822: 68,
+    0x1823: 68,
+    0x1824: 68,
+    0x1825: 68,
+    0x1826: 68,
+    0x1827: 68,
+    0x1828: 68,
+    0x1829: 68,
+    0x182a: 68,
+    0x182b: 68,
+    0x182c: 68,
+    0x182d: 68,
+    0x182e: 68,
+    0x182f: 68,
+    0x1830: 68,
+    0x1831: 68,
+    0x1832: 68,
+    0x1833: 68,
+    0x1834: 68,
+    0x1835: 68,
+    0x1836: 68,
+    0x1837: 68,
+    0x1838: 68,
+    0x1839: 68,
+    0x183a: 68,
+    0x183b: 68,
+    0x183c: 68,
+    0x183d: 68,
+    0x183e: 68,
+    0x183f: 68,
+    0x1840: 68,
+    0x1841: 68,
+    0x1842: 68,
+    0x1843: 68,
+    0x1844: 68,
+    0x1845: 68,
+    0x1846: 68,
+    0x1847: 68,
+    0x1848: 68,
+    0x1849: 68,
+    0x184a: 68,
+    0x184b: 68,
+    0x184c: 68,
+    0x184d: 68,
+    0x184e: 68,
+    0x184f: 68,
+    0x1850: 68,
+    0x1851: 68,
+    0x1852: 68,
+    0x1853: 68,
+    0x1854: 68,
+    0x1855: 68,
+    0x1856: 68,
+    0x1857: 68,
+    0x1858: 68,
+    0x1859: 68,
+    0x185a: 68,
+    0x185b: 68,
+    0x185c: 68,
+    0x185d: 68,
+    0x185e: 68,
+    0x185f: 68,
+    0x1860: 68,
+    0x1861: 68,
+    0x1862: 68,
+    0x1863: 68,
+    0x1864: 68,
+    0x1865: 68,
+    0x1866: 68,
+    0x1867: 68,
+    0x1868: 68,
+    0x1869: 68,
+    0x186a: 68,
+    0x186b: 68,
+    0x186c: 68,
+    0x186d: 68,
+    0x186e: 68,
+    0x186f: 68,
+    0x1870: 68,
+    0x1871: 68,
+    0x1872: 68,
+    0x1873: 68,
+    0x1874: 68,
+    0x1875: 68,
+    0x1876: 68,
+    0x1877: 68,
+    0x1878: 68,
+    0x1885: 84,
+    0x1886: 84,
+    0x1887: 68,
+    0x1888: 68,
+    0x1889: 68,
+    0x188a: 68,
+    0x188b: 68,
+    0x188c: 68,
+    0x188d: 68,
+    0x188e: 68,
+    0x188f: 68,
+    0x1890: 68,
+    0x1891: 68,
+    0x1892: 68,
+    0x1893: 68,
+    0x1894: 68,
+    0x1895: 68,
+    0x1896: 68,
+    0x1897: 68,
+    0x1898: 68,
+    0x1899: 68,
+    0x189a: 68,
+    0x189b: 68,
+    0x189c: 68,
+    0x189d: 68,
+    0x189e: 68,
+    0x189f: 68,
+    0x18a0: 68,
+    0x18a1: 68,
+    0x18a2: 68,
+    0x18a3: 68,
+    0x18a4: 68,
+    0x18a5: 68,
+    0x18a6: 68,
+    0x18a7: 68,
+    0x18a8: 68,
+    0x18a9: 84,
+    0x18aa: 68,
+    0x1920: 84,
+    0x1921: 84,
+    0x1922: 84,
+    0x1927: 84,
+    0x1928: 84,
+    0x1932: 84,
+    0x1939: 84,
+    0x193a: 84,
+    0x193b: 84,
+    0x1a17: 84,
+    0x1a18: 84,
+    0x1a1b: 84,
+    0x1a56: 84,
+    0x1a58: 84,
+    0x1a59: 84,
+    0x1a5a: 84,
+    0x1a5b: 84,
+    0x1a5c: 84,
+    0x1a5d: 84,
+    0x1a5e: 84,
+    0x1a60: 84,
+    0x1a62: 84,
+    0x1a65: 84,
+    0x1a66: 84,
+    0x1a67: 84,
+    0x1a68: 84,
+    0x1a69: 84,
+    0x1a6a: 84,
+    0x1a6b: 84,
+    0x1a6c: 84,
+    0x1a73: 84,
+    0x1a74: 84,
+    0x1a75: 84,
+    0x1a76: 84,
+    0x1a77: 84,
+    0x1a78: 84,
+    0x1a79: 84,
+    0x1a7a: 84,
+    0x1a7b: 84,
+    0x1a7c: 84,
+    0x1a7f: 84,
+    0x1ab0: 84,
+    0x1ab1: 84,
+    0x1ab2: 84,
+    0x1ab3: 84,
+    0x1ab4: 84,
+    0x1ab5: 84,
+    0x1ab6: 84,
+    0x1ab7: 84,
+    0x1ab8: 84,
+    0x1ab9: 84,
+    0x1aba: 84,
+    0x1abb: 84,
+    0x1abc: 84,
+    0x1abd: 84,
+    0x1abe: 84,
+    0x1abf: 84,
+    0x1ac0: 84,
+    0x1ac1: 84,
+    0x1ac2: 84,
+    0x1ac3: 84,
+    0x1ac4: 84,
+    0x1ac5: 84,
+    0x1ac6: 84,
+    0x1ac7: 84,
+    0x1ac8: 84,
+    0x1ac9: 84,
+    0x1aca: 84,
+    0x1acb: 84,
+    0x1acc: 84,
+    0x1acd: 84,
+    0x1ace: 84,
+    0x1b00: 84,
+    0x1b01: 84,
+    0x1b02: 84,
+    0x1b03: 84,
+    0x1b34: 84,
+    0x1b36: 84,
+    0x1b37: 84,
+    0x1b38: 84,
+    0x1b39: 84,
+    0x1b3a: 84,
+    0x1b3c: 84,
+    0x1b42: 84,
+    0x1b6b: 84,
+    0x1b6c: 84,
+    0x1b6d: 84,
+    0x1b6e: 84,
+    0x1b6f: 84,
+    0x1b70: 84,
+    0x1b71: 84,
+    0x1b72: 84,
+    0x1b73: 84,
+    0x1b80: 84,
+    0x1b81: 84,
+    0x1ba2: 84,
+    0x1ba3: 84,
+    0x1ba4: 84,
+    0x1ba5: 84,
+    0x1ba8: 84,
+    0x1ba9: 84,
+    0x1bab: 84,
+    0x1bac: 84,
+    0x1bad: 84,
+    0x1be6: 84,
+    0x1be8: 84,
+    0x1be9: 84,
+    0x1bed: 84,
+    0x1bef: 84,
+    0x1bf0: 84,
+    0x1bf1: 84,
+    0x1c2c: 84,
+    0x1c2d: 84,
+    0x1c2e: 84,
+    0x1c2f: 84,
+    0x1c30: 84,
+    0x1c31: 84,
+    0x1c32: 84,
+    0x1c33: 84,
+    0x1c36: 84,
+    0x1c37: 84,
+    0x1cd0: 84,
+    0x1cd1: 84,
+    0x1cd2: 84,
+    0x1cd4: 84,
+    0x1cd5: 84,
+    0x1cd6: 84,
+    0x1cd7: 84,
+    0x1cd8: 84,
+    0x1cd9: 84,
+    0x1cda: 84,
+    0x1cdb: 84,
+    0x1cdc: 84,
+    0x1cdd: 84,
+    0x1cde: 84,
+    0x1cdf: 84,
+    0x1ce0: 84,
+    0x1ce2: 84,
+    0x1ce3: 84,
+    0x1ce4: 84,
+    0x1ce5: 84,
+    0x1ce6: 84,
+    0x1ce7: 84,
+    0x1ce8: 84,
+    0x1ced: 84,
+    0x1cf4: 84,
+    0x1cf8: 84,
+    0x1cf9: 84,
+    0x1dc0: 84,
+    0x1dc1: 84,
+    0x1dc2: 84,
+    0x1dc3: 84,
+    0x1dc4: 84,
+    0x1dc5: 84,
+    0x1dc6: 84,
+    0x1dc7: 84,
+    0x1dc8: 84,
+    0x1dc9: 84,
+    0x1dca: 84,
+    0x1dcb: 84,
+    0x1dcc: 84,
+    0x1dcd: 84,
+    0x1dce: 84,
+    0x1dcf: 84,
+    0x1dd0: 84,
+    0x1dd1: 84,
+    0x1dd2: 84,
+    0x1dd3: 84,
+    0x1dd4: 84,
+    0x1dd5: 84,
+    0x1dd6: 84,
+    0x1dd7: 84,
+    0x1dd8: 84,
+    0x1dd9: 84,
+    0x1dda: 84,
+    0x1ddb: 84,
+    0x1ddc: 84,
+    0x1ddd: 84,
+    0x1dde: 84,
+    0x1ddf: 84,
+    0x1de0: 84,
+    0x1de1: 84,
+    0x1de2: 84,
+    0x1de3: 84,
+    0x1de4: 84,
+    0x1de5: 84,
+    0x1de6: 84,
+    0x1de7: 84,
+    0x1de8: 84,
+    0x1de9: 84,
+    0x1dea: 84,
+    0x1deb: 84,
+    0x1dec: 84,
+    0x1ded: 84,
+    0x1dee: 84,
+    0x1def: 84,
+    0x1df0: 84,
+    0x1df1: 84,
+    0x1df2: 84,
+    0x1df3: 84,
+    0x1df4: 84,
+    0x1df5: 84,
+    0x1df6: 84,
+    0x1df7: 84,
+    0x1df8: 84,
+    0x1df9: 84,
+    0x1dfa: 84,
+    0x1dfb: 84,
+    0x1dfc: 84,
+    0x1dfd: 84,
+    0x1dfe: 84,
+    0x1dff: 84,
+    0x200b: 84,
+    0x200d: 67,
+    0x200e: 84,
+    0x200f: 84,
+    0x202a: 84,
+    0x202b: 84,
+    0x202c: 84,
+    0x202d: 84,
+    0x202e: 84,
+    0x2060: 84,
+    0x2061: 84,
+    0x2062: 84,
+    0x2063: 84,
+    0x2064: 84,
+    0x206a: 84,
+    0x206b: 84,
+    0x206c: 84,
+    0x206d: 84,
+    0x206e: 84,
+    0x206f: 84,
+    0x20d0: 84,
+    0x20d1: 84,
+    0x20d2: 84,
+    0x20d3: 84,
+    0x20d4: 84,
+    0x20d5: 84,
+    0x20d6: 84,
+    0x20d7: 84,
+    0x20d8: 84,
+    0x20d9: 84,
+    0x20da: 84,
+    0x20db: 84,
+    0x20dc: 84,
+    0x20dd: 84,
+    0x20de: 84,
+    0x20df: 84,
+    0x20e0: 84,
+    0x20e1: 84,
+    0x20e2: 84,
+    0x20e3: 84,
+    0x20e4: 84,
+    0x20e5: 84,
+    0x20e6: 84,
+    0x20e7: 84,
+    0x20e8: 84,
+    0x20e9: 84,
+    0x20ea: 84,
+    0x20eb: 84,
+    0x20ec: 84,
+    0x20ed: 84,
+    0x20ee: 84,
+    0x20ef: 84,
+    0x20f0: 84,
+    0x2cef: 84,
+    0x2cf0: 84,
+    0x2cf1: 84,
+    0x2d7f: 84,
+    0x2de0: 84,
+    0x2de1: 84,
+    0x2de2: 84,
+    0x2de3: 84,
+    0x2de4: 84,
+    0x2de5: 84,
+    0x2de6: 84,
+    0x2de7: 84,
+    0x2de8: 84,
+    0x2de9: 84,
+    0x2dea: 84,
+    0x2deb: 84,
+    0x2dec: 84,
+    0x2ded: 84,
+    0x2dee: 84,
+    0x2def: 84,
+    0x2df0: 84,
+    0x2df1: 84,
+    0x2df2: 84,
+    0x2df3: 84,
+    0x2df4: 84,
+    0x2df5: 84,
+    0x2df6: 84,
+    0x2df7: 84,
+    0x2df8: 84,
+    0x2df9: 84,
+    0x2dfa: 84,
+    0x2dfb: 84,
+    0x2dfc: 84,
+    0x2dfd: 84,
+    0x2dfe: 84,
+    0x2dff: 84,
+    0x302a: 84,
+    0x302b: 84,
+    0x302c: 84,
+    0x302d: 84,
+    0x3099: 84,
+    0x309a: 84,
+    0xa66f: 84,
+    0xa670: 84,
+    0xa671: 84,
+    0xa672: 84,
+    0xa674: 84,
+    0xa675: 84,
+    0xa676: 84,
+    0xa677: 84,
+    0xa678: 84,
+    0xa679: 84,
+    0xa67a: 84,
+    0xa67b: 84,
+    0xa67c: 84,
+    0xa67d: 84,
+    0xa69e: 84,
+    0xa69f: 84,
+    0xa6f0: 84,
+    0xa6f1: 84,
+    0xa802: 84,
+    0xa806: 84,
+    0xa80b: 84,
+    0xa825: 84,
+    0xa826: 84,
+    0xa82c: 84,
+    0xa840: 68,
+    0xa841: 68,
+    0xa842: 68,
+    0xa843: 68,
+    0xa844: 68,
+    0xa845: 68,
+    0xa846: 68,
+    0xa847: 68,
+    0xa848: 68,
+    0xa849: 68,
+    0xa84a: 68,
+    0xa84b: 68,
+    0xa84c: 68,
+    0xa84d: 68,
+    0xa84e: 68,
+    0xa84f: 68,
+    0xa850: 68,
+    0xa851: 68,
+    0xa852: 68,
+    0xa853: 68,
+    0xa854: 68,
+    0xa855: 68,
+    0xa856: 68,
+    0xa857: 68,
+    0xa858: 68,
+    0xa859: 68,
+    0xa85a: 68,
+    0xa85b: 68,
+    0xa85c: 68,
+    0xa85d: 68,
+    0xa85e: 68,
+    0xa85f: 68,
+    0xa860: 68,
+    0xa861: 68,
+    0xa862: 68,
+    0xa863: 68,
+    0xa864: 68,
+    0xa865: 68,
+    0xa866: 68,
+    0xa867: 68,
+    0xa868: 68,
+    0xa869: 68,
+    0xa86a: 68,
+    0xa86b: 68,
+    0xa86c: 68,
+    0xa86d: 68,
+    0xa86e: 68,
+    0xa86f: 68,
+    0xa870: 68,
+    0xa871: 68,
+    0xa872: 76,
+    0xa8c4: 84,
+    0xa8c5: 84,
+    0xa8e0: 84,
+    0xa8e1: 84,
+    0xa8e2: 84,
+    0xa8e3: 84,
+    0xa8e4: 84,
+    0xa8e5: 84,
+    0xa8e6: 84,
+    0xa8e7: 84,
+    0xa8e8: 84,
+    0xa8e9: 84,
+    0xa8ea: 84,
+    0xa8eb: 84,
+    0xa8ec: 84,
+    0xa8ed: 84,
+    0xa8ee: 84,
+    0xa8ef: 84,
+    0xa8f0: 84,
+    0xa8f1: 84,
+    0xa8ff: 84,
+    0xa926: 84,
+    0xa927: 84,
+    0xa928: 84,
+    0xa929: 84,
+    0xa92a: 84,
+    0xa92b: 84,
+    0xa92c: 84,
+    0xa92d: 84,
+    0xa947: 84,
+    0xa948: 84,
+    0xa949: 84,
+    0xa94a: 84,
+    0xa94b: 84,
+    0xa94c: 84,
+    0xa94d: 84,
+    0xa94e: 84,
+    0xa94f: 84,
+    0xa950: 84,
+    0xa951: 84,
+    0xa980: 84,
+    0xa981: 84,
+    0xa982: 84,
+    0xa9b3: 84,
+    0xa9b6: 84,
+    0xa9b7: 84,
+    0xa9b8: 84,
+    0xa9b9: 84,
+    0xa9bc: 84,
+    0xa9bd: 84,
+    0xa9e5: 84,
+    0xaa29: 84,
+    0xaa2a: 84,
+    0xaa2b: 84,
+    0xaa2c: 84,
+    0xaa2d: 84,
+    0xaa2e: 84,
+    0xaa31: 84,
+    0xaa32: 84,
+    0xaa35: 84,
+    0xaa36: 84,
+    0xaa43: 84,
+    0xaa4c: 84,
+    0xaa7c: 84,
+    0xaab0: 84,
+    0xaab2: 84,
+    0xaab3: 84,
+    0xaab4: 84,
+    0xaab7: 84,
+    0xaab8: 84,
+    0xaabe: 84,
+    0xaabf: 84,
+    0xaac1: 84,
+    0xaaec: 84,
+    0xaaed: 84,
+    0xaaf6: 84,
+    0xabe5: 84,
+    0xabe8: 84,
+    0xabed: 84,
+    0xfb1e: 84,
+    0xfe00: 84,
+    0xfe01: 84,
+    0xfe02: 84,
+    0xfe03: 84,
+    0xfe04: 84,
+    0xfe05: 84,
+    0xfe06: 84,
+    0xfe07: 84,
+    0xfe08: 84,
+    0xfe09: 84,
+    0xfe0a: 84,
+    0xfe0b: 84,
+    0xfe0c: 84,
+    0xfe0d: 84,
+    0xfe0e: 84,
+    0xfe0f: 84,
+    0xfe20: 84,
+    0xfe21: 84,
+    0xfe22: 84,
+    0xfe23: 84,
+    0xfe24: 84,
+    0xfe25: 84,
+    0xfe26: 84,
+    0xfe27: 84,
+    0xfe28: 84,
+    0xfe29: 84,
+    0xfe2a: 84,
+    0xfe2b: 84,
+    0xfe2c: 84,
+    0xfe2d: 84,
+    0xfe2e: 84,
+    0xfe2f: 84,
+    0xfeff: 84,
+    0xfff9: 84,
+    0xfffa: 84,
+    0xfffb: 84,
+    0x101fd: 84,
+    0x102e0: 84,
+    0x10376: 84,
+    0x10377: 84,
+    0x10378: 84,
+    0x10379: 84,
+    0x1037a: 84,
+    0x10a01: 84,
+    0x10a02: 84,
+    0x10a03: 84,
+    0x10a05: 84,
+    0x10a06: 84,
+    0x10a0c: 84,
+    0x10a0d: 84,
+    0x10a0e: 84,
+    0x10a0f: 84,
+    0x10a38: 84,
+    0x10a39: 84,
+    0x10a3a: 84,
+    0x10a3f: 84,
+    0x10ac0: 68,
+    0x10ac1: 68,
+    0x10ac2: 68,
+    0x10ac3: 68,
+    0x10ac4: 68,
+    0x10ac5: 82,
+    0x10ac7: 82,
+    0x10ac9: 82,
+    0x10aca: 82,
+    0x10acd: 76,
+    0x10ace: 82,
+    0x10acf: 82,
+    0x10ad0: 82,
+    0x10ad1: 82,
+    0x10ad2: 82,
+    0x10ad3: 68,
+    0x10ad4: 68,
+    0x10ad5: 68,
+    0x10ad6: 68,
+    0x10ad7: 76,
+    0x10ad8: 68,
+    0x10ad9: 68,
+    0x10ada: 68,
+    0x10adb: 68,
+    0x10adc: 68,
+    0x10add: 82,
+    0x10ade: 68,
+    0x10adf: 68,
+    0x10ae0: 68,
+    0x10ae1: 82,
+    0x10ae4: 82,
+    0x10ae5: 84,
+    0x10ae6: 84,
+    0x10aeb: 68,
+    0x10aec: 68,
+    0x10aed: 68,
+    0x10aee: 68,
+    0x10aef: 82,
+    0x10b80: 68,
+    0x10b81: 82,
+    0x10b82: 68,
+    0x10b83: 82,
+    0x10b84: 82,
+    0x10b85: 82,
+    0x10b86: 68,
+    0x10b87: 68,
+    0x10b88: 68,
+    0x10b89: 82,
+    0x10b8a: 68,
+    0x10b8b: 68,
+    0x10b8c: 82,
+    0x10b8d: 68,
+    0x10b8e: 82,
+    0x10b8f: 82,
+    0x10b90: 68,
+    0x10b91: 82,
+    0x10ba9: 82,
+    0x10baa: 82,
+    0x10bab: 82,
+    0x10bac: 82,
+    0x10bad: 68,
+    0x10bae: 68,
+    0x10d00: 76,
+    0x10d01: 68,
+    0x10d02: 68,
+    0x10d03: 68,
+    0x10d04: 68,
+    0x10d05: 68,
+    0x10d06: 68,
+    0x10d07: 68,
+    0x10d08: 68,
+    0x10d09: 68,
+    0x10d0a: 68,
+    0x10d0b: 68,
+    0x10d0c: 68,
+    0x10d0d: 68,
+    0x10d0e: 68,
+    0x10d0f: 68,
+    0x10d10: 68,
+    0x10d11: 68,
+    0x10d12: 68,
+    0x10d13: 68,
+    0x10d14: 68,
+    0x10d15: 68,
+    0x10d16: 68,
+    0x10d17: 68,
+    0x10d18: 68,
+    0x10d19: 68,
+    0x10d1a: 68,
+    0x10d1b: 68,
+    0x10d1c: 68,
+    0x10d1d: 68,
+    0x10d1e: 68,
+    0x10d1f: 68,
+    0x10d20: 68,
+    0x10d21: 68,
+    0x10d22: 82,
+    0x10d23: 68,
+    0x10d24: 84,
+    0x10d25: 84,
+    0x10d26: 84,
+    0x10d27: 84,
+    0x10eab: 84,
+    0x10eac: 84,
+    0x10efd: 84,
+    0x10efe: 84,
+    0x10eff: 84,
+    0x10f30: 68,
+    0x10f31: 68,
+    0x10f32: 68,
+    0x10f33: 82,
+    0x10f34: 68,
+    0x10f35: 68,
+    0x10f36: 68,
+    0x10f37: 68,
+    0x10f38: 68,
+    0x10f39: 68,
+    0x10f3a: 68,
+    0x10f3b: 68,
+    0x10f3c: 68,
+    0x10f3d: 68,
+    0x10f3e: 68,
+    0x10f3f: 68,
+    0x10f40: 68,
+    0x10f41: 68,
+    0x10f42: 68,
+    0x10f43: 68,
+    0x10f44: 68,
+    0x10f46: 84,
+    0x10f47: 84,
+    0x10f48: 84,
+    0x10f49: 84,
+    0x10f4a: 84,
+    0x10f4b: 84,
+    0x10f4c: 84,
+    0x10f4d: 84,
+    0x10f4e: 84,
+    0x10f4f: 84,
+    0x10f50: 84,
+    0x10f51: 68,
+    0x10f52: 68,
+    0x10f53: 68,
+    0x10f54: 82,
+    0x10f70: 68,
+    0x10f71: 68,
+    0x10f72: 68,
+    0x10f73: 68,
+    0x10f74: 82,
+    0x10f75: 82,
+    0x10f76: 68,
+    0x10f77: 68,
+    0x10f78: 68,
+    0x10f79: 68,
+    0x10f7a: 68,
+    0x10f7b: 68,
+    0x10f7c: 68,
+    0x10f7d: 68,
+    0x10f7e: 68,
+    0x10f7f: 68,
+    0x10f80: 68,
+    0x10f81: 68,
+    0x10f82: 84,
+    0x10f83: 84,
+    0x10f84: 84,
+    0x10f85: 84,
+    0x10fb0: 68,
+    0x10fb2: 68,
+    0x10fb3: 68,
+    0x10fb4: 82,
+    0x10fb5: 82,
+    0x10fb6: 82,
+    0x10fb8: 68,
+    0x10fb9: 82,
+    0x10fba: 82,
+    0x10fbb: 68,
+    0x10fbc: 68,
+    0x10fbd: 82,
+    0x10fbe: 68,
+    0x10fbf: 68,
+    0x10fc1: 68,
+    0x10fc2: 82,
+    0x10fc3: 82,
+    0x10fc4: 68,
+    0x10fc9: 82,
+    0x10fca: 68,
+    0x10fcb: 76,
+    0x11001: 84,
+    0x11038: 84,
+    0x11039: 84,
+    0x1103a: 84,
+    0x1103b: 84,
+    0x1103c: 84,
+    0x1103d: 84,
+    0x1103e: 84,
+    0x1103f: 84,
+    0x11040: 84,
+    0x11041: 84,
+    0x11042: 84,
+    0x11043: 84,
+    0x11044: 84,
+    0x11045: 84,
+    0x11046: 84,
+    0x11070: 84,
+    0x11073: 84,
+    0x11074: 84,
+    0x1107f: 84,
+    0x11080: 84,
+    0x11081: 84,
+    0x110b3: 84,
+    0x110b4: 84,
+    0x110b5: 84,
+    0x110b6: 84,
+    0x110b9: 84,
+    0x110ba: 84,
+    0x110c2: 84,
+    0x11100: 84,
+    0x11101: 84,
+    0x11102: 84,
+    0x11127: 84,
+    0x11128: 84,
+    0x11129: 84,
+    0x1112a: 84,
+    0x1112b: 84,
+    0x1112d: 84,
+    0x1112e: 84,
+    0x1112f: 84,
+    0x11130: 84,
+    0x11131: 84,
+    0x11132: 84,
+    0x11133: 84,
+    0x11134: 84,
+    0x11173: 84,
+    0x11180: 84,
+    0x11181: 84,
+    0x111b6: 84,
+    0x111b7: 84,
+    0x111b8: 84,
+    0x111b9: 84,
+    0x111ba: 84,
+    0x111bb: 84,
+    0x111bc: 84,
+    0x111bd: 84,
+    0x111be: 84,
+    0x111c9: 84,
+    0x111ca: 84,
+    0x111cb: 84,
+    0x111cc: 84,
+    0x111cf: 84,
+    0x1122f: 84,
+    0x11230: 84,
+    0x11231: 84,
+    0x11234: 84,
+    0x11236: 84,
+    0x11237: 84,
+    0x1123e: 84,
+    0x11241: 84,
+    0x112df: 84,
+    0x112e3: 84,
+    0x112e4: 84,
+    0x112e5: 84,
+    0x112e6: 84,
+    0x112e7: 84,
+    0x112e8: 84,
+    0x112e9: 84,
+    0x112ea: 84,
+    0x11300: 84,
+    0x11301: 84,
+    0x1133b: 84,
+    0x1133c: 84,
+    0x11340: 84,
+    0x11366: 84,
+    0x11367: 84,
+    0x11368: 84,
+    0x11369: 84,
+    0x1136a: 84,
+    0x1136b: 84,
+    0x1136c: 84,
+    0x11370: 84,
+    0x11371: 84,
+    0x11372: 84,
+    0x11373: 84,
+    0x11374: 84,
+    0x11438: 84,
+    0x11439: 84,
+    0x1143a: 84,
+    0x1143b: 84,
+    0x1143c: 84,
+    0x1143d: 84,
+    0x1143e: 84,
+    0x1143f: 84,
+    0x11442: 84,
+    0x11443: 84,
+    0x11444: 84,
+    0x11446: 84,
+    0x1145e: 84,
+    0x114b3: 84,
+    0x114b4: 84,
+    0x114b5: 84,
+    0x114b6: 84,
+    0x114b7: 84,
+    0x114b8: 84,
+    0x114ba: 84,
+    0x114bf: 84,
+    0x114c0: 84,
+    0x114c2: 84,
+    0x114c3: 84,
+    0x115b2: 84,
+    0x115b3: 84,
+    0x115b4: 84,
+    0x115b5: 84,
+    0x115bc: 84,
+    0x115bd: 84,
+    0x115bf: 84,
+    0x115c0: 84,
+    0x115dc: 84,
+    0x115dd: 84,
+    0x11633: 84,
+    0x11634: 84,
+    0x11635: 84,
+    0x11636: 84,
+    0x11637: 84,
+    0x11638: 84,
+    0x11639: 84,
+    0x1163a: 84,
+    0x1163d: 84,
+    0x1163f: 84,
+    0x11640: 84,
+    0x116ab: 84,
+    0x116ad: 84,
+    0x116b0: 84,
+    0x116b1: 84,
+    0x116b2: 84,
+    0x116b3: 84,
+    0x116b4: 84,
+    0x116b5: 84,
+    0x116b7: 84,
+    0x1171d: 84,
+    0x1171e: 84,
+    0x1171f: 84,
+    0x11722: 84,
+    0x11723: 84,
+    0x11724: 84,
+    0x11725: 84,
+    0x11727: 84,
+    0x11728: 84,
+    0x11729: 84,
+    0x1172a: 84,
+    0x1172b: 84,
+    0x1182f: 84,
+    0x11830: 84,
+    0x11831: 84,
+    0x11832: 84,
+    0x11833: 84,
+    0x11834: 84,
+    0x11835: 84,
+    0x11836: 84,
+    0x11837: 84,
+    0x11839: 84,
+    0x1183a: 84,
+    0x1193b: 84,
+    0x1193c: 84,
+    0x1193e: 84,
+    0x11943: 84,
+    0x119d4: 84,
+    0x119d5: 84,
+    0x119d6: 84,
+    0x119d7: 84,
+    0x119da: 84,
+    0x119db: 84,
+    0x119e0: 84,
+    0x11a01: 84,
+    0x11a02: 84,
+    0x11a03: 84,
+    0x11a04: 84,
+    0x11a05: 84,
+    0x11a06: 84,
+    0x11a07: 84,
+    0x11a08: 84,
+    0x11a09: 84,
+    0x11a0a: 84,
+    0x11a33: 84,
+    0x11a34: 84,
+    0x11a35: 84,
+    0x11a36: 84,
+    0x11a37: 84,
+    0x11a38: 84,
+    0x11a3b: 84,
+    0x11a3c: 84,
+    0x11a3d: 84,
+    0x11a3e: 84,
+    0x11a47: 84,
+    0x11a51: 84,
+    0x11a52: 84,
+    0x11a53: 84,
+    0x11a54: 84,
+    0x11a55: 84,
+    0x11a56: 84,
+    0x11a59: 84,
+    0x11a5a: 84,
+    0x11a5b: 84,
+    0x11a8a: 84,
+    0x11a8b: 84,
+    0x11a8c: 84,
+    0x11a8d: 84,
+    0x11a8e: 84,
+    0x11a8f: 84,
+    0x11a90: 84,
+    0x11a91: 84,
+    0x11a92: 84,
+    0x11a93: 84,
+    0x11a94: 84,
+    0x11a95: 84,
+    0x11a96: 84,
+    0x11a98: 84,
+    0x11a99: 84,
+    0x11c30: 84,
+    0x11c31: 84,
+    0x11c32: 84,
+    0x11c33: 84,
+    0x11c34: 84,
+    0x11c35: 84,
+    0x11c36: 84,
+    0x11c38: 84,
+    0x11c39: 84,
+    0x11c3a: 84,
+    0x11c3b: 84,
+    0x11c3c: 84,
+    0x11c3d: 84,
+    0x11c3f: 84,
+    0x11c92: 84,
+    0x11c93: 84,
+    0x11c94: 84,
+    0x11c95: 84,
+    0x11c96: 84,
+    0x11c97: 84,
+    0x11c98: 84,
+    0x11c99: 84,
+    0x11c9a: 84,
+    0x11c9b: 84,
+    0x11c9c: 84,
+    0x11c9d: 84,
+    0x11c9e: 84,
+    0x11c9f: 84,
+    0x11ca0: 84,
+    0x11ca1: 84,
+    0x11ca2: 84,
+    0x11ca3: 84,
+    0x11ca4: 84,
+    0x11ca5: 84,
+    0x11ca6: 84,
+    0x11ca7: 84,
+    0x11caa: 84,
+    0x11cab: 84,
+    0x11cac: 84,
+    0x11cad: 84,
+    0x11cae: 84,
+    0x11caf: 84,
+    0x11cb0: 84,
+    0x11cb2: 84,
+    0x11cb3: 84,
+    0x11cb5: 84,
+    0x11cb6: 84,
+    0x11d31: 84,
+    0x11d32: 84,
+    0x11d33: 84,
+    0x11d34: 84,
+    0x11d35: 84,
+    0x11d36: 84,
+    0x11d3a: 84,
+    0x11d3c: 84,
+    0x11d3d: 84,
+    0x11d3f: 84,
+    0x11d40: 84,
+    0x11d41: 84,
+    0x11d42: 84,
+    0x11d43: 84,
+    0x11d44: 84,
+    0x11d45: 84,
+    0x11d47: 84,
+    0x11d90: 84,
+    0x11d91: 84,
+    0x11d95: 84,
+    0x11d97: 84,
+    0x11ef3: 84,
+    0x11ef4: 84,
+    0x11f00: 84,
+    0x11f01: 84,
+    0x11f36: 84,
+    0x11f37: 84,
+    0x11f38: 84,
+    0x11f39: 84,
+    0x11f3a: 84,
+    0x11f40: 84,
+    0x11f42: 84,
+    0x13430: 84,
+    0x13431: 84,
+    0x13432: 84,
+    0x13433: 84,
+    0x13434: 84,
+    0x13435: 84,
+    0x13436: 84,
+    0x13437: 84,
+    0x13438: 84,
+    0x13439: 84,
+    0x1343a: 84,
+    0x1343b: 84,
+    0x1343c: 84,
+    0x1343d: 84,
+    0x1343e: 84,
+    0x1343f: 84,
+    0x13440: 84,
+    0x13447: 84,
+    0x13448: 84,
+    0x13449: 84,
+    0x1344a: 84,
+    0x1344b: 84,
+    0x1344c: 84,
+    0x1344d: 84,
+    0x1344e: 84,
+    0x1344f: 84,
+    0x13450: 84,
+    0x13451: 84,
+    0x13452: 84,
+    0x13453: 84,
+    0x13454: 84,
+    0x13455: 84,
+    0x16af0: 84,
+    0x16af1: 84,
+    0x16af2: 84,
+    0x16af3: 84,
+    0x16af4: 84,
+    0x16b30: 84,
+    0x16b31: 84,
+    0x16b32: 84,
+    0x16b33: 84,
+    0x16b34: 84,
+    0x16b35: 84,
+    0x16b36: 84,
+    0x16f4f: 84,
+    0x16f8f: 84,
+    0x16f90: 84,
+    0x16f91: 84,
+    0x16f92: 84,
+    0x16fe4: 84,
+    0x1bc9d: 84,
+    0x1bc9e: 84,
+    0x1bca0: 84,
+    0x1bca1: 84,
+    0x1bca2: 84,
+    0x1bca3: 84,
+    0x1cf00: 84,
+    0x1cf01: 84,
+    0x1cf02: 84,
+    0x1cf03: 84,
+    0x1cf04: 84,
+    0x1cf05: 84,
+    0x1cf06: 84,
+    0x1cf07: 84,
+    0x1cf08: 84,
+    0x1cf09: 84,
+    0x1cf0a: 84,
+    0x1cf0b: 84,
+    0x1cf0c: 84,
+    0x1cf0d: 84,
+    0x1cf0e: 84,
+    0x1cf0f: 84,
+    0x1cf10: 84,
+    0x1cf11: 84,
+    0x1cf12: 84,
+    0x1cf13: 84,
+    0x1cf14: 84,
+    0x1cf15: 84,
+    0x1cf16: 84,
+    0x1cf17: 84,
+    0x1cf18: 84,
+    0x1cf19: 84,
+    0x1cf1a: 84,
+    0x1cf1b: 84,
+    0x1cf1c: 84,
+    0x1cf1d: 84,
+    0x1cf1e: 84,
+    0x1cf1f: 84,
+    0x1cf20: 84,
+    0x1cf21: 84,
+    0x1cf22: 84,
+    0x1cf23: 84,
+    0x1cf24: 84,
+    0x1cf25: 84,
+    0x1cf26: 84,
+    0x1cf27: 84,
+    0x1cf28: 84,
+    0x1cf29: 84,
+    0x1cf2a: 84,
+    0x1cf2b: 84,
+    0x1cf2c: 84,
+    0x1cf2d: 84,
+    0x1cf30: 84,
+    0x1cf31: 84,
+    0x1cf32: 84,
+    0x1cf33: 84,
+    0x1cf34: 84,
+    0x1cf35: 84,
+    0x1cf36: 84,
+    0x1cf37: 84,
+    0x1cf38: 84,
+    0x1cf39: 84,
+    0x1cf3a: 84,
+    0x1cf3b: 84,
+    0x1cf3c: 84,
+    0x1cf3d: 84,
+    0x1cf3e: 84,
+    0x1cf3f: 84,
+    0x1cf40: 84,
+    0x1cf41: 84,
+    0x1cf42: 84,
+    0x1cf43: 84,
+    0x1cf44: 84,
+    0x1cf45: 84,
+    0x1cf46: 84,
+    0x1d167: 84,
+    0x1d168: 84,
+    0x1d169: 84,
+    0x1d173: 84,
+    0x1d174: 84,
+    0x1d175: 84,
+    0x1d176: 84,
+    0x1d177: 84,
+    0x1d178: 84,
+    0x1d179: 84,
+    0x1d17a: 84,
+    0x1d17b: 84,
+    0x1d17c: 84,
+    0x1d17d: 84,
+    0x1d17e: 84,
+    0x1d17f: 84,
+    0x1d180: 84,
+    0x1d181: 84,
+    0x1d182: 84,
+    0x1d185: 84,
+    0x1d186: 84,
+    0x1d187: 84,
+    0x1d188: 84,
+    0x1d189: 84,
+    0x1d18a: 84,
+    0x1d18b: 84,
+    0x1d1aa: 84,
+    0x1d1ab: 84,
+    0x1d1ac: 84,
+    0x1d1ad: 84,
+    0x1d242: 84,
+    0x1d243: 84,
+    0x1d244: 84,
+    0x1da00: 84,
+    0x1da01: 84,
+    0x1da02: 84,
+    0x1da03: 84,
+    0x1da04: 84,
+    0x1da05: 84,
+    0x1da06: 84,
+    0x1da07: 84,
+    0x1da08: 84,
+    0x1da09: 84,
+    0x1da0a: 84,
+    0x1da0b: 84,
+    0x1da0c: 84,
+    0x1da0d: 84,
+    0x1da0e: 84,
+    0x1da0f: 84,
+    0x1da10: 84,
+    0x1da11: 84,
+    0x1da12: 84,
+    0x1da13: 84,
+    0x1da14: 84,
+    0x1da15: 84,
+    0x1da16: 84,
+    0x1da17: 84,
+    0x1da18: 84,
+    0x1da19: 84,
+    0x1da1a: 84,
+    0x1da1b: 84,
+    0x1da1c: 84,
+    0x1da1d: 84,
+    0x1da1e: 84,
+    0x1da1f: 84,
+    0x1da20: 84,
+    0x1da21: 84,
+    0x1da22: 84,
+    0x1da23: 84,
+    0x1da24: 84,
+    0x1da25: 84,
+    0x1da26: 84,
+    0x1da27: 84,
+    0x1da28: 84,
+    0x1da29: 84,
+    0x1da2a: 84,
+    0x1da2b: 84,
+    0x1da2c: 84,
+    0x1da2d: 84,
+    0x1da2e: 84,
+    0x1da2f: 84,
+    0x1da30: 84,
+    0x1da31: 84,
+    0x1da32: 84,
+    0x1da33: 84,
+    0x1da34: 84,
+    0x1da35: 84,
+    0x1da36: 84,
+    0x1da3b: 84,
+    0x1da3c: 84,
+    0x1da3d: 84,
+    0x1da3e: 84,
+    0x1da3f: 84,
+    0x1da40: 84,
+    0x1da41: 84,
+    0x1da42: 84,
+    0x1da43: 84,
+    0x1da44: 84,
+    0x1da45: 84,
+    0x1da46: 84,
+    0x1da47: 84,
+    0x1da48: 84,
+    0x1da49: 84,
+    0x1da4a: 84,
+    0x1da4b: 84,
+    0x1da4c: 84,
+    0x1da4d: 84,
+    0x1da4e: 84,
+    0x1da4f: 84,
+    0x1da50: 84,
+    0x1da51: 84,
+    0x1da52: 84,
+    0x1da53: 84,
+    0x1da54: 84,
+    0x1da55: 84,
+    0x1da56: 84,
+    0x1da57: 84,
+    0x1da58: 84,
+    0x1da59: 84,
+    0x1da5a: 84,
+    0x1da5b: 84,
+    0x1da5c: 84,
+    0x1da5d: 84,
+    0x1da5e: 84,
+    0x1da5f: 84,
+    0x1da60: 84,
+    0x1da61: 84,
+    0x1da62: 84,
+    0x1da63: 84,
+    0x1da64: 84,
+    0x1da65: 84,
+    0x1da66: 84,
+    0x1da67: 84,
+    0x1da68: 84,
+    0x1da69: 84,
+    0x1da6a: 84,
+    0x1da6b: 84,
+    0x1da6c: 84,
+    0x1da75: 84,
+    0x1da84: 84,
+    0x1da9b: 84,
+    0x1da9c: 84,
+    0x1da9d: 84,
+    0x1da9e: 84,
+    0x1da9f: 84,
+    0x1daa1: 84,
+    0x1daa2: 84,
+    0x1daa3: 84,
+    0x1daa4: 84,
+    0x1daa5: 84,
+    0x1daa6: 84,
+    0x1daa7: 84,
+    0x1daa8: 84,
+    0x1daa9: 84,
+    0x1daaa: 84,
+    0x1daab: 84,
+    0x1daac: 84,
+    0x1daad: 84,
+    0x1daae: 84,
+    0x1daaf: 84,
+    0x1e000: 84,
+    0x1e001: 84,
+    0x1e002: 84,
+    0x1e003: 84,
+    0x1e004: 84,
+    0x1e005: 84,
+    0x1e006: 84,
+    0x1e008: 84,
+    0x1e009: 84,
+    0x1e00a: 84,
+    0x1e00b: 84,
+    0x1e00c: 84,
+    0x1e00d: 84,
+    0x1e00e: 84,
+    0x1e00f: 84,
+    0x1e010: 84,
+    0x1e011: 84,
+    0x1e012: 84,
+    0x1e013: 84,
+    0x1e014: 84,
+    0x1e015: 84,
+    0x1e016: 84,
+    0x1e017: 84,
+    0x1e018: 84,
+    0x1e01b: 84,
+    0x1e01c: 84,
+    0x1e01d: 84,
+    0x1e01e: 84,
+    0x1e01f: 84,
+    0x1e020: 84,
+    0x1e021: 84,
+    0x1e023: 84,
+    0x1e024: 84,
+    0x1e026: 84,
+    0x1e027: 84,
+    0x1e028: 84,
+    0x1e029: 84,
+    0x1e02a: 84,
+    0x1e08f: 84,
+    0x1e130: 84,
+    0x1e131: 84,
+    0x1e132: 84,
+    0x1e133: 84,
+    0x1e134: 84,
+    0x1e135: 84,
+    0x1e136: 84,
+    0x1e2ae: 84,
+    0x1e2ec: 84,
+    0x1e2ed: 84,
+    0x1e2ee: 84,
+    0x1e2ef: 84,
+    0x1e4ec: 84,
+    0x1e4ed: 84,
+    0x1e4ee: 84,
+    0x1e4ef: 84,
+    0x1e8d0: 84,
+    0x1e8d1: 84,
+    0x1e8d2: 84,
+    0x1e8d3: 84,
+    0x1e8d4: 84,
+    0x1e8d5: 84,
+    0x1e8d6: 84,
+    0x1e900: 68,
+    0x1e901: 68,
+    0x1e902: 68,
+    0x1e903: 68,
+    0x1e904: 68,
+    0x1e905: 68,
+    0x1e906: 68,
+    0x1e907: 68,
+    0x1e908: 68,
+    0x1e909: 68,
+    0x1e90a: 68,
+    0x1e90b: 68,
+    0x1e90c: 68,
+    0x1e90d: 68,
+    0x1e90e: 68,
+    0x1e90f: 68,
+    0x1e910: 68,
+    0x1e911: 68,
+    0x1e912: 68,
+    0x1e913: 68,
+    0x1e914: 68,
+    0x1e915: 68,
+    0x1e916: 68,
+    0x1e917: 68,
+    0x1e918: 68,
+    0x1e919: 68,
+    0x1e91a: 68,
+    0x1e91b: 68,
+    0x1e91c: 68,
+    0x1e91d: 68,
+    0x1e91e: 68,
+    0x1e91f: 68,
+    0x1e920: 68,
+    0x1e921: 68,
+    0x1e922: 68,
+    0x1e923: 68,
+    0x1e924: 68,
+    0x1e925: 68,
+    0x1e926: 68,
+    0x1e927: 68,
+    0x1e928: 68,
+    0x1e929: 68,
+    0x1e92a: 68,
+    0x1e92b: 68,
+    0x1e92c: 68,
+    0x1e92d: 68,
+    0x1e92e: 68,
+    0x1e92f: 68,
+    0x1e930: 68,
+    0x1e931: 68,
+    0x1e932: 68,
+    0x1e933: 68,
+    0x1e934: 68,
+    0x1e935: 68,
+    0x1e936: 68,
+    0x1e937: 68,
+    0x1e938: 68,
+    0x1e939: 68,
+    0x1e93a: 68,
+    0x1e93b: 68,
+    0x1e93c: 68,
+    0x1e93d: 68,
+    0x1e93e: 68,
+    0x1e93f: 68,
+    0x1e940: 68,
+    0x1e941: 68,
+    0x1e942: 68,
+    0x1e943: 68,
+    0x1e944: 84,
+    0x1e945: 84,
+    0x1e946: 84,
+    0x1e947: 84,
+    0x1e948: 84,
+    0x1e949: 84,
+    0x1e94a: 84,
+    0x1e94b: 84,
+    0xe0001: 84,
+    0xe0020: 84,
+    0xe0021: 84,
+    0xe0022: 84,
+    0xe0023: 84,
+    0xe0024: 84,
+    0xe0025: 84,
+    0xe0026: 84,
+    0xe0027: 84,
+    0xe0028: 84,
+    0xe0029: 84,
+    0xe002a: 84,
+    0xe002b: 84,
+    0xe002c: 84,
+    0xe002d: 84,
+    0xe002e: 84,
+    0xe002f: 84,
+    0xe0030: 84,
+    0xe0031: 84,
+    0xe0032: 84,
+    0xe0033: 84,
+    0xe0034: 84,
+    0xe0035: 84,
+    0xe0036: 84,
+    0xe0037: 84,
+    0xe0038: 84,
+    0xe0039: 84,
+    0xe003a: 84,
+    0xe003b: 84,
+    0xe003c: 84,
+    0xe003d: 84,
+    0xe003e: 84,
+    0xe003f: 84,
+    0xe0040: 84,
+    0xe0041: 84,
+    0xe0042: 84,
+    0xe0043: 84,
+    0xe0044: 84,
+    0xe0045: 84,
+    0xe0046: 84,
+    0xe0047: 84,
+    0xe0048: 84,
+    0xe0049: 84,
+    0xe004a: 84,
+    0xe004b: 84,
+    0xe004c: 84,
+    0xe004d: 84,
+    0xe004e: 84,
+    0xe004f: 84,
+    0xe0050: 84,
+    0xe0051: 84,
+    0xe0052: 84,
+    0xe0053: 84,
+    0xe0054: 84,
+    0xe0055: 84,
+    0xe0056: 84,
+    0xe0057: 84,
+    0xe0058: 84,
+    0xe0059: 84,
+    0xe005a: 84,
+    0xe005b: 84,
+    0xe005c: 84,
+    0xe005d: 84,
+    0xe005e: 84,
+    0xe005f: 84,
+    0xe0060: 84,
+    0xe0061: 84,
+    0xe0062: 84,
+    0xe0063: 84,
+    0xe0064: 84,
+    0xe0065: 84,
+    0xe0066: 84,
+    0xe0067: 84,
+    0xe0068: 84,
+    0xe0069: 84,
+    0xe006a: 84,
+    0xe006b: 84,
+    0xe006c: 84,
+    0xe006d: 84,
+    0xe006e: 84,
+    0xe006f: 84,
+    0xe0070: 84,
+    0xe0071: 84,
+    0xe0072: 84,
+    0xe0073: 84,
+    0xe0074: 84,
+    0xe0075: 84,
+    0xe0076: 84,
+    0xe0077: 84,
+    0xe0078: 84,
+    0xe0079: 84,
+    0xe007a: 84,
+    0xe007b: 84,
+    0xe007c: 84,
+    0xe007d: 84,
+    0xe007e: 84,
+    0xe007f: 84,
+    0xe0100: 84,
+    0xe0101: 84,
+    0xe0102: 84,
+    0xe0103: 84,
+    0xe0104: 84,
+    0xe0105: 84,
+    0xe0106: 84,
+    0xe0107: 84,
+    0xe0108: 84,
+    0xe0109: 84,
+    0xe010a: 84,
+    0xe010b: 84,
+    0xe010c: 84,
+    0xe010d: 84,
+    0xe010e: 84,
+    0xe010f: 84,
+    0xe0110: 84,
+    0xe0111: 84,
+    0xe0112: 84,
+    0xe0113: 84,
+    0xe0114: 84,
+    0xe0115: 84,
+    0xe0116: 84,
+    0xe0117: 84,
+    0xe0118: 84,
+    0xe0119: 84,
+    0xe011a: 84,
+    0xe011b: 84,
+    0xe011c: 84,
+    0xe011d: 84,
+    0xe011e: 84,
+    0xe011f: 84,
+    0xe0120: 84,
+    0xe0121: 84,
+    0xe0122: 84,
+    0xe0123: 84,
+    0xe0124: 84,
+    0xe0125: 84,
+    0xe0126: 84,
+    0xe0127: 84,
+    0xe0128: 84,
+    0xe0129: 84,
+    0xe012a: 84,
+    0xe012b: 84,
+    0xe012c: 84,
+    0xe012d: 84,
+    0xe012e: 84,
+    0xe012f: 84,
+    0xe0130: 84,
+    0xe0131: 84,
+    0xe0132: 84,
+    0xe0133: 84,
+    0xe0134: 84,
+    0xe0135: 84,
+    0xe0136: 84,
+    0xe0137: 84,
+    0xe0138: 84,
+    0xe0139: 84,
+    0xe013a: 84,
+    0xe013b: 84,
+    0xe013c: 84,
+    0xe013d: 84,
+    0xe013e: 84,
+    0xe013f: 84,
+    0xe0140: 84,
+    0xe0141: 84,
+    0xe0142: 84,
+    0xe0143: 84,
+    0xe0144: 84,
+    0xe0145: 84,
+    0xe0146: 84,
+    0xe0147: 84,
+    0xe0148: 84,
+    0xe0149: 84,
+    0xe014a: 84,
+    0xe014b: 84,
+    0xe014c: 84,
+    0xe014d: 84,
+    0xe014e: 84,
+    0xe014f: 84,
+    0xe0150: 84,
+    0xe0151: 84,
+    0xe0152: 84,
+    0xe0153: 84,
+    0xe0154: 84,
+    0xe0155: 84,
+    0xe0156: 84,
+    0xe0157: 84,
+    0xe0158: 84,
+    0xe0159: 84,
+    0xe015a: 84,
+    0xe015b: 84,
+    0xe015c: 84,
+    0xe015d: 84,
+    0xe015e: 84,
+    0xe015f: 84,
+    0xe0160: 84,
+    0xe0161: 84,
+    0xe0162: 84,
+    0xe0163: 84,
+    0xe0164: 84,
+    0xe0165: 84,
+    0xe0166: 84,
+    0xe0167: 84,
+    0xe0168: 84,
+    0xe0169: 84,
+    0xe016a: 84,
+    0xe016b: 84,
+    0xe016c: 84,
+    0xe016d: 84,
+    0xe016e: 84,
+    0xe016f: 84,
+    0xe0170: 84,
+    0xe0171: 84,
+    0xe0172: 84,
+    0xe0173: 84,
+    0xe0174: 84,
+    0xe0175: 84,
+    0xe0176: 84,
+    0xe0177: 84,
+    0xe0178: 84,
+    0xe0179: 84,
+    0xe017a: 84,
+    0xe017b: 84,
+    0xe017c: 84,
+    0xe017d: 84,
+    0xe017e: 84,
+    0xe017f: 84,
+    0xe0180: 84,
+    0xe0181: 84,
+    0xe0182: 84,
+    0xe0183: 84,
+    0xe0184: 84,
+    0xe0185: 84,
+    0xe0186: 84,
+    0xe0187: 84,
+    0xe0188: 84,
+    0xe0189: 84,
+    0xe018a: 84,
+    0xe018b: 84,
+    0xe018c: 84,
+    0xe018d: 84,
+    0xe018e: 84,
+    0xe018f: 84,
+    0xe0190: 84,
+    0xe0191: 84,
+    0xe0192: 84,
+    0xe0193: 84,
+    0xe0194: 84,
+    0xe0195: 84,
+    0xe0196: 84,
+    0xe0197: 84,
+    0xe0198: 84,
+    0xe0199: 84,
+    0xe019a: 84,
+    0xe019b: 84,
+    0xe019c: 84,
+    0xe019d: 84,
+    0xe019e: 84,
+    0xe019f: 84,
+    0xe01a0: 84,
+    0xe01a1: 84,
+    0xe01a2: 84,
+    0xe01a3: 84,
+    0xe01a4: 84,
+    0xe01a5: 84,
+    0xe01a6: 84,
+    0xe01a7: 84,
+    0xe01a8: 84,
+    0xe01a9: 84,
+    0xe01aa: 84,
+    0xe01ab: 84,
+    0xe01ac: 84,
+    0xe01ad: 84,
+    0xe01ae: 84,
+    0xe01af: 84,
+    0xe01b0: 84,
+    0xe01b1: 84,
+    0xe01b2: 84,
+    0xe01b3: 84,
+    0xe01b4: 84,
+    0xe01b5: 84,
+    0xe01b6: 84,
+    0xe01b7: 84,
+    0xe01b8: 84,
+    0xe01b9: 84,
+    0xe01ba: 84,
+    0xe01bb: 84,
+    0xe01bc: 84,
+    0xe01bd: 84,
+    0xe01be: 84,
+    0xe01bf: 84,
+    0xe01c0: 84,
+    0xe01c1: 84,
+    0xe01c2: 84,
+    0xe01c3: 84,
+    0xe01c4: 84,
+    0xe01c5: 84,
+    0xe01c6: 84,
+    0xe01c7: 84,
+    0xe01c8: 84,
+    0xe01c9: 84,
+    0xe01ca: 84,
+    0xe01cb: 84,
+    0xe01cc: 84,
+    0xe01cd: 84,
+    0xe01ce: 84,
+    0xe01cf: 84,
+    0xe01d0: 84,
+    0xe01d1: 84,
+    0xe01d2: 84,
+    0xe01d3: 84,
+    0xe01d4: 84,
+    0xe01d5: 84,
+    0xe01d6: 84,
+    0xe01d7: 84,
+    0xe01d8: 84,
+    0xe01d9: 84,
+    0xe01da: 84,
+    0xe01db: 84,
+    0xe01dc: 84,
+    0xe01dd: 84,
+    0xe01de: 84,
+    0xe01df: 84,
+    0xe01e0: 84,
+    0xe01e1: 84,
+    0xe01e2: 84,
+    0xe01e3: 84,
+    0xe01e4: 84,
+    0xe01e5: 84,
+    0xe01e6: 84,
+    0xe01e7: 84,
+    0xe01e8: 84,
+    0xe01e9: 84,
+    0xe01ea: 84,
+    0xe01eb: 84,
+    0xe01ec: 84,
+    0xe01ed: 84,
+    0xe01ee: 84,
+    0xe01ef: 84,
+}
+codepoint_classes = {
+    'PVALID': (
+        0x2d0000002e,
+        0x300000003a,
+        0x610000007b,
+        0xdf000000f7,
+        0xf800000100,
+        0x10100000102,
+        0x10300000104,
+        0x10500000106,
+        0x10700000108,
+        0x1090000010a,
+        0x10b0000010c,
+        0x10d0000010e,
+        0x10f00000110,
+        0x11100000112,
+        0x11300000114,
+        0x11500000116,
+        0x11700000118,
+        0x1190000011a,
+        0x11b0000011c,
+        0x11d0000011e,
+        0x11f00000120,
+        0x12100000122,
+        0x12300000124,
+        0x12500000126,
+        0x12700000128,
+        0x1290000012a,
+        0x12b0000012c,
+        0x12d0000012e,
+        0x12f00000130,
+        0x13100000132,
+        0x13500000136,
+        0x13700000139,
+        0x13a0000013b,
+        0x13c0000013d,
+        0x13e0000013f,
+        0x14200000143,
+        0x14400000145,
+        0x14600000147,
+        0x14800000149,
+        0x14b0000014c,
+        0x14d0000014e,
+        0x14f00000150,
+        0x15100000152,
+        0x15300000154,
+        0x15500000156,
+        0x15700000158,
+        0x1590000015a,
+        0x15b0000015c,
+        0x15d0000015e,
+        0x15f00000160,
+        0x16100000162,
+        0x16300000164,
+        0x16500000166,
+        0x16700000168,
+        0x1690000016a,
+        0x16b0000016c,
+        0x16d0000016e,
+        0x16f00000170,
+        0x17100000172,
+        0x17300000174,
+        0x17500000176,
+        0x17700000178,
+        0x17a0000017b,
+        0x17c0000017d,
+        0x17e0000017f,
+        0x18000000181,
+        0x18300000184,
+        0x18500000186,
+        0x18800000189,
+        0x18c0000018e,
+        0x19200000193,
+        0x19500000196,
+        0x1990000019c,
+        0x19e0000019f,
+        0x1a1000001a2,
+        0x1a3000001a4,
+        0x1a5000001a6,
+        0x1a8000001a9,
+        0x1aa000001ac,
+        0x1ad000001ae,
+        0x1b0000001b1,
+        0x1b4000001b5,
+        0x1b6000001b7,
+        0x1b9000001bc,
+        0x1bd000001c4,
+        0x1ce000001cf,
+        0x1d0000001d1,
+        0x1d2000001d3,
+        0x1d4000001d5,
+        0x1d6000001d7,
+        0x1d8000001d9,
+        0x1da000001db,
+        0x1dc000001de,
+        0x1df000001e0,
+        0x1e1000001e2,
+        0x1e3000001e4,
+        0x1e5000001e6,
+        0x1e7000001e8,
+        0x1e9000001ea,
+        0x1eb000001ec,
+        0x1ed000001ee,
+        0x1ef000001f1,
+        0x1f5000001f6,
+        0x1f9000001fa,
+        0x1fb000001fc,
+        0x1fd000001fe,
+        0x1ff00000200,
+        0x20100000202,
+        0x20300000204,
+        0x20500000206,
+        0x20700000208,
+        0x2090000020a,
+        0x20b0000020c,
+        0x20d0000020e,
+        0x20f00000210,
+        0x21100000212,
+        0x21300000214,
+        0x21500000216,
+        0x21700000218,
+        0x2190000021a,
+        0x21b0000021c,
+        0x21d0000021e,
+        0x21f00000220,
+        0x22100000222,
+        0x22300000224,
+        0x22500000226,
+        0x22700000228,
+        0x2290000022a,
+        0x22b0000022c,
+        0x22d0000022e,
+        0x22f00000230,
+        0x23100000232,
+        0x2330000023a,
+        0x23c0000023d,
+        0x23f00000241,
+        0x24200000243,
+        0x24700000248,
+        0x2490000024a,
+        0x24b0000024c,
+        0x24d0000024e,
+        0x24f000002b0,
+        0x2b9000002c2,
+        0x2c6000002d2,
+        0x2ec000002ed,
+        0x2ee000002ef,
+        0x30000000340,
+        0x34200000343,
+        0x3460000034f,
+        0x35000000370,
+        0x37100000372,
+        0x37300000374,
+        0x37700000378,
+        0x37b0000037e,
+        0x39000000391,
+        0x3ac000003cf,
+        0x3d7000003d8,
+        0x3d9000003da,
+        0x3db000003dc,
+        0x3dd000003de,
+        0x3df000003e0,
+        0x3e1000003e2,
+        0x3e3000003e4,
+        0x3e5000003e6,
+        0x3e7000003e8,
+        0x3e9000003ea,
+        0x3eb000003ec,
+        0x3ed000003ee,
+        0x3ef000003f0,
+        0x3f3000003f4,
+        0x3f8000003f9,
+        0x3fb000003fd,
+        0x43000000460,
+        0x46100000462,
+        0x46300000464,
+        0x46500000466,
+        0x46700000468,
+        0x4690000046a,
+        0x46b0000046c,
+        0x46d0000046e,
+        0x46f00000470,
+        0x47100000472,
+        0x47300000474,
+        0x47500000476,
+        0x47700000478,
+        0x4790000047a,
+        0x47b0000047c,
+        0x47d0000047e,
+        0x47f00000480,
+        0x48100000482,
+        0x48300000488,
+        0x48b0000048c,
+        0x48d0000048e,
+        0x48f00000490,
+        0x49100000492,
+        0x49300000494,
+        0x49500000496,
+        0x49700000498,
+        0x4990000049a,
+        0x49b0000049c,
+        0x49d0000049e,
+        0x49f000004a0,
+        0x4a1000004a2,
+        0x4a3000004a4,
+        0x4a5000004a6,
+        0x4a7000004a8,
+        0x4a9000004aa,
+        0x4ab000004ac,
+        0x4ad000004ae,
+        0x4af000004b0,
+        0x4b1000004b2,
+        0x4b3000004b4,
+        0x4b5000004b6,
+        0x4b7000004b8,
+        0x4b9000004ba,
+        0x4bb000004bc,
+        0x4bd000004be,
+        0x4bf000004c0,
+        0x4c2000004c3,
+        0x4c4000004c5,
+        0x4c6000004c7,
+        0x4c8000004c9,
+        0x4ca000004cb,
+        0x4cc000004cd,
+        0x4ce000004d0,
+        0x4d1000004d2,
+        0x4d3000004d4,
+        0x4d5000004d6,
+        0x4d7000004d8,
+        0x4d9000004da,
+        0x4db000004dc,
+        0x4dd000004de,
+        0x4df000004e0,
+        0x4e1000004e2,
+        0x4e3000004e4,
+        0x4e5000004e6,
+        0x4e7000004e8,
+        0x4e9000004ea,
+        0x4eb000004ec,
+        0x4ed000004ee,
+        0x4ef000004f0,
+        0x4f1000004f2,
+        0x4f3000004f4,
+        0x4f5000004f6,
+        0x4f7000004f8,
+        0x4f9000004fa,
+        0x4fb000004fc,
+        0x4fd000004fe,
+        0x4ff00000500,
+        0x50100000502,
+        0x50300000504,
+        0x50500000506,
+        0x50700000508,
+        0x5090000050a,
+        0x50b0000050c,
+        0x50d0000050e,
+        0x50f00000510,
+        0x51100000512,
+        0x51300000514,
+        0x51500000516,
+        0x51700000518,
+        0x5190000051a,
+        0x51b0000051c,
+        0x51d0000051e,
+        0x51f00000520,
+        0x52100000522,
+        0x52300000524,
+        0x52500000526,
+        0x52700000528,
+        0x5290000052a,
+        0x52b0000052c,
+        0x52d0000052e,
+        0x52f00000530,
+        0x5590000055a,
+        0x56000000587,
+        0x58800000589,
+        0x591000005be,
+        0x5bf000005c0,
+        0x5c1000005c3,
+        0x5c4000005c6,
+        0x5c7000005c8,
+        0x5d0000005eb,
+        0x5ef000005f3,
+        0x6100000061b,
+        0x62000000640,
+        0x64100000660,
+        0x66e00000675,
+        0x679000006d4,
+        0x6d5000006dd,
+        0x6df000006e9,
+        0x6ea000006f0,
+        0x6fa00000700,
+        0x7100000074b,
+        0x74d000007b2,
+        0x7c0000007f6,
+        0x7fd000007fe,
+        0x8000000082e,
+        0x8400000085c,
+        0x8600000086b,
+        0x87000000888,
+        0x8890000088f,
+        0x898000008e2,
+        0x8e300000958,
+        0x96000000964,
+        0x96600000970,
+        0x97100000984,
+        0x9850000098d,
+        0x98f00000991,
+        0x993000009a9,
+        0x9aa000009b1,
+        0x9b2000009b3,
+        0x9b6000009ba,
+        0x9bc000009c5,
+        0x9c7000009c9,
+        0x9cb000009cf,
+        0x9d7000009d8,
+        0x9e0000009e4,
+        0x9e6000009f2,
+        0x9fc000009fd,
+        0x9fe000009ff,
+        0xa0100000a04,
+        0xa0500000a0b,
+        0xa0f00000a11,
+        0xa1300000a29,
+        0xa2a00000a31,
+        0xa3200000a33,
+        0xa3500000a36,
+        0xa3800000a3a,
+        0xa3c00000a3d,
+        0xa3e00000a43,
+        0xa4700000a49,
+        0xa4b00000a4e,
+        0xa5100000a52,
+        0xa5c00000a5d,
+        0xa6600000a76,
+        0xa8100000a84,
+        0xa8500000a8e,
+        0xa8f00000a92,
+        0xa9300000aa9,
+        0xaaa00000ab1,
+        0xab200000ab4,
+        0xab500000aba,
+        0xabc00000ac6,
+        0xac700000aca,
+        0xacb00000ace,
+        0xad000000ad1,
+        0xae000000ae4,
+        0xae600000af0,
+        0xaf900000b00,
+        0xb0100000b04,
+        0xb0500000b0d,
+        0xb0f00000b11,
+        0xb1300000b29,
+        0xb2a00000b31,
+        0xb3200000b34,
+        0xb3500000b3a,
+        0xb3c00000b45,
+        0xb4700000b49,
+        0xb4b00000b4e,
+        0xb5500000b58,
+        0xb5f00000b64,
+        0xb6600000b70,
+        0xb7100000b72,
+        0xb8200000b84,
+        0xb8500000b8b,
+        0xb8e00000b91,
+        0xb9200000b96,
+        0xb9900000b9b,
+        0xb9c00000b9d,
+        0xb9e00000ba0,
+        0xba300000ba5,
+        0xba800000bab,
+        0xbae00000bba,
+        0xbbe00000bc3,
+        0xbc600000bc9,
+        0xbca00000bce,
+        0xbd000000bd1,
+        0xbd700000bd8,
+        0xbe600000bf0,
+        0xc0000000c0d,
+        0xc0e00000c11,
+        0xc1200000c29,
+        0xc2a00000c3a,
+        0xc3c00000c45,
+        0xc4600000c49,
+        0xc4a00000c4e,
+        0xc5500000c57,
+        0xc5800000c5b,
+        0xc5d00000c5e,
+        0xc6000000c64,
+        0xc6600000c70,
+        0xc8000000c84,
+        0xc8500000c8d,
+        0xc8e00000c91,
+        0xc9200000ca9,
+        0xcaa00000cb4,
+        0xcb500000cba,
+        0xcbc00000cc5,
+        0xcc600000cc9,
+        0xcca00000cce,
+        0xcd500000cd7,
+        0xcdd00000cdf,
+        0xce000000ce4,
+        0xce600000cf0,
+        0xcf100000cf4,
+        0xd0000000d0d,
+        0xd0e00000d11,
+        0xd1200000d45,
+        0xd4600000d49,
+        0xd4a00000d4f,
+        0xd5400000d58,
+        0xd5f00000d64,
+        0xd6600000d70,
+        0xd7a00000d80,
+        0xd8100000d84,
+        0xd8500000d97,
+        0xd9a00000db2,
+        0xdb300000dbc,
+        0xdbd00000dbe,
+        0xdc000000dc7,
+        0xdca00000dcb,
+        0xdcf00000dd5,
+        0xdd600000dd7,
+        0xdd800000de0,
+        0xde600000df0,
+        0xdf200000df4,
+        0xe0100000e33,
+        0xe3400000e3b,
+        0xe4000000e4f,
+        0xe5000000e5a,
+        0xe8100000e83,
+        0xe8400000e85,
+        0xe8600000e8b,
+        0xe8c00000ea4,
+        0xea500000ea6,
+        0xea700000eb3,
+        0xeb400000ebe,
+        0xec000000ec5,
+        0xec600000ec7,
+        0xec800000ecf,
+        0xed000000eda,
+        0xede00000ee0,
+        0xf0000000f01,
+        0xf0b00000f0c,
+        0xf1800000f1a,
+        0xf2000000f2a,
+        0xf3500000f36,
+        0xf3700000f38,
+        0xf3900000f3a,
+        0xf3e00000f43,
+        0xf4400000f48,
+        0xf4900000f4d,
+        0xf4e00000f52,
+        0xf5300000f57,
+        0xf5800000f5c,
+        0xf5d00000f69,
+        0xf6a00000f6d,
+        0xf7100000f73,
+        0xf7400000f75,
+        0xf7a00000f81,
+        0xf8200000f85,
+        0xf8600000f93,
+        0xf9400000f98,
+        0xf9900000f9d,
+        0xf9e00000fa2,
+        0xfa300000fa7,
+        0xfa800000fac,
+        0xfad00000fb9,
+        0xfba00000fbd,
+        0xfc600000fc7,
+        0x10000000104a,
+        0x10500000109e,
+        0x10d0000010fb,
+        0x10fd00001100,
+        0x120000001249,
+        0x124a0000124e,
+        0x125000001257,
+        0x125800001259,
+        0x125a0000125e,
+        0x126000001289,
+        0x128a0000128e,
+        0x1290000012b1,
+        0x12b2000012b6,
+        0x12b8000012bf,
+        0x12c0000012c1,
+        0x12c2000012c6,
+        0x12c8000012d7,
+        0x12d800001311,
+        0x131200001316,
+        0x13180000135b,
+        0x135d00001360,
+        0x138000001390,
+        0x13a0000013f6,
+        0x14010000166d,
+        0x166f00001680,
+        0x16810000169b,
+        0x16a0000016eb,
+        0x16f1000016f9,
+        0x170000001716,
+        0x171f00001735,
+        0x174000001754,
+        0x17600000176d,
+        0x176e00001771,
+        0x177200001774,
+        0x1780000017b4,
+        0x17b6000017d4,
+        0x17d7000017d8,
+        0x17dc000017de,
+        0x17e0000017ea,
+        0x18100000181a,
+        0x182000001879,
+        0x1880000018ab,
+        0x18b0000018f6,
+        0x19000000191f,
+        0x19200000192c,
+        0x19300000193c,
+        0x19460000196e,
+        0x197000001975,
+        0x1980000019ac,
+        0x19b0000019ca,
+        0x19d0000019da,
+        0x1a0000001a1c,
+        0x1a2000001a5f,
+        0x1a6000001a7d,
+        0x1a7f00001a8a,
+        0x1a9000001a9a,
+        0x1aa700001aa8,
+        0x1ab000001abe,
+        0x1abf00001acf,
+        0x1b0000001b4d,
+        0x1b5000001b5a,
+        0x1b6b00001b74,
+        0x1b8000001bf4,
+        0x1c0000001c38,
+        0x1c4000001c4a,
+        0x1c4d00001c7e,
+        0x1cd000001cd3,
+        0x1cd400001cfb,
+        0x1d0000001d2c,
+        0x1d2f00001d30,
+        0x1d3b00001d3c,
+        0x1d4e00001d4f,
+        0x1d6b00001d78,
+        0x1d7900001d9b,
+        0x1dc000001e00,
+        0x1e0100001e02,
+        0x1e0300001e04,
+        0x1e0500001e06,
+        0x1e0700001e08,
+        0x1e0900001e0a,
+        0x1e0b00001e0c,
+        0x1e0d00001e0e,
+        0x1e0f00001e10,
+        0x1e1100001e12,
+        0x1e1300001e14,
+        0x1e1500001e16,
+        0x1e1700001e18,
+        0x1e1900001e1a,
+        0x1e1b00001e1c,
+        0x1e1d00001e1e,
+        0x1e1f00001e20,
+        0x1e2100001e22,
+        0x1e2300001e24,
+        0x1e2500001e26,
+        0x1e2700001e28,
+        0x1e2900001e2a,
+        0x1e2b00001e2c,
+        0x1e2d00001e2e,
+        0x1e2f00001e30,
+        0x1e3100001e32,
+        0x1e3300001e34,
+        0x1e3500001e36,
+        0x1e3700001e38,
+        0x1e3900001e3a,
+        0x1e3b00001e3c,
+        0x1e3d00001e3e,
+        0x1e3f00001e40,
+        0x1e4100001e42,
+        0x1e4300001e44,
+        0x1e4500001e46,
+        0x1e4700001e48,
+        0x1e4900001e4a,
+        0x1e4b00001e4c,
+        0x1e4d00001e4e,
+        0x1e4f00001e50,
+        0x1e5100001e52,
+        0x1e5300001e54,
+        0x1e5500001e56,
+        0x1e5700001e58,
+        0x1e5900001e5a,
+        0x1e5b00001e5c,
+        0x1e5d00001e5e,
+        0x1e5f00001e60,
+        0x1e6100001e62,
+        0x1e6300001e64,
+        0x1e6500001e66,
+        0x1e6700001e68,
+        0x1e6900001e6a,
+        0x1e6b00001e6c,
+        0x1e6d00001e6e,
+        0x1e6f00001e70,
+        0x1e7100001e72,
+        0x1e7300001e74,
+        0x1e7500001e76,
+        0x1e7700001e78,
+        0x1e7900001e7a,
+        0x1e7b00001e7c,
+        0x1e7d00001e7e,
+        0x1e7f00001e80,
+        0x1e8100001e82,
+        0x1e8300001e84,
+        0x1e8500001e86,
+        0x1e8700001e88,
+        0x1e8900001e8a,
+        0x1e8b00001e8c,
+        0x1e8d00001e8e,
+        0x1e8f00001e90,
+        0x1e9100001e92,
+        0x1e9300001e94,
+        0x1e9500001e9a,
+        0x1e9c00001e9e,
+        0x1e9f00001ea0,
+        0x1ea100001ea2,
+        0x1ea300001ea4,
+        0x1ea500001ea6,
+        0x1ea700001ea8,
+        0x1ea900001eaa,
+        0x1eab00001eac,
+        0x1ead00001eae,
+        0x1eaf00001eb0,
+        0x1eb100001eb2,
+        0x1eb300001eb4,
+        0x1eb500001eb6,
+        0x1eb700001eb8,
+        0x1eb900001eba,
+        0x1ebb00001ebc,
+        0x1ebd00001ebe,
+        0x1ebf00001ec0,
+        0x1ec100001ec2,
+        0x1ec300001ec4,
+        0x1ec500001ec6,
+        0x1ec700001ec8,
+        0x1ec900001eca,
+        0x1ecb00001ecc,
+        0x1ecd00001ece,
+        0x1ecf00001ed0,
+        0x1ed100001ed2,
+        0x1ed300001ed4,
+        0x1ed500001ed6,
+        0x1ed700001ed8,
+        0x1ed900001eda,
+        0x1edb00001edc,
+        0x1edd00001ede,
+        0x1edf00001ee0,
+        0x1ee100001ee2,
+        0x1ee300001ee4,
+        0x1ee500001ee6,
+        0x1ee700001ee8,
+        0x1ee900001eea,
+        0x1eeb00001eec,
+        0x1eed00001eee,
+        0x1eef00001ef0,
+        0x1ef100001ef2,
+        0x1ef300001ef4,
+        0x1ef500001ef6,
+        0x1ef700001ef8,
+        0x1ef900001efa,
+        0x1efb00001efc,
+        0x1efd00001efe,
+        0x1eff00001f08,
+        0x1f1000001f16,
+        0x1f2000001f28,
+        0x1f3000001f38,
+        0x1f4000001f46,
+        0x1f5000001f58,
+        0x1f6000001f68,
+        0x1f7000001f71,
+        0x1f7200001f73,
+        0x1f7400001f75,
+        0x1f7600001f77,
+        0x1f7800001f79,
+        0x1f7a00001f7b,
+        0x1f7c00001f7d,
+        0x1fb000001fb2,
+        0x1fb600001fb7,
+        0x1fc600001fc7,
+        0x1fd000001fd3,
+        0x1fd600001fd8,
+        0x1fe000001fe3,
+        0x1fe400001fe8,
+        0x1ff600001ff7,
+        0x214e0000214f,
+        0x218400002185,
+        0x2c3000002c60,
+        0x2c6100002c62,
+        0x2c6500002c67,
+        0x2c6800002c69,
+        0x2c6a00002c6b,
+        0x2c6c00002c6d,
+        0x2c7100002c72,
+        0x2c7300002c75,
+        0x2c7600002c7c,
+        0x2c8100002c82,
+        0x2c8300002c84,
+        0x2c8500002c86,
+        0x2c8700002c88,
+        0x2c8900002c8a,
+        0x2c8b00002c8c,
+        0x2c8d00002c8e,
+        0x2c8f00002c90,
+        0x2c9100002c92,
+        0x2c9300002c94,
+        0x2c9500002c96,
+        0x2c9700002c98,
+        0x2c9900002c9a,
+        0x2c9b00002c9c,
+        0x2c9d00002c9e,
+        0x2c9f00002ca0,
+        0x2ca100002ca2,
+        0x2ca300002ca4,
+        0x2ca500002ca6,
+        0x2ca700002ca8,
+        0x2ca900002caa,
+        0x2cab00002cac,
+        0x2cad00002cae,
+        0x2caf00002cb0,
+        0x2cb100002cb2,
+        0x2cb300002cb4,
+        0x2cb500002cb6,
+        0x2cb700002cb8,
+        0x2cb900002cba,
+        0x2cbb00002cbc,
+        0x2cbd00002cbe,
+        0x2cbf00002cc0,
+        0x2cc100002cc2,
+        0x2cc300002cc4,
+        0x2cc500002cc6,
+        0x2cc700002cc8,
+        0x2cc900002cca,
+        0x2ccb00002ccc,
+        0x2ccd00002cce,
+        0x2ccf00002cd0,
+        0x2cd100002cd2,
+        0x2cd300002cd4,
+        0x2cd500002cd6,
+        0x2cd700002cd8,
+        0x2cd900002cda,
+        0x2cdb00002cdc,
+        0x2cdd00002cde,
+        0x2cdf00002ce0,
+        0x2ce100002ce2,
+        0x2ce300002ce5,
+        0x2cec00002ced,
+        0x2cee00002cf2,
+        0x2cf300002cf4,
+        0x2d0000002d26,
+        0x2d2700002d28,
+        0x2d2d00002d2e,
+        0x2d3000002d68,
+        0x2d7f00002d97,
+        0x2da000002da7,
+        0x2da800002daf,
+        0x2db000002db7,
+        0x2db800002dbf,
+        0x2dc000002dc7,
+        0x2dc800002dcf,
+        0x2dd000002dd7,
+        0x2dd800002ddf,
+        0x2de000002e00,
+        0x2e2f00002e30,
+        0x300500003008,
+        0x302a0000302e,
+        0x303c0000303d,
+        0x304100003097,
+        0x30990000309b,
+        0x309d0000309f,
+        0x30a1000030fb,
+        0x30fc000030ff,
+        0x310500003130,
+        0x31a0000031c0,
+        0x31f000003200,
+        0x340000004dc0,
+        0x4e000000a48d,
+        0xa4d00000a4fe,
+        0xa5000000a60d,
+        0xa6100000a62c,
+        0xa6410000a642,
+        0xa6430000a644,
+        0xa6450000a646,
+        0xa6470000a648,
+        0xa6490000a64a,
+        0xa64b0000a64c,
+        0xa64d0000a64e,
+        0xa64f0000a650,
+        0xa6510000a652,
+        0xa6530000a654,
+        0xa6550000a656,
+        0xa6570000a658,
+        0xa6590000a65a,
+        0xa65b0000a65c,
+        0xa65d0000a65e,
+        0xa65f0000a660,
+        0xa6610000a662,
+        0xa6630000a664,
+        0xa6650000a666,
+        0xa6670000a668,
+        0xa6690000a66a,
+        0xa66b0000a66c,
+        0xa66d0000a670,
+        0xa6740000a67e,
+        0xa67f0000a680,
+        0xa6810000a682,
+        0xa6830000a684,
+        0xa6850000a686,
+        0xa6870000a688,
+        0xa6890000a68a,
+        0xa68b0000a68c,
+        0xa68d0000a68e,
+        0xa68f0000a690,
+        0xa6910000a692,
+        0xa6930000a694,
+        0xa6950000a696,
+        0xa6970000a698,
+        0xa6990000a69a,
+        0xa69b0000a69c,
+        0xa69e0000a6e6,
+        0xa6f00000a6f2,
+        0xa7170000a720,
+        0xa7230000a724,
+        0xa7250000a726,
+        0xa7270000a728,
+        0xa7290000a72a,
+        0xa72b0000a72c,
+        0xa72d0000a72e,
+        0xa72f0000a732,
+        0xa7330000a734,
+        0xa7350000a736,
+        0xa7370000a738,
+        0xa7390000a73a,
+        0xa73b0000a73c,
+        0xa73d0000a73e,
+        0xa73f0000a740,
+        0xa7410000a742,
+        0xa7430000a744,
+        0xa7450000a746,
+        0xa7470000a748,
+        0xa7490000a74a,
+        0xa74b0000a74c,
+        0xa74d0000a74e,
+        0xa74f0000a750,
+        0xa7510000a752,
+        0xa7530000a754,
+        0xa7550000a756,
+        0xa7570000a758,
+        0xa7590000a75a,
+        0xa75b0000a75c,
+        0xa75d0000a75e,
+        0xa75f0000a760,
+        0xa7610000a762,
+        0xa7630000a764,
+        0xa7650000a766,
+        0xa7670000a768,
+        0xa7690000a76a,
+        0xa76b0000a76c,
+        0xa76d0000a76e,
+        0xa76f0000a770,
+        0xa7710000a779,
+        0xa77a0000a77b,
+        0xa77c0000a77d,
+        0xa77f0000a780,
+        0xa7810000a782,
+        0xa7830000a784,
+        0xa7850000a786,
+        0xa7870000a789,
+        0xa78c0000a78d,
+        0xa78e0000a790,
+        0xa7910000a792,
+        0xa7930000a796,
+        0xa7970000a798,
+        0xa7990000a79a,
+        0xa79b0000a79c,
+        0xa79d0000a79e,
+        0xa79f0000a7a0,
+        0xa7a10000a7a2,
+        0xa7a30000a7a4,
+        0xa7a50000a7a6,
+        0xa7a70000a7a8,
+        0xa7a90000a7aa,
+        0xa7af0000a7b0,
+        0xa7b50000a7b6,
+        0xa7b70000a7b8,
+        0xa7b90000a7ba,
+        0xa7bb0000a7bc,
+        0xa7bd0000a7be,
+        0xa7bf0000a7c0,
+        0xa7c10000a7c2,
+        0xa7c30000a7c4,
+        0xa7c80000a7c9,
+        0xa7ca0000a7cb,
+        0xa7d10000a7d2,
+        0xa7d30000a7d4,
+        0xa7d50000a7d6,
+        0xa7d70000a7d8,
+        0xa7d90000a7da,
+        0xa7f60000a7f8,
+        0xa7fa0000a828,
+        0xa82c0000a82d,
+        0xa8400000a874,
+        0xa8800000a8c6,
+        0xa8d00000a8da,
+        0xa8e00000a8f8,
+        0xa8fb0000a8fc,
+        0xa8fd0000a92e,
+        0xa9300000a954,
+        0xa9800000a9c1,
+        0xa9cf0000a9da,
+        0xa9e00000a9ff,
+        0xaa000000aa37,
+        0xaa400000aa4e,
+        0xaa500000aa5a,
+        0xaa600000aa77,
+        0xaa7a0000aac3,
+        0xaadb0000aade,
+        0xaae00000aaf0,
+        0xaaf20000aaf7,
+        0xab010000ab07,
+        0xab090000ab0f,
+        0xab110000ab17,
+        0xab200000ab27,
+        0xab280000ab2f,
+        0xab300000ab5b,
+        0xab600000ab69,
+        0xabc00000abeb,
+        0xabec0000abee,
+        0xabf00000abfa,
+        0xac000000d7a4,
+        0xfa0e0000fa10,
+        0xfa110000fa12,
+        0xfa130000fa15,
+        0xfa1f0000fa20,
+        0xfa210000fa22,
+        0xfa230000fa25,
+        0xfa270000fa2a,
+        0xfb1e0000fb1f,
+        0xfe200000fe30,
+        0xfe730000fe74,
+        0x100000001000c,
+        0x1000d00010027,
+        0x100280001003b,
+        0x1003c0001003e,
+        0x1003f0001004e,
+        0x100500001005e,
+        0x10080000100fb,
+        0x101fd000101fe,
+        0x102800001029d,
+        0x102a0000102d1,
+        0x102e0000102e1,
+        0x1030000010320,
+        0x1032d00010341,
+        0x103420001034a,
+        0x103500001037b,
+        0x103800001039e,
+        0x103a0000103c4,
+        0x103c8000103d0,
+        0x104280001049e,
+        0x104a0000104aa,
+        0x104d8000104fc,
+        0x1050000010528,
+        0x1053000010564,
+        0x10597000105a2,
+        0x105a3000105b2,
+        0x105b3000105ba,
+        0x105bb000105bd,
+        0x1060000010737,
+        0x1074000010756,
+        0x1076000010768,
+        0x1078000010781,
+        0x1080000010806,
+        0x1080800010809,
+        0x1080a00010836,
+        0x1083700010839,
+        0x1083c0001083d,
+        0x1083f00010856,
+        0x1086000010877,
+        0x108800001089f,
+        0x108e0000108f3,
+        0x108f4000108f6,
+        0x1090000010916,
+        0x109200001093a,
+        0x10980000109b8,
+        0x109be000109c0,
+        0x10a0000010a04,
+        0x10a0500010a07,
+        0x10a0c00010a14,
+        0x10a1500010a18,
+        0x10a1900010a36,
+        0x10a3800010a3b,
+        0x10a3f00010a40,
+        0x10a6000010a7d,
+        0x10a8000010a9d,
+        0x10ac000010ac8,
+        0x10ac900010ae7,
+        0x10b0000010b36,
+        0x10b4000010b56,
+        0x10b6000010b73,
+        0x10b8000010b92,
+        0x10c0000010c49,
+        0x10cc000010cf3,
+        0x10d0000010d28,
+        0x10d3000010d3a,
+        0x10e8000010eaa,
+        0x10eab00010ead,
+        0x10eb000010eb2,
+        0x10efd00010f1d,
+        0x10f2700010f28,
+        0x10f3000010f51,
+        0x10f7000010f86,
+        0x10fb000010fc5,
+        0x10fe000010ff7,
+        0x1100000011047,
+        0x1106600011076,
+        0x1107f000110bb,
+        0x110c2000110c3,
+        0x110d0000110e9,
+        0x110f0000110fa,
+        0x1110000011135,
+        0x1113600011140,
+        0x1114400011148,
+        0x1115000011174,
+        0x1117600011177,
+        0x11180000111c5,
+        0x111c9000111cd,
+        0x111ce000111db,
+        0x111dc000111dd,
+        0x1120000011212,
+        0x1121300011238,
+        0x1123e00011242,
+        0x1128000011287,
+        0x1128800011289,
+        0x1128a0001128e,
+        0x1128f0001129e,
+        0x1129f000112a9,
+        0x112b0000112eb,
+        0x112f0000112fa,
+        0x1130000011304,
+        0x113050001130d,
+        0x1130f00011311,
+        0x1131300011329,
+        0x1132a00011331,
+        0x1133200011334,
+        0x113350001133a,
+        0x1133b00011345,
+        0x1134700011349,
+        0x1134b0001134e,
+        0x1135000011351,
+        0x1135700011358,
+        0x1135d00011364,
+        0x113660001136d,
+        0x1137000011375,
+        0x114000001144b,
+        0x114500001145a,
+        0x1145e00011462,
+        0x11480000114c6,
+        0x114c7000114c8,
+        0x114d0000114da,
+        0x11580000115b6,
+        0x115b8000115c1,
+        0x115d8000115de,
+        0x1160000011641,
+        0x1164400011645,
+        0x116500001165a,
+        0x11680000116b9,
+        0x116c0000116ca,
+        0x117000001171b,
+        0x1171d0001172c,
+        0x117300001173a,
+        0x1174000011747,
+        0x118000001183b,
+        0x118c0000118ea,
+        0x118ff00011907,
+        0x119090001190a,
+        0x1190c00011914,
+        0x1191500011917,
+        0x1191800011936,
+        0x1193700011939,
+        0x1193b00011944,
+        0x119500001195a,
+        0x119a0000119a8,
+        0x119aa000119d8,
+        0x119da000119e2,
+        0x119e3000119e5,
+        0x11a0000011a3f,
+        0x11a4700011a48,
+        0x11a5000011a9a,
+        0x11a9d00011a9e,
+        0x11ab000011af9,
+        0x11c0000011c09,
+        0x11c0a00011c37,
+        0x11c3800011c41,
+        0x11c5000011c5a,
+        0x11c7200011c90,
+        0x11c9200011ca8,
+        0x11ca900011cb7,
+        0x11d0000011d07,
+        0x11d0800011d0a,
+        0x11d0b00011d37,
+        0x11d3a00011d3b,
+        0x11d3c00011d3e,
+        0x11d3f00011d48,
+        0x11d5000011d5a,
+        0x11d6000011d66,
+        0x11d6700011d69,
+        0x11d6a00011d8f,
+        0x11d9000011d92,
+        0x11d9300011d99,
+        0x11da000011daa,
+        0x11ee000011ef7,
+        0x11f0000011f11,
+        0x11f1200011f3b,
+        0x11f3e00011f43,
+        0x11f5000011f5a,
+        0x11fb000011fb1,
+        0x120000001239a,
+        0x1248000012544,
+        0x12f9000012ff1,
+        0x1300000013430,
+        0x1344000013456,
+        0x1440000014647,
+        0x1680000016a39,
+        0x16a4000016a5f,
+        0x16a6000016a6a,
+        0x16a7000016abf,
+        0x16ac000016aca,
+        0x16ad000016aee,
+        0x16af000016af5,
+        0x16b0000016b37,
+        0x16b4000016b44,
+        0x16b5000016b5a,
+        0x16b6300016b78,
+        0x16b7d00016b90,
+        0x16e6000016e80,
+        0x16f0000016f4b,
+        0x16f4f00016f88,
+        0x16f8f00016fa0,
+        0x16fe000016fe2,
+        0x16fe300016fe5,
+        0x16ff000016ff2,
+        0x17000000187f8,
+        0x1880000018cd6,
+        0x18d0000018d09,
+        0x1aff00001aff4,
+        0x1aff50001affc,
+        0x1affd0001afff,
+        0x1b0000001b123,
+        0x1b1320001b133,
+        0x1b1500001b153,
+        0x1b1550001b156,
+        0x1b1640001b168,
+        0x1b1700001b2fc,
+        0x1bc000001bc6b,
+        0x1bc700001bc7d,
+        0x1bc800001bc89,
+        0x1bc900001bc9a,
+        0x1bc9d0001bc9f,
+        0x1cf000001cf2e,
+        0x1cf300001cf47,
+        0x1da000001da37,
+        0x1da3b0001da6d,
+        0x1da750001da76,
+        0x1da840001da85,
+        0x1da9b0001daa0,
+        0x1daa10001dab0,
+        0x1df000001df1f,
+        0x1df250001df2b,
+        0x1e0000001e007,
+        0x1e0080001e019,
+        0x1e01b0001e022,
+        0x1e0230001e025,
+        0x1e0260001e02b,
+        0x1e08f0001e090,
+        0x1e1000001e12d,
+        0x1e1300001e13e,
+        0x1e1400001e14a,
+        0x1e14e0001e14f,
+        0x1e2900001e2af,
+        0x1e2c00001e2fa,
+        0x1e4d00001e4fa,
+        0x1e7e00001e7e7,
+        0x1e7e80001e7ec,
+        0x1e7ed0001e7ef,
+        0x1e7f00001e7ff,
+        0x1e8000001e8c5,
+        0x1e8d00001e8d7,
+        0x1e9220001e94c,
+        0x1e9500001e95a,
+        0x200000002a6e0,
+        0x2a7000002b73a,
+        0x2b7400002b81e,
+        0x2b8200002cea2,
+        0x2ceb00002ebe1,
+        0x2ebf00002ee5e,
+        0x300000003134b,
+        0x31350000323b0,
+    ),
+    'CONTEXTJ': (
+        0x200c0000200e,
+    ),
+    'CONTEXTO': (
+        0xb7000000b8,
+        0x37500000376,
+        0x5f3000005f5,
+        0x6600000066a,
+        0x6f0000006fa,
+        0x30fb000030fc,
+    ),
+}
diff --git a/llm/Lib/site-packages/idna/intranges.py b/llm/Lib/site-packages/idna/intranges.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a43b0475347cb50d0d65ada1000a82eeca9e882
--- /dev/null
+++ b/llm/Lib/site-packages/idna/intranges.py
@@ -0,0 +1,54 @@
+"""
+Given a list of integers, made up of (hopefully) a small number of long runs
+of consecutive integers, compute a representation of the form
+((start1, end1), (start2, end2) ...). Then answer the question "was x present
+in the original list?" in time O(log(# runs)).
+"""
+
+import bisect
+from typing import List, Tuple
+
+def intranges_from_list(list_: List[int]) -> Tuple[int, ...]:
+    """Represent a list of integers as a sequence of ranges:
+    ((start_0, end_0), (start_1, end_1), ...), such that the original
+    integers are exactly those x such that start_i <= x < end_i for some i.
+
+    Ranges are encoded as single integers (start << 32 | end), not as tuples.
+    """
+
+    sorted_list = sorted(list_)
+    ranges = []
+    last_write = -1
+    for i in range(len(sorted_list)):
+        if i+1 < len(sorted_list):
+            if sorted_list[i] == sorted_list[i+1]-1:
+                continue
+        current_range = sorted_list[last_write+1:i+1]
+        ranges.append(_encode_range(current_range[0], current_range[-1] + 1))
+        last_write = i
+
+    return tuple(ranges)
+
+def _encode_range(start: int, end: int) -> int:
+    return (start << 32) | end
+
+def _decode_range(r: int) -> Tuple[int, int]:
+    return (r >> 32), (r & ((1 << 32) - 1))
+
+
+def intranges_contain(int_: int, ranges: Tuple[int, ...]) -> bool:
+    """Determine if `int_` falls into one of the ranges in `ranges`."""
+    tuple_ = _encode_range(int_, 0)
+    pos = bisect.bisect_left(ranges, tuple_)
+    # we could be immediately ahead of a tuple (start, end)
+    # with start < int_ <= end
+    if pos > 0:
+        left, right = _decode_range(ranges[pos-1])
+        if left <= int_ < right:
+            return True
+    # or we could be immediately behind a tuple (int_, end)
+    if pos < len(ranges):
+        left, _ = _decode_range(ranges[pos])
+        if left == int_:
+            return True
+    return False
diff --git a/llm/Lib/site-packages/idna/package_data.py b/llm/Lib/site-packages/idna/package_data.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed8111336331554058dfb0a8d5dcbc0defc62dfe
--- /dev/null
+++ b/llm/Lib/site-packages/idna/package_data.py
@@ -0,0 +1,2 @@
+__version__ = '3.7'
+
diff --git a/llm/Lib/site-packages/idna/py.typed b/llm/Lib/site-packages/idna/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/idna/uts46data.py b/llm/Lib/site-packages/idna/uts46data.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a1eddbfd7543b5e2d866c320c3aebfc2bd5ba0e
--- /dev/null
+++ b/llm/Lib/site-packages/idna/uts46data.py
@@ -0,0 +1,8598 @@
+# This file is automatically generated by tools/idna-data
+# vim: set fileencoding=utf-8 :
+
+from typing import List, Tuple, Union
+
+
+"""IDNA Mapping Table from UTS46."""
+
+
+__version__ = '15.1.0'
+def _seg_0() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x0, '3'),
+    (0x1, '3'),
+    (0x2, '3'),
+    (0x3, '3'),
+    (0x4, '3'),
+    (0x5, '3'),
+    (0x6, '3'),
+    (0x7, '3'),
+    (0x8, '3'),
+    (0x9, '3'),
+    (0xA, '3'),
+    (0xB, '3'),
+    (0xC, '3'),
+    (0xD, '3'),
+    (0xE, '3'),
+    (0xF, '3'),
+    (0x10, '3'),
+    (0x11, '3'),
+    (0x12, '3'),
+    (0x13, '3'),
+    (0x14, '3'),
+    (0x15, '3'),
+    (0x16, '3'),
+    (0x17, '3'),
+    (0x18, '3'),
+    (0x19, '3'),
+    (0x1A, '3'),
+    (0x1B, '3'),
+    (0x1C, '3'),
+    (0x1D, '3'),
+    (0x1E, '3'),
+    (0x1F, '3'),
+    (0x20, '3'),
+    (0x21, '3'),
+    (0x22, '3'),
+    (0x23, '3'),
+    (0x24, '3'),
+    (0x25, '3'),
+    (0x26, '3'),
+    (0x27, '3'),
+    (0x28, '3'),
+    (0x29, '3'),
+    (0x2A, '3'),
+    (0x2B, '3'),
+    (0x2C, '3'),
+    (0x2D, 'V'),
+    (0x2E, 'V'),
+    (0x2F, '3'),
+    (0x30, 'V'),
+    (0x31, 'V'),
+    (0x32, 'V'),
+    (0x33, 'V'),
+    (0x34, 'V'),
+    (0x35, 'V'),
+    (0x36, 'V'),
+    (0x37, 'V'),
+    (0x38, 'V'),
+    (0x39, 'V'),
+    (0x3A, '3'),
+    (0x3B, '3'),
+    (0x3C, '3'),
+    (0x3D, '3'),
+    (0x3E, '3'),
+    (0x3F, '3'),
+    (0x40, '3'),
+    (0x41, 'M', 'a'),
+    (0x42, 'M', 'b'),
+    (0x43, 'M', 'c'),
+    (0x44, 'M', 'd'),
+    (0x45, 'M', 'e'),
+    (0x46, 'M', 'f'),
+    (0x47, 'M', 'g'),
+    (0x48, 'M', 'h'),
+    (0x49, 'M', 'i'),
+    (0x4A, 'M', 'j'),
+    (0x4B, 'M', 'k'),
+    (0x4C, 'M', 'l'),
+    (0x4D, 'M', 'm'),
+    (0x4E, 'M', 'n'),
+    (0x4F, 'M', 'o'),
+    (0x50, 'M', 'p'),
+    (0x51, 'M', 'q'),
+    (0x52, 'M', 'r'),
+    (0x53, 'M', 's'),
+    (0x54, 'M', 't'),
+    (0x55, 'M', 'u'),
+    (0x56, 'M', 'v'),
+    (0x57, 'M', 'w'),
+    (0x58, 'M', 'x'),
+    (0x59, 'M', 'y'),
+    (0x5A, 'M', 'z'),
+    (0x5B, '3'),
+    (0x5C, '3'),
+    (0x5D, '3'),
+    (0x5E, '3'),
+    (0x5F, '3'),
+    (0x60, '3'),
+    (0x61, 'V'),
+    (0x62, 'V'),
+    (0x63, 'V'),
+    ]
+
+def _seg_1() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x64, 'V'),
+    (0x65, 'V'),
+    (0x66, 'V'),
+    (0x67, 'V'),
+    (0x68, 'V'),
+    (0x69, 'V'),
+    (0x6A, 'V'),
+    (0x6B, 'V'),
+    (0x6C, 'V'),
+    (0x6D, 'V'),
+    (0x6E, 'V'),
+    (0x6F, 'V'),
+    (0x70, 'V'),
+    (0x71, 'V'),
+    (0x72, 'V'),
+    (0x73, 'V'),
+    (0x74, 'V'),
+    (0x75, 'V'),
+    (0x76, 'V'),
+    (0x77, 'V'),
+    (0x78, 'V'),
+    (0x79, 'V'),
+    (0x7A, 'V'),
+    (0x7B, '3'),
+    (0x7C, '3'),
+    (0x7D, '3'),
+    (0x7E, '3'),
+    (0x7F, '3'),
+    (0x80, 'X'),
+    (0x81, 'X'),
+    (0x82, 'X'),
+    (0x83, 'X'),
+    (0x84, 'X'),
+    (0x85, 'X'),
+    (0x86, 'X'),
+    (0x87, 'X'),
+    (0x88, 'X'),
+    (0x89, 'X'),
+    (0x8A, 'X'),
+    (0x8B, 'X'),
+    (0x8C, 'X'),
+    (0x8D, 'X'),
+    (0x8E, 'X'),
+    (0x8F, 'X'),
+    (0x90, 'X'),
+    (0x91, 'X'),
+    (0x92, 'X'),
+    (0x93, 'X'),
+    (0x94, 'X'),
+    (0x95, 'X'),
+    (0x96, 'X'),
+    (0x97, 'X'),
+    (0x98, 'X'),
+    (0x99, 'X'),
+    (0x9A, 'X'),
+    (0x9B, 'X'),
+    (0x9C, 'X'),
+    (0x9D, 'X'),
+    (0x9E, 'X'),
+    (0x9F, 'X'),
+    (0xA0, '3', ' '),
+    (0xA1, 'V'),
+    (0xA2, 'V'),
+    (0xA3, 'V'),
+    (0xA4, 'V'),
+    (0xA5, 'V'),
+    (0xA6, 'V'),
+    (0xA7, 'V'),
+    (0xA8, '3', ' ̈'),
+    (0xA9, 'V'),
+    (0xAA, 'M', 'a'),
+    (0xAB, 'V'),
+    (0xAC, 'V'),
+    (0xAD, 'I'),
+    (0xAE, 'V'),
+    (0xAF, '3', ' ̄'),
+    (0xB0, 'V'),
+    (0xB1, 'V'),
+    (0xB2, 'M', '2'),
+    (0xB3, 'M', '3'),
+    (0xB4, '3', ' ́'),
+    (0xB5, 'M', 'μ'),
+    (0xB6, 'V'),
+    (0xB7, 'V'),
+    (0xB8, '3', ' ̧'),
+    (0xB9, 'M', '1'),
+    (0xBA, 'M', 'o'),
+    (0xBB, 'V'),
+    (0xBC, 'M', '1⁄4'),
+    (0xBD, 'M', '1⁄2'),
+    (0xBE, 'M', '3⁄4'),
+    (0xBF, 'V'),
+    (0xC0, 'M', 'à'),
+    (0xC1, 'M', 'á'),
+    (0xC2, 'M', 'â'),
+    (0xC3, 'M', 'ã'),
+    (0xC4, 'M', 'ä'),
+    (0xC5, 'M', 'å'),
+    (0xC6, 'M', 'æ'),
+    (0xC7, 'M', 'ç'),
+    ]
+
+def _seg_2() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xC8, 'M', 'è'),
+    (0xC9, 'M', 'é'),
+    (0xCA, 'M', 'ê'),
+    (0xCB, 'M', 'ë'),
+    (0xCC, 'M', 'ì'),
+    (0xCD, 'M', 'í'),
+    (0xCE, 'M', 'î'),
+    (0xCF, 'M', 'ï'),
+    (0xD0, 'M', 'ð'),
+    (0xD1, 'M', 'ñ'),
+    (0xD2, 'M', 'ò'),
+    (0xD3, 'M', 'ó'),
+    (0xD4, 'M', 'ô'),
+    (0xD5, 'M', 'õ'),
+    (0xD6, 'M', 'ö'),
+    (0xD7, 'V'),
+    (0xD8, 'M', 'ø'),
+    (0xD9, 'M', 'ù'),
+    (0xDA, 'M', 'ú'),
+    (0xDB, 'M', 'û'),
+    (0xDC, 'M', 'ü'),
+    (0xDD, 'M', 'ý'),
+    (0xDE, 'M', 'þ'),
+    (0xDF, 'D', 'ss'),
+    (0xE0, 'V'),
+    (0xE1, 'V'),
+    (0xE2, 'V'),
+    (0xE3, 'V'),
+    (0xE4, 'V'),
+    (0xE5, 'V'),
+    (0xE6, 'V'),
+    (0xE7, 'V'),
+    (0xE8, 'V'),
+    (0xE9, 'V'),
+    (0xEA, 'V'),
+    (0xEB, 'V'),
+    (0xEC, 'V'),
+    (0xED, 'V'),
+    (0xEE, 'V'),
+    (0xEF, 'V'),
+    (0xF0, 'V'),
+    (0xF1, 'V'),
+    (0xF2, 'V'),
+    (0xF3, 'V'),
+    (0xF4, 'V'),
+    (0xF5, 'V'),
+    (0xF6, 'V'),
+    (0xF7, 'V'),
+    (0xF8, 'V'),
+    (0xF9, 'V'),
+    (0xFA, 'V'),
+    (0xFB, 'V'),
+    (0xFC, 'V'),
+    (0xFD, 'V'),
+    (0xFE, 'V'),
+    (0xFF, 'V'),
+    (0x100, 'M', 'ā'),
+    (0x101, 'V'),
+    (0x102, 'M', 'ă'),
+    (0x103, 'V'),
+    (0x104, 'M', 'ą'),
+    (0x105, 'V'),
+    (0x106, 'M', 'ć'),
+    (0x107, 'V'),
+    (0x108, 'M', 'ĉ'),
+    (0x109, 'V'),
+    (0x10A, 'M', 'ċ'),
+    (0x10B, 'V'),
+    (0x10C, 'M', 'č'),
+    (0x10D, 'V'),
+    (0x10E, 'M', 'ď'),
+    (0x10F, 'V'),
+    (0x110, 'M', 'đ'),
+    (0x111, 'V'),
+    (0x112, 'M', 'ē'),
+    (0x113, 'V'),
+    (0x114, 'M', 'ĕ'),
+    (0x115, 'V'),
+    (0x116, 'M', 'ė'),
+    (0x117, 'V'),
+    (0x118, 'M', 'ę'),
+    (0x119, 'V'),
+    (0x11A, 'M', 'ě'),
+    (0x11B, 'V'),
+    (0x11C, 'M', 'ĝ'),
+    (0x11D, 'V'),
+    (0x11E, 'M', 'ğ'),
+    (0x11F, 'V'),
+    (0x120, 'M', 'ġ'),
+    (0x121, 'V'),
+    (0x122, 'M', 'ģ'),
+    (0x123, 'V'),
+    (0x124, 'M', 'ĥ'),
+    (0x125, 'V'),
+    (0x126, 'M', 'ħ'),
+    (0x127, 'V'),
+    (0x128, 'M', 'ĩ'),
+    (0x129, 'V'),
+    (0x12A, 'M', 'ī'),
+    (0x12B, 'V'),
+    ]
+
+def _seg_3() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x12C, 'M', 'ĭ'),
+    (0x12D, 'V'),
+    (0x12E, 'M', 'į'),
+    (0x12F, 'V'),
+    (0x130, 'M', 'i̇'),
+    (0x131, 'V'),
+    (0x132, 'M', 'ij'),
+    (0x134, 'M', 'ĵ'),
+    (0x135, 'V'),
+    (0x136, 'M', 'ķ'),
+    (0x137, 'V'),
+    (0x139, 'M', 'ĺ'),
+    (0x13A, 'V'),
+    (0x13B, 'M', 'ļ'),
+    (0x13C, 'V'),
+    (0x13D, 'M', 'ľ'),
+    (0x13E, 'V'),
+    (0x13F, 'M', 'l·'),
+    (0x141, 'M', 'ł'),
+    (0x142, 'V'),
+    (0x143, 'M', 'ń'),
+    (0x144, 'V'),
+    (0x145, 'M', 'ņ'),
+    (0x146, 'V'),
+    (0x147, 'M', 'ň'),
+    (0x148, 'V'),
+    (0x149, 'M', 'ʼn'),
+    (0x14A, 'M', 'ŋ'),
+    (0x14B, 'V'),
+    (0x14C, 'M', 'ō'),
+    (0x14D, 'V'),
+    (0x14E, 'M', 'ŏ'),
+    (0x14F, 'V'),
+    (0x150, 'M', 'ő'),
+    (0x151, 'V'),
+    (0x152, 'M', 'œ'),
+    (0x153, 'V'),
+    (0x154, 'M', 'ŕ'),
+    (0x155, 'V'),
+    (0x156, 'M', 'ŗ'),
+    (0x157, 'V'),
+    (0x158, 'M', 'ř'),
+    (0x159, 'V'),
+    (0x15A, 'M', 'ś'),
+    (0x15B, 'V'),
+    (0x15C, 'M', 'ŝ'),
+    (0x15D, 'V'),
+    (0x15E, 'M', 'ş'),
+    (0x15F, 'V'),
+    (0x160, 'M', 'š'),
+    (0x161, 'V'),
+    (0x162, 'M', 'ţ'),
+    (0x163, 'V'),
+    (0x164, 'M', 'ť'),
+    (0x165, 'V'),
+    (0x166, 'M', 'ŧ'),
+    (0x167, 'V'),
+    (0x168, 'M', 'ũ'),
+    (0x169, 'V'),
+    (0x16A, 'M', 'ū'),
+    (0x16B, 'V'),
+    (0x16C, 'M', 'ŭ'),
+    (0x16D, 'V'),
+    (0x16E, 'M', 'ů'),
+    (0x16F, 'V'),
+    (0x170, 'M', 'ű'),
+    (0x171, 'V'),
+    (0x172, 'M', 'ų'),
+    (0x173, 'V'),
+    (0x174, 'M', 'ŵ'),
+    (0x175, 'V'),
+    (0x176, 'M', 'ŷ'),
+    (0x177, 'V'),
+    (0x178, 'M', 'ÿ'),
+    (0x179, 'M', 'ź'),
+    (0x17A, 'V'),
+    (0x17B, 'M', 'ż'),
+    (0x17C, 'V'),
+    (0x17D, 'M', 'ž'),
+    (0x17E, 'V'),
+    (0x17F, 'M', 's'),
+    (0x180, 'V'),
+    (0x181, 'M', 'ɓ'),
+    (0x182, 'M', 'ƃ'),
+    (0x183, 'V'),
+    (0x184, 'M', 'ƅ'),
+    (0x185, 'V'),
+    (0x186, 'M', 'ɔ'),
+    (0x187, 'M', 'ƈ'),
+    (0x188, 'V'),
+    (0x189, 'M', 'ɖ'),
+    (0x18A, 'M', 'ɗ'),
+    (0x18B, 'M', 'ƌ'),
+    (0x18C, 'V'),
+    (0x18E, 'M', 'ǝ'),
+    (0x18F, 'M', 'ə'),
+    (0x190, 'M', 'ɛ'),
+    (0x191, 'M', 'ƒ'),
+    (0x192, 'V'),
+    (0x193, 'M', 'ɠ'),
+    ]
+
+def _seg_4() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x194, 'M', 'ɣ'),
+    (0x195, 'V'),
+    (0x196, 'M', 'ɩ'),
+    (0x197, 'M', 'ɨ'),
+    (0x198, 'M', 'ƙ'),
+    (0x199, 'V'),
+    (0x19C, 'M', 'ɯ'),
+    (0x19D, 'M', 'ɲ'),
+    (0x19E, 'V'),
+    (0x19F, 'M', 'ɵ'),
+    (0x1A0, 'M', 'ơ'),
+    (0x1A1, 'V'),
+    (0x1A2, 'M', 'ƣ'),
+    (0x1A3, 'V'),
+    (0x1A4, 'M', 'ƥ'),
+    (0x1A5, 'V'),
+    (0x1A6, 'M', 'ʀ'),
+    (0x1A7, 'M', 'ƨ'),
+    (0x1A8, 'V'),
+    (0x1A9, 'M', 'ʃ'),
+    (0x1AA, 'V'),
+    (0x1AC, 'M', 'ƭ'),
+    (0x1AD, 'V'),
+    (0x1AE, 'M', 'ʈ'),
+    (0x1AF, 'M', 'ư'),
+    (0x1B0, 'V'),
+    (0x1B1, 'M', 'ʊ'),
+    (0x1B2, 'M', 'ʋ'),
+    (0x1B3, 'M', 'ƴ'),
+    (0x1B4, 'V'),
+    (0x1B5, 'M', 'ƶ'),
+    (0x1B6, 'V'),
+    (0x1B7, 'M', 'ʒ'),
+    (0x1B8, 'M', 'ƹ'),
+    (0x1B9, 'V'),
+    (0x1BC, 'M', 'ƽ'),
+    (0x1BD, 'V'),
+    (0x1C4, 'M', 'dž'),
+    (0x1C7, 'M', 'lj'),
+    (0x1CA, 'M', 'nj'),
+    (0x1CD, 'M', 'ǎ'),
+    (0x1CE, 'V'),
+    (0x1CF, 'M', 'ǐ'),
+    (0x1D0, 'V'),
+    (0x1D1, 'M', 'ǒ'),
+    (0x1D2, 'V'),
+    (0x1D3, 'M', 'ǔ'),
+    (0x1D4, 'V'),
+    (0x1D5, 'M', 'ǖ'),
+    (0x1D6, 'V'),
+    (0x1D7, 'M', 'ǘ'),
+    (0x1D8, 'V'),
+    (0x1D9, 'M', 'ǚ'),
+    (0x1DA, 'V'),
+    (0x1DB, 'M', 'ǜ'),
+    (0x1DC, 'V'),
+    (0x1DE, 'M', 'ǟ'),
+    (0x1DF, 'V'),
+    (0x1E0, 'M', 'ǡ'),
+    (0x1E1, 'V'),
+    (0x1E2, 'M', 'ǣ'),
+    (0x1E3, 'V'),
+    (0x1E4, 'M', 'ǥ'),
+    (0x1E5, 'V'),
+    (0x1E6, 'M', 'ǧ'),
+    (0x1E7, 'V'),
+    (0x1E8, 'M', 'ǩ'),
+    (0x1E9, 'V'),
+    (0x1EA, 'M', 'ǫ'),
+    (0x1EB, 'V'),
+    (0x1EC, 'M', 'ǭ'),
+    (0x1ED, 'V'),
+    (0x1EE, 'M', 'ǯ'),
+    (0x1EF, 'V'),
+    (0x1F1, 'M', 'dz'),
+    (0x1F4, 'M', 'ǵ'),
+    (0x1F5, 'V'),
+    (0x1F6, 'M', 'ƕ'),
+    (0x1F7, 'M', 'ƿ'),
+    (0x1F8, 'M', 'ǹ'),
+    (0x1F9, 'V'),
+    (0x1FA, 'M', 'ǻ'),
+    (0x1FB, 'V'),
+    (0x1FC, 'M', 'ǽ'),
+    (0x1FD, 'V'),
+    (0x1FE, 'M', 'ǿ'),
+    (0x1FF, 'V'),
+    (0x200, 'M', 'ȁ'),
+    (0x201, 'V'),
+    (0x202, 'M', 'ȃ'),
+    (0x203, 'V'),
+    (0x204, 'M', 'ȅ'),
+    (0x205, 'V'),
+    (0x206, 'M', 'ȇ'),
+    (0x207, 'V'),
+    (0x208, 'M', 'ȉ'),
+    (0x209, 'V'),
+    (0x20A, 'M', 'ȋ'),
+    (0x20B, 'V'),
+    (0x20C, 'M', 'ȍ'),
+    ]
+
+def _seg_5() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x20D, 'V'),
+    (0x20E, 'M', 'ȏ'),
+    (0x20F, 'V'),
+    (0x210, 'M', 'ȑ'),
+    (0x211, 'V'),
+    (0x212, 'M', 'ȓ'),
+    (0x213, 'V'),
+    (0x214, 'M', 'ȕ'),
+    (0x215, 'V'),
+    (0x216, 'M', 'ȗ'),
+    (0x217, 'V'),
+    (0x218, 'M', 'ș'),
+    (0x219, 'V'),
+    (0x21A, 'M', 'ț'),
+    (0x21B, 'V'),
+    (0x21C, 'M', 'ȝ'),
+    (0x21D, 'V'),
+    (0x21E, 'M', 'ȟ'),
+    (0x21F, 'V'),
+    (0x220, 'M', 'ƞ'),
+    (0x221, 'V'),
+    (0x222, 'M', 'ȣ'),
+    (0x223, 'V'),
+    (0x224, 'M', 'ȥ'),
+    (0x225, 'V'),
+    (0x226, 'M', 'ȧ'),
+    (0x227, 'V'),
+    (0x228, 'M', 'ȩ'),
+    (0x229, 'V'),
+    (0x22A, 'M', 'ȫ'),
+    (0x22B, 'V'),
+    (0x22C, 'M', 'ȭ'),
+    (0x22D, 'V'),
+    (0x22E, 'M', 'ȯ'),
+    (0x22F, 'V'),
+    (0x230, 'M', 'ȱ'),
+    (0x231, 'V'),
+    (0x232, 'M', 'ȳ'),
+    (0x233, 'V'),
+    (0x23A, 'M', 'ⱥ'),
+    (0x23B, 'M', 'ȼ'),
+    (0x23C, 'V'),
+    (0x23D, 'M', 'ƚ'),
+    (0x23E, 'M', 'ⱦ'),
+    (0x23F, 'V'),
+    (0x241, 'M', 'ɂ'),
+    (0x242, 'V'),
+    (0x243, 'M', 'ƀ'),
+    (0x244, 'M', 'ʉ'),
+    (0x245, 'M', 'ʌ'),
+    (0x246, 'M', 'ɇ'),
+    (0x247, 'V'),
+    (0x248, 'M', 'ɉ'),
+    (0x249, 'V'),
+    (0x24A, 'M', 'ɋ'),
+    (0x24B, 'V'),
+    (0x24C, 'M', 'ɍ'),
+    (0x24D, 'V'),
+    (0x24E, 'M', 'ɏ'),
+    (0x24F, 'V'),
+    (0x2B0, 'M', 'h'),
+    (0x2B1, 'M', 'ɦ'),
+    (0x2B2, 'M', 'j'),
+    (0x2B3, 'M', 'r'),
+    (0x2B4, 'M', 'ɹ'),
+    (0x2B5, 'M', 'ɻ'),
+    (0x2B6, 'M', 'ʁ'),
+    (0x2B7, 'M', 'w'),
+    (0x2B8, 'M', 'y'),
+    (0x2B9, 'V'),
+    (0x2D8, '3', ' ̆'),
+    (0x2D9, '3', ' ̇'),
+    (0x2DA, '3', ' ̊'),
+    (0x2DB, '3', ' ̨'),
+    (0x2DC, '3', ' ̃'),
+    (0x2DD, '3', ' ̋'),
+    (0x2DE, 'V'),
+    (0x2E0, 'M', 'ɣ'),
+    (0x2E1, 'M', 'l'),
+    (0x2E2, 'M', 's'),
+    (0x2E3, 'M', 'x'),
+    (0x2E4, 'M', 'ʕ'),
+    (0x2E5, 'V'),
+    (0x340, 'M', '̀'),
+    (0x341, 'M', '́'),
+    (0x342, 'V'),
+    (0x343, 'M', '̓'),
+    (0x344, 'M', '̈́'),
+    (0x345, 'M', 'ι'),
+    (0x346, 'V'),
+    (0x34F, 'I'),
+    (0x350, 'V'),
+    (0x370, 'M', 'ͱ'),
+    (0x371, 'V'),
+    (0x372, 'M', 'ͳ'),
+    (0x373, 'V'),
+    (0x374, 'M', 'ʹ'),
+    (0x375, 'V'),
+    (0x376, 'M', 'ͷ'),
+    (0x377, 'V'),
+    ]
+
+def _seg_6() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x378, 'X'),
+    (0x37A, '3', ' ι'),
+    (0x37B, 'V'),
+    (0x37E, '3', ';'),
+    (0x37F, 'M', 'ϳ'),
+    (0x380, 'X'),
+    (0x384, '3', ' ́'),
+    (0x385, '3', ' ̈́'),
+    (0x386, 'M', 'ά'),
+    (0x387, 'M', '·'),
+    (0x388, 'M', 'έ'),
+    (0x389, 'M', 'ή'),
+    (0x38A, 'M', 'ί'),
+    (0x38B, 'X'),
+    (0x38C, 'M', 'ό'),
+    (0x38D, 'X'),
+    (0x38E, 'M', 'ύ'),
+    (0x38F, 'M', 'ώ'),
+    (0x390, 'V'),
+    (0x391, 'M', 'α'),
+    (0x392, 'M', 'β'),
+    (0x393, 'M', 'γ'),
+    (0x394, 'M', 'δ'),
+    (0x395, 'M', 'ε'),
+    (0x396, 'M', 'ζ'),
+    (0x397, 'M', 'η'),
+    (0x398, 'M', 'θ'),
+    (0x399, 'M', 'ι'),
+    (0x39A, 'M', 'κ'),
+    (0x39B, 'M', 'λ'),
+    (0x39C, 'M', 'μ'),
+    (0x39D, 'M', 'ν'),
+    (0x39E, 'M', 'ξ'),
+    (0x39F, 'M', 'ο'),
+    (0x3A0, 'M', 'π'),
+    (0x3A1, 'M', 'ρ'),
+    (0x3A2, 'X'),
+    (0x3A3, 'M', 'σ'),
+    (0x3A4, 'M', 'τ'),
+    (0x3A5, 'M', 'υ'),
+    (0x3A6, 'M', 'φ'),
+    (0x3A7, 'M', 'χ'),
+    (0x3A8, 'M', 'ψ'),
+    (0x3A9, 'M', 'ω'),
+    (0x3AA, 'M', 'ϊ'),
+    (0x3AB, 'M', 'ϋ'),
+    (0x3AC, 'V'),
+    (0x3C2, 'D', 'σ'),
+    (0x3C3, 'V'),
+    (0x3CF, 'M', 'ϗ'),
+    (0x3D0, 'M', 'β'),
+    (0x3D1, 'M', 'θ'),
+    (0x3D2, 'M', 'υ'),
+    (0x3D3, 'M', 'ύ'),
+    (0x3D4, 'M', 'ϋ'),
+    (0x3D5, 'M', 'φ'),
+    (0x3D6, 'M', 'π'),
+    (0x3D7, 'V'),
+    (0x3D8, 'M', 'ϙ'),
+    (0x3D9, 'V'),
+    (0x3DA, 'M', 'ϛ'),
+    (0x3DB, 'V'),
+    (0x3DC, 'M', 'ϝ'),
+    (0x3DD, 'V'),
+    (0x3DE, 'M', 'ϟ'),
+    (0x3DF, 'V'),
+    (0x3E0, 'M', 'ϡ'),
+    (0x3E1, 'V'),
+    (0x3E2, 'M', 'ϣ'),
+    (0x3E3, 'V'),
+    (0x3E4, 'M', 'ϥ'),
+    (0x3E5, 'V'),
+    (0x3E6, 'M', 'ϧ'),
+    (0x3E7, 'V'),
+    (0x3E8, 'M', 'ϩ'),
+    (0x3E9, 'V'),
+    (0x3EA, 'M', 'ϫ'),
+    (0x3EB, 'V'),
+    (0x3EC, 'M', 'ϭ'),
+    (0x3ED, 'V'),
+    (0x3EE, 'M', 'ϯ'),
+    (0x3EF, 'V'),
+    (0x3F0, 'M', 'κ'),
+    (0x3F1, 'M', 'ρ'),
+    (0x3F2, 'M', 'σ'),
+    (0x3F3, 'V'),
+    (0x3F4, 'M', 'θ'),
+    (0x3F5, 'M', 'ε'),
+    (0x3F6, 'V'),
+    (0x3F7, 'M', 'ϸ'),
+    (0x3F8, 'V'),
+    (0x3F9, 'M', 'σ'),
+    (0x3FA, 'M', 'ϻ'),
+    (0x3FB, 'V'),
+    (0x3FD, 'M', 'ͻ'),
+    (0x3FE, 'M', 'ͼ'),
+    (0x3FF, 'M', 'ͽ'),
+    (0x400, 'M', 'ѐ'),
+    (0x401, 'M', 'ё'),
+    (0x402, 'M', 'ђ'),
+    ]
+
+def _seg_7() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x403, 'M', 'ѓ'),
+    (0x404, 'M', 'є'),
+    (0x405, 'M', 'ѕ'),
+    (0x406, 'M', 'і'),
+    (0x407, 'M', 'ї'),
+    (0x408, 'M', 'ј'),
+    (0x409, 'M', 'љ'),
+    (0x40A, 'M', 'њ'),
+    (0x40B, 'M', 'ћ'),
+    (0x40C, 'M', 'ќ'),
+    (0x40D, 'M', 'ѝ'),
+    (0x40E, 'M', 'ў'),
+    (0x40F, 'M', 'џ'),
+    (0x410, 'M', 'а'),
+    (0x411, 'M', 'б'),
+    (0x412, 'M', 'в'),
+    (0x413, 'M', 'г'),
+    (0x414, 'M', 'д'),
+    (0x415, 'M', 'е'),
+    (0x416, 'M', 'ж'),
+    (0x417, 'M', 'з'),
+    (0x418, 'M', 'и'),
+    (0x419, 'M', 'й'),
+    (0x41A, 'M', 'к'),
+    (0x41B, 'M', 'л'),
+    (0x41C, 'M', 'м'),
+    (0x41D, 'M', 'н'),
+    (0x41E, 'M', 'о'),
+    (0x41F, 'M', 'п'),
+    (0x420, 'M', 'р'),
+    (0x421, 'M', 'с'),
+    (0x422, 'M', 'т'),
+    (0x423, 'M', 'у'),
+    (0x424, 'M', 'ф'),
+    (0x425, 'M', 'х'),
+    (0x426, 'M', 'ц'),
+    (0x427, 'M', 'ч'),
+    (0x428, 'M', 'ш'),
+    (0x429, 'M', 'щ'),
+    (0x42A, 'M', 'ъ'),
+    (0x42B, 'M', 'ы'),
+    (0x42C, 'M', 'ь'),
+    (0x42D, 'M', 'э'),
+    (0x42E, 'M', 'ю'),
+    (0x42F, 'M', 'я'),
+    (0x430, 'V'),
+    (0x460, 'M', 'ѡ'),
+    (0x461, 'V'),
+    (0x462, 'M', 'ѣ'),
+    (0x463, 'V'),
+    (0x464, 'M', 'ѥ'),
+    (0x465, 'V'),
+    (0x466, 'M', 'ѧ'),
+    (0x467, 'V'),
+    (0x468, 'M', 'ѩ'),
+    (0x469, 'V'),
+    (0x46A, 'M', 'ѫ'),
+    (0x46B, 'V'),
+    (0x46C, 'M', 'ѭ'),
+    (0x46D, 'V'),
+    (0x46E, 'M', 'ѯ'),
+    (0x46F, 'V'),
+    (0x470, 'M', 'ѱ'),
+    (0x471, 'V'),
+    (0x472, 'M', 'ѳ'),
+    (0x473, 'V'),
+    (0x474, 'M', 'ѵ'),
+    (0x475, 'V'),
+    (0x476, 'M', 'ѷ'),
+    (0x477, 'V'),
+    (0x478, 'M', 'ѹ'),
+    (0x479, 'V'),
+    (0x47A, 'M', 'ѻ'),
+    (0x47B, 'V'),
+    (0x47C, 'M', 'ѽ'),
+    (0x47D, 'V'),
+    (0x47E, 'M', 'ѿ'),
+    (0x47F, 'V'),
+    (0x480, 'M', 'ҁ'),
+    (0x481, 'V'),
+    (0x48A, 'M', 'ҋ'),
+    (0x48B, 'V'),
+    (0x48C, 'M', 'ҍ'),
+    (0x48D, 'V'),
+    (0x48E, 'M', 'ҏ'),
+    (0x48F, 'V'),
+    (0x490, 'M', 'ґ'),
+    (0x491, 'V'),
+    (0x492, 'M', 'ғ'),
+    (0x493, 'V'),
+    (0x494, 'M', 'ҕ'),
+    (0x495, 'V'),
+    (0x496, 'M', 'җ'),
+    (0x497, 'V'),
+    (0x498, 'M', 'ҙ'),
+    (0x499, 'V'),
+    (0x49A, 'M', 'қ'),
+    (0x49B, 'V'),
+    (0x49C, 'M', 'ҝ'),
+    (0x49D, 'V'),
+    ]
+
+def _seg_8() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x49E, 'M', 'ҟ'),
+    (0x49F, 'V'),
+    (0x4A0, 'M', 'ҡ'),
+    (0x4A1, 'V'),
+    (0x4A2, 'M', 'ң'),
+    (0x4A3, 'V'),
+    (0x4A4, 'M', 'ҥ'),
+    (0x4A5, 'V'),
+    (0x4A6, 'M', 'ҧ'),
+    (0x4A7, 'V'),
+    (0x4A8, 'M', 'ҩ'),
+    (0x4A9, 'V'),
+    (0x4AA, 'M', 'ҫ'),
+    (0x4AB, 'V'),
+    (0x4AC, 'M', 'ҭ'),
+    (0x4AD, 'V'),
+    (0x4AE, 'M', 'ү'),
+    (0x4AF, 'V'),
+    (0x4B0, 'M', 'ұ'),
+    (0x4B1, 'V'),
+    (0x4B2, 'M', 'ҳ'),
+    (0x4B3, 'V'),
+    (0x4B4, 'M', 'ҵ'),
+    (0x4B5, 'V'),
+    (0x4B6, 'M', 'ҷ'),
+    (0x4B7, 'V'),
+    (0x4B8, 'M', 'ҹ'),
+    (0x4B9, 'V'),
+    (0x4BA, 'M', 'һ'),
+    (0x4BB, 'V'),
+    (0x4BC, 'M', 'ҽ'),
+    (0x4BD, 'V'),
+    (0x4BE, 'M', 'ҿ'),
+    (0x4BF, 'V'),
+    (0x4C0, 'X'),
+    (0x4C1, 'M', 'ӂ'),
+    (0x4C2, 'V'),
+    (0x4C3, 'M', 'ӄ'),
+    (0x4C4, 'V'),
+    (0x4C5, 'M', 'ӆ'),
+    (0x4C6, 'V'),
+    (0x4C7, 'M', 'ӈ'),
+    (0x4C8, 'V'),
+    (0x4C9, 'M', 'ӊ'),
+    (0x4CA, 'V'),
+    (0x4CB, 'M', 'ӌ'),
+    (0x4CC, 'V'),
+    (0x4CD, 'M', 'ӎ'),
+    (0x4CE, 'V'),
+    (0x4D0, 'M', 'ӑ'),
+    (0x4D1, 'V'),
+    (0x4D2, 'M', 'ӓ'),
+    (0x4D3, 'V'),
+    (0x4D4, 'M', 'ӕ'),
+    (0x4D5, 'V'),
+    (0x4D6, 'M', 'ӗ'),
+    (0x4D7, 'V'),
+    (0x4D8, 'M', 'ә'),
+    (0x4D9, 'V'),
+    (0x4DA, 'M', 'ӛ'),
+    (0x4DB, 'V'),
+    (0x4DC, 'M', 'ӝ'),
+    (0x4DD, 'V'),
+    (0x4DE, 'M', 'ӟ'),
+    (0x4DF, 'V'),
+    (0x4E0, 'M', 'ӡ'),
+    (0x4E1, 'V'),
+    (0x4E2, 'M', 'ӣ'),
+    (0x4E3, 'V'),
+    (0x4E4, 'M', 'ӥ'),
+    (0x4E5, 'V'),
+    (0x4E6, 'M', 'ӧ'),
+    (0x4E7, 'V'),
+    (0x4E8, 'M', 'ө'),
+    (0x4E9, 'V'),
+    (0x4EA, 'M', 'ӫ'),
+    (0x4EB, 'V'),
+    (0x4EC, 'M', 'ӭ'),
+    (0x4ED, 'V'),
+    (0x4EE, 'M', 'ӯ'),
+    (0x4EF, 'V'),
+    (0x4F0, 'M', 'ӱ'),
+    (0x4F1, 'V'),
+    (0x4F2, 'M', 'ӳ'),
+    (0x4F3, 'V'),
+    (0x4F4, 'M', 'ӵ'),
+    (0x4F5, 'V'),
+    (0x4F6, 'M', 'ӷ'),
+    (0x4F7, 'V'),
+    (0x4F8, 'M', 'ӹ'),
+    (0x4F9, 'V'),
+    (0x4FA, 'M', 'ӻ'),
+    (0x4FB, 'V'),
+    (0x4FC, 'M', 'ӽ'),
+    (0x4FD, 'V'),
+    (0x4FE, 'M', 'ӿ'),
+    (0x4FF, 'V'),
+    (0x500, 'M', 'ԁ'),
+    (0x501, 'V'),
+    (0x502, 'M', 'ԃ'),
+    ]
+
+def _seg_9() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x503, 'V'),
+    (0x504, 'M', 'ԅ'),
+    (0x505, 'V'),
+    (0x506, 'M', 'ԇ'),
+    (0x507, 'V'),
+    (0x508, 'M', 'ԉ'),
+    (0x509, 'V'),
+    (0x50A, 'M', 'ԋ'),
+    (0x50B, 'V'),
+    (0x50C, 'M', 'ԍ'),
+    (0x50D, 'V'),
+    (0x50E, 'M', 'ԏ'),
+    (0x50F, 'V'),
+    (0x510, 'M', 'ԑ'),
+    (0x511, 'V'),
+    (0x512, 'M', 'ԓ'),
+    (0x513, 'V'),
+    (0x514, 'M', 'ԕ'),
+    (0x515, 'V'),
+    (0x516, 'M', 'ԗ'),
+    (0x517, 'V'),
+    (0x518, 'M', 'ԙ'),
+    (0x519, 'V'),
+    (0x51A, 'M', 'ԛ'),
+    (0x51B, 'V'),
+    (0x51C, 'M', 'ԝ'),
+    (0x51D, 'V'),
+    (0x51E, 'M', 'ԟ'),
+    (0x51F, 'V'),
+    (0x520, 'M', 'ԡ'),
+    (0x521, 'V'),
+    (0x522, 'M', 'ԣ'),
+    (0x523, 'V'),
+    (0x524, 'M', 'ԥ'),
+    (0x525, 'V'),
+    (0x526, 'M', 'ԧ'),
+    (0x527, 'V'),
+    (0x528, 'M', 'ԩ'),
+    (0x529, 'V'),
+    (0x52A, 'M', 'ԫ'),
+    (0x52B, 'V'),
+    (0x52C, 'M', 'ԭ'),
+    (0x52D, 'V'),
+    (0x52E, 'M', 'ԯ'),
+    (0x52F, 'V'),
+    (0x530, 'X'),
+    (0x531, 'M', 'ա'),
+    (0x532, 'M', 'բ'),
+    (0x533, 'M', 'գ'),
+    (0x534, 'M', 'դ'),
+    (0x535, 'M', 'ե'),
+    (0x536, 'M', 'զ'),
+    (0x537, 'M', 'է'),
+    (0x538, 'M', 'ը'),
+    (0x539, 'M', 'թ'),
+    (0x53A, 'M', 'ժ'),
+    (0x53B, 'M', 'ի'),
+    (0x53C, 'M', 'լ'),
+    (0x53D, 'M', 'խ'),
+    (0x53E, 'M', 'ծ'),
+    (0x53F, 'M', 'կ'),
+    (0x540, 'M', 'հ'),
+    (0x541, 'M', 'ձ'),
+    (0x542, 'M', 'ղ'),
+    (0x543, 'M', 'ճ'),
+    (0x544, 'M', 'մ'),
+    (0x545, 'M', 'յ'),
+    (0x546, 'M', 'ն'),
+    (0x547, 'M', 'շ'),
+    (0x548, 'M', 'ո'),
+    (0x549, 'M', 'չ'),
+    (0x54A, 'M', 'պ'),
+    (0x54B, 'M', 'ջ'),
+    (0x54C, 'M', 'ռ'),
+    (0x54D, 'M', 'ս'),
+    (0x54E, 'M', 'վ'),
+    (0x54F, 'M', 'տ'),
+    (0x550, 'M', 'ր'),
+    (0x551, 'M', 'ց'),
+    (0x552, 'M', 'ւ'),
+    (0x553, 'M', 'փ'),
+    (0x554, 'M', 'ք'),
+    (0x555, 'M', 'օ'),
+    (0x556, 'M', 'ֆ'),
+    (0x557, 'X'),
+    (0x559, 'V'),
+    (0x587, 'M', 'եւ'),
+    (0x588, 'V'),
+    (0x58B, 'X'),
+    (0x58D, 'V'),
+    (0x590, 'X'),
+    (0x591, 'V'),
+    (0x5C8, 'X'),
+    (0x5D0, 'V'),
+    (0x5EB, 'X'),
+    (0x5EF, 'V'),
+    (0x5F5, 'X'),
+    (0x606, 'V'),
+    (0x61C, 'X'),
+    (0x61D, 'V'),
+    ]
+
+def _seg_10() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x675, 'M', 'اٴ'),
+    (0x676, 'M', 'وٴ'),
+    (0x677, 'M', 'ۇٴ'),
+    (0x678, 'M', 'يٴ'),
+    (0x679, 'V'),
+    (0x6DD, 'X'),
+    (0x6DE, 'V'),
+    (0x70E, 'X'),
+    (0x710, 'V'),
+    (0x74B, 'X'),
+    (0x74D, 'V'),
+    (0x7B2, 'X'),
+    (0x7C0, 'V'),
+    (0x7FB, 'X'),
+    (0x7FD, 'V'),
+    (0x82E, 'X'),
+    (0x830, 'V'),
+    (0x83F, 'X'),
+    (0x840, 'V'),
+    (0x85C, 'X'),
+    (0x85E, 'V'),
+    (0x85F, 'X'),
+    (0x860, 'V'),
+    (0x86B, 'X'),
+    (0x870, 'V'),
+    (0x88F, 'X'),
+    (0x898, 'V'),
+    (0x8E2, 'X'),
+    (0x8E3, 'V'),
+    (0x958, 'M', 'क़'),
+    (0x959, 'M', 'ख़'),
+    (0x95A, 'M', 'ग़'),
+    (0x95B, 'M', 'ज़'),
+    (0x95C, 'M', 'ड़'),
+    (0x95D, 'M', 'ढ़'),
+    (0x95E, 'M', 'फ़'),
+    (0x95F, 'M', 'य़'),
+    (0x960, 'V'),
+    (0x984, 'X'),
+    (0x985, 'V'),
+    (0x98D, 'X'),
+    (0x98F, 'V'),
+    (0x991, 'X'),
+    (0x993, 'V'),
+    (0x9A9, 'X'),
+    (0x9AA, 'V'),
+    (0x9B1, 'X'),
+    (0x9B2, 'V'),
+    (0x9B3, 'X'),
+    (0x9B6, 'V'),
+    (0x9BA, 'X'),
+    (0x9BC, 'V'),
+    (0x9C5, 'X'),
+    (0x9C7, 'V'),
+    (0x9C9, 'X'),
+    (0x9CB, 'V'),
+    (0x9CF, 'X'),
+    (0x9D7, 'V'),
+    (0x9D8, 'X'),
+    (0x9DC, 'M', 'ড়'),
+    (0x9DD, 'M', 'ঢ়'),
+    (0x9DE, 'X'),
+    (0x9DF, 'M', 'য়'),
+    (0x9E0, 'V'),
+    (0x9E4, 'X'),
+    (0x9E6, 'V'),
+    (0x9FF, 'X'),
+    (0xA01, 'V'),
+    (0xA04, 'X'),
+    (0xA05, 'V'),
+    (0xA0B, 'X'),
+    (0xA0F, 'V'),
+    (0xA11, 'X'),
+    (0xA13, 'V'),
+    (0xA29, 'X'),
+    (0xA2A, 'V'),
+    (0xA31, 'X'),
+    (0xA32, 'V'),
+    (0xA33, 'M', 'ਲ਼'),
+    (0xA34, 'X'),
+    (0xA35, 'V'),
+    (0xA36, 'M', 'ਸ਼'),
+    (0xA37, 'X'),
+    (0xA38, 'V'),
+    (0xA3A, 'X'),
+    (0xA3C, 'V'),
+    (0xA3D, 'X'),
+    (0xA3E, 'V'),
+    (0xA43, 'X'),
+    (0xA47, 'V'),
+    (0xA49, 'X'),
+    (0xA4B, 'V'),
+    (0xA4E, 'X'),
+    (0xA51, 'V'),
+    (0xA52, 'X'),
+    (0xA59, 'M', 'ਖ਼'),
+    (0xA5A, 'M', 'ਗ਼'),
+    (0xA5B, 'M', 'ਜ਼'),
+    (0xA5C, 'V'),
+    (0xA5D, 'X'),
+    ]
+
+def _seg_11() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xA5E, 'M', 'ਫ਼'),
+    (0xA5F, 'X'),
+    (0xA66, 'V'),
+    (0xA77, 'X'),
+    (0xA81, 'V'),
+    (0xA84, 'X'),
+    (0xA85, 'V'),
+    (0xA8E, 'X'),
+    (0xA8F, 'V'),
+    (0xA92, 'X'),
+    (0xA93, 'V'),
+    (0xAA9, 'X'),
+    (0xAAA, 'V'),
+    (0xAB1, 'X'),
+    (0xAB2, 'V'),
+    (0xAB4, 'X'),
+    (0xAB5, 'V'),
+    (0xABA, 'X'),
+    (0xABC, 'V'),
+    (0xAC6, 'X'),
+    (0xAC7, 'V'),
+    (0xACA, 'X'),
+    (0xACB, 'V'),
+    (0xACE, 'X'),
+    (0xAD0, 'V'),
+    (0xAD1, 'X'),
+    (0xAE0, 'V'),
+    (0xAE4, 'X'),
+    (0xAE6, 'V'),
+    (0xAF2, 'X'),
+    (0xAF9, 'V'),
+    (0xB00, 'X'),
+    (0xB01, 'V'),
+    (0xB04, 'X'),
+    (0xB05, 'V'),
+    (0xB0D, 'X'),
+    (0xB0F, 'V'),
+    (0xB11, 'X'),
+    (0xB13, 'V'),
+    (0xB29, 'X'),
+    (0xB2A, 'V'),
+    (0xB31, 'X'),
+    (0xB32, 'V'),
+    (0xB34, 'X'),
+    (0xB35, 'V'),
+    (0xB3A, 'X'),
+    (0xB3C, 'V'),
+    (0xB45, 'X'),
+    (0xB47, 'V'),
+    (0xB49, 'X'),
+    (0xB4B, 'V'),
+    (0xB4E, 'X'),
+    (0xB55, 'V'),
+    (0xB58, 'X'),
+    (0xB5C, 'M', 'ଡ଼'),
+    (0xB5D, 'M', 'ଢ଼'),
+    (0xB5E, 'X'),
+    (0xB5F, 'V'),
+    (0xB64, 'X'),
+    (0xB66, 'V'),
+    (0xB78, 'X'),
+    (0xB82, 'V'),
+    (0xB84, 'X'),
+    (0xB85, 'V'),
+    (0xB8B, 'X'),
+    (0xB8E, 'V'),
+    (0xB91, 'X'),
+    (0xB92, 'V'),
+    (0xB96, 'X'),
+    (0xB99, 'V'),
+    (0xB9B, 'X'),
+    (0xB9C, 'V'),
+    (0xB9D, 'X'),
+    (0xB9E, 'V'),
+    (0xBA0, 'X'),
+    (0xBA3, 'V'),
+    (0xBA5, 'X'),
+    (0xBA8, 'V'),
+    (0xBAB, 'X'),
+    (0xBAE, 'V'),
+    (0xBBA, 'X'),
+    (0xBBE, 'V'),
+    (0xBC3, 'X'),
+    (0xBC6, 'V'),
+    (0xBC9, 'X'),
+    (0xBCA, 'V'),
+    (0xBCE, 'X'),
+    (0xBD0, 'V'),
+    (0xBD1, 'X'),
+    (0xBD7, 'V'),
+    (0xBD8, 'X'),
+    (0xBE6, 'V'),
+    (0xBFB, 'X'),
+    (0xC00, 'V'),
+    (0xC0D, 'X'),
+    (0xC0E, 'V'),
+    (0xC11, 'X'),
+    (0xC12, 'V'),
+    (0xC29, 'X'),
+    (0xC2A, 'V'),
+    ]
+
+def _seg_12() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xC3A, 'X'),
+    (0xC3C, 'V'),
+    (0xC45, 'X'),
+    (0xC46, 'V'),
+    (0xC49, 'X'),
+    (0xC4A, 'V'),
+    (0xC4E, 'X'),
+    (0xC55, 'V'),
+    (0xC57, 'X'),
+    (0xC58, 'V'),
+    (0xC5B, 'X'),
+    (0xC5D, 'V'),
+    (0xC5E, 'X'),
+    (0xC60, 'V'),
+    (0xC64, 'X'),
+    (0xC66, 'V'),
+    (0xC70, 'X'),
+    (0xC77, 'V'),
+    (0xC8D, 'X'),
+    (0xC8E, 'V'),
+    (0xC91, 'X'),
+    (0xC92, 'V'),
+    (0xCA9, 'X'),
+    (0xCAA, 'V'),
+    (0xCB4, 'X'),
+    (0xCB5, 'V'),
+    (0xCBA, 'X'),
+    (0xCBC, 'V'),
+    (0xCC5, 'X'),
+    (0xCC6, 'V'),
+    (0xCC9, 'X'),
+    (0xCCA, 'V'),
+    (0xCCE, 'X'),
+    (0xCD5, 'V'),
+    (0xCD7, 'X'),
+    (0xCDD, 'V'),
+    (0xCDF, 'X'),
+    (0xCE0, 'V'),
+    (0xCE4, 'X'),
+    (0xCE6, 'V'),
+    (0xCF0, 'X'),
+    (0xCF1, 'V'),
+    (0xCF4, 'X'),
+    (0xD00, 'V'),
+    (0xD0D, 'X'),
+    (0xD0E, 'V'),
+    (0xD11, 'X'),
+    (0xD12, 'V'),
+    (0xD45, 'X'),
+    (0xD46, 'V'),
+    (0xD49, 'X'),
+    (0xD4A, 'V'),
+    (0xD50, 'X'),
+    (0xD54, 'V'),
+    (0xD64, 'X'),
+    (0xD66, 'V'),
+    (0xD80, 'X'),
+    (0xD81, 'V'),
+    (0xD84, 'X'),
+    (0xD85, 'V'),
+    (0xD97, 'X'),
+    (0xD9A, 'V'),
+    (0xDB2, 'X'),
+    (0xDB3, 'V'),
+    (0xDBC, 'X'),
+    (0xDBD, 'V'),
+    (0xDBE, 'X'),
+    (0xDC0, 'V'),
+    (0xDC7, 'X'),
+    (0xDCA, 'V'),
+    (0xDCB, 'X'),
+    (0xDCF, 'V'),
+    (0xDD5, 'X'),
+    (0xDD6, 'V'),
+    (0xDD7, 'X'),
+    (0xDD8, 'V'),
+    (0xDE0, 'X'),
+    (0xDE6, 'V'),
+    (0xDF0, 'X'),
+    (0xDF2, 'V'),
+    (0xDF5, 'X'),
+    (0xE01, 'V'),
+    (0xE33, 'M', 'ํา'),
+    (0xE34, 'V'),
+    (0xE3B, 'X'),
+    (0xE3F, 'V'),
+    (0xE5C, 'X'),
+    (0xE81, 'V'),
+    (0xE83, 'X'),
+    (0xE84, 'V'),
+    (0xE85, 'X'),
+    (0xE86, 'V'),
+    (0xE8B, 'X'),
+    (0xE8C, 'V'),
+    (0xEA4, 'X'),
+    (0xEA5, 'V'),
+    (0xEA6, 'X'),
+    (0xEA7, 'V'),
+    (0xEB3, 'M', 'ໍາ'),
+    (0xEB4, 'V'),
+    ]
+
+def _seg_13() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xEBE, 'X'),
+    (0xEC0, 'V'),
+    (0xEC5, 'X'),
+    (0xEC6, 'V'),
+    (0xEC7, 'X'),
+    (0xEC8, 'V'),
+    (0xECF, 'X'),
+    (0xED0, 'V'),
+    (0xEDA, 'X'),
+    (0xEDC, 'M', 'ຫນ'),
+    (0xEDD, 'M', 'ຫມ'),
+    (0xEDE, 'V'),
+    (0xEE0, 'X'),
+    (0xF00, 'V'),
+    (0xF0C, 'M', '་'),
+    (0xF0D, 'V'),
+    (0xF43, 'M', 'གྷ'),
+    (0xF44, 'V'),
+    (0xF48, 'X'),
+    (0xF49, 'V'),
+    (0xF4D, 'M', 'ཌྷ'),
+    (0xF4E, 'V'),
+    (0xF52, 'M', 'དྷ'),
+    (0xF53, 'V'),
+    (0xF57, 'M', 'བྷ'),
+    (0xF58, 'V'),
+    (0xF5C, 'M', 'ཛྷ'),
+    (0xF5D, 'V'),
+    (0xF69, 'M', 'ཀྵ'),
+    (0xF6A, 'V'),
+    (0xF6D, 'X'),
+    (0xF71, 'V'),
+    (0xF73, 'M', 'ཱི'),
+    (0xF74, 'V'),
+    (0xF75, 'M', 'ཱུ'),
+    (0xF76, 'M', 'ྲྀ'),
+    (0xF77, 'M', 'ྲཱྀ'),
+    (0xF78, 'M', 'ླྀ'),
+    (0xF79, 'M', 'ླཱྀ'),
+    (0xF7A, 'V'),
+    (0xF81, 'M', 'ཱྀ'),
+    (0xF82, 'V'),
+    (0xF93, 'M', 'ྒྷ'),
+    (0xF94, 'V'),
+    (0xF98, 'X'),
+    (0xF99, 'V'),
+    (0xF9D, 'M', 'ྜྷ'),
+    (0xF9E, 'V'),
+    (0xFA2, 'M', 'ྡྷ'),
+    (0xFA3, 'V'),
+    (0xFA7, 'M', 'ྦྷ'),
+    (0xFA8, 'V'),
+    (0xFAC, 'M', 'ྫྷ'),
+    (0xFAD, 'V'),
+    (0xFB9, 'M', 'ྐྵ'),
+    (0xFBA, 'V'),
+    (0xFBD, 'X'),
+    (0xFBE, 'V'),
+    (0xFCD, 'X'),
+    (0xFCE, 'V'),
+    (0xFDB, 'X'),
+    (0x1000, 'V'),
+    (0x10A0, 'X'),
+    (0x10C7, 'M', 'ⴧ'),
+    (0x10C8, 'X'),
+    (0x10CD, 'M', 'ⴭ'),
+    (0x10CE, 'X'),
+    (0x10D0, 'V'),
+    (0x10FC, 'M', 'ნ'),
+    (0x10FD, 'V'),
+    (0x115F, 'X'),
+    (0x1161, 'V'),
+    (0x1249, 'X'),
+    (0x124A, 'V'),
+    (0x124E, 'X'),
+    (0x1250, 'V'),
+    (0x1257, 'X'),
+    (0x1258, 'V'),
+    (0x1259, 'X'),
+    (0x125A, 'V'),
+    (0x125E, 'X'),
+    (0x1260, 'V'),
+    (0x1289, 'X'),
+    (0x128A, 'V'),
+    (0x128E, 'X'),
+    (0x1290, 'V'),
+    (0x12B1, 'X'),
+    (0x12B2, 'V'),
+    (0x12B6, 'X'),
+    (0x12B8, 'V'),
+    (0x12BF, 'X'),
+    (0x12C0, 'V'),
+    (0x12C1, 'X'),
+    (0x12C2, 'V'),
+    (0x12C6, 'X'),
+    (0x12C8, 'V'),
+    (0x12D7, 'X'),
+    (0x12D8, 'V'),
+    (0x1311, 'X'),
+    (0x1312, 'V'),
+    ]
+
+def _seg_14() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1316, 'X'),
+    (0x1318, 'V'),
+    (0x135B, 'X'),
+    (0x135D, 'V'),
+    (0x137D, 'X'),
+    (0x1380, 'V'),
+    (0x139A, 'X'),
+    (0x13A0, 'V'),
+    (0x13F6, 'X'),
+    (0x13F8, 'M', 'Ᏸ'),
+    (0x13F9, 'M', 'Ᏹ'),
+    (0x13FA, 'M', 'Ᏺ'),
+    (0x13FB, 'M', 'Ᏻ'),
+    (0x13FC, 'M', 'Ᏼ'),
+    (0x13FD, 'M', 'Ᏽ'),
+    (0x13FE, 'X'),
+    (0x1400, 'V'),
+    (0x1680, 'X'),
+    (0x1681, 'V'),
+    (0x169D, 'X'),
+    (0x16A0, 'V'),
+    (0x16F9, 'X'),
+    (0x1700, 'V'),
+    (0x1716, 'X'),
+    (0x171F, 'V'),
+    (0x1737, 'X'),
+    (0x1740, 'V'),
+    (0x1754, 'X'),
+    (0x1760, 'V'),
+    (0x176D, 'X'),
+    (0x176E, 'V'),
+    (0x1771, 'X'),
+    (0x1772, 'V'),
+    (0x1774, 'X'),
+    (0x1780, 'V'),
+    (0x17B4, 'X'),
+    (0x17B6, 'V'),
+    (0x17DE, 'X'),
+    (0x17E0, 'V'),
+    (0x17EA, 'X'),
+    (0x17F0, 'V'),
+    (0x17FA, 'X'),
+    (0x1800, 'V'),
+    (0x1806, 'X'),
+    (0x1807, 'V'),
+    (0x180B, 'I'),
+    (0x180E, 'X'),
+    (0x180F, 'I'),
+    (0x1810, 'V'),
+    (0x181A, 'X'),
+    (0x1820, 'V'),
+    (0x1879, 'X'),
+    (0x1880, 'V'),
+    (0x18AB, 'X'),
+    (0x18B0, 'V'),
+    (0x18F6, 'X'),
+    (0x1900, 'V'),
+    (0x191F, 'X'),
+    (0x1920, 'V'),
+    (0x192C, 'X'),
+    (0x1930, 'V'),
+    (0x193C, 'X'),
+    (0x1940, 'V'),
+    (0x1941, 'X'),
+    (0x1944, 'V'),
+    (0x196E, 'X'),
+    (0x1970, 'V'),
+    (0x1975, 'X'),
+    (0x1980, 'V'),
+    (0x19AC, 'X'),
+    (0x19B0, 'V'),
+    (0x19CA, 'X'),
+    (0x19D0, 'V'),
+    (0x19DB, 'X'),
+    (0x19DE, 'V'),
+    (0x1A1C, 'X'),
+    (0x1A1E, 'V'),
+    (0x1A5F, 'X'),
+    (0x1A60, 'V'),
+    (0x1A7D, 'X'),
+    (0x1A7F, 'V'),
+    (0x1A8A, 'X'),
+    (0x1A90, 'V'),
+    (0x1A9A, 'X'),
+    (0x1AA0, 'V'),
+    (0x1AAE, 'X'),
+    (0x1AB0, 'V'),
+    (0x1ACF, 'X'),
+    (0x1B00, 'V'),
+    (0x1B4D, 'X'),
+    (0x1B50, 'V'),
+    (0x1B7F, 'X'),
+    (0x1B80, 'V'),
+    (0x1BF4, 'X'),
+    (0x1BFC, 'V'),
+    (0x1C38, 'X'),
+    (0x1C3B, 'V'),
+    (0x1C4A, 'X'),
+    (0x1C4D, 'V'),
+    (0x1C80, 'M', 'в'),
+    ]
+
+def _seg_15() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1C81, 'M', 'д'),
+    (0x1C82, 'M', 'о'),
+    (0x1C83, 'M', 'с'),
+    (0x1C84, 'M', 'т'),
+    (0x1C86, 'M', 'ъ'),
+    (0x1C87, 'M', 'ѣ'),
+    (0x1C88, 'M', 'ꙋ'),
+    (0x1C89, 'X'),
+    (0x1C90, 'M', 'ა'),
+    (0x1C91, 'M', 'ბ'),
+    (0x1C92, 'M', 'გ'),
+    (0x1C93, 'M', 'დ'),
+    (0x1C94, 'M', 'ე'),
+    (0x1C95, 'M', 'ვ'),
+    (0x1C96, 'M', 'ზ'),
+    (0x1C97, 'M', 'თ'),
+    (0x1C98, 'M', 'ი'),
+    (0x1C99, 'M', 'კ'),
+    (0x1C9A, 'M', 'ლ'),
+    (0x1C9B, 'M', 'მ'),
+    (0x1C9C, 'M', 'ნ'),
+    (0x1C9D, 'M', 'ო'),
+    (0x1C9E, 'M', 'პ'),
+    (0x1C9F, 'M', 'ჟ'),
+    (0x1CA0, 'M', 'რ'),
+    (0x1CA1, 'M', 'ს'),
+    (0x1CA2, 'M', 'ტ'),
+    (0x1CA3, 'M', 'უ'),
+    (0x1CA4, 'M', 'ფ'),
+    (0x1CA5, 'M', 'ქ'),
+    (0x1CA6, 'M', 'ღ'),
+    (0x1CA7, 'M', 'ყ'),
+    (0x1CA8, 'M', 'შ'),
+    (0x1CA9, 'M', 'ჩ'),
+    (0x1CAA, 'M', 'ც'),
+    (0x1CAB, 'M', 'ძ'),
+    (0x1CAC, 'M', 'წ'),
+    (0x1CAD, 'M', 'ჭ'),
+    (0x1CAE, 'M', 'ხ'),
+    (0x1CAF, 'M', 'ჯ'),
+    (0x1CB0, 'M', 'ჰ'),
+    (0x1CB1, 'M', 'ჱ'),
+    (0x1CB2, 'M', 'ჲ'),
+    (0x1CB3, 'M', 'ჳ'),
+    (0x1CB4, 'M', 'ჴ'),
+    (0x1CB5, 'M', 'ჵ'),
+    (0x1CB6, 'M', 'ჶ'),
+    (0x1CB7, 'M', 'ჷ'),
+    (0x1CB8, 'M', 'ჸ'),
+    (0x1CB9, 'M', 'ჹ'),
+    (0x1CBA, 'M', 'ჺ'),
+    (0x1CBB, 'X'),
+    (0x1CBD, 'M', 'ჽ'),
+    (0x1CBE, 'M', 'ჾ'),
+    (0x1CBF, 'M', 'ჿ'),
+    (0x1CC0, 'V'),
+    (0x1CC8, 'X'),
+    (0x1CD0, 'V'),
+    (0x1CFB, 'X'),
+    (0x1D00, 'V'),
+    (0x1D2C, 'M', 'a'),
+    (0x1D2D, 'M', 'æ'),
+    (0x1D2E, 'M', 'b'),
+    (0x1D2F, 'V'),
+    (0x1D30, 'M', 'd'),
+    (0x1D31, 'M', 'e'),
+    (0x1D32, 'M', 'ǝ'),
+    (0x1D33, 'M', 'g'),
+    (0x1D34, 'M', 'h'),
+    (0x1D35, 'M', 'i'),
+    (0x1D36, 'M', 'j'),
+    (0x1D37, 'M', 'k'),
+    (0x1D38, 'M', 'l'),
+    (0x1D39, 'M', 'm'),
+    (0x1D3A, 'M', 'n'),
+    (0x1D3B, 'V'),
+    (0x1D3C, 'M', 'o'),
+    (0x1D3D, 'M', 'ȣ'),
+    (0x1D3E, 'M', 'p'),
+    (0x1D3F, 'M', 'r'),
+    (0x1D40, 'M', 't'),
+    (0x1D41, 'M', 'u'),
+    (0x1D42, 'M', 'w'),
+    (0x1D43, 'M', 'a'),
+    (0x1D44, 'M', 'ɐ'),
+    (0x1D45, 'M', 'ɑ'),
+    (0x1D46, 'M', 'ᴂ'),
+    (0x1D47, 'M', 'b'),
+    (0x1D48, 'M', 'd'),
+    (0x1D49, 'M', 'e'),
+    (0x1D4A, 'M', 'ə'),
+    (0x1D4B, 'M', 'ɛ'),
+    (0x1D4C, 'M', 'ɜ'),
+    (0x1D4D, 'M', 'g'),
+    (0x1D4E, 'V'),
+    (0x1D4F, 'M', 'k'),
+    (0x1D50, 'M', 'm'),
+    (0x1D51, 'M', 'ŋ'),
+    (0x1D52, 'M', 'o'),
+    (0x1D53, 'M', 'ɔ'),
+    ]
+
+def _seg_16() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1D54, 'M', 'ᴖ'),
+    (0x1D55, 'M', 'ᴗ'),
+    (0x1D56, 'M', 'p'),
+    (0x1D57, 'M', 't'),
+    (0x1D58, 'M', 'u'),
+    (0x1D59, 'M', 'ᴝ'),
+    (0x1D5A, 'M', 'ɯ'),
+    (0x1D5B, 'M', 'v'),
+    (0x1D5C, 'M', 'ᴥ'),
+    (0x1D5D, 'M', 'β'),
+    (0x1D5E, 'M', 'γ'),
+    (0x1D5F, 'M', 'δ'),
+    (0x1D60, 'M', 'φ'),
+    (0x1D61, 'M', 'χ'),
+    (0x1D62, 'M', 'i'),
+    (0x1D63, 'M', 'r'),
+    (0x1D64, 'M', 'u'),
+    (0x1D65, 'M', 'v'),
+    (0x1D66, 'M', 'β'),
+    (0x1D67, 'M', 'γ'),
+    (0x1D68, 'M', 'ρ'),
+    (0x1D69, 'M', 'φ'),
+    (0x1D6A, 'M', 'χ'),
+    (0x1D6B, 'V'),
+    (0x1D78, 'M', 'н'),
+    (0x1D79, 'V'),
+    (0x1D9B, 'M', 'ɒ'),
+    (0x1D9C, 'M', 'c'),
+    (0x1D9D, 'M', 'ɕ'),
+    (0x1D9E, 'M', 'ð'),
+    (0x1D9F, 'M', 'ɜ'),
+    (0x1DA0, 'M', 'f'),
+    (0x1DA1, 'M', 'ɟ'),
+    (0x1DA2, 'M', 'ɡ'),
+    (0x1DA3, 'M', 'ɥ'),
+    (0x1DA4, 'M', 'ɨ'),
+    (0x1DA5, 'M', 'ɩ'),
+    (0x1DA6, 'M', 'ɪ'),
+    (0x1DA7, 'M', 'ᵻ'),
+    (0x1DA8, 'M', 'ʝ'),
+    (0x1DA9, 'M', 'ɭ'),
+    (0x1DAA, 'M', 'ᶅ'),
+    (0x1DAB, 'M', 'ʟ'),
+    (0x1DAC, 'M', 'ɱ'),
+    (0x1DAD, 'M', 'ɰ'),
+    (0x1DAE, 'M', 'ɲ'),
+    (0x1DAF, 'M', 'ɳ'),
+    (0x1DB0, 'M', 'ɴ'),
+    (0x1DB1, 'M', 'ɵ'),
+    (0x1DB2, 'M', 'ɸ'),
+    (0x1DB3, 'M', 'ʂ'),
+    (0x1DB4, 'M', 'ʃ'),
+    (0x1DB5, 'M', 'ƫ'),
+    (0x1DB6, 'M', 'ʉ'),
+    (0x1DB7, 'M', 'ʊ'),
+    (0x1DB8, 'M', 'ᴜ'),
+    (0x1DB9, 'M', 'ʋ'),
+    (0x1DBA, 'M', 'ʌ'),
+    (0x1DBB, 'M', 'z'),
+    (0x1DBC, 'M', 'ʐ'),
+    (0x1DBD, 'M', 'ʑ'),
+    (0x1DBE, 'M', 'ʒ'),
+    (0x1DBF, 'M', 'θ'),
+    (0x1DC0, 'V'),
+    (0x1E00, 'M', 'ḁ'),
+    (0x1E01, 'V'),
+    (0x1E02, 'M', 'ḃ'),
+    (0x1E03, 'V'),
+    (0x1E04, 'M', 'ḅ'),
+    (0x1E05, 'V'),
+    (0x1E06, 'M', 'ḇ'),
+    (0x1E07, 'V'),
+    (0x1E08, 'M', 'ḉ'),
+    (0x1E09, 'V'),
+    (0x1E0A, 'M', 'ḋ'),
+    (0x1E0B, 'V'),
+    (0x1E0C, 'M', 'ḍ'),
+    (0x1E0D, 'V'),
+    (0x1E0E, 'M', 'ḏ'),
+    (0x1E0F, 'V'),
+    (0x1E10, 'M', 'ḑ'),
+    (0x1E11, 'V'),
+    (0x1E12, 'M', 'ḓ'),
+    (0x1E13, 'V'),
+    (0x1E14, 'M', 'ḕ'),
+    (0x1E15, 'V'),
+    (0x1E16, 'M', 'ḗ'),
+    (0x1E17, 'V'),
+    (0x1E18, 'M', 'ḙ'),
+    (0x1E19, 'V'),
+    (0x1E1A, 'M', 'ḛ'),
+    (0x1E1B, 'V'),
+    (0x1E1C, 'M', 'ḝ'),
+    (0x1E1D, 'V'),
+    (0x1E1E, 'M', 'ḟ'),
+    (0x1E1F, 'V'),
+    (0x1E20, 'M', 'ḡ'),
+    (0x1E21, 'V'),
+    (0x1E22, 'M', 'ḣ'),
+    (0x1E23, 'V'),
+    ]
+
+def _seg_17() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1E24, 'M', 'ḥ'),
+    (0x1E25, 'V'),
+    (0x1E26, 'M', 'ḧ'),
+    (0x1E27, 'V'),
+    (0x1E28, 'M', 'ḩ'),
+    (0x1E29, 'V'),
+    (0x1E2A, 'M', 'ḫ'),
+    (0x1E2B, 'V'),
+    (0x1E2C, 'M', 'ḭ'),
+    (0x1E2D, 'V'),
+    (0x1E2E, 'M', 'ḯ'),
+    (0x1E2F, 'V'),
+    (0x1E30, 'M', 'ḱ'),
+    (0x1E31, 'V'),
+    (0x1E32, 'M', 'ḳ'),
+    (0x1E33, 'V'),
+    (0x1E34, 'M', 'ḵ'),
+    (0x1E35, 'V'),
+    (0x1E36, 'M', 'ḷ'),
+    (0x1E37, 'V'),
+    (0x1E38, 'M', 'ḹ'),
+    (0x1E39, 'V'),
+    (0x1E3A, 'M', 'ḻ'),
+    (0x1E3B, 'V'),
+    (0x1E3C, 'M', 'ḽ'),
+    (0x1E3D, 'V'),
+    (0x1E3E, 'M', 'ḿ'),
+    (0x1E3F, 'V'),
+    (0x1E40, 'M', 'ṁ'),
+    (0x1E41, 'V'),
+    (0x1E42, 'M', 'ṃ'),
+    (0x1E43, 'V'),
+    (0x1E44, 'M', 'ṅ'),
+    (0x1E45, 'V'),
+    (0x1E46, 'M', 'ṇ'),
+    (0x1E47, 'V'),
+    (0x1E48, 'M', 'ṉ'),
+    (0x1E49, 'V'),
+    (0x1E4A, 'M', 'ṋ'),
+    (0x1E4B, 'V'),
+    (0x1E4C, 'M', 'ṍ'),
+    (0x1E4D, 'V'),
+    (0x1E4E, 'M', 'ṏ'),
+    (0x1E4F, 'V'),
+    (0x1E50, 'M', 'ṑ'),
+    (0x1E51, 'V'),
+    (0x1E52, 'M', 'ṓ'),
+    (0x1E53, 'V'),
+    (0x1E54, 'M', 'ṕ'),
+    (0x1E55, 'V'),
+    (0x1E56, 'M', 'ṗ'),
+    (0x1E57, 'V'),
+    (0x1E58, 'M', 'ṙ'),
+    (0x1E59, 'V'),
+    (0x1E5A, 'M', 'ṛ'),
+    (0x1E5B, 'V'),
+    (0x1E5C, 'M', 'ṝ'),
+    (0x1E5D, 'V'),
+    (0x1E5E, 'M', 'ṟ'),
+    (0x1E5F, 'V'),
+    (0x1E60, 'M', 'ṡ'),
+    (0x1E61, 'V'),
+    (0x1E62, 'M', 'ṣ'),
+    (0x1E63, 'V'),
+    (0x1E64, 'M', 'ṥ'),
+    (0x1E65, 'V'),
+    (0x1E66, 'M', 'ṧ'),
+    (0x1E67, 'V'),
+    (0x1E68, 'M', 'ṩ'),
+    (0x1E69, 'V'),
+    (0x1E6A, 'M', 'ṫ'),
+    (0x1E6B, 'V'),
+    (0x1E6C, 'M', 'ṭ'),
+    (0x1E6D, 'V'),
+    (0x1E6E, 'M', 'ṯ'),
+    (0x1E6F, 'V'),
+    (0x1E70, 'M', 'ṱ'),
+    (0x1E71, 'V'),
+    (0x1E72, 'M', 'ṳ'),
+    (0x1E73, 'V'),
+    (0x1E74, 'M', 'ṵ'),
+    (0x1E75, 'V'),
+    (0x1E76, 'M', 'ṷ'),
+    (0x1E77, 'V'),
+    (0x1E78, 'M', 'ṹ'),
+    (0x1E79, 'V'),
+    (0x1E7A, 'M', 'ṻ'),
+    (0x1E7B, 'V'),
+    (0x1E7C, 'M', 'ṽ'),
+    (0x1E7D, 'V'),
+    (0x1E7E, 'M', 'ṿ'),
+    (0x1E7F, 'V'),
+    (0x1E80, 'M', 'ẁ'),
+    (0x1E81, 'V'),
+    (0x1E82, 'M', 'ẃ'),
+    (0x1E83, 'V'),
+    (0x1E84, 'M', 'ẅ'),
+    (0x1E85, 'V'),
+    (0x1E86, 'M', 'ẇ'),
+    (0x1E87, 'V'),
+    ]
+
+def _seg_18() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1E88, 'M', 'ẉ'),
+    (0x1E89, 'V'),
+    (0x1E8A, 'M', 'ẋ'),
+    (0x1E8B, 'V'),
+    (0x1E8C, 'M', 'ẍ'),
+    (0x1E8D, 'V'),
+    (0x1E8E, 'M', 'ẏ'),
+    (0x1E8F, 'V'),
+    (0x1E90, 'M', 'ẑ'),
+    (0x1E91, 'V'),
+    (0x1E92, 'M', 'ẓ'),
+    (0x1E93, 'V'),
+    (0x1E94, 'M', 'ẕ'),
+    (0x1E95, 'V'),
+    (0x1E9A, 'M', 'aʾ'),
+    (0x1E9B, 'M', 'ṡ'),
+    (0x1E9C, 'V'),
+    (0x1E9E, 'M', 'ß'),
+    (0x1E9F, 'V'),
+    (0x1EA0, 'M', 'ạ'),
+    (0x1EA1, 'V'),
+    (0x1EA2, 'M', 'ả'),
+    (0x1EA3, 'V'),
+    (0x1EA4, 'M', 'ấ'),
+    (0x1EA5, 'V'),
+    (0x1EA6, 'M', 'ầ'),
+    (0x1EA7, 'V'),
+    (0x1EA8, 'M', 'ẩ'),
+    (0x1EA9, 'V'),
+    (0x1EAA, 'M', 'ẫ'),
+    (0x1EAB, 'V'),
+    (0x1EAC, 'M', 'ậ'),
+    (0x1EAD, 'V'),
+    (0x1EAE, 'M', 'ắ'),
+    (0x1EAF, 'V'),
+    (0x1EB0, 'M', 'ằ'),
+    (0x1EB1, 'V'),
+    (0x1EB2, 'M', 'ẳ'),
+    (0x1EB3, 'V'),
+    (0x1EB4, 'M', 'ẵ'),
+    (0x1EB5, 'V'),
+    (0x1EB6, 'M', 'ặ'),
+    (0x1EB7, 'V'),
+    (0x1EB8, 'M', 'ẹ'),
+    (0x1EB9, 'V'),
+    (0x1EBA, 'M', 'ẻ'),
+    (0x1EBB, 'V'),
+    (0x1EBC, 'M', 'ẽ'),
+    (0x1EBD, 'V'),
+    (0x1EBE, 'M', 'ế'),
+    (0x1EBF, 'V'),
+    (0x1EC0, 'M', 'ề'),
+    (0x1EC1, 'V'),
+    (0x1EC2, 'M', 'ể'),
+    (0x1EC3, 'V'),
+    (0x1EC4, 'M', 'ễ'),
+    (0x1EC5, 'V'),
+    (0x1EC6, 'M', 'ệ'),
+    (0x1EC7, 'V'),
+    (0x1EC8, 'M', 'ỉ'),
+    (0x1EC9, 'V'),
+    (0x1ECA, 'M', 'ị'),
+    (0x1ECB, 'V'),
+    (0x1ECC, 'M', 'ọ'),
+    (0x1ECD, 'V'),
+    (0x1ECE, 'M', 'ỏ'),
+    (0x1ECF, 'V'),
+    (0x1ED0, 'M', 'ố'),
+    (0x1ED1, 'V'),
+    (0x1ED2, 'M', 'ồ'),
+    (0x1ED3, 'V'),
+    (0x1ED4, 'M', 'ổ'),
+    (0x1ED5, 'V'),
+    (0x1ED6, 'M', 'ỗ'),
+    (0x1ED7, 'V'),
+    (0x1ED8, 'M', 'ộ'),
+    (0x1ED9, 'V'),
+    (0x1EDA, 'M', 'ớ'),
+    (0x1EDB, 'V'),
+    (0x1EDC, 'M', 'ờ'),
+    (0x1EDD, 'V'),
+    (0x1EDE, 'M', 'ở'),
+    (0x1EDF, 'V'),
+    (0x1EE0, 'M', 'ỡ'),
+    (0x1EE1, 'V'),
+    (0x1EE2, 'M', 'ợ'),
+    (0x1EE3, 'V'),
+    (0x1EE4, 'M', 'ụ'),
+    (0x1EE5, 'V'),
+    (0x1EE6, 'M', 'ủ'),
+    (0x1EE7, 'V'),
+    (0x1EE8, 'M', 'ứ'),
+    (0x1EE9, 'V'),
+    (0x1EEA, 'M', 'ừ'),
+    (0x1EEB, 'V'),
+    (0x1EEC, 'M', 'ử'),
+    (0x1EED, 'V'),
+    (0x1EEE, 'M', 'ữ'),
+    (0x1EEF, 'V'),
+    (0x1EF0, 'M', 'ự'),
+    ]
+
+def _seg_19() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1EF1, 'V'),
+    (0x1EF2, 'M', 'ỳ'),
+    (0x1EF3, 'V'),
+    (0x1EF4, 'M', 'ỵ'),
+    (0x1EF5, 'V'),
+    (0x1EF6, 'M', 'ỷ'),
+    (0x1EF7, 'V'),
+    (0x1EF8, 'M', 'ỹ'),
+    (0x1EF9, 'V'),
+    (0x1EFA, 'M', 'ỻ'),
+    (0x1EFB, 'V'),
+    (0x1EFC, 'M', 'ỽ'),
+    (0x1EFD, 'V'),
+    (0x1EFE, 'M', 'ỿ'),
+    (0x1EFF, 'V'),
+    (0x1F08, 'M', 'ἀ'),
+    (0x1F09, 'M', 'ἁ'),
+    (0x1F0A, 'M', 'ἂ'),
+    (0x1F0B, 'M', 'ἃ'),
+    (0x1F0C, 'M', 'ἄ'),
+    (0x1F0D, 'M', 'ἅ'),
+    (0x1F0E, 'M', 'ἆ'),
+    (0x1F0F, 'M', 'ἇ'),
+    (0x1F10, 'V'),
+    (0x1F16, 'X'),
+    (0x1F18, 'M', 'ἐ'),
+    (0x1F19, 'M', 'ἑ'),
+    (0x1F1A, 'M', 'ἒ'),
+    (0x1F1B, 'M', 'ἓ'),
+    (0x1F1C, 'M', 'ἔ'),
+    (0x1F1D, 'M', 'ἕ'),
+    (0x1F1E, 'X'),
+    (0x1F20, 'V'),
+    (0x1F28, 'M', 'ἠ'),
+    (0x1F29, 'M', 'ἡ'),
+    (0x1F2A, 'M', 'ἢ'),
+    (0x1F2B, 'M', 'ἣ'),
+    (0x1F2C, 'M', 'ἤ'),
+    (0x1F2D, 'M', 'ἥ'),
+    (0x1F2E, 'M', 'ἦ'),
+    (0x1F2F, 'M', 'ἧ'),
+    (0x1F30, 'V'),
+    (0x1F38, 'M', 'ἰ'),
+    (0x1F39, 'M', 'ἱ'),
+    (0x1F3A, 'M', 'ἲ'),
+    (0x1F3B, 'M', 'ἳ'),
+    (0x1F3C, 'M', 'ἴ'),
+    (0x1F3D, 'M', 'ἵ'),
+    (0x1F3E, 'M', 'ἶ'),
+    (0x1F3F, 'M', 'ἷ'),
+    (0x1F40, 'V'),
+    (0x1F46, 'X'),
+    (0x1F48, 'M', 'ὀ'),
+    (0x1F49, 'M', 'ὁ'),
+    (0x1F4A, 'M', 'ὂ'),
+    (0x1F4B, 'M', 'ὃ'),
+    (0x1F4C, 'M', 'ὄ'),
+    (0x1F4D, 'M', 'ὅ'),
+    (0x1F4E, 'X'),
+    (0x1F50, 'V'),
+    (0x1F58, 'X'),
+    (0x1F59, 'M', 'ὑ'),
+    (0x1F5A, 'X'),
+    (0x1F5B, 'M', 'ὓ'),
+    (0x1F5C, 'X'),
+    (0x1F5D, 'M', 'ὕ'),
+    (0x1F5E, 'X'),
+    (0x1F5F, 'M', 'ὗ'),
+    (0x1F60, 'V'),
+    (0x1F68, 'M', 'ὠ'),
+    (0x1F69, 'M', 'ὡ'),
+    (0x1F6A, 'M', 'ὢ'),
+    (0x1F6B, 'M', 'ὣ'),
+    (0x1F6C, 'M', 'ὤ'),
+    (0x1F6D, 'M', 'ὥ'),
+    (0x1F6E, 'M', 'ὦ'),
+    (0x1F6F, 'M', 'ὧ'),
+    (0x1F70, 'V'),
+    (0x1F71, 'M', 'ά'),
+    (0x1F72, 'V'),
+    (0x1F73, 'M', 'έ'),
+    (0x1F74, 'V'),
+    (0x1F75, 'M', 'ή'),
+    (0x1F76, 'V'),
+    (0x1F77, 'M', 'ί'),
+    (0x1F78, 'V'),
+    (0x1F79, 'M', 'ό'),
+    (0x1F7A, 'V'),
+    (0x1F7B, 'M', 'ύ'),
+    (0x1F7C, 'V'),
+    (0x1F7D, 'M', 'ώ'),
+    (0x1F7E, 'X'),
+    (0x1F80, 'M', 'ἀι'),
+    (0x1F81, 'M', 'ἁι'),
+    (0x1F82, 'M', 'ἂι'),
+    (0x1F83, 'M', 'ἃι'),
+    (0x1F84, 'M', 'ἄι'),
+    (0x1F85, 'M', 'ἅι'),
+    (0x1F86, 'M', 'ἆι'),
+    (0x1F87, 'M', 'ἇι'),
+    ]
+
+def _seg_20() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1F88, 'M', 'ἀι'),
+    (0x1F89, 'M', 'ἁι'),
+    (0x1F8A, 'M', 'ἂι'),
+    (0x1F8B, 'M', 'ἃι'),
+    (0x1F8C, 'M', 'ἄι'),
+    (0x1F8D, 'M', 'ἅι'),
+    (0x1F8E, 'M', 'ἆι'),
+    (0x1F8F, 'M', 'ἇι'),
+    (0x1F90, 'M', 'ἠι'),
+    (0x1F91, 'M', 'ἡι'),
+    (0x1F92, 'M', 'ἢι'),
+    (0x1F93, 'M', 'ἣι'),
+    (0x1F94, 'M', 'ἤι'),
+    (0x1F95, 'M', 'ἥι'),
+    (0x1F96, 'M', 'ἦι'),
+    (0x1F97, 'M', 'ἧι'),
+    (0x1F98, 'M', 'ἠι'),
+    (0x1F99, 'M', 'ἡι'),
+    (0x1F9A, 'M', 'ἢι'),
+    (0x1F9B, 'M', 'ἣι'),
+    (0x1F9C, 'M', 'ἤι'),
+    (0x1F9D, 'M', 'ἥι'),
+    (0x1F9E, 'M', 'ἦι'),
+    (0x1F9F, 'M', 'ἧι'),
+    (0x1FA0, 'M', 'ὠι'),
+    (0x1FA1, 'M', 'ὡι'),
+    (0x1FA2, 'M', 'ὢι'),
+    (0x1FA3, 'M', 'ὣι'),
+    (0x1FA4, 'M', 'ὤι'),
+    (0x1FA5, 'M', 'ὥι'),
+    (0x1FA6, 'M', 'ὦι'),
+    (0x1FA7, 'M', 'ὧι'),
+    (0x1FA8, 'M', 'ὠι'),
+    (0x1FA9, 'M', 'ὡι'),
+    (0x1FAA, 'M', 'ὢι'),
+    (0x1FAB, 'M', 'ὣι'),
+    (0x1FAC, 'M', 'ὤι'),
+    (0x1FAD, 'M', 'ὥι'),
+    (0x1FAE, 'M', 'ὦι'),
+    (0x1FAF, 'M', 'ὧι'),
+    (0x1FB0, 'V'),
+    (0x1FB2, 'M', 'ὰι'),
+    (0x1FB3, 'M', 'αι'),
+    (0x1FB4, 'M', 'άι'),
+    (0x1FB5, 'X'),
+    (0x1FB6, 'V'),
+    (0x1FB7, 'M', 'ᾶι'),
+    (0x1FB8, 'M', 'ᾰ'),
+    (0x1FB9, 'M', 'ᾱ'),
+    (0x1FBA, 'M', 'ὰ'),
+    (0x1FBB, 'M', 'ά'),
+    (0x1FBC, 'M', 'αι'),
+    (0x1FBD, '3', ' ̓'),
+    (0x1FBE, 'M', 'ι'),
+    (0x1FBF, '3', ' ̓'),
+    (0x1FC0, '3', ' ͂'),
+    (0x1FC1, '3', ' ̈͂'),
+    (0x1FC2, 'M', 'ὴι'),
+    (0x1FC3, 'M', 'ηι'),
+    (0x1FC4, 'M', 'ήι'),
+    (0x1FC5, 'X'),
+    (0x1FC6, 'V'),
+    (0x1FC7, 'M', 'ῆι'),
+    (0x1FC8, 'M', 'ὲ'),
+    (0x1FC9, 'M', 'έ'),
+    (0x1FCA, 'M', 'ὴ'),
+    (0x1FCB, 'M', 'ή'),
+    (0x1FCC, 'M', 'ηι'),
+    (0x1FCD, '3', ' ̓̀'),
+    (0x1FCE, '3', ' ̓́'),
+    (0x1FCF, '3', ' ̓͂'),
+    (0x1FD0, 'V'),
+    (0x1FD3, 'M', 'ΐ'),
+    (0x1FD4, 'X'),
+    (0x1FD6, 'V'),
+    (0x1FD8, 'M', 'ῐ'),
+    (0x1FD9, 'M', 'ῑ'),
+    (0x1FDA, 'M', 'ὶ'),
+    (0x1FDB, 'M', 'ί'),
+    (0x1FDC, 'X'),
+    (0x1FDD, '3', ' ̔̀'),
+    (0x1FDE, '3', ' ̔́'),
+    (0x1FDF, '3', ' ̔͂'),
+    (0x1FE0, 'V'),
+    (0x1FE3, 'M', 'ΰ'),
+    (0x1FE4, 'V'),
+    (0x1FE8, 'M', 'ῠ'),
+    (0x1FE9, 'M', 'ῡ'),
+    (0x1FEA, 'M', 'ὺ'),
+    (0x1FEB, 'M', 'ύ'),
+    (0x1FEC, 'M', 'ῥ'),
+    (0x1FED, '3', ' ̈̀'),
+    (0x1FEE, '3', ' ̈́'),
+    (0x1FEF, '3', '`'),
+    (0x1FF0, 'X'),
+    (0x1FF2, 'M', 'ὼι'),
+    (0x1FF3, 'M', 'ωι'),
+    (0x1FF4, 'M', 'ώι'),
+    (0x1FF5, 'X'),
+    (0x1FF6, 'V'),
+    ]
+
+def _seg_21() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1FF7, 'M', 'ῶι'),
+    (0x1FF8, 'M', 'ὸ'),
+    (0x1FF9, 'M', 'ό'),
+    (0x1FFA, 'M', 'ὼ'),
+    (0x1FFB, 'M', 'ώ'),
+    (0x1FFC, 'M', 'ωι'),
+    (0x1FFD, '3', ' ́'),
+    (0x1FFE, '3', ' ̔'),
+    (0x1FFF, 'X'),
+    (0x2000, '3', ' '),
+    (0x200B, 'I'),
+    (0x200C, 'D', ''),
+    (0x200E, 'X'),
+    (0x2010, 'V'),
+    (0x2011, 'M', '‐'),
+    (0x2012, 'V'),
+    (0x2017, '3', ' ̳'),
+    (0x2018, 'V'),
+    (0x2024, 'X'),
+    (0x2027, 'V'),
+    (0x2028, 'X'),
+    (0x202F, '3', ' '),
+    (0x2030, 'V'),
+    (0x2033, 'M', '′′'),
+    (0x2034, 'M', '′′′'),
+    (0x2035, 'V'),
+    (0x2036, 'M', '‵‵'),
+    (0x2037, 'M', '‵‵‵'),
+    (0x2038, 'V'),
+    (0x203C, '3', '!!'),
+    (0x203D, 'V'),
+    (0x203E, '3', ' ̅'),
+    (0x203F, 'V'),
+    (0x2047, '3', '??'),
+    (0x2048, '3', '?!'),
+    (0x2049, '3', '!?'),
+    (0x204A, 'V'),
+    (0x2057, 'M', '′′′′'),
+    (0x2058, 'V'),
+    (0x205F, '3', ' '),
+    (0x2060, 'I'),
+    (0x2061, 'X'),
+    (0x2064, 'I'),
+    (0x2065, 'X'),
+    (0x2070, 'M', '0'),
+    (0x2071, 'M', 'i'),
+    (0x2072, 'X'),
+    (0x2074, 'M', '4'),
+    (0x2075, 'M', '5'),
+    (0x2076, 'M', '6'),
+    (0x2077, 'M', '7'),
+    (0x2078, 'M', '8'),
+    (0x2079, 'M', '9'),
+    (0x207A, '3', '+'),
+    (0x207B, 'M', '−'),
+    (0x207C, '3', '='),
+    (0x207D, '3', '('),
+    (0x207E, '3', ')'),
+    (0x207F, 'M', 'n'),
+    (0x2080, 'M', '0'),
+    (0x2081, 'M', '1'),
+    (0x2082, 'M', '2'),
+    (0x2083, 'M', '3'),
+    (0x2084, 'M', '4'),
+    (0x2085, 'M', '5'),
+    (0x2086, 'M', '6'),
+    (0x2087, 'M', '7'),
+    (0x2088, 'M', '8'),
+    (0x2089, 'M', '9'),
+    (0x208A, '3', '+'),
+    (0x208B, 'M', '−'),
+    (0x208C, '3', '='),
+    (0x208D, '3', '('),
+    (0x208E, '3', ')'),
+    (0x208F, 'X'),
+    (0x2090, 'M', 'a'),
+    (0x2091, 'M', 'e'),
+    (0x2092, 'M', 'o'),
+    (0x2093, 'M', 'x'),
+    (0x2094, 'M', 'ə'),
+    (0x2095, 'M', 'h'),
+    (0x2096, 'M', 'k'),
+    (0x2097, 'M', 'l'),
+    (0x2098, 'M', 'm'),
+    (0x2099, 'M', 'n'),
+    (0x209A, 'M', 'p'),
+    (0x209B, 'M', 's'),
+    (0x209C, 'M', 't'),
+    (0x209D, 'X'),
+    (0x20A0, 'V'),
+    (0x20A8, 'M', 'rs'),
+    (0x20A9, 'V'),
+    (0x20C1, 'X'),
+    (0x20D0, 'V'),
+    (0x20F1, 'X'),
+    (0x2100, '3', 'a/c'),
+    (0x2101, '3', 'a/s'),
+    (0x2102, 'M', 'c'),
+    (0x2103, 'M', '°c'),
+    (0x2104, 'V'),
+    ]
+
+def _seg_22() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x2105, '3', 'c/o'),
+    (0x2106, '3', 'c/u'),
+    (0x2107, 'M', 'ɛ'),
+    (0x2108, 'V'),
+    (0x2109, 'M', '°f'),
+    (0x210A, 'M', 'g'),
+    (0x210B, 'M', 'h'),
+    (0x210F, 'M', 'ħ'),
+    (0x2110, 'M', 'i'),
+    (0x2112, 'M', 'l'),
+    (0x2114, 'V'),
+    (0x2115, 'M', 'n'),
+    (0x2116, 'M', 'no'),
+    (0x2117, 'V'),
+    (0x2119, 'M', 'p'),
+    (0x211A, 'M', 'q'),
+    (0x211B, 'M', 'r'),
+    (0x211E, 'V'),
+    (0x2120, 'M', 'sm'),
+    (0x2121, 'M', 'tel'),
+    (0x2122, 'M', 'tm'),
+    (0x2123, 'V'),
+    (0x2124, 'M', 'z'),
+    (0x2125, 'V'),
+    (0x2126, 'M', 'ω'),
+    (0x2127, 'V'),
+    (0x2128, 'M', 'z'),
+    (0x2129, 'V'),
+    (0x212A, 'M', 'k'),
+    (0x212B, 'M', 'å'),
+    (0x212C, 'M', 'b'),
+    (0x212D, 'M', 'c'),
+    (0x212E, 'V'),
+    (0x212F, 'M', 'e'),
+    (0x2131, 'M', 'f'),
+    (0x2132, 'X'),
+    (0x2133, 'M', 'm'),
+    (0x2134, 'M', 'o'),
+    (0x2135, 'M', 'א'),
+    (0x2136, 'M', 'ב'),
+    (0x2137, 'M', 'ג'),
+    (0x2138, 'M', 'ד'),
+    (0x2139, 'M', 'i'),
+    (0x213A, 'V'),
+    (0x213B, 'M', 'fax'),
+    (0x213C, 'M', 'π'),
+    (0x213D, 'M', 'γ'),
+    (0x213F, 'M', 'π'),
+    (0x2140, 'M', '∑'),
+    (0x2141, 'V'),
+    (0x2145, 'M', 'd'),
+    (0x2147, 'M', 'e'),
+    (0x2148, 'M', 'i'),
+    (0x2149, 'M', 'j'),
+    (0x214A, 'V'),
+    (0x2150, 'M', '1⁄7'),
+    (0x2151, 'M', '1⁄9'),
+    (0x2152, 'M', '1⁄10'),
+    (0x2153, 'M', '1⁄3'),
+    (0x2154, 'M', '2⁄3'),
+    (0x2155, 'M', '1⁄5'),
+    (0x2156, 'M', '2⁄5'),
+    (0x2157, 'M', '3⁄5'),
+    (0x2158, 'M', '4⁄5'),
+    (0x2159, 'M', '1⁄6'),
+    (0x215A, 'M', '5⁄6'),
+    (0x215B, 'M', '1⁄8'),
+    (0x215C, 'M', '3⁄8'),
+    (0x215D, 'M', '5⁄8'),
+    (0x215E, 'M', '7⁄8'),
+    (0x215F, 'M', '1⁄'),
+    (0x2160, 'M', 'i'),
+    (0x2161, 'M', 'ii'),
+    (0x2162, 'M', 'iii'),
+    (0x2163, 'M', 'iv'),
+    (0x2164, 'M', 'v'),
+    (0x2165, 'M', 'vi'),
+    (0x2166, 'M', 'vii'),
+    (0x2167, 'M', 'viii'),
+    (0x2168, 'M', 'ix'),
+    (0x2169, 'M', 'x'),
+    (0x216A, 'M', 'xi'),
+    (0x216B, 'M', 'xii'),
+    (0x216C, 'M', 'l'),
+    (0x216D, 'M', 'c'),
+    (0x216E, 'M', 'd'),
+    (0x216F, 'M', 'm'),
+    (0x2170, 'M', 'i'),
+    (0x2171, 'M', 'ii'),
+    (0x2172, 'M', 'iii'),
+    (0x2173, 'M', 'iv'),
+    (0x2174, 'M', 'v'),
+    (0x2175, 'M', 'vi'),
+    (0x2176, 'M', 'vii'),
+    (0x2177, 'M', 'viii'),
+    (0x2178, 'M', 'ix'),
+    (0x2179, 'M', 'x'),
+    (0x217A, 'M', 'xi'),
+    (0x217B, 'M', 'xii'),
+    (0x217C, 'M', 'l'),
+    ]
+
+def _seg_23() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x217D, 'M', 'c'),
+    (0x217E, 'M', 'd'),
+    (0x217F, 'M', 'm'),
+    (0x2180, 'V'),
+    (0x2183, 'X'),
+    (0x2184, 'V'),
+    (0x2189, 'M', '0⁄3'),
+    (0x218A, 'V'),
+    (0x218C, 'X'),
+    (0x2190, 'V'),
+    (0x222C, 'M', '∫∫'),
+    (0x222D, 'M', '∫∫∫'),
+    (0x222E, 'V'),
+    (0x222F, 'M', '∮∮'),
+    (0x2230, 'M', '∮∮∮'),
+    (0x2231, 'V'),
+    (0x2329, 'M', '〈'),
+    (0x232A, 'M', '〉'),
+    (0x232B, 'V'),
+    (0x2427, 'X'),
+    (0x2440, 'V'),
+    (0x244B, 'X'),
+    (0x2460, 'M', '1'),
+    (0x2461, 'M', '2'),
+    (0x2462, 'M', '3'),
+    (0x2463, 'M', '4'),
+    (0x2464, 'M', '5'),
+    (0x2465, 'M', '6'),
+    (0x2466, 'M', '7'),
+    (0x2467, 'M', '8'),
+    (0x2468, 'M', '9'),
+    (0x2469, 'M', '10'),
+    (0x246A, 'M', '11'),
+    (0x246B, 'M', '12'),
+    (0x246C, 'M', '13'),
+    (0x246D, 'M', '14'),
+    (0x246E, 'M', '15'),
+    (0x246F, 'M', '16'),
+    (0x2470, 'M', '17'),
+    (0x2471, 'M', '18'),
+    (0x2472, 'M', '19'),
+    (0x2473, 'M', '20'),
+    (0x2474, '3', '(1)'),
+    (0x2475, '3', '(2)'),
+    (0x2476, '3', '(3)'),
+    (0x2477, '3', '(4)'),
+    (0x2478, '3', '(5)'),
+    (0x2479, '3', '(6)'),
+    (0x247A, '3', '(7)'),
+    (0x247B, '3', '(8)'),
+    (0x247C, '3', '(9)'),
+    (0x247D, '3', '(10)'),
+    (0x247E, '3', '(11)'),
+    (0x247F, '3', '(12)'),
+    (0x2480, '3', '(13)'),
+    (0x2481, '3', '(14)'),
+    (0x2482, '3', '(15)'),
+    (0x2483, '3', '(16)'),
+    (0x2484, '3', '(17)'),
+    (0x2485, '3', '(18)'),
+    (0x2486, '3', '(19)'),
+    (0x2487, '3', '(20)'),
+    (0x2488, 'X'),
+    (0x249C, '3', '(a)'),
+    (0x249D, '3', '(b)'),
+    (0x249E, '3', '(c)'),
+    (0x249F, '3', '(d)'),
+    (0x24A0, '3', '(e)'),
+    (0x24A1, '3', '(f)'),
+    (0x24A2, '3', '(g)'),
+    (0x24A3, '3', '(h)'),
+    (0x24A4, '3', '(i)'),
+    (0x24A5, '3', '(j)'),
+    (0x24A6, '3', '(k)'),
+    (0x24A7, '3', '(l)'),
+    (0x24A8, '3', '(m)'),
+    (0x24A9, '3', '(n)'),
+    (0x24AA, '3', '(o)'),
+    (0x24AB, '3', '(p)'),
+    (0x24AC, '3', '(q)'),
+    (0x24AD, '3', '(r)'),
+    (0x24AE, '3', '(s)'),
+    (0x24AF, '3', '(t)'),
+    (0x24B0, '3', '(u)'),
+    (0x24B1, '3', '(v)'),
+    (0x24B2, '3', '(w)'),
+    (0x24B3, '3', '(x)'),
+    (0x24B4, '3', '(y)'),
+    (0x24B5, '3', '(z)'),
+    (0x24B6, 'M', 'a'),
+    (0x24B7, 'M', 'b'),
+    (0x24B8, 'M', 'c'),
+    (0x24B9, 'M', 'd'),
+    (0x24BA, 'M', 'e'),
+    (0x24BB, 'M', 'f'),
+    (0x24BC, 'M', 'g'),
+    (0x24BD, 'M', 'h'),
+    (0x24BE, 'M', 'i'),
+    (0x24BF, 'M', 'j'),
+    (0x24C0, 'M', 'k'),
+    ]
+
+def _seg_24() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x24C1, 'M', 'l'),
+    (0x24C2, 'M', 'm'),
+    (0x24C3, 'M', 'n'),
+    (0x24C4, 'M', 'o'),
+    (0x24C5, 'M', 'p'),
+    (0x24C6, 'M', 'q'),
+    (0x24C7, 'M', 'r'),
+    (0x24C8, 'M', 's'),
+    (0x24C9, 'M', 't'),
+    (0x24CA, 'M', 'u'),
+    (0x24CB, 'M', 'v'),
+    (0x24CC, 'M', 'w'),
+    (0x24CD, 'M', 'x'),
+    (0x24CE, 'M', 'y'),
+    (0x24CF, 'M', 'z'),
+    (0x24D0, 'M', 'a'),
+    (0x24D1, 'M', 'b'),
+    (0x24D2, 'M', 'c'),
+    (0x24D3, 'M', 'd'),
+    (0x24D4, 'M', 'e'),
+    (0x24D5, 'M', 'f'),
+    (0x24D6, 'M', 'g'),
+    (0x24D7, 'M', 'h'),
+    (0x24D8, 'M', 'i'),
+    (0x24D9, 'M', 'j'),
+    (0x24DA, 'M', 'k'),
+    (0x24DB, 'M', 'l'),
+    (0x24DC, 'M', 'm'),
+    (0x24DD, 'M', 'n'),
+    (0x24DE, 'M', 'o'),
+    (0x24DF, 'M', 'p'),
+    (0x24E0, 'M', 'q'),
+    (0x24E1, 'M', 'r'),
+    (0x24E2, 'M', 's'),
+    (0x24E3, 'M', 't'),
+    (0x24E4, 'M', 'u'),
+    (0x24E5, 'M', 'v'),
+    (0x24E6, 'M', 'w'),
+    (0x24E7, 'M', 'x'),
+    (0x24E8, 'M', 'y'),
+    (0x24E9, 'M', 'z'),
+    (0x24EA, 'M', '0'),
+    (0x24EB, 'V'),
+    (0x2A0C, 'M', '∫∫∫∫'),
+    (0x2A0D, 'V'),
+    (0x2A74, '3', '::='),
+    (0x2A75, '3', '=='),
+    (0x2A76, '3', '==='),
+    (0x2A77, 'V'),
+    (0x2ADC, 'M', '⫝̸'),
+    (0x2ADD, 'V'),
+    (0x2B74, 'X'),
+    (0x2B76, 'V'),
+    (0x2B96, 'X'),
+    (0x2B97, 'V'),
+    (0x2C00, 'M', 'ⰰ'),
+    (0x2C01, 'M', 'ⰱ'),
+    (0x2C02, 'M', 'ⰲ'),
+    (0x2C03, 'M', 'ⰳ'),
+    (0x2C04, 'M', 'ⰴ'),
+    (0x2C05, 'M', 'ⰵ'),
+    (0x2C06, 'M', 'ⰶ'),
+    (0x2C07, 'M', 'ⰷ'),
+    (0x2C08, 'M', 'ⰸ'),
+    (0x2C09, 'M', 'ⰹ'),
+    (0x2C0A, 'M', 'ⰺ'),
+    (0x2C0B, 'M', 'ⰻ'),
+    (0x2C0C, 'M', 'ⰼ'),
+    (0x2C0D, 'M', 'ⰽ'),
+    (0x2C0E, 'M', 'ⰾ'),
+    (0x2C0F, 'M', 'ⰿ'),
+    (0x2C10, 'M', 'ⱀ'),
+    (0x2C11, 'M', 'ⱁ'),
+    (0x2C12, 'M', 'ⱂ'),
+    (0x2C13, 'M', 'ⱃ'),
+    (0x2C14, 'M', 'ⱄ'),
+    (0x2C15, 'M', 'ⱅ'),
+    (0x2C16, 'M', 'ⱆ'),
+    (0x2C17, 'M', 'ⱇ'),
+    (0x2C18, 'M', 'ⱈ'),
+    (0x2C19, 'M', 'ⱉ'),
+    (0x2C1A, 'M', 'ⱊ'),
+    (0x2C1B, 'M', 'ⱋ'),
+    (0x2C1C, 'M', 'ⱌ'),
+    (0x2C1D, 'M', 'ⱍ'),
+    (0x2C1E, 'M', 'ⱎ'),
+    (0x2C1F, 'M', 'ⱏ'),
+    (0x2C20, 'M', 'ⱐ'),
+    (0x2C21, 'M', 'ⱑ'),
+    (0x2C22, 'M', 'ⱒ'),
+    (0x2C23, 'M', 'ⱓ'),
+    (0x2C24, 'M', 'ⱔ'),
+    (0x2C25, 'M', 'ⱕ'),
+    (0x2C26, 'M', 'ⱖ'),
+    (0x2C27, 'M', 'ⱗ'),
+    (0x2C28, 'M', 'ⱘ'),
+    (0x2C29, 'M', 'ⱙ'),
+    (0x2C2A, 'M', 'ⱚ'),
+    (0x2C2B, 'M', 'ⱛ'),
+    (0x2C2C, 'M', 'ⱜ'),
+    ]
+
+def _seg_25() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x2C2D, 'M', 'ⱝ'),
+    (0x2C2E, 'M', 'ⱞ'),
+    (0x2C2F, 'M', 'ⱟ'),
+    (0x2C30, 'V'),
+    (0x2C60, 'M', 'ⱡ'),
+    (0x2C61, 'V'),
+    (0x2C62, 'M', 'ɫ'),
+    (0x2C63, 'M', 'ᵽ'),
+    (0x2C64, 'M', 'ɽ'),
+    (0x2C65, 'V'),
+    (0x2C67, 'M', 'ⱨ'),
+    (0x2C68, 'V'),
+    (0x2C69, 'M', 'ⱪ'),
+    (0x2C6A, 'V'),
+    (0x2C6B, 'M', 'ⱬ'),
+    (0x2C6C, 'V'),
+    (0x2C6D, 'M', 'ɑ'),
+    (0x2C6E, 'M', 'ɱ'),
+    (0x2C6F, 'M', 'ɐ'),
+    (0x2C70, 'M', 'ɒ'),
+    (0x2C71, 'V'),
+    (0x2C72, 'M', 'ⱳ'),
+    (0x2C73, 'V'),
+    (0x2C75, 'M', 'ⱶ'),
+    (0x2C76, 'V'),
+    (0x2C7C, 'M', 'j'),
+    (0x2C7D, 'M', 'v'),
+    (0x2C7E, 'M', 'ȿ'),
+    (0x2C7F, 'M', 'ɀ'),
+    (0x2C80, 'M', 'ⲁ'),
+    (0x2C81, 'V'),
+    (0x2C82, 'M', 'ⲃ'),
+    (0x2C83, 'V'),
+    (0x2C84, 'M', 'ⲅ'),
+    (0x2C85, 'V'),
+    (0x2C86, 'M', 'ⲇ'),
+    (0x2C87, 'V'),
+    (0x2C88, 'M', 'ⲉ'),
+    (0x2C89, 'V'),
+    (0x2C8A, 'M', 'ⲋ'),
+    (0x2C8B, 'V'),
+    (0x2C8C, 'M', 'ⲍ'),
+    (0x2C8D, 'V'),
+    (0x2C8E, 'M', 'ⲏ'),
+    (0x2C8F, 'V'),
+    (0x2C90, 'M', 'ⲑ'),
+    (0x2C91, 'V'),
+    (0x2C92, 'M', 'ⲓ'),
+    (0x2C93, 'V'),
+    (0x2C94, 'M', 'ⲕ'),
+    (0x2C95, 'V'),
+    (0x2C96, 'M', 'ⲗ'),
+    (0x2C97, 'V'),
+    (0x2C98, 'M', 'ⲙ'),
+    (0x2C99, 'V'),
+    (0x2C9A, 'M', 'ⲛ'),
+    (0x2C9B, 'V'),
+    (0x2C9C, 'M', 'ⲝ'),
+    (0x2C9D, 'V'),
+    (0x2C9E, 'M', 'ⲟ'),
+    (0x2C9F, 'V'),
+    (0x2CA0, 'M', 'ⲡ'),
+    (0x2CA1, 'V'),
+    (0x2CA2, 'M', 'ⲣ'),
+    (0x2CA3, 'V'),
+    (0x2CA4, 'M', 'ⲥ'),
+    (0x2CA5, 'V'),
+    (0x2CA6, 'M', 'ⲧ'),
+    (0x2CA7, 'V'),
+    (0x2CA8, 'M', 'ⲩ'),
+    (0x2CA9, 'V'),
+    (0x2CAA, 'M', 'ⲫ'),
+    (0x2CAB, 'V'),
+    (0x2CAC, 'M', 'ⲭ'),
+    (0x2CAD, 'V'),
+    (0x2CAE, 'M', 'ⲯ'),
+    (0x2CAF, 'V'),
+    (0x2CB0, 'M', 'ⲱ'),
+    (0x2CB1, 'V'),
+    (0x2CB2, 'M', 'ⲳ'),
+    (0x2CB3, 'V'),
+    (0x2CB4, 'M', 'ⲵ'),
+    (0x2CB5, 'V'),
+    (0x2CB6, 'M', 'ⲷ'),
+    (0x2CB7, 'V'),
+    (0x2CB8, 'M', 'ⲹ'),
+    (0x2CB9, 'V'),
+    (0x2CBA, 'M', 'ⲻ'),
+    (0x2CBB, 'V'),
+    (0x2CBC, 'M', 'ⲽ'),
+    (0x2CBD, 'V'),
+    (0x2CBE, 'M', 'ⲿ'),
+    (0x2CBF, 'V'),
+    (0x2CC0, 'M', 'ⳁ'),
+    (0x2CC1, 'V'),
+    (0x2CC2, 'M', 'ⳃ'),
+    (0x2CC3, 'V'),
+    (0x2CC4, 'M', 'ⳅ'),
+    (0x2CC5, 'V'),
+    (0x2CC6, 'M', 'ⳇ'),
+    ]
+
+def _seg_26() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x2CC7, 'V'),
+    (0x2CC8, 'M', 'ⳉ'),
+    (0x2CC9, 'V'),
+    (0x2CCA, 'M', 'ⳋ'),
+    (0x2CCB, 'V'),
+    (0x2CCC, 'M', 'ⳍ'),
+    (0x2CCD, 'V'),
+    (0x2CCE, 'M', 'ⳏ'),
+    (0x2CCF, 'V'),
+    (0x2CD0, 'M', 'ⳑ'),
+    (0x2CD1, 'V'),
+    (0x2CD2, 'M', 'ⳓ'),
+    (0x2CD3, 'V'),
+    (0x2CD4, 'M', 'ⳕ'),
+    (0x2CD5, 'V'),
+    (0x2CD6, 'M', 'ⳗ'),
+    (0x2CD7, 'V'),
+    (0x2CD8, 'M', 'ⳙ'),
+    (0x2CD9, 'V'),
+    (0x2CDA, 'M', 'ⳛ'),
+    (0x2CDB, 'V'),
+    (0x2CDC, 'M', 'ⳝ'),
+    (0x2CDD, 'V'),
+    (0x2CDE, 'M', 'ⳟ'),
+    (0x2CDF, 'V'),
+    (0x2CE0, 'M', 'ⳡ'),
+    (0x2CE1, 'V'),
+    (0x2CE2, 'M', 'ⳣ'),
+    (0x2CE3, 'V'),
+    (0x2CEB, 'M', 'ⳬ'),
+    (0x2CEC, 'V'),
+    (0x2CED, 'M', 'ⳮ'),
+    (0x2CEE, 'V'),
+    (0x2CF2, 'M', 'ⳳ'),
+    (0x2CF3, 'V'),
+    (0x2CF4, 'X'),
+    (0x2CF9, 'V'),
+    (0x2D26, 'X'),
+    (0x2D27, 'V'),
+    (0x2D28, 'X'),
+    (0x2D2D, 'V'),
+    (0x2D2E, 'X'),
+    (0x2D30, 'V'),
+    (0x2D68, 'X'),
+    (0x2D6F, 'M', 'ⵡ'),
+    (0x2D70, 'V'),
+    (0x2D71, 'X'),
+    (0x2D7F, 'V'),
+    (0x2D97, 'X'),
+    (0x2DA0, 'V'),
+    (0x2DA7, 'X'),
+    (0x2DA8, 'V'),
+    (0x2DAF, 'X'),
+    (0x2DB0, 'V'),
+    (0x2DB7, 'X'),
+    (0x2DB8, 'V'),
+    (0x2DBF, 'X'),
+    (0x2DC0, 'V'),
+    (0x2DC7, 'X'),
+    (0x2DC8, 'V'),
+    (0x2DCF, 'X'),
+    (0x2DD0, 'V'),
+    (0x2DD7, 'X'),
+    (0x2DD8, 'V'),
+    (0x2DDF, 'X'),
+    (0x2DE0, 'V'),
+    (0x2E5E, 'X'),
+    (0x2E80, 'V'),
+    (0x2E9A, 'X'),
+    (0x2E9B, 'V'),
+    (0x2E9F, 'M', '母'),
+    (0x2EA0, 'V'),
+    (0x2EF3, 'M', '龟'),
+    (0x2EF4, 'X'),
+    (0x2F00, 'M', '一'),
+    (0x2F01, 'M', '丨'),
+    (0x2F02, 'M', '丶'),
+    (0x2F03, 'M', '丿'),
+    (0x2F04, 'M', '乙'),
+    (0x2F05, 'M', '亅'),
+    (0x2F06, 'M', '二'),
+    (0x2F07, 'M', '亠'),
+    (0x2F08, 'M', '人'),
+    (0x2F09, 'M', '儿'),
+    (0x2F0A, 'M', '入'),
+    (0x2F0B, 'M', '八'),
+    (0x2F0C, 'M', '冂'),
+    (0x2F0D, 'M', '冖'),
+    (0x2F0E, 'M', '冫'),
+    (0x2F0F, 'M', '几'),
+    (0x2F10, 'M', '凵'),
+    (0x2F11, 'M', '刀'),
+    (0x2F12, 'M', '力'),
+    (0x2F13, 'M', '勹'),
+    (0x2F14, 'M', '匕'),
+    (0x2F15, 'M', '匚'),
+    (0x2F16, 'M', '匸'),
+    (0x2F17, 'M', '十'),
+    (0x2F18, 'M', '卜'),
+    (0x2F19, 'M', '卩'),
+    ]
+
+def _seg_27() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x2F1A, 'M', '厂'),
+    (0x2F1B, 'M', '厶'),
+    (0x2F1C, 'M', '又'),
+    (0x2F1D, 'M', '口'),
+    (0x2F1E, 'M', '囗'),
+    (0x2F1F, 'M', '土'),
+    (0x2F20, 'M', '士'),
+    (0x2F21, 'M', '夂'),
+    (0x2F22, 'M', '夊'),
+    (0x2F23, 'M', '夕'),
+    (0x2F24, 'M', '大'),
+    (0x2F25, 'M', '女'),
+    (0x2F26, 'M', '子'),
+    (0x2F27, 'M', '宀'),
+    (0x2F28, 'M', '寸'),
+    (0x2F29, 'M', '小'),
+    (0x2F2A, 'M', '尢'),
+    (0x2F2B, 'M', '尸'),
+    (0x2F2C, 'M', '屮'),
+    (0x2F2D, 'M', '山'),
+    (0x2F2E, 'M', '巛'),
+    (0x2F2F, 'M', '工'),
+    (0x2F30, 'M', '己'),
+    (0x2F31, 'M', '巾'),
+    (0x2F32, 'M', '干'),
+    (0x2F33, 'M', '幺'),
+    (0x2F34, 'M', '广'),
+    (0x2F35, 'M', '廴'),
+    (0x2F36, 'M', '廾'),
+    (0x2F37, 'M', '弋'),
+    (0x2F38, 'M', '弓'),
+    (0x2F39, 'M', '彐'),
+    (0x2F3A, 'M', '彡'),
+    (0x2F3B, 'M', '彳'),
+    (0x2F3C, 'M', '心'),
+    (0x2F3D, 'M', '戈'),
+    (0x2F3E, 'M', '戶'),
+    (0x2F3F, 'M', '手'),
+    (0x2F40, 'M', '支'),
+    (0x2F41, 'M', '攴'),
+    (0x2F42, 'M', '文'),
+    (0x2F43, 'M', '斗'),
+    (0x2F44, 'M', '斤'),
+    (0x2F45, 'M', '方'),
+    (0x2F46, 'M', '无'),
+    (0x2F47, 'M', '日'),
+    (0x2F48, 'M', '曰'),
+    (0x2F49, 'M', '月'),
+    (0x2F4A, 'M', '木'),
+    (0x2F4B, 'M', '欠'),
+    (0x2F4C, 'M', '止'),
+    (0x2F4D, 'M', '歹'),
+    (0x2F4E, 'M', '殳'),
+    (0x2F4F, 'M', '毋'),
+    (0x2F50, 'M', '比'),
+    (0x2F51, 'M', '毛'),
+    (0x2F52, 'M', '氏'),
+    (0x2F53, 'M', '气'),
+    (0x2F54, 'M', '水'),
+    (0x2F55, 'M', '火'),
+    (0x2F56, 'M', '爪'),
+    (0x2F57, 'M', '父'),
+    (0x2F58, 'M', '爻'),
+    (0x2F59, 'M', '爿'),
+    (0x2F5A, 'M', '片'),
+    (0x2F5B, 'M', '牙'),
+    (0x2F5C, 'M', '牛'),
+    (0x2F5D, 'M', '犬'),
+    (0x2F5E, 'M', '玄'),
+    (0x2F5F, 'M', '玉'),
+    (0x2F60, 'M', '瓜'),
+    (0x2F61, 'M', '瓦'),
+    (0x2F62, 'M', '甘'),
+    (0x2F63, 'M', '生'),
+    (0x2F64, 'M', '用'),
+    (0x2F65, 'M', '田'),
+    (0x2F66, 'M', '疋'),
+    (0x2F67, 'M', '疒'),
+    (0x2F68, 'M', '癶'),
+    (0x2F69, 'M', '白'),
+    (0x2F6A, 'M', '皮'),
+    (0x2F6B, 'M', '皿'),
+    (0x2F6C, 'M', '目'),
+    (0x2F6D, 'M', '矛'),
+    (0x2F6E, 'M', '矢'),
+    (0x2F6F, 'M', '石'),
+    (0x2F70, 'M', '示'),
+    (0x2F71, 'M', '禸'),
+    (0x2F72, 'M', '禾'),
+    (0x2F73, 'M', '穴'),
+    (0x2F74, 'M', '立'),
+    (0x2F75, 'M', '竹'),
+    (0x2F76, 'M', '米'),
+    (0x2F77, 'M', '糸'),
+    (0x2F78, 'M', '缶'),
+    (0x2F79, 'M', '网'),
+    (0x2F7A, 'M', '羊'),
+    (0x2F7B, 'M', '羽'),
+    (0x2F7C, 'M', '老'),
+    (0x2F7D, 'M', '而'),
+    ]
+
+def _seg_28() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x2F7E, 'M', '耒'),
+    (0x2F7F, 'M', '耳'),
+    (0x2F80, 'M', '聿'),
+    (0x2F81, 'M', '肉'),
+    (0x2F82, 'M', '臣'),
+    (0x2F83, 'M', '自'),
+    (0x2F84, 'M', '至'),
+    (0x2F85, 'M', '臼'),
+    (0x2F86, 'M', '舌'),
+    (0x2F87, 'M', '舛'),
+    (0x2F88, 'M', '舟'),
+    (0x2F89, 'M', '艮'),
+    (0x2F8A, 'M', '色'),
+    (0x2F8B, 'M', '艸'),
+    (0x2F8C, 'M', '虍'),
+    (0x2F8D, 'M', '虫'),
+    (0x2F8E, 'M', '血'),
+    (0x2F8F, 'M', '行'),
+    (0x2F90, 'M', '衣'),
+    (0x2F91, 'M', '襾'),
+    (0x2F92, 'M', '見'),
+    (0x2F93, 'M', '角'),
+    (0x2F94, 'M', '言'),
+    (0x2F95, 'M', '谷'),
+    (0x2F96, 'M', '豆'),
+    (0x2F97, 'M', '豕'),
+    (0x2F98, 'M', '豸'),
+    (0x2F99, 'M', '貝'),
+    (0x2F9A, 'M', '赤'),
+    (0x2F9B, 'M', '走'),
+    (0x2F9C, 'M', '足'),
+    (0x2F9D, 'M', '身'),
+    (0x2F9E, 'M', '車'),
+    (0x2F9F, 'M', '辛'),
+    (0x2FA0, 'M', '辰'),
+    (0x2FA1, 'M', '辵'),
+    (0x2FA2, 'M', '邑'),
+    (0x2FA3, 'M', '酉'),
+    (0x2FA4, 'M', '釆'),
+    (0x2FA5, 'M', '里'),
+    (0x2FA6, 'M', '金'),
+    (0x2FA7, 'M', '長'),
+    (0x2FA8, 'M', '門'),
+    (0x2FA9, 'M', '阜'),
+    (0x2FAA, 'M', '隶'),
+    (0x2FAB, 'M', '隹'),
+    (0x2FAC, 'M', '雨'),
+    (0x2FAD, 'M', '靑'),
+    (0x2FAE, 'M', '非'),
+    (0x2FAF, 'M', '面'),
+    (0x2FB0, 'M', '革'),
+    (0x2FB1, 'M', '韋'),
+    (0x2FB2, 'M', '韭'),
+    (0x2FB3, 'M', '音'),
+    (0x2FB4, 'M', '頁'),
+    (0x2FB5, 'M', '風'),
+    (0x2FB6, 'M', '飛'),
+    (0x2FB7, 'M', '食'),
+    (0x2FB8, 'M', '首'),
+    (0x2FB9, 'M', '香'),
+    (0x2FBA, 'M', '馬'),
+    (0x2FBB, 'M', '骨'),
+    (0x2FBC, 'M', '高'),
+    (0x2FBD, 'M', '髟'),
+    (0x2FBE, 'M', '鬥'),
+    (0x2FBF, 'M', '鬯'),
+    (0x2FC0, 'M', '鬲'),
+    (0x2FC1, 'M', '鬼'),
+    (0x2FC2, 'M', '魚'),
+    (0x2FC3, 'M', '鳥'),
+    (0x2FC4, 'M', '鹵'),
+    (0x2FC5, 'M', '鹿'),
+    (0x2FC6, 'M', '麥'),
+    (0x2FC7, 'M', '麻'),
+    (0x2FC8, 'M', '黃'),
+    (0x2FC9, 'M', '黍'),
+    (0x2FCA, 'M', '黑'),
+    (0x2FCB, 'M', '黹'),
+    (0x2FCC, 'M', '黽'),
+    (0x2FCD, 'M', '鼎'),
+    (0x2FCE, 'M', '鼓'),
+    (0x2FCF, 'M', '鼠'),
+    (0x2FD0, 'M', '鼻'),
+    (0x2FD1, 'M', '齊'),
+    (0x2FD2, 'M', '齒'),
+    (0x2FD3, 'M', '龍'),
+    (0x2FD4, 'M', '龜'),
+    (0x2FD5, 'M', '龠'),
+    (0x2FD6, 'X'),
+    (0x3000, '3', ' '),
+    (0x3001, 'V'),
+    (0x3002, 'M', '.'),
+    (0x3003, 'V'),
+    (0x3036, 'M', '〒'),
+    (0x3037, 'V'),
+    (0x3038, 'M', '十'),
+    (0x3039, 'M', '卄'),
+    (0x303A, 'M', '卅'),
+    (0x303B, 'V'),
+    (0x3040, 'X'),
+    ]
+
+def _seg_29() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x3041, 'V'),
+    (0x3097, 'X'),
+    (0x3099, 'V'),
+    (0x309B, '3', ' ゙'),
+    (0x309C, '3', ' ゚'),
+    (0x309D, 'V'),
+    (0x309F, 'M', 'より'),
+    (0x30A0, 'V'),
+    (0x30FF, 'M', 'コト'),
+    (0x3100, 'X'),
+    (0x3105, 'V'),
+    (0x3130, 'X'),
+    (0x3131, 'M', 'ᄀ'),
+    (0x3132, 'M', 'ᄁ'),
+    (0x3133, 'M', 'ᆪ'),
+    (0x3134, 'M', 'ᄂ'),
+    (0x3135, 'M', 'ᆬ'),
+    (0x3136, 'M', 'ᆭ'),
+    (0x3137, 'M', 'ᄃ'),
+    (0x3138, 'M', 'ᄄ'),
+    (0x3139, 'M', 'ᄅ'),
+    (0x313A, 'M', 'ᆰ'),
+    (0x313B, 'M', 'ᆱ'),
+    (0x313C, 'M', 'ᆲ'),
+    (0x313D, 'M', 'ᆳ'),
+    (0x313E, 'M', 'ᆴ'),
+    (0x313F, 'M', 'ᆵ'),
+    (0x3140, 'M', 'ᄚ'),
+    (0x3141, 'M', 'ᄆ'),
+    (0x3142, 'M', 'ᄇ'),
+    (0x3143, 'M', 'ᄈ'),
+    (0x3144, 'M', 'ᄡ'),
+    (0x3145, 'M', 'ᄉ'),
+    (0x3146, 'M', 'ᄊ'),
+    (0x3147, 'M', 'ᄋ'),
+    (0x3148, 'M', 'ᄌ'),
+    (0x3149, 'M', 'ᄍ'),
+    (0x314A, 'M', 'ᄎ'),
+    (0x314B, 'M', 'ᄏ'),
+    (0x314C, 'M', 'ᄐ'),
+    (0x314D, 'M', 'ᄑ'),
+    (0x314E, 'M', 'ᄒ'),
+    (0x314F, 'M', 'ᅡ'),
+    (0x3150, 'M', 'ᅢ'),
+    (0x3151, 'M', 'ᅣ'),
+    (0x3152, 'M', 'ᅤ'),
+    (0x3153, 'M', 'ᅥ'),
+    (0x3154, 'M', 'ᅦ'),
+    (0x3155, 'M', 'ᅧ'),
+    (0x3156, 'M', 'ᅨ'),
+    (0x3157, 'M', 'ᅩ'),
+    (0x3158, 'M', 'ᅪ'),
+    (0x3159, 'M', 'ᅫ'),
+    (0x315A, 'M', 'ᅬ'),
+    (0x315B, 'M', 'ᅭ'),
+    (0x315C, 'M', 'ᅮ'),
+    (0x315D, 'M', 'ᅯ'),
+    (0x315E, 'M', 'ᅰ'),
+    (0x315F, 'M', 'ᅱ'),
+    (0x3160, 'M', 'ᅲ'),
+    (0x3161, 'M', 'ᅳ'),
+    (0x3162, 'M', 'ᅴ'),
+    (0x3163, 'M', 'ᅵ'),
+    (0x3164, 'X'),
+    (0x3165, 'M', 'ᄔ'),
+    (0x3166, 'M', 'ᄕ'),
+    (0x3167, 'M', 'ᇇ'),
+    (0x3168, 'M', 'ᇈ'),
+    (0x3169, 'M', 'ᇌ'),
+    (0x316A, 'M', 'ᇎ'),
+    (0x316B, 'M', 'ᇓ'),
+    (0x316C, 'M', 'ᇗ'),
+    (0x316D, 'M', 'ᇙ'),
+    (0x316E, 'M', 'ᄜ'),
+    (0x316F, 'M', 'ᇝ'),
+    (0x3170, 'M', 'ᇟ'),
+    (0x3171, 'M', 'ᄝ'),
+    (0x3172, 'M', 'ᄞ'),
+    (0x3173, 'M', 'ᄠ'),
+    (0x3174, 'M', 'ᄢ'),
+    (0x3175, 'M', 'ᄣ'),
+    (0x3176, 'M', 'ᄧ'),
+    (0x3177, 'M', 'ᄩ'),
+    (0x3178, 'M', 'ᄫ'),
+    (0x3179, 'M', 'ᄬ'),
+    (0x317A, 'M', 'ᄭ'),
+    (0x317B, 'M', 'ᄮ'),
+    (0x317C, 'M', 'ᄯ'),
+    (0x317D, 'M', 'ᄲ'),
+    (0x317E, 'M', 'ᄶ'),
+    (0x317F, 'M', 'ᅀ'),
+    (0x3180, 'M', 'ᅇ'),
+    (0x3181, 'M', 'ᅌ'),
+    (0x3182, 'M', 'ᇱ'),
+    (0x3183, 'M', 'ᇲ'),
+    (0x3184, 'M', 'ᅗ'),
+    (0x3185, 'M', 'ᅘ'),
+    (0x3186, 'M', 'ᅙ'),
+    (0x3187, 'M', 'ᆄ'),
+    (0x3188, 'M', 'ᆅ'),
+    ]
+
+def _seg_30() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x3189, 'M', 'ᆈ'),
+    (0x318A, 'M', 'ᆑ'),
+    (0x318B, 'M', 'ᆒ'),
+    (0x318C, 'M', 'ᆔ'),
+    (0x318D, 'M', 'ᆞ'),
+    (0x318E, 'M', 'ᆡ'),
+    (0x318F, 'X'),
+    (0x3190, 'V'),
+    (0x3192, 'M', '一'),
+    (0x3193, 'M', '二'),
+    (0x3194, 'M', '三'),
+    (0x3195, 'M', '四'),
+    (0x3196, 'M', '上'),
+    (0x3197, 'M', '中'),
+    (0x3198, 'M', '下'),
+    (0x3199, 'M', '甲'),
+    (0x319A, 'M', '乙'),
+    (0x319B, 'M', '丙'),
+    (0x319C, 'M', '丁'),
+    (0x319D, 'M', '天'),
+    (0x319E, 'M', '地'),
+    (0x319F, 'M', '人'),
+    (0x31A0, 'V'),
+    (0x31E4, 'X'),
+    (0x31F0, 'V'),
+    (0x3200, '3', '(ᄀ)'),
+    (0x3201, '3', '(ᄂ)'),
+    (0x3202, '3', '(ᄃ)'),
+    (0x3203, '3', '(ᄅ)'),
+    (0x3204, '3', '(ᄆ)'),
+    (0x3205, '3', '(ᄇ)'),
+    (0x3206, '3', '(ᄉ)'),
+    (0x3207, '3', '(ᄋ)'),
+    (0x3208, '3', '(ᄌ)'),
+    (0x3209, '3', '(ᄎ)'),
+    (0x320A, '3', '(ᄏ)'),
+    (0x320B, '3', '(ᄐ)'),
+    (0x320C, '3', '(ᄑ)'),
+    (0x320D, '3', '(ᄒ)'),
+    (0x320E, '3', '(가)'),
+    (0x320F, '3', '(나)'),
+    (0x3210, '3', '(다)'),
+    (0x3211, '3', '(라)'),
+    (0x3212, '3', '(마)'),
+    (0x3213, '3', '(바)'),
+    (0x3214, '3', '(사)'),
+    (0x3215, '3', '(아)'),
+    (0x3216, '3', '(자)'),
+    (0x3217, '3', '(차)'),
+    (0x3218, '3', '(카)'),
+    (0x3219, '3', '(타)'),
+    (0x321A, '3', '(파)'),
+    (0x321B, '3', '(하)'),
+    (0x321C, '3', '(주)'),
+    (0x321D, '3', '(오전)'),
+    (0x321E, '3', '(오후)'),
+    (0x321F, 'X'),
+    (0x3220, '3', '(一)'),
+    (0x3221, '3', '(二)'),
+    (0x3222, '3', '(三)'),
+    (0x3223, '3', '(四)'),
+    (0x3224, '3', '(五)'),
+    (0x3225, '3', '(六)'),
+    (0x3226, '3', '(七)'),
+    (0x3227, '3', '(八)'),
+    (0x3228, '3', '(九)'),
+    (0x3229, '3', '(十)'),
+    (0x322A, '3', '(月)'),
+    (0x322B, '3', '(火)'),
+    (0x322C, '3', '(水)'),
+    (0x322D, '3', '(木)'),
+    (0x322E, '3', '(金)'),
+    (0x322F, '3', '(土)'),
+    (0x3230, '3', '(日)'),
+    (0x3231, '3', '(株)'),
+    (0x3232, '3', '(有)'),
+    (0x3233, '3', '(社)'),
+    (0x3234, '3', '(名)'),
+    (0x3235, '3', '(特)'),
+    (0x3236, '3', '(財)'),
+    (0x3237, '3', '(祝)'),
+    (0x3238, '3', '(労)'),
+    (0x3239, '3', '(代)'),
+    (0x323A, '3', '(呼)'),
+    (0x323B, '3', '(学)'),
+    (0x323C, '3', '(監)'),
+    (0x323D, '3', '(企)'),
+    (0x323E, '3', '(資)'),
+    (0x323F, '3', '(協)'),
+    (0x3240, '3', '(祭)'),
+    (0x3241, '3', '(休)'),
+    (0x3242, '3', '(自)'),
+    (0x3243, '3', '(至)'),
+    (0x3244, 'M', '問'),
+    (0x3245, 'M', '幼'),
+    (0x3246, 'M', '文'),
+    (0x3247, 'M', '箏'),
+    (0x3248, 'V'),
+    (0x3250, 'M', 'pte'),
+    (0x3251, 'M', '21'),
+    ]
+
+def _seg_31() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x3252, 'M', '22'),
+    (0x3253, 'M', '23'),
+    (0x3254, 'M', '24'),
+    (0x3255, 'M', '25'),
+    (0x3256, 'M', '26'),
+    (0x3257, 'M', '27'),
+    (0x3258, 'M', '28'),
+    (0x3259, 'M', '29'),
+    (0x325A, 'M', '30'),
+    (0x325B, 'M', '31'),
+    (0x325C, 'M', '32'),
+    (0x325D, 'M', '33'),
+    (0x325E, 'M', '34'),
+    (0x325F, 'M', '35'),
+    (0x3260, 'M', 'ᄀ'),
+    (0x3261, 'M', 'ᄂ'),
+    (0x3262, 'M', 'ᄃ'),
+    (0x3263, 'M', 'ᄅ'),
+    (0x3264, 'M', 'ᄆ'),
+    (0x3265, 'M', 'ᄇ'),
+    (0x3266, 'M', 'ᄉ'),
+    (0x3267, 'M', 'ᄋ'),
+    (0x3268, 'M', 'ᄌ'),
+    (0x3269, 'M', 'ᄎ'),
+    (0x326A, 'M', 'ᄏ'),
+    (0x326B, 'M', 'ᄐ'),
+    (0x326C, 'M', 'ᄑ'),
+    (0x326D, 'M', 'ᄒ'),
+    (0x326E, 'M', '가'),
+    (0x326F, 'M', '나'),
+    (0x3270, 'M', '다'),
+    (0x3271, 'M', '라'),
+    (0x3272, 'M', '마'),
+    (0x3273, 'M', '바'),
+    (0x3274, 'M', '사'),
+    (0x3275, 'M', '아'),
+    (0x3276, 'M', '자'),
+    (0x3277, 'M', '차'),
+    (0x3278, 'M', '카'),
+    (0x3279, 'M', '타'),
+    (0x327A, 'M', '파'),
+    (0x327B, 'M', '하'),
+    (0x327C, 'M', '참고'),
+    (0x327D, 'M', '주의'),
+    (0x327E, 'M', '우'),
+    (0x327F, 'V'),
+    (0x3280, 'M', '一'),
+    (0x3281, 'M', '二'),
+    (0x3282, 'M', '三'),
+    (0x3283, 'M', '四'),
+    (0x3284, 'M', '五'),
+    (0x3285, 'M', '六'),
+    (0x3286, 'M', '七'),
+    (0x3287, 'M', '八'),
+    (0x3288, 'M', '九'),
+    (0x3289, 'M', '十'),
+    (0x328A, 'M', '月'),
+    (0x328B, 'M', '火'),
+    (0x328C, 'M', '水'),
+    (0x328D, 'M', '木'),
+    (0x328E, 'M', '金'),
+    (0x328F, 'M', '土'),
+    (0x3290, 'M', '日'),
+    (0x3291, 'M', '株'),
+    (0x3292, 'M', '有'),
+    (0x3293, 'M', '社'),
+    (0x3294, 'M', '名'),
+    (0x3295, 'M', '特'),
+    (0x3296, 'M', '財'),
+    (0x3297, 'M', '祝'),
+    (0x3298, 'M', '労'),
+    (0x3299, 'M', '秘'),
+    (0x329A, 'M', '男'),
+    (0x329B, 'M', '女'),
+    (0x329C, 'M', '適'),
+    (0x329D, 'M', '優'),
+    (0x329E, 'M', '印'),
+    (0x329F, 'M', '注'),
+    (0x32A0, 'M', '項'),
+    (0x32A1, 'M', '休'),
+    (0x32A2, 'M', '写'),
+    (0x32A3, 'M', '正'),
+    (0x32A4, 'M', '上'),
+    (0x32A5, 'M', '中'),
+    (0x32A6, 'M', '下'),
+    (0x32A7, 'M', '左'),
+    (0x32A8, 'M', '右'),
+    (0x32A9, 'M', '医'),
+    (0x32AA, 'M', '宗'),
+    (0x32AB, 'M', '学'),
+    (0x32AC, 'M', '監'),
+    (0x32AD, 'M', '企'),
+    (0x32AE, 'M', '資'),
+    (0x32AF, 'M', '協'),
+    (0x32B0, 'M', '夜'),
+    (0x32B1, 'M', '36'),
+    (0x32B2, 'M', '37'),
+    (0x32B3, 'M', '38'),
+    (0x32B4, 'M', '39'),
+    (0x32B5, 'M', '40'),
+    ]
+
+def _seg_32() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x32B6, 'M', '41'),
+    (0x32B7, 'M', '42'),
+    (0x32B8, 'M', '43'),
+    (0x32B9, 'M', '44'),
+    (0x32BA, 'M', '45'),
+    (0x32BB, 'M', '46'),
+    (0x32BC, 'M', '47'),
+    (0x32BD, 'M', '48'),
+    (0x32BE, 'M', '49'),
+    (0x32BF, 'M', '50'),
+    (0x32C0, 'M', '1月'),
+    (0x32C1, 'M', '2月'),
+    (0x32C2, 'M', '3月'),
+    (0x32C3, 'M', '4月'),
+    (0x32C4, 'M', '5月'),
+    (0x32C5, 'M', '6月'),
+    (0x32C6, 'M', '7月'),
+    (0x32C7, 'M', '8月'),
+    (0x32C8, 'M', '9月'),
+    (0x32C9, 'M', '10月'),
+    (0x32CA, 'M', '11月'),
+    (0x32CB, 'M', '12月'),
+    (0x32CC, 'M', 'hg'),
+    (0x32CD, 'M', 'erg'),
+    (0x32CE, 'M', 'ev'),
+    (0x32CF, 'M', 'ltd'),
+    (0x32D0, 'M', 'ア'),
+    (0x32D1, 'M', 'イ'),
+    (0x32D2, 'M', 'ウ'),
+    (0x32D3, 'M', 'エ'),
+    (0x32D4, 'M', 'オ'),
+    (0x32D5, 'M', 'カ'),
+    (0x32D6, 'M', 'キ'),
+    (0x32D7, 'M', 'ク'),
+    (0x32D8, 'M', 'ケ'),
+    (0x32D9, 'M', 'コ'),
+    (0x32DA, 'M', 'サ'),
+    (0x32DB, 'M', 'シ'),
+    (0x32DC, 'M', 'ス'),
+    (0x32DD, 'M', 'セ'),
+    (0x32DE, 'M', 'ソ'),
+    (0x32DF, 'M', 'タ'),
+    (0x32E0, 'M', 'チ'),
+    (0x32E1, 'M', 'ツ'),
+    (0x32E2, 'M', 'テ'),
+    (0x32E3, 'M', 'ト'),
+    (0x32E4, 'M', 'ナ'),
+    (0x32E5, 'M', 'ニ'),
+    (0x32E6, 'M', 'ヌ'),
+    (0x32E7, 'M', 'ネ'),
+    (0x32E8, 'M', 'ノ'),
+    (0x32E9, 'M', 'ハ'),
+    (0x32EA, 'M', 'ヒ'),
+    (0x32EB, 'M', 'フ'),
+    (0x32EC, 'M', 'ヘ'),
+    (0x32ED, 'M', 'ホ'),
+    (0x32EE, 'M', 'マ'),
+    (0x32EF, 'M', 'ミ'),
+    (0x32F0, 'M', 'ム'),
+    (0x32F1, 'M', 'メ'),
+    (0x32F2, 'M', 'モ'),
+    (0x32F3, 'M', 'ヤ'),
+    (0x32F4, 'M', 'ユ'),
+    (0x32F5, 'M', 'ヨ'),
+    (0x32F6, 'M', 'ラ'),
+    (0x32F7, 'M', 'リ'),
+    (0x32F8, 'M', 'ル'),
+    (0x32F9, 'M', 'レ'),
+    (0x32FA, 'M', 'ロ'),
+    (0x32FB, 'M', 'ワ'),
+    (0x32FC, 'M', 'ヰ'),
+    (0x32FD, 'M', 'ヱ'),
+    (0x32FE, 'M', 'ヲ'),
+    (0x32FF, 'M', '令和'),
+    (0x3300, 'M', 'アパート'),
+    (0x3301, 'M', 'アルファ'),
+    (0x3302, 'M', 'アンペア'),
+    (0x3303, 'M', 'アール'),
+    (0x3304, 'M', 'イニング'),
+    (0x3305, 'M', 'インチ'),
+    (0x3306, 'M', 'ウォン'),
+    (0x3307, 'M', 'エスクード'),
+    (0x3308, 'M', 'エーカー'),
+    (0x3309, 'M', 'オンス'),
+    (0x330A, 'M', 'オーム'),
+    (0x330B, 'M', 'カイリ'),
+    (0x330C, 'M', 'カラット'),
+    (0x330D, 'M', 'カロリー'),
+    (0x330E, 'M', 'ガロン'),
+    (0x330F, 'M', 'ガンマ'),
+    (0x3310, 'M', 'ギガ'),
+    (0x3311, 'M', 'ギニー'),
+    (0x3312, 'M', 'キュリー'),
+    (0x3313, 'M', 'ギルダー'),
+    (0x3314, 'M', 'キロ'),
+    (0x3315, 'M', 'キログラム'),
+    (0x3316, 'M', 'キロメートル'),
+    (0x3317, 'M', 'キロワット'),
+    (0x3318, 'M', 'グラム'),
+    (0x3319, 'M', 'グラムトン'),
+    ]
+
+def _seg_33() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x331A, 'M', 'クルゼイロ'),
+    (0x331B, 'M', 'クローネ'),
+    (0x331C, 'M', 'ケース'),
+    (0x331D, 'M', 'コルナ'),
+    (0x331E, 'M', 'コーポ'),
+    (0x331F, 'M', 'サイクル'),
+    (0x3320, 'M', 'サンチーム'),
+    (0x3321, 'M', 'シリング'),
+    (0x3322, 'M', 'センチ'),
+    (0x3323, 'M', 'セント'),
+    (0x3324, 'M', 'ダース'),
+    (0x3325, 'M', 'デシ'),
+    (0x3326, 'M', 'ドル'),
+    (0x3327, 'M', 'トン'),
+    (0x3328, 'M', 'ナノ'),
+    (0x3329, 'M', 'ノット'),
+    (0x332A, 'M', 'ハイツ'),
+    (0x332B, 'M', 'パーセント'),
+    (0x332C, 'M', 'パーツ'),
+    (0x332D, 'M', 'バーレル'),
+    (0x332E, 'M', 'ピアストル'),
+    (0x332F, 'M', 'ピクル'),
+    (0x3330, 'M', 'ピコ'),
+    (0x3331, 'M', 'ビル'),
+    (0x3332, 'M', 'ファラッド'),
+    (0x3333, 'M', 'フィート'),
+    (0x3334, 'M', 'ブッシェル'),
+    (0x3335, 'M', 'フラン'),
+    (0x3336, 'M', 'ヘクタール'),
+    (0x3337, 'M', 'ペソ'),
+    (0x3338, 'M', 'ペニヒ'),
+    (0x3339, 'M', 'ヘルツ'),
+    (0x333A, 'M', 'ペンス'),
+    (0x333B, 'M', 'ページ'),
+    (0x333C, 'M', 'ベータ'),
+    (0x333D, 'M', 'ポイント'),
+    (0x333E, 'M', 'ボルト'),
+    (0x333F, 'M', 'ホン'),
+    (0x3340, 'M', 'ポンド'),
+    (0x3341, 'M', 'ホール'),
+    (0x3342, 'M', 'ホーン'),
+    (0x3343, 'M', 'マイクロ'),
+    (0x3344, 'M', 'マイル'),
+    (0x3345, 'M', 'マッハ'),
+    (0x3346, 'M', 'マルク'),
+    (0x3347, 'M', 'マンション'),
+    (0x3348, 'M', 'ミクロン'),
+    (0x3349, 'M', 'ミリ'),
+    (0x334A, 'M', 'ミリバール'),
+    (0x334B, 'M', 'メガ'),
+    (0x334C, 'M', 'メガトン'),
+    (0x334D, 'M', 'メートル'),
+    (0x334E, 'M', 'ヤード'),
+    (0x334F, 'M', 'ヤール'),
+    (0x3350, 'M', 'ユアン'),
+    (0x3351, 'M', 'リットル'),
+    (0x3352, 'M', 'リラ'),
+    (0x3353, 'M', 'ルピー'),
+    (0x3354, 'M', 'ルーブル'),
+    (0x3355, 'M', 'レム'),
+    (0x3356, 'M', 'レントゲン'),
+    (0x3357, 'M', 'ワット'),
+    (0x3358, 'M', '0点'),
+    (0x3359, 'M', '1点'),
+    (0x335A, 'M', '2点'),
+    (0x335B, 'M', '3点'),
+    (0x335C, 'M', '4点'),
+    (0x335D, 'M', '5点'),
+    (0x335E, 'M', '6点'),
+    (0x335F, 'M', '7点'),
+    (0x3360, 'M', '8点'),
+    (0x3361, 'M', '9点'),
+    (0x3362, 'M', '10点'),
+    (0x3363, 'M', '11点'),
+    (0x3364, 'M', '12点'),
+    (0x3365, 'M', '13点'),
+    (0x3366, 'M', '14点'),
+    (0x3367, 'M', '15点'),
+    (0x3368, 'M', '16点'),
+    (0x3369, 'M', '17点'),
+    (0x336A, 'M', '18点'),
+    (0x336B, 'M', '19点'),
+    (0x336C, 'M', '20点'),
+    (0x336D, 'M', '21点'),
+    (0x336E, 'M', '22点'),
+    (0x336F, 'M', '23点'),
+    (0x3370, 'M', '24点'),
+    (0x3371, 'M', 'hpa'),
+    (0x3372, 'M', 'da'),
+    (0x3373, 'M', 'au'),
+    (0x3374, 'M', 'bar'),
+    (0x3375, 'M', 'ov'),
+    (0x3376, 'M', 'pc'),
+    (0x3377, 'M', 'dm'),
+    (0x3378, 'M', 'dm2'),
+    (0x3379, 'M', 'dm3'),
+    (0x337A, 'M', 'iu'),
+    (0x337B, 'M', '平成'),
+    (0x337C, 'M', '昭和'),
+    (0x337D, 'M', '大正'),
+    ]
+
+def _seg_34() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x337E, 'M', '明治'),
+    (0x337F, 'M', '株式会社'),
+    (0x3380, 'M', 'pa'),
+    (0x3381, 'M', 'na'),
+    (0x3382, 'M', 'μa'),
+    (0x3383, 'M', 'ma'),
+    (0x3384, 'M', 'ka'),
+    (0x3385, 'M', 'kb'),
+    (0x3386, 'M', 'mb'),
+    (0x3387, 'M', 'gb'),
+    (0x3388, 'M', 'cal'),
+    (0x3389, 'M', 'kcal'),
+    (0x338A, 'M', 'pf'),
+    (0x338B, 'M', 'nf'),
+    (0x338C, 'M', 'μf'),
+    (0x338D, 'M', 'μg'),
+    (0x338E, 'M', 'mg'),
+    (0x338F, 'M', 'kg'),
+    (0x3390, 'M', 'hz'),
+    (0x3391, 'M', 'khz'),
+    (0x3392, 'M', 'mhz'),
+    (0x3393, 'M', 'ghz'),
+    (0x3394, 'M', 'thz'),
+    (0x3395, 'M', 'μl'),
+    (0x3396, 'M', 'ml'),
+    (0x3397, 'M', 'dl'),
+    (0x3398, 'M', 'kl'),
+    (0x3399, 'M', 'fm'),
+    (0x339A, 'M', 'nm'),
+    (0x339B, 'M', 'μm'),
+    (0x339C, 'M', 'mm'),
+    (0x339D, 'M', 'cm'),
+    (0x339E, 'M', 'km'),
+    (0x339F, 'M', 'mm2'),
+    (0x33A0, 'M', 'cm2'),
+    (0x33A1, 'M', 'm2'),
+    (0x33A2, 'M', 'km2'),
+    (0x33A3, 'M', 'mm3'),
+    (0x33A4, 'M', 'cm3'),
+    (0x33A5, 'M', 'm3'),
+    (0x33A6, 'M', 'km3'),
+    (0x33A7, 'M', 'm∕s'),
+    (0x33A8, 'M', 'm∕s2'),
+    (0x33A9, 'M', 'pa'),
+    (0x33AA, 'M', 'kpa'),
+    (0x33AB, 'M', 'mpa'),
+    (0x33AC, 'M', 'gpa'),
+    (0x33AD, 'M', 'rad'),
+    (0x33AE, 'M', 'rad∕s'),
+    (0x33AF, 'M', 'rad∕s2'),
+    (0x33B0, 'M', 'ps'),
+    (0x33B1, 'M', 'ns'),
+    (0x33B2, 'M', 'μs'),
+    (0x33B3, 'M', 'ms'),
+    (0x33B4, 'M', 'pv'),
+    (0x33B5, 'M', 'nv'),
+    (0x33B6, 'M', 'μv'),
+    (0x33B7, 'M', 'mv'),
+    (0x33B8, 'M', 'kv'),
+    (0x33B9, 'M', 'mv'),
+    (0x33BA, 'M', 'pw'),
+    (0x33BB, 'M', 'nw'),
+    (0x33BC, 'M', 'μw'),
+    (0x33BD, 'M', 'mw'),
+    (0x33BE, 'M', 'kw'),
+    (0x33BF, 'M', 'mw'),
+    (0x33C0, 'M', 'kω'),
+    (0x33C1, 'M', 'mω'),
+    (0x33C2, 'X'),
+    (0x33C3, 'M', 'bq'),
+    (0x33C4, 'M', 'cc'),
+    (0x33C5, 'M', 'cd'),
+    (0x33C6, 'M', 'c∕kg'),
+    (0x33C7, 'X'),
+    (0x33C8, 'M', 'db'),
+    (0x33C9, 'M', 'gy'),
+    (0x33CA, 'M', 'ha'),
+    (0x33CB, 'M', 'hp'),
+    (0x33CC, 'M', 'in'),
+    (0x33CD, 'M', 'kk'),
+    (0x33CE, 'M', 'km'),
+    (0x33CF, 'M', 'kt'),
+    (0x33D0, 'M', 'lm'),
+    (0x33D1, 'M', 'ln'),
+    (0x33D2, 'M', 'log'),
+    (0x33D3, 'M', 'lx'),
+    (0x33D4, 'M', 'mb'),
+    (0x33D5, 'M', 'mil'),
+    (0x33D6, 'M', 'mol'),
+    (0x33D7, 'M', 'ph'),
+    (0x33D8, 'X'),
+    (0x33D9, 'M', 'ppm'),
+    (0x33DA, 'M', 'pr'),
+    (0x33DB, 'M', 'sr'),
+    (0x33DC, 'M', 'sv'),
+    (0x33DD, 'M', 'wb'),
+    (0x33DE, 'M', 'v∕m'),
+    (0x33DF, 'M', 'a∕m'),
+    (0x33E0, 'M', '1日'),
+    (0x33E1, 'M', '2日'),
+    ]
+
+def _seg_35() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x33E2, 'M', '3日'),
+    (0x33E3, 'M', '4日'),
+    (0x33E4, 'M', '5日'),
+    (0x33E5, 'M', '6日'),
+    (0x33E6, 'M', '7日'),
+    (0x33E7, 'M', '8日'),
+    (0x33E8, 'M', '9日'),
+    (0x33E9, 'M', '10日'),
+    (0x33EA, 'M', '11日'),
+    (0x33EB, 'M', '12日'),
+    (0x33EC, 'M', '13日'),
+    (0x33ED, 'M', '14日'),
+    (0x33EE, 'M', '15日'),
+    (0x33EF, 'M', '16日'),
+    (0x33F0, 'M', '17日'),
+    (0x33F1, 'M', '18日'),
+    (0x33F2, 'M', '19日'),
+    (0x33F3, 'M', '20日'),
+    (0x33F4, 'M', '21日'),
+    (0x33F5, 'M', '22日'),
+    (0x33F6, 'M', '23日'),
+    (0x33F7, 'M', '24日'),
+    (0x33F8, 'M', '25日'),
+    (0x33F9, 'M', '26日'),
+    (0x33FA, 'M', '27日'),
+    (0x33FB, 'M', '28日'),
+    (0x33FC, 'M', '29日'),
+    (0x33FD, 'M', '30日'),
+    (0x33FE, 'M', '31日'),
+    (0x33FF, 'M', 'gal'),
+    (0x3400, 'V'),
+    (0xA48D, 'X'),
+    (0xA490, 'V'),
+    (0xA4C7, 'X'),
+    (0xA4D0, 'V'),
+    (0xA62C, 'X'),
+    (0xA640, 'M', 'ꙁ'),
+    (0xA641, 'V'),
+    (0xA642, 'M', 'ꙃ'),
+    (0xA643, 'V'),
+    (0xA644, 'M', 'ꙅ'),
+    (0xA645, 'V'),
+    (0xA646, 'M', 'ꙇ'),
+    (0xA647, 'V'),
+    (0xA648, 'M', 'ꙉ'),
+    (0xA649, 'V'),
+    (0xA64A, 'M', 'ꙋ'),
+    (0xA64B, 'V'),
+    (0xA64C, 'M', 'ꙍ'),
+    (0xA64D, 'V'),
+    (0xA64E, 'M', 'ꙏ'),
+    (0xA64F, 'V'),
+    (0xA650, 'M', 'ꙑ'),
+    (0xA651, 'V'),
+    (0xA652, 'M', 'ꙓ'),
+    (0xA653, 'V'),
+    (0xA654, 'M', 'ꙕ'),
+    (0xA655, 'V'),
+    (0xA656, 'M', 'ꙗ'),
+    (0xA657, 'V'),
+    (0xA658, 'M', 'ꙙ'),
+    (0xA659, 'V'),
+    (0xA65A, 'M', 'ꙛ'),
+    (0xA65B, 'V'),
+    (0xA65C, 'M', 'ꙝ'),
+    (0xA65D, 'V'),
+    (0xA65E, 'M', 'ꙟ'),
+    (0xA65F, 'V'),
+    (0xA660, 'M', 'ꙡ'),
+    (0xA661, 'V'),
+    (0xA662, 'M', 'ꙣ'),
+    (0xA663, 'V'),
+    (0xA664, 'M', 'ꙥ'),
+    (0xA665, 'V'),
+    (0xA666, 'M', 'ꙧ'),
+    (0xA667, 'V'),
+    (0xA668, 'M', 'ꙩ'),
+    (0xA669, 'V'),
+    (0xA66A, 'M', 'ꙫ'),
+    (0xA66B, 'V'),
+    (0xA66C, 'M', 'ꙭ'),
+    (0xA66D, 'V'),
+    (0xA680, 'M', 'ꚁ'),
+    (0xA681, 'V'),
+    (0xA682, 'M', 'ꚃ'),
+    (0xA683, 'V'),
+    (0xA684, 'M', 'ꚅ'),
+    (0xA685, 'V'),
+    (0xA686, 'M', 'ꚇ'),
+    (0xA687, 'V'),
+    (0xA688, 'M', 'ꚉ'),
+    (0xA689, 'V'),
+    (0xA68A, 'M', 'ꚋ'),
+    (0xA68B, 'V'),
+    (0xA68C, 'M', 'ꚍ'),
+    (0xA68D, 'V'),
+    (0xA68E, 'M', 'ꚏ'),
+    (0xA68F, 'V'),
+    (0xA690, 'M', 'ꚑ'),
+    (0xA691, 'V'),
+    ]
+
+def _seg_36() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xA692, 'M', 'ꚓ'),
+    (0xA693, 'V'),
+    (0xA694, 'M', 'ꚕ'),
+    (0xA695, 'V'),
+    (0xA696, 'M', 'ꚗ'),
+    (0xA697, 'V'),
+    (0xA698, 'M', 'ꚙ'),
+    (0xA699, 'V'),
+    (0xA69A, 'M', 'ꚛ'),
+    (0xA69B, 'V'),
+    (0xA69C, 'M', 'ъ'),
+    (0xA69D, 'M', 'ь'),
+    (0xA69E, 'V'),
+    (0xA6F8, 'X'),
+    (0xA700, 'V'),
+    (0xA722, 'M', 'ꜣ'),
+    (0xA723, 'V'),
+    (0xA724, 'M', 'ꜥ'),
+    (0xA725, 'V'),
+    (0xA726, 'M', 'ꜧ'),
+    (0xA727, 'V'),
+    (0xA728, 'M', 'ꜩ'),
+    (0xA729, 'V'),
+    (0xA72A, 'M', 'ꜫ'),
+    (0xA72B, 'V'),
+    (0xA72C, 'M', 'ꜭ'),
+    (0xA72D, 'V'),
+    (0xA72E, 'M', 'ꜯ'),
+    (0xA72F, 'V'),
+    (0xA732, 'M', 'ꜳ'),
+    (0xA733, 'V'),
+    (0xA734, 'M', 'ꜵ'),
+    (0xA735, 'V'),
+    (0xA736, 'M', 'ꜷ'),
+    (0xA737, 'V'),
+    (0xA738, 'M', 'ꜹ'),
+    (0xA739, 'V'),
+    (0xA73A, 'M', 'ꜻ'),
+    (0xA73B, 'V'),
+    (0xA73C, 'M', 'ꜽ'),
+    (0xA73D, 'V'),
+    (0xA73E, 'M', 'ꜿ'),
+    (0xA73F, 'V'),
+    (0xA740, 'M', 'ꝁ'),
+    (0xA741, 'V'),
+    (0xA742, 'M', 'ꝃ'),
+    (0xA743, 'V'),
+    (0xA744, 'M', 'ꝅ'),
+    (0xA745, 'V'),
+    (0xA746, 'M', 'ꝇ'),
+    (0xA747, 'V'),
+    (0xA748, 'M', 'ꝉ'),
+    (0xA749, 'V'),
+    (0xA74A, 'M', 'ꝋ'),
+    (0xA74B, 'V'),
+    (0xA74C, 'M', 'ꝍ'),
+    (0xA74D, 'V'),
+    (0xA74E, 'M', 'ꝏ'),
+    (0xA74F, 'V'),
+    (0xA750, 'M', 'ꝑ'),
+    (0xA751, 'V'),
+    (0xA752, 'M', 'ꝓ'),
+    (0xA753, 'V'),
+    (0xA754, 'M', 'ꝕ'),
+    (0xA755, 'V'),
+    (0xA756, 'M', 'ꝗ'),
+    (0xA757, 'V'),
+    (0xA758, 'M', 'ꝙ'),
+    (0xA759, 'V'),
+    (0xA75A, 'M', 'ꝛ'),
+    (0xA75B, 'V'),
+    (0xA75C, 'M', 'ꝝ'),
+    (0xA75D, 'V'),
+    (0xA75E, 'M', 'ꝟ'),
+    (0xA75F, 'V'),
+    (0xA760, 'M', 'ꝡ'),
+    (0xA761, 'V'),
+    (0xA762, 'M', 'ꝣ'),
+    (0xA763, 'V'),
+    (0xA764, 'M', 'ꝥ'),
+    (0xA765, 'V'),
+    (0xA766, 'M', 'ꝧ'),
+    (0xA767, 'V'),
+    (0xA768, 'M', 'ꝩ'),
+    (0xA769, 'V'),
+    (0xA76A, 'M', 'ꝫ'),
+    (0xA76B, 'V'),
+    (0xA76C, 'M', 'ꝭ'),
+    (0xA76D, 'V'),
+    (0xA76E, 'M', 'ꝯ'),
+    (0xA76F, 'V'),
+    (0xA770, 'M', 'ꝯ'),
+    (0xA771, 'V'),
+    (0xA779, 'M', 'ꝺ'),
+    (0xA77A, 'V'),
+    (0xA77B, 'M', 'ꝼ'),
+    (0xA77C, 'V'),
+    (0xA77D, 'M', 'ᵹ'),
+    (0xA77E, 'M', 'ꝿ'),
+    (0xA77F, 'V'),
+    ]
+
+def _seg_37() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xA780, 'M', 'ꞁ'),
+    (0xA781, 'V'),
+    (0xA782, 'M', 'ꞃ'),
+    (0xA783, 'V'),
+    (0xA784, 'M', 'ꞅ'),
+    (0xA785, 'V'),
+    (0xA786, 'M', 'ꞇ'),
+    (0xA787, 'V'),
+    (0xA78B, 'M', 'ꞌ'),
+    (0xA78C, 'V'),
+    (0xA78D, 'M', 'ɥ'),
+    (0xA78E, 'V'),
+    (0xA790, 'M', 'ꞑ'),
+    (0xA791, 'V'),
+    (0xA792, 'M', 'ꞓ'),
+    (0xA793, 'V'),
+    (0xA796, 'M', 'ꞗ'),
+    (0xA797, 'V'),
+    (0xA798, 'M', 'ꞙ'),
+    (0xA799, 'V'),
+    (0xA79A, 'M', 'ꞛ'),
+    (0xA79B, 'V'),
+    (0xA79C, 'M', 'ꞝ'),
+    (0xA79D, 'V'),
+    (0xA79E, 'M', 'ꞟ'),
+    (0xA79F, 'V'),
+    (0xA7A0, 'M', 'ꞡ'),
+    (0xA7A1, 'V'),
+    (0xA7A2, 'M', 'ꞣ'),
+    (0xA7A3, 'V'),
+    (0xA7A4, 'M', 'ꞥ'),
+    (0xA7A5, 'V'),
+    (0xA7A6, 'M', 'ꞧ'),
+    (0xA7A7, 'V'),
+    (0xA7A8, 'M', 'ꞩ'),
+    (0xA7A9, 'V'),
+    (0xA7AA, 'M', 'ɦ'),
+    (0xA7AB, 'M', 'ɜ'),
+    (0xA7AC, 'M', 'ɡ'),
+    (0xA7AD, 'M', 'ɬ'),
+    (0xA7AE, 'M', 'ɪ'),
+    (0xA7AF, 'V'),
+    (0xA7B0, 'M', 'ʞ'),
+    (0xA7B1, 'M', 'ʇ'),
+    (0xA7B2, 'M', 'ʝ'),
+    (0xA7B3, 'M', 'ꭓ'),
+    (0xA7B4, 'M', 'ꞵ'),
+    (0xA7B5, 'V'),
+    (0xA7B6, 'M', 'ꞷ'),
+    (0xA7B7, 'V'),
+    (0xA7B8, 'M', 'ꞹ'),
+    (0xA7B9, 'V'),
+    (0xA7BA, 'M', 'ꞻ'),
+    (0xA7BB, 'V'),
+    (0xA7BC, 'M', 'ꞽ'),
+    (0xA7BD, 'V'),
+    (0xA7BE, 'M', 'ꞿ'),
+    (0xA7BF, 'V'),
+    (0xA7C0, 'M', 'ꟁ'),
+    (0xA7C1, 'V'),
+    (0xA7C2, 'M', 'ꟃ'),
+    (0xA7C3, 'V'),
+    (0xA7C4, 'M', 'ꞔ'),
+    (0xA7C5, 'M', 'ʂ'),
+    (0xA7C6, 'M', 'ᶎ'),
+    (0xA7C7, 'M', 'ꟈ'),
+    (0xA7C8, 'V'),
+    (0xA7C9, 'M', 'ꟊ'),
+    (0xA7CA, 'V'),
+    (0xA7CB, 'X'),
+    (0xA7D0, 'M', 'ꟑ'),
+    (0xA7D1, 'V'),
+    (0xA7D2, 'X'),
+    (0xA7D3, 'V'),
+    (0xA7D4, 'X'),
+    (0xA7D5, 'V'),
+    (0xA7D6, 'M', 'ꟗ'),
+    (0xA7D7, 'V'),
+    (0xA7D8, 'M', 'ꟙ'),
+    (0xA7D9, 'V'),
+    (0xA7DA, 'X'),
+    (0xA7F2, 'M', 'c'),
+    (0xA7F3, 'M', 'f'),
+    (0xA7F4, 'M', 'q'),
+    (0xA7F5, 'M', 'ꟶ'),
+    (0xA7F6, 'V'),
+    (0xA7F8, 'M', 'ħ'),
+    (0xA7F9, 'M', 'œ'),
+    (0xA7FA, 'V'),
+    (0xA82D, 'X'),
+    (0xA830, 'V'),
+    (0xA83A, 'X'),
+    (0xA840, 'V'),
+    (0xA878, 'X'),
+    (0xA880, 'V'),
+    (0xA8C6, 'X'),
+    (0xA8CE, 'V'),
+    (0xA8DA, 'X'),
+    (0xA8E0, 'V'),
+    (0xA954, 'X'),
+    ]
+
+def _seg_38() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xA95F, 'V'),
+    (0xA97D, 'X'),
+    (0xA980, 'V'),
+    (0xA9CE, 'X'),
+    (0xA9CF, 'V'),
+    (0xA9DA, 'X'),
+    (0xA9DE, 'V'),
+    (0xA9FF, 'X'),
+    (0xAA00, 'V'),
+    (0xAA37, 'X'),
+    (0xAA40, 'V'),
+    (0xAA4E, 'X'),
+    (0xAA50, 'V'),
+    (0xAA5A, 'X'),
+    (0xAA5C, 'V'),
+    (0xAAC3, 'X'),
+    (0xAADB, 'V'),
+    (0xAAF7, 'X'),
+    (0xAB01, 'V'),
+    (0xAB07, 'X'),
+    (0xAB09, 'V'),
+    (0xAB0F, 'X'),
+    (0xAB11, 'V'),
+    (0xAB17, 'X'),
+    (0xAB20, 'V'),
+    (0xAB27, 'X'),
+    (0xAB28, 'V'),
+    (0xAB2F, 'X'),
+    (0xAB30, 'V'),
+    (0xAB5C, 'M', 'ꜧ'),
+    (0xAB5D, 'M', 'ꬷ'),
+    (0xAB5E, 'M', 'ɫ'),
+    (0xAB5F, 'M', 'ꭒ'),
+    (0xAB60, 'V'),
+    (0xAB69, 'M', 'ʍ'),
+    (0xAB6A, 'V'),
+    (0xAB6C, 'X'),
+    (0xAB70, 'M', 'Ꭰ'),
+    (0xAB71, 'M', 'Ꭱ'),
+    (0xAB72, 'M', 'Ꭲ'),
+    (0xAB73, 'M', 'Ꭳ'),
+    (0xAB74, 'M', 'Ꭴ'),
+    (0xAB75, 'M', 'Ꭵ'),
+    (0xAB76, 'M', 'Ꭶ'),
+    (0xAB77, 'M', 'Ꭷ'),
+    (0xAB78, 'M', 'Ꭸ'),
+    (0xAB79, 'M', 'Ꭹ'),
+    (0xAB7A, 'M', 'Ꭺ'),
+    (0xAB7B, 'M', 'Ꭻ'),
+    (0xAB7C, 'M', 'Ꭼ'),
+    (0xAB7D, 'M', 'Ꭽ'),
+    (0xAB7E, 'M', 'Ꭾ'),
+    (0xAB7F, 'M', 'Ꭿ'),
+    (0xAB80, 'M', 'Ꮀ'),
+    (0xAB81, 'M', 'Ꮁ'),
+    (0xAB82, 'M', 'Ꮂ'),
+    (0xAB83, 'M', 'Ꮃ'),
+    (0xAB84, 'M', 'Ꮄ'),
+    (0xAB85, 'M', 'Ꮅ'),
+    (0xAB86, 'M', 'Ꮆ'),
+    (0xAB87, 'M', 'Ꮇ'),
+    (0xAB88, 'M', 'Ꮈ'),
+    (0xAB89, 'M', 'Ꮉ'),
+    (0xAB8A, 'M', 'Ꮊ'),
+    (0xAB8B, 'M', 'Ꮋ'),
+    (0xAB8C, 'M', 'Ꮌ'),
+    (0xAB8D, 'M', 'Ꮍ'),
+    (0xAB8E, 'M', 'Ꮎ'),
+    (0xAB8F, 'M', 'Ꮏ'),
+    (0xAB90, 'M', 'Ꮐ'),
+    (0xAB91, 'M', 'Ꮑ'),
+    (0xAB92, 'M', 'Ꮒ'),
+    (0xAB93, 'M', 'Ꮓ'),
+    (0xAB94, 'M', 'Ꮔ'),
+    (0xAB95, 'M', 'Ꮕ'),
+    (0xAB96, 'M', 'Ꮖ'),
+    (0xAB97, 'M', 'Ꮗ'),
+    (0xAB98, 'M', 'Ꮘ'),
+    (0xAB99, 'M', 'Ꮙ'),
+    (0xAB9A, 'M', 'Ꮚ'),
+    (0xAB9B, 'M', 'Ꮛ'),
+    (0xAB9C, 'M', 'Ꮜ'),
+    (0xAB9D, 'M', 'Ꮝ'),
+    (0xAB9E, 'M', 'Ꮞ'),
+    (0xAB9F, 'M', 'Ꮟ'),
+    (0xABA0, 'M', 'Ꮠ'),
+    (0xABA1, 'M', 'Ꮡ'),
+    (0xABA2, 'M', 'Ꮢ'),
+    (0xABA3, 'M', 'Ꮣ'),
+    (0xABA4, 'M', 'Ꮤ'),
+    (0xABA5, 'M', 'Ꮥ'),
+    (0xABA6, 'M', 'Ꮦ'),
+    (0xABA7, 'M', 'Ꮧ'),
+    (0xABA8, 'M', 'Ꮨ'),
+    (0xABA9, 'M', 'Ꮩ'),
+    (0xABAA, 'M', 'Ꮪ'),
+    (0xABAB, 'M', 'Ꮫ'),
+    (0xABAC, 'M', 'Ꮬ'),
+    (0xABAD, 'M', 'Ꮭ'),
+    (0xABAE, 'M', 'Ꮮ'),
+    ]
+
+def _seg_39() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xABAF, 'M', 'Ꮯ'),
+    (0xABB0, 'M', 'Ꮰ'),
+    (0xABB1, 'M', 'Ꮱ'),
+    (0xABB2, 'M', 'Ꮲ'),
+    (0xABB3, 'M', 'Ꮳ'),
+    (0xABB4, 'M', 'Ꮴ'),
+    (0xABB5, 'M', 'Ꮵ'),
+    (0xABB6, 'M', 'Ꮶ'),
+    (0xABB7, 'M', 'Ꮷ'),
+    (0xABB8, 'M', 'Ꮸ'),
+    (0xABB9, 'M', 'Ꮹ'),
+    (0xABBA, 'M', 'Ꮺ'),
+    (0xABBB, 'M', 'Ꮻ'),
+    (0xABBC, 'M', 'Ꮼ'),
+    (0xABBD, 'M', 'Ꮽ'),
+    (0xABBE, 'M', 'Ꮾ'),
+    (0xABBF, 'M', 'Ꮿ'),
+    (0xABC0, 'V'),
+    (0xABEE, 'X'),
+    (0xABF0, 'V'),
+    (0xABFA, 'X'),
+    (0xAC00, 'V'),
+    (0xD7A4, 'X'),
+    (0xD7B0, 'V'),
+    (0xD7C7, 'X'),
+    (0xD7CB, 'V'),
+    (0xD7FC, 'X'),
+    (0xF900, 'M', '豈'),
+    (0xF901, 'M', '更'),
+    (0xF902, 'M', '車'),
+    (0xF903, 'M', '賈'),
+    (0xF904, 'M', '滑'),
+    (0xF905, 'M', '串'),
+    (0xF906, 'M', '句'),
+    (0xF907, 'M', '龜'),
+    (0xF909, 'M', '契'),
+    (0xF90A, 'M', '金'),
+    (0xF90B, 'M', '喇'),
+    (0xF90C, 'M', '奈'),
+    (0xF90D, 'M', '懶'),
+    (0xF90E, 'M', '癩'),
+    (0xF90F, 'M', '羅'),
+    (0xF910, 'M', '蘿'),
+    (0xF911, 'M', '螺'),
+    (0xF912, 'M', '裸'),
+    (0xF913, 'M', '邏'),
+    (0xF914, 'M', '樂'),
+    (0xF915, 'M', '洛'),
+    (0xF916, 'M', '烙'),
+    (0xF917, 'M', '珞'),
+    (0xF918, 'M', '落'),
+    (0xF919, 'M', '酪'),
+    (0xF91A, 'M', '駱'),
+    (0xF91B, 'M', '亂'),
+    (0xF91C, 'M', '卵'),
+    (0xF91D, 'M', '欄'),
+    (0xF91E, 'M', '爛'),
+    (0xF91F, 'M', '蘭'),
+    (0xF920, 'M', '鸞'),
+    (0xF921, 'M', '嵐'),
+    (0xF922, 'M', '濫'),
+    (0xF923, 'M', '藍'),
+    (0xF924, 'M', '襤'),
+    (0xF925, 'M', '拉'),
+    (0xF926, 'M', '臘'),
+    (0xF927, 'M', '蠟'),
+    (0xF928, 'M', '廊'),
+    (0xF929, 'M', '朗'),
+    (0xF92A, 'M', '浪'),
+    (0xF92B, 'M', '狼'),
+    (0xF92C, 'M', '郎'),
+    (0xF92D, 'M', '來'),
+    (0xF92E, 'M', '冷'),
+    (0xF92F, 'M', '勞'),
+    (0xF930, 'M', '擄'),
+    (0xF931, 'M', '櫓'),
+    (0xF932, 'M', '爐'),
+    (0xF933, 'M', '盧'),
+    (0xF934, 'M', '老'),
+    (0xF935, 'M', '蘆'),
+    (0xF936, 'M', '虜'),
+    (0xF937, 'M', '路'),
+    (0xF938, 'M', '露'),
+    (0xF939, 'M', '魯'),
+    (0xF93A, 'M', '鷺'),
+    (0xF93B, 'M', '碌'),
+    (0xF93C, 'M', '祿'),
+    (0xF93D, 'M', '綠'),
+    (0xF93E, 'M', '菉'),
+    (0xF93F, 'M', '錄'),
+    (0xF940, 'M', '鹿'),
+    (0xF941, 'M', '論'),
+    (0xF942, 'M', '壟'),
+    (0xF943, 'M', '弄'),
+    (0xF944, 'M', '籠'),
+    (0xF945, 'M', '聾'),
+    (0xF946, 'M', '牢'),
+    (0xF947, 'M', '磊'),
+    (0xF948, 'M', '賂'),
+    (0xF949, 'M', '雷'),
+    ]
+
+def _seg_40() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xF94A, 'M', '壘'),
+    (0xF94B, 'M', '屢'),
+    (0xF94C, 'M', '樓'),
+    (0xF94D, 'M', '淚'),
+    (0xF94E, 'M', '漏'),
+    (0xF94F, 'M', '累'),
+    (0xF950, 'M', '縷'),
+    (0xF951, 'M', '陋'),
+    (0xF952, 'M', '勒'),
+    (0xF953, 'M', '肋'),
+    (0xF954, 'M', '凜'),
+    (0xF955, 'M', '凌'),
+    (0xF956, 'M', '稜'),
+    (0xF957, 'M', '綾'),
+    (0xF958, 'M', '菱'),
+    (0xF959, 'M', '陵'),
+    (0xF95A, 'M', '讀'),
+    (0xF95B, 'M', '拏'),
+    (0xF95C, 'M', '樂'),
+    (0xF95D, 'M', '諾'),
+    (0xF95E, 'M', '丹'),
+    (0xF95F, 'M', '寧'),
+    (0xF960, 'M', '怒'),
+    (0xF961, 'M', '率'),
+    (0xF962, 'M', '異'),
+    (0xF963, 'M', '北'),
+    (0xF964, 'M', '磻'),
+    (0xF965, 'M', '便'),
+    (0xF966, 'M', '復'),
+    (0xF967, 'M', '不'),
+    (0xF968, 'M', '泌'),
+    (0xF969, 'M', '數'),
+    (0xF96A, 'M', '索'),
+    (0xF96B, 'M', '參'),
+    (0xF96C, 'M', '塞'),
+    (0xF96D, 'M', '省'),
+    (0xF96E, 'M', '葉'),
+    (0xF96F, 'M', '說'),
+    (0xF970, 'M', '殺'),
+    (0xF971, 'M', '辰'),
+    (0xF972, 'M', '沈'),
+    (0xF973, 'M', '拾'),
+    (0xF974, 'M', '若'),
+    (0xF975, 'M', '掠'),
+    (0xF976, 'M', '略'),
+    (0xF977, 'M', '亮'),
+    (0xF978, 'M', '兩'),
+    (0xF979, 'M', '凉'),
+    (0xF97A, 'M', '梁'),
+    (0xF97B, 'M', '糧'),
+    (0xF97C, 'M', '良'),
+    (0xF97D, 'M', '諒'),
+    (0xF97E, 'M', '量'),
+    (0xF97F, 'M', '勵'),
+    (0xF980, 'M', '呂'),
+    (0xF981, 'M', '女'),
+    (0xF982, 'M', '廬'),
+    (0xF983, 'M', '旅'),
+    (0xF984, 'M', '濾'),
+    (0xF985, 'M', '礪'),
+    (0xF986, 'M', '閭'),
+    (0xF987, 'M', '驪'),
+    (0xF988, 'M', '麗'),
+    (0xF989, 'M', '黎'),
+    (0xF98A, 'M', '力'),
+    (0xF98B, 'M', '曆'),
+    (0xF98C, 'M', '歷'),
+    (0xF98D, 'M', '轢'),
+    (0xF98E, 'M', '年'),
+    (0xF98F, 'M', '憐'),
+    (0xF990, 'M', '戀'),
+    (0xF991, 'M', '撚'),
+    (0xF992, 'M', '漣'),
+    (0xF993, 'M', '煉'),
+    (0xF994, 'M', '璉'),
+    (0xF995, 'M', '秊'),
+    (0xF996, 'M', '練'),
+    (0xF997, 'M', '聯'),
+    (0xF998, 'M', '輦'),
+    (0xF999, 'M', '蓮'),
+    (0xF99A, 'M', '連'),
+    (0xF99B, 'M', '鍊'),
+    (0xF99C, 'M', '列'),
+    (0xF99D, 'M', '劣'),
+    (0xF99E, 'M', '咽'),
+    (0xF99F, 'M', '烈'),
+    (0xF9A0, 'M', '裂'),
+    (0xF9A1, 'M', '說'),
+    (0xF9A2, 'M', '廉'),
+    (0xF9A3, 'M', '念'),
+    (0xF9A4, 'M', '捻'),
+    (0xF9A5, 'M', '殮'),
+    (0xF9A6, 'M', '簾'),
+    (0xF9A7, 'M', '獵'),
+    (0xF9A8, 'M', '令'),
+    (0xF9A9, 'M', '囹'),
+    (0xF9AA, 'M', '寧'),
+    (0xF9AB, 'M', '嶺'),
+    (0xF9AC, 'M', '怜'),
+    (0xF9AD, 'M', '玲'),
+    ]
+
+def _seg_41() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xF9AE, 'M', '瑩'),
+    (0xF9AF, 'M', '羚'),
+    (0xF9B0, 'M', '聆'),
+    (0xF9B1, 'M', '鈴'),
+    (0xF9B2, 'M', '零'),
+    (0xF9B3, 'M', '靈'),
+    (0xF9B4, 'M', '領'),
+    (0xF9B5, 'M', '例'),
+    (0xF9B6, 'M', '禮'),
+    (0xF9B7, 'M', '醴'),
+    (0xF9B8, 'M', '隸'),
+    (0xF9B9, 'M', '惡'),
+    (0xF9BA, 'M', '了'),
+    (0xF9BB, 'M', '僚'),
+    (0xF9BC, 'M', '寮'),
+    (0xF9BD, 'M', '尿'),
+    (0xF9BE, 'M', '料'),
+    (0xF9BF, 'M', '樂'),
+    (0xF9C0, 'M', '燎'),
+    (0xF9C1, 'M', '療'),
+    (0xF9C2, 'M', '蓼'),
+    (0xF9C3, 'M', '遼'),
+    (0xF9C4, 'M', '龍'),
+    (0xF9C5, 'M', '暈'),
+    (0xF9C6, 'M', '阮'),
+    (0xF9C7, 'M', '劉'),
+    (0xF9C8, 'M', '杻'),
+    (0xF9C9, 'M', '柳'),
+    (0xF9CA, 'M', '流'),
+    (0xF9CB, 'M', '溜'),
+    (0xF9CC, 'M', '琉'),
+    (0xF9CD, 'M', '留'),
+    (0xF9CE, 'M', '硫'),
+    (0xF9CF, 'M', '紐'),
+    (0xF9D0, 'M', '類'),
+    (0xF9D1, 'M', '六'),
+    (0xF9D2, 'M', '戮'),
+    (0xF9D3, 'M', '陸'),
+    (0xF9D4, 'M', '倫'),
+    (0xF9D5, 'M', '崙'),
+    (0xF9D6, 'M', '淪'),
+    (0xF9D7, 'M', '輪'),
+    (0xF9D8, 'M', '律'),
+    (0xF9D9, 'M', '慄'),
+    (0xF9DA, 'M', '栗'),
+    (0xF9DB, 'M', '率'),
+    (0xF9DC, 'M', '隆'),
+    (0xF9DD, 'M', '利'),
+    (0xF9DE, 'M', '吏'),
+    (0xF9DF, 'M', '履'),
+    (0xF9E0, 'M', '易'),
+    (0xF9E1, 'M', '李'),
+    (0xF9E2, 'M', '梨'),
+    (0xF9E3, 'M', '泥'),
+    (0xF9E4, 'M', '理'),
+    (0xF9E5, 'M', '痢'),
+    (0xF9E6, 'M', '罹'),
+    (0xF9E7, 'M', '裏'),
+    (0xF9E8, 'M', '裡'),
+    (0xF9E9, 'M', '里'),
+    (0xF9EA, 'M', '離'),
+    (0xF9EB, 'M', '匿'),
+    (0xF9EC, 'M', '溺'),
+    (0xF9ED, 'M', '吝'),
+    (0xF9EE, 'M', '燐'),
+    (0xF9EF, 'M', '璘'),
+    (0xF9F0, 'M', '藺'),
+    (0xF9F1, 'M', '隣'),
+    (0xF9F2, 'M', '鱗'),
+    (0xF9F3, 'M', '麟'),
+    (0xF9F4, 'M', '林'),
+    (0xF9F5, 'M', '淋'),
+    (0xF9F6, 'M', '臨'),
+    (0xF9F7, 'M', '立'),
+    (0xF9F8, 'M', '笠'),
+    (0xF9F9, 'M', '粒'),
+    (0xF9FA, 'M', '狀'),
+    (0xF9FB, 'M', '炙'),
+    (0xF9FC, 'M', '識'),
+    (0xF9FD, 'M', '什'),
+    (0xF9FE, 'M', '茶'),
+    (0xF9FF, 'M', '刺'),
+    (0xFA00, 'M', '切'),
+    (0xFA01, 'M', '度'),
+    (0xFA02, 'M', '拓'),
+    (0xFA03, 'M', '糖'),
+    (0xFA04, 'M', '宅'),
+    (0xFA05, 'M', '洞'),
+    (0xFA06, 'M', '暴'),
+    (0xFA07, 'M', '輻'),
+    (0xFA08, 'M', '行'),
+    (0xFA09, 'M', '降'),
+    (0xFA0A, 'M', '見'),
+    (0xFA0B, 'M', '廓'),
+    (0xFA0C, 'M', '兀'),
+    (0xFA0D, 'M', '嗀'),
+    (0xFA0E, 'V'),
+    (0xFA10, 'M', '塚'),
+    (0xFA11, 'V'),
+    (0xFA12, 'M', '晴'),
+    ]
+
+def _seg_42() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xFA13, 'V'),
+    (0xFA15, 'M', '凞'),
+    (0xFA16, 'M', '猪'),
+    (0xFA17, 'M', '益'),
+    (0xFA18, 'M', '礼'),
+    (0xFA19, 'M', '神'),
+    (0xFA1A, 'M', '祥'),
+    (0xFA1B, 'M', '福'),
+    (0xFA1C, 'M', '靖'),
+    (0xFA1D, 'M', '精'),
+    (0xFA1E, 'M', '羽'),
+    (0xFA1F, 'V'),
+    (0xFA20, 'M', '蘒'),
+    (0xFA21, 'V'),
+    (0xFA22, 'M', '諸'),
+    (0xFA23, 'V'),
+    (0xFA25, 'M', '逸'),
+    (0xFA26, 'M', '都'),
+    (0xFA27, 'V'),
+    (0xFA2A, 'M', '飯'),
+    (0xFA2B, 'M', '飼'),
+    (0xFA2C, 'M', '館'),
+    (0xFA2D, 'M', '鶴'),
+    (0xFA2E, 'M', '郞'),
+    (0xFA2F, 'M', '隷'),
+    (0xFA30, 'M', '侮'),
+    (0xFA31, 'M', '僧'),
+    (0xFA32, 'M', '免'),
+    (0xFA33, 'M', '勉'),
+    (0xFA34, 'M', '勤'),
+    (0xFA35, 'M', '卑'),
+    (0xFA36, 'M', '喝'),
+    (0xFA37, 'M', '嘆'),
+    (0xFA38, 'M', '器'),
+    (0xFA39, 'M', '塀'),
+    (0xFA3A, 'M', '墨'),
+    (0xFA3B, 'M', '層'),
+    (0xFA3C, 'M', '屮'),
+    (0xFA3D, 'M', '悔'),
+    (0xFA3E, 'M', '慨'),
+    (0xFA3F, 'M', '憎'),
+    (0xFA40, 'M', '懲'),
+    (0xFA41, 'M', '敏'),
+    (0xFA42, 'M', '既'),
+    (0xFA43, 'M', '暑'),
+    (0xFA44, 'M', '梅'),
+    (0xFA45, 'M', '海'),
+    (0xFA46, 'M', '渚'),
+    (0xFA47, 'M', '漢'),
+    (0xFA48, 'M', '煮'),
+    (0xFA49, 'M', '爫'),
+    (0xFA4A, 'M', '琢'),
+    (0xFA4B, 'M', '碑'),
+    (0xFA4C, 'M', '社'),
+    (0xFA4D, 'M', '祉'),
+    (0xFA4E, 'M', '祈'),
+    (0xFA4F, 'M', '祐'),
+    (0xFA50, 'M', '祖'),
+    (0xFA51, 'M', '祝'),
+    (0xFA52, 'M', '禍'),
+    (0xFA53, 'M', '禎'),
+    (0xFA54, 'M', '穀'),
+    (0xFA55, 'M', '突'),
+    (0xFA56, 'M', '節'),
+    (0xFA57, 'M', '練'),
+    (0xFA58, 'M', '縉'),
+    (0xFA59, 'M', '繁'),
+    (0xFA5A, 'M', '署'),
+    (0xFA5B, 'M', '者'),
+    (0xFA5C, 'M', '臭'),
+    (0xFA5D, 'M', '艹'),
+    (0xFA5F, 'M', '著'),
+    (0xFA60, 'M', '褐'),
+    (0xFA61, 'M', '視'),
+    (0xFA62, 'M', '謁'),
+    (0xFA63, 'M', '謹'),
+    (0xFA64, 'M', '賓'),
+    (0xFA65, 'M', '贈'),
+    (0xFA66, 'M', '辶'),
+    (0xFA67, 'M', '逸'),
+    (0xFA68, 'M', '難'),
+    (0xFA69, 'M', '響'),
+    (0xFA6A, 'M', '頻'),
+    (0xFA6B, 'M', '恵'),
+    (0xFA6C, 'M', '𤋮'),
+    (0xFA6D, 'M', '舘'),
+    (0xFA6E, 'X'),
+    (0xFA70, 'M', '並'),
+    (0xFA71, 'M', '况'),
+    (0xFA72, 'M', '全'),
+    (0xFA73, 'M', '侀'),
+    (0xFA74, 'M', '充'),
+    (0xFA75, 'M', '冀'),
+    (0xFA76, 'M', '勇'),
+    (0xFA77, 'M', '勺'),
+    (0xFA78, 'M', '喝'),
+    (0xFA79, 'M', '啕'),
+    (0xFA7A, 'M', '喙'),
+    (0xFA7B, 'M', '嗢'),
+    (0xFA7C, 'M', '塚'),
+    ]
+
+def _seg_43() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xFA7D, 'M', '墳'),
+    (0xFA7E, 'M', '奄'),
+    (0xFA7F, 'M', '奔'),
+    (0xFA80, 'M', '婢'),
+    (0xFA81, 'M', '嬨'),
+    (0xFA82, 'M', '廒'),
+    (0xFA83, 'M', '廙'),
+    (0xFA84, 'M', '彩'),
+    (0xFA85, 'M', '徭'),
+    (0xFA86, 'M', '惘'),
+    (0xFA87, 'M', '慎'),
+    (0xFA88, 'M', '愈'),
+    (0xFA89, 'M', '憎'),
+    (0xFA8A, 'M', '慠'),
+    (0xFA8B, 'M', '懲'),
+    (0xFA8C, 'M', '戴'),
+    (0xFA8D, 'M', '揄'),
+    (0xFA8E, 'M', '搜'),
+    (0xFA8F, 'M', '摒'),
+    (0xFA90, 'M', '敖'),
+    (0xFA91, 'M', '晴'),
+    (0xFA92, 'M', '朗'),
+    (0xFA93, 'M', '望'),
+    (0xFA94, 'M', '杖'),
+    (0xFA95, 'M', '歹'),
+    (0xFA96, 'M', '殺'),
+    (0xFA97, 'M', '流'),
+    (0xFA98, 'M', '滛'),
+    (0xFA99, 'M', '滋'),
+    (0xFA9A, 'M', '漢'),
+    (0xFA9B, 'M', '瀞'),
+    (0xFA9C, 'M', '煮'),
+    (0xFA9D, 'M', '瞧'),
+    (0xFA9E, 'M', '爵'),
+    (0xFA9F, 'M', '犯'),
+    (0xFAA0, 'M', '猪'),
+    (0xFAA1, 'M', '瑱'),
+    (0xFAA2, 'M', '甆'),
+    (0xFAA3, 'M', '画'),
+    (0xFAA4, 'M', '瘝'),
+    (0xFAA5, 'M', '瘟'),
+    (0xFAA6, 'M', '益'),
+    (0xFAA7, 'M', '盛'),
+    (0xFAA8, 'M', '直'),
+    (0xFAA9, 'M', '睊'),
+    (0xFAAA, 'M', '着'),
+    (0xFAAB, 'M', '磌'),
+    (0xFAAC, 'M', '窱'),
+    (0xFAAD, 'M', '節'),
+    (0xFAAE, 'M', '类'),
+    (0xFAAF, 'M', '絛'),
+    (0xFAB0, 'M', '練'),
+    (0xFAB1, 'M', '缾'),
+    (0xFAB2, 'M', '者'),
+    (0xFAB3, 'M', '荒'),
+    (0xFAB4, 'M', '華'),
+    (0xFAB5, 'M', '蝹'),
+    (0xFAB6, 'M', '襁'),
+    (0xFAB7, 'M', '覆'),
+    (0xFAB8, 'M', '視'),
+    (0xFAB9, 'M', '調'),
+    (0xFABA, 'M', '諸'),
+    (0xFABB, 'M', '請'),
+    (0xFABC, 'M', '謁'),
+    (0xFABD, 'M', '諾'),
+    (0xFABE, 'M', '諭'),
+    (0xFABF, 'M', '謹'),
+    (0xFAC0, 'M', '變'),
+    (0xFAC1, 'M', '贈'),
+    (0xFAC2, 'M', '輸'),
+    (0xFAC3, 'M', '遲'),
+    (0xFAC4, 'M', '醙'),
+    (0xFAC5, 'M', '鉶'),
+    (0xFAC6, 'M', '陼'),
+    (0xFAC7, 'M', '難'),
+    (0xFAC8, 'M', '靖'),
+    (0xFAC9, 'M', '韛'),
+    (0xFACA, 'M', '響'),
+    (0xFACB, 'M', '頋'),
+    (0xFACC, 'M', '頻'),
+    (0xFACD, 'M', '鬒'),
+    (0xFACE, 'M', '龜'),
+    (0xFACF, 'M', '𢡊'),
+    (0xFAD0, 'M', '𢡄'),
+    (0xFAD1, 'M', '𣏕'),
+    (0xFAD2, 'M', '㮝'),
+    (0xFAD3, 'M', '䀘'),
+    (0xFAD4, 'M', '䀹'),
+    (0xFAD5, 'M', '𥉉'),
+    (0xFAD6, 'M', '𥳐'),
+    (0xFAD7, 'M', '𧻓'),
+    (0xFAD8, 'M', '齃'),
+    (0xFAD9, 'M', '龎'),
+    (0xFADA, 'X'),
+    (0xFB00, 'M', 'ff'),
+    (0xFB01, 'M', 'fi'),
+    (0xFB02, 'M', 'fl'),
+    (0xFB03, 'M', 'ffi'),
+    (0xFB04, 'M', 'ffl'),
+    (0xFB05, 'M', 'st'),
+    ]
+
+def _seg_44() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xFB07, 'X'),
+    (0xFB13, 'M', 'մն'),
+    (0xFB14, 'M', 'մե'),
+    (0xFB15, 'M', 'մի'),
+    (0xFB16, 'M', 'վն'),
+    (0xFB17, 'M', 'մխ'),
+    (0xFB18, 'X'),
+    (0xFB1D, 'M', 'יִ'),
+    (0xFB1E, 'V'),
+    (0xFB1F, 'M', 'ײַ'),
+    (0xFB20, 'M', 'ע'),
+    (0xFB21, 'M', 'א'),
+    (0xFB22, 'M', 'ד'),
+    (0xFB23, 'M', 'ה'),
+    (0xFB24, 'M', 'כ'),
+    (0xFB25, 'M', 'ל'),
+    (0xFB26, 'M', 'ם'),
+    (0xFB27, 'M', 'ר'),
+    (0xFB28, 'M', 'ת'),
+    (0xFB29, '3', '+'),
+    (0xFB2A, 'M', 'שׁ'),
+    (0xFB2B, 'M', 'שׂ'),
+    (0xFB2C, 'M', 'שּׁ'),
+    (0xFB2D, 'M', 'שּׂ'),
+    (0xFB2E, 'M', 'אַ'),
+    (0xFB2F, 'M', 'אָ'),
+    (0xFB30, 'M', 'אּ'),
+    (0xFB31, 'M', 'בּ'),
+    (0xFB32, 'M', 'גּ'),
+    (0xFB33, 'M', 'דּ'),
+    (0xFB34, 'M', 'הּ'),
+    (0xFB35, 'M', 'וּ'),
+    (0xFB36, 'M', 'זּ'),
+    (0xFB37, 'X'),
+    (0xFB38, 'M', 'טּ'),
+    (0xFB39, 'M', 'יּ'),
+    (0xFB3A, 'M', 'ךּ'),
+    (0xFB3B, 'M', 'כּ'),
+    (0xFB3C, 'M', 'לּ'),
+    (0xFB3D, 'X'),
+    (0xFB3E, 'M', 'מּ'),
+    (0xFB3F, 'X'),
+    (0xFB40, 'M', 'נּ'),
+    (0xFB41, 'M', 'סּ'),
+    (0xFB42, 'X'),
+    (0xFB43, 'M', 'ףּ'),
+    (0xFB44, 'M', 'פּ'),
+    (0xFB45, 'X'),
+    (0xFB46, 'M', 'צּ'),
+    (0xFB47, 'M', 'קּ'),
+    (0xFB48, 'M', 'רּ'),
+    (0xFB49, 'M', 'שּ'),
+    (0xFB4A, 'M', 'תּ'),
+    (0xFB4B, 'M', 'וֹ'),
+    (0xFB4C, 'M', 'בֿ'),
+    (0xFB4D, 'M', 'כֿ'),
+    (0xFB4E, 'M', 'פֿ'),
+    (0xFB4F, 'M', 'אל'),
+    (0xFB50, 'M', 'ٱ'),
+    (0xFB52, 'M', 'ٻ'),
+    (0xFB56, 'M', 'پ'),
+    (0xFB5A, 'M', 'ڀ'),
+    (0xFB5E, 'M', 'ٺ'),
+    (0xFB62, 'M', 'ٿ'),
+    (0xFB66, 'M', 'ٹ'),
+    (0xFB6A, 'M', 'ڤ'),
+    (0xFB6E, 'M', 'ڦ'),
+    (0xFB72, 'M', 'ڄ'),
+    (0xFB76, 'M', 'ڃ'),
+    (0xFB7A, 'M', 'چ'),
+    (0xFB7E, 'M', 'ڇ'),
+    (0xFB82, 'M', 'ڍ'),
+    (0xFB84, 'M', 'ڌ'),
+    (0xFB86, 'M', 'ڎ'),
+    (0xFB88, 'M', 'ڈ'),
+    (0xFB8A, 'M', 'ژ'),
+    (0xFB8C, 'M', 'ڑ'),
+    (0xFB8E, 'M', 'ک'),
+    (0xFB92, 'M', 'گ'),
+    (0xFB96, 'M', 'ڳ'),
+    (0xFB9A, 'M', 'ڱ'),
+    (0xFB9E, 'M', 'ں'),
+    (0xFBA0, 'M', 'ڻ'),
+    (0xFBA4, 'M', 'ۀ'),
+    (0xFBA6, 'M', 'ہ'),
+    (0xFBAA, 'M', 'ھ'),
+    (0xFBAE, 'M', 'ے'),
+    (0xFBB0, 'M', 'ۓ'),
+    (0xFBB2, 'V'),
+    (0xFBC3, 'X'),
+    (0xFBD3, 'M', 'ڭ'),
+    (0xFBD7, 'M', 'ۇ'),
+    (0xFBD9, 'M', 'ۆ'),
+    (0xFBDB, 'M', 'ۈ'),
+    (0xFBDD, 'M', 'ۇٴ'),
+    (0xFBDE, 'M', 'ۋ'),
+    (0xFBE0, 'M', 'ۅ'),
+    (0xFBE2, 'M', 'ۉ'),
+    (0xFBE4, 'M', 'ې'),
+    (0xFBE8, 'M', 'ى'),
+    ]
+
+def _seg_45() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xFBEA, 'M', 'ئا'),
+    (0xFBEC, 'M', 'ئە'),
+    (0xFBEE, 'M', 'ئو'),
+    (0xFBF0, 'M', 'ئۇ'),
+    (0xFBF2, 'M', 'ئۆ'),
+    (0xFBF4, 'M', 'ئۈ'),
+    (0xFBF6, 'M', 'ئې'),
+    (0xFBF9, 'M', 'ئى'),
+    (0xFBFC, 'M', 'ی'),
+    (0xFC00, 'M', 'ئج'),
+    (0xFC01, 'M', 'ئح'),
+    (0xFC02, 'M', 'ئم'),
+    (0xFC03, 'M', 'ئى'),
+    (0xFC04, 'M', 'ئي'),
+    (0xFC05, 'M', 'بج'),
+    (0xFC06, 'M', 'بح'),
+    (0xFC07, 'M', 'بخ'),
+    (0xFC08, 'M', 'بم'),
+    (0xFC09, 'M', 'بى'),
+    (0xFC0A, 'M', 'بي'),
+    (0xFC0B, 'M', 'تج'),
+    (0xFC0C, 'M', 'تح'),
+    (0xFC0D, 'M', 'تخ'),
+    (0xFC0E, 'M', 'تم'),
+    (0xFC0F, 'M', 'تى'),
+    (0xFC10, 'M', 'تي'),
+    (0xFC11, 'M', 'ثج'),
+    (0xFC12, 'M', 'ثم'),
+    (0xFC13, 'M', 'ثى'),
+    (0xFC14, 'M', 'ثي'),
+    (0xFC15, 'M', 'جح'),
+    (0xFC16, 'M', 'جم'),
+    (0xFC17, 'M', 'حج'),
+    (0xFC18, 'M', 'حم'),
+    (0xFC19, 'M', 'خج'),
+    (0xFC1A, 'M', 'خح'),
+    (0xFC1B, 'M', 'خم'),
+    (0xFC1C, 'M', 'سج'),
+    (0xFC1D, 'M', 'سح'),
+    (0xFC1E, 'M', 'سخ'),
+    (0xFC1F, 'M', 'سم'),
+    (0xFC20, 'M', 'صح'),
+    (0xFC21, 'M', 'صم'),
+    (0xFC22, 'M', 'ضج'),
+    (0xFC23, 'M', 'ضح'),
+    (0xFC24, 'M', 'ضخ'),
+    (0xFC25, 'M', 'ضم'),
+    (0xFC26, 'M', 'طح'),
+    (0xFC27, 'M', 'طم'),
+    (0xFC28, 'M', 'ظم'),
+    (0xFC29, 'M', 'عج'),
+    (0xFC2A, 'M', 'عم'),
+    (0xFC2B, 'M', 'غج'),
+    (0xFC2C, 'M', 'غم'),
+    (0xFC2D, 'M', 'فج'),
+    (0xFC2E, 'M', 'فح'),
+    (0xFC2F, 'M', 'فخ'),
+    (0xFC30, 'M', 'فم'),
+    (0xFC31, 'M', 'فى'),
+    (0xFC32, 'M', 'في'),
+    (0xFC33, 'M', 'قح'),
+    (0xFC34, 'M', 'قم'),
+    (0xFC35, 'M', 'قى'),
+    (0xFC36, 'M', 'قي'),
+    (0xFC37, 'M', 'كا'),
+    (0xFC38, 'M', 'كج'),
+    (0xFC39, 'M', 'كح'),
+    (0xFC3A, 'M', 'كخ'),
+    (0xFC3B, 'M', 'كل'),
+    (0xFC3C, 'M', 'كم'),
+    (0xFC3D, 'M', 'كى'),
+    (0xFC3E, 'M', 'كي'),
+    (0xFC3F, 'M', 'لج'),
+    (0xFC40, 'M', 'لح'),
+    (0xFC41, 'M', 'لخ'),
+    (0xFC42, 'M', 'لم'),
+    (0xFC43, 'M', 'لى'),
+    (0xFC44, 'M', 'لي'),
+    (0xFC45, 'M', 'مج'),
+    (0xFC46, 'M', 'مح'),
+    (0xFC47, 'M', 'مخ'),
+    (0xFC48, 'M', 'مم'),
+    (0xFC49, 'M', 'مى'),
+    (0xFC4A, 'M', 'مي'),
+    (0xFC4B, 'M', 'نج'),
+    (0xFC4C, 'M', 'نح'),
+    (0xFC4D, 'M', 'نخ'),
+    (0xFC4E, 'M', 'نم'),
+    (0xFC4F, 'M', 'نى'),
+    (0xFC50, 'M', 'ني'),
+    (0xFC51, 'M', 'هج'),
+    (0xFC52, 'M', 'هم'),
+    (0xFC53, 'M', 'هى'),
+    (0xFC54, 'M', 'هي'),
+    (0xFC55, 'M', 'يج'),
+    (0xFC56, 'M', 'يح'),
+    (0xFC57, 'M', 'يخ'),
+    (0xFC58, 'M', 'يم'),
+    (0xFC59, 'M', 'يى'),
+    (0xFC5A, 'M', 'يي'),
+    ]
+
+def _seg_46() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xFC5B, 'M', 'ذٰ'),
+    (0xFC5C, 'M', 'رٰ'),
+    (0xFC5D, 'M', 'ىٰ'),
+    (0xFC5E, '3', ' ٌّ'),
+    (0xFC5F, '3', ' ٍّ'),
+    (0xFC60, '3', ' َّ'),
+    (0xFC61, '3', ' ُّ'),
+    (0xFC62, '3', ' ِّ'),
+    (0xFC63, '3', ' ّٰ'),
+    (0xFC64, 'M', 'ئر'),
+    (0xFC65, 'M', 'ئز'),
+    (0xFC66, 'M', 'ئم'),
+    (0xFC67, 'M', 'ئن'),
+    (0xFC68, 'M', 'ئى'),
+    (0xFC69, 'M', 'ئي'),
+    (0xFC6A, 'M', 'بر'),
+    (0xFC6B, 'M', 'بز'),
+    (0xFC6C, 'M', 'بم'),
+    (0xFC6D, 'M', 'بن'),
+    (0xFC6E, 'M', 'بى'),
+    (0xFC6F, 'M', 'بي'),
+    (0xFC70, 'M', 'تر'),
+    (0xFC71, 'M', 'تز'),
+    (0xFC72, 'M', 'تم'),
+    (0xFC73, 'M', 'تن'),
+    (0xFC74, 'M', 'تى'),
+    (0xFC75, 'M', 'تي'),
+    (0xFC76, 'M', 'ثر'),
+    (0xFC77, 'M', 'ثز'),
+    (0xFC78, 'M', 'ثم'),
+    (0xFC79, 'M', 'ثن'),
+    (0xFC7A, 'M', 'ثى'),
+    (0xFC7B, 'M', 'ثي'),
+    (0xFC7C, 'M', 'فى'),
+    (0xFC7D, 'M', 'في'),
+    (0xFC7E, 'M', 'قى'),
+    (0xFC7F, 'M', 'قي'),
+    (0xFC80, 'M', 'كا'),
+    (0xFC81, 'M', 'كل'),
+    (0xFC82, 'M', 'كم'),
+    (0xFC83, 'M', 'كى'),
+    (0xFC84, 'M', 'كي'),
+    (0xFC85, 'M', 'لم'),
+    (0xFC86, 'M', 'لى'),
+    (0xFC87, 'M', 'لي'),
+    (0xFC88, 'M', 'ما'),
+    (0xFC89, 'M', 'مم'),
+    (0xFC8A, 'M', 'نر'),
+    (0xFC8B, 'M', 'نز'),
+    (0xFC8C, 'M', 'نم'),
+    (0xFC8D, 'M', 'نن'),
+    (0xFC8E, 'M', 'نى'),
+    (0xFC8F, 'M', 'ني'),
+    (0xFC90, 'M', 'ىٰ'),
+    (0xFC91, 'M', 'ير'),
+    (0xFC92, 'M', 'يز'),
+    (0xFC93, 'M', 'يم'),
+    (0xFC94, 'M', 'ين'),
+    (0xFC95, 'M', 'يى'),
+    (0xFC96, 'M', 'يي'),
+    (0xFC97, 'M', 'ئج'),
+    (0xFC98, 'M', 'ئح'),
+    (0xFC99, 'M', 'ئخ'),
+    (0xFC9A, 'M', 'ئم'),
+    (0xFC9B, 'M', 'ئه'),
+    (0xFC9C, 'M', 'بج'),
+    (0xFC9D, 'M', 'بح'),
+    (0xFC9E, 'M', 'بخ'),
+    (0xFC9F, 'M', 'بم'),
+    (0xFCA0, 'M', 'به'),
+    (0xFCA1, 'M', 'تج'),
+    (0xFCA2, 'M', 'تح'),
+    (0xFCA3, 'M', 'تخ'),
+    (0xFCA4, 'M', 'تم'),
+    (0xFCA5, 'M', 'ته'),
+    (0xFCA6, 'M', 'ثم'),
+    (0xFCA7, 'M', 'جح'),
+    (0xFCA8, 'M', 'جم'),
+    (0xFCA9, 'M', 'حج'),
+    (0xFCAA, 'M', 'حم'),
+    (0xFCAB, 'M', 'خج'),
+    (0xFCAC, 'M', 'خم'),
+    (0xFCAD, 'M', 'سج'),
+    (0xFCAE, 'M', 'سح'),
+    (0xFCAF, 'M', 'سخ'),
+    (0xFCB0, 'M', 'سم'),
+    (0xFCB1, 'M', 'صح'),
+    (0xFCB2, 'M', 'صخ'),
+    (0xFCB3, 'M', 'صم'),
+    (0xFCB4, 'M', 'ضج'),
+    (0xFCB5, 'M', 'ضح'),
+    (0xFCB6, 'M', 'ضخ'),
+    (0xFCB7, 'M', 'ضم'),
+    (0xFCB8, 'M', 'طح'),
+    (0xFCB9, 'M', 'ظم'),
+    (0xFCBA, 'M', 'عج'),
+    (0xFCBB, 'M', 'عم'),
+    (0xFCBC, 'M', 'غج'),
+    (0xFCBD, 'M', 'غم'),
+    (0xFCBE, 'M', 'فج'),
+    ]
+
+def _seg_47() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xFCBF, 'M', 'فح'),
+    (0xFCC0, 'M', 'فخ'),
+    (0xFCC1, 'M', 'فم'),
+    (0xFCC2, 'M', 'قح'),
+    (0xFCC3, 'M', 'قم'),
+    (0xFCC4, 'M', 'كج'),
+    (0xFCC5, 'M', 'كح'),
+    (0xFCC6, 'M', 'كخ'),
+    (0xFCC7, 'M', 'كل'),
+    (0xFCC8, 'M', 'كم'),
+    (0xFCC9, 'M', 'لج'),
+    (0xFCCA, 'M', 'لح'),
+    (0xFCCB, 'M', 'لخ'),
+    (0xFCCC, 'M', 'لم'),
+    (0xFCCD, 'M', 'له'),
+    (0xFCCE, 'M', 'مج'),
+    (0xFCCF, 'M', 'مح'),
+    (0xFCD0, 'M', 'مخ'),
+    (0xFCD1, 'M', 'مم'),
+    (0xFCD2, 'M', 'نج'),
+    (0xFCD3, 'M', 'نح'),
+    (0xFCD4, 'M', 'نخ'),
+    (0xFCD5, 'M', 'نم'),
+    (0xFCD6, 'M', 'نه'),
+    (0xFCD7, 'M', 'هج'),
+    (0xFCD8, 'M', 'هم'),
+    (0xFCD9, 'M', 'هٰ'),
+    (0xFCDA, 'M', 'يج'),
+    (0xFCDB, 'M', 'يح'),
+    (0xFCDC, 'M', 'يخ'),
+    (0xFCDD, 'M', 'يم'),
+    (0xFCDE, 'M', 'يه'),
+    (0xFCDF, 'M', 'ئم'),
+    (0xFCE0, 'M', 'ئه'),
+    (0xFCE1, 'M', 'بم'),
+    (0xFCE2, 'M', 'به'),
+    (0xFCE3, 'M', 'تم'),
+    (0xFCE4, 'M', 'ته'),
+    (0xFCE5, 'M', 'ثم'),
+    (0xFCE6, 'M', 'ثه'),
+    (0xFCE7, 'M', 'سم'),
+    (0xFCE8, 'M', 'سه'),
+    (0xFCE9, 'M', 'شم'),
+    (0xFCEA, 'M', 'شه'),
+    (0xFCEB, 'M', 'كل'),
+    (0xFCEC, 'M', 'كم'),
+    (0xFCED, 'M', 'لم'),
+    (0xFCEE, 'M', 'نم'),
+    (0xFCEF, 'M', 'نه'),
+    (0xFCF0, 'M', 'يم'),
+    (0xFCF1, 'M', 'يه'),
+    (0xFCF2, 'M', 'ـَّ'),
+    (0xFCF3, 'M', 'ـُّ'),
+    (0xFCF4, 'M', 'ـِّ'),
+    (0xFCF5, 'M', 'طى'),
+    (0xFCF6, 'M', 'طي'),
+    (0xFCF7, 'M', 'عى'),
+    (0xFCF8, 'M', 'عي'),
+    (0xFCF9, 'M', 'غى'),
+    (0xFCFA, 'M', 'غي'),
+    (0xFCFB, 'M', 'سى'),
+    (0xFCFC, 'M', 'سي'),
+    (0xFCFD, 'M', 'شى'),
+    (0xFCFE, 'M', 'شي'),
+    (0xFCFF, 'M', 'حى'),
+    (0xFD00, 'M', 'حي'),
+    (0xFD01, 'M', 'جى'),
+    (0xFD02, 'M', 'جي'),
+    (0xFD03, 'M', 'خى'),
+    (0xFD04, 'M', 'خي'),
+    (0xFD05, 'M', 'صى'),
+    (0xFD06, 'M', 'صي'),
+    (0xFD07, 'M', 'ضى'),
+    (0xFD08, 'M', 'ضي'),
+    (0xFD09, 'M', 'شج'),
+    (0xFD0A, 'M', 'شح'),
+    (0xFD0B, 'M', 'شخ'),
+    (0xFD0C, 'M', 'شم'),
+    (0xFD0D, 'M', 'شر'),
+    (0xFD0E, 'M', 'سر'),
+    (0xFD0F, 'M', 'صر'),
+    (0xFD10, 'M', 'ضر'),
+    (0xFD11, 'M', 'طى'),
+    (0xFD12, 'M', 'طي'),
+    (0xFD13, 'M', 'عى'),
+    (0xFD14, 'M', 'عي'),
+    (0xFD15, 'M', 'غى'),
+    (0xFD16, 'M', 'غي'),
+    (0xFD17, 'M', 'سى'),
+    (0xFD18, 'M', 'سي'),
+    (0xFD19, 'M', 'شى'),
+    (0xFD1A, 'M', 'شي'),
+    (0xFD1B, 'M', 'حى'),
+    (0xFD1C, 'M', 'حي'),
+    (0xFD1D, 'M', 'جى'),
+    (0xFD1E, 'M', 'جي'),
+    (0xFD1F, 'M', 'خى'),
+    (0xFD20, 'M', 'خي'),
+    (0xFD21, 'M', 'صى'),
+    (0xFD22, 'M', 'صي'),
+    ]
+
+def _seg_48() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xFD23, 'M', 'ضى'),
+    (0xFD24, 'M', 'ضي'),
+    (0xFD25, 'M', 'شج'),
+    (0xFD26, 'M', 'شح'),
+    (0xFD27, 'M', 'شخ'),
+    (0xFD28, 'M', 'شم'),
+    (0xFD29, 'M', 'شر'),
+    (0xFD2A, 'M', 'سر'),
+    (0xFD2B, 'M', 'صر'),
+    (0xFD2C, 'M', 'ضر'),
+    (0xFD2D, 'M', 'شج'),
+    (0xFD2E, 'M', 'شح'),
+    (0xFD2F, 'M', 'شخ'),
+    (0xFD30, 'M', 'شم'),
+    (0xFD31, 'M', 'سه'),
+    (0xFD32, 'M', 'شه'),
+    (0xFD33, 'M', 'طم'),
+    (0xFD34, 'M', 'سج'),
+    (0xFD35, 'M', 'سح'),
+    (0xFD36, 'M', 'سخ'),
+    (0xFD37, 'M', 'شج'),
+    (0xFD38, 'M', 'شح'),
+    (0xFD39, 'M', 'شخ'),
+    (0xFD3A, 'M', 'طم'),
+    (0xFD3B, 'M', 'ظم'),
+    (0xFD3C, 'M', 'اً'),
+    (0xFD3E, 'V'),
+    (0xFD50, 'M', 'تجم'),
+    (0xFD51, 'M', 'تحج'),
+    (0xFD53, 'M', 'تحم'),
+    (0xFD54, 'M', 'تخم'),
+    (0xFD55, 'M', 'تمج'),
+    (0xFD56, 'M', 'تمح'),
+    (0xFD57, 'M', 'تمخ'),
+    (0xFD58, 'M', 'جمح'),
+    (0xFD5A, 'M', 'حمي'),
+    (0xFD5B, 'M', 'حمى'),
+    (0xFD5C, 'M', 'سحج'),
+    (0xFD5D, 'M', 'سجح'),
+    (0xFD5E, 'M', 'سجى'),
+    (0xFD5F, 'M', 'سمح'),
+    (0xFD61, 'M', 'سمج'),
+    (0xFD62, 'M', 'سمم'),
+    (0xFD64, 'M', 'صحح'),
+    (0xFD66, 'M', 'صمم'),
+    (0xFD67, 'M', 'شحم'),
+    (0xFD69, 'M', 'شجي'),
+    (0xFD6A, 'M', 'شمخ'),
+    (0xFD6C, 'M', 'شمم'),
+    (0xFD6E, 'M', 'ضحى'),
+    (0xFD6F, 'M', 'ضخم'),
+    (0xFD71, 'M', 'طمح'),
+    (0xFD73, 'M', 'طمم'),
+    (0xFD74, 'M', 'طمي'),
+    (0xFD75, 'M', 'عجم'),
+    (0xFD76, 'M', 'عمم'),
+    (0xFD78, 'M', 'عمى'),
+    (0xFD79, 'M', 'غمم'),
+    (0xFD7A, 'M', 'غمي'),
+    (0xFD7B, 'M', 'غمى'),
+    (0xFD7C, 'M', 'فخم'),
+    (0xFD7E, 'M', 'قمح'),
+    (0xFD7F, 'M', 'قمم'),
+    (0xFD80, 'M', 'لحم'),
+    (0xFD81, 'M', 'لحي'),
+    (0xFD82, 'M', 'لحى'),
+    (0xFD83, 'M', 'لجج'),
+    (0xFD85, 'M', 'لخم'),
+    (0xFD87, 'M', 'لمح'),
+    (0xFD89, 'M', 'محج'),
+    (0xFD8A, 'M', 'محم'),
+    (0xFD8B, 'M', 'محي'),
+    (0xFD8C, 'M', 'مجح'),
+    (0xFD8D, 'M', 'مجم'),
+    (0xFD8E, 'M', 'مخج'),
+    (0xFD8F, 'M', 'مخم'),
+    (0xFD90, 'X'),
+    (0xFD92, 'M', 'مجخ'),
+    (0xFD93, 'M', 'همج'),
+    (0xFD94, 'M', 'همم'),
+    (0xFD95, 'M', 'نحم'),
+    (0xFD96, 'M', 'نحى'),
+    (0xFD97, 'M', 'نجم'),
+    (0xFD99, 'M', 'نجى'),
+    (0xFD9A, 'M', 'نمي'),
+    (0xFD9B, 'M', 'نمى'),
+    (0xFD9C, 'M', 'يمم'),
+    (0xFD9E, 'M', 'بخي'),
+    (0xFD9F, 'M', 'تجي'),
+    (0xFDA0, 'M', 'تجى'),
+    (0xFDA1, 'M', 'تخي'),
+    (0xFDA2, 'M', 'تخى'),
+    (0xFDA3, 'M', 'تمي'),
+    (0xFDA4, 'M', 'تمى'),
+    (0xFDA5, 'M', 'جمي'),
+    (0xFDA6, 'M', 'جحى'),
+    (0xFDA7, 'M', 'جمى'),
+    (0xFDA8, 'M', 'سخى'),
+    (0xFDA9, 'M', 'صحي'),
+    (0xFDAA, 'M', 'شحي'),
+    ]
+
+def _seg_49() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xFDAB, 'M', 'ضحي'),
+    (0xFDAC, 'M', 'لجي'),
+    (0xFDAD, 'M', 'لمي'),
+    (0xFDAE, 'M', 'يحي'),
+    (0xFDAF, 'M', 'يجي'),
+    (0xFDB0, 'M', 'يمي'),
+    (0xFDB1, 'M', 'ممي'),
+    (0xFDB2, 'M', 'قمي'),
+    (0xFDB3, 'M', 'نحي'),
+    (0xFDB4, 'M', 'قمح'),
+    (0xFDB5, 'M', 'لحم'),
+    (0xFDB6, 'M', 'عمي'),
+    (0xFDB7, 'M', 'كمي'),
+    (0xFDB8, 'M', 'نجح'),
+    (0xFDB9, 'M', 'مخي'),
+    (0xFDBA, 'M', 'لجم'),
+    (0xFDBB, 'M', 'كمم'),
+    (0xFDBC, 'M', 'لجم'),
+    (0xFDBD, 'M', 'نجح'),
+    (0xFDBE, 'M', 'جحي'),
+    (0xFDBF, 'M', 'حجي'),
+    (0xFDC0, 'M', 'مجي'),
+    (0xFDC1, 'M', 'فمي'),
+    (0xFDC2, 'M', 'بحي'),
+    (0xFDC3, 'M', 'كمم'),
+    (0xFDC4, 'M', 'عجم'),
+    (0xFDC5, 'M', 'صمم'),
+    (0xFDC6, 'M', 'سخي'),
+    (0xFDC7, 'M', 'نجي'),
+    (0xFDC8, 'X'),
+    (0xFDCF, 'V'),
+    (0xFDD0, 'X'),
+    (0xFDF0, 'M', 'صلے'),
+    (0xFDF1, 'M', 'قلے'),
+    (0xFDF2, 'M', 'الله'),
+    (0xFDF3, 'M', 'اكبر'),
+    (0xFDF4, 'M', 'محمد'),
+    (0xFDF5, 'M', 'صلعم'),
+    (0xFDF6, 'M', 'رسول'),
+    (0xFDF7, 'M', 'عليه'),
+    (0xFDF8, 'M', 'وسلم'),
+    (0xFDF9, 'M', 'صلى'),
+    (0xFDFA, '3', 'صلى الله عليه وسلم'),
+    (0xFDFB, '3', 'جل جلاله'),
+    (0xFDFC, 'M', 'ریال'),
+    (0xFDFD, 'V'),
+    (0xFE00, 'I'),
+    (0xFE10, '3', ','),
+    (0xFE11, 'M', '、'),
+    (0xFE12, 'X'),
+    (0xFE13, '3', ':'),
+    (0xFE14, '3', ';'),
+    (0xFE15, '3', '!'),
+    (0xFE16, '3', '?'),
+    (0xFE17, 'M', '〖'),
+    (0xFE18, 'M', '〗'),
+    (0xFE19, 'X'),
+    (0xFE20, 'V'),
+    (0xFE30, 'X'),
+    (0xFE31, 'M', '—'),
+    (0xFE32, 'M', '–'),
+    (0xFE33, '3', '_'),
+    (0xFE35, '3', '('),
+    (0xFE36, '3', ')'),
+    (0xFE37, '3', '{'),
+    (0xFE38, '3', '}'),
+    (0xFE39, 'M', '〔'),
+    (0xFE3A, 'M', '〕'),
+    (0xFE3B, 'M', '【'),
+    (0xFE3C, 'M', '】'),
+    (0xFE3D, 'M', '《'),
+    (0xFE3E, 'M', '》'),
+    (0xFE3F, 'M', '〈'),
+    (0xFE40, 'M', '〉'),
+    (0xFE41, 'M', '「'),
+    (0xFE42, 'M', '」'),
+    (0xFE43, 'M', '『'),
+    (0xFE44, 'M', '』'),
+    (0xFE45, 'V'),
+    (0xFE47, '3', '['),
+    (0xFE48, '3', ']'),
+    (0xFE49, '3', ' ̅'),
+    (0xFE4D, '3', '_'),
+    (0xFE50, '3', ','),
+    (0xFE51, 'M', '、'),
+    (0xFE52, 'X'),
+    (0xFE54, '3', ';'),
+    (0xFE55, '3', ':'),
+    (0xFE56, '3', '?'),
+    (0xFE57, '3', '!'),
+    (0xFE58, 'M', '—'),
+    (0xFE59, '3', '('),
+    (0xFE5A, '3', ')'),
+    (0xFE5B, '3', '{'),
+    (0xFE5C, '3', '}'),
+    (0xFE5D, 'M', '〔'),
+    (0xFE5E, 'M', '〕'),
+    (0xFE5F, '3', '#'),
+    (0xFE60, '3', '&'),
+    (0xFE61, '3', '*'),
+    ]
+
+def _seg_50() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xFE62, '3', '+'),
+    (0xFE63, 'M', '-'),
+    (0xFE64, '3', '<'),
+    (0xFE65, '3', '>'),
+    (0xFE66, '3', '='),
+    (0xFE67, 'X'),
+    (0xFE68, '3', '\\'),
+    (0xFE69, '3', '$'),
+    (0xFE6A, '3', '%'),
+    (0xFE6B, '3', '@'),
+    (0xFE6C, 'X'),
+    (0xFE70, '3', ' ً'),
+    (0xFE71, 'M', 'ـً'),
+    (0xFE72, '3', ' ٌ'),
+    (0xFE73, 'V'),
+    (0xFE74, '3', ' ٍ'),
+    (0xFE75, 'X'),
+    (0xFE76, '3', ' َ'),
+    (0xFE77, 'M', 'ـَ'),
+    (0xFE78, '3', ' ُ'),
+    (0xFE79, 'M', 'ـُ'),
+    (0xFE7A, '3', ' ِ'),
+    (0xFE7B, 'M', 'ـِ'),
+    (0xFE7C, '3', ' ّ'),
+    (0xFE7D, 'M', 'ـّ'),
+    (0xFE7E, '3', ' ْ'),
+    (0xFE7F, 'M', 'ـْ'),
+    (0xFE80, 'M', 'ء'),
+    (0xFE81, 'M', 'آ'),
+    (0xFE83, 'M', 'أ'),
+    (0xFE85, 'M', 'ؤ'),
+    (0xFE87, 'M', 'إ'),
+    (0xFE89, 'M', 'ئ'),
+    (0xFE8D, 'M', 'ا'),
+    (0xFE8F, 'M', 'ب'),
+    (0xFE93, 'M', 'ة'),
+    (0xFE95, 'M', 'ت'),
+    (0xFE99, 'M', 'ث'),
+    (0xFE9D, 'M', 'ج'),
+    (0xFEA1, 'M', 'ح'),
+    (0xFEA5, 'M', 'خ'),
+    (0xFEA9, 'M', 'د'),
+    (0xFEAB, 'M', 'ذ'),
+    (0xFEAD, 'M', 'ر'),
+    (0xFEAF, 'M', 'ز'),
+    (0xFEB1, 'M', 'س'),
+    (0xFEB5, 'M', 'ش'),
+    (0xFEB9, 'M', 'ص'),
+    (0xFEBD, 'M', 'ض'),
+    (0xFEC1, 'M', 'ط'),
+    (0xFEC5, 'M', 'ظ'),
+    (0xFEC9, 'M', 'ع'),
+    (0xFECD, 'M', 'غ'),
+    (0xFED1, 'M', 'ف'),
+    (0xFED5, 'M', 'ق'),
+    (0xFED9, 'M', 'ك'),
+    (0xFEDD, 'M', 'ل'),
+    (0xFEE1, 'M', 'م'),
+    (0xFEE5, 'M', 'ن'),
+    (0xFEE9, 'M', 'ه'),
+    (0xFEED, 'M', 'و'),
+    (0xFEEF, 'M', 'ى'),
+    (0xFEF1, 'M', 'ي'),
+    (0xFEF5, 'M', 'لآ'),
+    (0xFEF7, 'M', 'لأ'),
+    (0xFEF9, 'M', 'لإ'),
+    (0xFEFB, 'M', 'لا'),
+    (0xFEFD, 'X'),
+    (0xFEFF, 'I'),
+    (0xFF00, 'X'),
+    (0xFF01, '3', '!'),
+    (0xFF02, '3', '"'),
+    (0xFF03, '3', '#'),
+    (0xFF04, '3', '$'),
+    (0xFF05, '3', '%'),
+    (0xFF06, '3', '&'),
+    (0xFF07, '3', '\''),
+    (0xFF08, '3', '('),
+    (0xFF09, '3', ')'),
+    (0xFF0A, '3', '*'),
+    (0xFF0B, '3', '+'),
+    (0xFF0C, '3', ','),
+    (0xFF0D, 'M', '-'),
+    (0xFF0E, 'M', '.'),
+    (0xFF0F, '3', '/'),
+    (0xFF10, 'M', '0'),
+    (0xFF11, 'M', '1'),
+    (0xFF12, 'M', '2'),
+    (0xFF13, 'M', '3'),
+    (0xFF14, 'M', '4'),
+    (0xFF15, 'M', '5'),
+    (0xFF16, 'M', '6'),
+    (0xFF17, 'M', '7'),
+    (0xFF18, 'M', '8'),
+    (0xFF19, 'M', '9'),
+    (0xFF1A, '3', ':'),
+    (0xFF1B, '3', ';'),
+    (0xFF1C, '3', '<'),
+    (0xFF1D, '3', '='),
+    (0xFF1E, '3', '>'),
+    ]
+
+def _seg_51() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xFF1F, '3', '?'),
+    (0xFF20, '3', '@'),
+    (0xFF21, 'M', 'a'),
+    (0xFF22, 'M', 'b'),
+    (0xFF23, 'M', 'c'),
+    (0xFF24, 'M', 'd'),
+    (0xFF25, 'M', 'e'),
+    (0xFF26, 'M', 'f'),
+    (0xFF27, 'M', 'g'),
+    (0xFF28, 'M', 'h'),
+    (0xFF29, 'M', 'i'),
+    (0xFF2A, 'M', 'j'),
+    (0xFF2B, 'M', 'k'),
+    (0xFF2C, 'M', 'l'),
+    (0xFF2D, 'M', 'm'),
+    (0xFF2E, 'M', 'n'),
+    (0xFF2F, 'M', 'o'),
+    (0xFF30, 'M', 'p'),
+    (0xFF31, 'M', 'q'),
+    (0xFF32, 'M', 'r'),
+    (0xFF33, 'M', 's'),
+    (0xFF34, 'M', 't'),
+    (0xFF35, 'M', 'u'),
+    (0xFF36, 'M', 'v'),
+    (0xFF37, 'M', 'w'),
+    (0xFF38, 'M', 'x'),
+    (0xFF39, 'M', 'y'),
+    (0xFF3A, 'M', 'z'),
+    (0xFF3B, '3', '['),
+    (0xFF3C, '3', '\\'),
+    (0xFF3D, '3', ']'),
+    (0xFF3E, '3', '^'),
+    (0xFF3F, '3', '_'),
+    (0xFF40, '3', '`'),
+    (0xFF41, 'M', 'a'),
+    (0xFF42, 'M', 'b'),
+    (0xFF43, 'M', 'c'),
+    (0xFF44, 'M', 'd'),
+    (0xFF45, 'M', 'e'),
+    (0xFF46, 'M', 'f'),
+    (0xFF47, 'M', 'g'),
+    (0xFF48, 'M', 'h'),
+    (0xFF49, 'M', 'i'),
+    (0xFF4A, 'M', 'j'),
+    (0xFF4B, 'M', 'k'),
+    (0xFF4C, 'M', 'l'),
+    (0xFF4D, 'M', 'm'),
+    (0xFF4E, 'M', 'n'),
+    (0xFF4F, 'M', 'o'),
+    (0xFF50, 'M', 'p'),
+    (0xFF51, 'M', 'q'),
+    (0xFF52, 'M', 'r'),
+    (0xFF53, 'M', 's'),
+    (0xFF54, 'M', 't'),
+    (0xFF55, 'M', 'u'),
+    (0xFF56, 'M', 'v'),
+    (0xFF57, 'M', 'w'),
+    (0xFF58, 'M', 'x'),
+    (0xFF59, 'M', 'y'),
+    (0xFF5A, 'M', 'z'),
+    (0xFF5B, '3', '{'),
+    (0xFF5C, '3', '|'),
+    (0xFF5D, '3', '}'),
+    (0xFF5E, '3', '~'),
+    (0xFF5F, 'M', '⦅'),
+    (0xFF60, 'M', '⦆'),
+    (0xFF61, 'M', '.'),
+    (0xFF62, 'M', '「'),
+    (0xFF63, 'M', '」'),
+    (0xFF64, 'M', '、'),
+    (0xFF65, 'M', '・'),
+    (0xFF66, 'M', 'ヲ'),
+    (0xFF67, 'M', 'ァ'),
+    (0xFF68, 'M', 'ィ'),
+    (0xFF69, 'M', 'ゥ'),
+    (0xFF6A, 'M', 'ェ'),
+    (0xFF6B, 'M', 'ォ'),
+    (0xFF6C, 'M', 'ャ'),
+    (0xFF6D, 'M', 'ュ'),
+    (0xFF6E, 'M', 'ョ'),
+    (0xFF6F, 'M', 'ッ'),
+    (0xFF70, 'M', 'ー'),
+    (0xFF71, 'M', 'ア'),
+    (0xFF72, 'M', 'イ'),
+    (0xFF73, 'M', 'ウ'),
+    (0xFF74, 'M', 'エ'),
+    (0xFF75, 'M', 'オ'),
+    (0xFF76, 'M', 'カ'),
+    (0xFF77, 'M', 'キ'),
+    (0xFF78, 'M', 'ク'),
+    (0xFF79, 'M', 'ケ'),
+    (0xFF7A, 'M', 'コ'),
+    (0xFF7B, 'M', 'サ'),
+    (0xFF7C, 'M', 'シ'),
+    (0xFF7D, 'M', 'ス'),
+    (0xFF7E, 'M', 'セ'),
+    (0xFF7F, 'M', 'ソ'),
+    (0xFF80, 'M', 'タ'),
+    (0xFF81, 'M', 'チ'),
+    (0xFF82, 'M', 'ツ'),
+    ]
+
+def _seg_52() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xFF83, 'M', 'テ'),
+    (0xFF84, 'M', 'ト'),
+    (0xFF85, 'M', 'ナ'),
+    (0xFF86, 'M', 'ニ'),
+    (0xFF87, 'M', 'ヌ'),
+    (0xFF88, 'M', 'ネ'),
+    (0xFF89, 'M', 'ノ'),
+    (0xFF8A, 'M', 'ハ'),
+    (0xFF8B, 'M', 'ヒ'),
+    (0xFF8C, 'M', 'フ'),
+    (0xFF8D, 'M', 'ヘ'),
+    (0xFF8E, 'M', 'ホ'),
+    (0xFF8F, 'M', 'マ'),
+    (0xFF90, 'M', 'ミ'),
+    (0xFF91, 'M', 'ム'),
+    (0xFF92, 'M', 'メ'),
+    (0xFF93, 'M', 'モ'),
+    (0xFF94, 'M', 'ヤ'),
+    (0xFF95, 'M', 'ユ'),
+    (0xFF96, 'M', 'ヨ'),
+    (0xFF97, 'M', 'ラ'),
+    (0xFF98, 'M', 'リ'),
+    (0xFF99, 'M', 'ル'),
+    (0xFF9A, 'M', 'レ'),
+    (0xFF9B, 'M', 'ロ'),
+    (0xFF9C, 'M', 'ワ'),
+    (0xFF9D, 'M', 'ン'),
+    (0xFF9E, 'M', '゙'),
+    (0xFF9F, 'M', '゚'),
+    (0xFFA0, 'X'),
+    (0xFFA1, 'M', 'ᄀ'),
+    (0xFFA2, 'M', 'ᄁ'),
+    (0xFFA3, 'M', 'ᆪ'),
+    (0xFFA4, 'M', 'ᄂ'),
+    (0xFFA5, 'M', 'ᆬ'),
+    (0xFFA6, 'M', 'ᆭ'),
+    (0xFFA7, 'M', 'ᄃ'),
+    (0xFFA8, 'M', 'ᄄ'),
+    (0xFFA9, 'M', 'ᄅ'),
+    (0xFFAA, 'M', 'ᆰ'),
+    (0xFFAB, 'M', 'ᆱ'),
+    (0xFFAC, 'M', 'ᆲ'),
+    (0xFFAD, 'M', 'ᆳ'),
+    (0xFFAE, 'M', 'ᆴ'),
+    (0xFFAF, 'M', 'ᆵ'),
+    (0xFFB0, 'M', 'ᄚ'),
+    (0xFFB1, 'M', 'ᄆ'),
+    (0xFFB2, 'M', 'ᄇ'),
+    (0xFFB3, 'M', 'ᄈ'),
+    (0xFFB4, 'M', 'ᄡ'),
+    (0xFFB5, 'M', 'ᄉ'),
+    (0xFFB6, 'M', 'ᄊ'),
+    (0xFFB7, 'M', 'ᄋ'),
+    (0xFFB8, 'M', 'ᄌ'),
+    (0xFFB9, 'M', 'ᄍ'),
+    (0xFFBA, 'M', 'ᄎ'),
+    (0xFFBB, 'M', 'ᄏ'),
+    (0xFFBC, 'M', 'ᄐ'),
+    (0xFFBD, 'M', 'ᄑ'),
+    (0xFFBE, 'M', 'ᄒ'),
+    (0xFFBF, 'X'),
+    (0xFFC2, 'M', 'ᅡ'),
+    (0xFFC3, 'M', 'ᅢ'),
+    (0xFFC4, 'M', 'ᅣ'),
+    (0xFFC5, 'M', 'ᅤ'),
+    (0xFFC6, 'M', 'ᅥ'),
+    (0xFFC7, 'M', 'ᅦ'),
+    (0xFFC8, 'X'),
+    (0xFFCA, 'M', 'ᅧ'),
+    (0xFFCB, 'M', 'ᅨ'),
+    (0xFFCC, 'M', 'ᅩ'),
+    (0xFFCD, 'M', 'ᅪ'),
+    (0xFFCE, 'M', 'ᅫ'),
+    (0xFFCF, 'M', 'ᅬ'),
+    (0xFFD0, 'X'),
+    (0xFFD2, 'M', 'ᅭ'),
+    (0xFFD3, 'M', 'ᅮ'),
+    (0xFFD4, 'M', 'ᅯ'),
+    (0xFFD5, 'M', 'ᅰ'),
+    (0xFFD6, 'M', 'ᅱ'),
+    (0xFFD7, 'M', 'ᅲ'),
+    (0xFFD8, 'X'),
+    (0xFFDA, 'M', 'ᅳ'),
+    (0xFFDB, 'M', 'ᅴ'),
+    (0xFFDC, 'M', 'ᅵ'),
+    (0xFFDD, 'X'),
+    (0xFFE0, 'M', '¢'),
+    (0xFFE1, 'M', '£'),
+    (0xFFE2, 'M', '¬'),
+    (0xFFE3, '3', ' ̄'),
+    (0xFFE4, 'M', '¦'),
+    (0xFFE5, 'M', '¥'),
+    (0xFFE6, 'M', '₩'),
+    (0xFFE7, 'X'),
+    (0xFFE8, 'M', '│'),
+    (0xFFE9, 'M', '←'),
+    (0xFFEA, 'M', '↑'),
+    (0xFFEB, 'M', '→'),
+    (0xFFEC, 'M', '↓'),
+    (0xFFED, 'M', '■'),
+    ]
+
+def _seg_53() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0xFFEE, 'M', '○'),
+    (0xFFEF, 'X'),
+    (0x10000, 'V'),
+    (0x1000C, 'X'),
+    (0x1000D, 'V'),
+    (0x10027, 'X'),
+    (0x10028, 'V'),
+    (0x1003B, 'X'),
+    (0x1003C, 'V'),
+    (0x1003E, 'X'),
+    (0x1003F, 'V'),
+    (0x1004E, 'X'),
+    (0x10050, 'V'),
+    (0x1005E, 'X'),
+    (0x10080, 'V'),
+    (0x100FB, 'X'),
+    (0x10100, 'V'),
+    (0x10103, 'X'),
+    (0x10107, 'V'),
+    (0x10134, 'X'),
+    (0x10137, 'V'),
+    (0x1018F, 'X'),
+    (0x10190, 'V'),
+    (0x1019D, 'X'),
+    (0x101A0, 'V'),
+    (0x101A1, 'X'),
+    (0x101D0, 'V'),
+    (0x101FE, 'X'),
+    (0x10280, 'V'),
+    (0x1029D, 'X'),
+    (0x102A0, 'V'),
+    (0x102D1, 'X'),
+    (0x102E0, 'V'),
+    (0x102FC, 'X'),
+    (0x10300, 'V'),
+    (0x10324, 'X'),
+    (0x1032D, 'V'),
+    (0x1034B, 'X'),
+    (0x10350, 'V'),
+    (0x1037B, 'X'),
+    (0x10380, 'V'),
+    (0x1039E, 'X'),
+    (0x1039F, 'V'),
+    (0x103C4, 'X'),
+    (0x103C8, 'V'),
+    (0x103D6, 'X'),
+    (0x10400, 'M', '𐐨'),
+    (0x10401, 'M', '𐐩'),
+    (0x10402, 'M', '𐐪'),
+    (0x10403, 'M', '𐐫'),
+    (0x10404, 'M', '𐐬'),
+    (0x10405, 'M', '𐐭'),
+    (0x10406, 'M', '𐐮'),
+    (0x10407, 'M', '𐐯'),
+    (0x10408, 'M', '𐐰'),
+    (0x10409, 'M', '𐐱'),
+    (0x1040A, 'M', '𐐲'),
+    (0x1040B, 'M', '𐐳'),
+    (0x1040C, 'M', '𐐴'),
+    (0x1040D, 'M', '𐐵'),
+    (0x1040E, 'M', '𐐶'),
+    (0x1040F, 'M', '𐐷'),
+    (0x10410, 'M', '𐐸'),
+    (0x10411, 'M', '𐐹'),
+    (0x10412, 'M', '𐐺'),
+    (0x10413, 'M', '𐐻'),
+    (0x10414, 'M', '𐐼'),
+    (0x10415, 'M', '𐐽'),
+    (0x10416, 'M', '𐐾'),
+    (0x10417, 'M', '𐐿'),
+    (0x10418, 'M', '𐑀'),
+    (0x10419, 'M', '𐑁'),
+    (0x1041A, 'M', '𐑂'),
+    (0x1041B, 'M', '𐑃'),
+    (0x1041C, 'M', '𐑄'),
+    (0x1041D, 'M', '𐑅'),
+    (0x1041E, 'M', '𐑆'),
+    (0x1041F, 'M', '𐑇'),
+    (0x10420, 'M', '𐑈'),
+    (0x10421, 'M', '𐑉'),
+    (0x10422, 'M', '𐑊'),
+    (0x10423, 'M', '𐑋'),
+    (0x10424, 'M', '𐑌'),
+    (0x10425, 'M', '𐑍'),
+    (0x10426, 'M', '𐑎'),
+    (0x10427, 'M', '𐑏'),
+    (0x10428, 'V'),
+    (0x1049E, 'X'),
+    (0x104A0, 'V'),
+    (0x104AA, 'X'),
+    (0x104B0, 'M', '𐓘'),
+    (0x104B1, 'M', '𐓙'),
+    (0x104B2, 'M', '𐓚'),
+    (0x104B3, 'M', '𐓛'),
+    (0x104B4, 'M', '𐓜'),
+    (0x104B5, 'M', '𐓝'),
+    (0x104B6, 'M', '𐓞'),
+    (0x104B7, 'M', '𐓟'),
+    (0x104B8, 'M', '𐓠'),
+    (0x104B9, 'M', '𐓡'),
+    ]
+
+def _seg_54() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x104BA, 'M', '𐓢'),
+    (0x104BB, 'M', '𐓣'),
+    (0x104BC, 'M', '𐓤'),
+    (0x104BD, 'M', '𐓥'),
+    (0x104BE, 'M', '𐓦'),
+    (0x104BF, 'M', '𐓧'),
+    (0x104C0, 'M', '𐓨'),
+    (0x104C1, 'M', '𐓩'),
+    (0x104C2, 'M', '𐓪'),
+    (0x104C3, 'M', '𐓫'),
+    (0x104C4, 'M', '𐓬'),
+    (0x104C5, 'M', '𐓭'),
+    (0x104C6, 'M', '𐓮'),
+    (0x104C7, 'M', '𐓯'),
+    (0x104C8, 'M', '𐓰'),
+    (0x104C9, 'M', '𐓱'),
+    (0x104CA, 'M', '𐓲'),
+    (0x104CB, 'M', '𐓳'),
+    (0x104CC, 'M', '𐓴'),
+    (0x104CD, 'M', '𐓵'),
+    (0x104CE, 'M', '𐓶'),
+    (0x104CF, 'M', '𐓷'),
+    (0x104D0, 'M', '𐓸'),
+    (0x104D1, 'M', '𐓹'),
+    (0x104D2, 'M', '𐓺'),
+    (0x104D3, 'M', '𐓻'),
+    (0x104D4, 'X'),
+    (0x104D8, 'V'),
+    (0x104FC, 'X'),
+    (0x10500, 'V'),
+    (0x10528, 'X'),
+    (0x10530, 'V'),
+    (0x10564, 'X'),
+    (0x1056F, 'V'),
+    (0x10570, 'M', '𐖗'),
+    (0x10571, 'M', '𐖘'),
+    (0x10572, 'M', '𐖙'),
+    (0x10573, 'M', '𐖚'),
+    (0x10574, 'M', '𐖛'),
+    (0x10575, 'M', '𐖜'),
+    (0x10576, 'M', '𐖝'),
+    (0x10577, 'M', '𐖞'),
+    (0x10578, 'M', '𐖟'),
+    (0x10579, 'M', '𐖠'),
+    (0x1057A, 'M', '𐖡'),
+    (0x1057B, 'X'),
+    (0x1057C, 'M', '𐖣'),
+    (0x1057D, 'M', '𐖤'),
+    (0x1057E, 'M', '𐖥'),
+    (0x1057F, 'M', '𐖦'),
+    (0x10580, 'M', '𐖧'),
+    (0x10581, 'M', '𐖨'),
+    (0x10582, 'M', '𐖩'),
+    (0x10583, 'M', '𐖪'),
+    (0x10584, 'M', '𐖫'),
+    (0x10585, 'M', '𐖬'),
+    (0x10586, 'M', '𐖭'),
+    (0x10587, 'M', '𐖮'),
+    (0x10588, 'M', '𐖯'),
+    (0x10589, 'M', '𐖰'),
+    (0x1058A, 'M', '𐖱'),
+    (0x1058B, 'X'),
+    (0x1058C, 'M', '𐖳'),
+    (0x1058D, 'M', '𐖴'),
+    (0x1058E, 'M', '𐖵'),
+    (0x1058F, 'M', '𐖶'),
+    (0x10590, 'M', '𐖷'),
+    (0x10591, 'M', '𐖸'),
+    (0x10592, 'M', '𐖹'),
+    (0x10593, 'X'),
+    (0x10594, 'M', '𐖻'),
+    (0x10595, 'M', '𐖼'),
+    (0x10596, 'X'),
+    (0x10597, 'V'),
+    (0x105A2, 'X'),
+    (0x105A3, 'V'),
+    (0x105B2, 'X'),
+    (0x105B3, 'V'),
+    (0x105BA, 'X'),
+    (0x105BB, 'V'),
+    (0x105BD, 'X'),
+    (0x10600, 'V'),
+    (0x10737, 'X'),
+    (0x10740, 'V'),
+    (0x10756, 'X'),
+    (0x10760, 'V'),
+    (0x10768, 'X'),
+    (0x10780, 'V'),
+    (0x10781, 'M', 'ː'),
+    (0x10782, 'M', 'ˑ'),
+    (0x10783, 'M', 'æ'),
+    (0x10784, 'M', 'ʙ'),
+    (0x10785, 'M', 'ɓ'),
+    (0x10786, 'X'),
+    (0x10787, 'M', 'ʣ'),
+    (0x10788, 'M', 'ꭦ'),
+    (0x10789, 'M', 'ʥ'),
+    (0x1078A, 'M', 'ʤ'),
+    (0x1078B, 'M', 'ɖ'),
+    (0x1078C, 'M', 'ɗ'),
+    ]
+
+def _seg_55() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1078D, 'M', 'ᶑ'),
+    (0x1078E, 'M', 'ɘ'),
+    (0x1078F, 'M', 'ɞ'),
+    (0x10790, 'M', 'ʩ'),
+    (0x10791, 'M', 'ɤ'),
+    (0x10792, 'M', 'ɢ'),
+    (0x10793, 'M', 'ɠ'),
+    (0x10794, 'M', 'ʛ'),
+    (0x10795, 'M', 'ħ'),
+    (0x10796, 'M', 'ʜ'),
+    (0x10797, 'M', 'ɧ'),
+    (0x10798, 'M', 'ʄ'),
+    (0x10799, 'M', 'ʪ'),
+    (0x1079A, 'M', 'ʫ'),
+    (0x1079B, 'M', 'ɬ'),
+    (0x1079C, 'M', '𝼄'),
+    (0x1079D, 'M', 'ꞎ'),
+    (0x1079E, 'M', 'ɮ'),
+    (0x1079F, 'M', '𝼅'),
+    (0x107A0, 'M', 'ʎ'),
+    (0x107A1, 'M', '𝼆'),
+    (0x107A2, 'M', 'ø'),
+    (0x107A3, 'M', 'ɶ'),
+    (0x107A4, 'M', 'ɷ'),
+    (0x107A5, 'M', 'q'),
+    (0x107A6, 'M', 'ɺ'),
+    (0x107A7, 'M', '𝼈'),
+    (0x107A8, 'M', 'ɽ'),
+    (0x107A9, 'M', 'ɾ'),
+    (0x107AA, 'M', 'ʀ'),
+    (0x107AB, 'M', 'ʨ'),
+    (0x107AC, 'M', 'ʦ'),
+    (0x107AD, 'M', 'ꭧ'),
+    (0x107AE, 'M', 'ʧ'),
+    (0x107AF, 'M', 'ʈ'),
+    (0x107B0, 'M', 'ⱱ'),
+    (0x107B1, 'X'),
+    (0x107B2, 'M', 'ʏ'),
+    (0x107B3, 'M', 'ʡ'),
+    (0x107B4, 'M', 'ʢ'),
+    (0x107B5, 'M', 'ʘ'),
+    (0x107B6, 'M', 'ǀ'),
+    (0x107B7, 'M', 'ǁ'),
+    (0x107B8, 'M', 'ǂ'),
+    (0x107B9, 'M', '𝼊'),
+    (0x107BA, 'M', '𝼞'),
+    (0x107BB, 'X'),
+    (0x10800, 'V'),
+    (0x10806, 'X'),
+    (0x10808, 'V'),
+    (0x10809, 'X'),
+    (0x1080A, 'V'),
+    (0x10836, 'X'),
+    (0x10837, 'V'),
+    (0x10839, 'X'),
+    (0x1083C, 'V'),
+    (0x1083D, 'X'),
+    (0x1083F, 'V'),
+    (0x10856, 'X'),
+    (0x10857, 'V'),
+    (0x1089F, 'X'),
+    (0x108A7, 'V'),
+    (0x108B0, 'X'),
+    (0x108E0, 'V'),
+    (0x108F3, 'X'),
+    (0x108F4, 'V'),
+    (0x108F6, 'X'),
+    (0x108FB, 'V'),
+    (0x1091C, 'X'),
+    (0x1091F, 'V'),
+    (0x1093A, 'X'),
+    (0x1093F, 'V'),
+    (0x10940, 'X'),
+    (0x10980, 'V'),
+    (0x109B8, 'X'),
+    (0x109BC, 'V'),
+    (0x109D0, 'X'),
+    (0x109D2, 'V'),
+    (0x10A04, 'X'),
+    (0x10A05, 'V'),
+    (0x10A07, 'X'),
+    (0x10A0C, 'V'),
+    (0x10A14, 'X'),
+    (0x10A15, 'V'),
+    (0x10A18, 'X'),
+    (0x10A19, 'V'),
+    (0x10A36, 'X'),
+    (0x10A38, 'V'),
+    (0x10A3B, 'X'),
+    (0x10A3F, 'V'),
+    (0x10A49, 'X'),
+    (0x10A50, 'V'),
+    (0x10A59, 'X'),
+    (0x10A60, 'V'),
+    (0x10AA0, 'X'),
+    (0x10AC0, 'V'),
+    (0x10AE7, 'X'),
+    (0x10AEB, 'V'),
+    (0x10AF7, 'X'),
+    (0x10B00, 'V'),
+    ]
+
+def _seg_56() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x10B36, 'X'),
+    (0x10B39, 'V'),
+    (0x10B56, 'X'),
+    (0x10B58, 'V'),
+    (0x10B73, 'X'),
+    (0x10B78, 'V'),
+    (0x10B92, 'X'),
+    (0x10B99, 'V'),
+    (0x10B9D, 'X'),
+    (0x10BA9, 'V'),
+    (0x10BB0, 'X'),
+    (0x10C00, 'V'),
+    (0x10C49, 'X'),
+    (0x10C80, 'M', '𐳀'),
+    (0x10C81, 'M', '𐳁'),
+    (0x10C82, 'M', '𐳂'),
+    (0x10C83, 'M', '𐳃'),
+    (0x10C84, 'M', '𐳄'),
+    (0x10C85, 'M', '𐳅'),
+    (0x10C86, 'M', '𐳆'),
+    (0x10C87, 'M', '𐳇'),
+    (0x10C88, 'M', '𐳈'),
+    (0x10C89, 'M', '𐳉'),
+    (0x10C8A, 'M', '𐳊'),
+    (0x10C8B, 'M', '𐳋'),
+    (0x10C8C, 'M', '𐳌'),
+    (0x10C8D, 'M', '𐳍'),
+    (0x10C8E, 'M', '𐳎'),
+    (0x10C8F, 'M', '𐳏'),
+    (0x10C90, 'M', '𐳐'),
+    (0x10C91, 'M', '𐳑'),
+    (0x10C92, 'M', '𐳒'),
+    (0x10C93, 'M', '𐳓'),
+    (0x10C94, 'M', '𐳔'),
+    (0x10C95, 'M', '𐳕'),
+    (0x10C96, 'M', '𐳖'),
+    (0x10C97, 'M', '𐳗'),
+    (0x10C98, 'M', '𐳘'),
+    (0x10C99, 'M', '𐳙'),
+    (0x10C9A, 'M', '𐳚'),
+    (0x10C9B, 'M', '𐳛'),
+    (0x10C9C, 'M', '𐳜'),
+    (0x10C9D, 'M', '𐳝'),
+    (0x10C9E, 'M', '𐳞'),
+    (0x10C9F, 'M', '𐳟'),
+    (0x10CA0, 'M', '𐳠'),
+    (0x10CA1, 'M', '𐳡'),
+    (0x10CA2, 'M', '𐳢'),
+    (0x10CA3, 'M', '𐳣'),
+    (0x10CA4, 'M', '𐳤'),
+    (0x10CA5, 'M', '𐳥'),
+    (0x10CA6, 'M', '𐳦'),
+    (0x10CA7, 'M', '𐳧'),
+    (0x10CA8, 'M', '𐳨'),
+    (0x10CA9, 'M', '𐳩'),
+    (0x10CAA, 'M', '𐳪'),
+    (0x10CAB, 'M', '𐳫'),
+    (0x10CAC, 'M', '𐳬'),
+    (0x10CAD, 'M', '𐳭'),
+    (0x10CAE, 'M', '𐳮'),
+    (0x10CAF, 'M', '𐳯'),
+    (0x10CB0, 'M', '𐳰'),
+    (0x10CB1, 'M', '𐳱'),
+    (0x10CB2, 'M', '𐳲'),
+    (0x10CB3, 'X'),
+    (0x10CC0, 'V'),
+    (0x10CF3, 'X'),
+    (0x10CFA, 'V'),
+    (0x10D28, 'X'),
+    (0x10D30, 'V'),
+    (0x10D3A, 'X'),
+    (0x10E60, 'V'),
+    (0x10E7F, 'X'),
+    (0x10E80, 'V'),
+    (0x10EAA, 'X'),
+    (0x10EAB, 'V'),
+    (0x10EAE, 'X'),
+    (0x10EB0, 'V'),
+    (0x10EB2, 'X'),
+    (0x10EFD, 'V'),
+    (0x10F28, 'X'),
+    (0x10F30, 'V'),
+    (0x10F5A, 'X'),
+    (0x10F70, 'V'),
+    (0x10F8A, 'X'),
+    (0x10FB0, 'V'),
+    (0x10FCC, 'X'),
+    (0x10FE0, 'V'),
+    (0x10FF7, 'X'),
+    (0x11000, 'V'),
+    (0x1104E, 'X'),
+    (0x11052, 'V'),
+    (0x11076, 'X'),
+    (0x1107F, 'V'),
+    (0x110BD, 'X'),
+    (0x110BE, 'V'),
+    (0x110C3, 'X'),
+    (0x110D0, 'V'),
+    (0x110E9, 'X'),
+    (0x110F0, 'V'),
+    ]
+
+def _seg_57() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x110FA, 'X'),
+    (0x11100, 'V'),
+    (0x11135, 'X'),
+    (0x11136, 'V'),
+    (0x11148, 'X'),
+    (0x11150, 'V'),
+    (0x11177, 'X'),
+    (0x11180, 'V'),
+    (0x111E0, 'X'),
+    (0x111E1, 'V'),
+    (0x111F5, 'X'),
+    (0x11200, 'V'),
+    (0x11212, 'X'),
+    (0x11213, 'V'),
+    (0x11242, 'X'),
+    (0x11280, 'V'),
+    (0x11287, 'X'),
+    (0x11288, 'V'),
+    (0x11289, 'X'),
+    (0x1128A, 'V'),
+    (0x1128E, 'X'),
+    (0x1128F, 'V'),
+    (0x1129E, 'X'),
+    (0x1129F, 'V'),
+    (0x112AA, 'X'),
+    (0x112B0, 'V'),
+    (0x112EB, 'X'),
+    (0x112F0, 'V'),
+    (0x112FA, 'X'),
+    (0x11300, 'V'),
+    (0x11304, 'X'),
+    (0x11305, 'V'),
+    (0x1130D, 'X'),
+    (0x1130F, 'V'),
+    (0x11311, 'X'),
+    (0x11313, 'V'),
+    (0x11329, 'X'),
+    (0x1132A, 'V'),
+    (0x11331, 'X'),
+    (0x11332, 'V'),
+    (0x11334, 'X'),
+    (0x11335, 'V'),
+    (0x1133A, 'X'),
+    (0x1133B, 'V'),
+    (0x11345, 'X'),
+    (0x11347, 'V'),
+    (0x11349, 'X'),
+    (0x1134B, 'V'),
+    (0x1134E, 'X'),
+    (0x11350, 'V'),
+    (0x11351, 'X'),
+    (0x11357, 'V'),
+    (0x11358, 'X'),
+    (0x1135D, 'V'),
+    (0x11364, 'X'),
+    (0x11366, 'V'),
+    (0x1136D, 'X'),
+    (0x11370, 'V'),
+    (0x11375, 'X'),
+    (0x11400, 'V'),
+    (0x1145C, 'X'),
+    (0x1145D, 'V'),
+    (0x11462, 'X'),
+    (0x11480, 'V'),
+    (0x114C8, 'X'),
+    (0x114D0, 'V'),
+    (0x114DA, 'X'),
+    (0x11580, 'V'),
+    (0x115B6, 'X'),
+    (0x115B8, 'V'),
+    (0x115DE, 'X'),
+    (0x11600, 'V'),
+    (0x11645, 'X'),
+    (0x11650, 'V'),
+    (0x1165A, 'X'),
+    (0x11660, 'V'),
+    (0x1166D, 'X'),
+    (0x11680, 'V'),
+    (0x116BA, 'X'),
+    (0x116C0, 'V'),
+    (0x116CA, 'X'),
+    (0x11700, 'V'),
+    (0x1171B, 'X'),
+    (0x1171D, 'V'),
+    (0x1172C, 'X'),
+    (0x11730, 'V'),
+    (0x11747, 'X'),
+    (0x11800, 'V'),
+    (0x1183C, 'X'),
+    (0x118A0, 'M', '𑣀'),
+    (0x118A1, 'M', '𑣁'),
+    (0x118A2, 'M', '𑣂'),
+    (0x118A3, 'M', '𑣃'),
+    (0x118A4, 'M', '𑣄'),
+    (0x118A5, 'M', '𑣅'),
+    (0x118A6, 'M', '𑣆'),
+    (0x118A7, 'M', '𑣇'),
+    (0x118A8, 'M', '𑣈'),
+    (0x118A9, 'M', '𑣉'),
+    (0x118AA, 'M', '𑣊'),
+    ]
+
+def _seg_58() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x118AB, 'M', '𑣋'),
+    (0x118AC, 'M', '𑣌'),
+    (0x118AD, 'M', '𑣍'),
+    (0x118AE, 'M', '𑣎'),
+    (0x118AF, 'M', '𑣏'),
+    (0x118B0, 'M', '𑣐'),
+    (0x118B1, 'M', '𑣑'),
+    (0x118B2, 'M', '𑣒'),
+    (0x118B3, 'M', '𑣓'),
+    (0x118B4, 'M', '𑣔'),
+    (0x118B5, 'M', '𑣕'),
+    (0x118B6, 'M', '𑣖'),
+    (0x118B7, 'M', '𑣗'),
+    (0x118B8, 'M', '𑣘'),
+    (0x118B9, 'M', '𑣙'),
+    (0x118BA, 'M', '𑣚'),
+    (0x118BB, 'M', '𑣛'),
+    (0x118BC, 'M', '𑣜'),
+    (0x118BD, 'M', '𑣝'),
+    (0x118BE, 'M', '𑣞'),
+    (0x118BF, 'M', '𑣟'),
+    (0x118C0, 'V'),
+    (0x118F3, 'X'),
+    (0x118FF, 'V'),
+    (0x11907, 'X'),
+    (0x11909, 'V'),
+    (0x1190A, 'X'),
+    (0x1190C, 'V'),
+    (0x11914, 'X'),
+    (0x11915, 'V'),
+    (0x11917, 'X'),
+    (0x11918, 'V'),
+    (0x11936, 'X'),
+    (0x11937, 'V'),
+    (0x11939, 'X'),
+    (0x1193B, 'V'),
+    (0x11947, 'X'),
+    (0x11950, 'V'),
+    (0x1195A, 'X'),
+    (0x119A0, 'V'),
+    (0x119A8, 'X'),
+    (0x119AA, 'V'),
+    (0x119D8, 'X'),
+    (0x119DA, 'V'),
+    (0x119E5, 'X'),
+    (0x11A00, 'V'),
+    (0x11A48, 'X'),
+    (0x11A50, 'V'),
+    (0x11AA3, 'X'),
+    (0x11AB0, 'V'),
+    (0x11AF9, 'X'),
+    (0x11B00, 'V'),
+    (0x11B0A, 'X'),
+    (0x11C00, 'V'),
+    (0x11C09, 'X'),
+    (0x11C0A, 'V'),
+    (0x11C37, 'X'),
+    (0x11C38, 'V'),
+    (0x11C46, 'X'),
+    (0x11C50, 'V'),
+    (0x11C6D, 'X'),
+    (0x11C70, 'V'),
+    (0x11C90, 'X'),
+    (0x11C92, 'V'),
+    (0x11CA8, 'X'),
+    (0x11CA9, 'V'),
+    (0x11CB7, 'X'),
+    (0x11D00, 'V'),
+    (0x11D07, 'X'),
+    (0x11D08, 'V'),
+    (0x11D0A, 'X'),
+    (0x11D0B, 'V'),
+    (0x11D37, 'X'),
+    (0x11D3A, 'V'),
+    (0x11D3B, 'X'),
+    (0x11D3C, 'V'),
+    (0x11D3E, 'X'),
+    (0x11D3F, 'V'),
+    (0x11D48, 'X'),
+    (0x11D50, 'V'),
+    (0x11D5A, 'X'),
+    (0x11D60, 'V'),
+    (0x11D66, 'X'),
+    (0x11D67, 'V'),
+    (0x11D69, 'X'),
+    (0x11D6A, 'V'),
+    (0x11D8F, 'X'),
+    (0x11D90, 'V'),
+    (0x11D92, 'X'),
+    (0x11D93, 'V'),
+    (0x11D99, 'X'),
+    (0x11DA0, 'V'),
+    (0x11DAA, 'X'),
+    (0x11EE0, 'V'),
+    (0x11EF9, 'X'),
+    (0x11F00, 'V'),
+    (0x11F11, 'X'),
+    (0x11F12, 'V'),
+    (0x11F3B, 'X'),
+    (0x11F3E, 'V'),
+    ]
+
+def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x11F5A, 'X'),
+    (0x11FB0, 'V'),
+    (0x11FB1, 'X'),
+    (0x11FC0, 'V'),
+    (0x11FF2, 'X'),
+    (0x11FFF, 'V'),
+    (0x1239A, 'X'),
+    (0x12400, 'V'),
+    (0x1246F, 'X'),
+    (0x12470, 'V'),
+    (0x12475, 'X'),
+    (0x12480, 'V'),
+    (0x12544, 'X'),
+    (0x12F90, 'V'),
+    (0x12FF3, 'X'),
+    (0x13000, 'V'),
+    (0x13430, 'X'),
+    (0x13440, 'V'),
+    (0x13456, 'X'),
+    (0x14400, 'V'),
+    (0x14647, 'X'),
+    (0x16800, 'V'),
+    (0x16A39, 'X'),
+    (0x16A40, 'V'),
+    (0x16A5F, 'X'),
+    (0x16A60, 'V'),
+    (0x16A6A, 'X'),
+    (0x16A6E, 'V'),
+    (0x16ABF, 'X'),
+    (0x16AC0, 'V'),
+    (0x16ACA, 'X'),
+    (0x16AD0, 'V'),
+    (0x16AEE, 'X'),
+    (0x16AF0, 'V'),
+    (0x16AF6, 'X'),
+    (0x16B00, 'V'),
+    (0x16B46, 'X'),
+    (0x16B50, 'V'),
+    (0x16B5A, 'X'),
+    (0x16B5B, 'V'),
+    (0x16B62, 'X'),
+    (0x16B63, 'V'),
+    (0x16B78, 'X'),
+    (0x16B7D, 'V'),
+    (0x16B90, 'X'),
+    (0x16E40, 'M', '𖹠'),
+    (0x16E41, 'M', '𖹡'),
+    (0x16E42, 'M', '𖹢'),
+    (0x16E43, 'M', '𖹣'),
+    (0x16E44, 'M', '𖹤'),
+    (0x16E45, 'M', '𖹥'),
+    (0x16E46, 'M', '𖹦'),
+    (0x16E47, 'M', '𖹧'),
+    (0x16E48, 'M', '𖹨'),
+    (0x16E49, 'M', '𖹩'),
+    (0x16E4A, 'M', '𖹪'),
+    (0x16E4B, 'M', '𖹫'),
+    (0x16E4C, 'M', '𖹬'),
+    (0x16E4D, 'M', '𖹭'),
+    (0x16E4E, 'M', '𖹮'),
+    (0x16E4F, 'M', '𖹯'),
+    (0x16E50, 'M', '𖹰'),
+    (0x16E51, 'M', '𖹱'),
+    (0x16E52, 'M', '𖹲'),
+    (0x16E53, 'M', '𖹳'),
+    (0x16E54, 'M', '𖹴'),
+    (0x16E55, 'M', '𖹵'),
+    (0x16E56, 'M', '𖹶'),
+    (0x16E57, 'M', '𖹷'),
+    (0x16E58, 'M', '𖹸'),
+    (0x16E59, 'M', '𖹹'),
+    (0x16E5A, 'M', '𖹺'),
+    (0x16E5B, 'M', '𖹻'),
+    (0x16E5C, 'M', '𖹼'),
+    (0x16E5D, 'M', '𖹽'),
+    (0x16E5E, 'M', '𖹾'),
+    (0x16E5F, 'M', '𖹿'),
+    (0x16E60, 'V'),
+    (0x16E9B, 'X'),
+    (0x16F00, 'V'),
+    (0x16F4B, 'X'),
+    (0x16F4F, 'V'),
+    (0x16F88, 'X'),
+    (0x16F8F, 'V'),
+    (0x16FA0, 'X'),
+    (0x16FE0, 'V'),
+    (0x16FE5, 'X'),
+    (0x16FF0, 'V'),
+    (0x16FF2, 'X'),
+    (0x17000, 'V'),
+    (0x187F8, 'X'),
+    (0x18800, 'V'),
+    (0x18CD6, 'X'),
+    (0x18D00, 'V'),
+    (0x18D09, 'X'),
+    (0x1AFF0, 'V'),
+    (0x1AFF4, 'X'),
+    (0x1AFF5, 'V'),
+    (0x1AFFC, 'X'),
+    (0x1AFFD, 'V'),
+    ]
+
+def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1AFFF, 'X'),
+    (0x1B000, 'V'),
+    (0x1B123, 'X'),
+    (0x1B132, 'V'),
+    (0x1B133, 'X'),
+    (0x1B150, 'V'),
+    (0x1B153, 'X'),
+    (0x1B155, 'V'),
+    (0x1B156, 'X'),
+    (0x1B164, 'V'),
+    (0x1B168, 'X'),
+    (0x1B170, 'V'),
+    (0x1B2FC, 'X'),
+    (0x1BC00, 'V'),
+    (0x1BC6B, 'X'),
+    (0x1BC70, 'V'),
+    (0x1BC7D, 'X'),
+    (0x1BC80, 'V'),
+    (0x1BC89, 'X'),
+    (0x1BC90, 'V'),
+    (0x1BC9A, 'X'),
+    (0x1BC9C, 'V'),
+    (0x1BCA0, 'I'),
+    (0x1BCA4, 'X'),
+    (0x1CF00, 'V'),
+    (0x1CF2E, 'X'),
+    (0x1CF30, 'V'),
+    (0x1CF47, 'X'),
+    (0x1CF50, 'V'),
+    (0x1CFC4, 'X'),
+    (0x1D000, 'V'),
+    (0x1D0F6, 'X'),
+    (0x1D100, 'V'),
+    (0x1D127, 'X'),
+    (0x1D129, 'V'),
+    (0x1D15E, 'M', '𝅗𝅥'),
+    (0x1D15F, 'M', '𝅘𝅥'),
+    (0x1D160, 'M', '𝅘𝅥𝅮'),
+    (0x1D161, 'M', '𝅘𝅥𝅯'),
+    (0x1D162, 'M', '𝅘𝅥𝅰'),
+    (0x1D163, 'M', '𝅘𝅥𝅱'),
+    (0x1D164, 'M', '𝅘𝅥𝅲'),
+    (0x1D165, 'V'),
+    (0x1D173, 'X'),
+    (0x1D17B, 'V'),
+    (0x1D1BB, 'M', '𝆹𝅥'),
+    (0x1D1BC, 'M', '𝆺𝅥'),
+    (0x1D1BD, 'M', '𝆹𝅥𝅮'),
+    (0x1D1BE, 'M', '𝆺𝅥𝅮'),
+    (0x1D1BF, 'M', '𝆹𝅥𝅯'),
+    (0x1D1C0, 'M', '𝆺𝅥𝅯'),
+    (0x1D1C1, 'V'),
+    (0x1D1EB, 'X'),
+    (0x1D200, 'V'),
+    (0x1D246, 'X'),
+    (0x1D2C0, 'V'),
+    (0x1D2D4, 'X'),
+    (0x1D2E0, 'V'),
+    (0x1D2F4, 'X'),
+    (0x1D300, 'V'),
+    (0x1D357, 'X'),
+    (0x1D360, 'V'),
+    (0x1D379, 'X'),
+    (0x1D400, 'M', 'a'),
+    (0x1D401, 'M', 'b'),
+    (0x1D402, 'M', 'c'),
+    (0x1D403, 'M', 'd'),
+    (0x1D404, 'M', 'e'),
+    (0x1D405, 'M', 'f'),
+    (0x1D406, 'M', 'g'),
+    (0x1D407, 'M', 'h'),
+    (0x1D408, 'M', 'i'),
+    (0x1D409, 'M', 'j'),
+    (0x1D40A, 'M', 'k'),
+    (0x1D40B, 'M', 'l'),
+    (0x1D40C, 'M', 'm'),
+    (0x1D40D, 'M', 'n'),
+    (0x1D40E, 'M', 'o'),
+    (0x1D40F, 'M', 'p'),
+    (0x1D410, 'M', 'q'),
+    (0x1D411, 'M', 'r'),
+    (0x1D412, 'M', 's'),
+    (0x1D413, 'M', 't'),
+    (0x1D414, 'M', 'u'),
+    (0x1D415, 'M', 'v'),
+    (0x1D416, 'M', 'w'),
+    (0x1D417, 'M', 'x'),
+    (0x1D418, 'M', 'y'),
+    (0x1D419, 'M', 'z'),
+    (0x1D41A, 'M', 'a'),
+    (0x1D41B, 'M', 'b'),
+    (0x1D41C, 'M', 'c'),
+    (0x1D41D, 'M', 'd'),
+    (0x1D41E, 'M', 'e'),
+    (0x1D41F, 'M', 'f'),
+    (0x1D420, 'M', 'g'),
+    (0x1D421, 'M', 'h'),
+    (0x1D422, 'M', 'i'),
+    (0x1D423, 'M', 'j'),
+    (0x1D424, 'M', 'k'),
+    ]
+
+def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1D425, 'M', 'l'),
+    (0x1D426, 'M', 'm'),
+    (0x1D427, 'M', 'n'),
+    (0x1D428, 'M', 'o'),
+    (0x1D429, 'M', 'p'),
+    (0x1D42A, 'M', 'q'),
+    (0x1D42B, 'M', 'r'),
+    (0x1D42C, 'M', 's'),
+    (0x1D42D, 'M', 't'),
+    (0x1D42E, 'M', 'u'),
+    (0x1D42F, 'M', 'v'),
+    (0x1D430, 'M', 'w'),
+    (0x1D431, 'M', 'x'),
+    (0x1D432, 'M', 'y'),
+    (0x1D433, 'M', 'z'),
+    (0x1D434, 'M', 'a'),
+    (0x1D435, 'M', 'b'),
+    (0x1D436, 'M', 'c'),
+    (0x1D437, 'M', 'd'),
+    (0x1D438, 'M', 'e'),
+    (0x1D439, 'M', 'f'),
+    (0x1D43A, 'M', 'g'),
+    (0x1D43B, 'M', 'h'),
+    (0x1D43C, 'M', 'i'),
+    (0x1D43D, 'M', 'j'),
+    (0x1D43E, 'M', 'k'),
+    (0x1D43F, 'M', 'l'),
+    (0x1D440, 'M', 'm'),
+    (0x1D441, 'M', 'n'),
+    (0x1D442, 'M', 'o'),
+    (0x1D443, 'M', 'p'),
+    (0x1D444, 'M', 'q'),
+    (0x1D445, 'M', 'r'),
+    (0x1D446, 'M', 's'),
+    (0x1D447, 'M', 't'),
+    (0x1D448, 'M', 'u'),
+    (0x1D449, 'M', 'v'),
+    (0x1D44A, 'M', 'w'),
+    (0x1D44B, 'M', 'x'),
+    (0x1D44C, 'M', 'y'),
+    (0x1D44D, 'M', 'z'),
+    (0x1D44E, 'M', 'a'),
+    (0x1D44F, 'M', 'b'),
+    (0x1D450, 'M', 'c'),
+    (0x1D451, 'M', 'd'),
+    (0x1D452, 'M', 'e'),
+    (0x1D453, 'M', 'f'),
+    (0x1D454, 'M', 'g'),
+    (0x1D455, 'X'),
+    (0x1D456, 'M', 'i'),
+    (0x1D457, 'M', 'j'),
+    (0x1D458, 'M', 'k'),
+    (0x1D459, 'M', 'l'),
+    (0x1D45A, 'M', 'm'),
+    (0x1D45B, 'M', 'n'),
+    (0x1D45C, 'M', 'o'),
+    (0x1D45D, 'M', 'p'),
+    (0x1D45E, 'M', 'q'),
+    (0x1D45F, 'M', 'r'),
+    (0x1D460, 'M', 's'),
+    (0x1D461, 'M', 't'),
+    (0x1D462, 'M', 'u'),
+    (0x1D463, 'M', 'v'),
+    (0x1D464, 'M', 'w'),
+    (0x1D465, 'M', 'x'),
+    (0x1D466, 'M', 'y'),
+    (0x1D467, 'M', 'z'),
+    (0x1D468, 'M', 'a'),
+    (0x1D469, 'M', 'b'),
+    (0x1D46A, 'M', 'c'),
+    (0x1D46B, 'M', 'd'),
+    (0x1D46C, 'M', 'e'),
+    (0x1D46D, 'M', 'f'),
+    (0x1D46E, 'M', 'g'),
+    (0x1D46F, 'M', 'h'),
+    (0x1D470, 'M', 'i'),
+    (0x1D471, 'M', 'j'),
+    (0x1D472, 'M', 'k'),
+    (0x1D473, 'M', 'l'),
+    (0x1D474, 'M', 'm'),
+    (0x1D475, 'M', 'n'),
+    (0x1D476, 'M', 'o'),
+    (0x1D477, 'M', 'p'),
+    (0x1D478, 'M', 'q'),
+    (0x1D479, 'M', 'r'),
+    (0x1D47A, 'M', 's'),
+    (0x1D47B, 'M', 't'),
+    (0x1D47C, 'M', 'u'),
+    (0x1D47D, 'M', 'v'),
+    (0x1D47E, 'M', 'w'),
+    (0x1D47F, 'M', 'x'),
+    (0x1D480, 'M', 'y'),
+    (0x1D481, 'M', 'z'),
+    (0x1D482, 'M', 'a'),
+    (0x1D483, 'M', 'b'),
+    (0x1D484, 'M', 'c'),
+    (0x1D485, 'M', 'd'),
+    (0x1D486, 'M', 'e'),
+    (0x1D487, 'M', 'f'),
+    (0x1D488, 'M', 'g'),
+    ]
+
+def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1D489, 'M', 'h'),
+    (0x1D48A, 'M', 'i'),
+    (0x1D48B, 'M', 'j'),
+    (0x1D48C, 'M', 'k'),
+    (0x1D48D, 'M', 'l'),
+    (0x1D48E, 'M', 'm'),
+    (0x1D48F, 'M', 'n'),
+    (0x1D490, 'M', 'o'),
+    (0x1D491, 'M', 'p'),
+    (0x1D492, 'M', 'q'),
+    (0x1D493, 'M', 'r'),
+    (0x1D494, 'M', 's'),
+    (0x1D495, 'M', 't'),
+    (0x1D496, 'M', 'u'),
+    (0x1D497, 'M', 'v'),
+    (0x1D498, 'M', 'w'),
+    (0x1D499, 'M', 'x'),
+    (0x1D49A, 'M', 'y'),
+    (0x1D49B, 'M', 'z'),
+    (0x1D49C, 'M', 'a'),
+    (0x1D49D, 'X'),
+    (0x1D49E, 'M', 'c'),
+    (0x1D49F, 'M', 'd'),
+    (0x1D4A0, 'X'),
+    (0x1D4A2, 'M', 'g'),
+    (0x1D4A3, 'X'),
+    (0x1D4A5, 'M', 'j'),
+    (0x1D4A6, 'M', 'k'),
+    (0x1D4A7, 'X'),
+    (0x1D4A9, 'M', 'n'),
+    (0x1D4AA, 'M', 'o'),
+    (0x1D4AB, 'M', 'p'),
+    (0x1D4AC, 'M', 'q'),
+    (0x1D4AD, 'X'),
+    (0x1D4AE, 'M', 's'),
+    (0x1D4AF, 'M', 't'),
+    (0x1D4B0, 'M', 'u'),
+    (0x1D4B1, 'M', 'v'),
+    (0x1D4B2, 'M', 'w'),
+    (0x1D4B3, 'M', 'x'),
+    (0x1D4B4, 'M', 'y'),
+    (0x1D4B5, 'M', 'z'),
+    (0x1D4B6, 'M', 'a'),
+    (0x1D4B7, 'M', 'b'),
+    (0x1D4B8, 'M', 'c'),
+    (0x1D4B9, 'M', 'd'),
+    (0x1D4BA, 'X'),
+    (0x1D4BB, 'M', 'f'),
+    (0x1D4BC, 'X'),
+    (0x1D4BD, 'M', 'h'),
+    (0x1D4BE, 'M', 'i'),
+    (0x1D4BF, 'M', 'j'),
+    (0x1D4C0, 'M', 'k'),
+    (0x1D4C1, 'M', 'l'),
+    (0x1D4C2, 'M', 'm'),
+    (0x1D4C3, 'M', 'n'),
+    (0x1D4C4, 'X'),
+    (0x1D4C5, 'M', 'p'),
+    (0x1D4C6, 'M', 'q'),
+    (0x1D4C7, 'M', 'r'),
+    (0x1D4C8, 'M', 's'),
+    (0x1D4C9, 'M', 't'),
+    (0x1D4CA, 'M', 'u'),
+    (0x1D4CB, 'M', 'v'),
+    (0x1D4CC, 'M', 'w'),
+    (0x1D4CD, 'M', 'x'),
+    (0x1D4CE, 'M', 'y'),
+    (0x1D4CF, 'M', 'z'),
+    (0x1D4D0, 'M', 'a'),
+    (0x1D4D1, 'M', 'b'),
+    (0x1D4D2, 'M', 'c'),
+    (0x1D4D3, 'M', 'd'),
+    (0x1D4D4, 'M', 'e'),
+    (0x1D4D5, 'M', 'f'),
+    (0x1D4D6, 'M', 'g'),
+    (0x1D4D7, 'M', 'h'),
+    (0x1D4D8, 'M', 'i'),
+    (0x1D4D9, 'M', 'j'),
+    (0x1D4DA, 'M', 'k'),
+    (0x1D4DB, 'M', 'l'),
+    (0x1D4DC, 'M', 'm'),
+    (0x1D4DD, 'M', 'n'),
+    (0x1D4DE, 'M', 'o'),
+    (0x1D4DF, 'M', 'p'),
+    (0x1D4E0, 'M', 'q'),
+    (0x1D4E1, 'M', 'r'),
+    (0x1D4E2, 'M', 's'),
+    (0x1D4E3, 'M', 't'),
+    (0x1D4E4, 'M', 'u'),
+    (0x1D4E5, 'M', 'v'),
+    (0x1D4E6, 'M', 'w'),
+    (0x1D4E7, 'M', 'x'),
+    (0x1D4E8, 'M', 'y'),
+    (0x1D4E9, 'M', 'z'),
+    (0x1D4EA, 'M', 'a'),
+    (0x1D4EB, 'M', 'b'),
+    (0x1D4EC, 'M', 'c'),
+    (0x1D4ED, 'M', 'd'),
+    (0x1D4EE, 'M', 'e'),
+    (0x1D4EF, 'M', 'f'),
+    ]
+
+def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1D4F0, 'M', 'g'),
+    (0x1D4F1, 'M', 'h'),
+    (0x1D4F2, 'M', 'i'),
+    (0x1D4F3, 'M', 'j'),
+    (0x1D4F4, 'M', 'k'),
+    (0x1D4F5, 'M', 'l'),
+    (0x1D4F6, 'M', 'm'),
+    (0x1D4F7, 'M', 'n'),
+    (0x1D4F8, 'M', 'o'),
+    (0x1D4F9, 'M', 'p'),
+    (0x1D4FA, 'M', 'q'),
+    (0x1D4FB, 'M', 'r'),
+    (0x1D4FC, 'M', 's'),
+    (0x1D4FD, 'M', 't'),
+    (0x1D4FE, 'M', 'u'),
+    (0x1D4FF, 'M', 'v'),
+    (0x1D500, 'M', 'w'),
+    (0x1D501, 'M', 'x'),
+    (0x1D502, 'M', 'y'),
+    (0x1D503, 'M', 'z'),
+    (0x1D504, 'M', 'a'),
+    (0x1D505, 'M', 'b'),
+    (0x1D506, 'X'),
+    (0x1D507, 'M', 'd'),
+    (0x1D508, 'M', 'e'),
+    (0x1D509, 'M', 'f'),
+    (0x1D50A, 'M', 'g'),
+    (0x1D50B, 'X'),
+    (0x1D50D, 'M', 'j'),
+    (0x1D50E, 'M', 'k'),
+    (0x1D50F, 'M', 'l'),
+    (0x1D510, 'M', 'm'),
+    (0x1D511, 'M', 'n'),
+    (0x1D512, 'M', 'o'),
+    (0x1D513, 'M', 'p'),
+    (0x1D514, 'M', 'q'),
+    (0x1D515, 'X'),
+    (0x1D516, 'M', 's'),
+    (0x1D517, 'M', 't'),
+    (0x1D518, 'M', 'u'),
+    (0x1D519, 'M', 'v'),
+    (0x1D51A, 'M', 'w'),
+    (0x1D51B, 'M', 'x'),
+    (0x1D51C, 'M', 'y'),
+    (0x1D51D, 'X'),
+    (0x1D51E, 'M', 'a'),
+    (0x1D51F, 'M', 'b'),
+    (0x1D520, 'M', 'c'),
+    (0x1D521, 'M', 'd'),
+    (0x1D522, 'M', 'e'),
+    (0x1D523, 'M', 'f'),
+    (0x1D524, 'M', 'g'),
+    (0x1D525, 'M', 'h'),
+    (0x1D526, 'M', 'i'),
+    (0x1D527, 'M', 'j'),
+    (0x1D528, 'M', 'k'),
+    (0x1D529, 'M', 'l'),
+    (0x1D52A, 'M', 'm'),
+    (0x1D52B, 'M', 'n'),
+    (0x1D52C, 'M', 'o'),
+    (0x1D52D, 'M', 'p'),
+    (0x1D52E, 'M', 'q'),
+    (0x1D52F, 'M', 'r'),
+    (0x1D530, 'M', 's'),
+    (0x1D531, 'M', 't'),
+    (0x1D532, 'M', 'u'),
+    (0x1D533, 'M', 'v'),
+    (0x1D534, 'M', 'w'),
+    (0x1D535, 'M', 'x'),
+    (0x1D536, 'M', 'y'),
+    (0x1D537, 'M', 'z'),
+    (0x1D538, 'M', 'a'),
+    (0x1D539, 'M', 'b'),
+    (0x1D53A, 'X'),
+    (0x1D53B, 'M', 'd'),
+    (0x1D53C, 'M', 'e'),
+    (0x1D53D, 'M', 'f'),
+    (0x1D53E, 'M', 'g'),
+    (0x1D53F, 'X'),
+    (0x1D540, 'M', 'i'),
+    (0x1D541, 'M', 'j'),
+    (0x1D542, 'M', 'k'),
+    (0x1D543, 'M', 'l'),
+    (0x1D544, 'M', 'm'),
+    (0x1D545, 'X'),
+    (0x1D546, 'M', 'o'),
+    (0x1D547, 'X'),
+    (0x1D54A, 'M', 's'),
+    (0x1D54B, 'M', 't'),
+    (0x1D54C, 'M', 'u'),
+    (0x1D54D, 'M', 'v'),
+    (0x1D54E, 'M', 'w'),
+    (0x1D54F, 'M', 'x'),
+    (0x1D550, 'M', 'y'),
+    (0x1D551, 'X'),
+    (0x1D552, 'M', 'a'),
+    (0x1D553, 'M', 'b'),
+    (0x1D554, 'M', 'c'),
+    (0x1D555, 'M', 'd'),
+    (0x1D556, 'M', 'e'),
+    ]
+
+def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1D557, 'M', 'f'),
+    (0x1D558, 'M', 'g'),
+    (0x1D559, 'M', 'h'),
+    (0x1D55A, 'M', 'i'),
+    (0x1D55B, 'M', 'j'),
+    (0x1D55C, 'M', 'k'),
+    (0x1D55D, 'M', 'l'),
+    (0x1D55E, 'M', 'm'),
+    (0x1D55F, 'M', 'n'),
+    (0x1D560, 'M', 'o'),
+    (0x1D561, 'M', 'p'),
+    (0x1D562, 'M', 'q'),
+    (0x1D563, 'M', 'r'),
+    (0x1D564, 'M', 's'),
+    (0x1D565, 'M', 't'),
+    (0x1D566, 'M', 'u'),
+    (0x1D567, 'M', 'v'),
+    (0x1D568, 'M', 'w'),
+    (0x1D569, 'M', 'x'),
+    (0x1D56A, 'M', 'y'),
+    (0x1D56B, 'M', 'z'),
+    (0x1D56C, 'M', 'a'),
+    (0x1D56D, 'M', 'b'),
+    (0x1D56E, 'M', 'c'),
+    (0x1D56F, 'M', 'd'),
+    (0x1D570, 'M', 'e'),
+    (0x1D571, 'M', 'f'),
+    (0x1D572, 'M', 'g'),
+    (0x1D573, 'M', 'h'),
+    (0x1D574, 'M', 'i'),
+    (0x1D575, 'M', 'j'),
+    (0x1D576, 'M', 'k'),
+    (0x1D577, 'M', 'l'),
+    (0x1D578, 'M', 'm'),
+    (0x1D579, 'M', 'n'),
+    (0x1D57A, 'M', 'o'),
+    (0x1D57B, 'M', 'p'),
+    (0x1D57C, 'M', 'q'),
+    (0x1D57D, 'M', 'r'),
+    (0x1D57E, 'M', 's'),
+    (0x1D57F, 'M', 't'),
+    (0x1D580, 'M', 'u'),
+    (0x1D581, 'M', 'v'),
+    (0x1D582, 'M', 'w'),
+    (0x1D583, 'M', 'x'),
+    (0x1D584, 'M', 'y'),
+    (0x1D585, 'M', 'z'),
+    (0x1D586, 'M', 'a'),
+    (0x1D587, 'M', 'b'),
+    (0x1D588, 'M', 'c'),
+    (0x1D589, 'M', 'd'),
+    (0x1D58A, 'M', 'e'),
+    (0x1D58B, 'M', 'f'),
+    (0x1D58C, 'M', 'g'),
+    (0x1D58D, 'M', 'h'),
+    (0x1D58E, 'M', 'i'),
+    (0x1D58F, 'M', 'j'),
+    (0x1D590, 'M', 'k'),
+    (0x1D591, 'M', 'l'),
+    (0x1D592, 'M', 'm'),
+    (0x1D593, 'M', 'n'),
+    (0x1D594, 'M', 'o'),
+    (0x1D595, 'M', 'p'),
+    (0x1D596, 'M', 'q'),
+    (0x1D597, 'M', 'r'),
+    (0x1D598, 'M', 's'),
+    (0x1D599, 'M', 't'),
+    (0x1D59A, 'M', 'u'),
+    (0x1D59B, 'M', 'v'),
+    (0x1D59C, 'M', 'w'),
+    (0x1D59D, 'M', 'x'),
+    (0x1D59E, 'M', 'y'),
+    (0x1D59F, 'M', 'z'),
+    (0x1D5A0, 'M', 'a'),
+    (0x1D5A1, 'M', 'b'),
+    (0x1D5A2, 'M', 'c'),
+    (0x1D5A3, 'M', 'd'),
+    (0x1D5A4, 'M', 'e'),
+    (0x1D5A5, 'M', 'f'),
+    (0x1D5A6, 'M', 'g'),
+    (0x1D5A7, 'M', 'h'),
+    (0x1D5A8, 'M', 'i'),
+    (0x1D5A9, 'M', 'j'),
+    (0x1D5AA, 'M', 'k'),
+    (0x1D5AB, 'M', 'l'),
+    (0x1D5AC, 'M', 'm'),
+    (0x1D5AD, 'M', 'n'),
+    (0x1D5AE, 'M', 'o'),
+    (0x1D5AF, 'M', 'p'),
+    (0x1D5B0, 'M', 'q'),
+    (0x1D5B1, 'M', 'r'),
+    (0x1D5B2, 'M', 's'),
+    (0x1D5B3, 'M', 't'),
+    (0x1D5B4, 'M', 'u'),
+    (0x1D5B5, 'M', 'v'),
+    (0x1D5B6, 'M', 'w'),
+    (0x1D5B7, 'M', 'x'),
+    (0x1D5B8, 'M', 'y'),
+    (0x1D5B9, 'M', 'z'),
+    (0x1D5BA, 'M', 'a'),
+    ]
+
+def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1D5BB, 'M', 'b'),
+    (0x1D5BC, 'M', 'c'),
+    (0x1D5BD, 'M', 'd'),
+    (0x1D5BE, 'M', 'e'),
+    (0x1D5BF, 'M', 'f'),
+    (0x1D5C0, 'M', 'g'),
+    (0x1D5C1, 'M', 'h'),
+    (0x1D5C2, 'M', 'i'),
+    (0x1D5C3, 'M', 'j'),
+    (0x1D5C4, 'M', 'k'),
+    (0x1D5C5, 'M', 'l'),
+    (0x1D5C6, 'M', 'm'),
+    (0x1D5C7, 'M', 'n'),
+    (0x1D5C8, 'M', 'o'),
+    (0x1D5C9, 'M', 'p'),
+    (0x1D5CA, 'M', 'q'),
+    (0x1D5CB, 'M', 'r'),
+    (0x1D5CC, 'M', 's'),
+    (0x1D5CD, 'M', 't'),
+    (0x1D5CE, 'M', 'u'),
+    (0x1D5CF, 'M', 'v'),
+    (0x1D5D0, 'M', 'w'),
+    (0x1D5D1, 'M', 'x'),
+    (0x1D5D2, 'M', 'y'),
+    (0x1D5D3, 'M', 'z'),
+    (0x1D5D4, 'M', 'a'),
+    (0x1D5D5, 'M', 'b'),
+    (0x1D5D6, 'M', 'c'),
+    (0x1D5D7, 'M', 'd'),
+    (0x1D5D8, 'M', 'e'),
+    (0x1D5D9, 'M', 'f'),
+    (0x1D5DA, 'M', 'g'),
+    (0x1D5DB, 'M', 'h'),
+    (0x1D5DC, 'M', 'i'),
+    (0x1D5DD, 'M', 'j'),
+    (0x1D5DE, 'M', 'k'),
+    (0x1D5DF, 'M', 'l'),
+    (0x1D5E0, 'M', 'm'),
+    (0x1D5E1, 'M', 'n'),
+    (0x1D5E2, 'M', 'o'),
+    (0x1D5E3, 'M', 'p'),
+    (0x1D5E4, 'M', 'q'),
+    (0x1D5E5, 'M', 'r'),
+    (0x1D5E6, 'M', 's'),
+    (0x1D5E7, 'M', 't'),
+    (0x1D5E8, 'M', 'u'),
+    (0x1D5E9, 'M', 'v'),
+    (0x1D5EA, 'M', 'w'),
+    (0x1D5EB, 'M', 'x'),
+    (0x1D5EC, 'M', 'y'),
+    (0x1D5ED, 'M', 'z'),
+    (0x1D5EE, 'M', 'a'),
+    (0x1D5EF, 'M', 'b'),
+    (0x1D5F0, 'M', 'c'),
+    (0x1D5F1, 'M', 'd'),
+    (0x1D5F2, 'M', 'e'),
+    (0x1D5F3, 'M', 'f'),
+    (0x1D5F4, 'M', 'g'),
+    (0x1D5F5, 'M', 'h'),
+    (0x1D5F6, 'M', 'i'),
+    (0x1D5F7, 'M', 'j'),
+    (0x1D5F8, 'M', 'k'),
+    (0x1D5F9, 'M', 'l'),
+    (0x1D5FA, 'M', 'm'),
+    (0x1D5FB, 'M', 'n'),
+    (0x1D5FC, 'M', 'o'),
+    (0x1D5FD, 'M', 'p'),
+    (0x1D5FE, 'M', 'q'),
+    (0x1D5FF, 'M', 'r'),
+    (0x1D600, 'M', 's'),
+    (0x1D601, 'M', 't'),
+    (0x1D602, 'M', 'u'),
+    (0x1D603, 'M', 'v'),
+    (0x1D604, 'M', 'w'),
+    (0x1D605, 'M', 'x'),
+    (0x1D606, 'M', 'y'),
+    (0x1D607, 'M', 'z'),
+    (0x1D608, 'M', 'a'),
+    (0x1D609, 'M', 'b'),
+    (0x1D60A, 'M', 'c'),
+    (0x1D60B, 'M', 'd'),
+    (0x1D60C, 'M', 'e'),
+    (0x1D60D, 'M', 'f'),
+    (0x1D60E, 'M', 'g'),
+    (0x1D60F, 'M', 'h'),
+    (0x1D610, 'M', 'i'),
+    (0x1D611, 'M', 'j'),
+    (0x1D612, 'M', 'k'),
+    (0x1D613, 'M', 'l'),
+    (0x1D614, 'M', 'm'),
+    (0x1D615, 'M', 'n'),
+    (0x1D616, 'M', 'o'),
+    (0x1D617, 'M', 'p'),
+    (0x1D618, 'M', 'q'),
+    (0x1D619, 'M', 'r'),
+    (0x1D61A, 'M', 's'),
+    (0x1D61B, 'M', 't'),
+    (0x1D61C, 'M', 'u'),
+    (0x1D61D, 'M', 'v'),
+    (0x1D61E, 'M', 'w'),
+    ]
+
+def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1D61F, 'M', 'x'),
+    (0x1D620, 'M', 'y'),
+    (0x1D621, 'M', 'z'),
+    (0x1D622, 'M', 'a'),
+    (0x1D623, 'M', 'b'),
+    (0x1D624, 'M', 'c'),
+    (0x1D625, 'M', 'd'),
+    (0x1D626, 'M', 'e'),
+    (0x1D627, 'M', 'f'),
+    (0x1D628, 'M', 'g'),
+    (0x1D629, 'M', 'h'),
+    (0x1D62A, 'M', 'i'),
+    (0x1D62B, 'M', 'j'),
+    (0x1D62C, 'M', 'k'),
+    (0x1D62D, 'M', 'l'),
+    (0x1D62E, 'M', 'm'),
+    (0x1D62F, 'M', 'n'),
+    (0x1D630, 'M', 'o'),
+    (0x1D631, 'M', 'p'),
+    (0x1D632, 'M', 'q'),
+    (0x1D633, 'M', 'r'),
+    (0x1D634, 'M', 's'),
+    (0x1D635, 'M', 't'),
+    (0x1D636, 'M', 'u'),
+    (0x1D637, 'M', 'v'),
+    (0x1D638, 'M', 'w'),
+    (0x1D639, 'M', 'x'),
+    (0x1D63A, 'M', 'y'),
+    (0x1D63B, 'M', 'z'),
+    (0x1D63C, 'M', 'a'),
+    (0x1D63D, 'M', 'b'),
+    (0x1D63E, 'M', 'c'),
+    (0x1D63F, 'M', 'd'),
+    (0x1D640, 'M', 'e'),
+    (0x1D641, 'M', 'f'),
+    (0x1D642, 'M', 'g'),
+    (0x1D643, 'M', 'h'),
+    (0x1D644, 'M', 'i'),
+    (0x1D645, 'M', 'j'),
+    (0x1D646, 'M', 'k'),
+    (0x1D647, 'M', 'l'),
+    (0x1D648, 'M', 'm'),
+    (0x1D649, 'M', 'n'),
+    (0x1D64A, 'M', 'o'),
+    (0x1D64B, 'M', 'p'),
+    (0x1D64C, 'M', 'q'),
+    (0x1D64D, 'M', 'r'),
+    (0x1D64E, 'M', 's'),
+    (0x1D64F, 'M', 't'),
+    (0x1D650, 'M', 'u'),
+    (0x1D651, 'M', 'v'),
+    (0x1D652, 'M', 'w'),
+    (0x1D653, 'M', 'x'),
+    (0x1D654, 'M', 'y'),
+    (0x1D655, 'M', 'z'),
+    (0x1D656, 'M', 'a'),
+    (0x1D657, 'M', 'b'),
+    (0x1D658, 'M', 'c'),
+    (0x1D659, 'M', 'd'),
+    (0x1D65A, 'M', 'e'),
+    (0x1D65B, 'M', 'f'),
+    (0x1D65C, 'M', 'g'),
+    (0x1D65D, 'M', 'h'),
+    (0x1D65E, 'M', 'i'),
+    (0x1D65F, 'M', 'j'),
+    (0x1D660, 'M', 'k'),
+    (0x1D661, 'M', 'l'),
+    (0x1D662, 'M', 'm'),
+    (0x1D663, 'M', 'n'),
+    (0x1D664, 'M', 'o'),
+    (0x1D665, 'M', 'p'),
+    (0x1D666, 'M', 'q'),
+    (0x1D667, 'M', 'r'),
+    (0x1D668, 'M', 's'),
+    (0x1D669, 'M', 't'),
+    (0x1D66A, 'M', 'u'),
+    (0x1D66B, 'M', 'v'),
+    (0x1D66C, 'M', 'w'),
+    (0x1D66D, 'M', 'x'),
+    (0x1D66E, 'M', 'y'),
+    (0x1D66F, 'M', 'z'),
+    (0x1D670, 'M', 'a'),
+    (0x1D671, 'M', 'b'),
+    (0x1D672, 'M', 'c'),
+    (0x1D673, 'M', 'd'),
+    (0x1D674, 'M', 'e'),
+    (0x1D675, 'M', 'f'),
+    (0x1D676, 'M', 'g'),
+    (0x1D677, 'M', 'h'),
+    (0x1D678, 'M', 'i'),
+    (0x1D679, 'M', 'j'),
+    (0x1D67A, 'M', 'k'),
+    (0x1D67B, 'M', 'l'),
+    (0x1D67C, 'M', 'm'),
+    (0x1D67D, 'M', 'n'),
+    (0x1D67E, 'M', 'o'),
+    (0x1D67F, 'M', 'p'),
+    (0x1D680, 'M', 'q'),
+    (0x1D681, 'M', 'r'),
+    (0x1D682, 'M', 's'),
+    ]
+
+def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1D683, 'M', 't'),
+    (0x1D684, 'M', 'u'),
+    (0x1D685, 'M', 'v'),
+    (0x1D686, 'M', 'w'),
+    (0x1D687, 'M', 'x'),
+    (0x1D688, 'M', 'y'),
+    (0x1D689, 'M', 'z'),
+    (0x1D68A, 'M', 'a'),
+    (0x1D68B, 'M', 'b'),
+    (0x1D68C, 'M', 'c'),
+    (0x1D68D, 'M', 'd'),
+    (0x1D68E, 'M', 'e'),
+    (0x1D68F, 'M', 'f'),
+    (0x1D690, 'M', 'g'),
+    (0x1D691, 'M', 'h'),
+    (0x1D692, 'M', 'i'),
+    (0x1D693, 'M', 'j'),
+    (0x1D694, 'M', 'k'),
+    (0x1D695, 'M', 'l'),
+    (0x1D696, 'M', 'm'),
+    (0x1D697, 'M', 'n'),
+    (0x1D698, 'M', 'o'),
+    (0x1D699, 'M', 'p'),
+    (0x1D69A, 'M', 'q'),
+    (0x1D69B, 'M', 'r'),
+    (0x1D69C, 'M', 's'),
+    (0x1D69D, 'M', 't'),
+    (0x1D69E, 'M', 'u'),
+    (0x1D69F, 'M', 'v'),
+    (0x1D6A0, 'M', 'w'),
+    (0x1D6A1, 'M', 'x'),
+    (0x1D6A2, 'M', 'y'),
+    (0x1D6A3, 'M', 'z'),
+    (0x1D6A4, 'M', 'ı'),
+    (0x1D6A5, 'M', 'ȷ'),
+    (0x1D6A6, 'X'),
+    (0x1D6A8, 'M', 'α'),
+    (0x1D6A9, 'M', 'β'),
+    (0x1D6AA, 'M', 'γ'),
+    (0x1D6AB, 'M', 'δ'),
+    (0x1D6AC, 'M', 'ε'),
+    (0x1D6AD, 'M', 'ζ'),
+    (0x1D6AE, 'M', 'η'),
+    (0x1D6AF, 'M', 'θ'),
+    (0x1D6B0, 'M', 'ι'),
+    (0x1D6B1, 'M', 'κ'),
+    (0x1D6B2, 'M', 'λ'),
+    (0x1D6B3, 'M', 'μ'),
+    (0x1D6B4, 'M', 'ν'),
+    (0x1D6B5, 'M', 'ξ'),
+    (0x1D6B6, 'M', 'ο'),
+    (0x1D6B7, 'M', 'π'),
+    (0x1D6B8, 'M', 'ρ'),
+    (0x1D6B9, 'M', 'θ'),
+    (0x1D6BA, 'M', 'σ'),
+    (0x1D6BB, 'M', 'τ'),
+    (0x1D6BC, 'M', 'υ'),
+    (0x1D6BD, 'M', 'φ'),
+    (0x1D6BE, 'M', 'χ'),
+    (0x1D6BF, 'M', 'ψ'),
+    (0x1D6C0, 'M', 'ω'),
+    (0x1D6C1, 'M', '∇'),
+    (0x1D6C2, 'M', 'α'),
+    (0x1D6C3, 'M', 'β'),
+    (0x1D6C4, 'M', 'γ'),
+    (0x1D6C5, 'M', 'δ'),
+    (0x1D6C6, 'M', 'ε'),
+    (0x1D6C7, 'M', 'ζ'),
+    (0x1D6C8, 'M', 'η'),
+    (0x1D6C9, 'M', 'θ'),
+    (0x1D6CA, 'M', 'ι'),
+    (0x1D6CB, 'M', 'κ'),
+    (0x1D6CC, 'M', 'λ'),
+    (0x1D6CD, 'M', 'μ'),
+    (0x1D6CE, 'M', 'ν'),
+    (0x1D6CF, 'M', 'ξ'),
+    (0x1D6D0, 'M', 'ο'),
+    (0x1D6D1, 'M', 'π'),
+    (0x1D6D2, 'M', 'ρ'),
+    (0x1D6D3, 'M', 'σ'),
+    (0x1D6D5, 'M', 'τ'),
+    (0x1D6D6, 'M', 'υ'),
+    (0x1D6D7, 'M', 'φ'),
+    (0x1D6D8, 'M', 'χ'),
+    (0x1D6D9, 'M', 'ψ'),
+    (0x1D6DA, 'M', 'ω'),
+    (0x1D6DB, 'M', '∂'),
+    (0x1D6DC, 'M', 'ε'),
+    (0x1D6DD, 'M', 'θ'),
+    (0x1D6DE, 'M', 'κ'),
+    (0x1D6DF, 'M', 'φ'),
+    (0x1D6E0, 'M', 'ρ'),
+    (0x1D6E1, 'M', 'π'),
+    (0x1D6E2, 'M', 'α'),
+    (0x1D6E3, 'M', 'β'),
+    (0x1D6E4, 'M', 'γ'),
+    (0x1D6E5, 'M', 'δ'),
+    (0x1D6E6, 'M', 'ε'),
+    (0x1D6E7, 'M', 'ζ'),
+    (0x1D6E8, 'M', 'η'),
+    ]
+
+def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1D6E9, 'M', 'θ'),
+    (0x1D6EA, 'M', 'ι'),
+    (0x1D6EB, 'M', 'κ'),
+    (0x1D6EC, 'M', 'λ'),
+    (0x1D6ED, 'M', 'μ'),
+    (0x1D6EE, 'M', 'ν'),
+    (0x1D6EF, 'M', 'ξ'),
+    (0x1D6F0, 'M', 'ο'),
+    (0x1D6F1, 'M', 'π'),
+    (0x1D6F2, 'M', 'ρ'),
+    (0x1D6F3, 'M', 'θ'),
+    (0x1D6F4, 'M', 'σ'),
+    (0x1D6F5, 'M', 'τ'),
+    (0x1D6F6, 'M', 'υ'),
+    (0x1D6F7, 'M', 'φ'),
+    (0x1D6F8, 'M', 'χ'),
+    (0x1D6F9, 'M', 'ψ'),
+    (0x1D6FA, 'M', 'ω'),
+    (0x1D6FB, 'M', '∇'),
+    (0x1D6FC, 'M', 'α'),
+    (0x1D6FD, 'M', 'β'),
+    (0x1D6FE, 'M', 'γ'),
+    (0x1D6FF, 'M', 'δ'),
+    (0x1D700, 'M', 'ε'),
+    (0x1D701, 'M', 'ζ'),
+    (0x1D702, 'M', 'η'),
+    (0x1D703, 'M', 'θ'),
+    (0x1D704, 'M', 'ι'),
+    (0x1D705, 'M', 'κ'),
+    (0x1D706, 'M', 'λ'),
+    (0x1D707, 'M', 'μ'),
+    (0x1D708, 'M', 'ν'),
+    (0x1D709, 'M', 'ξ'),
+    (0x1D70A, 'M', 'ο'),
+    (0x1D70B, 'M', 'π'),
+    (0x1D70C, 'M', 'ρ'),
+    (0x1D70D, 'M', 'σ'),
+    (0x1D70F, 'M', 'τ'),
+    (0x1D710, 'M', 'υ'),
+    (0x1D711, 'M', 'φ'),
+    (0x1D712, 'M', 'χ'),
+    (0x1D713, 'M', 'ψ'),
+    (0x1D714, 'M', 'ω'),
+    (0x1D715, 'M', '∂'),
+    (0x1D716, 'M', 'ε'),
+    (0x1D717, 'M', 'θ'),
+    (0x1D718, 'M', 'κ'),
+    (0x1D719, 'M', 'φ'),
+    (0x1D71A, 'M', 'ρ'),
+    (0x1D71B, 'M', 'π'),
+    (0x1D71C, 'M', 'α'),
+    (0x1D71D, 'M', 'β'),
+    (0x1D71E, 'M', 'γ'),
+    (0x1D71F, 'M', 'δ'),
+    (0x1D720, 'M', 'ε'),
+    (0x1D721, 'M', 'ζ'),
+    (0x1D722, 'M', 'η'),
+    (0x1D723, 'M', 'θ'),
+    (0x1D724, 'M', 'ι'),
+    (0x1D725, 'M', 'κ'),
+    (0x1D726, 'M', 'λ'),
+    (0x1D727, 'M', 'μ'),
+    (0x1D728, 'M', 'ν'),
+    (0x1D729, 'M', 'ξ'),
+    (0x1D72A, 'M', 'ο'),
+    (0x1D72B, 'M', 'π'),
+    (0x1D72C, 'M', 'ρ'),
+    (0x1D72D, 'M', 'θ'),
+    (0x1D72E, 'M', 'σ'),
+    (0x1D72F, 'M', 'τ'),
+    (0x1D730, 'M', 'υ'),
+    (0x1D731, 'M', 'φ'),
+    (0x1D732, 'M', 'χ'),
+    (0x1D733, 'M', 'ψ'),
+    (0x1D734, 'M', 'ω'),
+    (0x1D735, 'M', '∇'),
+    (0x1D736, 'M', 'α'),
+    (0x1D737, 'M', 'β'),
+    (0x1D738, 'M', 'γ'),
+    (0x1D739, 'M', 'δ'),
+    (0x1D73A, 'M', 'ε'),
+    (0x1D73B, 'M', 'ζ'),
+    (0x1D73C, 'M', 'η'),
+    (0x1D73D, 'M', 'θ'),
+    (0x1D73E, 'M', 'ι'),
+    (0x1D73F, 'M', 'κ'),
+    (0x1D740, 'M', 'λ'),
+    (0x1D741, 'M', 'μ'),
+    (0x1D742, 'M', 'ν'),
+    (0x1D743, 'M', 'ξ'),
+    (0x1D744, 'M', 'ο'),
+    (0x1D745, 'M', 'π'),
+    (0x1D746, 'M', 'ρ'),
+    (0x1D747, 'M', 'σ'),
+    (0x1D749, 'M', 'τ'),
+    (0x1D74A, 'M', 'υ'),
+    (0x1D74B, 'M', 'φ'),
+    (0x1D74C, 'M', 'χ'),
+    (0x1D74D, 'M', 'ψ'),
+    (0x1D74E, 'M', 'ω'),
+    ]
+
+def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1D74F, 'M', '∂'),
+    (0x1D750, 'M', 'ε'),
+    (0x1D751, 'M', 'θ'),
+    (0x1D752, 'M', 'κ'),
+    (0x1D753, 'M', 'φ'),
+    (0x1D754, 'M', 'ρ'),
+    (0x1D755, 'M', 'π'),
+    (0x1D756, 'M', 'α'),
+    (0x1D757, 'M', 'β'),
+    (0x1D758, 'M', 'γ'),
+    (0x1D759, 'M', 'δ'),
+    (0x1D75A, 'M', 'ε'),
+    (0x1D75B, 'M', 'ζ'),
+    (0x1D75C, 'M', 'η'),
+    (0x1D75D, 'M', 'θ'),
+    (0x1D75E, 'M', 'ι'),
+    (0x1D75F, 'M', 'κ'),
+    (0x1D760, 'M', 'λ'),
+    (0x1D761, 'M', 'μ'),
+    (0x1D762, 'M', 'ν'),
+    (0x1D763, 'M', 'ξ'),
+    (0x1D764, 'M', 'ο'),
+    (0x1D765, 'M', 'π'),
+    (0x1D766, 'M', 'ρ'),
+    (0x1D767, 'M', 'θ'),
+    (0x1D768, 'M', 'σ'),
+    (0x1D769, 'M', 'τ'),
+    (0x1D76A, 'M', 'υ'),
+    (0x1D76B, 'M', 'φ'),
+    (0x1D76C, 'M', 'χ'),
+    (0x1D76D, 'M', 'ψ'),
+    (0x1D76E, 'M', 'ω'),
+    (0x1D76F, 'M', '∇'),
+    (0x1D770, 'M', 'α'),
+    (0x1D771, 'M', 'β'),
+    (0x1D772, 'M', 'γ'),
+    (0x1D773, 'M', 'δ'),
+    (0x1D774, 'M', 'ε'),
+    (0x1D775, 'M', 'ζ'),
+    (0x1D776, 'M', 'η'),
+    (0x1D777, 'M', 'θ'),
+    (0x1D778, 'M', 'ι'),
+    (0x1D779, 'M', 'κ'),
+    (0x1D77A, 'M', 'λ'),
+    (0x1D77B, 'M', 'μ'),
+    (0x1D77C, 'M', 'ν'),
+    (0x1D77D, 'M', 'ξ'),
+    (0x1D77E, 'M', 'ο'),
+    (0x1D77F, 'M', 'π'),
+    (0x1D780, 'M', 'ρ'),
+    (0x1D781, 'M', 'σ'),
+    (0x1D783, 'M', 'τ'),
+    (0x1D784, 'M', 'υ'),
+    (0x1D785, 'M', 'φ'),
+    (0x1D786, 'M', 'χ'),
+    (0x1D787, 'M', 'ψ'),
+    (0x1D788, 'M', 'ω'),
+    (0x1D789, 'M', '∂'),
+    (0x1D78A, 'M', 'ε'),
+    (0x1D78B, 'M', 'θ'),
+    (0x1D78C, 'M', 'κ'),
+    (0x1D78D, 'M', 'φ'),
+    (0x1D78E, 'M', 'ρ'),
+    (0x1D78F, 'M', 'π'),
+    (0x1D790, 'M', 'α'),
+    (0x1D791, 'M', 'β'),
+    (0x1D792, 'M', 'γ'),
+    (0x1D793, 'M', 'δ'),
+    (0x1D794, 'M', 'ε'),
+    (0x1D795, 'M', 'ζ'),
+    (0x1D796, 'M', 'η'),
+    (0x1D797, 'M', 'θ'),
+    (0x1D798, 'M', 'ι'),
+    (0x1D799, 'M', 'κ'),
+    (0x1D79A, 'M', 'λ'),
+    (0x1D79B, 'M', 'μ'),
+    (0x1D79C, 'M', 'ν'),
+    (0x1D79D, 'M', 'ξ'),
+    (0x1D79E, 'M', 'ο'),
+    (0x1D79F, 'M', 'π'),
+    (0x1D7A0, 'M', 'ρ'),
+    (0x1D7A1, 'M', 'θ'),
+    (0x1D7A2, 'M', 'σ'),
+    (0x1D7A3, 'M', 'τ'),
+    (0x1D7A4, 'M', 'υ'),
+    (0x1D7A5, 'M', 'φ'),
+    (0x1D7A6, 'M', 'χ'),
+    (0x1D7A7, 'M', 'ψ'),
+    (0x1D7A8, 'M', 'ω'),
+    (0x1D7A9, 'M', '∇'),
+    (0x1D7AA, 'M', 'α'),
+    (0x1D7AB, 'M', 'β'),
+    (0x1D7AC, 'M', 'γ'),
+    (0x1D7AD, 'M', 'δ'),
+    (0x1D7AE, 'M', 'ε'),
+    (0x1D7AF, 'M', 'ζ'),
+    (0x1D7B0, 'M', 'η'),
+    (0x1D7B1, 'M', 'θ'),
+    (0x1D7B2, 'M', 'ι'),
+    (0x1D7B3, 'M', 'κ'),
+    ]
+
+def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1D7B4, 'M', 'λ'),
+    (0x1D7B5, 'M', 'μ'),
+    (0x1D7B6, 'M', 'ν'),
+    (0x1D7B7, 'M', 'ξ'),
+    (0x1D7B8, 'M', 'ο'),
+    (0x1D7B9, 'M', 'π'),
+    (0x1D7BA, 'M', 'ρ'),
+    (0x1D7BB, 'M', 'σ'),
+    (0x1D7BD, 'M', 'τ'),
+    (0x1D7BE, 'M', 'υ'),
+    (0x1D7BF, 'M', 'φ'),
+    (0x1D7C0, 'M', 'χ'),
+    (0x1D7C1, 'M', 'ψ'),
+    (0x1D7C2, 'M', 'ω'),
+    (0x1D7C3, 'M', '∂'),
+    (0x1D7C4, 'M', 'ε'),
+    (0x1D7C5, 'M', 'θ'),
+    (0x1D7C6, 'M', 'κ'),
+    (0x1D7C7, 'M', 'φ'),
+    (0x1D7C8, 'M', 'ρ'),
+    (0x1D7C9, 'M', 'π'),
+    (0x1D7CA, 'M', 'ϝ'),
+    (0x1D7CC, 'X'),
+    (0x1D7CE, 'M', '0'),
+    (0x1D7CF, 'M', '1'),
+    (0x1D7D0, 'M', '2'),
+    (0x1D7D1, 'M', '3'),
+    (0x1D7D2, 'M', '4'),
+    (0x1D7D3, 'M', '5'),
+    (0x1D7D4, 'M', '6'),
+    (0x1D7D5, 'M', '7'),
+    (0x1D7D6, 'M', '8'),
+    (0x1D7D7, 'M', '9'),
+    (0x1D7D8, 'M', '0'),
+    (0x1D7D9, 'M', '1'),
+    (0x1D7DA, 'M', '2'),
+    (0x1D7DB, 'M', '3'),
+    (0x1D7DC, 'M', '4'),
+    (0x1D7DD, 'M', '5'),
+    (0x1D7DE, 'M', '6'),
+    (0x1D7DF, 'M', '7'),
+    (0x1D7E0, 'M', '8'),
+    (0x1D7E1, 'M', '9'),
+    (0x1D7E2, 'M', '0'),
+    (0x1D7E3, 'M', '1'),
+    (0x1D7E4, 'M', '2'),
+    (0x1D7E5, 'M', '3'),
+    (0x1D7E6, 'M', '4'),
+    (0x1D7E7, 'M', '5'),
+    (0x1D7E8, 'M', '6'),
+    (0x1D7E9, 'M', '7'),
+    (0x1D7EA, 'M', '8'),
+    (0x1D7EB, 'M', '9'),
+    (0x1D7EC, 'M', '0'),
+    (0x1D7ED, 'M', '1'),
+    (0x1D7EE, 'M', '2'),
+    (0x1D7EF, 'M', '3'),
+    (0x1D7F0, 'M', '4'),
+    (0x1D7F1, 'M', '5'),
+    (0x1D7F2, 'M', '6'),
+    (0x1D7F3, 'M', '7'),
+    (0x1D7F4, 'M', '8'),
+    (0x1D7F5, 'M', '9'),
+    (0x1D7F6, 'M', '0'),
+    (0x1D7F7, 'M', '1'),
+    (0x1D7F8, 'M', '2'),
+    (0x1D7F9, 'M', '3'),
+    (0x1D7FA, 'M', '4'),
+    (0x1D7FB, 'M', '5'),
+    (0x1D7FC, 'M', '6'),
+    (0x1D7FD, 'M', '7'),
+    (0x1D7FE, 'M', '8'),
+    (0x1D7FF, 'M', '9'),
+    (0x1D800, 'V'),
+    (0x1DA8C, 'X'),
+    (0x1DA9B, 'V'),
+    (0x1DAA0, 'X'),
+    (0x1DAA1, 'V'),
+    (0x1DAB0, 'X'),
+    (0x1DF00, 'V'),
+    (0x1DF1F, 'X'),
+    (0x1DF25, 'V'),
+    (0x1DF2B, 'X'),
+    (0x1E000, 'V'),
+    (0x1E007, 'X'),
+    (0x1E008, 'V'),
+    (0x1E019, 'X'),
+    (0x1E01B, 'V'),
+    (0x1E022, 'X'),
+    (0x1E023, 'V'),
+    (0x1E025, 'X'),
+    (0x1E026, 'V'),
+    (0x1E02B, 'X'),
+    (0x1E030, 'M', 'а'),
+    (0x1E031, 'M', 'б'),
+    (0x1E032, 'M', 'в'),
+    (0x1E033, 'M', 'г'),
+    (0x1E034, 'M', 'д'),
+    (0x1E035, 'M', 'е'),
+    (0x1E036, 'M', 'ж'),
+    ]
+
+def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1E037, 'M', 'з'),
+    (0x1E038, 'M', 'и'),
+    (0x1E039, 'M', 'к'),
+    (0x1E03A, 'M', 'л'),
+    (0x1E03B, 'M', 'м'),
+    (0x1E03C, 'M', 'о'),
+    (0x1E03D, 'M', 'п'),
+    (0x1E03E, 'M', 'р'),
+    (0x1E03F, 'M', 'с'),
+    (0x1E040, 'M', 'т'),
+    (0x1E041, 'M', 'у'),
+    (0x1E042, 'M', 'ф'),
+    (0x1E043, 'M', 'х'),
+    (0x1E044, 'M', 'ц'),
+    (0x1E045, 'M', 'ч'),
+    (0x1E046, 'M', 'ш'),
+    (0x1E047, 'M', 'ы'),
+    (0x1E048, 'M', 'э'),
+    (0x1E049, 'M', 'ю'),
+    (0x1E04A, 'M', 'ꚉ'),
+    (0x1E04B, 'M', 'ә'),
+    (0x1E04C, 'M', 'і'),
+    (0x1E04D, 'M', 'ј'),
+    (0x1E04E, 'M', 'ө'),
+    (0x1E04F, 'M', 'ү'),
+    (0x1E050, 'M', 'ӏ'),
+    (0x1E051, 'M', 'а'),
+    (0x1E052, 'M', 'б'),
+    (0x1E053, 'M', 'в'),
+    (0x1E054, 'M', 'г'),
+    (0x1E055, 'M', 'д'),
+    (0x1E056, 'M', 'е'),
+    (0x1E057, 'M', 'ж'),
+    (0x1E058, 'M', 'з'),
+    (0x1E059, 'M', 'и'),
+    (0x1E05A, 'M', 'к'),
+    (0x1E05B, 'M', 'л'),
+    (0x1E05C, 'M', 'о'),
+    (0x1E05D, 'M', 'п'),
+    (0x1E05E, 'M', 'с'),
+    (0x1E05F, 'M', 'у'),
+    (0x1E060, 'M', 'ф'),
+    (0x1E061, 'M', 'х'),
+    (0x1E062, 'M', 'ц'),
+    (0x1E063, 'M', 'ч'),
+    (0x1E064, 'M', 'ш'),
+    (0x1E065, 'M', 'ъ'),
+    (0x1E066, 'M', 'ы'),
+    (0x1E067, 'M', 'ґ'),
+    (0x1E068, 'M', 'і'),
+    (0x1E069, 'M', 'ѕ'),
+    (0x1E06A, 'M', 'џ'),
+    (0x1E06B, 'M', 'ҫ'),
+    (0x1E06C, 'M', 'ꙑ'),
+    (0x1E06D, 'M', 'ұ'),
+    (0x1E06E, 'X'),
+    (0x1E08F, 'V'),
+    (0x1E090, 'X'),
+    (0x1E100, 'V'),
+    (0x1E12D, 'X'),
+    (0x1E130, 'V'),
+    (0x1E13E, 'X'),
+    (0x1E140, 'V'),
+    (0x1E14A, 'X'),
+    (0x1E14E, 'V'),
+    (0x1E150, 'X'),
+    (0x1E290, 'V'),
+    (0x1E2AF, 'X'),
+    (0x1E2C0, 'V'),
+    (0x1E2FA, 'X'),
+    (0x1E2FF, 'V'),
+    (0x1E300, 'X'),
+    (0x1E4D0, 'V'),
+    (0x1E4FA, 'X'),
+    (0x1E7E0, 'V'),
+    (0x1E7E7, 'X'),
+    (0x1E7E8, 'V'),
+    (0x1E7EC, 'X'),
+    (0x1E7ED, 'V'),
+    (0x1E7EF, 'X'),
+    (0x1E7F0, 'V'),
+    (0x1E7FF, 'X'),
+    (0x1E800, 'V'),
+    (0x1E8C5, 'X'),
+    (0x1E8C7, 'V'),
+    (0x1E8D7, 'X'),
+    (0x1E900, 'M', '𞤢'),
+    (0x1E901, 'M', '𞤣'),
+    (0x1E902, 'M', '𞤤'),
+    (0x1E903, 'M', '𞤥'),
+    (0x1E904, 'M', '𞤦'),
+    (0x1E905, 'M', '𞤧'),
+    (0x1E906, 'M', '𞤨'),
+    (0x1E907, 'M', '𞤩'),
+    (0x1E908, 'M', '𞤪'),
+    (0x1E909, 'M', '𞤫'),
+    (0x1E90A, 'M', '𞤬'),
+    (0x1E90B, 'M', '𞤭'),
+    (0x1E90C, 'M', '𞤮'),
+    (0x1E90D, 'M', '𞤯'),
+    ]
+
+def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1E90E, 'M', '𞤰'),
+    (0x1E90F, 'M', '𞤱'),
+    (0x1E910, 'M', '𞤲'),
+    (0x1E911, 'M', '𞤳'),
+    (0x1E912, 'M', '𞤴'),
+    (0x1E913, 'M', '𞤵'),
+    (0x1E914, 'M', '𞤶'),
+    (0x1E915, 'M', '𞤷'),
+    (0x1E916, 'M', '𞤸'),
+    (0x1E917, 'M', '𞤹'),
+    (0x1E918, 'M', '𞤺'),
+    (0x1E919, 'M', '𞤻'),
+    (0x1E91A, 'M', '𞤼'),
+    (0x1E91B, 'M', '𞤽'),
+    (0x1E91C, 'M', '𞤾'),
+    (0x1E91D, 'M', '𞤿'),
+    (0x1E91E, 'M', '𞥀'),
+    (0x1E91F, 'M', '𞥁'),
+    (0x1E920, 'M', '𞥂'),
+    (0x1E921, 'M', '𞥃'),
+    (0x1E922, 'V'),
+    (0x1E94C, 'X'),
+    (0x1E950, 'V'),
+    (0x1E95A, 'X'),
+    (0x1E95E, 'V'),
+    (0x1E960, 'X'),
+    (0x1EC71, 'V'),
+    (0x1ECB5, 'X'),
+    (0x1ED01, 'V'),
+    (0x1ED3E, 'X'),
+    (0x1EE00, 'M', 'ا'),
+    (0x1EE01, 'M', 'ب'),
+    (0x1EE02, 'M', 'ج'),
+    (0x1EE03, 'M', 'د'),
+    (0x1EE04, 'X'),
+    (0x1EE05, 'M', 'و'),
+    (0x1EE06, 'M', 'ز'),
+    (0x1EE07, 'M', 'ح'),
+    (0x1EE08, 'M', 'ط'),
+    (0x1EE09, 'M', 'ي'),
+    (0x1EE0A, 'M', 'ك'),
+    (0x1EE0B, 'M', 'ل'),
+    (0x1EE0C, 'M', 'م'),
+    (0x1EE0D, 'M', 'ن'),
+    (0x1EE0E, 'M', 'س'),
+    (0x1EE0F, 'M', 'ع'),
+    (0x1EE10, 'M', 'ف'),
+    (0x1EE11, 'M', 'ص'),
+    (0x1EE12, 'M', 'ق'),
+    (0x1EE13, 'M', 'ر'),
+    (0x1EE14, 'M', 'ش'),
+    (0x1EE15, 'M', 'ت'),
+    (0x1EE16, 'M', 'ث'),
+    (0x1EE17, 'M', 'خ'),
+    (0x1EE18, 'M', 'ذ'),
+    (0x1EE19, 'M', 'ض'),
+    (0x1EE1A, 'M', 'ظ'),
+    (0x1EE1B, 'M', 'غ'),
+    (0x1EE1C, 'M', 'ٮ'),
+    (0x1EE1D, 'M', 'ں'),
+    (0x1EE1E, 'M', 'ڡ'),
+    (0x1EE1F, 'M', 'ٯ'),
+    (0x1EE20, 'X'),
+    (0x1EE21, 'M', 'ب'),
+    (0x1EE22, 'M', 'ج'),
+    (0x1EE23, 'X'),
+    (0x1EE24, 'M', 'ه'),
+    (0x1EE25, 'X'),
+    (0x1EE27, 'M', 'ح'),
+    (0x1EE28, 'X'),
+    (0x1EE29, 'M', 'ي'),
+    (0x1EE2A, 'M', 'ك'),
+    (0x1EE2B, 'M', 'ل'),
+    (0x1EE2C, 'M', 'م'),
+    (0x1EE2D, 'M', 'ن'),
+    (0x1EE2E, 'M', 'س'),
+    (0x1EE2F, 'M', 'ع'),
+    (0x1EE30, 'M', 'ف'),
+    (0x1EE31, 'M', 'ص'),
+    (0x1EE32, 'M', 'ق'),
+    (0x1EE33, 'X'),
+    (0x1EE34, 'M', 'ش'),
+    (0x1EE35, 'M', 'ت'),
+    (0x1EE36, 'M', 'ث'),
+    (0x1EE37, 'M', 'خ'),
+    (0x1EE38, 'X'),
+    (0x1EE39, 'M', 'ض'),
+    (0x1EE3A, 'X'),
+    (0x1EE3B, 'M', 'غ'),
+    (0x1EE3C, 'X'),
+    (0x1EE42, 'M', 'ج'),
+    (0x1EE43, 'X'),
+    (0x1EE47, 'M', 'ح'),
+    (0x1EE48, 'X'),
+    (0x1EE49, 'M', 'ي'),
+    (0x1EE4A, 'X'),
+    (0x1EE4B, 'M', 'ل'),
+    (0x1EE4C, 'X'),
+    (0x1EE4D, 'M', 'ن'),
+    (0x1EE4E, 'M', 'س'),
+    ]
+
+def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1EE4F, 'M', 'ع'),
+    (0x1EE50, 'X'),
+    (0x1EE51, 'M', 'ص'),
+    (0x1EE52, 'M', 'ق'),
+    (0x1EE53, 'X'),
+    (0x1EE54, 'M', 'ش'),
+    (0x1EE55, 'X'),
+    (0x1EE57, 'M', 'خ'),
+    (0x1EE58, 'X'),
+    (0x1EE59, 'M', 'ض'),
+    (0x1EE5A, 'X'),
+    (0x1EE5B, 'M', 'غ'),
+    (0x1EE5C, 'X'),
+    (0x1EE5D, 'M', 'ں'),
+    (0x1EE5E, 'X'),
+    (0x1EE5F, 'M', 'ٯ'),
+    (0x1EE60, 'X'),
+    (0x1EE61, 'M', 'ب'),
+    (0x1EE62, 'M', 'ج'),
+    (0x1EE63, 'X'),
+    (0x1EE64, 'M', 'ه'),
+    (0x1EE65, 'X'),
+    (0x1EE67, 'M', 'ح'),
+    (0x1EE68, 'M', 'ط'),
+    (0x1EE69, 'M', 'ي'),
+    (0x1EE6A, 'M', 'ك'),
+    (0x1EE6B, 'X'),
+    (0x1EE6C, 'M', 'م'),
+    (0x1EE6D, 'M', 'ن'),
+    (0x1EE6E, 'M', 'س'),
+    (0x1EE6F, 'M', 'ع'),
+    (0x1EE70, 'M', 'ف'),
+    (0x1EE71, 'M', 'ص'),
+    (0x1EE72, 'M', 'ق'),
+    (0x1EE73, 'X'),
+    (0x1EE74, 'M', 'ش'),
+    (0x1EE75, 'M', 'ت'),
+    (0x1EE76, 'M', 'ث'),
+    (0x1EE77, 'M', 'خ'),
+    (0x1EE78, 'X'),
+    (0x1EE79, 'M', 'ض'),
+    (0x1EE7A, 'M', 'ظ'),
+    (0x1EE7B, 'M', 'غ'),
+    (0x1EE7C, 'M', 'ٮ'),
+    (0x1EE7D, 'X'),
+    (0x1EE7E, 'M', 'ڡ'),
+    (0x1EE7F, 'X'),
+    (0x1EE80, 'M', 'ا'),
+    (0x1EE81, 'M', 'ب'),
+    (0x1EE82, 'M', 'ج'),
+    (0x1EE83, 'M', 'د'),
+    (0x1EE84, 'M', 'ه'),
+    (0x1EE85, 'M', 'و'),
+    (0x1EE86, 'M', 'ز'),
+    (0x1EE87, 'M', 'ح'),
+    (0x1EE88, 'M', 'ط'),
+    (0x1EE89, 'M', 'ي'),
+    (0x1EE8A, 'X'),
+    (0x1EE8B, 'M', 'ل'),
+    (0x1EE8C, 'M', 'م'),
+    (0x1EE8D, 'M', 'ن'),
+    (0x1EE8E, 'M', 'س'),
+    (0x1EE8F, 'M', 'ع'),
+    (0x1EE90, 'M', 'ف'),
+    (0x1EE91, 'M', 'ص'),
+    (0x1EE92, 'M', 'ق'),
+    (0x1EE93, 'M', 'ر'),
+    (0x1EE94, 'M', 'ش'),
+    (0x1EE95, 'M', 'ت'),
+    (0x1EE96, 'M', 'ث'),
+    (0x1EE97, 'M', 'خ'),
+    (0x1EE98, 'M', 'ذ'),
+    (0x1EE99, 'M', 'ض'),
+    (0x1EE9A, 'M', 'ظ'),
+    (0x1EE9B, 'M', 'غ'),
+    (0x1EE9C, 'X'),
+    (0x1EEA1, 'M', 'ب'),
+    (0x1EEA2, 'M', 'ج'),
+    (0x1EEA3, 'M', 'د'),
+    (0x1EEA4, 'X'),
+    (0x1EEA5, 'M', 'و'),
+    (0x1EEA6, 'M', 'ز'),
+    (0x1EEA7, 'M', 'ح'),
+    (0x1EEA8, 'M', 'ط'),
+    (0x1EEA9, 'M', 'ي'),
+    (0x1EEAA, 'X'),
+    (0x1EEAB, 'M', 'ل'),
+    (0x1EEAC, 'M', 'م'),
+    (0x1EEAD, 'M', 'ن'),
+    (0x1EEAE, 'M', 'س'),
+    (0x1EEAF, 'M', 'ع'),
+    (0x1EEB0, 'M', 'ف'),
+    (0x1EEB1, 'M', 'ص'),
+    (0x1EEB2, 'M', 'ق'),
+    (0x1EEB3, 'M', 'ر'),
+    (0x1EEB4, 'M', 'ش'),
+    (0x1EEB5, 'M', 'ت'),
+    (0x1EEB6, 'M', 'ث'),
+    (0x1EEB7, 'M', 'خ'),
+    (0x1EEB8, 'M', 'ذ'),
+    ]
+
+def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1EEB9, 'M', 'ض'),
+    (0x1EEBA, 'M', 'ظ'),
+    (0x1EEBB, 'M', 'غ'),
+    (0x1EEBC, 'X'),
+    (0x1EEF0, 'V'),
+    (0x1EEF2, 'X'),
+    (0x1F000, 'V'),
+    (0x1F02C, 'X'),
+    (0x1F030, 'V'),
+    (0x1F094, 'X'),
+    (0x1F0A0, 'V'),
+    (0x1F0AF, 'X'),
+    (0x1F0B1, 'V'),
+    (0x1F0C0, 'X'),
+    (0x1F0C1, 'V'),
+    (0x1F0D0, 'X'),
+    (0x1F0D1, 'V'),
+    (0x1F0F6, 'X'),
+    (0x1F101, '3', '0,'),
+    (0x1F102, '3', '1,'),
+    (0x1F103, '3', '2,'),
+    (0x1F104, '3', '3,'),
+    (0x1F105, '3', '4,'),
+    (0x1F106, '3', '5,'),
+    (0x1F107, '3', '6,'),
+    (0x1F108, '3', '7,'),
+    (0x1F109, '3', '8,'),
+    (0x1F10A, '3', '9,'),
+    (0x1F10B, 'V'),
+    (0x1F110, '3', '(a)'),
+    (0x1F111, '3', '(b)'),
+    (0x1F112, '3', '(c)'),
+    (0x1F113, '3', '(d)'),
+    (0x1F114, '3', '(e)'),
+    (0x1F115, '3', '(f)'),
+    (0x1F116, '3', '(g)'),
+    (0x1F117, '3', '(h)'),
+    (0x1F118, '3', '(i)'),
+    (0x1F119, '3', '(j)'),
+    (0x1F11A, '3', '(k)'),
+    (0x1F11B, '3', '(l)'),
+    (0x1F11C, '3', '(m)'),
+    (0x1F11D, '3', '(n)'),
+    (0x1F11E, '3', '(o)'),
+    (0x1F11F, '3', '(p)'),
+    (0x1F120, '3', '(q)'),
+    (0x1F121, '3', '(r)'),
+    (0x1F122, '3', '(s)'),
+    (0x1F123, '3', '(t)'),
+    (0x1F124, '3', '(u)'),
+    (0x1F125, '3', '(v)'),
+    (0x1F126, '3', '(w)'),
+    (0x1F127, '3', '(x)'),
+    (0x1F128, '3', '(y)'),
+    (0x1F129, '3', '(z)'),
+    (0x1F12A, 'M', '〔s〕'),
+    (0x1F12B, 'M', 'c'),
+    (0x1F12C, 'M', 'r'),
+    (0x1F12D, 'M', 'cd'),
+    (0x1F12E, 'M', 'wz'),
+    (0x1F12F, 'V'),
+    (0x1F130, 'M', 'a'),
+    (0x1F131, 'M', 'b'),
+    (0x1F132, 'M', 'c'),
+    (0x1F133, 'M', 'd'),
+    (0x1F134, 'M', 'e'),
+    (0x1F135, 'M', 'f'),
+    (0x1F136, 'M', 'g'),
+    (0x1F137, 'M', 'h'),
+    (0x1F138, 'M', 'i'),
+    (0x1F139, 'M', 'j'),
+    (0x1F13A, 'M', 'k'),
+    (0x1F13B, 'M', 'l'),
+    (0x1F13C, 'M', 'm'),
+    (0x1F13D, 'M', 'n'),
+    (0x1F13E, 'M', 'o'),
+    (0x1F13F, 'M', 'p'),
+    (0x1F140, 'M', 'q'),
+    (0x1F141, 'M', 'r'),
+    (0x1F142, 'M', 's'),
+    (0x1F143, 'M', 't'),
+    (0x1F144, 'M', 'u'),
+    (0x1F145, 'M', 'v'),
+    (0x1F146, 'M', 'w'),
+    (0x1F147, 'M', 'x'),
+    (0x1F148, 'M', 'y'),
+    (0x1F149, 'M', 'z'),
+    (0x1F14A, 'M', 'hv'),
+    (0x1F14B, 'M', 'mv'),
+    (0x1F14C, 'M', 'sd'),
+    (0x1F14D, 'M', 'ss'),
+    (0x1F14E, 'M', 'ppv'),
+    (0x1F14F, 'M', 'wc'),
+    (0x1F150, 'V'),
+    (0x1F16A, 'M', 'mc'),
+    (0x1F16B, 'M', 'md'),
+    (0x1F16C, 'M', 'mr'),
+    (0x1F16D, 'V'),
+    (0x1F190, 'M', 'dj'),
+    (0x1F191, 'V'),
+    ]
+
+def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1F1AE, 'X'),
+    (0x1F1E6, 'V'),
+    (0x1F200, 'M', 'ほか'),
+    (0x1F201, 'M', 'ココ'),
+    (0x1F202, 'M', 'サ'),
+    (0x1F203, 'X'),
+    (0x1F210, 'M', '手'),
+    (0x1F211, 'M', '字'),
+    (0x1F212, 'M', '双'),
+    (0x1F213, 'M', 'デ'),
+    (0x1F214, 'M', '二'),
+    (0x1F215, 'M', '多'),
+    (0x1F216, 'M', '解'),
+    (0x1F217, 'M', '天'),
+    (0x1F218, 'M', '交'),
+    (0x1F219, 'M', '映'),
+    (0x1F21A, 'M', '無'),
+    (0x1F21B, 'M', '料'),
+    (0x1F21C, 'M', '前'),
+    (0x1F21D, 'M', '後'),
+    (0x1F21E, 'M', '再'),
+    (0x1F21F, 'M', '新'),
+    (0x1F220, 'M', '初'),
+    (0x1F221, 'M', '終'),
+    (0x1F222, 'M', '生'),
+    (0x1F223, 'M', '販'),
+    (0x1F224, 'M', '声'),
+    (0x1F225, 'M', '吹'),
+    (0x1F226, 'M', '演'),
+    (0x1F227, 'M', '投'),
+    (0x1F228, 'M', '捕'),
+    (0x1F229, 'M', '一'),
+    (0x1F22A, 'M', '三'),
+    (0x1F22B, 'M', '遊'),
+    (0x1F22C, 'M', '左'),
+    (0x1F22D, 'M', '中'),
+    (0x1F22E, 'M', '右'),
+    (0x1F22F, 'M', '指'),
+    (0x1F230, 'M', '走'),
+    (0x1F231, 'M', '打'),
+    (0x1F232, 'M', '禁'),
+    (0x1F233, 'M', '空'),
+    (0x1F234, 'M', '合'),
+    (0x1F235, 'M', '満'),
+    (0x1F236, 'M', '有'),
+    (0x1F237, 'M', '月'),
+    (0x1F238, 'M', '申'),
+    (0x1F239, 'M', '割'),
+    (0x1F23A, 'M', '営'),
+    (0x1F23B, 'M', '配'),
+    (0x1F23C, 'X'),
+    (0x1F240, 'M', '〔本〕'),
+    (0x1F241, 'M', '〔三〕'),
+    (0x1F242, 'M', '〔二〕'),
+    (0x1F243, 'M', '〔安〕'),
+    (0x1F244, 'M', '〔点〕'),
+    (0x1F245, 'M', '〔打〕'),
+    (0x1F246, 'M', '〔盗〕'),
+    (0x1F247, 'M', '〔勝〕'),
+    (0x1F248, 'M', '〔敗〕'),
+    (0x1F249, 'X'),
+    (0x1F250, 'M', '得'),
+    (0x1F251, 'M', '可'),
+    (0x1F252, 'X'),
+    (0x1F260, 'V'),
+    (0x1F266, 'X'),
+    (0x1F300, 'V'),
+    (0x1F6D8, 'X'),
+    (0x1F6DC, 'V'),
+    (0x1F6ED, 'X'),
+    (0x1F6F0, 'V'),
+    (0x1F6FD, 'X'),
+    (0x1F700, 'V'),
+    (0x1F777, 'X'),
+    (0x1F77B, 'V'),
+    (0x1F7DA, 'X'),
+    (0x1F7E0, 'V'),
+    (0x1F7EC, 'X'),
+    (0x1F7F0, 'V'),
+    (0x1F7F1, 'X'),
+    (0x1F800, 'V'),
+    (0x1F80C, 'X'),
+    (0x1F810, 'V'),
+    (0x1F848, 'X'),
+    (0x1F850, 'V'),
+    (0x1F85A, 'X'),
+    (0x1F860, 'V'),
+    (0x1F888, 'X'),
+    (0x1F890, 'V'),
+    (0x1F8AE, 'X'),
+    (0x1F8B0, 'V'),
+    (0x1F8B2, 'X'),
+    (0x1F900, 'V'),
+    (0x1FA54, 'X'),
+    (0x1FA60, 'V'),
+    (0x1FA6E, 'X'),
+    (0x1FA70, 'V'),
+    (0x1FA7D, 'X'),
+    (0x1FA80, 'V'),
+    (0x1FA89, 'X'),
+    ]
+
+def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1FA90, 'V'),
+    (0x1FABE, 'X'),
+    (0x1FABF, 'V'),
+    (0x1FAC6, 'X'),
+    (0x1FACE, 'V'),
+    (0x1FADC, 'X'),
+    (0x1FAE0, 'V'),
+    (0x1FAE9, 'X'),
+    (0x1FAF0, 'V'),
+    (0x1FAF9, 'X'),
+    (0x1FB00, 'V'),
+    (0x1FB93, 'X'),
+    (0x1FB94, 'V'),
+    (0x1FBCB, 'X'),
+    (0x1FBF0, 'M', '0'),
+    (0x1FBF1, 'M', '1'),
+    (0x1FBF2, 'M', '2'),
+    (0x1FBF3, 'M', '3'),
+    (0x1FBF4, 'M', '4'),
+    (0x1FBF5, 'M', '5'),
+    (0x1FBF6, 'M', '6'),
+    (0x1FBF7, 'M', '7'),
+    (0x1FBF8, 'M', '8'),
+    (0x1FBF9, 'M', '9'),
+    (0x1FBFA, 'X'),
+    (0x20000, 'V'),
+    (0x2A6E0, 'X'),
+    (0x2A700, 'V'),
+    (0x2B73A, 'X'),
+    (0x2B740, 'V'),
+    (0x2B81E, 'X'),
+    (0x2B820, 'V'),
+    (0x2CEA2, 'X'),
+    (0x2CEB0, 'V'),
+    (0x2EBE1, 'X'),
+    (0x2EBF0, 'V'),
+    (0x2EE5E, 'X'),
+    (0x2F800, 'M', '丽'),
+    (0x2F801, 'M', '丸'),
+    (0x2F802, 'M', '乁'),
+    (0x2F803, 'M', '𠄢'),
+    (0x2F804, 'M', '你'),
+    (0x2F805, 'M', '侮'),
+    (0x2F806, 'M', '侻'),
+    (0x2F807, 'M', '倂'),
+    (0x2F808, 'M', '偺'),
+    (0x2F809, 'M', '備'),
+    (0x2F80A, 'M', '僧'),
+    (0x2F80B, 'M', '像'),
+    (0x2F80C, 'M', '㒞'),
+    (0x2F80D, 'M', '𠘺'),
+    (0x2F80E, 'M', '免'),
+    (0x2F80F, 'M', '兔'),
+    (0x2F810, 'M', '兤'),
+    (0x2F811, 'M', '具'),
+    (0x2F812, 'M', '𠔜'),
+    (0x2F813, 'M', '㒹'),
+    (0x2F814, 'M', '內'),
+    (0x2F815, 'M', '再'),
+    (0x2F816, 'M', '𠕋'),
+    (0x2F817, 'M', '冗'),
+    (0x2F818, 'M', '冤'),
+    (0x2F819, 'M', '仌'),
+    (0x2F81A, 'M', '冬'),
+    (0x2F81B, 'M', '况'),
+    (0x2F81C, 'M', '𩇟'),
+    (0x2F81D, 'M', '凵'),
+    (0x2F81E, 'M', '刃'),
+    (0x2F81F, 'M', '㓟'),
+    (0x2F820, 'M', '刻'),
+    (0x2F821, 'M', '剆'),
+    (0x2F822, 'M', '割'),
+    (0x2F823, 'M', '剷'),
+    (0x2F824, 'M', '㔕'),
+    (0x2F825, 'M', '勇'),
+    (0x2F826, 'M', '勉'),
+    (0x2F827, 'M', '勤'),
+    (0x2F828, 'M', '勺'),
+    (0x2F829, 'M', '包'),
+    (0x2F82A, 'M', '匆'),
+    (0x2F82B, 'M', '北'),
+    (0x2F82C, 'M', '卉'),
+    (0x2F82D, 'M', '卑'),
+    (0x2F82E, 'M', '博'),
+    (0x2F82F, 'M', '即'),
+    (0x2F830, 'M', '卽'),
+    (0x2F831, 'M', '卿'),
+    (0x2F834, 'M', '𠨬'),
+    (0x2F835, 'M', '灰'),
+    (0x2F836, 'M', '及'),
+    (0x2F837, 'M', '叟'),
+    (0x2F838, 'M', '𠭣'),
+    (0x2F839, 'M', '叫'),
+    (0x2F83A, 'M', '叱'),
+    (0x2F83B, 'M', '吆'),
+    (0x2F83C, 'M', '咞'),
+    (0x2F83D, 'M', '吸'),
+    (0x2F83E, 'M', '呈'),
+    (0x2F83F, 'M', '周'),
+    (0x2F840, 'M', '咢'),
+    ]
+
+def _seg_77() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x2F841, 'M', '哶'),
+    (0x2F842, 'M', '唐'),
+    (0x2F843, 'M', '啓'),
+    (0x2F844, 'M', '啣'),
+    (0x2F845, 'M', '善'),
+    (0x2F847, 'M', '喙'),
+    (0x2F848, 'M', '喫'),
+    (0x2F849, 'M', '喳'),
+    (0x2F84A, 'M', '嗂'),
+    (0x2F84B, 'M', '圖'),
+    (0x2F84C, 'M', '嘆'),
+    (0x2F84D, 'M', '圗'),
+    (0x2F84E, 'M', '噑'),
+    (0x2F84F, 'M', '噴'),
+    (0x2F850, 'M', '切'),
+    (0x2F851, 'M', '壮'),
+    (0x2F852, 'M', '城'),
+    (0x2F853, 'M', '埴'),
+    (0x2F854, 'M', '堍'),
+    (0x2F855, 'M', '型'),
+    (0x2F856, 'M', '堲'),
+    (0x2F857, 'M', '報'),
+    (0x2F858, 'M', '墬'),
+    (0x2F859, 'M', '𡓤'),
+    (0x2F85A, 'M', '売'),
+    (0x2F85B, 'M', '壷'),
+    (0x2F85C, 'M', '夆'),
+    (0x2F85D, 'M', '多'),
+    (0x2F85E, 'M', '夢'),
+    (0x2F85F, 'M', '奢'),
+    (0x2F860, 'M', '𡚨'),
+    (0x2F861, 'M', '𡛪'),
+    (0x2F862, 'M', '姬'),
+    (0x2F863, 'M', '娛'),
+    (0x2F864, 'M', '娧'),
+    (0x2F865, 'M', '姘'),
+    (0x2F866, 'M', '婦'),
+    (0x2F867, 'M', '㛮'),
+    (0x2F868, 'X'),
+    (0x2F869, 'M', '嬈'),
+    (0x2F86A, 'M', '嬾'),
+    (0x2F86C, 'M', '𡧈'),
+    (0x2F86D, 'M', '寃'),
+    (0x2F86E, 'M', '寘'),
+    (0x2F86F, 'M', '寧'),
+    (0x2F870, 'M', '寳'),
+    (0x2F871, 'M', '𡬘'),
+    (0x2F872, 'M', '寿'),
+    (0x2F873, 'M', '将'),
+    (0x2F874, 'X'),
+    (0x2F875, 'M', '尢'),
+    (0x2F876, 'M', '㞁'),
+    (0x2F877, 'M', '屠'),
+    (0x2F878, 'M', '屮'),
+    (0x2F879, 'M', '峀'),
+    (0x2F87A, 'M', '岍'),
+    (0x2F87B, 'M', '𡷤'),
+    (0x2F87C, 'M', '嵃'),
+    (0x2F87D, 'M', '𡷦'),
+    (0x2F87E, 'M', '嵮'),
+    (0x2F87F, 'M', '嵫'),
+    (0x2F880, 'M', '嵼'),
+    (0x2F881, 'M', '巡'),
+    (0x2F882, 'M', '巢'),
+    (0x2F883, 'M', '㠯'),
+    (0x2F884, 'M', '巽'),
+    (0x2F885, 'M', '帨'),
+    (0x2F886, 'M', '帽'),
+    (0x2F887, 'M', '幩'),
+    (0x2F888, 'M', '㡢'),
+    (0x2F889, 'M', '𢆃'),
+    (0x2F88A, 'M', '㡼'),
+    (0x2F88B, 'M', '庰'),
+    (0x2F88C, 'M', '庳'),
+    (0x2F88D, 'M', '庶'),
+    (0x2F88E, 'M', '廊'),
+    (0x2F88F, 'M', '𪎒'),
+    (0x2F890, 'M', '廾'),
+    (0x2F891, 'M', '𢌱'),
+    (0x2F893, 'M', '舁'),
+    (0x2F894, 'M', '弢'),
+    (0x2F896, 'M', '㣇'),
+    (0x2F897, 'M', '𣊸'),
+    (0x2F898, 'M', '𦇚'),
+    (0x2F899, 'M', '形'),
+    (0x2F89A, 'M', '彫'),
+    (0x2F89B, 'M', '㣣'),
+    (0x2F89C, 'M', '徚'),
+    (0x2F89D, 'M', '忍'),
+    (0x2F89E, 'M', '志'),
+    (0x2F89F, 'M', '忹'),
+    (0x2F8A0, 'M', '悁'),
+    (0x2F8A1, 'M', '㤺'),
+    (0x2F8A2, 'M', '㤜'),
+    (0x2F8A3, 'M', '悔'),
+    (0x2F8A4, 'M', '𢛔'),
+    (0x2F8A5, 'M', '惇'),
+    (0x2F8A6, 'M', '慈'),
+    (0x2F8A7, 'M', '慌'),
+    (0x2F8A8, 'M', '慎'),
+    ]
+
+def _seg_78() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x2F8A9, 'M', '慌'),
+    (0x2F8AA, 'M', '慺'),
+    (0x2F8AB, 'M', '憎'),
+    (0x2F8AC, 'M', '憲'),
+    (0x2F8AD, 'M', '憤'),
+    (0x2F8AE, 'M', '憯'),
+    (0x2F8AF, 'M', '懞'),
+    (0x2F8B0, 'M', '懲'),
+    (0x2F8B1, 'M', '懶'),
+    (0x2F8B2, 'M', '成'),
+    (0x2F8B3, 'M', '戛'),
+    (0x2F8B4, 'M', '扝'),
+    (0x2F8B5, 'M', '抱'),
+    (0x2F8B6, 'M', '拔'),
+    (0x2F8B7, 'M', '捐'),
+    (0x2F8B8, 'M', '𢬌'),
+    (0x2F8B9, 'M', '挽'),
+    (0x2F8BA, 'M', '拼'),
+    (0x2F8BB, 'M', '捨'),
+    (0x2F8BC, 'M', '掃'),
+    (0x2F8BD, 'M', '揤'),
+    (0x2F8BE, 'M', '𢯱'),
+    (0x2F8BF, 'M', '搢'),
+    (0x2F8C0, 'M', '揅'),
+    (0x2F8C1, 'M', '掩'),
+    (0x2F8C2, 'M', '㨮'),
+    (0x2F8C3, 'M', '摩'),
+    (0x2F8C4, 'M', '摾'),
+    (0x2F8C5, 'M', '撝'),
+    (0x2F8C6, 'M', '摷'),
+    (0x2F8C7, 'M', '㩬'),
+    (0x2F8C8, 'M', '敏'),
+    (0x2F8C9, 'M', '敬'),
+    (0x2F8CA, 'M', '𣀊'),
+    (0x2F8CB, 'M', '旣'),
+    (0x2F8CC, 'M', '書'),
+    (0x2F8CD, 'M', '晉'),
+    (0x2F8CE, 'M', '㬙'),
+    (0x2F8CF, 'M', '暑'),
+    (0x2F8D0, 'M', '㬈'),
+    (0x2F8D1, 'M', '㫤'),
+    (0x2F8D2, 'M', '冒'),
+    (0x2F8D3, 'M', '冕'),
+    (0x2F8D4, 'M', '最'),
+    (0x2F8D5, 'M', '暜'),
+    (0x2F8D6, 'M', '肭'),
+    (0x2F8D7, 'M', '䏙'),
+    (0x2F8D8, 'M', '朗'),
+    (0x2F8D9, 'M', '望'),
+    (0x2F8DA, 'M', '朡'),
+    (0x2F8DB, 'M', '杞'),
+    (0x2F8DC, 'M', '杓'),
+    (0x2F8DD, 'M', '𣏃'),
+    (0x2F8DE, 'M', '㭉'),
+    (0x2F8DF, 'M', '柺'),
+    (0x2F8E0, 'M', '枅'),
+    (0x2F8E1, 'M', '桒'),
+    (0x2F8E2, 'M', '梅'),
+    (0x2F8E3, 'M', '𣑭'),
+    (0x2F8E4, 'M', '梎'),
+    (0x2F8E5, 'M', '栟'),
+    (0x2F8E6, 'M', '椔'),
+    (0x2F8E7, 'M', '㮝'),
+    (0x2F8E8, 'M', '楂'),
+    (0x2F8E9, 'M', '榣'),
+    (0x2F8EA, 'M', '槪'),
+    (0x2F8EB, 'M', '檨'),
+    (0x2F8EC, 'M', '𣚣'),
+    (0x2F8ED, 'M', '櫛'),
+    (0x2F8EE, 'M', '㰘'),
+    (0x2F8EF, 'M', '次'),
+    (0x2F8F0, 'M', '𣢧'),
+    (0x2F8F1, 'M', '歔'),
+    (0x2F8F2, 'M', '㱎'),
+    (0x2F8F3, 'M', '歲'),
+    (0x2F8F4, 'M', '殟'),
+    (0x2F8F5, 'M', '殺'),
+    (0x2F8F6, 'M', '殻'),
+    (0x2F8F7, 'M', '𣪍'),
+    (0x2F8F8, 'M', '𡴋'),
+    (0x2F8F9, 'M', '𣫺'),
+    (0x2F8FA, 'M', '汎'),
+    (0x2F8FB, 'M', '𣲼'),
+    (0x2F8FC, 'M', '沿'),
+    (0x2F8FD, 'M', '泍'),
+    (0x2F8FE, 'M', '汧'),
+    (0x2F8FF, 'M', '洖'),
+    (0x2F900, 'M', '派'),
+    (0x2F901, 'M', '海'),
+    (0x2F902, 'M', '流'),
+    (0x2F903, 'M', '浩'),
+    (0x2F904, 'M', '浸'),
+    (0x2F905, 'M', '涅'),
+    (0x2F906, 'M', '𣴞'),
+    (0x2F907, 'M', '洴'),
+    (0x2F908, 'M', '港'),
+    (0x2F909, 'M', '湮'),
+    (0x2F90A, 'M', '㴳'),
+    (0x2F90B, 'M', '滋'),
+    (0x2F90C, 'M', '滇'),
+    ]
+
+def _seg_79() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x2F90D, 'M', '𣻑'),
+    (0x2F90E, 'M', '淹'),
+    (0x2F90F, 'M', '潮'),
+    (0x2F910, 'M', '𣽞'),
+    (0x2F911, 'M', '𣾎'),
+    (0x2F912, 'M', '濆'),
+    (0x2F913, 'M', '瀹'),
+    (0x2F914, 'M', '瀞'),
+    (0x2F915, 'M', '瀛'),
+    (0x2F916, 'M', '㶖'),
+    (0x2F917, 'M', '灊'),
+    (0x2F918, 'M', '災'),
+    (0x2F919, 'M', '灷'),
+    (0x2F91A, 'M', '炭'),
+    (0x2F91B, 'M', '𠔥'),
+    (0x2F91C, 'M', '煅'),
+    (0x2F91D, 'M', '𤉣'),
+    (0x2F91E, 'M', '熜'),
+    (0x2F91F, 'X'),
+    (0x2F920, 'M', '爨'),
+    (0x2F921, 'M', '爵'),
+    (0x2F922, 'M', '牐'),
+    (0x2F923, 'M', '𤘈'),
+    (0x2F924, 'M', '犀'),
+    (0x2F925, 'M', '犕'),
+    (0x2F926, 'M', '𤜵'),
+    (0x2F927, 'M', '𤠔'),
+    (0x2F928, 'M', '獺'),
+    (0x2F929, 'M', '王'),
+    (0x2F92A, 'M', '㺬'),
+    (0x2F92B, 'M', '玥'),
+    (0x2F92C, 'M', '㺸'),
+    (0x2F92E, 'M', '瑇'),
+    (0x2F92F, 'M', '瑜'),
+    (0x2F930, 'M', '瑱'),
+    (0x2F931, 'M', '璅'),
+    (0x2F932, 'M', '瓊'),
+    (0x2F933, 'M', '㼛'),
+    (0x2F934, 'M', '甤'),
+    (0x2F935, 'M', '𤰶'),
+    (0x2F936, 'M', '甾'),
+    (0x2F937, 'M', '𤲒'),
+    (0x2F938, 'M', '異'),
+    (0x2F939, 'M', '𢆟'),
+    (0x2F93A, 'M', '瘐'),
+    (0x2F93B, 'M', '𤾡'),
+    (0x2F93C, 'M', '𤾸'),
+    (0x2F93D, 'M', '𥁄'),
+    (0x2F93E, 'M', '㿼'),
+    (0x2F93F, 'M', '䀈'),
+    (0x2F940, 'M', '直'),
+    (0x2F941, 'M', '𥃳'),
+    (0x2F942, 'M', '𥃲'),
+    (0x2F943, 'M', '𥄙'),
+    (0x2F944, 'M', '𥄳'),
+    (0x2F945, 'M', '眞'),
+    (0x2F946, 'M', '真'),
+    (0x2F948, 'M', '睊'),
+    (0x2F949, 'M', '䀹'),
+    (0x2F94A, 'M', '瞋'),
+    (0x2F94B, 'M', '䁆'),
+    (0x2F94C, 'M', '䂖'),
+    (0x2F94D, 'M', '𥐝'),
+    (0x2F94E, 'M', '硎'),
+    (0x2F94F, 'M', '碌'),
+    (0x2F950, 'M', '磌'),
+    (0x2F951, 'M', '䃣'),
+    (0x2F952, 'M', '𥘦'),
+    (0x2F953, 'M', '祖'),
+    (0x2F954, 'M', '𥚚'),
+    (0x2F955, 'M', '𥛅'),
+    (0x2F956, 'M', '福'),
+    (0x2F957, 'M', '秫'),
+    (0x2F958, 'M', '䄯'),
+    (0x2F959, 'M', '穀'),
+    (0x2F95A, 'M', '穊'),
+    (0x2F95B, 'M', '穏'),
+    (0x2F95C, 'M', '𥥼'),
+    (0x2F95D, 'M', '𥪧'),
+    (0x2F95F, 'X'),
+    (0x2F960, 'M', '䈂'),
+    (0x2F961, 'M', '𥮫'),
+    (0x2F962, 'M', '篆'),
+    (0x2F963, 'M', '築'),
+    (0x2F964, 'M', '䈧'),
+    (0x2F965, 'M', '𥲀'),
+    (0x2F966, 'M', '糒'),
+    (0x2F967, 'M', '䊠'),
+    (0x2F968, 'M', '糨'),
+    (0x2F969, 'M', '糣'),
+    (0x2F96A, 'M', '紀'),
+    (0x2F96B, 'M', '𥾆'),
+    (0x2F96C, 'M', '絣'),
+    (0x2F96D, 'M', '䌁'),
+    (0x2F96E, 'M', '緇'),
+    (0x2F96F, 'M', '縂'),
+    (0x2F970, 'M', '繅'),
+    (0x2F971, 'M', '䌴'),
+    (0x2F972, 'M', '𦈨'),
+    (0x2F973, 'M', '𦉇'),
+    ]
+
+def _seg_80() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x2F974, 'M', '䍙'),
+    (0x2F975, 'M', '𦋙'),
+    (0x2F976, 'M', '罺'),
+    (0x2F977, 'M', '𦌾'),
+    (0x2F978, 'M', '羕'),
+    (0x2F979, 'M', '翺'),
+    (0x2F97A, 'M', '者'),
+    (0x2F97B, 'M', '𦓚'),
+    (0x2F97C, 'M', '𦔣'),
+    (0x2F97D, 'M', '聠'),
+    (0x2F97E, 'M', '𦖨'),
+    (0x2F97F, 'M', '聰'),
+    (0x2F980, 'M', '𣍟'),
+    (0x2F981, 'M', '䏕'),
+    (0x2F982, 'M', '育'),
+    (0x2F983, 'M', '脃'),
+    (0x2F984, 'M', '䐋'),
+    (0x2F985, 'M', '脾'),
+    (0x2F986, 'M', '媵'),
+    (0x2F987, 'M', '𦞧'),
+    (0x2F988, 'M', '𦞵'),
+    (0x2F989, 'M', '𣎓'),
+    (0x2F98A, 'M', '𣎜'),
+    (0x2F98B, 'M', '舁'),
+    (0x2F98C, 'M', '舄'),
+    (0x2F98D, 'M', '辞'),
+    (0x2F98E, 'M', '䑫'),
+    (0x2F98F, 'M', '芑'),
+    (0x2F990, 'M', '芋'),
+    (0x2F991, 'M', '芝'),
+    (0x2F992, 'M', '劳'),
+    (0x2F993, 'M', '花'),
+    (0x2F994, 'M', '芳'),
+    (0x2F995, 'M', '芽'),
+    (0x2F996, 'M', '苦'),
+    (0x2F997, 'M', '𦬼'),
+    (0x2F998, 'M', '若'),
+    (0x2F999, 'M', '茝'),
+    (0x2F99A, 'M', '荣'),
+    (0x2F99B, 'M', '莭'),
+    (0x2F99C, 'M', '茣'),
+    (0x2F99D, 'M', '莽'),
+    (0x2F99E, 'M', '菧'),
+    (0x2F99F, 'M', '著'),
+    (0x2F9A0, 'M', '荓'),
+    (0x2F9A1, 'M', '菊'),
+    (0x2F9A2, 'M', '菌'),
+    (0x2F9A3, 'M', '菜'),
+    (0x2F9A4, 'M', '𦰶'),
+    (0x2F9A5, 'M', '𦵫'),
+    (0x2F9A6, 'M', '𦳕'),
+    (0x2F9A7, 'M', '䔫'),
+    (0x2F9A8, 'M', '蓱'),
+    (0x2F9A9, 'M', '蓳'),
+    (0x2F9AA, 'M', '蔖'),
+    (0x2F9AB, 'M', '𧏊'),
+    (0x2F9AC, 'M', '蕤'),
+    (0x2F9AD, 'M', '𦼬'),
+    (0x2F9AE, 'M', '䕝'),
+    (0x2F9AF, 'M', '䕡'),
+    (0x2F9B0, 'M', '𦾱'),
+    (0x2F9B1, 'M', '𧃒'),
+    (0x2F9B2, 'M', '䕫'),
+    (0x2F9B3, 'M', '虐'),
+    (0x2F9B4, 'M', '虜'),
+    (0x2F9B5, 'M', '虧'),
+    (0x2F9B6, 'M', '虩'),
+    (0x2F9B7, 'M', '蚩'),
+    (0x2F9B8, 'M', '蚈'),
+    (0x2F9B9, 'M', '蜎'),
+    (0x2F9BA, 'M', '蛢'),
+    (0x2F9BB, 'M', '蝹'),
+    (0x2F9BC, 'M', '蜨'),
+    (0x2F9BD, 'M', '蝫'),
+    (0x2F9BE, 'M', '螆'),
+    (0x2F9BF, 'X'),
+    (0x2F9C0, 'M', '蟡'),
+    (0x2F9C1, 'M', '蠁'),
+    (0x2F9C2, 'M', '䗹'),
+    (0x2F9C3, 'M', '衠'),
+    (0x2F9C4, 'M', '衣'),
+    (0x2F9C5, 'M', '𧙧'),
+    (0x2F9C6, 'M', '裗'),
+    (0x2F9C7, 'M', '裞'),
+    (0x2F9C8, 'M', '䘵'),
+    (0x2F9C9, 'M', '裺'),
+    (0x2F9CA, 'M', '㒻'),
+    (0x2F9CB, 'M', '𧢮'),
+    (0x2F9CC, 'M', '𧥦'),
+    (0x2F9CD, 'M', '䚾'),
+    (0x2F9CE, 'M', '䛇'),
+    (0x2F9CF, 'M', '誠'),
+    (0x2F9D0, 'M', '諭'),
+    (0x2F9D1, 'M', '變'),
+    (0x2F9D2, 'M', '豕'),
+    (0x2F9D3, 'M', '𧲨'),
+    (0x2F9D4, 'M', '貫'),
+    (0x2F9D5, 'M', '賁'),
+    (0x2F9D6, 'M', '贛'),
+    (0x2F9D7, 'M', '起'),
+    ]
+
+def _seg_81() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x2F9D8, 'M', '𧼯'),
+    (0x2F9D9, 'M', '𠠄'),
+    (0x2F9DA, 'M', '跋'),
+    (0x2F9DB, 'M', '趼'),
+    (0x2F9DC, 'M', '跰'),
+    (0x2F9DD, 'M', '𠣞'),
+    (0x2F9DE, 'M', '軔'),
+    (0x2F9DF, 'M', '輸'),
+    (0x2F9E0, 'M', '𨗒'),
+    (0x2F9E1, 'M', '𨗭'),
+    (0x2F9E2, 'M', '邔'),
+    (0x2F9E3, 'M', '郱'),
+    (0x2F9E4, 'M', '鄑'),
+    (0x2F9E5, 'M', '𨜮'),
+    (0x2F9E6, 'M', '鄛'),
+    (0x2F9E7, 'M', '鈸'),
+    (0x2F9E8, 'M', '鋗'),
+    (0x2F9E9, 'M', '鋘'),
+    (0x2F9EA, 'M', '鉼'),
+    (0x2F9EB, 'M', '鏹'),
+    (0x2F9EC, 'M', '鐕'),
+    (0x2F9ED, 'M', '𨯺'),
+    (0x2F9EE, 'M', '開'),
+    (0x2F9EF, 'M', '䦕'),
+    (0x2F9F0, 'M', '閷'),
+    (0x2F9F1, 'M', '𨵷'),
+    (0x2F9F2, 'M', '䧦'),
+    (0x2F9F3, 'M', '雃'),
+    (0x2F9F4, 'M', '嶲'),
+    (0x2F9F5, 'M', '霣'),
+    (0x2F9F6, 'M', '𩅅'),
+    (0x2F9F7, 'M', '𩈚'),
+    (0x2F9F8, 'M', '䩮'),
+    (0x2F9F9, 'M', '䩶'),
+    (0x2F9FA, 'M', '韠'),
+    (0x2F9FB, 'M', '𩐊'),
+    (0x2F9FC, 'M', '䪲'),
+    (0x2F9FD, 'M', '𩒖'),
+    (0x2F9FE, 'M', '頋'),
+    (0x2FA00, 'M', '頩'),
+    (0x2FA01, 'M', '𩖶'),
+    (0x2FA02, 'M', '飢'),
+    (0x2FA03, 'M', '䬳'),
+    (0x2FA04, 'M', '餩'),
+    (0x2FA05, 'M', '馧'),
+    (0x2FA06, 'M', '駂'),
+    (0x2FA07, 'M', '駾'),
+    (0x2FA08, 'M', '䯎'),
+    (0x2FA09, 'M', '𩬰'),
+    (0x2FA0A, 'M', '鬒'),
+    (0x2FA0B, 'M', '鱀'),
+    (0x2FA0C, 'M', '鳽'),
+    (0x2FA0D, 'M', '䳎'),
+    (0x2FA0E, 'M', '䳭'),
+    (0x2FA0F, 'M', '鵧'),
+    (0x2FA10, 'M', '𪃎'),
+    (0x2FA11, 'M', '䳸'),
+    (0x2FA12, 'M', '𪄅'),
+    (0x2FA13, 'M', '𪈎'),
+    (0x2FA14, 'M', '𪊑'),
+    (0x2FA15, 'M', '麻'),
+    (0x2FA16, 'M', '䵖'),
+    (0x2FA17, 'M', '黹'),
+    (0x2FA18, 'M', '黾'),
+    (0x2FA19, 'M', '鼅'),
+    (0x2FA1A, 'M', '鼏'),
+    (0x2FA1B, 'M', '鼖'),
+    (0x2FA1C, 'M', '鼻'),
+    (0x2FA1D, 'M', '𪘀'),
+    (0x2FA1E, 'X'),
+    (0x30000, 'V'),
+    (0x3134B, 'X'),
+    (0x31350, 'V'),
+    (0x323B0, 'X'),
+    (0xE0100, 'I'),
+    (0xE01F0, 'X'),
+    ]
+
+uts46data = tuple(
+    _seg_0()
+    + _seg_1()
+    + _seg_2()
+    + _seg_3()
+    + _seg_4()
+    + _seg_5()
+    + _seg_6()
+    + _seg_7()
+    + _seg_8()
+    + _seg_9()
+    + _seg_10()
+    + _seg_11()
+    + _seg_12()
+    + _seg_13()
+    + _seg_14()
+    + _seg_15()
+    + _seg_16()
+    + _seg_17()
+    + _seg_18()
+    + _seg_19()
+    + _seg_20()
+    + _seg_21()
+    + _seg_22()
+    + _seg_23()
+    + _seg_24()
+    + _seg_25()
+    + _seg_26()
+    + _seg_27()
+    + _seg_28()
+    + _seg_29()
+    + _seg_30()
+    + _seg_31()
+    + _seg_32()
+    + _seg_33()
+    + _seg_34()
+    + _seg_35()
+    + _seg_36()
+    + _seg_37()
+    + _seg_38()
+    + _seg_39()
+    + _seg_40()
+    + _seg_41()
+    + _seg_42()
+    + _seg_43()
+    + _seg_44()
+    + _seg_45()
+    + _seg_46()
+    + _seg_47()
+    + _seg_48()
+    + _seg_49()
+    + _seg_50()
+    + _seg_51()
+    + _seg_52()
+    + _seg_53()
+    + _seg_54()
+    + _seg_55()
+    + _seg_56()
+    + _seg_57()
+    + _seg_58()
+    + _seg_59()
+    + _seg_60()
+    + _seg_61()
+    + _seg_62()
+    + _seg_63()
+    + _seg_64()
+    + _seg_65()
+    + _seg_66()
+    + _seg_67()
+    + _seg_68()
+    + _seg_69()
+    + _seg_70()
+    + _seg_71()
+    + _seg_72()
+    + _seg_73()
+    + _seg_74()
+    + _seg_75()
+    + _seg_76()
+    + _seg_77()
+    + _seg_78()
+    + _seg_79()
+    + _seg_80()
+    + _seg_81()
+)  # type: Tuple[Union[Tuple[int, str], Tuple[int, str, str]], ...]
diff --git a/llm/Lib/site-packages/isympy.py b/llm/Lib/site-packages/isympy.py
new file mode 100644
index 0000000000000000000000000000000000000000..50e9bc78d08904b8c177105ee90d984ea4b01d20
--- /dev/null
+++ b/llm/Lib/site-packages/isympy.py
@@ -0,0 +1,342 @@
+"""
+Python shell for SymPy.
+
+This is just a normal Python shell (IPython shell if you have the
+IPython package installed), that executes the following commands for
+the user:
+
+    >>> from __future__ import division
+    >>> from sympy import *
+    >>> x, y, z, t = symbols('x y z t')
+    >>> k, m, n = symbols('k m n', integer=True)
+    >>> f, g, h = symbols('f g h', cls=Function)
+    >>> init_printing()
+
+So starting 'isympy' is equivalent to starting Python (or IPython) and
+executing the above commands by hand.  It is intended for easy and quick
+experimentation with SymPy.  isympy is a good way to use SymPy as an
+interactive calculator. If you have IPython and Matplotlib installed, then
+interactive plotting is enabled by default.
+
+COMMAND LINE OPTIONS
+--------------------
+
+-c CONSOLE, --console=CONSOLE
+
+     Use the specified shell (Python or IPython) shell as the console
+     backend instead of the default one (IPython if present, Python
+     otherwise), e.g.:
+
+        $isympy -c python
+
+    CONSOLE must be one of 'ipython' or 'python'
+
+-p PRETTY, --pretty PRETTY
+
+    Setup pretty-printing in SymPy. When pretty-printing is enabled,
+    expressions can be printed with Unicode or ASCII. The default is
+    to use pretty-printing (with Unicode if the terminal supports it).
+    When this option is 'no', expressions will not be pretty-printed
+    and ASCII will be used:
+
+        $isympy -p no
+
+    PRETTY must be one of 'unicode', 'ascii', or 'no'
+
+-t TYPES, --types=TYPES
+
+    Setup the ground types for the polys.  By default, gmpy ground types
+    are used if gmpy2 or gmpy is installed, otherwise it falls back to python
+    ground types, which are a little bit slower.  You can manually
+    choose python ground types even if gmpy is installed (e.g., for
+    testing purposes):
+
+        $isympy -t python
+
+    TYPES must be one of 'gmpy', 'gmpy1' or 'python'
+
+    Note that the ground type gmpy1 is primarily intended for testing; it
+    forces the use of gmpy version 1 even if gmpy2 is available.
+
+    This is the same as setting the environment variable
+    SYMPY_GROUND_TYPES to the given ground type (e.g.,
+    SYMPY_GROUND_TYPES='gmpy')
+
+    The ground types can be determined interactively from the variable
+    sympy.polys.domains.GROUND_TYPES.
+
+-o ORDER, --order ORDER
+
+    Setup the ordering of terms for printing.  The default is lex, which
+    orders terms lexicographically (e.g., x**2 + x + 1). You can choose
+    other orderings, such as rev-lex, which will use reverse
+    lexicographic ordering (e.g., 1 + x + x**2):
+
+        $isympy -o rev-lex
+
+    ORDER must be one of 'lex', 'rev-lex', 'grlex', 'rev-grlex',
+    'grevlex', 'rev-grevlex', 'old', or 'none'.
+
+    Note that for very large expressions, ORDER='none' may speed up
+    printing considerably but the terms will have no canonical order.
+
+-q, --quiet
+
+    Print only Python's and SymPy's versions to stdout at startup.
+
+-d, --doctest
+
+    Use the same format that should be used for doctests.  This is
+    equivalent to -c python -p no.
+
+-C, --no-cache
+
+    Disable the caching mechanism.  Disabling the cache may slow certain
+    operations down considerably.  This is useful for testing the cache,
+    or for benchmarking, as the cache can result in deceptive timings.
+
+    This is equivalent to setting the environment variable
+    SYMPY_USE_CACHE to 'no'.
+
+-a, --auto-symbols (requires at least IPython 0.11)
+
+    Automatically create missing symbols.  Normally, typing a name of a
+    Symbol that has not been instantiated first would raise NameError,
+    but with this option enabled, any undefined name will be
+    automatically created as a Symbol.
+
+    Note that this is intended only for interactive, calculator style
+    usage. In a script that uses SymPy, Symbols should be instantiated
+    at the top, so that it's clear what they are.
+
+    This will not override any names that are already defined, which
+    includes the single character letters represented by the mnemonic
+    QCOSINE (see the "Gotchas and Pitfalls" document in the
+    documentation). You can delete existing names by executing "del
+    name".  If a name is defined, typing "'name' in dir()" will return True.
+
+    The Symbols that are created using this have default assumptions.
+    If you want to place assumptions on symbols, you should create them
+    using symbols() or var().
+
+    Finally, this only works in the top level namespace. So, for
+    example, if you define a function in isympy with an undefined
+    Symbol, it will not work.
+
+    See also the -i and -I options.
+
+-i, --int-to-Integer (requires at least IPython 0.11)
+
+    Automatically wrap int literals with Integer.  This makes it so that
+    things like 1/2 will come out as Rational(1, 2), rather than 0.5.  This
+    works by preprocessing the source and wrapping all int literals with
+    Integer.  Note that this will not change the behavior of int literals
+    assigned to variables, and it also won't change the behavior of functions
+    that return int literals.
+
+    If you want an int, you can wrap the literal in int(), e.g. int(3)/int(2)
+    gives 1.5 (with division imported from __future__).
+
+-I, --interactive (requires at least IPython 0.11)
+
+    This is equivalent to --auto-symbols --int-to-Integer.  Future options
+    designed for ease of interactive use may be added to this.
+
+-D, --debug
+
+    Enable debugging output.  This is the same as setting the
+    environment variable SYMPY_DEBUG to 'True'.  The debug status is set
+    in the variable SYMPY_DEBUG within isympy.
+
+-- IPython options
+
+    Additionally you can pass command line options directly to the IPython
+    interpreter (the standard Python shell is not supported).  However you
+    need to add the '--' separator between two types of options, e.g the
+    startup banner option and the colors option. You need to enter the
+    options as required by the version of IPython that you are using, too:
+
+    in IPython 0.11,
+
+        $isympy -q -- --colors=NoColor
+
+    or older versions of IPython,
+
+        $isympy -q -- -colors NoColor
+
+See also isympy --help.
+"""
+
+import os
+import sys
+
+# DO NOT IMPORT SYMPY HERE! Or the setting of the sympy environment variables
+# by the command line will break.
+
+def main() -> None:
+    from argparse import ArgumentParser, RawDescriptionHelpFormatter
+
+    VERSION = None
+    if '--version' in sys.argv:
+        # We cannot import sympy before this is run, because flags like -C and
+        # -t set environment variables that must be set before SymPy is
+        # imported. The only thing we need to import it for is to get the
+        # version, which only matters with the --version flag.
+        import sympy
+        VERSION = sympy.__version__
+
+    usage = 'isympy [options] -- [ipython options]'
+    parser = ArgumentParser(
+        usage=usage,
+        description=__doc__,
+        formatter_class=RawDescriptionHelpFormatter,
+    )
+
+    parser.add_argument('--version', action='version', version=VERSION)
+
+    parser.add_argument(
+        '-c', '--console',
+        dest='console',
+        action='store',
+        default=None,
+        choices=['ipython', 'python'],
+        metavar='CONSOLE',
+        help='select type of interactive session: ipython | python; defaults '
+        'to ipython if IPython is installed, otherwise python')
+
+    parser.add_argument(
+        '-p', '--pretty',
+        dest='pretty',
+        action='store',
+        default=None,
+        metavar='PRETTY',
+        choices=['unicode', 'ascii', 'no'],
+        help='setup pretty printing: unicode | ascii | no; defaults to '
+        'unicode printing if the terminal supports it, otherwise ascii')
+
+    parser.add_argument(
+        '-t', '--types',
+        dest='types',
+        action='store',
+        default=None,
+        metavar='TYPES',
+        choices=['gmpy', 'gmpy1', 'python'],
+        help='setup ground types: gmpy | gmpy1 | python; defaults to gmpy if gmpy2 '
+        'or gmpy is installed, otherwise python')
+
+    parser.add_argument(
+        '-o', '--order',
+        dest='order',
+        action='store',
+        default=None,
+        metavar='ORDER',
+        choices=['lex', 'grlex', 'grevlex', 'rev-lex', 'rev-grlex', 'rev-grevlex', 'old', 'none'],
+        help='setup ordering of terms: [rev-]lex | [rev-]grlex | [rev-]grevlex | old | none; defaults to lex')
+
+    parser.add_argument(
+        '-q', '--quiet',
+        dest='quiet',
+        action='store_true',
+        default=False,
+        help='print only version information at startup')
+
+    parser.add_argument(
+        '-d', '--doctest',
+        dest='doctest',
+        action='store_true',
+        default=False,
+        help='use the doctest format for output (you can just copy and paste it)')
+
+    parser.add_argument(
+        '-C', '--no-cache',
+        dest='cache',
+        action='store_false',
+        default=True,
+        help='disable caching mechanism')
+
+    parser.add_argument(
+        '-a', '--auto-symbols',
+        dest='auto_symbols',
+        action='store_true',
+        default=False,
+        help='automatically construct missing symbols')
+
+    parser.add_argument(
+        '-i', '--int-to-Integer',
+        dest='auto_int_to_Integer',
+        action='store_true',
+        default=False,
+        help="automatically wrap int literals with Integer")
+
+    parser.add_argument(
+        '-I', '--interactive',
+        dest='interactive',
+        action='store_true',
+        default=False,
+        help="equivalent to -a -i")
+
+    parser.add_argument(
+        '-D', '--debug',
+        dest='debug',
+        action='store_true',
+        default=False,
+        help='enable debugging output')
+
+    (options, ipy_args) = parser.parse_known_args()
+    if '--' in ipy_args:
+        ipy_args.remove('--')
+
+    if not options.cache:
+        os.environ['SYMPY_USE_CACHE'] = 'no'
+
+    if options.types:
+        os.environ['SYMPY_GROUND_TYPES'] = options.types
+
+    if options.debug:
+        os.environ['SYMPY_DEBUG'] = str(options.debug)
+
+    if options.doctest:
+        options.pretty = 'no'
+        options.console = 'python'
+
+    session = options.console
+
+    if session is not None:
+        ipython = session == 'ipython'
+    else:
+        try:
+            import IPython
+            ipython = True
+        except ImportError:
+            if not options.quiet:
+                from sympy.interactive.session import no_ipython
+                print(no_ipython)
+            ipython = False
+
+    args = {
+        'pretty_print': True,
+        'use_unicode':  None,
+        'use_latex':    None,
+        'order':        None,
+        'argv':         ipy_args,
+    }
+
+    if options.pretty == 'unicode':
+        args['use_unicode'] = True
+    elif options.pretty == 'ascii':
+        args['use_unicode'] = False
+    elif options.pretty == 'no':
+        args['pretty_print'] = False
+
+    if options.order is not None:
+        args['order'] = options.order
+
+    args['quiet'] = options.quiet
+    args['auto_symbols'] = options.auto_symbols or options.interactive
+    args['auto_int_to_Integer'] = options.auto_int_to_Integer or options.interactive
+
+    from sympy.interactive import init_session
+    init_session(ipython, **args)
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Lib/site-packages/jinja2/__init__.py b/llm/Lib/site-packages/jinja2/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..af5d4288d3c7f7c00d131e3341716755bb95351f
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/__init__.py
@@ -0,0 +1,37 @@
+"""Jinja is a template engine written in pure Python. It provides a
+non-XML syntax that supports inline expressions and an optional
+sandboxed environment.
+"""
+from .bccache import BytecodeCache as BytecodeCache
+from .bccache import FileSystemBytecodeCache as FileSystemBytecodeCache
+from .bccache import MemcachedBytecodeCache as MemcachedBytecodeCache
+from .environment import Environment as Environment
+from .environment import Template as Template
+from .exceptions import TemplateAssertionError as TemplateAssertionError
+from .exceptions import TemplateError as TemplateError
+from .exceptions import TemplateNotFound as TemplateNotFound
+from .exceptions import TemplateRuntimeError as TemplateRuntimeError
+from .exceptions import TemplatesNotFound as TemplatesNotFound
+from .exceptions import TemplateSyntaxError as TemplateSyntaxError
+from .exceptions import UndefinedError as UndefinedError
+from .loaders import BaseLoader as BaseLoader
+from .loaders import ChoiceLoader as ChoiceLoader
+from .loaders import DictLoader as DictLoader
+from .loaders import FileSystemLoader as FileSystemLoader
+from .loaders import FunctionLoader as FunctionLoader
+from .loaders import ModuleLoader as ModuleLoader
+from .loaders import PackageLoader as PackageLoader
+from .loaders import PrefixLoader as PrefixLoader
+from .runtime import ChainableUndefined as ChainableUndefined
+from .runtime import DebugUndefined as DebugUndefined
+from .runtime import make_logging_undefined as make_logging_undefined
+from .runtime import StrictUndefined as StrictUndefined
+from .runtime import Undefined as Undefined
+from .utils import clear_caches as clear_caches
+from .utils import is_undefined as is_undefined
+from .utils import pass_context as pass_context
+from .utils import pass_environment as pass_environment
+from .utils import pass_eval_context as pass_eval_context
+from .utils import select_autoescape as select_autoescape
+
+__version__ = "3.1.3"
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a0394a85697bd18a055d0c71cc296859d2c5e060
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/_identifier.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/_identifier.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4115a8181007d1ac1a503dc20a3d13ba406c3766
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/_identifier.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/async_utils.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/async_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5ef26660cfe5e7274736371aaa21c258fde0ac2a
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/async_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/bccache.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/bccache.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bfedc37cf277dac1b07c0ca325703254ecd68c36
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/bccache.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/compiler.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/compiler.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7045023fbf3aa300aed6da62666280dbff28926a
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/compiler.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/constants.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/constants.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bc7b727b73eac2ffe8454f39e3c43cce6565339b
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/constants.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/debug.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/debug.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..361c444abbdfc5a7fe6b45b4a71c8d8df866ecac
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/debug.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/defaults.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/defaults.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..308cd16242408bc2e8fa0c6d960a5ba4797931a8
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/defaults.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/environment.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/environment.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0a1d975c0651429580ed9121620bf39541e03530
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/environment.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d9f9a3e16d0bd98975d5e0f0f5cf320aeae6559b
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/ext.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/ext.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..efc9362850d14b3936a88b8c616a705a0b26ca8d
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/ext.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/filters.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/filters.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c92f87fd256413d79bb225c6b186c2a4b11a3855
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/filters.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/idtracking.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/idtracking.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..950f3ee25ae882fea1e52f7116780d9899e3d893
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/idtracking.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/lexer.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/lexer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eb0386d658a75b35e617ee6d32eb6abebf14b647
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/lexer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/loaders.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/loaders.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..59078ab942d2082a38e91df359c011448de88ceb
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/loaders.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/meta.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/meta.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4d3fcef2913b68daa4a50f77833f37036ddf0783
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/meta.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/nativetypes.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/nativetypes.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..70220a3e86d4e351c17af39db5ff0df3d52e556f
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/nativetypes.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/nodes.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/nodes.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c33a025431607b14b32ee92dc7d1dd3bfecc1ffc
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/nodes.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/optimizer.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/optimizer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4d29854041a9301ff4b65167707ad48bcf1f2b89
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/optimizer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/parser.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c5134f15bdbdd698a67b8d5f1c52006f7b4e1a7c
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/runtime.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/runtime.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7969b3da6307f1e3ec2a34ecfadf28a762550962
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/runtime.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/sandbox.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/sandbox.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c872f307f95618f2777ecd74ce9a2c0773cc0e06
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/sandbox.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/tests.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/tests.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..98bd9ffa8be3696834015524d44909953febc759
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/tests.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c31a53d898274cdb784f891d6bb0f7ea065bf5ed
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/__pycache__/visitor.cpython-311.pyc b/llm/Lib/site-packages/jinja2/__pycache__/visitor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b6fd31d9b94fa234ba5775736c6a6685ed4cb642
Binary files /dev/null and b/llm/Lib/site-packages/jinja2/__pycache__/visitor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jinja2/_identifier.py b/llm/Lib/site-packages/jinja2/_identifier.py
new file mode 100644
index 0000000000000000000000000000000000000000..928c1503c7d414a8a86bbf5a82c68d42cb089bd2
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/_identifier.py
@@ -0,0 +1,6 @@
+import re
+
+# generated by scripts/generate_identifier_pattern.py
+pattern = re.compile(
+    r"[\w·̀-ͯ·҃-֑҇-ׇֽֿׁׂׅׄؐ-ًؚ-ٰٟۖ-ۜ۟-۪ۤۧۨ-ܑۭܰ-݊ަ-ް߫-߽߳ࠖ-࠙ࠛ-ࠣࠥ-ࠧࠩ-࡙࠭-࡛࣓-ࣣ࣡-ःऺ-़ा-ॏ॑-ॗॢॣঁ-ঃ়া-ৄেৈো-্ৗৢৣ৾ਁ-ਃ਼ਾ-ੂੇੈੋ-੍ੑੰੱੵઁ-ઃ઼ા-ૅે-ૉો-્ૢૣૺ-૿ଁ-ଃ଼ା-ୄେୈୋ-୍ୖୗୢୣஂா-ூெ-ைொ-்ௗఀ-ఄా-ౄె-ైొ-్ౕౖౢౣಁ-ಃ಼ಾ-ೄೆ-ೈೊ-್ೕೖೢೣഀ-ഃ഻഼ാ-ൄെ-ൈൊ-്ൗൢൣංඃ්ා-ුූෘ-ෟෲෳัิ-ฺ็-๎ັິ-ູົຼ່-ໍ༹༘༙༵༷༾༿ཱ-྄྆྇ྍ-ྗྙ-ྼ࿆ါ-ှၖ-ၙၞ-ၠၢ-ၤၧ-ၭၱ-ၴႂ-ႍႏႚ-ႝ፝-፟ᜒ-᜔ᜲ-᜴ᝒᝓᝲᝳ឴-៓៝᠋-᠍ᢅᢆᢩᤠ-ᤫᤰ-᤻ᨗ-ᨛᩕ-ᩞ᩠-᩿᩼᪰-᪽ᬀ-ᬄ᬴-᭄᭫-᭳ᮀ-ᮂᮡ-ᮭ᯦-᯳ᰤ-᰷᳐-᳔᳒-᳨᳭ᳲ-᳴᳷-᳹᷀-᷹᷻-᷿‿⁀⁔⃐-⃥⃜⃡-⃰℘℮⳯-⵿⳱ⷠ-〪ⷿ-゙゚〯꙯ꙴ-꙽ꚞꚟ꛰꛱ꠂ꠆ꠋꠣ-ꠧꢀꢁꢴ-ꣅ꣠-꣱ꣿꤦ-꤭ꥇ-꥓ꦀ-ꦃ꦳-꧀ꧥꨩ-ꨶꩃꩌꩍꩻ-ꩽꪰꪲ-ꪴꪷꪸꪾ꪿꫁ꫫ-ꫯꫵ꫶ꯣ-ꯪ꯬꯭ﬞ︀-️︠-︯︳︴﹍-﹏＿𐇽𐋠𐍶-𐍺𐨁-𐨃𐨅𐨆𐨌-𐨏𐨸-𐨿𐨺𐫦𐫥𐴤-𐽆𐴧-𐽐𑀀-𑀂𑀸-𑁆𑁿-𑂂𑂰-𑂺𑄀-𑄂𑄧-𑄴𑅅𑅆𑅳𑆀-𑆂𑆳-𑇀𑇉-𑇌𑈬-𑈷𑈾𑋟-𑋪𑌀-𑌃𑌻𑌼𑌾-𑍄𑍇𑍈𑍋-𑍍𑍗𑍢𑍣𑍦-𑍬𑍰-𑍴𑐵-𑑆𑑞𑒰-𑓃𑖯-𑖵𑖸-𑗀𑗜𑗝𑘰-𑙀𑚫-𑚷𑜝-𑜫𑠬-𑠺𑨁-𑨊𑨳-𑨹𑨻-𑨾𑩇𑩑-𑩛𑪊-𑪙𑰯-𑰶𑰸-𑰿𑲒-𑲧𑲩-𑲶𑴱-𑴶𑴺𑴼𑴽𑴿-𑵅𑵇𑶊-𑶎𑶐𑶑𑶓-𑶗𑻳-𑻶𖫰-𖫴𖬰-𖬶𖽑-𖽾𖾏-𖾒𛲝𛲞𝅥-𝅩𝅭-𝅲𝅻-𝆂𝆅-𝆋𝆪-𝆭𝉂-𝉄𝨀-𝨶𝨻-𝩬𝩵𝪄𝪛-𝪟𝪡-𝪯𞀀-𞀆𞀈-𞀘𞀛-𞀡𞀣𞀤𞀦-𞣐𞀪-𞣖𞥄-𞥊󠄀-󠇯]+"  # noqa: B950
+)
diff --git a/llm/Lib/site-packages/jinja2/async_utils.py b/llm/Lib/site-packages/jinja2/async_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..715d70119bba3f02350827da184cedbd08f65185
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/async_utils.py
@@ -0,0 +1,84 @@
+import inspect
+import typing as t
+from functools import WRAPPER_ASSIGNMENTS
+from functools import wraps
+
+from .utils import _PassArg
+from .utils import pass_eval_context
+
+V = t.TypeVar("V")
+
+
+def async_variant(normal_func):  # type: ignore
+    def decorator(async_func):  # type: ignore
+        pass_arg = _PassArg.from_obj(normal_func)
+        need_eval_context = pass_arg is None
+
+        if pass_arg is _PassArg.environment:
+
+            def is_async(args: t.Any) -> bool:
+                return t.cast(bool, args[0].is_async)
+
+        else:
+
+            def is_async(args: t.Any) -> bool:
+                return t.cast(bool, args[0].environment.is_async)
+
+        # Take the doc and annotations from the sync function, but the
+        # name from the async function. Pallets-Sphinx-Themes
+        # build_function_directive expects __wrapped__ to point to the
+        # sync function.
+        async_func_attrs = ("__module__", "__name__", "__qualname__")
+        normal_func_attrs = tuple(set(WRAPPER_ASSIGNMENTS).difference(async_func_attrs))
+
+        @wraps(normal_func, assigned=normal_func_attrs)
+        @wraps(async_func, assigned=async_func_attrs, updated=())
+        def wrapper(*args, **kwargs):  # type: ignore
+            b = is_async(args)
+
+            if need_eval_context:
+                args = args[1:]
+
+            if b:
+                return async_func(*args, **kwargs)
+
+            return normal_func(*args, **kwargs)
+
+        if need_eval_context:
+            wrapper = pass_eval_context(wrapper)
+
+        wrapper.jinja_async_variant = True
+        return wrapper
+
+    return decorator
+
+
+_common_primitives = {int, float, bool, str, list, dict, tuple, type(None)}
+
+
+async def auto_await(value: t.Union[t.Awaitable["V"], "V"]) -> "V":
+    # Avoid a costly call to isawaitable
+    if type(value) in _common_primitives:
+        return t.cast("V", value)
+
+    if inspect.isawaitable(value):
+        return await t.cast("t.Awaitable[V]", value)
+
+    return t.cast("V", value)
+
+
+async def auto_aiter(
+    iterable: "t.Union[t.AsyncIterable[V], t.Iterable[V]]",
+) -> "t.AsyncIterator[V]":
+    if hasattr(iterable, "__aiter__"):
+        async for item in t.cast("t.AsyncIterable[V]", iterable):
+            yield item
+    else:
+        for item in iterable:
+            yield item
+
+
+async def auto_to_list(
+    value: "t.Union[t.AsyncIterable[V], t.Iterable[V]]",
+) -> t.List["V"]:
+    return [x async for x in auto_aiter(value)]
diff --git a/llm/Lib/site-packages/jinja2/bccache.py b/llm/Lib/site-packages/jinja2/bccache.py
new file mode 100644
index 0000000000000000000000000000000000000000..d0ddf56ef62b03cba6b6c5f9b94d819393f09d38
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/bccache.py
@@ -0,0 +1,406 @@
+"""The optional bytecode cache system. This is useful if you have very
+complex template situations and the compilation of all those templates
+slows down your application too much.
+
+Situations where this is useful are often forking web applications that
+are initialized on the first request.
+"""
+import errno
+import fnmatch
+import marshal
+import os
+import pickle
+import stat
+import sys
+import tempfile
+import typing as t
+from hashlib import sha1
+from io import BytesIO
+from types import CodeType
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+    from .environment import Environment
+
+    class _MemcachedClient(te.Protocol):
+        def get(self, key: str) -> bytes:
+            ...
+
+        def set(self, key: str, value: bytes, timeout: t.Optional[int] = None) -> None:
+            ...
+
+
+bc_version = 5
+# Magic bytes to identify Jinja bytecode cache files. Contains the
+# Python major and minor version to avoid loading incompatible bytecode
+# if a project upgrades its Python version.
+bc_magic = (
+    b"j2"
+    + pickle.dumps(bc_version, 2)
+    + pickle.dumps((sys.version_info[0] << 24) | sys.version_info[1], 2)
+)
+
+
+class Bucket:
+    """Buckets are used to store the bytecode for one template.  It's created
+    and initialized by the bytecode cache and passed to the loading functions.
+
+    The buckets get an internal checksum from the cache assigned and use this
+    to automatically reject outdated cache material.  Individual bytecode
+    cache subclasses don't have to care about cache invalidation.
+    """
+
+    def __init__(self, environment: "Environment", key: str, checksum: str) -> None:
+        self.environment = environment
+        self.key = key
+        self.checksum = checksum
+        self.reset()
+
+    def reset(self) -> None:
+        """Resets the bucket (unloads the bytecode)."""
+        self.code: t.Optional[CodeType] = None
+
+    def load_bytecode(self, f: t.BinaryIO) -> None:
+        """Loads bytecode from a file or file like object."""
+        # make sure the magic header is correct
+        magic = f.read(len(bc_magic))
+        if magic != bc_magic:
+            self.reset()
+            return
+        # the source code of the file changed, we need to reload
+        checksum = pickle.load(f)
+        if self.checksum != checksum:
+            self.reset()
+            return
+        # if marshal_load fails then we need to reload
+        try:
+            self.code = marshal.load(f)
+        except (EOFError, ValueError, TypeError):
+            self.reset()
+            return
+
+    def write_bytecode(self, f: t.IO[bytes]) -> None:
+        """Dump the bytecode into the file or file like object passed."""
+        if self.code is None:
+            raise TypeError("can't write empty bucket")
+        f.write(bc_magic)
+        pickle.dump(self.checksum, f, 2)
+        marshal.dump(self.code, f)
+
+    def bytecode_from_string(self, string: bytes) -> None:
+        """Load bytecode from bytes."""
+        self.load_bytecode(BytesIO(string))
+
+    def bytecode_to_string(self) -> bytes:
+        """Return the bytecode as bytes."""
+        out = BytesIO()
+        self.write_bytecode(out)
+        return out.getvalue()
+
+
+class BytecodeCache:
+    """To implement your own bytecode cache you have to subclass this class
+    and override :meth:`load_bytecode` and :meth:`dump_bytecode`.  Both of
+    these methods are passed a :class:`~jinja2.bccache.Bucket`.
+
+    A very basic bytecode cache that saves the bytecode on the file system::
+
+        from os import path
+
+        class MyCache(BytecodeCache):
+
+            def __init__(self, directory):
+                self.directory = directory
+
+            def load_bytecode(self, bucket):
+                filename = path.join(self.directory, bucket.key)
+                if path.exists(filename):
+                    with open(filename, 'rb') as f:
+                        bucket.load_bytecode(f)
+
+            def dump_bytecode(self, bucket):
+                filename = path.join(self.directory, bucket.key)
+                with open(filename, 'wb') as f:
+                    bucket.write_bytecode(f)
+
+    A more advanced version of a filesystem based bytecode cache is part of
+    Jinja.
+    """
+
+    def load_bytecode(self, bucket: Bucket) -> None:
+        """Subclasses have to override this method to load bytecode into a
+        bucket.  If they are not able to find code in the cache for the
+        bucket, it must not do anything.
+        """
+        raise NotImplementedError()
+
+    def dump_bytecode(self, bucket: Bucket) -> None:
+        """Subclasses have to override this method to write the bytecode
+        from a bucket back to the cache.  If it unable to do so it must not
+        fail silently but raise an exception.
+        """
+        raise NotImplementedError()
+
+    def clear(self) -> None:
+        """Clears the cache.  This method is not used by Jinja but should be
+        implemented to allow applications to clear the bytecode cache used
+        by a particular environment.
+        """
+
+    def get_cache_key(
+        self, name: str, filename: t.Optional[t.Union[str]] = None
+    ) -> str:
+        """Returns the unique hash key for this template name."""
+        hash = sha1(name.encode("utf-8"))
+
+        if filename is not None:
+            hash.update(f"|{filename}".encode())
+
+        return hash.hexdigest()
+
+    def get_source_checksum(self, source: str) -> str:
+        """Returns a checksum for the source."""
+        return sha1(source.encode("utf-8")).hexdigest()
+
+    def get_bucket(
+        self,
+        environment: "Environment",
+        name: str,
+        filename: t.Optional[str],
+        source: str,
+    ) -> Bucket:
+        """Return a cache bucket for the given template.  All arguments are
+        mandatory but filename may be `None`.
+        """
+        key = self.get_cache_key(name, filename)
+        checksum = self.get_source_checksum(source)
+        bucket = Bucket(environment, key, checksum)
+        self.load_bytecode(bucket)
+        return bucket
+
+    def set_bucket(self, bucket: Bucket) -> None:
+        """Put the bucket into the cache."""
+        self.dump_bytecode(bucket)
+
+
+class FileSystemBytecodeCache(BytecodeCache):
+    """A bytecode cache that stores bytecode on the filesystem.  It accepts
+    two arguments: The directory where the cache items are stored and a
+    pattern string that is used to build the filename.
+
+    If no directory is specified a default cache directory is selected.  On
+    Windows the user's temp directory is used, on UNIX systems a directory
+    is created for the user in the system temp directory.
+
+    The pattern can be used to have multiple separate caches operate on the
+    same directory.  The default pattern is ``'__jinja2_%s.cache'``.  ``%s``
+    is replaced with the cache key.
+
+    >>> bcc = FileSystemBytecodeCache('/tmp/jinja_cache', '%s.cache')
+
+    This bytecode cache supports clearing of the cache using the clear method.
+    """
+
+    def __init__(
+        self, directory: t.Optional[str] = None, pattern: str = "__jinja2_%s.cache"
+    ) -> None:
+        if directory is None:
+            directory = self._get_default_cache_dir()
+        self.directory = directory
+        self.pattern = pattern
+
+    def _get_default_cache_dir(self) -> str:
+        def _unsafe_dir() -> "te.NoReturn":
+            raise RuntimeError(
+                "Cannot determine safe temp directory.  You "
+                "need to explicitly provide one."
+            )
+
+        tmpdir = tempfile.gettempdir()
+
+        # On windows the temporary directory is used specific unless
+        # explicitly forced otherwise.  We can just use that.
+        if os.name == "nt":
+            return tmpdir
+        if not hasattr(os, "getuid"):
+            _unsafe_dir()
+
+        dirname = f"_jinja2-cache-{os.getuid()}"
+        actual_dir = os.path.join(tmpdir, dirname)
+
+        try:
+            os.mkdir(actual_dir, stat.S_IRWXU)
+        except OSError as e:
+            if e.errno != errno.EEXIST:
+                raise
+        try:
+            os.chmod(actual_dir, stat.S_IRWXU)
+            actual_dir_stat = os.lstat(actual_dir)
+            if (
+                actual_dir_stat.st_uid != os.getuid()
+                or not stat.S_ISDIR(actual_dir_stat.st_mode)
+                or stat.S_IMODE(actual_dir_stat.st_mode) != stat.S_IRWXU
+            ):
+                _unsafe_dir()
+        except OSError as e:
+            if e.errno != errno.EEXIST:
+                raise
+
+        actual_dir_stat = os.lstat(actual_dir)
+        if (
+            actual_dir_stat.st_uid != os.getuid()
+            or not stat.S_ISDIR(actual_dir_stat.st_mode)
+            or stat.S_IMODE(actual_dir_stat.st_mode) != stat.S_IRWXU
+        ):
+            _unsafe_dir()
+
+        return actual_dir
+
+    def _get_cache_filename(self, bucket: Bucket) -> str:
+        return os.path.join(self.directory, self.pattern % (bucket.key,))
+
+    def load_bytecode(self, bucket: Bucket) -> None:
+        filename = self._get_cache_filename(bucket)
+
+        # Don't test for existence before opening the file, since the
+        # file could disappear after the test before the open.
+        try:
+            f = open(filename, "rb")
+        except (FileNotFoundError, IsADirectoryError, PermissionError):
+            # PermissionError can occur on Windows when an operation is
+            # in progress, such as calling clear().
+            return
+
+        with f:
+            bucket.load_bytecode(f)
+
+    def dump_bytecode(self, bucket: Bucket) -> None:
+        # Write to a temporary file, then rename to the real name after
+        # writing. This avoids another process reading the file before
+        # it is fully written.
+        name = self._get_cache_filename(bucket)
+        f = tempfile.NamedTemporaryFile(
+            mode="wb",
+            dir=os.path.dirname(name),
+            prefix=os.path.basename(name),
+            suffix=".tmp",
+            delete=False,
+        )
+
+        def remove_silent() -> None:
+            try:
+                os.remove(f.name)
+            except OSError:
+                # Another process may have called clear(). On Windows,
+                # another program may be holding the file open.
+                pass
+
+        try:
+            with f:
+                bucket.write_bytecode(f)
+        except BaseException:
+            remove_silent()
+            raise
+
+        try:
+            os.replace(f.name, name)
+        except OSError:
+            # Another process may have called clear(). On Windows,
+            # another program may be holding the file open.
+            remove_silent()
+        except BaseException:
+            remove_silent()
+            raise
+
+    def clear(self) -> None:
+        # imported lazily here because google app-engine doesn't support
+        # write access on the file system and the function does not exist
+        # normally.
+        from os import remove
+
+        files = fnmatch.filter(os.listdir(self.directory), self.pattern % ("*",))
+        for filename in files:
+            try:
+                remove(os.path.join(self.directory, filename))
+            except OSError:
+                pass
+
+
+class MemcachedBytecodeCache(BytecodeCache):
+    """This class implements a bytecode cache that uses a memcache cache for
+    storing the information.  It does not enforce a specific memcache library
+    (tummy's memcache or cmemcache) but will accept any class that provides
+    the minimal interface required.
+
+    Libraries compatible with this class:
+
+    -   `cachelib <https://github.com/pallets/cachelib>`_
+    -   `python-memcached <https://pypi.org/project/python-memcached/>`_
+
+    (Unfortunately the django cache interface is not compatible because it
+    does not support storing binary data, only text. You can however pass
+    the underlying cache client to the bytecode cache which is available
+    as `django.core.cache.cache._client`.)
+
+    The minimal interface for the client passed to the constructor is this:
+
+    .. class:: MinimalClientInterface
+
+        .. method:: set(key, value[, timeout])
+
+            Stores the bytecode in the cache.  `value` is a string and
+            `timeout` the timeout of the key.  If timeout is not provided
+            a default timeout or no timeout should be assumed, if it's
+            provided it's an integer with the number of seconds the cache
+            item should exist.
+
+        .. method:: get(key)
+
+            Returns the value for the cache key.  If the item does not
+            exist in the cache the return value must be `None`.
+
+    The other arguments to the constructor are the prefix for all keys that
+    is added before the actual cache key and the timeout for the bytecode in
+    the cache system.  We recommend a high (or no) timeout.
+
+    This bytecode cache does not support clearing of used items in the cache.
+    The clear method is a no-operation function.
+
+    .. versionadded:: 2.7
+       Added support for ignoring memcache errors through the
+       `ignore_memcache_errors` parameter.
+    """
+
+    def __init__(
+        self,
+        client: "_MemcachedClient",
+        prefix: str = "jinja2/bytecode/",
+        timeout: t.Optional[int] = None,
+        ignore_memcache_errors: bool = True,
+    ):
+        self.client = client
+        self.prefix = prefix
+        self.timeout = timeout
+        self.ignore_memcache_errors = ignore_memcache_errors
+
+    def load_bytecode(self, bucket: Bucket) -> None:
+        try:
+            code = self.client.get(self.prefix + bucket.key)
+        except Exception:
+            if not self.ignore_memcache_errors:
+                raise
+        else:
+            bucket.bytecode_from_string(code)
+
+    def dump_bytecode(self, bucket: Bucket) -> None:
+        key = self.prefix + bucket.key
+        value = bucket.bytecode_to_string()
+
+        try:
+            if self.timeout is not None:
+                self.client.set(key, value, self.timeout)
+            else:
+                self.client.set(key, value)
+        except Exception:
+            if not self.ignore_memcache_errors:
+                raise
diff --git a/llm/Lib/site-packages/jinja2/compiler.py b/llm/Lib/site-packages/jinja2/compiler.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff95c807b0bab10991df53f82de2c94a0db7edc8
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/compiler.py
@@ -0,0 +1,1956 @@
+"""Compiles nodes from the parser into Python code."""
+import typing as t
+from contextlib import contextmanager
+from functools import update_wrapper
+from io import StringIO
+from itertools import chain
+from keyword import iskeyword as is_python_keyword
+
+from markupsafe import escape
+from markupsafe import Markup
+
+from . import nodes
+from .exceptions import TemplateAssertionError
+from .idtracking import Symbols
+from .idtracking import VAR_LOAD_ALIAS
+from .idtracking import VAR_LOAD_PARAMETER
+from .idtracking import VAR_LOAD_RESOLVE
+from .idtracking import VAR_LOAD_UNDEFINED
+from .nodes import EvalContext
+from .optimizer import Optimizer
+from .utils import _PassArg
+from .utils import concat
+from .visitor import NodeVisitor
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+    from .environment import Environment
+
+F = t.TypeVar("F", bound=t.Callable[..., t.Any])
+
+operators = {
+    "eq": "==",
+    "ne": "!=",
+    "gt": ">",
+    "gteq": ">=",
+    "lt": "<",
+    "lteq": "<=",
+    "in": "in",
+    "notin": "not in",
+}
+
+
+def optimizeconst(f: F) -> F:
+    def new_func(
+        self: "CodeGenerator", node: nodes.Expr, frame: "Frame", **kwargs: t.Any
+    ) -> t.Any:
+        # Only optimize if the frame is not volatile
+        if self.optimizer is not None and not frame.eval_ctx.volatile:
+            new_node = self.optimizer.visit(node, frame.eval_ctx)
+
+            if new_node != node:
+                return self.visit(new_node, frame)
+
+        return f(self, node, frame, **kwargs)
+
+    return update_wrapper(t.cast(F, new_func), f)
+
+
+def _make_binop(op: str) -> t.Callable[["CodeGenerator", nodes.BinExpr, "Frame"], None]:
+    @optimizeconst
+    def visitor(self: "CodeGenerator", node: nodes.BinExpr, frame: Frame) -> None:
+        if (
+            self.environment.sandboxed
+            and op in self.environment.intercepted_binops  # type: ignore
+        ):
+            self.write(f"environment.call_binop(context, {op!r}, ")
+            self.visit(node.left, frame)
+            self.write(", ")
+            self.visit(node.right, frame)
+        else:
+            self.write("(")
+            self.visit(node.left, frame)
+            self.write(f" {op} ")
+            self.visit(node.right, frame)
+
+        self.write(")")
+
+    return visitor
+
+
+def _make_unop(
+    op: str,
+) -> t.Callable[["CodeGenerator", nodes.UnaryExpr, "Frame"], None]:
+    @optimizeconst
+    def visitor(self: "CodeGenerator", node: nodes.UnaryExpr, frame: Frame) -> None:
+        if (
+            self.environment.sandboxed
+            and op in self.environment.intercepted_unops  # type: ignore
+        ):
+            self.write(f"environment.call_unop(context, {op!r}, ")
+            self.visit(node.node, frame)
+        else:
+            self.write("(" + op)
+            self.visit(node.node, frame)
+
+        self.write(")")
+
+    return visitor
+
+
+def generate(
+    node: nodes.Template,
+    environment: "Environment",
+    name: t.Optional[str],
+    filename: t.Optional[str],
+    stream: t.Optional[t.TextIO] = None,
+    defer_init: bool = False,
+    optimized: bool = True,
+) -> t.Optional[str]:
+    """Generate the python source for a node tree."""
+    if not isinstance(node, nodes.Template):
+        raise TypeError("Can't compile non template nodes")
+
+    generator = environment.code_generator_class(
+        environment, name, filename, stream, defer_init, optimized
+    )
+    generator.visit(node)
+
+    if stream is None:
+        return generator.stream.getvalue()  # type: ignore
+
+    return None
+
+
+def has_safe_repr(value: t.Any) -> bool:
+    """Does the node have a safe representation?"""
+    if value is None or value is NotImplemented or value is Ellipsis:
+        return True
+
+    if type(value) in {bool, int, float, complex, range, str, Markup}:
+        return True
+
+    if type(value) in {tuple, list, set, frozenset}:
+        return all(has_safe_repr(v) for v in value)
+
+    if type(value) is dict:
+        return all(has_safe_repr(k) and has_safe_repr(v) for k, v in value.items())
+
+    return False
+
+
+def find_undeclared(
+    nodes: t.Iterable[nodes.Node], names: t.Iterable[str]
+) -> t.Set[str]:
+    """Check if the names passed are accessed undeclared.  The return value
+    is a set of all the undeclared names from the sequence of names found.
+    """
+    visitor = UndeclaredNameVisitor(names)
+    try:
+        for node in nodes:
+            visitor.visit(node)
+    except VisitorExit:
+        pass
+    return visitor.undeclared
+
+
+class MacroRef:
+    def __init__(self, node: t.Union[nodes.Macro, nodes.CallBlock]) -> None:
+        self.node = node
+        self.accesses_caller = False
+        self.accesses_kwargs = False
+        self.accesses_varargs = False
+
+
+class Frame:
+    """Holds compile time information for us."""
+
+    def __init__(
+        self,
+        eval_ctx: EvalContext,
+        parent: t.Optional["Frame"] = None,
+        level: t.Optional[int] = None,
+    ) -> None:
+        self.eval_ctx = eval_ctx
+
+        # the parent of this frame
+        self.parent = parent
+
+        if parent is None:
+            self.symbols = Symbols(level=level)
+
+            # in some dynamic inheritance situations the compiler needs to add
+            # write tests around output statements.
+            self.require_output_check = False
+
+            # inside some tags we are using a buffer rather than yield statements.
+            # this for example affects {% filter %} or {% macro %}.  If a frame
+            # is buffered this variable points to the name of the list used as
+            # buffer.
+            self.buffer: t.Optional[str] = None
+
+            # the name of the block we're in, otherwise None.
+            self.block: t.Optional[str] = None
+
+        else:
+            self.symbols = Symbols(parent.symbols, level=level)
+            self.require_output_check = parent.require_output_check
+            self.buffer = parent.buffer
+            self.block = parent.block
+
+        # a toplevel frame is the root + soft frames such as if conditions.
+        self.toplevel = False
+
+        # the root frame is basically just the outermost frame, so no if
+        # conditions.  This information is used to optimize inheritance
+        # situations.
+        self.rootlevel = False
+
+        # variables set inside of loops and blocks should not affect outer frames,
+        # but they still needs to be kept track of as part of the active context.
+        self.loop_frame = False
+        self.block_frame = False
+
+        # track whether the frame is being used in an if-statement or conditional
+        # expression as it determines which errors should be raised during runtime
+        # or compile time.
+        self.soft_frame = False
+
+    def copy(self) -> "Frame":
+        """Create a copy of the current one."""
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.symbols = self.symbols.copy()
+        return rv
+
+    def inner(self, isolated: bool = False) -> "Frame":
+        """Return an inner frame."""
+        if isolated:
+            return Frame(self.eval_ctx, level=self.symbols.level + 1)
+        return Frame(self.eval_ctx, self)
+
+    def soft(self) -> "Frame":
+        """Return a soft frame.  A soft frame may not be modified as
+        standalone thing as it shares the resources with the frame it
+        was created of, but it's not a rootlevel frame any longer.
+
+        This is only used to implement if-statements and conditional
+        expressions.
+        """
+        rv = self.copy()
+        rv.rootlevel = False
+        rv.soft_frame = True
+        return rv
+
+    __copy__ = copy
+
+
+class VisitorExit(RuntimeError):
+    """Exception used by the `UndeclaredNameVisitor` to signal a stop."""
+
+
+class DependencyFinderVisitor(NodeVisitor):
+    """A visitor that collects filter and test calls."""
+
+    def __init__(self) -> None:
+        self.filters: t.Set[str] = set()
+        self.tests: t.Set[str] = set()
+
+    def visit_Filter(self, node: nodes.Filter) -> None:
+        self.generic_visit(node)
+        self.filters.add(node.name)
+
+    def visit_Test(self, node: nodes.Test) -> None:
+        self.generic_visit(node)
+        self.tests.add(node.name)
+
+    def visit_Block(self, node: nodes.Block) -> None:
+        """Stop visiting at blocks."""
+
+
+class UndeclaredNameVisitor(NodeVisitor):
+    """A visitor that checks if a name is accessed without being
+    declared.  This is different from the frame visitor as it will
+    not stop at closure frames.
+    """
+
+    def __init__(self, names: t.Iterable[str]) -> None:
+        self.names = set(names)
+        self.undeclared: t.Set[str] = set()
+
+    def visit_Name(self, node: nodes.Name) -> None:
+        if node.ctx == "load" and node.name in self.names:
+            self.undeclared.add(node.name)
+            if self.undeclared == self.names:
+                raise VisitorExit()
+        else:
+            self.names.discard(node.name)
+
+    def visit_Block(self, node: nodes.Block) -> None:
+        """Stop visiting a blocks."""
+
+
+class CompilerExit(Exception):
+    """Raised if the compiler encountered a situation where it just
+    doesn't make sense to further process the code.  Any block that
+    raises such an exception is not further processed.
+    """
+
+
+class CodeGenerator(NodeVisitor):
+    def __init__(
+        self,
+        environment: "Environment",
+        name: t.Optional[str],
+        filename: t.Optional[str],
+        stream: t.Optional[t.TextIO] = None,
+        defer_init: bool = False,
+        optimized: bool = True,
+    ) -> None:
+        if stream is None:
+            stream = StringIO()
+        self.environment = environment
+        self.name = name
+        self.filename = filename
+        self.stream = stream
+        self.created_block_context = False
+        self.defer_init = defer_init
+        self.optimizer: t.Optional[Optimizer] = None
+
+        if optimized:
+            self.optimizer = Optimizer(environment)
+
+        # aliases for imports
+        self.import_aliases: t.Dict[str, str] = {}
+
+        # a registry for all blocks.  Because blocks are moved out
+        # into the global python scope they are registered here
+        self.blocks: t.Dict[str, nodes.Block] = {}
+
+        # the number of extends statements so far
+        self.extends_so_far = 0
+
+        # some templates have a rootlevel extends.  In this case we
+        # can safely assume that we're a child template and do some
+        # more optimizations.
+        self.has_known_extends = False
+
+        # the current line number
+        self.code_lineno = 1
+
+        # registry of all filters and tests (global, not block local)
+        self.tests: t.Dict[str, str] = {}
+        self.filters: t.Dict[str, str] = {}
+
+        # the debug information
+        self.debug_info: t.List[t.Tuple[int, int]] = []
+        self._write_debug_info: t.Optional[int] = None
+
+        # the number of new lines before the next write()
+        self._new_lines = 0
+
+        # the line number of the last written statement
+        self._last_line = 0
+
+        # true if nothing was written so far.
+        self._first_write = True
+
+        # used by the `temporary_identifier` method to get new
+        # unique, temporary identifier
+        self._last_identifier = 0
+
+        # the current indentation
+        self._indentation = 0
+
+        # Tracks toplevel assignments
+        self._assign_stack: t.List[t.Set[str]] = []
+
+        # Tracks parameter definition blocks
+        self._param_def_block: t.List[t.Set[str]] = []
+
+        # Tracks the current context.
+        self._context_reference_stack = ["context"]
+
+    @property
+    def optimized(self) -> bool:
+        return self.optimizer is not None
+
+    # -- Various compilation helpers
+
+    def fail(self, msg: str, lineno: int) -> "te.NoReturn":
+        """Fail with a :exc:`TemplateAssertionError`."""
+        raise TemplateAssertionError(msg, lineno, self.name, self.filename)
+
+    def temporary_identifier(self) -> str:
+        """Get a new unique identifier."""
+        self._last_identifier += 1
+        return f"t_{self._last_identifier}"
+
+    def buffer(self, frame: Frame) -> None:
+        """Enable buffering for the frame from that point onwards."""
+        frame.buffer = self.temporary_identifier()
+        self.writeline(f"{frame.buffer} = []")
+
+    def return_buffer_contents(
+        self, frame: Frame, force_unescaped: bool = False
+    ) -> None:
+        """Return the buffer contents of the frame."""
+        if not force_unescaped:
+            if frame.eval_ctx.volatile:
+                self.writeline("if context.eval_ctx.autoescape:")
+                self.indent()
+                self.writeline(f"return Markup(concat({frame.buffer}))")
+                self.outdent()
+                self.writeline("else:")
+                self.indent()
+                self.writeline(f"return concat({frame.buffer})")
+                self.outdent()
+                return
+            elif frame.eval_ctx.autoescape:
+                self.writeline(f"return Markup(concat({frame.buffer}))")
+                return
+        self.writeline(f"return concat({frame.buffer})")
+
+    def indent(self) -> None:
+        """Indent by one."""
+        self._indentation += 1
+
+    def outdent(self, step: int = 1) -> None:
+        """Outdent by step."""
+        self._indentation -= step
+
+    def start_write(self, frame: Frame, node: t.Optional[nodes.Node] = None) -> None:
+        """Yield or write into the frame buffer."""
+        if frame.buffer is None:
+            self.writeline("yield ", node)
+        else:
+            self.writeline(f"{frame.buffer}.append(", node)
+
+    def end_write(self, frame: Frame) -> None:
+        """End the writing process started by `start_write`."""
+        if frame.buffer is not None:
+            self.write(")")
+
+    def simple_write(
+        self, s: str, frame: Frame, node: t.Optional[nodes.Node] = None
+    ) -> None:
+        """Simple shortcut for start_write + write + end_write."""
+        self.start_write(frame, node)
+        self.write(s)
+        self.end_write(frame)
+
+    def blockvisit(self, nodes: t.Iterable[nodes.Node], frame: Frame) -> None:
+        """Visit a list of nodes as block in a frame.  If the current frame
+        is no buffer a dummy ``if 0: yield None`` is written automatically.
+        """
+        try:
+            self.writeline("pass")
+            for node in nodes:
+                self.visit(node, frame)
+        except CompilerExit:
+            pass
+
+    def write(self, x: str) -> None:
+        """Write a string into the output stream."""
+        if self._new_lines:
+            if not self._first_write:
+                self.stream.write("\n" * self._new_lines)
+                self.code_lineno += self._new_lines
+                if self._write_debug_info is not None:
+                    self.debug_info.append((self._write_debug_info, self.code_lineno))
+                    self._write_debug_info = None
+            self._first_write = False
+            self.stream.write("    " * self._indentation)
+            self._new_lines = 0
+        self.stream.write(x)
+
+    def writeline(
+        self, x: str, node: t.Optional[nodes.Node] = None, extra: int = 0
+    ) -> None:
+        """Combination of newline and write."""
+        self.newline(node, extra)
+        self.write(x)
+
+    def newline(self, node: t.Optional[nodes.Node] = None, extra: int = 0) -> None:
+        """Add one or more newlines before the next write."""
+        self._new_lines = max(self._new_lines, 1 + extra)
+        if node is not None and node.lineno != self._last_line:
+            self._write_debug_info = node.lineno
+            self._last_line = node.lineno
+
+    def signature(
+        self,
+        node: t.Union[nodes.Call, nodes.Filter, nodes.Test],
+        frame: Frame,
+        extra_kwargs: t.Optional[t.Mapping[str, t.Any]] = None,
+    ) -> None:
+        """Writes a function call to the stream for the current node.
+        A leading comma is added automatically.  The extra keyword
+        arguments may not include python keywords otherwise a syntax
+        error could occur.  The extra keyword arguments should be given
+        as python dict.
+        """
+        # if any of the given keyword arguments is a python keyword
+        # we have to make sure that no invalid call is created.
+        kwarg_workaround = any(
+            is_python_keyword(t.cast(str, k))
+            for k in chain((x.key for x in node.kwargs), extra_kwargs or ())
+        )
+
+        for arg in node.args:
+            self.write(", ")
+            self.visit(arg, frame)
+
+        if not kwarg_workaround:
+            for kwarg in node.kwargs:
+                self.write(", ")
+                self.visit(kwarg, frame)
+            if extra_kwargs is not None:
+                for key, value in extra_kwargs.items():
+                    self.write(f", {key}={value}")
+        if node.dyn_args:
+            self.write(", *")
+            self.visit(node.dyn_args, frame)
+
+        if kwarg_workaround:
+            if node.dyn_kwargs is not None:
+                self.write(", **dict({")
+            else:
+                self.write(", **{")
+            for kwarg in node.kwargs:
+                self.write(f"{kwarg.key!r}: ")
+                self.visit(kwarg.value, frame)
+                self.write(", ")
+            if extra_kwargs is not None:
+                for key, value in extra_kwargs.items():
+                    self.write(f"{key!r}: {value}, ")
+            if node.dyn_kwargs is not None:
+                self.write("}, **")
+                self.visit(node.dyn_kwargs, frame)
+                self.write(")")
+            else:
+                self.write("}")
+
+        elif node.dyn_kwargs is not None:
+            self.write(", **")
+            self.visit(node.dyn_kwargs, frame)
+
+    def pull_dependencies(self, nodes: t.Iterable[nodes.Node]) -> None:
+        """Find all filter and test names used in the template and
+        assign them to variables in the compiled namespace. Checking
+        that the names are registered with the environment is done when
+        compiling the Filter and Test nodes. If the node is in an If or
+        CondExpr node, the check is done at runtime instead.
+
+        .. versionchanged:: 3.0
+            Filters and tests in If and CondExpr nodes are checked at
+            runtime instead of compile time.
+        """
+        visitor = DependencyFinderVisitor()
+
+        for node in nodes:
+            visitor.visit(node)
+
+        for id_map, names, dependency in (self.filters, visitor.filters, "filters"), (
+            self.tests,
+            visitor.tests,
+            "tests",
+        ):
+            for name in sorted(names):
+                if name not in id_map:
+                    id_map[name] = self.temporary_identifier()
+
+                # add check during runtime that dependencies used inside of executed
+                # blocks are defined, as this step may be skipped during compile time
+                self.writeline("try:")
+                self.indent()
+                self.writeline(f"{id_map[name]} = environment.{dependency}[{name!r}]")
+                self.outdent()
+                self.writeline("except KeyError:")
+                self.indent()
+                self.writeline("@internalcode")
+                self.writeline(f"def {id_map[name]}(*unused):")
+                self.indent()
+                self.writeline(
+                    f'raise TemplateRuntimeError("No {dependency[:-1]}'
+                    f' named {name!r} found.")'
+                )
+                self.outdent()
+                self.outdent()
+
+    def enter_frame(self, frame: Frame) -> None:
+        undefs = []
+        for target, (action, param) in frame.symbols.loads.items():
+            if action == VAR_LOAD_PARAMETER:
+                pass
+            elif action == VAR_LOAD_RESOLVE:
+                self.writeline(f"{target} = {self.get_resolve_func()}({param!r})")
+            elif action == VAR_LOAD_ALIAS:
+                self.writeline(f"{target} = {param}")
+            elif action == VAR_LOAD_UNDEFINED:
+                undefs.append(target)
+            else:
+                raise NotImplementedError("unknown load instruction")
+        if undefs:
+            self.writeline(f"{' = '.join(undefs)} = missing")
+
+    def leave_frame(self, frame: Frame, with_python_scope: bool = False) -> None:
+        if not with_python_scope:
+            undefs = []
+            for target in frame.symbols.loads:
+                undefs.append(target)
+            if undefs:
+                self.writeline(f"{' = '.join(undefs)} = missing")
+
+    def choose_async(self, async_value: str = "async ", sync_value: str = "") -> str:
+        return async_value if self.environment.is_async else sync_value
+
+    def func(self, name: str) -> str:
+        return f"{self.choose_async()}def {name}"
+
+    def macro_body(
+        self, node: t.Union[nodes.Macro, nodes.CallBlock], frame: Frame
+    ) -> t.Tuple[Frame, MacroRef]:
+        """Dump the function def of a macro or call block."""
+        frame = frame.inner()
+        frame.symbols.analyze_node(node)
+        macro_ref = MacroRef(node)
+
+        explicit_caller = None
+        skip_special_params = set()
+        args = []
+
+        for idx, arg in enumerate(node.args):
+            if arg.name == "caller":
+                explicit_caller = idx
+            if arg.name in ("kwargs", "varargs"):
+                skip_special_params.add(arg.name)
+            args.append(frame.symbols.ref(arg.name))
+
+        undeclared = find_undeclared(node.body, ("caller", "kwargs", "varargs"))
+
+        if "caller" in undeclared:
+            # In older Jinja versions there was a bug that allowed caller
+            # to retain the special behavior even if it was mentioned in
+            # the argument list.  However thankfully this was only really
+            # working if it was the last argument.  So we are explicitly
+            # checking this now and error out if it is anywhere else in
+            # the argument list.
+            if explicit_caller is not None:
+                try:
+                    node.defaults[explicit_caller - len(node.args)]
+                except IndexError:
+                    self.fail(
+                        "When defining macros or call blocks the "
+                        'special "caller" argument must be omitted '
+                        "or be given a default.",
+                        node.lineno,
+                    )
+            else:
+                args.append(frame.symbols.declare_parameter("caller"))
+            macro_ref.accesses_caller = True
+        if "kwargs" in undeclared and "kwargs" not in skip_special_params:
+            args.append(frame.symbols.declare_parameter("kwargs"))
+            macro_ref.accesses_kwargs = True
+        if "varargs" in undeclared and "varargs" not in skip_special_params:
+            args.append(frame.symbols.declare_parameter("varargs"))
+            macro_ref.accesses_varargs = True
+
+        # macros are delayed, they never require output checks
+        frame.require_output_check = False
+        frame.symbols.analyze_node(node)
+        self.writeline(f"{self.func('macro')}({', '.join(args)}):", node)
+        self.indent()
+
+        self.buffer(frame)
+        self.enter_frame(frame)
+
+        self.push_parameter_definitions(frame)
+        for idx, arg in enumerate(node.args):
+            ref = frame.symbols.ref(arg.name)
+            self.writeline(f"if {ref} is missing:")
+            self.indent()
+            try:
+                default = node.defaults[idx - len(node.args)]
+            except IndexError:
+                self.writeline(
+                    f'{ref} = undefined("parameter {arg.name!r} was not provided",'
+                    f" name={arg.name!r})"
+                )
+            else:
+                self.writeline(f"{ref} = ")
+                self.visit(default, frame)
+            self.mark_parameter_stored(ref)
+            self.outdent()
+        self.pop_parameter_definitions()
+
+        self.blockvisit(node.body, frame)
+        self.return_buffer_contents(frame, force_unescaped=True)
+        self.leave_frame(frame, with_python_scope=True)
+        self.outdent()
+
+        return frame, macro_ref
+
+    def macro_def(self, macro_ref: MacroRef, frame: Frame) -> None:
+        """Dump the macro definition for the def created by macro_body."""
+        arg_tuple = ", ".join(repr(x.name) for x in macro_ref.node.args)
+        name = getattr(macro_ref.node, "name", None)
+        if len(macro_ref.node.args) == 1:
+            arg_tuple += ","
+        self.write(
+            f"Macro(environment, macro, {name!r}, ({arg_tuple}),"
+            f" {macro_ref.accesses_kwargs!r}, {macro_ref.accesses_varargs!r},"
+            f" {macro_ref.accesses_caller!r}, context.eval_ctx.autoescape)"
+        )
+
+    def position(self, node: nodes.Node) -> str:
+        """Return a human readable position for the node."""
+        rv = f"line {node.lineno}"
+        if self.name is not None:
+            rv = f"{rv} in {self.name!r}"
+        return rv
+
+    def dump_local_context(self, frame: Frame) -> str:
+        items_kv = ", ".join(
+            f"{name!r}: {target}"
+            for name, target in frame.symbols.dump_stores().items()
+        )
+        return f"{{{items_kv}}}"
+
+    def write_commons(self) -> None:
+        """Writes a common preamble that is used by root and block functions.
+        Primarily this sets up common local helpers and enforces a generator
+        through a dead branch.
+        """
+        self.writeline("resolve = context.resolve_or_missing")
+        self.writeline("undefined = environment.undefined")
+        self.writeline("concat = environment.concat")
+        # always use the standard Undefined class for the implicit else of
+        # conditional expressions
+        self.writeline("cond_expr_undefined = Undefined")
+        self.writeline("if 0: yield None")
+
+    def push_parameter_definitions(self, frame: Frame) -> None:
+        """Pushes all parameter targets from the given frame into a local
+        stack that permits tracking of yet to be assigned parameters.  In
+        particular this enables the optimization from `visit_Name` to skip
+        undefined expressions for parameters in macros as macros can reference
+        otherwise unbound parameters.
+        """
+        self._param_def_block.append(frame.symbols.dump_param_targets())
+
+    def pop_parameter_definitions(self) -> None:
+        """Pops the current parameter definitions set."""
+        self._param_def_block.pop()
+
+    def mark_parameter_stored(self, target: str) -> None:
+        """Marks a parameter in the current parameter definitions as stored.
+        This will skip the enforced undefined checks.
+        """
+        if self._param_def_block:
+            self._param_def_block[-1].discard(target)
+
+    def push_context_reference(self, target: str) -> None:
+        self._context_reference_stack.append(target)
+
+    def pop_context_reference(self) -> None:
+        self._context_reference_stack.pop()
+
+    def get_context_ref(self) -> str:
+        return self._context_reference_stack[-1]
+
+    def get_resolve_func(self) -> str:
+        target = self._context_reference_stack[-1]
+        if target == "context":
+            return "resolve"
+        return f"{target}.resolve"
+
+    def derive_context(self, frame: Frame) -> str:
+        return f"{self.get_context_ref()}.derived({self.dump_local_context(frame)})"
+
+    def parameter_is_undeclared(self, target: str) -> bool:
+        """Checks if a given target is an undeclared parameter."""
+        if not self._param_def_block:
+            return False
+        return target in self._param_def_block[-1]
+
+    def push_assign_tracking(self) -> None:
+        """Pushes a new layer for assignment tracking."""
+        self._assign_stack.append(set())
+
+    def pop_assign_tracking(self, frame: Frame) -> None:
+        """Pops the topmost level for assignment tracking and updates the
+        context variables if necessary.
+        """
+        vars = self._assign_stack.pop()
+        if (
+            not frame.block_frame
+            and not frame.loop_frame
+            and not frame.toplevel
+            or not vars
+        ):
+            return
+        public_names = [x for x in vars if x[:1] != "_"]
+        if len(vars) == 1:
+            name = next(iter(vars))
+            ref = frame.symbols.ref(name)
+            if frame.loop_frame:
+                self.writeline(f"_loop_vars[{name!r}] = {ref}")
+                return
+            if frame.block_frame:
+                self.writeline(f"_block_vars[{name!r}] = {ref}")
+                return
+            self.writeline(f"context.vars[{name!r}] = {ref}")
+        else:
+            if frame.loop_frame:
+                self.writeline("_loop_vars.update({")
+            elif frame.block_frame:
+                self.writeline("_block_vars.update({")
+            else:
+                self.writeline("context.vars.update({")
+            for idx, name in enumerate(vars):
+                if idx:
+                    self.write(", ")
+                ref = frame.symbols.ref(name)
+                self.write(f"{name!r}: {ref}")
+            self.write("})")
+        if not frame.block_frame and not frame.loop_frame and public_names:
+            if len(public_names) == 1:
+                self.writeline(f"context.exported_vars.add({public_names[0]!r})")
+            else:
+                names_str = ", ".join(map(repr, public_names))
+                self.writeline(f"context.exported_vars.update(({names_str}))")
+
+    # -- Statement Visitors
+
+    def visit_Template(
+        self, node: nodes.Template, frame: t.Optional[Frame] = None
+    ) -> None:
+        assert frame is None, "no root frame allowed"
+        eval_ctx = EvalContext(self.environment, self.name)
+
+        from .runtime import exported, async_exported
+
+        if self.environment.is_async:
+            exported_names = sorted(exported + async_exported)
+        else:
+            exported_names = sorted(exported)
+
+        self.writeline("from jinja2.runtime import " + ", ".join(exported_names))
+
+        # if we want a deferred initialization we cannot move the
+        # environment into a local name
+        envenv = "" if self.defer_init else ", environment=environment"
+
+        # do we have an extends tag at all?  If not, we can save some
+        # overhead by just not processing any inheritance code.
+        have_extends = node.find(nodes.Extends) is not None
+
+        # find all blocks
+        for block in node.find_all(nodes.Block):
+            if block.name in self.blocks:
+                self.fail(f"block {block.name!r} defined twice", block.lineno)
+            self.blocks[block.name] = block
+
+        # find all imports and import them
+        for import_ in node.find_all(nodes.ImportedName):
+            if import_.importname not in self.import_aliases:
+                imp = import_.importname
+                self.import_aliases[imp] = alias = self.temporary_identifier()
+                if "." in imp:
+                    module, obj = imp.rsplit(".", 1)
+                    self.writeline(f"from {module} import {obj} as {alias}")
+                else:
+                    self.writeline(f"import {imp} as {alias}")
+
+        # add the load name
+        self.writeline(f"name = {self.name!r}")
+
+        # generate the root render function.
+        self.writeline(
+            f"{self.func('root')}(context, missing=missing{envenv}):", extra=1
+        )
+        self.indent()
+        self.write_commons()
+
+        # process the root
+        frame = Frame(eval_ctx)
+        if "self" in find_undeclared(node.body, ("self",)):
+            ref = frame.symbols.declare_parameter("self")
+            self.writeline(f"{ref} = TemplateReference(context)")
+        frame.symbols.analyze_node(node)
+        frame.toplevel = frame.rootlevel = True
+        frame.require_output_check = have_extends and not self.has_known_extends
+        if have_extends:
+            self.writeline("parent_template = None")
+        self.enter_frame(frame)
+        self.pull_dependencies(node.body)
+        self.blockvisit(node.body, frame)
+        self.leave_frame(frame, with_python_scope=True)
+        self.outdent()
+
+        # make sure that the parent root is called.
+        if have_extends:
+            if not self.has_known_extends:
+                self.indent()
+                self.writeline("if parent_template is not None:")
+            self.indent()
+            if not self.environment.is_async:
+                self.writeline("yield from parent_template.root_render_func(context)")
+            else:
+                self.writeline(
+                    "async for event in parent_template.root_render_func(context):"
+                )
+                self.indent()
+                self.writeline("yield event")
+                self.outdent()
+            self.outdent(1 + (not self.has_known_extends))
+
+        # at this point we now have the blocks collected and can visit them too.
+        for name, block in self.blocks.items():
+            self.writeline(
+                f"{self.func('block_' + name)}(context, missing=missing{envenv}):",
+                block,
+                1,
+            )
+            self.indent()
+            self.write_commons()
+            # It's important that we do not make this frame a child of the
+            # toplevel template.  This would cause a variety of
+            # interesting issues with identifier tracking.
+            block_frame = Frame(eval_ctx)
+            block_frame.block_frame = True
+            undeclared = find_undeclared(block.body, ("self", "super"))
+            if "self" in undeclared:
+                ref = block_frame.symbols.declare_parameter("self")
+                self.writeline(f"{ref} = TemplateReference(context)")
+            if "super" in undeclared:
+                ref = block_frame.symbols.declare_parameter("super")
+                self.writeline(f"{ref} = context.super({name!r}, block_{name})")
+            block_frame.symbols.analyze_node(block)
+            block_frame.block = name
+            self.writeline("_block_vars = {}")
+            self.enter_frame(block_frame)
+            self.pull_dependencies(block.body)
+            self.blockvisit(block.body, block_frame)
+            self.leave_frame(block_frame, with_python_scope=True)
+            self.outdent()
+
+        blocks_kv_str = ", ".join(f"{x!r}: block_{x}" for x in self.blocks)
+        self.writeline(f"blocks = {{{blocks_kv_str}}}", extra=1)
+        debug_kv_str = "&".join(f"{k}={v}" for k, v in self.debug_info)
+        self.writeline(f"debug_info = {debug_kv_str!r}")
+
+    def visit_Block(self, node: nodes.Block, frame: Frame) -> None:
+        """Call a block and register it for the template."""
+        level = 0
+        if frame.toplevel:
+            # if we know that we are a child template, there is no need to
+            # check if we are one
+            if self.has_known_extends:
+                return
+            if self.extends_so_far > 0:
+                self.writeline("if parent_template is None:")
+                self.indent()
+                level += 1
+
+        if node.scoped:
+            context = self.derive_context(frame)
+        else:
+            context = self.get_context_ref()
+
+        if node.required:
+            self.writeline(f"if len(context.blocks[{node.name!r}]) <= 1:", node)
+            self.indent()
+            self.writeline(
+                f'raise TemplateRuntimeError("Required block {node.name!r} not found")',
+                node,
+            )
+            self.outdent()
+
+        if not self.environment.is_async and frame.buffer is None:
+            self.writeline(
+                f"yield from context.blocks[{node.name!r}][0]({context})", node
+            )
+        else:
+            self.writeline(
+                f"{self.choose_async()}for event in"
+                f" context.blocks[{node.name!r}][0]({context}):",
+                node,
+            )
+            self.indent()
+            self.simple_write("event", frame)
+            self.outdent()
+
+        self.outdent(level)
+
+    def visit_Extends(self, node: nodes.Extends, frame: Frame) -> None:
+        """Calls the extender."""
+        if not frame.toplevel:
+            self.fail("cannot use extend from a non top-level scope", node.lineno)
+
+        # if the number of extends statements in general is zero so
+        # far, we don't have to add a check if something extended
+        # the template before this one.
+        if self.extends_so_far > 0:
+            # if we have a known extends we just add a template runtime
+            # error into the generated code.  We could catch that at compile
+            # time too, but i welcome it not to confuse users by throwing the
+            # same error at different times just "because we can".
+            if not self.has_known_extends:
+                self.writeline("if parent_template is not None:")
+                self.indent()
+            self.writeline('raise TemplateRuntimeError("extended multiple times")')
+
+            # if we have a known extends already we don't need that code here
+            # as we know that the template execution will end here.
+            if self.has_known_extends:
+                raise CompilerExit()
+            else:
+                self.outdent()
+
+        self.writeline("parent_template = environment.get_template(", node)
+        self.visit(node.template, frame)
+        self.write(f", {self.name!r})")
+        self.writeline("for name, parent_block in parent_template.blocks.items():")
+        self.indent()
+        self.writeline("context.blocks.setdefault(name, []).append(parent_block)")
+        self.outdent()
+
+        # if this extends statement was in the root level we can take
+        # advantage of that information and simplify the generated code
+        # in the top level from this point onwards
+        if frame.rootlevel:
+            self.has_known_extends = True
+
+        # and now we have one more
+        self.extends_so_far += 1
+
+    def visit_Include(self, node: nodes.Include, frame: Frame) -> None:
+        """Handles includes."""
+        if node.ignore_missing:
+            self.writeline("try:")
+            self.indent()
+
+        func_name = "get_or_select_template"
+        if isinstance(node.template, nodes.Const):
+            if isinstance(node.template.value, str):
+                func_name = "get_template"
+            elif isinstance(node.template.value, (tuple, list)):
+                func_name = "select_template"
+        elif isinstance(node.template, (nodes.Tuple, nodes.List)):
+            func_name = "select_template"
+
+        self.writeline(f"template = environment.{func_name}(", node)
+        self.visit(node.template, frame)
+        self.write(f", {self.name!r})")
+        if node.ignore_missing:
+            self.outdent()
+            self.writeline("except TemplateNotFound:")
+            self.indent()
+            self.writeline("pass")
+            self.outdent()
+            self.writeline("else:")
+            self.indent()
+
+        skip_event_yield = False
+        if node.with_context:
+            self.writeline(
+                f"{self.choose_async()}for event in template.root_render_func("
+                "template.new_context(context.get_all(), True,"
+                f" {self.dump_local_context(frame)})):"
+            )
+        elif self.environment.is_async:
+            self.writeline(
+                "for event in (await template._get_default_module_async())"
+                "._body_stream:"
+            )
+        else:
+            self.writeline("yield from template._get_default_module()._body_stream")
+            skip_event_yield = True
+
+        if not skip_event_yield:
+            self.indent()
+            self.simple_write("event", frame)
+            self.outdent()
+
+        if node.ignore_missing:
+            self.outdent()
+
+    def _import_common(
+        self, node: t.Union[nodes.Import, nodes.FromImport], frame: Frame
+    ) -> None:
+        self.write(f"{self.choose_async('await ')}environment.get_template(")
+        self.visit(node.template, frame)
+        self.write(f", {self.name!r}).")
+
+        if node.with_context:
+            f_name = f"make_module{self.choose_async('_async')}"
+            self.write(
+                f"{f_name}(context.get_all(), True, {self.dump_local_context(frame)})"
+            )
+        else:
+            self.write(f"_get_default_module{self.choose_async('_async')}(context)")
+
+    def visit_Import(self, node: nodes.Import, frame: Frame) -> None:
+        """Visit regular imports."""
+        self.writeline(f"{frame.symbols.ref(node.target)} = ", node)
+        if frame.toplevel:
+            self.write(f"context.vars[{node.target!r}] = ")
+
+        self._import_common(node, frame)
+
+        if frame.toplevel and not node.target.startswith("_"):
+            self.writeline(f"context.exported_vars.discard({node.target!r})")
+
+    def visit_FromImport(self, node: nodes.FromImport, frame: Frame) -> None:
+        """Visit named imports."""
+        self.newline(node)
+        self.write("included_template = ")
+        self._import_common(node, frame)
+        var_names = []
+        discarded_names = []
+        for name in node.names:
+            if isinstance(name, tuple):
+                name, alias = name
+            else:
+                alias = name
+            self.writeline(
+                f"{frame.symbols.ref(alias)} ="
+                f" getattr(included_template, {name!r}, missing)"
+            )
+            self.writeline(f"if {frame.symbols.ref(alias)} is missing:")
+            self.indent()
+            message = (
+                "the template {included_template.__name__!r}"
+                f" (imported on {self.position(node)})"
+                f" does not export the requested name {name!r}"
+            )
+            self.writeline(
+                f"{frame.symbols.ref(alias)} = undefined(f{message!r}, name={name!r})"
+            )
+            self.outdent()
+            if frame.toplevel:
+                var_names.append(alias)
+                if not alias.startswith("_"):
+                    discarded_names.append(alias)
+
+        if var_names:
+            if len(var_names) == 1:
+                name = var_names[0]
+                self.writeline(f"context.vars[{name!r}] = {frame.symbols.ref(name)}")
+            else:
+                names_kv = ", ".join(
+                    f"{name!r}: {frame.symbols.ref(name)}" for name in var_names
+                )
+                self.writeline(f"context.vars.update({{{names_kv}}})")
+        if discarded_names:
+            if len(discarded_names) == 1:
+                self.writeline(f"context.exported_vars.discard({discarded_names[0]!r})")
+            else:
+                names_str = ", ".join(map(repr, discarded_names))
+                self.writeline(
+                    f"context.exported_vars.difference_update(({names_str}))"
+                )
+
+    def visit_For(self, node: nodes.For, frame: Frame) -> None:
+        loop_frame = frame.inner()
+        loop_frame.loop_frame = True
+        test_frame = frame.inner()
+        else_frame = frame.inner()
+
+        # try to figure out if we have an extended loop.  An extended loop
+        # is necessary if the loop is in recursive mode if the special loop
+        # variable is accessed in the body if the body is a scoped block.
+        extended_loop = (
+            node.recursive
+            or "loop"
+            in find_undeclared(node.iter_child_nodes(only=("body",)), ("loop",))
+            or any(block.scoped for block in node.find_all(nodes.Block))
+        )
+
+        loop_ref = None
+        if extended_loop:
+            loop_ref = loop_frame.symbols.declare_parameter("loop")
+
+        loop_frame.symbols.analyze_node(node, for_branch="body")
+        if node.else_:
+            else_frame.symbols.analyze_node(node, for_branch="else")
+
+        if node.test:
+            loop_filter_func = self.temporary_identifier()
+            test_frame.symbols.analyze_node(node, for_branch="test")
+            self.writeline(f"{self.func(loop_filter_func)}(fiter):", node.test)
+            self.indent()
+            self.enter_frame(test_frame)
+            self.writeline(self.choose_async("async for ", "for "))
+            self.visit(node.target, loop_frame)
+            self.write(" in ")
+            self.write(self.choose_async("auto_aiter(fiter)", "fiter"))
+            self.write(":")
+            self.indent()
+            self.writeline("if ", node.test)
+            self.visit(node.test, test_frame)
+            self.write(":")
+            self.indent()
+            self.writeline("yield ")
+            self.visit(node.target, loop_frame)
+            self.outdent(3)
+            self.leave_frame(test_frame, with_python_scope=True)
+
+        # if we don't have an recursive loop we have to find the shadowed
+        # variables at that point.  Because loops can be nested but the loop
+        # variable is a special one we have to enforce aliasing for it.
+        if node.recursive:
+            self.writeline(
+                f"{self.func('loop')}(reciter, loop_render_func, depth=0):", node
+            )
+            self.indent()
+            self.buffer(loop_frame)
+
+            # Use the same buffer for the else frame
+            else_frame.buffer = loop_frame.buffer
+
+        # make sure the loop variable is a special one and raise a template
+        # assertion error if a loop tries to write to loop
+        if extended_loop:
+            self.writeline(f"{loop_ref} = missing")
+
+        for name in node.find_all(nodes.Name):
+            if name.ctx == "store" and name.name == "loop":
+                self.fail(
+                    "Can't assign to special loop variable in for-loop target",
+                    name.lineno,
+                )
+
+        if node.else_:
+            iteration_indicator = self.temporary_identifier()
+            self.writeline(f"{iteration_indicator} = 1")
+
+        self.writeline(self.choose_async("async for ", "for "), node)
+        self.visit(node.target, loop_frame)
+        if extended_loop:
+            self.write(f", {loop_ref} in {self.choose_async('Async')}LoopContext(")
+        else:
+            self.write(" in ")
+
+        if node.test:
+            self.write(f"{loop_filter_func}(")
+        if node.recursive:
+            self.write("reciter")
+        else:
+            if self.environment.is_async and not extended_loop:
+                self.write("auto_aiter(")
+            self.visit(node.iter, frame)
+            if self.environment.is_async and not extended_loop:
+                self.write(")")
+        if node.test:
+            self.write(")")
+
+        if node.recursive:
+            self.write(", undefined, loop_render_func, depth):")
+        else:
+            self.write(", undefined):" if extended_loop else ":")
+
+        self.indent()
+        self.enter_frame(loop_frame)
+
+        self.writeline("_loop_vars = {}")
+        self.blockvisit(node.body, loop_frame)
+        if node.else_:
+            self.writeline(f"{iteration_indicator} = 0")
+        self.outdent()
+        self.leave_frame(
+            loop_frame, with_python_scope=node.recursive and not node.else_
+        )
+
+        if node.else_:
+            self.writeline(f"if {iteration_indicator}:")
+            self.indent()
+            self.enter_frame(else_frame)
+            self.blockvisit(node.else_, else_frame)
+            self.leave_frame(else_frame)
+            self.outdent()
+
+        # if the node was recursive we have to return the buffer contents
+        # and start the iteration code
+        if node.recursive:
+            self.return_buffer_contents(loop_frame)
+            self.outdent()
+            self.start_write(frame, node)
+            self.write(f"{self.choose_async('await ')}loop(")
+            if self.environment.is_async:
+                self.write("auto_aiter(")
+            self.visit(node.iter, frame)
+            if self.environment.is_async:
+                self.write(")")
+            self.write(", loop)")
+            self.end_write(frame)
+
+        # at the end of the iteration, clear any assignments made in the
+        # loop from the top level
+        if self._assign_stack:
+            self._assign_stack[-1].difference_update(loop_frame.symbols.stores)
+
+    def visit_If(self, node: nodes.If, frame: Frame) -> None:
+        if_frame = frame.soft()
+        self.writeline("if ", node)
+        self.visit(node.test, if_frame)
+        self.write(":")
+        self.indent()
+        self.blockvisit(node.body, if_frame)
+        self.outdent()
+        for elif_ in node.elif_:
+            self.writeline("elif ", elif_)
+            self.visit(elif_.test, if_frame)
+            self.write(":")
+            self.indent()
+            self.blockvisit(elif_.body, if_frame)
+            self.outdent()
+        if node.else_:
+            self.writeline("else:")
+            self.indent()
+            self.blockvisit(node.else_, if_frame)
+            self.outdent()
+
+    def visit_Macro(self, node: nodes.Macro, frame: Frame) -> None:
+        macro_frame, macro_ref = self.macro_body(node, frame)
+        self.newline()
+        if frame.toplevel:
+            if not node.name.startswith("_"):
+                self.write(f"context.exported_vars.add({node.name!r})")
+            self.writeline(f"context.vars[{node.name!r}] = ")
+        self.write(f"{frame.symbols.ref(node.name)} = ")
+        self.macro_def(macro_ref, macro_frame)
+
+    def visit_CallBlock(self, node: nodes.CallBlock, frame: Frame) -> None:
+        call_frame, macro_ref = self.macro_body(node, frame)
+        self.writeline("caller = ")
+        self.macro_def(macro_ref, call_frame)
+        self.start_write(frame, node)
+        self.visit_Call(node.call, frame, forward_caller=True)
+        self.end_write(frame)
+
+    def visit_FilterBlock(self, node: nodes.FilterBlock, frame: Frame) -> None:
+        filter_frame = frame.inner()
+        filter_frame.symbols.analyze_node(node)
+        self.enter_frame(filter_frame)
+        self.buffer(filter_frame)
+        self.blockvisit(node.body, filter_frame)
+        self.start_write(frame, node)
+        self.visit_Filter(node.filter, filter_frame)
+        self.end_write(frame)
+        self.leave_frame(filter_frame)
+
+    def visit_With(self, node: nodes.With, frame: Frame) -> None:
+        with_frame = frame.inner()
+        with_frame.symbols.analyze_node(node)
+        self.enter_frame(with_frame)
+        for target, expr in zip(node.targets, node.values):
+            self.newline()
+            self.visit(target, with_frame)
+            self.write(" = ")
+            self.visit(expr, frame)
+        self.blockvisit(node.body, with_frame)
+        self.leave_frame(with_frame)
+
+    def visit_ExprStmt(self, node: nodes.ExprStmt, frame: Frame) -> None:
+        self.newline(node)
+        self.visit(node.node, frame)
+
+    class _FinalizeInfo(t.NamedTuple):
+        const: t.Optional[t.Callable[..., str]]
+        src: t.Optional[str]
+
+    @staticmethod
+    def _default_finalize(value: t.Any) -> t.Any:
+        """The default finalize function if the environment isn't
+        configured with one. Or, if the environment has one, this is
+        called on that function's output for constants.
+        """
+        return str(value)
+
+    _finalize: t.Optional[_FinalizeInfo] = None
+
+    def _make_finalize(self) -> _FinalizeInfo:
+        """Build the finalize function to be used on constants and at
+        runtime. Cached so it's only created once for all output nodes.
+
+        Returns a ``namedtuple`` with the following attributes:
+
+        ``const``
+            A function to finalize constant data at compile time.
+
+        ``src``
+            Source code to output around nodes to be evaluated at
+            runtime.
+        """
+        if self._finalize is not None:
+            return self._finalize
+
+        finalize: t.Optional[t.Callable[..., t.Any]]
+        finalize = default = self._default_finalize
+        src = None
+
+        if self.environment.finalize:
+            src = "environment.finalize("
+            env_finalize = self.environment.finalize
+            pass_arg = {
+                _PassArg.context: "context",
+                _PassArg.eval_context: "context.eval_ctx",
+                _PassArg.environment: "environment",
+            }.get(
+                _PassArg.from_obj(env_finalize)  # type: ignore
+            )
+            finalize = None
+
+            if pass_arg is None:
+
+                def finalize(value: t.Any) -> t.Any:  # noqa: F811
+                    return default(env_finalize(value))
+
+            else:
+                src = f"{src}{pass_arg}, "
+
+                if pass_arg == "environment":
+
+                    def finalize(value: t.Any) -> t.Any:  # noqa: F811
+                        return default(env_finalize(self.environment, value))
+
+        self._finalize = self._FinalizeInfo(finalize, src)
+        return self._finalize
+
+    def _output_const_repr(self, group: t.Iterable[t.Any]) -> str:
+        """Given a group of constant values converted from ``Output``
+        child nodes, produce a string to write to the template module
+        source.
+        """
+        return repr(concat(group))
+
+    def _output_child_to_const(
+        self, node: nodes.Expr, frame: Frame, finalize: _FinalizeInfo
+    ) -> str:
+        """Try to optimize a child of an ``Output`` node by trying to
+        convert it to constant, finalized data at compile time.
+
+        If :exc:`Impossible` is raised, the node is not constant and
+        will be evaluated at runtime. Any other exception will also be
+        evaluated at runtime for easier debugging.
+        """
+        const = node.as_const(frame.eval_ctx)
+
+        if frame.eval_ctx.autoescape:
+            const = escape(const)
+
+        # Template data doesn't go through finalize.
+        if isinstance(node, nodes.TemplateData):
+            return str(const)
+
+        return finalize.const(const)  # type: ignore
+
+    def _output_child_pre(
+        self, node: nodes.Expr, frame: Frame, finalize: _FinalizeInfo
+    ) -> None:
+        """Output extra source code before visiting a child of an
+        ``Output`` node.
+        """
+        if frame.eval_ctx.volatile:
+            self.write("(escape if context.eval_ctx.autoescape else str)(")
+        elif frame.eval_ctx.autoescape:
+            self.write("escape(")
+        else:
+            self.write("str(")
+
+        if finalize.src is not None:
+            self.write(finalize.src)
+
+    def _output_child_post(
+        self, node: nodes.Expr, frame: Frame, finalize: _FinalizeInfo
+    ) -> None:
+        """Output extra source code after visiting a child of an
+        ``Output`` node.
+        """
+        self.write(")")
+
+        if finalize.src is not None:
+            self.write(")")
+
+    def visit_Output(self, node: nodes.Output, frame: Frame) -> None:
+        # If an extends is active, don't render outside a block.
+        if frame.require_output_check:
+            # A top-level extends is known to exist at compile time.
+            if self.has_known_extends:
+                return
+
+            self.writeline("if parent_template is None:")
+            self.indent()
+
+        finalize = self._make_finalize()
+        body: t.List[t.Union[t.List[t.Any], nodes.Expr]] = []
+
+        # Evaluate constants at compile time if possible. Each item in
+        # body will be either a list of static data or a node to be
+        # evaluated at runtime.
+        for child in node.nodes:
+            try:
+                if not (
+                    # If the finalize function requires runtime context,
+                    # constants can't be evaluated at compile time.
+                    finalize.const
+                    # Unless it's basic template data that won't be
+                    # finalized anyway.
+                    or isinstance(child, nodes.TemplateData)
+                ):
+                    raise nodes.Impossible()
+
+                const = self._output_child_to_const(child, frame, finalize)
+            except (nodes.Impossible, Exception):
+                # The node was not constant and needs to be evaluated at
+                # runtime. Or another error was raised, which is easier
+                # to debug at runtime.
+                body.append(child)
+                continue
+
+            if body and isinstance(body[-1], list):
+                body[-1].append(const)
+            else:
+                body.append([const])
+
+        if frame.buffer is not None:
+            if len(body) == 1:
+                self.writeline(f"{frame.buffer}.append(")
+            else:
+                self.writeline(f"{frame.buffer}.extend((")
+
+            self.indent()
+
+        for item in body:
+            if isinstance(item, list):
+                # A group of constant data to join and output.
+                val = self._output_const_repr(item)
+
+                if frame.buffer is None:
+                    self.writeline("yield " + val)
+                else:
+                    self.writeline(val + ",")
+            else:
+                if frame.buffer is None:
+                    self.writeline("yield ", item)
+                else:
+                    self.newline(item)
+
+                # A node to be evaluated at runtime.
+                self._output_child_pre(item, frame, finalize)
+                self.visit(item, frame)
+                self._output_child_post(item, frame, finalize)
+
+                if frame.buffer is not None:
+                    self.write(",")
+
+        if frame.buffer is not None:
+            self.outdent()
+            self.writeline(")" if len(body) == 1 else "))")
+
+        if frame.require_output_check:
+            self.outdent()
+
+    def visit_Assign(self, node: nodes.Assign, frame: Frame) -> None:
+        self.push_assign_tracking()
+        self.newline(node)
+        self.visit(node.target, frame)
+        self.write(" = ")
+        self.visit(node.node, frame)
+        self.pop_assign_tracking(frame)
+
+    def visit_AssignBlock(self, node: nodes.AssignBlock, frame: Frame) -> None:
+        self.push_assign_tracking()
+        block_frame = frame.inner()
+        # This is a special case.  Since a set block always captures we
+        # will disable output checks.  This way one can use set blocks
+        # toplevel even in extended templates.
+        block_frame.require_output_check = False
+        block_frame.symbols.analyze_node(node)
+        self.enter_frame(block_frame)
+        self.buffer(block_frame)
+        self.blockvisit(node.body, block_frame)
+        self.newline(node)
+        self.visit(node.target, frame)
+        self.write(" = (Markup if context.eval_ctx.autoescape else identity)(")
+        if node.filter is not None:
+            self.visit_Filter(node.filter, block_frame)
+        else:
+            self.write(f"concat({block_frame.buffer})")
+        self.write(")")
+        self.pop_assign_tracking(frame)
+        self.leave_frame(block_frame)
+
+    # -- Expression Visitors
+
+    def visit_Name(self, node: nodes.Name, frame: Frame) -> None:
+        if node.ctx == "store" and (
+            frame.toplevel or frame.loop_frame or frame.block_frame
+        ):
+            if self._assign_stack:
+                self._assign_stack[-1].add(node.name)
+        ref = frame.symbols.ref(node.name)
+
+        # If we are looking up a variable we might have to deal with the
+        # case where it's undefined.  We can skip that case if the load
+        # instruction indicates a parameter which are always defined.
+        if node.ctx == "load":
+            load = frame.symbols.find_load(ref)
+            if not (
+                load is not None
+                and load[0] == VAR_LOAD_PARAMETER
+                and not self.parameter_is_undeclared(ref)
+            ):
+                self.write(
+                    f"(undefined(name={node.name!r}) if {ref} is missing else {ref})"
+                )
+                return
+
+        self.write(ref)
+
+    def visit_NSRef(self, node: nodes.NSRef, frame: Frame) -> None:
+        # NSRefs can only be used to store values; since they use the normal
+        # `foo.bar` notation they will be parsed as a normal attribute access
+        # when used anywhere but in a `set` context
+        ref = frame.symbols.ref(node.name)
+        self.writeline(f"if not isinstance({ref}, Namespace):")
+        self.indent()
+        self.writeline(
+            "raise TemplateRuntimeError"
+            '("cannot assign attribute on non-namespace object")'
+        )
+        self.outdent()
+        self.writeline(f"{ref}[{node.attr!r}]")
+
+    def visit_Const(self, node: nodes.Const, frame: Frame) -> None:
+        val = node.as_const(frame.eval_ctx)
+        if isinstance(val, float):
+            self.write(str(val))
+        else:
+            self.write(repr(val))
+
+    def visit_TemplateData(self, node: nodes.TemplateData, frame: Frame) -> None:
+        try:
+            self.write(repr(node.as_const(frame.eval_ctx)))
+        except nodes.Impossible:
+            self.write(
+                f"(Markup if context.eval_ctx.autoescape else identity)({node.data!r})"
+            )
+
+    def visit_Tuple(self, node: nodes.Tuple, frame: Frame) -> None:
+        self.write("(")
+        idx = -1
+        for idx, item in enumerate(node.items):
+            if idx:
+                self.write(", ")
+            self.visit(item, frame)
+        self.write(",)" if idx == 0 else ")")
+
+    def visit_List(self, node: nodes.List, frame: Frame) -> None:
+        self.write("[")
+        for idx, item in enumerate(node.items):
+            if idx:
+                self.write(", ")
+            self.visit(item, frame)
+        self.write("]")
+
+    def visit_Dict(self, node: nodes.Dict, frame: Frame) -> None:
+        self.write("{")
+        for idx, item in enumerate(node.items):
+            if idx:
+                self.write(", ")
+            self.visit(item.key, frame)
+            self.write(": ")
+            self.visit(item.value, frame)
+        self.write("}")
+
+    visit_Add = _make_binop("+")
+    visit_Sub = _make_binop("-")
+    visit_Mul = _make_binop("*")
+    visit_Div = _make_binop("/")
+    visit_FloorDiv = _make_binop("//")
+    visit_Pow = _make_binop("**")
+    visit_Mod = _make_binop("%")
+    visit_And = _make_binop("and")
+    visit_Or = _make_binop("or")
+    visit_Pos = _make_unop("+")
+    visit_Neg = _make_unop("-")
+    visit_Not = _make_unop("not ")
+
+    @optimizeconst
+    def visit_Concat(self, node: nodes.Concat, frame: Frame) -> None:
+        if frame.eval_ctx.volatile:
+            func_name = "(markup_join if context.eval_ctx.volatile else str_join)"
+        elif frame.eval_ctx.autoescape:
+            func_name = "markup_join"
+        else:
+            func_name = "str_join"
+        self.write(f"{func_name}((")
+        for arg in node.nodes:
+            self.visit(arg, frame)
+            self.write(", ")
+        self.write("))")
+
+    @optimizeconst
+    def visit_Compare(self, node: nodes.Compare, frame: Frame) -> None:
+        self.write("(")
+        self.visit(node.expr, frame)
+        for op in node.ops:
+            self.visit(op, frame)
+        self.write(")")
+
+    def visit_Operand(self, node: nodes.Operand, frame: Frame) -> None:
+        self.write(f" {operators[node.op]} ")
+        self.visit(node.expr, frame)
+
+    @optimizeconst
+    def visit_Getattr(self, node: nodes.Getattr, frame: Frame) -> None:
+        if self.environment.is_async:
+            self.write("(await auto_await(")
+
+        self.write("environment.getattr(")
+        self.visit(node.node, frame)
+        self.write(f", {node.attr!r})")
+
+        if self.environment.is_async:
+            self.write("))")
+
+    @optimizeconst
+    def visit_Getitem(self, node: nodes.Getitem, frame: Frame) -> None:
+        # slices bypass the environment getitem method.
+        if isinstance(node.arg, nodes.Slice):
+            self.visit(node.node, frame)
+            self.write("[")
+            self.visit(node.arg, frame)
+            self.write("]")
+        else:
+            if self.environment.is_async:
+                self.write("(await auto_await(")
+
+            self.write("environment.getitem(")
+            self.visit(node.node, frame)
+            self.write(", ")
+            self.visit(node.arg, frame)
+            self.write(")")
+
+            if self.environment.is_async:
+                self.write("))")
+
+    def visit_Slice(self, node: nodes.Slice, frame: Frame) -> None:
+        if node.start is not None:
+            self.visit(node.start, frame)
+        self.write(":")
+        if node.stop is not None:
+            self.visit(node.stop, frame)
+        if node.step is not None:
+            self.write(":")
+            self.visit(node.step, frame)
+
+    @contextmanager
+    def _filter_test_common(
+        self, node: t.Union[nodes.Filter, nodes.Test], frame: Frame, is_filter: bool
+    ) -> t.Iterator[None]:
+        if self.environment.is_async:
+            self.write("(await auto_await(")
+
+        if is_filter:
+            self.write(f"{self.filters[node.name]}(")
+            func = self.environment.filters.get(node.name)
+        else:
+            self.write(f"{self.tests[node.name]}(")
+            func = self.environment.tests.get(node.name)
+
+        # When inside an If or CondExpr frame, allow the filter to be
+        # undefined at compile time and only raise an error if it's
+        # actually called at runtime. See pull_dependencies.
+        if func is None and not frame.soft_frame:
+            type_name = "filter" if is_filter else "test"
+            self.fail(f"No {type_name} named {node.name!r}.", node.lineno)
+
+        pass_arg = {
+            _PassArg.context: "context",
+            _PassArg.eval_context: "context.eval_ctx",
+            _PassArg.environment: "environment",
+        }.get(
+            _PassArg.from_obj(func)  # type: ignore
+        )
+
+        if pass_arg is not None:
+            self.write(f"{pass_arg}, ")
+
+        # Back to the visitor function to handle visiting the target of
+        # the filter or test.
+        yield
+
+        self.signature(node, frame)
+        self.write(")")
+
+        if self.environment.is_async:
+            self.write("))")
+
+    @optimizeconst
+    def visit_Filter(self, node: nodes.Filter, frame: Frame) -> None:
+        with self._filter_test_common(node, frame, True):
+            # if the filter node is None we are inside a filter block
+            # and want to write to the current buffer
+            if node.node is not None:
+                self.visit(node.node, frame)
+            elif frame.eval_ctx.volatile:
+                self.write(
+                    f"(Markup(concat({frame.buffer}))"
+                    f" if context.eval_ctx.autoescape else concat({frame.buffer}))"
+                )
+            elif frame.eval_ctx.autoescape:
+                self.write(f"Markup(concat({frame.buffer}))")
+            else:
+                self.write(f"concat({frame.buffer})")
+
+    @optimizeconst
+    def visit_Test(self, node: nodes.Test, frame: Frame) -> None:
+        with self._filter_test_common(node, frame, False):
+            self.visit(node.node, frame)
+
+    @optimizeconst
+    def visit_CondExpr(self, node: nodes.CondExpr, frame: Frame) -> None:
+        frame = frame.soft()
+
+        def write_expr2() -> None:
+            if node.expr2 is not None:
+                self.visit(node.expr2, frame)
+                return
+
+            self.write(
+                f'cond_expr_undefined("the inline if-expression on'
+                f" {self.position(node)} evaluated to false and no else"
+                f' section was defined.")'
+            )
+
+        self.write("(")
+        self.visit(node.expr1, frame)
+        self.write(" if ")
+        self.visit(node.test, frame)
+        self.write(" else ")
+        write_expr2()
+        self.write(")")
+
+    @optimizeconst
+    def visit_Call(
+        self, node: nodes.Call, frame: Frame, forward_caller: bool = False
+    ) -> None:
+        if self.environment.is_async:
+            self.write("(await auto_await(")
+        if self.environment.sandboxed:
+            self.write("environment.call(context, ")
+        else:
+            self.write("context.call(")
+        self.visit(node.node, frame)
+        extra_kwargs = {"caller": "caller"} if forward_caller else None
+        loop_kwargs = {"_loop_vars": "_loop_vars"} if frame.loop_frame else {}
+        block_kwargs = {"_block_vars": "_block_vars"} if frame.block_frame else {}
+        if extra_kwargs:
+            extra_kwargs.update(loop_kwargs, **block_kwargs)
+        elif loop_kwargs or block_kwargs:
+            extra_kwargs = dict(loop_kwargs, **block_kwargs)
+        self.signature(node, frame, extra_kwargs)
+        self.write(")")
+        if self.environment.is_async:
+            self.write("))")
+
+    def visit_Keyword(self, node: nodes.Keyword, frame: Frame) -> None:
+        self.write(node.key + "=")
+        self.visit(node.value, frame)
+
+    # -- Unused nodes for extensions
+
+    def visit_MarkSafe(self, node: nodes.MarkSafe, frame: Frame) -> None:
+        self.write("Markup(")
+        self.visit(node.expr, frame)
+        self.write(")")
+
+    def visit_MarkSafeIfAutoescape(
+        self, node: nodes.MarkSafeIfAutoescape, frame: Frame
+    ) -> None:
+        self.write("(Markup if context.eval_ctx.autoescape else identity)(")
+        self.visit(node.expr, frame)
+        self.write(")")
+
+    def visit_EnvironmentAttribute(
+        self, node: nodes.EnvironmentAttribute, frame: Frame
+    ) -> None:
+        self.write("environment." + node.name)
+
+    def visit_ExtensionAttribute(
+        self, node: nodes.ExtensionAttribute, frame: Frame
+    ) -> None:
+        self.write(f"environment.extensions[{node.identifier!r}].{node.name}")
+
+    def visit_ImportedName(self, node: nodes.ImportedName, frame: Frame) -> None:
+        self.write(self.import_aliases[node.importname])
+
+    def visit_InternalName(self, node: nodes.InternalName, frame: Frame) -> None:
+        self.write(node.name)
+
+    def visit_ContextReference(
+        self, node: nodes.ContextReference, frame: Frame
+    ) -> None:
+        self.write("context")
+
+    def visit_DerivedContextReference(
+        self, node: nodes.DerivedContextReference, frame: Frame
+    ) -> None:
+        self.write(self.derive_context(frame))
+
+    def visit_Continue(self, node: nodes.Continue, frame: Frame) -> None:
+        self.writeline("continue", node)
+
+    def visit_Break(self, node: nodes.Break, frame: Frame) -> None:
+        self.writeline("break", node)
+
+    def visit_Scope(self, node: nodes.Scope, frame: Frame) -> None:
+        scope_frame = frame.inner()
+        scope_frame.symbols.analyze_node(node)
+        self.enter_frame(scope_frame)
+        self.blockvisit(node.body, scope_frame)
+        self.leave_frame(scope_frame)
+
+    def visit_OverlayScope(self, node: nodes.OverlayScope, frame: Frame) -> None:
+        ctx = self.temporary_identifier()
+        self.writeline(f"{ctx} = {self.derive_context(frame)}")
+        self.writeline(f"{ctx}.vars = ")
+        self.visit(node.context, frame)
+        self.push_context_reference(ctx)
+
+        scope_frame = frame.inner(isolated=True)
+        scope_frame.symbols.analyze_node(node)
+        self.enter_frame(scope_frame)
+        self.blockvisit(node.body, scope_frame)
+        self.leave_frame(scope_frame)
+        self.pop_context_reference()
+
+    def visit_EvalContextModifier(
+        self, node: nodes.EvalContextModifier, frame: Frame
+    ) -> None:
+        for keyword in node.options:
+            self.writeline(f"context.eval_ctx.{keyword.key} = ")
+            self.visit(keyword.value, frame)
+            try:
+                val = keyword.value.as_const(frame.eval_ctx)
+            except nodes.Impossible:
+                frame.eval_ctx.volatile = True
+            else:
+                setattr(frame.eval_ctx, keyword.key, val)
+
+    def visit_ScopedEvalContextModifier(
+        self, node: nodes.ScopedEvalContextModifier, frame: Frame
+    ) -> None:
+        old_ctx_name = self.temporary_identifier()
+        saved_ctx = frame.eval_ctx.save()
+        self.writeline(f"{old_ctx_name} = context.eval_ctx.save()")
+        self.visit_EvalContextModifier(node, frame)
+        for child in node.body:
+            self.visit(child, frame)
+        frame.eval_ctx.revert(saved_ctx)
+        self.writeline(f"context.eval_ctx.revert({old_ctx_name})")
diff --git a/llm/Lib/site-packages/jinja2/constants.py b/llm/Lib/site-packages/jinja2/constants.py
new file mode 100644
index 0000000000000000000000000000000000000000..41a1c23b0a7fe134b1f662545876eb65b31b071e
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/constants.py
@@ -0,0 +1,20 @@
+#: list of lorem ipsum words used by the lipsum() helper function
+LOREM_IPSUM_WORDS = """\
+a ac accumsan ad adipiscing aenean aliquam aliquet amet ante aptent arcu at
+auctor augue bibendum blandit class commodo condimentum congue consectetuer
+consequat conubia convallis cras cubilia cum curabitur curae cursus dapibus
+diam dictum dictumst dignissim dis dolor donec dui duis egestas eget eleifend
+elementum elit enim erat eros est et etiam eu euismod facilisi facilisis fames
+faucibus felis fermentum feugiat fringilla fusce gravida habitant habitasse hac
+hendrerit hymenaeos iaculis id imperdiet in inceptos integer interdum ipsum
+justo lacinia lacus laoreet lectus leo libero ligula litora lobortis lorem
+luctus maecenas magna magnis malesuada massa mattis mauris metus mi molestie
+mollis montes morbi mus nam nascetur natoque nec neque netus nibh nisi nisl non
+nonummy nostra nulla nullam nunc odio orci ornare parturient pede pellentesque
+penatibus per pharetra phasellus placerat platea porta porttitor posuere
+potenti praesent pretium primis proin pulvinar purus quam quis quisque rhoncus
+ridiculus risus rutrum sagittis sapien scelerisque sed sem semper senectus sit
+sociis sociosqu sodales sollicitudin suscipit suspendisse taciti tellus tempor
+tempus tincidunt torquent tortor tristique turpis ullamcorper ultrices
+ultricies urna ut varius vehicula vel velit venenatis vestibulum vitae vivamus
+viverra volutpat vulputate"""
diff --git a/llm/Lib/site-packages/jinja2/debug.py b/llm/Lib/site-packages/jinja2/debug.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ed7e9297e01b87c4e999d19d48a4265b38b574f
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/debug.py
@@ -0,0 +1,191 @@
+import sys
+import typing as t
+from types import CodeType
+from types import TracebackType
+
+from .exceptions import TemplateSyntaxError
+from .utils import internal_code
+from .utils import missing
+
+if t.TYPE_CHECKING:
+    from .runtime import Context
+
+
+def rewrite_traceback_stack(source: t.Optional[str] = None) -> BaseException:
+    """Rewrite the current exception to replace any tracebacks from
+    within compiled template code with tracebacks that look like they
+    came from the template source.
+
+    This must be called within an ``except`` block.
+
+    :param source: For ``TemplateSyntaxError``, the original source if
+        known.
+    :return: The original exception with the rewritten traceback.
+    """
+    _, exc_value, tb = sys.exc_info()
+    exc_value = t.cast(BaseException, exc_value)
+    tb = t.cast(TracebackType, tb)
+
+    if isinstance(exc_value, TemplateSyntaxError) and not exc_value.translated:
+        exc_value.translated = True
+        exc_value.source = source
+        # Remove the old traceback, otherwise the frames from the
+        # compiler still show up.
+        exc_value.with_traceback(None)
+        # Outside of runtime, so the frame isn't executing template
+        # code, but it still needs to point at the template.
+        tb = fake_traceback(
+            exc_value, None, exc_value.filename or "<unknown>", exc_value.lineno
+        )
+    else:
+        # Skip the frame for the render function.
+        tb = tb.tb_next
+
+    stack = []
+
+    # Build the stack of traceback object, replacing any in template
+    # code with the source file and line information.
+    while tb is not None:
+        # Skip frames decorated with @internalcode. These are internal
+        # calls that aren't useful in template debugging output.
+        if tb.tb_frame.f_code in internal_code:
+            tb = tb.tb_next
+            continue
+
+        template = tb.tb_frame.f_globals.get("__jinja_template__")
+
+        if template is not None:
+            lineno = template.get_corresponding_lineno(tb.tb_lineno)
+            fake_tb = fake_traceback(exc_value, tb, template.filename, lineno)
+            stack.append(fake_tb)
+        else:
+            stack.append(tb)
+
+        tb = tb.tb_next
+
+    tb_next = None
+
+    # Assign tb_next in reverse to avoid circular references.
+    for tb in reversed(stack):
+        tb.tb_next = tb_next
+        tb_next = tb
+
+    return exc_value.with_traceback(tb_next)
+
+
+def fake_traceback(  # type: ignore
+    exc_value: BaseException, tb: t.Optional[TracebackType], filename: str, lineno: int
+) -> TracebackType:
+    """Produce a new traceback object that looks like it came from the
+    template source instead of the compiled code. The filename, line
+    number, and location name will point to the template, and the local
+    variables will be the current template context.
+
+    :param exc_value: The original exception to be re-raised to create
+        the new traceback.
+    :param tb: The original traceback to get the local variables and
+        code info from.
+    :param filename: The template filename.
+    :param lineno: The line number in the template source.
+    """
+    if tb is not None:
+        # Replace the real locals with the context that would be
+        # available at that point in the template.
+        locals = get_template_locals(tb.tb_frame.f_locals)
+        locals.pop("__jinja_exception__", None)
+    else:
+        locals = {}
+
+    globals = {
+        "__name__": filename,
+        "__file__": filename,
+        "__jinja_exception__": exc_value,
+    }
+    # Raise an exception at the correct line number.
+    code: CodeType = compile(
+        "\n" * (lineno - 1) + "raise __jinja_exception__", filename, "exec"
+    )
+
+    # Build a new code object that points to the template file and
+    # replaces the location with a block name.
+    location = "template"
+
+    if tb is not None:
+        function = tb.tb_frame.f_code.co_name
+
+        if function == "root":
+            location = "top-level template code"
+        elif function.startswith("block_"):
+            location = f"block {function[6:]!r}"
+
+    if sys.version_info >= (3, 8):
+        code = code.replace(co_name=location)
+    else:
+        code = CodeType(
+            code.co_argcount,
+            code.co_kwonlyargcount,
+            code.co_nlocals,
+            code.co_stacksize,
+            code.co_flags,
+            code.co_code,
+            code.co_consts,
+            code.co_names,
+            code.co_varnames,
+            code.co_filename,
+            location,
+            code.co_firstlineno,
+            code.co_lnotab,
+            code.co_freevars,
+            code.co_cellvars,
+        )
+
+    # Execute the new code, which is guaranteed to raise, and return
+    # the new traceback without this frame.
+    try:
+        exec(code, globals, locals)
+    except BaseException:
+        return sys.exc_info()[2].tb_next  # type: ignore
+
+
+def get_template_locals(real_locals: t.Mapping[str, t.Any]) -> t.Dict[str, t.Any]:
+    """Based on the runtime locals, get the context that would be
+    available at that point in the template.
+    """
+    # Start with the current template context.
+    ctx: "t.Optional[Context]" = real_locals.get("context")
+
+    if ctx is not None:
+        data: t.Dict[str, t.Any] = ctx.get_all().copy()
+    else:
+        data = {}
+
+    # Might be in a derived context that only sets local variables
+    # rather than pushing a context. Local variables follow the scheme
+    # l_depth_name. Find the highest-depth local that has a value for
+    # each name.
+    local_overrides: t.Dict[str, t.Tuple[int, t.Any]] = {}
+
+    for name, value in real_locals.items():
+        if not name.startswith("l_") or value is missing:
+            # Not a template variable, or no longer relevant.
+            continue
+
+        try:
+            _, depth_str, name = name.split("_", 2)
+            depth = int(depth_str)
+        except ValueError:
+            continue
+
+        cur_depth = local_overrides.get(name, (-1,))[0]
+
+        if cur_depth < depth:
+            local_overrides[name] = (depth, value)
+
+    # Modify the context with any derived context.
+    for name, (_, value) in local_overrides.items():
+        if value is missing:
+            data.pop(name, None)
+        else:
+            data[name] = value
+
+    return data
diff --git a/llm/Lib/site-packages/jinja2/defaults.py b/llm/Lib/site-packages/jinja2/defaults.py
new file mode 100644
index 0000000000000000000000000000000000000000..638cad3d2d8907330bde56e2b76c9b185c523b45
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/defaults.py
@@ -0,0 +1,48 @@
+import typing as t
+
+from .filters import FILTERS as DEFAULT_FILTERS  # noqa: F401
+from .tests import TESTS as DEFAULT_TESTS  # noqa: F401
+from .utils import Cycler
+from .utils import generate_lorem_ipsum
+from .utils import Joiner
+from .utils import Namespace
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+
+# defaults for the parser / lexer
+BLOCK_START_STRING = "{%"
+BLOCK_END_STRING = "%}"
+VARIABLE_START_STRING = "{{"
+VARIABLE_END_STRING = "}}"
+COMMENT_START_STRING = "{#"
+COMMENT_END_STRING = "#}"
+LINE_STATEMENT_PREFIX: t.Optional[str] = None
+LINE_COMMENT_PREFIX: t.Optional[str] = None
+TRIM_BLOCKS = False
+LSTRIP_BLOCKS = False
+NEWLINE_SEQUENCE: "te.Literal['\\n', '\\r\\n', '\\r']" = "\n"
+KEEP_TRAILING_NEWLINE = False
+
+# default filters, tests and namespace
+
+DEFAULT_NAMESPACE = {
+    "range": range,
+    "dict": dict,
+    "lipsum": generate_lorem_ipsum,
+    "cycler": Cycler,
+    "joiner": Joiner,
+    "namespace": Namespace,
+}
+
+# default policies
+DEFAULT_POLICIES: t.Dict[str, t.Any] = {
+    "compiler.ascii_str": True,
+    "urlize.rel": "noopener",
+    "urlize.target": None,
+    "urlize.extra_schemes": None,
+    "truncate.leeway": 5,
+    "json.dumps_function": None,
+    "json.dumps_kwargs": {"sort_keys": True},
+    "ext.i18n.trimmed": False,
+}
diff --git a/llm/Lib/site-packages/jinja2/environment.py b/llm/Lib/site-packages/jinja2/environment.py
new file mode 100644
index 0000000000000000000000000000000000000000..185d33246e395cc9a905bf7a05e5abdf1a1bbe5e
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/environment.py
@@ -0,0 +1,1667 @@
+"""Classes for managing templates and their runtime and compile time
+options.
+"""
+import os
+import typing
+import typing as t
+import weakref
+from collections import ChainMap
+from functools import lru_cache
+from functools import partial
+from functools import reduce
+from types import CodeType
+
+from markupsafe import Markup
+
+from . import nodes
+from .compiler import CodeGenerator
+from .compiler import generate
+from .defaults import BLOCK_END_STRING
+from .defaults import BLOCK_START_STRING
+from .defaults import COMMENT_END_STRING
+from .defaults import COMMENT_START_STRING
+from .defaults import DEFAULT_FILTERS
+from .defaults import DEFAULT_NAMESPACE
+from .defaults import DEFAULT_POLICIES
+from .defaults import DEFAULT_TESTS
+from .defaults import KEEP_TRAILING_NEWLINE
+from .defaults import LINE_COMMENT_PREFIX
+from .defaults import LINE_STATEMENT_PREFIX
+from .defaults import LSTRIP_BLOCKS
+from .defaults import NEWLINE_SEQUENCE
+from .defaults import TRIM_BLOCKS
+from .defaults import VARIABLE_END_STRING
+from .defaults import VARIABLE_START_STRING
+from .exceptions import TemplateNotFound
+from .exceptions import TemplateRuntimeError
+from .exceptions import TemplatesNotFound
+from .exceptions import TemplateSyntaxError
+from .exceptions import UndefinedError
+from .lexer import get_lexer
+from .lexer import Lexer
+from .lexer import TokenStream
+from .nodes import EvalContext
+from .parser import Parser
+from .runtime import Context
+from .runtime import new_context
+from .runtime import Undefined
+from .utils import _PassArg
+from .utils import concat
+from .utils import consume
+from .utils import import_string
+from .utils import internalcode
+from .utils import LRUCache
+from .utils import missing
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+    from .bccache import BytecodeCache
+    from .ext import Extension
+    from .loaders import BaseLoader
+
+_env_bound = t.TypeVar("_env_bound", bound="Environment")
+
+
+# for direct template usage we have up to ten living environments
+@lru_cache(maxsize=10)
+def get_spontaneous_environment(cls: t.Type[_env_bound], *args: t.Any) -> _env_bound:
+    """Return a new spontaneous environment. A spontaneous environment
+    is used for templates created directly rather than through an
+    existing environment.
+
+    :param cls: Environment class to create.
+    :param args: Positional arguments passed to environment.
+    """
+    env = cls(*args)
+    env.shared = True
+    return env
+
+
+def create_cache(
+    size: int,
+) -> t.Optional[t.MutableMapping[t.Tuple[weakref.ref, str], "Template"]]:
+    """Return the cache class for the given size."""
+    if size == 0:
+        return None
+
+    if size < 0:
+        return {}
+
+    return LRUCache(size)  # type: ignore
+
+
+def copy_cache(
+    cache: t.Optional[t.MutableMapping],
+) -> t.Optional[t.MutableMapping[t.Tuple[weakref.ref, str], "Template"]]:
+    """Create an empty copy of the given cache."""
+    if cache is None:
+        return None
+
+    if type(cache) is dict:
+        return {}
+
+    return LRUCache(cache.capacity)  # type: ignore
+
+
+def load_extensions(
+    environment: "Environment",
+    extensions: t.Sequence[t.Union[str, t.Type["Extension"]]],
+) -> t.Dict[str, "Extension"]:
+    """Load the extensions from the list and bind it to the environment.
+    Returns a dict of instantiated extensions.
+    """
+    result = {}
+
+    for extension in extensions:
+        if isinstance(extension, str):
+            extension = t.cast(t.Type["Extension"], import_string(extension))
+
+        result[extension.identifier] = extension(environment)
+
+    return result
+
+
+def _environment_config_check(environment: "Environment") -> "Environment":
+    """Perform a sanity check on the environment."""
+    assert issubclass(
+        environment.undefined, Undefined
+    ), "'undefined' must be a subclass of 'jinja2.Undefined'."
+    assert (
+        environment.block_start_string
+        != environment.variable_start_string
+        != environment.comment_start_string
+    ), "block, variable and comment start strings must be different."
+    assert environment.newline_sequence in {
+        "\r",
+        "\r\n",
+        "\n",
+    }, "'newline_sequence' must be one of '\\n', '\\r\\n', or '\\r'."
+    return environment
+
+
+class Environment:
+    r"""The core component of Jinja is the `Environment`.  It contains
+    important shared variables like configuration, filters, tests,
+    globals and others.  Instances of this class may be modified if
+    they are not shared and if no template was loaded so far.
+    Modifications on environments after the first template was loaded
+    will lead to surprising effects and undefined behavior.
+
+    Here are the possible initialization parameters:
+
+        `block_start_string`
+            The string marking the beginning of a block.  Defaults to ``'{%'``.
+
+        `block_end_string`
+            The string marking the end of a block.  Defaults to ``'%}'``.
+
+        `variable_start_string`
+            The string marking the beginning of a print statement.
+            Defaults to ``'{{'``.
+
+        `variable_end_string`
+            The string marking the end of a print statement.  Defaults to
+            ``'}}'``.
+
+        `comment_start_string`
+            The string marking the beginning of a comment.  Defaults to ``'{#'``.
+
+        `comment_end_string`
+            The string marking the end of a comment.  Defaults to ``'#}'``.
+
+        `line_statement_prefix`
+            If given and a string, this will be used as prefix for line based
+            statements.  See also :ref:`line-statements`.
+
+        `line_comment_prefix`
+            If given and a string, this will be used as prefix for line based
+            comments.  See also :ref:`line-statements`.
+
+            .. versionadded:: 2.2
+
+        `trim_blocks`
+            If this is set to ``True`` the first newline after a block is
+            removed (block, not variable tag!).  Defaults to `False`.
+
+        `lstrip_blocks`
+            If this is set to ``True`` leading spaces and tabs are stripped
+            from the start of a line to a block.  Defaults to `False`.
+
+        `newline_sequence`
+            The sequence that starts a newline.  Must be one of ``'\r'``,
+            ``'\n'`` or ``'\r\n'``.  The default is ``'\n'`` which is a
+            useful default for Linux and OS X systems as well as web
+            applications.
+
+        `keep_trailing_newline`
+            Preserve the trailing newline when rendering templates.
+            The default is ``False``, which causes a single newline,
+            if present, to be stripped from the end of the template.
+
+            .. versionadded:: 2.7
+
+        `extensions`
+            List of Jinja extensions to use.  This can either be import paths
+            as strings or extension classes.  For more information have a
+            look at :ref:`the extensions documentation <jinja-extensions>`.
+
+        `optimized`
+            should the optimizer be enabled?  Default is ``True``.
+
+        `undefined`
+            :class:`Undefined` or a subclass of it that is used to represent
+            undefined values in the template.
+
+        `finalize`
+            A callable that can be used to process the result of a variable
+            expression before it is output.  For example one can convert
+            ``None`` implicitly into an empty string here.
+
+        `autoescape`
+            If set to ``True`` the XML/HTML autoescaping feature is enabled by
+            default.  For more details about autoescaping see
+            :class:`~markupsafe.Markup`.  As of Jinja 2.4 this can also
+            be a callable that is passed the template name and has to
+            return ``True`` or ``False`` depending on autoescape should be
+            enabled by default.
+
+            .. versionchanged:: 2.4
+               `autoescape` can now be a function
+
+        `loader`
+            The template loader for this environment.
+
+        `cache_size`
+            The size of the cache.  Per default this is ``400`` which means
+            that if more than 400 templates are loaded the loader will clean
+            out the least recently used template.  If the cache size is set to
+            ``0`` templates are recompiled all the time, if the cache size is
+            ``-1`` the cache will not be cleaned.
+
+            .. versionchanged:: 2.8
+               The cache size was increased to 400 from a low 50.
+
+        `auto_reload`
+            Some loaders load templates from locations where the template
+            sources may change (ie: file system or database).  If
+            ``auto_reload`` is set to ``True`` (default) every time a template is
+            requested the loader checks if the source changed and if yes, it
+            will reload the template.  For higher performance it's possible to
+            disable that.
+
+        `bytecode_cache`
+            If set to a bytecode cache object, this object will provide a
+            cache for the internal Jinja bytecode so that templates don't
+            have to be parsed if they were not changed.
+
+            See :ref:`bytecode-cache` for more information.
+
+        `enable_async`
+            If set to true this enables async template execution which
+            allows using async functions and generators.
+    """
+
+    #: if this environment is sandboxed.  Modifying this variable won't make
+    #: the environment sandboxed though.  For a real sandboxed environment
+    #: have a look at jinja2.sandbox.  This flag alone controls the code
+    #: generation by the compiler.
+    sandboxed = False
+
+    #: True if the environment is just an overlay
+    overlayed = False
+
+    #: the environment this environment is linked to if it is an overlay
+    linked_to: t.Optional["Environment"] = None
+
+    #: shared environments have this set to `True`.  A shared environment
+    #: must not be modified
+    shared = False
+
+    #: the class that is used for code generation.  See
+    #: :class:`~jinja2.compiler.CodeGenerator` for more information.
+    code_generator_class: t.Type["CodeGenerator"] = CodeGenerator
+
+    concat = "".join
+
+    #: the context class that is used for templates.  See
+    #: :class:`~jinja2.runtime.Context` for more information.
+    context_class: t.Type[Context] = Context
+
+    template_class: t.Type["Template"]
+
+    def __init__(
+        self,
+        block_start_string: str = BLOCK_START_STRING,
+        block_end_string: str = BLOCK_END_STRING,
+        variable_start_string: str = VARIABLE_START_STRING,
+        variable_end_string: str = VARIABLE_END_STRING,
+        comment_start_string: str = COMMENT_START_STRING,
+        comment_end_string: str = COMMENT_END_STRING,
+        line_statement_prefix: t.Optional[str] = LINE_STATEMENT_PREFIX,
+        line_comment_prefix: t.Optional[str] = LINE_COMMENT_PREFIX,
+        trim_blocks: bool = TRIM_BLOCKS,
+        lstrip_blocks: bool = LSTRIP_BLOCKS,
+        newline_sequence: "te.Literal['\\n', '\\r\\n', '\\r']" = NEWLINE_SEQUENCE,
+        keep_trailing_newline: bool = KEEP_TRAILING_NEWLINE,
+        extensions: t.Sequence[t.Union[str, t.Type["Extension"]]] = (),
+        optimized: bool = True,
+        undefined: t.Type[Undefined] = Undefined,
+        finalize: t.Optional[t.Callable[..., t.Any]] = None,
+        autoescape: t.Union[bool, t.Callable[[t.Optional[str]], bool]] = False,
+        loader: t.Optional["BaseLoader"] = None,
+        cache_size: int = 400,
+        auto_reload: bool = True,
+        bytecode_cache: t.Optional["BytecodeCache"] = None,
+        enable_async: bool = False,
+    ):
+        # !!Important notice!!
+        #   The constructor accepts quite a few arguments that should be
+        #   passed by keyword rather than position.  However it's important to
+        #   not change the order of arguments because it's used at least
+        #   internally in those cases:
+        #       -   spontaneous environments (i18n extension and Template)
+        #       -   unittests
+        #   If parameter changes are required only add parameters at the end
+        #   and don't change the arguments (or the defaults!) of the arguments
+        #   existing already.
+
+        # lexer / parser information
+        self.block_start_string = block_start_string
+        self.block_end_string = block_end_string
+        self.variable_start_string = variable_start_string
+        self.variable_end_string = variable_end_string
+        self.comment_start_string = comment_start_string
+        self.comment_end_string = comment_end_string
+        self.line_statement_prefix = line_statement_prefix
+        self.line_comment_prefix = line_comment_prefix
+        self.trim_blocks = trim_blocks
+        self.lstrip_blocks = lstrip_blocks
+        self.newline_sequence = newline_sequence
+        self.keep_trailing_newline = keep_trailing_newline
+
+        # runtime information
+        self.undefined: t.Type[Undefined] = undefined
+        self.optimized = optimized
+        self.finalize = finalize
+        self.autoescape = autoescape
+
+        # defaults
+        self.filters = DEFAULT_FILTERS.copy()
+        self.tests = DEFAULT_TESTS.copy()
+        self.globals = DEFAULT_NAMESPACE.copy()
+
+        # set the loader provided
+        self.loader = loader
+        self.cache = create_cache(cache_size)
+        self.bytecode_cache = bytecode_cache
+        self.auto_reload = auto_reload
+
+        # configurable policies
+        self.policies = DEFAULT_POLICIES.copy()
+
+        # load extensions
+        self.extensions = load_extensions(self, extensions)
+
+        self.is_async = enable_async
+        _environment_config_check(self)
+
+    def add_extension(self, extension: t.Union[str, t.Type["Extension"]]) -> None:
+        """Adds an extension after the environment was created.
+
+        .. versionadded:: 2.5
+        """
+        self.extensions.update(load_extensions(self, [extension]))
+
+    def extend(self, **attributes: t.Any) -> None:
+        """Add the items to the instance of the environment if they do not exist
+        yet.  This is used by :ref:`extensions <writing-extensions>` to register
+        callbacks and configuration values without breaking inheritance.
+        """
+        for key, value in attributes.items():
+            if not hasattr(self, key):
+                setattr(self, key, value)
+
+    def overlay(
+        self,
+        block_start_string: str = missing,
+        block_end_string: str = missing,
+        variable_start_string: str = missing,
+        variable_end_string: str = missing,
+        comment_start_string: str = missing,
+        comment_end_string: str = missing,
+        line_statement_prefix: t.Optional[str] = missing,
+        line_comment_prefix: t.Optional[str] = missing,
+        trim_blocks: bool = missing,
+        lstrip_blocks: bool = missing,
+        newline_sequence: "te.Literal['\\n', '\\r\\n', '\\r']" = missing,
+        keep_trailing_newline: bool = missing,
+        extensions: t.Sequence[t.Union[str, t.Type["Extension"]]] = missing,
+        optimized: bool = missing,
+        undefined: t.Type[Undefined] = missing,
+        finalize: t.Optional[t.Callable[..., t.Any]] = missing,
+        autoescape: t.Union[bool, t.Callable[[t.Optional[str]], bool]] = missing,
+        loader: t.Optional["BaseLoader"] = missing,
+        cache_size: int = missing,
+        auto_reload: bool = missing,
+        bytecode_cache: t.Optional["BytecodeCache"] = missing,
+        enable_async: bool = False,
+    ) -> "Environment":
+        """Create a new overlay environment that shares all the data with the
+        current environment except for cache and the overridden attributes.
+        Extensions cannot be removed for an overlayed environment.  An overlayed
+        environment automatically gets all the extensions of the environment it
+        is linked to plus optional extra extensions.
+
+        Creating overlays should happen after the initial environment was set
+        up completely.  Not all attributes are truly linked, some are just
+        copied over so modifications on the original environment may not shine
+        through.
+
+        .. versionchanged:: 3.1.2
+            Added the ``newline_sequence``,, ``keep_trailing_newline``,
+            and ``enable_async`` parameters to match ``__init__``.
+        """
+        args = dict(locals())
+        del args["self"], args["cache_size"], args["extensions"], args["enable_async"]
+
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.overlayed = True
+        rv.linked_to = self
+
+        for key, value in args.items():
+            if value is not missing:
+                setattr(rv, key, value)
+
+        if cache_size is not missing:
+            rv.cache = create_cache(cache_size)
+        else:
+            rv.cache = copy_cache(self.cache)
+
+        rv.extensions = {}
+        for key, value in self.extensions.items():
+            rv.extensions[key] = value.bind(rv)
+        if extensions is not missing:
+            rv.extensions.update(load_extensions(rv, extensions))
+
+        if enable_async is not missing:
+            rv.is_async = enable_async
+
+        return _environment_config_check(rv)
+
+    @property
+    def lexer(self) -> Lexer:
+        """The lexer for this environment."""
+        return get_lexer(self)
+
+    def iter_extensions(self) -> t.Iterator["Extension"]:
+        """Iterates over the extensions by priority."""
+        return iter(sorted(self.extensions.values(), key=lambda x: x.priority))
+
+    def getitem(
+        self, obj: t.Any, argument: t.Union[str, t.Any]
+    ) -> t.Union[t.Any, Undefined]:
+        """Get an item or attribute of an object but prefer the item."""
+        try:
+            return obj[argument]
+        except (AttributeError, TypeError, LookupError):
+            if isinstance(argument, str):
+                try:
+                    attr = str(argument)
+                except Exception:
+                    pass
+                else:
+                    try:
+                        return getattr(obj, attr)
+                    except AttributeError:
+                        pass
+            return self.undefined(obj=obj, name=argument)
+
+    def getattr(self, obj: t.Any, attribute: str) -> t.Any:
+        """Get an item or attribute of an object but prefer the attribute.
+        Unlike :meth:`getitem` the attribute *must* be a string.
+        """
+        try:
+            return getattr(obj, attribute)
+        except AttributeError:
+            pass
+        try:
+            return obj[attribute]
+        except (TypeError, LookupError, AttributeError):
+            return self.undefined(obj=obj, name=attribute)
+
+    def _filter_test_common(
+        self,
+        name: t.Union[str, Undefined],
+        value: t.Any,
+        args: t.Optional[t.Sequence[t.Any]],
+        kwargs: t.Optional[t.Mapping[str, t.Any]],
+        context: t.Optional[Context],
+        eval_ctx: t.Optional[EvalContext],
+        is_filter: bool,
+    ) -> t.Any:
+        if is_filter:
+            env_map = self.filters
+            type_name = "filter"
+        else:
+            env_map = self.tests
+            type_name = "test"
+
+        func = env_map.get(name)  # type: ignore
+
+        if func is None:
+            msg = f"No {type_name} named {name!r}."
+
+            if isinstance(name, Undefined):
+                try:
+                    name._fail_with_undefined_error()
+                except Exception as e:
+                    msg = f"{msg} ({e}; did you forget to quote the callable name?)"
+
+            raise TemplateRuntimeError(msg)
+
+        args = [value, *(args if args is not None else ())]
+        kwargs = kwargs if kwargs is not None else {}
+        pass_arg = _PassArg.from_obj(func)
+
+        if pass_arg is _PassArg.context:
+            if context is None:
+                raise TemplateRuntimeError(
+                    f"Attempted to invoke a context {type_name} without context."
+                )
+
+            args.insert(0, context)
+        elif pass_arg is _PassArg.eval_context:
+            if eval_ctx is None:
+                if context is not None:
+                    eval_ctx = context.eval_ctx
+                else:
+                    eval_ctx = EvalContext(self)
+
+            args.insert(0, eval_ctx)
+        elif pass_arg is _PassArg.environment:
+            args.insert(0, self)
+
+        return func(*args, **kwargs)
+
+    def call_filter(
+        self,
+        name: str,
+        value: t.Any,
+        args: t.Optional[t.Sequence[t.Any]] = None,
+        kwargs: t.Optional[t.Mapping[str, t.Any]] = None,
+        context: t.Optional[Context] = None,
+        eval_ctx: t.Optional[EvalContext] = None,
+    ) -> t.Any:
+        """Invoke a filter on a value the same way the compiler does.
+
+        This might return a coroutine if the filter is running from an
+        environment in async mode and the filter supports async
+        execution. It's your responsibility to await this if needed.
+
+        .. versionadded:: 2.7
+        """
+        return self._filter_test_common(
+            name, value, args, kwargs, context, eval_ctx, True
+        )
+
+    def call_test(
+        self,
+        name: str,
+        value: t.Any,
+        args: t.Optional[t.Sequence[t.Any]] = None,
+        kwargs: t.Optional[t.Mapping[str, t.Any]] = None,
+        context: t.Optional[Context] = None,
+        eval_ctx: t.Optional[EvalContext] = None,
+    ) -> t.Any:
+        """Invoke a test on a value the same way the compiler does.
+
+        This might return a coroutine if the test is running from an
+        environment in async mode and the test supports async execution.
+        It's your responsibility to await this if needed.
+
+        .. versionchanged:: 3.0
+            Tests support ``@pass_context``, etc. decorators. Added
+            the ``context`` and ``eval_ctx`` parameters.
+
+        .. versionadded:: 2.7
+        """
+        return self._filter_test_common(
+            name, value, args, kwargs, context, eval_ctx, False
+        )
+
+    @internalcode
+    def parse(
+        self,
+        source: str,
+        name: t.Optional[str] = None,
+        filename: t.Optional[str] = None,
+    ) -> nodes.Template:
+        """Parse the sourcecode and return the abstract syntax tree.  This
+        tree of nodes is used by the compiler to convert the template into
+        executable source- or bytecode.  This is useful for debugging or to
+        extract information from templates.
+
+        If you are :ref:`developing Jinja extensions <writing-extensions>`
+        this gives you a good overview of the node tree generated.
+        """
+        try:
+            return self._parse(source, name, filename)
+        except TemplateSyntaxError:
+            self.handle_exception(source=source)
+
+    def _parse(
+        self, source: str, name: t.Optional[str], filename: t.Optional[str]
+    ) -> nodes.Template:
+        """Internal parsing function used by `parse` and `compile`."""
+        return Parser(self, source, name, filename).parse()
+
+    def lex(
+        self,
+        source: str,
+        name: t.Optional[str] = None,
+        filename: t.Optional[str] = None,
+    ) -> t.Iterator[t.Tuple[int, str, str]]:
+        """Lex the given sourcecode and return a generator that yields
+        tokens as tuples in the form ``(lineno, token_type, value)``.
+        This can be useful for :ref:`extension development <writing-extensions>`
+        and debugging templates.
+
+        This does not perform preprocessing.  If you want the preprocessing
+        of the extensions to be applied you have to filter source through
+        the :meth:`preprocess` method.
+        """
+        source = str(source)
+        try:
+            return self.lexer.tokeniter(source, name, filename)
+        except TemplateSyntaxError:
+            self.handle_exception(source=source)
+
+    def preprocess(
+        self,
+        source: str,
+        name: t.Optional[str] = None,
+        filename: t.Optional[str] = None,
+    ) -> str:
+        """Preprocesses the source with all extensions.  This is automatically
+        called for all parsing and compiling methods but *not* for :meth:`lex`
+        because there you usually only want the actual source tokenized.
+        """
+        return reduce(
+            lambda s, e: e.preprocess(s, name, filename),
+            self.iter_extensions(),
+            str(source),
+        )
+
+    def _tokenize(
+        self,
+        source: str,
+        name: t.Optional[str],
+        filename: t.Optional[str] = None,
+        state: t.Optional[str] = None,
+    ) -> TokenStream:
+        """Called by the parser to do the preprocessing and filtering
+        for all the extensions.  Returns a :class:`~jinja2.lexer.TokenStream`.
+        """
+        source = self.preprocess(source, name, filename)
+        stream = self.lexer.tokenize(source, name, filename, state)
+
+        for ext in self.iter_extensions():
+            stream = ext.filter_stream(stream)  # type: ignore
+
+            if not isinstance(stream, TokenStream):
+                stream = TokenStream(stream, name, filename)  # type: ignore
+
+        return stream
+
+    def _generate(
+        self,
+        source: nodes.Template,
+        name: t.Optional[str],
+        filename: t.Optional[str],
+        defer_init: bool = False,
+    ) -> str:
+        """Internal hook that can be overridden to hook a different generate
+        method in.
+
+        .. versionadded:: 2.5
+        """
+        return generate(  # type: ignore
+            source,
+            self,
+            name,
+            filename,
+            defer_init=defer_init,
+            optimized=self.optimized,
+        )
+
+    def _compile(self, source: str, filename: str) -> CodeType:
+        """Internal hook that can be overridden to hook a different compile
+        method in.
+
+        .. versionadded:: 2.5
+        """
+        return compile(source, filename, "exec")
+
+    @typing.overload
+    def compile(  # type: ignore
+        self,
+        source: t.Union[str, nodes.Template],
+        name: t.Optional[str] = None,
+        filename: t.Optional[str] = None,
+        raw: "te.Literal[False]" = False,
+        defer_init: bool = False,
+    ) -> CodeType:
+        ...
+
+    @typing.overload
+    def compile(
+        self,
+        source: t.Union[str, nodes.Template],
+        name: t.Optional[str] = None,
+        filename: t.Optional[str] = None,
+        raw: "te.Literal[True]" = ...,
+        defer_init: bool = False,
+    ) -> str:
+        ...
+
+    @internalcode
+    def compile(
+        self,
+        source: t.Union[str, nodes.Template],
+        name: t.Optional[str] = None,
+        filename: t.Optional[str] = None,
+        raw: bool = False,
+        defer_init: bool = False,
+    ) -> t.Union[str, CodeType]:
+        """Compile a node or template source code.  The `name` parameter is
+        the load name of the template after it was joined using
+        :meth:`join_path` if necessary, not the filename on the file system.
+        the `filename` parameter is the estimated filename of the template on
+        the file system.  If the template came from a database or memory this
+        can be omitted.
+
+        The return value of this method is a python code object.  If the `raw`
+        parameter is `True` the return value will be a string with python
+        code equivalent to the bytecode returned otherwise.  This method is
+        mainly used internally.
+
+        `defer_init` is use internally to aid the module code generator.  This
+        causes the generated code to be able to import without the global
+        environment variable to be set.
+
+        .. versionadded:: 2.4
+           `defer_init` parameter added.
+        """
+        source_hint = None
+        try:
+            if isinstance(source, str):
+                source_hint = source
+                source = self._parse(source, name, filename)
+            source = self._generate(source, name, filename, defer_init=defer_init)
+            if raw:
+                return source
+            if filename is None:
+                filename = "<template>"
+            return self._compile(source, filename)
+        except TemplateSyntaxError:
+            self.handle_exception(source=source_hint)
+
+    def compile_expression(
+        self, source: str, undefined_to_none: bool = True
+    ) -> "TemplateExpression":
+        """A handy helper method that returns a callable that accepts keyword
+        arguments that appear as variables in the expression.  If called it
+        returns the result of the expression.
+
+        This is useful if applications want to use the same rules as Jinja
+        in template "configuration files" or similar situations.
+
+        Example usage:
+
+        >>> env = Environment()
+        >>> expr = env.compile_expression('foo == 42')
+        >>> expr(foo=23)
+        False
+        >>> expr(foo=42)
+        True
+
+        Per default the return value is converted to `None` if the
+        expression returns an undefined value.  This can be changed
+        by setting `undefined_to_none` to `False`.
+
+        >>> env.compile_expression('var')() is None
+        True
+        >>> env.compile_expression('var', undefined_to_none=False)()
+        Undefined
+
+        .. versionadded:: 2.1
+        """
+        parser = Parser(self, source, state="variable")
+        try:
+            expr = parser.parse_expression()
+            if not parser.stream.eos:
+                raise TemplateSyntaxError(
+                    "chunk after expression", parser.stream.current.lineno, None, None
+                )
+            expr.set_environment(self)
+        except TemplateSyntaxError:
+            self.handle_exception(source=source)
+
+        body = [nodes.Assign(nodes.Name("result", "store"), expr, lineno=1)]
+        template = self.from_string(nodes.Template(body, lineno=1))
+        return TemplateExpression(template, undefined_to_none)
+
+    def compile_templates(
+        self,
+        target: t.Union[str, os.PathLike],
+        extensions: t.Optional[t.Collection[str]] = None,
+        filter_func: t.Optional[t.Callable[[str], bool]] = None,
+        zip: t.Optional[str] = "deflated",
+        log_function: t.Optional[t.Callable[[str], None]] = None,
+        ignore_errors: bool = True,
+    ) -> None:
+        """Finds all the templates the loader can find, compiles them
+        and stores them in `target`.  If `zip` is `None`, instead of in a
+        zipfile, the templates will be stored in a directory.
+        By default a deflate zip algorithm is used. To switch to
+        the stored algorithm, `zip` can be set to ``'stored'``.
+
+        `extensions` and `filter_func` are passed to :meth:`list_templates`.
+        Each template returned will be compiled to the target folder or
+        zipfile.
+
+        By default template compilation errors are ignored.  In case a
+        log function is provided, errors are logged.  If you want template
+        syntax errors to abort the compilation you can set `ignore_errors`
+        to `False` and you will get an exception on syntax errors.
+
+        .. versionadded:: 2.4
+        """
+        from .loaders import ModuleLoader
+
+        if log_function is None:
+
+            def log_function(x: str) -> None:
+                pass
+
+        assert log_function is not None
+        assert self.loader is not None, "No loader configured."
+
+        def write_file(filename: str, data: str) -> None:
+            if zip:
+                info = ZipInfo(filename)
+                info.external_attr = 0o755 << 16
+                zip_file.writestr(info, data)
+            else:
+                with open(os.path.join(target, filename), "wb") as f:
+                    f.write(data.encode("utf8"))
+
+        if zip is not None:
+            from zipfile import ZipFile, ZipInfo, ZIP_DEFLATED, ZIP_STORED
+
+            zip_file = ZipFile(
+                target, "w", dict(deflated=ZIP_DEFLATED, stored=ZIP_STORED)[zip]
+            )
+            log_function(f"Compiling into Zip archive {target!r}")
+        else:
+            if not os.path.isdir(target):
+                os.makedirs(target)
+            log_function(f"Compiling into folder {target!r}")
+
+        try:
+            for name in self.list_templates(extensions, filter_func):
+                source, filename, _ = self.loader.get_source(self, name)
+                try:
+                    code = self.compile(source, name, filename, True, True)
+                except TemplateSyntaxError as e:
+                    if not ignore_errors:
+                        raise
+                    log_function(f'Could not compile "{name}": {e}')
+                    continue
+
+                filename = ModuleLoader.get_module_filename(name)
+
+                write_file(filename, code)
+                log_function(f'Compiled "{name}" as {filename}')
+        finally:
+            if zip:
+                zip_file.close()
+
+        log_function("Finished compiling templates")
+
+    def list_templates(
+        self,
+        extensions: t.Optional[t.Collection[str]] = None,
+        filter_func: t.Optional[t.Callable[[str], bool]] = None,
+    ) -> t.List[str]:
+        """Returns a list of templates for this environment.  This requires
+        that the loader supports the loader's
+        :meth:`~BaseLoader.list_templates` method.
+
+        If there are other files in the template folder besides the
+        actual templates, the returned list can be filtered.  There are two
+        ways: either `extensions` is set to a list of file extensions for
+        templates, or a `filter_func` can be provided which is a callable that
+        is passed a template name and should return `True` if it should end up
+        in the result list.
+
+        If the loader does not support that, a :exc:`TypeError` is raised.
+
+        .. versionadded:: 2.4
+        """
+        assert self.loader is not None, "No loader configured."
+        names = self.loader.list_templates()
+
+        if extensions is not None:
+            if filter_func is not None:
+                raise TypeError(
+                    "either extensions or filter_func can be passed, but not both"
+                )
+
+            def filter_func(x: str) -> bool:
+                return "." in x and x.rsplit(".", 1)[1] in extensions
+
+        if filter_func is not None:
+            names = [name for name in names if filter_func(name)]
+
+        return names
+
+    def handle_exception(self, source: t.Optional[str] = None) -> "te.NoReturn":
+        """Exception handling helper.  This is used internally to either raise
+        rewritten exceptions or return a rendered traceback for the template.
+        """
+        from .debug import rewrite_traceback_stack
+
+        raise rewrite_traceback_stack(source=source)
+
+    def join_path(self, template: str, parent: str) -> str:
+        """Join a template with the parent.  By default all the lookups are
+        relative to the loader root so this method returns the `template`
+        parameter unchanged, but if the paths should be relative to the
+        parent template, this function can be used to calculate the real
+        template name.
+
+        Subclasses may override this method and implement template path
+        joining here.
+        """
+        return template
+
+    @internalcode
+    def _load_template(
+        self, name: str, globals: t.Optional[t.MutableMapping[str, t.Any]]
+    ) -> "Template":
+        if self.loader is None:
+            raise TypeError("no loader for this environment specified")
+        cache_key = (weakref.ref(self.loader), name)
+        if self.cache is not None:
+            template = self.cache.get(cache_key)
+            if template is not None and (
+                not self.auto_reload or template.is_up_to_date
+            ):
+                # template.globals is a ChainMap, modifying it will only
+                # affect the template, not the environment globals.
+                if globals:
+                    template.globals.update(globals)
+
+                return template
+
+        template = self.loader.load(self, name, self.make_globals(globals))
+
+        if self.cache is not None:
+            self.cache[cache_key] = template
+        return template
+
+    @internalcode
+    def get_template(
+        self,
+        name: t.Union[str, "Template"],
+        parent: t.Optional[str] = None,
+        globals: t.Optional[t.MutableMapping[str, t.Any]] = None,
+    ) -> "Template":
+        """Load a template by name with :attr:`loader` and return a
+        :class:`Template`. If the template does not exist a
+        :exc:`TemplateNotFound` exception is raised.
+
+        :param name: Name of the template to load. When loading
+            templates from the filesystem, "/" is used as the path
+            separator, even on Windows.
+        :param parent: The name of the parent template importing this
+            template. :meth:`join_path` can be used to implement name
+            transformations with this.
+        :param globals: Extend the environment :attr:`globals` with
+            these extra variables available for all renders of this
+            template. If the template has already been loaded and
+            cached, its globals are updated with any new items.
+
+        .. versionchanged:: 3.0
+            If a template is loaded from cache, ``globals`` will update
+            the template's globals instead of ignoring the new values.
+
+        .. versionchanged:: 2.4
+            If ``name`` is a :class:`Template` object it is returned
+            unchanged.
+        """
+        if isinstance(name, Template):
+            return name
+        if parent is not None:
+            name = self.join_path(name, parent)
+
+        return self._load_template(name, globals)
+
+    @internalcode
+    def select_template(
+        self,
+        names: t.Iterable[t.Union[str, "Template"]],
+        parent: t.Optional[str] = None,
+        globals: t.Optional[t.MutableMapping[str, t.Any]] = None,
+    ) -> "Template":
+        """Like :meth:`get_template`, but tries loading multiple names.
+        If none of the names can be loaded a :exc:`TemplatesNotFound`
+        exception is raised.
+
+        :param names: List of template names to try loading in order.
+        :param parent: The name of the parent template importing this
+            template. :meth:`join_path` can be used to implement name
+            transformations with this.
+        :param globals: Extend the environment :attr:`globals` with
+            these extra variables available for all renders of this
+            template. If the template has already been loaded and
+            cached, its globals are updated with any new items.
+
+        .. versionchanged:: 3.0
+            If a template is loaded from cache, ``globals`` will update
+            the template's globals instead of ignoring the new values.
+
+        .. versionchanged:: 2.11
+            If ``names`` is :class:`Undefined`, an :exc:`UndefinedError`
+            is raised instead. If no templates were found and ``names``
+            contains :class:`Undefined`, the message is more helpful.
+
+        .. versionchanged:: 2.4
+            If ``names`` contains a :class:`Template` object it is
+            returned unchanged.
+
+        .. versionadded:: 2.3
+        """
+        if isinstance(names, Undefined):
+            names._fail_with_undefined_error()
+
+        if not names:
+            raise TemplatesNotFound(
+                message="Tried to select from an empty list of templates."
+            )
+
+        for name in names:
+            if isinstance(name, Template):
+                return name
+            if parent is not None:
+                name = self.join_path(name, parent)
+            try:
+                return self._load_template(name, globals)
+            except (TemplateNotFound, UndefinedError):
+                pass
+        raise TemplatesNotFound(names)  # type: ignore
+
+    @internalcode
+    def get_or_select_template(
+        self,
+        template_name_or_list: t.Union[
+            str, "Template", t.List[t.Union[str, "Template"]]
+        ],
+        parent: t.Optional[str] = None,
+        globals: t.Optional[t.MutableMapping[str, t.Any]] = None,
+    ) -> "Template":
+        """Use :meth:`select_template` if an iterable of template names
+        is given, or :meth:`get_template` if one name is given.
+
+        .. versionadded:: 2.3
+        """
+        if isinstance(template_name_or_list, (str, Undefined)):
+            return self.get_template(template_name_or_list, parent, globals)
+        elif isinstance(template_name_or_list, Template):
+            return template_name_or_list
+        return self.select_template(template_name_or_list, parent, globals)
+
+    def from_string(
+        self,
+        source: t.Union[str, nodes.Template],
+        globals: t.Optional[t.MutableMapping[str, t.Any]] = None,
+        template_class: t.Optional[t.Type["Template"]] = None,
+    ) -> "Template":
+        """Load a template from a source string without using
+        :attr:`loader`.
+
+        :param source: Jinja source to compile into a template.
+        :param globals: Extend the environment :attr:`globals` with
+            these extra variables available for all renders of this
+            template. If the template has already been loaded and
+            cached, its globals are updated with any new items.
+        :param template_class: Return an instance of this
+            :class:`Template` class.
+        """
+        gs = self.make_globals(globals)
+        cls = template_class or self.template_class
+        return cls.from_code(self, self.compile(source), gs, None)
+
+    def make_globals(
+        self, d: t.Optional[t.MutableMapping[str, t.Any]]
+    ) -> t.MutableMapping[str, t.Any]:
+        """Make the globals map for a template. Any given template
+        globals overlay the environment :attr:`globals`.
+
+        Returns a :class:`collections.ChainMap`. This allows any changes
+        to a template's globals to only affect that template, while
+        changes to the environment's globals are still reflected.
+        However, avoid modifying any globals after a template is loaded.
+
+        :param d: Dict of template-specific globals.
+
+        .. versionchanged:: 3.0
+            Use :class:`collections.ChainMap` to always prevent mutating
+            environment globals.
+        """
+        if d is None:
+            d = {}
+
+        return ChainMap(d, self.globals)
+
+
+class Template:
+    """A compiled template that can be rendered.
+
+    Use the methods on :class:`Environment` to create or load templates.
+    The environment is used to configure how templates are compiled and
+    behave.
+
+    It is also possible to create a template object directly. This is
+    not usually recommended. The constructor takes most of the same
+    arguments as :class:`Environment`. All templates created with the
+    same environment arguments share the same ephemeral ``Environment``
+    instance behind the scenes.
+
+    A template object should be considered immutable. Modifications on
+    the object are not supported.
+    """
+
+    #: Type of environment to create when creating a template directly
+    #: rather than through an existing environment.
+    environment_class: t.Type[Environment] = Environment
+
+    environment: Environment
+    globals: t.MutableMapping[str, t.Any]
+    name: t.Optional[str]
+    filename: t.Optional[str]
+    blocks: t.Dict[str, t.Callable[[Context], t.Iterator[str]]]
+    root_render_func: t.Callable[[Context], t.Iterator[str]]
+    _module: t.Optional["TemplateModule"]
+    _debug_info: str
+    _uptodate: t.Optional[t.Callable[[], bool]]
+
+    def __new__(
+        cls,
+        source: t.Union[str, nodes.Template],
+        block_start_string: str = BLOCK_START_STRING,
+        block_end_string: str = BLOCK_END_STRING,
+        variable_start_string: str = VARIABLE_START_STRING,
+        variable_end_string: str = VARIABLE_END_STRING,
+        comment_start_string: str = COMMENT_START_STRING,
+        comment_end_string: str = COMMENT_END_STRING,
+        line_statement_prefix: t.Optional[str] = LINE_STATEMENT_PREFIX,
+        line_comment_prefix: t.Optional[str] = LINE_COMMENT_PREFIX,
+        trim_blocks: bool = TRIM_BLOCKS,
+        lstrip_blocks: bool = LSTRIP_BLOCKS,
+        newline_sequence: "te.Literal['\\n', '\\r\\n', '\\r']" = NEWLINE_SEQUENCE,
+        keep_trailing_newline: bool = KEEP_TRAILING_NEWLINE,
+        extensions: t.Sequence[t.Union[str, t.Type["Extension"]]] = (),
+        optimized: bool = True,
+        undefined: t.Type[Undefined] = Undefined,
+        finalize: t.Optional[t.Callable[..., t.Any]] = None,
+        autoescape: t.Union[bool, t.Callable[[t.Optional[str]], bool]] = False,
+        enable_async: bool = False,
+    ) -> t.Any:  # it returns a `Template`, but this breaks the sphinx build...
+        env = get_spontaneous_environment(
+            cls.environment_class,  # type: ignore
+            block_start_string,
+            block_end_string,
+            variable_start_string,
+            variable_end_string,
+            comment_start_string,
+            comment_end_string,
+            line_statement_prefix,
+            line_comment_prefix,
+            trim_blocks,
+            lstrip_blocks,
+            newline_sequence,
+            keep_trailing_newline,
+            frozenset(extensions),
+            optimized,
+            undefined,  # type: ignore
+            finalize,
+            autoescape,
+            None,
+            0,
+            False,
+            None,
+            enable_async,
+        )
+        return env.from_string(source, template_class=cls)
+
+    @classmethod
+    def from_code(
+        cls,
+        environment: Environment,
+        code: CodeType,
+        globals: t.MutableMapping[str, t.Any],
+        uptodate: t.Optional[t.Callable[[], bool]] = None,
+    ) -> "Template":
+        """Creates a template object from compiled code and the globals.  This
+        is used by the loaders and environment to create a template object.
+        """
+        namespace = {"environment": environment, "__file__": code.co_filename}
+        exec(code, namespace)
+        rv = cls._from_namespace(environment, namespace, globals)
+        rv._uptodate = uptodate
+        return rv
+
+    @classmethod
+    def from_module_dict(
+        cls,
+        environment: Environment,
+        module_dict: t.MutableMapping[str, t.Any],
+        globals: t.MutableMapping[str, t.Any],
+    ) -> "Template":
+        """Creates a template object from a module.  This is used by the
+        module loader to create a template object.
+
+        .. versionadded:: 2.4
+        """
+        return cls._from_namespace(environment, module_dict, globals)
+
+    @classmethod
+    def _from_namespace(
+        cls,
+        environment: Environment,
+        namespace: t.MutableMapping[str, t.Any],
+        globals: t.MutableMapping[str, t.Any],
+    ) -> "Template":
+        t: "Template" = object.__new__(cls)
+        t.environment = environment
+        t.globals = globals
+        t.name = namespace["name"]
+        t.filename = namespace["__file__"]
+        t.blocks = namespace["blocks"]
+
+        # render function and module
+        t.root_render_func = namespace["root"]
+        t._module = None
+
+        # debug and loader helpers
+        t._debug_info = namespace["debug_info"]
+        t._uptodate = None
+
+        # store the reference
+        namespace["environment"] = environment
+        namespace["__jinja_template__"] = t
+
+        return t
+
+    def render(self, *args: t.Any, **kwargs: t.Any) -> str:
+        """This method accepts the same arguments as the `dict` constructor:
+        A dict, a dict subclass or some keyword arguments.  If no arguments
+        are given the context will be empty.  These two calls do the same::
+
+            template.render(knights='that say nih')
+            template.render({'knights': 'that say nih'})
+
+        This will return the rendered template as a string.
+        """
+        if self.environment.is_async:
+            import asyncio
+
+            close = False
+
+            try:
+                loop = asyncio.get_running_loop()
+            except RuntimeError:
+                loop = asyncio.new_event_loop()
+                close = True
+
+            try:
+                return loop.run_until_complete(self.render_async(*args, **kwargs))
+            finally:
+                if close:
+                    loop.close()
+
+        ctx = self.new_context(dict(*args, **kwargs))
+
+        try:
+            return self.environment.concat(self.root_render_func(ctx))  # type: ignore
+        except Exception:
+            self.environment.handle_exception()
+
+    async def render_async(self, *args: t.Any, **kwargs: t.Any) -> str:
+        """This works similar to :meth:`render` but returns a coroutine
+        that when awaited returns the entire rendered template string.  This
+        requires the async feature to be enabled.
+
+        Example usage::
+
+            await template.render_async(knights='that say nih; asynchronously')
+        """
+        if not self.environment.is_async:
+            raise RuntimeError(
+                "The environment was not created with async mode enabled."
+            )
+
+        ctx = self.new_context(dict(*args, **kwargs))
+
+        try:
+            return self.environment.concat(  # type: ignore
+                [n async for n in self.root_render_func(ctx)]  # type: ignore
+            )
+        except Exception:
+            return self.environment.handle_exception()
+
+    def stream(self, *args: t.Any, **kwargs: t.Any) -> "TemplateStream":
+        """Works exactly like :meth:`generate` but returns a
+        :class:`TemplateStream`.
+        """
+        return TemplateStream(self.generate(*args, **kwargs))
+
+    def generate(self, *args: t.Any, **kwargs: t.Any) -> t.Iterator[str]:
+        """For very large templates it can be useful to not render the whole
+        template at once but evaluate each statement after another and yield
+        piece for piece.  This method basically does exactly that and returns
+        a generator that yields one item after another as strings.
+
+        It accepts the same arguments as :meth:`render`.
+        """
+        if self.environment.is_async:
+            import asyncio
+
+            async def to_list() -> t.List[str]:
+                return [x async for x in self.generate_async(*args, **kwargs)]
+
+            yield from asyncio.run(to_list())
+            return
+
+        ctx = self.new_context(dict(*args, **kwargs))
+
+        try:
+            yield from self.root_render_func(ctx)
+        except Exception:
+            yield self.environment.handle_exception()
+
+    async def generate_async(
+        self, *args: t.Any, **kwargs: t.Any
+    ) -> t.AsyncIterator[str]:
+        """An async version of :meth:`generate`.  Works very similarly but
+        returns an async iterator instead.
+        """
+        if not self.environment.is_async:
+            raise RuntimeError(
+                "The environment was not created with async mode enabled."
+            )
+
+        ctx = self.new_context(dict(*args, **kwargs))
+
+        try:
+            async for event in self.root_render_func(ctx):  # type: ignore
+                yield event
+        except Exception:
+            yield self.environment.handle_exception()
+
+    def new_context(
+        self,
+        vars: t.Optional[t.Dict[str, t.Any]] = None,
+        shared: bool = False,
+        locals: t.Optional[t.Mapping[str, t.Any]] = None,
+    ) -> Context:
+        """Create a new :class:`Context` for this template.  The vars
+        provided will be passed to the template.  Per default the globals
+        are added to the context.  If shared is set to `True` the data
+        is passed as is to the context without adding the globals.
+
+        `locals` can be a dict of local variables for internal usage.
+        """
+        return new_context(
+            self.environment, self.name, self.blocks, vars, shared, self.globals, locals
+        )
+
+    def make_module(
+        self,
+        vars: t.Optional[t.Dict[str, t.Any]] = None,
+        shared: bool = False,
+        locals: t.Optional[t.Mapping[str, t.Any]] = None,
+    ) -> "TemplateModule":
+        """This method works like the :attr:`module` attribute when called
+        without arguments but it will evaluate the template on every call
+        rather than caching it.  It's also possible to provide
+        a dict which is then used as context.  The arguments are the same
+        as for the :meth:`new_context` method.
+        """
+        ctx = self.new_context(vars, shared, locals)
+        return TemplateModule(self, ctx)
+
+    async def make_module_async(
+        self,
+        vars: t.Optional[t.Dict[str, t.Any]] = None,
+        shared: bool = False,
+        locals: t.Optional[t.Mapping[str, t.Any]] = None,
+    ) -> "TemplateModule":
+        """As template module creation can invoke template code for
+        asynchronous executions this method must be used instead of the
+        normal :meth:`make_module` one.  Likewise the module attribute
+        becomes unavailable in async mode.
+        """
+        ctx = self.new_context(vars, shared, locals)
+        return TemplateModule(
+            self, ctx, [x async for x in self.root_render_func(ctx)]  # type: ignore
+        )
+
+    @internalcode
+    def _get_default_module(self, ctx: t.Optional[Context] = None) -> "TemplateModule":
+        """If a context is passed in, this means that the template was
+        imported. Imported templates have access to the current
+        template's globals by default, but they can only be accessed via
+        the context during runtime.
+
+        If there are new globals, we need to create a new module because
+        the cached module is already rendered and will not have access
+        to globals from the current context. This new module is not
+        cached because the template can be imported elsewhere, and it
+        should have access to only the current template's globals.
+        """
+        if self.environment.is_async:
+            raise RuntimeError("Module is not available in async mode.")
+
+        if ctx is not None:
+            keys = ctx.globals_keys - self.globals.keys()
+
+            if keys:
+                return self.make_module({k: ctx.parent[k] for k in keys})
+
+        if self._module is None:
+            self._module = self.make_module()
+
+        return self._module
+
+    async def _get_default_module_async(
+        self, ctx: t.Optional[Context] = None
+    ) -> "TemplateModule":
+        if ctx is not None:
+            keys = ctx.globals_keys - self.globals.keys()
+
+            if keys:
+                return await self.make_module_async({k: ctx.parent[k] for k in keys})
+
+        if self._module is None:
+            self._module = await self.make_module_async()
+
+        return self._module
+
+    @property
+    def module(self) -> "TemplateModule":
+        """The template as module.  This is used for imports in the
+        template runtime but is also useful if one wants to access
+        exported template variables from the Python layer:
+
+        >>> t = Template('{% macro foo() %}42{% endmacro %}23')
+        >>> str(t.module)
+        '23'
+        >>> t.module.foo() == u'42'
+        True
+
+        This attribute is not available if async mode is enabled.
+        """
+        return self._get_default_module()
+
+    def get_corresponding_lineno(self, lineno: int) -> int:
+        """Return the source line number of a line number in the
+        generated bytecode as they are not in sync.
+        """
+        for template_line, code_line in reversed(self.debug_info):
+            if code_line <= lineno:
+                return template_line
+        return 1
+
+    @property
+    def is_up_to_date(self) -> bool:
+        """If this variable is `False` there is a newer version available."""
+        if self._uptodate is None:
+            return True
+        return self._uptodate()
+
+    @property
+    def debug_info(self) -> t.List[t.Tuple[int, int]]:
+        """The debug info mapping."""
+        if self._debug_info:
+            return [
+                tuple(map(int, x.split("=")))  # type: ignore
+                for x in self._debug_info.split("&")
+            ]
+
+        return []
+
+    def __repr__(self) -> str:
+        if self.name is None:
+            name = f"memory:{id(self):x}"
+        else:
+            name = repr(self.name)
+        return f"<{type(self).__name__} {name}>"
+
+
+class TemplateModule:
+    """Represents an imported template.  All the exported names of the
+    template are available as attributes on this object.  Additionally
+    converting it into a string renders the contents.
+    """
+
+    def __init__(
+        self,
+        template: Template,
+        context: Context,
+        body_stream: t.Optional[t.Iterable[str]] = None,
+    ) -> None:
+        if body_stream is None:
+            if context.environment.is_async:
+                raise RuntimeError(
+                    "Async mode requires a body stream to be passed to"
+                    " a template module. Use the async methods of the"
+                    " API you are using."
+                )
+
+            body_stream = list(template.root_render_func(context))
+
+        self._body_stream = body_stream
+        self.__dict__.update(context.get_exported())
+        self.__name__ = template.name
+
+    def __html__(self) -> Markup:
+        return Markup(concat(self._body_stream))
+
+    def __str__(self) -> str:
+        return concat(self._body_stream)
+
+    def __repr__(self) -> str:
+        if self.__name__ is None:
+            name = f"memory:{id(self):x}"
+        else:
+            name = repr(self.__name__)
+        return f"<{type(self).__name__} {name}>"
+
+
+class TemplateExpression:
+    """The :meth:`jinja2.Environment.compile_expression` method returns an
+    instance of this object.  It encapsulates the expression-like access
+    to the template with an expression it wraps.
+    """
+
+    def __init__(self, template: Template, undefined_to_none: bool) -> None:
+        self._template = template
+        self._undefined_to_none = undefined_to_none
+
+    def __call__(self, *args: t.Any, **kwargs: t.Any) -> t.Optional[t.Any]:
+        context = self._template.new_context(dict(*args, **kwargs))
+        consume(self._template.root_render_func(context))
+        rv = context.vars["result"]
+        if self._undefined_to_none and isinstance(rv, Undefined):
+            rv = None
+        return rv
+
+
+class TemplateStream:
+    """A template stream works pretty much like an ordinary python generator
+    but it can buffer multiple items to reduce the number of total iterations.
+    Per default the output is unbuffered which means that for every unbuffered
+    instruction in the template one string is yielded.
+
+    If buffering is enabled with a buffer size of 5, five items are combined
+    into a new string.  This is mainly useful if you are streaming
+    big templates to a client via WSGI which flushes after each iteration.
+    """
+
+    def __init__(self, gen: t.Iterator[str]) -> None:
+        self._gen = gen
+        self.disable_buffering()
+
+    def dump(
+        self,
+        fp: t.Union[str, t.IO],
+        encoding: t.Optional[str] = None,
+        errors: t.Optional[str] = "strict",
+    ) -> None:
+        """Dump the complete stream into a file or file-like object.
+        Per default strings are written, if you want to encode
+        before writing specify an `encoding`.
+
+        Example usage::
+
+            Template('Hello {{ name }}!').stream(name='foo').dump('hello.html')
+        """
+        close = False
+
+        if isinstance(fp, str):
+            if encoding is None:
+                encoding = "utf-8"
+
+            fp = open(fp, "wb")
+            close = True
+        try:
+            if encoding is not None:
+                iterable = (x.encode(encoding, errors) for x in self)  # type: ignore
+            else:
+                iterable = self  # type: ignore
+
+            if hasattr(fp, "writelines"):
+                fp.writelines(iterable)
+            else:
+                for item in iterable:
+                    fp.write(item)
+        finally:
+            if close:
+                fp.close()
+
+    def disable_buffering(self) -> None:
+        """Disable the output buffering."""
+        self._next = partial(next, self._gen)
+        self.buffered = False
+
+    def _buffered_generator(self, size: int) -> t.Iterator[str]:
+        buf: t.List[str] = []
+        c_size = 0
+        push = buf.append
+
+        while True:
+            try:
+                while c_size < size:
+                    c = next(self._gen)
+                    push(c)
+                    if c:
+                        c_size += 1
+            except StopIteration:
+                if not c_size:
+                    return
+            yield concat(buf)
+            del buf[:]
+            c_size = 0
+
+    def enable_buffering(self, size: int = 5) -> None:
+        """Enable buffering.  Buffer `size` items before yielding them."""
+        if size <= 1:
+            raise ValueError("buffer size too small")
+
+        self.buffered = True
+        self._next = partial(next, self._buffered_generator(size))
+
+    def __iter__(self) -> "TemplateStream":
+        return self
+
+    def __next__(self) -> str:
+        return self._next()  # type: ignore
+
+
+# hook in default template class.  if anyone reads this comment: ignore that
+# it's possible to use custom templates ;-)
+Environment.template_class = Template
diff --git a/llm/Lib/site-packages/jinja2/exceptions.py b/llm/Lib/site-packages/jinja2/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..082ebe8f221d4e7e980e4d321c0a0c5da033b124
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/exceptions.py
@@ -0,0 +1,166 @@
+import typing as t
+
+if t.TYPE_CHECKING:
+    from .runtime import Undefined
+
+
+class TemplateError(Exception):
+    """Baseclass for all template errors."""
+
+    def __init__(self, message: t.Optional[str] = None) -> None:
+        super().__init__(message)
+
+    @property
+    def message(self) -> t.Optional[str]:
+        return self.args[0] if self.args else None
+
+
+class TemplateNotFound(IOError, LookupError, TemplateError):
+    """Raised if a template does not exist.
+
+    .. versionchanged:: 2.11
+        If the given name is :class:`Undefined` and no message was
+        provided, an :exc:`UndefinedError` is raised.
+    """
+
+    # Silence the Python warning about message being deprecated since
+    # it's not valid here.
+    message: t.Optional[str] = None
+
+    def __init__(
+        self,
+        name: t.Optional[t.Union[str, "Undefined"]],
+        message: t.Optional[str] = None,
+    ) -> None:
+        IOError.__init__(self, name)
+
+        if message is None:
+            from .runtime import Undefined
+
+            if isinstance(name, Undefined):
+                name._fail_with_undefined_error()
+
+            message = name
+
+        self.message = message
+        self.name = name
+        self.templates = [name]
+
+    def __str__(self) -> str:
+        return str(self.message)
+
+
+class TemplatesNotFound(TemplateNotFound):
+    """Like :class:`TemplateNotFound` but raised if multiple templates
+    are selected.  This is a subclass of :class:`TemplateNotFound`
+    exception, so just catching the base exception will catch both.
+
+    .. versionchanged:: 2.11
+        If a name in the list of names is :class:`Undefined`, a message
+        about it being undefined is shown rather than the empty string.
+
+    .. versionadded:: 2.2
+    """
+
+    def __init__(
+        self,
+        names: t.Sequence[t.Union[str, "Undefined"]] = (),
+        message: t.Optional[str] = None,
+    ) -> None:
+        if message is None:
+            from .runtime import Undefined
+
+            parts = []
+
+            for name in names:
+                if isinstance(name, Undefined):
+                    parts.append(name._undefined_message)
+                else:
+                    parts.append(name)
+
+            parts_str = ", ".join(map(str, parts))
+            message = f"none of the templates given were found: {parts_str}"
+
+        super().__init__(names[-1] if names else None, message)
+        self.templates = list(names)
+
+
+class TemplateSyntaxError(TemplateError):
+    """Raised to tell the user that there is a problem with the template."""
+
+    def __init__(
+        self,
+        message: str,
+        lineno: int,
+        name: t.Optional[str] = None,
+        filename: t.Optional[str] = None,
+    ) -> None:
+        super().__init__(message)
+        self.lineno = lineno
+        self.name = name
+        self.filename = filename
+        self.source: t.Optional[str] = None
+
+        # this is set to True if the debug.translate_syntax_error
+        # function translated the syntax error into a new traceback
+        self.translated = False
+
+    def __str__(self) -> str:
+        # for translated errors we only return the message
+        if self.translated:
+            return t.cast(str, self.message)
+
+        # otherwise attach some stuff
+        location = f"line {self.lineno}"
+        name = self.filename or self.name
+        if name:
+            location = f'File "{name}", {location}'
+        lines = [t.cast(str, self.message), "  " + location]
+
+        # if the source is set, add the line to the output
+        if self.source is not None:
+            try:
+                line = self.source.splitlines()[self.lineno - 1]
+            except IndexError:
+                pass
+            else:
+                lines.append("    " + line.strip())
+
+        return "\n".join(lines)
+
+    def __reduce__(self):  # type: ignore
+        # https://bugs.python.org/issue1692335 Exceptions that take
+        # multiple required arguments have problems with pickling.
+        # Without this, raises TypeError: __init__() missing 1 required
+        # positional argument: 'lineno'
+        return self.__class__, (self.message, self.lineno, self.name, self.filename)
+
+
+class TemplateAssertionError(TemplateSyntaxError):
+    """Like a template syntax error, but covers cases where something in the
+    template caused an error at compile time that wasn't necessarily caused
+    by a syntax error.  However it's a direct subclass of
+    :exc:`TemplateSyntaxError` and has the same attributes.
+    """
+
+
+class TemplateRuntimeError(TemplateError):
+    """A generic runtime error in the template engine.  Under some situations
+    Jinja may raise this exception.
+    """
+
+
+class UndefinedError(TemplateRuntimeError):
+    """Raised if a template tries to operate on :class:`Undefined`."""
+
+
+class SecurityError(TemplateRuntimeError):
+    """Raised if a template tries to do something insecure if the
+    sandbox is enabled.
+    """
+
+
+class FilterArgumentError(TemplateRuntimeError):
+    """This error is raised if a filter was called with inappropriate
+    arguments
+    """
diff --git a/llm/Lib/site-packages/jinja2/ext.py b/llm/Lib/site-packages/jinja2/ext.py
new file mode 100644
index 0000000000000000000000000000000000000000..fade1fa3bc89b0d85d6ae3915277b835c67d7030
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/ext.py
@@ -0,0 +1,869 @@
+"""Extension API for adding custom tags and behavior."""
+import pprint
+import re
+import typing as t
+
+from markupsafe import Markup
+
+from . import defaults
+from . import nodes
+from .environment import Environment
+from .exceptions import TemplateAssertionError
+from .exceptions import TemplateSyntaxError
+from .runtime import concat  # type: ignore
+from .runtime import Context
+from .runtime import Undefined
+from .utils import import_string
+from .utils import pass_context
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+    from .lexer import Token
+    from .lexer import TokenStream
+    from .parser import Parser
+
+    class _TranslationsBasic(te.Protocol):
+        def gettext(self, message: str) -> str:
+            ...
+
+        def ngettext(self, singular: str, plural: str, n: int) -> str:
+            pass
+
+    class _TranslationsContext(_TranslationsBasic):
+        def pgettext(self, context: str, message: str) -> str:
+            ...
+
+        def npgettext(self, context: str, singular: str, plural: str, n: int) -> str:
+            ...
+
+    _SupportedTranslations = t.Union[_TranslationsBasic, _TranslationsContext]
+
+
+# I18N functions available in Jinja templates. If the I18N library
+# provides ugettext, it will be assigned to gettext.
+GETTEXT_FUNCTIONS: t.Tuple[str, ...] = (
+    "_",
+    "gettext",
+    "ngettext",
+    "pgettext",
+    "npgettext",
+)
+_ws_re = re.compile(r"\s*\n\s*")
+
+
+class Extension:
+    """Extensions can be used to add extra functionality to the Jinja template
+    system at the parser level.  Custom extensions are bound to an environment
+    but may not store environment specific data on `self`.  The reason for
+    this is that an extension can be bound to another environment (for
+    overlays) by creating a copy and reassigning the `environment` attribute.
+
+    As extensions are created by the environment they cannot accept any
+    arguments for configuration.  One may want to work around that by using
+    a factory function, but that is not possible as extensions are identified
+    by their import name.  The correct way to configure the extension is
+    storing the configuration values on the environment.  Because this way the
+    environment ends up acting as central configuration storage the
+    attributes may clash which is why extensions have to ensure that the names
+    they choose for configuration are not too generic.  ``prefix`` for example
+    is a terrible name, ``fragment_cache_prefix`` on the other hand is a good
+    name as includes the name of the extension (fragment cache).
+    """
+
+    identifier: t.ClassVar[str]
+
+    def __init_subclass__(cls) -> None:
+        cls.identifier = f"{cls.__module__}.{cls.__name__}"
+
+    #: if this extension parses this is the list of tags it's listening to.
+    tags: t.Set[str] = set()
+
+    #: the priority of that extension.  This is especially useful for
+    #: extensions that preprocess values.  A lower value means higher
+    #: priority.
+    #:
+    #: .. versionadded:: 2.4
+    priority = 100
+
+    def __init__(self, environment: Environment) -> None:
+        self.environment = environment
+
+    def bind(self, environment: Environment) -> "Extension":
+        """Create a copy of this extension bound to another environment."""
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.environment = environment
+        return rv
+
+    def preprocess(
+        self, source: str, name: t.Optional[str], filename: t.Optional[str] = None
+    ) -> str:
+        """This method is called before the actual lexing and can be used to
+        preprocess the source.  The `filename` is optional.  The return value
+        must be the preprocessed source.
+        """
+        return source
+
+    def filter_stream(
+        self, stream: "TokenStream"
+    ) -> t.Union["TokenStream", t.Iterable["Token"]]:
+        """It's passed a :class:`~jinja2.lexer.TokenStream` that can be used
+        to filter tokens returned.  This method has to return an iterable of
+        :class:`~jinja2.lexer.Token`\\s, but it doesn't have to return a
+        :class:`~jinja2.lexer.TokenStream`.
+        """
+        return stream
+
+    def parse(self, parser: "Parser") -> t.Union[nodes.Node, t.List[nodes.Node]]:
+        """If any of the :attr:`tags` matched this method is called with the
+        parser as first argument.  The token the parser stream is pointing at
+        is the name token that matched.  This method has to return one or a
+        list of multiple nodes.
+        """
+        raise NotImplementedError()
+
+    def attr(
+        self, name: str, lineno: t.Optional[int] = None
+    ) -> nodes.ExtensionAttribute:
+        """Return an attribute node for the current extension.  This is useful
+        to pass constants on extensions to generated template code.
+
+        ::
+
+            self.attr('_my_attribute', lineno=lineno)
+        """
+        return nodes.ExtensionAttribute(self.identifier, name, lineno=lineno)
+
+    def call_method(
+        self,
+        name: str,
+        args: t.Optional[t.List[nodes.Expr]] = None,
+        kwargs: t.Optional[t.List[nodes.Keyword]] = None,
+        dyn_args: t.Optional[nodes.Expr] = None,
+        dyn_kwargs: t.Optional[nodes.Expr] = None,
+        lineno: t.Optional[int] = None,
+    ) -> nodes.Call:
+        """Call a method of the extension.  This is a shortcut for
+        :meth:`attr` + :class:`jinja2.nodes.Call`.
+        """
+        if args is None:
+            args = []
+        if kwargs is None:
+            kwargs = []
+        return nodes.Call(
+            self.attr(name, lineno=lineno),
+            args,
+            kwargs,
+            dyn_args,
+            dyn_kwargs,
+            lineno=lineno,
+        )
+
+
+@pass_context
+def _gettext_alias(
+    __context: Context, *args: t.Any, **kwargs: t.Any
+) -> t.Union[t.Any, Undefined]:
+    return __context.call(__context.resolve("gettext"), *args, **kwargs)
+
+
+def _make_new_gettext(func: t.Callable[[str], str]) -> t.Callable[..., str]:
+    @pass_context
+    def gettext(__context: Context, __string: str, **variables: t.Any) -> str:
+        rv = __context.call(func, __string)
+        if __context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        # Always treat as a format string, even if there are no
+        # variables. This makes translation strings more consistent
+        # and predictable. This requires escaping
+        return rv % variables  # type: ignore
+
+    return gettext
+
+
+def _make_new_ngettext(func: t.Callable[[str, str, int], str]) -> t.Callable[..., str]:
+    @pass_context
+    def ngettext(
+        __context: Context,
+        __singular: str,
+        __plural: str,
+        __num: int,
+        **variables: t.Any,
+    ) -> str:
+        variables.setdefault("num", __num)
+        rv = __context.call(func, __singular, __plural, __num)
+        if __context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        # Always treat as a format string, see gettext comment above.
+        return rv % variables  # type: ignore
+
+    return ngettext
+
+
+def _make_new_pgettext(func: t.Callable[[str, str], str]) -> t.Callable[..., str]:
+    @pass_context
+    def pgettext(
+        __context: Context, __string_ctx: str, __string: str, **variables: t.Any
+    ) -> str:
+        variables.setdefault("context", __string_ctx)
+        rv = __context.call(func, __string_ctx, __string)
+
+        if __context.eval_ctx.autoescape:
+            rv = Markup(rv)
+
+        # Always treat as a format string, see gettext comment above.
+        return rv % variables  # type: ignore
+
+    return pgettext
+
+
+def _make_new_npgettext(
+    func: t.Callable[[str, str, str, int], str]
+) -> t.Callable[..., str]:
+    @pass_context
+    def npgettext(
+        __context: Context,
+        __string_ctx: str,
+        __singular: str,
+        __plural: str,
+        __num: int,
+        **variables: t.Any,
+    ) -> str:
+        variables.setdefault("context", __string_ctx)
+        variables.setdefault("num", __num)
+        rv = __context.call(func, __string_ctx, __singular, __plural, __num)
+
+        if __context.eval_ctx.autoescape:
+            rv = Markup(rv)
+
+        # Always treat as a format string, see gettext comment above.
+        return rv % variables  # type: ignore
+
+    return npgettext
+
+
+class InternationalizationExtension(Extension):
+    """This extension adds gettext support to Jinja."""
+
+    tags = {"trans"}
+
+    # TODO: the i18n extension is currently reevaluating values in a few
+    # situations.  Take this example:
+    #   {% trans count=something() %}{{ count }} foo{% pluralize
+    #     %}{{ count }} fooss{% endtrans %}
+    # something is called twice here.  One time for the gettext value and
+    # the other time for the n-parameter of the ngettext function.
+
+    def __init__(self, environment: Environment) -> None:
+        super().__init__(environment)
+        environment.globals["_"] = _gettext_alias
+        environment.extend(
+            install_gettext_translations=self._install,
+            install_null_translations=self._install_null,
+            install_gettext_callables=self._install_callables,
+            uninstall_gettext_translations=self._uninstall,
+            extract_translations=self._extract,
+            newstyle_gettext=False,
+        )
+
+    def _install(
+        self, translations: "_SupportedTranslations", newstyle: t.Optional[bool] = None
+    ) -> None:
+        # ugettext and ungettext are preferred in case the I18N library
+        # is providing compatibility with older Python versions.
+        gettext = getattr(translations, "ugettext", None)
+        if gettext is None:
+            gettext = translations.gettext
+        ngettext = getattr(translations, "ungettext", None)
+        if ngettext is None:
+            ngettext = translations.ngettext
+
+        pgettext = getattr(translations, "pgettext", None)
+        npgettext = getattr(translations, "npgettext", None)
+        self._install_callables(
+            gettext, ngettext, newstyle=newstyle, pgettext=pgettext, npgettext=npgettext
+        )
+
+    def _install_null(self, newstyle: t.Optional[bool] = None) -> None:
+        import gettext
+
+        translations = gettext.NullTranslations()
+
+        if hasattr(translations, "pgettext"):
+            # Python < 3.8
+            pgettext = translations.pgettext
+        else:
+
+            def pgettext(c: str, s: str) -> str:
+                return s
+
+        if hasattr(translations, "npgettext"):
+            npgettext = translations.npgettext
+        else:
+
+            def npgettext(c: str, s: str, p: str, n: int) -> str:
+                return s if n == 1 else p
+
+        self._install_callables(
+            gettext=translations.gettext,
+            ngettext=translations.ngettext,
+            newstyle=newstyle,
+            pgettext=pgettext,
+            npgettext=npgettext,
+        )
+
+    def _install_callables(
+        self,
+        gettext: t.Callable[[str], str],
+        ngettext: t.Callable[[str, str, int], str],
+        newstyle: t.Optional[bool] = None,
+        pgettext: t.Optional[t.Callable[[str, str], str]] = None,
+        npgettext: t.Optional[t.Callable[[str, str, str, int], str]] = None,
+    ) -> None:
+        if newstyle is not None:
+            self.environment.newstyle_gettext = newstyle  # type: ignore
+        if self.environment.newstyle_gettext:  # type: ignore
+            gettext = _make_new_gettext(gettext)
+            ngettext = _make_new_ngettext(ngettext)
+
+            if pgettext is not None:
+                pgettext = _make_new_pgettext(pgettext)
+
+            if npgettext is not None:
+                npgettext = _make_new_npgettext(npgettext)
+
+        self.environment.globals.update(
+            gettext=gettext, ngettext=ngettext, pgettext=pgettext, npgettext=npgettext
+        )
+
+    def _uninstall(self, translations: "_SupportedTranslations") -> None:
+        for key in ("gettext", "ngettext", "pgettext", "npgettext"):
+            self.environment.globals.pop(key, None)
+
+    def _extract(
+        self,
+        source: t.Union[str, nodes.Template],
+        gettext_functions: t.Sequence[str] = GETTEXT_FUNCTIONS,
+    ) -> t.Iterator[
+        t.Tuple[int, str, t.Union[t.Optional[str], t.Tuple[t.Optional[str], ...]]]
+    ]:
+        if isinstance(source, str):
+            source = self.environment.parse(source)
+        return extract_from_ast(source, gettext_functions)
+
+    def parse(self, parser: "Parser") -> t.Union[nodes.Node, t.List[nodes.Node]]:
+        """Parse a translatable tag."""
+        lineno = next(parser.stream).lineno
+
+        context = None
+        context_token = parser.stream.next_if("string")
+
+        if context_token is not None:
+            context = context_token.value
+
+        # find all the variables referenced.  Additionally a variable can be
+        # defined in the body of the trans block too, but this is checked at
+        # a later state.
+        plural_expr: t.Optional[nodes.Expr] = None
+        plural_expr_assignment: t.Optional[nodes.Assign] = None
+        num_called_num = False
+        variables: t.Dict[str, nodes.Expr] = {}
+        trimmed = None
+        while parser.stream.current.type != "block_end":
+            if variables:
+                parser.stream.expect("comma")
+
+            # skip colon for python compatibility
+            if parser.stream.skip_if("colon"):
+                break
+
+            token = parser.stream.expect("name")
+            if token.value in variables:
+                parser.fail(
+                    f"translatable variable {token.value!r} defined twice.",
+                    token.lineno,
+                    exc=TemplateAssertionError,
+                )
+
+            # expressions
+            if parser.stream.current.type == "assign":
+                next(parser.stream)
+                variables[token.value] = var = parser.parse_expression()
+            elif trimmed is None and token.value in ("trimmed", "notrimmed"):
+                trimmed = token.value == "trimmed"
+                continue
+            else:
+                variables[token.value] = var = nodes.Name(token.value, "load")
+
+            if plural_expr is None:
+                if isinstance(var, nodes.Call):
+                    plural_expr = nodes.Name("_trans", "load")
+                    variables[token.value] = plural_expr
+                    plural_expr_assignment = nodes.Assign(
+                        nodes.Name("_trans", "store"), var
+                    )
+                else:
+                    plural_expr = var
+                num_called_num = token.value == "num"
+
+        parser.stream.expect("block_end")
+
+        plural = None
+        have_plural = False
+        referenced = set()
+
+        # now parse until endtrans or pluralize
+        singular_names, singular = self._parse_block(parser, True)
+        if singular_names:
+            referenced.update(singular_names)
+            if plural_expr is None:
+                plural_expr = nodes.Name(singular_names[0], "load")
+                num_called_num = singular_names[0] == "num"
+
+        # if we have a pluralize block, we parse that too
+        if parser.stream.current.test("name:pluralize"):
+            have_plural = True
+            next(parser.stream)
+            if parser.stream.current.type != "block_end":
+                token = parser.stream.expect("name")
+                if token.value not in variables:
+                    parser.fail(
+                        f"unknown variable {token.value!r} for pluralization",
+                        token.lineno,
+                        exc=TemplateAssertionError,
+                    )
+                plural_expr = variables[token.value]
+                num_called_num = token.value == "num"
+            parser.stream.expect("block_end")
+            plural_names, plural = self._parse_block(parser, False)
+            next(parser.stream)
+            referenced.update(plural_names)
+        else:
+            next(parser.stream)
+
+        # register free names as simple name expressions
+        for name in referenced:
+            if name not in variables:
+                variables[name] = nodes.Name(name, "load")
+
+        if not have_plural:
+            plural_expr = None
+        elif plural_expr is None:
+            parser.fail("pluralize without variables", lineno)
+
+        if trimmed is None:
+            trimmed = self.environment.policies["ext.i18n.trimmed"]
+        if trimmed:
+            singular = self._trim_whitespace(singular)
+            if plural:
+                plural = self._trim_whitespace(plural)
+
+        node = self._make_node(
+            singular,
+            plural,
+            context,
+            variables,
+            plural_expr,
+            bool(referenced),
+            num_called_num and have_plural,
+        )
+        node.set_lineno(lineno)
+        if plural_expr_assignment is not None:
+            return [plural_expr_assignment, node]
+        else:
+            return node
+
+    def _trim_whitespace(self, string: str, _ws_re: t.Pattern[str] = _ws_re) -> str:
+        return _ws_re.sub(" ", string.strip())
+
+    def _parse_block(
+        self, parser: "Parser", allow_pluralize: bool
+    ) -> t.Tuple[t.List[str], str]:
+        """Parse until the next block tag with a given name."""
+        referenced = []
+        buf = []
+
+        while True:
+            if parser.stream.current.type == "data":
+                buf.append(parser.stream.current.value.replace("%", "%%"))
+                next(parser.stream)
+            elif parser.stream.current.type == "variable_begin":
+                next(parser.stream)
+                name = parser.stream.expect("name").value
+                referenced.append(name)
+                buf.append(f"%({name})s")
+                parser.stream.expect("variable_end")
+            elif parser.stream.current.type == "block_begin":
+                next(parser.stream)
+                block_name = (
+                    parser.stream.current.value
+                    if parser.stream.current.type == "name"
+                    else None
+                )
+                if block_name == "endtrans":
+                    break
+                elif block_name == "pluralize":
+                    if allow_pluralize:
+                        break
+                    parser.fail(
+                        "a translatable section can have only one pluralize section"
+                    )
+                elif block_name == "trans":
+                    parser.fail(
+                        "trans blocks can't be nested; did you mean `endtrans`?"
+                    )
+                parser.fail(
+                    f"control structures in translatable sections are not allowed; "
+                    f"saw `{block_name}`"
+                )
+            elif parser.stream.eos:
+                parser.fail("unclosed translation block")
+            else:
+                raise RuntimeError("internal parser error")
+
+        return referenced, concat(buf)
+
+    def _make_node(
+        self,
+        singular: str,
+        plural: t.Optional[str],
+        context: t.Optional[str],
+        variables: t.Dict[str, nodes.Expr],
+        plural_expr: t.Optional[nodes.Expr],
+        vars_referenced: bool,
+        num_called_num: bool,
+    ) -> nodes.Output:
+        """Generates a useful node from the data provided."""
+        newstyle = self.environment.newstyle_gettext  # type: ignore
+        node: nodes.Expr
+
+        # no variables referenced?  no need to escape for old style
+        # gettext invocations only if there are vars.
+        if not vars_referenced and not newstyle:
+            singular = singular.replace("%%", "%")
+            if plural:
+                plural = plural.replace("%%", "%")
+
+        func_name = "gettext"
+        func_args: t.List[nodes.Expr] = [nodes.Const(singular)]
+
+        if context is not None:
+            func_args.insert(0, nodes.Const(context))
+            func_name = f"p{func_name}"
+
+        if plural_expr is not None:
+            func_name = f"n{func_name}"
+            func_args.extend((nodes.Const(plural), plural_expr))
+
+        node = nodes.Call(nodes.Name(func_name, "load"), func_args, [], None, None)
+
+        # in case newstyle gettext is used, the method is powerful
+        # enough to handle the variable expansion and autoescape
+        # handling itself
+        if newstyle:
+            for key, value in variables.items():
+                # the function adds that later anyways in case num was
+                # called num, so just skip it.
+                if num_called_num and key == "num":
+                    continue
+                node.kwargs.append(nodes.Keyword(key, value))
+
+        # otherwise do that here
+        else:
+            # mark the return value as safe if we are in an
+            # environment with autoescaping turned on
+            node = nodes.MarkSafeIfAutoescape(node)
+            if variables:
+                node = nodes.Mod(
+                    node,
+                    nodes.Dict(
+                        [
+                            nodes.Pair(nodes.Const(key), value)
+                            for key, value in variables.items()
+                        ]
+                    ),
+                )
+        return nodes.Output([node])
+
+
+class ExprStmtExtension(Extension):
+    """Adds a `do` tag to Jinja that works like the print statement just
+    that it doesn't print the return value.
+    """
+
+    tags = {"do"}
+
+    def parse(self, parser: "Parser") -> nodes.ExprStmt:
+        node = nodes.ExprStmt(lineno=next(parser.stream).lineno)
+        node.node = parser.parse_tuple()
+        return node
+
+
+class LoopControlExtension(Extension):
+    """Adds break and continue to the template engine."""
+
+    tags = {"break", "continue"}
+
+    def parse(self, parser: "Parser") -> t.Union[nodes.Break, nodes.Continue]:
+        token = next(parser.stream)
+        if token.value == "break":
+            return nodes.Break(lineno=token.lineno)
+        return nodes.Continue(lineno=token.lineno)
+
+
+class DebugExtension(Extension):
+    """A ``{% debug %}`` tag that dumps the available variables,
+    filters, and tests.
+
+    .. code-block:: html+jinja
+
+        <pre>{% debug %}</pre>
+
+    .. code-block:: text
+
+        {'context': {'cycler': <class 'jinja2.utils.Cycler'>,
+                     ...,
+                     'namespace': <class 'jinja2.utils.Namespace'>},
+         'filters': ['abs', 'attr', 'batch', 'capitalize', 'center', 'count', 'd',
+                     ..., 'urlencode', 'urlize', 'wordcount', 'wordwrap', 'xmlattr'],
+         'tests': ['!=', '<', '<=', '==', '>', '>=', 'callable', 'defined',
+                   ..., 'odd', 'sameas', 'sequence', 'string', 'undefined', 'upper']}
+
+    .. versionadded:: 2.11.0
+    """
+
+    tags = {"debug"}
+
+    def parse(self, parser: "Parser") -> nodes.Output:
+        lineno = parser.stream.expect("name:debug").lineno
+        context = nodes.ContextReference()
+        result = self.call_method("_render", [context], lineno=lineno)
+        return nodes.Output([result], lineno=lineno)
+
+    def _render(self, context: Context) -> str:
+        result = {
+            "context": context.get_all(),
+            "filters": sorted(self.environment.filters.keys()),
+            "tests": sorted(self.environment.tests.keys()),
+        }
+
+        # Set the depth since the intent is to show the top few names.
+        return pprint.pformat(result, depth=3, compact=True)
+
+
+def extract_from_ast(
+    ast: nodes.Template,
+    gettext_functions: t.Sequence[str] = GETTEXT_FUNCTIONS,
+    babel_style: bool = True,
+) -> t.Iterator[
+    t.Tuple[int, str, t.Union[t.Optional[str], t.Tuple[t.Optional[str], ...]]]
+]:
+    """Extract localizable strings from the given template node.  Per
+    default this function returns matches in babel style that means non string
+    parameters as well as keyword arguments are returned as `None`.  This
+    allows Babel to figure out what you really meant if you are using
+    gettext functions that allow keyword arguments for placeholder expansion.
+    If you don't want that behavior set the `babel_style` parameter to `False`
+    which causes only strings to be returned and parameters are always stored
+    in tuples.  As a consequence invalid gettext calls (calls without a single
+    string parameter or string parameters after non-string parameters) are
+    skipped.
+
+    This example explains the behavior:
+
+    >>> from jinja2 import Environment
+    >>> env = Environment()
+    >>> node = env.parse('{{ (_("foo"), _(), ngettext("foo", "bar", 42)) }}')
+    >>> list(extract_from_ast(node))
+    [(1, '_', 'foo'), (1, '_', ()), (1, 'ngettext', ('foo', 'bar', None))]
+    >>> list(extract_from_ast(node, babel_style=False))
+    [(1, '_', ('foo',)), (1, 'ngettext', ('foo', 'bar'))]
+
+    For every string found this function yields a ``(lineno, function,
+    message)`` tuple, where:
+
+    * ``lineno`` is the number of the line on which the string was found,
+    * ``function`` is the name of the ``gettext`` function used (if the
+      string was extracted from embedded Python code), and
+    *   ``message`` is the string, or a tuple of strings for functions
+         with multiple string arguments.
+
+    This extraction function operates on the AST and is because of that unable
+    to extract any comments.  For comment support you have to use the babel
+    extraction interface or extract comments yourself.
+    """
+    out: t.Union[t.Optional[str], t.Tuple[t.Optional[str], ...]]
+
+    for node in ast.find_all(nodes.Call):
+        if (
+            not isinstance(node.node, nodes.Name)
+            or node.node.name not in gettext_functions
+        ):
+            continue
+
+        strings: t.List[t.Optional[str]] = []
+
+        for arg in node.args:
+            if isinstance(arg, nodes.Const) and isinstance(arg.value, str):
+                strings.append(arg.value)
+            else:
+                strings.append(None)
+
+        for _ in node.kwargs:
+            strings.append(None)
+        if node.dyn_args is not None:
+            strings.append(None)
+        if node.dyn_kwargs is not None:
+            strings.append(None)
+
+        if not babel_style:
+            out = tuple(x for x in strings if x is not None)
+
+            if not out:
+                continue
+        else:
+            if len(strings) == 1:
+                out = strings[0]
+            else:
+                out = tuple(strings)
+
+        yield node.lineno, node.node.name, out
+
+
+class _CommentFinder:
+    """Helper class to find comments in a token stream.  Can only
+    find comments for gettext calls forwards.  Once the comment
+    from line 4 is found, a comment for line 1 will not return a
+    usable value.
+    """
+
+    def __init__(
+        self, tokens: t.Sequence[t.Tuple[int, str, str]], comment_tags: t.Sequence[str]
+    ) -> None:
+        self.tokens = tokens
+        self.comment_tags = comment_tags
+        self.offset = 0
+        self.last_lineno = 0
+
+    def find_backwards(self, offset: int) -> t.List[str]:
+        try:
+            for _, token_type, token_value in reversed(
+                self.tokens[self.offset : offset]
+            ):
+                if token_type in ("comment", "linecomment"):
+                    try:
+                        prefix, comment = token_value.split(None, 1)
+                    except ValueError:
+                        continue
+                    if prefix in self.comment_tags:
+                        return [comment.rstrip()]
+            return []
+        finally:
+            self.offset = offset
+
+    def find_comments(self, lineno: int) -> t.List[str]:
+        if not self.comment_tags or self.last_lineno > lineno:
+            return []
+        for idx, (token_lineno, _, _) in enumerate(self.tokens[self.offset :]):
+            if token_lineno > lineno:
+                return self.find_backwards(self.offset + idx)
+        return self.find_backwards(len(self.tokens))
+
+
+def babel_extract(
+    fileobj: t.BinaryIO,
+    keywords: t.Sequence[str],
+    comment_tags: t.Sequence[str],
+    options: t.Dict[str, t.Any],
+) -> t.Iterator[
+    t.Tuple[
+        int, str, t.Union[t.Optional[str], t.Tuple[t.Optional[str], ...]], t.List[str]
+    ]
+]:
+    """Babel extraction method for Jinja templates.
+
+    .. versionchanged:: 2.3
+       Basic support for translation comments was added.  If `comment_tags`
+       is now set to a list of keywords for extraction, the extractor will
+       try to find the best preceding comment that begins with one of the
+       keywords.  For best results, make sure to not have more than one
+       gettext call in one line of code and the matching comment in the
+       same line or the line before.
+
+    .. versionchanged:: 2.5.1
+       The `newstyle_gettext` flag can be set to `True` to enable newstyle
+       gettext calls.
+
+    .. versionchanged:: 2.7
+       A `silent` option can now be provided.  If set to `False` template
+       syntax errors are propagated instead of being ignored.
+
+    :param fileobj: the file-like object the messages should be extracted from
+    :param keywords: a list of keywords (i.e. function names) that should be
+                     recognized as translation functions
+    :param comment_tags: a list of translator tags to search for and include
+                         in the results.
+    :param options: a dictionary of additional options (optional)
+    :return: an iterator over ``(lineno, funcname, message, comments)`` tuples.
+             (comments will be empty currently)
+    """
+    extensions: t.Dict[t.Type[Extension], None] = {}
+
+    for extension_name in options.get("extensions", "").split(","):
+        extension_name = extension_name.strip()
+
+        if not extension_name:
+            continue
+
+        extensions[import_string(extension_name)] = None
+
+    if InternationalizationExtension not in extensions:
+        extensions[InternationalizationExtension] = None
+
+    def getbool(options: t.Mapping[str, str], key: str, default: bool = False) -> bool:
+        return options.get(key, str(default)).lower() in {"1", "on", "yes", "true"}
+
+    silent = getbool(options, "silent", True)
+    environment = Environment(
+        options.get("block_start_string", defaults.BLOCK_START_STRING),
+        options.get("block_end_string", defaults.BLOCK_END_STRING),
+        options.get("variable_start_string", defaults.VARIABLE_START_STRING),
+        options.get("variable_end_string", defaults.VARIABLE_END_STRING),
+        options.get("comment_start_string", defaults.COMMENT_START_STRING),
+        options.get("comment_end_string", defaults.COMMENT_END_STRING),
+        options.get("line_statement_prefix") or defaults.LINE_STATEMENT_PREFIX,
+        options.get("line_comment_prefix") or defaults.LINE_COMMENT_PREFIX,
+        getbool(options, "trim_blocks", defaults.TRIM_BLOCKS),
+        getbool(options, "lstrip_blocks", defaults.LSTRIP_BLOCKS),
+        defaults.NEWLINE_SEQUENCE,
+        getbool(options, "keep_trailing_newline", defaults.KEEP_TRAILING_NEWLINE),
+        tuple(extensions),
+        cache_size=0,
+        auto_reload=False,
+    )
+
+    if getbool(options, "trimmed"):
+        environment.policies["ext.i18n.trimmed"] = True
+    if getbool(options, "newstyle_gettext"):
+        environment.newstyle_gettext = True  # type: ignore
+
+    source = fileobj.read().decode(options.get("encoding", "utf-8"))
+    try:
+        node = environment.parse(source)
+        tokens = list(environment.lex(environment.preprocess(source)))
+    except TemplateSyntaxError:
+        if not silent:
+            raise
+        # skip templates with syntax errors
+        return
+
+    finder = _CommentFinder(tokens, comment_tags)
+    for lineno, func, message in extract_from_ast(node, keywords):
+        yield lineno, func, message, finder.find_comments(lineno)
+
+
+#: nicer import names
+i18n = InternationalizationExtension
+do = ExprStmtExtension
+loopcontrols = LoopControlExtension
+debug = DebugExtension
diff --git a/llm/Lib/site-packages/jinja2/filters.py b/llm/Lib/site-packages/jinja2/filters.py
new file mode 100644
index 0000000000000000000000000000000000000000..c7ecc9bb683085b9e1a54a03258e2e4967aad6d9
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/filters.py
@@ -0,0 +1,1854 @@
+"""Built-in template filters used with the ``|`` operator."""
+import math
+import random
+import re
+import typing
+import typing as t
+from collections import abc
+from itertools import chain
+from itertools import groupby
+
+from markupsafe import escape
+from markupsafe import Markup
+from markupsafe import soft_str
+
+from .async_utils import async_variant
+from .async_utils import auto_aiter
+from .async_utils import auto_await
+from .async_utils import auto_to_list
+from .exceptions import FilterArgumentError
+from .runtime import Undefined
+from .utils import htmlsafe_json_dumps
+from .utils import pass_context
+from .utils import pass_environment
+from .utils import pass_eval_context
+from .utils import pformat
+from .utils import url_quote
+from .utils import urlize
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+    from .environment import Environment
+    from .nodes import EvalContext
+    from .runtime import Context
+    from .sandbox import SandboxedEnvironment  # noqa: F401
+
+    class HasHTML(te.Protocol):
+        def __html__(self) -> str:
+            pass
+
+
+F = t.TypeVar("F", bound=t.Callable[..., t.Any])
+K = t.TypeVar("K")
+V = t.TypeVar("V")
+
+
+def ignore_case(value: V) -> V:
+    """For use as a postprocessor for :func:`make_attrgetter`. Converts strings
+    to lowercase and returns other types as-is."""
+    if isinstance(value, str):
+        return t.cast(V, value.lower())
+
+    return value
+
+
+def make_attrgetter(
+    environment: "Environment",
+    attribute: t.Optional[t.Union[str, int]],
+    postprocess: t.Optional[t.Callable[[t.Any], t.Any]] = None,
+    default: t.Optional[t.Any] = None,
+) -> t.Callable[[t.Any], t.Any]:
+    """Returns a callable that looks up the given attribute from a
+    passed object with the rules of the environment.  Dots are allowed
+    to access attributes of attributes.  Integer parts in paths are
+    looked up as integers.
+    """
+    parts = _prepare_attribute_parts(attribute)
+
+    def attrgetter(item: t.Any) -> t.Any:
+        for part in parts:
+            item = environment.getitem(item, part)
+
+            if default is not None and isinstance(item, Undefined):
+                item = default
+
+        if postprocess is not None:
+            item = postprocess(item)
+
+        return item
+
+    return attrgetter
+
+
+def make_multi_attrgetter(
+    environment: "Environment",
+    attribute: t.Optional[t.Union[str, int]],
+    postprocess: t.Optional[t.Callable[[t.Any], t.Any]] = None,
+) -> t.Callable[[t.Any], t.List[t.Any]]:
+    """Returns a callable that looks up the given comma separated
+    attributes from a passed object with the rules of the environment.
+    Dots are allowed to access attributes of each attribute.  Integer
+    parts in paths are looked up as integers.
+
+    The value returned by the returned callable is a list of extracted
+    attribute values.
+
+    Examples of attribute: "attr1,attr2", "attr1.inner1.0,attr2.inner2.0", etc.
+    """
+    if isinstance(attribute, str):
+        split: t.Sequence[t.Union[str, int, None]] = attribute.split(",")
+    else:
+        split = [attribute]
+
+    parts = [_prepare_attribute_parts(item) for item in split]
+
+    def attrgetter(item: t.Any) -> t.List[t.Any]:
+        items = [None] * len(parts)
+
+        for i, attribute_part in enumerate(parts):
+            item_i = item
+
+            for part in attribute_part:
+                item_i = environment.getitem(item_i, part)
+
+            if postprocess is not None:
+                item_i = postprocess(item_i)
+
+            items[i] = item_i
+
+        return items
+
+    return attrgetter
+
+
+def _prepare_attribute_parts(
+    attr: t.Optional[t.Union[str, int]]
+) -> t.List[t.Union[str, int]]:
+    if attr is None:
+        return []
+
+    if isinstance(attr, str):
+        return [int(x) if x.isdigit() else x for x in attr.split(".")]
+
+    return [attr]
+
+
+def do_forceescape(value: "t.Union[str, HasHTML]") -> Markup:
+    """Enforce HTML escaping.  This will probably double escape variables."""
+    if hasattr(value, "__html__"):
+        value = t.cast("HasHTML", value).__html__()
+
+    return escape(str(value))
+
+
+def do_urlencode(
+    value: t.Union[str, t.Mapping[str, t.Any], t.Iterable[t.Tuple[str, t.Any]]]
+) -> str:
+    """Quote data for use in a URL path or query using UTF-8.
+
+    Basic wrapper around :func:`urllib.parse.quote` when given a
+    string, or :func:`urllib.parse.urlencode` for a dict or iterable.
+
+    :param value: Data to quote. A string will be quoted directly. A
+        dict or iterable of ``(key, value)`` pairs will be joined as a
+        query string.
+
+    When given a string, "/" is not quoted. HTTP servers treat "/" and
+    "%2F" equivalently in paths. If you need quoted slashes, use the
+    ``|replace("/", "%2F")`` filter.
+
+    .. versionadded:: 2.7
+    """
+    if isinstance(value, str) or not isinstance(value, abc.Iterable):
+        return url_quote(value)
+
+    if isinstance(value, dict):
+        items: t.Iterable[t.Tuple[str, t.Any]] = value.items()
+    else:
+        items = value  # type: ignore
+
+    return "&".join(
+        f"{url_quote(k, for_qs=True)}={url_quote(v, for_qs=True)}" for k, v in items
+    )
+
+
+@pass_eval_context
+def do_replace(
+    eval_ctx: "EvalContext", s: str, old: str, new: str, count: t.Optional[int] = None
+) -> str:
+    """Return a copy of the value with all occurrences of a substring
+    replaced with a new one. The first argument is the substring
+    that should be replaced, the second is the replacement string.
+    If the optional third argument ``count`` is given, only the first
+    ``count`` occurrences are replaced:
+
+    .. sourcecode:: jinja
+
+        {{ "Hello World"|replace("Hello", "Goodbye") }}
+            -> Goodbye World
+
+        {{ "aaaaargh"|replace("a", "d'oh, ", 2) }}
+            -> d'oh, d'oh, aaargh
+    """
+    if count is None:
+        count = -1
+
+    if not eval_ctx.autoescape:
+        return str(s).replace(str(old), str(new), count)
+
+    if (
+        hasattr(old, "__html__")
+        or hasattr(new, "__html__")
+        and not hasattr(s, "__html__")
+    ):
+        s = escape(s)
+    else:
+        s = soft_str(s)
+
+    return s.replace(soft_str(old), soft_str(new), count)
+
+
+def do_upper(s: str) -> str:
+    """Convert a value to uppercase."""
+    return soft_str(s).upper()
+
+
+def do_lower(s: str) -> str:
+    """Convert a value to lowercase."""
+    return soft_str(s).lower()
+
+
+def do_items(value: t.Union[t.Mapping[K, V], Undefined]) -> t.Iterator[t.Tuple[K, V]]:
+    """Return an iterator over the ``(key, value)`` items of a mapping.
+
+    ``x|items`` is the same as ``x.items()``, except if ``x`` is
+    undefined an empty iterator is returned.
+
+    This filter is useful if you expect the template to be rendered with
+    an implementation of Jinja in another programming language that does
+    not have a ``.items()`` method on its mapping type.
+
+    .. code-block:: html+jinja
+
+        <dl>
+        {% for key, value in my_dict|items %}
+            <dt>{{ key }}
+            <dd>{{ value }}
+        {% endfor %}
+        </dl>
+
+    .. versionadded:: 3.1
+    """
+    if isinstance(value, Undefined):
+        return
+
+    if not isinstance(value, abc.Mapping):
+        raise TypeError("Can only get item pairs from a mapping.")
+
+    yield from value.items()
+
+
+_space_re = re.compile(r"\s", flags=re.ASCII)
+
+
+@pass_eval_context
+def do_xmlattr(
+    eval_ctx: "EvalContext", d: t.Mapping[str, t.Any], autospace: bool = True
+) -> str:
+    """Create an SGML/XML attribute string based on the items in a dict.
+
+    If any key contains a space, this fails with a ``ValueError``. Values that
+    are neither ``none`` nor ``undefined`` are automatically escaped.
+
+    .. sourcecode:: html+jinja
+
+        <ul{{ {'class': 'my_list', 'missing': none,
+                'id': 'list-%d'|format(variable)}|xmlattr }}>
+        ...
+        </ul>
+
+    Results in something like this:
+
+    .. sourcecode:: html
+
+        <ul class="my_list" id="list-42">
+        ...
+        </ul>
+
+    As you can see it automatically prepends a space in front of the item
+    if the filter returned something unless the second parameter is false.
+
+    .. versionchanged:: 3.1.3
+        Keys with spaces are not allowed.
+    """
+    items = []
+
+    for key, value in d.items():
+        if value is None or isinstance(value, Undefined):
+            continue
+
+        if _space_re.search(key) is not None:
+            raise ValueError(f"Spaces are not allowed in attributes: '{key}'")
+
+        items.append(f'{escape(key)}="{escape(value)}"')
+
+    rv = " ".join(items)
+
+    if autospace and rv:
+        rv = " " + rv
+
+    if eval_ctx.autoescape:
+        rv = Markup(rv)
+
+    return rv
+
+
+def do_capitalize(s: str) -> str:
+    """Capitalize a value. The first character will be uppercase, all others
+    lowercase.
+    """
+    return soft_str(s).capitalize()
+
+
+_word_beginning_split_re = re.compile(r"([-\s({\[<]+)")
+
+
+def do_title(s: str) -> str:
+    """Return a titlecased version of the value. I.e. words will start with
+    uppercase letters, all remaining characters are lowercase.
+    """
+    return "".join(
+        [
+            item[0].upper() + item[1:].lower()
+            for item in _word_beginning_split_re.split(soft_str(s))
+            if item
+        ]
+    )
+
+
+def do_dictsort(
+    value: t.Mapping[K, V],
+    case_sensitive: bool = False,
+    by: 'te.Literal["key", "value"]' = "key",
+    reverse: bool = False,
+) -> t.List[t.Tuple[K, V]]:
+    """Sort a dict and yield (key, value) pairs. Python dicts may not
+    be in the order you want to display them in, so sort them first.
+
+    .. sourcecode:: jinja
+
+        {% for key, value in mydict|dictsort %}
+            sort the dict by key, case insensitive
+
+        {% for key, value in mydict|dictsort(reverse=true) %}
+            sort the dict by key, case insensitive, reverse order
+
+        {% for key, value in mydict|dictsort(true) %}
+            sort the dict by key, case sensitive
+
+        {% for key, value in mydict|dictsort(false, 'value') %}
+            sort the dict by value, case insensitive
+    """
+    if by == "key":
+        pos = 0
+    elif by == "value":
+        pos = 1
+    else:
+        raise FilterArgumentError('You can only sort by either "key" or "value"')
+
+    def sort_func(item: t.Tuple[t.Any, t.Any]) -> t.Any:
+        value = item[pos]
+
+        if not case_sensitive:
+            value = ignore_case(value)
+
+        return value
+
+    return sorted(value.items(), key=sort_func, reverse=reverse)
+
+
+@pass_environment
+def do_sort(
+    environment: "Environment",
+    value: "t.Iterable[V]",
+    reverse: bool = False,
+    case_sensitive: bool = False,
+    attribute: t.Optional[t.Union[str, int]] = None,
+) -> "t.List[V]":
+    """Sort an iterable using Python's :func:`sorted`.
+
+    .. sourcecode:: jinja
+
+        {% for city in cities|sort %}
+            ...
+        {% endfor %}
+
+    :param reverse: Sort descending instead of ascending.
+    :param case_sensitive: When sorting strings, sort upper and lower
+        case separately.
+    :param attribute: When sorting objects or dicts, an attribute or
+        key to sort by. Can use dot notation like ``"address.city"``.
+        Can be a list of attributes like ``"age,name"``.
+
+    The sort is stable, it does not change the relative order of
+    elements that compare equal. This makes it is possible to chain
+    sorts on different attributes and ordering.
+
+    .. sourcecode:: jinja
+
+        {% for user in users|sort(attribute="name")
+            |sort(reverse=true, attribute="age") %}
+            ...
+        {% endfor %}
+
+    As a shortcut to chaining when the direction is the same for all
+    attributes, pass a comma separate list of attributes.
+
+    .. sourcecode:: jinja
+
+        {% for user in users|sort(attribute="age,name") %}
+            ...
+        {% endfor %}
+
+    .. versionchanged:: 2.11.0
+        The ``attribute`` parameter can be a comma separated list of
+        attributes, e.g. ``"age,name"``.
+
+    .. versionchanged:: 2.6
+       The ``attribute`` parameter was added.
+    """
+    key_func = make_multi_attrgetter(
+        environment, attribute, postprocess=ignore_case if not case_sensitive else None
+    )
+    return sorted(value, key=key_func, reverse=reverse)
+
+
+@pass_environment
+def do_unique(
+    environment: "Environment",
+    value: "t.Iterable[V]",
+    case_sensitive: bool = False,
+    attribute: t.Optional[t.Union[str, int]] = None,
+) -> "t.Iterator[V]":
+    """Returns a list of unique items from the given iterable.
+
+    .. sourcecode:: jinja
+
+        {{ ['foo', 'bar', 'foobar', 'FooBar']|unique|list }}
+            -> ['foo', 'bar', 'foobar']
+
+    The unique items are yielded in the same order as their first occurrence in
+    the iterable passed to the filter.
+
+    :param case_sensitive: Treat upper and lower case strings as distinct.
+    :param attribute: Filter objects with unique values for this attribute.
+    """
+    getter = make_attrgetter(
+        environment, attribute, postprocess=ignore_case if not case_sensitive else None
+    )
+    seen = set()
+
+    for item in value:
+        key = getter(item)
+
+        if key not in seen:
+            seen.add(key)
+            yield item
+
+
+def _min_or_max(
+    environment: "Environment",
+    value: "t.Iterable[V]",
+    func: "t.Callable[..., V]",
+    case_sensitive: bool,
+    attribute: t.Optional[t.Union[str, int]],
+) -> "t.Union[V, Undefined]":
+    it = iter(value)
+
+    try:
+        first = next(it)
+    except StopIteration:
+        return environment.undefined("No aggregated item, sequence was empty.")
+
+    key_func = make_attrgetter(
+        environment, attribute, postprocess=ignore_case if not case_sensitive else None
+    )
+    return func(chain([first], it), key=key_func)
+
+
+@pass_environment
+def do_min(
+    environment: "Environment",
+    value: "t.Iterable[V]",
+    case_sensitive: bool = False,
+    attribute: t.Optional[t.Union[str, int]] = None,
+) -> "t.Union[V, Undefined]":
+    """Return the smallest item from the sequence.
+
+    .. sourcecode:: jinja
+
+        {{ [1, 2, 3]|min }}
+            -> 1
+
+    :param case_sensitive: Treat upper and lower case strings as distinct.
+    :param attribute: Get the object with the min value of this attribute.
+    """
+    return _min_or_max(environment, value, min, case_sensitive, attribute)
+
+
+@pass_environment
+def do_max(
+    environment: "Environment",
+    value: "t.Iterable[V]",
+    case_sensitive: bool = False,
+    attribute: t.Optional[t.Union[str, int]] = None,
+) -> "t.Union[V, Undefined]":
+    """Return the largest item from the sequence.
+
+    .. sourcecode:: jinja
+
+        {{ [1, 2, 3]|max }}
+            -> 3
+
+    :param case_sensitive: Treat upper and lower case strings as distinct.
+    :param attribute: Get the object with the max value of this attribute.
+    """
+    return _min_or_max(environment, value, max, case_sensitive, attribute)
+
+
+def do_default(
+    value: V,
+    default_value: V = "",  # type: ignore
+    boolean: bool = False,
+) -> V:
+    """If the value is undefined it will return the passed default value,
+    otherwise the value of the variable:
+
+    .. sourcecode:: jinja
+
+        {{ my_variable|default('my_variable is not defined') }}
+
+    This will output the value of ``my_variable`` if the variable was
+    defined, otherwise ``'my_variable is not defined'``. If you want
+    to use default with variables that evaluate to false you have to
+    set the second parameter to `true`:
+
+    .. sourcecode:: jinja
+
+        {{ ''|default('the string was empty', true) }}
+
+    .. versionchanged:: 2.11
+       It's now possible to configure the :class:`~jinja2.Environment` with
+       :class:`~jinja2.ChainableUndefined` to make the `default` filter work
+       on nested elements and attributes that may contain undefined values
+       in the chain without getting an :exc:`~jinja2.UndefinedError`.
+    """
+    if isinstance(value, Undefined) or (boolean and not value):
+        return default_value
+
+    return value
+
+
+@pass_eval_context
+def sync_do_join(
+    eval_ctx: "EvalContext",
+    value: t.Iterable,
+    d: str = "",
+    attribute: t.Optional[t.Union[str, int]] = None,
+) -> str:
+    """Return a string which is the concatenation of the strings in the
+    sequence. The separator between elements is an empty string per
+    default, you can define it with the optional parameter:
+
+    .. sourcecode:: jinja
+
+        {{ [1, 2, 3]|join('|') }}
+            -> 1|2|3
+
+        {{ [1, 2, 3]|join }}
+            -> 123
+
+    It is also possible to join certain attributes of an object:
+
+    .. sourcecode:: jinja
+
+        {{ users|join(', ', attribute='username') }}
+
+    .. versionadded:: 2.6
+       The `attribute` parameter was added.
+    """
+    if attribute is not None:
+        value = map(make_attrgetter(eval_ctx.environment, attribute), value)
+
+    # no automatic escaping?  joining is a lot easier then
+    if not eval_ctx.autoescape:
+        return str(d).join(map(str, value))
+
+    # if the delimiter doesn't have an html representation we check
+    # if any of the items has.  If yes we do a coercion to Markup
+    if not hasattr(d, "__html__"):
+        value = list(value)
+        do_escape = False
+
+        for idx, item in enumerate(value):
+            if hasattr(item, "__html__"):
+                do_escape = True
+            else:
+                value[idx] = str(item)
+
+        if do_escape:
+            d = escape(d)
+        else:
+            d = str(d)
+
+        return d.join(value)
+
+    # no html involved, to normal joining
+    return soft_str(d).join(map(soft_str, value))
+
+
+@async_variant(sync_do_join)  # type: ignore
+async def do_join(
+    eval_ctx: "EvalContext",
+    value: t.Union[t.AsyncIterable, t.Iterable],
+    d: str = "",
+    attribute: t.Optional[t.Union[str, int]] = None,
+) -> str:
+    return sync_do_join(eval_ctx, await auto_to_list(value), d, attribute)
+
+
+def do_center(value: str, width: int = 80) -> str:
+    """Centers the value in a field of a given width."""
+    return soft_str(value).center(width)
+
+
+@pass_environment
+def sync_do_first(
+    environment: "Environment", seq: "t.Iterable[V]"
+) -> "t.Union[V, Undefined]":
+    """Return the first item of a sequence."""
+    try:
+        return next(iter(seq))
+    except StopIteration:
+        return environment.undefined("No first item, sequence was empty.")
+
+
+@async_variant(sync_do_first)  # type: ignore
+async def do_first(
+    environment: "Environment", seq: "t.Union[t.AsyncIterable[V], t.Iterable[V]]"
+) -> "t.Union[V, Undefined]":
+    try:
+        return await auto_aiter(seq).__anext__()
+    except StopAsyncIteration:
+        return environment.undefined("No first item, sequence was empty.")
+
+
+@pass_environment
+def do_last(
+    environment: "Environment", seq: "t.Reversible[V]"
+) -> "t.Union[V, Undefined]":
+    """Return the last item of a sequence.
+
+    Note: Does not work with generators. You may want to explicitly
+    convert it to a list:
+
+    .. sourcecode:: jinja
+
+        {{ data | selectattr('name', '==', 'Jinja') | list | last }}
+    """
+    try:
+        return next(iter(reversed(seq)))
+    except StopIteration:
+        return environment.undefined("No last item, sequence was empty.")
+
+
+# No async do_last, it may not be safe in async mode.
+
+
+@pass_context
+def do_random(context: "Context", seq: "t.Sequence[V]") -> "t.Union[V, Undefined]":
+    """Return a random item from the sequence."""
+    try:
+        return random.choice(seq)
+    except IndexError:
+        return context.environment.undefined("No random item, sequence was empty.")
+
+
+def do_filesizeformat(value: t.Union[str, float, int], binary: bool = False) -> str:
+    """Format the value like a 'human-readable' file size (i.e. 13 kB,
+    4.1 MB, 102 Bytes, etc).  Per default decimal prefixes are used (Mega,
+    Giga, etc.), if the second parameter is set to `True` the binary
+    prefixes are used (Mebi, Gibi).
+    """
+    bytes = float(value)
+    base = 1024 if binary else 1000
+    prefixes = [
+        ("KiB" if binary else "kB"),
+        ("MiB" if binary else "MB"),
+        ("GiB" if binary else "GB"),
+        ("TiB" if binary else "TB"),
+        ("PiB" if binary else "PB"),
+        ("EiB" if binary else "EB"),
+        ("ZiB" if binary else "ZB"),
+        ("YiB" if binary else "YB"),
+    ]
+
+    if bytes == 1:
+        return "1 Byte"
+    elif bytes < base:
+        return f"{int(bytes)} Bytes"
+    else:
+        for i, prefix in enumerate(prefixes):
+            unit = base ** (i + 2)
+
+            if bytes < unit:
+                return f"{base * bytes / unit:.1f} {prefix}"
+
+        return f"{base * bytes / unit:.1f} {prefix}"
+
+
+def do_pprint(value: t.Any) -> str:
+    """Pretty print a variable. Useful for debugging."""
+    return pformat(value)
+
+
+_uri_scheme_re = re.compile(r"^([\w.+-]{2,}:(/){0,2})$")
+
+
+@pass_eval_context
+def do_urlize(
+    eval_ctx: "EvalContext",
+    value: str,
+    trim_url_limit: t.Optional[int] = None,
+    nofollow: bool = False,
+    target: t.Optional[str] = None,
+    rel: t.Optional[str] = None,
+    extra_schemes: t.Optional[t.Iterable[str]] = None,
+) -> str:
+    """Convert URLs in text into clickable links.
+
+    This may not recognize links in some situations. Usually, a more
+    comprehensive formatter, such as a Markdown library, is a better
+    choice.
+
+    Works on ``http://``, ``https://``, ``www.``, ``mailto:``, and email
+    addresses. Links with trailing punctuation (periods, commas, closing
+    parentheses) and leading punctuation (opening parentheses) are
+    recognized excluding the punctuation. Email addresses that include
+    header fields are not recognized (for example,
+    ``mailto:address@example.com?cc=copy@example.com``).
+
+    :param value: Original text containing URLs to link.
+    :param trim_url_limit: Shorten displayed URL values to this length.
+    :param nofollow: Add the ``rel=nofollow`` attribute to links.
+    :param target: Add the ``target`` attribute to links.
+    :param rel: Add the ``rel`` attribute to links.
+    :param extra_schemes: Recognize URLs that start with these schemes
+        in addition to the default behavior. Defaults to
+        ``env.policies["urlize.extra_schemes"]``, which defaults to no
+        extra schemes.
+
+    .. versionchanged:: 3.0
+        The ``extra_schemes`` parameter was added.
+
+    .. versionchanged:: 3.0
+        Generate ``https://`` links for URLs without a scheme.
+
+    .. versionchanged:: 3.0
+        The parsing rules were updated. Recognize email addresses with
+        or without the ``mailto:`` scheme. Validate IP addresses. Ignore
+        parentheses and brackets in more cases.
+
+    .. versionchanged:: 2.8
+       The ``target`` parameter was added.
+    """
+    policies = eval_ctx.environment.policies
+    rel_parts = set((rel or "").split())
+
+    if nofollow:
+        rel_parts.add("nofollow")
+
+    rel_parts.update((policies["urlize.rel"] or "").split())
+    rel = " ".join(sorted(rel_parts)) or None
+
+    if target is None:
+        target = policies["urlize.target"]
+
+    if extra_schemes is None:
+        extra_schemes = policies["urlize.extra_schemes"] or ()
+
+    for scheme in extra_schemes:
+        if _uri_scheme_re.fullmatch(scheme) is None:
+            raise FilterArgumentError(f"{scheme!r} is not a valid URI scheme prefix.")
+
+    rv = urlize(
+        value,
+        trim_url_limit=trim_url_limit,
+        rel=rel,
+        target=target,
+        extra_schemes=extra_schemes,
+    )
+
+    if eval_ctx.autoescape:
+        rv = Markup(rv)
+
+    return rv
+
+
+def do_indent(
+    s: str, width: t.Union[int, str] = 4, first: bool = False, blank: bool = False
+) -> str:
+    """Return a copy of the string with each line indented by 4 spaces. The
+    first line and blank lines are not indented by default.
+
+    :param width: Number of spaces, or a string, to indent by.
+    :param first: Don't skip indenting the first line.
+    :param blank: Don't skip indenting empty lines.
+
+    .. versionchanged:: 3.0
+        ``width`` can be a string.
+
+    .. versionchanged:: 2.10
+        Blank lines are not indented by default.
+
+        Rename the ``indentfirst`` argument to ``first``.
+    """
+    if isinstance(width, str):
+        indention = width
+    else:
+        indention = " " * width
+
+    newline = "\n"
+
+    if isinstance(s, Markup):
+        indention = Markup(indention)
+        newline = Markup(newline)
+
+    s += newline  # this quirk is necessary for splitlines method
+
+    if blank:
+        rv = (newline + indention).join(s.splitlines())
+    else:
+        lines = s.splitlines()
+        rv = lines.pop(0)
+
+        if lines:
+            rv += newline + newline.join(
+                indention + line if line else line for line in lines
+            )
+
+    if first:
+        rv = indention + rv
+
+    return rv
+
+
+@pass_environment
+def do_truncate(
+    env: "Environment",
+    s: str,
+    length: int = 255,
+    killwords: bool = False,
+    end: str = "...",
+    leeway: t.Optional[int] = None,
+) -> str:
+    """Return a truncated copy of the string. The length is specified
+    with the first parameter which defaults to ``255``. If the second
+    parameter is ``true`` the filter will cut the text at length. Otherwise
+    it will discard the last word. If the text was in fact
+    truncated it will append an ellipsis sign (``"..."``). If you want a
+    different ellipsis sign than ``"..."`` you can specify it using the
+    third parameter. Strings that only exceed the length by the tolerance
+    margin given in the fourth parameter will not be truncated.
+
+    .. sourcecode:: jinja
+
+        {{ "foo bar baz qux"|truncate(9) }}
+            -> "foo..."
+        {{ "foo bar baz qux"|truncate(9, True) }}
+            -> "foo ba..."
+        {{ "foo bar baz qux"|truncate(11) }}
+            -> "foo bar baz qux"
+        {{ "foo bar baz qux"|truncate(11, False, '...', 0) }}
+            -> "foo bar..."
+
+    The default leeway on newer Jinja versions is 5 and was 0 before but
+    can be reconfigured globally.
+    """
+    if leeway is None:
+        leeway = env.policies["truncate.leeway"]
+
+    assert length >= len(end), f"expected length >= {len(end)}, got {length}"
+    assert leeway >= 0, f"expected leeway >= 0, got {leeway}"
+
+    if len(s) <= length + leeway:
+        return s
+
+    if killwords:
+        return s[: length - len(end)] + end
+
+    result = s[: length - len(end)].rsplit(" ", 1)[0]
+    return result + end
+
+
+@pass_environment
+def do_wordwrap(
+    environment: "Environment",
+    s: str,
+    width: int = 79,
+    break_long_words: bool = True,
+    wrapstring: t.Optional[str] = None,
+    break_on_hyphens: bool = True,
+) -> str:
+    """Wrap a string to the given width. Existing newlines are treated
+    as paragraphs to be wrapped separately.
+
+    :param s: Original text to wrap.
+    :param width: Maximum length of wrapped lines.
+    :param break_long_words: If a word is longer than ``width``, break
+        it across lines.
+    :param break_on_hyphens: If a word contains hyphens, it may be split
+        across lines.
+    :param wrapstring: String to join each wrapped line. Defaults to
+        :attr:`Environment.newline_sequence`.
+
+    .. versionchanged:: 2.11
+        Existing newlines are treated as paragraphs wrapped separately.
+
+    .. versionchanged:: 2.11
+        Added the ``break_on_hyphens`` parameter.
+
+    .. versionchanged:: 2.7
+        Added the ``wrapstring`` parameter.
+    """
+    import textwrap
+
+    if wrapstring is None:
+        wrapstring = environment.newline_sequence
+
+    # textwrap.wrap doesn't consider existing newlines when wrapping.
+    # If the string has a newline before width, wrap will still insert
+    # a newline at width, resulting in a short line. Instead, split and
+    # wrap each paragraph individually.
+    return wrapstring.join(
+        [
+            wrapstring.join(
+                textwrap.wrap(
+                    line,
+                    width=width,
+                    expand_tabs=False,
+                    replace_whitespace=False,
+                    break_long_words=break_long_words,
+                    break_on_hyphens=break_on_hyphens,
+                )
+            )
+            for line in s.splitlines()
+        ]
+    )
+
+
+_word_re = re.compile(r"\w+")
+
+
+def do_wordcount(s: str) -> int:
+    """Count the words in that string."""
+    return len(_word_re.findall(soft_str(s)))
+
+
+def do_int(value: t.Any, default: int = 0, base: int = 10) -> int:
+    """Convert the value into an integer. If the
+    conversion doesn't work it will return ``0``. You can
+    override this default using the first parameter. You
+    can also override the default base (10) in the second
+    parameter, which handles input with prefixes such as
+    0b, 0o and 0x for bases 2, 8 and 16 respectively.
+    The base is ignored for decimal numbers and non-string values.
+    """
+    try:
+        if isinstance(value, str):
+            return int(value, base)
+
+        return int(value)
+    except (TypeError, ValueError):
+        # this quirk is necessary so that "42.23"|int gives 42.
+        try:
+            return int(float(value))
+        except (TypeError, ValueError):
+            return default
+
+
+def do_float(value: t.Any, default: float = 0.0) -> float:
+    """Convert the value into a floating point number. If the
+    conversion doesn't work it will return ``0.0``. You can
+    override this default using the first parameter.
+    """
+    try:
+        return float(value)
+    except (TypeError, ValueError):
+        return default
+
+
+def do_format(value: str, *args: t.Any, **kwargs: t.Any) -> str:
+    """Apply the given values to a `printf-style`_ format string, like
+    ``string % values``.
+
+    .. sourcecode:: jinja
+
+        {{ "%s, %s!"|format(greeting, name) }}
+        Hello, World!
+
+    In most cases it should be more convenient and efficient to use the
+    ``%`` operator or :meth:`str.format`.
+
+    .. code-block:: text
+
+        {{ "%s, %s!" % (greeting, name) }}
+        {{ "{}, {}!".format(greeting, name) }}
+
+    .. _printf-style: https://docs.python.org/library/stdtypes.html
+        #printf-style-string-formatting
+    """
+    if args and kwargs:
+        raise FilterArgumentError(
+            "can't handle positional and keyword arguments at the same time"
+        )
+
+    return soft_str(value) % (kwargs or args)
+
+
+def do_trim(value: str, chars: t.Optional[str] = None) -> str:
+    """Strip leading and trailing characters, by default whitespace."""
+    return soft_str(value).strip(chars)
+
+
+def do_striptags(value: "t.Union[str, HasHTML]") -> str:
+    """Strip SGML/XML tags and replace adjacent whitespace by one space."""
+    if hasattr(value, "__html__"):
+        value = t.cast("HasHTML", value).__html__()
+
+    return Markup(str(value)).striptags()
+
+
+def sync_do_slice(
+    value: "t.Collection[V]", slices: int, fill_with: "t.Optional[V]" = None
+) -> "t.Iterator[t.List[V]]":
+    """Slice an iterator and return a list of lists containing
+    those items. Useful if you want to create a div containing
+    three ul tags that represent columns:
+
+    .. sourcecode:: html+jinja
+
+        <div class="columnwrapper">
+          {%- for column in items|slice(3) %}
+            <ul class="column-{{ loop.index }}">
+            {%- for item in column %}
+              <li>{{ item }}</li>
+            {%- endfor %}
+            </ul>
+          {%- endfor %}
+        </div>
+
+    If you pass it a second argument it's used to fill missing
+    values on the last iteration.
+    """
+    seq = list(value)
+    length = len(seq)
+    items_per_slice = length // slices
+    slices_with_extra = length % slices
+    offset = 0
+
+    for slice_number in range(slices):
+        start = offset + slice_number * items_per_slice
+
+        if slice_number < slices_with_extra:
+            offset += 1
+
+        end = offset + (slice_number + 1) * items_per_slice
+        tmp = seq[start:end]
+
+        if fill_with is not None and slice_number >= slices_with_extra:
+            tmp.append(fill_with)
+
+        yield tmp
+
+
+@async_variant(sync_do_slice)  # type: ignore
+async def do_slice(
+    value: "t.Union[t.AsyncIterable[V], t.Iterable[V]]",
+    slices: int,
+    fill_with: t.Optional[t.Any] = None,
+) -> "t.Iterator[t.List[V]]":
+    return sync_do_slice(await auto_to_list(value), slices, fill_with)
+
+
+def do_batch(
+    value: "t.Iterable[V]", linecount: int, fill_with: "t.Optional[V]" = None
+) -> "t.Iterator[t.List[V]]":
+    """
+    A filter that batches items. It works pretty much like `slice`
+    just the other way round. It returns a list of lists with the
+    given number of items. If you provide a second parameter this
+    is used to fill up missing items. See this example:
+
+    .. sourcecode:: html+jinja
+
+        <table>
+        {%- for row in items|batch(3, '&nbsp;') %}
+          <tr>
+          {%- for column in row %}
+            <td>{{ column }}</td>
+          {%- endfor %}
+          </tr>
+        {%- endfor %}
+        </table>
+    """
+    tmp: "t.List[V]" = []
+
+    for item in value:
+        if len(tmp) == linecount:
+            yield tmp
+            tmp = []
+
+        tmp.append(item)
+
+    if tmp:
+        if fill_with is not None and len(tmp) < linecount:
+            tmp += [fill_with] * (linecount - len(tmp))
+
+        yield tmp
+
+
+def do_round(
+    value: float,
+    precision: int = 0,
+    method: 'te.Literal["common", "ceil", "floor"]' = "common",
+) -> float:
+    """Round the number to a given precision. The first
+    parameter specifies the precision (default is ``0``), the
+    second the rounding method:
+
+    - ``'common'`` rounds either up or down
+    - ``'ceil'`` always rounds up
+    - ``'floor'`` always rounds down
+
+    If you don't specify a method ``'common'`` is used.
+
+    .. sourcecode:: jinja
+
+        {{ 42.55|round }}
+            -> 43.0
+        {{ 42.55|round(1, 'floor') }}
+            -> 42.5
+
+    Note that even if rounded to 0 precision, a float is returned.  If
+    you need a real integer, pipe it through `int`:
+
+    .. sourcecode:: jinja
+
+        {{ 42.55|round|int }}
+            -> 43
+    """
+    if method not in {"common", "ceil", "floor"}:
+        raise FilterArgumentError("method must be common, ceil or floor")
+
+    if method == "common":
+        return round(value, precision)
+
+    func = getattr(math, method)
+    return t.cast(float, func(value * (10**precision)) / (10**precision))
+
+
+class _GroupTuple(t.NamedTuple):
+    grouper: t.Any
+    list: t.List
+
+    # Use the regular tuple repr to hide this subclass if users print
+    # out the value during debugging.
+    def __repr__(self) -> str:
+        return tuple.__repr__(self)
+
+    def __str__(self) -> str:
+        return tuple.__str__(self)
+
+
+@pass_environment
+def sync_do_groupby(
+    environment: "Environment",
+    value: "t.Iterable[V]",
+    attribute: t.Union[str, int],
+    default: t.Optional[t.Any] = None,
+    case_sensitive: bool = False,
+) -> "t.List[_GroupTuple]":
+    """Group a sequence of objects by an attribute using Python's
+    :func:`itertools.groupby`. The attribute can use dot notation for
+    nested access, like ``"address.city"``. Unlike Python's ``groupby``,
+    the values are sorted first so only one group is returned for each
+    unique value.
+
+    For example, a list of ``User`` objects with a ``city`` attribute
+    can be rendered in groups. In this example, ``grouper`` refers to
+    the ``city`` value of the group.
+
+    .. sourcecode:: html+jinja
+
+        <ul>{% for city, items in users|groupby("city") %}
+          <li>{{ city }}
+            <ul>{% for user in items %}
+              <li>{{ user.name }}
+            {% endfor %}</ul>
+          </li>
+        {% endfor %}</ul>
+
+    ``groupby`` yields namedtuples of ``(grouper, list)``, which
+    can be used instead of the tuple unpacking above. ``grouper`` is the
+    value of the attribute, and ``list`` is the items with that value.
+
+    .. sourcecode:: html+jinja
+
+        <ul>{% for group in users|groupby("city") %}
+          <li>{{ group.grouper }}: {{ group.list|join(", ") }}
+        {% endfor %}</ul>
+
+    You can specify a ``default`` value to use if an object in the list
+    does not have the given attribute.
+
+    .. sourcecode:: jinja
+
+        <ul>{% for city, items in users|groupby("city", default="NY") %}
+          <li>{{ city }}: {{ items|map(attribute="name")|join(", ") }}</li>
+        {% endfor %}</ul>
+
+    Like the :func:`~jinja-filters.sort` filter, sorting and grouping is
+    case-insensitive by default. The ``key`` for each group will have
+    the case of the first item in that group of values. For example, if
+    a list of users has cities ``["CA", "NY", "ca"]``, the "CA" group
+    will have two values. This can be disabled by passing
+    ``case_sensitive=True``.
+
+    .. versionchanged:: 3.1
+        Added the ``case_sensitive`` parameter. Sorting and grouping is
+        case-insensitive by default, matching other filters that do
+        comparisons.
+
+    .. versionchanged:: 3.0
+        Added the ``default`` parameter.
+
+    .. versionchanged:: 2.6
+        The attribute supports dot notation for nested access.
+    """
+    expr = make_attrgetter(
+        environment,
+        attribute,
+        postprocess=ignore_case if not case_sensitive else None,
+        default=default,
+    )
+    out = [
+        _GroupTuple(key, list(values))
+        for key, values in groupby(sorted(value, key=expr), expr)
+    ]
+
+    if not case_sensitive:
+        # Return the real key from the first value instead of the lowercase key.
+        output_expr = make_attrgetter(environment, attribute, default=default)
+        out = [_GroupTuple(output_expr(values[0]), values) for _, values in out]
+
+    return out
+
+
+@async_variant(sync_do_groupby)  # type: ignore
+async def do_groupby(
+    environment: "Environment",
+    value: "t.Union[t.AsyncIterable[V], t.Iterable[V]]",
+    attribute: t.Union[str, int],
+    default: t.Optional[t.Any] = None,
+    case_sensitive: bool = False,
+) -> "t.List[_GroupTuple]":
+    expr = make_attrgetter(
+        environment,
+        attribute,
+        postprocess=ignore_case if not case_sensitive else None,
+        default=default,
+    )
+    out = [
+        _GroupTuple(key, await auto_to_list(values))
+        for key, values in groupby(sorted(await auto_to_list(value), key=expr), expr)
+    ]
+
+    if not case_sensitive:
+        # Return the real key from the first value instead of the lowercase key.
+        output_expr = make_attrgetter(environment, attribute, default=default)
+        out = [_GroupTuple(output_expr(values[0]), values) for _, values in out]
+
+    return out
+
+
+@pass_environment
+def sync_do_sum(
+    environment: "Environment",
+    iterable: "t.Iterable[V]",
+    attribute: t.Optional[t.Union[str, int]] = None,
+    start: V = 0,  # type: ignore
+) -> V:
+    """Returns the sum of a sequence of numbers plus the value of parameter
+    'start' (which defaults to 0).  When the sequence is empty it returns
+    start.
+
+    It is also possible to sum up only certain attributes:
+
+    .. sourcecode:: jinja
+
+        Total: {{ items|sum(attribute='price') }}
+
+    .. versionchanged:: 2.6
+       The ``attribute`` parameter was added to allow summing up over
+       attributes.  Also the ``start`` parameter was moved on to the right.
+    """
+    if attribute is not None:
+        iterable = map(make_attrgetter(environment, attribute), iterable)
+
+    return sum(iterable, start)  # type: ignore[no-any-return, call-overload]
+
+
+@async_variant(sync_do_sum)  # type: ignore
+async def do_sum(
+    environment: "Environment",
+    iterable: "t.Union[t.AsyncIterable[V], t.Iterable[V]]",
+    attribute: t.Optional[t.Union[str, int]] = None,
+    start: V = 0,  # type: ignore
+) -> V:
+    rv = start
+
+    if attribute is not None:
+        func = make_attrgetter(environment, attribute)
+    else:
+
+        def func(x: V) -> V:
+            return x
+
+    async for item in auto_aiter(iterable):
+        rv += func(item)
+
+    return rv
+
+
+def sync_do_list(value: "t.Iterable[V]") -> "t.List[V]":
+    """Convert the value into a list.  If it was a string the returned list
+    will be a list of characters.
+    """
+    return list(value)
+
+
+@async_variant(sync_do_list)  # type: ignore
+async def do_list(value: "t.Union[t.AsyncIterable[V], t.Iterable[V]]") -> "t.List[V]":
+    return await auto_to_list(value)
+
+
+def do_mark_safe(value: str) -> Markup:
+    """Mark the value as safe which means that in an environment with automatic
+    escaping enabled this variable will not be escaped.
+    """
+    return Markup(value)
+
+
+def do_mark_unsafe(value: str) -> str:
+    """Mark a value as unsafe.  This is the reverse operation for :func:`safe`."""
+    return str(value)
+
+
+@typing.overload
+def do_reverse(value: str) -> str:
+    ...
+
+
+@typing.overload
+def do_reverse(value: "t.Iterable[V]") -> "t.Iterable[V]":
+    ...
+
+
+def do_reverse(value: t.Union[str, t.Iterable[V]]) -> t.Union[str, t.Iterable[V]]:
+    """Reverse the object or return an iterator that iterates over it the other
+    way round.
+    """
+    if isinstance(value, str):
+        return value[::-1]
+
+    try:
+        return reversed(value)  # type: ignore
+    except TypeError:
+        try:
+            rv = list(value)
+            rv.reverse()
+            return rv
+        except TypeError as e:
+            raise FilterArgumentError("argument must be iterable") from e
+
+
+@pass_environment
+def do_attr(
+    environment: "Environment", obj: t.Any, name: str
+) -> t.Union[Undefined, t.Any]:
+    """Get an attribute of an object.  ``foo|attr("bar")`` works like
+    ``foo.bar`` just that always an attribute is returned and items are not
+    looked up.
+
+    See :ref:`Notes on subscriptions <notes-on-subscriptions>` for more details.
+    """
+    try:
+        name = str(name)
+    except UnicodeError:
+        pass
+    else:
+        try:
+            value = getattr(obj, name)
+        except AttributeError:
+            pass
+        else:
+            if environment.sandboxed:
+                environment = t.cast("SandboxedEnvironment", environment)
+
+                if not environment.is_safe_attribute(obj, name, value):
+                    return environment.unsafe_undefined(obj, name)
+
+            return value
+
+    return environment.undefined(obj=obj, name=name)
+
+
+@typing.overload
+def sync_do_map(
+    context: "Context", value: t.Iterable, name: str, *args: t.Any, **kwargs: t.Any
+) -> t.Iterable:
+    ...
+
+
+@typing.overload
+def sync_do_map(
+    context: "Context",
+    value: t.Iterable,
+    *,
+    attribute: str = ...,
+    default: t.Optional[t.Any] = None,
+) -> t.Iterable:
+    ...
+
+
+@pass_context
+def sync_do_map(
+    context: "Context", value: t.Iterable, *args: t.Any, **kwargs: t.Any
+) -> t.Iterable:
+    """Applies a filter on a sequence of objects or looks up an attribute.
+    This is useful when dealing with lists of objects but you are really
+    only interested in a certain value of it.
+
+    The basic usage is mapping on an attribute.  Imagine you have a list
+    of users but you are only interested in a list of usernames:
+
+    .. sourcecode:: jinja
+
+        Users on this page: {{ users|map(attribute='username')|join(', ') }}
+
+    You can specify a ``default`` value to use if an object in the list
+    does not have the given attribute.
+
+    .. sourcecode:: jinja
+
+        {{ users|map(attribute="username", default="Anonymous")|join(", ") }}
+
+    Alternatively you can let it invoke a filter by passing the name of the
+    filter and the arguments afterwards.  A good example would be applying a
+    text conversion filter on a sequence:
+
+    .. sourcecode:: jinja
+
+        Users on this page: {{ titles|map('lower')|join(', ') }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (u.username for u in users)
+        (getattr(u, "username", "Anonymous") for u in users)
+        (do_lower(x) for x in titles)
+
+    .. versionchanged:: 2.11.0
+        Added the ``default`` parameter.
+
+    .. versionadded:: 2.7
+    """
+    if value:
+        func = prepare_map(context, args, kwargs)
+
+        for item in value:
+            yield func(item)
+
+
+@typing.overload
+def do_map(
+    context: "Context",
+    value: t.Union[t.AsyncIterable, t.Iterable],
+    name: str,
+    *args: t.Any,
+    **kwargs: t.Any,
+) -> t.Iterable:
+    ...
+
+
+@typing.overload
+def do_map(
+    context: "Context",
+    value: t.Union[t.AsyncIterable, t.Iterable],
+    *,
+    attribute: str = ...,
+    default: t.Optional[t.Any] = None,
+) -> t.Iterable:
+    ...
+
+
+@async_variant(sync_do_map)  # type: ignore
+async def do_map(
+    context: "Context",
+    value: t.Union[t.AsyncIterable, t.Iterable],
+    *args: t.Any,
+    **kwargs: t.Any,
+) -> t.AsyncIterable:
+    if value:
+        func = prepare_map(context, args, kwargs)
+
+        async for item in auto_aiter(value):
+            yield await auto_await(func(item))
+
+
+@pass_context
+def sync_do_select(
+    context: "Context", value: "t.Iterable[V]", *args: t.Any, **kwargs: t.Any
+) -> "t.Iterator[V]":
+    """Filters a sequence of objects by applying a test to each object,
+    and only selecting the objects with the test succeeding.
+
+    If no test is specified, each object will be evaluated as a boolean.
+
+    Example usage:
+
+    .. sourcecode:: jinja
+
+        {{ numbers|select("odd") }}
+        {{ numbers|select("odd") }}
+        {{ numbers|select("divisibleby", 3) }}
+        {{ numbers|select("lessthan", 42) }}
+        {{ strings|select("equalto", "mystring") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (n for n in numbers if test_odd(n))
+        (n for n in numbers if test_divisibleby(n, 3))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(context, value, args, kwargs, lambda x: x, False)
+
+
+@async_variant(sync_do_select)  # type: ignore
+async def do_select(
+    context: "Context",
+    value: "t.Union[t.AsyncIterable[V], t.Iterable[V]]",
+    *args: t.Any,
+    **kwargs: t.Any,
+) -> "t.AsyncIterator[V]":
+    return async_select_or_reject(context, value, args, kwargs, lambda x: x, False)
+
+
+@pass_context
+def sync_do_reject(
+    context: "Context", value: "t.Iterable[V]", *args: t.Any, **kwargs: t.Any
+) -> "t.Iterator[V]":
+    """Filters a sequence of objects by applying a test to each object,
+    and rejecting the objects with the test succeeding.
+
+    If no test is specified, each object will be evaluated as a boolean.
+
+    Example usage:
+
+    .. sourcecode:: jinja
+
+        {{ numbers|reject("odd") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (n for n in numbers if not test_odd(n))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(context, value, args, kwargs, lambda x: not x, False)
+
+
+@async_variant(sync_do_reject)  # type: ignore
+async def do_reject(
+    context: "Context",
+    value: "t.Union[t.AsyncIterable[V], t.Iterable[V]]",
+    *args: t.Any,
+    **kwargs: t.Any,
+) -> "t.AsyncIterator[V]":
+    return async_select_or_reject(context, value, args, kwargs, lambda x: not x, False)
+
+
+@pass_context
+def sync_do_selectattr(
+    context: "Context", value: "t.Iterable[V]", *args: t.Any, **kwargs: t.Any
+) -> "t.Iterator[V]":
+    """Filters a sequence of objects by applying a test to the specified
+    attribute of each object, and only selecting the objects with the
+    test succeeding.
+
+    If no test is specified, the attribute's value will be evaluated as
+    a boolean.
+
+    Example usage:
+
+    .. sourcecode:: jinja
+
+        {{ users|selectattr("is_active") }}
+        {{ users|selectattr("email", "none") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (u for user in users if user.is_active)
+        (u for user in users if test_none(user.email))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(context, value, args, kwargs, lambda x: x, True)
+
+
+@async_variant(sync_do_selectattr)  # type: ignore
+async def do_selectattr(
+    context: "Context",
+    value: "t.Union[t.AsyncIterable[V], t.Iterable[V]]",
+    *args: t.Any,
+    **kwargs: t.Any,
+) -> "t.AsyncIterator[V]":
+    return async_select_or_reject(context, value, args, kwargs, lambda x: x, True)
+
+
+@pass_context
+def sync_do_rejectattr(
+    context: "Context", value: "t.Iterable[V]", *args: t.Any, **kwargs: t.Any
+) -> "t.Iterator[V]":
+    """Filters a sequence of objects by applying a test to the specified
+    attribute of each object, and rejecting the objects with the test
+    succeeding.
+
+    If no test is specified, the attribute's value will be evaluated as
+    a boolean.
+
+    .. sourcecode:: jinja
+
+        {{ users|rejectattr("is_active") }}
+        {{ users|rejectattr("email", "none") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (u for user in users if not user.is_active)
+        (u for user in users if not test_none(user.email))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(context, value, args, kwargs, lambda x: not x, True)
+
+
+@async_variant(sync_do_rejectattr)  # type: ignore
+async def do_rejectattr(
+    context: "Context",
+    value: "t.Union[t.AsyncIterable[V], t.Iterable[V]]",
+    *args: t.Any,
+    **kwargs: t.Any,
+) -> "t.AsyncIterator[V]":
+    return async_select_or_reject(context, value, args, kwargs, lambda x: not x, True)
+
+
+@pass_eval_context
+def do_tojson(
+    eval_ctx: "EvalContext", value: t.Any, indent: t.Optional[int] = None
+) -> Markup:
+    """Serialize an object to a string of JSON, and mark it safe to
+    render in HTML. This filter is only for use in HTML documents.
+
+    The returned string is safe to render in HTML documents and
+    ``<script>`` tags. The exception is in HTML attributes that are
+    double quoted; either use single quotes or the ``|forceescape``
+    filter.
+
+    :param value: The object to serialize to JSON.
+    :param indent: The ``indent`` parameter passed to ``dumps``, for
+        pretty-printing the value.
+
+    .. versionadded:: 2.9
+    """
+    policies = eval_ctx.environment.policies
+    dumps = policies["json.dumps_function"]
+    kwargs = policies["json.dumps_kwargs"]
+
+    if indent is not None:
+        kwargs = kwargs.copy()
+        kwargs["indent"] = indent
+
+    return htmlsafe_json_dumps(value, dumps=dumps, **kwargs)
+
+
+def prepare_map(
+    context: "Context", args: t.Tuple, kwargs: t.Dict[str, t.Any]
+) -> t.Callable[[t.Any], t.Any]:
+    if not args and "attribute" in kwargs:
+        attribute = kwargs.pop("attribute")
+        default = kwargs.pop("default", None)
+
+        if kwargs:
+            raise FilterArgumentError(
+                f"Unexpected keyword argument {next(iter(kwargs))!r}"
+            )
+
+        func = make_attrgetter(context.environment, attribute, default=default)
+    else:
+        try:
+            name = args[0]
+            args = args[1:]
+        except LookupError:
+            raise FilterArgumentError("map requires a filter argument") from None
+
+        def func(item: t.Any) -> t.Any:
+            return context.environment.call_filter(
+                name, item, args, kwargs, context=context
+            )
+
+    return func
+
+
+def prepare_select_or_reject(
+    context: "Context",
+    args: t.Tuple,
+    kwargs: t.Dict[str, t.Any],
+    modfunc: t.Callable[[t.Any], t.Any],
+    lookup_attr: bool,
+) -> t.Callable[[t.Any], t.Any]:
+    if lookup_attr:
+        try:
+            attr = args[0]
+        except LookupError:
+            raise FilterArgumentError("Missing parameter for attribute name") from None
+
+        transfunc = make_attrgetter(context.environment, attr)
+        off = 1
+    else:
+        off = 0
+
+        def transfunc(x: V) -> V:
+            return x
+
+    try:
+        name = args[off]
+        args = args[1 + off :]
+
+        def func(item: t.Any) -> t.Any:
+            return context.environment.call_test(name, item, args, kwargs)
+
+    except LookupError:
+        func = bool  # type: ignore
+
+    return lambda item: modfunc(func(transfunc(item)))
+
+
+def select_or_reject(
+    context: "Context",
+    value: "t.Iterable[V]",
+    args: t.Tuple,
+    kwargs: t.Dict[str, t.Any],
+    modfunc: t.Callable[[t.Any], t.Any],
+    lookup_attr: bool,
+) -> "t.Iterator[V]":
+    if value:
+        func = prepare_select_or_reject(context, args, kwargs, modfunc, lookup_attr)
+
+        for item in value:
+            if func(item):
+                yield item
+
+
+async def async_select_or_reject(
+    context: "Context",
+    value: "t.Union[t.AsyncIterable[V], t.Iterable[V]]",
+    args: t.Tuple,
+    kwargs: t.Dict[str, t.Any],
+    modfunc: t.Callable[[t.Any], t.Any],
+    lookup_attr: bool,
+) -> "t.AsyncIterator[V]":
+    if value:
+        func = prepare_select_or_reject(context, args, kwargs, modfunc, lookup_attr)
+
+        async for item in auto_aiter(value):
+            if func(item):
+                yield item
+
+
+FILTERS = {
+    "abs": abs,
+    "attr": do_attr,
+    "batch": do_batch,
+    "capitalize": do_capitalize,
+    "center": do_center,
+    "count": len,
+    "d": do_default,
+    "default": do_default,
+    "dictsort": do_dictsort,
+    "e": escape,
+    "escape": escape,
+    "filesizeformat": do_filesizeformat,
+    "first": do_first,
+    "float": do_float,
+    "forceescape": do_forceescape,
+    "format": do_format,
+    "groupby": do_groupby,
+    "indent": do_indent,
+    "int": do_int,
+    "join": do_join,
+    "last": do_last,
+    "length": len,
+    "list": do_list,
+    "lower": do_lower,
+    "items": do_items,
+    "map": do_map,
+    "min": do_min,
+    "max": do_max,
+    "pprint": do_pprint,
+    "random": do_random,
+    "reject": do_reject,
+    "rejectattr": do_rejectattr,
+    "replace": do_replace,
+    "reverse": do_reverse,
+    "round": do_round,
+    "safe": do_mark_safe,
+    "select": do_select,
+    "selectattr": do_selectattr,
+    "slice": do_slice,
+    "sort": do_sort,
+    "string": soft_str,
+    "striptags": do_striptags,
+    "sum": do_sum,
+    "title": do_title,
+    "trim": do_trim,
+    "truncate": do_truncate,
+    "unique": do_unique,
+    "upper": do_upper,
+    "urlencode": do_urlencode,
+    "urlize": do_urlize,
+    "wordcount": do_wordcount,
+    "wordwrap": do_wordwrap,
+    "xmlattr": do_xmlattr,
+    "tojson": do_tojson,
+}
diff --git a/llm/Lib/site-packages/jinja2/idtracking.py b/llm/Lib/site-packages/jinja2/idtracking.py
new file mode 100644
index 0000000000000000000000000000000000000000..995ebaa0c8178ddb9e0479e0e9f6d30ed863a785
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/idtracking.py
@@ -0,0 +1,318 @@
+import typing as t
+
+from . import nodes
+from .visitor import NodeVisitor
+
+VAR_LOAD_PARAMETER = "param"
+VAR_LOAD_RESOLVE = "resolve"
+VAR_LOAD_ALIAS = "alias"
+VAR_LOAD_UNDEFINED = "undefined"
+
+
+def find_symbols(
+    nodes: t.Iterable[nodes.Node], parent_symbols: t.Optional["Symbols"] = None
+) -> "Symbols":
+    sym = Symbols(parent=parent_symbols)
+    visitor = FrameSymbolVisitor(sym)
+    for node in nodes:
+        visitor.visit(node)
+    return sym
+
+
+def symbols_for_node(
+    node: nodes.Node, parent_symbols: t.Optional["Symbols"] = None
+) -> "Symbols":
+    sym = Symbols(parent=parent_symbols)
+    sym.analyze_node(node)
+    return sym
+
+
+class Symbols:
+    def __init__(
+        self, parent: t.Optional["Symbols"] = None, level: t.Optional[int] = None
+    ) -> None:
+        if level is None:
+            if parent is None:
+                level = 0
+            else:
+                level = parent.level + 1
+
+        self.level: int = level
+        self.parent = parent
+        self.refs: t.Dict[str, str] = {}
+        self.loads: t.Dict[str, t.Any] = {}
+        self.stores: t.Set[str] = set()
+
+    def analyze_node(self, node: nodes.Node, **kwargs: t.Any) -> None:
+        visitor = RootVisitor(self)
+        visitor.visit(node, **kwargs)
+
+    def _define_ref(
+        self, name: str, load: t.Optional[t.Tuple[str, t.Optional[str]]] = None
+    ) -> str:
+        ident = f"l_{self.level}_{name}"
+        self.refs[name] = ident
+        if load is not None:
+            self.loads[ident] = load
+        return ident
+
+    def find_load(self, target: str) -> t.Optional[t.Any]:
+        if target in self.loads:
+            return self.loads[target]
+
+        if self.parent is not None:
+            return self.parent.find_load(target)
+
+        return None
+
+    def find_ref(self, name: str) -> t.Optional[str]:
+        if name in self.refs:
+            return self.refs[name]
+
+        if self.parent is not None:
+            return self.parent.find_ref(name)
+
+        return None
+
+    def ref(self, name: str) -> str:
+        rv = self.find_ref(name)
+        if rv is None:
+            raise AssertionError(
+                "Tried to resolve a name to a reference that was"
+                f" unknown to the frame ({name!r})"
+            )
+        return rv
+
+    def copy(self) -> "Symbols":
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.refs = self.refs.copy()
+        rv.loads = self.loads.copy()
+        rv.stores = self.stores.copy()
+        return rv
+
+    def store(self, name: str) -> None:
+        self.stores.add(name)
+
+        # If we have not see the name referenced yet, we need to figure
+        # out what to set it to.
+        if name not in self.refs:
+            # If there is a parent scope we check if the name has a
+            # reference there.  If it does it means we might have to alias
+            # to a variable there.
+            if self.parent is not None:
+                outer_ref = self.parent.find_ref(name)
+                if outer_ref is not None:
+                    self._define_ref(name, load=(VAR_LOAD_ALIAS, outer_ref))
+                    return
+
+            # Otherwise we can just set it to undefined.
+            self._define_ref(name, load=(VAR_LOAD_UNDEFINED, None))
+
+    def declare_parameter(self, name: str) -> str:
+        self.stores.add(name)
+        return self._define_ref(name, load=(VAR_LOAD_PARAMETER, None))
+
+    def load(self, name: str) -> None:
+        if self.find_ref(name) is None:
+            self._define_ref(name, load=(VAR_LOAD_RESOLVE, name))
+
+    def branch_update(self, branch_symbols: t.Sequence["Symbols"]) -> None:
+        stores: t.Dict[str, int] = {}
+        for branch in branch_symbols:
+            for target in branch.stores:
+                if target in self.stores:
+                    continue
+                stores[target] = stores.get(target, 0) + 1
+
+        for sym in branch_symbols:
+            self.refs.update(sym.refs)
+            self.loads.update(sym.loads)
+            self.stores.update(sym.stores)
+
+        for name, branch_count in stores.items():
+            if branch_count == len(branch_symbols):
+                continue
+
+            target = self.find_ref(name)  # type: ignore
+            assert target is not None, "should not happen"
+
+            if self.parent is not None:
+                outer_target = self.parent.find_ref(name)
+                if outer_target is not None:
+                    self.loads[target] = (VAR_LOAD_ALIAS, outer_target)
+                    continue
+            self.loads[target] = (VAR_LOAD_RESOLVE, name)
+
+    def dump_stores(self) -> t.Dict[str, str]:
+        rv: t.Dict[str, str] = {}
+        node: t.Optional["Symbols"] = self
+
+        while node is not None:
+            for name in sorted(node.stores):
+                if name not in rv:
+                    rv[name] = self.find_ref(name)  # type: ignore
+
+            node = node.parent
+
+        return rv
+
+    def dump_param_targets(self) -> t.Set[str]:
+        rv = set()
+        node: t.Optional["Symbols"] = self
+
+        while node is not None:
+            for target, (instr, _) in self.loads.items():
+                if instr == VAR_LOAD_PARAMETER:
+                    rv.add(target)
+
+            node = node.parent
+
+        return rv
+
+
+class RootVisitor(NodeVisitor):
+    def __init__(self, symbols: "Symbols") -> None:
+        self.sym_visitor = FrameSymbolVisitor(symbols)
+
+    def _simple_visit(self, node: nodes.Node, **kwargs: t.Any) -> None:
+        for child in node.iter_child_nodes():
+            self.sym_visitor.visit(child)
+
+    visit_Template = _simple_visit
+    visit_Block = _simple_visit
+    visit_Macro = _simple_visit
+    visit_FilterBlock = _simple_visit
+    visit_Scope = _simple_visit
+    visit_If = _simple_visit
+    visit_ScopedEvalContextModifier = _simple_visit
+
+    def visit_AssignBlock(self, node: nodes.AssignBlock, **kwargs: t.Any) -> None:
+        for child in node.body:
+            self.sym_visitor.visit(child)
+
+    def visit_CallBlock(self, node: nodes.CallBlock, **kwargs: t.Any) -> None:
+        for child in node.iter_child_nodes(exclude=("call",)):
+            self.sym_visitor.visit(child)
+
+    def visit_OverlayScope(self, node: nodes.OverlayScope, **kwargs: t.Any) -> None:
+        for child in node.body:
+            self.sym_visitor.visit(child)
+
+    def visit_For(
+        self, node: nodes.For, for_branch: str = "body", **kwargs: t.Any
+    ) -> None:
+        if for_branch == "body":
+            self.sym_visitor.visit(node.target, store_as_param=True)
+            branch = node.body
+        elif for_branch == "else":
+            branch = node.else_
+        elif for_branch == "test":
+            self.sym_visitor.visit(node.target, store_as_param=True)
+            if node.test is not None:
+                self.sym_visitor.visit(node.test)
+            return
+        else:
+            raise RuntimeError("Unknown for branch")
+
+        if branch:
+            for item in branch:
+                self.sym_visitor.visit(item)
+
+    def visit_With(self, node: nodes.With, **kwargs: t.Any) -> None:
+        for target in node.targets:
+            self.sym_visitor.visit(target)
+        for child in node.body:
+            self.sym_visitor.visit(child)
+
+    def generic_visit(self, node: nodes.Node, *args: t.Any, **kwargs: t.Any) -> None:
+        raise NotImplementedError(f"Cannot find symbols for {type(node).__name__!r}")
+
+
+class FrameSymbolVisitor(NodeVisitor):
+    """A visitor for `Frame.inspect`."""
+
+    def __init__(self, symbols: "Symbols") -> None:
+        self.symbols = symbols
+
+    def visit_Name(
+        self, node: nodes.Name, store_as_param: bool = False, **kwargs: t.Any
+    ) -> None:
+        """All assignments to names go through this function."""
+        if store_as_param or node.ctx == "param":
+            self.symbols.declare_parameter(node.name)
+        elif node.ctx == "store":
+            self.symbols.store(node.name)
+        elif node.ctx == "load":
+            self.symbols.load(node.name)
+
+    def visit_NSRef(self, node: nodes.NSRef, **kwargs: t.Any) -> None:
+        self.symbols.load(node.name)
+
+    def visit_If(self, node: nodes.If, **kwargs: t.Any) -> None:
+        self.visit(node.test, **kwargs)
+        original_symbols = self.symbols
+
+        def inner_visit(nodes: t.Iterable[nodes.Node]) -> "Symbols":
+            self.symbols = rv = original_symbols.copy()
+
+            for subnode in nodes:
+                self.visit(subnode, **kwargs)
+
+            self.symbols = original_symbols
+            return rv
+
+        body_symbols = inner_visit(node.body)
+        elif_symbols = inner_visit(node.elif_)
+        else_symbols = inner_visit(node.else_ or ())
+        self.symbols.branch_update([body_symbols, elif_symbols, else_symbols])
+
+    def visit_Macro(self, node: nodes.Macro, **kwargs: t.Any) -> None:
+        self.symbols.store(node.name)
+
+    def visit_Import(self, node: nodes.Import, **kwargs: t.Any) -> None:
+        self.generic_visit(node, **kwargs)
+        self.symbols.store(node.target)
+
+    def visit_FromImport(self, node: nodes.FromImport, **kwargs: t.Any) -> None:
+        self.generic_visit(node, **kwargs)
+
+        for name in node.names:
+            if isinstance(name, tuple):
+                self.symbols.store(name[1])
+            else:
+                self.symbols.store(name)
+
+    def visit_Assign(self, node: nodes.Assign, **kwargs: t.Any) -> None:
+        """Visit assignments in the correct order."""
+        self.visit(node.node, **kwargs)
+        self.visit(node.target, **kwargs)
+
+    def visit_For(self, node: nodes.For, **kwargs: t.Any) -> None:
+        """Visiting stops at for blocks.  However the block sequence
+        is visited as part of the outer scope.
+        """
+        self.visit(node.iter, **kwargs)
+
+    def visit_CallBlock(self, node: nodes.CallBlock, **kwargs: t.Any) -> None:
+        self.visit(node.call, **kwargs)
+
+    def visit_FilterBlock(self, node: nodes.FilterBlock, **kwargs: t.Any) -> None:
+        self.visit(node.filter, **kwargs)
+
+    def visit_With(self, node: nodes.With, **kwargs: t.Any) -> None:
+        for target in node.values:
+            self.visit(target)
+
+    def visit_AssignBlock(self, node: nodes.AssignBlock, **kwargs: t.Any) -> None:
+        """Stop visiting at block assigns."""
+        self.visit(node.target, **kwargs)
+
+    def visit_Scope(self, node: nodes.Scope, **kwargs: t.Any) -> None:
+        """Stop visiting at scopes."""
+
+    def visit_Block(self, node: nodes.Block, **kwargs: t.Any) -> None:
+        """Stop visiting at blocks."""
+
+    def visit_OverlayScope(self, node: nodes.OverlayScope, **kwargs: t.Any) -> None:
+        """Do not visit into overlay scopes."""
diff --git a/llm/Lib/site-packages/jinja2/lexer.py b/llm/Lib/site-packages/jinja2/lexer.py
new file mode 100644
index 0000000000000000000000000000000000000000..aff7e9f993792e1ced39c93fc0d39dcb5bdd5fde
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/lexer.py
@@ -0,0 +1,866 @@
+"""Implements a Jinja / Python combination lexer. The ``Lexer`` class
+is used to do some preprocessing. It filters out invalid operators like
+the bitshift operators we don't allow in templates. It separates
+template code and python code in expressions.
+"""
+import re
+import typing as t
+from ast import literal_eval
+from collections import deque
+from sys import intern
+
+from ._identifier import pattern as name_re
+from .exceptions import TemplateSyntaxError
+from .utils import LRUCache
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+    from .environment import Environment
+
+# cache for the lexers. Exists in order to be able to have multiple
+# environments with the same lexer
+_lexer_cache: t.MutableMapping[t.Tuple, "Lexer"] = LRUCache(50)  # type: ignore
+
+# static regular expressions
+whitespace_re = re.compile(r"\s+")
+newline_re = re.compile(r"(\r\n|\r|\n)")
+string_re = re.compile(
+    r"('([^'\\]*(?:\\.[^'\\]*)*)'" r'|"([^"\\]*(?:\\.[^"\\]*)*)")', re.S
+)
+integer_re = re.compile(
+    r"""
+    (
+        0b(_?[0-1])+ # binary
+    |
+        0o(_?[0-7])+ # octal
+    |
+        0x(_?[\da-f])+ # hex
+    |
+        [1-9](_?\d)* # decimal
+    |
+        0(_?0)* # decimal zero
+    )
+    """,
+    re.IGNORECASE | re.VERBOSE,
+)
+float_re = re.compile(
+    r"""
+    (?<!\.)  # doesn't start with a .
+    (\d+_)*\d+  # digits, possibly _ separated
+    (
+        (\.(\d+_)*\d+)?  # optional fractional part
+        e[+\-]?(\d+_)*\d+  # exponent part
+    |
+        \.(\d+_)*\d+  # required fractional part
+    )
+    """,
+    re.IGNORECASE | re.VERBOSE,
+)
+
+# internal the tokens and keep references to them
+TOKEN_ADD = intern("add")
+TOKEN_ASSIGN = intern("assign")
+TOKEN_COLON = intern("colon")
+TOKEN_COMMA = intern("comma")
+TOKEN_DIV = intern("div")
+TOKEN_DOT = intern("dot")
+TOKEN_EQ = intern("eq")
+TOKEN_FLOORDIV = intern("floordiv")
+TOKEN_GT = intern("gt")
+TOKEN_GTEQ = intern("gteq")
+TOKEN_LBRACE = intern("lbrace")
+TOKEN_LBRACKET = intern("lbracket")
+TOKEN_LPAREN = intern("lparen")
+TOKEN_LT = intern("lt")
+TOKEN_LTEQ = intern("lteq")
+TOKEN_MOD = intern("mod")
+TOKEN_MUL = intern("mul")
+TOKEN_NE = intern("ne")
+TOKEN_PIPE = intern("pipe")
+TOKEN_POW = intern("pow")
+TOKEN_RBRACE = intern("rbrace")
+TOKEN_RBRACKET = intern("rbracket")
+TOKEN_RPAREN = intern("rparen")
+TOKEN_SEMICOLON = intern("semicolon")
+TOKEN_SUB = intern("sub")
+TOKEN_TILDE = intern("tilde")
+TOKEN_WHITESPACE = intern("whitespace")
+TOKEN_FLOAT = intern("float")
+TOKEN_INTEGER = intern("integer")
+TOKEN_NAME = intern("name")
+TOKEN_STRING = intern("string")
+TOKEN_OPERATOR = intern("operator")
+TOKEN_BLOCK_BEGIN = intern("block_begin")
+TOKEN_BLOCK_END = intern("block_end")
+TOKEN_VARIABLE_BEGIN = intern("variable_begin")
+TOKEN_VARIABLE_END = intern("variable_end")
+TOKEN_RAW_BEGIN = intern("raw_begin")
+TOKEN_RAW_END = intern("raw_end")
+TOKEN_COMMENT_BEGIN = intern("comment_begin")
+TOKEN_COMMENT_END = intern("comment_end")
+TOKEN_COMMENT = intern("comment")
+TOKEN_LINESTATEMENT_BEGIN = intern("linestatement_begin")
+TOKEN_LINESTATEMENT_END = intern("linestatement_end")
+TOKEN_LINECOMMENT_BEGIN = intern("linecomment_begin")
+TOKEN_LINECOMMENT_END = intern("linecomment_end")
+TOKEN_LINECOMMENT = intern("linecomment")
+TOKEN_DATA = intern("data")
+TOKEN_INITIAL = intern("initial")
+TOKEN_EOF = intern("eof")
+
+# bind operators to token types
+operators = {
+    "+": TOKEN_ADD,
+    "-": TOKEN_SUB,
+    "/": TOKEN_DIV,
+    "//": TOKEN_FLOORDIV,
+    "*": TOKEN_MUL,
+    "%": TOKEN_MOD,
+    "**": TOKEN_POW,
+    "~": TOKEN_TILDE,
+    "[": TOKEN_LBRACKET,
+    "]": TOKEN_RBRACKET,
+    "(": TOKEN_LPAREN,
+    ")": TOKEN_RPAREN,
+    "{": TOKEN_LBRACE,
+    "}": TOKEN_RBRACE,
+    "==": TOKEN_EQ,
+    "!=": TOKEN_NE,
+    ">": TOKEN_GT,
+    ">=": TOKEN_GTEQ,
+    "<": TOKEN_LT,
+    "<=": TOKEN_LTEQ,
+    "=": TOKEN_ASSIGN,
+    ".": TOKEN_DOT,
+    ":": TOKEN_COLON,
+    "|": TOKEN_PIPE,
+    ",": TOKEN_COMMA,
+    ";": TOKEN_SEMICOLON,
+}
+
+reverse_operators = {v: k for k, v in operators.items()}
+assert len(operators) == len(reverse_operators), "operators dropped"
+operator_re = re.compile(
+    f"({'|'.join(re.escape(x) for x in sorted(operators, key=lambda x: -len(x)))})"
+)
+
+ignored_tokens = frozenset(
+    [
+        TOKEN_COMMENT_BEGIN,
+        TOKEN_COMMENT,
+        TOKEN_COMMENT_END,
+        TOKEN_WHITESPACE,
+        TOKEN_LINECOMMENT_BEGIN,
+        TOKEN_LINECOMMENT_END,
+        TOKEN_LINECOMMENT,
+    ]
+)
+ignore_if_empty = frozenset(
+    [TOKEN_WHITESPACE, TOKEN_DATA, TOKEN_COMMENT, TOKEN_LINECOMMENT]
+)
+
+
+def _describe_token_type(token_type: str) -> str:
+    if token_type in reverse_operators:
+        return reverse_operators[token_type]
+
+    return {
+        TOKEN_COMMENT_BEGIN: "begin of comment",
+        TOKEN_COMMENT_END: "end of comment",
+        TOKEN_COMMENT: "comment",
+        TOKEN_LINECOMMENT: "comment",
+        TOKEN_BLOCK_BEGIN: "begin of statement block",
+        TOKEN_BLOCK_END: "end of statement block",
+        TOKEN_VARIABLE_BEGIN: "begin of print statement",
+        TOKEN_VARIABLE_END: "end of print statement",
+        TOKEN_LINESTATEMENT_BEGIN: "begin of line statement",
+        TOKEN_LINESTATEMENT_END: "end of line statement",
+        TOKEN_DATA: "template data / text",
+        TOKEN_EOF: "end of template",
+    }.get(token_type, token_type)
+
+
+def describe_token(token: "Token") -> str:
+    """Returns a description of the token."""
+    if token.type == TOKEN_NAME:
+        return token.value
+
+    return _describe_token_type(token.type)
+
+
+def describe_token_expr(expr: str) -> str:
+    """Like `describe_token` but for token expressions."""
+    if ":" in expr:
+        type, value = expr.split(":", 1)
+
+        if type == TOKEN_NAME:
+            return value
+    else:
+        type = expr
+
+    return _describe_token_type(type)
+
+
+def count_newlines(value: str) -> int:
+    """Count the number of newline characters in the string.  This is
+    useful for extensions that filter a stream.
+    """
+    return len(newline_re.findall(value))
+
+
+def compile_rules(environment: "Environment") -> t.List[t.Tuple[str, str]]:
+    """Compiles all the rules from the environment into a list of rules."""
+    e = re.escape
+    rules = [
+        (
+            len(environment.comment_start_string),
+            TOKEN_COMMENT_BEGIN,
+            e(environment.comment_start_string),
+        ),
+        (
+            len(environment.block_start_string),
+            TOKEN_BLOCK_BEGIN,
+            e(environment.block_start_string),
+        ),
+        (
+            len(environment.variable_start_string),
+            TOKEN_VARIABLE_BEGIN,
+            e(environment.variable_start_string),
+        ),
+    ]
+
+    if environment.line_statement_prefix is not None:
+        rules.append(
+            (
+                len(environment.line_statement_prefix),
+                TOKEN_LINESTATEMENT_BEGIN,
+                r"^[ \t\v]*" + e(environment.line_statement_prefix),
+            )
+        )
+    if environment.line_comment_prefix is not None:
+        rules.append(
+            (
+                len(environment.line_comment_prefix),
+                TOKEN_LINECOMMENT_BEGIN,
+                r"(?:^|(?<=\S))[^\S\r\n]*" + e(environment.line_comment_prefix),
+            )
+        )
+
+    return [x[1:] for x in sorted(rules, reverse=True)]
+
+
+class Failure:
+    """Class that raises a `TemplateSyntaxError` if called.
+    Used by the `Lexer` to specify known errors.
+    """
+
+    def __init__(
+        self, message: str, cls: t.Type[TemplateSyntaxError] = TemplateSyntaxError
+    ) -> None:
+        self.message = message
+        self.error_class = cls
+
+    def __call__(self, lineno: int, filename: str) -> "te.NoReturn":
+        raise self.error_class(self.message, lineno, filename)
+
+
+class Token(t.NamedTuple):
+    lineno: int
+    type: str
+    value: str
+
+    def __str__(self) -> str:
+        return describe_token(self)
+
+    def test(self, expr: str) -> bool:
+        """Test a token against a token expression.  This can either be a
+        token type or ``'token_type:token_value'``.  This can only test
+        against string values and types.
+        """
+        # here we do a regular string equality check as test_any is usually
+        # passed an iterable of not interned strings.
+        if self.type == expr:
+            return True
+
+        if ":" in expr:
+            return expr.split(":", 1) == [self.type, self.value]
+
+        return False
+
+    def test_any(self, *iterable: str) -> bool:
+        """Test against multiple token expressions."""
+        return any(self.test(expr) for expr in iterable)
+
+
+class TokenStreamIterator:
+    """The iterator for tokenstreams.  Iterate over the stream
+    until the eof token is reached.
+    """
+
+    def __init__(self, stream: "TokenStream") -> None:
+        self.stream = stream
+
+    def __iter__(self) -> "TokenStreamIterator":
+        return self
+
+    def __next__(self) -> Token:
+        token = self.stream.current
+
+        if token.type is TOKEN_EOF:
+            self.stream.close()
+            raise StopIteration
+
+        next(self.stream)
+        return token
+
+
+class TokenStream:
+    """A token stream is an iterable that yields :class:`Token`\\s.  The
+    parser however does not iterate over it but calls :meth:`next` to go
+    one token ahead.  The current active token is stored as :attr:`current`.
+    """
+
+    def __init__(
+        self,
+        generator: t.Iterable[Token],
+        name: t.Optional[str],
+        filename: t.Optional[str],
+    ):
+        self._iter = iter(generator)
+        self._pushed: "te.Deque[Token]" = deque()
+        self.name = name
+        self.filename = filename
+        self.closed = False
+        self.current = Token(1, TOKEN_INITIAL, "")
+        next(self)
+
+    def __iter__(self) -> TokenStreamIterator:
+        return TokenStreamIterator(self)
+
+    def __bool__(self) -> bool:
+        return bool(self._pushed) or self.current.type is not TOKEN_EOF
+
+    @property
+    def eos(self) -> bool:
+        """Are we at the end of the stream?"""
+        return not self
+
+    def push(self, token: Token) -> None:
+        """Push a token back to the stream."""
+        self._pushed.append(token)
+
+    def look(self) -> Token:
+        """Look at the next token."""
+        old_token = next(self)
+        result = self.current
+        self.push(result)
+        self.current = old_token
+        return result
+
+    def skip(self, n: int = 1) -> None:
+        """Got n tokens ahead."""
+        for _ in range(n):
+            next(self)
+
+    def next_if(self, expr: str) -> t.Optional[Token]:
+        """Perform the token test and return the token if it matched.
+        Otherwise the return value is `None`.
+        """
+        if self.current.test(expr):
+            return next(self)
+
+        return None
+
+    def skip_if(self, expr: str) -> bool:
+        """Like :meth:`next_if` but only returns `True` or `False`."""
+        return self.next_if(expr) is not None
+
+    def __next__(self) -> Token:
+        """Go one token ahead and return the old one.
+
+        Use the built-in :func:`next` instead of calling this directly.
+        """
+        rv = self.current
+
+        if self._pushed:
+            self.current = self._pushed.popleft()
+        elif self.current.type is not TOKEN_EOF:
+            try:
+                self.current = next(self._iter)
+            except StopIteration:
+                self.close()
+
+        return rv
+
+    def close(self) -> None:
+        """Close the stream."""
+        self.current = Token(self.current.lineno, TOKEN_EOF, "")
+        self._iter = iter(())
+        self.closed = True
+
+    def expect(self, expr: str) -> Token:
+        """Expect a given token type and return it.  This accepts the same
+        argument as :meth:`jinja2.lexer.Token.test`.
+        """
+        if not self.current.test(expr):
+            expr = describe_token_expr(expr)
+
+            if self.current.type is TOKEN_EOF:
+                raise TemplateSyntaxError(
+                    f"unexpected end of template, expected {expr!r}.",
+                    self.current.lineno,
+                    self.name,
+                    self.filename,
+                )
+
+            raise TemplateSyntaxError(
+                f"expected token {expr!r}, got {describe_token(self.current)!r}",
+                self.current.lineno,
+                self.name,
+                self.filename,
+            )
+
+        return next(self)
+
+
+def get_lexer(environment: "Environment") -> "Lexer":
+    """Return a lexer which is probably cached."""
+    key = (
+        environment.block_start_string,
+        environment.block_end_string,
+        environment.variable_start_string,
+        environment.variable_end_string,
+        environment.comment_start_string,
+        environment.comment_end_string,
+        environment.line_statement_prefix,
+        environment.line_comment_prefix,
+        environment.trim_blocks,
+        environment.lstrip_blocks,
+        environment.newline_sequence,
+        environment.keep_trailing_newline,
+    )
+    lexer = _lexer_cache.get(key)
+
+    if lexer is None:
+        _lexer_cache[key] = lexer = Lexer(environment)
+
+    return lexer
+
+
+class OptionalLStrip(tuple):
+    """A special tuple for marking a point in the state that can have
+    lstrip applied.
+    """
+
+    __slots__ = ()
+
+    # Even though it looks like a no-op, creating instances fails
+    # without this.
+    def __new__(cls, *members, **kwargs):  # type: ignore
+        return super().__new__(cls, members)
+
+
+class _Rule(t.NamedTuple):
+    pattern: t.Pattern[str]
+    tokens: t.Union[str, t.Tuple[str, ...], t.Tuple[Failure]]
+    command: t.Optional[str]
+
+
+class Lexer:
+    """Class that implements a lexer for a given environment. Automatically
+    created by the environment class, usually you don't have to do that.
+
+    Note that the lexer is not automatically bound to an environment.
+    Multiple environments can share the same lexer.
+    """
+
+    def __init__(self, environment: "Environment") -> None:
+        # shortcuts
+        e = re.escape
+
+        def c(x: str) -> t.Pattern[str]:
+            return re.compile(x, re.M | re.S)
+
+        # lexing rules for tags
+        tag_rules: t.List[_Rule] = [
+            _Rule(whitespace_re, TOKEN_WHITESPACE, None),
+            _Rule(float_re, TOKEN_FLOAT, None),
+            _Rule(integer_re, TOKEN_INTEGER, None),
+            _Rule(name_re, TOKEN_NAME, None),
+            _Rule(string_re, TOKEN_STRING, None),
+            _Rule(operator_re, TOKEN_OPERATOR, None),
+        ]
+
+        # assemble the root lexing rule. because "|" is ungreedy
+        # we have to sort by length so that the lexer continues working
+        # as expected when we have parsing rules like <% for block and
+        # <%= for variables. (if someone wants asp like syntax)
+        # variables are just part of the rules if variable processing
+        # is required.
+        root_tag_rules = compile_rules(environment)
+
+        block_start_re = e(environment.block_start_string)
+        block_end_re = e(environment.block_end_string)
+        comment_end_re = e(environment.comment_end_string)
+        variable_end_re = e(environment.variable_end_string)
+
+        # block suffix if trimming is enabled
+        block_suffix_re = "\\n?" if environment.trim_blocks else ""
+
+        self.lstrip_blocks = environment.lstrip_blocks
+
+        self.newline_sequence = environment.newline_sequence
+        self.keep_trailing_newline = environment.keep_trailing_newline
+
+        root_raw_re = (
+            rf"(?P<raw_begin>{block_start_re}(\-|\+|)\s*raw\s*"
+            rf"(?:\-{block_end_re}\s*|{block_end_re}))"
+        )
+        root_parts_re = "|".join(
+            [root_raw_re] + [rf"(?P<{n}>{r}(\-|\+|))" for n, r in root_tag_rules]
+        )
+
+        # global lexing rules
+        self.rules: t.Dict[str, t.List[_Rule]] = {
+            "root": [
+                # directives
+                _Rule(
+                    c(rf"(.*?)(?:{root_parts_re})"),
+                    OptionalLStrip(TOKEN_DATA, "#bygroup"),  # type: ignore
+                    "#bygroup",
+                ),
+                # data
+                _Rule(c(".+"), TOKEN_DATA, None),
+            ],
+            # comments
+            TOKEN_COMMENT_BEGIN: [
+                _Rule(
+                    c(
+                        rf"(.*?)((?:\+{comment_end_re}|\-{comment_end_re}\s*"
+                        rf"|{comment_end_re}{block_suffix_re}))"
+                    ),
+                    (TOKEN_COMMENT, TOKEN_COMMENT_END),
+                    "#pop",
+                ),
+                _Rule(c(r"(.)"), (Failure("Missing end of comment tag"),), None),
+            ],
+            # blocks
+            TOKEN_BLOCK_BEGIN: [
+                _Rule(
+                    c(
+                        rf"(?:\+{block_end_re}|\-{block_end_re}\s*"
+                        rf"|{block_end_re}{block_suffix_re})"
+                    ),
+                    TOKEN_BLOCK_END,
+                    "#pop",
+                ),
+            ]
+            + tag_rules,
+            # variables
+            TOKEN_VARIABLE_BEGIN: [
+                _Rule(
+                    c(rf"\-{variable_end_re}\s*|{variable_end_re}"),
+                    TOKEN_VARIABLE_END,
+                    "#pop",
+                )
+            ]
+            + tag_rules,
+            # raw block
+            TOKEN_RAW_BEGIN: [
+                _Rule(
+                    c(
+                        rf"(.*?)((?:{block_start_re}(\-|\+|))\s*endraw\s*"
+                        rf"(?:\+{block_end_re}|\-{block_end_re}\s*"
+                        rf"|{block_end_re}{block_suffix_re}))"
+                    ),
+                    OptionalLStrip(TOKEN_DATA, TOKEN_RAW_END),  # type: ignore
+                    "#pop",
+                ),
+                _Rule(c(r"(.)"), (Failure("Missing end of raw directive"),), None),
+            ],
+            # line statements
+            TOKEN_LINESTATEMENT_BEGIN: [
+                _Rule(c(r"\s*(\n|$)"), TOKEN_LINESTATEMENT_END, "#pop")
+            ]
+            + tag_rules,
+            # line comments
+            TOKEN_LINECOMMENT_BEGIN: [
+                _Rule(
+                    c(r"(.*?)()(?=\n|$)"),
+                    (TOKEN_LINECOMMENT, TOKEN_LINECOMMENT_END),
+                    "#pop",
+                )
+            ],
+        }
+
+    def _normalize_newlines(self, value: str) -> str:
+        """Replace all newlines with the configured sequence in strings
+        and template data.
+        """
+        return newline_re.sub(self.newline_sequence, value)
+
+    def tokenize(
+        self,
+        source: str,
+        name: t.Optional[str] = None,
+        filename: t.Optional[str] = None,
+        state: t.Optional[str] = None,
+    ) -> TokenStream:
+        """Calls tokeniter + tokenize and wraps it in a token stream."""
+        stream = self.tokeniter(source, name, filename, state)
+        return TokenStream(self.wrap(stream, name, filename), name, filename)
+
+    def wrap(
+        self,
+        stream: t.Iterable[t.Tuple[int, str, str]],
+        name: t.Optional[str] = None,
+        filename: t.Optional[str] = None,
+    ) -> t.Iterator[Token]:
+        """This is called with the stream as returned by `tokenize` and wraps
+        every token in a :class:`Token` and converts the value.
+        """
+        for lineno, token, value_str in stream:
+            if token in ignored_tokens:
+                continue
+
+            value: t.Any = value_str
+
+            if token == TOKEN_LINESTATEMENT_BEGIN:
+                token = TOKEN_BLOCK_BEGIN
+            elif token == TOKEN_LINESTATEMENT_END:
+                token = TOKEN_BLOCK_END
+            # we are not interested in those tokens in the parser
+            elif token in (TOKEN_RAW_BEGIN, TOKEN_RAW_END):
+                continue
+            elif token == TOKEN_DATA:
+                value = self._normalize_newlines(value_str)
+            elif token == "keyword":
+                token = value_str
+            elif token == TOKEN_NAME:
+                value = value_str
+
+                if not value.isidentifier():
+                    raise TemplateSyntaxError(
+                        "Invalid character in identifier", lineno, name, filename
+                    )
+            elif token == TOKEN_STRING:
+                # try to unescape string
+                try:
+                    value = (
+                        self._normalize_newlines(value_str[1:-1])
+                        .encode("ascii", "backslashreplace")
+                        .decode("unicode-escape")
+                    )
+                except Exception as e:
+                    msg = str(e).split(":")[-1].strip()
+                    raise TemplateSyntaxError(msg, lineno, name, filename) from e
+            elif token == TOKEN_INTEGER:
+                value = int(value_str.replace("_", ""), 0)
+            elif token == TOKEN_FLOAT:
+                # remove all "_" first to support more Python versions
+                value = literal_eval(value_str.replace("_", ""))
+            elif token == TOKEN_OPERATOR:
+                token = operators[value_str]
+
+            yield Token(lineno, token, value)
+
+    def tokeniter(
+        self,
+        source: str,
+        name: t.Optional[str],
+        filename: t.Optional[str] = None,
+        state: t.Optional[str] = None,
+    ) -> t.Iterator[t.Tuple[int, str, str]]:
+        """This method tokenizes the text and returns the tokens in a
+        generator. Use this method if you just want to tokenize a template.
+
+        .. versionchanged:: 3.0
+            Only ``\\n``, ``\\r\\n`` and ``\\r`` are treated as line
+            breaks.
+        """
+        lines = newline_re.split(source)[::2]
+
+        if not self.keep_trailing_newline and lines[-1] == "":
+            del lines[-1]
+
+        source = "\n".join(lines)
+        pos = 0
+        lineno = 1
+        stack = ["root"]
+
+        if state is not None and state != "root":
+            assert state in ("variable", "block"), "invalid state"
+            stack.append(state + "_begin")
+
+        statetokens = self.rules[stack[-1]]
+        source_length = len(source)
+        balancing_stack: t.List[str] = []
+        newlines_stripped = 0
+        line_starting = True
+
+        while True:
+            # tokenizer loop
+            for regex, tokens, new_state in statetokens:
+                m = regex.match(source, pos)
+
+                # if no match we try again with the next rule
+                if m is None:
+                    continue
+
+                # we only match blocks and variables if braces / parentheses
+                # are balanced. continue parsing with the lower rule which
+                # is the operator rule. do this only if the end tags look
+                # like operators
+                if balancing_stack and tokens in (
+                    TOKEN_VARIABLE_END,
+                    TOKEN_BLOCK_END,
+                    TOKEN_LINESTATEMENT_END,
+                ):
+                    continue
+
+                # tuples support more options
+                if isinstance(tokens, tuple):
+                    groups: t.Sequence[str] = m.groups()
+
+                    if isinstance(tokens, OptionalLStrip):
+                        # Rule supports lstrip. Match will look like
+                        # text, block type, whitespace control, type, control, ...
+                        text = groups[0]
+                        # Skipping the text and first type, every other group is the
+                        # whitespace control for each type. One of the groups will be
+                        # -, +, or empty string instead of None.
+                        strip_sign = next(g for g in groups[2::2] if g is not None)
+
+                        if strip_sign == "-":
+                            # Strip all whitespace between the text and the tag.
+                            stripped = text.rstrip()
+                            newlines_stripped = text[len(stripped) :].count("\n")
+                            groups = [stripped, *groups[1:]]
+                        elif (
+                            # Not marked for preserving whitespace.
+                            strip_sign != "+"
+                            # lstrip is enabled.
+                            and self.lstrip_blocks
+                            # Not a variable expression.
+                            and not m.groupdict().get(TOKEN_VARIABLE_BEGIN)
+                        ):
+                            # The start of text between the last newline and the tag.
+                            l_pos = text.rfind("\n") + 1
+
+                            if l_pos > 0 or line_starting:
+                                # If there's only whitespace between the newline and the
+                                # tag, strip it.
+                                if whitespace_re.fullmatch(text, l_pos):
+                                    groups = [text[:l_pos], *groups[1:]]
+
+                    for idx, token in enumerate(tokens):
+                        # failure group
+                        if token.__class__ is Failure:
+                            raise token(lineno, filename)
+                        # bygroup is a bit more complex, in that case we
+                        # yield for the current token the first named
+                        # group that matched
+                        elif token == "#bygroup":
+                            for key, value in m.groupdict().items():
+                                if value is not None:
+                                    yield lineno, key, value
+                                    lineno += value.count("\n")
+                                    break
+                            else:
+                                raise RuntimeError(
+                                    f"{regex!r} wanted to resolve the token dynamically"
+                                    " but no group matched"
+                                )
+                        # normal group
+                        else:
+                            data = groups[idx]
+
+                            if data or token not in ignore_if_empty:
+                                yield lineno, token, data
+
+                            lineno += data.count("\n") + newlines_stripped
+                            newlines_stripped = 0
+
+                # strings as token just are yielded as it.
+                else:
+                    data = m.group()
+
+                    # update brace/parentheses balance
+                    if tokens == TOKEN_OPERATOR:
+                        if data == "{":
+                            balancing_stack.append("}")
+                        elif data == "(":
+                            balancing_stack.append(")")
+                        elif data == "[":
+                            balancing_stack.append("]")
+                        elif data in ("}", ")", "]"):
+                            if not balancing_stack:
+                                raise TemplateSyntaxError(
+                                    f"unexpected '{data}'", lineno, name, filename
+                                )
+
+                            expected_op = balancing_stack.pop()
+
+                            if expected_op != data:
+                                raise TemplateSyntaxError(
+                                    f"unexpected '{data}', expected '{expected_op}'",
+                                    lineno,
+                                    name,
+                                    filename,
+                                )
+
+                    # yield items
+                    if data or tokens not in ignore_if_empty:
+                        yield lineno, tokens, data
+
+                    lineno += data.count("\n")
+
+                line_starting = m.group()[-1:] == "\n"
+                # fetch new position into new variable so that we can check
+                # if there is a internal parsing error which would result
+                # in an infinite loop
+                pos2 = m.end()
+
+                # handle state changes
+                if new_state is not None:
+                    # remove the uppermost state
+                    if new_state == "#pop":
+                        stack.pop()
+                    # resolve the new state by group checking
+                    elif new_state == "#bygroup":
+                        for key, value in m.groupdict().items():
+                            if value is not None:
+                                stack.append(key)
+                                break
+                        else:
+                            raise RuntimeError(
+                                f"{regex!r} wanted to resolve the new state dynamically"
+                                f" but no group matched"
+                            )
+                    # direct state name given
+                    else:
+                        stack.append(new_state)
+
+                    statetokens = self.rules[stack[-1]]
+                # we are still at the same position and no stack change.
+                # this means a loop without break condition, avoid that and
+                # raise error
+                elif pos2 == pos:
+                    raise RuntimeError(
+                        f"{regex!r} yielded empty string without stack change"
+                    )
+
+                # publish new function and start again
+                pos = pos2
+                break
+            # if loop terminated without break we haven't found a single match
+            # either we are at the end of the file or we have a problem
+            else:
+                # end of text
+                if pos >= source_length:
+                    return
+
+                # something went wrong
+                raise TemplateSyntaxError(
+                    f"unexpected char {source[pos]!r} at {pos}", lineno, name, filename
+                )
diff --git a/llm/Lib/site-packages/jinja2/loaders.py b/llm/Lib/site-packages/jinja2/loaders.py
new file mode 100644
index 0000000000000000000000000000000000000000..32f3a74e7d912ace28c4eee0e4c231c989c2c93c
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/loaders.py
@@ -0,0 +1,661 @@
+"""API and implementations for loading templates from different data
+sources.
+"""
+import importlib.util
+import os
+import posixpath
+import sys
+import typing as t
+import weakref
+import zipimport
+from collections import abc
+from hashlib import sha1
+from importlib import import_module
+from types import ModuleType
+
+from .exceptions import TemplateNotFound
+from .utils import internalcode
+
+if t.TYPE_CHECKING:
+    from .environment import Environment
+    from .environment import Template
+
+
+def split_template_path(template: str) -> t.List[str]:
+    """Split a path into segments and perform a sanity check.  If it detects
+    '..' in the path it will raise a `TemplateNotFound` error.
+    """
+    pieces = []
+    for piece in template.split("/"):
+        if (
+            os.path.sep in piece
+            or (os.path.altsep and os.path.altsep in piece)
+            or piece == os.path.pardir
+        ):
+            raise TemplateNotFound(template)
+        elif piece and piece != ".":
+            pieces.append(piece)
+    return pieces
+
+
+class BaseLoader:
+    """Baseclass for all loaders.  Subclass this and override `get_source` to
+    implement a custom loading mechanism.  The environment provides a
+    `get_template` method that calls the loader's `load` method to get the
+    :class:`Template` object.
+
+    A very basic example for a loader that looks up templates on the file
+    system could look like this::
+
+        from jinja2 import BaseLoader, TemplateNotFound
+        from os.path import join, exists, getmtime
+
+        class MyLoader(BaseLoader):
+
+            def __init__(self, path):
+                self.path = path
+
+            def get_source(self, environment, template):
+                path = join(self.path, template)
+                if not exists(path):
+                    raise TemplateNotFound(template)
+                mtime = getmtime(path)
+                with open(path) as f:
+                    source = f.read()
+                return source, path, lambda: mtime == getmtime(path)
+    """
+
+    #: if set to `False` it indicates that the loader cannot provide access
+    #: to the source of templates.
+    #:
+    #: .. versionadded:: 2.4
+    has_source_access = True
+
+    def get_source(
+        self, environment: "Environment", template: str
+    ) -> t.Tuple[str, t.Optional[str], t.Optional[t.Callable[[], bool]]]:
+        """Get the template source, filename and reload helper for a template.
+        It's passed the environment and template name and has to return a
+        tuple in the form ``(source, filename, uptodate)`` or raise a
+        `TemplateNotFound` error if it can't locate the template.
+
+        The source part of the returned tuple must be the source of the
+        template as a string. The filename should be the name of the
+        file on the filesystem if it was loaded from there, otherwise
+        ``None``. The filename is used by Python for the tracebacks
+        if no loader extension is used.
+
+        The last item in the tuple is the `uptodate` function.  If auto
+        reloading is enabled it's always called to check if the template
+        changed.  No arguments are passed so the function must store the
+        old state somewhere (for example in a closure).  If it returns `False`
+        the template will be reloaded.
+        """
+        if not self.has_source_access:
+            raise RuntimeError(
+                f"{type(self).__name__} cannot provide access to the source"
+            )
+        raise TemplateNotFound(template)
+
+    def list_templates(self) -> t.List[str]:
+        """Iterates over all templates.  If the loader does not support that
+        it should raise a :exc:`TypeError` which is the default behavior.
+        """
+        raise TypeError("this loader cannot iterate over all templates")
+
+    @internalcode
+    def load(
+        self,
+        environment: "Environment",
+        name: str,
+        globals: t.Optional[t.MutableMapping[str, t.Any]] = None,
+    ) -> "Template":
+        """Loads a template.  This method looks up the template in the cache
+        or loads one by calling :meth:`get_source`.  Subclasses should not
+        override this method as loaders working on collections of other
+        loaders (such as :class:`PrefixLoader` or :class:`ChoiceLoader`)
+        will not call this method but `get_source` directly.
+        """
+        code = None
+        if globals is None:
+            globals = {}
+
+        # first we try to get the source for this template together
+        # with the filename and the uptodate function.
+        source, filename, uptodate = self.get_source(environment, name)
+
+        # try to load the code from the bytecode cache if there is a
+        # bytecode cache configured.
+        bcc = environment.bytecode_cache
+        if bcc is not None:
+            bucket = bcc.get_bucket(environment, name, filename, source)
+            code = bucket.code
+
+        # if we don't have code so far (not cached, no longer up to
+        # date) etc. we compile the template
+        if code is None:
+            code = environment.compile(source, name, filename)
+
+        # if the bytecode cache is available and the bucket doesn't
+        # have a code so far, we give the bucket the new code and put
+        # it back to the bytecode cache.
+        if bcc is not None and bucket.code is None:
+            bucket.code = code
+            bcc.set_bucket(bucket)
+
+        return environment.template_class.from_code(
+            environment, code, globals, uptodate
+        )
+
+
+class FileSystemLoader(BaseLoader):
+    """Load templates from a directory in the file system.
+
+    The path can be relative or absolute. Relative paths are relative to
+    the current working directory.
+
+    .. code-block:: python
+
+        loader = FileSystemLoader("templates")
+
+    A list of paths can be given. The directories will be searched in
+    order, stopping at the first matching template.
+
+    .. code-block:: python
+
+        loader = FileSystemLoader(["/override/templates", "/default/templates"])
+
+    :param searchpath: A path, or list of paths, to the directory that
+        contains the templates.
+    :param encoding: Use this encoding to read the text from template
+        files.
+    :param followlinks: Follow symbolic links in the path.
+
+    .. versionchanged:: 2.8
+        Added the ``followlinks`` parameter.
+    """
+
+    def __init__(
+        self,
+        searchpath: t.Union[str, os.PathLike, t.Sequence[t.Union[str, os.PathLike]]],
+        encoding: str = "utf-8",
+        followlinks: bool = False,
+    ) -> None:
+        if not isinstance(searchpath, abc.Iterable) or isinstance(searchpath, str):
+            searchpath = [searchpath]
+
+        self.searchpath = [os.fspath(p) for p in searchpath]
+        self.encoding = encoding
+        self.followlinks = followlinks
+
+    def get_source(
+        self, environment: "Environment", template: str
+    ) -> t.Tuple[str, str, t.Callable[[], bool]]:
+        pieces = split_template_path(template)
+
+        for searchpath in self.searchpath:
+            # Use posixpath even on Windows to avoid "drive:" or UNC
+            # segments breaking out of the search directory.
+            filename = posixpath.join(searchpath, *pieces)
+
+            if os.path.isfile(filename):
+                break
+        else:
+            raise TemplateNotFound(template)
+
+        with open(filename, encoding=self.encoding) as f:
+            contents = f.read()
+
+        mtime = os.path.getmtime(filename)
+
+        def uptodate() -> bool:
+            try:
+                return os.path.getmtime(filename) == mtime
+            except OSError:
+                return False
+
+        # Use normpath to convert Windows altsep to sep.
+        return contents, os.path.normpath(filename), uptodate
+
+    def list_templates(self) -> t.List[str]:
+        found = set()
+        for searchpath in self.searchpath:
+            walk_dir = os.walk(searchpath, followlinks=self.followlinks)
+            for dirpath, _, filenames in walk_dir:
+                for filename in filenames:
+                    template = (
+                        os.path.join(dirpath, filename)[len(searchpath) :]
+                        .strip(os.path.sep)
+                        .replace(os.path.sep, "/")
+                    )
+                    if template[:2] == "./":
+                        template = template[2:]
+                    if template not in found:
+                        found.add(template)
+        return sorted(found)
+
+
+class PackageLoader(BaseLoader):
+    """Load templates from a directory in a Python package.
+
+    :param package_name: Import name of the package that contains the
+        template directory.
+    :param package_path: Directory within the imported package that
+        contains the templates.
+    :param encoding: Encoding of template files.
+
+    The following example looks up templates in the ``pages`` directory
+    within the ``project.ui`` package.
+
+    .. code-block:: python
+
+        loader = PackageLoader("project.ui", "pages")
+
+    Only packages installed as directories (standard pip behavior) or
+    zip/egg files (less common) are supported. The Python API for
+    introspecting data in packages is too limited to support other
+    installation methods the way this loader requires.
+
+    There is limited support for :pep:`420` namespace packages. The
+    template directory is assumed to only be in one namespace
+    contributor. Zip files contributing to a namespace are not
+    supported.
+
+    .. versionchanged:: 3.0
+        No longer uses ``setuptools`` as a dependency.
+
+    .. versionchanged:: 3.0
+        Limited PEP 420 namespace package support.
+    """
+
+    def __init__(
+        self,
+        package_name: str,
+        package_path: "str" = "templates",
+        encoding: str = "utf-8",
+    ) -> None:
+        package_path = os.path.normpath(package_path).rstrip(os.path.sep)
+
+        # normpath preserves ".", which isn't valid in zip paths.
+        if package_path == os.path.curdir:
+            package_path = ""
+        elif package_path[:2] == os.path.curdir + os.path.sep:
+            package_path = package_path[2:]
+
+        self.package_path = package_path
+        self.package_name = package_name
+        self.encoding = encoding
+
+        # Make sure the package exists. This also makes namespace
+        # packages work, otherwise get_loader returns None.
+        import_module(package_name)
+        spec = importlib.util.find_spec(package_name)
+        assert spec is not None, "An import spec was not found for the package."
+        loader = spec.loader
+        assert loader is not None, "A loader was not found for the package."
+        self._loader = loader
+        self._archive = None
+        template_root = None
+
+        if isinstance(loader, zipimport.zipimporter):
+            self._archive = loader.archive
+            pkgdir = next(iter(spec.submodule_search_locations))  # type: ignore
+            template_root = os.path.join(pkgdir, package_path).rstrip(os.path.sep)
+        else:
+            roots: t.List[str] = []
+
+            # One element for regular packages, multiple for namespace
+            # packages, or None for single module file.
+            if spec.submodule_search_locations:
+                roots.extend(spec.submodule_search_locations)
+            # A single module file, use the parent directory instead.
+            elif spec.origin is not None:
+                roots.append(os.path.dirname(spec.origin))
+
+            for root in roots:
+                root = os.path.join(root, package_path)
+
+                if os.path.isdir(root):
+                    template_root = root
+                    break
+
+        if template_root is None:
+            raise ValueError(
+                f"The {package_name!r} package was not installed in a"
+                " way that PackageLoader understands."
+            )
+
+        self._template_root = template_root
+
+    def get_source(
+        self, environment: "Environment", template: str
+    ) -> t.Tuple[str, str, t.Optional[t.Callable[[], bool]]]:
+        # Use posixpath even on Windows to avoid "drive:" or UNC
+        # segments breaking out of the search directory. Use normpath to
+        # convert Windows altsep to sep.
+        p = os.path.normpath(
+            posixpath.join(self._template_root, *split_template_path(template))
+        )
+        up_to_date: t.Optional[t.Callable[[], bool]]
+
+        if self._archive is None:
+            # Package is a directory.
+            if not os.path.isfile(p):
+                raise TemplateNotFound(template)
+
+            with open(p, "rb") as f:
+                source = f.read()
+
+            mtime = os.path.getmtime(p)
+
+            def up_to_date() -> bool:
+                return os.path.isfile(p) and os.path.getmtime(p) == mtime
+
+        else:
+            # Package is a zip file.
+            try:
+                source = self._loader.get_data(p)  # type: ignore
+            except OSError as e:
+                raise TemplateNotFound(template) from e
+
+            # Could use the zip's mtime for all template mtimes, but
+            # would need to safely reload the module if it's out of
+            # date, so just report it as always current.
+            up_to_date = None
+
+        return source.decode(self.encoding), p, up_to_date
+
+    def list_templates(self) -> t.List[str]:
+        results: t.List[str] = []
+
+        if self._archive is None:
+            # Package is a directory.
+            offset = len(self._template_root)
+
+            for dirpath, _, filenames in os.walk(self._template_root):
+                dirpath = dirpath[offset:].lstrip(os.path.sep)
+                results.extend(
+                    os.path.join(dirpath, name).replace(os.path.sep, "/")
+                    for name in filenames
+                )
+        else:
+            if not hasattr(self._loader, "_files"):
+                raise TypeError(
+                    "This zip import does not have the required"
+                    " metadata to list templates."
+                )
+
+            # Package is a zip file.
+            prefix = (
+                self._template_root[len(self._archive) :].lstrip(os.path.sep)
+                + os.path.sep
+            )
+            offset = len(prefix)
+
+            for name in self._loader._files.keys():
+                # Find names under the templates directory that aren't directories.
+                if name.startswith(prefix) and name[-1] != os.path.sep:
+                    results.append(name[offset:].replace(os.path.sep, "/"))
+
+        results.sort()
+        return results
+
+
+class DictLoader(BaseLoader):
+    """Loads a template from a Python dict mapping template names to
+    template source.  This loader is useful for unittesting:
+
+    >>> loader = DictLoader({'index.html': 'source here'})
+
+    Because auto reloading is rarely useful this is disabled per default.
+    """
+
+    def __init__(self, mapping: t.Mapping[str, str]) -> None:
+        self.mapping = mapping
+
+    def get_source(
+        self, environment: "Environment", template: str
+    ) -> t.Tuple[str, None, t.Callable[[], bool]]:
+        if template in self.mapping:
+            source = self.mapping[template]
+            return source, None, lambda: source == self.mapping.get(template)
+        raise TemplateNotFound(template)
+
+    def list_templates(self) -> t.List[str]:
+        return sorted(self.mapping)
+
+
+class FunctionLoader(BaseLoader):
+    """A loader that is passed a function which does the loading.  The
+    function receives the name of the template and has to return either
+    a string with the template source, a tuple in the form ``(source,
+    filename, uptodatefunc)`` or `None` if the template does not exist.
+
+    >>> def load_template(name):
+    ...     if name == 'index.html':
+    ...         return '...'
+    ...
+    >>> loader = FunctionLoader(load_template)
+
+    The `uptodatefunc` is a function that is called if autoreload is enabled
+    and has to return `True` if the template is still up to date.  For more
+    details have a look at :meth:`BaseLoader.get_source` which has the same
+    return value.
+    """
+
+    def __init__(
+        self,
+        load_func: t.Callable[
+            [str],
+            t.Optional[
+                t.Union[
+                    str, t.Tuple[str, t.Optional[str], t.Optional[t.Callable[[], bool]]]
+                ]
+            ],
+        ],
+    ) -> None:
+        self.load_func = load_func
+
+    def get_source(
+        self, environment: "Environment", template: str
+    ) -> t.Tuple[str, t.Optional[str], t.Optional[t.Callable[[], bool]]]:
+        rv = self.load_func(template)
+
+        if rv is None:
+            raise TemplateNotFound(template)
+
+        if isinstance(rv, str):
+            return rv, None, None
+
+        return rv
+
+
+class PrefixLoader(BaseLoader):
+    """A loader that is passed a dict of loaders where each loader is bound
+    to a prefix.  The prefix is delimited from the template by a slash per
+    default, which can be changed by setting the `delimiter` argument to
+    something else::
+
+        loader = PrefixLoader({
+            'app1':     PackageLoader('mypackage.app1'),
+            'app2':     PackageLoader('mypackage.app2')
+        })
+
+    By loading ``'app1/index.html'`` the file from the app1 package is loaded,
+    by loading ``'app2/index.html'`` the file from the second.
+    """
+
+    def __init__(
+        self, mapping: t.Mapping[str, BaseLoader], delimiter: str = "/"
+    ) -> None:
+        self.mapping = mapping
+        self.delimiter = delimiter
+
+    def get_loader(self, template: str) -> t.Tuple[BaseLoader, str]:
+        try:
+            prefix, name = template.split(self.delimiter, 1)
+            loader = self.mapping[prefix]
+        except (ValueError, KeyError) as e:
+            raise TemplateNotFound(template) from e
+        return loader, name
+
+    def get_source(
+        self, environment: "Environment", template: str
+    ) -> t.Tuple[str, t.Optional[str], t.Optional[t.Callable[[], bool]]]:
+        loader, name = self.get_loader(template)
+        try:
+            return loader.get_source(environment, name)
+        except TemplateNotFound as e:
+            # re-raise the exception with the correct filename here.
+            # (the one that includes the prefix)
+            raise TemplateNotFound(template) from e
+
+    @internalcode
+    def load(
+        self,
+        environment: "Environment",
+        name: str,
+        globals: t.Optional[t.MutableMapping[str, t.Any]] = None,
+    ) -> "Template":
+        loader, local_name = self.get_loader(name)
+        try:
+            return loader.load(environment, local_name, globals)
+        except TemplateNotFound as e:
+            # re-raise the exception with the correct filename here.
+            # (the one that includes the prefix)
+            raise TemplateNotFound(name) from e
+
+    def list_templates(self) -> t.List[str]:
+        result = []
+        for prefix, loader in self.mapping.items():
+            for template in loader.list_templates():
+                result.append(prefix + self.delimiter + template)
+        return result
+
+
+class ChoiceLoader(BaseLoader):
+    """This loader works like the `PrefixLoader` just that no prefix is
+    specified.  If a template could not be found by one loader the next one
+    is tried.
+
+    >>> loader = ChoiceLoader([
+    ...     FileSystemLoader('/path/to/user/templates'),
+    ...     FileSystemLoader('/path/to/system/templates')
+    ... ])
+
+    This is useful if you want to allow users to override builtin templates
+    from a different location.
+    """
+
+    def __init__(self, loaders: t.Sequence[BaseLoader]) -> None:
+        self.loaders = loaders
+
+    def get_source(
+        self, environment: "Environment", template: str
+    ) -> t.Tuple[str, t.Optional[str], t.Optional[t.Callable[[], bool]]]:
+        for loader in self.loaders:
+            try:
+                return loader.get_source(environment, template)
+            except TemplateNotFound:
+                pass
+        raise TemplateNotFound(template)
+
+    @internalcode
+    def load(
+        self,
+        environment: "Environment",
+        name: str,
+        globals: t.Optional[t.MutableMapping[str, t.Any]] = None,
+    ) -> "Template":
+        for loader in self.loaders:
+            try:
+                return loader.load(environment, name, globals)
+            except TemplateNotFound:
+                pass
+        raise TemplateNotFound(name)
+
+    def list_templates(self) -> t.List[str]:
+        found = set()
+        for loader in self.loaders:
+            found.update(loader.list_templates())
+        return sorted(found)
+
+
+class _TemplateModule(ModuleType):
+    """Like a normal module but with support for weak references"""
+
+
+class ModuleLoader(BaseLoader):
+    """This loader loads templates from precompiled templates.
+
+    Example usage:
+
+    >>> loader = ChoiceLoader([
+    ...     ModuleLoader('/path/to/compiled/templates'),
+    ...     FileSystemLoader('/path/to/templates')
+    ... ])
+
+    Templates can be precompiled with :meth:`Environment.compile_templates`.
+    """
+
+    has_source_access = False
+
+    def __init__(
+        self, path: t.Union[str, os.PathLike, t.Sequence[t.Union[str, os.PathLike]]]
+    ) -> None:
+        package_name = f"_jinja2_module_templates_{id(self):x}"
+
+        # create a fake module that looks for the templates in the
+        # path given.
+        mod = _TemplateModule(package_name)
+
+        if not isinstance(path, abc.Iterable) or isinstance(path, str):
+            path = [path]
+
+        mod.__path__ = [os.fspath(p) for p in path]
+
+        sys.modules[package_name] = weakref.proxy(
+            mod, lambda x: sys.modules.pop(package_name, None)
+        )
+
+        # the only strong reference, the sys.modules entry is weak
+        # so that the garbage collector can remove it once the
+        # loader that created it goes out of business.
+        self.module = mod
+        self.package_name = package_name
+
+    @staticmethod
+    def get_template_key(name: str) -> str:
+        return "tmpl_" + sha1(name.encode("utf-8")).hexdigest()
+
+    @staticmethod
+    def get_module_filename(name: str) -> str:
+        return ModuleLoader.get_template_key(name) + ".py"
+
+    @internalcode
+    def load(
+        self,
+        environment: "Environment",
+        name: str,
+        globals: t.Optional[t.MutableMapping[str, t.Any]] = None,
+    ) -> "Template":
+        key = self.get_template_key(name)
+        module = f"{self.package_name}.{key}"
+        mod = getattr(self.module, module, None)
+
+        if mod is None:
+            try:
+                mod = __import__(module, None, None, ["root"])
+            except ImportError as e:
+                raise TemplateNotFound(name) from e
+
+            # remove the entry from sys.modules, we only want the attribute
+            # on the module object we have stored on the loader.
+            sys.modules.pop(module, None)
+
+        if globals is None:
+            globals = {}
+
+        return environment.template_class.from_module_dict(
+            environment, mod.__dict__, globals
+        )
diff --git a/llm/Lib/site-packages/jinja2/meta.py b/llm/Lib/site-packages/jinja2/meta.py
new file mode 100644
index 0000000000000000000000000000000000000000..0057d6eabade5e964e6ef0e3ac8ed2dd67494b03
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/meta.py
@@ -0,0 +1,111 @@
+"""Functions that expose information about templates that might be
+interesting for introspection.
+"""
+import typing as t
+
+from . import nodes
+from .compiler import CodeGenerator
+from .compiler import Frame
+
+if t.TYPE_CHECKING:
+    from .environment import Environment
+
+
+class TrackingCodeGenerator(CodeGenerator):
+    """We abuse the code generator for introspection."""
+
+    def __init__(self, environment: "Environment") -> None:
+        super().__init__(environment, "<introspection>", "<introspection>")
+        self.undeclared_identifiers: t.Set[str] = set()
+
+    def write(self, x: str) -> None:
+        """Don't write."""
+
+    def enter_frame(self, frame: Frame) -> None:
+        """Remember all undeclared identifiers."""
+        super().enter_frame(frame)
+
+        for _, (action, param) in frame.symbols.loads.items():
+            if action == "resolve" and param not in self.environment.globals:
+                self.undeclared_identifiers.add(param)
+
+
+def find_undeclared_variables(ast: nodes.Template) -> t.Set[str]:
+    """Returns a set of all variables in the AST that will be looked up from
+    the context at runtime.  Because at compile time it's not known which
+    variables will be used depending on the path the execution takes at
+    runtime, all variables are returned.
+
+    >>> from jinja2 import Environment, meta
+    >>> env = Environment()
+    >>> ast = env.parse('{% set foo = 42 %}{{ bar + foo }}')
+    >>> meta.find_undeclared_variables(ast) == {'bar'}
+    True
+
+    .. admonition:: Implementation
+
+       Internally the code generator is used for finding undeclared variables.
+       This is good to know because the code generator might raise a
+       :exc:`TemplateAssertionError` during compilation and as a matter of
+       fact this function can currently raise that exception as well.
+    """
+    codegen = TrackingCodeGenerator(ast.environment)  # type: ignore
+    codegen.visit(ast)
+    return codegen.undeclared_identifiers
+
+
+_ref_types = (nodes.Extends, nodes.FromImport, nodes.Import, nodes.Include)
+_RefType = t.Union[nodes.Extends, nodes.FromImport, nodes.Import, nodes.Include]
+
+
+def find_referenced_templates(ast: nodes.Template) -> t.Iterator[t.Optional[str]]:
+    """Finds all the referenced templates from the AST.  This will return an
+    iterator over all the hardcoded template extensions, inclusions and
+    imports.  If dynamic inheritance or inclusion is used, `None` will be
+    yielded.
+
+    >>> from jinja2 import Environment, meta
+    >>> env = Environment()
+    >>> ast = env.parse('{% extends "layout.html" %}{% include helper %}')
+    >>> list(meta.find_referenced_templates(ast))
+    ['layout.html', None]
+
+    This function is useful for dependency tracking.  For example if you want
+    to rebuild parts of the website after a layout template has changed.
+    """
+    template_name: t.Any
+
+    for node in ast.find_all(_ref_types):
+        template: nodes.Expr = node.template  # type: ignore
+
+        if not isinstance(template, nodes.Const):
+            # a tuple with some non consts in there
+            if isinstance(template, (nodes.Tuple, nodes.List)):
+                for template_name in template.items:
+                    # something const, only yield the strings and ignore
+                    # non-string consts that really just make no sense
+                    if isinstance(template_name, nodes.Const):
+                        if isinstance(template_name.value, str):
+                            yield template_name.value
+                    # something dynamic in there
+                    else:
+                        yield None
+            # something dynamic we don't know about here
+            else:
+                yield None
+            continue
+        # constant is a basestring, direct template name
+        if isinstance(template.value, str):
+            yield template.value
+        # a tuple or list (latter *should* not happen) made of consts,
+        # yield the consts that are strings.  We could warn here for
+        # non string values
+        elif isinstance(node, nodes.Include) and isinstance(
+            template.value, (tuple, list)
+        ):
+            for template_name in template.value:
+                if isinstance(template_name, str):
+                    yield template_name
+        # something else we don't care about, we could warn here
+        else:
+            yield None
diff --git a/llm/Lib/site-packages/jinja2/nativetypes.py b/llm/Lib/site-packages/jinja2/nativetypes.py
new file mode 100644
index 0000000000000000000000000000000000000000..71db8cc31f45efee11eaad9d8807da389470cf15
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/nativetypes.py
@@ -0,0 +1,130 @@
+import typing as t
+from ast import literal_eval
+from ast import parse
+from itertools import chain
+from itertools import islice
+from types import GeneratorType
+
+from . import nodes
+from .compiler import CodeGenerator
+from .compiler import Frame
+from .compiler import has_safe_repr
+from .environment import Environment
+from .environment import Template
+
+
+def native_concat(values: t.Iterable[t.Any]) -> t.Optional[t.Any]:
+    """Return a native Python type from the list of compiled nodes. If
+    the result is a single node, its value is returned. Otherwise, the
+    nodes are concatenated as strings. If the result can be parsed with
+    :func:`ast.literal_eval`, the parsed value is returned. Otherwise,
+    the string is returned.
+
+    :param values: Iterable of outputs to concatenate.
+    """
+    head = list(islice(values, 2))
+
+    if not head:
+        return None
+
+    if len(head) == 1:
+        raw = head[0]
+        if not isinstance(raw, str):
+            return raw
+    else:
+        if isinstance(values, GeneratorType):
+            values = chain(head, values)
+        raw = "".join([str(v) for v in values])
+
+    try:
+        return literal_eval(
+            # In Python 3.10+ ast.literal_eval removes leading spaces/tabs
+            # from the given string. For backwards compatibility we need to
+            # parse the string ourselves without removing leading spaces/tabs.
+            parse(raw, mode="eval")
+        )
+    except (ValueError, SyntaxError, MemoryError):
+        return raw
+
+
+class NativeCodeGenerator(CodeGenerator):
+    """A code generator which renders Python types by not adding
+    ``str()`` around output nodes.
+    """
+
+    @staticmethod
+    def _default_finalize(value: t.Any) -> t.Any:
+        return value
+
+    def _output_const_repr(self, group: t.Iterable[t.Any]) -> str:
+        return repr("".join([str(v) for v in group]))
+
+    def _output_child_to_const(
+        self, node: nodes.Expr, frame: Frame, finalize: CodeGenerator._FinalizeInfo
+    ) -> t.Any:
+        const = node.as_const(frame.eval_ctx)
+
+        if not has_safe_repr(const):
+            raise nodes.Impossible()
+
+        if isinstance(node, nodes.TemplateData):
+            return const
+
+        return finalize.const(const)  # type: ignore
+
+    def _output_child_pre(
+        self, node: nodes.Expr, frame: Frame, finalize: CodeGenerator._FinalizeInfo
+    ) -> None:
+        if finalize.src is not None:
+            self.write(finalize.src)
+
+    def _output_child_post(
+        self, node: nodes.Expr, frame: Frame, finalize: CodeGenerator._FinalizeInfo
+    ) -> None:
+        if finalize.src is not None:
+            self.write(")")
+
+
+class NativeEnvironment(Environment):
+    """An environment that renders templates to native Python types."""
+
+    code_generator_class = NativeCodeGenerator
+    concat = staticmethod(native_concat)  # type: ignore
+
+
+class NativeTemplate(Template):
+    environment_class = NativeEnvironment
+
+    def render(self, *args: t.Any, **kwargs: t.Any) -> t.Any:
+        """Render the template to produce a native Python type. If the
+        result is a single node, its value is returned. Otherwise, the
+        nodes are concatenated as strings. If the result can be parsed
+        with :func:`ast.literal_eval`, the parsed value is returned.
+        Otherwise, the string is returned.
+        """
+        ctx = self.new_context(dict(*args, **kwargs))
+
+        try:
+            return self.environment_class.concat(  # type: ignore
+                self.root_render_func(ctx)
+            )
+        except Exception:
+            return self.environment.handle_exception()
+
+    async def render_async(self, *args: t.Any, **kwargs: t.Any) -> t.Any:
+        if not self.environment.is_async:
+            raise RuntimeError(
+                "The environment was not created with async mode enabled."
+            )
+
+        ctx = self.new_context(dict(*args, **kwargs))
+
+        try:
+            return self.environment_class.concat(  # type: ignore
+                [n async for n in self.root_render_func(ctx)]  # type: ignore
+            )
+        except Exception:
+            return self.environment.handle_exception()
+
+
+NativeEnvironment.template_class = NativeTemplate
diff --git a/llm/Lib/site-packages/jinja2/nodes.py b/llm/Lib/site-packages/jinja2/nodes.py
new file mode 100644
index 0000000000000000000000000000000000000000..b2f88d9d9c19a2cb5d03b0158c743c6b947a29ea
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/nodes.py
@@ -0,0 +1,1204 @@
+"""AST nodes generated by the parser for the compiler. Also provides
+some node tree helper functions used by the parser and compiler in order
+to normalize nodes.
+"""
+import inspect
+import operator
+import typing as t
+from collections import deque
+
+from markupsafe import Markup
+
+from .utils import _PassArg
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+    from .environment import Environment
+
+_NodeBound = t.TypeVar("_NodeBound", bound="Node")
+
+_binop_to_func: t.Dict[str, t.Callable[[t.Any, t.Any], t.Any]] = {
+    "*": operator.mul,
+    "/": operator.truediv,
+    "//": operator.floordiv,
+    "**": operator.pow,
+    "%": operator.mod,
+    "+": operator.add,
+    "-": operator.sub,
+}
+
+_uaop_to_func: t.Dict[str, t.Callable[[t.Any], t.Any]] = {
+    "not": operator.not_,
+    "+": operator.pos,
+    "-": operator.neg,
+}
+
+_cmpop_to_func: t.Dict[str, t.Callable[[t.Any, t.Any], t.Any]] = {
+    "eq": operator.eq,
+    "ne": operator.ne,
+    "gt": operator.gt,
+    "gteq": operator.ge,
+    "lt": operator.lt,
+    "lteq": operator.le,
+    "in": lambda a, b: a in b,
+    "notin": lambda a, b: a not in b,
+}
+
+
+class Impossible(Exception):
+    """Raised if the node could not perform a requested action."""
+
+
+class NodeType(type):
+    """A metaclass for nodes that handles the field and attribute
+    inheritance.  fields and attributes from the parent class are
+    automatically forwarded to the child."""
+
+    def __new__(mcs, name, bases, d):  # type: ignore
+        for attr in "fields", "attributes":
+            storage = []
+            storage.extend(getattr(bases[0] if bases else object, attr, ()))
+            storage.extend(d.get(attr, ()))
+            assert len(bases) <= 1, "multiple inheritance not allowed"
+            assert len(storage) == len(set(storage)), "layout conflict"
+            d[attr] = tuple(storage)
+        d.setdefault("abstract", False)
+        return type.__new__(mcs, name, bases, d)
+
+
+class EvalContext:
+    """Holds evaluation time information.  Custom attributes can be attached
+    to it in extensions.
+    """
+
+    def __init__(
+        self, environment: "Environment", template_name: t.Optional[str] = None
+    ) -> None:
+        self.environment = environment
+        if callable(environment.autoescape):
+            self.autoescape = environment.autoescape(template_name)
+        else:
+            self.autoescape = environment.autoescape
+        self.volatile = False
+
+    def save(self) -> t.Mapping[str, t.Any]:
+        return self.__dict__.copy()
+
+    def revert(self, old: t.Mapping[str, t.Any]) -> None:
+        self.__dict__.clear()
+        self.__dict__.update(old)
+
+
+def get_eval_context(node: "Node", ctx: t.Optional[EvalContext]) -> EvalContext:
+    if ctx is None:
+        if node.environment is None:
+            raise RuntimeError(
+                "if no eval context is passed, the node must have an"
+                " attached environment."
+            )
+        return EvalContext(node.environment)
+    return ctx
+
+
+class Node(metaclass=NodeType):
+    """Baseclass for all Jinja nodes.  There are a number of nodes available
+    of different types.  There are four major types:
+
+    -   :class:`Stmt`: statements
+    -   :class:`Expr`: expressions
+    -   :class:`Helper`: helper nodes
+    -   :class:`Template`: the outermost wrapper node
+
+    All nodes have fields and attributes.  Fields may be other nodes, lists,
+    or arbitrary values.  Fields are passed to the constructor as regular
+    positional arguments, attributes as keyword arguments.  Each node has
+    two attributes: `lineno` (the line number of the node) and `environment`.
+    The `environment` attribute is set at the end of the parsing process for
+    all nodes automatically.
+    """
+
+    fields: t.Tuple[str, ...] = ()
+    attributes: t.Tuple[str, ...] = ("lineno", "environment")
+    abstract = True
+
+    lineno: int
+    environment: t.Optional["Environment"]
+
+    def __init__(self, *fields: t.Any, **attributes: t.Any) -> None:
+        if self.abstract:
+            raise TypeError("abstract nodes are not instantiable")
+        if fields:
+            if len(fields) != len(self.fields):
+                if not self.fields:
+                    raise TypeError(f"{type(self).__name__!r} takes 0 arguments")
+                raise TypeError(
+                    f"{type(self).__name__!r} takes 0 or {len(self.fields)}"
+                    f" argument{'s' if len(self.fields) != 1 else ''}"
+                )
+            for name, arg in zip(self.fields, fields):
+                setattr(self, name, arg)
+        for attr in self.attributes:
+            setattr(self, attr, attributes.pop(attr, None))
+        if attributes:
+            raise TypeError(f"unknown attribute {next(iter(attributes))!r}")
+
+    def iter_fields(
+        self,
+        exclude: t.Optional[t.Container[str]] = None,
+        only: t.Optional[t.Container[str]] = None,
+    ) -> t.Iterator[t.Tuple[str, t.Any]]:
+        """This method iterates over all fields that are defined and yields
+        ``(key, value)`` tuples.  Per default all fields are returned, but
+        it's possible to limit that to some fields by providing the `only`
+        parameter or to exclude some using the `exclude` parameter.  Both
+        should be sets or tuples of field names.
+        """
+        for name in self.fields:
+            if (
+                (exclude is None and only is None)
+                or (exclude is not None and name not in exclude)
+                or (only is not None and name in only)
+            ):
+                try:
+                    yield name, getattr(self, name)
+                except AttributeError:
+                    pass
+
+    def iter_child_nodes(
+        self,
+        exclude: t.Optional[t.Container[str]] = None,
+        only: t.Optional[t.Container[str]] = None,
+    ) -> t.Iterator["Node"]:
+        """Iterates over all direct child nodes of the node.  This iterates
+        over all fields and yields the values of they are nodes.  If the value
+        of a field is a list all the nodes in that list are returned.
+        """
+        for _, item in self.iter_fields(exclude, only):
+            if isinstance(item, list):
+                for n in item:
+                    if isinstance(n, Node):
+                        yield n
+            elif isinstance(item, Node):
+                yield item
+
+    def find(self, node_type: t.Type[_NodeBound]) -> t.Optional[_NodeBound]:
+        """Find the first node of a given type.  If no such node exists the
+        return value is `None`.
+        """
+        for result in self.find_all(node_type):
+            return result
+
+        return None
+
+    def find_all(
+        self, node_type: t.Union[t.Type[_NodeBound], t.Tuple[t.Type[_NodeBound], ...]]
+    ) -> t.Iterator[_NodeBound]:
+        """Find all the nodes of a given type.  If the type is a tuple,
+        the check is performed for any of the tuple items.
+        """
+        for child in self.iter_child_nodes():
+            if isinstance(child, node_type):
+                yield child  # type: ignore
+            yield from child.find_all(node_type)
+
+    def set_ctx(self, ctx: str) -> "Node":
+        """Reset the context of a node and all child nodes.  Per default the
+        parser will all generate nodes that have a 'load' context as it's the
+        most common one.  This method is used in the parser to set assignment
+        targets and other nodes to a store context.
+        """
+        todo = deque([self])
+        while todo:
+            node = todo.popleft()
+            if "ctx" in node.fields:
+                node.ctx = ctx  # type: ignore
+            todo.extend(node.iter_child_nodes())
+        return self
+
+    def set_lineno(self, lineno: int, override: bool = False) -> "Node":
+        """Set the line numbers of the node and children."""
+        todo = deque([self])
+        while todo:
+            node = todo.popleft()
+            if "lineno" in node.attributes:
+                if node.lineno is None or override:
+                    node.lineno = lineno
+            todo.extend(node.iter_child_nodes())
+        return self
+
+    def set_environment(self, environment: "Environment") -> "Node":
+        """Set the environment for all nodes."""
+        todo = deque([self])
+        while todo:
+            node = todo.popleft()
+            node.environment = environment
+            todo.extend(node.iter_child_nodes())
+        return self
+
+    def __eq__(self, other: t.Any) -> bool:
+        if type(self) is not type(other):
+            return NotImplemented
+
+        return tuple(self.iter_fields()) == tuple(other.iter_fields())
+
+    __hash__ = object.__hash__
+
+    def __repr__(self) -> str:
+        args_str = ", ".join(f"{a}={getattr(self, a, None)!r}" for a in self.fields)
+        return f"{type(self).__name__}({args_str})"
+
+    def dump(self) -> str:
+        def _dump(node: t.Union[Node, t.Any]) -> None:
+            if not isinstance(node, Node):
+                buf.append(repr(node))
+                return
+
+            buf.append(f"nodes.{type(node).__name__}(")
+            if not node.fields:
+                buf.append(")")
+                return
+            for idx, field in enumerate(node.fields):
+                if idx:
+                    buf.append(", ")
+                value = getattr(node, field)
+                if isinstance(value, list):
+                    buf.append("[")
+                    for idx, item in enumerate(value):
+                        if idx:
+                            buf.append(", ")
+                        _dump(item)
+                    buf.append("]")
+                else:
+                    _dump(value)
+            buf.append(")")
+
+        buf: t.List[str] = []
+        _dump(self)
+        return "".join(buf)
+
+
+class Stmt(Node):
+    """Base node for all statements."""
+
+    abstract = True
+
+
+class Helper(Node):
+    """Nodes that exist in a specific context only."""
+
+    abstract = True
+
+
+class Template(Node):
+    """Node that represents a template.  This must be the outermost node that
+    is passed to the compiler.
+    """
+
+    fields = ("body",)
+    body: t.List[Node]
+
+
+class Output(Stmt):
+    """A node that holds multiple expressions which are then printed out.
+    This is used both for the `print` statement and the regular template data.
+    """
+
+    fields = ("nodes",)
+    nodes: t.List["Expr"]
+
+
+class Extends(Stmt):
+    """Represents an extends statement."""
+
+    fields = ("template",)
+    template: "Expr"
+
+
+class For(Stmt):
+    """The for loop.  `target` is the target for the iteration (usually a
+    :class:`Name` or :class:`Tuple`), `iter` the iterable.  `body` is a list
+    of nodes that are used as loop-body, and `else_` a list of nodes for the
+    `else` block.  If no else node exists it has to be an empty list.
+
+    For filtered nodes an expression can be stored as `test`, otherwise `None`.
+    """
+
+    fields = ("target", "iter", "body", "else_", "test", "recursive")
+    target: Node
+    iter: Node
+    body: t.List[Node]
+    else_: t.List[Node]
+    test: t.Optional[Node]
+    recursive: bool
+
+
+class If(Stmt):
+    """If `test` is true, `body` is rendered, else `else_`."""
+
+    fields = ("test", "body", "elif_", "else_")
+    test: Node
+    body: t.List[Node]
+    elif_: t.List["If"]
+    else_: t.List[Node]
+
+
+class Macro(Stmt):
+    """A macro definition.  `name` is the name of the macro, `args` a list of
+    arguments and `defaults` a list of defaults if there are any.  `body` is
+    a list of nodes for the macro body.
+    """
+
+    fields = ("name", "args", "defaults", "body")
+    name: str
+    args: t.List["Name"]
+    defaults: t.List["Expr"]
+    body: t.List[Node]
+
+
+class CallBlock(Stmt):
+    """Like a macro without a name but a call instead.  `call` is called with
+    the unnamed macro as `caller` argument this node holds.
+    """
+
+    fields = ("call", "args", "defaults", "body")
+    call: "Call"
+    args: t.List["Name"]
+    defaults: t.List["Expr"]
+    body: t.List[Node]
+
+
+class FilterBlock(Stmt):
+    """Node for filter sections."""
+
+    fields = ("body", "filter")
+    body: t.List[Node]
+    filter: "Filter"
+
+
+class With(Stmt):
+    """Specific node for with statements.  In older versions of Jinja the
+    with statement was implemented on the base of the `Scope` node instead.
+
+    .. versionadded:: 2.9.3
+    """
+
+    fields = ("targets", "values", "body")
+    targets: t.List["Expr"]
+    values: t.List["Expr"]
+    body: t.List[Node]
+
+
+class Block(Stmt):
+    """A node that represents a block.
+
+    .. versionchanged:: 3.0.0
+        the `required` field was added.
+    """
+
+    fields = ("name", "body", "scoped", "required")
+    name: str
+    body: t.List[Node]
+    scoped: bool
+    required: bool
+
+
+class Include(Stmt):
+    """A node that represents the include tag."""
+
+    fields = ("template", "with_context", "ignore_missing")
+    template: "Expr"
+    with_context: bool
+    ignore_missing: bool
+
+
+class Import(Stmt):
+    """A node that represents the import tag."""
+
+    fields = ("template", "target", "with_context")
+    template: "Expr"
+    target: str
+    with_context: bool
+
+
+class FromImport(Stmt):
+    """A node that represents the from import tag.  It's important to not
+    pass unsafe names to the name attribute.  The compiler translates the
+    attribute lookups directly into getattr calls and does *not* use the
+    subscript callback of the interface.  As exported variables may not
+    start with double underscores (which the parser asserts) this is not a
+    problem for regular Jinja code, but if this node is used in an extension
+    extra care must be taken.
+
+    The list of names may contain tuples if aliases are wanted.
+    """
+
+    fields = ("template", "names", "with_context")
+    template: "Expr"
+    names: t.List[t.Union[str, t.Tuple[str, str]]]
+    with_context: bool
+
+
+class ExprStmt(Stmt):
+    """A statement that evaluates an expression and discards the result."""
+
+    fields = ("node",)
+    node: Node
+
+
+class Assign(Stmt):
+    """Assigns an expression to a target."""
+
+    fields = ("target", "node")
+    target: "Expr"
+    node: Node
+
+
+class AssignBlock(Stmt):
+    """Assigns a block to a target."""
+
+    fields = ("target", "filter", "body")
+    target: "Expr"
+    filter: t.Optional["Filter"]
+    body: t.List[Node]
+
+
+class Expr(Node):
+    """Baseclass for all expressions."""
+
+    abstract = True
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Any:
+        """Return the value of the expression as constant or raise
+        :exc:`Impossible` if this was not possible.
+
+        An :class:`EvalContext` can be provided, if none is given
+        a default context is created which requires the nodes to have
+        an attached environment.
+
+        .. versionchanged:: 2.4
+           the `eval_ctx` parameter was added.
+        """
+        raise Impossible()
+
+    def can_assign(self) -> bool:
+        """Check if it's possible to assign something to this node."""
+        return False
+
+
+class BinExpr(Expr):
+    """Baseclass for all binary expressions."""
+
+    fields = ("left", "right")
+    left: Expr
+    right: Expr
+    operator: str
+    abstract = True
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Any:
+        eval_ctx = get_eval_context(self, eval_ctx)
+
+        # intercepted operators cannot be folded at compile time
+        if (
+            eval_ctx.environment.sandboxed
+            and self.operator in eval_ctx.environment.intercepted_binops  # type: ignore
+        ):
+            raise Impossible()
+        f = _binop_to_func[self.operator]
+        try:
+            return f(self.left.as_const(eval_ctx), self.right.as_const(eval_ctx))
+        except Exception as e:
+            raise Impossible() from e
+
+
+class UnaryExpr(Expr):
+    """Baseclass for all unary expressions."""
+
+    fields = ("node",)
+    node: Expr
+    operator: str
+    abstract = True
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Any:
+        eval_ctx = get_eval_context(self, eval_ctx)
+
+        # intercepted operators cannot be folded at compile time
+        if (
+            eval_ctx.environment.sandboxed
+            and self.operator in eval_ctx.environment.intercepted_unops  # type: ignore
+        ):
+            raise Impossible()
+        f = _uaop_to_func[self.operator]
+        try:
+            return f(self.node.as_const(eval_ctx))
+        except Exception as e:
+            raise Impossible() from e
+
+
+class Name(Expr):
+    """Looks up a name or stores a value in a name.
+    The `ctx` of the node can be one of the following values:
+
+    -   `store`: store a value in the name
+    -   `load`: load that name
+    -   `param`: like `store` but if the name was defined as function parameter.
+    """
+
+    fields = ("name", "ctx")
+    name: str
+    ctx: str
+
+    def can_assign(self) -> bool:
+        return self.name not in {"true", "false", "none", "True", "False", "None"}
+
+
+class NSRef(Expr):
+    """Reference to a namespace value assignment"""
+
+    fields = ("name", "attr")
+    name: str
+    attr: str
+
+    def can_assign(self) -> bool:
+        # We don't need any special checks here; NSRef assignments have a
+        # runtime check to ensure the target is a namespace object which will
+        # have been checked already as it is created using a normal assignment
+        # which goes through a `Name` node.
+        return True
+
+
+class Literal(Expr):
+    """Baseclass for literals."""
+
+    abstract = True
+
+
+class Const(Literal):
+    """All constant values.  The parser will return this node for simple
+    constants such as ``42`` or ``"foo"`` but it can be used to store more
+    complex values such as lists too.  Only constants with a safe
+    representation (objects where ``eval(repr(x)) == x`` is true).
+    """
+
+    fields = ("value",)
+    value: t.Any
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Any:
+        return self.value
+
+    @classmethod
+    def from_untrusted(
+        cls,
+        value: t.Any,
+        lineno: t.Optional[int] = None,
+        environment: "t.Optional[Environment]" = None,
+    ) -> "Const":
+        """Return a const object if the value is representable as
+        constant value in the generated code, otherwise it will raise
+        an `Impossible` exception.
+        """
+        from .compiler import has_safe_repr
+
+        if not has_safe_repr(value):
+            raise Impossible()
+        return cls(value, lineno=lineno, environment=environment)
+
+
+class TemplateData(Literal):
+    """A constant template string."""
+
+    fields = ("data",)
+    data: str
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> str:
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if eval_ctx.volatile:
+            raise Impossible()
+        if eval_ctx.autoescape:
+            return Markup(self.data)
+        return self.data
+
+
+class Tuple(Literal):
+    """For loop unpacking and some other things like multiple arguments
+    for subscripts.  Like for :class:`Name` `ctx` specifies if the tuple
+    is used for loading the names or storing.
+    """
+
+    fields = ("items", "ctx")
+    items: t.List[Expr]
+    ctx: str
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Tuple[t.Any, ...]:
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return tuple(x.as_const(eval_ctx) for x in self.items)
+
+    def can_assign(self) -> bool:
+        for item in self.items:
+            if not item.can_assign():
+                return False
+        return True
+
+
+class List(Literal):
+    """Any list literal such as ``[1, 2, 3]``"""
+
+    fields = ("items",)
+    items: t.List[Expr]
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.List[t.Any]:
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return [x.as_const(eval_ctx) for x in self.items]
+
+
+class Dict(Literal):
+    """Any dict literal such as ``{1: 2, 3: 4}``.  The items must be a list of
+    :class:`Pair` nodes.
+    """
+
+    fields = ("items",)
+    items: t.List["Pair"]
+
+    def as_const(
+        self, eval_ctx: t.Optional[EvalContext] = None
+    ) -> t.Dict[t.Any, t.Any]:
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return dict(x.as_const(eval_ctx) for x in self.items)
+
+
+class Pair(Helper):
+    """A key, value pair for dicts."""
+
+    fields = ("key", "value")
+    key: Expr
+    value: Expr
+
+    def as_const(
+        self, eval_ctx: t.Optional[EvalContext] = None
+    ) -> t.Tuple[t.Any, t.Any]:
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.key.as_const(eval_ctx), self.value.as_const(eval_ctx)
+
+
+class Keyword(Helper):
+    """A key, value pair for keyword arguments where key is a string."""
+
+    fields = ("key", "value")
+    key: str
+    value: Expr
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Tuple[str, t.Any]:
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.key, self.value.as_const(eval_ctx)
+
+
+class CondExpr(Expr):
+    """A conditional expression (inline if expression).  (``{{
+    foo if bar else baz }}``)
+    """
+
+    fields = ("test", "expr1", "expr2")
+    test: Expr
+    expr1: Expr
+    expr2: t.Optional[Expr]
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Any:
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if self.test.as_const(eval_ctx):
+            return self.expr1.as_const(eval_ctx)
+
+        # if we evaluate to an undefined object, we better do that at runtime
+        if self.expr2 is None:
+            raise Impossible()
+
+        return self.expr2.as_const(eval_ctx)
+
+
+def args_as_const(
+    node: t.Union["_FilterTestCommon", "Call"], eval_ctx: t.Optional[EvalContext]
+) -> t.Tuple[t.List[t.Any], t.Dict[t.Any, t.Any]]:
+    args = [x.as_const(eval_ctx) for x in node.args]
+    kwargs = dict(x.as_const(eval_ctx) for x in node.kwargs)
+
+    if node.dyn_args is not None:
+        try:
+            args.extend(node.dyn_args.as_const(eval_ctx))
+        except Exception as e:
+            raise Impossible() from e
+
+    if node.dyn_kwargs is not None:
+        try:
+            kwargs.update(node.dyn_kwargs.as_const(eval_ctx))
+        except Exception as e:
+            raise Impossible() from e
+
+    return args, kwargs
+
+
+class _FilterTestCommon(Expr):
+    fields = ("node", "name", "args", "kwargs", "dyn_args", "dyn_kwargs")
+    node: Expr
+    name: str
+    args: t.List[Expr]
+    kwargs: t.List[Pair]
+    dyn_args: t.Optional[Expr]
+    dyn_kwargs: t.Optional[Expr]
+    abstract = True
+    _is_filter = True
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Any:
+        eval_ctx = get_eval_context(self, eval_ctx)
+
+        if eval_ctx.volatile:
+            raise Impossible()
+
+        if self._is_filter:
+            env_map = eval_ctx.environment.filters
+        else:
+            env_map = eval_ctx.environment.tests
+
+        func = env_map.get(self.name)
+        pass_arg = _PassArg.from_obj(func)  # type: ignore
+
+        if func is None or pass_arg is _PassArg.context:
+            raise Impossible()
+
+        if eval_ctx.environment.is_async and (
+            getattr(func, "jinja_async_variant", False) is True
+            or inspect.iscoroutinefunction(func)
+        ):
+            raise Impossible()
+
+        args, kwargs = args_as_const(self, eval_ctx)
+        args.insert(0, self.node.as_const(eval_ctx))
+
+        if pass_arg is _PassArg.eval_context:
+            args.insert(0, eval_ctx)
+        elif pass_arg is _PassArg.environment:
+            args.insert(0, eval_ctx.environment)
+
+        try:
+            return func(*args, **kwargs)
+        except Exception as e:
+            raise Impossible() from e
+
+
+class Filter(_FilterTestCommon):
+    """Apply a filter to an expression. ``name`` is the name of the
+    filter, the other fields are the same as :class:`Call`.
+
+    If ``node`` is ``None``, the filter is being used in a filter block
+    and is applied to the content of the block.
+    """
+
+    node: t.Optional[Expr]  # type: ignore
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Any:
+        if self.node is None:
+            raise Impossible()
+
+        return super().as_const(eval_ctx=eval_ctx)
+
+
+class Test(_FilterTestCommon):
+    """Apply a test to an expression. ``name`` is the name of the test,
+    the other field are the same as :class:`Call`.
+
+    .. versionchanged:: 3.0
+        ``as_const`` shares the same logic for filters and tests. Tests
+        check for volatile, async, and ``@pass_context`` etc.
+        decorators.
+    """
+
+    _is_filter = False
+
+
+class Call(Expr):
+    """Calls an expression.  `args` is a list of arguments, `kwargs` a list
+    of keyword arguments (list of :class:`Keyword` nodes), and `dyn_args`
+    and `dyn_kwargs` has to be either `None` or a node that is used as
+    node for dynamic positional (``*args``) or keyword (``**kwargs``)
+    arguments.
+    """
+
+    fields = ("node", "args", "kwargs", "dyn_args", "dyn_kwargs")
+    node: Expr
+    args: t.List[Expr]
+    kwargs: t.List[Keyword]
+    dyn_args: t.Optional[Expr]
+    dyn_kwargs: t.Optional[Expr]
+
+
+class Getitem(Expr):
+    """Get an attribute or item from an expression and prefer the item."""
+
+    fields = ("node", "arg", "ctx")
+    node: Expr
+    arg: Expr
+    ctx: str
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Any:
+        if self.ctx != "load":
+            raise Impossible()
+
+        eval_ctx = get_eval_context(self, eval_ctx)
+
+        try:
+            return eval_ctx.environment.getitem(
+                self.node.as_const(eval_ctx), self.arg.as_const(eval_ctx)
+            )
+        except Exception as e:
+            raise Impossible() from e
+
+
+class Getattr(Expr):
+    """Get an attribute or item from an expression that is a ascii-only
+    bytestring and prefer the attribute.
+    """
+
+    fields = ("node", "attr", "ctx")
+    node: Expr
+    attr: str
+    ctx: str
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Any:
+        if self.ctx != "load":
+            raise Impossible()
+
+        eval_ctx = get_eval_context(self, eval_ctx)
+
+        try:
+            return eval_ctx.environment.getattr(self.node.as_const(eval_ctx), self.attr)
+        except Exception as e:
+            raise Impossible() from e
+
+
+class Slice(Expr):
+    """Represents a slice object.  This must only be used as argument for
+    :class:`Subscript`.
+    """
+
+    fields = ("start", "stop", "step")
+    start: t.Optional[Expr]
+    stop: t.Optional[Expr]
+    step: t.Optional[Expr]
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> slice:
+        eval_ctx = get_eval_context(self, eval_ctx)
+
+        def const(obj: t.Optional[Expr]) -> t.Optional[t.Any]:
+            if obj is None:
+                return None
+            return obj.as_const(eval_ctx)
+
+        return slice(const(self.start), const(self.stop), const(self.step))
+
+
+class Concat(Expr):
+    """Concatenates the list of expressions provided after converting
+    them to strings.
+    """
+
+    fields = ("nodes",)
+    nodes: t.List[Expr]
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> str:
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return "".join(str(x.as_const(eval_ctx)) for x in self.nodes)
+
+
+class Compare(Expr):
+    """Compares an expression with some other expressions.  `ops` must be a
+    list of :class:`Operand`\\s.
+    """
+
+    fields = ("expr", "ops")
+    expr: Expr
+    ops: t.List["Operand"]
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Any:
+        eval_ctx = get_eval_context(self, eval_ctx)
+        result = value = self.expr.as_const(eval_ctx)
+
+        try:
+            for op in self.ops:
+                new_value = op.expr.as_const(eval_ctx)
+                result = _cmpop_to_func[op.op](value, new_value)
+
+                if not result:
+                    return False
+
+                value = new_value
+        except Exception as e:
+            raise Impossible() from e
+
+        return result
+
+
+class Operand(Helper):
+    """Holds an operator and an expression."""
+
+    fields = ("op", "expr")
+    op: str
+    expr: Expr
+
+
+class Mul(BinExpr):
+    """Multiplies the left with the right node."""
+
+    operator = "*"
+
+
+class Div(BinExpr):
+    """Divides the left by the right node."""
+
+    operator = "/"
+
+
+class FloorDiv(BinExpr):
+    """Divides the left by the right node and converts the
+    result into an integer by truncating.
+    """
+
+    operator = "//"
+
+
+class Add(BinExpr):
+    """Add the left to the right node."""
+
+    operator = "+"
+
+
+class Sub(BinExpr):
+    """Subtract the right from the left node."""
+
+    operator = "-"
+
+
+class Mod(BinExpr):
+    """Left modulo right."""
+
+    operator = "%"
+
+
+class Pow(BinExpr):
+    """Left to the power of right."""
+
+    operator = "**"
+
+
+class And(BinExpr):
+    """Short circuited AND."""
+
+    operator = "and"
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Any:
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.left.as_const(eval_ctx) and self.right.as_const(eval_ctx)
+
+
+class Or(BinExpr):
+    """Short circuited OR."""
+
+    operator = "or"
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> t.Any:
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.left.as_const(eval_ctx) or self.right.as_const(eval_ctx)
+
+
+class Not(UnaryExpr):
+    """Negate the expression."""
+
+    operator = "not"
+
+
+class Neg(UnaryExpr):
+    """Make the expression negative."""
+
+    operator = "-"
+
+
+class Pos(UnaryExpr):
+    """Make the expression positive (noop for most expressions)"""
+
+    operator = "+"
+
+
+# Helpers for extensions
+
+
+class EnvironmentAttribute(Expr):
+    """Loads an attribute from the environment object.  This is useful for
+    extensions that want to call a callback stored on the environment.
+    """
+
+    fields = ("name",)
+    name: str
+
+
+class ExtensionAttribute(Expr):
+    """Returns the attribute of an extension bound to the environment.
+    The identifier is the identifier of the :class:`Extension`.
+
+    This node is usually constructed by calling the
+    :meth:`~jinja2.ext.Extension.attr` method on an extension.
+    """
+
+    fields = ("identifier", "name")
+    identifier: str
+    name: str
+
+
+class ImportedName(Expr):
+    """If created with an import name the import name is returned on node
+    access.  For example ``ImportedName('cgi.escape')`` returns the `escape`
+    function from the cgi module on evaluation.  Imports are optimized by the
+    compiler so there is no need to assign them to local variables.
+    """
+
+    fields = ("importname",)
+    importname: str
+
+
+class InternalName(Expr):
+    """An internal name in the compiler.  You cannot create these nodes
+    yourself but the parser provides a
+    :meth:`~jinja2.parser.Parser.free_identifier` method that creates
+    a new identifier for you.  This identifier is not available from the
+    template and is not treated specially by the compiler.
+    """
+
+    fields = ("name",)
+    name: str
+
+    def __init__(self) -> None:
+        raise TypeError(
+            "Can't create internal names.  Use the "
+            "`free_identifier` method on a parser."
+        )
+
+
+class MarkSafe(Expr):
+    """Mark the wrapped expression as safe (wrap it as `Markup`)."""
+
+    fields = ("expr",)
+    expr: Expr
+
+    def as_const(self, eval_ctx: t.Optional[EvalContext] = None) -> Markup:
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return Markup(self.expr.as_const(eval_ctx))
+
+
+class MarkSafeIfAutoescape(Expr):
+    """Mark the wrapped expression as safe (wrap it as `Markup`) but
+    only if autoescaping is active.
+
+    .. versionadded:: 2.5
+    """
+
+    fields = ("expr",)
+    expr: Expr
+
+    def as_const(
+        self, eval_ctx: t.Optional[EvalContext] = None
+    ) -> t.Union[Markup, t.Any]:
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if eval_ctx.volatile:
+            raise Impossible()
+        expr = self.expr.as_const(eval_ctx)
+        if eval_ctx.autoescape:
+            return Markup(expr)
+        return expr
+
+
+class ContextReference(Expr):
+    """Returns the current template context.  It can be used like a
+    :class:`Name` node, with a ``'load'`` ctx and will return the
+    current :class:`~jinja2.runtime.Context` object.
+
+    Here an example that assigns the current template name to a
+    variable named `foo`::
+
+        Assign(Name('foo', ctx='store'),
+               Getattr(ContextReference(), 'name'))
+
+    This is basically equivalent to using the
+    :func:`~jinja2.pass_context` decorator when using the high-level
+    API, which causes a reference to the context to be passed as the
+    first argument to a function.
+    """
+
+
+class DerivedContextReference(Expr):
+    """Return the current template context including locals. Behaves
+    exactly like :class:`ContextReference`, but includes local
+    variables, such as from a ``for`` loop.
+
+    .. versionadded:: 2.11
+    """
+
+
+class Continue(Stmt):
+    """Continue a loop."""
+
+
+class Break(Stmt):
+    """Break a loop."""
+
+
+class Scope(Stmt):
+    """An artificial scope."""
+
+    fields = ("body",)
+    body: t.List[Node]
+
+
+class OverlayScope(Stmt):
+    """An overlay scope for extensions.  This is a largely unoptimized scope
+    that however can be used to introduce completely arbitrary variables into
+    a sub scope from a dictionary or dictionary like object.  The `context`
+    field has to evaluate to a dictionary object.
+
+    Example usage::
+
+        OverlayScope(context=self.call_method('get_context'),
+                     body=[...])
+
+    .. versionadded:: 2.10
+    """
+
+    fields = ("context", "body")
+    context: Expr
+    body: t.List[Node]
+
+
+class EvalContextModifier(Stmt):
+    """Modifies the eval context.  For each option that should be modified,
+    a :class:`Keyword` has to be added to the :attr:`options` list.
+
+    Example to change the `autoescape` setting::
+
+        EvalContextModifier(options=[Keyword('autoescape', Const(True))])
+    """
+
+    fields = ("options",)
+    options: t.List[Keyword]
+
+
+class ScopedEvalContextModifier(EvalContextModifier):
+    """Modifies the eval context and reverts it later.  Works exactly like
+    :class:`EvalContextModifier` but will only modify the
+    :class:`~jinja2.nodes.EvalContext` for nodes in the :attr:`body`.
+    """
+
+    fields = ("body",)
+    body: t.List[Node]
+
+
+# make sure nobody creates custom nodes
+def _failing_new(*args: t.Any, **kwargs: t.Any) -> "te.NoReturn":
+    raise TypeError("can't create custom node types")
+
+
+NodeType.__new__ = staticmethod(_failing_new)  # type: ignore
+del _failing_new
diff --git a/llm/Lib/site-packages/jinja2/optimizer.py b/llm/Lib/site-packages/jinja2/optimizer.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe1010705e7b29d4fa1900b3a0438ab93d7b582c
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/optimizer.py
@@ -0,0 +1,47 @@
+"""The optimizer tries to constant fold expressions and modify the AST
+in place so that it should be faster to evaluate.
+
+Because the AST does not contain all the scoping information and the
+compiler has to find that out, we cannot do all the optimizations we
+want. For example, loop unrolling doesn't work because unrolled loops
+would have a different scope. The solution would be a second syntax tree
+that stored the scoping rules.
+"""
+import typing as t
+
+from . import nodes
+from .visitor import NodeTransformer
+
+if t.TYPE_CHECKING:
+    from .environment import Environment
+
+
+def optimize(node: nodes.Node, environment: "Environment") -> nodes.Node:
+    """The context hint can be used to perform an static optimization
+    based on the context given."""
+    optimizer = Optimizer(environment)
+    return t.cast(nodes.Node, optimizer.visit(node))
+
+
+class Optimizer(NodeTransformer):
+    def __init__(self, environment: "t.Optional[Environment]") -> None:
+        self.environment = environment
+
+    def generic_visit(
+        self, node: nodes.Node, *args: t.Any, **kwargs: t.Any
+    ) -> nodes.Node:
+        node = super().generic_visit(node, *args, **kwargs)
+
+        # Do constant folding. Some other nodes besides Expr have
+        # as_const, but folding them causes errors later on.
+        if isinstance(node, nodes.Expr):
+            try:
+                return nodes.Const.from_untrusted(
+                    node.as_const(args[0] if args else None),
+                    lineno=node.lineno,
+                    environment=self.environment,
+                )
+            except nodes.Impossible:
+                pass
+
+        return node
diff --git a/llm/Lib/site-packages/jinja2/parser.py b/llm/Lib/site-packages/jinja2/parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..3354bc93390f405d9c11b1241b06443135241f22
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/parser.py
@@ -0,0 +1,1034 @@
+"""Parse tokens from the lexer into nodes for the compiler."""
+import typing
+import typing as t
+
+from . import nodes
+from .exceptions import TemplateAssertionError
+from .exceptions import TemplateSyntaxError
+from .lexer import describe_token
+from .lexer import describe_token_expr
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+    from .environment import Environment
+
+_ImportInclude = t.TypeVar("_ImportInclude", nodes.Import, nodes.Include)
+_MacroCall = t.TypeVar("_MacroCall", nodes.Macro, nodes.CallBlock)
+
+_statement_keywords = frozenset(
+    [
+        "for",
+        "if",
+        "block",
+        "extends",
+        "print",
+        "macro",
+        "include",
+        "from",
+        "import",
+        "set",
+        "with",
+        "autoescape",
+    ]
+)
+_compare_operators = frozenset(["eq", "ne", "lt", "lteq", "gt", "gteq"])
+
+_math_nodes: t.Dict[str, t.Type[nodes.Expr]] = {
+    "add": nodes.Add,
+    "sub": nodes.Sub,
+    "mul": nodes.Mul,
+    "div": nodes.Div,
+    "floordiv": nodes.FloorDiv,
+    "mod": nodes.Mod,
+}
+
+
+class Parser:
+    """This is the central parsing class Jinja uses.  It's passed to
+    extensions and can be used to parse expressions or statements.
+    """
+
+    def __init__(
+        self,
+        environment: "Environment",
+        source: str,
+        name: t.Optional[str] = None,
+        filename: t.Optional[str] = None,
+        state: t.Optional[str] = None,
+    ) -> None:
+        self.environment = environment
+        self.stream = environment._tokenize(source, name, filename, state)
+        self.name = name
+        self.filename = filename
+        self.closed = False
+        self.extensions: t.Dict[
+            str, t.Callable[["Parser"], t.Union[nodes.Node, t.List[nodes.Node]]]
+        ] = {}
+        for extension in environment.iter_extensions():
+            for tag in extension.tags:
+                self.extensions[tag] = extension.parse
+        self._last_identifier = 0
+        self._tag_stack: t.List[str] = []
+        self._end_token_stack: t.List[t.Tuple[str, ...]] = []
+
+    def fail(
+        self,
+        msg: str,
+        lineno: t.Optional[int] = None,
+        exc: t.Type[TemplateSyntaxError] = TemplateSyntaxError,
+    ) -> "te.NoReturn":
+        """Convenience method that raises `exc` with the message, passed
+        line number or last line number as well as the current name and
+        filename.
+        """
+        if lineno is None:
+            lineno = self.stream.current.lineno
+        raise exc(msg, lineno, self.name, self.filename)
+
+    def _fail_ut_eof(
+        self,
+        name: t.Optional[str],
+        end_token_stack: t.List[t.Tuple[str, ...]],
+        lineno: t.Optional[int],
+    ) -> "te.NoReturn":
+        expected: t.Set[str] = set()
+        for exprs in end_token_stack:
+            expected.update(map(describe_token_expr, exprs))
+        if end_token_stack:
+            currently_looking: t.Optional[str] = " or ".join(
+                map(repr, map(describe_token_expr, end_token_stack[-1]))
+            )
+        else:
+            currently_looking = None
+
+        if name is None:
+            message = ["Unexpected end of template."]
+        else:
+            message = [f"Encountered unknown tag {name!r}."]
+
+        if currently_looking:
+            if name is not None and name in expected:
+                message.append(
+                    "You probably made a nesting mistake. Jinja is expecting this tag,"
+                    f" but currently looking for {currently_looking}."
+                )
+            else:
+                message.append(
+                    f"Jinja was looking for the following tags: {currently_looking}."
+                )
+
+        if self._tag_stack:
+            message.append(
+                "The innermost block that needs to be closed is"
+                f" {self._tag_stack[-1]!r}."
+            )
+
+        self.fail(" ".join(message), lineno)
+
+    def fail_unknown_tag(
+        self, name: str, lineno: t.Optional[int] = None
+    ) -> "te.NoReturn":
+        """Called if the parser encounters an unknown tag.  Tries to fail
+        with a human readable error message that could help to identify
+        the problem.
+        """
+        self._fail_ut_eof(name, self._end_token_stack, lineno)
+
+    def fail_eof(
+        self,
+        end_tokens: t.Optional[t.Tuple[str, ...]] = None,
+        lineno: t.Optional[int] = None,
+    ) -> "te.NoReturn":
+        """Like fail_unknown_tag but for end of template situations."""
+        stack = list(self._end_token_stack)
+        if end_tokens is not None:
+            stack.append(end_tokens)
+        self._fail_ut_eof(None, stack, lineno)
+
+    def is_tuple_end(
+        self, extra_end_rules: t.Optional[t.Tuple[str, ...]] = None
+    ) -> bool:
+        """Are we at the end of a tuple?"""
+        if self.stream.current.type in ("variable_end", "block_end", "rparen"):
+            return True
+        elif extra_end_rules is not None:
+            return self.stream.current.test_any(extra_end_rules)  # type: ignore
+        return False
+
+    def free_identifier(self, lineno: t.Optional[int] = None) -> nodes.InternalName:
+        """Return a new free identifier as :class:`~jinja2.nodes.InternalName`."""
+        self._last_identifier += 1
+        rv = object.__new__(nodes.InternalName)
+        nodes.Node.__init__(rv, f"fi{self._last_identifier}", lineno=lineno)
+        return rv
+
+    def parse_statement(self) -> t.Union[nodes.Node, t.List[nodes.Node]]:
+        """Parse a single statement."""
+        token = self.stream.current
+        if token.type != "name":
+            self.fail("tag name expected", token.lineno)
+        self._tag_stack.append(token.value)
+        pop_tag = True
+        try:
+            if token.value in _statement_keywords:
+                f = getattr(self, f"parse_{self.stream.current.value}")
+                return f()  # type: ignore
+            if token.value == "call":
+                return self.parse_call_block()
+            if token.value == "filter":
+                return self.parse_filter_block()
+            ext = self.extensions.get(token.value)
+            if ext is not None:
+                return ext(self)
+
+            # did not work out, remove the token we pushed by accident
+            # from the stack so that the unknown tag fail function can
+            # produce a proper error message.
+            self._tag_stack.pop()
+            pop_tag = False
+            self.fail_unknown_tag(token.value, token.lineno)
+        finally:
+            if pop_tag:
+                self._tag_stack.pop()
+
+    def parse_statements(
+        self, end_tokens: t.Tuple[str, ...], drop_needle: bool = False
+    ) -> t.List[nodes.Node]:
+        """Parse multiple statements into a list until one of the end tokens
+        is reached.  This is used to parse the body of statements as it also
+        parses template data if appropriate.  The parser checks first if the
+        current token is a colon and skips it if there is one.  Then it checks
+        for the block end and parses until if one of the `end_tokens` is
+        reached.  Per default the active token in the stream at the end of
+        the call is the matched end token.  If this is not wanted `drop_needle`
+        can be set to `True` and the end token is removed.
+        """
+        # the first token may be a colon for python compatibility
+        self.stream.skip_if("colon")
+
+        # in the future it would be possible to add whole code sections
+        # by adding some sort of end of statement token and parsing those here.
+        self.stream.expect("block_end")
+        result = self.subparse(end_tokens)
+
+        # we reached the end of the template too early, the subparser
+        # does not check for this, so we do that now
+        if self.stream.current.type == "eof":
+            self.fail_eof(end_tokens)
+
+        if drop_needle:
+            next(self.stream)
+        return result
+
+    def parse_set(self) -> t.Union[nodes.Assign, nodes.AssignBlock]:
+        """Parse an assign statement."""
+        lineno = next(self.stream).lineno
+        target = self.parse_assign_target(with_namespace=True)
+        if self.stream.skip_if("assign"):
+            expr = self.parse_tuple()
+            return nodes.Assign(target, expr, lineno=lineno)
+        filter_node = self.parse_filter(None)
+        body = self.parse_statements(("name:endset",), drop_needle=True)
+        return nodes.AssignBlock(target, filter_node, body, lineno=lineno)
+
+    def parse_for(self) -> nodes.For:
+        """Parse a for loop."""
+        lineno = self.stream.expect("name:for").lineno
+        target = self.parse_assign_target(extra_end_rules=("name:in",))
+        self.stream.expect("name:in")
+        iter = self.parse_tuple(
+            with_condexpr=False, extra_end_rules=("name:recursive",)
+        )
+        test = None
+        if self.stream.skip_if("name:if"):
+            test = self.parse_expression()
+        recursive = self.stream.skip_if("name:recursive")
+        body = self.parse_statements(("name:endfor", "name:else"))
+        if next(self.stream).value == "endfor":
+            else_ = []
+        else:
+            else_ = self.parse_statements(("name:endfor",), drop_needle=True)
+        return nodes.For(target, iter, body, else_, test, recursive, lineno=lineno)
+
+    def parse_if(self) -> nodes.If:
+        """Parse an if construct."""
+        node = result = nodes.If(lineno=self.stream.expect("name:if").lineno)
+        while True:
+            node.test = self.parse_tuple(with_condexpr=False)
+            node.body = self.parse_statements(("name:elif", "name:else", "name:endif"))
+            node.elif_ = []
+            node.else_ = []
+            token = next(self.stream)
+            if token.test("name:elif"):
+                node = nodes.If(lineno=self.stream.current.lineno)
+                result.elif_.append(node)
+                continue
+            elif token.test("name:else"):
+                result.else_ = self.parse_statements(("name:endif",), drop_needle=True)
+            break
+        return result
+
+    def parse_with(self) -> nodes.With:
+        node = nodes.With(lineno=next(self.stream).lineno)
+        targets: t.List[nodes.Expr] = []
+        values: t.List[nodes.Expr] = []
+        while self.stream.current.type != "block_end":
+            if targets:
+                self.stream.expect("comma")
+            target = self.parse_assign_target()
+            target.set_ctx("param")
+            targets.append(target)
+            self.stream.expect("assign")
+            values.append(self.parse_expression())
+        node.targets = targets
+        node.values = values
+        node.body = self.parse_statements(("name:endwith",), drop_needle=True)
+        return node
+
+    def parse_autoescape(self) -> nodes.Scope:
+        node = nodes.ScopedEvalContextModifier(lineno=next(self.stream).lineno)
+        node.options = [nodes.Keyword("autoescape", self.parse_expression())]
+        node.body = self.parse_statements(("name:endautoescape",), drop_needle=True)
+        return nodes.Scope([node])
+
+    def parse_block(self) -> nodes.Block:
+        node = nodes.Block(lineno=next(self.stream).lineno)
+        node.name = self.stream.expect("name").value
+        node.scoped = self.stream.skip_if("name:scoped")
+        node.required = self.stream.skip_if("name:required")
+
+        # common problem people encounter when switching from django
+        # to jinja.  we do not support hyphens in block names, so let's
+        # raise a nicer error message in that case.
+        if self.stream.current.type == "sub":
+            self.fail(
+                "Block names in Jinja have to be valid Python identifiers and may not"
+                " contain hyphens, use an underscore instead."
+            )
+
+        node.body = self.parse_statements(("name:endblock",), drop_needle=True)
+
+        # enforce that required blocks only contain whitespace or comments
+        # by asserting that the body, if not empty, is just TemplateData nodes
+        # with whitespace data
+        if node.required:
+            for body_node in node.body:
+                if not isinstance(body_node, nodes.Output) or any(
+                    not isinstance(output_node, nodes.TemplateData)
+                    or not output_node.data.isspace()
+                    for output_node in body_node.nodes
+                ):
+                    self.fail("Required blocks can only contain comments or whitespace")
+
+        self.stream.skip_if("name:" + node.name)
+        return node
+
+    def parse_extends(self) -> nodes.Extends:
+        node = nodes.Extends(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        return node
+
+    def parse_import_context(
+        self, node: _ImportInclude, default: bool
+    ) -> _ImportInclude:
+        if self.stream.current.test_any(
+            "name:with", "name:without"
+        ) and self.stream.look().test("name:context"):
+            node.with_context = next(self.stream).value == "with"
+            self.stream.skip()
+        else:
+            node.with_context = default
+        return node
+
+    def parse_include(self) -> nodes.Include:
+        node = nodes.Include(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        if self.stream.current.test("name:ignore") and self.stream.look().test(
+            "name:missing"
+        ):
+            node.ignore_missing = True
+            self.stream.skip(2)
+        else:
+            node.ignore_missing = False
+        return self.parse_import_context(node, True)
+
+    def parse_import(self) -> nodes.Import:
+        node = nodes.Import(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        self.stream.expect("name:as")
+        node.target = self.parse_assign_target(name_only=True).name
+        return self.parse_import_context(node, False)
+
+    def parse_from(self) -> nodes.FromImport:
+        node = nodes.FromImport(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        self.stream.expect("name:import")
+        node.names = []
+
+        def parse_context() -> bool:
+            if self.stream.current.value in {
+                "with",
+                "without",
+            } and self.stream.look().test("name:context"):
+                node.with_context = next(self.stream).value == "with"
+                self.stream.skip()
+                return True
+            return False
+
+        while True:
+            if node.names:
+                self.stream.expect("comma")
+            if self.stream.current.type == "name":
+                if parse_context():
+                    break
+                target = self.parse_assign_target(name_only=True)
+                if target.name.startswith("_"):
+                    self.fail(
+                        "names starting with an underline can not be imported",
+                        target.lineno,
+                        exc=TemplateAssertionError,
+                    )
+                if self.stream.skip_if("name:as"):
+                    alias = self.parse_assign_target(name_only=True)
+                    node.names.append((target.name, alias.name))
+                else:
+                    node.names.append(target.name)
+                if parse_context() or self.stream.current.type != "comma":
+                    break
+            else:
+                self.stream.expect("name")
+        if not hasattr(node, "with_context"):
+            node.with_context = False
+        return node
+
+    def parse_signature(self, node: _MacroCall) -> None:
+        args = node.args = []
+        defaults = node.defaults = []
+        self.stream.expect("lparen")
+        while self.stream.current.type != "rparen":
+            if args:
+                self.stream.expect("comma")
+            arg = self.parse_assign_target(name_only=True)
+            arg.set_ctx("param")
+            if self.stream.skip_if("assign"):
+                defaults.append(self.parse_expression())
+            elif defaults:
+                self.fail("non-default argument follows default argument")
+            args.append(arg)
+        self.stream.expect("rparen")
+
+    def parse_call_block(self) -> nodes.CallBlock:
+        node = nodes.CallBlock(lineno=next(self.stream).lineno)
+        if self.stream.current.type == "lparen":
+            self.parse_signature(node)
+        else:
+            node.args = []
+            node.defaults = []
+
+        call_node = self.parse_expression()
+        if not isinstance(call_node, nodes.Call):
+            self.fail("expected call", node.lineno)
+        node.call = call_node
+        node.body = self.parse_statements(("name:endcall",), drop_needle=True)
+        return node
+
+    def parse_filter_block(self) -> nodes.FilterBlock:
+        node = nodes.FilterBlock(lineno=next(self.stream).lineno)
+        node.filter = self.parse_filter(None, start_inline=True)  # type: ignore
+        node.body = self.parse_statements(("name:endfilter",), drop_needle=True)
+        return node
+
+    def parse_macro(self) -> nodes.Macro:
+        node = nodes.Macro(lineno=next(self.stream).lineno)
+        node.name = self.parse_assign_target(name_only=True).name
+        self.parse_signature(node)
+        node.body = self.parse_statements(("name:endmacro",), drop_needle=True)
+        return node
+
+    def parse_print(self) -> nodes.Output:
+        node = nodes.Output(lineno=next(self.stream).lineno)
+        node.nodes = []
+        while self.stream.current.type != "block_end":
+            if node.nodes:
+                self.stream.expect("comma")
+            node.nodes.append(self.parse_expression())
+        return node
+
+    @typing.overload
+    def parse_assign_target(
+        self, with_tuple: bool = ..., name_only: "te.Literal[True]" = ...
+    ) -> nodes.Name:
+        ...
+
+    @typing.overload
+    def parse_assign_target(
+        self,
+        with_tuple: bool = True,
+        name_only: bool = False,
+        extra_end_rules: t.Optional[t.Tuple[str, ...]] = None,
+        with_namespace: bool = False,
+    ) -> t.Union[nodes.NSRef, nodes.Name, nodes.Tuple]:
+        ...
+
+    def parse_assign_target(
+        self,
+        with_tuple: bool = True,
+        name_only: bool = False,
+        extra_end_rules: t.Optional[t.Tuple[str, ...]] = None,
+        with_namespace: bool = False,
+    ) -> t.Union[nodes.NSRef, nodes.Name, nodes.Tuple]:
+        """Parse an assignment target.  As Jinja allows assignments to
+        tuples, this function can parse all allowed assignment targets.  Per
+        default assignments to tuples are parsed, that can be disable however
+        by setting `with_tuple` to `False`.  If only assignments to names are
+        wanted `name_only` can be set to `True`.  The `extra_end_rules`
+        parameter is forwarded to the tuple parsing function.  If
+        `with_namespace` is enabled, a namespace assignment may be parsed.
+        """
+        target: nodes.Expr
+
+        if with_namespace and self.stream.look().type == "dot":
+            token = self.stream.expect("name")
+            next(self.stream)  # dot
+            attr = self.stream.expect("name")
+            target = nodes.NSRef(token.value, attr.value, lineno=token.lineno)
+        elif name_only:
+            token = self.stream.expect("name")
+            target = nodes.Name(token.value, "store", lineno=token.lineno)
+        else:
+            if with_tuple:
+                target = self.parse_tuple(
+                    simplified=True, extra_end_rules=extra_end_rules
+                )
+            else:
+                target = self.parse_primary()
+
+            target.set_ctx("store")
+
+        if not target.can_assign():
+            self.fail(
+                f"can't assign to {type(target).__name__.lower()!r}", target.lineno
+            )
+
+        return target  # type: ignore
+
+    def parse_expression(self, with_condexpr: bool = True) -> nodes.Expr:
+        """Parse an expression.  Per default all expressions are parsed, if
+        the optional `with_condexpr` parameter is set to `False` conditional
+        expressions are not parsed.
+        """
+        if with_condexpr:
+            return self.parse_condexpr()
+        return self.parse_or()
+
+    def parse_condexpr(self) -> nodes.Expr:
+        lineno = self.stream.current.lineno
+        expr1 = self.parse_or()
+        expr3: t.Optional[nodes.Expr]
+
+        while self.stream.skip_if("name:if"):
+            expr2 = self.parse_or()
+            if self.stream.skip_if("name:else"):
+                expr3 = self.parse_condexpr()
+            else:
+                expr3 = None
+            expr1 = nodes.CondExpr(expr2, expr1, expr3, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return expr1
+
+    def parse_or(self) -> nodes.Expr:
+        lineno = self.stream.current.lineno
+        left = self.parse_and()
+        while self.stream.skip_if("name:or"):
+            right = self.parse_and()
+            left = nodes.Or(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_and(self) -> nodes.Expr:
+        lineno = self.stream.current.lineno
+        left = self.parse_not()
+        while self.stream.skip_if("name:and"):
+            right = self.parse_not()
+            left = nodes.And(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_not(self) -> nodes.Expr:
+        if self.stream.current.test("name:not"):
+            lineno = next(self.stream).lineno
+            return nodes.Not(self.parse_not(), lineno=lineno)
+        return self.parse_compare()
+
+    def parse_compare(self) -> nodes.Expr:
+        lineno = self.stream.current.lineno
+        expr = self.parse_math1()
+        ops = []
+        while True:
+            token_type = self.stream.current.type
+            if token_type in _compare_operators:
+                next(self.stream)
+                ops.append(nodes.Operand(token_type, self.parse_math1()))
+            elif self.stream.skip_if("name:in"):
+                ops.append(nodes.Operand("in", self.parse_math1()))
+            elif self.stream.current.test("name:not") and self.stream.look().test(
+                "name:in"
+            ):
+                self.stream.skip(2)
+                ops.append(nodes.Operand("notin", self.parse_math1()))
+            else:
+                break
+            lineno = self.stream.current.lineno
+        if not ops:
+            return expr
+        return nodes.Compare(expr, ops, lineno=lineno)
+
+    def parse_math1(self) -> nodes.Expr:
+        lineno = self.stream.current.lineno
+        left = self.parse_concat()
+        while self.stream.current.type in ("add", "sub"):
+            cls = _math_nodes[self.stream.current.type]
+            next(self.stream)
+            right = self.parse_concat()
+            left = cls(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_concat(self) -> nodes.Expr:
+        lineno = self.stream.current.lineno
+        args = [self.parse_math2()]
+        while self.stream.current.type == "tilde":
+            next(self.stream)
+            args.append(self.parse_math2())
+        if len(args) == 1:
+            return args[0]
+        return nodes.Concat(args, lineno=lineno)
+
+    def parse_math2(self) -> nodes.Expr:
+        lineno = self.stream.current.lineno
+        left = self.parse_pow()
+        while self.stream.current.type in ("mul", "div", "floordiv", "mod"):
+            cls = _math_nodes[self.stream.current.type]
+            next(self.stream)
+            right = self.parse_pow()
+            left = cls(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_pow(self) -> nodes.Expr:
+        lineno = self.stream.current.lineno
+        left = self.parse_unary()
+        while self.stream.current.type == "pow":
+            next(self.stream)
+            right = self.parse_unary()
+            left = nodes.Pow(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_unary(self, with_filter: bool = True) -> nodes.Expr:
+        token_type = self.stream.current.type
+        lineno = self.stream.current.lineno
+        node: nodes.Expr
+
+        if token_type == "sub":
+            next(self.stream)
+            node = nodes.Neg(self.parse_unary(False), lineno=lineno)
+        elif token_type == "add":
+            next(self.stream)
+            node = nodes.Pos(self.parse_unary(False), lineno=lineno)
+        else:
+            node = self.parse_primary()
+        node = self.parse_postfix(node)
+        if with_filter:
+            node = self.parse_filter_expr(node)
+        return node
+
+    def parse_primary(self) -> nodes.Expr:
+        token = self.stream.current
+        node: nodes.Expr
+        if token.type == "name":
+            if token.value in ("true", "false", "True", "False"):
+                node = nodes.Const(token.value in ("true", "True"), lineno=token.lineno)
+            elif token.value in ("none", "None"):
+                node = nodes.Const(None, lineno=token.lineno)
+            else:
+                node = nodes.Name(token.value, "load", lineno=token.lineno)
+            next(self.stream)
+        elif token.type == "string":
+            next(self.stream)
+            buf = [token.value]
+            lineno = token.lineno
+            while self.stream.current.type == "string":
+                buf.append(self.stream.current.value)
+                next(self.stream)
+            node = nodes.Const("".join(buf), lineno=lineno)
+        elif token.type in ("integer", "float"):
+            next(self.stream)
+            node = nodes.Const(token.value, lineno=token.lineno)
+        elif token.type == "lparen":
+            next(self.stream)
+            node = self.parse_tuple(explicit_parentheses=True)
+            self.stream.expect("rparen")
+        elif token.type == "lbracket":
+            node = self.parse_list()
+        elif token.type == "lbrace":
+            node = self.parse_dict()
+        else:
+            self.fail(f"unexpected {describe_token(token)!r}", token.lineno)
+        return node
+
+    def parse_tuple(
+        self,
+        simplified: bool = False,
+        with_condexpr: bool = True,
+        extra_end_rules: t.Optional[t.Tuple[str, ...]] = None,
+        explicit_parentheses: bool = False,
+    ) -> t.Union[nodes.Tuple, nodes.Expr]:
+        """Works like `parse_expression` but if multiple expressions are
+        delimited by a comma a :class:`~jinja2.nodes.Tuple` node is created.
+        This method could also return a regular expression instead of a tuple
+        if no commas where found.
+
+        The default parsing mode is a full tuple.  If `simplified` is `True`
+        only names and literals are parsed.  The `no_condexpr` parameter is
+        forwarded to :meth:`parse_expression`.
+
+        Because tuples do not require delimiters and may end in a bogus comma
+        an extra hint is needed that marks the end of a tuple.  For example
+        for loops support tuples between `for` and `in`.  In that case the
+        `extra_end_rules` is set to ``['name:in']``.
+
+        `explicit_parentheses` is true if the parsing was triggered by an
+        expression in parentheses.  This is used to figure out if an empty
+        tuple is a valid expression or not.
+        """
+        lineno = self.stream.current.lineno
+        if simplified:
+            parse = self.parse_primary
+        elif with_condexpr:
+            parse = self.parse_expression
+        else:
+
+            def parse() -> nodes.Expr:
+                return self.parse_expression(with_condexpr=False)
+
+        args: t.List[nodes.Expr] = []
+        is_tuple = False
+
+        while True:
+            if args:
+                self.stream.expect("comma")
+            if self.is_tuple_end(extra_end_rules):
+                break
+            args.append(parse())
+            if self.stream.current.type == "comma":
+                is_tuple = True
+            else:
+                break
+            lineno = self.stream.current.lineno
+
+        if not is_tuple:
+            if args:
+                return args[0]
+
+            # if we don't have explicit parentheses, an empty tuple is
+            # not a valid expression.  This would mean nothing (literally
+            # nothing) in the spot of an expression would be an empty
+            # tuple.
+            if not explicit_parentheses:
+                self.fail(
+                    "Expected an expression,"
+                    f" got {describe_token(self.stream.current)!r}"
+                )
+
+        return nodes.Tuple(args, "load", lineno=lineno)
+
+    def parse_list(self) -> nodes.List:
+        token = self.stream.expect("lbracket")
+        items: t.List[nodes.Expr] = []
+        while self.stream.current.type != "rbracket":
+            if items:
+                self.stream.expect("comma")
+            if self.stream.current.type == "rbracket":
+                break
+            items.append(self.parse_expression())
+        self.stream.expect("rbracket")
+        return nodes.List(items, lineno=token.lineno)
+
+    def parse_dict(self) -> nodes.Dict:
+        token = self.stream.expect("lbrace")
+        items: t.List[nodes.Pair] = []
+        while self.stream.current.type != "rbrace":
+            if items:
+                self.stream.expect("comma")
+            if self.stream.current.type == "rbrace":
+                break
+            key = self.parse_expression()
+            self.stream.expect("colon")
+            value = self.parse_expression()
+            items.append(nodes.Pair(key, value, lineno=key.lineno))
+        self.stream.expect("rbrace")
+        return nodes.Dict(items, lineno=token.lineno)
+
+    def parse_postfix(self, node: nodes.Expr) -> nodes.Expr:
+        while True:
+            token_type = self.stream.current.type
+            if token_type == "dot" or token_type == "lbracket":
+                node = self.parse_subscript(node)
+            # calls are valid both after postfix expressions (getattr
+            # and getitem) as well as filters and tests
+            elif token_type == "lparen":
+                node = self.parse_call(node)
+            else:
+                break
+        return node
+
+    def parse_filter_expr(self, node: nodes.Expr) -> nodes.Expr:
+        while True:
+            token_type = self.stream.current.type
+            if token_type == "pipe":
+                node = self.parse_filter(node)  # type: ignore
+            elif token_type == "name" and self.stream.current.value == "is":
+                node = self.parse_test(node)
+            # calls are valid both after postfix expressions (getattr
+            # and getitem) as well as filters and tests
+            elif token_type == "lparen":
+                node = self.parse_call(node)
+            else:
+                break
+        return node
+
+    def parse_subscript(
+        self, node: nodes.Expr
+    ) -> t.Union[nodes.Getattr, nodes.Getitem]:
+        token = next(self.stream)
+        arg: nodes.Expr
+
+        if token.type == "dot":
+            attr_token = self.stream.current
+            next(self.stream)
+            if attr_token.type == "name":
+                return nodes.Getattr(
+                    node, attr_token.value, "load", lineno=token.lineno
+                )
+            elif attr_token.type != "integer":
+                self.fail("expected name or number", attr_token.lineno)
+            arg = nodes.Const(attr_token.value, lineno=attr_token.lineno)
+            return nodes.Getitem(node, arg, "load", lineno=token.lineno)
+        if token.type == "lbracket":
+            args: t.List[nodes.Expr] = []
+            while self.stream.current.type != "rbracket":
+                if args:
+                    self.stream.expect("comma")
+                args.append(self.parse_subscribed())
+            self.stream.expect("rbracket")
+            if len(args) == 1:
+                arg = args[0]
+            else:
+                arg = nodes.Tuple(args, "load", lineno=token.lineno)
+            return nodes.Getitem(node, arg, "load", lineno=token.lineno)
+        self.fail("expected subscript expression", token.lineno)
+
+    def parse_subscribed(self) -> nodes.Expr:
+        lineno = self.stream.current.lineno
+        args: t.List[t.Optional[nodes.Expr]]
+
+        if self.stream.current.type == "colon":
+            next(self.stream)
+            args = [None]
+        else:
+            node = self.parse_expression()
+            if self.stream.current.type != "colon":
+                return node
+            next(self.stream)
+            args = [node]
+
+        if self.stream.current.type == "colon":
+            args.append(None)
+        elif self.stream.current.type not in ("rbracket", "comma"):
+            args.append(self.parse_expression())
+        else:
+            args.append(None)
+
+        if self.stream.current.type == "colon":
+            next(self.stream)
+            if self.stream.current.type not in ("rbracket", "comma"):
+                args.append(self.parse_expression())
+            else:
+                args.append(None)
+        else:
+            args.append(None)
+
+        return nodes.Slice(lineno=lineno, *args)  # noqa: B026
+
+    def parse_call_args(self) -> t.Tuple:
+        token = self.stream.expect("lparen")
+        args = []
+        kwargs = []
+        dyn_args = None
+        dyn_kwargs = None
+        require_comma = False
+
+        def ensure(expr: bool) -> None:
+            if not expr:
+                self.fail("invalid syntax for function call expression", token.lineno)
+
+        while self.stream.current.type != "rparen":
+            if require_comma:
+                self.stream.expect("comma")
+
+                # support for trailing comma
+                if self.stream.current.type == "rparen":
+                    break
+
+            if self.stream.current.type == "mul":
+                ensure(dyn_args is None and dyn_kwargs is None)
+                next(self.stream)
+                dyn_args = self.parse_expression()
+            elif self.stream.current.type == "pow":
+                ensure(dyn_kwargs is None)
+                next(self.stream)
+                dyn_kwargs = self.parse_expression()
+            else:
+                if (
+                    self.stream.current.type == "name"
+                    and self.stream.look().type == "assign"
+                ):
+                    # Parsing a kwarg
+                    ensure(dyn_kwargs is None)
+                    key = self.stream.current.value
+                    self.stream.skip(2)
+                    value = self.parse_expression()
+                    kwargs.append(nodes.Keyword(key, value, lineno=value.lineno))
+                else:
+                    # Parsing an arg
+                    ensure(dyn_args is None and dyn_kwargs is None and not kwargs)
+                    args.append(self.parse_expression())
+
+            require_comma = True
+
+        self.stream.expect("rparen")
+        return args, kwargs, dyn_args, dyn_kwargs
+
+    def parse_call(self, node: nodes.Expr) -> nodes.Call:
+        # The lparen will be expected in parse_call_args, but the lineno
+        # needs to be recorded before the stream is advanced.
+        token = self.stream.current
+        args, kwargs, dyn_args, dyn_kwargs = self.parse_call_args()
+        return nodes.Call(node, args, kwargs, dyn_args, dyn_kwargs, lineno=token.lineno)
+
+    def parse_filter(
+        self, node: t.Optional[nodes.Expr], start_inline: bool = False
+    ) -> t.Optional[nodes.Expr]:
+        while self.stream.current.type == "pipe" or start_inline:
+            if not start_inline:
+                next(self.stream)
+            token = self.stream.expect("name")
+            name = token.value
+            while self.stream.current.type == "dot":
+                next(self.stream)
+                name += "." + self.stream.expect("name").value
+            if self.stream.current.type == "lparen":
+                args, kwargs, dyn_args, dyn_kwargs = self.parse_call_args()
+            else:
+                args = []
+                kwargs = []
+                dyn_args = dyn_kwargs = None
+            node = nodes.Filter(
+                node, name, args, kwargs, dyn_args, dyn_kwargs, lineno=token.lineno
+            )
+            start_inline = False
+        return node
+
+    def parse_test(self, node: nodes.Expr) -> nodes.Expr:
+        token = next(self.stream)
+        if self.stream.current.test("name:not"):
+            next(self.stream)
+            negated = True
+        else:
+            negated = False
+        name = self.stream.expect("name").value
+        while self.stream.current.type == "dot":
+            next(self.stream)
+            name += "." + self.stream.expect("name").value
+        dyn_args = dyn_kwargs = None
+        kwargs = []
+        if self.stream.current.type == "lparen":
+            args, kwargs, dyn_args, dyn_kwargs = self.parse_call_args()
+        elif self.stream.current.type in {
+            "name",
+            "string",
+            "integer",
+            "float",
+            "lparen",
+            "lbracket",
+            "lbrace",
+        } and not self.stream.current.test_any("name:else", "name:or", "name:and"):
+            if self.stream.current.test("name:is"):
+                self.fail("You cannot chain multiple tests with is")
+            arg_node = self.parse_primary()
+            arg_node = self.parse_postfix(arg_node)
+            args = [arg_node]
+        else:
+            args = []
+        node = nodes.Test(
+            node, name, args, kwargs, dyn_args, dyn_kwargs, lineno=token.lineno
+        )
+        if negated:
+            node = nodes.Not(node, lineno=token.lineno)
+        return node
+
+    def subparse(
+        self, end_tokens: t.Optional[t.Tuple[str, ...]] = None
+    ) -> t.List[nodes.Node]:
+        body: t.List[nodes.Node] = []
+        data_buffer: t.List[nodes.Node] = []
+        add_data = data_buffer.append
+
+        if end_tokens is not None:
+            self._end_token_stack.append(end_tokens)
+
+        def flush_data() -> None:
+            if data_buffer:
+                lineno = data_buffer[0].lineno
+                body.append(nodes.Output(data_buffer[:], lineno=lineno))
+                del data_buffer[:]
+
+        try:
+            while self.stream:
+                token = self.stream.current
+                if token.type == "data":
+                    if token.value:
+                        add_data(nodes.TemplateData(token.value, lineno=token.lineno))
+                    next(self.stream)
+                elif token.type == "variable_begin":
+                    next(self.stream)
+                    add_data(self.parse_tuple(with_condexpr=True))
+                    self.stream.expect("variable_end")
+                elif token.type == "block_begin":
+                    flush_data()
+                    next(self.stream)
+                    if end_tokens is not None and self.stream.current.test_any(
+                        *end_tokens
+                    ):
+                        return body
+                    rv = self.parse_statement()
+                    if isinstance(rv, list):
+                        body.extend(rv)
+                    else:
+                        body.append(rv)
+                    self.stream.expect("block_end")
+                else:
+                    raise AssertionError("internal parsing error")
+
+            flush_data()
+        finally:
+            if end_tokens is not None:
+                self._end_token_stack.pop()
+        return body
+
+    def parse(self) -> nodes.Template:
+        """Parse the whole template into a `Template` node."""
+        result = nodes.Template(self.subparse(), lineno=1)
+        result.set_environment(self.environment)
+        return result
diff --git a/llm/Lib/site-packages/jinja2/py.typed b/llm/Lib/site-packages/jinja2/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/jinja2/runtime.py b/llm/Lib/site-packages/jinja2/runtime.py
new file mode 100644
index 0000000000000000000000000000000000000000..58a540ba3f4486790ab268d6eb8ecbd15c2837c1
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/runtime.py
@@ -0,0 +1,1051 @@
+"""The runtime functions and state used by compiled templates."""
+import functools
+import sys
+import typing as t
+from collections import abc
+from itertools import chain
+
+from markupsafe import escape  # noqa: F401
+from markupsafe import Markup
+from markupsafe import soft_str
+
+from .async_utils import auto_aiter
+from .async_utils import auto_await  # noqa: F401
+from .exceptions import TemplateNotFound  # noqa: F401
+from .exceptions import TemplateRuntimeError  # noqa: F401
+from .exceptions import UndefinedError
+from .nodes import EvalContext
+from .utils import _PassArg
+from .utils import concat
+from .utils import internalcode
+from .utils import missing
+from .utils import Namespace  # noqa: F401
+from .utils import object_type_repr
+from .utils import pass_eval_context
+
+V = t.TypeVar("V")
+F = t.TypeVar("F", bound=t.Callable[..., t.Any])
+
+if t.TYPE_CHECKING:
+    import logging
+    import typing_extensions as te
+    from .environment import Environment
+
+    class LoopRenderFunc(te.Protocol):
+        def __call__(
+            self,
+            reciter: t.Iterable[V],
+            loop_render_func: "LoopRenderFunc",
+            depth: int = 0,
+        ) -> str:
+            ...
+
+
+# these variables are exported to the template runtime
+exported = [
+    "LoopContext",
+    "TemplateReference",
+    "Macro",
+    "Markup",
+    "TemplateRuntimeError",
+    "missing",
+    "escape",
+    "markup_join",
+    "str_join",
+    "identity",
+    "TemplateNotFound",
+    "Namespace",
+    "Undefined",
+    "internalcode",
+]
+async_exported = [
+    "AsyncLoopContext",
+    "auto_aiter",
+    "auto_await",
+]
+
+
+def identity(x: V) -> V:
+    """Returns its argument. Useful for certain things in the
+    environment.
+    """
+    return x
+
+
+def markup_join(seq: t.Iterable[t.Any]) -> str:
+    """Concatenation that escapes if necessary and converts to string."""
+    buf = []
+    iterator = map(soft_str, seq)
+    for arg in iterator:
+        buf.append(arg)
+        if hasattr(arg, "__html__"):
+            return Markup("").join(chain(buf, iterator))
+    return concat(buf)
+
+
+def str_join(seq: t.Iterable[t.Any]) -> str:
+    """Simple args to string conversion and concatenation."""
+    return concat(map(str, seq))
+
+
+def new_context(
+    environment: "Environment",
+    template_name: t.Optional[str],
+    blocks: t.Dict[str, t.Callable[["Context"], t.Iterator[str]]],
+    vars: t.Optional[t.Dict[str, t.Any]] = None,
+    shared: bool = False,
+    globals: t.Optional[t.MutableMapping[str, t.Any]] = None,
+    locals: t.Optional[t.Mapping[str, t.Any]] = None,
+) -> "Context":
+    """Internal helper for context creation."""
+    if vars is None:
+        vars = {}
+    if shared:
+        parent = vars
+    else:
+        parent = dict(globals or (), **vars)
+    if locals:
+        # if the parent is shared a copy should be created because
+        # we don't want to modify the dict passed
+        if shared:
+            parent = dict(parent)
+        for key, value in locals.items():
+            if value is not missing:
+                parent[key] = value
+    return environment.context_class(
+        environment, parent, template_name, blocks, globals=globals
+    )
+
+
+class TemplateReference:
+    """The `self` in templates."""
+
+    def __init__(self, context: "Context") -> None:
+        self.__context = context
+
+    def __getitem__(self, name: str) -> t.Any:
+        blocks = self.__context.blocks[name]
+        return BlockReference(name, self.__context, blocks, 0)
+
+    def __repr__(self) -> str:
+        return f"<{type(self).__name__} {self.__context.name!r}>"
+
+
+def _dict_method_all(dict_method: F) -> F:
+    @functools.wraps(dict_method)
+    def f_all(self: "Context") -> t.Any:
+        return dict_method(self.get_all())
+
+    return t.cast(F, f_all)
+
+
+@abc.Mapping.register
+class Context:
+    """The template context holds the variables of a template.  It stores the
+    values passed to the template and also the names the template exports.
+    Creating instances is neither supported nor useful as it's created
+    automatically at various stages of the template evaluation and should not
+    be created by hand.
+
+    The context is immutable.  Modifications on :attr:`parent` **must not**
+    happen and modifications on :attr:`vars` are allowed from generated
+    template code only.  Template filters and global functions marked as
+    :func:`pass_context` get the active context passed as first argument
+    and are allowed to access the context read-only.
+
+    The template context supports read only dict operations (`get`,
+    `keys`, `values`, `items`, `iterkeys`, `itervalues`, `iteritems`,
+    `__getitem__`, `__contains__`).  Additionally there is a :meth:`resolve`
+    method that doesn't fail with a `KeyError` but returns an
+    :class:`Undefined` object for missing variables.
+    """
+
+    def __init__(
+        self,
+        environment: "Environment",
+        parent: t.Dict[str, t.Any],
+        name: t.Optional[str],
+        blocks: t.Dict[str, t.Callable[["Context"], t.Iterator[str]]],
+        globals: t.Optional[t.MutableMapping[str, t.Any]] = None,
+    ):
+        self.parent = parent
+        self.vars: t.Dict[str, t.Any] = {}
+        self.environment: "Environment" = environment
+        self.eval_ctx = EvalContext(self.environment, name)
+        self.exported_vars: t.Set[str] = set()
+        self.name = name
+        self.globals_keys = set() if globals is None else set(globals)
+
+        # create the initial mapping of blocks.  Whenever template inheritance
+        # takes place the runtime will update this mapping with the new blocks
+        # from the template.
+        self.blocks = {k: [v] for k, v in blocks.items()}
+
+    def super(
+        self, name: str, current: t.Callable[["Context"], t.Iterator[str]]
+    ) -> t.Union["BlockReference", "Undefined"]:
+        """Render a parent block."""
+        try:
+            blocks = self.blocks[name]
+            index = blocks.index(current) + 1
+            blocks[index]
+        except LookupError:
+            return self.environment.undefined(
+                f"there is no parent block called {name!r}.", name="super"
+            )
+        return BlockReference(name, self, blocks, index)
+
+    def get(self, key: str, default: t.Any = None) -> t.Any:
+        """Look up a variable by name, or return a default if the key is
+        not found.
+
+        :param key: The variable name to look up.
+        :param default: The value to return if the key is not found.
+        """
+        try:
+            return self[key]
+        except KeyError:
+            return default
+
+    def resolve(self, key: str) -> t.Union[t.Any, "Undefined"]:
+        """Look up a variable by name, or return an :class:`Undefined`
+        object if the key is not found.
+
+        If you need to add custom behavior, override
+        :meth:`resolve_or_missing`, not this method. The various lookup
+        functions use that method, not this one.
+
+        :param key: The variable name to look up.
+        """
+        rv = self.resolve_or_missing(key)
+
+        if rv is missing:
+            return self.environment.undefined(name=key)
+
+        return rv
+
+    def resolve_or_missing(self, key: str) -> t.Any:
+        """Look up a variable by name, or return a ``missing`` sentinel
+        if the key is not found.
+
+        Override this method to add custom lookup behavior.
+        :meth:`resolve`, :meth:`get`, and :meth:`__getitem__` use this
+        method. Don't call this method directly.
+
+        :param key: The variable name to look up.
+        """
+        if key in self.vars:
+            return self.vars[key]
+
+        if key in self.parent:
+            return self.parent[key]
+
+        return missing
+
+    def get_exported(self) -> t.Dict[str, t.Any]:
+        """Get a new dict with the exported variables."""
+        return {k: self.vars[k] for k in self.exported_vars}
+
+    def get_all(self) -> t.Dict[str, t.Any]:
+        """Return the complete context as dict including the exported
+        variables.  For optimizations reasons this might not return an
+        actual copy so be careful with using it.
+        """
+        if not self.vars:
+            return self.parent
+        if not self.parent:
+            return self.vars
+        return dict(self.parent, **self.vars)
+
+    @internalcode
+    def call(
+        __self, __obj: t.Callable, *args: t.Any, **kwargs: t.Any  # noqa: B902
+    ) -> t.Union[t.Any, "Undefined"]:
+        """Call the callable with the arguments and keyword arguments
+        provided but inject the active context or environment as first
+        argument if the callable has :func:`pass_context` or
+        :func:`pass_environment`.
+        """
+        if __debug__:
+            __traceback_hide__ = True  # noqa
+
+        # Allow callable classes to take a context
+        if (
+            hasattr(__obj, "__call__")  # noqa: B004
+            and _PassArg.from_obj(__obj.__call__) is not None
+        ):
+            __obj = __obj.__call__
+
+        pass_arg = _PassArg.from_obj(__obj)
+
+        if pass_arg is _PassArg.context:
+            # the active context should have access to variables set in
+            # loops and blocks without mutating the context itself
+            if kwargs.get("_loop_vars"):
+                __self = __self.derived(kwargs["_loop_vars"])
+            if kwargs.get("_block_vars"):
+                __self = __self.derived(kwargs["_block_vars"])
+            args = (__self,) + args
+        elif pass_arg is _PassArg.eval_context:
+            args = (__self.eval_ctx,) + args
+        elif pass_arg is _PassArg.environment:
+            args = (__self.environment,) + args
+
+        kwargs.pop("_block_vars", None)
+        kwargs.pop("_loop_vars", None)
+
+        try:
+            return __obj(*args, **kwargs)
+        except StopIteration:
+            return __self.environment.undefined(
+                "value was undefined because a callable raised a"
+                " StopIteration exception"
+            )
+
+    def derived(self, locals: t.Optional[t.Dict[str, t.Any]] = None) -> "Context":
+        """Internal helper function to create a derived context.  This is
+        used in situations where the system needs a new context in the same
+        template that is independent.
+        """
+        context = new_context(
+            self.environment, self.name, {}, self.get_all(), True, None, locals
+        )
+        context.eval_ctx = self.eval_ctx
+        context.blocks.update((k, list(v)) for k, v in self.blocks.items())
+        return context
+
+    keys = _dict_method_all(dict.keys)
+    values = _dict_method_all(dict.values)
+    items = _dict_method_all(dict.items)
+
+    def __contains__(self, name: str) -> bool:
+        return name in self.vars or name in self.parent
+
+    def __getitem__(self, key: str) -> t.Any:
+        """Look up a variable by name with ``[]`` syntax, or raise a
+        ``KeyError`` if the key is not found.
+        """
+        item = self.resolve_or_missing(key)
+
+        if item is missing:
+            raise KeyError(key)
+
+        return item
+
+    def __repr__(self) -> str:
+        return f"<{type(self).__name__} {self.get_all()!r} of {self.name!r}>"
+
+
+class BlockReference:
+    """One block on a template reference."""
+
+    def __init__(
+        self,
+        name: str,
+        context: "Context",
+        stack: t.List[t.Callable[["Context"], t.Iterator[str]]],
+        depth: int,
+    ) -> None:
+        self.name = name
+        self._context = context
+        self._stack = stack
+        self._depth = depth
+
+    @property
+    def super(self) -> t.Union["BlockReference", "Undefined"]:
+        """Super the block."""
+        if self._depth + 1 >= len(self._stack):
+            return self._context.environment.undefined(
+                f"there is no parent block called {self.name!r}.", name="super"
+            )
+        return BlockReference(self.name, self._context, self._stack, self._depth + 1)
+
+    @internalcode
+    async def _async_call(self) -> str:
+        rv = concat(
+            [x async for x in self._stack[self._depth](self._context)]  # type: ignore
+        )
+
+        if self._context.eval_ctx.autoescape:
+            return Markup(rv)
+
+        return rv
+
+    @internalcode
+    def __call__(self) -> str:
+        if self._context.environment.is_async:
+            return self._async_call()  # type: ignore
+
+        rv = concat(self._stack[self._depth](self._context))
+
+        if self._context.eval_ctx.autoescape:
+            return Markup(rv)
+
+        return rv
+
+
+class LoopContext:
+    """A wrapper iterable for dynamic ``for`` loops, with information
+    about the loop and iteration.
+    """
+
+    #: Current iteration of the loop, starting at 0.
+    index0 = -1
+
+    _length: t.Optional[int] = None
+    _after: t.Any = missing
+    _current: t.Any = missing
+    _before: t.Any = missing
+    _last_changed_value: t.Any = missing
+
+    def __init__(
+        self,
+        iterable: t.Iterable[V],
+        undefined: t.Type["Undefined"],
+        recurse: t.Optional["LoopRenderFunc"] = None,
+        depth0: int = 0,
+    ) -> None:
+        """
+        :param iterable: Iterable to wrap.
+        :param undefined: :class:`Undefined` class to use for next and
+            previous items.
+        :param recurse: The function to render the loop body when the
+            loop is marked recursive.
+        :param depth0: Incremented when looping recursively.
+        """
+        self._iterable = iterable
+        self._iterator = self._to_iterator(iterable)
+        self._undefined = undefined
+        self._recurse = recurse
+        #: How many levels deep a recursive loop currently is, starting at 0.
+        self.depth0 = depth0
+
+    @staticmethod
+    def _to_iterator(iterable: t.Iterable[V]) -> t.Iterator[V]:
+        return iter(iterable)
+
+    @property
+    def length(self) -> int:
+        """Length of the iterable.
+
+        If the iterable is a generator or otherwise does not have a
+        size, it is eagerly evaluated to get a size.
+        """
+        if self._length is not None:
+            return self._length
+
+        try:
+            self._length = len(self._iterable)  # type: ignore
+        except TypeError:
+            iterable = list(self._iterator)
+            self._iterator = self._to_iterator(iterable)
+            self._length = len(iterable) + self.index + (self._after is not missing)
+
+        return self._length
+
+    def __len__(self) -> int:
+        return self.length
+
+    @property
+    def depth(self) -> int:
+        """How many levels deep a recursive loop currently is, starting at 1."""
+        return self.depth0 + 1
+
+    @property
+    def index(self) -> int:
+        """Current iteration of the loop, starting at 1."""
+        return self.index0 + 1
+
+    @property
+    def revindex0(self) -> int:
+        """Number of iterations from the end of the loop, ending at 0.
+
+        Requires calculating :attr:`length`.
+        """
+        return self.length - self.index
+
+    @property
+    def revindex(self) -> int:
+        """Number of iterations from the end of the loop, ending at 1.
+
+        Requires calculating :attr:`length`.
+        """
+        return self.length - self.index0
+
+    @property
+    def first(self) -> bool:
+        """Whether this is the first iteration of the loop."""
+        return self.index0 == 0
+
+    def _peek_next(self) -> t.Any:
+        """Return the next element in the iterable, or :data:`missing`
+        if the iterable is exhausted. Only peeks one item ahead, caching
+        the result in :attr:`_last` for use in subsequent checks. The
+        cache is reset when :meth:`__next__` is called.
+        """
+        if self._after is not missing:
+            return self._after
+
+        self._after = next(self._iterator, missing)
+        return self._after
+
+    @property
+    def last(self) -> bool:
+        """Whether this is the last iteration of the loop.
+
+        Causes the iterable to advance early. See
+        :func:`itertools.groupby` for issues this can cause.
+        The :func:`groupby` filter avoids that issue.
+        """
+        return self._peek_next() is missing
+
+    @property
+    def previtem(self) -> t.Union[t.Any, "Undefined"]:
+        """The item in the previous iteration. Undefined during the
+        first iteration.
+        """
+        if self.first:
+            return self._undefined("there is no previous item")
+
+        return self._before
+
+    @property
+    def nextitem(self) -> t.Union[t.Any, "Undefined"]:
+        """The item in the next iteration. Undefined during the last
+        iteration.
+
+        Causes the iterable to advance early. See
+        :func:`itertools.groupby` for issues this can cause.
+        The :func:`jinja-filters.groupby` filter avoids that issue.
+        """
+        rv = self._peek_next()
+
+        if rv is missing:
+            return self._undefined("there is no next item")
+
+        return rv
+
+    def cycle(self, *args: V) -> V:
+        """Return a value from the given args, cycling through based on
+        the current :attr:`index0`.
+
+        :param args: One or more values to cycle through.
+        """
+        if not args:
+            raise TypeError("no items for cycling given")
+
+        return args[self.index0 % len(args)]
+
+    def changed(self, *value: t.Any) -> bool:
+        """Return ``True`` if previously called with a different value
+        (including when called for the first time).
+
+        :param value: One or more values to compare to the last call.
+        """
+        if self._last_changed_value != value:
+            self._last_changed_value = value
+            return True
+
+        return False
+
+    def __iter__(self) -> "LoopContext":
+        return self
+
+    def __next__(self) -> t.Tuple[t.Any, "LoopContext"]:
+        if self._after is not missing:
+            rv = self._after
+            self._after = missing
+        else:
+            rv = next(self._iterator)
+
+        self.index0 += 1
+        self._before = self._current
+        self._current = rv
+        return rv, self
+
+    @internalcode
+    def __call__(self, iterable: t.Iterable[V]) -> str:
+        """When iterating over nested data, render the body of the loop
+        recursively with the given inner iterable data.
+
+        The loop must have the ``recursive`` marker for this to work.
+        """
+        if self._recurse is None:
+            raise TypeError(
+                "The loop must have the 'recursive' marker to be called recursively."
+            )
+
+        return self._recurse(iterable, self._recurse, depth=self.depth)
+
+    def __repr__(self) -> str:
+        return f"<{type(self).__name__} {self.index}/{self.length}>"
+
+
+class AsyncLoopContext(LoopContext):
+    _iterator: t.AsyncIterator[t.Any]  # type: ignore
+
+    @staticmethod
+    def _to_iterator(  # type: ignore
+        iterable: t.Union[t.Iterable[V], t.AsyncIterable[V]]
+    ) -> t.AsyncIterator[V]:
+        return auto_aiter(iterable)
+
+    @property
+    async def length(self) -> int:  # type: ignore
+        if self._length is not None:
+            return self._length
+
+        try:
+            self._length = len(self._iterable)  # type: ignore
+        except TypeError:
+            iterable = [x async for x in self._iterator]
+            self._iterator = self._to_iterator(iterable)
+            self._length = len(iterable) + self.index + (self._after is not missing)
+
+        return self._length
+
+    @property
+    async def revindex0(self) -> int:  # type: ignore
+        return await self.length - self.index
+
+    @property
+    async def revindex(self) -> int:  # type: ignore
+        return await self.length - self.index0
+
+    async def _peek_next(self) -> t.Any:
+        if self._after is not missing:
+            return self._after
+
+        try:
+            self._after = await self._iterator.__anext__()
+        except StopAsyncIteration:
+            self._after = missing
+
+        return self._after
+
+    @property
+    async def last(self) -> bool:  # type: ignore
+        return await self._peek_next() is missing
+
+    @property
+    async def nextitem(self) -> t.Union[t.Any, "Undefined"]:
+        rv = await self._peek_next()
+
+        if rv is missing:
+            return self._undefined("there is no next item")
+
+        return rv
+
+    def __aiter__(self) -> "AsyncLoopContext":
+        return self
+
+    async def __anext__(self) -> t.Tuple[t.Any, "AsyncLoopContext"]:
+        if self._after is not missing:
+            rv = self._after
+            self._after = missing
+        else:
+            rv = await self._iterator.__anext__()
+
+        self.index0 += 1
+        self._before = self._current
+        self._current = rv
+        return rv, self
+
+
+class Macro:
+    """Wraps a macro function."""
+
+    def __init__(
+        self,
+        environment: "Environment",
+        func: t.Callable[..., str],
+        name: str,
+        arguments: t.List[str],
+        catch_kwargs: bool,
+        catch_varargs: bool,
+        caller: bool,
+        default_autoescape: t.Optional[bool] = None,
+    ):
+        self._environment = environment
+        self._func = func
+        self._argument_count = len(arguments)
+        self.name = name
+        self.arguments = arguments
+        self.catch_kwargs = catch_kwargs
+        self.catch_varargs = catch_varargs
+        self.caller = caller
+        self.explicit_caller = "caller" in arguments
+
+        if default_autoescape is None:
+            if callable(environment.autoescape):
+                default_autoescape = environment.autoescape(None)
+            else:
+                default_autoescape = environment.autoescape
+
+        self._default_autoescape = default_autoescape
+
+    @internalcode
+    @pass_eval_context
+    def __call__(self, *args: t.Any, **kwargs: t.Any) -> str:
+        # This requires a bit of explanation,  In the past we used to
+        # decide largely based on compile-time information if a macro is
+        # safe or unsafe.  While there was a volatile mode it was largely
+        # unused for deciding on escaping.  This turns out to be
+        # problematic for macros because whether a macro is safe depends not
+        # on the escape mode when it was defined, but rather when it was used.
+        #
+        # Because however we export macros from the module system and
+        # there are historic callers that do not pass an eval context (and
+        # will continue to not pass one), we need to perform an instance
+        # check here.
+        #
+        # This is considered safe because an eval context is not a valid
+        # argument to callables otherwise anyway.  Worst case here is
+        # that if no eval context is passed we fall back to the compile
+        # time autoescape flag.
+        if args and isinstance(args[0], EvalContext):
+            autoescape = args[0].autoescape
+            args = args[1:]
+        else:
+            autoescape = self._default_autoescape
+
+        # try to consume the positional arguments
+        arguments = list(args[: self._argument_count])
+        off = len(arguments)
+
+        # For information why this is necessary refer to the handling
+        # of caller in the `macro_body` handler in the compiler.
+        found_caller = False
+
+        # if the number of arguments consumed is not the number of
+        # arguments expected we start filling in keyword arguments
+        # and defaults.
+        if off != self._argument_count:
+            for name in self.arguments[len(arguments) :]:
+                try:
+                    value = kwargs.pop(name)
+                except KeyError:
+                    value = missing
+                if name == "caller":
+                    found_caller = True
+                arguments.append(value)
+        else:
+            found_caller = self.explicit_caller
+
+        # it's important that the order of these arguments does not change
+        # if not also changed in the compiler's `function_scoping` method.
+        # the order is caller, keyword arguments, positional arguments!
+        if self.caller and not found_caller:
+            caller = kwargs.pop("caller", None)
+            if caller is None:
+                caller = self._environment.undefined("No caller defined", name="caller")
+            arguments.append(caller)
+
+        if self.catch_kwargs:
+            arguments.append(kwargs)
+        elif kwargs:
+            if "caller" in kwargs:
+                raise TypeError(
+                    f"macro {self.name!r} was invoked with two values for the special"
+                    " caller argument. This is most likely a bug."
+                )
+            raise TypeError(
+                f"macro {self.name!r} takes no keyword argument {next(iter(kwargs))!r}"
+            )
+        if self.catch_varargs:
+            arguments.append(args[self._argument_count :])
+        elif len(args) > self._argument_count:
+            raise TypeError(
+                f"macro {self.name!r} takes not more than"
+                f" {len(self.arguments)} argument(s)"
+            )
+
+        return self._invoke(arguments, autoescape)
+
+    async def _async_invoke(self, arguments: t.List[t.Any], autoescape: bool) -> str:
+        rv = await self._func(*arguments)  # type: ignore
+
+        if autoescape:
+            return Markup(rv)
+
+        return rv  # type: ignore
+
+    def _invoke(self, arguments: t.List[t.Any], autoescape: bool) -> str:
+        if self._environment.is_async:
+            return self._async_invoke(arguments, autoescape)  # type: ignore
+
+        rv = self._func(*arguments)
+
+        if autoescape:
+            rv = Markup(rv)
+
+        return rv
+
+    def __repr__(self) -> str:
+        name = "anonymous" if self.name is None else repr(self.name)
+        return f"<{type(self).__name__} {name}>"
+
+
+class Undefined:
+    """The default undefined type.  This undefined type can be printed and
+    iterated over, but every other access will raise an :exc:`UndefinedError`:
+
+    >>> foo = Undefined(name='foo')
+    >>> str(foo)
+    ''
+    >>> not foo
+    True
+    >>> foo + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    """
+
+    __slots__ = (
+        "_undefined_hint",
+        "_undefined_obj",
+        "_undefined_name",
+        "_undefined_exception",
+    )
+
+    def __init__(
+        self,
+        hint: t.Optional[str] = None,
+        obj: t.Any = missing,
+        name: t.Optional[str] = None,
+        exc: t.Type[TemplateRuntimeError] = UndefinedError,
+    ) -> None:
+        self._undefined_hint = hint
+        self._undefined_obj = obj
+        self._undefined_name = name
+        self._undefined_exception = exc
+
+    @property
+    def _undefined_message(self) -> str:
+        """Build a message about the undefined value based on how it was
+        accessed.
+        """
+        if self._undefined_hint:
+            return self._undefined_hint
+
+        if self._undefined_obj is missing:
+            return f"{self._undefined_name!r} is undefined"
+
+        if not isinstance(self._undefined_name, str):
+            return (
+                f"{object_type_repr(self._undefined_obj)} has no"
+                f" element {self._undefined_name!r}"
+            )
+
+        return (
+            f"{object_type_repr(self._undefined_obj)!r} has no"
+            f" attribute {self._undefined_name!r}"
+        )
+
+    @internalcode
+    def _fail_with_undefined_error(
+        self, *args: t.Any, **kwargs: t.Any
+    ) -> "te.NoReturn":
+        """Raise an :exc:`UndefinedError` when operations are performed
+        on the undefined value.
+        """
+        raise self._undefined_exception(self._undefined_message)
+
+    @internalcode
+    def __getattr__(self, name: str) -> t.Any:
+        if name[:2] == "__":
+            raise AttributeError(name)
+
+        return self._fail_with_undefined_error()
+
+    __add__ = __radd__ = __sub__ = __rsub__ = _fail_with_undefined_error
+    __mul__ = __rmul__ = __div__ = __rdiv__ = _fail_with_undefined_error
+    __truediv__ = __rtruediv__ = _fail_with_undefined_error
+    __floordiv__ = __rfloordiv__ = _fail_with_undefined_error
+    __mod__ = __rmod__ = _fail_with_undefined_error
+    __pos__ = __neg__ = _fail_with_undefined_error
+    __call__ = __getitem__ = _fail_with_undefined_error
+    __lt__ = __le__ = __gt__ = __ge__ = _fail_with_undefined_error
+    __int__ = __float__ = __complex__ = _fail_with_undefined_error
+    __pow__ = __rpow__ = _fail_with_undefined_error
+
+    def __eq__(self, other: t.Any) -> bool:
+        return type(self) is type(other)
+
+    def __ne__(self, other: t.Any) -> bool:
+        return not self.__eq__(other)
+
+    def __hash__(self) -> int:
+        return id(type(self))
+
+    def __str__(self) -> str:
+        return ""
+
+    def __len__(self) -> int:
+        return 0
+
+    def __iter__(self) -> t.Iterator[t.Any]:
+        yield from ()
+
+    async def __aiter__(self) -> t.AsyncIterator[t.Any]:
+        for _ in ():
+            yield
+
+    def __bool__(self) -> bool:
+        return False
+
+    def __repr__(self) -> str:
+        return "Undefined"
+
+
+def make_logging_undefined(
+    logger: t.Optional["logging.Logger"] = None, base: t.Type[Undefined] = Undefined
+) -> t.Type[Undefined]:
+    """Given a logger object this returns a new undefined class that will
+    log certain failures.  It will log iterations and printing.  If no
+    logger is given a default logger is created.
+
+    Example::
+
+        logger = logging.getLogger(__name__)
+        LoggingUndefined = make_logging_undefined(
+            logger=logger,
+            base=Undefined
+        )
+
+    .. versionadded:: 2.8
+
+    :param logger: the logger to use.  If not provided, a default logger
+                   is created.
+    :param base: the base class to add logging functionality to.  This
+                 defaults to :class:`Undefined`.
+    """
+    if logger is None:
+        import logging
+
+        logger = logging.getLogger(__name__)
+        logger.addHandler(logging.StreamHandler(sys.stderr))
+
+    def _log_message(undef: Undefined) -> None:
+        logger.warning("Template variable warning: %s", undef._undefined_message)
+
+    class LoggingUndefined(base):  # type: ignore
+        __slots__ = ()
+
+        def _fail_with_undefined_error(  # type: ignore
+            self, *args: t.Any, **kwargs: t.Any
+        ) -> "te.NoReturn":
+            try:
+                super()._fail_with_undefined_error(*args, **kwargs)
+            except self._undefined_exception as e:
+                logger.error("Template variable error: %s", e)  # type: ignore
+                raise e
+
+        def __str__(self) -> str:
+            _log_message(self)
+            return super().__str__()  # type: ignore
+
+        def __iter__(self) -> t.Iterator[t.Any]:
+            _log_message(self)
+            return super().__iter__()  # type: ignore
+
+        def __bool__(self) -> bool:
+            _log_message(self)
+            return super().__bool__()  # type: ignore
+
+    return LoggingUndefined
+
+
+class ChainableUndefined(Undefined):
+    """An undefined that is chainable, where both ``__getattr__`` and
+    ``__getitem__`` return itself rather than raising an
+    :exc:`UndefinedError`.
+
+    >>> foo = ChainableUndefined(name='foo')
+    >>> str(foo.bar['baz'])
+    ''
+    >>> foo.bar['baz'] + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+
+    .. versionadded:: 2.11.0
+    """
+
+    __slots__ = ()
+
+    def __html__(self) -> str:
+        return str(self)
+
+    def __getattr__(self, _: str) -> "ChainableUndefined":
+        return self
+
+    __getitem__ = __getattr__  # type: ignore
+
+
+class DebugUndefined(Undefined):
+    """An undefined that returns the debug info when printed.
+
+    >>> foo = DebugUndefined(name='foo')
+    >>> str(foo)
+    '{{ foo }}'
+    >>> not foo
+    True
+    >>> foo + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    """
+
+    __slots__ = ()
+
+    def __str__(self) -> str:
+        if self._undefined_hint:
+            message = f"undefined value printed: {self._undefined_hint}"
+
+        elif self._undefined_obj is missing:
+            message = self._undefined_name  # type: ignore
+
+        else:
+            message = (
+                f"no such element: {object_type_repr(self._undefined_obj)}"
+                f"[{self._undefined_name!r}]"
+            )
+
+        return f"{{{{ {message} }}}}"
+
+
+class StrictUndefined(Undefined):
+    """An undefined that barks on print and iteration as well as boolean
+    tests and all kinds of comparisons.  In other words: you can do nothing
+    with it except checking if it's defined using the `defined` test.
+
+    >>> foo = StrictUndefined(name='foo')
+    >>> str(foo)
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    >>> not foo
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    >>> foo + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    """
+
+    __slots__ = ()
+    __iter__ = __str__ = __len__ = Undefined._fail_with_undefined_error
+    __eq__ = __ne__ = __bool__ = __hash__ = Undefined._fail_with_undefined_error
+    __contains__ = Undefined._fail_with_undefined_error
+
+
+# Remove slots attributes, after the metaclass is applied they are
+# unneeded and contain wrong data for subclasses.
+del (
+    Undefined.__slots__,
+    ChainableUndefined.__slots__,
+    DebugUndefined.__slots__,
+    StrictUndefined.__slots__,
+)
diff --git a/llm/Lib/site-packages/jinja2/sandbox.py b/llm/Lib/site-packages/jinja2/sandbox.py
new file mode 100644
index 0000000000000000000000000000000000000000..06d74148eccea79d1f5a0ca2fb76ecc246f87d62
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/sandbox.py
@@ -0,0 +1,428 @@
+"""A sandbox layer that ensures unsafe operations cannot be performed.
+Useful when the template itself comes from an untrusted source.
+"""
+import operator
+import types
+import typing as t
+from _string import formatter_field_name_split  # type: ignore
+from collections import abc
+from collections import deque
+from string import Formatter
+
+from markupsafe import EscapeFormatter
+from markupsafe import Markup
+
+from .environment import Environment
+from .exceptions import SecurityError
+from .runtime import Context
+from .runtime import Undefined
+
+F = t.TypeVar("F", bound=t.Callable[..., t.Any])
+
+#: maximum number of items a range may produce
+MAX_RANGE = 100000
+
+#: Unsafe function attributes.
+UNSAFE_FUNCTION_ATTRIBUTES: t.Set[str] = set()
+
+#: Unsafe method attributes. Function attributes are unsafe for methods too.
+UNSAFE_METHOD_ATTRIBUTES: t.Set[str] = set()
+
+#: unsafe generator attributes.
+UNSAFE_GENERATOR_ATTRIBUTES = {"gi_frame", "gi_code"}
+
+#: unsafe attributes on coroutines
+UNSAFE_COROUTINE_ATTRIBUTES = {"cr_frame", "cr_code"}
+
+#: unsafe attributes on async generators
+UNSAFE_ASYNC_GENERATOR_ATTRIBUTES = {"ag_code", "ag_frame"}
+
+_mutable_spec: t.Tuple[t.Tuple[t.Type, t.FrozenSet[str]], ...] = (
+    (
+        abc.MutableSet,
+        frozenset(
+            [
+                "add",
+                "clear",
+                "difference_update",
+                "discard",
+                "pop",
+                "remove",
+                "symmetric_difference_update",
+                "update",
+            ]
+        ),
+    ),
+    (
+        abc.MutableMapping,
+        frozenset(["clear", "pop", "popitem", "setdefault", "update"]),
+    ),
+    (
+        abc.MutableSequence,
+        frozenset(["append", "reverse", "insert", "sort", "extend", "remove"]),
+    ),
+    (
+        deque,
+        frozenset(
+            [
+                "append",
+                "appendleft",
+                "clear",
+                "extend",
+                "extendleft",
+                "pop",
+                "popleft",
+                "remove",
+                "rotate",
+            ]
+        ),
+    ),
+)
+
+
+def inspect_format_method(callable: t.Callable) -> t.Optional[str]:
+    if not isinstance(
+        callable, (types.MethodType, types.BuiltinMethodType)
+    ) or callable.__name__ not in ("format", "format_map"):
+        return None
+
+    obj = callable.__self__
+
+    if isinstance(obj, str):
+        return obj
+
+    return None
+
+
+def safe_range(*args: int) -> range:
+    """A range that can't generate ranges with a length of more than
+    MAX_RANGE items.
+    """
+    rng = range(*args)
+
+    if len(rng) > MAX_RANGE:
+        raise OverflowError(
+            "Range too big. The sandbox blocks ranges larger than"
+            f" MAX_RANGE ({MAX_RANGE})."
+        )
+
+    return rng
+
+
+def unsafe(f: F) -> F:
+    """Marks a function or method as unsafe.
+
+    .. code-block: python
+
+        @unsafe
+        def delete(self):
+            pass
+    """
+    f.unsafe_callable = True  # type: ignore
+    return f
+
+
+def is_internal_attribute(obj: t.Any, attr: str) -> bool:
+    """Test if the attribute given is an internal python attribute.  For
+    example this function returns `True` for the `func_code` attribute of
+    python objects.  This is useful if the environment method
+    :meth:`~SandboxedEnvironment.is_safe_attribute` is overridden.
+
+    >>> from jinja2.sandbox import is_internal_attribute
+    >>> is_internal_attribute(str, "mro")
+    True
+    >>> is_internal_attribute(str, "upper")
+    False
+    """
+    if isinstance(obj, types.FunctionType):
+        if attr in UNSAFE_FUNCTION_ATTRIBUTES:
+            return True
+    elif isinstance(obj, types.MethodType):
+        if attr in UNSAFE_FUNCTION_ATTRIBUTES or attr in UNSAFE_METHOD_ATTRIBUTES:
+            return True
+    elif isinstance(obj, type):
+        if attr == "mro":
+            return True
+    elif isinstance(obj, (types.CodeType, types.TracebackType, types.FrameType)):
+        return True
+    elif isinstance(obj, types.GeneratorType):
+        if attr in UNSAFE_GENERATOR_ATTRIBUTES:
+            return True
+    elif hasattr(types, "CoroutineType") and isinstance(obj, types.CoroutineType):
+        if attr in UNSAFE_COROUTINE_ATTRIBUTES:
+            return True
+    elif hasattr(types, "AsyncGeneratorType") and isinstance(
+        obj, types.AsyncGeneratorType
+    ):
+        if attr in UNSAFE_ASYNC_GENERATOR_ATTRIBUTES:
+            return True
+    return attr.startswith("__")
+
+
+def modifies_known_mutable(obj: t.Any, attr: str) -> bool:
+    """This function checks if an attribute on a builtin mutable object
+    (list, dict, set or deque) or the corresponding ABCs would modify it
+    if called.
+
+    >>> modifies_known_mutable({}, "clear")
+    True
+    >>> modifies_known_mutable({}, "keys")
+    False
+    >>> modifies_known_mutable([], "append")
+    True
+    >>> modifies_known_mutable([], "index")
+    False
+
+    If called with an unsupported object, ``False`` is returned.
+
+    >>> modifies_known_mutable("foo", "upper")
+    False
+    """
+    for typespec, unsafe in _mutable_spec:
+        if isinstance(obj, typespec):
+            return attr in unsafe
+    return False
+
+
+class SandboxedEnvironment(Environment):
+    """The sandboxed environment.  It works like the regular environment but
+    tells the compiler to generate sandboxed code.  Additionally subclasses of
+    this environment may override the methods that tell the runtime what
+    attributes or functions are safe to access.
+
+    If the template tries to access insecure code a :exc:`SecurityError` is
+    raised.  However also other exceptions may occur during the rendering so
+    the caller has to ensure that all exceptions are caught.
+    """
+
+    sandboxed = True
+
+    #: default callback table for the binary operators.  A copy of this is
+    #: available on each instance of a sandboxed environment as
+    #: :attr:`binop_table`
+    default_binop_table: t.Dict[str, t.Callable[[t.Any, t.Any], t.Any]] = {
+        "+": operator.add,
+        "-": operator.sub,
+        "*": operator.mul,
+        "/": operator.truediv,
+        "//": operator.floordiv,
+        "**": operator.pow,
+        "%": operator.mod,
+    }
+
+    #: default callback table for the unary operators.  A copy of this is
+    #: available on each instance of a sandboxed environment as
+    #: :attr:`unop_table`
+    default_unop_table: t.Dict[str, t.Callable[[t.Any], t.Any]] = {
+        "+": operator.pos,
+        "-": operator.neg,
+    }
+
+    #: a set of binary operators that should be intercepted.  Each operator
+    #: that is added to this set (empty by default) is delegated to the
+    #: :meth:`call_binop` method that will perform the operator.  The default
+    #: operator callback is specified by :attr:`binop_table`.
+    #:
+    #: The following binary operators are interceptable:
+    #: ``//``, ``%``, ``+``, ``*``, ``-``, ``/``, and ``**``
+    #:
+    #: The default operation form the operator table corresponds to the
+    #: builtin function.  Intercepted calls are always slower than the native
+    #: operator call, so make sure only to intercept the ones you are
+    #: interested in.
+    #:
+    #: .. versionadded:: 2.6
+    intercepted_binops: t.FrozenSet[str] = frozenset()
+
+    #: a set of unary operators that should be intercepted.  Each operator
+    #: that is added to this set (empty by default) is delegated to the
+    #: :meth:`call_unop` method that will perform the operator.  The default
+    #: operator callback is specified by :attr:`unop_table`.
+    #:
+    #: The following unary operators are interceptable: ``+``, ``-``
+    #:
+    #: The default operation form the operator table corresponds to the
+    #: builtin function.  Intercepted calls are always slower than the native
+    #: operator call, so make sure only to intercept the ones you are
+    #: interested in.
+    #:
+    #: .. versionadded:: 2.6
+    intercepted_unops: t.FrozenSet[str] = frozenset()
+
+    def __init__(self, *args: t.Any, **kwargs: t.Any) -> None:
+        super().__init__(*args, **kwargs)
+        self.globals["range"] = safe_range
+        self.binop_table = self.default_binop_table.copy()
+        self.unop_table = self.default_unop_table.copy()
+
+    def is_safe_attribute(self, obj: t.Any, attr: str, value: t.Any) -> bool:
+        """The sandboxed environment will call this method to check if the
+        attribute of an object is safe to access.  Per default all attributes
+        starting with an underscore are considered private as well as the
+        special attributes of internal python objects as returned by the
+        :func:`is_internal_attribute` function.
+        """
+        return not (attr.startswith("_") or is_internal_attribute(obj, attr))
+
+    def is_safe_callable(self, obj: t.Any) -> bool:
+        """Check if an object is safely callable. By default callables
+        are considered safe unless decorated with :func:`unsafe`.
+
+        This also recognizes the Django convention of setting
+        ``func.alters_data = True``.
+        """
+        return not (
+            getattr(obj, "unsafe_callable", False) or getattr(obj, "alters_data", False)
+        )
+
+    def call_binop(
+        self, context: Context, operator: str, left: t.Any, right: t.Any
+    ) -> t.Any:
+        """For intercepted binary operator calls (:meth:`intercepted_binops`)
+        this function is executed instead of the builtin operator.  This can
+        be used to fine tune the behavior of certain operators.
+
+        .. versionadded:: 2.6
+        """
+        return self.binop_table[operator](left, right)
+
+    def call_unop(self, context: Context, operator: str, arg: t.Any) -> t.Any:
+        """For intercepted unary operator calls (:meth:`intercepted_unops`)
+        this function is executed instead of the builtin operator.  This can
+        be used to fine tune the behavior of certain operators.
+
+        .. versionadded:: 2.6
+        """
+        return self.unop_table[operator](arg)
+
+    def getitem(
+        self, obj: t.Any, argument: t.Union[str, t.Any]
+    ) -> t.Union[t.Any, Undefined]:
+        """Subscribe an object from sandboxed code."""
+        try:
+            return obj[argument]
+        except (TypeError, LookupError):
+            if isinstance(argument, str):
+                try:
+                    attr = str(argument)
+                except Exception:
+                    pass
+                else:
+                    try:
+                        value = getattr(obj, attr)
+                    except AttributeError:
+                        pass
+                    else:
+                        if self.is_safe_attribute(obj, argument, value):
+                            return value
+                        return self.unsafe_undefined(obj, argument)
+        return self.undefined(obj=obj, name=argument)
+
+    def getattr(self, obj: t.Any, attribute: str) -> t.Union[t.Any, Undefined]:
+        """Subscribe an object from sandboxed code and prefer the
+        attribute.  The attribute passed *must* be a bytestring.
+        """
+        try:
+            value = getattr(obj, attribute)
+        except AttributeError:
+            try:
+                return obj[attribute]
+            except (TypeError, LookupError):
+                pass
+        else:
+            if self.is_safe_attribute(obj, attribute, value):
+                return value
+            return self.unsafe_undefined(obj, attribute)
+        return self.undefined(obj=obj, name=attribute)
+
+    def unsafe_undefined(self, obj: t.Any, attribute: str) -> Undefined:
+        """Return an undefined object for unsafe attributes."""
+        return self.undefined(
+            f"access to attribute {attribute!r} of"
+            f" {type(obj).__name__!r} object is unsafe.",
+            name=attribute,
+            obj=obj,
+            exc=SecurityError,
+        )
+
+    def format_string(
+        self,
+        s: str,
+        args: t.Tuple[t.Any, ...],
+        kwargs: t.Dict[str, t.Any],
+        format_func: t.Optional[t.Callable] = None,
+    ) -> str:
+        """If a format call is detected, then this is routed through this
+        method so that our safety sandbox can be used for it.
+        """
+        formatter: SandboxedFormatter
+        if isinstance(s, Markup):
+            formatter = SandboxedEscapeFormatter(self, escape=s.escape)
+        else:
+            formatter = SandboxedFormatter(self)
+
+        if format_func is not None and format_func.__name__ == "format_map":
+            if len(args) != 1 or kwargs:
+                raise TypeError(
+                    "format_map() takes exactly one argument"
+                    f" {len(args) + (kwargs is not None)} given"
+                )
+
+            kwargs = args[0]
+            args = ()
+
+        rv = formatter.vformat(s, args, kwargs)
+        return type(s)(rv)
+
+    def call(
+        __self,  # noqa: B902
+        __context: Context,
+        __obj: t.Any,
+        *args: t.Any,
+        **kwargs: t.Any,
+    ) -> t.Any:
+        """Call an object from sandboxed code."""
+        fmt = inspect_format_method(__obj)
+        if fmt is not None:
+            return __self.format_string(fmt, args, kwargs, __obj)
+
+        # the double prefixes are to avoid double keyword argument
+        # errors when proxying the call.
+        if not __self.is_safe_callable(__obj):
+            raise SecurityError(f"{__obj!r} is not safely callable")
+        return __context.call(__obj, *args, **kwargs)
+
+
+class ImmutableSandboxedEnvironment(SandboxedEnvironment):
+    """Works exactly like the regular `SandboxedEnvironment` but does not
+    permit modifications on the builtin mutable objects `list`, `set`, and
+    `dict` by using the :func:`modifies_known_mutable` function.
+    """
+
+    def is_safe_attribute(self, obj: t.Any, attr: str, value: t.Any) -> bool:
+        if not super().is_safe_attribute(obj, attr, value):
+            return False
+
+        return not modifies_known_mutable(obj, attr)
+
+
+class SandboxedFormatter(Formatter):
+    def __init__(self, env: Environment, **kwargs: t.Any) -> None:
+        self._env = env
+        super().__init__(**kwargs)
+
+    def get_field(
+        self, field_name: str, args: t.Sequence[t.Any], kwargs: t.Mapping[str, t.Any]
+    ) -> t.Tuple[t.Any, str]:
+        first, rest = formatter_field_name_split(field_name)
+        obj = self.get_value(first, args, kwargs)
+        for is_attr, i in rest:
+            if is_attr:
+                obj = self._env.getattr(obj, i)
+            else:
+                obj = self._env.getitem(obj, i)
+        return obj, first
+
+
+class SandboxedEscapeFormatter(SandboxedFormatter, EscapeFormatter):
+    pass
diff --git a/llm/Lib/site-packages/jinja2/tests.py b/llm/Lib/site-packages/jinja2/tests.py
new file mode 100644
index 0000000000000000000000000000000000000000..a467cf08b54879ee734617611aef72ed946d4566
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/tests.py
@@ -0,0 +1,255 @@
+"""Built-in template tests used with the ``is`` operator."""
+import operator
+import typing as t
+from collections import abc
+from numbers import Number
+
+from .runtime import Undefined
+from .utils import pass_environment
+
+if t.TYPE_CHECKING:
+    from .environment import Environment
+
+
+def test_odd(value: int) -> bool:
+    """Return true if the variable is odd."""
+    return value % 2 == 1
+
+
+def test_even(value: int) -> bool:
+    """Return true if the variable is even."""
+    return value % 2 == 0
+
+
+def test_divisibleby(value: int, num: int) -> bool:
+    """Check if a variable is divisible by a number."""
+    return value % num == 0
+
+
+def test_defined(value: t.Any) -> bool:
+    """Return true if the variable is defined:
+
+    .. sourcecode:: jinja
+
+        {% if variable is defined %}
+            value of variable: {{ variable }}
+        {% else %}
+            variable is not defined
+        {% endif %}
+
+    See the :func:`default` filter for a simple way to set undefined
+    variables.
+    """
+    return not isinstance(value, Undefined)
+
+
+def test_undefined(value: t.Any) -> bool:
+    """Like :func:`defined` but the other way round."""
+    return isinstance(value, Undefined)
+
+
+@pass_environment
+def test_filter(env: "Environment", value: str) -> bool:
+    """Check if a filter exists by name. Useful if a filter may be
+    optionally available.
+
+    .. code-block:: jinja
+
+        {% if 'markdown' is filter %}
+            {{ value | markdown }}
+        {% else %}
+            {{ value }}
+        {% endif %}
+
+    .. versionadded:: 3.0
+    """
+    return value in env.filters
+
+
+@pass_environment
+def test_test(env: "Environment", value: str) -> bool:
+    """Check if a test exists by name. Useful if a test may be
+    optionally available.
+
+    .. code-block:: jinja
+
+        {% if 'loud' is test %}
+            {% if value is loud %}
+                {{ value|upper }}
+            {% else %}
+                {{ value|lower }}
+            {% endif %}
+        {% else %}
+            {{ value }}
+        {% endif %}
+
+    .. versionadded:: 3.0
+    """
+    return value in env.tests
+
+
+def test_none(value: t.Any) -> bool:
+    """Return true if the variable is none."""
+    return value is None
+
+
+def test_boolean(value: t.Any) -> bool:
+    """Return true if the object is a boolean value.
+
+    .. versionadded:: 2.11
+    """
+    return value is True or value is False
+
+
+def test_false(value: t.Any) -> bool:
+    """Return true if the object is False.
+
+    .. versionadded:: 2.11
+    """
+    return value is False
+
+
+def test_true(value: t.Any) -> bool:
+    """Return true if the object is True.
+
+    .. versionadded:: 2.11
+    """
+    return value is True
+
+
+# NOTE: The existing 'number' test matches booleans and floats
+def test_integer(value: t.Any) -> bool:
+    """Return true if the object is an integer.
+
+    .. versionadded:: 2.11
+    """
+    return isinstance(value, int) and value is not True and value is not False
+
+
+# NOTE: The existing 'number' test matches booleans and integers
+def test_float(value: t.Any) -> bool:
+    """Return true if the object is a float.
+
+    .. versionadded:: 2.11
+    """
+    return isinstance(value, float)
+
+
+def test_lower(value: str) -> bool:
+    """Return true if the variable is lowercased."""
+    return str(value).islower()
+
+
+def test_upper(value: str) -> bool:
+    """Return true if the variable is uppercased."""
+    return str(value).isupper()
+
+
+def test_string(value: t.Any) -> bool:
+    """Return true if the object is a string."""
+    return isinstance(value, str)
+
+
+def test_mapping(value: t.Any) -> bool:
+    """Return true if the object is a mapping (dict etc.).
+
+    .. versionadded:: 2.6
+    """
+    return isinstance(value, abc.Mapping)
+
+
+def test_number(value: t.Any) -> bool:
+    """Return true if the variable is a number."""
+    return isinstance(value, Number)
+
+
+def test_sequence(value: t.Any) -> bool:
+    """Return true if the variable is a sequence. Sequences are variables
+    that are iterable.
+    """
+    try:
+        len(value)
+        value.__getitem__
+    except Exception:
+        return False
+
+    return True
+
+
+def test_sameas(value: t.Any, other: t.Any) -> bool:
+    """Check if an object points to the same memory address than another
+    object:
+
+    .. sourcecode:: jinja
+
+        {% if foo.attribute is sameas false %}
+            the foo attribute really is the `False` singleton
+        {% endif %}
+    """
+    return value is other
+
+
+def test_iterable(value: t.Any) -> bool:
+    """Check if it's possible to iterate over an object."""
+    try:
+        iter(value)
+    except TypeError:
+        return False
+
+    return True
+
+
+def test_escaped(value: t.Any) -> bool:
+    """Check if the value is escaped."""
+    return hasattr(value, "__html__")
+
+
+def test_in(value: t.Any, seq: t.Container) -> bool:
+    """Check if value is in seq.
+
+    .. versionadded:: 2.10
+    """
+    return value in seq
+
+
+TESTS = {
+    "odd": test_odd,
+    "even": test_even,
+    "divisibleby": test_divisibleby,
+    "defined": test_defined,
+    "undefined": test_undefined,
+    "filter": test_filter,
+    "test": test_test,
+    "none": test_none,
+    "boolean": test_boolean,
+    "false": test_false,
+    "true": test_true,
+    "integer": test_integer,
+    "float": test_float,
+    "lower": test_lower,
+    "upper": test_upper,
+    "string": test_string,
+    "mapping": test_mapping,
+    "number": test_number,
+    "sequence": test_sequence,
+    "iterable": test_iterable,
+    "callable": callable,
+    "sameas": test_sameas,
+    "escaped": test_escaped,
+    "in": test_in,
+    "==": operator.eq,
+    "eq": operator.eq,
+    "equalto": operator.eq,
+    "!=": operator.ne,
+    "ne": operator.ne,
+    ">": operator.gt,
+    "gt": operator.gt,
+    "greaterthan": operator.gt,
+    "ge": operator.ge,
+    ">=": operator.ge,
+    "<": operator.lt,
+    "lt": operator.lt,
+    "lessthan": operator.lt,
+    "<=": operator.le,
+    "le": operator.le,
+}
diff --git a/llm/Lib/site-packages/jinja2/utils.py b/llm/Lib/site-packages/jinja2/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..18914a58fd3620b43ad98afd0fcb0a5758d764e9
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/utils.py
@@ -0,0 +1,755 @@
+import enum
+import json
+import os
+import re
+import typing as t
+from collections import abc
+from collections import deque
+from random import choice
+from random import randrange
+from threading import Lock
+from types import CodeType
+from urllib.parse import quote_from_bytes
+
+import markupsafe
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+
+F = t.TypeVar("F", bound=t.Callable[..., t.Any])
+
+# special singleton representing missing values for the runtime
+missing: t.Any = type("MissingType", (), {"__repr__": lambda x: "missing"})()
+
+internal_code: t.MutableSet[CodeType] = set()
+
+concat = "".join
+
+
+def pass_context(f: F) -> F:
+    """Pass the :class:`~jinja2.runtime.Context` as the first argument
+    to the decorated function when called while rendering a template.
+
+    Can be used on functions, filters, and tests.
+
+    If only ``Context.eval_context`` is needed, use
+    :func:`pass_eval_context`. If only ``Context.environment`` is
+    needed, use :func:`pass_environment`.
+
+    .. versionadded:: 3.0.0
+        Replaces ``contextfunction`` and ``contextfilter``.
+    """
+    f.jinja_pass_arg = _PassArg.context  # type: ignore
+    return f
+
+
+def pass_eval_context(f: F) -> F:
+    """Pass the :class:`~jinja2.nodes.EvalContext` as the first argument
+    to the decorated function when called while rendering a template.
+    See :ref:`eval-context`.
+
+    Can be used on functions, filters, and tests.
+
+    If only ``EvalContext.environment`` is needed, use
+    :func:`pass_environment`.
+
+    .. versionadded:: 3.0.0
+        Replaces ``evalcontextfunction`` and ``evalcontextfilter``.
+    """
+    f.jinja_pass_arg = _PassArg.eval_context  # type: ignore
+    return f
+
+
+def pass_environment(f: F) -> F:
+    """Pass the :class:`~jinja2.Environment` as the first argument to
+    the decorated function when called while rendering a template.
+
+    Can be used on functions, filters, and tests.
+
+    .. versionadded:: 3.0.0
+        Replaces ``environmentfunction`` and ``environmentfilter``.
+    """
+    f.jinja_pass_arg = _PassArg.environment  # type: ignore
+    return f
+
+
+class _PassArg(enum.Enum):
+    context = enum.auto()
+    eval_context = enum.auto()
+    environment = enum.auto()
+
+    @classmethod
+    def from_obj(cls, obj: F) -> t.Optional["_PassArg"]:
+        if hasattr(obj, "jinja_pass_arg"):
+            return obj.jinja_pass_arg  # type: ignore
+
+        return None
+
+
+def internalcode(f: F) -> F:
+    """Marks the function as internally used"""
+    internal_code.add(f.__code__)
+    return f
+
+
+def is_undefined(obj: t.Any) -> bool:
+    """Check if the object passed is undefined.  This does nothing more than
+    performing an instance check against :class:`Undefined` but looks nicer.
+    This can be used for custom filters or tests that want to react to
+    undefined variables.  For example a custom default filter can look like
+    this::
+
+        def default(var, default=''):
+            if is_undefined(var):
+                return default
+            return var
+    """
+    from .runtime import Undefined
+
+    return isinstance(obj, Undefined)
+
+
+def consume(iterable: t.Iterable[t.Any]) -> None:
+    """Consumes an iterable without doing anything with it."""
+    for _ in iterable:
+        pass
+
+
+def clear_caches() -> None:
+    """Jinja keeps internal caches for environments and lexers.  These are
+    used so that Jinja doesn't have to recreate environments and lexers all
+    the time.  Normally you don't have to care about that but if you are
+    measuring memory consumption you may want to clean the caches.
+    """
+    from .environment import get_spontaneous_environment
+    from .lexer import _lexer_cache
+
+    get_spontaneous_environment.cache_clear()
+    _lexer_cache.clear()
+
+
+def import_string(import_name: str, silent: bool = False) -> t.Any:
+    """Imports an object based on a string.  This is useful if you want to
+    use import paths as endpoints or something similar.  An import path can
+    be specified either in dotted notation (``xml.sax.saxutils.escape``)
+    or with a colon as object delimiter (``xml.sax.saxutils:escape``).
+
+    If the `silent` is True the return value will be `None` if the import
+    fails.
+
+    :return: imported object
+    """
+    try:
+        if ":" in import_name:
+            module, obj = import_name.split(":", 1)
+        elif "." in import_name:
+            module, _, obj = import_name.rpartition(".")
+        else:
+            return __import__(import_name)
+        return getattr(__import__(module, None, None, [obj]), obj)
+    except (ImportError, AttributeError):
+        if not silent:
+            raise
+
+
+def open_if_exists(filename: str, mode: str = "rb") -> t.Optional[t.IO]:
+    """Returns a file descriptor for the filename if that file exists,
+    otherwise ``None``.
+    """
+    if not os.path.isfile(filename):
+        return None
+
+    return open(filename, mode)
+
+
+def object_type_repr(obj: t.Any) -> str:
+    """Returns the name of the object's type.  For some recognized
+    singletons the name of the object is returned instead. (For
+    example for `None` and `Ellipsis`).
+    """
+    if obj is None:
+        return "None"
+    elif obj is Ellipsis:
+        return "Ellipsis"
+
+    cls = type(obj)
+
+    if cls.__module__ == "builtins":
+        return f"{cls.__name__} object"
+
+    return f"{cls.__module__}.{cls.__name__} object"
+
+
+def pformat(obj: t.Any) -> str:
+    """Format an object using :func:`pprint.pformat`."""
+    from pprint import pformat
+
+    return pformat(obj)
+
+
+_http_re = re.compile(
+    r"""
+    ^
+    (
+        (https?://|www\.)  # scheme or www
+        (([\w%-]+\.)+)?  # subdomain
+        (
+            [a-z]{2,63}  # basic tld
+        |
+            xn--[\w%]{2,59}  # idna tld
+        )
+    |
+        ([\w%-]{2,63}\.)+  # basic domain
+        (com|net|int|edu|gov|org|info|mil)  # basic tld
+    |
+        (https?://)  # scheme
+        (
+            (([\d]{1,3})(\.[\d]{1,3}){3})  # IPv4
+        |
+            (\[([\da-f]{0,4}:){2}([\da-f]{0,4}:?){1,6}])  # IPv6
+        )
+    )
+    (?::[\d]{1,5})?  # port
+    (?:[/?#]\S*)?  # path, query, and fragment
+    $
+    """,
+    re.IGNORECASE | re.VERBOSE,
+)
+_email_re = re.compile(r"^\S+@\w[\w.-]*\.\w+$")
+
+
+def urlize(
+    text: str,
+    trim_url_limit: t.Optional[int] = None,
+    rel: t.Optional[str] = None,
+    target: t.Optional[str] = None,
+    extra_schemes: t.Optional[t.Iterable[str]] = None,
+) -> str:
+    """Convert URLs in text into clickable links.
+
+    This may not recognize links in some situations. Usually, a more
+    comprehensive formatter, such as a Markdown library, is a better
+    choice.
+
+    Works on ``http://``, ``https://``, ``www.``, ``mailto:``, and email
+    addresses. Links with trailing punctuation (periods, commas, closing
+    parentheses) and leading punctuation (opening parentheses) are
+    recognized excluding the punctuation. Email addresses that include
+    header fields are not recognized (for example,
+    ``mailto:address@example.com?cc=copy@example.com``).
+
+    :param text: Original text containing URLs to link.
+    :param trim_url_limit: Shorten displayed URL values to this length.
+    :param target: Add the ``target`` attribute to links.
+    :param rel: Add the ``rel`` attribute to links.
+    :param extra_schemes: Recognize URLs that start with these schemes
+        in addition to the default behavior.
+
+    .. versionchanged:: 3.0
+        The ``extra_schemes`` parameter was added.
+
+    .. versionchanged:: 3.0
+        Generate ``https://`` links for URLs without a scheme.
+
+    .. versionchanged:: 3.0
+        The parsing rules were updated. Recognize email addresses with
+        or without the ``mailto:`` scheme. Validate IP addresses. Ignore
+        parentheses and brackets in more cases.
+    """
+    if trim_url_limit is not None:
+
+        def trim_url(x: str) -> str:
+            if len(x) > trim_url_limit:
+                return f"{x[:trim_url_limit]}..."
+
+            return x
+
+    else:
+
+        def trim_url(x: str) -> str:
+            return x
+
+    words = re.split(r"(\s+)", str(markupsafe.escape(text)))
+    rel_attr = f' rel="{markupsafe.escape(rel)}"' if rel else ""
+    target_attr = f' target="{markupsafe.escape(target)}"' if target else ""
+
+    for i, word in enumerate(words):
+        head, middle, tail = "", word, ""
+        match = re.match(r"^([(<]|&lt;)+", middle)
+
+        if match:
+            head = match.group()
+            middle = middle[match.end() :]
+
+        # Unlike lead, which is anchored to the start of the string,
+        # need to check that the string ends with any of the characters
+        # before trying to match all of them, to avoid backtracking.
+        if middle.endswith((")", ">", ".", ",", "\n", "&gt;")):
+            match = re.search(r"([)>.,\n]|&gt;)+$", middle)
+
+            if match:
+                tail = match.group()
+                middle = middle[: match.start()]
+
+        # Prefer balancing parentheses in URLs instead of ignoring a
+        # trailing character.
+        for start_char, end_char in ("(", ")"), ("<", ">"), ("&lt;", "&gt;"):
+            start_count = middle.count(start_char)
+
+            if start_count <= middle.count(end_char):
+                # Balanced, or lighter on the left
+                continue
+
+            # Move as many as possible from the tail to balance
+            for _ in range(min(start_count, tail.count(end_char))):
+                end_index = tail.index(end_char) + len(end_char)
+                # Move anything in the tail before the end char too
+                middle += tail[:end_index]
+                tail = tail[end_index:]
+
+        if _http_re.match(middle):
+            if middle.startswith("https://") or middle.startswith("http://"):
+                middle = (
+                    f'<a href="{middle}"{rel_attr}{target_attr}>{trim_url(middle)}</a>'
+                )
+            else:
+                middle = (
+                    f'<a href="https://{middle}"{rel_attr}{target_attr}>'
+                    f"{trim_url(middle)}</a>"
+                )
+
+        elif middle.startswith("mailto:") and _email_re.match(middle[7:]):
+            middle = f'<a href="{middle}">{middle[7:]}</a>'
+
+        elif (
+            "@" in middle
+            and not middle.startswith("www.")
+            and ":" not in middle
+            and _email_re.match(middle)
+        ):
+            middle = f'<a href="mailto:{middle}">{middle}</a>'
+
+        elif extra_schemes is not None:
+            for scheme in extra_schemes:
+                if middle != scheme and middle.startswith(scheme):
+                    middle = f'<a href="{middle}"{rel_attr}{target_attr}>{middle}</a>'
+
+        words[i] = f"{head}{middle}{tail}"
+
+    return "".join(words)
+
+
+def generate_lorem_ipsum(
+    n: int = 5, html: bool = True, min: int = 20, max: int = 100
+) -> str:
+    """Generate some lorem ipsum for the template."""
+    from .constants import LOREM_IPSUM_WORDS
+
+    words = LOREM_IPSUM_WORDS.split()
+    result = []
+
+    for _ in range(n):
+        next_capitalized = True
+        last_comma = last_fullstop = 0
+        word = None
+        last = None
+        p = []
+
+        # each paragraph contains out of 20 to 100 words.
+        for idx, _ in enumerate(range(randrange(min, max))):
+            while True:
+                word = choice(words)
+                if word != last:
+                    last = word
+                    break
+            if next_capitalized:
+                word = word.capitalize()
+                next_capitalized = False
+            # add commas
+            if idx - randrange(3, 8) > last_comma:
+                last_comma = idx
+                last_fullstop += 2
+                word += ","
+            # add end of sentences
+            if idx - randrange(10, 20) > last_fullstop:
+                last_comma = last_fullstop = idx
+                word += "."
+                next_capitalized = True
+            p.append(word)
+
+        # ensure that the paragraph ends with a dot.
+        p_str = " ".join(p)
+
+        if p_str.endswith(","):
+            p_str = p_str[:-1] + "."
+        elif not p_str.endswith("."):
+            p_str += "."
+
+        result.append(p_str)
+
+    if not html:
+        return "\n\n".join(result)
+    return markupsafe.Markup(
+        "\n".join(f"<p>{markupsafe.escape(x)}</p>" for x in result)
+    )
+
+
+def url_quote(obj: t.Any, charset: str = "utf-8", for_qs: bool = False) -> str:
+    """Quote a string for use in a URL using the given charset.
+
+    :param obj: String or bytes to quote. Other types are converted to
+        string then encoded to bytes using the given charset.
+    :param charset: Encode text to bytes using this charset.
+    :param for_qs: Quote "/" and use "+" for spaces.
+    """
+    if not isinstance(obj, bytes):
+        if not isinstance(obj, str):
+            obj = str(obj)
+
+        obj = obj.encode(charset)
+
+    safe = b"" if for_qs else b"/"
+    rv = quote_from_bytes(obj, safe)
+
+    if for_qs:
+        rv = rv.replace("%20", "+")
+
+    return rv
+
+
+@abc.MutableMapping.register
+class LRUCache:
+    """A simple LRU Cache implementation."""
+
+    # this is fast for small capacities (something below 1000) but doesn't
+    # scale.  But as long as it's only used as storage for templates this
+    # won't do any harm.
+
+    def __init__(self, capacity: int) -> None:
+        self.capacity = capacity
+        self._mapping: t.Dict[t.Any, t.Any] = {}
+        self._queue: "te.Deque[t.Any]" = deque()
+        self._postinit()
+
+    def _postinit(self) -> None:
+        # alias all queue methods for faster lookup
+        self._popleft = self._queue.popleft
+        self._pop = self._queue.pop
+        self._remove = self._queue.remove
+        self._wlock = Lock()
+        self._append = self._queue.append
+
+    def __getstate__(self) -> t.Mapping[str, t.Any]:
+        return {
+            "capacity": self.capacity,
+            "_mapping": self._mapping,
+            "_queue": self._queue,
+        }
+
+    def __setstate__(self, d: t.Mapping[str, t.Any]) -> None:
+        self.__dict__.update(d)
+        self._postinit()
+
+    def __getnewargs__(self) -> t.Tuple:
+        return (self.capacity,)
+
+    def copy(self) -> "LRUCache":
+        """Return a shallow copy of the instance."""
+        rv = self.__class__(self.capacity)
+        rv._mapping.update(self._mapping)
+        rv._queue.extend(self._queue)
+        return rv
+
+    def get(self, key: t.Any, default: t.Any = None) -> t.Any:
+        """Return an item from the cache dict or `default`"""
+        try:
+            return self[key]
+        except KeyError:
+            return default
+
+    def setdefault(self, key: t.Any, default: t.Any = None) -> t.Any:
+        """Set `default` if the key is not in the cache otherwise
+        leave unchanged. Return the value of this key.
+        """
+        try:
+            return self[key]
+        except KeyError:
+            self[key] = default
+            return default
+
+    def clear(self) -> None:
+        """Clear the cache."""
+        with self._wlock:
+            self._mapping.clear()
+            self._queue.clear()
+
+    def __contains__(self, key: t.Any) -> bool:
+        """Check if a key exists in this cache."""
+        return key in self._mapping
+
+    def __len__(self) -> int:
+        """Return the current size of the cache."""
+        return len(self._mapping)
+
+    def __repr__(self) -> str:
+        return f"<{type(self).__name__} {self._mapping!r}>"
+
+    def __getitem__(self, key: t.Any) -> t.Any:
+        """Get an item from the cache. Moves the item up so that it has the
+        highest priority then.
+
+        Raise a `KeyError` if it does not exist.
+        """
+        with self._wlock:
+            rv = self._mapping[key]
+
+            if self._queue[-1] != key:
+                try:
+                    self._remove(key)
+                except ValueError:
+                    # if something removed the key from the container
+                    # when we read, ignore the ValueError that we would
+                    # get otherwise.
+                    pass
+
+                self._append(key)
+
+            return rv
+
+    def __setitem__(self, key: t.Any, value: t.Any) -> None:
+        """Sets the value for an item. Moves the item up so that it
+        has the highest priority then.
+        """
+        with self._wlock:
+            if key in self._mapping:
+                self._remove(key)
+            elif len(self._mapping) == self.capacity:
+                del self._mapping[self._popleft()]
+
+            self._append(key)
+            self._mapping[key] = value
+
+    def __delitem__(self, key: t.Any) -> None:
+        """Remove an item from the cache dict.
+        Raise a `KeyError` if it does not exist.
+        """
+        with self._wlock:
+            del self._mapping[key]
+
+            try:
+                self._remove(key)
+            except ValueError:
+                pass
+
+    def items(self) -> t.Iterable[t.Tuple[t.Any, t.Any]]:
+        """Return a list of items."""
+        result = [(key, self._mapping[key]) for key in list(self._queue)]
+        result.reverse()
+        return result
+
+    def values(self) -> t.Iterable[t.Any]:
+        """Return a list of all values."""
+        return [x[1] for x in self.items()]
+
+    def keys(self) -> t.Iterable[t.Any]:
+        """Return a list of all keys ordered by most recent usage."""
+        return list(self)
+
+    def __iter__(self) -> t.Iterator[t.Any]:
+        return reversed(tuple(self._queue))
+
+    def __reversed__(self) -> t.Iterator[t.Any]:
+        """Iterate over the keys in the cache dict, oldest items
+        coming first.
+        """
+        return iter(tuple(self._queue))
+
+    __copy__ = copy
+
+
+def select_autoescape(
+    enabled_extensions: t.Collection[str] = ("html", "htm", "xml"),
+    disabled_extensions: t.Collection[str] = (),
+    default_for_string: bool = True,
+    default: bool = False,
+) -> t.Callable[[t.Optional[str]], bool]:
+    """Intelligently sets the initial value of autoescaping based on the
+    filename of the template.  This is the recommended way to configure
+    autoescaping if you do not want to write a custom function yourself.
+
+    If you want to enable it for all templates created from strings or
+    for all templates with `.html` and `.xml` extensions::
+
+        from jinja2 import Environment, select_autoescape
+        env = Environment(autoescape=select_autoescape(
+            enabled_extensions=('html', 'xml'),
+            default_for_string=True,
+        ))
+
+    Example configuration to turn it on at all times except if the template
+    ends with `.txt`::
+
+        from jinja2 import Environment, select_autoescape
+        env = Environment(autoescape=select_autoescape(
+            disabled_extensions=('txt',),
+            default_for_string=True,
+            default=True,
+        ))
+
+    The `enabled_extensions` is an iterable of all the extensions that
+    autoescaping should be enabled for.  Likewise `disabled_extensions` is
+    a list of all templates it should be disabled for.  If a template is
+    loaded from a string then the default from `default_for_string` is used.
+    If nothing matches then the initial value of autoescaping is set to the
+    value of `default`.
+
+    For security reasons this function operates case insensitive.
+
+    .. versionadded:: 2.9
+    """
+    enabled_patterns = tuple(f".{x.lstrip('.').lower()}" for x in enabled_extensions)
+    disabled_patterns = tuple(f".{x.lstrip('.').lower()}" for x in disabled_extensions)
+
+    def autoescape(template_name: t.Optional[str]) -> bool:
+        if template_name is None:
+            return default_for_string
+        template_name = template_name.lower()
+        if template_name.endswith(enabled_patterns):
+            return True
+        if template_name.endswith(disabled_patterns):
+            return False
+        return default
+
+    return autoescape
+
+
+def htmlsafe_json_dumps(
+    obj: t.Any, dumps: t.Optional[t.Callable[..., str]] = None, **kwargs: t.Any
+) -> markupsafe.Markup:
+    """Serialize an object to a string of JSON with :func:`json.dumps`,
+    then replace HTML-unsafe characters with Unicode escapes and mark
+    the result safe with :class:`~markupsafe.Markup`.
+
+    This is available in templates as the ``|tojson`` filter.
+
+    The following characters are escaped: ``<``, ``>``, ``&``, ``'``.
+
+    The returned string is safe to render in HTML documents and
+    ``<script>`` tags. The exception is in HTML attributes that are
+    double quoted; either use single quotes or the ``|forceescape``
+    filter.
+
+    :param obj: The object to serialize to JSON.
+    :param dumps: The ``dumps`` function to use. Defaults to
+        ``env.policies["json.dumps_function"]``, which defaults to
+        :func:`json.dumps`.
+    :param kwargs: Extra arguments to pass to ``dumps``. Merged onto
+        ``env.policies["json.dumps_kwargs"]``.
+
+    .. versionchanged:: 3.0
+        The ``dumper`` parameter is renamed to ``dumps``.
+
+    .. versionadded:: 2.9
+    """
+    if dumps is None:
+        dumps = json.dumps
+
+    return markupsafe.Markup(
+        dumps(obj, **kwargs)
+        .replace("<", "\\u003c")
+        .replace(">", "\\u003e")
+        .replace("&", "\\u0026")
+        .replace("'", "\\u0027")
+    )
+
+
+class Cycler:
+    """Cycle through values by yield them one at a time, then restarting
+    once the end is reached. Available as ``cycler`` in templates.
+
+    Similar to ``loop.cycle``, but can be used outside loops or across
+    multiple loops. For example, render a list of folders and files in a
+    list, alternating giving them "odd" and "even" classes.
+
+    .. code-block:: html+jinja
+
+        {% set row_class = cycler("odd", "even") %}
+        <ul class="browser">
+        {% for folder in folders %}
+          <li class="folder {{ row_class.next() }}">{{ folder }}
+        {% endfor %}
+        {% for file in files %}
+          <li class="file {{ row_class.next() }}">{{ file }}
+        {% endfor %}
+        </ul>
+
+    :param items: Each positional argument will be yielded in the order
+        given for each cycle.
+
+    .. versionadded:: 2.1
+    """
+
+    def __init__(self, *items: t.Any) -> None:
+        if not items:
+            raise RuntimeError("at least one item has to be provided")
+        self.items = items
+        self.pos = 0
+
+    def reset(self) -> None:
+        """Resets the current item to the first item."""
+        self.pos = 0
+
+    @property
+    def current(self) -> t.Any:
+        """Return the current item. Equivalent to the item that will be
+        returned next time :meth:`next` is called.
+        """
+        return self.items[self.pos]
+
+    def next(self) -> t.Any:
+        """Return the current item, then advance :attr:`current` to the
+        next item.
+        """
+        rv = self.current
+        self.pos = (self.pos + 1) % len(self.items)
+        return rv
+
+    __next__ = next
+
+
+class Joiner:
+    """A joining helper for templates."""
+
+    def __init__(self, sep: str = ", ") -> None:
+        self.sep = sep
+        self.used = False
+
+    def __call__(self) -> str:
+        if not self.used:
+            self.used = True
+            return ""
+        return self.sep
+
+
+class Namespace:
+    """A namespace object that can hold arbitrary attributes.  It may be
+    initialized from a dictionary or with keyword arguments."""
+
+    def __init__(*args: t.Any, **kwargs: t.Any) -> None:  # noqa: B902
+        self, args = args[0], args[1:]
+        self.__attrs = dict(*args, **kwargs)
+
+    def __getattribute__(self, name: str) -> t.Any:
+        # __class__ is needed for the awaitable check in async mode
+        if name in {"_Namespace__attrs", "__class__"}:
+            return object.__getattribute__(self, name)
+        try:
+            return self.__attrs[name]
+        except KeyError:
+            raise AttributeError(name) from None
+
+    def __setitem__(self, name: str, value: t.Any) -> None:
+        self.__attrs[name] = value
+
+    def __repr__(self) -> str:
+        return f"<Namespace {self.__attrs!r}>"
diff --git a/llm/Lib/site-packages/jinja2/visitor.py b/llm/Lib/site-packages/jinja2/visitor.py
new file mode 100644
index 0000000000000000000000000000000000000000..17c6aaba570742652f70bf1e7bf1a576c9d256ae
--- /dev/null
+++ b/llm/Lib/site-packages/jinja2/visitor.py
@@ -0,0 +1,92 @@
+"""API for traversing the AST nodes. Implemented by the compiler and
+meta introspection.
+"""
+import typing as t
+
+from .nodes import Node
+
+if t.TYPE_CHECKING:
+    import typing_extensions as te
+
+    class VisitCallable(te.Protocol):
+        def __call__(self, node: Node, *args: t.Any, **kwargs: t.Any) -> t.Any:
+            ...
+
+
+class NodeVisitor:
+    """Walks the abstract syntax tree and call visitor functions for every
+    node found.  The visitor functions may return values which will be
+    forwarded by the `visit` method.
+
+    Per default the visitor functions for the nodes are ``'visit_'`` +
+    class name of the node.  So a `TryFinally` node visit function would
+    be `visit_TryFinally`.  This behavior can be changed by overriding
+    the `get_visitor` function.  If no visitor function exists for a node
+    (return value `None`) the `generic_visit` visitor is used instead.
+    """
+
+    def get_visitor(self, node: Node) -> "t.Optional[VisitCallable]":
+        """Return the visitor function for this node or `None` if no visitor
+        exists for this node.  In that case the generic visit function is
+        used instead.
+        """
+        return getattr(self, f"visit_{type(node).__name__}", None)
+
+    def visit(self, node: Node, *args: t.Any, **kwargs: t.Any) -> t.Any:
+        """Visit a node."""
+        f = self.get_visitor(node)
+
+        if f is not None:
+            return f(node, *args, **kwargs)
+
+        return self.generic_visit(node, *args, **kwargs)
+
+    def generic_visit(self, node: Node, *args: t.Any, **kwargs: t.Any) -> t.Any:
+        """Called if no explicit visitor function exists for a node."""
+        for child_node in node.iter_child_nodes():
+            self.visit(child_node, *args, **kwargs)
+
+
+class NodeTransformer(NodeVisitor):
+    """Walks the abstract syntax tree and allows modifications of nodes.
+
+    The `NodeTransformer` will walk the AST and use the return value of the
+    visitor functions to replace or remove the old node.  If the return
+    value of the visitor function is `None` the node will be removed
+    from the previous location otherwise it's replaced with the return
+    value.  The return value may be the original node in which case no
+    replacement takes place.
+    """
+
+    def generic_visit(self, node: Node, *args: t.Any, **kwargs: t.Any) -> Node:
+        for field, old_value in node.iter_fields():
+            if isinstance(old_value, list):
+                new_values = []
+                for value in old_value:
+                    if isinstance(value, Node):
+                        value = self.visit(value, *args, **kwargs)
+                        if value is None:
+                            continue
+                        elif not isinstance(value, Node):
+                            new_values.extend(value)
+                            continue
+                    new_values.append(value)
+                old_value[:] = new_values
+            elif isinstance(old_value, Node):
+                new_node = self.visit(old_value, *args, **kwargs)
+                if new_node is None:
+                    delattr(node, field)
+                else:
+                    setattr(node, field, new_node)
+        return node
+
+    def visit_list(self, node: Node, *args: t.Any, **kwargs: t.Any) -> t.List[Node]:
+        """As transformers may return lists in some places this method
+        can be used to enforce a list as return value.
+        """
+        rv = self.visit(node, *args, **kwargs)
+
+        if not isinstance(rv, list):
+            return [rv]
+
+        return rv
diff --git a/llm/Lib/site-packages/joblib-1.4.0.dist-info/INSTALLER b/llm/Lib/site-packages/joblib-1.4.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/joblib-1.4.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/joblib-1.4.0.dist-info/LICENSE.txt b/llm/Lib/site-packages/joblib-1.4.0.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..910537bd33412dd9b70c4d07cedd41b519be7fb5
--- /dev/null
+++ b/llm/Lib/site-packages/joblib-1.4.0.dist-info/LICENSE.txt
@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2008-2021, The joblib developers.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/llm/Lib/site-packages/joblib-1.4.0.dist-info/METADATA b/llm/Lib/site-packages/joblib-1.4.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..0ca5d797274c60a620b93d84010e122232011ba5
--- /dev/null
+++ b/llm/Lib/site-packages/joblib-1.4.0.dist-info/METADATA
@@ -0,0 +1,165 @@
+Metadata-Version: 2.1
+Name: joblib
+Version: 1.4.0
+Summary: Lightweight pipelining with Python functions
+Author-email: Gael Varoquaux <gael.varoquaux@normalesup.org>
+License: BSD 3-Clause
+Project-URL: Homepage, https://joblib.readthedocs.io
+Project-URL: Source, https://github.com/joblib/joblib
+Platform: any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Utilities
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+License-File: LICENSE.txt
+
+|PyPi| |Azure| |ReadTheDocs| |Codecov| 
+
+.. |PyPi| image:: https://badge.fury.io/py/joblib.svg
+   :target: https://badge.fury.io/py/joblib
+   :alt: Joblib version
+
+.. |Azure| image:: https://dev.azure.com/joblib/joblib/_apis/build/status/joblib.joblib?branchName=master
+   :target: https://dev.azure.com/joblib/joblib/_build?definitionId=3&_a=summary&branchFilter=40
+   :alt: Azure CI status
+
+.. |ReadTheDocs| image:: https://readthedocs.org/projects/joblib/badge/?version=latest
+    :target: https://joblib.readthedocs.io/en/latest/?badge=latest
+    :alt: Documentation Status
+
+.. |Codecov| image:: https://codecov.io/gh/joblib/joblib/branch/master/graph/badge.svg
+   :target: https://codecov.io/gh/joblib/joblib
+   :alt: Codecov coverage
+
+
+The homepage of joblib with user documentation is located on:
+
+https://joblib.readthedocs.io
+
+Getting the latest code
+=======================
+
+To get the latest code using git, simply type::
+
+    git clone https://github.com/joblib/joblib.git
+
+If you don't have git installed, you can download a zip
+of the latest code: https://github.com/joblib/joblib/archive/refs/heads/master.zip
+
+Installing
+==========
+
+You can use `pip` to install joblib::
+
+    pip install joblib
+
+from any directory or::
+
+    python setup.py install
+
+from the source directory.
+
+Dependencies
+============
+
+- Joblib has no mandatory dependencies besides Python (supported versions are
+  3.8+).
+- Joblib has an optional dependency on Numpy (at least version 1.6.1) for array
+  manipulation.
+- Joblib includes its own vendored copy of
+  `loky <https://github.com/tomMoral/loky>`_ for process management.
+- Joblib can efficiently dump and load numpy arrays but does not require numpy
+  to be installed.
+- Joblib has an optional dependency on
+  `python-lz4 <https://pypi.python.org/pypi/lz4>`_ as a faster alternative to
+  zlib and gzip for compressed serialization.
+- Joblib has an optional dependency on psutil to mitigate memory leaks in
+  parallel worker processes.
+- Some examples require external dependencies such as pandas. See the
+  instructions in the `Building the docs`_ section for details.
+
+Workflow to contribute
+======================
+
+To contribute to joblib, first create an account on `github
+<https://github.com/>`_. Once this is done, fork the `joblib repository
+<https://github.com/joblib/joblib>`_ to have your own repository,
+clone it using 'git clone' on the computers where you want to work. Make
+your changes in your clone, push them to your github account, test them
+on several computers, and when you are happy with them, send a pull
+request to the main repository.
+
+Running the test suite
+======================
+
+To run the test suite, you need the pytest (version >= 3) and coverage modules.
+Run the test suite using::
+
+    pytest joblib
+
+from the root of the project.
+
+Building the docs
+=================
+
+To build the docs you need to have sphinx (>=1.4) and some dependencies
+installed::
+
+    pip install -U -r .readthedocs-requirements.txt
+
+The docs can then be built with the following command::
+
+    make doc
+
+The html docs are located in the ``doc/_build/html`` directory.
+
+
+Making a source tarball
+=======================
+
+To create a source tarball, eg for packaging or distributing, run the
+following command::
+
+    python setup.py sdist
+
+The tarball will be created in the `dist` directory. This command will
+compile the docs, and the resulting tarball can be installed with
+no extra dependencies than the Python standard library. You will need
+setuptool and sphinx.
+
+Making a release and uploading it to PyPI
+=========================================
+
+This command is only run by project manager, to make a release, and
+upload in to PyPI::
+
+    python setup.py sdist bdist_wheel
+    twine upload dist/*
+
+
+Note that the documentation should automatically get updated at each git
+push. If that is not the case, try building th doc locally and resolve
+any doc build error (in particular when running the examples).
+
+Updating the changelog
+======================
+
+Changes are listed in the CHANGES.rst file. They must be manually updated
+but, the following git command may be used to generate the lines::
+
+    git log --abbrev-commit --date=short --no-merges --sparse
+
diff --git a/llm/Lib/site-packages/joblib-1.4.0.dist-info/RECORD b/llm/Lib/site-packages/joblib-1.4.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..254e0f46391d494cff88129f79bb2fbb15aeb9bb
--- /dev/null
+++ b/llm/Lib/site-packages/joblib-1.4.0.dist-info/RECORD
@@ -0,0 +1,217 @@
+joblib-1.4.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+joblib-1.4.0.dist-info/LICENSE.txt,sha256=QmEpEcGHLF5LQ_auDo7llGfNNQMyJBz3LOkGQCZPrmo,1527
+joblib-1.4.0.dist-info/METADATA,sha256=RvoJhBm8jAYOnpWDNhwlybOVwN5nFst_OYytoS6_xRQ,5370
+joblib-1.4.0.dist-info/RECORD,,
+joblib-1.4.0.dist-info/WHEEL,sha256=2wepM1nk4DS4eFpYrW1TTqPcoGNfHhhO_i5m4cOimbo,92
+joblib-1.4.0.dist-info/top_level.txt,sha256=P0LsoZ45gBL7ckL4lqQt7tdbrHD4xlVYhffmhHeeT_U,7
+joblib/__init__.py,sha256=ytsTJjbnDLtKYZ1il4QVYU8ReyTdKgKqd3zO_2FTv7Y,5132
+joblib/__pycache__/__init__.cpython-311.pyc,,
+joblib/__pycache__/_cloudpickle_wrapper.cpython-311.pyc,,
+joblib/__pycache__/_dask.cpython-311.pyc,,
+joblib/__pycache__/_memmapping_reducer.cpython-311.pyc,,
+joblib/__pycache__/_multiprocessing_helpers.cpython-311.pyc,,
+joblib/__pycache__/_parallel_backends.cpython-311.pyc,,
+joblib/__pycache__/_store_backends.cpython-311.pyc,,
+joblib/__pycache__/_utils.cpython-311.pyc,,
+joblib/__pycache__/backports.cpython-311.pyc,,
+joblib/__pycache__/compressor.cpython-311.pyc,,
+joblib/__pycache__/disk.cpython-311.pyc,,
+joblib/__pycache__/executor.cpython-311.pyc,,
+joblib/__pycache__/func_inspect.cpython-311.pyc,,
+joblib/__pycache__/hashing.cpython-311.pyc,,
+joblib/__pycache__/logger.cpython-311.pyc,,
+joblib/__pycache__/memory.cpython-311.pyc,,
+joblib/__pycache__/numpy_pickle.cpython-311.pyc,,
+joblib/__pycache__/numpy_pickle_compat.cpython-311.pyc,,
+joblib/__pycache__/numpy_pickle_utils.cpython-311.pyc,,
+joblib/__pycache__/parallel.cpython-311.pyc,,
+joblib/__pycache__/pool.cpython-311.pyc,,
+joblib/__pycache__/testing.cpython-311.pyc,,
+joblib/_cloudpickle_wrapper.py,sha256=-PBMUqgZCfd5EMaKn5FCQhWKiAJfbq4i2o6Z6KZ1ynE,417
+joblib/_dask.py,sha256=IhFjN6oMQVIcLC7bLHnA7KgO7nnEp7p6P4JH12934J4,13313
+joblib/_memmapping_reducer.py,sha256=4xclMWTgI5l-C6OFyt6FvamH-ToJu3DmopAXwt7a9F4,28092
+joblib/_multiprocessing_helpers.py,sha256=t7wIXfrLfzqFXjOeOYs4JP45tptxmYm5_yE8ylIRbR8,1925
+joblib/_parallel_backends.py,sha256=82qX4mJ5eHz4i0e5gbdHgvzST3P6LJ59hpfee0IyZCQ,25489
+joblib/_store_backends.py,sha256=PaoeHo4Mr7idPI3MvX766OqBQ_y_WkG_oZbE4MjbdKw,16683
+joblib/_utils.py,sha256=BBUs4ZHpDRxpgTsdrZSyBb39MqacM6JauI3dTRmnHm4,2076
+joblib/backports.py,sha256=aGh0cjs_xMhO2ym7RprpDjCBudiPtDhgD1vf5YMbMaI,5361
+joblib/compressor.py,sha256=WwRzsQhdQp0lbQvvEbAcaevCOCM2_Qyv_HJ4PVHtobQ,19768
+joblib/disk.py,sha256=PxUC63dBG2O1GriL1SLskHUjz7XzR-y6rqKEJHEY0jA,4389
+joblib/executor.py,sha256=PiaOwENhecRVnOdvHZLwGsr-RMKfk_F_Noy8y7nntJY,5136
+joblib/externals/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+joblib/externals/__pycache__/__init__.cpython-311.pyc,,
+joblib/externals/cloudpickle/__init__.py,sha256=vb2JCOn1EpLUdVyPe1ESyhLymcvh-Rk3ISHJ-52aDLw,308
+joblib/externals/cloudpickle/__pycache__/__init__.cpython-311.pyc,,
+joblib/externals/cloudpickle/__pycache__/cloudpickle.cpython-311.pyc,,
+joblib/externals/cloudpickle/__pycache__/cloudpickle_fast.cpython-311.pyc,,
+joblib/externals/cloudpickle/cloudpickle.py,sha256=APCGMuIfVpWcelGsLlo2zRmwKRloaoiznQEOAoEWH9Y,55283
+joblib/externals/cloudpickle/cloudpickle_fast.py,sha256=1GqUD4nLKsv0vv9ty2La3eVLyeWNrPFlhUCN-aNI-30,322
+joblib/externals/loky/__init__.py,sha256=T20hgxG9YPps-AhsElBMzIJD73q0h3x0Hys49alTvq8,1104
+joblib/externals/loky/__pycache__/__init__.cpython-311.pyc,,
+joblib/externals/loky/__pycache__/_base.cpython-311.pyc,,
+joblib/externals/loky/__pycache__/cloudpickle_wrapper.cpython-311.pyc,,
+joblib/externals/loky/__pycache__/initializers.cpython-311.pyc,,
+joblib/externals/loky/__pycache__/process_executor.cpython-311.pyc,,
+joblib/externals/loky/__pycache__/reusable_executor.cpython-311.pyc,,
+joblib/externals/loky/_base.py,sha256=LsQnEoKWKGhdeqGhMc68Aqwz4MrTnEs20KAYbFiUHzo,1057
+joblib/externals/loky/backend/__init__.py,sha256=Ix9KThV1CYk7-M5OQnJ_A_JrrrWJ-Jowa-HMMeGbp18,312
+joblib/externals/loky/backend/__pycache__/__init__.cpython-311.pyc,,
+joblib/externals/loky/backend/__pycache__/_posix_reduction.cpython-311.pyc,,
+joblib/externals/loky/backend/__pycache__/_win_reduction.cpython-311.pyc,,
+joblib/externals/loky/backend/__pycache__/context.cpython-311.pyc,,
+joblib/externals/loky/backend/__pycache__/fork_exec.cpython-311.pyc,,
+joblib/externals/loky/backend/__pycache__/popen_loky_posix.cpython-311.pyc,,
+joblib/externals/loky/backend/__pycache__/popen_loky_win32.cpython-311.pyc,,
+joblib/externals/loky/backend/__pycache__/process.cpython-311.pyc,,
+joblib/externals/loky/backend/__pycache__/queues.cpython-311.pyc,,
+joblib/externals/loky/backend/__pycache__/reduction.cpython-311.pyc,,
+joblib/externals/loky/backend/__pycache__/resource_tracker.cpython-311.pyc,,
+joblib/externals/loky/backend/__pycache__/spawn.cpython-311.pyc,,
+joblib/externals/loky/backend/__pycache__/synchronize.cpython-311.pyc,,
+joblib/externals/loky/backend/__pycache__/utils.cpython-311.pyc,,
+joblib/externals/loky/backend/_posix_reduction.py,sha256=xgCSrIaLI0k_MI0XNOBSp5e1ox1WN9idgrWbkWpMUr4,1776
+joblib/externals/loky/backend/_win_reduction.py,sha256=WmNB0NXtyJ_o_WzfPUEGh5dPhXIeI6FkEnFNXUxO2ws,683
+joblib/externals/loky/backend/context.py,sha256=GGBUGp4QDx1qvBuWDvyOSjNWYA79shxgAagsrcxA50E,13654
+joblib/externals/loky/backend/fork_exec.py,sha256=c3I22U_ewtT1T5Xn65SUXHrftspvllrGezGiv5KSRQY,1186
+joblib/externals/loky/backend/popen_loky_posix.py,sha256=ZFFs6H7Xp3CCQDE4oqmd_flWday6EdtlQ34Hkpa2PFQ,5580
+joblib/externals/loky/backend/popen_loky_win32.py,sha256=bYkhRA0w8qUcYFwoezeGwcnlCocEdheWXc6SZ-_rVxo,5325
+joblib/externals/loky/backend/process.py,sha256=4-Y94EoIrg4btsjTNxUBHAHhR96Nrugn_7_PGL6aU50,2018
+joblib/externals/loky/backend/queues.py,sha256=eETFvbPHwKfdoYyOgNQCyKq_Zlm-lzH3fwwpUIh-_4U,7322
+joblib/externals/loky/backend/reduction.py,sha256=CRu922R8xOxog2Snhop7y6fN1fPX9_h110brrICwZUE,7063
+joblib/externals/loky/backend/resource_tracker.py,sha256=421689XAmmxmNXktfkhNHNERIY3LbAcmWAsmRHPNUjg,14498
+joblib/externals/loky/backend/spawn.py,sha256=PVOHs8ou7IPcISb7t_Pp86FnUtPUw_KUAdxmDHOrAaU,8962
+joblib/externals/loky/backend/synchronize.py,sha256=nlDwBoLZB93m_l55qfZM_Ql-4L84PSYimoQqt5TzpDk,11768
+joblib/externals/loky/backend/utils.py,sha256=RVsxqyET4TJdbjc9uUHJmfhlQ2v4Uq-fiT_5b5rfC0s,5757
+joblib/externals/loky/cloudpickle_wrapper.py,sha256=9VfrXIfHiJcoXDqwgaHWbRsWipVA23oRJaxnXzSu7GM,3608
+joblib/externals/loky/initializers.py,sha256=dtKtRsJUmVwiJu0yZ-Ih0m8PvW_MxmouG7mShEcsStc,2567
+joblib/externals/loky/process_executor.py,sha256=eP5eVZFUsYPDhN91cxRHl23uEfqNWDeDQjrdNDB4c3o,51050
+joblib/externals/loky/reusable_executor.py,sha256=XVxLGMhCDij8CU6BDHbYKPxn8lG-rnqXaIfxO2nXGXg,10305
+joblib/func_inspect.py,sha256=Cwei03uwnZKJ9mbGmdCSjVGgq2_1lJNJSkeUn1GTvSo,14204
+joblib/hashing.py,sha256=4X9OOofkfDQr3N8NZKTsMOKWr8IiIV0kjBwqCUJCej4,10535
+joblib/logger.py,sha256=meT-hFPTZukfBRkeyCVCxhssPSr668_R5Nn25S-iXtc,5463
+joblib/memory.py,sha256=SDxiok3TiQOqy7Cd6A6yxrtWCZADWhMIiiWsBe97QRA,45990
+joblib/numpy_pickle.py,sha256=5_L7EbPg94T3iSODEdkikJNj_z2qvpZYaGei9HlMBWU,26886
+joblib/numpy_pickle_compat.py,sha256=U7zVNNF03an_7AgHOxhTxcOSbLJTWcGsnV_xbT3vRdY,8547
+joblib/numpy_pickle_utils.py,sha256=KccSp_MhMFsV41Mw9pSijchtGOCympDaHWH0VpIUeSs,8723
+joblib/parallel.py,sha256=foh2ez7ep8oIS5QInXU6qRSZ4xWWY_AeZjzDVDIOppc,84579
+joblib/pool.py,sha256=7jhFg7_qIuBbJ2URbKvyZtET9AxRKaYrYiBSes1VFxo,14411
+joblib/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+joblib/test/__pycache__/__init__.cpython-311.pyc,,
+joblib/test/__pycache__/common.cpython-311.pyc,,
+joblib/test/__pycache__/test_backports.cpython-311.pyc,,
+joblib/test/__pycache__/test_cloudpickle_wrapper.cpython-311.pyc,,
+joblib/test/__pycache__/test_config.cpython-311.pyc,,
+joblib/test/__pycache__/test_dask.cpython-311.pyc,,
+joblib/test/__pycache__/test_disk.cpython-311.pyc,,
+joblib/test/__pycache__/test_func_inspect.cpython-311.pyc,,
+joblib/test/__pycache__/test_func_inspect_special_encoding.cpython-311.pyc,,
+joblib/test/__pycache__/test_hashing.cpython-311.pyc,,
+joblib/test/__pycache__/test_init.cpython-311.pyc,,
+joblib/test/__pycache__/test_logger.cpython-311.pyc,,
+joblib/test/__pycache__/test_memmapping.cpython-311.pyc,,
+joblib/test/__pycache__/test_memory.cpython-311.pyc,,
+joblib/test/__pycache__/test_memory_async.cpython-311.pyc,,
+joblib/test/__pycache__/test_missing_multiprocessing.cpython-311.pyc,,
+joblib/test/__pycache__/test_module.cpython-311.pyc,,
+joblib/test/__pycache__/test_numpy_pickle.cpython-311.pyc,,
+joblib/test/__pycache__/test_numpy_pickle_compat.cpython-311.pyc,,
+joblib/test/__pycache__/test_numpy_pickle_utils.cpython-311.pyc,,
+joblib/test/__pycache__/test_parallel.cpython-311.pyc,,
+joblib/test/__pycache__/test_store_backends.cpython-311.pyc,,
+joblib/test/__pycache__/test_testing.cpython-311.pyc,,
+joblib/test/__pycache__/test_utils.cpython-311.pyc,,
+joblib/test/__pycache__/testutils.cpython-311.pyc,,
+joblib/test/common.py,sha256=seNB39WwHwu0qfMo6qeV7y0m6wxCcJ1B-Q1MWLvn4Vk,2336
+joblib/test/data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+joblib/test/data/__pycache__/__init__.cpython-311.pyc,,
+joblib/test/data/__pycache__/create_numpy_pickle.cpython-311.pyc,,
+joblib/test/data/create_numpy_pickle.py,sha256=BEaSv8dm3a48mvxl_Kf5ASwkkbGhwRplzNotTP4RCC0,3460
+joblib/test/data/joblib_0.10.0_compressed_pickle_py27_np16.gz,sha256=QYRH6Q2DSGVorjCSqWCxjTWCMOJKyew4Nl2qmfQVvQ8,769
+joblib/test/data/joblib_0.10.0_compressed_pickle_py27_np17.gz,sha256=ofTozM_KlPJa50TR8FCwc09mMmO6OO0GQhgUBLNIsXs,757
+joblib/test/data/joblib_0.10.0_compressed_pickle_py33_np18.gz,sha256=2eIVeA-XjOaT5IEQ6tI2UuHG3hwhiRciMmkBmPcIh4g,792
+joblib/test/data/joblib_0.10.0_compressed_pickle_py34_np19.gz,sha256=Gr2z_1tVWDH1H3_wCVHmakknf8KqeHKT8Yz4d1vmUCM,794
+joblib/test/data/joblib_0.10.0_compressed_pickle_py35_np19.gz,sha256=pWw_xuDbOkECqu1KGf1OFU7s2VbzC2v5F5iXhE7TwB4,790
+joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl,sha256=icRQjj374B-AHk5znxre0T9oWUHokoHIBQ8MqKo8l-U,986
+joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.bz2,sha256=oYQVIyMiUxyRgWSuBBSOvCWKzToA-kUpcoQWdV4UoV4,997
+joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.gzip,sha256=Jpv3iGcDgKTv-O4nZsUreIbUK7qnt2cugZ-VMgNeEDQ,798
+joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.lzma,sha256=c0wu0x8pPv4BcStj7pE61rZpf68FLG_pNzQZ4e82zH8,660
+joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.xz,sha256=77FG1FDG0GHQav-1bxc4Tn9ky6ubUW_MbE0_iGmz5wc,712
+joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl,sha256=4GTC7s_cWNVShERn2nvVbspZYJgyK_0man4TEqvdVzU,1068
+joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.bz2,sha256=6G1vbs_iYmz2kYJ6w4qB1k7D67UnxUMus0S4SWeBtFo,1000
+joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.gzip,sha256=tlRUWeJS1BXmcwtLNSNK9L0hDHekFl07CqWxTShinmY,831
+joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.lzma,sha256=CorPwnfv3rR5hjNtJI01-sEBMOnkSxNlRVaWTszMopA,694
+joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.xz,sha256=Dppj3MffOKsKETeptEtDaxPOv6MA6xnbpK5LzlDQ-oE,752
+joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl,sha256=HL5Fb1uR9aPLjjhoOPJ2wwM1Qyo1FCZoYYd2HVw0Fos,1068
+joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.bz2,sha256=Pyr2fqZnwfUxXdyrBr-kRwBYY8HA_Yi7fgSguKy5pUs,1021
+joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.gzip,sha256=os8NJjQI9FhnlZM-Ay9dX_Uo35gZnoJCgQSIVvcBPfE,831
+joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.lzma,sha256=Q_0y43qU7_GqAabJ8y3PWVhOisurnCAq3GzuCu04V58,697
+joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.xz,sha256=BNfmiQfpeLVpdfkwlJK4hJ5Cpgl0vreVyekyc5d_PNM,752
+joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl,sha256=l7nvLolhBDIdPFznOz3lBHiMOPBPCMi1bXop1tFSCpY,1068
+joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.bz2,sha256=pqGpuIS-ZU4uP8mkglHs8MaSDiVcPy7l3XHYJSppRgY,1005
+joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.gzip,sha256=YRFXE6LEb6qK72yPqnXdqQVY8Ts8xKUS9PWQKhLxWvk,833
+joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.lzma,sha256=Bf7gCUeTuTjCkbcIdyZYz69irblX4SAVQEzxCnMQhNU,701
+joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.xz,sha256=As8w2LGWwwNmKy3QNdKljK63Yq46gjRf_RJ0lh5_WqA,752
+joblib/test/data/joblib_0.11.0_compressed_pickle_py36_np111.gz,sha256=1WrnXDqDoNEPYOZX1Q5Wr2463b8vVV6fw4Wm5S4bMt4,800
+joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl,sha256=XmsOFxeC1f1aYdGETclG6yfF9rLoB11DayOAhDMULrw,1068
+joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.bz2,sha256=vI2yWb50LKL_NgZyd_XkoD5teIg93uI42mWnx9ee-AQ,991
+joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.gzip,sha256=1WrnXDqDoNEPYOZX1Q5Wr2463b8vVV6fw4Wm5S4bMt4,800
+joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.lzma,sha256=IWA0JlZG2ur53HgTUDl1m7q79dcVq6b0VOq33gKoJU0,715
+joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.xz,sha256=3Xh_NbMZdBjYx7ynfJ3Fyke28izSRSSzzNB0z5D4k9Y,752
+joblib/test/data/joblib_0.8.4_compressed_pickle_py27_np17.gz,sha256=Sp-ZT7i6pj5on2gbptszu7RarzJpOmHJ67UKOmCPQMg,659
+joblib/test/data/joblib_0.9.2_compressed_pickle_py27_np16.gz,sha256=NLtDrvo2XIH0KvUUAvhOqMeoXEjGW0IuTk_osu5XiDw,658
+joblib/test/data/joblib_0.9.2_compressed_pickle_py27_np17.gz,sha256=NLtDrvo2XIH0KvUUAvhOqMeoXEjGW0IuTk_osu5XiDw,658
+joblib/test/data/joblib_0.9.2_compressed_pickle_py34_np19.gz,sha256=nzO9iiGkG3KbBdrF3usOho8higkrDj_lmICUzxZyF_Y,673
+joblib/test/data/joblib_0.9.2_compressed_pickle_py35_np19.gz,sha256=nzO9iiGkG3KbBdrF3usOho8higkrDj_lmICUzxZyF_Y,673
+joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl,sha256=naijdk2xIeKdIa3mfJw0JlmOdtiN6uRM1yOJg6-M73M,670
+joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_01.npy,sha256=DvvX2c5-7DpuCg20HnleA5bMo9awN9rWxhtGSEPSiAk,120
+joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_02.npy,sha256=HBzzbLeB-8whuVO7CgtF3wktoOrg52WILlljzNcBBbE,120
+joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_03.npy,sha256=oMRa4qKJhBy-uiRDt-uqOzHAqencxzKUrKVynaAJJAU,236
+joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_04.npy,sha256=PsviRClLqT4IR5sWwbmpQR41af9mDtBFncodJBOB3wU,104
+joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl,sha256=LynX8dLOygfxDfFywOgm7wgWOhSxLG7z-oDsU6X83Dw,670
+joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_01.npy,sha256=DvvX2c5-7DpuCg20HnleA5bMo9awN9rWxhtGSEPSiAk,120
+joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_02.npy,sha256=HBzzbLeB-8whuVO7CgtF3wktoOrg52WILlljzNcBBbE,120
+joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_03.npy,sha256=oMRa4qKJhBy-uiRDt-uqOzHAqencxzKUrKVynaAJJAU,236
+joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_04.npy,sha256=PsviRClLqT4IR5sWwbmpQR41af9mDtBFncodJBOB3wU,104
+joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl,sha256=w9TLxpDTzp5TI6cU6lRvMsAasXEChcQgGE9s30sm_CU,691
+joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_01.npy,sha256=DvvX2c5-7DpuCg20HnleA5bMo9awN9rWxhtGSEPSiAk,120
+joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_02.npy,sha256=HBzzbLeB-8whuVO7CgtF3wktoOrg52WILlljzNcBBbE,120
+joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_03.npy,sha256=jt6aZKUrJdfbMJUJVsl47As5MrfRSs1avGMhbmS6vec,307
+joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_04.npy,sha256=PsviRClLqT4IR5sWwbmpQR41af9mDtBFncodJBOB3wU,104
+joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl,sha256=ilOBAOaulLFvKrD32S1NfnpiK-LfzA9rC3O2I7xROuI,691
+joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_01.npy,sha256=DvvX2c5-7DpuCg20HnleA5bMo9awN9rWxhtGSEPSiAk,120
+joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_02.npy,sha256=HBzzbLeB-8whuVO7CgtF3wktoOrg52WILlljzNcBBbE,120
+joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_03.npy,sha256=jt6aZKUrJdfbMJUJVsl47As5MrfRSs1avGMhbmS6vec,307
+joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_04.npy,sha256=PsviRClLqT4IR5sWwbmpQR41af9mDtBFncodJBOB3wU,104
+joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl,sha256=WfDVIqKcMzzh1gSAshIfzBoIpdLdZQuG79yYf5kfpOo,691
+joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_01.npy,sha256=DvvX2c5-7DpuCg20HnleA5bMo9awN9rWxhtGSEPSiAk,120
+joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_02.npy,sha256=HBzzbLeB-8whuVO7CgtF3wktoOrg52WILlljzNcBBbE,120
+joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_03.npy,sha256=jt6aZKUrJdfbMJUJVsl47As5MrfRSs1avGMhbmS6vec,307
+joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_04.npy,sha256=PsviRClLqT4IR5sWwbmpQR41af9mDtBFncodJBOB3wU,104
+joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz,sha256=8jYfWJsx0oY2J-3LlmEigK5cClnJSW2J2rfeSTZw-Ts,802
+joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz_01.npy.z,sha256=YT9VvT3sEl2uWlOyvH2CkyE9Sok4od9O3kWtgeuUUqE,43
+joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz_02.npy.z,sha256=txA5RDI0PRuiU_UNKY8pGp-zQgQQ9vaVvMi60hOPaVs,43
+joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz_03.npy.z,sha256=d3AwICvU2MpSNjh2aPIsdJeGZLlDjANAF1Soa6uM0Po,37
+joblib/test/test_backports.py,sha256=Y9bhGa6H-K_FgLkDyXaSHzpaWk148Rjn8R9IKCKdy-k,1175
+joblib/test/test_cloudpickle_wrapper.py,sha256=gc05MGe1LJfhCNTv02VdDXg8Z6FeJJ3rFTff1_WmMwc,751
+joblib/test/test_config.py,sha256=EvQKH7n4qXAcPd-BTnfu4duR6b5ag65xjaEjPMDM50w,5284
+joblib/test/test_dask.py,sha256=IIHdXXpH5NenurB6jem9rYisa_rP-usPyoPVaWzBEN0,18418
+joblib/test/test_disk.py,sha256=wJd1o9nLzqEjLqxxkgB9S7-UcKjHPQ8qK5l0czcNp0o,2205
+joblib/test/test_func_inspect.py,sha256=fyR9q1nGHwch5hD1hedut2YeN19hHDyUuDc8mXQuGeY,9488
+joblib/test/test_func_inspect_special_encoding.py,sha256=5xILDjSO-xtjQAMLvMeVD-L7IG4ZURb2gvBiShaDE78,145
+joblib/test/test_hashing.py,sha256=w8_WVgXL1TFueCSriX97GrCAS3mcmu5Ly062pOAOoRI,16054
+joblib/test/test_init.py,sha256=bgNF-9CIJl1MFNA75LBWOaiNtvduVfuvglz_u9Tt8Uc,422
+joblib/test/test_logger.py,sha256=CyA3E8Y74AHZfqJxetNrYfwXSOlLc1Pq1hqt7aJ6PwA,984
+joblib/test/test_memmapping.py,sha256=6kXT4ZMCtPykWhDf66QCcQvsdC9PaJumiCY0jHPwfio,43298
+joblib/test/test_memory.py,sha256=1dWfSPgMgdp2WdnY6lMILRdCbQ4v915DDOC_Q8d3WDE,49419
+joblib/test/test_memory_async.py,sha256=g-3Y09LqMccWR8Kw_yA0-yaduL-5zDBgaGUlgleOGDo,4807
+joblib/test/test_missing_multiprocessing.py,sha256=oeneMgi6iUVIbkfazGvXmOp6fqa7ok9uhj902Qjs_nk,1123
+joblib/test/test_module.py,sha256=HTHQSgnwa-1blkvhL_oVBO5yYdw8IrQTIJCK_QCsMtM,1936
+joblib/test/test_numpy_pickle.py,sha256=6rRMvj-9dgBVucPLY7J0qBIIcY2XOSQGh1owqOiGIrg,42485
+joblib/test/test_numpy_pickle_compat.py,sha256=o4mB8M6mVRX8Hxw-fxOmWPcbSAyswTdEHk64hVv_ZCk,609
+joblib/test/test_numpy_pickle_utils.py,sha256=-lQnhOAIGyd5oyWT2LGQPc3QO_Oxb3VhM_H3QjKm5e0,383
+joblib/test/test_parallel.py,sha256=fyvzDhsGADyjLoTy9Jycdketu1YZ1WyYtQCBIQ_YEso,73523
+joblib/test/test_store_backends.py,sha256=LCCUS9DN7feJniwnOD7x0pMKAQ-5rgCBBctwi5FhjWM,3121
+joblib/test/test_testing.py,sha256=1O5ZTJkdBjVkM-Ss4mComsEbJgrwROloVu8Mqv7Jv-w,2570
+joblib/test/test_utils.py,sha256=L6aBHiZrF6TUFbPGmQXGyNMnoAy5pEhOJoH5CAG_6CU,584
+joblib/test/testutils.py,sha256=6a7zVJm1kg6M-t4CH9tz8A6rMdC6ZY9sU6wBB8C7Zzo,251
+joblib/testing.py,sha256=6i2ctsokVXohLBhc1dXIZc2TiQDRiB-glGKFbfZDIqE,3093
diff --git a/llm/Lib/site-packages/joblib-1.4.0.dist-info/WHEEL b/llm/Lib/site-packages/joblib-1.4.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..57e3d840d59a650ac5bccbad5baeec47d155f0ad
--- /dev/null
+++ b/llm/Lib/site-packages/joblib-1.4.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.38.4)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/joblib-1.4.0.dist-info/top_level.txt b/llm/Lib/site-packages/joblib-1.4.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..ca4af27e2b6e9917d9600060588a18cc9e3cc78c
--- /dev/null
+++ b/llm/Lib/site-packages/joblib-1.4.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+joblib
diff --git a/llm/Lib/site-packages/joblib/__init__.py b/llm/Lib/site-packages/joblib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..962a43482801e803549c949ab274974742d969b7
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/__init__.py
@@ -0,0 +1,148 @@
+"""Joblib is a set of tools to provide **lightweight pipelining in
+Python**. In particular:
+
+1. transparent disk-caching of functions and lazy re-evaluation
+   (memoize pattern)
+
+2. easy simple parallel computing
+
+Joblib is optimized to be **fast** and **robust** on large
+data in particular and has specific optimizations for `numpy` arrays. It is
+**BSD-licensed**.
+
+
+    ==================== ===============================================
+    **Documentation:**       https://joblib.readthedocs.io
+
+    **Download:**            https://pypi.python.org/pypi/joblib#downloads
+
+    **Source code:**         https://github.com/joblib/joblib
+
+    **Report issues:**       https://github.com/joblib/joblib/issues
+    ==================== ===============================================
+
+
+Vision
+--------
+
+The vision is to provide tools to easily achieve better performance and
+reproducibility when working with long running jobs.
+
+ *  **Avoid computing the same thing twice**: code is often rerun again and
+    again, for instance when prototyping computational-heavy jobs (as in
+    scientific development), but hand-crafted solutions to alleviate this
+    issue are error-prone and often lead to unreproducible results.
+
+ *  **Persist to disk transparently**: efficiently persisting
+    arbitrary objects containing large data is hard. Using
+    joblib's caching mechanism avoids hand-written persistence and
+    implicitly links the file on disk to the execution context of
+    the original Python object. As a result, joblib's persistence is
+    good for resuming an application status or computational job, eg
+    after a crash.
+
+Joblib addresses these problems while **leaving your code and your flow
+control as unmodified as possible** (no framework, no new paradigms).
+
+Main features
+------------------
+
+1) **Transparent and fast disk-caching of output value:** a memoize or
+   make-like functionality for Python functions that works well for
+   arbitrary Python objects, including very large numpy arrays. Separate
+   persistence and flow-execution logic from domain logic or algorithmic
+   code by writing the operations as a set of steps with well-defined
+   inputs and  outputs: Python functions. Joblib can save their
+   computation to disk and rerun it only if necessary::
+
+      >>> from joblib import Memory
+      >>> cachedir = 'your_cache_dir_goes_here'
+      >>> mem = Memory(cachedir)
+      >>> import numpy as np
+      >>> a = np.vander(np.arange(3)).astype(float)
+      >>> square = mem.cache(np.square)
+      >>> b = square(a)                                   # doctest: +ELLIPSIS
+      ______________________________________________________________________...
+      [Memory] Calling square...
+      square(array([[0., 0., 1.],
+             [1., 1., 1.],
+             [4., 2., 1.]]))
+      _________________________________________________...square - ...s, 0.0min
+
+      >>> c = square(a)
+      >>> # The above call did not trigger an evaluation
+
+2) **Embarrassingly parallel helper:** to make it easy to write readable
+   parallel code and debug it quickly::
+
+      >>> from joblib import Parallel, delayed
+      >>> from math import sqrt
+      >>> Parallel(n_jobs=1)(delayed(sqrt)(i**2) for i in range(10))
+      [0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0]
+
+
+3) **Fast compressed Persistence**: a replacement for pickle to work
+   efficiently on Python objects containing large data (
+   *joblib.dump* & *joblib.load* ).
+
+..
+    >>> import shutil ; shutil.rmtree(cachedir)
+
+"""
+
+# PEP0440 compatible formatted version, see:
+# https://www.python.org/dev/peps/pep-0440/
+#
+# Generic release markers:
+# X.Y
+# X.Y.Z # For bugfix releases
+#
+# Admissible pre-release markers:
+# X.YaN # Alpha release
+# X.YbN # Beta release
+# X.YrcN # Release Candidate
+# X.Y # Final release
+#
+# Dev branch marker is: 'X.Y.dev' or 'X.Y.devN' where N is an integer.
+# 'X.Y.dev0' is the canonical version of 'X.Y.dev'
+#
+__version__ = '1.4.0'
+
+
+import os
+
+from .memory import Memory
+from .memory import MemorizedResult
+from .memory import register_store_backend
+from .memory import expires_after
+
+from .logger import PrintTime
+from .logger import Logger
+
+from .hashing import hash
+
+from .numpy_pickle import dump
+from .numpy_pickle import load
+
+from .compressor import register_compressor
+
+from .parallel import Parallel
+from .parallel import delayed
+from .parallel import cpu_count
+from .parallel import register_parallel_backend
+from .parallel import parallel_backend
+from .parallel import parallel_config
+from .parallel import effective_n_jobs
+from ._cloudpickle_wrapper import wrap_non_picklable_objects
+
+
+__all__ = ['Memory', 'MemorizedResult', 'PrintTime', 'Logger', 'hash', 'dump',
+           'load', 'Parallel', 'delayed', 'cpu_count', 'effective_n_jobs',
+           'register_parallel_backend', 'parallel_backend', 'expires_after',
+           'register_store_backend', 'register_compressor',
+           'wrap_non_picklable_objects', 'parallel_config']
+
+
+# Workaround issue discovered in intel-openmp 2019.5:
+# https://github.com/ContinuumIO/anaconda-issues/issues/11294
+os.environ.setdefault("KMP_INIT_AT_FORK", "FALSE")
diff --git a/llm/Lib/site-packages/joblib/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d436e118be31b8d62c8e4b0607ff787da0f29cfc
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/_cloudpickle_wrapper.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/_cloudpickle_wrapper.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9cfed8d767ca0fbf311d05f538041ffbd3848d00
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/_cloudpickle_wrapper.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/_dask.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/_dask.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f51e4c7e7488df158f9cb5592383c5a301ba1c78
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/_dask.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/_memmapping_reducer.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/_memmapping_reducer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..19e25a9f956baee8eccb345bd3da4b3a4050afc0
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/_memmapping_reducer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/_multiprocessing_helpers.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/_multiprocessing_helpers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..90f03fead34acc78cd45e259d9a1b823cee05d8e
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/_multiprocessing_helpers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/_parallel_backends.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/_parallel_backends.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a7f673cc286ad06884e1de02255e363d08de16ce
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/_parallel_backends.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/_store_backends.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/_store_backends.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..65066f02e800f5d547fcce5397c2322424189ce3
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/_store_backends.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/_utils.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8698702858dcb329b3872fb53c2ae3c56ab0b00c
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/backports.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/backports.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ff2a6adac15e75f130696d9fe0bf2aedbbe59891
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/backports.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/compressor.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/compressor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..965c1ea9e7d92c158c25971ba9c9b7f3cc81165a
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/compressor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/disk.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/disk.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7694d986afb1568413d8b75d187f5010dc5f739b
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/disk.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/executor.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/executor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..80cbfb410dd4eb8fff4e03f635980c8ecc361d8a
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/executor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/func_inspect.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/func_inspect.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c2b88b143781cff8d07c1674381175e44ea7177e
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/func_inspect.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/hashing.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/hashing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..92d7d4d823faeb1b3752aca6281e378817ea4898
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/hashing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/logger.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/logger.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..31e3249648e26a39db01e549486c3fd5792642a8
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/logger.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/memory.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..49a9ed0c03dc3722f537aea961cc6505996b16de
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/numpy_pickle.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/numpy_pickle.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..782b909611f12d7e726f49e46ca8f6ec47707171
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/numpy_pickle.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/numpy_pickle_compat.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/numpy_pickle_compat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..572236a42b4e576004f4aff0a4b5e159896a9978
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/numpy_pickle_compat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/numpy_pickle_utils.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/numpy_pickle_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..88970c0cc7140229eed86193ab8fc7740b8f8efb
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/numpy_pickle_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/parallel.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/parallel.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..893b0d31792bc596169e33df897f8ee8041076fd
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/parallel.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/pool.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/pool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7ae5178f782c59e6ff5cacaf728c11ac168d8c5a
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/pool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/__pycache__/testing.cpython-311.pyc b/llm/Lib/site-packages/joblib/__pycache__/testing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..58e96f47a0278b2acdce5682d2ae22078acf7a45
Binary files /dev/null and b/llm/Lib/site-packages/joblib/__pycache__/testing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/_cloudpickle_wrapper.py b/llm/Lib/site-packages/joblib/_cloudpickle_wrapper.py
new file mode 100644
index 0000000000000000000000000000000000000000..daf899d04ff513e1ce9c9c41871adcfd72c8fcf7
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/_cloudpickle_wrapper.py
@@ -0,0 +1,19 @@
+"""
+Small shim of loky's cloudpickle_wrapper to avoid failure when
+multiprocessing is not available.
+"""
+
+
+from ._multiprocessing_helpers import mp
+
+
+def _my_wrap_non_picklable_objects(obj, keep_wrapper=True):
+    return obj
+
+
+if mp is not None:
+    from .externals.loky import wrap_non_picklable_objects
+else:
+    wrap_non_picklable_objects = _my_wrap_non_picklable_objects
+
+__all__ = ["wrap_non_picklable_objects"]
diff --git a/llm/Lib/site-packages/joblib/_dask.py b/llm/Lib/site-packages/joblib/_dask.py
new file mode 100644
index 0000000000000000000000000000000000000000..4288ed05cd9290a1db19044ea9ceb4ec28974082
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/_dask.py
@@ -0,0 +1,379 @@
+from __future__ import print_function, division, absolute_import
+
+import asyncio
+import concurrent.futures
+import contextlib
+
+import time
+from uuid import uuid4
+import weakref
+
+from .parallel import parallel_config
+from .parallel import AutoBatchingMixin, ParallelBackendBase
+
+from ._utils import (
+    _TracebackCapturingWrapper,
+    _retrieve_traceback_capturing_wrapped_call
+)
+
+try:
+    import dask
+    import distributed
+except ImportError:
+    dask = None
+    distributed = None
+
+if dask is not None and distributed is not None:
+    from dask.utils import funcname
+    from dask.sizeof import sizeof
+    from dask.distributed import (
+        Client,
+        as_completed,
+        get_client,
+        secede,
+        rejoin,
+    )
+    from distributed.utils import thread_state
+
+    try:
+        # asyncio.TimeoutError, Python3-only error thrown by recent versions of
+        # distributed
+        from distributed.utils import TimeoutError as _TimeoutError
+    except ImportError:
+        from tornado.gen import TimeoutError as _TimeoutError
+
+
+def is_weakrefable(obj):
+    try:
+        weakref.ref(obj)
+        return True
+    except TypeError:
+        return False
+
+
+class _WeakKeyDictionary:
+    """A variant of weakref.WeakKeyDictionary for unhashable objects.
+
+    This datastructure is used to store futures for broadcasted data objects
+    such as large numpy arrays or pandas dataframes that are not hashable and
+    therefore cannot be used as keys of traditional python dicts.
+
+    Furthermore using a dict with id(array) as key is not safe because the
+    Python is likely to reuse id of recently collected arrays.
+    """
+
+    def __init__(self):
+        self._data = {}
+
+    def __getitem__(self, obj):
+        ref, val = self._data[id(obj)]
+        if ref() is not obj:
+            # In case of a race condition with on_destroy.
+            raise KeyError(obj)
+        return val
+
+    def __setitem__(self, obj, value):
+        key = id(obj)
+        try:
+            ref, _ = self._data[key]
+            if ref() is not obj:
+                # In case of race condition with on_destroy.
+                raise KeyError(obj)
+        except KeyError:
+            # Insert the new entry in the mapping along with a weakref
+            # callback to automatically delete the entry from the mapping
+            # as soon as the object used as key is garbage collected.
+            def on_destroy(_):
+                del self._data[key]
+            ref = weakref.ref(obj, on_destroy)
+        self._data[key] = ref, value
+
+    def __len__(self):
+        return len(self._data)
+
+    def clear(self):
+        self._data.clear()
+
+
+def _funcname(x):
+    try:
+        if isinstance(x, list):
+            x = x[0][0]
+    except Exception:
+        pass
+    return funcname(x)
+
+
+def _make_tasks_summary(tasks):
+    """Summarize of list of (func, args, kwargs) function calls"""
+    unique_funcs = {func for func, args, kwargs in tasks}
+
+    if len(unique_funcs) == 1:
+        mixed = False
+    else:
+        mixed = True
+    return len(tasks), mixed, _funcname(tasks)
+
+
+class Batch:
+    """dask-compatible wrapper that executes a batch of tasks"""
+    def __init__(self, tasks):
+        # collect some metadata from the tasks to ease Batch calls
+        # introspection when debugging
+        self._num_tasks, self._mixed, self._funcname = _make_tasks_summary(
+            tasks
+        )
+
+    def __call__(self, tasks=None):
+        results = []
+        with parallel_config(backend='dask'):
+            for func, args, kwargs in tasks:
+                results.append(func(*args, **kwargs))
+            return results
+
+    def __repr__(self):
+        descr = f"batch_of_{self._funcname}_{self._num_tasks}_calls"
+        if self._mixed:
+            descr = "mixed_" + descr
+        return descr
+
+
+def _joblib_probe_task():
+    # Noop used by the joblib connector to probe when workers are ready.
+    pass
+
+
+class DaskDistributedBackend(AutoBatchingMixin, ParallelBackendBase):
+    MIN_IDEAL_BATCH_DURATION = 0.2
+    MAX_IDEAL_BATCH_DURATION = 1.0
+    supports_retrieve_callback = True
+    default_n_jobs = -1
+
+    def __init__(self, scheduler_host=None, scatter=None,
+                 client=None, loop=None, wait_for_workers_timeout=10,
+                 **submit_kwargs):
+        super().__init__()
+
+        if distributed is None:
+            msg = ("You are trying to use 'dask' as a joblib parallel backend "
+                   "but dask is not installed. Please install dask "
+                   "to fix this error.")
+            raise ValueError(msg)
+
+        if client is None:
+            if scheduler_host:
+                client = Client(scheduler_host, loop=loop,
+                                set_as_default=False)
+            else:
+                try:
+                    client = get_client()
+                except ValueError as e:
+                    msg = ("To use Joblib with Dask first create a Dask Client"
+                           "\n\n"
+                           "    from dask.distributed import Client\n"
+                           "    client = Client()\n"
+                           "or\n"
+                           "    client = Client('scheduler-address:8786')")
+                    raise ValueError(msg) from e
+
+        self.client = client
+
+        if scatter is not None and not isinstance(scatter, (list, tuple)):
+            raise TypeError("scatter must be a list/tuple, got "
+                            "`%s`" % type(scatter).__name__)
+
+        if scatter is not None and len(scatter) > 0:
+            # Keep a reference to the scattered data to keep the ids the same
+            self._scatter = list(scatter)
+            scattered = self.client.scatter(scatter, broadcast=True)
+            self.data_futures = {id(x): f for x, f in zip(scatter, scattered)}
+        else:
+            self._scatter = []
+            self.data_futures = {}
+        self.wait_for_workers_timeout = wait_for_workers_timeout
+        self.submit_kwargs = submit_kwargs
+        self.waiting_futures = as_completed(
+            [],
+            loop=client.loop,
+            with_results=True,
+            raise_errors=False
+        )
+        self._results = {}
+        self._callbacks = {}
+
+    async def _collect(self):
+        while self._continue:
+            async for future, result in self.waiting_futures:
+                cf_future = self._results.pop(future)
+                callback = self._callbacks.pop(future)
+                if future.status == "error":
+                    typ, exc, tb = result
+                    cf_future.set_exception(exc)
+                else:
+                    cf_future.set_result(result)
+                    callback(result)
+            await asyncio.sleep(0.01)
+
+    def __reduce__(self):
+        return (DaskDistributedBackend, ())
+
+    def get_nested_backend(self):
+        return DaskDistributedBackend(client=self.client), -1
+
+    def configure(self, n_jobs=1, parallel=None, **backend_args):
+        self.parallel = parallel
+        return self.effective_n_jobs(n_jobs)
+
+    def start_call(self):
+        self._continue = True
+        self.client.loop.add_callback(self._collect)
+        self.call_data_futures = _WeakKeyDictionary()
+
+    def stop_call(self):
+        # The explicit call to clear is required to break a cycling reference
+        # to the futures.
+        self._continue = False
+        # wait for the future collection routine (self._backend._collect) to
+        # finish in order to limit asyncio warnings due to aborting _collect
+        # during a following backend termination call
+        time.sleep(0.01)
+        self.call_data_futures.clear()
+
+    def effective_n_jobs(self, n_jobs):
+        effective_n_jobs = sum(self.client.ncores().values())
+        if effective_n_jobs != 0 or not self.wait_for_workers_timeout:
+            return effective_n_jobs
+
+        # If there is no worker, schedule a probe task to wait for the workers
+        # to come up and be available. If the dask cluster is in adaptive mode
+        # task might cause the cluster to provision some workers.
+        try:
+            self.client.submit(_joblib_probe_task).result(
+                timeout=self.wait_for_workers_timeout
+            )
+        except _TimeoutError as e:
+            error_msg = (
+                "DaskDistributedBackend has no worker after {} seconds. "
+                "Make sure that workers are started and can properly connect "
+                "to the scheduler and increase the joblib/dask connection "
+                "timeout with:\n\n"
+                "parallel_config(backend='dask', wait_for_workers_timeout={})"
+            ).format(self.wait_for_workers_timeout,
+                     max(10, 2 * self.wait_for_workers_timeout))
+            raise TimeoutError(error_msg) from e
+        return sum(self.client.ncores().values())
+
+    async def _to_func_args(self, func):
+        itemgetters = dict()
+
+        # Futures that are dynamically generated during a single call to
+        # Parallel.__call__.
+        call_data_futures = getattr(self, 'call_data_futures', None)
+
+        async def maybe_to_futures(args):
+            out = []
+            for arg in args:
+                arg_id = id(arg)
+                if arg_id in itemgetters:
+                    out.append(itemgetters[arg_id])
+                    continue
+
+                f = self.data_futures.get(arg_id, None)
+                if f is None and call_data_futures is not None:
+                    try:
+                        f = await call_data_futures[arg]
+                    except KeyError:
+                        pass
+                    if f is None:
+                        if is_weakrefable(arg) and sizeof(arg) > 1e3:
+                            # Automatically scatter large objects to some of
+                            # the workers to avoid duplicated data transfers.
+                            # Rely on automated inter-worker data stealing if
+                            # more workers need to reuse this data
+                            # concurrently.
+                            # set hash=False - nested scatter calls (i.e
+                            # calling client.scatter inside a dask worker)
+                            # using hash=True often raise CancelledError,
+                            # see dask/distributed#3703
+                            _coro = self.client.scatter(
+                                arg,
+                                asynchronous=True,
+                                hash=False
+                            )
+                            # Centralize the scattering of identical arguments
+                            # between concurrent apply_async callbacks by
+                            # exposing the running coroutine in
+                            # call_data_futures before it completes.
+                            t = asyncio.Task(_coro)
+                            call_data_futures[arg] = t
+
+                            f = await t
+
+                if f is not None:
+                    out.append(f)
+                else:
+                    out.append(arg)
+            return out
+
+        tasks = []
+        for f, args, kwargs in func.items:
+            args = list(await maybe_to_futures(args))
+            kwargs = dict(zip(kwargs.keys(),
+                              await maybe_to_futures(kwargs.values())))
+            tasks.append((f, args, kwargs))
+
+        return (Batch(tasks), tasks)
+
+    def apply_async(self, func, callback=None):
+
+        cf_future = concurrent.futures.Future()
+        cf_future.get = cf_future.result  # achieve AsyncResult API
+
+        async def f(func, callback):
+            batch, tasks = await self._to_func_args(func)
+            key = f'{repr(batch)}-{uuid4().hex}'
+
+            dask_future = self.client.submit(
+                _TracebackCapturingWrapper(batch),
+                tasks=tasks,
+                key=key,
+                **self.submit_kwargs
+            )
+            self.waiting_futures.add(dask_future)
+            self._callbacks[dask_future] = callback
+            self._results[dask_future] = cf_future
+
+        self.client.loop.add_callback(f, func, callback)
+
+        return cf_future
+
+    def retrieve_result_callback(self, out):
+        return _retrieve_traceback_capturing_wrapped_call(out)
+
+    def abort_everything(self, ensure_ready=True):
+        """ Tell the client to cancel any task submitted via this instance
+
+        joblib.Parallel will never access those results
+        """
+        with self.waiting_futures.lock:
+            self.waiting_futures.futures.clear()
+            while not self.waiting_futures.queue.empty():
+                self.waiting_futures.queue.get()
+
+    @contextlib.contextmanager
+    def retrieval_context(self):
+        """Override ParallelBackendBase.retrieval_context to avoid deadlocks.
+
+        This removes thread from the worker's thread pool (using 'secede').
+        Seceding avoids deadlock in nested parallelism settings.
+        """
+        # See 'joblib.Parallel.__call__' and 'joblib.Parallel.retrieve' for how
+        # this is used.
+        if hasattr(thread_state, 'execution_state'):
+            # we are in a worker. Secede to avoid deadlock.
+            secede()
+
+        yield
+
+        if hasattr(thread_state, 'execution_state'):
+            rejoin()
diff --git a/llm/Lib/site-packages/joblib/_memmapping_reducer.py b/llm/Lib/site-packages/joblib/_memmapping_reducer.py
new file mode 100644
index 0000000000000000000000000000000000000000..13f5c4a17ef0794dc965ca3e3a3ef216125e2946
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/_memmapping_reducer.py
@@ -0,0 +1,657 @@
+"""
+Reducer using memory mapping for numpy arrays
+"""
+# Author: Thomas Moreau <thomas.moreau.2010@gmail.com>
+# Copyright: 2017, Thomas Moreau
+# License: BSD 3 clause
+
+from mmap import mmap
+import errno
+import os
+import stat
+import threading
+import atexit
+import tempfile
+import time
+import warnings
+import weakref
+from uuid import uuid4
+from multiprocessing import util
+
+from pickle import whichmodule, loads, dumps, HIGHEST_PROTOCOL, PicklingError
+
+try:
+    WindowsError
+except NameError:
+    WindowsError = type(None)
+
+try:
+    import numpy as np
+    from numpy.lib.stride_tricks import as_strided
+except ImportError:
+    np = None
+
+from .numpy_pickle import dump, load, load_temporary_memmap
+from .backports import make_memmap
+from .disk import delete_folder
+from .externals.loky.backend import resource_tracker
+
+# Some system have a ramdisk mounted by default, we can use it instead of /tmp
+# as the default folder to dump big arrays to share with subprocesses.
+SYSTEM_SHARED_MEM_FS = '/dev/shm'
+
+# Minimal number of bytes available on SYSTEM_SHARED_MEM_FS to consider using
+# it as the default folder to dump big arrays to share with subprocesses.
+SYSTEM_SHARED_MEM_FS_MIN_SIZE = int(2e9)
+
+# Folder and file permissions to chmod temporary files generated by the
+# memmapping pool. Only the owner of the Python process can access the
+# temporary files and folder.
+FOLDER_PERMISSIONS = stat.S_IRUSR | stat.S_IWUSR | stat.S_IXUSR
+FILE_PERMISSIONS = stat.S_IRUSR | stat.S_IWUSR
+
+# Set used in joblib workers, referencing the filenames of temporary memmaps
+# created by joblib to speed up data communication. In child processes, we add
+# a finalizer to these memmaps that sends a maybe_unlink call to the
+# resource_tracker, in order to free main memory as fast as possible.
+JOBLIB_MMAPS = set()
+
+
+def _log_and_unlink(filename):
+    from .externals.loky.backend.resource_tracker import _resource_tracker
+    util.debug(
+        "[FINALIZER CALL] object mapping to {} about to be deleted,"
+        " decrementing the refcount of the file (pid: {})".format(
+            os.path.basename(filename), os.getpid()))
+    _resource_tracker.maybe_unlink(filename, "file")
+
+
+def add_maybe_unlink_finalizer(memmap):
+    util.debug(
+        "[FINALIZER ADD] adding finalizer to {} (id {}, filename {}, pid  {})"
+        "".format(type(memmap), id(memmap), os.path.basename(memmap.filename),
+                  os.getpid()))
+    weakref.finalize(memmap, _log_and_unlink, memmap.filename)
+
+
+def unlink_file(filename):
+    """Wrapper around os.unlink with a retry mechanism.
+
+    The retry mechanism has been implemented primarily to overcome a race
+    condition happening during the finalizer of a np.memmap: when a process
+    holding the last reference to a mmap-backed np.memmap/np.array is about to
+    delete this array (and close the reference), it sends a maybe_unlink
+    request to the resource_tracker. This request can be processed faster than
+    it takes for the last reference of the memmap to be closed, yielding (on
+    Windows) a PermissionError in the resource_tracker loop.
+    """
+    NUM_RETRIES = 10
+    for retry_no in range(1, NUM_RETRIES + 1):
+        try:
+            os.unlink(filename)
+            break
+        except PermissionError:
+            util.debug(
+                '[ResourceTracker] tried to unlink {}, got '
+                'PermissionError'.format(filename)
+            )
+            if retry_no == NUM_RETRIES:
+                raise
+            else:
+                time.sleep(.2)
+        except FileNotFoundError:
+            # In case of a race condition when deleting the temporary folder,
+            # avoid noisy FileNotFoundError exception in the resource tracker.
+            pass
+
+
+resource_tracker._CLEANUP_FUNCS['file'] = unlink_file
+
+
+class _WeakArrayKeyMap:
+    """A variant of weakref.WeakKeyDictionary for unhashable numpy arrays.
+
+    This datastructure will be used with numpy arrays as obj keys, therefore we
+    do not use the __get__ / __set__ methods to avoid any conflict with the
+    numpy fancy indexing syntax.
+    """
+
+    def __init__(self):
+        self._data = {}
+
+    def get(self, obj):
+        ref, val = self._data[id(obj)]
+        if ref() is not obj:
+            # In case of race condition with on_destroy: could never be
+            # triggered by the joblib tests with CPython.
+            raise KeyError(obj)
+        return val
+
+    def set(self, obj, value):
+        key = id(obj)
+        try:
+            ref, _ = self._data[key]
+            if ref() is not obj:
+                # In case of race condition with on_destroy: could never be
+                # triggered by the joblib tests with CPython.
+                raise KeyError(obj)
+        except KeyError:
+            # Insert the new entry in the mapping along with a weakref
+            # callback to automatically delete the entry from the mapping
+            # as soon as the object used as key is garbage collected.
+            def on_destroy(_):
+                del self._data[key]
+            ref = weakref.ref(obj, on_destroy)
+        self._data[key] = ref, value
+
+    def __getstate__(self):
+        raise PicklingError("_WeakArrayKeyMap is not pickleable")
+
+
+###############################################################################
+# Support for efficient transient pickling of numpy data structures
+
+
+def _get_backing_memmap(a):
+    """Recursively look up the original np.memmap instance base if any."""
+    b = getattr(a, 'base', None)
+    if b is None:
+        # TODO: check scipy sparse datastructure if scipy is installed
+        # a nor its descendants do not have a memmap base
+        return None
+
+    elif isinstance(b, mmap):
+        # a is already a real memmap instance.
+        return a
+
+    else:
+        # Recursive exploration of the base ancestry
+        return _get_backing_memmap(b)
+
+
+def _get_temp_dir(pool_folder_name, temp_folder=None):
+    """Get the full path to a subfolder inside the temporary folder.
+
+    Parameters
+    ----------
+    pool_folder_name : str
+        Sub-folder name used for the serialization of a pool instance.
+
+    temp_folder: str, optional
+        Folder to be used by the pool for memmapping large arrays
+        for sharing memory with worker processes. If None, this will try in
+        order:
+
+        - a folder pointed by the JOBLIB_TEMP_FOLDER environment
+          variable,
+        - /dev/shm if the folder exists and is writable: this is a
+          RAMdisk filesystem available by default on modern Linux
+          distributions,
+        - the default system temporary folder that can be
+          overridden with TMP, TMPDIR or TEMP environment
+          variables, typically /tmp under Unix operating systems.
+
+    Returns
+    -------
+    pool_folder : str
+       full path to the temporary folder
+    use_shared_mem : bool
+       whether the temporary folder is written to the system shared memory
+       folder or some other temporary folder.
+    """
+    use_shared_mem = False
+    if temp_folder is None:
+        temp_folder = os.environ.get('JOBLIB_TEMP_FOLDER', None)
+    if temp_folder is None:
+        if os.path.exists(SYSTEM_SHARED_MEM_FS) and hasattr(os, 'statvfs'):
+            try:
+                shm_stats = os.statvfs(SYSTEM_SHARED_MEM_FS)
+                available_nbytes = shm_stats.f_bsize * shm_stats.f_bavail
+                if available_nbytes > SYSTEM_SHARED_MEM_FS_MIN_SIZE:
+                    # Try to see if we have write access to the shared mem
+                    # folder only if it is reasonably large (that is 2GB or
+                    # more).
+                    temp_folder = SYSTEM_SHARED_MEM_FS
+                    pool_folder = os.path.join(temp_folder, pool_folder_name)
+                    if not os.path.exists(pool_folder):
+                        os.makedirs(pool_folder)
+                    use_shared_mem = True
+            except (IOError, OSError):
+                # Missing rights in the /dev/shm partition, fallback to regular
+                # temp folder.
+                temp_folder = None
+    if temp_folder is None:
+        # Fallback to the default tmp folder, typically /tmp
+        temp_folder = tempfile.gettempdir()
+    temp_folder = os.path.abspath(os.path.expanduser(temp_folder))
+    pool_folder = os.path.join(temp_folder, pool_folder_name)
+    return pool_folder, use_shared_mem
+
+
+def has_shareable_memory(a):
+    """Return True if a is backed by some mmap buffer directly or not."""
+    return _get_backing_memmap(a) is not None
+
+
+def _strided_from_memmap(filename, dtype, mode, offset, order, shape, strides,
+                         total_buffer_len, unlink_on_gc_collect):
+    """Reconstruct an array view on a memory mapped file."""
+    if mode == 'w+':
+        # Do not zero the original data when unpickling
+        mode = 'r+'
+
+    if strides is None:
+        # Simple, contiguous memmap
+        return make_memmap(
+            filename, dtype=dtype, shape=shape, mode=mode, offset=offset,
+            order=order, unlink_on_gc_collect=unlink_on_gc_collect
+        )
+    else:
+        # For non-contiguous data, memmap the total enclosing buffer and then
+        # extract the non-contiguous view with the stride-tricks API
+        base = make_memmap(
+            filename, dtype=dtype, shape=total_buffer_len, offset=offset,
+            mode=mode, order=order, unlink_on_gc_collect=unlink_on_gc_collect
+        )
+        return as_strided(base, shape=shape, strides=strides)
+
+
+def _reduce_memmap_backed(a, m):
+    """Pickling reduction for memmap backed arrays.
+
+    a is expected to be an instance of np.ndarray (or np.memmap)
+    m is expected to be an instance of np.memmap on the top of the ``base``
+    attribute ancestry of a. ``m.base`` should be the real python mmap object.
+    """
+    # offset that comes from the striding differences between a and m
+    util.debug('[MEMMAP REDUCE] reducing a memmap-backed array '
+               '(shape, {}, pid: {})'.format(a.shape, os.getpid()))
+    try:
+        from numpy.lib.array_utils import byte_bounds
+    except (ModuleNotFoundError, ImportError):
+        # Backward-compat for numpy < 2.0
+        from numpy import byte_bounds
+    a_start, a_end = byte_bounds(a)
+    m_start = byte_bounds(m)[0]
+    offset = a_start - m_start
+
+    # offset from the backing memmap
+    offset += m.offset
+
+    if m.flags['F_CONTIGUOUS']:
+        order = 'F'
+    else:
+        # The backing memmap buffer is necessarily contiguous hence C if not
+        # Fortran
+        order = 'C'
+
+    if a.flags['F_CONTIGUOUS'] or a.flags['C_CONTIGUOUS']:
+        # If the array is a contiguous view, no need to pass the strides
+        strides = None
+        total_buffer_len = None
+    else:
+        # Compute the total number of items to map from which the strided
+        # view will be extracted.
+        strides = a.strides
+        total_buffer_len = (a_end - a_start) // a.itemsize
+
+    return (_strided_from_memmap,
+            (m.filename, a.dtype, m.mode, offset, order, a.shape, strides,
+             total_buffer_len, False))
+
+
+def reduce_array_memmap_backward(a):
+    """reduce a np.array or a np.memmap from a child process"""
+    m = _get_backing_memmap(a)
+    if isinstance(m, np.memmap) and m.filename not in JOBLIB_MMAPS:
+        # if a is backed by a memmaped file, reconstruct a using the
+        # memmaped file.
+        return _reduce_memmap_backed(a, m)
+    else:
+        # a is either a regular (not memmap-backed) numpy array, or an array
+        # backed by a shared temporary file created by joblib. In the latter
+        # case, in order to limit the lifespan of these temporary files, we
+        # serialize the memmap as a regular numpy array, and decref the
+        # file backing the memmap (done implicitly in a previously registered
+        # finalizer, see ``unlink_on_gc_collect`` for more details)
+        return (
+            loads, (dumps(np.asarray(a), protocol=HIGHEST_PROTOCOL), )
+        )
+
+
+class ArrayMemmapForwardReducer(object):
+    """Reducer callable to dump large arrays to memmap files.
+
+    Parameters
+    ----------
+    max_nbytes: int
+        Threshold to trigger memmapping of large arrays to files created
+        a folder.
+    temp_folder_resolver: callable
+        An callable in charge of resolving a temporary folder name where files
+        for backing memmapped arrays are created.
+    mmap_mode: 'r', 'r+' or 'c'
+        Mode for the created memmap datastructure. See the documentation of
+        numpy.memmap for more details. Note: 'w+' is coerced to 'r+'
+        automatically to avoid zeroing the data on unpickling.
+    verbose: int, optional, 0 by default
+        If verbose > 0, memmap creations are logged.
+        If verbose > 1, both memmap creations, reuse and array pickling are
+        logged.
+    prewarm: bool, optional, False by default.
+        Force a read on newly memmapped array to make sure that OS pre-cache it
+        memory. This can be useful to avoid concurrent disk access when the
+        same data array is passed to different worker processes.
+    """
+
+    def __init__(self, max_nbytes, temp_folder_resolver, mmap_mode,
+                 unlink_on_gc_collect, verbose=0, prewarm=True):
+        self._max_nbytes = max_nbytes
+        self._temp_folder_resolver = temp_folder_resolver
+        self._mmap_mode = mmap_mode
+        self.verbose = int(verbose)
+        if prewarm == "auto":
+            self._prewarm = not self._temp_folder.startswith(
+                SYSTEM_SHARED_MEM_FS
+            )
+        else:
+            self._prewarm = prewarm
+        self._prewarm = prewarm
+        self._memmaped_arrays = _WeakArrayKeyMap()
+        self._temporary_memmaped_filenames = set()
+        self._unlink_on_gc_collect = unlink_on_gc_collect
+
+    @property
+    def _temp_folder(self):
+        return self._temp_folder_resolver()
+
+    def __reduce__(self):
+        # The ArrayMemmapForwardReducer is passed to the children processes: it
+        # needs to be pickled but the _WeakArrayKeyMap need to be skipped as
+        # it's only guaranteed to be consistent with the parent process memory
+        # garbage collection.
+        # Although this reducer is pickled, it is not needed in its destination
+        # process (child processes), as we only use this reducer to send
+        # memmaps from the parent process to the children processes. For this
+        # reason, we can afford skipping the resolver, (which would otherwise
+        # be unpicklable), and pass it as None instead.
+        args = (self._max_nbytes, None, self._mmap_mode,
+                self._unlink_on_gc_collect)
+        kwargs = {
+            'verbose': self.verbose,
+            'prewarm': self._prewarm,
+        }
+        return ArrayMemmapForwardReducer, args, kwargs
+
+    def __call__(self, a):
+        m = _get_backing_memmap(a)
+        if m is not None and isinstance(m, np.memmap):
+            # a is already backed by a memmap file, let's reuse it directly
+            return _reduce_memmap_backed(a, m)
+
+        if (not a.dtype.hasobject and self._max_nbytes is not None and
+                a.nbytes > self._max_nbytes):
+            # check that the folder exists (lazily create the pool temp folder
+            # if required)
+            try:
+                os.makedirs(self._temp_folder)
+                os.chmod(self._temp_folder, FOLDER_PERMISSIONS)
+            except OSError as e:
+                if e.errno != errno.EEXIST:
+                    raise e
+
+            try:
+                basename = self._memmaped_arrays.get(a)
+            except KeyError:
+                # Generate a new unique random filename. The process and thread
+                # ids are only useful for debugging purpose and to make it
+                # easier to cleanup orphaned files in case of hard process
+                # kill (e.g. by "kill -9" or segfault).
+                basename = "{}-{}-{}.pkl".format(
+                    os.getpid(), id(threading.current_thread()), uuid4().hex)
+                self._memmaped_arrays.set(a, basename)
+            filename = os.path.join(self._temp_folder, basename)
+
+            # In case the same array with the same content is passed several
+            # times to the pool subprocess children, serialize it only once
+
+            is_new_memmap = filename not in self._temporary_memmaped_filenames
+
+            # add the memmap to the list of temporary memmaps created by joblib
+            self._temporary_memmaped_filenames.add(filename)
+
+            if self._unlink_on_gc_collect:
+                # Bump reference count of the memmap by 1 to account for
+                # shared usage of the memmap by a child process. The
+                # corresponding decref call will be executed upon calling
+                # resource_tracker.maybe_unlink, registered as a finalizer in
+                # the child.
+                # the incref/decref calls here are only possible when the child
+                # and the parent share the same resource_tracker. It is not the
+                # case for the multiprocessing backend, but it does not matter
+                # because unlinking a memmap from a child process is only
+                # useful to control the memory usage of long-lasting child
+                # processes, while the multiprocessing-based pools terminate
+                # their workers at the end of a map() call.
+                resource_tracker.register(filename, "file")
+
+            if is_new_memmap:
+                # Incref each temporary memmap created by joblib one extra
+                # time.  This means that these memmaps will only be deleted
+                # once an extra maybe_unlink() is called, which is done once
+                # all the jobs have completed (or been canceled) in the
+                # Parallel._terminate_backend() method.
+                resource_tracker.register(filename, "file")
+
+            if not os.path.exists(filename):
+                util.debug(
+                    "[ARRAY DUMP] Pickling new array (shape={}, dtype={}) "
+                    "creating a new memmap at {}".format(
+                        a.shape, a.dtype, filename))
+                for dumped_filename in dump(a, filename):
+                    os.chmod(dumped_filename, FILE_PERMISSIONS)
+
+                if self._prewarm:
+                    # Warm up the data by accessing it. This operation ensures
+                    # that the disk access required to create the memmapping
+                    # file are performed in the reducing process and avoids
+                    # concurrent memmap creation in multiple children
+                    # processes.
+                    load(filename, mmap_mode=self._mmap_mode).max()
+
+            else:
+                util.debug(
+                    "[ARRAY DUMP] Pickling known array (shape={}, dtype={}) "
+                    "reusing memmap file: {}".format(
+                        a.shape, a.dtype, os.path.basename(filename)))
+
+            # The worker process will use joblib.load to memmap the data
+            return (
+                (load_temporary_memmap, (filename, self._mmap_mode,
+                                         self._unlink_on_gc_collect))
+            )
+        else:
+            # do not convert a into memmap, let pickler do its usual copy with
+            # the default system pickler
+            util.debug(
+                '[ARRAY DUMP] Pickling array (NO MEMMAPPING) (shape={}, '
+                ' dtype={}).'.format(a.shape, a.dtype))
+            return (loads, (dumps(a, protocol=HIGHEST_PROTOCOL),))
+
+
+def get_memmapping_reducers(
+        forward_reducers=None, backward_reducers=None,
+        temp_folder_resolver=None, max_nbytes=1e6, mmap_mode='r', verbose=0,
+        prewarm=False, unlink_on_gc_collect=True, **kwargs):
+    """Construct a pair of memmapping reducer linked to a tmpdir.
+
+    This function manage the creation and the clean up of the temporary folders
+    underlying the memory maps and should be use to get the reducers necessary
+    to construct joblib pool or executor.
+    """
+    if forward_reducers is None:
+        forward_reducers = dict()
+    if backward_reducers is None:
+        backward_reducers = dict()
+
+    if np is not None:
+        # Register smart numpy.ndarray reducers that detects memmap backed
+        # arrays and that is also able to dump to memmap large in-memory
+        # arrays over the max_nbytes threshold
+        forward_reduce_ndarray = ArrayMemmapForwardReducer(
+            max_nbytes, temp_folder_resolver, mmap_mode, unlink_on_gc_collect,
+            verbose, prewarm=prewarm)
+        forward_reducers[np.ndarray] = forward_reduce_ndarray
+        forward_reducers[np.memmap] = forward_reduce_ndarray
+
+        # Communication from child process to the parent process always
+        # pickles in-memory numpy.ndarray without dumping them as memmap
+        # to avoid confusing the caller and make it tricky to collect the
+        # temporary folder
+        backward_reducers[np.ndarray] = reduce_array_memmap_backward
+        backward_reducers[np.memmap] = reduce_array_memmap_backward
+
+    return forward_reducers, backward_reducers
+
+
+class TemporaryResourcesManager(object):
+    """Stateful object able to manage temporary folder and pickles
+
+    It exposes:
+    - a per-context folder name resolving API that memmap-based reducers will
+      rely on to know where to pickle the temporary memmaps
+    - a temporary file/folder management API that internally uses the
+      resource_tracker.
+    """
+
+    def __init__(self, temp_folder_root=None, context_id=None):
+        self._current_temp_folder = None
+        self._temp_folder_root = temp_folder_root
+        self._use_shared_mem = None
+        self._cached_temp_folders = dict()
+        self._id = uuid4().hex
+        self._finalizers = {}
+        if context_id is None:
+            # It would be safer to not assign a default context id (less silent
+            # bugs), but doing this while maintaining backward compatibility
+            # with the previous, context-unaware version get_memmaping_executor
+            # exposes too many low-level details.
+            context_id = uuid4().hex
+        self.set_current_context(context_id)
+
+    def set_current_context(self, context_id):
+        self._current_context_id = context_id
+        self.register_new_context(context_id)
+
+    def register_new_context(self, context_id):
+        # Prepare a sub-folder name specific to a context (usually a unique id
+        # generated by each instance of the Parallel class). Do not create in
+        # advance to spare FS write access if no array is to be dumped).
+        if context_id in self._cached_temp_folders:
+            return
+        else:
+            # During its lifecycle, one Parallel object can have several
+            # executors associated to it (for instance, if a loky worker raises
+            # an exception, joblib shutdowns the executor and instantly
+            # recreates a new one before raising the error - see
+            # ``ensure_ready``.  Because we don't want two executors tied to
+            # the same Parallel object (and thus the same context id) to
+            # register/use/delete the same folder, we also add an id specific
+            # to the current Manager (and thus specific to its associated
+            # executor) to the folder name.
+            new_folder_name = (
+                "joblib_memmapping_folder_{}_{}_{}".format(
+                    os.getpid(), self._id, context_id)
+            )
+            new_folder_path, _ = _get_temp_dir(
+                new_folder_name, self._temp_folder_root
+            )
+            self.register_folder_finalizer(new_folder_path, context_id)
+            self._cached_temp_folders[context_id] = new_folder_path
+
+    def resolve_temp_folder_name(self):
+        """Return a folder name specific to the currently activated context"""
+        return self._cached_temp_folders[self._current_context_id]
+
+    # resource management API
+
+    def register_folder_finalizer(self, pool_subfolder, context_id):
+        # Register the garbage collector at program exit in case caller forgets
+        # to call terminate explicitly: note we do not pass any reference to
+        # ensure that this callback won't prevent garbage collection of
+        # parallel instance and related file handler resources such as POSIX
+        # semaphores and pipes
+        pool_module_name = whichmodule(delete_folder, 'delete_folder')
+        resource_tracker.register(pool_subfolder, "folder")
+
+        def _cleanup():
+            # In some cases the Python runtime seems to set delete_folder to
+            # None just before exiting when accessing the delete_folder
+            # function from the closure namespace. So instead we reimport
+            # the delete_folder function explicitly.
+            # https://github.com/joblib/joblib/issues/328
+            # We cannot just use from 'joblib.pool import delete_folder'
+            # because joblib should only use relative imports to allow
+            # easy vendoring.
+            delete_folder = __import__(
+                pool_module_name, fromlist=['delete_folder']
+            ).delete_folder
+            try:
+                delete_folder(pool_subfolder, allow_non_empty=True)
+                resource_tracker.unregister(pool_subfolder, "folder")
+            except OSError:
+                warnings.warn("Failed to delete temporary folder: {}"
+                              .format(pool_subfolder))
+
+        self._finalizers[context_id] = atexit.register(_cleanup)
+
+    def _clean_temporary_resources(self, context_id=None, force=False,
+                                   allow_non_empty=False):
+        """Clean temporary resources created by a process-based pool"""
+        if context_id is None:
+            # Iterates over a copy of the cache keys to avoid Error due to
+            # iterating over a changing size dictionary.
+            for context_id in list(self._cached_temp_folders):
+                self._clean_temporary_resources(
+                    context_id, force=force, allow_non_empty=allow_non_empty
+                )
+        else:
+            temp_folder = self._cached_temp_folders.get(context_id)
+            if temp_folder and os.path.exists(temp_folder):
+                for filename in os.listdir(temp_folder):
+                    if force:
+                        # Some workers have failed and the ref counted might
+                        # be off. The workers should have shut down by this
+                        # time so forcefully clean up the files.
+                        resource_tracker.unregister(
+                            os.path.join(temp_folder, filename), "file"
+                        )
+                    else:
+                        resource_tracker.maybe_unlink(
+                            os.path.join(temp_folder, filename), "file"
+                        )
+
+                # When forcing clean-up, try to delete the folder even if some
+                # files are still in it. Otherwise, try to delete the folder
+                allow_non_empty |= force
+
+                # Clean up the folder if possible, either if it is empty or
+                # if none of the files in it are in used and allow_non_empty.
+                try:
+                    delete_folder(
+                        temp_folder, allow_non_empty=allow_non_empty
+                    )
+                    # Forget the folder once it has been deleted
+                    self._cached_temp_folders.pop(context_id, None)
+                    resource_tracker.unregister(temp_folder, "folder")
+
+                    # Also cancel the finalizers  that gets triggered at gc.
+                    finalizer = self._finalizers.pop(context_id, None)
+                    if finalizer is not None:
+                        atexit.unregister(finalizer)
+
+                except OSError:
+                    # Temporary folder cannot be deleted right now.
+                    # This folder will be cleaned up by an atexit
+                    # finalizer registered by the memmapping_reducer.
+                    pass
diff --git a/llm/Lib/site-packages/joblib/_multiprocessing_helpers.py b/llm/Lib/site-packages/joblib/_multiprocessing_helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..bde4bc1905311cdc4cd337e9b72e3b24f50a3ed5
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/_multiprocessing_helpers.py
@@ -0,0 +1,53 @@
+"""Helper module to factorize the conditional multiprocessing import logic
+
+We use a distinct module to simplify import statements and avoid introducing
+circular dependencies (for instance for the assert_spawning name).
+"""
+import os
+import warnings
+
+
+# Obtain possible configuration from the environment, assuming 1 (on)
+# by default, upon 0 set to None. Should instructively fail if some non
+# 0/1 value is set.
+mp = int(os.environ.get('JOBLIB_MULTIPROCESSING', 1)) or None
+if mp:
+    try:
+        import multiprocessing as mp
+        import _multiprocessing  # noqa
+    except ImportError:
+        mp = None
+
+# 2nd stage: validate that locking is available on the system and
+#            issue a warning if not
+if mp is not None:
+    try:
+        # try to create a named semaphore using SemLock to make sure they are
+        # available on this platform. We use the low level object
+        # _multiprocessing.SemLock to avoid spawning a resource tracker on
+        # Unix system or changing the default backend.
+        import tempfile
+        from _multiprocessing import SemLock
+
+        _rand = tempfile._RandomNameSequence()
+        for i in range(100):
+            try:
+                name = '/joblib-{}-{}' .format(
+                    os.getpid(), next(_rand))
+                _sem = SemLock(0, 0, 1, name=name, unlink=True)
+                del _sem  # cleanup
+                break
+            except FileExistsError as e:  # pragma: no cover
+                if i >= 99:
+                    raise FileExistsError(
+                        'cannot find name for semaphore') from e
+    except (FileExistsError, AttributeError, ImportError, OSError) as e:
+        mp = None
+        warnings.warn('%s.  joblib will operate in serial mode' % (e,))
+
+
+# 3rd stage: backward compat for the assert_spawning helper
+if mp is not None:
+    from multiprocessing.context import assert_spawning
+else:
+    assert_spawning = None
diff --git a/llm/Lib/site-packages/joblib/_parallel_backends.py b/llm/Lib/site-packages/joblib/_parallel_backends.py
new file mode 100644
index 0000000000000000000000000000000000000000..8201c96bcf61b5c6e61821e7073a0babf6510268
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/_parallel_backends.py
@@ -0,0 +1,649 @@
+"""
+Backends for embarrassingly parallel code.
+"""
+
+import gc
+import os
+import warnings
+import threading
+import contextlib
+from abc import ABCMeta, abstractmethod
+
+from ._utils import (
+    _TracebackCapturingWrapper,
+    _retrieve_traceback_capturing_wrapped_call
+)
+
+from ._multiprocessing_helpers import mp
+
+if mp is not None:
+    from .pool import MemmappingPool
+    from multiprocessing.pool import ThreadPool
+    from .executor import get_memmapping_executor
+
+    # Import loky only if multiprocessing is present
+    from .externals.loky import process_executor, cpu_count
+    from .externals.loky.process_executor import ShutdownExecutorError
+
+
+class ParallelBackendBase(metaclass=ABCMeta):
+    """Helper abc which defines all methods a ParallelBackend must implement"""
+
+    supports_inner_max_num_threads = False
+    supports_retrieve_callback = False
+    default_n_jobs = 1
+
+    @property
+    def supports_return_generator(self):
+        return self.supports_retrieve_callback
+
+    @property
+    def supports_timeout(self):
+        return self.supports_retrieve_callback
+
+    nesting_level = None
+
+    def __init__(self, nesting_level=None, inner_max_num_threads=None,
+                 **kwargs):
+        super().__init__(**kwargs)
+        self.nesting_level = nesting_level
+        self.inner_max_num_threads = inner_max_num_threads
+
+    MAX_NUM_THREADS_VARS = [
+        'OMP_NUM_THREADS', 'OPENBLAS_NUM_THREADS', 'MKL_NUM_THREADS',
+        'BLIS_NUM_THREADS', 'VECLIB_MAXIMUM_THREADS', 'NUMBA_NUM_THREADS',
+        'NUMEXPR_NUM_THREADS',
+    ]
+
+    TBB_ENABLE_IPC_VAR = "ENABLE_IPC"
+
+    @abstractmethod
+    def effective_n_jobs(self, n_jobs):
+        """Determine the number of jobs that can actually run in parallel
+
+        n_jobs is the number of workers requested by the callers. Passing
+        n_jobs=-1 means requesting all available workers for instance matching
+        the number of CPU cores on the worker host(s).
+
+        This method should return a guesstimate of the number of workers that
+        can actually perform work concurrently. The primary use case is to make
+        it possible for the caller to know in how many chunks to slice the
+        work.
+
+        In general working on larger data chunks is more efficient (less
+        scheduling overhead and better use of CPU cache prefetching heuristics)
+        as long as all the workers have enough work to do.
+        """
+
+    @abstractmethod
+    def apply_async(self, func, callback=None):
+        """Schedule a func to be run"""
+
+    def retrieve_result_callback(self, out):
+        """Called within the callback function passed in apply_async.
+
+        The argument of this function is the argument given to a callback in
+        the considered backend. It is supposed to return the outcome of a task
+        if it succeeded or raise the exception if it failed.
+        """
+
+    def configure(self, n_jobs=1, parallel=None, prefer=None, require=None,
+                  **backend_args):
+        """Reconfigure the backend and return the number of workers.
+
+        This makes it possible to reuse an existing backend instance for
+        successive independent calls to Parallel with different parameters.
+        """
+        self.parallel = parallel
+        return self.effective_n_jobs(n_jobs)
+
+    def start_call(self):
+        """Call-back method called at the beginning of a Parallel call"""
+
+    def stop_call(self):
+        """Call-back method called at the end of a Parallel call"""
+
+    def terminate(self):
+        """Shutdown the workers and free the shared memory."""
+
+    def compute_batch_size(self):
+        """Determine the optimal batch size"""
+        return 1
+
+    def batch_completed(self, batch_size, duration):
+        """Callback indicate how long it took to run a batch"""
+
+    def get_exceptions(self):
+        """List of exception types to be captured."""
+        return []
+
+    def abort_everything(self, ensure_ready=True):
+        """Abort any running tasks
+
+        This is called when an exception has been raised when executing a task
+        and all the remaining tasks will be ignored and can therefore be
+        aborted to spare computation resources.
+
+        If ensure_ready is True, the backend should be left in an operating
+        state as future tasks might be re-submitted via that same backend
+        instance.
+
+        If ensure_ready is False, the implementer of this method can decide
+        to leave the backend in a closed / terminated state as no new task
+        are expected to be submitted to this backend.
+
+        Setting ensure_ready to False is an optimization that can be leveraged
+        when aborting tasks via killing processes from a local process pool
+        managed by the backend it-self: if we expect no new tasks, there is no
+        point in re-creating new workers.
+        """
+        # Does nothing by default: to be overridden in subclasses when
+        # canceling tasks is possible.
+        pass
+
+    def get_nested_backend(self):
+        """Backend instance to be used by nested Parallel calls.
+
+        By default a thread-based backend is used for the first level of
+        nesting. Beyond, switch to sequential backend to avoid spawning too
+        many threads on the host.
+        """
+        nesting_level = getattr(self, 'nesting_level', 0) + 1
+        if nesting_level > 1:
+            return SequentialBackend(nesting_level=nesting_level), None
+        else:
+            return ThreadingBackend(nesting_level=nesting_level), None
+
+    @contextlib.contextmanager
+    def retrieval_context(self):
+        """Context manager to manage an execution context.
+
+        Calls to Parallel.retrieve will be made inside this context.
+
+        By default, this does nothing. It may be useful for subclasses to
+        handle nested parallelism. In particular, it may be required to avoid
+        deadlocks if a backend manages a fixed number of workers, when those
+        workers may be asked to do nested Parallel calls. Without
+        'retrieval_context' this could lead to deadlock, as all the workers
+        managed by the backend may be "busy" waiting for the nested parallel
+        calls to finish, but the backend has no free workers to execute those
+        tasks.
+        """
+        yield
+
+    def _prepare_worker_env(self, n_jobs):
+        """Return environment variables limiting threadpools in external libs.
+
+        This function return a dict containing environment variables to pass
+        when creating a pool of process. These environment variables limit the
+        number of threads to `n_threads` for OpenMP, MKL, Accelerated and
+        OpenBLAS libraries in the child processes.
+        """
+        explicit_n_threads = self.inner_max_num_threads
+        default_n_threads = max(cpu_count() // n_jobs, 1)
+
+        # Set the inner environment variables to self.inner_max_num_threads if
+        # it is given. Else, default to cpu_count // n_jobs unless the variable
+        # is already present in the parent process environment.
+        env = {}
+        for var in self.MAX_NUM_THREADS_VARS:
+            if explicit_n_threads is None:
+                var_value = os.environ.get(var, default_n_threads)
+            else:
+                var_value = explicit_n_threads
+
+            env[var] = str(var_value)
+
+        if self.TBB_ENABLE_IPC_VAR not in os.environ:
+            # To avoid over-subscription when using TBB, let the TBB schedulers
+            # use Inter Process Communication to coordinate:
+            env[self.TBB_ENABLE_IPC_VAR] = "1"
+        return env
+
+    @staticmethod
+    def in_main_thread():
+        return isinstance(threading.current_thread(), threading._MainThread)
+
+
+class SequentialBackend(ParallelBackendBase):
+    """A ParallelBackend which will execute all batches sequentially.
+
+    Does not use/create any threading objects, and hence has minimal
+    overhead. Used when n_jobs == 1.
+    """
+
+    uses_threads = True
+    supports_timeout = False
+    supports_retrieve_callback = False
+    supports_sharedmem = True
+
+    def effective_n_jobs(self, n_jobs):
+        """Determine the number of jobs which are going to run in parallel"""
+        if n_jobs == 0:
+            raise ValueError('n_jobs == 0 in Parallel has no meaning')
+        return 1
+
+    def apply_async(self, func, callback=None):
+        """Schedule a func to be run"""
+        raise RuntimeError("Should never be called for SequentialBackend.")
+
+    def retrieve_result_callback(self, out):
+        raise RuntimeError("Should never be called for SequentialBackend.")
+
+    def get_nested_backend(self):
+        # import is not top level to avoid cyclic import errors.
+        from .parallel import get_active_backend
+
+        # SequentialBackend should neither change the nesting level, the
+        # default backend or the number of jobs. Just return the current one.
+        return get_active_backend()
+
+
+class PoolManagerMixin(object):
+    """A helper class for managing pool of workers."""
+
+    _pool = None
+
+    def effective_n_jobs(self, n_jobs):
+        """Determine the number of jobs which are going to run in parallel"""
+        if n_jobs == 0:
+            raise ValueError('n_jobs == 0 in Parallel has no meaning')
+        elif mp is None or n_jobs is None:
+            # multiprocessing is not available or disabled, fallback
+            # to sequential mode
+            return 1
+        elif n_jobs < 0:
+            n_jobs = max(cpu_count() + 1 + n_jobs, 1)
+        return n_jobs
+
+    def terminate(self):
+        """Shutdown the process or thread pool"""
+        if self._pool is not None:
+            self._pool.close()
+            self._pool.terminate()  # terminate does a join()
+            self._pool = None
+
+    def _get_pool(self):
+        """Used by apply_async to make it possible to implement lazy init"""
+        return self._pool
+
+    def apply_async(self, func, callback=None):
+        """Schedule a func to be run"""
+        # Here, we need a wrapper to avoid crashes on KeyboardInterruptErrors.
+        # We also call the callback on error, to make sure the pool does not
+        # wait on crashed jobs.
+        return self._get_pool().apply_async(
+            _TracebackCapturingWrapper(func), (),
+            callback=callback, error_callback=callback
+        )
+
+    def retrieve_result_callback(self, out):
+        """Mimic concurrent.futures results, raising an error if needed."""
+        return _retrieve_traceback_capturing_wrapped_call(out)
+
+    def abort_everything(self, ensure_ready=True):
+        """Shutdown the pool and restart a new one with the same parameters"""
+        self.terminate()
+        if ensure_ready:
+            self.configure(n_jobs=self.parallel.n_jobs, parallel=self.parallel,
+                           **self.parallel._backend_args)
+
+
+class AutoBatchingMixin(object):
+    """A helper class for automagically batching jobs."""
+
+    # In seconds, should be big enough to hide multiprocessing dispatching
+    # overhead.
+    # This settings was found by running benchmarks/bench_auto_batching.py
+    # with various parameters on various platforms.
+    MIN_IDEAL_BATCH_DURATION = .2
+
+    # Should not be too high to avoid stragglers: long jobs running alone
+    # on a single worker while other workers have no work to process any more.
+    MAX_IDEAL_BATCH_DURATION = 2
+
+    # Batching counters default values
+    _DEFAULT_EFFECTIVE_BATCH_SIZE = 1
+    _DEFAULT_SMOOTHED_BATCH_DURATION = 0.0
+
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+        self._effective_batch_size = self._DEFAULT_EFFECTIVE_BATCH_SIZE
+        self._smoothed_batch_duration = self._DEFAULT_SMOOTHED_BATCH_DURATION
+
+    def compute_batch_size(self):
+        """Determine the optimal batch size"""
+        old_batch_size = self._effective_batch_size
+        batch_duration = self._smoothed_batch_duration
+        if (batch_duration > 0 and
+                batch_duration < self.MIN_IDEAL_BATCH_DURATION):
+            # The current batch size is too small: the duration of the
+            # processing of a batch of task is not large enough to hide
+            # the scheduling overhead.
+            ideal_batch_size = int(old_batch_size *
+                                   self.MIN_IDEAL_BATCH_DURATION /
+                                   batch_duration)
+            # Multiply by two to limit oscilations between min and max.
+            ideal_batch_size *= 2
+
+            # dont increase the batch size too fast to limit huge batch sizes
+            # potentially leading to starving worker
+            batch_size = min(2 * old_batch_size, ideal_batch_size)
+
+            batch_size = max(batch_size, 1)
+
+            self._effective_batch_size = batch_size
+            if self.parallel.verbose >= 10:
+                self.parallel._print(
+                    f"Batch computation too fast ({batch_duration}s.) "
+                    f"Setting batch_size={batch_size}."
+                )
+        elif (batch_duration > self.MAX_IDEAL_BATCH_DURATION and
+              old_batch_size >= 2):
+            # The current batch size is too big. If we schedule overly long
+            # running batches some CPUs might wait with nothing left to do
+            # while a couple of CPUs a left processing a few long running
+            # batches. Better reduce the batch size a bit to limit the
+            # likelihood of scheduling such stragglers.
+
+            # decrease the batch size quickly to limit potential starving
+            ideal_batch_size = int(
+                old_batch_size * self.MIN_IDEAL_BATCH_DURATION / batch_duration
+            )
+            # Multiply by two to limit oscilations between min and max.
+            batch_size = max(2 * ideal_batch_size, 1)
+            self._effective_batch_size = batch_size
+            if self.parallel.verbose >= 10:
+                self.parallel._print(
+                    f"Batch computation too slow ({batch_duration}s.) "
+                    f"Setting batch_size={batch_size}."
+                )
+        else:
+            # No batch size adjustment
+            batch_size = old_batch_size
+
+        if batch_size != old_batch_size:
+            # Reset estimation of the smoothed mean batch duration: this
+            # estimate is updated in the multiprocessing apply_async
+            # CallBack as long as the batch_size is constant. Therefore
+            # we need to reset the estimate whenever we re-tune the batch
+            # size.
+            self._smoothed_batch_duration = \
+                self._DEFAULT_SMOOTHED_BATCH_DURATION
+
+        return batch_size
+
+    def batch_completed(self, batch_size, duration):
+        """Callback indicate how long it took to run a batch"""
+        if batch_size == self._effective_batch_size:
+            # Update the smoothed streaming estimate of the duration of a batch
+            # from dispatch to completion
+            old_duration = self._smoothed_batch_duration
+            if old_duration == self._DEFAULT_SMOOTHED_BATCH_DURATION:
+                # First record of duration for this batch size after the last
+                # reset.
+                new_duration = duration
+            else:
+                # Update the exponentially weighted average of the duration of
+                # batch for the current effective size.
+                new_duration = 0.8 * old_duration + 0.2 * duration
+            self._smoothed_batch_duration = new_duration
+
+    def reset_batch_stats(self):
+        """Reset batch statistics to default values.
+
+        This avoids interferences with future jobs.
+        """
+        self._effective_batch_size = self._DEFAULT_EFFECTIVE_BATCH_SIZE
+        self._smoothed_batch_duration = self._DEFAULT_SMOOTHED_BATCH_DURATION
+
+
+class ThreadingBackend(PoolManagerMixin, ParallelBackendBase):
+    """A ParallelBackend which will use a thread pool to execute batches in.
+
+    This is a low-overhead backend but it suffers from the Python Global
+    Interpreter Lock if the called function relies a lot on Python objects.
+    Mostly useful when the execution bottleneck is a compiled extension that
+    explicitly releases the GIL (for instance a Cython loop wrapped in a "with
+    nogil" block or an expensive call to a library such as NumPy).
+
+    The actual thread pool is lazily initialized: the actual thread pool
+    construction is delayed to the first call to apply_async.
+
+    ThreadingBackend is used as the default backend for nested calls.
+    """
+
+    supports_retrieve_callback = True
+    uses_threads = True
+    supports_sharedmem = True
+
+    def configure(self, n_jobs=1, parallel=None, **backend_args):
+        """Build a process or thread pool and return the number of workers"""
+        n_jobs = self.effective_n_jobs(n_jobs)
+        if n_jobs == 1:
+            # Avoid unnecessary overhead and use sequential backend instead.
+            raise FallbackToBackend(
+                SequentialBackend(nesting_level=self.nesting_level))
+        self.parallel = parallel
+        self._n_jobs = n_jobs
+        return n_jobs
+
+    def _get_pool(self):
+        """Lazily initialize the thread pool
+
+        The actual pool of worker threads is only initialized at the first
+        call to apply_async.
+        """
+        if self._pool is None:
+            self._pool = ThreadPool(self._n_jobs)
+        return self._pool
+
+
+class MultiprocessingBackend(PoolManagerMixin, AutoBatchingMixin,
+                             ParallelBackendBase):
+    """A ParallelBackend which will use a multiprocessing.Pool.
+
+    Will introduce some communication and memory overhead when exchanging
+    input and output data with the with the worker Python processes.
+    However, does not suffer from the Python Global Interpreter Lock.
+    """
+
+    supports_retrieve_callback = True
+    supports_return_generator = False
+
+    def effective_n_jobs(self, n_jobs):
+        """Determine the number of jobs which are going to run in parallel.
+
+        This also checks if we are attempting to create a nested parallel
+        loop.
+        """
+        if mp is None:
+            return 1
+
+        if mp.current_process().daemon:
+            # Daemonic processes cannot have children
+            if n_jobs != 1:
+                if inside_dask_worker():
+                    msg = (
+                        "Inside a Dask worker with daemon=True, "
+                        "setting n_jobs=1.\nPossible work-arounds:\n"
+                        "- dask.config.set("
+                        "{'distributed.worker.daemon': False})"
+                        "- set the environment variable "
+                        "DASK_DISTRIBUTED__WORKER__DAEMON=False\n"
+                        "before creating your Dask cluster."
+                    )
+                else:
+                    msg = (
+                        'Multiprocessing-backed parallel loops '
+                        'cannot be nested, setting n_jobs=1'
+                    )
+                warnings.warn(msg, stacklevel=3)
+            return 1
+
+        if process_executor._CURRENT_DEPTH > 0:
+            # Mixing loky and multiprocessing in nested loop is not supported
+            if n_jobs != 1:
+                warnings.warn(
+                    'Multiprocessing-backed parallel loops cannot be nested,'
+                    ' below loky, setting n_jobs=1',
+                    stacklevel=3)
+            return 1
+
+        elif not (self.in_main_thread() or self.nesting_level == 0):
+            # Prevent posix fork inside in non-main posix threads
+            if n_jobs != 1:
+                warnings.warn(
+                    'Multiprocessing-backed parallel loops cannot be nested'
+                    ' below threads, setting n_jobs=1',
+                    stacklevel=3)
+            return 1
+
+        return super(MultiprocessingBackend, self).effective_n_jobs(n_jobs)
+
+    def configure(self, n_jobs=1, parallel=None, prefer=None, require=None,
+                  **memmappingpool_args):
+        """Build a process or thread pool and return the number of workers"""
+        n_jobs = self.effective_n_jobs(n_jobs)
+        if n_jobs == 1:
+            raise FallbackToBackend(
+                SequentialBackend(nesting_level=self.nesting_level))
+
+        # Make sure to free as much memory as possible before forking
+        gc.collect()
+        self._pool = MemmappingPool(n_jobs, **memmappingpool_args)
+        self.parallel = parallel
+        return n_jobs
+
+    def terminate(self):
+        """Shutdown the process or thread pool"""
+        super(MultiprocessingBackend, self).terminate()
+        self.reset_batch_stats()
+
+
+class LokyBackend(AutoBatchingMixin, ParallelBackendBase):
+    """Managing pool of workers with loky instead of multiprocessing."""
+
+    supports_retrieve_callback = True
+    supports_inner_max_num_threads = True
+
+    def configure(self, n_jobs=1, parallel=None, prefer=None, require=None,
+                  idle_worker_timeout=300, **memmappingexecutor_args):
+        """Build a process executor and return the number of workers"""
+        n_jobs = self.effective_n_jobs(n_jobs)
+        if n_jobs == 1:
+            raise FallbackToBackend(
+                SequentialBackend(nesting_level=self.nesting_level))
+
+        self._workers = get_memmapping_executor(
+            n_jobs, timeout=idle_worker_timeout,
+            env=self._prepare_worker_env(n_jobs=n_jobs),
+            context_id=parallel._id, **memmappingexecutor_args)
+        self.parallel = parallel
+        return n_jobs
+
+    def effective_n_jobs(self, n_jobs):
+        """Determine the number of jobs which are going to run in parallel"""
+        if n_jobs == 0:
+            raise ValueError('n_jobs == 0 in Parallel has no meaning')
+        elif mp is None or n_jobs is None:
+            # multiprocessing is not available or disabled, fallback
+            # to sequential mode
+            return 1
+        elif mp.current_process().daemon:
+            # Daemonic processes cannot have children
+            if n_jobs != 1:
+                if inside_dask_worker():
+                    msg = (
+                        "Inside a Dask worker with daemon=True, "
+                        "setting n_jobs=1.\nPossible work-arounds:\n"
+                        "- dask.config.set("
+                        "{'distributed.worker.daemon': False})\n"
+                        "- set the environment variable "
+                        "DASK_DISTRIBUTED__WORKER__DAEMON=False\n"
+                        "before creating your Dask cluster."
+                    )
+                else:
+                    msg = (
+                        'Loky-backed parallel loops cannot be called in a'
+                        ' multiprocessing, setting n_jobs=1'
+                    )
+                warnings.warn(msg, stacklevel=3)
+
+            return 1
+        elif not (self.in_main_thread() or self.nesting_level == 0):
+            # Prevent posix fork inside in non-main posix threads
+            if n_jobs != 1:
+                warnings.warn(
+                    'Loky-backed parallel loops cannot be nested below '
+                    'threads, setting n_jobs=1',
+                    stacklevel=3)
+            return 1
+        elif n_jobs < 0:
+            n_jobs = max(cpu_count() + 1 + n_jobs, 1)
+        return n_jobs
+
+    def apply_async(self, func, callback=None):
+        """Schedule a func to be run"""
+        future = self._workers.submit(func)
+        if callback is not None:
+            future.add_done_callback(callback)
+        return future
+
+    def retrieve_result_callback(self, out):
+        try:
+            return out.result()
+        except ShutdownExecutorError:
+            raise RuntimeError(
+                "The executor underlying Parallel has been shutdown. "
+                "This is likely due to the garbage collection of a previous "
+                "generator from a call to Parallel with return_as='generator'."
+                " Make sure the generator is not garbage collected when "
+                "submitting a new job or that it is first properly exhausted."
+            )
+
+    def terminate(self):
+        if self._workers is not None:
+            # Don't terminate the workers as we want to reuse them in later
+            # calls, but cleanup the temporary resources that the Parallel call
+            # created. This 'hack' requires a private, low-level operation.
+            self._workers._temp_folder_manager._clean_temporary_resources(
+                context_id=self.parallel._id, force=False
+            )
+            self._workers = None
+
+        self.reset_batch_stats()
+
+    def abort_everything(self, ensure_ready=True):
+        """Shutdown the workers and restart a new one with the same parameters
+        """
+        self._workers.terminate(kill_workers=True)
+        self._workers = None
+
+        if ensure_ready:
+            self.configure(n_jobs=self.parallel.n_jobs, parallel=self.parallel)
+
+
+class FallbackToBackend(Exception):
+    """Raised when configuration should fallback to another backend"""
+
+    def __init__(self, backend):
+        self.backend = backend
+
+
+def inside_dask_worker():
+    """Check whether the current function is executed inside a Dask worker.
+    """
+    # This function can not be in joblib._dask because there would be a
+    # circular import:
+    # _dask imports _parallel_backend that imports _dask ...
+    try:
+        from distributed import get_worker
+    except ImportError:
+        return False
+
+    try:
+        get_worker()
+        return True
+    except ValueError:
+        return False
diff --git a/llm/Lib/site-packages/joblib/_store_backends.py b/llm/Lib/site-packages/joblib/_store_backends.py
new file mode 100644
index 0000000000000000000000000000000000000000..68e207c17d452faf7539fe0185dc0739a569774b
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/_store_backends.py
@@ -0,0 +1,474 @@
+"""Storage providers backends for Memory caching."""
+
+from pickle import PicklingError
+import re
+import os
+import os.path
+import datetime
+import json
+import shutil
+import time
+import warnings
+import collections
+import operator
+import threading
+from abc import ABCMeta, abstractmethod
+
+from .backports import concurrency_safe_rename
+from .disk import mkdirp, memstr_to_bytes, rm_subdirs
+from .logger import format_time
+from . import numpy_pickle
+
+CacheItemInfo = collections.namedtuple('CacheItemInfo',
+                                       'path size last_access')
+
+
+class CacheWarning(Warning):
+    """Warning to capture dump failures except for PicklingError."""
+    pass
+
+
+def concurrency_safe_write(object_to_write, filename, write_func):
+    """Writes an object into a unique file in a concurrency-safe way."""
+    thread_id = id(threading.current_thread())
+    temporary_filename = '{}.thread-{}-pid-{}'.format(
+        filename, thread_id, os.getpid())
+    write_func(object_to_write, temporary_filename)
+
+    return temporary_filename
+
+
+class StoreBackendBase(metaclass=ABCMeta):
+    """Helper Abstract Base Class which defines all methods that
+       a StorageBackend must implement."""
+
+    location = None
+
+    @abstractmethod
+    def _open_item(self, f, mode):
+        """Opens an item on the store and return a file-like object.
+
+        This method is private and only used by the StoreBackendMixin object.
+
+        Parameters
+        ----------
+        f: a file-like object
+            The file-like object where an item is stored and retrieved
+        mode: string, optional
+            the mode in which the file-like object is opened allowed valued are
+            'rb', 'wb'
+
+        Returns
+        -------
+        a file-like object
+        """
+
+    @abstractmethod
+    def _item_exists(self, location):
+        """Checks if an item location exists in the store.
+
+        This method is private and only used by the StoreBackendMixin object.
+
+        Parameters
+        ----------
+        location: string
+            The location of an item. On a filesystem, this corresponds to the
+            absolute path, including the filename, of a file.
+
+        Returns
+        -------
+        True if the item exists, False otherwise
+        """
+
+    @abstractmethod
+    def _move_item(self, src, dst):
+        """Moves an item from src to dst in the store.
+
+        This method is private and only used by the StoreBackendMixin object.
+
+        Parameters
+        ----------
+        src: string
+            The source location of an item
+        dst: string
+            The destination location of an item
+        """
+
+    @abstractmethod
+    def create_location(self, location):
+        """Creates a location on the store.
+
+        Parameters
+        ----------
+        location: string
+            The location in the store. On a filesystem, this corresponds to a
+            directory.
+        """
+
+    @abstractmethod
+    def clear_location(self, location):
+        """Clears a location on the store.
+
+        Parameters
+        ----------
+        location: string
+            The location in the store. On a filesystem, this corresponds to a
+            directory or a filename absolute path
+        """
+
+    @abstractmethod
+    def get_items(self):
+        """Returns the whole list of items available in the store.
+
+        Returns
+        -------
+        The list of items identified by their ids (e.g filename in a
+        filesystem).
+        """
+
+    @abstractmethod
+    def configure(self, location, verbose=0, backend_options=dict()):
+        """Configures the store.
+
+        Parameters
+        ----------
+        location: string
+            The base location used by the store. On a filesystem, this
+            corresponds to a directory.
+        verbose: int
+            The level of verbosity of the store
+        backend_options: dict
+            Contains a dictionary of named parameters used to configure the
+            store backend.
+        """
+
+
+class StoreBackendMixin(object):
+    """Class providing all logic for managing the store in a generic way.
+
+    The StoreBackend subclass has to implement 3 methods: create_location,
+    clear_location and configure. The StoreBackend also has to provide
+    a private _open_item, _item_exists and _move_item methods. The _open_item
+    method has to have the same signature as the builtin open and return a
+    file-like object.
+    """
+
+    def load_item(self, call_id, verbose=1, timestamp=None, metadata=None):
+        """Load an item from the store given its id as a list of str."""
+        full_path = os.path.join(self.location, *call_id)
+
+        if verbose > 1:
+            ts_string = ('{: <16}'.format(format_time(time.time() - timestamp))
+                         if timestamp is not None else '')
+            signature = os.path.basename(call_id[0])
+            if metadata is not None and 'input_args' in metadata:
+                kwargs = ', '.join('{}={}'.format(*item)
+                                   for item in metadata['input_args'].items())
+                signature += '({})'.format(kwargs)
+            msg = '[Memory]{}: Loading {}'.format(ts_string, signature)
+            if verbose < 10:
+                print('{0}...'.format(msg))
+            else:
+                print('{0} from {1}'.format(msg, full_path))
+
+        mmap_mode = (None if not hasattr(self, 'mmap_mode')
+                     else self.mmap_mode)
+
+        filename = os.path.join(full_path, 'output.pkl')
+        if not self._item_exists(filename):
+            raise KeyError("Non-existing item (may have been "
+                           "cleared).\nFile %s does not exist" % filename)
+
+        # file-like object cannot be used when mmap_mode is set
+        if mmap_mode is None:
+            with self._open_item(filename, "rb") as f:
+                item = numpy_pickle.load(f)
+        else:
+            item = numpy_pickle.load(filename, mmap_mode=mmap_mode)
+        return item
+
+    def dump_item(self, call_id, item, verbose=1):
+        """Dump an item in the store at the id given as a list of str."""
+        try:
+            item_path = os.path.join(self.location, *call_id)
+            if not self._item_exists(item_path):
+                self.create_location(item_path)
+            filename = os.path.join(item_path, 'output.pkl')
+            if verbose > 10:
+                print('Persisting in %s' % item_path)
+
+            def write_func(to_write, dest_filename):
+                with self._open_item(dest_filename, "wb") as f:
+                    try:
+                        numpy_pickle.dump(to_write, f, compress=self.compress)
+                    except PicklingError as e:
+                        # TODO(1.5) turn into error
+                        warnings.warn(
+                            "Unable to cache to disk: failed to pickle "
+                            "output. In version 1.5 this will raise an "
+                            f"exception. Exception: {e}.",
+                            FutureWarning
+                        )
+
+            self._concurrency_safe_write(item, filename, write_func)
+        except Exception as e:  # noqa: E722
+            warnings.warn(
+                "Unable to cache to disk. Possibly a race condition in the "
+                f"creation of the directory. Exception: {e}.",
+                CacheWarning
+            )
+
+    def clear_item(self, call_id):
+        """Clear the item at the id, given as a list of str."""
+        item_path = os.path.join(self.location, *call_id)
+        if self._item_exists(item_path):
+            self.clear_location(item_path)
+
+    def contains_item(self, call_id):
+        """Check if there is an item at the id, given as a list of str."""
+        item_path = os.path.join(self.location, *call_id)
+        filename = os.path.join(item_path, 'output.pkl')
+
+        return self._item_exists(filename)
+
+    def get_item_info(self, call_id):
+        """Return information about item."""
+        return {'location': os.path.join(self.location, *call_id)}
+
+    def get_metadata(self, call_id):
+        """Return actual metadata of an item."""
+        try:
+            item_path = os.path.join(self.location, *call_id)
+            filename = os.path.join(item_path, 'metadata.json')
+            with self._open_item(filename, 'rb') as f:
+                return json.loads(f.read().decode('utf-8'))
+        except:  # noqa: E722
+            return {}
+
+    def store_metadata(self, call_id, metadata):
+        """Store metadata of a computation."""
+        try:
+            item_path = os.path.join(self.location, *call_id)
+            self.create_location(item_path)
+            filename = os.path.join(item_path, 'metadata.json')
+
+            def write_func(to_write, dest_filename):
+                with self._open_item(dest_filename, "wb") as f:
+                    f.write(json.dumps(to_write).encode('utf-8'))
+
+            self._concurrency_safe_write(metadata, filename, write_func)
+        except:  # noqa: E722
+            pass
+
+    def contains_path(self, call_id):
+        """Check cached function is available in store."""
+        func_path = os.path.join(self.location, *call_id)
+        return self.object_exists(func_path)
+
+    def clear_path(self, call_id):
+        """Clear all items with a common path in the store."""
+        func_path = os.path.join(self.location, *call_id)
+        if self._item_exists(func_path):
+            self.clear_location(func_path)
+
+    def store_cached_func_code(self, call_id, func_code=None):
+        """Store the code of the cached function."""
+        func_path = os.path.join(self.location, *call_id)
+        if not self._item_exists(func_path):
+            self.create_location(func_path)
+
+        if func_code is not None:
+            filename = os.path.join(func_path, "func_code.py")
+            with self._open_item(filename, 'wb') as f:
+                f.write(func_code.encode('utf-8'))
+
+    def get_cached_func_code(self, call_id):
+        """Store the code of the cached function."""
+        filename = os.path.join(self.location, *call_id, 'func_code.py')
+        try:
+            with self._open_item(filename, 'rb') as f:
+                return f.read().decode('utf-8')
+        except:  # noqa: E722
+            raise
+
+    def get_cached_func_info(self, call_id):
+        """Return information related to the cached function if it exists."""
+        return {'location': os.path.join(self.location, *call_id)}
+
+    def clear(self):
+        """Clear the whole store content."""
+        self.clear_location(self.location)
+
+    def enforce_store_limits(
+            self, bytes_limit, items_limit=None, age_limit=None
+    ):
+        """
+        Remove the store's oldest files to enforce item, byte, and age limits.
+        """
+        items_to_delete = self._get_items_to_delete(
+            bytes_limit, items_limit, age_limit
+        )
+
+        for item in items_to_delete:
+            if self.verbose > 10:
+                print('Deleting item {0}'.format(item))
+            try:
+                self.clear_location(item.path)
+            except OSError:
+                # Even with ignore_errors=True shutil.rmtree can raise OSError
+                # with:
+                # [Errno 116] Stale file handle if another process has deleted
+                # the folder already.
+                pass
+
+    def _get_items_to_delete(
+            self, bytes_limit, items_limit=None, age_limit=None
+    ):
+        """
+        Get items to delete to keep the store under size, file, & age limits.
+        """
+        if isinstance(bytes_limit, str):
+            bytes_limit = memstr_to_bytes(bytes_limit)
+
+        items = self.get_items()
+        if not items:
+            return []
+
+        size = sum(item.size for item in items)
+
+        if bytes_limit is not None:
+            to_delete_size = size - bytes_limit
+        else:
+            to_delete_size = 0
+
+        if items_limit is not None:
+            to_delete_items = len(items) - items_limit
+        else:
+            to_delete_items = 0
+
+        if age_limit is not None:
+            older_item = min(item.last_access for item in items)
+            deadline = datetime.datetime.now() - age_limit
+        else:
+            deadline = None
+
+        if (
+            to_delete_size <= 0 and to_delete_items <= 0
+            and (deadline is None or older_item > deadline)
+        ):
+            return []
+
+        # We want to delete first the cache items that were accessed a
+        # long time ago
+        items.sort(key=operator.attrgetter('last_access'))
+
+        items_to_delete = []
+        size_so_far = 0
+        items_so_far = 0
+
+        for item in items:
+            if (
+                (size_so_far >= to_delete_size)
+                and items_so_far >= to_delete_items
+                and (deadline is None or deadline < item.last_access)
+            ):
+                break
+
+            items_to_delete.append(item)
+            size_so_far += item.size
+            items_so_far += 1
+
+        return items_to_delete
+
+    def _concurrency_safe_write(self, to_write, filename, write_func):
+        """Writes an object into a file in a concurrency-safe way."""
+        temporary_filename = concurrency_safe_write(to_write,
+                                                    filename, write_func)
+        self._move_item(temporary_filename, filename)
+
+    def __repr__(self):
+        """Printable representation of the store location."""
+        return '{class_name}(location="{location}")'.format(
+            class_name=self.__class__.__name__, location=self.location)
+
+
+class FileSystemStoreBackend(StoreBackendBase, StoreBackendMixin):
+    """A StoreBackend used with local or network file systems."""
+
+    _open_item = staticmethod(open)
+    _item_exists = staticmethod(os.path.exists)
+    _move_item = staticmethod(concurrency_safe_rename)
+
+    def clear_location(self, location):
+        """Delete location on store."""
+        if (location == self.location):
+            rm_subdirs(location)
+        else:
+            shutil.rmtree(location, ignore_errors=True)
+
+    def create_location(self, location):
+        """Create object location on store"""
+        mkdirp(location)
+
+    def get_items(self):
+        """Returns the whole list of items available in the store."""
+        items = []
+
+        for dirpath, _, filenames in os.walk(self.location):
+            is_cache_hash_dir = re.match('[a-f0-9]{32}',
+                                         os.path.basename(dirpath))
+
+            if is_cache_hash_dir:
+                output_filename = os.path.join(dirpath, 'output.pkl')
+                try:
+                    last_access = os.path.getatime(output_filename)
+                except OSError:
+                    try:
+                        last_access = os.path.getatime(dirpath)
+                    except OSError:
+                        # The directory has already been deleted
+                        continue
+
+                last_access = datetime.datetime.fromtimestamp(last_access)
+                try:
+                    full_filenames = [os.path.join(dirpath, fn)
+                                      for fn in filenames]
+                    dirsize = sum(os.path.getsize(fn)
+                                  for fn in full_filenames)
+                except OSError:
+                    # Either output_filename or one of the files in
+                    # dirpath does not exist any more. We assume this
+                    # directory is being cleaned by another process already
+                    continue
+
+                items.append(CacheItemInfo(dirpath, dirsize,
+                                           last_access))
+
+        return items
+
+    def configure(self, location, verbose=1, backend_options=None):
+        """Configure the store backend.
+
+        For this backend, valid store options are 'compress' and 'mmap_mode'
+        """
+        if backend_options is None:
+            backend_options = {}
+
+        # setup location directory
+        self.location = location
+        if not os.path.exists(self.location):
+            mkdirp(self.location)
+
+        # item can be stored compressed for faster I/O
+        self.compress = backend_options.get('compress', False)
+
+        # FileSystemStoreBackend can be used with mmap_mode options under
+        # certain conditions.
+        mmap_mode = backend_options.get('mmap_mode')
+        if self.compress and mmap_mode is not None:
+            warnings.warn('Compressed items cannot be memmapped in a '
+                          'filesystem store. Option will be ignored.',
+                          stacklevel=2)
+
+        self.mmap_mode = mmap_mode
+        self.verbose = verbose
diff --git a/llm/Lib/site-packages/joblib/_utils.py b/llm/Lib/site-packages/joblib/_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..0b7cc64ee51695fe18e2fc8a819696e0246b54f8
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/_utils.py
@@ -0,0 +1,83 @@
+# Adapted from https://stackoverflow.com/a/9558001/2536294
+
+import ast
+from dataclasses import dataclass
+import operator as op
+
+
+from ._multiprocessing_helpers import mp
+
+if mp is not None:
+    from .externals.loky.process_executor import _ExceptionWithTraceback
+
+
+# supported operators
+operators = {
+    ast.Add: op.add,
+    ast.Sub: op.sub,
+    ast.Mult: op.mul,
+    ast.Div: op.truediv,
+    ast.FloorDiv: op.floordiv,
+    ast.Mod: op.mod,
+    ast.Pow: op.pow,
+    ast.USub: op.neg,
+}
+
+
+def eval_expr(expr):
+    """
+    >>> eval_expr('2*6')
+    12
+    >>> eval_expr('2**6')
+    64
+    >>> eval_expr('1 + 2*3**(4) / (6 + -7)')
+    -161.0
+    """
+    try:
+        return eval_(ast.parse(expr, mode="eval").body)
+    except (TypeError, SyntaxError, KeyError) as e:
+        raise ValueError(
+            f"{expr!r} is not a valid or supported arithmetic expression."
+        ) from e
+
+
+def eval_(node):
+    if isinstance(node, ast.Constant):  # <constant>
+        return node.value
+    elif isinstance(node, ast.BinOp):  # <left> <operator> <right>
+        return operators[type(node.op)](eval_(node.left), eval_(node.right))
+    elif isinstance(node, ast.UnaryOp):  # <operator> <operand> e.g., -1
+        return operators[type(node.op)](eval_(node.operand))
+    else:
+        raise TypeError(node)
+
+
+@dataclass(frozen=True)
+class _Sentinel:
+    """A sentinel to mark a parameter as not explicitly set"""
+    default_value: object
+
+    def __repr__(self):
+        return f"default({self.default_value!r})"
+
+
+class _TracebackCapturingWrapper:
+    """Protect function call and return error with traceback."""
+
+    def __init__(self, func):
+        self.func = func
+
+    def __call__(self, **kwargs):
+        try:
+            return self.func(**kwargs)
+        except BaseException as e:
+            return _ExceptionWithTraceback(e)
+
+
+def _retrieve_traceback_capturing_wrapped_call(out):
+    if isinstance(out, _ExceptionWithTraceback):
+        rebuild, args = out.__reduce__()
+        out = rebuild(*args)
+    if isinstance(out, BaseException):
+        raise out
+    return out
diff --git a/llm/Lib/site-packages/joblib/backports.py b/llm/Lib/site-packages/joblib/backports.py
new file mode 100644
index 0000000000000000000000000000000000000000..3a14f107689e82b634da6794d30e658fdc000987
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/backports.py
@@ -0,0 +1,177 @@
+"""
+Backports of fixes for joblib dependencies
+"""
+import os
+import re
+import time
+
+from os.path import basename
+from multiprocessing import util
+
+
+class Version:
+    """Backport from deprecated distutils
+
+    We maintain this backport to avoid introducing a new dependency on
+    `packaging`.
+
+    We might rexplore this choice in the future if all major Python projects
+    introduce a dependency on packaging anyway.
+    """
+
+    def __init__(self, vstring=None):
+        if vstring:
+            self.parse(vstring)
+
+    def __repr__(self):
+        return "%s ('%s')" % (self.__class__.__name__, str(self))
+
+    def __eq__(self, other):
+        c = self._cmp(other)
+        if c is NotImplemented:
+            return c
+        return c == 0
+
+    def __lt__(self, other):
+        c = self._cmp(other)
+        if c is NotImplemented:
+            return c
+        return c < 0
+
+    def __le__(self, other):
+        c = self._cmp(other)
+        if c is NotImplemented:
+            return c
+        return c <= 0
+
+    def __gt__(self, other):
+        c = self._cmp(other)
+        if c is NotImplemented:
+            return c
+        return c > 0
+
+    def __ge__(self, other):
+        c = self._cmp(other)
+        if c is NotImplemented:
+            return c
+        return c >= 0
+
+
+class LooseVersion(Version):
+    """Backport from deprecated distutils
+
+    We maintain this backport to avoid introducing a new dependency on
+    `packaging`.
+
+    We might rexplore this choice in the future if all major Python projects
+    introduce a dependency on packaging anyway.
+    """
+
+    component_re = re.compile(r'(\d+ | [a-z]+ | \.)', re.VERBOSE)
+
+    def __init__(self, vstring=None):
+        if vstring:
+            self.parse(vstring)
+
+    def parse(self, vstring):
+        # I've given up on thinking I can reconstruct the version string
+        # from the parsed tuple -- so I just store the string here for
+        # use by __str__
+        self.vstring = vstring
+        components = [x for x in self.component_re.split(vstring)
+                      if x and x != '.']
+        for i, obj in enumerate(components):
+            try:
+                components[i] = int(obj)
+            except ValueError:
+                pass
+
+        self.version = components
+
+    def __str__(self):
+        return self.vstring
+
+    def __repr__(self):
+        return "LooseVersion ('%s')" % str(self)
+
+    def _cmp(self, other):
+        if isinstance(other, str):
+            other = LooseVersion(other)
+        elif not isinstance(other, LooseVersion):
+            return NotImplemented
+
+        if self.version == other.version:
+            return 0
+        if self.version < other.version:
+            return -1
+        if self.version > other.version:
+            return 1
+
+
+try:
+    import numpy as np
+
+    def make_memmap(filename, dtype='uint8', mode='r+', offset=0,
+                    shape=None, order='C', unlink_on_gc_collect=False):
+        """Custom memmap constructor compatible with numpy.memmap.
+
+        This function:
+        - is a backport the numpy memmap offset fix (See
+          https://github.com/numpy/numpy/pull/8443 for more details.
+          The numpy fix is available starting numpy 1.13)
+        - adds ``unlink_on_gc_collect``, which specifies  explicitly whether
+          the process re-constructing the memmap owns a reference to the
+          underlying file. If set to True, it adds a finalizer to the
+          newly-created memmap that sends a maybe_unlink request for the
+          memmaped file to resource_tracker.
+        """
+        util.debug(
+            "[MEMMAP READ] creating a memmap (shape {}, filename {}, "
+            "pid {})".format(shape, basename(filename), os.getpid())
+        )
+
+        mm = np.memmap(filename, dtype=dtype, mode=mode, offset=offset,
+                       shape=shape, order=order)
+        if LooseVersion(np.__version__) < '1.13':
+            mm.offset = offset
+        if unlink_on_gc_collect:
+            from ._memmapping_reducer import add_maybe_unlink_finalizer
+            add_maybe_unlink_finalizer(mm)
+        return mm
+except ImportError:
+    def make_memmap(filename, dtype='uint8', mode='r+', offset=0,
+                    shape=None, order='C', unlink_on_gc_collect=False):
+        raise NotImplementedError(
+            "'joblib.backports.make_memmap' should not be used "
+            'if numpy is not installed.')
+
+
+if os.name == 'nt':
+    # https://github.com/joblib/joblib/issues/540
+    access_denied_errors = (5, 13)
+    from os import replace
+
+    def concurrency_safe_rename(src, dst):
+        """Renames ``src`` into ``dst`` overwriting ``dst`` if it exists.
+
+        On Windows os.replace can yield permission errors if executed by two
+        different processes.
+        """
+        max_sleep_time = 1
+        total_sleep_time = 0
+        sleep_time = 0.001
+        while total_sleep_time < max_sleep_time:
+            try:
+                replace(src, dst)
+                break
+            except Exception as exc:
+                if getattr(exc, 'winerror', None) in access_denied_errors:
+                    time.sleep(sleep_time)
+                    total_sleep_time += sleep_time
+                    sleep_time *= 2
+                else:
+                    raise
+        else:
+            raise
+else:
+    from os import replace as concurrency_safe_rename  # noqa
diff --git a/llm/Lib/site-packages/joblib/compressor.py b/llm/Lib/site-packages/joblib/compressor.py
new file mode 100644
index 0000000000000000000000000000000000000000..0d9e2618a48339e1af8cf2da573fd0af8c96f0b0
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/compressor.py
@@ -0,0 +1,570 @@
+"""Classes and functions for managing compressors."""
+
+import io
+import zlib
+from joblib.backports import LooseVersion
+
+try:
+    from threading import RLock
+except ImportError:
+    from dummy_threading import RLock
+
+try:
+    import bz2
+except ImportError:
+    bz2 = None
+
+try:
+    import lz4
+    from lz4.frame import LZ4FrameFile
+except ImportError:
+    lz4 = None
+
+try:
+    import lzma
+except ImportError:
+    lzma = None
+
+
+LZ4_NOT_INSTALLED_ERROR = ('LZ4 is not installed. Install it with pip: '
+                           'https://python-lz4.readthedocs.io/')
+
+# Registered compressors
+_COMPRESSORS = {}
+
+# Magic numbers of supported compression file formats.
+_ZFILE_PREFIX = b'ZF'  # used with pickle files created before 0.9.3.
+_ZLIB_PREFIX = b'\x78'
+_GZIP_PREFIX = b'\x1f\x8b'
+_BZ2_PREFIX = b'BZ'
+_XZ_PREFIX = b'\xfd\x37\x7a\x58\x5a'
+_LZMA_PREFIX = b'\x5d\x00'
+_LZ4_PREFIX = b'\x04\x22\x4D\x18'
+
+
+def register_compressor(compressor_name, compressor,
+                        force=False):
+    """Register a new compressor.
+
+    Parameters
+    ----------
+    compressor_name: str.
+        The name of the compressor.
+    compressor: CompressorWrapper
+        An instance of a 'CompressorWrapper'.
+    """
+    global _COMPRESSORS
+    if not isinstance(compressor_name, str):
+        raise ValueError("Compressor name should be a string, "
+                         "'{}' given.".format(compressor_name))
+
+    if not isinstance(compressor, CompressorWrapper):
+        raise ValueError("Compressor should implement the CompressorWrapper "
+                         "interface, '{}' given.".format(compressor))
+
+    if (compressor.fileobj_factory is not None and
+            (not hasattr(compressor.fileobj_factory, 'read') or
+             not hasattr(compressor.fileobj_factory, 'write') or
+             not hasattr(compressor.fileobj_factory, 'seek') or
+             not hasattr(compressor.fileobj_factory, 'tell'))):
+        raise ValueError("Compressor 'fileobj_factory' attribute should "
+                         "implement the file object interface, '{}' given."
+                         .format(compressor.fileobj_factory))
+
+    if compressor_name in _COMPRESSORS and not force:
+        raise ValueError("Compressor '{}' already registered."
+                         .format(compressor_name))
+
+    _COMPRESSORS[compressor_name] = compressor
+
+
+class CompressorWrapper():
+    """A wrapper around a compressor file object.
+
+    Attributes
+    ----------
+    obj: a file-like object
+        The object must implement the buffer interface and will be used
+        internally to compress/decompress the data.
+    prefix: bytestring
+        A bytestring corresponding to the magic number that identifies the
+        file format associated to the compressor.
+    extension: str
+        The file extension used to automatically select this compressor during
+        a dump to a file.
+    """
+
+    def __init__(self, obj, prefix=b'', extension=''):
+        self.fileobj_factory = obj
+        self.prefix = prefix
+        self.extension = extension
+
+    def compressor_file(self, fileobj, compresslevel=None):
+        """Returns an instance of a compressor file object."""
+        if compresslevel is None:
+            return self.fileobj_factory(fileobj, 'wb')
+        else:
+            return self.fileobj_factory(fileobj, 'wb',
+                                        compresslevel=compresslevel)
+
+    def decompressor_file(self, fileobj):
+        """Returns an instance of a decompressor file object."""
+        return self.fileobj_factory(fileobj, 'rb')
+
+
+class BZ2CompressorWrapper(CompressorWrapper):
+
+    prefix = _BZ2_PREFIX
+    extension = '.bz2'
+
+    def __init__(self):
+        if bz2 is not None:
+            self.fileobj_factory = bz2.BZ2File
+        else:
+            self.fileobj_factory = None
+
+    def _check_versions(self):
+        if bz2 is None:
+            raise ValueError('bz2 module is not compiled on your python '
+                             'standard library.')
+
+    def compressor_file(self, fileobj, compresslevel=None):
+        """Returns an instance of a compressor file object."""
+        self._check_versions()
+        if compresslevel is None:
+            return self.fileobj_factory(fileobj, 'wb')
+        else:
+            return self.fileobj_factory(fileobj, 'wb',
+                                        compresslevel=compresslevel)
+
+    def decompressor_file(self, fileobj):
+        """Returns an instance of a decompressor file object."""
+        self._check_versions()
+        fileobj = self.fileobj_factory(fileobj, 'rb')
+        return fileobj
+
+
+class LZMACompressorWrapper(CompressorWrapper):
+
+    prefix = _LZMA_PREFIX
+    extension = '.lzma'
+    _lzma_format_name = 'FORMAT_ALONE'
+
+    def __init__(self):
+        if lzma is not None:
+            self.fileobj_factory = lzma.LZMAFile
+            self._lzma_format = getattr(lzma, self._lzma_format_name)
+        else:
+            self.fileobj_factory = None
+
+    def _check_versions(self):
+        if lzma is None:
+            raise ValueError('lzma module is not compiled on your python '
+                             'standard library.')
+
+    def compressor_file(self, fileobj, compresslevel=None):
+        """Returns an instance of a compressor file object."""
+        if compresslevel is None:
+            return self.fileobj_factory(fileobj, 'wb',
+                                        format=self._lzma_format)
+        else:
+            return self.fileobj_factory(fileobj, 'wb',
+                                        format=self._lzma_format,
+                                        preset=compresslevel)
+
+    def decompressor_file(self, fileobj):
+        """Returns an instance of a decompressor file object."""
+        return lzma.LZMAFile(fileobj, 'rb')
+
+
+class XZCompressorWrapper(LZMACompressorWrapper):
+
+    prefix = _XZ_PREFIX
+    extension = '.xz'
+    _lzma_format_name = 'FORMAT_XZ'
+
+
+class LZ4CompressorWrapper(CompressorWrapper):
+
+    prefix = _LZ4_PREFIX
+    extension = '.lz4'
+
+    def __init__(self):
+        if lz4 is not None:
+            self.fileobj_factory = LZ4FrameFile
+        else:
+            self.fileobj_factory = None
+
+    def _check_versions(self):
+        if lz4 is None:
+            raise ValueError(LZ4_NOT_INSTALLED_ERROR)
+        lz4_version = lz4.__version__
+        if lz4_version.startswith("v"):
+            lz4_version = lz4_version[1:]
+        if LooseVersion(lz4_version) < LooseVersion('0.19'):
+            raise ValueError(LZ4_NOT_INSTALLED_ERROR)
+
+    def compressor_file(self, fileobj, compresslevel=None):
+        """Returns an instance of a compressor file object."""
+        self._check_versions()
+        if compresslevel is None:
+            return self.fileobj_factory(fileobj, 'wb')
+        else:
+            return self.fileobj_factory(fileobj, 'wb',
+                                        compression_level=compresslevel)
+
+    def decompressor_file(self, fileobj):
+        """Returns an instance of a decompressor file object."""
+        self._check_versions()
+        return self.fileobj_factory(fileobj, 'rb')
+
+
+###############################################################################
+#  base file compression/decompression object definition
+_MODE_CLOSED = 0
+_MODE_READ = 1
+_MODE_READ_EOF = 2
+_MODE_WRITE = 3
+_BUFFER_SIZE = 8192
+
+
+class BinaryZlibFile(io.BufferedIOBase):
+    """A file object providing transparent zlib (de)compression.
+
+    TODO python2_drop: is it still needed since we dropped Python 2 support A
+    BinaryZlibFile can act as a wrapper for an existing file object, or refer
+    directly to a named file on disk.
+
+    Note that BinaryZlibFile provides only a *binary* file interface: data read
+    is returned as bytes, and data to be written should be given as bytes.
+
+    This object is an adaptation of the BZ2File object and is compatible with
+    versions of python >= 2.7.
+
+    If filename is a str or bytes object, it gives the name
+    of the file to be opened. Otherwise, it should be a file object,
+    which will be used to read or write the compressed data.
+
+    mode can be 'rb' for reading (default) or 'wb' for (over)writing
+
+    If mode is 'wb', compresslevel can be a number between 1
+    and 9 specifying the level of compression: 1 produces the least
+    compression, and 9 produces the most compression. 3 is the default.
+    """
+
+    wbits = zlib.MAX_WBITS
+
+    def __init__(self, filename, mode="rb", compresslevel=3):
+        # This lock must be recursive, so that BufferedIOBase's
+        # readline(), readlines() and writelines() don't deadlock.
+        self._lock = RLock()
+        self._fp = None
+        self._closefp = False
+        self._mode = _MODE_CLOSED
+        self._pos = 0
+        self._size = -1
+        self.compresslevel = compresslevel
+
+        if not isinstance(compresslevel, int) or not (1 <= compresslevel <= 9):
+            raise ValueError("'compresslevel' must be an integer "
+                             "between 1 and 9. You provided 'compresslevel={}'"
+                             .format(compresslevel))
+
+        if mode == "rb":
+            self._mode = _MODE_READ
+            self._decompressor = zlib.decompressobj(self.wbits)
+            self._buffer = b""
+            self._buffer_offset = 0
+        elif mode == "wb":
+            self._mode = _MODE_WRITE
+            self._compressor = zlib.compressobj(self.compresslevel,
+                                                zlib.DEFLATED, self.wbits,
+                                                zlib.DEF_MEM_LEVEL, 0)
+        else:
+            raise ValueError("Invalid mode: %r" % (mode,))
+
+        if isinstance(filename, str):
+            self._fp = io.open(filename, mode)
+            self._closefp = True
+        elif hasattr(filename, "read") or hasattr(filename, "write"):
+            self._fp = filename
+        else:
+            raise TypeError("filename must be a str or bytes object, "
+                            "or a file")
+
+    def close(self):
+        """Flush and close the file.
+
+        May be called more than once without error. Once the file is
+        closed, any other operation on it will raise a ValueError.
+        """
+        with self._lock:
+            if self._mode == _MODE_CLOSED:
+                return
+            try:
+                if self._mode in (_MODE_READ, _MODE_READ_EOF):
+                    self._decompressor = None
+                elif self._mode == _MODE_WRITE:
+                    self._fp.write(self._compressor.flush())
+                    self._compressor = None
+            finally:
+                try:
+                    if self._closefp:
+                        self._fp.close()
+                finally:
+                    self._fp = None
+                    self._closefp = False
+                    self._mode = _MODE_CLOSED
+                    self._buffer = b""
+                    self._buffer_offset = 0
+
+    @property
+    def closed(self):
+        """True if this file is closed."""
+        return self._mode == _MODE_CLOSED
+
+    def fileno(self):
+        """Return the file descriptor for the underlying file."""
+        self._check_not_closed()
+        return self._fp.fileno()
+
+    def seekable(self):
+        """Return whether the file supports seeking."""
+        return self.readable() and self._fp.seekable()
+
+    def readable(self):
+        """Return whether the file was opened for reading."""
+        self._check_not_closed()
+        return self._mode in (_MODE_READ, _MODE_READ_EOF)
+
+    def writable(self):
+        """Return whether the file was opened for writing."""
+        self._check_not_closed()
+        return self._mode == _MODE_WRITE
+
+    # Mode-checking helper functions.
+
+    def _check_not_closed(self):
+        if self.closed:
+            fname = getattr(self._fp, 'name', None)
+            msg = "I/O operation on closed file"
+            if fname is not None:
+                msg += " {}".format(fname)
+            msg += "."
+            raise ValueError(msg)
+
+    def _check_can_read(self):
+        if self._mode not in (_MODE_READ, _MODE_READ_EOF):
+            self._check_not_closed()
+            raise io.UnsupportedOperation("File not open for reading")
+
+    def _check_can_write(self):
+        if self._mode != _MODE_WRITE:
+            self._check_not_closed()
+            raise io.UnsupportedOperation("File not open for writing")
+
+    def _check_can_seek(self):
+        if self._mode not in (_MODE_READ, _MODE_READ_EOF):
+            self._check_not_closed()
+            raise io.UnsupportedOperation("Seeking is only supported "
+                                          "on files open for reading")
+        if not self._fp.seekable():
+            raise io.UnsupportedOperation("The underlying file object "
+                                          "does not support seeking")
+
+    # Fill the readahead buffer if it is empty. Returns False on EOF.
+    def _fill_buffer(self):
+        if self._mode == _MODE_READ_EOF:
+            return False
+        # Depending on the input data, our call to the decompressor may not
+        # return any data. In this case, try again after reading another block.
+        while self._buffer_offset == len(self._buffer):
+            try:
+                rawblock = (self._decompressor.unused_data or
+                            self._fp.read(_BUFFER_SIZE))
+                if not rawblock:
+                    raise EOFError
+            except EOFError:
+                # End-of-stream marker and end of file. We're good.
+                self._mode = _MODE_READ_EOF
+                self._size = self._pos
+                return False
+            else:
+                self._buffer = self._decompressor.decompress(rawblock)
+            self._buffer_offset = 0
+        return True
+
+    # Read data until EOF.
+    # If return_data is false, consume the data without returning it.
+    def _read_all(self, return_data=True):
+        # The loop assumes that _buffer_offset is 0. Ensure that this is true.
+        self._buffer = self._buffer[self._buffer_offset:]
+        self._buffer_offset = 0
+
+        blocks = []
+        while self._fill_buffer():
+            if return_data:
+                blocks.append(self._buffer)
+            self._pos += len(self._buffer)
+            self._buffer = b""
+        if return_data:
+            return b"".join(blocks)
+
+    # Read a block of up to n bytes.
+    # If return_data is false, consume the data without returning it.
+    def _read_block(self, n_bytes, return_data=True):
+        # If we have enough data buffered, return immediately.
+        end = self._buffer_offset + n_bytes
+        if end <= len(self._buffer):
+            data = self._buffer[self._buffer_offset: end]
+            self._buffer_offset = end
+            self._pos += len(data)
+            return data if return_data else None
+
+        # The loop assumes that _buffer_offset is 0. Ensure that this is true.
+        self._buffer = self._buffer[self._buffer_offset:]
+        self._buffer_offset = 0
+
+        blocks = []
+        while n_bytes > 0 and self._fill_buffer():
+            if n_bytes < len(self._buffer):
+                data = self._buffer[:n_bytes]
+                self._buffer_offset = n_bytes
+            else:
+                data = self._buffer
+                self._buffer = b""
+            if return_data:
+                blocks.append(data)
+            self._pos += len(data)
+            n_bytes -= len(data)
+        if return_data:
+            return b"".join(blocks)
+
+    def read(self, size=-1):
+        """Read up to size uncompressed bytes from the file.
+
+        If size is negative or omitted, read until EOF is reached.
+        Returns b'' if the file is already at EOF.
+        """
+        with self._lock:
+            self._check_can_read()
+            if size == 0:
+                return b""
+            elif size < 0:
+                return self._read_all()
+            else:
+                return self._read_block(size)
+
+    def readinto(self, b):
+        """Read up to len(b) bytes into b.
+
+        Returns the number of bytes read (0 for EOF).
+        """
+        with self._lock:
+            return io.BufferedIOBase.readinto(self, b)
+
+    def write(self, data):
+        """Write a byte string to the file.
+
+        Returns the number of uncompressed bytes written, which is
+        always len(data). Note that due to buffering, the file on disk
+        may not reflect the data written until close() is called.
+        """
+        with self._lock:
+            self._check_can_write()
+            # Convert data type if called by io.BufferedWriter.
+            if isinstance(data, memoryview):
+                data = data.tobytes()
+
+            compressed = self._compressor.compress(data)
+            self._fp.write(compressed)
+            self._pos += len(data)
+            return len(data)
+
+    # Rewind the file to the beginning of the data stream.
+    def _rewind(self):
+        self._fp.seek(0, 0)
+        self._mode = _MODE_READ
+        self._pos = 0
+        self._decompressor = zlib.decompressobj(self.wbits)
+        self._buffer = b""
+        self._buffer_offset = 0
+
+    def seek(self, offset, whence=0):
+        """Change the file position.
+
+        The new position is specified by offset, relative to the
+        position indicated by whence. Values for whence are:
+
+            0: start of stream (default); offset must not be negative
+            1: current stream position
+            2: end of stream; offset must not be positive
+
+        Returns the new file position.
+
+        Note that seeking is emulated, so depending on the parameters,
+        this operation may be extremely slow.
+        """
+        with self._lock:
+            self._check_can_seek()
+
+            # Recalculate offset as an absolute file position.
+            if whence == 0:
+                pass
+            elif whence == 1:
+                offset = self._pos + offset
+            elif whence == 2:
+                # Seeking relative to EOF - we need to know the file's size.
+                if self._size < 0:
+                    self._read_all(return_data=False)
+                offset = self._size + offset
+            else:
+                raise ValueError("Invalid value for whence: %s" % (whence,))
+
+            # Make it so that offset is the number of bytes to skip forward.
+            if offset < self._pos:
+                self._rewind()
+            else:
+                offset -= self._pos
+
+            # Read and discard data until we reach the desired position.
+            self._read_block(offset, return_data=False)
+
+            return self._pos
+
+    def tell(self):
+        """Return the current file position."""
+        with self._lock:
+            self._check_not_closed()
+            return self._pos
+
+
+class ZlibCompressorWrapper(CompressorWrapper):
+
+    def __init__(self):
+        CompressorWrapper.__init__(self, obj=BinaryZlibFile,
+                                   prefix=_ZLIB_PREFIX, extension='.z')
+
+
+class BinaryGzipFile(BinaryZlibFile):
+    """A file object providing transparent gzip (de)compression.
+
+    If filename is a str or bytes object, it gives the name
+    of the file to be opened. Otherwise, it should be a file object,
+    which will be used to read or write the compressed data.
+
+    mode can be 'rb' for reading (default) or 'wb' for (over)writing
+
+    If mode is 'wb', compresslevel can be a number between 1
+    and 9 specifying the level of compression: 1 produces the least
+    compression, and 9 produces the most compression. 3 is the default.
+    """
+
+    wbits = 31  # zlib compressor/decompressor wbits value for gzip format.
+
+
+class GzipCompressorWrapper(CompressorWrapper):
+
+    def __init__(self):
+        CompressorWrapper.__init__(self, obj=BinaryGzipFile,
+                                   prefix=_GZIP_PREFIX, extension='.gz')
diff --git a/llm/Lib/site-packages/joblib/disk.py b/llm/Lib/site-packages/joblib/disk.py
new file mode 100644
index 0000000000000000000000000000000000000000..32fbb89f6dc6c9c7df532c5fefa14934f16321f6
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/disk.py
@@ -0,0 +1,136 @@
+"""
+Disk management utilities.
+"""
+
+# Authors: Gael Varoquaux <gael dot varoquaux at normalesup dot org>
+#          Lars Buitinck
+# Copyright (c) 2010 Gael Varoquaux
+# License: BSD Style, 3 clauses.
+
+
+import os
+import sys
+import time
+import errno
+import shutil
+
+from multiprocessing import util
+
+
+try:
+    WindowsError
+except NameError:
+    WindowsError = OSError
+
+
+def disk_used(path):
+    """ Return the disk usage in a directory."""
+    size = 0
+    for file in os.listdir(path) + ['.']:
+        stat = os.stat(os.path.join(path, file))
+        if hasattr(stat, 'st_blocks'):
+            size += stat.st_blocks * 512
+        else:
+            # on some platform st_blocks is not available (e.g., Windows)
+            # approximate by rounding to next multiple of 512
+            size += (stat.st_size // 512 + 1) * 512
+    # We need to convert to int to avoid having longs on some systems (we
+    # don't want longs to avoid problems we SQLite)
+    return int(size / 1024.)
+
+
+def memstr_to_bytes(text):
+    """ Convert a memory text to its value in bytes.
+    """
+    kilo = 1024
+    units = dict(K=kilo, M=kilo ** 2, G=kilo ** 3)
+    try:
+        size = int(units[text[-1]] * float(text[:-1]))
+    except (KeyError, ValueError) as e:
+        raise ValueError(
+            "Invalid literal for size give: %s (type %s) should be "
+            "alike '10G', '500M', '50K'." % (text, type(text))) from e
+    return size
+
+
+def mkdirp(d):
+    """Ensure directory d exists (like mkdir -p on Unix)
+    No guarantee that the directory is writable.
+    """
+    try:
+        os.makedirs(d)
+    except OSError as e:
+        if e.errno != errno.EEXIST:
+            raise
+
+
+# if a rmtree operation fails in rm_subdirs, wait for this much time (in secs),
+# then retry up to RM_SUBDIRS_N_RETRY times. If it still fails, raise the
+# exception. this mechanism ensures that the sub-process gc have the time to
+# collect and close the memmaps before we fail.
+RM_SUBDIRS_RETRY_TIME = 0.1
+RM_SUBDIRS_N_RETRY = 10
+
+
+def rm_subdirs(path, onerror=None):
+    """Remove all subdirectories in this path.
+
+    The directory indicated by `path` is left in place, and its subdirectories
+    are erased.
+
+    If onerror is set, it is called to handle the error with arguments (func,
+    path, exc_info) where func is os.listdir, os.remove, or os.rmdir;
+    path is the argument to that function that caused it to fail; and
+    exc_info is a tuple returned by sys.exc_info().  If onerror is None,
+    an exception is raised.
+    """
+
+    # NOTE this code is adapted from the one in shutil.rmtree, and is
+    # just as fast
+
+    names = []
+    try:
+        names = os.listdir(path)
+    except os.error:
+        if onerror is not None:
+            onerror(os.listdir, path, sys.exc_info())
+        else:
+            raise
+
+    for name in names:
+        fullname = os.path.join(path, name)
+        delete_folder(fullname, onerror=onerror)
+
+
+def delete_folder(folder_path, onerror=None, allow_non_empty=True):
+    """Utility function to cleanup a temporary folder if it still exists."""
+    if os.path.isdir(folder_path):
+        if onerror is not None:
+            shutil.rmtree(folder_path, False, onerror)
+        else:
+            # allow the rmtree to fail once, wait and re-try.
+            # if the error is raised again, fail
+            err_count = 0
+            while True:
+                files = os.listdir(folder_path)
+                try:
+                    if len(files) == 0 or allow_non_empty:
+                        shutil.rmtree(
+                            folder_path, ignore_errors=False, onerror=None
+                        )
+                        util.debug(
+                            "Successfully deleted {}".format(folder_path))
+                        break
+                    else:
+                        raise OSError(
+                            "Expected empty folder {} but got {} "
+                            "files.".format(folder_path, len(files))
+                        )
+                except (OSError, WindowsError):
+                    err_count += 1
+                    if err_count > RM_SUBDIRS_N_RETRY:
+                        # the folder cannot be deleted right now. It maybe
+                        # because some temporary files have not been deleted
+                        # yet.
+                        raise
+                time.sleep(RM_SUBDIRS_RETRY_TIME)
diff --git a/llm/Lib/site-packages/joblib/executor.py b/llm/Lib/site-packages/joblib/executor.py
new file mode 100644
index 0000000000000000000000000000000000000000..6837a7d147411cd74034a078ff98cab916ec36ce
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/executor.py
@@ -0,0 +1,117 @@
+"""Utility function to construct a loky.ReusableExecutor with custom pickler.
+
+This module provides efficient ways of working with data stored in
+shared memory with numpy.memmap arrays without inducing any memory
+copy between the parent and child processes.
+"""
+# Author: Thomas Moreau <thomas.moreau.2010@gmail.com>
+# Copyright: 2017, Thomas Moreau
+# License: BSD 3 clause
+
+from ._memmapping_reducer import get_memmapping_reducers
+from ._memmapping_reducer import TemporaryResourcesManager
+from .externals.loky.reusable_executor import _ReusablePoolExecutor
+
+
+_executor_args = None
+
+
+def get_memmapping_executor(n_jobs, **kwargs):
+    return MemmappingExecutor.get_memmapping_executor(n_jobs, **kwargs)
+
+
+class MemmappingExecutor(_ReusablePoolExecutor):
+
+    @classmethod
+    def get_memmapping_executor(cls, n_jobs, timeout=300, initializer=None,
+                                initargs=(), env=None, temp_folder=None,
+                                context_id=None, **backend_args):
+        """Factory for ReusableExecutor with automatic memmapping for large
+        numpy arrays.
+        """
+        global _executor_args
+        # Check if we can reuse the executor here instead of deferring the test
+        # to loky as the reducers are objects that changes at each call.
+        executor_args = backend_args.copy()
+        executor_args.update(env if env else {})
+        executor_args.update(dict(
+            timeout=timeout, initializer=initializer, initargs=initargs))
+        reuse = _executor_args is None or _executor_args == executor_args
+        _executor_args = executor_args
+
+        manager = TemporaryResourcesManager(temp_folder)
+
+        # reducers access the temporary folder in which to store temporary
+        # pickles through a call to manager.resolve_temp_folder_name. resolving
+        # the folder name dynamically is useful to use different folders across
+        # calls of a same reusable executor
+        job_reducers, result_reducers = get_memmapping_reducers(
+            unlink_on_gc_collect=True,
+            temp_folder_resolver=manager.resolve_temp_folder_name,
+            **backend_args)
+        _executor, executor_is_reused = super().get_reusable_executor(
+            n_jobs, job_reducers=job_reducers, result_reducers=result_reducers,
+            reuse=reuse, timeout=timeout, initializer=initializer,
+            initargs=initargs, env=env
+        )
+
+        if not executor_is_reused:
+            # Only set a _temp_folder_manager for new executors. Reused
+            # executors already have a _temporary_folder_manager that must not
+            # be re-assigned like that because it is referenced in various
+            # places in the reducing machinery of the executor.
+            _executor._temp_folder_manager = manager
+
+        if context_id is not None:
+            # Only register the specified context once we know which manager
+            # the current executor is using, in order to not register an atexit
+            # finalizer twice for the same folder.
+            _executor._temp_folder_manager.register_new_context(context_id)
+
+        return _executor
+
+    def terminate(self, kill_workers=False):
+
+        self.shutdown(kill_workers=kill_workers)
+
+        # When workers are killed in a brutal manner, they cannot execute the
+        # finalizer of their shared memmaps. The refcount of those memmaps may
+        # be off by an unknown number, so instead of decref'ing them, we force
+        # delete the whole temporary folder, and unregister them. There is no
+        # risk of PermissionError at folder deletion because at this
+        # point, all child processes are dead, so all references to temporary
+        # memmaps are closed. Otherwise, just try to delete as much as possible
+        # with allow_non_empty=True but if we can't, it will be clean up later
+        # on by the resource_tracker.
+        with self._submit_resize_lock:
+            self._temp_folder_manager._clean_temporary_resources(
+                force=kill_workers, allow_non_empty=True
+            )
+
+    @property
+    def _temp_folder(self):
+        # Legacy property in tests. could be removed if we refactored the
+        # memmapping tests. SHOULD ONLY BE USED IN TESTS!
+        # We cache this property because it is called late in the tests - at
+        # this point, all context have been unregistered, and
+        # resolve_temp_folder_name raises an error.
+        if getattr(self, '_cached_temp_folder', None) is not None:
+            return self._cached_temp_folder
+        else:
+            self._cached_temp_folder = self._temp_folder_manager.resolve_temp_folder_name()  # noqa
+            return self._cached_temp_folder
+
+
+class _TestingMemmappingExecutor(MemmappingExecutor):
+    """Wrapper around ReusableExecutor to ease memmapping testing with Pool
+    and Executor. This is only for testing purposes.
+
+    """
+    def apply_async(self, func, args):
+        """Schedule a func to be run"""
+        future = self.submit(func, *args)
+        future.get = future.result
+        return future
+
+    def map(self, f, *args):
+        return list(super().map(f, *args))
diff --git a/llm/Lib/site-packages/joblib/externals/__init__.py b/llm/Lib/site-packages/joblib/externals/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/joblib/externals/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7931a5c96ad7adba5edab66ea3f29dd59a41fb0f
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/cloudpickle/__init__.py b/llm/Lib/site-packages/joblib/externals/cloudpickle/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..58a8d086ff616b2ef75ab0d788d990e749f96e8d
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/cloudpickle/__init__.py
@@ -0,0 +1,18 @@
+from . import cloudpickle
+from .cloudpickle import *  # noqa
+
+__doc__ = cloudpickle.__doc__
+
+__version__ = "3.0.0"
+
+__all__ = [  # noqa
+    "__version__",
+    "Pickler",
+    "CloudPickler",
+    "dumps",
+    "loads",
+    "dump",
+    "load",
+    "register_pickle_by_value",
+    "unregister_pickle_by_value",
+]
diff --git a/llm/Lib/site-packages/joblib/externals/cloudpickle/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/cloudpickle/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e7126be14a665b904a6c62a42185053aee98eb1
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/cloudpickle/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/cloudpickle/__pycache__/cloudpickle.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/cloudpickle/__pycache__/cloudpickle.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ccc94e6ec1ddb86123807409b8dcbfb766604687
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/cloudpickle/__pycache__/cloudpickle.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/cloudpickle/__pycache__/cloudpickle_fast.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/cloudpickle/__pycache__/cloudpickle_fast.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fca4c57cfecbeff00ee2ff15f52bffc1b3f186b4
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/cloudpickle/__pycache__/cloudpickle_fast.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/cloudpickle/cloudpickle.py b/llm/Lib/site-packages/joblib/externals/cloudpickle/cloudpickle.py
new file mode 100644
index 0000000000000000000000000000000000000000..eb43a9676bbb11bdecf187e7f6cde51f793ff3fc
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/cloudpickle/cloudpickle.py
@@ -0,0 +1,1487 @@
+"""Pickler class to extend the standard pickle.Pickler functionality
+
+The main objective is to make it natural to perform distributed computing on
+clusters (such as PySpark, Dask, Ray...) with interactively defined code
+(functions, classes, ...) written in notebooks or console.
+
+In particular this pickler adds the following features:
+- serialize interactively-defined or locally-defined functions, classes,
+  enums, typevars, lambdas and nested functions to compiled byte code;
+- deal with some other non-serializable objects in an ad-hoc manner where
+  applicable.
+
+This pickler is therefore meant to be used for the communication between short
+lived Python processes running the same version of Python and libraries. In
+particular, it is not meant to be used for long term storage of Python objects.
+
+It does not include an unpickler, as standard Python unpickling suffices.
+
+This module was extracted from the `cloud` package, developed by `PiCloud, Inc.
+<https://web.archive.org/web/20140626004012/http://www.picloud.com/>`_.
+
+Copyright (c) 2012-now, CloudPickle developers and contributors.
+Copyright (c) 2012, Regents of the University of California.
+Copyright (c) 2009 `PiCloud, Inc. <https://web.archive.org/web/20140626004012/http://www.picloud.com/>`_.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the University of California, Berkeley nor the
+      names of its contributors may be used to endorse or promote
+      products derived from this software without specific prior written
+      permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+
+import _collections_abc
+from collections import ChainMap, OrderedDict
+import abc
+import builtins
+import copyreg
+import dataclasses
+import dis
+from enum import Enum
+import io
+import itertools
+import logging
+import opcode
+import pickle
+from pickle import _getattribute
+import platform
+import struct
+import sys
+import threading
+import types
+import typing
+import uuid
+import warnings
+import weakref
+
+# The following import is required to be imported in the cloudpickle
+# namespace to be able to load pickle files generated with older versions of
+# cloudpickle. See: tests/test_backward_compat.py
+from types import CellType  # noqa: F401
+
+
+# cloudpickle is meant for inter process communication: we expect all
+# communicating processes to run the same Python version hence we favor
+# communication speed over compatibility:
+DEFAULT_PROTOCOL = pickle.HIGHEST_PROTOCOL
+
+# Names of modules whose resources should be treated as dynamic.
+_PICKLE_BY_VALUE_MODULES = set()
+
+# Track the provenance of reconstructed dynamic classes to make it possible to
+# reconstruct instances from the matching singleton class definition when
+# appropriate and preserve the usual "isinstance" semantics of Python objects.
+_DYNAMIC_CLASS_TRACKER_BY_CLASS = weakref.WeakKeyDictionary()
+_DYNAMIC_CLASS_TRACKER_BY_ID = weakref.WeakValueDictionary()
+_DYNAMIC_CLASS_TRACKER_LOCK = threading.Lock()
+
+PYPY = platform.python_implementation() == "PyPy"
+
+builtin_code_type = None
+if PYPY:
+    # builtin-code objects only exist in pypy
+    builtin_code_type = type(float.__new__.__code__)
+
+_extract_code_globals_cache = weakref.WeakKeyDictionary()
+
+
+def _get_or_create_tracker_id(class_def):
+    with _DYNAMIC_CLASS_TRACKER_LOCK:
+        class_tracker_id = _DYNAMIC_CLASS_TRACKER_BY_CLASS.get(class_def)
+        if class_tracker_id is None:
+            class_tracker_id = uuid.uuid4().hex
+            _DYNAMIC_CLASS_TRACKER_BY_CLASS[class_def] = class_tracker_id
+            _DYNAMIC_CLASS_TRACKER_BY_ID[class_tracker_id] = class_def
+    return class_tracker_id
+
+
+def _lookup_class_or_track(class_tracker_id, class_def):
+    if class_tracker_id is not None:
+        with _DYNAMIC_CLASS_TRACKER_LOCK:
+            class_def = _DYNAMIC_CLASS_TRACKER_BY_ID.setdefault(
+                class_tracker_id, class_def
+            )
+            _DYNAMIC_CLASS_TRACKER_BY_CLASS[class_def] = class_tracker_id
+    return class_def
+
+
+def register_pickle_by_value(module):
+    """Register a module to make it functions and classes picklable by value.
+
+    By default, functions and classes that are attributes of an importable
+    module are to be pickled by reference, that is relying on re-importing
+    the attribute from the module at load time.
+
+    If `register_pickle_by_value(module)` is called, all its functions and
+    classes are subsequently to be pickled by value, meaning that they can
+    be loaded in Python processes where the module is not importable.
+
+    This is especially useful when developing a module in a distributed
+    execution environment: restarting the client Python process with the new
+    source code is enough: there is no need to re-install the new version
+    of the module on all the worker nodes nor to restart the workers.
+
+    Note: this feature is considered experimental. See the cloudpickle
+    README.md file for more details and limitations.
+    """
+    if not isinstance(module, types.ModuleType):
+        raise ValueError(f"Input should be a module object, got {str(module)} instead")
+    # In the future, cloudpickle may need a way to access any module registered
+    # for pickling by value in order to introspect relative imports inside
+    # functions pickled by value. (see
+    # https://github.com/cloudpipe/cloudpickle/pull/417#issuecomment-873684633).
+    # This access can be ensured by checking that module is present in
+    # sys.modules at registering time and assuming that it will still be in
+    # there when accessed during pickling. Another alternative would be to
+    # store a weakref to the module. Even though cloudpickle does not implement
+    # this introspection yet, in order to avoid a possible breaking change
+    # later, we still enforce the presence of module inside sys.modules.
+    if module.__name__ not in sys.modules:
+        raise ValueError(
+            f"{module} was not imported correctly, have you used an "
+            "`import` statement to access it?"
+        )
+    _PICKLE_BY_VALUE_MODULES.add(module.__name__)
+
+
+def unregister_pickle_by_value(module):
+    """Unregister that the input module should be pickled by value."""
+    if not isinstance(module, types.ModuleType):
+        raise ValueError(f"Input should be a module object, got {str(module)} instead")
+    if module.__name__ not in _PICKLE_BY_VALUE_MODULES:
+        raise ValueError(f"{module} is not registered for pickle by value")
+    else:
+        _PICKLE_BY_VALUE_MODULES.remove(module.__name__)
+
+
+def list_registry_pickle_by_value():
+    return _PICKLE_BY_VALUE_MODULES.copy()
+
+
+def _is_registered_pickle_by_value(module):
+    module_name = module.__name__
+    if module_name in _PICKLE_BY_VALUE_MODULES:
+        return True
+    while True:
+        parent_name = module_name.rsplit(".", 1)[0]
+        if parent_name == module_name:
+            break
+        if parent_name in _PICKLE_BY_VALUE_MODULES:
+            return True
+        module_name = parent_name
+    return False
+
+
+def _whichmodule(obj, name):
+    """Find the module an object belongs to.
+
+    This function differs from ``pickle.whichmodule`` in two ways:
+    - it does not mangle the cases where obj's module is __main__ and obj was
+      not found in any module.
+    - Errors arising during module introspection are ignored, as those errors
+      are considered unwanted side effects.
+    """
+    module_name = getattr(obj, "__module__", None)
+
+    if module_name is not None:
+        return module_name
+    # Protect the iteration by using a copy of sys.modules against dynamic
+    # modules that trigger imports of other modules upon calls to getattr or
+    # other threads importing at the same time.
+    for module_name, module in sys.modules.copy().items():
+        # Some modules such as coverage can inject non-module objects inside
+        # sys.modules
+        if (
+            module_name == "__main__"
+            or module is None
+            or not isinstance(module, types.ModuleType)
+        ):
+            continue
+        try:
+            if _getattribute(module, name)[0] is obj:
+                return module_name
+        except Exception:
+            pass
+    return None
+
+
+def _should_pickle_by_reference(obj, name=None):
+    """Test whether an function or a class should be pickled by reference
+
+    Pickling by reference means by that the object (typically a function or a
+    class) is an attribute of a module that is assumed to be importable in the
+    target Python environment. Loading will therefore rely on importing the
+    module and then calling `getattr` on it to access the function or class.
+
+    Pickling by reference is the only option to pickle functions and classes
+    in the standard library. In cloudpickle the alternative option is to
+    pickle by value (for instance for interactively or locally defined
+    functions and classes or for attributes of modules that have been
+    explicitly registered to be pickled by value.
+    """
+    if isinstance(obj, types.FunctionType) or issubclass(type(obj), type):
+        module_and_name = _lookup_module_and_qualname(obj, name=name)
+        if module_and_name is None:
+            return False
+        module, name = module_and_name
+        return not _is_registered_pickle_by_value(module)
+
+    elif isinstance(obj, types.ModuleType):
+        # We assume that sys.modules is primarily used as a cache mechanism for
+        # the Python import machinery. Checking if a module has been added in
+        # is sys.modules therefore a cheap and simple heuristic to tell us
+        # whether we can assume that a given module could be imported by name
+        # in another Python process.
+        if _is_registered_pickle_by_value(obj):
+            return False
+        return obj.__name__ in sys.modules
+    else:
+        raise TypeError(
+            "cannot check importability of {} instances".format(type(obj).__name__)
+        )
+
+
+def _lookup_module_and_qualname(obj, name=None):
+    if name is None:
+        name = getattr(obj, "__qualname__", None)
+    if name is None:  # pragma: no cover
+        # This used to be needed for Python 2.7 support but is probably not
+        # needed anymore. However we keep the __name__ introspection in case
+        # users of cloudpickle rely on this old behavior for unknown reasons.
+        name = getattr(obj, "__name__", None)
+
+    module_name = _whichmodule(obj, name)
+
+    if module_name is None:
+        # In this case, obj.__module__ is None AND obj was not found in any
+        # imported module. obj is thus treated as dynamic.
+        return None
+
+    if module_name == "__main__":
+        return None
+
+    # Note: if module_name is in sys.modules, the corresponding module is
+    # assumed importable at unpickling time. See #357
+    module = sys.modules.get(module_name, None)
+    if module is None:
+        # The main reason why obj's module would not be imported is that this
+        # module has been dynamically created, using for example
+        # types.ModuleType. The other possibility is that module was removed
+        # from sys.modules after obj was created/imported. But this case is not
+        # supported, as the standard pickle does not support it either.
+        return None
+
+    try:
+        obj2, parent = _getattribute(module, name)
+    except AttributeError:
+        # obj was not found inside the module it points to
+        return None
+    if obj2 is not obj:
+        return None
+    return module, name
+
+
+def _extract_code_globals(co):
+    """Find all globals names read or written to by codeblock co."""
+    out_names = _extract_code_globals_cache.get(co)
+    if out_names is None:
+        # We use a dict with None values instead of a set to get a
+        # deterministic order and avoid introducing non-deterministic pickle
+        # bytes as a results.
+        out_names = {name: None for name in _walk_global_ops(co)}
+
+        # Declaring a function inside another one using the "def ..." syntax
+        # generates a constant code object corresponding to the one of the
+        # nested function's As the nested function may itself need global
+        # variables, we need to introspect its code, extract its globals, (look
+        # for code object in it's co_consts attribute..) and add the result to
+        # code_globals
+        if co.co_consts:
+            for const in co.co_consts:
+                if isinstance(const, types.CodeType):
+                    out_names.update(_extract_code_globals(const))
+
+        _extract_code_globals_cache[co] = out_names
+
+    return out_names
+
+
+def _find_imported_submodules(code, top_level_dependencies):
+    """Find currently imported submodules used by a function.
+
+    Submodules used by a function need to be detected and referenced for the
+    function to work correctly at depickling time. Because submodules can be
+    referenced as attribute of their parent package (``package.submodule``), we
+    need a special introspection technique that does not rely on GLOBAL-related
+    opcodes to find references of them in a code object.
+
+    Example:
+    ```
+    import concurrent.futures
+    import cloudpickle
+    def func():
+        x = concurrent.futures.ThreadPoolExecutor
+    if __name__ == '__main__':
+        cloudpickle.dumps(func)
+    ```
+    The globals extracted by cloudpickle in the function's state include the
+    concurrent package, but not its submodule (here, concurrent.futures), which
+    is the module used by func. Find_imported_submodules will detect the usage
+    of concurrent.futures. Saving this module alongside with func will ensure
+    that calling func once depickled does not fail due to concurrent.futures
+    not being imported
+    """
+
+    subimports = []
+    # check if any known dependency is an imported package
+    for x in top_level_dependencies:
+        if (
+            isinstance(x, types.ModuleType)
+            and hasattr(x, "__package__")
+            and x.__package__
+        ):
+            # check if the package has any currently loaded sub-imports
+            prefix = x.__name__ + "."
+            # A concurrent thread could mutate sys.modules,
+            # make sure we iterate over a copy to avoid exceptions
+            for name in list(sys.modules):
+                # Older versions of pytest will add a "None" module to
+                # sys.modules.
+                if name is not None and name.startswith(prefix):
+                    # check whether the function can address the sub-module
+                    tokens = set(name[len(prefix) :].split("."))
+                    if not tokens - set(code.co_names):
+                        subimports.append(sys.modules[name])
+    return subimports
+
+
+# relevant opcodes
+STORE_GLOBAL = opcode.opmap["STORE_GLOBAL"]
+DELETE_GLOBAL = opcode.opmap["DELETE_GLOBAL"]
+LOAD_GLOBAL = opcode.opmap["LOAD_GLOBAL"]
+GLOBAL_OPS = (STORE_GLOBAL, DELETE_GLOBAL, LOAD_GLOBAL)
+HAVE_ARGUMENT = dis.HAVE_ARGUMENT
+EXTENDED_ARG = dis.EXTENDED_ARG
+
+
+_BUILTIN_TYPE_NAMES = {}
+for k, v in types.__dict__.items():
+    if type(v) is type:
+        _BUILTIN_TYPE_NAMES[v] = k
+
+
+def _builtin_type(name):
+    if name == "ClassType":  # pragma: no cover
+        # Backward compat to load pickle files generated with cloudpickle
+        # < 1.3 even if loading pickle files from older versions is not
+        # officially supported.
+        return type
+    return getattr(types, name)
+
+
+def _walk_global_ops(code):
+    """Yield referenced name for global-referencing instructions in code."""
+    for instr in dis.get_instructions(code):
+        op = instr.opcode
+        if op in GLOBAL_OPS:
+            yield instr.argval
+
+
+def _extract_class_dict(cls):
+    """Retrieve a copy of the dict of a class without the inherited method."""
+    clsdict = dict(cls.__dict__)  # copy dict proxy to a dict
+    if len(cls.__bases__) == 1:
+        inherited_dict = cls.__bases__[0].__dict__
+    else:
+        inherited_dict = {}
+        for base in reversed(cls.__bases__):
+            inherited_dict.update(base.__dict__)
+    to_remove = []
+    for name, value in clsdict.items():
+        try:
+            base_value = inherited_dict[name]
+            if value is base_value:
+                to_remove.append(name)
+        except KeyError:
+            pass
+    for name in to_remove:
+        clsdict.pop(name)
+    return clsdict
+
+
+def is_tornado_coroutine(func):
+    """Return whether `func` is a Tornado coroutine function.
+
+    Running coroutines are not supported.
+    """
+    warnings.warn(
+        "is_tornado_coroutine is deprecated in cloudpickle 3.0 and will be "
+        "removed in cloudpickle 4.0. Use tornado.gen.is_coroutine_function "
+        "directly instead.",
+        category=DeprecationWarning,
+    )
+    if "tornado.gen" not in sys.modules:
+        return False
+    gen = sys.modules["tornado.gen"]
+    if not hasattr(gen, "is_coroutine_function"):
+        # Tornado version is too old
+        return False
+    return gen.is_coroutine_function(func)
+
+
+def subimport(name):
+    # We cannot do simply: `return __import__(name)`: Indeed, if ``name`` is
+    # the name of a submodule, __import__ will return the top-level root module
+    # of this submodule. For instance, __import__('os.path') returns the `os`
+    # module.
+    __import__(name)
+    return sys.modules[name]
+
+
+def dynamic_subimport(name, vars):
+    mod = types.ModuleType(name)
+    mod.__dict__.update(vars)
+    mod.__dict__["__builtins__"] = builtins.__dict__
+    return mod
+
+
+def _get_cell_contents(cell):
+    try:
+        return cell.cell_contents
+    except ValueError:
+        # Handle empty cells explicitly with a sentinel value.
+        return _empty_cell_value
+
+
+def instance(cls):
+    """Create a new instance of a class.
+
+    Parameters
+    ----------
+    cls : type
+        The class to create an instance of.
+
+    Returns
+    -------
+    instance : cls
+        A new instance of ``cls``.
+    """
+    return cls()
+
+
+@instance
+class _empty_cell_value:
+    """Sentinel for empty closures."""
+
+    @classmethod
+    def __reduce__(cls):
+        return cls.__name__
+
+
+def _make_function(code, globals, name, argdefs, closure):
+    # Setting __builtins__ in globals is needed for nogil CPython.
+    globals["__builtins__"] = __builtins__
+    return types.FunctionType(code, globals, name, argdefs, closure)
+
+
+def _make_empty_cell():
+    if False:
+        # trick the compiler into creating an empty cell in our lambda
+        cell = None
+        raise AssertionError("this route should not be executed")
+
+    return (lambda: cell).__closure__[0]
+
+
+def _make_cell(value=_empty_cell_value):
+    cell = _make_empty_cell()
+    if value is not _empty_cell_value:
+        cell.cell_contents = value
+    return cell
+
+
+def _make_skeleton_class(
+    type_constructor, name, bases, type_kwargs, class_tracker_id, extra
+):
+    """Build dynamic class with an empty __dict__ to be filled once memoized
+
+    If class_tracker_id is not None, try to lookup an existing class definition
+    matching that id. If none is found, track a newly reconstructed class
+    definition under that id so that other instances stemming from the same
+    class id will also reuse this class definition.
+
+    The "extra" variable is meant to be a dict (or None) that can be used for
+    forward compatibility shall the need arise.
+    """
+    skeleton_class = types.new_class(
+        name, bases, {"metaclass": type_constructor}, lambda ns: ns.update(type_kwargs)
+    )
+    return _lookup_class_or_track(class_tracker_id, skeleton_class)
+
+
+def _make_skeleton_enum(
+    bases, name, qualname, members, module, class_tracker_id, extra
+):
+    """Build dynamic enum with an empty __dict__ to be filled once memoized
+
+    The creation of the enum class is inspired by the code of
+    EnumMeta._create_.
+
+    If class_tracker_id is not None, try to lookup an existing enum definition
+    matching that id. If none is found, track a newly reconstructed enum
+    definition under that id so that other instances stemming from the same
+    class id will also reuse this enum definition.
+
+    The "extra" variable is meant to be a dict (or None) that can be used for
+    forward compatibility shall the need arise.
+    """
+    # enums always inherit from their base Enum class at the last position in
+    # the list of base classes:
+    enum_base = bases[-1]
+    metacls = enum_base.__class__
+    classdict = metacls.__prepare__(name, bases)
+
+    for member_name, member_value in members.items():
+        classdict[member_name] = member_value
+    enum_class = metacls.__new__(metacls, name, bases, classdict)
+    enum_class.__module__ = module
+    enum_class.__qualname__ = qualname
+
+    return _lookup_class_or_track(class_tracker_id, enum_class)
+
+
+def _make_typevar(name, bound, constraints, covariant, contravariant, class_tracker_id):
+    tv = typing.TypeVar(
+        name,
+        *constraints,
+        bound=bound,
+        covariant=covariant,
+        contravariant=contravariant,
+    )
+    return _lookup_class_or_track(class_tracker_id, tv)
+
+
+def _decompose_typevar(obj):
+    return (
+        obj.__name__,
+        obj.__bound__,
+        obj.__constraints__,
+        obj.__covariant__,
+        obj.__contravariant__,
+        _get_or_create_tracker_id(obj),
+    )
+
+
+def _typevar_reduce(obj):
+    # TypeVar instances require the module information hence why we
+    # are not using the _should_pickle_by_reference directly
+    module_and_name = _lookup_module_and_qualname(obj, name=obj.__name__)
+
+    if module_and_name is None:
+        return (_make_typevar, _decompose_typevar(obj))
+    elif _is_registered_pickle_by_value(module_and_name[0]):
+        return (_make_typevar, _decompose_typevar(obj))
+
+    return (getattr, module_and_name)
+
+
+def _get_bases(typ):
+    if "__orig_bases__" in getattr(typ, "__dict__", {}):
+        # For generic types (see PEP 560)
+        # Note that simply checking `hasattr(typ, '__orig_bases__')` is not
+        # correct.  Subclasses of a fully-parameterized generic class does not
+        # have `__orig_bases__` defined, but `hasattr(typ, '__orig_bases__')`
+        # will return True because it's defined in the base class.
+        bases_attr = "__orig_bases__"
+    else:
+        # For regular class objects
+        bases_attr = "__bases__"
+    return getattr(typ, bases_attr)
+
+
+def _make_dict_keys(obj, is_ordered=False):
+    if is_ordered:
+        return OrderedDict.fromkeys(obj).keys()
+    else:
+        return dict.fromkeys(obj).keys()
+
+
+def _make_dict_values(obj, is_ordered=False):
+    if is_ordered:
+        return OrderedDict((i, _) for i, _ in enumerate(obj)).values()
+    else:
+        return {i: _ for i, _ in enumerate(obj)}.values()
+
+
+def _make_dict_items(obj, is_ordered=False):
+    if is_ordered:
+        return OrderedDict(obj).items()
+    else:
+        return obj.items()
+
+
+# COLLECTION OF OBJECTS __getnewargs__-LIKE METHODS
+# -------------------------------------------------
+
+
+def _class_getnewargs(obj):
+    type_kwargs = {}
+    if "__module__" in obj.__dict__:
+        type_kwargs["__module__"] = obj.__module__
+
+    __dict__ = obj.__dict__.get("__dict__", None)
+    if isinstance(__dict__, property):
+        type_kwargs["__dict__"] = __dict__
+
+    return (
+        type(obj),
+        obj.__name__,
+        _get_bases(obj),
+        type_kwargs,
+        _get_or_create_tracker_id(obj),
+        None,
+    )
+
+
+def _enum_getnewargs(obj):
+    members = {e.name: e.value for e in obj}
+    return (
+        obj.__bases__,
+        obj.__name__,
+        obj.__qualname__,
+        members,
+        obj.__module__,
+        _get_or_create_tracker_id(obj),
+        None,
+    )
+
+
+# COLLECTION OF OBJECTS RECONSTRUCTORS
+# ------------------------------------
+def _file_reconstructor(retval):
+    return retval
+
+
+# COLLECTION OF OBJECTS STATE GETTERS
+# -----------------------------------
+
+
+def _function_getstate(func):
+    # - Put func's dynamic attributes (stored in func.__dict__) in state. These
+    #   attributes will be restored at unpickling time using
+    #   f.__dict__.update(state)
+    # - Put func's members into slotstate. Such attributes will be restored at
+    #   unpickling time by iterating over slotstate and calling setattr(func,
+    #   slotname, slotvalue)
+    slotstate = {
+        "__name__": func.__name__,
+        "__qualname__": func.__qualname__,
+        "__annotations__": func.__annotations__,
+        "__kwdefaults__": func.__kwdefaults__,
+        "__defaults__": func.__defaults__,
+        "__module__": func.__module__,
+        "__doc__": func.__doc__,
+        "__closure__": func.__closure__,
+    }
+
+    f_globals_ref = _extract_code_globals(func.__code__)
+    f_globals = {k: func.__globals__[k] for k in f_globals_ref if k in func.__globals__}
+
+    if func.__closure__ is not None:
+        closure_values = list(map(_get_cell_contents, func.__closure__))
+    else:
+        closure_values = ()
+
+    # Extract currently-imported submodules used by func. Storing these modules
+    # in a smoke _cloudpickle_subimports attribute of the object's state will
+    # trigger the side effect of importing these modules at unpickling time
+    # (which is necessary for func to work correctly once depickled)
+    slotstate["_cloudpickle_submodules"] = _find_imported_submodules(
+        func.__code__, itertools.chain(f_globals.values(), closure_values)
+    )
+    slotstate["__globals__"] = f_globals
+
+    state = func.__dict__
+    return state, slotstate
+
+
+def _class_getstate(obj):
+    clsdict = _extract_class_dict(obj)
+    clsdict.pop("__weakref__", None)
+
+    if issubclass(type(obj), abc.ABCMeta):
+        # If obj is an instance of an ABCMeta subclass, don't pickle the
+        # cache/negative caches populated during isinstance/issubclass
+        # checks, but pickle the list of registered subclasses of obj.
+        clsdict.pop("_abc_cache", None)
+        clsdict.pop("_abc_negative_cache", None)
+        clsdict.pop("_abc_negative_cache_version", None)
+        registry = clsdict.pop("_abc_registry", None)
+        if registry is None:
+            # The abc caches and registered subclasses of a
+            # class are bundled into the single _abc_impl attribute
+            clsdict.pop("_abc_impl", None)
+            (registry, _, _, _) = abc._get_dump(obj)
+
+            clsdict["_abc_impl"] = [subclass_weakref() for subclass_weakref in registry]
+        else:
+            # In the above if clause, registry is a set of weakrefs -- in
+            # this case, registry is a WeakSet
+            clsdict["_abc_impl"] = [type_ for type_ in registry]
+
+    if "__slots__" in clsdict:
+        # pickle string length optimization: member descriptors of obj are
+        # created automatically from obj's __slots__ attribute, no need to
+        # save them in obj's state
+        if isinstance(obj.__slots__, str):
+            clsdict.pop(obj.__slots__)
+        else:
+            for k in obj.__slots__:
+                clsdict.pop(k, None)
+
+    clsdict.pop("__dict__", None)  # unpicklable property object
+
+    return (clsdict, {})
+
+
+def _enum_getstate(obj):
+    clsdict, slotstate = _class_getstate(obj)
+
+    members = {e.name: e.value for e in obj}
+    # Cleanup the clsdict that will be passed to _make_skeleton_enum:
+    # Those attributes are already handled by the metaclass.
+    for attrname in [
+        "_generate_next_value_",
+        "_member_names_",
+        "_member_map_",
+        "_member_type_",
+        "_value2member_map_",
+    ]:
+        clsdict.pop(attrname, None)
+    for member in members:
+        clsdict.pop(member)
+        # Special handling of Enum subclasses
+    return clsdict, slotstate
+
+
+# COLLECTIONS OF OBJECTS REDUCERS
+# -------------------------------
+# A reducer is a function taking a single argument (obj), and that returns a
+# tuple with all the necessary data to re-construct obj. Apart from a few
+# exceptions (list, dict, bytes, int, etc.), a reducer is necessary to
+# correctly pickle an object.
+# While many built-in objects (Exceptions objects, instances of the "object"
+# class, etc), are shipped with their own built-in reducer (invoked using
+# obj.__reduce__), some do not. The following methods were created to "fill
+# these holes".
+
+
+def _code_reduce(obj):
+    """code object reducer."""
+    # If you are not sure about the order of arguments, take a look at help
+    # of the specific type from types, for example:
+    # >>> from types import CodeType
+    # >>> help(CodeType)
+    if hasattr(obj, "co_exceptiontable"):
+        # Python 3.11 and later: there are some new attributes
+        # related to the enhanced exceptions.
+        args = (
+            obj.co_argcount,
+            obj.co_posonlyargcount,
+            obj.co_kwonlyargcount,
+            obj.co_nlocals,
+            obj.co_stacksize,
+            obj.co_flags,
+            obj.co_code,
+            obj.co_consts,
+            obj.co_names,
+            obj.co_varnames,
+            obj.co_filename,
+            obj.co_name,
+            obj.co_qualname,
+            obj.co_firstlineno,
+            obj.co_linetable,
+            obj.co_exceptiontable,
+            obj.co_freevars,
+            obj.co_cellvars,
+        )
+    elif hasattr(obj, "co_linetable"):
+        # Python 3.10 and later: obj.co_lnotab is deprecated and constructor
+        # expects obj.co_linetable instead.
+        args = (
+            obj.co_argcount,
+            obj.co_posonlyargcount,
+            obj.co_kwonlyargcount,
+            obj.co_nlocals,
+            obj.co_stacksize,
+            obj.co_flags,
+            obj.co_code,
+            obj.co_consts,
+            obj.co_names,
+            obj.co_varnames,
+            obj.co_filename,
+            obj.co_name,
+            obj.co_firstlineno,
+            obj.co_linetable,
+            obj.co_freevars,
+            obj.co_cellvars,
+        )
+    elif hasattr(obj, "co_nmeta"):  # pragma: no cover
+        # "nogil" Python: modified attributes from 3.9
+        args = (
+            obj.co_argcount,
+            obj.co_posonlyargcount,
+            obj.co_kwonlyargcount,
+            obj.co_nlocals,
+            obj.co_framesize,
+            obj.co_ndefaultargs,
+            obj.co_nmeta,
+            obj.co_flags,
+            obj.co_code,
+            obj.co_consts,
+            obj.co_varnames,
+            obj.co_filename,
+            obj.co_name,
+            obj.co_firstlineno,
+            obj.co_lnotab,
+            obj.co_exc_handlers,
+            obj.co_jump_table,
+            obj.co_freevars,
+            obj.co_cellvars,
+            obj.co_free2reg,
+            obj.co_cell2reg,
+        )
+    else:
+        # Backward compat for 3.8 and 3.9
+        args = (
+            obj.co_argcount,
+            obj.co_posonlyargcount,
+            obj.co_kwonlyargcount,
+            obj.co_nlocals,
+            obj.co_stacksize,
+            obj.co_flags,
+            obj.co_code,
+            obj.co_consts,
+            obj.co_names,
+            obj.co_varnames,
+            obj.co_filename,
+            obj.co_name,
+            obj.co_firstlineno,
+            obj.co_lnotab,
+            obj.co_freevars,
+            obj.co_cellvars,
+        )
+    return types.CodeType, args
+
+
+def _cell_reduce(obj):
+    """Cell (containing values of a function's free variables) reducer."""
+    try:
+        obj.cell_contents
+    except ValueError:  # cell is empty
+        return _make_empty_cell, ()
+    else:
+        return _make_cell, (obj.cell_contents,)
+
+
+def _classmethod_reduce(obj):
+    orig_func = obj.__func__
+    return type(obj), (orig_func,)
+
+
+def _file_reduce(obj):
+    """Save a file."""
+    import io
+
+    if not hasattr(obj, "name") or not hasattr(obj, "mode"):
+        raise pickle.PicklingError(
+            "Cannot pickle files that do not map to an actual file"
+        )
+    if obj is sys.stdout:
+        return getattr, (sys, "stdout")
+    if obj is sys.stderr:
+        return getattr, (sys, "stderr")
+    if obj is sys.stdin:
+        raise pickle.PicklingError("Cannot pickle standard input")
+    if obj.closed:
+        raise pickle.PicklingError("Cannot pickle closed files")
+    if hasattr(obj, "isatty") and obj.isatty():
+        raise pickle.PicklingError("Cannot pickle files that map to tty objects")
+    if "r" not in obj.mode and "+" not in obj.mode:
+        raise pickle.PicklingError(
+            "Cannot pickle files that are not opened for reading: %s" % obj.mode
+        )
+
+    name = obj.name
+
+    retval = io.StringIO()
+
+    try:
+        # Read the whole file
+        curloc = obj.tell()
+        obj.seek(0)
+        contents = obj.read()
+        obj.seek(curloc)
+    except OSError as e:
+        raise pickle.PicklingError(
+            "Cannot pickle file %s as it cannot be read" % name
+        ) from e
+    retval.write(contents)
+    retval.seek(curloc)
+
+    retval.name = name
+    return _file_reconstructor, (retval,)
+
+
+def _getset_descriptor_reduce(obj):
+    return getattr, (obj.__objclass__, obj.__name__)
+
+
+def _mappingproxy_reduce(obj):
+    return types.MappingProxyType, (dict(obj),)
+
+
+def _memoryview_reduce(obj):
+    return bytes, (obj.tobytes(),)
+
+
+def _module_reduce(obj):
+    if _should_pickle_by_reference(obj):
+        return subimport, (obj.__name__,)
+    else:
+        # Some external libraries can populate the "__builtins__" entry of a
+        # module's `__dict__` with unpicklable objects (see #316). For that
+        # reason, we do not attempt to pickle the "__builtins__" entry, and
+        # restore a default value for it at unpickling time.
+        state = obj.__dict__.copy()
+        state.pop("__builtins__", None)
+        return dynamic_subimport, (obj.__name__, state)
+
+
+def _method_reduce(obj):
+    return (types.MethodType, (obj.__func__, obj.__self__))
+
+
+def _logger_reduce(obj):
+    return logging.getLogger, (obj.name,)
+
+
+def _root_logger_reduce(obj):
+    return logging.getLogger, ()
+
+
+def _property_reduce(obj):
+    return property, (obj.fget, obj.fset, obj.fdel, obj.__doc__)
+
+
+def _weakset_reduce(obj):
+    return weakref.WeakSet, (list(obj),)
+
+
+def _dynamic_class_reduce(obj):
+    """Save a class that can't be referenced as a module attribute.
+
+    This method is used to serialize classes that are defined inside
+    functions, or that otherwise can't be serialized as attribute lookups
+    from importable modules.
+    """
+    if Enum is not None and issubclass(obj, Enum):
+        return (
+            _make_skeleton_enum,
+            _enum_getnewargs(obj),
+            _enum_getstate(obj),
+            None,
+            None,
+            _class_setstate,
+        )
+    else:
+        return (
+            _make_skeleton_class,
+            _class_getnewargs(obj),
+            _class_getstate(obj),
+            None,
+            None,
+            _class_setstate,
+        )
+
+
+def _class_reduce(obj):
+    """Select the reducer depending on the dynamic nature of the class obj."""
+    if obj is type(None):  # noqa
+        return type, (None,)
+    elif obj is type(Ellipsis):
+        return type, (Ellipsis,)
+    elif obj is type(NotImplemented):
+        return type, (NotImplemented,)
+    elif obj in _BUILTIN_TYPE_NAMES:
+        return _builtin_type, (_BUILTIN_TYPE_NAMES[obj],)
+    elif not _should_pickle_by_reference(obj):
+        return _dynamic_class_reduce(obj)
+    return NotImplemented
+
+
+def _dict_keys_reduce(obj):
+    # Safer not to ship the full dict as sending the rest might
+    # be unintended and could potentially cause leaking of
+    # sensitive information
+    return _make_dict_keys, (list(obj),)
+
+
+def _dict_values_reduce(obj):
+    # Safer not to ship the full dict as sending the rest might
+    # be unintended and could potentially cause leaking of
+    # sensitive information
+    return _make_dict_values, (list(obj),)
+
+
+def _dict_items_reduce(obj):
+    return _make_dict_items, (dict(obj),)
+
+
+def _odict_keys_reduce(obj):
+    # Safer not to ship the full dict as sending the rest might
+    # be unintended and could potentially cause leaking of
+    # sensitive information
+    return _make_dict_keys, (list(obj), True)
+
+
+def _odict_values_reduce(obj):
+    # Safer not to ship the full dict as sending the rest might
+    # be unintended and could potentially cause leaking of
+    # sensitive information
+    return _make_dict_values, (list(obj), True)
+
+
+def _odict_items_reduce(obj):
+    return _make_dict_items, (dict(obj), True)
+
+
+def _dataclass_field_base_reduce(obj):
+    return _get_dataclass_field_type_sentinel, (obj.name,)
+
+
+# COLLECTIONS OF OBJECTS STATE SETTERS
+# ------------------------------------
+# state setters are called at unpickling time, once the object is created and
+# it has to be updated to how it was at unpickling time.
+
+
+def _function_setstate(obj, state):
+    """Update the state of a dynamic function.
+
+    As __closure__ and __globals__ are readonly attributes of a function, we
+    cannot rely on the native setstate routine of pickle.load_build, that calls
+    setattr on items of the slotstate. Instead, we have to modify them inplace.
+    """
+    state, slotstate = state
+    obj.__dict__.update(state)
+
+    obj_globals = slotstate.pop("__globals__")
+    obj_closure = slotstate.pop("__closure__")
+    # _cloudpickle_subimports is a set of submodules that must be loaded for
+    # the pickled function to work correctly at unpickling time. Now that these
+    # submodules are depickled (hence imported), they can be removed from the
+    # object's state (the object state only served as a reference holder to
+    # these submodules)
+    slotstate.pop("_cloudpickle_submodules")
+
+    obj.__globals__.update(obj_globals)
+    obj.__globals__["__builtins__"] = __builtins__
+
+    if obj_closure is not None:
+        for i, cell in enumerate(obj_closure):
+            try:
+                value = cell.cell_contents
+            except ValueError:  # cell is empty
+                continue
+            obj.__closure__[i].cell_contents = value
+
+    for k, v in slotstate.items():
+        setattr(obj, k, v)
+
+
+def _class_setstate(obj, state):
+    state, slotstate = state
+    registry = None
+    for attrname, attr in state.items():
+        if attrname == "_abc_impl":
+            registry = attr
+        else:
+            setattr(obj, attrname, attr)
+    if registry is not None:
+        for subclass in registry:
+            obj.register(subclass)
+
+    return obj
+
+
+# COLLECTION OF DATACLASS UTILITIES
+# ---------------------------------
+# There are some internal sentinel values whose identity must be preserved when
+# unpickling dataclass fields. Each sentinel value has a unique name that we can
+# use to retrieve its identity at unpickling time.
+
+
+_DATACLASSE_FIELD_TYPE_SENTINELS = {
+    dataclasses._FIELD.name: dataclasses._FIELD,
+    dataclasses._FIELD_CLASSVAR.name: dataclasses._FIELD_CLASSVAR,
+    dataclasses._FIELD_INITVAR.name: dataclasses._FIELD_INITVAR,
+}
+
+
+def _get_dataclass_field_type_sentinel(name):
+    return _DATACLASSE_FIELD_TYPE_SENTINELS[name]
+
+
+class Pickler(pickle.Pickler):
+    # set of reducers defined and used by cloudpickle (private)
+    _dispatch_table = {}
+    _dispatch_table[classmethod] = _classmethod_reduce
+    _dispatch_table[io.TextIOWrapper] = _file_reduce
+    _dispatch_table[logging.Logger] = _logger_reduce
+    _dispatch_table[logging.RootLogger] = _root_logger_reduce
+    _dispatch_table[memoryview] = _memoryview_reduce
+    _dispatch_table[property] = _property_reduce
+    _dispatch_table[staticmethod] = _classmethod_reduce
+    _dispatch_table[CellType] = _cell_reduce
+    _dispatch_table[types.CodeType] = _code_reduce
+    _dispatch_table[types.GetSetDescriptorType] = _getset_descriptor_reduce
+    _dispatch_table[types.ModuleType] = _module_reduce
+    _dispatch_table[types.MethodType] = _method_reduce
+    _dispatch_table[types.MappingProxyType] = _mappingproxy_reduce
+    _dispatch_table[weakref.WeakSet] = _weakset_reduce
+    _dispatch_table[typing.TypeVar] = _typevar_reduce
+    _dispatch_table[_collections_abc.dict_keys] = _dict_keys_reduce
+    _dispatch_table[_collections_abc.dict_values] = _dict_values_reduce
+    _dispatch_table[_collections_abc.dict_items] = _dict_items_reduce
+    _dispatch_table[type(OrderedDict().keys())] = _odict_keys_reduce
+    _dispatch_table[type(OrderedDict().values())] = _odict_values_reduce
+    _dispatch_table[type(OrderedDict().items())] = _odict_items_reduce
+    _dispatch_table[abc.abstractmethod] = _classmethod_reduce
+    _dispatch_table[abc.abstractclassmethod] = _classmethod_reduce
+    _dispatch_table[abc.abstractstaticmethod] = _classmethod_reduce
+    _dispatch_table[abc.abstractproperty] = _property_reduce
+    _dispatch_table[dataclasses._FIELD_BASE] = _dataclass_field_base_reduce
+
+    dispatch_table = ChainMap(_dispatch_table, copyreg.dispatch_table)
+
+    # function reducers are defined as instance methods of cloudpickle.Pickler
+    # objects, as they rely on a cloudpickle.Pickler attribute (globals_ref)
+    def _dynamic_function_reduce(self, func):
+        """Reduce a function that is not pickleable via attribute lookup."""
+        newargs = self._function_getnewargs(func)
+        state = _function_getstate(func)
+        return (_make_function, newargs, state, None, None, _function_setstate)
+
+    def _function_reduce(self, obj):
+        """Reducer for function objects.
+
+        If obj is a top-level attribute of a file-backed module, this reducer
+        returns NotImplemented, making the cloudpickle.Pickler fall back to
+        traditional pickle.Pickler routines to save obj. Otherwise, it reduces
+        obj using a custom cloudpickle reducer designed specifically to handle
+        dynamic functions.
+        """
+        if _should_pickle_by_reference(obj):
+            return NotImplemented
+        else:
+            return self._dynamic_function_reduce(obj)
+
+    def _function_getnewargs(self, func):
+        code = func.__code__
+
+        # base_globals represents the future global namespace of func at
+        # unpickling time. Looking it up and storing it in
+        # cloudpickle.Pickler.globals_ref allow functions sharing the same
+        # globals at pickling time to also share them once unpickled, at one
+        # condition: since globals_ref is an attribute of a cloudpickle.Pickler
+        # instance, and that a new cloudpickle.Pickler is created each time
+        # cloudpickle.dump or cloudpickle.dumps is called, functions also need
+        # to be saved within the same invocation of
+        # cloudpickle.dump/cloudpickle.dumps (for example:
+        # cloudpickle.dumps([f1, f2])). There is no such limitation when using
+        # cloudpickle.Pickler.dump, as long as the multiple invocations are
+        # bound to the same cloudpickle.Pickler instance.
+        base_globals = self.globals_ref.setdefault(id(func.__globals__), {})
+
+        if base_globals == {}:
+            # Add module attributes used to resolve relative imports
+            # instructions inside func.
+            for k in ["__package__", "__name__", "__path__", "__file__"]:
+                if k in func.__globals__:
+                    base_globals[k] = func.__globals__[k]
+
+        # Do not bind the free variables before the function is created to
+        # avoid infinite recursion.
+        if func.__closure__ is None:
+            closure = None
+        else:
+            closure = tuple(_make_empty_cell() for _ in range(len(code.co_freevars)))
+
+        return code, base_globals, None, None, closure
+
+    def dump(self, obj):
+        try:
+            return super().dump(obj)
+        except RuntimeError as e:
+            if len(e.args) > 0 and "recursion" in e.args[0]:
+                msg = "Could not pickle object as excessively deep recursion required."
+                raise pickle.PicklingError(msg) from e
+            else:
+                raise
+
+    def __init__(self, file, protocol=None, buffer_callback=None):
+        if protocol is None:
+            protocol = DEFAULT_PROTOCOL
+        super().__init__(file, protocol=protocol, buffer_callback=buffer_callback)
+        # map functions __globals__ attribute ids, to ensure that functions
+        # sharing the same global namespace at pickling time also share
+        # their global namespace at unpickling time.
+        self.globals_ref = {}
+        self.proto = int(protocol)
+
+    if not PYPY:
+        # pickle.Pickler is the C implementation of the CPython pickler and
+        # therefore we rely on reduce_override method to customize the pickler
+        # behavior.
+
+        # `cloudpickle.Pickler.dispatch` is only left for backward
+        # compatibility - note that when using protocol 5,
+        # `cloudpickle.Pickler.dispatch` is not an extension of
+        # `pickle._Pickler.dispatch` dictionary, because `cloudpickle.Pickler`
+        # subclasses the C-implemented `pickle.Pickler`, which does not expose
+        # a `dispatch` attribute.  Earlier versions of `cloudpickle.Pickler`
+        # used `cloudpickle.Pickler.dispatch` as a class-level attribute
+        # storing all reducers implemented by cloudpickle, but the attribute
+        # name was not a great choice given because it would collide with a
+        # similarly named attribute in the pure-Python `pickle._Pickler`
+        # implementation in the standard library.
+        dispatch = dispatch_table
+
+        # Implementation of the reducer_override callback, in order to
+        # efficiently serialize dynamic functions and classes by subclassing
+        # the C-implemented `pickle.Pickler`.
+        # TODO: decorrelate reducer_override (which is tied to CPython's
+        # implementation - would it make sense to backport it to pypy? - and
+        # pickle's protocol 5 which is implementation agnostic. Currently, the
+        # availability of both notions coincide on CPython's pickle, but it may
+        # not be the case anymore when pypy implements protocol 5.
+
+        def reducer_override(self, obj):
+            """Type-agnostic reducing callback for function and classes.
+
+            For performance reasons, subclasses of the C `pickle.Pickler` class
+            cannot register custom reducers for functions and classes in the
+            dispatch_table attribute. Reducers for such types must instead
+            implemented via the special `reducer_override` method.
+
+            Note that this method will be called for any object except a few
+            builtin-types (int, lists, dicts etc.), which differs from reducers
+            in the Pickler's dispatch_table, each of them being invoked for
+            objects of a specific type only.
+
+            This property comes in handy for classes: although most classes are
+            instances of the ``type`` metaclass, some of them can be instances
+            of other custom metaclasses (such as enum.EnumMeta for example). In
+            particular, the metaclass will likely not be known in advance, and
+            thus cannot be special-cased using an entry in the dispatch_table.
+            reducer_override, among other things, allows us to register a
+            reducer that will be called for any class, independently of its
+            type.
+
+            Notes:
+
+            * reducer_override has the priority over dispatch_table-registered
+            reducers.
+            * reducer_override can be used to fix other limitations of
+              cloudpickle for other types that suffered from type-specific
+              reducers, such as Exceptions. See
+              https://github.com/cloudpipe/cloudpickle/issues/248
+            """
+            t = type(obj)
+            try:
+                is_anyclass = issubclass(t, type)
+            except TypeError:  # t is not a class (old Boost; see SF #502085)
+                is_anyclass = False
+
+            if is_anyclass:
+                return _class_reduce(obj)
+            elif isinstance(obj, types.FunctionType):
+                return self._function_reduce(obj)
+            else:
+                # fallback to save_global, including the Pickler's
+                # dispatch_table
+                return NotImplemented
+
+    else:
+        # When reducer_override is not available, hack the pure-Python
+        # Pickler's types.FunctionType and type savers. Note: the type saver
+        # must override Pickler.save_global, because pickle.py contains a
+        # hard-coded call to save_global when pickling meta-classes.
+        dispatch = pickle.Pickler.dispatch.copy()
+
+        def _save_reduce_pickle5(
+            self,
+            func,
+            args,
+            state=None,
+            listitems=None,
+            dictitems=None,
+            state_setter=None,
+            obj=None,
+        ):
+            save = self.save
+            write = self.write
+            self.save_reduce(
+                func,
+                args,
+                state=None,
+                listitems=listitems,
+                dictitems=dictitems,
+                obj=obj,
+            )
+            # backport of the Python 3.8 state_setter pickle operations
+            save(state_setter)
+            save(obj)  # simple BINGET opcode as obj is already memoized.
+            save(state)
+            write(pickle.TUPLE2)
+            # Trigger a state_setter(obj, state) function call.
+            write(pickle.REDUCE)
+            # The purpose of state_setter is to carry-out an
+            # inplace modification of obj. We do not care about what the
+            # method might return, so its output is eventually removed from
+            # the stack.
+            write(pickle.POP)
+
+        def save_global(self, obj, name=None, pack=struct.pack):
+            """Main dispatch method.
+
+            The name of this method is somewhat misleading: all types get
+            dispatched here.
+            """
+            if obj is type(None):  # noqa
+                return self.save_reduce(type, (None,), obj=obj)
+            elif obj is type(Ellipsis):
+                return self.save_reduce(type, (Ellipsis,), obj=obj)
+            elif obj is type(NotImplemented):
+                return self.save_reduce(type, (NotImplemented,), obj=obj)
+            elif obj in _BUILTIN_TYPE_NAMES:
+                return self.save_reduce(
+                    _builtin_type, (_BUILTIN_TYPE_NAMES[obj],), obj=obj
+                )
+
+            if name is not None:
+                super().save_global(obj, name=name)
+            elif not _should_pickle_by_reference(obj, name=name):
+                self._save_reduce_pickle5(*_dynamic_class_reduce(obj), obj=obj)
+            else:
+                super().save_global(obj, name=name)
+
+        dispatch[type] = save_global
+
+        def save_function(self, obj, name=None):
+            """Registered with the dispatch to handle all function types.
+
+            Determines what kind of function obj is (e.g. lambda, defined at
+            interactive prompt, etc) and handles the pickling appropriately.
+            """
+            if _should_pickle_by_reference(obj, name=name):
+                return super().save_global(obj, name=name)
+            elif PYPY and isinstance(obj.__code__, builtin_code_type):
+                return self.save_pypy_builtin_func(obj)
+            else:
+                return self._save_reduce_pickle5(
+                    *self._dynamic_function_reduce(obj), obj=obj
+                )
+
+        def save_pypy_builtin_func(self, obj):
+            """Save pypy equivalent of builtin functions.
+
+            PyPy does not have the concept of builtin-functions. Instead,
+            builtin-functions are simple function instances, but with a
+            builtin-code attribute.
+            Most of the time, builtin functions should be pickled by attribute.
+            But PyPy has flaky support for __qualname__, so some builtin
+            functions such as float.__new__ will be classified as dynamic. For
+            this reason only, we created this special routine. Because
+            builtin-functions are not expected to have closure or globals,
+            there is no additional hack (compared the one already implemented
+            in pickle) to protect ourselves from reference cycles. A simple
+            (reconstructor, newargs, obj.__dict__) tuple is save_reduced.  Note
+            also that PyPy improved their support for __qualname__ in v3.6, so
+            this routing should be removed when cloudpickle supports only PyPy
+            3.6 and later.
+            """
+            rv = (
+                types.FunctionType,
+                (obj.__code__, {}, obj.__name__, obj.__defaults__, obj.__closure__),
+                obj.__dict__,
+            )
+            self.save_reduce(*rv, obj=obj)
+
+        dispatch[types.FunctionType] = save_function
+
+
+# Shorthands similar to pickle.dump/pickle.dumps
+
+
+def dump(obj, file, protocol=None, buffer_callback=None):
+    """Serialize obj as bytes streamed into file
+
+    protocol defaults to cloudpickle.DEFAULT_PROTOCOL which is an alias to
+    pickle.HIGHEST_PROTOCOL. This setting favors maximum communication
+    speed between processes running the same Python version.
+
+    Set protocol=pickle.DEFAULT_PROTOCOL instead if you need to ensure
+    compatibility with older versions of Python (although this is not always
+    guaranteed to work because cloudpickle relies on some internal
+    implementation details that can change from one Python version to the
+    next).
+    """
+    Pickler(file, protocol=protocol, buffer_callback=buffer_callback).dump(obj)
+
+
+def dumps(obj, protocol=None, buffer_callback=None):
+    """Serialize obj as a string of bytes allocated in memory
+
+    protocol defaults to cloudpickle.DEFAULT_PROTOCOL which is an alias to
+    pickle.HIGHEST_PROTOCOL. This setting favors maximum communication
+    speed between processes running the same Python version.
+
+    Set protocol=pickle.DEFAULT_PROTOCOL instead if you need to ensure
+    compatibility with older versions of Python (although this is not always
+    guaranteed to work because cloudpickle relies on some internal
+    implementation details that can change from one Python version to the
+    next).
+    """
+    with io.BytesIO() as file:
+        cp = Pickler(file, protocol=protocol, buffer_callback=buffer_callback)
+        cp.dump(obj)
+        return file.getvalue()
+
+
+# Include pickles unloading functions in this namespace for convenience.
+load, loads = pickle.load, pickle.loads
+
+# Backward compat alias.
+CloudPickler = Pickler
diff --git a/llm/Lib/site-packages/joblib/externals/cloudpickle/cloudpickle_fast.py b/llm/Lib/site-packages/joblib/externals/cloudpickle/cloudpickle_fast.py
new file mode 100644
index 0000000000000000000000000000000000000000..52d6732e44ebcc0053b24969943f7c3b742268bb
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/cloudpickle/cloudpickle_fast.py
@@ -0,0 +1,13 @@
+"""Compatibility module.
+
+It can be necessary to load files generated by previous versions of cloudpickle
+that rely on symbols being defined under the `cloudpickle.cloudpickle_fast`
+namespace.
+
+See: tests/test_backward_compat.py
+"""
+from . import cloudpickle
+
+
+def __getattr__(name):
+    return getattr(cloudpickle, name)
diff --git a/llm/Lib/site-packages/joblib/externals/loky/__init__.py b/llm/Lib/site-packages/joblib/externals/loky/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5886d2a62092bdc9f444d7a22058d065de567818
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/__init__.py
@@ -0,0 +1,44 @@
+r"""The :mod:`loky` module manages a pool of worker that can be re-used across time.
+It provides a robust and dynamic implementation os the
+:class:`ProcessPoolExecutor` and a function :func:`get_reusable_executor` which
+hide the pool management under the hood.
+"""
+from concurrent.futures import (
+    ALL_COMPLETED,
+    FIRST_COMPLETED,
+    FIRST_EXCEPTION,
+    CancelledError,
+    Executor,
+    TimeoutError,
+    as_completed,
+    wait,
+)
+
+from ._base import Future
+from .backend.context import cpu_count
+from .backend.reduction import set_loky_pickler
+from .reusable_executor import get_reusable_executor
+from .cloudpickle_wrapper import wrap_non_picklable_objects
+from .process_executor import BrokenProcessPool, ProcessPoolExecutor
+
+
+__all__ = [
+    "get_reusable_executor",
+    "cpu_count",
+    "wait",
+    "as_completed",
+    "Future",
+    "Executor",
+    "ProcessPoolExecutor",
+    "BrokenProcessPool",
+    "CancelledError",
+    "TimeoutError",
+    "FIRST_COMPLETED",
+    "FIRST_EXCEPTION",
+    "ALL_COMPLETED",
+    "wrap_non_picklable_objects",
+    "set_loky_pickler",
+]
+
+
+__version__ = "3.4.1"
diff --git a/llm/Lib/site-packages/joblib/externals/loky/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..76b717743e4da5014226da1e7833f41622ce6c69
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/__pycache__/_base.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/__pycache__/_base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..917c2f72831f7e8c851935cc5cf6213585cbcdfa
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/__pycache__/_base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/__pycache__/cloudpickle_wrapper.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/__pycache__/cloudpickle_wrapper.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d566c664e7610d1801ee13e5de47380ea13469ca
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/__pycache__/cloudpickle_wrapper.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/__pycache__/initializers.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/__pycache__/initializers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ba6b688848d274c3d01fb4ee2386d881c719677b
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/__pycache__/initializers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/__pycache__/process_executor.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/__pycache__/process_executor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..58356453ac4926f03e03a65dd00e4f4b765afc2c
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/__pycache__/process_executor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/__pycache__/reusable_executor.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/__pycache__/reusable_executor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..55e0b45b3029a703aa505a5d863466e451bcdac3
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/__pycache__/reusable_executor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/_base.py b/llm/Lib/site-packages/joblib/externals/loky/_base.py
new file mode 100644
index 0000000000000000000000000000000000000000..da0abc1e7fa18363e6342a3b67410f1429e6fa10
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/_base.py
@@ -0,0 +1,28 @@
+###############################################################################
+# Modification of concurrent.futures.Future
+#
+# author: Thomas Moreau and Olivier Grisel
+#
+# adapted from concurrent/futures/_base.py (17/02/2017)
+#  * Do not use yield from
+#  * Use old super syntax
+#
+# Copyright 2009 Brian Quinlan. All Rights Reserved.
+# Licensed to PSF under a Contributor Agreement.
+
+from concurrent.futures import Future as _BaseFuture
+from concurrent.futures._base import LOGGER
+
+
+# To make loky._base.Future instances awaitable  by concurrent.futures.wait,
+# derive our custom Future class from _BaseFuture. _invoke_callback is the only
+# modification made to this class in loky.
+# TODO investigate why using `concurrent.futures.Future` directly does not
+# always work in our test suite.
+class Future(_BaseFuture):
+    def _invoke_callbacks(self):
+        for callback in self._done_callbacks:
+            try:
+                callback(self)
+            except BaseException:
+                LOGGER.exception(f"exception calling callback for {self!r}")
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__init__.py b/llm/Lib/site-packages/joblib/externals/loky/backend/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d339aa644599cf5728394200abdfa19a1256aa02
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/__init__.py
@@ -0,0 +1,14 @@
+import os
+from multiprocessing import synchronize
+
+from .context import get_context
+
+
+def _make_name():
+    return f"/loky-{os.getpid()}-{next(synchronize.SemLock._rand)}"
+
+
+# monkey patch the name creation for multiprocessing
+synchronize.SemLock._make_name = staticmethod(_make_name)
+
+__all__ = ["get_context"]
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7cc3f3c4c841d0019e266b1c4df5a3a6917c6127
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/_posix_reduction.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/_posix_reduction.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c0d9796f10275b61d82f1188be7f203191c096fe
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/_posix_reduction.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/_win_reduction.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/_win_reduction.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bfbcbd2060cae191154fa75971a04cf3261b3d5c
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/_win_reduction.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/context.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/context.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9f359c2873502c24cc5850ffb79e059229fa9ae1
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/context.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/fork_exec.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/fork_exec.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0547b12cea1985cba48e1b0da89e9d2a58e4b511
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/fork_exec.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/popen_loky_posix.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/popen_loky_posix.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dcac3b3a1b93415c5f72ac3927bc8779aa0526cd
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/popen_loky_posix.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/popen_loky_win32.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/popen_loky_win32.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ed87e9e93d2e3cdeb734afefe2b070d9cb06d383
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/popen_loky_win32.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/process.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/process.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4e9814389a1d1a19383251ee6f8ab23e7f974e39
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/process.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/queues.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/queues.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bd94f08fbdce376000b86be3a1df4171b5831d90
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/queues.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/reduction.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/reduction.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6ade79a59a69d318cc4daa6fe4f1dee29e800f39
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/reduction.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/resource_tracker.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/resource_tracker.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f376fede0efa135e2ce457be82f4922e83d525f0
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/resource_tracker.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/spawn.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/spawn.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3cd9661e20eb20fd62586288bb17445231d3c18b
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/spawn.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/synchronize.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/synchronize.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..80d2163272b160d5ea61a0828dae4409d6af425e
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/synchronize.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f8e51b41150a5ac326245de9c6a16898c6a8ad49
Binary files /dev/null and b/llm/Lib/site-packages/joblib/externals/loky/backend/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/_posix_reduction.py b/llm/Lib/site-packages/joblib/externals/loky/backend/_posix_reduction.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b800ec07ff26af38174097a194e24413bf6fc2d
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/_posix_reduction.py
@@ -0,0 +1,67 @@
+###############################################################################
+# Extra reducers for Unix based system and connections objects
+#
+# author: Thomas Moreau and Olivier Grisel
+#
+# adapted from multiprocessing/reduction.py (17/02/2017)
+#  * Add adapted reduction for LokyProcesses and socket/Connection
+#
+import os
+import socket
+import _socket
+from multiprocessing.connection import Connection
+from multiprocessing.context import get_spawning_popen
+
+from .reduction import register
+
+HAVE_SEND_HANDLE = (
+    hasattr(socket, "CMSG_LEN")
+    and hasattr(socket, "SCM_RIGHTS")
+    and hasattr(socket.socket, "sendmsg")
+)
+
+
+def _mk_inheritable(fd):
+    os.set_inheritable(fd, True)
+    return fd
+
+
+def DupFd(fd):
+    """Return a wrapper for an fd."""
+    popen_obj = get_spawning_popen()
+    if popen_obj is not None:
+        return popen_obj.DupFd(popen_obj.duplicate_for_child(fd))
+    elif HAVE_SEND_HANDLE:
+        from multiprocessing import resource_sharer
+
+        return resource_sharer.DupFd(fd)
+    else:
+        raise TypeError(
+            "Cannot pickle connection object. This object can only be "
+            "passed when spawning a new process"
+        )
+
+
+def _reduce_socket(s):
+    df = DupFd(s.fileno())
+    return _rebuild_socket, (df, s.family, s.type, s.proto)
+
+
+def _rebuild_socket(df, family, type, proto):
+    fd = df.detach()
+    return socket.fromfd(fd, family, type, proto)
+
+
+def rebuild_connection(df, readable, writable):
+    fd = df.detach()
+    return Connection(fd, readable, writable)
+
+
+def reduce_connection(conn):
+    df = DupFd(conn.fileno())
+    return rebuild_connection, (df, conn.readable, conn.writable)
+
+
+register(socket.socket, _reduce_socket)
+register(_socket.socket, _reduce_socket)
+register(Connection, reduce_connection)
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/_win_reduction.py b/llm/Lib/site-packages/joblib/externals/loky/backend/_win_reduction.py
new file mode 100644
index 0000000000000000000000000000000000000000..506d0ecba7c8951ddeaa05b48eb1bdadc8d5ff46
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/_win_reduction.py
@@ -0,0 +1,18 @@
+###############################################################################
+# Extra reducers for Windows system and connections objects
+#
+# author: Thomas Moreau and Olivier Grisel
+#
+# adapted from multiprocessing/reduction.py (17/02/2017)
+#  * Add adapted reduction for LokyProcesses and socket/PipeConnection
+#
+import socket
+from multiprocessing import connection
+from multiprocessing.reduction import _reduce_socket
+
+from .reduction import register
+
+# register reduction for win32 communication objects
+register(socket.socket, _reduce_socket)
+register(connection.Connection, connection.reduce_connection)
+register(connection.PipeConnection, connection.reduce_pipe_connection)
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/context.py b/llm/Lib/site-packages/joblib/externals/loky/backend/context.py
new file mode 100644
index 0000000000000000000000000000000000000000..d0f590317e75752fdd0b4962b9f3ecbbbaf50b37
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/context.py
@@ -0,0 +1,378 @@
+###############################################################################
+# Basic context management with LokyContext
+#
+# author: Thomas Moreau and Olivier Grisel
+#
+# adapted from multiprocessing/context.py
+#  * Create a context ensuring loky uses only objects that are compatible
+#  * Add LokyContext to the list of context of multiprocessing so loky can be
+#    used with multiprocessing.set_start_method
+#  * Implement a CFS-aware amd physical-core aware cpu_count function.
+#
+import os
+import sys
+import math
+import subprocess
+import traceback
+import warnings
+import multiprocessing as mp
+from multiprocessing import get_context as mp_get_context
+from multiprocessing.context import BaseContext
+
+
+from .process import LokyProcess, LokyInitMainProcess
+
+# Apparently, on older Python versions, loky cannot work 61 workers on Windows
+# but instead 60: ¯\_(ツ)_/¯
+if sys.version_info >= (3, 8):
+    from concurrent.futures.process import _MAX_WINDOWS_WORKERS
+
+    if sys.version_info < (3, 10):
+        _MAX_WINDOWS_WORKERS = _MAX_WINDOWS_WORKERS - 1
+else:
+    # compat for versions before 3.8 which do not define this.
+    _MAX_WINDOWS_WORKERS = 60
+
+START_METHODS = ["loky", "loky_init_main", "spawn"]
+if sys.platform != "win32":
+    START_METHODS += ["fork", "forkserver"]
+
+_DEFAULT_START_METHOD = None
+
+# Cache for the number of physical cores to avoid repeating subprocess calls.
+# It should not change during the lifetime of the program.
+physical_cores_cache = None
+
+
+def get_context(method=None):
+    # Try to overload the default context
+    method = method or _DEFAULT_START_METHOD or "loky"
+    if method == "fork":
+        # If 'fork' is explicitly requested, warn user about potential issues.
+        warnings.warn(
+            "`fork` start method should not be used with "
+            "`loky` as it does not respect POSIX. Try using "
+            "`spawn` or `loky` instead.",
+            UserWarning,
+        )
+    try:
+        return mp_get_context(method)
+    except ValueError:
+        raise ValueError(
+            f"Unknown context '{method}'. Value should be in "
+            f"{START_METHODS}."
+        )
+
+
+def set_start_method(method, force=False):
+    global _DEFAULT_START_METHOD
+    if _DEFAULT_START_METHOD is not None and not force:
+        raise RuntimeError("context has already been set")
+    assert method is None or method in START_METHODS, (
+        f"'{method}' is not a valid start_method. It should be in "
+        f"{START_METHODS}"
+    )
+
+    _DEFAULT_START_METHOD = method
+
+
+def get_start_method():
+    return _DEFAULT_START_METHOD
+
+
+def cpu_count(only_physical_cores=False):
+    """Return the number of CPUs the current process can use.
+
+    The returned number of CPUs accounts for:
+     * the number of CPUs in the system, as given by
+       ``multiprocessing.cpu_count``;
+     * the CPU affinity settings of the current process
+       (available on some Unix systems);
+     * Cgroup CPU bandwidth limit (available on Linux only, typically
+       set by docker and similar container orchestration systems);
+     * the value of the LOKY_MAX_CPU_COUNT environment variable if defined.
+    and is given as the minimum of these constraints.
+
+    If ``only_physical_cores`` is True, return the number of physical cores
+    instead of the number of logical cores (hyperthreading / SMT). Note that
+    this option is not enforced if the number of usable cores is controlled in
+    any other way such as: process affinity, Cgroup restricted CPU bandwidth
+    or the LOKY_MAX_CPU_COUNT environment variable. If the number of physical
+    cores is not found, return the number of logical cores.
+
+    Note that on Windows, the returned number of CPUs cannot exceed 61 (or 60 for
+    Python < 3.10), see:
+    https://bugs.python.org/issue26903.
+
+    It is also always larger or equal to 1.
+    """
+    # Note: os.cpu_count() is allowed to return None in its docstring
+    os_cpu_count = os.cpu_count() or 1
+    if sys.platform == "win32":
+        # On Windows, attempting to use more than 61 CPUs would result in a
+        # OS-level error. See https://bugs.python.org/issue26903. According to
+        # https://learn.microsoft.com/en-us/windows/win32/procthread/processor-groups
+        # it might be possible to go beyond with a lot of extra work but this
+        # does not look easy.
+        os_cpu_count = min(os_cpu_count, _MAX_WINDOWS_WORKERS)
+
+    cpu_count_user = _cpu_count_user(os_cpu_count)
+    aggregate_cpu_count = max(min(os_cpu_count, cpu_count_user), 1)
+
+    if not only_physical_cores:
+        return aggregate_cpu_count
+
+    if cpu_count_user < os_cpu_count:
+        # Respect user setting
+        return max(cpu_count_user, 1)
+
+    cpu_count_physical, exception = _count_physical_cores()
+    if cpu_count_physical != "not found":
+        return cpu_count_physical
+
+    # Fallback to default behavior
+    if exception is not None:
+        # warns only the first time
+        warnings.warn(
+            "Could not find the number of physical cores for the "
+            f"following reason:\n{exception}\n"
+            "Returning the number of logical cores instead. You can "
+            "silence this warning by setting LOKY_MAX_CPU_COUNT to "
+            "the number of cores you want to use."
+        )
+        traceback.print_tb(exception.__traceback__)
+
+    return aggregate_cpu_count
+
+
+def _cpu_count_cgroup(os_cpu_count):
+    # Cgroup CPU bandwidth limit available in Linux since 2.6 kernel
+    cpu_max_fname = "/sys/fs/cgroup/cpu.max"
+    cfs_quota_fname = "/sys/fs/cgroup/cpu/cpu.cfs_quota_us"
+    cfs_period_fname = "/sys/fs/cgroup/cpu/cpu.cfs_period_us"
+    if os.path.exists(cpu_max_fname):
+        # cgroup v2
+        # https://www.kernel.org/doc/html/latest/admin-guide/cgroup-v2.html
+        with open(cpu_max_fname) as fh:
+            cpu_quota_us, cpu_period_us = fh.read().strip().split()
+    elif os.path.exists(cfs_quota_fname) and os.path.exists(cfs_period_fname):
+        # cgroup v1
+        # https://www.kernel.org/doc/html/latest/scheduler/sched-bwc.html#management
+        with open(cfs_quota_fname) as fh:
+            cpu_quota_us = fh.read().strip()
+        with open(cfs_period_fname) as fh:
+            cpu_period_us = fh.read().strip()
+    else:
+        # No Cgroup CPU bandwidth limit (e.g. non-Linux platform)
+        cpu_quota_us = "max"
+        cpu_period_us = 100_000  # unused, for consistency with default values
+
+    if cpu_quota_us == "max":
+        # No active Cgroup quota on a Cgroup-capable platform
+        return os_cpu_count
+    else:
+        cpu_quota_us = int(cpu_quota_us)
+        cpu_period_us = int(cpu_period_us)
+        if cpu_quota_us > 0 and cpu_period_us > 0:
+            return math.ceil(cpu_quota_us / cpu_period_us)
+        else:  # pragma: no cover
+            # Setting a negative cpu_quota_us value is a valid way to disable
+            # cgroup CPU bandwith limits
+            return os_cpu_count
+
+
+def _cpu_count_affinity(os_cpu_count):
+    # Number of available CPUs given affinity settings
+    if hasattr(os, "sched_getaffinity"):
+        try:
+            return len(os.sched_getaffinity(0))
+        except NotImplementedError:
+            pass
+
+    # On PyPy and possibly other platforms, os.sched_getaffinity does not exist
+    # or raises NotImplementedError, let's try with the psutil if installed.
+    try:
+        import psutil
+
+        p = psutil.Process()
+        if hasattr(p, "cpu_affinity"):
+            return len(p.cpu_affinity())
+
+    except ImportError:  # pragma: no cover
+        if (
+            sys.platform == "linux"
+            and os.environ.get("LOKY_MAX_CPU_COUNT") is None
+        ):
+            # PyPy does not implement os.sched_getaffinity on Linux which
+            # can cause severe oversubscription problems. Better warn the
+            # user in this particularly pathological case which can wreck
+            # havoc, typically on CI workers.
+            warnings.warn(
+                "Failed to inspect CPU affinity constraints on this system. "
+                "Please install psutil or explictly set LOKY_MAX_CPU_COUNT."
+            )
+
+    # This can happen for platforms that do not implement any kind of CPU
+    # infinity such as macOS-based platforms.
+    return os_cpu_count
+
+
+def _cpu_count_user(os_cpu_count):
+    """Number of user defined available CPUs"""
+    cpu_count_affinity = _cpu_count_affinity(os_cpu_count)
+
+    cpu_count_cgroup = _cpu_count_cgroup(os_cpu_count)
+
+    # User defined soft-limit passed as a loky specific environment variable.
+    cpu_count_loky = int(os.environ.get("LOKY_MAX_CPU_COUNT", os_cpu_count))
+
+    return min(cpu_count_affinity, cpu_count_cgroup, cpu_count_loky)
+
+
+def _count_physical_cores():
+    """Return a tuple (number of physical cores, exception)
+
+    If the number of physical cores is found, exception is set to None.
+    If it has not been found, return ("not found", exception).
+
+    The number of physical cores is cached to avoid repeating subprocess calls.
+    """
+    exception = None
+
+    # First check if the value is cached
+    global physical_cores_cache
+    if physical_cores_cache is not None:
+        return physical_cores_cache, exception
+
+    # Not cached yet, find it
+    try:
+        if sys.platform == "linux":
+            cpu_info = subprocess.run(
+                "lscpu --parse=core".split(), capture_output=True, text=True
+            )
+            cpu_info = cpu_info.stdout.splitlines()
+            cpu_info = {line for line in cpu_info if not line.startswith("#")}
+            cpu_count_physical = len(cpu_info)
+        elif sys.platform == "win32":
+            cpu_info = subprocess.run(
+                "wmic CPU Get NumberOfCores /Format:csv".split(),
+                capture_output=True,
+                text=True,
+            )
+            cpu_info = cpu_info.stdout.splitlines()
+            cpu_info = [
+                l.split(",")[1]
+                for l in cpu_info
+                if (l and l != "Node,NumberOfCores")
+            ]
+            cpu_count_physical = sum(map(int, cpu_info))
+        elif sys.platform == "darwin":
+            cpu_info = subprocess.run(
+                "sysctl -n hw.physicalcpu".split(),
+                capture_output=True,
+                text=True,
+            )
+            cpu_info = cpu_info.stdout
+            cpu_count_physical = int(cpu_info)
+        else:
+            raise NotImplementedError(f"unsupported platform: {sys.platform}")
+
+        # if cpu_count_physical < 1, we did not find a valid value
+        if cpu_count_physical < 1:
+            raise ValueError(f"found {cpu_count_physical} physical cores < 1")
+
+    except Exception as e:
+        exception = e
+        cpu_count_physical = "not found"
+
+    # Put the result in cache
+    physical_cores_cache = cpu_count_physical
+
+    return cpu_count_physical, exception
+
+
+class LokyContext(BaseContext):
+    """Context relying on the LokyProcess."""
+
+    _name = "loky"
+    Process = LokyProcess
+    cpu_count = staticmethod(cpu_count)
+
+    def Queue(self, maxsize=0, reducers=None):
+        """Returns a queue object"""
+        from .queues import Queue
+
+        return Queue(maxsize, reducers=reducers, ctx=self.get_context())
+
+    def SimpleQueue(self, reducers=None):
+        """Returns a queue object"""
+        from .queues import SimpleQueue
+
+        return SimpleQueue(reducers=reducers, ctx=self.get_context())
+
+    if sys.platform != "win32":
+        """For Unix platform, use our custom implementation of synchronize
+        ensuring that we use the loky.backend.resource_tracker to clean-up
+        the semaphores in case of a worker crash.
+        """
+
+        def Semaphore(self, value=1):
+            """Returns a semaphore object"""
+            from .synchronize import Semaphore
+
+            return Semaphore(value=value)
+
+        def BoundedSemaphore(self, value):
+            """Returns a bounded semaphore object"""
+            from .synchronize import BoundedSemaphore
+
+            return BoundedSemaphore(value)
+
+        def Lock(self):
+            """Returns a lock object"""
+            from .synchronize import Lock
+
+            return Lock()
+
+        def RLock(self):
+            """Returns a recurrent lock object"""
+            from .synchronize import RLock
+
+            return RLock()
+
+        def Condition(self, lock=None):
+            """Returns a condition object"""
+            from .synchronize import Condition
+
+            return Condition(lock)
+
+        def Event(self):
+            """Returns an event object"""
+            from .synchronize import Event
+
+            return Event()
+
+
+class LokyInitMainContext(LokyContext):
+    """Extra context with LokyProcess, which does load the main module
+
+    This context is used for compatibility in the case ``cloudpickle`` is not
+    present on the running system. This permits to load functions defined in
+    the ``main`` module, using proper safeguards. The declaration of the
+    ``executor`` should be protected by ``if __name__ == "__main__":`` and the
+    functions and variable used from main should be out of this block.
+
+    This mimics the default behavior of multiprocessing under Windows and the
+    behavior of the ``spawn`` start method on a posix system.
+    For more details, see the end of the following section of python doc
+    https://docs.python.org/3/library/multiprocessing.html#multiprocessing-programming
+    """
+
+    _name = "loky_init_main"
+    Process = LokyInitMainProcess
+
+
+# Register loky context so it works with multiprocessing.get_context
+ctx_loky = LokyContext()
+mp.context._concrete_contexts["loky"] = ctx_loky
+mp.context._concrete_contexts["loky_init_main"] = LokyInitMainContext()
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/fork_exec.py b/llm/Lib/site-packages/joblib/externals/loky/backend/fork_exec.py
new file mode 100644
index 0000000000000000000000000000000000000000..2353c42f51a6e6c558ce70e35e1b7405e22d70ed
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/fork_exec.py
@@ -0,0 +1,43 @@
+###############################################################################
+# Launch a subprocess using forkexec and make sure only the needed fd are
+# shared in the two process.
+#
+# author: Thomas Moreau and Olivier Grisel
+#
+import os
+import sys
+
+
+def close_fds(keep_fds):  # pragma: no cover
+    """Close all the file descriptors except those in keep_fds."""
+
+    # Make sure to keep stdout and stderr open for logging purpose
+    keep_fds = {*keep_fds, 1, 2}
+
+    # We try to retrieve all the open fds
+    try:
+        open_fds = {int(fd) for fd in os.listdir("/proc/self/fd")}
+    except FileNotFoundError:
+        import resource
+
+        max_nfds = resource.getrlimit(resource.RLIMIT_NOFILE)[0]
+        open_fds = {*range(max_nfds)}
+
+    for i in open_fds - keep_fds:
+        try:
+            os.close(i)
+        except OSError:
+            pass
+
+
+def fork_exec(cmd, keep_fds, env=None):
+    # copy the environment variables to set in the child process
+    env = env or {}
+    child_env = {**os.environ, **env}
+
+    pid = os.fork()
+    if pid == 0:  # pragma: no cover
+        close_fds(keep_fds)
+        os.execve(sys.executable, cmd, child_env)
+    else:
+        return pid
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/popen_loky_posix.py b/llm/Lib/site-packages/joblib/externals/loky/backend/popen_loky_posix.py
new file mode 100644
index 0000000000000000000000000000000000000000..74395be0757f0a07ef92a7b0efe1e1ea4ecdac77
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/popen_loky_posix.py
@@ -0,0 +1,193 @@
+###############################################################################
+# Popen for LokyProcess.
+#
+# author: Thomas Moreau and Olivier Grisel
+#
+import os
+import sys
+import signal
+import pickle
+from io import BytesIO
+from multiprocessing import util, process
+from multiprocessing.connection import wait
+from multiprocessing.context import set_spawning_popen
+
+from . import reduction, resource_tracker, spawn
+
+
+__all__ = ["Popen"]
+
+
+#
+# Wrapper for an fd used while launching a process
+#
+
+
+class _DupFd:
+    def __init__(self, fd):
+        self.fd = reduction._mk_inheritable(fd)
+
+    def detach(self):
+        return self.fd
+
+
+#
+# Start child process using subprocess.Popen
+#
+
+
+class Popen:
+    method = "loky"
+    DupFd = _DupFd
+
+    def __init__(self, process_obj):
+        sys.stdout.flush()
+        sys.stderr.flush()
+        self.returncode = None
+        self._fds = []
+        self._launch(process_obj)
+
+    def duplicate_for_child(self, fd):
+        self._fds.append(fd)
+        return reduction._mk_inheritable(fd)
+
+    def poll(self, flag=os.WNOHANG):
+        if self.returncode is None:
+            while True:
+                try:
+                    pid, sts = os.waitpid(self.pid, flag)
+                except OSError:
+                    # Child process not yet created. See #1731717
+                    # e.errno == errno.ECHILD == 10
+                    return None
+                else:
+                    break
+            if pid == self.pid:
+                if os.WIFSIGNALED(sts):
+                    self.returncode = -os.WTERMSIG(sts)
+                else:
+                    assert os.WIFEXITED(sts)
+                    self.returncode = os.WEXITSTATUS(sts)
+        return self.returncode
+
+    def wait(self, timeout=None):
+        if self.returncode is None:
+            if timeout is not None:
+                if not wait([self.sentinel], timeout):
+                    return None
+            # This shouldn't block if wait() returned successfully.
+            return self.poll(os.WNOHANG if timeout == 0.0 else 0)
+        return self.returncode
+
+    def terminate(self):
+        if self.returncode is None:
+            try:
+                os.kill(self.pid, signal.SIGTERM)
+            except ProcessLookupError:
+                pass
+            except OSError:
+                if self.wait(timeout=0.1) is None:
+                    raise
+
+    def _launch(self, process_obj):
+
+        tracker_fd = resource_tracker._resource_tracker.getfd()
+
+        fp = BytesIO()
+        set_spawning_popen(self)
+        try:
+            prep_data = spawn.get_preparation_data(
+                process_obj._name,
+                getattr(process_obj, "init_main_module", True),
+            )
+            reduction.dump(prep_data, fp)
+            reduction.dump(process_obj, fp)
+
+        finally:
+            set_spawning_popen(None)
+
+        try:
+            parent_r, child_w = os.pipe()
+            child_r, parent_w = os.pipe()
+            # for fd in self._fds:
+            #     _mk_inheritable(fd)
+
+            cmd_python = [sys.executable]
+            cmd_python += ["-m", self.__module__]
+            cmd_python += ["--process-name", str(process_obj.name)]
+            cmd_python += ["--pipe", str(reduction._mk_inheritable(child_r))]
+            reduction._mk_inheritable(child_w)
+            reduction._mk_inheritable(tracker_fd)
+            self._fds += [child_r, child_w, tracker_fd]
+            if sys.version_info >= (3, 8) and os.name == "posix":
+                mp_tracker_fd = prep_data["mp_tracker_args"]["fd"]
+                self.duplicate_for_child(mp_tracker_fd)
+
+            from .fork_exec import fork_exec
+
+            pid = fork_exec(cmd_python, self._fds, env=process_obj.env)
+            util.debug(
+                f"launched python with pid {pid} and cmd:\n{cmd_python}"
+            )
+            self.sentinel = parent_r
+
+            method = "getbuffer"
+            if not hasattr(fp, method):
+                method = "getvalue"
+            with os.fdopen(parent_w, "wb") as f:
+                f.write(getattr(fp, method)())
+            self.pid = pid
+        finally:
+            if parent_r is not None:
+                util.Finalize(self, os.close, (parent_r,))
+            for fd in (child_r, child_w):
+                if fd is not None:
+                    os.close(fd)
+
+    @staticmethod
+    def thread_is_spawning():
+        return True
+
+
+if __name__ == "__main__":
+    import argparse
+
+    parser = argparse.ArgumentParser("Command line parser")
+    parser.add_argument(
+        "--pipe", type=int, required=True, help="File handle for the pipe"
+    )
+    parser.add_argument(
+        "--process-name",
+        type=str,
+        default=None,
+        help="Identifier for debugging purpose",
+    )
+
+    args = parser.parse_args()
+
+    info = {}
+    exitcode = 1
+    try:
+        with os.fdopen(args.pipe, "rb") as from_parent:
+            process.current_process()._inheriting = True
+            try:
+                prep_data = pickle.load(from_parent)
+                spawn.prepare(prep_data)
+                process_obj = pickle.load(from_parent)
+            finally:
+                del process.current_process()._inheriting
+
+        exitcode = process_obj._bootstrap()
+    except Exception:
+        print("\n\n" + "-" * 80)
+        print(f"{args.process_name} failed with traceback: ")
+        print("-" * 80)
+        import traceback
+
+        print(traceback.format_exc())
+        print("\n" + "-" * 80)
+    finally:
+        if from_parent is not None:
+            from_parent.close()
+
+        sys.exit(exitcode)
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/popen_loky_win32.py b/llm/Lib/site-packages/joblib/externals/loky/backend/popen_loky_win32.py
new file mode 100644
index 0000000000000000000000000000000000000000..4f85f65df5e22bc2342f44c4a59b5e2ece63a81f
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/popen_loky_win32.py
@@ -0,0 +1,173 @@
+import os
+import sys
+import msvcrt
+import _winapi
+from pickle import load
+from multiprocessing import process, util
+from multiprocessing.context import set_spawning_popen
+from multiprocessing.popen_spawn_win32 import Popen as _Popen
+
+from . import reduction, spawn
+
+
+__all__ = ["Popen"]
+
+#
+#
+#
+
+
+def _path_eq(p1, p2):
+    return p1 == p2 or os.path.normcase(p1) == os.path.normcase(p2)
+
+
+WINENV = hasattr(sys, "_base_executable") and not _path_eq(
+    sys.executable, sys._base_executable
+)
+
+
+def _close_handles(*handles):
+    for handle in handles:
+        _winapi.CloseHandle(handle)
+
+
+#
+# We define a Popen class similar to the one from subprocess, but
+# whose constructor takes a process object as its argument.
+#
+
+
+class Popen(_Popen):
+    """
+    Start a subprocess to run the code of a process object.
+
+    We differ from cpython implementation with the way we handle environment
+    variables, in order to be able to modify then in the child processes before
+    importing any library, in order to control the number of threads in C-level
+    threadpools.
+
+    We also use the loky preparation data, in particular to handle main_module
+    inits and the loky resource tracker.
+    """
+
+    method = "loky"
+
+    def __init__(self, process_obj):
+        prep_data = spawn.get_preparation_data(
+            process_obj._name, getattr(process_obj, "init_main_module", True)
+        )
+
+        # read end of pipe will be duplicated by the child process
+        # -- see spawn_main() in spawn.py.
+        #
+        # bpo-33929: Previously, the read end of pipe was "stolen" by the child
+        # process, but it leaked a handle if the child process had been
+        # terminated before it could steal the handle from the parent process.
+        rhandle, whandle = _winapi.CreatePipe(None, 0)
+        wfd = msvcrt.open_osfhandle(whandle, 0)
+        cmd = get_command_line(parent_pid=os.getpid(), pipe_handle=rhandle)
+
+        python_exe = spawn.get_executable()
+
+        # copy the environment variables to set in the child process
+        child_env = {**os.environ, **process_obj.env}
+
+        # bpo-35797: When running in a venv, we bypass the redirect
+        # executor and launch our base Python.
+        if WINENV and _path_eq(python_exe, sys.executable):
+            cmd[0] = python_exe = sys._base_executable
+            child_env["__PYVENV_LAUNCHER__"] = sys.executable
+
+        cmd = " ".join(f'"{x}"' for x in cmd)
+
+        with open(wfd, "wb") as to_child:
+            # start process
+            try:
+                hp, ht, pid, _ = _winapi.CreateProcess(
+                    python_exe,
+                    cmd,
+                    None,
+                    None,
+                    False,
+                    0,
+                    child_env,
+                    None,
+                    None,
+                )
+                _winapi.CloseHandle(ht)
+            except BaseException:
+                _winapi.CloseHandle(rhandle)
+                raise
+
+            # set attributes of self
+            self.pid = pid
+            self.returncode = None
+            self._handle = hp
+            self.sentinel = int(hp)
+            self.finalizer = util.Finalize(
+                self, _close_handles, (self.sentinel, int(rhandle))
+            )
+
+            # send information to child
+            set_spawning_popen(self)
+            try:
+                reduction.dump(prep_data, to_child)
+                reduction.dump(process_obj, to_child)
+            finally:
+                set_spawning_popen(None)
+
+
+def get_command_line(pipe_handle, parent_pid, **kwds):
+    """Returns prefix of command line used for spawning a child process."""
+    if getattr(sys, "frozen", False):
+        return [sys.executable, "--multiprocessing-fork", pipe_handle]
+    else:
+        prog = (
+            "from joblib.externals.loky.backend.popen_loky_win32 import main; "
+            f"main(pipe_handle={pipe_handle}, parent_pid={parent_pid})"
+        )
+        opts = util._args_from_interpreter_flags()
+        return [
+            spawn.get_executable(),
+            *opts,
+            "-c",
+            prog,
+            "--multiprocessing-fork",
+        ]
+
+
+def is_forking(argv):
+    """Return whether commandline indicates we are forking."""
+    if len(argv) >= 2 and argv[1] == "--multiprocessing-fork":
+        return True
+    else:
+        return False
+
+
+def main(pipe_handle, parent_pid=None):
+    """Run code specified by data received over pipe."""
+    assert is_forking(sys.argv), "Not forking"
+
+    if parent_pid is not None:
+        source_process = _winapi.OpenProcess(
+            _winapi.SYNCHRONIZE | _winapi.PROCESS_DUP_HANDLE, False, parent_pid
+        )
+    else:
+        source_process = None
+    new_handle = reduction.duplicate(
+        pipe_handle, source_process=source_process
+    )
+    fd = msvcrt.open_osfhandle(new_handle, os.O_RDONLY)
+    parent_sentinel = source_process
+
+    with os.fdopen(fd, "rb", closefd=True) as from_parent:
+        process.current_process()._inheriting = True
+        try:
+            preparation_data = load(from_parent)
+            spawn.prepare(preparation_data, parent_sentinel)
+            self = load(from_parent)
+        finally:
+            del process.current_process()._inheriting
+
+    exitcode = self._bootstrap(parent_sentinel)
+    sys.exit(exitcode)
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/process.py b/llm/Lib/site-packages/joblib/externals/loky/backend/process.py
new file mode 100644
index 0000000000000000000000000000000000000000..356255094b7647be8de6998a8752dd7807b25e10
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/process.py
@@ -0,0 +1,85 @@
+###############################################################################
+# LokyProcess implementation
+#
+# authors: Thomas Moreau and Olivier Grisel
+#
+# based on multiprocessing/process.py  (17/02/2017)
+#
+import sys
+from multiprocessing.context import assert_spawning
+from multiprocessing.process import BaseProcess
+
+
+class LokyProcess(BaseProcess):
+    _start_method = "loky"
+
+    def __init__(
+        self,
+        group=None,
+        target=None,
+        name=None,
+        args=(),
+        kwargs={},
+        daemon=None,
+        init_main_module=False,
+        env=None,
+    ):
+        super().__init__(
+            group=group,
+            target=target,
+            name=name,
+            args=args,
+            kwargs=kwargs,
+            daemon=daemon,
+        )
+        self.env = {} if env is None else env
+        self.authkey = self.authkey
+        self.init_main_module = init_main_module
+
+    @staticmethod
+    def _Popen(process_obj):
+        if sys.platform == "win32":
+            from .popen_loky_win32 import Popen
+        else:
+            from .popen_loky_posix import Popen
+        return Popen(process_obj)
+
+
+class LokyInitMainProcess(LokyProcess):
+    _start_method = "loky_init_main"
+
+    def __init__(
+        self,
+        group=None,
+        target=None,
+        name=None,
+        args=(),
+        kwargs={},
+        daemon=None,
+    ):
+        super().__init__(
+            group=group,
+            target=target,
+            name=name,
+            args=args,
+            kwargs=kwargs,
+            daemon=daemon,
+            init_main_module=True,
+        )
+
+
+#
+# We subclass bytes to avoid accidental transmission of auth keys over network
+#
+
+
+class AuthenticationKey(bytes):
+    def __reduce__(self):
+        try:
+            assert_spawning(self)
+        except RuntimeError:
+            raise TypeError(
+                "Pickling an AuthenticationKey object is "
+                "disallowed for security reasons"
+            )
+        return AuthenticationKey, (bytes(self),)
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/queues.py b/llm/Lib/site-packages/joblib/externals/loky/backend/queues.py
new file mode 100644
index 0000000000000000000000000000000000000000..5afd99b420fbc480ed5eb743333a687110a90e49
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/queues.py
@@ -0,0 +1,236 @@
+###############################################################################
+# Queue and SimpleQueue implementation for loky
+#
+# authors: Thomas Moreau, Olivier Grisel
+#
+# based on multiprocessing/queues.py (16/02/2017)
+# * Add some custom reducers for the Queues/SimpleQueue to tweak the
+#   pickling process. (overload Queue._feed/SimpleQueue.put)
+#
+import os
+import sys
+import errno
+import weakref
+import threading
+from multiprocessing import util
+from multiprocessing.queues import (
+    Full,
+    Queue as mp_Queue,
+    SimpleQueue as mp_SimpleQueue,
+    _sentinel,
+)
+from multiprocessing.context import assert_spawning
+
+from .reduction import dumps
+
+
+__all__ = ["Queue", "SimpleQueue", "Full"]
+
+
+class Queue(mp_Queue):
+    def __init__(self, maxsize=0, reducers=None, ctx=None):
+        super().__init__(maxsize=maxsize, ctx=ctx)
+        self._reducers = reducers
+
+    # Use custom queue set/get state to be able to reduce the custom reducers
+    def __getstate__(self):
+        assert_spawning(self)
+        return (
+            self._ignore_epipe,
+            self._maxsize,
+            self._reader,
+            self._writer,
+            self._reducers,
+            self._rlock,
+            self._wlock,
+            self._sem,
+            self._opid,
+        )
+
+    def __setstate__(self, state):
+        (
+            self._ignore_epipe,
+            self._maxsize,
+            self._reader,
+            self._writer,
+            self._reducers,
+            self._rlock,
+            self._wlock,
+            self._sem,
+            self._opid,
+        ) = state
+        if sys.version_info >= (3, 9):
+            self._reset()
+        else:
+            self._after_fork()
+
+    # Overload _start_thread to correctly call our custom _feed
+    def _start_thread(self):
+        util.debug("Queue._start_thread()")
+
+        # Start thread which transfers data from buffer to pipe
+        self._buffer.clear()
+        self._thread = threading.Thread(
+            target=Queue._feed,
+            args=(
+                self._buffer,
+                self._notempty,
+                self._send_bytes,
+                self._wlock,
+                self._writer.close,
+                self._reducers,
+                self._ignore_epipe,
+                self._on_queue_feeder_error,
+                self._sem,
+            ),
+            name="QueueFeederThread",
+        )
+        self._thread.daemon = True
+
+        util.debug("doing self._thread.start()")
+        self._thread.start()
+        util.debug("... done self._thread.start()")
+
+        # On process exit we will wait for data to be flushed to pipe.
+        #
+        # However, if this process created the queue then all
+        # processes which use the queue will be descendants of this
+        # process.  Therefore waiting for the queue to be flushed
+        # is pointless once all the child processes have been joined.
+        created_by_this_process = self._opid == os.getpid()
+        if not self._joincancelled and not created_by_this_process:
+            self._jointhread = util.Finalize(
+                self._thread,
+                Queue._finalize_join,
+                [weakref.ref(self._thread)],
+                exitpriority=-5,
+            )
+
+        # Send sentinel to the thread queue object when garbage collected
+        self._close = util.Finalize(
+            self,
+            Queue._finalize_close,
+            [self._buffer, self._notempty],
+            exitpriority=10,
+        )
+
+    # Overload the _feed methods to use our custom pickling strategy.
+    @staticmethod
+    def _feed(
+        buffer,
+        notempty,
+        send_bytes,
+        writelock,
+        close,
+        reducers,
+        ignore_epipe,
+        onerror,
+        queue_sem,
+    ):
+        util.debug("starting thread to feed data to pipe")
+        nacquire = notempty.acquire
+        nrelease = notempty.release
+        nwait = notempty.wait
+        bpopleft = buffer.popleft
+        sentinel = _sentinel
+        if sys.platform != "win32":
+            wacquire = writelock.acquire
+            wrelease = writelock.release
+        else:
+            wacquire = None
+
+        while True:
+            try:
+                nacquire()
+                try:
+                    if not buffer:
+                        nwait()
+                finally:
+                    nrelease()
+                try:
+                    while True:
+                        obj = bpopleft()
+                        if obj is sentinel:
+                            util.debug("feeder thread got sentinel -- exiting")
+                            close()
+                            return
+
+                        # serialize the data before acquiring the lock
+                        obj_ = dumps(obj, reducers=reducers)
+                        if wacquire is None:
+                            send_bytes(obj_)
+                        else:
+                            wacquire()
+                            try:
+                                send_bytes(obj_)
+                            finally:
+                                wrelease()
+                        # Remove references early to avoid leaking memory
+                        del obj, obj_
+                except IndexError:
+                    pass
+            except BaseException as e:
+                if ignore_epipe and getattr(e, "errno", 0) == errno.EPIPE:
+                    return
+                # Since this runs in a daemon thread the resources it uses
+                # may be become unusable while the process is cleaning up.
+                # We ignore errors which happen after the process has
+                # started to cleanup.
+                if util.is_exiting():
+                    util.info(f"error in queue thread: {e}")
+                    return
+                else:
+                    queue_sem.release()
+                    onerror(e, obj)
+
+    def _on_queue_feeder_error(self, e, obj):
+        """
+        Private API hook called when feeding data in the background thread
+        raises an exception.  For overriding by concurrent.futures.
+        """
+        import traceback
+
+        traceback.print_exc()
+
+
+class SimpleQueue(mp_SimpleQueue):
+    def __init__(self, reducers=None, ctx=None):
+        super().__init__(ctx=ctx)
+
+        # Add possiblity to use custom reducers
+        self._reducers = reducers
+
+    def close(self):
+        self._reader.close()
+        self._writer.close()
+
+    # Use custom queue set/get state to be able to reduce the custom reducers
+    def __getstate__(self):
+        assert_spawning(self)
+        return (
+            self._reader,
+            self._writer,
+            self._reducers,
+            self._rlock,
+            self._wlock,
+        )
+
+    def __setstate__(self, state):
+        (
+            self._reader,
+            self._writer,
+            self._reducers,
+            self._rlock,
+            self._wlock,
+        ) = state
+
+    # Overload put to use our customizable reducer
+    def put(self, obj):
+        # serialize the data before acquiring the lock
+        obj = dumps(obj, reducers=self._reducers)
+        if self._wlock is None:
+            # writes to a message oriented win32 pipe are atomic
+            self._writer.send_bytes(obj)
+        else:
+            with self._wlock:
+                self._writer.send_bytes(obj)
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/reduction.py b/llm/Lib/site-packages/joblib/externals/loky/backend/reduction.py
new file mode 100644
index 0000000000000000000000000000000000000000..bed32ba9e18f7d0fccab7ead6095996d27f448e2
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/reduction.py
@@ -0,0 +1,224 @@
+###############################################################################
+# Customizable Pickler with some basic reducers
+#
+# author: Thomas Moreau
+#
+# adapted from multiprocessing/reduction.py (17/02/2017)
+#  * Replace the ForkingPickler with a similar _LokyPickler,
+#  * Add CustomizableLokyPickler to allow customizing pickling process
+#    on the fly.
+#
+import copyreg
+import io
+import functools
+import types
+import sys
+import os
+
+from multiprocessing import util
+from pickle import loads, HIGHEST_PROTOCOL
+
+###############################################################################
+# Enable custom pickling in Loky.
+
+_dispatch_table = {}
+
+
+def register(type_, reduce_function):
+    _dispatch_table[type_] = reduce_function
+
+
+###############################################################################
+# Registers extra pickling routines to improve picklization  for loky
+
+
+# make methods picklable
+def _reduce_method(m):
+    if m.__self__ is None:
+        return getattr, (m.__class__, m.__func__.__name__)
+    else:
+        return getattr, (m.__self__, m.__func__.__name__)
+
+
+class _C:
+    def f(self):
+        pass
+
+    @classmethod
+    def h(cls):
+        pass
+
+
+register(type(_C().f), _reduce_method)
+register(type(_C.h), _reduce_method)
+
+
+if not hasattr(sys, "pypy_version_info"):
+    # PyPy uses functions instead of method_descriptors and wrapper_descriptors
+    def _reduce_method_descriptor(m):
+        return getattr, (m.__objclass__, m.__name__)
+
+    register(type(list.append), _reduce_method_descriptor)
+    register(type(int.__add__), _reduce_method_descriptor)
+
+
+# Make partial func pickable
+def _reduce_partial(p):
+    return _rebuild_partial, (p.func, p.args, p.keywords or {})
+
+
+def _rebuild_partial(func, args, keywords):
+    return functools.partial(func, *args, **keywords)
+
+
+register(functools.partial, _reduce_partial)
+
+if sys.platform != "win32":
+    from ._posix_reduction import _mk_inheritable  # noqa: F401
+else:
+    from . import _win_reduction  # noqa: F401
+
+# global variable to change the pickler behavior
+try:
+    from joblib.externals import cloudpickle  # noqa: F401
+
+    DEFAULT_ENV = "cloudpickle"
+except ImportError:
+    # If cloudpickle is not present, fallback to pickle
+    DEFAULT_ENV = "pickle"
+
+ENV_LOKY_PICKLER = os.environ.get("LOKY_PICKLER", DEFAULT_ENV)
+_LokyPickler = None
+_loky_pickler_name = None
+
+
+def set_loky_pickler(loky_pickler=None):
+    global _LokyPickler, _loky_pickler_name
+
+    if loky_pickler is None:
+        loky_pickler = ENV_LOKY_PICKLER
+
+    loky_pickler_cls = None
+
+    # The default loky_pickler is cloudpickle
+    if loky_pickler in ["", None]:
+        loky_pickler = "cloudpickle"
+
+    if loky_pickler == _loky_pickler_name:
+        return
+
+    if loky_pickler == "cloudpickle":
+        from joblib.externals.cloudpickle import CloudPickler as loky_pickler_cls
+    else:
+        try:
+            from importlib import import_module
+
+            module_pickle = import_module(loky_pickler)
+            loky_pickler_cls = module_pickle.Pickler
+        except (ImportError, AttributeError) as e:
+            extra_info = (
+                "\nThis error occurred while setting loky_pickler to"
+                f" '{loky_pickler}', as required by the env variable "
+                "LOKY_PICKLER or the function set_loky_pickler."
+            )
+            e.args = (e.args[0] + extra_info,) + e.args[1:]
+            e.msg = e.args[0]
+            raise e
+
+    util.debug(
+        f"Using '{loky_pickler if loky_pickler else 'cloudpickle'}' for "
+        "serialization."
+    )
+
+    class CustomizablePickler(loky_pickler_cls):
+        _loky_pickler_cls = loky_pickler_cls
+
+        def _set_dispatch_table(self, dispatch_table):
+            for ancestor_class in self._loky_pickler_cls.mro():
+                dt_attribute = getattr(ancestor_class, "dispatch_table", None)
+                if isinstance(dt_attribute, types.MemberDescriptorType):
+                    # Ancestor class (typically _pickle.Pickler) has a
+                    # member_descriptor for its "dispatch_table" attribute. Use
+                    # it to set the dispatch_table as a member instead of a
+                    # dynamic attribute in the __dict__ of the instance,
+                    # otherwise it will not be taken into account by the C
+                    # implementation of the dump method if a subclass defines a
+                    # class-level dispatch_table attribute as was done in
+                    # cloudpickle 1.6.0:
+                    # https://github.com/joblib/loky/pull/260
+                    dt_attribute.__set__(self, dispatch_table)
+                    break
+
+            # On top of member descriptor set, also use setattr such that code
+            # that directly access self.dispatch_table gets a consistent view
+            # of the same table.
+            self.dispatch_table = dispatch_table
+
+        def __init__(self, writer, reducers=None, protocol=HIGHEST_PROTOCOL):
+            loky_pickler_cls.__init__(self, writer, protocol=protocol)
+            if reducers is None:
+                reducers = {}
+
+            if hasattr(self, "dispatch_table"):
+                # Force a copy that we will update without mutating the
+                # any class level defined dispatch_table.
+                loky_dt = dict(self.dispatch_table)
+            else:
+                # Use standard reducers as bases
+                loky_dt = copyreg.dispatch_table.copy()
+
+            # Register loky specific reducers
+            loky_dt.update(_dispatch_table)
+
+            # Set the new dispatch table, taking care of the fact that we
+            # need to use the member_descriptor when we inherit from a
+            # subclass of the C implementation of the Pickler base class
+            # with an class level dispatch_table attribute.
+            self._set_dispatch_table(loky_dt)
+
+            # Register the reducers
+            for type, reduce_func in reducers.items():
+                self.register(type, reduce_func)
+
+        def register(self, type, reduce_func):
+            """Attach a reducer function to a given type in the dispatch table."""
+            self.dispatch_table[type] = reduce_func
+
+    _LokyPickler = CustomizablePickler
+    _loky_pickler_name = loky_pickler
+
+
+def get_loky_pickler_name():
+    global _loky_pickler_name
+    return _loky_pickler_name
+
+
+def get_loky_pickler():
+    global _LokyPickler
+    return _LokyPickler
+
+
+# Set it to its default value
+set_loky_pickler()
+
+
+def dump(obj, file, reducers=None, protocol=None):
+    """Replacement for pickle.dump() using _LokyPickler."""
+    global _LokyPickler
+    _LokyPickler(file, reducers=reducers, protocol=protocol).dump(obj)
+
+
+def dumps(obj, reducers=None, protocol=None):
+    global _LokyPickler
+
+    buf = io.BytesIO()
+    dump(obj, buf, reducers=reducers, protocol=protocol)
+    return buf.getbuffer()
+
+
+__all__ = ["dump", "dumps", "loads", "register", "set_loky_pickler"]
+
+if sys.platform == "win32":
+    from multiprocessing.reduction import duplicate
+
+    __all__ += ["duplicate"]
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/resource_tracker.py b/llm/Lib/site-packages/joblib/externals/loky/backend/resource_tracker.py
new file mode 100644
index 0000000000000000000000000000000000000000..25204a7a729d4d5f295070cd050c17a4ed9d49b7
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/resource_tracker.py
@@ -0,0 +1,378 @@
+###############################################################################
+# Server process to keep track of unlinked resources, like folders and
+# semaphores and clean them.
+#
+# author: Thomas Moreau
+#
+# adapted from multiprocessing/semaphore_tracker.py  (17/02/2017)
+#  * include custom spawnv_passfds to start the process
+#  * add some VERBOSE logging
+#
+# TODO: multiprocessing.resource_tracker was contributed to Python 3.8 so
+# once loky drops support for Python 3.7 it might be possible to stop
+# maintaining this loky-specific fork. As a consequence, it might also be
+# possible to stop maintaining the loky.backend.synchronize fork of
+# multiprocessing.synchronize.
+
+#
+# On Unix we run a server process which keeps track of unlinked
+# resources. The server ignores SIGINT and SIGTERM and reads from a
+# pipe. The resource_tracker implements a reference counting scheme: each time
+# a Python process anticipates the shared usage of a resource by another
+# process, it signals the resource_tracker of this shared usage, and in return,
+# the resource_tracker increments the resource's reference count by 1.
+# Similarly, when access to a resource is closed by a Python process, the
+# process notifies the resource_tracker by asking it to decrement the
+# resource's reference count by 1.  When the reference count drops to 0, the
+# resource_tracker attempts to clean up the underlying resource.
+
+# Finally, every other process connected to the resource tracker has a copy of
+# the writable end of the pipe used to communicate with it, so the resource
+# tracker gets EOF when all other processes have exited. Then the
+# resource_tracker process unlinks any remaining leaked resources (with
+# reference count above 0)
+
+# For semaphores, this is important because the system only supports a limited
+# number of named semaphores, and they will not be automatically removed till
+# the next reboot.  Without this resource tracker process, "killall python"
+# would probably leave unlinked semaphores.
+
+# Note that this behavior differs from CPython's resource_tracker, which only
+# implements list of shared resources, and not a proper refcounting scheme.
+# Also, CPython's resource tracker will only attempt to cleanup those shared
+# resources once all procsses connected to the resouce tracker have exited.
+
+
+import os
+import shutil
+import sys
+import signal
+import warnings
+import threading
+from _multiprocessing import sem_unlink
+from multiprocessing import util
+
+from . import spawn
+
+if sys.platform == "win32":
+    import _winapi
+    import msvcrt
+    from multiprocessing.reduction import duplicate
+
+
+__all__ = ["ensure_running", "register", "unregister"]
+
+_HAVE_SIGMASK = hasattr(signal, "pthread_sigmask")
+_IGNORED_SIGNALS = (signal.SIGINT, signal.SIGTERM)
+
+_CLEANUP_FUNCS = {"folder": shutil.rmtree, "file": os.unlink}
+
+if os.name == "posix":
+    _CLEANUP_FUNCS["semlock"] = sem_unlink
+
+
+VERBOSE = False
+
+
+class ResourceTracker:
+    def __init__(self):
+        self._lock = threading.Lock()
+        self._fd = None
+        self._pid = None
+
+    def getfd(self):
+        self.ensure_running()
+        return self._fd
+
+    def ensure_running(self):
+        """Make sure that resource tracker process is running.
+
+        This can be run from any process.  Usually a child process will use
+        the resource created by its parent."""
+        with self._lock:
+            if self._fd is not None:
+                # resource tracker was launched before, is it still running?
+                if self._check_alive():
+                    # => still alive
+                    return
+                # => dead, launch it again
+                os.close(self._fd)
+                if os.name == "posix":
+                    try:
+                        # At this point, the resource_tracker process has been
+                        # killed or crashed. Let's remove the process entry
+                        # from the process table to avoid zombie processes.
+                        os.waitpid(self._pid, 0)
+                    except OSError:
+                        # The process was terminated or is a child from an
+                        # ancestor of the current process.
+                        pass
+                self._fd = None
+                self._pid = None
+
+                warnings.warn(
+                    "resource_tracker: process died unexpectedly, "
+                    "relaunching.  Some folders/sempahores might "
+                    "leak."
+                )
+
+            fds_to_pass = []
+            try:
+                fds_to_pass.append(sys.stderr.fileno())
+            except Exception:
+                pass
+
+            r, w = os.pipe()
+            if sys.platform == "win32":
+                _r = duplicate(msvcrt.get_osfhandle(r), inheritable=True)
+                os.close(r)
+                r = _r
+
+            cmd = f"from {main.__module__} import main; main({r}, {VERBOSE})"
+            try:
+                fds_to_pass.append(r)
+                # process will out live us, so no need to wait on pid
+                exe = spawn.get_executable()
+                args = [exe, *util._args_from_interpreter_flags(), "-c", cmd]
+                util.debug(f"launching resource tracker: {args}")
+                # bpo-33613: Register a signal mask that will block the
+                # signals.  This signal mask will be inherited by the child
+                # that is going to be spawned and will protect the child from a
+                # race condition that can make the child die before it
+                # registers signal handlers for SIGINT and SIGTERM. The mask is
+                # unregistered after spawning the child.
+                try:
+                    if _HAVE_SIGMASK:
+                        signal.pthread_sigmask(
+                            signal.SIG_BLOCK, _IGNORED_SIGNALS
+                        )
+                    pid = spawnv_passfds(exe, args, fds_to_pass)
+                finally:
+                    if _HAVE_SIGMASK:
+                        signal.pthread_sigmask(
+                            signal.SIG_UNBLOCK, _IGNORED_SIGNALS
+                        )
+            except BaseException:
+                os.close(w)
+                raise
+            else:
+                self._fd = w
+                self._pid = pid
+            finally:
+                if sys.platform == "win32":
+                    _winapi.CloseHandle(r)
+                else:
+                    os.close(r)
+
+    def _check_alive(self):
+        """Check for the existence of the resource tracker process."""
+        try:
+            self._send("PROBE", "", "")
+        except BrokenPipeError:
+            return False
+        else:
+            return True
+
+    def register(self, name, rtype):
+        """Register a named resource, and increment its refcount."""
+        self.ensure_running()
+        self._send("REGISTER", name, rtype)
+
+    def unregister(self, name, rtype):
+        """Unregister a named resource with resource tracker."""
+        self.ensure_running()
+        self._send("UNREGISTER", name, rtype)
+
+    def maybe_unlink(self, name, rtype):
+        """Decrement the refcount of a resource, and delete it if it hits 0"""
+        self.ensure_running()
+        self._send("MAYBE_UNLINK", name, rtype)
+
+    def _send(self, cmd, name, rtype):
+        if len(name) > 512:
+            # posix guarantees that writes to a pipe of less than PIPE_BUF
+            # bytes are atomic, and that PIPE_BUF >= 512
+            raise ValueError("name too long")
+        msg = f"{cmd}:{name}:{rtype}\n".encode("ascii")
+        nbytes = os.write(self._fd, msg)
+        assert nbytes == len(msg)
+
+
+_resource_tracker = ResourceTracker()
+ensure_running = _resource_tracker.ensure_running
+register = _resource_tracker.register
+maybe_unlink = _resource_tracker.maybe_unlink
+unregister = _resource_tracker.unregister
+getfd = _resource_tracker.getfd
+
+
+def main(fd, verbose=0):
+    """Run resource tracker."""
+    # protect the process from ^C and "killall python" etc
+    if verbose:
+        util.log_to_stderr(level=util.DEBUG)
+
+    signal.signal(signal.SIGINT, signal.SIG_IGN)
+    signal.signal(signal.SIGTERM, signal.SIG_IGN)
+
+    if _HAVE_SIGMASK:
+        signal.pthread_sigmask(signal.SIG_UNBLOCK, _IGNORED_SIGNALS)
+
+    for f in (sys.stdin, sys.stdout):
+        try:
+            f.close()
+        except Exception:
+            pass
+
+    if verbose:
+        util.debug("Main resource tracker is running")
+
+    registry = {rtype: {} for rtype in _CLEANUP_FUNCS.keys()}
+    try:
+        # keep track of registered/unregistered resources
+        if sys.platform == "win32":
+            fd = msvcrt.open_osfhandle(fd, os.O_RDONLY)
+        with open(fd, "rb") as f:
+            while True:
+                line = f.readline()
+                if line == b"":  # EOF
+                    break
+                try:
+                    splitted = line.strip().decode("ascii").split(":")
+                    # name can potentially contain separator symbols (for
+                    # instance folders on Windows)
+                    cmd, name, rtype = (
+                        splitted[0],
+                        ":".join(splitted[1:-1]),
+                        splitted[-1],
+                    )
+
+                    if cmd == "PROBE":
+                        continue
+
+                    if rtype not in _CLEANUP_FUNCS:
+                        raise ValueError(
+                            f"Cannot register {name} for automatic cleanup: "
+                            f"unknown resource type ({rtype}). Resource type "
+                            "should be one of the following: "
+                            f"{list(_CLEANUP_FUNCS.keys())}"
+                        )
+
+                    if cmd == "REGISTER":
+                        if name not in registry[rtype]:
+                            registry[rtype][name] = 1
+                        else:
+                            registry[rtype][name] += 1
+
+                        if verbose:
+                            util.debug(
+                                "[ResourceTracker] incremented refcount of "
+                                f"{rtype} {name} "
+                                f"(current {registry[rtype][name]})"
+                            )
+                    elif cmd == "UNREGISTER":
+                        del registry[rtype][name]
+                        if verbose:
+                            util.debug(
+                                f"[ResourceTracker] unregister {name} {rtype}: "
+                                f"registry({len(registry)})"
+                            )
+                    elif cmd == "MAYBE_UNLINK":
+                        registry[rtype][name] -= 1
+                        if verbose:
+                            util.debug(
+                                "[ResourceTracker] decremented refcount of "
+                                f"{rtype} {name} "
+                                f"(current {registry[rtype][name]})"
+                            )
+
+                        if registry[rtype][name] == 0:
+                            del registry[rtype][name]
+                            try:
+                                if verbose:
+                                    util.debug(
+                                        f"[ResourceTracker] unlink {name}"
+                                    )
+                                _CLEANUP_FUNCS[rtype](name)
+                            except Exception as e:
+                                warnings.warn(
+                                    f"resource_tracker: {name}: {e!r}"
+                                )
+
+                    else:
+                        raise RuntimeError(f"unrecognized command {cmd!r}")
+                except BaseException:
+                    try:
+                        sys.excepthook(*sys.exc_info())
+                    except BaseException:
+                        pass
+    finally:
+        # all processes have terminated; cleanup any remaining resources
+        def _unlink_resources(rtype_registry, rtype):
+            if rtype_registry:
+                try:
+                    warnings.warn(
+                        "resource_tracker: There appear to be "
+                        f"{len(rtype_registry)} leaked {rtype} objects to "
+                        "clean up at shutdown"
+                    )
+                except Exception:
+                    pass
+            for name in rtype_registry:
+                # For some reason the process which created and registered this
+                # resource has failed to unregister it. Presumably it has
+                # died.  We therefore clean it up.
+                try:
+                    _CLEANUP_FUNCS[rtype](name)
+                    if verbose:
+                        util.debug(f"[ResourceTracker] unlink {name}")
+                except Exception as e:
+                    warnings.warn(f"resource_tracker: {name}: {e!r}")
+
+        for rtype, rtype_registry in registry.items():
+            if rtype == "folder":
+                continue
+            else:
+                _unlink_resources(rtype_registry, rtype)
+
+        # The default cleanup routine for folders deletes everything inside
+        # those folders recursively, which can include other resources tracked
+        # by the resource tracker). To limit the risk of the resource tracker
+        # attempting to delete twice a resource (once as part of a tracked
+        # folder, and once as a resource), we delete the folders after all
+        # other resource types.
+        if "folder" in registry:
+            _unlink_resources(registry["folder"], "folder")
+
+    if verbose:
+        util.debug("resource tracker shut down")
+
+
+#
+# Start a program with only specified fds kept open
+#
+
+
+def spawnv_passfds(path, args, passfds):
+    passfds = sorted(passfds)
+    if sys.platform != "win32":
+        errpipe_read, errpipe_write = os.pipe()
+        try:
+            from .reduction import _mk_inheritable
+            from .fork_exec import fork_exec
+
+            _pass = [_mk_inheritable(fd) for fd in passfds]
+            return fork_exec(args, _pass)
+        finally:
+            os.close(errpipe_read)
+            os.close(errpipe_write)
+    else:
+        cmd = " ".join(f'"{x}"' for x in args)
+        try:
+            _, ht, pid, _ = _winapi.CreateProcess(
+                path, cmd, None, None, True, 0, None, None, None
+            )
+            _winapi.CloseHandle(ht)
+        except BaseException:
+            pass
+        return pid
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/spawn.py b/llm/Lib/site-packages/joblib/externals/loky/backend/spawn.py
new file mode 100644
index 0000000000000000000000000000000000000000..d011c398035f4e013ef36615a56e3bf0d8519d07
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/spawn.py
@@ -0,0 +1,250 @@
+###############################################################################
+# Prepares and processes the data to setup the new process environment
+#
+# author: Thomas Moreau and Olivier Grisel
+#
+# adapted from multiprocessing/spawn.py (17/02/2017)
+#  * Improve logging data
+#
+import os
+import sys
+import runpy
+import textwrap
+import types
+from multiprocessing import process, util
+
+
+if sys.platform != "win32":
+    WINEXE = False
+    WINSERVICE = False
+else:
+    import msvcrt
+    from multiprocessing.reduction import duplicate
+
+    WINEXE = sys.platform == "win32" and getattr(sys, "frozen", False)
+    WINSERVICE = sys.executable.lower().endswith("pythonservice.exe")
+
+if WINSERVICE:
+    _python_exe = os.path.join(sys.exec_prefix, "python.exe")
+else:
+    _python_exe = sys.executable
+
+
+def get_executable():
+    return _python_exe
+
+
+def _check_not_importing_main():
+    if getattr(process.current_process(), "_inheriting", False):
+        raise RuntimeError(
+            textwrap.dedent(
+                """\
+            An attempt has been made to start a new process before the
+            current process has finished its bootstrapping phase.
+
+            This probably means that you are not using fork to start your
+            child processes and you have forgotten to use the proper idiom
+            in the main module:
+
+                if __name__ == '__main__':
+                    freeze_support()
+                    ...
+
+            The "freeze_support()" line can be omitted if the program
+            is not going to be frozen to produce an executable."""
+            )
+        )
+
+
+def get_preparation_data(name, init_main_module=True):
+    """Return info about parent needed by child to unpickle process object."""
+    _check_not_importing_main()
+    d = dict(
+        log_to_stderr=util._log_to_stderr,
+        authkey=bytes(process.current_process().authkey),
+        name=name,
+        sys_argv=sys.argv,
+        orig_dir=process.ORIGINAL_DIR,
+        dir=os.getcwd(),
+    )
+
+    # Send sys_path and make sure the current directory will not be changed
+    d["sys_path"] = [p if p != "" else process.ORIGINAL_DIR for p in sys.path]
+
+    # Make sure to pass the information if the multiprocessing logger is active
+    if util._logger is not None:
+        d["log_level"] = util._logger.getEffectiveLevel()
+        if util._logger.handlers:
+            h = util._logger.handlers[0]
+            d["log_fmt"] = h.formatter._fmt
+
+    # Tell the child how to communicate with the resource_tracker
+    from .resource_tracker import _resource_tracker
+
+    _resource_tracker.ensure_running()
+    d["tracker_args"] = {"pid": _resource_tracker._pid}
+    if sys.platform == "win32":
+        d["tracker_args"]["fh"] = msvcrt.get_osfhandle(_resource_tracker._fd)
+    else:
+        d["tracker_args"]["fd"] = _resource_tracker._fd
+
+    if sys.version_info >= (3, 8) and os.name == "posix":
+        # joblib/loky#242: allow loky processes to retrieve the resource
+        # tracker of their parent in case the child processes depickles
+        # shared_memory objects, that are still tracked by multiprocessing's
+        # resource_tracker by default.
+        # XXX: this is a workaround that may be error prone: in the future, it
+        # would be better to have loky subclass multiprocessing's shared_memory
+        # to force registration of shared_memory segments via loky's
+        # resource_tracker.
+        from multiprocessing.resource_tracker import (
+            _resource_tracker as mp_resource_tracker,
+        )
+
+        # multiprocessing's resource_tracker must be running before loky
+        # process is created (othewise the child won't be able to use it if it
+        # is created later on)
+        mp_resource_tracker.ensure_running()
+        d["mp_tracker_args"] = {
+            "fd": mp_resource_tracker._fd,
+            "pid": mp_resource_tracker._pid,
+        }
+
+    # Figure out whether to initialise main in the subprocess as a module
+    # or through direct execution (or to leave it alone entirely)
+    if init_main_module:
+        main_module = sys.modules["__main__"]
+        try:
+            main_mod_name = getattr(main_module.__spec__, "name", None)
+        except BaseException:
+            main_mod_name = None
+        if main_mod_name is not None:
+            d["init_main_from_name"] = main_mod_name
+        elif sys.platform != "win32" or (not WINEXE and not WINSERVICE):
+            main_path = getattr(main_module, "__file__", None)
+            if main_path is not None:
+                if (
+                    not os.path.isabs(main_path)
+                    and process.ORIGINAL_DIR is not None
+                ):
+                    main_path = os.path.join(process.ORIGINAL_DIR, main_path)
+                d["init_main_from_path"] = os.path.normpath(main_path)
+
+    return d
+
+
+#
+# Prepare current process
+#
+old_main_modules = []
+
+
+def prepare(data, parent_sentinel=None):
+    """Try to get current process ready to unpickle process object."""
+    if "name" in data:
+        process.current_process().name = data["name"]
+
+    if "authkey" in data:
+        process.current_process().authkey = data["authkey"]
+
+    if "log_to_stderr" in data and data["log_to_stderr"]:
+        util.log_to_stderr()
+
+    if "log_level" in data:
+        util.get_logger().setLevel(data["log_level"])
+
+    if "log_fmt" in data:
+        import logging
+
+        util.get_logger().handlers[0].setFormatter(
+            logging.Formatter(data["log_fmt"])
+        )
+
+    if "sys_path" in data:
+        sys.path = data["sys_path"]
+
+    if "sys_argv" in data:
+        sys.argv = data["sys_argv"]
+
+    if "dir" in data:
+        os.chdir(data["dir"])
+
+    if "orig_dir" in data:
+        process.ORIGINAL_DIR = data["orig_dir"]
+
+    if "mp_tracker_args" in data:
+        from multiprocessing.resource_tracker import (
+            _resource_tracker as mp_resource_tracker,
+        )
+
+        mp_resource_tracker._fd = data["mp_tracker_args"]["fd"]
+        mp_resource_tracker._pid = data["mp_tracker_args"]["pid"]
+    if "tracker_args" in data:
+        from .resource_tracker import _resource_tracker
+
+        _resource_tracker._pid = data["tracker_args"]["pid"]
+        if sys.platform == "win32":
+            handle = data["tracker_args"]["fh"]
+            handle = duplicate(handle, source_process=parent_sentinel)
+            _resource_tracker._fd = msvcrt.open_osfhandle(handle, os.O_RDONLY)
+        else:
+            _resource_tracker._fd = data["tracker_args"]["fd"]
+
+    if "init_main_from_name" in data:
+        _fixup_main_from_name(data["init_main_from_name"])
+    elif "init_main_from_path" in data:
+        _fixup_main_from_path(data["init_main_from_path"])
+
+
+# Multiprocessing module helpers to fix up the main module in
+# spawned subprocesses
+def _fixup_main_from_name(mod_name):
+    # __main__.py files for packages, directories, zip archives, etc, run
+    # their "main only" code unconditionally, so we don't even try to
+    # populate anything in __main__, nor do we make any changes to
+    # __main__ attributes
+    current_main = sys.modules["__main__"]
+    if mod_name == "__main__" or mod_name.endswith(".__main__"):
+        return
+
+    # If this process was forked, __main__ may already be populated
+    if getattr(current_main.__spec__, "name", None) == mod_name:
+        return
+
+    # Otherwise, __main__ may contain some non-main code where we need to
+    # support unpickling it properly. We rerun it as __mp_main__ and make
+    # the normal __main__ an alias to that
+    old_main_modules.append(current_main)
+    main_module = types.ModuleType("__mp_main__")
+    main_content = runpy.run_module(
+        mod_name, run_name="__mp_main__", alter_sys=True
+    )
+    main_module.__dict__.update(main_content)
+    sys.modules["__main__"] = sys.modules["__mp_main__"] = main_module
+
+
+def _fixup_main_from_path(main_path):
+    # If this process was forked, __main__ may already be populated
+    current_main = sys.modules["__main__"]
+
+    # Unfortunately, the main ipython launch script historically had no
+    # "if __name__ == '__main__'" guard, so we work around that
+    # by treating it like a __main__.py file
+    # See https://github.com/ipython/ipython/issues/4698
+    main_name = os.path.splitext(os.path.basename(main_path))[0]
+    if main_name == "ipython":
+        return
+
+    # Otherwise, if __file__ already has the setting we expect,
+    # there's nothing more to do
+    if getattr(current_main, "__file__", None) == main_path:
+        return
+
+    # If the parent process has sent a path through rather than a module
+    # name we assume it is an executable script that may contain
+    # non-main code that needs to be executed
+    old_main_modules.append(current_main)
+    main_module = types.ModuleType("__mp_main__")
+    main_content = runpy.run_path(main_path, run_name="__mp_main__")
+    main_module.__dict__.update(main_content)
+    sys.modules["__main__"] = sys.modules["__mp_main__"] = main_module
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/synchronize.py b/llm/Lib/site-packages/joblib/externals/loky/backend/synchronize.py
new file mode 100644
index 0000000000000000000000000000000000000000..18db3e34db979240b4a4a943ea6931db3091321d
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/synchronize.py
@@ -0,0 +1,409 @@
+###############################################################################
+# Synchronization primitives based on our SemLock implementation
+#
+# author: Thomas Moreau and Olivier Grisel
+#
+# adapted from multiprocessing/synchronize.py (17/02/2017)
+#  * Remove ctx argument for compatibility reason
+#  * Registers a cleanup function with the loky resource_tracker to remove the
+#    semaphore when the process dies instead.
+#
+# TODO: investigate which Python version is required to be able to use
+# multiprocessing.resource_tracker and therefore multiprocessing.synchronize
+# instead of a loky-specific fork.
+
+import os
+import sys
+import tempfile
+import threading
+import _multiprocessing
+from time import time as _time
+from multiprocessing import process, util
+from multiprocessing.context import assert_spawning
+
+from . import resource_tracker
+
+__all__ = [
+    "Lock",
+    "RLock",
+    "Semaphore",
+    "BoundedSemaphore",
+    "Condition",
+    "Event",
+]
+# Try to import the mp.synchronize module cleanly, if it fails
+# raise ImportError for platforms lacking a working sem_open implementation.
+# See issue 3770
+try:
+    from _multiprocessing import SemLock as _SemLock
+    from _multiprocessing import sem_unlink
+except ImportError:
+    raise ImportError(
+        "This platform lacks a functioning sem_open"
+        " implementation, therefore, the required"
+        " synchronization primitives needed will not"
+        " function, see issue 3770."
+    )
+
+#
+# Constants
+#
+
+RECURSIVE_MUTEX, SEMAPHORE = range(2)
+SEM_VALUE_MAX = _multiprocessing.SemLock.SEM_VALUE_MAX
+
+
+#
+# Base class for semaphores and mutexes; wraps `_multiprocessing.SemLock`
+#
+
+
+class SemLock:
+
+    _rand = tempfile._RandomNameSequence()
+
+    def __init__(self, kind, value, maxvalue, name=None):
+        # unlink_now is only used on win32 or when we are using fork.
+        unlink_now = False
+        if name is None:
+            # Try to find an unused name for the SemLock instance.
+            for _ in range(100):
+                try:
+                    self._semlock = _SemLock(
+                        kind, value, maxvalue, SemLock._make_name(), unlink_now
+                    )
+                except FileExistsError:  # pragma: no cover
+                    pass
+                else:
+                    break
+            else:  # pragma: no cover
+                raise FileExistsError("cannot find name for semaphore")
+        else:
+            self._semlock = _SemLock(kind, value, maxvalue, name, unlink_now)
+        self.name = name
+        util.debug(
+            f"created semlock with handle {self._semlock.handle} and name "
+            f'"{self.name}"'
+        )
+
+        self._make_methods()
+
+        def _after_fork(obj):
+            obj._semlock._after_fork()
+
+        util.register_after_fork(self, _after_fork)
+
+        # When the object is garbage collected or the
+        # process shuts down we unlink the semaphore name
+        resource_tracker.register(self._semlock.name, "semlock")
+        util.Finalize(
+            self, SemLock._cleanup, (self._semlock.name,), exitpriority=0
+        )
+
+    @staticmethod
+    def _cleanup(name):
+        try:
+            sem_unlink(name)
+        except FileNotFoundError:
+            # Already unlinked, possibly by user code: ignore and make sure to
+            # unregister the semaphore from the resource tracker.
+            pass
+        finally:
+            resource_tracker.unregister(name, "semlock")
+
+    def _make_methods(self):
+        self.acquire = self._semlock.acquire
+        self.release = self._semlock.release
+
+    def __enter__(self):
+        return self._semlock.acquire()
+
+    def __exit__(self, *args):
+        return self._semlock.release()
+
+    def __getstate__(self):
+        assert_spawning(self)
+        sl = self._semlock
+        h = sl.handle
+        return (h, sl.kind, sl.maxvalue, sl.name)
+
+    def __setstate__(self, state):
+        self._semlock = _SemLock._rebuild(*state)
+        util.debug(
+            f'recreated blocker with handle {state[0]!r} and name "{state[3]}"'
+        )
+        self._make_methods()
+
+    @staticmethod
+    def _make_name():
+        # OSX does not support long names for semaphores
+        return f"/loky-{os.getpid()}-{next(SemLock._rand)}"
+
+
+#
+# Semaphore
+#
+
+
+class Semaphore(SemLock):
+    def __init__(self, value=1):
+        SemLock.__init__(self, SEMAPHORE, value, SEM_VALUE_MAX)
+
+    def get_value(self):
+        if sys.platform == "darwin":
+            raise NotImplementedError("OSX does not implement sem_getvalue")
+        return self._semlock._get_value()
+
+    def __repr__(self):
+        try:
+            value = self._semlock._get_value()
+        except Exception:
+            value = "unknown"
+        return f"<{self.__class__.__name__}(value={value})>"
+
+
+#
+# Bounded semaphore
+#
+
+
+class BoundedSemaphore(Semaphore):
+    def __init__(self, value=1):
+        SemLock.__init__(self, SEMAPHORE, value, value)
+
+    def __repr__(self):
+        try:
+            value = self._semlock._get_value()
+        except Exception:
+            value = "unknown"
+        return (
+            f"<{self.__class__.__name__}(value={value}, "
+            f"maxvalue={self._semlock.maxvalue})>"
+        )
+
+
+#
+# Non-recursive lock
+#
+
+
+class Lock(SemLock):
+    def __init__(self):
+        super().__init__(SEMAPHORE, 1, 1)
+
+    def __repr__(self):
+        try:
+            if self._semlock._is_mine():
+                name = process.current_process().name
+                if threading.current_thread().name != "MainThread":
+                    name = f"{name}|{threading.current_thread().name}"
+            elif self._semlock._get_value() == 1:
+                name = "None"
+            elif self._semlock._count() > 0:
+                name = "SomeOtherThread"
+            else:
+                name = "SomeOtherProcess"
+        except Exception:
+            name = "unknown"
+        return f"<{self.__class__.__name__}(owner={name})>"
+
+
+#
+# Recursive lock
+#
+
+
+class RLock(SemLock):
+    def __init__(self):
+        super().__init__(RECURSIVE_MUTEX, 1, 1)
+
+    def __repr__(self):
+        try:
+            if self._semlock._is_mine():
+                name = process.current_process().name
+                if threading.current_thread().name != "MainThread":
+                    name = f"{name}|{threading.current_thread().name}"
+                count = self._semlock._count()
+            elif self._semlock._get_value() == 1:
+                name, count = "None", 0
+            elif self._semlock._count() > 0:
+                name, count = "SomeOtherThread", "nonzero"
+            else:
+                name, count = "SomeOtherProcess", "nonzero"
+        except Exception:
+            name, count = "unknown", "unknown"
+        return f"<{self.__class__.__name__}({name}, {count})>"
+
+
+#
+# Condition variable
+#
+
+
+class Condition:
+    def __init__(self, lock=None):
+        self._lock = lock or RLock()
+        self._sleeping_count = Semaphore(0)
+        self._woken_count = Semaphore(0)
+        self._wait_semaphore = Semaphore(0)
+        self._make_methods()
+
+    def __getstate__(self):
+        assert_spawning(self)
+        return (
+            self._lock,
+            self._sleeping_count,
+            self._woken_count,
+            self._wait_semaphore,
+        )
+
+    def __setstate__(self, state):
+        (
+            self._lock,
+            self._sleeping_count,
+            self._woken_count,
+            self._wait_semaphore,
+        ) = state
+        self._make_methods()
+
+    def __enter__(self):
+        return self._lock.__enter__()
+
+    def __exit__(self, *args):
+        return self._lock.__exit__(*args)
+
+    def _make_methods(self):
+        self.acquire = self._lock.acquire
+        self.release = self._lock.release
+
+    def __repr__(self):
+        try:
+            num_waiters = (
+                self._sleeping_count._semlock._get_value()
+                - self._woken_count._semlock._get_value()
+            )
+        except Exception:
+            num_waiters = "unknown"
+        return f"<{self.__class__.__name__}({self._lock}, {num_waiters})>"
+
+    def wait(self, timeout=None):
+        assert (
+            self._lock._semlock._is_mine()
+        ), "must acquire() condition before using wait()"
+
+        # indicate that this thread is going to sleep
+        self._sleeping_count.release()
+
+        # release lock
+        count = self._lock._semlock._count()
+        for _ in range(count):
+            self._lock.release()
+
+        try:
+            # wait for notification or timeout
+            return self._wait_semaphore.acquire(True, timeout)
+        finally:
+            # indicate that this thread has woken
+            self._woken_count.release()
+
+            # reacquire lock
+            for _ in range(count):
+                self._lock.acquire()
+
+    def notify(self):
+        assert self._lock._semlock._is_mine(), "lock is not owned"
+        assert not self._wait_semaphore.acquire(False)
+
+        # to take account of timeouts since last notify() we subtract
+        # woken_count from sleeping_count and rezero woken_count
+        while self._woken_count.acquire(False):
+            res = self._sleeping_count.acquire(False)
+            assert res
+
+        if self._sleeping_count.acquire(False):  # try grabbing a sleeper
+            self._wait_semaphore.release()  # wake up one sleeper
+            self._woken_count.acquire()  # wait for the sleeper to wake
+
+            # rezero _wait_semaphore in case a timeout just happened
+            self._wait_semaphore.acquire(False)
+
+    def notify_all(self):
+        assert self._lock._semlock._is_mine(), "lock is not owned"
+        assert not self._wait_semaphore.acquire(False)
+
+        # to take account of timeouts since last notify*() we subtract
+        # woken_count from sleeping_count and rezero woken_count
+        while self._woken_count.acquire(False):
+            res = self._sleeping_count.acquire(False)
+            assert res
+
+        sleepers = 0
+        while self._sleeping_count.acquire(False):
+            self._wait_semaphore.release()  # wake up one sleeper
+            sleepers += 1
+
+        if sleepers:
+            for _ in range(sleepers):
+                self._woken_count.acquire()  # wait for a sleeper to wake
+
+            # rezero wait_semaphore in case some timeouts just happened
+            while self._wait_semaphore.acquire(False):
+                pass
+
+    def wait_for(self, predicate, timeout=None):
+        result = predicate()
+        if result:
+            return result
+        if timeout is not None:
+            endtime = _time() + timeout
+        else:
+            endtime = None
+            waittime = None
+        while not result:
+            if endtime is not None:
+                waittime = endtime - _time()
+                if waittime <= 0:
+                    break
+            self.wait(waittime)
+            result = predicate()
+        return result
+
+
+#
+# Event
+#
+
+
+class Event:
+    def __init__(self):
+        self._cond = Condition(Lock())
+        self._flag = Semaphore(0)
+
+    def is_set(self):
+        with self._cond:
+            if self._flag.acquire(False):
+                self._flag.release()
+                return True
+            return False
+
+    def set(self):
+        with self._cond:
+            self._flag.acquire(False)
+            self._flag.release()
+            self._cond.notify_all()
+
+    def clear(self):
+        with self._cond:
+            self._flag.acquire(False)
+
+    def wait(self, timeout=None):
+        with self._cond:
+            if self._flag.acquire(False):
+                self._flag.release()
+            else:
+                self._cond.wait(timeout)
+
+            if self._flag.acquire(False):
+                self._flag.release()
+                return True
+            return False
diff --git a/llm/Lib/site-packages/joblib/externals/loky/backend/utils.py b/llm/Lib/site-packages/joblib/externals/loky/backend/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..aa089f7a1bf9b577455775f6d6249baf4bd430de
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/backend/utils.py
@@ -0,0 +1,181 @@
+import os
+import sys
+import time
+import errno
+import signal
+import warnings
+import subprocess
+import traceback
+
+try:
+    import psutil
+except ImportError:
+    psutil = None
+
+
+def kill_process_tree(process, use_psutil=True):
+    """Terminate process and its descendants with SIGKILL"""
+    if use_psutil and psutil is not None:
+        _kill_process_tree_with_psutil(process)
+    else:
+        _kill_process_tree_without_psutil(process)
+
+
+def recursive_terminate(process, use_psutil=True):
+    warnings.warn(
+        "recursive_terminate is deprecated in loky 3.2, use kill_process_tree"
+        "instead",
+        DeprecationWarning,
+    )
+    kill_process_tree(process, use_psutil=use_psutil)
+
+
+def _kill_process_tree_with_psutil(process):
+    try:
+        descendants = psutil.Process(process.pid).children(recursive=True)
+    except psutil.NoSuchProcess:
+        return
+
+    # Kill the descendants in reverse order to avoid killing the parents before
+    # the descendant in cases where there are more processes nested.
+    for descendant in descendants[::-1]:
+        try:
+            descendant.kill()
+        except psutil.NoSuchProcess:
+            pass
+
+    try:
+        psutil.Process(process.pid).kill()
+    except psutil.NoSuchProcess:
+        pass
+    process.join()
+
+
+def _kill_process_tree_without_psutil(process):
+    """Terminate a process and its descendants."""
+    try:
+        if sys.platform == "win32":
+            _windows_taskkill_process_tree(process.pid)
+        else:
+            _posix_recursive_kill(process.pid)
+    except Exception:  # pragma: no cover
+        details = traceback.format_exc()
+        warnings.warn(
+            "Failed to kill subprocesses on this platform. Please install"
+            "psutil: https://github.com/giampaolo/psutil\n"
+            f"Details:\n{details}"
+        )
+        # In case we cannot introspect or kill the descendants, we fall back to
+        # only killing the main process.
+        #
+        # Note: on Windows, process.kill() is an alias for process.terminate()
+        # which in turns calls the Win32 API function TerminateProcess().
+        process.kill()
+    process.join()
+
+
+def _windows_taskkill_process_tree(pid):
+    # On windows, the taskkill function with option `/T` terminate a given
+    # process pid and its children.
+    try:
+        subprocess.check_output(
+            ["taskkill", "/F", "/T", "/PID", str(pid)], stderr=None
+        )
+    except subprocess.CalledProcessError as e:
+        # In Windows, taskkill returns 128, 255 for no process found.
+        if e.returncode not in [128, 255]:
+            # Let's raise to let the caller log the error details in a
+            # warning and only kill the root process.
+            raise  # pragma: no cover
+
+
+def _kill(pid):
+    # Not all systems (e.g. Windows) have a SIGKILL, but the C specification
+    # mandates a SIGTERM signal. While Windows is handled specifically above,
+    # let's try to be safe for other hypothetic platforms that only have
+    # SIGTERM without SIGKILL.
+    kill_signal = getattr(signal, "SIGKILL", signal.SIGTERM)
+    try:
+        os.kill(pid, kill_signal)
+    except OSError as e:
+        # if OSError is raised with [Errno 3] no such process, the process
+        # is already terminated, else, raise the error and let the top
+        # level function raise a warning and retry to kill the process.
+        if e.errno != errno.ESRCH:
+            raise  # pragma: no cover
+
+
+def _posix_recursive_kill(pid):
+    """Recursively kill the descendants of a process before killing it."""
+    try:
+        children_pids = subprocess.check_output(
+            ["pgrep", "-P", str(pid)], stderr=None, text=True
+        )
+    except subprocess.CalledProcessError as e:
+        # `ps` returns 1 when no child process has been found
+        if e.returncode == 1:
+            children_pids = ""
+        else:
+            raise  # pragma: no cover
+
+    # Decode the result, split the cpid and remove the trailing line
+    for cpid in children_pids.splitlines():
+        cpid = int(cpid)
+        _posix_recursive_kill(cpid)
+
+    _kill(pid)
+
+
+def get_exitcodes_terminated_worker(processes):
+    """Return a formatted string with the exitcodes of terminated workers.
+
+    If necessary, wait (up to .25s) for the system to correctly set the
+    exitcode of one terminated worker.
+    """
+    patience = 5
+
+    # Catch the exitcode of the terminated workers. There should at least be
+    # one. If not, wait a bit for the system to correctly set the exitcode of
+    # the terminated worker.
+    exitcodes = [
+        p.exitcode for p in list(processes.values()) if p.exitcode is not None
+    ]
+    while not exitcodes and patience > 0:
+        patience -= 1
+        exitcodes = [
+            p.exitcode
+            for p in list(processes.values())
+            if p.exitcode is not None
+        ]
+        time.sleep(0.05)
+
+    return _format_exitcodes(exitcodes)
+
+
+def _format_exitcodes(exitcodes):
+    """Format a list of exit code with names of the signals if possible"""
+    str_exitcodes = [
+        f"{_get_exitcode_name(e)}({e})" for e in exitcodes if e is not None
+    ]
+    return "{" + ", ".join(str_exitcodes) + "}"
+
+
+def _get_exitcode_name(exitcode):
+    if sys.platform == "win32":
+        # The exitcode are unreliable  on windows (see bpo-31863).
+        # For this case, return UNKNOWN
+        return "UNKNOWN"
+
+    if exitcode < 0:
+        try:
+            import signal
+
+            return signal.Signals(-exitcode).name
+        except ValueError:
+            return "UNKNOWN"
+    elif exitcode != 255:
+        # The exitcode are unreliable on forkserver were 255 is always returned
+        # (see bpo-30589). For this case, return UNKNOWN
+        return "EXIT"
+
+    return "UNKNOWN"
diff --git a/llm/Lib/site-packages/joblib/externals/loky/cloudpickle_wrapper.py b/llm/Lib/site-packages/joblib/externals/loky/cloudpickle_wrapper.py
new file mode 100644
index 0000000000000000000000000000000000000000..099debcb711c6695f0570861293b198047bd6093
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/cloudpickle_wrapper.py
@@ -0,0 +1,102 @@
+import inspect
+from functools import partial
+from joblib.externals.cloudpickle import dumps, loads
+
+
+WRAP_CACHE = {}
+
+
+class CloudpickledObjectWrapper:
+    def __init__(self, obj, keep_wrapper=False):
+        self._obj = obj
+        self._keep_wrapper = keep_wrapper
+
+    def __reduce__(self):
+        _pickled_object = dumps(self._obj)
+        if not self._keep_wrapper:
+            return loads, (_pickled_object,)
+
+        return _reconstruct_wrapper, (_pickled_object, self._keep_wrapper)
+
+    def __getattr__(self, attr):
+        # Ensure that the wrapped object can be used seemlessly as the
+        # previous object.
+        if attr not in ["_obj", "_keep_wrapper"]:
+            return getattr(self._obj, attr)
+        return getattr(self, attr)
+
+
+# Make sure the wrapped object conserves the callable property
+class CallableObjectWrapper(CloudpickledObjectWrapper):
+    def __call__(self, *args, **kwargs):
+        return self._obj(*args, **kwargs)
+
+
+def _wrap_non_picklable_objects(obj, keep_wrapper):
+    if callable(obj):
+        return CallableObjectWrapper(obj, keep_wrapper=keep_wrapper)
+    return CloudpickledObjectWrapper(obj, keep_wrapper=keep_wrapper)
+
+
+def _reconstruct_wrapper(_pickled_object, keep_wrapper):
+    obj = loads(_pickled_object)
+    return _wrap_non_picklable_objects(obj, keep_wrapper)
+
+
+def _wrap_objects_when_needed(obj):
+    # Function to introspect an object and decide if it should be wrapped or
+    # not.
+    need_wrap = "__main__" in getattr(obj, "__module__", "")
+    if isinstance(obj, partial):
+        return partial(
+            _wrap_objects_when_needed(obj.func),
+            *[_wrap_objects_when_needed(a) for a in obj.args],
+            **{
+                k: _wrap_objects_when_needed(v)
+                for k, v in obj.keywords.items()
+            }
+        )
+    if callable(obj):
+        # Need wrap if the object is a function defined in a local scope of
+        # another function.
+        func_code = getattr(obj, "__code__", "")
+        need_wrap |= getattr(func_code, "co_flags", 0) & inspect.CO_NESTED
+
+        # Need wrap if the obj is a lambda expression
+        func_name = getattr(obj, "__name__", "")
+        need_wrap |= "<lambda>" in func_name
+
+    if not need_wrap:
+        return obj
+
+    wrapped_obj = WRAP_CACHE.get(obj)
+    if wrapped_obj is None:
+        wrapped_obj = _wrap_non_picklable_objects(obj, keep_wrapper=False)
+        WRAP_CACHE[obj] = wrapped_obj
+    return wrapped_obj
+
+
+def wrap_non_picklable_objects(obj, keep_wrapper=True):
+    """Wrapper for non-picklable object to use cloudpickle to serialize them.
+
+    Note that this wrapper tends to slow down the serialization process as it
+    is done with cloudpickle which is typically slower compared to pickle. The
+    proper way to solve serialization issues is to avoid defining functions and
+    objects in the main scripts and to implement __reduce__ functions for
+    complex classes.
+    """
+    # If obj is a  class, create a CloudpickledClassWrapper which instantiates
+    # the object internally and wrap it directly in a CloudpickledObjectWrapper
+    if inspect.isclass(obj):
+
+        class CloudpickledClassWrapper(CloudpickledObjectWrapper):
+            def __init__(self, *args, **kwargs):
+                self._obj = obj(*args, **kwargs)
+                self._keep_wrapper = keep_wrapper
+
+        CloudpickledClassWrapper.__name__ = obj.__name__
+        return CloudpickledClassWrapper
+
+    # If obj is an instance of a class, just wrap it in a regular
+    # CloudpickledObjectWrapper
+    return _wrap_non_picklable_objects(obj, keep_wrapper=keep_wrapper)
diff --git a/llm/Lib/site-packages/joblib/externals/loky/initializers.py b/llm/Lib/site-packages/joblib/externals/loky/initializers.py
new file mode 100644
index 0000000000000000000000000000000000000000..aea0e56c25d0d74e04788493058549a1399f8342
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/initializers.py
@@ -0,0 +1,80 @@
+import warnings
+
+
+def _viztracer_init(init_kwargs):
+    """Initialize viztracer's profiler in worker processes"""
+    from viztracer import VizTracer
+
+    tracer = VizTracer(**init_kwargs)
+    tracer.register_exit()
+    tracer.start()
+
+
+def _make_viztracer_initializer_and_initargs():
+    try:
+        import viztracer
+
+        tracer = viztracer.get_tracer()
+        if tracer is not None and getattr(tracer, "enable", False):
+            # Profiler is active: introspect its configuration to
+            # initialize the workers with the same configuration.
+            return _viztracer_init, (tracer.init_kwargs,)
+    except ImportError:
+        # viztracer is not installed: nothing to do
+        pass
+    except Exception as e:
+        # In case viztracer's API evolve, we do not want to crash loky but
+        # we want to know about it to be able to update loky.
+        warnings.warn(f"Unable to introspect viztracer state: {e}")
+    return None, ()
+
+
+class _ChainedInitializer:
+    """Compound worker initializer
+
+    This is meant to be used in conjunction with _chain_initializers to
+    produce  the necessary chained_args list to be passed to __call__.
+    """
+
+    def __init__(self, initializers):
+        self._initializers = initializers
+
+    def __call__(self, *chained_args):
+        for initializer, args in zip(self._initializers, chained_args):
+            initializer(*args)
+
+
+def _chain_initializers(initializer_and_args):
+    """Convenience helper to combine a sequence of initializers.
+
+    If some initializers are None, they are filtered out.
+    """
+    filtered_initializers = []
+    filtered_initargs = []
+    for initializer, initargs in initializer_and_args:
+        if initializer is not None:
+            filtered_initializers.append(initializer)
+            filtered_initargs.append(initargs)
+
+    if not filtered_initializers:
+        return None, ()
+    elif len(filtered_initializers) == 1:
+        return filtered_initializers[0], filtered_initargs[0]
+    else:
+        return _ChainedInitializer(filtered_initializers), filtered_initargs
+
+
+def _prepare_initializer(initializer, initargs):
+    if initializer is not None and not callable(initializer):
+        raise TypeError(
+            f"initializer must be a callable, got: {initializer!r}"
+        )
+
+    # Introspect runtime to determine if we need to propagate the viztracer
+    # profiler information to the workers:
+    return _chain_initializers(
+        [
+            (initializer, initargs),
+            _make_viztracer_initializer_and_initargs(),
+        ]
+    )
diff --git a/llm/Lib/site-packages/joblib/externals/loky/process_executor.py b/llm/Lib/site-packages/joblib/externals/loky/process_executor.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e08cc21f21dad4e9df4f547add59a8660395043
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/process_executor.py
@@ -0,0 +1,1314 @@
+###############################################################################
+# Re-implementation of the ProcessPoolExecutor more robust to faults
+#
+# author: Thomas Moreau and Olivier Grisel
+#
+# adapted from concurrent/futures/process_pool_executor.py (17/02/2017)
+#  * Add an extra management thread to detect executor_manager_thread failures,
+#  * Improve the shutdown process to avoid deadlocks,
+#  * Add timeout for workers,
+#  * More robust pickling process.
+#
+# Copyright 2009 Brian Quinlan. All Rights Reserved.
+# Licensed to PSF under a Contributor Agreement.
+
+"""Implements ProcessPoolExecutor.
+
+The follow diagram and text describe the data-flow through the system:
+
+|======================= In-process =====================|== Out-of-process ==|
+
++----------+     +----------+       +--------+     +-----------+    +---------+
+|          |  => | Work Ids |       |        |     | Call Q    |    | Process |
+|          |     +----------+       |        |     +-----------+    |  Pool   |
+|          |     | ...      |       |        |     | ...       |    +---------+
+|          |     | 6        |    => |        |  => | 5, call() | => |         |
+|          |     | 7        |       |        |     | ...       |    |         |
+| Process  |     | ...      |       | Local  |     +-----------+    | Process |
+|  Pool    |     +----------+       | Worker |                      |  #1..n  |
+| Executor |                        | Thread |                      |         |
+|          |     +----------- +     |        |     +-----------+    |         |
+|          | <=> | Work Items | <=> |        | <=  | Result Q  | <= |         |
+|          |     +------------+     |        |     +-----------+    |         |
+|          |     | 6: call()  |     |        |     | ...       |    |         |
+|          |     |    future  |     +--------+     | 4, result |    |         |
+|          |     | ...        |                    | 3, except |    |         |
++----------+     +------------+                    +-----------+    +---------+
+
+Executor.submit() called:
+- creates a uniquely numbered _WorkItem and adds it to the "Work Items" dict
+- adds the id of the _WorkItem to the "Work Ids" queue
+
+Local worker thread:
+- reads work ids from the "Work Ids" queue and looks up the corresponding
+  WorkItem from the "Work Items" dict: if the work item has been cancelled then
+  it is simply removed from the dict, otherwise it is repackaged as a
+  _CallItem and put in the "Call Q". New _CallItems are put in the "Call Q"
+  until "Call Q" is full. NOTE: the size of the "Call Q" is kept small because
+  calls placed in the "Call Q" can no longer be cancelled with Future.cancel().
+- reads _ResultItems from "Result Q", updates the future stored in the
+  "Work Items" dict and deletes the dict entry
+
+Process #1..n:
+- reads _CallItems from "Call Q", executes the calls, and puts the resulting
+  _ResultItems in "Result Q"
+"""
+
+
+__author__ = "Thomas Moreau (thomas.moreau.2010@gmail.com)"
+
+
+import os
+import gc
+import sys
+import queue
+import struct
+import weakref
+import warnings
+import itertools
+import traceback
+import threading
+from time import time, sleep
+import multiprocessing as mp
+from functools import partial
+from pickle import PicklingError
+from concurrent.futures import Executor
+from concurrent.futures._base import LOGGER
+from concurrent.futures.process import BrokenProcessPool as _BPPException
+from multiprocessing.connection import wait
+
+from ._base import Future
+from .backend import get_context
+from .backend.context import cpu_count, _MAX_WINDOWS_WORKERS
+from .backend.queues import Queue, SimpleQueue
+from .backend.reduction import set_loky_pickler, get_loky_pickler_name
+from .backend.utils import kill_process_tree, get_exitcodes_terminated_worker
+from .initializers import _prepare_initializer
+
+
+# Mechanism to prevent infinite process spawning. When a worker of a
+# ProcessPoolExecutor nested in MAX_DEPTH Executor tries to create a new
+# Executor, a LokyRecursionError is raised
+MAX_DEPTH = int(os.environ.get("LOKY_MAX_DEPTH", 10))
+_CURRENT_DEPTH = 0
+
+# Minimum time interval between two consecutive memory leak protection checks.
+_MEMORY_LEAK_CHECK_DELAY = 1.0
+
+# Number of bytes of memory usage allowed over the reference process size.
+_MAX_MEMORY_LEAK_SIZE = int(3e8)
+
+
+try:
+    from psutil import Process
+
+    _USE_PSUTIL = True
+
+    def _get_memory_usage(pid, force_gc=False):
+        if force_gc:
+            gc.collect()
+
+        mem_size = Process(pid).memory_info().rss
+        mp.util.debug(f"psutil return memory size: {mem_size}")
+        return mem_size
+
+except ImportError:
+    _USE_PSUTIL = False
+
+
+class _ThreadWakeup:
+    def __init__(self):
+        self._closed = False
+        self._reader, self._writer = mp.Pipe(duplex=False)
+
+    def close(self):
+        if not self._closed:
+            self._closed = True
+            self._writer.close()
+            self._reader.close()
+
+    def wakeup(self):
+        if not self._closed:
+            self._writer.send_bytes(b"")
+
+    def clear(self):
+        if not self._closed:
+            while self._reader.poll():
+                self._reader.recv_bytes()
+
+
+class _ExecutorFlags:
+    """necessary references to maintain executor states without preventing gc
+
+    It permits to keep the information needed by executor_manager_thread
+    and crash_detection_thread to maintain the pool without preventing the
+    garbage collection of unreferenced executors.
+    """
+
+    def __init__(self, shutdown_lock):
+
+        self.shutdown = False
+        self.broken = None
+        self.kill_workers = False
+        self.shutdown_lock = shutdown_lock
+
+    def flag_as_shutting_down(self, kill_workers=None):
+        with self.shutdown_lock:
+            self.shutdown = True
+            if kill_workers is not None:
+                self.kill_workers = kill_workers
+
+    def flag_as_broken(self, broken):
+        with self.shutdown_lock:
+            self.shutdown = True
+            self.broken = broken
+
+
+# Prior to 3.9, executor_manager_thread is created as daemon thread. This means
+# that it is not joined automatically when the interpreter is shutting down.
+# To work around this problem, an exit handler is installed to tell the
+# thread to exit when the interpreter is shutting down and then waits until
+# it finishes. The thread needs to be daemonized because the atexit hooks are
+# called after all non daemonized threads are joined.
+#
+# Starting 3.9, there exists a specific atexit hook to be called before joining
+# the threads so the executor_manager_thread does not need to be daemonized
+# anymore.
+#
+# The atexit hooks are registered when starting the first ProcessPoolExecutor
+# to avoid import having an effect on the interpreter.
+
+_global_shutdown = False
+_global_shutdown_lock = threading.Lock()
+_threads_wakeups = weakref.WeakKeyDictionary()
+
+
+def _python_exit():
+    global _global_shutdown
+    _global_shutdown = True
+
+    # Materialize the list of items to avoid error due to iterating over
+    # changing size dictionary.
+    items = list(_threads_wakeups.items())
+    if len(items) > 0:
+        mp.util.debug(
+            "Interpreter shutting down. Waking up {len(items)}"
+            f"executor_manager_thread:\n{items}"
+        )
+
+    # Wake up the executor_manager_thread's so they can detect the interpreter
+    # is shutting down and exit.
+    for _, (shutdown_lock, thread_wakeup) in items:
+        with shutdown_lock:
+            thread_wakeup.wakeup()
+
+    # Collect the executor_manager_thread's to make sure we exit cleanly.
+    for thread, _ in items:
+        # This locks is to prevent situations where an executor is gc'ed in one
+        # thread while the atexit finalizer is running in another thread. This
+        # can happen when joblib is used in pypy for instance.
+        with _global_shutdown_lock:
+            thread.join()
+
+
+# With the fork context, _thread_wakeups is propagated to children.
+# Clear it after fork to avoid some situation that can cause some
+# freeze when joining the workers.
+mp.util.register_after_fork(_threads_wakeups, lambda obj: obj.clear())
+
+
+# Module variable to register the at_exit call
+process_pool_executor_at_exit = None
+
+# Controls how many more calls than processes will be queued in the call queue.
+# A smaller number will mean that processes spend more time idle waiting for
+# work while a larger number will make Future.cancel() succeed less frequently
+# (Futures in the call queue cannot be cancelled).
+EXTRA_QUEUED_CALLS = 1
+
+
+class _RemoteTraceback(Exception):
+    """Embed stringification of remote traceback in local traceback"""
+
+    def __init__(self, tb=None):
+        self.tb = f'\n"""\n{tb}"""'
+
+    def __str__(self):
+        return self.tb
+
+
+# Do not inherit from BaseException to mirror
+# concurrent.futures.process._ExceptionWithTraceback
+class _ExceptionWithTraceback:
+    def __init__(self, exc):
+        tb = getattr(exc, "__traceback__", None)
+        if tb is None:
+            _, _, tb = sys.exc_info()
+        tb = traceback.format_exception(type(exc), exc, tb)
+        tb = "".join(tb)
+        self.exc = exc
+        self.tb = tb
+
+    def __reduce__(self):
+        return _rebuild_exc, (self.exc, self.tb)
+
+
+def _rebuild_exc(exc, tb):
+    exc.__cause__ = _RemoteTraceback(tb)
+    return exc
+
+
+class _WorkItem:
+
+    __slots__ = ["future", "fn", "args", "kwargs"]
+
+    def __init__(self, future, fn, args, kwargs):
+        self.future = future
+        self.fn = fn
+        self.args = args
+        self.kwargs = kwargs
+
+
+class _ResultItem:
+    def __init__(self, work_id, exception=None, result=None):
+        self.work_id = work_id
+        self.exception = exception
+        self.result = result
+
+
+class _CallItem:
+    def __init__(self, work_id, fn, args, kwargs):
+        self.work_id = work_id
+        self.fn = fn
+        self.args = args
+        self.kwargs = kwargs
+
+        # Store the current loky_pickler so it is correctly set in the worker
+        self.loky_pickler = get_loky_pickler_name()
+
+    def __call__(self):
+        set_loky_pickler(self.loky_pickler)
+        return self.fn(*self.args, **self.kwargs)
+
+    def __repr__(self):
+        return (
+            f"CallItem({self.work_id}, {self.fn}, {self.args}, {self.kwargs})"
+        )
+
+
+class _SafeQueue(Queue):
+    """Safe Queue set exception to the future object linked to a job"""
+
+    def __init__(
+        self,
+        max_size=0,
+        ctx=None,
+        pending_work_items=None,
+        running_work_items=None,
+        thread_wakeup=None,
+        reducers=None,
+    ):
+        self.thread_wakeup = thread_wakeup
+        self.pending_work_items = pending_work_items
+        self.running_work_items = running_work_items
+        super().__init__(max_size, reducers=reducers, ctx=ctx)
+
+    def _on_queue_feeder_error(self, e, obj):
+        if isinstance(obj, _CallItem):
+            # format traceback only works on python3
+            if isinstance(e, struct.error):
+                raised_error = RuntimeError(
+                    "The task could not be sent to the workers as it is too "
+                    "large for `send_bytes`."
+                )
+            else:
+                raised_error = PicklingError(
+                    "Could not pickle the task to send it to the workers."
+                )
+            tb = traceback.format_exception(
+                type(e), e, getattr(e, "__traceback__", None)
+            )
+            raised_error.__cause__ = _RemoteTraceback("".join(tb))
+            work_item = self.pending_work_items.pop(obj.work_id, None)
+            self.running_work_items.remove(obj.work_id)
+            # work_item can be None if another process terminated. In this
+            # case, the executor_manager_thread fails all work_items with
+            # BrokenProcessPool
+            if work_item is not None:
+                work_item.future.set_exception(raised_error)
+                del work_item
+            self.thread_wakeup.wakeup()
+        else:
+            super()._on_queue_feeder_error(e, obj)
+
+
+def _get_chunks(chunksize, *iterables):
+    """Iterates over zip()ed iterables in chunks."""
+    it = zip(*iterables)
+    while True:
+        chunk = tuple(itertools.islice(it, chunksize))
+        if not chunk:
+            return
+        yield chunk
+
+
+def _process_chunk(fn, chunk):
+    """Processes a chunk of an iterable passed to map.
+
+    Runs the function passed to map() on a chunk of the
+    iterable passed to map.
+
+    This function is run in a separate process.
+
+    """
+    return [fn(*args) for args in chunk]
+
+
+def _sendback_result(result_queue, work_id, result=None, exception=None):
+    """Safely send back the given result or exception"""
+    try:
+        result_queue.put(
+            _ResultItem(work_id, result=result, exception=exception)
+        )
+    except BaseException as e:
+        exc = _ExceptionWithTraceback(e)
+        result_queue.put(_ResultItem(work_id, exception=exc))
+
+
+def _process_worker(
+    call_queue,
+    result_queue,
+    initializer,
+    initargs,
+    processes_management_lock,
+    timeout,
+    worker_exit_lock,
+    current_depth,
+):
+    """Evaluates calls from call_queue and places the results in result_queue.
+
+    This worker is run in a separate process.
+
+    Args:
+        call_queue: A ctx.Queue of _CallItems that will be read and
+            evaluated by the worker.
+        result_queue: A ctx.Queue of _ResultItems that will written
+            to by the worker.
+        initializer: A callable initializer, or None
+        initargs: A tuple of args for the initializer
+        processes_management_lock: A ctx.Lock avoiding worker timeout while
+            some workers are being spawned.
+        timeout: maximum time to wait for a new item in the call_queue. If that
+            time is expired, the worker will shutdown.
+        worker_exit_lock: Lock to avoid flagging the executor as broken on
+            workers timeout.
+        current_depth: Nested parallelism level, to avoid infinite spawning.
+    """
+    if initializer is not None:
+        try:
+            initializer(*initargs)
+        except BaseException:
+            LOGGER.critical("Exception in initializer:", exc_info=True)
+            # The parent will notice that the process stopped and
+            # mark the pool broken
+            return
+
+    # set the global _CURRENT_DEPTH mechanism to limit recursive call
+    global _CURRENT_DEPTH
+    _CURRENT_DEPTH = current_depth
+    _process_reference_size = None
+    _last_memory_leak_check = None
+    pid = os.getpid()
+
+    mp.util.debug(f"Worker started with timeout={timeout}")
+    while True:
+        try:
+            call_item = call_queue.get(block=True, timeout=timeout)
+            if call_item is None:
+                mp.util.info("Shutting down worker on sentinel")
+        except queue.Empty:
+            mp.util.info(f"Shutting down worker after timeout {timeout:0.3f}s")
+            if processes_management_lock.acquire(block=False):
+                processes_management_lock.release()
+                call_item = None
+            else:
+                mp.util.info("Could not acquire processes_management_lock")
+                continue
+        except BaseException:
+            previous_tb = traceback.format_exc()
+            try:
+                result_queue.put(_RemoteTraceback(previous_tb))
+            except BaseException:
+                # If we cannot format correctly the exception, at least print
+                # the traceback.
+                print(previous_tb)
+            mp.util.debug("Exiting with code 1")
+            sys.exit(1)
+        if call_item is None:
+            # Notify queue management thread about worker shutdown
+            result_queue.put(pid)
+            is_clean = worker_exit_lock.acquire(True, timeout=30)
+
+            # Early notify any loky executor running in this worker process
+            # (nested parallelism) that this process is about to shutdown to
+            # avoid a deadlock waiting undifinitely for the worker to finish.
+            _python_exit()
+
+            if is_clean:
+                mp.util.debug("Exited cleanly")
+            else:
+                mp.util.info("Main process did not release worker_exit")
+            return
+        try:
+            r = call_item()
+        except BaseException as e:
+            exc = _ExceptionWithTraceback(e)
+            result_queue.put(_ResultItem(call_item.work_id, exception=exc))
+        else:
+            _sendback_result(result_queue, call_item.work_id, result=r)
+            del r
+
+        # Free the resource as soon as possible, to avoid holding onto
+        # open files or shared memory that is not needed anymore
+        del call_item
+
+        if _USE_PSUTIL:
+            if _process_reference_size is None:
+                # Make reference measurement after the first call
+                _process_reference_size = _get_memory_usage(pid, force_gc=True)
+                _last_memory_leak_check = time()
+                continue
+            if time() - _last_memory_leak_check > _MEMORY_LEAK_CHECK_DELAY:
+                mem_usage = _get_memory_usage(pid)
+                _last_memory_leak_check = time()
+                if mem_usage - _process_reference_size < _MAX_MEMORY_LEAK_SIZE:
+                    # Memory usage stays within bounds: everything is fine.
+                    continue
+
+                # Check again memory usage; this time take the measurement
+                # after a forced garbage collection to break any reference
+                # cycles.
+                mem_usage = _get_memory_usage(pid, force_gc=True)
+                _last_memory_leak_check = time()
+                if mem_usage - _process_reference_size < _MAX_MEMORY_LEAK_SIZE:
+                    # The GC managed to free the memory: everything is fine.
+                    continue
+
+                # The process is leaking memory: let the master process
+                # know that we need to start a new worker.
+                mp.util.info("Memory leak detected: shutting down worker")
+                result_queue.put(pid)
+                with worker_exit_lock:
+                    mp.util.debug("Exit due to memory leak")
+                    return
+        else:
+            # if psutil is not installed, trigger gc.collect events
+            # regularly to limit potential memory leaks due to reference cycles
+            if _last_memory_leak_check is None or (
+                time() - _last_memory_leak_check > _MEMORY_LEAK_CHECK_DELAY
+            ):
+                gc.collect()
+                _last_memory_leak_check = time()
+
+
+class _ExecutorManagerThread(threading.Thread):
+    """Manages the communication between this process and the worker processes.
+
+    The manager is run in a local thread.
+
+    Args:
+        executor: A reference to the ProcessPoolExecutor that owns
+            this thread. A weakref will be own by the manager as well as
+            references to internal objects used to introspect the state of
+            the executor.
+    """
+
+    def __init__(self, executor):
+        # Store references to necessary internals of the executor.
+
+        # A _ThreadWakeup to allow waking up the executor_manager_thread from
+        # the main Thread and avoid deadlocks caused by permanently
+        # locked queues.
+        self.thread_wakeup = executor._executor_manager_thread_wakeup
+        self.shutdown_lock = executor._shutdown_lock
+
+        # A weakref.ref to the ProcessPoolExecutor that owns this thread. Used
+        # to determine if the ProcessPoolExecutor has been garbage collected
+        # and that the manager can exit.
+        # When the executor gets garbage collected, the weakref callback
+        # will wake up the queue management thread so that it can terminate
+        # if there is no pending work item.
+        def weakref_cb(
+            _,
+            thread_wakeup=self.thread_wakeup,
+            shutdown_lock=self.shutdown_lock,
+        ):
+            if mp is not None:
+                # At this point, the multiprocessing module can already be
+                # garbage collected. We only log debug info when still
+                # possible.
+                mp.util.debug(
+                    "Executor collected: triggering callback for"
+                    " QueueManager wakeup"
+                )
+            with shutdown_lock:
+                thread_wakeup.wakeup()
+
+        self.executor_reference = weakref.ref(executor, weakref_cb)
+
+        # The flags of the executor
+        self.executor_flags = executor._flags
+
+        # A list of the ctx.Process instances used as workers.
+        self.processes = executor._processes
+
+        # A ctx.Queue that will be filled with _CallItems derived from
+        # _WorkItems for processing by the process workers.
+        self.call_queue = executor._call_queue
+
+        # A ctx.SimpleQueue of _ResultItems generated by the process workers.
+        self.result_queue = executor._result_queue
+
+        # A queue.Queue of work ids e.g. Queue([5, 6, ...]).
+        self.work_ids_queue = executor._work_ids
+
+        # A dict mapping work ids to _WorkItems e.g.
+        #     {5: <_WorkItem...>, 6: <_WorkItem...>, ...}
+        self.pending_work_items = executor._pending_work_items
+
+        # A list of the work_ids that are currently running
+        self.running_work_items = executor._running_work_items
+
+        # A lock to avoid concurrent shutdown of workers on timeout and spawn
+        # of new processes or shut down
+        self.processes_management_lock = executor._processes_management_lock
+
+        super().__init__(name="ExecutorManagerThread")
+        if sys.version_info < (3, 9):
+            self.daemon = True
+
+    def run(self):
+        # Main loop for the executor manager thread.
+
+        while True:
+            self.add_call_item_to_queue()
+
+            result_item, is_broken, bpe = self.wait_result_broken_or_wakeup()
+
+            if is_broken:
+                self.terminate_broken(bpe)
+                return
+            if result_item is not None:
+                self.process_result_item(result_item)
+                # Delete reference to result_item to avoid keeping references
+                # while waiting on new results.
+                del result_item
+
+            if self.is_shutting_down():
+                self.flag_executor_shutting_down()
+
+                # Since no new work items can be added, it is safe to shutdown
+                # this thread if there are no pending work items.
+                if not self.pending_work_items:
+                    self.join_executor_internals()
+                    return
+
+    def add_call_item_to_queue(self):
+        # Fills call_queue with _WorkItems from pending_work_items.
+        # This function never blocks.
+        while True:
+            if self.call_queue.full():
+                return
+            try:
+                work_id = self.work_ids_queue.get(block=False)
+            except queue.Empty:
+                return
+            else:
+                work_item = self.pending_work_items[work_id]
+
+                if work_item.future.set_running_or_notify_cancel():
+                    self.running_work_items += [work_id]
+                    self.call_queue.put(
+                        _CallItem(
+                            work_id,
+                            work_item.fn,
+                            work_item.args,
+                            work_item.kwargs,
+                        ),
+                        block=True,
+                    )
+                else:
+                    del self.pending_work_items[work_id]
+                    continue
+
+    def wait_result_broken_or_wakeup(self):
+        # Wait for a result to be ready in the result_queue while checking
+        # that all worker processes are still running, or for a wake up
+        # signal send. The wake up signals come either from new tasks being
+        # submitted, from the executor being shutdown/gc-ed, or from the
+        # shutdown of the python interpreter.
+        result_reader = self.result_queue._reader
+        wakeup_reader = self.thread_wakeup._reader
+        readers = [result_reader, wakeup_reader]
+        worker_sentinels = [p.sentinel for p in list(self.processes.values())]
+        ready = wait(readers + worker_sentinels)
+
+        bpe = None
+        is_broken = True
+        result_item = None
+        if result_reader in ready:
+            try:
+                result_item = result_reader.recv()
+                if isinstance(result_item, _RemoteTraceback):
+                    bpe = BrokenProcessPool(
+                        "A task has failed to un-serialize. Please ensure that"
+                        " the arguments of the function are all picklable."
+                    )
+                    bpe.__cause__ = result_item
+                else:
+                    is_broken = False
+            except BaseException as e:
+                bpe = BrokenProcessPool(
+                    "A result has failed to un-serialize. Please ensure that "
+                    "the objects returned by the function are always "
+                    "picklable."
+                )
+                tb = traceback.format_exception(
+                    type(e), e, getattr(e, "__traceback__", None)
+                )
+                bpe.__cause__ = _RemoteTraceback("".join(tb))
+
+        elif wakeup_reader in ready:
+            # This is simply a wake-up event that might either trigger putting
+            # more tasks in the queue or trigger the clean up of resources.
+            is_broken = False
+        else:
+            # A worker has terminated and we don't know why, set the state of
+            # the executor as broken
+            exit_codes = ""
+            if sys.platform != "win32":
+                # In Windows, introspecting terminated workers exitcodes seems
+                # unstable, therefore they are not appended in the exception
+                # message.
+                exit_codes = (
+                    "\nThe exit codes of the workers are "
+                    f"{get_exitcodes_terminated_worker(self.processes)}"
+                )
+            mp.util.debug(
+                "A worker unexpectedly terminated. Workers that "
+                "might have caused the breakage: "
+                + str(
+                    {
+                        p.name: p.exitcode
+                        for p in list(self.processes.values())
+                        if p is not None and p.sentinel in ready
+                    }
+                )
+            )
+            bpe = TerminatedWorkerError(
+                "A worker process managed by the executor was unexpectedly "
+                "terminated. This could be caused by a segmentation fault "
+                "while calling the function or by an excessive memory usage "
+                "causing the Operating System to kill the worker.\n"
+                f"{exit_codes}"
+            )
+
+        self.thread_wakeup.clear()
+
+        return result_item, is_broken, bpe
+
+    def process_result_item(self, result_item):
+        # Process the received a result_item. This can be either the PID of a
+        # worker that exited gracefully or a _ResultItem
+
+        if isinstance(result_item, int):
+            # Clean shutdown of a worker using its PID, either on request
+            # by the executor.shutdown method or by the timeout of the worker
+            # itself: we should not mark the executor as broken.
+            with self.processes_management_lock:
+                p = self.processes.pop(result_item, None)
+
+            # p can be None if the executor is concurrently shutting down.
+            if p is not None:
+                p._worker_exit_lock.release()
+                mp.util.debug(
+                    f"joining {p.name} when processing {p.pid} as result_item"
+                )
+                p.join()
+                del p
+
+            # Make sure the executor have the right number of worker, even if a
+            # worker timeout while some jobs were submitted. If some work is
+            # pending or there is less processes than running items, we need to
+            # start a new Process and raise a warning.
+            n_pending = len(self.pending_work_items)
+            n_running = len(self.running_work_items)
+            if n_pending - n_running > 0 or n_running > len(self.processes):
+                executor = self.executor_reference()
+                if (
+                    executor is not None
+                    and len(self.processes) < executor._max_workers
+                ):
+                    warnings.warn(
+                        "A worker stopped while some jobs were given to the "
+                        "executor. This can be caused by a too short worker "
+                        "timeout or by a memory leak.",
+                        UserWarning,
+                    )
+                    with executor._processes_management_lock:
+                        executor._adjust_process_count()
+                    executor = None
+        else:
+            # Received a _ResultItem so mark the future as completed.
+            work_item = self.pending_work_items.pop(result_item.work_id, None)
+            # work_item can be None if another process terminated (see above)
+            if work_item is not None:
+                if result_item.exception:
+                    work_item.future.set_exception(result_item.exception)
+                else:
+                    work_item.future.set_result(result_item.result)
+                self.running_work_items.remove(result_item.work_id)
+
+    def is_shutting_down(self):
+        # Check whether we should start shutting down the executor.
+        executor = self.executor_reference()
+        # No more work items can be added if:
+        #   - The interpreter is shutting down OR
+        #   - The executor that owns this thread is not broken AND
+        #        * The executor that owns this worker has been collected OR
+        #        * The executor that owns this worker has been shutdown.
+        # If the executor is broken, it should be detected in the next loop.
+        return _global_shutdown or (
+            (executor is None or self.executor_flags.shutdown)
+            and not self.executor_flags.broken
+        )
+
+    def terminate_broken(self, bpe):
+        # Terminate the executor because it is in a broken state. The bpe
+        # argument can be used to display more information on the error that
+        # lead the executor into becoming broken.
+
+        # Mark the process pool broken so that submits fail right now.
+        self.executor_flags.flag_as_broken(bpe)
+
+        # Mark pending tasks as failed.
+        for work_item in self.pending_work_items.values():
+            work_item.future.set_exception(bpe)
+            # Delete references to object. See issue16284
+            del work_item
+        self.pending_work_items.clear()
+
+        # Terminate remaining workers forcibly: the queues or their
+        # locks may be in a dirty state and block forever.
+        self.kill_workers(reason="broken executor")
+
+        # clean up resources
+        self.join_executor_internals()
+
+    def flag_executor_shutting_down(self):
+        # Flag the executor as shutting down and cancel remaining tasks if
+        # requested as early as possible if it is not gc-ed yet.
+        self.executor_flags.flag_as_shutting_down()
+
+        # Cancel pending work items if requested.
+        if self.executor_flags.kill_workers:
+            while self.pending_work_items:
+                _, work_item = self.pending_work_items.popitem()
+                work_item.future.set_exception(
+                    ShutdownExecutorError(
+                        "The Executor was shutdown with `kill_workers=True` "
+                        "before this job could complete."
+                    )
+                )
+                del work_item
+
+            # Kill the remaining worker forcibly to no waste time joining them
+            self.kill_workers(reason="executor shutting down")
+
+    def kill_workers(self, reason=""):
+        # Terminate the remaining workers using SIGKILL. This function also
+        # terminates descendant workers of the children in case there is some
+        # nested parallelism.
+        while self.processes:
+            _, p = self.processes.popitem()
+            mp.util.debug(f"terminate process {p.name}, reason: {reason}")
+            try:
+                kill_process_tree(p)
+            except ProcessLookupError:  # pragma: no cover
+                pass
+
+    def shutdown_workers(self):
+        # shutdown all workers in self.processes
+
+        # Create a list to avoid RuntimeError due to concurrent modification of
+        # processes. nb_children_alive is thus an upper bound. Also release the
+        # processes' _worker_exit_lock to accelerate the shutdown procedure, as
+        # there is no need for hand-shake here.
+        with self.processes_management_lock:
+            n_children_to_stop = 0
+            for p in list(self.processes.values()):
+                mp.util.debug(f"releasing worker exit lock on {p.name}")
+                p._worker_exit_lock.release()
+                n_children_to_stop += 1
+
+        mp.util.debug(f"found {n_children_to_stop} processes to stop")
+
+        # Send the right number of sentinels, to make sure all children are
+        # properly terminated. Do it with a mechanism that avoid hanging on
+        # Full queue when all workers have already been shutdown.
+        n_sentinels_sent = 0
+        cooldown_time = 0.001
+        while (
+            n_sentinels_sent < n_children_to_stop
+            and self.get_n_children_alive() > 0
+        ):
+            for _ in range(n_children_to_stop - n_sentinels_sent):
+                try:
+                    self.call_queue.put_nowait(None)
+                    n_sentinels_sent += 1
+                except queue.Full as e:
+                    if cooldown_time > 5.0:
+                        mp.util.info(
+                            "failed to send all sentinels and exit with error."
+                            f"\ncall_queue size={self.call_queue._maxsize}; "
+                            f" full is {self.call_queue.full()}; "
+                        )
+                        raise e
+                    mp.util.info(
+                        "full call_queue prevented to send all sentinels at "
+                        "once, waiting..."
+                    )
+                    sleep(cooldown_time)
+                    cooldown_time *= 1.2
+                    break
+
+        mp.util.debug(f"sent {n_sentinels_sent} sentinels to the call queue")
+
+    def join_executor_internals(self):
+        self.shutdown_workers()
+
+        # Release the queue's resources as soon as possible. Flag the feeder
+        # thread for clean exit to avoid having the crash detection thread flag
+        # the Executor as broken during the shutdown. This is safe as either:
+        #  * We don't need to communicate with the workers anymore
+        #  * There is nothing left in the Queue buffer except None sentinels
+        mp.util.debug("closing call_queue")
+        self.call_queue.close()
+        self.call_queue.join_thread()
+
+        # Closing result_queue
+        mp.util.debug("closing result_queue")
+        self.result_queue.close()
+
+        mp.util.debug("closing thread_wakeup")
+        with self.shutdown_lock:
+            self.thread_wakeup.close()
+
+        # If .join() is not called on the created processes then
+        # some ctx.Queue methods may deadlock on macOS.
+        with self.processes_management_lock:
+            mp.util.debug(f"joining {len(self.processes)} processes")
+            n_joined_processes = 0
+            while True:
+                try:
+                    pid, p = self.processes.popitem()
+                    mp.util.debug(f"joining process {p.name} with pid {pid}")
+                    p.join()
+                    n_joined_processes += 1
+                except KeyError:
+                    break
+
+            mp.util.debug(
+                "executor management thread clean shutdown of "
+                f"{n_joined_processes} workers"
+            )
+
+    def get_n_children_alive(self):
+        # This is an upper bound on the number of children alive.
+        with self.processes_management_lock:
+            return sum(p.is_alive() for p in list(self.processes.values()))
+
+
+_system_limits_checked = False
+_system_limited = None
+
+
+def _check_system_limits():
+    global _system_limits_checked, _system_limited
+    if _system_limits_checked and _system_limited:
+        raise NotImplementedError(_system_limited)
+    _system_limits_checked = True
+    try:
+        nsems_max = os.sysconf("SC_SEM_NSEMS_MAX")
+    except (AttributeError, ValueError):
+        # sysconf not available or setting not available
+        return
+    if nsems_max == -1:
+        # undetermined limit, assume that limit is determined
+        # by available memory only
+        return
+    if nsems_max >= 256:
+        # minimum number of semaphores available
+        # according to POSIX
+        return
+    _system_limited = (
+        f"system provides too few semaphores ({nsems_max} available, "
+        "256 necessary)"
+    )
+    raise NotImplementedError(_system_limited)
+
+
+def _chain_from_iterable_of_lists(iterable):
+    """
+    Specialized implementation of itertools.chain.from_iterable.
+    Each item in *iterable* should be a list.  This function is
+    careful not to keep references to yielded objects.
+    """
+    for element in iterable:
+        element.reverse()
+        while element:
+            yield element.pop()
+
+
+def _check_max_depth(context):
+    # Limit the maxmal recursion level
+    global _CURRENT_DEPTH
+    if context.get_start_method() == "fork" and _CURRENT_DEPTH > 0:
+        raise LokyRecursionError(
+            "Could not spawn extra nested processes at depth superior to "
+            "MAX_DEPTH=1. It is not possible to increase this limit when "
+            "using the 'fork' start method."
+        )
+
+    if 0 < MAX_DEPTH and _CURRENT_DEPTH + 1 > MAX_DEPTH:
+        raise LokyRecursionError(
+            "Could not spawn extra nested processes at depth superior to "
+            f"MAX_DEPTH={MAX_DEPTH}. If this is intendend, you can change "
+            "this limit with the LOKY_MAX_DEPTH environment variable."
+        )
+
+
+class LokyRecursionError(RuntimeError):
+    """A process tries to spawn too many levels of nested processes."""
+
+
+class BrokenProcessPool(_BPPException):
+    """
+    Raised when the executor is broken while a future was in the running state.
+    The cause can an error raised when unpickling the task in the worker
+    process or when unpickling the result value in the parent process. It can
+    also be caused by a worker process being terminated unexpectedly.
+    """
+
+
+class TerminatedWorkerError(BrokenProcessPool):
+    """
+    Raised when a process in a ProcessPoolExecutor terminated abruptly
+    while a future was in the running state.
+    """
+
+
+# Alias for backward compat (for code written for loky 1.1.4 and earlier). Do
+# not use in new code.
+BrokenExecutor = BrokenProcessPool
+
+
+class ShutdownExecutorError(RuntimeError):
+
+    """
+    Raised when a ProcessPoolExecutor is shutdown while a future was in the
+    running or pending state.
+    """
+
+
+class ProcessPoolExecutor(Executor):
+
+    _at_exit = None
+
+    def __init__(
+        self,
+        max_workers=None,
+        job_reducers=None,
+        result_reducers=None,
+        timeout=None,
+        context=None,
+        initializer=None,
+        initargs=(),
+        env=None,
+    ):
+        """Initializes a new ProcessPoolExecutor instance.
+
+        Args:
+            max_workers: int, optional (default: cpu_count())
+                The maximum number of processes that can be used to execute the
+                given calls. If None or not given then as many worker processes
+                will be created as the number of CPUs the current process
+                can use.
+            job_reducers, result_reducers: dict(type: reducer_func)
+                Custom reducer for pickling the jobs and the results from the
+                Executor. If only `job_reducers` is provided, `result_reducer`
+                will use the same reducers
+            timeout: int, optional (default: None)
+                Idle workers exit after timeout seconds. If a new job is
+                submitted after the timeout, the executor will start enough
+                new Python processes to make sure the pool of workers is full.
+            context: A multiprocessing context to launch the workers. This
+                object should provide SimpleQueue, Queue and Process.
+            initializer: An callable used to initialize worker processes.
+            initargs: A tuple of arguments to pass to the initializer.
+            env: A dict of environment variable to overwrite in the child
+                process. The environment variables are set before any module is
+                loaded. Note that this only works with the loky context.
+        """
+        _check_system_limits()
+
+        if max_workers is None:
+            self._max_workers = cpu_count()
+        else:
+            if max_workers <= 0:
+                raise ValueError("max_workers must be greater than 0")
+            self._max_workers = max_workers
+
+        if (
+            sys.platform == "win32"
+            and self._max_workers > _MAX_WINDOWS_WORKERS
+        ):
+            warnings.warn(
+                f"On Windows, max_workers cannot exceed {_MAX_WINDOWS_WORKERS} "
+                "due to limitations of the operating system."
+            )
+            self._max_workers = _MAX_WINDOWS_WORKERS
+
+        if context is None:
+            context = get_context()
+        self._context = context
+        self._env = env
+
+        self._initializer, self._initargs = _prepare_initializer(
+            initializer, initargs
+        )
+        _check_max_depth(self._context)
+
+        if result_reducers is None:
+            result_reducers = job_reducers
+
+        # Timeout
+        self._timeout = timeout
+
+        # Management thread
+        self._executor_manager_thread = None
+
+        # Map of pids to processes
+        self._processes = {}
+
+        # Internal variables of the ProcessPoolExecutor
+        self._processes = {}
+        self._queue_count = 0
+        self._pending_work_items = {}
+        self._running_work_items = []
+        self._work_ids = queue.Queue()
+        self._processes_management_lock = self._context.Lock()
+        self._executor_manager_thread = None
+        self._shutdown_lock = threading.Lock()
+
+        # _ThreadWakeup is a communication channel used to interrupt the wait
+        # of the main loop of executor_manager_thread from another thread (e.g.
+        # when calling executor.submit or executor.shutdown). We do not use the
+        # _result_queue to send wakeup signals to the executor_manager_thread
+        # as it could result in a deadlock if a worker process dies with the
+        # _result_queue write lock still acquired.
+        #
+        # _shutdown_lock must be locked to access _ThreadWakeup.wakeup.
+        self._executor_manager_thread_wakeup = _ThreadWakeup()
+
+        # Flag to hold the state of the Executor. This permits to introspect
+        # the Executor state even once it has been garbage collected.
+        self._flags = _ExecutorFlags(self._shutdown_lock)
+
+        # Finally setup the queues for interprocess communication
+        self._setup_queues(job_reducers, result_reducers)
+
+        mp.util.debug("ProcessPoolExecutor is setup")
+
+    def _setup_queues(self, job_reducers, result_reducers, queue_size=None):
+        # Make the call queue slightly larger than the number of processes to
+        # prevent the worker processes from idling. But don't make it too big
+        # because futures in the call queue cannot be cancelled.
+        if queue_size is None:
+            queue_size = 2 * self._max_workers + EXTRA_QUEUED_CALLS
+        self._call_queue = _SafeQueue(
+            max_size=queue_size,
+            pending_work_items=self._pending_work_items,
+            running_work_items=self._running_work_items,
+            thread_wakeup=self._executor_manager_thread_wakeup,
+            reducers=job_reducers,
+            ctx=self._context,
+        )
+        # Killed worker processes can produce spurious "broken pipe"
+        # tracebacks in the queue's own worker thread. But we detect killed
+        # processes anyway, so silence the tracebacks.
+        self._call_queue._ignore_epipe = True
+
+        self._result_queue = SimpleQueue(
+            reducers=result_reducers, ctx=self._context
+        )
+
+    def _start_executor_manager_thread(self):
+        if self._executor_manager_thread is None:
+            mp.util.debug("_start_executor_manager_thread called")
+
+            # Start the processes so that their sentinels are known.
+            self._executor_manager_thread = _ExecutorManagerThread(self)
+            self._executor_manager_thread.start()
+
+            # register this executor in a mechanism that ensures it will wakeup
+            # when the interpreter is exiting.
+            _threads_wakeups[self._executor_manager_thread] = (
+                self._shutdown_lock,
+                self._executor_manager_thread_wakeup,
+            )
+
+            global process_pool_executor_at_exit
+            if process_pool_executor_at_exit is None:
+                # Ensure that the _python_exit function will be called before
+                # the multiprocessing.Queue._close finalizers which have an
+                # exitpriority of 10.
+
+                if sys.version_info < (3, 9):
+                    process_pool_executor_at_exit = mp.util.Finalize(
+                        None, _python_exit, exitpriority=20
+                    )
+                else:
+                    process_pool_executor_at_exit = threading._register_atexit(
+                        _python_exit
+                    )
+
+    def _adjust_process_count(self):
+        while len(self._processes) < self._max_workers:
+            worker_exit_lock = self._context.BoundedSemaphore(1)
+            args = (
+                self._call_queue,
+                self._result_queue,
+                self._initializer,
+                self._initargs,
+                self._processes_management_lock,
+                self._timeout,
+                worker_exit_lock,
+                _CURRENT_DEPTH + 1,
+            )
+            worker_exit_lock.acquire()
+            try:
+                # Try to spawn the process with some environment variable to
+                # overwrite but it only works with the loky context for now.
+                p = self._context.Process(
+                    target=_process_worker, args=args, env=self._env
+                )
+            except TypeError:
+                p = self._context.Process(target=_process_worker, args=args)
+            p._worker_exit_lock = worker_exit_lock
+            p.start()
+            self._processes[p.pid] = p
+        mp.util.debug(
+            f"Adjusted process count to {self._max_workers}: "
+            f"{[(p.name, pid) for pid, p in self._processes.items()]}"
+        )
+
+    def _ensure_executor_running(self):
+        """ensures all workers and management thread are running"""
+        with self._processes_management_lock:
+            if len(self._processes) != self._max_workers:
+                self._adjust_process_count()
+            self._start_executor_manager_thread()
+
+    def submit(self, fn, *args, **kwargs):
+        with self._flags.shutdown_lock:
+            if self._flags.broken is not None:
+                raise self._flags.broken
+            if self._flags.shutdown:
+                raise ShutdownExecutorError(
+                    "cannot schedule new futures after shutdown"
+                )
+
+            # Cannot submit a new calls once the interpreter is shutting down.
+            # This check avoids spawning new processes at exit.
+            if _global_shutdown:
+                raise RuntimeError(
+                    "cannot schedule new futures after " "interpreter shutdown"
+                )
+
+            f = Future()
+            w = _WorkItem(f, fn, args, kwargs)
+
+            self._pending_work_items[self._queue_count] = w
+            self._work_ids.put(self._queue_count)
+            self._queue_count += 1
+            # Wake up queue management thread
+            self._executor_manager_thread_wakeup.wakeup()
+
+            self._ensure_executor_running()
+            return f
+
+    submit.__doc__ = Executor.submit.__doc__
+
+    def map(self, fn, *iterables, **kwargs):
+        """Returns an iterator equivalent to map(fn, iter).
+
+        Args:
+            fn: A callable that will take as many arguments as there are
+                passed iterables.
+            timeout: The maximum number of seconds to wait. If None, then there
+                is no limit on the wait time.
+            chunksize: If greater than one, the iterables will be chopped into
+                chunks of size chunksize and submitted to the process pool.
+                If set to one, the items in the list will be sent one at a
+                time.
+
+        Returns:
+            An iterator equivalent to: map(func, *iterables) but the calls may
+            be evaluated out-of-order.
+
+        Raises:
+            TimeoutError: If the entire result iterator could not be generated
+                before the given timeout.
+            Exception: If fn(*args) raises for any values.
+        """
+        timeout = kwargs.get("timeout", None)
+        chunksize = kwargs.get("chunksize", 1)
+        if chunksize < 1:
+            raise ValueError("chunksize must be >= 1.")
+
+        results = super().map(
+            partial(_process_chunk, fn),
+            _get_chunks(chunksize, *iterables),
+            timeout=timeout,
+        )
+        return _chain_from_iterable_of_lists(results)
+
+    def shutdown(self, wait=True, kill_workers=False):
+        mp.util.debug(f"shutting down executor {self}")
+
+        self._flags.flag_as_shutting_down(kill_workers)
+        executor_manager_thread = self._executor_manager_thread
+        executor_manager_thread_wakeup = self._executor_manager_thread_wakeup
+
+        if executor_manager_thread_wakeup is not None:
+            # Wake up queue management thread
+            with self._shutdown_lock:
+                self._executor_manager_thread_wakeup.wakeup()
+
+        if executor_manager_thread is not None and wait:
+            # This locks avoids concurrent join if the interpreter
+            # is shutting down.
+            with _global_shutdown_lock:
+                executor_manager_thread.join()
+                _threads_wakeups.pop(executor_manager_thread, None)
+
+        # To reduce the risk of opening too many files, remove references to
+        # objects that use file descriptors.
+        self._executor_manager_thread = None
+        self._executor_manager_thread_wakeup = None
+        self._call_queue = None
+        self._result_queue = None
+        self._processes_management_lock = None
+
+    shutdown.__doc__ = Executor.shutdown.__doc__
diff --git a/llm/Lib/site-packages/joblib/externals/loky/reusable_executor.py b/llm/Lib/site-packages/joblib/externals/loky/reusable_executor.py
new file mode 100644
index 0000000000000000000000000000000000000000..ad016fd389762a1c458200ffe7b310239da3a3f3
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/externals/loky/reusable_executor.py
@@ -0,0 +1,285 @@
+###############################################################################
+# Reusable ProcessPoolExecutor
+#
+# author: Thomas Moreau and Olivier Grisel
+#
+import time
+import warnings
+import threading
+import multiprocessing as mp
+
+from .process_executor import ProcessPoolExecutor, EXTRA_QUEUED_CALLS
+from .backend.context import cpu_count
+from .backend import get_context
+
+__all__ = ["get_reusable_executor"]
+
+# Singleton executor and id management
+_executor_lock = threading.RLock()
+_next_executor_id = 0
+_executor = None
+_executor_kwargs = None
+
+
+def _get_next_executor_id():
+    """Ensure that each successive executor instance has a unique, monotonic id.
+
+    The purpose of this monotonic id is to help debug and test automated
+    instance creation.
+    """
+    global _next_executor_id
+    with _executor_lock:
+        executor_id = _next_executor_id
+        _next_executor_id += 1
+        return executor_id
+
+
+def get_reusable_executor(
+    max_workers=None,
+    context=None,
+    timeout=10,
+    kill_workers=False,
+    reuse="auto",
+    job_reducers=None,
+    result_reducers=None,
+    initializer=None,
+    initargs=(),
+    env=None,
+):
+    """Return the current ReusableExectutor instance.
+
+    Start a new instance if it has not been started already or if the previous
+    instance was left in a broken state.
+
+    If the previous instance does not have the requested number of workers, the
+    executor is dynamically resized to adjust the number of workers prior to
+    returning.
+
+    Reusing a singleton instance spares the overhead of starting new worker
+    processes and importing common python packages each time.
+
+    ``max_workers`` controls the maximum number of tasks that can be running in
+    parallel in worker processes. By default this is set to the number of
+    CPUs on the host.
+
+    Setting ``timeout`` (in seconds) makes idle workers automatically shutdown
+    so as to release system resources. New workers are respawn upon submission
+    of new tasks so that ``max_workers`` are available to accept the newly
+    submitted tasks. Setting ``timeout`` to around 100 times the time required
+    to spawn new processes and import packages in them (on the order of 100ms)
+    ensures that the overhead of spawning workers is negligible.
+
+    Setting ``kill_workers=True`` makes it possible to forcibly interrupt
+    previously spawned jobs to get a new instance of the reusable executor
+    with new constructor argument values.
+
+    The ``job_reducers`` and ``result_reducers`` are used to customize the
+    pickling of tasks and results send to the executor.
+
+    When provided, the ``initializer`` is run first in newly spawned
+    processes with argument ``initargs``.
+
+    The environment variable in the child process are a copy of the values in
+    the main process. One can provide a dict ``{ENV: VAL}`` where ``ENV`` and
+    ``VAL`` are string literals to overwrite the environment variable ``ENV``
+    in the child processes to value ``VAL``. The environment variables are set
+    in the children before any module is loaded. This only works with the
+    ``loky`` context.
+    """
+    _executor, _ = _ReusablePoolExecutor.get_reusable_executor(
+        max_workers=max_workers,
+        context=context,
+        timeout=timeout,
+        kill_workers=kill_workers,
+        reuse=reuse,
+        job_reducers=job_reducers,
+        result_reducers=result_reducers,
+        initializer=initializer,
+        initargs=initargs,
+        env=env,
+    )
+    return _executor
+
+
+class _ReusablePoolExecutor(ProcessPoolExecutor):
+    def __init__(
+        self,
+        submit_resize_lock,
+        max_workers=None,
+        context=None,
+        timeout=None,
+        executor_id=0,
+        job_reducers=None,
+        result_reducers=None,
+        initializer=None,
+        initargs=(),
+        env=None,
+    ):
+        super().__init__(
+            max_workers=max_workers,
+            context=context,
+            timeout=timeout,
+            job_reducers=job_reducers,
+            result_reducers=result_reducers,
+            initializer=initializer,
+            initargs=initargs,
+            env=env,
+        )
+        self.executor_id = executor_id
+        self._submit_resize_lock = submit_resize_lock
+
+    @classmethod
+    def get_reusable_executor(
+        cls,
+        max_workers=None,
+        context=None,
+        timeout=10,
+        kill_workers=False,
+        reuse="auto",
+        job_reducers=None,
+        result_reducers=None,
+        initializer=None,
+        initargs=(),
+        env=None,
+    ):
+        with _executor_lock:
+            global _executor, _executor_kwargs
+            executor = _executor
+
+            if max_workers is None:
+                if reuse is True and executor is not None:
+                    max_workers = executor._max_workers
+                else:
+                    max_workers = cpu_count()
+            elif max_workers <= 0:
+                raise ValueError(
+                    f"max_workers must be greater than 0, got {max_workers}."
+                )
+
+            if isinstance(context, str):
+                context = get_context(context)
+            if context is not None and context.get_start_method() == "fork":
+                raise ValueError(
+                    "Cannot use reusable executor with the 'fork' context"
+                )
+
+            kwargs = dict(
+                context=context,
+                timeout=timeout,
+                job_reducers=job_reducers,
+                result_reducers=result_reducers,
+                initializer=initializer,
+                initargs=initargs,
+                env=env,
+            )
+            if executor is None:
+                is_reused = False
+                mp.util.debug(
+                    f"Create a executor with max_workers={max_workers}."
+                )
+                executor_id = _get_next_executor_id()
+                _executor_kwargs = kwargs
+                _executor = executor = cls(
+                    _executor_lock,
+                    max_workers=max_workers,
+                    executor_id=executor_id,
+                    **kwargs,
+                )
+            else:
+                if reuse == "auto":
+                    reuse = kwargs == _executor_kwargs
+                if (
+                    executor._flags.broken
+                    or executor._flags.shutdown
+                    or not reuse
+                ):
+                    if executor._flags.broken:
+                        reason = "broken"
+                    elif executor._flags.shutdown:
+                        reason = "shutdown"
+                    else:
+                        reason = "arguments have changed"
+                    mp.util.debug(
+                        "Creating a new executor with max_workers="
+                        f"{max_workers} as the previous instance cannot be "
+                        f"reused ({reason})."
+                    )
+                    executor.shutdown(wait=True, kill_workers=kill_workers)
+                    _executor = executor = _executor_kwargs = None
+                    # Recursive call to build a new instance
+                    return cls.get_reusable_executor(
+                        max_workers=max_workers, **kwargs
+                    )
+                else:
+                    mp.util.debug(
+                        "Reusing existing executor with "
+                        f"max_workers={executor._max_workers}."
+                    )
+                    is_reused = True
+                    executor._resize(max_workers)
+
+        return executor, is_reused
+
+    def submit(self, fn, *args, **kwargs):
+        with self._submit_resize_lock:
+            return super().submit(fn, *args, **kwargs)
+
+    def _resize(self, max_workers):
+        with self._submit_resize_lock:
+            if max_workers is None:
+                raise ValueError("Trying to resize with max_workers=None")
+            elif max_workers == self._max_workers:
+                return
+
+            if self._executor_manager_thread is None:
+                # If the executor_manager_thread has not been started
+                # then no processes have been spawned and we can just
+                # update _max_workers and return
+                self._max_workers = max_workers
+                return
+
+            self._wait_job_completion()
+
+            # Some process might have returned due to timeout so check how many
+            # children are still alive. Use the _process_management_lock to
+            # ensure that no process are spawned or timeout during the resize.
+            with self._processes_management_lock:
+                processes = list(self._processes.values())
+                nb_children_alive = sum(p.is_alive() for p in processes)
+                self._max_workers = max_workers
+                for _ in range(max_workers, nb_children_alive):
+                    self._call_queue.put(None)
+            while (
+                len(self._processes) > max_workers and not self._flags.broken
+            ):
+                time.sleep(1e-3)
+
+            self._adjust_process_count()
+            processes = list(self._processes.values())
+            while not all(p.is_alive() for p in processes):
+                time.sleep(1e-3)
+
+    def _wait_job_completion(self):
+        """Wait for the cache to be empty before resizing the pool."""
+        # Issue a warning to the user about the bad effect of this usage.
+        if self._pending_work_items:
+            warnings.warn(
+                "Trying to resize an executor with running jobs: "
+                "waiting for jobs completion before resizing.",
+                UserWarning,
+            )
+            mp.util.debug(
+                f"Executor {self.executor_id} waiting for jobs completion "
+                "before resizing"
+            )
+        # Wait for the completion of the jobs
+        while self._pending_work_items:
+            time.sleep(1e-3)
+
+    def _setup_queues(self, job_reducers, result_reducers):
+        # As this executor can be resized, use a large queue size to avoid
+        # underestimating capacity and introducing overhead
+        queue_size = 2 * cpu_count() + EXTRA_QUEUED_CALLS
+        super()._setup_queues(
+            job_reducers, result_reducers, queue_size=queue_size
+        )
diff --git a/llm/Lib/site-packages/joblib/func_inspect.py b/llm/Lib/site-packages/joblib/func_inspect.py
new file mode 100644
index 0000000000000000000000000000000000000000..3f8094614b90abed5804723908ddf5eb109901b1
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/func_inspect.py
@@ -0,0 +1,369 @@
+"""
+My own variation on function-specific inspect-like features.
+"""
+
+# Author: Gael Varoquaux <gael dot varoquaux at normalesup dot org>
+# Copyright (c) 2009 Gael Varoquaux
+# License: BSD Style, 3 clauses.
+
+import inspect
+import warnings
+import re
+import os
+import collections
+
+from itertools import islice
+from tokenize import open as open_py_source
+
+from .logger import pformat
+
+full_argspec_fields = ('args varargs varkw defaults kwonlyargs '
+                       'kwonlydefaults annotations')
+full_argspec_type = collections.namedtuple('FullArgSpec', full_argspec_fields)
+
+
+def get_func_code(func):
+    """ Attempts to retrieve a reliable function code hash.
+
+        The reason we don't use inspect.getsource is that it caches the
+        source, whereas we want this to be modified on the fly when the
+        function is modified.
+
+        Returns
+        -------
+        func_code: string
+            The function code
+        source_file: string
+            The path to the file in which the function is defined.
+        first_line: int
+            The first line of the code in the source file.
+
+        Notes
+        ------
+        This function does a bit more magic than inspect, and is thus
+        more robust.
+    """
+    source_file = None
+    try:
+        code = func.__code__
+        source_file = code.co_filename
+        if not os.path.exists(source_file):
+            # Use inspect for lambda functions and functions defined in an
+            # interactive shell, or in doctests
+            source_code = ''.join(inspect.getsourcelines(func)[0])
+            line_no = 1
+            if source_file.startswith('<doctest '):
+                source_file, line_no = re.match(
+                    r'\<doctest (.*\.rst)\[(.*)\]\>', source_file).groups()
+                line_no = int(line_no)
+                source_file = '<doctest %s>' % source_file
+            return source_code, source_file, line_no
+        # Try to retrieve the source code.
+        with open_py_source(source_file) as source_file_obj:
+            first_line = code.co_firstlineno
+            # All the lines after the function definition:
+            source_lines = list(islice(source_file_obj, first_line - 1, None))
+        return ''.join(inspect.getblock(source_lines)), source_file, first_line
+    except:  # noqa: E722
+        # If the source code fails, we use the hash. This is fragile and
+        # might change from one session to another.
+        if hasattr(func, '__code__'):
+            # Python 3.X
+            return str(func.__code__.__hash__()), source_file, -1
+        else:
+            # Weird objects like numpy ufunc don't have __code__
+            # This is fragile, as quite often the id of the object is
+            # in the repr, so it might not persist across sessions,
+            # however it will work for ufuncs.
+            return repr(func), source_file, -1
+
+
+def _clean_win_chars(string):
+    """Windows cannot encode some characters in filename."""
+    import urllib
+    if hasattr(urllib, 'quote'):
+        quote = urllib.quote
+    else:
+        # In Python 3, quote is elsewhere
+        import urllib.parse
+        quote = urllib.parse.quote
+    for char in ('<', '>', '!', ':', '\\'):
+        string = string.replace(char, quote(char))
+    return string
+
+
+def get_func_name(func, resolv_alias=True, win_characters=True):
+    """ Return the function import path (as a list of module names), and
+        a name for the function.
+
+        Parameters
+        ----------
+        func: callable
+            The func to inspect
+        resolv_alias: boolean, optional
+            If true, possible local aliases are indicated.
+        win_characters: boolean, optional
+            If true, substitute special characters using urllib.quote
+            This is useful in Windows, as it cannot encode some filenames
+    """
+    if hasattr(func, '__module__'):
+        module = func.__module__
+    else:
+        try:
+            module = inspect.getmodule(func)
+        except TypeError:
+            if hasattr(func, '__class__'):
+                module = func.__class__.__module__
+            else:
+                module = 'unknown'
+    if module is None:
+        # Happens in doctests, eg
+        module = ''
+    if module == '__main__':
+        try:
+            filename = os.path.abspath(inspect.getsourcefile(func))
+        except:  # noqa: E722
+            filename = None
+        if filename is not None:
+            # mangling of full path to filename
+            parts = filename.split(os.sep)
+            if parts[-1].startswith('<ipython-input'):
+                # We're in a IPython (or notebook) session. parts[-1] comes
+                # from func.__code__.co_filename and is of the form
+                # <ipython-input-N-XYZ>, where:
+                # - N is the cell number where the function was defined
+                # - XYZ is a hash representing the function's code (and name).
+                #   It will be consistent across sessions and kernel restarts,
+                #   and will change if the function's code/name changes
+                # We remove N so that cache is properly hit if the cell where
+                # the func is defined is re-exectuted.
+                # The XYZ hash should avoid collisions between functions with
+                # the same name, both within the same notebook but also across
+                # notebooks
+                splitted = parts[-1].split('-')
+                parts[-1] = '-'.join(splitted[:2] + splitted[3:])
+            elif len(parts) > 2 and parts[-2].startswith('ipykernel_'):
+                # In a notebook session (ipykernel). Filename seems to be 'xyz'
+                # of above. parts[-2] has the structure ipykernel_XXXXXX where
+                # XXXXXX is a six-digit number identifying the current run (?).
+                # If we split it off, the function again has the same
+                # identifier across runs.
+                parts[-2] = 'ipykernel'
+            filename = '-'.join(parts)
+            if filename.endswith('.py'):
+                filename = filename[:-3]
+            module = module + '-' + filename
+    module = module.split('.')
+    if hasattr(func, 'func_name'):
+        name = func.func_name
+    elif hasattr(func, '__name__'):
+        name = func.__name__
+    else:
+        name = 'unknown'
+    # Hack to detect functions not defined at the module-level
+    if resolv_alias:
+        # TODO: Maybe add a warning here?
+        if hasattr(func, 'func_globals') and name in func.func_globals:
+            if not func.func_globals[name] is func:
+                name = '%s-alias' % name
+    if hasattr(func, '__qualname__') and func.__qualname__ != name:
+        # Extend the module name in case of nested functions to avoid
+        # (module, name) collisions
+        module.extend(func.__qualname__.split(".")[:-1])
+    if inspect.ismethod(func):
+        # We need to add the name of the class
+        if hasattr(func, 'im_class'):
+            klass = func.im_class
+            module.append(klass.__name__)
+    if os.name == 'nt' and win_characters:
+        # Windows can't encode certain characters in filenames
+        name = _clean_win_chars(name)
+        module = [_clean_win_chars(s) for s in module]
+    return module, name
+
+
+def _signature_str(function_name, arg_sig):
+    """Helper function to output a function signature"""
+    return '{}{}'.format(function_name, arg_sig)
+
+
+def _function_called_str(function_name, args, kwargs):
+    """Helper function to output a function call"""
+    template_str = '{0}({1}, {2})'
+
+    args_str = repr(args)[1:-1]
+    kwargs_str = ', '.join('%s=%s' % (k, v)
+                           for k, v in kwargs.items())
+    return template_str.format(function_name, args_str,
+                               kwargs_str)
+
+
+def filter_args(func, ignore_lst, args=(), kwargs=dict()):
+    """ Filters the given args and kwargs using a list of arguments to
+        ignore, and a function specification.
+
+        Parameters
+        ----------
+        func: callable
+            Function giving the argument specification
+        ignore_lst: list of strings
+            List of arguments to ignore (either a name of an argument
+            in the function spec, or '*', or '**')
+        *args: list
+            Positional arguments passed to the function.
+        **kwargs: dict
+            Keyword arguments passed to the function
+
+        Returns
+        -------
+        filtered_args: list
+            List of filtered positional and keyword arguments.
+    """
+    args = list(args)
+    if isinstance(ignore_lst, str):
+        # Catch a common mistake
+        raise ValueError(
+            'ignore_lst must be a list of parameters to ignore '
+            '%s (type %s) was given' % (ignore_lst, type(ignore_lst)))
+    # Special case for functools.partial objects
+    if (not inspect.ismethod(func) and not inspect.isfunction(func)):
+        if ignore_lst:
+            warnings.warn('Cannot inspect object %s, ignore list will '
+                          'not work.' % func, stacklevel=2)
+        return {'*': args, '**': kwargs}
+    arg_sig = inspect.signature(func)
+    arg_names = []
+    arg_defaults = []
+    arg_kwonlyargs = []
+    arg_varargs = None
+    arg_varkw = None
+    for param in arg_sig.parameters.values():
+        if param.kind is param.POSITIONAL_OR_KEYWORD:
+            arg_names.append(param.name)
+        elif param.kind is param.KEYWORD_ONLY:
+            arg_names.append(param.name)
+            arg_kwonlyargs.append(param.name)
+        elif param.kind is param.VAR_POSITIONAL:
+            arg_varargs = param.name
+        elif param.kind is param.VAR_KEYWORD:
+            arg_varkw = param.name
+        if param.default is not param.empty:
+            arg_defaults.append(param.default)
+    if inspect.ismethod(func):
+        # First argument is 'self', it has been removed by Python
+        # we need to add it back:
+        args = [func.__self__, ] + args
+        # func is an instance method, inspect.signature(func) does not
+        # include self, we need to fetch it from the class method, i.e
+        # func.__func__
+        class_method_sig = inspect.signature(func.__func__)
+        self_name = next(iter(class_method_sig.parameters))
+        arg_names = [self_name] + arg_names
+    # XXX: Maybe I need an inspect.isbuiltin to detect C-level methods, such
+    # as on ndarrays.
+
+    _, name = get_func_name(func, resolv_alias=False)
+    arg_dict = dict()
+    arg_position = -1
+    for arg_position, arg_name in enumerate(arg_names):
+        if arg_position < len(args):
+            # Positional argument or keyword argument given as positional
+            if arg_name not in arg_kwonlyargs:
+                arg_dict[arg_name] = args[arg_position]
+            else:
+                raise ValueError(
+                    "Keyword-only parameter '%s' was passed as "
+                    'positional parameter for %s:\n'
+                    '     %s was called.'
+                    % (arg_name,
+                       _signature_str(name, arg_sig),
+                       _function_called_str(name, args, kwargs))
+                )
+
+        else:
+            position = arg_position - len(arg_names)
+            if arg_name in kwargs:
+                arg_dict[arg_name] = kwargs[arg_name]
+            else:
+                try:
+                    arg_dict[arg_name] = arg_defaults[position]
+                except (IndexError, KeyError) as e:
+                    # Missing argument
+                    raise ValueError(
+                        'Wrong number of arguments for %s:\n'
+                        '     %s was called.'
+                        % (_signature_str(name, arg_sig),
+                           _function_called_str(name, args, kwargs))
+                    ) from e
+
+    varkwargs = dict()
+    for arg_name, arg_value in sorted(kwargs.items()):
+        if arg_name in arg_dict:
+            arg_dict[arg_name] = arg_value
+        elif arg_varkw is not None:
+            varkwargs[arg_name] = arg_value
+        else:
+            raise TypeError("Ignore list for %s() contains an unexpected "
+                            "keyword argument '%s'" % (name, arg_name))
+
+    if arg_varkw is not None:
+        arg_dict['**'] = varkwargs
+    if arg_varargs is not None:
+        varargs = args[arg_position + 1:]
+        arg_dict['*'] = varargs
+
+    # Now remove the arguments to be ignored
+    for item in ignore_lst:
+        if item in arg_dict:
+            arg_dict.pop(item)
+        else:
+            raise ValueError("Ignore list: argument '%s' is not defined for "
+                             "function %s"
+                             % (item,
+                                _signature_str(name, arg_sig))
+                             )
+    # XXX: Return a sorted list of pairs?
+    return arg_dict
+
+
+def _format_arg(arg):
+    formatted_arg = pformat(arg, indent=2)
+    if len(formatted_arg) > 1500:
+        formatted_arg = '%s...' % formatted_arg[:700]
+    return formatted_arg
+
+
+def format_signature(func, *args, **kwargs):
+    # XXX: Should this use inspect.formatargvalues/formatargspec?
+    module, name = get_func_name(func)
+    module = [m for m in module if m]
+    if module:
+        module.append(name)
+        module_path = '.'.join(module)
+    else:
+        module_path = name
+    arg_str = list()
+    previous_length = 0
+    for arg in args:
+        formatted_arg = _format_arg(arg)
+        if previous_length > 80:
+            formatted_arg = '\n%s' % formatted_arg
+        previous_length = len(formatted_arg)
+        arg_str.append(formatted_arg)
+    arg_str.extend(['%s=%s' % (v, _format_arg(i)) for v, i in kwargs.items()])
+    arg_str = ', '.join(arg_str)
+
+    signature = '%s(%s)' % (name, arg_str)
+    return module_path, signature
+
+
+def format_call(func, args, kwargs, object_name="Memory"):
+    """ Returns a nicely formatted statement displaying the function
+        call with the given arguments.
+    """
+    path, signature = format_signature(func, *args, **kwargs)
+    msg = '%s\n[%s] Calling %s...\n%s' % (80 * '_', object_name,
+                                          path, signature)
+    return msg
+    # XXX: Not using logging framework
+    # self.debug(msg)
diff --git a/llm/Lib/site-packages/joblib/hashing.py b/llm/Lib/site-packages/joblib/hashing.py
new file mode 100644
index 0000000000000000000000000000000000000000..6c081f06997ae3b6c18fc76b286ef95e008f23cc
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/hashing.py
@@ -0,0 +1,265 @@
+"""
+Fast cryptographic hash of Python objects, with a special case for fast
+hashing of numpy arrays.
+"""
+
+# Author: Gael Varoquaux <gael dot varoquaux at normalesup dot org>
+# Copyright (c) 2009 Gael Varoquaux
+# License: BSD Style, 3 clauses.
+
+import pickle
+import hashlib
+import sys
+import types
+import struct
+import io
+import decimal
+
+
+Pickler = pickle._Pickler
+
+
+class _ConsistentSet(object):
+    """ Class used to ensure the hash of Sets is preserved
+        whatever the order of its items.
+    """
+    def __init__(self, set_sequence):
+        # Forces order of elements in set to ensure consistent hash.
+        try:
+            # Trying first to order the set assuming the type of elements is
+            # consistent and orderable.
+            # This fails on python 3 when elements are unorderable
+            # but we keep it in a try as it's faster.
+            self._sequence = sorted(set_sequence)
+        except (TypeError, decimal.InvalidOperation):
+            # If elements are unorderable, sorting them using their hash.
+            # This is slower but works in any case.
+            self._sequence = sorted((hash(e) for e in set_sequence))
+
+
+class _MyHash(object):
+    """ Class used to hash objects that won't normally pickle """
+
+    def __init__(self, *args):
+        self.args = args
+
+
+class Hasher(Pickler):
+    """ A subclass of pickler, to do cryptographic hashing, rather than
+        pickling.
+    """
+
+    def __init__(self, hash_name='md5'):
+        self.stream = io.BytesIO()
+        # By default we want a pickle protocol that only changes with
+        # the major python version and not the minor one
+        protocol = 3
+        Pickler.__init__(self, self.stream, protocol=protocol)
+        # Initialise the hash obj
+        self._hash = hashlib.new(hash_name)
+
+    def hash(self, obj, return_digest=True):
+        try:
+            self.dump(obj)
+        except pickle.PicklingError as e:
+            e.args += ('PicklingError while hashing %r: %r' % (obj, e),)
+            raise
+        dumps = self.stream.getvalue()
+        self._hash.update(dumps)
+        if return_digest:
+            return self._hash.hexdigest()
+
+    def save(self, obj):
+        if isinstance(obj, (types.MethodType, type({}.pop))):
+            # the Pickler cannot pickle instance methods; here we decompose
+            # them into components that make them uniquely identifiable
+            if hasattr(obj, '__func__'):
+                func_name = obj.__func__.__name__
+            else:
+                func_name = obj.__name__
+            inst = obj.__self__
+            if type(inst) is type(pickle):
+                obj = _MyHash(func_name, inst.__name__)
+            elif inst is None:
+                # type(None) or type(module) do not pickle
+                obj = _MyHash(func_name, inst)
+            else:
+                cls = obj.__self__.__class__
+                obj = _MyHash(func_name, inst, cls)
+        Pickler.save(self, obj)
+
+    def memoize(self, obj):
+        # We want hashing to be sensitive to value instead of reference.
+        # For example we want ['aa', 'aa'] and ['aa', 'aaZ'[:2]]
+        # to hash to the same value and that's why we disable memoization
+        # for strings
+        if isinstance(obj, (bytes, str)):
+            return
+        Pickler.memoize(self, obj)
+
+    # The dispatch table of the pickler is not accessible in Python
+    # 3, as these lines are only bugware for IPython, we skip them.
+    def save_global(self, obj, name=None, pack=struct.pack):
+        # We have to override this method in order to deal with objects
+        # defined interactively in IPython that are not injected in
+        # __main__
+        kwargs = dict(name=name, pack=pack)
+        del kwargs['pack']
+        try:
+            Pickler.save_global(self, obj, **kwargs)
+        except pickle.PicklingError:
+            Pickler.save_global(self, obj, **kwargs)
+            module = getattr(obj, "__module__", None)
+            if module == '__main__':
+                my_name = name
+                if my_name is None:
+                    my_name = obj.__name__
+                mod = sys.modules[module]
+                if not hasattr(mod, my_name):
+                    # IPython doesn't inject the variables define
+                    # interactively in __main__
+                    setattr(mod, my_name, obj)
+
+    dispatch = Pickler.dispatch.copy()
+    # builtin
+    dispatch[type(len)] = save_global
+    # type
+    dispatch[type(object)] = save_global
+    # classobj
+    dispatch[type(Pickler)] = save_global
+    # function
+    dispatch[type(pickle.dump)] = save_global
+
+    def _batch_setitems(self, items):
+        # forces order of keys in dict to ensure consistent hash.
+        try:
+            # Trying first to compare dict assuming the type of keys is
+            # consistent and orderable.
+            # This fails on python 3 when keys are unorderable
+            # but we keep it in a try as it's faster.
+            Pickler._batch_setitems(self, iter(sorted(items)))
+        except TypeError:
+            # If keys are unorderable, sorting them using their hash. This is
+            # slower but works in any case.
+            Pickler._batch_setitems(self, iter(sorted((hash(k), v)
+                                                      for k, v in items)))
+
+    def save_set(self, set_items):
+        # forces order of items in Set to ensure consistent hash
+        Pickler.save(self, _ConsistentSet(set_items))
+
+    dispatch[type(set())] = save_set
+
+
+class NumpyHasher(Hasher):
+    """ Special case the hasher for when numpy is loaded.
+    """
+
+    def __init__(self, hash_name='md5', coerce_mmap=False):
+        """
+            Parameters
+            ----------
+            hash_name: string
+                The hash algorithm to be used
+            coerce_mmap: boolean
+                Make no difference between np.memmap and np.ndarray
+                objects.
+        """
+        self.coerce_mmap = coerce_mmap
+        Hasher.__init__(self, hash_name=hash_name)
+        # delayed import of numpy, to avoid tight coupling
+        import numpy as np
+        self.np = np
+        if hasattr(np, 'getbuffer'):
+            self._getbuffer = np.getbuffer
+        else:
+            self._getbuffer = memoryview
+
+    def save(self, obj):
+        """ Subclass the save method, to hash ndarray subclass, rather
+            than pickling them. Off course, this is a total abuse of
+            the Pickler class.
+        """
+        if isinstance(obj, self.np.ndarray) and not obj.dtype.hasobject:
+            # Compute a hash of the object
+            # The update function of the hash requires a c_contiguous buffer.
+            if obj.shape == ():
+                # 0d arrays need to be flattened because viewing them as bytes
+                # raises a ValueError exception.
+                obj_c_contiguous = obj.flatten()
+            elif obj.flags.c_contiguous:
+                obj_c_contiguous = obj
+            elif obj.flags.f_contiguous:
+                obj_c_contiguous = obj.T
+            else:
+                # Cater for non-single-segment arrays: this creates a
+                # copy, and thus alleviates this issue.
+                # XXX: There might be a more efficient way of doing this
+                obj_c_contiguous = obj.flatten()
+
+            # memoryview is not supported for some dtypes, e.g. datetime64, see
+            # https://github.com/numpy/numpy/issues/4983. The
+            # workaround is to view the array as bytes before
+            # taking the memoryview.
+            self._hash.update(
+                self._getbuffer(obj_c_contiguous.view(self.np.uint8)))
+
+            # We store the class, to be able to distinguish between
+            # Objects with the same binary content, but different
+            # classes.
+            if self.coerce_mmap and isinstance(obj, self.np.memmap):
+                # We don't make the difference between memmap and
+                # normal ndarrays, to be able to reload previously
+                # computed results with memmap.
+                klass = self.np.ndarray
+            else:
+                klass = obj.__class__
+            # We also return the dtype and the shape, to distinguish
+            # different views on the same data with different dtypes.
+
+            # The object will be pickled by the pickler hashed at the end.
+            obj = (klass, ('HASHED', obj.dtype, obj.shape, obj.strides))
+        elif isinstance(obj, self.np.dtype):
+            # numpy.dtype consistent hashing is tricky to get right. This comes
+            # from the fact that atomic np.dtype objects are interned:
+            # ``np.dtype('f4') is np.dtype('f4')``. The situation is
+            # complicated by the fact that this interning does not resist a
+            # simple pickle.load/dump roundtrip:
+            # ``pickle.loads(pickle.dumps(np.dtype('f4'))) is not
+            # np.dtype('f4') Because pickle relies on memoization during
+            # pickling, it is easy to
+            # produce different hashes for seemingly identical objects, such as
+            # ``[np.dtype('f4'), np.dtype('f4')]``
+            # and ``[np.dtype('f4'), pickle.loads(pickle.dumps('f4'))]``.
+            # To prevent memoization from interfering with hashing, we isolate
+            # the serialization (and thus the pickle memoization) of each dtype
+            # using each time a different ``pickle.dumps`` call unrelated to
+            # the current Hasher instance.
+            self._hash.update("_HASHED_DTYPE".encode('utf-8'))
+            self._hash.update(pickle.dumps(obj))
+            return
+        Hasher.save(self, obj)
+
+
+def hash(obj, hash_name='md5', coerce_mmap=False):
+    """ Quick calculation of a hash to identify uniquely Python objects
+        containing numpy arrays.
+
+        Parameters
+        ----------
+        hash_name: 'md5' or 'sha1'
+            Hashing algorithm used. sha1 is supposedly safer, but md5 is
+            faster.
+        coerce_mmap: boolean
+            Make no difference between np.memmap and np.ndarray
+    """
+    valid_hash_names = ('md5', 'sha1')
+    if hash_name not in valid_hash_names:
+        raise ValueError("Valid options for 'hash_name' are {}. "
+                         "Got hash_name={!r} instead."
+                         .format(valid_hash_names, hash_name))
+    if 'numpy' in sys.modules:
+        hasher = NumpyHasher(hash_name=hash_name, coerce_mmap=coerce_mmap)
+    else:
+        hasher = Hasher(hash_name=hash_name)
+    return hasher.hash(obj)
diff --git a/llm/Lib/site-packages/joblib/logger.py b/llm/Lib/site-packages/joblib/logger.py
new file mode 100644
index 0000000000000000000000000000000000000000..cf9d258011f3c581334a93ef3ccdac7dfb19b25e
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/logger.py
@@ -0,0 +1,162 @@
+"""
+Helpers for logging.
+
+This module needs much love to become useful.
+"""
+
+# Author: Gael Varoquaux <gael dot varoquaux at normalesup dot org>
+# Copyright (c) 2008 Gael Varoquaux
+# License: BSD Style, 3 clauses.
+
+from __future__ import print_function
+
+import time
+import sys
+import os
+import shutil
+import logging
+import pprint
+
+from .disk import mkdirp
+
+
+def _squeeze_time(t):
+    """Remove .1s to the time under Windows: this is the time it take to
+    stat files. This is needed to make results similar to timings under
+    Unix, for tests
+    """
+    if sys.platform.startswith('win'):
+        return max(0, t - .1)
+    else:
+        return t
+
+
+def format_time(t):
+    t = _squeeze_time(t)
+    return "%.1fs, %.1fmin" % (t, t / 60.)
+
+
+def short_format_time(t):
+    t = _squeeze_time(t)
+    if t > 60:
+        return "%4.1fmin" % (t / 60.)
+    else:
+        return " %5.1fs" % (t)
+
+
+def pformat(obj, indent=0, depth=3):
+    if 'numpy' in sys.modules:
+        import numpy as np
+        print_options = np.get_printoptions()
+        np.set_printoptions(precision=6, threshold=64, edgeitems=1)
+    else:
+        print_options = None
+    out = pprint.pformat(obj, depth=depth, indent=indent)
+    if print_options:
+        np.set_printoptions(**print_options)
+    return out
+
+
+###############################################################################
+# class `Logger`
+###############################################################################
+class Logger(object):
+    """ Base class for logging messages.
+    """
+
+    def __init__(self, depth=3, name=None):
+        """
+            Parameters
+            ----------
+            depth: int, optional
+                The depth of objects printed.
+            name: str, optional
+                The namespace to log to. If None, defaults to joblib.
+        """
+        self.depth = depth
+        self._name = name if name else 'joblib'
+
+    def warn(self, msg):
+        logging.getLogger(self._name).warning("[%s]: %s" % (self, msg))
+
+    def info(self, msg):
+        logging.info("[%s]: %s" % (self, msg))
+
+    def debug(self, msg):
+        # XXX: This conflicts with the debug flag used in children class
+        logging.getLogger(self._name).debug("[%s]: %s" % (self, msg))
+
+    def format(self, obj, indent=0):
+        """Return the formatted representation of the object."""
+        return pformat(obj, indent=indent, depth=self.depth)
+
+
+###############################################################################
+# class `PrintTime`
+###############################################################################
+class PrintTime(object):
+    """ Print and log messages while keeping track of time.
+    """
+
+    def __init__(self, logfile=None, logdir=None):
+        if logfile is not None and logdir is not None:
+            raise ValueError('Cannot specify both logfile and logdir')
+        # XXX: Need argument docstring
+        self.last_time = time.time()
+        self.start_time = self.last_time
+        if logdir is not None:
+            logfile = os.path.join(logdir, 'joblib.log')
+        self.logfile = logfile
+        if logfile is not None:
+            mkdirp(os.path.dirname(logfile))
+            if os.path.exists(logfile):
+                # Rotate the logs
+                for i in range(1, 9):
+                    try:
+                        shutil.move(logfile + '.%i' % i,
+                                    logfile + '.%i' % (i + 1))
+                    except:  # noqa: E722
+                        "No reason failing here"
+                # Use a copy rather than a move, so that a process
+                # monitoring this file does not get lost.
+                try:
+                    shutil.copy(logfile, logfile + '.1')
+                except:  # noqa: E722
+                    "No reason failing here"
+            try:
+                with open(logfile, 'w') as logfile:
+                    logfile.write('\nLogging joblib python script\n')
+                    logfile.write('\n---%s---\n' % time.ctime(self.last_time))
+            except:  # noqa: E722
+                """ Multiprocessing writing to files can create race
+                    conditions. Rather fail silently than crash the
+                    computation.
+                """
+                # XXX: We actually need a debug flag to disable this
+                # silent failure.
+
+    def __call__(self, msg='', total=False):
+        """ Print the time elapsed between the last call and the current
+            call, with an optional message.
+        """
+        if not total:
+            time_lapse = time.time() - self.last_time
+            full_msg = "%s: %s" % (msg, format_time(time_lapse))
+        else:
+            # FIXME: Too much logic duplicated
+            time_lapse = time.time() - self.start_time
+            full_msg = "%s: %.2fs, %.1f min" % (msg, time_lapse,
+                                                time_lapse / 60)
+        print(full_msg, file=sys.stderr)
+        if self.logfile is not None:
+            try:
+                with open(self.logfile, 'a') as f:
+                    print(full_msg, file=f)
+            except:  # noqa: E722
+                """ Multiprocessing writing to files can create race
+                    conditions. Rather fail silently than crash the
+                    calculation.
+                """
+                # XXX: We actually need a debug flag to disable this
+                # silent failure.
+        self.last_time = time.time()
diff --git a/llm/Lib/site-packages/joblib/memory.py b/llm/Lib/site-packages/joblib/memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..6f87f803947a4060f0e64fe1bec1a3d0bc35672b
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/memory.py
@@ -0,0 +1,1160 @@
+"""
+A context object for caching a function's return value each time it
+is called with the same input arguments.
+
+"""
+
+# Author: Gael Varoquaux <gael dot varoquaux at normalesup dot org>
+# Copyright (c) 2009 Gael Varoquaux
+# License: BSD Style, 3 clauses.
+
+
+import asyncio
+import datetime
+import functools
+import inspect
+import logging
+import os
+import pathlib
+import pydoc
+import re
+import textwrap
+import time
+import tokenize
+import traceback
+import warnings
+import weakref
+
+from . import hashing
+from ._store_backends import CacheWarning  # noqa
+from ._store_backends import FileSystemStoreBackend, StoreBackendBase
+from .func_inspect import (filter_args, format_call, format_signature,
+                           get_func_code, get_func_name)
+from .logger import Logger, format_time, pformat
+
+FIRST_LINE_TEXT = "# first line:"
+
+# TODO: The following object should have a data store object as a sub
+# object, and the interface to persist and query should be separated in
+# the data store.
+#
+# This would enable creating 'Memory' objects with a different logic for
+# pickling that would simply span a MemorizedFunc with the same
+# store (or do we want to copy it to avoid cross-talks?), for instance to
+# implement HDF5 pickling.
+
+# TODO: Same remark for the logger, and probably use the Python logging
+# mechanism.
+
+
+def extract_first_line(func_code):
+    """ Extract the first line information from the function code
+        text if available.
+    """
+    if func_code.startswith(FIRST_LINE_TEXT):
+        func_code = func_code.split('\n')
+        first_line = int(func_code[0][len(FIRST_LINE_TEXT):])
+        func_code = '\n'.join(func_code[1:])
+    else:
+        first_line = -1
+    return func_code, first_line
+
+
+class JobLibCollisionWarning(UserWarning):
+    """ Warn that there might be a collision between names of functions.
+    """
+
+
+_STORE_BACKENDS = {'local': FileSystemStoreBackend}
+
+
+def register_store_backend(backend_name, backend):
+    """Extend available store backends.
+
+    The Memory, MemorizeResult and MemorizeFunc objects are designed to be
+    agnostic to the type of store used behind. By default, the local file
+    system is used but this function gives the possibility to extend joblib's
+    memory pattern with other types of storage such as cloud storage (S3, GCS,
+    OpenStack, HadoopFS, etc) or blob DBs.
+
+    Parameters
+    ----------
+    backend_name: str
+        The name identifying the store backend being registered. For example,
+        'local' is used with FileSystemStoreBackend.
+    backend: StoreBackendBase subclass
+        The name of a class that implements the StoreBackendBase interface.
+
+    """
+    if not isinstance(backend_name, str):
+        raise ValueError("Store backend name should be a string, "
+                         "'{0}' given.".format(backend_name))
+    if backend is None or not issubclass(backend, StoreBackendBase):
+        raise ValueError("Store backend should inherit "
+                         "StoreBackendBase, "
+                         "'{0}' given.".format(backend))
+
+    _STORE_BACKENDS[backend_name] = backend
+
+
+def _store_backend_factory(backend, location, verbose=0, backend_options=None):
+    """Return the correct store object for the given location."""
+    if backend_options is None:
+        backend_options = {}
+
+    if isinstance(location, pathlib.Path):
+        location = str(location)
+
+    if isinstance(location, StoreBackendBase):
+        return location
+    elif isinstance(location, str):
+        obj = None
+        location = os.path.expanduser(location)
+        # The location is not a local file system, we look in the
+        # registered backends if there's one matching the given backend
+        # name.
+        for backend_key, backend_obj in _STORE_BACKENDS.items():
+            if backend == backend_key:
+                obj = backend_obj()
+
+        # By default, we assume the FileSystemStoreBackend can be used if no
+        # matching backend could be found.
+        if obj is None:
+            raise TypeError('Unknown location {0} or backend {1}'.format(
+                            location, backend))
+
+        # The store backend is configured with the extra named parameters,
+        # some of them are specific to the underlying store backend.
+        obj.configure(location, verbose=verbose,
+                      backend_options=backend_options)
+        return obj
+    elif location is not None:
+        warnings.warn(
+            "Instantiating a backend using a {} as a location is not "
+            "supported by joblib. Returning None instead.".format(
+                location.__class__.__name__), UserWarning)
+
+    return None
+
+
+def _build_func_identifier(func):
+    """Build a roughly unique identifier for the cached function."""
+    modules, funcname = get_func_name(func)
+    # We reuse historical fs-like way of building a function identifier
+    return os.path.join(*modules, funcname)
+
+
+# An in-memory store to avoid looking at the disk-based function
+# source code to check if a function definition has changed
+_FUNCTION_HASHES = weakref.WeakKeyDictionary()
+
+
+###############################################################################
+# class `MemorizedResult`
+###############################################################################
+class MemorizedResult(Logger):
+    """Object representing a cached value.
+
+    Attributes
+    ----------
+    location: str
+        The location of joblib cache. Depends on the store backend used.
+
+    func: function or str
+        function whose output is cached. The string case is intended only for
+        instantiation based on the output of repr() on another instance.
+        (namely eval(repr(memorized_instance)) works).
+
+    argument_hash: str
+        hash of the function arguments.
+
+    backend: str
+        Type of store backend for reading/writing cache files.
+        Default is 'local'.
+
+    mmap_mode: {None, 'r+', 'r', 'w+', 'c'}
+        The memmapping mode used when loading from cache numpy arrays. See
+        numpy.load for the meaning of the different values.
+
+    verbose: int
+        verbosity level (0 means no message).
+
+    timestamp, metadata: string
+        for internal use only.
+    """
+    def __init__(self, location, call_id, backend='local', mmap_mode=None,
+                 verbose=0, timestamp=None, metadata=None):
+        Logger.__init__(self)
+        self._call_id = call_id
+        self.store_backend = _store_backend_factory(backend, location,
+                                                    verbose=verbose)
+        self.mmap_mode = mmap_mode
+
+        if metadata is not None:
+            self.metadata = metadata
+        else:
+            self.metadata = self.store_backend.get_metadata(self._call_id)
+
+        self.duration = self.metadata.get('duration', None)
+        self.verbose = verbose
+        self.timestamp = timestamp
+
+    @property
+    def func(self):
+        return self.func_id
+
+    @property
+    def func_id(self):
+        return self._call_id[0]
+
+    @property
+    def args_id(self):
+        return self._call_id[1]
+
+    @property
+    def argument_hash(self):
+        warnings.warn(
+            "The 'argument_hash' attribute has been deprecated in version "
+            "0.12 and will be removed in version 0.14.\n"
+            "Use `args_id` attribute instead.",
+            DeprecationWarning, stacklevel=2)
+        return self.args_id
+
+    def get(self):
+        """Read value from cache and return it."""
+        try:
+            return self.store_backend.load_item(
+                self._call_id,
+                timestamp=self.timestamp,
+                metadata=self.metadata,
+                verbose=self.verbose
+            )
+        except ValueError as exc:
+            new_exc = KeyError(
+                "Error while trying to load a MemorizedResult's value. "
+                "It seems that this folder is corrupted : {}".format(
+                    os.path.join(self.store_backend.location, *self._call_id)))
+            raise new_exc from exc
+
+    def clear(self):
+        """Clear value from cache"""
+        self.store_backend.clear_item(self._call_id)
+
+    def __repr__(self):
+        return '{}(location="{}", func="{}", args_id="{}")'.format(
+            self.__class__.__name__, self.store_backend.location,
+            *self._call_id
+        )
+
+    def __getstate__(self):
+        state = self.__dict__.copy()
+        state['timestamp'] = None
+        return state
+
+
+class NotMemorizedResult(object):
+    """Class representing an arbitrary value.
+
+    This class is a replacement for MemorizedResult when there is no cache.
+    """
+    __slots__ = ('value', 'valid')
+
+    def __init__(self, value):
+        self.value = value
+        self.valid = True
+
+    def get(self):
+        if self.valid:
+            return self.value
+        else:
+            raise KeyError("No value stored.")
+
+    def clear(self):
+        self.valid = False
+        self.value = None
+
+    def __repr__(self):
+        if self.valid:
+            return ('{class_name}({value})'
+                    .format(class_name=self.__class__.__name__,
+                            value=pformat(self.value)))
+        else:
+            return self.__class__.__name__ + ' with no value'
+
+    # __getstate__ and __setstate__ are required because of __slots__
+    def __getstate__(self):
+        return {"valid": self.valid, "value": self.value}
+
+    def __setstate__(self, state):
+        self.valid = state["valid"]
+        self.value = state["value"]
+
+
+###############################################################################
+# class `NotMemorizedFunc`
+###############################################################################
+class NotMemorizedFunc(object):
+    """No-op object decorating a function.
+
+    This class replaces MemorizedFunc when there is no cache. It provides an
+    identical API but does not write anything on disk.
+
+    Attributes
+    ----------
+    func: callable
+        Original undecorated function.
+    """
+    # Should be a light as possible (for speed)
+    def __init__(self, func):
+        self.func = func
+
+    def __call__(self, *args, **kwargs):
+        return self.func(*args, **kwargs)
+
+    def call_and_shelve(self, *args, **kwargs):
+        return NotMemorizedResult(self.func(*args, **kwargs))
+
+    def __repr__(self):
+        return '{0}(func={1})'.format(self.__class__.__name__, self.func)
+
+    def clear(self, warn=True):
+        # Argument "warn" is for compatibility with MemorizedFunc.clear
+        pass
+
+    def call(self, *args, **kwargs):
+        return self.func(*args, **kwargs)
+
+    def check_call_in_cache(self, *args, **kwargs):
+        return False
+
+
+###############################################################################
+# class `AsyncNotMemorizedFunc`
+###############################################################################
+class AsyncNotMemorizedFunc(NotMemorizedFunc):
+    async def call_and_shelve(self, *args, **kwargs):
+        return NotMemorizedResult(await self.func(*args, **kwargs))
+
+
+###############################################################################
+# class `MemorizedFunc`
+###############################################################################
+class MemorizedFunc(Logger):
+    """Callable object decorating a function for caching its return value
+    each time it is called.
+
+    Methods are provided to inspect the cache or clean it.
+
+    Attributes
+    ----------
+    func: callable
+        The original, undecorated, function.
+
+    location: string
+        The location of joblib cache. Depends on the store backend used.
+
+    backend: str
+        Type of store backend for reading/writing cache files.
+        Default is 'local', in which case the location is the path to a
+        disk storage.
+
+    ignore: list or None
+        List of variable names to ignore when choosing whether to
+        recompute.
+
+    mmap_mode: {None, 'r+', 'r', 'w+', 'c'}
+        The memmapping mode used when loading from cache
+        numpy arrays. See numpy.load for the meaning of the different
+        values.
+
+    compress: boolean, or integer
+        Whether to zip the stored data on disk. If an integer is
+        given, it should be between 1 and 9, and sets the amount
+        of compression. Note that compressed arrays cannot be
+        read by memmapping.
+
+    verbose: int, optional
+        The verbosity flag, controls messages that are issued as
+        the function is evaluated.
+
+    cache_validation_callback: callable, optional
+        Callable to check if a result in cache is valid or is to be recomputed.
+        When the function is called with arguments for which a cache exists,
+        the callback is called with the cache entry's metadata as its sole
+        argument. If it returns True, the cached result is returned, else the
+        cache for these arguments is cleared and the result is recomputed.
+    """
+    # ------------------------------------------------------------------------
+    # Public interface
+    # ------------------------------------------------------------------------
+
+    def __init__(self, func, location, backend='local', ignore=None,
+                 mmap_mode=None, compress=False, verbose=1, timestamp=None,
+                 cache_validation_callback=None):
+        Logger.__init__(self)
+        self.mmap_mode = mmap_mode
+        self.compress = compress
+        self.func = func
+        self.cache_validation_callback = cache_validation_callback
+        self.func_id = _build_func_identifier(func)
+        self.ignore = ignore if ignore is not None else []
+        self._verbose = verbose
+
+        # retrieve store object from backend type and location.
+        self.store_backend = _store_backend_factory(backend, location,
+                                                    verbose=verbose,
+                                                    backend_options=dict(
+                                                        compress=compress,
+                                                        mmap_mode=mmap_mode),
+                                                    )
+        if self.store_backend is not None:
+            # Create func directory on demand.
+            self.store_backend.store_cached_func_code([self.func_id])
+
+        self.timestamp = timestamp if timestamp is not None else time.time()
+        try:
+            functools.update_wrapper(self, func)
+        except Exception:
+            pass  # Objects like ufunc don't like that
+        if inspect.isfunction(func):
+            doc = pydoc.TextDoc().document(func)
+            # Remove blank line
+            doc = doc.replace('\n', '\n\n', 1)
+            # Strip backspace-overprints for compatibility with autodoc
+            doc = re.sub('\x08.', '', doc)
+        else:
+            # Pydoc does a poor job on other objects
+            doc = func.__doc__
+        self.__doc__ = 'Memoized version of %s' % doc
+
+        self._func_code_info = None
+        self._func_code_id = None
+
+    def _is_in_cache_and_valid(self, call_id):
+        """Check if the function call is cached and valid for given arguments.
+
+        - Compare the function code with the one from the cached function,
+        asserting if it has changed.
+        - Check if the function call is present in the cache.
+        - Call `cache_validation_callback` for user define cache validation.
+
+        Returns True if the function call is in cache and can be used, and
+        returns False otherwise.
+        """
+        # Check if the code of the function has changed
+        if not self._check_previous_func_code(stacklevel=4):
+            return False
+
+        # Check if this specific call is in the cache
+        if not self.store_backend.contains_item(call_id):
+            return False
+
+        # Call the user defined cache validation callback
+        metadata = self.store_backend.get_metadata(call_id)
+        if (self.cache_validation_callback is not None and
+                not self.cache_validation_callback(metadata)):
+            self.store_backend.clear_item(call_id)
+            return False
+
+        return True
+
+    def _cached_call(self, args, kwargs, shelving):
+        """Call wrapped function and cache result, or read cache if available.
+
+        This function returns the wrapped function output or a reference to
+        the cached result.
+
+        Arguments:
+        ----------
+
+        args, kwargs: list and dict
+            input arguments for wrapped function
+
+        shelving: bool
+            True when called via the call_and_shelve function.
+
+
+        Returns
+        -------
+        Output of the wrapped function if shelving is false, or a
+        MemorizedResult reference to the value if shelving is true.
+        """
+        args_id = self._get_args_id(*args, **kwargs)
+        call_id = (self.func_id, args_id)
+        _, func_name = get_func_name(self.func)
+        func_info = self.store_backend.get_cached_func_info([self.func_id])
+        location = func_info['location']
+
+        if self._verbose >= 20:
+            logging.basicConfig(level=logging.INFO)
+            _, signature = format_signature(self.func, *args, **kwargs)
+            self.info(
+                textwrap.dedent(
+                    f"""
+                        Querying {func_name} with signature
+                        {signature}.
+
+                        (argument hash {args_id})
+
+                        The store location is {location}.
+                        """
+                )
+            )
+
+        # Compare the function code with the previous to see if the
+        # function code has changed and check if the results are present in
+        # the cache.
+        if self._is_in_cache_and_valid(call_id):
+            if shelving:
+                return self._get_memorized_result(call_id)
+
+            try:
+                start_time = time.time()
+                output = self._load_item(call_id)
+                if self._verbose > 4:
+                    self._print_duration(time.time() - start_time,
+                                         context='cache loaded ')
+                return output
+            except Exception:
+                # XXX: Should use an exception logger
+                _, signature = format_signature(self.func, *args, **kwargs)
+                self.warn('Exception while loading results for '
+                          '{}\n {}'.format(signature, traceback.format_exc()))
+
+        if self._verbose > 10:
+            self.warn(
+                f"Computing func {func_name}, argument hash {args_id} "
+                f"in location {location}"
+            )
+
+        return self._call(call_id, args, kwargs, shelving)
+
+    @property
+    def func_code_info(self):
+        # 3-tuple property containing: the function source code, source file,
+        # and first line of the code inside the source file
+        if hasattr(self.func, '__code__'):
+            if self._func_code_id is None:
+                self._func_code_id = id(self.func.__code__)
+            elif id(self.func.__code__) != self._func_code_id:
+                # Be robust to dynamic reassignments of self.func.__code__
+                self._func_code_info = None
+
+        if self._func_code_info is None:
+            # Cache the source code of self.func . Provided that get_func_code
+            # (which should be called once on self) gets called in the process
+            # in which self.func was defined, this caching mechanism prevents
+            # undesired cache clearing when the cached function is called in
+            # an environment where the introspection utilities get_func_code
+            # relies on do not work (typically, in joblib child processes).
+            # See #1035 for  more info
+            # TODO (pierreglaser): do the same with get_func_name?
+            self._func_code_info = get_func_code(self.func)
+        return self._func_code_info
+
+    def call_and_shelve(self, *args, **kwargs):
+        """Call wrapped function, cache result and return a reference.
+
+        This method returns a reference to the cached result instead of the
+        result itself. The reference object is small and pickeable, allowing
+        to send or store it easily. Call .get() on reference object to get
+        result.
+
+        Returns
+        -------
+        cached_result: MemorizedResult or NotMemorizedResult
+            reference to the value returned by the wrapped function. The
+            class "NotMemorizedResult" is used when there is no cache
+            activated (e.g. location=None in Memory).
+        """
+        return self._cached_call(args, kwargs, shelving=True)
+
+    def __call__(self, *args, **kwargs):
+        return self._cached_call(args, kwargs, shelving=False)
+
+    def __getstate__(self):
+        # Make sure self.func's source is introspected prior to being pickled -
+        # code introspection utilities typically do not work inside child
+        # processes
+        _ = self.func_code_info
+
+        # We don't store the timestamp when pickling, to avoid the hash
+        # depending from it.
+        state = self.__dict__.copy()
+        state['timestamp'] = None
+
+        # Invalidate the code id as id(obj) will be different in the child
+        state['_func_code_id'] = None
+
+        return state
+
+    def check_call_in_cache(self, *args, **kwargs):
+        """Check if function call is in the memory cache.
+
+        Does not call the function or do any work besides func inspection
+        and arg hashing.
+
+        Returns
+        -------
+        is_call_in_cache: bool
+            Whether or not the result of the function has been cached
+            for the input arguments that have been passed.
+        """
+        call_id = (self.func_id, self._get_args_id(*args, **kwargs))
+        return self.store_backend.contains_item(call_id)
+
+    # ------------------------------------------------------------------------
+    # Private interface
+    # ------------------------------------------------------------------------
+
+    def _get_args_id(self, *args, **kwargs):
+        """Return the input parameter hash of a result."""
+        return hashing.hash(filter_args(self.func, self.ignore, args, kwargs),
+                            coerce_mmap=self.mmap_mode is not None)
+
+    def _hash_func(self):
+        """Hash a function to key the online cache"""
+        func_code_h = hash(getattr(self.func, '__code__', None))
+        return id(self.func), hash(self.func), func_code_h
+
+    def _write_func_code(self, func_code, first_line):
+        """ Write the function code and the filename to a file.
+        """
+        # We store the first line because the filename and the function
+        # name is not always enough to identify a function: people
+        # sometimes have several functions named the same way in a
+        # file. This is bad practice, but joblib should be robust to bad
+        # practice.
+        func_code = u'%s %i\n%s' % (FIRST_LINE_TEXT, first_line, func_code)
+        self.store_backend.store_cached_func_code([self.func_id], func_code)
+
+        # Also store in the in-memory store of function hashes
+        is_named_callable = (hasattr(self.func, '__name__') and
+                             self.func.__name__ != '<lambda>')
+        if is_named_callable:
+            # Don't do this for lambda functions or strange callable
+            # objects, as it ends up being too fragile
+            func_hash = self._hash_func()
+            try:
+                _FUNCTION_HASHES[self.func] = func_hash
+            except TypeError:
+                # Some callable are not hashable
+                pass
+
+    def _check_previous_func_code(self, stacklevel=2):
+        """
+            stacklevel is the depth a which this function is called, to
+            issue useful warnings to the user.
+        """
+        # First check if our function is in the in-memory store.
+        # Using the in-memory store not only makes things faster, but it
+        # also renders us robust to variations of the files when the
+        # in-memory version of the code does not vary
+        try:
+            if self.func in _FUNCTION_HASHES:
+                # We use as an identifier the id of the function and its
+                # hash. This is more likely to falsely change than have hash
+                # collisions, thus we are on the safe side.
+                func_hash = self._hash_func()
+                if func_hash == _FUNCTION_HASHES[self.func]:
+                    return True
+        except TypeError:
+            # Some callables are not hashable
+            pass
+
+        # Here, we go through some effort to be robust to dynamically
+        # changing code and collision. We cannot inspect.getsource
+        # because it is not reliable when using IPython's magic "%run".
+        func_code, source_file, first_line = self.func_code_info
+        try:
+            old_func_code, old_first_line = extract_first_line(
+                self.store_backend.get_cached_func_code([self.func_id]))
+        except (IOError, OSError):  # some backend can also raise OSError
+            self._write_func_code(func_code, first_line)
+            return False
+        if old_func_code == func_code:
+            return True
+
+        # We have differing code, is this because we are referring to
+        # different functions, or because the function we are referring to has
+        # changed?
+
+        _, func_name = get_func_name(self.func, resolv_alias=False,
+                                     win_characters=False)
+        if old_first_line == first_line == -1 or func_name == '<lambda>':
+            if not first_line == -1:
+                func_description = ("{0} ({1}:{2})"
+                                    .format(func_name, source_file,
+                                            first_line))
+            else:
+                func_description = func_name
+            warnings.warn(JobLibCollisionWarning(
+                "Cannot detect name collisions for function '{0}'"
+                .format(func_description)), stacklevel=stacklevel)
+
+        # Fetch the code at the old location and compare it. If it is the
+        # same than the code store, we have a collision: the code in the
+        # file has not changed, but the name we have is pointing to a new
+        # code block.
+        if not old_first_line == first_line and source_file is not None:
+            if os.path.exists(source_file):
+                _, func_name = get_func_name(self.func, resolv_alias=False)
+                num_lines = len(func_code.split('\n'))
+                with tokenize.open(source_file) as f:
+                    on_disk_func_code = f.readlines()[
+                        old_first_line - 1:old_first_line - 1 + num_lines - 1]
+                on_disk_func_code = ''.join(on_disk_func_code)
+                possible_collision = (on_disk_func_code.rstrip() ==
+                                      old_func_code.rstrip())
+            else:
+                possible_collision = source_file.startswith('<doctest ')
+            if possible_collision:
+                warnings.warn(JobLibCollisionWarning(
+                    'Possible name collisions between functions '
+                    "'%s' (%s:%i) and '%s' (%s:%i)" %
+                    (func_name, source_file, old_first_line,
+                     func_name, source_file, first_line)),
+                    stacklevel=stacklevel)
+
+        # The function has changed, wipe the cache directory.
+        # XXX: Should be using warnings, and giving stacklevel
+        if self._verbose > 10:
+            _, func_name = get_func_name(self.func, resolv_alias=False)
+            self.warn("Function {0} (identified by {1}) has changed"
+                      ".".format(func_name, self.func_id))
+        self.clear(warn=True)
+        return False
+
+    def clear(self, warn=True):
+        """Empty the function's cache."""
+        func_id = self.func_id
+        if self._verbose > 0 and warn:
+            self.warn("Clearing function cache identified by %s" % func_id)
+        self.store_backend.clear_path([func_id, ])
+
+        func_code, _, first_line = self.func_code_info
+        self._write_func_code(func_code, first_line)
+
+    def call(self, *args, **kwargs):
+        """Force the execution of the function with the given arguments.
+
+        The output values will be persisted, i.e., the cache will be updated
+        with any new values.
+
+        Parameters
+        ----------
+        *args: arguments
+            The arguments.
+        **kwargs: keyword arguments
+            Keyword arguments.
+
+        Returns
+        -------
+        output : object
+            The output of the function call.
+        """
+        call_id = (self.func_id, self._get_args_id(*args, **kwargs))
+        return self._call(call_id, args, kwargs)
+
+    def _call(self, call_id, args, kwargs, shelving=False):
+        self._before_call(args, kwargs)
+        start_time = time.time()
+        output = self.func(*args, **kwargs)
+        return self._after_call(call_id, args, kwargs, shelving,
+                                output, start_time)
+
+    def _before_call(self, args, kwargs):
+        if self._verbose > 0:
+            print(format_call(self.func, args, kwargs))
+
+    def _after_call(self, call_id, args, kwargs, shelving, output, start_time):
+        self.store_backend.dump_item(call_id, output, verbose=self._verbose)
+        duration = time.time() - start_time
+        if self._verbose > 0:
+            self._print_duration(duration)
+        metadata = self._persist_input(duration, call_id, args, kwargs)
+        if shelving:
+            return self._get_memorized_result(call_id, metadata)
+
+        if self.mmap_mode is not None:
+            # Memmap the output at the first call to be consistent with
+            # later calls
+            output = self._load_item(call_id, metadata)
+        return output
+
+    def _persist_input(self, duration, call_id, args, kwargs,
+                       this_duration_limit=0.5):
+        """ Save a small summary of the call using json format in the
+            output directory.
+
+            output_dir: string
+                directory where to write metadata.
+
+            duration: float
+                time taken by hashing input arguments, calling the wrapped
+                function and persisting its output.
+
+            args, kwargs: list and dict
+                input arguments for wrapped function
+
+            this_duration_limit: float
+                Max execution time for this function before issuing a warning.
+        """
+        start_time = time.time()
+        argument_dict = filter_args(self.func, self.ignore,
+                                    args, kwargs)
+
+        input_repr = dict((k, repr(v)) for k, v in argument_dict.items())
+        # This can fail due to race-conditions with multiple
+        # concurrent joblibs removing the file or the directory
+        metadata = {
+            "duration": duration, "input_args": input_repr, "time": start_time,
+        }
+
+        self.store_backend.store_metadata(call_id, metadata)
+
+        this_duration = time.time() - start_time
+        if this_duration > this_duration_limit:
+            # This persistence should be fast. It will not be if repr() takes
+            # time and its output is large, because json.dump will have to
+            # write a large file. This should not be an issue with numpy arrays
+            # for which repr() always output a short representation, but can
+            # be with complex dictionaries. Fixing the problem should be a
+            # matter of replacing repr() above by something smarter.
+            warnings.warn("Persisting input arguments took %.2fs to run."
+                          "If this happens often in your code, it can cause "
+                          "performance problems "
+                          "(results will be correct in all cases). "
+                          "The reason for this is probably some large input "
+                          "arguments for a wrapped function."
+                          % this_duration, stacklevel=5)
+        return metadata
+
+    def _get_memorized_result(self, call_id, metadata=None):
+        return MemorizedResult(self.store_backend, call_id,
+                               metadata=metadata, timestamp=self.timestamp,
+                               verbose=self._verbose - 1)
+
+    def _load_item(self, call_id, metadata=None):
+        return self.store_backend.load_item(call_id, metadata=metadata,
+                                            timestamp=self.timestamp,
+                                            verbose=self._verbose)
+
+    def _print_duration(self, duration, context=''):
+        _, name = get_func_name(self.func)
+        msg = f"{name} {context}- {format_time(duration)}"
+        print(max(0, (80 - len(msg))) * '_' + msg)
+
+    # ------------------------------------------------------------------------
+    # Private `object` interface
+    # ------------------------------------------------------------------------
+
+    def __repr__(self):
+        return '{class_name}(func={func}, location={location})'.format(
+            class_name=self.__class__.__name__,
+            func=self.func,
+            location=self.store_backend.location,)
+
+
+###############################################################################
+# class `AsyncMemorizedFunc`
+###############################################################################
+class AsyncMemorizedFunc(MemorizedFunc):
+    async def __call__(self, *args, **kwargs):
+        out = super().__call__(*args, **kwargs)
+        return await out if asyncio.iscoroutine(out) else out
+
+    async def call_and_shelve(self, *args, **kwargs):
+        out = super().call_and_shelve(*args, **kwargs)
+        return await out if asyncio.iscoroutine(out) else out
+
+    async def call(self, *args, **kwargs):
+        out = super().call(*args, **kwargs)
+        return await out if asyncio.iscoroutine(out) else out
+
+    async def _call(self, call_id, args, kwargs, shelving=False):
+        self._before_call(args, kwargs)
+        start_time = time.time()
+        output = await self.func(*args, **kwargs)
+        return self._after_call(call_id, args, kwargs, shelving,
+                                output, start_time)
+
+
+###############################################################################
+# class `Memory`
+###############################################################################
+class Memory(Logger):
+    """ A context object for caching a function's return value each time it
+        is called with the same input arguments.
+
+        All values are cached on the filesystem, in a deep directory
+        structure.
+
+        Read more in the :ref:`User Guide <memory>`.
+
+        Parameters
+        ----------
+        location: str, pathlib.Path or None
+            The path of the base directory to use as a data store
+            or None. If None is given, no caching is done and
+            the Memory object is completely transparent. This option
+            replaces cachedir since version 0.12.
+
+        backend: str, optional
+            Type of store backend for reading/writing cache files.
+            Default: 'local'.
+            The 'local' backend is using regular filesystem operations to
+            manipulate data (open, mv, etc) in the backend.
+
+        mmap_mode: {None, 'r+', 'r', 'w+', 'c'}, optional
+            The memmapping mode used when loading from cache
+            numpy arrays. See numpy.load for the meaning of the
+            arguments.
+
+        compress: boolean, or integer, optional
+            Whether to zip the stored data on disk. If an integer is
+            given, it should be between 1 and 9, and sets the amount
+            of compression. Note that compressed arrays cannot be
+            read by memmapping.
+
+        verbose: int, optional
+            Verbosity flag, controls the debug messages that are issued
+            as functions are evaluated.
+
+        bytes_limit: int | str, optional
+            Limit in bytes of the size of the cache. By default, the size of
+            the cache is unlimited. When reducing the size of the cache,
+            ``joblib`` keeps the most recently accessed items first. If a
+            str is passed, it is converted to a number of bytes using units
+            { K | M | G} for kilo, mega, giga.
+
+            **Note:** You need to call :meth:`joblib.Memory.reduce_size` to
+            actually reduce the cache size to be less than ``bytes_limit``.
+
+            **Note:** This argument has been deprecated. One should give the
+            value of ``bytes_limit`` directly in
+            :meth:`joblib.Memory.reduce_size`.
+
+        backend_options: dict, optional
+            Contains a dictionary of named parameters used to configure
+            the store backend.
+    """
+    # ------------------------------------------------------------------------
+    # Public interface
+    # ------------------------------------------------------------------------
+
+    def __init__(self, location=None, backend='local',
+                 mmap_mode=None, compress=False, verbose=1, bytes_limit=None,
+                 backend_options=None):
+        Logger.__init__(self)
+        self._verbose = verbose
+        self.mmap_mode = mmap_mode
+        self.timestamp = time.time()
+        if bytes_limit is not None:
+            warnings.warn(
+                "bytes_limit argument has been deprecated. It will be removed "
+                "in version 1.5. Please pass its value directly to "
+                "Memory.reduce_size.",
+                category=DeprecationWarning
+            )
+        self.bytes_limit = bytes_limit
+        self.backend = backend
+        self.compress = compress
+        if backend_options is None:
+            backend_options = {}
+        self.backend_options = backend_options
+
+        if compress and mmap_mode is not None:
+            warnings.warn('Compressed results cannot be memmapped',
+                          stacklevel=2)
+
+        self.location = location
+        if isinstance(location, str):
+            location = os.path.join(location, 'joblib')
+
+        self.store_backend = _store_backend_factory(
+            backend, location, verbose=self._verbose,
+            backend_options=dict(compress=compress, mmap_mode=mmap_mode,
+                                 **backend_options))
+
+    def cache(self, func=None, ignore=None, verbose=None, mmap_mode=False,
+              cache_validation_callback=None):
+        """ Decorates the given function func to only compute its return
+            value for input arguments not cached on disk.
+
+            Parameters
+            ----------
+            func: callable, optional
+                The function to be decorated
+            ignore: list of strings
+                A list of arguments name to ignore in the hashing
+            verbose: integer, optional
+                The verbosity mode of the function. By default that
+                of the memory object is used.
+            mmap_mode: {None, 'r+', 'r', 'w+', 'c'}, optional
+                The memmapping mode used when loading from cache
+                numpy arrays. See numpy.load for the meaning of the
+                arguments. By default that of the memory object is used.
+            cache_validation_callback: callable, optional
+                Callable to validate whether or not the cache is valid. When
+                the cached function is called with arguments for which a cache
+                exists, this callable is called with the metadata of the cached
+                result as its sole argument. If it returns True, then the
+                cached result is returned, else the cache for these arguments
+                is cleared and recomputed.
+
+            Returns
+            -------
+            decorated_func: MemorizedFunc object
+                The returned object is a MemorizedFunc object, that is
+                callable (behaves like a function), but offers extra
+                methods for cache lookup and management. See the
+                documentation for :class:`joblib.memory.MemorizedFunc`.
+        """
+        if (cache_validation_callback is not None and
+                not callable(cache_validation_callback)):
+            raise ValueError(
+                "cache_validation_callback needs to be callable. "
+                f"Got {cache_validation_callback}."
+            )
+        if func is None:
+            # Partial application, to be able to specify extra keyword
+            # arguments in decorators
+            return functools.partial(
+                self.cache, ignore=ignore,
+                mmap_mode=mmap_mode,
+                verbose=verbose,
+                cache_validation_callback=cache_validation_callback
+            )
+        if self.store_backend is None:
+            cls = (AsyncNotMemorizedFunc
+                   if asyncio.iscoroutinefunction(func)
+                   else NotMemorizedFunc)
+            return cls(func)
+        if verbose is None:
+            verbose = self._verbose
+        if mmap_mode is False:
+            mmap_mode = self.mmap_mode
+        if isinstance(func, MemorizedFunc):
+            func = func.func
+        cls = (AsyncMemorizedFunc
+               if asyncio.iscoroutinefunction(func)
+               else MemorizedFunc)
+        return cls(
+            func, location=self.store_backend, backend=self.backend,
+            ignore=ignore, mmap_mode=mmap_mode, compress=self.compress,
+            verbose=verbose, timestamp=self.timestamp,
+            cache_validation_callback=cache_validation_callback
+        )
+
+    def clear(self, warn=True):
+        """ Erase the complete cache directory.
+        """
+        if warn:
+            self.warn('Flushing completely the cache')
+        if self.store_backend is not None:
+            self.store_backend.clear()
+
+            # As the cache is completely clear, make sure the _FUNCTION_HASHES
+            # cache is also reset. Else, for a function that is present in this
+            # table, results cached after this clear will be have cache miss
+            # as the function code is not re-written.
+            _FUNCTION_HASHES.clear()
+
+    def reduce_size(self, bytes_limit=None, items_limit=None, age_limit=None):
+        """Remove cache elements to make the cache fit its limits.
+
+        The limitation can impose that the cache size fits in ``bytes_limit``,
+        that the number of cache items is no more than ``items_limit``, and
+        that all files in cache are not older than ``age_limit``.
+
+        Parameters
+        ----------
+        bytes_limit: int | str, optional
+            Limit in bytes of the size of the cache. By default, the size of
+            the cache is unlimited. When reducing the size of the cache,
+            ``joblib`` keeps the most recently accessed items first. If a
+            str is passed, it is converted to a number of bytes using units
+            { K | M | G} for kilo, mega, giga.
+
+        items_limit: int, optional
+            Number of items to limit the cache to.  By default, the number of
+            items in the cache is unlimited.  When reducing the size of the
+            cache, ``joblib`` keeps the most recently accessed items first.
+
+        age_limit: datetime.timedelta, optional
+            Maximum age of items to limit the cache to.  When reducing the size
+            of the cache, any items last accessed more than the given length of
+            time ago are deleted.
+        """
+        if bytes_limit is None:
+            bytes_limit = self.bytes_limit
+
+        if self.store_backend is None:
+            # No cached results, this function does nothing.
+            return
+
+        if bytes_limit is None and items_limit is None and age_limit is None:
+            # No limitation to impose, returning
+            return
+
+        # Defers the actual limits enforcing to the store backend.
+        self.store_backend.enforce_store_limits(
+            bytes_limit, items_limit, age_limit
+        )
+
+    def eval(self, func, *args, **kwargs):
+        """ Eval function func with arguments `*args` and `**kwargs`,
+            in the context of the memory.
+
+            This method works similarly to the builtin `apply`, except
+            that the function is called only if the cache is not
+            up to date.
+
+        """
+        if self.store_backend is None:
+            return func(*args, **kwargs)
+        return self.cache(func)(*args, **kwargs)
+
+    # ------------------------------------------------------------------------
+    # Private `object` interface
+    # ------------------------------------------------------------------------
+
+    def __repr__(self):
+        return '{class_name}(location={location})'.format(
+            class_name=self.__class__.__name__,
+            location=(None if self.store_backend is None
+                      else self.store_backend.location))
+
+    def __getstate__(self):
+        """ We don't store the timestamp when pickling, to avoid the hash
+            depending from it.
+        """
+        state = self.__dict__.copy()
+        state['timestamp'] = None
+        return state
+
+
+###############################################################################
+# cache_validation_callback helpers
+###############################################################################
+
+def expires_after(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0,
+                  hours=0, weeks=0):
+    """Helper cache_validation_callback to force recompute after a duration.
+
+    Parameters
+    ----------
+    days, seconds, microseconds, milliseconds, minutes, hours, weeks: numbers
+        argument passed to a timedelta.
+    """
+    delta = datetime.timedelta(
+        days=days, seconds=seconds, microseconds=microseconds,
+        milliseconds=milliseconds, minutes=minutes, hours=hours, weeks=weeks
+    )
+
+    def cache_validation_callback(metadata):
+        computation_age = time.time() - metadata['time']
+        return computation_age < delta.total_seconds()
+
+    return cache_validation_callback
diff --git a/llm/Lib/site-packages/joblib/numpy_pickle.py b/llm/Lib/site-packages/joblib/numpy_pickle.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf83bb0914571dfa978bbe41a6d0e3a44a9cb947
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/numpy_pickle.py
@@ -0,0 +1,659 @@
+"""Utilities for fast persistence of big data, with optional compression."""
+
+# Author: Gael Varoquaux <gael dot varoquaux at normalesup dot org>
+# Copyright (c) 2009 Gael Varoquaux
+# License: BSD Style, 3 clauses.
+
+import pickle
+import os
+import warnings
+import io
+from pathlib import Path
+
+from .compressor import lz4, LZ4_NOT_INSTALLED_ERROR
+from .compressor import _COMPRESSORS, register_compressor, BinaryZlibFile
+from .compressor import (ZlibCompressorWrapper, GzipCompressorWrapper,
+                         BZ2CompressorWrapper, LZMACompressorWrapper,
+                         XZCompressorWrapper, LZ4CompressorWrapper)
+from .numpy_pickle_utils import Unpickler, Pickler
+from .numpy_pickle_utils import _read_fileobject, _write_fileobject
+from .numpy_pickle_utils import _read_bytes, BUFFER_SIZE
+from .numpy_pickle_utils import _ensure_native_byte_order
+from .numpy_pickle_compat import load_compatibility
+from .numpy_pickle_compat import NDArrayWrapper
+# For compatibility with old versions of joblib, we need ZNDArrayWrapper
+# to be visible in the current namespace.
+# Explicitly skipping next line from flake8 as it triggers an F401 warning
+# which we don't care.
+from .numpy_pickle_compat import ZNDArrayWrapper  # noqa
+from .backports import make_memmap
+
+# Register supported compressors
+register_compressor('zlib', ZlibCompressorWrapper())
+register_compressor('gzip', GzipCompressorWrapper())
+register_compressor('bz2', BZ2CompressorWrapper())
+register_compressor('lzma', LZMACompressorWrapper())
+register_compressor('xz', XZCompressorWrapper())
+register_compressor('lz4', LZ4CompressorWrapper())
+
+
+###############################################################################
+# Utility objects for persistence.
+
+# For convenience, 16 bytes are used to be sure to cover all the possible
+# dtypes' alignments. For reference, see:
+# https://numpy.org/devdocs/dev/alignment.html
+NUMPY_ARRAY_ALIGNMENT_BYTES = 16
+
+
+class NumpyArrayWrapper(object):
+    """An object to be persisted instead of numpy arrays.
+
+    This object is used to hack into the pickle machinery and read numpy
+    array data from our custom persistence format.
+    More precisely, this object is used for:
+    * carrying the information of the persisted array: subclass, shape, order,
+    dtype. Those ndarray metadata are used to correctly reconstruct the array
+    with low level numpy functions.
+    * determining if memmap is allowed on the array.
+    * reading the array bytes from a file.
+    * reading the array using memorymap from a file.
+    * writing the array bytes to a file.
+
+    Attributes
+    ----------
+    subclass: numpy.ndarray subclass
+        Determine the subclass of the wrapped array.
+    shape: numpy.ndarray shape
+        Determine the shape of the wrapped array.
+    order: {'C', 'F'}
+        Determine the order of wrapped array data. 'C' is for C order, 'F' is
+        for fortran order.
+    dtype: numpy.ndarray dtype
+        Determine the data type of the wrapped array.
+    allow_mmap: bool
+        Determine if memory mapping is allowed on the wrapped array.
+        Default: False.
+    """
+
+    def __init__(self, subclass, shape, order, dtype, allow_mmap=False,
+                 numpy_array_alignment_bytes=NUMPY_ARRAY_ALIGNMENT_BYTES):
+        """Constructor. Store the useful information for later."""
+        self.subclass = subclass
+        self.shape = shape
+        self.order = order
+        self.dtype = dtype
+        self.allow_mmap = allow_mmap
+        # We make numpy_array_alignment_bytes an instance attribute to allow us
+        # to change our mind about the default alignment and still load the old
+        # pickles (with the previous alignment) correctly
+        self.numpy_array_alignment_bytes = numpy_array_alignment_bytes
+
+    def safe_get_numpy_array_alignment_bytes(self):
+        # NumpyArrayWrapper instances loaded from joblib <= 1.1 pickles don't
+        # have an numpy_array_alignment_bytes attribute
+        return getattr(self, 'numpy_array_alignment_bytes', None)
+
+    def write_array(self, array, pickler):
+        """Write array bytes to pickler file handle.
+
+        This function is an adaptation of the numpy write_array function
+        available in version 1.10.1 in numpy/lib/format.py.
+        """
+        # Set buffer size to 16 MiB to hide the Python loop overhead.
+        buffersize = max(16 * 1024 ** 2 // array.itemsize, 1)
+        if array.dtype.hasobject:
+            # We contain Python objects so we cannot write out the data
+            # directly. Instead, we will pickle it out with version 2 of the
+            # pickle protocol.
+            pickle.dump(array, pickler.file_handle, protocol=2)
+        else:
+            numpy_array_alignment_bytes = \
+                self.safe_get_numpy_array_alignment_bytes()
+            if numpy_array_alignment_bytes is not None:
+                current_pos = pickler.file_handle.tell()
+                pos_after_padding_byte = current_pos + 1
+                padding_length = numpy_array_alignment_bytes - (
+                    pos_after_padding_byte % numpy_array_alignment_bytes)
+                # A single byte is written that contains the padding length in
+                # bytes
+                padding_length_byte = int.to_bytes(
+                    padding_length, length=1, byteorder='little')
+                pickler.file_handle.write(padding_length_byte)
+
+                if padding_length != 0:
+                    padding = b'\xff' * padding_length
+                    pickler.file_handle.write(padding)
+
+            for chunk in pickler.np.nditer(array,
+                                           flags=['external_loop',
+                                                  'buffered',
+                                                  'zerosize_ok'],
+                                           buffersize=buffersize,
+                                           order=self.order):
+                pickler.file_handle.write(chunk.tobytes('C'))
+
+    def read_array(self, unpickler):
+        """Read array from unpickler file handle.
+
+        This function is an adaptation of the numpy read_array function
+        available in version 1.10.1 in numpy/lib/format.py.
+        """
+        if len(self.shape) == 0:
+            count = 1
+        else:
+            # joblib issue #859: we cast the elements of self.shape to int64 to
+            # prevent a potential overflow when computing their product.
+            shape_int64 = [unpickler.np.int64(x) for x in self.shape]
+            count = unpickler.np.multiply.reduce(shape_int64)
+        # Now read the actual data.
+        if self.dtype.hasobject:
+            # The array contained Python objects. We need to unpickle the data.
+            array = pickle.load(unpickler.file_handle)
+        else:
+            numpy_array_alignment_bytes = \
+                self.safe_get_numpy_array_alignment_bytes()
+            if numpy_array_alignment_bytes is not None:
+                padding_byte = unpickler.file_handle.read(1)
+                padding_length = int.from_bytes(
+                    padding_byte, byteorder='little')
+                if padding_length != 0:
+                    unpickler.file_handle.read(padding_length)
+
+            # This is not a real file. We have to read it the
+            # memory-intensive way.
+            # crc32 module fails on reads greater than 2 ** 32 bytes,
+            # breaking large reads from gzip streams. Chunk reads to
+            # BUFFER_SIZE bytes to avoid issue and reduce memory overhead
+            # of the read. In non-chunked case count < max_read_count, so
+            # only one read is performed.
+            max_read_count = BUFFER_SIZE // min(BUFFER_SIZE,
+                                                self.dtype.itemsize)
+
+            array = unpickler.np.empty(count, dtype=self.dtype)
+            for i in range(0, count, max_read_count):
+                read_count = min(max_read_count, count - i)
+                read_size = int(read_count * self.dtype.itemsize)
+                data = _read_bytes(unpickler.file_handle,
+                                   read_size, "array data")
+                array[i:i + read_count] = \
+                    unpickler.np.frombuffer(data, dtype=self.dtype,
+                                            count=read_count)
+                del data
+
+            if self.order == 'F':
+                array.shape = self.shape[::-1]
+                array = array.transpose()
+            else:
+                array.shape = self.shape
+
+        # Detect byte order mismatch and swap as needed.
+        return _ensure_native_byte_order(array)
+
+    def read_mmap(self, unpickler):
+        """Read an array using numpy memmap."""
+        current_pos = unpickler.file_handle.tell()
+        offset = current_pos
+        numpy_array_alignment_bytes = \
+            self.safe_get_numpy_array_alignment_bytes()
+
+        if numpy_array_alignment_bytes is not None:
+            padding_byte = unpickler.file_handle.read(1)
+            padding_length = int.from_bytes(padding_byte, byteorder='little')
+            # + 1 is for the padding byte
+            offset += padding_length + 1
+
+        if unpickler.mmap_mode == 'w+':
+            unpickler.mmap_mode = 'r+'
+
+        marray = make_memmap(unpickler.filename,
+                             dtype=self.dtype,
+                             shape=self.shape,
+                             order=self.order,
+                             mode=unpickler.mmap_mode,
+                             offset=offset)
+        # update the offset so that it corresponds to the end of the read array
+        unpickler.file_handle.seek(offset + marray.nbytes)
+
+        if (numpy_array_alignment_bytes is None and
+                current_pos % NUMPY_ARRAY_ALIGNMENT_BYTES != 0):
+            message = (
+                f'The memmapped array {marray} loaded from the file '
+                f'{unpickler.file_handle.name} is not byte aligned. '
+                'This may cause segmentation faults if this memmapped array '
+                'is used in some libraries like BLAS or PyTorch. '
+                'To get rid of this warning, regenerate your pickle file '
+                'with joblib >= 1.2.0. '
+                'See https://github.com/joblib/joblib/issues/563 '
+                'for more details'
+            )
+            warnings.warn(message)
+
+        return _ensure_native_byte_order(marray)
+
+    def read(self, unpickler):
+        """Read the array corresponding to this wrapper.
+
+        Use the unpickler to get all information to correctly read the array.
+
+        Parameters
+        ----------
+        unpickler: NumpyUnpickler
+
+        Returns
+        -------
+        array: numpy.ndarray
+
+        """
+        # When requested, only use memmap mode if allowed.
+        if unpickler.mmap_mode is not None and self.allow_mmap:
+            array = self.read_mmap(unpickler)
+        else:
+            array = self.read_array(unpickler)
+
+        # Manage array subclass case
+        if (hasattr(array, '__array_prepare__') and
+            self.subclass not in (unpickler.np.ndarray,
+                                  unpickler.np.memmap)):
+            # We need to reconstruct another subclass
+            new_array = unpickler.np.core.multiarray._reconstruct(
+                self.subclass, (0,), 'b')
+            return new_array.__array_prepare__(array)
+        else:
+            return array
+
+###############################################################################
+# Pickler classes
+
+
+class NumpyPickler(Pickler):
+    """A pickler to persist big data efficiently.
+
+    The main features of this object are:
+    * persistence of numpy arrays in a single file.
+    * optional compression with a special care on avoiding memory copies.
+
+    Attributes
+    ----------
+    fp: file
+        File object handle used for serializing the input object.
+    protocol: int, optional
+        Pickle protocol used. Default is pickle.DEFAULT_PROTOCOL.
+    """
+
+    dispatch = Pickler.dispatch.copy()
+
+    def __init__(self, fp, protocol=None):
+        self.file_handle = fp
+        self.buffered = isinstance(self.file_handle, BinaryZlibFile)
+
+        # By default we want a pickle protocol that only changes with
+        # the major python version and not the minor one
+        if protocol is None:
+            protocol = pickle.DEFAULT_PROTOCOL
+
+        Pickler.__init__(self, self.file_handle, protocol=protocol)
+        # delayed import of numpy, to avoid tight coupling
+        try:
+            import numpy as np
+        except ImportError:
+            np = None
+        self.np = np
+
+    def _create_array_wrapper(self, array):
+        """Create and returns a numpy array wrapper from a numpy array."""
+        order = 'F' if (array.flags.f_contiguous and
+                        not array.flags.c_contiguous) else 'C'
+        allow_mmap = not self.buffered and not array.dtype.hasobject
+
+        kwargs = {}
+        try:
+            self.file_handle.tell()
+        except io.UnsupportedOperation:
+            kwargs = {'numpy_array_alignment_bytes': None}
+
+        wrapper = NumpyArrayWrapper(type(array),
+                                    array.shape, order, array.dtype,
+                                    allow_mmap=allow_mmap,
+                                    **kwargs)
+
+        return wrapper
+
+    def save(self, obj):
+        """Subclass the Pickler `save` method.
+
+        This is a total abuse of the Pickler class in order to use the numpy
+        persistence function `save` instead of the default pickle
+        implementation. The numpy array is replaced by a custom wrapper in the
+        pickle persistence stack and the serialized array is written right
+        after in the file. Warning: the file produced does not follow the
+        pickle format. As such it can not be read with `pickle.load`.
+        """
+        if self.np is not None and type(obj) in (self.np.ndarray,
+                                                 self.np.matrix,
+                                                 self.np.memmap):
+            if type(obj) is self.np.memmap:
+                # Pickling doesn't work with memmapped arrays
+                obj = self.np.asanyarray(obj)
+
+            # The array wrapper is pickled instead of the real array.
+            wrapper = self._create_array_wrapper(obj)
+            Pickler.save(self, wrapper)
+
+            # A framer was introduced with pickle protocol 4 and we want to
+            # ensure the wrapper object is written before the numpy array
+            # buffer in the pickle file.
+            # See https://www.python.org/dev/peps/pep-3154/#framing to get
+            # more information on the framer behavior.
+            if self.proto >= 4:
+                self.framer.commit_frame(force=True)
+
+            # And then array bytes are written right after the wrapper.
+            wrapper.write_array(obj, self)
+            return
+
+        return Pickler.save(self, obj)
+
+
+class NumpyUnpickler(Unpickler):
+    """A subclass of the Unpickler to unpickle our numpy pickles.
+
+    Attributes
+    ----------
+    mmap_mode: str
+        The memorymap mode to use for reading numpy arrays.
+    file_handle: file_like
+        File object to unpickle from.
+    filename: str
+        Name of the file to unpickle from. It should correspond to file_handle.
+        This parameter is required when using mmap_mode.
+    np: module
+        Reference to numpy module if numpy is installed else None.
+
+    """
+
+    dispatch = Unpickler.dispatch.copy()
+
+    def __init__(self, filename, file_handle, mmap_mode=None):
+        # The next line is for backward compatibility with pickle generated
+        # with joblib versions less than 0.10.
+        self._dirname = os.path.dirname(filename)
+
+        self.mmap_mode = mmap_mode
+        self.file_handle = file_handle
+        # filename is required for numpy mmap mode.
+        self.filename = filename
+        self.compat_mode = False
+        Unpickler.__init__(self, self.file_handle)
+        try:
+            import numpy as np
+        except ImportError:
+            np = None
+        self.np = np
+
+    def load_build(self):
+        """Called to set the state of a newly created object.
+
+        We capture it to replace our place-holder objects, NDArrayWrapper or
+        NumpyArrayWrapper, by the array we are interested in. We
+        replace them directly in the stack of pickler.
+        NDArrayWrapper is used for backward compatibility with joblib <= 0.9.
+        """
+        Unpickler.load_build(self)
+
+        # For backward compatibility, we support NDArrayWrapper objects.
+        if isinstance(self.stack[-1], (NDArrayWrapper, NumpyArrayWrapper)):
+            if self.np is None:
+                raise ImportError("Trying to unpickle an ndarray, "
+                                  "but numpy didn't import correctly")
+            array_wrapper = self.stack.pop()
+            # If any NDArrayWrapper is found, we switch to compatibility mode,
+            # this will be used to raise a DeprecationWarning to the user at
+            # the end of the unpickling.
+            if isinstance(array_wrapper, NDArrayWrapper):
+                self.compat_mode = True
+            self.stack.append(array_wrapper.read(self))
+
+    # Be careful to register our new method.
+    dispatch[pickle.BUILD[0]] = load_build
+
+
+###############################################################################
+# Utility functions
+
+def dump(value, filename, compress=0, protocol=None, cache_size=None):
+    """Persist an arbitrary Python object into one file.
+
+    Read more in the :ref:`User Guide <persistence>`.
+
+    Parameters
+    ----------
+    value: any Python object
+        The object to store to disk.
+    filename: str, pathlib.Path, or file object.
+        The file object or path of the file in which it is to be stored.
+        The compression method corresponding to one of the supported filename
+        extensions ('.z', '.gz', '.bz2', '.xz' or '.lzma') will be used
+        automatically.
+    compress: int from 0 to 9 or bool or 2-tuple, optional
+        Optional compression level for the data. 0 or False is no compression.
+        Higher value means more compression, but also slower read and
+        write times. Using a value of 3 is often a good compromise.
+        See the notes for more details.
+        If compress is True, the compression level used is 3.
+        If compress is a 2-tuple, the first element must correspond to a string
+        between supported compressors (e.g 'zlib', 'gzip', 'bz2', 'lzma'
+        'xz'), the second element must be an integer from 0 to 9, corresponding
+        to the compression level.
+    protocol: int, optional
+        Pickle protocol, see pickle.dump documentation for more details.
+    cache_size: positive int, optional
+        This option is deprecated in 0.10 and has no effect.
+
+    Returns
+    -------
+    filenames: list of strings
+        The list of file names in which the data is stored. If
+        compress is false, each array is stored in a different file.
+
+    See Also
+    --------
+    joblib.load : corresponding loader
+
+    Notes
+    -----
+    Memmapping on load cannot be used for compressed files. Thus
+    using compression can significantly slow down loading. In
+    addition, compressed files take up extra memory during
+    dump and load.
+
+    """
+
+    if Path is not None and isinstance(filename, Path):
+        filename = str(filename)
+
+    is_filename = isinstance(filename, str)
+    is_fileobj = hasattr(filename, "write")
+
+    compress_method = 'zlib'  # zlib is the default compression method.
+    if compress is True:
+        # By default, if compress is enabled, we want the default compress
+        # level of the compressor.
+        compress_level = None
+    elif isinstance(compress, tuple):
+        # a 2-tuple was set in compress
+        if len(compress) != 2:
+            raise ValueError(
+                'Compress argument tuple should contain exactly 2 elements: '
+                '(compress method, compress level), you passed {}'
+                .format(compress))
+        compress_method, compress_level = compress
+    elif isinstance(compress, str):
+        compress_method = compress
+        compress_level = None  # Use default compress level
+        compress = (compress_method, compress_level)
+    else:
+        compress_level = compress
+
+    if compress_method == 'lz4' and lz4 is None:
+        raise ValueError(LZ4_NOT_INSTALLED_ERROR)
+
+    if (compress_level is not None and
+            compress_level is not False and
+            compress_level not in range(10)):
+        # Raising an error if a non valid compress level is given.
+        raise ValueError(
+            'Non valid compress level given: "{}". Possible values are '
+            '{}.'.format(compress_level, list(range(10))))
+
+    if compress_method not in _COMPRESSORS:
+        # Raising an error if an unsupported compression method is given.
+        raise ValueError(
+            'Non valid compression method given: "{}". Possible values are '
+            '{}.'.format(compress_method, _COMPRESSORS))
+
+    if not is_filename and not is_fileobj:
+        # People keep inverting arguments, and the resulting error is
+        # incomprehensible
+        raise ValueError(
+            'Second argument should be a filename or a file-like object, '
+            '%s (type %s) was given.'
+            % (filename, type(filename))
+        )
+
+    if is_filename and not isinstance(compress, tuple):
+        # In case no explicit compression was requested using both compression
+        # method and level in a tuple and the filename has an explicit
+        # extension, we select the corresponding compressor.
+
+        # unset the variable to be sure no compression level is set afterwards.
+        compress_method = None
+        for name, compressor in _COMPRESSORS.items():
+            if filename.endswith(compressor.extension):
+                compress_method = name
+
+        if compress_method in _COMPRESSORS and compress_level == 0:
+            # we choose the default compress_level in case it was not given
+            # as an argument (using compress).
+            compress_level = None
+
+    if cache_size is not None:
+        # Cache size is deprecated starting from version 0.10
+        warnings.warn("Please do not set 'cache_size' in joblib.dump, "
+                      "this parameter has no effect and will be removed. "
+                      "You used 'cache_size={}'".format(cache_size),
+                      DeprecationWarning, stacklevel=2)
+
+    if compress_level != 0:
+        with _write_fileobject(filename, compress=(compress_method,
+                                                   compress_level)) as f:
+            NumpyPickler(f, protocol=protocol).dump(value)
+    elif is_filename:
+        with open(filename, 'wb') as f:
+            NumpyPickler(f, protocol=protocol).dump(value)
+    else:
+        NumpyPickler(filename, protocol=protocol).dump(value)
+
+    # If the target container is a file object, nothing is returned.
+    if is_fileobj:
+        return
+
+    # For compatibility, the list of created filenames (e.g with one element
+    # after 0.10.0) is returned by default.
+    return [filename]
+
+
+def _unpickle(fobj, filename="", mmap_mode=None):
+    """Internal unpickling function."""
+    # We are careful to open the file handle early and keep it open to
+    # avoid race-conditions on renames.
+    # That said, if data is stored in companion files, which can be
+    # the case with the old persistence format, moving the directory
+    # will create a race when joblib tries to access the companion
+    # files.
+    unpickler = NumpyUnpickler(filename, fobj, mmap_mode=mmap_mode)
+    obj = None
+    try:
+        obj = unpickler.load()
+        if unpickler.compat_mode:
+            warnings.warn("The file '%s' has been generated with a "
+                          "joblib version less than 0.10. "
+                          "Please regenerate this pickle file."
+                          % filename,
+                          DeprecationWarning, stacklevel=3)
+    except UnicodeDecodeError as exc:
+        # More user-friendly error message
+        new_exc = ValueError(
+            'You may be trying to read with '
+            'python 3 a joblib pickle generated with python 2. '
+            'This feature is not supported by joblib.')
+        new_exc.__cause__ = exc
+        raise new_exc
+    return obj
+
+
+def load_temporary_memmap(filename, mmap_mode, unlink_on_gc_collect):
+    from ._memmapping_reducer import JOBLIB_MMAPS, add_maybe_unlink_finalizer
+    obj = load(filename, mmap_mode)
+    JOBLIB_MMAPS.add(obj.filename)
+    if unlink_on_gc_collect:
+        add_maybe_unlink_finalizer(obj)
+    return obj
+
+
+def load(filename, mmap_mode=None):
+    """Reconstruct a Python object from a file persisted with joblib.dump.
+
+    Read more in the :ref:`User Guide <persistence>`.
+
+    WARNING: joblib.load relies on the pickle module and can therefore
+    execute arbitrary Python code. It should therefore never be used
+    to load files from untrusted sources.
+
+    Parameters
+    ----------
+    filename: str, pathlib.Path, or file object.
+        The file object or path of the file from which to load the object
+    mmap_mode: {None, 'r+', 'r', 'w+', 'c'}, optional
+        If not None, the arrays are memory-mapped from the disk. This
+        mode has no effect for compressed files. Note that in this
+        case the reconstructed object might no longer match exactly
+        the originally pickled object.
+
+    Returns
+    -------
+    result: any Python object
+        The object stored in the file.
+
+    See Also
+    --------
+    joblib.dump : function to save an object
+
+    Notes
+    -----
+
+    This function can load numpy array files saved separately during the
+    dump. If the mmap_mode argument is given, it is passed to np.load and
+    arrays are loaded as memmaps. As a consequence, the reconstructed
+    object might not match the original pickled object. Note that if the
+    file was saved with compression, the arrays cannot be memmapped.
+    """
+    if Path is not None and isinstance(filename, Path):
+        filename = str(filename)
+
+    if hasattr(filename, "read"):
+        fobj = filename
+        filename = getattr(fobj, 'name', '')
+        with _read_fileobject(fobj, filename, mmap_mode) as fobj:
+            obj = _unpickle(fobj)
+    else:
+        with open(filename, 'rb') as f:
+            with _read_fileobject(f, filename, mmap_mode) as fobj:
+                if isinstance(fobj, str):
+                    # if the returned file object is a string, this means we
+                    # try to load a pickle file generated with an version of
+                    # Joblib so we load it with joblib compatibility function.
+                    return load_compatibility(fobj)
+
+                obj = _unpickle(fobj, filename, mmap_mode)
+    return obj
diff --git a/llm/Lib/site-packages/joblib/numpy_pickle_compat.py b/llm/Lib/site-packages/joblib/numpy_pickle_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..32612849bdb8320990f0433d3ded42898046c913
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/numpy_pickle_compat.py
@@ -0,0 +1,244 @@
+"""Numpy pickle compatibility functions."""
+
+import pickle
+import os
+import zlib
+import inspect
+
+from io import BytesIO
+
+from .numpy_pickle_utils import _ZFILE_PREFIX
+from .numpy_pickle_utils import Unpickler
+from .numpy_pickle_utils import _ensure_native_byte_order
+
+
+def hex_str(an_int):
+    """Convert an int to an hexadecimal string."""
+    return '{:#x}'.format(an_int)
+
+
+def asbytes(s):
+    if isinstance(s, bytes):
+        return s
+    return s.encode('latin1')
+
+
+_MAX_LEN = len(hex_str(2 ** 64))
+_CHUNK_SIZE = 64 * 1024
+
+
+def read_zfile(file_handle):
+    """Read the z-file and return the content as a string.
+
+    Z-files are raw data compressed with zlib used internally by joblib
+    for persistence. Backward compatibility is not guaranteed. Do not
+    use for external purposes.
+    """
+    file_handle.seek(0)
+    header_length = len(_ZFILE_PREFIX) + _MAX_LEN
+    length = file_handle.read(header_length)
+    length = length[len(_ZFILE_PREFIX):]
+    length = int(length, 16)
+
+    # With python2 and joblib version <= 0.8.4 compressed pickle header is one
+    # character wider so we need to ignore an additional space if present.
+    # Note: the first byte of the zlib data is guaranteed not to be a
+    # space according to
+    # https://tools.ietf.org/html/rfc6713#section-2.1
+    next_byte = file_handle.read(1)
+    if next_byte != b' ':
+        # The zlib compressed data has started and we need to go back
+        # one byte
+        file_handle.seek(header_length)
+
+    # We use the known length of the data to tell Zlib the size of the
+    # buffer to allocate.
+    data = zlib.decompress(file_handle.read(), 15, length)
+    assert len(data) == length, (
+        "Incorrect data length while decompressing %s."
+        "The file could be corrupted." % file_handle)
+    return data
+
+
+def write_zfile(file_handle, data, compress=1):
+    """Write the data in the given file as a Z-file.
+
+    Z-files are raw data compressed with zlib used internally by joblib
+    for persistence. Backward compatibility is not guaranteed. Do not
+    use for external purposes.
+    """
+    file_handle.write(_ZFILE_PREFIX)
+    length = hex_str(len(data))
+    # Store the length of the data
+    file_handle.write(asbytes(length.ljust(_MAX_LEN)))
+    file_handle.write(zlib.compress(asbytes(data), compress))
+
+###############################################################################
+# Utility objects for persistence.
+
+
+class NDArrayWrapper(object):
+    """An object to be persisted instead of numpy arrays.
+
+    The only thing this object does, is to carry the filename in which
+    the array has been persisted, and the array subclass.
+    """
+
+    def __init__(self, filename, subclass, allow_mmap=True):
+        """Constructor. Store the useful information for later."""
+        self.filename = filename
+        self.subclass = subclass
+        self.allow_mmap = allow_mmap
+
+    def read(self, unpickler):
+        """Reconstruct the array."""
+        filename = os.path.join(unpickler._dirname, self.filename)
+        # Load the array from the disk
+        # use getattr instead of self.allow_mmap to ensure backward compat
+        # with NDArrayWrapper instances pickled with joblib < 0.9.0
+        allow_mmap = getattr(self, 'allow_mmap', True)
+        kwargs = {}
+        if allow_mmap:
+            kwargs['mmap_mode'] = unpickler.mmap_mode
+        if "allow_pickle" in inspect.signature(unpickler.np.load).parameters:
+            # Required in numpy 1.16.3 and later to aknowledge the security
+            # risk.
+            kwargs["allow_pickle"] = True
+        array = unpickler.np.load(filename, **kwargs)
+
+        # Detect byte order mismatch and swap as needed.
+        array = _ensure_native_byte_order(array)
+
+        # Reconstruct subclasses. This does not work with old
+        # versions of numpy
+        if (hasattr(array, '__array_prepare__') and
+            self.subclass not in (unpickler.np.ndarray,
+                                  unpickler.np.memmap)):
+            # We need to reconstruct another subclass
+            new_array = unpickler.np.core.multiarray._reconstruct(
+                self.subclass, (0,), 'b')
+            return new_array.__array_prepare__(array)
+        else:
+            return array
+
+
+class ZNDArrayWrapper(NDArrayWrapper):
+    """An object to be persisted instead of numpy arrays.
+
+    This object store the Zfile filename in which
+    the data array has been persisted, and the meta information to
+    retrieve it.
+    The reason that we store the raw buffer data of the array and
+    the meta information, rather than array representation routine
+    (tobytes) is that it enables us to use completely the strided
+    model to avoid memory copies (a and a.T store as fast). In
+    addition saving the heavy information separately can avoid
+    creating large temporary buffers when unpickling data with
+    large arrays.
+    """
+
+    def __init__(self, filename, init_args, state):
+        """Constructor. Store the useful information for later."""
+        self.filename = filename
+        self.state = state
+        self.init_args = init_args
+
+    def read(self, unpickler):
+        """Reconstruct the array from the meta-information and the z-file."""
+        # Here we a simply reproducing the unpickling mechanism for numpy
+        # arrays
+        filename = os.path.join(unpickler._dirname, self.filename)
+        array = unpickler.np.core.multiarray._reconstruct(*self.init_args)
+        with open(filename, 'rb') as f:
+            data = read_zfile(f)
+        state = self.state + (data,)
+        array.__setstate__(state)
+        return array
+
+
+class ZipNumpyUnpickler(Unpickler):
+    """A subclass of the Unpickler to unpickle our numpy pickles."""
+
+    dispatch = Unpickler.dispatch.copy()
+
+    def __init__(self, filename, file_handle, mmap_mode=None):
+        """Constructor."""
+        self._filename = os.path.basename(filename)
+        self._dirname = os.path.dirname(filename)
+        self.mmap_mode = mmap_mode
+        self.file_handle = self._open_pickle(file_handle)
+        Unpickler.__init__(self, self.file_handle)
+        try:
+            import numpy as np
+        except ImportError:
+            np = None
+        self.np = np
+
+    def _open_pickle(self, file_handle):
+        return BytesIO(read_zfile(file_handle))
+
+    def load_build(self):
+        """Set the state of a newly created object.
+
+        We capture it to replace our place-holder objects,
+        NDArrayWrapper, by the array we are interested in. We
+        replace them directly in the stack of pickler.
+        """
+        Unpickler.load_build(self)
+        if isinstance(self.stack[-1], NDArrayWrapper):
+            if self.np is None:
+                raise ImportError("Trying to unpickle an ndarray, "
+                                  "but numpy didn't import correctly")
+            nd_array_wrapper = self.stack.pop()
+            array = nd_array_wrapper.read(self)
+            self.stack.append(array)
+
+    dispatch[pickle.BUILD[0]] = load_build
+
+
+def load_compatibility(filename):
+    """Reconstruct a Python object from a file persisted with joblib.dump.
+
+    This function ensures the compatibility with joblib old persistence format
+    (<= 0.9.3).
+
+    Parameters
+    ----------
+    filename: string
+        The name of the file from which to load the object
+
+    Returns
+    -------
+    result: any Python object
+        The object stored in the file.
+
+    See Also
+    --------
+    joblib.dump : function to save an object
+
+    Notes
+    -----
+
+    This function can load numpy array files saved separately during the
+    dump.
+    """
+    with open(filename, 'rb') as file_handle:
+        # We are careful to open the file handle early and keep it open to
+        # avoid race-conditions on renames. That said, if data is stored in
+        # companion files, moving the directory will create a race when
+        # joblib tries to access the companion files.
+        unpickler = ZipNumpyUnpickler(filename, file_handle=file_handle)
+        try:
+            obj = unpickler.load()
+        except UnicodeDecodeError as exc:
+            # More user-friendly error message
+            new_exc = ValueError(
+                'You may be trying to read with '
+                'python 3 a joblib pickle generated with python 2. '
+                'This feature is not supported by joblib.')
+            new_exc.__cause__ = exc
+            raise new_exc
+        finally:
+            if hasattr(unpickler, 'file_handle'):
+                unpickler.file_handle.close()
+        return obj
diff --git a/llm/Lib/site-packages/joblib/numpy_pickle_utils.py b/llm/Lib/site-packages/joblib/numpy_pickle_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..23cfb34ecb19161a2eca6bc85f29c3996162572c
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/numpy_pickle_utils.py
@@ -0,0 +1,253 @@
+"""Utilities for fast persistence of big data, with optional compression."""
+
+# Author: Gael Varoquaux <gael dot varoquaux at normalesup dot org>
+# Copyright (c) 2009 Gael Varoquaux
+# License: BSD Style, 3 clauses.
+
+import pickle
+import io
+import sys
+import warnings
+import contextlib
+
+from .compressor import _ZFILE_PREFIX
+from .compressor import _COMPRESSORS
+
+try:
+    import numpy as np
+except ImportError:
+    np = None
+
+Unpickler = pickle._Unpickler
+Pickler = pickle._Pickler
+xrange = range
+
+
+try:
+    # The python standard library can be built without bz2 so we make bz2
+    # usage optional.
+    # see https://github.com/scikit-learn/scikit-learn/issues/7526 for more
+    # details.
+    import bz2
+except ImportError:
+    bz2 = None
+
+# Buffer size used in io.BufferedReader and io.BufferedWriter
+_IO_BUFFER_SIZE = 1024 ** 2
+
+
+def _is_raw_file(fileobj):
+    """Check if fileobj is a raw file object, e.g created with open."""
+    fileobj = getattr(fileobj, 'raw', fileobj)
+    return isinstance(fileobj, io.FileIO)
+
+
+def _get_prefixes_max_len():
+    # Compute the max prefix len of registered compressors.
+    prefixes = [len(compressor.prefix) for compressor in _COMPRESSORS.values()]
+    prefixes += [len(_ZFILE_PREFIX)]
+    return max(prefixes)
+
+
+def _is_numpy_array_byte_order_mismatch(array):
+    """Check if numpy array is having byte order mismatch"""
+    return ((sys.byteorder == 'big' and
+             (array.dtype.byteorder == '<' or
+              (array.dtype.byteorder == '|' and array.dtype.fields and
+               all(e[0].byteorder == '<'
+                   for e in array.dtype.fields.values())))) or
+            (sys.byteorder == 'little' and
+             (array.dtype.byteorder == '>' or
+              (array.dtype.byteorder == '|' and array.dtype.fields and
+               all(e[0].byteorder == '>'
+                   for e in array.dtype.fields.values())))))
+
+
+def _ensure_native_byte_order(array):
+    """Use the byte order of the host while preserving values
+
+    Does nothing if array already uses the system byte order.
+    """
+    if _is_numpy_array_byte_order_mismatch(array):
+        array = array.byteswap().view(array.dtype.newbyteorder('='))
+    return array
+
+
+###############################################################################
+# Cache file utilities
+def _detect_compressor(fileobj):
+    """Return the compressor matching fileobj.
+
+    Parameters
+    ----------
+    fileobj: file object
+
+    Returns
+    -------
+    str in {'zlib', 'gzip', 'bz2', 'lzma', 'xz', 'compat', 'not-compressed'}
+    """
+    # Read the magic number in the first bytes of the file.
+    max_prefix_len = _get_prefixes_max_len()
+    if hasattr(fileobj, 'peek'):
+        # Peek allows to read those bytes without moving the cursor in the
+        # file whic.
+        first_bytes = fileobj.peek(max_prefix_len)
+    else:
+        # Fallback to seek if the fileobject is not peekable.
+        first_bytes = fileobj.read(max_prefix_len)
+        fileobj.seek(0)
+
+    if first_bytes.startswith(_ZFILE_PREFIX):
+        return "compat"
+    else:
+        for name, compressor in _COMPRESSORS.items():
+            if first_bytes.startswith(compressor.prefix):
+                return name
+
+    return "not-compressed"
+
+
+def _buffered_read_file(fobj):
+    """Return a buffered version of a read file object."""
+    return io.BufferedReader(fobj, buffer_size=_IO_BUFFER_SIZE)
+
+
+def _buffered_write_file(fobj):
+    """Return a buffered version of a write file object."""
+    return io.BufferedWriter(fobj, buffer_size=_IO_BUFFER_SIZE)
+
+
+@contextlib.contextmanager
+def _read_fileobject(fileobj, filename, mmap_mode=None):
+    """Utility function opening the right fileobject from a filename.
+
+    The magic number is used to choose between the type of file object to open:
+    * regular file object (default)
+    * zlib file object
+    * gzip file object
+    * bz2 file object
+    * lzma file object (for xz and lzma compressor)
+
+    Parameters
+    ----------
+    fileobj: file object
+    compressor: str in {'zlib', 'gzip', 'bz2', 'lzma', 'xz', 'compat',
+                        'not-compressed'}
+    filename: str
+        filename path corresponding to the fileobj parameter.
+    mmap_mode: str
+        memory map mode that should be used to open the pickle file. This
+        parameter is useful to verify that the user is not trying to one with
+        compression. Default: None.
+
+    Returns
+    -------
+        a file like object
+
+    """
+    # Detect if the fileobj contains compressed data.
+    compressor = _detect_compressor(fileobj)
+
+    if compressor == 'compat':
+        # Compatibility with old pickle mode: simply return the input
+        # filename "as-is" and let the compatibility function be called by the
+        # caller.
+        warnings.warn("The file '%s' has been generated with a joblib "
+                      "version less than 0.10. "
+                      "Please regenerate this pickle file." % filename,
+                      DeprecationWarning, stacklevel=2)
+        yield filename
+    else:
+        if compressor in _COMPRESSORS:
+            # based on the compressor detected in the file, we open the
+            # correct decompressor file object, wrapped in a buffer.
+            compressor_wrapper = _COMPRESSORS[compressor]
+            inst = compressor_wrapper.decompressor_file(fileobj)
+            fileobj = _buffered_read_file(inst)
+
+        # Checking if incompatible load parameters with the type of file:
+        # mmap_mode cannot be used with compressed file or in memory buffers
+        # such as io.BytesIO.
+        if mmap_mode is not None:
+            if isinstance(fileobj, io.BytesIO):
+                warnings.warn('In memory persistence is not compatible with '
+                              'mmap_mode "%(mmap_mode)s" flag passed. '
+                              'mmap_mode option will be ignored.'
+                              % locals(), stacklevel=2)
+            elif compressor != 'not-compressed':
+                warnings.warn('mmap_mode "%(mmap_mode)s" is not compatible '
+                              'with compressed file %(filename)s. '
+                              '"%(mmap_mode)s" flag will be ignored.'
+                              % locals(), stacklevel=2)
+            elif not _is_raw_file(fileobj):
+                warnings.warn('"%(fileobj)r" is not a raw file, mmap_mode '
+                              '"%(mmap_mode)s" flag will be ignored.'
+                              % locals(), stacklevel=2)
+
+        yield fileobj
+
+
+def _write_fileobject(filename, compress=("zlib", 3)):
+    """Return the right compressor file object in write mode."""
+    compressmethod = compress[0]
+    compresslevel = compress[1]
+
+    if compressmethod in _COMPRESSORS.keys():
+        file_instance = _COMPRESSORS[compressmethod].compressor_file(
+            filename, compresslevel=compresslevel)
+        return _buffered_write_file(file_instance)
+    else:
+        file_instance = _COMPRESSORS['zlib'].compressor_file(
+            filename, compresslevel=compresslevel)
+        return _buffered_write_file(file_instance)
+
+
+# Utility functions/variables from numpy required for writing arrays.
+# We need at least the functions introduced in version 1.9 of numpy. Here,
+# we use the ones from numpy 1.10.2.
+BUFFER_SIZE = 2 ** 18  # size of buffer for reading npz files in bytes
+
+
+def _read_bytes(fp, size, error_template="ran out of data"):
+    """Read from file-like object until size bytes are read.
+
+    TODO python2_drop: is it still needed? The docstring mentions python 2.6
+    and it looks like this can be at least simplified ...
+
+    Raises ValueError if not EOF is encountered before size bytes are read.
+    Non-blocking objects only supported if they derive from io objects.
+
+    Required as e.g. ZipExtFile in python 2.6 can return less data than
+    requested.
+
+    This function was taken from numpy/lib/format.py in version 1.10.2.
+
+    Parameters
+    ----------
+    fp: file-like object
+    size: int
+    error_template: str
+
+    Returns
+    -------
+    a bytes object
+        The data read in bytes.
+
+    """
+    data = bytes()
+    while True:
+        # io files (default in python3) return None or raise on
+        # would-block, python2 file will truncate, probably nothing can be
+        # done about that.  note that regular files can't be non-blocking
+        try:
+            r = fp.read(size - len(data))
+            data += r
+            if len(r) == 0 or len(data) == size:
+                break
+        except io.BlockingIOError:
+            pass
+    if len(data) != size:
+        msg = "EOF: reading %s, expected %d bytes got %d"
+        raise ValueError(msg % (error_template, size, len(data)))
+    else:
+        return data
diff --git a/llm/Lib/site-packages/joblib/parallel.py b/llm/Lib/site-packages/joblib/parallel.py
new file mode 100644
index 0000000000000000000000000000000000000000..e42385df86cc8348d6b1e30b6c8dc5aecff9a8a6
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/parallel.py
@@ -0,0 +1,2010 @@
+"""
+Helpers for embarrassingly parallel code.
+"""
+# Author: Gael Varoquaux < gael dot varoquaux at normalesup dot org >
+# Copyright: 2010, Gael Varoquaux
+# License: BSD 3 clause
+
+from __future__ import division
+
+import os
+import sys
+from math import sqrt
+import functools
+import collections
+import time
+import threading
+import itertools
+from uuid import uuid4
+from numbers import Integral
+import warnings
+import queue
+import weakref
+from contextlib import nullcontext
+
+from multiprocessing import TimeoutError
+
+from ._multiprocessing_helpers import mp
+
+from .logger import Logger, short_format_time
+from .disk import memstr_to_bytes
+from ._parallel_backends import (FallbackToBackend, MultiprocessingBackend,
+                                 ThreadingBackend, SequentialBackend,
+                                 LokyBackend)
+from ._utils import eval_expr, _Sentinel
+
+# Make sure that those two classes are part of the public joblib.parallel API
+# so that 3rd party backend implementers can import them from here.
+from ._parallel_backends import AutoBatchingMixin  # noqa
+from ._parallel_backends import ParallelBackendBase  # noqa
+
+
+IS_PYPY = hasattr(sys, "pypy_version_info")
+
+
+BACKENDS = {
+    'threading': ThreadingBackend,
+    'sequential': SequentialBackend,
+}
+# name of the backend used by default by Parallel outside of any context
+# managed by ``parallel_config`` or ``parallel_backend``.
+
+# threading is the only backend that is always everywhere
+DEFAULT_BACKEND = 'threading'
+
+MAYBE_AVAILABLE_BACKENDS = {'multiprocessing', 'loky'}
+
+# if multiprocessing is available, so is loky, we set it as the default
+# backend
+if mp is not None:
+    BACKENDS['multiprocessing'] = MultiprocessingBackend
+    from .externals import loky
+    BACKENDS['loky'] = LokyBackend
+    DEFAULT_BACKEND = 'loky'
+
+
+DEFAULT_THREAD_BACKEND = 'threading'
+
+
+# Thread local value that can be overridden by the ``parallel_config`` context
+# manager
+_backend = threading.local()
+
+
+def _register_dask():
+    """Register Dask Backend if called with parallel_config(backend="dask")"""
+    try:
+        from ._dask import DaskDistributedBackend
+        register_parallel_backend('dask', DaskDistributedBackend)
+    except ImportError as e:
+        msg = ("To use the dask.distributed backend you must install both "
+               "the `dask` and distributed modules.\n\n"
+               "See https://dask.pydata.org/en/latest/install.html for more "
+               "information.")
+        raise ImportError(msg) from e
+
+
+EXTERNAL_BACKENDS = {
+    'dask': _register_dask,
+}
+
+
+# Sentinels for the default values of the Parallel constructor and
+# the parallel_config and parallel_backend context managers
+default_parallel_config = {
+    "backend": _Sentinel(default_value=None),
+    "n_jobs": _Sentinel(default_value=None),
+    "verbose": _Sentinel(default_value=0),
+    "temp_folder": _Sentinel(default_value=None),
+    "max_nbytes": _Sentinel(default_value="1M"),
+    "mmap_mode": _Sentinel(default_value="r"),
+    "prefer": _Sentinel(default_value=None),
+    "require": _Sentinel(default_value=None),
+}
+
+
+VALID_BACKEND_HINTS = ('processes', 'threads', None)
+VALID_BACKEND_CONSTRAINTS = ('sharedmem', None)
+
+
+def _get_config_param(param, context_config, key):
+    """Return the value of a parallel config parameter
+
+    Explicitly setting it in Parallel has priority over setting in a
+    parallel_(config/backend) context manager.
+    """
+    if param is not default_parallel_config[key]:
+        # param is explicitely set, return it
+        return param
+
+    if context_config[key] is not default_parallel_config[key]:
+        # there's a context manager and the key is set, return it
+        return context_config[key]
+
+    # Otherwise, we are in the default_parallel_config,
+    # return the default value
+    return param.default_value
+
+
+def get_active_backend(
+    prefer=default_parallel_config["prefer"],
+    require=default_parallel_config["require"],
+    verbose=default_parallel_config["verbose"],
+):
+    """Return the active default backend"""
+    backend, config = _get_active_backend(prefer, require, verbose)
+    n_jobs = _get_config_param(
+        default_parallel_config['n_jobs'], config, "n_jobs"
+    )
+    return backend, n_jobs
+
+
+def _get_active_backend(
+    prefer=default_parallel_config["prefer"],
+    require=default_parallel_config["require"],
+    verbose=default_parallel_config["verbose"],
+):
+    """Return the active default backend"""
+
+    backend_config = getattr(_backend, "config", default_parallel_config)
+
+    backend = _get_config_param(
+        default_parallel_config['backend'], backend_config, "backend"
+    )
+    prefer = _get_config_param(prefer, backend_config, "prefer")
+    require = _get_config_param(require, backend_config, "require")
+    verbose = _get_config_param(verbose, backend_config, "verbose")
+
+    if prefer not in VALID_BACKEND_HINTS:
+        raise ValueError(
+            f"prefer={prefer} is not a valid backend hint, "
+            f"expected one of {VALID_BACKEND_HINTS}"
+        )
+    if require not in VALID_BACKEND_CONSTRAINTS:
+        raise ValueError(
+            f"require={require} is not a valid backend constraint, "
+            f"expected one of {VALID_BACKEND_CONSTRAINTS}"
+        )
+    if prefer == 'processes' and require == 'sharedmem':
+        raise ValueError(
+            "prefer == 'processes' and require == 'sharedmem'"
+            " are inconsistent settings"
+        )
+
+    explicit_backend = True
+    if backend is None:
+
+        # We are either outside of the scope of any parallel_(config/backend)
+        # context manager or the context manager did not set a backend.
+        # create the default backend instance now.
+        backend = BACKENDS[DEFAULT_BACKEND](nesting_level=0)
+        explicit_backend = False
+
+    # Try to use the backend set by the user with the context manager.
+
+    nesting_level = backend.nesting_level
+    uses_threads = getattr(backend, 'uses_threads', False)
+    supports_sharedmem = getattr(backend, 'supports_sharedmem', False)
+    # Force to use thread-based backend if the provided backend does not
+    # match the shared memory constraint or if the backend is not explicitely
+    # given and threads are prefered.
+    force_threads = (require == 'sharedmem' and not supports_sharedmem)
+    force_threads |= (
+        not explicit_backend and prefer == 'threads' and not uses_threads
+    )
+    if force_threads:
+        # This backend does not match the shared memory constraint:
+        # fallback to the default thead-based backend.
+        sharedmem_backend = BACKENDS[DEFAULT_THREAD_BACKEND](
+            nesting_level=nesting_level
+        )
+        # Warn the user if we forced the backend to thread-based, while the
+        # user explicitely specified a non-thread-based backend.
+        if verbose >= 10 and explicit_backend:
+            print(
+                f"Using {sharedmem_backend.__class__.__name__} as "
+                f"joblib backend instead of {backend.__class__.__name__} "
+                "as the latter does not provide shared memory semantics."
+            )
+        # Force to n_jobs=1 by default
+        thread_config = backend_config.copy()
+        thread_config['n_jobs'] = 1
+        return sharedmem_backend, thread_config
+
+    return backend, backend_config
+
+
+class parallel_config:
+    """Set the default backend or configuration for :class:`~joblib.Parallel`.
+
+    This is an alternative to directly passing keyword arguments to the
+    :class:`~joblib.Parallel` class constructor. It is particularly useful when
+    calling into library code that uses joblib internally but does not expose
+    the various parallel configuration arguments in its own API.
+
+    Parameters
+    ----------
+    backend: str or ParallelBackendBase instance, default=None
+        If ``backend`` is a string it must match a previously registered
+        implementation using the :func:`~register_parallel_backend` function.
+
+        By default the following backends are available:
+
+        - 'loky': single-host, process-based parallelism (used by default),
+        - 'threading': single-host, thread-based parallelism,
+        - 'multiprocessing': legacy single-host, process-based parallelism.
+
+        'loky' is recommended to run functions that manipulate Python objects.
+        'threading' is a low-overhead alternative that is most efficient for
+        functions that release the Global Interpreter Lock: e.g. I/O-bound
+        code or CPU-bound code in a few calls to native code that explicitly
+        releases the GIL. Note that on some rare systems (such as pyodide),
+        multiprocessing and loky may not be available, in which case joblib
+        defaults to threading.
+
+        In addition, if the ``dask`` and ``distributed`` Python packages are
+        installed, it is possible to use the 'dask' backend for better
+        scheduling of nested parallel calls without over-subscription and
+        potentially distribute parallel calls over a networked cluster of
+        several hosts.
+
+        It is also possible to use the distributed 'ray' backend for
+        distributing the workload to a cluster of nodes. See more details
+        in the Examples section below.
+
+        Alternatively the backend can be passed directly as an instance.
+
+    n_jobs: int, default=None
+        The maximum number of concurrently running jobs, such as the number
+        of Python worker processes when ``backend="loky"`` or the size of the
+        thread-pool when ``backend="threading"``.
+        This argument is converted to an integer, rounded below for float.
+        If -1 is given, `joblib` tries to use all CPUs. The number of CPUs
+        ``n_cpus`` is obtained with :func:`~cpu_count`.
+        For n_jobs below -1, (n_cpus + 1 + n_jobs) are used. For instance,
+        using ``n_jobs=-2`` will result in all CPUs but one being used.
+        This argument can also go above ``n_cpus``, which will cause
+        oversubscription. In some cases, slight oversubscription can be
+        beneficial, e.g., for tasks with large I/O operations.
+        If 1 is given, no parallel computing code is used at all, and the
+        behavior amounts to a simple python `for` loop. This mode is not
+        compatible with `timeout`.
+        None is a marker for 'unset' that will be interpreted as n_jobs=1
+        unless the call is performed under a :func:`~parallel_config`
+        context manager that sets another value for ``n_jobs``.
+        If n_jobs = 0 then a ValueError is raised.
+
+    verbose: int, default=0
+        The verbosity level: if non zero, progress messages are
+        printed. Above 50, the output is sent to stdout.
+        The frequency of the messages increases with the verbosity level.
+        If it more than 10, all iterations are reported.
+
+    temp_folder: str or None, default=None
+        Folder to be used by the pool for memmapping large arrays
+        for sharing memory with worker processes. If None, this will try in
+        order:
+
+        - a folder pointed by the ``JOBLIB_TEMP_FOLDER`` environment
+          variable,
+        - ``/dev/shm`` if the folder exists and is writable: this is a
+          RAM disk filesystem available by default on modern Linux
+          distributions,
+        - the default system temporary folder that can be
+          overridden with ``TMP``, ``TMPDIR`` or ``TEMP`` environment
+          variables, typically ``/tmp`` under Unix operating systems.
+
+    max_nbytes int, str, or None, optional, default='1M'
+        Threshold on the size of arrays passed to the workers that
+        triggers automated memory mapping in temp_folder. Can be an int
+        in Bytes, or a human-readable string, e.g., '1M' for 1 megabyte.
+        Use None to disable memmapping of large arrays.
+
+    mmap_mode: {None, 'r+', 'r', 'w+', 'c'}, default='r'
+        Memmapping mode for numpy arrays passed to workers. None will
+        disable memmapping, other modes defined in the numpy.memmap doc:
+        https://numpy.org/doc/stable/reference/generated/numpy.memmap.html
+        Also, see 'max_nbytes' parameter documentation for more details.
+
+    prefer: str in {'processes', 'threads'} or None, default=None
+        Soft hint to choose the default backend.
+        The default process-based backend is 'loky' and the default
+        thread-based backend is 'threading'. Ignored if the ``backend``
+        parameter is specified.
+
+    require: 'sharedmem' or None, default=None
+        Hard constraint to select the backend. If set to 'sharedmem',
+        the selected backend will be single-host and thread-based.
+
+    inner_max_num_threads: int, default=None
+        If not None, overwrites the limit set on the number of threads
+        usable in some third-party library threadpools like OpenBLAS,
+        MKL or OpenMP. This is only used with the ``loky`` backend.
+
+    backend_params: dict
+        Additional parameters to pass to the backend constructor when
+        backend is a string.
+
+    Notes
+    -----
+    Joblib tries to limit the oversubscription by limiting the number of
+    threads usable in some third-party library threadpools like OpenBLAS, MKL
+    or OpenMP. The default limit in each worker is set to
+    ``max(cpu_count() // effective_n_jobs, 1)`` but this limit can be
+    overwritten with the ``inner_max_num_threads`` argument which will be used
+    to set this limit in the child processes.
+
+    .. versionadded:: 1.3
+
+    Examples
+    --------
+    >>> from operator import neg
+    >>> with parallel_config(backend='threading'):
+    ...     print(Parallel()(delayed(neg)(i + 1) for i in range(5)))
+    ...
+    [-1, -2, -3, -4, -5]
+
+    To use the 'ray' joblib backend add the following lines:
+
+    >>> from ray.util.joblib import register_ray  # doctest: +SKIP
+    >>> register_ray()  # doctest: +SKIP
+    >>> with parallel_config(backend="ray"):  # doctest: +SKIP
+    ...     print(Parallel()(delayed(neg)(i + 1) for i in range(5)))
+    [-1, -2, -3, -4, -5]
+
+    """
+    def __init__(
+        self,
+        backend=default_parallel_config["backend"],
+        *,
+        n_jobs=default_parallel_config["n_jobs"],
+        verbose=default_parallel_config["verbose"],
+        temp_folder=default_parallel_config["temp_folder"],
+        max_nbytes=default_parallel_config["max_nbytes"],
+        mmap_mode=default_parallel_config["mmap_mode"],
+        prefer=default_parallel_config["prefer"],
+        require=default_parallel_config["require"],
+        inner_max_num_threads=None,
+        **backend_params
+    ):
+        # Save the parallel info and set the active parallel config
+        self.old_parallel_config = getattr(
+            _backend, "config", default_parallel_config
+        )
+
+        backend = self._check_backend(
+            backend, inner_max_num_threads, **backend_params
+        )
+
+        new_config = {
+            "n_jobs": n_jobs,
+            "verbose": verbose,
+            "temp_folder": temp_folder,
+            "max_nbytes": max_nbytes,
+            "mmap_mode": mmap_mode,
+            "prefer": prefer,
+            "require": require,
+            "backend": backend
+        }
+        self.parallel_config = self.old_parallel_config.copy()
+        self.parallel_config.update({
+            k: v for k, v in new_config.items()
+            if not isinstance(v, _Sentinel)
+        })
+
+        setattr(_backend, "config", self.parallel_config)
+
+    def _check_backend(self, backend, inner_max_num_threads, **backend_params):
+        if backend is default_parallel_config['backend']:
+            if inner_max_num_threads is not None or len(backend_params) > 0:
+                raise ValueError(
+                    "inner_max_num_threads and other constructor "
+                    "parameters backend_params are only supported "
+                    "when backend is not None."
+                )
+            return backend
+
+        if isinstance(backend, str):
+            # Handle non-registered or missing backends
+            if backend not in BACKENDS:
+                if backend in EXTERNAL_BACKENDS:
+                    register = EXTERNAL_BACKENDS[backend]
+                    register()
+                elif backend in MAYBE_AVAILABLE_BACKENDS:
+                    warnings.warn(
+                        f"joblib backend '{backend}' is not available on "
+                        f"your system, falling back to {DEFAULT_BACKEND}.",
+                        UserWarning,
+                        stacklevel=2
+                    )
+                    BACKENDS[backend] = BACKENDS[DEFAULT_BACKEND]
+                else:
+                    raise ValueError(
+                        f"Invalid backend: {backend}, expected one of "
+                        f"{sorted(BACKENDS.keys())}"
+                    )
+
+            backend = BACKENDS[backend](**backend_params)
+
+        if inner_max_num_threads is not None:
+            msg = (
+                f"{backend.__class__.__name__} does not accept setting the "
+                "inner_max_num_threads argument."
+            )
+            assert backend.supports_inner_max_num_threads, msg
+            backend.inner_max_num_threads = inner_max_num_threads
+
+        # If the nesting_level of the backend is not set previously, use the
+        # nesting level from the previous active_backend to set it
+        if backend.nesting_level is None:
+            parent_backend = self.old_parallel_config['backend']
+            if parent_backend is default_parallel_config['backend']:
+                nesting_level = 0
+            else:
+                nesting_level = parent_backend.nesting_level
+            backend.nesting_level = nesting_level
+
+        return backend
+
+    def __enter__(self):
+        return self.parallel_config
+
+    def __exit__(self, type, value, traceback):
+        self.unregister()
+
+    def unregister(self):
+        setattr(_backend, "config", self.old_parallel_config)
+
+
+class parallel_backend(parallel_config):
+    """Change the default backend used by Parallel inside a with block.
+
+    .. warning::
+        It is advised to use the :class:`~joblib.parallel_config` context
+        manager instead, which allows more fine-grained control over the
+        backend configuration.
+
+    If ``backend`` is a string it must match a previously registered
+    implementation using the :func:`~register_parallel_backend` function.
+
+    By default the following backends are available:
+
+    - 'loky': single-host, process-based parallelism (used by default),
+    - 'threading': single-host, thread-based parallelism,
+    - 'multiprocessing': legacy single-host, process-based parallelism.
+
+    'loky' is recommended to run functions that manipulate Python objects.
+    'threading' is a low-overhead alternative that is most efficient for
+    functions that release the Global Interpreter Lock: e.g. I/O-bound code or
+    CPU-bound code in a few calls to native code that explicitly releases the
+    GIL. Note that on some rare systems (such as Pyodide),
+    multiprocessing and loky may not be available, in which case joblib
+    defaults to threading.
+
+    You can also use the `Dask <https://docs.dask.org/en/stable/>`_ joblib
+    backend to distribute work across machines. This works well with
+    scikit-learn estimators with the ``n_jobs`` parameter, for example::
+
+    >>> import joblib  # doctest: +SKIP
+    >>> from sklearn.model_selection import GridSearchCV  # doctest: +SKIP
+    >>> from dask.distributed import Client, LocalCluster # doctest: +SKIP
+
+    >>> # create a local Dask cluster
+    >>> cluster = LocalCluster()  # doctest: +SKIP
+    >>> client = Client(cluster)  # doctest: +SKIP
+    >>> grid_search = GridSearchCV(estimator, param_grid, n_jobs=-1)
+    ... # doctest: +SKIP
+    >>> with joblib.parallel_backend("dask", scatter=[X, y]):  # doctest: +SKIP
+    ...     grid_search.fit(X, y)
+
+    It is also possible to use the distributed 'ray' backend for distributing
+    the workload to a cluster of nodes. To use the 'ray' joblib backend add
+    the following lines::
+
+     >>> from ray.util.joblib import register_ray  # doctest: +SKIP
+     >>> register_ray()  # doctest: +SKIP
+     >>> with parallel_backend("ray"):  # doctest: +SKIP
+     ...     print(Parallel()(delayed(neg)(i + 1) for i in range(5)))
+     [-1, -2, -3, -4, -5]
+
+    Alternatively the backend can be passed directly as an instance.
+
+    By default all available workers will be used (``n_jobs=-1``) unless the
+    caller passes an explicit value for the ``n_jobs`` parameter.
+
+    This is an alternative to passing a ``backend='backend_name'`` argument to
+    the :class:`~Parallel` class constructor. It is particularly useful when
+    calling into library code that uses joblib internally but does not expose
+    the backend argument in its own API.
+
+    >>> from operator import neg
+    >>> with parallel_backend('threading'):
+    ...     print(Parallel()(delayed(neg)(i + 1) for i in range(5)))
+    ...
+    [-1, -2, -3, -4, -5]
+
+    Joblib also tries to limit the oversubscription by limiting the number of
+    threads usable in some third-party library threadpools like OpenBLAS, MKL
+    or OpenMP. The default limit in each worker is set to
+    ``max(cpu_count() // effective_n_jobs, 1)`` but this limit can be
+    overwritten with the ``inner_max_num_threads`` argument which will be used
+    to set this limit in the child processes.
+
+    .. versionadded:: 0.10
+
+    See Also
+    --------
+    joblib.parallel_config: context manager to change the backend
+        configuration.
+    """
+    def __init__(self, backend, n_jobs=-1, inner_max_num_threads=None,
+                 **backend_params):
+
+        super().__init__(
+            backend=backend,
+            n_jobs=n_jobs,
+            inner_max_num_threads=inner_max_num_threads,
+            **backend_params
+        )
+
+        if self.old_parallel_config is None:
+            self.old_backend_and_jobs = None
+        else:
+            self.old_backend_and_jobs = (
+                self.old_parallel_config["backend"],
+                self.old_parallel_config["n_jobs"],
+            )
+        self.new_backend_and_jobs = (
+            self.parallel_config["backend"],
+            self.parallel_config["n_jobs"],
+        )
+
+    def __enter__(self):
+        return self.new_backend_and_jobs
+
+
+# Under Linux or OS X the default start method of multiprocessing
+# can cause third party libraries to crash. Under Python 3.4+ it is possible
+# to set an environment variable to switch the default start method from
+# 'fork' to 'forkserver' or 'spawn' to avoid this issue albeit at the cost
+# of causing semantic changes and some additional pool instantiation overhead.
+DEFAULT_MP_CONTEXT = None
+if hasattr(mp, 'get_context'):
+    method = os.environ.get('JOBLIB_START_METHOD', '').strip() or None
+    if method is not None:
+        DEFAULT_MP_CONTEXT = mp.get_context(method=method)
+
+
+class BatchedCalls(object):
+    """Wrap a sequence of (func, args, kwargs) tuples as a single callable"""
+
+    def __init__(self, iterator_slice, backend_and_jobs, reducer_callback=None,
+                 pickle_cache=None):
+        self.items = list(iterator_slice)
+        self._size = len(self.items)
+        self._reducer_callback = reducer_callback
+        if isinstance(backend_and_jobs, tuple):
+            self._backend, self._n_jobs = backend_and_jobs
+        else:
+            # this is for backward compatibility purposes. Before 0.12.6,
+            # nested backends were returned without n_jobs indications.
+            self._backend, self._n_jobs = backend_and_jobs, None
+        self._pickle_cache = pickle_cache if pickle_cache is not None else {}
+
+    def __call__(self):
+        # Set the default nested backend to self._backend but do not set the
+        # change the default number of processes to -1
+        with parallel_config(backend=self._backend, n_jobs=self._n_jobs):
+            return [func(*args, **kwargs)
+                    for func, args, kwargs in self.items]
+
+    def __reduce__(self):
+        if self._reducer_callback is not None:
+            self._reducer_callback()
+        # no need to pickle the callback.
+        return (
+            BatchedCalls,
+            (self.items, (self._backend, self._n_jobs), None,
+             self._pickle_cache)
+        )
+
+    def __len__(self):
+        return self._size
+
+
+# Possible exit status for a task
+TASK_DONE = "Done"
+TASK_ERROR = "Error"
+TASK_PENDING = "Pending"
+
+
+###############################################################################
+# CPU count that works also when multiprocessing has been disabled via
+# the JOBLIB_MULTIPROCESSING environment variable
+def cpu_count(only_physical_cores=False):
+    """Return the number of CPUs.
+
+    This delegates to loky.cpu_count that takes into account additional
+    constraints such as Linux CFS scheduler quotas (typically set by container
+    runtimes such as docker) and CPU affinity (for instance using the taskset
+    command on Linux).
+
+    If only_physical_cores is True, do not take hyperthreading / SMT logical
+    cores into account.
+    """
+    if mp is None:
+        return 1
+
+    return loky.cpu_count(only_physical_cores=only_physical_cores)
+
+
+###############################################################################
+# For verbosity
+
+def _verbosity_filter(index, verbose):
+    """ Returns False for indices increasingly apart, the distance
+        depending on the value of verbose.
+
+        We use a lag increasing as the square of index
+    """
+    if not verbose:
+        return True
+    elif verbose > 10:
+        return False
+    if index == 0:
+        return False
+    verbose = .5 * (11 - verbose) ** 2
+    scale = sqrt(index / verbose)
+    next_scale = sqrt((index + 1) / verbose)
+    return (int(next_scale) == int(scale))
+
+
+###############################################################################
+def delayed(function):
+    """Decorator used to capture the arguments of a function."""
+
+    def delayed_function(*args, **kwargs):
+        return function, args, kwargs
+    try:
+        delayed_function = functools.wraps(function)(delayed_function)
+    except AttributeError:
+        " functools.wraps fails on some callable objects "
+    return delayed_function
+
+
+###############################################################################
+class BatchCompletionCallBack(object):
+    """Callback to keep track of completed results and schedule the next tasks.
+
+    This callable is executed by the parent process whenever a worker process
+    has completed a batch of tasks.
+
+    It is used for progress reporting, to update estimate of the batch
+    processing duration and to schedule the next batch of tasks to be
+    processed.
+
+    It is assumed that this callback will always be triggered by the backend
+    right after the end of a task, in case of success as well as in case of
+    failure.
+    """
+
+    ##########################################################################
+    #                   METHODS CALLED BY THE MAIN THREAD                    #
+    ##########################################################################
+    def __init__(self, dispatch_timestamp, batch_size, parallel):
+        self.dispatch_timestamp = dispatch_timestamp
+        self.batch_size = batch_size
+        self.parallel = parallel
+        self.parallel_call_id = parallel._call_id
+
+        # Internals to keep track of the status and outcome of the task.
+
+        # Used to hold a reference to the future-like object returned by the
+        # backend after launching this task
+        # This will be set later when calling `register_job`, as it is only
+        # created once the task has been submitted.
+        self.job = None
+
+        if not parallel._backend.supports_retrieve_callback:
+            # The status is only used for asynchronous result retrieval in the
+            # callback.
+            self.status = None
+        else:
+            # The initial status for the job is TASK_PENDING.
+            # Once it is done, it will be either TASK_DONE, or TASK_ERROR.
+            self.status = TASK_PENDING
+
+    def register_job(self, job):
+        """Register the object returned by `apply_async`."""
+        self.job = job
+
+    def get_result(self, timeout):
+        """Returns the raw result of the task that was submitted.
+
+        If the task raised an exception rather than returning, this same
+        exception will be raised instead.
+
+        If the backend supports the retrieval callback, it is assumed that this
+        method is only called after the result has been registered. It is
+        ensured by checking that `self.status(timeout)` does not return
+        TASK_PENDING. In this case, `get_result` directly returns the
+        registered result (or raise the registered exception).
+
+        For other backends, there are no such assumptions, but `get_result`
+        still needs to synchronously retrieve the result before it can
+        return it or raise. It will block at most `self.timeout` seconds
+        waiting for retrieval to complete, after that it raises a TimeoutError.
+        """
+
+        backend = self.parallel._backend
+
+        if backend.supports_retrieve_callback:
+            # We assume that the result has already been retrieved by the
+            # callback thread, and is stored internally. It's just waiting to
+            # be returned.
+            return self._return_or_raise()
+
+        # For other backends, the main thread needs to run the retrieval step.
+        try:
+            if backend.supports_timeout:
+                result = self.job.get(timeout=timeout)
+            else:
+                result = self.job.get()
+            outcome = dict(result=result, status=TASK_DONE)
+        except BaseException as e:
+            outcome = dict(result=e, status=TASK_ERROR)
+        self._register_outcome(outcome)
+
+        return self._return_or_raise()
+
+    def _return_or_raise(self):
+        try:
+            if self.status == TASK_ERROR:
+                raise self._result
+            return self._result
+        finally:
+            del self._result
+
+    def get_status(self, timeout):
+        """Get the status of the task.
+
+        This function also checks if the timeout has been reached and register
+        the TimeoutError outcome when it is the case.
+        """
+        if timeout is None or self.status != TASK_PENDING:
+            return self.status
+
+        # The computation are running and the status is pending.
+        # Check that we did not wait for this jobs more than `timeout`.
+        now = time.time()
+        if not hasattr(self, "_completion_timeout_counter"):
+            self._completion_timeout_counter = now
+
+        if (now - self._completion_timeout_counter) > timeout:
+            outcome = dict(result=TimeoutError(), status=TASK_ERROR)
+            self._register_outcome(outcome)
+
+        return self.status
+
+    ##########################################################################
+    #                     METHODS CALLED BY CALLBACK THREADS                 #
+    ##########################################################################
+    def __call__(self, out):
+        """Function called by the callback thread after a job is completed."""
+
+        # If the backend doesn't support callback retrievals, the next batch of
+        # tasks is dispatched regardless. The result will be retrieved by the
+        # main thread when calling `get_result`.
+        if not self.parallel._backend.supports_retrieve_callback:
+            self._dispatch_new()
+            return
+
+        # If the backend supports retrieving the result in the callback, it
+        # registers the task outcome (TASK_ERROR or TASK_DONE), and schedules
+        # the next batch if needed.
+        with self.parallel._lock:
+            # Edge case where while the task was processing, the `parallel`
+            # instance has been reset and a new call has been issued, but the
+            # worker managed to complete the task and trigger this callback
+            # call just before being aborted by the reset.
+            if self.parallel._call_id != self.parallel_call_id:
+                return
+
+            # When aborting, stop as fast as possible and do not retrieve the
+            # result as it won't be returned by the Parallel call.
+            if self.parallel._aborting:
+                return
+
+            # Retrieves the result of the task in the main process and dispatch
+            # a new batch if needed.
+            job_succeeded = self._retrieve_result(out)
+
+            if not self.parallel.return_ordered:
+                # Append the job to the queue in the order of completion
+                # instead of submission.
+                self.parallel._jobs.append(self)
+
+        if job_succeeded:
+            self._dispatch_new()
+
+    def _dispatch_new(self):
+        """Schedule the next batch of tasks to be processed."""
+
+        # This steps ensure that auto-batching works as expected.
+        this_batch_duration = time.time() - self.dispatch_timestamp
+        self.parallel._backend.batch_completed(self.batch_size,
+                                               this_batch_duration)
+
+        # Schedule the next batch of tasks.
+        with self.parallel._lock:
+            self.parallel.n_completed_tasks += self.batch_size
+            self.parallel.print_progress()
+            if self.parallel._original_iterator is not None:
+                self.parallel.dispatch_next()
+
+    def _retrieve_result(self, out):
+        """Fetch and register the outcome of a task.
+
+        Return True if the task succeeded, False otherwise.
+        This function is only called by backends that support retrieving
+        the task result in the callback thread.
+        """
+        try:
+            result = self.parallel._backend.retrieve_result_callback(out)
+            outcome = dict(status=TASK_DONE, result=result)
+        except BaseException as e:
+            # Avoid keeping references to parallel in the error.
+            e.__traceback__ = None
+            outcome = dict(result=e, status=TASK_ERROR)
+
+        self._register_outcome(outcome)
+        return outcome['status'] != TASK_ERROR
+
+    ##########################################################################
+    #            This method can be called either in the main thread         #
+    #                        or in the callback thread.                      #
+    ##########################################################################
+    def _register_outcome(self, outcome):
+        """Register the outcome of a task.
+
+        This method can be called only once, future calls will be ignored.
+        """
+        # Covers the edge case where the main thread tries to register a
+        # `TimeoutError` while the callback thread tries to register a result
+        # at the same time.
+        with self.parallel._lock:
+            if self.status not in (TASK_PENDING, None):
+                return
+            self.status = outcome["status"]
+
+        self._result = outcome["result"]
+
+        # Once the result and the status are extracted, the last reference to
+        # the job can be deleted.
+        self.job = None
+
+        # As soon as an error as been spotted, early stopping flags are sent to
+        # the `parallel` instance.
+        if self.status == TASK_ERROR:
+            self.parallel._exception = True
+            self.parallel._aborting = True
+
+
+###############################################################################
+def register_parallel_backend(name, factory, make_default=False):
+    """Register a new Parallel backend factory.
+
+    The new backend can then be selected by passing its name as the backend
+    argument to the :class:`~Parallel` class. Moreover, the default backend can
+    be overwritten globally by setting make_default=True.
+
+    The factory can be any callable that takes no argument and return an
+    instance of ``ParallelBackendBase``.
+
+    Warning: this function is experimental and subject to change in a future
+    version of joblib.
+
+    .. versionadded:: 0.10
+    """
+    BACKENDS[name] = factory
+    if make_default:
+        global DEFAULT_BACKEND
+        DEFAULT_BACKEND = name
+
+
+def effective_n_jobs(n_jobs=-1):
+    """Determine the number of jobs that can actually run in parallel
+
+    n_jobs is the number of workers requested by the callers. Passing n_jobs=-1
+    means requesting all available workers for instance matching the number of
+    CPU cores on the worker host(s).
+
+    This method should return a guesstimate of the number of workers that can
+    actually perform work concurrently with the currently enabled default
+    backend. The primary use case is to make it possible for the caller to know
+    in how many chunks to slice the work.
+
+    In general working on larger data chunks is more efficient (less scheduling
+    overhead and better use of CPU cache prefetching heuristics) as long as all
+    the workers have enough work to do.
+
+    Warning: this function is experimental and subject to change in a future
+    version of joblib.
+
+    .. versionadded:: 0.10
+    """
+    if n_jobs == 1:
+        return 1
+
+    backend, backend_n_jobs = get_active_backend()
+    if n_jobs is None:
+        n_jobs = backend_n_jobs
+    return backend.effective_n_jobs(n_jobs=n_jobs)
+
+
+###############################################################################
+class Parallel(Logger):
+    ''' Helper class for readable parallel mapping.
+
+        Read more in the :ref:`User Guide <parallel>`.
+
+        Parameters
+        ----------
+        n_jobs: int, default=None
+            The maximum number of concurrently running jobs, such as the number
+            of Python worker processes when ``backend="loky"`` or the size of
+            the thread-pool when ``backend="threading"``.
+            This argument is converted to an integer, rounded below for float.
+            If -1 is given, `joblib` tries to use all CPUs. The number of CPUs
+            ``n_cpus`` is obtained with :func:`~cpu_count`.
+            For n_jobs below -1, (n_cpus + 1 + n_jobs) are used. For instance,
+            using ``n_jobs=-2`` will result in all CPUs but one being used.
+            This argument can also go above ``n_cpus``, which will cause
+            oversubscription. In some cases, slight oversubscription can be
+            beneficial, e.g., for tasks with large I/O operations.
+            If 1 is given, no parallel computing code is used at all, and the
+            behavior amounts to a simple python `for` loop. This mode is not
+            compatible with ``timeout``.
+            None is a marker for 'unset' that will be interpreted as n_jobs=1
+            unless the call is performed under a :func:`~parallel_config`
+            context manager that sets another value for ``n_jobs``.
+            If n_jobs = 0 then a ValueError is raised.
+        backend: str, ParallelBackendBase instance or None, default='loky'
+            Specify the parallelization backend implementation.
+            Supported backends are:
+
+            - "loky" used by default, can induce some
+              communication and memory overhead when exchanging input and
+              output data with the worker Python processes. On some rare
+              systems (such as Pyiodide), the loky backend may not be
+              available.
+            - "multiprocessing" previous process-based backend based on
+              `multiprocessing.Pool`. Less robust than `loky`.
+            - "threading" is a very low-overhead backend but it suffers
+              from the Python Global Interpreter Lock if the called function
+              relies a lot on Python objects. "threading" is mostly useful
+              when the execution bottleneck is a compiled extension that
+              explicitly releases the GIL (for instance a Cython loop wrapped
+              in a "with nogil" block or an expensive call to a library such
+              as NumPy).
+            - finally, you can register backends by calling
+              :func:`~register_parallel_backend`. This will allow you to
+              implement a backend of your liking.
+
+            It is not recommended to hard-code the backend name in a call to
+            :class:`~Parallel` in a library. Instead it is recommended to set
+            soft hints (prefer) or hard constraints (require) so as to make it
+            possible for library users to change the backend from the outside
+            using the :func:`~parallel_config` context manager.
+        return_as: str in {'list', 'generator', 'generator_unordered'}, default='list'
+            If 'list', calls to this instance will return a list, only when
+            all results have been processed and retrieved.
+            If 'generator', it will return a generator that yields the results
+            as soon as they are available, in the order the tasks have been
+            submitted with.
+            If 'generator_unordered', the generator will immediately yield
+            available results independently of the submission order. The output
+            order is not deterministic in this case because it depends on the
+            concurrency of the workers.
+        prefer: str in {'processes', 'threads'} or None, default=None
+            Soft hint to choose the default backend if no specific backend
+            was selected with the :func:`~parallel_config` context manager.
+            The default process-based backend is 'loky' and the default
+            thread-based backend is 'threading'. Ignored if the ``backend``
+            parameter is specified.
+        require: 'sharedmem' or None, default=None
+            Hard constraint to select the backend. If set to 'sharedmem',
+            the selected backend will be single-host and thread-based even
+            if the user asked for a non-thread based backend with
+            :func:`~joblib.parallel_config`.
+        verbose: int, default=0
+            The verbosity level: if non zero, progress messages are
+            printed. Above 50, the output is sent to stdout.
+            The frequency of the messages increases with the verbosity level.
+            If it more than 10, all iterations are reported.
+        timeout: float or None, default=None
+            Timeout limit for each task to complete.  If any task takes longer
+            a TimeOutError will be raised. Only applied when n_jobs != 1
+        pre_dispatch: {'all', integer, or expression, as in '3*n_jobs'}, default='2*n_jobs'
+            The number of batches (of tasks) to be pre-dispatched.
+            Default is '2*n_jobs'. When batch_size="auto" this is reasonable
+            default and the workers should never starve. Note that only basic
+            arithmetics are allowed here and no modules can be used in this
+            expression.
+        batch_size: int or 'auto', default='auto'
+            The number of atomic tasks to dispatch at once to each
+            worker. When individual evaluations are very fast, dispatching
+            calls to workers can be slower than sequential computation because
+            of the overhead. Batching fast computations together can mitigate
+            this.
+            The ``'auto'`` strategy keeps track of the time it takes for a
+            batch to complete, and dynamically adjusts the batch size to keep
+            the time on the order of half a second, using a heuristic. The
+            initial batch size is 1.
+            ``batch_size="auto"`` with ``backend="threading"`` will dispatch
+            batches of a single task at a time as the threading backend has
+            very little overhead and using larger batch size has not proved to
+            bring any gain in that case.
+        temp_folder: str or None, default=None
+            Folder to be used by the pool for memmapping large arrays
+            for sharing memory with worker processes. If None, this will try in
+            order:
+
+            - a folder pointed by the JOBLIB_TEMP_FOLDER environment
+              variable,
+            - /dev/shm if the folder exists and is writable: this is a
+              RAM disk filesystem available by default on modern Linux
+              distributions,
+            - the default system temporary folder that can be
+              overridden with TMP, TMPDIR or TEMP environment
+              variables, typically /tmp under Unix operating systems.
+
+            Only active when ``backend="loky"`` or ``"multiprocessing"``.
+        max_nbytes int, str, or None, optional, default='1M'
+            Threshold on the size of arrays passed to the workers that
+            triggers automated memory mapping in temp_folder. Can be an int
+            in Bytes, or a human-readable string, e.g., '1M' for 1 megabyte.
+            Use None to disable memmapping of large arrays.
+            Only active when ``backend="loky"`` or ``"multiprocessing"``.
+        mmap_mode: {None, 'r+', 'r', 'w+', 'c'}, default='r'
+            Memmapping mode for numpy arrays passed to workers. None will
+            disable memmapping, other modes defined in the numpy.memmap doc:
+            https://numpy.org/doc/stable/reference/generated/numpy.memmap.html
+            Also, see 'max_nbytes' parameter documentation for more details.
+
+        Notes
+        -----
+
+        This object uses workers to compute in parallel the application of a
+        function to many different arguments. The main functionality it brings
+        in addition to using the raw multiprocessing or concurrent.futures API
+        are (see examples for details):
+
+        * More readable code, in particular since it avoids
+          constructing list of arguments.
+
+        * Easier debugging:
+            - informative tracebacks even when the error happens on
+              the client side
+            - using 'n_jobs=1' enables to turn off parallel computing
+              for debugging without changing the codepath
+            - early capture of pickling errors
+
+        * An optional progress meter.
+
+        * Interruption of multiprocesses jobs with 'Ctrl-C'
+
+        * Flexible pickling control for the communication to and from
+          the worker processes.
+
+        * Ability to use shared memory efficiently with worker
+          processes for large numpy-based datastructures.
+
+        Note that the intended usage is to run one call at a time. Multiple
+        calls to the same Parallel object will result in a ``RuntimeError``
+
+        Examples
+        --------
+
+        A simple example:
+
+        >>> from math import sqrt
+        >>> from joblib import Parallel, delayed
+        >>> Parallel(n_jobs=1)(delayed(sqrt)(i**2) for i in range(10))
+        [0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0]
+
+        Reshaping the output when the function has several return
+        values:
+
+        >>> from math import modf
+        >>> from joblib import Parallel, delayed
+        >>> r = Parallel(n_jobs=1)(delayed(modf)(i/2.) for i in range(10))
+        >>> res, i = zip(*r)
+        >>> res
+        (0.0, 0.5, 0.0, 0.5, 0.0, 0.5, 0.0, 0.5, 0.0, 0.5)
+        >>> i
+        (0.0, 0.0, 1.0, 1.0, 2.0, 2.0, 3.0, 3.0, 4.0, 4.0)
+
+        The progress meter: the higher the value of `verbose`, the more
+        messages:
+
+        >>> from time import sleep
+        >>> from joblib import Parallel, delayed
+        >>> r = Parallel(n_jobs=2, verbose=10)(
+        ...     delayed(sleep)(.2) for _ in range(10)) #doctest: +SKIP
+        [Parallel(n_jobs=2)]: Done   1 tasks      | elapsed:    0.6s
+        [Parallel(n_jobs=2)]: Done   4 tasks      | elapsed:    0.8s
+        [Parallel(n_jobs=2)]: Done  10 out of  10 | elapsed:    1.4s finished
+
+        Traceback example, note how the line of the error is indicated
+        as well as the values of the parameter passed to the function that
+        triggered the exception, even though the traceback happens in the
+        child process:
+
+        >>> from heapq import nlargest
+        >>> from joblib import Parallel, delayed
+        >>> Parallel(n_jobs=2)(
+        ... delayed(nlargest)(2, n) for n in (range(4), 'abcde', 3))
+        ... # doctest: +SKIP
+        -----------------------------------------------------------------------
+        Sub-process traceback:
+        -----------------------------------------------------------------------
+        TypeError                                      Mon Nov 12 11:37:46 2012
+        PID: 12934                                Python 2.7.3: /usr/bin/python
+        ........................................................................
+        /usr/lib/python2.7/heapq.pyc in nlargest(n=2, iterable=3, key=None)
+            419         if n >= size:
+            420             return sorted(iterable, key=key, reverse=True)[:n]
+            421
+            422     # When key is none, use simpler decoration
+            423     if key is None:
+        --> 424         it = izip(iterable, count(0,-1))           # decorate
+            425         result = _nlargest(n, it)
+            426         return map(itemgetter(0), result)          # undecorate
+            427
+            428     # General case, slowest method
+         TypeError: izip argument #1 must support iteration
+        _______________________________________________________________________
+
+
+        Using pre_dispatch in a producer/consumer situation, where the
+        data is generated on the fly. Note how the producer is first
+        called 3 times before the parallel loop is initiated, and then
+        called to generate new data on the fly:
+
+        >>> from math import sqrt
+        >>> from joblib import Parallel, delayed
+        >>> def producer():
+        ...     for i in range(6):
+        ...         print('Produced %s' % i)
+        ...         yield i
+        >>> out = Parallel(n_jobs=2, verbose=100, pre_dispatch='1.5*n_jobs')(
+        ...     delayed(sqrt)(i) for i in producer()) #doctest: +SKIP
+        Produced 0
+        Produced 1
+        Produced 2
+        [Parallel(n_jobs=2)]: Done 1 jobs     | elapsed:  0.0s
+        Produced 3
+        [Parallel(n_jobs=2)]: Done 2 jobs     | elapsed:  0.0s
+        Produced 4
+        [Parallel(n_jobs=2)]: Done 3 jobs     | elapsed:  0.0s
+        Produced 5
+        [Parallel(n_jobs=2)]: Done 4 jobs     | elapsed:  0.0s
+        [Parallel(n_jobs=2)]: Done 6 out of 6 | elapsed:  0.0s remaining: 0.0s
+        [Parallel(n_jobs=2)]: Done 6 out of 6 | elapsed:  0.0s finished
+
+    '''  # noqa: E501
+    def __init__(
+        self,
+        n_jobs=default_parallel_config["n_jobs"],
+        backend=default_parallel_config['backend'],
+        return_as="list",
+        verbose=default_parallel_config["verbose"],
+        timeout=None,
+        pre_dispatch='2 * n_jobs',
+        batch_size='auto',
+        temp_folder=default_parallel_config["temp_folder"],
+        max_nbytes=default_parallel_config["max_nbytes"],
+        mmap_mode=default_parallel_config["mmap_mode"],
+        prefer=default_parallel_config["prefer"],
+        require=default_parallel_config["require"],
+    ):
+        # Initiate parent Logger class state
+        super().__init__()
+
+        # Interpret n_jobs=None as 'unset'
+        if n_jobs is None:
+            n_jobs = default_parallel_config["n_jobs"]
+
+        active_backend, context_config = _get_active_backend(
+            prefer=prefer, require=require, verbose=verbose
+        )
+
+        nesting_level = active_backend.nesting_level
+
+        self.verbose = _get_config_param(verbose, context_config, "verbose")
+        self.timeout = timeout
+        self.pre_dispatch = pre_dispatch
+
+        if return_as not in {"list", "generator", "generator_unordered"}:
+            raise ValueError(
+                'Expected `return_as` parameter to be a string equal to "list"'
+                f',"generator" or "generator_unordered", but got {return_as} '
+                "instead."
+            )
+        self.return_as = return_as
+        self.return_generator = return_as != "list"
+        self.return_ordered = return_as != "generator_unordered"
+
+        # Check if we are under a parallel_config or parallel_backend
+        # context manager and use the config from the context manager
+        # for arguments that are not explicitly set.
+        self._backend_args = {
+            k: _get_config_param(param, context_config, k) for param, k in [
+                (max_nbytes, "max_nbytes"),
+                (temp_folder, "temp_folder"),
+                (mmap_mode, "mmap_mode"),
+                (prefer, "prefer"),
+                (require, "require"),
+                (verbose, "verbose"),
+            ]
+        }
+
+        if isinstance(self._backend_args["max_nbytes"], str):
+            self._backend_args["max_nbytes"] = memstr_to_bytes(
+                self._backend_args["max_nbytes"]
+            )
+        self._backend_args["verbose"] = max(
+            0, self._backend_args["verbose"] - 50
+        )
+
+        if DEFAULT_MP_CONTEXT is not None:
+            self._backend_args['context'] = DEFAULT_MP_CONTEXT
+        elif hasattr(mp, "get_context"):
+            self._backend_args['context'] = mp.get_context()
+
+        if backend is default_parallel_config['backend'] or backend is None:
+            backend = active_backend
+
+        elif isinstance(backend, ParallelBackendBase):
+            # Use provided backend as is, with the current nesting_level if it
+            # is not set yet.
+            if backend.nesting_level is None:
+                backend.nesting_level = nesting_level
+
+        elif hasattr(backend, 'Pool') and hasattr(backend, 'Lock'):
+            # Make it possible to pass a custom multiprocessing context as
+            # backend to change the start method to forkserver or spawn or
+            # preload modules on the forkserver helper process.
+            self._backend_args['context'] = backend
+            backend = MultiprocessingBackend(nesting_level=nesting_level)
+
+        elif backend not in BACKENDS and backend in MAYBE_AVAILABLE_BACKENDS:
+            warnings.warn(
+                f"joblib backend '{backend}' is not available on "
+                f"your system, falling back to {DEFAULT_BACKEND}.",
+                UserWarning,
+                stacklevel=2)
+            BACKENDS[backend] = BACKENDS[DEFAULT_BACKEND]
+            backend = BACKENDS[DEFAULT_BACKEND](nesting_level=nesting_level)
+
+        else:
+            try:
+                backend_factory = BACKENDS[backend]
+            except KeyError as e:
+                raise ValueError("Invalid backend: %s, expected one of %r"
+                                 % (backend, sorted(BACKENDS.keys()))) from e
+            backend = backend_factory(nesting_level=nesting_level)
+
+        n_jobs = _get_config_param(n_jobs, context_config, "n_jobs")
+        if n_jobs is None:
+            # No specific context override and no specific value request:
+            # default to the default of the backend.
+            n_jobs = backend.default_n_jobs
+        try:
+            n_jobs = int(n_jobs)
+        except ValueError:
+            raise ValueError("n_jobs could not be converted to int")
+        self.n_jobs = n_jobs
+
+        if (require == 'sharedmem' and
+                not getattr(backend, 'supports_sharedmem', False)):
+            raise ValueError("Backend %s does not support shared memory"
+                             % backend)
+
+        if (batch_size == 'auto' or isinstance(batch_size, Integral) and
+                batch_size > 0):
+            self.batch_size = batch_size
+        else:
+            raise ValueError(
+                "batch_size must be 'auto' or a positive integer, got: %r"
+                % batch_size)
+
+        if not isinstance(backend, SequentialBackend):
+            if self.return_generator and not backend.supports_return_generator:
+                raise ValueError(
+                    "Backend {} does not support "
+                    "return_as={}".format(backend, return_as)
+                )
+            # This lock is used to coordinate the main thread of this process
+            # with the async callback thread of our the pool.
+            self._lock = threading.RLock()
+            self._jobs = collections.deque()
+            self._pending_outputs = list()
+            self._ready_batches = queue.Queue()
+            self._reducer_callback = None
+
+        # Internal variables
+        self._backend = backend
+        self._running = False
+        self._managed_backend = False
+        self._id = uuid4().hex
+        self._call_ref = None
+
+    def __enter__(self):
+        self._managed_backend = True
+        self._calling = False
+        self._initialize_backend()
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        self._managed_backend = False
+        if self.return_generator and self._calling:
+            self._abort()
+        self._terminate_and_reset()
+
+    def _initialize_backend(self):
+        """Build a process or thread pool and return the number of workers"""
+        try:
+            n_jobs = self._backend.configure(n_jobs=self.n_jobs, parallel=self,
+                                             **self._backend_args)
+            if self.timeout is not None and not self._backend.supports_timeout:
+                warnings.warn(
+                    'The backend class {!r} does not support timeout. '
+                    "You have set 'timeout={}' in Parallel but "
+                    "the 'timeout' parameter will not be used.".format(
+                        self._backend.__class__.__name__,
+                        self.timeout))
+
+        except FallbackToBackend as e:
+            # Recursively initialize the backend in case of requested fallback.
+            self._backend = e.backend
+            n_jobs = self._initialize_backend()
+
+        return n_jobs
+
+    def _effective_n_jobs(self):
+        if self._backend:
+            return self._backend.effective_n_jobs(self.n_jobs)
+        return 1
+
+    def _terminate_and_reset(self):
+        if hasattr(self._backend, 'stop_call') and self._calling:
+            self._backend.stop_call()
+        self._calling = False
+        if not self._managed_backend:
+            self._backend.terminate()
+
+    def _dispatch(self, batch):
+        """Queue the batch for computing, with or without multiprocessing
+
+        WARNING: this method is not thread-safe: it should be only called
+        indirectly via dispatch_one_batch.
+
+        """
+        # If job.get() catches an exception, it closes the queue:
+        if self._aborting:
+            return
+
+        batch_size = len(batch)
+
+        self.n_dispatched_tasks += batch_size
+        self.n_dispatched_batches += 1
+
+        dispatch_timestamp = time.time()
+
+        batch_tracker = BatchCompletionCallBack(
+            dispatch_timestamp, batch_size, self
+        )
+
+        if self.return_ordered:
+            self._jobs.append(batch_tracker)
+
+        # If return_ordered is False, the batch_tracker is not stored in the
+        # jobs queue at the time of submission. Instead, it will be appended to
+        # the queue by itself as soon as the callback is triggered to be able
+        # to return the results in the order of completion.
+
+        job = self._backend.apply_async(batch, callback=batch_tracker)
+        batch_tracker.register_job(job)
+
+    def dispatch_next(self):
+        """Dispatch more data for parallel processing
+
+        This method is meant to be called concurrently by the multiprocessing
+        callback. We rely on the thread-safety of dispatch_one_batch to protect
+        against concurrent consumption of the unprotected iterator.
+
+        """
+        if not self.dispatch_one_batch(self._original_iterator):
+            self._iterating = False
+            self._original_iterator = None
+
+    def dispatch_one_batch(self, iterator):
+        """Prefetch the tasks for the next batch and dispatch them.
+
+        The effective size of the batch is computed here.
+        If there are no more jobs to dispatch, return False, else return True.
+
+        The iterator consumption and dispatching is protected by the same
+        lock so calling this function should be thread safe.
+
+        """
+
+        if self._aborting:
+            return False
+
+        batch_size = self._get_batch_size()
+
+        with self._lock:
+            # to ensure an even distribution of the workload between workers,
+            # we look ahead in the original iterators more than batch_size
+            # tasks - However, we keep consuming only one batch at each
+            # dispatch_one_batch call. The extra tasks are stored in a local
+            # queue, _ready_batches, that is looked-up prior to re-consuming
+            # tasks from the origal iterator.
+            try:
+                tasks = self._ready_batches.get(block=False)
+            except queue.Empty:
+                # slice the iterator n_jobs * batchsize items at a time. If the
+                # slice returns less than that, then the current batchsize puts
+                # too much weight on a subset of workers, while other may end
+                # up starving. So in this case, re-scale the batch size
+                # accordingly to distribute evenly the last items between all
+                # workers.
+                n_jobs = self._cached_effective_n_jobs
+                big_batch_size = batch_size * n_jobs
+
+                try:
+                    islice = list(itertools.islice(iterator, big_batch_size))
+                except Exception as e:
+                    # Handle the fact that the generator of task raised an
+                    # exception. As this part of the code can be executed in
+                    # a thread internal to the backend, register a task with
+                    # an error that will be raised in the user's thread.
+                    if isinstance(e.__context__, queue.Empty):
+                        # Supress the cause of the exception if it is
+                        # queue.Empty to avoid cluttered traceback. Only do it
+                        # if the __context__ is really empty to avoid messing
+                        # with causes of the original error.
+                        e.__cause__ = None
+                    batch_tracker = BatchCompletionCallBack(
+                        0, batch_size, self
+                    )
+                    self._jobs.append(batch_tracker)
+                    batch_tracker._register_outcome(dict(
+                        result=e, status=TASK_ERROR
+                    ))
+                    return True
+
+                if len(islice) == 0:
+                    return False
+                elif (iterator is self._original_iterator and
+                      len(islice) < big_batch_size):
+                    # We reached the end of the original iterator (unless
+                    # iterator is the ``pre_dispatch``-long initial slice of
+                    # the original iterator) -- decrease the batch size to
+                    # account for potential variance in the batches running
+                    # time.
+                    final_batch_size = max(1, len(islice) // (10 * n_jobs))
+                else:
+                    final_batch_size = max(1, len(islice) // n_jobs)
+
+                # enqueue n_jobs batches in a local queue
+                for i in range(0, len(islice), final_batch_size):
+                    tasks = BatchedCalls(islice[i:i + final_batch_size],
+                                         self._backend.get_nested_backend(),
+                                         self._reducer_callback,
+                                         self._pickle_cache)
+                    self._ready_batches.put(tasks)
+
+                # finally, get one task.
+                tasks = self._ready_batches.get(block=False)
+            if len(tasks) == 0:
+                # No more tasks available in the iterator: tell caller to stop.
+                return False
+            else:
+                self._dispatch(tasks)
+                return True
+
+    def _get_batch_size(self):
+        """Returns the effective batch size for dispatch"""
+        if self.batch_size == 'auto':
+            return self._backend.compute_batch_size()
+        else:
+            # Fixed batch size strategy
+            return self.batch_size
+
+    def _print(self, msg):
+        """Display the message on stout or stderr depending on verbosity"""
+        # XXX: Not using the logger framework: need to
+        # learn to use logger better.
+        if not self.verbose:
+            return
+        if self.verbose < 50:
+            writer = sys.stderr.write
+        else:
+            writer = sys.stdout.write
+        writer(f"[{self}]: {msg}\n")
+
+    def _is_completed(self):
+        """Check if all tasks have been completed"""
+        return self.n_completed_tasks == self.n_dispatched_tasks and not (
+            self._iterating or self._aborting
+        )
+
+    def print_progress(self):
+        """Display the process of the parallel execution only a fraction
+           of time, controlled by self.verbose.
+        """
+
+        if not self.verbose:
+            return
+
+        elapsed_time = time.time() - self._start_time
+
+        if self._is_completed():
+            # Make sure that we get a last message telling us we are done
+            self._print(
+                f"Done {self.n_completed_tasks:3d} out of "
+                f"{self.n_completed_tasks:3d} | elapsed: "
+                f"{short_format_time(elapsed_time)} finished"
+            )
+            return
+
+        # Original job iterator becomes None once it has been fully
+        # consumed: at this point we know the total number of jobs and we are
+        # able to display an estimation of the remaining time based on already
+        # completed jobs. Otherwise, we simply display the number of completed
+        # tasks.
+        elif self._original_iterator is not None:
+            if _verbosity_filter(self.n_dispatched_batches, self.verbose):
+                return
+            self._print(
+                f"Done {self.n_completed_tasks:3d} tasks      | elapsed: "
+                f"{short_format_time(elapsed_time)}"
+            )
+        else:
+            index = self.n_completed_tasks
+            # We are finished dispatching
+            total_tasks = self.n_dispatched_tasks
+            # We always display the first loop
+            if not index == 0:
+                # Display depending on the number of remaining items
+                # A message as soon as we finish dispatching, cursor is 0
+                cursor = (total_tasks - index + 1 -
+                          self._pre_dispatch_amount)
+                frequency = (total_tasks // self.verbose) + 1
+                is_last_item = (index + 1 == total_tasks)
+                if (is_last_item or cursor % frequency):
+                    return
+            remaining_time = (elapsed_time / index) * \
+                             (self.n_dispatched_tasks - index * 1.0)
+            # only display status if remaining time is greater or equal to 0
+            self._print(
+                f"Done {index:3d} out of {total_tasks:3d} | elapsed: "
+                f"{short_format_time(elapsed_time)} remaining: "
+                f"{short_format_time(remaining_time)}"
+            )
+
+    def _abort(self):
+        # Stop dispatching new jobs in the async callback thread
+        self._aborting = True
+
+        # If the backend allows it, cancel or kill remaining running
+        # tasks without waiting for the results as we will raise
+        # the exception we got back to the caller instead of returning
+        # any result.
+        backend = self._backend
+        if (not self._aborted and hasattr(backend, 'abort_everything')):
+            # If the backend is managed externally we need to make sure
+            # to leave it in a working state to allow for future jobs
+            # scheduling.
+            ensure_ready = self._managed_backend
+            backend.abort_everything(ensure_ready=ensure_ready)
+        self._aborted = True
+
+    def _start(self, iterator, pre_dispatch):
+        # Only set self._iterating to True if at least a batch
+        # was dispatched. In particular this covers the edge
+        # case of Parallel used with an exhausted iterator. If
+        # self._original_iterator is None, then this means either
+        # that pre_dispatch == "all", n_jobs == 1 or that the first batch
+        # was very quick and its callback already dispatched all the
+        # remaining jobs.
+        self._iterating = False
+        if self.dispatch_one_batch(iterator):
+            self._iterating = self._original_iterator is not None
+
+        while self.dispatch_one_batch(iterator):
+            pass
+
+        if pre_dispatch == "all":
+            # The iterable was consumed all at once by the above for loop.
+            # No need to wait for async callbacks to trigger to
+            # consumption.
+            self._iterating = False
+
+    def _get_outputs(self, iterator, pre_dispatch):
+        """Iterator returning the tasks' output as soon as they are ready."""
+        dispatch_thread_id = threading.get_ident()
+        detach_generator_exit = False
+        try:
+            self._start(iterator, pre_dispatch)
+            # first yield returns None, for internal use only. This ensures
+            # that we enter the try/except block and start dispatching the
+            # tasks.
+            yield
+
+            with self._backend.retrieval_context():
+                yield from self._retrieve()
+
+        except GeneratorExit:
+            # The generator has been garbage collected before being fully
+            # consumed. This aborts the remaining tasks if possible and warn
+            # the user if necessary.
+            self._exception = True
+
+            # In some interpreters such as PyPy, GeneratorExit can be raised in
+            # a different thread than the one used to start the dispatch of the
+            # parallel tasks. This can lead to hang when a thread attempts to
+            # join itself. As workaround, we detach the execution of the
+            # aborting code to a dedicated thread. We then need to make sure
+            # the rest of the function does not call `_terminate_and_reset`
+            # in finally.
+            if dispatch_thread_id != threading.get_ident():
+                if not IS_PYPY:
+                    warnings.warn(
+                        "A generator produced by joblib.Parallel has been "
+                        "gc'ed in an unexpected thread. This behavior should "
+                        "not cause major -issues but to make sure, please "
+                        "report this warning and your use case at "
+                        "https://github.com/joblib/joblib/issues so it can "
+                        "be investigated."
+                    )
+
+                detach_generator_exit = True
+                _parallel = self
+
+                class _GeneratorExitThread(threading.Thread):
+                    def run(self):
+                        _parallel._abort()
+                        if _parallel.return_generator:
+                            _parallel._warn_exit_early()
+                        _parallel._terminate_and_reset()
+
+                _GeneratorExitThread(
+                    name="GeneratorExitThread"
+                ).start()
+                return
+
+            # Otherwise, we are in the thread that started the dispatch: we can
+            # safely abort the execution and warn the user.
+            self._abort()
+            if self.return_generator:
+                self._warn_exit_early()
+
+            raise
+
+        # Note: we catch any BaseException instead of just Exception instances
+        # to also include KeyboardInterrupt
+        except BaseException:
+            self._exception = True
+            self._abort()
+            raise
+        finally:
+            # Store the unconsumed tasks and terminate the workers if necessary
+            _remaining_outputs = ([] if self._exception else self._jobs)
+            self._jobs = collections.deque()
+            self._running = False
+            if not detach_generator_exit:
+                self._terminate_and_reset()
+
+        while len(_remaining_outputs) > 0:
+            batched_results = _remaining_outputs.popleft()
+            batched_results = batched_results.get_result(self.timeout)
+            for result in batched_results:
+                yield result
+
+    def _wait_retrieval(self):
+        """Return True if we need to continue retriving some tasks."""
+
+        # If the input load is still being iterated over, it means that tasks
+        # are still on the dispatch wait list and their results will need to
+        # be retrieved later on.
+        if self._iterating:
+            return True
+
+        # If some of the dispatched tasks are still being processed by the
+        # workers, wait for the compute to finish before starting retrieval
+        if self.n_completed_tasks < self.n_dispatched_tasks:
+            return True
+
+        # For backends that does not support retrieving asynchronously the
+        # result to the main process, all results must be carefully retrieved
+        # in the _retrieve loop in the main thread while the backend is alive.
+        # For other backends, the actual retrieval is done asynchronously in
+        # the callback thread, and we can terminate the backend before the
+        # `self._jobs` result list has been emptied. The remaining results
+        # will be collected in the `finally` step of the generator.
+        if not self._backend.supports_retrieve_callback:
+            if len(self._jobs) > 0:
+                return True
+
+        return False
+
+    def _retrieve(self):
+        while self._wait_retrieval():
+
+            # If the callback thread of a worker has signaled that its task
+            # triggered an exception, or if the retrieval loop has raised an
+            # exception (e.g. `GeneratorExit`), exit the loop and surface the
+            # worker traceback.
+            if self._aborting:
+                self._raise_error_fast()
+                break
+
+            # If the next job is not ready for retrieval yet, we just wait for
+            # async callbacks to progress.
+            if ((len(self._jobs) == 0) or
+                (self._jobs[0].get_status(
+                    timeout=self.timeout) == TASK_PENDING)):
+                time.sleep(0.01)
+                continue
+
+            # We need to be careful: the job list can be filling up as
+            # we empty it and Python list are not thread-safe by
+            # default hence the use of the lock
+            with self._lock:
+                batched_results = self._jobs.popleft()
+
+            # Flatten the batched results to output one output at a time
+            batched_results = batched_results.get_result(self.timeout)
+            for result in batched_results:
+                self._nb_consumed += 1
+                yield result
+
+    def _raise_error_fast(self):
+        """If we are aborting, raise if a job caused an error."""
+
+        # Find the first job whose status is TASK_ERROR if it exists.
+        with self._lock:
+            error_job = next((job for job in self._jobs
+                              if job.status == TASK_ERROR), None)
+
+        # If this error job exists, immediatly raise the error by
+        # calling get_result. This job might not exists if abort has been
+        # called directly or if the generator is gc'ed.
+        if error_job is not None:
+            error_job.get_result(self.timeout)
+
+    def _warn_exit_early(self):
+        """Warn the user if the generator is gc'ed before being consumned."""
+        ready_outputs = self.n_completed_tasks - self._nb_consumed
+        is_completed = self._is_completed()
+        msg = ""
+        if ready_outputs:
+            msg += (
+                f"{ready_outputs} tasks have been successfully executed "
+                " but not used."
+            )
+            if not is_completed:
+                msg += " Additionally, "
+
+        if not is_completed:
+            msg += (
+                f"{self.n_dispatched_tasks - self.n_completed_tasks} tasks "
+                "which were still being processed by the workers have been "
+                "cancelled."
+            )
+
+        if msg:
+            msg += (
+                " You could benefit from adjusting the input task "
+                "iterator to limit unnecessary computation time."
+            )
+
+            warnings.warn(msg)
+
+    def _get_sequential_output(self, iterable):
+        """Separate loop for sequential output.
+
+        This simplifies the traceback in case of errors and reduces the
+        overhead of calling sequential tasks with `joblib`.
+        """
+        try:
+            self._iterating = True
+            self._original_iterator = iterable
+            batch_size = self._get_batch_size()
+
+            if batch_size != 1:
+                it = iter(iterable)
+                iterable_batched = iter(
+                    lambda: tuple(itertools.islice(it, batch_size)), ()
+                )
+                iterable = (
+                    task for batch in iterable_batched for task in batch
+                )
+
+            # first yield returns None, for internal use only. This ensures
+            # that we enter the try/except block and setup the generator.
+            yield None
+
+            # Sequentially call the tasks and yield the results.
+            for func, args, kwargs in iterable:
+                self.n_dispatched_batches += 1
+                self.n_dispatched_tasks += 1
+                res = func(*args, **kwargs)
+                self.n_completed_tasks += 1
+                self.print_progress()
+                yield res
+                self._nb_consumed += 1
+        except BaseException:
+            self._exception = True
+            self._aborting = True
+            self._aborted = True
+            raise
+        finally:
+            self.print_progress()
+            self._running = False
+            self._iterating = False
+            self._original_iterator = None
+
+    def _reset_run_tracking(self):
+        """Reset the counters and flags used to track the execution."""
+
+        # Makes sur the parallel instance was not previously running in a
+        # thread-safe way.
+        with getattr(self, '_lock', nullcontext()):
+            if self._running:
+                msg = 'This Parallel instance is already running !'
+                if self.return_generator is True:
+                    msg += (
+                        " Before submitting new tasks, you must wait for the "
+                        "completion of all the previous tasks, or clean all "
+                        "references to the output generator."
+                    )
+                raise RuntimeError(msg)
+            self._running = True
+
+        # Counter to keep track of the task dispatched and completed.
+        self.n_dispatched_batches = 0
+        self.n_dispatched_tasks = 0
+        self.n_completed_tasks = 0
+
+        # Following count is incremented by one each time the user iterates
+        # on the output generator, it is used to prepare an informative
+        # warning message in case the generator is deleted before all the
+        # dispatched tasks have been consumed.
+        self._nb_consumed = 0
+
+        # Following flags are used to synchronize the threads in case one of
+        # the tasks error-out to ensure that all workers abort fast and that
+        # the backend terminates properly.
+
+        # Set to True as soon as a worker signals that a task errors-out
+        self._exception = False
+        # Set to True in case of early termination following an incident
+        self._aborting = False
+        # Set to True after abortion is complete
+        self._aborted = False
+
+    def __call__(self, iterable):
+        """Main function to dispatch parallel tasks."""
+
+        self._reset_run_tracking()
+        self._start_time = time.time()
+
+        if not self._managed_backend:
+            n_jobs = self._initialize_backend()
+        else:
+            n_jobs = self._effective_n_jobs()
+
+        if n_jobs == 1:
+            # If n_jobs==1, run the computation sequentially and return
+            # immediatly to avoid overheads.
+            output = self._get_sequential_output(iterable)
+            next(output)
+            return output if self.return_generator else list(output)
+
+        # Let's create an ID that uniquely identifies the current call. If the
+        # call is interrupted early and that the same instance is immediately
+        # re-used, this id will be used to prevent workers that were
+        # concurrently finalizing a task from the previous call to run the
+        # callback.
+        with self._lock:
+            self._call_id = uuid4().hex
+
+        # self._effective_n_jobs should be called in the Parallel.__call__
+        # thread only -- store its value in an attribute for further queries.
+        self._cached_effective_n_jobs = n_jobs
+
+        if isinstance(self._backend, LokyBackend):
+            # For the loky backend, we add a callback executed when reducing
+            # BatchCalls, that makes the loky executor use a temporary folder
+            # specific to this Parallel object when pickling temporary memmaps.
+            # This callback is necessary to ensure that several Parallel
+            # objects using the same resuable executor don't use the same
+            # temporary resources.
+
+            def _batched_calls_reducer_callback():
+                # Relevant implementation detail: the following lines, called
+                # when reducing BatchedCalls, are called in a thread-safe
+                # situation, meaning that the context of the temporary folder
+                # manager will not be changed in between the callback execution
+                # and the end of the BatchedCalls pickling. The reason is that
+                # pickling (the only place where set_current_context is used)
+                # is done from a single thread (the queue_feeder_thread).
+                self._backend._workers._temp_folder_manager.set_current_context(  # noqa
+                    self._id
+                )
+            self._reducer_callback = _batched_calls_reducer_callback
+
+        # self._effective_n_jobs should be called in the Parallel.__call__
+        # thread only -- store its value in an attribute for further queries.
+        self._cached_effective_n_jobs = n_jobs
+
+        backend_name = self._backend.__class__.__name__
+        if n_jobs == 0:
+            raise RuntimeError("%s has no active worker." % backend_name)
+
+        self._print(
+            f"Using backend {backend_name} with {n_jobs} concurrent workers."
+        )
+        if hasattr(self._backend, 'start_call'):
+            self._backend.start_call()
+
+        # Following flag prevents double calls to `backend.stop_call`.
+        self._calling = True
+
+        iterator = iter(iterable)
+        pre_dispatch = self.pre_dispatch
+
+        if pre_dispatch == 'all':
+            # prevent further dispatch via multiprocessing callback thread
+            self._original_iterator = None
+            self._pre_dispatch_amount = 0
+        else:
+            self._original_iterator = iterator
+            if hasattr(pre_dispatch, 'endswith'):
+                pre_dispatch = eval_expr(
+                    pre_dispatch.replace("n_jobs", str(n_jobs))
+                )
+            self._pre_dispatch_amount = pre_dispatch = int(pre_dispatch)
+
+            # The main thread will consume the first pre_dispatch items and
+            # the remaining items will later be lazily dispatched by async
+            # callbacks upon task completions.
+
+            # TODO: this iterator should be batch_size * n_jobs
+            iterator = itertools.islice(iterator, self._pre_dispatch_amount)
+
+        # Use a caching dict for callables that are pickled with cloudpickle to
+        # improve performances. This cache is used only in the case of
+        # functions that are defined in the __main__ module, functions that
+        # are defined locally (inside another function) and lambda expressions.
+        self._pickle_cache = dict()
+
+        output = self._get_outputs(iterator, pre_dispatch)
+        self._call_ref = weakref.ref(output)
+
+        # The first item from the output is blank, but it makes the interpreter
+        # progress until it enters the Try/Except block of the generator and
+        # reach the first `yield` statement. This starts the aynchronous
+        # dispatch of the tasks to the workers.
+        next(output)
+
+        return output if self.return_generator else list(output)
+
+    def __repr__(self):
+        return '%s(n_jobs=%s)' % (self.__class__.__name__, self.n_jobs)
diff --git a/llm/Lib/site-packages/joblib/pool.py b/llm/Lib/site-packages/joblib/pool.py
new file mode 100644
index 0000000000000000000000000000000000000000..72a6baa3ac5854ebac9f96a4c6df77b52bff300e
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/pool.py
@@ -0,0 +1,354 @@
+"""Custom implementation of multiprocessing.Pool with custom pickler.
+
+This module provides efficient ways of working with data stored in
+shared memory with numpy.memmap arrays without inducing any memory
+copy between the parent and child processes.
+
+This module should not be imported if multiprocessing is not
+available as it implements subclasses of multiprocessing Pool
+that uses a custom alternative to SimpleQueue.
+
+"""
+# Author: Olivier Grisel <olivier.grisel@ensta.org>
+# Copyright: 2012, Olivier Grisel
+# License: BSD 3 clause
+
+import copyreg
+import sys
+import warnings
+from time import sleep
+
+try:
+    WindowsError
+except NameError:
+    WindowsError = type(None)
+
+from pickle import Pickler
+
+from pickle import HIGHEST_PROTOCOL
+from io import BytesIO
+
+from ._memmapping_reducer import get_memmapping_reducers
+from ._memmapping_reducer import TemporaryResourcesManager
+from ._multiprocessing_helpers import mp, assert_spawning
+
+# We need the class definition to derive from it, not the multiprocessing.Pool
+# factory function
+from multiprocessing.pool import Pool
+
+try:
+    import numpy as np
+except ImportError:
+    np = None
+
+
+###############################################################################
+# Enable custom pickling in Pool queues
+
+class CustomizablePickler(Pickler):
+    """Pickler that accepts custom reducers.
+
+    TODO python2_drop : can this be simplified ?
+
+    HIGHEST_PROTOCOL is selected by default as this pickler is used
+    to pickle ephemeral datastructures for interprocess communication
+    hence no backward compatibility is required.
+
+    `reducers` is expected to be a dictionary with key/values
+    being `(type, callable)` pairs where `callable` is a function that
+    give an instance of `type` will return a tuple `(constructor,
+    tuple_of_objects)` to rebuild an instance out of the pickled
+    `tuple_of_objects` as would return a `__reduce__` method. See the
+    standard library documentation on pickling for more details.
+
+    """
+
+    # We override the pure Python pickler as its the only way to be able to
+    # customize the dispatch table without side effects in Python 2.7
+    # to 3.2. For Python 3.3+ leverage the new dispatch_table
+    # feature from https://bugs.python.org/issue14166 that makes it possible
+    # to use the C implementation of the Pickler which is faster.
+
+    def __init__(self, writer, reducers=None, protocol=HIGHEST_PROTOCOL):
+        Pickler.__init__(self, writer, protocol=protocol)
+        if reducers is None:
+            reducers = {}
+        if hasattr(Pickler, 'dispatch'):
+            # Make the dispatch registry an instance level attribute instead of
+            # a reference to the class dictionary under Python 2
+            self.dispatch = Pickler.dispatch.copy()
+        else:
+            # Under Python 3 initialize the dispatch table with a copy of the
+            # default registry
+            self.dispatch_table = copyreg.dispatch_table.copy()
+        for type, reduce_func in reducers.items():
+            self.register(type, reduce_func)
+
+    def register(self, type, reduce_func):
+        """Attach a reducer function to a given type in the dispatch table."""
+        if hasattr(Pickler, 'dispatch'):
+            # Python 2 pickler dispatching is not explicitly customizable.
+            # Let us use a closure to workaround this limitation.
+            def dispatcher(self, obj):
+                reduced = reduce_func(obj)
+                self.save_reduce(obj=obj, *reduced)
+            self.dispatch[type] = dispatcher
+        else:
+            self.dispatch_table[type] = reduce_func
+
+
+class CustomizablePicklingQueue(object):
+    """Locked Pipe implementation that uses a customizable pickler.
+
+    This class is an alternative to the multiprocessing implementation
+    of SimpleQueue in order to make it possible to pass custom
+    pickling reducers, for instance to avoid memory copy when passing
+    memory mapped datastructures.
+
+    `reducers` is expected to be a dict with key / values being
+    `(type, callable)` pairs where `callable` is a function that, given an
+    instance of `type`, will return a tuple `(constructor, tuple_of_objects)`
+    to rebuild an instance out of the pickled `tuple_of_objects` as would
+    return a `__reduce__` method.
+
+    See the standard library documentation on pickling for more details.
+    """
+
+    def __init__(self, context, reducers=None):
+        self._reducers = reducers
+        self._reader, self._writer = context.Pipe(duplex=False)
+        self._rlock = context.Lock()
+        if sys.platform == 'win32':
+            self._wlock = None
+        else:
+            self._wlock = context.Lock()
+        self._make_methods()
+
+    def __getstate__(self):
+        assert_spawning(self)
+        return (self._reader, self._writer, self._rlock, self._wlock,
+                self._reducers)
+
+    def __setstate__(self, state):
+        (self._reader, self._writer, self._rlock, self._wlock,
+         self._reducers) = state
+        self._make_methods()
+
+    def empty(self):
+        return not self._reader.poll()
+
+    def _make_methods(self):
+        self._recv = recv = self._reader.recv
+        racquire, rrelease = self._rlock.acquire, self._rlock.release
+
+        def get():
+            racquire()
+            try:
+                return recv()
+            finally:
+                rrelease()
+
+        self.get = get
+
+        if self._reducers:
+            def send(obj):
+                buffer = BytesIO()
+                CustomizablePickler(buffer, self._reducers).dump(obj)
+                self._writer.send_bytes(buffer.getvalue())
+            self._send = send
+        else:
+            self._send = send = self._writer.send
+        if self._wlock is None:
+            # writes to a message oriented win32 pipe are atomic
+            self.put = send
+        else:
+            wlock_acquire, wlock_release = (
+                self._wlock.acquire, self._wlock.release)
+
+            def put(obj):
+                wlock_acquire()
+                try:
+                    return send(obj)
+                finally:
+                    wlock_release()
+
+            self.put = put
+
+
+class PicklingPool(Pool):
+    """Pool implementation with customizable pickling reducers.
+
+    This is useful to control how data is shipped between processes
+    and makes it possible to use shared memory without useless
+    copies induces by the default pickling methods of the original
+    objects passed as arguments to dispatch.
+
+    `forward_reducers` and `backward_reducers` are expected to be
+    dictionaries with key/values being `(type, callable)` pairs where
+    `callable` is a function that, given an instance of `type`, will return a
+    tuple `(constructor, tuple_of_objects)` to rebuild an instance out of the
+    pickled `tuple_of_objects` as would return a `__reduce__` method.
+    See the standard library documentation about pickling for more details.
+
+    """
+
+    def __init__(self, processes=None, forward_reducers=None,
+                 backward_reducers=None, **kwargs):
+        if forward_reducers is None:
+            forward_reducers = dict()
+        if backward_reducers is None:
+            backward_reducers = dict()
+        self._forward_reducers = forward_reducers
+        self._backward_reducers = backward_reducers
+        poolargs = dict(processes=processes)
+        poolargs.update(kwargs)
+        super(PicklingPool, self).__init__(**poolargs)
+
+    def _setup_queues(self):
+        context = getattr(self, '_ctx', mp)
+        self._inqueue = CustomizablePicklingQueue(context,
+                                                  self._forward_reducers)
+        self._outqueue = CustomizablePicklingQueue(context,
+                                                   self._backward_reducers)
+        self._quick_put = self._inqueue._send
+        self._quick_get = self._outqueue._recv
+
+
+class MemmappingPool(PicklingPool):
+    """Process pool that shares large arrays to avoid memory copy.
+
+    This drop-in replacement for `multiprocessing.pool.Pool` makes
+    it possible to work efficiently with shared memory in a numpy
+    context.
+
+    Existing instances of numpy.memmap are preserved: the child
+    suprocesses will have access to the same shared memory in the
+    original mode except for the 'w+' mode that is automatically
+    transformed as 'r+' to avoid zeroing the original data upon
+    instantiation.
+
+    Furthermore large arrays from the parent process are automatically
+    dumped to a temporary folder on the filesystem such as child
+    processes to access their content via memmapping (file system
+    backed shared memory).
+
+    Note: it is important to call the terminate method to collect
+    the temporary folder used by the pool.
+
+    Parameters
+    ----------
+    processes: int, optional
+        Number of worker processes running concurrently in the pool.
+    initializer: callable, optional
+        Callable executed on worker process creation.
+    initargs: tuple, optional
+        Arguments passed to the initializer callable.
+    temp_folder: (str, callable) optional
+        If str:
+          Folder to be used by the pool for memmapping large arrays
+          for sharing memory with worker processes. If None, this will try in
+          order:
+          - a folder pointed by the JOBLIB_TEMP_FOLDER environment variable,
+          - /dev/shm if the folder exists and is writable: this is a RAMdisk
+            filesystem available by default on modern Linux distributions,
+          - the default system temporary folder that can be overridden
+            with TMP, TMPDIR or TEMP environment variables, typically /tmp
+            under Unix operating systems.
+        if callable:
+            An callable in charge of dynamically resolving a temporary folder
+            for memmapping large arrays.
+    max_nbytes int or None, optional, 1e6 by default
+        Threshold on the size of arrays passed to the workers that
+        triggers automated memory mapping in temp_folder.
+        Use None to disable memmapping of large arrays.
+    mmap_mode: {'r+', 'r', 'w+', 'c'}
+        Memmapping mode for numpy arrays passed to workers.
+        See 'max_nbytes' parameter documentation for more details.
+    forward_reducers: dictionary, optional
+        Reducers used to pickle objects passed from master to worker
+        processes: see below.
+    backward_reducers: dictionary, optional
+        Reducers used to pickle return values from workers back to the
+        master process.
+    verbose: int, optional
+        Make it possible to monitor how the communication of numpy arrays
+        with the subprocess is handled (pickling or memmapping)
+    prewarm: bool or str, optional, "auto" by default.
+        If True, force a read on newly memmapped array to make sure that OS
+        pre-cache it in memory. This can be useful to avoid concurrent disk
+        access when the same data array is passed to different worker
+        processes. If "auto" (by default), prewarm is set to True, unless the
+        Linux shared memory partition /dev/shm is available and used as temp
+        folder.
+
+    `forward_reducers` and `backward_reducers` are expected to be
+    dictionaries with key/values being `(type, callable)` pairs where
+    `callable` is a function that give an instance of `type` will return
+    a tuple `(constructor, tuple_of_objects)` to rebuild an instance out
+    of the pickled `tuple_of_objects` as would return a `__reduce__`
+    method. See the standard library documentation on pickling for more
+    details.
+
+    """
+
+    def __init__(self, processes=None, temp_folder=None, max_nbytes=1e6,
+                 mmap_mode='r', forward_reducers=None, backward_reducers=None,
+                 verbose=0, context_id=None, prewarm=False, **kwargs):
+
+        if context_id is not None:
+            warnings.warn('context_id is deprecated and ignored in joblib'
+                          ' 0.9.4 and will be removed in 0.11',
+                          DeprecationWarning)
+
+        manager = TemporaryResourcesManager(temp_folder)
+        self._temp_folder_manager = manager
+
+        # The usage of a temp_folder_resolver over a simple temp_folder is
+        # superfluous for multiprocessing pools, as they don't get reused, see
+        # get_memmapping_executor for more details. We still use it for code
+        # simplicity.
+        forward_reducers, backward_reducers = \
+            get_memmapping_reducers(
+                temp_folder_resolver=manager.resolve_temp_folder_name,
+                max_nbytes=max_nbytes, mmap_mode=mmap_mode,
+                forward_reducers=forward_reducers,
+                backward_reducers=backward_reducers, verbose=verbose,
+                unlink_on_gc_collect=False, prewarm=prewarm)
+
+        poolargs = dict(
+            processes=processes,
+            forward_reducers=forward_reducers,
+            backward_reducers=backward_reducers)
+        poolargs.update(kwargs)
+        super(MemmappingPool, self).__init__(**poolargs)
+
+    def terminate(self):
+        n_retries = 10
+        for i in range(n_retries):
+            try:
+                super(MemmappingPool, self).terminate()
+                break
+            except OSError as e:
+                if isinstance(e, WindowsError):
+                    # Workaround  occasional "[Error 5] Access is denied" issue
+                    # when trying to terminate a process under windows.
+                    sleep(0.1)
+                    if i + 1 == n_retries:
+                        warnings.warn("Failed to terminate worker processes in"
+                                      " multiprocessing pool: %r" % e)
+
+        # Clean up the temporary resources as the workers should now be off.
+        self._temp_folder_manager._clean_temporary_resources()
+
+    @property
+    def _temp_folder(self):
+        # Legacy property in tests. could be removed if we refactored the
+        # memmapping tests. SHOULD ONLY BE USED IN TESTS!
+        # We cache this property because it is called late in the tests - at
+        # this point, all context have been unregistered, and
+        # resolve_temp_folder_name raises an error.
+        if getattr(self, '_cached_temp_folder', None) is not None:
+            return self._cached_temp_folder
+        else:
+            self._cached_temp_folder = self._temp_folder_manager.resolve_temp_folder_name()  # noqa
+            return self._cached_temp_folder
diff --git a/llm/Lib/site-packages/joblib/test/__init__.py b/llm/Lib/site-packages/joblib/test/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5a62daa3d66a3baeb2757be4f7d147f1cf35ba15
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/common.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/common.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f3738afadd9cf492e2327164b3bd27d56ecdcda1
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/common.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_backports.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_backports.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..582c3b407936e38392832fd118beddf4f065662d
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_backports.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_cloudpickle_wrapper.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_cloudpickle_wrapper.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5b5322f6746d531ad5507ab6898ccb1e0d103c13
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_cloudpickle_wrapper.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_config.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_config.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6772c3e7d1dc942864f6e891a16c2236d9ad9cb9
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_config.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_dask.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_dask.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9e9fd123006f9e805cc2a3c3c8bf52cb002040d7
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_dask.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_disk.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_disk.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..be76f069ccb21588ee875724936de6c7a3118774
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_disk.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_func_inspect.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_func_inspect.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b766a9ff1ec4e53ac1686fc5cd8db043dc2d7379
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_func_inspect.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_func_inspect_special_encoding.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_func_inspect_special_encoding.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..99930df56b92ba817524cfc02c8442d8b3a99773
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_func_inspect_special_encoding.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_hashing.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_hashing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b33362ae4de8841b3133010da22f9292d6f670b9
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_hashing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_init.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_init.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..11d6869fc759330246a173ab714ff857bc772164
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_init.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_logger.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_logger.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..98ca11abd846924242584fd548f3e5ba2fadb1ad
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_logger.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_memmapping.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_memmapping.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c3b258eeb527004107cf3dd586ff9addeb414a5b
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_memmapping.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_memory.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6bed67d4cf985d34b83fb955b1b82a487d573308
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_memory_async.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_memory_async.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..425808c9e9b9c2e66b5d98c7e6b56dcb39f1c2e0
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_memory_async.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_missing_multiprocessing.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_missing_multiprocessing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5632bcbfac09785e963ab030a4e44e3254363079
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_missing_multiprocessing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_module.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_module.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2efdd49bd30c6e72861c8657653e9d85d87c47a6
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_module.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_numpy_pickle.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_numpy_pickle.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..117d64972f7be49681fe183b363eabed456171af
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_numpy_pickle.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_numpy_pickle_compat.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_numpy_pickle_compat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..45e4ee05a53c0486c4b1c7e7ce2d7dea52ee194d
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_numpy_pickle_compat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_numpy_pickle_utils.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_numpy_pickle_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..358edc5ba321b3b9321ae23b176632b38faa2ca3
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_numpy_pickle_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_parallel.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_parallel.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..03906997accc98448e7b4737052674ed2008282d
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_parallel.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_store_backends.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_store_backends.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8ae5f811a08312c3931d416bbb79903cd789470c
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_store_backends.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_testing.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_testing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..543bd995a08d11fde527a3c93882304d2b6d0d71
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_testing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/test_utils.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/test_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f80ceb4e5ab6a6b5f7aa3aec807d222c12d93409
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/test_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/__pycache__/testutils.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/__pycache__/testutils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..16078e192b6564c6640a2e2253ef8e69dddf5f87
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/__pycache__/testutils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/common.py b/llm/Lib/site-packages/joblib/test/common.py
new file mode 100644
index 0000000000000000000000000000000000000000..b0ca0c6abd913bc37091ebae4bd6a0b64084d20f
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/common.py
@@ -0,0 +1,84 @@
+"""
+Small utilities for testing.
+"""
+import os
+import gc
+import sys
+
+from joblib._multiprocessing_helpers import mp
+from joblib.testing import SkipTest, skipif
+
+try:
+    import lz4
+except ImportError:
+    lz4 = None
+
+IS_PYPY = hasattr(sys, "pypy_version_info")
+
+# A decorator to run tests only when numpy is available
+try:
+    import numpy as np
+
+    def with_numpy(func):
+        """A decorator to skip tests requiring numpy."""
+        return func
+
+except ImportError:
+    def with_numpy(func):
+        """A decorator to skip tests requiring numpy."""
+        def my_func():
+            raise SkipTest('Test requires numpy')
+        return my_func
+    np = None
+
+# TODO: Turn this back on after refactoring yield based tests in test_hashing
+# with_numpy = skipif(not np, reason='Test requires numpy.')
+
+# we use memory_profiler library for memory consumption checks
+try:
+    from memory_profiler import memory_usage
+
+    def with_memory_profiler(func):
+        """A decorator to skip tests requiring memory_profiler."""
+        return func
+
+    def memory_used(func, *args, **kwargs):
+        """Compute memory usage when executing func."""
+        gc.collect()
+        mem_use = memory_usage((func, args, kwargs), interval=.001)
+        return max(mem_use) - min(mem_use)
+
+except ImportError:
+    def with_memory_profiler(func):
+        """A decorator to skip tests requiring memory_profiler."""
+        def dummy_func():
+            raise SkipTest('Test requires memory_profiler.')
+        return dummy_func
+
+    memory_usage = memory_used = None
+
+
+def force_gc_pypy():
+    # The gc in pypy can be delayed. Force it to test the behavior when it
+    # will eventually be collected.
+    if IS_PYPY:
+        # Run gc.collect() twice to make sure the weakref is collected, as
+        # mentionned in the pypy doc:
+        # https://doc.pypy.org/en/latest/config/objspace.usemodules._weakref.html
+        import gc
+        gc.collect()
+        gc.collect()
+
+
+with_multiprocessing = skipif(
+    mp is None, reason='Needs multiprocessing to run.')
+
+
+with_dev_shm = skipif(
+    not os.path.exists('/dev/shm'),
+    reason='This test requires a large /dev/shm shared memory fs.')
+
+with_lz4 = skipif(lz4 is None, reason='Needs lz4 compression to run')
+
+without_lz4 = skipif(
+    lz4 is not None, reason='Needs lz4 not being installed to run')
diff --git a/llm/Lib/site-packages/joblib/test/data/__init__.py b/llm/Lib/site-packages/joblib/test/data/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/joblib/test/data/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/data/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9e62d674fb372759fe6727c47483f67200755622
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/data/__pycache__/create_numpy_pickle.cpython-311.pyc b/llm/Lib/site-packages/joblib/test/data/__pycache__/create_numpy_pickle.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a88858ee8b0e46711bb2c6ad9c69fa85a063883e
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/__pycache__/create_numpy_pickle.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/joblib/test/data/create_numpy_pickle.py b/llm/Lib/site-packages/joblib/test/data/create_numpy_pickle.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba903d6cc2cd75879eed60ff31ecdf7ffe230d45
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/create_numpy_pickle.py
@@ -0,0 +1,95 @@
+"""
+This script is used to generate test data for joblib/test/test_numpy_pickle.py
+"""
+
+import sys
+import re
+
+# pytest needs to be able to import this module even when numpy is
+# not installed
+try:
+    import numpy as np
+except ImportError:
+    np = None
+
+import joblib
+
+
+def get_joblib_version(joblib_version=joblib.__version__):
+    """Normalize joblib version by removing suffix.
+
+    >>> get_joblib_version('0.8.4')
+    '0.8.4'
+    >>> get_joblib_version('0.8.4b1')
+    '0.8.4'
+    >>> get_joblib_version('0.9.dev0')
+    '0.9'
+    """
+    matches = [re.match(r'(\d+).*', each)
+               for each in joblib_version.split('.')]
+    return '.'.join([m.group(1) for m in matches if m is not None])
+
+
+def write_test_pickle(to_pickle, args):
+    kwargs = {}
+    compress = args.compress
+    method = args.method
+    joblib_version = get_joblib_version()
+    py_version = '{0[0]}{0[1]}'.format(sys.version_info)
+    numpy_version = ''.join(np.__version__.split('.')[:2])
+
+    # The game here is to generate the right filename according to the options.
+    body = '_compressed' if (compress and method == 'zlib') else ''
+    if compress:
+        if method == 'zlib':
+            kwargs['compress'] = True
+            extension = '.gz'
+        else:
+            kwargs['compress'] = (method, 3)
+            extension = '.pkl.{}'.format(method)
+        if args.cache_size:
+            kwargs['cache_size'] = 0
+            body += '_cache_size'
+    else:
+        extension = '.pkl'
+
+    pickle_filename = 'joblib_{}{}_pickle_py{}_np{}{}'.format(
+        joblib_version, body, py_version, numpy_version, extension)
+
+    try:
+        joblib.dump(to_pickle, pickle_filename, **kwargs)
+    except Exception as e:
+        # With old python version (=< 3.3.), we can arrive there when
+        # dumping compressed pickle with LzmaFile.
+        print("Error: cannot generate file '{}' with arguments '{}'. "
+              "Error was: {}".format(pickle_filename, kwargs, e))
+    else:
+        print("File '{}' generated successfully.".format(pickle_filename))
+
+
+if __name__ == '__main__':
+    import argparse
+    parser = argparse.ArgumentParser(description="Joblib pickle data "
+                                                 "generator.")
+    parser.add_argument('--cache_size', action="store_true",
+                        help="Force creation of companion numpy "
+                             "files for pickled arrays.")
+    parser.add_argument('--compress', action="store_true",
+                        help="Generate compress pickles.")
+    parser.add_argument('--method', type=str, default='zlib',
+                        choices=['zlib', 'gzip', 'bz2', 'xz', 'lzma', 'lz4'],
+                        help="Set compression method.")
+    # We need to be specific about dtypes in particular endianness
+    # because the pickles can be generated on one architecture and
+    # the tests run on another one. See
+    # https://github.com/joblib/joblib/issues/279.
+    to_pickle = [np.arange(5, dtype=np.dtype('<i8')),
+                 np.arange(5, dtype=np.dtype('<f8')),
+                 np.array([1, 'abc', {'a': 1, 'b': 2}], dtype='O'),
+                 # all possible bytes as a byte string
+                 np.arange(256, dtype=np.uint8).tobytes(),
+                 np.matrix([0, 1, 2], dtype=np.dtype('<i8')),
+                 # unicode string with non-ascii chars
+                 u"C'est l'\xe9t\xe9 !"]
+
+    write_test_pickle(to_pickle, parser.parse_args())
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py27_np16.gz b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py27_np16.gz
new file mode 100644
index 0000000000000000000000000000000000000000..fedefdd304054a85fa995801885f997ca8e1a44f
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py27_np16.gz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:418447e90d83486568ae3092a960b18d358230e24ac9ec38365daa99f415bd0f
+size 769
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py27_np17.gz b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py27_np17.gz
new file mode 100644
index 0000000000000000000000000000000000000000..3fd32f71887ddd0c94d06c8a77afccc322fed583
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py27_np17.gz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a1f4e8cccfca94f25ae744d1f050b0734f663263ba38ed0642181404b348b17b
+size 757
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py33_np18.gz b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py33_np18.gz
new file mode 100644
index 0000000000000000000000000000000000000000..7cd1fcc9dc7a04d7ac251d3b1bbf973609b947b8
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py33_np18.gz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d9e215780f978ce693e48110ead23652e1c6de1c2189172232690198f7088788
+size 792
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py34_np19.gz b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py34_np19.gz
new file mode 100644
index 0000000000000000000000000000000000000000..7cc0ad77a184883b0268bffd1e2f3d195ae99f6b
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py34_np19.gz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1abdb3ff5b555831f51f7ff00951e66a49277fc2aa787293f18cf8775be65023
+size 794
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py35_np19.gz b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py35_np19.gz
new file mode 100644
index 0000000000000000000000000000000000000000..878decdcad534f6d2cdd14a487c207f8c6133261
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_compressed_pickle_py35_np19.gz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a56c3fc6e0db3a4102aaed4a19fd4e154eecd956f30b6bf9179897844ed3c01e
+size 790
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl
new file mode 100644
index 0000000000000000000000000000000000000000..38202b72d880ff53255dbb86eccd73bdb6224c74
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:89c4508e3dfbe01f801e4e739f1aded13f685941e89281c8050f0ca8aa3c97e5
+size 986
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.bz2 b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.bz2
new file mode 100644
index 0000000000000000000000000000000000000000..77ea56324322ed8657967221aad47bc0063a12fc
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.bz2
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a18415232322531c918164ae04148ebc258acd3a00fa4529728416755e14a15e
+size 997
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.gzip b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.gzip
new file mode 100644
index 0000000000000000000000000000000000000000..266b2592d66c98c72534e6b9c69ed0627f81dc04
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.gzip differ
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.lzma b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.lzma
new file mode 100644
index 0000000000000000000000000000000000000000..92acdd95675978ef8265e261f770749eb68d6f7c
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.lzma differ
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.xz b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.xz
new file mode 100644
index 0000000000000000000000000000000000000000..7812497bc95e5894c8e880736bfb06aa22bb2fae
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py27_np17.pkl.xz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:efb146d450c6d061d06affb56f17384e7f64cbab9b516fcc6c4d3f8869b3e707
+size 712
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl
new file mode 100644
index 0000000000000000000000000000000000000000..d6cf697b1c1c752d4d8a78d702a70042ad047ce9
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e064c2eecfdc58d552844467da7bd56eca596098322bfd266a7e1312abdd5735
+size 1068
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.bz2 b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.bz2
new file mode 100644
index 0000000000000000000000000000000000000000..317981559c4a9987aa099efeb68e4359c08d71ec
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.bz2
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e86d6f6ecfe2626cf691827ac38a81d64ec3ebb527c5432eb344b8496781b45a
+size 1000
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.gzip b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.gzip
new file mode 100644
index 0000000000000000000000000000000000000000..02f62ecf2db32e01f029eae612de0f12f26a466f
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.gzip differ
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.lzma b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.lzma
new file mode 100644
index 0000000000000000000000000000000000000000..4280387fc5e542d3b022be43ab8ab8c05ea2e953
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.lzma differ
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.xz b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.xz
new file mode 100644
index 0000000000000000000000000000000000000000..826c9ba7b9579a988f8f1718219bbc41fd1ad756
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py33_np18.pkl.xz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0e9a63dcc7df38ab0a1137a9b44b436b13cebfa300eb19dba4ae4bce50d0fa81
+size 752
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl
new file mode 100644
index 0000000000000000000000000000000000000000..f22c25bdb59d15a3771104dff6dfebe564e98add
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1cbe456f5b91f5a3cb8e386838f276c30335432a351426686187761d5c34168b
+size 1068
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.bz2 b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.bz2
new file mode 100644
index 0000000000000000000000000000000000000000..80818a8baa1e2481b62bed06bb2b95f4a614cc3a
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.bz2
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3f2af67ea667c1f5315ddcab06bfa447005863c1c0fd88bb7e04a0b8acb9a54b
+size 1021
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.gzip b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.gzip
new file mode 100644
index 0000000000000000000000000000000000000000..02b16b8ebaa36c61da9c0c4cba6ceae88049cb43
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.gzip differ
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.lzma b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.lzma
new file mode 100644
index 0000000000000000000000000000000000000000..add975b005d9c6fdab5c24c369edb0c7c4cf397c
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.lzma differ
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.xz b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.xz
new file mode 100644
index 0000000000000000000000000000000000000000..1cd5660dd8d32121e8dd7b40534187add5981639
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py34_np19.pkl.xz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:04d7e68907e978b56975f9309492b8849e42a60974beb795c9e93273977f3cd3
+size 752
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl
new file mode 100644
index 0000000000000000000000000000000000000000..360af38dc3a9bde47e3b18b144dc1c5257e7daca
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:97b9ef2e896104321d3c5ce73b3de504788c38f04f08c8b56d7a29d6d1520a96
+size 1068
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.bz2 b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.bz2
new file mode 100644
index 0000000000000000000000000000000000000000..06e8395437874c25cfdf6a6783eab12a6c178f90
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.bz2
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a6a1a9b884be654e2e3fc9a48251ecf0c6920e255c3f2ee5dd71d8252a694606
+size 1005
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.gzip b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.gzip
new file mode 100644
index 0000000000000000000000000000000000000000..2d56bb066e49bbf08dc2565c53f11348b62f8ef6
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.gzip differ
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.lzma b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.lzma
new file mode 100644
index 0000000000000000000000000000000000000000..6664c1772e85fa930dc330550f2cb237ac042328
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.lzma differ
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.xz b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.xz
new file mode 100644
index 0000000000000000000000000000000000000000..cec2871b09ae347e07c81eb55e7979300748ccd1
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.10.0_pickle_py35_np19.pkl.xz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:02cf30d8b196c303662b2dd035d2a58caeb762ae3a82345ffd1274961e7f5aa0
+size 752
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_compressed_pickle_py36_np111.gz b/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_compressed_pickle_py36_np111.gz
new file mode 100644
index 0000000000000000000000000000000000000000..f2e65e202609648f0a5464ae5b78b9f9fba8dd6e
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_compressed_pickle_py36_np111.gz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d56ae75c3a83a0d10f60e657d50e56af6e3addbf2f555e9fc385a6e52e1b32de
+size 800
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl b/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl
new file mode 100644
index 0000000000000000000000000000000000000000..4dda21d9ad4ce279b8474ecce9697e3290e96bfa
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5e6b0e171782d5fd5a61d1844dc946eb27c5f6b2e8075d436b23808433142ebc
+size 1068
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.bz2 b/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.bz2
new file mode 100644
index 0000000000000000000000000000000000000000..895dd324d574d9b2298833317a76f3794209bbb3
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.bz2
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:bc8db259be742ca2ff36067277f5e4a03e6d78883ddee238da65a7c7d79ef804
+size 991
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.gzip b/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.gzip
new file mode 100644
index 0000000000000000000000000000000000000000..bffa94bc1e200b7a2cb7aa1b200364bd80455477
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.gzip differ
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.lzma b/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.lzma
new file mode 100644
index 0000000000000000000000000000000000000000..2090b534faf3b514544244d70112af74769ee247
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.lzma differ
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.xz b/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.xz
new file mode 100644
index 0000000000000000000000000000000000000000..c7607dcdb2b09e7a50acc3239cc585974e7a09e6
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.11.0_pickle_py36_np111.pkl.xz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:dd787f35b3197418d8c7bca77c9dc5ca47b6f22cd24524b3ccd074cf90f893d6
+size 752
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.8.4_compressed_pickle_py27_np17.gz b/llm/Lib/site-packages/joblib/test/data/joblib_0.8.4_compressed_pickle_py27_np17.gz
new file mode 100644
index 0000000000000000000000000000000000000000..fc4e28719d5acc118ac1d8bd8cdd15227eef25ba
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.8.4_compressed_pickle_py27_np17.gz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4a9f994fb8baa63e689f681ba6db33bbb45aaf32693a61c9ebb50a3a608f40c8
+size 659
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_compressed_pickle_py27_np16.gz b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_compressed_pickle_py27_np16.gz
new file mode 100644
index 0000000000000000000000000000000000000000..1238376dd6ac2e166bf56f263862afe56b866da3
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_compressed_pickle_py27_np16.gz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:34bb43aefa365c81f42af51402f84ea8c7a85c48c65b422e4e4fe8b2ee57883c
+size 658
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_compressed_pickle_py27_np17.gz b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_compressed_pickle_py27_np17.gz
new file mode 100644
index 0000000000000000000000000000000000000000..1238376dd6ac2e166bf56f263862afe56b866da3
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_compressed_pickle_py27_np17.gz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:34bb43aefa365c81f42af51402f84ea8c7a85c48c65b422e4e4fe8b2ee57883c
+size 658
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_compressed_pickle_py34_np19.gz b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_compressed_pickle_py34_np19.gz
new file mode 100644
index 0000000000000000000000000000000000000000..0720a70aee276c37f9457817922ae60b67600d47
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_compressed_pickle_py34_np19.gz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9f33bd8a21a41b729b05dac5deeb0e868f218a092b0e3fe5988094cf167217f6
+size 673
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_compressed_pickle_py35_np19.gz b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_compressed_pickle_py35_np19.gz
new file mode 100644
index 0000000000000000000000000000000000000000..0720a70aee276c37f9457817922ae60b67600d47
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_compressed_pickle_py35_np19.gz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9f33bd8a21a41b729b05dac5deeb0e868f218a092b0e3fe5988094cf167217f6
+size 673
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl
new file mode 100644
index 0000000000000000000000000000000000000000..f7ca0addc6d032e93d0b530a2b42a583fb0d4b81
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9da8a3764db121e29d21ade67c9c3426598e76d88deae44cd7238983af8cef73
+size 670
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_01.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_01.npy
new file mode 100644
index 0000000000000000000000000000000000000000..15574a4193ad4ad724b2b8053c701a82efa78fd5
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_01.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0efbd7d9ce7eec3a6e0a0db41e795e0396cca3d6b037dad6c61b464843d28809
+size 120
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_02.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_02.npy
new file mode 100644
index 0000000000000000000000000000000000000000..f00f08fbeeda280fa3ce00069c313c5412a33eca
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_02.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1c1cf36cb781fbcc21b953bb0a0b45df092da0eae0e765882e5963ccd70105b1
+size 120
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_03.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_03.npy
new file mode 100644
index 0000000000000000000000000000000000000000..ccc84c361de2569ed5cb91967f9063efcd84dd14
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_03.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a0c45ae2a289841cbeba2443b7ebaa3b31c0a9e9dcc73294aca5729da0092405
+size 236
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_04.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_04.npy
new file mode 100644
index 0000000000000000000000000000000000000000..e9b5e77c73268dfff541b576126f06fc6fed3d59
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np16.pkl_04.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3ecbe244294ba93e08479b16c1b9a9411e3569ff660ed0459dca1d241381df05
+size 104
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl
new file mode 100644
index 0000000000000000000000000000000000000000..976cba8c28be9a3dd0075efe5a6b3ce704319161
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2f29d7f1d2ceca07f10df172c0e826ef08163a14b12c6ef3fa80ec53a5fcdc3c
+size 670
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_01.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_01.npy
new file mode 100644
index 0000000000000000000000000000000000000000..15574a4193ad4ad724b2b8053c701a82efa78fd5
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_01.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0efbd7d9ce7eec3a6e0a0db41e795e0396cca3d6b037dad6c61b464843d28809
+size 120
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_02.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_02.npy
new file mode 100644
index 0000000000000000000000000000000000000000..f00f08fbeeda280fa3ce00069c313c5412a33eca
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_02.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1c1cf36cb781fbcc21b953bb0a0b45df092da0eae0e765882e5963ccd70105b1
+size 120
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_03.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_03.npy
new file mode 100644
index 0000000000000000000000000000000000000000..ccc84c361de2569ed5cb91967f9063efcd84dd14
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_03.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a0c45ae2a289841cbeba2443b7ebaa3b31c0a9e9dcc73294aca5729da0092405
+size 236
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_04.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_04.npy
new file mode 100644
index 0000000000000000000000000000000000000000..e9b5e77c73268dfff541b576126f06fc6fed3d59
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py27_np17.pkl_04.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3ecbe244294ba93e08479b16c1b9a9411e3569ff660ed0459dca1d241381df05
+size 104
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl
new file mode 100644
index 0000000000000000000000000000000000000000..e739b6d035cdf110063dbb8b2cdceb116e187019
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c3d4cbc690d3ce9e5323a714ea546f32c01ab1710285c420184f6cdf4b26fc25
+size 691
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_01.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_01.npy
new file mode 100644
index 0000000000000000000000000000000000000000..15574a4193ad4ad724b2b8053c701a82efa78fd5
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_01.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0efbd7d9ce7eec3a6e0a0db41e795e0396cca3d6b037dad6c61b464843d28809
+size 120
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_02.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_02.npy
new file mode 100644
index 0000000000000000000000000000000000000000..f00f08fbeeda280fa3ce00069c313c5412a33eca
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_02.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1c1cf36cb781fbcc21b953bb0a0b45df092da0eae0e765882e5963ccd70105b1
+size 120
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_03.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_03.npy
new file mode 100644
index 0000000000000000000000000000000000000000..73976395be90d4b2b2d955c79a90721e16cebc82
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_03.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8ede9a64a52b25d7db30950956c978ec0b3932b7d14acd5abc63216e64babde7
+size 307
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_04.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_04.npy
new file mode 100644
index 0000000000000000000000000000000000000000..e9b5e77c73268dfff541b576126f06fc6fed3d59
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py33_np18.pkl_04.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3ecbe244294ba93e08479b16c1b9a9411e3569ff660ed0459dca1d241381df05
+size 104
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl
new file mode 100644
index 0000000000000000000000000000000000000000..19b2b0b8ee910063dcc1b24a87b1f387604c3706
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8a538100e6ae94b16f2ab0f7d92d4d7e7a622be2dfcc0f6b0b73b623bc513ae2
+size 691
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_01.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_01.npy
new file mode 100644
index 0000000000000000000000000000000000000000..15574a4193ad4ad724b2b8053c701a82efa78fd5
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_01.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0efbd7d9ce7eec3a6e0a0db41e795e0396cca3d6b037dad6c61b464843d28809
+size 120
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_02.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_02.npy
new file mode 100644
index 0000000000000000000000000000000000000000..f00f08fbeeda280fa3ce00069c313c5412a33eca
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_02.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1c1cf36cb781fbcc21b953bb0a0b45df092da0eae0e765882e5963ccd70105b1
+size 120
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_03.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_03.npy
new file mode 100644
index 0000000000000000000000000000000000000000..73976395be90d4b2b2d955c79a90721e16cebc82
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_03.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8ede9a64a52b25d7db30950956c978ec0b3932b7d14acd5abc63216e64babde7
+size 307
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_04.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_04.npy
new file mode 100644
index 0000000000000000000000000000000000000000..e9b5e77c73268dfff541b576126f06fc6fed3d59
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py34_np19.pkl_04.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3ecbe244294ba93e08479b16c1b9a9411e3569ff660ed0459dca1d241381df05
+size 104
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl
new file mode 100644
index 0000000000000000000000000000000000000000..93417ab8e94e4542a24211ad514948f9d1b80a3a
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:59f0d522a29c333ce1d60480b2121fcc1a08a5d2dd650b86efdc987f991fa4ea
+size 691
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_01.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_01.npy
new file mode 100644
index 0000000000000000000000000000000000000000..15574a4193ad4ad724b2b8053c701a82efa78fd5
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_01.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0efbd7d9ce7eec3a6e0a0db41e795e0396cca3d6b037dad6c61b464843d28809
+size 120
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_02.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_02.npy
new file mode 100644
index 0000000000000000000000000000000000000000..f00f08fbeeda280fa3ce00069c313c5412a33eca
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_02.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1c1cf36cb781fbcc21b953bb0a0b45df092da0eae0e765882e5963ccd70105b1
+size 120
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_03.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_03.npy
new file mode 100644
index 0000000000000000000000000000000000000000..73976395be90d4b2b2d955c79a90721e16cebc82
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_03.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8ede9a64a52b25d7db30950956c978ec0b3932b7d14acd5abc63216e64babde7
+size 307
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_04.npy b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_04.npy
new file mode 100644
index 0000000000000000000000000000000000000000..e9b5e77c73268dfff541b576126f06fc6fed3d59
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.2_pickle_py35_np19.pkl_04.npy
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3ecbe244294ba93e08479b16c1b9a9411e3569ff660ed0459dca1d241381df05
+size 104
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz
new file mode 100644
index 0000000000000000000000000000000000000000..e3125fe0fd4709dbd0067e67a06a3f24073934ad
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f2361f589b31d2863627edcb96612280ae5c0a59c9496d89dab7de493670f93b
+size 802
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz_01.npy.z b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz_01.npy.z
new file mode 100644
index 0000000000000000000000000000000000000000..bba0f811dfe9a8f33665b7c31837eab72ce8499e
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz_01.npy.z differ
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz_02.npy.z b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz_02.npy.z
new file mode 100644
index 0000000000000000000000000000000000000000..ccb4f412310d7a238fe50f4885581d221a34f5e1
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz_02.npy.z differ
diff --git a/llm/Lib/site-packages/joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz_03.npy.z b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz_03.npy.z
new file mode 100644
index 0000000000000000000000000000000000000000..669602e0a880d308cbea22eed2fda74cea225a9f
Binary files /dev/null and b/llm/Lib/site-packages/joblib/test/data/joblib_0.9.4.dev0_compressed_cache_size_pickle_py35_np19.gz_03.npy.z differ
diff --git a/llm/Lib/site-packages/joblib/test/test_backports.py b/llm/Lib/site-packages/joblib/test/test_backports.py
new file mode 100644
index 0000000000000000000000000000000000000000..4f5a3bd42353bf5a3d77243b9c607a3ec2b8cb1d
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_backports.py
@@ -0,0 +1,35 @@
+import mmap
+
+from joblib.backports import make_memmap, concurrency_safe_rename
+from joblib.test.common import with_numpy
+from joblib.testing import parametrize
+from joblib import Parallel, delayed
+
+
+@with_numpy
+def test_memmap(tmpdir):
+    fname = tmpdir.join('test.mmap').strpath
+    size = 5 * mmap.ALLOCATIONGRANULARITY
+    offset = mmap.ALLOCATIONGRANULARITY + 1
+    memmap_obj = make_memmap(fname, shape=size, mode='w+', offset=offset)
+    assert memmap_obj.offset == offset
+
+
+@parametrize('dst_content', [None, 'dst content'])
+@parametrize('backend', [None, 'threading'])
+def test_concurrency_safe_rename(tmpdir, dst_content, backend):
+    src_paths = [tmpdir.join('src_%d' % i) for i in range(4)]
+    for src_path in src_paths:
+        src_path.write('src content')
+    dst_path = tmpdir.join('dst')
+    if dst_content is not None:
+        dst_path.write(dst_content)
+
+    Parallel(n_jobs=4, backend=backend)(
+        delayed(concurrency_safe_rename)(src_path.strpath, dst_path.strpath)
+        for src_path in src_paths
+    )
+    assert dst_path.exists()
+    assert dst_path.read() == 'src content'
+    for src_path in src_paths:
+        assert not src_path.exists()
diff --git a/llm/Lib/site-packages/joblib/test/test_cloudpickle_wrapper.py b/llm/Lib/site-packages/joblib/test/test_cloudpickle_wrapper.py
new file mode 100644
index 0000000000000000000000000000000000000000..57bf92f940b2a68f10863ea5c42be444c8e0d2b0
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_cloudpickle_wrapper.py
@@ -0,0 +1,27 @@
+"""
+Test that our implementation of wrap_non_picklable_objects mimics
+properly the loky implementation.
+"""
+
+from .._cloudpickle_wrapper import wrap_non_picklable_objects
+from .._cloudpickle_wrapper import _my_wrap_non_picklable_objects
+
+
+def a_function(x):
+    return x
+
+
+class AClass(object):
+
+    def __call__(self, x):
+        return x
+
+
+def test_wrap_non_picklable_objects():
+    # Mostly a smoke test: test that we can use callable in the same way
+    # with both our implementation of wrap_non_picklable_objects and the
+    # upstream one
+    for obj in (a_function, AClass()):
+        wrapped_obj = wrap_non_picklable_objects(obj)
+        my_wrapped_obj = _my_wrap_non_picklable_objects(obj)
+        assert wrapped_obj(1) == my_wrapped_obj(1)
diff --git a/llm/Lib/site-packages/joblib/test/test_config.py b/llm/Lib/site-packages/joblib/test/test_config.py
new file mode 100644
index 0000000000000000000000000000000000000000..56eeed31b0db103360771c52cae641d00edb1c3a
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_config.py
@@ -0,0 +1,151 @@
+import os
+
+from joblib.parallel import parallel_config
+from joblib.parallel import parallel_backend
+from joblib.parallel import Parallel, delayed
+
+from joblib.parallel import BACKENDS
+from joblib.parallel import DEFAULT_BACKEND
+from joblib.parallel import EXTERNAL_BACKENDS
+
+from joblib._parallel_backends import LokyBackend
+from joblib._parallel_backends import ThreadingBackend
+from joblib._parallel_backends import MultiprocessingBackend
+
+from joblib.testing import parametrize, raises
+from joblib.test.common import np, with_numpy
+from joblib.test.common import with_multiprocessing
+from joblib.test.test_parallel import check_memmap
+
+
+@parametrize("context", [parallel_config, parallel_backend])
+def test_global_parallel_backend(context):
+    default = Parallel()._backend
+
+    pb = context('threading')
+    try:
+        assert isinstance(Parallel()._backend, ThreadingBackend)
+    finally:
+        pb.unregister()
+    assert type(Parallel()._backend) is type(default)
+
+
+@parametrize("context", [parallel_config, parallel_backend])
+def test_external_backends(context):
+    def register_foo():
+        BACKENDS['foo'] = ThreadingBackend
+
+    EXTERNAL_BACKENDS['foo'] = register_foo
+    try:
+        with context('foo'):
+            assert isinstance(Parallel()._backend, ThreadingBackend)
+    finally:
+        del EXTERNAL_BACKENDS['foo']
+
+
+@with_numpy
+@with_multiprocessing
+def test_parallel_config_no_backend(tmpdir):
+    # Check that parallel_config allows to change the config
+    # even if no backend is set.
+    with parallel_config(n_jobs=2, max_nbytes=1, temp_folder=tmpdir):
+        with Parallel(prefer="processes") as p:
+            assert isinstance(p._backend, LokyBackend)
+            assert p.n_jobs == 2
+
+            # Checks that memmapping is enabled
+            p(delayed(check_memmap)(a) for a in [np.random.random(10)] * 2)
+            assert len(os.listdir(tmpdir)) > 0
+
+
+@with_numpy
+@with_multiprocessing
+def test_parallel_config_params_explicit_set(tmpdir):
+    with parallel_config(n_jobs=3, max_nbytes=1, temp_folder=tmpdir):
+        with Parallel(n_jobs=2, prefer="processes", max_nbytes='1M') as p:
+            assert isinstance(p._backend, LokyBackend)
+            assert p.n_jobs == 2
+
+            # Checks that memmapping is disabled
+            with raises(TypeError, match="Expected np.memmap instance"):
+                p(delayed(check_memmap)(a) for a in [np.random.random(10)] * 2)
+
+
+@parametrize("param", ["prefer", "require"])
+def test_parallel_config_bad_params(param):
+    # Check that an error is raised when setting a wrong backend
+    # hint or constraint
+    with raises(ValueError, match=f"{param}=wrong is not a valid"):
+        with parallel_config(**{param: "wrong"}):
+            Parallel()
+
+
+def test_parallel_config_constructor_params():
+    # Check that an error is raised when backend is None
+    # but backend constructor params are given
+    with raises(ValueError, match="only supported when backend is not None"):
+        with parallel_config(inner_max_num_threads=1):
+            pass
+
+    with raises(ValueError, match="only supported when backend is not None"):
+        with parallel_config(backend_param=1):
+            pass
+
+
+def test_parallel_config_nested():
+    # Check that nested configuration retrieves the info from the
+    # parent config and do not reset them.
+
+    with parallel_config(n_jobs=2):
+        p = Parallel()
+        assert isinstance(p._backend, BACKENDS[DEFAULT_BACKEND])
+        assert p.n_jobs == 2
+
+    with parallel_config(backend='threading'):
+        with parallel_config(n_jobs=2):
+            p = Parallel()
+            assert isinstance(p._backend, ThreadingBackend)
+            assert p.n_jobs == 2
+
+    with parallel_config(verbose=100):
+        with parallel_config(n_jobs=2):
+            p = Parallel()
+            assert p.verbose == 100
+            assert p.n_jobs == 2
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize('backend', ['multiprocessing', 'threading',
+                         MultiprocessingBackend(), ThreadingBackend()])
+@parametrize("context", [parallel_config, parallel_backend])
+def test_threadpool_limitation_in_child_context_error(context, backend):
+
+    with raises(AssertionError, match=r"does not acc.*inner_max_num_threads"):
+        context(backend, inner_max_num_threads=1)
+
+
+@parametrize("context", [parallel_config, parallel_backend])
+def test_parallel_n_jobs_none(context):
+    # Check that n_jobs=None is interpreted as "unset" in Parallel
+    # non regression test for #1473
+    with context(backend="threading", n_jobs=2):
+        with Parallel(n_jobs=None) as p:
+            assert p.n_jobs == 2
+
+    with context(backend="threading"):
+        default_n_jobs = Parallel().n_jobs
+        with Parallel(n_jobs=None) as p:
+            assert p.n_jobs == default_n_jobs
+
+
+@parametrize("context", [parallel_config, parallel_backend])
+def test_parallel_config_n_jobs_none(context):
+    # Check that n_jobs=None is interpreted as "explicitly set" in
+    # parallel_(config/backend)
+    # non regression test for #1473
+    with context(backend="threading", n_jobs=2):
+        with context(backend="threading", n_jobs=None):
+            # n_jobs=None resets n_jobs to backend's default
+            with Parallel() as p:
+                assert p.n_jobs == 1
diff --git a/llm/Lib/site-packages/joblib/test/test_dask.py b/llm/Lib/site-packages/joblib/test/test_dask.py
new file mode 100644
index 0000000000000000000000000000000000000000..aebe65525fc55f4593e6c83b5bfd4ffc76d945a7
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_dask.py
@@ -0,0 +1,499 @@
+from __future__ import print_function, division, absolute_import
+import os
+import warnings
+
+import pytest
+from random import random
+from uuid import uuid4
+from time import sleep
+
+from .. import Parallel, delayed, parallel_config
+from ..parallel import ThreadingBackend, AutoBatchingMixin
+from .._dask import DaskDistributedBackend
+
+distributed = pytest.importorskip('distributed')
+dask = pytest.importorskip('dask')
+
+# These imports need to be after the pytest.importorskip hence the noqa: E402
+from distributed import Client, LocalCluster, get_client  # noqa: E402
+from distributed.metrics import time  # noqa: E402
+# Note: pytest requires to manually import all fixtures used in the test
+# and their dependencies.
+from distributed.utils_test import cluster, inc, cleanup  # noqa: E402, F401
+
+
+def noop(*args, **kwargs):
+    pass
+
+
+def slow_raise_value_error(condition, duration=0.05):
+    sleep(duration)
+    if condition:
+        raise ValueError("condition evaluated to True")
+
+
+def count_events(event_name, client):
+    worker_events = client.run(lambda dask_worker: dask_worker.log)
+    event_counts = {}
+    for w, events in worker_events.items():
+        event_counts[w] = len([event for event in list(events)
+                               if event[1] == event_name])
+    return event_counts
+
+
+def test_simple(loop):
+    with cluster() as (s, [a, b]):
+        with Client(s['address'], loop=loop) as client:  # noqa: F841
+            with parallel_config(backend='dask'):
+                seq = Parallel()(delayed(inc)(i) for i in range(10))
+                assert seq == [inc(i) for i in range(10)]
+
+                with pytest.raises(ValueError):
+                    Parallel()(delayed(slow_raise_value_error)(i == 3)
+                               for i in range(10))
+
+                seq = Parallel()(delayed(inc)(i) for i in range(10))
+                assert seq == [inc(i) for i in range(10)]
+
+
+def test_dask_backend_uses_autobatching(loop):
+    assert (DaskDistributedBackend.compute_batch_size
+            is AutoBatchingMixin.compute_batch_size)
+
+    with cluster() as (s, [a, b]):
+        with Client(s['address'], loop=loop) as client:  # noqa: F841
+            with parallel_config(backend='dask'):
+                with Parallel() as parallel:
+                    # The backend should be initialized with a default
+                    # batch size of 1:
+                    backend = parallel._backend
+                    assert isinstance(backend, DaskDistributedBackend)
+                    assert backend.parallel is parallel
+                    assert backend._effective_batch_size == 1
+
+                    # Launch many short tasks that should trigger
+                    # auto-batching:
+                    parallel(
+                        delayed(lambda: None)()
+                        for _ in range(int(1e4))
+                    )
+                    assert backend._effective_batch_size > 10
+
+
+def random2():
+    return random()
+
+
+def test_dont_assume_function_purity(loop):
+    with cluster() as (s, [a, b]):
+        with Client(s['address'], loop=loop) as client:  # noqa: F841
+            with parallel_config(backend='dask'):
+                x, y = Parallel()(delayed(random2)() for i in range(2))
+                assert x != y
+
+
+@pytest.mark.parametrize("mixed", [True, False])
+def test_dask_funcname(loop, mixed):
+    from joblib._dask import Batch
+    if not mixed:
+        tasks = [delayed(inc)(i) for i in range(4)]
+        batch_repr = 'batch_of_inc_4_calls'
+    else:
+        tasks = [
+            delayed(abs)(i) if i % 2 else delayed(inc)(i) for i in range(4)
+        ]
+        batch_repr = 'mixed_batch_of_inc_4_calls'
+
+    assert repr(Batch(tasks)) == batch_repr
+
+    with cluster() as (s, [a, b]):
+        with Client(s['address'], loop=loop) as client:
+            with parallel_config(backend='dask'):
+                _ = Parallel(batch_size=2, pre_dispatch='all')(tasks)
+
+            def f(dask_scheduler):
+                return list(dask_scheduler.transition_log)
+            batch_repr = batch_repr.replace('4', '2')
+            log = client.run_on_scheduler(f)
+            assert all('batch_of_inc' in tup[0] for tup in log)
+
+
+def test_no_undesired_distributed_cache_hit():
+    # Dask has a pickle cache for callables that are called many times. Because
+    # the dask backends used to wrap both the functions and the arguments
+    # under instances of the Batch callable class this caching mechanism could
+    # lead to bugs as described in: https://github.com/joblib/joblib/pull/1055
+    # The joblib-dask backend has been refactored to avoid bundling the
+    # arguments as an attribute of the Batch instance to avoid this problem.
+    # This test serves as non-regression problem.
+
+    # Use a large number of input arguments to give the AutoBatchingMixin
+    # enough tasks to kick-in.
+    lists = [[] for _ in range(100)]
+    np = pytest.importorskip('numpy')
+    X = np.arange(int(1e6))
+
+    def isolated_operation(list_, data=None):
+        if data is not None:
+            np.testing.assert_array_equal(data, X)
+        list_.append(uuid4().hex)
+        return list_
+
+    cluster = LocalCluster(n_workers=1, threads_per_worker=2)
+    client = Client(cluster)
+    try:
+        with parallel_config(backend='dask'):
+            # dispatches joblib.parallel.BatchedCalls
+            res = Parallel()(
+                delayed(isolated_operation)(list_) for list_ in lists
+            )
+
+        # The original arguments should not have been mutated as the mutation
+        # happens in the dask worker process.
+        assert lists == [[] for _ in range(100)]
+
+        # Here we did not pass any large numpy array as argument to
+        # isolated_operation so no scattering event should happen under the
+        # hood.
+        counts = count_events('receive-from-scatter', client)
+        assert sum(counts.values()) == 0
+        assert all([len(r) == 1 for r in res])
+
+        with parallel_config(backend='dask'):
+            # Append a large array which will be scattered by dask, and
+            # dispatch joblib._dask.Batch
+            res = Parallel()(
+                delayed(isolated_operation)(list_, data=X) for list_ in lists
+            )
+
+        # This time, auto-scattering should have kicked it.
+        counts = count_events('receive-from-scatter', client)
+        assert sum(counts.values()) > 0
+        assert all([len(r) == 1 for r in res])
+    finally:
+        client.close(timeout=30)
+        cluster.close(timeout=30)
+
+
+class CountSerialized(object):
+    def __init__(self, x):
+        self.x = x
+        self.count = 0
+
+    def __add__(self, other):
+        return self.x + getattr(other, 'x', other)
+
+    __radd__ = __add__
+
+    def __reduce__(self):
+        self.count += 1
+        return (CountSerialized, (self.x,))
+
+
+def add5(a, b, c, d=0, e=0):
+    return a + b + c + d + e
+
+
+def test_manual_scatter(loop):
+    x = CountSerialized(1)
+    y = CountSerialized(2)
+    z = CountSerialized(3)
+
+    with cluster() as (s, [a, b]):
+        with Client(s['address'], loop=loop) as client:  # noqa: F841
+            with parallel_config(backend='dask', scatter=[x, y]):
+                f = delayed(add5)
+                tasks = [f(x, y, z, d=4, e=5),
+                         f(x, z, y, d=5, e=4),
+                         f(y, x, z, d=x, e=5),
+                         f(z, z, x, d=z, e=y)]
+                expected = [func(*args, **kwargs)
+                            for func, args, kwargs in tasks]
+                results = Parallel()(tasks)
+
+            # Scatter must take a list/tuple
+            with pytest.raises(TypeError):
+                with parallel_config(backend='dask', loop=loop, scatter=1):
+                    pass
+
+    assert results == expected
+
+    # Scattered variables only serialized once
+    assert x.count == 1
+    assert y.count == 1
+    # Depending on the version of distributed, the unscattered z variable
+    # is either pickled 4 or 6 times, possibly because of the memoization
+    # of objects that appear several times in the arguments of a delayed
+    # task.
+    assert z.count in (4, 6)
+
+
+# When the same IOLoop is used for multiple clients in a row, use
+# loop_in_thread instead of loop to prevent the Client from closing it.  See
+# dask/distributed #4112
+def test_auto_scatter(loop_in_thread):
+    np = pytest.importorskip('numpy')
+    data1 = np.ones(int(1e4), dtype=np.uint8)
+    data2 = np.ones(int(1e4), dtype=np.uint8)
+    data_to_process = ([data1] * 3) + ([data2] * 3)
+
+    with cluster() as (s, [a, b]):
+        with Client(s['address'], loop=loop_in_thread) as client:
+            with parallel_config(backend='dask'):
+                # Passing the same data as arg and kwarg triggers a single
+                # scatter operation whose result is reused.
+                Parallel()(delayed(noop)(data, data, i, opt=data)
+                           for i, data in enumerate(data_to_process))
+            # By default large array are automatically scattered with
+            # broadcast=1 which means that one worker must directly receive
+            # the data from the scatter operation once.
+            counts = count_events('receive-from-scatter', client)
+            assert counts[a['address']] + counts[b['address']] == 2
+
+    with cluster() as (s, [a, b]):
+        with Client(s['address'], loop=loop_in_thread) as client:
+            with parallel_config(backend='dask'):
+                Parallel()(delayed(noop)(data1[:3], i) for i in range(5))
+            # Small arrays are passed within the task definition without going
+            # through a scatter operation.
+            counts = count_events('receive-from-scatter', client)
+            assert counts[a['address']] == 0
+            assert counts[b['address']] == 0
+
+
+@pytest.mark.parametrize("retry_no", list(range(2)))
+def test_nested_scatter(loop, retry_no):
+
+    np = pytest.importorskip('numpy')
+
+    NUM_INNER_TASKS = 10
+    NUM_OUTER_TASKS = 10
+
+    def my_sum(x, i, j):
+        return np.sum(x)
+
+    def outer_function_joblib(array, i):
+        client = get_client()  # noqa
+        with parallel_config(backend="dask"):
+            results = Parallel()(
+                delayed(my_sum)(array[j:], i, j) for j in range(
+                    NUM_INNER_TASKS)
+            )
+        return sum(results)
+
+    with cluster() as (s, [a, b]):
+        with Client(s['address'], loop=loop) as _:
+            with parallel_config(backend="dask"):
+                my_array = np.ones(10000)
+                _ = Parallel()(
+                    delayed(outer_function_joblib)(
+                        my_array[i:], i) for i in range(NUM_OUTER_TASKS)
+                )
+
+
+def test_nested_backend_context_manager(loop_in_thread):
+    def get_nested_pids():
+        pids = set(Parallel(n_jobs=2)(delayed(os.getpid)() for _ in range(2)))
+        pids |= set(Parallel(n_jobs=2)(delayed(os.getpid)() for _ in range(2)))
+        return pids
+
+    with cluster() as (s, [a, b]):
+        with Client(s['address'], loop=loop_in_thread) as client:
+            with parallel_config(backend='dask'):
+                pid_groups = Parallel(n_jobs=2)(
+                    delayed(get_nested_pids)()
+                    for _ in range(10)
+                )
+                for pid_group in pid_groups:
+                    assert len(set(pid_group)) <= 2
+
+        # No deadlocks
+        with Client(s['address'], loop=loop_in_thread) as client:  # noqa: F841
+            with parallel_config(backend='dask'):
+                pid_groups = Parallel(n_jobs=2)(
+                    delayed(get_nested_pids)()
+                    for _ in range(10)
+                )
+                for pid_group in pid_groups:
+                    assert len(set(pid_group)) <= 2
+
+
+def test_nested_backend_context_manager_implicit_n_jobs(loop):
+    # Check that Parallel with no explicit n_jobs value automatically selects
+    # all the dask workers, including in nested calls.
+
+    def _backend_type(p):
+        return p._backend.__class__.__name__
+
+    def get_nested_implicit_n_jobs():
+        with Parallel() as p:
+            return _backend_type(p), p.n_jobs
+
+    with cluster() as (s, [a, b]):
+        with Client(s['address'], loop=loop) as client:  # noqa: F841
+            with parallel_config(backend='dask'):
+                with Parallel() as p:
+                    assert _backend_type(p) == "DaskDistributedBackend"
+                    assert p.n_jobs == -1
+                    all_nested_n_jobs = p(
+                        delayed(get_nested_implicit_n_jobs)()
+                        for _ in range(2)
+                    )
+                for backend_type, nested_n_jobs in all_nested_n_jobs:
+                    assert backend_type == "DaskDistributedBackend"
+                    assert nested_n_jobs == -1
+
+
+def test_errors(loop):
+    with pytest.raises(ValueError) as info:
+        with parallel_config(backend='dask'):
+            pass
+
+    assert "create a dask client" in str(info.value).lower()
+
+
+def test_correct_nested_backend(loop):
+    with cluster() as (s, [a, b]):
+        with Client(s['address'], loop=loop) as client:  # noqa: F841
+            # No requirement, should be us
+            with parallel_config(backend='dask'):
+                result = Parallel(n_jobs=2)(
+                    delayed(outer)(nested_require=None) for _ in range(1))
+                assert isinstance(result[0][0][0], DaskDistributedBackend)
+
+            # Require threads, should be threading
+            with parallel_config(backend='dask'):
+                result = Parallel(n_jobs=2)(
+                    delayed(outer)(nested_require='sharedmem')
+                    for _ in range(1))
+                assert isinstance(result[0][0][0], ThreadingBackend)
+
+
+def outer(nested_require):
+    return Parallel(n_jobs=2, prefer='threads')(
+        delayed(middle)(nested_require) for _ in range(1)
+    )
+
+
+def middle(require):
+    return Parallel(n_jobs=2, require=require)(
+        delayed(inner)() for _ in range(1)
+    )
+
+
+def inner():
+    return Parallel()._backend
+
+
+def test_secede_with_no_processes(loop):
+    # https://github.com/dask/distributed/issues/1775
+    with Client(loop=loop, processes=False, set_as_default=True):
+        with parallel_config(backend='dask'):
+            Parallel(n_jobs=4)(delayed(id)(i) for i in range(2))
+
+
+def _worker_address(_):
+    from distributed import get_worker
+    return get_worker().address
+
+
+def test_dask_backend_keywords(loop):
+    with cluster() as (s, [a, b]):
+        with Client(s['address'], loop=loop) as client:  # noqa: F841
+            with parallel_config(backend='dask', workers=a['address']):
+                seq = Parallel()(
+                    delayed(_worker_address)(i) for i in range(10))
+                assert seq == [a['address']] * 10
+
+            with parallel_config(backend='dask', workers=b['address']):
+                seq = Parallel()(
+                    delayed(_worker_address)(i) for i in range(10))
+                assert seq == [b['address']] * 10
+
+
+def test_scheduler_tasks_cleanup(loop):
+    with Client(processes=False, loop=loop) as client:
+        with parallel_config(backend='dask'):
+            Parallel()(delayed(inc)(i) for i in range(10))
+
+        start = time()
+        while client.cluster.scheduler.tasks:
+            sleep(0.01)
+            assert time() < start + 5
+
+        assert not client.futures
+
+
+@pytest.mark.parametrize("cluster_strategy", ["adaptive", "late_scaling"])
+@pytest.mark.skipif(
+    distributed.__version__ <= '2.1.1' and distributed.__version__ >= '1.28.0',
+    reason="distributed bug - https://github.com/dask/distributed/pull/2841")
+def test_wait_for_workers(cluster_strategy):
+    cluster = LocalCluster(n_workers=0, processes=False, threads_per_worker=2)
+    client = Client(cluster)
+    if cluster_strategy == "adaptive":
+        cluster.adapt(minimum=0, maximum=2)
+    elif cluster_strategy == "late_scaling":
+        # Tell the cluster to start workers but this is a non-blocking call
+        # and new workers might take time to connect. In this case the Parallel
+        # call should wait for at least one worker to come up before starting
+        # to schedule work.
+        cluster.scale(2)
+    try:
+        with parallel_config(backend='dask'):
+            # The following should wait a bit for at least one worker to
+            # become available.
+            Parallel()(delayed(inc)(i) for i in range(10))
+    finally:
+        client.close()
+        cluster.close()
+
+
+def test_wait_for_workers_timeout():
+    # Start a cluster with 0 worker:
+    cluster = LocalCluster(n_workers=0, processes=False, threads_per_worker=2)
+    client = Client(cluster)
+    try:
+        with parallel_config(backend='dask', wait_for_workers_timeout=0.1):
+            # Short timeout: DaskDistributedBackend
+            msg = "DaskDistributedBackend has no worker after 0.1 seconds."
+            with pytest.raises(TimeoutError, match=msg):
+                Parallel()(delayed(inc)(i) for i in range(10))
+
+        with parallel_config(backend='dask', wait_for_workers_timeout=0):
+            # No timeout: fallback to generic joblib failure:
+            msg = "DaskDistributedBackend has no active worker"
+            with pytest.raises(RuntimeError, match=msg):
+                Parallel()(delayed(inc)(i) for i in range(10))
+    finally:
+        client.close()
+        cluster.close()
+
+
+@pytest.mark.parametrize("backend", ["loky", "multiprocessing"])
+def test_joblib_warning_inside_dask_daemonic_worker(backend):
+    cluster = LocalCluster(n_workers=2)
+    client = Client(cluster)
+    try:
+
+        def func_using_joblib_parallel():
+            # Somehow trying to check the warning type here (e.g. with
+            # pytest.warns(UserWarning)) make the test hang. Work-around:
+            # return the warning record to the client and the warning check is
+            # done client-side.
+            with warnings.catch_warnings(record=True) as record:
+                Parallel(n_jobs=2, backend=backend)(
+                    delayed(inc)(i) for i in range(10))
+
+            return record
+
+        fut = client.submit(func_using_joblib_parallel)
+        record = fut.result()
+
+        assert len(record) == 1
+        warning = record[0].message
+        assert isinstance(warning, UserWarning)
+        assert "distributed.worker.daemon" in str(warning)
+    finally:
+        client.close(timeout=30)
+        cluster.close(timeout=30)
diff --git a/llm/Lib/site-packages/joblib/test/test_disk.py b/llm/Lib/site-packages/joblib/test/test_disk.py
new file mode 100644
index 0000000000000000000000000000000000000000..b825a8b3a5c18a3114f34ed9d7c90cce62799085
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_disk.py
@@ -0,0 +1,71 @@
+"""
+Unit tests for the disk utilities.
+"""
+
+# Authors: Gael Varoquaux <gael dot varoquaux at normalesup dot org>
+#          Lars Buitinck
+# Copyright (c) 2010 Gael Varoquaux
+# License: BSD Style, 3 clauses.
+
+from __future__ import with_statement
+import array
+import os
+
+from joblib.disk import disk_used, memstr_to_bytes, mkdirp, rm_subdirs
+from joblib.testing import parametrize, raises
+
+###############################################################################
+
+
+def test_disk_used(tmpdir):
+    cachedir = tmpdir.strpath
+    # Not write a file that is 1M big in this directory, and check the
+    # size. The reason we use such a big file is that it makes us robust
+    # to errors due to block allocation.
+    a = array.array('i')
+    sizeof_i = a.itemsize
+    target_size = 1024
+    n = int(target_size * 1024 / sizeof_i)
+    a = array.array('i', n * (1,))
+    with open(os.path.join(cachedir, 'test'), 'wb') as output:
+        a.tofile(output)
+    assert disk_used(cachedir) >= target_size
+    assert disk_used(cachedir) < target_size + 12
+
+
+@parametrize('text,value',
+             [('80G', 80 * 1024 ** 3),
+              ('1.4M', int(1.4 * 1024 ** 2)),
+              ('120M', 120 * 1024 ** 2),
+              ('53K', 53 * 1024)])
+def test_memstr_to_bytes(text, value):
+    assert memstr_to_bytes(text) == value
+
+
+@parametrize('text,exception,regex',
+             [('fooG', ValueError, r'Invalid literal for size.*fooG.*'),
+              ('1.4N', ValueError, r'Invalid literal for size.*1.4N.*')])
+def test_memstr_to_bytes_exception(text, exception, regex):
+    with raises(exception) as excinfo:
+        memstr_to_bytes(text)
+    assert excinfo.match(regex)
+
+
+def test_mkdirp(tmpdir):
+    mkdirp(os.path.join(tmpdir.strpath, 'ham'))
+    mkdirp(os.path.join(tmpdir.strpath, 'ham'))
+    mkdirp(os.path.join(tmpdir.strpath, 'spam', 'spam'))
+
+    # Not all OSErrors are ignored
+    with raises(OSError):
+        mkdirp('')
+
+
+def test_rm_subdirs(tmpdir):
+    sub_path = os.path.join(tmpdir.strpath, "am", "stram")
+    full_path = os.path.join(sub_path, "gram")
+    mkdirp(os.path.join(full_path))
+
+    rm_subdirs(sub_path)
+    assert os.path.exists(sub_path)
+    assert not os.path.exists(full_path)
diff --git a/llm/Lib/site-packages/joblib/test/test_func_inspect.py b/llm/Lib/site-packages/joblib/test/test_func_inspect.py
new file mode 100644
index 0000000000000000000000000000000000000000..dba237d48578e5d6386e67e80f3e6d31761108d6
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_func_inspect.py
@@ -0,0 +1,310 @@
+"""
+Test the func_inspect module.
+"""
+
+# Author: Gael Varoquaux <gael dot varoquaux at normalesup dot org>
+# Copyright (c) 2009 Gael Varoquaux
+# License: BSD Style, 3 clauses.
+
+import functools
+
+from joblib.func_inspect import filter_args, get_func_name, get_func_code
+from joblib.func_inspect import _clean_win_chars, format_signature
+from joblib.memory import Memory
+from joblib.test.common import with_numpy
+from joblib.testing import fixture, parametrize, raises
+
+
+###############################################################################
+# Module-level functions and fixture, for tests
+def f(x, y=0):
+    pass
+
+
+def g(x):
+    pass
+
+
+def h(x, y=0, *args, **kwargs):
+    pass
+
+
+def i(x=1):
+    pass
+
+
+def j(x, y, **kwargs):
+    pass
+
+
+def k(*args, **kwargs):
+    pass
+
+
+def m1(x, *, y):
+    pass
+
+
+def m2(x, *, y, z=3):
+    pass
+
+
+@fixture(scope='module')
+def cached_func(tmpdir_factory):
+    # Create a Memory object to test decorated functions.
+    # We should be careful not to call the decorated functions, so that
+    # cache directories are not created in the temp dir.
+    cachedir = tmpdir_factory.mktemp("joblib_test_func_inspect")
+    mem = Memory(cachedir.strpath)
+
+    @mem.cache
+    def cached_func_inner(x):
+        return x
+
+    return cached_func_inner
+
+
+class Klass(object):
+
+    def f(self, x):
+        return x
+
+
+###############################################################################
+# Tests
+
+@parametrize('func,args,filtered_args',
+             [(f, [[], (1, )], {'x': 1, 'y': 0}),
+              (f, [['x'], (1, )], {'y': 0}),
+              (f, [['y'], (0, )], {'x': 0}),
+              (f, [['y'], (0, ), {'y': 1}], {'x': 0}),
+              (f, [['x', 'y'], (0, )], {}),
+              (f, [[], (0,), {'y': 1}], {'x': 0, 'y': 1}),
+              (f, [['y'], (), {'x': 2, 'y': 1}], {'x': 2}),
+              (g, [[], (), {'x': 1}], {'x': 1}),
+              (i, [[], (2, )], {'x': 2})])
+def test_filter_args(func, args, filtered_args):
+    assert filter_args(func, *args) == filtered_args
+
+
+def test_filter_args_method():
+    obj = Klass()
+    assert filter_args(obj.f, [], (1, )) == {'x': 1, 'self': obj}
+
+
+@parametrize('func,args,filtered_args',
+             [(h, [[], (1, )],
+               {'x': 1, 'y': 0, '*': [], '**': {}}),
+              (h, [[], (1, 2, 3, 4)],
+               {'x': 1, 'y': 2, '*': [3, 4], '**': {}}),
+              (h, [[], (1, 25), {'ee': 2}],
+               {'x': 1, 'y': 25, '*': [], '**': {'ee': 2}}),
+              (h, [['*'], (1, 2, 25), {'ee': 2}],
+               {'x': 1, 'y': 2, '**': {'ee': 2}})])
+def test_filter_varargs(func, args, filtered_args):
+    assert filter_args(func, *args) == filtered_args
+
+
+test_filter_kwargs_extra_params = [
+    (m1, [[], (1,), {'y': 2}], {'x': 1, 'y': 2}),
+    (m2, [[], (1,), {'y': 2}], {'x': 1, 'y': 2, 'z': 3})
+]
+
+
+@parametrize('func,args,filtered_args',
+             [(k, [[], (1, 2), {'ee': 2}],
+               {'*': [1, 2], '**': {'ee': 2}}),
+              (k, [[], (3, 4)],
+               {'*': [3, 4], '**': {}})] +
+             test_filter_kwargs_extra_params)
+def test_filter_kwargs(func, args, filtered_args):
+    assert filter_args(func, *args) == filtered_args
+
+
+def test_filter_args_2():
+    assert (filter_args(j, [], (1, 2), {'ee': 2}) ==
+            {'x': 1, 'y': 2, '**': {'ee': 2}})
+
+    ff = functools.partial(f, 1)
+    # filter_args has to special-case partial
+    assert filter_args(ff, [], (1, )) == {'*': [1], '**': {}}
+    assert filter_args(ff, ['y'], (1, )) == {'*': [1], '**': {}}
+
+
+@parametrize('func,funcname', [(f, 'f'), (g, 'g'),
+                               (cached_func, 'cached_func')])
+def test_func_name(func, funcname):
+    # Check that we are not confused by decoration
+    # here testcase 'cached_func' is the function itself
+    assert get_func_name(func)[1] == funcname
+
+
+def test_func_name_on_inner_func(cached_func):
+    # Check that we are not confused by decoration
+    # here testcase 'cached_func' is the 'cached_func_inner' function
+    # returned by 'cached_func' fixture
+    assert get_func_name(cached_func)[1] == 'cached_func_inner'
+
+
+def test_func_name_collision_on_inner_func():
+    # Check that two functions defining and caching an inner function
+    # with the same do not cause (module, name) collision
+    def f():
+        def inner_func():
+            return  # pragma: no cover
+        return get_func_name(inner_func)
+
+    def g():
+        def inner_func():
+            return  # pragma: no cover
+        return get_func_name(inner_func)
+
+    module, name = f()
+    other_module, other_name = g()
+
+    assert name == other_name
+    assert module != other_module
+
+
+def test_func_inspect_errors():
+    # Check that func_inspect is robust and will work on weird objects
+    assert get_func_name('a'.lower)[-1] == 'lower'
+    assert get_func_code('a'.lower)[1:] == (None, -1)
+    ff = lambda x: x  # noqa: E731
+    assert get_func_name(ff, win_characters=False)[-1] == '<lambda>'
+    assert get_func_code(ff)[1] == __file__.replace('.pyc', '.py')
+    # Simulate a function defined in __main__
+    ff.__module__ = '__main__'
+    assert get_func_name(ff, win_characters=False)[-1] == '<lambda>'
+    assert get_func_code(ff)[1] == __file__.replace('.pyc', '.py')
+
+
+def func_with_kwonly_args(a, b, *, kw1='kw1', kw2='kw2'):
+    pass
+
+
+def func_with_signature(a: int, b: int) -> None:
+    pass
+
+
+def test_filter_args_edge_cases():
+    assert (
+        filter_args(func_with_kwonly_args, [], (1, 2),
+                    {'kw1': 3, 'kw2': 4}) ==
+        {'a': 1, 'b': 2, 'kw1': 3, 'kw2': 4})
+
+    # filter_args doesn't care about keyword-only arguments so you
+    # can pass 'kw1' into *args without any problem
+    with raises(ValueError) as excinfo:
+        filter_args(func_with_kwonly_args, [], (1, 2, 3), {'kw2': 2})
+    excinfo.match("Keyword-only parameter 'kw1' was passed as positional "
+                  "parameter")
+
+    assert (
+        filter_args(func_with_kwonly_args, ['b', 'kw2'], (1, 2),
+                    {'kw1': 3, 'kw2': 4}) ==
+        {'a': 1, 'kw1': 3})
+
+    assert (filter_args(func_with_signature, ['b'], (1, 2)) == {'a': 1})
+
+
+def test_bound_methods():
+    """ Make sure that calling the same method on two different instances
+        of the same class does resolv to different signatures.
+    """
+    a = Klass()
+    b = Klass()
+    assert filter_args(a.f, [], (1, )) != filter_args(b.f, [], (1, ))
+
+
+@parametrize('exception,regex,func,args',
+             [(ValueError, 'ignore_lst must be a list of parameters to ignore',
+               f, ['bar', (None, )]),
+              (ValueError, r'Ignore list: argument \'(.*)\' is not defined',
+               g, [['bar'], (None, )]),
+              (ValueError, 'Wrong number of arguments',
+               h, [[]])])
+def test_filter_args_error_msg(exception, regex, func, args):
+    """ Make sure that filter_args returns decent error messages, for the
+        sake of the user.
+    """
+    with raises(exception) as excinfo:
+        filter_args(func, *args)
+    excinfo.match(regex)
+
+
+def test_filter_args_no_kwargs_mutation():
+    """None-regression test against 0.12.0 changes.
+
+    https://github.com/joblib/joblib/pull/75
+
+    Make sure filter args doesn't mutate the kwargs dict that gets passed in.
+    """
+    kwargs = {'x': 0}
+    filter_args(g, [], [], kwargs)
+    assert kwargs == {'x': 0}
+
+
+def test_clean_win_chars():
+    string = r'C:\foo\bar\main.py'
+    mangled_string = _clean_win_chars(string)
+    for char in ('\\', ':', '<', '>', '!'):
+        assert char not in mangled_string
+
+
+@parametrize('func,args,kwargs,sgn_expected',
+             [(g, [list(range(5))], {}, 'g([0, 1, 2, 3, 4])'),
+              (k, [1, 2, (3, 4)], {'y': True}, 'k(1, 2, (3, 4), y=True)')])
+def test_format_signature(func, args, kwargs, sgn_expected):
+    # Test signature formatting.
+    path, sgn_result = format_signature(func, *args, **kwargs)
+    assert sgn_result == sgn_expected
+
+
+def test_format_signature_long_arguments():
+    shortening_threshold = 1500
+    # shortening gets it down to 700 characters but there is the name
+    # of the function in the signature and a few additional things
+    # like dots for the ellipsis
+    shortening_target = 700 + 10
+
+    arg = 'a' * shortening_threshold
+    _, signature = format_signature(h, arg)
+    assert len(signature) < shortening_target
+
+    nb_args = 5
+    args = [arg for _ in range(nb_args)]
+    _, signature = format_signature(h, *args)
+    assert len(signature) < shortening_target * nb_args
+
+    kwargs = {str(i): arg for i, arg in enumerate(args)}
+    _, signature = format_signature(h, **kwargs)
+    assert len(signature) < shortening_target * nb_args
+
+    _, signature = format_signature(h, *args, **kwargs)
+    assert len(signature) < shortening_target * 2 * nb_args
+
+
+@with_numpy
+def test_format_signature_numpy():
+    """ Test the format signature formatting with numpy.
+    """
+
+
+def test_special_source_encoding():
+    from joblib.test.test_func_inspect_special_encoding import big5_f
+    func_code, source_file, first_line = get_func_code(big5_f)
+    assert first_line == 5
+    assert "def big5_f():" in func_code
+    assert "test_func_inspect_special_encoding" in source_file
+
+
+def _get_code():
+    from joblib.test.test_func_inspect_special_encoding import big5_f
+    return get_func_code(big5_f)[0]
+
+
+def test_func_code_consistency():
+    from joblib.parallel import Parallel, delayed
+    codes = Parallel(n_jobs=2)(delayed(_get_code)() for _ in range(5))
+    assert len(set(codes)) == 1
diff --git a/llm/Lib/site-packages/joblib/test/test_func_inspect_special_encoding.py b/llm/Lib/site-packages/joblib/test/test_func_inspect_special_encoding.py
new file mode 100644
index 0000000000000000000000000000000000000000..6c41a59a6900ced36050bf357359c1164a11fdbe
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_func_inspect_special_encoding.py
@@ -0,0 +1,9 @@
+# -*- coding: big5 -*-
+
+
+# Some Traditional Chinese characters: �@�Ǥ���r��
+def big5_f():
+    """�Ω���ժ����
+    """
+    # ����
+    return 0
diff --git a/llm/Lib/site-packages/joblib/test/test_hashing.py b/llm/Lib/site-packages/joblib/test/test_hashing.py
new file mode 100644
index 0000000000000000000000000000000000000000..85593d297f6e2387c58cad8d5bceba4d21b1c0aa
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_hashing.py
@@ -0,0 +1,495 @@
+"""
+Test the hashing module.
+"""
+
+# Author: Gael Varoquaux <gael dot varoquaux at normalesup dot org>
+# Copyright (c) 2009 Gael Varoquaux
+# License: BSD Style, 3 clauses.
+
+import time
+import hashlib
+import sys
+import gc
+import io
+import collections
+import itertools
+import pickle
+import random
+from concurrent.futures import ProcessPoolExecutor
+from decimal import Decimal
+
+from joblib.hashing import hash
+from joblib.func_inspect import filter_args
+from joblib.memory import Memory
+from joblib.testing import raises, skipif, fixture, parametrize
+from joblib.test.common import np, with_numpy
+
+
+def unicode(s):
+    return s
+
+
+###############################################################################
+# Helper functions for the tests
+def time_func(func, *args):
+    """ Time function func on *args.
+    """
+    times = list()
+    for _ in range(3):
+        t1 = time.time()
+        func(*args)
+        times.append(time.time() - t1)
+    return min(times)
+
+
+def relative_time(func1, func2, *args):
+    """ Return the relative time between func1 and func2 applied on
+        *args.
+    """
+    time_func1 = time_func(func1, *args)
+    time_func2 = time_func(func2, *args)
+    relative_diff = 0.5 * (abs(time_func1 - time_func2)
+                           / (time_func1 + time_func2))
+    return relative_diff
+
+
+class Klass(object):
+
+    def f(self, x):
+        return x
+
+
+class KlassWithCachedMethod(object):
+
+    def __init__(self, cachedir):
+        mem = Memory(location=cachedir)
+        self.f = mem.cache(self.f)
+
+    def f(self, x):
+        return x
+
+
+###############################################################################
+# Tests
+
+input_list = [1, 2, 1., 2., 1 + 1j, 2. + 1j,
+              'a', 'b',
+              (1,), (1, 1,), [1, ], [1, 1, ],
+              {1: 1}, {1: 2}, {2: 1},
+              None,
+              gc.collect,
+              [1, ].append,
+              # Next 2 sets have unorderable elements in python 3.
+              set(('a', 1)),
+              set(('a', 1, ('a', 1))),
+              # Next 2 dicts have unorderable type of keys in python 3.
+              {'a': 1, 1: 2},
+              {'a': 1, 1: 2, 'd': {'a': 1}}]
+
+
+@parametrize('obj1', input_list)
+@parametrize('obj2', input_list)
+def test_trivial_hash(obj1, obj2):
+    """Smoke test hash on various types."""
+    # Check that 2 objects have the same hash only if they are the same.
+    are_hashes_equal = hash(obj1) == hash(obj2)
+    are_objs_identical = obj1 is obj2
+    assert are_hashes_equal == are_objs_identical
+
+
+def test_hash_methods():
+    # Check that hashing instance methods works
+    a = io.StringIO(unicode('a'))
+    assert hash(a.flush) == hash(a.flush)
+    a1 = collections.deque(range(10))
+    a2 = collections.deque(range(9))
+    assert hash(a1.extend) != hash(a2.extend)
+
+
+@fixture(scope='function')
+@with_numpy
+def three_np_arrays():
+    rnd = np.random.RandomState(0)
+    arr1 = rnd.random_sample((10, 10))
+    arr2 = arr1.copy()
+    arr3 = arr2.copy()
+    arr3[0] += 1
+    return arr1, arr2, arr3
+
+
+def test_hash_numpy_arrays(three_np_arrays):
+    arr1, arr2, arr3 = three_np_arrays
+
+    for obj1, obj2 in itertools.product(three_np_arrays, repeat=2):
+        are_hashes_equal = hash(obj1) == hash(obj2)
+        are_arrays_equal = np.all(obj1 == obj2)
+        assert are_hashes_equal == are_arrays_equal
+
+    assert hash(arr1) != hash(arr1.T)
+
+
+def test_hash_numpy_dict_of_arrays(three_np_arrays):
+    arr1, arr2, arr3 = three_np_arrays
+
+    d1 = {1: arr1, 2: arr2}
+    d2 = {1: arr2, 2: arr1}
+    d3 = {1: arr2, 2: arr3}
+
+    assert hash(d1) == hash(d2)
+    assert hash(d1) != hash(d3)
+
+
+@with_numpy
+@parametrize('dtype', ['datetime64[s]', 'timedelta64[D]'])
+def test_numpy_datetime_array(dtype):
+    # memoryview is not supported for some dtypes e.g. datetime64
+    # see https://github.com/joblib/joblib/issues/188 for more details
+    a_hash = hash(np.arange(10))
+    array = np.arange(0, 10, dtype=dtype)
+    assert hash(array) != a_hash
+
+
+@with_numpy
+def test_hash_numpy_noncontiguous():
+    a = np.asarray(np.arange(6000).reshape((1000, 2, 3)),
+                   order='F')[:, :1, :]
+    b = np.ascontiguousarray(a)
+    assert hash(a) != hash(b)
+
+    c = np.asfortranarray(a)
+    assert hash(a) != hash(c)
+
+
+@with_numpy
+@parametrize('coerce_mmap', [True, False])
+def test_hash_memmap(tmpdir, coerce_mmap):
+    """Check that memmap and arrays hash identically if coerce_mmap is True."""
+    filename = tmpdir.join('memmap_temp').strpath
+    try:
+        m = np.memmap(filename, shape=(10, 10), mode='w+')
+        a = np.asarray(m)
+        are_hashes_equal = (hash(a, coerce_mmap=coerce_mmap) ==
+                            hash(m, coerce_mmap=coerce_mmap))
+        assert are_hashes_equal == coerce_mmap
+    finally:
+        if 'm' in locals():
+            del m
+            # Force a garbage-collection cycle, to be certain that the
+            # object is delete, and we don't run in a problem under
+            # Windows with a file handle still open.
+            gc.collect()
+
+
+@with_numpy
+@skipif(sys.platform == 'win32', reason='This test is not stable under windows'
+                                        ' for some reason')
+def test_hash_numpy_performance():
+    """ Check the performance of hashing numpy arrays:
+
+        In [22]: a = np.random.random(1000000)
+
+        In [23]: %timeit hashlib.md5(a).hexdigest()
+        100 loops, best of 3: 20.7 ms per loop
+
+        In [24]: %timeit hashlib.md5(pickle.dumps(a, protocol=2)).hexdigest()
+        1 loops, best of 3: 73.1 ms per loop
+
+        In [25]: %timeit hashlib.md5(cPickle.dumps(a, protocol=2)).hexdigest()
+        10 loops, best of 3: 53.9 ms per loop
+
+        In [26]: %timeit hash(a)
+        100 loops, best of 3: 20.8 ms per loop
+    """
+    rnd = np.random.RandomState(0)
+    a = rnd.random_sample(1000000)
+
+    def md5_hash(x):
+        return hashlib.md5(memoryview(x)).hexdigest()
+
+    relative_diff = relative_time(md5_hash, hash, a)
+    assert relative_diff < 0.3
+
+    # Check that hashing an tuple of 3 arrays takes approximately
+    # 3 times as much as hashing one array
+    time_hashlib = 3 * time_func(md5_hash, a)
+    time_hash = time_func(hash, (a, a, a))
+    relative_diff = 0.5 * (abs(time_hash - time_hashlib)
+                           / (time_hash + time_hashlib))
+    assert relative_diff < 0.3
+
+
+def test_bound_methods_hash():
+    """ Make sure that calling the same method on two different instances
+    of the same class does resolve to the same hashes.
+    """
+    a = Klass()
+    b = Klass()
+    assert (hash(filter_args(a.f, [], (1, ))) ==
+            hash(filter_args(b.f, [], (1, ))))
+
+
+def test_bound_cached_methods_hash(tmpdir):
+    """ Make sure that calling the same _cached_ method on two different
+    instances of the same class does resolve to the same hashes.
+    """
+    a = KlassWithCachedMethod(tmpdir.strpath)
+    b = KlassWithCachedMethod(tmpdir.strpath)
+    assert (hash(filter_args(a.f.func, [], (1, ))) ==
+            hash(filter_args(b.f.func, [], (1, ))))
+
+
+@with_numpy
+def test_hash_object_dtype():
+    """ Make sure that ndarrays with dtype `object' hash correctly."""
+
+    a = np.array([np.arange(i) for i in range(6)], dtype=object)
+    b = np.array([np.arange(i) for i in range(6)], dtype=object)
+
+    assert hash(a) == hash(b)
+
+
+@with_numpy
+def test_numpy_scalar():
+    # Numpy scalars are built from compiled functions, and lead to
+    # strange pickling paths explored, that can give hash collisions
+    a = np.float64(2.0)
+    b = np.float64(3.0)
+    assert hash(a) != hash(b)
+
+
+def test_dict_hash(tmpdir):
+    # Check that dictionaries hash consistently, even though the ordering
+    # of the keys is not guaranteed
+    k = KlassWithCachedMethod(tmpdir.strpath)
+
+    d = {'#s12069__c_maps.nii.gz': [33],
+         '#s12158__c_maps.nii.gz': [33],
+         '#s12258__c_maps.nii.gz': [33],
+         '#s12277__c_maps.nii.gz': [33],
+         '#s12300__c_maps.nii.gz': [33],
+         '#s12401__c_maps.nii.gz': [33],
+         '#s12430__c_maps.nii.gz': [33],
+         '#s13817__c_maps.nii.gz': [33],
+         '#s13903__c_maps.nii.gz': [33],
+         '#s13916__c_maps.nii.gz': [33],
+         '#s13981__c_maps.nii.gz': [33],
+         '#s13982__c_maps.nii.gz': [33],
+         '#s13983__c_maps.nii.gz': [33]}
+
+    a = k.f(d)
+    b = k.f(a)
+
+    assert hash(a) == hash(b)
+
+
+def test_set_hash(tmpdir):
+    # Check that sets hash consistently, even though their ordering
+    # is not guaranteed
+    k = KlassWithCachedMethod(tmpdir.strpath)
+
+    s = set(['#s12069__c_maps.nii.gz',
+             '#s12158__c_maps.nii.gz',
+             '#s12258__c_maps.nii.gz',
+             '#s12277__c_maps.nii.gz',
+             '#s12300__c_maps.nii.gz',
+             '#s12401__c_maps.nii.gz',
+             '#s12430__c_maps.nii.gz',
+             '#s13817__c_maps.nii.gz',
+             '#s13903__c_maps.nii.gz',
+             '#s13916__c_maps.nii.gz',
+             '#s13981__c_maps.nii.gz',
+             '#s13982__c_maps.nii.gz',
+             '#s13983__c_maps.nii.gz'])
+
+    a = k.f(s)
+    b = k.f(a)
+
+    assert hash(a) == hash(b)
+
+
+def test_set_decimal_hash():
+    # Check that sets containing decimals hash consistently, even though
+    # ordering is not guaranteed
+    assert (hash(set([Decimal(0), Decimal('NaN')])) ==
+            hash(set([Decimal('NaN'), Decimal(0)])))
+
+
+def test_string():
+    # Test that we obtain the same hash for object owning several strings,
+    # whatever the past of these strings (which are immutable in Python)
+    string = 'foo'
+    a = {string: 'bar'}
+    b = {string: 'bar'}
+    c = pickle.loads(pickle.dumps(b))
+    assert hash([a, b]) == hash([a, c])
+
+
+@with_numpy
+def test_numpy_dtype_pickling():
+    # numpy dtype hashing is tricky to get right: see #231, #239, #251 #1080,
+    # #1082, and explanatory comments inside
+    # ``joblib.hashing.NumpyHasher.save``.
+
+    # In this test, we make sure that the pickling of numpy dtypes is robust to
+    # object identity and object copy.
+
+    dt1 = np.dtype('f4')
+    dt2 = np.dtype('f4')
+
+    # simple dtypes objects are interned
+    assert dt1 is dt2
+    assert hash(dt1) == hash(dt2)
+
+    dt1_roundtripped = pickle.loads(pickle.dumps(dt1))
+    assert dt1 is not dt1_roundtripped
+    assert hash(dt1) == hash(dt1_roundtripped)
+
+    assert hash([dt1, dt1]) == hash([dt1_roundtripped, dt1_roundtripped])
+    assert hash([dt1, dt1]) == hash([dt1, dt1_roundtripped])
+
+    complex_dt1 = np.dtype(
+        [('name', np.str_, 16), ('grades', np.float64, (2,))]
+    )
+    complex_dt2 = np.dtype(
+        [('name', np.str_, 16), ('grades', np.float64, (2,))]
+    )
+
+    # complex dtypes objects are not interned
+    assert hash(complex_dt1) == hash(complex_dt2)
+
+    complex_dt1_roundtripped = pickle.loads(pickle.dumps(complex_dt1))
+    assert complex_dt1_roundtripped is not complex_dt1
+    assert hash(complex_dt1) == hash(complex_dt1_roundtripped)
+
+    assert hash([complex_dt1, complex_dt1]) == hash(
+        [complex_dt1_roundtripped, complex_dt1_roundtripped]
+    )
+    assert hash([complex_dt1, complex_dt1]) == hash(
+        [complex_dt1_roundtripped, complex_dt1]
+    )
+
+
+@parametrize('to_hash,expected',
+             [('This is a string to hash',
+               '71b3f47df22cb19431d85d92d0b230b2'),
+              (u"C'est l\xe9t\xe9",
+               '2d8d189e9b2b0b2e384d93c868c0e576'),
+              ((123456, 54321, -98765),
+               'e205227dd82250871fa25aa0ec690aa3'),
+              ([random.Random(42).random() for _ in range(5)],
+               'a11ffad81f9682a7d901e6edc3d16c84'),
+              ({'abcde': 123, 'sadfas': [-9999, 2, 3]},
+                  'aeda150553d4bb5c69f0e69d51b0e2ef')])
+def test_hashes_stay_the_same(to_hash, expected):
+    # We want to make sure that hashes don't change with joblib
+    # version. For end users, that would mean that they have to
+    # regenerate their cache from scratch, which potentially means
+    # lengthy recomputations.
+    # Expected results have been generated with joblib 0.9.2
+    assert hash(to_hash) == expected
+
+
+@with_numpy
+def test_hashes_are_different_between_c_and_fortran_contiguous_arrays():
+    # We want to be sure that the c-contiguous and f-contiguous versions of the
+    # same array produce 2 different hashes.
+    rng = np.random.RandomState(0)
+    arr_c = rng.random_sample((10, 10))
+    arr_f = np.asfortranarray(arr_c)
+    assert hash(arr_c) != hash(arr_f)
+
+
+@with_numpy
+def test_0d_array():
+    hash(np.array(0))
+
+
+@with_numpy
+def test_0d_and_1d_array_hashing_is_different():
+    assert hash(np.array(0)) != hash(np.array([0]))
+
+
+@with_numpy
+def test_hashes_stay_the_same_with_numpy_objects():
+    # Note: joblib used to test numpy objects hashing by comparing the produced
+    # hash of an object with some hard-coded target value to guarantee that
+    # hashing remains the same across joblib versions. However, since numpy
+    # 1.20 and joblib 1.0, joblib relies on potentially unstable implementation
+    # details of numpy to hash np.dtype objects, which makes the stability of
+    # hash values across different environments hard to guarantee and to test.
+    # As a result, hashing stability across joblib versions becomes best-effort
+    # only, and we only test the consistency within a single environment by
+    # making sure:
+    # - the hash of two copies of the same objects is the same
+    # - hashing some object in two different python processes produces the same
+    #   value. This should be viewed as a proxy for testing hash consistency
+    #   through time between Python sessions (provided no change in the
+    #   environment was done between sessions).
+
+    def create_objects_to_hash():
+        rng = np.random.RandomState(42)
+        # Being explicit about dtypes in order to avoid
+        # architecture-related differences. Also using 'f4' rather than
+        # 'f8' for float arrays because 'f8' arrays generated by
+        # rng.random.randn don't seem to be bit-identical on 32bit and
+        # 64bit machines.
+        to_hash_list = [
+            rng.randint(-1000, high=1000, size=50).astype('<i8'),
+            tuple(rng.randn(3).astype('<f4') for _ in range(5)),
+            [rng.randn(3).astype('<f4') for _ in range(5)],
+            {
+                -3333: rng.randn(3, 5).astype('<f4'),
+                0: [
+                    rng.randint(10, size=20).astype('<i8'),
+                    rng.randn(10).astype('<f4')
+                ]
+            },
+            # Non regression cases for
+            # https://github.com/joblib/joblib/issues/308
+            np.arange(100, dtype='<i8').reshape((10, 10)),
+            # Fortran contiguous array
+            np.asfortranarray(np.arange(100, dtype='<i8').reshape((10, 10))),
+            # Non contiguous array
+            np.arange(100, dtype='<i8').reshape((10, 10))[:, :2],
+        ]
+        return to_hash_list
+
+    # Create two lists containing copies of the same objects.  joblib.hash
+    # should return the same hash for to_hash_list_one[i] and
+    # to_hash_list_two[i]
+    to_hash_list_one = create_objects_to_hash()
+    to_hash_list_two = create_objects_to_hash()
+
+    e1 = ProcessPoolExecutor(max_workers=1)
+    e2 = ProcessPoolExecutor(max_workers=1)
+
+    try:
+        for obj_1, obj_2 in zip(to_hash_list_one, to_hash_list_two):
+            # testing consistency of hashes across python processes
+            hash_1 = e1.submit(hash, obj_1).result()
+            hash_2 = e2.submit(hash, obj_1).result()
+            assert hash_1 == hash_2
+
+            # testing consistency when hashing two copies of the same objects.
+            hash_3 = e1.submit(hash, obj_2).result()
+            assert hash_1 == hash_3
+
+    finally:
+        e1.shutdown()
+        e2.shutdown()
+
+
+def test_hashing_pickling_error():
+    def non_picklable():
+        return 42
+
+    with raises(pickle.PicklingError) as excinfo:
+        hash(non_picklable)
+    excinfo.match('PicklingError while hashing')
+
+
+def test_wrong_hash_name():
+    msg = "Valid options for 'hash_name' are"
+    with raises(ValueError, match=msg):
+        data = {'foo': 'bar'}
+        hash(data, hash_name='invalid')
diff --git a/llm/Lib/site-packages/joblib/test/test_init.py b/llm/Lib/site-packages/joblib/test/test_init.py
new file mode 100644
index 0000000000000000000000000000000000000000..923a89b749862ef85b9420634e29e1f7c863113a
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_init.py
@@ -0,0 +1,14 @@
+# Basic test case to test functioning of module's top-level
+
+try:
+    from joblib import *  # noqa
+    _top_import_error = None
+except Exception as ex:  # pragma: no cover
+    _top_import_error = ex
+
+
+def test_import_joblib():
+    # Test either above import has failed for some reason
+    # "import *" only allowed at module level, hence we
+    # rely on setting up the variable above
+    assert _top_import_error is None
diff --git a/llm/Lib/site-packages/joblib/test/test_logger.py b/llm/Lib/site-packages/joblib/test/test_logger.py
new file mode 100644
index 0000000000000000000000000000000000000000..7cc59d4d1593bc5a4ab637328bf4e0dac068866f
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_logger.py
@@ -0,0 +1,31 @@
+"""
+Test the logger module.
+"""
+
+# Author: Gael Varoquaux <gael dot varoquaux at normalesup dot org>
+# Copyright (c) 2009 Gael Varoquaux
+# License: BSD Style, 3 clauses.
+import re
+
+from joblib.logger import PrintTime
+
+
+def test_print_time(tmpdir, capsys):
+    # A simple smoke test for PrintTime.
+    logfile = tmpdir.join('test.log').strpath
+    print_time = PrintTime(logfile=logfile)
+    print_time('Foo')
+    # Create a second time, to smoke test log rotation.
+    print_time = PrintTime(logfile=logfile)
+    print_time('Foo')
+    # And a third time
+    print_time = PrintTime(logfile=logfile)
+    print_time('Foo')
+
+    out_printed_text, err_printed_text = capsys.readouterr()
+    # Use regexps to be robust to time variations
+    match = r"Foo: 0\..s, 0\..min\nFoo: 0\..s, 0..min\nFoo: " + \
+            r".\..s, 0..min\n"
+    if not re.match(match, err_printed_text):
+        raise AssertionError('Excepted %s, got %s' %
+                             (match, err_printed_text))
diff --git a/llm/Lib/site-packages/joblib/test/test_memmapping.py b/llm/Lib/site-packages/joblib/test/test_memmapping.py
new file mode 100644
index 0000000000000000000000000000000000000000..42a297a9e445d38c0daa03bc7d78e4c4f1fd4571
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_memmapping.py
@@ -0,0 +1,1191 @@
+import os
+import mmap
+import sys
+import platform
+import gc
+import pickle
+import itertools
+from time import sleep
+import subprocess
+import threading
+import faulthandler
+
+import pytest
+
+from joblib.test.common import with_numpy, np
+from joblib.test.common import with_multiprocessing
+from joblib.test.common import with_dev_shm
+from joblib.testing import raises, parametrize, skipif
+from joblib.backports import make_memmap
+from joblib.parallel import Parallel, delayed
+
+from joblib.pool import MemmappingPool
+from joblib.executor import _TestingMemmappingExecutor as TestExecutor
+from joblib._memmapping_reducer import has_shareable_memory
+from joblib._memmapping_reducer import ArrayMemmapForwardReducer
+from joblib._memmapping_reducer import _strided_from_memmap
+from joblib._memmapping_reducer import _get_temp_dir
+from joblib._memmapping_reducer import _WeakArrayKeyMap
+from joblib._memmapping_reducer import _get_backing_memmap
+import joblib._memmapping_reducer as jmr
+
+
+def setup_module():
+    faulthandler.dump_traceback_later(timeout=300, exit=True)
+
+
+def teardown_module():
+    faulthandler.cancel_dump_traceback_later()
+
+
+def check_memmap_and_send_back(array):
+    assert _get_backing_memmap(array) is not None
+    return array
+
+
+def check_array(args):
+    """Dummy helper function to be executed in subprocesses
+
+    Check that the provided array has the expected values in the provided
+    range.
+
+    """
+    data, position, expected = args
+    np.testing.assert_array_equal(data[position], expected)
+
+
+def inplace_double(args):
+    """Dummy helper function to be executed in subprocesses
+
+
+    Check that the input array has the right values in the provided range
+    and perform an inplace modification to double the values in the range by
+    two.
+
+    """
+    data, position, expected = args
+    assert data[position] == expected
+    data[position] *= 2
+    np.testing.assert_array_equal(data[position], 2 * expected)
+
+
+@with_numpy
+@with_multiprocessing
+def test_memmap_based_array_reducing(tmpdir):
+    """Check that it is possible to reduce a memmap backed array"""
+    assert_array_equal = np.testing.assert_array_equal
+    filename = tmpdir.join('test.mmap').strpath
+
+    # Create a file larger than what will be used by a
+    buffer = np.memmap(filename, dtype=np.float64, shape=500, mode='w+')
+
+    # Fill the original buffer with negative markers to detect over of
+    # underflow in case of test failures
+    buffer[:] = - 1.0 * np.arange(buffer.shape[0], dtype=buffer.dtype)
+    buffer.flush()
+
+    # Memmap a 2D fortran array on a offsetted subsection of the previous
+    # buffer
+    a = np.memmap(filename, dtype=np.float64, shape=(3, 5, 4),
+                  mode='r+', order='F', offset=4)
+    a[:] = np.arange(60).reshape(a.shape)
+
+    # Build various views that share the buffer with the original memmap
+
+    # b is an memmap sliced view on an memmap instance
+    b = a[1:-1, 2:-1, 2:4]
+
+    # c and d are array views
+    c = np.asarray(b)
+    d = c.T
+
+    # Array reducer with auto dumping disabled
+    reducer = ArrayMemmapForwardReducer(None, tmpdir.strpath, 'c', True)
+
+    def reconstruct_array_or_memmap(x):
+        cons, args = reducer(x)
+        return cons(*args)
+
+    # Reconstruct original memmap
+    a_reconstructed = reconstruct_array_or_memmap(a)
+    assert has_shareable_memory(a_reconstructed)
+    assert isinstance(a_reconstructed, np.memmap)
+    assert_array_equal(a_reconstructed, a)
+
+    # Reconstruct strided memmap view
+    b_reconstructed = reconstruct_array_or_memmap(b)
+    assert has_shareable_memory(b_reconstructed)
+    assert_array_equal(b_reconstructed, b)
+
+    # Reconstruct arrays views on memmap base
+    c_reconstructed = reconstruct_array_or_memmap(c)
+    assert not isinstance(c_reconstructed, np.memmap)
+    assert has_shareable_memory(c_reconstructed)
+    assert_array_equal(c_reconstructed, c)
+
+    d_reconstructed = reconstruct_array_or_memmap(d)
+    assert not isinstance(d_reconstructed, np.memmap)
+    assert has_shareable_memory(d_reconstructed)
+    assert_array_equal(d_reconstructed, d)
+
+    # Test graceful degradation on fake memmap instances with in-memory
+    # buffers
+    a3 = a * 3
+    assert not has_shareable_memory(a3)
+    a3_reconstructed = reconstruct_array_or_memmap(a3)
+    assert not has_shareable_memory(a3_reconstructed)
+    assert not isinstance(a3_reconstructed, np.memmap)
+    assert_array_equal(a3_reconstructed, a * 3)
+
+    # Test graceful degradation on arrays derived from fake memmap instances
+    b3 = np.asarray(a3)
+    assert not has_shareable_memory(b3)
+
+    b3_reconstructed = reconstruct_array_or_memmap(b3)
+    assert isinstance(b3_reconstructed, np.ndarray)
+    assert not has_shareable_memory(b3_reconstructed)
+    assert_array_equal(b3_reconstructed, b3)
+
+
+@with_multiprocessing
+@skipif((sys.platform != "win32") or (),
+        reason="PermissionError only easily triggerable on Windows")
+def test_resource_tracker_retries_when_permissionerror(tmpdir):
+    # Test resource_tracker retry mechanism when unlinking memmaps.  See more
+    # thorough information in the ``unlink_file`` documentation of joblib.
+    filename = tmpdir.join('test.mmap').strpath
+    cmd = """if 1:
+    import os
+    import numpy as np
+    import time
+    from joblib.externals.loky.backend import resource_tracker
+    resource_tracker.VERBOSE = 1
+
+    # Start the resource tracker
+    resource_tracker.ensure_running()
+    time.sleep(1)
+
+    # Create a file containing numpy data
+    memmap = np.memmap(r"{filename}", dtype=np.float64, shape=10, mode='w+')
+    memmap[:] = np.arange(10).astype(np.int8).data
+    memmap.flush()
+    assert os.path.exists(r"{filename}")
+    del memmap
+
+    # Create a np.memmap backed by this file
+    memmap = np.memmap(r"{filename}", dtype=np.float64, shape=10, mode='w+')
+    resource_tracker.register(r"{filename}", "file")
+
+    # Ask the resource_tracker to delete the file backing the np.memmap , this
+    # should raise PermissionError that the resource_tracker will log.
+    resource_tracker.maybe_unlink(r"{filename}", "file")
+
+    # Wait for the resource_tracker to process the maybe_unlink before cleaning
+    # up the memmap
+    time.sleep(2)
+    """.format(filename=filename)
+    p = subprocess.Popen([sys.executable, '-c', cmd], stderr=subprocess.PIPE,
+                         stdout=subprocess.PIPE)
+    p.wait()
+    out, err = p.communicate()
+    assert p.returncode == 0
+    assert out == b''
+    msg = 'tried to unlink {}, got PermissionError'.format(filename)
+    assert msg in err.decode()
+
+
+@with_numpy
+@with_multiprocessing
+def test_high_dimension_memmap_array_reducing(tmpdir):
+    assert_array_equal = np.testing.assert_array_equal
+
+    filename = tmpdir.join('test.mmap').strpath
+
+    # Create a high dimensional memmap
+    a = np.memmap(filename, dtype=np.float64, shape=(100, 15, 15, 3),
+                  mode='w+')
+    a[:] = np.arange(100 * 15 * 15 * 3).reshape(a.shape)
+
+    # Create some slices/indices at various dimensions
+    b = a[0:10]
+    c = a[:, 5:10]
+    d = a[:, :, :, 0]
+    e = a[1:3:4]
+
+    # Array reducer with auto dumping disabled
+    reducer = ArrayMemmapForwardReducer(None, tmpdir.strpath, 'c', True)
+
+    def reconstruct_array_or_memmap(x):
+        cons, args = reducer(x)
+        return cons(*args)
+
+    a_reconstructed = reconstruct_array_or_memmap(a)
+    assert has_shareable_memory(a_reconstructed)
+    assert isinstance(a_reconstructed, np.memmap)
+    assert_array_equal(a_reconstructed, a)
+
+    b_reconstructed = reconstruct_array_or_memmap(b)
+    assert has_shareable_memory(b_reconstructed)
+    assert_array_equal(b_reconstructed, b)
+
+    c_reconstructed = reconstruct_array_or_memmap(c)
+    assert has_shareable_memory(c_reconstructed)
+    assert_array_equal(c_reconstructed, c)
+
+    d_reconstructed = reconstruct_array_or_memmap(d)
+    assert has_shareable_memory(d_reconstructed)
+    assert_array_equal(d_reconstructed, d)
+
+    e_reconstructed = reconstruct_array_or_memmap(e)
+    assert has_shareable_memory(e_reconstructed)
+    assert_array_equal(e_reconstructed, e)
+
+
+@with_numpy
+def test__strided_from_memmap(tmpdir):
+    fname = tmpdir.join('test.mmap').strpath
+    size = 5 * mmap.ALLOCATIONGRANULARITY
+    offset = mmap.ALLOCATIONGRANULARITY + 1
+    # This line creates the mmap file that is reused later
+    memmap_obj = np.memmap(fname, mode='w+', shape=size + offset)
+    # filename, dtype, mode, offset, order, shape, strides, total_buffer_len
+    memmap_obj = _strided_from_memmap(fname, dtype='uint8', mode='r',
+                                      offset=offset, order='C', shape=size,
+                                      strides=None, total_buffer_len=None,
+                                      unlink_on_gc_collect=False)
+    assert isinstance(memmap_obj, np.memmap)
+    assert memmap_obj.offset == offset
+    memmap_backed_obj = _strided_from_memmap(
+        fname, dtype='uint8', mode='r', offset=offset, order='C',
+        shape=(size // 2,), strides=(2,), total_buffer_len=size,
+        unlink_on_gc_collect=False
+    )
+    assert _get_backing_memmap(memmap_backed_obj).offset == offset
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize("factory", [MemmappingPool, TestExecutor.get_memmapping_executor],
+             ids=["multiprocessing", "loky"])
+def test_pool_with_memmap(factory, tmpdir):
+    """Check that subprocess can access and update shared memory memmap"""
+    assert_array_equal = np.testing.assert_array_equal
+
+    # Fork the subprocess before allocating the objects to be passed
+    pool_temp_folder = tmpdir.mkdir('pool').strpath
+    p = factory(10, max_nbytes=2, temp_folder=pool_temp_folder)
+    try:
+        filename = tmpdir.join('test.mmap').strpath
+        a = np.memmap(filename, dtype=np.float32, shape=(3, 5), mode='w+')
+        a.fill(1.0)
+
+        p.map(inplace_double, [(a, (i, j), 1.0)
+                               for i in range(a.shape[0])
+                               for j in range(a.shape[1])])
+
+        assert_array_equal(a, 2 * np.ones(a.shape))
+
+        # Open a copy-on-write view on the previous data
+        b = np.memmap(filename, dtype=np.float32, shape=(5, 3), mode='c')
+
+        p.map(inplace_double, [(b, (i, j), 2.0)
+                               for i in range(b.shape[0])
+                               for j in range(b.shape[1])])
+
+        # Passing memmap instances to the pool should not trigger the creation
+        # of new files on the FS
+        assert os.listdir(pool_temp_folder) == []
+
+        # the original data is untouched
+        assert_array_equal(a, 2 * np.ones(a.shape))
+        assert_array_equal(b, 2 * np.ones(b.shape))
+
+        # readonly maps can be read but not updated
+        c = np.memmap(filename, dtype=np.float32, shape=(10,), mode='r',
+                      offset=5 * 4)
+
+        with raises(AssertionError):
+            p.map(check_array, [(c, i, 3.0) for i in range(c.shape[0])])
+
+        # depending on the version of numpy one can either get a RuntimeError
+        # or a ValueError
+        with raises((RuntimeError, ValueError)):
+            p.map(inplace_double, [(c, i, 2.0) for i in range(c.shape[0])])
+    finally:
+        # Clean all filehandlers held by the pool
+        p.terminate()
+        del p
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize("factory", [MemmappingPool, TestExecutor.get_memmapping_executor],
+             ids=["multiprocessing", "loky"])
+def test_pool_with_memmap_array_view(factory, tmpdir):
+    """Check that subprocess can access and update shared memory array"""
+    assert_array_equal = np.testing.assert_array_equal
+
+    # Fork the subprocess before allocating the objects to be passed
+    pool_temp_folder = tmpdir.mkdir('pool').strpath
+    p = factory(10, max_nbytes=2, temp_folder=pool_temp_folder)
+    try:
+
+        filename = tmpdir.join('test.mmap').strpath
+        a = np.memmap(filename, dtype=np.float32, shape=(3, 5), mode='w+')
+        a.fill(1.0)
+
+        # Create an ndarray view on the memmap instance
+        a_view = np.asarray(a)
+        assert not isinstance(a_view, np.memmap)
+        assert has_shareable_memory(a_view)
+
+        p.map(inplace_double, [(a_view, (i, j), 1.0)
+                               for i in range(a.shape[0])
+                               for j in range(a.shape[1])])
+
+        # Both a and the a_view have been updated
+        assert_array_equal(a, 2 * np.ones(a.shape))
+        assert_array_equal(a_view, 2 * np.ones(a.shape))
+
+        # Passing memmap array view to the pool should not trigger the
+        # creation of new files on the FS
+        assert os.listdir(pool_temp_folder) == []
+
+    finally:
+        p.terminate()
+        del p
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize("backend", ["multiprocessing", "loky"])
+def test_permission_error_windows_reference_cycle(backend):
+    # Non regression test for:
+    # https://github.com/joblib/joblib/issues/806
+    #
+    # The issue happens when trying to delete a memory mapped file that has
+    # not yet been closed by one of the worker processes.
+    cmd = """if 1:
+        import numpy as np
+        from joblib import Parallel, delayed
+
+
+        data = np.random.rand(int(2e6)).reshape((int(1e6), 2))
+
+        # Build a complex cyclic reference that is likely to delay garbage
+        # collection of the memmapped array in the worker processes.
+        first_list = current_list = [data]
+        for i in range(10):
+            current_list = [current_list]
+        first_list.append(current_list)
+
+        if __name__ == "__main__":
+            results = Parallel(n_jobs=2, backend="{b}")(
+                delayed(len)(current_list) for i in range(10))
+            assert results == [1] * 10
+    """.format(b=backend)
+    p = subprocess.Popen([sys.executable, '-c', cmd], stderr=subprocess.PIPE,
+                         stdout=subprocess.PIPE)
+    p.wait()
+    out, err = p.communicate()
+    assert p.returncode == 0, out.decode() + "\n\n" + err.decode()
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize("backend", ["multiprocessing", "loky"])
+def test_permission_error_windows_memmap_sent_to_parent(backend):
+    # Second non-regression test for:
+    # https://github.com/joblib/joblib/issues/806
+    # previously, child process would not convert temporary memmaps to numpy
+    # arrays when sending the data back to the parent process. This would lead
+    # to permission errors on windows when deleting joblib's temporary folder,
+    # as the memmaped files handles would still opened in the parent process.
+    cmd = '''if 1:
+        import os
+        import time
+
+        import numpy as np
+
+        from joblib import Parallel, delayed
+        from testutils import return_slice_of_data
+
+        data = np.ones(int(2e6))
+
+        if __name__ == '__main__':
+            # warm-up call to launch the workers and start the resource_tracker
+            _ = Parallel(n_jobs=2, verbose=5, backend='{b}')(
+                delayed(id)(i) for i in range(20))
+
+            time.sleep(0.5)
+
+            slice_of_data = Parallel(n_jobs=2, verbose=5, backend='{b}')(
+                delayed(return_slice_of_data)(data, 0, 20) for _ in range(10))
+    '''.format(b=backend)
+
+    for _ in range(3):
+        env = os.environ.copy()
+        env['PYTHONPATH'] = os.path.dirname(__file__)
+        p = subprocess.Popen([sys.executable, '-c', cmd],
+                             stderr=subprocess.PIPE,
+                             stdout=subprocess.PIPE, env=env)
+        p.wait()
+        out, err = p.communicate()
+        assert p.returncode == 0, err
+        assert out == b''
+        if sys.version_info[:3] not in [(3, 8, 0), (3, 8, 1)]:
+            # In early versions of Python 3.8, a reference leak
+            # https://github.com/cloudpipe/cloudpickle/issues/327, holds
+            # references to pickled objects, generating race condition during
+            # cleanup finalizers of joblib and noisy resource_tracker outputs.
+            assert b'resource_tracker' not in err
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize("backend", ["multiprocessing", "loky"])
+def test_parallel_isolated_temp_folders(backend):
+    # Test that consecutive Parallel call use isolated subfolders, even
+    # for the loky backend that reuses its executor instance across calls.
+    array = np.arange(int(1e2))
+    [filename_1] = Parallel(n_jobs=2, backend=backend, max_nbytes=10)(
+        delayed(getattr)(array, 'filename') for _ in range(1)
+    )
+    [filename_2] = Parallel(n_jobs=2, backend=backend, max_nbytes=10)(
+        delayed(getattr)(array, 'filename') for _ in range(1)
+    )
+    assert os.path.dirname(filename_2) != os.path.dirname(filename_1)
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize("backend", ["multiprocessing", "loky"])
+def test_managed_backend_reuse_temp_folder(backend):
+    # Test that calls to a managed parallel object reuse the same memmaps.
+    array = np.arange(int(1e2))
+    with Parallel(n_jobs=2, backend=backend, max_nbytes=10) as p:
+        [filename_1] = p(
+            delayed(getattr)(array, 'filename') for _ in range(1)
+        )
+        [filename_2] = p(
+            delayed(getattr)(array, 'filename') for _ in range(1)
+        )
+    assert os.path.dirname(filename_2) == os.path.dirname(filename_1)
+
+
+@with_numpy
+@with_multiprocessing
+def test_memmapping_temp_folder_thread_safety():
+    # Concurrent calls to Parallel with the loky backend will use the same
+    # executor, and thus the same reducers. Make sure that those reducers use
+    # different temporary folders depending on which Parallel objects called
+    # them, which is necessary to limit potential race conditions during the
+    # garbage collection of temporary memmaps.
+    array = np.arange(int(1e2))
+
+    temp_dirs_thread_1 = set()
+    temp_dirs_thread_2 = set()
+
+    def concurrent_get_filename(array, temp_dirs):
+        with Parallel(backend='loky', n_jobs=2, max_nbytes=10) as p:
+            for i in range(10):
+                [filename] = p(
+                    delayed(getattr)(array, 'filename') for _ in range(1)
+                )
+                temp_dirs.add(os.path.dirname(filename))
+
+    t1 = threading.Thread(
+        target=concurrent_get_filename, args=(array, temp_dirs_thread_1)
+    )
+    t2 = threading.Thread(
+        target=concurrent_get_filename, args=(array, temp_dirs_thread_2)
+    )
+
+    t1.start()
+    t2.start()
+
+    t1.join()
+    t2.join()
+
+    assert len(temp_dirs_thread_1) == 1
+    assert len(temp_dirs_thread_2) == 1
+
+    assert temp_dirs_thread_1 != temp_dirs_thread_2
+
+
+@with_numpy
+@with_multiprocessing
+def test_multithreaded_parallel_termination_resource_tracker_silent():
+    # test that concurrent termination attempts of a same executor does not
+    # emit any spurious error from the resource_tracker. We test various
+    # situations making 0, 1 or both parallel call sending a task that will
+    # make the worker (and thus the whole Parallel call) error out.
+    cmd = '''if 1:
+        import os
+        import numpy as np
+        from joblib import Parallel, delayed
+        from joblib.externals.loky.backend import resource_tracker
+        from concurrent.futures import ThreadPoolExecutor, wait
+
+        resource_tracker.VERBOSE = 0
+
+        array = np.arange(int(1e2))
+
+        temp_dirs_thread_1 = set()
+        temp_dirs_thread_2 = set()
+
+
+        def raise_error(array):
+            raise ValueError
+
+
+        def parallel_get_filename(array, temp_dirs):
+            with Parallel(backend="loky", n_jobs=2, max_nbytes=10) as p:
+                for i in range(10):
+                    [filename] = p(
+                        delayed(getattr)(array, "filename") for _ in range(1)
+                    )
+                    temp_dirs.add(os.path.dirname(filename))
+
+
+        def parallel_raise(array, temp_dirs):
+            with Parallel(backend="loky", n_jobs=2, max_nbytes=10) as p:
+                for i in range(10):
+                    [filename] = p(
+                        delayed(raise_error)(array) for _ in range(1)
+                    )
+                    temp_dirs.add(os.path.dirname(filename))
+
+
+        executor = ThreadPoolExecutor(max_workers=2)
+
+        # both function calls will use the same loky executor, but with a
+        # different Parallel object.
+        future_1 = executor.submit({f1}, array, temp_dirs_thread_1)
+        future_2 = executor.submit({f2}, array, temp_dirs_thread_2)
+
+        # Wait for both threads to terminate their backend
+        wait([future_1, future_2])
+
+        future_1.result()
+        future_2.result()
+    '''
+    functions_and_returncodes = [
+        ("parallel_get_filename", "parallel_get_filename", 0),
+        ("parallel_get_filename", "parallel_raise", 1),
+        ("parallel_raise", "parallel_raise", 1)
+    ]
+
+    for f1, f2, returncode in functions_and_returncodes:
+        p = subprocess.Popen([sys.executable, '-c', cmd.format(f1=f1, f2=f2)],
+                             stderr=subprocess.PIPE, stdout=subprocess.PIPE)
+        p.wait()
+        out, err = p.communicate()
+        assert p.returncode == returncode, out.decode()
+        assert b"resource_tracker" not in err, err.decode()
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize("backend", ["multiprocessing", "loky"])
+def test_many_parallel_calls_on_same_object(backend):
+    # After #966 got merged, consecutive Parallel objects were sharing temp
+    # folder, which would lead to race conditions happening during the
+    # temporary resources management with the resource_tracker. This is a
+    # non-regression test that makes sure that consecutive Parallel operations
+    # on the same object do not error out.
+    cmd = '''if 1:
+        import os
+        import time
+
+        import numpy as np
+
+        from joblib import Parallel, delayed
+        from testutils import return_slice_of_data
+
+        data = np.ones(100)
+
+        if __name__ == '__main__':
+            for i in range(5):
+                slice_of_data = Parallel(
+                    n_jobs=2, max_nbytes=1, backend='{b}')(
+                        delayed(return_slice_of_data)(data, 0, 20)
+                        for _ in range(10)
+                    )
+    '''.format(b=backend)
+    env = os.environ.copy()
+    env['PYTHONPATH'] = os.path.dirname(__file__)
+    p = subprocess.Popen(
+        [sys.executable, '-c', cmd],
+        stderr=subprocess.PIPE,
+        stdout=subprocess.PIPE,
+        env=env,
+    )
+    p.wait()
+    out, err = p.communicate()
+    assert p.returncode == 0, err
+    assert out == b''
+    if sys.version_info[:3] not in [(3, 8, 0), (3, 8, 1)]:
+        # In early versions of Python 3.8, a reference leak
+        # https://github.com/cloudpipe/cloudpickle/issues/327, holds
+        # references to pickled objects, generating race condition during
+        # cleanup finalizers of joblib and noisy resource_tracker outputs.
+        assert b'resource_tracker' not in err
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize("backend", ["multiprocessing", "loky"])
+def test_memmap_returned_as_regular_array(backend):
+    data = np.ones(int(1e3))
+    # Check that child processes send temporary memmaps back as numpy arrays.
+    [result] = Parallel(n_jobs=2, backend=backend, max_nbytes=100)(
+        delayed(check_memmap_and_send_back)(data) for _ in range(1))
+    assert _get_backing_memmap(result) is None
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize("backend", ["multiprocessing", "loky"])
+def test_resource_tracker_silent_when_reference_cycles(backend):
+    # There is a variety of reasons that can make joblib with loky backend
+    # output noisy warnings when a reference cycle is preventing a memmap from
+    # being garbage collected. Especially, joblib's main process finalizer
+    # deletes the temporary folder if it was not done before, which can
+    # interact badly with the resource_tracker. We don't risk leaking any
+    # resources, but this will likely make joblib output a lot of low-level
+    # confusing messages.
+    #
+    # This test makes sure that the resource_tracker is silent when a reference
+    # has been collected concurrently on non-Windows platforms.
+    #
+    # Note that the script in ``cmd`` is the exact same script as in
+    # test_permission_error_windows_reference_cycle.
+    if backend == "loky" and sys.platform.startswith('win'):
+        # XXX: on Windows, reference cycles can delay timely garbage collection
+        # and make it impossible to properly delete the temporary folder in the
+        # main process because of permission errors.
+        pytest.xfail(
+            "The temporary folder cannot be deleted on Windows in the "
+            "presence of a reference cycle"
+        )
+
+    cmd = """if 1:
+        import numpy as np
+        from joblib import Parallel, delayed
+
+
+        data = np.random.rand(int(2e6)).reshape((int(1e6), 2))
+
+        # Build a complex cyclic reference that is likely to delay garbage
+        # collection of the memmapped array in the worker processes.
+        first_list = current_list = [data]
+        for i in range(10):
+            current_list = [current_list]
+        first_list.append(current_list)
+
+        if __name__ == "__main__":
+            results = Parallel(n_jobs=2, backend="{b}")(
+                delayed(len)(current_list) for i in range(10))
+            assert results == [1] * 10
+    """.format(b=backend)
+    p = subprocess.Popen([sys.executable, '-c', cmd], stderr=subprocess.PIPE,
+                         stdout=subprocess.PIPE)
+    p.wait()
+    out, err = p.communicate()
+    out = out.decode()
+    err = err.decode()
+    assert p.returncode == 0, out + "\n\n" + err
+    assert "resource_tracker" not in err, err
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize("factory", [MemmappingPool, TestExecutor.get_memmapping_executor],
+             ids=["multiprocessing", "loky"])
+def test_memmapping_pool_for_large_arrays(factory, tmpdir):
+    """Check that large arrays are not copied in memory"""
+
+    # Check that the tempfolder is empty
+    assert os.listdir(tmpdir.strpath) == []
+
+    # Build an array reducers that automatically dump large array content
+    # to filesystem backed memmap instances to avoid memory explosion
+    p = factory(3, max_nbytes=40, temp_folder=tmpdir.strpath, verbose=2)
+    try:
+        # The temporary folder for the pool is not provisioned in advance
+        assert os.listdir(tmpdir.strpath) == []
+        assert not os.path.exists(p._temp_folder)
+
+        small = np.ones(5, dtype=np.float32)
+        assert small.nbytes == 20
+        p.map(check_array, [(small, i, 1.0) for i in range(small.shape[0])])
+
+        # Memory has been copied, the pool filesystem folder is unused
+        assert os.listdir(tmpdir.strpath) == []
+
+        # Try with a file larger than the memmap threshold of 40 bytes
+        large = np.ones(100, dtype=np.float64)
+        assert large.nbytes == 800
+        p.map(check_array, [(large, i, 1.0) for i in range(large.shape[0])])
+
+        # The data has been dumped in a temp folder for subprocess to share it
+        # without per-child memory copies
+        assert os.path.isdir(p._temp_folder)
+        dumped_filenames = os.listdir(p._temp_folder)
+        assert len(dumped_filenames) == 1
+
+        # Check that memory mapping is not triggered for arrays with
+        # dtype='object'
+        objects = np.array(['abc'] * 100, dtype='object')
+        results = p.map(has_shareable_memory, [objects])
+        assert not results[0]
+
+    finally:
+        # check FS garbage upon pool termination
+        p.terminate()
+        for i in range(10):
+            sleep(.1)
+            if not os.path.exists(p._temp_folder):
+                break
+        else:  # pragma: no cover
+            raise AssertionError(
+                'temporary folder {} was not deleted'.format(p._temp_folder)
+            )
+        del p
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize(
+    "backend",
+    [
+        pytest.param(
+            "multiprocessing",
+            marks=pytest.mark.xfail(
+                reason='https://github.com/joblib/joblib/issues/1086'
+            ),
+        ),
+        "loky",
+    ]
+)
+def test_child_raises_parent_exits_cleanly(backend):
+    # When a task executed by a child process raises an error, the parent
+    # process's backend is notified, and calls abort_everything.
+    # In loky, abort_everything itself calls shutdown(kill_workers=True) which
+    # sends SIGKILL to the worker, preventing it from running the finalizers
+    # supposed to signal the resource_tracker when the worker is done using
+    # objects relying on a shared resource (e.g np.memmaps). Because this
+    # behavior is prone to :
+    # - cause a resource leak
+    # - make the resource tracker emit noisy resource warnings
+    # we explicitly test that, when the said situation occurs:
+    # - no resources are actually leaked
+    # - the temporary resources are deleted as soon as possible (typically, at
+    #   the end of the failing Parallel call)
+    # - the resource_tracker does not emit any warnings.
+    cmd = """if 1:
+        import os
+        from pathlib import Path
+        from time import sleep
+
+        import numpy as np
+        from joblib import Parallel, delayed
+        from testutils import print_filename_and_raise
+
+        data = np.random.rand(1000)
+
+        def get_temp_folder(parallel_obj, backend):
+            if "{b}" == "loky":
+                return Path(parallel_obj._backend._workers._temp_folder)
+            else:
+                return Path(parallel_obj._backend._pool._temp_folder)
+
+
+        if __name__ == "__main__":
+            try:
+                with Parallel(n_jobs=2, backend="{b}", max_nbytes=100) as p:
+                    temp_folder = get_temp_folder(p, "{b}")
+                    p(delayed(print_filename_and_raise)(data)
+                              for i in range(1))
+            except ValueError as e:
+                # the temporary folder should be deleted by the end of this
+                # call but apparently on some file systems, this takes
+                # some time to be visible.
+                #
+                # We attempt to write into the temporary folder to test for
+                # its existence and we wait for a maximum of 10 seconds.
+                for i in range(100):
+                    try:
+                        with open(temp_folder / "some_file.txt", "w") as f:
+                            f.write("some content")
+                    except FileNotFoundError:
+                        # temp_folder has been deleted, all is fine
+                        break
+
+                    # ... else, wait a bit and try again
+                    sleep(.1)
+                else:
+                    raise AssertionError(
+                        str(temp_folder) + " was not deleted"
+                    ) from e
+    """.format(b=backend)
+    env = os.environ.copy()
+    env['PYTHONPATH'] = os.path.dirname(__file__)
+    p = subprocess.Popen([sys.executable, '-c', cmd], stderr=subprocess.PIPE,
+                         stdout=subprocess.PIPE, env=env)
+    p.wait()
+    out, err = p.communicate()
+    out, err = out.decode(), err.decode()
+    filename = out.split('\n')[0]
+    assert p.returncode == 0, err or out
+    assert err == ''  # no resource_tracker warnings.
+    assert not os.path.exists(filename)
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize("factory", [MemmappingPool, TestExecutor.get_memmapping_executor],
+             ids=["multiprocessing", "loky"])
+def test_memmapping_pool_for_large_arrays_disabled(factory, tmpdir):
+    """Check that large arrays memmapping can be disabled"""
+    # Set max_nbytes to None to disable the auto memmapping feature
+    p = factory(3, max_nbytes=None, temp_folder=tmpdir.strpath)
+    try:
+
+        # Check that the tempfolder is empty
+        assert os.listdir(tmpdir.strpath) == []
+
+        # Try with a file largish than the memmap threshold of 40 bytes
+        large = np.ones(100, dtype=np.float64)
+        assert large.nbytes == 800
+        p.map(check_array, [(large, i, 1.0) for i in range(large.shape[0])])
+
+        # Check that the tempfolder is still empty
+        assert os.listdir(tmpdir.strpath) == []
+
+    finally:
+        # Cleanup open file descriptors
+        p.terminate()
+        del p
+
+
+@with_numpy
+@with_multiprocessing
+@with_dev_shm
+@parametrize("factory", [MemmappingPool, TestExecutor.get_memmapping_executor],
+             ids=["multiprocessing", "loky"])
+def test_memmapping_on_large_enough_dev_shm(factory):
+    """Check that memmapping uses /dev/shm when possible"""
+    orig_size = jmr.SYSTEM_SHARED_MEM_FS_MIN_SIZE
+    try:
+        # Make joblib believe that it can use /dev/shm even when running on a
+        # CI container where the size of the /dev/shm is not very large (that
+        # is at least 32 MB instead of 2 GB by default).
+        jmr.SYSTEM_SHARED_MEM_FS_MIN_SIZE = int(32e6)
+        p = factory(3, max_nbytes=10)
+        try:
+            # Check that the pool has correctly detected the presence of the
+            # shared memory filesystem.
+            pool_temp_folder = p._temp_folder
+            folder_prefix = '/dev/shm/joblib_memmapping_folder_'
+            assert pool_temp_folder.startswith(folder_prefix)
+            assert os.path.exists(pool_temp_folder)
+
+            # Try with a file larger than the memmap threshold of 10 bytes
+            a = np.ones(100, dtype=np.float64)
+            assert a.nbytes == 800
+            p.map(id, [a] * 10)
+            # a should have been memmapped to the pool temp folder: the joblib
+            # pickling procedure generate one .pkl file:
+            assert len(os.listdir(pool_temp_folder)) == 1
+
+            # create a new array with content that is different from 'a' so
+            # that it is mapped to a different file in the temporary folder of
+            # the pool.
+            b = np.ones(100, dtype=np.float64) * 2
+            assert b.nbytes == 800
+            p.map(id, [b] * 10)
+            # A copy of both a and b are now stored in the shared memory folder
+            assert len(os.listdir(pool_temp_folder)) == 2
+        finally:
+            # Cleanup open file descriptors
+            p.terminate()
+            del p
+
+        for i in range(100):
+            # The temp folder is cleaned up upon pool termination
+            if not os.path.exists(pool_temp_folder):
+                break
+            sleep(.1)
+        else:  # pragma: no cover
+            raise AssertionError('temporary folder of pool was not deleted')
+    finally:
+        jmr.SYSTEM_SHARED_MEM_FS_MIN_SIZE = orig_size
+
+
+@with_numpy
+@with_multiprocessing
+@with_dev_shm
+@parametrize("factory", [MemmappingPool, TestExecutor.get_memmapping_executor],
+             ids=["multiprocessing", "loky"])
+def test_memmapping_on_too_small_dev_shm(factory):
+    orig_size = jmr.SYSTEM_SHARED_MEM_FS_MIN_SIZE
+    try:
+        # Make joblib believe that it cannot use /dev/shm unless there is
+        # 42 exabytes of available shared memory in /dev/shm
+        jmr.SYSTEM_SHARED_MEM_FS_MIN_SIZE = int(42e18)
+
+        p = factory(3, max_nbytes=10)
+        try:
+            # Check that the pool has correctly detected the presence of the
+            # shared memory filesystem.
+            pool_temp_folder = p._temp_folder
+            assert not pool_temp_folder.startswith('/dev/shm')
+        finally:
+            # Cleanup open file descriptors
+            p.terminate()
+            del p
+
+        # The temp folder is cleaned up upon pool termination
+        assert not os.path.exists(pool_temp_folder)
+    finally:
+        jmr.SYSTEM_SHARED_MEM_FS_MIN_SIZE = orig_size
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize("factory", [MemmappingPool, TestExecutor.get_memmapping_executor],
+             ids=["multiprocessing", "loky"])
+def test_memmapping_pool_for_large_arrays_in_return(factory, tmpdir):
+    """Check that large arrays are not copied in memory in return"""
+    assert_array_equal = np.testing.assert_array_equal
+
+    # Build an array reducers that automatically dump large array content
+    # but check that the returned datastructure are regular arrays to avoid
+    # passing a memmap array pointing to a pool controlled temp folder that
+    # might be confusing to the user
+
+    # The MemmappingPool user can always return numpy.memmap object explicitly
+    # to avoid memory copy
+    p = factory(3, max_nbytes=10, temp_folder=tmpdir.strpath)
+    try:
+        res = p.apply_async(np.ones, args=(1000,))
+        large = res.get()
+        assert not has_shareable_memory(large)
+        assert_array_equal(large, np.ones(1000))
+    finally:
+        p.terminate()
+        del p
+
+
+def _worker_multiply(a, n_times):
+    """Multiplication function to be executed by subprocess"""
+    assert has_shareable_memory(a)
+    return a * n_times
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize("factory", [MemmappingPool, TestExecutor.get_memmapping_executor],
+             ids=["multiprocessing", "loky"])
+def test_workaround_against_bad_memmap_with_copied_buffers(factory, tmpdir):
+    """Check that memmaps with a bad buffer are returned as regular arrays
+
+    Unary operations and ufuncs on memmap instances return a new memmap
+    instance with an in-memory buffer (probably a numpy bug).
+    """
+    assert_array_equal = np.testing.assert_array_equal
+
+    p = factory(3, max_nbytes=10, temp_folder=tmpdir.strpath)
+    try:
+        # Send a complex, large-ish view on a array that will be converted to
+        # a memmap in the worker process
+        a = np.asarray(np.arange(6000).reshape((1000, 2, 3)),
+                       order='F')[:, :1, :]
+
+        # Call a non-inplace multiply operation on the worker and memmap and
+        # send it back to the parent.
+        b = p.apply_async(_worker_multiply, args=(a, 3)).get()
+        assert not has_shareable_memory(b)
+        assert_array_equal(b, 3 * a)
+    finally:
+        p.terminate()
+        del p
+
+
+def identity(arg):
+    return arg
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize(
+    "factory,retry_no",
+    list(itertools.product(
+        [MemmappingPool, TestExecutor.get_memmapping_executor], range(3))),
+    ids=['{}, {}'.format(x, y) for x, y in itertools.product(
+        ["multiprocessing", "loky"], map(str, range(3)))])
+def test_pool_memmap_with_big_offset(factory, retry_no, tmpdir):
+    # Test that numpy memmap offset is set correctly if greater than
+    # mmap.ALLOCATIONGRANULARITY, see
+    # https://github.com/joblib/joblib/issues/451 and
+    # https://github.com/numpy/numpy/pull/8443 for more details.
+    fname = tmpdir.join('test.mmap').strpath
+    size = 5 * mmap.ALLOCATIONGRANULARITY
+    offset = mmap.ALLOCATIONGRANULARITY + 1
+    obj = make_memmap(fname, mode='w+', shape=size, dtype='uint8',
+                      offset=offset)
+
+    p = factory(2, temp_folder=tmpdir.strpath)
+    result = p.apply_async(identity, args=(obj,)).get()
+    assert isinstance(result, np.memmap)
+    assert result.offset == offset
+    np.testing.assert_array_equal(obj, result)
+    p.terminate()
+
+
+def test_pool_get_temp_dir(tmpdir):
+    pool_folder_name = 'test.tmpdir'
+    pool_folder, shared_mem = _get_temp_dir(pool_folder_name, tmpdir.strpath)
+    assert shared_mem is False
+    assert pool_folder == tmpdir.join('test.tmpdir').strpath
+
+    pool_folder, shared_mem = _get_temp_dir(pool_folder_name, temp_folder=None)
+    if sys.platform.startswith('win'):
+        assert shared_mem is False
+    assert pool_folder.endswith(pool_folder_name)
+
+
+def test_pool_get_temp_dir_no_statvfs(tmpdir, monkeypatch):
+    """Check that _get_temp_dir works when os.statvfs is not defined
+
+    Regression test for #902
+    """
+    pool_folder_name = 'test.tmpdir'
+    import joblib._memmapping_reducer
+    if hasattr(joblib._memmapping_reducer.os, 'statvfs'):
+        # We are on Unix, since Windows doesn't have this function
+        monkeypatch.delattr(joblib._memmapping_reducer.os, 'statvfs')
+
+    pool_folder, shared_mem = _get_temp_dir(pool_folder_name, temp_folder=None)
+    if sys.platform.startswith('win'):
+        assert shared_mem is False
+    assert pool_folder.endswith(pool_folder_name)
+
+
+@with_numpy
+@skipif(sys.platform == 'win32', reason='This test fails with a '
+        'PermissionError on Windows')
+@parametrize("mmap_mode", ["r+", "w+"])
+def test_numpy_arrays_use_different_memory(mmap_mode):
+    def func(arr, value):
+        arr[:] = value
+        return arr
+
+    arrays = [np.zeros((10, 10), dtype='float64') for i in range(10)]
+
+    results = Parallel(mmap_mode=mmap_mode, max_nbytes=0, n_jobs=2)(
+        delayed(func)(arr, i) for i, arr in enumerate(arrays))
+
+    for i, arr in enumerate(results):
+        np.testing.assert_array_equal(arr, i)
+
+
+@with_numpy
+def test_weak_array_key_map():
+
+    def assert_empty_after_gc_collect(container, retries=100):
+        for i in range(retries):
+            if len(container) == 0:
+                return
+            gc.collect()
+            sleep(.1)
+        assert len(container) == 0
+
+    a = np.ones(42)
+    m = _WeakArrayKeyMap()
+    m.set(a, 'a')
+    assert m.get(a) == 'a'
+
+    b = a
+    assert m.get(b) == 'a'
+    m.set(b, 'b')
+    assert m.get(a) == 'b'
+
+    del a
+    gc.collect()
+    assert len(m._data) == 1
+    assert m.get(b) == 'b'
+
+    del b
+    assert_empty_after_gc_collect(m._data)
+
+    c = np.ones(42)
+    m.set(c, 'c')
+    assert len(m._data) == 1
+    assert m.get(c) == 'c'
+
+    with raises(KeyError):
+        m.get(np.ones(42))
+
+    del c
+    assert_empty_after_gc_collect(m._data)
+
+    # Check that creating and dropping numpy arrays with potentially the same
+    # object id will not cause the map to get confused.
+    def get_set_get_collect(m, i):
+        a = np.ones(42)
+        with raises(KeyError):
+            m.get(a)
+        m.set(a, i)
+        assert m.get(a) == i
+        return id(a)
+
+    unique_ids = set([get_set_get_collect(m, i) for i in range(1000)])
+    if platform.python_implementation() == 'CPython':
+        # On CPython (at least) the same id is often reused many times for the
+        # temporary arrays created under the local scope of the
+        # get_set_get_collect function without causing any spurious lookups /
+        # insertions in the map. Apparently on Python nogil, the id is not
+        # reused as often.
+        max_len_unique_ids = 400 if getattr(sys.flags, 'nogil', False) else 100
+        assert len(unique_ids) < max_len_unique_ids
+
+
+def test_weak_array_key_map_no_pickling():
+    m = _WeakArrayKeyMap()
+    with raises(pickle.PicklingError):
+        pickle.dumps(m)
+
+
+@with_numpy
+@with_multiprocessing
+def test_direct_mmap(tmpdir):
+    testfile = str(tmpdir.join('arr.dat'))
+    a = np.arange(10, dtype='uint8')
+    a.tofile(testfile)
+
+    def _read_array():
+        with open(testfile) as fd:
+            mm = mmap.mmap(fd.fileno(), 0, access=mmap.ACCESS_READ, offset=0)
+        return np.ndarray((10,), dtype=np.uint8, buffer=mm, offset=0)
+
+    def func(x):
+        return x**2
+
+    arr = _read_array()
+
+    # this is expected to work and gives the reference
+    ref = Parallel(n_jobs=2)(delayed(func)(x) for x in [a])
+
+    # now test that it work with the mmap array
+    results = Parallel(n_jobs=2)(delayed(func)(x) for x in [arr])
+    np.testing.assert_array_equal(results, ref)
+
+    # also test with a mmap array read in the subprocess
+    def worker():
+        return _read_array()
+
+    results = Parallel(n_jobs=2)(delayed(worker)() for _ in range(1))
+    np.testing.assert_array_equal(results[0], arr)
diff --git a/llm/Lib/site-packages/joblib/test/test_memory.py b/llm/Lib/site-packages/joblib/test/test_memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..120987b666bb84268457bdd4b843a7bae070832f
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_memory.py
@@ -0,0 +1,1493 @@
+"""
+Test the memory module.
+"""
+
+# Author: Gael Varoquaux <gael dot varoquaux at normalesup dot org>
+# Copyright (c) 2009 Gael Varoquaux
+# License: BSD Style, 3 clauses.
+
+import functools
+import gc
+import logging
+import shutil
+import os
+import os.path
+import pathlib
+import pickle
+import sys
+import time
+import datetime
+import textwrap
+
+import pytest
+
+from joblib.memory import Memory
+from joblib.memory import expires_after
+from joblib.memory import MemorizedFunc, NotMemorizedFunc
+from joblib.memory import MemorizedResult, NotMemorizedResult
+from joblib.memory import _FUNCTION_HASHES
+from joblib.memory import register_store_backend, _STORE_BACKENDS
+from joblib.memory import _build_func_identifier, _store_backend_factory
+from joblib.memory import JobLibCollisionWarning
+from joblib.parallel import Parallel, delayed
+from joblib._store_backends import StoreBackendBase, FileSystemStoreBackend
+from joblib.test.common import with_numpy, np
+from joblib.test.common import with_multiprocessing
+from joblib.testing import parametrize, raises, warns
+from joblib.hashing import hash
+
+
+###############################################################################
+# Module-level variables for the tests
+def f(x, y=1):
+    """ A module-level function for testing purposes.
+    """
+    return x ** 2 + y
+
+
+###############################################################################
+# Helper function for the tests
+def check_identity_lazy(func, accumulator, location):
+    """ Given a function and an accumulator (a list that grows every
+        time the function is called), check that the function can be
+        decorated by memory to be a lazy identity.
+    """
+    # Call each function with several arguments, and check that it is
+    # evaluated only once per argument.
+    memory = Memory(location=location, verbose=0)
+    func = memory.cache(func)
+    for i in range(3):
+        for _ in range(2):
+            assert func(i) == i
+            assert len(accumulator) == i + 1
+
+
+def corrupt_single_cache_item(memory):
+    single_cache_item, = memory.store_backend.get_items()
+    output_filename = os.path.join(single_cache_item.path, 'output.pkl')
+    with open(output_filename, 'w') as f:
+        f.write('garbage')
+
+
+def monkeypatch_cached_func_warn(func, monkeypatch_fixture):
+    # Need monkeypatch because pytest does not
+    # capture stdlib logging output (see
+    # https://github.com/pytest-dev/pytest/issues/2079)
+
+    recorded = []
+
+    def append_to_record(item):
+        recorded.append(item)
+    monkeypatch_fixture.setattr(func, 'warn', append_to_record)
+    return recorded
+
+
+###############################################################################
+# Tests
+def test_memory_integration(tmpdir):
+    """ Simple test of memory lazy evaluation.
+    """
+    accumulator = list()
+
+    # Rmk: this function has the same name than a module-level function,
+    # thus it serves as a test to see that both are identified
+    # as different.
+    def f(arg):
+        accumulator.append(1)
+        return arg
+
+    check_identity_lazy(f, accumulator, tmpdir.strpath)
+
+    # Now test clearing
+    for compress in (False, True):
+        for mmap_mode in ('r', None):
+            memory = Memory(location=tmpdir.strpath, verbose=10,
+                            mmap_mode=mmap_mode, compress=compress)
+            # First clear the cache directory, to check that our code can
+            # handle that
+            # NOTE: this line would raise an exception, as the database file is
+            # still open; we ignore the error since we want to test what
+            # happens if the directory disappears
+            shutil.rmtree(tmpdir.strpath, ignore_errors=True)
+            g = memory.cache(f)
+            g(1)
+            g.clear(warn=False)
+            current_accumulator = len(accumulator)
+            out = g(1)
+
+        assert len(accumulator) == current_accumulator + 1
+        # Also, check that Memory.eval works similarly
+        assert memory.eval(f, 1) == out
+        assert len(accumulator) == current_accumulator + 1
+
+    # Now do a smoke test with a function defined in __main__, as the name
+    # mangling rules are more complex
+    f.__module__ = '__main__'
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    memory.cache(f)(1)
+
+
+@parametrize("call_before_reducing", [True, False])
+def test_parallel_call_cached_function_defined_in_jupyter(
+    tmpdir, call_before_reducing
+):
+    # Calling an interactively defined memory.cache()'d function inside a
+    # Parallel call used to clear the existing cache related to the said
+    # function (https://github.com/joblib/joblib/issues/1035)
+
+    # This tests checks that this is no longer the case.
+
+    # TODO: test that the cache related to the function cache persists across
+    # ipython sessions (provided that no code change were made to the
+    # function's source)?
+
+    # The first part of the test makes the necessary low-level calls to emulate
+    # the definition of a function in an jupyter notebook cell. Joblib has
+    # some custom code to treat functions defined specifically in jupyter
+    # notebooks/ipython session -- we want to test this code, which requires
+    # the emulation to be rigorous.
+    for session_no in [0, 1]:
+        ipython_cell_source = '''
+        def f(x):
+            return x
+        '''
+
+        ipython_cell_id = '<ipython-input-{}-000000000000>'.format(session_no)
+
+        exec(
+            compile(
+                textwrap.dedent(ipython_cell_source),
+                filename=ipython_cell_id,
+                mode='exec'
+            )
+        )
+        # f is now accessible in the locals mapping - but for some unknown
+        # reason, f = locals()['f'] throws a KeyError at runtime, we need to
+        # bind locals()['f'] to a different name in the local namespace
+        aliased_f = locals()['f']
+        aliased_f.__module__ = "__main__"
+
+        # Preliminary sanity checks, and tests checking that joblib properly
+        # identified f as an interactive function defined in a jupyter notebook
+        assert aliased_f(1) == 1
+        assert aliased_f.__code__.co_filename == ipython_cell_id
+
+        memory = Memory(location=tmpdir.strpath, verbose=0)
+        cached_f = memory.cache(aliased_f)
+
+        assert len(os.listdir(tmpdir / 'joblib')) == 1
+        f_cache_relative_directory = os.listdir(tmpdir / 'joblib')[0]
+        assert 'ipython-input' in f_cache_relative_directory
+
+        f_cache_directory = tmpdir / 'joblib' / f_cache_relative_directory
+
+        if session_no == 0:
+            # The cache should be empty as cached_f has not been called yet.
+            assert os.listdir(f_cache_directory) == ['f']
+            assert os.listdir(f_cache_directory / 'f') == []
+
+            if call_before_reducing:
+                cached_f(3)
+                # Two files were just created, func_code.py, and a folder
+                # containing the information (inputs hash/ouptput) of
+                # cached_f(3)
+                assert len(os.listdir(f_cache_directory / 'f')) == 2
+
+                # Now, testing  #1035: when calling a cached function, joblib
+                # used to dynamically inspect the underlying function to
+                # extract its source code (to verify it matches the source code
+                # of the function as last inspected by joblib) -- however,
+                # source code introspection fails for dynamic functions sent to
+                # child processes - which would eventually make joblib clear
+                # the cache associated to f
+                res = Parallel(n_jobs=2)(delayed(cached_f)(i) for i in [1, 2])
+            else:
+                # Submit the function to the joblib child processes, although
+                # the function has never been called in the parent yet. This
+                # triggers a specific code branch inside
+                # MemorizedFunc.__reduce__.
+                res = Parallel(n_jobs=2)(delayed(cached_f)(i) for i in [1, 2])
+                assert len(os.listdir(f_cache_directory / 'f')) == 3
+
+                cached_f(3)
+
+            # Making sure f's cache does not get cleared after the parallel
+            # calls, and contains ALL cached functions calls (f(1), f(2), f(3))
+            # and 'func_code.py'
+            assert len(os.listdir(f_cache_directory / 'f')) == 4
+        else:
+            # For the second session, there should be an already existing cache
+            assert len(os.listdir(f_cache_directory / 'f')) == 4
+
+            cached_f(3)
+
+            # The previous cache should not be invalidated after calling the
+            # function in a new session
+            assert len(os.listdir(f_cache_directory / 'f')) == 4
+
+
+def test_no_memory():
+    """ Test memory with location=None: no memoize """
+    accumulator = list()
+
+    def ff(arg):
+        accumulator.append(1)
+        return arg
+
+    memory = Memory(location=None, verbose=0)
+    gg = memory.cache(ff)
+    for _ in range(4):
+        current_accumulator = len(accumulator)
+        gg(1)
+        assert len(accumulator) == current_accumulator + 1
+
+
+def test_memory_kwarg(tmpdir):
+    " Test memory with a function with keyword arguments."
+    accumulator = list()
+
+    def g(arg1=None, arg2=1):
+        accumulator.append(1)
+        return arg1
+
+    check_identity_lazy(g, accumulator, tmpdir.strpath)
+
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    g = memory.cache(g)
+    # Smoke test with an explicit keyword argument:
+    assert g(arg1=30, arg2=2) == 30
+
+
+def test_memory_lambda(tmpdir):
+    " Test memory with a function with a lambda."
+    accumulator = list()
+
+    def helper(x):
+        """ A helper function to define l as a lambda.
+        """
+        accumulator.append(1)
+        return x
+
+    check_identity_lazy(lambda x: helper(x), accumulator, tmpdir.strpath)
+
+
+def test_memory_name_collision(tmpdir):
+    " Check that name collisions with functions will raise warnings"
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+
+    @memory.cache
+    def name_collision(x):
+        """ A first function called name_collision
+        """
+        return x
+
+    a = name_collision
+
+    @memory.cache
+    def name_collision(x):
+        """ A second function called name_collision
+        """
+        return x
+
+    b = name_collision
+
+    with warns(JobLibCollisionWarning) as warninfo:
+        a(1)
+        b(1)
+
+    assert len(warninfo) == 1
+    assert "collision" in str(warninfo[0].message)
+
+
+def test_memory_warning_lambda_collisions(tmpdir):
+    # Check that multiple use of lambda will raise collisions
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    a = memory.cache(lambda x: x)
+    b = memory.cache(lambda x: x + 1)
+
+    with warns(JobLibCollisionWarning) as warninfo:
+        assert a(0) == 0
+        assert b(1) == 2
+        assert a(1) == 1
+
+    # In recent Python versions, we can retrieve the code of lambdas,
+    # thus nothing is raised
+    assert len(warninfo) == 4
+
+
+def test_memory_warning_collision_detection(tmpdir):
+    # Check that collisions impossible to detect will raise appropriate
+    # warnings.
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    a1 = eval('lambda x: x')
+    a1 = memory.cache(a1)
+    b1 = eval('lambda x: x+1')
+    b1 = memory.cache(b1)
+
+    with warns(JobLibCollisionWarning) as warninfo:
+        a1(1)
+        b1(1)
+        a1(0)
+
+    assert len(warninfo) == 2
+    assert "cannot detect" in str(warninfo[0].message).lower()
+
+
+def test_memory_partial(tmpdir):
+    " Test memory with functools.partial."
+    accumulator = list()
+
+    def func(x, y):
+        """ A helper function to define l as a lambda.
+        """
+        accumulator.append(1)
+        return y
+
+    import functools
+    function = functools.partial(func, 1)
+
+    check_identity_lazy(function, accumulator, tmpdir.strpath)
+
+
+def test_memory_eval(tmpdir):
+    " Smoke test memory with a function with a function defined in an eval."
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+
+    m = eval('lambda x: x')
+    mm = memory.cache(m)
+
+    assert mm(1) == 1
+
+
+def count_and_append(x=[]):
+    """ A function with a side effect in its arguments.
+
+        Return the length of its argument and append one element.
+    """
+    len_x = len(x)
+    x.append(None)
+    return len_x
+
+
+def test_argument_change(tmpdir):
+    """ Check that if a function has a side effect in its arguments, it
+        should use the hash of changing arguments.
+    """
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    func = memory.cache(count_and_append)
+    # call the function for the first time, is should cache it with
+    # argument x=[]
+    assert func() == 0
+    # the second time the argument is x=[None], which is not cached
+    # yet, so the functions should be called a second time
+    assert func() == 1
+
+
+@with_numpy
+@parametrize('mmap_mode', [None, 'r'])
+def test_memory_numpy(tmpdir, mmap_mode):
+    " Test memory with a function with numpy arrays."
+    accumulator = list()
+
+    def n(arg=None):
+        accumulator.append(1)
+        return arg
+
+    memory = Memory(location=tmpdir.strpath, mmap_mode=mmap_mode,
+                    verbose=0)
+    cached_n = memory.cache(n)
+
+    rnd = np.random.RandomState(0)
+    for i in range(3):
+        a = rnd.random_sample((10, 10))
+        for _ in range(3):
+            assert np.all(cached_n(a) == a)
+            assert len(accumulator) == i + 1
+
+
+@with_numpy
+def test_memory_numpy_check_mmap_mode(tmpdir, monkeypatch):
+    """Check that mmap_mode is respected even at the first call"""
+
+    memory = Memory(location=tmpdir.strpath, mmap_mode='r', verbose=0)
+
+    @memory.cache()
+    def twice(a):
+        return a * 2
+
+    a = np.ones(3)
+
+    b = twice(a)
+    c = twice(a)
+
+    assert isinstance(c, np.memmap)
+    assert c.mode == 'r'
+
+    assert isinstance(b, np.memmap)
+    assert b.mode == 'r'
+
+    # Corrupts the file,  Deleting b and c mmaps
+    # is necessary to be able edit the file
+    del b
+    del c
+    gc.collect()
+    corrupt_single_cache_item(memory)
+
+    # Make sure that corrupting the file causes recomputation and that
+    # a warning is issued.
+    recorded_warnings = monkeypatch_cached_func_warn(twice, monkeypatch)
+    d = twice(a)
+    assert len(recorded_warnings) == 1
+    exception_msg = 'Exception while loading results'
+    assert exception_msg in recorded_warnings[0]
+    # Asserts that the recomputation returns a mmap
+    assert isinstance(d, np.memmap)
+    assert d.mode == 'r'
+
+
+def test_memory_exception(tmpdir):
+    """ Smoketest the exception handling of Memory.
+    """
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+
+    class MyException(Exception):
+        pass
+
+    @memory.cache
+    def h(exc=0):
+        if exc:
+            raise MyException
+
+    # Call once, to initialise the cache
+    h()
+
+    for _ in range(3):
+        # Call 3 times, to be sure that the Exception is always raised
+        with raises(MyException):
+            h(1)
+
+
+def test_memory_ignore(tmpdir):
+    " Test the ignore feature of memory "
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    accumulator = list()
+
+    @memory.cache(ignore=['y'])
+    def z(x, y=1):
+        accumulator.append(1)
+
+    assert z.ignore == ['y']
+
+    z(0, y=1)
+    assert len(accumulator) == 1
+    z(0, y=1)
+    assert len(accumulator) == 1
+    z(0, y=2)
+    assert len(accumulator) == 1
+
+
+def test_memory_ignore_decorated(tmpdir):
+    " Test the ignore feature of memory on a decorated function "
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    accumulator = list()
+
+    def decorate(f):
+        @functools.wraps(f)
+        def wrapped(*args, **kwargs):
+            return f(*args, **kwargs)
+        return wrapped
+
+    @memory.cache(ignore=['y'])
+    @decorate
+    def z(x, y=1):
+        accumulator.append(1)
+
+    assert z.ignore == ['y']
+
+    z(0, y=1)
+    assert len(accumulator) == 1
+    z(0, y=1)
+    assert len(accumulator) == 1
+    z(0, y=2)
+    assert len(accumulator) == 1
+
+
+def test_memory_args_as_kwargs(tmpdir):
+    """Non-regression test against 0.12.0 changes.
+
+    https://github.com/joblib/joblib/pull/751
+    """
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+
+    @memory.cache
+    def plus_one(a):
+        return a + 1
+
+    # It's possible to call a positional arg as a kwarg.
+    assert plus_one(1) == 2
+    assert plus_one(a=1) == 2
+
+    # However, a positional argument that joblib hadn't seen
+    # before would cause a failure if it was passed as a kwarg.
+    assert plus_one(a=2) == 3
+
+
+@parametrize('ignore, verbose, mmap_mode', [(['x'], 100, 'r'),
+                                            ([], 10, None)])
+def test_partial_decoration(tmpdir, ignore, verbose, mmap_mode):
+    "Check cache may be called with kwargs before decorating"
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+
+    @memory.cache(ignore=ignore, verbose=verbose, mmap_mode=mmap_mode)
+    def z(x):
+        pass
+
+    assert z.ignore == ignore
+    assert z._verbose == verbose
+    assert z.mmap_mode == mmap_mode
+
+
+def test_func_dir(tmpdir):
+    # Test the creation of the memory cache directory for the function.
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    path = __name__.split('.')
+    path.append('f')
+    path = tmpdir.join('joblib', *path).strpath
+
+    g = memory.cache(f)
+    # Test that the function directory is created on demand
+    func_id = _build_func_identifier(f)
+    location = os.path.join(g.store_backend.location, func_id)
+    assert location == path
+    assert os.path.exists(path)
+    assert memory.location == os.path.dirname(g.store_backend.location)
+
+    # Test that the code is stored.
+    # For the following test to be robust to previous execution, we clear
+    # the in-memory store
+    _FUNCTION_HASHES.clear()
+    assert not g._check_previous_func_code()
+    assert os.path.exists(os.path.join(path, 'func_code.py'))
+    assert g._check_previous_func_code()
+
+    # Test the robustness to failure of loading previous results.
+    args_id = g._get_args_id(1)
+    output_dir = os.path.join(g.store_backend.location, g.func_id, args_id)
+    a = g(1)
+    assert os.path.exists(output_dir)
+    os.remove(os.path.join(output_dir, 'output.pkl'))
+    assert a == g(1)
+
+
+def test_persistence(tmpdir):
+    # Test the memorized functions can be pickled and restored.
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    g = memory.cache(f)
+    output = g(1)
+
+    h = pickle.loads(pickle.dumps(g))
+
+    args_id = h._get_args_id(1)
+    output_dir = os.path.join(h.store_backend.location, h.func_id, args_id)
+    assert os.path.exists(output_dir)
+    assert output == h.store_backend.load_item([h.func_id, args_id])
+    memory2 = pickle.loads(pickle.dumps(memory))
+    assert memory.store_backend.location == memory2.store_backend.location
+
+    # Smoke test that pickling a memory with location=None works
+    memory = Memory(location=None, verbose=0)
+    pickle.loads(pickle.dumps(memory))
+    g = memory.cache(f)
+    gp = pickle.loads(pickle.dumps(g))
+    gp(1)
+
+
+def test_check_call_in_cache(tmpdir):
+    for func in (MemorizedFunc(f, tmpdir.strpath),
+                 Memory(location=tmpdir.strpath, verbose=0).cache(f)):
+        result = func.check_call_in_cache(2)
+        assert not result
+        assert isinstance(result, bool)
+        assert func(2) == 5
+        result = func.check_call_in_cache(2)
+        assert result
+        assert isinstance(result, bool)
+        func.clear()
+
+
+def test_call_and_shelve(tmpdir):
+    # Test MemorizedFunc outputting a reference to cache.
+
+    for func, Result in zip((MemorizedFunc(f, tmpdir.strpath),
+                             NotMemorizedFunc(f),
+                             Memory(location=tmpdir.strpath,
+                                    verbose=0).cache(f),
+                             Memory(location=None).cache(f),
+                             ),
+                            (MemorizedResult, NotMemorizedResult,
+                             MemorizedResult, NotMemorizedResult)):
+        assert func(2) == 5
+        result = func.call_and_shelve(2)
+        assert isinstance(result, Result)
+        assert result.get() == 5
+
+        result.clear()
+        with raises(KeyError):
+            result.get()
+        result.clear()  # Do nothing if there is no cache.
+
+
+def test_call_and_shelve_argument_hash(tmpdir):
+    # Verify that a warning is raised when accessing arguments_hash
+    # attribute from MemorizedResult
+    func = Memory(location=tmpdir.strpath, verbose=0).cache(f)
+    result = func.call_and_shelve(2)
+    assert isinstance(result, MemorizedResult)
+    with warns(DeprecationWarning) as w:
+        assert result.argument_hash == result.args_id
+    assert len(w) == 1
+    assert "The 'argument_hash' attribute has been deprecated" \
+        in str(w[-1].message)
+
+
+def test_call_and_shelve_lazily_load_stored_result(tmpdir):
+    """Check call_and_shelve only load stored data if needed."""
+    test_access_time_file = tmpdir.join('test_access')
+    test_access_time_file.write('test_access')
+    test_access_time = os.stat(test_access_time_file.strpath).st_atime
+    # check file system access time stats resolution is lower than test wait
+    # timings.
+    time.sleep(0.5)
+    assert test_access_time_file.read() == 'test_access'
+
+    if test_access_time == os.stat(test_access_time_file.strpath).st_atime:
+        # Skip this test when access time cannot be retrieved with enough
+        # precision from the file system (e.g. NTFS on windows).
+        pytest.skip("filesystem does not support fine-grained access time "
+                    "attribute")
+
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    func = memory.cache(f)
+    args_id = func._get_args_id(2)
+    result_path = os.path.join(memory.store_backend.location,
+                               func.func_id, args_id, 'output.pkl')
+    assert func(2) == 5
+    first_access_time = os.stat(result_path).st_atime
+    time.sleep(1)
+
+    # Should not access the stored data
+    result = func.call_and_shelve(2)
+    assert isinstance(result, MemorizedResult)
+    assert os.stat(result_path).st_atime == first_access_time
+    time.sleep(1)
+
+    # Read the stored data => last access time is greater than first_access
+    assert result.get() == 5
+    assert os.stat(result_path).st_atime > first_access_time
+
+
+def test_memorized_pickling(tmpdir):
+    for func in (MemorizedFunc(f, tmpdir.strpath), NotMemorizedFunc(f)):
+        filename = tmpdir.join('pickling_test.dat').strpath
+        result = func.call_and_shelve(2)
+        with open(filename, 'wb') as fp:
+            pickle.dump(result, fp)
+        with open(filename, 'rb') as fp:
+            result2 = pickle.load(fp)
+        assert result2.get() == result.get()
+        os.remove(filename)
+
+
+def test_memorized_repr(tmpdir):
+    func = MemorizedFunc(f, tmpdir.strpath)
+    result = func.call_and_shelve(2)
+
+    func2 = MemorizedFunc(f, tmpdir.strpath)
+    result2 = func2.call_and_shelve(2)
+    assert result.get() == result2.get()
+    assert repr(func) == repr(func2)
+
+    # Smoke test with NotMemorizedFunc
+    func = NotMemorizedFunc(f)
+    repr(func)
+    repr(func.call_and_shelve(2))
+
+    # Smoke test for message output (increase code coverage)
+    func = MemorizedFunc(f, tmpdir.strpath, verbose=11, timestamp=time.time())
+    result = func.call_and_shelve(11)
+    result.get()
+
+    func = MemorizedFunc(f, tmpdir.strpath, verbose=11)
+    result = func.call_and_shelve(11)
+    result.get()
+
+    func = MemorizedFunc(f, tmpdir.strpath, verbose=5, timestamp=time.time())
+    result = func.call_and_shelve(11)
+    result.get()
+
+    func = MemorizedFunc(f, tmpdir.strpath, verbose=5)
+    result = func.call_and_shelve(11)
+    result.get()
+
+
+def test_memory_file_modification(capsys, tmpdir, monkeypatch):
+    # Test that modifying a Python file after loading it does not lead to
+    # Recomputation
+    dir_name = tmpdir.mkdir('tmp_import').strpath
+    filename = os.path.join(dir_name, 'tmp_joblib_.py')
+    content = 'def f(x):\n    print(x)\n    return x\n'
+    with open(filename, 'w') as module_file:
+        module_file.write(content)
+
+    # Load the module:
+    monkeypatch.syspath_prepend(dir_name)
+    import tmp_joblib_ as tmp
+
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    f = memory.cache(tmp.f)
+    # First call f a few times
+    f(1)
+    f(2)
+    f(1)
+
+    # Now modify the module where f is stored without modifying f
+    with open(filename, 'w') as module_file:
+        module_file.write('\n\n' + content)
+
+    # And call f a couple more times
+    f(1)
+    f(1)
+
+    # Flush the .pyc files
+    shutil.rmtree(dir_name)
+    os.mkdir(dir_name)
+    # Now modify the module where f is stored, modifying f
+    content = 'def f(x):\n    print("x=%s" % x)\n    return x\n'
+    with open(filename, 'w') as module_file:
+        module_file.write(content)
+
+    # And call f more times prior to reloading: the cache should not be
+    # invalidated at this point as the active function definition has not
+    # changed in memory yet.
+    f(1)
+    f(1)
+
+    # Now reload
+    sys.stdout.write('Reloading\n')
+    sys.modules.pop('tmp_joblib_')
+    import tmp_joblib_ as tmp
+    f = memory.cache(tmp.f)
+
+    # And call f more times
+    f(1)
+    f(1)
+
+    out, err = capsys.readouterr()
+    assert out == '1\n2\nReloading\nx=1\n'
+
+
+def _function_to_cache(a, b):
+    # Just a place holder function to be mutated by tests
+    pass
+
+
+def _sum(a, b):
+    return a + b
+
+
+def _product(a, b):
+    return a * b
+
+
+def test_memory_in_memory_function_code_change(tmpdir):
+    _function_to_cache.__code__ = _sum.__code__
+
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    f = memory.cache(_function_to_cache)
+
+    assert f(1, 2) == 3
+    assert f(1, 2) == 3
+
+    with warns(JobLibCollisionWarning):
+        # Check that inline function modification triggers a cache invalidation
+        _function_to_cache.__code__ = _product.__code__
+        assert f(1, 2) == 2
+        assert f(1, 2) == 2
+
+
+def test_clear_memory_with_none_location():
+    memory = Memory(location=None)
+    memory.clear()
+
+
+def func_with_kwonly_args(a, b, *, kw1='kw1', kw2='kw2'):
+    return a, b, kw1, kw2
+
+
+def func_with_signature(a: int, b: float) -> float:
+    return a + b
+
+
+def test_memory_func_with_kwonly_args(tmpdir):
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    func_cached = memory.cache(func_with_kwonly_args)
+
+    assert func_cached(1, 2, kw1=3) == (1, 2, 3, 'kw2')
+
+    # Making sure that providing a keyword-only argument by
+    # position raises an exception
+    with raises(ValueError) as excinfo:
+        func_cached(1, 2, 3, kw2=4)
+    excinfo.match("Keyword-only parameter 'kw1' was passed as positional "
+                  "parameter")
+
+    # Keyword-only parameter passed by position with cached call
+    # should still raise ValueError
+    func_cached(1, 2, kw1=3, kw2=4)
+
+    with raises(ValueError) as excinfo:
+        func_cached(1, 2, 3, kw2=4)
+    excinfo.match("Keyword-only parameter 'kw1' was passed as positional "
+                  "parameter")
+
+    # Test 'ignore' parameter
+    func_cached = memory.cache(func_with_kwonly_args, ignore=['kw2'])
+    assert func_cached(1, 2, kw1=3, kw2=4) == (1, 2, 3, 4)
+    assert func_cached(1, 2, kw1=3, kw2='ignored') == (1, 2, 3, 4)
+
+
+def test_memory_func_with_signature(tmpdir):
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    func_cached = memory.cache(func_with_signature)
+
+    assert func_cached(1, 2.) == 3.
+
+
+def _setup_toy_cache(tmpdir, num_inputs=10):
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+
+    @memory.cache()
+    def get_1000_bytes(arg):
+        return 'a' * 1000
+
+    inputs = list(range(num_inputs))
+    for arg in inputs:
+        get_1000_bytes(arg)
+
+    func_id = _build_func_identifier(get_1000_bytes)
+    hash_dirnames = [get_1000_bytes._get_args_id(arg)
+                     for arg in inputs]
+
+    full_hashdirs = [os.path.join(get_1000_bytes.store_backend.location,
+                                  func_id, dirname)
+                     for dirname in hash_dirnames]
+    return memory, full_hashdirs, get_1000_bytes
+
+
+def test__get_items(tmpdir):
+    memory, expected_hash_dirs, _ = _setup_toy_cache(tmpdir)
+    items = memory.store_backend.get_items()
+    hash_dirs = [ci.path for ci in items]
+    assert set(hash_dirs) == set(expected_hash_dirs)
+
+    def get_files_size(directory):
+        full_paths = [os.path.join(directory, fn)
+                      for fn in os.listdir(directory)]
+        return sum(os.path.getsize(fp) for fp in full_paths)
+
+    expected_hash_cache_sizes = [get_files_size(hash_dir)
+                                 for hash_dir in hash_dirs]
+    hash_cache_sizes = [ci.size for ci in items]
+    assert hash_cache_sizes == expected_hash_cache_sizes
+
+    output_filenames = [os.path.join(hash_dir, 'output.pkl')
+                        for hash_dir in hash_dirs]
+
+    expected_last_accesses = [
+        datetime.datetime.fromtimestamp(os.path.getatime(fn))
+        for fn in output_filenames]
+    last_accesses = [ci.last_access for ci in items]
+    assert last_accesses == expected_last_accesses
+
+
+def test__get_items_to_delete(tmpdir):
+    # test empty cache
+    memory, _, _ = _setup_toy_cache(tmpdir, num_inputs=0)
+    items_to_delete = memory.store_backend._get_items_to_delete('1K')
+    assert items_to_delete == []
+
+    memory, expected_hash_cachedirs, _ = _setup_toy_cache(tmpdir)
+    items = memory.store_backend.get_items()
+    # bytes_limit set to keep only one cache item (each hash cache
+    # folder is about 1000 bytes + metadata)
+    items_to_delete = memory.store_backend._get_items_to_delete('2K')
+    nb_hashes = len(expected_hash_cachedirs)
+    assert set.issubset(set(items_to_delete), set(items))
+    assert len(items_to_delete) == nb_hashes - 1
+
+    # Sanity check bytes_limit=2048 is the same as bytes_limit='2K'
+    items_to_delete_2048b = memory.store_backend._get_items_to_delete(2048)
+    assert sorted(items_to_delete) == sorted(items_to_delete_2048b)
+
+    # bytes_limit greater than the size of the cache
+    items_to_delete_empty = memory.store_backend._get_items_to_delete('1M')
+    assert items_to_delete_empty == []
+
+    # All the cache items need to be deleted
+    bytes_limit_too_small = 500
+    items_to_delete_500b = memory.store_backend._get_items_to_delete(
+        bytes_limit_too_small
+    )
+    assert set(items_to_delete_500b), set(items)
+
+    # Test LRU property: surviving cache items should all have a more
+    # recent last_access that the ones that have been deleted
+    items_to_delete_6000b = memory.store_backend._get_items_to_delete(6000)
+    surviving_items = set(items).difference(items_to_delete_6000b)
+
+    assert (max(ci.last_access for ci in items_to_delete_6000b) <=
+            min(ci.last_access for ci in surviving_items))
+
+
+def test_memory_reduce_size_bytes_limit(tmpdir):
+    memory, _, _ = _setup_toy_cache(tmpdir)
+    ref_cache_items = memory.store_backend.get_items()
+
+    # By default memory.bytes_limit is None and reduce_size is a noop
+    memory.reduce_size()
+    cache_items = memory.store_backend.get_items()
+    assert sorted(ref_cache_items) == sorted(cache_items)
+
+    # No cache items deleted if bytes_limit greater than the size of
+    # the cache
+    memory.reduce_size(bytes_limit='1M')
+    cache_items = memory.store_backend.get_items()
+    assert sorted(ref_cache_items) == sorted(cache_items)
+
+    # bytes_limit is set so that only two cache items are kept
+    memory.reduce_size(bytes_limit='3K')
+    cache_items = memory.store_backend.get_items()
+    assert set.issubset(set(cache_items), set(ref_cache_items))
+    assert len(cache_items) == 2
+
+    # bytes_limit set so that no cache item is kept
+    bytes_limit_too_small = 500
+    memory.reduce_size(bytes_limit=bytes_limit_too_small)
+    cache_items = memory.store_backend.get_items()
+    assert cache_items == []
+
+
+def test_memory_reduce_size_items_limit(tmpdir):
+    memory, _, _ = _setup_toy_cache(tmpdir)
+    ref_cache_items = memory.store_backend.get_items()
+
+    # By default reduce_size is a noop
+    memory.reduce_size()
+    cache_items = memory.store_backend.get_items()
+    assert sorted(ref_cache_items) == sorted(cache_items)
+
+    # No cache items deleted if items_limit greater than the size of
+    # the cache
+    memory.reduce_size(items_limit=10)
+    cache_items = memory.store_backend.get_items()
+    assert sorted(ref_cache_items) == sorted(cache_items)
+
+    # items_limit is set so that only two cache items are kept
+    memory.reduce_size(items_limit=2)
+    cache_items = memory.store_backend.get_items()
+    assert set.issubset(set(cache_items), set(ref_cache_items))
+    assert len(cache_items) == 2
+
+    # item_limit set so that no cache item is kept
+    memory.reduce_size(items_limit=0)
+    cache_items = memory.store_backend.get_items()
+    assert cache_items == []
+
+
+def test_memory_reduce_size_age_limit(tmpdir):
+    import time
+    import datetime
+    memory, _, put_cache = _setup_toy_cache(tmpdir)
+    ref_cache_items = memory.store_backend.get_items()
+
+    # By default reduce_size is a noop
+    memory.reduce_size()
+    cache_items = memory.store_backend.get_items()
+    assert sorted(ref_cache_items) == sorted(cache_items)
+
+    # No cache items deleted if age_limit big.
+    memory.reduce_size(age_limit=datetime.timedelta(days=1))
+    cache_items = memory.store_backend.get_items()
+    assert sorted(ref_cache_items) == sorted(cache_items)
+
+    # age_limit is set so that only two cache items are kept
+    time.sleep(1)
+    put_cache(-1)
+    put_cache(-2)
+    memory.reduce_size(age_limit=datetime.timedelta(seconds=1))
+    cache_items = memory.store_backend.get_items()
+    assert not set.issubset(set(cache_items), set(ref_cache_items))
+    assert len(cache_items) == 2
+
+    # age_limit set so that no cache item is kept
+    memory.reduce_size(age_limit=datetime.timedelta(seconds=0))
+    cache_items = memory.store_backend.get_items()
+    assert cache_items == []
+
+
+def test_memory_clear(tmpdir):
+    memory, _, g = _setup_toy_cache(tmpdir)
+    memory.clear()
+
+    assert os.listdir(memory.store_backend.location) == []
+
+    # Check that the cache for functions hash is also reset.
+    assert not g._check_previous_func_code(stacklevel=4)
+
+
+def fast_func_with_complex_output():
+    complex_obj = ['a' * 1000] * 1000
+    return complex_obj
+
+
+def fast_func_with_conditional_complex_output(complex_output=True):
+    complex_obj = {str(i): i for i in range(int(1e5))}
+    return complex_obj if complex_output else 'simple output'
+
+
+@with_multiprocessing
+def test_cached_function_race_condition_when_persisting_output(tmpdir, capfd):
+    # Test race condition where multiple processes are writing into
+    # the same output.pkl. See
+    # https://github.com/joblib/joblib/issues/490 for more details.
+    memory = Memory(location=tmpdir.strpath)
+    func_cached = memory.cache(fast_func_with_complex_output)
+
+    Parallel(n_jobs=2)(delayed(func_cached)() for i in range(3))
+
+    stdout, stderr = capfd.readouterr()
+
+    # Checking both stdout and stderr (ongoing PR #434 may change
+    # logging destination) to make sure there is no exception while
+    # loading the results
+    exception_msg = 'Exception while loading results'
+    assert exception_msg not in stdout
+    assert exception_msg not in stderr
+
+
+@with_multiprocessing
+def test_cached_function_race_condition_when_persisting_output_2(tmpdir,
+                                                                 capfd):
+    # Test race condition in first attempt at solving
+    # https://github.com/joblib/joblib/issues/490. The race condition
+    # was due to the delay between seeing the cache directory created
+    # (interpreted as the result being cached) and the output.pkl being
+    # pickled.
+    memory = Memory(location=tmpdir.strpath)
+    func_cached = memory.cache(fast_func_with_conditional_complex_output)
+
+    Parallel(n_jobs=2)(delayed(func_cached)(True if i % 2 == 0 else False)
+                       for i in range(3))
+
+    stdout, stderr = capfd.readouterr()
+
+    # Checking both stdout and stderr (ongoing PR #434 may change
+    # logging destination) to make sure there is no exception while
+    # loading the results
+    exception_msg = 'Exception while loading results'
+    assert exception_msg not in stdout
+    assert exception_msg not in stderr
+
+
+def test_memory_recomputes_after_an_error_while_loading_results(
+        tmpdir, monkeypatch):
+    memory = Memory(location=tmpdir.strpath)
+
+    def func(arg):
+        # This makes sure that the timestamp returned by two calls of
+        # func are different. This is needed on Windows where
+        # time.time resolution may not be accurate enough
+        time.sleep(0.01)
+        return arg, time.time()
+
+    cached_func = memory.cache(func)
+    input_arg = 'arg'
+    arg, timestamp = cached_func(input_arg)
+
+    # Make sure the function is correctly cached
+    assert arg == input_arg
+
+    # Corrupting output.pkl to make sure that an error happens when
+    # loading the cached result
+    corrupt_single_cache_item(memory)
+
+    # Make sure that corrupting the file causes recomputation and that
+    # a warning is issued.
+    recorded_warnings = monkeypatch_cached_func_warn(cached_func, monkeypatch)
+    recomputed_arg, recomputed_timestamp = cached_func(arg)
+    assert len(recorded_warnings) == 1
+    exception_msg = 'Exception while loading results'
+    assert exception_msg in recorded_warnings[0]
+    assert recomputed_arg == arg
+    assert recomputed_timestamp > timestamp
+
+    # Corrupting output.pkl to make sure that an error happens when
+    # loading the cached result
+    corrupt_single_cache_item(memory)
+    reference = cached_func.call_and_shelve(arg)
+    try:
+        reference.get()
+        raise AssertionError(
+            "It normally not possible to load a corrupted"
+            " MemorizedResult"
+        )
+    except KeyError as e:
+        message = "is corrupted"
+        assert message in str(e.args)
+
+
+class IncompleteStoreBackend(StoreBackendBase):
+    """This backend cannot be instantiated and should raise a TypeError."""
+    pass
+
+
+class DummyStoreBackend(StoreBackendBase):
+    """A dummy store backend that does nothing."""
+
+    def _open_item(self, *args, **kwargs):
+        """Open an item on store."""
+        "Does nothing"
+
+    def _item_exists(self, location):
+        """Check if an item location exists."""
+        "Does nothing"
+
+    def _move_item(self, src, dst):
+        """Move an item from src to dst in store."""
+        "Does nothing"
+
+    def create_location(self, location):
+        """Create location on store."""
+        "Does nothing"
+
+    def exists(self, obj):
+        """Check if an object exists in the store"""
+        return False
+
+    def clear_location(self, obj):
+        """Clear object on store"""
+        "Does nothing"
+
+    def get_items(self):
+        """Returns the whole list of items available in cache."""
+        return []
+
+    def configure(self, location, *args, **kwargs):
+        """Configure the store"""
+        "Does nothing"
+
+
+@parametrize("invalid_prefix", [None, dict(), list()])
+def test_register_invalid_store_backends_key(invalid_prefix):
+    # verify the right exceptions are raised when passing a wrong backend key.
+    with raises(ValueError) as excinfo:
+        register_store_backend(invalid_prefix, None)
+    excinfo.match(r'Store backend name should be a string*')
+
+
+def test_register_invalid_store_backends_object():
+    # verify the right exceptions are raised when passing a wrong backend
+    # object.
+    with raises(ValueError) as excinfo:
+        register_store_backend("fs", None)
+    excinfo.match(r'Store backend should inherit StoreBackendBase*')
+
+
+def test_memory_default_store_backend():
+    # test an unknown backend falls back into a FileSystemStoreBackend
+    with raises(TypeError) as excinfo:
+        Memory(location='/tmp/joblib', backend='unknown')
+    excinfo.match(r"Unknown location*")
+
+
+def test_warning_on_unknown_location_type():
+    class NonSupportedLocationClass:
+        pass
+    unsupported_location = NonSupportedLocationClass()
+
+    with warns(UserWarning) as warninfo:
+        _store_backend_factory("local", location=unsupported_location)
+
+    expected_mesage = ("Instantiating a backend using a "
+                       "NonSupportedLocationClass as a location is not "
+                       "supported by joblib")
+    assert expected_mesage in str(warninfo[0].message)
+
+
+def test_instanciate_incomplete_store_backend():
+    # Verify that registering an external incomplete store backend raises an
+    # exception when one tries to instantiate it.
+    backend_name = "isb"
+    register_store_backend(backend_name, IncompleteStoreBackend)
+    assert (backend_name, IncompleteStoreBackend) in _STORE_BACKENDS.items()
+    with raises(TypeError) as excinfo:
+        _store_backend_factory(backend_name, "fake_location")
+    excinfo.match(r"Can't instantiate abstract class IncompleteStoreBackend "
+                  "(without an implementation for|with) abstract methods*")
+
+
+def test_dummy_store_backend():
+    # Verify that registering an external store backend works.
+
+    backend_name = "dsb"
+    register_store_backend(backend_name, DummyStoreBackend)
+    assert (backend_name, DummyStoreBackend) in _STORE_BACKENDS.items()
+
+    backend_obj = _store_backend_factory(backend_name, "dummy_location")
+    assert isinstance(backend_obj, DummyStoreBackend)
+
+
+def test_instanciate_store_backend_with_pathlib_path():
+    # Instantiate a FileSystemStoreBackend using a pathlib.Path object
+    path = pathlib.Path("some_folder")
+    backend_obj = _store_backend_factory("local", path)
+    assert backend_obj.location == "some_folder"
+
+
+def test_filesystem_store_backend_repr(tmpdir):
+    # Verify string representation of a filesystem store backend.
+
+    repr_pattern = 'FileSystemStoreBackend(location="{location}")'
+    backend = FileSystemStoreBackend()
+    assert backend.location is None
+
+    repr(backend)  # Should not raise an exception
+
+    assert str(backend) == repr_pattern.format(location=None)
+
+    # backend location is passed explicitly via the configure method (called
+    # by the internal _store_backend_factory function)
+    backend.configure(tmpdir.strpath)
+
+    assert str(backend) == repr_pattern.format(location=tmpdir.strpath)
+
+    repr(backend)  # Should not raise an exception
+
+
+def test_memory_objects_repr(tmpdir):
+    # Verify printable reprs of MemorizedResult, MemorizedFunc and Memory.
+
+    def my_func(a, b):
+        return a + b
+
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    memorized_func = memory.cache(my_func)
+
+    memorized_func_repr = 'MemorizedFunc(func={func}, location={location})'
+
+    assert str(memorized_func) == memorized_func_repr.format(
+        func=my_func,
+        location=memory.store_backend.location)
+
+    memorized_result = memorized_func.call_and_shelve(42, 42)
+
+    memorized_result_repr = ('MemorizedResult(location="{location}", '
+                             'func="{func}", args_id="{args_id}")')
+
+    assert str(memorized_result) == memorized_result_repr.format(
+        location=memory.store_backend.location,
+        func=memorized_result.func_id,
+        args_id=memorized_result.args_id)
+
+    assert str(memory) == 'Memory(location={location})'.format(
+        location=memory.store_backend.location)
+
+
+def test_memorized_result_pickle(tmpdir):
+    # Verify a MemoryResult object can be pickled/depickled. Non regression
+    # test introduced following issue
+    # https://github.com/joblib/joblib/issues/747
+
+    memory = Memory(location=tmpdir.strpath)
+
+    @memory.cache
+    def g(x):
+        return x**2
+
+    memorized_result = g.call_and_shelve(4)
+    memorized_result_pickle = pickle.dumps(memorized_result)
+    memorized_result_loads = pickle.loads(memorized_result_pickle)
+
+    assert memorized_result.store_backend.location == \
+        memorized_result_loads.store_backend.location
+    assert memorized_result.func == memorized_result_loads.func
+    assert memorized_result.args_id == memorized_result_loads.args_id
+    assert str(memorized_result) == str(memorized_result_loads)
+
+
+def compare(left, right, ignored_attrs=None):
+    if ignored_attrs is None:
+        ignored_attrs = []
+
+    left_vars = vars(left)
+    right_vars = vars(right)
+    assert set(left_vars.keys()) == set(right_vars.keys())
+    for attr in left_vars.keys():
+        if attr in ignored_attrs:
+            continue
+        assert left_vars[attr] == right_vars[attr]
+
+
+@pytest.mark.parametrize('memory_kwargs',
+                         [{'compress': 3, 'verbose': 2},
+                          {'mmap_mode': 'r', 'verbose': 5,
+                           'backend_options': {'parameter': 'unused'}}])
+def test_memory_pickle_dump_load(tmpdir, memory_kwargs):
+    memory = Memory(location=tmpdir.strpath, **memory_kwargs)
+
+    memory_reloaded = pickle.loads(pickle.dumps(memory))
+
+    # Compare Memory instance before and after pickle roundtrip
+    compare(memory.store_backend, memory_reloaded.store_backend)
+    compare(memory, memory_reloaded,
+            ignored_attrs=set(['store_backend', 'timestamp', '_func_code_id']))
+    assert hash(memory) == hash(memory_reloaded)
+
+    func_cached = memory.cache(f)
+
+    func_cached_reloaded = pickle.loads(pickle.dumps(func_cached))
+
+    # Compare MemorizedFunc instance before/after pickle roundtrip
+    compare(func_cached.store_backend, func_cached_reloaded.store_backend)
+    compare(func_cached, func_cached_reloaded,
+            ignored_attrs=set(['store_backend', 'timestamp', '_func_code_id']))
+    assert hash(func_cached) == hash(func_cached_reloaded)
+
+    # Compare MemorizedResult instance before/after pickle roundtrip
+    memorized_result = func_cached.call_and_shelve(1)
+    memorized_result_reloaded = pickle.loads(pickle.dumps(memorized_result))
+
+    compare(memorized_result.store_backend,
+            memorized_result_reloaded.store_backend)
+    compare(memorized_result, memorized_result_reloaded,
+            ignored_attrs=set(['store_backend', 'timestamp', '_func_code_id']))
+    assert hash(memorized_result) == hash(memorized_result_reloaded)
+
+
+def test_info_log(tmpdir, caplog):
+    caplog.set_level(logging.INFO)
+    x = 3
+
+    memory = Memory(location=tmpdir.strpath, verbose=20)
+
+    @memory.cache
+    def f(x):
+        return x ** 2
+
+    _ = f(x)
+    assert "Querying" in caplog.text
+    caplog.clear()
+
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+
+    @memory.cache
+    def f(x):
+        return x ** 2
+
+    _ = f(x)
+    assert "Querying" not in caplog.text
+    caplog.clear()
+
+
+def test_deprecated_bytes_limit(tmpdir):
+    from joblib import __version__
+    if __version__ >= "1.5":
+        raise DeprecationWarning(
+            "Bytes limit is deprecated and should be removed by 1.4"
+        )
+    with pytest.warns(DeprecationWarning, match="bytes_limit"):
+        _ = Memory(location=tmpdir.strpath, bytes_limit='1K')
+
+
+class TestCacheValidationCallback:
+    "Tests on parameter `cache_validation_callback`"
+
+    @pytest.fixture()
+    def memory(self, tmp_path):
+        mem = Memory(location=tmp_path)
+        yield mem
+        mem.clear()
+
+    def foo(self, x, d, delay=None):
+        d["run"] = True
+        if delay is not None:
+            time.sleep(delay)
+        return x * 2
+
+    def test_invalid_cache_validation_callback(self, memory):
+        "Test invalid values for `cache_validation_callback"
+        match = "cache_validation_callback needs to be callable. Got True."
+        with pytest.raises(ValueError, match=match):
+            memory.cache(cache_validation_callback=True)
+
+    @pytest.mark.parametrize("consider_cache_valid", [True, False])
+    def test_constant_cache_validation_callback(
+            self, memory, consider_cache_valid
+    ):
+        "Test expiry of old results"
+        f = memory.cache(
+            self.foo, cache_validation_callback=lambda _: consider_cache_valid,
+            ignore=["d"]
+        )
+
+        d1, d2 = {"run": False}, {"run": False}
+        assert f(2, d1) == 4
+        assert f(2, d2) == 4
+
+        assert d1["run"]
+        assert d2["run"] != consider_cache_valid
+
+    def test_memory_only_cache_long_run(self, memory):
+        "Test cache validity based on run duration."
+
+        def cache_validation_callback(metadata):
+            duration = metadata['duration']
+            if duration > 0.1:
+                return True
+
+        f = memory.cache(
+            self.foo, cache_validation_callback=cache_validation_callback,
+            ignore=["d"]
+        )
+
+        # Short run are not cached
+        d1, d2 = {"run": False}, {"run": False}
+        assert f(2, d1, delay=0) == 4
+        assert f(2, d2, delay=0) == 4
+        assert d1["run"]
+        assert d2["run"]
+
+        # Longer run are cached
+        d1, d2 = {"run": False}, {"run": False}
+        assert f(2, d1, delay=0.2) == 4
+        assert f(2, d2, delay=0.2) == 4
+        assert d1["run"]
+        assert not d2["run"]
+
+    def test_memory_expires_after(self, memory):
+        "Test expiry of old cached results"
+
+        f = memory.cache(
+            self.foo, cache_validation_callback=expires_after(seconds=.3),
+            ignore=["d"]
+        )
+
+        d1, d2, d3 = {"run": False}, {"run": False}, {"run": False}
+        assert f(2, d1) == 4
+        assert f(2, d2) == 4
+        time.sleep(.5)
+        assert f(2, d3) == 4
+
+        assert d1["run"]
+        assert not d2["run"]
+        assert d3["run"]
diff --git a/llm/Lib/site-packages/joblib/test/test_memory_async.py b/llm/Lib/site-packages/joblib/test/test_memory_async.py
new file mode 100644
index 0000000000000000000000000000000000000000..ecad0c926193a7ed84f669cface0023363f231ff
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_memory_async.py
@@ -0,0 +1,149 @@
+import asyncio
+import gc
+import shutil
+
+import pytest
+
+from joblib.memory import (AsyncMemorizedFunc, AsyncNotMemorizedFunc,
+                           MemorizedResult, Memory, NotMemorizedResult)
+from joblib.test.common import np, with_numpy
+from joblib.testing import raises
+
+from .test_memory import (corrupt_single_cache_item,
+                          monkeypatch_cached_func_warn)
+
+
+async def check_identity_lazy_async(func, accumulator, location):
+    """ Similar to check_identity_lazy_async for coroutine functions"""
+    memory = Memory(location=location, verbose=0)
+    func = memory.cache(func)
+    for i in range(3):
+        for _ in range(2):
+            value = await func(i)
+            assert value == i
+            assert len(accumulator) == i + 1
+
+
+@pytest.mark.asyncio
+async def test_memory_integration_async(tmpdir):
+    accumulator = list()
+
+    async def f(n):
+        await asyncio.sleep(0.1)
+        accumulator.append(1)
+        return n
+
+    await check_identity_lazy_async(f, accumulator, tmpdir.strpath)
+
+    # Now test clearing
+    for compress in (False, True):
+        for mmap_mode in ('r', None):
+            memory = Memory(location=tmpdir.strpath, verbose=10,
+                            mmap_mode=mmap_mode, compress=compress)
+            # First clear the cache directory, to check that our code can
+            # handle that
+            # NOTE: this line would raise an exception, as the database
+            # file is still open; we ignore the error since we want to
+            # test what happens if the directory disappears
+            shutil.rmtree(tmpdir.strpath, ignore_errors=True)
+            g = memory.cache(f)
+            await g(1)
+            g.clear(warn=False)
+            current_accumulator = len(accumulator)
+            out = await g(1)
+
+        assert len(accumulator) == current_accumulator + 1
+        # Also, check that Memory.eval works similarly
+        evaled = await memory.eval(f, 1)
+        assert evaled == out
+        assert len(accumulator) == current_accumulator + 1
+
+    # Now do a smoke test with a function defined in __main__, as the name
+    # mangling rules are more complex
+    f.__module__ = '__main__'
+    memory = Memory(location=tmpdir.strpath, verbose=0)
+    await memory.cache(f)(1)
+
+
+@pytest.mark.asyncio
+async def test_no_memory_async():
+    accumulator = list()
+
+    async def ff(x):
+        await asyncio.sleep(0.1)
+        accumulator.append(1)
+        return x
+
+    memory = Memory(location=None, verbose=0)
+    gg = memory.cache(ff)
+    for _ in range(4):
+        current_accumulator = len(accumulator)
+        await gg(1)
+        assert len(accumulator) == current_accumulator + 1
+
+
+@with_numpy
+@pytest.mark.asyncio
+async def test_memory_numpy_check_mmap_mode_async(tmpdir, monkeypatch):
+    """Check that mmap_mode is respected even at the first call"""
+
+    memory = Memory(location=tmpdir.strpath, mmap_mode='r', verbose=0)
+
+    @memory.cache()
+    async def twice(a):
+        return a * 2
+
+    a = np.ones(3)
+    b = await twice(a)
+    c = await twice(a)
+
+    assert isinstance(c, np.memmap)
+    assert c.mode == 'r'
+
+    assert isinstance(b, np.memmap)
+    assert b.mode == 'r'
+
+    # Corrupts the file,  Deleting b and c mmaps
+    # is necessary to be able edit the file
+    del b
+    del c
+    gc.collect()
+    corrupt_single_cache_item(memory)
+
+    # Make sure that corrupting the file causes recomputation and that
+    # a warning is issued.
+    recorded_warnings = monkeypatch_cached_func_warn(twice, monkeypatch)
+    d = await twice(a)
+    assert len(recorded_warnings) == 1
+    exception_msg = 'Exception while loading results'
+    assert exception_msg in recorded_warnings[0]
+    # Asserts that the recomputation returns a mmap
+    assert isinstance(d, np.memmap)
+    assert d.mode == 'r'
+
+
+@pytest.mark.asyncio
+async def test_call_and_shelve_async(tmpdir):
+    async def f(x, y=1):
+        await asyncio.sleep(0.1)
+        return x ** 2 + y
+
+    # Test MemorizedFunc outputting a reference to cache.
+    for func, Result in zip((AsyncMemorizedFunc(f, tmpdir.strpath),
+                             AsyncNotMemorizedFunc(f),
+                             Memory(location=tmpdir.strpath,
+                                    verbose=0).cache(f),
+                             Memory(location=None).cache(f),
+                             ),
+                            (MemorizedResult, NotMemorizedResult,
+                             MemorizedResult, NotMemorizedResult,
+                             )):
+        for _ in range(2):
+            result = await func.call_and_shelve(2)
+            assert isinstance(result, Result)
+            assert result.get() == 5
+
+        result.clear()
+        with raises(KeyError):
+            result.get()
+        result.clear()  # Do nothing if there is no cache.
diff --git a/llm/Lib/site-packages/joblib/test/test_missing_multiprocessing.py b/llm/Lib/site-packages/joblib/test/test_missing_multiprocessing.py
new file mode 100644
index 0000000000000000000000000000000000000000..251925ced5208b4aaf09d9aab305eb44c7102818
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_missing_multiprocessing.py
@@ -0,0 +1,32 @@
+"""
+Pyodide and other single-threaded Python builds will be missing the
+_multiprocessing module. Test that joblib still works in this environment.
+"""
+
+import os
+import subprocess
+import sys
+
+
+def test_missing_multiprocessing(tmp_path):
+    """
+    Test that import joblib works even if _multiprocessing is missing.
+
+    pytest has already imported everything from joblib. The most reasonable way
+    to test importing joblib with modified environment is to invoke a separate
+    Python process. This also ensures that we don't break other tests by
+    importing a bad `_multiprocessing` module.
+    """
+    (tmp_path / "_multiprocessing.py").write_text(
+        'raise ImportError("No _multiprocessing module!")'
+    )
+    env = dict(os.environ)
+    # For subprocess, use current sys.path with our custom version of
+    # multiprocessing inserted.
+    env["PYTHONPATH"] = ":".join([str(tmp_path)] + sys.path)
+    subprocess.check_call(
+        [sys.executable, "-c",
+         "import joblib, math; "
+         "joblib.Parallel(n_jobs=1)("
+         "joblib.delayed(math.sqrt)(i**2) for i in range(10))"
+         ], env=env)
diff --git a/llm/Lib/site-packages/joblib/test/test_module.py b/llm/Lib/site-packages/joblib/test/test_module.py
new file mode 100644
index 0000000000000000000000000000000000000000..a2257a4142d79996f3d299cb820927ae48a05810
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_module.py
@@ -0,0 +1,53 @@
+import sys
+import joblib
+from joblib.testing import check_subprocess_call
+from joblib.test.common import with_multiprocessing
+
+
+def test_version():
+    assert hasattr(joblib, '__version__'), (
+        "There are no __version__ argument on the joblib module")
+
+
+@with_multiprocessing
+def test_no_start_method_side_effect_on_import():
+    # check that importing joblib does not implicitly set the global
+    # start_method for multiprocessing.
+    code = """if True:
+        import joblib
+        import multiprocessing as mp
+        # The following line would raise RuntimeError if the
+        # start_method is already set.
+        mp.set_start_method("loky")
+    """
+    check_subprocess_call([sys.executable, '-c', code])
+
+
+@with_multiprocessing
+def test_no_semaphore_tracker_on_import():
+    # check that importing joblib does not implicitly spawn a resource tracker
+    # or a semaphore tracker
+    code = """if True:
+        import joblib
+        from multiprocessing import semaphore_tracker
+        # The following line would raise RuntimeError if the
+        # start_method is already set.
+        msg = "multiprocessing.semaphore_tracker has been spawned on import"
+        assert semaphore_tracker._semaphore_tracker._fd is None, msg"""
+    if sys.version_info >= (3, 8):
+        # semaphore_tracker was renamed in Python 3.8:
+        code = code.replace("semaphore_tracker", "resource_tracker")
+    check_subprocess_call([sys.executable, '-c', code])
+
+
+@with_multiprocessing
+def test_no_resource_tracker_on_import():
+    code = """if True:
+        import joblib
+        from joblib.externals.loky.backend import resource_tracker
+        # The following line would raise RuntimeError if the
+        # start_method is already set.
+        msg = "loky.resource_tracker has been spawned on import"
+        assert resource_tracker._resource_tracker._fd is None, msg
+    """
+    check_subprocess_call([sys.executable, '-c', code])
diff --git a/llm/Lib/site-packages/joblib/test/test_numpy_pickle.py b/llm/Lib/site-packages/joblib/test/test_numpy_pickle.py
new file mode 100644
index 0000000000000000000000000000000000000000..9fee585c79ad219d3a9f8cdc6a55655b50099c09
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_numpy_pickle.py
@@ -0,0 +1,1159 @@
+"""Test the numpy pickler as a replacement of the standard pickler."""
+
+import copy
+import os
+import random
+import re
+import io
+import sys
+import warnings
+import gzip
+import zlib
+import bz2
+import pickle
+import socket
+from contextlib import closing
+import mmap
+from pathlib import Path
+
+try:
+    import lzma
+except ImportError:
+    lzma = None
+
+import pytest
+
+from joblib.test.common import np, with_numpy, with_lz4, without_lz4
+from joblib.test.common import with_memory_profiler, memory_used
+from joblib.testing import parametrize, raises, warns
+
+# numpy_pickle is not a drop-in replacement of pickle, as it takes
+# filenames instead of open files as arguments.
+from joblib import numpy_pickle, register_compressor
+from joblib.test import data
+
+from joblib.numpy_pickle_utils import _IO_BUFFER_SIZE
+from joblib.numpy_pickle_utils import _detect_compressor
+from joblib.numpy_pickle_utils import _is_numpy_array_byte_order_mismatch
+from joblib.numpy_pickle_utils import _ensure_native_byte_order
+from joblib.compressor import (_COMPRESSORS, _LZ4_PREFIX, CompressorWrapper,
+                               LZ4_NOT_INSTALLED_ERROR, BinaryZlibFile)
+
+
+###############################################################################
+# Define a list of standard types.
+# Borrowed from dill, initial author: Micheal McKerns:
+# http://dev.danse.us/trac/pathos/browser/dill/dill_test2.py
+
+typelist = []
+
+# testing types
+_none = None
+typelist.append(_none)
+_type = type
+typelist.append(_type)
+_bool = bool(1)
+typelist.append(_bool)
+_int = int(1)
+typelist.append(_int)
+_float = float(1)
+typelist.append(_float)
+_complex = complex(1)
+typelist.append(_complex)
+_string = str(1)
+typelist.append(_string)
+_tuple = ()
+typelist.append(_tuple)
+_list = []
+typelist.append(_list)
+_dict = {}
+typelist.append(_dict)
+_builtin = len
+typelist.append(_builtin)
+
+
+def _function(x):
+    yield x
+
+
+class _class:
+    def _method(self):
+        pass
+
+
+class _newclass(object):
+    def _method(self):
+        pass
+
+
+typelist.append(_function)
+typelist.append(_class)
+typelist.append(_newclass)  # <type 'type'>
+_instance = _class()
+typelist.append(_instance)
+_object = _newclass()
+typelist.append(_object)  # <type 'class'>
+
+
+###############################################################################
+# Tests
+
+@parametrize('compress', [0, 1])
+@parametrize('member', typelist)
+def test_standard_types(tmpdir, compress, member):
+    # Test pickling and saving with standard types.
+    filename = tmpdir.join('test.pkl').strpath
+    numpy_pickle.dump(member, filename, compress=compress)
+    _member = numpy_pickle.load(filename)
+    # We compare the pickled instance to the reloaded one only if it
+    # can be compared to a copied one
+    if member == copy.deepcopy(member):
+        assert member == _member
+
+
+def test_value_error():
+    # Test inverting the input arguments to dump
+    with raises(ValueError):
+        numpy_pickle.dump('foo', dict())
+
+
+@parametrize('wrong_compress', [-1, 10, dict()])
+def test_compress_level_error(wrong_compress):
+    # Verify that passing an invalid compress argument raises an error.
+    exception_msg = ('Non valid compress level given: '
+                     '"{0}"'.format(wrong_compress))
+    with raises(ValueError) as excinfo:
+        numpy_pickle.dump('dummy', 'foo', compress=wrong_compress)
+    excinfo.match(exception_msg)
+
+
+@with_numpy
+@parametrize('compress', [False, True, 0, 3, 'zlib'])
+def test_numpy_persistence(tmpdir, compress):
+    filename = tmpdir.join('test.pkl').strpath
+    rnd = np.random.RandomState(0)
+    a = rnd.random_sample((10, 2))
+    # We use 'a.T' to have a non C-contiguous array.
+    for index, obj in enumerate(((a,), (a.T,), (a, a), [a, a, a])):
+        filenames = numpy_pickle.dump(obj, filename, compress=compress)
+
+        # All is cached in one file
+        assert len(filenames) == 1
+        # Check that only one file was created
+        assert filenames[0] == filename
+        # Check that this file does exist
+        assert os.path.exists(filenames[0])
+
+        # Unpickle the object
+        obj_ = numpy_pickle.load(filename)
+        # Check that the items are indeed arrays
+        for item in obj_:
+            assert isinstance(item, np.ndarray)
+        # And finally, check that all the values are equal.
+        np.testing.assert_array_equal(np.array(obj), np.array(obj_))
+
+    # Now test with an array subclass
+    obj = np.memmap(filename + 'mmap', mode='w+', shape=4, dtype=np.float64)
+    filenames = numpy_pickle.dump(obj, filename, compress=compress)
+    # All is cached in one file
+    assert len(filenames) == 1
+
+    obj_ = numpy_pickle.load(filename)
+    if (type(obj) is not np.memmap and
+            hasattr(obj, '__array_prepare__')):
+        # We don't reconstruct memmaps
+        assert isinstance(obj_, type(obj))
+
+    np.testing.assert_array_equal(obj_, obj)
+
+    # Test with an object containing multiple numpy arrays
+    obj = ComplexTestObject()
+    filenames = numpy_pickle.dump(obj, filename, compress=compress)
+    # All is cached in one file
+    assert len(filenames) == 1
+
+    obj_loaded = numpy_pickle.load(filename)
+    assert isinstance(obj_loaded, type(obj))
+    np.testing.assert_array_equal(obj_loaded.array_float, obj.array_float)
+    np.testing.assert_array_equal(obj_loaded.array_int, obj.array_int)
+    np.testing.assert_array_equal(obj_loaded.array_obj, obj.array_obj)
+
+
+@with_numpy
+def test_numpy_persistence_bufferred_array_compression(tmpdir):
+    big_array = np.ones((_IO_BUFFER_SIZE + 100), dtype=np.uint8)
+    filename = tmpdir.join('test.pkl').strpath
+    numpy_pickle.dump(big_array, filename, compress=True)
+    arr_reloaded = numpy_pickle.load(filename)
+
+    np.testing.assert_array_equal(big_array, arr_reloaded)
+
+
+@with_numpy
+def test_memmap_persistence(tmpdir):
+    rnd = np.random.RandomState(0)
+    a = rnd.random_sample(10)
+    filename = tmpdir.join('test1.pkl').strpath
+    numpy_pickle.dump(a, filename)
+    b = numpy_pickle.load(filename, mmap_mode='r')
+
+    assert isinstance(b, np.memmap)
+
+    # Test with an object containing multiple numpy arrays
+    filename = tmpdir.join('test2.pkl').strpath
+    obj = ComplexTestObject()
+    numpy_pickle.dump(obj, filename)
+    obj_loaded = numpy_pickle.load(filename, mmap_mode='r')
+    assert isinstance(obj_loaded, type(obj))
+    assert isinstance(obj_loaded.array_float, np.memmap)
+    assert not obj_loaded.array_float.flags.writeable
+    assert isinstance(obj_loaded.array_int, np.memmap)
+    assert not obj_loaded.array_int.flags.writeable
+    # Memory map not allowed for numpy object arrays
+    assert not isinstance(obj_loaded.array_obj, np.memmap)
+    np.testing.assert_array_equal(obj_loaded.array_float,
+                                  obj.array_float)
+    np.testing.assert_array_equal(obj_loaded.array_int,
+                                  obj.array_int)
+    np.testing.assert_array_equal(obj_loaded.array_obj,
+                                  obj.array_obj)
+
+    # Test we can write in memmapped arrays
+    obj_loaded = numpy_pickle.load(filename, mmap_mode='r+')
+    assert obj_loaded.array_float.flags.writeable
+    obj_loaded.array_float[0:10] = 10.0
+    assert obj_loaded.array_int.flags.writeable
+    obj_loaded.array_int[0:10] = 10
+
+    obj_reloaded = numpy_pickle.load(filename, mmap_mode='r')
+    np.testing.assert_array_equal(obj_reloaded.array_float,
+                                  obj_loaded.array_float)
+    np.testing.assert_array_equal(obj_reloaded.array_int,
+                                  obj_loaded.array_int)
+
+    # Test w+ mode is caught and the mode has switched to r+
+    numpy_pickle.load(filename, mmap_mode='w+')
+    assert obj_loaded.array_int.flags.writeable
+    assert obj_loaded.array_int.mode == 'r+'
+    assert obj_loaded.array_float.flags.writeable
+    assert obj_loaded.array_float.mode == 'r+'
+
+
+@with_numpy
+def test_memmap_persistence_mixed_dtypes(tmpdir):
+    # loading datastructures that have sub-arrays with dtype=object
+    # should not prevent memmapping on fixed size dtype sub-arrays.
+    rnd = np.random.RandomState(0)
+    a = rnd.random_sample(10)
+    b = np.array([1, 'b'], dtype=object)
+    construct = (a, b)
+    filename = tmpdir.join('test.pkl').strpath
+    numpy_pickle.dump(construct, filename)
+    a_clone, b_clone = numpy_pickle.load(filename, mmap_mode='r')
+
+    # the floating point array has been memory mapped
+    assert isinstance(a_clone, np.memmap)
+
+    # the object-dtype array has been loaded in memory
+    assert not isinstance(b_clone, np.memmap)
+
+
+@with_numpy
+def test_masked_array_persistence(tmpdir):
+    # The special-case picker fails, because saving masked_array
+    # not implemented, but it just delegates to the standard pickler.
+    rnd = np.random.RandomState(0)
+    a = rnd.random_sample(10)
+    a = np.ma.masked_greater(a, 0.5)
+    filename = tmpdir.join('test.pkl').strpath
+    numpy_pickle.dump(a, filename)
+    b = numpy_pickle.load(filename, mmap_mode='r')
+    assert isinstance(b, np.ma.masked_array)
+
+
+@with_numpy
+def test_compress_mmap_mode_warning(tmpdir):
+    # Test the warning in case of compress + mmap_mode
+    rnd = np.random.RandomState(0)
+    a = rnd.random_sample(10)
+    this_filename = tmpdir.join('test.pkl').strpath
+    numpy_pickle.dump(a, this_filename, compress=1)
+    with warns(UserWarning) as warninfo:
+        numpy_pickle.load(this_filename, mmap_mode='r+')
+    debug_msg = "\n".join([str(w) for w in warninfo])
+    warninfo = [w.message for w in warninfo]
+    assert len(warninfo) == 1, debug_msg
+    assert (
+        str(warninfo[0]) ==
+        'mmap_mode "r+" is not compatible with compressed '
+        f'file {this_filename}. "r+" flag will be ignored.'
+    )
+
+
+@with_numpy
+@parametrize('cache_size', [None, 0, 10])
+def test_cache_size_warning(tmpdir, cache_size):
+    # Check deprecation warning raised when cache size is not None
+    filename = tmpdir.join('test.pkl').strpath
+    rnd = np.random.RandomState(0)
+    a = rnd.random_sample((10, 2))
+
+    warnings.simplefilter("always")
+    with warnings.catch_warnings(record=True) as warninfo:
+        numpy_pickle.dump(a, filename, cache_size=cache_size)
+    expected_nb_warnings = 1 if cache_size is not None else 0
+    assert len(warninfo) == expected_nb_warnings
+    for w in warninfo:
+        assert w.category == DeprecationWarning
+        assert (str(w.message) ==
+                "Please do not set 'cache_size' in joblib.dump, this "
+                "parameter has no effect and will be removed. You "
+                "used 'cache_size={0}'".format(cache_size))
+
+
+@with_numpy
+@with_memory_profiler
+@parametrize('compress', [True, False])
+def test_memory_usage(tmpdir, compress):
+    # Verify memory stays within expected bounds.
+    filename = tmpdir.join('test.pkl').strpath
+    small_array = np.ones((10, 10))
+    big_array = np.ones(shape=100 * int(1e6), dtype=np.uint8)
+
+    for obj in (small_array, big_array):
+        size = obj.nbytes / 1e6
+        obj_filename = filename + str(np.random.randint(0, 1000))
+        mem_used = memory_used(numpy_pickle.dump,
+                               obj, obj_filename, compress=compress)
+
+        # The memory used to dump the object shouldn't exceed the buffer
+        # size used to write array chunks (16MB).
+        write_buf_size = _IO_BUFFER_SIZE + 16 * 1024 ** 2 / 1e6
+        assert mem_used <= write_buf_size
+
+        mem_used = memory_used(numpy_pickle.load, obj_filename)
+        # memory used should be less than array size + buffer size used to
+        # read the array chunk by chunk.
+        read_buf_size = 32 + _IO_BUFFER_SIZE  # MiB
+        assert mem_used < size + read_buf_size
+
+
+@with_numpy
+def test_compressed_pickle_dump_and_load(tmpdir):
+    expected_list = [np.arange(5, dtype=np.dtype('<i8')),
+                     np.arange(5, dtype=np.dtype('>i8')),
+                     np.arange(5, dtype=np.dtype('<f8')),
+                     np.arange(5, dtype=np.dtype('>f8')),
+                     np.array([1, 'abc', {'a': 1, 'b': 2}], dtype='O'),
+                     np.arange(256, dtype=np.uint8).tobytes(),
+                     u"C'est l'\xe9t\xe9 !"]
+
+    fname = tmpdir.join('temp.pkl.gz').strpath
+
+    dumped_filenames = numpy_pickle.dump(expected_list, fname, compress=1)
+    assert len(dumped_filenames) == 1
+    result_list = numpy_pickle.load(fname)
+    for result, expected in zip(result_list, expected_list):
+        if isinstance(expected, np.ndarray):
+            expected = _ensure_native_byte_order(expected)
+            assert result.dtype == expected.dtype
+            np.testing.assert_equal(result, expected)
+        else:
+            assert result == expected
+
+
+def _check_pickle(filename, expected_list, mmap_mode=None):
+    """Helper function to test joblib pickle content.
+
+    Note: currently only pickles containing an iterable are supported
+    by this function.
+    """
+    version_match = re.match(r'.+py(\d)(\d).+', filename)
+    py_version_used_for_writing = int(version_match.group(1))
+
+    py_version_to_default_pickle_protocol = {2: 2, 3: 3}
+    pickle_reading_protocol = py_version_to_default_pickle_protocol.get(3, 4)
+    pickle_writing_protocol = py_version_to_default_pickle_protocol.get(
+        py_version_used_for_writing, 4)
+    if pickle_reading_protocol >= pickle_writing_protocol:
+        try:
+            with warnings.catch_warnings(record=True) as warninfo:
+                warnings.simplefilter('always')
+                warnings.filterwarnings(
+                    'ignore', module='numpy',
+                    message='The compiler package is deprecated')
+                result_list = numpy_pickle.load(filename, mmap_mode=mmap_mode)
+            filename_base = os.path.basename(filename)
+            expected_nb_deprecation_warnings = 1 if (
+                "_0.9" in filename_base or "_0.8.4" in filename_base) else 0
+
+            expected_nb_user_warnings = 3 if (
+                re.search("_0.1.+.pkl$", filename_base) and
+                mmap_mode is not None) else 0
+            expected_nb_warnings = \
+                expected_nb_deprecation_warnings + expected_nb_user_warnings
+            assert len(warninfo) == expected_nb_warnings
+
+            deprecation_warnings = [
+                w for w in warninfo if issubclass(
+                    w.category, DeprecationWarning)]
+            user_warnings = [
+                w for w in warninfo if issubclass(
+                    w.category, UserWarning)]
+            for w in deprecation_warnings:
+                assert (str(w.message) ==
+                        "The file '{0}' has been generated with a joblib "
+                        "version less than 0.10. Please regenerate this "
+                        "pickle file.".format(filename))
+
+            for w in user_warnings:
+                escaped_filename = re.escape(filename)
+                assert re.search(
+                    f"memmapped.+{escaped_filename}.+segmentation fault",
+                    str(w.message))
+
+            for result, expected in zip(result_list, expected_list):
+                if isinstance(expected, np.ndarray):
+                    expected = _ensure_native_byte_order(expected)
+                    assert result.dtype == expected.dtype
+                    np.testing.assert_equal(result, expected)
+                else:
+                    assert result == expected
+        except Exception as exc:
+            # When trying to read with python 3 a pickle generated
+            # with python 2 we expect a user-friendly error
+            if py_version_used_for_writing == 2:
+                assert isinstance(exc, ValueError)
+                message = ('You may be trying to read with '
+                           'python 3 a joblib pickle generated with python 2.')
+                assert message in str(exc)
+            elif filename.endswith('.lz4') and with_lz4.args[0]:
+                assert isinstance(exc, ValueError)
+                assert LZ4_NOT_INSTALLED_ERROR in str(exc)
+            else:
+                raise
+    else:
+        # Pickle protocol used for writing is too high. We expect a
+        # "unsupported pickle protocol" error message
+        try:
+            numpy_pickle.load(filename)
+            raise AssertionError('Numpy pickle loading should '
+                                 'have raised a ValueError exception')
+        except ValueError as e:
+            message = 'unsupported pickle protocol: {0}'.format(
+                pickle_writing_protocol)
+            assert message in str(e.args)
+
+
+@with_numpy
+def test_joblib_pickle_across_python_versions():
+    # We need to be specific about dtypes in particular endianness
+    # because the pickles can be generated on one architecture and
+    # the tests run on another one. See
+    # https://github.com/joblib/joblib/issues/279.
+    expected_list = [np.arange(5, dtype=np.dtype('<i8')),
+                     np.arange(5, dtype=np.dtype('<f8')),
+                     np.array([1, 'abc', {'a': 1, 'b': 2}], dtype='O'),
+                     np.arange(256, dtype=np.uint8).tobytes(),
+                     # np.matrix is a subclass of np.ndarray, here we want
+                     # to verify this type of object is correctly unpickled
+                     # among versions.
+                     np.matrix([0, 1, 2], dtype=np.dtype('<i8')),
+                     u"C'est l'\xe9t\xe9 !"]
+
+    # Testing all the compressed and non compressed
+    # pickles in joblib/test/data. These pickles were generated by
+    # the joblib/test/data/create_numpy_pickle.py script for the
+    # relevant python, joblib and numpy versions.
+    test_data_dir = os.path.dirname(os.path.abspath(data.__file__))
+
+    pickle_extensions = ('.pkl', '.gz', '.gzip', '.bz2', 'lz4')
+    if lzma is not None:
+        pickle_extensions += ('.xz', '.lzma')
+    pickle_filenames = [os.path.join(test_data_dir, fn)
+                        for fn in os.listdir(test_data_dir)
+                        if any(fn.endswith(ext) for ext in pickle_extensions)]
+
+    for fname in pickle_filenames:
+        _check_pickle(fname, expected_list)
+
+
+@with_numpy
+def test_joblib_pickle_across_python_versions_with_mmap():
+    expected_list = [np.arange(5, dtype=np.dtype('<i8')),
+                     np.arange(5, dtype=np.dtype('<f8')),
+                     np.array([1, 'abc', {'a': 1, 'b': 2}], dtype='O'),
+                     np.arange(256, dtype=np.uint8).tobytes(),
+                     # np.matrix is a subclass of np.ndarray, here we want
+                     # to verify this type of object is correctly unpickled
+                     # among versions.
+                     np.matrix([0, 1, 2], dtype=np.dtype('<i8')),
+                     u"C'est l'\xe9t\xe9 !"]
+
+    test_data_dir = os.path.dirname(os.path.abspath(data.__file__))
+
+    pickle_filenames = [
+        os.path.join(test_data_dir, fn)
+        for fn in os.listdir(test_data_dir) if fn.endswith('.pkl')]
+    for fname in pickle_filenames:
+        _check_pickle(fname, expected_list, mmap_mode='r')
+
+
+@with_numpy
+def test_numpy_array_byte_order_mismatch_detection():
+    # List of numpy arrays with big endian byteorder.
+    be_arrays = [np.array([(1, 2.0), (3, 4.0)],
+                          dtype=[('', '>i8'), ('', '>f8')]),
+                 np.arange(3, dtype=np.dtype('>i8')),
+                 np.arange(3, dtype=np.dtype('>f8'))]
+
+    # Verify the byteorder mismatch is correctly detected.
+    for array in be_arrays:
+        if sys.byteorder == 'big':
+            assert not _is_numpy_array_byte_order_mismatch(array)
+        else:
+            assert _is_numpy_array_byte_order_mismatch(array)
+        converted = _ensure_native_byte_order(array)
+        if converted.dtype.fields:
+            for f in converted.dtype.fields.values():
+                f[0].byteorder == '='
+        else:
+            assert converted.dtype.byteorder == "="
+
+    # List of numpy arrays with little endian byteorder.
+    le_arrays = [np.array([(1, 2.0), (3, 4.0)],
+                          dtype=[('', '<i8'), ('', '<f8')]),
+                 np.arange(3, dtype=np.dtype('<i8')),
+                 np.arange(3, dtype=np.dtype('<f8'))]
+
+    # Verify the byteorder mismatch is correctly detected.
+    for array in le_arrays:
+        if sys.byteorder == 'little':
+            assert not _is_numpy_array_byte_order_mismatch(array)
+        else:
+            assert _is_numpy_array_byte_order_mismatch(array)
+        converted = _ensure_native_byte_order(array)
+        if converted.dtype.fields:
+            for f in converted.dtype.fields.values():
+                f[0].byteorder == '='
+        else:
+            assert converted.dtype.byteorder == "="
+
+
+@parametrize('compress_tuple', [('zlib', 3), ('gzip', 3)])
+def test_compress_tuple_argument(tmpdir, compress_tuple):
+    # Verify the tuple is correctly taken into account.
+    filename = tmpdir.join('test.pkl').strpath
+    numpy_pickle.dump("dummy", filename,
+                      compress=compress_tuple)
+    # Verify the file contains the right magic number
+    with open(filename, 'rb') as f:
+        assert _detect_compressor(f) == compress_tuple[0]
+
+
+@parametrize('compress_tuple,message',
+             [(('zlib', 3, 'extra'),        # wrong compress tuple
+               'Compress argument tuple should contain exactly 2 elements'),
+              (('wrong', 3),                # wrong compress method
+               'Non valid compression method given: "{}"'.format('wrong')),
+              (('zlib', 'wrong'),           # wrong compress level
+               'Non valid compress level given: "{}"'.format('wrong'))])
+def test_compress_tuple_argument_exception(tmpdir, compress_tuple, message):
+    filename = tmpdir.join('test.pkl').strpath
+    # Verify setting a wrong compress tuple raises a ValueError.
+    with raises(ValueError) as excinfo:
+        numpy_pickle.dump('dummy', filename, compress=compress_tuple)
+    excinfo.match(message)
+
+
+@parametrize('compress_string', ['zlib', 'gzip'])
+def test_compress_string_argument(tmpdir, compress_string):
+    # Verify the string is correctly taken into account.
+    filename = tmpdir.join('test.pkl').strpath
+    numpy_pickle.dump("dummy", filename,
+                      compress=compress_string)
+    # Verify the file contains the right magic number
+    with open(filename, 'rb') as f:
+        assert _detect_compressor(f) == compress_string
+
+
+@with_numpy
+@parametrize('compress', [1, 3, 6])
+@parametrize('cmethod', _COMPRESSORS)
+def test_joblib_compression_formats(tmpdir, compress, cmethod):
+    filename = tmpdir.join('test.pkl').strpath
+    objects = (np.ones(shape=(100, 100), dtype='f8'),
+               range(10),
+               {'a': 1, 2: 'b'}, [], (), {}, 0, 1.0)
+
+    if cmethod in ("lzma", "xz") and lzma is None:
+        pytest.skip("lzma is support not available")
+
+    elif cmethod == 'lz4' and with_lz4.args[0]:
+        # Skip the test if lz4 is not installed. We here use the with_lz4
+        # skipif fixture whose argument is True when lz4 is not installed
+        pytest.skip("lz4 is not installed.")
+
+    dump_filename = filename + "." + cmethod
+    for obj in objects:
+        numpy_pickle.dump(obj, dump_filename, compress=(cmethod, compress))
+        # Verify the file contains the right magic number
+        with open(dump_filename, 'rb') as f:
+            assert _detect_compressor(f) == cmethod
+        # Verify the reloaded object is correct
+        obj_reloaded = numpy_pickle.load(dump_filename)
+        assert isinstance(obj_reloaded, type(obj))
+        if isinstance(obj, np.ndarray):
+            np.testing.assert_array_equal(obj_reloaded, obj)
+        else:
+            assert obj_reloaded == obj
+
+
+def _gzip_file_decompress(source_filename, target_filename):
+    """Decompress a gzip file."""
+    with closing(gzip.GzipFile(source_filename, "rb")) as fo:
+        buf = fo.read()
+
+    with open(target_filename, "wb") as fo:
+        fo.write(buf)
+
+
+def _zlib_file_decompress(source_filename, target_filename):
+    """Decompress a zlib file."""
+    with open(source_filename, 'rb') as fo:
+        buf = zlib.decompress(fo.read())
+
+    with open(target_filename, 'wb') as fo:
+        fo.write(buf)
+
+
+@parametrize('extension,decompress',
+             [('.z', _zlib_file_decompress),
+              ('.gz', _gzip_file_decompress)])
+def test_load_externally_decompressed_files(tmpdir, extension, decompress):
+    # Test that BinaryZlibFile generates valid gzip and zlib compressed files.
+    obj = "a string to persist"
+    filename_raw = tmpdir.join('test.pkl').strpath
+
+    filename_compressed = filename_raw + extension
+    # Use automatic extension detection to compress with the right method.
+    numpy_pickle.dump(obj, filename_compressed)
+
+    # Decompress with the corresponding method
+    decompress(filename_compressed, filename_raw)
+
+    # Test that the uncompressed pickle can be loaded and
+    # that the result is correct.
+    obj_reloaded = numpy_pickle.load(filename_raw)
+    assert obj == obj_reloaded
+
+
+@parametrize('extension,cmethod',
+             # valid compressor extensions
+             [('.z', 'zlib'),
+              ('.gz', 'gzip'),
+              ('.bz2', 'bz2'),
+              ('.lzma', 'lzma'),
+              ('.xz', 'xz'),
+              # invalid compressor extensions
+              ('.pkl', 'not-compressed'),
+              ('', 'not-compressed')])
+def test_compression_using_file_extension(tmpdir, extension, cmethod):
+    if cmethod in ("lzma", "xz") and lzma is None:
+        pytest.skip("lzma is missing")
+    # test that compression method corresponds to the given filename extension.
+    filename = tmpdir.join('test.pkl').strpath
+    obj = "object to dump"
+
+    dump_fname = filename + extension
+    numpy_pickle.dump(obj, dump_fname)
+    # Verify the file contains the right magic number
+    with open(dump_fname, 'rb') as f:
+        assert _detect_compressor(f) == cmethod
+    # Verify the reloaded object is correct
+    obj_reloaded = numpy_pickle.load(dump_fname)
+    assert isinstance(obj_reloaded, type(obj))
+    assert obj_reloaded == obj
+
+
+@with_numpy
+def test_file_handle_persistence(tmpdir):
+    objs = [np.random.random((10, 10)), "some data"]
+    fobjs = [bz2.BZ2File, gzip.GzipFile]
+    if lzma is not None:
+        fobjs += [lzma.LZMAFile]
+    filename = tmpdir.join('test.pkl').strpath
+
+    for obj in objs:
+        for fobj in fobjs:
+            with fobj(filename, 'wb') as f:
+                numpy_pickle.dump(obj, f)
+
+            # using the same decompressor prevents from internally
+            # decompress again.
+            with fobj(filename, 'rb') as f:
+                obj_reloaded = numpy_pickle.load(f)
+
+            # when needed, the correct decompressor should be used when
+            # passing a raw file handle.
+            with open(filename, 'rb') as f:
+                obj_reloaded_2 = numpy_pickle.load(f)
+
+            if isinstance(obj, np.ndarray):
+                np.testing.assert_array_equal(obj_reloaded, obj)
+                np.testing.assert_array_equal(obj_reloaded_2, obj)
+            else:
+                assert obj_reloaded == obj
+                assert obj_reloaded_2 == obj
+
+
+@with_numpy
+def test_in_memory_persistence():
+    objs = [np.random.random((10, 10)), "some data"]
+    for obj in objs:
+        f = io.BytesIO()
+        numpy_pickle.dump(obj, f)
+        obj_reloaded = numpy_pickle.load(f)
+        if isinstance(obj, np.ndarray):
+            np.testing.assert_array_equal(obj_reloaded, obj)
+        else:
+            assert obj_reloaded == obj
+
+
+@with_numpy
+def test_file_handle_persistence_mmap(tmpdir):
+    obj = np.random.random((10, 10))
+    filename = tmpdir.join('test.pkl').strpath
+
+    with open(filename, 'wb') as f:
+        numpy_pickle.dump(obj, f)
+
+    with open(filename, 'rb') as f:
+        obj_reloaded = numpy_pickle.load(f, mmap_mode='r+')
+
+    np.testing.assert_array_equal(obj_reloaded, obj)
+
+
+@with_numpy
+def test_file_handle_persistence_compressed_mmap(tmpdir):
+    obj = np.random.random((10, 10))
+    filename = tmpdir.join('test.pkl').strpath
+
+    with open(filename, 'wb') as f:
+        numpy_pickle.dump(obj, f, compress=('gzip', 3))
+
+    with closing(gzip.GzipFile(filename, 'rb')) as f:
+        with warns(UserWarning) as warninfo:
+            numpy_pickle.load(f, mmap_mode='r+')
+        assert len(warninfo) == 1
+        assert (str(warninfo[0].message) ==
+                '"%(fileobj)r" is not a raw file, mmap_mode "%(mmap_mode)s" '
+                'flag will be ignored.' % {'fileobj': f, 'mmap_mode': 'r+'})
+
+
+@with_numpy
+def test_file_handle_persistence_in_memory_mmap():
+    obj = np.random.random((10, 10))
+    buf = io.BytesIO()
+
+    numpy_pickle.dump(obj, buf)
+
+    with warns(UserWarning) as warninfo:
+        numpy_pickle.load(buf, mmap_mode='r+')
+    assert len(warninfo) == 1
+    assert (str(warninfo[0].message) ==
+            'In memory persistence is not compatible with mmap_mode '
+            '"%(mmap_mode)s" flag passed. mmap_mode option will be '
+            'ignored.' % {'mmap_mode': 'r+'})
+
+
+@parametrize('data', [b'a little data as bytes.',
+                      # More bytes
+                      10000 * "{}".format(
+                          random.randint(0, 1000) * 1000).encode('latin-1')],
+             ids=["a little data as bytes.", "a large data as bytes."])
+@parametrize('compress_level', [1, 3, 9])
+def test_binary_zlibfile(tmpdir, data, compress_level):
+    filename = tmpdir.join('test.pkl').strpath
+    # Regular cases
+    with open(filename, 'wb') as f:
+        with BinaryZlibFile(f, 'wb',
+                            compresslevel=compress_level) as fz:
+            assert fz.writable()
+            fz.write(data)
+            assert fz.fileno() == f.fileno()
+            with raises(io.UnsupportedOperation):
+                fz._check_can_read()
+
+            with raises(io.UnsupportedOperation):
+                fz._check_can_seek()
+        assert fz.closed
+        with raises(ValueError):
+            fz._check_not_closed()
+
+    with open(filename, 'rb') as f:
+        with BinaryZlibFile(f) as fz:
+            assert fz.readable()
+            assert fz.seekable()
+            assert fz.fileno() == f.fileno()
+            assert fz.read() == data
+            with raises(io.UnsupportedOperation):
+                fz._check_can_write()
+            assert fz.seekable()
+            fz.seek(0)
+            assert fz.tell() == 0
+        assert fz.closed
+
+    # Test with a filename as input
+    with BinaryZlibFile(filename, 'wb',
+                        compresslevel=compress_level) as fz:
+        assert fz.writable()
+        fz.write(data)
+
+    with BinaryZlibFile(filename, 'rb') as fz:
+        assert fz.read() == data
+        assert fz.seekable()
+
+    # Test without context manager
+    fz = BinaryZlibFile(filename, 'wb', compresslevel=compress_level)
+    assert fz.writable()
+    fz.write(data)
+    fz.close()
+
+    fz = BinaryZlibFile(filename, 'rb')
+    assert fz.read() == data
+    fz.close()
+
+
+@parametrize('bad_value', [-1, 10, 15, 'a', (), {}])
+def test_binary_zlibfile_bad_compression_levels(tmpdir, bad_value):
+    filename = tmpdir.join('test.pkl').strpath
+    with raises(ValueError) as excinfo:
+        BinaryZlibFile(filename, 'wb', compresslevel=bad_value)
+    pattern = re.escape("'compresslevel' must be an integer between 1 and 9. "
+                        "You provided 'compresslevel={}'".format(bad_value))
+    excinfo.match(pattern)
+
+
+@parametrize('bad_mode', ['a', 'x', 'r', 'w', 1, 2])
+def test_binary_zlibfile_invalid_modes(tmpdir, bad_mode):
+    filename = tmpdir.join('test.pkl').strpath
+    with raises(ValueError) as excinfo:
+        BinaryZlibFile(filename, bad_mode)
+    excinfo.match("Invalid mode")
+
+
+@parametrize('bad_file', [1, (), {}])
+def test_binary_zlibfile_invalid_filename_type(bad_file):
+    with raises(TypeError) as excinfo:
+        BinaryZlibFile(bad_file, 'rb')
+    excinfo.match("filename must be a str or bytes object, or a file")
+
+
+###############################################################################
+# Test dumping array subclasses
+if np is not None:
+
+    class SubArray(np.ndarray):
+
+        def __reduce__(self):
+            return _load_sub_array, (np.asarray(self), )
+
+    def _load_sub_array(arr):
+        d = SubArray(arr.shape)
+        d[:] = arr
+        return d
+
+    class ComplexTestObject:
+        """A complex object containing numpy arrays as attributes."""
+
+        def __init__(self):
+            self.array_float = np.arange(100, dtype='float64')
+            self.array_int = np.ones(100, dtype='int32')
+            self.array_obj = np.array(['a', 10, 20.0], dtype='object')
+
+
+@with_numpy
+def test_numpy_subclass(tmpdir):
+    filename = tmpdir.join('test.pkl').strpath
+    a = SubArray((10,))
+    numpy_pickle.dump(a, filename)
+    c = numpy_pickle.load(filename)
+    assert isinstance(c, SubArray)
+    np.testing.assert_array_equal(c, a)
+
+
+def test_pathlib(tmpdir):
+    filename = tmpdir.join('test.pkl').strpath
+    value = 123
+    numpy_pickle.dump(value, Path(filename))
+    assert numpy_pickle.load(filename) == value
+    numpy_pickle.dump(value, filename)
+    assert numpy_pickle.load(Path(filename)) == value
+
+
+@with_numpy
+def test_non_contiguous_array_pickling(tmpdir):
+    filename = tmpdir.join('test.pkl').strpath
+
+    for array in [  # Array that triggers a contiguousness issue with nditer,
+                    # see https://github.com/joblib/joblib/pull/352 and see
+                    # https://github.com/joblib/joblib/pull/353
+                    np.asfortranarray([[1, 2], [3, 4]])[1:],
+                    # Non contiguous array with works fine with nditer
+                    np.ones((10, 50, 20), order='F')[:, :1, :]]:
+        assert not array.flags.c_contiguous
+        assert not array.flags.f_contiguous
+        numpy_pickle.dump(array, filename)
+        array_reloaded = numpy_pickle.load(filename)
+        np.testing.assert_array_equal(array_reloaded, array)
+
+
+@with_numpy
+def test_pickle_highest_protocol(tmpdir):
+    # ensure persistence of a numpy array is valid even when using
+    # the pickle HIGHEST_PROTOCOL.
+    # see https://github.com/joblib/joblib/issues/362
+
+    filename = tmpdir.join('test.pkl').strpath
+    test_array = np.zeros(10)
+
+    numpy_pickle.dump(test_array, filename, protocol=pickle.HIGHEST_PROTOCOL)
+    array_reloaded = numpy_pickle.load(filename)
+
+    np.testing.assert_array_equal(array_reloaded, test_array)
+
+
+@with_numpy
+def test_pickle_in_socket():
+    # test that joblib can pickle in sockets
+    test_array = np.arange(10)
+    _ADDR = ("localhost", 12345)
+    listener = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    listener.bind(_ADDR)
+    listener.listen(1)
+
+    with socket.create_connection(_ADDR) as client:
+        server, client_addr = listener.accept()
+
+        with server.makefile("wb") as sf:
+            numpy_pickle.dump(test_array, sf)
+
+        with client.makefile("rb") as cf:
+            array_reloaded = numpy_pickle.load(cf)
+
+        np.testing.assert_array_equal(array_reloaded, test_array)
+
+        # Check that a byte-aligned numpy array written in a file can be send
+        # over a socket and then read on the other side
+        bytes_to_send = io.BytesIO()
+        numpy_pickle.dump(test_array, bytes_to_send)
+        server.send(bytes_to_send.getvalue())
+
+        with client.makefile("rb") as cf:
+            array_reloaded = numpy_pickle.load(cf)
+
+        np.testing.assert_array_equal(array_reloaded, test_array)
+
+
+@with_numpy
+def test_load_memmap_with_big_offset(tmpdir):
+    # Test that numpy memmap offset is set correctly if greater than
+    # mmap.ALLOCATIONGRANULARITY, see
+    # https://github.com/joblib/joblib/issues/451 and
+    # https://github.com/numpy/numpy/pull/8443 for more details.
+    fname = tmpdir.join('test.mmap').strpath
+    size = mmap.ALLOCATIONGRANULARITY
+    obj = [np.zeros(size, dtype='uint8'), np.ones(size, dtype='uint8')]
+    numpy_pickle.dump(obj, fname)
+    memmaps = numpy_pickle.load(fname, mmap_mode='r')
+    assert isinstance(memmaps[1], np.memmap)
+    assert memmaps[1].offset > size
+    np.testing.assert_array_equal(obj, memmaps)
+
+
+def test_register_compressor(tmpdir):
+    # Check that registering compressor file works.
+    compressor_name = 'test-name'
+    compressor_prefix = 'test-prefix'
+
+    class BinaryCompressorTestFile(io.BufferedIOBase):
+        pass
+
+    class BinaryCompressorTestWrapper(CompressorWrapper):
+
+        def __init__(self):
+            CompressorWrapper.__init__(self, obj=BinaryCompressorTestFile,
+                                       prefix=compressor_prefix)
+
+    register_compressor(compressor_name, BinaryCompressorTestWrapper())
+
+    assert (_COMPRESSORS[compressor_name].fileobj_factory ==
+            BinaryCompressorTestFile)
+    assert _COMPRESSORS[compressor_name].prefix == compressor_prefix
+
+    # Remove this dummy compressor file from extra compressors because other
+    # tests might fail because of this
+    _COMPRESSORS.pop(compressor_name)
+
+
+@parametrize('invalid_name', [1, (), {}])
+def test_register_compressor_invalid_name(invalid_name):
+    # Test that registering an invalid compressor name is not allowed.
+    with raises(ValueError) as excinfo:
+        register_compressor(invalid_name, None)
+    excinfo.match("Compressor name should be a string")
+
+
+def test_register_compressor_invalid_fileobj():
+    # Test that registering an invalid file object is not allowed.
+
+    class InvalidFileObject():
+        pass
+
+    class InvalidFileObjectWrapper(CompressorWrapper):
+        def __init__(self):
+            CompressorWrapper.__init__(self, obj=InvalidFileObject,
+                                       prefix=b'prefix')
+
+    with raises(ValueError) as excinfo:
+        register_compressor('invalid', InvalidFileObjectWrapper())
+
+    excinfo.match("Compressor 'fileobj_factory' attribute should implement "
+                  "the file object interface")
+
+
+class AnotherZlibCompressorWrapper(CompressorWrapper):
+
+    def __init__(self):
+        CompressorWrapper.__init__(self, obj=BinaryZlibFile, prefix=b'prefix')
+
+
+class StandardLibGzipCompressorWrapper(CompressorWrapper):
+
+    def __init__(self):
+        CompressorWrapper.__init__(self, obj=gzip.GzipFile, prefix=b'prefix')
+
+
+def test_register_compressor_already_registered():
+    # Test registration of existing compressor files.
+    compressor_name = 'test-name'
+
+    # register a test compressor
+    register_compressor(compressor_name, AnotherZlibCompressorWrapper())
+
+    with raises(ValueError) as excinfo:
+        register_compressor(compressor_name,
+                            StandardLibGzipCompressorWrapper())
+    excinfo.match("Compressor '{}' already registered."
+                  .format(compressor_name))
+
+    register_compressor(compressor_name, StandardLibGzipCompressorWrapper(),
+                        force=True)
+
+    assert compressor_name in _COMPRESSORS
+    assert _COMPRESSORS[compressor_name].fileobj_factory == gzip.GzipFile
+
+    # Remove this dummy compressor file from extra compressors because other
+    # tests might fail because of this
+    _COMPRESSORS.pop(compressor_name)
+
+
+@with_lz4
+def test_lz4_compression(tmpdir):
+    # Check that lz4 can be used when dependency is available.
+    import lz4.frame
+    compressor = 'lz4'
+    assert compressor in _COMPRESSORS
+    assert _COMPRESSORS[compressor].fileobj_factory == lz4.frame.LZ4FrameFile
+
+    fname = tmpdir.join('test.pkl').strpath
+    data = 'test data'
+    numpy_pickle.dump(data, fname, compress=compressor)
+
+    with open(fname, 'rb') as f:
+        assert f.read(len(_LZ4_PREFIX)) == _LZ4_PREFIX
+    assert numpy_pickle.load(fname) == data
+
+    # Test that LZ4 is applied based on file extension
+    numpy_pickle.dump(data, fname + '.lz4')
+    with open(fname, 'rb') as f:
+        assert f.read(len(_LZ4_PREFIX)) == _LZ4_PREFIX
+    assert numpy_pickle.load(fname) == data
+
+
+@without_lz4
+def test_lz4_compression_without_lz4(tmpdir):
+    # Check that lz4 cannot be used when dependency is not available.
+    fname = tmpdir.join('test.nolz4').strpath
+    data = 'test data'
+    msg = LZ4_NOT_INSTALLED_ERROR
+    with raises(ValueError) as excinfo:
+        numpy_pickle.dump(data, fname, compress='lz4')
+    excinfo.match(msg)
+
+    with raises(ValueError) as excinfo:
+        numpy_pickle.dump(data, fname + '.lz4')
+    excinfo.match(msg)
+
+
+protocols = [pickle.DEFAULT_PROTOCOL]
+if pickle.HIGHEST_PROTOCOL != pickle.DEFAULT_PROTOCOL:
+    protocols.append(pickle.HIGHEST_PROTOCOL)
+
+
+@with_numpy
+@parametrize('protocol', protocols)
+def test_memmap_alignment_padding(tmpdir, protocol):
+    # Test that memmaped arrays returned by numpy.load are correctly aligned
+    fname = tmpdir.join('test.mmap').strpath
+
+    a = np.random.randn(2)
+    numpy_pickle.dump(a, fname, protocol=protocol)
+    memmap = numpy_pickle.load(fname, mmap_mode='r')
+    assert isinstance(memmap, np.memmap)
+    np.testing.assert_array_equal(a, memmap)
+    assert (
+        memmap.ctypes.data % numpy_pickle.NUMPY_ARRAY_ALIGNMENT_BYTES == 0)
+    assert memmap.flags.aligned
+
+    array_list = [
+        np.random.randn(2), np.random.randn(2),
+        np.random.randn(2), np.random.randn(2)
+    ]
+
+    # On Windows OSError 22 if reusing the same path for memmap ...
+    fname = tmpdir.join('test1.mmap').strpath
+    numpy_pickle.dump(array_list, fname, protocol=protocol)
+    l_reloaded = numpy_pickle.load(fname, mmap_mode='r')
+
+    for idx, memmap in enumerate(l_reloaded):
+        assert isinstance(memmap, np.memmap)
+        np.testing.assert_array_equal(array_list[idx], memmap)
+        assert (
+            memmap.ctypes.data % numpy_pickle.NUMPY_ARRAY_ALIGNMENT_BYTES == 0)
+        assert memmap.flags.aligned
+
+    array_dict = {
+        'a0': np.arange(2, dtype=np.uint8),
+        'a1': np.arange(3, dtype=np.uint8),
+        'a2': np.arange(5, dtype=np.uint8),
+        'a3': np.arange(7, dtype=np.uint8),
+        'a4': np.arange(11, dtype=np.uint8),
+        'a5': np.arange(13, dtype=np.uint8),
+        'a6': np.arange(17, dtype=np.uint8),
+        'a7': np.arange(19, dtype=np.uint8),
+        'a8': np.arange(23, dtype=np.uint8),
+    }
+
+    # On Windows OSError 22 if reusing the same path for memmap ...
+    fname = tmpdir.join('test2.mmap').strpath
+    numpy_pickle.dump(array_dict, fname, protocol=protocol)
+    d_reloaded = numpy_pickle.load(fname, mmap_mode='r')
+
+    for key, memmap in d_reloaded.items():
+        assert isinstance(memmap, np.memmap)
+        np.testing.assert_array_equal(array_dict[key], memmap)
+        assert (
+            memmap.ctypes.data % numpy_pickle.NUMPY_ARRAY_ALIGNMENT_BYTES == 0)
+        assert memmap.flags.aligned
diff --git a/llm/Lib/site-packages/joblib/test/test_numpy_pickle_compat.py b/llm/Lib/site-packages/joblib/test/test_numpy_pickle_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..9e95393b19e979593c7037d0d4fb740e47131dde
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_numpy_pickle_compat.py
@@ -0,0 +1,16 @@
+"""Test the old numpy pickler, compatibility version."""
+
+# numpy_pickle is not a drop-in replacement of pickle, as it takes
+# filenames instead of open files as arguments.
+from joblib import numpy_pickle_compat
+
+
+def test_z_file(tmpdir):
+    # Test saving and loading data with Zfiles.
+    filename = tmpdir.join('test.pkl').strpath
+    data = numpy_pickle_compat.asbytes('Foo, \n Bar, baz, \n\nfoobar')
+    with open(filename, 'wb') as f:
+        numpy_pickle_compat.write_zfile(f, data)
+    with open(filename, 'rb') as f:
+        data_read = numpy_pickle_compat.read_zfile(f)
+    assert data == data_read
diff --git a/llm/Lib/site-packages/joblib/test/test_numpy_pickle_utils.py b/llm/Lib/site-packages/joblib/test/test_numpy_pickle_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..5c414a2227cbf6094dc594f6712139d4fd397a9d
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_numpy_pickle_utils.py
@@ -0,0 +1,9 @@
+from joblib.compressor import BinaryZlibFile
+from joblib.testing import parametrize
+
+
+@parametrize('filename', ['test', u'test'])  # testing str and unicode names
+def test_binary_zlib_file(tmpdir, filename):
+    """Testing creation of files depending on the type of the filenames."""
+    binary_file = BinaryZlibFile(tmpdir.join(filename).strpath, mode='wb')
+    binary_file.close()
diff --git a/llm/Lib/site-packages/joblib/test/test_parallel.py b/llm/Lib/site-packages/joblib/test/test_parallel.py
new file mode 100644
index 0000000000000000000000000000000000000000..21f06faa01c3ed93b80accad494e6a0482cc2e72
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_parallel.py
@@ -0,0 +1,2034 @@
+"""
+Test the parallel module.
+"""
+
+# Author: Gael Varoquaux <gael dot varoquaux at normalesup dot org>
+# Copyright (c) 2010-2011 Gael Varoquaux
+# License: BSD Style, 3 clauses.
+
+import os
+import sys
+import time
+import mmap
+import weakref
+import warnings
+import threading
+from traceback import format_exception
+from math import sqrt
+from time import sleep
+from pickle import PicklingError
+from contextlib import nullcontext
+from multiprocessing import TimeoutError
+import pytest
+
+import joblib
+from joblib import parallel
+from joblib import dump, load
+
+from joblib._multiprocessing_helpers import mp
+
+from joblib.test.common import np, with_numpy
+from joblib.test.common import with_multiprocessing
+from joblib.test.common import IS_PYPY, force_gc_pypy
+from joblib.testing import (parametrize, raises, check_subprocess_call,
+                            skipif, warns)
+
+if mp is not None:
+    # Loky is not available if multiprocessing is not
+    from joblib.externals.loky import get_reusable_executor
+
+from queue import Queue
+
+try:
+    import posix
+except ImportError:
+    posix = None
+
+try:
+    from ._openmp_test_helper.parallel_sum import parallel_sum
+except ImportError:
+    parallel_sum = None
+
+try:
+    import distributed
+except ImportError:
+    distributed = None
+
+from joblib._parallel_backends import SequentialBackend
+from joblib._parallel_backends import ThreadingBackend
+from joblib._parallel_backends import MultiprocessingBackend
+from joblib._parallel_backends import ParallelBackendBase
+from joblib._parallel_backends import LokyBackend
+
+from joblib.parallel import Parallel, delayed
+from joblib.parallel import parallel_config
+from joblib.parallel import parallel_backend
+from joblib.parallel import register_parallel_backend
+from joblib.parallel import effective_n_jobs, cpu_count
+
+from joblib.parallel import mp, BACKENDS, DEFAULT_BACKEND
+
+
+RETURN_GENERATOR_BACKENDS = BACKENDS.copy()
+RETURN_GENERATOR_BACKENDS.pop("multiprocessing", None)
+
+ALL_VALID_BACKENDS = [None] + sorted(BACKENDS.keys())
+# Add instances of backend classes deriving from ParallelBackendBase
+ALL_VALID_BACKENDS += [BACKENDS[backend_str]() for backend_str in BACKENDS]
+if mp is None:
+    PROCESS_BACKENDS = []
+else:
+    PROCESS_BACKENDS = ['multiprocessing', 'loky']
+PARALLEL_BACKENDS = PROCESS_BACKENDS + ['threading']
+
+if hasattr(mp, 'get_context'):
+    # Custom multiprocessing context in Python 3.4+
+    ALL_VALID_BACKENDS.append(mp.get_context('spawn'))
+
+DefaultBackend = BACKENDS[DEFAULT_BACKEND]
+
+
+def get_workers(backend):
+    return getattr(backend, '_pool', getattr(backend, '_workers', None))
+
+
+def division(x, y):
+    return x / y
+
+
+def square(x):
+    return x ** 2
+
+
+class MyExceptionWithFinickyInit(Exception):
+    """An exception class with non trivial __init__
+    """
+    def __init__(self, a, b, c, d):
+        pass
+
+
+def exception_raiser(x, custom_exception=False):
+    if x == 7:
+        raise (MyExceptionWithFinickyInit('a', 'b', 'c', 'd')
+               if custom_exception else ValueError)
+    return x
+
+
+def interrupt_raiser(x):
+    time.sleep(.05)
+    raise KeyboardInterrupt
+
+
+def f(x, y=0, z=0):
+    """ A module-level function so that it can be spawn with
+    multiprocessing.
+    """
+    return x ** 2 + y + z
+
+
+def _active_backend_type():
+    return type(parallel.get_active_backend()[0])
+
+
+def parallel_func(inner_n_jobs, backend):
+    return Parallel(n_jobs=inner_n_jobs, backend=backend)(
+        delayed(square)(i) for i in range(3))
+
+
+###############################################################################
+def test_cpu_count():
+    assert cpu_count() > 0
+
+
+def test_effective_n_jobs():
+    assert effective_n_jobs() > 0
+
+
+@parametrize("context", [parallel_config, parallel_backend])
+@pytest.mark.parametrize(
+    "backend_n_jobs, expected_n_jobs",
+    [(3, 3), (-1, effective_n_jobs(n_jobs=-1)), (None, 1)],
+    ids=["positive-int", "negative-int", "None"]
+)
+@with_multiprocessing
+def test_effective_n_jobs_None(context, backend_n_jobs, expected_n_jobs):
+    # check the number of effective jobs when `n_jobs=None`
+    # non-regression test for https://github.com/joblib/joblib/issues/984
+    with context("threading", n_jobs=backend_n_jobs):
+        # when using a backend, the default of number jobs will be the one set
+        # in the backend
+        assert effective_n_jobs(n_jobs=None) == expected_n_jobs
+    # without any backend, None will default to a single job
+    assert effective_n_jobs(n_jobs=None) == 1
+
+
+###############################################################################
+# Test parallel
+
+@parametrize('backend', ALL_VALID_BACKENDS)
+@parametrize('n_jobs', [1, 2, -1, -2])
+@parametrize('verbose', [2, 11, 100])
+def test_simple_parallel(backend, n_jobs, verbose):
+    assert ([square(x) for x in range(5)] ==
+            Parallel(n_jobs=n_jobs, backend=backend,
+                     verbose=verbose)(
+                delayed(square)(x) for x in range(5)))
+
+
+@parametrize('backend', ALL_VALID_BACKENDS)
+def test_main_thread_renamed_no_warning(backend, monkeypatch):
+    # Check that no default backend relies on the name of the main thread:
+    # https://github.com/joblib/joblib/issues/180#issuecomment-253266247
+    # Some programs use a different name for the main thread. This is the case
+    # for uWSGI apps for instance.
+    monkeypatch.setattr(target=threading.current_thread(), name='name',
+                        value='some_new_name_for_the_main_thread')
+
+    with warnings.catch_warnings(record=True) as warninfo:
+        results = Parallel(n_jobs=2, backend=backend)(
+            delayed(square)(x) for x in range(3))
+        assert results == [0, 1, 4]
+
+    # Due to the default parameters of LokyBackend, there is a chance that
+    # warninfo catches Warnings from worker timeouts. We remove it if it exists
+    warninfo = [w for w in warninfo if "worker timeout" not in str(w.message)]
+
+    # The multiprocessing backend will raise a warning when detecting that is
+    # started from the non-main thread. Let's check that there is no false
+    # positive because of the name change.
+    assert len(warninfo) == 0
+
+
+def _assert_warning_nested(backend, inner_n_jobs, expected):
+    with warnings.catch_warnings(record=True) as warninfo:
+        warnings.simplefilter("always")
+        parallel_func(backend=backend, inner_n_jobs=inner_n_jobs)
+
+    warninfo = [w.message for w in warninfo]
+    if expected:
+        if warninfo:
+            warnings_are_correct = all(
+                'backed parallel loops cannot' in each.args[0]
+                for each in warninfo
+            )
+            # With Python nogil, when the outer backend is threading, we might
+            # see more that one warning
+            warnings_have_the_right_length = (
+                len(warninfo) >= 1 if getattr(sys.flags, 'nogil', False)
+                else len(warninfo) == 1)
+            return warnings_are_correct and warnings_have_the_right_length
+
+        return False
+    else:
+        assert not warninfo
+        return True
+
+
+@with_multiprocessing
+@parametrize('parent_backend,child_backend,expected', [
+    ('loky', 'multiprocessing', True),
+    ('loky', 'loky', False),
+    ('multiprocessing', 'multiprocessing', True),
+    ('multiprocessing', 'loky', True),
+    ('threading', 'multiprocessing', True),
+    ('threading', 'loky', True),
+])
+def test_nested_parallel_warnings(parent_backend, child_backend, expected):
+
+    # no warnings if inner_n_jobs=1
+    Parallel(n_jobs=2, backend=parent_backend)(
+        delayed(_assert_warning_nested)(
+            backend=child_backend, inner_n_jobs=1,
+            expected=False)
+        for _ in range(5))
+
+    #  warnings if inner_n_jobs != 1 and expected
+    res = Parallel(n_jobs=2, backend=parent_backend)(
+        delayed(_assert_warning_nested)(
+            backend=child_backend, inner_n_jobs=2,
+            expected=expected)
+        for _ in range(5))
+
+    # warning handling is not thread safe. One thread might see multiple
+    # warning or no warning at all.
+    if parent_backend == "threading":
+        if IS_PYPY and not any(res):
+            # Related to joblib#1426, should be removed once it is solved.
+            pytest.xfail(reason="This test often fails in PyPy.")
+        assert any(res)
+    else:
+        assert all(res)
+
+
+@with_multiprocessing
+@parametrize('backend', ['loky', 'multiprocessing', 'threading'])
+def test_background_thread_parallelism(backend):
+    is_run_parallel = [False]
+
+    def background_thread(is_run_parallel):
+        with warnings.catch_warnings(record=True) as warninfo:
+            Parallel(n_jobs=2)(
+                delayed(sleep)(.1) for _ in range(4))
+        print(len(warninfo))
+        is_run_parallel[0] = len(warninfo) == 0
+
+    t = threading.Thread(target=background_thread, args=(is_run_parallel,))
+    t.start()
+    t.join()
+    assert is_run_parallel[0]
+
+
+def nested_loop(backend):
+    Parallel(n_jobs=2, backend=backend)(
+        delayed(square)(.01) for _ in range(2))
+
+
+@parametrize('child_backend', BACKENDS)
+@parametrize('parent_backend', BACKENDS)
+def test_nested_loop(parent_backend, child_backend):
+    Parallel(n_jobs=2, backend=parent_backend)(
+        delayed(nested_loop)(child_backend) for _ in range(2))
+
+
+def raise_exception(backend):
+    raise ValueError
+
+
+@with_multiprocessing
+def test_nested_loop_with_exception_with_loky():
+    with raises(ValueError):
+        with Parallel(n_jobs=2, backend="loky") as parallel:
+            parallel([delayed(nested_loop)("loky"),
+                      delayed(raise_exception)("loky")])
+
+
+def test_mutate_input_with_threads():
+    """Input is mutable when using the threading backend"""
+    q = Queue(maxsize=5)
+    Parallel(n_jobs=2, backend="threading")(
+        delayed(q.put)(1) for _ in range(5))
+    assert q.full()
+
+
+@parametrize('n_jobs', [1, 2, 3])
+def test_parallel_kwargs(n_jobs):
+    """Check the keyword argument processing of pmap."""
+    lst = range(10)
+    assert ([f(x, y=1) for x in lst] ==
+            Parallel(n_jobs=n_jobs)(delayed(f)(x, y=1) for x in lst))
+
+
+@parametrize('backend', PARALLEL_BACKENDS)
+def test_parallel_as_context_manager(backend):
+    lst = range(10)
+    expected = [f(x, y=1) for x in lst]
+
+    with Parallel(n_jobs=4, backend=backend) as p:
+        # Internally a pool instance has been eagerly created and is managed
+        # via the context manager protocol
+        managed_backend = p._backend
+
+        # We make call with the managed parallel object several times inside
+        # the managed block:
+        assert expected == p(delayed(f)(x, y=1) for x in lst)
+        assert expected == p(delayed(f)(x, y=1) for x in lst)
+
+        # Those calls have all used the same pool instance:
+        if mp is not None:
+            assert get_workers(managed_backend) is get_workers(p._backend)
+
+    # As soon as we exit the context manager block, the pool is terminated and
+    # no longer referenced from the parallel object:
+    if mp is not None:
+        assert get_workers(p._backend) is None
+
+    # It's still possible to use the parallel instance in non-managed mode:
+    assert expected == p(delayed(f)(x, y=1) for x in lst)
+    if mp is not None:
+        assert get_workers(p._backend) is None
+
+
+@with_multiprocessing
+def test_parallel_pickling():
+    """ Check that pmap captures the errors when it is passed an object
+        that cannot be pickled.
+    """
+    class UnpicklableObject(object):
+        def __reduce__(self):
+            raise RuntimeError('123')
+
+    with raises(PicklingError, match=r"the task to send"):
+        Parallel(n_jobs=2, backend='loky')(delayed(id)(
+            UnpicklableObject()) for _ in range(10))
+
+
+@parametrize('backend', PARALLEL_BACKENDS)
+def test_parallel_timeout_success(backend):
+    # Check that timeout isn't thrown when function is fast enough
+    assert len(Parallel(n_jobs=2, backend=backend, timeout=30)(
+        delayed(sleep)(0.001) for x in range(10))) == 10
+
+
+@with_multiprocessing
+@parametrize('backend', PARALLEL_BACKENDS)
+def test_parallel_timeout_fail(backend):
+    # Check that timeout properly fails when function is too slow
+    with raises(TimeoutError):
+        Parallel(n_jobs=2, backend=backend, timeout=0.01)(
+            delayed(sleep)(10) for x in range(10))
+
+
+@with_multiprocessing
+@parametrize('backend', PROCESS_BACKENDS)
+def test_error_capture(backend):
+    # Check that error are captured, and that correct exceptions
+    # are raised.
+    if mp is not None:
+        with raises(ZeroDivisionError):
+            Parallel(n_jobs=2, backend=backend)(
+                [delayed(division)(x, y)
+                    for x, y in zip((0, 1), (1, 0))])
+
+        with raises(KeyboardInterrupt):
+            Parallel(n_jobs=2, backend=backend)(
+                [delayed(interrupt_raiser)(x) for x in (1, 0)])
+
+        # Try again with the context manager API
+        with Parallel(n_jobs=2, backend=backend) as parallel:
+            assert get_workers(parallel._backend) is not None
+            original_workers = get_workers(parallel._backend)
+
+            with raises(ZeroDivisionError):
+                parallel([delayed(division)(x, y)
+                          for x, y in zip((0, 1), (1, 0))])
+
+            # The managed pool should still be available and be in a working
+            # state despite the previously raised (and caught) exception
+            assert get_workers(parallel._backend) is not None
+
+            # The pool should have been interrupted and restarted:
+            assert get_workers(parallel._backend) is not original_workers
+
+            assert ([f(x, y=1) for x in range(10)] ==
+                    parallel(delayed(f)(x, y=1) for x in range(10)))
+
+            original_workers = get_workers(parallel._backend)
+            with raises(KeyboardInterrupt):
+                parallel([delayed(interrupt_raiser)(x) for x in (1, 0)])
+
+            # The pool should still be available despite the exception
+            assert get_workers(parallel._backend) is not None
+
+            # The pool should have been interrupted and restarted:
+            assert get_workers(parallel._backend) is not original_workers
+
+            assert ([f(x, y=1) for x in range(10)] ==
+                    parallel(delayed(f)(x, y=1) for x in range(10))), (
+                parallel._iterating, parallel.n_completed_tasks,
+                parallel.n_dispatched_tasks, parallel._aborting
+            )
+
+        # Check that the inner pool has been terminated when exiting the
+        # context manager
+        assert get_workers(parallel._backend) is None
+    else:
+        with raises(KeyboardInterrupt):
+            Parallel(n_jobs=2)(
+                [delayed(interrupt_raiser)(x) for x in (1, 0)])
+
+    # wrapped exceptions should inherit from the class of the original
+    # exception to make it easy to catch them
+    with raises(ZeroDivisionError):
+        Parallel(n_jobs=2)(
+            [delayed(division)(x, y) for x, y in zip((0, 1), (1, 0))])
+
+    with raises(MyExceptionWithFinickyInit):
+        Parallel(n_jobs=2, verbose=0)(
+            (delayed(exception_raiser)(i, custom_exception=True)
+             for i in range(30)))
+
+
+@with_multiprocessing
+@parametrize('backend', BACKENDS)
+def test_error_in_task_iterator(backend):
+
+    def my_generator(raise_at=0):
+        for i in range(20):
+            if i == raise_at:
+                raise ValueError("Iterator Raising Error")
+            yield i
+
+    with Parallel(n_jobs=2, backend=backend) as p:
+        # The error is raised in the pre-dispatch phase
+        with raises(ValueError, match="Iterator Raising Error"):
+            p(delayed(square)(i) for i in my_generator(raise_at=0))
+
+        # The error is raised when dispatching a new task after the
+        # pre-dispatch (likely to happen in a different thread)
+        with raises(ValueError, match="Iterator Raising Error"):
+            p(delayed(square)(i) for i in my_generator(raise_at=5))
+
+        # Same, but raises long after the pre-dispatch phase
+        with raises(ValueError, match="Iterator Raising Error"):
+            p(delayed(square)(i) for i in my_generator(raise_at=19))
+
+
+def consumer(queue, item):
+    queue.append('Consumed %s' % item)
+
+
+@parametrize('backend', BACKENDS)
+@parametrize('batch_size, expected_queue',
+             [(1, ['Produced 0', 'Consumed 0',
+                   'Produced 1', 'Consumed 1',
+                   'Produced 2', 'Consumed 2',
+                   'Produced 3', 'Consumed 3',
+                   'Produced 4', 'Consumed 4',
+                   'Produced 5', 'Consumed 5']),
+              (4, [  # First Batch
+                  'Produced 0', 'Produced 1', 'Produced 2', 'Produced 3',
+                  'Consumed 0', 'Consumed 1', 'Consumed 2', 'Consumed 3',
+                     # Second batch
+                  'Produced 4', 'Produced 5', 'Consumed 4', 'Consumed 5'])])
+def test_dispatch_one_job(backend, batch_size, expected_queue):
+    """ Test that with only one job, Parallel does act as a iterator.
+    """
+    queue = list()
+
+    def producer():
+        for i in range(6):
+            queue.append('Produced %i' % i)
+            yield i
+
+    Parallel(n_jobs=1, batch_size=batch_size, backend=backend)(
+        delayed(consumer)(queue, x) for x in producer())
+    assert queue == expected_queue
+    assert len(queue) == 12
+
+
+@with_multiprocessing
+@parametrize('backend', PARALLEL_BACKENDS)
+def test_dispatch_multiprocessing(backend):
+    """ Check that using pre_dispatch Parallel does indeed dispatch items
+        lazily.
+    """
+    manager = mp.Manager()
+    queue = manager.list()
+
+    def producer():
+        for i in range(6):
+            queue.append('Produced %i' % i)
+            yield i
+
+    Parallel(n_jobs=2, batch_size=1, pre_dispatch=3, backend=backend)(
+        delayed(consumer)(queue, 'any') for _ in producer())
+
+    queue_contents = list(queue)
+    assert queue_contents[0] == 'Produced 0'
+
+    # Only 3 tasks are pre-dispatched out of 6. The 4th task is dispatched only
+    # after any of the first 3 jobs have completed.
+    first_consumption_index = queue_contents[:4].index('Consumed any')
+    assert first_consumption_index > -1
+
+    produced_3_index = queue_contents.index('Produced 3')  # 4th task produced
+    assert produced_3_index > first_consumption_index
+
+    assert len(queue) == 12
+
+
+def test_batching_auto_threading():
+    # batching='auto' with the threading backend leaves the effective batch
+    # size to 1 (no batching) as it has been found to never be beneficial with
+    # this low-overhead backend.
+
+    with Parallel(n_jobs=2, batch_size='auto', backend='threading') as p:
+        p(delayed(id)(i) for i in range(5000))  # many very fast tasks
+        assert p._backend.compute_batch_size() == 1
+
+
+@with_multiprocessing
+@parametrize('backend', PROCESS_BACKENDS)
+def test_batching_auto_subprocesses(backend):
+    with Parallel(n_jobs=2, batch_size='auto', backend=backend) as p:
+        p(delayed(id)(i) for i in range(5000))  # many very fast tasks
+
+        # It should be strictly larger than 1 but as we don't want heisen
+        # failures on clogged CI worker environment be safe and only check that
+        # it's a strictly positive number.
+        assert p._backend.compute_batch_size() > 0
+
+
+def test_exception_dispatch():
+    """Make sure that exception raised during dispatch are indeed captured"""
+    with raises(ValueError):
+        Parallel(n_jobs=2, pre_dispatch=16, verbose=0)(
+            delayed(exception_raiser)(i) for i in range(30))
+
+
+def nested_function_inner(i):
+    Parallel(n_jobs=2)(
+        delayed(exception_raiser)(j) for j in range(30))
+
+
+def nested_function_outer(i):
+    Parallel(n_jobs=2)(
+        delayed(nested_function_inner)(j) for j in range(30))
+
+
+@with_multiprocessing
+@parametrize('backend', PARALLEL_BACKENDS)
+@pytest.mark.xfail(reason="https://github.com/joblib/loky/pull/255")
+def test_nested_exception_dispatch(backend):
+    """Ensure errors for nested joblib cases gets propagated
+
+    We rely on the Python 3 built-in __cause__ system that already
+    report this kind of information to the user.
+    """
+    with raises(ValueError) as excinfo:
+        Parallel(n_jobs=2, backend=backend)(
+            delayed(nested_function_outer)(i) for i in range(30))
+
+    # Check that important information such as function names are visible
+    # in the final error message reported to the user
+    report_lines = format_exception(excinfo.type, excinfo.value, excinfo.tb)
+    report = "".join(report_lines)
+    assert 'nested_function_outer' in report
+    assert 'nested_function_inner' in report
+    assert 'exception_raiser' in report
+
+    assert type(excinfo.value) is ValueError
+
+
+class FakeParallelBackend(SequentialBackend):
+    """Pretends to run concurrently while running sequentially."""
+
+    def configure(self, n_jobs=1, parallel=None, **backend_args):
+        self.n_jobs = self.effective_n_jobs(n_jobs)
+        self.parallel = parallel
+        return n_jobs
+
+    def effective_n_jobs(self, n_jobs=1):
+        if n_jobs < 0:
+            n_jobs = max(mp.cpu_count() + 1 + n_jobs, 1)
+        return n_jobs
+
+
+def test_invalid_backend():
+    with raises(ValueError, match="Invalid backend:"):
+        Parallel(backend='unit-testing')
+
+    with raises(ValueError, match="Invalid backend:"):
+        with parallel_config(backend='unit-testing'):
+            pass
+
+    with raises(ValueError, match="Invalid backend:"):
+        with parallel_config(backend='unit-testing'):
+            pass
+
+
+@parametrize('backend', ALL_VALID_BACKENDS)
+def test_invalid_njobs(backend):
+    with raises(ValueError) as excinfo:
+        Parallel(n_jobs=0, backend=backend)._initialize_backend()
+    assert "n_jobs == 0 in Parallel has no meaning" in str(excinfo.value)
+
+    with raises(ValueError) as excinfo:
+        Parallel(n_jobs=0.5, backend=backend)._initialize_backend()
+    assert "n_jobs == 0 in Parallel has no meaning" in str(excinfo.value)
+
+    with raises(ValueError) as excinfo:
+        Parallel(n_jobs="2.3", backend=backend)._initialize_backend()
+    assert "n_jobs could not be converted to int" in str(excinfo.value)
+
+    with raises(ValueError) as excinfo:
+        Parallel(n_jobs="invalid_str", backend=backend)._initialize_backend()
+    assert "n_jobs could not be converted to int" in str(excinfo.value)
+
+
+@with_multiprocessing
+@parametrize('backend', PARALLEL_BACKENDS)
+@parametrize('n_jobs', ['2', 2.3, 2])
+def test_njobs_converted_to_int(backend, n_jobs):
+    p = Parallel(n_jobs=n_jobs, backend=backend)
+    assert p._effective_n_jobs() == 2
+
+    res = p(delayed(square)(i) for i in range(10))
+    assert all(r == square(i) for i, r in enumerate(res))
+
+
+def test_register_parallel_backend():
+    try:
+        register_parallel_backend("test_backend", FakeParallelBackend)
+        assert "test_backend" in BACKENDS
+        assert BACKENDS["test_backend"] == FakeParallelBackend
+    finally:
+        del BACKENDS["test_backend"]
+
+
+def test_overwrite_default_backend():
+    assert _active_backend_type() == DefaultBackend
+    try:
+        register_parallel_backend("threading", BACKENDS["threading"],
+                                  make_default=True)
+        assert _active_backend_type() == ThreadingBackend
+    finally:
+        # Restore the global default manually
+        parallel.DEFAULT_BACKEND = DEFAULT_BACKEND
+    assert _active_backend_type() == DefaultBackend
+
+
+@skipif(mp is not None, reason="Only without multiprocessing")
+def test_backend_no_multiprocessing():
+    with warns(UserWarning,
+               match="joblib backend '.*' is not available on.*"):
+        Parallel(backend='loky')(delayed(square)(i) for i in range(3))
+
+    # The below should now work without problems
+    with parallel_config(backend='loky'):
+        Parallel()(delayed(square)(i) for i in range(3))
+
+
+def check_backend_context_manager(context, backend_name):
+    with context(backend_name, n_jobs=3):
+        active_backend, active_n_jobs = parallel.get_active_backend()
+        assert active_n_jobs == 3
+        assert effective_n_jobs(3) == 3
+        p = Parallel()
+        assert p.n_jobs == 3
+        if backend_name == 'multiprocessing':
+            assert type(active_backend) is MultiprocessingBackend
+            assert type(p._backend) is MultiprocessingBackend
+        elif backend_name == 'loky':
+            assert type(active_backend) is LokyBackend
+            assert type(p._backend) is LokyBackend
+        elif backend_name == 'threading':
+            assert type(active_backend) is ThreadingBackend
+            assert type(p._backend) is ThreadingBackend
+        elif backend_name.startswith('test_'):
+            assert type(active_backend) is FakeParallelBackend
+            assert type(p._backend) is FakeParallelBackend
+
+
+all_backends_for_context_manager = PARALLEL_BACKENDS[:]
+all_backends_for_context_manager.extend(
+    ['test_backend_%d' % i for i in range(3)]
+)
+
+
+@with_multiprocessing
+@parametrize('backend', all_backends_for_context_manager)
+@parametrize('context', [parallel_backend, parallel_config])
+def test_backend_context_manager(monkeypatch, backend, context):
+    if backend not in BACKENDS:
+        monkeypatch.setitem(BACKENDS, backend, FakeParallelBackend)
+
+    assert _active_backend_type() == DefaultBackend
+    # check that this possible to switch parallel backends sequentially
+    check_backend_context_manager(context, backend)
+
+    # The default backend is restored
+    assert _active_backend_type() == DefaultBackend
+
+    # Check that context manager switching is thread safe:
+    Parallel(n_jobs=2, backend='threading')(
+        delayed(check_backend_context_manager)(context, b)
+        for b in all_backends_for_context_manager if not b)
+
+    # The default backend is again restored
+    assert _active_backend_type() == DefaultBackend
+
+
+class ParameterizedParallelBackend(SequentialBackend):
+    """Pretends to run conncurrently while running sequentially."""
+
+    def __init__(self, param=None):
+        if param is None:
+            raise ValueError('param should not be None')
+        self.param = param
+
+
+@parametrize("context", [parallel_config, parallel_backend])
+def test_parameterized_backend_context_manager(monkeypatch, context):
+    monkeypatch.setitem(BACKENDS, 'param_backend',
+                        ParameterizedParallelBackend)
+    assert _active_backend_type() == DefaultBackend
+
+    with context('param_backend', param=42, n_jobs=3):
+        active_backend, active_n_jobs = parallel.get_active_backend()
+        assert type(active_backend) is ParameterizedParallelBackend
+        assert active_backend.param == 42
+        assert active_n_jobs == 3
+        p = Parallel()
+        assert p.n_jobs == 3
+        assert p._backend is active_backend
+        results = p(delayed(sqrt)(i) for i in range(5))
+    assert results == [sqrt(i) for i in range(5)]
+
+    # The default backend is again restored
+    assert _active_backend_type() == DefaultBackend
+
+
+@parametrize("context", [parallel_config, parallel_backend])
+def test_directly_parameterized_backend_context_manager(context):
+    assert _active_backend_type() == DefaultBackend
+
+    # Check that it's possible to pass a backend instance directly,
+    # without registration
+    with context(ParameterizedParallelBackend(param=43), n_jobs=5):
+        active_backend, active_n_jobs = parallel.get_active_backend()
+        assert type(active_backend) is ParameterizedParallelBackend
+        assert active_backend.param == 43
+        assert active_n_jobs == 5
+        p = Parallel()
+        assert p.n_jobs == 5
+        assert p._backend is active_backend
+        results = p(delayed(sqrt)(i) for i in range(5))
+    assert results == [sqrt(i) for i in range(5)]
+
+    # The default backend is again restored
+    assert _active_backend_type() == DefaultBackend
+
+
+def sleep_and_return_pid():
+    sleep(.1)
+    return os.getpid()
+
+
+def get_nested_pids():
+    assert _active_backend_type() == ThreadingBackend
+    # Assert that the nested backend does not change the default number of
+    # jobs used in Parallel
+    assert Parallel()._effective_n_jobs() == 1
+
+    # Assert that the tasks are running only on one process
+    return Parallel(n_jobs=2)(delayed(sleep_and_return_pid)()
+                              for _ in range(2))
+
+
+class MyBackend(joblib._parallel_backends.LokyBackend):
+    """Backend to test backward compatibility with older backends"""
+    def get_nested_backend(self, ):
+        # Older backends only return a backend, without n_jobs indications.
+        return super(MyBackend, self).get_nested_backend()[0]
+
+
+register_parallel_backend('back_compat_backend', MyBackend)
+
+
+@with_multiprocessing
+@parametrize('backend', ['threading', 'loky', 'multiprocessing',
+                         'back_compat_backend'])
+@parametrize("context", [parallel_config, parallel_backend])
+def test_nested_backend_context_manager(context, backend):
+    # Check that by default, nested parallel calls will always use the
+    # ThreadingBackend
+
+    with context(backend):
+        pid_groups = Parallel(n_jobs=2)(
+            delayed(get_nested_pids)()
+            for _ in range(10)
+        )
+        for pid_group in pid_groups:
+            assert len(set(pid_group)) == 1
+
+
+@with_multiprocessing
+@parametrize('n_jobs', [2, -1, None])
+@parametrize('backend', PARALLEL_BACKENDS)
+@parametrize("context", [parallel_config, parallel_backend])
+def test_nested_backend_in_sequential(backend, n_jobs, context):
+    # Check that by default, nested parallel calls will always use the
+    # ThreadingBackend
+
+    def check_nested_backend(expected_backend_type, expected_n_job):
+        # Assert that the sequential backend at top level, does not change the
+        # backend for nested calls.
+        assert _active_backend_type() == BACKENDS[expected_backend_type]
+
+        # Assert that the nested backend in SequentialBackend does not change
+        # the default number of jobs used in Parallel
+        expected_n_job = effective_n_jobs(expected_n_job)
+        assert Parallel()._effective_n_jobs() == expected_n_job
+
+    Parallel(n_jobs=1)(
+        delayed(check_nested_backend)(DEFAULT_BACKEND, 1)
+        for _ in range(10)
+    )
+
+    with context(backend, n_jobs=n_jobs):
+        Parallel(n_jobs=1)(
+            delayed(check_nested_backend)(backend, n_jobs)
+            for _ in range(10)
+        )
+
+
+def check_nesting_level(context, inner_backend, expected_level):
+    with context(inner_backend) as ctx:
+        if context is parallel_config:
+            backend = ctx["backend"]
+        if context is parallel_backend:
+            backend = ctx[0]
+        assert backend.nesting_level == expected_level
+
+
+@with_multiprocessing
+@parametrize('outer_backend', PARALLEL_BACKENDS)
+@parametrize('inner_backend', PARALLEL_BACKENDS)
+@parametrize("context", [parallel_config, parallel_backend])
+def test_backend_nesting_level(context, outer_backend, inner_backend):
+    # Check that the nesting level for the backend is correctly set
+    check_nesting_level(context, outer_backend, 0)
+
+    Parallel(n_jobs=2, backend=outer_backend)(
+        delayed(check_nesting_level)(context, inner_backend, 1)
+        for _ in range(10)
+    )
+
+    with context(inner_backend, n_jobs=2):
+        Parallel()(delayed(check_nesting_level)(context, inner_backend, 1)
+                   for _ in range(10))
+
+
+@with_multiprocessing
+@parametrize("context", [parallel_config, parallel_backend])
+@parametrize('with_retrieve_callback', [True, False])
+def test_retrieval_context(context, with_retrieve_callback):
+    import contextlib
+
+    class MyBackend(ThreadingBackend):
+        i = 0
+        supports_retrieve_callback = with_retrieve_callback
+
+        @contextlib.contextmanager
+        def retrieval_context(self):
+            self.i += 1
+            yield
+
+    register_parallel_backend("retrieval", MyBackend)
+
+    def nested_call(n):
+        return Parallel(n_jobs=2)(delayed(id)(i) for i in range(n))
+
+    with context("retrieval") as ctx:
+        Parallel(n_jobs=2)(
+            delayed(nested_call)(i)
+            for i in range(5)
+        )
+        if context is parallel_config:
+            assert ctx["backend"].i == 1
+        if context is parallel_backend:
+            assert ctx[0].i == 1
+
+
+###############################################################################
+# Test helpers
+
+@parametrize('batch_size', [0, -1, 1.42])
+def test_invalid_batch_size(batch_size):
+    with raises(ValueError):
+        Parallel(batch_size=batch_size)
+
+
+@parametrize('n_tasks, n_jobs, pre_dispatch, batch_size',
+             [(2, 2, 'all', 'auto'),
+              (2, 2, 'n_jobs', 'auto'),
+              (10, 2, 'n_jobs', 'auto'),
+              (517, 2, 'n_jobs', 'auto'),
+              (10, 2, 'n_jobs', 'auto'),
+              (10, 4, 'n_jobs', 'auto'),
+              (200, 12, 'n_jobs', 'auto'),
+              (25, 12, '2 * n_jobs', 1),
+              (250, 12, 'all', 1),
+              (250, 12, '2 * n_jobs', 7),
+              (200, 12, '2 * n_jobs', 'auto')])
+def test_dispatch_race_condition(n_tasks, n_jobs, pre_dispatch, batch_size):
+    # Check that using (async-)dispatch does not yield a race condition on the
+    # iterable generator that is not thread-safe natively.
+    # This is a non-regression test for the "Pool seems closed" class of error
+    params = {'n_jobs': n_jobs, 'pre_dispatch': pre_dispatch,
+              'batch_size': batch_size}
+    expected = [square(i) for i in range(n_tasks)]
+    results = Parallel(**params)(delayed(square)(i) for i in range(n_tasks))
+    assert results == expected
+
+
+@with_multiprocessing
+def test_default_mp_context():
+    mp_start_method = mp.get_start_method()
+    p = Parallel(n_jobs=2, backend='multiprocessing')
+    context = p._backend_args.get('context')
+    start_method = context.get_start_method()
+    assert start_method == mp_start_method
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize('backend', PROCESS_BACKENDS)
+def test_no_blas_crash_or_freeze_with_subprocesses(backend):
+    if backend == 'multiprocessing':
+        # Use the spawn backend that is both robust and available on all
+        # platforms
+        backend = mp.get_context('spawn')
+
+    # Check that on recent Python version, the 'spawn' start method can make
+    # it possible to use multiprocessing in conjunction of any BLAS
+    # implementation that happens to be used by numpy with causing a freeze or
+    # a crash
+    rng = np.random.RandomState(42)
+
+    # call BLAS DGEMM to force the initialization of the internal thread-pool
+    # in the main process
+    a = rng.randn(1000, 1000)
+    np.dot(a, a.T)
+
+    # check that the internal BLAS thread-pool is not in an inconsistent state
+    # in the worker processes managed by multiprocessing
+    Parallel(n_jobs=2, backend=backend)(
+        delayed(np.dot)(a, a.T) for i in range(2))
+
+
+UNPICKLABLE_CALLABLE_SCRIPT_TEMPLATE_NO_MAIN = """\
+from joblib import Parallel, delayed
+
+def square(x):
+    return x ** 2
+
+backend = "{}"
+if backend == "spawn":
+    from multiprocessing import get_context
+    backend = get_context(backend)
+
+print(Parallel(n_jobs=2, backend=backend)(
+      delayed(square)(i) for i in range(5)))
+"""
+
+
+@with_multiprocessing
+@parametrize('backend', PROCESS_BACKENDS)
+def test_parallel_with_interactively_defined_functions(backend):
+    # When using the "-c" flag, interactive functions defined in __main__
+    # should work with any backend.
+    if backend == "multiprocessing" and mp.get_start_method() != "fork":
+        pytest.skip("Require fork start method to use interactively defined "
+                    "functions with multiprocessing.")
+    code = UNPICKLABLE_CALLABLE_SCRIPT_TEMPLATE_NO_MAIN.format(backend)
+    check_subprocess_call(
+        [sys.executable, '-c', code], timeout=10,
+        stdout_regex=r'\[0, 1, 4, 9, 16\]')
+
+
+UNPICKLABLE_CALLABLE_SCRIPT_TEMPLATE_MAIN = """\
+import sys
+# Make sure that joblib is importable in the subprocess launching this
+# script. This is needed in case we run the tests from the joblib root
+# folder without having installed joblib
+sys.path.insert(0, {joblib_root_folder!r})
+
+from joblib import Parallel, delayed
+
+def run(f, x):
+    return f(x)
+
+{define_func}
+
+if __name__ == "__main__":
+    backend = "{backend}"
+    if backend == "spawn":
+        from multiprocessing import get_context
+        backend = get_context(backend)
+
+    callable_position = "{callable_position}"
+    if callable_position == "delayed":
+        print(Parallel(n_jobs=2, backend=backend)(
+                delayed(square)(i) for i in range(5)))
+    elif callable_position == "args":
+        print(Parallel(n_jobs=2, backend=backend)(
+                delayed(run)(square, i) for i in range(5)))
+    else:
+        print(Parallel(n_jobs=2, backend=backend)(
+                delayed(run)(f=square, x=i) for i in range(5)))
+"""
+
+SQUARE_MAIN = """\
+def square(x):
+    return x ** 2
+"""
+SQUARE_LOCAL = """\
+def gen_square():
+    def square(x):
+        return x ** 2
+    return square
+square = gen_square()
+"""
+SQUARE_LAMBDA = """\
+square = lambda x: x ** 2
+"""
+
+
+@with_multiprocessing
+@parametrize('backend', PROCESS_BACKENDS + ([] if mp is None else ['spawn']))
+@parametrize('define_func', [SQUARE_MAIN, SQUARE_LOCAL, SQUARE_LAMBDA])
+@parametrize('callable_position', ['delayed', 'args', 'kwargs'])
+def test_parallel_with_unpicklable_functions_in_args(
+        backend, define_func, callable_position, tmpdir):
+    if backend in ['multiprocessing', 'spawn'] and (
+            define_func != SQUARE_MAIN or sys.platform == "win32"):
+        pytest.skip("Not picklable with pickle")
+    code = UNPICKLABLE_CALLABLE_SCRIPT_TEMPLATE_MAIN.format(
+        define_func=define_func, backend=backend,
+        callable_position=callable_position,
+        joblib_root_folder=os.path.dirname(os.path.dirname(joblib.__file__)))
+    code_file = tmpdir.join("unpicklable_func_script.py")
+    code_file.write(code)
+    check_subprocess_call(
+        [sys.executable, code_file.strpath], timeout=10,
+        stdout_regex=r'\[0, 1, 4, 9, 16\]')
+
+
+INTERACTIVE_DEFINED_FUNCTION_AND_CLASS_SCRIPT_CONTENT = """\
+import sys
+import faulthandler
+# Make sure that joblib is importable in the subprocess launching this
+# script. This is needed in case we run the tests from the joblib root
+# folder without having installed joblib
+sys.path.insert(0, {joblib_root_folder!r})
+
+from joblib import Parallel, delayed
+from functools import partial
+
+class MyClass:
+    '''Class defined in the __main__ namespace'''
+    def __init__(self, value):
+        self.value = value
+
+
+def square(x, ignored=None, ignored2=None):
+    '''Function defined in the __main__ namespace'''
+    return x.value ** 2
+
+
+square2 = partial(square, ignored2='something')
+
+# Here, we do not need the `if __name__ == "__main__":` safeguard when
+# using the default `loky` backend (even on Windows).
+
+# To make debugging easier
+faulthandler.dump_traceback_later(30, exit=True)
+
+# The following baroque function call is meant to check that joblib
+# introspection rightfully uses cloudpickle instead of the (faster) pickle
+# module of the standard library when necessary. In particular cloudpickle is
+# necessary for functions and instances of classes interactively defined in the
+# __main__ module.
+
+print(Parallel(backend="loky", n_jobs=2)(
+    delayed(square2)(MyClass(i), ignored=[dict(a=MyClass(1))])
+    for i in range(5)
+))
+""".format(joblib_root_folder=os.path.dirname(
+    os.path.dirname(joblib.__file__)))
+
+
+@with_multiprocessing
+def test_parallel_with_interactively_defined_functions_loky(tmpdir):
+    # loky accepts interactive functions defined in __main__ and does not
+    # require if __name__ == '__main__' even when the __main__ module is
+    # defined by the result of the execution of a filesystem script.
+    script = tmpdir.join('joblib_interactively_defined_function.py')
+    script.write(INTERACTIVE_DEFINED_FUNCTION_AND_CLASS_SCRIPT_CONTENT)
+    check_subprocess_call(
+        [sys.executable, script.strpath],
+        stdout_regex=r'\[0, 1, 4, 9, 16\]',
+        timeout=None,  # rely on faulthandler to kill the process
+    )
+
+
+INTERACTIVELY_DEFINED_SUBCLASS_WITH_METHOD_SCRIPT_CONTENT = """\
+import sys
+# Make sure that joblib is importable in the subprocess launching this
+# script. This is needed in case we run the tests from the joblib root
+# folder without having installed joblib
+sys.path.insert(0, {joblib_root_folder!r})
+
+from joblib import Parallel, delayed, hash
+import multiprocessing as mp
+mp.util.log_to_stderr(5)
+
+class MyList(list):
+    '''MyList is interactively defined by MyList.append is a built-in'''
+    def __hash__(self):
+        # XXX: workaround limitation in cloudpickle
+        return hash(self).__hash__()
+
+l = MyList()
+
+print(Parallel(backend="loky", n_jobs=2)(
+    delayed(l.append)(i) for i in range(3)
+))
+""".format(joblib_root_folder=os.path.dirname(
+    os.path.dirname(joblib.__file__)))
+
+
+@with_multiprocessing
+def test_parallel_with_interactively_defined_bound_method_loky(tmpdir):
+    script = tmpdir.join('joblib_interactive_bound_method_script.py')
+    script.write(INTERACTIVELY_DEFINED_SUBCLASS_WITH_METHOD_SCRIPT_CONTENT)
+    check_subprocess_call([sys.executable, script.strpath],
+                          stdout_regex=r'\[None, None, None\]',
+                          stderr_regex=r'LokyProcess',
+                          timeout=15)
+
+
+def test_parallel_with_exhausted_iterator():
+    exhausted_iterator = iter([])
+    assert Parallel(n_jobs=2)(exhausted_iterator) == []
+
+
+def _cleanup_worker():
+    """Helper function to force gc in each worker."""
+    force_gc_pypy()
+    time.sleep(.1)
+
+
+def check_memmap(a):
+    if not isinstance(a, np.memmap):
+        raise TypeError('Expected np.memmap instance, got %r',
+                        type(a))
+    return a.copy()  # return a regular array instead of a memmap
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize('backend', PROCESS_BACKENDS)
+def test_auto_memmap_on_arrays_from_generator(backend):
+    # Non-regression test for a problem with a bad interaction between the
+    # GC collecting arrays recently created during iteration inside the
+    # parallel dispatch loop and the auto-memmap feature of Parallel.
+    # See: https://github.com/joblib/joblib/pull/294
+    def generate_arrays(n):
+        for i in range(n):
+            yield np.ones(10, dtype=np.float32) * i
+    # Use max_nbytes=1 to force the use of memory-mapping even for small
+    # arrays
+    results = Parallel(n_jobs=2, max_nbytes=1, backend=backend)(
+        delayed(check_memmap)(a) for a in generate_arrays(100))
+    for result, expected in zip(results, generate_arrays(len(results))):
+        np.testing.assert_array_equal(expected, result)
+
+    # Second call to force loky to adapt the executor by growing the number
+    # of worker processes. This is a non-regression test for:
+    # https://github.com/joblib/joblib/issues/629.
+    results = Parallel(n_jobs=4, max_nbytes=1, backend=backend)(
+        delayed(check_memmap)(a) for a in generate_arrays(100))
+    for result, expected in zip(results, generate_arrays(len(results))):
+        np.testing.assert_array_equal(expected, result)
+
+
+def identity(arg):
+    return arg
+
+
+@with_numpy
+@with_multiprocessing
+def test_memmap_with_big_offset(tmpdir):
+    fname = tmpdir.join('test.mmap').strpath
+    size = mmap.ALLOCATIONGRANULARITY
+    obj = [np.zeros(size, dtype='uint8'), np.ones(size, dtype='uint8')]
+    dump(obj, fname)
+    memmap = load(fname, mmap_mode='r')
+    result, = Parallel(n_jobs=2)(delayed(identity)(memmap) for _ in [0])
+    assert isinstance(memmap[1], np.memmap)
+    assert memmap[1].offset > size
+    np.testing.assert_array_equal(obj, result)
+
+
+def test_warning_about_timeout_not_supported_by_backend():
+    with warnings.catch_warnings(record=True) as warninfo:
+        Parallel(n_jobs=1, timeout=1)(delayed(square)(i) for i in range(50))
+    assert len(warninfo) == 1
+    w = warninfo[0]
+    assert isinstance(w.message, UserWarning)
+    assert str(w.message) == (
+        "The backend class 'SequentialBackend' does not support timeout. "
+        "You have set 'timeout=1' in Parallel but the 'timeout' parameter "
+        "will not be used.")
+
+
+def set_list_value(input_list, index, value):
+    input_list[index] = value
+    return value
+
+
+@pytest.mark.parametrize('n_jobs', [1, 2, 4])
+def test_parallel_return_order_with_return_as_generator_parameter(n_jobs):
+    # This test inserts values in a list in some expected order
+    # in sequential computing, and then checks that this order has been
+    # respected by Parallel output generator.
+    input_list = [0] * 5
+    result = Parallel(n_jobs=n_jobs, return_as="generator",
+                      backend='threading')(
+        delayed(set_list_value)(input_list, i, i) for i in range(5))
+
+    # Ensure that all the tasks are completed before checking the result
+    result = list(result)
+
+    assert all(v == r for v, r in zip(input_list, result))
+
+
+def _sqrt_with_delay(e, delay):
+    if delay:
+        sleep(30)
+    return sqrt(e)
+
+
+def _test_parallel_unordered_generator_returns_fastest_first(backend, n_jobs):
+    # This test submits 10 tasks, but the second task is super slow. This test
+    # checks that the 9 other tasks return before the slow task is done, when
+    # `return_as` parameter is set to `'generator_unordered'`
+    result = Parallel(n_jobs=n_jobs, return_as="generator_unordered",
+                      backend=backend)(
+        delayed(_sqrt_with_delay)(i**2, (i == 1)) for i in range(10))
+
+    quickly_returned = sorted(next(result) for _ in range(9))
+
+    expected_quickly_returned = [0] + list(range(2, 10))
+
+    assert all(
+        v == r for v, r in zip(expected_quickly_returned, quickly_returned)
+    )
+
+    del result
+    force_gc_pypy()
+
+
+@pytest.mark.parametrize('n_jobs', [2, 4])
+# NB: for this test to work, the backend must be allowed to process tasks
+# concurrently, so at least two jobs with a non-sequential backend are
+# mandatory.
+@with_multiprocessing
+@parametrize('backend', set(RETURN_GENERATOR_BACKENDS) - {"sequential"})
+def test_parallel_unordered_generator_returns_fastest_first(backend, n_jobs):
+    _test_parallel_unordered_generator_returns_fastest_first(backend, n_jobs)
+
+
+@pytest.mark.parametrize('n_jobs', [2, -1])
+@parametrize("context", [parallel_config, parallel_backend])
+@skipif(distributed is None, reason='This test requires dask')
+def test_parallel_unordered_generator_returns_fastest_first_with_dask(
+        n_jobs, context
+):
+    with distributed.Client(
+            n_workers=2, threads_per_worker=2
+    ), context("dask"):
+        _test_parallel_unordered_generator_returns_fastest_first(None, n_jobs)
+
+
+@parametrize('backend', ALL_VALID_BACKENDS)
+@parametrize('n_jobs', [1, 2, -2, -1])
+def test_abort_backend(n_jobs, backend):
+    delays = ["a"] + [10] * 100
+    with raises(TypeError):
+        t_start = time.time()
+        Parallel(n_jobs=n_jobs, backend=backend)(
+            delayed(time.sleep)(i) for i in delays)
+    dt = time.time() - t_start
+    assert dt < 20
+
+
+def get_large_object(arg):
+    result = np.ones(int(5 * 1e5), dtype=bool)
+    result[0] = False
+    return result
+
+
+def _test_deadlock_with_generator(backend, return_as, n_jobs):
+    # Non-regression test for a race condition in the backends when the pickler
+    # is delayed by a large object.
+    with Parallel(n_jobs=n_jobs, backend=backend,
+                  return_as=return_as) as parallel:
+        result = parallel(delayed(get_large_object)(i) for i in range(10))
+        next(result)
+        next(result)
+        del result
+        # The gc in pypy can be delayed. Force it to make sure this test does
+        # not cause timeout on the CI.
+        force_gc_pypy()
+
+
+@with_numpy
+@parametrize('backend', RETURN_GENERATOR_BACKENDS)
+@parametrize('return_as', ["generator", "generator_unordered"])
+@parametrize('n_jobs', [1, 2, -2, -1])
+def test_deadlock_with_generator(backend, return_as, n_jobs):
+    _test_deadlock_with_generator(backend, return_as, n_jobs)
+
+
+@with_numpy
+@pytest.mark.parametrize('n_jobs', [2, -1])
+@parametrize('return_as', ["generator", "generator_unordered"])
+@parametrize("context", [parallel_config, parallel_backend])
+@skipif(distributed is None, reason='This test requires dask')
+def test_deadlock_with_generator_and_dask(context, return_as, n_jobs):
+    with distributed.Client(
+            n_workers=2, threads_per_worker=2
+    ), context("dask"):
+        _test_deadlock_with_generator(None, return_as, n_jobs)
+
+
+@parametrize('backend', RETURN_GENERATOR_BACKENDS)
+@parametrize('return_as', ["generator", "generator_unordered"])
+@parametrize('n_jobs', [1, 2, -2, -1])
+def test_multiple_generator_call(backend, return_as, n_jobs):
+    # Non-regression test that ensures the dispatch of the tasks starts
+    # immediately when Parallel.__call__ is called. This test relies on the
+    # assumption that only one generator can be submitted at a time.
+    with raises(RuntimeError,
+                match="This Parallel instance is already running"):
+        parallel = Parallel(n_jobs, backend=backend, return_as=return_as)
+        g = parallel(delayed(sleep)(1) for _ in range(10))  # noqa: F841
+        t_start = time.time()
+        gen2 = parallel(delayed(id)(i) for i in range(100))  # noqa: F841
+
+    # Make sure that the error is raised quickly
+    assert time.time() - t_start < 2, (
+        "The error should be raised immediatly when submitting a new task "
+        "but it took more than 2s."
+    )
+
+    del g
+    # The gc in pypy can be delayed. Force it to make sure this test does not
+    # cause timeout on the CI.
+    force_gc_pypy()
+
+
+@parametrize('backend', RETURN_GENERATOR_BACKENDS)
+@parametrize('return_as', ["generator", "generator_unordered"])
+@parametrize('n_jobs', [1, 2, -2, -1])
+def test_multiple_generator_call_managed(backend, return_as, n_jobs):
+    # Non-regression test that ensures the dispatch of the tasks starts
+    # immediately when Parallel.__call__ is called. This test relies on the
+    # assumption that only one generator can be submitted at a time.
+    with Parallel(n_jobs, backend=backend,
+                  return_as=return_as) as parallel:
+        g = parallel(delayed(sleep)(10) for _ in range(10))  # noqa: F841
+        t_start = time.time()
+        with raises(RuntimeError,
+                    match="This Parallel instance is already running"):
+            g2 = parallel(delayed(id)(i) for i in range(100))  # noqa: F841
+
+        # Make sure that the error is raised quickly
+        assert time.time() - t_start < 2, (
+            "The error should be raised immediatly when submitting a new task "
+            "but it took more than 2s."
+        )
+
+    # The gc in pypy can be delayed. Force it to make sure this test does not
+    # cause timeout on the CI.
+    del g
+    force_gc_pypy()
+
+
+@parametrize('backend', RETURN_GENERATOR_BACKENDS)
+@parametrize('return_as_1', ["generator", "generator_unordered"])
+@parametrize('return_as_2', ["generator", "generator_unordered"])
+@parametrize('n_jobs', [1, 2, -2, -1])
+def test_multiple_generator_call_separated(
+        backend, return_as_1, return_as_2, n_jobs
+):
+    # Check that for separated Parallel, both tasks are correctly returned.
+    g = Parallel(n_jobs, backend=backend, return_as=return_as_1)(
+        delayed(sqrt)(i ** 2) for i in range(10)
+    )
+    g2 = Parallel(n_jobs, backend=backend, return_as=return_as_2)(
+        delayed(sqrt)(i ** 2) for i in range(10, 20)
+    )
+
+    if return_as_1 == "generator_unordered":
+        g = sorted(g)
+
+    if return_as_2 == "generator_unordered":
+        g2 = sorted(g2)
+
+    assert all(res == i for res, i in zip(g, range(10)))
+    assert all(res == i for res, i in zip(g2, range(10, 20)))
+
+
+@parametrize('backend, error', [
+    ('loky', True),
+    ('threading', False),
+    ('sequential', False),
+])
+@parametrize('return_as_1', ["generator", "generator_unordered"])
+@parametrize('return_as_2', ["generator", "generator_unordered"])
+def test_multiple_generator_call_separated_gc(
+        backend, return_as_1, return_as_2, error
+):
+
+    if (backend == 'loky') and (mp is None):
+        pytest.skip("Requires multiprocessing")
+
+    # Check that in loky, only one call can be run at a time with
+    # a single executor.
+    parallel = Parallel(2, backend=backend, return_as=return_as_1)
+    g = parallel(delayed(sleep)(10) for i in range(10))
+    g_wr = weakref.finalize(g, lambda: print("Generator collected"))
+    ctx = (
+        raises(RuntimeError, match="The executor underlying Parallel")
+        if error else nullcontext()
+    )
+    with ctx:
+        # For loky, this call will raise an error as the gc of the previous
+        # generator will shutdown the shared executor.
+        # For the other backends, as the worker pools are not shared between
+        # the two calls, this should proceed correctly.
+        t_start = time.time()
+        g = Parallel(2, backend=backend, return_as=return_as_2)(
+            delayed(sqrt)(i ** 2) for i in range(10, 20)
+        )
+
+        # The gc in pypy can be delayed. Force it to test the behavior when it
+        # will eventually be collected.
+        force_gc_pypy()
+
+        if return_as_2 == "generator_unordered":
+            g = sorted(g)
+
+        assert all(res == i for res, i in zip(g, range(10, 20)))
+
+    assert time.time() - t_start < 5
+
+    # Make sure that the computation are stopped for the gc'ed generator
+    retry = 0
+    while g_wr.alive and retry < 3:
+        retry += 1
+        time.sleep(.5)
+    assert time.time() - t_start < 5
+
+    if parallel._effective_n_jobs() != 1:
+        # check that the first parallel object is aborting (the final _aborted
+        # state might be delayed).
+        assert parallel._aborting
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize('backend', PROCESS_BACKENDS)
+def test_memmapping_leaks(backend, tmpdir):
+    # Non-regression test for memmapping backends. Ensure that the data
+    # does not stay too long in memory
+    tmpdir = tmpdir.strpath
+
+    # Use max_nbytes=1 to force the use of memory-mapping even for small
+    # arrays
+    with Parallel(n_jobs=2, max_nbytes=1, backend=backend,
+                  temp_folder=tmpdir) as p:
+        p(delayed(check_memmap)(a) for a in [np.random.random(10)] * 2)
+
+        # The memmap folder should not be clean in the context scope
+        assert len(os.listdir(tmpdir)) > 0
+
+        # Cleaning of the memmap folder is triggered by the garbage
+        # collection. With pypy the garbage collection has been observed to be
+        # delayed, sometimes up until the shutdown of the interpreter. This
+        # cleanup job executed in the worker ensures that it's triggered
+        # immediately.
+        p(delayed(_cleanup_worker)() for _ in range(2))
+
+    # Make sure that the shared memory is cleaned at the end when we exit
+    # the context
+    for _ in range(100):
+        if not os.listdir(tmpdir):
+            break
+        sleep(.1)
+    else:
+        raise AssertionError('temporary directory of Parallel was not removed')
+
+    # Make sure that the shared memory is cleaned at the end of a call
+    p = Parallel(n_jobs=2, max_nbytes=1, backend=backend)
+    p(delayed(check_memmap)(a) for a in [np.random.random(10)] * 2)
+    p(delayed(_cleanup_worker)() for _ in range(2))
+
+    for _ in range(100):
+        if not os.listdir(tmpdir):
+            break
+        sleep(.1)
+    else:
+        raise AssertionError('temporary directory of Parallel was not removed')
+
+
+@parametrize('backend',
+             ([None, 'threading'] if mp is None
+              else [None, 'loky', 'threading'])
+             )
+def test_lambda_expression(backend):
+    # cloudpickle is used to pickle delayed callables
+    results = Parallel(n_jobs=2, backend=backend)(
+        delayed(lambda x: x ** 2)(i) for i in range(10))
+    assert results == [i ** 2 for i in range(10)]
+
+
+@with_multiprocessing
+@parametrize('backend', PROCESS_BACKENDS)
+def test_backend_batch_statistics_reset(backend):
+    """Test that a parallel backend correctly resets its batch statistics."""
+    n_jobs = 2
+    n_inputs = 500
+    task_time = 2. / n_inputs
+
+    p = Parallel(verbose=10, n_jobs=n_jobs, backend=backend)
+    p(delayed(time.sleep)(task_time) for i in range(n_inputs))
+    assert (p._backend._effective_batch_size ==
+            p._backend._DEFAULT_EFFECTIVE_BATCH_SIZE)
+    assert (p._backend._smoothed_batch_duration ==
+            p._backend._DEFAULT_SMOOTHED_BATCH_DURATION)
+
+    p(delayed(time.sleep)(task_time) for i in range(n_inputs))
+    assert (p._backend._effective_batch_size ==
+            p._backend._DEFAULT_EFFECTIVE_BATCH_SIZE)
+    assert (p._backend._smoothed_batch_duration ==
+            p._backend._DEFAULT_SMOOTHED_BATCH_DURATION)
+
+
+@with_multiprocessing
+@parametrize("context", [parallel_config, parallel_backend])
+def test_backend_hinting_and_constraints(context):
+    for n_jobs in [1, 2, -1]:
+        assert type(Parallel(n_jobs=n_jobs)._backend) == DefaultBackend
+
+        p = Parallel(n_jobs=n_jobs, prefer='threads')
+        assert type(p._backend) is ThreadingBackend
+
+        p = Parallel(n_jobs=n_jobs, prefer='processes')
+        assert type(p._backend) is DefaultBackend
+
+        p = Parallel(n_jobs=n_jobs, require='sharedmem')
+        assert type(p._backend) is ThreadingBackend
+
+    # Explicit backend selection can override backend hinting although it
+    # is useless to pass a hint when selecting a backend.
+    p = Parallel(n_jobs=2, backend='loky', prefer='threads')
+    assert type(p._backend) is LokyBackend
+
+    with context('loky', n_jobs=2):
+        # Explicit backend selection by the user with the context manager
+        # should be respected when combined with backend hints only.
+        p = Parallel(prefer='threads')
+        assert type(p._backend) is LokyBackend
+        assert p.n_jobs == 2
+
+    with context('loky', n_jobs=2):
+        # Locally hard-coded n_jobs value is respected.
+        p = Parallel(n_jobs=3, prefer='threads')
+        assert type(p._backend) is LokyBackend
+        assert p.n_jobs == 3
+
+    with context('loky', n_jobs=2):
+        # Explicit backend selection by the user with the context manager
+        # should be ignored when the Parallel call has hard constraints.
+        # In this case, the default backend that supports shared mem is
+        # used an the default number of processes is used.
+        p = Parallel(require='sharedmem')
+        assert type(p._backend) is ThreadingBackend
+        assert p.n_jobs == 1
+
+    with context('loky', n_jobs=2):
+        p = Parallel(n_jobs=3, require='sharedmem')
+        assert type(p._backend) is ThreadingBackend
+        assert p.n_jobs == 3
+
+
+@parametrize("context", [parallel_config, parallel_backend])
+def test_backend_hinting_and_constraints_with_custom_backends(
+    capsys, context
+):
+    # Custom backends can declare that they use threads and have shared memory
+    # semantics:
+    class MyCustomThreadingBackend(ParallelBackendBase):
+        supports_sharedmem = True
+        use_threads = True
+
+        def apply_async(self):
+            pass
+
+        def effective_n_jobs(self, n_jobs):
+            return n_jobs
+
+    with context(MyCustomThreadingBackend()):
+        p = Parallel(n_jobs=2, prefer='processes')  # ignored
+        assert type(p._backend) is MyCustomThreadingBackend
+
+        p = Parallel(n_jobs=2, require='sharedmem')
+        assert type(p._backend) is MyCustomThreadingBackend
+
+    class MyCustomProcessingBackend(ParallelBackendBase):
+        supports_sharedmem = False
+        use_threads = False
+
+        def apply_async(self):
+            pass
+
+        def effective_n_jobs(self, n_jobs):
+            return n_jobs
+
+    with context(MyCustomProcessingBackend()):
+        p = Parallel(n_jobs=2, prefer='processes')
+        assert type(p._backend) is MyCustomProcessingBackend
+
+        out, err = capsys.readouterr()
+        assert out == ""
+        assert err == ""
+
+        p = Parallel(n_jobs=2, require='sharedmem', verbose=10)
+        assert type(p._backend) is ThreadingBackend
+
+        out, err = capsys.readouterr()
+        expected = ("Using ThreadingBackend as joblib backend "
+                    "instead of MyCustomProcessingBackend as the latter "
+                    "does not provide shared memory semantics.")
+        assert out.strip() == expected
+        assert err == ""
+
+    with raises(ValueError):
+        Parallel(backend=MyCustomProcessingBackend(), require='sharedmem')
+
+
+def test_invalid_backend_hinting_and_constraints():
+    with raises(ValueError):
+        Parallel(prefer='invalid')
+
+    with raises(ValueError):
+        Parallel(require='invalid')
+
+    with raises(ValueError):
+        # It is inconsistent to prefer process-based parallelism while
+        # requiring shared memory semantics.
+        Parallel(prefer='processes', require='sharedmem')
+
+    if mp is not None:
+        # It is inconsistent to ask explicitly for a process-based
+        # parallelism while requiring shared memory semantics.
+        with raises(ValueError):
+            Parallel(backend='loky', require='sharedmem')
+        with raises(ValueError):
+            Parallel(backend='multiprocessing', require='sharedmem')
+
+
+def _recursive_backend_info(limit=3, **kwargs):
+    """Perform nested parallel calls and introspect the backend on the way"""
+
+    with Parallel(n_jobs=2) as p:
+        this_level = [(type(p._backend).__name__, p._backend.nesting_level)]
+        if limit == 0:
+            return this_level
+        results = p(delayed(_recursive_backend_info)(limit=limit - 1, **kwargs)
+                    for i in range(1))
+        return this_level + results[0]
+
+
+@with_multiprocessing
+@parametrize('backend', ['loky', 'threading'])
+@parametrize("context", [parallel_config, parallel_backend])
+def test_nested_parallelism_limit(context, backend):
+    with context(backend, n_jobs=2):
+        backend_types_and_levels = _recursive_backend_info()
+
+    if cpu_count() == 1:
+        second_level_backend_type = 'SequentialBackend'
+        max_level = 1
+    else:
+        second_level_backend_type = 'ThreadingBackend'
+        max_level = 2
+
+    top_level_backend_type = backend.title() + 'Backend'
+    expected_types_and_levels = [
+        (top_level_backend_type, 0),
+        (second_level_backend_type, 1),
+        ('SequentialBackend', max_level),
+        ('SequentialBackend', max_level)
+    ]
+    assert backend_types_and_levels == expected_types_and_levels
+
+
+@with_numpy
+@parametrize("context", [parallel_config, parallel_backend])
+@skipif(distributed is None, reason='This test requires dask')
+def test_nested_parallelism_with_dask(context):
+    with distributed.Client(n_workers=2, threads_per_worker=2):
+        # 10 MB of data as argument to trigger implicit scattering
+        data = np.ones(int(1e7), dtype=np.uint8)
+        for i in range(2):
+            with context('dask'):
+                backend_types_and_levels = _recursive_backend_info(data=data)
+            assert len(backend_types_and_levels) == 4
+            assert all(name == 'DaskDistributedBackend'
+                       for name, _ in backend_types_and_levels)
+
+        # No argument
+        with context('dask'):
+            backend_types_and_levels = _recursive_backend_info()
+        assert len(backend_types_and_levels) == 4
+        assert all(name == 'DaskDistributedBackend'
+                   for name, _ in backend_types_and_levels)
+
+
+def _recursive_parallel(nesting_limit=None):
+    """A horrible function that does recursive parallel calls"""
+    return Parallel()(delayed(_recursive_parallel)() for i in range(2))
+
+
+@pytest.mark.no_cover
+@parametrize("context", [parallel_config, parallel_backend])
+@parametrize(
+    'backend', (['threading'] if mp is None else ['loky', 'threading'])
+)
+def test_thread_bomb_mitigation(context, backend):
+    # Test that recursive parallelism raises a recursion rather than
+    # saturating the operating system resources by creating a unbounded number
+    # of threads.
+    with context(backend, n_jobs=2):
+        with raises(BaseException) as excinfo:
+            _recursive_parallel()
+    exc = excinfo.value
+    if backend == "loky":
+        # Local import because loky may not be importable for lack of
+        # multiprocessing
+        from joblib.externals.loky.process_executor import TerminatedWorkerError # noqa
+        if isinstance(exc, (TerminatedWorkerError, PicklingError)):
+            # The recursion exception can itself cause an error when
+            # pickling it to be send back to the parent process. In this
+            # case the worker crashes but the original traceback is still
+            # printed on stderr. This could be improved but does not seem
+            # simple to do and this is not critical for users (as long
+            # as there is no process or thread bomb happening).
+            pytest.xfail("Loky worker crash when serializing RecursionError")
+
+    assert isinstance(exc, RecursionError)
+
+
+def _run_parallel_sum():
+    env_vars = {}
+    for var in ['OMP_NUM_THREADS', 'OPENBLAS_NUM_THREADS', 'MKL_NUM_THREADS',
+                'VECLIB_MAXIMUM_THREADS', 'NUMEXPR_NUM_THREADS',
+                'NUMBA_NUM_THREADS', 'ENABLE_IPC']:
+        env_vars[var] = os.environ.get(var)
+    return env_vars, parallel_sum(100)
+
+
+@parametrize("backend", ([None, 'loky'] if mp is not None else [None]))
+@skipif(parallel_sum is None, reason="Need OpenMP helper compiled")
+def test_parallel_thread_limit(backend):
+    results = Parallel(n_jobs=2, backend=backend)(
+        delayed(_run_parallel_sum)() for _ in range(2)
+    )
+    expected_num_threads = max(cpu_count() // 2, 1)
+    for worker_env_vars, omp_num_threads in results:
+        assert omp_num_threads == expected_num_threads
+        for name, value in worker_env_vars.items():
+            if name.endswith("_THREADS"):
+                assert value == str(expected_num_threads)
+            else:
+                assert name == "ENABLE_IPC"
+                assert value == "1"
+
+
+@parametrize("context", [parallel_config, parallel_backend])
+@skipif(distributed is not None, reason='This test requires dask')
+def test_dask_backend_when_dask_not_installed(context):
+    with raises(ValueError, match='Please install dask'):
+        context('dask')
+
+
+@parametrize("context", [parallel_config, parallel_backend])
+def test_zero_worker_backend(context):
+    # joblib.Parallel should reject with an explicit error message parallel
+    # backends that have no worker.
+    class ZeroWorkerBackend(ThreadingBackend):
+        def configure(self, *args, **kwargs):
+            return 0
+
+        def apply_async(self, func, callback=None):   # pragma: no cover
+            raise TimeoutError("No worker available")
+
+        def effective_n_jobs(self, n_jobs):   # pragma: no cover
+            return 0
+
+    expected_msg = "ZeroWorkerBackend has no active worker"
+    with context(ZeroWorkerBackend()):
+        with pytest.raises(RuntimeError, match=expected_msg):
+            Parallel(n_jobs=2)(delayed(id)(i) for i in range(2))
+
+
+def test_globals_update_at_each_parallel_call():
+    # This is a non-regression test related to joblib issues #836 and #833.
+    # Cloudpickle versions between 0.5.4 and 0.7 introduced a bug where global
+    # variables changes in a parent process between two calls to
+    # joblib.Parallel would not be propagated into the workers.
+    global MY_GLOBAL_VARIABLE
+    MY_GLOBAL_VARIABLE = "original value"
+
+    def check_globals():
+        global MY_GLOBAL_VARIABLE
+        return MY_GLOBAL_VARIABLE
+
+    assert check_globals() == "original value"
+
+    workers_global_variable = Parallel(n_jobs=2)(
+        delayed(check_globals)() for i in range(2))
+    assert set(workers_global_variable) == {"original value"}
+
+    # Change the value of MY_GLOBAL_VARIABLE, and make sure this change gets
+    # propagated into the workers environment
+    MY_GLOBAL_VARIABLE = "changed value"
+    assert check_globals() == "changed value"
+
+    workers_global_variable = Parallel(n_jobs=2)(
+        delayed(check_globals)() for i in range(2))
+    assert set(workers_global_variable) == {"changed value"}
+
+
+##############################################################################
+# Test environment variable in child env, in particular for limiting
+# the maximal number of threads in C-library threadpools.
+#
+
+def _check_numpy_threadpool_limits():
+    import numpy as np
+    # Let's call BLAS on a Matrix Matrix multiplication with dimensions large
+    # enough to ensure that the threadpool managed by the underlying BLAS
+    # implementation is actually used so as to force its initialization.
+    a = np.random.randn(100, 100)
+    np.dot(a, a)
+    from threadpoolctl import threadpool_info
+    return threadpool_info()
+
+
+def _parent_max_num_threads_for(child_module, parent_info):
+    for parent_module in parent_info:
+        if parent_module['filepath'] == child_module['filepath']:
+            return parent_module['num_threads']
+    raise ValueError("An unexpected module was loaded in child:\n{}"
+                     .format(child_module))
+
+
+def check_child_num_threads(workers_info, parent_info, num_threads):
+    # Check that the number of threads reported in workers_info is consistent
+    # with the expectation. We need to be careful to handle the cases where
+    # the requested number of threads is below max_num_thread for the library.
+    for child_threadpool_info in workers_info:
+        for child_module in child_threadpool_info:
+            parent_max_num_threads = _parent_max_num_threads_for(
+                child_module, parent_info)
+            expected = {min(num_threads, parent_max_num_threads), num_threads}
+            assert child_module['num_threads'] in expected
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize('n_jobs', [2, 4, -2, -1])
+def test_threadpool_limitation_in_child_loky(n_jobs):
+    # Check that the protection against oversubscription in workers is working
+    # using threadpoolctl functionalities.
+
+    # Skip this test if numpy is not linked to a BLAS library
+    parent_info = _check_numpy_threadpool_limits()
+    if len(parent_info) == 0:
+        pytest.skip(reason="Need a version of numpy linked to BLAS")
+
+    workers_threadpool_infos = Parallel(backend="loky", n_jobs=n_jobs)(
+        delayed(_check_numpy_threadpool_limits)() for i in range(2))
+
+    n_jobs = effective_n_jobs(n_jobs)
+    expected_child_num_threads = max(cpu_count() // n_jobs, 1)
+
+    check_child_num_threads(workers_threadpool_infos, parent_info,
+                            expected_child_num_threads)
+
+
+@with_numpy
+@with_multiprocessing
+@parametrize('inner_max_num_threads', [1, 2, 4, None])
+@parametrize('n_jobs', [2, -1])
+@parametrize("context", [parallel_config, parallel_backend])
+def test_threadpool_limitation_in_child_context(
+    context, n_jobs, inner_max_num_threads
+):
+    # Check that the protection against oversubscription in workers is working
+    # using threadpoolctl functionalities.
+
+    # Skip this test if numpy is not linked to a BLAS library
+    parent_info = _check_numpy_threadpool_limits()
+    if len(parent_info) == 0:
+        pytest.skip(reason="Need a version of numpy linked to BLAS")
+
+    with context('loky', inner_max_num_threads=inner_max_num_threads):
+        workers_threadpool_infos = Parallel(n_jobs=n_jobs)(
+            delayed(_check_numpy_threadpool_limits)() for i in range(2))
+
+    n_jobs = effective_n_jobs(n_jobs)
+    if inner_max_num_threads is None:
+        expected_child_num_threads = max(cpu_count() // n_jobs, 1)
+    else:
+        expected_child_num_threads = inner_max_num_threads
+
+    check_child_num_threads(workers_threadpool_infos, parent_info,
+                            expected_child_num_threads)
+
+
+@with_multiprocessing
+@parametrize('n_jobs', [2, -1])
+@parametrize('var_name', ["OPENBLAS_NUM_THREADS",
+                          "MKL_NUM_THREADS",
+                          "OMP_NUM_THREADS"])
+@parametrize("context", [parallel_config, parallel_backend])
+def test_threadpool_limitation_in_child_override(context, n_jobs, var_name):
+    # Check that environment variables set by the user on the main process
+    # always have the priority.
+
+    # Clean up the existing executor because we change the environment of the
+    # parent at runtime and it is not detected in loky intentionally.
+    get_reusable_executor(reuse=True).shutdown()
+
+    def _get_env(var_name):
+        return os.environ.get(var_name)
+
+    original_var_value = os.environ.get(var_name)
+    try:
+        os.environ[var_name] = "4"
+        # Skip this test if numpy is not linked to a BLAS library
+        results = Parallel(n_jobs=n_jobs)(
+            delayed(_get_env)(var_name) for i in range(2))
+        assert results == ["4", "4"]
+
+        with context('loky', inner_max_num_threads=1):
+            results = Parallel(n_jobs=n_jobs)(
+                delayed(_get_env)(var_name) for i in range(2))
+        assert results == ["1", "1"]
+
+    finally:
+        if original_var_value is None:
+            del os.environ[var_name]
+        else:
+            os.environ[var_name] = original_var_value
+
+
+@with_multiprocessing
+@parametrize('n_jobs', [2, 4, -1])
+def test_loky_reuse_workers(n_jobs):
+    # Non-regression test for issue #967 where the workers are not reused when
+    # calling multiple Parallel loops.
+
+    def parallel_call(n_jobs):
+        x = range(10)
+        Parallel(n_jobs=n_jobs)(delayed(sum)(x) for i in range(10))
+
+    # Run a parallel loop and get the workers used for computations
+    parallel_call(n_jobs)
+    first_executor = get_reusable_executor(reuse=True)
+
+    # Ensure that the workers are reused for the next calls, as the executor is
+    # not restarted.
+    for _ in range(10):
+        parallel_call(n_jobs)
+        executor = get_reusable_executor(reuse=True)
+        assert executor == first_executor
diff --git a/llm/Lib/site-packages/joblib/test/test_store_backends.py b/llm/Lib/site-packages/joblib/test/test_store_backends.py
new file mode 100644
index 0000000000000000000000000000000000000000..e5db16757ea45fd6761e1b8cfd35e5f5a920752f
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_store_backends.py
@@ -0,0 +1,94 @@
+
+try:
+    # Python 2.7: use the C pickle to speed up
+    # test_concurrency_safe_write which pickles big python objects
+    import cPickle as cpickle
+except ImportError:
+    import pickle as cpickle
+import functools
+from pickle import PicklingError
+import time
+
+import pytest
+
+from joblib.testing import parametrize, timeout
+from joblib.test.common import with_multiprocessing
+from joblib.backports import concurrency_safe_rename
+from joblib import Parallel, delayed
+from joblib._store_backends import (
+    concurrency_safe_write,
+    FileSystemStoreBackend,
+    CacheWarning,
+)
+
+
+def write_func(output, filename):
+    with open(filename, 'wb') as f:
+        cpickle.dump(output, f)
+
+
+def load_func(expected, filename):
+    for i in range(10):
+        try:
+            with open(filename, 'rb') as f:
+                reloaded = cpickle.load(f)
+            break
+        except (OSError, IOError):
+            # On Windows you can have WindowsError ([Error 5] Access
+            # is denied or [Error 13] Permission denied) when reading the file,
+            # probably because a writer process has a lock on the file
+            time.sleep(0.1)
+    else:
+        raise
+    assert expected == reloaded
+
+
+def concurrency_safe_write_rename(to_write, filename, write_func):
+    temporary_filename = concurrency_safe_write(to_write,
+                                                filename, write_func)
+    concurrency_safe_rename(temporary_filename, filename)
+
+
+@timeout(0)  # No timeout as this test can be long
+@with_multiprocessing
+@parametrize('backend', ['multiprocessing', 'loky', 'threading'])
+def test_concurrency_safe_write(tmpdir, backend):
+    # Add one item to cache
+    filename = tmpdir.join('test.pkl').strpath
+
+    obj = {str(i): i for i in range(int(1e5))}
+    funcs = [functools.partial(concurrency_safe_write_rename,
+                               write_func=write_func)
+             if i % 3 != 2 else load_func for i in range(12)]
+    Parallel(n_jobs=2, backend=backend)(
+        delayed(func)(obj, filename) for func in funcs)
+
+
+def test_warning_on_dump_failure(tmpdir):
+    # Check that a warning is raised when the dump fails for any reason but
+    # a PicklingError.
+    class UnpicklableObject(object):
+        def __reduce__(self):
+            raise RuntimeError("some exception")
+
+    backend = FileSystemStoreBackend()
+    backend.location = tmpdir.join('test_warning_on_pickling_error').strpath
+    backend.compress = None
+
+    with pytest.warns(CacheWarning, match="some exception"):
+        backend.dump_item("testpath", UnpicklableObject())
+
+
+def test_warning_on_pickling_error(tmpdir):
+    # This is separate from test_warning_on_dump_failure because in the
+    # future we will turn this into an exception.
+    class UnpicklableObject(object):
+        def __reduce__(self):
+            raise PicklingError("not picklable")
+
+    backend = FileSystemStoreBackend()
+    backend.location = tmpdir.join('test_warning_on_pickling_error').strpath
+    backend.compress = None
+
+    with pytest.warns(FutureWarning, match="not picklable"):
+        backend.dump_item("testpath", UnpicklableObject())
diff --git a/llm/Lib/site-packages/joblib/test/test_testing.py b/llm/Lib/site-packages/joblib/test/test_testing.py
new file mode 100644
index 0000000000000000000000000000000000000000..e8095aa67040ce868849b89927b325895b5d8e34
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_testing.py
@@ -0,0 +1,75 @@
+import sys
+import re
+
+from joblib.testing import raises, check_subprocess_call
+
+
+def test_check_subprocess_call():
+    code = '\n'.join(['result = 1 + 2 * 3',
+                      'print(result)',
+                      'my_list = [1, 2, 3]',
+                      'print(my_list)'])
+
+    check_subprocess_call([sys.executable, '-c', code])
+
+    # Now checking stdout with a regex
+    check_subprocess_call([sys.executable, '-c', code],
+                          # Regex needed for platform-specific line endings
+                          stdout_regex=r'7\s{1,2}\[1, 2, 3\]')
+
+
+def test_check_subprocess_call_non_matching_regex():
+    code = '42'
+    non_matching_pattern = '_no_way_this_matches_anything_'
+
+    with raises(ValueError) as excinfo:
+        check_subprocess_call([sys.executable, '-c', code],
+                              stdout_regex=non_matching_pattern)
+    excinfo.match('Unexpected stdout.+{}'.format(non_matching_pattern))
+
+
+def test_check_subprocess_call_wrong_command():
+    wrong_command = '_a_command_that_does_not_exist_'
+    with raises(OSError):
+        check_subprocess_call([wrong_command])
+
+
+def test_check_subprocess_call_non_zero_return_code():
+    code_with_non_zero_exit = '\n'.join([
+        'import sys',
+        'print("writing on stdout")',
+        'sys.stderr.write("writing on stderr")',
+        'sys.exit(123)'])
+
+    pattern = re.compile('Non-zero return code: 123.+'
+                         'Stdout:\nwriting on stdout.+'
+                         'Stderr:\nwriting on stderr', re.DOTALL)
+
+    with raises(ValueError) as excinfo:
+        check_subprocess_call([sys.executable, '-c', code_with_non_zero_exit])
+    excinfo.match(pattern)
+
+
+def test_check_subprocess_call_timeout():
+    code_timing_out = '\n'.join([
+        'import time',
+        'import sys',
+        'print("before sleep on stdout")',
+        'sys.stdout.flush()',
+        'sys.stderr.write("before sleep on stderr")',
+        'sys.stderr.flush()',
+        # We need to sleep for at least 2 * timeout seconds in case the SIGKILL
+        # is triggered.
+        'time.sleep(10)',
+        'print("process should have be killed before")',
+        'sys.stdout.flush()'])
+
+    pattern = re.compile('Non-zero return code:.+'
+                         'Stdout:\nbefore sleep on stdout\\s+'
+                         'Stderr:\nbefore sleep on stderr',
+                         re.DOTALL)
+
+    with raises(ValueError) as excinfo:
+        check_subprocess_call([sys.executable, '-c', code_timing_out],
+                              timeout=1)
+    excinfo.match(pattern)
diff --git a/llm/Lib/site-packages/joblib/test/test_utils.py b/llm/Lib/site-packages/joblib/test/test_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..4999a212c462bdb6c10e9e08fdfba74d03b05294
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/test_utils.py
@@ -0,0 +1,27 @@
+import pytest
+
+from joblib._utils import eval_expr
+
+
+@pytest.mark.parametrize(
+    "expr",
+    ["exec('import os')", "print(1)", "import os", "1+1; import os", "1^1"],
+)
+def test_eval_expr_invalid(expr):
+    with pytest.raises(
+        ValueError, match="is not a valid or supported arithmetic"
+    ):
+        eval_expr(expr)
+
+
+@pytest.mark.parametrize(
+    "expr, result",
+    [
+        ("2*6", 12),
+        ("2**6", 64),
+        ("1 + 2*3**(4) / (6 + -7)", -161.0),
+        ("(20 // 3) % 5", 1),
+    ],
+)
+def test_eval_expr_valid(expr, result):
+    assert eval_expr(expr) == result
diff --git a/llm/Lib/site-packages/joblib/test/testutils.py b/llm/Lib/site-packages/joblib/test/testutils.py
new file mode 100644
index 0000000000000000000000000000000000000000..20ec8c1ba0a50da6be9fce3686ac1950b1a55ab5
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/test/testutils.py
@@ -0,0 +1,8 @@
+def return_slice_of_data(arr, start_idx, end_idx):
+    return arr[start_idx:end_idx]
+
+
+def print_filename_and_raise(arr):
+    from joblib._memmapping_reducer import _get_backing_memmap
+    print(_get_backing_memmap(arr).filename)
+    raise ValueError
diff --git a/llm/Lib/site-packages/joblib/testing.py b/llm/Lib/site-packages/joblib/testing.py
new file mode 100644
index 0000000000000000000000000000000000000000..caab7d2903c710534596f2248de4b6c0642f9526
--- /dev/null
+++ b/llm/Lib/site-packages/joblib/testing.py
@@ -0,0 +1,99 @@
+"""
+Helper for testing.
+"""
+
+import sys
+import warnings
+import os.path
+import re
+import subprocess
+import threading
+
+import pytest
+import _pytest
+
+
+raises = pytest.raises
+warns = pytest.warns
+SkipTest = _pytest.runner.Skipped
+skipif = pytest.mark.skipif
+fixture = pytest.fixture
+parametrize = pytest.mark.parametrize
+timeout = pytest.mark.timeout
+xfail = pytest.mark.xfail
+param = pytest.param
+
+
+def warnings_to_stdout():
+    """ Redirect all warnings to stdout.
+    """
+    showwarning_orig = warnings.showwarning
+
+    def showwarning(msg, cat, fname, lno, file=None, line=0):
+        showwarning_orig(msg, cat, os.path.basename(fname), line, sys.stdout)
+
+    warnings.showwarning = showwarning
+    # warnings.simplefilter('always')
+
+
+def check_subprocess_call(cmd, timeout=5, stdout_regex=None,
+                          stderr_regex=None):
+    """Runs a command in a subprocess with timeout in seconds.
+
+    A SIGTERM is sent after `timeout` and if it does not terminate, a
+    SIGKILL is sent after `2 * timeout`.
+
+    Also checks returncode is zero, stdout if stdout_regex is set, and
+    stderr if stderr_regex is set.
+    """
+    proc = subprocess.Popen(cmd, stdout=subprocess.PIPE,
+                            stderr=subprocess.PIPE)
+
+    def terminate_process():  # pragma: no cover
+        """
+        Attempt to terminate a leftover process spawned during test execution:
+        ideally this should not be needed but can help avoid clogging the CI
+        workers in case of deadlocks.
+        """
+        warnings.warn(f"Timeout running {cmd}")
+        proc.terminate()
+
+    def kill_process():  # pragma: no cover
+        """
+        Kill a leftover process spawned during test execution: ideally this
+        should not be needed but can help avoid clogging the CI workers in
+        case of deadlocks.
+        """
+        warnings.warn(f"Timeout running {cmd}")
+        proc.kill()
+
+    try:
+        if timeout is not None:
+            terminate_timer = threading.Timer(timeout, terminate_process)
+            terminate_timer.start()
+            kill_timer = threading.Timer(2 * timeout, kill_process)
+            kill_timer.start()
+        stdout, stderr = proc.communicate()
+        stdout, stderr = stdout.decode(), stderr.decode()
+        if proc.returncode != 0:
+            message = (
+                'Non-zero return code: {}.\nStdout:\n{}\n'
+                'Stderr:\n{}').format(
+                    proc.returncode, stdout, stderr)
+            raise ValueError(message)
+
+        if (stdout_regex is not None and
+                not re.search(stdout_regex, stdout)):
+            raise ValueError(
+                "Unexpected stdout: {!r} does not match:\n{!r}".format(
+                    stdout_regex, stdout))
+        if (stderr_regex is not None and
+                not re.search(stderr_regex, stderr)):
+            raise ValueError(
+                "Unexpected stderr: {!r} does not match:\n{!r}".format(
+                    stderr_regex, stderr))
+
+    finally:
+        if timeout is not None:
+            terminate_timer.cancel()
+            kill_timer.cancel()
diff --git a/llm/Lib/site-packages/jsonpatch-1.33.dist-info/AUTHORS b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/AUTHORS
new file mode 100644
index 0000000000000000000000000000000000000000..f5f6363eac6b578d8bf76a98a0fe673ec285f7bb
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/AUTHORS
@@ -0,0 +1,4 @@
+Stefan Kögl <stefan@skoegl.net>
+Alexander Shorin <kxepal@gmail.com>
+Byron Ruth <bruth@codeomics.com>
+William Kral <william.kral@gmail.com>
diff --git a/llm/Lib/site-packages/jsonpatch-1.33.dist-info/INSTALLER b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/jsonpatch-1.33.dist-info/LICENSE b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..c8fc60f32e80077abc2c7c1e968b3fcf44cde304
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/LICENSE
@@ -0,0 +1,11 @@
+Copyright (c) 2011 Stefan Kögl <stefan@skoegl.net>
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/llm/Lib/site-packages/jsonpatch-1.33.dist-info/METADATA b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..f73d29d6ae84ed1855680d30bbb2ee753d9534fd
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/METADATA
@@ -0,0 +1,66 @@
+Metadata-Version: 2.1
+Name: jsonpatch
+Version: 1.33
+Summary: Apply JSON-Patches (RFC 6902) 
+Home-page: https://github.com/stefankoegl/python-json-patch
+Author: Stefan Kögl
+Author-email: stefan@skoegl.net
+License: Modified BSD License
+Project-URL: Website, https://github.com/stefankoegl/python-json-patch
+Project-URL: Repository, https://github.com/stefankoegl/python-json-patch.git
+Project-URL: Documentation, https://python-json-patch.readthedocs.org/
+Project-URL: PyPI, https://pypi.org/pypi/jsonpatch
+Project-URL: Tests, https://travis-ci.org/stefankoegl/python-json-patch
+Project-URL: Test Coverage, https://coveralls.io/r/stefankoegl/python-json-patch
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, !=3.6.*
+License-File: LICENSE
+License-File: AUTHORS
+Requires-Dist: jsonpointer (>=1.9)
+
+python-json-patch
+=================
+
+[![PyPI version](https://img.shields.io/pypi/v/jsonpatch.svg)](https://pypi.python.org/pypi/jsonpatch/)
+[![Supported Python versions](https://img.shields.io/pypi/pyversions/jsonpatch.svg)](https://pypi.python.org/pypi/jsonpatch/)
+[![Build Status](https://travis-ci.org/stefankoegl/python-json-patch.png?branch=master)](https://travis-ci.org/stefankoegl/python-json-patch)
+[![Coverage Status](https://coveralls.io/repos/stefankoegl/python-json-patch/badge.png?branch=master)](https://coveralls.io/r/stefankoegl/python-json-patch?branch=master)
+
+Applying JSON Patches in Python
+-------------------------------
+
+Library to apply JSON Patches according to
+[RFC 6902](http://tools.ietf.org/html/rfc6902)
+
+See source code for examples
+
+* Website: https://github.com/stefankoegl/python-json-patch
+* Repository: https://github.com/stefankoegl/python-json-patch.git
+* Documentation: https://python-json-patch.readthedocs.org/
+* PyPI: https://pypi.python.org/pypi/jsonpatch
+* Travis CI: https://travis-ci.org/stefankoegl/python-json-patch
+* Coveralls: https://coveralls.io/r/stefankoegl/python-json-patch
+
+Running external tests
+----------------------
+To run external tests (such as those from https://github.com/json-patch/json-patch-tests) use ext_test.py
+
+    ./ext_tests.py ../json-patch-tests/tests.json
+
+
diff --git a/llm/Lib/site-packages/jsonpatch-1.33.dist-info/RECORD b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..6db2e26079004c9247c642c351b1153867c4300f
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/RECORD
@@ -0,0 +1,11 @@
+../../Scripts/jsondiff,sha256=0rKV-UMgsMa-QOtsr3ljQai4gDgwi1OdPPsW4tOmo3o,1212
+../../Scripts/jsonpatch,sha256=EEJiiZVYz7mXPSa577cr29rQc-8ErQ_VlsDh7aetUU4,3873
+__pycache__/jsonpatch.cpython-311.pyc,,
+jsonpatch-1.33.dist-info/AUTHORS,sha256=hOtEnBGbfDegKjzMDEl5vuVJyczbI2PlYE2ho4LjGNQ,140
+jsonpatch-1.33.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+jsonpatch-1.33.dist-info/LICENSE,sha256=Q5PrZzP6HjZ_QXabOC9PG-e_Da6x4kPtkrP12Lr9I28,1481
+jsonpatch-1.33.dist-info/METADATA,sha256=BvMru0ZpJn2EqCva9fwN1Nhh0NoAayr171mCWaZveik,2980
+jsonpatch-1.33.dist-info/RECORD,,
+jsonpatch-1.33.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
+jsonpatch-1.33.dist-info/top_level.txt,sha256=zcviI7Mh4AvvPBpgKZBzEdgbVh_ewsfvS2t3-wcsnN4,10
+jsonpatch.py,sha256=V752by5vjU3ced_Unhc1Ltd2jgcoS12krKaSEPs7pf4,29778
diff --git a/llm/Lib/site-packages/jsonpatch-1.33.dist-info/WHEEL b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..0b18a281107a0448a9980396d9d324ea2aa7a7f8
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.37.1)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/jsonpatch-1.33.dist-info/top_level.txt b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..621f9382109e9ad87814ac832c67942e6b3731c0
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpatch-1.33.dist-info/top_level.txt
@@ -0,0 +1 @@
+jsonpatch
diff --git a/llm/Lib/site-packages/jsonpatch.py b/llm/Lib/site-packages/jsonpatch.py
new file mode 100644
index 0000000000000000000000000000000000000000..d3fc26d51c53006fecd09ff7a31e10ef01883f25
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpatch.py
@@ -0,0 +1,931 @@
+# -*- coding: utf-8 -*-
+#
+# python-json-patch - An implementation of the JSON Patch format
+# https://github.com/stefankoegl/python-json-patch
+#
+# Copyright (c) 2011 Stefan Kögl <stefan@skoegl.net>
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+#
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+# 3. The name of the author may not be used to endorse or promote products
+#    derived from this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+
+""" Apply JSON-Patches (RFC 6902) """
+
+from __future__ import unicode_literals
+
+import collections
+import copy
+import functools
+import json
+import sys
+
+try:
+    from collections.abc import Sequence
+except ImportError:  # Python 3
+    from collections import Sequence
+
+try:
+    from types import MappingProxyType
+except ImportError:
+    # Python < 3.3
+    MappingProxyType = dict
+
+from jsonpointer import JsonPointer, JsonPointerException
+
+
+_ST_ADD = 0
+_ST_REMOVE = 1
+
+
+try:
+    from collections.abc import MutableMapping, MutableSequence
+
+except ImportError:
+    from collections import MutableMapping, MutableSequence
+    str = unicode
+
+# Will be parsed by setup.py to determine package metadata
+__author__ = 'Stefan Kögl <stefan@skoegl.net>'
+__version__ = '1.33'
+__website__ = 'https://github.com/stefankoegl/python-json-patch'
+__license__ = 'Modified BSD License'
+
+
+# pylint: disable=E0611,W0404
+if sys.version_info >= (3, 0):
+    basestring = (bytes, str)  # pylint: disable=C0103,W0622
+
+
+class JsonPatchException(Exception):
+    """Base Json Patch exception"""
+
+
+class InvalidJsonPatch(JsonPatchException):
+    """ Raised if an invalid JSON Patch is created """
+
+
+class JsonPatchConflict(JsonPatchException):
+    """Raised if patch could not be applied due to conflict situation such as:
+    - attempt to add object key when it already exists;
+    - attempt to operate with nonexistence object key;
+    - attempt to insert value to array at position beyond its size;
+    - etc.
+    """
+
+
+class JsonPatchTestFailed(JsonPatchException, AssertionError):
+    """ A Test operation failed """
+
+
+def multidict(ordered_pairs):
+    """Convert duplicate keys values to lists."""
+    # read all values into lists
+    mdict = collections.defaultdict(list)
+    for key, value in ordered_pairs:
+        mdict[key].append(value)
+
+    return dict(
+        # unpack lists that have only 1 item
+        (key, values[0] if len(values) == 1 else values)
+        for key, values in mdict.items()
+    )
+
+
+# The "object_pairs_hook" parameter is used to handle duplicate keys when
+# loading a JSON object.
+_jsonloads = functools.partial(json.loads, object_pairs_hook=multidict)
+
+
+def apply_patch(doc, patch, in_place=False, pointer_cls=JsonPointer):
+    """Apply list of patches to specified json document.
+
+    :param doc: Document object.
+    :type doc: dict
+
+    :param patch: JSON patch as list of dicts or raw JSON-encoded string.
+    :type patch: list or str
+
+    :param in_place: While :const:`True` patch will modify target document.
+                     By default patch will be applied to document copy.
+    :type in_place: bool
+
+    :param pointer_cls: JSON pointer class to use.
+    :type pointer_cls: Type[JsonPointer]
+
+    :return: Patched document object.
+    :rtype: dict
+
+    >>> doc = {'foo': 'bar'}
+    >>> patch = [{'op': 'add', 'path': '/baz', 'value': 'qux'}]
+    >>> other = apply_patch(doc, patch)
+    >>> doc is not other
+    True
+    >>> other == {'foo': 'bar', 'baz': 'qux'}
+    True
+    >>> patch = [{'op': 'add', 'path': '/baz', 'value': 'qux'}]
+    >>> apply_patch(doc, patch, in_place=True) == {'foo': 'bar', 'baz': 'qux'}
+    True
+    >>> doc == other
+    True
+    """
+
+    if isinstance(patch, basestring):
+        patch = JsonPatch.from_string(patch, pointer_cls=pointer_cls)
+    else:
+        patch = JsonPatch(patch, pointer_cls=pointer_cls)
+    return patch.apply(doc, in_place)
+
+
+def make_patch(src, dst, pointer_cls=JsonPointer):
+    """Generates patch by comparing two document objects. Actually is
+    a proxy to :meth:`JsonPatch.from_diff` method.
+
+    :param src: Data source document object.
+    :type src: dict
+
+    :param dst: Data source document object.
+    :type dst: dict
+
+    :param pointer_cls: JSON pointer class to use.
+    :type pointer_cls: Type[JsonPointer]
+
+    >>> src = {'foo': 'bar', 'numbers': [1, 3, 4, 8]}
+    >>> dst = {'baz': 'qux', 'numbers': [1, 4, 7]}
+    >>> patch = make_patch(src, dst)
+    >>> new = patch.apply(src)
+    >>> new == dst
+    True
+    """
+
+    return JsonPatch.from_diff(src, dst, pointer_cls=pointer_cls)
+
+
+class PatchOperation(object):
+    """A single operation inside a JSON Patch."""
+
+    def __init__(self, operation, pointer_cls=JsonPointer):
+        self.pointer_cls = pointer_cls
+
+        if not operation.__contains__('path'):
+            raise InvalidJsonPatch("Operation must have a 'path' member")
+
+        if isinstance(operation['path'], self.pointer_cls):
+            self.location = operation['path'].path
+            self.pointer = operation['path']
+        else:
+            self.location = operation['path']
+            try:
+                self.pointer = self.pointer_cls(self.location)
+            except TypeError as ex:
+                raise InvalidJsonPatch("Invalid 'path'")
+
+        self.operation = operation
+
+    def apply(self, obj):
+        """Abstract method that applies a patch operation to the specified object."""
+        raise NotImplementedError('should implement the patch operation.')
+
+    def __hash__(self):
+        return hash(frozenset(self.operation.items()))
+
+    def __eq__(self, other):
+        if not isinstance(other, PatchOperation):
+            return False
+        return self.operation == other.operation
+
+    def __ne__(self, other):
+        return not(self == other)
+
+    @property
+    def path(self):
+        return '/'.join(self.pointer.parts[:-1])
+
+    @property
+    def key(self):
+        try:
+            return int(self.pointer.parts[-1])
+        except ValueError:
+            return self.pointer.parts[-1]
+
+    @key.setter
+    def key(self, value):
+        self.pointer.parts[-1] = str(value)
+        self.location = self.pointer.path
+        self.operation['path'] = self.location
+
+
+class RemoveOperation(PatchOperation):
+    """Removes an object property or an array element."""
+
+    def apply(self, obj):
+        subobj, part = self.pointer.to_last(obj)
+
+        if isinstance(subobj, Sequence) and not isinstance(part, int):
+            raise JsonPointerException("invalid array index '{0}'".format(part))
+
+        try:
+            del subobj[part]
+        except (KeyError, IndexError) as ex:
+            msg = "can't remove a non-existent object '{0}'".format(part)
+            raise JsonPatchConflict(msg)
+
+        return obj
+
+    def _on_undo_remove(self, path, key):
+        if self.path == path:
+            if self.key >= key:
+                self.key += 1
+            else:
+                key -= 1
+        return key
+
+    def _on_undo_add(self, path, key):
+        if self.path == path:
+            if self.key > key:
+                self.key -= 1
+            else:
+                key -= 1
+        return key
+
+
+class AddOperation(PatchOperation):
+    """Adds an object property or an array element."""
+
+    def apply(self, obj):
+        try:
+            value = self.operation["value"]
+        except KeyError as ex:
+            raise InvalidJsonPatch(
+                "The operation does not contain a 'value' member")
+
+        subobj, part = self.pointer.to_last(obj)
+
+        if isinstance(subobj, MutableSequence):
+            if part == '-':
+                subobj.append(value)  # pylint: disable=E1103
+
+            elif part > len(subobj) or part < 0:
+                raise JsonPatchConflict("can't insert outside of list")
+
+            else:
+                subobj.insert(part, value)  # pylint: disable=E1103
+
+        elif isinstance(subobj, MutableMapping):
+            if part is None:
+                obj = value  # we're replacing the root
+            else:
+                subobj[part] = value
+
+        else:
+            if part is None:
+                raise TypeError("invalid document type {0}".format(type(subobj)))
+            else:
+                raise JsonPatchConflict("unable to fully resolve json pointer {0}, part {1}".format(self.location, part))
+        return obj
+
+    def _on_undo_remove(self, path, key):
+        if self.path == path:
+            if self.key > key:
+                self.key += 1
+            else:
+                key += 1
+        return key
+
+    def _on_undo_add(self, path, key):
+        if self.path == path:
+            if self.key > key:
+                self.key -= 1
+            else:
+                key += 1
+        return key
+
+
+class ReplaceOperation(PatchOperation):
+    """Replaces an object property or an array element by a new value."""
+
+    def apply(self, obj):
+        try:
+            value = self.operation["value"]
+        except KeyError as ex:
+            raise InvalidJsonPatch(
+                "The operation does not contain a 'value' member")
+
+        subobj, part = self.pointer.to_last(obj)
+
+        if part is None:
+            return value
+
+        if part == "-":
+            raise InvalidJsonPatch("'path' with '-' can't be applied to 'replace' operation")
+
+        if isinstance(subobj, MutableSequence):
+            if part >= len(subobj) or part < 0:
+                raise JsonPatchConflict("can't replace outside of list")
+
+        elif isinstance(subobj, MutableMapping):
+            if part not in subobj:
+                msg = "can't replace a non-existent object '{0}'".format(part)
+                raise JsonPatchConflict(msg)
+        else:
+            if part is None:
+                raise TypeError("invalid document type {0}".format(type(subobj)))
+            else:
+                raise JsonPatchConflict("unable to fully resolve json pointer {0}, part {1}".format(self.location, part))
+
+        subobj[part] = value
+        return obj
+
+    def _on_undo_remove(self, path, key):
+        return key
+
+    def _on_undo_add(self, path, key):
+        return key
+
+
+class MoveOperation(PatchOperation):
+    """Moves an object property or an array element to a new location."""
+
+    def apply(self, obj):
+        try:
+            if isinstance(self.operation['from'], self.pointer_cls):
+                from_ptr = self.operation['from']
+            else:
+                from_ptr = self.pointer_cls(self.operation['from'])
+        except KeyError as ex:
+            raise InvalidJsonPatch(
+                "The operation does not contain a 'from' member")
+
+        subobj, part = from_ptr.to_last(obj)
+        try:
+            value = subobj[part]
+        except (KeyError, IndexError) as ex:
+            raise JsonPatchConflict(str(ex))
+
+        # If source and target are equal, this is a no-op
+        if self.pointer == from_ptr:
+            return obj
+
+        if isinstance(subobj, MutableMapping) and \
+                self.pointer.contains(from_ptr):
+            raise JsonPatchConflict('Cannot move values into their own children')
+
+        obj = RemoveOperation({
+            'op': 'remove',
+            'path': self.operation['from']
+        }, pointer_cls=self.pointer_cls).apply(obj)
+
+        obj = AddOperation({
+            'op': 'add',
+            'path': self.location,
+            'value': value
+        }, pointer_cls=self.pointer_cls).apply(obj)
+
+        return obj
+
+    @property
+    def from_path(self):
+        from_ptr = self.pointer_cls(self.operation['from'])
+        return '/'.join(from_ptr.parts[:-1])
+
+    @property
+    def from_key(self):
+        from_ptr = self.pointer_cls(self.operation['from'])
+        try:
+            return int(from_ptr.parts[-1])
+        except TypeError:
+            return from_ptr.parts[-1]
+
+    @from_key.setter
+    def from_key(self, value):
+        from_ptr = self.pointer_cls(self.operation['from'])
+        from_ptr.parts[-1] = str(value)
+        self.operation['from'] = from_ptr.path
+
+    def _on_undo_remove(self, path, key):
+        if self.from_path == path:
+            if self.from_key >= key:
+                self.from_key += 1
+            else:
+                key -= 1
+        if self.path == path:
+            if self.key > key:
+                self.key += 1
+            else:
+                key += 1
+        return key
+
+    def _on_undo_add(self, path, key):
+        if self.from_path == path:
+            if self.from_key > key:
+                self.from_key -= 1
+            else:
+                key -= 1
+        if self.path == path:
+            if self.key > key:
+                self.key -= 1
+            else:
+                key += 1
+        return key
+
+
+class TestOperation(PatchOperation):
+    """Test value by specified location."""
+
+    def apply(self, obj):
+        try:
+            subobj, part = self.pointer.to_last(obj)
+            if part is None:
+                val = subobj
+            else:
+                val = self.pointer.walk(subobj, part)
+        except JsonPointerException as ex:
+            raise JsonPatchTestFailed(str(ex))
+
+        try:
+            value = self.operation['value']
+        except KeyError as ex:
+            raise InvalidJsonPatch(
+                "The operation does not contain a 'value' member")
+
+        if val != value:
+            msg = '{0} ({1}) is not equal to tested value {2} ({3})'
+            raise JsonPatchTestFailed(msg.format(val, type(val),
+                                                 value, type(value)))
+
+        return obj
+
+
+class CopyOperation(PatchOperation):
+    """ Copies an object property or an array element to a new location """
+
+    def apply(self, obj):
+        try:
+            from_ptr = self.pointer_cls(self.operation['from'])
+        except KeyError as ex:
+            raise InvalidJsonPatch(
+                "The operation does not contain a 'from' member")
+
+        subobj, part = from_ptr.to_last(obj)
+        try:
+            value = copy.deepcopy(subobj[part])
+        except (KeyError, IndexError) as ex:
+            raise JsonPatchConflict(str(ex))
+
+        obj = AddOperation({
+            'op': 'add',
+            'path': self.location,
+            'value': value
+        }, pointer_cls=self.pointer_cls).apply(obj)
+
+        return obj
+
+
+class JsonPatch(object):
+    json_dumper = staticmethod(json.dumps)
+    json_loader = staticmethod(_jsonloads)
+
+    operations = MappingProxyType({
+        'remove': RemoveOperation,
+        'add': AddOperation,
+        'replace': ReplaceOperation,
+        'move': MoveOperation,
+        'test': TestOperation,
+        'copy': CopyOperation,
+    })
+
+    """A JSON Patch is a list of Patch Operations.
+
+    >>> patch = JsonPatch([
+    ...     {'op': 'add', 'path': '/foo', 'value': 'bar'},
+    ...     {'op': 'add', 'path': '/baz', 'value': [1, 2, 3]},
+    ...     {'op': 'remove', 'path': '/baz/1'},
+    ...     {'op': 'test', 'path': '/baz', 'value': [1, 3]},
+    ...     {'op': 'replace', 'path': '/baz/0', 'value': 42},
+    ...     {'op': 'remove', 'path': '/baz/1'},
+    ... ])
+    >>> doc = {}
+    >>> result = patch.apply(doc)
+    >>> expected = {'foo': 'bar', 'baz': [42]}
+    >>> result == expected
+    True
+
+    JsonPatch object is iterable, so you can easily access each patch
+    statement in a loop:
+
+    >>> lpatch = list(patch)
+    >>> expected = {'op': 'add', 'path': '/foo', 'value': 'bar'}
+    >>> lpatch[0] == expected
+    True
+    >>> lpatch == patch.patch
+    True
+
+    Also JsonPatch could be converted directly to :class:`bool` if it contains
+    any operation statements:
+
+    >>> bool(patch)
+    True
+    >>> bool(JsonPatch([]))
+    False
+
+    This behavior is very handy with :func:`make_patch` to write more readable
+    code:
+
+    >>> old = {'foo': 'bar', 'numbers': [1, 3, 4, 8]}
+    >>> new = {'baz': 'qux', 'numbers': [1, 4, 7]}
+    >>> patch = make_patch(old, new)
+    >>> if patch:
+    ...     # document have changed, do something useful
+    ...     patch.apply(old)    #doctest: +ELLIPSIS
+    {...}
+    """
+    def __init__(self, patch, pointer_cls=JsonPointer):
+        self.patch = patch
+        self.pointer_cls = pointer_cls
+
+        # Verify that the structure of the patch document
+        # is correct by retrieving each patch element.
+        # Much of the validation is done in the initializer
+        # though some is delayed until the patch is applied.
+        for op in self.patch:
+            # We're only checking for basestring in the following check
+            # for two reasons:
+            #
+            # - It should come from JSON, which only allows strings as
+            #   dictionary keys, so having a string here unambiguously means
+            #   someone used: {"op": ..., ...} instead of [{"op": ..., ...}].
+            #
+            # - There's no possible false positive: if someone give a sequence
+            #   of mappings, this won't raise.
+            if isinstance(op, basestring):
+                raise InvalidJsonPatch("Document is expected to be sequence of "
+                                       "operations, got a sequence of strings.")
+
+            self._get_operation(op)
+
+    def __str__(self):
+        """str(self) -> self.to_string()"""
+        return self.to_string()
+
+    def __bool__(self):
+        return bool(self.patch)
+
+    __nonzero__ = __bool__
+
+    def __iter__(self):
+        return iter(self.patch)
+
+    def __hash__(self):
+        return hash(tuple(self._ops))
+
+    def __eq__(self, other):
+        if not isinstance(other, JsonPatch):
+            return False
+        return self._ops == other._ops
+
+    def __ne__(self, other):
+        return not(self == other)
+
+    @classmethod
+    def from_string(cls, patch_str, loads=None, pointer_cls=JsonPointer):
+        """Creates JsonPatch instance from string source.
+
+        :param patch_str: JSON patch as raw string.
+        :type patch_str: str
+
+        :param loads: A function of one argument that loads a serialized
+                      JSON string.
+        :type loads: function
+
+        :param pointer_cls: JSON pointer class to use.
+        :type pointer_cls: Type[JsonPointer]
+
+        :return: :class:`JsonPatch` instance.
+        """
+        json_loader = loads or cls.json_loader
+        patch = json_loader(patch_str)
+        return cls(patch, pointer_cls=pointer_cls)
+
+    @classmethod
+    def from_diff(
+            cls, src, dst, optimization=True, dumps=None,
+            pointer_cls=JsonPointer,
+    ):
+        """Creates JsonPatch instance based on comparison of two document
+        objects. Json patch would be created for `src` argument against `dst`
+        one.
+
+        :param src: Data source document object.
+        :type src: dict
+
+        :param dst: Data source document object.
+        :type dst: dict
+
+        :param dumps: A function of one argument that produces a serialized
+                      JSON string.
+        :type dumps: function
+
+        :param pointer_cls: JSON pointer class to use.
+        :type pointer_cls: Type[JsonPointer]
+
+        :return: :class:`JsonPatch` instance.
+
+        >>> src = {'foo': 'bar', 'numbers': [1, 3, 4, 8]}
+        >>> dst = {'baz': 'qux', 'numbers': [1, 4, 7]}
+        >>> patch = JsonPatch.from_diff(src, dst)
+        >>> new = patch.apply(src)
+        >>> new == dst
+        True
+        """
+        json_dumper = dumps or cls.json_dumper
+        builder = DiffBuilder(src, dst, json_dumper, pointer_cls=pointer_cls)
+        builder._compare_values('', None, src, dst)
+        ops = list(builder.execute())
+        return cls(ops, pointer_cls=pointer_cls)
+
+    def to_string(self, dumps=None):
+        """Returns patch set as JSON string."""
+        json_dumper = dumps or self.json_dumper
+        return json_dumper(self.patch)
+
+    @property
+    def _ops(self):
+        return tuple(map(self._get_operation, self.patch))
+
+    def apply(self, obj, in_place=False):
+        """Applies the patch to a given object.
+
+        :param obj: Document object.
+        :type obj: dict
+
+        :param in_place: Tweaks the way how patch would be applied - directly to
+                         specified `obj` or to its copy.
+        :type in_place: bool
+
+        :return: Modified `obj`.
+        """
+
+        if not in_place:
+            obj = copy.deepcopy(obj)
+
+        for operation in self._ops:
+            obj = operation.apply(obj)
+
+        return obj
+
+    def _get_operation(self, operation):
+        if 'op' not in operation:
+            raise InvalidJsonPatch("Operation does not contain 'op' member")
+
+        op = operation['op']
+
+        if not isinstance(op, basestring):
+            raise InvalidJsonPatch("Operation's op must be a string")
+
+        if op not in self.operations:
+            raise InvalidJsonPatch("Unknown operation {0!r}".format(op))
+
+        cls = self.operations[op]
+        return cls(operation, pointer_cls=self.pointer_cls)
+
+
+class DiffBuilder(object):
+
+    def __init__(self, src_doc, dst_doc, dumps=json.dumps, pointer_cls=JsonPointer):
+        self.dumps = dumps
+        self.pointer_cls = pointer_cls
+        self.index_storage = [{}, {}]
+        self.index_storage2 = [[], []]
+        self.__root = root = []
+        self.src_doc = src_doc
+        self.dst_doc = dst_doc
+        root[:] = [root, root, None]
+
+    def store_index(self, value, index, st):
+        typed_key = (value, type(value))
+        try:
+            storage = self.index_storage[st]
+            stored = storage.get(typed_key)
+            if stored is None:
+                storage[typed_key] = [index]
+            else:
+                storage[typed_key].append(index)
+
+        except TypeError:
+            self.index_storage2[st].append((typed_key, index))
+
+    def take_index(self, value, st):
+        typed_key = (value, type(value))
+        try:
+            stored = self.index_storage[st].get(typed_key)
+            if stored:
+                return stored.pop()
+
+        except TypeError:
+            storage = self.index_storage2[st]
+            for i in range(len(storage)-1, -1, -1):
+                if storage[i][0] == typed_key:
+                    return storage.pop(i)[1]
+
+    def insert(self, op):
+        root = self.__root
+        last = root[0]
+        last[1] = root[0] = [last, root, op]
+        return root[0]
+
+    def remove(self, index):
+        link_prev, link_next, _ = index
+        link_prev[1] = link_next
+        link_next[0] = link_prev
+        index[:] = []
+
+    def iter_from(self, start):
+        root = self.__root
+        curr = start[1]
+        while curr is not root:
+            yield curr[2]
+            curr = curr[1]
+
+    def __iter__(self):
+        root = self.__root
+        curr = root[1]
+        while curr is not root:
+            yield curr[2]
+            curr = curr[1]
+
+    def execute(self):
+        root = self.__root
+        curr = root[1]
+        while curr is not root:
+            if curr[1] is not root:
+                op_first, op_second = curr[2], curr[1][2]
+                if op_first.location == op_second.location and \
+                        type(op_first) == RemoveOperation and \
+                        type(op_second) == AddOperation:
+                    yield ReplaceOperation({
+                        'op': 'replace',
+                        'path': op_second.location,
+                        'value': op_second.operation['value'],
+                    }, pointer_cls=self.pointer_cls).operation
+                    curr = curr[1][1]
+                    continue
+
+            yield curr[2].operation
+            curr = curr[1]
+
+    def _item_added(self, path, key, item):
+        index = self.take_index(item, _ST_REMOVE)
+        if index is not None:
+            op = index[2]
+            if type(op.key) == int and type(key) == int:
+                for v in self.iter_from(index):
+                    op.key = v._on_undo_remove(op.path, op.key)
+
+            self.remove(index)
+            if op.location != _path_join(path, key):
+                new_op = MoveOperation({
+                    'op': 'move',
+                    'from': op.location,
+                    'path': _path_join(path, key),
+                }, pointer_cls=self.pointer_cls)
+                self.insert(new_op)
+        else:
+            new_op = AddOperation({
+                'op': 'add',
+                'path': _path_join(path, key),
+                'value': item,
+            }, pointer_cls=self.pointer_cls)
+            new_index = self.insert(new_op)
+            self.store_index(item, new_index, _ST_ADD)
+
+    def _item_removed(self, path, key, item):
+        new_op = RemoveOperation({
+            'op': 'remove',
+            'path': _path_join(path, key),
+        }, pointer_cls=self.pointer_cls)
+        index = self.take_index(item, _ST_ADD)
+        new_index = self.insert(new_op)
+        if index is not None:
+            op = index[2]
+            # We can't rely on the op.key type since PatchOperation casts
+            # the .key property to int and this path wrongly ends up being taken
+            # for numeric string dict keys while the intention is to only handle lists.
+            # So we do an explicit check on the item affected by the op instead.
+            added_item = op.pointer.to_last(self.dst_doc)[0]
+            if type(added_item) == list:
+                for v in self.iter_from(index):
+                    op.key = v._on_undo_add(op.path, op.key)
+
+            self.remove(index)
+            if new_op.location != op.location:
+                new_op = MoveOperation({
+                    'op': 'move',
+                    'from': new_op.location,
+                    'path': op.location,
+                }, pointer_cls=self.pointer_cls)
+                new_index[2] = new_op
+
+            else:
+                self.remove(new_index)
+
+        else:
+            self.store_index(item, new_index, _ST_REMOVE)
+
+    def _item_replaced(self, path, key, item):
+        self.insert(ReplaceOperation({
+            'op': 'replace',
+            'path': _path_join(path, key),
+            'value': item,
+        }, pointer_cls=self.pointer_cls))
+
+    def _compare_dicts(self, path, src, dst):
+        src_keys = set(src.keys())
+        dst_keys = set(dst.keys())
+        added_keys = dst_keys - src_keys
+        removed_keys = src_keys - dst_keys
+
+        for key in removed_keys:
+            self._item_removed(path, str(key), src[key])
+
+        for key in added_keys:
+            self._item_added(path, str(key), dst[key])
+
+        for key in src_keys & dst_keys:
+            self._compare_values(path, key, src[key], dst[key])
+
+    def _compare_lists(self, path, src, dst):
+        len_src, len_dst = len(src), len(dst)
+        max_len = max(len_src, len_dst)
+        min_len = min(len_src, len_dst)
+        for key in range(max_len):
+            if key < min_len:
+                old, new = src[key], dst[key]
+                if old == new:
+                    continue
+
+                elif isinstance(old, MutableMapping) and \
+                    isinstance(new, MutableMapping):
+                    self._compare_dicts(_path_join(path, key), old, new)
+
+                elif isinstance(old, MutableSequence) and \
+                        isinstance(new, MutableSequence):
+                    self._compare_lists(_path_join(path, key), old, new)
+
+                else:
+                    self._item_removed(path, key, old)
+                    self._item_added(path, key, new)
+
+            elif len_src > len_dst:
+                self._item_removed(path, len_dst, src[key])
+
+            else:
+                self._item_added(path, key, dst[key])
+
+    def _compare_values(self, path, key, src, dst):
+        if isinstance(src, MutableMapping) and \
+                isinstance(dst, MutableMapping):
+            self._compare_dicts(_path_join(path, key), src, dst)
+
+        elif isinstance(src, MutableSequence) and \
+                isinstance(dst, MutableSequence):
+            self._compare_lists(_path_join(path, key), src, dst)
+
+        # To ensure we catch changes to JSON, we can't rely on a simple
+        # src == dst, because it would not recognize the difference between
+        # 1 and True, among other things. Using json.dumps is the most
+        # fool-proof way to ensure we catch type changes that matter to JSON
+        # and ignore those that don't. The performance of this could be
+        # improved by doing more direct type checks, but we'd need to be
+        # careful to accept type changes that don't matter when JSONified.
+        elif self.dumps(src) == self.dumps(dst):
+            return
+
+        else:
+            self._item_replaced(path, key, dst)
+
+
+def _path_join(path, key):
+    if key is None:
+        return path
+
+    return path + '/' + str(key).replace('~', '~0').replace('/', '~1')
diff --git a/llm/Lib/site-packages/jsonpointer-2.4.dist-info/AUTHORS b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/AUTHORS
new file mode 100644
index 0000000000000000000000000000000000000000..8319fec44d8e4d467b2e4827738b91ff706f93d5
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/AUTHORS
@@ -0,0 +1,3 @@
+Stefan Kögl <stefan@skoegl.net>
+Alexander Shorin <kxepal@gmail.com>
+Christopher J. White <chris@grierwhite.com>
diff --git a/llm/Lib/site-packages/jsonpointer-2.4.dist-info/INSTALLER b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/jsonpointer-2.4.dist-info/LICENSE.txt b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..491196d773493c591f1287107c3d368f2f8263d3
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/LICENSE.txt
@@ -0,0 +1,26 @@
+Copyright (c) 2011 Stefan Kögl <stefan@skoegl.net>
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. The name of the author may not be used to endorse or promote products
+   derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
diff --git a/llm/Lib/site-packages/jsonpointer-2.4.dist-info/METADATA b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..9fc5dbb2ec15d2557fac84d26e78eb12f7dc7a76
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/METADATA
@@ -0,0 +1,56 @@
+Metadata-Version: 2.1
+Name: jsonpointer
+Version: 2.4
+Summary: Identify specific nodes in a JSON document (RFC 6901) 
+Home-page: https://github.com/stefankoegl/python-json-pointer
+Author: Stefan Kögl
+Author-email: stefan@skoegl.net
+License: Modified BSD License
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, !=3.6.*
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+License-File: AUTHORS
+
+python-json-pointer
+===================
+
+[![PyPI version](https://img.shields.io/pypi/v/jsonpointer.svg)](https://pypi.python.org/pypi/jsonpointer/)
+[![Supported Python versions](https://img.shields.io/pypi/pyversions/jsonpointer.svg)](https://pypi.python.org/pypi/jsonpointer/)
+[![Build Status](https://travis-ci.org/stefankoegl/python-json-pointer.svg?branch=master)](https://travis-ci.org/stefankoegl/python-json-pointer)
+[![Coverage Status](https://coveralls.io/repos/stefankoegl/python-json-pointer/badge.svg?branch=master)](https://coveralls.io/r/stefankoegl/python-json-pointer?branch=master)
+
+
+Resolve JSON Pointers in Python
+-------------------------------
+
+Library to resolve JSON Pointers according to
+[RFC 6901](http://tools.ietf.org/html/rfc6901)
+
+See source code for examples
+* Website: https://github.com/stefankoegl/python-json-pointer
+* Repository: https://github.com/stefankoegl/python-json-pointer.git
+* Documentation: https://python-json-pointer.readthedocs.org/
+* PyPI: https://pypi.python.org/pypi/jsonpointer
+* Travis CI: https://travis-ci.org/stefankoegl/python-json-pointer
+* Coveralls: https://coveralls.io/r/stefankoegl/python-json-pointer
+
+
diff --git a/llm/Lib/site-packages/jsonpointer-2.4.dist-info/RECORD b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..f9d9fe26cc1996ee3b75e8d17000e322721ed691
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/RECORD
@@ -0,0 +1,10 @@
+../../Scripts/jsonpointer,sha256=2iTL_tWjHBasJnYx5wlDJ0OeKV0W11hqZjJhtUdqOiU,1852
+__pycache__/jsonpointer.cpython-311.pyc,,
+jsonpointer-2.4.dist-info/AUTHORS,sha256=TVgxnQ9ZyHvvWwez_k2w8ZwtfVVFsDTGv3tXyJu-9X8,113
+jsonpointer-2.4.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+jsonpointer-2.4.dist-info/LICENSE.txt,sha256=2LJPFdRyiF94ii1umFhQ8mRie4YBKhe7JCyD8xDZB-U,1413
+jsonpointer-2.4.dist-info/METADATA,sha256=do16UoPF49C7cntyAXlrHS9ayuCihrNU6o-H_ZBPxDE,2525
+jsonpointer-2.4.dist-info/RECORD,,
+jsonpointer-2.4.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
+jsonpointer-2.4.dist-info/top_level.txt,sha256=BsUcar_C0nZzPGV2ackrJ9CpVU8_0W_pHYKwpdnWddM,12
+jsonpointer.py,sha256=t0WK4KRBvY5Xg3m4oPD0uFHUcbpOs0UIYfJ3HR4pmr4,10964
diff --git a/llm/Lib/site-packages/jsonpointer-2.4.dist-info/WHEEL b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..0b18a281107a0448a9980396d9d324ea2aa7a7f8
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.37.1)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/llm/Lib/site-packages/jsonpointer-2.4.dist-info/top_level.txt b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..5d4375536666f86a4a1cbd7467fff002705c7d36
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpointer-2.4.dist-info/top_level.txt
@@ -0,0 +1 @@
+jsonpointer
diff --git a/llm/Lib/site-packages/jsonpointer.py b/llm/Lib/site-packages/jsonpointer.py
new file mode 100644
index 0000000000000000000000000000000000000000..47d90ad8dc29d601f8a91e94646657f8146a4020
--- /dev/null
+++ b/llm/Lib/site-packages/jsonpointer.py
@@ -0,0 +1,366 @@
+# -*- coding: utf-8 -*-
+#
+# python-json-pointer - An implementation of the JSON Pointer syntax
+# https://github.com/stefankoegl/python-json-pointer
+#
+# Copyright (c) 2011 Stefan Kögl <stefan@skoegl.net>
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+#
+# 1. Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution.
+# 3. The name of the author may not be used to endorse or promote products
+# derived from this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+
+""" Identify specific nodes in a JSON document (RFC 6901) """
+
+from __future__ import unicode_literals
+
+# Will be parsed by setup.py to determine package metadata
+__author__ = 'Stefan Kögl <stefan@skoegl.net>'
+__version__ = '2.4'
+__website__ = 'https://github.com/stefankoegl/python-json-pointer'
+__license__ = 'Modified BSD License'
+
+
+try:
+    from itertools import izip
+    str = unicode
+    encode_str = lambda u: u.encode("raw_unicode_escape")
+except ImportError:  # Python 3
+    izip = zip
+    encode_str = lambda u: u
+
+try:
+    from collections.abc import Mapping, Sequence
+except ImportError:  # Python 3
+    from collections import Mapping, Sequence
+
+from itertools import tee, chain
+import re
+import copy
+
+
+_nothing = object()
+
+
+def set_pointer(doc, pointer, value, inplace=True):
+    """Resolves pointer against doc and sets the value of the target within doc.
+
+    With inplace set to true, doc is modified as long as pointer is not the
+    root.
+
+    >>> obj = {'foo': {'anArray': [ {'prop': 44}], 'another prop': {'baz': 'A string' }}}
+
+    >>> set_pointer(obj, '/foo/anArray/0/prop', 55) == \
+    {'foo': {'another prop': {'baz': 'A string'}, 'anArray': [{'prop': 55}]}}
+    True
+
+    >>> set_pointer(obj, '/foo/yet another prop', 'added prop') == \
+    {'foo': {'another prop': {'baz': 'A string'}, 'yet another prop': 'added prop', 'anArray': [{'prop': 55}]}}
+    True
+
+    >>> obj = {'foo': {}}
+    >>> set_pointer(obj, '/foo/a%20b', 'x') == \
+    {'foo': {'a%20b': 'x' }}
+    True
+    """
+
+    pointer = JsonPointer(pointer)
+    return pointer.set(doc, value, inplace)
+
+
+def resolve_pointer(doc, pointer, default=_nothing):
+    """ Resolves pointer against doc and returns the referenced object
+
+    >>> obj = {'foo': {'anArray': [ {'prop': 44}], 'another prop': {'baz': 'A string' }}, 'a%20b': 1, 'c d': 2}
+
+    >>> resolve_pointer(obj, '') == obj
+    True
+
+    >>> resolve_pointer(obj, '/foo') == obj['foo']
+    True
+
+    >>> resolve_pointer(obj, '/foo/another prop') == obj['foo']['another prop']
+    True
+
+    >>> resolve_pointer(obj, '/foo/another prop/baz') == obj['foo']['another prop']['baz']
+    True
+
+    >>> resolve_pointer(obj, '/foo/anArray/0') == obj['foo']['anArray'][0]
+    True
+
+    >>> resolve_pointer(obj, '/some/path', None) == None
+    True
+
+    >>> resolve_pointer(obj, '/a b', None) == None
+    True
+
+    >>> resolve_pointer(obj, '/a%20b') == 1
+    True
+
+    >>> resolve_pointer(obj, '/c d') == 2
+    True
+
+    >>> resolve_pointer(obj, '/c%20d', None) == None
+    True
+    """
+
+    pointer = JsonPointer(pointer)
+    return pointer.resolve(doc, default)
+
+
+def pairwise(iterable):
+    """ Transforms a list to a list of tuples of adjacent items
+
+    s -> (s0,s1), (s1,s2), (s2, s3), ...
+
+    >>> list(pairwise([]))
+    []
+
+    >>> list(pairwise([1]))
+    []
+
+    >>> list(pairwise([1, 2, 3, 4]))
+    [(1, 2), (2, 3), (3, 4)]
+    """
+    a, b = tee(iterable)
+    for _ in b:
+        break
+    return izip(a, b)
+
+
+class JsonPointerException(Exception):
+    pass
+
+
+class EndOfList(object):
+    """Result of accessing element "-" of a list"""
+
+    def __init__(self, list_):
+        self.list_ = list_
+
+    def __repr__(self):
+        return '{cls}({lst})'.format(cls=self.__class__.__name__,
+                                     lst=repr(self.list_))
+
+
+class JsonPointer(object):
+    """A JSON Pointer that can reference parts of a JSON document"""
+
+    # Array indices must not contain:
+    # leading zeros, signs, spaces, decimals, etc
+    _RE_ARRAY_INDEX = re.compile('0|[1-9][0-9]*$')
+    _RE_INVALID_ESCAPE = re.compile('(~[^01]|~$)')
+
+    def __init__(self, pointer):
+
+        # validate escapes
+        invalid_escape = self._RE_INVALID_ESCAPE.search(pointer)
+        if invalid_escape:
+            raise JsonPointerException('Found invalid escape {}'.format(
+                invalid_escape.group()))
+
+        parts = pointer.split('/')
+        if parts.pop(0) != '':
+            raise JsonPointerException('Location must start with /')
+
+        parts = [unescape(part) for part in parts]
+        self.parts = parts
+
+    def to_last(self, doc):
+        """Resolves ptr until the last step, returns (sub-doc, last-step)"""
+
+        if not self.parts:
+            return doc, None
+
+        for part in self.parts[:-1]:
+            doc = self.walk(doc, part)
+
+        return doc, JsonPointer.get_part(doc, self.parts[-1])
+
+    def resolve(self, doc, default=_nothing):
+        """Resolves the pointer against doc and returns the referenced object"""
+
+        for part in self.parts:
+
+            try:
+                doc = self.walk(doc, part)
+            except JsonPointerException:
+                if default is _nothing:
+                    raise
+                else:
+                    return default
+
+        return doc
+
+    get = resolve
+
+    def set(self, doc, value, inplace=True):
+        """Resolve the pointer against the doc and replace the target with value."""
+
+        if len(self.parts) == 0:
+            if inplace:
+                raise JsonPointerException('Cannot set root in place')
+            return value
+
+        if not inplace:
+            doc = copy.deepcopy(doc)
+
+        (parent, part) = self.to_last(doc)
+
+        if isinstance(parent, Sequence) and part == '-':
+            parent.append(value)
+        else:
+            parent[part] = value
+
+        return doc
+
+    @classmethod
+    def get_part(cls, doc, part):
+        """Returns the next step in the correct type"""
+
+        if isinstance(doc, Mapping):
+            return part
+
+        elif isinstance(doc, Sequence):
+
+            if part == '-':
+                return part
+
+            if not JsonPointer._RE_ARRAY_INDEX.match(str(part)):
+                raise JsonPointerException("'%s' is not a valid sequence index" % part)
+
+            return int(part)
+
+        elif hasattr(doc, '__getitem__'):
+            # Allow indexing via ducktyping
+            # if the target has defined __getitem__
+            return part
+
+        else:
+            raise JsonPointerException("Document '%s' does not support indexing, "
+                                       "must be mapping/sequence or support __getitem__" % type(doc))
+            
+    def get_parts(self):
+        """Returns the list of the parts. For example, JsonPointer('/a/b').get_parts() == ['a', 'b']"""
+        
+        return self.parts
+
+
+    def walk(self, doc, part):
+        """ Walks one step in doc and returns the referenced part """
+
+        part = JsonPointer.get_part(doc, part)
+
+        assert hasattr(doc, '__getitem__'), "invalid document type %s" % (type(doc),)
+
+        if isinstance(doc, Sequence):
+            if part == '-':
+                return EndOfList(doc)
+
+            try:
+                return doc[part]
+
+            except IndexError:
+                raise JsonPointerException("index '%s' is out of bounds" % (part, ))
+
+        # Else the object is a mapping or supports __getitem__(so assume custom indexing)
+        try:
+            return doc[part]
+
+        except KeyError:
+            raise JsonPointerException("member '%s' not found in %s" % (part, doc))
+
+
+    def contains(self, ptr):
+        """ Returns True if self contains the given ptr """
+        return self.parts[:len(ptr.parts)] == ptr.parts
+
+    def __contains__(self, item):
+        """ Returns True if self contains the given ptr """
+        return self.contains(item)
+
+    def join(self, suffix):
+        """ Returns a new JsonPointer with the given suffix append to this ptr """
+        if isinstance(suffix, JsonPointer):
+            suffix_parts = suffix.parts
+        elif isinstance(suffix, str):
+            suffix_parts = JsonPointer(suffix).parts
+        else:
+            suffix_parts = suffix
+        try:
+            return JsonPointer.from_parts(chain(self.parts, suffix_parts))
+        except:
+            raise JsonPointerException("Invalid suffix")
+
+    def __truediv__(self, suffix): # Python 3
+        return self.join(suffix)
+    __div__ = __truediv__ # Python 2
+
+    @property
+    def path(self):
+        """Returns the string representation of the pointer
+
+        >>> ptr = JsonPointer('/~0/0/~1').path == '/~0/0/~1'
+        """
+        parts = [escape(part) for part in self.parts]
+        return ''.join('/' + part for part in parts)
+
+    def __eq__(self, other):
+        """Compares a pointer to another object
+
+        Pointers can be compared by comparing their strings (or splitted
+        strings), because no two different parts can point to the same
+        structure in an object (eg no different number representations)
+        """
+
+        if not isinstance(other, JsonPointer):
+            return False
+
+        return self.parts == other.parts
+
+    def __hash__(self):
+        return hash(tuple(self.parts))
+
+    def __str__(self):
+        return encode_str(self.path)
+
+    def __repr__(self):
+        return "JsonPointer(" + repr(self.path) + ")"
+
+    @classmethod
+    def from_parts(cls, parts):
+        """Constructs a JsonPointer from a list of (unescaped) paths
+
+        >>> JsonPointer.from_parts(['a', '~', '/', 0]).path == '/a/~0/~1/0'
+        True
+        """
+        parts = [escape(str(part)) for part in parts]
+        ptr = cls(''.join('/' + part for part in parts))
+        return ptr
+
+
+def escape(s):
+    return s.replace('~', '~0').replace('/', '~1')
+
+def unescape(s):
+    return s.replace('~1', '/').replace('~0', '~')
diff --git a/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/INSTALLER b/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/METADATA b/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..3f0ec196109305e052ec4e37b6829aaca101c0ec
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/METADATA
@@ -0,0 +1,175 @@
+Metadata-Version: 2.1
+Name: jsonschema
+Version: 4.21.1
+Summary: An implementation of JSON Schema validation for Python
+Project-URL: Homepage, https://github.com/python-jsonschema/jsonschema
+Project-URL: Documentation, https://python-jsonschema.readthedocs.io/
+Project-URL: Issues, https://github.com/python-jsonschema/jsonschema/issues/
+Project-URL: Funding, https://github.com/sponsors/Julian
+Project-URL: Tidelift, https://tidelift.com/subscription/pkg/pypi-jsonschema?utm_source=pypi-jsonschema&utm_medium=referral&utm_campaign=pypi-link
+Project-URL: Changelog, https://github.com/python-jsonschema/jsonschema/blob/main/CHANGELOG.rst
+Project-URL: Source, https://github.com/python-jsonschema/jsonschema
+Author: Julian Berman
+Author-email: Julian+jsonschema@GrayVines.com
+License: MIT
+License-File: COPYING
+Keywords: data validation,json,json schema,jsonschema,validation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: File Formats :: JSON
+Classifier: Topic :: File Formats :: JSON :: JSON Schema
+Requires-Python: >=3.8
+Requires-Dist: attrs>=22.2.0
+Requires-Dist: importlib-resources>=1.4.0; python_version < '3.9'
+Requires-Dist: jsonschema-specifications>=2023.03.6
+Requires-Dist: pkgutil-resolve-name>=1.3.10; python_version < '3.9'
+Requires-Dist: referencing>=0.28.4
+Requires-Dist: rpds-py>=0.7.1
+Provides-Extra: format
+Requires-Dist: fqdn; extra == 'format'
+Requires-Dist: idna; extra == 'format'
+Requires-Dist: isoduration; extra == 'format'
+Requires-Dist: jsonpointer>1.13; extra == 'format'
+Requires-Dist: rfc3339-validator; extra == 'format'
+Requires-Dist: rfc3987; extra == 'format'
+Requires-Dist: uri-template; extra == 'format'
+Requires-Dist: webcolors>=1.11; extra == 'format'
+Provides-Extra: format-nongpl
+Requires-Dist: fqdn; extra == 'format-nongpl'
+Requires-Dist: idna; extra == 'format-nongpl'
+Requires-Dist: isoduration; extra == 'format-nongpl'
+Requires-Dist: jsonpointer>1.13; extra == 'format-nongpl'
+Requires-Dist: rfc3339-validator; extra == 'format-nongpl'
+Requires-Dist: rfc3986-validator>0.1.0; extra == 'format-nongpl'
+Requires-Dist: uri-template; extra == 'format-nongpl'
+Requires-Dist: webcolors>=1.11; extra == 'format-nongpl'
+Description-Content-Type: text/x-rst
+
+==========
+jsonschema
+==========
+
+|PyPI| |Pythons| |CI| |ReadTheDocs| |Precommit| |Zenodo|
+
+.. |PyPI| image:: https://img.shields.io/pypi/v/jsonschema.svg
+   :alt: PyPI version
+   :target: https://pypi.org/project/jsonschema/
+
+.. |Pythons| image:: https://img.shields.io/pypi/pyversions/jsonschema.svg
+   :alt: Supported Python versions
+   :target: https://pypi.org/project/jsonschema/
+
+.. |CI| image:: https://github.com/python-jsonschema/jsonschema/workflows/CI/badge.svg
+  :alt: Build status
+  :target: https://github.com/python-jsonschema/jsonschema/actions?query=workflow%3ACI
+
+.. |ReadTheDocs| image:: https://readthedocs.org/projects/python-jsonschema/badge/?version=stable&style=flat
+   :alt: ReadTheDocs status
+   :target: https://python-jsonschema.readthedocs.io/en/stable/
+
+.. |Precommit| image:: https://results.pre-commit.ci/badge/github/python-jsonschema/jsonschema/main.svg
+   :alt: pre-commit.ci status
+   :target: https://results.pre-commit.ci/latest/github/python-jsonschema/jsonschema/main
+
+.. |Zenodo| image:: https://zenodo.org/badge/3072629.svg
+   :alt: Zenodo DOI
+   :target: https://zenodo.org/badge/latestdoi/3072629
+
+
+``jsonschema`` is an implementation of the `JSON Schema <https://json-schema.org>`_ specification for Python.
+
+.. code:: python
+
+    >>> from jsonschema import validate
+
+    >>> # A sample schema, like what we'd get from json.load()
+    >>> schema = {
+    ...     "type" : "object",
+    ...     "properties" : {
+    ...         "price" : {"type" : "number"},
+    ...         "name" : {"type" : "string"},
+    ...     },
+    ... }
+
+    >>> # If no exception is raised by validate(), the instance is valid.
+    >>> validate(instance={"name" : "Eggs", "price" : 34.99}, schema=schema)
+
+    >>> validate(
+    ...     instance={"name" : "Eggs", "price" : "Invalid"}, schema=schema,
+    ... )                                   # doctest: +IGNORE_EXCEPTION_DETAIL
+    Traceback (most recent call last):
+        ...
+    ValidationError: 'Invalid' is not of type 'number'
+
+It can also be used from the command line by installing `check-jsonschema <https://github.com/python-jsonschema/check-jsonschema>`_.
+
+Features
+--------
+
+* Full support for `Draft 2020-12 <https://python-jsonschema.readthedocs.io/en/latest/api/jsonschema/validators/#jsonschema.validators.Draft202012Validator>`_, `Draft 2019-09 <https://python-jsonschema.readthedocs.io/en/latest/api/jsonschema/validators/#jsonschema.validators.Draft201909Validator>`_, `Draft 7 <https://python-jsonschema.readthedocs.io/en/latest/api/jsonschema/validators/#jsonschema.validators.Draft7Validator>`_, `Draft 6 <https://python-jsonschema.readthedocs.io/en/latest/api/jsonschema/validators/#jsonschema.validators.Draft6Validator>`_, `Draft 4 <https://python-jsonschema.readthedocs.io/en/latest/api/jsonschema/validators/#jsonschema.validators.Draft4Validator>`_ and `Draft 3 <https://python-jsonschema.readthedocs.io/en/latest/api/jsonschema/validators/#jsonschema.validators.Draft3Validator>`_
+
+* `Lazy validation <https://python-jsonschema.readthedocs.io/en/latest/api/jsonschema/protocols/#jsonschema.protocols.Validator.iter_errors>`_ that can iteratively report *all* validation errors.
+
+* `Programmatic querying <https://python-jsonschema.readthedocs.io/en/latest/errors/>`_ of which properties or items failed validation.
+
+
+Installation
+------------
+
+``jsonschema`` is available on `PyPI <https://pypi.org/project/jsonschema/>`_. You can install using `pip <https://pip.pypa.io/en/stable/>`_:
+
+.. code:: bash
+
+    $ pip install jsonschema
+
+
+Extras
+======
+
+Two extras are available when installing the package, both currently related to ``format`` validation:
+
+    * ``format``
+    * ``format-nongpl``
+
+They can be used when installing in order to include additional dependencies, e.g.:
+
+.. code:: bash
+
+    $ pip install jsonschema'[format]'
+
+Be aware that the mere presence of these dependencies – or even the specification of ``format`` checks in a schema – do *not* activate format checks (as per the specification).
+Please read the `format validation documentation <https://python-jsonschema.readthedocs.io/en/latest/validate/#validating-formats>`_ for further details.
+
+About
+-----
+
+I'm Julian Berman.
+
+``jsonschema`` is on `GitHub <https://github.com/python-jsonschema/jsonschema>`_.
+
+Get in touch, via GitHub or otherwise, if you've got something to contribute, it'd be most welcome!
+
+You can also generally find me on Libera (nick: ``Julian``) in various channels, including ``#python``.
+
+If you feel overwhelmingly grateful, you can also `sponsor me <https://github.com/sponsors/Julian/>`_.
+
+And for companies who appreciate ``jsonschema`` and its continued support and growth, ``jsonschema`` is also now supportable via `TideLift <https://tidelift.com/subscription/pkg/pypi-jsonschema?utm_source=pypi-jsonschema&utm_medium=referral&utm_campaign=readme>`_.
+
+
+Release Information
+-------------------
+
+v4.21.1
+=======
+
+* Slightly speed up the ``contains`` keyword by removing some unnecessary validator (re-)creation.
diff --git a/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/RECORD b/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..0f8ee3890d0bc1cf3a0dc9f09289c0336f52a37a
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/RECORD
@@ -0,0 +1,70 @@
+../../Scripts/jsonschema.exe,sha256=h50eA58jsqo8ekisiT-dQztxY7YghIMpqrmoAIwuaBM,108381
+jsonschema-4.21.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+jsonschema-4.21.1.dist-info/METADATA,sha256=x2J7cuqnMmopRhlFHCtWMD1nQ3qiUpMqh0yz2cRTPT8,7831
+jsonschema-4.21.1.dist-info/RECORD,,
+jsonschema-4.21.1.dist-info/WHEEL,sha256=mRYSEL3Ih6g5a_CVMIcwiF__0Ae4_gLYh01YFNwiq1k,87
+jsonschema-4.21.1.dist-info/entry_points.txt,sha256=vO7rX4Fs_xIVJy2pnAtKgTSxfpnozAVQ0DjCmpMxnWE,51
+jsonschema-4.21.1.dist-info/licenses/COPYING,sha256=T5KgFaE8TRoEC-8BiqE0MLTxvHO0Gxa7hGw0Z2bedDk,1057
+jsonschema/__init__.py,sha256=LkPwscySlJ9lTOp7ZB1M7jQ8mbG7-bYG41iBwbZ-o9s,3941
+jsonschema/__main__.py,sha256=iLsZf2upUB3ilBKTlMnyK-HHt2Cnnfkwwxi_c6gLvSA,115
+jsonschema/__pycache__/__init__.cpython-311.pyc,,
+jsonschema/__pycache__/__main__.cpython-311.pyc,,
+jsonschema/__pycache__/_format.cpython-311.pyc,,
+jsonschema/__pycache__/_keywords.cpython-311.pyc,,
+jsonschema/__pycache__/_legacy_keywords.cpython-311.pyc,,
+jsonschema/__pycache__/_types.cpython-311.pyc,,
+jsonschema/__pycache__/_typing.cpython-311.pyc,,
+jsonschema/__pycache__/_utils.cpython-311.pyc,,
+jsonschema/__pycache__/cli.cpython-311.pyc,,
+jsonschema/__pycache__/exceptions.cpython-311.pyc,,
+jsonschema/__pycache__/protocols.cpython-311.pyc,,
+jsonschema/__pycache__/validators.cpython-311.pyc,,
+jsonschema/_format.py,sha256=zU9Bg18dn1u9f43ORXo6_zpcR92Tm1dz0UlYXjzjbgU,14710
+jsonschema/_keywords.py,sha256=r8_DrqAfn6QLwQnmXEggveiSU-UaIL2p2nuPINelfFc,14949
+jsonschema/_legacy_keywords.py,sha256=2tWuwRPWbYS7EAl8wBIC_rabGuv1J4dfYLqNEPpShhA,15191
+jsonschema/_types.py,sha256=WDFT49X-gQd4w5IbzpjZyhVdOtjC4swQ4uHaPmH5svw,5362
+jsonschema/_typing.py,sha256=NZhPhkBOn9INYZk8G69rDeuRamztgXCMLh10z9cfT6g,610
+jsonschema/_utils.py,sha256=z8rU2vVCYRi3XUV8bXVTw9RzgMkC74C9olPfaFh8-18,10602
+jsonschema/benchmarks/__init__.py,sha256=A0sQrxDBVHSyQ-8ru3L11hMXf3q9gVuB9x_YgHb4R9M,70
+jsonschema/benchmarks/__pycache__/__init__.cpython-311.pyc,,
+jsonschema/benchmarks/__pycache__/contains.cpython-311.pyc,,
+jsonschema/benchmarks/__pycache__/issue232.cpython-311.pyc,,
+jsonschema/benchmarks/__pycache__/json_schema_test_suite.cpython-311.pyc,,
+jsonschema/benchmarks/__pycache__/nested_schemas.cpython-311.pyc,,
+jsonschema/benchmarks/__pycache__/subcomponents.cpython-311.pyc,,
+jsonschema/benchmarks/__pycache__/unused_registry.cpython-311.pyc,,
+jsonschema/benchmarks/__pycache__/validator_creation.cpython-311.pyc,,
+jsonschema/benchmarks/contains.py,sha256=gexQoUrCOwECofbt19BeosQZ7WFL6PDdkX49DWwBlOg,786
+jsonschema/benchmarks/issue232.py,sha256=3LLYLIlBGQnVuyyo2iAv-xky5P6PRFHANx4-zIIQOoE,521
+jsonschema/benchmarks/issue232/issue.json,sha256=eaPOZjMRu5u8RpKrsA9uk7ucPZS5tkKG4D_hkOTQ3Hk,117105
+jsonschema/benchmarks/json_schema_test_suite.py,sha256=PvfabpUYcF4_7csYDTcTauED8rnFEGYbdY5RqTXD08s,320
+jsonschema/benchmarks/nested_schemas.py,sha256=mo07dx-CIgmSOI62CNs4g5xu1FzHklLBpkQoDxWYcKs,1892
+jsonschema/benchmarks/subcomponents.py,sha256=fEyiMzsWeK2pd7DEGCuuY-vzGunwhHczRBWEnBRLKIo,1113
+jsonschema/benchmarks/unused_registry.py,sha256=hwRwONc9cefPtYzkoX_TYRO3GyUojriv0-YQaK3vnj0,940
+jsonschema/benchmarks/validator_creation.py,sha256=UkUQlLAnussnr_KdCIdad6xx2pXxQLmYtsXoiirKeWQ,285
+jsonschema/cli.py,sha256=SGy9JPg02mgXhNxugU8iXhYNivfSjBhKTNAgV90ty-M,8551
+jsonschema/exceptions.py,sha256=4g6a74jSb_jnSyzmAOhxwPh3MYiQHFyrJlV8s7FFN6I,13977
+jsonschema/protocols.py,sha256=XXRIlsboM5lc0mxeMSUCQmrqtcGzSM5TuwfIKBB4RuQ,7169
+jsonschema/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+jsonschema/tests/__pycache__/__init__.cpython-311.pyc,,
+jsonschema/tests/__pycache__/_suite.cpython-311.pyc,,
+jsonschema/tests/__pycache__/fuzz_validate.cpython-311.pyc,,
+jsonschema/tests/__pycache__/test_cli.cpython-311.pyc,,
+jsonschema/tests/__pycache__/test_deprecations.cpython-311.pyc,,
+jsonschema/tests/__pycache__/test_exceptions.cpython-311.pyc,,
+jsonschema/tests/__pycache__/test_format.cpython-311.pyc,,
+jsonschema/tests/__pycache__/test_jsonschema_test_suite.cpython-311.pyc,,
+jsonschema/tests/__pycache__/test_types.cpython-311.pyc,,
+jsonschema/tests/__pycache__/test_utils.cpython-311.pyc,,
+jsonschema/tests/__pycache__/test_validators.cpython-311.pyc,,
+jsonschema/tests/_suite.py,sha256=rP6N9rGYrfWJCmPfiUbfodfQ0twqUJkk8sblGD7pzek,8097
+jsonschema/tests/fuzz_validate.py,sha256=fUA7yTJIihaCwJplkUehZeyB84HcXEcqtY5oPJXIO7I,1114
+jsonschema/tests/test_cli.py,sha256=uFMu2YbIfbSDCnykhLL4-VR3-jg1tvQLJn2Bliwp_Bw,28587
+jsonschema/tests/test_deprecations.py,sha256=9VxOCfWzMG1Tg4OD8riU_Znd6HDOQZkepzVgxsdUdU8,15760
+jsonschema/tests/test_exceptions.py,sha256=26l4I4luUt47m6CXpR2xXoZPcMAWGq7kbavJ1S8UiaU,20112
+jsonschema/tests/test_format.py,sha256=eVm5SMaWF2lOPO28bPAwNvkiQvHCQKy-MnuAgEchfEc,3188
+jsonschema/tests/test_jsonschema_test_suite.py,sha256=a2saPs2Cwwg0sdRdu-uJ8goSXLbqrS-pC48QJy0K4DE,8674
+jsonschema/tests/test_types.py,sha256=cF51KTDmdsx06MrIc4fXKt0X9fIsVgw5uhT8CamVa8U,6977
+jsonschema/tests/test_utils.py,sha256=lJRVYyQeZQTUCTU_M3BhlkxPMgjsc8KQCd7U_Qkook8,3749
+jsonschema/tests/test_validators.py,sha256=eiaigsZMzHYYsniQ1UPygaS56a1d-_7-9NC4wVXAhzs,87975
+jsonschema/validators.py,sha256=yT2oAenK3cRyhcTeHObvfCm0AWmPXhUC_idor_IIMwQ,46510
diff --git a/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/WHEEL b/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..2860816abecb3c5ad7da6d018a4334b87e6b6cfc
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.21.0
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/entry_points.txt b/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..eecef9d8fad351de6b048532776160696a796ef9
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/entry_points.txt
@@ -0,0 +1,2 @@
+[console_scripts]
+jsonschema = jsonschema.cli:main
diff --git a/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/licenses/COPYING b/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/licenses/COPYING
new file mode 100644
index 0000000000000000000000000000000000000000..af9cfbdb134f42e5205ecbad597421d778826481
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema-4.21.1.dist-info/licenses/COPYING
@@ -0,0 +1,19 @@
+Copyright (c) 2013 Julian Berman
+
+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
+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.
diff --git a/llm/Lib/site-packages/jsonschema/__init__.py b/llm/Lib/site-packages/jsonschema/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..79924cf7e51665d03295ecdb7d0930bdeb806d4f
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/__init__.py
@@ -0,0 +1,120 @@
+"""
+An implementation of JSON Schema for Python.
+
+The main functionality is provided by the validator classes for each of the
+supported JSON Schema versions.
+
+Most commonly, `jsonschema.validators.validate` is the quickest way to simply
+validate a given instance under a schema, and will create a validator
+for you.
+"""
+import warnings
+
+from jsonschema._format import FormatChecker
+from jsonschema._types import TypeChecker
+from jsonschema.exceptions import SchemaError, ValidationError
+from jsonschema.validators import (
+    Draft3Validator,
+    Draft4Validator,
+    Draft6Validator,
+    Draft7Validator,
+    Draft201909Validator,
+    Draft202012Validator,
+    validate,
+)
+
+
+def __getattr__(name):
+    if name == "__version__":
+        warnings.warn(
+            "Accessing jsonschema.__version__ is deprecated and will be "
+            "removed in a future release. Use importlib.metadata directly "
+            "to query for jsonschema's version.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+
+        from importlib import metadata
+        return metadata.version("jsonschema")
+    elif name == "RefResolver":
+        from jsonschema.validators import _RefResolver
+        warnings.warn(
+            _RefResolver._DEPRECATION_MESSAGE,
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return _RefResolver
+    elif name == "ErrorTree":
+        warnings.warn(
+            "Importing ErrorTree directly from the jsonschema package "
+            "is deprecated and will become an ImportError. Import it from "
+            "jsonschema.exceptions instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        from jsonschema.exceptions import ErrorTree
+        return ErrorTree
+    elif name == "FormatError":
+        warnings.warn(
+            "Importing FormatError directly from the jsonschema package "
+            "is deprecated and will become an ImportError. Import it from "
+            "jsonschema.exceptions instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        from jsonschema.exceptions import FormatError
+        return FormatError
+    elif name == "Validator":
+        warnings.warn(
+            "Importing Validator directly from the jsonschema package "
+            "is deprecated and will become an ImportError. Import it from "
+            "jsonschema.protocols instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        from jsonschema.protocols import Validator
+        return Validator
+    elif name == "RefResolutionError":
+        from jsonschema.exceptions import _RefResolutionError
+        warnings.warn(
+            _RefResolutionError._DEPRECATION_MESSAGE,
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return _RefResolutionError
+
+    format_checkers = {
+        "draft3_format_checker": Draft3Validator,
+        "draft4_format_checker": Draft4Validator,
+        "draft6_format_checker": Draft6Validator,
+        "draft7_format_checker": Draft7Validator,
+        "draft201909_format_checker": Draft201909Validator,
+        "draft202012_format_checker": Draft202012Validator,
+    }
+    ValidatorForFormat = format_checkers.get(name)
+    if ValidatorForFormat is not None:
+        warnings.warn(
+            f"Accessing jsonschema.{name} is deprecated and will be "
+            "removed in a future release. Instead, use the FORMAT_CHECKER "
+            "attribute on the corresponding Validator.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return ValidatorForFormat.FORMAT_CHECKER
+
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = [
+    "Draft201909Validator",
+    "Draft202012Validator",
+    "Draft3Validator",
+    "Draft4Validator",
+    "Draft6Validator",
+    "Draft7Validator",
+    "FormatChecker",
+    "SchemaError",
+    "TypeChecker",
+    "ValidationError",
+    "validate",
+]
diff --git a/llm/Lib/site-packages/jsonschema/__main__.py b/llm/Lib/site-packages/jsonschema/__main__.py
new file mode 100644
index 0000000000000000000000000000000000000000..fb260ae145d7518f8e8fa16ed13cc2c6173e7404
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/__main__.py
@@ -0,0 +1,6 @@
+"""
+The jsonschema CLI is now deprecated in favor of check-jsonschema.
+"""
+from jsonschema.cli import main
+
+main()
diff --git a/llm/Lib/site-packages/jsonschema/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ac152ba8716af0da13fd8bfd6db373dc269fb58c
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/__pycache__/__main__.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/__pycache__/__main__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..539253a1dcf88e7c1f497d260d26dfc7d3b376bd
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/__pycache__/__main__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/__pycache__/_format.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/__pycache__/_format.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e89b433306f58fda9e2dfa49b6b35dce96b4f625
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/__pycache__/_format.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/__pycache__/_keywords.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/__pycache__/_keywords.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8383c4fa6783e680551748010a0b8d9cb21f9d40
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/__pycache__/_keywords.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/__pycache__/_legacy_keywords.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/__pycache__/_legacy_keywords.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1aec3652db9adb319aae357aef8cb98076538ebf
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/__pycache__/_legacy_keywords.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/__pycache__/_types.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/__pycache__/_types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3d53f36b4e7d1888d23c7628085bef1e98750f17
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/__pycache__/_types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/__pycache__/_typing.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/__pycache__/_typing.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..842182288545d51fe367a60c56bc68d8a4dd8d1e
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/__pycache__/_typing.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/__pycache__/_utils.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/__pycache__/_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..34600aeb3d3cf6b65f4bd8b77a920b8e94bfd54a
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/__pycache__/_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/__pycache__/cli.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/__pycache__/cli.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3279af4fb0f5151534f4b3c9b4b7ae7c0dab33e0
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/__pycache__/cli.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..675fb232c64f69d1416f303c43f3b8b67e99c08f
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/__pycache__/protocols.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/__pycache__/protocols.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d2aa337770d3de9c27ce58eb9bd7d2e364263456
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/__pycache__/protocols.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/__pycache__/validators.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/__pycache__/validators.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..46c1e0a7332e2cc42a762e67d6c73e5d4e0782eb
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/__pycache__/validators.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/_format.py b/llm/Lib/site-packages/jsonschema/_format.py
new file mode 100644
index 0000000000000000000000000000000000000000..e5f5bb7cfa574c64d334767f02d6b77da051eb02
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/_format.py
@@ -0,0 +1,519 @@
+from __future__ import annotations
+
+from contextlib import suppress
+from datetime import date, datetime
+from uuid import UUID
+import ipaddress
+import re
+import typing
+import warnings
+
+from jsonschema.exceptions import FormatError
+
+_FormatCheckCallable = typing.Callable[[object], bool]
+#: A format checker callable.
+_F = typing.TypeVar("_F", bound=_FormatCheckCallable)
+_RaisesType = typing.Union[
+    typing.Type[Exception], typing.Tuple[typing.Type[Exception], ...],
+]
+
+_RE_DATE = re.compile(r"^\d{4}-\d{2}-\d{2}$", re.ASCII)
+
+
+class FormatChecker:
+    """
+    A ``format`` property checker.
+
+    JSON Schema does not mandate that the ``format`` property actually do any
+    validation. If validation is desired however, instances of this class can
+    be hooked into validators to enable format validation.
+
+    `FormatChecker` objects always return ``True`` when asked about
+    formats that they do not know how to validate.
+
+    To add a check for a custom format use the `FormatChecker.checks`
+    decorator.
+
+    Arguments:
+
+        formats:
+
+            The known formats to validate. This argument can be used to
+            limit which formats will be used during validation.
+    """
+
+    checkers: dict[
+        str,
+        tuple[_FormatCheckCallable, _RaisesType],
+    ] = {}  # noqa: RUF012
+
+    def __init__(self, formats: typing.Iterable[str] | None = None):
+        if formats is None:
+            formats = self.checkers.keys()
+        self.checkers = {k: self.checkers[k] for k in formats}
+
+    def __repr__(self):
+        return f"<FormatChecker checkers={sorted(self.checkers)}>"
+
+    def checks(
+        self, format: str, raises: _RaisesType = (),
+    ) -> typing.Callable[[_F], _F]:
+        """
+        Register a decorated function as validating a new format.
+
+        Arguments:
+
+            format:
+
+                The format that the decorated function will check.
+
+            raises:
+
+                The exception(s) raised by the decorated function when an
+                invalid instance is found.
+
+                The exception object will be accessible as the
+                `jsonschema.exceptions.ValidationError.cause` attribute of the
+                resulting validation error.
+        """
+
+        def _checks(func: _F) -> _F:
+            self.checkers[format] = (func, raises)
+            return func
+
+        return _checks
+
+    @classmethod
+    def cls_checks(
+        cls, format: str, raises: _RaisesType = (),
+    ) -> typing.Callable[[_F], _F]:
+        warnings.warn(
+            (
+                "FormatChecker.cls_checks is deprecated. Call "
+                "FormatChecker.checks on a specific FormatChecker instance "
+                "instead."
+            ),
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return cls._cls_checks(format=format, raises=raises)
+
+    @classmethod
+    def _cls_checks(
+        cls, format: str, raises: _RaisesType = (),
+    ) -> typing.Callable[[_F], _F]:
+        def _checks(func: _F) -> _F:
+            cls.checkers[format] = (func, raises)
+            return func
+
+        return _checks
+
+    def check(self, instance: object, format: str) -> None:
+        """
+        Check whether the instance conforms to the given format.
+
+        Arguments:
+
+            instance (*any primitive type*, i.e. str, number, bool):
+
+                The instance to check
+
+            format:
+
+                The format that instance should conform to
+
+        Raises:
+
+            FormatError:
+
+                if the instance does not conform to ``format``
+        """
+        if format not in self.checkers:
+            return
+
+        func, raises = self.checkers[format]
+        result, cause = None, None
+        try:
+            result = func(instance)
+        except raises as e:
+            cause = e
+        if not result:
+            raise FormatError(f"{instance!r} is not a {format!r}", cause=cause)
+
+    def conforms(self, instance: object, format: str) -> bool:
+        """
+        Check whether the instance conforms to the given format.
+
+        Arguments:
+
+            instance (*any primitive type*, i.e. str, number, bool):
+
+                The instance to check
+
+            format:
+
+                The format that instance should conform to
+
+        Returns:
+
+            bool: whether it conformed
+        """
+        try:
+            self.check(instance, format)
+        except FormatError:
+            return False
+        else:
+            return True
+
+
+draft3_format_checker = FormatChecker()
+draft4_format_checker = FormatChecker()
+draft6_format_checker = FormatChecker()
+draft7_format_checker = FormatChecker()
+draft201909_format_checker = FormatChecker()
+draft202012_format_checker = FormatChecker()
+
+_draft_checkers: dict[str, FormatChecker] = dict(
+    draft3=draft3_format_checker,
+    draft4=draft4_format_checker,
+    draft6=draft6_format_checker,
+    draft7=draft7_format_checker,
+    draft201909=draft201909_format_checker,
+    draft202012=draft202012_format_checker,
+)
+
+
+def _checks_drafts(
+    name=None,
+    draft3=None,
+    draft4=None,
+    draft6=None,
+    draft7=None,
+    draft201909=None,
+    draft202012=None,
+    raises=(),
+) -> typing.Callable[[_F], _F]:
+    draft3 = draft3 or name
+    draft4 = draft4 or name
+    draft6 = draft6 or name
+    draft7 = draft7 or name
+    draft201909 = draft201909 or name
+    draft202012 = draft202012 or name
+
+    def wrap(func: _F) -> _F:
+        if draft3:
+            func = _draft_checkers["draft3"].checks(draft3, raises)(func)
+        if draft4:
+            func = _draft_checkers["draft4"].checks(draft4, raises)(func)
+        if draft6:
+            func = _draft_checkers["draft6"].checks(draft6, raises)(func)
+        if draft7:
+            func = _draft_checkers["draft7"].checks(draft7, raises)(func)
+        if draft201909:
+            func = _draft_checkers["draft201909"].checks(draft201909, raises)(
+                func,
+            )
+        if draft202012:
+            func = _draft_checkers["draft202012"].checks(draft202012, raises)(
+                func,
+            )
+
+        # Oy. This is bad global state, but relied upon for now, until
+        # deprecation. See #519 and test_format_checkers_come_with_defaults
+        FormatChecker._cls_checks(
+            draft202012 or draft201909 or draft7 or draft6 or draft4 or draft3,
+            raises,
+        )(func)
+        return func
+
+    return wrap
+
+
+@_checks_drafts(name="idn-email")
+@_checks_drafts(name="email")
+def is_email(instance: object) -> bool:
+    if not isinstance(instance, str):
+        return True
+    return "@" in instance
+
+
+@_checks_drafts(
+    draft3="ip-address",
+    draft4="ipv4",
+    draft6="ipv4",
+    draft7="ipv4",
+    draft201909="ipv4",
+    draft202012="ipv4",
+    raises=ipaddress.AddressValueError,
+)
+def is_ipv4(instance: object) -> bool:
+    if not isinstance(instance, str):
+        return True
+    return bool(ipaddress.IPv4Address(instance))
+
+
+@_checks_drafts(name="ipv6", raises=ipaddress.AddressValueError)
+def is_ipv6(instance: object) -> bool:
+    if not isinstance(instance, str):
+        return True
+    address = ipaddress.IPv6Address(instance)
+    return not getattr(address, "scope_id", "")
+
+
+with suppress(ImportError):
+    from fqdn import FQDN
+
+    @_checks_drafts(
+        draft3="host-name",
+        draft4="hostname",
+        draft6="hostname",
+        draft7="hostname",
+        draft201909="hostname",
+        draft202012="hostname",
+    )
+    def is_host_name(instance: object) -> bool:
+        if not isinstance(instance, str):
+            return True
+        return FQDN(instance, min_labels=1).is_valid
+
+
+with suppress(ImportError):
+    # The built-in `idna` codec only implements RFC 3890, so we go elsewhere.
+    import idna
+
+    @_checks_drafts(
+        draft7="idn-hostname",
+        draft201909="idn-hostname",
+        draft202012="idn-hostname",
+        raises=(idna.IDNAError, UnicodeError),
+    )
+    def is_idn_host_name(instance: object) -> bool:
+        if not isinstance(instance, str):
+            return True
+        idna.encode(instance)
+        return True
+
+
+try:
+    import rfc3987
+except ImportError:
+    with suppress(ImportError):
+        from rfc3986_validator import validate_rfc3986
+
+        @_checks_drafts(name="uri")
+        def is_uri(instance: object) -> bool:
+            if not isinstance(instance, str):
+                return True
+            return validate_rfc3986(instance, rule="URI")
+
+        @_checks_drafts(
+            draft6="uri-reference",
+            draft7="uri-reference",
+            draft201909="uri-reference",
+            draft202012="uri-reference",
+            raises=ValueError,
+        )
+        def is_uri_reference(instance: object) -> bool:
+            if not isinstance(instance, str):
+                return True
+            return validate_rfc3986(instance, rule="URI_reference")
+
+else:
+
+    @_checks_drafts(
+        draft7="iri",
+        draft201909="iri",
+        draft202012="iri",
+        raises=ValueError,
+    )
+    def is_iri(instance: object) -> bool:
+        if not isinstance(instance, str):
+            return True
+        return rfc3987.parse(instance, rule="IRI")
+
+    @_checks_drafts(
+        draft7="iri-reference",
+        draft201909="iri-reference",
+        draft202012="iri-reference",
+        raises=ValueError,
+    )
+    def is_iri_reference(instance: object) -> bool:
+        if not isinstance(instance, str):
+            return True
+        return rfc3987.parse(instance, rule="IRI_reference")
+
+    @_checks_drafts(name="uri", raises=ValueError)
+    def is_uri(instance: object) -> bool:
+        if not isinstance(instance, str):
+            return True
+        return rfc3987.parse(instance, rule="URI")
+
+    @_checks_drafts(
+        draft6="uri-reference",
+        draft7="uri-reference",
+        draft201909="uri-reference",
+        draft202012="uri-reference",
+        raises=ValueError,
+    )
+    def is_uri_reference(instance: object) -> bool:
+        if not isinstance(instance, str):
+            return True
+        return rfc3987.parse(instance, rule="URI_reference")
+
+
+with suppress(ImportError):
+    from rfc3339_validator import validate_rfc3339
+
+    @_checks_drafts(name="date-time")
+    def is_datetime(instance: object) -> bool:
+        if not isinstance(instance, str):
+            return True
+        return validate_rfc3339(instance.upper())
+
+    @_checks_drafts(
+        draft7="time",
+        draft201909="time",
+        draft202012="time",
+    )
+    def is_time(instance: object) -> bool:
+        if not isinstance(instance, str):
+            return True
+        return is_datetime("1970-01-01T" + instance)
+
+
+@_checks_drafts(name="regex", raises=re.error)
+def is_regex(instance: object) -> bool:
+    if not isinstance(instance, str):
+        return True
+    return bool(re.compile(instance))
+
+
+@_checks_drafts(
+    draft3="date",
+    draft7="date",
+    draft201909="date",
+    draft202012="date",
+    raises=ValueError,
+)
+def is_date(instance: object) -> bool:
+    if not isinstance(instance, str):
+        return True
+    return bool(_RE_DATE.fullmatch(instance) and date.fromisoformat(instance))
+
+
+@_checks_drafts(draft3="time", raises=ValueError)
+def is_draft3_time(instance: object) -> bool:
+    if not isinstance(instance, str):
+        return True
+    return bool(datetime.strptime(instance, "%H:%M:%S"))  # noqa: DTZ007
+
+
+with suppress(ImportError):
+    from webcolors import CSS21_NAMES_TO_HEX
+    import webcolors
+
+    def is_css_color_code(instance: object) -> bool:
+        return webcolors.normalize_hex(instance)
+
+    @_checks_drafts(draft3="color", raises=(ValueError, TypeError))
+    def is_css21_color(instance: object) -> bool:
+        if (
+            not isinstance(instance, str)
+            or instance.lower() in CSS21_NAMES_TO_HEX
+        ):
+            return True
+        return is_css_color_code(instance)
+
+
+with suppress(ImportError):
+    import jsonpointer
+
+    @_checks_drafts(
+        draft6="json-pointer",
+        draft7="json-pointer",
+        draft201909="json-pointer",
+        draft202012="json-pointer",
+        raises=jsonpointer.JsonPointerException,
+    )
+    def is_json_pointer(instance: object) -> bool:
+        if not isinstance(instance, str):
+            return True
+        return bool(jsonpointer.JsonPointer(instance))
+
+    # TODO: I don't want to maintain this, so it
+    #       needs to go either into jsonpointer (pending
+    #       https://github.com/stefankoegl/python-json-pointer/issues/34) or
+    #       into a new external library.
+    @_checks_drafts(
+        draft7="relative-json-pointer",
+        draft201909="relative-json-pointer",
+        draft202012="relative-json-pointer",
+        raises=jsonpointer.JsonPointerException,
+    )
+    def is_relative_json_pointer(instance: object) -> bool:
+        # Definition taken from:
+        # https://tools.ietf.org/html/draft-handrews-relative-json-pointer-01#section-3
+        if not isinstance(instance, str):
+            return True
+        if not instance:
+            return False
+
+        non_negative_integer, rest = [], ""
+        for i, character in enumerate(instance):
+            if character.isdigit():
+                # digits with a leading "0" are not allowed
+                if i > 0 and int(instance[i - 1]) == 0:
+                    return False
+
+                non_negative_integer.append(character)
+                continue
+
+            if not non_negative_integer:
+                return False
+
+            rest = instance[i:]
+            break
+        return (rest == "#") or bool(jsonpointer.JsonPointer(rest))
+
+
+with suppress(ImportError):
+    import uri_template
+
+    @_checks_drafts(
+        draft6="uri-template",
+        draft7="uri-template",
+        draft201909="uri-template",
+        draft202012="uri-template",
+    )
+    def is_uri_template(instance: object) -> bool:
+        if not isinstance(instance, str):
+            return True
+        return uri_template.validate(instance)
+
+
+with suppress(ImportError):
+    import isoduration
+
+    @_checks_drafts(
+        draft201909="duration",
+        draft202012="duration",
+        raises=isoduration.DurationParsingException,
+    )
+    def is_duration(instance: object) -> bool:
+        if not isinstance(instance, str):
+            return True
+        isoduration.parse_duration(instance)
+        # FIXME: See bolsote/isoduration#25 and bolsote/isoduration#21
+        return instance.endswith(tuple("DMYWHMS"))
+
+
+@_checks_drafts(
+    draft201909="uuid",
+    draft202012="uuid",
+    raises=ValueError,
+)
+def is_uuid(instance: object) -> bool:
+    if not isinstance(instance, str):
+        return True
+    UUID(instance)
+    return all(instance[position] == "-" for position in (8, 13, 18, 23))
diff --git a/llm/Lib/site-packages/jsonschema/_keywords.py b/llm/Lib/site-packages/jsonschema/_keywords.py
new file mode 100644
index 0000000000000000000000000000000000000000..f30f954192abeef3a031c37ddcfd6a9831e4e247
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/_keywords.py
@@ -0,0 +1,449 @@
+from fractions import Fraction
+import re
+
+from jsonschema._utils import (
+    ensure_list,
+    equal,
+    extras_msg,
+    find_additional_properties,
+    find_evaluated_item_indexes_by_schema,
+    find_evaluated_property_keys_by_schema,
+    uniq,
+)
+from jsonschema.exceptions import FormatError, ValidationError
+
+
+def patternProperties(validator, patternProperties, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    for pattern, subschema in patternProperties.items():
+        for k, v in instance.items():
+            if re.search(pattern, k):
+                yield from validator.descend(
+                    v, subschema, path=k, schema_path=pattern,
+                )
+
+
+def propertyNames(validator, propertyNames, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    for property in instance:
+        yield from validator.descend(instance=property, schema=propertyNames)
+
+
+def additionalProperties(validator, aP, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    extras = set(find_additional_properties(instance, schema))
+
+    if validator.is_type(aP, "object"):
+        for extra in extras:
+            yield from validator.descend(instance[extra], aP, path=extra)
+    elif not aP and extras:
+        if "patternProperties" in schema:
+            verb = "does" if len(extras) == 1 else "do"
+            joined = ", ".join(repr(each) for each in sorted(extras))
+            patterns = ", ".join(
+                repr(each) for each in sorted(schema["patternProperties"])
+            )
+            error = f"{joined} {verb} not match any of the regexes: {patterns}"
+            yield ValidationError(error)
+        else:
+            error = "Additional properties are not allowed (%s %s unexpected)"
+            yield ValidationError(error % extras_msg(sorted(extras, key=str)))
+
+
+def items(validator, items, instance, schema):
+    if not validator.is_type(instance, "array"):
+        return
+
+    prefix = len(schema.get("prefixItems", []))
+    total = len(instance)
+    extra = total - prefix
+    if extra <= 0:
+        return
+
+    if items is False:
+        rest = instance[prefix:] if extra != 1 else instance[prefix]
+        item = "items" if prefix != 1 else "item"
+        yield ValidationError(
+            f"Expected at most {prefix} {item} but found {extra} "
+            f"extra: {rest!r}",
+        )
+    else:
+        for index in range(prefix, total):
+            yield from validator.descend(
+                instance=instance[index],
+                schema=items,
+                path=index,
+            )
+
+
+def const(validator, const, instance, schema):
+    if not equal(instance, const):
+        yield ValidationError(f"{const!r} was expected")
+
+
+def contains(validator, contains, instance, schema):
+    if not validator.is_type(instance, "array"):
+        return
+
+    matches = 0
+    min_contains = schema.get("minContains", 1)
+    max_contains = schema.get("maxContains", len(instance))
+
+    contains_validator = validator.evolve(schema=contains)
+
+    for each in instance:
+        if contains_validator.is_valid(each):
+            matches += 1
+            if matches > max_contains:
+                yield ValidationError(
+                    "Too many items match the given schema "
+                    f"(expected at most {max_contains})",
+                    validator="maxContains",
+                    validator_value=max_contains,
+                )
+                return
+
+    if matches < min_contains:
+        if not matches:
+            yield ValidationError(
+                f"{instance!r} does not contain items "
+                "matching the given schema",
+            )
+        else:
+            yield ValidationError(
+                "Too few items match the given schema (expected at least "
+                f"{min_contains} but only {matches} matched)",
+                validator="minContains",
+                validator_value=min_contains,
+            )
+
+
+def exclusiveMinimum(validator, minimum, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if instance <= minimum:
+        yield ValidationError(
+            f"{instance!r} is less than or equal to "
+            f"the minimum of {minimum!r}",
+        )
+
+
+def exclusiveMaximum(validator, maximum, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if instance >= maximum:
+        yield ValidationError(
+            f"{instance!r} is greater than or equal "
+            f"to the maximum of {maximum!r}",
+        )
+
+
+def minimum(validator, minimum, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if instance < minimum:
+        message = f"{instance!r} is less than the minimum of {minimum!r}"
+        yield ValidationError(message)
+
+
+def maximum(validator, maximum, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if instance > maximum:
+        message = f"{instance!r} is greater than the maximum of {maximum!r}"
+        yield ValidationError(message)
+
+
+def multipleOf(validator, dB, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if isinstance(dB, float):
+        quotient = instance / dB
+        try:
+            failed = int(quotient) != quotient
+        except OverflowError:
+            # When `instance` is large and `dB` is less than one,
+            # quotient can overflow to infinity; and then casting to int
+            # raises an error.
+            #
+            # In this case we fall back to Fraction logic, which is
+            # exact and cannot overflow.  The performance is also
+            # acceptable: we try the fast all-float option first, and
+            # we know that fraction(dB) can have at most a few hundred
+            # digits in each part.  The worst-case slowdown is therefore
+            # for already-slow enormous integers or Decimals.
+            failed = (Fraction(instance) / Fraction(dB)).denominator != 1
+    else:
+        failed = instance % dB
+
+    if failed:
+        yield ValidationError(f"{instance!r} is not a multiple of {dB}")
+
+
+def minItems(validator, mI, instance, schema):
+    if validator.is_type(instance, "array") and len(instance) < mI:
+        message = "should be non-empty" if mI == 1 else "is too short"
+        yield ValidationError(f"{instance!r} {message}")
+
+
+def maxItems(validator, mI, instance, schema):
+    if validator.is_type(instance, "array") and len(instance) > mI:
+        message = "is expected to be empty" if mI == 0 else "is too long"
+        yield ValidationError(f"{instance!r} {message}")
+
+
+def uniqueItems(validator, uI, instance, schema):
+    if (
+        uI
+        and validator.is_type(instance, "array")
+        and not uniq(instance)
+    ):
+        yield ValidationError(f"{instance!r} has non-unique elements")
+
+
+def pattern(validator, patrn, instance, schema):
+    if (
+        validator.is_type(instance, "string")
+        and not re.search(patrn, instance)
+    ):
+        yield ValidationError(f"{instance!r} does not match {patrn!r}")
+
+
+def format(validator, format, instance, schema):
+    if validator.format_checker is not None:
+        try:
+            validator.format_checker.check(instance, format)
+        except FormatError as error:
+            yield ValidationError(error.message, cause=error.cause)
+
+
+def minLength(validator, mL, instance, schema):
+    if validator.is_type(instance, "string") and len(instance) < mL:
+        message = "should be non-empty" if mL == 1 else "is too short"
+        yield ValidationError(f"{instance!r} {message}")
+
+
+def maxLength(validator, mL, instance, schema):
+    if validator.is_type(instance, "string") and len(instance) > mL:
+        message = "is expected to be empty" if mL == 0 else "is too long"
+        yield ValidationError(f"{instance!r} {message}")
+
+
+def dependentRequired(validator, dependentRequired, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    for property, dependency in dependentRequired.items():
+        if property not in instance:
+            continue
+
+        for each in dependency:
+            if each not in instance:
+                message = f"{each!r} is a dependency of {property!r}"
+                yield ValidationError(message)
+
+
+def dependentSchemas(validator, dependentSchemas, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    for property, dependency in dependentSchemas.items():
+        if property not in instance:
+            continue
+        yield from validator.descend(
+            instance, dependency, schema_path=property,
+        )
+
+
+def enum(validator, enums, instance, schema):
+    if all(not equal(each, instance) for each in enums):
+        yield ValidationError(f"{instance!r} is not one of {enums!r}")
+
+
+def ref(validator, ref, instance, schema):
+    yield from validator._validate_reference(ref=ref, instance=instance)
+
+
+def dynamicRef(validator, dynamicRef, instance, schema):
+    yield from validator._validate_reference(ref=dynamicRef, instance=instance)
+
+
+def type(validator, types, instance, schema):
+    types = ensure_list(types)
+
+    if not any(validator.is_type(instance, type) for type in types):
+        reprs = ", ".join(repr(type) for type in types)
+        yield ValidationError(f"{instance!r} is not of type {reprs}")
+
+
+def properties(validator, properties, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    for property, subschema in properties.items():
+        if property in instance:
+            yield from validator.descend(
+                instance[property],
+                subschema,
+                path=property,
+                schema_path=property,
+            )
+
+
+def required(validator, required, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+    for property in required:
+        if property not in instance:
+            yield ValidationError(f"{property!r} is a required property")
+
+
+def minProperties(validator, mP, instance, schema):
+    if validator.is_type(instance, "object") and len(instance) < mP:
+        message = (
+            "should be non-empty" if mP == 1
+            else "does not have enough properties"
+        )
+        yield ValidationError(f"{instance!r} {message}")
+
+
+def maxProperties(validator, mP, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+    if validator.is_type(instance, "object") and len(instance) > mP:
+        message = (
+            "is expected to be empty" if mP == 0
+            else "has too many properties"
+        )
+        yield ValidationError(f"{instance!r} {message}")
+
+
+def allOf(validator, allOf, instance, schema):
+    for index, subschema in enumerate(allOf):
+        yield from validator.descend(instance, subschema, schema_path=index)
+
+
+def anyOf(validator, anyOf, instance, schema):
+    all_errors = []
+    for index, subschema in enumerate(anyOf):
+        errs = list(validator.descend(instance, subschema, schema_path=index))
+        if not errs:
+            break
+        all_errors.extend(errs)
+    else:
+        yield ValidationError(
+            f"{instance!r} is not valid under any of the given schemas",
+            context=all_errors,
+        )
+
+
+def oneOf(validator, oneOf, instance, schema):
+    subschemas = enumerate(oneOf)
+    all_errors = []
+    for index, subschema in subschemas:
+        errs = list(validator.descend(instance, subschema, schema_path=index))
+        if not errs:
+            first_valid = subschema
+            break
+        all_errors.extend(errs)
+    else:
+        yield ValidationError(
+            f"{instance!r} is not valid under any of the given schemas",
+            context=all_errors,
+        )
+
+    more_valid = [
+        each for _, each in subschemas
+        if validator.evolve(schema=each).is_valid(instance)
+    ]
+    if more_valid:
+        more_valid.append(first_valid)
+        reprs = ", ".join(repr(schema) for schema in more_valid)
+        yield ValidationError(f"{instance!r} is valid under each of {reprs}")
+
+
+def not_(validator, not_schema, instance, schema):
+    if validator.evolve(schema=not_schema).is_valid(instance):
+        message = f"{instance!r} should not be valid under {not_schema!r}"
+        yield ValidationError(message)
+
+
+def if_(validator, if_schema, instance, schema):
+    if validator.evolve(schema=if_schema).is_valid(instance):
+        if "then" in schema:
+            then = schema["then"]
+            yield from validator.descend(instance, then, schema_path="then")
+    elif "else" in schema:
+        else_ = schema["else"]
+        yield from validator.descend(instance, else_, schema_path="else")
+
+
+def unevaluatedItems(validator, unevaluatedItems, instance, schema):
+    if not validator.is_type(instance, "array"):
+        return
+    evaluated_item_indexes = find_evaluated_item_indexes_by_schema(
+        validator, instance, schema,
+    )
+    unevaluated_items = [
+        item for index, item in enumerate(instance)
+        if index not in evaluated_item_indexes
+    ]
+    if unevaluated_items:
+        error = "Unevaluated items are not allowed (%s %s unexpected)"
+        yield ValidationError(error % extras_msg(unevaluated_items))
+
+
+def unevaluatedProperties(validator, unevaluatedProperties, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+    evaluated_keys = find_evaluated_property_keys_by_schema(
+        validator, instance, schema,
+    )
+    unevaluated_keys = []
+    for property in instance:
+        if property not in evaluated_keys:
+            for _ in validator.descend(
+                instance[property],
+                unevaluatedProperties,
+                path=property,
+                schema_path=property,
+            ):
+                # FIXME: Include context for each unevaluated property
+                #        indicating why it's invalid under the subschema.
+                unevaluated_keys.append(property)  # noqa: PERF401
+
+    if unevaluated_keys:
+        if unevaluatedProperties is False:
+            error = "Unevaluated properties are not allowed (%s %s unexpected)"
+            extras = sorted(unevaluated_keys, key=str)
+            yield ValidationError(error % extras_msg(extras))
+        else:
+            error = (
+                "Unevaluated properties are not valid under "
+                "the given schema (%s %s unevaluated and invalid)"
+            )
+            yield ValidationError(error % extras_msg(unevaluated_keys))
+
+
+def prefixItems(validator, prefixItems, instance, schema):
+    if not validator.is_type(instance, "array"):
+        return
+
+    for (index, item), subschema in zip(enumerate(instance), prefixItems):
+        yield from validator.descend(
+            instance=item,
+            schema=subschema,
+            schema_path=index,
+            path=index,
+        )
diff --git a/llm/Lib/site-packages/jsonschema/_legacy_keywords.py b/llm/Lib/site-packages/jsonschema/_legacy_keywords.py
new file mode 100644
index 0000000000000000000000000000000000000000..c691589f8f69fdbbc0152728121361665de08f00
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/_legacy_keywords.py
@@ -0,0 +1,449 @@
+import re
+
+from referencing.jsonschema import lookup_recursive_ref
+
+from jsonschema import _utils
+from jsonschema.exceptions import ValidationError
+
+
+def ignore_ref_siblings(schema):
+    """
+    Ignore siblings of ``$ref`` if it is present.
+
+    Otherwise, return all keywords.
+
+    Suitable for use with `create`'s ``applicable_validators`` argument.
+    """
+    ref = schema.get("$ref")
+    if ref is not None:
+        return [("$ref", ref)]
+    else:
+        return schema.items()
+
+
+def dependencies_draft3(validator, dependencies, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    for property, dependency in dependencies.items():
+        if property not in instance:
+            continue
+
+        if validator.is_type(dependency, "object"):
+            yield from validator.descend(
+                instance, dependency, schema_path=property,
+            )
+        elif validator.is_type(dependency, "string"):
+            if dependency not in instance:
+                message = f"{dependency!r} is a dependency of {property!r}"
+                yield ValidationError(message)
+        else:
+            for each in dependency:
+                if each not in instance:
+                    message = f"{each!r} is a dependency of {property!r}"
+                    yield ValidationError(message)
+
+
+def dependencies_draft4_draft6_draft7(
+    validator,
+    dependencies,
+    instance,
+    schema,
+):
+    """
+    Support for the ``dependencies`` keyword from pre-draft 2019-09.
+
+    In later drafts, the keyword was split into separate
+    ``dependentRequired`` and ``dependentSchemas`` validators.
+    """
+    if not validator.is_type(instance, "object"):
+        return
+
+    for property, dependency in dependencies.items():
+        if property not in instance:
+            continue
+
+        if validator.is_type(dependency, "array"):
+            for each in dependency:
+                if each not in instance:
+                    message = f"{each!r} is a dependency of {property!r}"
+                    yield ValidationError(message)
+        else:
+            yield from validator.descend(
+                instance, dependency, schema_path=property,
+            )
+
+
+def disallow_draft3(validator, disallow, instance, schema):
+    for disallowed in _utils.ensure_list(disallow):
+        if validator.evolve(schema={"type": [disallowed]}).is_valid(instance):
+            message = f"{disallowed!r} is disallowed for {instance!r}"
+            yield ValidationError(message)
+
+
+def extends_draft3(validator, extends, instance, schema):
+    if validator.is_type(extends, "object"):
+        yield from validator.descend(instance, extends)
+        return
+    for index, subschema in enumerate(extends):
+        yield from validator.descend(instance, subschema, schema_path=index)
+
+
+def items_draft3_draft4(validator, items, instance, schema):
+    if not validator.is_type(instance, "array"):
+        return
+
+    if validator.is_type(items, "object"):
+        for index, item in enumerate(instance):
+            yield from validator.descend(item, items, path=index)
+    else:
+        for (index, item), subschema in zip(enumerate(instance), items):
+            yield from validator.descend(
+                item, subschema, path=index, schema_path=index,
+            )
+
+
+def additionalItems(validator, aI, instance, schema):
+    if (
+        not validator.is_type(instance, "array")
+        or validator.is_type(schema.get("items", {}), "object")
+    ):
+        return
+
+    len_items = len(schema.get("items", []))
+    if validator.is_type(aI, "object"):
+        for index, item in enumerate(instance[len_items:], start=len_items):
+            yield from validator.descend(item, aI, path=index)
+    elif not aI and len(instance) > len(schema.get("items", [])):
+        error = "Additional items are not allowed (%s %s unexpected)"
+        yield ValidationError(
+            error % _utils.extras_msg(instance[len(schema.get("items", [])):]),
+        )
+
+
+def items_draft6_draft7_draft201909(validator, items, instance, schema):
+    if not validator.is_type(instance, "array"):
+        return
+
+    if validator.is_type(items, "array"):
+        for (index, item), subschema in zip(enumerate(instance), items):
+            yield from validator.descend(
+                item, subschema, path=index, schema_path=index,
+            )
+    else:
+        for index, item in enumerate(instance):
+            yield from validator.descend(item, items, path=index)
+
+
+def minimum_draft3_draft4(validator, minimum, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if schema.get("exclusiveMinimum", False):
+        failed = instance <= minimum
+        cmp = "less than or equal to"
+    else:
+        failed = instance < minimum
+        cmp = "less than"
+
+    if failed:
+        message = f"{instance!r} is {cmp} the minimum of {minimum!r}"
+        yield ValidationError(message)
+
+
+def maximum_draft3_draft4(validator, maximum, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if schema.get("exclusiveMaximum", False):
+        failed = instance >= maximum
+        cmp = "greater than or equal to"
+    else:
+        failed = instance > maximum
+        cmp = "greater than"
+
+    if failed:
+        message = f"{instance!r} is {cmp} the maximum of {maximum!r}"
+        yield ValidationError(message)
+
+
+def properties_draft3(validator, properties, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    for property, subschema in properties.items():
+        if property in instance:
+            yield from validator.descend(
+                instance[property],
+                subschema,
+                path=property,
+                schema_path=property,
+            )
+        elif subschema.get("required", False):
+            error = ValidationError(f"{property!r} is a required property")
+            error._set(
+                validator="required",
+                validator_value=subschema["required"],
+                instance=instance,
+                schema=schema,
+            )
+            error.path.appendleft(property)
+            error.schema_path.extend([property, "required"])
+            yield error
+
+
+def type_draft3(validator, types, instance, schema):
+    types = _utils.ensure_list(types)
+
+    all_errors = []
+    for index, type in enumerate(types):
+        if validator.is_type(type, "object"):
+            errors = list(validator.descend(instance, type, schema_path=index))
+            if not errors:
+                return
+            all_errors.extend(errors)
+        elif validator.is_type(instance, type):
+                return
+
+    reprs = []
+    for type in types:
+        try:
+            reprs.append(repr(type["name"]))
+        except Exception:  # noqa: BLE001
+            reprs.append(repr(type))
+    yield ValidationError(
+        f"{instance!r} is not of type {', '.join(reprs)}",
+        context=all_errors,
+    )
+
+
+def contains_draft6_draft7(validator, contains, instance, schema):
+    if not validator.is_type(instance, "array"):
+        return
+
+    if not any(
+        validator.evolve(schema=contains).is_valid(element)
+        for element in instance
+    ):
+        yield ValidationError(
+            f"None of {instance!r} are valid under the given schema",
+        )
+
+
+def recursiveRef(validator, recursiveRef, instance, schema):
+    resolved = lookup_recursive_ref(validator._resolver)
+    yield from validator.descend(
+        instance,
+        resolved.contents,
+        resolver=resolved.resolver,
+    )
+
+
+def find_evaluated_item_indexes_by_schema(validator, instance, schema):
+    """
+    Get all indexes of items that get evaluated under the current schema.
+
+    Covers all keywords related to unevaluatedItems: items, prefixItems, if,
+    then, else, contains, unevaluatedItems, allOf, oneOf, anyOf
+    """
+    if validator.is_type(schema, "boolean"):
+        return []
+    evaluated_indexes = []
+
+    ref = schema.get("$ref")
+    if ref is not None:
+        resolved = validator._resolver.lookup(ref)
+        evaluated_indexes.extend(
+            find_evaluated_item_indexes_by_schema(
+                validator.evolve(
+                    schema=resolved.contents,
+                    _resolver=resolved.resolver,
+                ),
+                instance,
+                resolved.contents,
+            ),
+        )
+
+    if "$recursiveRef" in schema:
+        resolved = lookup_recursive_ref(validator._resolver)
+        evaluated_indexes.extend(
+            find_evaluated_item_indexes_by_schema(
+                validator.evolve(
+                    schema=resolved.contents,
+                    _resolver=resolved.resolver,
+                ),
+                instance,
+                resolved.contents,
+            ),
+        )
+
+    if "items" in schema:
+        if "additionalItems" in schema:
+            return list(range(len(instance)))
+
+        if validator.is_type(schema["items"], "object"):
+            return list(range(len(instance)))
+        evaluated_indexes += list(range(len(schema["items"])))
+
+    if "if" in schema:
+        if validator.evolve(schema=schema["if"]).is_valid(instance):
+            evaluated_indexes += find_evaluated_item_indexes_by_schema(
+                validator, instance, schema["if"],
+            )
+            if "then" in schema:
+                evaluated_indexes += find_evaluated_item_indexes_by_schema(
+                    validator, instance, schema["then"],
+                )
+        elif "else" in schema:
+            evaluated_indexes += find_evaluated_item_indexes_by_schema(
+                validator, instance, schema["else"],
+            )
+
+    for keyword in ["contains", "unevaluatedItems"]:
+        if keyword in schema:
+            for k, v in enumerate(instance):
+                if validator.evolve(schema=schema[keyword]).is_valid(v):
+                    evaluated_indexes.append(k)
+
+    for keyword in ["allOf", "oneOf", "anyOf"]:
+        if keyword in schema:
+            for subschema in schema[keyword]:
+                errs = next(validator.descend(instance, subschema), None)
+                if errs is None:
+                    evaluated_indexes += find_evaluated_item_indexes_by_schema(
+                        validator, instance, subschema,
+                    )
+
+    return evaluated_indexes
+
+
+def unevaluatedItems_draft2019(validator, unevaluatedItems, instance, schema):
+    if not validator.is_type(instance, "array"):
+        return
+    evaluated_item_indexes = find_evaluated_item_indexes_by_schema(
+        validator, instance, schema,
+    )
+    unevaluated_items = [
+        item for index, item in enumerate(instance)
+        if index not in evaluated_item_indexes
+    ]
+    if unevaluated_items:
+        error = "Unevaluated items are not allowed (%s %s unexpected)"
+        yield ValidationError(error % _utils.extras_msg(unevaluated_items))
+
+
+def find_evaluated_property_keys_by_schema(validator, instance, schema):
+    if validator.is_type(schema, "boolean"):
+        return []
+    evaluated_keys = []
+
+    ref = schema.get("$ref")
+    if ref is not None:
+        resolved = validator._resolver.lookup(ref)
+        evaluated_keys.extend(
+            find_evaluated_property_keys_by_schema(
+                validator.evolve(
+                    schema=resolved.contents,
+                    _resolver=resolved.resolver,
+                ),
+                instance,
+                resolved.contents,
+            ),
+        )
+
+    if "$recursiveRef" in schema:
+        resolved = lookup_recursive_ref(validator._resolver)
+        evaluated_keys.extend(
+            find_evaluated_property_keys_by_schema(
+                validator.evolve(
+                    schema=resolved.contents,
+                    _resolver=resolved.resolver,
+                ),
+                instance,
+                resolved.contents,
+            ),
+        )
+
+    for keyword in [
+        "properties", "additionalProperties", "unevaluatedProperties",
+    ]:
+        if keyword in schema:
+            schema_value = schema[keyword]
+            if validator.is_type(schema_value, "boolean") and schema_value:
+                evaluated_keys += instance.keys()
+
+            elif validator.is_type(schema_value, "object"):
+                for property in schema_value:
+                    if property in instance:
+                        evaluated_keys.append(property)
+
+    if "patternProperties" in schema:
+        for property in instance:
+            for pattern in schema["patternProperties"]:
+                if re.search(pattern, property):
+                    evaluated_keys.append(property)
+
+    if "dependentSchemas" in schema:
+        for property, subschema in schema["dependentSchemas"].items():
+            if property not in instance:
+                continue
+            evaluated_keys += find_evaluated_property_keys_by_schema(
+                validator, instance, subschema,
+            )
+
+    for keyword in ["allOf", "oneOf", "anyOf"]:
+        if keyword in schema:
+            for subschema in schema[keyword]:
+                errs = next(validator.descend(instance, subschema), None)
+                if errs is None:
+                    evaluated_keys += find_evaluated_property_keys_by_schema(
+                        validator, instance, subschema,
+                    )
+
+    if "if" in schema:
+        if validator.evolve(schema=schema["if"]).is_valid(instance):
+            evaluated_keys += find_evaluated_property_keys_by_schema(
+                validator, instance, schema["if"],
+            )
+            if "then" in schema:
+                evaluated_keys += find_evaluated_property_keys_by_schema(
+                    validator, instance, schema["then"],
+                )
+        elif "else" in schema:
+            evaluated_keys += find_evaluated_property_keys_by_schema(
+                validator, instance, schema["else"],
+            )
+
+    return evaluated_keys
+
+
+def unevaluatedProperties_draft2019(validator, uP, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+    evaluated_keys = find_evaluated_property_keys_by_schema(
+        validator, instance, schema,
+    )
+    unevaluated_keys = []
+    for property in instance:
+        if property not in evaluated_keys:
+            for _ in validator.descend(
+                instance[property],
+                uP,
+                path=property,
+                schema_path=property,
+            ):
+                # FIXME: Include context for each unevaluated property
+                #        indicating why it's invalid under the subschema.
+                unevaluated_keys.append(property)  # noqa: PERF401
+
+    if unevaluated_keys:
+        if uP is False:
+            error = "Unevaluated properties are not allowed (%s %s unexpected)"
+            extras = sorted(unevaluated_keys, key=str)
+            yield ValidationError(error % _utils.extras_msg(extras))
+        else:
+            error = (
+                "Unevaluated properties are not valid under "
+                "the given schema (%s %s unevaluated and invalid)"
+            )
+            yield ValidationError(error % _utils.extras_msg(unevaluated_keys))
diff --git a/llm/Lib/site-packages/jsonschema/_types.py b/llm/Lib/site-packages/jsonschema/_types.py
new file mode 100644
index 0000000000000000000000000000000000000000..5c8930c196ad2ee5ee95c1f40441d32b138a3b3a
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/_types.py
@@ -0,0 +1,195 @@
+from __future__ import annotations
+
+from typing import Any, Callable, Mapping
+import numbers
+
+from attrs import evolve, field, frozen
+from rpds import HashTrieMap
+
+from jsonschema.exceptions import UndefinedTypeCheck
+
+
+# unfortunately, the type of HashTrieMap is generic, and if used as an attrs
+# converter, the generic type is presented to mypy, which then fails to match
+# the concrete type of a type checker mapping
+# this "do nothing" wrapper presents the correct information to mypy
+def _typed_map_converter(
+    init_val: Mapping[str, Callable[[TypeChecker, Any], bool]],
+) -> HashTrieMap[str, Callable[[TypeChecker, Any], bool]]:
+    return HashTrieMap.convert(init_val)
+
+
+def is_array(checker, instance):
+    return isinstance(instance, list)
+
+
+def is_bool(checker, instance):
+    return isinstance(instance, bool)
+
+
+def is_integer(checker, instance):
+    # bool inherits from int, so ensure bools aren't reported as ints
+    if isinstance(instance, bool):
+        return False
+    return isinstance(instance, int)
+
+
+def is_null(checker, instance):
+    return instance is None
+
+
+def is_number(checker, instance):
+    # bool inherits from int, so ensure bools aren't reported as ints
+    if isinstance(instance, bool):
+        return False
+    return isinstance(instance, numbers.Number)
+
+
+def is_object(checker, instance):
+    return isinstance(instance, dict)
+
+
+def is_string(checker, instance):
+    return isinstance(instance, str)
+
+
+def is_any(checker, instance):
+    return True
+
+
+@frozen(repr=False)
+class TypeChecker:
+    """
+    A :kw:`type` property checker.
+
+    A `TypeChecker` performs type checking for a `Validator`, converting
+    between the defined JSON Schema types and some associated Python types or
+    objects.
+
+    Modifying the behavior just mentioned by redefining which Python objects
+    are considered to be of which JSON Schema types can be done using
+    `TypeChecker.redefine` or `TypeChecker.redefine_many`, and types can be
+    removed via `TypeChecker.remove`. Each of these return a new `TypeChecker`.
+
+    Arguments:
+
+        type_checkers:
+
+            The initial mapping of types to their checking functions.
+    """
+
+    _type_checkers: HashTrieMap[
+        str, Callable[[TypeChecker, Any], bool],
+    ] = field(default=HashTrieMap(), converter=_typed_map_converter)
+
+    def __repr__(self):
+        types = ", ".join(repr(k) for k in sorted(self._type_checkers))
+        return f"<{self.__class__.__name__} types={{{types}}}>"
+
+    def is_type(self, instance, type: str) -> bool:
+        """
+        Check if the instance is of the appropriate type.
+
+        Arguments:
+
+            instance:
+
+                The instance to check
+
+            type:
+
+                The name of the type that is expected.
+
+        Raises:
+
+            `jsonschema.exceptions.UndefinedTypeCheck`:
+
+                if ``type`` is unknown to this object.
+        """
+        try:
+            fn = self._type_checkers[type]
+        except KeyError:
+            raise UndefinedTypeCheck(type) from None
+
+        return fn(self, instance)
+
+    def redefine(self, type: str, fn) -> TypeChecker:
+        """
+        Produce a new checker with the given type redefined.
+
+        Arguments:
+
+            type:
+
+                The name of the type to check.
+
+            fn (collections.abc.Callable):
+
+                A callable taking exactly two parameters - the type
+                checker calling the function and the instance to check.
+                The function should return true if instance is of this
+                type and false otherwise.
+        """
+        return self.redefine_many({type: fn})
+
+    def redefine_many(self, definitions=()) -> TypeChecker:
+        """
+        Produce a new checker with the given types redefined.
+
+        Arguments:
+
+            definitions (dict):
+
+                A dictionary mapping types to their checking functions.
+        """
+        type_checkers = self._type_checkers.update(definitions)
+        return evolve(self, type_checkers=type_checkers)
+
+    def remove(self, *types) -> TypeChecker:
+        """
+        Produce a new checker with the given types forgotten.
+
+        Arguments:
+
+            types:
+
+                the names of the types to remove.
+
+        Raises:
+
+            `jsonschema.exceptions.UndefinedTypeCheck`:
+
+                if any given type is unknown to this object
+        """
+        type_checkers = self._type_checkers
+        for each in types:
+            try:
+                type_checkers = type_checkers.remove(each)
+            except KeyError:
+                raise UndefinedTypeCheck(each) from None
+        return evolve(self, type_checkers=type_checkers)
+
+
+draft3_type_checker = TypeChecker(
+    {
+        "any": is_any,
+        "array": is_array,
+        "boolean": is_bool,
+        "integer": is_integer,
+        "object": is_object,
+        "null": is_null,
+        "number": is_number,
+        "string": is_string,
+    },
+)
+draft4_type_checker = draft3_type_checker.remove("any")
+draft6_type_checker = draft4_type_checker.redefine(
+    "integer",
+    lambda checker, instance: (
+        is_integer(checker, instance)
+        or isinstance(instance, float) and instance.is_integer()
+    ),
+)
+draft7_type_checker = draft6_type_checker
+draft201909_type_checker = draft7_type_checker
+draft202012_type_checker = draft201909_type_checker
diff --git a/llm/Lib/site-packages/jsonschema/_typing.py b/llm/Lib/site-packages/jsonschema/_typing.py
new file mode 100644
index 0000000000000000000000000000000000000000..d283dc48d10489baf7516182bfb1b111faf12ba0
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/_typing.py
@@ -0,0 +1,28 @@
+"""
+Some (initially private) typing helpers for jsonschema's types.
+"""
+from typing import Any, Callable, Iterable, Protocol, Tuple, Union
+
+import referencing.jsonschema
+
+from jsonschema.protocols import Validator
+
+
+class SchemaKeywordValidator(Protocol):
+    def __call__(
+        self,
+        validator: Validator,
+        value: Any,
+        instance: Any,
+        schema: referencing.jsonschema.Schema,
+    ) -> None:
+        ...
+
+
+id_of = Callable[[referencing.jsonschema.Schema], Union[str, None]]
+
+
+ApplicableValidators = Callable[
+    [referencing.jsonschema.Schema],
+    Iterable[Tuple[str, Any]],
+]
diff --git a/llm/Lib/site-packages/jsonschema/_utils.py b/llm/Lib/site-packages/jsonschema/_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..57fddc498934ba7cd69f9fbace21d07687c51be6
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/_utils.py
@@ -0,0 +1,348 @@
+from collections.abc import Mapping, MutableMapping, Sequence
+from urllib.parse import urlsplit
+import itertools
+import re
+
+
+class URIDict(MutableMapping):
+    """
+    Dictionary which uses normalized URIs as keys.
+    """
+
+    def normalize(self, uri):
+        return urlsplit(uri).geturl()
+
+    def __init__(self, *args, **kwargs):
+        self.store = dict()
+        self.store.update(*args, **kwargs)
+
+    def __getitem__(self, uri):
+        return self.store[self.normalize(uri)]
+
+    def __setitem__(self, uri, value):
+        self.store[self.normalize(uri)] = value
+
+    def __delitem__(self, uri):
+        del self.store[self.normalize(uri)]
+
+    def __iter__(self):
+        return iter(self.store)
+
+    def __len__(self):  # pragma: no cover -- untested, but to be removed
+        return len(self.store)
+
+    def __repr__(self):  # pragma: no cover -- untested, but to be removed
+        return repr(self.store)
+
+
+class Unset:
+    """
+    An as-of-yet unset attribute or unprovided default parameter.
+    """
+
+    def __repr__(self):  # pragma: no cover
+        return "<unset>"
+
+
+def format_as_index(container, indices):
+    """
+    Construct a single string containing indexing operations for the indices.
+
+    For example for a container ``bar``, [1, 2, "foo"] -> bar[1][2]["foo"]
+
+    Arguments:
+
+        container (str):
+
+            A word to use for the thing being indexed
+
+        indices (sequence):
+
+            The indices to format.
+    """
+    if not indices:
+        return container
+    return f"{container}[{']['.join(repr(index) for index in indices)}]"
+
+
+def find_additional_properties(instance, schema):
+    """
+    Return the set of additional properties for the given ``instance``.
+
+    Weeds out properties that should have been validated by ``properties`` and
+    / or ``patternProperties``.
+
+    Assumes ``instance`` is dict-like already.
+    """
+    properties = schema.get("properties", {})
+    patterns = "|".join(schema.get("patternProperties", {}))
+    for property in instance:
+        if property not in properties:
+            if patterns and re.search(patterns, property):
+                continue
+            yield property
+
+
+def extras_msg(extras):
+    """
+    Create an error message for extra items or properties.
+    """
+    verb = "was" if len(extras) == 1 else "were"
+    return ", ".join(repr(extra) for extra in extras), verb
+
+
+def ensure_list(thing):
+    """
+    Wrap ``thing`` in a list if it's a single str.
+
+    Otherwise, return it unchanged.
+    """
+    if isinstance(thing, str):
+        return [thing]
+    return thing
+
+
+def _mapping_equal(one, two):
+    """
+    Check if two mappings are equal using the semantics of `equal`.
+    """
+    if len(one) != len(two):
+        return False
+    return all(
+        key in two and equal(value, two[key])
+        for key, value in one.items()
+    )
+
+
+def _sequence_equal(one, two):
+    """
+    Check if two sequences are equal using the semantics of `equal`.
+    """
+    if len(one) != len(two):
+        return False
+    return all(equal(i, j) for i, j in zip(one, two))
+
+
+def equal(one, two):
+    """
+    Check if two things are equal evading some Python type hierarchy semantics.
+
+    Specifically in JSON Schema, evade `bool` inheriting from `int`,
+    recursing into sequences to do the same.
+    """
+    if isinstance(one, str) or isinstance(two, str):
+        return one == two
+    if isinstance(one, Sequence) and isinstance(two, Sequence):
+        return _sequence_equal(one, two)
+    if isinstance(one, Mapping) and isinstance(two, Mapping):
+        return _mapping_equal(one, two)
+    return unbool(one) == unbool(two)
+
+
+def unbool(element, true=object(), false=object()):
+    """
+    A hack to make True and 1 and False and 0 unique for ``uniq``.
+    """
+    if element is True:
+        return true
+    elif element is False:
+        return false
+    return element
+
+
+def uniq(container):
+    """
+    Check if all of a container's elements are unique.
+
+    Tries to rely on the container being recursively sortable, or otherwise
+    falls back on (slow) brute force.
+    """
+    try:
+        sort = sorted(unbool(i) for i in container)
+        sliced = itertools.islice(sort, 1, None)
+
+        for i, j in zip(sort, sliced):
+            if equal(i, j):
+                return False
+
+    except (NotImplementedError, TypeError):
+        seen = []
+        for e in container:
+            e = unbool(e)
+
+            for i in seen:
+                if equal(i, e):
+                    return False
+
+            seen.append(e)
+    return True
+
+
+def find_evaluated_item_indexes_by_schema(validator, instance, schema):
+    """
+    Get all indexes of items that get evaluated under the current schema.
+
+    Covers all keywords related to unevaluatedItems: items, prefixItems, if,
+    then, else, contains, unevaluatedItems, allOf, oneOf, anyOf
+    """
+    if validator.is_type(schema, "boolean"):
+        return []
+    evaluated_indexes = []
+
+    if "items" in schema:
+        return list(range(len(instance)))
+
+    ref = schema.get("$ref")
+    if ref is not None:
+        resolved = validator._resolver.lookup(ref)
+        evaluated_indexes.extend(
+            find_evaluated_item_indexes_by_schema(
+                validator.evolve(
+                    schema=resolved.contents,
+                    _resolver=resolved.resolver,
+                ),
+                instance,
+                resolved.contents,
+            ),
+        )
+
+    dynamicRef = schema.get("$dynamicRef")
+    if dynamicRef is not None:
+        resolved = validator._resolver.lookup(dynamicRef)
+        evaluated_indexes.extend(
+            find_evaluated_item_indexes_by_schema(
+                validator.evolve(
+                    schema=resolved.contents,
+                    _resolver=resolved.resolver,
+                ),
+                instance,
+                resolved.contents,
+            ),
+        )
+
+    if "prefixItems" in schema:
+        evaluated_indexes += list(range(len(schema["prefixItems"])))
+
+    if "if" in schema:
+        if validator.evolve(schema=schema["if"]).is_valid(instance):
+            evaluated_indexes += find_evaluated_item_indexes_by_schema(
+                validator, instance, schema["if"],
+            )
+            if "then" in schema:
+                evaluated_indexes += find_evaluated_item_indexes_by_schema(
+                    validator, instance, schema["then"],
+                )
+        elif "else" in schema:
+            evaluated_indexes += find_evaluated_item_indexes_by_schema(
+                validator, instance, schema["else"],
+            )
+
+    for keyword in ["contains", "unevaluatedItems"]:
+        if keyword in schema:
+            for k, v in enumerate(instance):
+                if validator.evolve(schema=schema[keyword]).is_valid(v):
+                    evaluated_indexes.append(k)
+
+    for keyword in ["allOf", "oneOf", "anyOf"]:
+        if keyword in schema:
+            for subschema in schema[keyword]:
+                errs = next(validator.descend(instance, subschema), None)
+                if errs is None:
+                    evaluated_indexes += find_evaluated_item_indexes_by_schema(
+                        validator, instance, subschema,
+                    )
+
+    return evaluated_indexes
+
+
+def find_evaluated_property_keys_by_schema(validator, instance, schema):
+    """
+    Get all keys of items that get evaluated under the current schema.
+
+    Covers all keywords related to unevaluatedProperties: properties,
+    additionalProperties, unevaluatedProperties, patternProperties,
+    dependentSchemas, allOf, oneOf, anyOf, if, then, else
+    """
+    if validator.is_type(schema, "boolean"):
+        return []
+    evaluated_keys = []
+
+    ref = schema.get("$ref")
+    if ref is not None:
+        resolved = validator._resolver.lookup(ref)
+        evaluated_keys.extend(
+            find_evaluated_property_keys_by_schema(
+                validator.evolve(
+                    schema=resolved.contents,
+                    _resolver=resolved.resolver,
+                ),
+                instance,
+                resolved.contents,
+            ),
+        )
+
+    dynamicRef = schema.get("$dynamicRef")
+    if dynamicRef is not None:
+        resolved = validator._resolver.lookup(dynamicRef)
+        evaluated_keys.extend(
+            find_evaluated_property_keys_by_schema(
+                validator.evolve(
+                    schema=resolved.contents,
+                    _resolver=resolved.resolver,
+                ),
+                instance,
+                resolved.contents,
+            ),
+        )
+
+    for keyword in [
+        "properties", "additionalProperties", "unevaluatedProperties",
+    ]:
+        if keyword in schema:
+            schema_value = schema[keyword]
+            if validator.is_type(schema_value, "boolean") and schema_value:
+                evaluated_keys += instance.keys()
+
+            elif validator.is_type(schema_value, "object"):
+                for property in schema_value:
+                    if property in instance:
+                        evaluated_keys.append(property)
+
+    if "patternProperties" in schema:
+        for property in instance:
+            for pattern in schema["patternProperties"]:
+                if re.search(pattern, property):
+                    evaluated_keys.append(property)
+
+    if "dependentSchemas" in schema:
+        for property, subschema in schema["dependentSchemas"].items():
+            if property not in instance:
+                continue
+            evaluated_keys += find_evaluated_property_keys_by_schema(
+                validator, instance, subschema,
+            )
+
+    for keyword in ["allOf", "oneOf", "anyOf"]:
+        if keyword in schema:
+            for subschema in schema[keyword]:
+                errs = next(validator.descend(instance, subschema), None)
+                if errs is None:
+                    evaluated_keys += find_evaluated_property_keys_by_schema(
+                        validator, instance, subschema,
+                    )
+
+    if "if" in schema:
+        if validator.evolve(schema=schema["if"]).is_valid(instance):
+            evaluated_keys += find_evaluated_property_keys_by_schema(
+                validator, instance, schema["if"],
+            )
+            if "then" in schema:
+                evaluated_keys += find_evaluated_property_keys_by_schema(
+                    validator, instance, schema["then"],
+                )
+        elif "else" in schema:
+            evaluated_keys += find_evaluated_property_keys_by_schema(
+                validator, instance, schema["else"],
+            )
+
+    return evaluated_keys
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/__init__.py b/llm/Lib/site-packages/jsonschema/benchmarks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e3dcc689930da95198c251ce806637d6413c8b1e
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/benchmarks/__init__.py
@@ -0,0 +1,5 @@
+"""
+Benchmarks for validation.
+
+This package is *not* public API.
+"""
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3cc087300fa956dfa19a90b6617da687560f2ae1
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/contains.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/contains.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9d3a73f28a30e9d41e06f8b6a8c972eef18efeec
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/contains.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/issue232.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/issue232.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..88961c68e5d7fb52e703068cb98038402c674414
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/issue232.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/json_schema_test_suite.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/json_schema_test_suite.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..95ccd2a6a5a9fd51bf9a8bbe7fb0845bd171e062
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/json_schema_test_suite.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/nested_schemas.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/nested_schemas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6721434562f49ef36aae502c57adad5503dc9e9e
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/nested_schemas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/subcomponents.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/subcomponents.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..83bd4e5720c08457e8b199d46d8e47986b9a0190
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/subcomponents.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/unused_registry.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/unused_registry.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b553549fd7122164329b3d6fd26a1dba5ef608d4
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/unused_registry.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/validator_creation.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/validator_creation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..35b0e5ba6c20c38610c77320b762665a284e6aa6
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/benchmarks/__pycache__/validator_creation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/contains.py b/llm/Lib/site-packages/jsonschema/benchmarks/contains.py
new file mode 100644
index 0000000000000000000000000000000000000000..739cd044cceb807b4029dca9447e954214a24809
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/benchmarks/contains.py
@@ -0,0 +1,28 @@
+"""
+A benchmark for validation of the `contains` keyword.
+"""
+
+from pyperf import Runner
+
+from jsonschema import Draft202012Validator
+
+schema = {
+    "type": "array",
+    "contains": {"const": 37},
+}
+validator = Draft202012Validator(schema)
+
+size = 1000
+beginning = [37] + [0] * (size - 1)
+middle = [0] * (size // 2) + [37] + [0] * (size // 2)
+end = [0] * (size - 1) + [37]
+invalid = [0] * size
+
+
+if __name__ == "__main__":
+    runner = Runner()
+    runner.bench_func("baseline", lambda: validator.is_valid([]))
+    runner.bench_func("beginning", lambda: validator.is_valid(beginning))
+    runner.bench_func("middle", lambda: validator.is_valid(middle))
+    runner.bench_func("end", lambda: validator.is_valid(end))
+    runner.bench_func("invalid", lambda: validator.is_valid(invalid))
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/issue232.py b/llm/Lib/site-packages/jsonschema/benchmarks/issue232.py
new file mode 100644
index 0000000000000000000000000000000000000000..efd07154822e4b0609900482eb26636fc3c100eb
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/benchmarks/issue232.py
@@ -0,0 +1,25 @@
+"""
+A performance benchmark using the example from issue #232.
+
+See https://github.com/python-jsonschema/jsonschema/pull/232.
+"""
+from pathlib import Path
+
+from pyperf import Runner
+from referencing import Registry
+
+from jsonschema.tests._suite import Version
+import jsonschema
+
+issue232 = Version(
+    path=Path(__file__).parent / "issue232",
+    remotes=Registry(),
+    name="issue232",
+)
+
+
+if __name__ == "__main__":
+    issue232.benchmark(
+        runner=Runner(),
+        Validator=jsonschema.Draft4Validator,
+    )
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/issue232/issue.json b/llm/Lib/site-packages/jsonschema/benchmarks/issue232/issue.json
new file mode 100644
index 0000000000000000000000000000000000000000..804c340845fa0694e8db1083cfe7c290c04f36b1
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/benchmarks/issue232/issue.json
@@ -0,0 +1,2653 @@
+[
+    {
+        "description": "Petstore",
+        "schema": {
+            "title": "A JSON Schema for Swagger 2.0 API.",
+            "id": "http://swagger.io/v2/schema.json#",
+            "$schema": "http://json-schema.org/draft-04/schema#",
+            "type": "object",
+            "required": [
+                "swagger",
+                "info",
+                "paths"
+            ],
+            "additionalProperties": false,
+            "patternProperties": {
+                "^x-": {
+                    "$ref": "#/definitions/vendorExtension"
+                }
+            },
+            "properties": {
+                "swagger": {
+                    "type": "string",
+                    "enum": [
+                        "2.0"
+                    ],
+                    "description": "The Swagger version of this document."
+                },
+                "info": {
+                    "$ref": "#/definitions/info"
+                },
+                "host": {
+                    "type": "string",
+                    "pattern": "^[^{}/ :\\\\]+(?::\\d+)?$",
+                    "description": "The host (name or ip) of the API. Example: 'swagger.io'"
+                },
+                "basePath": {
+                    "type": "string",
+                    "pattern": "^/",
+                    "description": "The base path to the API. Example: '/api'."
+                },
+                "schemes": {
+                    "$ref": "#/definitions/schemesList"
+                },
+                "consumes": {
+                    "description": "A list of MIME types accepted by the API.",
+                    "allOf": [
+                        {
+                            "$ref": "#/definitions/mediaTypeList"
+                        }
+                    ]
+                },
+                "produces": {
+                    "description": "A list of MIME types the API can produce.",
+                    "allOf": [
+                        {
+                            "$ref": "#/definitions/mediaTypeList"
+                        }
+                    ]
+                },
+                "paths": {
+                    "$ref": "#/definitions/paths"
+                },
+                "definitions": {
+                    "$ref": "#/definitions/definitions"
+                },
+                "parameters": {
+                    "$ref": "#/definitions/parameterDefinitions"
+                },
+                "responses": {
+                    "$ref": "#/definitions/responseDefinitions"
+                },
+                "security": {
+                    "$ref": "#/definitions/security"
+                },
+                "securityDefinitions": {
+                    "$ref": "#/definitions/securityDefinitions"
+                },
+                "tags": {
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/tag"
+                    },
+                    "uniqueItems": true
+                },
+                "externalDocs": {
+                    "$ref": "#/definitions/externalDocs"
+                }
+            },
+            "definitions": {
+                "info": {
+                    "type": "object",
+                    "description": "General information about the API.",
+                    "required": [
+                        "version",
+                        "title"
+                    ],
+                    "additionalProperties": false,
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    },
+                    "properties": {
+                        "title": {
+                            "type": "string",
+                            "description": "A unique and precise title of the API."
+                        },
+                        "version": {
+                            "type": "string",
+                            "description": "A semantic version number of the API."
+                        },
+                        "description": {
+                            "type": "string",
+                            "description": "A longer description of the API. Should be different from the title.  GitHub Flavored Markdown is allowed."
+                        },
+                        "termsOfService": {
+                            "type": "string",
+                            "description": "The terms of service for the API."
+                        },
+                        "contact": {
+                            "$ref": "#/definitions/contact"
+                        },
+                        "license": {
+                            "$ref": "#/definitions/license"
+                        }
+                    }
+                },
+                "contact": {
+                    "type": "object",
+                    "description": "Contact information for the owners of the API.",
+                    "additionalProperties": false,
+                    "properties": {
+                        "name": {
+                            "type": "string",
+                            "description": "The identifying name of the contact person/organization."
+                        },
+                        "url": {
+                            "type": "string",
+                            "description": "The URL pointing to the contact information.",
+                            "format": "uri"
+                        },
+                        "email": {
+                            "type": "string",
+                            "description": "The email address of the contact person/organization.",
+                            "format": "email"
+                        }
+                    },
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "license": {
+                    "type": "object",
+                    "required": [
+                        "name"
+                    ],
+                    "additionalProperties": false,
+                    "properties": {
+                        "name": {
+                            "type": "string",
+                            "description": "The name of the license type. It's encouraged to use an OSI compatible license."
+                        },
+                        "url": {
+                            "type": "string",
+                            "description": "The URL pointing to the license.",
+                            "format": "uri"
+                        }
+                    },
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "paths": {
+                    "type": "object",
+                    "description": "Relative paths to the individual endpoints. They must be relative to the 'basePath'.",
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        },
+                        "^/": {
+                            "$ref": "#/definitions/pathItem"
+                        }
+                    },
+                    "additionalProperties": false
+                },
+                "definitions": {
+                    "type": "object",
+                    "additionalProperties": {
+                        "$ref": "#/definitions/schema"
+                    },
+                    "description": "One or more JSON objects describing the schemas being consumed and produced by the API."
+                },
+                "parameterDefinitions": {
+                    "type": "object",
+                    "additionalProperties": {
+                        "$ref": "#/definitions/parameter"
+                    },
+                    "description": "One or more JSON representations for parameters"
+                },
+                "responseDefinitions": {
+                    "type": "object",
+                    "additionalProperties": {
+                        "$ref": "#/definitions/response"
+                    },
+                    "description": "One or more JSON representations for parameters"
+                },
+                "externalDocs": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "description": "information about external documentation",
+                    "required": [
+                        "url"
+                    ],
+                    "properties": {
+                        "description": {
+                            "type": "string"
+                        },
+                        "url": {
+                            "type": "string",
+                            "format": "uri"
+                        }
+                    },
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "examples": {
+                    "type": "object",
+                    "additionalProperties": true
+                },
+                "mimeType": {
+                    "type": "string",
+                    "description": "The MIME type of the HTTP message."
+                },
+                "operation": {
+                    "type": "object",
+                    "required": [
+                        "responses"
+                    ],
+                    "additionalProperties": false,
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    },
+                    "properties": {
+                        "tags": {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            },
+                            "uniqueItems": true
+                        },
+                        "summary": {
+                            "type": "string",
+                            "description": "A brief summary of the operation."
+                        },
+                        "description": {
+                            "type": "string",
+                            "description": "A longer description of the operation, GitHub Flavored Markdown is allowed."
+                        },
+                        "externalDocs": {
+                            "$ref": "#/definitions/externalDocs"
+                        },
+                        "operationId": {
+                            "type": "string",
+                            "description": "A unique identifier of the operation."
+                        },
+                        "produces": {
+                            "description": "A list of MIME types the API can produce.",
+                            "allOf": [
+                                {
+                                    "$ref": "#/definitions/mediaTypeList"
+                                }
+                            ]
+                        },
+                        "consumes": {
+                            "description": "A list of MIME types the API can consume.",
+                            "allOf": [
+                                {
+                                    "$ref": "#/definitions/mediaTypeList"
+                                }
+                            ]
+                        },
+                        "parameters": {
+                            "$ref": "#/definitions/parametersList"
+                        },
+                        "responses": {
+                            "$ref": "#/definitions/responses"
+                        },
+                        "schemes": {
+                            "$ref": "#/definitions/schemesList"
+                        },
+                        "deprecated": {
+                            "type": "boolean",
+                            "default": false
+                        },
+                        "security": {
+                            "$ref": "#/definitions/security"
+                        }
+                    }
+                },
+                "pathItem": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    },
+                    "properties": {
+                        "$ref": {
+                            "type": "string"
+                        },
+                        "get": {
+                            "$ref": "#/definitions/operation"
+                        },
+                        "put": {
+                            "$ref": "#/definitions/operation"
+                        },
+                        "post": {
+                            "$ref": "#/definitions/operation"
+                        },
+                        "delete": {
+                            "$ref": "#/definitions/operation"
+                        },
+                        "options": {
+                            "$ref": "#/definitions/operation"
+                        },
+                        "head": {
+                            "$ref": "#/definitions/operation"
+                        },
+                        "patch": {
+                            "$ref": "#/definitions/operation"
+                        },
+                        "parameters": {
+                            "$ref": "#/definitions/parametersList"
+                        }
+                    }
+                },
+                "responses": {
+                    "type": "object",
+                    "description": "Response objects names can either be any valid HTTP status code or 'default'.",
+                    "minProperties": 1,
+                    "additionalProperties": false,
+                    "patternProperties": {
+                        "^([0-9]{3})$|^(default)$": {
+                            "$ref": "#/definitions/responseValue"
+                        },
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    },
+                    "not": {
+                        "type": "object",
+                        "additionalProperties": false,
+                        "patternProperties": {
+                            "^x-": {
+                                "$ref": "#/definitions/vendorExtension"
+                            }
+                        }
+                    }
+                },
+                "responseValue": {
+                    "oneOf": [
+                        {
+                            "$ref": "#/definitions/response"
+                        },
+                        {
+                            "$ref": "#/definitions/jsonReference"
+                        }
+                    ]
+                },
+                "response": {
+                    "type": "object",
+                    "required": [
+                        "description"
+                    ],
+                    "properties": {
+                        "description": {
+                            "type": "string"
+                        },
+                        "schema": {
+                            "oneOf": [
+                                {
+                                    "$ref": "#/definitions/schema"
+                                },
+                                {
+                                    "$ref": "#/definitions/fileSchema"
+                                }
+                            ]
+                        },
+                        "headers": {
+                            "$ref": "#/definitions/headers"
+                        },
+                        "examples": {
+                            "$ref": "#/definitions/examples"
+                        }
+                    },
+                    "additionalProperties": false,
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "headers": {
+                    "type": "object",
+                    "additionalProperties": {
+                        "$ref": "#/definitions/header"
+                    }
+                },
+                "header": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": [
+                        "type"
+                    ],
+                    "properties": {
+                        "type": {
+                            "type": "string",
+                            "enum": [
+                                "string",
+                                "number",
+                                "integer",
+                                "boolean",
+                                "array"
+                            ]
+                        },
+                        "format": {
+                            "type": "string"
+                        },
+                        "items": {
+                            "$ref": "#/definitions/primitivesItems"
+                        },
+                        "collectionFormat": {
+                            "$ref": "#/definitions/collectionFormat"
+                        },
+                        "default": {
+                            "$ref": "#/definitions/default"
+                        },
+                        "maximum": {
+                            "$ref": "#/definitions/maximum"
+                        },
+                        "exclusiveMaximum": {
+                            "$ref": "#/definitions/exclusiveMaximum"
+                        },
+                        "minimum": {
+                            "$ref": "#/definitions/minimum"
+                        },
+                        "exclusiveMinimum": {
+                            "$ref": "#/definitions/exclusiveMinimum"
+                        },
+                        "maxLength": {
+                            "$ref": "#/definitions/maxLength"
+                        },
+                        "minLength": {
+                            "$ref": "#/definitions/minLength"
+                        },
+                        "pattern": {
+                            "$ref": "#/definitions/pattern"
+                        },
+                        "maxItems": {
+                            "$ref": "#/definitions/maxItems"
+                        },
+                        "minItems": {
+                            "$ref": "#/definitions/minItems"
+                        },
+                        "uniqueItems": {
+                            "$ref": "#/definitions/uniqueItems"
+                        },
+                        "enum": {
+                            "$ref": "#/definitions/enum"
+                        },
+                        "multipleOf": {
+                            "$ref": "#/definitions/multipleOf"
+                        },
+                        "description": {
+                            "type": "string"
+                        }
+                    },
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "vendorExtension": {
+                    "description": "Any property starting with x- is valid.",
+                    "additionalProperties": true,
+                    "additionalItems": true
+                },
+                "bodyParameter": {
+                    "type": "object",
+                    "required": [
+                        "name",
+                        "in",
+                        "schema"
+                    ],
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    },
+                    "properties": {
+                        "description": {
+                            "type": "string",
+                            "description": "A brief description of the parameter. This could contain examples of use.  GitHub Flavored Markdown is allowed."
+                        },
+                        "name": {
+                            "type": "string",
+                            "description": "The name of the parameter."
+                        },
+                        "in": {
+                            "type": "string",
+                            "description": "Determines the location of the parameter.",
+                            "enum": [
+                                "body"
+                            ]
+                        },
+                        "required": {
+                            "type": "boolean",
+                            "description": "Determines whether or not this parameter is required or optional.",
+                            "default": false
+                        },
+                        "schema": {
+                            "$ref": "#/definitions/schema"
+                        }
+                    },
+                    "additionalProperties": false
+                },
+                "headerParameterSubSchema": {
+                    "additionalProperties": false,
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    },
+                    "properties": {
+                        "required": {
+                            "type": "boolean",
+                            "description": "Determines whether or not this parameter is required or optional.",
+                            "default": false
+                        },
+                        "in": {
+                            "type": "string",
+                            "description": "Determines the location of the parameter.",
+                            "enum": [
+                                "header"
+                            ]
+                        },
+                        "description": {
+                            "type": "string",
+                            "description": "A brief description of the parameter. This could contain examples of use.  GitHub Flavored Markdown is allowed."
+                        },
+                        "name": {
+                            "type": "string",
+                            "description": "The name of the parameter."
+                        },
+                        "type": {
+                            "type": "string",
+                            "enum": [
+                                "string",
+                                "number",
+                                "boolean",
+                                "integer",
+                                "array"
+                            ]
+                        },
+                        "format": {
+                            "type": "string"
+                        },
+                        "items": {
+                            "$ref": "#/definitions/primitivesItems"
+                        },
+                        "collectionFormat": {
+                            "$ref": "#/definitions/collectionFormat"
+                        },
+                        "default": {
+                            "$ref": "#/definitions/default"
+                        },
+                        "maximum": {
+                            "$ref": "#/definitions/maximum"
+                        },
+                        "exclusiveMaximum": {
+                            "$ref": "#/definitions/exclusiveMaximum"
+                        },
+                        "minimum": {
+                            "$ref": "#/definitions/minimum"
+                        },
+                        "exclusiveMinimum": {
+                            "$ref": "#/definitions/exclusiveMinimum"
+                        },
+                        "maxLength": {
+                            "$ref": "#/definitions/maxLength"
+                        },
+                        "minLength": {
+                            "$ref": "#/definitions/minLength"
+                        },
+                        "pattern": {
+                            "$ref": "#/definitions/pattern"
+                        },
+                        "maxItems": {
+                            "$ref": "#/definitions/maxItems"
+                        },
+                        "minItems": {
+                            "$ref": "#/definitions/minItems"
+                        },
+                        "uniqueItems": {
+                            "$ref": "#/definitions/uniqueItems"
+                        },
+                        "enum": {
+                            "$ref": "#/definitions/enum"
+                        },
+                        "multipleOf": {
+                            "$ref": "#/definitions/multipleOf"
+                        }
+                    }
+                },
+                "queryParameterSubSchema": {
+                    "additionalProperties": false,
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    },
+                    "properties": {
+                        "required": {
+                            "type": "boolean",
+                            "description": "Determines whether or not this parameter is required or optional.",
+                            "default": false
+                        },
+                        "in": {
+                            "type": "string",
+                            "description": "Determines the location of the parameter.",
+                            "enum": [
+                                "query"
+                            ]
+                        },
+                        "description": {
+                            "type": "string",
+                            "description": "A brief description of the parameter. This could contain examples of use.  GitHub Flavored Markdown is allowed."
+                        },
+                        "name": {
+                            "type": "string",
+                            "description": "The name of the parameter."
+                        },
+                        "allowEmptyValue": {
+                            "type": "boolean",
+                            "default": false,
+                            "description": "allows sending a parameter by name only or with an empty value."
+                        },
+                        "type": {
+                            "type": "string",
+                            "enum": [
+                                "string",
+                                "number",
+                                "boolean",
+                                "integer",
+                                "array"
+                            ]
+                        },
+                        "format": {
+                            "type": "string"
+                        },
+                        "items": {
+                            "$ref": "#/definitions/primitivesItems"
+                        },
+                        "collectionFormat": {
+                            "$ref": "#/definitions/collectionFormatWithMulti"
+                        },
+                        "default": {
+                            "$ref": "#/definitions/default"
+                        },
+                        "maximum": {
+                            "$ref": "#/definitions/maximum"
+                        },
+                        "exclusiveMaximum": {
+                            "$ref": "#/definitions/exclusiveMaximum"
+                        },
+                        "minimum": {
+                            "$ref": "#/definitions/minimum"
+                        },
+                        "exclusiveMinimum": {
+                            "$ref": "#/definitions/exclusiveMinimum"
+                        },
+                        "maxLength": {
+                            "$ref": "#/definitions/maxLength"
+                        },
+                        "minLength": {
+                            "$ref": "#/definitions/minLength"
+                        },
+                        "pattern": {
+                            "$ref": "#/definitions/pattern"
+                        },
+                        "maxItems": {
+                            "$ref": "#/definitions/maxItems"
+                        },
+                        "minItems": {
+                            "$ref": "#/definitions/minItems"
+                        },
+                        "uniqueItems": {
+                            "$ref": "#/definitions/uniqueItems"
+                        },
+                        "enum": {
+                            "$ref": "#/definitions/enum"
+                        },
+                        "multipleOf": {
+                            "$ref": "#/definitions/multipleOf"
+                        }
+                    }
+                },
+                "formDataParameterSubSchema": {
+                    "additionalProperties": false,
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    },
+                    "properties": {
+                        "required": {
+                            "type": "boolean",
+                            "description": "Determines whether or not this parameter is required or optional.",
+                            "default": false
+                        },
+                        "in": {
+                            "type": "string",
+                            "description": "Determines the location of the parameter.",
+                            "enum": [
+                                "formData"
+                            ]
+                        },
+                        "description": {
+                            "type": "string",
+                            "description": "A brief description of the parameter. This could contain examples of use.  GitHub Flavored Markdown is allowed."
+                        },
+                        "name": {
+                            "type": "string",
+                            "description": "The name of the parameter."
+                        },
+                        "allowEmptyValue": {
+                            "type": "boolean",
+                            "default": false,
+                            "description": "allows sending a parameter by name only or with an empty value."
+                        },
+                        "type": {
+                            "type": "string",
+                            "enum": [
+                                "string",
+                                "number",
+                                "boolean",
+                                "integer",
+                                "array",
+                                "file"
+                            ]
+                        },
+                        "format": {
+                            "type": "string"
+                        },
+                        "items": {
+                            "$ref": "#/definitions/primitivesItems"
+                        },
+                        "collectionFormat": {
+                            "$ref": "#/definitions/collectionFormatWithMulti"
+                        },
+                        "default": {
+                            "$ref": "#/definitions/default"
+                        },
+                        "maximum": {
+                            "$ref": "#/definitions/maximum"
+                        },
+                        "exclusiveMaximum": {
+                            "$ref": "#/definitions/exclusiveMaximum"
+                        },
+                        "minimum": {
+                            "$ref": "#/definitions/minimum"
+                        },
+                        "exclusiveMinimum": {
+                            "$ref": "#/definitions/exclusiveMinimum"
+                        },
+                        "maxLength": {
+                            "$ref": "#/definitions/maxLength"
+                        },
+                        "minLength": {
+                            "$ref": "#/definitions/minLength"
+                        },
+                        "pattern": {
+                            "$ref": "#/definitions/pattern"
+                        },
+                        "maxItems": {
+                            "$ref": "#/definitions/maxItems"
+                        },
+                        "minItems": {
+                            "$ref": "#/definitions/minItems"
+                        },
+                        "uniqueItems": {
+                            "$ref": "#/definitions/uniqueItems"
+                        },
+                        "enum": {
+                            "$ref": "#/definitions/enum"
+                        },
+                        "multipleOf": {
+                            "$ref": "#/definitions/multipleOf"
+                        }
+                    }
+                },
+                "pathParameterSubSchema": {
+                    "additionalProperties": false,
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    },
+                    "required": [
+                        "required"
+                    ],
+                    "properties": {
+                        "required": {
+                            "type": "boolean",
+                            "enum": [
+                                true
+                            ],
+                            "description": "Determines whether or not this parameter is required or optional."
+                        },
+                        "in": {
+                            "type": "string",
+                            "description": "Determines the location of the parameter.",
+                            "enum": [
+                                "path"
+                            ]
+                        },
+                        "description": {
+                            "type": "string",
+                            "description": "A brief description of the parameter. This could contain examples of use.  GitHub Flavored Markdown is allowed."
+                        },
+                        "name": {
+                            "type": "string",
+                            "description": "The name of the parameter."
+                        },
+                        "type": {
+                            "type": "string",
+                            "enum": [
+                                "string",
+                                "number",
+                                "boolean",
+                                "integer",
+                                "array"
+                            ]
+                        },
+                        "format": {
+                            "type": "string"
+                        },
+                        "items": {
+                            "$ref": "#/definitions/primitivesItems"
+                        },
+                        "collectionFormat": {
+                            "$ref": "#/definitions/collectionFormat"
+                        },
+                        "default": {
+                            "$ref": "#/definitions/default"
+                        },
+                        "maximum": {
+                            "$ref": "#/definitions/maximum"
+                        },
+                        "exclusiveMaximum": {
+                            "$ref": "#/definitions/exclusiveMaximum"
+                        },
+                        "minimum": {
+                            "$ref": "#/definitions/minimum"
+                        },
+                        "exclusiveMinimum": {
+                            "$ref": "#/definitions/exclusiveMinimum"
+                        },
+                        "maxLength": {
+                            "$ref": "#/definitions/maxLength"
+                        },
+                        "minLength": {
+                            "$ref": "#/definitions/minLength"
+                        },
+                        "pattern": {
+                            "$ref": "#/definitions/pattern"
+                        },
+                        "maxItems": {
+                            "$ref": "#/definitions/maxItems"
+                        },
+                        "minItems": {
+                            "$ref": "#/definitions/minItems"
+                        },
+                        "uniqueItems": {
+                            "$ref": "#/definitions/uniqueItems"
+                        },
+                        "enum": {
+                            "$ref": "#/definitions/enum"
+                        },
+                        "multipleOf": {
+                            "$ref": "#/definitions/multipleOf"
+                        }
+                    }
+                },
+                "nonBodyParameter": {
+                    "type": "object",
+                    "required": [
+                        "name",
+                        "in",
+                        "type"
+                    ],
+                    "oneOf": [
+                        {
+                            "$ref": "#/definitions/headerParameterSubSchema"
+                        },
+                        {
+                            "$ref": "#/definitions/formDataParameterSubSchema"
+                        },
+                        {
+                            "$ref": "#/definitions/queryParameterSubSchema"
+                        },
+                        {
+                            "$ref": "#/definitions/pathParameterSubSchema"
+                        }
+                    ]
+                },
+                "parameter": {
+                    "oneOf": [
+                        {
+                            "$ref": "#/definitions/bodyParameter"
+                        },
+                        {
+                            "$ref": "#/definitions/nonBodyParameter"
+                        }
+                    ]
+                },
+                "schema": {
+                    "type": "object",
+                    "description": "A deterministic version of a JSON Schema object.",
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    },
+                    "properties": {
+                        "$ref": {
+                            "type": "string"
+                        },
+                        "format": {
+                            "type": "string"
+                        },
+                        "title": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/title"
+                        },
+                        "description": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/description"
+                        },
+                        "default": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/default"
+                        },
+                        "multipleOf": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/multipleOf"
+                        },
+                        "maximum": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/maximum"
+                        },
+                        "exclusiveMaximum": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMaximum"
+                        },
+                        "minimum": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/minimum"
+                        },
+                        "exclusiveMinimum": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMinimum"
+                        },
+                        "maxLength": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
+                        },
+                        "minLength": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
+                        },
+                        "pattern": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/pattern"
+                        },
+                        "maxItems": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
+                        },
+                        "minItems": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
+                        },
+                        "uniqueItems": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/uniqueItems"
+                        },
+                        "maxProperties": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
+                        },
+                        "minProperties": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
+                        },
+                        "required": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/definitions/stringArray"
+                        },
+                        "enum": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/enum"
+                        },
+                        "additionalProperties": {
+                            "anyOf": [
+                                {
+                                    "$ref": "#/definitions/schema"
+                                },
+                                {
+                                    "type": "boolean"
+                                }
+                            ],
+                            "default": {}
+                        },
+                        "type": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/type"
+                        },
+                        "items": {
+                            "anyOf": [
+                                {
+                                    "$ref": "#/definitions/schema"
+                                },
+                                {
+                                    "type": "array",
+                                    "minItems": 1,
+                                    "items": {
+                                        "$ref": "#/definitions/schema"
+                                    }
+                                }
+                            ],
+                            "default": {}
+                        },
+                        "allOf": {
+                            "type": "array",
+                            "minItems": 1,
+                            "items": {
+                                "$ref": "#/definitions/schema"
+                            }
+                        },
+                        "properties": {
+                            "type": "object",
+                            "additionalProperties": {
+                                "$ref": "#/definitions/schema"
+                            },
+                            "default": {}
+                        },
+                        "discriminator": {
+                            "type": "string"
+                        },
+                        "readOnly": {
+                            "type": "boolean",
+                            "default": false
+                        },
+                        "xml": {
+                            "$ref": "#/definitions/xml"
+                        },
+                        "externalDocs": {
+                            "$ref": "#/definitions/externalDocs"
+                        },
+                        "example": {}
+                    },
+                    "additionalProperties": false
+                },
+                "fileSchema": {
+                    "type": "object",
+                    "description": "A deterministic version of a JSON Schema object.",
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    },
+                    "required": [
+                        "type"
+                    ],
+                    "properties": {
+                        "format": {
+                            "type": "string"
+                        },
+                        "title": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/title"
+                        },
+                        "description": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/description"
+                        },
+                        "default": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/properties/default"
+                        },
+                        "required": {
+                            "$ref": "http://json-schema.org/draft-04/schema#/definitions/stringArray"
+                        },
+                        "type": {
+                            "type": "string",
+                            "enum": [
+                                "file"
+                            ]
+                        },
+                        "readOnly": {
+                            "type": "boolean",
+                            "default": false
+                        },
+                        "externalDocs": {
+                            "$ref": "#/definitions/externalDocs"
+                        },
+                        "example": {}
+                    },
+                    "additionalProperties": false
+                },
+                "primitivesItems": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "type": {
+                            "type": "string",
+                            "enum": [
+                                "string",
+                                "number",
+                                "integer",
+                                "boolean",
+                                "array"
+                            ]
+                        },
+                        "format": {
+                            "type": "string"
+                        },
+                        "items": {
+                            "$ref": "#/definitions/primitivesItems"
+                        },
+                        "collectionFormat": {
+                            "$ref": "#/definitions/collectionFormat"
+                        },
+                        "default": {
+                            "$ref": "#/definitions/default"
+                        },
+                        "maximum": {
+                            "$ref": "#/definitions/maximum"
+                        },
+                        "exclusiveMaximum": {
+                            "$ref": "#/definitions/exclusiveMaximum"
+                        },
+                        "minimum": {
+                            "$ref": "#/definitions/minimum"
+                        },
+                        "exclusiveMinimum": {
+                            "$ref": "#/definitions/exclusiveMinimum"
+                        },
+                        "maxLength": {
+                            "$ref": "#/definitions/maxLength"
+                        },
+                        "minLength": {
+                            "$ref": "#/definitions/minLength"
+                        },
+                        "pattern": {
+                            "$ref": "#/definitions/pattern"
+                        },
+                        "maxItems": {
+                            "$ref": "#/definitions/maxItems"
+                        },
+                        "minItems": {
+                            "$ref": "#/definitions/minItems"
+                        },
+                        "uniqueItems": {
+                            "$ref": "#/definitions/uniqueItems"
+                        },
+                        "enum": {
+                            "$ref": "#/definitions/enum"
+                        },
+                        "multipleOf": {
+                            "$ref": "#/definitions/multipleOf"
+                        }
+                    },
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "security": {
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/securityRequirement"
+                    },
+                    "uniqueItems": true
+                },
+                "securityRequirement": {
+                    "type": "object",
+                    "additionalProperties": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        },
+                        "uniqueItems": true
+                    }
+                },
+                "xml": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                        "name": {
+                            "type": "string"
+                        },
+                        "namespace": {
+                            "type": "string"
+                        },
+                        "prefix": {
+                            "type": "string"
+                        },
+                        "attribute": {
+                            "type": "boolean",
+                            "default": false
+                        },
+                        "wrapped": {
+                            "type": "boolean",
+                            "default": false
+                        }
+                    },
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "tag": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": [
+                        "name"
+                    ],
+                    "properties": {
+                        "name": {
+                            "type": "string"
+                        },
+                        "description": {
+                            "type": "string"
+                        },
+                        "externalDocs": {
+                            "$ref": "#/definitions/externalDocs"
+                        }
+                    },
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "securityDefinitions": {
+                    "type": "object",
+                    "additionalProperties": {
+                        "oneOf": [
+                            {
+                                "$ref": "#/definitions/basicAuthenticationSecurity"
+                            },
+                            {
+                                "$ref": "#/definitions/apiKeySecurity"
+                            },
+                            {
+                                "$ref": "#/definitions/oauth2ImplicitSecurity"
+                            },
+                            {
+                                "$ref": "#/definitions/oauth2PasswordSecurity"
+                            },
+                            {
+                                "$ref": "#/definitions/oauth2ApplicationSecurity"
+                            },
+                            {
+                                "$ref": "#/definitions/oauth2AccessCodeSecurity"
+                            }
+                        ]
+                    }
+                },
+                "basicAuthenticationSecurity": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": [
+                        "type"
+                    ],
+                    "properties": {
+                        "type": {
+                            "type": "string",
+                            "enum": [
+                                "basic"
+                            ]
+                        },
+                        "description": {
+                            "type": "string"
+                        }
+                    },
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "apiKeySecurity": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": [
+                        "type",
+                        "name",
+                        "in"
+                    ],
+                    "properties": {
+                        "type": {
+                            "type": "string",
+                            "enum": [
+                                "apiKey"
+                            ]
+                        },
+                        "name": {
+                            "type": "string"
+                        },
+                        "in": {
+                            "type": "string",
+                            "enum": [
+                                "header",
+                                "query"
+                            ]
+                        },
+                        "description": {
+                            "type": "string"
+                        }
+                    },
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "oauth2ImplicitSecurity": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": [
+                        "type",
+                        "flow",
+                        "authorizationUrl"
+                    ],
+                    "properties": {
+                        "type": {
+                            "type": "string",
+                            "enum": [
+                                "oauth2"
+                            ]
+                        },
+                        "flow": {
+                            "type": "string",
+                            "enum": [
+                                "implicit"
+                            ]
+                        },
+                        "scopes": {
+                            "$ref": "#/definitions/oauth2Scopes"
+                        },
+                        "authorizationUrl": {
+                            "type": "string",
+                            "format": "uri"
+                        },
+                        "description": {
+                            "type": "string"
+                        }
+                    },
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "oauth2PasswordSecurity": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": [
+                        "type",
+                        "flow",
+                        "tokenUrl"
+                    ],
+                    "properties": {
+                        "type": {
+                            "type": "string",
+                            "enum": [
+                                "oauth2"
+                            ]
+                        },
+                        "flow": {
+                            "type": "string",
+                            "enum": [
+                                "password"
+                            ]
+                        },
+                        "scopes": {
+                            "$ref": "#/definitions/oauth2Scopes"
+                        },
+                        "tokenUrl": {
+                            "type": "string",
+                            "format": "uri"
+                        },
+                        "description": {
+                            "type": "string"
+                        }
+                    },
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "oauth2ApplicationSecurity": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": [
+                        "type",
+                        "flow",
+                        "tokenUrl"
+                    ],
+                    "properties": {
+                        "type": {
+                            "type": "string",
+                            "enum": [
+                                "oauth2"
+                            ]
+                        },
+                        "flow": {
+                            "type": "string",
+                            "enum": [
+                                "application"
+                            ]
+                        },
+                        "scopes": {
+                            "$ref": "#/definitions/oauth2Scopes"
+                        },
+                        "tokenUrl": {
+                            "type": "string",
+                            "format": "uri"
+                        },
+                        "description": {
+                            "type": "string"
+                        }
+                    },
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "oauth2AccessCodeSecurity": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": [
+                        "type",
+                        "flow",
+                        "authorizationUrl",
+                        "tokenUrl"
+                    ],
+                    "properties": {
+                        "type": {
+                            "type": "string",
+                            "enum": [
+                                "oauth2"
+                            ]
+                        },
+                        "flow": {
+                            "type": "string",
+                            "enum": [
+                                "accessCode"
+                            ]
+                        },
+                        "scopes": {
+                            "$ref": "#/definitions/oauth2Scopes"
+                        },
+                        "authorizationUrl": {
+                            "type": "string",
+                            "format": "uri"
+                        },
+                        "tokenUrl": {
+                            "type": "string",
+                            "format": "uri"
+                        },
+                        "description": {
+                            "type": "string"
+                        }
+                    },
+                    "patternProperties": {
+                        "^x-": {
+                            "$ref": "#/definitions/vendorExtension"
+                        }
+                    }
+                },
+                "oauth2Scopes": {
+                    "type": "object",
+                    "additionalProperties": {
+                        "type": "string"
+                    }
+                },
+                "mediaTypeList": {
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/mimeType"
+                    },
+                    "uniqueItems": true
+                },
+                "parametersList": {
+                    "type": "array",
+                    "description": "The parameters needed to send a valid API call.",
+                    "additionalItems": false,
+                    "items": {
+                        "oneOf": [
+                            {
+                                "$ref": "#/definitions/parameter"
+                            },
+                            {
+                                "$ref": "#/definitions/jsonReference"
+                            }
+                        ]
+                    },
+                    "uniqueItems": true
+                },
+                "schemesList": {
+                    "type": "array",
+                    "description": "The transfer protocol of the API.",
+                    "items": {
+                        "type": "string",
+                        "enum": [
+                            "http",
+                            "https",
+                            "ws",
+                            "wss"
+                        ]
+                    },
+                    "uniqueItems": true
+                },
+                "collectionFormat": {
+                    "type": "string",
+                    "enum": [
+                        "csv",
+                        "ssv",
+                        "tsv",
+                        "pipes"
+                    ],
+                    "default": "csv"
+                },
+                "collectionFormatWithMulti": {
+                    "type": "string",
+                    "enum": [
+                        "csv",
+                        "ssv",
+                        "tsv",
+                        "pipes",
+                        "multi"
+                    ],
+                    "default": "csv"
+                },
+                "title": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/properties/title"
+                },
+                "description": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/properties/description"
+                },
+                "default": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/properties/default"
+                },
+                "multipleOf": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/properties/multipleOf"
+                },
+                "maximum": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/properties/maximum"
+                },
+                "exclusiveMaximum": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMaximum"
+                },
+                "minimum": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/properties/minimum"
+                },
+                "exclusiveMinimum": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMinimum"
+                },
+                "maxLength": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
+                },
+                "minLength": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
+                },
+                "pattern": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/properties/pattern"
+                },
+                "maxItems": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
+                },
+                "minItems": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
+                },
+                "uniqueItems": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/properties/uniqueItems"
+                },
+                "enum": {
+                    "$ref": "http://json-schema.org/draft-04/schema#/properties/enum"
+                },
+                "jsonReference": {
+                    "type": "object",
+                    "required": [
+                        "$ref"
+                    ],
+                    "additionalProperties": false,
+                    "properties": {
+                        "$ref": {
+                            "type": "string"
+                        }
+                    }
+                }
+            }
+        },
+        "tests": [
+            {
+                "description": "Example petsore",
+                "data": {
+                    "swagger": "2.0",
+                    "info": {
+                        "description": "This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.",
+                        "version": "1.0.0",
+                        "title": "Swagger Petstore",
+                        "termsOfService": "http://swagger.io/terms/",
+                        "contact": {
+                            "email": "apiteam@swagger.io"
+                        },
+                        "license": {
+                            "name": "Apache 2.0",
+                            "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
+                        }
+                    },
+                    "host": "petstore.swagger.io",
+                    "basePath": "/v2",
+                    "tags": [
+                        {
+                            "name": "pet",
+                            "description": "Everything about your Pets",
+                            "externalDocs": {
+                                "description": "Find out more",
+                                "url": "http://swagger.io"
+                            }
+                        },
+                        {
+                            "name": "store",
+                            "description": "Access to Petstore orders"
+                        },
+                        {
+                            "name": "user",
+                            "description": "Operations about user",
+                            "externalDocs": {
+                                "description": "Find out more about our store",
+                                "url": "http://swagger.io"
+                            }
+                        }
+                    ],
+                    "schemes": [
+                        "http"
+                    ],
+                    "paths": {
+                        "/pet": {
+                            "post": {
+                                "tags": [
+                                    "pet"
+                                ],
+                                "summary": "Add a new pet to the store",
+                                "description": "",
+                                "operationId": "addPet",
+                                "consumes": [
+                                    "application/json",
+                                    "application/xml"
+                                ],
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "in": "body",
+                                        "name": "body",
+                                        "description": "Pet object that needs to be added to the store",
+                                        "required": true,
+                                        "schema": {
+                                            "$ref": "#/definitions/Pet"
+                                        }
+                                    }
+                                ],
+                                "responses": {
+                                    "405": {
+                                        "description": "Invalid input"
+                                    }
+                                },
+                                "security": [
+                                    {
+                                        "petstore_auth": [
+                                            "write:pets",
+                                            "read:pets"
+                                        ]
+                                    }
+                                ]
+                            },
+                            "put": {
+                                "tags": [
+                                    "pet"
+                                ],
+                                "summary": "Update an existing pet",
+                                "description": "",
+                                "operationId": "updatePet",
+                                "consumes": [
+                                    "application/json",
+                                    "application/xml"
+                                ],
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "in": "body",
+                                        "name": "body",
+                                        "description": "Pet object that needs to be added to the store",
+                                        "required": true,
+                                        "schema": {
+                                            "$ref": "#/definitions/Pet"
+                                        }
+                                    }
+                                ],
+                                "responses": {
+                                    "400": {
+                                        "description": "Invalid ID supplied"
+                                    },
+                                    "404": {
+                                        "description": "Pet not found"
+                                    },
+                                    "405": {
+                                        "description": "Validation exception"
+                                    }
+                                },
+                                "security": [
+                                    {
+                                        "petstore_auth": [
+                                            "write:pets",
+                                            "read:pets"
+                                        ]
+                                    }
+                                ]
+                            }
+                        },
+                        "/pet/findByStatus": {
+                            "get": {
+                                "tags": [
+                                    "pet"
+                                ],
+                                "summary": "Finds Pets by status",
+                                "description": "Multiple status values can be provided with comma separated strings",
+                                "operationId": "findPetsByStatus",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "name": "status",
+                                        "in": "query",
+                                        "description": "Status values that need to be considered for filter",
+                                        "required": true,
+                                        "type": "array",
+                                        "items": {
+                                            "type": "string",
+                                            "enum": [
+                                                "available",
+                                                "pending",
+                                                "sold"
+                                            ],
+                                            "default": "available"
+                                        },
+                                        "collectionFormat": "multi"
+                                    }
+                                ],
+                                "responses": {
+                                    "200": {
+                                        "description": "successful operation",
+                                        "schema": {
+                                            "type": "array",
+                                            "items": {
+                                                "$ref": "#/definitions/Pet"
+                                            }
+                                        }
+                                    },
+                                    "400": {
+                                        "description": "Invalid status value"
+                                    }
+                                },
+                                "security": [
+                                    {
+                                        "petstore_auth": [
+                                            "write:pets",
+                                            "read:pets"
+                                        ]
+                                    }
+                                ]
+                            }
+                        },
+                        "/pet/findByTags": {
+                            "get": {
+                                "tags": [
+                                    "pet"
+                                ],
+                                "summary": "Finds Pets by tags",
+                                "description": "Muliple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.",
+                                "operationId": "findPetsByTags",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "name": "tags",
+                                        "in": "query",
+                                        "description": "Tags to filter by",
+                                        "required": true,
+                                        "type": "array",
+                                        "items": {
+                                            "type": "string"
+                                        },
+                                        "collectionFormat": "multi"
+                                    }
+                                ],
+                                "responses": {
+                                    "200": {
+                                        "description": "successful operation",
+                                        "schema": {
+                                            "type": "array",
+                                            "items": {
+                                                "$ref": "#/definitions/Pet"
+                                            }
+                                        }
+                                    },
+                                    "400": {
+                                        "description": "Invalid tag value"
+                                    }
+                                },
+                                "security": [
+                                    {
+                                        "petstore_auth": [
+                                            "write:pets",
+                                            "read:pets"
+                                        ]
+                                    }
+                                ],
+                                "deprecated": true
+                            }
+                        },
+                        "/pet/{petId}": {
+                            "get": {
+                                "tags": [
+                                    "pet"
+                                ],
+                                "summary": "Find pet by ID",
+                                "description": "Returns a single pet",
+                                "operationId": "getPetById",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "name": "petId",
+                                        "in": "path",
+                                        "description": "ID of pet to return",
+                                        "required": true,
+                                        "type": "integer",
+                                        "format": "int64"
+                                    }
+                                ],
+                                "responses": {
+                                    "200": {
+                                        "description": "successful operation",
+                                        "schema": {
+                                            "$ref": "#/definitions/Pet"
+                                        }
+                                    },
+                                    "400": {
+                                        "description": "Invalid ID supplied"
+                                    },
+                                    "404": {
+                                        "description": "Pet not found"
+                                    }
+                                },
+                                "security": [
+                                    {
+                                        "api_key": []
+                                    }
+                                ]
+                            },
+                            "post": {
+                                "tags": [
+                                    "pet"
+                                ],
+                                "summary": "Updates a pet in the store with form data",
+                                "description": "",
+                                "operationId": "updatePetWithForm",
+                                "consumes": [
+                                    "application/x-www-form-urlencoded"
+                                ],
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "name": "petId",
+                                        "in": "path",
+                                        "description": "ID of pet that needs to be updated",
+                                        "required": true,
+                                        "type": "integer",
+                                        "format": "int64"
+                                    },
+                                    {
+                                        "name": "name",
+                                        "in": "formData",
+                                        "description": "Updated name of the pet",
+                                        "required": false,
+                                        "type": "string"
+                                    },
+                                    {
+                                        "name": "status",
+                                        "in": "formData",
+                                        "description": "Updated status of the pet",
+                                        "required": false,
+                                        "type": "string"
+                                    }
+                                ],
+                                "responses": {
+                                    "405": {
+                                        "description": "Invalid input"
+                                    }
+                                },
+                                "security": [
+                                    {
+                                        "petstore_auth": [
+                                            "write:pets",
+                                            "read:pets"
+                                        ]
+                                    }
+                                ]
+                            },
+                            "delete": {
+                                "tags": [
+                                    "pet"
+                                ],
+                                "summary": "Deletes a pet",
+                                "description": "",
+                                "operationId": "deletePet",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "name": "api_key",
+                                        "in": "header",
+                                        "required": false,
+                                        "type": "string"
+                                    },
+                                    {
+                                        "name": "petId",
+                                        "in": "path",
+                                        "description": "Pet id to delete",
+                                        "required": true,
+                                        "type": "integer",
+                                        "format": "int64"
+                                    }
+                                ],
+                                "responses": {
+                                    "400": {
+                                        "description": "Invalid ID supplied"
+                                    },
+                                    "404": {
+                                        "description": "Pet not found"
+                                    }
+                                },
+                                "security": [
+                                    {
+                                        "petstore_auth": [
+                                            "write:pets",
+                                            "read:pets"
+                                        ]
+                                    }
+                                ]
+                            }
+                        },
+                        "/pet/{petId}/uploadImage": {
+                            "post": {
+                                "tags": [
+                                    "pet"
+                                ],
+                                "summary": "uploads an image",
+                                "description": "",
+                                "operationId": "uploadFile",
+                                "consumes": [
+                                    "multipart/form-data"
+                                ],
+                                "produces": [
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "name": "petId",
+                                        "in": "path",
+                                        "description": "ID of pet to update",
+                                        "required": true,
+                                        "type": "integer",
+                                        "format": "int64"
+                                    },
+                                    {
+                                        "name": "additionalMetadata",
+                                        "in": "formData",
+                                        "description": "Additional data to pass to server",
+                                        "required": false,
+                                        "type": "string"
+                                    },
+                                    {
+                                        "name": "file",
+                                        "in": "formData",
+                                        "description": "file to upload",
+                                        "required": false,
+                                        "type": "file"
+                                    }
+                                ],
+                                "responses": {
+                                    "200": {
+                                        "description": "successful operation",
+                                        "schema": {
+                                            "$ref": "#/definitions/ApiResponse"
+                                        }
+                                    }
+                                },
+                                "security": [
+                                    {
+                                        "petstore_auth": [
+                                            "write:pets",
+                                            "read:pets"
+                                        ]
+                                    }
+                                ]
+                            }
+                        },
+                        "/store/inventory": {
+                            "get": {
+                                "tags": [
+                                    "store"
+                                ],
+                                "summary": "Returns pet inventories by status",
+                                "description": "Returns a map of status codes to quantities",
+                                "operationId": "getInventory",
+                                "produces": [
+                                    "application/json"
+                                ],
+                                "parameters": [],
+                                "responses": {
+                                    "200": {
+                                        "description": "successful operation",
+                                        "schema": {
+                                            "type": "object",
+                                            "additionalProperties": {
+                                                "type": "integer",
+                                                "format": "int32"
+                                            }
+                                        }
+                                    }
+                                },
+                                "security": [
+                                    {
+                                        "api_key": []
+                                    }
+                                ]
+                            }
+                        },
+                        "/store/order": {
+                            "post": {
+                                "tags": [
+                                    "store"
+                                ],
+                                "summary": "Place an order for a pet",
+                                "description": "",
+                                "operationId": "placeOrder",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "in": "body",
+                                        "name": "body",
+                                        "description": "order placed for purchasing the pet",
+                                        "required": true,
+                                        "schema": {
+                                            "$ref": "#/definitions/Order"
+                                        }
+                                    }
+                                ],
+                                "responses": {
+                                    "200": {
+                                        "description": "successful operation",
+                                        "schema": {
+                                            "$ref": "#/definitions/Order"
+                                        }
+                                    },
+                                    "400": {
+                                        "description": "Invalid Order"
+                                    }
+                                }
+                            }
+                        },
+                        "/store/order/{orderId}": {
+                            "get": {
+                                "tags": [
+                                    "store"
+                                ],
+                                "summary": "Find purchase order by ID",
+                                "description": "For valid response try integer IDs with value >= 1 and <= 10. Other values will generated exceptions",
+                                "operationId": "getOrderById",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "name": "orderId",
+                                        "in": "path",
+                                        "description": "ID of pet that needs to be fetched",
+                                        "required": true,
+                                        "type": "integer",
+                                        "maximum": 10.0,
+                                        "minimum": 1.0,
+                                        "format": "int64"
+                                    }
+                                ],
+                                "responses": {
+                                    "200": {
+                                        "description": "successful operation",
+                                        "schema": {
+                                            "$ref": "#/definitions/Order"
+                                        }
+                                    },
+                                    "400": {
+                                        "description": "Invalid ID supplied"
+                                    },
+                                    "404": {
+                                        "description": "Order not found"
+                                    }
+                                }
+                            },
+                            "delete": {
+                                "tags": [
+                                    "store"
+                                ],
+                                "summary": "Delete purchase order by ID",
+                                "description": "For valid response try integer IDs with positive integer value. Negative or non-integer values will generate API errors",
+                                "operationId": "deleteOrder",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "name": "orderId",
+                                        "in": "path",
+                                        "description": "ID of the order that needs to be deleted",
+                                        "required": true,
+                                        "type": "integer",
+                                        "minimum": 1.0,
+                                        "format": "int64"
+                                    }
+                                ],
+                                "responses": {
+                                    "400": {
+                                        "description": "Invalid ID supplied"
+                                    },
+                                    "404": {
+                                        "description": "Order not found"
+                                    }
+                                }
+                            }
+                        },
+                        "/user": {
+                            "post": {
+                                "tags": [
+                                    "user"
+                                ],
+                                "summary": "Create user",
+                                "description": "This can only be done by the logged in user.",
+                                "operationId": "createUser",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "in": "body",
+                                        "name": "body",
+                                        "description": "Created user object",
+                                        "required": true,
+                                        "schema": {
+                                            "$ref": "#/definitions/User"
+                                        }
+                                    }
+                                ],
+                                "responses": {
+                                    "default": {
+                                        "description": "successful operation"
+                                    }
+                                }
+                            }
+                        },
+                        "/user/createWithArray": {
+                            "post": {
+                                "tags": [
+                                    "user"
+                                ],
+                                "summary": "Creates list of users with given input array",
+                                "description": "",
+                                "operationId": "createUsersWithArrayInput",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "in": "body",
+                                        "name": "body",
+                                        "description": "List of user object",
+                                        "required": true,
+                                        "schema": {
+                                            "type": "array",
+                                            "items": {
+                                                "$ref": "#/definitions/User"
+                                            }
+                                        }
+                                    }
+                                ],
+                                "responses": {
+                                    "default": {
+                                        "description": "successful operation"
+                                    }
+                                }
+                            }
+                        },
+                        "/user/createWithList": {
+                            "post": {
+                                "tags": [
+                                    "user"
+                                ],
+                                "summary": "Creates list of users with given input array",
+                                "description": "",
+                                "operationId": "createUsersWithListInput",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "in": "body",
+                                        "name": "body",
+                                        "description": "List of user object",
+                                        "required": true,
+                                        "schema": {
+                                            "type": "array",
+                                            "items": {
+                                                "$ref": "#/definitions/User"
+                                            }
+                                        }
+                                    }
+                                ],
+                                "responses": {
+                                    "default": {
+                                        "description": "successful operation"
+                                    }
+                                }
+                            }
+                        },
+                        "/user/login": {
+                            "get": {
+                                "tags": [
+                                    "user"
+                                ],
+                                "summary": "Logs user into the system",
+                                "description": "",
+                                "operationId": "loginUser",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "name": "username",
+                                        "in": "query",
+                                        "description": "The user name for login",
+                                        "required": true,
+                                        "type": "string"
+                                    },
+                                    {
+                                        "name": "password",
+                                        "in": "query",
+                                        "description": "The password for login in clear text",
+                                        "required": true,
+                                        "type": "string"
+                                    }
+                                ],
+                                "responses": {
+                                    "200": {
+                                        "description": "successful operation",
+                                        "schema": {
+                                            "type": "string"
+                                        },
+                                        "headers": {
+                                            "X-Rate-Limit": {
+                                                "type": "integer",
+                                                "format": "int32",
+                                                "description": "calls per hour allowed by the user"
+                                            },
+                                            "X-Expires-After": {
+                                                "type": "string",
+                                                "format": "date-time",
+                                                "description": "date in UTC when token expires"
+                                            }
+                                        }
+                                    },
+                                    "400": {
+                                        "description": "Invalid username/password supplied"
+                                    }
+                                }
+                            }
+                        },
+                        "/user/logout": {
+                            "get": {
+                                "tags": [
+                                    "user"
+                                ],
+                                "summary": "Logs out current logged in user session",
+                                "description": "",
+                                "operationId": "logoutUser",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [],
+                                "responses": {
+                                    "default": {
+                                        "description": "successful operation"
+                                    }
+                                }
+                            }
+                        },
+                        "/user/{username}": {
+                            "get": {
+                                "tags": [
+                                    "user"
+                                ],
+                                "summary": "Get user by user name",
+                                "description": "",
+                                "operationId": "getUserByName",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "name": "username",
+                                        "in": "path",
+                                        "description": "The name that needs to be fetched. Use user1 for testing. ",
+                                        "required": true,
+                                        "type": "string"
+                                    }
+                                ],
+                                "responses": {
+                                    "200": {
+                                        "description": "successful operation",
+                                        "schema": {
+                                            "$ref": "#/definitions/User"
+                                        }
+                                    },
+                                    "400": {
+                                        "description": "Invalid username supplied"
+                                    },
+                                    "404": {
+                                        "description": "User not found"
+                                    }
+                                }
+                            },
+                            "put": {
+                                "tags": [
+                                    "user"
+                                ],
+                                "summary": "Updated user",
+                                "description": "This can only be done by the logged in user.",
+                                "operationId": "updateUser",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "name": "username",
+                                        "in": "path",
+                                        "description": "name that need to be updated",
+                                        "required": true,
+                                        "type": "string"
+                                    },
+                                    {
+                                        "in": "body",
+                                        "name": "body",
+                                        "description": "Updated user object",
+                                        "required": true,
+                                        "schema": {
+                                            "$ref": "#/definitions/User"
+                                        }
+                                    }
+                                ],
+                                "responses": {
+                                    "400": {
+                                        "description": "Invalid user supplied"
+                                    },
+                                    "404": {
+                                        "description": "User not found"
+                                    }
+                                }
+                            },
+                            "delete": {
+                                "tags": [
+                                    "user"
+                                ],
+                                "summary": "Delete user",
+                                "description": "This can only be done by the logged in user.",
+                                "operationId": "deleteUser",
+                                "produces": [
+                                    "application/xml",
+                                    "application/json"
+                                ],
+                                "parameters": [
+                                    {
+                                        "name": "username",
+                                        "in": "path",
+                                        "description": "The name that needs to be deleted",
+                                        "required": true,
+                                        "type": "string"
+                                    }
+                                ],
+                                "responses": {
+                                    "400": {
+                                        "description": "Invalid username supplied"
+                                    },
+                                    "404": {
+                                        "description": "User not found"
+                                    }
+                                }
+                            }
+                        }
+                    },
+                    "securityDefinitions": {
+                        "petstore_auth": {
+                            "type": "oauth2",
+                            "authorizationUrl": "http://petstore.swagger.io/oauth/dialog",
+                            "flow": "implicit",
+                            "scopes": {
+                                "write:pets": "modify pets in your account",
+                                "read:pets": "read your pets"
+                            }
+                        },
+                        "api_key": {
+                            "type": "apiKey",
+                            "name": "api_key",
+                            "in": "header"
+                        }
+                    },
+                    "definitions": {
+                        "Order": {
+                            "type": "object",
+                            "properties": {
+                                "id": {
+                                    "type": "integer",
+                                    "format": "int64"
+                                },
+                                "petId": {
+                                    "type": "integer",
+                                    "format": "int64"
+                                },
+                                "quantity": {
+                                    "type": "integer",
+                                    "format": "int32"
+                                },
+                                "shipDate": {
+                                    "type": "string",
+                                    "format": "date-time"
+                                },
+                                "status": {
+                                    "type": "string",
+                                    "description": "Order Status",
+                                    "enum": [
+                                        "placed",
+                                        "approved",
+                                        "delivered"
+                                    ]
+                                },
+                                "complete": {
+                                    "type": "boolean",
+                                    "default": false
+                                }
+                            },
+                            "xml": {
+                                "name": "Order"
+                            }
+                        },
+                        "Category": {
+                            "type": "object",
+                            "properties": {
+                                "id": {
+                                    "type": "integer",
+                                    "format": "int64"
+                                },
+                                "name": {
+                                    "type": "string"
+                                }
+                            },
+                            "xml": {
+                                "name": "Category"
+                            }
+                        },
+                        "User": {
+                            "type": "object",
+                            "properties": {
+                                "id": {
+                                    "type": "integer",
+                                    "format": "int64"
+                                },
+                                "username": {
+                                    "type": "string"
+                                },
+                                "firstName": {
+                                    "type": "string"
+                                },
+                                "lastName": {
+                                    "type": "string"
+                                },
+                                "email": {
+                                    "type": "string"
+                                },
+                                "password": {
+                                    "type": "string"
+                                },
+                                "phone": {
+                                    "type": "string"
+                                },
+                                "userStatus": {
+                                    "type": "integer",
+                                    "format": "int32",
+                                    "description": "User Status"
+                                }
+                            },
+                            "xml": {
+                                "name": "User"
+                            }
+                        },
+                        "Tag": {
+                            "type": "object",
+                            "properties": {
+                                "id": {
+                                    "type": "integer",
+                                    "format": "int64"
+                                },
+                                "name": {
+                                    "type": "string"
+                                }
+                            },
+                            "xml": {
+                                "name": "Tag"
+                            }
+                        },
+                        "Pet": {
+                            "type": "object",
+                            "required": [
+                                "name",
+                                "photoUrls"
+                            ],
+                            "properties": {
+                                "id": {
+                                    "type": "integer",
+                                    "format": "int64"
+                                },
+                                "category": {
+                                    "$ref": "#/definitions/Category"
+                                },
+                                "name": {
+                                    "type": "string",
+                                    "example": "doggie"
+                                },
+                                "photoUrls": {
+                                    "type": "array",
+                                    "xml": {
+                                        "name": "photoUrl",
+                                        "wrapped": true
+                                    },
+                                    "items": {
+                                        "type": "string"
+                                    }
+                                },
+                                "tags": {
+                                    "type": "array",
+                                    "xml": {
+                                        "name": "tag",
+                                        "wrapped": true
+                                    },
+                                    "items": {
+                                        "$ref": "#/definitions/Tag"
+                                    }
+                                },
+                                "status": {
+                                    "type": "string",
+                                    "description": "pet status in the store",
+                                    "enum": [
+                                        "available",
+                                        "pending",
+                                        "sold"
+                                    ]
+                                }
+                            },
+                            "xml": {
+                                "name": "Pet"
+                            }
+                        },
+                        "ApiResponse": {
+                            "type": "object",
+                            "properties": {
+                                "code": {
+                                    "type": "integer",
+                                    "format": "int32"
+                                },
+                                "type": {
+                                    "type": "string"
+                                },
+                                "message": {
+                                    "type": "string"
+                                }
+                            }
+                        }
+                    },
+                    "externalDocs": {
+                        "description": "Find out more about Swagger",
+                        "url": "http://swagger.io"
+                    }
+                },
+                "valid": true
+            }
+        ]
+    }
+]
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/json_schema_test_suite.py b/llm/Lib/site-packages/jsonschema/benchmarks/json_schema_test_suite.py
new file mode 100644
index 0000000000000000000000000000000000000000..905fb6a3b88faf56e3288f7eb5053172f97abe8b
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/benchmarks/json_schema_test_suite.py
@@ -0,0 +1,12 @@
+"""
+A performance benchmark using the official test suite.
+
+This benchmarks jsonschema using every valid example in the
+JSON-Schema-Test-Suite. It will take some time to complete.
+"""
+from pyperf import Runner
+
+from jsonschema.tests._suite import Suite
+
+if __name__ == "__main__":
+    Suite().benchmark(runner=Runner())
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/nested_schemas.py b/llm/Lib/site-packages/jsonschema/benchmarks/nested_schemas.py
new file mode 100644
index 0000000000000000000000000000000000000000..b025c47cfd6736b0ea3d36856c1e2c8de35dde79
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/benchmarks/nested_schemas.py
@@ -0,0 +1,56 @@
+"""
+Validating highly nested schemas shouldn't cause exponential time blowups.
+
+See https://github.com/python-jsonschema/jsonschema/issues/1097.
+"""
+from itertools import cycle
+
+from jsonschema.validators import validator_for
+
+metaschemaish = {
+    "$id": "https://example.com/draft/2020-12/schema/strict",
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+
+    "$vocabulary": {
+        "https://json-schema.org/draft/2020-12/vocab/core": True,
+        "https://json-schema.org/draft/2020-12/vocab/applicator": True,
+        "https://json-schema.org/draft/2020-12/vocab/unevaluated": True,
+        "https://json-schema.org/draft/2020-12/vocab/validation": True,
+        "https://json-schema.org/draft/2020-12/vocab/meta-data": True,
+        "https://json-schema.org/draft/2020-12/vocab/format-annotation": True,
+        "https://json-schema.org/draft/2020-12/vocab/content": True,
+    },
+    "$dynamicAnchor": "meta",
+
+    "$ref": "https://json-schema.org/draft/2020-12/schema",
+    "unevaluatedProperties": False,
+}
+
+
+def nested_schema(levels):
+    """
+    Produce a schema which validates deeply nested objects and arrays.
+    """
+
+    names = cycle(["foo", "bar", "baz", "quux", "spam", "eggs"])
+    schema = {"type": "object", "properties": {"ham": {"type": "string"}}}
+    for _, name in zip(range(levels - 1), names):
+        schema = {"type": "object", "properties": {name: schema}}
+    return schema
+
+
+validator = validator_for(metaschemaish)(metaschemaish)
+
+if __name__ == "__main__":
+    from pyperf import Runner
+    runner = Runner()
+
+    not_nested = nested_schema(levels=1)
+    runner.bench_func("not nested", lambda: validator.is_valid(not_nested))
+
+    for levels in range(1, 11, 3):
+        schema = nested_schema(levels=levels)
+        runner.bench_func(
+            f"nested * {levels}",
+            lambda schema=schema: validator.is_valid(schema),
+        )
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/subcomponents.py b/llm/Lib/site-packages/jsonschema/benchmarks/subcomponents.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d78c7be6c88d177b89dfc80e52acae7820156a5
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/benchmarks/subcomponents.py
@@ -0,0 +1,42 @@
+"""
+A benchmark which tries to compare the possible slow subparts of validation.
+"""
+from referencing import Registry
+from referencing.jsonschema import DRAFT202012
+from rpds import HashTrieMap, HashTrieSet
+
+from jsonschema import Draft202012Validator
+
+schema = {
+    "type": "array",
+    "minLength": 1,
+    "maxLength": 1,
+    "items": {"type": "integer"},
+}
+
+hmap = HashTrieMap()
+hset = HashTrieSet()
+
+registry = Registry()
+
+v = Draft202012Validator(schema)
+
+
+def registry_data_structures():
+    return hmap.insert("foo", "bar"), hset.insert("foo")
+
+
+def registry_add():
+    resource = DRAFT202012.create_resource(schema)
+    return registry.with_resource(uri="urn:example", resource=resource)
+
+
+if __name__ == "__main__":
+    from pyperf import Runner
+    runner = Runner()
+
+    runner.bench_func("HashMap/HashSet insertion", registry_data_structures)
+    runner.bench_func("Registry insertion", registry_add)
+    runner.bench_func("Success", lambda: v.is_valid([1]))
+    runner.bench_func("Failure", lambda: v.is_valid(["foo"]))
+    runner.bench_func("Metaschema validation", lambda: v.check_schema(schema))
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/unused_registry.py b/llm/Lib/site-packages/jsonschema/benchmarks/unused_registry.py
new file mode 100644
index 0000000000000000000000000000000000000000..7b272c235625378b231d1c113bcb8ef45851cbc7
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/benchmarks/unused_registry.py
@@ -0,0 +1,35 @@
+"""
+An unused schema registry should not cause slower validation.
+
+"Unused" here means one where no reference resolution is occurring anyhow.
+
+See https://github.com/python-jsonschema/jsonschema/issues/1088.
+"""
+from pyperf import Runner
+from referencing import Registry
+from referencing.jsonschema import DRAFT201909
+
+from jsonschema import Draft201909Validator
+
+registry = Registry().with_resource(
+    "urn:example:foo",
+    DRAFT201909.create_resource({}),
+)
+
+schema = {"$ref": "https://json-schema.org/draft/2019-09/schema"}
+instance = {"maxLength": 4}
+
+no_registry = Draft201909Validator(schema)
+with_useless_registry = Draft201909Validator(schema, registry=registry)
+
+if __name__ == "__main__":
+    runner = Runner()
+
+    runner.bench_func(
+        "no registry",
+        lambda: no_registry.is_valid(instance),
+    )
+    runner.bench_func(
+        "useless registry",
+        lambda: with_useless_registry.is_valid(instance),
+    )
diff --git a/llm/Lib/site-packages/jsonschema/benchmarks/validator_creation.py b/llm/Lib/site-packages/jsonschema/benchmarks/validator_creation.py
new file mode 100644
index 0000000000000000000000000000000000000000..4baeb3a31641a027496732a6f10e200346551209
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/benchmarks/validator_creation.py
@@ -0,0 +1,14 @@
+from pyperf import Runner
+
+from jsonschema import Draft202012Validator
+
+schema = {
+    "type": "array",
+    "minLength": 1,
+    "maxLength": 1,
+    "items": {"type": "integer"},
+}
+
+
+if __name__ == "__main__":
+    Runner().bench_func("validator creation", Draft202012Validator, schema)
diff --git a/llm/Lib/site-packages/jsonschema/cli.py b/llm/Lib/site-packages/jsonschema/cli.py
new file mode 100644
index 0000000000000000000000000000000000000000..cf6298eb0dbbe2015c0b7c7d04ec030962b2928a
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/cli.py
@@ -0,0 +1,296 @@
+"""
+The ``jsonschema`` command line.
+"""
+
+from importlib import metadata
+from json import JSONDecodeError
+from textwrap import dedent
+import argparse
+import json
+import sys
+import traceback
+import warnings
+
+try:
+    from pkgutil import resolve_name
+except ImportError:
+    from pkgutil_resolve_name import resolve_name  # type: ignore[no-redef]
+
+from attrs import define, field
+
+from jsonschema.exceptions import SchemaError
+from jsonschema.validators import _RefResolver, validator_for
+
+warnings.warn(
+    (
+        "The jsonschema CLI is deprecated and will be removed in a future "
+        "version. Please use check-jsonschema instead, which can be installed "
+        "from https://pypi.org/project/check-jsonschema/"
+    ),
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+
+class _CannotLoadFile(Exception):
+    pass
+
+
+@define
+class _Outputter:
+
+    _formatter = field()
+    _stdout = field()
+    _stderr = field()
+
+    @classmethod
+    def from_arguments(cls, arguments, stdout, stderr):
+        if arguments["output"] == "plain":
+            formatter = _PlainFormatter(arguments["error_format"])
+        elif arguments["output"] == "pretty":
+            formatter = _PrettyFormatter()
+        return cls(formatter=formatter, stdout=stdout, stderr=stderr)
+
+    def load(self, path):
+        try:
+            file = open(path)  # noqa: SIM115, PTH123
+        except FileNotFoundError as error:
+            self.filenotfound_error(path=path, exc_info=sys.exc_info())
+            raise _CannotLoadFile() from error
+
+        with file:
+            try:
+                return json.load(file)
+            except JSONDecodeError as error:
+                self.parsing_error(path=path, exc_info=sys.exc_info())
+                raise _CannotLoadFile() from error
+
+    def filenotfound_error(self, **kwargs):
+        self._stderr.write(self._formatter.filenotfound_error(**kwargs))
+
+    def parsing_error(self, **kwargs):
+        self._stderr.write(self._formatter.parsing_error(**kwargs))
+
+    def validation_error(self, **kwargs):
+        self._stderr.write(self._formatter.validation_error(**kwargs))
+
+    def validation_success(self, **kwargs):
+        self._stdout.write(self._formatter.validation_success(**kwargs))
+
+
+@define
+class _PrettyFormatter:
+
+    _ERROR_MSG = dedent(
+        """\
+        ===[{type}]===({path})===
+
+        {body}
+        -----------------------------
+        """,
+    )
+    _SUCCESS_MSG = "===[SUCCESS]===({path})===\n"
+
+    def filenotfound_error(self, path, exc_info):
+        return self._ERROR_MSG.format(
+            path=path,
+            type="FileNotFoundError",
+            body=f"{path!r} does not exist.",
+        )
+
+    def parsing_error(self, path, exc_info):
+        exc_type, exc_value, exc_traceback = exc_info
+        exc_lines = "".join(
+            traceback.format_exception(exc_type, exc_value, exc_traceback),
+        )
+        return self._ERROR_MSG.format(
+            path=path,
+            type=exc_type.__name__,
+            body=exc_lines,
+        )
+
+    def validation_error(self, instance_path, error):
+        return self._ERROR_MSG.format(
+            path=instance_path,
+            type=error.__class__.__name__,
+            body=error,
+        )
+
+    def validation_success(self, instance_path):
+        return self._SUCCESS_MSG.format(path=instance_path)
+
+
+@define
+class _PlainFormatter:
+
+    _error_format = field()
+
+    def filenotfound_error(self, path, exc_info):
+        return f"{path!r} does not exist.\n"
+
+    def parsing_error(self, path, exc_info):
+        return "Failed to parse {}: {}\n".format(
+            "<stdin>" if path == "<stdin>" else repr(path),
+            exc_info[1],
+        )
+
+    def validation_error(self, instance_path, error):
+        return self._error_format.format(file_name=instance_path, error=error)
+
+    def validation_success(self, instance_path):
+        return ""
+
+
+def _resolve_name_with_default(name):
+    if "." not in name:
+        name = "jsonschema." + name
+    return resolve_name(name)
+
+
+parser = argparse.ArgumentParser(
+    description="JSON Schema Validation CLI",
+)
+parser.add_argument(
+    "-i", "--instance",
+    action="append",
+    dest="instances",
+    help="""
+        a path to a JSON instance (i.e. filename.json) to validate (may
+        be specified multiple times). If no instances are provided via this
+        option, one will be expected on standard input.
+    """,
+)
+parser.add_argument(
+    "-F", "--error-format",
+    help="""
+        the format to use for each validation error message, specified
+        in a form suitable for str.format. This string will be passed
+        one formatted object named 'error' for each ValidationError.
+        Only provide this option when using --output=plain, which is the
+        default. If this argument is unprovided and --output=plain is
+        used, a simple default representation will be used.
+    """,
+)
+parser.add_argument(
+    "-o", "--output",
+    choices=["plain", "pretty"],
+    default="plain",
+    help="""
+        an output format to use. 'plain' (default) will produce minimal
+        text with one line for each error, while 'pretty' will produce
+        more detailed human-readable output on multiple lines.
+    """,
+)
+parser.add_argument(
+    "-V", "--validator",
+    type=_resolve_name_with_default,
+    help="""
+        the fully qualified object name of a validator to use, or, for
+        validators that are registered with jsonschema, simply the name
+        of the class.
+    """,
+)
+parser.add_argument(
+    "--base-uri",
+    help="""
+        a base URI to assign to the provided schema, even if it does not
+        declare one (via e.g. $id). This option can be used if you wish to
+        resolve relative references to a particular URI (or local path)
+    """,
+)
+parser.add_argument(
+    "--version",
+    action="version",
+    version=metadata.version("jsonschema"),
+)
+parser.add_argument(
+    "schema",
+    help="the path to a JSON Schema to validate with (i.e. schema.json)",
+)
+
+
+def parse_args(args):  # noqa: D103
+    arguments = vars(parser.parse_args(args=args or ["--help"]))
+    if arguments["output"] != "plain" and arguments["error_format"]:
+        raise parser.error(
+            "--error-format can only be used with --output plain",
+        )
+    if arguments["output"] == "plain" and arguments["error_format"] is None:
+        arguments["error_format"] = "{error.instance}: {error.message}\n"
+    return arguments
+
+
+def _validate_instance(instance_path, instance, validator, outputter):
+    invalid = False
+    for error in validator.iter_errors(instance):
+        invalid = True
+        outputter.validation_error(instance_path=instance_path, error=error)
+
+    if not invalid:
+        outputter.validation_success(instance_path=instance_path)
+    return invalid
+
+
+def main(args=sys.argv[1:]):  # noqa: D103
+    sys.exit(run(arguments=parse_args(args=args)))
+
+
+def run(arguments, stdout=sys.stdout, stderr=sys.stderr, stdin=sys.stdin):  # noqa: D103
+    outputter = _Outputter.from_arguments(
+        arguments=arguments,
+        stdout=stdout,
+        stderr=stderr,
+    )
+
+    try:
+        schema = outputter.load(arguments["schema"])
+    except _CannotLoadFile:
+        return 1
+
+    Validator = arguments["validator"]
+    if Validator is None:
+        Validator = validator_for(schema)
+
+    try:
+        Validator.check_schema(schema)
+    except SchemaError as error:
+        outputter.validation_error(
+            instance_path=arguments["schema"],
+            error=error,
+        )
+        return 1
+
+    if arguments["instances"]:
+        load, instances = outputter.load, arguments["instances"]
+    else:
+        def load(_):
+            try:
+                return json.load(stdin)
+            except JSONDecodeError as error:
+                outputter.parsing_error(
+                    path="<stdin>", exc_info=sys.exc_info(),
+                )
+                raise _CannotLoadFile() from error
+        instances = ["<stdin>"]
+
+    resolver = _RefResolver(
+        base_uri=arguments["base_uri"],
+        referrer=schema,
+    ) if arguments["base_uri"] is not None else None
+
+    validator = Validator(schema, resolver=resolver)
+    exit_code = 0
+    for each in instances:
+        try:
+            instance = load(each)
+        except _CannotLoadFile:
+            exit_code = 1
+        else:
+            exit_code |= _validate_instance(
+                instance_path=each,
+                instance=instance,
+                validator=validator,
+                outputter=outputter,
+            )
+
+    return exit_code
diff --git a/llm/Lib/site-packages/jsonschema/exceptions.py b/llm/Lib/site-packages/jsonschema/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..7caa432ef33c6044e068e0a18cc990dd0bf25667
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/exceptions.py
@@ -0,0 +1,470 @@
+"""
+Validation errors, and some surrounding helpers.
+"""
+from __future__ import annotations
+
+from collections import defaultdict, deque
+from pprint import pformat
+from textwrap import dedent, indent
+from typing import TYPE_CHECKING, ClassVar
+import heapq
+import itertools
+import warnings
+
+from attrs import define
+from referencing.exceptions import Unresolvable as _Unresolvable
+
+from jsonschema import _utils
+
+if TYPE_CHECKING:
+    from collections.abc import Iterable, Mapping, MutableMapping
+
+WEAK_MATCHES: frozenset[str] = frozenset(["anyOf", "oneOf"])
+STRONG_MATCHES: frozenset[str] = frozenset()
+
+_unset = _utils.Unset()
+
+
+def __getattr__(name):
+    if name == "RefResolutionError":
+        warnings.warn(
+            _RefResolutionError._DEPRECATION_MESSAGE,
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return _RefResolutionError
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+class _Error(Exception):
+
+    _word_for_schema_in_error_message: ClassVar[str]
+    _word_for_instance_in_error_message: ClassVar[str]
+
+    def __init__(
+        self,
+        message: str,
+        validator=_unset,
+        path=(),
+        cause=None,
+        context=(),
+        validator_value=_unset,
+        instance=_unset,
+        schema=_unset,
+        schema_path=(),
+        parent=None,
+        type_checker=_unset,
+    ):
+        super().__init__(
+            message,
+            validator,
+            path,
+            cause,
+            context,
+            validator_value,
+            instance,
+            schema,
+            schema_path,
+            parent,
+        )
+        self.message = message
+        self.path = self.relative_path = deque(path)
+        self.schema_path = self.relative_schema_path = deque(schema_path)
+        self.context = list(context)
+        self.cause = self.__cause__ = cause
+        self.validator = validator
+        self.validator_value = validator_value
+        self.instance = instance
+        self.schema = schema
+        self.parent = parent
+        self._type_checker = type_checker
+
+        for error in context:
+            error.parent = self
+
+    def __repr__(self):
+        return f"<{self.__class__.__name__}: {self.message!r}>"
+
+    def __str__(self):
+        essential_for_verbose = (
+            self.validator, self.validator_value, self.instance, self.schema,
+        )
+        if any(m is _unset for m in essential_for_verbose):
+            return self.message
+
+        schema_path = _utils.format_as_index(
+            container=self._word_for_schema_in_error_message,
+            indices=list(self.relative_schema_path)[:-1],
+        )
+        instance_path = _utils.format_as_index(
+            container=self._word_for_instance_in_error_message,
+            indices=self.relative_path,
+        )
+        prefix = 16 * " "
+
+        return dedent(
+            f"""\
+            {self.message}
+
+            Failed validating {self.validator!r} in {schema_path}:
+                {indent(pformat(self.schema, width=72), prefix).lstrip()}
+
+            On {instance_path}:
+                {indent(pformat(self.instance, width=72), prefix).lstrip()}
+            """.rstrip(),
+        )
+
+    @classmethod
+    def create_from(cls, other):
+        return cls(**other._contents())
+
+    @property
+    def absolute_path(self):
+        parent = self.parent
+        if parent is None:
+            return self.relative_path
+
+        path = deque(self.relative_path)
+        path.extendleft(reversed(parent.absolute_path))
+        return path
+
+    @property
+    def absolute_schema_path(self):
+        parent = self.parent
+        if parent is None:
+            return self.relative_schema_path
+
+        path = deque(self.relative_schema_path)
+        path.extendleft(reversed(parent.absolute_schema_path))
+        return path
+
+    @property
+    def json_path(self):
+        path = "$"
+        for elem in self.absolute_path:
+            if isinstance(elem, int):
+                path += "[" + str(elem) + "]"
+            else:
+                path += "." + elem
+        return path
+
+    def _set(self, type_checker=None, **kwargs):
+        if type_checker is not None and self._type_checker is _unset:
+            self._type_checker = type_checker
+
+        for k, v in kwargs.items():
+            if getattr(self, k) is _unset:
+                setattr(self, k, v)
+
+    def _contents(self):
+        attrs = (
+            "message", "cause", "context", "validator", "validator_value",
+            "path", "schema_path", "instance", "schema", "parent",
+        )
+        return {attr: getattr(self, attr) for attr in attrs}
+
+    def _matches_type(self):
+        try:
+            expected = self.schema["type"]
+        except (KeyError, TypeError):
+            return False
+
+        if isinstance(expected, str):
+            return self._type_checker.is_type(self.instance, expected)
+
+        return any(
+            self._type_checker.is_type(self.instance, expected_type)
+            for expected_type in expected
+        )
+
+
+class ValidationError(_Error):
+    """
+    An instance was invalid under a provided schema.
+    """
+
+    _word_for_schema_in_error_message = "schema"
+    _word_for_instance_in_error_message = "instance"
+
+
+class SchemaError(_Error):
+    """
+    A schema was invalid under its corresponding metaschema.
+    """
+
+    _word_for_schema_in_error_message = "metaschema"
+    _word_for_instance_in_error_message = "schema"
+
+
+@define(slots=False)
+class _RefResolutionError(Exception):
+    """
+    A ref could not be resolved.
+    """
+
+    _DEPRECATION_MESSAGE = (
+        "jsonschema.exceptions.RefResolutionError is deprecated as of version "
+        "4.18.0. If you wish to catch potential reference resolution errors, "
+        "directly catch referencing.exceptions.Unresolvable."
+    )
+
+    _cause: Exception
+
+    def __eq__(self, other):
+        if self.__class__ is not other.__class__:
+            return NotImplemented  # pragma: no cover -- uncovered but deprecated  # noqa: E501
+        return self._cause == other._cause
+
+    def __str__(self):
+        return str(self._cause)
+
+
+class _WrappedReferencingError(_RefResolutionError, _Unresolvable):  # pragma: no cover -- partially uncovered but to be removed  # noqa: E501
+    def __init__(self, cause: _Unresolvable):
+        object.__setattr__(self, "_wrapped", cause)
+
+    def __eq__(self, other):
+        if other.__class__ is self.__class__:
+            return self._wrapped == other._wrapped
+        elif other.__class__ is self._wrapped.__class__:
+            return self._wrapped == other
+        return NotImplemented
+
+    def __getattr__(self, attr):
+        return getattr(self._wrapped, attr)
+
+    def __hash__(self):
+        return hash(self._wrapped)
+
+    def __repr__(self):
+        return f"<WrappedReferencingError {self._wrapped!r}>"
+
+    def __str__(self):
+        return f"{self._wrapped.__class__.__name__}: {self._wrapped}"
+
+
+class UndefinedTypeCheck(Exception):
+    """
+    A type checker was asked to check a type it did not have registered.
+    """
+
+    def __init__(self, type):
+        self.type = type
+
+    def __str__(self):
+        return f"Type {self.type!r} is unknown to this type checker"
+
+
+class UnknownType(Exception):
+    """
+    A validator was asked to validate an instance against an unknown type.
+    """
+
+    def __init__(self, type, instance, schema):
+        self.type = type
+        self.instance = instance
+        self.schema = schema
+
+    def __str__(self):
+        prefix = 16 * " "
+
+        return dedent(
+            f"""\
+            Unknown type {self.type!r} for validator with schema:
+                {indent(pformat(self.schema, width=72), prefix).lstrip()}
+
+            While checking instance:
+                {indent(pformat(self.instance, width=72), prefix).lstrip()}
+            """.rstrip(),
+        )
+
+
+class FormatError(Exception):
+    """
+    Validating a format failed.
+    """
+
+    def __init__(self, message, cause=None):
+        super().__init__(message, cause)
+        self.message = message
+        self.cause = self.__cause__ = cause
+
+    def __str__(self):
+        return self.message
+
+
+class ErrorTree:
+    """
+    ErrorTrees make it easier to check which validations failed.
+    """
+
+    _instance = _unset
+
+    def __init__(self, errors: Iterable[ValidationError] = ()):
+        self.errors: MutableMapping[str, ValidationError] = {}
+        self._contents: Mapping[str, ErrorTree] = defaultdict(self.__class__)
+
+        for error in errors:
+            container = self
+            for element in error.path:
+                container = container[element]
+            container.errors[error.validator] = error
+
+            container._instance = error.instance
+
+    def __contains__(self, index: str | int):
+        """
+        Check whether ``instance[index]`` has any errors.
+        """
+        return index in self._contents
+
+    def __getitem__(self, index):
+        """
+        Retrieve the child tree one level down at the given ``index``.
+
+        If the index is not in the instance that this tree corresponds
+        to and is not known by this tree, whatever error would be raised
+        by ``instance.__getitem__`` will be propagated (usually this is
+        some subclass of `LookupError`.
+        """
+        if self._instance is not _unset and index not in self:
+            self._instance[index]
+        return self._contents[index]
+
+    def __setitem__(self, index: str | int, value: ErrorTree):
+        """
+        Add an error to the tree at the given ``index``.
+
+        .. deprecated:: v4.20.0
+
+            Setting items on an `ErrorTree` is deprecated without replacement.
+            To populate a tree, provide all of its sub-errors when you
+            construct the tree.
+        """
+        warnings.warn(
+            "ErrorTree.__setitem__ is deprecated without replacement.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        self._contents[index] = value  # type: ignore[index]
+
+    def __iter__(self):
+        """
+        Iterate (non-recursively) over the indices in the instance with errors.
+        """
+        return iter(self._contents)
+
+    def __len__(self):
+        """
+        Return the `total_errors`.
+        """
+        return self.total_errors
+
+    def __repr__(self):
+        total = len(self)
+        errors = "error" if total == 1 else "errors"
+        return f"<{self.__class__.__name__} ({total} total {errors})>"
+
+    @property
+    def total_errors(self):
+        """
+        The total number of errors in the entire tree, including children.
+        """
+        child_errors = sum(len(tree) for _, tree in self._contents.items())
+        return len(self.errors) + child_errors
+
+
+def by_relevance(weak=WEAK_MATCHES, strong=STRONG_MATCHES):
+    """
+    Create a key function that can be used to sort errors by relevance.
+
+    Arguments:
+        weak (set):
+            a collection of validation keywords to consider to be
+            "weak".  If there are two errors at the same level of the
+            instance and one is in the set of weak validation keywords,
+            the other error will take priority. By default, :kw:`anyOf`
+            and :kw:`oneOf` are considered weak keywords and will be
+            superseded by other same-level validation errors.
+
+        strong (set):
+            a collection of validation keywords to consider to be
+            "strong"
+    """
+
+    def relevance(error):
+        validator = error.validator
+        return (
+            -len(error.path),
+            validator not in weak,
+            validator in strong,
+            not error._matches_type(),
+        )
+
+    return relevance
+
+
+relevance = by_relevance()
+"""
+A key function (e.g. to use with `sorted`) which sorts errors by relevance.
+
+Example:
+
+.. code:: python
+
+    sorted(validator.iter_errors(12), key=jsonschema.exceptions.relevance)
+"""
+
+
+def best_match(errors, key=relevance):
+    """
+    Try to find an error that appears to be the best match among given errors.
+
+    In general, errors that are higher up in the instance (i.e. for which
+    `ValidationError.path` is shorter) are considered better matches,
+    since they indicate "more" is wrong with the instance.
+
+    If the resulting match is either :kw:`oneOf` or :kw:`anyOf`, the
+    *opposite* assumption is made -- i.e. the deepest error is picked,
+    since these keywords only need to match once, and any other errors
+    may not be relevant.
+
+    Arguments:
+        errors (collections.abc.Iterable):
+
+            the errors to select from. Do not provide a mixture of
+            errors from different validation attempts (i.e. from
+            different instances or schemas), since it won't produce
+            sensical output.
+
+        key (collections.abc.Callable):
+
+            the key to use when sorting errors. See `relevance` and
+            transitively `by_relevance` for more details (the default is
+            to sort with the defaults of that function). Changing the
+            default is only useful if you want to change the function
+            that rates errors but still want the error context descent
+            done by this function.
+
+    Returns:
+        the best matching error, or ``None`` if the iterable was empty
+
+    .. note::
+
+        This function is a heuristic. Its return value may change for a given
+        set of inputs from version to version if better heuristics are added.
+    """
+    errors = iter(errors)
+    best = next(errors, None)
+    if best is None:
+        return
+    best = max(itertools.chain([best], errors), key=key)
+
+    while best.context:
+        # Calculate the minimum via nsmallest, because we don't recurse if
+        # all nested errors have the same relevance (i.e. if min == max == all)
+        smallest = heapq.nsmallest(2, best.context, key=key)
+        if len(smallest) == 2 and key(smallest[0]) == key(smallest[1]):  # noqa: PLR2004
+            return best
+        best = smallest[0]
+    return best
diff --git a/llm/Lib/site-packages/jsonschema/protocols.py b/llm/Lib/site-packages/jsonschema/protocols.py
new file mode 100644
index 0000000000000000000000000000000000000000..43b64c6c922319fd2aeab57c02ae80c5f86b046f
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/protocols.py
@@ -0,0 +1,231 @@
+"""
+typing.Protocol classes for jsonschema interfaces.
+"""
+
+# for reference material on Protocols, see
+#   https://www.python.org/dev/peps/pep-0544/
+
+from __future__ import annotations
+
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    ClassVar,
+    Iterable,
+    Protocol,
+    runtime_checkable,
+)
+
+# in order for Sphinx to resolve references accurately from type annotations,
+# it needs to see names like `jsonschema.TypeChecker`
+# therefore, only import at type-checking time (to avoid circular references),
+# but use `jsonschema` for any types which will otherwise not be resolvable
+if TYPE_CHECKING:
+    from collections.abc import Mapping
+
+    import referencing.jsonschema
+
+    from jsonschema import _typing
+    from jsonschema.exceptions import ValidationError
+    import jsonschema
+    import jsonschema.validators
+
+# For code authors working on the validator protocol, these are the three
+# use-cases which should be kept in mind:
+#
+# 1. As a protocol class, it can be used in type annotations to describe the
+#    available methods and attributes of a validator
+# 2. It is the source of autodoc for the validator documentation
+# 3. It is runtime_checkable, meaning that it can be used in isinstance()
+#    checks.
+#
+# Since protocols are not base classes, isinstance() checking is limited in
+# its capabilities. See docs on runtime_checkable for detail
+
+
+@runtime_checkable
+class Validator(Protocol):
+    """
+    The protocol to which all validator classes adhere.
+
+    Arguments:
+
+        schema:
+
+            The schema that the validator object will validate with.
+            It is assumed to be valid, and providing
+            an invalid schema can lead to undefined behavior. See
+            `Validator.check_schema` to validate a schema first.
+
+        registry:
+
+            a schema registry that will be used for looking up JSON references
+
+        resolver:
+
+            a resolver that will be used to resolve :kw:`$ref`
+            properties (JSON references). If unprovided, one will be created.
+
+            .. deprecated:: v4.18.0
+
+                `RefResolver <_RefResolver>` has been deprecated in favor of
+                `referencing`, and with it, this argument.
+
+        format_checker:
+
+            if provided, a checker which will be used to assert about
+            :kw:`format` properties present in the schema. If unprovided,
+            *no* format validation is done, and the presence of format
+            within schemas is strictly informational. Certain formats
+            require additional packages to be installed in order to assert
+            against instances. Ensure you've installed `jsonschema` with
+            its `extra (optional) dependencies <index:extras>` when
+            invoking ``pip``.
+
+    .. deprecated:: v4.12.0
+
+        Subclassing validator classes now explicitly warns this is not part of
+        their public API.
+    """
+
+    #: An object representing the validator's meta schema (the schema that
+    #: describes valid schemas in the given version).
+    META_SCHEMA: ClassVar[Mapping]
+
+    #: A mapping of validation keywords (`str`\s) to functions that
+    #: validate the keyword with that name. For more information see
+    #: `creating-validators`.
+    VALIDATORS: ClassVar[Mapping]
+
+    #: A `jsonschema.TypeChecker` that will be used when validating
+    #: :kw:`type` keywords in JSON schemas.
+    TYPE_CHECKER: ClassVar[jsonschema.TypeChecker]
+
+    #: A `jsonschema.FormatChecker` that will be used when validating
+    #: :kw:`format` keywords in JSON schemas.
+    FORMAT_CHECKER: ClassVar[jsonschema.FormatChecker]
+
+    #: A function which given a schema returns its ID.
+    ID_OF: _typing.id_of
+
+    #: The schema that will be used to validate instances
+    schema: Mapping | bool
+
+    def __init__(
+        self,
+        schema: Mapping | bool,
+        registry: referencing.jsonschema.SchemaRegistry,
+        format_checker: jsonschema.FormatChecker | None = None,
+    ) -> None:
+        ...
+
+    @classmethod
+    def check_schema(cls, schema: Mapping | bool) -> None:
+        """
+        Validate the given schema against the validator's `META_SCHEMA`.
+
+        Raises:
+
+            `jsonschema.exceptions.SchemaError`:
+
+                if the schema is invalid
+        """
+
+    def is_type(self, instance: Any, type: str) -> bool:
+        """
+        Check if the instance is of the given (JSON Schema) type.
+
+        Arguments:
+
+            instance:
+
+                the value to check
+
+            type:
+
+                the name of a known (JSON Schema) type
+
+        Returns:
+
+            whether the instance is of the given type
+
+        Raises:
+
+            `jsonschema.exceptions.UnknownType`:
+
+                if ``type`` is not a known type
+        """
+
+    def is_valid(self, instance: Any) -> bool:
+        """
+        Check if the instance is valid under the current `schema`.
+
+        Returns:
+
+            whether the instance is valid or not
+
+        >>> schema = {"maxItems" : 2}
+        >>> Draft202012Validator(schema).is_valid([2, 3, 4])
+        False
+        """
+
+    def iter_errors(self, instance: Any) -> Iterable[ValidationError]:
+        r"""
+        Lazily yield each of the validation errors in the given instance.
+
+        >>> schema = {
+        ...     "type" : "array",
+        ...     "items" : {"enum" : [1, 2, 3]},
+        ...     "maxItems" : 2,
+        ... }
+        >>> v = Draft202012Validator(schema)
+        >>> for error in sorted(v.iter_errors([2, 3, 4]), key=str):
+        ...     print(error.message)
+        4 is not one of [1, 2, 3]
+        [2, 3, 4] is too long
+
+        .. deprecated:: v4.0.0
+
+            Calling this function with a second schema argument is deprecated.
+            Use `Validator.evolve` instead.
+        """
+
+    def validate(self, instance: Any) -> None:
+        """
+        Check if the instance is valid under the current `schema`.
+
+        Raises:
+
+            `jsonschema.exceptions.ValidationError`:
+
+                if the instance is invalid
+
+        >>> schema = {"maxItems" : 2}
+        >>> Draft202012Validator(schema).validate([2, 3, 4])
+        Traceback (most recent call last):
+            ...
+        ValidationError: [2, 3, 4] is too long
+        """
+
+    def evolve(self, **kwargs) -> Validator:
+        """
+        Create a new validator like this one, but with given changes.
+
+        Preserves all other attributes, so can be used to e.g. create a
+        validator with a different schema but with the same :kw:`$ref`
+        resolution behavior.
+
+        >>> validator = Draft202012Validator({})
+        >>> validator.evolve(schema={"type": "number"})
+        Draft202012Validator(schema={'type': 'number'}, format_checker=None)
+
+        The returned object satisfies the validator protocol, but may not
+        be of the same concrete class! In particular this occurs
+        when a :kw:`$ref` occurs to a schema with a different
+        :kw:`$schema` than this one (i.e. for a different draft).
+
+        >>> validator.evolve(
+        ...     schema={"$schema": Draft7Validator.META_SCHEMA["$id"]}
+        ... )
+        Draft7Validator(schema=..., format_checker=None)
+        """
diff --git a/llm/Lib/site-packages/jsonschema/tests/__init__.py b/llm/Lib/site-packages/jsonschema/tests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/jsonschema/tests/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/tests/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..32716dd3eb7d27bd81074bc3f1a4d65450ba6f1f
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/tests/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/tests/__pycache__/_suite.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/tests/__pycache__/_suite.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0cea28eb5fc5cc0a1d83899f378cc09826342434
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/tests/__pycache__/_suite.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/tests/__pycache__/fuzz_validate.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/tests/__pycache__/fuzz_validate.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0904adb18d86393257f16ec838d8ea1f70130773
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/tests/__pycache__/fuzz_validate.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_cli.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_cli.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1ace345198b5efee389e262f451171911ce9363a
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_cli.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_deprecations.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_deprecations.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ce68fd8b60d0b47cb56fcd5ac7349cabf9f9c2b3
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_deprecations.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_exceptions.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1e60d42dc17f8e20ebdc79a872743e3012075265
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_format.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_format.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6d096cedacc7736b30702c59d0b8cbd2011a473f
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_format.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_jsonschema_test_suite.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_jsonschema_test_suite.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ab298422632ade33698fd8a12943b78bd0d5ace7
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_jsonschema_test_suite.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_types.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2230df35a741661fcd6534c0bd2597fa9d40dcea
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_utils.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c9f4a0c1ced1f3b58fba21c1a2d7136fc011b036
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_validators.cpython-311.pyc b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_validators.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aa3d5c174bb315a46c73f85d8fefc7704e8fd046
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema/tests/__pycache__/test_validators.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema/tests/_suite.py b/llm/Lib/site-packages/jsonschema/tests/_suite.py
new file mode 100644
index 0000000000000000000000000000000000000000..aeae411306410b938fd9f9d0051db417d459872f
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/tests/_suite.py
@@ -0,0 +1,275 @@
+"""
+Python representations of the JSON Schema Test Suite tests.
+"""
+from __future__ import annotations
+
+from contextlib import suppress
+from functools import partial
+from pathlib import Path
+from typing import TYPE_CHECKING, Any
+import json
+import os
+import re
+import subprocess
+import sys
+import unittest
+
+from attrs import field, frozen
+from referencing import Registry
+import referencing.jsonschema
+
+if TYPE_CHECKING:
+    from collections.abc import Iterable, Mapping
+
+    import pyperf
+
+from jsonschema.validators import _VALIDATORS
+import jsonschema
+
+_DELIMITERS = re.compile(r"[\W\- ]+")
+
+
+def _find_suite():
+    root = os.environ.get("JSON_SCHEMA_TEST_SUITE")
+    if root is not None:
+        return Path(root)
+
+    root = Path(jsonschema.__file__).parent.parent / "json"
+    if not root.is_dir():  # pragma: no cover
+        raise ValueError(
+            (
+                "Can't find the JSON-Schema-Test-Suite directory. "
+                "Set the 'JSON_SCHEMA_TEST_SUITE' environment "
+                "variable or run the tests from alongside a checkout "
+                "of the suite."
+            ),
+        )
+    return root
+
+
+@frozen
+class Suite:
+
+    _root: Path = field(factory=_find_suite)
+    _remotes: referencing.jsonschema.SchemaRegistry = field(init=False)
+
+    def __attrs_post_init__(self):
+        jsonschema_suite = self._root.joinpath("bin", "jsonschema_suite")
+        argv = [sys.executable, str(jsonschema_suite), "remotes"]
+        remotes = subprocess.check_output(argv).decode("utf-8")
+
+        resources = json.loads(remotes)
+
+        li = "http://localhost:1234/locationIndependentIdentifierPre2019.json"
+        li4 = "http://localhost:1234/locationIndependentIdentifierDraft4.json"
+
+        registry = Registry().with_resources(
+            [
+                (
+                    li,
+                    referencing.jsonschema.DRAFT7.create_resource(
+                        contents=resources.pop(li),
+                    ),
+                ),
+                (
+                    li4,
+                    referencing.jsonschema.DRAFT4.create_resource(
+                        contents=resources.pop(li4),
+                    ),
+                ),
+            ],
+        ).with_contents(
+            resources.items(),
+            default_specification=referencing.jsonschema.DRAFT202012,
+        )
+        object.__setattr__(self, "_remotes", registry)
+
+    def benchmark(self, runner: pyperf.Runner):  # pragma: no cover
+        for name, Validator in _VALIDATORS.items():
+            self.version(name=name).benchmark(
+                runner=runner,
+                Validator=Validator,
+            )
+
+    def version(self, name) -> Version:
+        return Version(
+            name=name,
+            path=self._root / "tests" / name,
+            remotes=self._remotes,
+        )
+
+
+@frozen
+class Version:
+
+    _path: Path
+    _remotes: referencing.jsonschema.SchemaRegistry
+
+    name: str
+
+    def benchmark(self, **kwargs):  # pragma: no cover
+        for case in self.cases():
+            case.benchmark(**kwargs)
+
+    def cases(self) -> Iterable[_Case]:
+        return self._cases_in(paths=self._path.glob("*.json"))
+
+    def format_cases(self) -> Iterable[_Case]:
+        return self._cases_in(paths=self._path.glob("optional/format/*.json"))
+
+    def optional_cases_of(self, name: str) -> Iterable[_Case]:
+        return self._cases_in(paths=[self._path / "optional" / f"{name}.json"])
+
+    def to_unittest_testcase(self, *groups, **kwargs):
+        name = kwargs.pop("name", "Test" + self.name.title().replace("-", ""))
+        methods = {
+            method.__name__: method
+            for method in (
+                test.to_unittest_method(**kwargs)
+                for group in groups
+                for case in group
+                for test in case.tests
+            )
+        }
+        cls = type(name, (unittest.TestCase,), methods)
+
+        # We're doing crazy things, so if they go wrong, like a function
+        # behaving differently on some other interpreter, just make them
+        # not happen.
+        with suppress(Exception):
+            cls.__module__ = _someone_save_us_the_module_of_the_caller()
+
+        return cls
+
+    def _cases_in(self, paths: Iterable[Path]) -> Iterable[_Case]:
+        for path in paths:
+            for case in json.loads(path.read_text(encoding="utf-8")):
+                yield _Case.from_dict(
+                    case,
+                    version=self,
+                    subject=path.stem,
+                    remotes=self._remotes,
+                )
+
+
+@frozen
+class _Case:
+
+    version: Version
+
+    subject: str
+    description: str
+    schema: Mapping[str, Any] | bool
+    tests: list[_Test]
+    comment: str | None = None
+
+    @classmethod
+    def from_dict(cls, data, remotes, **kwargs):
+        data.update(kwargs)
+        tests = [
+            _Test(
+                version=data["version"],
+                subject=data["subject"],
+                case_description=data["description"],
+                schema=data["schema"],
+                remotes=remotes,
+                **test,
+            ) for test in data.pop("tests")
+        ]
+        return cls(tests=tests, **data)
+
+    def benchmark(self, runner: pyperf.Runner, **kwargs):  # pragma: no cover
+        for test in self.tests:
+            runner.bench_func(
+                test.fully_qualified_name,
+                partial(test.validate_ignoring_errors, **kwargs),
+            )
+
+
+@frozen(repr=False)
+class _Test:
+
+    version: Version
+
+    subject: str
+    case_description: str
+    description: str
+
+    data: Any
+    schema: Mapping[str, Any] | bool
+
+    valid: bool
+
+    _remotes: referencing.jsonschema.SchemaRegistry
+
+    comment: str | None = None
+
+    def __repr__(self):  # pragma: no cover
+        return f"<Test {self.fully_qualified_name}>"
+
+    @property
+    def fully_qualified_name(self):  # pragma: no cover
+        return " > ".join(  # noqa: FLY002
+            [
+                self.version.name,
+                self.subject,
+                self.case_description,
+                self.description,
+            ],
+        )
+
+    def to_unittest_method(self, skip=lambda test: None, **kwargs):
+        if self.valid:
+            def fn(this):
+                self.validate(**kwargs)
+        else:
+            def fn(this):
+                with this.assertRaises(jsonschema.ValidationError):
+                    self.validate(**kwargs)
+
+        fn.__name__ = "_".join(
+            [
+                "test",
+                _DELIMITERS.sub("_", self.subject),
+                _DELIMITERS.sub("_", self.case_description),
+                _DELIMITERS.sub("_", self.description),
+            ],
+        )
+        reason = skip(self)
+        if reason is None or os.environ.get("JSON_SCHEMA_DEBUG", "0") != "0":
+            return fn
+        elif os.environ.get("JSON_SCHEMA_EXPECTED_FAILURES", "0") != "0":  # pragma: no cover  # noqa: E501
+            return unittest.expectedFailure(fn)
+        else:
+            return unittest.skip(reason)(fn)
+
+    def validate(self, Validator, **kwargs):
+        Validator.check_schema(self.schema)
+        validator = Validator(
+            schema=self.schema,
+            registry=self._remotes,
+            **kwargs,
+        )
+        if os.environ.get("JSON_SCHEMA_DEBUG", "0") != "0":  # pragma: no cover
+            breakpoint()  # noqa: T100
+        validator.validate(instance=self.data)
+
+    def validate_ignoring_errors(self, Validator):  # pragma: no cover
+        with suppress(jsonschema.ValidationError):
+            self.validate(Validator=Validator)
+
+
+def _someone_save_us_the_module_of_the_caller():
+    """
+    The FQON of the module 2nd stack frames up from here.
+
+    This is intended to allow us to dynamically return test case classes that
+    are indistinguishable from being defined in the module that wants them.
+
+    Otherwise, trial will mis-print the FQON, and copy pasting it won't re-run
+    the class that really is running.
+
+    Save us all, this is all so so so so so terrible.
+    """
+
+    return sys._getframe(2).f_globals["__name__"]
diff --git a/llm/Lib/site-packages/jsonschema/tests/fuzz_validate.py b/llm/Lib/site-packages/jsonschema/tests/fuzz_validate.py
new file mode 100644
index 0000000000000000000000000000000000000000..c12e88bcfe9bfdc0e0ffaab502789a6b585d4be2
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/tests/fuzz_validate.py
@@ -0,0 +1,50 @@
+"""
+Fuzzing setup for OSS-Fuzz.
+
+See https://github.com/google/oss-fuzz/tree/master/projects/jsonschema for the
+other half of the setup here.
+"""
+import sys
+
+from hypothesis import given, strategies
+
+import jsonschema
+
+PRIM = strategies.one_of(
+    strategies.booleans(),
+    strategies.integers(),
+    strategies.floats(allow_nan=False, allow_infinity=False),
+    strategies.text(),
+)
+DICT = strategies.recursive(
+    base=strategies.one_of(
+        strategies.booleans(),
+        strategies.dictionaries(strategies.text(), PRIM),
+    ),
+    extend=lambda inner: strategies.dictionaries(strategies.text(), inner),
+)
+
+
+@given(obj1=DICT, obj2=DICT)
+def test_schemas(obj1, obj2):
+    try:
+        jsonschema.validate(instance=obj1, schema=obj2)
+    except jsonschema.exceptions.ValidationError:
+        pass
+    except jsonschema.exceptions.SchemaError:
+        pass
+
+
+def main():
+    atheris.instrument_all()
+    atheris.Setup(
+        sys.argv,
+        test_schemas.hypothesis.fuzz_one_input,
+        enable_python_coverage=True,
+    )
+    atheris.Fuzz()
+
+
+if __name__ == "__main__":
+    import atheris
+    main()
diff --git a/llm/Lib/site-packages/jsonschema/tests/test_cli.py b/llm/Lib/site-packages/jsonschema/tests/test_cli.py
new file mode 100644
index 0000000000000000000000000000000000000000..79d2a1584b85a2020034963c93a3c430baab9542
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/tests/test_cli.py
@@ -0,0 +1,907 @@
+from contextlib import redirect_stderr, redirect_stdout
+from importlib import metadata
+from io import StringIO
+from json import JSONDecodeError
+from pathlib import Path
+from textwrap import dedent
+from unittest import TestCase
+import json
+import os
+import subprocess
+import sys
+import tempfile
+import warnings
+
+from jsonschema import Draft4Validator, Draft202012Validator
+from jsonschema.exceptions import (
+    SchemaError,
+    ValidationError,
+    _RefResolutionError,
+)
+from jsonschema.validators import _LATEST_VERSION, validate
+
+with warnings.catch_warnings():
+    warnings.simplefilter("ignore")
+    from jsonschema import cli
+
+
+def fake_validator(*errors):
+    errors = list(reversed(errors))
+
+    class FakeValidator:
+        def __init__(self, *args, **kwargs):
+            pass
+
+        def iter_errors(self, instance):
+            if errors:
+                return errors.pop()
+            return []  # pragma: no cover
+
+        @classmethod
+        def check_schema(self, schema):
+            pass
+
+    return FakeValidator
+
+
+def fake_open(all_contents):
+    def open(path):
+        contents = all_contents.get(path)
+        if contents is None:
+            raise FileNotFoundError(path)
+        return StringIO(contents)
+    return open
+
+
+def _message_for(non_json):
+    try:
+        json.loads(non_json)
+    except JSONDecodeError as error:
+        return str(error)
+    else:  # pragma: no cover
+        raise RuntimeError("Tried and failed to capture a JSON dump error.")
+
+
+class TestCLI(TestCase):
+    def run_cli(
+        self, argv, files=None, stdin=StringIO(), exit_code=0, **override,
+    ):
+        arguments = cli.parse_args(argv)
+        arguments.update(override)
+
+        self.assertFalse(hasattr(cli, "open"))
+        cli.open = fake_open(files or {})
+        try:
+            stdout, stderr = StringIO(), StringIO()
+            actual_exit_code = cli.run(
+                arguments,
+                stdin=stdin,
+                stdout=stdout,
+                stderr=stderr,
+            )
+        finally:
+            del cli.open
+
+        self.assertEqual(
+            actual_exit_code, exit_code, msg=dedent(
+                f"""
+                    Expected an exit code of {exit_code} != {actual_exit_code}.
+
+                    stdout: {stdout.getvalue()}
+
+                    stderr: {stderr.getvalue()}
+                """,
+            ),
+        )
+        return stdout.getvalue(), stderr.getvalue()
+
+    def assertOutputs(self, stdout="", stderr="", **kwargs):
+        self.assertEqual(
+            self.run_cli(**kwargs),
+            (dedent(stdout), dedent(stderr)),
+        )
+
+    def test_invalid_instance(self):
+        error = ValidationError("I am an error!", instance=12)
+        self.assertOutputs(
+            files=dict(
+                some_schema='{"does not": "matter since it is stubbed"}',
+                some_instance=json.dumps(error.instance),
+            ),
+            validator=fake_validator([error]),
+
+            argv=["-i", "some_instance", "some_schema"],
+
+            exit_code=1,
+            stderr="12: I am an error!\n",
+        )
+
+    def test_invalid_instance_pretty_output(self):
+        error = ValidationError("I am an error!", instance=12)
+        self.assertOutputs(
+            files=dict(
+                some_schema='{"does not": "matter since it is stubbed"}',
+                some_instance=json.dumps(error.instance),
+            ),
+            validator=fake_validator([error]),
+
+            argv=["-i", "some_instance", "--output", "pretty", "some_schema"],
+
+            exit_code=1,
+            stderr="""\
+                ===[ValidationError]===(some_instance)===
+
+                I am an error!
+                -----------------------------
+            """,
+        )
+
+    def test_invalid_instance_explicit_plain_output(self):
+        error = ValidationError("I am an error!", instance=12)
+        self.assertOutputs(
+            files=dict(
+                some_schema='{"does not": "matter since it is stubbed"}',
+                some_instance=json.dumps(error.instance),
+            ),
+            validator=fake_validator([error]),
+
+            argv=["--output", "plain", "-i", "some_instance", "some_schema"],
+
+            exit_code=1,
+            stderr="12: I am an error!\n",
+        )
+
+    def test_invalid_instance_multiple_errors(self):
+        instance = 12
+        first = ValidationError("First error", instance=instance)
+        second = ValidationError("Second error", instance=instance)
+
+        self.assertOutputs(
+            files=dict(
+                some_schema='{"does not": "matter since it is stubbed"}',
+                some_instance=json.dumps(instance),
+            ),
+            validator=fake_validator([first, second]),
+
+            argv=["-i", "some_instance", "some_schema"],
+
+            exit_code=1,
+            stderr="""\
+                12: First error
+                12: Second error
+            """,
+        )
+
+    def test_invalid_instance_multiple_errors_pretty_output(self):
+        instance = 12
+        first = ValidationError("First error", instance=instance)
+        second = ValidationError("Second error", instance=instance)
+
+        self.assertOutputs(
+            files=dict(
+                some_schema='{"does not": "matter since it is stubbed"}',
+                some_instance=json.dumps(instance),
+            ),
+            validator=fake_validator([first, second]),
+
+            argv=["-i", "some_instance", "--output", "pretty", "some_schema"],
+
+            exit_code=1,
+            stderr="""\
+                ===[ValidationError]===(some_instance)===
+
+                First error
+                -----------------------------
+                ===[ValidationError]===(some_instance)===
+
+                Second error
+                -----------------------------
+            """,
+        )
+
+    def test_multiple_invalid_instances(self):
+        first_instance = 12
+        first_errors = [
+            ValidationError("An error", instance=first_instance),
+            ValidationError("Another error", instance=first_instance),
+        ]
+        second_instance = "foo"
+        second_errors = [ValidationError("BOOM", instance=second_instance)]
+
+        self.assertOutputs(
+            files=dict(
+                some_schema='{"does not": "matter since it is stubbed"}',
+                some_first_instance=json.dumps(first_instance),
+                some_second_instance=json.dumps(second_instance),
+            ),
+            validator=fake_validator(first_errors, second_errors),
+
+            argv=[
+                "-i", "some_first_instance",
+                "-i", "some_second_instance",
+                "some_schema",
+            ],
+
+            exit_code=1,
+            stderr="""\
+                12: An error
+                12: Another error
+                foo: BOOM
+            """,
+        )
+
+    def test_multiple_invalid_instances_pretty_output(self):
+        first_instance = 12
+        first_errors = [
+            ValidationError("An error", instance=first_instance),
+            ValidationError("Another error", instance=first_instance),
+        ]
+        second_instance = "foo"
+        second_errors = [ValidationError("BOOM", instance=second_instance)]
+
+        self.assertOutputs(
+            files=dict(
+                some_schema='{"does not": "matter since it is stubbed"}',
+                some_first_instance=json.dumps(first_instance),
+                some_second_instance=json.dumps(second_instance),
+            ),
+            validator=fake_validator(first_errors, second_errors),
+
+            argv=[
+                "--output", "pretty",
+                "-i", "some_first_instance",
+                "-i", "some_second_instance",
+                "some_schema",
+            ],
+
+            exit_code=1,
+            stderr="""\
+                ===[ValidationError]===(some_first_instance)===
+
+                An error
+                -----------------------------
+                ===[ValidationError]===(some_first_instance)===
+
+                Another error
+                -----------------------------
+                ===[ValidationError]===(some_second_instance)===
+
+                BOOM
+                -----------------------------
+            """,
+        )
+
+    def test_custom_error_format(self):
+        first_instance = 12
+        first_errors = [
+            ValidationError("An error", instance=first_instance),
+            ValidationError("Another error", instance=first_instance),
+        ]
+        second_instance = "foo"
+        second_errors = [ValidationError("BOOM", instance=second_instance)]
+
+        self.assertOutputs(
+            files=dict(
+                some_schema='{"does not": "matter since it is stubbed"}',
+                some_first_instance=json.dumps(first_instance),
+                some_second_instance=json.dumps(second_instance),
+            ),
+            validator=fake_validator(first_errors, second_errors),
+
+            argv=[
+                "--error-format", ":{error.message}._-_.{error.instance}:",
+                "-i", "some_first_instance",
+                "-i", "some_second_instance",
+                "some_schema",
+            ],
+
+            exit_code=1,
+            stderr=":An error._-_.12::Another error._-_.12::BOOM._-_.foo:",
+        )
+
+    def test_invalid_schema(self):
+        self.assertOutputs(
+            files=dict(some_schema='{"type": 12}'),
+            argv=["some_schema"],
+
+            exit_code=1,
+            stderr="""\
+                12: 12 is not valid under any of the given schemas
+            """,
+        )
+
+    def test_invalid_schema_pretty_output(self):
+        schema = {"type": 12}
+
+        with self.assertRaises(SchemaError) as e:
+            validate(schema=schema, instance="")
+        error = str(e.exception)
+
+        self.assertOutputs(
+            files=dict(some_schema=json.dumps(schema)),
+            argv=["--output", "pretty", "some_schema"],
+
+            exit_code=1,
+            stderr=(
+                "===[SchemaError]===(some_schema)===\n\n"
+                + str(error)
+                + "\n-----------------------------\n"
+            ),
+        )
+
+    def test_invalid_schema_multiple_errors(self):
+        self.assertOutputs(
+            files=dict(some_schema='{"type": 12, "items": 57}'),
+            argv=["some_schema"],
+
+            exit_code=1,
+            stderr="""\
+                57: 57 is not of type 'object', 'boolean'
+            """,
+        )
+
+    def test_invalid_schema_multiple_errors_pretty_output(self):
+        schema = {"type": 12, "items": 57}
+
+        with self.assertRaises(SchemaError) as e:
+            validate(schema=schema, instance="")
+        error = str(e.exception)
+
+        self.assertOutputs(
+            files=dict(some_schema=json.dumps(schema)),
+            argv=["--output", "pretty", "some_schema"],
+
+            exit_code=1,
+            stderr=(
+                "===[SchemaError]===(some_schema)===\n\n"
+                + str(error)
+                + "\n-----------------------------\n"
+            ),
+        )
+
+    def test_invalid_schema_with_invalid_instance(self):
+        """
+        "Validating" an instance that's invalid under an invalid schema
+        just shows the schema error.
+        """
+        self.assertOutputs(
+            files=dict(
+                some_schema='{"type": 12, "minimum": 30}',
+                some_instance="13",
+            ),
+            argv=["-i", "some_instance", "some_schema"],
+
+            exit_code=1,
+            stderr="""\
+                12: 12 is not valid under any of the given schemas
+            """,
+        )
+
+    def test_invalid_schema_with_invalid_instance_pretty_output(self):
+        instance, schema = 13, {"type": 12, "minimum": 30}
+
+        with self.assertRaises(SchemaError) as e:
+            validate(schema=schema, instance=instance)
+        error = str(e.exception)
+
+        self.assertOutputs(
+            files=dict(
+                some_schema=json.dumps(schema),
+                some_instance=json.dumps(instance),
+            ),
+            argv=["--output", "pretty", "-i", "some_instance", "some_schema"],
+
+            exit_code=1,
+            stderr=(
+                "===[SchemaError]===(some_schema)===\n\n"
+                + str(error)
+                + "\n-----------------------------\n"
+            ),
+        )
+
+    def test_invalid_instance_continues_with_the_rest(self):
+        self.assertOutputs(
+            files=dict(
+                some_schema='{"minimum": 30}',
+                first_instance="not valid JSON!",
+                second_instance="12",
+            ),
+            argv=[
+                "-i", "first_instance",
+                "-i", "second_instance",
+                "some_schema",
+            ],
+
+            exit_code=1,
+            stderr="""\
+                Failed to parse 'first_instance': {}
+                12: 12 is less than the minimum of 30
+            """.format(_message_for("not valid JSON!")),
+        )
+
+    def test_custom_error_format_applies_to_schema_errors(self):
+        instance, schema = 13, {"type": 12, "minimum": 30}
+
+        with self.assertRaises(SchemaError):
+            validate(schema=schema, instance=instance)
+
+        self.assertOutputs(
+            files=dict(some_schema=json.dumps(schema)),
+
+            argv=[
+                "--error-format", ":{error.message}._-_.{error.instance}:",
+                "some_schema",
+            ],
+
+            exit_code=1,
+            stderr=":12 is not valid under any of the given schemas._-_.12:",
+        )
+
+    def test_instance_is_invalid_JSON(self):
+        instance = "not valid JSON!"
+
+        self.assertOutputs(
+            files=dict(some_schema="{}", some_instance=instance),
+            argv=["-i", "some_instance", "some_schema"],
+
+            exit_code=1,
+            stderr=f"""\
+                Failed to parse 'some_instance': {_message_for(instance)}
+            """,
+        )
+
+    def test_instance_is_invalid_JSON_pretty_output(self):
+        stdout, stderr = self.run_cli(
+            files=dict(
+                some_schema="{}",
+                some_instance="not valid JSON!",
+            ),
+
+            argv=["--output", "pretty", "-i", "some_instance", "some_schema"],
+
+            exit_code=1,
+        )
+        self.assertFalse(stdout)
+        self.assertIn(
+            "(some_instance)===\n\nTraceback (most recent call last):\n",
+            stderr,
+        )
+        self.assertNotIn("some_schema", stderr)
+
+    def test_instance_is_invalid_JSON_on_stdin(self):
+        instance = "not valid JSON!"
+
+        self.assertOutputs(
+            files=dict(some_schema="{}"),
+            stdin=StringIO(instance),
+
+            argv=["some_schema"],
+
+            exit_code=1,
+            stderr=f"""\
+                Failed to parse <stdin>: {_message_for(instance)}
+            """,
+        )
+
+    def test_instance_is_invalid_JSON_on_stdin_pretty_output(self):
+        stdout, stderr = self.run_cli(
+            files=dict(some_schema="{}"),
+            stdin=StringIO("not valid JSON!"),
+
+            argv=["--output", "pretty", "some_schema"],
+
+            exit_code=1,
+        )
+        self.assertFalse(stdout)
+        self.assertIn(
+            "(<stdin>)===\n\nTraceback (most recent call last):\n",
+            stderr,
+        )
+        self.assertNotIn("some_schema", stderr)
+
+    def test_schema_is_invalid_JSON(self):
+        schema = "not valid JSON!"
+
+        self.assertOutputs(
+            files=dict(some_schema=schema),
+
+            argv=["some_schema"],
+
+            exit_code=1,
+            stderr=f"""\
+                Failed to parse 'some_schema': {_message_for(schema)}
+            """,
+        )
+
+    def test_schema_is_invalid_JSON_pretty_output(self):
+        stdout, stderr = self.run_cli(
+            files=dict(some_schema="not valid JSON!"),
+
+            argv=["--output", "pretty", "some_schema"],
+
+            exit_code=1,
+        )
+        self.assertFalse(stdout)
+        self.assertIn(
+            "(some_schema)===\n\nTraceback (most recent call last):\n",
+            stderr,
+        )
+
+    def test_schema_and_instance_are_both_invalid_JSON(self):
+        """
+        Only the schema error is reported, as we abort immediately.
+        """
+        schema, instance = "not valid JSON!", "also not valid JSON!"
+        self.assertOutputs(
+            files=dict(some_schema=schema, some_instance=instance),
+
+            argv=["some_schema"],
+
+            exit_code=1,
+            stderr=f"""\
+                Failed to parse 'some_schema': {_message_for(schema)}
+            """,
+        )
+
+    def test_schema_and_instance_are_both_invalid_JSON_pretty_output(self):
+        """
+        Only the schema error is reported, as we abort immediately.
+        """
+        stdout, stderr = self.run_cli(
+            files=dict(
+                some_schema="not valid JSON!",
+                some_instance="also not valid JSON!",
+            ),
+
+            argv=["--output", "pretty", "-i", "some_instance", "some_schema"],
+
+            exit_code=1,
+        )
+        self.assertFalse(stdout)
+        self.assertIn(
+            "(some_schema)===\n\nTraceback (most recent call last):\n",
+            stderr,
+        )
+        self.assertNotIn("some_instance", stderr)
+
+    def test_instance_does_not_exist(self):
+        self.assertOutputs(
+            files=dict(some_schema="{}"),
+            argv=["-i", "nonexisting_instance", "some_schema"],
+
+            exit_code=1,
+            stderr="""\
+                'nonexisting_instance' does not exist.
+            """,
+        )
+
+    def test_instance_does_not_exist_pretty_output(self):
+        self.assertOutputs(
+            files=dict(some_schema="{}"),
+            argv=[
+                "--output", "pretty",
+                "-i", "nonexisting_instance",
+                "some_schema",
+            ],
+
+            exit_code=1,
+            stderr="""\
+                ===[FileNotFoundError]===(nonexisting_instance)===
+
+                'nonexisting_instance' does not exist.
+                -----------------------------
+            """,
+        )
+
+    def test_schema_does_not_exist(self):
+        self.assertOutputs(
+            argv=["nonexisting_schema"],
+
+            exit_code=1,
+            stderr="'nonexisting_schema' does not exist.\n",
+        )
+
+    def test_schema_does_not_exist_pretty_output(self):
+        self.assertOutputs(
+            argv=["--output", "pretty", "nonexisting_schema"],
+
+            exit_code=1,
+            stderr="""\
+                ===[FileNotFoundError]===(nonexisting_schema)===
+
+                'nonexisting_schema' does not exist.
+                -----------------------------
+            """,
+        )
+
+    def test_neither_instance_nor_schema_exist(self):
+        self.assertOutputs(
+            argv=["-i", "nonexisting_instance", "nonexisting_schema"],
+
+            exit_code=1,
+            stderr="'nonexisting_schema' does not exist.\n",
+        )
+
+    def test_neither_instance_nor_schema_exist_pretty_output(self):
+        self.assertOutputs(
+            argv=[
+                "--output", "pretty",
+                "-i", "nonexisting_instance",
+                "nonexisting_schema",
+            ],
+
+            exit_code=1,
+            stderr="""\
+                ===[FileNotFoundError]===(nonexisting_schema)===
+
+                'nonexisting_schema' does not exist.
+                -----------------------------
+            """,
+        )
+
+    def test_successful_validation(self):
+        self.assertOutputs(
+            files=dict(some_schema="{}", some_instance="{}"),
+            argv=["-i", "some_instance", "some_schema"],
+            stdout="",
+            stderr="",
+        )
+
+    def test_successful_validation_pretty_output(self):
+        self.assertOutputs(
+            files=dict(some_schema="{}", some_instance="{}"),
+            argv=["--output", "pretty", "-i", "some_instance", "some_schema"],
+            stdout="===[SUCCESS]===(some_instance)===\n",
+            stderr="",
+        )
+
+    def test_successful_validation_of_stdin(self):
+        self.assertOutputs(
+            files=dict(some_schema="{}"),
+            stdin=StringIO("{}"),
+            argv=["some_schema"],
+            stdout="",
+            stderr="",
+        )
+
+    def test_successful_validation_of_stdin_pretty_output(self):
+        self.assertOutputs(
+            files=dict(some_schema="{}"),
+            stdin=StringIO("{}"),
+            argv=["--output", "pretty", "some_schema"],
+            stdout="===[SUCCESS]===(<stdin>)===\n",
+            stderr="",
+        )
+
+    def test_successful_validation_of_just_the_schema(self):
+        self.assertOutputs(
+            files=dict(some_schema="{}", some_instance="{}"),
+            argv=["-i", "some_instance", "some_schema"],
+            stdout="",
+            stderr="",
+        )
+
+    def test_successful_validation_of_just_the_schema_pretty_output(self):
+        self.assertOutputs(
+            files=dict(some_schema="{}", some_instance="{}"),
+            argv=["--output", "pretty", "-i", "some_instance", "some_schema"],
+            stdout="===[SUCCESS]===(some_instance)===\n",
+            stderr="",
+        )
+
+    def test_successful_validation_via_explicit_base_uri(self):
+        ref_schema_file = tempfile.NamedTemporaryFile(delete=False)
+        ref_schema_file.close()
+        self.addCleanup(os.remove, ref_schema_file.name)
+
+        ref_path = Path(ref_schema_file.name)
+        ref_path.write_text('{"definitions": {"num": {"type": "integer"}}}')
+
+        schema = f'{{"$ref": "{ref_path.name}#/definitions/num"}}'
+
+        self.assertOutputs(
+            files=dict(some_schema=schema, some_instance="1"),
+            argv=[
+                "-i", "some_instance",
+                "--base-uri", ref_path.parent.as_uri() + "/",
+                "some_schema",
+            ],
+            stdout="",
+            stderr="",
+        )
+
+    def test_unsuccessful_validation_via_explicit_base_uri(self):
+        ref_schema_file = tempfile.NamedTemporaryFile(delete=False)
+        ref_schema_file.close()
+        self.addCleanup(os.remove, ref_schema_file.name)
+
+        ref_path = Path(ref_schema_file.name)
+        ref_path.write_text('{"definitions": {"num": {"type": "integer"}}}')
+
+        schema = f'{{"$ref": "{ref_path.name}#/definitions/num"}}'
+
+        self.assertOutputs(
+            files=dict(some_schema=schema, some_instance='"1"'),
+            argv=[
+                "-i", "some_instance",
+                "--base-uri", ref_path.parent.as_uri() + "/",
+                "some_schema",
+            ],
+            exit_code=1,
+            stdout="",
+            stderr="1: '1' is not of type 'integer'\n",
+        )
+
+    def test_nonexistent_file_with_explicit_base_uri(self):
+        schema = '{"$ref": "someNonexistentFile.json#definitions/num"}'
+        instance = "1"
+
+        with self.assertRaises(_RefResolutionError) as e:
+            self.assertOutputs(
+                files=dict(
+                    some_schema=schema,
+                    some_instance=instance,
+                ),
+                argv=[
+                    "-i", "some_instance",
+                    "--base-uri", Path.cwd().as_uri(),
+                    "some_schema",
+                ],
+            )
+        error = str(e.exception)
+        self.assertIn(f"{os.sep}someNonexistentFile.json'", error)
+
+    def test_invalid_explicit_base_uri(self):
+        schema = '{"$ref": "foo.json#definitions/num"}'
+        instance = "1"
+
+        with self.assertRaises(_RefResolutionError) as e:
+            self.assertOutputs(
+                files=dict(
+                    some_schema=schema,
+                    some_instance=instance,
+                ),
+                argv=[
+                    "-i", "some_instance",
+                    "--base-uri", "not@UR1",
+                    "some_schema",
+                ],
+            )
+        error = str(e.exception)
+        self.assertEqual(
+            error, "unknown url type: 'foo.json'",
+        )
+
+    def test_it_validates_using_the_latest_validator_when_unspecified(self):
+        # There isn't a better way now I can think of to ensure that the
+        # latest version was used, given that the call to validator_for
+        # is hidden inside the CLI, so guard that that's the case, and
+        # this test will have to be updated when versions change until
+        # we can think of a better way to ensure this behavior.
+        self.assertIs(Draft202012Validator, _LATEST_VERSION)
+
+        self.assertOutputs(
+            files=dict(some_schema='{"const": "check"}', some_instance='"a"'),
+            argv=["-i", "some_instance", "some_schema"],
+            exit_code=1,
+            stdout="",
+            stderr="a: 'check' was expected\n",
+        )
+
+    def test_it_validates_using_draft7_when_specified(self):
+        """
+        Specifically, `const` validation applies for Draft 7.
+        """
+        schema = """
+            {
+                "$schema": "http://json-schema.org/draft-07/schema#",
+                "const": "check"
+            }
+        """
+        instance = '"foo"'
+        self.assertOutputs(
+            files=dict(some_schema=schema, some_instance=instance),
+            argv=["-i", "some_instance", "some_schema"],
+            exit_code=1,
+            stdout="",
+            stderr="foo: 'check' was expected\n",
+        )
+
+    def test_it_validates_using_draft4_when_specified(self):
+        """
+        Specifically, `const` validation *does not* apply for Draft 4.
+        """
+        schema = """
+            {
+                "$schema": "http://json-schema.org/draft-04/schema#",
+                "const": "check"
+            }
+            """
+        instance = '"foo"'
+        self.assertOutputs(
+            files=dict(some_schema=schema, some_instance=instance),
+            argv=["-i", "some_instance", "some_schema"],
+            stdout="",
+            stderr="",
+        )
+
+
+class TestParser(TestCase):
+
+    FakeValidator = fake_validator()
+
+    def test_find_validator_by_fully_qualified_object_name(self):
+        arguments = cli.parse_args(
+            [
+                "--validator",
+                "jsonschema.tests.test_cli.TestParser.FakeValidator",
+                "--instance", "mem://some/instance",
+                "mem://some/schema",
+            ],
+        )
+        self.assertIs(arguments["validator"], self.FakeValidator)
+
+    def test_find_validator_in_jsonschema(self):
+        arguments = cli.parse_args(
+            [
+                "--validator", "Draft4Validator",
+                "--instance", "mem://some/instance",
+                "mem://some/schema",
+            ],
+        )
+        self.assertIs(arguments["validator"], Draft4Validator)
+
+    def cli_output_for(self, *argv):
+        stdout, stderr = StringIO(), StringIO()
+        with redirect_stdout(stdout), redirect_stderr(stderr):  # noqa: SIM117
+            with self.assertRaises(SystemExit):
+                cli.parse_args(argv)
+        return stdout.getvalue(), stderr.getvalue()
+
+    def test_unknown_output(self):
+        stdout, stderr = self.cli_output_for(
+            "--output", "foo",
+            "mem://some/schema",
+        )
+        self.assertIn("invalid choice: 'foo'", stderr)
+        self.assertFalse(stdout)
+
+    def test_useless_error_format(self):
+        stdout, stderr = self.cli_output_for(
+            "--output", "pretty",
+            "--error-format", "foo",
+            "mem://some/schema",
+        )
+        self.assertIn(
+            "--error-format can only be used with --output plain",
+            stderr,
+        )
+        self.assertFalse(stdout)
+
+
+class TestCLIIntegration(TestCase):
+    def test_license(self):
+        output = subprocess.check_output(
+            [sys.executable, "-m", "pip", "show", "jsonschema"],
+            stderr=subprocess.STDOUT,
+        )
+        self.assertIn(b"License: MIT", output)
+
+    def test_version(self):
+        version = subprocess.check_output(
+            [sys.executable, "-W", "ignore", "-m", "jsonschema", "--version"],
+            stderr=subprocess.STDOUT,
+        )
+        version = version.decode("utf-8").strip()
+        self.assertEqual(version, metadata.version("jsonschema"))
+
+    def test_no_arguments_shows_usage_notes(self):
+        output = subprocess.check_output(
+            [sys.executable, "-m", "jsonschema"],
+            stderr=subprocess.STDOUT,
+        )
+        output_for_help = subprocess.check_output(
+            [sys.executable, "-m", "jsonschema", "--help"],
+            stderr=subprocess.STDOUT,
+        )
+        self.assertEqual(output, output_for_help)
diff --git a/llm/Lib/site-packages/jsonschema/tests/test_deprecations.py b/llm/Lib/site-packages/jsonschema/tests/test_deprecations.py
new file mode 100644
index 0000000000000000000000000000000000000000..aea922d238944f29b4be67ffbef7ed0b74d250db
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/tests/test_deprecations.py
@@ -0,0 +1,432 @@
+from contextlib import contextmanager
+from io import BytesIO
+from unittest import TestCase, mock
+import importlib.metadata
+import json
+import subprocess
+import sys
+import urllib.request
+
+import referencing.exceptions
+
+from jsonschema import FormatChecker, exceptions, protocols, validators
+
+
+class TestDeprecations(TestCase):
+    def test_version(self):
+        """
+        As of v4.0.0, __version__ is deprecated in favor of importlib.metadata.
+        """
+
+        message = "Accessing jsonschema.__version__ is deprecated"
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema import __version__
+
+        self.assertEqual(__version__, importlib.metadata.version("jsonschema"))
+        self.assertEqual(w.filename, __file__)
+
+    def test_validators_ErrorTree(self):
+        """
+        As of v4.0.0, importing ErrorTree from jsonschema.validators is
+        deprecated in favor of doing so from jsonschema.exceptions.
+        """
+
+        message = "Importing ErrorTree from jsonschema.validators is "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema.validators import ErrorTree
+
+        self.assertEqual(ErrorTree, exceptions.ErrorTree)
+        self.assertEqual(w.filename, __file__)
+
+    def test_import_ErrorTree(self):
+        """
+        As of v4.18.0, importing ErrorTree from the package root is
+        deprecated in favor of doing so from jsonschema.exceptions.
+        """
+
+        message = "Importing ErrorTree directly from the jsonschema package "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema import ErrorTree
+
+        self.assertEqual(ErrorTree, exceptions.ErrorTree)
+        self.assertEqual(w.filename, __file__)
+
+    def test_ErrorTree_setitem(self):
+        """
+        As of v4.20.0, setting items on an ErrorTree is deprecated.
+        """
+
+        e = exceptions.ValidationError("some error", path=["foo"])
+        tree = exceptions.ErrorTree()
+        subtree = exceptions.ErrorTree(errors=[e])
+
+        message = "ErrorTree.__setitem__ is "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            tree["foo"] = subtree
+
+        self.assertEqual(tree["foo"], subtree)
+        self.assertEqual(w.filename, __file__)
+
+    def test_import_FormatError(self):
+        """
+        As of v4.18.0, importing FormatError from the package root is
+        deprecated in favor of doing so from jsonschema.exceptions.
+        """
+
+        message = "Importing FormatError directly from the jsonschema package "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema import FormatError
+
+        self.assertEqual(FormatError, exceptions.FormatError)
+        self.assertEqual(w.filename, __file__)
+
+    def test_import_Validator(self):
+        """
+        As of v4.19.0, importing Validator from the package root is
+        deprecated in favor of doing so from jsonschema.protocols.
+        """
+
+        message = "Importing Validator directly from the jsonschema package "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema import Validator
+
+        self.assertEqual(Validator, protocols.Validator)
+        self.assertEqual(w.filename, __file__)
+
+    def test_validators_validators(self):
+        """
+        As of v4.0.0, accessing jsonschema.validators.validators is
+        deprecated.
+        """
+
+        message = "Accessing jsonschema.validators.validators is deprecated"
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            value = validators.validators
+
+        self.assertEqual(value, validators._VALIDATORS)
+        self.assertEqual(w.filename, __file__)
+
+    def test_validators_meta_schemas(self):
+        """
+        As of v4.0.0, accessing jsonschema.validators.meta_schemas is
+        deprecated.
+        """
+
+        message = "Accessing jsonschema.validators.meta_schemas is deprecated"
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            value = validators.meta_schemas
+
+        self.assertEqual(value, validators._META_SCHEMAS)
+        self.assertEqual(w.filename, __file__)
+
+    def test_RefResolver_in_scope(self):
+        """
+        As of v4.0.0, RefResolver.in_scope is deprecated.
+        """
+
+        resolver = validators._RefResolver.from_schema({})
+        message = "jsonschema.RefResolver.in_scope is deprecated "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:  # noqa: SIM117
+            with resolver.in_scope("foo"):
+                pass
+
+        self.assertEqual(w.filename, __file__)
+
+    def test_Validator_is_valid_two_arguments(self):
+        """
+        As of v4.0.0, calling is_valid with two arguments (to provide a
+        different schema) is deprecated.
+        """
+
+        validator = validators.Draft7Validator({})
+        message = "Passing a schema to Validator.is_valid is deprecated "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            result = validator.is_valid("foo", {"type": "number"})
+
+        self.assertFalse(result)
+        self.assertEqual(w.filename, __file__)
+
+    def test_Validator_iter_errors_two_arguments(self):
+        """
+        As of v4.0.0, calling iter_errors with two arguments (to provide a
+        different schema) is deprecated.
+        """
+
+        validator = validators.Draft7Validator({})
+        message = "Passing a schema to Validator.iter_errors is deprecated "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            error, = validator.iter_errors("foo", {"type": "number"})
+
+        self.assertEqual(error.validator, "type")
+        self.assertEqual(w.filename, __file__)
+
+    def test_Validator_resolver(self):
+        """
+        As of v4.18.0, accessing Validator.resolver is deprecated.
+        """
+
+        validator = validators.Draft7Validator({})
+        message = "Accessing Draft7Validator.resolver is "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            self.assertIsInstance(validator.resolver, validators._RefResolver)
+
+        self.assertEqual(w.filename, __file__)
+
+    def test_RefResolver(self):
+        """
+        As of v4.18.0, RefResolver is fully deprecated.
+        """
+
+        message = "jsonschema.RefResolver is deprecated"
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema import RefResolver
+        self.assertEqual(w.filename, __file__)
+
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema.validators import RefResolver  # noqa: F401, F811
+        self.assertEqual(w.filename, __file__)
+
+    def test_RefResolutionError(self):
+        """
+        As of v4.18.0, RefResolutionError is deprecated in favor of directly
+        catching errors from the referencing library.
+        """
+
+        message = "jsonschema.exceptions.RefResolutionError is deprecated"
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema import RefResolutionError
+
+        self.assertEqual(RefResolutionError, exceptions._RefResolutionError)
+        self.assertEqual(w.filename, __file__)
+
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema.exceptions import RefResolutionError
+
+        self.assertEqual(RefResolutionError, exceptions._RefResolutionError)
+        self.assertEqual(w.filename, __file__)
+
+    def test_catching_Unresolvable_directly(self):
+        """
+        This behavior is the intended behavior (i.e. it's not deprecated), but
+        given we do "tricksy" things in the iterim to wrap exceptions in a
+        multiple inheritance subclass, we need to be extra sure it works and
+        stays working.
+        """
+        validator = validators.Draft202012Validator({"$ref": "urn:nothing"})
+
+        with self.assertRaises(referencing.exceptions.Unresolvable) as e:
+            validator.validate(12)
+
+        expected = referencing.exceptions.Unresolvable(ref="urn:nothing")
+        self.assertEqual(
+            (e.exception, str(e.exception)),
+            (expected, "Unresolvable: urn:nothing"),
+        )
+
+    def test_catching_Unresolvable_via_RefResolutionError(self):
+        """
+        Until RefResolutionError is removed, it is still possible to catch
+        exceptions from reference resolution using it, even though they may
+        have been raised by referencing.
+        """
+        with self.assertWarns(DeprecationWarning):
+            from jsonschema import RefResolutionError
+
+        validator = validators.Draft202012Validator({"$ref": "urn:nothing"})
+
+        with self.assertRaises(referencing.exceptions.Unresolvable) as u:
+            validator.validate(12)
+
+        with self.assertRaises(RefResolutionError) as e:
+            validator.validate(12)
+
+        self.assertEqual(
+            (e.exception, str(e.exception)),
+            (u.exception, "Unresolvable: urn:nothing"),
+        )
+
+    def test_WrappedReferencingError_hashability(self):
+        """
+        Ensure the wrapped referencing errors are hashable when possible.
+        """
+        with self.assertWarns(DeprecationWarning):
+            from jsonschema import RefResolutionError
+
+        validator = validators.Draft202012Validator({"$ref": "urn:nothing"})
+
+        with self.assertRaises(referencing.exceptions.Unresolvable) as u:
+            validator.validate(12)
+
+        with self.assertRaises(RefResolutionError) as e:
+            validator.validate(12)
+
+        self.assertIn(e.exception, {u.exception})
+        self.assertIn(u.exception, {e.exception})
+
+    def test_Validator_subclassing(self):
+        """
+        As of v4.12.0, subclassing a validator class produces an explicit
+        deprecation warning.
+
+        This was never intended to be public API (and some comments over the
+        years in issues said so, but obviously that's not a great way to make
+        sure it's followed).
+
+        A future version will explicitly raise an error.
+        """
+
+        message = "Subclassing validator classes is "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            class Subclass(validators.Draft202012Validator):
+                pass
+
+        self.assertEqual(w.filename, __file__)
+
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            class AnotherSubclass(validators.create(meta_schema={})):
+                pass
+
+    def test_FormatChecker_cls_checks(self):
+        """
+        As of v4.14.0, FormatChecker.cls_checks is deprecated without
+        replacement.
+        """
+
+        self.addCleanup(FormatChecker.checkers.pop, "boom", None)
+
+        message = "FormatChecker.cls_checks "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            FormatChecker.cls_checks("boom")
+
+        self.assertEqual(w.filename, __file__)
+
+    def test_draftN_format_checker(self):
+        """
+        As of v4.16.0, accessing jsonschema.draftn_format_checker is deprecated
+        in favor of Validator.FORMAT_CHECKER.
+        """
+
+        message = "Accessing jsonschema.draft202012_format_checker is "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema import draft202012_format_checker
+
+        self.assertIs(
+            draft202012_format_checker,
+            validators.Draft202012Validator.FORMAT_CHECKER,
+        )
+        self.assertEqual(w.filename, __file__)
+
+        message = "Accessing jsonschema.draft201909_format_checker is "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema import draft201909_format_checker
+
+        self.assertIs(
+            draft201909_format_checker,
+            validators.Draft201909Validator.FORMAT_CHECKER,
+        )
+        self.assertEqual(w.filename, __file__)
+
+        message = "Accessing jsonschema.draft7_format_checker is "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema import draft7_format_checker
+
+        self.assertIs(
+            draft7_format_checker,
+            validators.Draft7Validator.FORMAT_CHECKER,
+        )
+        self.assertEqual(w.filename, __file__)
+
+        message = "Accessing jsonschema.draft6_format_checker is "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema import draft6_format_checker
+
+        self.assertIs(
+            draft6_format_checker,
+            validators.Draft6Validator.FORMAT_CHECKER,
+        )
+        self.assertEqual(w.filename, __file__)
+
+        message = "Accessing jsonschema.draft4_format_checker is "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema import draft4_format_checker
+
+        self.assertIs(
+            draft4_format_checker,
+            validators.Draft4Validator.FORMAT_CHECKER,
+        )
+        self.assertEqual(w.filename, __file__)
+
+        message = "Accessing jsonschema.draft3_format_checker is "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            from jsonschema import draft3_format_checker
+
+        self.assertIs(
+            draft3_format_checker,
+            validators.Draft3Validator.FORMAT_CHECKER,
+        )
+        self.assertEqual(w.filename, __file__)
+
+        with self.assertRaises(ImportError):
+            from jsonschema import draft1234_format_checker  # noqa: F401
+
+    def test_import_cli(self):
+        """
+        As of v4.17.0, importing jsonschema.cli is deprecated.
+        """
+
+        message = "The jsonschema CLI is deprecated and will be removed "
+        with self.assertWarnsRegex(DeprecationWarning, message) as w:
+            import jsonschema.cli
+            importlib.reload(jsonschema.cli)
+
+        self.assertEqual(w.filename, importlib.__file__)
+
+    def test_cli(self):
+        """
+        As of v4.17.0, the jsonschema CLI is deprecated.
+        """
+
+        process = subprocess.run(
+            [sys.executable, "-m", "jsonschema"],
+            capture_output=True,
+            check=True,
+        )
+        self.assertIn(b"The jsonschema CLI is deprecated ", process.stderr)
+
+    def test_automatic_remote_retrieval(self):
+        """
+        Automatic retrieval of remote references is deprecated as of v4.18.0.
+        """
+        ref = "http://bar#/$defs/baz"
+        schema = {"$defs": {"baz": {"type": "integer"}}}
+
+        if "requests" in sys.modules:  # pragma: no cover
+            self.addCleanup(
+                sys.modules.__setitem__, "requests", sys.modules["requests"],
+            )
+        sys.modules["requests"] = None
+
+        @contextmanager
+        def fake_urlopen(request):
+            self.assertIsInstance(request, urllib.request.Request)
+            self.assertEqual(request.full_url, "http://bar")
+
+            # Ha ha urllib.request.Request "normalizes" header names and
+            # Request.get_header does not also normalize them...
+            (header, value), = request.header_items()
+            self.assertEqual(header.lower(), "user-agent")
+            self.assertEqual(
+                value, "python-jsonschema (deprecated $ref resolution)",
+            )
+            yield BytesIO(json.dumps(schema).encode("utf8"))
+
+        validator = validators.Draft202012Validator({"$ref": ref})
+
+        message = "Automatically retrieving remote references "
+        patch = mock.patch.object(urllib.request, "urlopen", new=fake_urlopen)
+
+        with patch, self.assertWarnsRegex(DeprecationWarning, message):
+            self.assertEqual(
+                (validator.is_valid({}), validator.is_valid(37)),
+                (False, True),
+            )
diff --git a/llm/Lib/site-packages/jsonschema/tests/test_exceptions.py b/llm/Lib/site-packages/jsonschema/tests/test_exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..18be0589b4fee0ca66f622ddc66039f6d84b41ef
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/tests/test_exceptions.py
@@ -0,0 +1,617 @@
+from unittest import TestCase
+import textwrap
+
+from jsonschema import exceptions
+from jsonschema.validators import _LATEST_VERSION
+
+
+class TestBestMatch(TestCase):
+    def best_match_of(self, instance, schema):
+        errors = list(_LATEST_VERSION(schema).iter_errors(instance))
+        best = exceptions.best_match(iter(errors))
+        reversed_best = exceptions.best_match(reversed(errors))
+        self.assertEqual(
+            best._contents(),
+            reversed_best._contents(),
+            f"No consistent best match!\nGot: {best}\n\nThen: {reversed_best}",
+        )
+        return best
+
+    def test_shallower_errors_are_better_matches(self):
+        schema = {
+            "properties": {
+                "foo": {
+                    "minProperties": 2,
+                    "properties": {"bar": {"type": "object"}},
+                },
+            },
+        }
+        best = self.best_match_of(instance={"foo": {"bar": []}}, schema=schema)
+        self.assertEqual(best.validator, "minProperties")
+
+    def test_oneOf_and_anyOf_are_weak_matches(self):
+        """
+        A property you *must* match is probably better than one you have to
+        match a part of.
+        """
+
+        schema = {
+            "minProperties": 2,
+            "anyOf": [{"type": "string"}, {"type": "number"}],
+            "oneOf": [{"type": "string"}, {"type": "number"}],
+        }
+        best = self.best_match_of(instance={}, schema=schema)
+        self.assertEqual(best.validator, "minProperties")
+
+    def test_if_the_most_relevant_error_is_anyOf_it_is_traversed(self):
+        """
+        If the most relevant error is an anyOf, then we traverse its context
+        and select the otherwise *least* relevant error, since in this case
+        that means the most specific, deep, error inside the instance.
+
+        I.e. since only one of the schemas must match, we look for the most
+        relevant one.
+        """
+
+        schema = {
+            "properties": {
+                "foo": {
+                    "anyOf": [
+                        {"type": "string"},
+                        {"properties": {"bar": {"type": "array"}}},
+                    ],
+                },
+            },
+        }
+        best = self.best_match_of(instance={"foo": {"bar": 12}}, schema=schema)
+        self.assertEqual(best.validator_value, "array")
+
+    def test_no_anyOf_traversal_for_equally_relevant_errors(self):
+        """
+        We don't traverse into an anyOf (as above) if all of its context errors
+        seem to be equally "wrong" against the instance.
+        """
+
+        schema = {
+            "anyOf": [
+                {"type": "string"},
+                {"type": "integer"},
+                {"type": "object"},
+            ],
+        }
+        best = self.best_match_of(instance=[], schema=schema)
+        self.assertEqual(best.validator, "anyOf")
+
+    def test_anyOf_traversal_for_single_equally_relevant_error(self):
+        """
+        We *do* traverse anyOf with a single nested error, even though it is
+        vacuously equally relevant to itself.
+        """
+
+        schema = {
+            "anyOf": [
+                {"type": "string"},
+            ],
+        }
+        best = self.best_match_of(instance=[], schema=schema)
+        self.assertEqual(best.validator, "type")
+
+    def test_if_the_most_relevant_error_is_oneOf_it_is_traversed(self):
+        """
+        If the most relevant error is an oneOf, then we traverse its context
+        and select the otherwise *least* relevant error, since in this case
+        that means the most specific, deep, error inside the instance.
+
+        I.e. since only one of the schemas must match, we look for the most
+        relevant one.
+        """
+
+        schema = {
+            "properties": {
+                "foo": {
+                    "oneOf": [
+                        {"type": "string"},
+                        {"properties": {"bar": {"type": "array"}}},
+                    ],
+                },
+            },
+        }
+        best = self.best_match_of(instance={"foo": {"bar": 12}}, schema=schema)
+        self.assertEqual(best.validator_value, "array")
+
+    def test_no_oneOf_traversal_for_equally_relevant_errors(self):
+        """
+        We don't traverse into an oneOf (as above) if all of its context errors
+        seem to be equally "wrong" against the instance.
+        """
+
+        schema = {
+            "oneOf": [
+                {"type": "string"},
+                {"type": "integer"},
+                {"type": "object"},
+            ],
+        }
+        best = self.best_match_of(instance=[], schema=schema)
+        self.assertEqual(best.validator, "oneOf")
+
+    def test_oneOf_traversal_for_single_equally_relevant_error(self):
+        """
+        We *do* traverse oneOf with a single nested error, even though it is
+        vacuously equally relevant to itself.
+        """
+
+        schema = {
+            "oneOf": [
+                {"type": "string"},
+            ],
+        }
+        best = self.best_match_of(instance=[], schema=schema)
+        self.assertEqual(best.validator, "type")
+
+    def test_if_the_most_relevant_error_is_allOf_it_is_traversed(self):
+        """
+        Now, if the error is allOf, we traverse but select the *most* relevant
+        error from the context, because all schemas here must match anyways.
+        """
+
+        schema = {
+            "properties": {
+                "foo": {
+                    "allOf": [
+                        {"type": "string"},
+                        {"properties": {"bar": {"type": "array"}}},
+                    ],
+                },
+            },
+        }
+        best = self.best_match_of(instance={"foo": {"bar": 12}}, schema=schema)
+        self.assertEqual(best.validator_value, "string")
+
+    def test_nested_context_for_oneOf(self):
+        """
+        We traverse into nested contexts (a oneOf containing an error in a
+        nested oneOf here).
+        """
+
+        schema = {
+            "properties": {
+                "foo": {
+                    "oneOf": [
+                        {"type": "string"},
+                        {
+                            "oneOf": [
+                                {"type": "string"},
+                                {
+                                    "properties": {
+                                        "bar": {"type": "array"},
+                                    },
+                                },
+                            ],
+                        },
+                    ],
+                },
+            },
+        }
+        best = self.best_match_of(instance={"foo": {"bar": 12}}, schema=schema)
+        self.assertEqual(best.validator_value, "array")
+
+    def test_it_prioritizes_matching_types(self):
+        schema = {
+            "properties": {
+                "foo": {
+                    "anyOf": [
+                        {"type": "array", "minItems": 2},
+                        {"type": "string", "minLength": 10},
+                    ],
+                },
+            },
+        }
+        best = self.best_match_of(instance={"foo": "bar"}, schema=schema)
+        self.assertEqual(best.validator, "minLength")
+
+        reordered = {
+            "properties": {
+                "foo": {
+                    "anyOf": [
+                        {"type": "string", "minLength": 10},
+                        {"type": "array", "minItems": 2},
+                    ],
+                },
+            },
+        }
+        best = self.best_match_of(instance={"foo": "bar"}, schema=reordered)
+        self.assertEqual(best.validator, "minLength")
+
+    def test_it_prioritizes_matching_union_types(self):
+        schema = {
+            "properties": {
+                "foo": {
+                    "anyOf": [
+                        {"type": ["array", "object"], "minItems": 2},
+                        {"type": ["integer", "string"], "minLength": 10},
+                    ],
+                },
+            },
+        }
+        best = self.best_match_of(instance={"foo": "bar"}, schema=schema)
+        self.assertEqual(best.validator, "minLength")
+
+        reordered = {
+            "properties": {
+                "foo": {
+                    "anyOf": [
+                        {"type": "string", "minLength": 10},
+                        {"type": "array", "minItems": 2},
+                    ],
+                },
+            },
+        }
+        best = self.best_match_of(instance={"foo": "bar"}, schema=reordered)
+        self.assertEqual(best.validator, "minLength")
+
+    def test_boolean_schemas(self):
+        schema = {"properties": {"foo": False}}
+        best = self.best_match_of(instance={"foo": "bar"}, schema=schema)
+        self.assertIsNone(best.validator)
+
+    def test_one_error(self):
+        validator = _LATEST_VERSION({"minProperties": 2})
+        error, = validator.iter_errors({})
+        self.assertEqual(
+            exceptions.best_match(validator.iter_errors({})).validator,
+            "minProperties",
+        )
+
+    def test_no_errors(self):
+        validator = _LATEST_VERSION({})
+        self.assertIsNone(exceptions.best_match(validator.iter_errors({})))
+
+
+class TestByRelevance(TestCase):
+    def test_short_paths_are_better_matches(self):
+        shallow = exceptions.ValidationError("Oh no!", path=["baz"])
+        deep = exceptions.ValidationError("Oh yes!", path=["foo", "bar"])
+        match = max([shallow, deep], key=exceptions.relevance)
+        self.assertIs(match, shallow)
+
+        match = max([deep, shallow], key=exceptions.relevance)
+        self.assertIs(match, shallow)
+
+    def test_global_errors_are_even_better_matches(self):
+        shallow = exceptions.ValidationError("Oh no!", path=[])
+        deep = exceptions.ValidationError("Oh yes!", path=["foo"])
+
+        errors = sorted([shallow, deep], key=exceptions.relevance)
+        self.assertEqual(
+            [list(error.path) for error in errors],
+            [["foo"], []],
+        )
+
+        errors = sorted([deep, shallow], key=exceptions.relevance)
+        self.assertEqual(
+            [list(error.path) for error in errors],
+            [["foo"], []],
+        )
+
+    def test_weak_keywords_are_lower_priority(self):
+        weak = exceptions.ValidationError("Oh no!", path=[], validator="a")
+        normal = exceptions.ValidationError("Oh yes!", path=[], validator="b")
+
+        best_match = exceptions.by_relevance(weak="a")
+
+        match = max([weak, normal], key=best_match)
+        self.assertIs(match, normal)
+
+        match = max([normal, weak], key=best_match)
+        self.assertIs(match, normal)
+
+    def test_strong_keywords_are_higher_priority(self):
+        weak = exceptions.ValidationError("Oh no!", path=[], validator="a")
+        normal = exceptions.ValidationError("Oh yes!", path=[], validator="b")
+        strong = exceptions.ValidationError("Oh fine!", path=[], validator="c")
+
+        best_match = exceptions.by_relevance(weak="a", strong="c")
+
+        match = max([weak, normal, strong], key=best_match)
+        self.assertIs(match, strong)
+
+        match = max([strong, normal, weak], key=best_match)
+        self.assertIs(match, strong)
+
+
+class TestErrorTree(TestCase):
+    def test_it_knows_how_many_total_errors_it_contains(self):
+        # FIXME: #442
+        errors = [
+            exceptions.ValidationError("Something", validator=i)
+            for i in range(8)
+        ]
+        tree = exceptions.ErrorTree(errors)
+        self.assertEqual(tree.total_errors, 8)
+
+    def test_it_contains_an_item_if_the_item_had_an_error(self):
+        errors = [exceptions.ValidationError("a message", path=["bar"])]
+        tree = exceptions.ErrorTree(errors)
+        self.assertIn("bar", tree)
+
+    def test_it_does_not_contain_an_item_if_the_item_had_no_error(self):
+        errors = [exceptions.ValidationError("a message", path=["bar"])]
+        tree = exceptions.ErrorTree(errors)
+        self.assertNotIn("foo", tree)
+
+    def test_keywords_that_failed_appear_in_errors_dict(self):
+        error = exceptions.ValidationError("a message", validator="foo")
+        tree = exceptions.ErrorTree([error])
+        self.assertEqual(tree.errors, {"foo": error})
+
+    def test_it_creates_a_child_tree_for_each_nested_path(self):
+        errors = [
+            exceptions.ValidationError("a bar message", path=["bar"]),
+            exceptions.ValidationError("a bar -> 0 message", path=["bar", 0]),
+        ]
+        tree = exceptions.ErrorTree(errors)
+        self.assertIn(0, tree["bar"])
+        self.assertNotIn(1, tree["bar"])
+
+    def test_children_have_their_errors_dicts_built(self):
+        e1, e2 = (
+            exceptions.ValidationError("1", validator="foo", path=["bar", 0]),
+            exceptions.ValidationError("2", validator="quux", path=["bar", 0]),
+        )
+        tree = exceptions.ErrorTree([e1, e2])
+        self.assertEqual(tree["bar"][0].errors, {"foo": e1, "quux": e2})
+
+    def test_multiple_errors_with_instance(self):
+        e1, e2 = (
+            exceptions.ValidationError(
+                "1",
+                validator="foo",
+                path=["bar", "bar2"],
+                instance="i1"),
+            exceptions.ValidationError(
+                "2",
+                validator="quux",
+                path=["foobar", 2],
+                instance="i2"),
+        )
+        exceptions.ErrorTree([e1, e2])
+
+    def test_it_does_not_contain_subtrees_that_are_not_in_the_instance(self):
+        error = exceptions.ValidationError("123", validator="foo", instance=[])
+        tree = exceptions.ErrorTree([error])
+
+        with self.assertRaises(IndexError):
+            tree[0]
+
+    def test_if_its_in_the_tree_anyhow_it_does_not_raise_an_error(self):
+        """
+        If a keyword refers to a path that isn't in the instance, the
+        tree still properly returns a subtree for that path.
+        """
+
+        error = exceptions.ValidationError(
+            "a message", validator="foo", instance={}, path=["foo"],
+        )
+        tree = exceptions.ErrorTree([error])
+        self.assertIsInstance(tree["foo"], exceptions.ErrorTree)
+
+    def test_iter(self):
+        e1, e2 = (
+            exceptions.ValidationError(
+                "1",
+                validator="foo",
+                path=["bar", "bar2"],
+                instance="i1"),
+            exceptions.ValidationError(
+                "2",
+                validator="quux",
+                path=["foobar", 2],
+                instance="i2"),
+        )
+        tree = exceptions.ErrorTree([e1, e2])
+        self.assertEqual(set(tree), {"bar", "foobar"})
+
+    def test_repr_single(self):
+        error = exceptions.ValidationError(
+            "1",
+            validator="foo",
+            path=["bar", "bar2"],
+            instance="i1",
+        )
+        tree = exceptions.ErrorTree([error])
+        self.assertEqual(repr(tree), "<ErrorTree (1 total error)>")
+
+    def test_repr_multiple(self):
+        e1, e2 = (
+            exceptions.ValidationError(
+                "1",
+                validator="foo",
+                path=["bar", "bar2"],
+                instance="i1"),
+            exceptions.ValidationError(
+                "2",
+                validator="quux",
+                path=["foobar", 2],
+                instance="i2"),
+        )
+        tree = exceptions.ErrorTree([e1, e2])
+        self.assertEqual(repr(tree), "<ErrorTree (2 total errors)>")
+
+    def test_repr_empty(self):
+        tree = exceptions.ErrorTree([])
+        self.assertEqual(repr(tree), "<ErrorTree (0 total errors)>")
+
+
+class TestErrorInitReprStr(TestCase):
+    def make_error(self, **kwargs):
+        defaults = dict(
+            message="hello",
+            validator="type",
+            validator_value="string",
+            instance=5,
+            schema={"type": "string"},
+        )
+        defaults.update(kwargs)
+        return exceptions.ValidationError(**defaults)
+
+    def assertShows(self, expected, **kwargs):
+        expected = textwrap.dedent(expected).rstrip("\n")
+
+        error = self.make_error(**kwargs)
+        message_line, _, rest = str(error).partition("\n")
+        self.assertEqual(message_line, error.message)
+        self.assertEqual(rest, expected)
+
+    def test_it_calls_super_and_sets_args(self):
+        error = self.make_error()
+        self.assertGreater(len(error.args), 1)
+
+    def test_repr(self):
+        self.assertEqual(
+            repr(exceptions.ValidationError(message="Hello!")),
+            "<ValidationError: 'Hello!'>",
+        )
+
+    def test_unset_error(self):
+        error = exceptions.ValidationError("message")
+        self.assertEqual(str(error), "message")
+
+        kwargs = {
+            "validator": "type",
+            "validator_value": "string",
+            "instance": 5,
+            "schema": {"type": "string"},
+        }
+        # Just the message should show if any of the attributes are unset
+        for attr in kwargs:
+            k = dict(kwargs)
+            del k[attr]
+            error = exceptions.ValidationError("message", **k)
+            self.assertEqual(str(error), "message")
+
+    def test_empty_paths(self):
+        self.assertShows(
+            """
+            Failed validating 'type' in schema:
+                {'type': 'string'}
+
+            On instance:
+                5
+            """,
+            path=[],
+            schema_path=[],
+        )
+
+    def test_one_item_paths(self):
+        self.assertShows(
+            """
+            Failed validating 'type' in schema:
+                {'type': 'string'}
+
+            On instance[0]:
+                5
+            """,
+            path=[0],
+            schema_path=["items"],
+        )
+
+    def test_multiple_item_paths(self):
+        self.assertShows(
+            """
+            Failed validating 'type' in schema['items'][0]:
+                {'type': 'string'}
+
+            On instance[0]['a']:
+                5
+            """,
+            path=[0, "a"],
+            schema_path=["items", 0, 1],
+        )
+
+    def test_uses_pprint(self):
+        self.assertShows(
+            """
+            Failed validating 'maxLength' in schema:
+                {0: 0,
+                 1: 1,
+                 2: 2,
+                 3: 3,
+                 4: 4,
+                 5: 5,
+                 6: 6,
+                 7: 7,
+                 8: 8,
+                 9: 9,
+                 10: 10,
+                 11: 11,
+                 12: 12,
+                 13: 13,
+                 14: 14,
+                 15: 15,
+                 16: 16,
+                 17: 17,
+                 18: 18,
+                 19: 19}
+
+            On instance:
+                [0,
+                 1,
+                 2,
+                 3,
+                 4,
+                 5,
+                 6,
+                 7,
+                 8,
+                 9,
+                 10,
+                 11,
+                 12,
+                 13,
+                 14,
+                 15,
+                 16,
+                 17,
+                 18,
+                 19,
+                 20,
+                 21,
+                 22,
+                 23,
+                 24]
+            """,
+            instance=list(range(25)),
+            schema=dict(zip(range(20), range(20))),
+            validator="maxLength",
+        )
+
+    def test_str_works_with_instances_having_overriden_eq_operator(self):
+        """
+        Check for #164 which rendered exceptions unusable when a
+        `ValidationError` involved instances with an `__eq__` method
+        that returned truthy values.
+        """
+
+        class DontEQMeBro:
+            def __eq__(this, other):  # pragma: no cover
+                self.fail("Don't!")
+
+            def __ne__(this, other):  # pragma: no cover
+                self.fail("Don't!")
+
+        instance = DontEQMeBro()
+        error = exceptions.ValidationError(
+            "a message",
+            validator="foo",
+            instance=instance,
+            validator_value="some",
+            schema="schema",
+        )
+        self.assertIn(repr(instance), str(error))
+
+
+class TestHashable(TestCase):
+    def test_hashable(self):
+        {exceptions.ValidationError("")}
+        {exceptions.SchemaError("")}
diff --git a/llm/Lib/site-packages/jsonschema/tests/test_format.py b/llm/Lib/site-packages/jsonschema/tests/test_format.py
new file mode 100644
index 0000000000000000000000000000000000000000..d829f9848f51f882d5a3f9413c80e0dbdcdaf292
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/tests/test_format.py
@@ -0,0 +1,91 @@
+"""
+Tests for the parts of jsonschema related to the :kw:`format` keyword.
+"""
+
+from unittest import TestCase
+
+from jsonschema import FormatChecker, ValidationError
+from jsonschema.exceptions import FormatError
+from jsonschema.validators import Draft4Validator
+
+BOOM = ValueError("Boom!")
+BANG = ZeroDivisionError("Bang!")
+
+
+def boom(thing):
+    if thing == "bang":
+        raise BANG
+    raise BOOM
+
+
+class TestFormatChecker(TestCase):
+    def test_it_can_validate_no_formats(self):
+        checker = FormatChecker(formats=())
+        self.assertFalse(checker.checkers)
+
+    def test_it_raises_a_key_error_for_unknown_formats(self):
+        with self.assertRaises(KeyError):
+            FormatChecker(formats=["o noes"])
+
+    def test_it_can_register_cls_checkers(self):
+        original = dict(FormatChecker.checkers)
+        self.addCleanup(FormatChecker.checkers.pop, "boom")
+        with self.assertWarns(DeprecationWarning):
+            FormatChecker.cls_checks("boom")(boom)
+        self.assertEqual(
+            FormatChecker.checkers,
+            dict(original, boom=(boom, ())),
+        )
+
+    def test_it_can_register_checkers(self):
+        checker = FormatChecker()
+        checker.checks("boom")(boom)
+        self.assertEqual(
+            checker.checkers,
+            dict(FormatChecker.checkers, boom=(boom, ())),
+        )
+
+    def test_it_catches_registered_errors(self):
+        checker = FormatChecker()
+        checker.checks("boom", raises=type(BOOM))(boom)
+
+        with self.assertRaises(FormatError) as cm:
+            checker.check(instance=12, format="boom")
+
+        self.assertIs(cm.exception.cause, BOOM)
+        self.assertIs(cm.exception.__cause__, BOOM)
+        self.assertEqual(str(cm.exception), "12 is not a 'boom'")
+
+        # Unregistered errors should not be caught
+        with self.assertRaises(type(BANG)):
+            checker.check(instance="bang", format="boom")
+
+    def test_format_error_causes_become_validation_error_causes(self):
+        checker = FormatChecker()
+        checker.checks("boom", raises=ValueError)(boom)
+        validator = Draft4Validator({"format": "boom"}, format_checker=checker)
+
+        with self.assertRaises(ValidationError) as cm:
+            validator.validate("BOOM")
+
+        self.assertIs(cm.exception.cause, BOOM)
+        self.assertIs(cm.exception.__cause__, BOOM)
+
+    def test_format_checkers_come_with_defaults(self):
+        # This is bad :/ but relied upon.
+        # The docs for quite awhile recommended people do things like
+        # validate(..., format_checker=FormatChecker())
+        # We should change that, but we can't without deprecation...
+        checker = FormatChecker()
+        with self.assertRaises(FormatError):
+            checker.check(instance="not-an-ipv4", format="ipv4")
+
+    def test_repr(self):
+        checker = FormatChecker(formats=())
+        checker.checks("foo")(lambda thing: True)  # pragma: no cover
+        checker.checks("bar")(lambda thing: True)  # pragma: no cover
+        checker.checks("baz")(lambda thing: True)  # pragma: no cover
+        self.assertEqual(
+            repr(checker),
+            "<FormatChecker checkers=['bar', 'baz', 'foo']>",
+        )
diff --git a/llm/Lib/site-packages/jsonschema/tests/test_jsonschema_test_suite.py b/llm/Lib/site-packages/jsonschema/tests/test_jsonschema_test_suite.py
new file mode 100644
index 0000000000000000000000000000000000000000..282c1369cdd2a3b877ac55a735ad3ad0837ada27
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/tests/test_jsonschema_test_suite.py
@@ -0,0 +1,269 @@
+"""
+Test runner for the JSON Schema official test suite
+
+Tests comprehensive correctness of each draft's validator.
+
+See https://github.com/json-schema-org/JSON-Schema-Test-Suite for details.
+"""
+
+import sys
+
+from jsonschema.tests._suite import Suite
+import jsonschema
+
+SUITE = Suite()
+DRAFT3 = SUITE.version(name="draft3")
+DRAFT4 = SUITE.version(name="draft4")
+DRAFT6 = SUITE.version(name="draft6")
+DRAFT7 = SUITE.version(name="draft7")
+DRAFT201909 = SUITE.version(name="draft2019-09")
+DRAFT202012 = SUITE.version(name="draft2020-12")
+
+
+def skip(message, **kwargs):
+    def skipper(test):
+        if all(value == getattr(test, attr) for attr, value in kwargs.items()):
+            return message
+    return skipper
+
+
+def missing_format(Validator):
+    def missing_format(test):  # pragma: no cover
+        schema = test.schema
+        if (
+            schema is True
+            or schema is False
+            or "format" not in schema
+            or schema["format"] in Validator.FORMAT_CHECKER.checkers
+            or test.valid
+        ):
+            return
+
+        return f"Format checker {schema['format']!r} not found."
+    return missing_format
+
+
+def complex_email_validation(test):
+    if test.subject != "email":
+        return
+
+    message = "Complex email validation is (intentionally) unsupported."
+    return skip(
+        message=message,
+        description="an invalid domain",
+    )(test) or skip(
+        message=message,
+        description="an invalid IPv4-address-literal",
+    )(test) or skip(
+        message=message,
+        description="dot after local part is not valid",
+    )(test) or skip(
+        message=message,
+        description="dot before local part is not valid",
+    )(test) or skip(
+        message=message,
+        description="two subsequent dots inside local part are not valid",
+    )(test)
+
+
+if sys.version_info < (3, 9):  # pragma: no cover
+    message = "Rejecting leading zeros is 3.9+"
+    allowed_leading_zeros = skip(
+        message=message,
+        subject="ipv4",
+        description="invalid leading zeroes, as they are treated as octals",
+    )
+else:
+    def allowed_leading_zeros(test):  # pragma: no cover
+        return
+
+
+def leap_second(test):
+    message = "Leap seconds are unsupported."
+    return skip(
+        message=message,
+        subject="time",
+        description="a valid time string with leap second",
+    )(test) or skip(
+        message=message,
+        subject="time",
+        description="a valid time string with leap second, Zulu",
+    )(test) or skip(
+        message=message,
+        subject="time",
+        description="a valid time string with leap second with offset",
+    )(test) or skip(
+        message=message,
+        subject="time",
+        description="valid leap second, positive time-offset",
+    )(test) or skip(
+        message=message,
+        subject="time",
+        description="valid leap second, negative time-offset",
+    )(test) or skip(
+        message=message,
+        subject="time",
+        description="valid leap second, large positive time-offset",
+    )(test) or skip(
+        message=message,
+        subject="time",
+        description="valid leap second, large negative time-offset",
+    )(test) or skip(
+        message=message,
+        subject="time",
+        description="valid leap second, zero time-offset",
+    )(test) or skip(
+        message=message,
+        subject="date-time",
+        description="a valid date-time with a leap second, UTC",
+    )(test) or skip(
+        message=message,
+        subject="date-time",
+        description="a valid date-time with a leap second, with minus offset",
+    )(test)
+
+
+TestDraft3 = DRAFT3.to_unittest_testcase(
+    DRAFT3.cases(),
+    DRAFT3.format_cases(),
+    DRAFT3.optional_cases_of(name="bignum"),
+    DRAFT3.optional_cases_of(name="non-bmp-regex"),
+    DRAFT3.optional_cases_of(name="zeroTerminatedFloats"),
+    Validator=jsonschema.Draft3Validator,
+    format_checker=jsonschema.Draft3Validator.FORMAT_CHECKER,
+    skip=lambda test: (
+        missing_format(jsonschema.Draft3Validator)(test)
+        or complex_email_validation(test)
+    ),
+)
+
+
+TestDraft4 = DRAFT4.to_unittest_testcase(
+    DRAFT4.cases(),
+    DRAFT4.format_cases(),
+    DRAFT4.optional_cases_of(name="bignum"),
+    DRAFT4.optional_cases_of(name="float-overflow"),
+    DRAFT4.optional_cases_of(name="id"),
+    DRAFT4.optional_cases_of(name="non-bmp-regex"),
+    DRAFT4.optional_cases_of(name="zeroTerminatedFloats"),
+    Validator=jsonschema.Draft4Validator,
+    format_checker=jsonschema.Draft4Validator.FORMAT_CHECKER,
+    skip=lambda test: (
+        allowed_leading_zeros(test)
+        or leap_second(test)
+        or missing_format(jsonschema.Draft4Validator)(test)
+        or complex_email_validation(test)
+    ),
+)
+
+
+TestDraft6 = DRAFT6.to_unittest_testcase(
+    DRAFT6.cases(),
+    DRAFT6.format_cases(),
+    DRAFT6.optional_cases_of(name="bignum"),
+    DRAFT6.optional_cases_of(name="float-overflow"),
+    DRAFT6.optional_cases_of(name="id"),
+    DRAFT6.optional_cases_of(name="non-bmp-regex"),
+    Validator=jsonschema.Draft6Validator,
+    format_checker=jsonschema.Draft6Validator.FORMAT_CHECKER,
+    skip=lambda test: (
+        allowed_leading_zeros(test)
+        or leap_second(test)
+        or missing_format(jsonschema.Draft6Validator)(test)
+        or complex_email_validation(test)
+    ),
+)
+
+
+TestDraft7 = DRAFT7.to_unittest_testcase(
+    DRAFT7.cases(),
+    DRAFT7.format_cases(),
+    DRAFT7.optional_cases_of(name="bignum"),
+    DRAFT7.optional_cases_of(name="cross-draft"),
+    DRAFT7.optional_cases_of(name="float-overflow"),
+    DRAFT6.optional_cases_of(name="id"),
+    DRAFT7.optional_cases_of(name="non-bmp-regex"),
+    DRAFT7.optional_cases_of(name="unknownKeyword"),
+    Validator=jsonschema.Draft7Validator,
+    format_checker=jsonschema.Draft7Validator.FORMAT_CHECKER,
+    skip=lambda test: (
+        allowed_leading_zeros(test)
+        or leap_second(test)
+        or missing_format(jsonschema.Draft7Validator)(test)
+        or complex_email_validation(test)
+    ),
+)
+
+
+TestDraft201909 = DRAFT201909.to_unittest_testcase(
+    DRAFT201909.cases(),
+    DRAFT201909.optional_cases_of(name="anchor"),
+    DRAFT201909.optional_cases_of(name="bignum"),
+    DRAFT201909.optional_cases_of(name="cross-draft"),
+    DRAFT201909.optional_cases_of(name="float-overflow"),
+    DRAFT201909.optional_cases_of(name="id"),
+    DRAFT201909.optional_cases_of(name="no-schema"),
+    DRAFT201909.optional_cases_of(name="non-bmp-regex"),
+    DRAFT201909.optional_cases_of(name="refOfUnknownKeyword"),
+    DRAFT201909.optional_cases_of(name="unknownKeyword"),
+    Validator=jsonschema.Draft201909Validator,
+    skip=skip(
+        message="Vocabulary support is still in-progress.",
+        subject="vocabulary",
+        description=(
+            "no validation: invalid number, but it still validates"
+        ),
+    ),
+)
+
+
+TestDraft201909Format = DRAFT201909.to_unittest_testcase(
+    DRAFT201909.format_cases(),
+    name="TestDraft201909Format",
+    Validator=jsonschema.Draft201909Validator,
+    format_checker=jsonschema.Draft201909Validator.FORMAT_CHECKER,
+    skip=lambda test: (
+        complex_email_validation(test)
+        or allowed_leading_zeros(test)
+        or leap_second(test)
+        or missing_format(jsonschema.Draft201909Validator)(test)
+        or complex_email_validation(test)
+    ),
+)
+
+
+TestDraft202012 = DRAFT202012.to_unittest_testcase(
+    DRAFT202012.cases(),
+    DRAFT201909.optional_cases_of(name="anchor"),
+    DRAFT202012.optional_cases_of(name="bignum"),
+    DRAFT202012.optional_cases_of(name="cross-draft"),
+    DRAFT202012.optional_cases_of(name="float-overflow"),
+    DRAFT202012.optional_cases_of(name="id"),
+    DRAFT202012.optional_cases_of(name="no-schema"),
+    DRAFT202012.optional_cases_of(name="non-bmp-regex"),
+    DRAFT202012.optional_cases_of(name="refOfUnknownKeyword"),
+    DRAFT202012.optional_cases_of(name="unknownKeyword"),
+    Validator=jsonschema.Draft202012Validator,
+    skip=skip(
+        message="Vocabulary support is still in-progress.",
+        subject="vocabulary",
+        description=(
+            "no validation: invalid number, but it still validates"
+        ),
+    ),
+)
+
+
+TestDraft202012Format = DRAFT202012.to_unittest_testcase(
+    DRAFT202012.format_cases(),
+    name="TestDraft202012Format",
+    Validator=jsonschema.Draft202012Validator,
+    format_checker=jsonschema.Draft202012Validator.FORMAT_CHECKER,
+    skip=lambda test: (
+        complex_email_validation(test)
+        or allowed_leading_zeros(test)
+        or leap_second(test)
+        or missing_format(jsonschema.Draft202012Validator)(test)
+        or complex_email_validation(test)
+    ),
+)
diff --git a/llm/Lib/site-packages/jsonschema/tests/test_types.py b/llm/Lib/site-packages/jsonschema/tests/test_types.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd97b180029ae05d7f3b22f1048f9adcb769f36f
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/tests/test_types.py
@@ -0,0 +1,221 @@
+"""
+Tests for the `TypeChecker`-based type interface.
+
+The actual correctness of the type checking is handled in
+`test_jsonschema_test_suite`; these tests check that TypeChecker
+functions correctly at a more granular level.
+"""
+from collections import namedtuple
+from unittest import TestCase
+
+from jsonschema import ValidationError, _keywords
+from jsonschema._types import TypeChecker
+from jsonschema.exceptions import UndefinedTypeCheck, UnknownType
+from jsonschema.validators import Draft202012Validator, extend
+
+
+def equals_2(checker, instance):
+    return instance == 2
+
+
+def is_namedtuple(instance):
+    return isinstance(instance, tuple) and getattr(instance, "_fields", None)
+
+
+def is_object_or_named_tuple(checker, instance):
+    if Draft202012Validator.TYPE_CHECKER.is_type(instance, "object"):
+        return True
+    return is_namedtuple(instance)
+
+
+class TestTypeChecker(TestCase):
+    def test_is_type(self):
+        checker = TypeChecker({"two": equals_2})
+        self.assertEqual(
+            (
+                checker.is_type(instance=2, type="two"),
+                checker.is_type(instance="bar", type="two"),
+            ),
+            (True, False),
+        )
+
+    def test_is_unknown_type(self):
+        with self.assertRaises(UndefinedTypeCheck) as e:
+            TypeChecker().is_type(4, "foobar")
+        self.assertIn(
+            "'foobar' is unknown to this type checker",
+            str(e.exception),
+        )
+        self.assertTrue(
+            e.exception.__suppress_context__,
+            msg="Expected the internal KeyError to be hidden.",
+        )
+
+    def test_checks_can_be_added_at_init(self):
+        checker = TypeChecker({"two": equals_2})
+        self.assertEqual(checker, TypeChecker().redefine("two", equals_2))
+
+    def test_redefine_existing_type(self):
+        self.assertEqual(
+            TypeChecker().redefine("two", object()).redefine("two", equals_2),
+            TypeChecker().redefine("two", equals_2),
+        )
+
+    def test_remove(self):
+        self.assertEqual(
+            TypeChecker({"two": equals_2}).remove("two"),
+            TypeChecker(),
+        )
+
+    def test_remove_unknown_type(self):
+        with self.assertRaises(UndefinedTypeCheck) as context:
+            TypeChecker().remove("foobar")
+        self.assertIn("foobar", str(context.exception))
+
+    def test_redefine_many(self):
+        self.assertEqual(
+            TypeChecker().redefine_many({"foo": int, "bar": str}),
+            TypeChecker().redefine("foo", int).redefine("bar", str),
+        )
+
+    def test_remove_multiple(self):
+        self.assertEqual(
+            TypeChecker({"foo": int, "bar": str}).remove("foo", "bar"),
+            TypeChecker(),
+        )
+
+    def test_type_check_can_raise_key_error(self):
+        """
+        Make sure no one writes:
+
+            try:
+                self._type_checkers[type](...)
+            except KeyError:
+
+        ignoring the fact that the function itself can raise that.
+        """
+
+        error = KeyError("Stuff")
+
+        def raises_keyerror(checker, instance):
+            raise error
+
+        with self.assertRaises(KeyError) as context:
+            TypeChecker({"foo": raises_keyerror}).is_type(4, "foo")
+
+        self.assertIs(context.exception, error)
+
+    def test_repr(self):
+        checker = TypeChecker({"foo": is_namedtuple, "bar": is_namedtuple})
+        self.assertEqual(repr(checker), "<TypeChecker types={'bar', 'foo'}>")
+
+
+class TestCustomTypes(TestCase):
+    def test_simple_type_can_be_extended(self):
+        def int_or_str_int(checker, instance):
+            if not isinstance(instance, (int, str)):
+                return False
+            try:
+                int(instance)
+            except ValueError:
+                return False
+            return True
+
+        CustomValidator = extend(
+            Draft202012Validator,
+            type_checker=Draft202012Validator.TYPE_CHECKER.redefine(
+                "integer", int_or_str_int,
+            ),
+        )
+        validator = CustomValidator({"type": "integer"})
+
+        validator.validate(4)
+        validator.validate("4")
+
+        with self.assertRaises(ValidationError):
+            validator.validate(4.4)
+
+        with self.assertRaises(ValidationError):
+            validator.validate("foo")
+
+    def test_object_can_be_extended(self):
+        schema = {"type": "object"}
+
+        Point = namedtuple("Point", ["x", "y"])
+
+        type_checker = Draft202012Validator.TYPE_CHECKER.redefine(
+            "object", is_object_or_named_tuple,
+        )
+
+        CustomValidator = extend(
+            Draft202012Validator,
+            type_checker=type_checker,
+        )
+        validator = CustomValidator(schema)
+
+        validator.validate(Point(x=4, y=5))
+
+    def test_object_extensions_require_custom_validators(self):
+        schema = {"type": "object", "required": ["x"]}
+
+        type_checker = Draft202012Validator.TYPE_CHECKER.redefine(
+            "object", is_object_or_named_tuple,
+        )
+
+        CustomValidator = extend(
+            Draft202012Validator,
+            type_checker=type_checker,
+        )
+        validator = CustomValidator(schema)
+
+        Point = namedtuple("Point", ["x", "y"])
+        # Cannot handle required
+        with self.assertRaises(ValidationError):
+            validator.validate(Point(x=4, y=5))
+
+    def test_object_extensions_can_handle_custom_validators(self):
+        schema = {
+            "type": "object",
+            "required": ["x"],
+            "properties": {"x": {"type": "integer"}},
+        }
+
+        type_checker = Draft202012Validator.TYPE_CHECKER.redefine(
+            "object", is_object_or_named_tuple,
+        )
+
+        def coerce_named_tuple(fn):
+            def coerced(validator, value, instance, schema):
+                if is_namedtuple(instance):
+                    instance = instance._asdict()
+                return fn(validator, value, instance, schema)
+            return coerced
+
+        required = coerce_named_tuple(_keywords.required)
+        properties = coerce_named_tuple(_keywords.properties)
+
+        CustomValidator = extend(
+            Draft202012Validator,
+            type_checker=type_checker,
+            validators={"required": required, "properties": properties},
+        )
+
+        validator = CustomValidator(schema)
+
+        Point = namedtuple("Point", ["x", "y"])
+        # Can now process required and properties
+        validator.validate(Point(x=4, y=5))
+
+        with self.assertRaises(ValidationError):
+            validator.validate(Point(x="not an integer", y=5))
+
+        # As well as still handle objects.
+        validator.validate({"x": 4, "y": 5})
+
+        with self.assertRaises(ValidationError):
+            validator.validate({"x": "not an integer", "y": 5})
+
+    def test_unknown_type(self):
+        with self.assertRaises(UnknownType) as e:
+            Draft202012Validator({}).is_type(12, "some unknown type")
+        self.assertIn("'some unknown type'", str(e.exception))
diff --git a/llm/Lib/site-packages/jsonschema/tests/test_utils.py b/llm/Lib/site-packages/jsonschema/tests/test_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..4e542b9628d2572c3f43da40c46b2a0b13ac7421
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/tests/test_utils.py
@@ -0,0 +1,124 @@
+from unittest import TestCase
+
+from jsonschema._utils import equal
+
+
+class TestEqual(TestCase):
+    def test_none(self):
+        self.assertTrue(equal(None, None))
+
+
+class TestDictEqual(TestCase):
+    def test_equal_dictionaries(self):
+        dict_1 = {"a": "b", "c": "d"}
+        dict_2 = {"c": "d", "a": "b"}
+        self.assertTrue(equal(dict_1, dict_2))
+
+    def test_missing_key(self):
+        dict_1 = {"a": "b", "c": "d"}
+        dict_2 = {"c": "d", "x": "b"}
+        self.assertFalse(equal(dict_1, dict_2))
+
+    def test_additional_key(self):
+        dict_1 = {"a": "b", "c": "d"}
+        dict_2 = {"c": "d", "a": "b", "x": "x"}
+        self.assertFalse(equal(dict_1, dict_2))
+
+    def test_missing_value(self):
+        dict_1 = {"a": "b", "c": "d"}
+        dict_2 = {"c": "d", "a": "x"}
+        self.assertFalse(equal(dict_1, dict_2))
+
+    def test_empty_dictionaries(self):
+        dict_1 = {}
+        dict_2 = {}
+        self.assertTrue(equal(dict_1, dict_2))
+
+    def test_one_none(self):
+        dict_1 = None
+        dict_2 = {"a": "b", "c": "d"}
+        self.assertFalse(equal(dict_1, dict_2))
+
+    def test_same_item(self):
+        dict_1 = {"a": "b", "c": "d"}
+        self.assertTrue(equal(dict_1, dict_1))
+
+    def test_nested_equal(self):
+        dict_1 = {"a": {"a": "b", "c": "d"}, "c": "d"}
+        dict_2 = {"c": "d", "a": {"a": "b", "c": "d"}}
+        self.assertTrue(equal(dict_1, dict_2))
+
+    def test_nested_dict_unequal(self):
+        dict_1 = {"a": {"a": "b", "c": "d"}, "c": "d"}
+        dict_2 = {"c": "d", "a": {"a": "b", "c": "x"}}
+        self.assertFalse(equal(dict_1, dict_2))
+
+    def test_mixed_nested_equal(self):
+        dict_1 = {"a": ["a", "b", "c", "d"], "c": "d"}
+        dict_2 = {"c": "d", "a": ["a", "b", "c", "d"]}
+        self.assertTrue(equal(dict_1, dict_2))
+
+    def test_nested_list_unequal(self):
+        dict_1 = {"a": ["a", "b", "c", "d"], "c": "d"}
+        dict_2 = {"c": "d", "a": ["b", "c", "d", "a"]}
+        self.assertFalse(equal(dict_1, dict_2))
+
+
+class TestListEqual(TestCase):
+    def test_equal_lists(self):
+        list_1 = ["a", "b", "c"]
+        list_2 = ["a", "b", "c"]
+        self.assertTrue(equal(list_1, list_2))
+
+    def test_unsorted_lists(self):
+        list_1 = ["a", "b", "c"]
+        list_2 = ["b", "b", "a"]
+        self.assertFalse(equal(list_1, list_2))
+
+    def test_first_list_larger(self):
+        list_1 = ["a", "b", "c"]
+        list_2 = ["a", "b"]
+        self.assertFalse(equal(list_1, list_2))
+
+    def test_second_list_larger(self):
+        list_1 = ["a", "b"]
+        list_2 = ["a", "b", "c"]
+        self.assertFalse(equal(list_1, list_2))
+
+    def test_list_with_none_unequal(self):
+        list_1 = ["a", "b", None]
+        list_2 = ["a", "b", "c"]
+        self.assertFalse(equal(list_1, list_2))
+
+        list_1 = ["a", "b", None]
+        list_2 = [None, "b", "c"]
+        self.assertFalse(equal(list_1, list_2))
+
+    def test_list_with_none_equal(self):
+        list_1 = ["a", None, "c"]
+        list_2 = ["a", None, "c"]
+        self.assertTrue(equal(list_1, list_2))
+
+    def test_empty_list(self):
+        list_1 = []
+        list_2 = []
+        self.assertTrue(equal(list_1, list_2))
+
+    def test_one_none(self):
+        list_1 = None
+        list_2 = []
+        self.assertFalse(equal(list_1, list_2))
+
+    def test_same_list(self):
+        list_1 = ["a", "b", "c"]
+        self.assertTrue(equal(list_1, list_1))
+
+    def test_equal_nested_lists(self):
+        list_1 = ["a", ["b", "c"], "d"]
+        list_2 = ["a", ["b", "c"], "d"]
+        self.assertTrue(equal(list_1, list_2))
+
+    def test_unequal_nested_lists(self):
+        list_1 = ["a", ["b", "c"], "d"]
+        list_2 = ["a", [], "c"]
+        self.assertFalse(equal(list_1, list_2))
diff --git a/llm/Lib/site-packages/jsonschema/tests/test_validators.py b/llm/Lib/site-packages/jsonschema/tests/test_validators.py
new file mode 100644
index 0000000000000000000000000000000000000000..28cc4027372c10df1d071eb656102b3b81bc5ecc
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/tests/test_validators.py
@@ -0,0 +1,2575 @@
+from __future__ import annotations
+
+from collections import deque, namedtuple
+from contextlib import contextmanager
+from decimal import Decimal
+from io import BytesIO
+from typing import Any
+from unittest import TestCase, mock
+from urllib.request import pathname2url
+import json
+import os
+import sys
+import tempfile
+import warnings
+
+from attrs import define, field
+from referencing.jsonschema import DRAFT202012
+import referencing.exceptions
+
+from jsonschema import (
+    FormatChecker,
+    TypeChecker,
+    exceptions,
+    protocols,
+    validators,
+)
+
+
+def fail(validator, errors, instance, schema):
+    for each in errors:
+        each.setdefault("message", "You told me to fail!")
+        yield exceptions.ValidationError(**each)
+
+
+class TestCreateAndExtend(TestCase):
+    def setUp(self):
+        self.addCleanup(
+            self.assertEqual,
+            validators._META_SCHEMAS,
+            dict(validators._META_SCHEMAS),
+        )
+        self.addCleanup(
+            self.assertEqual,
+            validators._VALIDATORS,
+            dict(validators._VALIDATORS),
+        )
+
+        self.meta_schema = {"$id": "some://meta/schema"}
+        self.validators = {"fail": fail}
+        self.type_checker = TypeChecker()
+        self.Validator = validators.create(
+            meta_schema=self.meta_schema,
+            validators=self.validators,
+            type_checker=self.type_checker,
+        )
+
+    def test_attrs(self):
+        self.assertEqual(
+            (
+                self.Validator.VALIDATORS,
+                self.Validator.META_SCHEMA,
+                self.Validator.TYPE_CHECKER,
+            ), (
+                self.validators,
+                self.meta_schema,
+                self.type_checker,
+            ),
+        )
+
+    def test_init(self):
+        schema = {"fail": []}
+        self.assertEqual(self.Validator(schema).schema, schema)
+
+    def test_iter_errors_successful(self):
+        schema = {"fail": []}
+        validator = self.Validator(schema)
+
+        errors = list(validator.iter_errors("hello"))
+        self.assertEqual(errors, [])
+
+    def test_iter_errors_one_error(self):
+        schema = {"fail": [{"message": "Whoops!"}]}
+        validator = self.Validator(schema)
+
+        expected_error = exceptions.ValidationError(
+            "Whoops!",
+            instance="goodbye",
+            schema=schema,
+            validator="fail",
+            validator_value=[{"message": "Whoops!"}],
+            schema_path=deque(["fail"]),
+        )
+
+        errors = list(validator.iter_errors("goodbye"))
+        self.assertEqual(len(errors), 1)
+        self.assertEqual(errors[0]._contents(), expected_error._contents())
+
+    def test_iter_errors_multiple_errors(self):
+        schema = {
+            "fail": [
+                {"message": "First"},
+                {"message": "Second!", "validator": "asdf"},
+                {"message": "Third"},
+            ],
+        }
+        validator = self.Validator(schema)
+
+        errors = list(validator.iter_errors("goodbye"))
+        self.assertEqual(len(errors), 3)
+
+    def test_if_a_version_is_provided_it_is_registered(self):
+        Validator = validators.create(
+            meta_schema={"$id": "something"},
+            version="my version",
+        )
+        self.addCleanup(validators._META_SCHEMAS.pop, "something")
+        self.addCleanup(validators._VALIDATORS.pop, "my version")
+        self.assertEqual(Validator.__name__, "MyVersionValidator")
+        self.assertEqual(Validator.__qualname__, "MyVersionValidator")
+
+    def test_repr(self):
+        Validator = validators.create(
+            meta_schema={"$id": "something"},
+            version="my version",
+        )
+        self.addCleanup(validators._META_SCHEMAS.pop, "something")
+        self.addCleanup(validators._VALIDATORS.pop, "my version")
+        self.assertEqual(
+            repr(Validator({})),
+            "MyVersionValidator(schema={}, format_checker=None)",
+        )
+
+    def test_long_repr(self):
+        Validator = validators.create(
+            meta_schema={"$id": "something"},
+            version="my version",
+        )
+        self.addCleanup(validators._META_SCHEMAS.pop, "something")
+        self.addCleanup(validators._VALIDATORS.pop, "my version")
+        self.assertEqual(
+            repr(Validator({"a": list(range(1000))})), (
+                "MyVersionValidator(schema={'a': [0, 1, 2, 3, 4, 5, ...]}, "
+                "format_checker=None)"
+            ),
+        )
+
+    def test_repr_no_version(self):
+        Validator = validators.create(meta_schema={})
+        self.assertEqual(
+            repr(Validator({})),
+            "Validator(schema={}, format_checker=None)",
+        )
+
+    def test_dashes_are_stripped_from_validator_names(self):
+        Validator = validators.create(
+            meta_schema={"$id": "something"},
+            version="foo-bar",
+        )
+        self.addCleanup(validators._META_SCHEMAS.pop, "something")
+        self.addCleanup(validators._VALIDATORS.pop, "foo-bar")
+        self.assertEqual(Validator.__qualname__, "FooBarValidator")
+
+    def test_if_a_version_is_not_provided_it_is_not_registered(self):
+        original = dict(validators._META_SCHEMAS)
+        validators.create(meta_schema={"id": "id"})
+        self.assertEqual(validators._META_SCHEMAS, original)
+
+    def test_validates_registers_meta_schema_id(self):
+        meta_schema_key = "meta schema id"
+        my_meta_schema = {"id": meta_schema_key}
+
+        validators.create(
+            meta_schema=my_meta_schema,
+            version="my version",
+            id_of=lambda s: s.get("id", ""),
+        )
+        self.addCleanup(validators._META_SCHEMAS.pop, meta_schema_key)
+        self.addCleanup(validators._VALIDATORS.pop, "my version")
+
+        self.assertIn(meta_schema_key, validators._META_SCHEMAS)
+
+    def test_validates_registers_meta_schema_draft6_id(self):
+        meta_schema_key = "meta schema $id"
+        my_meta_schema = {"$id": meta_schema_key}
+
+        validators.create(
+            meta_schema=my_meta_schema,
+            version="my version",
+        )
+        self.addCleanup(validators._META_SCHEMAS.pop, meta_schema_key)
+        self.addCleanup(validators._VALIDATORS.pop, "my version")
+
+        self.assertIn(meta_schema_key, validators._META_SCHEMAS)
+
+    def test_create_default_types(self):
+        Validator = validators.create(meta_schema={}, validators=())
+        self.assertTrue(
+            all(
+                Validator({}).is_type(instance=instance, type=type)
+                for type, instance in [
+                    ("array", []),
+                    ("boolean", True),
+                    ("integer", 12),
+                    ("null", None),
+                    ("number", 12.0),
+                    ("object", {}),
+                    ("string", "foo"),
+                ]
+            ),
+        )
+
+    def test_check_schema_with_different_metaschema(self):
+        """
+        One can create a validator class whose metaschema uses a different
+        dialect than itself.
+        """
+
+        NoEmptySchemasValidator = validators.create(
+            meta_schema={
+                "$schema": validators.Draft202012Validator.META_SCHEMA["$id"],
+                "not": {"const": {}},
+            },
+        )
+        NoEmptySchemasValidator.check_schema({"foo": "bar"})
+
+        with self.assertRaises(exceptions.SchemaError):
+            NoEmptySchemasValidator.check_schema({})
+
+        NoEmptySchemasValidator({"foo": "bar"}).validate("foo")
+
+    def test_check_schema_with_different_metaschema_defaults_to_self(self):
+        """
+        A validator whose metaschema doesn't declare $schema defaults to its
+        own validation behavior, not the latest "normal" specification.
+        """
+
+        NoEmptySchemasValidator = validators.create(
+            meta_schema={"fail": [{"message": "Meta schema whoops!"}]},
+            validators={"fail": fail},
+        )
+        with self.assertRaises(exceptions.SchemaError):
+            NoEmptySchemasValidator.check_schema({})
+
+    def test_extend(self):
+        original = dict(self.Validator.VALIDATORS)
+        new = object()
+
+        Extended = validators.extend(
+            self.Validator,
+            validators={"new": new},
+        )
+        self.assertEqual(
+            (
+                Extended.VALIDATORS,
+                Extended.META_SCHEMA,
+                Extended.TYPE_CHECKER,
+                self.Validator.VALIDATORS,
+            ), (
+                dict(original, new=new),
+                self.Validator.META_SCHEMA,
+                self.Validator.TYPE_CHECKER,
+                original,
+            ),
+        )
+
+    def test_extend_idof(self):
+        """
+        Extending a validator preserves its notion of schema IDs.
+        """
+        def id_of(schema):
+            return schema.get("__test__", self.Validator.ID_OF(schema))
+        correct_id = "the://correct/id/"
+        meta_schema = {
+            "$id": "the://wrong/id/",
+            "__test__": correct_id,
+        }
+        Original = validators.create(
+            meta_schema=meta_schema,
+            validators=self.validators,
+            type_checker=self.type_checker,
+            id_of=id_of,
+        )
+        self.assertEqual(Original.ID_OF(Original.META_SCHEMA), correct_id)
+
+        Derived = validators.extend(Original)
+        self.assertEqual(Derived.ID_OF(Derived.META_SCHEMA), correct_id)
+
+    def test_extend_applicable_validators(self):
+        """
+        Extending a validator preserves its notion of applicable validators.
+        """
+
+        schema = {
+            "$defs": {"test": {"type": "number"}},
+            "$ref": "#/$defs/test",
+            "maximum": 1,
+        }
+
+        draft4 = validators.Draft4Validator(schema)
+        self.assertTrue(draft4.is_valid(37))  # as $ref ignores siblings
+
+        Derived = validators.extend(validators.Draft4Validator)
+        self.assertTrue(Derived(schema).is_valid(37))
+
+
+class TestValidationErrorMessages(TestCase):
+    def message_for(self, instance, schema, *args, **kwargs):
+        cls = kwargs.pop("cls", validators._LATEST_VERSION)
+        cls.check_schema(schema)
+        validator = cls(schema, *args, **kwargs)
+        errors = list(validator.iter_errors(instance))
+        self.assertTrue(errors, msg=f"No errors were raised for {instance!r}")
+        self.assertEqual(
+            len(errors),
+            1,
+            msg=f"Expected exactly one error, found {errors!r}",
+        )
+        return errors[0].message
+
+    def test_single_type_failure(self):
+        message = self.message_for(instance=1, schema={"type": "string"})
+        self.assertEqual(message, "1 is not of type 'string'")
+
+    def test_single_type_list_failure(self):
+        message = self.message_for(instance=1, schema={"type": ["string"]})
+        self.assertEqual(message, "1 is not of type 'string'")
+
+    def test_multiple_type_failure(self):
+        types = "string", "object"
+        message = self.message_for(instance=1, schema={"type": list(types)})
+        self.assertEqual(message, "1 is not of type 'string', 'object'")
+
+    def test_object_with_named_type_failure(self):
+        schema = {"type": [{"name": "Foo", "minimum": 3}]}
+        message = self.message_for(
+            instance=1,
+            schema=schema,
+            cls=validators.Draft3Validator,
+        )
+        self.assertEqual(message, "1 is not of type 'Foo'")
+
+    def test_minimum(self):
+        message = self.message_for(instance=1, schema={"minimum": 2})
+        self.assertEqual(message, "1 is less than the minimum of 2")
+
+    def test_maximum(self):
+        message = self.message_for(instance=1, schema={"maximum": 0})
+        self.assertEqual(message, "1 is greater than the maximum of 0")
+
+    def test_dependencies_single_element(self):
+        depend, on = "bar", "foo"
+        schema = {"dependencies": {depend: on}}
+        message = self.message_for(
+            instance={"bar": 2},
+            schema=schema,
+            cls=validators.Draft3Validator,
+        )
+        self.assertEqual(message, "'foo' is a dependency of 'bar'")
+
+    def test_object_without_title_type_failure_draft3(self):
+        type = {"type": [{"minimum": 3}]}
+        message = self.message_for(
+            instance=1,
+            schema={"type": [type]},
+            cls=validators.Draft3Validator,
+        )
+        self.assertEqual(
+            message,
+            "1 is not of type {'type': [{'minimum': 3}]}",
+        )
+
+    def test_dependencies_list_draft3(self):
+        depend, on = "bar", "foo"
+        schema = {"dependencies": {depend: [on]}}
+        message = self.message_for(
+            instance={"bar": 2},
+            schema=schema,
+            cls=validators.Draft3Validator,
+        )
+        self.assertEqual(message, "'foo' is a dependency of 'bar'")
+
+    def test_dependencies_list_draft7(self):
+        depend, on = "bar", "foo"
+        schema = {"dependencies": {depend: [on]}}
+        message = self.message_for(
+            instance={"bar": 2},
+            schema=schema,
+            cls=validators.Draft7Validator,
+        )
+        self.assertEqual(message, "'foo' is a dependency of 'bar'")
+
+    def test_additionalItems_single_failure(self):
+        message = self.message_for(
+            instance=[2],
+            schema={"items": [], "additionalItems": False},
+            cls=validators.Draft3Validator,
+        )
+        self.assertIn("(2 was unexpected)", message)
+
+    def test_additionalItems_multiple_failures(self):
+        message = self.message_for(
+            instance=[1, 2, 3],
+            schema={"items": [], "additionalItems": False},
+            cls=validators.Draft3Validator,
+        )
+        self.assertIn("(1, 2, 3 were unexpected)", message)
+
+    def test_additionalProperties_single_failure(self):
+        additional = "foo"
+        schema = {"additionalProperties": False}
+        message = self.message_for(instance={additional: 2}, schema=schema)
+        self.assertIn("('foo' was unexpected)", message)
+
+    def test_additionalProperties_multiple_failures(self):
+        schema = {"additionalProperties": False}
+        message = self.message_for(
+            instance=dict.fromkeys(["foo", "bar"]),
+            schema=schema,
+        )
+
+        self.assertIn(repr("foo"), message)
+        self.assertIn(repr("bar"), message)
+        self.assertIn("were unexpected)", message)
+
+    def test_const(self):
+        schema = {"const": 12}
+        message = self.message_for(
+            instance={"foo": "bar"},
+            schema=schema,
+        )
+        self.assertIn("12 was expected", message)
+
+    def test_contains_draft_6(self):
+        schema = {"contains": {"const": 12}}
+        message = self.message_for(
+            instance=[2, {}, []],
+            schema=schema,
+            cls=validators.Draft6Validator,
+        )
+        self.assertEqual(
+            message,
+            "None of [2, {}, []] are valid under the given schema",
+        )
+
+    def test_invalid_format_default_message(self):
+        checker = FormatChecker(formats=())
+        checker.checks("thing")(lambda value: False)
+
+        schema = {"format": "thing"}
+        message = self.message_for(
+            instance="bla",
+            schema=schema,
+            format_checker=checker,
+        )
+
+        self.assertIn(repr("bla"), message)
+        self.assertIn(repr("thing"), message)
+        self.assertIn("is not a", message)
+
+    def test_additionalProperties_false_patternProperties(self):
+        schema = {"type": "object",
+                  "additionalProperties": False,
+                  "patternProperties": {
+                      "^abc$": {"type": "string"},
+                      "^def$": {"type": "string"},
+                  }}
+        message = self.message_for(
+            instance={"zebra": 123},
+            schema=schema,
+            cls=validators.Draft4Validator,
+        )
+        self.assertEqual(
+            message,
+            "{} does not match any of the regexes: {}, {}".format(
+                repr("zebra"), repr("^abc$"), repr("^def$"),
+            ),
+        )
+        message = self.message_for(
+            instance={"zebra": 123, "fish": 456},
+            schema=schema,
+            cls=validators.Draft4Validator,
+        )
+        self.assertEqual(
+            message,
+            "{}, {} do not match any of the regexes: {}, {}".format(
+                repr("fish"), repr("zebra"), repr("^abc$"), repr("^def$"),
+            ),
+        )
+
+    def test_False_schema(self):
+        message = self.message_for(
+            instance="something",
+            schema=False,
+        )
+        self.assertEqual(message, "False schema does not allow 'something'")
+
+    def test_multipleOf(self):
+        message = self.message_for(
+            instance=3,
+            schema={"multipleOf": 2},
+        )
+        self.assertEqual(message, "3 is not a multiple of 2")
+
+    def test_minItems(self):
+        message = self.message_for(instance=[], schema={"minItems": 2})
+        self.assertEqual(message, "[] is too short")
+
+    def test_maxItems(self):
+        message = self.message_for(instance=[1, 2, 3], schema={"maxItems": 2})
+        self.assertEqual(message, "[1, 2, 3] is too long")
+
+    def test_minItems_1(self):
+        message = self.message_for(instance=[], schema={"minItems": 1})
+        self.assertEqual(message, "[] should be non-empty")
+
+    def test_maxItems_0(self):
+        message = self.message_for(instance=[1, 2, 3], schema={"maxItems": 0})
+        self.assertEqual(message, "[1, 2, 3] is expected to be empty")
+
+    def test_minLength(self):
+        message = self.message_for(
+            instance="",
+            schema={"minLength": 2},
+        )
+        self.assertEqual(message, "'' is too short")
+
+    def test_maxLength(self):
+        message = self.message_for(
+            instance="abc",
+            schema={"maxLength": 2},
+        )
+        self.assertEqual(message, "'abc' is too long")
+
+    def test_minLength_1(self):
+        message = self.message_for(instance="", schema={"minLength": 1})
+        self.assertEqual(message, "'' should be non-empty")
+
+    def test_maxLength_0(self):
+        message = self.message_for(instance="abc", schema={"maxLength": 0})
+        self.assertEqual(message, "'abc' is expected to be empty")
+
+    def test_minProperties(self):
+        message = self.message_for(instance={}, schema={"minProperties": 2})
+        self.assertEqual(message, "{} does not have enough properties")
+
+    def test_maxProperties(self):
+        message = self.message_for(
+            instance={"a": {}, "b": {}, "c": {}},
+            schema={"maxProperties": 2},
+        )
+        self.assertEqual(
+            message,
+            "{'a': {}, 'b': {}, 'c': {}} has too many properties",
+        )
+
+    def test_minProperties_1(self):
+        message = self.message_for(instance={}, schema={"minProperties": 1})
+        self.assertEqual(message, "{} should be non-empty")
+
+    def test_maxProperties_0(self):
+        message = self.message_for(
+            instance={1: 2},
+            schema={"maxProperties": 0},
+        )
+        self.assertEqual(message, "{1: 2} is expected to be empty")
+
+    def test_prefixItems_with_items(self):
+        message = self.message_for(
+            instance=[1, 2, "foo"],
+            schema={"items": False, "prefixItems": [{}, {}]},
+        )
+        self.assertEqual(
+            message,
+            "Expected at most 2 items but found 1 extra: 'foo'",
+        )
+
+    def test_prefixItems_with_multiple_extra_items(self):
+        message = self.message_for(
+            instance=[1, 2, "foo", 5],
+            schema={"items": False, "prefixItems": [{}, {}]},
+        )
+        self.assertEqual(
+            message,
+            "Expected at most 2 items but found 2 extra: ['foo', 5]",
+        )
+
+    def test_pattern(self):
+        message = self.message_for(
+            instance="bbb",
+            schema={"pattern": "^a*$"},
+        )
+        self.assertEqual(message, "'bbb' does not match '^a*$'")
+
+    def test_does_not_contain(self):
+        message = self.message_for(
+            instance=[],
+            schema={"contains": {"type": "string"}},
+        )
+        self.assertEqual(
+            message,
+            "[] does not contain items matching the given schema",
+        )
+
+    def test_contains_too_few(self):
+        message = self.message_for(
+            instance=["foo", 1],
+            schema={"contains": {"type": "string"}, "minContains": 2},
+        )
+        self.assertEqual(
+            message,
+            "Too few items match the given schema "
+            "(expected at least 2 but only 1 matched)",
+        )
+
+    def test_contains_too_few_both_constrained(self):
+        message = self.message_for(
+            instance=["foo", 1],
+            schema={
+                "contains": {"type": "string"},
+                "minContains": 2,
+                "maxContains": 4,
+            },
+        )
+        self.assertEqual(
+            message,
+            "Too few items match the given schema (expected at least 2 but "
+            "only 1 matched)",
+        )
+
+    def test_contains_too_many(self):
+        message = self.message_for(
+            instance=["foo", "bar", "baz"],
+            schema={"contains": {"type": "string"}, "maxContains": 2},
+        )
+        self.assertEqual(
+            message,
+            "Too many items match the given schema (expected at most 2)",
+        )
+
+    def test_contains_too_many_both_constrained(self):
+        message = self.message_for(
+            instance=["foo"] * 5,
+            schema={
+                "contains": {"type": "string"},
+                "minContains": 2,
+                "maxContains": 4,
+            },
+        )
+        self.assertEqual(
+            message,
+            "Too many items match the given schema (expected at most 4)",
+        )
+
+    def test_exclusiveMinimum(self):
+        message = self.message_for(
+            instance=3,
+            schema={"exclusiveMinimum": 5},
+        )
+        self.assertEqual(
+            message,
+            "3 is less than or equal to the minimum of 5",
+        )
+
+    def test_exclusiveMaximum(self):
+        message = self.message_for(instance=3, schema={"exclusiveMaximum": 2})
+        self.assertEqual(
+            message,
+            "3 is greater than or equal to the maximum of 2",
+        )
+
+    def test_required(self):
+        message = self.message_for(instance={}, schema={"required": ["foo"]})
+        self.assertEqual(message, "'foo' is a required property")
+
+    def test_dependentRequired(self):
+        message = self.message_for(
+            instance={"foo": {}},
+            schema={"dependentRequired": {"foo": ["bar"]}},
+        )
+        self.assertEqual(message, "'bar' is a dependency of 'foo'")
+
+    def test_oneOf_matches_none(self):
+        message = self.message_for(instance={}, schema={"oneOf": [False]})
+        self.assertEqual(
+            message,
+            "{} is not valid under any of the given schemas",
+        )
+
+    def test_oneOf_matches_too_many(self):
+        message = self.message_for(instance={}, schema={"oneOf": [True, True]})
+        self.assertEqual(message, "{} is valid under each of True, True")
+
+    def test_unevaluated_items(self):
+        schema = {"type": "array", "unevaluatedItems": False}
+        message = self.message_for(instance=["foo", "bar"], schema=schema)
+        self.assertIn(
+            message,
+            "Unevaluated items are not allowed ('foo', 'bar' were unexpected)",
+        )
+
+    def test_unevaluated_items_on_invalid_type(self):
+        schema = {"type": "array", "unevaluatedItems": False}
+        message = self.message_for(instance="foo", schema=schema)
+        self.assertEqual(message, "'foo' is not of type 'array'")
+
+    def test_unevaluated_properties_invalid_against_subschema(self):
+        schema = {
+            "properties": {"foo": {"type": "string"}},
+            "unevaluatedProperties": {"const": 12},
+        }
+        message = self.message_for(
+            instance={
+                "foo": "foo",
+                "bar": "bar",
+                "baz": 12,
+            },
+            schema=schema,
+        )
+        self.assertEqual(
+            message,
+            "Unevaluated properties are not valid under the given schema "
+            "('bar' was unevaluated and invalid)",
+        )
+
+    def test_unevaluated_properties_disallowed(self):
+        schema = {"type": "object", "unevaluatedProperties": False}
+        message = self.message_for(
+            instance={
+                "foo": "foo",
+                "bar": "bar",
+            },
+            schema=schema,
+        )
+        self.assertEqual(
+            message,
+            "Unevaluated properties are not allowed "
+            "('bar', 'foo' were unexpected)",
+        )
+
+    def test_unevaluated_properties_on_invalid_type(self):
+        schema = {"type": "object", "unevaluatedProperties": False}
+        message = self.message_for(instance="foo", schema=schema)
+        self.assertEqual(message, "'foo' is not of type 'object'")
+
+    def test_single_item(self):
+        schema = {"prefixItems": [{}], "items": False}
+        message = self.message_for(
+            instance=["foo", "bar", "baz"],
+            schema=schema,
+        )
+        self.assertEqual(
+            message,
+            "Expected at most 1 item but found 2 extra: ['bar', 'baz']",
+        )
+
+    def test_heterogeneous_additionalItems_with_Items(self):
+        schema = {"items": [{}], "additionalItems": False}
+        message = self.message_for(
+            instance=["foo", "bar", 37],
+            schema=schema,
+            cls=validators.Draft7Validator,
+        )
+        self.assertEqual(
+            message,
+            "Additional items are not allowed ('bar', 37 were unexpected)",
+        )
+
+    def test_heterogeneous_items_prefixItems(self):
+        schema = {"prefixItems": [{}], "items": False}
+        message = self.message_for(
+            instance=["foo", "bar", 37],
+            schema=schema,
+        )
+        self.assertEqual(
+            message,
+            "Expected at most 1 item but found 2 extra: ['bar', 37]",
+        )
+
+    def test_heterogeneous_unevaluatedItems_prefixItems(self):
+        schema = {"prefixItems": [{}], "unevaluatedItems": False}
+        message = self.message_for(
+            instance=["foo", "bar", 37],
+            schema=schema,
+        )
+        self.assertEqual(
+            message,
+            "Unevaluated items are not allowed ('bar', 37 were unexpected)",
+        )
+
+    def test_heterogeneous_properties_additionalProperties(self):
+        """
+        Not valid deserialized JSON, but this should not blow up.
+        """
+        schema = {"properties": {"foo": {}}, "additionalProperties": False}
+        message = self.message_for(
+            instance={"foo": {}, "a": "baz", 37: 12},
+            schema=schema,
+        )
+        self.assertEqual(
+            message,
+            "Additional properties are not allowed (37, 'a' were unexpected)",
+        )
+
+    def test_heterogeneous_properties_unevaluatedProperties(self):
+        """
+        Not valid deserialized JSON, but this should not blow up.
+        """
+        schema = {"properties": {"foo": {}}, "unevaluatedProperties": False}
+        message = self.message_for(
+            instance={"foo": {}, "a": "baz", 37: 12},
+            schema=schema,
+        )
+        self.assertEqual(
+            message,
+            "Unevaluated properties are not allowed (37, 'a' were unexpected)",
+        )
+
+
+class TestValidationErrorDetails(TestCase):
+    # TODO: These really need unit tests for each individual keyword, rather
+    #       than just these higher level tests.
+    def test_anyOf(self):
+        instance = 5
+        schema = {
+            "anyOf": [
+                {"minimum": 20},
+                {"type": "string"},
+            ],
+        }
+
+        validator = validators.Draft4Validator(schema)
+        errors = list(validator.iter_errors(instance))
+        self.assertEqual(len(errors), 1)
+        e = errors[0]
+
+        self.assertEqual(e.validator, "anyOf")
+        self.assertEqual(e.validator_value, schema["anyOf"])
+        self.assertEqual(e.instance, instance)
+        self.assertEqual(e.schema, schema)
+        self.assertIsNone(e.parent)
+
+        self.assertEqual(e.path, deque([]))
+        self.assertEqual(e.relative_path, deque([]))
+        self.assertEqual(e.absolute_path, deque([]))
+        self.assertEqual(e.json_path, "$")
+
+        self.assertEqual(e.schema_path, deque(["anyOf"]))
+        self.assertEqual(e.relative_schema_path, deque(["anyOf"]))
+        self.assertEqual(e.absolute_schema_path, deque(["anyOf"]))
+
+        self.assertEqual(len(e.context), 2)
+
+        e1, e2 = sorted_errors(e.context)
+
+        self.assertEqual(e1.validator, "minimum")
+        self.assertEqual(e1.validator_value, schema["anyOf"][0]["minimum"])
+        self.assertEqual(e1.instance, instance)
+        self.assertEqual(e1.schema, schema["anyOf"][0])
+        self.assertIs(e1.parent, e)
+
+        self.assertEqual(e1.path, deque([]))
+        self.assertEqual(e1.absolute_path, deque([]))
+        self.assertEqual(e1.relative_path, deque([]))
+        self.assertEqual(e1.json_path, "$")
+
+        self.assertEqual(e1.schema_path, deque([0, "minimum"]))
+        self.assertEqual(e1.relative_schema_path, deque([0, "minimum"]))
+        self.assertEqual(
+            e1.absolute_schema_path, deque(["anyOf", 0, "minimum"]),
+        )
+
+        self.assertFalse(e1.context)
+
+        self.assertEqual(e2.validator, "type")
+        self.assertEqual(e2.validator_value, schema["anyOf"][1]["type"])
+        self.assertEqual(e2.instance, instance)
+        self.assertEqual(e2.schema, schema["anyOf"][1])
+        self.assertIs(e2.parent, e)
+
+        self.assertEqual(e2.path, deque([]))
+        self.assertEqual(e2.relative_path, deque([]))
+        self.assertEqual(e2.absolute_path, deque([]))
+        self.assertEqual(e2.json_path, "$")
+
+        self.assertEqual(e2.schema_path, deque([1, "type"]))
+        self.assertEqual(e2.relative_schema_path, deque([1, "type"]))
+        self.assertEqual(e2.absolute_schema_path, deque(["anyOf", 1, "type"]))
+
+        self.assertEqual(len(e2.context), 0)
+
+    def test_type(self):
+        instance = {"foo": 1}
+        schema = {
+            "type": [
+                {"type": "integer"},
+                {
+                    "type": "object",
+                    "properties": {"foo": {"enum": [2]}},
+                },
+            ],
+        }
+
+        validator = validators.Draft3Validator(schema)
+        errors = list(validator.iter_errors(instance))
+        self.assertEqual(len(errors), 1)
+        e = errors[0]
+
+        self.assertEqual(e.validator, "type")
+        self.assertEqual(e.validator_value, schema["type"])
+        self.assertEqual(e.instance, instance)
+        self.assertEqual(e.schema, schema)
+        self.assertIsNone(e.parent)
+
+        self.assertEqual(e.path, deque([]))
+        self.assertEqual(e.relative_path, deque([]))
+        self.assertEqual(e.absolute_path, deque([]))
+        self.assertEqual(e.json_path, "$")
+
+        self.assertEqual(e.schema_path, deque(["type"]))
+        self.assertEqual(e.relative_schema_path, deque(["type"]))
+        self.assertEqual(e.absolute_schema_path, deque(["type"]))
+
+        self.assertEqual(len(e.context), 2)
+
+        e1, e2 = sorted_errors(e.context)
+
+        self.assertEqual(e1.validator, "type")
+        self.assertEqual(e1.validator_value, schema["type"][0]["type"])
+        self.assertEqual(e1.instance, instance)
+        self.assertEqual(e1.schema, schema["type"][0])
+        self.assertIs(e1.parent, e)
+
+        self.assertEqual(e1.path, deque([]))
+        self.assertEqual(e1.relative_path, deque([]))
+        self.assertEqual(e1.absolute_path, deque([]))
+        self.assertEqual(e1.json_path, "$")
+
+        self.assertEqual(e1.schema_path, deque([0, "type"]))
+        self.assertEqual(e1.relative_schema_path, deque([0, "type"]))
+        self.assertEqual(e1.absolute_schema_path, deque(["type", 0, "type"]))
+
+        self.assertFalse(e1.context)
+
+        self.assertEqual(e2.validator, "enum")
+        self.assertEqual(e2.validator_value, [2])
+        self.assertEqual(e2.instance, 1)
+        self.assertEqual(e2.schema, {"enum": [2]})
+        self.assertIs(e2.parent, e)
+
+        self.assertEqual(e2.path, deque(["foo"]))
+        self.assertEqual(e2.relative_path, deque(["foo"]))
+        self.assertEqual(e2.absolute_path, deque(["foo"]))
+        self.assertEqual(e2.json_path, "$.foo")
+
+        self.assertEqual(
+            e2.schema_path, deque([1, "properties", "foo", "enum"]),
+        )
+        self.assertEqual(
+            e2.relative_schema_path, deque([1, "properties", "foo", "enum"]),
+        )
+        self.assertEqual(
+            e2.absolute_schema_path,
+            deque(["type", 1, "properties", "foo", "enum"]),
+        )
+
+        self.assertFalse(e2.context)
+
+    def test_single_nesting(self):
+        instance = {"foo": 2, "bar": [1], "baz": 15, "quux": "spam"}
+        schema = {
+            "properties": {
+                "foo": {"type": "string"},
+                "bar": {"minItems": 2},
+                "baz": {"maximum": 10, "enum": [2, 4, 6, 8]},
+            },
+        }
+
+        validator = validators.Draft3Validator(schema)
+        errors = validator.iter_errors(instance)
+        e1, e2, e3, e4 = sorted_errors(errors)
+
+        self.assertEqual(e1.path, deque(["bar"]))
+        self.assertEqual(e2.path, deque(["baz"]))
+        self.assertEqual(e3.path, deque(["baz"]))
+        self.assertEqual(e4.path, deque(["foo"]))
+
+        self.assertEqual(e1.relative_path, deque(["bar"]))
+        self.assertEqual(e2.relative_path, deque(["baz"]))
+        self.assertEqual(e3.relative_path, deque(["baz"]))
+        self.assertEqual(e4.relative_path, deque(["foo"]))
+
+        self.assertEqual(e1.absolute_path, deque(["bar"]))
+        self.assertEqual(e2.absolute_path, deque(["baz"]))
+        self.assertEqual(e3.absolute_path, deque(["baz"]))
+        self.assertEqual(e4.absolute_path, deque(["foo"]))
+
+        self.assertEqual(e1.json_path, "$.bar")
+        self.assertEqual(e2.json_path, "$.baz")
+        self.assertEqual(e3.json_path, "$.baz")
+        self.assertEqual(e4.json_path, "$.foo")
+
+        self.assertEqual(e1.validator, "minItems")
+        self.assertEqual(e2.validator, "enum")
+        self.assertEqual(e3.validator, "maximum")
+        self.assertEqual(e4.validator, "type")
+
+    def test_multiple_nesting(self):
+        instance = [1, {"foo": 2, "bar": {"baz": [1]}}, "quux"]
+        schema = {
+            "type": "string",
+            "items": {
+                "type": ["string", "object"],
+                "properties": {
+                    "foo": {"enum": [1, 3]},
+                    "bar": {
+                        "type": "array",
+                        "properties": {
+                            "bar": {"required": True},
+                            "baz": {"minItems": 2},
+                        },
+                    },
+                },
+            },
+        }
+
+        validator = validators.Draft3Validator(schema)
+        errors = validator.iter_errors(instance)
+        e1, e2, e3, e4, e5, e6 = sorted_errors(errors)
+
+        self.assertEqual(e1.path, deque([]))
+        self.assertEqual(e2.path, deque([0]))
+        self.assertEqual(e3.path, deque([1, "bar"]))
+        self.assertEqual(e4.path, deque([1, "bar", "bar"]))
+        self.assertEqual(e5.path, deque([1, "bar", "baz"]))
+        self.assertEqual(e6.path, deque([1, "foo"]))
+
+        self.assertEqual(e1.json_path, "$")
+        self.assertEqual(e2.json_path, "$[0]")
+        self.assertEqual(e3.json_path, "$[1].bar")
+        self.assertEqual(e4.json_path, "$[1].bar.bar")
+        self.assertEqual(e5.json_path, "$[1].bar.baz")
+        self.assertEqual(e6.json_path, "$[1].foo")
+
+        self.assertEqual(e1.schema_path, deque(["type"]))
+        self.assertEqual(e2.schema_path, deque(["items", "type"]))
+        self.assertEqual(
+            list(e3.schema_path), ["items", "properties", "bar", "type"],
+        )
+        self.assertEqual(
+            list(e4.schema_path),
+            ["items", "properties", "bar", "properties", "bar", "required"],
+        )
+        self.assertEqual(
+            list(e5.schema_path),
+            ["items", "properties", "bar", "properties", "baz", "minItems"],
+        )
+        self.assertEqual(
+            list(e6.schema_path), ["items", "properties", "foo", "enum"],
+        )
+
+        self.assertEqual(e1.validator, "type")
+        self.assertEqual(e2.validator, "type")
+        self.assertEqual(e3.validator, "type")
+        self.assertEqual(e4.validator, "required")
+        self.assertEqual(e5.validator, "minItems")
+        self.assertEqual(e6.validator, "enum")
+
+    def test_recursive(self):
+        schema = {
+            "definitions": {
+                "node": {
+                    "anyOf": [{
+                        "type": "object",
+                        "required": ["name", "children"],
+                        "properties": {
+                            "name": {
+                                "type": "string",
+                            },
+                            "children": {
+                                "type": "object",
+                                "patternProperties": {
+                                    "^.*$": {
+                                        "$ref": "#/definitions/node",
+                                    },
+                                },
+                            },
+                        },
+                    }],
+                },
+            },
+            "type": "object",
+            "required": ["root"],
+            "properties": {"root": {"$ref": "#/definitions/node"}},
+        }
+
+        instance = {
+            "root": {
+                "name": "root",
+                "children": {
+                    "a": {
+                        "name": "a",
+                        "children": {
+                            "ab": {
+                                "name": "ab",
+                                # missing "children"
+                            },
+                        },
+                    },
+                },
+            },
+        }
+        validator = validators.Draft4Validator(schema)
+
+        e, = validator.iter_errors(instance)
+        self.assertEqual(e.absolute_path, deque(["root"]))
+        self.assertEqual(
+            e.absolute_schema_path, deque(["properties", "root", "anyOf"]),
+        )
+        self.assertEqual(e.json_path, "$.root")
+
+        e1, = e.context
+        self.assertEqual(e1.absolute_path, deque(["root", "children", "a"]))
+        self.assertEqual(
+            e1.absolute_schema_path, deque(
+                [
+                    "properties",
+                    "root",
+                    "anyOf",
+                    0,
+                    "properties",
+                    "children",
+                    "patternProperties",
+                    "^.*$",
+                    "anyOf",
+                ],
+            ),
+        )
+        self.assertEqual(e1.json_path, "$.root.children.a")
+
+        e2, = e1.context
+        self.assertEqual(
+            e2.absolute_path, deque(
+                ["root", "children", "a", "children", "ab"],
+            ),
+        )
+        self.assertEqual(
+            e2.absolute_schema_path, deque(
+                [
+                    "properties",
+                    "root",
+                    "anyOf",
+                    0,
+                    "properties",
+                    "children",
+                    "patternProperties",
+                    "^.*$",
+                    "anyOf",
+                    0,
+                    "properties",
+                    "children",
+                    "patternProperties",
+                    "^.*$",
+                    "anyOf",
+                ],
+            ),
+        )
+        self.assertEqual(e2.json_path, "$.root.children.a.children.ab")
+
+    def test_additionalProperties(self):
+        instance = {"bar": "bar", "foo": 2}
+        schema = {"additionalProperties": {"type": "integer", "minimum": 5}}
+
+        validator = validators.Draft3Validator(schema)
+        errors = validator.iter_errors(instance)
+        e1, e2 = sorted_errors(errors)
+
+        self.assertEqual(e1.path, deque(["bar"]))
+        self.assertEqual(e2.path, deque(["foo"]))
+
+        self.assertEqual(e1.json_path, "$.bar")
+        self.assertEqual(e2.json_path, "$.foo")
+
+        self.assertEqual(e1.validator, "type")
+        self.assertEqual(e2.validator, "minimum")
+
+    def test_patternProperties(self):
+        instance = {"bar": 1, "foo": 2}
+        schema = {
+            "patternProperties": {
+                "bar": {"type": "string"},
+                "foo": {"minimum": 5},
+            },
+        }
+
+        validator = validators.Draft3Validator(schema)
+        errors = validator.iter_errors(instance)
+        e1, e2 = sorted_errors(errors)
+
+        self.assertEqual(e1.path, deque(["bar"]))
+        self.assertEqual(e2.path, deque(["foo"]))
+
+        self.assertEqual(e1.json_path, "$.bar")
+        self.assertEqual(e2.json_path, "$.foo")
+
+        self.assertEqual(e1.validator, "type")
+        self.assertEqual(e2.validator, "minimum")
+
+    def test_additionalItems(self):
+        instance = ["foo", 1]
+        schema = {
+            "items": [],
+            "additionalItems": {"type": "integer", "minimum": 5},
+        }
+
+        validator = validators.Draft3Validator(schema)
+        errors = validator.iter_errors(instance)
+        e1, e2 = sorted_errors(errors)
+
+        self.assertEqual(e1.path, deque([0]))
+        self.assertEqual(e2.path, deque([1]))
+
+        self.assertEqual(e1.json_path, "$[0]")
+        self.assertEqual(e2.json_path, "$[1]")
+
+        self.assertEqual(e1.validator, "type")
+        self.assertEqual(e2.validator, "minimum")
+
+    def test_additionalItems_with_items(self):
+        instance = ["foo", "bar", 1]
+        schema = {
+            "items": [{}],
+            "additionalItems": {"type": "integer", "minimum": 5},
+        }
+
+        validator = validators.Draft3Validator(schema)
+        errors = validator.iter_errors(instance)
+        e1, e2 = sorted_errors(errors)
+
+        self.assertEqual(e1.path, deque([1]))
+        self.assertEqual(e2.path, deque([2]))
+
+        self.assertEqual(e1.json_path, "$[1]")
+        self.assertEqual(e2.json_path, "$[2]")
+
+        self.assertEqual(e1.validator, "type")
+        self.assertEqual(e2.validator, "minimum")
+
+    def test_propertyNames(self):
+        instance = {"foo": 12}
+        schema = {"propertyNames": {"not": {"const": "foo"}}}
+
+        validator = validators.Draft7Validator(schema)
+        error, = validator.iter_errors(instance)
+
+        self.assertEqual(error.validator, "not")
+        self.assertEqual(
+            error.message,
+            "'foo' should not be valid under {'const': 'foo'}",
+        )
+        self.assertEqual(error.path, deque([]))
+        self.assertEqual(error.json_path, "$")
+        self.assertEqual(error.schema_path, deque(["propertyNames", "not"]))
+
+    def test_if_then(self):
+        schema = {
+            "if": {"const": 12},
+            "then": {"const": 13},
+        }
+
+        validator = validators.Draft7Validator(schema)
+        error, = validator.iter_errors(12)
+
+        self.assertEqual(error.validator, "const")
+        self.assertEqual(error.message, "13 was expected")
+        self.assertEqual(error.path, deque([]))
+        self.assertEqual(error.json_path, "$")
+        self.assertEqual(error.schema_path, deque(["then", "const"]))
+
+    def test_if_else(self):
+        schema = {
+            "if": {"const": 12},
+            "else": {"const": 13},
+        }
+
+        validator = validators.Draft7Validator(schema)
+        error, = validator.iter_errors(15)
+
+        self.assertEqual(error.validator, "const")
+        self.assertEqual(error.message, "13 was expected")
+        self.assertEqual(error.path, deque([]))
+        self.assertEqual(error.json_path, "$")
+        self.assertEqual(error.schema_path, deque(["else", "const"]))
+
+    def test_boolean_schema_False(self):
+        validator = validators.Draft7Validator(False)
+        error, = validator.iter_errors(12)
+
+        self.assertEqual(
+            (
+                error.message,
+                error.validator,
+                error.validator_value,
+                error.instance,
+                error.schema,
+                error.schema_path,
+                error.json_path,
+            ),
+            (
+                "False schema does not allow 12",
+                None,
+                None,
+                12,
+                False,
+                deque([]),
+                "$",
+            ),
+        )
+
+    def test_ref(self):
+        ref, schema = "someRef", {"additionalProperties": {"type": "integer"}}
+        validator = validators.Draft7Validator(
+            {"$ref": ref},
+            resolver=validators._RefResolver("", {}, store={ref: schema}),
+        )
+        error, = validator.iter_errors({"foo": "notAnInteger"})
+
+        self.assertEqual(
+            (
+                error.message,
+                error.validator,
+                error.validator_value,
+                error.instance,
+                error.absolute_path,
+                error.schema,
+                error.schema_path,
+                error.json_path,
+            ),
+            (
+                "'notAnInteger' is not of type 'integer'",
+                "type",
+                "integer",
+                "notAnInteger",
+                deque(["foo"]),
+                {"type": "integer"},
+                deque(["additionalProperties", "type"]),
+                "$.foo",
+            ),
+        )
+
+    def test_prefixItems(self):
+        schema = {"prefixItems": [{"type": "string"}, {}, {}, {"maximum": 3}]}
+        validator = validators.Draft202012Validator(schema)
+        type_error, min_error = validator.iter_errors([1, 2, "foo", 5])
+        self.assertEqual(
+            (
+                type_error.message,
+                type_error.validator,
+                type_error.validator_value,
+                type_error.instance,
+                type_error.absolute_path,
+                type_error.schema,
+                type_error.schema_path,
+                type_error.json_path,
+            ),
+            (
+                "1 is not of type 'string'",
+                "type",
+                "string",
+                1,
+                deque([0]),
+                {"type": "string"},
+                deque(["prefixItems", 0, "type"]),
+                "$[0]",
+            ),
+        )
+        self.assertEqual(
+            (
+                min_error.message,
+                min_error.validator,
+                min_error.validator_value,
+                min_error.instance,
+                min_error.absolute_path,
+                min_error.schema,
+                min_error.schema_path,
+                min_error.json_path,
+            ),
+            (
+                "5 is greater than the maximum of 3",
+                "maximum",
+                3,
+                5,
+                deque([3]),
+                {"maximum": 3},
+                deque(["prefixItems", 3, "maximum"]),
+                "$[3]",
+            ),
+        )
+
+    def test_prefixItems_with_items(self):
+        schema = {
+            "items": {"type": "string"},
+            "prefixItems": [{}],
+        }
+        validator = validators.Draft202012Validator(schema)
+        e1, e2 = validator.iter_errors(["foo", 2, "bar", 4, "baz"])
+        self.assertEqual(
+            (
+                e1.message,
+                e1.validator,
+                e1.validator_value,
+                e1.instance,
+                e1.absolute_path,
+                e1.schema,
+                e1.schema_path,
+                e1.json_path,
+            ),
+            (
+                "2 is not of type 'string'",
+                "type",
+                "string",
+                2,
+                deque([1]),
+                {"type": "string"},
+                deque(["items", "type"]),
+                "$[1]",
+            ),
+        )
+        self.assertEqual(
+            (
+                e2.message,
+                e2.validator,
+                e2.validator_value,
+                e2.instance,
+                e2.absolute_path,
+                e2.schema,
+                e2.schema_path,
+                e2.json_path,
+            ),
+            (
+                "4 is not of type 'string'",
+                "type",
+                "string",
+                4,
+                deque([3]),
+                {"type": "string"},
+                deque(["items", "type"]),
+                "$[3]",
+            ),
+        )
+
+    def test_contains_too_many(self):
+        """
+        `contains` + `maxContains` produces only one error, even if there are
+        many more incorrectly matching elements.
+        """
+        schema = {"contains": {"type": "string"}, "maxContains": 2}
+        validator = validators.Draft202012Validator(schema)
+        error, = validator.iter_errors(["foo", 2, "bar", 4, "baz", "quux"])
+        self.assertEqual(
+            (
+                error.message,
+                error.validator,
+                error.validator_value,
+                error.instance,
+                error.absolute_path,
+                error.schema,
+                error.schema_path,
+                error.json_path,
+            ),
+            (
+                "Too many items match the given schema (expected at most 2)",
+                "maxContains",
+                2,
+                ["foo", 2, "bar", 4, "baz", "quux"],
+                deque([]),
+                {"contains": {"type": "string"}, "maxContains": 2},
+                deque(["contains"]),
+                "$",
+            ),
+        )
+
+    def test_contains_too_few(self):
+        schema = {"contains": {"type": "string"}, "minContains": 2}
+        validator = validators.Draft202012Validator(schema)
+        error, = validator.iter_errors(["foo", 2, 4])
+        self.assertEqual(
+            (
+                error.message,
+                error.validator,
+                error.validator_value,
+                error.instance,
+                error.absolute_path,
+                error.schema,
+                error.schema_path,
+                error.json_path,
+            ),
+            (
+                (
+                    "Too few items match the given schema "
+                    "(expected at least 2 but only 1 matched)"
+                ),
+                "minContains",
+                2,
+                ["foo", 2, 4],
+                deque([]),
+                {"contains": {"type": "string"}, "minContains": 2},
+                deque(["contains"]),
+                "$",
+            ),
+        )
+
+    def test_contains_none(self):
+        schema = {"contains": {"type": "string"}, "minContains": 2}
+        validator = validators.Draft202012Validator(schema)
+        error, = validator.iter_errors([2, 4])
+        self.assertEqual(
+            (
+                error.message,
+                error.validator,
+                error.validator_value,
+                error.instance,
+                error.absolute_path,
+                error.schema,
+                error.schema_path,
+                error.json_path,
+            ),
+            (
+                "[2, 4] does not contain items matching the given schema",
+                "contains",
+                {"type": "string"},
+                [2, 4],
+                deque([]),
+                {"contains": {"type": "string"}, "minContains": 2},
+                deque(["contains"]),
+                "$",
+            ),
+        )
+
+    def test_ref_sibling(self):
+        schema = {
+            "$defs": {"foo": {"required": ["bar"]}},
+            "properties": {
+                "aprop": {
+                    "$ref": "#/$defs/foo",
+                    "required": ["baz"],
+                },
+            },
+        }
+
+        validator = validators.Draft202012Validator(schema)
+        e1, e2 = validator.iter_errors({"aprop": {}})
+        self.assertEqual(
+            (
+                e1.message,
+                e1.validator,
+                e1.validator_value,
+                e1.instance,
+                e1.absolute_path,
+                e1.schema,
+                e1.schema_path,
+                e1.relative_schema_path,
+                e1.json_path,
+            ),
+            (
+                "'bar' is a required property",
+                "required",
+                ["bar"],
+                {},
+                deque(["aprop"]),
+                {"required": ["bar"]},
+                deque(["properties", "aprop", "required"]),
+                deque(["properties", "aprop", "required"]),
+                "$.aprop",
+            ),
+        )
+        self.assertEqual(
+            (
+                e2.message,
+                e2.validator,
+                e2.validator_value,
+                e2.instance,
+                e2.absolute_path,
+                e2.schema,
+                e2.schema_path,
+                e2.relative_schema_path,
+                e2.json_path,
+            ),
+            (
+                "'baz' is a required property",
+                "required",
+                ["baz"],
+                {},
+                deque(["aprop"]),
+                {"$ref": "#/$defs/foo", "required": ["baz"]},
+                deque(["properties", "aprop", "required"]),
+                deque(["properties", "aprop", "required"]),
+                "$.aprop",
+            ),
+        )
+
+
+class MetaSchemaTestsMixin:
+    # TODO: These all belong upstream
+    def test_invalid_properties(self):
+        with self.assertRaises(exceptions.SchemaError):
+            self.Validator.check_schema({"properties": 12})
+
+    def test_minItems_invalid_string(self):
+        with self.assertRaises(exceptions.SchemaError):
+            # needs to be an integer
+            self.Validator.check_schema({"minItems": "1"})
+
+    def test_enum_allows_empty_arrays(self):
+        """
+        Technically, all the spec says is they SHOULD have elements, not MUST.
+
+        (As of Draft 6. Previous drafts do say MUST).
+
+        See #529.
+        """
+        if self.Validator in {
+            validators.Draft3Validator,
+            validators.Draft4Validator,
+        }:
+            with self.assertRaises(exceptions.SchemaError):
+                self.Validator.check_schema({"enum": []})
+        else:
+            self.Validator.check_schema({"enum": []})
+
+    def test_enum_allows_non_unique_items(self):
+        """
+        Technically, all the spec says is they SHOULD be unique, not MUST.
+
+        (As of Draft 6. Previous drafts do say MUST).
+
+        See #529.
+        """
+        if self.Validator in {
+            validators.Draft3Validator,
+            validators.Draft4Validator,
+        }:
+            with self.assertRaises(exceptions.SchemaError):
+                self.Validator.check_schema({"enum": [12, 12]})
+        else:
+            self.Validator.check_schema({"enum": [12, 12]})
+
+    def test_schema_with_invalid_regex(self):
+        with self.assertRaises(exceptions.SchemaError):
+            self.Validator.check_schema({"pattern": "*notaregex"})
+
+    def test_schema_with_invalid_regex_with_disabled_format_validation(self):
+        self.Validator.check_schema(
+            {"pattern": "*notaregex"},
+            format_checker=None,
+        )
+
+
+class ValidatorTestMixin(MetaSchemaTestsMixin):
+    def test_it_implements_the_validator_protocol(self):
+        self.assertIsInstance(self.Validator({}), protocols.Validator)
+
+    def test_valid_instances_are_valid(self):
+        schema, instance = self.valid
+        self.assertTrue(self.Validator(schema).is_valid(instance))
+
+    def test_invalid_instances_are_not_valid(self):
+        schema, instance = self.invalid
+        self.assertFalse(self.Validator(schema).is_valid(instance))
+
+    def test_non_existent_properties_are_ignored(self):
+        self.Validator({object(): object()}).validate(instance=object())
+
+    def test_evolve(self):
+        schema, format_checker = {"type": "integer"}, FormatChecker()
+        original = self.Validator(
+            schema,
+            format_checker=format_checker,
+        )
+        new = original.evolve(
+            schema={"type": "string"},
+            format_checker=self.Validator.FORMAT_CHECKER,
+        )
+
+        expected = self.Validator(
+            {"type": "string"},
+            format_checker=self.Validator.FORMAT_CHECKER,
+            _resolver=new._resolver,
+        )
+
+        self.assertEqual(new, expected)
+        self.assertNotEqual(new, original)
+
+    def test_evolve_with_subclass(self):
+        """
+        Subclassing validators isn't supported public API, but some users have
+        done it, because we don't actually error entirely when it's done :/
+
+        We need to deprecate doing so first to help as many of these users
+        ensure they can move to supported APIs, but this test ensures that in
+        the interim, we haven't broken those users.
+        """
+
+        with self.assertWarns(DeprecationWarning):
+            @define
+            class OhNo(self.Validator):
+                foo = field(factory=lambda: [1, 2, 3])
+                _bar = field(default=37)
+
+        validator = OhNo({}, bar=12)
+        self.assertEqual(validator.foo, [1, 2, 3])
+
+        new = validator.evolve(schema={"type": "integer"})
+        self.assertEqual(new.foo, [1, 2, 3])
+        self.assertEqual(new._bar, 12)
+
+    def test_is_type_is_true_for_valid_type(self):
+        self.assertTrue(self.Validator({}).is_type("foo", "string"))
+
+    def test_is_type_is_false_for_invalid_type(self):
+        self.assertFalse(self.Validator({}).is_type("foo", "array"))
+
+    def test_is_type_evades_bool_inheriting_from_int(self):
+        self.assertFalse(self.Validator({}).is_type(True, "integer"))
+        self.assertFalse(self.Validator({}).is_type(True, "number"))
+
+    def test_it_can_validate_with_decimals(self):
+        schema = {"items": {"type": "number"}}
+        Validator = validators.extend(
+            self.Validator,
+            type_checker=self.Validator.TYPE_CHECKER.redefine(
+                "number",
+                lambda checker, thing: isinstance(
+                    thing, (int, float, Decimal),
+                ) and not isinstance(thing, bool),
+            ),
+        )
+
+        validator = Validator(schema)
+        validator.validate([1, 1.1, Decimal(1) / Decimal(8)])
+
+        invalid = ["foo", {}, [], True, None]
+        self.assertEqual(
+            [error.instance for error in validator.iter_errors(invalid)],
+            invalid,
+        )
+
+    def test_it_returns_true_for_formats_it_does_not_know_about(self):
+        validator = self.Validator(
+            {"format": "carrot"}, format_checker=FormatChecker(),
+        )
+        validator.validate("bugs")
+
+    def test_it_does_not_validate_formats_by_default(self):
+        validator = self.Validator({})
+        self.assertIsNone(validator.format_checker)
+
+    def test_it_validates_formats_if_a_checker_is_provided(self):
+        checker = FormatChecker()
+        bad = ValueError("Bad!")
+
+        @checker.checks("foo", raises=ValueError)
+        def check(value):
+            if value == "good":
+                return True
+            elif value == "bad":
+                raise bad
+            else:  # pragma: no cover
+                self.fail(f"What is {value}? [Baby Don't Hurt Me]")
+
+        validator = self.Validator(
+            {"format": "foo"}, format_checker=checker,
+        )
+
+        validator.validate("good")
+        with self.assertRaises(exceptions.ValidationError) as cm:
+            validator.validate("bad")
+
+        # Make sure original cause is attached
+        self.assertIs(cm.exception.cause, bad)
+
+    def test_non_string_custom_type(self):
+        non_string_type = object()
+        schema = {"type": [non_string_type]}
+        Crazy = validators.extend(
+            self.Validator,
+            type_checker=self.Validator.TYPE_CHECKER.redefine(
+                non_string_type,
+                lambda checker, thing: isinstance(thing, int),
+            ),
+        )
+        Crazy(schema).validate(15)
+
+    def test_it_properly_formats_tuples_in_errors(self):
+        """
+        A tuple instance properly formats validation errors for uniqueItems.
+
+        See #224
+        """
+        TupleValidator = validators.extend(
+            self.Validator,
+            type_checker=self.Validator.TYPE_CHECKER.redefine(
+                "array",
+                lambda checker, thing: isinstance(thing, tuple),
+            ),
+        )
+        with self.assertRaises(exceptions.ValidationError) as e:
+            TupleValidator({"uniqueItems": True}).validate((1, 1))
+        self.assertIn("(1, 1) has non-unique elements", str(e.exception))
+
+    def test_check_redefined_sequence(self):
+        """
+        Allow array to validate against another defined sequence type
+        """
+        schema = {"type": "array", "uniqueItems": True}
+        MyMapping = namedtuple("MyMapping", "a, b")
+        Validator = validators.extend(
+            self.Validator,
+            type_checker=self.Validator.TYPE_CHECKER.redefine_many(
+                {
+                    "array": lambda checker, thing: isinstance(
+                        thing, (list, deque),
+                    ),
+                    "object": lambda checker, thing: isinstance(
+                        thing, (dict, MyMapping),
+                    ),
+                },
+            ),
+        )
+        validator = Validator(schema)
+
+        valid_instances = [
+            deque(["a", None, "1", "", True]),
+            deque([[False], [0]]),
+            [deque([False]), deque([0])],
+            [[deque([False])], [deque([0])]],
+            [[[[[deque([False])]]]], [[[[deque([0])]]]]],
+            [deque([deque([False])]), deque([deque([0])])],
+            [MyMapping("a", 0), MyMapping("a", False)],
+            [
+                MyMapping("a", [deque([0])]),
+                MyMapping("a", [deque([False])]),
+            ],
+            [
+                MyMapping("a", [MyMapping("a", deque([0]))]),
+                MyMapping("a", [MyMapping("a", deque([False]))]),
+            ],
+            [deque(deque(deque([False]))), deque(deque(deque([0])))],
+        ]
+
+        for instance in valid_instances:
+            validator.validate(instance)
+
+        invalid_instances = [
+            deque(["a", "b", "a"]),
+            deque([[False], [False]]),
+            [deque([False]), deque([False])],
+            [[deque([False])], [deque([False])]],
+            [[[[[deque([False])]]]], [[[[deque([False])]]]]],
+            [deque([deque([False])]), deque([deque([False])])],
+            [MyMapping("a", False), MyMapping("a", False)],
+            [
+                MyMapping("a", [deque([False])]),
+                MyMapping("a", [deque([False])]),
+            ],
+            [
+                MyMapping("a", [MyMapping("a", deque([False]))]),
+                MyMapping("a", [MyMapping("a", deque([False]))]),
+            ],
+            [deque(deque(deque([False]))), deque(deque(deque([False])))],
+        ]
+
+        for instance in invalid_instances:
+            with self.assertRaises(exceptions.ValidationError):
+                validator.validate(instance)
+
+    def test_it_creates_a_ref_resolver_if_not_provided(self):
+        with self.assertWarns(DeprecationWarning):
+            resolver = self.Validator({}).resolver
+        self.assertIsInstance(resolver, validators._RefResolver)
+
+    def test_it_upconverts_from_deprecated_RefResolvers(self):
+        ref, schema = "someCoolRef", {"type": "integer"}
+        resolver = validators._RefResolver("", {}, store={ref: schema})
+        validator = self.Validator({"$ref": ref}, resolver=resolver)
+
+        with self.assertRaises(exceptions.ValidationError):
+            validator.validate(None)
+
+    def test_it_upconverts_from_yet_older_deprecated_legacy_RefResolvers(self):
+        """
+        Legacy RefResolvers support only the context manager form of
+        resolution.
+        """
+
+        class LegacyRefResolver:
+            @contextmanager
+            def resolving(this, ref):
+                self.assertEqual(ref, "the ref")
+                yield {"type": "integer"}
+
+        resolver = LegacyRefResolver()
+        schema = {"$ref": "the ref"}
+
+        with self.assertRaises(exceptions.ValidationError):
+            self.Validator(schema, resolver=resolver).validate(None)
+
+
+class AntiDraft6LeakMixin:
+    """
+    Make sure functionality from draft 6 doesn't leak backwards in time.
+    """
+
+    def test_True_is_not_a_schema(self):
+        with self.assertRaises(exceptions.SchemaError) as e:
+            self.Validator.check_schema(True)
+        self.assertIn("True is not of type", str(e.exception))
+
+    def test_False_is_not_a_schema(self):
+        with self.assertRaises(exceptions.SchemaError) as e:
+            self.Validator.check_schema(False)
+        self.assertIn("False is not of type", str(e.exception))
+
+    def test_True_is_not_a_schema_even_if_you_forget_to_check(self):
+        with self.assertRaises(Exception) as e:
+            self.Validator(True).validate(12)
+        self.assertNotIsInstance(e.exception, exceptions.ValidationError)
+
+    def test_False_is_not_a_schema_even_if_you_forget_to_check(self):
+        with self.assertRaises(Exception) as e:
+            self.Validator(False).validate(12)
+        self.assertNotIsInstance(e.exception, exceptions.ValidationError)
+
+
+class TestDraft3Validator(AntiDraft6LeakMixin, ValidatorTestMixin, TestCase):
+    Validator = validators.Draft3Validator
+    valid: tuple[dict, dict] = ({}, {})
+    invalid = {"type": "integer"}, "foo"
+
+    def test_any_type_is_valid_for_type_any(self):
+        validator = self.Validator({"type": "any"})
+        validator.validate(object())
+
+    def test_any_type_is_redefinable(self):
+        """
+        Sigh, because why not.
+        """
+        Crazy = validators.extend(
+            self.Validator,
+            type_checker=self.Validator.TYPE_CHECKER.redefine(
+                "any", lambda checker, thing: isinstance(thing, int),
+            ),
+        )
+        validator = Crazy({"type": "any"})
+        validator.validate(12)
+        with self.assertRaises(exceptions.ValidationError):
+            validator.validate("foo")
+
+    def test_is_type_is_true_for_any_type(self):
+        self.assertTrue(self.Validator({"type": "any"}).is_valid(object()))
+
+    def test_is_type_does_not_evade_bool_if_it_is_being_tested(self):
+        self.assertTrue(self.Validator({}).is_type(True, "boolean"))
+        self.assertTrue(self.Validator({"type": "any"}).is_valid(True))
+
+
+class TestDraft4Validator(AntiDraft6LeakMixin, ValidatorTestMixin, TestCase):
+    Validator = validators.Draft4Validator
+    valid: tuple[dict, dict] = ({}, {})
+    invalid = {"type": "integer"}, "foo"
+
+
+class TestDraft6Validator(ValidatorTestMixin, TestCase):
+    Validator = validators.Draft6Validator
+    valid: tuple[dict, dict] = ({}, {})
+    invalid = {"type": "integer"}, "foo"
+
+
+class TestDraft7Validator(ValidatorTestMixin, TestCase):
+    Validator = validators.Draft7Validator
+    valid: tuple[dict, dict] = ({}, {})
+    invalid = {"type": "integer"}, "foo"
+
+
+class TestDraft201909Validator(ValidatorTestMixin, TestCase):
+    Validator = validators.Draft201909Validator
+    valid: tuple[dict, dict] = ({}, {})
+    invalid = {"type": "integer"}, "foo"
+
+
+class TestDraft202012Validator(ValidatorTestMixin, TestCase):
+    Validator = validators.Draft202012Validator
+    valid: tuple[dict, dict] = ({}, {})
+    invalid = {"type": "integer"}, "foo"
+
+
+class TestLatestValidator(TestCase):
+    """
+    These really apply to multiple versions but are easiest to test on one.
+    """
+
+    def test_ref_resolvers_may_have_boolean_schemas_stored(self):
+        ref = "someCoolRef"
+        schema = {"$ref": ref}
+        resolver = validators._RefResolver("", {}, store={ref: False})
+        validator = validators._LATEST_VERSION(schema, resolver=resolver)
+
+        with self.assertRaises(exceptions.ValidationError):
+            validator.validate(None)
+
+
+class TestValidatorFor(TestCase):
+    def test_draft_3(self):
+        schema = {"$schema": "http://json-schema.org/draft-03/schema"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft3Validator,
+        )
+
+        schema = {"$schema": "http://json-schema.org/draft-03/schema#"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft3Validator,
+        )
+
+    def test_draft_4(self):
+        schema = {"$schema": "http://json-schema.org/draft-04/schema"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft4Validator,
+        )
+
+        schema = {"$schema": "http://json-schema.org/draft-04/schema#"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft4Validator,
+        )
+
+    def test_draft_6(self):
+        schema = {"$schema": "http://json-schema.org/draft-06/schema"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft6Validator,
+        )
+
+        schema = {"$schema": "http://json-schema.org/draft-06/schema#"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft6Validator,
+        )
+
+    def test_draft_7(self):
+        schema = {"$schema": "http://json-schema.org/draft-07/schema"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft7Validator,
+        )
+
+        schema = {"$schema": "http://json-schema.org/draft-07/schema#"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft7Validator,
+        )
+
+    def test_draft_201909(self):
+        schema = {"$schema": "https://json-schema.org/draft/2019-09/schema"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft201909Validator,
+        )
+
+        schema = {"$schema": "https://json-schema.org/draft/2019-09/schema#"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft201909Validator,
+        )
+
+    def test_draft_202012(self):
+        schema = {"$schema": "https://json-schema.org/draft/2020-12/schema"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft202012Validator,
+        )
+
+        schema = {"$schema": "https://json-schema.org/draft/2020-12/schema#"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft202012Validator,
+        )
+
+    def test_True(self):
+        self.assertIs(
+            validators.validator_for(True),
+            validators._LATEST_VERSION,
+        )
+
+    def test_False(self):
+        self.assertIs(
+            validators.validator_for(False),
+            validators._LATEST_VERSION,
+        )
+
+    def test_custom_validator(self):
+        Validator = validators.create(
+            meta_schema={"id": "meta schema id"},
+            version="12",
+            id_of=lambda s: s.get("id", ""),
+        )
+        schema = {"$schema": "meta schema id"}
+        self.assertIs(
+            validators.validator_for(schema),
+            Validator,
+        )
+
+    def test_custom_validator_draft6(self):
+        Validator = validators.create(
+            meta_schema={"$id": "meta schema $id"},
+            version="13",
+        )
+        schema = {"$schema": "meta schema $id"}
+        self.assertIs(
+            validators.validator_for(schema),
+            Validator,
+        )
+
+    def test_validator_for_jsonschema_default(self):
+        self.assertIs(validators.validator_for({}), validators._LATEST_VERSION)
+
+    def test_validator_for_custom_default(self):
+        self.assertIs(validators.validator_for({}, default=None), None)
+
+    def test_warns_if_meta_schema_specified_was_not_found(self):
+        with self.assertWarns(DeprecationWarning) as cm:
+            validators.validator_for(schema={"$schema": "unknownSchema"})
+
+        self.assertEqual(cm.filename, __file__)
+        self.assertEqual(
+            str(cm.warning),
+            "The metaschema specified by $schema was not found. "
+            "Using the latest draft to validate, but this will raise "
+            "an error in the future.",
+        )
+
+    def test_does_not_warn_if_meta_schema_is_unspecified(self):
+        with warnings.catch_warnings(record=True) as w:
+            warnings.simplefilter("always")
+            validators.validator_for(schema={}, default={})
+        self.assertFalse(w)
+
+    def test_validator_for_custom_default_with_schema(self):
+        schema, default = {"$schema": "mailto:foo@example.com"}, object()
+        self.assertIs(validators.validator_for(schema, default), default)
+
+
+class TestValidate(TestCase):
+    def assertUses(self, schema, Validator):
+        result = []
+        with mock.patch.object(Validator, "check_schema", result.append):
+            validators.validate({}, schema)
+        self.assertEqual(result, [schema])
+
+    def test_draft3_validator_is_chosen(self):
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-03/schema#"},
+            Validator=validators.Draft3Validator,
+        )
+        # Make sure it works without the empty fragment
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-03/schema"},
+            Validator=validators.Draft3Validator,
+        )
+
+    def test_draft4_validator_is_chosen(self):
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-04/schema#"},
+            Validator=validators.Draft4Validator,
+        )
+        # Make sure it works without the empty fragment
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-04/schema"},
+            Validator=validators.Draft4Validator,
+        )
+
+    def test_draft6_validator_is_chosen(self):
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-06/schema#"},
+            Validator=validators.Draft6Validator,
+        )
+        # Make sure it works without the empty fragment
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-06/schema"},
+            Validator=validators.Draft6Validator,
+        )
+
+    def test_draft7_validator_is_chosen(self):
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-07/schema#"},
+            Validator=validators.Draft7Validator,
+        )
+        # Make sure it works without the empty fragment
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-07/schema"},
+            Validator=validators.Draft7Validator,
+        )
+
+    def test_draft202012_validator_is_chosen(self):
+        self.assertUses(
+            schema={
+                "$schema": "https://json-schema.org/draft/2020-12/schema#",
+            },
+            Validator=validators.Draft202012Validator,
+        )
+        # Make sure it works without the empty fragment
+        self.assertUses(
+            schema={
+                "$schema": "https://json-schema.org/draft/2020-12/schema",
+            },
+            Validator=validators.Draft202012Validator,
+        )
+
+    def test_draft202012_validator_is_the_default(self):
+        self.assertUses(schema={}, Validator=validators.Draft202012Validator)
+
+    def test_validation_error_message(self):
+        with self.assertRaises(exceptions.ValidationError) as e:
+            validators.validate(12, {"type": "string"})
+        self.assertRegex(
+            str(e.exception),
+            "(?s)Failed validating '.*' in schema.*On instance",
+        )
+
+    def test_schema_error_message(self):
+        with self.assertRaises(exceptions.SchemaError) as e:
+            validators.validate(12, {"type": 12})
+        self.assertRegex(
+            str(e.exception),
+            "(?s)Failed validating '.*' in metaschema.*On schema",
+        )
+
+    def test_it_uses_best_match(self):
+        schema = {
+            "oneOf": [
+                {"type": "number", "minimum": 20},
+                {"type": "array"},
+            ],
+        }
+        with self.assertRaises(exceptions.ValidationError) as e:
+            validators.validate(12, schema)
+        self.assertIn("12 is less than the minimum of 20", str(e.exception))
+
+
+class TestThreading(TestCase):
+    """
+    Threading-related functionality tests.
+
+    jsonschema doesn't promise thread safety, and its validation behavior
+    across multiple threads may change at any time, but that means it isn't
+    safe to share *validators* across threads, not that anytime one has
+    multiple threads that jsonschema won't work (it certainly is intended to).
+
+    These tests ensure that this minimal level of functionality continues to
+    work.
+    """
+
+    def test_validation_across_a_second_thread(self):
+        failed = []
+
+        def validate():
+            try:
+                validators.validate(instance=37, schema=True)
+            except:  # pragma: no cover  # noqa: E722
+                failed.append(sys.exc_info())
+
+        validate()  # just verify it succeeds
+
+        from threading import Thread
+        thread = Thread(target=validate)
+        thread.start()
+        thread.join()
+        self.assertEqual((thread.is_alive(), failed), (False, []))
+
+
+class TestReferencing(TestCase):
+    def test_registry_with_retrieve(self):
+        def retrieve(uri):
+            return DRAFT202012.create_resource({"type": "integer"})
+
+        registry = referencing.Registry(retrieve=retrieve)
+        schema = {"$ref": "https://example.com/"}
+        validator = validators.Draft202012Validator(schema, registry=registry)
+
+        self.assertEqual(
+            (validator.is_valid(12), validator.is_valid("foo")),
+            (True, False),
+        )
+
+    def test_custom_registries_do_not_autoretrieve_remote_resources(self):
+        registry = referencing.Registry()
+        schema = {"$ref": "https://example.com/"}
+        validator = validators.Draft202012Validator(schema, registry=registry)
+
+        with warnings.catch_warnings(record=True) as w:
+            warnings.simplefilter("always")
+            with self.assertRaises(referencing.exceptions.Unresolvable):
+                validator.validate(12)
+        self.assertFalse(w)
+
+
+class TestRefResolver(TestCase):
+
+    base_uri = ""
+    stored_uri = "foo://stored"
+    stored_schema = {"stored": "schema"}
+
+    def setUp(self):
+        self.referrer = {}
+        self.store = {self.stored_uri: self.stored_schema}
+        self.resolver = validators._RefResolver(
+            self.base_uri, self.referrer, self.store,
+        )
+
+    def test_it_does_not_retrieve_schema_urls_from_the_network(self):
+        ref = validators.Draft3Validator.META_SCHEMA["id"]
+        with mock.patch.object(self.resolver, "resolve_remote") as patched:  # noqa: SIM117
+            with self.resolver.resolving(ref) as resolved:
+                pass
+        self.assertEqual(resolved, validators.Draft3Validator.META_SCHEMA)
+        self.assertFalse(patched.called)
+
+    def test_it_resolves_local_refs(self):
+        ref = "#/properties/foo"
+        self.referrer["properties"] = {"foo": object()}
+        with self.resolver.resolving(ref) as resolved:
+            self.assertEqual(resolved, self.referrer["properties"]["foo"])
+
+    def test_it_resolves_local_refs_with_id(self):
+        schema = {"id": "http://bar/schema#", "a": {"foo": "bar"}}
+        resolver = validators._RefResolver.from_schema(
+            schema,
+            id_of=lambda schema: schema.get("id", ""),
+        )
+        with resolver.resolving("#/a") as resolved:
+            self.assertEqual(resolved, schema["a"])
+        with resolver.resolving("http://bar/schema#/a") as resolved:
+            self.assertEqual(resolved, schema["a"])
+
+    def test_it_retrieves_stored_refs(self):
+        with self.resolver.resolving(self.stored_uri) as resolved:
+            self.assertIs(resolved, self.stored_schema)
+
+        self.resolver.store["cached_ref"] = {"foo": 12}
+        with self.resolver.resolving("cached_ref#/foo") as resolved:
+            self.assertEqual(resolved, 12)
+
+    def test_it_retrieves_unstored_refs_via_requests(self):
+        ref = "http://bar#baz"
+        schema = {"baz": 12}
+
+        if "requests" in sys.modules:  # pragma: no cover
+            self.addCleanup(
+                sys.modules.__setitem__, "requests", sys.modules["requests"],
+            )
+        sys.modules["requests"] = ReallyFakeRequests({"http://bar": schema})
+
+        with self.resolver.resolving(ref) as resolved:
+            self.assertEqual(resolved, 12)
+
+    def test_it_retrieves_unstored_refs_via_urlopen(self):
+        ref = "http://bar#baz"
+        schema = {"baz": 12}
+
+        if "requests" in sys.modules:  # pragma: no cover
+            self.addCleanup(
+                sys.modules.__setitem__, "requests", sys.modules["requests"],
+            )
+        sys.modules["requests"] = None
+
+        @contextmanager
+        def fake_urlopen(url):
+            self.assertEqual(url, "http://bar")
+            yield BytesIO(json.dumps(schema).encode("utf8"))
+
+        self.addCleanup(setattr, validators, "urlopen", validators.urlopen)
+        validators.urlopen = fake_urlopen
+
+        with self.resolver.resolving(ref) as resolved:
+            pass
+        self.assertEqual(resolved, 12)
+
+    def test_it_retrieves_local_refs_via_urlopen(self):
+        with tempfile.NamedTemporaryFile(delete=False, mode="wt") as tempf:
+            self.addCleanup(os.remove, tempf.name)
+            json.dump({"foo": "bar"}, tempf)
+
+        ref = f"file://{pathname2url(tempf.name)}#foo"
+        with self.resolver.resolving(ref) as resolved:
+            self.assertEqual(resolved, "bar")
+
+    def test_it_can_construct_a_base_uri_from_a_schema(self):
+        schema = {"id": "foo"}
+        resolver = validators._RefResolver.from_schema(
+            schema,
+            id_of=lambda schema: schema.get("id", ""),
+        )
+        self.assertEqual(resolver.base_uri, "foo")
+        self.assertEqual(resolver.resolution_scope, "foo")
+        with resolver.resolving("") as resolved:
+            self.assertEqual(resolved, schema)
+        with resolver.resolving("#") as resolved:
+            self.assertEqual(resolved, schema)
+        with resolver.resolving("foo") as resolved:
+            self.assertEqual(resolved, schema)
+        with resolver.resolving("foo#") as resolved:
+            self.assertEqual(resolved, schema)
+
+    def test_it_can_construct_a_base_uri_from_a_schema_without_id(self):
+        schema = {}
+        resolver = validators._RefResolver.from_schema(schema)
+        self.assertEqual(resolver.base_uri, "")
+        self.assertEqual(resolver.resolution_scope, "")
+        with resolver.resolving("") as resolved:
+            self.assertEqual(resolved, schema)
+        with resolver.resolving("#") as resolved:
+            self.assertEqual(resolved, schema)
+
+    def test_custom_uri_scheme_handlers(self):
+        def handler(url):
+            self.assertEqual(url, ref)
+            return schema
+
+        schema = {"foo": "bar"}
+        ref = "foo://bar"
+        resolver = validators._RefResolver("", {}, handlers={"foo": handler})
+        with resolver.resolving(ref) as resolved:
+            self.assertEqual(resolved, schema)
+
+    def test_cache_remote_on(self):
+        response = [object()]
+
+        def handler(url):
+            try:
+                return response.pop()
+            except IndexError:  # pragma: no cover
+                self.fail("Response must not have been cached!")
+
+        ref = "foo://bar"
+        resolver = validators._RefResolver(
+            "", {}, cache_remote=True, handlers={"foo": handler},
+        )
+        with resolver.resolving(ref):
+            pass
+        with resolver.resolving(ref):
+            pass
+
+    def test_cache_remote_off(self):
+        response = [object()]
+
+        def handler(url):
+            try:
+                return response.pop()
+            except IndexError:  # pragma: no cover
+                self.fail("Handler called twice!")
+
+        ref = "foo://bar"
+        resolver = validators._RefResolver(
+            "", {}, cache_remote=False, handlers={"foo": handler},
+        )
+        with resolver.resolving(ref):
+            pass
+
+    def test_if_you_give_it_junk_you_get_a_resolution_error(self):
+        error = ValueError("Oh no! What's this?")
+
+        def handler(url):
+            raise error
+
+        ref = "foo://bar"
+        resolver = validators._RefResolver("", {}, handlers={"foo": handler})
+        with self.assertRaises(exceptions._RefResolutionError) as err:  # noqa: SIM117
+            with resolver.resolving(ref):
+                self.fail("Shouldn't get this far!")  # pragma: no cover
+        self.assertEqual(err.exception, exceptions._RefResolutionError(error))
+
+    def test_helpful_error_message_on_failed_pop_scope(self):
+        resolver = validators._RefResolver("", {})
+        resolver.pop_scope()
+        with self.assertRaises(exceptions._RefResolutionError) as exc:
+            resolver.pop_scope()
+        self.assertIn("Failed to pop the scope", str(exc.exception))
+
+    def test_pointer_within_schema_with_different_id(self):
+        """
+        See #1085.
+        """
+        schema = validators.Draft7Validator.META_SCHEMA
+        one = validators._RefResolver("", schema)
+        validator = validators.Draft7Validator(schema, resolver=one)
+        self.assertFalse(validator.is_valid({"maxLength": "foo"}))
+
+        another = {
+            "allOf": [{"$ref": validators.Draft7Validator.META_SCHEMA["$id"]}],
+        }
+        two = validators._RefResolver("", another)
+        validator = validators.Draft7Validator(another, resolver=two)
+        self.assertFalse(validator.is_valid({"maxLength": "foo"}))
+
+    def test_newly_created_validator_with_ref_resolver(self):
+        """
+        See https://github.com/python-jsonschema/jsonschema/issues/1061#issuecomment-1624266555.
+        """
+
+        def handle(uri):
+            self.assertEqual(uri, "http://example.com/foo")
+            return {"type": "integer"}
+
+        resolver = validators._RefResolver("", {}, handlers={"http": handle})
+        Validator = validators.create(
+            meta_schema={},
+            validators=validators.Draft4Validator.VALIDATORS,
+        )
+        schema = {"$id": "http://example.com/bar", "$ref": "foo"}
+        validator = Validator(schema, resolver=resolver)
+        self.assertEqual(
+            (validator.is_valid({}), validator.is_valid(37)),
+            (False, True),
+        )
+
+    def test_refresolver_with_pointer_in_schema_with_no_id(self):
+        """
+        See https://github.com/python-jsonschema/jsonschema/issues/1124#issuecomment-1632574249.
+        """
+
+        schema = {
+            "properties": {"x": {"$ref": "#/definitions/x"}},
+            "definitions": {"x": {"type": "integer"}},
+        }
+
+        validator = validators.Draft202012Validator(
+            schema,
+            resolver=validators._RefResolver("", schema),
+        )
+        self.assertEqual(
+            (validator.is_valid({"x": "y"}), validator.is_valid({"x": 37})),
+            (False, True),
+        )
+
+
+
+def sorted_errors(errors):
+    def key(error):
+        return (
+            [str(e) for e in error.path],
+            [str(e) for e in error.schema_path],
+        )
+    return sorted(errors, key=key)
+
+
+@define
+class ReallyFakeRequests:
+
+    _responses: dict[str, Any]
+
+    def get(self, url):
+        response = self._responses.get(url)
+        if url is None:  # pragma: no cover
+            raise ValueError("Unknown URL: " + repr(url))
+        return _ReallyFakeJSONResponse(json.dumps(response))
+
+
+@define
+class _ReallyFakeJSONResponse:
+
+    _response: str
+
+    def json(self):
+        return json.loads(self._response)
diff --git a/llm/Lib/site-packages/jsonschema/validators.py b/llm/Lib/site-packages/jsonschema/validators.py
new file mode 100644
index 0000000000000000000000000000000000000000..fefbe832c4be5e861d13fb518f451f0b638a249e
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema/validators.py
@@ -0,0 +1,1387 @@
+"""
+Creation and extension of validators, with implementations for existing drafts.
+"""
+from __future__ import annotations
+
+from collections import deque
+from collections.abc import Iterable, Mapping, Sequence
+from functools import lru_cache
+from operator import methodcaller
+from typing import TYPE_CHECKING
+from urllib.parse import unquote, urldefrag, urljoin, urlsplit
+from urllib.request import urlopen
+from warnings import warn
+import contextlib
+import json
+import reprlib
+import warnings
+
+from attrs import define, field, fields
+from jsonschema_specifications import REGISTRY as SPECIFICATIONS
+from rpds import HashTrieMap
+import referencing.exceptions
+import referencing.jsonschema
+
+from jsonschema import (
+    _format,
+    _keywords,
+    _legacy_keywords,
+    _types,
+    _typing,
+    _utils,
+    exceptions,
+)
+
+if TYPE_CHECKING:
+    from jsonschema.protocols import Validator
+
+_UNSET = _utils.Unset()
+
+_VALIDATORS: dict[str, Validator] = {}
+_META_SCHEMAS = _utils.URIDict()
+
+
+def __getattr__(name):
+    if name == "ErrorTree":
+        warnings.warn(
+            "Importing ErrorTree from jsonschema.validators is deprecated. "
+            "Instead import it from jsonschema.exceptions.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        from jsonschema.exceptions import ErrorTree
+        return ErrorTree
+    elif name == "validators":
+        warnings.warn(
+            "Accessing jsonschema.validators.validators is deprecated. "
+            "Use jsonschema.validators.validator_for with a given schema.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return _VALIDATORS
+    elif name == "meta_schemas":
+        warnings.warn(
+            "Accessing jsonschema.validators.meta_schemas is deprecated. "
+            "Use jsonschema.validators.validator_for with a given schema.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return _META_SCHEMAS
+    elif name == "RefResolver":
+        warnings.warn(
+            _RefResolver._DEPRECATION_MESSAGE,
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return _RefResolver
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+def validates(version):
+    """
+    Register the decorated validator for a ``version`` of the specification.
+
+    Registered validators and their meta schemas will be considered when
+    parsing :kw:`$schema` keywords' URIs.
+
+    Arguments:
+
+        version (str):
+
+            An identifier to use as the version's name
+
+    Returns:
+
+        collections.abc.Callable:
+
+            a class decorator to decorate the validator with the version
+    """
+
+    def _validates(cls):
+        _VALIDATORS[version] = cls
+        meta_schema_id = cls.ID_OF(cls.META_SCHEMA)
+        _META_SCHEMAS[meta_schema_id] = cls
+        return cls
+    return _validates
+
+
+def _warn_for_remote_retrieve(uri: str):
+    from urllib.request import Request, urlopen
+    headers = {"User-Agent": "python-jsonschema (deprecated $ref resolution)"}
+    request = Request(uri, headers=headers)  # noqa: S310
+    with urlopen(request) as response:  # noqa: S310
+        warnings.warn(
+            "Automatically retrieving remote references can be a security "
+            "vulnerability and is discouraged by the JSON Schema "
+            "specifications. Relying on this behavior is deprecated "
+            "and will shortly become an error. If you are sure you want to "
+            "remotely retrieve your reference and that it is safe to do so, "
+            "you can find instructions for doing so via referencing.Registry "
+            "in the referencing documentation "
+            "(https://referencing.readthedocs.org).",
+            DeprecationWarning,
+            stacklevel=9,  # Ha ha ha ha magic numbers :/
+        )
+        return referencing.Resource.from_contents(
+            json.load(response),
+            default_specification=referencing.jsonschema.DRAFT202012,
+        )
+
+
+_REMOTE_WARNING_REGISTRY = SPECIFICATIONS.combine(
+    referencing.Registry(retrieve=_warn_for_remote_retrieve),  # type: ignore[call-arg]
+)
+
+
+def create(
+    meta_schema: referencing.jsonschema.ObjectSchema,
+    validators: (
+        Mapping[str, _typing.SchemaKeywordValidator]
+        | Iterable[tuple[str, _typing.SchemaKeywordValidator]]
+    ) = (),
+    version: str | None = None,
+    type_checker: _types.TypeChecker = _types.draft202012_type_checker,
+    format_checker: _format.FormatChecker = _format.draft202012_format_checker,
+    id_of: _typing.id_of = referencing.jsonschema.DRAFT202012.id_of,
+    applicable_validators: _typing.ApplicableValidators = methodcaller(
+        "items",
+    ),
+):
+    """
+    Create a new validator class.
+
+    Arguments:
+
+        meta_schema:
+
+            the meta schema for the new validator class
+
+        validators:
+
+            a mapping from names to callables, where each callable will
+            validate the schema property with the given name.
+
+            Each callable should take 4 arguments:
+
+                1. a validator instance,
+                2. the value of the property being validated within the
+                   instance
+                3. the instance
+                4. the schema
+
+        version:
+
+            an identifier for the version that this validator class will
+            validate. If provided, the returned validator class will
+            have its ``__name__`` set to include the version, and also
+            will have `jsonschema.validators.validates` automatically
+            called for the given version.
+
+        type_checker:
+
+            a type checker, used when applying the :kw:`type` keyword.
+
+            If unprovided, a `jsonschema.TypeChecker` will be created
+            with a set of default types typical of JSON Schema drafts.
+
+        format_checker:
+
+            a format checker, used when applying the :kw:`format` keyword.
+
+            If unprovided, a `jsonschema.FormatChecker` will be created
+            with a set of default formats typical of JSON Schema drafts.
+
+        id_of:
+
+            A function that given a schema, returns its ID.
+
+        applicable_validators:
+
+            A function that, given a schema, returns the list of
+            applicable schema keywords and associated values
+            which will be used to validate the instance.
+            This is mostly used to support pre-draft 7 versions of JSON Schema
+            which specified behavior around ignoring keywords if they were
+            siblings of a ``$ref`` keyword. If you're not attempting to
+            implement similar behavior, you can typically ignore this argument
+            and leave it at its default.
+
+    Returns:
+
+        a new `jsonschema.protocols.Validator` class
+    """
+    # preemptively don't shadow the `Validator.format_checker` local
+    format_checker_arg = format_checker
+
+    specification = referencing.jsonschema.specification_with(
+        dialect_id=id_of(meta_schema) or "urn:unknown-dialect",
+        default=referencing.Specification.OPAQUE,
+    )
+
+    @define
+    class Validator:
+
+        VALIDATORS = dict(validators)  # noqa: RUF012
+        META_SCHEMA = dict(meta_schema)  # noqa: RUF012
+        TYPE_CHECKER = type_checker
+        FORMAT_CHECKER = format_checker_arg
+        ID_OF = staticmethod(id_of)
+
+        _APPLICABLE_VALIDATORS = applicable_validators
+
+        schema: referencing.jsonschema.Schema = field(repr=reprlib.repr)
+        _ref_resolver = field(default=None, repr=False, alias="resolver")
+        format_checker: _format.FormatChecker | None = field(default=None)
+        # TODO: include new meta-schemas added at runtime
+        _registry: referencing.jsonschema.SchemaRegistry = field(
+            default=_REMOTE_WARNING_REGISTRY,
+            kw_only=True,
+            repr=False,
+        )
+        _resolver = field(
+            alias="_resolver",
+            default=None,
+            kw_only=True,
+            repr=False,
+        )
+
+        def __init_subclass__(cls):
+            warnings.warn(
+                (
+                    "Subclassing validator classes is not intended to "
+                    "be part of their public API. A future version "
+                    "will make doing so an error, as the behavior of "
+                    "subclasses isn't guaranteed to stay the same "
+                    "between releases of jsonschema. Instead, prefer "
+                    "composition of validators, wrapping them in an object "
+                    "owned entirely by the downstream library."
+                ),
+                DeprecationWarning,
+                stacklevel=2,
+            )
+
+            def evolve(self, **changes):
+                cls = self.__class__
+                schema = changes.setdefault("schema", self.schema)
+                NewValidator = validator_for(schema, default=cls)
+
+                for field in fields(cls):  # noqa: F402
+                    if not field.init:
+                        continue
+                    attr_name = field.name
+                    init_name = field.alias
+                    if init_name not in changes:
+                        changes[init_name] = getattr(self, attr_name)
+
+                return NewValidator(**changes)
+
+            cls.evolve = evolve
+
+        def __attrs_post_init__(self):
+            if self._resolver is None:
+                registry = self._registry
+                if registry is not _REMOTE_WARNING_REGISTRY:
+                    registry = SPECIFICATIONS.combine(registry)
+                resource = specification.create_resource(self.schema)
+                self._resolver = registry.resolver_with_root(resource)
+
+            # REMOVEME: Legacy ref resolution state management.
+            push_scope = getattr(self._ref_resolver, "push_scope", None)
+            if push_scope is not None:
+                id = id_of(self.schema)
+                if id is not None:
+                    push_scope(id)
+
+        @classmethod
+        def check_schema(cls, schema, format_checker=_UNSET):
+            Validator = validator_for(cls.META_SCHEMA, default=cls)
+            if format_checker is _UNSET:
+                format_checker = Validator.FORMAT_CHECKER
+            validator = Validator(
+                schema=cls.META_SCHEMA,
+                format_checker=format_checker,
+            )
+            for error in validator.iter_errors(schema):
+                raise exceptions.SchemaError.create_from(error)
+
+        @property
+        def resolver(self):
+            warnings.warn(
+                (
+                    f"Accessing {self.__class__.__name__}.resolver is "
+                    "deprecated as of v4.18.0, in favor of the "
+                    "https://github.com/python-jsonschema/referencing "
+                    "library, which provides more compliant referencing "
+                    "behavior as well as more flexible APIs for "
+                    "customization."
+                ),
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            if self._ref_resolver is None:
+                self._ref_resolver = _RefResolver.from_schema(
+                    self.schema,
+                    id_of=id_of,
+                )
+            return self._ref_resolver
+
+        def evolve(self, **changes):
+            schema = changes.setdefault("schema", self.schema)
+            NewValidator = validator_for(schema, default=self.__class__)
+
+            for (attr_name, init_name) in evolve_fields:
+                if init_name not in changes:
+                    changes[init_name] = getattr(self, attr_name)
+
+            return NewValidator(**changes)
+
+        def iter_errors(self, instance, _schema=None):
+            if _schema is not None:
+                warnings.warn(
+                    (
+                        "Passing a schema to Validator.iter_errors "
+                        "is deprecated and will be removed in a future "
+                        "release. Call validator.evolve(schema=new_schema)."
+                        "iter_errors(...) instead."
+                    ),
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+            else:
+                _schema = self.schema
+
+            if _schema is True:
+                return
+            elif _schema is False:
+                yield exceptions.ValidationError(
+                    f"False schema does not allow {instance!r}",
+                    validator=None,
+                    validator_value=None,
+                    instance=instance,
+                    schema=_schema,
+                )
+                return
+
+            for k, v in applicable_validators(_schema):
+                validator = self.VALIDATORS.get(k)
+                if validator is None:
+                    continue
+
+                errors = validator(self, v, instance, _schema) or ()
+                for error in errors:
+                    # set details if not already set by the called fn
+                    error._set(
+                        validator=k,
+                        validator_value=v,
+                        instance=instance,
+                        schema=_schema,
+                        type_checker=self.TYPE_CHECKER,
+                    )
+                    if k not in {"if", "$ref"}:
+                        error.schema_path.appendleft(k)
+                    yield error
+
+        def descend(
+            self,
+            instance,
+            schema,
+            path=None,
+            schema_path=None,
+            resolver=None,
+        ):
+            if schema is True:
+                return
+            elif schema is False:
+                yield exceptions.ValidationError(
+                    f"False schema does not allow {instance!r}",
+                    validator=None,
+                    validator_value=None,
+                    instance=instance,
+                    schema=schema,
+                )
+                return
+
+            if self._ref_resolver is not None:
+                evolved = self.evolve(schema=schema)
+            else:
+                if resolver is None:
+                    resolver = self._resolver.in_subresource(
+                        specification.create_resource(schema),
+                    )
+                evolved = self.evolve(schema=schema, _resolver=resolver)
+
+            for k, v in applicable_validators(schema):
+                validator = evolved.VALIDATORS.get(k)
+                if validator is None:
+                    continue
+
+                errors = validator(evolved, v, instance, schema) or ()
+                for error in errors:
+                    # set details if not already set by the called fn
+                    error._set(
+                        validator=k,
+                        validator_value=v,
+                        instance=instance,
+                        schema=schema,
+                        type_checker=evolved.TYPE_CHECKER,
+                    )
+                    if k not in {"if", "$ref"}:
+                        error.schema_path.appendleft(k)
+                    if path is not None:
+                        error.path.appendleft(path)
+                    if schema_path is not None:
+                        error.schema_path.appendleft(schema_path)
+                    yield error
+
+        def validate(self, *args, **kwargs):
+            for error in self.iter_errors(*args, **kwargs):
+                raise error
+
+        def is_type(self, instance, type):
+            try:
+                return self.TYPE_CHECKER.is_type(instance, type)
+            except exceptions.UndefinedTypeCheck:
+                exc = exceptions.UnknownType(type, instance, self.schema)
+                raise exc from None
+
+        def _validate_reference(self, ref, instance):
+            if self._ref_resolver is None:
+                try:
+                    resolved = self._resolver.lookup(ref)
+                except referencing.exceptions.Unresolvable as err:
+                    raise exceptions._WrappedReferencingError(err) from err
+
+                return self.descend(
+                    instance,
+                    resolved.contents,
+                    resolver=resolved.resolver,
+                )
+            else:
+                resolve = getattr(self._ref_resolver, "resolve", None)
+                if resolve is None:
+                    with self._ref_resolver.resolving(ref) as resolved:
+                        return self.descend(instance, resolved)
+                else:
+                    scope, resolved = resolve(ref)
+                    self._ref_resolver.push_scope(scope)
+
+                    try:
+                        return list(self.descend(instance, resolved))
+                    finally:
+                        self._ref_resolver.pop_scope()
+
+        def is_valid(self, instance, _schema=None):
+            if _schema is not None:
+                warnings.warn(
+                    (
+                        "Passing a schema to Validator.is_valid is deprecated "
+                        "and will be removed in a future release. Call "
+                        "validator.evolve(schema=new_schema).is_valid(...) "
+                        "instead."
+                    ),
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+                self = self.evolve(schema=_schema)
+
+            error = next(self.iter_errors(instance), None)
+            return error is None
+
+    evolve_fields = [
+        (field.name, field.alias)
+        for field in fields(Validator)
+        if field.init
+    ]
+
+    if version is not None:
+        safe = version.title().replace(" ", "").replace("-", "")
+        Validator.__name__ = Validator.__qualname__ = f"{safe}Validator"
+        Validator = validates(version)(Validator)  # type: ignore[misc]
+
+    return Validator
+
+
+def extend(
+    validator,
+    validators=(),
+    version=None,
+    type_checker=None,
+    format_checker=None,
+):
+    """
+    Create a new validator class by extending an existing one.
+
+    Arguments:
+
+        validator (jsonschema.protocols.Validator):
+
+            an existing validator class
+
+        validators (collections.abc.Mapping):
+
+            a mapping of new validator callables to extend with, whose
+            structure is as in `create`.
+
+            .. note::
+
+                Any validator callables with the same name as an
+                existing one will (silently) replace the old validator
+                callable entirely, effectively overriding any validation
+                done in the "parent" validator class.
+
+                If you wish to instead extend the behavior of a parent's
+                validator callable, delegate and call it directly in
+                the new validator function by retrieving it using
+                ``OldValidator.VALIDATORS["validation_keyword_name"]``.
+
+        version (str):
+
+            a version for the new validator class
+
+        type_checker (jsonschema.TypeChecker):
+
+            a type checker, used when applying the :kw:`type` keyword.
+
+            If unprovided, the type checker of the extended
+            `jsonschema.protocols.Validator` will be carried along.
+
+        format_checker (jsonschema.FormatChecker):
+
+            a format checker, used when applying the :kw:`format` keyword.
+
+            If unprovided, the format checker of the extended
+            `jsonschema.protocols.Validator` will be carried along.
+
+    Returns:
+
+        a new `jsonschema.protocols.Validator` class extending the one
+        provided
+
+    .. note:: Meta Schemas
+
+        The new validator class will have its parent's meta schema.
+
+        If you wish to change or extend the meta schema in the new
+        validator class, modify ``META_SCHEMA`` directly on the returned
+        class. Note that no implicit copying is done, so a copy should
+        likely be made before modifying it, in order to not affect the
+        old validator.
+    """
+    all_validators = dict(validator.VALIDATORS)
+    all_validators.update(validators)
+
+    if type_checker is None:
+        type_checker = validator.TYPE_CHECKER
+    if format_checker is None:
+        format_checker = validator.FORMAT_CHECKER
+    return create(
+        meta_schema=validator.META_SCHEMA,
+        validators=all_validators,
+        version=version,
+        type_checker=type_checker,
+        format_checker=format_checker,
+        id_of=validator.ID_OF,
+        applicable_validators=validator._APPLICABLE_VALIDATORS,
+    )
+
+
+Draft3Validator = create(
+    meta_schema=SPECIFICATIONS.contents(
+        "http://json-schema.org/draft-03/schema#",
+    ),
+    validators={
+        "$ref": _keywords.ref,
+        "additionalItems": _legacy_keywords.additionalItems,
+        "additionalProperties": _keywords.additionalProperties,
+        "dependencies": _legacy_keywords.dependencies_draft3,
+        "disallow": _legacy_keywords.disallow_draft3,
+        "divisibleBy": _keywords.multipleOf,
+        "enum": _keywords.enum,
+        "extends": _legacy_keywords.extends_draft3,
+        "format": _keywords.format,
+        "items": _legacy_keywords.items_draft3_draft4,
+        "maxItems": _keywords.maxItems,
+        "maxLength": _keywords.maxLength,
+        "maximum": _legacy_keywords.maximum_draft3_draft4,
+        "minItems": _keywords.minItems,
+        "minLength": _keywords.minLength,
+        "minimum": _legacy_keywords.minimum_draft3_draft4,
+        "pattern": _keywords.pattern,
+        "patternProperties": _keywords.patternProperties,
+        "properties": _legacy_keywords.properties_draft3,
+        "type": _legacy_keywords.type_draft3,
+        "uniqueItems": _keywords.uniqueItems,
+    },
+    type_checker=_types.draft3_type_checker,
+    format_checker=_format.draft3_format_checker,
+    version="draft3",
+    id_of=referencing.jsonschema.DRAFT3.id_of,
+    applicable_validators=_legacy_keywords.ignore_ref_siblings,
+)
+
+Draft4Validator = create(
+    meta_schema=SPECIFICATIONS.contents(
+        "http://json-schema.org/draft-04/schema#",
+    ),
+    validators={
+        "$ref": _keywords.ref,
+        "additionalItems": _legacy_keywords.additionalItems,
+        "additionalProperties": _keywords.additionalProperties,
+        "allOf": _keywords.allOf,
+        "anyOf": _keywords.anyOf,
+        "dependencies": _legacy_keywords.dependencies_draft4_draft6_draft7,
+        "enum": _keywords.enum,
+        "format": _keywords.format,
+        "items": _legacy_keywords.items_draft3_draft4,
+        "maxItems": _keywords.maxItems,
+        "maxLength": _keywords.maxLength,
+        "maxProperties": _keywords.maxProperties,
+        "maximum": _legacy_keywords.maximum_draft3_draft4,
+        "minItems": _keywords.minItems,
+        "minLength": _keywords.minLength,
+        "minProperties": _keywords.minProperties,
+        "minimum": _legacy_keywords.minimum_draft3_draft4,
+        "multipleOf": _keywords.multipleOf,
+        "not": _keywords.not_,
+        "oneOf": _keywords.oneOf,
+        "pattern": _keywords.pattern,
+        "patternProperties": _keywords.patternProperties,
+        "properties": _keywords.properties,
+        "required": _keywords.required,
+        "type": _keywords.type,
+        "uniqueItems": _keywords.uniqueItems,
+    },
+    type_checker=_types.draft4_type_checker,
+    format_checker=_format.draft4_format_checker,
+    version="draft4",
+    id_of=referencing.jsonschema.DRAFT4.id_of,
+    applicable_validators=_legacy_keywords.ignore_ref_siblings,
+)
+
+Draft6Validator = create(
+    meta_schema=SPECIFICATIONS.contents(
+        "http://json-schema.org/draft-06/schema#",
+    ),
+    validators={
+        "$ref": _keywords.ref,
+        "additionalItems": _legacy_keywords.additionalItems,
+        "additionalProperties": _keywords.additionalProperties,
+        "allOf": _keywords.allOf,
+        "anyOf": _keywords.anyOf,
+        "const": _keywords.const,
+        "contains": _legacy_keywords.contains_draft6_draft7,
+        "dependencies": _legacy_keywords.dependencies_draft4_draft6_draft7,
+        "enum": _keywords.enum,
+        "exclusiveMaximum": _keywords.exclusiveMaximum,
+        "exclusiveMinimum": _keywords.exclusiveMinimum,
+        "format": _keywords.format,
+        "items": _legacy_keywords.items_draft6_draft7_draft201909,
+        "maxItems": _keywords.maxItems,
+        "maxLength": _keywords.maxLength,
+        "maxProperties": _keywords.maxProperties,
+        "maximum": _keywords.maximum,
+        "minItems": _keywords.minItems,
+        "minLength": _keywords.minLength,
+        "minProperties": _keywords.minProperties,
+        "minimum": _keywords.minimum,
+        "multipleOf": _keywords.multipleOf,
+        "not": _keywords.not_,
+        "oneOf": _keywords.oneOf,
+        "pattern": _keywords.pattern,
+        "patternProperties": _keywords.patternProperties,
+        "properties": _keywords.properties,
+        "propertyNames": _keywords.propertyNames,
+        "required": _keywords.required,
+        "type": _keywords.type,
+        "uniqueItems": _keywords.uniqueItems,
+    },
+    type_checker=_types.draft6_type_checker,
+    format_checker=_format.draft6_format_checker,
+    version="draft6",
+    id_of=referencing.jsonschema.DRAFT6.id_of,
+    applicable_validators=_legacy_keywords.ignore_ref_siblings,
+)
+
+Draft7Validator = create(
+    meta_schema=SPECIFICATIONS.contents(
+        "http://json-schema.org/draft-07/schema#",
+    ),
+    validators={
+        "$ref": _keywords.ref,
+        "additionalItems": _legacy_keywords.additionalItems,
+        "additionalProperties": _keywords.additionalProperties,
+        "allOf": _keywords.allOf,
+        "anyOf": _keywords.anyOf,
+        "const": _keywords.const,
+        "contains": _legacy_keywords.contains_draft6_draft7,
+        "dependencies": _legacy_keywords.dependencies_draft4_draft6_draft7,
+        "enum": _keywords.enum,
+        "exclusiveMaximum": _keywords.exclusiveMaximum,
+        "exclusiveMinimum": _keywords.exclusiveMinimum,
+        "format": _keywords.format,
+        "if": _keywords.if_,
+        "items": _legacy_keywords.items_draft6_draft7_draft201909,
+        "maxItems": _keywords.maxItems,
+        "maxLength": _keywords.maxLength,
+        "maxProperties": _keywords.maxProperties,
+        "maximum": _keywords.maximum,
+        "minItems": _keywords.minItems,
+        "minLength": _keywords.minLength,
+        "minProperties": _keywords.minProperties,
+        "minimum": _keywords.minimum,
+        "multipleOf": _keywords.multipleOf,
+        "not": _keywords.not_,
+        "oneOf": _keywords.oneOf,
+        "pattern": _keywords.pattern,
+        "patternProperties": _keywords.patternProperties,
+        "properties": _keywords.properties,
+        "propertyNames": _keywords.propertyNames,
+        "required": _keywords.required,
+        "type": _keywords.type,
+        "uniqueItems": _keywords.uniqueItems,
+    },
+    type_checker=_types.draft7_type_checker,
+    format_checker=_format.draft7_format_checker,
+    version="draft7",
+    id_of=referencing.jsonschema.DRAFT7.id_of,
+    applicable_validators=_legacy_keywords.ignore_ref_siblings,
+)
+
+Draft201909Validator = create(
+    meta_schema=SPECIFICATIONS.contents(
+        "https://json-schema.org/draft/2019-09/schema",
+    ),
+    validators={
+        "$recursiveRef": _legacy_keywords.recursiveRef,
+        "$ref": _keywords.ref,
+        "additionalItems": _legacy_keywords.additionalItems,
+        "additionalProperties": _keywords.additionalProperties,
+        "allOf": _keywords.allOf,
+        "anyOf": _keywords.anyOf,
+        "const": _keywords.const,
+        "contains": _keywords.contains,
+        "dependentRequired": _keywords.dependentRequired,
+        "dependentSchemas": _keywords.dependentSchemas,
+        "enum": _keywords.enum,
+        "exclusiveMaximum": _keywords.exclusiveMaximum,
+        "exclusiveMinimum": _keywords.exclusiveMinimum,
+        "format": _keywords.format,
+        "if": _keywords.if_,
+        "items": _legacy_keywords.items_draft6_draft7_draft201909,
+        "maxItems": _keywords.maxItems,
+        "maxLength": _keywords.maxLength,
+        "maxProperties": _keywords.maxProperties,
+        "maximum": _keywords.maximum,
+        "minItems": _keywords.minItems,
+        "minLength": _keywords.minLength,
+        "minProperties": _keywords.minProperties,
+        "minimum": _keywords.minimum,
+        "multipleOf": _keywords.multipleOf,
+        "not": _keywords.not_,
+        "oneOf": _keywords.oneOf,
+        "pattern": _keywords.pattern,
+        "patternProperties": _keywords.patternProperties,
+        "properties": _keywords.properties,
+        "propertyNames": _keywords.propertyNames,
+        "required": _keywords.required,
+        "type": _keywords.type,
+        "unevaluatedItems": _legacy_keywords.unevaluatedItems_draft2019,
+        "unevaluatedProperties": (
+            _legacy_keywords.unevaluatedProperties_draft2019
+        ),
+        "uniqueItems": _keywords.uniqueItems,
+    },
+    type_checker=_types.draft201909_type_checker,
+    format_checker=_format.draft201909_format_checker,
+    version="draft2019-09",
+)
+
+Draft202012Validator = create(
+    meta_schema=SPECIFICATIONS.contents(
+        "https://json-schema.org/draft/2020-12/schema",
+    ),
+    validators={
+        "$dynamicRef": _keywords.dynamicRef,
+        "$ref": _keywords.ref,
+        "additionalProperties": _keywords.additionalProperties,
+        "allOf": _keywords.allOf,
+        "anyOf": _keywords.anyOf,
+        "const": _keywords.const,
+        "contains": _keywords.contains,
+        "dependentRequired": _keywords.dependentRequired,
+        "dependentSchemas": _keywords.dependentSchemas,
+        "enum": _keywords.enum,
+        "exclusiveMaximum": _keywords.exclusiveMaximum,
+        "exclusiveMinimum": _keywords.exclusiveMinimum,
+        "format": _keywords.format,
+        "if": _keywords.if_,
+        "items": _keywords.items,
+        "maxItems": _keywords.maxItems,
+        "maxLength": _keywords.maxLength,
+        "maxProperties": _keywords.maxProperties,
+        "maximum": _keywords.maximum,
+        "minItems": _keywords.minItems,
+        "minLength": _keywords.minLength,
+        "minProperties": _keywords.minProperties,
+        "minimum": _keywords.minimum,
+        "multipleOf": _keywords.multipleOf,
+        "not": _keywords.not_,
+        "oneOf": _keywords.oneOf,
+        "pattern": _keywords.pattern,
+        "patternProperties": _keywords.patternProperties,
+        "prefixItems": _keywords.prefixItems,
+        "properties": _keywords.properties,
+        "propertyNames": _keywords.propertyNames,
+        "required": _keywords.required,
+        "type": _keywords.type,
+        "unevaluatedItems": _keywords.unevaluatedItems,
+        "unevaluatedProperties": _keywords.unevaluatedProperties,
+        "uniqueItems": _keywords.uniqueItems,
+    },
+    type_checker=_types.draft202012_type_checker,
+    format_checker=_format.draft202012_format_checker,
+    version="draft2020-12",
+)
+
+_LATEST_VERSION = Draft202012Validator
+
+
+class _RefResolver:
+    """
+    Resolve JSON References.
+
+    Arguments:
+
+        base_uri (str):
+
+            The URI of the referring document
+
+        referrer:
+
+            The actual referring document
+
+        store (dict):
+
+            A mapping from URIs to documents to cache
+
+        cache_remote (bool):
+
+            Whether remote refs should be cached after first resolution
+
+        handlers (dict):
+
+            A mapping from URI schemes to functions that should be used
+            to retrieve them
+
+        urljoin_cache (:func:`functools.lru_cache`):
+
+            A cache that will be used for caching the results of joining
+            the resolution scope to subscopes.
+
+        remote_cache (:func:`functools.lru_cache`):
+
+            A cache that will be used for caching the results of
+            resolved remote URLs.
+
+    Attributes:
+
+        cache_remote (bool):
+
+            Whether remote refs should be cached after first resolution
+
+    .. deprecated:: v4.18.0
+
+        ``RefResolver`` has been deprecated in favor of `referencing`.
+    """
+
+    _DEPRECATION_MESSAGE = (
+        "jsonschema.RefResolver is deprecated as of v4.18.0, in favor of the "
+        "https://github.com/python-jsonschema/referencing library, which "
+        "provides more compliant referencing behavior as well as more "
+        "flexible APIs for customization. A future release will remove "
+        "RefResolver. Please file a feature request (on referencing) if you "
+        "are missing an API for the kind of customization you need."
+    )
+
+    def __init__(
+        self,
+        base_uri,
+        referrer,
+        store=HashTrieMap(),
+        cache_remote=True,
+        handlers=(),
+        urljoin_cache=None,
+        remote_cache=None,
+    ):
+        if urljoin_cache is None:
+            urljoin_cache = lru_cache(1024)(urljoin)
+        if remote_cache is None:
+            remote_cache = lru_cache(1024)(self.resolve_from_url)
+
+        self.referrer = referrer
+        self.cache_remote = cache_remote
+        self.handlers = dict(handlers)
+
+        self._scopes_stack = [base_uri]
+
+        self.store = _utils.URIDict(
+            (uri, each.contents) for uri, each in SPECIFICATIONS.items()
+        )
+        self.store.update(
+            (id, each.META_SCHEMA) for id, each in _META_SCHEMAS.items()
+        )
+        self.store.update(store)
+        self.store.update(
+            (schema["$id"], schema)
+            for schema in store.values()
+            if isinstance(schema, Mapping) and "$id" in schema
+        )
+        self.store[base_uri] = referrer
+
+        self._urljoin_cache = urljoin_cache
+        self._remote_cache = remote_cache
+
+    @classmethod
+    def from_schema(  # noqa: D417
+        cls,
+        schema,
+        id_of=referencing.jsonschema.DRAFT202012.id_of,
+        *args,
+        **kwargs,
+    ):
+        """
+        Construct a resolver from a JSON schema object.
+
+        Arguments:
+
+            schema:
+
+                the referring schema
+
+        Returns:
+
+            `_RefResolver`
+        """
+        return cls(base_uri=id_of(schema) or "", referrer=schema, *args, **kwargs)  # noqa: B026, E501
+
+    def push_scope(self, scope):
+        """
+        Enter a given sub-scope.
+
+        Treats further dereferences as being performed underneath the
+        given scope.
+        """
+        self._scopes_stack.append(
+            self._urljoin_cache(self.resolution_scope, scope),
+        )
+
+    def pop_scope(self):
+        """
+        Exit the most recent entered scope.
+
+        Treats further dereferences as being performed underneath the
+        original scope.
+
+        Don't call this method more times than `push_scope` has been
+        called.
+        """
+        try:
+            self._scopes_stack.pop()
+        except IndexError:
+            raise exceptions._RefResolutionError(
+                "Failed to pop the scope from an empty stack. "
+                "`pop_scope()` should only be called once for every "
+                "`push_scope()`",
+            ) from None
+
+    @property
+    def resolution_scope(self):
+        """
+        Retrieve the current resolution scope.
+        """
+        return self._scopes_stack[-1]
+
+    @property
+    def base_uri(self):
+        """
+        Retrieve the current base URI, not including any fragment.
+        """
+        uri, _ = urldefrag(self.resolution_scope)
+        return uri
+
+    @contextlib.contextmanager
+    def in_scope(self, scope):
+        """
+        Temporarily enter the given scope for the duration of the context.
+
+        .. deprecated:: v4.0.0
+        """
+        warnings.warn(
+            "jsonschema.RefResolver.in_scope is deprecated and will be "
+            "removed in a future release.",
+            DeprecationWarning,
+            stacklevel=3,
+        )
+        self.push_scope(scope)
+        try:
+            yield
+        finally:
+            self.pop_scope()
+
+    @contextlib.contextmanager
+    def resolving(self, ref):
+        """
+        Resolve the given ``ref`` and enter its resolution scope.
+
+        Exits the scope on exit of this context manager.
+
+        Arguments:
+
+            ref (str):
+
+                The reference to resolve
+        """
+        url, resolved = self.resolve(ref)
+        self.push_scope(url)
+        try:
+            yield resolved
+        finally:
+            self.pop_scope()
+
+    def _find_in_referrer(self, key):
+        return self._get_subschemas_cache()[key]
+
+    @lru_cache  # noqa: B019
+    def _get_subschemas_cache(self):
+        cache = {key: [] for key in _SUBSCHEMAS_KEYWORDS}
+        for keyword, subschema in _search_schema(
+            self.referrer, _match_subschema_keywords,
+        ):
+            cache[keyword].append(subschema)
+        return cache
+
+    @lru_cache  # noqa: B019
+    def _find_in_subschemas(self, url):
+        subschemas = self._get_subschemas_cache()["$id"]
+        if not subschemas:
+            return None
+        uri, fragment = urldefrag(url)
+        for subschema in subschemas:
+            id = subschema["$id"]
+            if not isinstance(id, str):
+                continue
+            target_uri = self._urljoin_cache(self.resolution_scope, id)
+            if target_uri.rstrip("/") == uri.rstrip("/"):
+                if fragment:
+                    subschema = self.resolve_fragment(subschema, fragment)
+                self.store[url] = subschema
+                return url, subschema
+        return None
+
+    def resolve(self, ref):
+        """
+        Resolve the given reference.
+        """
+        url = self._urljoin_cache(self.resolution_scope, ref).rstrip("/")
+
+        match = self._find_in_subschemas(url)
+        if match is not None:
+            return match
+
+        return url, self._remote_cache(url)
+
+    def resolve_from_url(self, url):
+        """
+        Resolve the given URL.
+        """
+        url, fragment = urldefrag(url)
+        if not url:
+            url = self.base_uri
+
+        try:
+            document = self.store[url]
+        except KeyError:
+            try:
+                document = self.resolve_remote(url)
+            except Exception as exc:  # noqa: BLE001
+                raise exceptions._RefResolutionError(exc) from exc
+
+        return self.resolve_fragment(document, fragment)
+
+    def resolve_fragment(self, document, fragment):
+        """
+        Resolve a ``fragment`` within the referenced ``document``.
+
+        Arguments:
+
+            document:
+
+                The referent document
+
+            fragment (str):
+
+                a URI fragment to resolve within it
+        """
+        fragment = fragment.lstrip("/")
+
+        if not fragment:
+            return document
+
+        if document is self.referrer:
+            find = self._find_in_referrer
+        else:
+
+            def find(key):
+                yield from _search_schema(document, _match_keyword(key))
+
+        for keyword in ["$anchor", "$dynamicAnchor"]:
+            for subschema in find(keyword):
+                if fragment == subschema[keyword]:
+                    return subschema
+        for keyword in ["id", "$id"]:
+            for subschema in find(keyword):
+                if "#" + fragment == subschema[keyword]:
+                    return subschema
+
+        # Resolve via path
+        parts = unquote(fragment).split("/") if fragment else []
+        for part in parts:
+            part = part.replace("~1", "/").replace("~0", "~")
+
+            if isinstance(document, Sequence):
+                try:  # noqa: SIM105
+                    part = int(part)
+                except ValueError:
+                    pass
+            try:
+                document = document[part]
+            except (TypeError, LookupError) as err:
+                raise exceptions._RefResolutionError(
+                    f"Unresolvable JSON pointer: {fragment!r}",
+                ) from err
+
+        return document
+
+    def resolve_remote(self, uri):
+        """
+        Resolve a remote ``uri``.
+
+        If called directly, does not check the store first, but after
+        retrieving the document at the specified URI it will be saved in
+        the store if :attr:`cache_remote` is True.
+
+        .. note::
+
+            If the requests_ library is present, ``jsonschema`` will use it to
+            request the remote ``uri``, so that the correct encoding is
+            detected and used.
+
+            If it isn't, or if the scheme of the ``uri`` is not ``http`` or
+            ``https``, UTF-8 is assumed.
+
+        Arguments:
+
+            uri (str):
+
+                The URI to resolve
+
+        Returns:
+
+            The retrieved document
+
+        .. _requests: https://pypi.org/project/requests/
+        """
+        try:
+            import requests
+        except ImportError:
+            requests = None
+
+        scheme = urlsplit(uri).scheme
+
+        if scheme in self.handlers:
+            result = self.handlers[scheme](uri)
+        elif scheme in ["http", "https"] and requests:
+            # Requests has support for detecting the correct encoding of
+            # json over http
+            result = requests.get(uri).json()
+        else:
+            # Otherwise, pass off to urllib and assume utf-8
+            with urlopen(uri) as url:  # noqa: S310
+                result = json.loads(url.read().decode("utf-8"))
+
+        if self.cache_remote:
+            self.store[uri] = result
+        return result
+
+
+_SUBSCHEMAS_KEYWORDS = ("$id", "id", "$anchor", "$dynamicAnchor")
+
+
+def _match_keyword(keyword):
+
+    def matcher(value):
+        if keyword in value:
+            yield value
+
+    return matcher
+
+
+def _match_subschema_keywords(value):
+    for keyword in _SUBSCHEMAS_KEYWORDS:
+        if keyword in value:
+            yield keyword, value
+
+
+def _search_schema(schema, matcher):
+    """Breadth-first search routine."""
+    values = deque([schema])
+    while values:
+        value = values.pop()
+        if not isinstance(value, dict):
+            continue
+        yield from matcher(value)
+        values.extendleft(value.values())
+
+
+def validate(instance, schema, cls=None, *args, **kwargs):  # noqa: D417
+    """
+    Validate an instance under the given schema.
+
+        >>> validate([2, 3, 4], {"maxItems": 2})
+        Traceback (most recent call last):
+            ...
+        ValidationError: [2, 3, 4] is too long
+
+    :func:`~jsonschema.validators.validate` will first verify that the
+    provided schema is itself valid, since not doing so can lead to less
+    obvious error messages and fail in less obvious or consistent ways.
+
+    If you know you have a valid schema already, especially
+    if you intend to validate multiple instances with
+    the same schema, you likely would prefer using the
+    `jsonschema.protocols.Validator.validate` method directly on a
+    specific validator (e.g. ``Draft202012Validator.validate``).
+
+
+    Arguments:
+
+        instance:
+
+            The instance to validate
+
+        schema:
+
+            The schema to validate with
+
+        cls (jsonschema.protocols.Validator):
+
+            The class that will be used to validate the instance.
+
+    If the ``cls`` argument is not provided, two things will happen
+    in accordance with the specification. First, if the schema has a
+    :kw:`$schema` keyword containing a known meta-schema [#]_ then the
+    proper validator will be used. The specification recommends that
+    all schemas contain :kw:`$schema` properties for this reason. If no
+    :kw:`$schema` property is found, the default validator class is the
+    latest released draft.
+
+    Any other provided positional and keyword arguments will be passed
+    on when instantiating the ``cls``.
+
+    Raises:
+
+        `jsonschema.exceptions.ValidationError`:
+
+            if the instance is invalid
+
+        `jsonschema.exceptions.SchemaError`:
+
+            if the schema itself is invalid
+
+    .. rubric:: Footnotes
+    .. [#] known by a validator registered with
+        `jsonschema.validators.validates`
+    """
+    if cls is None:
+        cls = validator_for(schema)
+
+    cls.check_schema(schema)
+    validator = cls(schema, *args, **kwargs)
+    error = exceptions.best_match(validator.iter_errors(instance))
+    if error is not None:
+        raise error
+
+
+def validator_for(schema, default=_UNSET) -> Validator:
+    """
+    Retrieve the validator class appropriate for validating the given schema.
+
+    Uses the :kw:`$schema` keyword that should be present in the given
+    schema to look up the appropriate validator class.
+
+    Arguments:
+
+        schema (collections.abc.Mapping or bool):
+
+            the schema to look at
+
+        default:
+
+            the default to return if the appropriate validator class
+            cannot be determined.
+
+            If unprovided, the default is to return the latest supported
+            draft.
+
+    Examples:
+
+        The :kw:`$schema` JSON Schema keyword will control which validator
+        class is returned:
+
+        >>> schema = {
+        ...     "$schema": "https://json-schema.org/draft/2020-12/schema",
+        ...     "type": "integer",
+        ... }
+        >>> jsonschema.validators.validator_for(schema)
+        <class 'jsonschema.validators.Draft202012Validator'>
+
+
+        Here, a draft 7 schema instead will return the draft 7 validator:
+
+        >>> schema = {
+        ...     "$schema": "http://json-schema.org/draft-07/schema#",
+        ...     "type": "integer",
+        ... }
+        >>> jsonschema.validators.validator_for(schema)
+        <class 'jsonschema.validators.Draft7Validator'>
+
+
+        Schemas with no ``$schema`` keyword will fallback to the default
+        argument:
+
+        >>> schema = {"type": "integer"}
+        >>> jsonschema.validators.validator_for(
+        ...     schema, default=Draft7Validator,
+        ... )
+        <class 'jsonschema.validators.Draft7Validator'>
+
+        or if none is provided, to the latest version supported.
+        Always including the keyword when authoring schemas is highly
+        recommended.
+
+    """
+    DefaultValidator = _LATEST_VERSION if default is _UNSET else default
+
+    if schema is True or schema is False or "$schema" not in schema:
+        return DefaultValidator
+    if schema["$schema"] not in _META_SCHEMAS and default is _UNSET:
+        warn(
+            (
+                "The metaschema specified by $schema was not found. "
+                "Using the latest draft to validate, but this will raise "
+                "an error in the future."
+            ),
+            DeprecationWarning,
+            stacklevel=2,
+        )
+    return _META_SCHEMAS.get(schema["$schema"], DefaultValidator)
diff --git a/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/INSTALLER b/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/METADATA b/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..f1797d2936cf2617628cef303b44e544e7a05377
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/METADATA
@@ -0,0 +1,56 @@
+Metadata-Version: 2.1
+Name: jsonschema-specifications
+Version: 2023.12.1
+Summary: The JSON Schema meta-schemas and vocabularies, exposed as a Registry
+Project-URL: Documentation, https://jsonschema-specifications.readthedocs.io/
+Project-URL: Homepage, https://github.com/python-jsonschema/jsonschema-specifications
+Project-URL: Issues, https://github.com/python-jsonschema/jsonschema-specifications/issues/
+Project-URL: Funding, https://github.com/sponsors/Julian
+Project-URL: Tidelift, https://tidelift.com/subscription/pkg/pypi-jsonschema-specifications?utm_source=pypi-jsonschema-specifications&utm_medium=referral&utm_campaign=pypi-link
+Project-URL: Source, https://github.com/python-jsonschema/jsonschema-specifications
+Author: Julian Berman
+Author-email: Julian+jsonschema-specifications@GrayVines.com
+License: MIT
+License-File: COPYING
+Keywords: data validation,json,json schema,jsonschema,validation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: File Formats :: JSON :: JSON Schema
+Requires-Python: >=3.8
+Requires-Dist: importlib-resources>=1.4.0; python_version < '3.9'
+Requires-Dist: referencing>=0.31.0
+Description-Content-Type: text/x-rst
+
+=============================
+``jsonschema-specifications``
+=============================
+
+|PyPI| |Pythons| |CI| |ReadTheDocs|
+
+JSON support files from the `JSON Schema Specifications <https://json-schema.org/specification.html>`_ (metaschemas, vocabularies, etc.), packaged for runtime access from Python as a `referencing-based Schema Registry <https://referencing.readthedocs.io/en/stable/api/#referencing.Registry>`_.
+
+.. |PyPI| image:: https://img.shields.io/pypi/v/jsonschema-specifications.svg
+  :alt: PyPI version
+  :target: https://pypi.org/project/jsonschema-specifications/
+
+.. |Pythons| image:: https://img.shields.io/pypi/pyversions/jsonschema-specifications.svg
+  :alt: Supported Python versions
+  :target: https://pypi.org/project/jsonschema-specifications/
+
+.. |CI| image:: https://github.com/python-jsonschema/jsonschema-specifications/workflows/CI/badge.svg
+  :alt: Build status
+  :target: https://github.com/python-jsonschema/jsonschema-specifications/actions?query=workflow%3ACI
+
+.. |ReadTheDocs| image:: https://readthedocs.org/projects/jsonschema-specifications/badge/?version=stable&style=flat
+  :alt: ReadTheDocs status
+  :target: https://jsonschema-specifications.readthedocs.io/en/stable/
diff --git a/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/RECORD b/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..b231d5f6ba75263b04bcc78def3e5119ad429baf
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/RECORD
@@ -0,0 +1,33 @@
+jsonschema_specifications-2023.12.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+jsonschema_specifications-2023.12.1.dist-info/METADATA,sha256=fnTxmkgaHmLZ2WGJ1erA8FSWtQmx1wB3tpnalxBQ2C0,2977
+jsonschema_specifications-2023.12.1.dist-info/RECORD,,
+jsonschema_specifications-2023.12.1.dist-info/WHEEL,sha256=mRYSEL3Ih6g5a_CVMIcwiF__0Ae4_gLYh01YFNwiq1k,87
+jsonschema_specifications-2023.12.1.dist-info/licenses/COPYING,sha256=QtzWNJX4e063x3V6-jebtVpT-Ur9el9lfZrfVyNuUVw,1057
+jsonschema_specifications/__init__.py,sha256=XmYAMRnPbRv_oidAvNZyoOttwYAvBdqr77ouDD32ZXE,385
+jsonschema_specifications/__pycache__/__init__.cpython-311.pyc,,
+jsonschema_specifications/__pycache__/_core.cpython-311.pyc,,
+jsonschema_specifications/_core.py,sha256=tFhc1CMleJ3AJOK_bjxOpFQTdrsUClFGfFxPBU_CebM,1140
+jsonschema_specifications/schemas/draft201909/metaschema.json,sha256=e3YbPhIfCgyh6ioLjizIVrz4AWBLgmjXG6yqICvAwTs,1785
+jsonschema_specifications/schemas/draft201909/vocabularies/applicator,sha256=aJUQDplyb7sQcFhRK77D7P1LJOj9L6zuPlBe5ysNTDE,1860
+jsonschema_specifications/schemas/draft201909/vocabularies/content,sha256=m31PVaTi_bAsQwBo_f-rxzKt3OI42j8d8mkCScM1MnQ,517
+jsonschema_specifications/schemas/draft201909/vocabularies/core,sha256=taLElX9kldClCB8ECevooU5BOayyA_x0hHH47eKvWyw,1531
+jsonschema_specifications/schemas/draft201909/vocabularies/meta-data,sha256=1H4kRd1qgicaKY2DzGxsuNSuHhXg3Fa-zTehY-zwEoY,892
+jsonschema_specifications/schemas/draft201909/vocabularies/validation,sha256=HlJsHTNac0gF_ILPV5jBK5YK19olF8Zs2lobCTWcPBw,2834
+jsonschema_specifications/schemas/draft202012/metaschema.json,sha256=Qdp29a-3zgYtJI92JGOpL3ykfk4PkFsiS6av7vkd7Q8,2452
+jsonschema_specifications/schemas/draft202012/vocabularies/applicator,sha256=xKbkFHuR_vf-ptwFjLG_k0AvdBS3ZXiosWqvHa1qrO8,1659
+jsonschema_specifications/schemas/draft202012/vocabularies/content,sha256=CDQ3R3ZOSlgUJieTz01lIFenkThjxZUNQyl-jh_axbY,519
+jsonschema_specifications/schemas/draft202012/vocabularies/core,sha256=wtEqjk3RHTNt_IOj9mOqTGnwtJs76wlP_rJbUxb0gD0,1564
+jsonschema_specifications/schemas/draft202012/vocabularies/format,sha256=UOu_55BhGoSbjMQAoJwdDg-2q1wNQ6DyIgH9NiUFa_Q,403
+jsonschema_specifications/schemas/draft202012/vocabularies/format-annotation,sha256=q8d1rf79idIjWBcNm_k_Tr0jSVY7u-3WDwK-98gSvMA,448
+jsonschema_specifications/schemas/draft202012/vocabularies/format-assertion,sha256=xSJCuaG7eGsmw-gset1CjDH5yW5XXc6Z5W6l_qptogw,445
+jsonschema_specifications/schemas/draft202012/vocabularies/meta-data,sha256=j3bW4U9Bubku-TO3CM3FFEyLUmhlGtEZGEhfsXVPHHY,892
+jsonschema_specifications/schemas/draft202012/vocabularies/unevaluated,sha256=Lb-8tzmUtnCwl2SSre4f_7RsIWgnhNL1pMpWH54tDLQ,506
+jsonschema_specifications/schemas/draft202012/vocabularies/validation,sha256=cBCjHlQfMtK-ch4t40jfdcmzaHaj7TBId_wKvaHTelg,2834
+jsonschema_specifications/schemas/draft3/metaschema.json,sha256=LPdfZENvtb43Si6qJ6uLfh_WUcm0ba6mxnsC_WTiRYs,2600
+jsonschema_specifications/schemas/draft4/metaschema.json,sha256=4UidC0dV8CeTMCWR0_y48Htok6gqlPJIlfjk7fEbguI,4357
+jsonschema_specifications/schemas/draft6/metaschema.json,sha256=wp386fVINcOgbAOzxdXsDtp3cGVo-cTffPvHVmpRAG0,4437
+jsonschema_specifications/schemas/draft7/metaschema.json,sha256=PVOSCIJhYGxVm2A_OFMpyfGrRbXWZ-uZBodFOwVdQF4,4819
+jsonschema_specifications/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+jsonschema_specifications/tests/__pycache__/__init__.cpython-311.pyc,,
+jsonschema_specifications/tests/__pycache__/test_jsonschema_specifications.cpython-311.pyc,,
+jsonschema_specifications/tests/test_jsonschema_specifications.py,sha256=WkbYRW6A6FoZ0rivShfqVLSCsAiHJ2x8TxqECJTXPTY,1106
diff --git a/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/WHEEL b/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..2860816abecb3c5ad7da6d018a4334b87e6b6cfc
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.21.0
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/licenses/COPYING b/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/licenses/COPYING
new file mode 100644
index 0000000000000000000000000000000000000000..a9f853e43069b8e3f8a156a4af2b1198a004230d
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications-2023.12.1.dist-info/licenses/COPYING
@@ -0,0 +1,19 @@
+Copyright (c) 2022 Julian Berman
+
+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
+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.
diff --git a/llm/Lib/site-packages/jsonschema_specifications/__init__.py b/llm/Lib/site-packages/jsonschema_specifications/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..98b6b3902f11af1dd087bc5826bf4b4c53520783
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/__init__.py
@@ -0,0 +1,11 @@
+"""
+The JSON Schema meta-schemas and vocabularies, exposed as a Registry.
+"""
+from referencing.jsonschema import EMPTY_REGISTRY as _EMPTY_REGISTRY
+
+from jsonschema_specifications._core import _schemas
+
+#: A `referencing.jsonschema.SchemaRegistry` containing all of the official
+#: meta-schemas and vocabularies.
+REGISTRY = (_schemas() @ _EMPTY_REGISTRY).crawl()
+__all__ = ["REGISTRY"]
diff --git a/llm/Lib/site-packages/jsonschema_specifications/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/jsonschema_specifications/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6d78ed922d73bfe6b8a5447f76e4d21d30475c14
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema_specifications/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema_specifications/__pycache__/_core.cpython-311.pyc b/llm/Lib/site-packages/jsonschema_specifications/__pycache__/_core.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cf236f9990e2648d19797198998e6add2c129e55
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema_specifications/__pycache__/_core.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema_specifications/_core.py b/llm/Lib/site-packages/jsonschema_specifications/_core.py
new file mode 100644
index 0000000000000000000000000000000000000000..e67bd712b3732f20ec353ba1d8b5c806fad2c74a
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/_core.py
@@ -0,0 +1,38 @@
+"""
+Load all the JSON Schema specification's official schemas.
+"""
+
+import json
+
+try:
+    from importlib.resources import files
+except ImportError:
+    from importlib_resources import (  # type: ignore[import-not-found, no-redef]
+        files,
+    )
+
+from referencing import Resource
+
+
+def _schemas():
+    """
+    All schemas we ship.
+    """
+    # importlib.resources.abc.Traversal doesn't have nice ways to do this that
+    # I'm aware of...
+    #
+    # It can't recurse arbitrarily, e.g. no ``.glob()``.
+    #
+    # So this takes some liberties given the real layout of what we ship
+    # (only 2 levels of nesting, no directories within the second level).
+
+    for version in files(__package__).joinpath("schemas").iterdir():
+        if version.name.startswith("."):
+            continue
+        for child in version.iterdir():
+            children = [child] if child.is_file() else child.iterdir()
+            for path in children:
+                if path.name.startswith("."):
+                    continue
+                contents = json.loads(path.read_text(encoding="utf-8"))
+                yield Resource.from_contents(contents)
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/metaschema.json b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/metaschema.json
new file mode 100644
index 0000000000000000000000000000000000000000..2248a0c80bbfc51b67863f848f60466f135cdb2b
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/metaschema.json
@@ -0,0 +1,42 @@
+{
+    "$schema": "https://json-schema.org/draft/2019-09/schema",
+    "$id": "https://json-schema.org/draft/2019-09/schema",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2019-09/vocab/core": true,
+        "https://json-schema.org/draft/2019-09/vocab/applicator": true,
+        "https://json-schema.org/draft/2019-09/vocab/validation": true,
+        "https://json-schema.org/draft/2019-09/vocab/meta-data": true,
+        "https://json-schema.org/draft/2019-09/vocab/format": false,
+        "https://json-schema.org/draft/2019-09/vocab/content": true
+    },
+    "$recursiveAnchor": true,
+
+    "title": "Core and Validation specifications meta-schema",
+    "allOf": [
+        {"$ref": "meta/core"},
+        {"$ref": "meta/applicator"},
+        {"$ref": "meta/validation"},
+        {"$ref": "meta/meta-data"},
+        {"$ref": "meta/format"},
+        {"$ref": "meta/content"}
+    ],
+    "type": ["object", "boolean"],
+    "properties": {
+        "definitions": {
+            "$comment": "While no longer an official keyword as it is replaced by $defs, this keyword is retained in the meta-schema to prevent incompatible extensions as it remains in common use.",
+            "type": "object",
+            "additionalProperties": { "$recursiveRef": "#" },
+            "default": {}
+        },
+        "dependencies": {
+            "$comment": "\"dependencies\" is no longer a keyword, but schema authors should avoid redefining it to facilitate a smooth transition to \"dependentSchemas\" and \"dependentRequired\"",
+            "type": "object",
+            "additionalProperties": {
+                "anyOf": [
+                    { "$recursiveRef": "#" },
+                    { "$ref": "meta/validation#/$defs/stringArray" }
+                ]
+            }
+        }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/applicator b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/applicator
new file mode 100644
index 0000000000000000000000000000000000000000..24a1cc4f4f54b5a556de93c2799853b31e78e512
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/applicator
@@ -0,0 +1,56 @@
+{
+    "$schema": "https://json-schema.org/draft/2019-09/schema",
+    "$id": "https://json-schema.org/draft/2019-09/meta/applicator",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2019-09/vocab/applicator": true
+    },
+    "$recursiveAnchor": true,
+
+    "title": "Applicator vocabulary meta-schema",
+    "type": ["object", "boolean"],
+    "properties": {
+        "additionalItems": { "$recursiveRef": "#" },
+        "unevaluatedItems": { "$recursiveRef": "#" },
+        "items": {
+            "anyOf": [
+                { "$recursiveRef": "#" },
+                { "$ref": "#/$defs/schemaArray" }
+            ]
+        },
+        "contains": { "$recursiveRef": "#" },
+        "additionalProperties": { "$recursiveRef": "#" },
+        "unevaluatedProperties": { "$recursiveRef": "#" },
+        "properties": {
+            "type": "object",
+            "additionalProperties": { "$recursiveRef": "#" },
+            "default": {}
+        },
+        "patternProperties": {
+            "type": "object",
+            "additionalProperties": { "$recursiveRef": "#" },
+            "propertyNames": { "format": "regex" },
+            "default": {}
+        },
+        "dependentSchemas": {
+            "type": "object",
+            "additionalProperties": {
+                "$recursiveRef": "#"
+            }
+        },
+        "propertyNames": { "$recursiveRef": "#" },
+        "if": { "$recursiveRef": "#" },
+        "then": { "$recursiveRef": "#" },
+        "else": { "$recursiveRef": "#" },
+        "allOf": { "$ref": "#/$defs/schemaArray" },
+        "anyOf": { "$ref": "#/$defs/schemaArray" },
+        "oneOf": { "$ref": "#/$defs/schemaArray" },
+        "not": { "$recursiveRef": "#" }
+    },
+    "$defs": {
+        "schemaArray": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$recursiveRef": "#" }
+        }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/content b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/content
new file mode 100644
index 0000000000000000000000000000000000000000..f6752a8efbeb74a7b7b2e74cbb272c422a975363
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/content
@@ -0,0 +1,17 @@
+{
+    "$schema": "https://json-schema.org/draft/2019-09/schema",
+    "$id": "https://json-schema.org/draft/2019-09/meta/content",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2019-09/vocab/content": true
+    },
+    "$recursiveAnchor": true,
+
+    "title": "Content vocabulary meta-schema",
+
+    "type": ["object", "boolean"],
+    "properties": {
+        "contentMediaType": { "type": "string" },
+        "contentEncoding": { "type": "string" },
+        "contentSchema": { "$recursiveRef": "#" }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/core b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/core
new file mode 100644
index 0000000000000000000000000000000000000000..eb708a56044146bb7903fd59159725a0c693aefe
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/core
@@ -0,0 +1,57 @@
+{
+    "$schema": "https://json-schema.org/draft/2019-09/schema",
+    "$id": "https://json-schema.org/draft/2019-09/meta/core",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2019-09/vocab/core": true
+    },
+    "$recursiveAnchor": true,
+
+    "title": "Core vocabulary meta-schema",
+    "type": ["object", "boolean"],
+    "properties": {
+        "$id": {
+            "type": "string",
+            "format": "uri-reference",
+            "$comment": "Non-empty fragments not allowed.",
+            "pattern": "^[^#]*#?$"
+        },
+        "$schema": {
+            "type": "string",
+            "format": "uri"
+        },
+        "$anchor": {
+            "type": "string",
+            "pattern": "^[A-Za-z][-A-Za-z0-9.:_]*$"
+        },
+        "$ref": {
+            "type": "string",
+            "format": "uri-reference"
+        },
+        "$recursiveRef": {
+            "type": "string",
+            "format": "uri-reference"
+        },
+        "$recursiveAnchor": {
+            "type": "boolean",
+            "default": false
+        },
+        "$vocabulary": {
+            "type": "object",
+            "propertyNames": {
+                "type": "string",
+                "format": "uri"
+            },
+            "additionalProperties": {
+                "type": "boolean"
+            }
+        },
+        "$comment": {
+            "type": "string"
+        },
+        "$defs": {
+            "type": "object",
+            "additionalProperties": { "$recursiveRef": "#" },
+            "default": {}
+        }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/meta-data b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/meta-data
new file mode 100644
index 0000000000000000000000000000000000000000..da04cff6d346f26bfe5bd21b636609fecd583628
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/meta-data
@@ -0,0 +1,37 @@
+{
+    "$schema": "https://json-schema.org/draft/2019-09/schema",
+    "$id": "https://json-schema.org/draft/2019-09/meta/meta-data",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2019-09/vocab/meta-data": true
+    },
+    "$recursiveAnchor": true,
+
+    "title": "Meta-data vocabulary meta-schema",
+
+    "type": ["object", "boolean"],
+    "properties": {
+        "title": {
+            "type": "string"
+        },
+        "description": {
+            "type": "string"
+        },
+        "default": true,
+        "deprecated": {
+            "type": "boolean",
+            "default": false
+        },
+        "readOnly": {
+            "type": "boolean",
+            "default": false
+        },
+        "writeOnly": {
+            "type": "boolean",
+            "default": false
+        },
+        "examples": {
+            "type": "array",
+            "items": true
+        }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/validation b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/validation
new file mode 100644
index 0000000000000000000000000000000000000000..9f59677b30c238f07a358c0c8ee72c3b710dc24d
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/validation
@@ -0,0 +1,98 @@
+{
+    "$schema": "https://json-schema.org/draft/2019-09/schema",
+    "$id": "https://json-schema.org/draft/2019-09/meta/validation",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2019-09/vocab/validation": true
+    },
+    "$recursiveAnchor": true,
+
+    "title": "Validation vocabulary meta-schema",
+    "type": ["object", "boolean"],
+    "properties": {
+        "multipleOf": {
+            "type": "number",
+            "exclusiveMinimum": 0
+        },
+        "maximum": {
+            "type": "number"
+        },
+        "exclusiveMaximum": {
+            "type": "number"
+        },
+        "minimum": {
+            "type": "number"
+        },
+        "exclusiveMinimum": {
+            "type": "number"
+        },
+        "maxLength": { "$ref": "#/$defs/nonNegativeInteger" },
+        "minLength": { "$ref": "#/$defs/nonNegativeIntegerDefault0" },
+        "pattern": {
+            "type": "string",
+            "format": "regex"
+        },
+        "maxItems": { "$ref": "#/$defs/nonNegativeInteger" },
+        "minItems": { "$ref": "#/$defs/nonNegativeIntegerDefault0" },
+        "uniqueItems": {
+            "type": "boolean",
+            "default": false
+        },
+        "maxContains": { "$ref": "#/$defs/nonNegativeInteger" },
+        "minContains": {
+            "$ref": "#/$defs/nonNegativeInteger",
+            "default": 1
+        },
+        "maxProperties": { "$ref": "#/$defs/nonNegativeInteger" },
+        "minProperties": { "$ref": "#/$defs/nonNegativeIntegerDefault0" },
+        "required": { "$ref": "#/$defs/stringArray" },
+        "dependentRequired": {
+            "type": "object",
+            "additionalProperties": {
+                "$ref": "#/$defs/stringArray"
+            }
+        },
+        "const": true,
+        "enum": {
+            "type": "array",
+            "items": true
+        },
+        "type": {
+            "anyOf": [
+                { "$ref": "#/$defs/simpleTypes" },
+                {
+                    "type": "array",
+                    "items": { "$ref": "#/$defs/simpleTypes" },
+                    "minItems": 1,
+                    "uniqueItems": true
+                }
+            ]
+        }
+    },
+    "$defs": {
+        "nonNegativeInteger": {
+            "type": "integer",
+            "minimum": 0
+        },
+        "nonNegativeIntegerDefault0": {
+            "$ref": "#/$defs/nonNegativeInteger",
+            "default": 0
+        },
+        "simpleTypes": {
+            "enum": [
+                "array",
+                "boolean",
+                "integer",
+                "null",
+                "number",
+                "object",
+                "string"
+            ]
+        },
+        "stringArray": {
+            "type": "array",
+            "items": { "type": "string" },
+            "uniqueItems": true,
+            "default": []
+        }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/metaschema.json b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/metaschema.json
new file mode 100644
index 0000000000000000000000000000000000000000..d5e2d31c3c88e61f4c204cb6616887bba7e105dd
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/metaschema.json
@@ -0,0 +1,58 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://json-schema.org/draft/2020-12/schema",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2020-12/vocab/core": true,
+        "https://json-schema.org/draft/2020-12/vocab/applicator": true,
+        "https://json-schema.org/draft/2020-12/vocab/unevaluated": true,
+        "https://json-schema.org/draft/2020-12/vocab/validation": true,
+        "https://json-schema.org/draft/2020-12/vocab/meta-data": true,
+        "https://json-schema.org/draft/2020-12/vocab/format-annotation": true,
+        "https://json-schema.org/draft/2020-12/vocab/content": true
+    },
+    "$dynamicAnchor": "meta",
+
+    "title": "Core and Validation specifications meta-schema",
+    "allOf": [
+        {"$ref": "meta/core"},
+        {"$ref": "meta/applicator"},
+        {"$ref": "meta/unevaluated"},
+        {"$ref": "meta/validation"},
+        {"$ref": "meta/meta-data"},
+        {"$ref": "meta/format-annotation"},
+        {"$ref": "meta/content"}
+    ],
+    "type": ["object", "boolean"],
+    "$comment": "This meta-schema also defines keywords that have appeared in previous drafts in order to prevent incompatible extensions as they remain in common use.",
+    "properties": {
+        "definitions": {
+            "$comment": "\"definitions\" has been replaced by \"$defs\".",
+            "type": "object",
+            "additionalProperties": { "$dynamicRef": "#meta" },
+            "deprecated": true,
+            "default": {}
+        },
+        "dependencies": {
+            "$comment": "\"dependencies\" has been split and replaced by \"dependentSchemas\" and \"dependentRequired\" in order to serve their differing semantics.",
+            "type": "object",
+            "additionalProperties": {
+                "anyOf": [
+                    { "$dynamicRef": "#meta" },
+                    { "$ref": "meta/validation#/$defs/stringArray" }
+                ]
+            },
+            "deprecated": true,
+            "default": {}
+        },
+        "$recursiveAnchor": {
+            "$comment": "\"$recursiveAnchor\" has been replaced by \"$dynamicAnchor\".",
+            "$ref": "meta/core#/$defs/anchorString",
+            "deprecated": true
+        },
+        "$recursiveRef": {
+            "$comment": "\"$recursiveRef\" has been replaced by \"$dynamicRef\".",
+            "$ref": "meta/core#/$defs/uriReferenceString",
+            "deprecated": true
+        }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/applicator b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/applicator
new file mode 100644
index 0000000000000000000000000000000000000000..ca69923096f3a2e4fe5eb8152a92d87d146cf021
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/applicator
@@ -0,0 +1,48 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://json-schema.org/draft/2020-12/meta/applicator",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2020-12/vocab/applicator": true
+    },
+    "$dynamicAnchor": "meta",
+
+    "title": "Applicator vocabulary meta-schema",
+    "type": ["object", "boolean"],
+    "properties": {
+        "prefixItems": { "$ref": "#/$defs/schemaArray" },
+        "items": { "$dynamicRef": "#meta" },
+        "contains": { "$dynamicRef": "#meta" },
+        "additionalProperties": { "$dynamicRef": "#meta" },
+        "properties": {
+            "type": "object",
+            "additionalProperties": { "$dynamicRef": "#meta" },
+            "default": {}
+        },
+        "patternProperties": {
+            "type": "object",
+            "additionalProperties": { "$dynamicRef": "#meta" },
+            "propertyNames": { "format": "regex" },
+            "default": {}
+        },
+        "dependentSchemas": {
+            "type": "object",
+            "additionalProperties": { "$dynamicRef": "#meta" },
+            "default": {}
+        },
+        "propertyNames": { "$dynamicRef": "#meta" },
+        "if": { "$dynamicRef": "#meta" },
+        "then": { "$dynamicRef": "#meta" },
+        "else": { "$dynamicRef": "#meta" },
+        "allOf": { "$ref": "#/$defs/schemaArray" },
+        "anyOf": { "$ref": "#/$defs/schemaArray" },
+        "oneOf": { "$ref": "#/$defs/schemaArray" },
+        "not": { "$dynamicRef": "#meta" }
+    },
+    "$defs": {
+        "schemaArray": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$dynamicRef": "#meta" }
+        }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/content b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/content
new file mode 100644
index 0000000000000000000000000000000000000000..2f6e056a9ac2399582eaf05985a26acf9161f213
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/content
@@ -0,0 +1,17 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://json-schema.org/draft/2020-12/meta/content",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2020-12/vocab/content": true
+    },
+    "$dynamicAnchor": "meta",
+
+    "title": "Content vocabulary meta-schema",
+
+    "type": ["object", "boolean"],
+    "properties": {
+        "contentEncoding": { "type": "string" },
+        "contentMediaType": { "type": "string" },
+        "contentSchema": { "$dynamicRef": "#meta" }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/core b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/core
new file mode 100644
index 0000000000000000000000000000000000000000..dfc092d9646e1ea89e4d771bfcf2a4ca87eeac75
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/core
@@ -0,0 +1,51 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://json-schema.org/draft/2020-12/meta/core",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2020-12/vocab/core": true
+    },
+    "$dynamicAnchor": "meta",
+
+    "title": "Core vocabulary meta-schema",
+    "type": ["object", "boolean"],
+    "properties": {
+        "$id": {
+            "$ref": "#/$defs/uriReferenceString",
+            "$comment": "Non-empty fragments not allowed.",
+            "pattern": "^[^#]*#?$"
+        },
+        "$schema": { "$ref": "#/$defs/uriString" },
+        "$ref": { "$ref": "#/$defs/uriReferenceString" },
+        "$anchor": { "$ref": "#/$defs/anchorString" },
+        "$dynamicRef": { "$ref": "#/$defs/uriReferenceString" },
+        "$dynamicAnchor": { "$ref": "#/$defs/anchorString" },
+        "$vocabulary": {
+            "type": "object",
+            "propertyNames": { "$ref": "#/$defs/uriString" },
+            "additionalProperties": {
+                "type": "boolean"
+            }
+        },
+        "$comment": {
+            "type": "string"
+        },
+        "$defs": {
+            "type": "object",
+            "additionalProperties": { "$dynamicRef": "#meta" }
+        }
+    },
+    "$defs": {
+        "anchorString": {
+            "type": "string",
+            "pattern": "^[A-Za-z_][-A-Za-z0-9._]*$"
+        },
+        "uriString": {
+            "type": "string",
+            "format": "uri"
+        },
+        "uriReferenceString": {
+            "type": "string",
+            "format": "uri-reference"
+        }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/format b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/format
new file mode 100644
index 0000000000000000000000000000000000000000..09bbfdda972ca77cd26e290d70ab59db4bbe8a27
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/format
@@ -0,0 +1,14 @@
+{
+    "$schema": "https://json-schema.org/draft/2019-09/schema",
+    "$id": "https://json-schema.org/draft/2019-09/meta/format",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2019-09/vocab/format": true
+    },
+    "$recursiveAnchor": true,
+
+    "title": "Format vocabulary meta-schema",
+    "type": ["object", "boolean"],
+    "properties": {
+        "format": { "type": "string" }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/format-annotation b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/format-annotation
new file mode 100644
index 0000000000000000000000000000000000000000..51ef7ea118c34e8ac3da66c973bae02b9e8325d8
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/format-annotation
@@ -0,0 +1,14 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://json-schema.org/draft/2020-12/meta/format-annotation",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2020-12/vocab/format-annotation": true
+    },
+    "$dynamicAnchor": "meta",
+
+    "title": "Format vocabulary meta-schema for annotation results",
+    "type": ["object", "boolean"],
+    "properties": {
+        "format": { "type": "string" }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/format-assertion b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/format-assertion
new file mode 100644
index 0000000000000000000000000000000000000000..5e73fd7571e504990f7a055da960056f07dcdb19
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/format-assertion
@@ -0,0 +1,14 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://json-schema.org/draft/2020-12/meta/format-assertion",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2020-12/vocab/format-assertion": true
+    },
+    "$dynamicAnchor": "meta",
+
+    "title": "Format vocabulary meta-schema for assertion results",
+    "type": ["object", "boolean"],
+    "properties": {
+        "format": { "type": "string" }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/meta-data b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/meta-data
new file mode 100644
index 0000000000000000000000000000000000000000..05cbc22afde5ebe6ba84957ca412277bde1e4b08
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/meta-data
@@ -0,0 +1,37 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://json-schema.org/draft/2020-12/meta/meta-data",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2020-12/vocab/meta-data": true
+    },
+    "$dynamicAnchor": "meta",
+
+    "title": "Meta-data vocabulary meta-schema",
+
+    "type": ["object", "boolean"],
+    "properties": {
+        "title": {
+            "type": "string"
+        },
+        "description": {
+            "type": "string"
+        },
+        "default": true,
+        "deprecated": {
+            "type": "boolean",
+            "default": false
+        },
+        "readOnly": {
+            "type": "boolean",
+            "default": false
+        },
+        "writeOnly": {
+            "type": "boolean",
+            "default": false
+        },
+        "examples": {
+            "type": "array",
+            "items": true
+        }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/unevaluated b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/unevaluated
new file mode 100644
index 0000000000000000000000000000000000000000..5f62a3ffa20be07dc813d6b8a154fa8451d0dc61
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/unevaluated
@@ -0,0 +1,15 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://json-schema.org/draft/2020-12/meta/unevaluated",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2020-12/vocab/unevaluated": true
+    },
+    "$dynamicAnchor": "meta",
+
+    "title": "Unevaluated applicator vocabulary meta-schema",
+    "type": ["object", "boolean"],
+    "properties": {
+        "unevaluatedItems": { "$dynamicRef": "#meta" },
+        "unevaluatedProperties": { "$dynamicRef": "#meta" }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/validation b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/validation
new file mode 100644
index 0000000000000000000000000000000000000000..606b87ba2ec213d63b9e2035a6acc4edcb4b8357
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/validation
@@ -0,0 +1,98 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://json-schema.org/draft/2020-12/meta/validation",
+    "$vocabulary": {
+        "https://json-schema.org/draft/2020-12/vocab/validation": true
+    },
+    "$dynamicAnchor": "meta",
+
+    "title": "Validation vocabulary meta-schema",
+    "type": ["object", "boolean"],
+    "properties": {
+        "type": {
+            "anyOf": [
+                { "$ref": "#/$defs/simpleTypes" },
+                {
+                    "type": "array",
+                    "items": { "$ref": "#/$defs/simpleTypes" },
+                    "minItems": 1,
+                    "uniqueItems": true
+                }
+            ]
+        },
+        "const": true,
+        "enum": {
+            "type": "array",
+            "items": true
+        },
+        "multipleOf": {
+            "type": "number",
+            "exclusiveMinimum": 0
+        },
+        "maximum": {
+            "type": "number"
+        },
+        "exclusiveMaximum": {
+            "type": "number"
+        },
+        "minimum": {
+            "type": "number"
+        },
+        "exclusiveMinimum": {
+            "type": "number"
+        },
+        "maxLength": { "$ref": "#/$defs/nonNegativeInteger" },
+        "minLength": { "$ref": "#/$defs/nonNegativeIntegerDefault0" },
+        "pattern": {
+            "type": "string",
+            "format": "regex"
+        },
+        "maxItems": { "$ref": "#/$defs/nonNegativeInteger" },
+        "minItems": { "$ref": "#/$defs/nonNegativeIntegerDefault0" },
+        "uniqueItems": {
+            "type": "boolean",
+            "default": false
+        },
+        "maxContains": { "$ref": "#/$defs/nonNegativeInteger" },
+        "minContains": {
+            "$ref": "#/$defs/nonNegativeInteger",
+            "default": 1
+        },
+        "maxProperties": { "$ref": "#/$defs/nonNegativeInteger" },
+        "minProperties": { "$ref": "#/$defs/nonNegativeIntegerDefault0" },
+        "required": { "$ref": "#/$defs/stringArray" },
+        "dependentRequired": {
+            "type": "object",
+            "additionalProperties": {
+                "$ref": "#/$defs/stringArray"
+            }
+        }
+    },
+    "$defs": {
+        "nonNegativeInteger": {
+            "type": "integer",
+            "minimum": 0
+        },
+        "nonNegativeIntegerDefault0": {
+            "$ref": "#/$defs/nonNegativeInteger",
+            "default": 0
+        },
+        "simpleTypes": {
+            "enum": [
+                "array",
+                "boolean",
+                "integer",
+                "null",
+                "number",
+                "object",
+                "string"
+            ]
+        },
+        "stringArray": {
+            "type": "array",
+            "items": { "type": "string" },
+            "uniqueItems": true,
+            "default": []
+        }
+    }
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft3/metaschema.json b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft3/metaschema.json
new file mode 100644
index 0000000000000000000000000000000000000000..8b26b1f89f9852e4f69f466dd7d718b21ba5b989
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft3/metaschema.json
@@ -0,0 +1,172 @@
+{
+	"$schema" : "http://json-schema.org/draft-03/schema#",
+	"id" : "http://json-schema.org/draft-03/schema#",
+	"type" : "object",
+
+	"properties" : {
+		"type" : {
+			"type" : ["string", "array"],
+			"items" : {
+				"type" : ["string", {"$ref" : "#"}]
+			},
+			"uniqueItems" : true,
+			"default" : "any"
+		},
+
+		"properties" : {
+			"type" : "object",
+			"additionalProperties" : {"$ref" : "#"},
+			"default" : {}
+		},
+
+		"patternProperties" : {
+			"type" : "object",
+			"additionalProperties" : {"$ref" : "#"},
+			"default" : {}
+		},
+
+		"additionalProperties" : {
+			"type" : [{"$ref" : "#"}, "boolean"],
+			"default" : {}
+		},
+
+		"items" : {
+			"type" : [{"$ref" : "#"}, "array"],
+			"items" : {"$ref" : "#"},
+			"default" : {}
+		},
+
+		"additionalItems" : {
+			"type" : [{"$ref" : "#"}, "boolean"],
+			"default" : {}
+		},
+
+		"required" : {
+			"type" : "boolean",
+			"default" : false
+		},
+
+		"dependencies" : {
+			"type" : "object",
+			"additionalProperties" : {
+				"type" : ["string", "array", {"$ref" : "#"}],
+				"items" : {
+					"type" : "string"
+				}
+			},
+			"default" : {}
+		},
+
+		"minimum" : {
+			"type" : "number"
+		},
+
+		"maximum" : {
+			"type" : "number"
+		},
+
+		"exclusiveMinimum" : {
+			"type" : "boolean",
+			"default" : false
+		},
+
+		"exclusiveMaximum" : {
+			"type" : "boolean",
+			"default" : false
+		},
+
+		"minItems" : {
+			"type" : "integer",
+			"minimum" : 0,
+			"default" : 0
+		},
+
+		"maxItems" : {
+			"type" : "integer",
+			"minimum" : 0
+		},
+
+		"uniqueItems" : {
+			"type" : "boolean",
+			"default" : false
+		},
+
+		"pattern" : {
+			"type" : "string",
+			"format" : "regex"
+		},
+
+		"minLength" : {
+			"type" : "integer",
+			"minimum" : 0,
+			"default" : 0
+		},
+
+		"maxLength" : {
+			"type" : "integer"
+		},
+
+		"enum" : {
+			"type" : "array",
+			"minItems" : 1,
+			"uniqueItems" : true
+		},
+
+		"default" : {
+			"type" : "any"
+		},
+
+		"title" : {
+			"type" : "string"
+		},
+
+		"description" : {
+			"type" : "string"
+		},
+
+		"format" : {
+			"type" : "string"
+		},
+
+		"divisibleBy" : {
+			"type" : "number",
+			"minimum" : 0,
+			"exclusiveMinimum" : true,
+			"default" : 1
+		},
+
+		"disallow" : {
+			"type" : ["string", "array"],
+			"items" : {
+				"type" : ["string", {"$ref" : "#"}]
+			},
+			"uniqueItems" : true
+		},
+
+		"extends" : {
+			"type" : [{"$ref" : "#"}, "array"],
+			"items" : {"$ref" : "#"},
+			"default" : {}
+		},
+
+		"id" : {
+			"type" : "string"
+		},
+
+		"$ref" : {
+			"type" : "string"
+		},
+
+		"$schema" : {
+			"type" : "string",
+			"format" : "uri"
+		}
+	},
+
+	"dependencies" : {
+		"exclusiveMinimum" : "minimum",
+		"exclusiveMaximum" : "maximum"
+	},
+
+	"default" : {}
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft4/metaschema.json b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft4/metaschema.json
new file mode 100644
index 0000000000000000000000000000000000000000..bcbb84743e3838fab7cbec5f0a5bcbafcfc99136
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft4/metaschema.json
@@ -0,0 +1,149 @@
+{
+    "id": "http://json-schema.org/draft-04/schema#",
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "description": "Core schema meta-schema",
+    "definitions": {
+        "schemaArray": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#" }
+        },
+        "positiveInteger": {
+            "type": "integer",
+            "minimum": 0
+        },
+        "positiveIntegerDefault0": {
+            "allOf": [ { "$ref": "#/definitions/positiveInteger" }, { "default": 0 } ]
+        },
+        "simpleTypes": {
+            "enum": [ "array", "boolean", "integer", "null", "number", "object", "string" ]
+        },
+        "stringArray": {
+            "type": "array",
+            "items": { "type": "string" },
+            "minItems": 1,
+            "uniqueItems": true
+        }
+    },
+    "type": "object",
+    "properties": {
+        "id": {
+            "type": "string"
+        },
+        "$schema": {
+            "type": "string"
+        },
+        "title": {
+            "type": "string"
+        },
+        "description": {
+            "type": "string"
+        },
+        "default": {},
+        "multipleOf": {
+            "type": "number",
+            "minimum": 0,
+            "exclusiveMinimum": true
+        },
+        "maximum": {
+            "type": "number"
+        },
+        "exclusiveMaximum": {
+            "type": "boolean",
+            "default": false
+        },
+        "minimum": {
+            "type": "number"
+        },
+        "exclusiveMinimum": {
+            "type": "boolean",
+            "default": false
+        },
+        "maxLength": { "$ref": "#/definitions/positiveInteger" },
+        "minLength": { "$ref": "#/definitions/positiveIntegerDefault0" },
+        "pattern": {
+            "type": "string",
+            "format": "regex"
+        },
+        "additionalItems": {
+            "anyOf": [
+                { "type": "boolean" },
+                { "$ref": "#" }
+            ],
+            "default": {}
+        },
+        "items": {
+            "anyOf": [
+                { "$ref": "#" },
+                { "$ref": "#/definitions/schemaArray" }
+            ],
+            "default": {}
+        },
+        "maxItems": { "$ref": "#/definitions/positiveInteger" },
+        "minItems": { "$ref": "#/definitions/positiveIntegerDefault0" },
+        "uniqueItems": {
+            "type": "boolean",
+            "default": false
+        },
+        "maxProperties": { "$ref": "#/definitions/positiveInteger" },
+        "minProperties": { "$ref": "#/definitions/positiveIntegerDefault0" },
+        "required": { "$ref": "#/definitions/stringArray" },
+        "additionalProperties": {
+            "anyOf": [
+                { "type": "boolean" },
+                { "$ref": "#" }
+            ],
+            "default": {}
+        },
+        "definitions": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "default": {}
+        },
+        "properties": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "default": {}
+        },
+        "patternProperties": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "default": {}
+        },
+        "dependencies": {
+            "type": "object",
+            "additionalProperties": {
+                "anyOf": [
+                    { "$ref": "#" },
+                    { "$ref": "#/definitions/stringArray" }
+                ]
+            }
+        },
+        "enum": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true
+        },
+        "type": {
+            "anyOf": [
+                { "$ref": "#/definitions/simpleTypes" },
+                {
+                    "type": "array",
+                    "items": { "$ref": "#/definitions/simpleTypes" },
+                    "minItems": 1,
+                    "uniqueItems": true
+                }
+            ]
+        },
+        "format": { "type": "string" },
+        "allOf": { "$ref": "#/definitions/schemaArray" },
+        "anyOf": { "$ref": "#/definitions/schemaArray" },
+        "oneOf": { "$ref": "#/definitions/schemaArray" },
+        "not": { "$ref": "#" }
+    },
+    "dependencies": {
+        "exclusiveMaximum": [ "maximum" ],
+        "exclusiveMinimum": [ "minimum" ]
+    },
+    "default": {}
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft6/metaschema.json b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft6/metaschema.json
new file mode 100644
index 0000000000000000000000000000000000000000..a0d2bf7896c2619ae657cd3b3266660156021706
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft6/metaschema.json
@@ -0,0 +1,153 @@
+{
+    "$schema": "http://json-schema.org/draft-06/schema#",
+    "$id": "http://json-schema.org/draft-06/schema#",
+    "title": "Core schema meta-schema",
+    "definitions": {
+        "schemaArray": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#" }
+        },
+        "nonNegativeInteger": {
+            "type": "integer",
+            "minimum": 0
+        },
+        "nonNegativeIntegerDefault0": {
+            "allOf": [
+                { "$ref": "#/definitions/nonNegativeInteger" },
+                { "default": 0 }
+            ]
+        },
+        "simpleTypes": {
+            "enum": [
+                "array",
+                "boolean",
+                "integer",
+                "null",
+                "number",
+                "object",
+                "string"
+            ]
+        },
+        "stringArray": {
+            "type": "array",
+            "items": { "type": "string" },
+            "uniqueItems": true,
+            "default": []
+        }
+    },
+    "type": ["object", "boolean"],
+    "properties": {
+        "$id": {
+            "type": "string",
+            "format": "uri-reference"
+        },
+        "$schema": {
+            "type": "string",
+            "format": "uri"
+        },
+        "$ref": {
+            "type": "string",
+            "format": "uri-reference"
+        },
+        "title": {
+            "type": "string"
+        },
+        "description": {
+            "type": "string"
+        },
+        "default": {},
+        "examples": {
+            "type": "array",
+            "items": {}
+        },
+        "multipleOf": {
+            "type": "number",
+            "exclusiveMinimum": 0
+        },
+        "maximum": {
+            "type": "number"
+        },
+        "exclusiveMaximum": {
+            "type": "number"
+        },
+        "minimum": {
+            "type": "number"
+        },
+        "exclusiveMinimum": {
+            "type": "number"
+        },
+        "maxLength": { "$ref": "#/definitions/nonNegativeInteger" },
+        "minLength": { "$ref": "#/definitions/nonNegativeIntegerDefault0" },
+        "pattern": {
+            "type": "string",
+            "format": "regex"
+        },
+        "additionalItems": { "$ref": "#" },
+        "items": {
+            "anyOf": [
+                { "$ref": "#" },
+                { "$ref": "#/definitions/schemaArray" }
+            ],
+            "default": {}
+        },
+        "maxItems": { "$ref": "#/definitions/nonNegativeInteger" },
+        "minItems": { "$ref": "#/definitions/nonNegativeIntegerDefault0" },
+        "uniqueItems": {
+            "type": "boolean",
+            "default": false
+        },
+        "contains": { "$ref": "#" },
+        "maxProperties": { "$ref": "#/definitions/nonNegativeInteger" },
+        "minProperties": { "$ref": "#/definitions/nonNegativeIntegerDefault0" },
+        "required": { "$ref": "#/definitions/stringArray" },
+        "additionalProperties": { "$ref": "#" },
+        "definitions": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "default": {}
+        },
+        "properties": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "default": {}
+        },
+        "patternProperties": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "propertyNames": { "format": "regex" },
+            "default": {}
+        },
+        "dependencies": {
+            "type": "object",
+            "additionalProperties": {
+                "anyOf": [
+                    { "$ref": "#" },
+                    { "$ref": "#/definitions/stringArray" }
+                ]
+            }
+        },
+        "propertyNames": { "$ref": "#" },
+        "const": {},
+        "enum": {
+            "type": "array"
+        },
+        "type": {
+            "anyOf": [
+                { "$ref": "#/definitions/simpleTypes" },
+                {
+                    "type": "array",
+                    "items": { "$ref": "#/definitions/simpleTypes" },
+                    "minItems": 1,
+                    "uniqueItems": true
+                }
+            ]
+        },
+        "format": { "type": "string" },
+        "allOf": { "$ref": "#/definitions/schemaArray" },
+        "anyOf": { "$ref": "#/definitions/schemaArray" },
+        "oneOf": { "$ref": "#/definitions/schemaArray" },
+        "not": { "$ref": "#" }
+    },
+    "default": {}
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/schemas/draft7/metaschema.json b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft7/metaschema.json
new file mode 100644
index 0000000000000000000000000000000000000000..746cde9690134529bdcde889f72c7ad5259f24ad
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/schemas/draft7/metaschema.json
@@ -0,0 +1,166 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "http://json-schema.org/draft-07/schema#",
+    "title": "Core schema meta-schema",
+    "definitions": {
+        "schemaArray": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#" }
+        },
+        "nonNegativeInteger": {
+            "type": "integer",
+            "minimum": 0
+        },
+        "nonNegativeIntegerDefault0": {
+            "allOf": [
+                { "$ref": "#/definitions/nonNegativeInteger" },
+                { "default": 0 }
+            ]
+        },
+        "simpleTypes": {
+            "enum": [
+                "array",
+                "boolean",
+                "integer",
+                "null",
+                "number",
+                "object",
+                "string"
+            ]
+        },
+        "stringArray": {
+            "type": "array",
+            "items": { "type": "string" },
+            "uniqueItems": true,
+            "default": []
+        }
+    },
+    "type": ["object", "boolean"],
+    "properties": {
+        "$id": {
+            "type": "string",
+            "format": "uri-reference"
+        },
+        "$schema": {
+            "type": "string",
+            "format": "uri"
+        },
+        "$ref": {
+            "type": "string",
+            "format": "uri-reference"
+        },
+        "$comment": {
+            "type": "string"
+        },
+        "title": {
+            "type": "string"
+        },
+        "description": {
+            "type": "string"
+        },
+        "default": true,
+        "readOnly": {
+            "type": "boolean",
+            "default": false
+        },
+        "examples": {
+            "type": "array",
+            "items": true
+        },
+        "multipleOf": {
+            "type": "number",
+            "exclusiveMinimum": 0
+        },
+        "maximum": {
+            "type": "number"
+        },
+        "exclusiveMaximum": {
+            "type": "number"
+        },
+        "minimum": {
+            "type": "number"
+        },
+        "exclusiveMinimum": {
+            "type": "number"
+        },
+        "maxLength": { "$ref": "#/definitions/nonNegativeInteger" },
+        "minLength": { "$ref": "#/definitions/nonNegativeIntegerDefault0" },
+        "pattern": {
+            "type": "string",
+            "format": "regex"
+        },
+        "additionalItems": { "$ref": "#" },
+        "items": {
+            "anyOf": [
+                { "$ref": "#" },
+                { "$ref": "#/definitions/schemaArray" }
+            ],
+            "default": true
+        },
+        "maxItems": { "$ref": "#/definitions/nonNegativeInteger" },
+        "minItems": { "$ref": "#/definitions/nonNegativeIntegerDefault0" },
+        "uniqueItems": {
+            "type": "boolean",
+            "default": false
+        },
+        "contains": { "$ref": "#" },
+        "maxProperties": { "$ref": "#/definitions/nonNegativeInteger" },
+        "minProperties": { "$ref": "#/definitions/nonNegativeIntegerDefault0" },
+        "required": { "$ref": "#/definitions/stringArray" },
+        "additionalProperties": { "$ref": "#" },
+        "definitions": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "default": {}
+        },
+        "properties": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "default": {}
+        },
+        "patternProperties": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "propertyNames": { "format": "regex" },
+            "default": {}
+        },
+        "dependencies": {
+            "type": "object",
+            "additionalProperties": {
+                "anyOf": [
+                    { "$ref": "#" },
+                    { "$ref": "#/definitions/stringArray" }
+                ]
+            }
+        },
+        "propertyNames": { "$ref": "#" },
+        "const": true,
+        "enum": {
+            "type": "array",
+            "items": true
+        },
+        "type": {
+            "anyOf": [
+                { "$ref": "#/definitions/simpleTypes" },
+                {
+                    "type": "array",
+                    "items": { "$ref": "#/definitions/simpleTypes" },
+                    "minItems": 1,
+                    "uniqueItems": true
+                }
+            ]
+        },
+        "format": { "type": "string" },
+        "contentMediaType": { "type": "string" },
+        "contentEncoding": { "type": "string" },
+        "if": {"$ref": "#"},
+        "then": {"$ref": "#"},
+        "else": {"$ref": "#"},
+        "allOf": { "$ref": "#/definitions/schemaArray" },
+        "anyOf": { "$ref": "#/definitions/schemaArray" },
+        "oneOf": { "$ref": "#/definitions/schemaArray" },
+        "not": { "$ref": "#" }
+    },
+    "default": true
+}
diff --git a/llm/Lib/site-packages/jsonschema_specifications/tests/__init__.py b/llm/Lib/site-packages/jsonschema_specifications/tests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/jsonschema_specifications/tests/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/jsonschema_specifications/tests/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..89bc7bd95322b4e90ff8e185d39275d09daf0c00
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema_specifications/tests/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema_specifications/tests/__pycache__/test_jsonschema_specifications.cpython-311.pyc b/llm/Lib/site-packages/jsonschema_specifications/tests/__pycache__/test_jsonschema_specifications.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..19bdc0c1badf430dfc935ebdcb77f949d3206953
Binary files /dev/null and b/llm/Lib/site-packages/jsonschema_specifications/tests/__pycache__/test_jsonschema_specifications.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/jsonschema_specifications/tests/test_jsonschema_specifications.py b/llm/Lib/site-packages/jsonschema_specifications/tests/test_jsonschema_specifications.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd2927e0c8381f3eb93029df155758c05ed5eb26
--- /dev/null
+++ b/llm/Lib/site-packages/jsonschema_specifications/tests/test_jsonschema_specifications.py
@@ -0,0 +1,41 @@
+from collections.abc import Mapping
+from pathlib import Path
+
+import pytest
+
+from jsonschema_specifications import REGISTRY
+
+
+def test_it_contains_metaschemas():
+    schema = REGISTRY.contents("http://json-schema.org/draft-07/schema#")
+    assert isinstance(schema, Mapping)
+    assert schema["$id"] == "http://json-schema.org/draft-07/schema#"
+    assert schema["title"] == "Core schema meta-schema"
+
+
+def test_it_is_crawled():
+    assert REGISTRY.crawl() == REGISTRY
+
+
+@pytest.mark.parametrize(
+    "ignored_relative_path",
+    ["schemas/.DS_Store", "schemas/draft7/.DS_Store"],
+)
+def test_it_copes_with_dotfiles(ignored_relative_path):
+    """
+    Ignore files like .DS_Store if someone has actually caused one to exist.
+
+    We test here through the private interface as of course the global has
+    already loaded our schemas.
+    """
+
+    import jsonschema_specifications
+
+    package = Path(jsonschema_specifications.__file__).parent
+
+    ignored = package / ignored_relative_path
+    ignored.touch()
+    try:
+        list(jsonschema_specifications._schemas())
+    finally:
+        ignored.unlink()
diff --git a/llm/Lib/site-packages/langchain-0.1.16.dist-info/INSTALLER b/llm/Lib/site-packages/langchain-0.1.16.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/langchain-0.1.16.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/langchain-0.1.16.dist-info/LICENSE b/llm/Lib/site-packages/langchain-0.1.16.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..3957738673765912ca83a0048f833e095d61e087
--- /dev/null
+++ b/llm/Lib/site-packages/langchain-0.1.16.dist-info/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) LangChain, Inc.
+
+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
+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.
diff --git a/llm/Lib/site-packages/langchain-0.1.16.dist-info/METADATA b/llm/Lib/site-packages/langchain-0.1.16.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..0784a32b1728ceebc26620a33730f727728df65b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain-0.1.16.dist-info/METADATA
@@ -0,0 +1,222 @@
+Metadata-Version: 2.1
+Name: langchain
+Version: 0.1.16
+Summary: Building applications with LLMs through composability
+Home-page: https://github.com/langchain-ai/langchain
+License: MIT
+Requires-Python: >=3.8.1,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Provides-Extra: all
+Provides-Extra: azure
+Provides-Extra: clarifai
+Provides-Extra: cli
+Provides-Extra: cohere
+Provides-Extra: docarray
+Provides-Extra: embeddings
+Provides-Extra: extended-testing
+Provides-Extra: javascript
+Provides-Extra: llms
+Provides-Extra: openai
+Provides-Extra: qdrant
+Provides-Extra: text-helpers
+Requires-Dist: PyYAML (>=5.3)
+Requires-Dist: SQLAlchemy (>=1.4,<3)
+Requires-Dist: aiohttp (>=3.8.3,<4.0.0)
+Requires-Dist: aiosqlite (>=0.19.0,<0.20.0) ; extra == "extended-testing"
+Requires-Dist: aleph-alpha-client (>=2.15.0,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: anthropic (>=0.3.11,<0.4.0) ; extra == "extended-testing"
+Requires-Dist: arxiv (>=1.4,<2.0) ; extra == "extended-testing"
+Requires-Dist: assemblyai (>=0.17.0,<0.18.0) ; extra == "extended-testing"
+Requires-Dist: async-timeout (>=4.0.0,<5.0.0) ; python_version < "3.11"
+Requires-Dist: atlassian-python-api (>=3.36.0,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: azure-ai-formrecognizer (>=3.2.1,<4.0.0) ; extra == "azure"
+Requires-Dist: azure-ai-textanalytics (>=5.3.0,<6.0.0) ; extra == "azure"
+Requires-Dist: azure-cognitiveservices-speech (>=1.28.0,<2.0.0) ; extra == "azure"
+Requires-Dist: azure-core (>=1.26.4,<2.0.0) ; extra == "azure"
+Requires-Dist: azure-cosmos (>=4.4.0b1,<5.0.0) ; extra == "azure"
+Requires-Dist: azure-identity (>=1.12.0,<2.0.0) ; extra == "azure"
+Requires-Dist: azure-search-documents (==11.4.0b8) ; extra == "azure"
+Requires-Dist: beautifulsoup4 (>=4,<5) ; extra == "extended-testing"
+Requires-Dist: bibtexparser (>=1.4.0,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: cassio (>=0.1.0,<0.2.0) ; extra == "extended-testing"
+Requires-Dist: chardet (>=5.1.0,<6.0.0) ; extra == "text-helpers" or extra == "extended-testing"
+Requires-Dist: clarifai (>=9.1.0) ; extra == "llms" or extra == "clarifai"
+Requires-Dist: cohere (>=4,<6) ; extra == "llms" or extra == "cohere" or extra == "extended-testing"
+Requires-Dist: couchbase (>=4.1.9,<5.0.0) ; extra == "extended-testing"
+Requires-Dist: dashvector (>=1.0.1,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: databricks-vectorsearch (>=0.21,<0.22) ; extra == "extended-testing"
+Requires-Dist: dataclasses-json (>=0.5.7,<0.7)
+Requires-Dist: datasets (>=2.15.0,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: dgml-utils (>=0.3.0,<0.4.0) ; extra == "extended-testing"
+Requires-Dist: docarray[hnswlib] (>=0.32.0,<0.33.0) ; extra == "docarray"
+Requires-Dist: esprima (>=4.0.1,<5.0.0) ; extra == "javascript" or extra == "extended-testing"
+Requires-Dist: faiss-cpu (>=1,<2) ; extra == "extended-testing"
+Requires-Dist: feedparser (>=6.0.10,<7.0.0) ; extra == "extended-testing"
+Requires-Dist: fireworks-ai (>=0.9.0,<0.10.0) ; extra == "extended-testing"
+Requires-Dist: geopandas (>=0.13.1,<0.14.0) ; extra == "extended-testing"
+Requires-Dist: gitpython (>=3.1.32,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: google-cloud-documentai (>=2.20.1,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: gql (>=3.4.1,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: hologres-vector (>=0.0.6,<0.0.7) ; extra == "extended-testing"
+Requires-Dist: html2text (>=2020.1.16,<2021.0.0) ; extra == "extended-testing"
+Requires-Dist: huggingface_hub (>=0,<1) ; extra == "llms"
+Requires-Dist: javelin-sdk (>=0.1.8,<0.2.0) ; extra == "extended-testing"
+Requires-Dist: jinja2 (>=3,<4) ; extra == "extended-testing"
+Requires-Dist: jq (>=1.4.1,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: jsonpatch (>=1.33,<2.0)
+Requires-Dist: jsonschema (>1) ; extra == "extended-testing"
+Requires-Dist: langchain-community (>=0.0.32,<0.1)
+Requires-Dist: langchain-core (>=0.1.42,<0.2.0)
+Requires-Dist: langchain-openai (>=0.0.2,<0.1) ; extra == "extended-testing"
+Requires-Dist: langchain-text-splitters (>=0.0.1,<0.1)
+Requires-Dist: langsmith (>=0.1.17,<0.2.0)
+Requires-Dist: lxml (>=4.9.3,<6.0) ; extra == "extended-testing"
+Requires-Dist: manifest-ml (>=0.0.1,<0.0.2) ; extra == "llms"
+Requires-Dist: markdownify (>=0.11.6,<0.12.0) ; extra == "extended-testing"
+Requires-Dist: motor (>=3.3.1,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: msal (>=1.25.0,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: mwparserfromhell (>=0.6.4,<0.7.0) ; extra == "extended-testing"
+Requires-Dist: mwxml (>=0.3.3,<0.4.0) ; extra == "extended-testing"
+Requires-Dist: newspaper3k (>=0.2.8,<0.3.0) ; extra == "extended-testing"
+Requires-Dist: nlpcloud (>=1,<2) ; extra == "llms"
+Requires-Dist: numexpr (>=2.8.6,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: numpy (>=1,<2)
+Requires-Dist: openai (<2) ; extra == "llms" or extra == "openai" or extra == "azure" or extra == "extended-testing" or extra == "extended-testing"
+Requires-Dist: openapi-pydantic (>=0.3.2,<0.4.0) ; extra == "extended-testing"
+Requires-Dist: openlm (>=0.0.5,<0.0.6) ; extra == "llms"
+Requires-Dist: pandas (>=2.0.1,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: pdfminer-six (>=20221105,<20221106) ; extra == "extended-testing"
+Requires-Dist: pgvector (>=0.1.6,<0.2.0) ; extra == "extended-testing"
+Requires-Dist: praw (>=7.7.1,<8.0.0) ; extra == "extended-testing"
+Requires-Dist: psychicapi (>=0.8.0,<0.9.0) ; extra == "extended-testing"
+Requires-Dist: py-trello (>=0.19.0,<0.20.0) ; extra == "extended-testing"
+Requires-Dist: pydantic (>=1,<3)
+Requires-Dist: pymupdf (>=1.22.3,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: pypdf (>=3.4.0,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: pypdfium2 (>=4.10.0,<5.0.0) ; extra == "extended-testing"
+Requires-Dist: pyspark (>=3.4.0,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: qdrant-client (>=1.3.1,<2.0.0) ; (python_full_version >= "3.8.1" and python_version < "3.12") and (extra == "qdrant")
+Requires-Dist: rank-bm25 (>=0.2.2,<0.3.0) ; extra == "extended-testing"
+Requires-Dist: rapidfuzz (>=3.1.1,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: rapidocr-onnxruntime (>=1.3.2,<2.0.0) ; (python_full_version >= "3.8.1" and python_version < "3.12") and (extra == "extended-testing")
+Requires-Dist: rdflib (==7.0.0) ; extra == "extended-testing"
+Requires-Dist: requests (>=2,<3)
+Requires-Dist: requests-toolbelt (>=1.0.0,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: rspace_client (>=2.5.0,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: scikit-learn (>=1.2.2,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: sentence-transformers (>=2,<3) ; extra == "embeddings"
+Requires-Dist: sqlite-vss (>=0.1.2,<0.2.0) ; extra == "extended-testing"
+Requires-Dist: streamlit (>=1.18.0,<2.0.0) ; (python_full_version >= "3.8.1" and python_full_version != "3.9.7" and python_version < "4.0") and (extra == "extended-testing")
+Requires-Dist: sympy (>=1.12,<2.0) ; extra == "extended-testing"
+Requires-Dist: telethon (>=1.28.5,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: tenacity (>=8.1.0,<9.0.0)
+Requires-Dist: tiktoken (>=0.3.2,<0.6.0) ; (python_version >= "3.9") and (extra == "openai")
+Requires-Dist: timescale-vector (>=0.0.1,<0.0.2) ; extra == "extended-testing"
+Requires-Dist: torch (>=1,<3) ; extra == "llms"
+Requires-Dist: tqdm (>=4.48.0) ; extra == "extended-testing"
+Requires-Dist: transformers (>=4,<5) ; extra == "llms"
+Requires-Dist: typer (>=0.9.0,<0.10.0) ; extra == "cli"
+Requires-Dist: upstash-redis (>=0.15.0,<0.16.0) ; extra == "extended-testing"
+Requires-Dist: xata (>=1.0.0a7,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: xmltodict (>=0.13.0,<0.14.0) ; extra == "extended-testing"
+Project-URL: Repository, https://github.com/langchain-ai/langchain
+Description-Content-Type: text/markdown
+
+# 🦜️🔗 LangChain
+
+⚡ Building applications with LLMs through composability ⚡
+
+[![Release Notes](https://img.shields.io/github/release/langchain-ai/langchain)](https://github.com/langchain-ai/langchain/releases)
+[![lint](https://github.com/langchain-ai/langchain/actions/workflows/lint.yml/badge.svg)](https://github.com/langchain-ai/langchain/actions/workflows/lint.yml)
+[![test](https://github.com/langchain-ai/langchain/actions/workflows/test.yml/badge.svg)](https://github.com/langchain-ai/langchain/actions/workflows/test.yml)
+[![Downloads](https://static.pepy.tech/badge/langchain/month)](https://pepy.tech/project/langchain)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchainai.svg?style=social&label=Follow%20%40LangChainAI)](https://twitter.com/langchainai)
+[![](https://dcbadge.vercel.app/api/server/6adMQxSpJS?compact=true&style=flat)](https://discord.gg/6adMQxSpJS)
+[![Open in Dev Containers](https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/langchain-ai/langchain)
+[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/langchain-ai/langchain)
+[![GitHub star chart](https://img.shields.io/github/stars/langchain-ai/langchain?style=social)](https://star-history.com/#langchain-ai/langchain)
+[![Dependency Status](https://img.shields.io/librariesio/github/langchain-ai/langchain)](https://libraries.io/github/langchain-ai/langchain)
+[![Open Issues](https://img.shields.io/github/issues-raw/langchain-ai/langchain)](https://github.com/langchain-ai/langchain/issues)
+
+
+Looking for the JS/TS version? Check out [LangChain.js](https://github.com/langchain-ai/langchainjs).
+
+To help you ship LangChain apps to production faster, check out [LangSmith](https://smith.langchain.com). 
+[LangSmith](https://smith.langchain.com) is a unified developer platform for building, testing, and monitoring LLM applications. 
+Fill out [this form](https://www.langchain.com/contact-sales) to speak with our sales team.
+
+## Quick Install
+
+`pip install langchain`
+or
+`pip install langsmith && conda install langchain -c conda-forge`
+
+## 🤔 What is this?
+
+Large language models (LLMs) are emerging as a transformative technology, enabling developers to build applications that they previously could not. However, using these LLMs in isolation is often insufficient for creating a truly powerful app - the real power comes when you can combine them with other sources of computation or knowledge.
+
+This library aims to assist in the development of those types of applications. Common examples of these applications include:
+
+**❓ Question answering with RAG**
+
+- [Documentation](https://python.langchain.com/docs/use_cases/question_answering/)
+- End-to-end Example: [Chat LangChain](https://chat.langchain.com) and [repo](https://github.com/langchain-ai/chat-langchain)
+
+**🧱 Extracting structured output**
+
+- [Documentation](https://python.langchain.com/docs/use_cases/extraction/)
+- End-to-end Example: [SQL Llama2 Template](https://github.com/langchain-ai/langchain-extract/)
+
+**🤖 Chatbots**
+
+- [Documentation](https://python.langchain.com/docs/use_cases/chatbots)
+- End-to-end Example: [Web LangChain (web researcher chatbot)](https://weblangchain.vercel.app) and [repo](https://github.com/langchain-ai/weblangchain)
+
+## 📖 Documentation
+
+Please see [here](https://python.langchain.com) for full documentation on:
+
+- Getting started (installation, setting up the environment, simple examples)
+- How-To examples (demos, integrations, helper functions)
+- Reference (full API docs)
+- Resources (high-level explanation of core concepts)
+
+## 🚀 What can this help with?
+
+There are five main areas that LangChain is designed to help with.
+These are, in increasing order of complexity:
+
+**📃 Models and Prompts:**
+
+This includes prompt management, prompt optimization, a generic interface for all LLMs, and common utilities for working with chat models and LLMs.
+
+**🔗 Chains:**
+
+Chains go beyond a single LLM call and involve sequences of calls (whether to an LLM or a different utility). LangChain provides a standard interface for chains, lots of integrations with other tools, and end-to-end chains for common applications.
+
+**📚 Retrieval Augmented Generation:**
+
+Retrieval Augmented Generation involves specific types of chains that first interact with an external data source to fetch data for use in the generation step. Examples include summarization of long pieces of text and question/answering over specific data sources.
+
+**🤖 Agents:**
+
+Agents involve an LLM making decisions about which Actions to take, taking that Action, seeing an Observation, and repeating that until done. LangChain provides a standard interface for agents, a selection of agents to choose from, and examples of end-to-end agents.
+
+**🧐 Evaluation:**
+
+[BETA] Generative models are notoriously hard to evaluate with traditional metrics. One new way of evaluating them is using language models themselves to do the evaluation. LangChain provides some prompts/chains for assisting in this.
+
+For more information on these concepts, please see our [full documentation](https://python.langchain.com).
+
+## 💁 Contributing
+
+As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
+
+For detailed information on how to contribute, see the [Contributing Guide](https://python.langchain.com/docs/contributing/).
+
diff --git a/llm/Lib/site-packages/langchain-0.1.16.dist-info/RECORD b/llm/Lib/site-packages/langchain-0.1.16.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..74d6f0280ecf71a1b9eaae1c389d28e17c12c0c1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain-0.1.16.dist-info/RECORD
@@ -0,0 +1,2660 @@
+../../Scripts/langchain-server.exe,sha256=yQUpNX6q4nje5zjfvybIaafaGAnWCcUAKbPxDrMdLx0,108383
+langchain-0.1.16.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+langchain-0.1.16.dist-info/LICENSE,sha256=TsZ-TKbmch26hJssqCJhWXyGph7iFLvyFBYAa3stBHg,1067
+langchain-0.1.16.dist-info/METADATA,sha256=X5lYh2ETJr8wVizl3vB66lG7krbUPUnNncq8rKE0gCw,13834
+langchain-0.1.16.dist-info/RECORD,,
+langchain-0.1.16.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain-0.1.16.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+langchain-0.1.16.dist-info/entry_points.txt,sha256=IgKjoXnkkVC8Nm7ggiFMCNAk01ua6RVTb9cmZTVNm5w,58
+langchain/__init__.py,sha256=s79V9hQC_Bei2BDLb4BGcy5E5Z9dqxIYzrF_zt0cG4g,13689
+langchain/__pycache__/__init__.cpython-311.pyc,,
+langchain/__pycache__/base_language.cpython-311.pyc,,
+langchain/__pycache__/cache.cpython-311.pyc,,
+langchain/__pycache__/env.cpython-311.pyc,,
+langchain/__pycache__/example_generator.cpython-311.pyc,,
+langchain/__pycache__/formatting.cpython-311.pyc,,
+langchain/__pycache__/hub.cpython-311.pyc,,
+langchain/__pycache__/input.cpython-311.pyc,,
+langchain/__pycache__/model_laboratory.cpython-311.pyc,,
+langchain/__pycache__/python.cpython-311.pyc,,
+langchain/__pycache__/requests.cpython-311.pyc,,
+langchain/__pycache__/serpapi.cpython-311.pyc,,
+langchain/__pycache__/sql_database.cpython-311.pyc,,
+langchain/__pycache__/text_splitter.cpython-311.pyc,,
+langchain/_api/__init__.py,sha256=2--Xuq83dTMhTYUIXXF3ZEMSOXmeJT4LozYEcviXpBw,667
+langchain/_api/__pycache__/__init__.cpython-311.pyc,,
+langchain/_api/__pycache__/deprecation.cpython-311.pyc,,
+langchain/_api/__pycache__/path.cpython-311.pyc,,
+langchain/_api/deprecation.py,sha256=MpH4S7a11UDuoAGCv1RLWGn4pwhoFwEOrtONJGep40U,471
+langchain/_api/path.py,sha256=ovJP6Pcf7L_KaKvMMet9G9OzfLTb-sZV2pEw3Tp7o3I,122
+langchain/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/adapters/__pycache__/__init__.cpython-311.pyc,,
+langchain/adapters/__pycache__/openai.cpython-311.pyc,,
+langchain/adapters/openai.py,sha256=oIgRXvdkPcyGvK4fUc98sGh_PMxPFwthNZ2wHTPkfzI,653
+langchain/agents/__init__.py,sha256=zX3mt848Rp1qLbf3GWdp7rM506suT67FM_llWnTlUGI,4925
+langchain/agents/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/__pycache__/agent.cpython-311.pyc,,
+langchain/agents/__pycache__/agent_iterator.cpython-311.pyc,,
+langchain/agents/__pycache__/agent_types.cpython-311.pyc,,
+langchain/agents/__pycache__/initialize.cpython-311.pyc,,
+langchain/agents/__pycache__/load_tools.cpython-311.pyc,,
+langchain/agents/__pycache__/loading.cpython-311.pyc,,
+langchain/agents/__pycache__/schema.cpython-311.pyc,,
+langchain/agents/__pycache__/tools.cpython-311.pyc,,
+langchain/agents/__pycache__/types.cpython-311.pyc,,
+langchain/agents/__pycache__/utils.cpython-311.pyc,,
+langchain/agents/agent.py,sha256=XhySn3pMQxgCBW2nTjLX8E57RZIPGxTbLl8qOUOkUpo,56623
+langchain/agents/agent_iterator.py,sha256=mg2QoxEmpt8NTslYk40zVbyyzQ4NI9tMVJ0Z5Bd_9os,15135
+langchain/agents/agent_toolkits/__init__.py,sha256=RmdNxlv6dUcWCC2NhRehk87tXw4Xqr-c0INNfzJSgPA,3678
+langchain/agents/agent_toolkits/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/__pycache__/azure_cognitive_services.cpython-311.pyc,,
+langchain/agents/agent_toolkits/__pycache__/base.cpython-311.pyc,,
+langchain/agents/agent_toolkits/ainetwork/__init__.py,sha256=henfKntuAEjG1KoN-Hk1IHy3fFGCYPWLEuZtF2bIdZI,25
+langchain/agents/agent_toolkits/ainetwork/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/ainetwork/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/ainetwork/toolkit.py,sha256=m06nT1IS8XqZds0HwYJw618YO2I_3a3et4Z6BZgW66g,114
+langchain/agents/agent_toolkits/amadeus/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/amadeus/toolkit.py,sha256=HynZ2k_e8QQdv_mXGb2lzKFhEsbIgpwd-CbdeQ8Mp5s,108
+langchain/agents/agent_toolkits/azure_cognitive_services.py,sha256=scBRv2WUGzrd3LCU3aNDuhQpj90nmVrVvd4vIUWo16A,156
+langchain/agents/agent_toolkits/base.py,sha256=QFa5VNwsP8CC6i-f1LFXn0flYnQhBeR5iTTOZBrCk3I,91
+langchain/agents/agent_toolkits/clickup/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/agents/agent_toolkits/clickup/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/clickup/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/clickup/toolkit.py,sha256=4El45o9kqymhP9g5EbiwhU70aUrnIf-i62T9f6_6WVM,108
+langchain/agents/agent_toolkits/conversational_retrieval/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/agents/agent_toolkits/conversational_retrieval/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/conversational_retrieval/__pycache__/openai_functions.cpython-311.pyc,,
+langchain/agents/agent_toolkits/conversational_retrieval/__pycache__/tool.cpython-311.pyc,,
+langchain/agents/agent_toolkits/conversational_retrieval/openai_functions.py,sha256=JIoha6Mcl3VmTwdlXMeSnkR9lUqVFELaEN-zm_m2EJQ,3235
+langchain/agents/agent_toolkits/conversational_retrieval/tool.py,sha256=JReb_U_ZVrWGJeYxmGVxeEROfk1-T7DcwuK5lYQIZYs,97
+langchain/agents/agent_toolkits/csv/__init__.py,sha256=nxqqnFzM48gemXmWUZc7mWjuwdiDRzF215ftoGU6qro,1091
+langchain/agents/agent_toolkits/csv/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/file_management/__init__.py,sha256=kfHhPFslutoeZEeLXecxpBFmVPvaDleY4mQCwau4pJ4,177
+langchain/agents/agent_toolkits/file_management/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/file_management/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/file_management/toolkit.py,sha256=HbOzrYfccLG_8A2POarJnl5-oSC8s_gFLP2ihxj6OmQ,139
+langchain/agents/agent_toolkits/github/__init__.py,sha256=FBxQxsk8O9n4TXCZXHQW_-011pdVK3_3dN-yeLGPQjE,22
+langchain/agents/agent_toolkits/github/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/github/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/github/toolkit.py,sha256=6BkLO5mvieqONIbNEEsOEoK15UaeKSVs93gZwDS_Dtc,617
+langchain/agents/agent_toolkits/gitlab/__init__.py,sha256=x1DYZ-uaP3BvHsoZs21RxdktQ9292mYBP-tR3tG0h3U,22
+langchain/agents/agent_toolkits/gitlab/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/gitlab/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/gitlab/toolkit.py,sha256=K1iXceo1c2BMJQxfMF_Y-EPPNPla7__ygs8vbFE1bn0,105
+langchain/agents/agent_toolkits/gmail/__init__.py,sha256=0Y2P1d5UFysfWDxwUmb98JLCYNHoQBs1GnxynWGSRz8,21
+langchain/agents/agent_toolkits/gmail/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/gmail/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/gmail/toolkit.py,sha256=KBSSTBkpBIBSEWCTyJaugZpl98ONZxXKJDjGLYdBAGQ,120
+langchain/agents/agent_toolkits/jira/__init__.py,sha256=g7l8EPCXUddP-_AiO9huERcC_x2kD-dfroYmUe8O8I0,20
+langchain/agents/agent_toolkits/jira/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/jira/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/jira/toolkit.py,sha256=kwg0D8-SJ3ljnhaqOq_a9XDlNO_RnVZsdKRRbOjvVic,99
+langchain/agents/agent_toolkits/json/__init__.py,sha256=T7Z9zw9_awf5-r0kExvry2aybzxEnpDb5SyLOpBC2d0,18
+langchain/agents/agent_toolkits/json/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/json/__pycache__/base.cpython-311.pyc,,
+langchain/agents/agent_toolkits/json/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/agent_toolkits/json/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/json/base.py,sha256=gVvxWF53Fqw9uRD9yjz18AHqbfBieh8ibZ7mRxIfz-8,108
+langchain/agents/agent_toolkits/json/prompt.py,sha256=1AKPTnr9QP6qJna4yZN0VNZMYaVJQNlFu43nXK62x7g,126
+langchain/agents/agent_toolkits/json/toolkit.py,sha256=lalOgDngZ83caHYgRFaX_M-JV_aDDBmSrSTIIGX7rHc,99
+langchain/agents/agent_toolkits/multion/__init__.py,sha256=hc75Ek8tmBDf4f34RGwQ447AzE5qHR-HZACB7Di3YAA,23
+langchain/agents/agent_toolkits/multion/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/multion/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/multion/toolkit.py,sha256=ZKQT8LfVu_1j5h6G71vi3XL500axuOdAAKl1b7W0_Ys,108
+langchain/agents/agent_toolkits/nasa/__init__.py,sha256=_g1obC4mS4XeMYhkcNw32uIe7mGPChqhOYMj170Pjp0,19
+langchain/agents/agent_toolkits/nasa/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/nasa/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/nasa/toolkit.py,sha256=_lmQJbtVwq___nj2BLSbG9bIerR7mJUbR3gyEHagMuc,99
+langchain/agents/agent_toolkits/nla/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/agents/agent_toolkits/nla/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/nla/__pycache__/tool.cpython-311.pyc,,
+langchain/agents/agent_toolkits/nla/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/nla/tool.py,sha256=ASpvuMib6xyN9BXxHKlZdJt48gWWGoaWrlzOGTfswRU,87
+langchain/agents/agent_toolkits/nla/toolkit.py,sha256=5ibTKdHOoOZVzObFBhumWER-orvC_a0LjhTTBF1ibdg,96
+langchain/agents/agent_toolkits/office365/__init__.py,sha256=wdPaHFsDOXYsITlWPe2RtHIxFRP2CdbQHIOG1GeEcLs,25
+langchain/agents/agent_toolkits/office365/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/office365/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/office365/toolkit.py,sha256=WiPls_X0veVUaaiXJDI9e5hsnGrFZgMPw6IX_lB3DJc,104
+langchain/agents/agent_toolkits/openapi/__init__.py,sha256=b7ELUVFz_v756WQLXBUtR1mbaXGrKr3tdAroWCsWGm4,26
+langchain/agents/agent_toolkits/openapi/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/openapi/__pycache__/base.cpython-311.pyc,,
+langchain/agents/agent_toolkits/openapi/__pycache__/planner.cpython-311.pyc,,
+langchain/agents/agent_toolkits/openapi/__pycache__/planner_prompt.cpython-311.pyc,,
+langchain/agents/agent_toolkits/openapi/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/agent_toolkits/openapi/__pycache__/spec.cpython-311.pyc,,
+langchain/agents/agent_toolkits/openapi/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/openapi/base.py,sha256=pTuWjOB-yvVAJzu7YnyjJR7Q_DZL5n5WyPNTqaKni8w,117
+langchain/agents/agent_toolkits/openapi/planner.py,sha256=zghNU7nugtcFDTU886DCybWNYPoDQz3aXLFTc470s1A,530
+langchain/agents/agent_toolkits/openapi/planner_prompt.py,sha256=TjJwbdo9u4nt8dtT8iKLE_C1nSSLph1w58-ab9oWXBA,1153
+langchain/agents/agent_toolkits/openapi/prompt.py,sha256=OaWCnZdKftyejt2QNKJ00PDb8lop2tAjeIkBGlZ86iI,186
+langchain/agents/agent_toolkits/openapi/spec.py,sha256=EqQZOjl4lgUbr8hOCF4hSsuzImBQN0Lr3x7mVApGcOc,170
+langchain/agents/agent_toolkits/openapi/toolkit.py,sha256=4ado-Kef0k11Bf577k4_FCqyZy4WedxwOFyZr6PNZMc,157
+langchain/agents/agent_toolkits/pandas/__init__.py,sha256=Ga1aHBv5_ROpZdvAxE9yH64irbTUZ6EVU1einTlY3ic,1104
+langchain/agents/agent_toolkits/pandas/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/playwright/__init__.py,sha256=wKgI0NJbvqzMETZqrApudIgaxLUe0Mn2OzW6ZASEJqw,174
+langchain/agents/agent_toolkits/playwright/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/playwright/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/playwright/toolkit.py,sha256=SIiO6x7OMZ7S8z_MEDvkX0y0orLCqvZnc0HI7--z5yI,140
+langchain/agents/agent_toolkits/powerbi/__init__.py,sha256=9KrYrWCcuVyxlBBLCke09XngnFsFodfInQSW7XVXys4,22
+langchain/agents/agent_toolkits/powerbi/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/powerbi/__pycache__/base.cpython-311.pyc,,
+langchain/agents/agent_toolkits/powerbi/__pycache__/chat_base.cpython-311.pyc,,
+langchain/agents/agent_toolkits/powerbi/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/agent_toolkits/powerbi/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/powerbi/base.py,sha256=X__HtILAlm0PVLmSLRvG2NgvO34jKBgzgL2oDzWUSes,109
+langchain/agents/agent_toolkits/powerbi/chat_base.py,sha256=pnRw77P7uvYpMSMG7taw3GZbN97hBsDRuu3Ob7dPVLI,124
+langchain/agents/agent_toolkits/powerbi/prompt.py,sha256=dSHQuBQOV_TCjdtM6iee2gzghYo6f6MQgVnlOrjiLoY,269
+langchain/agents/agent_toolkits/powerbi/toolkit.py,sha256=Z2CRcs5qcCh-Y6adk50gXQQtw6A_D0HGVeTsnjSrzx0,108
+langchain/agents/agent_toolkits/python/__init__.py,sha256=WlNZZ07mpFZL1phriTjn9q4yXQASVbsSkKCjq-vC-9Y,1094
+langchain/agents/agent_toolkits/python/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/slack/__init__.py,sha256=6Z7GpcJD6FwuFKdcvKJvIfhFvJiiy9I7Gc1MSEKJlcw,21
+langchain/agents/agent_toolkits/slack/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/slack/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/slack/toolkit.py,sha256=npieqOMZAb_jhoLYT55l3LbamtnW1B6t9ta_KokvEk0,102
+langchain/agents/agent_toolkits/spark/__init__.py,sha256=h5uYM0mjy7S6_qCnmk1b-Vx-GWJeBtSXhYAeCsM_4VI,1103
+langchain/agents/agent_toolkits/spark/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/spark_sql/__init__.py,sha256=3IVQbSsdtLKybKYDE0VSq-SCTNFSAJNgCzaJWnSWJbg,23
+langchain/agents/agent_toolkits/spark_sql/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/spark_sql/__pycache__/base.cpython-311.pyc,,
+langchain/agents/agent_toolkits/spark_sql/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/agent_toolkits/spark_sql/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/spark_sql/base.py,sha256=JEbgPux-FdBbr-IeA8pRGlMUJjr53R1oTVeRnwx4WzM,123
+langchain/agents/agent_toolkits/spark_sql/prompt.py,sha256=gocLFQqRPtiGI6JMZ-YfwEkt90WmF4RG73N5TIzTZQo,127
+langchain/agents/agent_toolkits/spark_sql/toolkit.py,sha256=h9i-RpiPTCdUUqkhTb0fOvPFgE_YZAcSy3MtXA6DCAQ,112
+langchain/agents/agent_toolkits/sql/__init__.py,sha256=eqqu9Hd5KiY9-04X2_9acILI2bShgSqNxJFsQ7cm9Dw,17
+langchain/agents/agent_toolkits/sql/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/sql/__pycache__/base.cpython-311.pyc,,
+langchain/agents/agent_toolkits/sql/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/agent_toolkits/sql/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/sql/base.py,sha256=H9-OcYjC7g9OJLI_nXTpVaVBGMg4_6QuqPzvRFc_TpQ,105
+langchain/agents/agent_toolkits/sql/prompt.py,sha256=3RXGTNGd2aQIe33DAQh9h30ddQpiGCgBXCp7AfLnCxA,184
+langchain/agents/agent_toolkits/sql/toolkit.py,sha256=5zHrih4pUuNERdKFix3sF6_6AJc4OyaXNF8cnkGcoLk,112
+langchain/agents/agent_toolkits/steam/__init__.py,sha256=iOMgxWCt0FTNLMNq0wScgSN_YdBBq-56VM6j0Ud8GpI,21
+langchain/agents/agent_toolkits/steam/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/steam/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/steam/toolkit.py,sha256=zmlo8MoHKHijy4ZpTeWcHVG2ARqtG2nBOy2fJYWUTRY,102
+langchain/agents/agent_toolkits/vectorstore/__init__.py,sha256=uT5qVHjIcx3yFkWfxOzbRKL5xwWcMuFGQ-es9O7b2NQ,56
+langchain/agents/agent_toolkits/vectorstore/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/vectorstore/__pycache__/base.cpython-311.pyc,,
+langchain/agents/agent_toolkits/vectorstore/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/agent_toolkits/vectorstore/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/vectorstore/base.py,sha256=YIhA5IXFUjo3dqgKojfFlkOeVHakcb_Y9kETOt3mlPs,4211
+langchain/agents/agent_toolkits/vectorstore/prompt.py,sha256=DndLnLxi9iKjuYKo5E1nscHCOPeCoNcpl8dFHcSltxU,834
+langchain/agents/agent_toolkits/vectorstore/toolkit.py,sha256=o8WKim2AKFTOtyWvj979vMxMI-oJsdcc0WBw1y-bfCQ,3001
+langchain/agents/agent_toolkits/xorbits/__init__.py,sha256=LJ-yZ3UKg4vjibzbgMXocR03vcsU_7ZvU7TlScM9RlE,1095
+langchain/agents/agent_toolkits/xorbits/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/zapier/__init__.py,sha256=19Hc7HG8DzQfg83qqEbYiXA5FklLoRAEOfIs9JqTjX8,22
+langchain/agents/agent_toolkits/zapier/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/agent_toolkits/zapier/__pycache__/toolkit.cpython-311.pyc,,
+langchain/agents/agent_toolkits/zapier/toolkit.py,sha256=J25Ji-5owleSJzp_xtUbXySQWJojt4jMU9wCIogSMnk,105
+langchain/agents/agent_types.py,sha256=WX071-ALyj1DmHghVX437ED0TdhcYu3f0urwQNVGJ2A,1948
+langchain/agents/chat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/agents/chat/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/chat/__pycache__/base.cpython-311.pyc,,
+langchain/agents/chat/__pycache__/output_parser.cpython-311.pyc,,
+langchain/agents/chat/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/chat/base.py,sha256=chR1XKZrQav_xDj6BrsvrFnKDiNpMoyQRu6mFVMfDRQ,5110
+langchain/agents/chat/output_parser.py,sha256=-h0IWy4V_seqg5Ygm-bUtQa2CCdvImlmtNY3-348NjQ,1977
+langchain/agents/chat/prompt.py,sha256=4Ub4oZyIKmJRpWwxOyGcYwlyoK8jJ0kR60jW0lPspC8,1158
+langchain/agents/conversational/__init__.py,sha256=TnMfDzoRzR-xCiR6ph3tn3H7OPbBPpuTsFuqkLMzjiA,75
+langchain/agents/conversational/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/conversational/__pycache__/base.cpython-311.pyc,,
+langchain/agents/conversational/__pycache__/output_parser.cpython-311.pyc,,
+langchain/agents/conversational/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/conversational/base.py,sha256=ShDGSxtbvzHyFmtsuAvRZO3Lrp_M3HtK-3HOOcXTkws,4979
+langchain/agents/conversational/output_parser.py,sha256=OnnkpNW68Gs6pN5nsuTc5Wx0yBOfZUdBk5V8YhFeKh8,1383
+langchain/agents/conversational/prompt.py,sha256=6eiZYQT9liZQr30wAhoqP_2Unph7i-qSqTWqfqdMijI,1859
+langchain/agents/conversational_chat/__init__.py,sha256=TnMfDzoRzR-xCiR6ph3tn3H7OPbBPpuTsFuqkLMzjiA,75
+langchain/agents/conversational_chat/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/conversational_chat/__pycache__/base.cpython-311.pyc,,
+langchain/agents/conversational_chat/__pycache__/output_parser.cpython-311.pyc,,
+langchain/agents/conversational_chat/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/conversational_chat/base.py,sha256=qoN3u4bNCJnH7TEsNG5IuGYeLEKRLD9DAgpRdqZHrnM,5244
+langchain/agents/conversational_chat/output_parser.py,sha256=ZQIRAI-a9gZJtNf4l6u9mQeZw6HCTUcFenAH4MJs5LQ,2398
+langchain/agents/conversational_chat/prompt.py,sha256=rJk3Y5zRo0rxUJUmz5-B7SWt-fs9Mqbs2mucJsIInWY,2763
+langchain/agents/format_scratchpad/__init__.py,sha256=Y-9Nyao9IjZnEXCP9akcmdSnE8JdwSzXY_SVTGai9J4,955
+langchain/agents/format_scratchpad/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/format_scratchpad/__pycache__/log.cpython-311.pyc,,
+langchain/agents/format_scratchpad/__pycache__/log_to_messages.cpython-311.pyc,,
+langchain/agents/format_scratchpad/__pycache__/openai_functions.cpython-311.pyc,,
+langchain/agents/format_scratchpad/__pycache__/openai_tools.cpython-311.pyc,,
+langchain/agents/format_scratchpad/__pycache__/tools.cpython-311.pyc,,
+langchain/agents/format_scratchpad/__pycache__/xml.cpython-311.pyc,,
+langchain/agents/format_scratchpad/log.py,sha256=llVeFjc5yfq2uUjTGhru7aWJxmMBYhoxL4VnnKyF2BU,528
+langchain/agents/format_scratchpad/log_to_messages.py,sha256=FjiNYcZCrd94xpxI86KukLUkgJJnADziBUt3XiXdQWY,721
+langchain/agents/format_scratchpad/openai_functions.py,sha256=OEZXfZPTVaVVx2g41WD6Tv1Ri9wtt-QLaAXACopO2vo,2203
+langchain/agents/format_scratchpad/openai_tools.py,sha256=vyBEqvIZ5HCradWWg0weg4bj9R3nr-CpGZqvSua9HnE,166
+langchain/agents/format_scratchpad/tools.py,sha256=5zw3o1zOcEuuayatYM8YpDgXh91Sb5ACYkknIEtodmc,1853
+langchain/agents/format_scratchpad/xml.py,sha256=DtMBd2-Rgi2LdfxXNImYYNcCEy5lxk8ix7-SSCOpWQY,578
+langchain/agents/initialize.py,sha256=YMviPclDGp4nXUEHdk_JFQJGsVk4_DIj1vpp0qRq7-Q,3244
+langchain/agents/json_chat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/agents/json_chat/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/json_chat/__pycache__/base.cpython-311.pyc,,
+langchain/agents/json_chat/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/json_chat/base.py,sha256=Cb3IIKvZAP_Ss_EJLrq81bXiCv1eXDNZBV3ItP_jNQ8,7743
+langchain/agents/json_chat/prompt.py,sha256=gZukOH50C1llQ-AB2QvtL-PSrczv-a-gJLIPYP8z6vA,551
+langchain/agents/load_tools.py,sha256=fsdGxtPCnmJ8Z5zJeQYIpp_YM-czWW_VxTIAGmfDSSs,27500
+langchain/agents/loading.py,sha256=Lvf9-qNfXor_TkrroY2P7EE3Z0QYMwtgeVjY_rRUVzU,4634
+langchain/agents/mrkl/__init__.py,sha256=Gpz8w88wAF4GSXoGnuYOwZY5rhjFL5WGZvTVQa-YJas,86
+langchain/agents/mrkl/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/mrkl/__pycache__/base.cpython-311.pyc,,
+langchain/agents/mrkl/__pycache__/output_parser.cpython-311.pyc,,
+langchain/agents/mrkl/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/mrkl/base.py,sha256=38uPsI9yjGLojApVQHZNhKA6pfYPTNrSGivPn1OYIaA,6098
+langchain/agents/mrkl/output_parser.py,sha256=84p_09GQBWBmvvJceze267iuofLXVlKGuQrLGwm9tSI,3407
+langchain/agents/mrkl/prompt.py,sha256=2dTMP2lAWiLvCtuEijgQRjbKDlbPEnmx77duMwdJ7e4,641
+langchain/agents/openai_assistant/__init__.py,sha256=Xssaqoxrix3hn1gKSOLmDRQzTxAoJk0ProGXmXQe8Mw,114
+langchain/agents/openai_assistant/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/openai_assistant/__pycache__/base.cpython-311.pyc,,
+langchain/agents/openai_assistant/base.py,sha256=DhGdK5-wJCBjGsWrEdZzO35tVXReI35GEVfvE6P-fG8,27654
+langchain/agents/openai_functions_agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/agents/openai_functions_agent/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/openai_functions_agent/__pycache__/agent_token_buffer_memory.cpython-311.pyc,,
+langchain/agents/openai_functions_agent/__pycache__/base.cpython-311.pyc,,
+langchain/agents/openai_functions_agent/agent_token_buffer_memory.py,sha256=CQPWq3LV8DqdQ4ABHPFemGFWIFZg0-Peg6WTUDOESLc,2567
+langchain/agents/openai_functions_agent/base.py,sha256=2DsPR3ivxWFFA3I1MWHsaQrSJwTpDRyJhYFAw-9QhAw,11633
+langchain/agents/openai_functions_multi_agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/agents/openai_functions_multi_agent/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/openai_functions_multi_agent/__pycache__/base.cpython-311.pyc,,
+langchain/agents/openai_functions_multi_agent/base.py,sha256=o28ov6n7doz6PgvOZ-Bt5gtF8V-TwpYdqfn8Q46cvXk,12006
+langchain/agents/openai_tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/agents/openai_tools/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/openai_tools/__pycache__/base.cpython-311.pyc,,
+langchain/agents/openai_tools/base.py,sha256=a6XIhtZsethtXJ0zCPrkta0FwTGAqp2aMwk_KH4wSfI,3435
+langchain/agents/output_parsers/__init__.py,sha256=rZpsF8yZuwetJXT77j3ZFmoqHiIbDNKOkJ2ebiaSfdY,1373
+langchain/agents/output_parsers/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/output_parsers/__pycache__/json.cpython-311.pyc,,
+langchain/agents/output_parsers/__pycache__/openai_functions.cpython-311.pyc,,
+langchain/agents/output_parsers/__pycache__/openai_tools.cpython-311.pyc,,
+langchain/agents/output_parsers/__pycache__/react_json_single_input.cpython-311.pyc,,
+langchain/agents/output_parsers/__pycache__/react_single_input.cpython-311.pyc,,
+langchain/agents/output_parsers/__pycache__/self_ask.cpython-311.pyc,,
+langchain/agents/output_parsers/__pycache__/tools.cpython-311.pyc,,
+langchain/agents/output_parsers/__pycache__/xml.cpython-311.pyc,,
+langchain/agents/output_parsers/json.py,sha256=sW9e8fG4VlPnMn53dWIwSgnyRBUYs4ULFymrhW92sWQ,1846
+langchain/agents/output_parsers/openai_functions.py,sha256=MjNEFVCxYgS6Efr3HX4rR1zoks2vJxoV8FCUa240jPQ,3467
+langchain/agents/output_parsers/openai_tools.py,sha256=A_GpcYqy3xnkKrlBtrmHIUWwwLMyaKwWc8R-gEvRV3s,2317
+langchain/agents/output_parsers/react_json_single_input.py,sha256=txp86nQROhVtEK2GfpmP0sXyMjIFHlwc-IjcnyGuDOE,2455
+langchain/agents/output_parsers/react_single_input.py,sha256=lIHosxNep1YFCgW9h71gEDWs59dmGeWlWedl9gWf11k,3218
+langchain/agents/output_parsers/self_ask.py,sha256=-4_-hQbKB1ichR5odEyeYUV-wIdLmP5eGDxzw77Cop4,1545
+langchain/agents/output_parsers/tools.py,sha256=9hRlUsJVmS0VmFzEKVYfg5AeusynB2lw4Xi4uYns5JM,3753
+langchain/agents/output_parsers/xml.py,sha256=2MjxW4nAM4sZN-in3K40_K5DBx6cI2Erb0TZbpSoZIY,1658
+langchain/agents/react/__init__.py,sha256=9RIjjaUDfWnoMEMpV57JQ0CwZZC5Soh357QdKpVIM-4,76
+langchain/agents/react/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/react/__pycache__/agent.cpython-311.pyc,,
+langchain/agents/react/__pycache__/base.cpython-311.pyc,,
+langchain/agents/react/__pycache__/output_parser.cpython-311.pyc,,
+langchain/agents/react/__pycache__/textworld_prompt.cpython-311.pyc,,
+langchain/agents/react/__pycache__/wiki_prompt.cpython-311.pyc,,
+langchain/agents/react/agent.py,sha256=WjD2UYv5aYfmMDH-bSCpmvrz7TnyUmosYpA8rRRom-0,4975
+langchain/agents/react/base.py,sha256=0y2TLZrFh45QIJaRIH2kNqNGFaJLZcvs5AhY93DasOo,5714
+langchain/agents/react/output_parser.py,sha256=bEL3U3mxYGK7_7Lm4GlOq8JKQTgyHFQQIEVUUZjV1qs,1231
+langchain/agents/react/textworld_prompt.py,sha256=b9WDM8pFmqrfAWJ8n6zkxlPlxQI5oHljZ1R9g5y6cRE,1906
+langchain/agents/react/wiki_prompt.py,sha256=iQxqKo5IjsP9manfQwf5sz038Hv_hZH_CMWHtAZYKNM,6127
+langchain/agents/schema.py,sha256=D8iW5lc5aepoNGwIr_mCOKB9e7e5urj_C-OA2_4lWmE,1175
+langchain/agents/self_ask_with_search/__init__.py,sha256=gtk3yKsQVBrtX2esW3480KtNXSi7Qim-LXddQFNlS24,106
+langchain/agents/self_ask_with_search/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/self_ask_with_search/__pycache__/base.cpython-311.pyc,,
+langchain/agents/self_ask_with_search/__pycache__/output_parser.cpython-311.pyc,,
+langchain/agents/self_ask_with_search/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/self_ask_with_search/base.py,sha256=cRLtpjYaJL8t1kk-jdXvMCgnflAhN8yzWNoutkD8S2E,8146
+langchain/agents/self_ask_with_search/output_parser.py,sha256=hLDqfU7xV_5G6c68ofhngNWtlnLn8q20R2uSZ9FToOk,138
+langchain/agents/self_ask_with_search/prompt.py,sha256=J3mgTaq-KwT-yTorpDkCi8ruTPTPE8s4OTcL7o8GJgA,1926
+langchain/agents/structured_chat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/agents/structured_chat/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/structured_chat/__pycache__/base.cpython-311.pyc,,
+langchain/agents/structured_chat/__pycache__/output_parser.cpython-311.pyc,,
+langchain/agents/structured_chat/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/structured_chat/base.py,sha256=l957GuWgWtu9KJ9xFk6XZInDlVelATYN_fg1q67-5hU,10812
+langchain/agents/structured_chat/output_parser.py,sha256=0jj2cSH8SLMJMW9cSI82oIJf2lg5SJf34-0Cv_91x8g,3799
+langchain/agents/structured_chat/prompt.py,sha256=OiBTRUOhvhSyO2jO2ByUUiaCrkK_tIUH9pMWWKs-aF4,992
+langchain/agents/tool_calling_agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/agents/tool_calling_agent/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/tool_calling_agent/__pycache__/base.cpython-311.pyc,,
+langchain/agents/tool_calling_agent/base.py,sha256=oKbUNWdZx-e5aOYWhrrRSuWEQHY9DXEyXSFtldR5oiA,3464
+langchain/agents/tools.py,sha256=mvd2lvmCyfK37XFouRlgKIjsltxoOWiTsXaI_r0eEbs,1409
+langchain/agents/types.py,sha256=reTknIC_U9YMexGn3LoHJ5ApW3SuMm9S4QGJs5gTjoM,1475
+langchain/agents/utils.py,sha256=_cLXKL6NS2iqfftiGJOnNZtM7mLZLwd5qBKxEshhuRQ,384
+langchain/agents/xml/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/agents/xml/__pycache__/__init__.cpython-311.pyc,,
+langchain/agents/xml/__pycache__/base.cpython-311.pyc,,
+langchain/agents/xml/__pycache__/prompt.cpython-311.pyc,,
+langchain/agents/xml/base.py,sha256=nDfXxmCqz9VpeALAWYfWedx8vLvCA7xULko1B7-vr6E,8103
+langchain/agents/xml/prompt.py,sha256=XdIyXZMZq8ObRAboEgkw-s-ZBKgXKRxTBskFMWTJ9aE,767
+langchain/base_language.py,sha256=OQmutOaRyAIauI79mu_pO6N9JB2uL8GgaNsAgNf-5B8,217
+langchain/cache.py,sha256=n0QPLxXJiVuYpMhXc42nATpEUdLCdDDjhUiNvelDPg4,767
+langchain/callbacks/__init__.py,sha256=WgoUrEvBPiXojrECm1JLRiqO0HOGt_fmuuqvVttqKBY,2509
+langchain/callbacks/__pycache__/__init__.cpython-311.pyc,,
+langchain/callbacks/__pycache__/aim_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/argilla_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/arize_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/arthur_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/base.cpython-311.pyc,,
+langchain/callbacks/__pycache__/clearml_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/comet_ml_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/confident_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/context_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/file.cpython-311.pyc,,
+langchain/callbacks/__pycache__/flyte_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/human.cpython-311.pyc,,
+langchain/callbacks/__pycache__/infino_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/labelstudio_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/llmonitor_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/manager.cpython-311.pyc,,
+langchain/callbacks/__pycache__/mlflow_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/openai_info.cpython-311.pyc,,
+langchain/callbacks/__pycache__/promptlayer_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/sagemaker_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/stdout.cpython-311.pyc,,
+langchain/callbacks/__pycache__/streaming_aiter.cpython-311.pyc,,
+langchain/callbacks/__pycache__/streaming_aiter_final_only.cpython-311.pyc,,
+langchain/callbacks/__pycache__/streaming_stdout.cpython-311.pyc,,
+langchain/callbacks/__pycache__/streaming_stdout_final_only.cpython-311.pyc,,
+langchain/callbacks/__pycache__/trubrics_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/utils.cpython-311.pyc,,
+langchain/callbacks/__pycache__/wandb_callback.cpython-311.pyc,,
+langchain/callbacks/__pycache__/whylabs_callback.cpython-311.pyc,,
+langchain/callbacks/aim_callback.py,sha256=hVpK6_5JHE7KgF53opsWlymMzJczNha7dTnS2h-PDB4,211
+langchain/callbacks/argilla_callback.py,sha256=WCUR17TGEbY6fqA5012kxSmbY-Db612UiTRmHVigEmc,120
+langchain/callbacks/arize_callback.py,sha256=m2g531bfOr8LETQ9sQEyfRfWlnpkSqTSx4dlB_uxiII,114
+langchain/callbacks/arthur_callback.py,sha256=JL1MQ7a5_YT_SM_DJWMLxP1ujfm5Fgmw0JCjNWc5hMc,133
+langchain/callbacks/base.py,sha256=H3_hzqaiEJyM_IOqD1yQN--IhIREmuCNhZzMNX4RmH8,653
+langchain/callbacks/clearml_callback.py,sha256=-x4uBeD6W8qNcSzoJKF6uJv_yauJL94hLSCrfUnb4gk,129
+langchain/callbacks/comet_ml_callback.py,sha256=wDWffNNHQt3u4vvQz1qRGBBl__5A0E1GGXpqb80-kdg,133
+langchain/callbacks/confident_callback.py,sha256=uMfpi3rnHcUA3iyE6z0HXkddvUjPfaBTLjePY7nEzwU,124
+langchain/callbacks/context_callback.py,sha256=1ch5n640qFITKCKILnirb3zeJGNjAUJPX0z_6cpGA7U,129
+langchain/callbacks/file.py,sha256=Aq6cX05uKEjz22Q6a3Eows63Vp1_nRqNFi0vcBxv5t0,2589
+langchain/callbacks/flyte_callback.py,sha256=1qI3B5Ju6SKzsIZhJIBB21bmBFCNmZvIW38HKHDtvtU,123
+langchain/callbacks/human.py,sha256=jeBmQbXoz47iLXKuSAb_lcodVfu1ZjUxI8zNXBZsEGk,275
+langchain/callbacks/infino_callback.py,sha256=luBT9IpngZMgt1HoRw5SP_Z63_jwds_ClnNk1BPlMPM,133
+langchain/callbacks/labelstudio_callback.py,sha256=SOeQR-zU-NzBFEDctmEiCR0q_r1C9DbtdGMQ4nxavMw,241
+langchain/callbacks/llmonitor_callback.py,sha256=5UyAmaYc_wWACa5eFiCjiVxvUXF9XJjZBKSzcStB8hw,142
+langchain/callbacks/manager.py,sha256=bbltO6W0230RkKxiXBH2Zm73QmZHxicjIIppm6N93vU,1777
+langchain/callbacks/mlflow_callback.py,sha256=P9VC0sCt2d33ehxI44LdecOG9D4aBSj0b2hh-u1q7hs,305
+langchain/callbacks/openai_info.py,sha256=yj5zxRz1gbB31lWMTrJXZO6iiTnZNY8Oc8kRxAUwkd0,113
+langchain/callbacks/promptlayer_callback.py,sha256=h7Aax6yIFkFA0vxVSAM9gxS_i0psfD1lXZ6XU3aQSdA,141
+langchain/callbacks/sagemaker_callback.py,sha256=tOHLHqEAMwY5yA0p8ZcrXnPuO882B12IKZbPDyd9iOA,135
+langchain/callbacks/stdout.py,sha256=9weMjKUjKSTcWmeb3Sb2KKblj7C0-QTa1SzUzRMbjw0,103
+langchain/callbacks/streaming_aiter.py,sha256=l0y-STj3gXhF-yZ9_wWcOEd4gWFduMwJyt-O8liCj5A,2399
+langchain/callbacks/streaming_aiter_final_only.py,sha256=3ZMODWYi-lMukQ_3TvM8JM_nuwsNSPMf1nl6C2DNvyk,3371
+langchain/callbacks/streaming_stdout.py,sha256=H-3b-B652V7puMTgwXww5tAPAeEe4TCRbdaGrCHVkL4,173
+langchain/callbacks/streaming_stdout_final_only.py,sha256=zx_jGrFY1aKtxk81haDb89x9tpL6JV12Mg8xohGqqec,3357
+langchain/callbacks/streamlit/__init__.py,sha256=xZdUQQUWXfjI-QSvs7-gijILufGXG9aJ63x0cBkH8B4,3190
+langchain/callbacks/streamlit/__pycache__/__init__.cpython-311.pyc,,
+langchain/callbacks/streamlit/__pycache__/mutable_expander.cpython-311.pyc,,
+langchain/callbacks/streamlit/__pycache__/streamlit_callback_handler.cpython-311.pyc,,
+langchain/callbacks/streamlit/mutable_expander.py,sha256=Q2o8fqBkAx_lVgciMg9NwGcClSuvbt4VWeTqQpT_yD4,185
+langchain/callbacks/streamlit/streamlit_callback_handler.py,sha256=e8-d4tTR_pRkb137tkWLKytBoPV0ltU0Z5Ay_R5KAv4,490
+langchain/callbacks/tracers/__init__.py,sha256=Pn42EItndvWUwDHoyvRZB6eqngXSOcf4k6aSKIQ2SPg,589
+langchain/callbacks/tracers/__pycache__/__init__.cpython-311.pyc,,
+langchain/callbacks/tracers/__pycache__/base.cpython-311.pyc,,
+langchain/callbacks/tracers/__pycache__/comet.cpython-311.pyc,,
+langchain/callbacks/tracers/__pycache__/evaluation.cpython-311.pyc,,
+langchain/callbacks/tracers/__pycache__/langchain.cpython-311.pyc,,
+langchain/callbacks/tracers/__pycache__/langchain_v1.cpython-311.pyc,,
+langchain/callbacks/tracers/__pycache__/log_stream.cpython-311.pyc,,
+langchain/callbacks/tracers/__pycache__/logging.cpython-311.pyc,,
+langchain/callbacks/tracers/__pycache__/root_listeners.cpython-311.pyc,,
+langchain/callbacks/tracers/__pycache__/run_collector.cpython-311.pyc,,
+langchain/callbacks/tracers/__pycache__/schemas.cpython-311.pyc,,
+langchain/callbacks/tracers/__pycache__/stdout.cpython-311.pyc,,
+langchain/callbacks/tracers/__pycache__/wandb.cpython-311.pyc,,
+langchain/callbacks/tracers/base.py,sha256=Teo6B_k5zgnXmEAK-nE7-ngYTBFf29PSlhZIKcyu1og,154
+langchain/callbacks/tracers/comet.py,sha256=1VGhWs7qVX15ct-ftXIsqp7lLKk6nd4B0OL972Ff-Dw,154
+langchain/callbacks/tracers/evaluation.py,sha256=PVOkUFXW5jev-wnZHjTwAx9Ag5e1G09P0FStr17PYZ4,233
+langchain/callbacks/tracers/langchain.py,sha256=KS1qe0UMdmQzoESWw696yWtQyg4_ZSXj4kNOtLfWFlU,218
+langchain/callbacks/tracers/langchain_v1.py,sha256=gdFt_Orrv9W0P_ytMz0UkBTOiYFz8fOwrjKCFk96Bc8,99
+langchain/callbacks/tracers/log_stream.py,sha256=Fghp01LH6Ucvj6q-NtvhYZzW3Ow1n-IXVlrdnh-rrLs,226
+langchain/callbacks/tracers/logging.py,sha256=UTbuh0Zm6Bu4PGTRcFqh0h1AVISrndyOlR3LgpVjAFQ,1384
+langchain/callbacks/tracers/root_listeners.py,sha256=z4sMzTA35qnAd5S5K19Fu-8rySYOIDnEgYf0SjoQhk0,105
+langchain/callbacks/tracers/run_collector.py,sha256=xDu5e45bJW8PyGaFul9tenkbjZ__MtfR1FoqpqM-BsA,120
+langchain/callbacks/tracers/schemas.py,sha256=LzW3N2S6a0nozOY9lSLHDUAfn8aYrXIkd97iok6GdHw,470
+langchain/callbacks/tracers/stdout.py,sha256=0TtKsQzOiUgpgF59jc0_ptAcgfC7RwyxBYKtqyHLnD0,168
+langchain/callbacks/tracers/wandb.py,sha256=YYIu7UUG5UBA3XO0D07imzEKAMlXWOVInGncYbMwNPQ,229
+langchain/callbacks/trubrics_callback.py,sha256=AvqhLSLkAnl18fov6AAE9cx2TtoKgdPziZ4aFtY-ZnI,132
+langchain/callbacks/utils.py,sha256=ZybZmZme44xsn9yqTzmrTST43AUc08co5rAUzM5tIDk,403
+langchain/callbacks/wandb_callback.py,sha256=B4pFBj4JyaDwVjONq5M9Zd5rKLZRfk4kRUgEU75u1us,130
+langchain/callbacks/whylabs_callback.py,sha256=ycw-RoeLKrq1FnzFQDVkB-ZsWmunnd_oO1n-hyMW_HU,129
+langchain/chains/__init__.py,sha256=dIP4LAw1PmKp0Mg_QaMbrecvdzbi54otZw9j8GIS1_g,4963
+langchain/chains/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/__pycache__/base.cpython-311.pyc,,
+langchain/chains/__pycache__/example_generator.cpython-311.pyc,,
+langchain/chains/__pycache__/history_aware_retriever.cpython-311.pyc,,
+langchain/chains/__pycache__/llm.cpython-311.pyc,,
+langchain/chains/__pycache__/llm_requests.cpython-311.pyc,,
+langchain/chains/__pycache__/loading.cpython-311.pyc,,
+langchain/chains/__pycache__/mapreduce.cpython-311.pyc,,
+langchain/chains/__pycache__/moderation.cpython-311.pyc,,
+langchain/chains/__pycache__/prompt_selector.cpython-311.pyc,,
+langchain/chains/__pycache__/retrieval.cpython-311.pyc,,
+langchain/chains/__pycache__/sequential.cpython-311.pyc,,
+langchain/chains/__pycache__/transform.cpython-311.pyc,,
+langchain/chains/api/__init__.py,sha256=d8xBEQqFVNOMTm4qXNz5YiYkvA827Ayyd4XCG1KP-z4,84
+langchain/chains/api/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/api/__pycache__/base.cpython-311.pyc,,
+langchain/chains/api/__pycache__/news_docs.cpython-311.pyc,,
+langchain/chains/api/__pycache__/open_meteo_docs.cpython-311.pyc,,
+langchain/chains/api/__pycache__/podcast_docs.cpython-311.pyc,,
+langchain/chains/api/__pycache__/prompt.cpython-311.pyc,,
+langchain/chains/api/__pycache__/tmdb_docs.cpython-311.pyc,,
+langchain/chains/api/base.py,sha256=y_JdDxAd3nbuN090GqsYK9sX9QCxl0jUjvh6S9-HRb8,8919
+langchain/chains/api/news_docs.py,sha256=9vzx5nSPwe_cjFV8cemlfMp4EX8wiZe2eXBuRik2Vdg,2452
+langchain/chains/api/open_meteo_docs.py,sha256=8pLSX24K37lcgq3jmgfThcuiz7WY3zkub_V6dtsqc18,3399
+langchain/chains/api/openapi/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/chains/api/openapi/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/api/openapi/__pycache__/chain.cpython-311.pyc,,
+langchain/chains/api/openapi/__pycache__/prompts.cpython-311.pyc,,
+langchain/chains/api/openapi/__pycache__/requests_chain.cpython-311.pyc,,
+langchain/chains/api/openapi/__pycache__/response_chain.cpython-311.pyc,,
+langchain/chains/api/openapi/chain.py,sha256=6k1WOYiy6vkqDsBK0_gbfjIRYu-SbO1sXuygNaaRpvo,8786
+langchain/chains/api/openapi/prompts.py,sha256=4nNrzIYN1AR69B_NxH1DK2bt0sJgnlSFVdymNbCknK4,1791
+langchain/chains/api/openapi/requests_chain.py,sha256=I4X_XMW7PbdvYlqx09YeDPcQeQkt4zAk0wA7_JhB7LU,1975
+langchain/chains/api/openapi/response_chain.py,sha256=zBaKsBEuX3Kyaxvx-iz7yzZ5NghT2QuzfR71g4HZhQE,1847
+langchain/chains/api/podcast_docs.py,sha256=mPW1GrX0X6kaGuGpVYFXNvSoLNoUFse8CaoJSUSa4KU,1920
+langchain/chains/api/prompt.py,sha256=YERLepjWuo2J4wg40DWWfHH4Tsm-9eab-cIllHFxMk4,1031
+langchain/chains/api/tmdb_docs.py,sha256=8yoowa2d53-oytU0dycV-0w9wRe9xOXAPz-s8gQ6EpE,1537
+langchain/chains/base.py,sha256=_2bsF-Y4MhzaHRMFf-Hib_0xThegPCjDRrfBFapxa3s,29628
+langchain/chains/chat_vector_db/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/chains/chat_vector_db/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/chat_vector_db/__pycache__/prompts.cpython-311.pyc,,
+langchain/chains/chat_vector_db/prompts.py,sha256=4YM7z5Wi8ftJEVj3ZG8YOcudYwGHCNvQh4Gf_6592yc,694
+langchain/chains/combine_documents/__init__.py,sha256=tJZmkLOD4JGjh9OxkCdTMUzbBCb-47fHLyklQo6ida4,367
+langchain/chains/combine_documents/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/combine_documents/__pycache__/base.cpython-311.pyc,,
+langchain/chains/combine_documents/__pycache__/map_reduce.cpython-311.pyc,,
+langchain/chains/combine_documents/__pycache__/map_rerank.cpython-311.pyc,,
+langchain/chains/combine_documents/__pycache__/reduce.cpython-311.pyc,,
+langchain/chains/combine_documents/__pycache__/refine.cpython-311.pyc,,
+langchain/chains/combine_documents/__pycache__/stuff.cpython-311.pyc,,
+langchain/chains/combine_documents/base.py,sha256=bN4mWz7U3eCFWIdPvXjgsq5QfBm1TF2fuSN1U4n8GCc,8006
+langchain/chains/combine_documents/map_reduce.py,sha256=dEBzqBTPFaEOQGmAVMhcD9oEk_0j13sUgBsuVlRj__M,11781
+langchain/chains/combine_documents/map_rerank.py,sha256=r7EAj4wfobiK_O1gz_QVo6YOayhqgCUaDuTs_vD3gpc,8991
+langchain/chains/combine_documents/reduce.py,sha256=kpUPpvs2dr1ewqdisaw8-O_m0_uu_uKO6wXfzevZjo8,13894
+langchain/chains/combine_documents/refine.py,sha256=52amLZKeL1wBxB810mhNrzK8PdP-JxpyAAvQhlKfeXU,9113
+langchain/chains/combine_documents/stuff.py,sha256=4PjuMQk6zFgTrg8CN5csmfGfTQChfoL0HAXShYIL-Bg,10958
+langchain/chains/constitutional_ai/__init__.py,sha256=Woq_Efl5d-MSTkhpg7HLts3kXysJVZLiz3tr05NTf5Q,107
+langchain/chains/constitutional_ai/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/constitutional_ai/__pycache__/base.cpython-311.pyc,,
+langchain/chains/constitutional_ai/__pycache__/models.cpython-311.pyc,,
+langchain/chains/constitutional_ai/__pycache__/principles.cpython-311.pyc,,
+langchain/chains/constitutional_ai/__pycache__/prompts.cpython-311.pyc,,
+langchain/chains/constitutional_ai/base.py,sha256=6Q4LRKe7K8KDglWuBXbllHCo2F0ELArjKR-Y_CvQx0k,6341
+langchain/chains/constitutional_ai/models.py,sha256=i_0V64sOj4-k63foPRWVFIQYYqMRv_KYLxAD9kempCc,283
+langchain/chains/constitutional_ai/principles.py,sha256=V_bgghhwAqe2dI9YbcaQZaVlvM5kumV5g8c8G4fyARQ,21738
+langchain/chains/constitutional_ai/prompts.py,sha256=JFvDNRImra6G_0VuS-V3o-LbYPY4KG-QgJL_GMvosHY,8666
+langchain/chains/conversation/__init__.py,sha256=hpIiQSoUe0bGkqAGKxG_CEYRFsjHRL4l5uBEpCBetFc,71
+langchain/chains/conversation/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/conversation/__pycache__/base.cpython-311.pyc,,
+langchain/chains/conversation/__pycache__/memory.cpython-311.pyc,,
+langchain/chains/conversation/__pycache__/prompt.cpython-311.pyc,,
+langchain/chains/conversation/base.py,sha256=aKRfsY6TXhVIbY5acPmu7CYmZSAyj3FRDjFs2mnXdKQ,2366
+langchain/chains/conversation/memory.py,sha256=fzDdSAvZXk7MnOIuTOadDnA5k6IRgIpxncTLsDJFQjY,856
+langchain/chains/conversation/prompt.py,sha256=84xC4dy8yNiCSICT4b6UvZdQXpPifMVw1hf7WnFAVkw,913
+langchain/chains/conversational_retrieval/__init__.py,sha256=hq7jx-kmg3s8qLYnV7gPmzVIPcGqW69H6cXIjklvGjY,49
+langchain/chains/conversational_retrieval/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/conversational_retrieval/__pycache__/base.cpython-311.pyc,,
+langchain/chains/conversational_retrieval/__pycache__/prompts.cpython-311.pyc,,
+langchain/chains/conversational_retrieval/base.py,sha256=T3jxJXRW_fl-w9z3sVw6cDgq8w75GDjgfEIlF565UcA,17834
+langchain/chains/conversational_retrieval/prompts.py,sha256=kJITwauXq7dYKnSBoL2EcDTqAnJZlWF_GzJ9C55ZEv8,720
+langchain/chains/elasticsearch_database/__init__.py,sha256=B3Zxy8mxTb4bfMGHC__26BFkvT_6bPisS4rPIFiFWdU,126
+langchain/chains/elasticsearch_database/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/elasticsearch_database/__pycache__/base.cpython-311.pyc,,
+langchain/chains/elasticsearch_database/__pycache__/prompts.cpython-311.pyc,,
+langchain/chains/elasticsearch_database/base.py,sha256=H-yWxAA8U5O-7B4BLXNEOVe0HpvJDiDPthTfdjZJbq8,8287
+langchain/chains/elasticsearch_database/prompts.py,sha256=XTRDvnAMwGLlQh9vE0Ju8Nh39Ro7zjzZg13mY36pzNw,1425
+langchain/chains/ernie_functions/__init__.py,sha256=X9UasqHPYWmSBtSg9kiKzf2yADl34zVo0R9T-C2LMtA,465
+langchain/chains/ernie_functions/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/ernie_functions/__pycache__/base.cpython-311.pyc,,
+langchain/chains/ernie_functions/base.py,sha256=dqonjJzLFxis8jh1OWChISqKU-QH4XlkP64HZhNPFHI,23205
+langchain/chains/example_generator.py,sha256=nGtBhN7S7m8tWxUVil2BSoMV87VyCKms1ut7tynSNxM,741
+langchain/chains/flare/__init__.py,sha256=ufb8LMpEVUzTDflcNiJJyKCG9e4EVGAvz5e7h7f0Z1c,51
+langchain/chains/flare/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/flare/__pycache__/base.cpython-311.pyc,,
+langchain/chains/flare/__pycache__/prompts.cpython-311.pyc,,
+langchain/chains/flare/base.py,sha256=H1IoRUJvNgoFjdq0n9DDxbxsYYt1eUnKnWfBasiJCSY,9033
+langchain/chains/flare/prompts.py,sha256=6ypb3UrOwd4YFy1W8LjBwNVgZLYb-W1U1hme5IdPpDE,1471
+langchain/chains/graph_qa/__init__.py,sha256=42PVlGI3l9gze7kEp9PVGJyMoHoo4IdozzrKCT_W_uM,49
+langchain/chains/graph_qa/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/arangodb.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/base.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/cypher.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/cypher_utils.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/falkordb.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/gremlin.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/hugegraph.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/kuzu.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/nebulagraph.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/neptune_cypher.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/neptune_sparql.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/ontotext_graphdb.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/prompts.cpython-311.pyc,,
+langchain/chains/graph_qa/__pycache__/sparql.cpython-311.pyc,,
+langchain/chains/graph_qa/arangodb.py,sha256=0-bL0KsbLg9SdWWaE62JtIUwOYy9HIHcWQpXb3exLIo,8397
+langchain/chains/graph_qa/base.py,sha256=NbTczmd8jfGK2QMU08s_QJXsuXr4hdFhYdPFUE5Pb2Y,3671
+langchain/chains/graph_qa/cypher.py,sha256=LoLHYwMmHdoFWO64_IXKt9mkWaPvdkvmGlgAMyiYWnE,10543
+langchain/chains/graph_qa/cypher_utils.py,sha256=69Y8fIkempX4YPDjdorEZmb4ieN1k9DPosJiBLEG4Ug,9625
+langchain/chains/graph_qa/falkordb.py,sha256=q24aFAPR7o0-MZgbZ1ETBDNWwPXbvDrF3qRzROXnxPQ,5272
+langchain/chains/graph_qa/gremlin.py,sha256=ch3d0ZYdXuurJSbnohcCEii0gln29JbytF6FWV-QoFY,7808
+langchain/chains/graph_qa/hugegraph.py,sha256=lMAFThnp4PpoKHupm_IGIwplF8UBjGvLM4s4yzFxvVI,3717
+langchain/chains/graph_qa/kuzu.py,sha256=40hqCdWzA9i4NKm7McxF95jIVqkCupFGcFxkd90dyFE,3698
+langchain/chains/graph_qa/nebulagraph.py,sha256=jY7GeDMlXC_cmUIO1E4sVdEIgBRVnMFznkqZt66_SxQ,3692
+langchain/chains/graph_qa/neptune_cypher.py,sha256=UO_MWb1x4hcGuwozkloHxdWYAEdguqTZSQMalh20jWc,6898
+langchain/chains/graph_qa/neptune_sparql.py,sha256=Jx3nE4htnm5gCQYl26hAH-911J7LeKYxm6NAN9AIgUQ,6636
+langchain/chains/graph_qa/ontotext_graphdb.py,sha256=aDpozF4vAwwHnPlnIEpad5qM1t7hcZ7Is-MHtWIaNMs,7226
+langchain/chains/graph_qa/prompts.py,sha256=Uswy94MK-0-gj20fyWbuzXEBr13Ms6aQ3Gj4iBxms-M,16720
+langchain/chains/graph_qa/sparql.py,sha256=31KWgOQ_Gn6vwRM90lMfR4SNP74ejffNboX3wZ5-GLA,5838
+langchain/chains/history_aware_retriever.py,sha256=a92vlxlq0PaOubc_b4jj_WwGivk4Tyi1xzSBKaTOx4g,2662
+langchain/chains/hyde/__init__.py,sha256=mZ-cb7slBdlK5aG2R_NegBzNCXToHR-tdmfIIA6lKvQ,75
+langchain/chains/hyde/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/hyde/__pycache__/base.cpython-311.pyc,,
+langchain/chains/hyde/__pycache__/prompts.cpython-311.pyc,,
+langchain/chains/hyde/base.py,sha256=3bjH3SNN-sE3jNgOhu1SlCI8RBQihU7rbKhso1-Bc0U,3341
+langchain/chains/hyde/prompts.py,sha256=U4LfozneOyHDIKd8rCbnGSQK84YvZqAtpf5EL435Ol8,1913
+langchain/chains/llm.py,sha256=QVpn03rJ6IzOLKwEEJBMlKhdRQXhc8igJfPm_ajWVVU,14776
+langchain/chains/llm_bash/__init__.py,sha256=WFTymeHr7xIqUM4vVU5IqHliSVSnLBkeFU1inA3Y0gw,450
+langchain/chains/llm_bash/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/llm_checker/__init__.py,sha256=2IHg5XUQTQEoEMutGa66_tzOStNskQnDDXdN9VzJCSo,139
+langchain/chains/llm_checker/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/llm_checker/__pycache__/base.cpython-311.pyc,,
+langchain/chains/llm_checker/__pycache__/prompt.cpython-311.pyc,,
+langchain/chains/llm_checker/base.py,sha256=qnmIhplnkXZG9br1-Tc3VawjzrGBTMTnr-a3tVvHX1M,6190
+langchain/chains/llm_checker/prompt.py,sha256=ZyrtvgRH3XxCUKyLVAEhehlC3LfInaZ8ddZ3KE0OrIo,1125
+langchain/chains/llm_math/__init__.py,sha256=V-js2H13eXegQztkkM6joc2lRmD6XJJkj6k5RAnIWX8,143
+langchain/chains/llm_math/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/llm_math/__pycache__/base.cpython-311.pyc,,
+langchain/chains/llm_math/__pycache__/prompt.cpython-311.pyc,,
+langchain/chains/llm_math/base.py,sha256=PNtj8WoRKu3mX2NJPeHn5lTnCF-LO89vm0_2AviiUtA,6723
+langchain/chains/llm_math/prompt.py,sha256=uj1p7wrNWzbzMN3it80Xh1Iv14qoy_sd4f--opyMuB0,868
+langchain/chains/llm_requests.py,sha256=Y7DkL3A3Z6_F7qtLKCZ8eOTBQqzNLK-qpZaXKmzqgfs,3251
+langchain/chains/llm_summarization_checker/__init__.py,sha256=UixFPJ7i6Debb4wwA1voMbgVZqQ8d4p-Tuiy3-o3iT8,352
+langchain/chains/llm_summarization_checker/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/llm_summarization_checker/__pycache__/base.cpython-311.pyc,,
+langchain/chains/llm_summarization_checker/base.py,sha256=s_IBzLJR2L1eK1uZQeAWqHg9zNhaUkOXRE1r26Kn90Y,6582
+langchain/chains/llm_summarization_checker/prompts/are_all_true_prompt.txt,sha256=yWZxXJTyYtao73asx_tE-qUU5eZZJ8iu20WW3vMmLF8,654
+langchain/chains/llm_summarization_checker/prompts/check_facts.txt,sha256=Du-gC9bXGSdXfxa643sjTr2FtWuLBWkBA9dOUzRucZs,377
+langchain/chains/llm_summarization_checker/prompts/create_facts.txt,sha256=hM2_EVxM_8iL3rm7ui17NAUKoHCjpqhYjdXO6NQ6lEI,128
+langchain/chains/llm_summarization_checker/prompts/revise_summary.txt,sha256=nSSq5UQMx6gvjMKIs2t_ituuEQzu2nni1wdnywAe-5U,416
+langchain/chains/llm_symbolic_math/__init__.py,sha256=mqRp9PyuHeRrviq7kMCHRD54EcCV_mJxEKPqq3sU8YQ,467
+langchain/chains/llm_symbolic_math/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/loading.py,sha256=_TBvplfY2e1iES_dDQpiqztYJwe72vM9aRKZpdwbGm8,26890
+langchain/chains/mapreduce.py,sha256=5mtGKOPbDEanLD61Y9pdKtZ-qXW_iu-iVmJytGfzCbQ,3733
+langchain/chains/moderation.py,sha256=ID0dA5-XKIeZGtwk0EXtsc24z84O6PoOUrbpheYkVpc,3086
+langchain/chains/natbot/__init__.py,sha256=ACF2TYNK_CTfvmdLlG5Ry0_j9D6ZfjgfQxmeKe1BAIg,96
+langchain/chains/natbot/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/natbot/__pycache__/base.cpython-311.pyc,,
+langchain/chains/natbot/__pycache__/crawler.cpython-311.pyc,,
+langchain/chains/natbot/__pycache__/prompt.cpython-311.pyc,,
+langchain/chains/natbot/base.py,sha256=avFMaNgU6sShSTpMwM68AYYivABoivruMWY0gHDXHMQ,4695
+langchain/chains/natbot/crawler.py,sha256=E1mQUEsg8Jj6Eth-LBUcMU-Zc88JEA3a79kMhHkKO08,16050
+langchain/chains/natbot/prompt.py,sha256=zB95SYLG5_12ABFFGDtDi8vVP9DSdPoP8UCjrar_4TI,4989
+langchain/chains/openai_functions/__init__.py,sha256=N3C_4M_dKQxn7jfYCbyqxUaug0JoRTv3mIKjTpJERRk,1357
+langchain/chains/openai_functions/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/openai_functions/__pycache__/base.cpython-311.pyc,,
+langchain/chains/openai_functions/__pycache__/citation_fuzzy_match.cpython-311.pyc,,
+langchain/chains/openai_functions/__pycache__/extraction.cpython-311.pyc,,
+langchain/chains/openai_functions/__pycache__/openapi.cpython-311.pyc,,
+langchain/chains/openai_functions/__pycache__/qa_with_structure.cpython-311.pyc,,
+langchain/chains/openai_functions/__pycache__/tagging.cpython-311.pyc,,
+langchain/chains/openai_functions/__pycache__/utils.cpython-311.pyc,,
+langchain/chains/openai_functions/base.py,sha256=XgHRdFgQ1FyXvtVkS-iMlzqjfg0gdQSUOcGohFbiHq0,10158
+langchain/chains/openai_functions/citation_fuzzy_match.py,sha256=bHkYOhTgEG1wIhdC06WL6Wmnc_s-KctLs1cC5PLxwgQ,3558
+langchain/chains/openai_functions/extraction.py,sha256=0DXlHc0mm2GMQfTX8bvSkZe28BemAr8D6yKtkL53GVQ,4078
+langchain/chains/openai_functions/openapi.py,sha256=fJEQLogvwmW0eKQkQ3mvGeZK3vP1_y9K7CHflnghAUI,11311
+langchain/chains/openai_functions/qa_with_structure.py,sha256=MmOrJnrfknmXAdEi588-YAqL7Pc3Qdk7VsLMc97z6wU,3959
+langchain/chains/openai_functions/tagging.py,sha256=rQAv7Nx_YoLKhZMbCmGGvvNmuM5Nvnt5E374zxj78SE,2665
+langchain/chains/openai_functions/utils.py,sha256=AVp04lmZEoAiHAQ2LZqOXavNvC_11hL-rJ0X-jVuchA,1257
+langchain/chains/openai_tools/__init__.py,sha256=xX0If1Nx_ocEOI56EGxCI0v0RZ1_VUegzyODAj0RLVU,134
+langchain/chains/openai_tools/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/openai_tools/__pycache__/extraction.cpython-311.pyc,,
+langchain/chains/openai_tools/extraction.py,sha256=cxdCDzwTa9Pwrof26-PSX7YKu_5xtgwLq9eUj4fH52E,1665
+langchain/chains/prompt_selector.py,sha256=zJdUcMQctOZd5dMXcXSCwMwQssnLvCecHYFDEOiHphU,2015
+langchain/chains/qa_generation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/chains/qa_generation/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/qa_generation/__pycache__/base.cpython-311.pyc,,
+langchain/chains/qa_generation/__pycache__/prompt.cpython-311.pyc,,
+langchain/chains/qa_generation/base.py,sha256=MPwn8l8O3ZB5M3dJ2-4CEyaV4tjx_NwAxyCqJ9XkiBM,2465
+langchain/chains/qa_generation/prompt.py,sha256=W3lYKPUDSKS4N6b_FWlKzjn0tU5J4iQ8CF2FixdtqBo,1875
+langchain/chains/qa_with_sources/__init__.py,sha256=gQYb3ZPPIVdqOG-4Kv-ZrU5mHyETsBp3tqvN4LV3fh8,173
+langchain/chains/qa_with_sources/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/qa_with_sources/__pycache__/base.cpython-311.pyc,,
+langchain/chains/qa_with_sources/__pycache__/loading.cpython-311.pyc,,
+langchain/chains/qa_with_sources/__pycache__/map_reduce_prompt.cpython-311.pyc,,
+langchain/chains/qa_with_sources/__pycache__/refine_prompts.cpython-311.pyc,,
+langchain/chains/qa_with_sources/__pycache__/retrieval.cpython-311.pyc,,
+langchain/chains/qa_with_sources/__pycache__/stuff_prompt.cpython-311.pyc,,
+langchain/chains/qa_with_sources/__pycache__/vector_db.cpython-311.pyc,,
+langchain/chains/qa_with_sources/base.py,sha256=bM6Z3aMMqx2xoXFDQvVcNa2snvM99I_RHnpjk6hz2q0,7998
+langchain/chains/qa_with_sources/loading.py,sha256=JxrNFxJVz4TAtsFeiHfplWfeXXkAvz23YqZu2fJxKwE,7079
+langchain/chains/qa_with_sources/map_reduce_prompt.py,sha256=hAM6OZbefpaaANdFYElB9feUi1iTlg0h54NDrFOw6Fo,6971
+langchain/chains/qa_with_sources/refine_prompts.py,sha256=MIwQfIXjFFjmNmwgMIq9yM5rOQdjswHnShNpNNc1BwM,1318
+langchain/chains/qa_with_sources/retrieval.py,sha256=7gEql_-w-1dk3Vlf8yF48_7o1uFCR2U0jjnLWUX5hCc,2459
+langchain/chains/qa_with_sources/stuff_prompt.py,sha256=xfcB5tVDHFXTYZnPFzuJJGO7rBoFuZGENhRHLzI5bzM,6581
+langchain/chains/qa_with_sources/vector_db.py,sha256=lUbPxtuFMP6cakVCmKt2ICrxwNJya1Q1ce9rgeNGh00,2770
+langchain/chains/query_constructor/__init__.py,sha256=JGoT8jfg3jm9-22EgMY5OsDFZcnG83E_BH5iNt387aw,131
+langchain/chains/query_constructor/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/query_constructor/__pycache__/base.cpython-311.pyc,,
+langchain/chains/query_constructor/__pycache__/ir.cpython-311.pyc,,
+langchain/chains/query_constructor/__pycache__/parser.cpython-311.pyc,,
+langchain/chains/query_constructor/__pycache__/prompt.cpython-311.pyc,,
+langchain/chains/query_constructor/__pycache__/schema.cpython-311.pyc,,
+langchain/chains/query_constructor/base.py,sha256=4_VkSYEA0k8ZcMywHyW7PPLyHIsR0MSMPDmLQFQcJTw,13686
+langchain/chains/query_constructor/ir.py,sha256=MYBIqLPp-SVgLUM6W9vvSFP2n0y10l6W6gWg-khgmxg,3841
+langchain/chains/query_constructor/parser.py,sha256=UReYBC7LIQKq9FEO9NnjIIWH42FhE_az82QE1S4KgYw,5707
+langchain/chains/query_constructor/prompt.py,sha256=rwEsTr29cKBKPnn6vKB5rFw-youslUIFQoRIBkBh-j0,6880
+langchain/chains/query_constructor/schema.py,sha256=UkSYoiLVw2M6onveRNUoOPphIfhFN7OBpf-BOxXwLJw,321
+langchain/chains/question_answering/__init__.py,sha256=EzCn6v689pqrqgOESQDbSteg0E_5oPnDFuri4X_9JwQ,8811
+langchain/chains/question_answering/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/question_answering/__pycache__/map_reduce_prompt.cpython-311.pyc,,
+langchain/chains/question_answering/__pycache__/map_rerank_prompt.cpython-311.pyc,,
+langchain/chains/question_answering/__pycache__/refine_prompts.cpython-311.pyc,,
+langchain/chains/question_answering/__pycache__/stuff_prompt.cpython-311.pyc,,
+langchain/chains/question_answering/map_reduce_prompt.py,sha256=CrerC8PqW1-V8SsQQsFsMd7dfjTb04Urf2naQYVGxl0,8013
+langchain/chains/question_answering/map_rerank_prompt.py,sha256=l2Ha1Xqr5Q6Y-Xh9af8JTni9gLAyhKJhmSErRFGw9s4,1622
+langchain/chains/question_answering/refine_prompts.py,sha256=JbQKbGaHo-IoHw1Wl16mMvqTi9kjmp_5NK526C_9_nM,2378
+langchain/chains/question_answering/stuff_prompt.py,sha256=tXecxj10u9x0taPz4I1Kn-J0SOYcjIfr_8RINw9P7ys,1146
+langchain/chains/retrieval.py,sha256=-ZHLdDQUkIQLjF9DMvpH_YgZKxShTm0GaSIhw1ab_EM,2742
+langchain/chains/retrieval_qa/__init__.py,sha256=MGGNuZ-HVZDyk551hUjGexK3U9q-2Yi_VJkpi7MV2DE,62
+langchain/chains/retrieval_qa/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/retrieval_qa/__pycache__/base.cpython-311.pyc,,
+langchain/chains/retrieval_qa/__pycache__/prompt.cpython-311.pyc,,
+langchain/chains/retrieval_qa/base.py,sha256=UJ8sVTKmoq2CoM7i_Bl-N7N3jKxmpjXBI6tJW2zSuz4,9952
+langchain/chains/retrieval_qa/prompt.py,sha256=c5_tFGFbltYvM9P6K_Zk3dOeYYbiSFN-MkJK6HBoNuA,399
+langchain/chains/router/__init__.py,sha256=r66J28FWIORVB5QIZ1d8R_HsiBaV1eQMZDZvMC43oAQ,407
+langchain/chains/router/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/router/__pycache__/base.cpython-311.pyc,,
+langchain/chains/router/__pycache__/embedding_router.cpython-311.pyc,,
+langchain/chains/router/__pycache__/llm_router.cpython-311.pyc,,
+langchain/chains/router/__pycache__/multi_prompt.cpython-311.pyc,,
+langchain/chains/router/__pycache__/multi_prompt_prompt.cpython-311.pyc,,
+langchain/chains/router/__pycache__/multi_retrieval_prompt.cpython-311.pyc,,
+langchain/chains/router/__pycache__/multi_retrieval_qa.cpython-311.pyc,,
+langchain/chains/router/base.py,sha256=J-6nh4gZSdasPvpMP9dW73u1MHHA6ZuCV8iKvTEJViM,4571
+langchain/chains/router/embedding_router.py,sha256=Mhzh4V011HbVcn2rYeLkpqeBSFS11GMjndJNjMR0Vd4,3124
+langchain/chains/router/llm_router.py,sha256=KCn1qkIQGkcCu9Vu3ERP_2uH5ZtlNj550MnmL0dFRr4,4349
+langchain/chains/router/multi_prompt.py,sha256=gr1WhGbytCaG6E6_ZXDTPs8zs4gwG3Wru8bVTCx_ezU,2245
+langchain/chains/router/multi_prompt_prompt.py,sha256=T8UbIuxblnI6Byhw-BMAzwQcbB5ww3N6BiMqMJxS6Jc,1156
+langchain/chains/router/multi_retrieval_prompt.py,sha256=VUYGLWbwGiv03aSMW5sjdGNwsEa9FKgq0RcK5o3lkH4,1079
+langchain/chains/router/multi_retrieval_qa.py,sha256=Q3YWBHeK0BE92NyucOmqf_buHDf7nNIYilTiVeg-BVw,3659
+langchain/chains/sequential.py,sha256=ygb_VOKXWZ-Fy2aBSeG4W6G5DhqDF2H_W6_g7HRu8Vg,7510
+langchain/chains/sql_database/__init__.py,sha256=jQotWN4EWMD98Jk-f7rqh5YtbXbP9XXA0ypLGq8NgrM,47
+langchain/chains/sql_database/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/sql_database/__pycache__/prompt.cpython-311.pyc,,
+langchain/chains/sql_database/__pycache__/query.cpython-311.pyc,,
+langchain/chains/sql_database/prompt.py,sha256=W0xFqVZ18PzxmutnIBJrocXus8_QBByrKtxg8CjGaYw,15458
+langchain/chains/sql_database/query.py,sha256=bHDGjWJ-JcFFch8nQ_aqBgvPc6fYniRUYONVBEW9nFY,5293
+langchain/chains/structured_output/__init__.py,sha256=-6nFe-gznavFc3XCMv8XkEzuXoto2rI8Q-bcruVPOR8,204
+langchain/chains/structured_output/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/structured_output/__pycache__/base.cpython-311.pyc,,
+langchain/chains/structured_output/base.py,sha256=DFv3U8AIm1rItXjUeEEUX2ihtuwMDxBRFHt1lCxCkEg,22268
+langchain/chains/summarize/__init__.py,sha256=-vj0oCLooN4oGf9hsyuqJsHebaqg1_1AcMclRz9MOys,6192
+langchain/chains/summarize/__pycache__/__init__.cpython-311.pyc,,
+langchain/chains/summarize/__pycache__/map_reduce_prompt.cpython-311.pyc,,
+langchain/chains/summarize/__pycache__/refine_prompts.cpython-311.pyc,,
+langchain/chains/summarize/__pycache__/stuff_prompt.cpython-311.pyc,,
+langchain/chains/summarize/map_reduce_prompt.py,sha256=HZSitW2_WhJINN-_YJCzU6zJXbPuMr5zFek31AzutuQ,238
+langchain/chains/summarize/refine_prompts.py,sha256=CDXZDJWOV0jg-CwvQv5g1P86Xqd0aLFmUx7LLFiW_Qg,677
+langchain/chains/summarize/stuff_prompt.py,sha256=HZSitW2_WhJINN-_YJCzU6zJXbPuMr5zFek31AzutuQ,238
+langchain/chains/transform.py,sha256=tREbHjjRwCgH8r_j6dyWYaax8LqaDrS9cKgW1yVGhn8,2369
+langchain/chat_loaders/__init__.py,sha256=sDjTrVHWFwv4pySOIvIIUj2NwAI8Okf-i1lyIWuDFAI,452
+langchain/chat_loaders/__pycache__/__init__.cpython-311.pyc,,
+langchain/chat_loaders/__pycache__/base.cpython-311.pyc,,
+langchain/chat_loaders/__pycache__/facebook_messenger.cpython-311.pyc,,
+langchain/chat_loaders/__pycache__/gmail.cpython-311.pyc,,
+langchain/chat_loaders/__pycache__/imessage.cpython-311.pyc,,
+langchain/chat_loaders/__pycache__/langsmith.cpython-311.pyc,,
+langchain/chat_loaders/__pycache__/slack.cpython-311.pyc,,
+langchain/chat_loaders/__pycache__/telegram.cpython-311.pyc,,
+langchain/chat_loaders/__pycache__/utils.cpython-311.pyc,,
+langchain/chat_loaders/__pycache__/whatsapp.cpython-311.pyc,,
+langchain/chat_loaders/base.py,sha256=X4rrBZztqw5jIOYBCDL1XDupTJ32SlZBJjj4KLq1zpA,95
+langchain/chat_loaders/facebook_messenger.py,sha256=km0v6b5jJ0NAZ0ig-aNEWOCCEwuajo8yXNAbV3GTC4Y,240
+langchain/chat_loaders/gmail.py,sha256=O0R7c5Noja9agYTNb4tzE7UxgsZSsZpwkZynZucg9LI,99
+langchain/chat_loaders/imessage.py,sha256=xMHSJZ2h8K-qczZkhFcUXU7GKVG5DYcUQMNtVbViWks,107
+langchain/chat_loaders/langsmith.py,sha256=4Kec5J1go_fMFUu_fqqFcvHjJsqBxEMEXATm62SY1N4,187
+langchain/chat_loaders/slack.py,sha256=Vxbe6HOjbuao9hQucjNz4_5ZLUWoN7yfob8DfbfjXdk,98
+langchain/chat_loaders/telegram.py,sha256=3GN7gpBMXIzMdmaR0Sf276IGkEH-ET6kwat5Dex1uwY,107
+langchain/chat_loaders/utils.py,sha256=Fh5e-UTJY1zYuGmmau_Euo2yBPhnYAZeH8svYWu7zmQ,290
+langchain/chat_loaders/whatsapp.py,sha256=rkg-1EiFjY1U6M6zQDqaf614JeOrj9APbVEOmjTxPh8,107
+langchain/chat_models/__init__.py,sha256=M9h4bKy66cSmFzxcodQdtMeRGdBceV0yXJ8MIz2dgIc,1979
+langchain/chat_models/__pycache__/__init__.cpython-311.pyc,,
+langchain/chat_models/__pycache__/anthropic.cpython-311.pyc,,
+langchain/chat_models/__pycache__/anyscale.cpython-311.pyc,,
+langchain/chat_models/__pycache__/azure_openai.cpython-311.pyc,,
+langchain/chat_models/__pycache__/azureml_endpoint.cpython-311.pyc,,
+langchain/chat_models/__pycache__/baichuan.cpython-311.pyc,,
+langchain/chat_models/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc,,
+langchain/chat_models/__pycache__/base.cpython-311.pyc,,
+langchain/chat_models/__pycache__/bedrock.cpython-311.pyc,,
+langchain/chat_models/__pycache__/cohere.cpython-311.pyc,,
+langchain/chat_models/__pycache__/databricks.cpython-311.pyc,,
+langchain/chat_models/__pycache__/ernie.cpython-311.pyc,,
+langchain/chat_models/__pycache__/everlyai.cpython-311.pyc,,
+langchain/chat_models/__pycache__/fake.cpython-311.pyc,,
+langchain/chat_models/__pycache__/fireworks.cpython-311.pyc,,
+langchain/chat_models/__pycache__/gigachat.cpython-311.pyc,,
+langchain/chat_models/__pycache__/google_palm.cpython-311.pyc,,
+langchain/chat_models/__pycache__/human.cpython-311.pyc,,
+langchain/chat_models/__pycache__/hunyuan.cpython-311.pyc,,
+langchain/chat_models/__pycache__/javelin_ai_gateway.cpython-311.pyc,,
+langchain/chat_models/__pycache__/jinachat.cpython-311.pyc,,
+langchain/chat_models/__pycache__/konko.cpython-311.pyc,,
+langchain/chat_models/__pycache__/litellm.cpython-311.pyc,,
+langchain/chat_models/__pycache__/meta.cpython-311.pyc,,
+langchain/chat_models/__pycache__/minimax.cpython-311.pyc,,
+langchain/chat_models/__pycache__/mlflow.cpython-311.pyc,,
+langchain/chat_models/__pycache__/mlflow_ai_gateway.cpython-311.pyc,,
+langchain/chat_models/__pycache__/ollama.cpython-311.pyc,,
+langchain/chat_models/__pycache__/openai.cpython-311.pyc,,
+langchain/chat_models/__pycache__/pai_eas_endpoint.cpython-311.pyc,,
+langchain/chat_models/__pycache__/promptlayer_openai.cpython-311.pyc,,
+langchain/chat_models/__pycache__/tongyi.cpython-311.pyc,,
+langchain/chat_models/__pycache__/vertexai.cpython-311.pyc,,
+langchain/chat_models/__pycache__/volcengine_maas.cpython-311.pyc,,
+langchain/chat_models/__pycache__/yandex.cpython-311.pyc,,
+langchain/chat_models/anthropic.py,sha256=khjY0ERtGokOHNOSLH5P61dSVqTBY-a_7v2yGKvibtM,199
+langchain/chat_models/anyscale.py,sha256=uvRNZsW65pGLPBUoo0ioEwvJFFNyBidR2g2gu0JKzag,103
+langchain/chat_models/azure_openai.py,sha256=5jzcUvsGyZdkM8JFHZyLZhI2bzHehR5b3G5FLZNPhM4,104
+langchain/chat_models/azureml_endpoint.py,sha256=dxvxl7qtnT2U2YmUF7NB8Ns6dcS9K-JUZJy6io_2BBs,189
+langchain/chat_models/baichuan.py,sha256=8HvBXykCoM18QU0rvD7JG4rNz2-BwA0O7G-bcvG-zQc,110
+langchain/chat_models/baidu_qianfan_endpoint.py,sha256=IplOCoCWL4d2KS26NV5conuJzG_0749cynwGnaSRU5w,131
+langchain/chat_models/base.py,sha256=HdTXvrDvUzA07YrjFFEt0HkTt2WGsURvuQT-a9b4xoo,268
+langchain/chat_models/bedrock.py,sha256=O1s52MoFC4ngU4WOp3aV_LpXZpLhMhHwrXbTDaVm7hc,131
+langchain/chat_models/cohere.py,sha256=4kXyiZ17yHpQiIjJakPscDIpQJrdzgYbZLYgY8Lb_xQ,97
+langchain/chat_models/databricks.py,sha256=E_EXyxlVwzh_k0DYoRVvciKNLDIb5bUdsJUbFdMUWso,100
+langchain/chat_models/ernie.py,sha256=CS2ZmggKbusHXOF1ZZK7TQfwsyEmXQIxMdWZrs_F09U,91
+langchain/chat_models/everlyai.py,sha256=Aot8lIhAFPF2XL1xMClfgnq6owumZ-E5jWItqDFRHW0,103
+langchain/chat_models/fake.py,sha256=qVfOMLN4iI7hQFVcm7J9izNdV8rrPnMGxyq1j1zlxvo,169
+langchain/chat_models/fireworks.py,sha256=a7KKQ6rlv12mvwzqAAVC3s0DSzNZoqnMSFIZEIulgSY,113
+langchain/chat_models/gigachat.py,sha256=8b6BjHlSZc0cplConAW11gcRmq7Xc-MdJtI8B50Nw4c,95
+langchain/chat_models/google_palm.py,sha256=GYihvfYZSCw5uxdanh0zNB069oclB4Ajwk0LVK1JysA,158
+langchain/chat_models/human.py,sha256=diEOkP6cu4gMgUYhYmDnZp7eoVXRNqWLEiacq1ku5n0,114
+langchain/chat_models/hunyuan.py,sha256=t2yNQDEHARSLw4B7CpoMeZMavbl_dh3fTvFK9PHa0HA,107
+langchain/chat_models/javelin_ai_gateway.py,sha256=VJad65o97rzB-1u18LG4HPHwV7t-pCcth6KerMQ9EAU,159
+langchain/chat_models/jinachat.py,sha256=n5iS5HfiHXFaZKp6EYYj_joBVl4DTxUxEgLfgRKg3Yg,102
+langchain/chat_models/konko.py,sha256=2PlDdCpG2tDdAhqWi4ckP9gDP1y8DNZv6wijycTG6U0,94
+langchain/chat_models/litellm.py,sha256=U13Zzvof5xBNP5H_mv2-U6gPRhr42LK5vkaOS6o4YAI,137
+langchain/chat_models/meta.py,sha256=C2pWADuQ5MZgG9e79fX1YEHXIOxj_0I86WAh9E2qzAU,139
+langchain/chat_models/minimax.py,sha256=Yu-KZznIL27GI8Ipnzaa-gC8B6A3QNs_xMXavAYr5Gw,100
+langchain/chat_models/mlflow.py,sha256=A-JIh1_2eI2tRaVYVizHPevoxnPg96Y1KGfxxw0lCrI,88
+langchain/chat_models/mlflow_ai_gateway.py,sha256=12RpSiD-z9swpfZyyh_qYIg2WTBDrSQsOcJ_BLt4ofM,156
+langchain/chat_models/ollama.py,sha256=dT3U41WnqESrjoVQWpOg-SpbYeHoyc3xmG8EMKyRIvc,97
+langchain/chat_models/openai.py,sha256=dI_dAdvJWwydZod5h9V0bbqzOuW3ukWlob0JbASpUx8,104
+langchain/chat_models/pai_eas_endpoint.py,sha256=WIysHsKjFRsr53OG-lsm5gYjnXr2enoazM10CGxyWY8,114
+langchain/chat_models/promptlayer_openai.py,sha256=fJP_VASGa4N4uLN4AN-MVkR3pErEzAdjtFWEKZdKAFM,122
+langchain/chat_models/tongyi.py,sha256=bnB37UIZRs0FPmHzO4KkFyFPvlMZ1mhlSddbH9SspFM,104
+langchain/chat_models/vertexai.py,sha256=8z2M6Bp8m1G5cm8BpQ-Vl9P46vSPPDitfm9o6FGpUXI,110
+langchain/chat_models/volcengine_maas.py,sha256=FDh7Ww0y-4BTAP4E2e-zTs7NXF1-t128aYxG9neOETI,178
+langchain/chat_models/yandex.py,sha256=eVHa5dbsfSmHWiIYi8I8qpITI-jawmXoigeAA6GMe1Q,103
+langchain/docstore/__init__.py,sha256=6YZGI0QU35q8nkRWIgz7UzVSKVsNe0zZad6RY_z-p8E,1184
+langchain/docstore/__pycache__/__init__.cpython-311.pyc,,
+langchain/docstore/__pycache__/arbitrary_fn.cpython-311.pyc,,
+langchain/docstore/__pycache__/base.cpython-311.pyc,,
+langchain/docstore/__pycache__/document.cpython-311.pyc,,
+langchain/docstore/__pycache__/in_memory.cpython-311.pyc,,
+langchain/docstore/__pycache__/wikipedia.cpython-311.pyc,,
+langchain/docstore/arbitrary_fn.py,sha256=fAidb5t-Oxr5EKQZ2bxjnkKIZhMKMm-gijx7Yx4nJLI,91
+langchain/docstore/base.py,sha256=D6qa-5aYlDZFaSdRMhZZ_sx2Bs67s2mDOtSprISVDoI,109
+langchain/docstore/document.py,sha256=oNDzAxnJM3S8h2Pn13b_z5Q6kllet0wXi11nEMDi7X4,70
+langchain/docstore/in_memory.py,sha256=Dlvxs1iKoJRD79-y159f-w_1-t2GSoP9vm3xSKKd3a0,100
+langchain/docstore/wikipedia.py,sha256=4i0Mk1ZqXNeceebBZheTAtNJSRYzWr7g2XRdhKBpT_g,86
+langchain/document_loaders/__init__.py,sha256=b9BrKNbUKQuP5fVkQri75KCQmy04Yxib4I41w19qrRU,5741
+langchain/document_loaders/__pycache__/__init__.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/acreom.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/airbyte.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/airbyte_json.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/airtable.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/apify_dataset.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/arcgis_loader.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/arxiv.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/assemblyai.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/async_html.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/azlyrics.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/azure_ai_data.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/azure_blob_storage_container.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/azure_blob_storage_file.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/baiducloud_bos_directory.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/baiducloud_bos_file.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/base.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/base_o365.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/bibtex.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/bigquery.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/bilibili.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/blackboard.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/blockchain.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/brave_search.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/browserless.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/chatgpt.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/chromium.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/college_confidential.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/concurrent.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/confluence.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/conllu.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/couchbase.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/csv_loader.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/cube_semantic.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/datadog_logs.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/dataframe.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/diffbot.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/directory.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/discord.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/docugami.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/docusaurus.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/dropbox.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/duckdb_loader.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/email.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/epub.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/etherscan.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/evernote.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/excel.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/facebook_chat.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/fauna.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/figma.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/gcs_directory.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/gcs_file.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/generic.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/geodataframe.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/git.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/gitbook.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/github.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/google_speech_to_text.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/googledrive.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/gutenberg.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/helpers.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/hn.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/html.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/html_bs.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/hugging_face_dataset.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/ifixit.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/image.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/image_captions.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/imsdb.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/iugu.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/joplin.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/json_loader.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/lakefs.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/larksuite.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/markdown.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/mastodon.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/max_compute.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/mediawikidump.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/merge.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/mhtml.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/modern_treasury.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/mongodb.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/news.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/notebook.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/notion.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/notiondb.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/nuclia.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/obs_directory.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/obs_file.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/obsidian.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/odt.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/onedrive.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/onedrive_file.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/onenote.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/open_city_data.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/org_mode.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/pdf.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/polars_dataframe.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/powerpoint.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/psychic.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/pubmed.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/pyspark_dataframe.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/python.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/quip.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/readthedocs.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/recursive_url_loader.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/reddit.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/roam.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/rocksetdb.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/rspace.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/rss.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/rst.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/rtf.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/s3_directory.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/s3_file.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/sharepoint.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/sitemap.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/slack_directory.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/snowflake_loader.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/spreedly.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/srt.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/stripe.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/telegram.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/tencent_cos_directory.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/tencent_cos_file.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/tensorflow_datasets.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/text.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/tomarkdown.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/toml.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/trello.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/tsv.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/twitter.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/unstructured.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/url.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/url_playwright.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/url_selenium.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/weather.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/web_base.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/whatsapp_chat.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/wikipedia.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/word_document.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/xml.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/xorbits.cpython-311.pyc,,
+langchain/document_loaders/__pycache__/youtube.cpython-311.pyc,,
+langchain/document_loaders/acreom.py,sha256=2aC6TmsMaEotEieAC0Ap7Ciwe8R3SdpPs6syZcdflxg,97
+langchain/document_loaders/airbyte.py,sha256=VLU6oeBxRehOCollcFkxckbcF6wPlvL-yC0iPI3VwNE,554
+langchain/document_loaders/airbyte_json.py,sha256=WolTl9yUiYIDfn88Qqj7PRSy5N0_TMjjGsQGTZ6j-Xw,113
+langchain/document_loaders/airtable.py,sha256=r9QKWIp-IknSh1o3Z_DhBwIQRKHY8KMudamXG3ezaD4,103
+langchain/document_loaders/apify_dataset.py,sha256=_p8uqUPQbXCjnsXQCndSHrQsPfua0-f4m_yYsL4ktZM,116
+langchain/document_loaders/arcgis_loader.py,sha256=3I1Tn93o8PKgEgqSo1b6YaR6aouKu1XZNN9f2acY5xg,113
+langchain/document_loaders/arxiv.py,sha256=edS5tLcqFxGLzZUH_STO-BYuGUy09mGKvdIfgr7oPLo,94
+langchain/document_loaders/assemblyai.py,sha256=xPVaBmsgB3bg-X8pXOW0xbxfP8o_dEu-ErhP2l_or9o,190
+langchain/document_loaders/async_html.py,sha256=f8fkDznIE8nwtE2b7eGvvEDVJWXAOQBmYn1RzvgSb7c,116
+langchain/document_loaders/azlyrics.py,sha256=WKtFqEYIou7IBw_kO4jPRNkd-sa7blxD9_aBxpHeuco,103
+langchain/document_loaders/azure_ai_data.py,sha256=SrwrHfSYqeFsQebTL-Ps68v7Dt-9nIuCjaFxExHJzEk,114
+langchain/document_loaders/azure_blob_storage_container.py,sha256=ug5xG8mg32bcIGdqAhIC-6r5buCor3lNqJyIQ7VPA0M,166
+langchain/document_loaders/azure_blob_storage_file.py,sha256=V6Lwr8wul5k6U-dyenD0Y0T94snPdgN_DxzNSoATWEo,151
+langchain/document_loaders/baiducloud_bos_directory.py,sha256=SnwLuRrjQUwkqXA9vGIq59ZpnJUOrRZdLriu6bfgYGk,146
+langchain/document_loaders/baiducloud_bos_file.py,sha256=hamzs11lOO3SkjECjndXK0_kW7bcI65CSr5Yf3a-0g4,122
+langchain/document_loaders/base.py,sha256=Uga5YyikHXJ4msG9WqN8-beA6N47MyhHdhlBHLD3tM0,125
+langchain/document_loaders/base_o365.py,sha256=8Wl_vihS8C3bgcHTX7PevlFPRVS-vwD4975Cvr120rM,120
+langchain/document_loaders/bibtex.py,sha256=friGimgnSVmV7GV52cCNj9IIkKinI2m-aiYFoD9jwTA,97
+langchain/document_loaders/bigquery.py,sha256=4ETKb1UBGFARk5yT2YhP9FGdj_yfsGxglLFSoIpSJLY,103
+langchain/document_loaders/bilibili.py,sha256=gjNykh66qAox95BQR-IxoHlwpkauYCdPeg_MQvkfKHQ,103
+langchain/document_loaders/blackboard.py,sha256=J5HykJCJs3FKZeP6jBkLhuI4ZUSD_EckZRuAoSqNHuM,109
+langchain/document_loaders/blob_loaders/__init__.py,sha256=F0M0CRCzj8SQ9Bqs6xZ3dd1ycAHJBIj8DZzOn5ANSo0,374
+langchain/document_loaders/blob_loaders/__pycache__/__init__.cpython-311.pyc,,
+langchain/document_loaders/blob_loaders/__pycache__/file_system.cpython-311.pyc,,
+langchain/document_loaders/blob_loaders/__pycache__/schema.cpython-311.pyc,,
+langchain/document_loaders/blob_loaders/__pycache__/youtube_audio.cpython-311.pyc,,
+langchain/document_loaders/blob_loaders/file_system.py,sha256=QoDEfOzXBS_ScsdBxDmM3LZuXWY-Cm5dzGLnQbLzrgs,140
+langchain/document_loaders/blob_loaders/schema.py,sha256=Qs54nNEQ3sHpMrh0o8-1f0Nfo7IHGGoupXIXXvtVSok,159
+langchain/document_loaders/blob_loaders/youtube_audio.py,sha256=s1FPNvo7r-jHl5vlEQGvwpc9ngPdKv1O-G4bLli7iBU,138
+langchain/document_loaders/blockchain.py,sha256=Jy1Ar7oPs5nV5cFR2YHNu84wXIrAkWzt2WOZoja-fCU,172
+langchain/document_loaders/brave_search.py,sha256=QjNEorc7XdKMkdvLje0G5RpAs0epLu54Ci4k-WHjNuc,113
+langchain/document_loaders/browserless.py,sha256=ABG9peWXC_m8CbpKVYROO2fjZeyIVR9npX8MaizOmOc,112
+langchain/document_loaders/chatgpt.py,sha256=zkHmIi1PuMil0CNXvjSYssrTB84iva2gj99vpaPpS-g,138
+langchain/document_loaders/chromium.py,sha256=DC8Xg3A0mnr9u1M57X6hDu1iGH2-21c8nMkzmk6EImQ,113
+langchain/document_loaders/college_confidential.py,sha256=-rnb1rPYm3YqgGmJIbgk8VdQ_zUZ_LD5gpkpvpTU5fY,146
+langchain/document_loaders/concurrent.py,sha256=xaNsV2zu7bgxWgD39t1PHyCKkmxAJOHUPSIK71ErxDo,118
+langchain/document_loaders/confluence.py,sha256=gECecXPaunMxwF_YHAF3kfhBCr7TVEpIqvEpDt6hiys,154
+langchain/document_loaders/conllu.py,sha256=4lWFDsgw8oybAcb4Vkl1i90ENEVLJOrFT2brOulPhkw,97
+langchain/document_loaders/couchbase.py,sha256=LTN5yTV-Z4Y_jmP3PJBJFjuHftZcbpTPROGwJRzA094,106
+langchain/document_loaders/csv_loader.py,sha256=3FA2jic_kaxnUg-NeibjkcbBmOgxe8arCI0DkINV4_8,156
+langchain/document_loaders/cube_semantic.py,sha256=q8OEDeZAF190obpzF_s3RAGnRMPVKgn1wvAOZB2kQLw,116
+langchain/document_loaders/datadog_logs.py,sha256=GsVJno84hNpyHpzRb3sONnEsoB1221xHGZeltl-ksiA,113
+langchain/document_loaders/dataframe.py,sha256=_--Kpf3l9pknIIOI6LoJB5AGxlV3_600tJcLGFr-dW4,163
+langchain/document_loaders/diffbot.py,sha256=o-Lm18-NnASw8fKICb0uAGkSupkU-jmYCNZgStIPF1Q,100
+langchain/document_loaders/directory.py,sha256=i8-bCLef6Xzk6bmDkAI2c3qfkqCpFaOS3vVTpxsRb8g,115
+langchain/document_loaders/discord.py,sha256=z2m_PxH7CVfxC-x0Umf3S4YKDDScb-r2ZMhErshBgmQ,108
+langchain/document_loaders/docugami.py,sha256=lbo-Es0F0wTaoYrBLHSBcBPg2Mat_NUsNc0Od05xIZA,119
+langchain/document_loaders/docusaurus.py,sha256=og31qnrnLRz-roHSym1BZgCp0sxMQXZZc35Sypg4nY0,109
+langchain/document_loaders/dropbox.py,sha256=HYiZfM3kEwb0AvyB4bFJYZTefYWG2PMSjN51E0XziDA,100
+langchain/document_loaders/duckdb_loader.py,sha256=_onzlpYp0agjGoz7VgrKJFZfnVoie9y5tEz4_AZwgf4,104
+langchain/document_loaders/email.py,sha256=7cgG2LcYgReH7ozGhNJuXcmLf2GgA7V4xzbMdn5o3cE,177
+langchain/document_loaders/epub.py,sha256=wdu5IrijnQ6vLPPWCFXSHGzku91owGYpXFHlqu1p8qQ,115
+langchain/document_loaders/etherscan.py,sha256=rVx9XDnZ13yjSvP34Q3Du4EYUYWMfOxTpIFA7rp4OIs,106
+langchain/document_loaders/evernote.py,sha256=5QQVRFj6wV6cO7blrlhlr5UTaZT40o_hKGypL_hE2Fs,103
+langchain/document_loaders/excel.py,sha256=0g45g8_UD9la_Eyv4xfzS9hUw_Z_EAJgdrgG3Lcj92Y,118
+langchain/document_loaders/facebook_chat.py,sha256=yNWaTCfrbfGFP76Ca3OyIBUUju99VM4_lMs0FSWpQfs,167
+langchain/document_loaders/fauna.py,sha256=tuGEqlYe5b4PAMIWAYv65dymBUu6JI2NLbahZ-9evh4,94
+langchain/document_loaders/figma.py,sha256=bwwD8WITK5dsyXowYVw8cydRAxghIk6L-wNuHwdpjNg,102
+langchain/document_loaders/gcs_directory.py,sha256=TTKA4Hy6ZuEzWd5V4ktAY6yuevJOOHlS6N_CRkRAZtk,116
+langchain/document_loaders/gcs_file.py,sha256=KS-ylZR28l3AYcmYL5LpBRGP08BDe-_F8R-ldMjvRF4,101
+langchain/document_loaders/generic.py,sha256=T9NKWR9WTTls7lZ-uBSHb6op60NHpz6AwDrxuQsy68Q,100
+langchain/document_loaders/geodataframe.py,sha256=s0qeUkPHLjZAiP05NnLHvRRuR10fvJc8FIQENVNMtZE,115
+langchain/document_loaders/git.py,sha256=ywKjpAcvqeONwI01NiSLa84HTO-z4kWwf6p_37E4YTI,88
+langchain/document_loaders/gitbook.py,sha256=AtxSfbFpsBlBXqlX9vGvOeGtp15wMsyrldQz2NWuUeY,100
+langchain/document_loaders/github.py,sha256=gs2vO2V4LuW135pf15ZD4scZhyKZFCPSvRw8KBTwG40,160
+langchain/document_loaders/google_speech_to_text.py,sha256=7dQpoP2vfzmb8BwbQnQ287MjPKi6J2kz08tcIwloYZY,145
+langchain/document_loaders/googledrive.py,sha256=Yhd0NG-c1OiLGvPvUDrOMgcfXiEYq_O-fuxjdwrDhjE,112
+langchain/document_loaders/gutenberg.py,sha256=QaY_lRF9MT0nuQhMMEBNA02xbMDb6aSkoevXNq_m2HQ,106
+langchain/document_loaders/helpers.py,sha256=TPtlJ4v1o3sVwpSiX1gqDK7luvu12lN7QmEfJZDm93g,159
+langchain/document_loaders/hn.py,sha256=vanEERsQ-8lWED_1yB1LxDWhj_LH-YEsSObwZd_yGdM,85
+langchain/document_loaders/html.py,sha256=lYDt-5JhC8GKELZjGKAk26N-qtBt4YlmCYCG1eil9c0,115
+langchain/document_loaders/html_bs.py,sha256=qkkWjQj4WAaR7MQPz1n8UKdSaNnyL-nnYz99lOEhrNA,98
+langchain/document_loaders/hugging_face_dataset.py,sha256=8_406Z7DsZ8iihYcvuRkij0Z8PY3l6s5LiHQxz60x2E,144
+langchain/document_loaders/ifixit.py,sha256=gcExmrz0EYKEoQ7bSeQGpbE4ZTOP_SXjvAunfK67FN0,97
+langchain/document_loaders/image.py,sha256=UqCqthSxtC_k3EHlJnQiCtqL8zDfh0fcuU7OrRG6KUM,118
+langchain/document_loaders/image_captions.py,sha256=GPMH0b-dZlvqnnVushu2LaqSpaMO9h0zD6nVULVZKSQ,117
+langchain/document_loaders/imsdb.py,sha256=XbPrXUb0F1WK4uFDD244eDm5WMIA1DRTprOSY8NpWxs,94
+langchain/document_loaders/iugu.py,sha256=XGkgHUnkrg3f7SK3Kp7wS3feUNR87K4p2iGM9eB0FFc,91
+langchain/document_loaders/joplin.py,sha256=THrnH2zHYFl-l98UKAIw1WTY5np_tyIquglunff9DzE,97
+langchain/document_loaders/json_loader.py,sha256=kAkVsnxl9a1S0d4oLGeCfQ1EsNAVbtNlz-oZjKTQsGo,98
+langchain/document_loaders/lakefs.py,sha256=_SQhB3ShD-EHmUlVrXdTx92Js7y2u60Op-8_f5uXCNc,198
+langchain/document_loaders/larksuite.py,sha256=XMqRJ8iUf1o2ebENQ-pMJgD12k3KCDO99pJX-xjSSnk,112
+langchain/document_loaders/markdown.py,sha256=vjCwf9oQfU1q2LFuBWd0vIbgT7mqa20Kf1z3XKpyO3E,127
+langchain/document_loaders/mastodon.py,sha256=H7NtsHggo6xMerCm9EXkNwAXVL33ncusTFOgUoJk35I,122
+langchain/document_loaders/max_compute.py,sha256=roFLsx9urEFSmt6nVgojont8_DYN_qC8e3TXVFqnnfU,110
+langchain/document_loaders/mediawikidump.py,sha256=HY2L-D49igFZSBEXpxsDKZSsHndHfy4RT0zXmpygfkg,104
+langchain/document_loaders/merge.py,sha256=lJdE5cLBrMS1SknEgL72xFxWFrQQTsNcinNbBpGKXAA,104
+langchain/document_loaders/mhtml.py,sha256=elzKUNpODa1ASFxvYXWDREqqCs8rjrALsrXp8to98L0,94
+langchain/document_loaders/modern_treasury.py,sha256=S4TsaoJvtw5f2zKaQc43KM93mkt8A_8hVRpfSzaoddY,131
+langchain/document_loaders/mongodb.py,sha256=OOd_jFaFeO_2aK57O406xdK_o-H5_UWiR1A1vsgbAxQ,100
+langchain/document_loaders/news.py,sha256=fpoVktE84JQ5BIEjMTDo3a6uzg-Cryv-Y6oLfF8alKU,97
+langchain/document_loaders/notebook.py,sha256=afNfKQAtnQszq_AT5xiEEVE2eWanFJCvbUgi7vIUeZ8,196
+langchain/document_loaders/notion.py,sha256=tI3KQiM-LhJj9m5Ih1B_pxqR7L6Y0YyBXc2NwL9OfcQ,115
+langchain/document_loaders/notiondb.py,sha256=UcefhZsj_1BQjqlj0SZzn6WrTSXGz9fd50wbzVtgFCQ,112
+langchain/document_loaders/nuclia.py,sha256=fupu4tG0i0SrDN6SqzJdoQOFxVXUAYrJtOfrEcMxQLQ,97
+langchain/document_loaders/obs_directory.py,sha256=FBS-PHklJywguAmKaLHpXFOuAAFKniVMRO3gCPp8stE,116
+langchain/document_loaders/obs_file.py,sha256=g1_oNl6QLD7hecgl3D_bTb5b-FJM4fQBgcOkn3SeMtM,101
+langchain/document_loaders/obsidian.py,sha256=AX82NffZQ600d9_qBIINnQt_Nfzb0Igb30KjEgDGv70,103
+langchain/document_loaders/odt.py,sha256=xmjO6cqDwvE47KS03a6xDKgwoW3ClDc09bCLiZJTjos,112
+langchain/document_loaders/onedrive.py,sha256=EcOzToPjGfTY4XVzor_ddS9ro8doyWnp6hUsiFyt1P0,103
+langchain/document_loaders/onedrive_file.py,sha256=2Zrz5Dig7yx6aw9hU5jIjNDXZxvzRl2y8nnH3-WRaAM,125
+langchain/document_loaders/onenote.py,sha256=iyEd5nMLlWaFgEZV7cTkPwGmN-vuHQfp-8VSe1BahlE,109
+langchain/document_loaders/open_city_data.py,sha256=ckv8UGExq0G7Xo_jTz94hkFW3itQYzBfvvsWJ09aW_s,117
+langchain/document_loaders/org_mode.py,sha256=tnCZkiYsDyXLXkKuEePHpnPVqm2G-2VMgbQ2S_O7-3o,125
+langchain/document_loaders/parsers/__init__.py,sha256=ZZdWUHQTTIUIHytODvJmMgH9tn8oGzDFFYs6H2-AYho,789
+langchain/document_loaders/parsers/__pycache__/__init__.cpython-311.pyc,,
+langchain/document_loaders/parsers/__pycache__/audio.cpython-311.pyc,,
+langchain/document_loaders/parsers/__pycache__/docai.cpython-311.pyc,,
+langchain/document_loaders/parsers/__pycache__/generic.cpython-311.pyc,,
+langchain/document_loaders/parsers/__pycache__/grobid.cpython-311.pyc,,
+langchain/document_loaders/parsers/__pycache__/msword.cpython-311.pyc,,
+langchain/document_loaders/parsers/__pycache__/pdf.cpython-311.pyc,,
+langchain/document_loaders/parsers/__pycache__/registry.cpython-311.pyc,,
+langchain/document_loaders/parsers/__pycache__/txt.cpython-311.pyc,,
+langchain/document_loaders/parsers/audio.py,sha256=h47ik-0-07YeARL8YzqvGaTUG9rotv9sEsYE2DYQ5Ig,225
+langchain/document_loaders/parsers/docai.py,sha256=xw0Izqc9Tf2GJWgp0UWNTbnoFjGtTFg1syDWuT1tIL0,159
+langchain/document_loaders/parsers/generic.py,sha256=mc6i46TGs9Z8ccz5b2nfDGio6boQ-CCIUnk4mwJQ0VQ,120
+langchain/document_loaders/parsers/grobid.py,sha256=csDnEygCIRRE5uicJ7LqN47XRieNSbRuQEOt7rgq5Qk,176
+langchain/document_loaders/parsers/html/__init__.py,sha256=ahE8oP4C2qFmEBT-G65UQEnQjz9fsQzFA7DuQfsEn74,109
+langchain/document_loaders/parsers/html/__pycache__/__init__.cpython-311.pyc,,
+langchain/document_loaders/parsers/html/__pycache__/bs4.cpython-311.pyc,,
+langchain/document_loaders/parsers/html/bs4.py,sha256=ahE8oP4C2qFmEBT-G65UQEnQjz9fsQzFA7DuQfsEn74,109
+langchain/document_loaders/parsers/language/__init__.py,sha256=XUbP3aVIyahpn5p0wbEuQRFkYogN9FtCH_x6nS79Cxc,136
+langchain/document_loaders/parsers/language/__pycache__/__init__.cpython-311.pyc,,
+langchain/document_loaders/parsers/language/__pycache__/cobol.cpython-311.pyc,,
+langchain/document_loaders/parsers/language/__pycache__/code_segmenter.cpython-311.pyc,,
+langchain/document_loaders/parsers/language/__pycache__/javascript.cpython-311.pyc,,
+langchain/document_loaders/parsers/language/__pycache__/language_parser.cpython-311.pyc,,
+langchain/document_loaders/parsers/language/__pycache__/python.cpython-311.pyc,,
+langchain/document_loaders/parsers/language/cobol.py,sha256=79OURiVEEVz1gIQQw3Lc9tnFf75_kNEToMqaBo9O1UY,117
+langchain/document_loaders/parsers/language/code_segmenter.py,sha256=ABi_grNd9qwsxbzeJFwLhSnEHwLpCAHdkdpB0DBFdO4,133
+langchain/document_loaders/parsers/language/javascript.py,sha256=VN9zZVTdtnEcM9YPAyl7X-3cuY0bd8fc2Ois14BeMWA,141
+langchain/document_loaders/parsers/language/language_parser.py,sha256=XUbP3aVIyahpn5p0wbEuQRFkYogN9FtCH_x6nS79Cxc,136
+langchain/document_loaders/parsers/language/python.py,sha256=3QfMv3e5SAJE_tgyUI66NnOofJHb6UkpzTvHvQVD2ms,120
+langchain/document_loaders/parsers/msword.py,sha256=L0yK6qMFcZdotFVp5IAw6J6g1HQVkWgjIYbQRLOYWYU,105
+langchain/document_loaders/parsers/pdf.py,sha256=hHtGveiAGIvf2TFRbM3S2zFrQJ0lSVhRGRxxPx0QsGo,494
+langchain/document_loaders/parsers/registry.py,sha256=Lnlq5oyxxhu7K-Vh7fR-Y9vt9ZfrhNCmhr2HG4tKCNA,112
+langchain/document_loaders/parsers/txt.py,sha256=gMiimgDMDc0eFlUZipfMrkzv-Oi7LAarS8kFTkkNsgI,98
+langchain/document_loaders/pdf.py,sha256=O_lOOfXIqfWSCARapqv2lbAFHxMI9NPFyeZaRYA01nY,706
+langchain/document_loaders/polars_dataframe.py,sha256=CfSK5_Ds0FjjNsYPun2q3Gx3g5wscC0HlDUCVPxo-Mc,125
+langchain/document_loaders/powerpoint.py,sha256=gb3jilvAcFYBYxDUOAXVWlRuBhzYukFr4eemu7gn3Pg,133
+langchain/document_loaders/psychic.py,sha256=cxWuWIu62GbUUs8Ytx3iT_NtzVH3ne7LYIZTlXgjCpo,100
+langchain/document_loaders/pubmed.py,sha256=OmUHz5Ne-Nm5y8Y46LJoNEcDYxfZ_MGpv_xrISRREqI,97
+langchain/document_loaders/pyspark_dataframe.py,sha256=Pu0cOgH0YK3lcTD9wssnv8W_Ki_vkAot75V5AQ3jW5k,137
+langchain/document_loaders/python.py,sha256=r2fUNuLPKDd9xZtFvRmH7zy0FvpJzkOqWDZeQtdfKfc,97
+langchain/document_loaders/quip.py,sha256=GdcTsBLyJi74Lu8DIk2-Ao9QquHA6r5f-9x_dVMC2sk,91
+langchain/document_loaders/readthedocs.py,sha256=RRClminHKbrD_XeP_beqkDtIlHsuEE0V8pBd_a2rWcA,128
+langchain/document_loaders/recursive_url_loader.py,sha256=QAARRwkw2KB1zxb_h8tlAyou0BqwjtnuFHNRNpq4IzM,132
+langchain/document_loaders/reddit.py,sha256=j8AoPPbomzlslKKwiHUN5v-xMjuKmvQI1uIKc43jhBg,116
+langchain/document_loaders/roam.py,sha256=uodOkPARrrCbKQA9lSdF2itE73WHX6AiCBCQrnMalo8,91
+langchain/document_loaders/rocksetdb.py,sha256=tYJoQCRbqJa8sEGHnAARAGCiOopW8BEn9SNkxHwCzBE,111
+langchain/document_loaders/rspace.py,sha256=z2PMwBpJIThPyy8w-JdYSLLJ0FKoINTxASNnUki3Eb0,97
+langchain/document_loaders/rss.py,sha256=s_USD7NqpBJOOmkQDTi42hm9PrwZIAk34cbPXPH23gY,96
+langchain/document_loaders/rst.py,sha256=LFnfFQov4H21PMaJqgdIVlQOnSb42q3TM0bHTIAqNyQ,112
+langchain/document_loaders/rtf.py,sha256=5I3acOhxB5DiR9lE-0oPY9R0FP71dUAlJcMJtiMIdes,112
+langchain/document_loaders/s3_directory.py,sha256=2MGBSer4dvr9mNTeGZdnSyNiTVcDgZ_MDtguIKuDEz8,113
+langchain/document_loaders/s3_file.py,sha256=ttpM2W6UD-NnrJyZSa-VU1zL_x4X5NbpTAyR0pqjQMA,98
+langchain/document_loaders/sharepoint.py,sha256=aTr9yx4WxGuf4e2Am16nnz8nt3KiSsZXJGRg1cTCcRQ,109
+langchain/document_loaders/sitemap.py,sha256=wFPXFygR-LOAt4TiEM_KKuwiCi3oDIS4OCYmvp0GMA8,116
+langchain/document_loaders/slack_directory.py,sha256=wlIxgBjm4tBegXfYvWQMXgcq5rRh2iCqP-A2wcL4-Mk,122
+langchain/document_loaders/snowflake_loader.py,sha256=fPALWTy0ZmKLij2XJ4NS7o_QTAPxq4Rk1iYBOfcZ2kE,113
+langchain/document_loaders/spreedly.py,sha256=JycUMBpklOX9DGBTkh5Z1sfSmqwV2txhTZXgANnwXCU,112
+langchain/document_loaders/srt.py,sha256=zjNFikv6TWkMmTwaydoCPt2hxTAHQIzWQGuh2fZNWbU,88
+langchain/document_loaders/stripe.py,sha256=z1tD0RG4JfegAtiB2PlY3lDY0bF6COLMbA6dPiVq_Dk,97
+langchain/document_loaders/telegram.py,sha256=GYLL2tgB8idKGO7elf2KDmfIMPMJ915iSU2CofJrUhI,275
+langchain/document_loaders/tencent_cos_directory.py,sha256=SLPvERg5JZ0AqvdYppz5Q4c7PT7uGVUDD1IJ4rL8HxI,147
+langchain/document_loaders/tencent_cos_file.py,sha256=5Kxa8W3_QIhSOF-46AkM_OrVQxej2Fw5_sYYatWMXjk,123
+langchain/document_loaders/tensorflow_datasets.py,sha256=Q3i0o_eGngxs3Qow0pkkO8Gnwk1nB4NNBvYezD2sCE4,141
+langchain/document_loaders/text.py,sha256=jfCZbpRhzMneZZ-sU28x6DVSKtmmEK6xVegzQthtJMU,91
+langchain/document_loaders/tomarkdown.py,sha256=_faa5Cy8zzz0rEERdZySQgludJV61B6YID6t9as9j08,109
+langchain/document_loaders/toml.py,sha256=ZxpCnG2TAlWHiWzErEEx9zLp6gxWs81OmIMgOiT_AFw,91
+langchain/document_loaders/trello.py,sha256=7sss8Qnxj5ssIbBj_PX3If268PEs89Wfu0XGOdxhEZM,97
+langchain/document_loaders/tsv.py,sha256=1HAfkCNF_LnzU42Y9G_uz9wP-Y6x3Z063cPbR62pxc0,112
+langchain/document_loaders/twitter.py,sha256=_b3vV3-s8LVGyyqXA7dQI6qArUJKLbINR-WnaJhv13M,119
+langchain/document_loaders/unstructured.py,sha256=hlkm6Mf5s42gadslbRfoKk8udv1lm4eDZCFhXQQuTsA,601
+langchain/document_loaders/url.py,sha256=6VFBPJa8PfqHdMrrwOj6kM8CxEnPsSHMRJ36_oYh4iU,112
+langchain/document_loaders/url_playwright.py,sha256=A7dNj0wbjxMUWY2DoCf3kMuwr889T8jqqokx_o1plEA,236
+langchain/document_loaders/url_selenium.py,sha256=Y4wxqdyqpqy3Xwk6uWNRUpvtlpb812iJV5CSo2oM8bg,113
+langchain/document_loaders/weather.py,sha256=3KPesnHytEvByHRTIUnAQiTzKmfD9DE9NfkAgIIKGms,108
+langchain/document_loaders/web_base.py,sha256=lI-r30VIS7DyRc_NgFPuurvztQQu9zJjP7-6v7YH34o,110
+langchain/document_loaders/whatsapp_chat.py,sha256=JVJ-S_JqKjWz2AaxQMA2wS05-xNIzuojzE1MfZ_Q7DY,167
+langchain/document_loaders/wikipedia.py,sha256=ARigSmEHzy7m4J7ANbZAvP3xsf881lFdFlLjP-CxHW0,106
+langchain/document_loaders/word_document.py,sha256=yiR8XzNJ2WzDQoxBR-iigjB4oi07Ss2uCAnVz0hODmo,187
+langchain/document_loaders/xml.py,sha256=4an3bltHPo305vCwpgN1TFP98XixTilkhqmm3YiZ2NA,112
+langchain/document_loaders/xorbits.py,sha256=KhnxSnJeNNcGd6QPASCf42BfDaUh2u9pGDgZA9R4_lw,100
+langchain/document_loaders/youtube.py,sha256=MPYCw62QRDz647gMoS8FJA3ZwqRwHOIp-5GA2T-TZmI,218
+langchain/document_transformers/__init__.py,sha256=P8eJZW_qcgJz4PdqX_W3GM9NvCDP1I-YBCjM5TIQcBc,1616
+langchain/document_transformers/__pycache__/__init__.cpython-311.pyc,,
+langchain/document_transformers/__pycache__/beautiful_soup_transformer.cpython-311.pyc,,
+langchain/document_transformers/__pycache__/doctran_text_extract.cpython-311.pyc,,
+langchain/document_transformers/__pycache__/doctran_text_qa.cpython-311.pyc,,
+langchain/document_transformers/__pycache__/doctran_text_translate.cpython-311.pyc,,
+langchain/document_transformers/__pycache__/embeddings_redundant_filter.cpython-311.pyc,,
+langchain/document_transformers/__pycache__/google_translate.cpython-311.pyc,,
+langchain/document_transformers/__pycache__/html2text.cpython-311.pyc,,
+langchain/document_transformers/__pycache__/long_context_reorder.cpython-311.pyc,,
+langchain/document_transformers/__pycache__/nuclia_text_transform.cpython-311.pyc,,
+langchain/document_transformers/__pycache__/openai_functions.cpython-311.pyc,,
+langchain/document_transformers/beautiful_soup_transformer.py,sha256=np8Tm_VLDsXmyk5vVRdNTSk0ooLblPFADwD3JLK4Vh4,155
+langchain/document_transformers/doctran_text_extract.py,sha256=If3Nf5aHs2eREVswAxLMWtZni01Q_fm13vSPuUPx76Y,149
+langchain/document_transformers/doctran_text_qa.py,sha256=T7f1r7l9dQbiVY_E6TcxydLO_xlUiUp2mNzfppaUYzo,136
+langchain/document_transformers/doctran_text_translate.py,sha256=Ts166Q9aeHSQQgn0nKW2S-JnS_88mFrCm_vg5Uol81c,145
+langchain/document_transformers/embeddings_redundant_filter.py,sha256=mr_DPCKsyPgwatmQI6UxqXfau3U2z5Whroo4fsNwzvw,487
+langchain/document_transformers/google_translate.py,sha256=qyZs_nNEcUVvtl09xrceLO_oCJQ0Lp3Ykib2bIFZG8A,149
+langchain/document_transformers/html2text.py,sha256=AC_AuOTMhkHP4XcSRNQ2Sdce6JQalf5AzAk-WKb2_44,121
+langchain/document_transformers/long_context_reorder.py,sha256=Nlprmu6iDDyb8YEXNkj0jCG5qAHrX63c5_Egl3VJPrU,137
+langchain/document_transformers/nuclia_text_transform.py,sha256=moO6pB6I7wLOZbY7luBTvv4vDrfZpK5tT19a34cgymk,144
+langchain/document_transformers/openai_functions.py,sha256=8ZeEpuvv00aAF6D7ww_NAVO6h1INWZnWMi2dnxOLAJg,191
+langchain/document_transformers/xsl/html_chunks_with_headers.xslt,sha256=ti9sT_zWqZQf0aaeX5zT6tfHT1CuUpAVCvzoZWutE0o,6033
+langchain/embeddings/__init__.py,sha256=l1sPA6HxCVhTORqX38pCMFoZZXS7AwY99tIofb2bfR8,3598
+langchain/embeddings/__pycache__/__init__.cpython-311.pyc,,
+langchain/embeddings/__pycache__/aleph_alpha.cpython-311.pyc,,
+langchain/embeddings/__pycache__/awa.cpython-311.pyc,,
+langchain/embeddings/__pycache__/azure_openai.cpython-311.pyc,,
+langchain/embeddings/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc,,
+langchain/embeddings/__pycache__/base.cpython-311.pyc,,
+langchain/embeddings/__pycache__/bedrock.cpython-311.pyc,,
+langchain/embeddings/__pycache__/bookend.cpython-311.pyc,,
+langchain/embeddings/__pycache__/cache.cpython-311.pyc,,
+langchain/embeddings/__pycache__/clarifai.cpython-311.pyc,,
+langchain/embeddings/__pycache__/cloudflare_workersai.cpython-311.pyc,,
+langchain/embeddings/__pycache__/cohere.cpython-311.pyc,,
+langchain/embeddings/__pycache__/dashscope.cpython-311.pyc,,
+langchain/embeddings/__pycache__/databricks.cpython-311.pyc,,
+langchain/embeddings/__pycache__/deepinfra.cpython-311.pyc,,
+langchain/embeddings/__pycache__/edenai.cpython-311.pyc,,
+langchain/embeddings/__pycache__/elasticsearch.cpython-311.pyc,,
+langchain/embeddings/__pycache__/embaas.cpython-311.pyc,,
+langchain/embeddings/__pycache__/ernie.cpython-311.pyc,,
+langchain/embeddings/__pycache__/fake.cpython-311.pyc,,
+langchain/embeddings/__pycache__/fastembed.cpython-311.pyc,,
+langchain/embeddings/__pycache__/google_palm.cpython-311.pyc,,
+langchain/embeddings/__pycache__/gpt4all.cpython-311.pyc,,
+langchain/embeddings/__pycache__/gradient_ai.cpython-311.pyc,,
+langchain/embeddings/__pycache__/huggingface.cpython-311.pyc,,
+langchain/embeddings/__pycache__/huggingface_hub.cpython-311.pyc,,
+langchain/embeddings/__pycache__/infinity.cpython-311.pyc,,
+langchain/embeddings/__pycache__/javelin_ai_gateway.cpython-311.pyc,,
+langchain/embeddings/__pycache__/jina.cpython-311.pyc,,
+langchain/embeddings/__pycache__/johnsnowlabs.cpython-311.pyc,,
+langchain/embeddings/__pycache__/llamacpp.cpython-311.pyc,,
+langchain/embeddings/__pycache__/llm_rails.cpython-311.pyc,,
+langchain/embeddings/__pycache__/localai.cpython-311.pyc,,
+langchain/embeddings/__pycache__/minimax.cpython-311.pyc,,
+langchain/embeddings/__pycache__/mlflow.cpython-311.pyc,,
+langchain/embeddings/__pycache__/mlflow_gateway.cpython-311.pyc,,
+langchain/embeddings/__pycache__/modelscope_hub.cpython-311.pyc,,
+langchain/embeddings/__pycache__/mosaicml.cpython-311.pyc,,
+langchain/embeddings/__pycache__/nlpcloud.cpython-311.pyc,,
+langchain/embeddings/__pycache__/octoai_embeddings.cpython-311.pyc,,
+langchain/embeddings/__pycache__/ollama.cpython-311.pyc,,
+langchain/embeddings/__pycache__/openai.cpython-311.pyc,,
+langchain/embeddings/__pycache__/sagemaker_endpoint.cpython-311.pyc,,
+langchain/embeddings/__pycache__/self_hosted.cpython-311.pyc,,
+langchain/embeddings/__pycache__/self_hosted_hugging_face.cpython-311.pyc,,
+langchain/embeddings/__pycache__/sentence_transformer.cpython-311.pyc,,
+langchain/embeddings/__pycache__/spacy_embeddings.cpython-311.pyc,,
+langchain/embeddings/__pycache__/tensorflow_hub.cpython-311.pyc,,
+langchain/embeddings/__pycache__/vertexai.cpython-311.pyc,,
+langchain/embeddings/__pycache__/voyageai.cpython-311.pyc,,
+langchain/embeddings/__pycache__/xinference.cpython-311.pyc,,
+langchain/embeddings/aleph_alpha.py,sha256=-eigh8X8F3xZD0x7daSCKKUqJQwlM1DY-X9WfRm1n9M,248
+langchain/embeddings/awa.py,sha256=jee9qn0zzIy7FWTFWCxo5ignpANoC0fCaXoUh-kmAz0,90
+langchain/embeddings/azure_openai.py,sha256=SK2mmnVyhC9GoxSs6vxWTEyBeBciR3T3QbiDxsLx57k,115
+langchain/embeddings/baidu_qianfan_endpoint.py,sha256=yeWGyJhKKoML7toJCFZ5XvnMQQ0zMB8Md272_7J5R4c,142
+langchain/embeddings/base.py,sha256=1f9mAt3_kGWFWZVrt2H_6VXzPdbe8910YtJYKoYmoJs,113
+langchain/embeddings/bedrock.py,sha256=oK1PrN6BMouf6s4SqxdEJSBKqW52xTNaOpO4HRRF3Oc,102
+langchain/embeddings/bookend.py,sha256=v-E2k3OWPFpp1covnl_hmoL54J0Q4jQYRKyHeeuzDb0,111
+langchain/embeddings/cache.py,sha256=G_7n9eLX85pTXTbdgPZMBvT66gmt0maUMVYLTnLWBMY,8862
+langchain/embeddings/clarifai.py,sha256=kTMaBTiQu__tQ8YHlx4V28MvnQzGpRvK4Fx_5FK26e8,105
+langchain/embeddings/cloudflare_workersai.py,sha256=bHEMJN36t5DO7x-6wxvTOkPBQC9dbo5ylVb_47zg-tA,148
+langchain/embeddings/cohere.py,sha256=fd2ootwAzF_ZoSETvnVmvm3MA9150BX20LXWBtG37DE,99
+langchain/embeddings/dashscope.py,sha256=YmJbU20pMUhFFg3tR1ml7JvK8zCD4agiXoW-eSs55OQ,117
+langchain/embeddings/databricks.py,sha256=Sgbl9x0U3Ac3f3bIvElVq2anYxAppcirZHa3JnafsDg,111
+langchain/embeddings/deepinfra.py,sha256=vOhzu0oHcZGnl_F_TlmiMtTKRCYIwtOOwcduLlHPhqo,117
+langchain/embeddings/edenai.py,sha256=Jv4kkmPuLrXETwNASRbb4ZFS3ueOdad04UznmXRgN_M,99
+langchain/embeddings/elasticsearch.py,sha256=mt-BFWGdFpjOaAMx8QXcjJubJEQoXVV5FH6UApRmPqM,120
+langchain/embeddings/embaas.py,sha256=IueW8Ie0mAJ0ppRB2SIPZ9Xn4ginbva8Ac0I3bUmXUE,115
+langchain/embeddings/ernie.py,sha256=30fGLQJsUavonyjU444FhnH3lp1f6xWP00mIQM0v114,96
+langchain/embeddings/fake.py,sha256=4MegFW1uCv4Z1ZPPuVr2C6ZvmUUQ9r6Y7NIvxaPrWqg,164
+langchain/embeddings/fastembed.py,sha256=fpyQIrKQSRHgsvKDpy91ndyT27oUuJNz_Z6ViVjFF9A,108
+langchain/embeddings/google_palm.py,sha256=ROb5llltki4rA9CmmGAU2THtIG0_IBs4VJtDyemUrJo,121
+langchain/embeddings/gpt4all.py,sha256=7HOGhcGHlhTL0l8pmTruI1yt1Lyp8FVLTLzH40VlAus,102
+langchain/embeddings/gradient_ai.py,sha256=T6OR_GjEVhH0mYLO-qe02h3B77fJJXNZloP8uN6jp_s,108
+langchain/embeddings/huggingface.py,sha256=XCryU4DRSF57hpKKcLpYJKbqdV3gr0GssTJ4jMz9UiQ,344
+langchain/embeddings/huggingface_hub.py,sha256=29xsd4cGJSo9WSteBHuW31Z2_bVFwHZ3B-RKL5w4S4Y,133
+langchain/embeddings/infinity.py,sha256=lCnBLiN4WHhE2nJgmYVn3wx9iQeSol5wGHcfYf8Zq2k,200
+langchain/embeddings/javelin_ai_gateway.py,sha256=cfi2TbVsP1vIWMtrJe9lqkx5X9ZjZweN2adRwbQdbMs,140
+langchain/embeddings/jina.py,sha256=CkFNYFQjZUEuNfsUJg1dlCxxiio_orQEBk3D7qiUsu0,93
+langchain/embeddings/johnsnowlabs.py,sha256=m25vdAbv3x2F6tJP-i8pws526O8IW1aOqcEB88gI_z8,117
+langchain/embeddings/llamacpp.py,sha256=1lV8laj8cj31qjSYkVM25VUvVztuRwtntzW0iSzTeXM,105
+langchain/embeddings/llm_rails.py,sha256=v7pJ9pshIGCYC8dJeFus0BZjCjHMNj9l7SDczuSomMo,106
+langchain/embeddings/localai.py,sha256=WX_v1NJps4bS9y0qSpQ94JBrEVMAkPxCCfpwKC12mvE,118
+langchain/embeddings/minimax.py,sha256=oWyhI8oi4XgfDjRY8yg6vPAzUbBzLO9X-1NlwSVPlLQ,111
+langchain/embeddings/mlflow.py,sha256=ifsAUA5ydLzMzfXVwzuTgwtzdHSLPP6YYFggnvoRVII,99
+langchain/embeddings/mlflow_gateway.py,sha256=SzbPTiBqNNk9gcuBuvv8q7X_p8BD7BAqjeDh7FlEIpY,134
+langchain/embeddings/modelscope_hub.py,sha256=HqsRy-C3cESf_JhE_ropNBLDSrbUH-Rki9uX6VnozA8,115
+langchain/embeddings/mosaicml.py,sha256=UYGA4ioZCUTjI8-mCk6OfzNTWujhJBEfkBtqWFW7aKc,125
+langchain/embeddings/nlpcloud.py,sha256=bKIuCmp8fNhnvx1E946p7wFRMrJOMhGnFKYifxQiB2A,105
+langchain/embeddings/octoai_embeddings.py,sha256=ccYBzsPPUDCPh6AiYpqDQBfdSxVtLgL-O-ST3nH4q5I,119
+langchain/embeddings/ollama.py,sha256=eQhOQv63kF8H9QcwUPP9CRYpj44xHLCPKRkjYdIGqMQ,99
+langchain/embeddings/openai.py,sha256=I0s7sVamnKPDkqIlURq-X84JlUCLrKyb4PZjmpxDHlo,115
+langchain/embeddings/sagemaker_endpoint.py,sha256=hemAMoWyda3-FR_rXxDeYRlDVhUVTMSL6V63ikWqz3M,200
+langchain/embeddings/self_hosted.py,sha256=yUENd0cakgFHoPX_bMVqNwl0OVP_lcsEbxPO-hu1oQI,121
+langchain/embeddings/self_hosted_hugging_face.py,sha256=LSOBLbt-hj2vl-scV-t-mqfO6JX5d39zOMHn6cJsY_E,255
+langchain/embeddings/sentence_transformer.py,sha256=5VePTEwH9SU5-LhGWNQxZ_SktGfiXZh-r2eTykvyjGA,148
+langchain/embeddings/spacy_embeddings.py,sha256=Tk2i8Q7Klh_HIJXCDXdAJS3IYYKqElnLTkLsnhDIot8,107
+langchain/embeddings/tensorflow_hub.py,sha256=iNuYnw8rDrxwLFjQ7HAjjUNrON2yY_QJVn0t0076_iQ,130
+langchain/embeddings/vertexai.py,sha256=_Ujpc-OkgjmR4NJ3oNYoQBiwgmdTMlhjsJEjxmqYuRs,105
+langchain/embeddings/voyageai.py,sha256=HiWc40_eB7TZzwqnT-G7Wvr1CLLKN1kQUw4TlcUDnNo,117
+langchain/embeddings/xinference.py,sha256=kKtGdLUwKoxA_Hp6bVOPJQlENdW85UBEdAqsh59lq6o,111
+langchain/env.py,sha256=fucAbfcmwiN1CjKSg5l2lzquRVoE7wqfuMMlaByuyEk,476
+langchain/evaluation/__init__.py,sha256=jFKhJ5vxBMphg7qQe9Tw7Ma-rL7F3FRZG4C6XQPaZhg,5803
+langchain/evaluation/__pycache__/__init__.cpython-311.pyc,,
+langchain/evaluation/__pycache__/loading.cpython-311.pyc,,
+langchain/evaluation/__pycache__/schema.cpython-311.pyc,,
+langchain/evaluation/agents/__init__.py,sha256=fqXIN8cbpBYwE1m7LQRnTHTcMXS1fedZyOhpwzWCqbc,165
+langchain/evaluation/agents/__pycache__/__init__.cpython-311.pyc,,
+langchain/evaluation/agents/__pycache__/trajectory_eval_chain.cpython-311.pyc,,
+langchain/evaluation/agents/__pycache__/trajectory_eval_prompt.cpython-311.pyc,,
+langchain/evaluation/agents/trajectory_eval_chain.py,sha256=MKLAdR4SciQe-STWvJMIemnHHXD-AtEopEZl-0pNk3w,13910
+langchain/evaluation/agents/trajectory_eval_prompt.py,sha256=UqAk4-CKL1LjjpCNgRi-fuY1JEJO03tGxudL_P04N4k,5938
+langchain/evaluation/comparison/__init__.py,sha256=gHLBcYkt9wI2mf2YEmAxskptxQwuVPCQJrW4MqL_rWQ,1400
+langchain/evaluation/comparison/__pycache__/__init__.cpython-311.pyc,,
+langchain/evaluation/comparison/__pycache__/eval_chain.cpython-311.pyc,,
+langchain/evaluation/comparison/__pycache__/prompt.cpython-311.pyc,,
+langchain/evaluation/comparison/eval_chain.py,sha256=yrswcnIfz6CGXLJw2gOt9I5P0K5CG3szgkwgdl47ROU,16056
+langchain/evaluation/comparison/prompt.py,sha256=XU0jFiRumvFivPJwCyZYFBDrSK-TrRXORJ9KtmfYM2M,2358
+langchain/evaluation/criteria/__init__.py,sha256=FE5qrrz5JwWXJWXCzdyNRevEPfmmfBfjfHx-hR3pCWg,1647
+langchain/evaluation/criteria/__pycache__/__init__.cpython-311.pyc,,
+langchain/evaluation/criteria/__pycache__/eval_chain.cpython-311.pyc,,
+langchain/evaluation/criteria/__pycache__/prompt.cpython-311.pyc,,
+langchain/evaluation/criteria/eval_chain.py,sha256=JnWBgxj4_nG3ghl3YeQXQYTyZ1kVI94sSX0LUcvASwM,21358
+langchain/evaluation/criteria/prompt.py,sha256=6OgXmdvlYVzRMeAxa1fYGIxqeNAz1NkFCZ6ezLgUnZM,1756
+langchain/evaluation/embedding_distance/__init__.py,sha256=TyX5etnor5PF4cc3KjudE0B6_VKo_ZhovJLS5qOLjcI,323
+langchain/evaluation/embedding_distance/__pycache__/__init__.cpython-311.pyc,,
+langchain/evaluation/embedding_distance/__pycache__/base.cpython-311.pyc,,
+langchain/evaluation/embedding_distance/base.py,sha256=3muQsaAfFSWEnrBfmyha-6h4uB2jzZi_cuy_oKE_bGQ,15503
+langchain/evaluation/exact_match/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/evaluation/exact_match/__pycache__/__init__.cpython-311.pyc,,
+langchain/evaluation/exact_match/__pycache__/base.cpython-311.pyc,,
+langchain/evaluation/exact_match/base.py,sha256=BykyjgKQ94391eDODzn3m1RXao9ZSXtc9wiww_fysXI,2751
+langchain/evaluation/loading.py,sha256=AE2tKWD_zC5mpD2bZLOGR-mXH3rotCM82mV9iF7tejg,6719
+langchain/evaluation/parsing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/evaluation/parsing/__pycache__/__init__.cpython-311.pyc,,
+langchain/evaluation/parsing/__pycache__/base.cpython-311.pyc,,
+langchain/evaluation/parsing/__pycache__/json_distance.cpython-311.pyc,,
+langchain/evaluation/parsing/__pycache__/json_schema.cpython-311.pyc,,
+langchain/evaluation/parsing/base.py,sha256=JbEaMoLsERpLWBxjCmYhIR3QrS40aFgMmsgqOhRaTi0,5246
+langchain/evaluation/parsing/json_distance.py,sha256=63hgweZ96mIJDxsTOVefXKelGi3UfqbI3i5Q2bjocx4,3679
+langchain/evaluation/parsing/json_schema.py,sha256=r-0ZwbQbmkrBOuBHmHJTWGPMzCEY2ho_GnP40nJihxE,3197
+langchain/evaluation/qa/__init__.py,sha256=Uyycxfl8V8l4book5N0CekkQWp0ZaY5ziOuZ6c_t_3A,344
+langchain/evaluation/qa/__pycache__/__init__.cpython-311.pyc,,
+langchain/evaluation/qa/__pycache__/eval_chain.cpython-311.pyc,,
+langchain/evaluation/qa/__pycache__/eval_prompt.cpython-311.pyc,,
+langchain/evaluation/qa/__pycache__/generate_chain.cpython-311.pyc,,
+langchain/evaluation/qa/__pycache__/generate_prompt.cpython-311.pyc,,
+langchain/evaluation/qa/eval_chain.py,sha256=hkBGOoFv2pUytYhIlZByuhTcO8fI9SbbxScUJQuNtHA,10886
+langchain/evaluation/qa/eval_prompt.py,sha256=zfJxS2-SI_SOXBDFp0xRpNAOgeELV3ti9EhcV2DFO_Y,3911
+langchain/evaluation/qa/generate_chain.py,sha256=XgIaF_lCrthr0cICgKR7nELxbvpxGHY435pw4k3d20c,1052
+langchain/evaluation/qa/generate_prompt.py,sha256=g6U9K8-eq7JXOjFJokFEfBtLnHp-fpK1rgIwWYZ9Odc,606
+langchain/evaluation/regex_match/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/evaluation/regex_match/__pycache__/__init__.cpython-311.pyc,,
+langchain/evaluation/regex_match/__pycache__/base.cpython-311.pyc,,
+langchain/evaluation/regex_match/base.py,sha256=EKLoQOK1ncUF0wEIbzp7JjYwuyeLRkk4wvTXyD1UTZs,2407
+langchain/evaluation/schema.py,sha256=L_5dq9XawZoUzFykt7hzQU8WxZ8mBXhaU0SFl9VyNS8,18197
+langchain/evaluation/scoring/__init__.py,sha256=_HAJZIg0j5qH8c9KU5z0wV5DbbrUX814ne4_27bFyXQ,1112
+langchain/evaluation/scoring/__pycache__/__init__.cpython-311.pyc,,
+langchain/evaluation/scoring/__pycache__/eval_chain.cpython-311.pyc,,
+langchain/evaluation/scoring/__pycache__/prompt.cpython-311.pyc,,
+langchain/evaluation/scoring/eval_chain.py,sha256=5MmF2mKjREKLEy-O59raEpwNqTab685RjZopmtWjfDw,15656
+langchain/evaluation/scoring/prompt.py,sha256=MubYHBDC4ieJ68LVvFxlho4Ec5deajcBYBFuDzV7FjY,2129
+langchain/evaluation/string_distance/__init__.py,sha256=M6rtO3tlGCTydsL3MaZH35TrynStvTFFGkwPzEhszk8,285
+langchain/evaluation/string_distance/__pycache__/__init__.cpython-311.pyc,,
+langchain/evaluation/string_distance/__pycache__/base.cpython-311.pyc,,
+langchain/evaluation/string_distance/base.py,sha256=f_wYWhb1Stco716s_8k-e5YGtM11utbh5_IOGF0yfgE,14014
+langchain/example_generator.py,sha256=LYSewj4pnvE72fLJlpDlAwJgKkv8ResqDweHeCm7D4w,141
+langchain/formatting.py,sha256=Cw9JNCipy5D2RmgBe7hsusOMYqZlgXRfMPdNBPLEJys,167
+langchain/globals/__init__.py,sha256=-oVEVXqVwwReL577EiIiRPjgmQrXIhA9gZvQpU4CyAo,7435
+langchain/globals/__pycache__/__init__.cpython-311.pyc,,
+langchain/graphs/__init__.py,sha256=hUNTc7Q8EGdtbv6-KFVWNiHNWyKdfJrl17q_0JO1Qzs,1104
+langchain/graphs/__pycache__/__init__.cpython-311.pyc,,
+langchain/graphs/__pycache__/arangodb_graph.cpython-311.pyc,,
+langchain/graphs/__pycache__/falkordb_graph.cpython-311.pyc,,
+langchain/graphs/__pycache__/graph_document.cpython-311.pyc,,
+langchain/graphs/__pycache__/graph_store.cpython-311.pyc,,
+langchain/graphs/__pycache__/hugegraph.cpython-311.pyc,,
+langchain/graphs/__pycache__/kuzu_graph.cpython-311.pyc,,
+langchain/graphs/__pycache__/memgraph_graph.cpython-311.pyc,,
+langchain/graphs/__pycache__/nebula_graph.cpython-311.pyc,,
+langchain/graphs/__pycache__/neo4j_graph.cpython-311.pyc,,
+langchain/graphs/__pycache__/neptune_graph.cpython-311.pyc,,
+langchain/graphs/__pycache__/networkx_graph.cpython-311.pyc,,
+langchain/graphs/__pycache__/rdf_graph.cpython-311.pyc,,
+langchain/graphs/arangodb_graph.py,sha256=rn7uVI7WAa8aR4ZOdVSASvd1nUHBa5qJj2GyBCjcaUo,148
+langchain/graphs/falkordb_graph.py,sha256=EDnytKX55QmIxZC8mdWpfJuyw6d5cq6EDBmkAPzwICE,113
+langchain/graphs/graph_document.py,sha256=F9jfPRvgQ1vYRBCB0huse1yUc0KrsUlCGv7oFNFV8xs,141
+langchain/graphs/graph_store.py,sha256=TirHKx7GMsw-Tpyvkyff2bd8dkjQVRa_9Aic3HtzI1s,88
+langchain/graphs/hugegraph.py,sha256=ZVJu8qyZlSs1Z0a976oWNQByBk8VqKqYqwLfXF4lCxE,84
+langchain/graphs/kuzu_graph.py,sha256=Qf47ApC_FIkgItH02gIhqzMtdhom4qVXA9RfnyIW-68,85
+langchain/graphs/memgraph_graph.py,sha256=WIiOyW-z39J1psedQn-fF6ON7QMYqtAYCc2Q5Z-wHGk,106
+langchain/graphs/nebula_graph.py,sha256=i7H4yP_V_1l_zdsm-XReiR3b-xad6IT21j4DAO2Ld18,91
+langchain/graphs/neo4j_graph.py,sha256=zCcztsL7ObMgpzVs3CFYhjRb8sDL20NAZxcRsbBEIRg,97
+langchain/graphs/neptune_graph.py,sha256=veBykT4aOqt3Fx3Wl8nByZxWf6nHgb7HjJ6TmbhVf74,94
+langchain/graphs/networkx_graph.py,sha256=2sPGH0FP_T4uEaTgr0liwbfsEoiXuN8ZMPmlbwcYXME,299
+langchain/graphs/rdf_graph.py,sha256=ZDkbZf4hhBLD7g1T6swIB3vhD9cfWcA2fwhgojeHsU8,98
+langchain/hub.py,sha256=HHrVBhvuKqEiEYLz1b-WJN1YKvyp5-nht6xUVj7g2Fo,3465
+langchain/indexes/__init__.py,sha256=-h8580LyQ8yKTSvVYgmyJjcE-U5cjFWuoXLf7DtR0G8,902
+langchain/indexes/__pycache__/__init__.cpython-311.pyc,,
+langchain/indexes/__pycache__/_api.cpython-311.pyc,,
+langchain/indexes/__pycache__/_sql_record_manager.cpython-311.pyc,,
+langchain/indexes/__pycache__/base.cpython-311.pyc,,
+langchain/indexes/__pycache__/graph.cpython-311.pyc,,
+langchain/indexes/__pycache__/vectorstore.cpython-311.pyc,,
+langchain/indexes/_api.py,sha256=ajxxibopm8dQ4as4wgIcRK8vPPCyjvdMRT2Ha0FXAqU,22607
+langchain/indexes/_sql_record_manager.py,sha256=hFZWjYj8NCmUxpMpd_hiUcXEG_LE0ZyrA2dQGYsctZU,20640
+langchain/indexes/base.py,sha256=7zmC1Na3gCYTf36wm5boKh3R_eU2yLMMn0hKm9sfaBQ,5221
+langchain/indexes/graph.py,sha256=5Uwz_hTcv2dWdL0ov9XUR89GJxUeOPisRFQS5amNk8s,1752
+langchain/indexes/prompts/__init__.py,sha256=lCiOSbsAwjKYc0B8O-BM0MBfwYRoR1NZEkDh0SqgMlI,49
+langchain/indexes/prompts/__pycache__/__init__.cpython-311.pyc,,
+langchain/indexes/prompts/__pycache__/entity_extraction.cpython-311.pyc,,
+langchain/indexes/prompts/__pycache__/entity_summarization.cpython-311.pyc,,
+langchain/indexes/prompts/__pycache__/knowledge_triplet_extraction.cpython-311.pyc,,
+langchain/indexes/prompts/entity_extraction.py,sha256=gTKrAXGbbR3OKdtkgaq8UgigvNp8Q4oICcBHbaeVhOg,1952
+langchain/indexes/prompts/entity_summarization.py,sha256=fqL7-zIdas0H1SXXUS94otZSxeGpg-7o-Ppc_rxKeSk,1157
+langchain/indexes/prompts/knowledge_triplet_extraction.py,sha256=sn3iOee3KJJuDP7eJCGQOMMXwXLHfaW1pdSAByJyHy0,1599
+langchain/indexes/vectorstore.py,sha256=kn_Ny-Z-54aHG0WG-Fx1RSIUlHr4oDI2tw0w0NY0TjE,5412
+langchain/input.py,sha256=TcYGgdkyCQbGA3ZHlZoRtQcTUD3SC1jc5C90bfU5Wcs,282
+langchain/llms/__init__.py,sha256=8jUYdsPIcmeRUjl7eorayjrGJ_iaya4JBxD1GnJZoqI,17110
+langchain/llms/__pycache__/__init__.cpython-311.pyc,,
+langchain/llms/__pycache__/ai21.cpython-311.pyc,,
+langchain/llms/__pycache__/aleph_alpha.cpython-311.pyc,,
+langchain/llms/__pycache__/amazon_api_gateway.cpython-311.pyc,,
+langchain/llms/__pycache__/anthropic.cpython-311.pyc,,
+langchain/llms/__pycache__/anyscale.cpython-311.pyc,,
+langchain/llms/__pycache__/arcee.cpython-311.pyc,,
+langchain/llms/__pycache__/aviary.cpython-311.pyc,,
+langchain/llms/__pycache__/azureml_endpoint.cpython-311.pyc,,
+langchain/llms/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc,,
+langchain/llms/__pycache__/bananadev.cpython-311.pyc,,
+langchain/llms/__pycache__/base.cpython-311.pyc,,
+langchain/llms/__pycache__/baseten.cpython-311.pyc,,
+langchain/llms/__pycache__/beam.cpython-311.pyc,,
+langchain/llms/__pycache__/bedrock.cpython-311.pyc,,
+langchain/llms/__pycache__/bittensor.cpython-311.pyc,,
+langchain/llms/__pycache__/cerebriumai.cpython-311.pyc,,
+langchain/llms/__pycache__/chatglm.cpython-311.pyc,,
+langchain/llms/__pycache__/clarifai.cpython-311.pyc,,
+langchain/llms/__pycache__/cloudflare_workersai.cpython-311.pyc,,
+langchain/llms/__pycache__/cohere.cpython-311.pyc,,
+langchain/llms/__pycache__/ctransformers.cpython-311.pyc,,
+langchain/llms/__pycache__/ctranslate2.cpython-311.pyc,,
+langchain/llms/__pycache__/databricks.cpython-311.pyc,,
+langchain/llms/__pycache__/deepinfra.cpython-311.pyc,,
+langchain/llms/__pycache__/deepsparse.cpython-311.pyc,,
+langchain/llms/__pycache__/edenai.cpython-311.pyc,,
+langchain/llms/__pycache__/fake.cpython-311.pyc,,
+langchain/llms/__pycache__/fireworks.cpython-311.pyc,,
+langchain/llms/__pycache__/forefrontai.cpython-311.pyc,,
+langchain/llms/__pycache__/gigachat.cpython-311.pyc,,
+langchain/llms/__pycache__/google_palm.cpython-311.pyc,,
+langchain/llms/__pycache__/gooseai.cpython-311.pyc,,
+langchain/llms/__pycache__/gpt4all.cpython-311.pyc,,
+langchain/llms/__pycache__/gradient_ai.cpython-311.pyc,,
+langchain/llms/__pycache__/huggingface_endpoint.cpython-311.pyc,,
+langchain/llms/__pycache__/huggingface_hub.cpython-311.pyc,,
+langchain/llms/__pycache__/huggingface_pipeline.cpython-311.pyc,,
+langchain/llms/__pycache__/huggingface_text_gen_inference.cpython-311.pyc,,
+langchain/llms/__pycache__/human.cpython-311.pyc,,
+langchain/llms/__pycache__/javelin_ai_gateway.cpython-311.pyc,,
+langchain/llms/__pycache__/koboldai.cpython-311.pyc,,
+langchain/llms/__pycache__/llamacpp.cpython-311.pyc,,
+langchain/llms/__pycache__/loading.cpython-311.pyc,,
+langchain/llms/__pycache__/manifest.cpython-311.pyc,,
+langchain/llms/__pycache__/minimax.cpython-311.pyc,,
+langchain/llms/__pycache__/mlflow.cpython-311.pyc,,
+langchain/llms/__pycache__/mlflow_ai_gateway.cpython-311.pyc,,
+langchain/llms/__pycache__/modal.cpython-311.pyc,,
+langchain/llms/__pycache__/mosaicml.cpython-311.pyc,,
+langchain/llms/__pycache__/nlpcloud.cpython-311.pyc,,
+langchain/llms/__pycache__/octoai_endpoint.cpython-311.pyc,,
+langchain/llms/__pycache__/ollama.cpython-311.pyc,,
+langchain/llms/__pycache__/opaqueprompts.cpython-311.pyc,,
+langchain/llms/__pycache__/openai.cpython-311.pyc,,
+langchain/llms/__pycache__/openllm.cpython-311.pyc,,
+langchain/llms/__pycache__/openlm.cpython-311.pyc,,
+langchain/llms/__pycache__/pai_eas_endpoint.cpython-311.pyc,,
+langchain/llms/__pycache__/petals.cpython-311.pyc,,
+langchain/llms/__pycache__/pipelineai.cpython-311.pyc,,
+langchain/llms/__pycache__/predibase.cpython-311.pyc,,
+langchain/llms/__pycache__/predictionguard.cpython-311.pyc,,
+langchain/llms/__pycache__/promptlayer_openai.cpython-311.pyc,,
+langchain/llms/__pycache__/replicate.cpython-311.pyc,,
+langchain/llms/__pycache__/rwkv.cpython-311.pyc,,
+langchain/llms/__pycache__/sagemaker_endpoint.cpython-311.pyc,,
+langchain/llms/__pycache__/self_hosted.cpython-311.pyc,,
+langchain/llms/__pycache__/self_hosted_hugging_face.cpython-311.pyc,,
+langchain/llms/__pycache__/stochasticai.cpython-311.pyc,,
+langchain/llms/__pycache__/symblai_nebula.cpython-311.pyc,,
+langchain/llms/__pycache__/textgen.cpython-311.pyc,,
+langchain/llms/__pycache__/titan_takeoff.cpython-311.pyc,,
+langchain/llms/__pycache__/titan_takeoff_pro.cpython-311.pyc,,
+langchain/llms/__pycache__/together.cpython-311.pyc,,
+langchain/llms/__pycache__/tongyi.cpython-311.pyc,,
+langchain/llms/__pycache__/utils.cpython-311.pyc,,
+langchain/llms/__pycache__/vertexai.cpython-311.pyc,,
+langchain/llms/__pycache__/vllm.cpython-311.pyc,,
+langchain/llms/__pycache__/volcengine_maas.cpython-311.pyc,,
+langchain/llms/__pycache__/watsonxllm.cpython-311.pyc,,
+langchain/llms/__pycache__/writer.cpython-311.pyc,,
+langchain/llms/__pycache__/xinference.cpython-311.pyc,,
+langchain/llms/__pycache__/yandex.cpython-311.pyc,,
+langchain/llms/ai21.py,sha256=MOgNKiDsANlKlvHWkxN2QMTkVdUp4DB7XV9z9QZwAOA,103
+langchain/llms/aleph_alpha.py,sha256=2K8B2EQmVcyNobdMmYafypt2hE95M50u6L_ZNW-RXkA,86
+langchain/llms/amazon_api_gateway.py,sha256=9cFdC_Q9D85bqaNUJ3MNtIUVdskJ1WHEoVlYbwtgxUI,114
+langchain/llms/anthropic.py,sha256=r1xGrN_jdz87jvjOdCqXwz4jER5JKrr2sx2JdRIrtoc,82
+langchain/llms/anyscale.py,sha256=rEJZRzmjx1Wfz0a4oew1V8WfCM2qa5mLiNQmhlNXM1s,88
+langchain/llms/arcee.py,sha256=3N1zGDYmyer1q2XRBELlUYPhdE8LdRbVhBUrgeVYOMQ,70
+langchain/llms/aviary.py,sha256=nPjf9mMExFw_3CWQtQHOCgmd_uQsyfsWzxyUVRRXzRc,82
+langchain/llms/azureml_endpoint.py,sha256=dtLP_f0juITFcq-YK_pTBGy7QsPRldqYfQfcLnnq3uE,521
+langchain/llms/baidu_qianfan_endpoint.py,sha256=YYHju0X753J0nrDM8z02aKnzIyD78zWLn0Fo10g2wEA,113
+langchain/llms/bananadev.py,sha256=yG07p9du_2NHSooBmS6QwlgwhCFShJt0oW3NI03UaRQ,76
+langchain/llms/base.py,sha256=U5JQFvbg4kCqrsaPW7uGustnjHEOmq6a--zmdz2xSXk,228
+langchain/llms/baseten.py,sha256=9Q7pVMmSOt65yp0c9VS4qkGLHUQD6YaACsen-hXZBGk,76
+langchain/llms/beam.py,sha256=ySqTSErf66NnEvVqTC68TosyIUziY6dnBdXu4q0KKzY,67
+langchain/llms/bedrock.py,sha256=MRNISQBituaw1i1Q_ev4goTRLrCkcLUz250f8WMqcDQ,128
+langchain/llms/bittensor.py,sha256=PE5RCiuXPIz4qPQHfXrBWReUoFrXQyV2Z72qDnHpiOk,92
+langchain/llms/cerebriumai.py,sha256=c0qbjJqU9dZNpEfQpPHAbBdd5PhevLjxtuz_TVezSEg,88
+langchain/llms/chatglm.py,sha256=1oByuTbn3JKZ6zbu2un_YKIHNVZVeNGPd9b-XuGfLDg,76
+langchain/llms/clarifai.py,sha256=09rBTtuQ-T17bT75w4DPCBNr9IUjCY3Y-5UrKa5jiEg,79
+langchain/llms/cloudflare_workersai.py,sha256=nzi3Vq86GHnHNp2k1MR8F9fTjss1IqwXUHY5N5_STD0,113
+langchain/llms/cohere.py,sha256=RKbltkyPS0Jk6oBVAXJQENKliPtUe2PD1tlyTWBOQs4,89
+langchain/llms/ctransformers.py,sha256=H2RGolVBTp8JQy4pOu6TtP67EfBOMrm7aFfgijDQhSk,94
+langchain/llms/ctranslate2.py,sha256=qd8Jf9Q6PMC8fB81TMhjNuOZm0kVeXbJFcnto6smoS8,88
+langchain/llms/databricks.py,sha256=kje2Kh1zD52_VPlsmvXrAOPqe9W4vf3tXjgyFxUqJ-8,101
+langchain/llms/deepinfra.py,sha256=EeUiYZh4B9CeierVaYzJM8XB-lgaLlooDGHQXlrltGc,98
+langchain/llms/deepsparse.py,sha256=MqoTeYnh0F7RfnwAFyQki3Sx_9fytll_WMtublQVMD4,85
+langchain/llms/edenai.py,sha256=NHd0azPjhqA95qbZ--ZPYdbcctud4WZv-0Fm3v_xyMo,73
+langchain/llms/fake.py,sha256=tk8dd3bk3hZsZskXFZbUB8WWzZrX5TDAzVO3UR3b9iE,127
+langchain/llms/fireworks.py,sha256=tuwsRecmikwf1nSdE4cqF9cXWdvrplStjJF1a0v9iBk,98
+langchain/llms/forefrontai.py,sha256=6anDWi8AEvVFGbsF5n9-t4P_7tXSWiiPauz8KvZudwg,88
+langchain/llms/gigachat.py,sha256=HOsPXJkuX1fLHe13cVe0wgJwdjSGj0WK7Zrnr5BFmEw,79
+langchain/llms/google_palm.py,sha256=50tYggCs702ru-Vm1JRkazq75Ro-aR2UyGvFuM0TaoQ,86
+langchain/llms/gooseai.py,sha256=uboEmCvlLepewT8PtGu7FLELf7boGF5PAXl9rqIJWA0,76
+langchain/llms/gpt4all.py,sha256=djt67iZajcacPpykcYL1NCYJABWaNkQnFKdw7snxBtw,76
+langchain/llms/gradient_ai.py,sha256=qpJ4zqD8OOc1GlmZrPArIKO7JNfyNOaH-HMR6BYkMgA,116
+langchain/llms/grammars/json.gbnf,sha256=htDQy5F1h7Q6K9kuc1j7a_LUw8Dhj-_rhQc28OJqluQ,664
+langchain/llms/grammars/list.gbnf,sha256=9cg8vDmOQ-jZvKSj-hyvTUl05Igbw_416yRQnB2VqcA,167
+langchain/llms/huggingface_endpoint.py,sha256=Pkg_b_hR3ptsNRRFliwZxibuSiQ9GVLlLPWpHemMHRw,122
+langchain/llms/huggingface_hub.py,sha256=MkOLl_JGoRWMe-1IwtEj2GQUbj7XepEe2j3SKi1_rZ0,107
+langchain/llms/huggingface_pipeline.py,sha256=Zp_G8BqnOtV2JazcbQCVhdRlv91QBHe-2zQtpMmv0JY,129
+langchain/llms/huggingface_text_gen_inference.py,sha256=EeUj3uXPm-0p_kxuUsJ6XYXxTEd8u9ToPb5v8FxwP50,148
+langchain/llms/human.py,sha256=NGYBm_lqgqCvNR-Nn8UkMFBIfwO3qyB2_7WPu1Ef7ag,95
+langchain/llms/javelin_ai_gateway.py,sha256=jp3eCqFYvOUgtSgJ_euENxsBUfS7uAYj54_lXqH-mFQ,123
+langchain/llms/koboldai.py,sha256=syU76ouer-ZdNfevGNt9c8NKdwGZTXj-sRNifFnA6fs,87
+langchain/llms/llamacpp.py,sha256=G5HTxxY022r8eGcI4de-EwnZ-SgFl6qTxCaxRoiuG9k,79
+langchain/llms/loading.py,sha256=UTW-1mzY2AQRrCJIwJW5nWd96ktbKkuU2j68eprib7Q,124
+langchain/llms/manifest.py,sha256=8hQLnQsM2CIDuBcnSJIVSD8z5zkBTjNKAgS2kY4qa2c,93
+langchain/llms/minimax.py,sha256=SZ3vmrBZqhimZ4V1Ql_X6xTE9ReRVnelQxhcJ9dN8QU,85
+langchain/llms/mlflow.py,sha256=tGJb65Diz7lyY0mR29dq84RPJxruzzRaPzEnYrzRmx4,73
+langchain/llms/mlflow_ai_gateway.py,sha256=8Y4jh2PLsZid8pBa9g_LTWyNL5_XapYEwLmMLAizupE,102
+langchain/llms/modal.py,sha256=8BzOuwYZbhjmWA2vbwVLv0z2kxwNUTf5WEAquWZAwHQ,70
+langchain/llms/mosaicml.py,sha256=b5-8tm5KhdBYNeamH-1cpmVHWy483hK1zzZ-520s_Q4,95
+langchain/llms/nlpcloud.py,sha256=7OtFsJ0WxrAkn9Mk59Ii53N6JIJiaMzz1vzPN66CK6o,79
+langchain/llms/octoai_endpoint.py,sha256=svQLMgwTZQGj62AGXQp75lOLf5yM1KeU0OAsoxRJcmY,98
+langchain/llms/ollama.py,sha256=N3-OF2ZLhLN9zpXgsVmHu8-_H189aSnYn9QXgeL5Mpg,82
+langchain/llms/opaqueprompts.py,sha256=DjXoOUj1usOydMgc7_maDSq17A-IYAfwAHwrj29vmU4,94
+langchain/llms/openai.py,sha256=3j3swb8X6bp7JDDFJ9FNEKO1W-x841_2_IaY07on4x8,193
+langchain/llms/openllm.py,sha256=c99X7wHJFg_SZG350cJ7sEogLEaDO-inE4rAzB5LR4A,76
+langchain/llms/openlm.py,sha256=6WJLQ0fOt3PhUe4ipkDEarYsJrQ4sGg99oZMjSSz1as,73
+langchain/llms/pai_eas_endpoint.py,sha256=Kp15bXncPatUuty8zq51yvzAFtM_apCi_5a6qR97Zvg,99
+langchain/llms/petals.py,sha256=Job81DuK2sdvqWtIdZnc32OqWNB_sX5HRGfArtEJonY,73
+langchain/llms/pipelineai.py,sha256=3dxAYbgTLqbw4rqcfs1KqiZ5UiZhXjQeWhIav9salNk,85
+langchain/llms/predibase.py,sha256=5itNQWxgx_W4HIz3qHrOHr4YqPvBwwvALPACYrzosrQ,82
+langchain/llms/predictionguard.py,sha256=o8S9Bj5RDjGFP_P40is6wRcWqY6Mc6KHc0SnRepD6k8,100
+langchain/llms/promptlayer_openai.py,sha256=RhNNYyu0ATf9taylsWRKLg1qsj5L3DpdN_tsCWUAc5U,168
+langchain/llms/replicate.py,sha256=7eSUE-IfsWSNAdLHVnWLinEbcjUD-0cSZot8Ntr1XxE,82
+langchain/llms/rwkv.py,sha256=0u_4HPYW85v1Ae6b_SAXsMZhQibkO2O5UvZxOX4X_jI,67
+langchain/llms/sagemaker_endpoint.py,sha256=ow5G8_yJrN72lmT-Xf1vV9Xw3Ggyw7HtUDTHCFyBD8I,160
+langchain/llms/self_hosted.py,sha256=peGJJv4YwXjWAuT3l6enZUaYhAWgmhD5GL853BM__N8,111
+langchain/llms/self_hosted_hugging_face.py,sha256=nrbkxpG_HWRRpbMPM3JZ8VFeExJN6QeoUJDaciq9ecE,143
+langchain/llms/stochasticai.py,sha256=0lOpzZu5vkfQEF2pb0bRHkvllyc6bpwDCqrmKohK-p8,91
+langchain/llms/symblai_nebula.py,sha256=nFmLcAcNr48jZRWAQxlBnl2DjNzdWTxOyh1fjsOwR6E,97
+langchain/llms/textgen.py,sha256=mNJkJBWGtDaQsaYDUquUhP60qwJKu-z9UWqNnumIEM8,76
+langchain/llms/titan_takeoff.py,sha256=8vek6iVxODTyzlW3Iyws1CBwhakkh4ZiqpFBXSmjEaA,92
+langchain/llms/titan_takeoff_pro.py,sha256=0iKHxirPlG45Vea9_rBSMc0qmANzvL2_pzfOiOZyc-4,102
+langchain/llms/together.py,sha256=CLQcAx8hckN1M23H_wIuz7NHn1nDwt7P5QnD1Vtn8NE,79
+langchain/llms/tongyi.py,sha256=3SBrQIPQc0BvrQ6PWxpO7IALwkDWbo1TtIq3q8jYoI8,89
+langchain/llms/utils.py,sha256=z0go9Vftuzb8jR8Au7fw-m6orKTnNWq9PUYnppQfuAk,98
+langchain/llms/vertexai.py,sha256=_e7RhN7chTHYaQx8LTnhL0TMU2dz8EPATuTT_DlA4LE,147
+langchain/llms/vllm.py,sha256=rC2wMb8GewpLDf7JQWgjag-r0Tq3ivlptdpO0RYjCM8,93
+langchain/llms/volcengine_maas.py,sha256=Lgs-h9B6gZ6jf9xkEXi0iRa4khQXPSqKbiHOdEaOMoA,159
+langchain/llms/watsonxllm.py,sha256=vF8Ca4wsw1Nz9BgYEulSzfziusIf9-mOyBFmmcSS8Xk,85
+langchain/llms/writer.py,sha256=Mq-zBdE6ZDBIocqIIvr6JuJ_vhqc4QcjWpu8WYDFWbs,73
+langchain/llms/xinference.py,sha256=62izKI5XA0FnfYrKyslnIeMpCId3z7KczXysSwmzZ2M,85
+langchain/llms/yandex.py,sha256=7o0mtHpc3CtwBPysv2G5h1cJxNIzTq-4p1j5QQOeoqY,79
+langchain/load/__init__.py,sha256=sMLwVuG0tmiPmZPwzweooVeLBS1XK8gpz7ryKMWUsyA,206
+langchain/load/__pycache__/__init__.cpython-311.pyc,,
+langchain/load/__pycache__/dump.cpython-311.pyc,,
+langchain/load/__pycache__/load.cpython-311.pyc,,
+langchain/load/__pycache__/serializable.cpython-311.pyc,,
+langchain/load/dump.py,sha256=st-Wju0x5jrMVfMzjeKF1jo3Jvn8b1cCCfLrAaIYvhM,100
+langchain/load/load.py,sha256=sxSF6ySrMY4ouq77JPiuZKRx2lyVbqLoMi5ni5bHzAI,98
+langchain/load/serializable.py,sha256=6iZp1sg_ozIDqXTDEk60IP89UEwZEJ4j0oMaHascLKI,412
+langchain/memory/__init__.py,sha256=P0G9n1q22HOrNvTcLVUXCFNLP2KcFxZKP5W3NcLZ4mA,3256
+langchain/memory/__pycache__/__init__.cpython-311.pyc,,
+langchain/memory/__pycache__/buffer.cpython-311.pyc,,
+langchain/memory/__pycache__/buffer_window.cpython-311.pyc,,
+langchain/memory/__pycache__/chat_memory.cpython-311.pyc,,
+langchain/memory/__pycache__/combined.cpython-311.pyc,,
+langchain/memory/__pycache__/entity.cpython-311.pyc,,
+langchain/memory/__pycache__/kg.cpython-311.pyc,,
+langchain/memory/__pycache__/motorhead_memory.cpython-311.pyc,,
+langchain/memory/__pycache__/prompt.cpython-311.pyc,,
+langchain/memory/__pycache__/readonly.cpython-311.pyc,,
+langchain/memory/__pycache__/simple.cpython-311.pyc,,
+langchain/memory/__pycache__/summary.cpython-311.pyc,,
+langchain/memory/__pycache__/summary_buffer.cpython-311.pyc,,
+langchain/memory/__pycache__/token_buffer.cpython-311.pyc,,
+langchain/memory/__pycache__/utils.cpython-311.pyc,,
+langchain/memory/__pycache__/vectorstore.cpython-311.pyc,,
+langchain/memory/__pycache__/zep_memory.cpython-311.pyc,,
+langchain/memory/buffer.py,sha256=XfndrJ0nTIArL2G9BZUeMOWViKQ_AVEXEybznUKXdhE,4861
+langchain/memory/buffer_window.py,sha256=hRFiodXZC1Xu7DFTmbWp5wtosuBkAEHQsPEXmMd-XIk,1616
+langchain/memory/chat_memory.py,sha256=GTl405oysAMRomCLyVyzcBENqokUml1ZO8ykbsROL9o,2816
+langchain/memory/chat_message_histories/__init__.py,sha256=eEWkzX2wmfOQb6e9gxG2aOYQtET58ZUt115pgDPx2o4,1560
+langchain/memory/chat_message_histories/__pycache__/__init__.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/astradb.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/cassandra.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/cosmos_db.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/dynamodb.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/elasticsearch.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/file.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/firestore.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/in_memory.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/momento.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/mongodb.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/neo4j.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/postgres.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/redis.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/rocksetdb.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/singlestoredb.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/sql.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/streamlit.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/upstash_redis.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/xata.cpython-311.pyc,,
+langchain/memory/chat_message_histories/__pycache__/zep.cpython-311.pyc,,
+langchain/memory/chat_message_histories/astradb.py,sha256=dLFhpwkQxQqPGybUNC1pXq2ttG-1SprkQ7lKnkEMCYE,139
+langchain/memory/chat_message_histories/cassandra.py,sha256=YfVy7dBbmeUkmLYH3V-soJ_6vyQCtAAzxg1tbkvCn5Y,145
+langchain/memory/chat_message_histories/cosmos_db.py,sha256=D9_ogc1l5oZRZYE2Q5PVvSadvsZ0TfJ7rkH7EgMeYZ4,143
+langchain/memory/chat_message_histories/dynamodb.py,sha256=4Ffat52_ngxueLfGjQKAeMyngBCq2TN9xhdj0XiEB9U,142
+langchain/memory/chat_message_histories/elasticsearch.py,sha256=3KNMHd3QA9DrAiMLanEFjQWdWoF9eMJN4opbQj-K-4U,157
+langchain/memory/chat_message_histories/file.py,sha256=js59UuWvv5KCq43Ak3psEgM4oBqfHqILTpBkjzeL1w4,121
+langchain/memory/chat_message_histories/firestore.py,sha256=zb1HWdQAlz3eEY1YhFiwssLijaOzOXGt7xsSfwxZxus,145
+langchain/memory/chat_message_histories/in_memory.py,sha256=Si6oOhUUKu32TeMW76jM5NWLU8x3p-_HmSKenJHlyTo,118
+langchain/memory/chat_message_histories/momento.py,sha256=aei5Q987eoyFLzjsmEjPVVZQMkQoCAOPPDZ-8CeTzRQ,139
+langchain/memory/chat_message_histories/mongodb.py,sha256=muB2Q7BKtxNcy7UDATFq9s61cErYY5pg9Up5VONU1z8,139
+langchain/memory/chat_message_histories/neo4j.py,sha256=hFt5RSBXay62pokOMKfs3srBDeW7-8Rp0OiQPdEwwfw,124
+langchain/memory/chat_message_histories/postgres.py,sha256=eCIkhkUT6qtkmyr-XPT3szTrrOwC2VHqKxjjaFWUeik,142
+langchain/memory/chat_message_histories/redis.py,sha256=ORwyGe39Ab5WQ5EsosknRtbylLidjMuE5aR_lOo38Xk,124
+langchain/memory/chat_message_histories/rocksetdb.py,sha256=MzDkgAwT-EfquTNpM05EgpqV4NRs252-WY-S-xYGKRE,141
+langchain/memory/chat_message_histories/singlestoredb.py,sha256=kQ2wdS8d4udKroFH61LHXSKwPPQM76rd4YLfL8J6-WY,157
+langchain/memory/chat_message_histories/sql.py,sha256=fzFl0oafVvMfTWTaeAmgMRJlcNFiTAHRsz7b5OvTBlw,248
+langchain/memory/chat_message_histories/streamlit.py,sha256=zYC1SFYB1Fhzay9PHJFAloYAieOX6vcLz8C3bTowED0,145
+langchain/memory/chat_message_histories/upstash_redis.py,sha256=1eXeNwfqN2vIPCDbuwA-pwZBP_KGyyVAsJx75e-2r3Q,155
+langchain/memory/chat_message_histories/xata.py,sha256=dvb2Mbk6saCfPl7TOwOYRhoTCCYdgWqt6yZF5-2Xa-E,121
+langchain/memory/chat_message_histories/zep.py,sha256=g1A1L-DuLPDPCLsBuNPud2gfcjrahgARqXap9RyVaic,118
+langchain/memory/combined.py,sha256=nA2roWNoyXfCnOkwSNV9tRnQPgKg9malEpTsKAYzS0I,2912
+langchain/memory/entity.py,sha256=ZB74qN5ZLBstkwQeXw78JaDHHuEwe9fcHX_o16Cixfc,15677
+langchain/memory/kg.py,sha256=oqSk_F19Sn38ed0jTc2uj_QFiG2gMNNrrP2DFeIx5e8,5075
+langchain/memory/motorhead_memory.py,sha256=yF3E19JTswGAaE3vZzDwVhW88j1TBtrZNrfj2d-roj8,3106
+langchain/memory/prompt.py,sha256=r8vxZSRydSOWJzRszStN0Wky4n3fyM_QJ2XoKMsP3JA,8181
+langchain/memory/readonly.py,sha256=OixsZwxzaTL3niS8Ulx5cxNdXT0lxVtWNtwMI2ueOAc,794
+langchain/memory/simple.py,sha256=7El81OHJA0HBqwJ-AZDTQFPfB7B5NEsmY_fEOrwD0XA,761
+langchain/memory/summary.py,sha256=zmDx7LN2GeE0RwfQYQ80b3pNQE6P7gTxQ77OuffBl8A,3389
+langchain/memory/summary_buffer.py,sha256=DwkuprrrA1nszrE49wADEKyNB0--VFldgWDCt8CE10M,2949
+langchain/memory/token_buffer.py,sha256=E1N7bWSkAmi-7V7F-7iRl-BADStnplp-zwtUndjXBMM,2144
+langchain/memory/utils.py,sha256=PvauM6AkPRX5Hy5sY6NysuieRI9Oae1IeC61y1iIQMs,617
+langchain/memory/vectorstore.py,sha256=djrjWiiEiCMr5PJDBcaeQq5WWypDCwfB2HRhjWCKylM,3907
+langchain/memory/zep_memory.py,sha256=645I8HieQEm5bm0ICpS494yrlrdviz7Fc_1bkaibBNY,5090
+langchain/model_laboratory.py,sha256=IaJzVG_SbFX7W6ODriqqme-Q5x0MB18j4Bhg1Y-fWLo,3278
+langchain/output_parsers/__init__.py,sha256=_Gig7YqIxM6TAuvHMxfDsbxS2bN6XKfxZ7T0ZaRC36E,2216
+langchain/output_parsers/__pycache__/__init__.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/boolean.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/combining.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/datetime.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/enum.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/ernie_functions.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/fix.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/format_instructions.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/json.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/list.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/loading.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/openai_functions.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/openai_tools.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/pandas_dataframe.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/prompts.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/pydantic.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/rail_parser.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/regex.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/regex_dict.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/retry.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/structured.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/xml.cpython-311.pyc,,
+langchain/output_parsers/__pycache__/yaml.cpython-311.pyc,,
+langchain/output_parsers/boolean.py,sha256=1-_Xtqhq-9ll4GxfPXW_5sAjAbODCWKF6yTPdVhY8mQ,1689
+langchain/output_parsers/combining.py,sha256=9AcNNou-wCmbEvRL37c650O-FrW_FieJoaMq-4ACRO8,1799
+langchain/output_parsers/datetime.py,sha256=zxhwax0YxVahE3CCHMXTqjpyzQcffgZ9J0NA0qLL0_8,1974
+langchain/output_parsers/enum.py,sha256=ldgLvck3wxyLe7LQLDYdoSmFmqNugDpvV-4fBcusjMI,1205
+langchain/output_parsers/ernie_functions.py,sha256=SVm5rOfRtDrgtZ-2E767bHAsV4Zn5yGq0o1BK-fmhJk,424
+langchain/output_parsers/fix.py,sha256=EgpI-ocw27n_6X1-ciXUtNBCUUxEZ1x15IX7bqbKHh8,3153
+langchain/output_parsers/format_instructions.py,sha256=y5oSpjwzgmvYRNhfe0JmKHHdFZZP65L2snJI6xcMXEY,3958
+langchain/output_parsers/json.py,sha256=2FJL7uLd7pHgvpQm-r5XDyt9S1ZZ9mlJUW8ilQAQ0k4,340
+langchain/output_parsers/list.py,sha256=D35r0U51Xy5wHn-VcWxr97Ftul4UqszmyLetDi4syYQ,310
+langchain/output_parsers/loading.py,sha256=YD3RZ8TTBVtVTXdV14xpj_RNZqrJgclk9J9fHQI7YIA,702
+langchain/output_parsers/openai_functions.py,sha256=XmqUCySXGsaHugtItczb8K71lrQIfMNYvAofP9ZEF7U,364
+langchain/output_parsers/openai_tools.py,sha256=beZWrEXyOyGMVWJ7lWE7xxEgbfQCuQnHligdxuEQxng,229
+langchain/output_parsers/pandas_dataframe.py,sha256=Zom-2Bv9tNFIsI74kJa05kvoTNubaAoK4GdSLYoT3hk,6548
+langchain/output_parsers/prompts.py,sha256=zVhB4xjeWW3MKm4ZM8RfIiPUMg06SJAhYVmCa3jCNS8,508
+langchain/output_parsers/pydantic.py,sha256=uxbrfdyPnZxfdDvmuDr3QOmBFMwML3SfMDEmAKqmyvA,99
+langchain/output_parsers/rail_parser.py,sha256=bHyA04SJlDhhim8q6SguOcNOoBJl_oZvuqVSxFgpKHA,129
+langchain/output_parsers/regex.py,sha256=Rp6Mbkp9EQM2XlqmZ8qYtK3Hm_4rVHlYxF_jngcRQDs,1214
+langchain/output_parsers/regex_dict.py,sha256=ZT1a4n63T-ju853QwZBXhniQQWlSuAPrtd6CDnUMOpA,1709
+langchain/output_parsers/retry.py,sha256=2l3_a5HVwtXsKk3yd26iys9_mLx13Tr5u-VqDKY5s2s,7792
+langchain/output_parsers/structured.py,sha256=H6ng-GMMuTWoyc7EXMdlmS7Xz2w1gmOsZhzCc8Qgrd0,3134
+langchain/output_parsers/xml.py,sha256=WDHazWjxO-nDAzxkBJrd1tGINVrzo4mH2-Qgqtz9Y2w,93
+langchain/output_parsers/yaml.py,sha256=nedQqQivPTj7NlG2j2Tl0PGbZVHO26QOqP16tsLuWh8,2181
+langchain/prompts/__init__.py,sha256=IfjeJzLMqbK4jyPiYptdx_eDl_eKhTgG5L8RAQD5WoY,2560
+langchain/prompts/__pycache__/__init__.cpython-311.pyc,,
+langchain/prompts/__pycache__/base.cpython-311.pyc,,
+langchain/prompts/__pycache__/chat.cpython-311.pyc,,
+langchain/prompts/__pycache__/few_shot.cpython-311.pyc,,
+langchain/prompts/__pycache__/few_shot_with_templates.cpython-311.pyc,,
+langchain/prompts/__pycache__/loading.cpython-311.pyc,,
+langchain/prompts/__pycache__/pipeline.cpython-311.pyc,,
+langchain/prompts/__pycache__/prompt.cpython-311.pyc,,
+langchain/prompts/base.py,sha256=QATYkT1NM2-QElHrC4qapaOm3FDxDOgPCdJixuziSbM,565
+langchain/prompts/chat.py,sha256=ohOf8VGpdG2FaEBCzSLB0YPdT_8LmBwQGnb1pYVlZFc,1045
+langchain/prompts/example_selector/__init__.py,sha256=j8YecJzLMwaHOJSL-QAPJfeeuszNxfoNQvVyG1T940E,568
+langchain/prompts/example_selector/__pycache__/__init__.cpython-311.pyc,,
+langchain/prompts/example_selector/__pycache__/base.cpython-311.pyc,,
+langchain/prompts/example_selector/__pycache__/length_based.cpython-311.pyc,,
+langchain/prompts/example_selector/__pycache__/ngram_overlap.cpython-311.pyc,,
+langchain/prompts/example_selector/__pycache__/semantic_similarity.cpython-311.pyc,,
+langchain/prompts/example_selector/base.py,sha256=3n6781kzGl-MphxZkad_GvFBgU5r8VuxD2q6FOcZ5fk,105
+langchain/prompts/example_selector/length_based.py,sha256=ZA-o8JtrvRldXlow83arXEPZJL69c2q6-cCclgi85yg,136
+langchain/prompts/example_selector/ngram_overlap.py,sha256=2wyqQdekAVAXcPzgCBavaZ18NH_X73Yn1wX33JgYdMs,203
+langchain/prompts/example_selector/semantic_similarity.py,sha256=NkoM8e6-Cn9Mo3mH4Zgl8e3Gb4WnsqarwZalFqdgCcI,288
+langchain/prompts/few_shot.py,sha256=gY6lvzJ71_Rsg6o8xx_L3DD8cBy42n1Dc9GCHQmwqOs,265
+langchain/prompts/few_shot_with_templates.py,sha256=Dr2NQbv46aY44wMLz21Ai1jmvzbIhPYW4yYv6GLlVbI,128
+langchain/prompts/loading.py,sha256=i5tFvi3So9-joanAD2rwsp3jZq0nLBCgJ6fO7uFLcPw,530
+langchain/prompts/pipeline.py,sha256=vTdOcggYTfRc4VV2ob-19fsU_iSc96USyazS2EKxthk,133
+langchain/prompts/prompt.py,sha256=Q8sBG8MMTlIq_ErEbIsY0dnXkSCthAr8ntpAu3ZR6X8,153
+langchain/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/pydantic_v1/__init__.py,sha256=ta8Y50aRTwZP6qXnyh_0r56QNq9B044FWT_jjuAyV0E,897
+langchain/pydantic_v1/__pycache__/__init__.cpython-311.pyc,,
+langchain/pydantic_v1/__pycache__/dataclasses.cpython-311.pyc,,
+langchain/pydantic_v1/__pycache__/main.cpython-311.pyc,,
+langchain/pydantic_v1/dataclasses.py,sha256=ua-hUftg0xEtbBLgu7gV7BGgpD2Hk3PGfDxCxUi5DZ8,134
+langchain/pydantic_v1/main.py,sha256=QH2LgCi4tr-tLt3t6KhMykILHDzbqpPWaGQN4BUspOY,120
+langchain/python.py,sha256=AezWDeE9CnXOTx2OdfpNRToQYlKjtxv47uDNa2DbuWE,121
+langchain/requests.py,sha256=GlaNOLSXhbpgn4Y3MeuIaMSnBBAnwYl2VnKqTF5EjaA,222
+langchain/retrievers/__init__.py,sha256=Pf1Qkn3zL5b0uGg_j2L68qveGRzehVlW8QfKiXe_Y3I,3518
+langchain/retrievers/__pycache__/__init__.cpython-311.pyc,,
+langchain/retrievers/__pycache__/arcee.cpython-311.pyc,,
+langchain/retrievers/__pycache__/arxiv.cpython-311.pyc,,
+langchain/retrievers/__pycache__/azure_ai_search.cpython-311.pyc,,
+langchain/retrievers/__pycache__/bedrock.cpython-311.pyc,,
+langchain/retrievers/__pycache__/bm25.cpython-311.pyc,,
+langchain/retrievers/__pycache__/chaindesk.cpython-311.pyc,,
+langchain/retrievers/__pycache__/chatgpt_plugin_retriever.cpython-311.pyc,,
+langchain/retrievers/__pycache__/cohere_rag_retriever.cpython-311.pyc,,
+langchain/retrievers/__pycache__/contextual_compression.cpython-311.pyc,,
+langchain/retrievers/__pycache__/databerry.cpython-311.pyc,,
+langchain/retrievers/__pycache__/docarray.cpython-311.pyc,,
+langchain/retrievers/__pycache__/elastic_search_bm25.cpython-311.pyc,,
+langchain/retrievers/__pycache__/embedchain.cpython-311.pyc,,
+langchain/retrievers/__pycache__/ensemble.cpython-311.pyc,,
+langchain/retrievers/__pycache__/google_cloud_documentai_warehouse.cpython-311.pyc,,
+langchain/retrievers/__pycache__/google_vertex_ai_search.cpython-311.pyc,,
+langchain/retrievers/__pycache__/kay.cpython-311.pyc,,
+langchain/retrievers/__pycache__/kendra.cpython-311.pyc,,
+langchain/retrievers/__pycache__/knn.cpython-311.pyc,,
+langchain/retrievers/__pycache__/llama_index.cpython-311.pyc,,
+langchain/retrievers/__pycache__/merger_retriever.cpython-311.pyc,,
+langchain/retrievers/__pycache__/metal.cpython-311.pyc,,
+langchain/retrievers/__pycache__/milvus.cpython-311.pyc,,
+langchain/retrievers/__pycache__/multi_query.cpython-311.pyc,,
+langchain/retrievers/__pycache__/multi_vector.cpython-311.pyc,,
+langchain/retrievers/__pycache__/outline.cpython-311.pyc,,
+langchain/retrievers/__pycache__/parent_document_retriever.cpython-311.pyc,,
+langchain/retrievers/__pycache__/pinecone_hybrid_search.cpython-311.pyc,,
+langchain/retrievers/__pycache__/pubmed.cpython-311.pyc,,
+langchain/retrievers/__pycache__/pupmed.cpython-311.pyc,,
+langchain/retrievers/__pycache__/re_phraser.cpython-311.pyc,,
+langchain/retrievers/__pycache__/remote_retriever.cpython-311.pyc,,
+langchain/retrievers/__pycache__/svm.cpython-311.pyc,,
+langchain/retrievers/__pycache__/tavily_search_api.cpython-311.pyc,,
+langchain/retrievers/__pycache__/tfidf.cpython-311.pyc,,
+langchain/retrievers/__pycache__/time_weighted_retriever.cpython-311.pyc,,
+langchain/retrievers/__pycache__/vespa_retriever.cpython-311.pyc,,
+langchain/retrievers/__pycache__/weaviate_hybrid_search.cpython-311.pyc,,
+langchain/retrievers/__pycache__/web_research.cpython-311.pyc,,
+langchain/retrievers/__pycache__/wikipedia.cpython-311.pyc,,
+langchain/retrievers/__pycache__/you.cpython-311.pyc,,
+langchain/retrievers/__pycache__/zep.cpython-311.pyc,,
+langchain/retrievers/__pycache__/zilliz.cpython-311.pyc,,
+langchain/retrievers/arcee.py,sha256=CIQRpdLH8VDw9FvX3XNt_52WhVciaIMx41aknRVXJiA,94
+langchain/retrievers/arxiv.py,sha256=G4OWfJwk3PT5GSH7_w4LGBXO_rlwmYWE4SCI4ku8BsE,94
+langchain/retrievers/azure_ai_search.py,sha256=QdK5Rhd0CZQiiBaqe-EFx3G0pNDUq893uuRGZmRfTWo,197
+langchain/retrievers/bedrock.py,sha256=o0aNnOGSZjHxOeENuCWV85A6-AQ6VC1v-fQHl8iZKlw,221
+langchain/retrievers/bm25.py,sha256=khEsfzFepevPMv0vKmz3mZN7HaE-gV8YH4wiQ3Lg1WU,162
+langchain/retrievers/chaindesk.py,sha256=s2SdMZJvnu9Da6xAOCuPMNyauJSfEtEmd9TycBz8yZ0,106
+langchain/retrievers/chatgpt_plugin_retriever.py,sha256=YQjLKQsKMl0eS6eAJ3Hb4w8sBy9FiMlk08qx5nA3DQw,138
+langchain/retrievers/cohere_rag_retriever.py,sha256=Ee9QCtKSpcscdpCsnfycCZO98dK1l6ulEIdq5T9t1Kg,126
+langchain/retrievers/contextual_compression.py,sha256=X2KYf7kPfkwXwu4t6aORUnWJT00HigaZ1icpgj1D_8w,2298
+langchain/retrievers/databerry.py,sha256=OocBj0scl73SrR7sQHPFJmaRrrlbj_Z84gmdRfXhc0M,106
+langchain/retrievers/docarray.py,sha256=0SDj31BjG3Xe33bHhgqDqZ36gHg5FgOxWf148tf1QQk,129
+langchain/retrievers/document_compressors/__init__.py,sha256=csYDflvu4hOKzLwTf-OVpbWTcVz8WbdEmwt4_1o2_9U,834
+langchain/retrievers/document_compressors/__pycache__/__init__.cpython-311.pyc,,
+langchain/retrievers/document_compressors/__pycache__/base.cpython-311.pyc,,
+langchain/retrievers/document_compressors/__pycache__/chain_extract.cpython-311.pyc,,
+langchain/retrievers/document_compressors/__pycache__/chain_extract_prompt.cpython-311.pyc,,
+langchain/retrievers/document_compressors/__pycache__/chain_filter.cpython-311.pyc,,
+langchain/retrievers/document_compressors/__pycache__/chain_filter_prompt.cpython-311.pyc,,
+langchain/retrievers/document_compressors/__pycache__/cohere_rerank.cpython-311.pyc,,
+langchain/retrievers/document_compressors/__pycache__/cross_encoder_rerank.cpython-311.pyc,,
+langchain/retrievers/document_compressors/__pycache__/embeddings_filter.cpython-311.pyc,,
+langchain/retrievers/document_compressors/__pycache__/flashrank_rerank.cpython-311.pyc,,
+langchain/retrievers/document_compressors/base.py,sha256=Tu_Nvk8azD-ngoTLt7Edr7a8Z_4QWMm8KOgEYdni41k,2938
+langchain/retrievers/document_compressors/chain_extract.py,sha256=vHY9SwaV91WJ-Syg_ALX2GTcebY8oI4awa_vJ_MXTIo,4007
+langchain/retrievers/document_compressors/chain_extract_prompt.py,sha256=FezN4Fk0tRcRFcD1Nf1r2SUyUt49yQKzdcV_iCQj6rE,366
+langchain/retrievers/document_compressors/chain_filter.py,sha256=VAJeI9Fm5ojeCWVM6L3mFxc_ve7bxxrxnSzHHKu8JGk,2757
+langchain/retrievers/document_compressors/chain_filter_prompt.py,sha256=FTQRPiEsZ0Q9MQXXkpBwxtcqJ9D6Zq0GbuTmMpXHobA,231
+langchain/retrievers/document_compressors/cohere_rerank.py,sha256=FXSSnSMtPFIKSFsPwGIZm1mwkJs0b_Ga8ze5R-GQkSU,4532
+langchain/retrievers/document_compressors/cross_encoder_rerank.py,sha256=fFKA6R8lgpD3Hbc0vWZiqnB7XBxEOK3YQGFuRlGyY9M,1575
+langchain/retrievers/document_compressors/embeddings_filter.py,sha256=uifJoeIBYhWqxs8BODSQk8evz9rkMnSshepB_LX52CE,3031
+langchain/retrievers/document_compressors/flashrank_rerank.py,sha256=G2xVWxxsplY-gBfx3yrRwMKZ01oIJZhFp5XrZZyeUgI,2498
+langchain/retrievers/elastic_search_bm25.py,sha256=05ZKr3WkmsSr2EslHYCbImgNHE5jerzAVTOXB71fLSo,141
+langchain/retrievers/embedchain.py,sha256=8MUHo71IXxjq5XWSyjEfUtlr1pq3nrDAlwt5VXqQMhg,109
+langchain/retrievers/ensemble.py,sha256=pLjOQh31Wq10TF6Do48pVGQLm5W0LR4cJ7I1_1BMtFE,9711
+langchain/retrievers/google_cloud_documentai_warehouse.py,sha256=H77viL6oNUaMITDojhDd3Tk25tGV950g_AiHe5FUpGQ,171
+langchain/retrievers/google_vertex_ai_search.py,sha256=EmBDSTcuCg5HY4X-jCpC-MfkN_hmi8BCbMjlQLGFIJg,334
+langchain/retrievers/kay.py,sha256=AVBLxCPAWm9eOPyv5pWgwbI7tz9UPjR12zawO2EE_Rw,92
+langchain/retrievers/kendra.py,sha256=AcYvPcZ8HhQT0bMQTJZL90E1d5Eqxxuu4OZU3RZl9b8,803
+langchain/retrievers/knn.py,sha256=ovmLvG_UWlHYFTsDx_DE6WQLakAupscPWzpZZ8Onsqc,88
+langchain/retrievers/llama_index.py,sha256=kvBJZkKAZmQx6foSpsFvajeO8fZ_AUNgXT0on_QpzMc,177
+langchain/retrievers/merger_retriever.py,sha256=-nVV9J_8CmdBVT_h9y-udQY3legBaUj1t949oe_etN8,3487
+langchain/retrievers/metal.py,sha256=-0sYcaLkiNz3RCCX7c2dE9MDmYH0hdJKdL2Ko0vEGik,94
+langchain/retrievers/milvus.py,sha256=xvPRA6DsgJFwd2liK7SN-qRENVneZwuLyuEKayRFmww,133
+langchain/retrievers/multi_query.py,sha256=s3GwX_LZAnGMs8yCt5burCS_0LFXyeplQAuVutRDY3E,6768
+langchain/retrievers/multi_vector.py,sha256=0bt0wTfm1Ha21fH3Ikoln-iXzbnyHIh6lWI1vrmZMaI,3920
+langchain/retrievers/outline.py,sha256=_baTn0VKNOBYa5EFbP2iDxAYEHRvvZfRa6wSv5GFUR8,100
+langchain/retrievers/parent_document_retriever.py,sha256=CpllvOKP0YV1jZVX8U8KHftXS3kdA2jN--fk_KtyAEU,5198
+langchain/retrievers/pinecone_hybrid_search.py,sha256=IqFoqEzTvPsQ-vgnHiRVmGPZm3xlv4S8KdlVvqAMKIQ,150
+langchain/retrievers/pubmed.py,sha256=ljGEJBB2VRw79gd78j1F-OtW0tM3jjiLkUxrd-4-rtI,97
+langchain/retrievers/pupmed.py,sha256=EAueSZ7LnN8amj35xvFJ4XwWdit50vJjDpsE_SXeum8,94
+langchain/retrievers/re_phraser.py,sha256=IUspelPkQopXGv3wwWP6wJY8sYAtczCKZxwKdc6E8-M,2658
+langchain/retrievers/remote_retriever.py,sha256=95wxdEbopcMA6sB-Bqtzqj2GSRmVHJ4PqFZpF5UaiQU,125
+langchain/retrievers/self_query/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/retrievers/self_query/__pycache__/__init__.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/astradb.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/base.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/chroma.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/dashvector.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/deeplake.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/dingo.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/elasticsearch.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/milvus.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/mongodb_atlas.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/myscale.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/opensearch.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/pgvector.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/pinecone.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/qdrant.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/redis.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/supabase.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/tencentvectordb.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/timescalevector.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/vectara.cpython-311.pyc,,
+langchain/retrievers/self_query/__pycache__/weaviate.cpython-311.pyc,,
+langchain/retrievers/self_query/astradb.py,sha256=tTIrhpocDM7PgYo11Uxr8brx-n9GVO-IU4lcKG4-P8E,2194
+langchain/retrievers/self_query/base.py,sha256=jqg_x8Zz94vzhyf1SpmOAyeXUkSXIYHCDLseXP5JbAs,10865
+langchain/retrievers/self_query/chroma.py,sha256=vpb1wjmvbfUfICPKgvq3yIwY7LVdNl_NSLtB18zXvlY,1474
+langchain/retrievers/self_query/dashvector.py,sha256=g_Lx6m3n_eo-njdPGtWqkL2udDMtTphHSNJoFtu48MI,1918
+langchain/retrievers/self_query/deeplake.py,sha256=fwMrQ4KbOiItkqldpibllWmsaMbhV6soZfY1Oo6PEZQ,2631
+langchain/retrievers/self_query/dingo.py,sha256=V_bRij5O5cNd4iRQOZxCBsslDoQg_T2XlozKL6G5Cy4,1349
+langchain/retrievers/self_query/elasticsearch.py,sha256=KYL9XEqGPtifFTQ9ieywm66-PHJzA2VJ_MHSQb-XdVo,3273
+langchain/retrievers/self_query/milvus.py,sha256=K4q1RBBueY5I9v8ZEvRHIj5poP0ZWmOqJm1LbUPRyak,3352
+langchain/retrievers/self_query/mongodb_atlas.py,sha256=kQdSJFrcxpbRXuBTaf04gRoW9ePFyL9BTUfWpFwSTjY,2303
+langchain/retrievers/self_query/myscale.py,sha256=AgE9_KSWHmMqPnuOlNvzlyN0OP6su9aX4xpGS2CFM3Y,3636
+langchain/retrievers/self_query/opensearch.py,sha256=-ihgGy_SLZXCzCL5IVR-ROUu5fP2vd6owblUmM8mOEc,3271
+langchain/retrievers/self_query/pgvector.py,sha256=N-JDQQ81yN8fpma5YbvyQeybRu7nAiZm8nLG47LIldw,1529
+langchain/retrievers/self_query/pinecone.py,sha256=HmVifvXHppMBABTSjKOLwwvwKIzwqFJM8NjnPEaSQGs,1710
+langchain/retrievers/self_query/qdrant.py,sha256=sDPC7FNG72Co-y4Edngs7EWnwsC4VUeqlNz6Tsu9Ejk,3168
+langchain/retrievers/self_query/redis.py,sha256=KNuPyWXv8zcjQOTCMi5oRM3pqDBg2-J4LVTWtWagxXw,3376
+langchain/retrievers/self_query/supabase.py,sha256=xwKzUte7ZHBDyAQuucBlI_C6fr0ga7Y7ofjYW2mAe4U,2974
+langchain/retrievers/self_query/tencentvectordb.py,sha256=45aU4Bsi9XVgXpXpKBRF3HwYq_EiyfqUH38tTCigvHs,2875
+langchain/retrievers/self_query/timescalevector.py,sha256=ofQycIBrP8F-UZ6pm06L5NfxXv3hUkDTk9OnZ-Iwr64,2633
+langchain/retrievers/self_query/vectara.py,sha256=MKCGPdCTZMSFycFTtwZg9eI7aEECpK8UqojfGKcfolc,2164
+langchain/retrievers/self_query/weaviate.py,sha256=Sgmd3xUvG8bgr2-ZPfUmgZNcyYzI6XjIVruyHw-Ah2s,2619
+langchain/retrievers/svm.py,sha256=iUZPCWJDTGyak5GVZUr258yIzyisvgQZsV09oBwOHU8,88
+langchain/retrievers/tavily_search_api.py,sha256=kUqULTtrqs_HRnte1vaqJfkKhdFMdpiJ8U3mbqOhLN8,167
+langchain/retrievers/tfidf.py,sha256=pM_sZ7jha9c-U28SZYh8KAfqSsOqIkdkd0QT_j_bhK4,94
+langchain/retrievers/time_weighted_retriever.py,sha256=kGs4FwyQuZEjNTPVyrirFu_lTHp-ga0tEpH0Oi96fwA,7665
+langchain/retrievers/vespa_retriever.py,sha256=o6o13iCwJj3Ef9xkFnZ3nTcl1MY9DygLggZtremwA-E,104
+langchain/retrievers/weaviate_hybrid_search.py,sha256=MWEwK6vLnCmRiSnUTMMLAAOSV-CfYzp9T816Jymapts,150
+langchain/retrievers/web_research.py,sha256=4aoTB2122BSPdU3B2gX3TDj3jFZnDdwI6GdqIyhIpac,8197
+langchain/retrievers/wikipedia.py,sha256=t7KWBBZAw6j7P87vf_iYqsCltkarmAaLlhlz36qwems,106
+langchain/retrievers/you.py,sha256=od86qlBvvjw1T8Lel28IKuROEAiXjNKprvq4BWZncMI,88
+langchain/retrievers/zep.py,sha256=h9wUAahWFxlzMeEHMT4JzLlVgxog5sBloPUkWeSkYuE,142
+langchain/retrievers/zilliz.py,sha256=wNP-vr493o66ynVRllVGBHsOR-5jgjCNrXv_E0S0y6I,133
+langchain/runnables/__init__.py,sha256=_5XwnxKdD038iAev__Q7G36pVxXmIEFTY8y2MvjEDqk,693
+langchain/runnables/__pycache__/__init__.cpython-311.pyc,,
+langchain/runnables/__pycache__/hub.cpython-311.pyc,,
+langchain/runnables/__pycache__/openai_functions.cpython-311.pyc,,
+langchain/runnables/hub.py,sha256=EZZtbr7IROslFsyZoGQg7YvZUU7GX7iFWl6wkiaXVEI,809
+langchain/runnables/openai_functions.py,sha256=xJtav1oCqfxBADZXrLjQMB5DjN-NEh3NraICtrAbYhU,1525
+langchain/schema/__init__.py,sha256=xeGX7YHCoK6WRRMboRvwrM-7FBUx11aZFp1Ie4V3iPY,2065
+langchain/schema/__pycache__/__init__.cpython-311.pyc,,
+langchain/schema/__pycache__/agent.cpython-311.pyc,,
+langchain/schema/__pycache__/cache.cpython-311.pyc,,
+langchain/schema/__pycache__/chat.cpython-311.pyc,,
+langchain/schema/__pycache__/chat_history.cpython-311.pyc,,
+langchain/schema/__pycache__/document.cpython-311.pyc,,
+langchain/schema/__pycache__/embeddings.cpython-311.pyc,,
+langchain/schema/__pycache__/exceptions.cpython-311.pyc,,
+langchain/schema/__pycache__/language_model.cpython-311.pyc,,
+langchain/schema/__pycache__/memory.cpython-311.pyc,,
+langchain/schema/__pycache__/messages.cpython-311.pyc,,
+langchain/schema/__pycache__/output.cpython-311.pyc,,
+langchain/schema/__pycache__/output_parser.cpython-311.pyc,,
+langchain/schema/__pycache__/prompt.cpython-311.pyc,,
+langchain/schema/__pycache__/prompt_template.cpython-311.pyc,,
+langchain/schema/__pycache__/retriever.cpython-311.pyc,,
+langchain/schema/__pycache__/storage.cpython-311.pyc,,
+langchain/schema/__pycache__/vectorstore.cpython-311.pyc,,
+langchain/schema/agent.py,sha256=ziu7m5uOBKguXx1QwbElIqUEBdMnLQaFTYGw54N5g5U,149
+langchain/schema/cache.py,sha256=COiub2FmG_h_tW8Mwe9Amgyp0DKcuGPHIlCwrmjPrj0,105
+langchain/schema/callbacks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/schema/callbacks/__pycache__/__init__.cpython-311.pyc,,
+langchain/schema/callbacks/__pycache__/base.cpython-311.pyc,,
+langchain/schema/callbacks/__pycache__/manager.cpython-311.pyc,,
+langchain/schema/callbacks/__pycache__/stdout.cpython-311.pyc,,
+langchain/schema/callbacks/__pycache__/streaming_stdout.cpython-311.pyc,,
+langchain/schema/callbacks/base.py,sha256=3SiPT5ZfIVGKlYAFuQfQQ4PPv87oRq_CbsMSDjSjpBo,511
+langchain/schema/callbacks/manager.py,sha256=vvaqMDtG_kRuT9KNBLrchSNDTmdch8KiwMAJrqIi6Yc,1511
+langchain/schema/callbacks/stdout.py,sha256=9weMjKUjKSTcWmeb3Sb2KKblj7C0-QTa1SzUzRMbjw0,103
+langchain/schema/callbacks/streaming_stdout.py,sha256=URkFIyAS4V9HAiPQuiLgi5mGzBdVF5RfaRYQKhyChI0,131
+langchain/schema/callbacks/tracers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/schema/callbacks/tracers/__pycache__/__init__.cpython-311.pyc,,
+langchain/schema/callbacks/tracers/__pycache__/base.cpython-311.pyc,,
+langchain/schema/callbacks/tracers/__pycache__/evaluation.cpython-311.pyc,,
+langchain/schema/callbacks/tracers/__pycache__/langchain.cpython-311.pyc,,
+langchain/schema/callbacks/tracers/__pycache__/langchain_v1.cpython-311.pyc,,
+langchain/schema/callbacks/tracers/__pycache__/log_stream.cpython-311.pyc,,
+langchain/schema/callbacks/tracers/__pycache__/root_listeners.cpython-311.pyc,,
+langchain/schema/callbacks/tracers/__pycache__/run_collector.cpython-311.pyc,,
+langchain/schema/callbacks/tracers/__pycache__/schemas.cpython-311.pyc,,
+langchain/schema/callbacks/tracers/__pycache__/stdout.cpython-311.pyc,,
+langchain/schema/callbacks/tracers/base.py,sha256=6Y1iOQCE9K4fojdnyVIOEjZOMhBAgdSHRF2cXDmURWM,113
+langchain/schema/callbacks/tracers/evaluation.py,sha256=ZJItnN_hXGnVs1DIK4J9xG3EUWlt9iU9pKSJ60XpgDQ,176
+langchain/schema/callbacks/tracers/langchain.py,sha256=joRSY8NZPOUkq65sEZk8hyc_6adb_WJPWa2eu7aB9Ic,219
+langchain/schema/callbacks/tracers/langchain_v1.py,sha256=xSen-sx2Uc-URj4vTRpE5IsqaStG9WvsuRJZnLPQxfg,127
+langchain/schema/callbacks/tracers/log_stream.py,sha256=GOuTDkHx-uqD5wmu8KjgUXAoZ3LXEoeGw_FMa8ZvEhw,226
+langchain/schema/callbacks/tracers/root_listeners.py,sha256=z4sMzTA35qnAd5S5K19Fu-8rySYOIDnEgYf0SjoQhk0,105
+langchain/schema/callbacks/tracers/run_collector.py,sha256=xDu5e45bJW8PyGaFul9tenkbjZ__MtfR1FoqpqM-BsA,120
+langchain/schema/callbacks/tracers/schemas.py,sha256=WxTeFFvqKWh-Xvi6xCknVuLQ-q8C1nz4epc74RRnnoc,470
+langchain/schema/callbacks/tracers/stdout.py,sha256=heL8T5-kz279OVoG8pfULzYWwSt-OoYIUjrUqXpCCtc,257
+langchain/schema/chat.py,sha256=oTl-ap5KvXKSRrYXhZnqzcnR-tA2omq0tbnJXBcnO9k,80
+langchain/schema/chat_history.py,sha256=PApD2cIU2t6UZ5ohOic4fBZwY6HBwDQQbq9fageqkqA,101
+langchain/schema/document.py,sha256=TYs9k58mJo7DX-rf787JH9gcrm77oXtTbEcxbLuv3Ig,122
+langchain/schema/embeddings.py,sha256=WKl4o-zRuYGbD0AorklFp6ddCwtqRwp9xjpjaoouBRk,75
+langchain/schema/exceptions.py,sha256=ivVZKFnKg4U6LehuoCmZbbbLwDtRNIcrpmg0a0BZoOI,91
+langchain/schema/language_model.py,sha256=BZF1e7i8wX7ojubZRA2r4WCiBskxjFEfTUZazAFwDUI,367
+langchain/schema/memory.py,sha256=D12yH--Zf5AgvLCsCQNScHgNf1fL8ML_6_xH8InDX6k,71
+langchain/schema/messages.py,sha256=uhGY7Aug-qV-F45qaHj-_crr-S0hW_TCO7fiE-uGc6c,1048
+langchain/schema/output.py,sha256=bzzYNNH_uyYQg2pP82GneSbal2vFY-DOLajLF7kR-C4,320
+langchain/schema/output_parser.py,sha256=esyw2_45NzYaotHDtmZIO_teic_28vUzAKYD2Vl5wVc,651
+langchain/schema/prompt.py,sha256=L1eCkCkvv4IYcHKyTjU_BCDh1WKcKrNLhsisRG4OWQU,80
+langchain/schema/prompt_template.py,sha256=7xuYKspZuoR4VAIKUUHc10llvjmGoAhYjsusQbUNeJM,124
+langchain/schema/retriever.py,sha256=H5ejH7tVlF8Fq96LOY_dD0XUgXe_KlfcThFvFTL8H1o,81
+langchain/schema/runnable/__init__.py,sha256=aHkRXuLs61U32OLWDM8fofBDhWYh1tO32jyYEYtRi_Y,1796
+langchain/schema/runnable/__pycache__/__init__.cpython-311.pyc,,
+langchain/schema/runnable/__pycache__/base.cpython-311.pyc,,
+langchain/schema/runnable/__pycache__/branch.cpython-311.pyc,,
+langchain/schema/runnable/__pycache__/config.cpython-311.pyc,,
+langchain/schema/runnable/__pycache__/configurable.cpython-311.pyc,,
+langchain/schema/runnable/__pycache__/fallbacks.cpython-311.pyc,,
+langchain/schema/runnable/__pycache__/history.cpython-311.pyc,,
+langchain/schema/runnable/__pycache__/passthrough.cpython-311.pyc,,
+langchain/schema/runnable/__pycache__/retry.cpython-311.pyc,,
+langchain/schema/runnable/__pycache__/router.cpython-311.pyc,,
+langchain/schema/runnable/__pycache__/utils.cpython-311.pyc,,
+langchain/schema/runnable/base.py,sha256=6PP6QPWM7kV9tJjifbOcGu8bYmMQ2kl6dpbMq8dlbWA,781
+langchain/schema/runnable/branch.py,sha256=YvrdYOVJgi2bMXiNqiV2BBiuE-ySFVhQN02k9BdHAaM,89
+langchain/schema/runnable/config.py,sha256=5F1tZqL8SgkXl0BgZVBYsohAhfoSsoxp3DJZMjSd5cc,665
+langchain/schema/runnable/configurable.py,sha256=vSHtq-244VAnseY4z81d1dQGAu9kRzD2gkAYZHhrR_w,333
+langchain/schema/runnable/fallbacks.py,sha256=UK0bKO5yqc10zSZ2Cy4MJ8bs3TjHHY6-w7b5C9hPfQk,106
+langchain/schema/runnable/history.py,sha256=XFmbL4BDFnIbAkvPmeR40JjWoOIbuxZgJ67RZkoPdHU,260
+langchain/schema/runnable/passthrough.py,sha256=TQQX7Y7Sw4TlMac1cWEdtpcP0pb5VmNnSu39Ifu65DI,205
+langchain/schema/runnable/retry.py,sha256=nA5xkzD55UjsoooBmXsbQyq5XwS7Q-HRrZ6CD7SYSk8,94
+langchain/schema/runnable/router.py,sha256=hNTC-suV3N_iqZq1y6Wvo9j0PbDRRoTqfPnUUV0-9_0,117
+langchain/schema/runnable/utils.py,sha256=KDVyxVGynXVMJWKc89zw0_KoruWgZ47hpTSWfw92VQM,1118
+langchain/schema/storage.py,sha256=qHjS9oAC68daYtTS-bSzGrJUCin8BO46E92o8aN6c7U,85
+langchain/schema/vectorstore.py,sha256=S0l6WtBB7gNEQUnEsKhQzXNkjhow2lTx_p_OeJyNIJ8,137
+langchain/serpapi.py,sha256=jUvUNGNv3iTPqUCP33upHldzzf-Ns5aDBxecDz391uU,130
+langchain/smith/__init__.py,sha256=ZpitmOSZHp40ez19uSA_PpeGNoOFL-Nudxz-IqCxItg,3544
+langchain/smith/__pycache__/__init__.cpython-311.pyc,,
+langchain/smith/evaluation/__init__.py,sha256=gbQUAjH_9B3byjP2bUKGvif5IlxFlcbmvt7d1eFJSao,2199
+langchain/smith/evaluation/__pycache__/__init__.cpython-311.pyc,,
+langchain/smith/evaluation/__pycache__/config.cpython-311.pyc,,
+langchain/smith/evaluation/__pycache__/name_generation.cpython-311.pyc,,
+langchain/smith/evaluation/__pycache__/progress.cpython-311.pyc,,
+langchain/smith/evaluation/__pycache__/runner_utils.cpython-311.pyc,,
+langchain/smith/evaluation/__pycache__/string_run_evaluator.cpython-311.pyc,,
+langchain/smith/evaluation/__pycache__/utils.cpython-311.pyc,,
+langchain/smith/evaluation/config.py,sha256=Il8ywKNfW5-xStfiL_YWTO7_ZLQU6hPCd9-Tlf0NBMk,13429
+langchain/smith/evaluation/name_generation.py,sha256=IWocrWNjWnV8GhHJ7BrbGcWK1v9TUikzubpSBNz4Px4,9936
+langchain/smith/evaluation/progress.py,sha256=yFa-v03LPwk4UbZl3PcoO31hAJgORZ5luJ429isZDIA,3310
+langchain/smith/evaluation/runner_utils.py,sha256=Rljjb2QUrc4Py9OWB1b8uPsdjPb1q5HolbThavg98Vg,54127
+langchain/smith/evaluation/string_run_evaluator.py,sha256=A1sR_wlqVXlVAb2cTHGMMWxJl2rVOeZnFK1TpduYKiE,17107
+langchain/smith/evaluation/utils.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/sql_database.py,sha256=ptu6j0RCX42xYoIRGHuZSxKK7GAXwIc3WB3YUwIV2Tk,139
+langchain/storage/__init__.py,sha256=w7VFU5ucqCx5Zag99FJm_6OWlyIzpePY9GUtr3xVVuc,1571
+langchain/storage/__pycache__/__init__.cpython-311.pyc,,
+langchain/storage/__pycache__/_lc_store.cpython-311.pyc,,
+langchain/storage/__pycache__/encoder_backed.cpython-311.pyc,,
+langchain/storage/__pycache__/exceptions.cpython-311.pyc,,
+langchain/storage/__pycache__/file_system.cpython-311.pyc,,
+langchain/storage/__pycache__/in_memory.cpython-311.pyc,,
+langchain/storage/__pycache__/redis.cpython-311.pyc,,
+langchain/storage/__pycache__/upstash_redis.cpython-311.pyc,,
+langchain/storage/_lc_store.py,sha256=CxrIUMy_pgj-SYw9y5Kxd0XENylo4glOHOkXXD2kWvI,2517
+langchain/storage/encoder_backed.py,sha256=VtoRL-KxrfLEkpoj5HDt-bcgruxNUqqEFO0t7erO1PY,4333
+langchain/storage/exceptions.py,sha256=aE7R5wcCNJ0ccTljI1m2R8vVYp6GG5LnKYL9KQ247ig,106
+langchain/storage/file_system.py,sha256=jTXn1ilW0nEKdtEXjiURURt96QQZ_Xz6ZDM-54hmyLU,5516
+langchain/storage/in_memory.py,sha256=CV1ycYB6zYLC-ytT4l5q3aTJt-9Vw9JKz5wcI4K3PsY,4448
+langchain/storage/redis.py,sha256=eVj1CG_JMnceptEwuJnFYV-ghDyUpKKBu5U1J92CISA,83
+langchain/storage/upstash_redis.py,sha256=d35u62yfRJfkxbI_iX4DCZ3xbYIq_tPPgNSon_MNZ9M,166
+langchain/text_splitter.py,sha256=Xb0s1CaufdfvuMvoy9zdB6X-0lVmBYDOG47c1VHRRb8,1553
+langchain/tools/__init__.py,sha256=2EVo6o6je1FJCdRFaBGKR9DZKv8HksJE7JKuHp1teAM,5663
+langchain/tools/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/__pycache__/base.cpython-311.pyc,,
+langchain/tools/__pycache__/convert_to_openai.cpython-311.pyc,,
+langchain/tools/__pycache__/ifttt.cpython-311.pyc,,
+langchain/tools/__pycache__/plugin.cpython-311.pyc,,
+langchain/tools/__pycache__/render.cpython-311.pyc,,
+langchain/tools/__pycache__/retriever.cpython-311.pyc,,
+langchain/tools/__pycache__/yahoo_finance_news.cpython-311.pyc,,
+langchain/tools/ainetwork/__pycache__/app.cpython-311.pyc,,
+langchain/tools/ainetwork/__pycache__/base.cpython-311.pyc,,
+langchain/tools/ainetwork/__pycache__/owner.cpython-311.pyc,,
+langchain/tools/ainetwork/__pycache__/rule.cpython-311.pyc,,
+langchain/tools/ainetwork/__pycache__/transfer.cpython-311.pyc,,
+langchain/tools/ainetwork/__pycache__/value.cpython-311.pyc,,
+langchain/tools/ainetwork/app.py,sha256=UBLWfMmXkWJ6lBrUUrjl11iegQPwhST3EV0z2uaJ6JM,166
+langchain/tools/ainetwork/base.py,sha256=5EZZv0tb1npx577fCtbpyF9jVGN7o6kWGhGA5yLSjMM,124
+langchain/tools/ainetwork/owner.py,sha256=vplN0XZ8UwJEYaTOdnsSS2Gh3lmEqg2FXZW2X3lZW-k,119
+langchain/tools/ainetwork/rule.py,sha256=B6E66mj1C9uNVsLNoAw5qo1mr2LF3y4Jq8jV37G1Ghg,116
+langchain/tools/ainetwork/transfer.py,sha256=DNb5YTUfvCK8sCryUEU70StyRgR7UhwTWzrAyNtCkfc,130
+langchain/tools/ainetwork/value.py,sha256=vs1A36Bu6WswKLhoXu3DlBO0ZpZs635ED6UC5H_HwPM,121
+langchain/tools/amadeus/__init__.py,sha256=oCyY-VdpTaAVsYB2kN4UvaJamolHnlhosBDe3wt9GwA,257
+langchain/tools/amadeus/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/amadeus/__pycache__/base.cpython-311.pyc,,
+langchain/tools/amadeus/__pycache__/closest_airport.cpython-311.pyc,,
+langchain/tools/amadeus/__pycache__/flight_search.cpython-311.pyc,,
+langchain/tools/amadeus/base.py,sha256=NjA5RoDE1gX-iF5N1V5UCvkupN8LsJ_Y_4U0YWoSZqk,98
+langchain/tools/amadeus/closest_airport.py,sha256=0dT6KdbCCtwUS78YXznO37Q6y7ZOHdPjvumjeVRT0Ck,180
+langchain/tools/amadeus/flight_search.py,sha256=Z4tJV8fZN8dbYQdqWUnlB7ild4UDBD-nvLNPv_uZu80,170
+langchain/tools/arxiv/__init__.py,sha256=8i_5wwMXHX1BHQN7cDLCtqjYvN4_AxkAdwhNGgRmHtE,25
+langchain/tools/arxiv/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/arxiv/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/arxiv/tool.py,sha256=j_rjaEGM-tFTCPtyQk2h_pnSugUqfUcJL9GJgLPohec,118
+langchain/tools/azure_cognitive_services/__init__.py,sha256=vRoE4ioEcgnWzya8wPCAW296HiQS-PdRjas8L79pmlg,802
+langchain/tools/azure_cognitive_services/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/azure_cognitive_services/__pycache__/form_recognizer.cpython-311.pyc,,
+langchain/tools/azure_cognitive_services/__pycache__/image_analysis.cpython-311.pyc,,
+langchain/tools/azure_cognitive_services/__pycache__/speech2text.cpython-311.pyc,,
+langchain/tools/azure_cognitive_services/__pycache__/text2speech.cpython-311.pyc,,
+langchain/tools/azure_cognitive_services/__pycache__/text_analytics_health.cpython-311.pyc,,
+langchain/tools/azure_cognitive_services/form_recognizer.py,sha256=qoS1ae7x-57Ssz-KTN7Z5GsLU1SK3nFb3M-X93qJxFg,159
+langchain/tools/azure_cognitive_services/image_analysis.py,sha256=cI2T2p7IW_3tTCY3AJp4bMFsVDLK3nTcr9GxIgj67BM,156
+langchain/tools/azure_cognitive_services/speech2text.py,sha256=TCCnJrvno9jnZnvea2Fe0BCr1ytbjm6udLxBMNrR4zg,149
+langchain/tools/azure_cognitive_services/text2speech.py,sha256=9MhNkYSpn0Cc_SnG3HLZsKLuPA94aIPF74MB2sDxb60,149
+langchain/tools/azure_cognitive_services/text_analytics_health.py,sha256=Q3UbF1HTXC9ALnN-NxmXBQ2VSXVKUU-kHZea77uSF0M,175
+langchain/tools/base.py,sha256=yHaCAT9yFt3f8-bt4OATVpY0kIcrL3hyp9cHpItoE_4,332
+langchain/tools/bearly/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/tools/bearly/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/bearly/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/bearly/tool.py,sha256=emGaNdJv7Dgnq3s_-pdinUph4Qb3Jj2C-3s5e3RH-xM,229
+langchain/tools/bing_search/__init__.py,sha256=TrKKXeLieagRg0w09grJnRjPVVcb83DP44Bb6xot_CM,170
+langchain/tools/bing_search/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/bing_search/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/bing_search/tool.py,sha256=XyqWh_7tzoqgHyusjRUZQP1eW22bOKOr01Rqu7gckEs,138
+langchain/tools/brave_search/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/tools/brave_search/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/brave_search/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/brave_search/tool.py,sha256=fdu2OCjCej_av9wC8RkIqeDrp6AUj9l9WzDKe2Ln9cg,95
+langchain/tools/clickup/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/tools/clickup/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/clickup/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/clickup/tool.py,sha256=cUv2Rfwv0XUneZzKf1AlE0Tk7xcVTbTr5fB77lKonkg,94
+langchain/tools/convert_to_openai.py,sha256=Q5jmmrk6uOsBQktN_RKwft17WpCsa9MrA-sa0ZLdE2E,157
+langchain/tools/dataforseo_api_search/__init__.py,sha256=5lOqC2RP6PYUOn6VyW4LCUzh92Qj_kjaddUo7rxvTNM,268
+langchain/tools/dataforseo_api_search/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/dataforseo_api_search/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/dataforseo_api_search/tool.py,sha256=BapHJnfB4h3NP3wWSCstNVPvwbvs4iBzRH-wIyESdfA,197
+langchain/tools/ddg_search/__init__.py,sha256=Foj-IE35XDV4EpnDDYxIBiKjysvk_gSE-DoFWymxclY,147
+langchain/tools/ddg_search/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/ddg_search/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/ddg_search/tool.py,sha256=2pXbM8bc7FN0tLE-fPMZ1lOuLNUZsCxhd7CRDF1DVio,269
+langchain/tools/e2b_data_analysis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/tools/e2b_data_analysis/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/e2b_data_analysis/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/e2b_data_analysis/tool.py,sha256=YChH2C4NdhXpH88kCXq-FL8b90_7xosBMTi7m3bNL48,240
+langchain/tools/edenai/__init__.py,sha256=Ja01iGjJatsJxdmVKYrTUAzQ0FwG8iwZrp__foYGM8s,1024
+langchain/tools/edenai/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/edenai/__pycache__/audio_speech_to_text.cpython-311.pyc,,
+langchain/tools/edenai/__pycache__/audio_text_to_speech.cpython-311.pyc,,
+langchain/tools/edenai/__pycache__/edenai_base_tool.cpython-311.pyc,,
+langchain/tools/edenai/__pycache__/image_explicitcontent.cpython-311.pyc,,
+langchain/tools/edenai/__pycache__/image_objectdetection.cpython-311.pyc,,
+langchain/tools/edenai/__pycache__/ocr_identityparser.cpython-311.pyc,,
+langchain/tools/edenai/__pycache__/ocr_invoiceparser.cpython-311.pyc,,
+langchain/tools/edenai/__pycache__/text_moderation.cpython-311.pyc,,
+langchain/tools/edenai/audio_speech_to_text.py,sha256=KaY3pBBEhiyboZdbXH1xPAihHUQ_NiXTPyyM0uHCyeE,127
+langchain/tools/edenai/audio_text_to_speech.py,sha256=Y4pOiXYROBxXNqf3w40cne4KB8a1-QcZeP8WAxX-0ms,127
+langchain/tools/edenai/edenai_base_tool.py,sha256=H-lkZd50xEhTTRc0MBIP9CT8Eu2Ld8Ou4VFe7klno0c,99
+langchain/tools/edenai/image_explicitcontent.py,sha256=xtKyZnU_iQJEb035ydbyQE4mobFcNGXi-Cy5g7NByIk,139
+langchain/tools/edenai/image_objectdetection.py,sha256=0faUfIhf61zH5YET15QwzW_0U3R07YY9LZnX7UrwG44,143
+langchain/tools/edenai/ocr_identityparser.py,sha256=KwDx768qwM_4iqVR5juoA3fb7-lGW2scXcNJz0j1XtM,119
+langchain/tools/edenai/ocr_invoiceparser.py,sha256=iP5hD8eFFwnr-7J8BCmdlEHxR9sev1ytc5nDnwC9EZE,128
+langchain/tools/edenai/text_moderation.py,sha256=YMYdSWCJ3KHdG6iDZ9EYHwHP0AZLccpRtPTBEyWWxGg,126
+langchain/tools/eleven_labs/__init__.py,sha256=ZVMb18r014U4kKzrSDUWj9DFr2BbxxudjZ3sPT_sUtA,164
+langchain/tools/eleven_labs/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/eleven_labs/__pycache__/models.cpython-311.pyc,,
+langchain/tools/eleven_labs/__pycache__/text2speech.cpython-311.pyc,,
+langchain/tools/eleven_labs/models.py,sha256=c5x39ZfKhkcMzr21vk0bz93NPzHPARS_JN08esmSrUs,104
+langchain/tools/eleven_labs/text2speech.py,sha256=9Zw2tjPfPM8KZdnekV5MDaiGzEaMpDMEcsJRfbyBAuU,138
+langchain/tools/file_management/__init__.py,sha256=nQvziZtgKWL3GIdep-TO37d2rkL4Ipehf8RuaAEA8gc,723
+langchain/tools/file_management/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/file_management/__pycache__/copy.cpython-311.pyc,,
+langchain/tools/file_management/__pycache__/delete.cpython-311.pyc,,
+langchain/tools/file_management/__pycache__/file_search.cpython-311.pyc,,
+langchain/tools/file_management/__pycache__/list_dir.cpython-311.pyc,,
+langchain/tools/file_management/__pycache__/move.cpython-311.pyc,,
+langchain/tools/file_management/__pycache__/read.cpython-311.pyc,,
+langchain/tools/file_management/__pycache__/write.cpython-311.pyc,,
+langchain/tools/file_management/copy.py,sha256=lcRqrmdpJcFHrLwFh9JBdvhU4XBGrzzwq519LkktUFY,132
+langchain/tools/file_management/delete.py,sha256=mQj43KuqWZJ3sglaVR95pG66l4PnZJzlhXo3AXFBZco,155
+langchain/tools/file_management/file_search.py,sha256=T1J2knwXAt7SoLAeNKcb1ZARZFfQGEIsuyLJ20Fl8kw,160
+langchain/tools/file_management/list_dir.py,sha256=s45f2-fD9ek5oIImrIm-YpQtX6IB4kBDZn_7-97vyWo,175
+langchain/tools/file_management/move.py,sha256=59_BiDVa8oQRJYJhdwy_84nvno6z6rBDSIN0z7F2Sn4,132
+langchain/tools/file_management/read.py,sha256=nZIkbQxBXEha57AYfI8WnDexUmDf6XJZe8mZKkZyygI,132
+langchain/tools/file_management/write.py,sha256=FtOYbE9zOT3KJO500oCUq01rzBfaTydQ5k8DD_6YDPw,150
+langchain/tools/github/__init__.py,sha256=SzKhul90IpTDAtc3OdE92mQasahA0PqDSnc7j7B9ly0,20
+langchain/tools/github/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/github/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/github/tool.py,sha256=FyWL7N2pSPs7z5Q0vedtkHT5ytZ8Erp5b47fPUx89Hc,91
+langchain/tools/gitlab/__init__.py,sha256=rPY8UYi84KDzppleEwqUyaVRXySqrVWlb261ur_JjOM,20
+langchain/tools/gitlab/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/gitlab/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/gitlab/tool.py,sha256=eCsxPP7hrck_m9C3KEjS5rG6uXHL0cH8UOw62xCi1FM,91
+langchain/tools/gmail/__init__.py,sha256=p0u2UDN0jhdXYl-mPcIgefNxfXY4HFiYc1BJGp9WCSw,500
+langchain/tools/gmail/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/gmail/__pycache__/base.cpython-311.pyc,,
+langchain/tools/gmail/__pycache__/create_draft.cpython-311.pyc,,
+langchain/tools/gmail/__pycache__/get_message.cpython-311.pyc,,
+langchain/tools/gmail/__pycache__/get_thread.cpython-311.pyc,,
+langchain/tools/gmail/__pycache__/search.cpython-311.pyc,,
+langchain/tools/gmail/__pycache__/send_message.cpython-311.pyc,,
+langchain/tools/gmail/base.py,sha256=0vIGgNht-_JxCe4C73mE885fiwFerRJuZaOwoW__8es,92
+langchain/tools/gmail/create_draft.py,sha256=56CMNNVUu34HtBaF81Aa3doKLNsDZd2JGE5Y2olBkNs,159
+langchain/tools/gmail/get_message.py,sha256=luWeH8--2XlRiOGoS1t5DXy3Z5_YW87Ww2jMgXQsYRE,154
+langchain/tools/gmail/get_thread.py,sha256=Ccd4_tRnV812VhVB26ZcS5ZYqLBOBLuznjFU2nq6F6w,136
+langchain/tools/gmail/search.py,sha256=3J_FAYgH6epYHxBm4XdAtZIpT4DGPvE6yFG0JGA2GUU,167
+langchain/tools/gmail/send_message.py,sha256=VhUX5c7iI3IkqL7h1NW9kTMhV7T_Eq25SRZih6pGNZI,159
+langchain/tools/golden_query/__init__.py,sha256=Y04IRGEP6OvkEgswjEupKUkt6-JFuuej47kbnP0Wns8,136
+langchain/tools/golden_query/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/golden_query/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/golden_query/tool.py,sha256=CjMiRluJ164tBKEBm47Mc9b60FkrbQznvWQ8cFHLL2s,101
+langchain/tools/google_cloud/__init__.py,sha256=CaKO4qRuLzz4--tUQ-xNL_3JQcs0NhB6l-a4JtgCyTI,171
+langchain/tools/google_cloud/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/google_cloud/__pycache__/texttospeech.cpython-311.pyc,,
+langchain/tools/google_cloud/texttospeech.py,sha256=_P-dqKSYynPujSwR8U2uGrf1A3tVSwff5WiompLk5qc,151
+langchain/tools/google_finance/__init__.py,sha256=uK-k2yxn2OKULEBFgufDbs_56ryHJRq4-gG_iQ62C-4,152
+langchain/tools/google_finance/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/google_finance/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/google_finance/tool.py,sha256=QYIse_dGZeqa2aL5g-HTMGdEwZqpKppaAUysu39PZDY,117
+langchain/tools/google_jobs/__init__.py,sha256=dFNdE76BeJZ3SpCZu--sKU-GlFZVP9e10pQ__pxhH_k,140
+langchain/tools/google_jobs/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/google_jobs/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/google_jobs/tool.py,sha256=MI3wC3wZuSdO5NzIjYF2pSGcC5_d0xYLSHOsarIMkFQ,108
+langchain/tools/google_lens/__init__.py,sha256=8apk9RIaDwKrfObKYUpJr7cSASUiJBGSIu1JkCpHsWU,140
+langchain/tools/google_lens/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/google_lens/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/google_lens/tool.py,sha256=UaevnMrSMqa-BCgu_hEP3aE-ZuuS3fjGsr4f_GVjUqI,108
+langchain/tools/google_places/__init__.py,sha256=n5wwZvgpm7sohzv2hRRacS2d9vw_vwf2jOizLnpdvTc,140
+langchain/tools/google_places/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/google_places/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/google_places/tool.py,sha256=NhY4GOSypDtbrbzB0TjXmvUCfDEr9bAw9Ci1Koqzcg0,161
+langchain/tools/google_scholar/__init__.py,sha256=F7g-IX4a0sfQQZnyXkAsvGHlyhwit56TdxUQeGBBRQE,152
+langchain/tools/google_scholar/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/google_scholar/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/google_scholar/tool.py,sha256=cxpjvHYHQnKBT6ff7At5RbmyNV4SqzvUkb4a639O8jE,117
+langchain/tools/google_search/__init__.py,sha256=uLCt2uzM_rndct88evNdlXuaBJOeMqWn6F7ibrGVF9M,195
+langchain/tools/google_search/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/google_search/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/google_search/tool.py,sha256=sr1_R1gAMXeTkpFiv19iQOEuOzRiGjOFNp5zRXjVqG0,161
+langchain/tools/google_serper/__init__.py,sha256=hOe3l5NFDTBGh8kqeUhjq0BhHJMeWv8V0C4dBNGHsWw,243
+langchain/tools/google_serper/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/google_serper/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/google_serper/tool.py,sha256=fXZXf6bE1QpKk88Z86LNO9H_Sc7oNW7cyHJ6lTBulIY,161
+langchain/tools/google_trends/__init__.py,sha256=Lwn7fs35f2twAs1U-GppbqGqtGLibu5n3bnd9CblDUg,148
+langchain/tools/google_trends/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/google_trends/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/google_trends/tool.py,sha256=NMzH14AgYZaN2hMV_X5mR6yMSJLjL0douPp4ybtmwdg,114
+langchain/tools/graphql/__init__.py,sha256=5WzEFZc0S0sh1mn6kciABqotz0Zf1fftuwJ6XTs5LgU,47
+langchain/tools/graphql/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/graphql/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/graphql/tool.py,sha256=88Ib8jjhUu6vHC7-pCKxV7lhHmpPx8O1fNJi67GBLEo,98
+langchain/tools/human/__init__.py,sha256=96BPmcHUQOeclH24p3y5ZMHqsyYSnnEmObFFhTTkOFM,132
+langchain/tools/human/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/human/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/human/tool.py,sha256=SO9fUqAV_g_kj5_2NwXA8WhFM1M_AszE6UChyATzqs0,92
+langchain/tools/ifttt.py,sha256=4fJ_dUeD2rGOso8cpoi5zVZGa9Y0H0X_IOt9OeEWRJI,85
+langchain/tools/interaction/__init__.py,sha256=RYCJKa2M7CrzMbz59xYFJ_c3hwGJKOPyyP4G_sAt48w,43
+langchain/tools/interaction/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/interaction/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/interaction/tool.py,sha256=y7MOvH3C0xqJgCfXgTHyTKLjOELerdsvZxOVkQbQqos,104
+langchain/tools/jira/__init__.py,sha256=Zz6Gy5kGFFIfVAnG0a6c4ovi5XM9KZheGKaZ_fFbmGY,17
+langchain/tools/jira/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/jira/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/jira/tool.py,sha256=4rRMBgqZiJ_X4XIx6p0adPnqyKzWeJOTy5b0BG9q2dY,85
+langchain/tools/json/__init__.py,sha256=ieEWuRmzcehYXhGc-KcC6z1Lhbbn_nBEyMtnE04vyFU,46
+langchain/tools/json/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/json/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/json/tool.py,sha256=lVacsJYkE-3GcK9KUKtIVlJT8Guf7dBeu18fquBVrH8,174
+langchain/tools/memorize/__init__.py,sha256=Iv2FZHKB8eNuMKKjv873n1qDSQxUJxnkLA01z40aKv0,134
+langchain/tools/memorize/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/memorize/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/memorize/tool.py,sha256=1ecE60InzMKGUYttn-wKuvtUOR3aIKqyKaGQgsFawHo,115
+langchain/tools/merriam_webster/__init__.py,sha256=6n0Uz-TRpAh6M7LMI_p6_qa1c-4vT2kEvU3nDgxzr1Q,35
+langchain/tools/merriam_webster/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/merriam_webster/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/merriam_webster/tool.py,sha256=TBPErC78-22oRLbimrK72rCYKYZTBwGY022mSjNlHjY,120
+langchain/tools/metaphor_search/__init__.py,sha256=ORai2wY3PgqxgWPGpQA4ztTNu0iJ2kohn9H55zceHCA,154
+langchain/tools/metaphor_search/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/metaphor_search/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/metaphor_search/tool.py,sha256=Cl63hjytQdQDYYQhKnOAo7WETj5n9RX8vbeD2492Ga4,118
+langchain/tools/multion/__init__.py,sha256=uFsgWNkKrJ8jjafA2elIDu1gEjS7lijbn88nHwtga9E,359
+langchain/tools/multion/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/multion/__pycache__/close_session.cpython-311.pyc,,
+langchain/tools/multion/__pycache__/create_session.cpython-311.pyc,,
+langchain/tools/multion/__pycache__/update_session.cpython-311.pyc,,
+langchain/tools/multion/close_session.py,sha256=ryekwXvITh7-5J1JokmosxC72RvnvhTIVpA33AxOiA0,170
+langchain/tools/multion/create_session.py,sha256=2-JGk7p5yMeYvoQ1xTJzoQ2ZLEjDmxL8nqrtbuFRk-E,175
+langchain/tools/multion/update_session.py,sha256=53JruhR3Dk4FxjUKi4mJ933u1Dr1S2vGX4AWg8P4Ep8,175
+langchain/tools/nasa/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/tools/nasa/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/nasa/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/nasa/tool.py,sha256=yA6JGQk9Fm_6okA-NpQxwqokL933iELglsq6HSZn1Vc,85
+langchain/tools/nuclia/__init__.py,sha256=BiP6ptCcnJjViD2pSOSj3LVlP7vsbz5FIjYQwNRcFjo,111
+langchain/tools/nuclia/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/nuclia/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/nuclia/tool.py,sha256=DISf3SZCC5p8YFNAxBGFEtT5q5tdPbRU_IWPhTeB9jY,135
+langchain/tools/office365/__init__.py,sha256=vKlDtqgLcZeDzDoDci1zxXUfc46RYjn3ZD_xfhNDQp4,567
+langchain/tools/office365/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/office365/__pycache__/base.cpython-311.pyc,,
+langchain/tools/office365/__pycache__/create_draft_message.cpython-311.pyc,,
+langchain/tools/office365/__pycache__/events_search.cpython-311.pyc,,
+langchain/tools/office365/__pycache__/messages_search.cpython-311.pyc,,
+langchain/tools/office365/__pycache__/send_event.cpython-311.pyc,,
+langchain/tools/office365/__pycache__/send_message.cpython-311.pyc,,
+langchain/tools/office365/base.py,sha256=t6W4QHwWnohJSnphAua4K_1zpRJBu5lAGokGbtH7d4w,94
+langchain/tools/office365/create_draft_message.py,sha256=uZzvMO0rSWw5Gl8UqB3eTWaA1a469EVGr99ZFbw6GBI,197
+langchain/tools/office365/events_search.py,sha256=EVErM6itlyDC3mbM9bRvStoLSiMdbl5TuN8wMu-B3H4,164
+langchain/tools/office365/messages_search.py,sha256=dHy8p_28V2tK9S_G1f1DRlJmq8xrIMBSdtim3DRJ35Q,166
+langchain/tools/office365/send_event.py,sha256=6sNoOUDcqS2PTb4Q6srTOupY27YqaOBD8LWMBM14rv4,151
+langchain/tools/office365/send_message.py,sha256=ZzkStaqu-ZZOPucPDXGWYXE9mopDyA5hCs-haV-_nPo,161
+langchain/tools/openapi/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/tools/openapi/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/openapi/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/tools/openapi/utils/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/openapi/utils/__pycache__/api_models.cpython-311.pyc,,
+langchain/tools/openapi/utils/__pycache__/openapi_utils.cpython-311.pyc,,
+langchain/tools/openapi/utils/api_models.py,sha256=zd840L_UvAIrheCssQWJkTdGLyq7egGPkTU6nEZx3VQ,542
+langchain/tools/openapi/utils/openapi_utils.py,sha256=T9BQI9gbaoryA7YPoqx7oGCTwmGgHYd7WqD_cskIHw8,191
+langchain/tools/openweathermap/__init__.py,sha256=ulwCVk_Uw3y9eyZFyJtzYUTUA5l0XYRF1CKEYPgRN38,162
+langchain/tools/openweathermap/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/openweathermap/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/openweathermap/tool.py,sha256=s1-VcnYJ0V1ATxCqpwa-X0D0fyvRLw108BAagSr3UgI,119
+langchain/tools/playwright/__init__.py,sha256=pBSkDs07eYOMuQPT9RKq66XoPzeoRpzB_r7PmuyAgFg,763
+langchain/tools/playwright/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/playwright/__pycache__/base.cpython-311.pyc,,
+langchain/tools/playwright/__pycache__/click.cpython-311.pyc,,
+langchain/tools/playwright/__pycache__/current_page.cpython-311.pyc,,
+langchain/tools/playwright/__pycache__/extract_hyperlinks.cpython-311.pyc,,
+langchain/tools/playwright/__pycache__/extract_text.cpython-311.pyc,,
+langchain/tools/playwright/__pycache__/get_elements.cpython-311.pyc,,
+langchain/tools/playwright/__pycache__/navigate.cpython-311.pyc,,
+langchain/tools/playwright/__pycache__/navigate_back.cpython-311.pyc,,
+langchain/tools/playwright/base.py,sha256=MgSCJvFEm3zknBm26TqH3-SR7VLVDiev4CJnPcZQ2vQ,110
+langchain/tools/playwright/click.py,sha256=7TgHCeB7pwr-HhViCOdg68w9zjP9FhSIf_xjBsmJ634,124
+langchain/tools/playwright/current_page.py,sha256=wAtpHG9Me_D9ECYQsk44pG3FQaX9VVU0DzLL19TID6c,115
+langchain/tools/playwright/extract_hyperlinks.py,sha256=lZr-gHo1RiyvIXYGZhLLRy6JoWKpSt3MJZV2E2nNr3I,198
+langchain/tools/playwright/extract_text.py,sha256=r36Y8-EOPF34Lt1JyQZF0VZaVNGjFGF5lCKmZUc9XPs,109
+langchain/tools/playwright/get_elements.py,sha256=OKJXpKzovCF0h-yL5qgeCUYTBQ2cbFnG0LLexqViBRc,168
+langchain/tools/playwright/navigate.py,sha256=M6g2vHEo2F3i1jh-Oxy4A9hJ-qSe_LBr6IKPhtVkJt0,152
+langchain/tools/playwright/navigate_back.py,sha256=MBhOaJ092AFOLUI0Xv3T5Ni46zS-tnvOb25OsbRMiWM,112
+langchain/tools/plugin.py,sha256=NOGMubopnNx2TUKZC0auzYnXbr5-UXeUT4uKU_3gEwQ,214
+langchain/tools/powerbi/__init__.py,sha256=lFy__65sASd5e8Eac1E1RHN58uTVSOMprb88zClyEZU,52
+langchain/tools/powerbi/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/powerbi/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/powerbi/tool.py,sha256=TVCDoP37me46VkFHmfLCtYt82SaOuJ88Okv0mGcpoJQ,189
+langchain/tools/pubmed/__init__.py,sha256=KdYkXaHkUWLyuY35F0HRoZlX6PtTuTCPCYqlkgmBUgY,26
+langchain/tools/pubmed/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/pubmed/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/pubmed/tool.py,sha256=YmbB9T61cP8xuApNXiluNfET8yzytqH6C7cwGLpw09Y,95
+langchain/tools/python/__init__.py,sha256=I1_8ztkE3N2iq6h9hdWTw1QMTMJhGmrHjPJo46fh-eU,512
+langchain/tools/python/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/reddit_search/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/tools/reddit_search/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/reddit_search/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/reddit_search/tool.py,sha256=wpnGIuBOOw2o7jDCrV-WjB6h4o649NYfw0s-499Dkkc,159
+langchain/tools/render.py,sha256=MAhsDFrBkrCbpQyMdbNwNIbe9faH5K9PyEE7WjZfnME,1662
+langchain/tools/requests/__init__.py,sha256=oeutQGdlOp3p6PbcAAfjdYpftaXFmJYJgSWw5SGb6IM,52
+langchain/tools/requests/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/requests/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/requests/tool.py,sha256=WBq89BGe8GIqhz0OcqDvtYrw6_wQLT4SpRT_nwTRSRc,349
+langchain/tools/retriever.py,sha256=2A1gaC_2fZNCI73qOiJkpUQ6h8jpz2pydwD3Y49ZVaU,2542
+langchain/tools/scenexplain/__init__.py,sha256=rRP3hoEnMUUHwABFgXFLGCJkoQi4lyg585ONrgWis3k,31
+langchain/tools/scenexplain/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/scenexplain/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/scenexplain/tool.py,sha256=SkYo-u-feZIlSLGZlsvctKJ6QbC1iScz4bsmH25Vie0,140
+langchain/tools/searchapi/__init__.py,sha256=Uw8Un5_BMfEWxPFWplTf5qjWlRhQaB7u5uQk8r4LJZA,214
+langchain/tools/searchapi/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/searchapi/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/searchapi/tool.py,sha256=RBgLnn8TbY_yoUZgonnUWa-SFl-HpxBn_8SDtJHGJpw,132
+langchain/tools/searx_search/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/tools/searx_search/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/searx_search/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/searx_search/tool.py,sha256=EKfi5314PBFxQfQxL7C1ZtBmq6yL5emA-baaOSdFy0s,156
+langchain/tools/shell/__init__.py,sha256=0na3xEyP8QPmMn3n04761kvzAiq7ikfE8FoAO8dZDzc,103
+langchain/tools/shell/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/shell/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/shell/tool.py,sha256=DO5VUDXi68NOnNVWwbJQ4y51glcSvZQ2xjHZFbbTJKI,123
+langchain/tools/slack/__init__.py,sha256=-Z3TmdkV_QNOX8NmfjT_KfzXHDj5uYikPJxSprEf4Dc,433
+langchain/tools/slack/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/slack/__pycache__/base.cpython-311.pyc,,
+langchain/tools/slack/__pycache__/get_channel.cpython-311.pyc,,
+langchain/tools/slack/__pycache__/get_message.cpython-311.pyc,,
+langchain/tools/slack/__pycache__/schedule_message.cpython-311.pyc,,
+langchain/tools/slack/__pycache__/send_message.cpython-311.pyc,,
+langchain/tools/slack/base.py,sha256=cUK9FFKfnsha3kO95bWUJjKvIWpwEasbZohydeluuz4,92
+langchain/tools/slack/get_channel.py,sha256=4dS89P8uGOF6M4dK4DFhOTeIBbLDx7tUPoOufGL38Bk,103
+langchain/tools/slack/get_message.py,sha256=Pej-v_RFl2dZ6KnypxHF_azEjrPBywnU4dqJcZPY828,164
+langchain/tools/slack/schedule_message.py,sha256=hzmRe_fj4GMLEeputvB6OwWDZv2mEIreRQzkq_nUNE8,179
+langchain/tools/slack/send_message.py,sha256=IaJ5vl87XHtHHsW3lW8XmK0DsW98UfhyMZ9sQq5Np7k,159
+langchain/tools/sleep/__init__.py,sha256=O3fn_ASDE-eDcU3FsBaPTmLHV75hhMS4c6v2qzrak5E,18
+langchain/tools/sleep/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/sleep/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/sleep/tool.py,sha256=WIrPxF5OLpJn8LaxjJaRDGdQ0JjFp-3abKyNHsevAng,110
+langchain/tools/spark_sql/__init__.py,sha256=HDxRN6dODaOCPByAO48uZz3GbVZd49fE905zLArXCMA,44
+langchain/tools/spark_sql/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/spark_sql/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/spark_sql/tool.py,sha256=XdnQ7N9R-QlvNt6h616G4iDa2pz71C3DFJ0GW1M__T0,304
+langchain/tools/sql_database/__init__.py,sha256=Z7WNXu1y5-DhuoeA_Ync-Zcg3uK1lhdfQOlKBWAifmo,49
+langchain/tools/sql_database/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/sql_database/__pycache__/prompt.cpython-311.pyc,,
+langchain/tools/sql_database/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/sql_database/prompt.py,sha256=lenmC8B5E9td_4sumWUafFhuube-HWqolKedzAlyE60,101
+langchain/tools/sql_database/tool.py,sha256=fh8maGezhXXBJPdUlJEIZG-HffLj5folkQPpSZ7mrHM,337
+langchain/tools/stackexchange/__init__.py,sha256=dLGMnzEmyYZGoPsv215mPeqAU03McJJ_2WGkIioj3yY,33
+langchain/tools/stackexchange/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/stackexchange/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/stackexchange/tool.py,sha256=npSj0kURIRkxkgbXNrRzDc73WMXOurm4YlcqDrahKOA,108
+langchain/tools/steam/__init__.py,sha256=_hg6uHJlBNJnCFPctYr80psy7o2hRsuzemhtPYHLENA,24
+langchain/tools/steam/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/steam/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/steam/tool.py,sha256=DXpre7aQgKuZa6UTb9DpGiz5xINRMtYZKap8moI1alA,104
+langchain/tools/steamship_image_generation/__init__.py,sha256=1abTK0waz1F1auwU1YEwbluHBSfgmcR44XBeN-SIkwI,186
+langchain/tools/steamship_image_generation/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/steamship_image_generation/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/steamship_image_generation/tool.py,sha256=X3jVv2MPl7t3v2WSomikc__-KGeR5ir-dEyqFCB5MGg,180
+langchain/tools/tavily_search/__init__.py,sha256=SCJ7BPxCZfiYXYcE0FCPPpq-_WAoZWjBI2nVoJ7MRCw,189
+langchain/tools/tavily_search/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/tavily_search/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/tavily_search/tool.py,sha256=hAKnLDs-JHsFo06jW9SdSdha1mgK9Jjbpjpc1sOZu40,187
+langchain/tools/vectorstore/__init__.py,sha256=kheVdgDafCJHOhU5D5SBZZg9x_j5_gveZHqVhZ0pSZ8,51
+langchain/tools/vectorstore/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/vectorstore/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/vectorstore/tool.py,sha256=G3ZGOw-jLkpj5CrrgByJr2YSZFTt81YW-PFJmvNkcvA,192
+langchain/tools/wikipedia/__init__.py,sha256=h-dMgHpibxNGwmU14vNzpEMhy7TuFPUP_d4GYXzMZZ4,29
+langchain/tools/wikipedia/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/wikipedia/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/wikipedia/tool.py,sha256=WjP_GEsHUMiqXhUxiTajXB1g99GoOBICsMVp2qJrB-s,104
+langchain/tools/wolfram_alpha/__init__.py,sha256=7qUemdGFGdV1MzNZiVVQDJQRZ7bkutn9h5tTrRuZttA,156
+langchain/tools/wolfram_alpha/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/wolfram_alpha/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/wolfram_alpha/tool.py,sha256=Uxa9eWZmMswj5lB3SM9CQUov3bF6FnP_bAONXvbz8nw,114
+langchain/tools/yahoo_finance_news.py,sha256=r1T70y40WmY67Mq2t1PbK7AN10HgmfwlNWD_11w0-i8,114
+langchain/tools/youtube/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/tools/youtube/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/youtube/__pycache__/search.cpython-311.pyc,,
+langchain/tools/youtube/search.py,sha256=4mYwsodk-x9EInBs88eYISEOXjdvfstzciqRG5QJM58,104
+langchain/tools/zapier/__init__.py,sha256=1HpJsHgUIW2E38zayYvNCJnRez-W3wyrD5mRNYkHZBo,193
+langchain/tools/zapier/__pycache__/__init__.cpython-311.pyc,,
+langchain/tools/zapier/__pycache__/tool.cpython-311.pyc,,
+langchain/tools/zapier/tool.py,sha256=9whSHBJozWVKqT9WLFlgfsew8m6etLsqwfJWioLYpeA,162
+langchain/utilities/__init__.py,sha256=CYg1CemXkCXW6oPazwlcQU6DblIARC-vWdH7ty_6VIU,2327
+langchain/utilities/__pycache__/__init__.cpython-311.pyc,,
+langchain/utilities/__pycache__/alpha_vantage.cpython-311.pyc,,
+langchain/utilities/__pycache__/anthropic.cpython-311.pyc,,
+langchain/utilities/__pycache__/apify.cpython-311.pyc,,
+langchain/utilities/__pycache__/arcee.cpython-311.pyc,,
+langchain/utilities/__pycache__/arxiv.cpython-311.pyc,,
+langchain/utilities/__pycache__/asyncio.cpython-311.pyc,,
+langchain/utilities/__pycache__/awslambda.cpython-311.pyc,,
+langchain/utilities/__pycache__/bibtex.cpython-311.pyc,,
+langchain/utilities/__pycache__/bing_search.cpython-311.pyc,,
+langchain/utilities/__pycache__/brave_search.cpython-311.pyc,,
+langchain/utilities/__pycache__/clickup.cpython-311.pyc,,
+langchain/utilities/__pycache__/dalle_image_generator.cpython-311.pyc,,
+langchain/utilities/__pycache__/dataforseo_api_search.cpython-311.pyc,,
+langchain/utilities/__pycache__/duckduckgo_search.cpython-311.pyc,,
+langchain/utilities/__pycache__/github.cpython-311.pyc,,
+langchain/utilities/__pycache__/gitlab.cpython-311.pyc,,
+langchain/utilities/__pycache__/golden_query.cpython-311.pyc,,
+langchain/utilities/__pycache__/google_finance.cpython-311.pyc,,
+langchain/utilities/__pycache__/google_jobs.cpython-311.pyc,,
+langchain/utilities/__pycache__/google_lens.cpython-311.pyc,,
+langchain/utilities/__pycache__/google_places_api.cpython-311.pyc,,
+langchain/utilities/__pycache__/google_scholar.cpython-311.pyc,,
+langchain/utilities/__pycache__/google_search.cpython-311.pyc,,
+langchain/utilities/__pycache__/google_serper.cpython-311.pyc,,
+langchain/utilities/__pycache__/google_trends.cpython-311.pyc,,
+langchain/utilities/__pycache__/graphql.cpython-311.pyc,,
+langchain/utilities/__pycache__/jira.cpython-311.pyc,,
+langchain/utilities/__pycache__/loading.cpython-311.pyc,,
+langchain/utilities/__pycache__/max_compute.cpython-311.pyc,,
+langchain/utilities/__pycache__/merriam_webster.cpython-311.pyc,,
+langchain/utilities/__pycache__/metaphor_search.cpython-311.pyc,,
+langchain/utilities/__pycache__/nasa.cpython-311.pyc,,
+langchain/utilities/__pycache__/opaqueprompts.cpython-311.pyc,,
+langchain/utilities/__pycache__/openapi.cpython-311.pyc,,
+langchain/utilities/__pycache__/openweathermap.cpython-311.pyc,,
+langchain/utilities/__pycache__/outline.cpython-311.pyc,,
+langchain/utilities/__pycache__/portkey.cpython-311.pyc,,
+langchain/utilities/__pycache__/powerbi.cpython-311.pyc,,
+langchain/utilities/__pycache__/pubmed.cpython-311.pyc,,
+langchain/utilities/__pycache__/python.cpython-311.pyc,,
+langchain/utilities/__pycache__/reddit_search.cpython-311.pyc,,
+langchain/utilities/__pycache__/redis.cpython-311.pyc,,
+langchain/utilities/__pycache__/requests.cpython-311.pyc,,
+langchain/utilities/__pycache__/scenexplain.cpython-311.pyc,,
+langchain/utilities/__pycache__/searchapi.cpython-311.pyc,,
+langchain/utilities/__pycache__/searx_search.cpython-311.pyc,,
+langchain/utilities/__pycache__/serpapi.cpython-311.pyc,,
+langchain/utilities/__pycache__/spark_sql.cpython-311.pyc,,
+langchain/utilities/__pycache__/sql_database.cpython-311.pyc,,
+langchain/utilities/__pycache__/stackexchange.cpython-311.pyc,,
+langchain/utilities/__pycache__/steam.cpython-311.pyc,,
+langchain/utilities/__pycache__/tavily_search.cpython-311.pyc,,
+langchain/utilities/__pycache__/tensorflow_datasets.cpython-311.pyc,,
+langchain/utilities/__pycache__/twilio.cpython-311.pyc,,
+langchain/utilities/__pycache__/vertexai.cpython-311.pyc,,
+langchain/utilities/__pycache__/wikipedia.cpython-311.pyc,,
+langchain/utilities/__pycache__/wolfram_alpha.cpython-311.pyc,,
+langchain/utilities/__pycache__/zapier.cpython-311.pyc,,
+langchain/utilities/alpha_vantage.py,sha256=DDo_FtrZ8s1tb1EOj32KQx6sK8UdmLKTALq5J8E4_cQ,117
+langchain/utilities/anthropic.py,sha256=c00K6WCYb2oJej-2rSFSlng0N5FDCIhMBH2w52tnnXs,193
+langchain/utilities/apify.py,sha256=7B2fZdKCiQ87FgPCoG-stbXMA_897EikrrgxlALwR1o,89
+langchain/utilities/arcee.py,sha256=Cznc7XFW_I6DDWJwHvbTk_mQ_DebsENbHbVhLpXzblk,361
+langchain/utilities/arxiv.py,sha256=_sbvPG386HPEVcKkIaIE076Lypap9jLZ86Lk00b3xVg,95
+langchain/utilities/asyncio.py,sha256=1V67tgNokxxNYRrsHgog1YPFq4hHubMrZF3u7WcxiIc,274
+langchain/utilities/awslambda.py,sha256=_YC3l4NWwmxNKM4Mq2meqaAFQekwIwr7WzUnpNNu55Y,95
+langchain/utilities/bibtex.py,sha256=ej9B8PnVXMGCsN6AjuYs23z7vmvmK48pYI5qQS3yqJI,104
+langchain/utilities/bing_search.py,sha256=ujCj6lisjeQ06265_TcFYU2x2LmLvw662VyTPyQMq8o,111
+langchain/utilities/brave_search.py,sha256=9sjS3mngWZSU_8hXWQMjJ8_Ypoh2WGTZDWSRkoUXVow,108
+langchain/utilities/clickup.py,sha256=VJS_WR1Jpkj26mGb7XJbkOrPX-nkdHWG7wD1yNhrM8M,269
+langchain/utilities/dalle_image_generator.py,sha256=qGFnFm5M7GYfFsES8ytb0KpI0_GwV19Zv963N_zDWkU,111
+langchain/utilities/dataforseo_api_search.py,sha256=43Ir_X0fVfijoye4EdHrbf4Q-4sCBWi_sZiiYT1nfZA,121
+langchain/utilities/duckduckgo_search.py,sha256=w7xjwqKwQoWQ2gi6ELWy7SR67ei3S2J9Vb_GFSI40cY,129
+langchain/utilities/github.py,sha256=4A41JIl_TAVOKxw-OmJMIgesJYmZIcVS-wG1jzAkUE4,98
+langchain/utilities/gitlab.py,sha256=PQi3dg8ho_v3GcDrOJdnV8mwQg9MhTxybrvQJa-C8RM,98
+langchain/utilities/golden_query.py,sha256=_wM8zCujzyFlh9-KKMYtXnHbvBOMvW1gI6PjGMdZ1uc,123
+langchain/utilities/google_finance.py,sha256=kSw5QwVvCDkbH9EJyYt4ywK998EuXz2peJyV4BscPUU,120
+langchain/utilities/google_jobs.py,sha256=qEKxTbysbtlFYIGqqlmjgGqtKiMxBR4mr3Ckgb0IxBA,111
+langchain/utilities/google_lens.py,sha256=ZcK1eZNWPZG7MnCupqLKimI3bl0yS_BV7DvzlXqbRqo,111
+langchain/utilities/google_places_api.py,sha256=wNxdJ4BuKrqE46eBoCuZbX-vg82tzuAtTsntaW7Is58,121
+langchain/utilities/google_scholar.py,sha256=Dfg6-21NUr2vh-JiNCKIFInQRdFy8a_ojJYE4qlZTOk,120
+langchain/utilities/google_search.py,sha256=axjs2yZtN3_npd9urO5vHPVrBP7GMo-PMZevdK_d5sM,117
+langchain/utilities/google_serper.py,sha256=Ll-vx7SMRXxSKjTuO35_2NXMQ3e7UB284figUBiB4w0,117
+langchain/utilities/google_trends.py,sha256=o9vSyvhLYRGc-zPmmcJuEnPxiIoNfZEQaY809aVPtvo,117
+langchain/utilities/graphql.py,sha256=9VL1G0MKBxzmqb0THjTwuv5MeRAyqluxPWPsjLhhM9s,101
+langchain/utilities/jira.py,sha256=Pz-C5gcxDdXgeR4hYRaAkGE70jUz1RRYPidfb0Yj_FA,92
+langchain/utilities/loading.py,sha256=4QtpLz_q9F_fijDtgcez3m8N0AQb2pcnVF8N4lfUWTA,122
+langchain/utilities/max_compute.py,sha256=Oj721vmxE8fvjkjz-2tcXkJSREq9Ngs-Roi8DY9Zf0E,111
+langchain/utilities/merriam_webster.py,sha256=bgXmB-67l07gc5lDeROzUc0kiTg66ehp5kPYj01zFoM,139
+langchain/utilities/metaphor_search.py,sha256=XNJbGQcMB8kan4AvGdi5RaTuX64XUjRhn0NjgN7DPFQ,132
+langchain/utilities/nasa.py,sha256=Bd70CBqlwmOu3ReKvQQyFfAz0GuQnf8Zg2dVWV9uGCI,101
+langchain/utilities/opaqueprompts.py,sha256=_ypq4vMarkDBM3jTkNlk6NO2W0u8ciDAYefquONFh3A,115
+langchain/utilities/openapi.py,sha256=7N_tjC-d3JfX5nIejCYSBH_pjOdYGDadfyqoEwAiFnc,111
+langchain/utilities/openweathermap.py,sha256=km1Y0FoAvFRJAIcwn3dtH-5dLiMN-MAkysApByYZFSo,122
+langchain/utilities/outline.py,sha256=0JFvOTXcv9w3PJPRnXTV2yu4owxYca5IIREIFLkZJ0E,110
+langchain/utilities/portkey.py,sha256=b7aDqeFlZZ7zKbf5m2vAyj-2kYylxLbZr9dID-CXIUw,81
+langchain/utilities/powerbi.py,sha256=IZde8UoXDsOcQNKprdYs8GXmiRtVp8kpWFYSFpDtzi0,111
+langchain/utilities/pubmed.py,sha256=iWv5q1pfe8G_B_ubAIxhd1f0K1OCR_4YcR4YZuTlaFU,98
+langchain/utilities/python.py,sha256=-H8-vQb6spkSvaU2Hofg8HuXgZcu1VoLbBkw10GI20I,86
+langchain/utilities/reddit_search.py,sha256=OxmOC-U5cGq3JXsPA9JNvPNkbb8X_ByGKQm332CA6_E,117
+langchain/utilities/redis.py,sha256=ik63Zs0hyzX0taBEsKhNwvhB2u8E0gUJ8tsdijGflf0,201
+langchain/utilities/requests.py,sha256=0yn2kCy43ZUcz_e_-d6RgzC3mm4bGNhx6_wh06kkMnc,181
+langchain/utilities/scenexplain.py,sha256=cxt_Z3MUREmCs0LCL2DuHDqJ4u65yzKJQQ3E5gj_zps,113
+langchain/utilities/searchapi.py,sha256=s_XvE0R1yNrxmCQYuHCDpxdO_03Atm_Po67eQuXiwkg,107
+langchain/utilities/searx_search.py,sha256=Eplnsqbj0R3j_0GzmF6L4cW9_K5ESgtJ9Hxce1lcfmo,151
+langchain/utilities/serpapi.py,sha256=4ugicXq2XragdRnJRLow8uf_HNjliN_jg4ZB0vH5Y7s,125
+langchain/utilities/spark_sql.py,sha256=23qPqABsQ1gznObzn5ENuMjhqVUC--bBrQ5UrEql4dg,85
+langchain/utilities/sql_database.py,sha256=T6zXFhtL9ar1olyslQ5ltAZyAjB2R3cAz-9vbGdjCj4,139
+langchain/utilities/stackexchange.py,sha256=OROxm1XPyGKRQNFOkVX12bqcYRiBdEzSXruQVn4uxBw,119
+langchain/utilities/steam.py,sha256=yl4_GaOu70cmBp1NGQU8uGyCtQ8AJxNKZTGZFtDqkXY,101
+langchain/utilities/tavily_search.py,sha256=upI7h4XGapUnILfE3FHxmSs1NPyXwvcU3I5D2qp2uOI,126
+langchain/utilities/tensorflow_datasets.py,sha256=d2eydnoU7gNmZbA8tS8UjOu7WdR_mlGpTl3AWsd95jo,115
+langchain/utilities/twilio.py,sha256=_DsJOoIqRbbk-mzkm77fH0phImBcTFoQ8FGGsopFH5o,98
+langchain/utilities/vertexai.py,sha256=QJ37_fQf9LO017eVVHYcdeeRh0zT3D53BNHrbWztiHY,276
+langchain/utilities/wikipedia.py,sha256=qxLSWtnMq8KpsGzJBOMJCdOElX-FurPCu_ZywPLpvyA,116
+langchain/utilities/wolfram_alpha.py,sha256=EzUhoOBovy8Kmb953W0KXbzltFxXoQPOqw8vVW2-pY0,117
+langchain/utilities/zapier.py,sha256=C0jm5h43fJ5PTkwDzS9zUOaeI5K6551RTog9f1nzAVs,98
+langchain/utils/__init__.py,sha256=WVGQFc0avtlaXWij8i-9EaczI6UrUjO-vDxZh23kGw8,1221
+langchain/utils/__pycache__/__init__.cpython-311.pyc,,
+langchain/utils/__pycache__/aiter.cpython-311.pyc,,
+langchain/utils/__pycache__/env.cpython-311.pyc,,
+langchain/utils/__pycache__/ernie_functions.cpython-311.pyc,,
+langchain/utils/__pycache__/formatting.cpython-311.pyc,,
+langchain/utils/__pycache__/html.cpython-311.pyc,,
+langchain/utils/__pycache__/input.cpython-311.pyc,,
+langchain/utils/__pycache__/interactive_env.cpython-311.pyc,,
+langchain/utils/__pycache__/iter.cpython-311.pyc,,
+langchain/utils/__pycache__/json_schema.cpython-311.pyc,,
+langchain/utils/__pycache__/loading.cpython-311.pyc,,
+langchain/utils/__pycache__/math.cpython-311.pyc,,
+langchain/utils/__pycache__/openai.cpython-311.pyc,,
+langchain/utils/__pycache__/openai_functions.cpython-311.pyc,,
+langchain/utils/__pycache__/pydantic.cpython-311.pyc,,
+langchain/utils/__pycache__/strings.cpython-311.pyc,,
+langchain/utils/__pycache__/utils.cpython-311.pyc,,
+langchain/utils/aiter.py,sha256=7Ut0ojyQxDkgcPstziVZDlfmTlXSUYmQgDGBvDh83R0,102
+langchain/utils/env.py,sha256=KfFYCkcpxbeKl6JfpNWZmkxR1suHcpQuapIm-Dv2PlM,124
+langchain/utils/ernie_functions.py,sha256=HxFVErVGXX_b2Ngzn3O84Zyoii-hib3tOi4QefAsWGU,325
+langchain/utils/formatting.py,sha256=zrQEAw_328CgHtFLC1GKnpdobUzQtJ6jHR7ZUp1cBSA,91
+langchain/utils/html.py,sha256=YbIEQdxD5ud0TYyGxWDoIp_10vGUExubF4XSdMjx6gE,421
+langchain/utils/input.py,sha256=eMvdGirCwY78ecqpqNyqEvOYeRSXTAufxqvEyd9MOx0,211
+langchain/utils/interactive_env.py,sha256=NlnXizhm1TG3l_qKNI0qHJiHkh9q2jRjt5zGJsg_BCA,139
+langchain/utils/iter.py,sha256=w_FxBEiZ6SHbVrk6aRcNbCxrZtEqQ7Lf7_IeQBr6Yeo,133
+langchain/utils/json_schema.py,sha256=nSw7j5ZV6abc6wDtUQMfiJhMmwnVrGfIQA64KGuyTCc,258
+langchain/utils/loading.py,sha256=zr5W8pnZXlMysIQQtuYphOJxDBcrfeXoz632Tw0seLg,92
+langchain/utils/math.py,sha256=3wvqcXOj6b6wPqqGxHpOTOG5bj65yf8p1dyMywj2zgs,181
+langchain/utils/openai.py,sha256=r2yAlf-9-IxMgOaG6ineq_SDufJSJFzlEGonE061XB4,86
+langchain/utils/openai_functions.py,sha256=wAU7YCNgd2-nC_-1IIUnpE0S_zTdHYO5kmswWtLj7xI,330
+langchain/utils/pydantic.py,sha256=rg6ren6e7cJVyJKXyUNVdxS6ZsGeshV6e8iBEzfV_UU,111
+langchain/utils/strings.py,sha256=01zPdb-3EyRBfLMw8tFGJPmhZvW1O80gx_u_VmRjb38,148
+langchain/utils/utils.py,sha256=3HIZ2CfO10fr_OWAtWpwNyFDf18oRW12IZJOEJdgPsM,446
+langchain/vectorstores/__init__.py,sha256=nBS-4aGy4IGfyYgUivqGekjTELZHSSIFe6wkeRes5WA,2768
+langchain/vectorstores/__pycache__/__init__.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/alibabacloud_opensearch.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/analyticdb.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/annoy.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/astradb.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/atlas.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/awadb.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/azure_cosmos_db.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/azuresearch.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/bageldb.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/baiducloud_vector_search.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/base.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/cassandra.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/chroma.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/clarifai.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/clickhouse.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/dashvector.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/databricks_vector_search.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/deeplake.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/dingo.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/elastic_vector_search.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/elasticsearch.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/epsilla.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/faiss.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/hippo.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/hologres.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/lancedb.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/llm_rails.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/marqo.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/matching_engine.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/meilisearch.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/milvus.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/momento_vector_index.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/mongodb_atlas.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/myscale.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/neo4j_vector.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/nucliadb.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/opensearch_vector_search.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/pgembedding.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/pgvecto_rs.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/pgvector.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/pinecone.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/qdrant.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/rocksetdb.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/scann.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/semadb.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/singlestoredb.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/sklearn.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/sqlitevss.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/starrocks.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/supabase.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/tair.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/tencentvectordb.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/tigris.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/tiledb.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/timescalevector.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/typesense.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/usearch.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/utils.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/vald.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/vearch.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/vectara.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/vespa.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/weaviate.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/xata.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/yellowbrick.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/zep.cpython-311.pyc,,
+langchain/vectorstores/__pycache__/zilliz.cpython-311.pyc,,
+langchain/vectorstores/alibabacloud_opensearch.py,sha256=xh3cfS6evJJ4XjHeLdi3-lQ9kleu_nw2weky3jTcFhI,220
+langchain/vectorstores/analyticdb.py,sha256=EGjIrKYFbH5bdU0xL8WfDUku3P-G_FClEcGjXffofqE,109
+langchain/vectorstores/annoy.py,sha256=JVeOVVqQOtOQzbxOPa88rIXYYYNcHNmcA1WEmb-Rcgg,87
+langchain/vectorstores/astradb.py,sha256=lqo8Xe5nwFDZ5LAFk1r20WzlZffSf-NdREFlVZJgSg8,100
+langchain/vectorstores/atlas.py,sha256=oxuvXcaxXfvHPEvsSyTUwpd9kYVyz1ZwolAWVsYlAjI,82
+langchain/vectorstores/awadb.py,sha256=TRHMJjclkqXkVL3XEbzx4jowZQwChChsvusATSIHnNg,78
+langchain/vectorstores/azure_cosmos_db.py,sha256=Fd2B996cSeY92kYebZMdvWJwQcGc61rGZ95HJCRmqmo,256
+langchain/vectorstores/azuresearch.py,sha256=IPJs6QyBdJRYatStEqQeyarsKo--zjBU8_iRFK13pgg,188
+langchain/vectorstores/bageldb.py,sha256=CRqfdHx489DEB7qKl_zHxdlGiboj6hML8pqZiG1fH98,89
+langchain/vectorstores/baiducloud_vector_search.py,sha256=M877fPn1S2NAt1VAs8JMw4h4T6AhzS1L0k9hcN22IS0,115
+langchain/vectorstores/base.py,sha256=264EWH9pnWThSFqVQJi_ySfBbtViGV4d496rcyL96DY,125
+langchain/vectorstores/cassandra.py,sha256=aum0S3zsNKQlpVuN5oCyXFHY17-Lx6HelLF_BM3oiwU,104
+langchain/vectorstores/chroma.py,sha256=I85Y6o4ZXlUhD2wWCYHAAfVxd8LlHIh42XhTkYFLkAA,90
+langchain/vectorstores/clarifai.py,sha256=IlfLS0_jBPU3eU2jw1xkRfDvrB3ZOfVkwLdBT1xWQrg,87
+langchain/vectorstores/clickhouse.py,sha256=9XlaGRo-Gc4pnw4526PimtMlvPYyzbde4ibNTiucB4I,148
+langchain/vectorstores/dashvector.py,sha256=R_6OH5uWCVme42L9BHWI7-TcWGlwl30Smf9eTahnHrI,93
+langchain/vectorstores/databricks_vector_search.py,sha256=NzQLD_pZJAm-HJTPIGT4rfURiQBPoUhYr_cWl5eXIfE,140
+langchain/vectorstores/deeplake.py,sha256=hhIO-Bhn5qUsnz_Q2R2qfF3vIrpatkMFCAmX9lakLew,87
+langchain/vectorstores/dingo.py,sha256=-zNut1sdH507kaWYn6mRSjlJUoykTIiTPKexyL_fCnE,78
+langchain/vectorstores/docarray/__init__.py,sha256=-yA5diUG1xNKEhq2okPUWwbpUzT52YB5baxVLmtbTys,236
+langchain/vectorstores/docarray/__pycache__/__init__.cpython-311.pyc,,
+langchain/vectorstores/docarray/__pycache__/base.cpython-311.pyc,,
+langchain/vectorstores/docarray/__pycache__/hnsw.cpython-311.pyc,,
+langchain/vectorstores/docarray/__pycache__/in_memory.cpython-311.pyc,,
+langchain/vectorstores/docarray/base.py,sha256=uYWr8yNsJOW_rPYCO1g46cvWE4IVVyBHFEEpSKv9EGQ,111
+langchain/vectorstores/docarray/hnsw.py,sha256=WZvywfPkUldm69eZixvAxQH9kRPmrEYClwbn7yJ_lQw,112
+langchain/vectorstores/docarray/in_memory.py,sha256=-AjrFZcUmgg-VkwMwysjW2zwmN3e_5PXchouNYDjYI4,125
+langchain/vectorstores/elastic_vector_search.py,sha256=b0Q_EQr6v5LJFEX0QTbzvraTZrwHk2tx9K_tjZ_Nn80,184
+langchain/vectorstores/elasticsearch.py,sha256=F03FOgUThTpGrs8nNPlGETWvYeKyqwjlYBTKtUCBc04,362
+langchain/vectorstores/epsilla.py,sha256=nk-hsucrCsbOtgUJIxg_Zj3wt_GvcO2yQfeV4fuvJ-0,84
+langchain/vectorstores/faiss.py,sha256=BXLoXzMp5knV1RyJ1dCfLhulxtrB_7TjOg0SBUyUs4k,87
+langchain/vectorstores/hippo.py,sha256=yoEiFCcVMcoZ9F51U_6aT3pEhmXIiAILuSrVGg1Zhdw,78
+langchain/vectorstores/hologres.py,sha256=Z630icNuXdzWwXcEVybk_1QcGd-Rupd2ofJovzYIPbY,96
+langchain/vectorstores/lancedb.py,sha256=gU8d2c-4ulhm8_4FB-rlMndTdczwADgae5FD5YWdCiM,84
+langchain/vectorstores/llm_rails.py,sha256=dA4wyK72Fs5tFghUvkgFWHJLr8H9XOulk5fCu5p7UGE,128
+langchain/vectorstores/marqo.py,sha256=5Z1-P-ViaS928VB_CQPpY6Y4Epdtl4SxZb5WaoqX0W0,78
+langchain/vectorstores/matching_engine.py,sha256=Yi7rc_3QLjW6FiQv6i0sA_tTZjtLZFu-3D10P0jEmdk,106
+langchain/vectorstores/meilisearch.py,sha256=wyzg090FtZss3Nkg0zpZYVJ1HcL1Di6RVgyPddhpBRU,96
+langchain/vectorstores/milvus.py,sha256=vPmpRGW4yDsKiXzabMwXz8Lym_4EeF5JRhVtFBjWeSM,81
+langchain/vectorstores/momento_vector_index.py,sha256=XatmHaa2znGd3NA9SlKYbl7QITFZKiKZVo41nLT3_NA,128
+langchain/vectorstores/mongodb_atlas.py,sha256=f_Ig0d-n1M-Y9NILUhCt1rZkGSE_GqsY7Q-8o3RXA0w,192
+langchain/vectorstores/myscale.py,sha256=jrGJ0RveNEHF2xmkHS9tJuN9AVKjtcYnxMtRd0HcM7Q,179
+langchain/vectorstores/neo4j_vector.py,sha256=ljooXPjobGylvX_4O_wsczLbKaK-CjaLtJlHuT9FOUQ,147
+langchain/vectorstores/nucliadb.py,sha256=CtiAif6ZKiJUHskQiRnDCA7J2yfaJ6_UdMIaippCuvE,87
+langchain/vectorstores/opensearch_vector_search.py,sha256=DYOwcSXELzFMkkJZasQPmuksay7391gHJZOe5eCTLyc,147
+langchain/vectorstores/pgembedding.py,sha256=aEpIyvs9eSlBwCfHhwV0PjuBSVUNo7LOHnF_b3np6vY,234
+langchain/vectorstores/pgvecto_rs.py,sha256=e2jRUryX3-TnSSmy6oFg8B_rokQ--vMLGFv8R-cJ7Ls,93
+langchain/vectorstores/pgvector.py,sha256=fl_huAjkE8wVDuj8Iq_yzKAJuhqyE9di3pM0G0eJ9Qk,149
+langchain/vectorstores/pinecone.py,sha256=fI08K6KYHdfF8msi3zGatAKf7ajDjVFsBHGOS2_Uu9A,87
+langchain/vectorstores/qdrant.py,sha256=Sd6JqIhNsw0F9Yc9jVkmK2pxL0kR8pbKdfdPVTqQgxc,130
+langchain/vectorstores/redis/__init__.py,sha256=iDkWyYU-o8d7_mnGxK-HV8vsFtTyfEy1wJB9LY_fbSY,265
+langchain/vectorstores/redis/__pycache__/__init__.cpython-311.pyc,,
+langchain/vectorstores/redis/__pycache__/base.cpython-311.pyc,,
+langchain/vectorstores/redis/__pycache__/filters.cpython-311.pyc,,
+langchain/vectorstores/redis/__pycache__/schema.cpython-311.pyc,,
+langchain/vectorstores/redis/base.py,sha256=euq3Il6lq-gf9HnEEfuzCfCB4VOEKMHmE0KZMVOeHgs,213
+langchain/vectorstores/redis/filters.py,sha256=fX9iNlBm5ghnyfVVdiD6sWBFlWvs46udk4qbEmDjsUE,416
+langchain/vectorstores/redis/schema.py,sha256=dLTcQ2nimvwxv6-ouk75WU8eJltG2HpC0BL8cauOnlw,503
+langchain/vectorstores/rocksetdb.py,sha256=cXj6r9PTyNmVGfD0U9eI3M4m3YLYZ1KNA6A5_c_RQPk,86
+langchain/vectorstores/scann.py,sha256=uqFRRH9y4KFPzj21MyM0HIOAw6s6F2RDas1jGqxz8ck,87
+langchain/vectorstores/semadb.py,sha256=p1QE-JFJkDjco_730TSRmt57b07NAKlVmjXLCJsKwu4,81
+langchain/vectorstores/singlestoredb.py,sha256=z8wsn9XqgHwqhfvOH104YKi7ePXFWsD44_HFP9IcyDo,165
+langchain/vectorstores/sklearn.py,sha256=y8EVAQkecyFf8CDnIGp6xiUnpUI9zwoFqSOaqqSZ9bU,364
+langchain/vectorstores/sqlitevss.py,sha256=C0tZdpOfN8W2k8yAUPgnFU0DommRzN5AN4_7WQtpgpg,90
+langchain/vectorstores/starrocks.py,sha256=FHAiGCtSCvfsqZuoXdn4AyIiUWzV6--wutE6xqAlmyw,154
+langchain/vectorstores/supabase.py,sha256=6qCtbLSLv_Hzqf_9CBj1w1sTPTJVm9dlRto3uYFY1ZY,109
+langchain/vectorstores/tair.py,sha256=j_pWA4EYhW2l0p5iPLZ7iFH_GdC3PZ5B40KoMdG15Ik,75
+langchain/vectorstores/tencentvectordb.py,sha256=_ey78gLx7-dlK5wbqFW-ELEhAcSbahFDJVKoFYXNgKI,191
+langchain/vectorstores/tigris.py,sha256=o5kkkURmxSf_LNwW-fE6GdW-00cIrVgdoNhBcdD12b8,81
+langchain/vectorstores/tiledb.py,sha256=oQ3X2InuovVu5q7W1QS1K2PPpsGiW9P788sseDO94PE,97
+langchain/vectorstores/timescalevector.py,sha256=7baGDlld186zQLkti6RAe9mqPVRnCFA-sPRZO8SmwgM,124
+langchain/vectorstores/typesense.py,sha256=B0mvLDYY2Yi1LmvAiNOGzz7Yo2A3HU-ghzaJk9pknAI,90
+langchain/vectorstores/usearch.py,sha256=_-CZF3LyelGuuQa1G7xxyYj9m2tjpAbx-DepyfOAk9s,84
+langchain/vectorstores/utils.py,sha256=UU4fjjUrZqMSjiFvs-H-DMHio7NLA7FPLe-_ehYMntE,227
+langchain/vectorstores/vald.py,sha256=QHq8zTk0-PK1PMgRDFCx8H2aiGAvCwO0m5Iv6kKaqgg,75
+langchain/vectorstores/vearch.py,sha256=9SvKLRJYUdpY_ERhW7birAD4YTlPS6JP-R23pYH2cUQ,81
+langchain/vectorstores/vectara.py,sha256=sxfZBJ1YOUzTrdh7ZlzgowIQPGvss549GvyVQFkCvE8,122
+langchain/vectorstores/vespa.py,sha256=SI8ZkCOsJPo5k9HHMb_hrpalVAsBl8tB4J5DxPhuVdA,88
+langchain/vectorstores/weaviate.py,sha256=tOrCJAtZCxBt6RrsTUiDRd3lHkpXwjO2eF---PCVh80,103
+langchain/vectorstores/xata.py,sha256=ZKh5QWi3sd2mo-TUg2KKyMJ0mDThrS9rNo8TWW2LjYU,97
+langchain/vectorstores/yellowbrick.py,sha256=zQaiyNyzFWtklvsqjLng7uY9dfDbB51bYaD-BSemS_A,96
+langchain/vectorstores/zep.py,sha256=Kxk6j1rr7nY1ovQ5p7T5f58AcLT7Xkl-TW9QZLkYlww,132
+langchain/vectorstores/zilliz.py,sha256=7uMpFRglfsivaxkug3omEFgBs113eyE1cEuW5dBmi8k,81
diff --git a/llm/Lib/site-packages/langchain-0.1.16.dist-info/REQUESTED b/llm/Lib/site-packages/langchain-0.1.16.dist-info/REQUESTED
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain-0.1.16.dist-info/WHEEL b/llm/Lib/site-packages/langchain-0.1.16.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..7c881525d384f1537e81e8a783c8433a748a7089
--- /dev/null
+++ b/llm/Lib/site-packages/langchain-0.1.16.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 1.8.1
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/langchain-0.1.16.dist-info/entry_points.txt b/llm/Lib/site-packages/langchain-0.1.16.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..ee53ec0222c1f6b38b18173bf08dbd19f30e321e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain-0.1.16.dist-info/entry_points.txt
@@ -0,0 +1,3 @@
+[console_scripts]
+langchain-server=langchain.server:main
+
diff --git a/llm/Lib/site-packages/langchain/__init__.py b/llm/Lib/site-packages/langchain/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..78afad3a0aaf8090e667f5dd2558864f39d5baff
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/__init__.py
@@ -0,0 +1,438 @@
+# ruff: noqa: E402
+"""Main entrypoint into package."""
+import warnings
+from importlib import metadata
+from typing import Any, Optional
+
+from langchain_core._api.deprecation import surface_langchain_deprecation_warnings
+
+try:
+    __version__ = metadata.version(__package__)
+except metadata.PackageNotFoundError:
+    # Case where package metadata is not available.
+    __version__ = ""
+del metadata  # optional, avoids polluting the results of dir(__package__)
+
+
+def _warn_on_import(name: str, replacement: Optional[str] = None) -> None:
+    """Warn on import of deprecated module."""
+    from langchain.utils.interactive_env import is_interactive_env
+
+    if is_interactive_env():
+        # No warnings for interactive environments.
+        # This is done to avoid polluting the output of interactive environments
+        # where users rely on auto-complete and may trigger this warning
+        # even if they are not using any deprecated modules
+        return
+
+    if replacement:
+        warnings.warn(
+            f"Importing {name} from langchain root module is no longer supported. "
+            f"Please use {replacement} instead."
+        )
+    else:
+        warnings.warn(
+            f"Importing {name} from langchain root module is no longer supported."
+        )
+
+
+# Surfaces Deprecation and Pending Deprecation warnings from langchain.
+surface_langchain_deprecation_warnings()
+
+
+def __getattr__(name: str) -> Any:
+    if name == "MRKLChain":
+        from langchain.agents import MRKLChain
+
+        _warn_on_import(name, replacement="langchain.agents.MRKLChain")
+
+        return MRKLChain
+    elif name == "ReActChain":
+        from langchain.agents import ReActChain
+
+        _warn_on_import(name, replacement="langchain.agents.ReActChain")
+
+        return ReActChain
+    elif name == "SelfAskWithSearchChain":
+        from langchain.agents import SelfAskWithSearchChain
+
+        _warn_on_import(name, replacement="langchain.agents.SelfAskWithSearchChain")
+
+        return SelfAskWithSearchChain
+    elif name == "ConversationChain":
+        from langchain.chains import ConversationChain
+
+        _warn_on_import(name, replacement="langchain.chains.ConversationChain")
+
+        return ConversationChain
+    elif name == "LLMBashChain":
+        raise ImportError(
+            "This module has been moved to langchain-experimental. "
+            "For more details: "
+            "https://github.com/langchain-ai/langchain/discussions/11352."
+            "To access this code, install it with `pip install langchain-experimental`."
+            "`from langchain_experimental.llm_bash.base "
+            "import LLMBashChain`"
+        )
+
+    elif name == "LLMChain":
+        from langchain.chains import LLMChain
+
+        _warn_on_import(name, replacement="langchain.chains.LLMChain")
+
+        return LLMChain
+    elif name == "LLMCheckerChain":
+        from langchain.chains import LLMCheckerChain
+
+        _warn_on_import(name, replacement="langchain.chains.LLMCheckerChain")
+
+        return LLMCheckerChain
+    elif name == "LLMMathChain":
+        from langchain.chains import LLMMathChain
+
+        _warn_on_import(name, replacement="langchain.chains.LLMMathChain")
+
+        return LLMMathChain
+    elif name == "QAWithSourcesChain":
+        from langchain.chains import QAWithSourcesChain
+
+        _warn_on_import(name, replacement="langchain.chains.QAWithSourcesChain")
+
+        return QAWithSourcesChain
+    elif name == "VectorDBQA":
+        from langchain.chains import VectorDBQA
+
+        _warn_on_import(name, replacement="langchain.chains.VectorDBQA")
+
+        return VectorDBQA
+    elif name == "VectorDBQAWithSourcesChain":
+        from langchain.chains import VectorDBQAWithSourcesChain
+
+        _warn_on_import(name, replacement="langchain.chains.VectorDBQAWithSourcesChain")
+
+        return VectorDBQAWithSourcesChain
+    elif name == "InMemoryDocstore":
+        from langchain.docstore import InMemoryDocstore
+
+        _warn_on_import(name, replacement="langchain.docstore.InMemoryDocstore")
+
+        return InMemoryDocstore
+    elif name == "Wikipedia":
+        from langchain.docstore import Wikipedia
+
+        _warn_on_import(name, replacement="langchain.docstore.Wikipedia")
+
+        return Wikipedia
+    elif name == "Anthropic":
+        from langchain_community.llms import Anthropic
+
+        _warn_on_import(name, replacement="langchain_community.llms.Anthropic")
+
+        return Anthropic
+    elif name == "Banana":
+        from langchain_community.llms import Banana
+
+        _warn_on_import(name, replacement="langchain_community.llms.Banana")
+
+        return Banana
+    elif name == "CerebriumAI":
+        from langchain_community.llms import CerebriumAI
+
+        _warn_on_import(name, replacement="langchain_community.llms.CerebriumAI")
+
+        return CerebriumAI
+    elif name == "Cohere":
+        from langchain_community.llms import Cohere
+
+        _warn_on_import(name, replacement="langchain_community.llms.Cohere")
+
+        return Cohere
+    elif name == "ForefrontAI":
+        from langchain_community.llms import ForefrontAI
+
+        _warn_on_import(name, replacement="langchain_community.llms.ForefrontAI")
+
+        return ForefrontAI
+    elif name == "GooseAI":
+        from langchain_community.llms import GooseAI
+
+        _warn_on_import(name, replacement="langchain_community.llms.GooseAI")
+
+        return GooseAI
+    elif name == "HuggingFaceHub":
+        from langchain_community.llms import HuggingFaceHub
+
+        _warn_on_import(name, replacement="langchain_community.llms.HuggingFaceHub")
+
+        return HuggingFaceHub
+    elif name == "HuggingFaceTextGenInference":
+        from langchain_community.llms import HuggingFaceTextGenInference
+
+        _warn_on_import(
+            name, replacement="langchain_community.llms.HuggingFaceTextGenInference"
+        )
+
+        return HuggingFaceTextGenInference
+    elif name == "LlamaCpp":
+        from langchain_community.llms import LlamaCpp
+
+        _warn_on_import(name, replacement="langchain_community.llms.LlamaCpp")
+
+        return LlamaCpp
+    elif name == "Modal":
+        from langchain_community.llms import Modal
+
+        _warn_on_import(name, replacement="langchain_community.llms.Modal")
+
+        return Modal
+    elif name == "OpenAI":
+        from langchain_community.llms import OpenAI
+
+        _warn_on_import(name, replacement="langchain_community.llms.OpenAI")
+
+        return OpenAI
+    elif name == "Petals":
+        from langchain_community.llms import Petals
+
+        _warn_on_import(name, replacement="langchain_community.llms.Petals")
+
+        return Petals
+    elif name == "PipelineAI":
+        from langchain_community.llms import PipelineAI
+
+        _warn_on_import(name, replacement="langchain_community.llms.PipelineAI")
+
+        return PipelineAI
+    elif name == "SagemakerEndpoint":
+        from langchain_community.llms import SagemakerEndpoint
+
+        _warn_on_import(name, replacement="langchain_community.llms.SagemakerEndpoint")
+
+        return SagemakerEndpoint
+    elif name == "StochasticAI":
+        from langchain_community.llms import StochasticAI
+
+        _warn_on_import(name, replacement="langchain_community.llms.StochasticAI")
+
+        return StochasticAI
+    elif name == "Writer":
+        from langchain_community.llms import Writer
+
+        _warn_on_import(name, replacement="langchain_community.llms.Writer")
+
+        return Writer
+    elif name == "HuggingFacePipeline":
+        from langchain_community.llms.huggingface_pipeline import HuggingFacePipeline
+
+        _warn_on_import(
+            name,
+            replacement="langchain_community.llms.huggingface_pipeline.HuggingFacePipeline",
+        )
+
+        return HuggingFacePipeline
+    elif name == "FewShotPromptTemplate":
+        from langchain_core.prompts import FewShotPromptTemplate
+
+        _warn_on_import(
+            name, replacement="langchain_core.prompts.FewShotPromptTemplate"
+        )
+
+        return FewShotPromptTemplate
+    elif name == "Prompt":
+        from langchain_core.prompts import PromptTemplate
+
+        _warn_on_import(name, replacement="langchain_core.prompts.PromptTemplate")
+
+        # it's renamed as prompt template anyways
+        # this is just for backwards compat
+        return PromptTemplate
+    elif name == "PromptTemplate":
+        from langchain_core.prompts import PromptTemplate
+
+        _warn_on_import(name, replacement="langchain_core.prompts.PromptTemplate")
+
+        return PromptTemplate
+    elif name == "BasePromptTemplate":
+        from langchain_core.prompts import BasePromptTemplate
+
+        _warn_on_import(name, replacement="langchain_core.prompts.BasePromptTemplate")
+
+        return BasePromptTemplate
+    elif name == "ArxivAPIWrapper":
+        from langchain_community.utilities import ArxivAPIWrapper
+
+        _warn_on_import(
+            name, replacement="langchain_community.utilities.ArxivAPIWrapper"
+        )
+
+        return ArxivAPIWrapper
+    elif name == "GoldenQueryAPIWrapper":
+        from langchain_community.utilities import GoldenQueryAPIWrapper
+
+        _warn_on_import(
+            name, replacement="langchain_community.utilities.GoldenQueryAPIWrapper"
+        )
+
+        return GoldenQueryAPIWrapper
+    elif name == "GoogleSearchAPIWrapper":
+        from langchain_community.utilities import GoogleSearchAPIWrapper
+
+        _warn_on_import(
+            name, replacement="langchain_community.utilities.GoogleSearchAPIWrapper"
+        )
+
+        return GoogleSearchAPIWrapper
+    elif name == "GoogleSerperAPIWrapper":
+        from langchain_community.utilities import GoogleSerperAPIWrapper
+
+        _warn_on_import(
+            name, replacement="langchain_community.utilities.GoogleSerperAPIWrapper"
+        )
+
+        return GoogleSerperAPIWrapper
+    elif name == "PowerBIDataset":
+        from langchain_community.utilities import PowerBIDataset
+
+        _warn_on_import(
+            name, replacement="langchain_community.utilities.PowerBIDataset"
+        )
+
+        return PowerBIDataset
+    elif name == "SearxSearchWrapper":
+        from langchain_community.utilities import SearxSearchWrapper
+
+        _warn_on_import(
+            name, replacement="langchain_community.utilities.SearxSearchWrapper"
+        )
+
+        return SearxSearchWrapper
+    elif name == "WikipediaAPIWrapper":
+        from langchain_community.utilities import WikipediaAPIWrapper
+
+        _warn_on_import(
+            name, replacement="langchain_community.utilities.WikipediaAPIWrapper"
+        )
+
+        return WikipediaAPIWrapper
+    elif name == "WolframAlphaAPIWrapper":
+        from langchain_community.utilities import WolframAlphaAPIWrapper
+
+        _warn_on_import(
+            name, replacement="langchain_community.utilities.WolframAlphaAPIWrapper"
+        )
+
+        return WolframAlphaAPIWrapper
+    elif name == "SQLDatabase":
+        from langchain_community.utilities import SQLDatabase
+
+        _warn_on_import(name, replacement="langchain_community.utilities.SQLDatabase")
+
+        return SQLDatabase
+    elif name == "FAISS":
+        from langchain_community.vectorstores import FAISS
+
+        _warn_on_import(name, replacement="langchain_community.vectorstores.FAISS")
+
+        return FAISS
+    elif name == "ElasticVectorSearch":
+        from langchain_community.vectorstores import ElasticVectorSearch
+
+        _warn_on_import(
+            name, replacement="langchain_community.vectorstores.ElasticVectorSearch"
+        )
+
+        return ElasticVectorSearch
+    # For backwards compatibility
+    elif name == "SerpAPIChain" or name == "SerpAPIWrapper":
+        from langchain_community.utilities import SerpAPIWrapper
+
+        _warn_on_import(
+            name, replacement="langchain_community.utilities.SerpAPIWrapper"
+        )
+
+        return SerpAPIWrapper
+    elif name == "verbose":
+        from langchain.globals import _verbose
+
+        _warn_on_import(
+            name,
+            replacement=(
+                "langchain.globals.set_verbose() / langchain.globals.get_verbose()"
+            ),
+        )
+
+        return _verbose
+    elif name == "debug":
+        from langchain.globals import _debug
+
+        _warn_on_import(
+            name,
+            replacement=(
+                "langchain.globals.set_debug() / langchain.globals.get_debug()"
+            ),
+        )
+
+        return _debug
+    elif name == "llm_cache":
+        from langchain.globals import _llm_cache
+
+        _warn_on_import(
+            name,
+            replacement=(
+                "langchain.globals.set_llm_cache() / langchain.globals.get_llm_cache()"
+            ),
+        )
+
+        return _llm_cache
+    else:
+        raise AttributeError(f"Could not find: {name}")
+
+
+__all__ = [
+    "LLMChain",
+    "LLMCheckerChain",
+    "LLMMathChain",
+    "ArxivAPIWrapper",
+    "GoldenQueryAPIWrapper",
+    "SelfAskWithSearchChain",
+    "SerpAPIWrapper",
+    "SerpAPIChain",
+    "SearxSearchWrapper",
+    "GoogleSearchAPIWrapper",
+    "GoogleSerperAPIWrapper",
+    "WolframAlphaAPIWrapper",
+    "WikipediaAPIWrapper",
+    "Anthropic",
+    "Banana",
+    "CerebriumAI",
+    "Cohere",
+    "ForefrontAI",
+    "GooseAI",
+    "Modal",
+    "OpenAI",
+    "Petals",
+    "PipelineAI",
+    "StochasticAI",
+    "Writer",
+    "BasePromptTemplate",
+    "Prompt",
+    "FewShotPromptTemplate",
+    "PromptTemplate",
+    "ReActChain",
+    "Wikipedia",
+    "HuggingFaceHub",
+    "SagemakerEndpoint",
+    "HuggingFacePipeline",
+    "SQLDatabase",
+    "PowerBIDataset",
+    "FAISS",
+    "MRKLChain",
+    "VectorDBQA",
+    "ElasticVectorSearch",
+    "InMemoryDocstore",
+    "ConversationChain",
+    "VectorDBQAWithSourcesChain",
+    "QAWithSourcesChain",
+    "LlamaCpp",
+    "HuggingFaceTextGenInference",
+]
diff --git a/llm/Lib/site-packages/langchain/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1d37fc87a8150384c7101424246ed69ccab65ac5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/__pycache__/base_language.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/base_language.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dcabfc3988006127679d034690a772e958e1ac47
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/base_language.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/__pycache__/cache.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/cache.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..73a3d9eadf7ebc4320cd710f765c0885b5ef8b68
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/cache.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/__pycache__/env.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/env.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..af5ca4e86921fc87dce23905c64c6aeb708ce1fe
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/env.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/__pycache__/example_generator.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/example_generator.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9f445402736144c8a46d2a29f510a552bb623afb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/example_generator.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/__pycache__/formatting.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/formatting.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2b4f10fbffd9a7bfb08ed1d07af7d943ac7d7a90
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/formatting.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/__pycache__/hub.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/hub.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8a5036b86cf2fcc2076c1108fe25b46f66b2b99e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/hub.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/__pycache__/input.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/input.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..561e774670af92b73d81aec216b591721200a0ab
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/input.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/__pycache__/model_laboratory.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/model_laboratory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a2a8763ab54cfc85fd529c5ecf4508beaa3ab931
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/model_laboratory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/__pycache__/python.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/python.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fb0792be408c91b3df288752fd4edf5608c8873c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/python.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/__pycache__/requests.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/requests.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9ce195055c55fb510eb54ef586f10854a4db59af
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/requests.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/__pycache__/serpapi.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/serpapi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f9ebbb7698c0019982a3adcbdac3627a284338d4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/serpapi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/__pycache__/sql_database.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/sql_database.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6d516dd5ada157bd4b97b265639c237a8a9805ee
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/sql_database.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/__pycache__/text_splitter.cpython-311.pyc b/llm/Lib/site-packages/langchain/__pycache__/text_splitter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ab3f840b88538972239bee1b19a9db8ada32c2ba
Binary files /dev/null and b/llm/Lib/site-packages/langchain/__pycache__/text_splitter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/_api/__init__.py b/llm/Lib/site-packages/langchain/_api/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e013a72129f820754d0f2ea3578395fb02dcffd9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/_api/__init__.py
@@ -0,0 +1,26 @@
+"""Helper functions for managing the LangChain API.
+
+This module is only relevant for LangChain developers, not for users.
+
+.. warning::
+
+    This module and its submodules are for internal use only.  Do not use them
+    in your own code.  We may change the API at any time with no warning.
+
+"""
+
+from .deprecation import (
+    LangChainDeprecationWarning,
+    deprecated,
+    suppress_langchain_deprecation_warning,
+    surface_langchain_deprecation_warnings,
+    warn_deprecated,
+)
+
+__all__ = [
+    "deprecated",
+    "LangChainDeprecationWarning",
+    "suppress_langchain_deprecation_warning",
+    "surface_langchain_deprecation_warnings",
+    "warn_deprecated",
+]
diff --git a/llm/Lib/site-packages/langchain/_api/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/_api/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5ba7e0227c5dec4bd9453a567c6f7258fa7dad53
Binary files /dev/null and b/llm/Lib/site-packages/langchain/_api/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/_api/__pycache__/deprecation.cpython-311.pyc b/llm/Lib/site-packages/langchain/_api/__pycache__/deprecation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..267021bd775181a9267bf652bc0fed783711563d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/_api/__pycache__/deprecation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/_api/__pycache__/path.cpython-311.pyc b/llm/Lib/site-packages/langchain/_api/__pycache__/path.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ddd3ebc7dc86ff541d196d1fb26099899d58b3fe
Binary files /dev/null and b/llm/Lib/site-packages/langchain/_api/__pycache__/path.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/_api/deprecation.py b/llm/Lib/site-packages/langchain/_api/deprecation.py
new file mode 100644
index 0000000000000000000000000000000000000000..e85ab4046ce97621bee44c37a481572379b59fbf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/_api/deprecation.py
@@ -0,0 +1,17 @@
+from langchain_core._api.deprecation import (
+    LangChainDeprecationWarning,
+    LangChainPendingDeprecationWarning,
+    deprecated,
+    suppress_langchain_deprecation_warning,
+    surface_langchain_deprecation_warnings,
+    warn_deprecated,
+)
+
+__all__ = [
+    "LangChainDeprecationWarning",
+    "LangChainPendingDeprecationWarning",
+    "deprecated",
+    "suppress_langchain_deprecation_warning",
+    "warn_deprecated",
+    "surface_langchain_deprecation_warnings",
+]
diff --git a/llm/Lib/site-packages/langchain/_api/path.py b/llm/Lib/site-packages/langchain/_api/path.py
new file mode 100644
index 0000000000000000000000000000000000000000..5ee0fe817da75847425c409f7b428f812a4db855
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/_api/path.py
@@ -0,0 +1,3 @@
+from langchain_core._api.path import as_import_path, get_relative_path
+
+__all__ = ["get_relative_path", "as_import_path"]
diff --git a/llm/Lib/site-packages/langchain/adapters/__init__.py b/llm/Lib/site-packages/langchain/adapters/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/adapters/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/adapters/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8ac085c4d882dab3dee91e1a05823823c029e580
Binary files /dev/null and b/llm/Lib/site-packages/langchain/adapters/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/adapters/__pycache__/openai.cpython-311.pyc b/llm/Lib/site-packages/langchain/adapters/__pycache__/openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4dbe9cb7cb1cc91813ff07fce110ef401b0a7ad4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/adapters/__pycache__/openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/adapters/openai.py b/llm/Lib/site-packages/langchain/adapters/openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..54068ac804fb3c65f36bebdf526dced71e2a65f3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/adapters/openai.py
@@ -0,0 +1,31 @@
+from langchain_community.adapters.openai import (
+    Chat,
+    ChatCompletion,
+    ChatCompletionChunk,
+    ChatCompletions,
+    Choice,
+    ChoiceChunk,
+    Completions,
+    IndexableBaseModel,
+    chat,
+    convert_dict_to_message,
+    convert_message_to_dict,
+    convert_messages_for_finetuning,
+    convert_openai_messages,
+)
+
+__all__ = [
+    "IndexableBaseModel",
+    "Choice",
+    "ChatCompletions",
+    "ChoiceChunk",
+    "ChatCompletionChunk",
+    "convert_dict_to_message",
+    "convert_message_to_dict",
+    "convert_openai_messages",
+    "ChatCompletion",
+    "convert_messages_for_finetuning",
+    "Completions",
+    "Chat",
+    "chat",
+]
diff --git a/llm/Lib/site-packages/langchain/agents/__init__.py b/llm/Lib/site-packages/langchain/agents/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..564f368aeefe6315045f3d30446f1f551c58cce0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/__init__.py
@@ -0,0 +1,159 @@
+"""
+**Agent** is a class that uses an LLM to choose a sequence of actions to take.
+
+In Chains, a sequence of actions is hardcoded. In Agents,
+a language model is used as a reasoning engine to determine which actions
+to take and in which order.
+
+Agents select and use **Tools** and **Toolkits** for actions.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseSingleActionAgent --> LLMSingleActionAgent
+                              OpenAIFunctionsAgent
+                              XMLAgent
+                              Agent --> <name>Agent  # Examples: ZeroShotAgent, ChatAgent
+                                        
+
+    BaseMultiActionAgent  --> OpenAIMultiFunctionsAgent
+    
+    
+**Main helpers:**
+
+.. code-block::
+
+    AgentType, AgentExecutor, AgentOutputParser, AgentExecutorIterator,
+    AgentAction, AgentFinish
+    
+"""  # noqa: E501
+from pathlib import Path
+from typing import Any
+
+from langchain_community.agent_toolkits import (
+    create_json_agent,
+    create_openapi_agent,
+    create_pbi_agent,
+    create_pbi_chat_agent,
+    create_spark_sql_agent,
+    create_sql_agent,
+)
+from langchain_core._api.path import as_import_path
+
+from langchain.agents.agent import (
+    Agent,
+    AgentExecutor,
+    AgentOutputParser,
+    BaseMultiActionAgent,
+    BaseSingleActionAgent,
+    LLMSingleActionAgent,
+)
+from langchain.agents.agent_iterator import AgentExecutorIterator
+from langchain.agents.agent_toolkits.vectorstore.base import (
+    create_vectorstore_agent,
+    create_vectorstore_router_agent,
+)
+from langchain.agents.agent_types import AgentType
+from langchain.agents.conversational.base import ConversationalAgent
+from langchain.agents.conversational_chat.base import ConversationalChatAgent
+from langchain.agents.initialize import initialize_agent
+from langchain.agents.json_chat.base import create_json_chat_agent
+from langchain.agents.load_tools import (
+    get_all_tool_names,
+    load_huggingface_tool,
+    load_tools,
+)
+from langchain.agents.loading import load_agent
+from langchain.agents.mrkl.base import MRKLChain, ZeroShotAgent
+from langchain.agents.openai_functions_agent.base import (
+    OpenAIFunctionsAgent,
+    create_openai_functions_agent,
+)
+from langchain.agents.openai_functions_multi_agent.base import OpenAIMultiFunctionsAgent
+from langchain.agents.openai_tools.base import create_openai_tools_agent
+from langchain.agents.react.agent import create_react_agent
+from langchain.agents.react.base import ReActChain, ReActTextWorldAgent
+from langchain.agents.self_ask_with_search.base import (
+    SelfAskWithSearchChain,
+    create_self_ask_with_search_agent,
+)
+from langchain.agents.structured_chat.base import (
+    StructuredChatAgent,
+    create_structured_chat_agent,
+)
+from langchain.agents.tool_calling_agent.base import create_tool_calling_agent
+from langchain.agents.tools import Tool, tool
+from langchain.agents.xml.base import XMLAgent, create_xml_agent
+
+DEPRECATED_CODE = [
+    "create_csv_agent",
+    "create_pandas_dataframe_agent",
+    "create_spark_dataframe_agent",
+    "create_xorbits_agent",
+]
+
+
+def __getattr__(name: str) -> Any:
+    """Get attr name."""
+    if name in DEPRECATED_CODE:
+        # Get directory of langchain package
+        HERE = Path(__file__).parents[1]
+        relative_path = as_import_path(
+            Path(__file__).parent, suffix=name, relative_to=HERE
+        )
+        old_path = "langchain." + relative_path
+        new_path = "langchain_experimental." + relative_path
+        raise ImportError(
+            f"{name} has been moved to langchain experimental. "
+            "See https://github.com/langchain-ai/langchain/discussions/11680"
+            "for more information.\n"
+            f"Please update your import statement from: `{old_path}` to `{new_path}`."
+        )
+    raise AttributeError(f"{name} does not exist")
+
+
+__all__ = [
+    "Agent",
+    "AgentExecutor",
+    "AgentExecutorIterator",
+    "AgentOutputParser",
+    "AgentType",
+    "BaseMultiActionAgent",
+    "BaseSingleActionAgent",
+    "ConversationalAgent",
+    "ConversationalChatAgent",
+    "LLMSingleActionAgent",
+    "MRKLChain",
+    "OpenAIFunctionsAgent",
+    "OpenAIMultiFunctionsAgent",
+    "ReActChain",
+    "ReActTextWorldAgent",
+    "SelfAskWithSearchChain",
+    "StructuredChatAgent",
+    "Tool",
+    "ZeroShotAgent",
+    "create_json_agent",
+    "create_openapi_agent",
+    "create_pbi_agent",
+    "create_pbi_chat_agent",
+    "create_spark_sql_agent",
+    "create_sql_agent",
+    "create_vectorstore_agent",
+    "create_vectorstore_router_agent",
+    "get_all_tool_names",
+    "initialize_agent",
+    "load_agent",
+    "load_huggingface_tool",
+    "load_tools",
+    "tool",
+    "XMLAgent",
+    "create_openai_functions_agent",
+    "create_xml_agent",
+    "create_react_agent",
+    "create_openai_tools_agent",
+    "create_self_ask_with_search_agent",
+    "create_json_chat_agent",
+    "create_structured_chat_agent",
+    "create_tool_calling_agent",
+]
diff --git a/llm/Lib/site-packages/langchain/agents/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..00887cf23cca5482f9d6403c1e74af760f0f8310
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/__pycache__/agent.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/__pycache__/agent.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..be37f96951ec78181913fb216382b3fae4f7538d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/__pycache__/agent.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/__pycache__/agent_iterator.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/__pycache__/agent_iterator.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..826fcce7b7374f95f60158f23ce87092aed13bc4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/__pycache__/agent_iterator.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/__pycache__/agent_types.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/__pycache__/agent_types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5f6f43a0a0e41d1973a13808c56a837b7724b943
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/__pycache__/agent_types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/__pycache__/initialize.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/__pycache__/initialize.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f36359ace81dc8b03e0116fdd4bac23d670b829f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/__pycache__/initialize.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/__pycache__/load_tools.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/__pycache__/load_tools.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e4d591c974f2ca62be283d2a286fb72d5b570bfa
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/__pycache__/load_tools.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/__pycache__/loading.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/__pycache__/loading.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..48388465c78bd59d3ec037388c09c1995a04e106
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/__pycache__/loading.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/__pycache__/schema.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/__pycache__/schema.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1d6921124e697a0e204b77bfda530388b379722d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/__pycache__/schema.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/__pycache__/tools.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/__pycache__/tools.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ae8bbb22b45c48933bb282f5dcb32a08cd25fcee
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/__pycache__/tools.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/__pycache__/types.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/__pycache__/types.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4d55726698efe6f8472f8dc8bd6dafac6651b7a6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/__pycache__/types.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..650078bca2a5a18c9436d7132e493ad606f445d5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent.py b/llm/Lib/site-packages/langchain/agents/agent.py
new file mode 100644
index 0000000000000000000000000000000000000000..f37c8e1ab9f2324c0dc5f20eb970027f67e8b9de
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent.py
@@ -0,0 +1,1593 @@
+"""Chain that takes in an input and produces an action and action input."""
+from __future__ import annotations
+
+import asyncio
+import json
+import logging
+import time
+from abc import abstractmethod
+from pathlib import Path
+from typing import (
+    Any,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    Union,
+)
+
+import yaml
+from langchain_core._api import deprecated
+from langchain_core.agents import AgentAction, AgentFinish, AgentStep
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    AsyncCallbackManagerForToolRun,
+    BaseCallbackManager,
+    CallbackManagerForChainRun,
+    CallbackManagerForToolRun,
+    Callbacks,
+)
+from langchain_core.exceptions import OutputParserException
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.messages import BaseMessage
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.prompts.few_shot import FewShotPromptTemplate
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.runnables import Runnable, RunnableConfig, ensure_config
+from langchain_core.runnables.utils import AddableDict
+from langchain_core.tools import BaseTool
+from langchain_core.utils.input import get_color_mapping
+
+from langchain.agents.agent_iterator import AgentExecutorIterator
+from langchain.agents.agent_types import AgentType
+from langchain.agents.tools import InvalidTool
+from langchain.chains.base import Chain
+from langchain.chains.llm import LLMChain
+from langchain.utilities.asyncio import asyncio_timeout
+
+logger = logging.getLogger(__name__)
+
+
+class BaseSingleActionAgent(BaseModel):
+    """Base Single Action Agent class."""
+
+    @property
+    def return_values(self) -> List[str]:
+        """Return values of the agent."""
+        return ["output"]
+
+    def get_allowed_tools(self) -> Optional[List[str]]:
+        return None
+
+    @abstractmethod
+    def plan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[AgentAction, AgentFinish]:
+        """Given input, decided what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with observations
+            callbacks: Callbacks to run.
+            **kwargs: User inputs.
+
+        Returns:
+            Action specifying what tool to use.
+        """
+
+    @abstractmethod
+    async def aplan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[AgentAction, AgentFinish]:
+        """Given input, decided what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with observations
+            callbacks: Callbacks to run.
+            **kwargs: User inputs.
+
+        Returns:
+            Action specifying what tool to use.
+        """
+
+    @property
+    @abstractmethod
+    def input_keys(self) -> List[str]:
+        """Return the input keys.
+
+        :meta private:
+        """
+
+    def return_stopped_response(
+        self,
+        early_stopping_method: str,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        **kwargs: Any,
+    ) -> AgentFinish:
+        """Return response when agent has been stopped due to max iterations."""
+        if early_stopping_method == "force":
+            # `force` just returns a constant string
+            return AgentFinish(
+                {"output": "Agent stopped due to iteration limit or time limit."}, ""
+            )
+        else:
+            raise ValueError(
+                f"Got unsupported early_stopping_method `{early_stopping_method}`"
+            )
+
+    @classmethod
+    def from_llm_and_tools(
+        cls,
+        llm: BaseLanguageModel,
+        tools: Sequence[BaseTool],
+        callback_manager: Optional[BaseCallbackManager] = None,
+        **kwargs: Any,
+    ) -> BaseSingleActionAgent:
+        raise NotImplementedError
+
+    @property
+    def _agent_type(self) -> str:
+        """Return Identifier of agent type."""
+        raise NotImplementedError
+
+    def dict(self, **kwargs: Any) -> Dict:
+        """Return dictionary representation of agent."""
+        _dict = super().dict()
+        try:
+            _type = self._agent_type
+        except NotImplementedError:
+            _type = None
+        if isinstance(_type, AgentType):
+            _dict["_type"] = str(_type.value)
+        elif _type is not None:
+            _dict["_type"] = _type
+        return _dict
+
+    def save(self, file_path: Union[Path, str]) -> None:
+        """Save the agent.
+
+        Args:
+            file_path: Path to file to save the agent to.
+
+        Example:
+        .. code-block:: python
+
+            # If working with agent executor
+            agent.agent.save(file_path="path/agent.yaml")
+        """
+        # Convert file to Path object.
+        if isinstance(file_path, str):
+            save_path = Path(file_path)
+        else:
+            save_path = file_path
+
+        directory_path = save_path.parent
+        directory_path.mkdir(parents=True, exist_ok=True)
+
+        # Fetch dictionary to save
+        agent_dict = self.dict()
+        if "_type" not in agent_dict:
+            raise NotImplementedError(f"Agent {self} does not support saving")
+
+        if save_path.suffix == ".json":
+            with open(file_path, "w") as f:
+                json.dump(agent_dict, f, indent=4)
+        elif save_path.suffix.endswith((".yaml", ".yml")):
+            with open(file_path, "w") as f:
+                yaml.dump(agent_dict, f, default_flow_style=False)
+        else:
+            raise ValueError(f"{save_path} must be json or yaml")
+
+    def tool_run_logging_kwargs(self) -> Dict:
+        return {}
+
+
+class BaseMultiActionAgent(BaseModel):
+    """Base Multi Action Agent class."""
+
+    @property
+    def return_values(self) -> List[str]:
+        """Return values of the agent."""
+        return ["output"]
+
+    def get_allowed_tools(self) -> Optional[List[str]]:
+        return None
+
+    @abstractmethod
+    def plan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[List[AgentAction], AgentFinish]:
+        """Given input, decided what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with the observations.
+            callbacks: Callbacks to run.
+            **kwargs: User inputs.
+
+        Returns:
+            Actions specifying what tool to use.
+        """
+
+    @abstractmethod
+    async def aplan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[List[AgentAction], AgentFinish]:
+        """Given input, decided what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with the observations.
+            callbacks: Callbacks to run.
+            **kwargs: User inputs.
+
+        Returns:
+            Actions specifying what tool to use.
+        """
+
+    @property
+    @abstractmethod
+    def input_keys(self) -> List[str]:
+        """Return the input keys.
+
+        :meta private:
+        """
+
+    def return_stopped_response(
+        self,
+        early_stopping_method: str,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        **kwargs: Any,
+    ) -> AgentFinish:
+        """Return response when agent has been stopped due to max iterations."""
+        if early_stopping_method == "force":
+            # `force` just returns a constant string
+            return AgentFinish({"output": "Agent stopped due to max iterations."}, "")
+        else:
+            raise ValueError(
+                f"Got unsupported early_stopping_method `{early_stopping_method}`"
+            )
+
+    @property
+    def _agent_type(self) -> str:
+        """Return Identifier of agent type."""
+        raise NotImplementedError
+
+    def dict(self, **kwargs: Any) -> Dict:
+        """Return dictionary representation of agent."""
+        _dict = super().dict()
+        try:
+            _dict["_type"] = str(self._agent_type)
+        except NotImplementedError:
+            pass
+        return _dict
+
+    def save(self, file_path: Union[Path, str]) -> None:
+        """Save the agent.
+
+        Args:
+            file_path: Path to file to save the agent to.
+
+        Example:
+        .. code-block:: python
+
+            # If working with agent executor
+            agent.agent.save(file_path="path/agent.yaml")
+        """
+        # Convert file to Path object.
+        if isinstance(file_path, str):
+            save_path = Path(file_path)
+        else:
+            save_path = file_path
+
+        # Fetch dictionary to save
+        agent_dict = self.dict()
+        if "_type" not in agent_dict:
+            raise NotImplementedError(f"Agent {self} does not support saving.")
+
+        directory_path = save_path.parent
+        directory_path.mkdir(parents=True, exist_ok=True)
+
+        if save_path.suffix == ".json":
+            with open(file_path, "w") as f:
+                json.dump(agent_dict, f, indent=4)
+        elif save_path.suffix.endswith((".yaml", ".yml")):
+            with open(file_path, "w") as f:
+                yaml.dump(agent_dict, f, default_flow_style=False)
+        else:
+            raise ValueError(f"{save_path} must be json or yaml")
+
+    def tool_run_logging_kwargs(self) -> Dict:
+        return {}
+
+
+class AgentOutputParser(BaseOutputParser[Union[AgentAction, AgentFinish]]):
+    """Base class for parsing agent output into agent action/finish."""
+
+    @abstractmethod
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        """Parse text into agent action/finish."""
+
+
+class MultiActionAgentOutputParser(
+    BaseOutputParser[Union[List[AgentAction], AgentFinish]]
+):
+    """Base class for parsing agent output into agent actions/finish."""
+
+    @abstractmethod
+    def parse(self, text: str) -> Union[List[AgentAction], AgentFinish]:
+        """Parse text into agent actions/finish."""
+
+
+class RunnableAgent(BaseSingleActionAgent):
+    """Agent powered by runnables."""
+
+    runnable: Runnable[dict, Union[AgentAction, AgentFinish]]
+    """Runnable to call to get agent action."""
+    input_keys_arg: List[str] = []
+    return_keys_arg: List[str] = []
+    stream_runnable: bool = True
+    """Whether to stream from the runnable or not. 
+
+    If True then underlying LLM is invoked in a streaming fashion to make it possible 
+        to get access to the individual LLM tokens when using stream_log with the Agent 
+        Executor. If False then LLM is invoked in a non-streaming fashion and 
+        individual LLM tokens will not be available in stream_log.
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @property
+    def return_values(self) -> List[str]:
+        """Return values of the agent."""
+        return self.return_keys_arg
+
+    @property
+    def input_keys(self) -> List[str]:
+        return self.input_keys_arg
+
+    def plan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[AgentAction, AgentFinish]:
+        """Based on past history and current inputs, decide what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with the observations.
+            callbacks: Callbacks to run.
+            **kwargs: User inputs.
+
+        Returns:
+            Action specifying what tool to use.
+        """
+        inputs = {**kwargs, **{"intermediate_steps": intermediate_steps}}
+        final_output: Any = None
+        if self.stream_runnable:
+            # Use streaming to make sure that the underlying LLM is invoked in a
+            # streaming
+            # fashion to make it possible to get access to the individual LLM tokens
+            # when using stream_log with the Agent Executor.
+            # Because the response from the plan is not a generator, we need to
+            # accumulate the output into final output and return that.
+            for chunk in self.runnable.stream(inputs, config={"callbacks": callbacks}):
+                if final_output is None:
+                    final_output = chunk
+                else:
+                    final_output += chunk
+        else:
+            final_output = self.runnable.invoke(inputs, config={"callbacks": callbacks})
+
+        return final_output
+
+    async def aplan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[
+        AgentAction,
+        AgentFinish,
+    ]:
+        """Based on past history and current inputs, decide what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with observations
+            callbacks: Callbacks to run.
+            **kwargs: User inputs
+
+        Returns:
+            Action specifying what tool to use.
+        """
+        inputs = {**kwargs, **{"intermediate_steps": intermediate_steps}}
+        final_output: Any = None
+        if self.stream_runnable:
+            # Use streaming to make sure that the underlying LLM is invoked in a
+            # streaming
+            # fashion to make it possible to get access to the individual LLM tokens
+            # when using stream_log with the Agent Executor.
+            # Because the response from the plan is not a generator, we need to
+            # accumulate the output into final output and return that.
+            async for chunk in self.runnable.astream(
+                inputs, config={"callbacks": callbacks}
+            ):
+                if final_output is None:
+                    final_output = chunk
+                else:
+                    final_output += chunk
+        else:
+            final_output = await self.runnable.ainvoke(
+                inputs, config={"callbacks": callbacks}
+            )
+        return final_output
+
+
+class RunnableMultiActionAgent(BaseMultiActionAgent):
+    """Agent powered by runnables."""
+
+    runnable: Runnable[dict, Union[List[AgentAction], AgentFinish]]
+    """Runnable to call to get agent actions."""
+    input_keys_arg: List[str] = []
+    return_keys_arg: List[str] = []
+    stream_runnable: bool = True
+    """Whether to stream from the runnable or not. 
+    
+    If True then underlying LLM is invoked in a streaming fashion to make it possible 
+        to get access to the individual LLM tokens when using stream_log with the Agent 
+        Executor. If False then LLM is invoked in a non-streaming fashion and 
+        individual LLM tokens will not be available in stream_log.
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @property
+    def return_values(self) -> List[str]:
+        """Return values of the agent."""
+        return self.return_keys_arg
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the input keys.
+
+        Returns:
+            List of input keys.
+        """
+        return self.input_keys_arg
+
+    def plan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[
+        List[AgentAction],
+        AgentFinish,
+    ]:
+        """Based on past history and current inputs, decide what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with the observations.
+            callbacks: Callbacks to run.
+            **kwargs: User inputs.
+
+        Returns:
+            Action specifying what tool to use.
+        """
+        inputs = {**kwargs, **{"intermediate_steps": intermediate_steps}}
+        final_output: Any = None
+        if self.stream_runnable:
+            # Use streaming to make sure that the underlying LLM is invoked in a
+            # streaming
+            # fashion to make it possible to get access to the individual LLM tokens
+            # when using stream_log with the Agent Executor.
+            # Because the response from the plan is not a generator, we need to
+            # accumulate the output into final output and return that.
+            for chunk in self.runnable.stream(inputs, config={"callbacks": callbacks}):
+                if final_output is None:
+                    final_output = chunk
+                else:
+                    final_output += chunk
+        else:
+            final_output = self.runnable.invoke(inputs, config={"callbacks": callbacks})
+
+        return final_output
+
+    async def aplan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[
+        List[AgentAction],
+        AgentFinish,
+    ]:
+        """Based on past history and current inputs, decide what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with observations
+            callbacks: Callbacks to run.
+            **kwargs: User inputs.
+
+        Returns:
+            Action specifying what tool to use.
+        """
+        inputs = {**kwargs, **{"intermediate_steps": intermediate_steps}}
+        final_output: Any = None
+        if self.stream_runnable:
+            # Use streaming to make sure that the underlying LLM is invoked in a
+            # streaming
+            # fashion to make it possible to get access to the individual LLM tokens
+            # when using stream_log with the Agent Executor.
+            # Because the response from the plan is not a generator, we need to
+            # accumulate the output into final output and return that.
+            async for chunk in self.runnable.astream(
+                inputs, config={"callbacks": callbacks}
+            ):
+                if final_output is None:
+                    final_output = chunk
+                else:
+                    final_output += chunk
+        else:
+            final_output = await self.runnable.ainvoke(
+                inputs, config={"callbacks": callbacks}
+            )
+
+        return final_output
+
+
+@deprecated(
+    "0.1.0",
+    alternative=(
+        "Use new agent constructor methods like create_react_agent, create_json_agent, "
+        "create_structured_chat_agent, etc."
+    ),
+    removal="0.2.0",
+)
+class LLMSingleActionAgent(BaseSingleActionAgent):
+    """Base class for single action agents."""
+
+    llm_chain: LLMChain
+    """LLMChain to use for agent."""
+    output_parser: AgentOutputParser
+    """Output parser to use for agent."""
+    stop: List[str]
+    """List of strings to stop on."""
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the input keys.
+
+        Returns:
+            List of input keys.
+        """
+        return list(set(self.llm_chain.input_keys) - {"intermediate_steps"})
+
+    def dict(self, **kwargs: Any) -> Dict:
+        """Return dictionary representation of agent."""
+        _dict = super().dict()
+        del _dict["output_parser"]
+        return _dict
+
+    def plan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[AgentAction, AgentFinish]:
+        """Given input, decided what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with the observations.
+            callbacks: Callbacks to run.
+            **kwargs: User inputs.
+
+        Returns:
+            Action specifying what tool to use.
+        """
+        output = self.llm_chain.run(
+            intermediate_steps=intermediate_steps,
+            stop=self.stop,
+            callbacks=callbacks,
+            **kwargs,
+        )
+        return self.output_parser.parse(output)
+
+    async def aplan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[AgentAction, AgentFinish]:
+        """Given input, decided what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with observations
+            callbacks: Callbacks to run.
+            **kwargs: User inputs.
+
+        Returns:
+            Action specifying what tool to use.
+        """
+        output = await self.llm_chain.arun(
+            intermediate_steps=intermediate_steps,
+            stop=self.stop,
+            callbacks=callbacks,
+            **kwargs,
+        )
+        return self.output_parser.parse(output)
+
+    def tool_run_logging_kwargs(self) -> Dict:
+        return {
+            "llm_prefix": "",
+            "observation_prefix": "" if len(self.stop) == 0 else self.stop[0],
+        }
+
+
+@deprecated(
+    "0.1.0",
+    alternative=(
+        "Use new agent constructor methods like create_react_agent, create_json_agent, "
+        "create_structured_chat_agent, etc."
+    ),
+    removal="0.2.0",
+)
+class Agent(BaseSingleActionAgent):
+    """Agent that calls the language model and deciding the action.
+
+    This is driven by an LLMChain. The prompt in the LLMChain MUST include
+    a variable called "agent_scratchpad" where the agent can put its
+    intermediary work.
+    """
+
+    llm_chain: LLMChain
+    output_parser: AgentOutputParser
+    allowed_tools: Optional[List[str]] = None
+
+    def dict(self, **kwargs: Any) -> Dict:
+        """Return dictionary representation of agent."""
+        _dict = super().dict()
+        del _dict["output_parser"]
+        return _dict
+
+    def get_allowed_tools(self) -> Optional[List[str]]:
+        return self.allowed_tools
+
+    @property
+    def return_values(self) -> List[str]:
+        return ["output"]
+
+    def _fix_text(self, text: str) -> str:
+        """Fix the text."""
+        raise ValueError("fix_text not implemented for this agent.")
+
+    @property
+    def _stop(self) -> List[str]:
+        return [
+            f"\n{self.observation_prefix.rstrip()}",
+            f"\n\t{self.observation_prefix.rstrip()}",
+        ]
+
+    def _construct_scratchpad(
+        self, intermediate_steps: List[Tuple[AgentAction, str]]
+    ) -> Union[str, List[BaseMessage]]:
+        """Construct the scratchpad that lets the agent continue its thought process."""
+        thoughts = ""
+        for action, observation in intermediate_steps:
+            thoughts += action.log
+            thoughts += f"\n{self.observation_prefix}{observation}\n{self.llm_prefix}"
+        return thoughts
+
+    def plan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[AgentAction, AgentFinish]:
+        """Given input, decided what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with observations
+            callbacks: Callbacks to run.
+            **kwargs: User inputs.
+
+        Returns:
+            Action specifying what tool to use.
+        """
+        full_inputs = self.get_full_inputs(intermediate_steps, **kwargs)
+        full_output = self.llm_chain.predict(callbacks=callbacks, **full_inputs)
+        return self.output_parser.parse(full_output)
+
+    async def aplan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[AgentAction, AgentFinish]:
+        """Given input, decided what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with observations
+            callbacks: Callbacks to run.
+            **kwargs: User inputs.
+
+        Returns:
+            Action specifying what tool to use.
+        """
+        full_inputs = self.get_full_inputs(intermediate_steps, **kwargs)
+        full_output = await self.llm_chain.apredict(callbacks=callbacks, **full_inputs)
+        agent_output = await self.output_parser.aparse(full_output)
+        return agent_output
+
+    def get_full_inputs(
+        self, intermediate_steps: List[Tuple[AgentAction, str]], **kwargs: Any
+    ) -> Dict[str, Any]:
+        """Create the full inputs for the LLMChain from intermediate steps."""
+        thoughts = self._construct_scratchpad(intermediate_steps)
+        new_inputs = {"agent_scratchpad": thoughts, "stop": self._stop}
+        full_inputs = {**kwargs, **new_inputs}
+        return full_inputs
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the input keys.
+
+        :meta private:
+        """
+        return list(set(self.llm_chain.input_keys) - {"agent_scratchpad"})
+
+    @root_validator()
+    def validate_prompt(cls, values: Dict) -> Dict:
+        """Validate that prompt matches format."""
+        prompt = values["llm_chain"].prompt
+        if "agent_scratchpad" not in prompt.input_variables:
+            logger.warning(
+                "`agent_scratchpad` should be a variable in prompt.input_variables."
+                " Did not find it, so adding it at the end."
+            )
+            prompt.input_variables.append("agent_scratchpad")
+            if isinstance(prompt, PromptTemplate):
+                prompt.template += "\n{agent_scratchpad}"
+            elif isinstance(prompt, FewShotPromptTemplate):
+                prompt.suffix += "\n{agent_scratchpad}"
+            else:
+                raise ValueError(f"Got unexpected prompt type {type(prompt)}")
+        return values
+
+    @property
+    @abstractmethod
+    def observation_prefix(self) -> str:
+        """Prefix to append the observation with."""
+
+    @property
+    @abstractmethod
+    def llm_prefix(self) -> str:
+        """Prefix to append the LLM call with."""
+
+    @classmethod
+    @abstractmethod
+    def create_prompt(cls, tools: Sequence[BaseTool]) -> BasePromptTemplate:
+        """Create a prompt for this class."""
+
+    @classmethod
+    def _validate_tools(cls, tools: Sequence[BaseTool]) -> None:
+        """Validate that appropriate tools are passed in."""
+        pass
+
+    @classmethod
+    @abstractmethod
+    def _get_default_output_parser(cls, **kwargs: Any) -> AgentOutputParser:
+        """Get default output parser for this class."""
+
+    @classmethod
+    def from_llm_and_tools(
+        cls,
+        llm: BaseLanguageModel,
+        tools: Sequence[BaseTool],
+        callback_manager: Optional[BaseCallbackManager] = None,
+        output_parser: Optional[AgentOutputParser] = None,
+        **kwargs: Any,
+    ) -> Agent:
+        """Construct an agent from an LLM and tools."""
+        cls._validate_tools(tools)
+        llm_chain = LLMChain(
+            llm=llm,
+            prompt=cls.create_prompt(tools),
+            callback_manager=callback_manager,
+        )
+        tool_names = [tool.name for tool in tools]
+        _output_parser = output_parser or cls._get_default_output_parser()
+        return cls(
+            llm_chain=llm_chain,
+            allowed_tools=tool_names,
+            output_parser=_output_parser,
+            **kwargs,
+        )
+
+    def return_stopped_response(
+        self,
+        early_stopping_method: str,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        **kwargs: Any,
+    ) -> AgentFinish:
+        """Return response when agent has been stopped due to max iterations."""
+        if early_stopping_method == "force":
+            # `force` just returns a constant string
+            return AgentFinish(
+                {"output": "Agent stopped due to iteration limit or time limit."}, ""
+            )
+        elif early_stopping_method == "generate":
+            # Generate does one final forward pass
+            thoughts = ""
+            for action, observation in intermediate_steps:
+                thoughts += action.log
+                thoughts += (
+                    f"\n{self.observation_prefix}{observation}\n{self.llm_prefix}"
+                )
+            # Adding to the previous steps, we now tell the LLM to make a final pred
+            thoughts += (
+                "\n\nI now need to return a final answer based on the previous steps:"
+            )
+            new_inputs = {"agent_scratchpad": thoughts, "stop": self._stop}
+            full_inputs = {**kwargs, **new_inputs}
+            full_output = self.llm_chain.predict(**full_inputs)
+            # We try to extract a final answer
+            parsed_output = self.output_parser.parse(full_output)
+            if isinstance(parsed_output, AgentFinish):
+                # If we can extract, we send the correct stuff
+                return parsed_output
+            else:
+                # If we can extract, but the tool is not the final tool,
+                # we just return the full output
+                return AgentFinish({"output": full_output}, full_output)
+        else:
+            raise ValueError(
+                "early_stopping_method should be one of `force` or `generate`, "
+                f"got {early_stopping_method}"
+            )
+
+    def tool_run_logging_kwargs(self) -> Dict:
+        return {
+            "llm_prefix": self.llm_prefix,
+            "observation_prefix": self.observation_prefix,
+        }
+
+
+class ExceptionTool(BaseTool):
+    """Tool that just returns the query."""
+
+    name: str = "_Exception"
+    """Name of the tool."""
+    description: str = "Exception tool"
+    """Description of the tool."""
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        return query
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        return query
+
+
+NextStepOutput = List[Union[AgentFinish, AgentAction, AgentStep]]
+
+
+class AgentExecutor(Chain):
+    """Agent that is using tools."""
+
+    agent: Union[BaseSingleActionAgent, BaseMultiActionAgent]
+    """The agent to run for creating a plan and determining actions
+    to take at each step of the execution loop."""
+    tools: Sequence[BaseTool]
+    """The valid tools the agent can call."""
+    return_intermediate_steps: bool = False
+    """Whether to return the agent's trajectory of intermediate steps
+    at the end in addition to the final output."""
+    max_iterations: Optional[int] = 15
+    """The maximum number of steps to take before ending the execution
+    loop.
+    
+    Setting to 'None' could lead to an infinite loop."""
+    max_execution_time: Optional[float] = None
+    """The maximum amount of wall clock time to spend in the execution
+    loop.
+    """
+    early_stopping_method: str = "force"
+    """The method to use for early stopping if the agent never
+    returns `AgentFinish`. Either 'force' or 'generate'.
+
+    `"force"` returns a string saying that it stopped because it met a
+        time or iteration limit.
+    
+    `"generate"` calls the agent's LLM Chain one final time to generate
+        a final answer based on the previous steps.
+    """
+    handle_parsing_errors: Union[
+        bool, str, Callable[[OutputParserException], str]
+    ] = False
+    """How to handle errors raised by the agent's output parser.
+    Defaults to `False`, which raises the error.
+    If `true`, the error will be sent back to the LLM as an observation.
+    If a string, the string itself will be sent to the LLM as an observation.
+    If a callable function, the function will be called with the exception
+     as an argument, and the result of that function will be passed to the agent
+      as an observation.
+    """
+    trim_intermediate_steps: Union[
+        int, Callable[[List[Tuple[AgentAction, str]]], List[Tuple[AgentAction, str]]]
+    ] = -1
+
+    @classmethod
+    def from_agent_and_tools(
+        cls,
+        agent: Union[BaseSingleActionAgent, BaseMultiActionAgent],
+        tools: Sequence[BaseTool],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> AgentExecutor:
+        """Create from agent and tools."""
+        return cls(
+            agent=agent,
+            tools=tools,
+            callbacks=callbacks,
+            **kwargs,
+        )
+
+    @root_validator()
+    def validate_tools(cls, values: Dict) -> Dict:
+        """Validate that tools are compatible with agent."""
+        agent = values["agent"]
+        tools = values["tools"]
+        allowed_tools = agent.get_allowed_tools()
+        if allowed_tools is not None:
+            if set(allowed_tools) != set([tool.name for tool in tools]):
+                raise ValueError(
+                    f"Allowed tools ({allowed_tools}) different than "
+                    f"provided tools ({[tool.name for tool in tools]})"
+                )
+        return values
+
+    @root_validator()
+    def validate_return_direct_tool(cls, values: Dict) -> Dict:
+        """Validate that tools are compatible with agent."""
+        agent = values["agent"]
+        tools = values["tools"]
+        if isinstance(agent, BaseMultiActionAgent):
+            for tool in tools:
+                if tool.return_direct:
+                    raise ValueError(
+                        "Tools that have `return_direct=True` are not allowed "
+                        "in multi-action agents"
+                    )
+        return values
+
+    @root_validator(pre=True)
+    def validate_runnable_agent(cls, values: Dict) -> Dict:
+        """Convert runnable to agent if passed in."""
+        agent = values["agent"]
+        if isinstance(agent, Runnable):
+            try:
+                output_type = agent.OutputType
+            except Exception as _:
+                multi_action = False
+            else:
+                multi_action = output_type == Union[List[AgentAction], AgentFinish]
+
+            stream_runnable = values.pop("stream_runnable", True)
+            if multi_action:
+                values["agent"] = RunnableMultiActionAgent(
+                    runnable=agent, stream_runnable=stream_runnable
+                )
+            else:
+                values["agent"] = RunnableAgent(
+                    runnable=agent, stream_runnable=stream_runnable
+                )
+        return values
+
+    def save(self, file_path: Union[Path, str]) -> None:
+        """Raise error - saving not supported for Agent Executors."""
+        raise ValueError(
+            "Saving not supported for agent executors. "
+            "If you are trying to save the agent, please use the "
+            "`.save_agent(...)`"
+        )
+
+    def save_agent(self, file_path: Union[Path, str]) -> None:
+        """Save the underlying agent."""
+        return self.agent.save(file_path)
+
+    def iter(
+        self,
+        inputs: Any,
+        callbacks: Callbacks = None,
+        *,
+        include_run_info: bool = False,
+        async_: bool = False,  # arg kept for backwards compat, but ignored
+    ) -> AgentExecutorIterator:
+        """Enables iteration over steps taken to reach final output."""
+        return AgentExecutorIterator(
+            self,
+            inputs,
+            callbacks,
+            tags=self.tags,
+            include_run_info=include_run_info,
+        )
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the input keys.
+
+        :meta private:
+        """
+        return self.agent.input_keys
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return the singular output key.
+
+        :meta private:
+        """
+        if self.return_intermediate_steps:
+            return self.agent.return_values + ["intermediate_steps"]
+        else:
+            return self.agent.return_values
+
+    def lookup_tool(self, name: str) -> BaseTool:
+        """Lookup tool by name."""
+        return {tool.name: tool for tool in self.tools}[name]
+
+    def _should_continue(self, iterations: int, time_elapsed: float) -> bool:
+        if self.max_iterations is not None and iterations >= self.max_iterations:
+            return False
+        if (
+            self.max_execution_time is not None
+            and time_elapsed >= self.max_execution_time
+        ):
+            return False
+
+        return True
+
+    def _return(
+        self,
+        output: AgentFinish,
+        intermediate_steps: list,
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        if run_manager:
+            run_manager.on_agent_finish(output, color="green", verbose=self.verbose)
+        final_output = output.return_values
+        if self.return_intermediate_steps:
+            final_output["intermediate_steps"] = intermediate_steps
+        return final_output
+
+    async def _areturn(
+        self,
+        output: AgentFinish,
+        intermediate_steps: list,
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        if run_manager:
+            await run_manager.on_agent_finish(
+                output, color="green", verbose=self.verbose
+            )
+        final_output = output.return_values
+        if self.return_intermediate_steps:
+            final_output["intermediate_steps"] = intermediate_steps
+        return final_output
+
+    def _consume_next_step(
+        self, values: NextStepOutput
+    ) -> Union[AgentFinish, List[Tuple[AgentAction, str]]]:
+        if isinstance(values[-1], AgentFinish):
+            assert len(values) == 1
+            return values[-1]
+        else:
+            return [
+                (a.action, a.observation) for a in values if isinstance(a, AgentStep)
+            ]
+
+    def _take_next_step(
+        self,
+        name_to_tool_map: Dict[str, BaseTool],
+        color_mapping: Dict[str, str],
+        inputs: Dict[str, str],
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Union[AgentFinish, List[Tuple[AgentAction, str]]]:
+        return self._consume_next_step(
+            [
+                a
+                for a in self._iter_next_step(
+                    name_to_tool_map,
+                    color_mapping,
+                    inputs,
+                    intermediate_steps,
+                    run_manager,
+                )
+            ]
+        )
+
+    def _iter_next_step(
+        self,
+        name_to_tool_map: Dict[str, BaseTool],
+        color_mapping: Dict[str, str],
+        inputs: Dict[str, str],
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Iterator[Union[AgentFinish, AgentAction, AgentStep]]:
+        """Take a single step in the thought-action-observation loop.
+
+        Override this to take control of how the agent makes and acts on choices.
+        """
+        try:
+            intermediate_steps = self._prepare_intermediate_steps(intermediate_steps)
+
+            # Call the LLM to see what to do.
+            output = self.agent.plan(
+                intermediate_steps,
+                callbacks=run_manager.get_child() if run_manager else None,
+                **inputs,
+            )
+        except OutputParserException as e:
+            if isinstance(self.handle_parsing_errors, bool):
+                raise_error = not self.handle_parsing_errors
+            else:
+                raise_error = False
+            if raise_error:
+                raise ValueError(
+                    "An output parsing error occurred. "
+                    "In order to pass this error back to the agent and have it try "
+                    "again, pass `handle_parsing_errors=True` to the AgentExecutor. "
+                    f"This is the error: {str(e)}"
+                )
+            text = str(e)
+            if isinstance(self.handle_parsing_errors, bool):
+                if e.send_to_llm:
+                    observation = str(e.observation)
+                    text = str(e.llm_output)
+                else:
+                    observation = "Invalid or incomplete response"
+            elif isinstance(self.handle_parsing_errors, str):
+                observation = self.handle_parsing_errors
+            elif callable(self.handle_parsing_errors):
+                observation = self.handle_parsing_errors(e)
+            else:
+                raise ValueError("Got unexpected type of `handle_parsing_errors`")
+            output = AgentAction("_Exception", observation, text)
+            if run_manager:
+                run_manager.on_agent_action(output, color="green")
+            tool_run_kwargs = self.agent.tool_run_logging_kwargs()
+            observation = ExceptionTool().run(
+                output.tool_input,
+                verbose=self.verbose,
+                color=None,
+                callbacks=run_manager.get_child() if run_manager else None,
+                **tool_run_kwargs,
+            )
+            yield AgentStep(action=output, observation=observation)
+            return
+
+        # If the tool chosen is the finishing tool, then we end and return.
+        if isinstance(output, AgentFinish):
+            yield output
+            return
+
+        actions: List[AgentAction]
+        if isinstance(output, AgentAction):
+            actions = [output]
+        else:
+            actions = output
+        for agent_action in actions:
+            yield agent_action
+        for agent_action in actions:
+            yield self._perform_agent_action(
+                name_to_tool_map, color_mapping, agent_action, run_manager
+            )
+
+    def _perform_agent_action(
+        self,
+        name_to_tool_map: Dict[str, BaseTool],
+        color_mapping: Dict[str, str],
+        agent_action: AgentAction,
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> AgentStep:
+        if run_manager:
+            run_manager.on_agent_action(agent_action, color="green")
+        # Otherwise we lookup the tool
+        if agent_action.tool in name_to_tool_map:
+            tool = name_to_tool_map[agent_action.tool]
+            return_direct = tool.return_direct
+            color = color_mapping[agent_action.tool]
+            tool_run_kwargs = self.agent.tool_run_logging_kwargs()
+            if return_direct:
+                tool_run_kwargs["llm_prefix"] = ""
+            # We then call the tool on the tool input to get an observation
+            observation = tool.run(
+                agent_action.tool_input,
+                verbose=self.verbose,
+                color=color,
+                callbacks=run_manager.get_child() if run_manager else None,
+                **tool_run_kwargs,
+            )
+        else:
+            tool_run_kwargs = self.agent.tool_run_logging_kwargs()
+            observation = InvalidTool().run(
+                {
+                    "requested_tool_name": agent_action.tool,
+                    "available_tool_names": list(name_to_tool_map.keys()),
+                },
+                verbose=self.verbose,
+                color=None,
+                callbacks=run_manager.get_child() if run_manager else None,
+                **tool_run_kwargs,
+            )
+        return AgentStep(action=agent_action, observation=observation)
+
+    async def _atake_next_step(
+        self,
+        name_to_tool_map: Dict[str, BaseTool],
+        color_mapping: Dict[str, str],
+        inputs: Dict[str, str],
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Union[AgentFinish, List[Tuple[AgentAction, str]]]:
+        return self._consume_next_step(
+            [
+                a
+                async for a in self._aiter_next_step(
+                    name_to_tool_map,
+                    color_mapping,
+                    inputs,
+                    intermediate_steps,
+                    run_manager,
+                )
+            ]
+        )
+
+    async def _aiter_next_step(
+        self,
+        name_to_tool_map: Dict[str, BaseTool],
+        color_mapping: Dict[str, str],
+        inputs: Dict[str, str],
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> AsyncIterator[Union[AgentFinish, AgentAction, AgentStep]]:
+        """Take a single step in the thought-action-observation loop.
+
+        Override this to take control of how the agent makes and acts on choices.
+        """
+        try:
+            intermediate_steps = self._prepare_intermediate_steps(intermediate_steps)
+
+            # Call the LLM to see what to do.
+            output = await self.agent.aplan(
+                intermediate_steps,
+                callbacks=run_manager.get_child() if run_manager else None,
+                **inputs,
+            )
+        except OutputParserException as e:
+            if isinstance(self.handle_parsing_errors, bool):
+                raise_error = not self.handle_parsing_errors
+            else:
+                raise_error = False
+            if raise_error:
+                raise ValueError(
+                    "An output parsing error occurred. "
+                    "In order to pass this error back to the agent and have it try "
+                    "again, pass `handle_parsing_errors=True` to the AgentExecutor. "
+                    f"This is the error: {str(e)}"
+                )
+            text = str(e)
+            if isinstance(self.handle_parsing_errors, bool):
+                if e.send_to_llm:
+                    observation = str(e.observation)
+                    text = str(e.llm_output)
+                else:
+                    observation = "Invalid or incomplete response"
+            elif isinstance(self.handle_parsing_errors, str):
+                observation = self.handle_parsing_errors
+            elif callable(self.handle_parsing_errors):
+                observation = self.handle_parsing_errors(e)
+            else:
+                raise ValueError("Got unexpected type of `handle_parsing_errors`")
+            output = AgentAction("_Exception", observation, text)
+            tool_run_kwargs = self.agent.tool_run_logging_kwargs()
+            observation = await ExceptionTool().arun(
+                output.tool_input,
+                verbose=self.verbose,
+                color=None,
+                callbacks=run_manager.get_child() if run_manager else None,
+                **tool_run_kwargs,
+            )
+            yield AgentStep(action=output, observation=observation)
+            return
+
+        # If the tool chosen is the finishing tool, then we end and return.
+        if isinstance(output, AgentFinish):
+            yield output
+            return
+
+        actions: List[AgentAction]
+        if isinstance(output, AgentAction):
+            actions = [output]
+        else:
+            actions = output
+        for agent_action in actions:
+            yield agent_action
+
+        # Use asyncio.gather to run multiple tool.arun() calls concurrently
+        result = await asyncio.gather(
+            *[
+                self._aperform_agent_action(
+                    name_to_tool_map, color_mapping, agent_action, run_manager
+                )
+                for agent_action in actions
+            ],
+        )
+
+        # TODO This could yield each result as it becomes available
+        for chunk in result:
+            yield chunk
+
+    async def _aperform_agent_action(
+        self,
+        name_to_tool_map: Dict[str, BaseTool],
+        color_mapping: Dict[str, str],
+        agent_action: AgentAction,
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> AgentStep:
+        if run_manager:
+            await run_manager.on_agent_action(
+                agent_action, verbose=self.verbose, color="green"
+            )
+        # Otherwise we lookup the tool
+        if agent_action.tool in name_to_tool_map:
+            tool = name_to_tool_map[agent_action.tool]
+            return_direct = tool.return_direct
+            color = color_mapping[agent_action.tool]
+            tool_run_kwargs = self.agent.tool_run_logging_kwargs()
+            if return_direct:
+                tool_run_kwargs["llm_prefix"] = ""
+            # We then call the tool on the tool input to get an observation
+            observation = await tool.arun(
+                agent_action.tool_input,
+                verbose=self.verbose,
+                color=color,
+                callbacks=run_manager.get_child() if run_manager else None,
+                **tool_run_kwargs,
+            )
+        else:
+            tool_run_kwargs = self.agent.tool_run_logging_kwargs()
+            observation = await InvalidTool().arun(
+                {
+                    "requested_tool_name": agent_action.tool,
+                    "available_tool_names": list(name_to_tool_map.keys()),
+                },
+                verbose=self.verbose,
+                color=None,
+                callbacks=run_manager.get_child() if run_manager else None,
+                **tool_run_kwargs,
+            )
+        return AgentStep(action=agent_action, observation=observation)
+
+    def _call(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Run text through and get agent response."""
+        # Construct a mapping of tool name to tool for easy lookup
+        name_to_tool_map = {tool.name: tool for tool in self.tools}
+        # We construct a mapping from each tool to a color, used for logging.
+        color_mapping = get_color_mapping(
+            [tool.name for tool in self.tools], excluded_colors=["green", "red"]
+        )
+        intermediate_steps: List[Tuple[AgentAction, str]] = []
+        # Let's start tracking the number of iterations and time elapsed
+        iterations = 0
+        time_elapsed = 0.0
+        start_time = time.time()
+        # We now enter the agent loop (until it returns something).
+        while self._should_continue(iterations, time_elapsed):
+            next_step_output = self._take_next_step(
+                name_to_tool_map,
+                color_mapping,
+                inputs,
+                intermediate_steps,
+                run_manager=run_manager,
+            )
+            if isinstance(next_step_output, AgentFinish):
+                return self._return(
+                    next_step_output, intermediate_steps, run_manager=run_manager
+                )
+
+            intermediate_steps.extend(next_step_output)
+            if len(next_step_output) == 1:
+                next_step_action = next_step_output[0]
+                # See if tool should return directly
+                tool_return = self._get_tool_return(next_step_action)
+                if tool_return is not None:
+                    return self._return(
+                        tool_return, intermediate_steps, run_manager=run_manager
+                    )
+            iterations += 1
+            time_elapsed = time.time() - start_time
+        output = self.agent.return_stopped_response(
+            self.early_stopping_method, intermediate_steps, **inputs
+        )
+        return self._return(output, intermediate_steps, run_manager=run_manager)
+
+    async def _acall(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        """Run text through and get agent response."""
+        # Construct a mapping of tool name to tool for easy lookup
+        name_to_tool_map = {tool.name: tool for tool in self.tools}
+        # We construct a mapping from each tool to a color, used for logging.
+        color_mapping = get_color_mapping(
+            [tool.name for tool in self.tools], excluded_colors=["green"]
+        )
+        intermediate_steps: List[Tuple[AgentAction, str]] = []
+        # Let's start tracking the number of iterations and time elapsed
+        iterations = 0
+        time_elapsed = 0.0
+        start_time = time.time()
+        # We now enter the agent loop (until it returns something).
+        try:
+            async with asyncio_timeout(self.max_execution_time):
+                while self._should_continue(iterations, time_elapsed):
+                    next_step_output = await self._atake_next_step(
+                        name_to_tool_map,
+                        color_mapping,
+                        inputs,
+                        intermediate_steps,
+                        run_manager=run_manager,
+                    )
+                    if isinstance(next_step_output, AgentFinish):
+                        return await self._areturn(
+                            next_step_output,
+                            intermediate_steps,
+                            run_manager=run_manager,
+                        )
+
+                    intermediate_steps.extend(next_step_output)
+                    if len(next_step_output) == 1:
+                        next_step_action = next_step_output[0]
+                        # See if tool should return directly
+                        tool_return = self._get_tool_return(next_step_action)
+                        if tool_return is not None:
+                            return await self._areturn(
+                                tool_return, intermediate_steps, run_manager=run_manager
+                            )
+
+                    iterations += 1
+                    time_elapsed = time.time() - start_time
+                output = self.agent.return_stopped_response(
+                    self.early_stopping_method, intermediate_steps, **inputs
+                )
+                return await self._areturn(
+                    output, intermediate_steps, run_manager=run_manager
+                )
+        except (TimeoutError, asyncio.TimeoutError):
+            # stop early when interrupted by the async timeout
+            output = self.agent.return_stopped_response(
+                self.early_stopping_method, intermediate_steps, **inputs
+            )
+            return await self._areturn(
+                output, intermediate_steps, run_manager=run_manager
+            )
+
+    def _get_tool_return(
+        self, next_step_output: Tuple[AgentAction, str]
+    ) -> Optional[AgentFinish]:
+        """Check if the tool is a returning tool."""
+        agent_action, observation = next_step_output
+        name_to_tool_map = {tool.name: tool for tool in self.tools}
+        return_value_key = "output"
+        if len(self.agent.return_values) > 0:
+            return_value_key = self.agent.return_values[0]
+        # Invalid tools won't be in the map, so we return False.
+        if agent_action.tool in name_to_tool_map:
+            if name_to_tool_map[agent_action.tool].return_direct:
+                return AgentFinish(
+                    {return_value_key: observation},
+                    "",
+                )
+        return None
+
+    def _prepare_intermediate_steps(
+        self, intermediate_steps: List[Tuple[AgentAction, str]]
+    ) -> List[Tuple[AgentAction, str]]:
+        if (
+            isinstance(self.trim_intermediate_steps, int)
+            and self.trim_intermediate_steps > 0
+        ):
+            return intermediate_steps[-self.trim_intermediate_steps :]
+        elif callable(self.trim_intermediate_steps):
+            return self.trim_intermediate_steps(intermediate_steps)
+        else:
+            return intermediate_steps
+
+    def stream(
+        self,
+        input: Union[Dict[str, Any], Any],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Iterator[AddableDict]:
+        """Enables streaming over steps taken to reach final output."""
+        config = ensure_config(config)
+        iterator = AgentExecutorIterator(
+            self,
+            input,
+            config.get("callbacks"),
+            tags=config.get("tags"),
+            metadata=config.get("metadata"),
+            run_name=config.get("run_name"),
+            yield_actions=True,
+            **kwargs,
+        )
+        for step in iterator:
+            yield step
+
+    async def astream(
+        self,
+        input: Union[Dict[str, Any], Any],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[AddableDict]:
+        """Enables streaming over steps taken to reach final output."""
+        config = ensure_config(config)
+        iterator = AgentExecutorIterator(
+            self,
+            input,
+            config.get("callbacks"),
+            tags=config.get("tags"),
+            metadata=config.get("metadata"),
+            run_name=config.get("run_name"),
+            yield_actions=True,
+            **kwargs,
+        )
+        async for step in iterator:
+            yield step
diff --git a/llm/Lib/site-packages/langchain/agents/agent_iterator.py b/llm/Lib/site-packages/langchain/agents/agent_iterator.py
new file mode 100644
index 0000000000000000000000000000000000000000..12c995f2e97080834bb1d49fce1de1a642dd9b8a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_iterator.py
@@ -0,0 +1,392 @@
+from __future__ import annotations
+
+import asyncio
+import logging
+import time
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+    Tuple,
+    Union,
+)
+
+from langchain_core.agents import (
+    AgentAction,
+    AgentFinish,
+    AgentStep,
+)
+from langchain_core.callbacks import (
+    AsyncCallbackManager,
+    AsyncCallbackManagerForChainRun,
+    CallbackManager,
+    CallbackManagerForChainRun,
+    Callbacks,
+)
+from langchain_core.load.dump import dumpd
+from langchain_core.outputs import RunInfo
+from langchain_core.runnables.utils import AddableDict
+from langchain_core.tools import BaseTool
+from langchain_core.utils.input import get_color_mapping
+
+from langchain.schema import RUN_KEY
+from langchain.utilities.asyncio import asyncio_timeout
+
+if TYPE_CHECKING:
+    from langchain.agents.agent import AgentExecutor, NextStepOutput
+
+logger = logging.getLogger(__name__)
+
+
+class AgentExecutorIterator:
+    """Iterator for AgentExecutor."""
+
+    def __init__(
+        self,
+        agent_executor: AgentExecutor,
+        inputs: Any,
+        callbacks: Callbacks = None,
+        *,
+        tags: Optional[list[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        run_name: Optional[str] = None,
+        include_run_info: bool = False,
+        yield_actions: bool = False,
+    ):
+        """
+        Initialize the AgentExecutorIterator with the given AgentExecutor,
+        inputs, and optional callbacks.
+        """
+        self._agent_executor = agent_executor
+        self.inputs = inputs
+        self.callbacks = callbacks
+        self.tags = tags
+        self.metadata = metadata
+        self.run_name = run_name
+        self.include_run_info = include_run_info
+        self.yield_actions = yield_actions
+        self.reset()
+
+    _inputs: Dict[str, str]
+    callbacks: Callbacks
+    tags: Optional[list[str]]
+    metadata: Optional[Dict[str, Any]]
+    run_name: Optional[str]
+    include_run_info: bool
+    yield_actions: bool
+
+    @property
+    def inputs(self) -> Dict[str, str]:
+        return self._inputs
+
+    @inputs.setter
+    def inputs(self, inputs: Any) -> None:
+        self._inputs = self.agent_executor.prep_inputs(inputs)
+
+    @property
+    def agent_executor(self) -> AgentExecutor:
+        return self._agent_executor
+
+    @agent_executor.setter
+    def agent_executor(self, agent_executor: AgentExecutor) -> None:
+        self._agent_executor = agent_executor
+        # force re-prep inputs in case agent_executor's prep_inputs fn changed
+        self.inputs = self.inputs
+
+    @property
+    def name_to_tool_map(self) -> Dict[str, BaseTool]:
+        return {tool.name: tool for tool in self.agent_executor.tools}
+
+    @property
+    def color_mapping(self) -> Dict[str, str]:
+        return get_color_mapping(
+            [tool.name for tool in self.agent_executor.tools],
+            excluded_colors=["green", "red"],
+        )
+
+    def reset(self) -> None:
+        """
+        Reset the iterator to its initial state, clearing intermediate steps,
+        iterations, and time elapsed.
+        """
+        logger.debug("(Re)setting AgentExecutorIterator to fresh state")
+        self.intermediate_steps: list[tuple[AgentAction, str]] = []
+        self.iterations = 0
+        # maybe better to start these on the first __anext__ call?
+        self.time_elapsed = 0.0
+        self.start_time = time.time()
+
+    def update_iterations(self) -> None:
+        """
+        Increment the number of iterations and update the time elapsed.
+        """
+        self.iterations += 1
+        self.time_elapsed = time.time() - self.start_time
+        logger.debug(
+            f"Agent Iterations: {self.iterations} ({self.time_elapsed:.2f}s elapsed)"
+        )
+
+    def make_final_outputs(
+        self,
+        outputs: Dict[str, Any],
+        run_manager: Union[CallbackManagerForChainRun, AsyncCallbackManagerForChainRun],
+    ) -> AddableDict:
+        # have access to intermediate steps by design in iterator,
+        # so return only outputs may as well always be true.
+
+        prepared_outputs = AddableDict(
+            self.agent_executor.prep_outputs(
+                self.inputs, outputs, return_only_outputs=True
+            )
+        )
+        if self.include_run_info:
+            prepared_outputs[RUN_KEY] = RunInfo(run_id=run_manager.run_id)
+        return prepared_outputs
+
+    def __iter__(self: "AgentExecutorIterator") -> Iterator[AddableDict]:
+        logger.debug("Initialising AgentExecutorIterator")
+        self.reset()
+        callback_manager = CallbackManager.configure(
+            self.callbacks,
+            self.agent_executor.callbacks,
+            self.agent_executor.verbose,
+            self.tags,
+            self.agent_executor.tags,
+            self.metadata,
+            self.agent_executor.metadata,
+        )
+        run_manager = callback_manager.on_chain_start(
+            dumpd(self.agent_executor),
+            self.inputs,
+            name=self.run_name,
+        )
+        try:
+            while self.agent_executor._should_continue(
+                self.iterations, self.time_elapsed
+            ):
+                # take the next step: this plans next action, executes it,
+                # yielding action and observation as they are generated
+                next_step_seq: NextStepOutput = []
+                for chunk in self.agent_executor._iter_next_step(
+                    self.name_to_tool_map,
+                    self.color_mapping,
+                    self.inputs,
+                    self.intermediate_steps,
+                    run_manager,
+                ):
+                    next_step_seq.append(chunk)
+                    # if we're yielding actions, yield them as they come
+                    # do not yield AgentFinish, which will be handled below
+                    if self.yield_actions:
+                        if isinstance(chunk, AgentAction):
+                            yield AddableDict(actions=[chunk], messages=chunk.messages)
+                        elif isinstance(chunk, AgentStep):
+                            yield AddableDict(steps=[chunk], messages=chunk.messages)
+
+                # convert iterator output to format handled by _process_next_step_output
+                next_step = self.agent_executor._consume_next_step(next_step_seq)
+                # update iterations and time elapsed
+                self.update_iterations()
+                # decide if this is the final output
+                output = self._process_next_step_output(next_step, run_manager)
+                is_final = "intermediate_step" not in output
+                # yield the final output always
+                # for backwards compat, yield int. output if not yielding actions
+                if not self.yield_actions or is_final:
+                    yield output
+                # if final output reached, stop iteration
+                if is_final:
+                    return
+        except BaseException as e:
+            run_manager.on_chain_error(e)
+            raise
+
+        # if we got here means we exhausted iterations or time
+        yield self._stop(run_manager)
+
+    async def __aiter__(self) -> AsyncIterator[AddableDict]:
+        """
+        N.B. __aiter__ must be a normal method, so need to initialize async run manager
+        on first __anext__ call where we can await it
+        """
+        logger.debug("Initialising AgentExecutorIterator (async)")
+        self.reset()
+        callback_manager = AsyncCallbackManager.configure(
+            self.callbacks,
+            self.agent_executor.callbacks,
+            self.agent_executor.verbose,
+            self.tags,
+            self.agent_executor.tags,
+            self.metadata,
+            self.agent_executor.metadata,
+        )
+        run_manager = await callback_manager.on_chain_start(
+            dumpd(self.agent_executor),
+            self.inputs,
+            name=self.run_name,
+        )
+        try:
+            async with asyncio_timeout(self.agent_executor.max_execution_time):
+                while self.agent_executor._should_continue(
+                    self.iterations, self.time_elapsed
+                ):
+                    # take the next step: this plans next action, executes it,
+                    # yielding action and observation as they are generated
+                    next_step_seq: NextStepOutput = []
+                    async for chunk in self.agent_executor._aiter_next_step(
+                        self.name_to_tool_map,
+                        self.color_mapping,
+                        self.inputs,
+                        self.intermediate_steps,
+                        run_manager,
+                    ):
+                        next_step_seq.append(chunk)
+                        # if we're yielding actions, yield them as they come
+                        # do not yield AgentFinish, which will be handled below
+                        if self.yield_actions:
+                            if isinstance(chunk, AgentAction):
+                                yield AddableDict(
+                                    actions=[chunk], messages=chunk.messages
+                                )
+                            elif isinstance(chunk, AgentStep):
+                                yield AddableDict(
+                                    steps=[chunk], messages=chunk.messages
+                                )
+
+                    # convert iterator output to format handled by _process_next_step
+                    next_step = self.agent_executor._consume_next_step(next_step_seq)
+                    # update iterations and time elapsed
+                    self.update_iterations()
+                    # decide if this is the final output
+                    output = await self._aprocess_next_step_output(
+                        next_step, run_manager
+                    )
+                    is_final = "intermediate_step" not in output
+                    # yield the final output always
+                    # for backwards compat, yield int. output if not yielding actions
+                    if not self.yield_actions or is_final:
+                        yield output
+                    # if final output reached, stop iteration
+                    if is_final:
+                        return
+        except (TimeoutError, asyncio.TimeoutError):
+            yield await self._astop(run_manager)
+            return
+        except BaseException as e:
+            await run_manager.on_chain_error(e)
+            raise
+
+        # if we got here means we exhausted iterations or time
+        yield await self._astop(run_manager)
+
+    def _process_next_step_output(
+        self,
+        next_step_output: Union[AgentFinish, List[Tuple[AgentAction, str]]],
+        run_manager: CallbackManagerForChainRun,
+    ) -> AddableDict:
+        """
+        Process the output of the next step,
+        handling AgentFinish and tool return cases.
+        """
+        logger.debug("Processing output of Agent loop step")
+        if isinstance(next_step_output, AgentFinish):
+            logger.debug(
+                "Hit AgentFinish: _return -> on_chain_end -> run final output logic"
+            )
+            return self._return(next_step_output, run_manager=run_manager)
+
+        self.intermediate_steps.extend(next_step_output)
+        logger.debug("Updated intermediate_steps with step output")
+
+        # Check for tool return
+        if len(next_step_output) == 1:
+            next_step_action = next_step_output[0]
+            tool_return = self.agent_executor._get_tool_return(next_step_action)
+            if tool_return is not None:
+                return self._return(tool_return, run_manager=run_manager)
+
+        return AddableDict(intermediate_step=next_step_output)
+
+    async def _aprocess_next_step_output(
+        self,
+        next_step_output: Union[AgentFinish, List[Tuple[AgentAction, str]]],
+        run_manager: AsyncCallbackManagerForChainRun,
+    ) -> AddableDict:
+        """
+        Process the output of the next async step,
+        handling AgentFinish and tool return cases.
+        """
+        logger.debug("Processing output of async Agent loop step")
+        if isinstance(next_step_output, AgentFinish):
+            logger.debug(
+                "Hit AgentFinish: _areturn -> on_chain_end -> run final output logic"
+            )
+            return await self._areturn(next_step_output, run_manager=run_manager)
+
+        self.intermediate_steps.extend(next_step_output)
+        logger.debug("Updated intermediate_steps with step output")
+
+        # Check for tool return
+        if len(next_step_output) == 1:
+            next_step_action = next_step_output[0]
+            tool_return = self.agent_executor._get_tool_return(next_step_action)
+            if tool_return is not None:
+                return await self._areturn(tool_return, run_manager=run_manager)
+
+        return AddableDict(intermediate_step=next_step_output)
+
+    def _stop(self, run_manager: CallbackManagerForChainRun) -> AddableDict:
+        """
+        Stop the iterator and raise a StopIteration exception with the stopped response.
+        """
+        logger.warning("Stopping agent prematurely due to triggering stop condition")
+        # this manually constructs agent finish with output key
+        output = self.agent_executor.agent.return_stopped_response(
+            self.agent_executor.early_stopping_method,
+            self.intermediate_steps,
+            **self.inputs,
+        )
+        return self._return(output, run_manager=run_manager)
+
+    async def _astop(self, run_manager: AsyncCallbackManagerForChainRun) -> AddableDict:
+        """
+        Stop the async iterator and raise a StopAsyncIteration exception with
+        the stopped response.
+        """
+        logger.warning("Stopping agent prematurely due to triggering stop condition")
+        output = self.agent_executor.agent.return_stopped_response(
+            self.agent_executor.early_stopping_method,
+            self.intermediate_steps,
+            **self.inputs,
+        )
+        return await self._areturn(output, run_manager=run_manager)
+
+    def _return(
+        self, output: AgentFinish, run_manager: CallbackManagerForChainRun
+    ) -> AddableDict:
+        """
+        Return the final output of the iterator.
+        """
+        returned_output = self.agent_executor._return(
+            output, self.intermediate_steps, run_manager=run_manager
+        )
+        returned_output["messages"] = output.messages
+        run_manager.on_chain_end(returned_output)
+        return self.make_final_outputs(returned_output, run_manager)
+
+    async def _areturn(
+        self, output: AgentFinish, run_manager: AsyncCallbackManagerForChainRun
+    ) -> AddableDict:
+        """
+        Return the final output of the async iterator.
+        """
+        returned_output = await self.agent_executor._areturn(
+            output, self.intermediate_steps, run_manager=run_manager
+        )
+        returned_output["messages"] = output.messages
+        await run_manager.on_chain_end(returned_output)
+        return self.make_final_outputs(returned_output, run_manager)
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e718a66c311b728fb6ab84ccac8b28e0c234f939
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/__init__.py
@@ -0,0 +1,109 @@
+"""Agent toolkits contain integrations with various resources and services.
+
+LangChain has a large ecosystem of integrations with various external resources
+like local and remote file systems, APIs and databases.
+
+These integrations allow developers to create versatile applications that combine the
+power of LLMs with the ability to access, interact with and manipulate external
+resources.
+
+When developing an application, developers should inspect the capabilities and
+permissions of the tools that underlie the given agent toolkit, and determine
+whether permissions of the given toolkit are appropriate for the application.
+
+See [Security](https://python.langchain.com/docs/security) for more information.
+"""
+import warnings
+from pathlib import Path
+from typing import Any
+
+from langchain_core._api import LangChainDeprecationWarning
+from langchain_core._api.path import as_import_path
+
+from langchain.agents.agent_toolkits.conversational_retrieval.openai_functions import (
+    create_conversational_retrieval_agent,
+)
+from langchain.agents.agent_toolkits.vectorstore.base import (
+    create_vectorstore_agent,
+    create_vectorstore_router_agent,
+)
+from langchain.agents.agent_toolkits.vectorstore.toolkit import (
+    VectorStoreInfo,
+    VectorStoreRouterToolkit,
+    VectorStoreToolkit,
+)
+from langchain.tools.retriever import create_retriever_tool
+from langchain.utils.interactive_env import is_interactive_env
+
+DEPRECATED_AGENTS = [
+    "create_csv_agent",
+    "create_pandas_dataframe_agent",
+    "create_xorbits_agent",
+    "create_python_agent",
+    "create_spark_dataframe_agent",
+]
+
+
+def __getattr__(name: str) -> Any:
+    """Get attr name."""
+    if name in DEPRECATED_AGENTS:
+        relative_path = as_import_path(Path(__file__).parent, suffix=name)
+        old_path = "langchain." + relative_path
+        new_path = "langchain_experimental." + relative_path
+        raise ImportError(
+            f"{name} has been moved to langchain experimental. "
+            "See https://github.com/langchain-ai/langchain/discussions/11680"
+            "for more information.\n"
+            f"Please update your import statement from: `{old_path}` to `{new_path}`."
+        )
+
+    from langchain_community import agent_toolkits
+
+    # If not in interactive env, raise warning.
+    if not is_interactive_env():
+        warnings.warn(
+            "Importing this agent toolkit from langchain is deprecated. Importing it "
+            "from langchain will no longer be supported as of langchain==0.2.0. "
+            "Please import from langchain-community instead:\n\n"
+            f"`from langchain_community.agent_toolkits import {name}`.\n\n"
+            "To install langchain-community run `pip install -U langchain-community`.",
+            category=LangChainDeprecationWarning,
+        )
+
+    return getattr(agent_toolkits, name)
+
+
+__all__ = [
+    "AINetworkToolkit",
+    "AmadeusToolkit",
+    "AzureCognitiveServicesToolkit",
+    "FileManagementToolkit",
+    "GmailToolkit",
+    "JiraToolkit",
+    "JsonToolkit",
+    "MultionToolkit",
+    "NasaToolkit",
+    "NLAToolkit",
+    "O365Toolkit",
+    "OpenAPIToolkit",
+    "PlayWrightBrowserToolkit",
+    "PowerBIToolkit",
+    "SlackToolkit",
+    "SteamToolkit",
+    "SQLDatabaseToolkit",
+    "SparkSQLToolkit",
+    "VectorStoreInfo",
+    "VectorStoreRouterToolkit",
+    "VectorStoreToolkit",
+    "ZapierToolkit",
+    "create_json_agent",
+    "create_openapi_agent",
+    "create_pbi_agent",
+    "create_pbi_chat_agent",
+    "create_spark_sql_agent",
+    "create_sql_agent",
+    "create_vectorstore_agent",
+    "create_vectorstore_router_agent",
+    "create_conversational_retrieval_agent",
+    "create_retriever_tool",
+]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fd1b16fdd22010c4b6d41ec8a9b03a3693028e75
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/__pycache__/azure_cognitive_services.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/__pycache__/azure_cognitive_services.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..50e7fe3bc46943b72a22bdb8f123af292cbcd4b2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/__pycache__/azure_cognitive_services.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..97ecb7357414c37534bb3c15caebac900270f8e9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/ainetwork/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/ainetwork/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4295f2ef4886a3a6e862ed49c0050d3d9b8fc46
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/ainetwork/__init__.py
@@ -0,0 +1 @@
+"""AINetwork toolkit."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/ainetwork/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/ainetwork/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..98b8db0d3d2f660818483d7c8001fc3dd985c7c9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/ainetwork/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/ainetwork/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/ainetwork/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7f33b7f0ed8505c72df511123feee5774530d5c2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/ainetwork/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/ainetwork/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/ainetwork/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..397276703ac34b25790f963160468345ee199370
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/ainetwork/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.ainetwork.toolkit import AINetworkToolkit
+
+__all__ = ["AINetworkToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/amadeus/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/amadeus/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1141d7efe3f7bc2dbf557f0c960a56fb2cd1a0f2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/amadeus/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/amadeus/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/amadeus/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce5108571b51e130459281a0b9c35618ed9dd02e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/amadeus/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.amadeus.toolkit import AmadeusToolkit
+
+__all__ = ["AmadeusToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/azure_cognitive_services.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/azure_cognitive_services.py
new file mode 100644
index 0000000000000000000000000000000000000000..224a04ca41678d8430829b2583daf1b4f21f3624
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/azure_cognitive_services.py
@@ -0,0 +1,5 @@
+from langchain_community.agent_toolkits.azure_cognitive_services import (
+    AzureCognitiveServicesToolkit,
+)
+
+__all__ = ["AzureCognitiveServicesToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/base.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..ebeb44d0a0d65f7dbac999a471a111be973af129
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/base.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.base import BaseToolkit
+
+__all__ = ["BaseToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/clickup/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/clickup/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/clickup/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/clickup/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c81a2477ce1c64aee5bb6f08aab4dd33cedb74fe
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/clickup/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/clickup/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/clickup/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1de67403986f3c34e8c4ebba4da6e274503f7e62
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/clickup/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/clickup/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/clickup/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..b6bd3cc888c7af09d56aaa616bc90a70c4bd7952
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/clickup/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.clickup.toolkit import ClickupToolkit
+
+__all__ = ["ClickupToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7c06ae66e06ab94db852f495e2cd578d608ad58c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/__pycache__/openai_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/__pycache__/openai_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..29ed9c629c7dbe1a9790f81a1660aeed173270b0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/__pycache__/openai_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..10fd93aafd9b7b3c00400857b0c436c0f2c86a30
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/openai_functions.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/openai_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..d08a1991deb8f8fbc10dfd2af60d04caa7e27966
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/openai_functions.py
@@ -0,0 +1,85 @@
+from typing import Any, List, Optional  # noqa: E501
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.memory import BaseMemory
+from langchain_core.messages import SystemMessage
+from langchain_core.prompts.chat import MessagesPlaceholder
+
+from langchain.agents.agent import AgentExecutor
+from langchain.agents.openai_functions_agent.agent_token_buffer_memory import (
+    AgentTokenBufferMemory,
+)
+from langchain.agents.openai_functions_agent.base import OpenAIFunctionsAgent
+from langchain.memory.token_buffer import ConversationTokenBufferMemory
+from langchain.tools.base import BaseTool
+
+
+def _get_default_system_message() -> SystemMessage:
+    return SystemMessage(
+        content=(
+            "Do your best to answer the questions. "
+            "Feel free to use any tools available to look up "
+            "relevant information, only if necessary"
+        )
+    )
+
+
+def create_conversational_retrieval_agent(
+    llm: BaseLanguageModel,
+    tools: List[BaseTool],
+    remember_intermediate_steps: bool = True,
+    memory_key: str = "chat_history",
+    system_message: Optional[SystemMessage] = None,
+    verbose: bool = False,
+    max_token_limit: int = 2000,
+    **kwargs: Any,
+) -> AgentExecutor:
+    """A convenience method for creating a conversational retrieval agent.
+
+    Args:
+        llm: The language model to use, should be ChatOpenAI
+        tools: A list of tools the agent has access to
+        remember_intermediate_steps: Whether the agent should remember intermediate
+            steps or not. Intermediate steps refer to prior action/observation
+            pairs from previous questions. The benefit of remembering these is if
+            there is relevant information in there, the agent can use it to answer
+            follow up questions. The downside is it will take up more tokens.
+        memory_key: The name of the memory key in the prompt.
+        system_message: The system message to use. By default, a basic one will
+            be used.
+        verbose: Whether or not the final AgentExecutor should be verbose or not,
+            defaults to False.
+        max_token_limit: The max number of tokens to keep around in memory.
+            Defaults to 2000.
+
+    Returns:
+        An agent executor initialized appropriately
+    """
+
+    if remember_intermediate_steps:
+        memory: BaseMemory = AgentTokenBufferMemory(
+            memory_key=memory_key, llm=llm, max_token_limit=max_token_limit
+        )
+    else:
+        memory = ConversationTokenBufferMemory(
+            memory_key=memory_key,
+            return_messages=True,
+            output_key="output",
+            llm=llm,
+            max_token_limit=max_token_limit,
+        )
+
+    _system_message = system_message or _get_default_system_message()
+    prompt = OpenAIFunctionsAgent.create_prompt(
+        system_message=_system_message,
+        extra_prompt_messages=[MessagesPlaceholder(variable_name=memory_key)],
+    )
+    agent = OpenAIFunctionsAgent(llm=llm, tools=tools, prompt=prompt)
+    return AgentExecutor(
+        agent=agent,
+        tools=tools,
+        memory=memory,
+        verbose=verbose,
+        return_intermediate_steps=remember_intermediate_steps,
+        **kwargs,
+    )
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/tool.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..f7a09af8918c0aa3e19f8a47199e1fb11fc08dab
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/conversational_retrieval/tool.py
@@ -0,0 +1,3 @@
+from langchain.tools.retriever import create_retriever_tool
+
+__all__ = ["create_retriever_tool"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/csv/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/csv/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b049802888eaf0e8800d0ddfa29ec9b4ff4a42b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/csv/__init__.py
@@ -0,0 +1,26 @@
+from pathlib import Path
+from typing import Any
+
+from langchain_core._api.path import as_import_path
+
+
+def __getattr__(name: str) -> Any:
+    """Get attr name."""
+
+    if name == "create_csv_agent":
+        # Get directory of langchain package
+        HERE = Path(__file__).parents[3]
+        here = as_import_path(Path(__file__).parent, relative_to=HERE)
+
+        old_path = "langchain." + here + "." + name
+        new_path = "langchain_experimental." + here + "." + name
+        raise ImportError(
+            "This agent has been moved to langchain experiment. "
+            "This agent relies on python REPL tool under the hood, so to use it "
+            "safely please sandbox the python REPL. "
+            "Read https://github.com/langchain-ai/langchain/blob/master/SECURITY.md "
+            "and https://github.com/langchain-ai/langchain/discussions/11680"
+            "To keep using this code as is, install langchain experimental and "
+            f"update your import statement from:\n `{old_path}` to `{new_path}`."
+        )
+    raise AttributeError(f"{name} does not exist")
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/csv/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/csv/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..89f865fa34d6e8e7f4a24079228bbd4e3d801441
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/csv/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/file_management/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/file_management/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..53ce9329f914837adb259a2754cd522b62015c77
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/file_management/__init__.py
@@ -0,0 +1,7 @@
+"""Local file management toolkit."""
+
+from langchain_community.agent_toolkits.file_management.toolkit import (
+    FileManagementToolkit,
+)
+
+__all__ = ["FileManagementToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/file_management/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/file_management/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ff4a2525fbebff6928a13fe7a6f24bbc956be00d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/file_management/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/file_management/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/file_management/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d95b77fa547209fb5fca1d705878e4add1f208c9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/file_management/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/file_management/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/file_management/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..47a4325c28a722509a67b6aa2c40788e2748fd47
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/file_management/toolkit.py
@@ -0,0 +1,5 @@
+from langchain_community.agent_toolkits.file_management.toolkit import (
+    FileManagementToolkit,
+)
+
+__all__ = ["FileManagementToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/github/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/github/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bcd9368a52a4c85c4ce4703be431d8e32f1b959b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/github/__init__.py
@@ -0,0 +1 @@
+"""GitHub Toolkit."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/github/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/github/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e290233230310cd98fbf7d341e98f89fabb07dba
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/github/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/github/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/github/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3a712a564868e7429a5d486f51731a2507f27d9c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/github/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/github/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/github/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..2c4b9e213b049efa9a616790be6312ebea1c66a5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/github/toolkit.py
@@ -0,0 +1,35 @@
+from langchain_community.agent_toolkits.github.toolkit import (
+    BranchName,
+    CommentOnIssue,
+    CreateFile,
+    CreatePR,
+    CreateReviewRequest,
+    DeleteFile,
+    DirectoryPath,
+    GetIssue,
+    GetPR,
+    GitHubToolkit,
+    NoInput,
+    ReadFile,
+    SearchCode,
+    SearchIssuesAndPRs,
+    UpdateFile,
+)
+
+__all__ = [
+    "NoInput",
+    "GetIssue",
+    "CommentOnIssue",
+    "GetPR",
+    "CreatePR",
+    "CreateFile",
+    "ReadFile",
+    "UpdateFile",
+    "DeleteFile",
+    "DirectoryPath",
+    "BranchName",
+    "SearchCode",
+    "CreateReviewRequest",
+    "SearchIssuesAndPRs",
+    "GitHubToolkit",
+]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/gitlab/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gitlab/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7d3ca720636309ecfe762283732a06cfc68f3294
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gitlab/__init__.py
@@ -0,0 +1 @@
+"""GitLab Toolkit."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/gitlab/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gitlab/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7cc9e8f318756563cd9c9127302257a5d4f0923a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gitlab/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/gitlab/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gitlab/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..67ff04504cca9ca7d42ae6d66e99496b4eae797e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gitlab/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/gitlab/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gitlab/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..e5c116494425815da81b47a39a57c7110606e523
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gitlab/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.gitlab.toolkit import GitLabToolkit
+
+__all__ = ["GitLabToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/gmail/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gmail/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..02e7f81659f5a224cb8aa3d3a661e99972d6b0e6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gmail/__init__.py
@@ -0,0 +1 @@
+"""Gmail toolkit."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/gmail/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gmail/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8386df14000f918b26434a75344018b01f7be101
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gmail/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/gmail/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gmail/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0d119aab521b100ec94fee11ea494eb96c06e6f8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gmail/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/gmail/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gmail/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..d6f500e894c0a5184ce4e6e1c9b27f65177da5e3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/gmail/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.gmail.toolkit import SCOPES, GmailToolkit
+
+__all__ = ["SCOPES", "GmailToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/jira/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/jira/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9f7c67558fa53f59b5b7ac36f0c47a2dfe26f554
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/jira/__init__.py
@@ -0,0 +1 @@
+"""Jira Toolkit."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/jira/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/jira/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d25380ba6fd8a1027f1d40e4f4d1407b9c8f56a3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/jira/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/jira/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/jira/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d27ffa8cdc86d0783045dc5aae1be821cca6e16c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/jira/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/jira/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/jira/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..4f353747d8880e7e4d3eb2a5c0fb8bdc907e6789
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/jira/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.jira.toolkit import JiraToolkit
+
+__all__ = ["JiraToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bfab0ec6f83a544f93a19dc036a188cb08b82433
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__init__.py
@@ -0,0 +1 @@
+"""Json agent."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4e1976ab87935f7ec7816b899727c371bcba9f42
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1e4039adbfa0454580373752bad32919f78c1148
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eb0339d153f23b93913b91998ee224666b4a4bed
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..08f7e6c4fa12917dfdd454d61c5837167dae4757
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/base.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..d3e90faa61813eb6447df169b9cee497fdbc281c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/base.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.json.base import create_json_agent
+
+__all__ = ["create_json_agent"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/prompt.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..7a55b3e6bc169ca200ee2780da8781564c5fe355
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/prompt.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.json.prompt import JSON_PREFIX, JSON_SUFFIX
+
+__all__ = ["JSON_PREFIX", "JSON_SUFFIX"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..f4d558b69c31968a52a1812ae36424656755798a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/json/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.json.toolkit import JsonToolkit
+
+__all__ = ["JsonToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/multion/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/multion/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..56c7215199b05cf9a03832da4b24c928b771ece9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/multion/__init__.py
@@ -0,0 +1 @@
+"""MultiOn Toolkit."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/multion/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/multion/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..be2a118fa11b5a99f578228f1414a51d3c55f9ed
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/multion/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/multion/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/multion/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ef0038447208e4d677d16186f6da48deb8db1604
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/multion/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/multion/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/multion/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..4df2a4c9b61ed0cf0b5d2106082499ee813984f4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/multion/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.multion.toolkit import MultionToolkit
+
+__all__ = ["MultionToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/nasa/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nasa/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a13c3ec706c6d8773162ca325f1ceac2a7840315
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nasa/__init__.py
@@ -0,0 +1 @@
+"""NASA Toolkit"""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/nasa/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nasa/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9fe496e7ddb205cbd5a652a4f8aece856f829b26
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nasa/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/nasa/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nasa/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2782b325c21379a4203297be34b70d41e0d49700
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nasa/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/nasa/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nasa/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..312233762c9a6e79f972ab5514de664791afeb7b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nasa/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.nasa.toolkit import NasaToolkit
+
+__all__ = ["NasaToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8eaf89da29aafcd5f37ce1ac156804f4cdbf9a0a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..73b30d9d72fc3c9c2ef8e3caa45af429b789ddec
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6b62463a0b40878f081613d7f8f37a3ccb98a4e3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/tool.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d66bedadd07e50deb1a1e2bd69f59f06f0c538e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.nla.tool import NLATool
+
+__all__ = ["NLATool"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca290f02831fddf3876a1a2c5d85df8502fd99a1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/nla/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.nla.toolkit import NLAToolkit
+
+__all__ = ["NLAToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/office365/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/office365/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..acd0a87f955a214ef62fa32a0813971802cd96de
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/office365/__init__.py
@@ -0,0 +1 @@
+"""Office365 toolkit."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/office365/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/office365/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..970926a805a66773c5d7dc1c7c52b356e59d0043
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/office365/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/office365/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/office365/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a8ea2d561a965fe69c38c6e12514b1e39893c9c0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/office365/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/office365/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/office365/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..86cf061230545b1567d848b6093c22c13be21f35
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/office365/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.office365.toolkit import O365Toolkit
+
+__all__ = ["O365Toolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5d06e271cd00be5bc75dd27398a5fff15de1afbf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__init__.py
@@ -0,0 +1 @@
+"""OpenAPI spec agent."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b64d300254fa36b0fbd8785e8a68e288cbc02ac9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..96191d67652674d3ac4942e37571fb5cba79bf96
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/planner.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/planner.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..76a5816285fc3515db20e167a0bf5f0540665d26
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/planner.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/planner_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/planner_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c13be8236c1b6bd570582be169734c6d5386a281
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/planner_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..24e981226c28249d5748004433584562ddb43ced
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/spec.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/spec.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..87bf6512ae9081d454765759f5e90db36d18f121
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/spec.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b97a877b8963b640d6912957baa88ec08b9453f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/base.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..1fd86c1ba974d8f24b5065b9d3c4e5bed2992cd3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/base.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.openapi.base import create_openapi_agent
+
+__all__ = ["create_openapi_agent"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/planner.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/planner.py
new file mode 100644
index 0000000000000000000000000000000000000000..15e2ffc4fbf44babb643997042acb645f595b6d6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/planner.py
@@ -0,0 +1,19 @@
+from langchain_community.agent_toolkits.openapi.planner import (
+    MAX_RESPONSE_LENGTH,
+    RequestsDeleteToolWithParsing,
+    RequestsGetToolWithParsing,
+    RequestsPatchToolWithParsing,
+    RequestsPostToolWithParsing,
+    RequestsPutToolWithParsing,
+    create_openapi_agent,
+)
+
+__all__ = [
+    "MAX_RESPONSE_LENGTH",
+    "RequestsGetToolWithParsing",
+    "RequestsPostToolWithParsing",
+    "RequestsPatchToolWithParsing",
+    "RequestsPutToolWithParsing",
+    "RequestsDeleteToolWithParsing",
+    "create_openapi_agent",
+]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/planner_prompt.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/planner_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..a496b94f78d0e9343af0018fabf66b64b9114c2f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/planner_prompt.py
@@ -0,0 +1,39 @@
+from langchain_community.agent_toolkits.openapi.planner_prompt import (
+    API_CONTROLLER_PROMPT,
+    API_CONTROLLER_TOOL_DESCRIPTION,
+    API_CONTROLLER_TOOL_NAME,
+    API_ORCHESTRATOR_PROMPT,
+    API_PLANNER_PROMPT,
+    API_PLANNER_TOOL_DESCRIPTION,
+    API_PLANNER_TOOL_NAME,
+    PARSING_DELETE_PROMPT,
+    PARSING_GET_PROMPT,
+    PARSING_PATCH_PROMPT,
+    PARSING_POST_PROMPT,
+    PARSING_PUT_PROMPT,
+    REQUESTS_DELETE_TOOL_DESCRIPTION,
+    REQUESTS_GET_TOOL_DESCRIPTION,
+    REQUESTS_PATCH_TOOL_DESCRIPTION,
+    REQUESTS_POST_TOOL_DESCRIPTION,
+    REQUESTS_PUT_TOOL_DESCRIPTION,
+)
+
+__all__ = [
+    "API_PLANNER_PROMPT",
+    "API_PLANNER_TOOL_NAME",
+    "API_PLANNER_TOOL_DESCRIPTION",
+    "API_CONTROLLER_PROMPT",
+    "API_CONTROLLER_TOOL_NAME",
+    "API_CONTROLLER_TOOL_DESCRIPTION",
+    "API_ORCHESTRATOR_PROMPT",
+    "REQUESTS_GET_TOOL_DESCRIPTION",
+    "PARSING_GET_PROMPT",
+    "REQUESTS_POST_TOOL_DESCRIPTION",
+    "PARSING_POST_PROMPT",
+    "REQUESTS_PATCH_TOOL_DESCRIPTION",
+    "PARSING_PATCH_PROMPT",
+    "REQUESTS_PUT_TOOL_DESCRIPTION",
+    "PARSING_PUT_PROMPT",
+    "REQUESTS_DELETE_TOOL_DESCRIPTION",
+    "PARSING_DELETE_PROMPT",
+]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/prompt.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..14ec08f82e3609d881a45270ad3753fb20c27d13
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/prompt.py
@@ -0,0 +1,7 @@
+from langchain_community.agent_toolkits.openapi.prompt import (
+    DESCRIPTION,
+    OPENAPI_PREFIX,
+    OPENAPI_SUFFIX,
+)
+
+__all__ = ["OPENAPI_PREFIX", "OPENAPI_SUFFIX", "DESCRIPTION"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/spec.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/spec.py
new file mode 100644
index 0000000000000000000000000000000000000000..961010e3ebf45d0fc58dcadfab2bbd27b6809408
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/spec.py
@@ -0,0 +1,6 @@
+from langchain_community.agent_toolkits.openapi.spec import (
+    ReducedOpenAPISpec,
+    reduce_openapi_spec,
+)
+
+__all__ = ["ReducedOpenAPISpec", "reduce_openapi_spec"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..5ff0195ef8adc0bc2c6c3e092fcf52a584815b65
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/openapi/toolkit.py
@@ -0,0 +1,6 @@
+from langchain_community.agent_toolkits.openapi.toolkit import (
+    OpenAPIToolkit,
+    RequestsToolkit,
+)
+
+__all__ = ["RequestsToolkit", "OpenAPIToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/pandas/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/pandas/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a5cc6fc6664fb3597920923b04e71c3a198fd9e6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/pandas/__init__.py
@@ -0,0 +1,26 @@
+from pathlib import Path
+from typing import Any
+
+from langchain_core._api.path import as_import_path
+
+
+def __getattr__(name: str) -> Any:
+    """Get attr name."""
+
+    if name == "create_pandas_dataframe_agent":
+        # Get directory of langchain package
+        HERE = Path(__file__).parents[3]
+        here = as_import_path(Path(__file__).parent, relative_to=HERE)
+
+        old_path = "langchain." + here + "." + name
+        new_path = "langchain_experimental." + here + "." + name
+        raise ImportError(
+            "This agent has been moved to langchain experiment. "
+            "This agent relies on python REPL tool under the hood, so to use it "
+            "safely please sandbox the python REPL. "
+            "Read https://github.com/langchain-ai/langchain/blob/master/SECURITY.md "
+            "and https://github.com/langchain-ai/langchain/discussions/11680"
+            "To keep using this code as is, install langchain experimental and "
+            f"update your import statement from:\n `{old_path}` to `{new_path}`."
+        )
+    raise AttributeError(f"{name} does not exist")
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/pandas/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/pandas/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5f02a6bfa3bfb949aec52cabf7a31a3fc88a7dea
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/pandas/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/playwright/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/playwright/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7fc7f6d995095a63ad2fdc9cb12f7e1f2234878a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/playwright/__init__.py
@@ -0,0 +1,6 @@
+"""Playwright browser toolkit."""
+from langchain_community.agent_toolkits.playwright.toolkit import (
+    PlayWrightBrowserToolkit,
+)
+
+__all__ = ["PlayWrightBrowserToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/playwright/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/playwright/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..beac2eeeaf79dcd802a10da2ae29a091e48abc15
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/playwright/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/playwright/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/playwright/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7f8dbe83c065a50f99ca7ec627449ada8b69c5bc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/playwright/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/playwright/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/playwright/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ab77c652f57c256e26eec82c026edad94bcfb09
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/playwright/toolkit.py
@@ -0,0 +1,5 @@
+from langchain_community.agent_toolkits.playwright.toolkit import (
+    PlayWrightBrowserToolkit,
+)
+
+__all__ = ["PlayWrightBrowserToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..42a9b09ac7e41e5899830f0b2f7be4820207ebdd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__init__.py
@@ -0,0 +1 @@
+"""Power BI agent."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e3df9d42345f5b43d950e779a06bb0e0c85b128d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..79c182a1f577ff08643124d2c894dd0fb57517a1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/chat_base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/chat_base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9a34861dd7d4c353b8aee2906c257ccac98db3b8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/chat_base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8386d1e5cc615f122502e72a77138dcd42d83ad5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fc2e6dcdfaef5e24a550907019f22a45f5e5e4c8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/base.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..fc7ac24bb3d2be0c89b97e0d1f54c00daa164c8d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/base.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.powerbi.base import create_pbi_agent
+
+__all__ = ["create_pbi_agent"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/chat_base.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/chat_base.py
new file mode 100644
index 0000000000000000000000000000000000000000..34a8b9b19cf962f44a6eab46b9ff22c88298e077
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/chat_base.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.powerbi.chat_base import create_pbi_chat_agent
+
+__all__ = ["create_pbi_chat_agent"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/prompt.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..c9b87c8d74aadcabe5b97012fbc206c947b09db9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/prompt.py
@@ -0,0 +1,13 @@
+from langchain_community.agent_toolkits.powerbi.prompt import (
+    POWERBI_CHAT_PREFIX,
+    POWERBI_CHAT_SUFFIX,
+    POWERBI_PREFIX,
+    POWERBI_SUFFIX,
+)
+
+__all__ = [
+    "POWERBI_PREFIX",
+    "POWERBI_SUFFIX",
+    "POWERBI_CHAT_PREFIX",
+    "POWERBI_CHAT_SUFFIX",
+]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..dfab1055c2c8237a4ff8a3bcc884249bf081b5f7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/powerbi/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.powerbi.toolkit import PowerBIToolkit
+
+__all__ = ["PowerBIToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/python/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/python/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..85d36eeb49221563642a66612c53de3aee91609f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/python/__init__.py
@@ -0,0 +1,26 @@
+from pathlib import Path
+from typing import Any
+
+from langchain_core._api.path import as_import_path
+
+
+def __getattr__(name: str) -> Any:
+    """Get attr name."""
+
+    if name == "create_python_agent":
+        # Get directory of langchain package
+        HERE = Path(__file__).parents[3]
+        here = as_import_path(Path(__file__).parent, relative_to=HERE)
+
+        old_path = "langchain." + here + "." + name
+        new_path = "langchain_experimental." + here + "." + name
+        raise ImportError(
+            "This agent has been moved to langchain experiment. "
+            "This agent relies on python REPL tool under the hood, so to use it "
+            "safely please sandbox the python REPL. "
+            "Read https://github.com/langchain-ai/langchain/blob/master/SECURITY.md "
+            "and https://github.com/langchain-ai/langchain/discussions/11680"
+            "To keep using this code as is, install langchain experimental and "
+            f"update your import statement from:\n `{old_path}` to `{new_path}`."
+        )
+    raise AttributeError(f"{name} does not exist")
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/python/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/python/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..325a742f71977d0a0578f8b1b82084735f2dd3a6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/python/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/slack/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/slack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1ec5ae704ce5eb6ba87c7061da65aec216915295
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/slack/__init__.py
@@ -0,0 +1 @@
+"""Slack toolkit."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/slack/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/slack/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c3c75544de270fed21e46aadeaae01c0697f834a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/slack/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/slack/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/slack/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f5a2af2fb940c2d960783cee3dc665dfcdd4b9f9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/slack/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/slack/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/slack/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..2a536e4b0e029d05865d196fb3919a439540c153
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/slack/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.slack.toolkit import SlackToolkit
+
+__all__ = ["SlackToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..73ec5b97dee859c53917d70aa8c89a79aa4c3882
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark/__init__.py
@@ -0,0 +1,26 @@
+from pathlib import Path
+from typing import Any
+
+from langchain_core._api.path import as_import_path
+
+
+def __getattr__(name: str) -> Any:
+    """Get attr name."""
+
+    if name == "create_spark_dataframe_agent":
+        # Get directory of langchain package
+        HERE = Path(__file__).parents[3]
+        here = as_import_path(Path(__file__).parent, relative_to=HERE)
+
+        old_path = "langchain." + here + "." + name
+        new_path = "langchain_experimental." + here + "." + name
+        raise ImportError(
+            "This agent has been moved to langchain experiment. "
+            "This agent relies on python REPL tool under the hood, so to use it "
+            "safely please sandbox the python REPL. "
+            "Read https://github.com/langchain-ai/langchain/blob/master/SECURITY.md "
+            "and https://github.com/langchain-ai/langchain/discussions/11680"
+            "To keep using this code as is, install langchain experimental and "
+            f"update your import statement from:\n `{old_path}` to `{new_path}`."
+        )
+    raise AttributeError(f"{name} does not exist")
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2d395196a80c59c1b2b0de8d855281c4e8f0c9ce
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4308c079443cbd52500cbbc928422c3ce7506db3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__init__.py
@@ -0,0 +1 @@
+"""Spark SQL agent."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e77fadfc4728b14b3b940d7d466a28b97d53089
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..49e18a5e670ca0c02f91ee3c04ba3a1a18ac03d3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..59ebd17a239c9026e17fd67ba88863c42d51e1d8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f0c7fe8aa5a519f424c9010f77174573dba3e88c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/base.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..6f4a80920eb4ee6f01af001b22886a5c3b5a9c30
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/base.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.spark_sql.base import create_spark_sql_agent
+
+__all__ = ["create_spark_sql_agent"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/prompt.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..1ecdb2fb9e321d3c664b5640ced0c732dc55cdf6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/prompt.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.spark_sql.prompt import SQL_PREFIX, SQL_SUFFIX
+
+__all__ = ["SQL_PREFIX", "SQL_SUFFIX"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..54dcdda76c340a72ae95a5571e86a7aa293b8e43
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/spark_sql/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.spark_sql.toolkit import SparkSQLToolkit
+
+__all__ = ["SparkSQLToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..74293a52391557789bd62c6885ecd91f04b89dc8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__init__.py
@@ -0,0 +1 @@
+"""SQL agent."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bffbf863d593d0735e6a78f43bef1da1392ea8cd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2bb09f32fe880f27e4418d2e40be240b5f3cac5a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aef497e5a1daceb8f9a282d3a19ebfec5ea4764f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..84d5b69ba97c96dbaec20d0dfb6dabedf263b97b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/base.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..b465062de6cf182413b8a28ff9f96692d22284ed
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/base.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.sql.base import create_sql_agent
+
+__all__ = ["create_sql_agent"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/prompt.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..09a59512816d8a730fb02312ae603bc4df810495
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/prompt.py
@@ -0,0 +1,7 @@
+from langchain_community.agent_toolkits.sql.prompt import (
+    SQL_FUNCTIONS_SUFFIX,
+    SQL_PREFIX,
+    SQL_SUFFIX,
+)
+
+__all__ = ["SQL_PREFIX", "SQL_SUFFIX", "SQL_FUNCTIONS_SUFFIX"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..0293074e646c11e3fc6544e02ae29602c6d29636
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/sql/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.sql.toolkit import SQLDatabaseToolkit
+
+__all__ = ["SQLDatabaseToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/steam/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/steam/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f99981082424ee0a70e444573cb3b4f6f2de4947
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/steam/__init__.py
@@ -0,0 +1 @@
+"""Steam Toolkit."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/steam/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/steam/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f8a722815ddde5d735a4cb6bd2e08406f53c0c46
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/steam/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/steam/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/steam/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8688bcd11ba4d4d4df6dc64dd0cd7149484c3cf4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/steam/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/steam/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/steam/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..4fde82fea24131df84956942e10d3d2b65ad7cb7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/steam/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.steam.toolkit import SteamToolkit
+
+__all__ = ["SteamToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ee15a97e4898341a0d1fb68d56071759f07546c6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__init__.py
@@ -0,0 +1 @@
+"""Agent toolkit for interacting with vector stores."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9013bbfe1a4be06d2d5b1f6b6d50084a01aba5b4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1c7e3249fd6d8ea4d3776218ff6ddd0cee6e9849
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b5e2f47920c2138fc0e391e37dd60f25babaa10d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..15cfa062d72a254499f6bc361ed35ad8903acdf8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/base.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..49e1626c8ad1c02a0c8797f748ca0ba87d1ea3e2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/base.py
@@ -0,0 +1,96 @@
+"""VectorStore agent."""
+from typing import Any, Dict, Optional
+
+from langchain_core.language_models import BaseLanguageModel
+
+from langchain.agents.agent import AgentExecutor
+from langchain.agents.agent_toolkits.vectorstore.prompt import PREFIX, ROUTER_PREFIX
+from langchain.agents.agent_toolkits.vectorstore.toolkit import (
+    VectorStoreRouterToolkit,
+    VectorStoreToolkit,
+)
+from langchain.agents.mrkl.base import ZeroShotAgent
+from langchain.callbacks.base import BaseCallbackManager
+from langchain.chains.llm import LLMChain
+
+
+def create_vectorstore_agent(
+    llm: BaseLanguageModel,
+    toolkit: VectorStoreToolkit,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    prefix: str = PREFIX,
+    verbose: bool = False,
+    agent_executor_kwargs: Optional[Dict[str, Any]] = None,
+    **kwargs: Any,
+) -> AgentExecutor:
+    """Construct a VectorStore agent from an LLM and tools.
+
+    Args:
+        llm (BaseLanguageModel): LLM that will be used by the agent
+        toolkit (VectorStoreToolkit): Set of tools for the agent
+        callback_manager (Optional[BaseCallbackManager], optional): Object to handle the callback [ Defaults to None. ]
+        prefix (str, optional): The prefix prompt for the agent. If not provided uses default PREFIX.
+        verbose (bool, optional): If you want to see the content of the scratchpad. [ Defaults to False ]
+        agent_executor_kwargs (Optional[Dict[str, Any]], optional): If there is any other parameter you want to send to the agent. [ Defaults to None ]
+        **kwargs: Additional named parameters to pass to the ZeroShotAgent.
+
+    Returns:
+        AgentExecutor: Returns a callable AgentExecutor object. Either you can call it or use run method with the query to get the response
+    """  # noqa: E501
+    tools = toolkit.get_tools()
+    prompt = ZeroShotAgent.create_prompt(tools, prefix=prefix)
+    llm_chain = LLMChain(
+        llm=llm,
+        prompt=prompt,
+        callback_manager=callback_manager,
+    )
+    tool_names = [tool.name for tool in tools]
+    agent = ZeroShotAgent(llm_chain=llm_chain, allowed_tools=tool_names, **kwargs)
+    return AgentExecutor.from_agent_and_tools(
+        agent=agent,
+        tools=tools,
+        callback_manager=callback_manager,
+        verbose=verbose,
+        **(agent_executor_kwargs or {}),
+    )
+
+
+def create_vectorstore_router_agent(
+    llm: BaseLanguageModel,
+    toolkit: VectorStoreRouterToolkit,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    prefix: str = ROUTER_PREFIX,
+    verbose: bool = False,
+    agent_executor_kwargs: Optional[Dict[str, Any]] = None,
+    **kwargs: Any,
+) -> AgentExecutor:
+    """Construct a VectorStore router agent from an LLM and tools.
+
+    Args:
+        llm (BaseLanguageModel): LLM that will be used by the agent
+        toolkit (VectorStoreRouterToolkit): Set of tools for the agent which have routing capability with multiple vector stores
+        callback_manager (Optional[BaseCallbackManager], optional): Object to handle the callback [ Defaults to None. ]
+        prefix (str, optional): The prefix prompt for the router agent. If not provided uses default ROUTER_PREFIX.
+        verbose (bool, optional): If you want to see the content of the scratchpad. [ Defaults to False ]
+        agent_executor_kwargs (Optional[Dict[str, Any]], optional): If there is any other parameter you want to send to the agent. [ Defaults to None ]
+        **kwargs: Additional named parameters to pass to the ZeroShotAgent.
+
+    Returns:
+        AgentExecutor: Returns a callable AgentExecutor object. Either you can call it or use run method with the query to get the response.
+    """  # noqa: E501
+    tools = toolkit.get_tools()
+    prompt = ZeroShotAgent.create_prompt(tools, prefix=prefix)
+    llm_chain = LLMChain(
+        llm=llm,
+        prompt=prompt,
+        callback_manager=callback_manager,
+    )
+    tool_names = [tool.name for tool in tools]
+    agent = ZeroShotAgent(llm_chain=llm_chain, allowed_tools=tool_names, **kwargs)
+    return AgentExecutor.from_agent_and_tools(
+        agent=agent,
+        tools=tools,
+        callback_manager=callback_manager,
+        verbose=verbose,
+        **(agent_executor_kwargs or {}),
+    )
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/prompt.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..a2837e56f1858a39beacc6ac2d43d40a84c70ee2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/prompt.py
@@ -0,0 +1,13 @@
+# flake8: noqa
+
+PREFIX = """You are an agent designed to answer questions about sets of documents.
+You have access to tools for interacting with the documents, and the inputs to the tools are questions.
+Sometimes, you will be asked to provide sources for your questions, in which case you should use the appropriate tool to do so.
+If the question does not seem relevant to any of the tools provided, just return "I don't know" as the answer.
+"""
+
+ROUTER_PREFIX = """You are an agent designed to answer questions.
+You have access to tools for interacting with different sources, and the inputs to the tools are questions.
+Your main task is to decide which of the tools is relevant for answering question at hand.
+For complex questions, you can break the question down into sub questions and use tools to answers the sub questions.
+"""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..65e4e374587149c74735f3ac5a13683338353efd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/vectorstore/toolkit.py
@@ -0,0 +1,89 @@
+"""Toolkit for interacting with a vector store."""
+from typing import List
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.llms.openai import OpenAI
+from langchain_community.tools.vectorstore.tool import (
+    VectorStoreQATool,
+    VectorStoreQAWithSourcesTool,
+)
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.vectorstores import VectorStore
+
+from langchain.tools import BaseTool
+
+
+class VectorStoreInfo(BaseModel):
+    """Information about a VectorStore."""
+
+    vectorstore: VectorStore = Field(exclude=True)
+    name: str
+    description: str
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+
+class VectorStoreToolkit(BaseToolkit):
+    """Toolkit for interacting with a Vector Store."""
+
+    vectorstore_info: VectorStoreInfo = Field(exclude=True)
+    llm: BaseLanguageModel = Field(default_factory=lambda: OpenAI(temperature=0))
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        description = VectorStoreQATool.get_description(
+            self.vectorstore_info.name, self.vectorstore_info.description
+        )
+        qa_tool = VectorStoreQATool(
+            name=self.vectorstore_info.name,
+            description=description,
+            vectorstore=self.vectorstore_info.vectorstore,
+            llm=self.llm,
+        )
+        description = VectorStoreQAWithSourcesTool.get_description(
+            self.vectorstore_info.name, self.vectorstore_info.description
+        )
+        qa_with_sources_tool = VectorStoreQAWithSourcesTool(
+            name=f"{self.vectorstore_info.name}_with_sources",
+            description=description,
+            vectorstore=self.vectorstore_info.vectorstore,
+            llm=self.llm,
+        )
+        return [qa_tool, qa_with_sources_tool]
+
+
+class VectorStoreRouterToolkit(BaseToolkit):
+    """Toolkit for routing between Vector Stores."""
+
+    vectorstores: List[VectorStoreInfo] = Field(exclude=True)
+    llm: BaseLanguageModel = Field(default_factory=lambda: OpenAI(temperature=0))
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        tools: List[BaseTool] = []
+        for vectorstore_info in self.vectorstores:
+            description = VectorStoreQATool.get_description(
+                vectorstore_info.name, vectorstore_info.description
+            )
+            qa_tool = VectorStoreQATool(
+                name=vectorstore_info.name,
+                description=description,
+                vectorstore=vectorstore_info.vectorstore,
+                llm=self.llm,
+            )
+            tools.append(qa_tool)
+        return tools
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/xorbits/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/xorbits/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd8fc13ba0da8082657c3e2ba2bd7a33b75c94d4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/xorbits/__init__.py
@@ -0,0 +1,26 @@
+from pathlib import Path
+from typing import Any
+
+from langchain_core._api.path import as_import_path
+
+
+def __getattr__(name: str) -> Any:
+    """Get attr name."""
+
+    if name == "create_xorbits_agent":
+        # Get directory of langchain package
+        HERE = Path(__file__).parents[3]
+        here = as_import_path(Path(__file__).parent, relative_to=HERE)
+
+        old_path = "langchain." + here + "." + name
+        new_path = "langchain_experimental." + here + "." + name
+        raise ImportError(
+            "This agent has been moved to langchain experiment. "
+            "This agent relies on python REPL tool under the hood, so to use it "
+            "safely please sandbox the python REPL. "
+            "Read https://github.com/langchain-ai/langchain/blob/master/SECURITY.md "
+            "and https://github.com/langchain-ai/langchain/discussions/11680"
+            "To keep using this code as is, install langchain experimental and "
+            f"update your import statement from:\n `{old_path}` to `{new_path}`."
+        )
+    raise AttributeError(f"{name} does not exist")
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/xorbits/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/xorbits/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a3d422f2ad49d40ab969d7b1adae5ab9400a9245
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/xorbits/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/zapier/__init__.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/zapier/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..faef4a3253167aa6767779fbd32292cedcfc4a4e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/zapier/__init__.py
@@ -0,0 +1 @@
+"""Zapier Toolkit."""
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/zapier/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/zapier/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8af4e736c02afb1015461ff1c3b799a48e10e919
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/zapier/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/zapier/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/agent_toolkits/zapier/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3405e6d931e711ba644f667dbe368895aebaa829
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/agent_toolkits/zapier/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/agent_toolkits/zapier/toolkit.py b/llm/Lib/site-packages/langchain/agents/agent_toolkits/zapier/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a99d47460977699264abb10e77477b68c670948
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_toolkits/zapier/toolkit.py
@@ -0,0 +1,3 @@
+from langchain_community.agent_toolkits.zapier.toolkit import ZapierToolkit
+
+__all__ = ["ZapierToolkit"]
diff --git a/llm/Lib/site-packages/langchain/agents/agent_types.py b/llm/Lib/site-packages/langchain/agents/agent_types.py
new file mode 100644
index 0000000000000000000000000000000000000000..2e98fe548182322c50e4bd64fd154892d497231b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/agent_types.py
@@ -0,0 +1,57 @@
+"""Module definitions of agent types together with corresponding agents."""
+from enum import Enum
+
+from langchain_core._api import deprecated
+
+
+@deprecated(
+    "0.1.0",
+    alternative=(
+        "Use new agent constructor methods like create_react_agent, create_json_agent, "
+        "create_structured_chat_agent, etc."
+    ),
+    removal="0.2.0",
+)
+class AgentType(str, Enum):
+    """An enum for agent types.
+
+    See documentation: https://python.langchain.com/docs/modules/agents/agent_types/
+    """
+
+    ZERO_SHOT_REACT_DESCRIPTION = "zero-shot-react-description"
+    """A zero shot agent that does a reasoning step before acting."""
+
+    REACT_DOCSTORE = "react-docstore"
+    """A zero shot agent that does a reasoning step before acting.
+    
+    This agent has access to a document store that allows it to look up 
+    relevant information to answering the question.
+    """
+
+    SELF_ASK_WITH_SEARCH = "self-ask-with-search"
+    """An agent that breaks down a complex question into a series of simpler questions.
+    
+    This agent uses a search tool to look up answers to the simpler questions
+    in order to answer the original complex question.
+    """
+    CONVERSATIONAL_REACT_DESCRIPTION = "conversational-react-description"
+    CHAT_ZERO_SHOT_REACT_DESCRIPTION = "chat-zero-shot-react-description"
+    """A zero shot agent that does a reasoning step before acting.
+    
+    This agent is designed to be used in conjunction 
+    """
+
+    CHAT_CONVERSATIONAL_REACT_DESCRIPTION = "chat-conversational-react-description"
+
+    STRUCTURED_CHAT_ZERO_SHOT_REACT_DESCRIPTION = (
+        "structured-chat-zero-shot-react-description"
+    )
+    """An zero-shot react agent optimized for chat models.
+    
+    This agent is capable of invoking tools that have multiple inputs.
+    """
+
+    OPENAI_FUNCTIONS = "openai-functions"
+    """An agent optimized for using open AI functions."""
+
+    OPENAI_MULTI_FUNCTIONS = "openai-multi-functions"
diff --git a/llm/Lib/site-packages/langchain/agents/chat/__init__.py b/llm/Lib/site-packages/langchain/agents/chat/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/agents/chat/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/chat/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2b046a99fbe4fa26aaa786224327e89725248836
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/chat/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/chat/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/chat/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ef976edf53baf3cfa96576a3dc65954a697beb2b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/chat/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/chat/__pycache__/output_parser.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/chat/__pycache__/output_parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..00df342fa5af75f2234da1f22eed6f53fd485ada
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/chat/__pycache__/output_parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/chat/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/chat/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e9eff65b864b0ad7cb6d4c54973b4e3f4658311f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/chat/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/chat/base.py b/llm/Lib/site-packages/langchain/agents/chat/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..0fda0a119ed7e14037c85f326d0e652f8530681a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/chat/base.py
@@ -0,0 +1,142 @@
+from typing import Any, List, Optional, Sequence, Tuple
+
+from langchain_core._api import deprecated
+from langchain_core.agents import AgentAction
+from langchain_core.callbacks import BaseCallbackManager
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.prompts.chat import (
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+    SystemMessagePromptTemplate,
+)
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain.agents.agent import Agent, AgentOutputParser
+from langchain.agents.chat.output_parser import ChatOutputParser
+from langchain.agents.chat.prompt import (
+    FORMAT_INSTRUCTIONS,
+    HUMAN_MESSAGE,
+    SYSTEM_MESSAGE_PREFIX,
+    SYSTEM_MESSAGE_SUFFIX,
+)
+from langchain.agents.utils import validate_tools_single_input
+from langchain.chains.llm import LLMChain
+
+
+@deprecated("0.1.0", alternative="create_react_agent", removal="0.2.0")
+class ChatAgent(Agent):
+    """Chat Agent."""
+
+    output_parser: AgentOutputParser = Field(default_factory=ChatOutputParser)
+    """Output parser for the agent."""
+
+    @property
+    def observation_prefix(self) -> str:
+        """Prefix to append the observation with."""
+        return "Observation: "
+
+    @property
+    def llm_prefix(self) -> str:
+        """Prefix to append the llm call with."""
+        return "Thought:"
+
+    def _construct_scratchpad(
+        self, intermediate_steps: List[Tuple[AgentAction, str]]
+    ) -> str:
+        agent_scratchpad = super()._construct_scratchpad(intermediate_steps)
+        if not isinstance(agent_scratchpad, str):
+            raise ValueError("agent_scratchpad should be of type string.")
+        if agent_scratchpad:
+            return (
+                f"This was your previous work "
+                f"(but I haven't seen any of it! I only see what "
+                f"you return as final answer):\n{agent_scratchpad}"
+            )
+        else:
+            return agent_scratchpad
+
+    @classmethod
+    def _get_default_output_parser(cls, **kwargs: Any) -> AgentOutputParser:
+        return ChatOutputParser()
+
+    @classmethod
+    def _validate_tools(cls, tools: Sequence[BaseTool]) -> None:
+        super()._validate_tools(tools)
+        validate_tools_single_input(class_name=cls.__name__, tools=tools)
+
+    @property
+    def _stop(self) -> List[str]:
+        return ["Observation:"]
+
+    @classmethod
+    def create_prompt(
+        cls,
+        tools: Sequence[BaseTool],
+        system_message_prefix: str = SYSTEM_MESSAGE_PREFIX,
+        system_message_suffix: str = SYSTEM_MESSAGE_SUFFIX,
+        human_message: str = HUMAN_MESSAGE,
+        format_instructions: str = FORMAT_INSTRUCTIONS,
+        input_variables: Optional[List[str]] = None,
+    ) -> BasePromptTemplate:
+        tool_strings = "\n".join([f"{tool.name}: {tool.description}" for tool in tools])
+        tool_names = ", ".join([tool.name for tool in tools])
+        format_instructions = format_instructions.format(tool_names=tool_names)
+        template = "\n\n".join(
+            [
+                system_message_prefix,
+                tool_strings,
+                format_instructions,
+                system_message_suffix,
+            ]
+        )
+        messages = [
+            SystemMessagePromptTemplate.from_template(template),
+            HumanMessagePromptTemplate.from_template(human_message),
+        ]
+        if input_variables is None:
+            input_variables = ["input", "agent_scratchpad"]
+        return ChatPromptTemplate(input_variables=input_variables, messages=messages)  # type: ignore[arg-type]
+
+    @classmethod
+    def from_llm_and_tools(
+        cls,
+        llm: BaseLanguageModel,
+        tools: Sequence[BaseTool],
+        callback_manager: Optional[BaseCallbackManager] = None,
+        output_parser: Optional[AgentOutputParser] = None,
+        system_message_prefix: str = SYSTEM_MESSAGE_PREFIX,
+        system_message_suffix: str = SYSTEM_MESSAGE_SUFFIX,
+        human_message: str = HUMAN_MESSAGE,
+        format_instructions: str = FORMAT_INSTRUCTIONS,
+        input_variables: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Agent:
+        """Construct an agent from an LLM and tools."""
+        cls._validate_tools(tools)
+        prompt = cls.create_prompt(
+            tools,
+            system_message_prefix=system_message_prefix,
+            system_message_suffix=system_message_suffix,
+            human_message=human_message,
+            format_instructions=format_instructions,
+            input_variables=input_variables,
+        )
+        llm_chain = LLMChain(
+            llm=llm,
+            prompt=prompt,
+            callback_manager=callback_manager,
+        )
+        tool_names = [tool.name for tool in tools]
+        _output_parser = output_parser or cls._get_default_output_parser()
+        return cls(
+            llm_chain=llm_chain,
+            allowed_tools=tool_names,
+            output_parser=_output_parser,
+            **kwargs,
+        )
+
+    @property
+    def _agent_type(self) -> str:
+        raise ValueError
diff --git a/llm/Lib/site-packages/langchain/agents/chat/output_parser.py b/llm/Lib/site-packages/langchain/agents/chat/output_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..cdb8c0d0dae1df340a1343e8f94789076a2fb3da
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/chat/output_parser.py
@@ -0,0 +1,56 @@
+import json
+import re
+from typing import Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.exceptions import OutputParserException
+
+from langchain.agents.agent import AgentOutputParser
+from langchain.agents.chat.prompt import FORMAT_INSTRUCTIONS
+
+FINAL_ANSWER_ACTION = "Final Answer:"
+
+
+class ChatOutputParser(AgentOutputParser):
+    """Output parser for the chat agent."""
+
+    format_instructions: str = FORMAT_INSTRUCTIONS
+    """Default formatting instructions"""
+
+    pattern = re.compile(r"^.*?`{3}(?:json)?\n(.*?)`{3}.*?$", re.DOTALL)
+    """Regex pattern to parse the output."""
+
+    def get_format_instructions(self) -> str:
+        """Returns formatting instructions for the given output parser."""
+        return self.format_instructions
+
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        includes_answer = FINAL_ANSWER_ACTION in text
+        try:
+            found = self.pattern.search(text)
+            if not found:
+                # Fast fail to parse Final Answer.
+                raise ValueError("action not found")
+            action = found.group(1)
+            response = json.loads(action.strip())
+            includes_action = "action" in response
+            if includes_answer and includes_action:
+                raise OutputParserException(
+                    "Parsing LLM output produced a final answer "
+                    f"and a parse-able action: {text}"
+                )
+            return AgentAction(
+                response["action"], response.get("action_input", {}), text
+            )
+
+        except Exception as exc:
+            if not includes_answer:
+                raise OutputParserException(
+                    f"Could not parse LLM output: {text}"
+                ) from exc
+            output = text.split(FINAL_ANSWER_ACTION)[-1].strip()
+            return AgentFinish({"output": output}, text)
+
+    @property
+    def _type(self) -> str:
+        return "chat"
diff --git a/llm/Lib/site-packages/langchain/agents/chat/prompt.py b/llm/Lib/site-packages/langchain/agents/chat/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..4343739bf4187b359ab2ed4bcfbc87a7afb281fa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/chat/prompt.py
@@ -0,0 +1,30 @@
+# flake8: noqa
+SYSTEM_MESSAGE_PREFIX = """Answer the following questions as best you can. You have access to the following tools:"""
+FORMAT_INSTRUCTIONS = """The way you use the tools is by specifying a json blob.
+Specifically, this json should have a `action` key (with the name of the tool to use) and a `action_input` key (with the input to the tool going here).
+
+The only values that should be in the "action" field are: {tool_names}
+
+The $JSON_BLOB should only contain a SINGLE action, do NOT return a list of multiple actions. Here is an example of a valid $JSON_BLOB:
+
+```
+{{{{
+  "action": $TOOL_NAME,
+  "action_input": $INPUT
+}}}}
+```
+
+ALWAYS use the following format:
+
+Question: the input question you must answer
+Thought: you should always think about what to do
+Action:
+```
+$JSON_BLOB
+```
+Observation: the result of the action
+... (this Thought/Action/Observation can repeat N times)
+Thought: I now know the final answer
+Final Answer: the final answer to the original input question"""
+SYSTEM_MESSAGE_SUFFIX = """Begin! Reminder to always use the exact characters `Final Answer` when responding."""
+HUMAN_MESSAGE = "{input}\n\n{agent_scratchpad}"
diff --git a/llm/Lib/site-packages/langchain/agents/conversational/__init__.py b/llm/Lib/site-packages/langchain/agents/conversational/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..94290c9cb9c706d29a874c229aa087a87fb9fe68
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/conversational/__init__.py
@@ -0,0 +1 @@
+"""An agent designed to hold a conversation in addition to using tools."""
diff --git a/llm/Lib/site-packages/langchain/agents/conversational/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/conversational/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3ea5a236610c7ad79e1b1aad6dce9dd973f1d5ee
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/conversational/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/conversational/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/conversational/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ea3cf447ac767bbba6b0b2a12aeea4c39154bffd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/conversational/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/conversational/__pycache__/output_parser.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/conversational/__pycache__/output_parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f65b995369350e3723ca0a6a7836310efa3b6456
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/conversational/__pycache__/output_parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/conversational/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/conversational/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b55dd254c566ab50922c86122f91ba6d9c4bf071
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/conversational/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/conversational/base.py b/llm/Lib/site-packages/langchain/agents/conversational/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..864bf0425e98f067abb2cc7f03f882173a65c7e6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/conversational/base.py
@@ -0,0 +1,134 @@
+"""An agent designed to hold a conversation in addition to using tools."""
+from __future__ import annotations
+
+from typing import Any, List, Optional, Sequence
+
+from langchain_core._api import deprecated
+from langchain_core.callbacks import BaseCallbackManager
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import PromptTemplate
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain.agents.agent import Agent, AgentOutputParser
+from langchain.agents.agent_types import AgentType
+from langchain.agents.conversational.output_parser import ConvoOutputParser
+from langchain.agents.conversational.prompt import FORMAT_INSTRUCTIONS, PREFIX, SUFFIX
+from langchain.agents.utils import validate_tools_single_input
+from langchain.chains import LLMChain
+
+
+@deprecated("0.1.0", alternative="create_react_agent", removal="0.2.0")
+class ConversationalAgent(Agent):
+    """An agent that holds a conversation in addition to using tools."""
+
+    ai_prefix: str = "AI"
+    """Prefix to use before AI output."""
+    output_parser: AgentOutputParser = Field(default_factory=ConvoOutputParser)
+    """Output parser for the agent."""
+
+    @classmethod
+    def _get_default_output_parser(
+        cls, ai_prefix: str = "AI", **kwargs: Any
+    ) -> AgentOutputParser:
+        return ConvoOutputParser(ai_prefix=ai_prefix)
+
+    @property
+    def _agent_type(self) -> str:
+        """Return Identifier of agent type."""
+        return AgentType.CONVERSATIONAL_REACT_DESCRIPTION
+
+    @property
+    def observation_prefix(self) -> str:
+        """Prefix to append the observation with."""
+        return "Observation: "
+
+    @property
+    def llm_prefix(self) -> str:
+        """Prefix to append the llm call with."""
+        return "Thought:"
+
+    @classmethod
+    def create_prompt(
+        cls,
+        tools: Sequence[BaseTool],
+        prefix: str = PREFIX,
+        suffix: str = SUFFIX,
+        format_instructions: str = FORMAT_INSTRUCTIONS,
+        ai_prefix: str = "AI",
+        human_prefix: str = "Human",
+        input_variables: Optional[List[str]] = None,
+    ) -> PromptTemplate:
+        """Create prompt in the style of the zero-shot agent.
+
+        Args:
+            tools: List of tools the agent will have access to, used to format the
+                prompt.
+            prefix: String to put before the list of tools.
+            suffix: String to put after the list of tools.
+            ai_prefix: String to use before AI output.
+            human_prefix: String to use before human output.
+            input_variables: List of input variables the final prompt will expect.
+
+        Returns:
+            A PromptTemplate with the template assembled from the pieces here.
+        """
+        tool_strings = "\n".join(
+            [f"> {tool.name}: {tool.description}" for tool in tools]
+        )
+        tool_names = ", ".join([tool.name for tool in tools])
+        format_instructions = format_instructions.format(
+            tool_names=tool_names, ai_prefix=ai_prefix, human_prefix=human_prefix
+        )
+        template = "\n\n".join([prefix, tool_strings, format_instructions, suffix])
+        if input_variables is None:
+            input_variables = ["input", "chat_history", "agent_scratchpad"]
+        return PromptTemplate(template=template, input_variables=input_variables)
+
+    @classmethod
+    def _validate_tools(cls, tools: Sequence[BaseTool]) -> None:
+        super()._validate_tools(tools)
+        validate_tools_single_input(cls.__name__, tools)
+
+    @classmethod
+    def from_llm_and_tools(
+        cls,
+        llm: BaseLanguageModel,
+        tools: Sequence[BaseTool],
+        callback_manager: Optional[BaseCallbackManager] = None,
+        output_parser: Optional[AgentOutputParser] = None,
+        prefix: str = PREFIX,
+        suffix: str = SUFFIX,
+        format_instructions: str = FORMAT_INSTRUCTIONS,
+        ai_prefix: str = "AI",
+        human_prefix: str = "Human",
+        input_variables: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Agent:
+        """Construct an agent from an LLM and tools."""
+        cls._validate_tools(tools)
+        prompt = cls.create_prompt(
+            tools,
+            ai_prefix=ai_prefix,
+            human_prefix=human_prefix,
+            prefix=prefix,
+            suffix=suffix,
+            format_instructions=format_instructions,
+            input_variables=input_variables,
+        )
+        llm_chain = LLMChain(  # type: ignore[misc]
+            llm=llm,
+            prompt=prompt,
+            callback_manager=callback_manager,
+        )
+        tool_names = [tool.name for tool in tools]
+        _output_parser = output_parser or cls._get_default_output_parser(
+            ai_prefix=ai_prefix
+        )
+        return cls(
+            llm_chain=llm_chain,
+            allowed_tools=tool_names,
+            ai_prefix=ai_prefix,
+            output_parser=_output_parser,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/agents/conversational/output_parser.py b/llm/Lib/site-packages/langchain/agents/conversational/output_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..e74e626faa99e55ad37c2c54ea694997135800c5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/conversational/output_parser.py
@@ -0,0 +1,39 @@
+import re
+from typing import Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.exceptions import OutputParserException
+
+from langchain.agents.agent import AgentOutputParser
+from langchain.agents.conversational.prompt import FORMAT_INSTRUCTIONS
+
+
+class ConvoOutputParser(AgentOutputParser):
+    """Output parser for the conversational agent."""
+
+    ai_prefix: str = "AI"
+    """Prefix to use before AI output."""
+
+    format_instructions: str = FORMAT_INSTRUCTIONS
+    """Default formatting instructions"""
+
+    def get_format_instructions(self) -> str:
+        """Returns formatting instructions for the given output parser."""
+        return self.format_instructions
+
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        if f"{self.ai_prefix}:" in text:
+            return AgentFinish(
+                {"output": text.split(f"{self.ai_prefix}:")[-1].strip()}, text
+            )
+        regex = r"Action: (.*?)[\n]*Action Input: ([\s\S]*)"
+        match = re.search(regex, text, re.DOTALL)
+        if not match:
+            raise OutputParserException(f"Could not parse LLM output: `{text}`")
+        action = match.group(1)
+        action_input = match.group(2)
+        return AgentAction(action.strip(), action_input.strip(" ").strip('"'), text)
+
+    @property
+    def _type(self) -> str:
+        return "conversational"
diff --git a/llm/Lib/site-packages/langchain/agents/conversational/prompt.py b/llm/Lib/site-packages/langchain/agents/conversational/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..15268a760834452eb3ff990ca6548a80788271d3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/conversational/prompt.py
@@ -0,0 +1,36 @@
+# flake8: noqa
+PREFIX = """Assistant is a large language model trained by OpenAI.
+
+Assistant is designed to be able to assist with a wide range of tasks, from answering simple questions to providing in-depth explanations and discussions on a wide range of topics. As a language model, Assistant is able to generate human-like text based on the input it receives, allowing it to engage in natural-sounding conversations and provide responses that are coherent and relevant to the topic at hand.
+
+Assistant is constantly learning and improving, and its capabilities are constantly evolving. It is able to process and understand large amounts of text, and can use this knowledge to provide accurate and informative responses to a wide range of questions. Additionally, Assistant is able to generate its own text based on the input it receives, allowing it to engage in discussions and provide explanations and descriptions on a wide range of topics.
+
+Overall, Assistant is a powerful tool that can help with a wide range of tasks and provide valuable insights and information on a wide range of topics. Whether you need help with a specific question or just want to have a conversation about a particular topic, Assistant is here to assist.
+
+TOOLS:
+------
+
+Assistant has access to the following tools:"""
+FORMAT_INSTRUCTIONS = """To use a tool, please use the following format:
+
+```
+Thought: Do I need to use a tool? Yes
+Action: the action to take, should be one of [{tool_names}]
+Action Input: the input to the action
+Observation: the result of the action
+```
+
+When you have a response to say to the Human, or if you do not need to use a tool, you MUST use the format:
+
+```
+Thought: Do I need to use a tool? No
+{ai_prefix}: [your response here]
+```"""
+
+SUFFIX = """Begin!
+
+Previous conversation history:
+{chat_history}
+
+New input: {input}
+{agent_scratchpad}"""
diff --git a/llm/Lib/site-packages/langchain/agents/conversational_chat/__init__.py b/llm/Lib/site-packages/langchain/agents/conversational_chat/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..94290c9cb9c706d29a874c229aa087a87fb9fe68
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/conversational_chat/__init__.py
@@ -0,0 +1 @@
+"""An agent designed to hold a conversation in addition to using tools."""
diff --git a/llm/Lib/site-packages/langchain/agents/conversational_chat/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/conversational_chat/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5e620b84cfab5549d3d23a637103aa6df8f217f7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/conversational_chat/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/conversational_chat/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/conversational_chat/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dabecc85d6f4dce4e78c08eef4db62720e3218b7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/conversational_chat/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/conversational_chat/__pycache__/output_parser.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/conversational_chat/__pycache__/output_parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..87ec7bcfc9a32ae33179ea54a8dd98b04ba21c31
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/conversational_chat/__pycache__/output_parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/conversational_chat/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/conversational_chat/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..446c023b66ded9c649d235e6b02d69aa0979e00b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/conversational_chat/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/conversational_chat/base.py b/llm/Lib/site-packages/langchain/agents/conversational_chat/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ba0f6f54037ebf8e6e21909a5f9539d6430146d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/conversational_chat/base.py
@@ -0,0 +1,139 @@
+"""An agent designed to hold a conversation in addition to using tools."""
+from __future__ import annotations
+
+from typing import Any, List, Optional, Sequence, Tuple
+
+from langchain_core._api import deprecated
+from langchain_core.agents import AgentAction
+from langchain_core.callbacks import BaseCallbackManager
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.messages import AIMessage, BaseMessage, HumanMessage
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.prompts.chat import (
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+    MessagesPlaceholder,
+    SystemMessagePromptTemplate,
+)
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain.agents.agent import Agent, AgentOutputParser
+from langchain.agents.conversational_chat.output_parser import ConvoOutputParser
+from langchain.agents.conversational_chat.prompt import (
+    PREFIX,
+    SUFFIX,
+    TEMPLATE_TOOL_RESPONSE,
+)
+from langchain.agents.utils import validate_tools_single_input
+from langchain.chains import LLMChain
+
+
+@deprecated("0.1.0", alternative="create_json_chat_agent", removal="0.2.0")
+class ConversationalChatAgent(Agent):
+    """An agent designed to hold a conversation in addition to using tools."""
+
+    output_parser: AgentOutputParser = Field(default_factory=ConvoOutputParser)
+    template_tool_response: str = TEMPLATE_TOOL_RESPONSE
+
+    @classmethod
+    def _get_default_output_parser(cls, **kwargs: Any) -> AgentOutputParser:
+        return ConvoOutputParser()
+
+    @property
+    def _agent_type(self) -> str:
+        raise NotImplementedError
+
+    @property
+    def observation_prefix(self) -> str:
+        """Prefix to append the observation with."""
+        return "Observation: "
+
+    @property
+    def llm_prefix(self) -> str:
+        """Prefix to append the llm call with."""
+        return "Thought:"
+
+    @classmethod
+    def _validate_tools(cls, tools: Sequence[BaseTool]) -> None:
+        super()._validate_tools(tools)
+        validate_tools_single_input(cls.__name__, tools)
+
+    @classmethod
+    def create_prompt(
+        cls,
+        tools: Sequence[BaseTool],
+        system_message: str = PREFIX,
+        human_message: str = SUFFIX,
+        input_variables: Optional[List[str]] = None,
+        output_parser: Optional[BaseOutputParser] = None,
+    ) -> BasePromptTemplate:
+        tool_strings = "\n".join(
+            [f"> {tool.name}: {tool.description}" for tool in tools]
+        )
+        tool_names = ", ".join([tool.name for tool in tools])
+        _output_parser = output_parser or cls._get_default_output_parser()
+        format_instructions = human_message.format(
+            format_instructions=_output_parser.get_format_instructions()
+        )
+        final_prompt = format_instructions.format(
+            tool_names=tool_names, tools=tool_strings
+        )
+        if input_variables is None:
+            input_variables = ["input", "chat_history", "agent_scratchpad"]
+        messages = [
+            SystemMessagePromptTemplate.from_template(system_message),
+            MessagesPlaceholder(variable_name="chat_history"),
+            HumanMessagePromptTemplate.from_template(final_prompt),
+            MessagesPlaceholder(variable_name="agent_scratchpad"),
+        ]
+        return ChatPromptTemplate(input_variables=input_variables, messages=messages)  # type: ignore[arg-type]
+
+    def _construct_scratchpad(
+        self, intermediate_steps: List[Tuple[AgentAction, str]]
+    ) -> List[BaseMessage]:
+        """Construct the scratchpad that lets the agent continue its thought process."""
+        thoughts: List[BaseMessage] = []
+        for action, observation in intermediate_steps:
+            thoughts.append(AIMessage(content=action.log))
+            human_message = HumanMessage(
+                content=self.template_tool_response.format(observation=observation)
+            )
+            thoughts.append(human_message)
+        return thoughts
+
+    @classmethod
+    def from_llm_and_tools(
+        cls,
+        llm: BaseLanguageModel,
+        tools: Sequence[BaseTool],
+        callback_manager: Optional[BaseCallbackManager] = None,
+        output_parser: Optional[AgentOutputParser] = None,
+        system_message: str = PREFIX,
+        human_message: str = SUFFIX,
+        input_variables: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Agent:
+        """Construct an agent from an LLM and tools."""
+        cls._validate_tools(tools)
+        _output_parser = output_parser or cls._get_default_output_parser()
+        prompt = cls.create_prompt(
+            tools,
+            system_message=system_message,
+            human_message=human_message,
+            input_variables=input_variables,
+            output_parser=_output_parser,
+        )
+        llm_chain = LLMChain(  # type: ignore[misc]
+            llm=llm,
+            prompt=prompt,
+            callback_manager=callback_manager,
+        )
+        tool_names = [tool.name for tool in tools]
+        return cls(
+            llm_chain=llm_chain,
+            allowed_tools=tool_names,
+            output_parser=_output_parser,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/agents/conversational_chat/output_parser.py b/llm/Lib/site-packages/langchain/agents/conversational_chat/output_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..6fd330ccf8d186356138beae60113a6158e0c96b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/conversational_chat/output_parser.py
@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+from typing import Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.exceptions import OutputParserException
+
+from langchain.agents import AgentOutputParser
+from langchain.agents.conversational_chat.prompt import FORMAT_INSTRUCTIONS
+from langchain.output_parsers.json import parse_json_markdown
+
+
+# Define a class that parses output for conversational agents
+class ConvoOutputParser(AgentOutputParser):
+    """Output parser for the conversational agent."""
+
+    format_instructions: str = FORMAT_INSTRUCTIONS
+    """Default formatting instructions"""
+
+    def get_format_instructions(self) -> str:
+        """Returns formatting instructions for the given output parser."""
+        return self.format_instructions
+
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        """Attempts to parse the given text into an AgentAction or AgentFinish.
+
+        Raises:
+             OutputParserException if parsing fails.
+        """
+        try:
+            # Attempt to parse the text into a structured format (assumed to be JSON
+            # stored as markdown)
+            response = parse_json_markdown(text)
+
+            # If the response contains an 'action' and 'action_input'
+            if "action" in response and "action_input" in response:
+                action, action_input = response["action"], response["action_input"]
+
+                # If the action indicates a final answer, return an AgentFinish
+                if action == "Final Answer":
+                    return AgentFinish({"output": action_input}, text)
+                else:
+                    # Otherwise, return an AgentAction with the specified action and
+                    # input
+                    return AgentAction(action, action_input, text)
+            else:
+                # If the necessary keys aren't present in the response, raise an
+                # exception
+                raise OutputParserException(
+                    f"Missing 'action' or 'action_input' in LLM output: {text}"
+                )
+        except Exception as e:
+            # If any other exception is raised during parsing, also raise an
+            # OutputParserException
+            raise OutputParserException(f"Could not parse LLM output: {text}") from e
+
+    @property
+    def _type(self) -> str:
+        return "conversational_chat"
diff --git a/llm/Lib/site-packages/langchain/agents/conversational_chat/prompt.py b/llm/Lib/site-packages/langchain/agents/conversational_chat/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..712a9238eaedcac05b4d09b644686bf08a93f35d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/conversational_chat/prompt.py
@@ -0,0 +1,57 @@
+# flake8: noqa
+PREFIX = """Assistant is a large language model trained by OpenAI.
+
+Assistant is designed to be able to assist with a wide range of tasks, from answering simple questions to providing in-depth explanations and discussions on a wide range of topics. As a language model, Assistant is able to generate human-like text based on the input it receives, allowing it to engage in natural-sounding conversations and provide responses that are coherent and relevant to the topic at hand.
+
+Assistant is constantly learning and improving, and its capabilities are constantly evolving. It is able to process and understand large amounts of text, and can use this knowledge to provide accurate and informative responses to a wide range of questions. Additionally, Assistant is able to generate its own text based on the input it receives, allowing it to engage in discussions and provide explanations and descriptions on a wide range of topics.
+
+Overall, Assistant is a powerful system that can help with a wide range of tasks and provide valuable insights and information on a wide range of topics. Whether you need help with a specific question or just want to have a conversation about a particular topic, Assistant is here to assist."""
+
+FORMAT_INSTRUCTIONS = """RESPONSE FORMAT INSTRUCTIONS
+----------------------------
+
+When responding to me, please output a response in one of two formats:
+
+**Option 1:**
+Use this if you want the human to use a tool.
+Markdown code snippet formatted in the following schema:
+
+```json
+{{{{
+    "action": string, \\\\ The action to take. Must be one of {tool_names}
+    "action_input": string \\\\ The input to the action
+}}}}
+```
+
+**Option #2:**
+Use this if you want to respond directly to the human. Markdown code snippet formatted in the following schema:
+
+```json
+{{{{
+    "action": "Final Answer",
+    "action_input": string \\\\ You should put what you want to return to use here
+}}}}
+```"""
+
+SUFFIX = """TOOLS
+------
+Assistant can ask the user to use tools to look up information that may be helpful in answering the users original question. The tools the human can use are:
+
+{{tools}}
+
+{format_instructions}
+
+USER'S INPUT
+--------------------
+Here is the user's input (remember to respond with a markdown code snippet of a json blob with a single action, and NOTHING else):
+
+{{{{input}}}}"""
+
+TEMPLATE_TOOL_RESPONSE = """TOOL RESPONSE: 
+---------------------
+{observation}
+
+USER'S INPUT
+--------------------
+
+Okay, so what is the response to my last comment? If using information obtained from the tools you must mention it explicitly without mentioning the tool names - I have forgotten all TOOL RESPONSES! Remember to respond with a markdown code snippet of a json blob with a single action, and NOTHING else."""
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/__init__.py b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c81dfae5f874fc1971c02b2c69e1c3180d5fd343
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__init__.py
@@ -0,0 +1,24 @@
+"""Logic for formatting intermediate steps into an agent scratchpad.
+
+Intermediate steps refers to the list of (AgentAction, observation) tuples
+that result from previous iterations of the agent.
+Depending on the prompting strategy you are using, you may want to format these
+differently before passing them into the LLM.
+"""
+from langchain.agents.format_scratchpad.log import format_log_to_str
+from langchain.agents.format_scratchpad.log_to_messages import format_log_to_messages
+from langchain.agents.format_scratchpad.openai_functions import (
+    format_to_openai_function_messages,
+    format_to_openai_functions,
+)
+from langchain.agents.format_scratchpad.tools import format_to_tool_messages
+from langchain.agents.format_scratchpad.xml import format_xml
+
+__all__ = [
+    "format_xml",
+    "format_to_openai_function_messages",
+    "format_to_openai_functions",
+    "format_to_tool_messages",
+    "format_log_to_str",
+    "format_log_to_messages",
+]
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4aa43e8498a3fb5eb44cd985d5396d17e8ee2605
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/log.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/log.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d422535b719895e1aba2a5c68c11ea18cf49dc82
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/log.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/log_to_messages.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/log_to_messages.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cb49a134edcc59eafac23e25376ab8c619cba3ab
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/log_to_messages.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/openai_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/openai_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e72e2d7744be103651d895810826bba73fe9f1f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/openai_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/openai_tools.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/openai_tools.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ff20e494942bf87b69d73c6e12fb10749b19c35f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/openai_tools.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/tools.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/tools.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9cbe0353445f5a7d18ed16cd1edaba1c5609489c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/tools.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/xml.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/xml.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5face60675b923dd8b4a25706f15665cd06eaef1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/format_scratchpad/__pycache__/xml.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/log.py b/llm/Lib/site-packages/langchain/agents/format_scratchpad/log.py
new file mode 100644
index 0000000000000000000000000000000000000000..742758a8ed75e2bf7279c133faa42b5a556c0c8a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/format_scratchpad/log.py
@@ -0,0 +1,16 @@
+from typing import List, Tuple
+
+from langchain_core.agents import AgentAction
+
+
+def format_log_to_str(
+    intermediate_steps: List[Tuple[AgentAction, str]],
+    observation_prefix: str = "Observation: ",
+    llm_prefix: str = "Thought: ",
+) -> str:
+    """Construct the scratchpad that lets the agent continue its thought process."""
+    thoughts = ""
+    for action, observation in intermediate_steps:
+        thoughts += action.log
+        thoughts += f"\n{observation_prefix}{observation}\n{llm_prefix}"
+    return thoughts
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/log_to_messages.py b/llm/Lib/site-packages/langchain/agents/format_scratchpad/log_to_messages.py
new file mode 100644
index 0000000000000000000000000000000000000000..1329632b0c21448e8276f2858254feb033cde0f7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/format_scratchpad/log_to_messages.py
@@ -0,0 +1,19 @@
+from typing import List, Tuple
+
+from langchain_core.agents import AgentAction
+from langchain_core.messages import AIMessage, BaseMessage, HumanMessage
+
+
+def format_log_to_messages(
+    intermediate_steps: List[Tuple[AgentAction, str]],
+    template_tool_response: str = "{observation}",
+) -> List[BaseMessage]:
+    """Construct the scratchpad that lets the agent continue its thought process."""
+    thoughts: List[BaseMessage] = []
+    for action, observation in intermediate_steps:
+        thoughts.append(AIMessage(content=action.log))
+        human_message = HumanMessage(
+            content=template_tool_response.format(observation=observation)
+        )
+        thoughts.append(human_message)
+    return thoughts
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/openai_functions.py b/llm/Lib/site-packages/langchain/agents/format_scratchpad/openai_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..b5f09ea249927d05b85daec9cf146f05dfa81c45
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/format_scratchpad/openai_functions.py
@@ -0,0 +1,73 @@
+import json
+from typing import List, Sequence, Tuple
+
+from langchain_core.agents import AgentAction, AgentActionMessageLog
+from langchain_core.messages import AIMessage, BaseMessage, FunctionMessage
+
+
+def _convert_agent_action_to_messages(
+    agent_action: AgentAction, observation: str
+) -> List[BaseMessage]:
+    """Convert an agent action to a message.
+
+    This code is used to reconstruct the original AI message from the agent action.
+
+    Args:
+        agent_action: Agent action to convert.
+
+    Returns:
+        AIMessage that corresponds to the original tool invocation.
+    """
+    if isinstance(agent_action, AgentActionMessageLog):
+        return list(agent_action.message_log) + [
+            _create_function_message(agent_action, observation)
+        ]
+    else:
+        return [AIMessage(content=agent_action.log)]
+
+
+def _create_function_message(
+    agent_action: AgentAction, observation: str
+) -> FunctionMessage:
+    """Convert agent action and observation into a function message.
+    Args:
+        agent_action: the tool invocation request from the agent
+        observation: the result of the tool invocation
+    Returns:
+        FunctionMessage that corresponds to the original tool invocation
+    """
+    if not isinstance(observation, str):
+        try:
+            content = json.dumps(observation, ensure_ascii=False)
+        except Exception:
+            content = str(observation)
+    else:
+        content = observation
+    return FunctionMessage(
+        name=agent_action.tool,
+        content=content,
+    )
+
+
+def format_to_openai_function_messages(
+    intermediate_steps: Sequence[Tuple[AgentAction, str]],
+) -> List[BaseMessage]:
+    """Convert (AgentAction, tool output) tuples into FunctionMessages.
+
+    Args:
+        intermediate_steps: Steps the LLM has taken to date, along with observations
+
+    Returns:
+        list of messages to send to the LLM for the next prediction
+
+    """
+    messages = []
+
+    for agent_action, observation in intermediate_steps:
+        messages.extend(_convert_agent_action_to_messages(agent_action, observation))
+
+    return messages
+
+
+# Backwards compatibility
+format_to_openai_functions = format_to_openai_function_messages
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/openai_tools.py b/llm/Lib/site-packages/langchain/agents/format_scratchpad/openai_tools.py
new file mode 100644
index 0000000000000000000000000000000000000000..063905ea17937d02c0d41c9f4f5df7ceff825216
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/format_scratchpad/openai_tools.py
@@ -0,0 +1,5 @@
+from langchain.agents.format_scratchpad.tools import (
+    format_to_tool_messages as format_to_openai_tool_messages,
+)
+
+__all__ = ["format_to_openai_tool_messages"]
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/tools.py b/llm/Lib/site-packages/langchain/agents/format_scratchpad/tools.py
new file mode 100644
index 0000000000000000000000000000000000000000..4fbf16d8a341243a79a59b28e066ef7804b21fbe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/format_scratchpad/tools.py
@@ -0,0 +1,59 @@
+import json
+from typing import List, Sequence, Tuple
+
+from langchain_core.agents import AgentAction
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    ToolMessage,
+)
+
+from langchain.agents.output_parsers.tools import ToolAgentAction
+
+
+def _create_tool_message(
+    agent_action: ToolAgentAction, observation: str
+) -> ToolMessage:
+    """Convert agent action and observation into a function message.
+    Args:
+        agent_action: the tool invocation request from the agent
+        observation: the result of the tool invocation
+    Returns:
+        FunctionMessage that corresponds to the original tool invocation
+    """
+    if not isinstance(observation, str):
+        try:
+            content = json.dumps(observation, ensure_ascii=False)
+        except Exception:
+            content = str(observation)
+    else:
+        content = observation
+    return ToolMessage(
+        tool_call_id=agent_action.tool_call_id,
+        content=content,
+        additional_kwargs={"name": agent_action.tool},
+    )
+
+
+def format_to_tool_messages(
+    intermediate_steps: Sequence[Tuple[AgentAction, str]],
+) -> List[BaseMessage]:
+    """Convert (AgentAction, tool output) tuples into FunctionMessages.
+
+    Args:
+        intermediate_steps: Steps the LLM has taken to date, along with observations
+
+    Returns:
+        list of messages to send to the LLM for the next prediction
+
+    """
+    messages = []
+    for agent_action, observation in intermediate_steps:
+        if isinstance(agent_action, ToolAgentAction):
+            new_messages = list(agent_action.message_log) + [
+                _create_tool_message(agent_action, observation)
+            ]
+            messages.extend([new for new in new_messages if new not in messages])
+        else:
+            messages.append(AIMessage(content=agent_action.log))
+    return messages
diff --git a/llm/Lib/site-packages/langchain/agents/format_scratchpad/xml.py b/llm/Lib/site-packages/langchain/agents/format_scratchpad/xml.py
new file mode 100644
index 0000000000000000000000000000000000000000..e0ea960c14f40320064428c7023110ddea56ac62
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/format_scratchpad/xml.py
@@ -0,0 +1,23 @@
+from typing import List, Tuple
+
+from langchain_core.agents import AgentAction
+
+
+def format_xml(
+    intermediate_steps: List[Tuple[AgentAction, str]],
+) -> str:
+    """Format the intermediate steps as XML.
+
+    Args:
+        intermediate_steps: The intermediate steps.
+
+    Returns:
+        The intermediate steps as XML.
+    """
+    log = ""
+    for action, observation in intermediate_steps:
+        log += (
+            f"<tool>{action.tool}</tool><tool_input>{action.tool_input}"
+            f"</tool_input><observation>{observation}</observation>"
+        )
+    return log
diff --git a/llm/Lib/site-packages/langchain/agents/initialize.py b/llm/Lib/site-packages/langchain/agents/initialize.py
new file mode 100644
index 0000000000000000000000000000000000000000..890bc90e68f01912723b5b47bd0c343907771675
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/initialize.py
@@ -0,0 +1,90 @@
+"""Load agent."""
+from typing import Any, Optional, Sequence
+
+from langchain_core._api import deprecated
+from langchain_core.callbacks import BaseCallbackManager
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.tools import BaseTool
+
+from langchain.agents.agent import AgentExecutor
+from langchain.agents.agent_types import AgentType
+from langchain.agents.loading import AGENT_TO_CLASS, load_agent
+
+
+@deprecated(
+    "0.1.0",
+    alternative=(
+        "Use new agent constructor methods like create_react_agent, create_json_agent, "
+        "create_structured_chat_agent, etc."
+    ),
+    removal="0.2.0",
+)
+def initialize_agent(
+    tools: Sequence[BaseTool],
+    llm: BaseLanguageModel,
+    agent: Optional[AgentType] = None,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    agent_path: Optional[str] = None,
+    agent_kwargs: Optional[dict] = None,
+    *,
+    tags: Optional[Sequence[str]] = None,
+    **kwargs: Any,
+) -> AgentExecutor:
+    """Load an agent executor given tools and LLM.
+
+    Args:
+        tools: List of tools this agent has access to.
+        llm: Language model to use as the agent.
+        agent: Agent type to use. If None and agent_path is also None, will default to
+            AgentType.ZERO_SHOT_REACT_DESCRIPTION.
+        callback_manager: CallbackManager to use. Global callback manager is used if
+            not provided. Defaults to None.
+        agent_path: Path to serialized agent to use.
+        agent_kwargs: Additional keyword arguments to pass to the underlying agent
+        tags: Tags to apply to the traced runs.
+        **kwargs: Additional keyword arguments passed to the agent executor
+
+    Returns:
+        An agent executor
+    """
+    tags_ = list(tags) if tags else []
+    if agent is None and agent_path is None:
+        agent = AgentType.ZERO_SHOT_REACT_DESCRIPTION
+    if agent is not None and agent_path is not None:
+        raise ValueError(
+            "Both `agent` and `agent_path` are specified, "
+            "but at most only one should be."
+        )
+    if agent is not None:
+        if agent not in AGENT_TO_CLASS:
+            raise ValueError(
+                f"Got unknown agent type: {agent}. "
+                f"Valid types are: {AGENT_TO_CLASS.keys()}."
+            )
+        tags_.append(agent.value if isinstance(agent, AgentType) else agent)
+        agent_cls = AGENT_TO_CLASS[agent]
+        agent_kwargs = agent_kwargs or {}
+        agent_obj = agent_cls.from_llm_and_tools(
+            llm, tools, callback_manager=callback_manager, **agent_kwargs
+        )
+    elif agent_path is not None:
+        agent_obj = load_agent(
+            agent_path, llm=llm, tools=tools, callback_manager=callback_manager
+        )
+        try:
+            # TODO: Add tags from the serialized object directly.
+            tags_.append(agent_obj._agent_type)
+        except NotImplementedError:
+            pass
+    else:
+        raise ValueError(
+            "Somehow both `agent` and `agent_path` are None, "
+            "this should never happen."
+        )
+    return AgentExecutor.from_agent_and_tools(
+        agent=agent_obj,
+        tools=tools,
+        callback_manager=callback_manager,
+        tags=tags_,
+        **kwargs,
+    )
diff --git a/llm/Lib/site-packages/langchain/agents/json_chat/__init__.py b/llm/Lib/site-packages/langchain/agents/json_chat/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/agents/json_chat/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/json_chat/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f5bdc224a11212d08b90fff09b06bb5b1454f31e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/json_chat/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/json_chat/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/json_chat/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a1af7f30b95f8953fe40906f8ee361b82c546635
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/json_chat/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/json_chat/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/json_chat/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6f228ae3a9ddd6c9957d364dbff52ab22eb61c5f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/json_chat/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/json_chat/base.py b/llm/Lib/site-packages/langchain/agents/json_chat/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..ecf4ce7f7ce00cbfb3eb1f685614a87dec20f4c5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/json_chat/base.py
@@ -0,0 +1,188 @@
+from typing import List, Sequence, Union
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts.chat import ChatPromptTemplate
+from langchain_core.runnables import Runnable, RunnablePassthrough
+from langchain_core.tools import BaseTool
+
+from langchain.agents.format_scratchpad import format_log_to_messages
+from langchain.agents.json_chat.prompt import TEMPLATE_TOOL_RESPONSE
+from langchain.agents.output_parsers import JSONAgentOutputParser
+from langchain.tools.render import ToolsRenderer, render_text_description
+
+
+def create_json_chat_agent(
+    llm: BaseLanguageModel,
+    tools: Sequence[BaseTool],
+    prompt: ChatPromptTemplate,
+    stop_sequence: Union[bool, List[str]] = True,
+    tools_renderer: ToolsRenderer = render_text_description,
+    template_tool_response: str = TEMPLATE_TOOL_RESPONSE,
+) -> Runnable:
+    """Create an agent that uses JSON to format its logic, build for Chat Models.
+
+    Args:
+        llm: LLM to use as the agent.
+        tools: Tools this agent has access to.
+        prompt: The prompt to use. See Prompt section below for more.
+        stop_sequence: bool or list of str.
+            If True, adds a stop token of "Observation:" to avoid hallucinates. 
+            If False, does not add a stop token.
+            If a list of str, uses the provided list as the stop tokens.
+            
+            Default is True. You may to set this to False if the LLM you are using
+            does not support stop sequences.
+        tools_renderer: This controls how the tools are converted into a string and
+            then passed into the LLM. Default is `render_text_description`.
+        template_tool_response: Template prompt that uses the tool response (observation)
+            to make the LLM generate the next action to take.
+
+    Returns:
+        A Runnable sequence representing an agent. It takes as input all the same input
+        variables as the prompt passed in does. It returns as output either an
+        AgentAction or AgentFinish.
+
+    Example:
+
+        .. code-block:: python
+
+            from langchain import hub
+            from langchain_community.chat_models import ChatOpenAI
+            from langchain.agents import AgentExecutor, create_json_chat_agent
+
+            prompt = hub.pull("hwchase17/react-chat-json")
+            model = ChatOpenAI()
+            tools = ...
+
+            agent = create_json_chat_agent(model, tools, prompt)
+            agent_executor = AgentExecutor(agent=agent, tools=tools)
+
+            agent_executor.invoke({"input": "hi"})
+
+            # Using with chat history
+            from langchain_core.messages import AIMessage, HumanMessage
+            agent_executor.invoke(
+                {
+                    "input": "what's my name?",
+                    "chat_history": [
+                        HumanMessage(content="hi! my name is bob"),
+                        AIMessage(content="Hello Bob! How can I assist you today?"),
+                    ],
+                }
+            )
+
+    Prompt:
+    
+        The prompt must have input keys:
+            * `tools`: contains descriptions and arguments for each tool.
+            * `tool_names`: contains all tool names.
+            * `agent_scratchpad`: must be a MessagesPlaceholder. Contains previous agent actions and tool outputs as messages.
+        
+        Here's an example:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder
+            
+            system = '''Assistant is a large language model trained by OpenAI.
+
+            Assistant is designed to be able to assist with a wide range of tasks, from answering \
+            simple questions to providing in-depth explanations and discussions on a wide range of \
+            topics. As a language model, Assistant is able to generate human-like text based on \
+            the input it receives, allowing it to engage in natural-sounding conversations and \
+            provide responses that are coherent and relevant to the topic at hand.
+
+            Assistant is constantly learning and improving, and its capabilities are constantly \
+            evolving. It is able to process and understand large amounts of text, and can use this \
+            knowledge to provide accurate and informative responses to a wide range of questions. \
+            Additionally, Assistant is able to generate its own text based on the input it \
+            receives, allowing it to engage in discussions and provide explanations and \
+            descriptions on a wide range of topics.
+
+            Overall, Assistant is a powerful system that can help with a wide range of tasks \
+            and provide valuable insights and information on a wide range of topics. Whether \
+            you need help with a specific question or just want to have a conversation about \
+            a particular topic, Assistant is here to assist.'''
+            
+            human = '''TOOLS
+            ------
+            Assistant can ask the user to use tools to look up information that may be helpful in \
+            answering the users original question. The tools the human can use are:
+
+            {tools}
+
+            RESPONSE FORMAT INSTRUCTIONS
+            ----------------------------
+
+            When responding to me, please output a response in one of two formats:
+
+            **Option 1:**
+            Use this if you want the human to use a tool.
+            Markdown code snippet formatted in the following schema:
+
+            ```json
+            {{
+                "action": string, \ The action to take. Must be one of {tool_names}
+                "action_input": string \ The input to the action
+            }}
+            ```
+
+            **Option #2:**
+            Use this if you want to respond directly to the human. Markdown code snippet formatted \
+            in the following schema:
+
+            ```json
+            {{
+                "action": "Final Answer",
+                "action_input": string \ You should put what you want to return to use here
+            }}
+            ```
+
+            USER'S INPUT
+            --------------------
+            Here is the user's input (remember to respond with a markdown code snippet of a json \
+            blob with a single action, and NOTHING else):
+
+            {input}'''
+            
+            prompt = ChatPromptTemplate.from_messages(
+                [
+                    ("system", system),
+                    MessagesPlaceholder("chat_history", optional=True),
+                    ("human", human),
+                    MessagesPlaceholder("agent_scratchpad"),
+                ]
+            )
+    """  # noqa: E501
+    missing_vars = {"tools", "tool_names", "agent_scratchpad"}.difference(
+        prompt.input_variables + list(prompt.partial_variables)
+    )
+    if missing_vars:
+        raise ValueError(f"Prompt missing required variables: {missing_vars}")
+
+    if "{observation}" not in template_tool_response:
+        raise ValueError(
+            "Template tool response missing required variable 'observation'"
+        )
+
+    prompt = prompt.partial(
+        tools=tools_renderer(list(tools)),
+        tool_names=", ".join([t.name for t in tools]),
+    )
+    if stop_sequence:
+        stop = ["\nObservation"] if stop_sequence is True else stop_sequence
+        llm_to_use = llm.bind(stop=stop)
+    else:
+        llm_to_use = llm
+
+    agent = (
+        RunnablePassthrough.assign(
+            agent_scratchpad=lambda x: format_log_to_messages(
+                x["intermediate_steps"], template_tool_response=template_tool_response
+            )
+        )
+        | prompt
+        | llm_to_use
+        | JSONAgentOutputParser()
+    )
+    return agent
diff --git a/llm/Lib/site-packages/langchain/agents/json_chat/prompt.py b/llm/Lib/site-packages/langchain/agents/json_chat/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..34020caa29fcaaaee3396f165ede13b49aa4eb2d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/json_chat/prompt.py
@@ -0,0 +1,9 @@
+# flake8: noqa
+TEMPLATE_TOOL_RESPONSE = """TOOL RESPONSE: 
+---------------------
+{observation}
+
+USER'S INPUT
+--------------------
+
+Okay, so what is the response to my last comment? If using information obtained from the tools you must mention it explicitly without mentioning the tool names - I have forgotten all TOOL RESPONSES! Remember to respond with a markdown code snippet of a json blob with a single action, and NOTHING else - even if you just want to respond to the user. Do NOT respond with anything except a JSON snippet no matter what!"""
diff --git a/llm/Lib/site-packages/langchain/agents/load_tools.py b/llm/Lib/site-packages/langchain/agents/load_tools.py
new file mode 100644
index 0000000000000000000000000000000000000000..48712aae69de12c3499e3a39592b482c495dd0ec
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/load_tools.py
@@ -0,0 +1,699 @@
+# flake8: noqa
+"""Tools provide access to various resources and services.
+
+LangChain has a large ecosystem of integrations with various external resources
+like local and remote file systems, APIs and databases.
+
+These integrations allow developers to create versatile applications that combine the
+power of LLMs with the ability to access, interact with and manipulate external
+resources.
+
+When developing an application, developers should inspect the capabilities and
+permissions of the tools that underlie the given agent toolkit, and determine
+whether permissions of the given toolkit are appropriate for the application.
+
+See [Security](https://python.langchain.com/docs/security) for more information.
+"""
+import warnings
+from typing import Any, Dict, List, Optional, Callable, Tuple
+from mypy_extensions import Arg, KwArg
+
+from langchain_community.tools.file_management import ReadFileTool
+from langchain_core.tools import Tool
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.callbacks import BaseCallbackManager
+from langchain_core.callbacks import Callbacks
+from langchain.chains.api import news_docs, open_meteo_docs, podcast_docs, tmdb_docs
+from langchain.chains.api.base import APIChain
+from langchain.chains.llm_math.base import LLMMathChain
+from langchain_community.utilities.dalle_image_generator import DallEAPIWrapper
+from langchain_community.utilities.requests import TextRequestsWrapper
+from langchain_community.tools.arxiv.tool import ArxivQueryRun
+from langchain_community.tools.golden_query.tool import GoldenQueryRun
+from langchain_community.tools.pubmed.tool import PubmedQueryRun
+from langchain_core.tools import BaseTool
+from langchain_community.tools.bing_search.tool import BingSearchRun
+from langchain_community.tools.ddg_search.tool import DuckDuckGoSearchRun
+from langchain_community.tools.google_cloud.texttospeech import (
+    GoogleCloudTextToSpeechTool,
+)
+from langchain_community.tools.google_lens.tool import GoogleLensQueryRun
+from langchain_community.tools.google_search.tool import (
+    GoogleSearchResults,
+    GoogleSearchRun,
+)
+from langchain_community.tools.google_scholar.tool import GoogleScholarQueryRun
+from langchain_community.tools.google_finance.tool import GoogleFinanceQueryRun
+from langchain_community.tools.google_trends.tool import GoogleTrendsQueryRun
+from langchain_community.tools.metaphor_search.tool import MetaphorSearchResults
+from langchain_community.tools.google_jobs.tool import GoogleJobsQueryRun
+from langchain_community.tools.google_serper.tool import (
+    GoogleSerperResults,
+    GoogleSerperRun,
+)
+from langchain_community.tools.searchapi.tool import SearchAPIResults, SearchAPIRun
+from langchain_community.tools.graphql.tool import BaseGraphQLTool
+from langchain_community.tools.human.tool import HumanInputRun
+from langchain_community.tools.requests.tool import (
+    RequestsDeleteTool,
+    RequestsGetTool,
+    RequestsPatchTool,
+    RequestsPostTool,
+    RequestsPutTool,
+)
+from langchain_community.tools.eleven_labs.text2speech import ElevenLabsText2SpeechTool
+from langchain_community.tools.scenexplain.tool import SceneXplainTool
+from langchain_community.tools.searx_search.tool import (
+    SearxSearchResults,
+    SearxSearchRun,
+)
+from langchain_community.tools.shell.tool import ShellTool
+from langchain_community.tools.sleep.tool import SleepTool
+from langchain_community.tools.stackexchange.tool import StackExchangeTool
+from langchain_community.tools.merriam_webster.tool import MerriamWebsterQueryRun
+from langchain_community.tools.wikipedia.tool import WikipediaQueryRun
+from langchain_community.tools.wolfram_alpha.tool import WolframAlphaQueryRun
+from langchain_community.tools.openweathermap.tool import OpenWeatherMapQueryRun
+from langchain_community.tools.dataforseo_api_search import DataForSeoAPISearchRun
+from langchain_community.tools.dataforseo_api_search import DataForSeoAPISearchResults
+from langchain_community.tools.memorize.tool import Memorize
+from langchain_community.tools.reddit_search.tool import RedditSearchRun
+from langchain_community.utilities.arxiv import ArxivAPIWrapper
+from langchain_community.utilities.golden_query import GoldenQueryAPIWrapper
+from langchain_community.utilities.pubmed import PubMedAPIWrapper
+from langchain_community.utilities.bing_search import BingSearchAPIWrapper
+from langchain_community.utilities.duckduckgo_search import DuckDuckGoSearchAPIWrapper
+from langchain_community.utilities.google_lens import GoogleLensAPIWrapper
+from langchain_community.utilities.google_jobs import GoogleJobsAPIWrapper
+from langchain_community.utilities.google_search import GoogleSearchAPIWrapper
+from langchain_community.utilities.google_serper import GoogleSerperAPIWrapper
+from langchain_community.utilities.google_scholar import GoogleScholarAPIWrapper
+from langchain_community.utilities.google_finance import GoogleFinanceAPIWrapper
+from langchain_community.utilities.google_trends import GoogleTrendsAPIWrapper
+from langchain_community.utilities.metaphor_search import MetaphorSearchAPIWrapper
+from langchain_community.utilities.awslambda import LambdaWrapper
+from langchain_community.utilities.graphql import GraphQLAPIWrapper
+from langchain_community.utilities.searchapi import SearchApiAPIWrapper
+from langchain_community.utilities.searx_search import SearxSearchWrapper
+from langchain_community.utilities.serpapi import SerpAPIWrapper
+from langchain_community.utilities.stackexchange import StackExchangeAPIWrapper
+from langchain_community.utilities.twilio import TwilioAPIWrapper
+from langchain_community.utilities.merriam_webster import MerriamWebsterAPIWrapper
+from langchain_community.utilities.wikipedia import WikipediaAPIWrapper
+from langchain_community.utilities.wolfram_alpha import WolframAlphaAPIWrapper
+from langchain_community.utilities.openweathermap import OpenWeatherMapAPIWrapper
+from langchain_community.utilities.dataforseo_api_search import DataForSeoAPIWrapper
+from langchain_community.utilities.reddit_search import RedditSearchAPIWrapper
+
+
+def _get_tools_requests_get() -> BaseTool:
+    # Dangerous requests are allowed here, because there's another flag that the user
+    # has to provide in order to actually opt in.
+    # This is a private function and should not be used directly.
+    return RequestsGetTool(
+        requests_wrapper=TextRequestsWrapper(), allow_dangerous_requests=True
+    )
+
+
+def _get_tools_requests_post() -> BaseTool:
+    # Dangerous requests are allowed here, because there's another flag that the user
+    # has to provide in order to actually opt in.
+    # This is a private function and should not be used directly.
+    return RequestsPostTool(
+        requests_wrapper=TextRequestsWrapper(), allow_dangerous_requests=True
+    )
+
+
+def _get_tools_requests_patch() -> BaseTool:
+    # Dangerous requests are allowed here, because there's another flag that the user
+    # has to provide in order to actually opt in.
+    # This is a private function and should not be used directly.
+    return RequestsPatchTool(
+        requests_wrapper=TextRequestsWrapper(), allow_dangerous_requests=True
+    )
+
+
+def _get_tools_requests_put() -> BaseTool:
+    # Dangerous requests are allowed here, because there's another flag that the user
+    # has to provide in order to actually opt in.
+    # This is a private function and should not be used directly.
+    return RequestsPutTool(
+        requests_wrapper=TextRequestsWrapper(), allow_dangerous_requests=True
+    )
+
+
+def _get_tools_requests_delete() -> BaseTool:
+    # Dangerous requests are allowed here, because there's another flag that the user
+    # has to provide in order to actually opt in.
+    # This is a private function and should not be used directly.
+    return RequestsDeleteTool(
+        requests_wrapper=TextRequestsWrapper(), allow_dangerous_requests=True
+    )
+
+
+def _get_terminal() -> BaseTool:
+    return ShellTool()
+
+
+def _get_sleep() -> BaseTool:
+    return SleepTool()
+
+
+_BASE_TOOLS: Dict[str, Callable[[], BaseTool]] = {
+    "sleep": _get_sleep,
+}
+
+DANGEROUS_TOOLS = {
+    # Tools that contain some level of risk.
+    # Please use with caution and read the documentation of these tools
+    # to understand the risks and how to mitigate them.
+    # Refer to https://python.langchain.com/docs/security
+    # for more information.
+    "requests": _get_tools_requests_get,  # preserved for backwards compatibility
+    "requests_get": _get_tools_requests_get,
+    "requests_post": _get_tools_requests_post,
+    "requests_patch": _get_tools_requests_patch,
+    "requests_put": _get_tools_requests_put,
+    "requests_delete": _get_tools_requests_delete,
+    "terminal": _get_terminal,
+}
+
+
+def _get_llm_math(llm: BaseLanguageModel) -> BaseTool:
+    return Tool(
+        name="Calculator",
+        description="Useful for when you need to answer questions about math.",
+        func=LLMMathChain.from_llm(llm=llm).run,
+        coroutine=LLMMathChain.from_llm(llm=llm).arun,
+    )
+
+
+def _get_open_meteo_api(llm: BaseLanguageModel) -> BaseTool:
+    chain = APIChain.from_llm_and_api_docs(
+        llm,
+        open_meteo_docs.OPEN_METEO_DOCS,
+        limit_to_domains=["https://api.open-meteo.com/"],
+    )
+    return Tool(
+        name="Open-Meteo-API",
+        description="Useful for when you want to get weather information from the OpenMeteo API. The input should be a question in natural language that this API can answer.",
+        func=chain.run,
+    )
+
+
+_LLM_TOOLS: Dict[str, Callable[[BaseLanguageModel], BaseTool]] = {
+    "llm-math": _get_llm_math,
+    "open-meteo-api": _get_open_meteo_api,
+}
+
+
+def _get_news_api(llm: BaseLanguageModel, **kwargs: Any) -> BaseTool:
+    news_api_key = kwargs["news_api_key"]
+    chain = APIChain.from_llm_and_api_docs(
+        llm,
+        news_docs.NEWS_DOCS,
+        headers={"X-Api-Key": news_api_key},
+        limit_to_domains=["https://newsapi.org/"],
+    )
+    return Tool(
+        name="News-API",
+        description="Use this when you want to get information about the top headlines of current news stories. The input should be a question in natural language that this API can answer.",
+        func=chain.run,
+    )
+
+
+def _get_tmdb_api(llm: BaseLanguageModel, **kwargs: Any) -> BaseTool:
+    tmdb_bearer_token = kwargs["tmdb_bearer_token"]
+    chain = APIChain.from_llm_and_api_docs(
+        llm,
+        tmdb_docs.TMDB_DOCS,
+        headers={"Authorization": f"Bearer {tmdb_bearer_token}"},
+        limit_to_domains=["https://api.themoviedb.org/"],
+    )
+    return Tool(
+        name="TMDB-API",
+        description="Useful for when you want to get information from The Movie Database. The input should be a question in natural language that this API can answer.",
+        func=chain.run,
+    )
+
+
+def _get_podcast_api(llm: BaseLanguageModel, **kwargs: Any) -> BaseTool:
+    listen_api_key = kwargs["listen_api_key"]
+    chain = APIChain.from_llm_and_api_docs(
+        llm,
+        podcast_docs.PODCAST_DOCS,
+        headers={"X-ListenAPI-Key": listen_api_key},
+        limit_to_domains=["https://listen-api.listennotes.com/"],
+    )
+    return Tool(
+        name="Podcast-API",
+        description="Use the Listen Notes Podcast API to search all podcasts or episodes. The input should be a question in natural language that this API can answer.",
+        func=chain.run,
+    )
+
+
+def _get_lambda_api(**kwargs: Any) -> BaseTool:
+    return Tool(
+        name=kwargs["awslambda_tool_name"],
+        description=kwargs["awslambda_tool_description"],
+        func=LambdaWrapper(**kwargs).run,
+    )
+
+
+def _get_wolfram_alpha(**kwargs: Any) -> BaseTool:
+    return WolframAlphaQueryRun(api_wrapper=WolframAlphaAPIWrapper(**kwargs))
+
+
+def _get_google_search(**kwargs: Any) -> BaseTool:
+    return GoogleSearchRun(api_wrapper=GoogleSearchAPIWrapper(**kwargs))
+
+
+def _get_merriam_webster(**kwargs: Any) -> BaseTool:
+    return MerriamWebsterQueryRun(api_wrapper=MerriamWebsterAPIWrapper(**kwargs))
+
+
+def _get_wikipedia(**kwargs: Any) -> BaseTool:
+    return WikipediaQueryRun(api_wrapper=WikipediaAPIWrapper(**kwargs))
+
+
+def _get_arxiv(**kwargs: Any) -> BaseTool:
+    return ArxivQueryRun(api_wrapper=ArxivAPIWrapper(**kwargs))
+
+
+def _get_golden_query(**kwargs: Any) -> BaseTool:
+    return GoldenQueryRun(api_wrapper=GoldenQueryAPIWrapper(**kwargs))
+
+
+def _get_pubmed(**kwargs: Any) -> BaseTool:
+    return PubmedQueryRun(api_wrapper=PubMedAPIWrapper(**kwargs))
+
+
+def _get_google_jobs(**kwargs: Any) -> BaseTool:
+    return GoogleJobsQueryRun(api_wrapper=GoogleJobsAPIWrapper(**kwargs))
+
+
+def _get_google_lens(**kwargs: Any) -> BaseTool:
+    return GoogleLensQueryRun(api_wrapper=GoogleLensAPIWrapper(**kwargs))
+
+
+def _get_google_serper(**kwargs: Any) -> BaseTool:
+    return GoogleSerperRun(api_wrapper=GoogleSerperAPIWrapper(**kwargs))
+
+
+def _get_google_scholar(**kwargs: Any) -> BaseTool:
+    return GoogleScholarQueryRun(api_wrapper=GoogleScholarAPIWrapper(**kwargs))
+
+
+def _get_google_finance(**kwargs: Any) -> BaseTool:
+    return GoogleFinanceQueryRun(api_wrapper=GoogleFinanceAPIWrapper(**kwargs))
+
+
+def _get_google_trends(**kwargs: Any) -> BaseTool:
+    return GoogleTrendsQueryRun(api_wrapper=GoogleTrendsAPIWrapper(**kwargs))
+
+
+def _get_google_serper_results_json(**kwargs: Any) -> BaseTool:
+    return GoogleSerperResults(api_wrapper=GoogleSerperAPIWrapper(**kwargs))
+
+
+def _get_google_search_results_json(**kwargs: Any) -> BaseTool:
+    return GoogleSearchResults(api_wrapper=GoogleSearchAPIWrapper(**kwargs))
+
+
+def _get_searchapi(**kwargs: Any) -> BaseTool:
+    return SearchAPIRun(api_wrapper=SearchApiAPIWrapper(**kwargs))
+
+
+def _get_searchapi_results_json(**kwargs: Any) -> BaseTool:
+    return SearchAPIResults(api_wrapper=SearchApiAPIWrapper(**kwargs))
+
+
+def _get_serpapi(**kwargs: Any) -> BaseTool:
+    return Tool(
+        name="Search",
+        description="A search engine. Useful for when you need to answer questions about current events. Input should be a search query.",
+        func=SerpAPIWrapper(**kwargs).run,
+        coroutine=SerpAPIWrapper(**kwargs).arun,
+    )
+
+
+def _get_stackexchange(**kwargs: Any) -> BaseTool:
+    return StackExchangeTool(api_wrapper=StackExchangeAPIWrapper(**kwargs))
+
+
+def _get_dalle_image_generator(**kwargs: Any) -> Tool:
+    return Tool(
+        "Dall-E-Image-Generator",
+        DallEAPIWrapper(**kwargs).run,
+        "A wrapper around OpenAI DALL-E API. Useful for when you need to generate images from a text description. Input should be an image description.",
+    )
+
+
+def _get_twilio(**kwargs: Any) -> BaseTool:
+    return Tool(
+        name="Text-Message",
+        description="Useful for when you need to send a text message to a provided phone number.",
+        func=TwilioAPIWrapper(**kwargs).run,
+    )
+
+
+def _get_searx_search(**kwargs: Any) -> BaseTool:
+    return SearxSearchRun(wrapper=SearxSearchWrapper(**kwargs))
+
+
+def _get_searx_search_results_json(**kwargs: Any) -> BaseTool:
+    wrapper_kwargs = {k: v for k, v in kwargs.items() if k != "num_results"}
+    return SearxSearchResults(wrapper=SearxSearchWrapper(**wrapper_kwargs), **kwargs)
+
+
+def _get_bing_search(**kwargs: Any) -> BaseTool:
+    return BingSearchRun(api_wrapper=BingSearchAPIWrapper(**kwargs))
+
+
+def _get_metaphor_search(**kwargs: Any) -> BaseTool:
+    return MetaphorSearchResults(api_wrapper=MetaphorSearchAPIWrapper(**kwargs))
+
+
+def _get_ddg_search(**kwargs: Any) -> BaseTool:
+    return DuckDuckGoSearchRun(api_wrapper=DuckDuckGoSearchAPIWrapper(**kwargs))
+
+
+def _get_human_tool(**kwargs: Any) -> BaseTool:
+    return HumanInputRun(**kwargs)
+
+
+def _get_scenexplain(**kwargs: Any) -> BaseTool:
+    return SceneXplainTool(**kwargs)
+
+
+def _get_graphql_tool(**kwargs: Any) -> BaseTool:
+    return BaseGraphQLTool(graphql_wrapper=GraphQLAPIWrapper(**kwargs))
+
+
+def _get_openweathermap(**kwargs: Any) -> BaseTool:
+    return OpenWeatherMapQueryRun(api_wrapper=OpenWeatherMapAPIWrapper(**kwargs))
+
+
+def _get_dataforseo_api_search(**kwargs: Any) -> BaseTool:
+    return DataForSeoAPISearchRun(api_wrapper=DataForSeoAPIWrapper(**kwargs))
+
+
+def _get_dataforseo_api_search_json(**kwargs: Any) -> BaseTool:
+    return DataForSeoAPISearchResults(api_wrapper=DataForSeoAPIWrapper(**kwargs))
+
+
+def _get_eleven_labs_text2speech(**kwargs: Any) -> BaseTool:
+    return ElevenLabsText2SpeechTool(**kwargs)
+
+
+def _get_memorize(llm: BaseLanguageModel, **kwargs: Any) -> BaseTool:
+    return Memorize(llm=llm)  # type: ignore[arg-type]
+
+
+def _get_google_cloud_texttospeech(**kwargs: Any) -> BaseTool:
+    return GoogleCloudTextToSpeechTool(**kwargs)
+
+
+def _get_file_management_tool(**kwargs: Any) -> BaseTool:
+    return ReadFileTool(**kwargs)
+
+
+def _get_reddit_search(**kwargs: Any) -> BaseTool:
+    return RedditSearchRun(api_wrapper=RedditSearchAPIWrapper(**kwargs))
+
+
+_EXTRA_LLM_TOOLS: Dict[
+    str,
+    Tuple[Callable[[Arg(BaseLanguageModel, "llm"), KwArg(Any)], BaseTool], List[str]],
+] = {
+    "news-api": (_get_news_api, ["news_api_key"]),
+    "tmdb-api": (_get_tmdb_api, ["tmdb_bearer_token"]),
+    "podcast-api": (_get_podcast_api, ["listen_api_key"]),
+    "memorize": (_get_memorize, []),
+}
+_EXTRA_OPTIONAL_TOOLS: Dict[str, Tuple[Callable[[KwArg(Any)], BaseTool], List[str]]] = {
+    "wolfram-alpha": (_get_wolfram_alpha, ["wolfram_alpha_appid"]),
+    "google-search": (_get_google_search, ["google_api_key", "google_cse_id"]),
+    "google-search-results-json": (
+        _get_google_search_results_json,
+        ["google_api_key", "google_cse_id", "num_results"],
+    ),
+    "searx-search-results-json": (
+        _get_searx_search_results_json,
+        ["searx_host", "engines", "num_results", "aiosession"],
+    ),
+    "bing-search": (_get_bing_search, ["bing_subscription_key", "bing_search_url"]),
+    "metaphor-search": (_get_metaphor_search, ["metaphor_api_key"]),
+    "ddg-search": (_get_ddg_search, []),
+    "google-lens": (_get_google_lens, ["serp_api_key"]),
+    "google-serper": (_get_google_serper, ["serper_api_key", "aiosession"]),
+    "google-scholar": (
+        _get_google_scholar,
+        ["top_k_results", "hl", "lr", "serp_api_key"],
+    ),
+    "google-finance": (
+        _get_google_finance,
+        ["serp_api_key"],
+    ),
+    "google-trends": (
+        _get_google_trends,
+        ["serp_api_key"],
+    ),
+    "google-jobs": (
+        _get_google_jobs,
+        ["serp_api_key"],
+    ),
+    "google-serper-results-json": (
+        _get_google_serper_results_json,
+        ["serper_api_key", "aiosession"],
+    ),
+    "searchapi": (_get_searchapi, ["searchapi_api_key", "aiosession"]),
+    "searchapi-results-json": (
+        _get_searchapi_results_json,
+        ["searchapi_api_key", "aiosession"],
+    ),
+    "serpapi": (_get_serpapi, ["serpapi_api_key", "aiosession"]),
+    "dalle-image-generator": (_get_dalle_image_generator, ["openai_api_key"]),
+    "twilio": (_get_twilio, ["account_sid", "auth_token", "from_number"]),
+    "searx-search": (_get_searx_search, ["searx_host", "engines", "aiosession"]),
+    "merriam-webster": (_get_merriam_webster, ["merriam_webster_api_key"]),
+    "wikipedia": (_get_wikipedia, ["top_k_results", "lang"]),
+    "arxiv": (
+        _get_arxiv,
+        ["top_k_results", "load_max_docs", "load_all_available_meta"],
+    ),
+    "golden-query": (_get_golden_query, ["golden_api_key"]),
+    "pubmed": (_get_pubmed, ["top_k_results"]),
+    "human": (_get_human_tool, ["prompt_func", "input_func"]),
+    "awslambda": (
+        _get_lambda_api,
+        ["awslambda_tool_name", "awslambda_tool_description", "function_name"],
+    ),
+    "stackexchange": (_get_stackexchange, []),
+    "sceneXplain": (_get_scenexplain, []),
+    "graphql": (
+        _get_graphql_tool,
+        ["graphql_endpoint", "custom_headers", "fetch_schema_from_transport"],
+    ),
+    "openweathermap-api": (_get_openweathermap, ["openweathermap_api_key"]),
+    "dataforseo-api-search": (
+        _get_dataforseo_api_search,
+        ["api_login", "api_password", "aiosession"],
+    ),
+    "dataforseo-api-search-json": (
+        _get_dataforseo_api_search_json,
+        ["api_login", "api_password", "aiosession"],
+    ),
+    "eleven_labs_text2speech": (_get_eleven_labs_text2speech, ["eleven_api_key"]),
+    "google_cloud_texttospeech": (_get_google_cloud_texttospeech, []),
+    "read_file": (_get_file_management_tool, []),
+    "reddit_search": (
+        _get_reddit_search,
+        ["reddit_client_id", "reddit_client_secret", "reddit_user_agent"],
+    ),
+}
+
+
+def _handle_callbacks(
+    callback_manager: Optional[BaseCallbackManager], callbacks: Callbacks
+) -> Callbacks:
+    if callback_manager is not None:
+        warnings.warn(
+            "callback_manager is deprecated. Please use callbacks instead.",
+            DeprecationWarning,
+        )
+        if callbacks is not None:
+            raise ValueError(
+                "Cannot specify both callback_manager and callbacks arguments."
+            )
+        return callback_manager
+    return callbacks
+
+
+def load_huggingface_tool(
+    task_or_repo_id: str,
+    model_repo_id: Optional[str] = None,
+    token: Optional[str] = None,
+    remote: bool = False,
+    **kwargs: Any,
+) -> BaseTool:
+    """Loads a tool from the HuggingFace Hub.
+
+    Args:
+        task_or_repo_id: Task or model repo id.
+        model_repo_id: Optional model repo id.
+        token: Optional token.
+        remote: Optional remote. Defaults to False.
+        **kwargs:
+
+    Returns:
+        A tool.
+    """
+    try:
+        from transformers import load_tool
+    except ImportError:
+        raise ImportError(
+            "HuggingFace tools require the libraries `transformers>=4.29.0`"
+            " and `huggingface_hub>=0.14.1` to be installed."
+            " Please install it with"
+            " `pip install --upgrade transformers huggingface_hub`."
+        )
+    hf_tool = load_tool(
+        task_or_repo_id,
+        model_repo_id=model_repo_id,
+        token=token,
+        remote=remote,
+        **kwargs,
+    )
+    outputs = hf_tool.outputs
+    if set(outputs) != {"text"}:
+        raise NotImplementedError("Multimodal outputs not supported yet.")
+    inputs = hf_tool.inputs
+    if set(inputs) != {"text"}:
+        raise NotImplementedError("Multimodal inputs not supported yet.")
+    return Tool.from_function(
+        hf_tool.__call__, name=hf_tool.name, description=hf_tool.description
+    )
+
+
+def load_tools(
+    tool_names: List[str],
+    llm: Optional[BaseLanguageModel] = None,
+    callbacks: Callbacks = None,
+    allow_dangerous_tools: bool = False,
+    **kwargs: Any,
+) -> List[BaseTool]:
+    """Load tools based on their name.
+
+    Tools allow agents to interact with various resources and services like
+    APIs, databases, file systems, etc.
+
+    Please scope the permissions of each tools to the minimum required for the
+    application.
+
+    For example, if an application only needs to read from a database,
+    the database tool should not be given write permissions. Moreover
+    consider scoping the permissions to only allow accessing specific
+    tables and impose user-level quota for limiting resource usage.
+
+    Please read the APIs of the individual tools to determine which configuration
+    they support.
+
+    See [Security](https://python.langchain.com/docs/security) for more information.
+
+    Args:
+        tool_names: name of tools to load.
+        llm: An optional language model, may be needed to initialize certain tools.
+        callbacks: Optional callback manager or list of callback handlers.
+            If not provided, default global callback manager will be used.
+        allow_dangerous_tools: Optional flag to allow dangerous tools.
+            Tools that contain some level of risk.
+            Please use with caution and read the documentation of these tools
+            to understand the risks and how to mitigate them.
+            Refer to https://python.langchain.com/docs/security
+            for more information.
+            Please note that this list may not be fully exhaustive.
+            It is your responsibility to understand which tools
+            you're using and the risks associated with them.
+
+    Returns:
+        List of tools.
+    """
+    tools = []
+    callbacks = _handle_callbacks(
+        callback_manager=kwargs.get("callback_manager"), callbacks=callbacks
+    )
+    for name in tool_names:
+        if name in DANGEROUS_TOOLS and not allow_dangerous_tools:
+            raise ValueError(
+                f"{name} is a dangerous tool. You cannot use it without opting in "
+                "by setting allow_dangerous_tools to True. "
+                "Most tools have some inherit risk to them merely because they are "
+                'allowed to interact with the "real world".'
+                "Please refer to LangChain security guidelines "
+                "to https://python.langchain.com/docs/security."
+                "Some tools have been designated as dangerous because they pose "
+                "risk that is not intuitively obvious. For example, a tool that "
+                "allows an agent to make requests to the web, can also be used "
+                "to make requests to a server that is only accessible from the "
+                "server hosting the code."
+                "Again, all tools carry some risk, and it's your responsibility to "
+                "understand which tools you're using and the risks associated with "
+                "them."
+            )
+
+        if name in {"requests"}:
+            warnings.warn(
+                "tool name `requests` is deprecated - "
+                "please use `requests_all` or specify the requests method"
+            )
+        if name == "requests_all":
+            # expand requests into various methods
+            requests_method_tools = [
+                _tool for _tool in _BASE_TOOLS if _tool.startswith("requests_")
+            ]
+            tool_names.extend(requests_method_tools)
+        elif name in _BASE_TOOLS:
+            tools.append(_BASE_TOOLS[name]())
+        elif name in DANGEROUS_TOOLS:
+            tools.append(DANGEROUS_TOOLS[name]())
+        elif name in _LLM_TOOLS:
+            if llm is None:
+                raise ValueError(f"Tool {name} requires an LLM to be provided")
+            tool = _LLM_TOOLS[name](llm)
+            tools.append(tool)
+        elif name in _EXTRA_LLM_TOOLS:
+            if llm is None:
+                raise ValueError(f"Tool {name} requires an LLM to be provided")
+            _get_llm_tool_func, extra_keys = _EXTRA_LLM_TOOLS[name]
+            missing_keys = set(extra_keys).difference(kwargs)
+            if missing_keys:
+                raise ValueError(
+                    f"Tool {name} requires some parameters that were not "
+                    f"provided: {missing_keys}"
+                )
+            sub_kwargs = {k: kwargs[k] for k in extra_keys}
+            tool = _get_llm_tool_func(llm=llm, **sub_kwargs)
+            tools.append(tool)
+        elif name in _EXTRA_OPTIONAL_TOOLS:
+            _get_tool_func, extra_keys = _EXTRA_OPTIONAL_TOOLS[name]
+            sub_kwargs = {k: kwargs[k] for k in extra_keys if k in kwargs}
+            tool = _get_tool_func(**sub_kwargs)
+            tools.append(tool)
+        else:
+            raise ValueError(f"Got unknown tool {name}")
+    if callbacks is not None:
+        for tool in tools:
+            tool.callbacks = callbacks
+    return tools
+
+
+def get_all_tool_names() -> List[str]:
+    """Get a list of all possible tool names."""
+    return (
+        list(_BASE_TOOLS)
+        + list(_EXTRA_OPTIONAL_TOOLS)
+        + list(_EXTRA_LLM_TOOLS)
+        + list(_LLM_TOOLS)
+        + list(DANGEROUS_TOOLS)
+    )
diff --git a/llm/Lib/site-packages/langchain/agents/loading.py b/llm/Lib/site-packages/langchain/agents/loading.py
new file mode 100644
index 0000000000000000000000000000000000000000..a5d15d24e79aa89e7cf6600d9eaaf387ddbb9a01
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/loading.py
@@ -0,0 +1,132 @@
+"""Functionality for loading agents."""
+
+import json
+import logging
+from pathlib import Path
+from typing import Any, List, Optional, Union
+
+import yaml
+from langchain_core._api import deprecated
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.tools import Tool
+
+from langchain.agents.agent import BaseMultiActionAgent, BaseSingleActionAgent
+from langchain.agents.types import AGENT_TO_CLASS
+from langchain.chains.loading import load_chain, load_chain_from_config
+
+logger = logging.getLogger(__file__)
+
+URL_BASE = "https://raw.githubusercontent.com/hwchase17/langchain-hub/master/agents/"
+
+
+def _load_agent_from_tools(
+    config: dict, llm: BaseLanguageModel, tools: List[Tool], **kwargs: Any
+) -> Union[BaseSingleActionAgent, BaseMultiActionAgent]:
+    config_type = config.pop("_type")
+    if config_type not in AGENT_TO_CLASS:
+        raise ValueError(f"Loading {config_type} agent not supported")
+
+    agent_cls = AGENT_TO_CLASS[config_type]
+    combined_config = {**config, **kwargs}
+    return agent_cls.from_llm_and_tools(llm, tools, **combined_config)
+
+
+@deprecated("0.1.0", removal="0.2.0")
+def load_agent_from_config(
+    config: dict,
+    llm: Optional[BaseLanguageModel] = None,
+    tools: Optional[List[Tool]] = None,
+    **kwargs: Any,
+) -> Union[BaseSingleActionAgent, BaseMultiActionAgent]:
+    """Load agent from Config Dict.
+
+    Args:
+        config: Config dict to load agent from.
+        llm: Language model to use as the agent.
+        tools: List of tools this agent has access to.
+        **kwargs: Additional keyword arguments passed to the agent executor.
+
+    Returns:
+        An agent executor.
+    """
+    if "_type" not in config:
+        raise ValueError("Must specify an agent Type in config")
+    load_from_tools = config.pop("load_from_llm_and_tools", False)
+    if load_from_tools:
+        if llm is None:
+            raise ValueError(
+                "If `load_from_llm_and_tools` is set to True, "
+                "then LLM must be provided"
+            )
+        if tools is None:
+            raise ValueError(
+                "If `load_from_llm_and_tools` is set to True, "
+                "then tools must be provided"
+            )
+        return _load_agent_from_tools(config, llm, tools, **kwargs)
+    config_type = config.pop("_type")
+
+    if config_type not in AGENT_TO_CLASS:
+        raise ValueError(f"Loading {config_type} agent not supported")
+
+    agent_cls = AGENT_TO_CLASS[config_type]
+    if "llm_chain" in config:
+        config["llm_chain"] = load_chain_from_config(config.pop("llm_chain"))
+    elif "llm_chain_path" in config:
+        config["llm_chain"] = load_chain(config.pop("llm_chain_path"))
+    else:
+        raise ValueError("One of `llm_chain` and `llm_chain_path` should be specified.")
+    if "output_parser" in config:
+        logger.warning(
+            "Currently loading output parsers on agent is not supported, "
+            "will just use the default one."
+        )
+        del config["output_parser"]
+
+    combined_config = {**config, **kwargs}
+    return agent_cls(**combined_config)  # type: ignore
+
+
+@deprecated("0.1.0", removal="0.2.0")
+def load_agent(
+    path: Union[str, Path], **kwargs: Any
+) -> Union[BaseSingleActionAgent, BaseMultiActionAgent]:
+    """Unified method for loading an agent from LangChainHub or local fs.
+
+    Args:
+        path: Path to the agent file.
+        **kwargs: Additional keyword arguments passed to the agent executor.
+
+    Returns:
+        An agent executor.
+    """
+    if isinstance(path, str) and path.startswith("lc://"):
+        raise RuntimeError(
+            "Loading from the deprecated github-based Hub is no longer supported. "
+            "Please use the new LangChain Hub at https://smith.langchain.com/hub "
+            "instead."
+        )
+    return _load_agent_from_file(path, **kwargs)
+
+
+def _load_agent_from_file(
+    file: Union[str, Path], **kwargs: Any
+) -> Union[BaseSingleActionAgent, BaseMultiActionAgent]:
+    """Load agent from file."""
+    valid_suffixes = {"json", "yaml"}
+    # Convert file to Path object.
+    if isinstance(file, str):
+        file_path = Path(file)
+    else:
+        file_path = file
+    # Load from either json or yaml.
+    if file_path.suffix[1:] == "json":
+        with open(file_path) as f:
+            config = json.load(f)
+    elif file_path.suffix[1:] == "yaml":
+        with open(file_path, "r") as f:
+            config = yaml.safe_load(f)
+    else:
+        raise ValueError(f"Unsupported file type, must be one of {valid_suffixes}.")
+    # Load the agent from the config now.
+    return load_agent_from_config(config, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/agents/mrkl/__init__.py b/llm/Lib/site-packages/langchain/agents/mrkl/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a86a5b510d195acb0c2a2c8b9a292a8926221eb1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/mrkl/__init__.py
@@ -0,0 +1 @@
+"""Attempt to implement MRKL systems as described in arxiv.org/pdf/2205.00445.pdf."""
diff --git a/llm/Lib/site-packages/langchain/agents/mrkl/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/mrkl/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fba059fbc5b61ae495359a84d3326892117b3726
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/mrkl/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/mrkl/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/mrkl/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2ce7c24d3c8b6818d1ba397e2c4dffc885d7ba46
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/mrkl/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/mrkl/__pycache__/output_parser.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/mrkl/__pycache__/output_parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ef2b972a7e1023dbc79d6acbd615ff1d5fd35736
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/mrkl/__pycache__/output_parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/mrkl/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/mrkl/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..502df24718937acefc52d2a5fa582b084d7b16f0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/mrkl/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/mrkl/base.py b/llm/Lib/site-packages/langchain/agents/mrkl/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..b717a728dca890dfbdf84578b1a12df5d00a5929
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/mrkl/base.py
@@ -0,0 +1,173 @@
+"""Attempt to implement MRKL systems as described in arxiv.org/pdf/2205.00445.pdf."""
+from __future__ import annotations
+
+from typing import Any, Callable, List, NamedTuple, Optional, Sequence
+
+from langchain_core._api import deprecated
+from langchain_core.callbacks import BaseCallbackManager
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import PromptTemplate
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain.agents.agent import Agent, AgentExecutor, AgentOutputParser
+from langchain.agents.agent_types import AgentType
+from langchain.agents.mrkl.output_parser import MRKLOutputParser
+from langchain.agents.mrkl.prompt import FORMAT_INSTRUCTIONS, PREFIX, SUFFIX
+from langchain.agents.tools import Tool
+from langchain.agents.utils import validate_tools_single_input
+from langchain.chains import LLMChain
+from langchain.tools.render import render_text_description
+
+
+class ChainConfig(NamedTuple):
+    """Configuration for chain to use in MRKL system.
+
+    Args:
+        action_name: Name of the action.
+        action: Action function to call.
+        action_description: Description of the action.
+    """
+
+    action_name: str
+    action: Callable
+    action_description: str
+
+
+@deprecated("0.1.0", alternative="create_react_agent", removal="0.2.0")
+class ZeroShotAgent(Agent):
+    """Agent for the MRKL chain."""
+
+    output_parser: AgentOutputParser = Field(default_factory=MRKLOutputParser)
+
+    @classmethod
+    def _get_default_output_parser(cls, **kwargs: Any) -> AgentOutputParser:
+        return MRKLOutputParser()
+
+    @property
+    def _agent_type(self) -> str:
+        """Return Identifier of agent type."""
+        return AgentType.ZERO_SHOT_REACT_DESCRIPTION
+
+    @property
+    def observation_prefix(self) -> str:
+        """Prefix to append the observation with."""
+        return "Observation: "
+
+    @property
+    def llm_prefix(self) -> str:
+        """Prefix to append the llm call with."""
+        return "Thought:"
+
+    @classmethod
+    def create_prompt(
+        cls,
+        tools: Sequence[BaseTool],
+        prefix: str = PREFIX,
+        suffix: str = SUFFIX,
+        format_instructions: str = FORMAT_INSTRUCTIONS,
+        input_variables: Optional[List[str]] = None,
+    ) -> PromptTemplate:
+        """Create prompt in the style of the zero shot agent.
+
+        Args:
+            tools: List of tools the agent will have access to, used to format the
+                prompt.
+            prefix: String to put before the list of tools.
+            suffix: String to put after the list of tools.
+            input_variables: List of input variables the final prompt will expect.
+
+        Returns:
+            A PromptTemplate with the template assembled from the pieces here.
+        """
+        tool_strings = render_text_description(list(tools))
+        tool_names = ", ".join([tool.name for tool in tools])
+        format_instructions = format_instructions.format(tool_names=tool_names)
+        template = "\n\n".join([prefix, tool_strings, format_instructions, suffix])
+        if input_variables:
+            return PromptTemplate(template=template, input_variables=input_variables)
+        return PromptTemplate.from_template(template)
+
+    @classmethod
+    def from_llm_and_tools(
+        cls,
+        llm: BaseLanguageModel,
+        tools: Sequence[BaseTool],
+        callback_manager: Optional[BaseCallbackManager] = None,
+        output_parser: Optional[AgentOutputParser] = None,
+        prefix: str = PREFIX,
+        suffix: str = SUFFIX,
+        format_instructions: str = FORMAT_INSTRUCTIONS,
+        input_variables: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Agent:
+        """Construct an agent from an LLM and tools."""
+        cls._validate_tools(tools)
+        prompt = cls.create_prompt(
+            tools,
+            prefix=prefix,
+            suffix=suffix,
+            format_instructions=format_instructions,
+            input_variables=input_variables,
+        )
+        llm_chain = LLMChain(  # type: ignore[misc]
+            llm=llm,
+            prompt=prompt,
+            callback_manager=callback_manager,
+        )
+        tool_names = [tool.name for tool in tools]
+        _output_parser = output_parser or cls._get_default_output_parser()
+        return cls(
+            llm_chain=llm_chain,
+            allowed_tools=tool_names,
+            output_parser=_output_parser,
+            **kwargs,
+        )
+
+    @classmethod
+    def _validate_tools(cls, tools: Sequence[BaseTool]) -> None:
+        validate_tools_single_input(cls.__name__, tools)
+        if len(tools) == 0:
+            raise ValueError(
+                f"Got no tools for {cls.__name__}. At least one tool must be provided."
+            )
+        for tool in tools:
+            if tool.description is None:
+                raise ValueError(
+                    f"Got a tool {tool.name} without a description. For this agent, "
+                    f"a description must always be provided."
+                )
+        super()._validate_tools(tools)
+
+
+@deprecated("0.1.0", removal="0.2.0")
+class MRKLChain(AgentExecutor):
+    """[Deprecated] Chain that implements the MRKL system."""
+
+    @classmethod
+    def from_chains(
+        cls, llm: BaseLanguageModel, chains: List[ChainConfig], **kwargs: Any
+    ) -> AgentExecutor:
+        """User friendly way to initialize the MRKL chain.
+
+        This is intended to be an easy way to get up and running with the
+        MRKL chain.
+
+        Args:
+            llm: The LLM to use as the agent LLM.
+            chains: The chains the MRKL system has access to.
+            **kwargs: parameters to be passed to initialization.
+
+        Returns:
+            An initialized MRKL chain.
+        """
+        tools = [
+            Tool(
+                name=c.action_name,
+                func=c.action,
+                description=c.action_description,
+            )
+            for c in chains
+        ]
+        agent = ZeroShotAgent.from_llm_and_tools(llm, tools)
+        return cls(agent=agent, tools=tools, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/agents/mrkl/output_parser.py b/llm/Lib/site-packages/langchain/agents/mrkl/output_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..f6489c2a79289d860755e19e05458acf262c2331
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/mrkl/output_parser.py
@@ -0,0 +1,87 @@
+import re
+from typing import Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.exceptions import OutputParserException
+
+from langchain.agents.agent import AgentOutputParser
+from langchain.agents.mrkl.prompt import FORMAT_INSTRUCTIONS
+
+FINAL_ANSWER_ACTION = "Final Answer:"
+MISSING_ACTION_AFTER_THOUGHT_ERROR_MESSAGE = (
+    "Invalid Format: Missing 'Action:' after 'Thought:"
+)
+MISSING_ACTION_INPUT_AFTER_ACTION_ERROR_MESSAGE = (
+    "Invalid Format: Missing 'Action Input:' after 'Action:'"
+)
+FINAL_ANSWER_AND_PARSABLE_ACTION_ERROR_MESSAGE = (
+    "Parsing LLM output produced both a final answer and a parse-able action:"
+)
+
+
+class MRKLOutputParser(AgentOutputParser):
+    """MRKL Output parser for the chat agent."""
+
+    format_instructions: str = FORMAT_INSTRUCTIONS
+    """Default formatting instructions"""
+
+    def get_format_instructions(self) -> str:
+        """Returns formatting instructions for the given output parser."""
+        return self.format_instructions
+
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        includes_answer = FINAL_ANSWER_ACTION in text
+        regex = (
+            r"Action\s*\d*\s*:[\s]*(.*?)[\s]*Action\s*\d*\s*Input\s*\d*\s*:[\s]*(.*)"
+        )
+        action_match = re.search(regex, text, re.DOTALL)
+        if action_match and includes_answer:
+            if text.find(FINAL_ANSWER_ACTION) < text.find(action_match.group(0)):
+                # if final answer is before the hallucination, return final answer
+                start_index = text.find(FINAL_ANSWER_ACTION) + len(FINAL_ANSWER_ACTION)
+                end_index = text.find("\n\n", start_index)
+                return AgentFinish(
+                    {"output": text[start_index:end_index].strip()}, text[:end_index]
+                )
+            else:
+                raise OutputParserException(
+                    f"{FINAL_ANSWER_AND_PARSABLE_ACTION_ERROR_MESSAGE}: {text}"
+                )
+
+        if action_match:
+            action = action_match.group(1).strip()
+            action_input = action_match.group(2)
+            tool_input = action_input.strip(" ")
+            # ensure if its a well formed SQL query we don't remove any trailing " chars
+            if tool_input.startswith("SELECT ") is False:
+                tool_input = tool_input.strip('"')
+
+            return AgentAction(action, tool_input, text)
+
+        elif includes_answer:
+            return AgentFinish(
+                {"output": text.split(FINAL_ANSWER_ACTION)[-1].strip()}, text
+            )
+
+        if not re.search(r"Action\s*\d*\s*:[\s]*(.*?)", text, re.DOTALL):
+            raise OutputParserException(
+                f"Could not parse LLM output: `{text}`",
+                observation=MISSING_ACTION_AFTER_THOUGHT_ERROR_MESSAGE,
+                llm_output=text,
+                send_to_llm=True,
+            )
+        elif not re.search(
+            r"[\s]*Action\s*\d*\s*Input\s*\d*\s*:[\s]*(.*)", text, re.DOTALL
+        ):
+            raise OutputParserException(
+                f"Could not parse LLM output: `{text}`",
+                observation=MISSING_ACTION_INPUT_AFTER_ACTION_ERROR_MESSAGE,
+                llm_output=text,
+                send_to_llm=True,
+            )
+        else:
+            raise OutputParserException(f"Could not parse LLM output: `{text}`")
+
+    @property
+    def _type(self) -> str:
+        return "mrkl"
diff --git a/llm/Lib/site-packages/langchain/agents/mrkl/prompt.py b/llm/Lib/site-packages/langchain/agents/mrkl/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..db6827b5ec79f45d1e9f2b399cc0404caa100d2a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/mrkl/prompt.py
@@ -0,0 +1,16 @@
+# flake8: noqa
+PREFIX = """Answer the following questions as best you can. You have access to the following tools:"""
+FORMAT_INSTRUCTIONS = """Use the following format:
+
+Question: the input question you must answer
+Thought: you should always think about what to do
+Action: the action to take, should be one of [{tool_names}]
+Action Input: the input to the action
+Observation: the result of the action
+... (this Thought/Action/Action Input/Observation can repeat N times)
+Thought: I now know the final answer
+Final Answer: the final answer to the original input question"""
+SUFFIX = """Begin!
+
+Question: {input}
+Thought:{agent_scratchpad}"""
diff --git a/llm/Lib/site-packages/langchain/agents/openai_assistant/__init__.py b/llm/Lib/site-packages/langchain/agents/openai_assistant/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..265c0ed88f316356bc592173d8877895b8783b3e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/openai_assistant/__init__.py
@@ -0,0 +1,3 @@
+from langchain.agents.openai_assistant.base import OpenAIAssistantRunnable
+
+__all__ = ["OpenAIAssistantRunnable"]
diff --git a/llm/Lib/site-packages/langchain/agents/openai_assistant/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/openai_assistant/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a8c75859c9ba43f6ead0c0f135ec90455c385862
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/openai_assistant/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/openai_assistant/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/openai_assistant/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..31ee4f1e86f8fd16042c9cee35e9c053bf294a5c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/openai_assistant/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/openai_assistant/base.py b/llm/Lib/site-packages/langchain/agents/openai_assistant/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..a7571debf626bc84c6721ce8d98f85667e2c48d4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/openai_assistant/base.py
@@ -0,0 +1,723 @@
+from __future__ import annotations
+
+import json
+from json import JSONDecodeError
+from time import sleep
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+)
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import CallbackManager
+from langchain_core.load import dumpd
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+from langchain_core.runnables import RunnableConfig, RunnableSerializable, ensure_config
+from langchain_core.tools import BaseTool
+from langchain_core.utils.function_calling import convert_to_openai_tool
+
+if TYPE_CHECKING:
+    import openai
+    from openai.types.beta.threads import ThreadMessage
+    from openai.types.beta.threads.required_action_function_tool_call import (
+        RequiredActionFunctionToolCall,
+    )
+
+
+class OpenAIAssistantFinish(AgentFinish):
+    """AgentFinish with run and thread metadata."""
+
+    run_id: str
+    thread_id: str
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+
+class OpenAIAssistantAction(AgentAction):
+    """AgentAction with info needed to submit custom tool output to existing run."""
+
+    tool_call_id: str
+    run_id: str
+    thread_id: str
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+
+def _get_openai_client() -> openai.OpenAI:
+    try:
+        import openai
+
+        return openai.OpenAI()
+    except ImportError as e:
+        raise ImportError(
+            "Unable to import openai, please install with `pip install openai`."
+        ) from e
+    except AttributeError as e:
+        raise AttributeError(
+            "Please make sure you are using a v1.1-compatible version of openai. You "
+            'can install with `pip install "openai>=1.1"`.'
+        ) from e
+
+
+def _get_openai_async_client() -> openai.AsyncOpenAI:
+    try:
+        import openai
+
+        return openai.AsyncOpenAI()
+    except ImportError as e:
+        raise ImportError(
+            "Unable to import openai, please install with `pip install openai`."
+        ) from e
+    except AttributeError as e:
+        raise AttributeError(
+            "Please make sure you are using a v1.1-compatible version of openai. You "
+            'can install with `pip install "openai>=1.1"`.'
+        ) from e
+
+
+def _is_assistants_builtin_tool(
+    tool: Union[Dict[str, Any], Type[BaseModel], Callable, BaseTool],
+) -> bool:
+    """Determine if tool corresponds to OpenAI Assistants built-in."""
+    assistants_builtin_tools = ("code_interpreter", "retrieval")
+    return (
+        isinstance(tool, dict)
+        and ("type" in tool)
+        and (tool["type"] in assistants_builtin_tools)
+    )
+
+
+def _get_assistants_tool(
+    tool: Union[Dict[str, Any], Type[BaseModel], Callable, BaseTool],
+) -> Dict[str, Any]:
+    """Convert a raw function/class to an OpenAI tool.
+
+    Note that OpenAI assistants supports several built-in tools,
+    such as "code_interpreter" and "retrieval."
+    """
+    if _is_assistants_builtin_tool(tool):
+        return tool  # type: ignore
+    else:
+        return convert_to_openai_tool(tool)
+
+
+OutputType = Union[
+    List[OpenAIAssistantAction],
+    OpenAIAssistantFinish,
+    List["ThreadMessage"],
+    List["RequiredActionFunctionToolCall"],
+]
+
+
+class OpenAIAssistantRunnable(RunnableSerializable[Dict, OutputType]):
+    """Run an OpenAI Assistant.
+
+    Example using OpenAI tools:
+        .. code-block:: python
+
+            from langchain_experimental.openai_assistant import OpenAIAssistantRunnable
+
+            interpreter_assistant = OpenAIAssistantRunnable.create_assistant(
+                name="langchain assistant",
+                instructions="You are a personal math tutor. Write and run code to answer math questions.",
+                tools=[{"type": "code_interpreter"}],
+                model="gpt-4-1106-preview"
+            )
+            output = interpreter_assistant.invoke({"content": "What's 10 - 4 raised to the 2.7"})
+
+    Example using custom tools and AgentExecutor:
+        .. code-block:: python
+
+            from langchain_experimental.openai_assistant import OpenAIAssistantRunnable
+            from langchain.agents import AgentExecutor
+            from langchain.tools import E2BDataAnalysisTool
+
+
+            tools = [E2BDataAnalysisTool(api_key="...")]
+            agent = OpenAIAssistantRunnable.create_assistant(
+                name="langchain assistant e2b tool",
+                instructions="You are a personal math tutor. Write and run code to answer math questions.",
+                tools=tools,
+                model="gpt-4-1106-preview",
+                as_agent=True
+            )
+
+            agent_executor = AgentExecutor(agent=agent, tools=tools)
+            agent_executor.invoke({"content": "What's 10 - 4 raised to the 2.7"})
+
+
+    Example using custom tools and custom execution:
+        .. code-block:: python
+
+            from langchain_experimental.openai_assistant import OpenAIAssistantRunnable
+            from langchain.agents import AgentExecutor
+            from langchain_core.agents import AgentFinish
+            from langchain.tools import E2BDataAnalysisTool
+
+
+            tools = [E2BDataAnalysisTool(api_key="...")]
+            agent = OpenAIAssistantRunnable.create_assistant(
+                name="langchain assistant e2b tool",
+                instructions="You are a personal math tutor. Write and run code to answer math questions.",
+                tools=tools,
+                model="gpt-4-1106-preview",
+                as_agent=True
+            )
+
+            def execute_agent(agent, tools, input):
+                tool_map = {tool.name: tool for tool in tools}
+                response = agent.invoke(input)
+                while not isinstance(response, AgentFinish):
+                    tool_outputs = []
+                    for action in response:
+                        tool_output = tool_map[action.tool].invoke(action.tool_input)
+                        tool_outputs.append({"output": tool_output, "tool_call_id": action.tool_call_id})
+                    response = agent.invoke(
+                        {
+                            "tool_outputs": tool_outputs,
+                            "run_id": action.run_id,
+                            "thread_id": action.thread_id
+                        }
+                    )
+
+                return response
+
+            response = execute_agent(agent, tools, {"content": "What's 10 - 4 raised to the 2.7"})
+            next_response = execute_agent(agent, tools, {"content": "now add 17.241", "thread_id": response.thread_id})
+
+    """  # noqa: E501
+
+    client: Any = Field(default_factory=_get_openai_client)
+    """OpenAI or AzureOpenAI client."""
+    async_client: Any = None
+    """OpenAI or AzureOpenAI async client."""
+    assistant_id: str
+    """OpenAI assistant id."""
+    check_every_ms: float = 1_000.0
+    """Frequency with which to check run progress in ms."""
+    as_agent: bool = False
+    """Use as a LangChain agent, compatible with the AgentExecutor."""
+
+    @root_validator()
+    def validate_async_client(cls, values: dict) -> dict:
+        if values["async_client"] is None:
+            import openai
+
+            api_key = values["client"].api_key
+            values["async_client"] = openai.AsyncOpenAI(api_key=api_key)
+        return values
+
+    @classmethod
+    def create_assistant(
+        cls,
+        name: str,
+        instructions: str,
+        tools: Sequence[Union[BaseTool, dict]],
+        model: str,
+        *,
+        client: Optional[Union[openai.OpenAI, openai.AzureOpenAI]] = None,
+        **kwargs: Any,
+    ) -> OpenAIAssistantRunnable:
+        """Create an OpenAI Assistant and instantiate the Runnable.
+
+        Args:
+            name: Assistant name.
+            instructions: Assistant instructions.
+            tools: Assistant tools. Can be passed in OpenAI format or as BaseTools.
+            model: Assistant model to use.
+            client: OpenAI or AzureOpenAI client.
+                Will create default OpenAI client if not specified.
+
+        Returns:
+            OpenAIAssistantRunnable configured to run using the created assistant.
+        """
+        client = client or _get_openai_client()
+        assistant = client.beta.assistants.create(
+            name=name,
+            instructions=instructions,
+            tools=[_get_assistants_tool(tool) for tool in tools],  # type: ignore
+            model=model,
+            file_ids=kwargs.get("file_ids"),
+        )
+        return cls(assistant_id=assistant.id, client=client, **kwargs)
+
+    def invoke(
+        self, input: dict, config: Optional[RunnableConfig] = None
+    ) -> OutputType:
+        """Invoke assistant.
+
+        Args:
+            input: Runnable input dict that can have:
+                content: User message when starting a new run.
+                thread_id: Existing thread to use.
+                run_id: Existing run to use. Should only be supplied when providing
+                    the tool output for a required action after an initial invocation.
+                file_ids: File ids to include in new run. Used for retrieval.
+                message_metadata: Metadata to associate with new message.
+                thread_metadata: Metadata to associate with new thread. Only relevant
+                    when new thread being created.
+                instructions: Additional run instructions.
+                model: Override Assistant model for this run.
+                tools: Override Assistant tools for this run.
+                run_metadata: Metadata to associate with new run.
+            config: Runnable config:
+
+        Return:
+            If self.as_agent, will return
+                Union[List[OpenAIAssistantAction], OpenAIAssistantFinish]. Otherwise,
+                will return OpenAI types
+                Union[List[ThreadMessage], List[RequiredActionFunctionToolCall]].
+        """
+
+        config = ensure_config(config)
+        callback_manager = CallbackManager.configure(
+            inheritable_callbacks=config.get("callbacks"),
+            inheritable_tags=config.get("tags"),
+            inheritable_metadata=config.get("metadata"),
+        )
+        run_manager = callback_manager.on_chain_start(
+            dumpd(self), input, name=config.get("run_name")
+        )
+        try:
+            # Being run within AgentExecutor and there are tool outputs to submit.
+            if self.as_agent and input.get("intermediate_steps"):
+                tool_outputs = self._parse_intermediate_steps(
+                    input["intermediate_steps"]
+                )
+                run = self.client.beta.threads.runs.submit_tool_outputs(**tool_outputs)
+            # Starting a new thread and a new run.
+            elif "thread_id" not in input:
+                thread = {
+                    "messages": [
+                        {
+                            "role": "user",
+                            "content": input["content"],
+                            "file_ids": input.get("file_ids", []),
+                            "metadata": input.get("message_metadata"),
+                        }
+                    ],
+                    "metadata": input.get("thread_metadata"),
+                }
+                run = self._create_thread_and_run(input, thread)
+            # Starting a new run in an existing thread.
+            elif "run_id" not in input:
+                _ = self.client.beta.threads.messages.create(
+                    input["thread_id"],
+                    content=input["content"],
+                    role="user",
+                    file_ids=input.get("file_ids", []),
+                    metadata=input.get("message_metadata"),
+                )
+                run = self._create_run(input)
+            # Submitting tool outputs to an existing run, outside the AgentExecutor
+            # framework.
+            else:
+                run = self.client.beta.threads.runs.submit_tool_outputs(**input)
+            run = self._wait_for_run(run.id, run.thread_id)
+        except BaseException as e:
+            run_manager.on_chain_error(e)
+            raise e
+        try:
+            response = self._get_response(run)
+        except BaseException as e:
+            run_manager.on_chain_error(e, metadata=run.dict())
+            raise e
+        else:
+            run_manager.on_chain_end(response)
+            return response
+
+    @classmethod
+    async def acreate_assistant(
+        cls,
+        name: str,
+        instructions: str,
+        tools: Sequence[Union[BaseTool, dict]],
+        model: str,
+        *,
+        async_client: Optional[
+            Union[openai.AsyncOpenAI, openai.AsyncAzureOpenAI]
+        ] = None,
+        **kwargs: Any,
+    ) -> OpenAIAssistantRunnable:
+        """Create an AsyncOpenAI Assistant and instantiate the Runnable.
+
+        Args:
+            name: Assistant name.
+            instructions: Assistant instructions.
+            tools: Assistant tools. Can be passed in OpenAI format or as BaseTools.
+            model: Assistant model to use.
+            async_client: AsyncOpenAI client.
+            Will create default async_client if not specified.
+
+        Returns:
+            AsyncOpenAIAssistantRunnable configured to run using the created assistant.
+        """
+        async_client = async_client or _get_openai_async_client()
+        openai_tools = [_get_assistants_tool(tool) for tool in tools]
+        assistant = await async_client.beta.assistants.create(
+            name=name,
+            instructions=instructions,
+            tools=openai_tools,  # type: ignore
+            model=model,
+            file_ids=kwargs.get("file_ids"),
+        )
+        return cls(assistant_id=assistant.id, async_client=async_client, **kwargs)
+
+    async def ainvoke(
+        self, input: dict, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> OutputType:
+        """Async invoke assistant.
+
+        Args:
+            input: Runnable input dict that can have:
+                content: User message when starting a new run.
+                thread_id: Existing thread to use.
+                run_id: Existing run to use. Should only be supplied when providing
+                    the tool output for a required action after an initial invocation.
+                file_ids: File ids to include in new run. Used for retrieval.
+                message_metadata: Metadata to associate with new message.
+                thread_metadata: Metadata to associate with new thread. Only relevant
+                    when new thread being created.
+                instructions: Additional run instructions.
+                model: Override Assistant model for this run.
+                tools: Override Assistant tools for this run.
+                run_metadata: Metadata to associate with new run.
+            config: Runnable config:
+
+        Return:
+            If self.as_agent, will return
+                Union[List[OpenAIAssistantAction], OpenAIAssistantFinish]. Otherwise,
+                will return OpenAI types
+                Union[List[ThreadMessage], List[RequiredActionFunctionToolCall]].
+        """
+
+        config = config or {}
+        callback_manager = CallbackManager.configure(
+            inheritable_callbacks=config.get("callbacks"),
+            inheritable_tags=config.get("tags"),
+            inheritable_metadata=config.get("metadata"),
+        )
+        run_manager = callback_manager.on_chain_start(
+            dumpd(self), input, name=config.get("run_name")
+        )
+        try:
+            # Being run within AgentExecutor and there are tool outputs to submit.
+            if self.as_agent and input.get("intermediate_steps"):
+                tool_outputs = self._parse_intermediate_steps(
+                    input["intermediate_steps"]
+                )
+                run = await self.async_client.beta.threads.runs.submit_tool_outputs(
+                    **tool_outputs
+                )
+            # Starting a new thread and a new run.
+            elif "thread_id" not in input:
+                thread = {
+                    "messages": [
+                        {
+                            "role": "user",
+                            "content": input["content"],
+                            "file_ids": input.get("file_ids", []),
+                            "metadata": input.get("message_metadata"),
+                        }
+                    ],
+                    "metadata": input.get("thread_metadata"),
+                }
+                run = await self._create_thread_and_run(input, thread)
+            # Starting a new run in an existing thread.
+            elif "run_id" not in input:
+                _ = await self.async_client.beta.threads.messages.create(
+                    input["thread_id"],
+                    content=input["content"],
+                    role="user",
+                    file_ids=input.get("file_ids", []),
+                    metadata=input.get("message_metadata"),
+                )
+                run = await self._create_run(input)
+            # Submitting tool outputs to an existing run, outside the AgentExecutor
+            # framework.
+            else:
+                run = await self.async_client.beta.threads.runs.submit_tool_outputs(
+                    **input
+                )
+            run = await self._wait_for_run(run.id, run.thread_id)
+        except BaseException as e:
+            run_manager.on_chain_error(e)
+            raise e
+        try:
+            response = self._get_response(run)
+        except BaseException as e:
+            run_manager.on_chain_error(e, metadata=run.dict())
+            raise e
+        else:
+            run_manager.on_chain_end(response)
+            return response
+
+    def _parse_intermediate_steps(
+        self, intermediate_steps: List[Tuple[OpenAIAssistantAction, str]]
+    ) -> dict:
+        last_action, last_output = intermediate_steps[-1]
+        run = self._wait_for_run(last_action.run_id, last_action.thread_id)
+        required_tool_call_ids = {
+            tc.id for tc in run.required_action.submit_tool_outputs.tool_calls
+        }
+        tool_outputs = [
+            {"output": str(output), "tool_call_id": action.tool_call_id}
+            for action, output in intermediate_steps
+            if action.tool_call_id in required_tool_call_ids
+        ]
+        submit_tool_outputs = {
+            "tool_outputs": tool_outputs,
+            "run_id": last_action.run_id,
+            "thread_id": last_action.thread_id,
+        }
+        return submit_tool_outputs
+
+    def _create_run(self, input: dict) -> Any:
+        params = {
+            k: v
+            for k, v in input.items()
+            if k in ("instructions", "model", "tools", "run_metadata")
+        }
+        return self.client.beta.threads.runs.create(
+            input["thread_id"],
+            assistant_id=self.assistant_id,
+            **params,
+        )
+
+    def _create_thread_and_run(self, input: dict, thread: dict) -> Any:
+        params = {
+            k: v
+            for k, v in input.items()
+            if k in ("instructions", "model", "tools", "run_metadata")
+        }
+        run = self.client.beta.threads.create_and_run(
+            assistant_id=self.assistant_id,
+            thread=thread,
+            **params,
+        )
+        return run
+
+    def _get_response(self, run: Any) -> Any:
+        # TODO: Pagination
+
+        if run.status == "completed":
+            import openai
+
+            major_version = int(openai.version.VERSION.split(".")[0])
+            minor_version = int(openai.version.VERSION.split(".")[1])
+            version_gte_1_14 = (major_version > 1) or (
+                major_version == 1 and minor_version >= 14
+            )
+
+            messages = self.client.beta.threads.messages.list(
+                run.thread_id, order="asc"
+            )
+            new_messages = [msg for msg in messages if msg.run_id == run.id]
+            if not self.as_agent:
+                return new_messages
+            answer: Any = [
+                msg_content for msg in new_messages for msg_content in msg.content
+            ]
+            if all(
+                (
+                    isinstance(content, openai.types.beta.threads.TextContentBlock)
+                    if version_gte_1_14
+                    else isinstance(
+                        content, openai.types.beta.threads.MessageContentText
+                    )
+                )
+                for content in answer
+            ):
+                answer = "\n".join(content.text.value for content in answer)
+            return OpenAIAssistantFinish(
+                return_values={
+                    "output": answer,
+                    "thread_id": run.thread_id,
+                    "run_id": run.id,
+                },
+                log="",
+                run_id=run.id,
+                thread_id=run.thread_id,
+            )
+        elif run.status == "requires_action":
+            if not self.as_agent:
+                return run.required_action.submit_tool_outputs.tool_calls
+            actions = []
+            for tool_call in run.required_action.submit_tool_outputs.tool_calls:
+                function = tool_call.function
+                try:
+                    args = json.loads(function.arguments, strict=False)
+                except JSONDecodeError as e:
+                    raise ValueError(
+                        f"Received invalid JSON function arguments: "
+                        f"{function.arguments} for function {function.name}"
+                    ) from e
+                if len(args) == 1 and "__arg1" in args:
+                    args = args["__arg1"]
+                actions.append(
+                    OpenAIAssistantAction(
+                        tool=function.name,
+                        tool_input=args,
+                        tool_call_id=tool_call.id,
+                        log="",
+                        run_id=run.id,
+                        thread_id=run.thread_id,
+                    )
+                )
+            return actions
+        else:
+            run_info = json.dumps(run.dict(), indent=2)
+            raise ValueError(
+                f"Unexpected run status: {run.status}. Full run info:\n\n{run_info})"
+            )
+
+    def _wait_for_run(self, run_id: str, thread_id: str) -> Any:
+        in_progress = True
+        while in_progress:
+            run = self.client.beta.threads.runs.retrieve(run_id, thread_id=thread_id)
+            in_progress = run.status in ("in_progress", "queued")
+            if in_progress:
+                sleep(self.check_every_ms / 1000)
+        return run
+
+    async def _aparse_intermediate_steps(
+        self, intermediate_steps: List[Tuple[OpenAIAssistantAction, str]]
+    ) -> dict:
+        last_action, last_output = intermediate_steps[-1]
+        run = await self._wait_for_run(last_action.run_id, last_action.thread_id)
+        required_tool_call_ids = {
+            tc.id for tc in run.required_action.submit_tool_outputs.tool_calls
+        }
+        tool_outputs = [
+            {"output": str(output), "tool_call_id": action.tool_call_id}
+            for action, output in intermediate_steps
+            if action.tool_call_id in required_tool_call_ids
+        ]
+        submit_tool_outputs = {
+            "tool_outputs": tool_outputs,
+            "run_id": last_action.run_id,
+            "thread_id": last_action.thread_id,
+        }
+        return submit_tool_outputs
+
+    async def _acreate_run(self, input: dict) -> Any:
+        params = {
+            k: v
+            for k, v in input.items()
+            if k in ("instructions", "model", "tools", "run_metadata")
+        }
+        return await self.async_client.beta.threads.runs.create(
+            input["thread_id"],
+            assistant_id=self.assistant_id,
+            **params,
+        )
+
+    async def _acreate_thread_and_run(self, input: dict, thread: dict) -> Any:
+        params = {
+            k: v
+            for k, v in input.items()
+            if k in ("instructions", "model", "tools", "run_metadata")
+        }
+        run = await self.async_client.beta.threads.create_and_run(
+            assistant_id=self.assistant_id,
+            thread=thread,
+            **params,
+        )
+        return run
+
+    async def _aget_response(self, run: Any) -> Any:
+        # TODO: Pagination
+
+        if run.status == "completed":
+            import openai
+
+            major_version = int(openai.version.VERSION.split(".")[0])
+            minor_version = int(openai.version.VERSION.split(".")[1])
+            version_gte_1_14 = (major_version > 1) or (
+                major_version == 1 and minor_version >= 14
+            )
+
+            messages = await self.async_client.beta.threads.messages.list(
+                run.thread_id, order="asc"
+            )
+            new_messages = [msg for msg in messages if msg.run_id == run.id]
+            if not self.as_agent:
+                return new_messages
+            answer: Any = [
+                msg_content for msg in new_messages for msg_content in msg.content
+            ]
+            if all(
+                (
+                    isinstance(content, openai.types.beta.threads.TextContentBlock)
+                    if version_gte_1_14
+                    else isinstance(
+                        content, openai.types.beta.threads.MessageContentText
+                    )
+                )
+                for content in answer
+            ):
+                answer = "\n".join(content.text.value for content in answer)
+            return OpenAIAssistantFinish(
+                return_values={
+                    "output": answer,
+                    "thread_id": run.thread_id,
+                    "run_id": run.id,
+                },
+                log="",
+                run_id=run.id,
+                thread_id=run.thread_id,
+            )
+        elif run.status == "requires_action":
+            if not self.as_agent:
+                return run.required_action.submit_tool_outputs.tool_calls
+            actions = []
+            for tool_call in run.required_action.submit_tool_outputs.tool_calls:
+                function = tool_call.function
+                try:
+                    args = json.loads(function.arguments, strict=False)
+                except JSONDecodeError as e:
+                    raise ValueError(
+                        f"Received invalid JSON function arguments: "
+                        f"{function.arguments} for function {function.name}"
+                    ) from e
+                if len(args) == 1 and "__arg1" in args:
+                    args = args["__arg1"]
+                actions.append(
+                    OpenAIAssistantAction(
+                        tool=function.name,
+                        tool_input=args,
+                        tool_call_id=tool_call.id,
+                        log="",
+                        run_id=run.id,
+                        thread_id=run.thread_id,
+                    )
+                )
+            return actions
+        else:
+            run_info = json.dumps(run.dict(), indent=2)
+            raise ValueError(
+                f"Unexpected run status: {run.status}. Full run info:\n\n{run_info})"
+            )
+
+    async def _await_for_run(self, run_id: str, thread_id: str) -> Any:
+        in_progress = True
+        while in_progress:
+            run = await self.async_client.beta.threads.runs.retrieve(
+                run_id, thread_id=thread_id
+            )
+            in_progress = run.status in ("in_progress", "queued")
+            if in_progress:
+                sleep(self.check_every_ms / 1000)
+        return run
diff --git a/llm/Lib/site-packages/langchain/agents/openai_functions_agent/__init__.py b/llm/Lib/site-packages/langchain/agents/openai_functions_agent/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/agents/openai_functions_agent/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/openai_functions_agent/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ecdb9de92bc3e20649a6f96809456e3caf3d24f2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/openai_functions_agent/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/openai_functions_agent/__pycache__/agent_token_buffer_memory.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/openai_functions_agent/__pycache__/agent_token_buffer_memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a32d6db9387bd9f64b01971743aa34b97a656de9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/openai_functions_agent/__pycache__/agent_token_buffer_memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/openai_functions_agent/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/openai_functions_agent/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..917202829a40e331398a8d56a506dcc74d8c31f3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/openai_functions_agent/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/openai_functions_agent/agent_token_buffer_memory.py b/llm/Lib/site-packages/langchain/agents/openai_functions_agent/agent_token_buffer_memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe976ddb28643b365185bc546f8861ed11b66a40
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/openai_functions_agent/agent_token_buffer_memory.py
@@ -0,0 +1,66 @@
+"""Memory used to save agent output AND intermediate steps."""
+from typing import Any, Dict, List
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.messages import BaseMessage, get_buffer_string
+
+from langchain.agents.format_scratchpad.openai_functions import (
+    format_to_openai_function_messages,
+)
+from langchain.memory.chat_memory import BaseChatMemory
+
+
+class AgentTokenBufferMemory(BaseChatMemory):
+    """Memory used to save agent output AND intermediate steps."""
+
+    human_prefix: str = "Human"
+    ai_prefix: str = "AI"
+    llm: BaseLanguageModel
+    memory_key: str = "history"
+    max_token_limit: int = 12000
+    """The max number of tokens to keep in the buffer. 
+    Once the buffer exceeds this many tokens, the oldest messages will be pruned."""
+    return_messages: bool = True
+    output_key: str = "output"
+    intermediate_steps_key: str = "intermediate_steps"
+
+    @property
+    def buffer(self) -> List[BaseMessage]:
+        """String buffer of memory."""
+        return self.chat_memory.messages
+
+    @property
+    def memory_variables(self) -> List[str]:
+        """Will always return list of memory variables.
+
+        :meta private:
+        """
+        return [self.memory_key]
+
+    def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, Any]:
+        """Return history buffer."""
+        if self.return_messages:
+            final_buffer: Any = self.buffer
+        else:
+            final_buffer = get_buffer_string(
+                self.buffer,
+                human_prefix=self.human_prefix,
+                ai_prefix=self.ai_prefix,
+            )
+        return {self.memory_key: final_buffer}
+
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, Any]) -> None:
+        """Save context from this conversation to buffer. Pruned."""
+        input_str, output_str = self._get_input_output(inputs, outputs)
+        self.chat_memory.add_user_message(input_str)
+        steps = format_to_openai_function_messages(outputs[self.intermediate_steps_key])
+        for msg in steps:
+            self.chat_memory.add_message(msg)
+        self.chat_memory.add_ai_message(output_str)
+        # Prune buffer if it exceeds max token limit
+        buffer = self.chat_memory.messages
+        curr_buffer_length = self.llm.get_num_tokens_from_messages(buffer)
+        if curr_buffer_length > self.max_token_limit:
+            while curr_buffer_length > self.max_token_limit:
+                buffer.pop(0)
+                curr_buffer_length = self.llm.get_num_tokens_from_messages(buffer)
diff --git a/llm/Lib/site-packages/langchain/agents/openai_functions_agent/base.py b/llm/Lib/site-packages/langchain/agents/openai_functions_agent/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..3eed77bbe326d278402d62f24de2c9c59c964dcd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/openai_functions_agent/base.py
@@ -0,0 +1,319 @@
+"""Module implements an agent that uses OpenAI's APIs function enabled API."""
+from typing import Any, List, Optional, Sequence, Tuple, Type, Union
+
+from langchain_core._api import deprecated
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackManager, Callbacks
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.messages import (
+    BaseMessage,
+    SystemMessage,
+)
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.prompts.chat import (
+    BaseMessagePromptTemplate,
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+    MessagesPlaceholder,
+)
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.runnables import Runnable, RunnablePassthrough
+from langchain_core.tools import BaseTool
+from langchain_core.utils.function_calling import convert_to_openai_function
+
+from langchain.agents import BaseSingleActionAgent
+from langchain.agents.format_scratchpad.openai_functions import (
+    format_to_openai_function_messages,
+)
+from langchain.agents.output_parsers.openai_functions import (
+    OpenAIFunctionsAgentOutputParser,
+)
+
+
+@deprecated("0.1.0", alternative="create_openai_functions_agent", removal="0.2.0")
+class OpenAIFunctionsAgent(BaseSingleActionAgent):
+    """An Agent driven by OpenAIs function powered API.
+
+    Args:
+        llm: This should be an instance of ChatOpenAI, specifically a model
+            that supports using `functions`.
+        tools: The tools this agent has access to.
+        prompt: The prompt for this agent, should support agent_scratchpad as one
+            of the variables. For an easy way to construct this prompt, use
+            `OpenAIFunctionsAgent.create_prompt(...)`
+    """
+
+    llm: BaseLanguageModel
+    tools: Sequence[BaseTool]
+    prompt: BasePromptTemplate
+    output_parser: Type[
+        OpenAIFunctionsAgentOutputParser
+    ] = OpenAIFunctionsAgentOutputParser
+
+    def get_allowed_tools(self) -> List[str]:
+        """Get allowed tools."""
+        return [t.name for t in self.tools]
+
+    @root_validator
+    def validate_prompt(cls, values: dict) -> dict:
+        prompt: BasePromptTemplate = values["prompt"]
+        if "agent_scratchpad" not in prompt.input_variables:
+            raise ValueError(
+                "`agent_scratchpad` should be one of the variables in the prompt, "
+                f"got {prompt.input_variables}"
+            )
+        return values
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Get input keys. Input refers to user input here."""
+        return ["input"]
+
+    @property
+    def functions(self) -> List[dict]:
+        return [dict(convert_to_openai_function(t)) for t in self.tools]
+
+    def plan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        with_functions: bool = True,
+        **kwargs: Any,
+    ) -> Union[AgentAction, AgentFinish]:
+        """Given input, decided what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date, along with observations
+            **kwargs: User inputs.
+
+        Returns:
+            Action specifying what tool to use.
+        """
+        agent_scratchpad = format_to_openai_function_messages(intermediate_steps)
+        selected_inputs = {
+            k: kwargs[k] for k in self.prompt.input_variables if k != "agent_scratchpad"
+        }
+        full_inputs = dict(**selected_inputs, agent_scratchpad=agent_scratchpad)
+        prompt = self.prompt.format_prompt(**full_inputs)
+        messages = prompt.to_messages()
+        if with_functions:
+            predicted_message = self.llm.predict_messages(
+                messages,
+                functions=self.functions,
+                callbacks=callbacks,
+            )
+        else:
+            predicted_message = self.llm.predict_messages(
+                messages,
+                callbacks=callbacks,
+            )
+        agent_decision = self.output_parser._parse_ai_message(predicted_message)
+        return agent_decision
+
+    async def aplan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[AgentAction, AgentFinish]:
+        """Given input, decided what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with observations
+            **kwargs: User inputs.
+
+        Returns:
+            Action specifying what tool to use.
+        """
+        agent_scratchpad = format_to_openai_function_messages(intermediate_steps)
+        selected_inputs = {
+            k: kwargs[k] for k in self.prompt.input_variables if k != "agent_scratchpad"
+        }
+        full_inputs = dict(**selected_inputs, agent_scratchpad=agent_scratchpad)
+        prompt = self.prompt.format_prompt(**full_inputs)
+        messages = prompt.to_messages()
+        predicted_message = await self.llm.apredict_messages(
+            messages, functions=self.functions, callbacks=callbacks
+        )
+        agent_decision = self.output_parser._parse_ai_message(predicted_message)
+        return agent_decision
+
+    def return_stopped_response(
+        self,
+        early_stopping_method: str,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        **kwargs: Any,
+    ) -> AgentFinish:
+        """Return response when agent has been stopped due to max iterations."""
+        if early_stopping_method == "force":
+            # `force` just returns a constant string
+            return AgentFinish(
+                {"output": "Agent stopped due to iteration limit or time limit."}, ""
+            )
+        elif early_stopping_method == "generate":
+            # Generate does one final forward pass
+            agent_decision = self.plan(
+                intermediate_steps, with_functions=False, **kwargs
+            )
+            if isinstance(agent_decision, AgentFinish):
+                return agent_decision
+            else:
+                raise ValueError(
+                    f"got AgentAction with no functions provided: {agent_decision}"
+                )
+        else:
+            raise ValueError(
+                "early_stopping_method should be one of `force` or `generate`, "
+                f"got {early_stopping_method}"
+            )
+
+    @classmethod
+    def create_prompt(
+        cls,
+        system_message: Optional[SystemMessage] = SystemMessage(
+            content="You are a helpful AI assistant."
+        ),
+        extra_prompt_messages: Optional[List[BaseMessagePromptTemplate]] = None,
+    ) -> ChatPromptTemplate:
+        """Create prompt for this agent.
+
+        Args:
+            system_message: Message to use as the system message that will be the
+                first in the prompt.
+            extra_prompt_messages: Prompt messages that will be placed between the
+                system message and the new human input.
+
+        Returns:
+            A prompt template to pass into this agent.
+        """
+        _prompts = extra_prompt_messages or []
+        messages: List[Union[BaseMessagePromptTemplate, BaseMessage]]
+        if system_message:
+            messages = [system_message]
+        else:
+            messages = []
+
+        messages.extend(
+            [
+                *_prompts,
+                HumanMessagePromptTemplate.from_template("{input}"),
+                MessagesPlaceholder(variable_name="agent_scratchpad"),
+            ]
+        )
+        return ChatPromptTemplate(messages=messages)  # type: ignore[arg-type, call-arg]
+
+    @classmethod
+    def from_llm_and_tools(
+        cls,
+        llm: BaseLanguageModel,
+        tools: Sequence[BaseTool],
+        callback_manager: Optional[BaseCallbackManager] = None,
+        extra_prompt_messages: Optional[List[BaseMessagePromptTemplate]] = None,
+        system_message: Optional[SystemMessage] = SystemMessage(
+            content="You are a helpful AI assistant."
+        ),
+        **kwargs: Any,
+    ) -> BaseSingleActionAgent:
+        """Construct an agent from an LLM and tools."""
+        prompt = cls.create_prompt(
+            extra_prompt_messages=extra_prompt_messages,
+            system_message=system_message,
+        )
+        return cls(  # type: ignore[call-arg]
+            llm=llm,
+            prompt=prompt,
+            tools=tools,
+            callback_manager=callback_manager,
+            **kwargs,
+        )
+
+
+def create_openai_functions_agent(
+    llm: BaseLanguageModel, tools: Sequence[BaseTool], prompt: ChatPromptTemplate
+) -> Runnable:
+    """Create an agent that uses OpenAI function calling.
+
+    Args:
+        llm: LLM to use as the agent. Should work with OpenAI function calling,
+            so either be an OpenAI model that supports that or a wrapper of
+            a different model that adds in equivalent support.
+        tools: Tools this agent has access to.
+        prompt: The prompt to use. See Prompt section below for more.
+
+    Returns:
+        A Runnable sequence representing an agent. It takes as input all the same input
+        variables as the prompt passed in does. It returns as output either an
+        AgentAction or AgentFinish.
+
+    Example:
+
+        Creating an agent with no memory
+
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatOpenAI
+            from langchain.agents import AgentExecutor, create_openai_functions_agent
+            from langchain import hub
+
+            prompt = hub.pull("hwchase17/openai-functions-agent")
+            model = ChatOpenAI()
+            tools = ...
+
+            agent = create_openai_functions_agent(model, tools, prompt)
+            agent_executor = AgentExecutor(agent=agent, tools=tools)
+
+            agent_executor.invoke({"input": "hi"})
+
+            # Using with chat history
+            from langchain_core.messages import AIMessage, HumanMessage
+            agent_executor.invoke(
+                {
+                    "input": "what's my name?",
+                    "chat_history": [
+                        HumanMessage(content="hi! my name is bob"),
+                        AIMessage(content="Hello Bob! How can I assist you today?"),
+                    ],
+                }
+            )
+
+    Prompt:
+
+        The agent prompt must have an `agent_scratchpad` key that is a
+            ``MessagesPlaceholder``. Intermediate agent actions and tool output
+            messages will be passed in here.
+
+        Here's an example:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder
+
+            prompt = ChatPromptTemplate.from_messages(
+                [
+                    ("system", "You are a helpful assistant"),
+                    MessagesPlaceholder("chat_history", optional=True),
+                    ("human", "{input}"),
+                    MessagesPlaceholder("agent_scratchpad"),
+                ]
+            )
+    """
+    if "agent_scratchpad" not in (
+        prompt.input_variables + list(prompt.partial_variables)
+    ):
+        raise ValueError(
+            "Prompt must have input variable `agent_scratchpad`, but wasn't found. "
+            f"Found {prompt.input_variables} instead."
+        )
+    llm_with_tools = llm.bind(functions=[convert_to_openai_function(t) for t in tools])
+    agent = (
+        RunnablePassthrough.assign(
+            agent_scratchpad=lambda x: format_to_openai_function_messages(
+                x["intermediate_steps"]
+            )
+        )
+        | prompt
+        | llm_with_tools
+        | OpenAIFunctionsAgentOutputParser()
+    )
+    return agent
diff --git a/llm/Lib/site-packages/langchain/agents/openai_functions_multi_agent/__init__.py b/llm/Lib/site-packages/langchain/agents/openai_functions_multi_agent/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/agents/openai_functions_multi_agent/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/openai_functions_multi_agent/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dcd153130be17d2f9626bdbf94383f30677f968d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/openai_functions_multi_agent/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/openai_functions_multi_agent/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/openai_functions_multi_agent/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9a6c07e1a871cedeb5edb4adf0f9f9ab1f22bdcc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/openai_functions_multi_agent/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/openai_functions_multi_agent/base.py b/llm/Lib/site-packages/langchain/agents/openai_functions_multi_agent/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..f59a751136f94d0a5b29db74eb05625441ea9d37
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/openai_functions_multi_agent/base.py
@@ -0,0 +1,307 @@
+"""Module implements an agent that uses OpenAI's APIs function enabled API."""
+import json
+from json import JSONDecodeError
+from typing import Any, List, Optional, Sequence, Tuple, Union
+
+from langchain_core._api import deprecated
+from langchain_core.agents import AgentAction, AgentActionMessageLog, AgentFinish
+from langchain_core.callbacks import BaseCallbackManager, Callbacks
+from langchain_core.exceptions import OutputParserException
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    SystemMessage,
+)
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.prompts.chat import (
+    BaseMessagePromptTemplate,
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+    MessagesPlaceholder,
+)
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+
+from langchain.agents import BaseMultiActionAgent
+from langchain.agents.format_scratchpad.openai_functions import (
+    format_to_openai_function_messages,
+)
+
+# For backwards compatibility
+_FunctionsAgentAction = AgentActionMessageLog
+
+
+def _parse_ai_message(message: BaseMessage) -> Union[List[AgentAction], AgentFinish]:
+    """Parse an AI message."""
+    if not isinstance(message, AIMessage):
+        raise TypeError(f"Expected an AI message got {type(message)}")
+
+    function_call = message.additional_kwargs.get("function_call", {})
+
+    if function_call:
+        try:
+            arguments = json.loads(function_call["arguments"], strict=False)
+        except JSONDecodeError:
+            raise OutputParserException(
+                f"Could not parse tool input: {function_call} because "
+                f"the `arguments` is not valid JSON."
+            )
+
+        try:
+            tools = arguments["actions"]
+        except (TypeError, KeyError):
+            raise OutputParserException(
+                f"Could not parse tool input: {function_call} because "
+                f"the `arguments` JSON does not contain `actions` key."
+            )
+
+        final_tools: List[AgentAction] = []
+        for tool_schema in tools:
+            if "action" in tool_schema:
+                _tool_input = tool_schema["action"]
+            else:
+                # drop action_name from schema
+                _tool_input = tool_schema.copy()
+                del _tool_input["action_name"]
+            function_name = tool_schema["action_name"]
+
+            # HACK HACK HACK:
+            # The code that encodes tool input into Open AI uses a special variable
+            # name called `__arg1` to handle old style tools that do not expose a
+            # schema and expect a single string argument as an input.
+            # We unpack the argument here if it exists.
+            # Open AI does not support passing in a JSON array as an argument.
+            if "__arg1" in _tool_input:
+                tool_input = _tool_input["__arg1"]
+            else:
+                tool_input = _tool_input
+
+            content_msg = f"responded: {message.content}\n" if message.content else "\n"
+            log = f"\nInvoking: `{function_name}` with `{tool_input}`\n{content_msg}\n"
+            _tool = _FunctionsAgentAction(
+                tool=function_name,
+                tool_input=tool_input,
+                log=log,
+                message_log=[message],
+            )
+            final_tools.append(_tool)
+        return final_tools
+
+    return AgentFinish(
+        return_values={"output": message.content}, log=str(message.content)
+    )
+
+
+@deprecated("0.1.0", alternative="create_openai_tools_agent", removal="0.2.0")
+class OpenAIMultiFunctionsAgent(BaseMultiActionAgent):
+    """An Agent driven by OpenAIs function powered API.
+
+    Args:
+        llm: This should be an instance of ChatOpenAI, specifically a model
+            that supports using `functions`.
+        tools: The tools this agent has access to.
+        prompt: The prompt for this agent, should support agent_scratchpad as one
+            of the variables. For an easy way to construct this prompt, use
+            `OpenAIMultiFunctionsAgent.create_prompt(...)`
+    """
+
+    llm: BaseLanguageModel
+    tools: Sequence[BaseTool]
+    prompt: BasePromptTemplate
+
+    def get_allowed_tools(self) -> List[str]:
+        """Get allowed tools."""
+        return [t.name for t in self.tools]
+
+    @root_validator
+    def validate_prompt(cls, values: dict) -> dict:
+        prompt: BasePromptTemplate = values["prompt"]
+        if "agent_scratchpad" not in prompt.input_variables:
+            raise ValueError(
+                "`agent_scratchpad` should be one of the variables in the prompt, "
+                f"got {prompt.input_variables}"
+            )
+        return values
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Get input keys. Input refers to user input here."""
+        return ["input"]
+
+    @property
+    def functions(self) -> List[dict]:
+        enum_vals = [t.name for t in self.tools]
+        tool_selection = {
+            # OpenAI functions returns a single tool invocation
+            # Here we force the single tool invocation it returns to
+            # itself be a list of tool invocations. We do this by constructing
+            # a new tool that has one argument which is a list of tools
+            # to use.
+            "name": "tool_selection",
+            "description": "A list of actions to take.",
+            "parameters": {
+                "title": "tool_selection",
+                "description": "A list of actions to take.",
+                "type": "object",
+                "properties": {
+                    "actions": {
+                        "title": "actions",
+                        "type": "array",
+                        "items": {
+                            # This is a custom item which bundles the action_name
+                            # and the action. We do this because some actions
+                            # could have the same schema, and without this there
+                            # is no way to differentiate them.
+                            "title": "tool_call",
+                            "type": "object",
+                            "properties": {
+                                # This is the name of the action to take
+                                "action_name": {
+                                    "title": "action_name",
+                                    "enum": enum_vals,
+                                    "type": "string",
+                                    "description": (
+                                        "Name of the action to take. The name "
+                                        "provided here should match up with the "
+                                        "parameters for the action below."
+                                    ),
+                                },
+                                # This is the action to take.
+                                "action": {
+                                    "title": "Action",
+                                    "anyOf": [
+                                        {
+                                            "title": t.name,
+                                            "type": "object",
+                                            "properties": t.args,
+                                        }
+                                        for t in self.tools
+                                    ],
+                                },
+                            },
+                            "required": ["action_name", "action"],
+                        },
+                    }
+                },
+                "required": ["actions"],
+            },
+        }
+        return [tool_selection]
+
+    def plan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[List[AgentAction], AgentFinish]:
+        """Given input, decided what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date, along with observations
+            **kwargs: User inputs.
+
+        Returns:
+            Action specifying what tool to use.
+        """
+        agent_scratchpad = format_to_openai_function_messages(intermediate_steps)
+        selected_inputs = {
+            k: kwargs[k] for k in self.prompt.input_variables if k != "agent_scratchpad"
+        }
+        full_inputs = dict(**selected_inputs, agent_scratchpad=agent_scratchpad)
+        prompt = self.prompt.format_prompt(**full_inputs)
+        messages = prompt.to_messages()
+        predicted_message = self.llm.predict_messages(
+            messages, functions=self.functions, callbacks=callbacks
+        )
+        agent_decision = _parse_ai_message(predicted_message)
+        return agent_decision
+
+    async def aplan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[List[AgentAction], AgentFinish]:
+        """Given input, decided what to do.
+
+        Args:
+            intermediate_steps: Steps the LLM has taken to date,
+                along with observations
+            **kwargs: User inputs.
+
+        Returns:
+            Action specifying what tool to use.
+        """
+        agent_scratchpad = format_to_openai_function_messages(intermediate_steps)
+        selected_inputs = {
+            k: kwargs[k] for k in self.prompt.input_variables if k != "agent_scratchpad"
+        }
+        full_inputs = dict(**selected_inputs, agent_scratchpad=agent_scratchpad)
+        prompt = self.prompt.format_prompt(**full_inputs)
+        messages = prompt.to_messages()
+        predicted_message = await self.llm.apredict_messages(
+            messages, functions=self.functions, callbacks=callbacks
+        )
+        agent_decision = _parse_ai_message(predicted_message)
+        return agent_decision
+
+    @classmethod
+    def create_prompt(
+        cls,
+        system_message: Optional[SystemMessage] = SystemMessage(
+            content="You are a helpful AI assistant."
+        ),
+        extra_prompt_messages: Optional[List[BaseMessagePromptTemplate]] = None,
+    ) -> BasePromptTemplate:
+        """Create prompt for this agent.
+
+        Args:
+            system_message: Message to use as the system message that will be the
+                first in the prompt.
+            extra_prompt_messages: Prompt messages that will be placed between the
+                system message and the new human input.
+
+        Returns:
+            A prompt template to pass into this agent.
+        """
+        _prompts = extra_prompt_messages or []
+        messages: List[Union[BaseMessagePromptTemplate, BaseMessage]]
+        if system_message:
+            messages = [system_message]
+        else:
+            messages = []
+
+        messages.extend(
+            [
+                *_prompts,
+                HumanMessagePromptTemplate.from_template("{input}"),
+                MessagesPlaceholder(variable_name="agent_scratchpad"),
+            ]
+        )
+        return ChatPromptTemplate(messages=messages)  # type: ignore[arg-type, call-arg]
+
+    @classmethod
+    def from_llm_and_tools(
+        cls,
+        llm: BaseLanguageModel,
+        tools: Sequence[BaseTool],
+        callback_manager: Optional[BaseCallbackManager] = None,
+        extra_prompt_messages: Optional[List[BaseMessagePromptTemplate]] = None,
+        system_message: Optional[SystemMessage] = SystemMessage(
+            content="You are a helpful AI assistant."
+        ),
+        **kwargs: Any,
+    ) -> BaseMultiActionAgent:
+        """Construct an agent from an LLM and tools."""
+        prompt = cls.create_prompt(
+            extra_prompt_messages=extra_prompt_messages,
+            system_message=system_message,
+        )
+        return cls(  # type: ignore[call-arg]
+            llm=llm,
+            prompt=prompt,
+            tools=tools,
+            callback_manager=callback_manager,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/agents/openai_tools/__init__.py b/llm/Lib/site-packages/langchain/agents/openai_tools/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/agents/openai_tools/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/openai_tools/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a99054d84c07789481cd7c2583ab2a30051632f1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/openai_tools/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/openai_tools/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/openai_tools/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6762087c84becb43eb11293632fdc1c035e5832c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/openai_tools/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/openai_tools/base.py b/llm/Lib/site-packages/langchain/agents/openai_tools/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff2eface92e0783199ee001d05174211a0b305c3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/openai_tools/base.py
@@ -0,0 +1,99 @@
+from typing import Sequence
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts.chat import ChatPromptTemplate
+from langchain_core.runnables import Runnable, RunnablePassthrough
+from langchain_core.tools import BaseTool
+from langchain_core.utils.function_calling import convert_to_openai_tool
+
+from langchain.agents.format_scratchpad.openai_tools import (
+    format_to_openai_tool_messages,
+)
+from langchain.agents.output_parsers.openai_tools import OpenAIToolsAgentOutputParser
+
+
+def create_openai_tools_agent(
+    llm: BaseLanguageModel, tools: Sequence[BaseTool], prompt: ChatPromptTemplate
+) -> Runnable:
+    """Create an agent that uses OpenAI tools.
+
+    Args:
+        llm: LLM to use as the agent.
+        tools: Tools this agent has access to.
+        prompt: The prompt to use. See Prompt section below for more on the expected
+            input variables.
+
+    Returns:
+        A Runnable sequence representing an agent. It takes as input all the same input
+        variables as the prompt passed in does. It returns as output either an
+        AgentAction or AgentFinish.
+
+    Example:
+
+        .. code-block:: python
+
+            from langchain import hub
+            from langchain_community.chat_models import ChatOpenAI
+            from langchain.agents import AgentExecutor, create_openai_tools_agent
+
+            prompt = hub.pull("hwchase17/openai-tools-agent")
+            model = ChatOpenAI()
+            tools = ...
+
+            agent = create_openai_tools_agent(model, tools, prompt)
+            agent_executor = AgentExecutor(agent=agent, tools=tools)
+
+            agent_executor.invoke({"input": "hi"})
+
+            # Using with chat history
+            from langchain_core.messages import AIMessage, HumanMessage
+            agent_executor.invoke(
+                {
+                    "input": "what's my name?",
+                    "chat_history": [
+                        HumanMessage(content="hi! my name is bob"),
+                        AIMessage(content="Hello Bob! How can I assist you today?"),
+                    ],
+                }
+            )
+
+    Prompt:
+
+        The agent prompt must have an `agent_scratchpad` key that is a
+            ``MessagesPlaceholder``. Intermediate agent actions and tool output
+            messages will be passed in here.
+
+        Here's an example:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder
+
+            prompt = ChatPromptTemplate.from_messages(
+                [
+                    ("system", "You are a helpful assistant"),
+                    MessagesPlaceholder("chat_history", optional=True),
+                    ("human", "{input}"),
+                    MessagesPlaceholder("agent_scratchpad"),
+                ]
+            )
+    """
+    missing_vars = {"agent_scratchpad"}.difference(
+        prompt.input_variables + list(prompt.partial_variables)
+    )
+    if missing_vars:
+        raise ValueError(f"Prompt missing required variables: {missing_vars}")
+
+    llm_with_tools = llm.bind(tools=[convert_to_openai_tool(tool) for tool in tools])
+
+    agent = (
+        RunnablePassthrough.assign(
+            agent_scratchpad=lambda x: format_to_openai_tool_messages(
+                x["intermediate_steps"]
+            )
+        )
+        | prompt
+        | llm_with_tools
+        | OpenAIToolsAgentOutputParser()
+    )
+    return agent
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/__init__.py b/llm/Lib/site-packages/langchain/agents/output_parsers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ffbef5313ae87568c6355531a9d17306d02dd0de
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/output_parsers/__init__.py
@@ -0,0 +1,34 @@
+"""Parsing utils to go from string to AgentAction or Agent Finish.
+
+AgentAction means that an action should be taken.
+This contains the name of the tool to use, the input to pass to that tool,
+and a `log` variable (which contains a log of the agent's thinking).
+
+AgentFinish means that a response should be given.
+This contains a `return_values` dictionary. This usually contains a
+single `output` key, but can be extended to contain more.
+This also contains a `log` variable (which contains a log of the agent's thinking).
+"""
+from langchain.agents.output_parsers.json import JSONAgentOutputParser
+from langchain.agents.output_parsers.openai_functions import (
+    OpenAIFunctionsAgentOutputParser,
+)
+from langchain.agents.output_parsers.react_json_single_input import (
+    ReActJsonSingleInputOutputParser,
+)
+from langchain.agents.output_parsers.react_single_input import (
+    ReActSingleInputOutputParser,
+)
+from langchain.agents.output_parsers.self_ask import SelfAskOutputParser
+from langchain.agents.output_parsers.tools import ToolsAgentOutputParser
+from langchain.agents.output_parsers.xml import XMLAgentOutputParser
+
+__all__ = [
+    "ReActSingleInputOutputParser",
+    "SelfAskOutputParser",
+    "ToolsAgentOutputParser",
+    "ReActJsonSingleInputOutputParser",
+    "OpenAIFunctionsAgentOutputParser",
+    "XMLAgentOutputParser",
+    "JSONAgentOutputParser",
+]
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..71c81dd021d6e02c05de8d26175a93928b794425
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/json.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/json.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..054b0d1e0775f420c86edb552d06c51e5ad005e3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/json.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/openai_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/openai_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4ec8acc43c5742605470d2d2be0b69f676ab8cd3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/openai_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/openai_tools.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/openai_tools.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..73ea86abe2d7f29cc3b153c4db67ae9ce4b1d11f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/openai_tools.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/react_json_single_input.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/react_json_single_input.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..91956afa0883fd6df204ecfc6bbfeae77014b484
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/react_json_single_input.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/react_single_input.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/react_single_input.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5e9be785c2bd97f15a321011f08a4aa98d04e56e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/react_single_input.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/self_ask.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/self_ask.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1b1c27586db371d3f44c8c9c49c37f07098aee40
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/self_ask.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/tools.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/tools.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..20f3616e9c6df57755206762d06230f767927162
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/tools.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/xml.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/xml.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f138aafc332db59285a6da745ae8d588caaed112
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/output_parsers/__pycache__/xml.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/json.py b/llm/Lib/site-packages/langchain/agents/output_parsers/json.py
new file mode 100644
index 0000000000000000000000000000000000000000..2dbc56178ff0ab682853961de8aac6de9b7ac81e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/output_parsers/json.py
@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+import logging
+from typing import Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.exceptions import OutputParserException
+from langchain_core.output_parsers.json import parse_json_markdown
+
+from langchain.agents.agent import AgentOutputParser
+
+logger = logging.getLogger(__name__)
+
+
+class JSONAgentOutputParser(AgentOutputParser):
+    """Parses tool invocations and final answers in JSON format.
+
+    Expects output to be in one of two formats.
+
+    If the output signals that an action should be taken,
+    should be in the below format. This will result in an AgentAction
+    being returned.
+
+    ```
+    {
+      "action": "search",
+      "action_input": "2+2"
+    }
+    ```
+
+    If the output signals that a final answer should be given,
+    should be in the below format. This will result in an AgentFinish
+    being returned.
+
+    ```
+    {
+      "action": "Final Answer",
+      "action_input": "4"
+    }
+    ```
+    """
+
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        try:
+            response = parse_json_markdown(text)
+            if isinstance(response, list):
+                # gpt turbo frequently ignores the directive to emit a single action
+                logger.warning("Got multiple action responses: %s", response)
+                response = response[0]
+            if response["action"] == "Final Answer":
+                return AgentFinish({"output": response["action_input"]}, text)
+            else:
+                return AgentAction(
+                    response["action"], response.get("action_input", {}), text
+                )
+        except Exception as e:
+            raise OutputParserException(f"Could not parse LLM output: {text}") from e
+
+    @property
+    def _type(self) -> str:
+        return "json-agent"
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/openai_functions.py b/llm/Lib/site-packages/langchain/agents/output_parsers/openai_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..04778d177bd42fbd75f5fa9a3e0b85c2b8d9d48d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/output_parsers/openai_functions.py
@@ -0,0 +1,88 @@
+import json
+from json import JSONDecodeError
+from typing import List, Union
+
+from langchain_core.agents import AgentAction, AgentActionMessageLog, AgentFinish
+from langchain_core.exceptions import OutputParserException
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+)
+from langchain_core.outputs import ChatGeneration, Generation
+
+from langchain.agents.agent import AgentOutputParser
+
+
+class OpenAIFunctionsAgentOutputParser(AgentOutputParser):
+    """Parses a message into agent action/finish.
+
+    Is meant to be used with OpenAI models, as it relies on the specific
+    function_call parameter from OpenAI to convey what tools to use.
+
+    If a function_call parameter is passed, then that is used to get
+    the tool and tool input.
+
+    If one is not passed, then the AIMessage is assumed to be the final output.
+    """
+
+    @property
+    def _type(self) -> str:
+        return "openai-functions-agent"
+
+    @staticmethod
+    def _parse_ai_message(message: BaseMessage) -> Union[AgentAction, AgentFinish]:
+        """Parse an AI message."""
+        if not isinstance(message, AIMessage):
+            raise TypeError(f"Expected an AI message got {type(message)}")
+
+        function_call = message.additional_kwargs.get("function_call", {})
+
+        if function_call:
+            function_name = function_call["name"]
+            try:
+                if len(function_call["arguments"].strip()) == 0:
+                    # OpenAI returns an empty string for functions containing no args
+                    _tool_input = {}
+                else:
+                    # otherwise it returns a json object
+                    _tool_input = json.loads(function_call["arguments"], strict=False)
+            except JSONDecodeError:
+                raise OutputParserException(
+                    f"Could not parse tool input: {function_call} because "
+                    f"the `arguments` is not valid JSON."
+                )
+
+            # HACK HACK HACK:
+            # The code that encodes tool input into Open AI uses a special variable
+            # name called `__arg1` to handle old style tools that do not expose a
+            # schema and expect a single string argument as an input.
+            # We unpack the argument here if it exists.
+            # Open AI does not support passing in a JSON array as an argument.
+            if "__arg1" in _tool_input:
+                tool_input = _tool_input["__arg1"]
+            else:
+                tool_input = _tool_input
+
+            content_msg = f"responded: {message.content}\n" if message.content else "\n"
+            log = f"\nInvoking: `{function_name}` with `{tool_input}`\n{content_msg}\n"
+            return AgentActionMessageLog(
+                tool=function_name,
+                tool_input=tool_input,
+                log=log,
+                message_log=[message],
+            )
+
+        return AgentFinish(
+            return_values={"output": message.content}, log=str(message.content)
+        )
+
+    def parse_result(
+        self, result: List[Generation], *, partial: bool = False
+    ) -> Union[AgentAction, AgentFinish]:
+        if not isinstance(result[0], ChatGeneration):
+            raise ValueError("This output parser only works on ChatGeneration output")
+        message = result[0].message
+        return self._parse_ai_message(message)
+
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        raise ValueError("Can only parse messages")
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/openai_tools.py b/llm/Lib/site-packages/langchain/agents/output_parsers/openai_tools.py
new file mode 100644
index 0000000000000000000000000000000000000000..861ec23563017d3b65a4eb2ff2eec28119264ee3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/output_parsers/openai_tools.py
@@ -0,0 +1,65 @@
+from typing import List, Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.messages import BaseMessage
+from langchain_core.outputs import ChatGeneration, Generation
+
+from langchain.agents.agent import MultiActionAgentOutputParser
+from langchain.agents.output_parsers.tools import (
+    ToolAgentAction,
+    parse_ai_message_to_tool_action,
+)
+
+OpenAIToolAgentAction = ToolAgentAction
+
+
+def parse_ai_message_to_openai_tool_action(
+    message: BaseMessage,
+) -> Union[List[AgentAction], AgentFinish]:
+    """Parse an AI message potentially containing tool_calls."""
+    tool_actions = parse_ai_message_to_tool_action(message)
+    if isinstance(tool_actions, AgentFinish):
+        return tool_actions
+    final_actions: List[AgentAction] = []
+    for action in tool_actions:
+        if isinstance(action, ToolAgentAction):
+            final_actions.append(
+                OpenAIToolAgentAction(
+                    tool=action.tool,
+                    tool_input=action.tool_input,
+                    log=action.log,
+                    message_log=action.message_log,
+                    tool_call_id=action.tool_call_id,
+                )
+            )
+        else:
+            final_actions.append(action)
+    return final_actions
+
+
+class OpenAIToolsAgentOutputParser(MultiActionAgentOutputParser):
+    """Parses a message into agent actions/finish.
+
+    Is meant to be used with OpenAI models, as it relies on the specific
+    tool_calls parameter from OpenAI to convey what tools to use.
+
+    If a tool_calls parameter is passed, then that is used to get
+    the tool names and tool inputs.
+
+    If one is not passed, then the AIMessage is assumed to be the final output.
+    """
+
+    @property
+    def _type(self) -> str:
+        return "openai-tools-agent-output-parser"
+
+    def parse_result(
+        self, result: List[Generation], *, partial: bool = False
+    ) -> Union[List[AgentAction], AgentFinish]:
+        if not isinstance(result[0], ChatGeneration):
+            raise ValueError("This output parser only works on ChatGeneration output")
+        message = result[0].message
+        return parse_ai_message_to_openai_tool_action(message)
+
+    def parse(self, text: str) -> Union[List[AgentAction], AgentFinish]:
+        raise ValueError("Can only parse messages")
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/react_json_single_input.py b/llm/Lib/site-packages/langchain/agents/output_parsers/react_json_single_input.py
new file mode 100644
index 0000000000000000000000000000000000000000..0ca9ed2ffd82d59947eab0d68c745bb6bcef22c9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/output_parsers/react_json_single_input.py
@@ -0,0 +1,78 @@
+import json
+import re
+from typing import Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.exceptions import OutputParserException
+
+from langchain.agents.agent import AgentOutputParser
+from langchain.agents.chat.prompt import FORMAT_INSTRUCTIONS
+
+FINAL_ANSWER_ACTION = "Final Answer:"
+
+
+class ReActJsonSingleInputOutputParser(AgentOutputParser):
+    """Parses ReAct-style LLM calls that have a single tool input in json format.
+
+    Expects output to be in one of two formats.
+
+    If the output signals that an action should be taken,
+    should be in the below format. This will result in an AgentAction
+    being returned.
+
+    ```
+    Thought: agent thought here
+    Action:
+    ```
+    {
+        "action": "search",
+        "action_input": "what is the temperature in SF"
+    }
+    ```
+    ```
+
+    If the output signals that a final answer should be given,
+    should be in the below format. This will result in an AgentFinish
+    being returned.
+
+    ```
+    Thought: agent thought here
+    Final Answer: The temperature is 100 degrees
+    ```
+
+    """
+
+    pattern = re.compile(r"^.*?`{3}(?:json)?\n?(.*?)`{3}.*?$", re.DOTALL)
+    """Regex pattern to parse the output."""
+
+    def get_format_instructions(self) -> str:
+        return FORMAT_INSTRUCTIONS
+
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        includes_answer = FINAL_ANSWER_ACTION in text
+        try:
+            found = self.pattern.search(text)
+            if not found:
+                # Fast fail to parse Final Answer.
+                raise ValueError("action not found")
+            action = found.group(1)
+            response = json.loads(action.strip())
+            includes_action = "action" in response
+            if includes_answer and includes_action:
+                raise OutputParserException(
+                    "Parsing LLM output produced a final answer "
+                    f"and a parse-able action: {text}"
+                )
+            return AgentAction(
+                response["action"], response.get("action_input", {}), text
+            )
+
+        except Exception:
+            if not includes_answer:
+                raise OutputParserException(f"Could not parse LLM output: {text}")
+            output = text.split(FINAL_ANSWER_ACTION)[-1].strip()
+            return AgentFinish({"output": output}, text)
+
+    @property
+    def _type(self) -> str:
+        return "react-json-single-input"
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/react_single_input.py b/llm/Lib/site-packages/langchain/agents/output_parsers/react_single_input.py
new file mode 100644
index 0000000000000000000000000000000000000000..f63821588fe5de4e09f126822520a44f6dcfee8f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/output_parsers/react_single_input.py
@@ -0,0 +1,95 @@
+import re
+from typing import Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.exceptions import OutputParserException
+
+from langchain.agents.agent import AgentOutputParser
+from langchain.agents.mrkl.prompt import FORMAT_INSTRUCTIONS
+
+FINAL_ANSWER_ACTION = "Final Answer:"
+MISSING_ACTION_AFTER_THOUGHT_ERROR_MESSAGE = (
+    "Invalid Format: Missing 'Action:' after 'Thought:"
+)
+MISSING_ACTION_INPUT_AFTER_ACTION_ERROR_MESSAGE = (
+    "Invalid Format: Missing 'Action Input:' after 'Action:'"
+)
+FINAL_ANSWER_AND_PARSABLE_ACTION_ERROR_MESSAGE = (
+    "Parsing LLM output produced both a final answer and a parse-able action:"
+)
+
+
+class ReActSingleInputOutputParser(AgentOutputParser):
+    """Parses ReAct-style LLM calls that have a single tool input.
+
+    Expects output to be in one of two formats.
+
+    If the output signals that an action should be taken,
+    should be in the below format. This will result in an AgentAction
+    being returned.
+
+    ```
+    Thought: agent thought here
+    Action: search
+    Action Input: what is the temperature in SF?
+    ```
+
+    If the output signals that a final answer should be given,
+    should be in the below format. This will result in an AgentFinish
+    being returned.
+
+    ```
+    Thought: agent thought here
+    Final Answer: The temperature is 100 degrees
+    ```
+
+    """
+
+    def get_format_instructions(self) -> str:
+        return FORMAT_INSTRUCTIONS
+
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        includes_answer = FINAL_ANSWER_ACTION in text
+        regex = (
+            r"Action\s*\d*\s*:[\s]*(.*?)[\s]*Action\s*\d*\s*Input\s*\d*\s*:[\s]*(.*)"
+        )
+        action_match = re.search(regex, text, re.DOTALL)
+        if action_match:
+            if includes_answer:
+                raise OutputParserException(
+                    f"{FINAL_ANSWER_AND_PARSABLE_ACTION_ERROR_MESSAGE}: {text}"
+                )
+            action = action_match.group(1).strip()
+            action_input = action_match.group(2)
+            tool_input = action_input.strip(" ")
+            tool_input = tool_input.strip('"')
+
+            return AgentAction(action, tool_input, text)
+
+        elif includes_answer:
+            return AgentFinish(
+                {"output": text.split(FINAL_ANSWER_ACTION)[-1].strip()}, text
+            )
+
+        if not re.search(r"Action\s*\d*\s*:[\s]*(.*?)", text, re.DOTALL):
+            raise OutputParserException(
+                f"Could not parse LLM output: `{text}`",
+                observation=MISSING_ACTION_AFTER_THOUGHT_ERROR_MESSAGE,
+                llm_output=text,
+                send_to_llm=True,
+            )
+        elif not re.search(
+            r"[\s]*Action\s*\d*\s*Input\s*\d*\s*:[\s]*(.*)", text, re.DOTALL
+        ):
+            raise OutputParserException(
+                f"Could not parse LLM output: `{text}`",
+                observation=MISSING_ACTION_INPUT_AFTER_ACTION_ERROR_MESSAGE,
+                llm_output=text,
+                send_to_llm=True,
+            )
+        else:
+            raise OutputParserException(f"Could not parse LLM output: `{text}`")
+
+    @property
+    def _type(self) -> str:
+        return "react-single-input"
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/self_ask.py b/llm/Lib/site-packages/langchain/agents/output_parsers/self_ask.py
new file mode 100644
index 0000000000000000000000000000000000000000..e658703f7636729fb24c5828caa28e9c54957729
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/output_parsers/self_ask.py
@@ -0,0 +1,49 @@
+from typing import Sequence, Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.exceptions import OutputParserException
+
+from langchain.agents.agent import AgentOutputParser
+
+
+class SelfAskOutputParser(AgentOutputParser):
+    """Parses self-ask style LLM calls.
+
+    Expects output to be in one of two formats.
+
+    If the output signals that an action should be taken,
+    should be in the below format. This will result in an AgentAction
+    being returned.
+
+    ```
+    Thoughts go here...
+    Follow up: what is the temperature in SF?
+    ```
+
+    If the output signals that a final answer should be given,
+    should be in the below format. This will result in an AgentFinish
+    being returned.
+
+    ```
+    Thoughts go here...
+    So the final answer is: The temperature is 100 degrees
+    ```
+
+    """
+
+    followups: Sequence[str] = ("Follow up:", "Followup:")
+    finish_string: str = "So the final answer is: "
+
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        last_line = text.split("\n")[-1]
+        if not any([follow in last_line for follow in self.followups]):
+            if self.finish_string not in last_line:
+                raise OutputParserException(f"Could not parse output: {text}")
+            return AgentFinish({"output": last_line[len(self.finish_string) :]}, text)
+
+        after_colon = text.split(":")[-1].strip()
+        return AgentAction("Intermediate Answer", after_colon, text)
+
+    @property
+    def _type(self) -> str:
+        return "self_ask"
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/tools.py b/llm/Lib/site-packages/langchain/agents/output_parsers/tools.py
new file mode 100644
index 0000000000000000000000000000000000000000..850fdb42af684e30868e9c622ca42e3a415c6464
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/output_parsers/tools.py
@@ -0,0 +1,102 @@
+import json
+from json import JSONDecodeError
+from typing import List, Union
+
+from langchain_core.agents import AgentAction, AgentActionMessageLog, AgentFinish
+from langchain_core.exceptions import OutputParserException
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    ToolCall,
+)
+from langchain_core.outputs import ChatGeneration, Generation
+
+from langchain.agents.agent import MultiActionAgentOutputParser
+
+
+class ToolAgentAction(AgentActionMessageLog):
+    tool_call_id: str
+    """Tool call that this message is responding to."""
+
+
+def parse_ai_message_to_tool_action(
+    message: BaseMessage,
+) -> Union[List[AgentAction], AgentFinish]:
+    """Parse an AI message potentially containing tool_calls."""
+    if not isinstance(message, AIMessage):
+        raise TypeError(f"Expected an AI message got {type(message)}")
+
+    actions: List = []
+    if message.tool_calls:
+        tool_calls = message.tool_calls
+    else:
+        if not message.additional_kwargs.get("tool_calls"):
+            return AgentFinish(
+                return_values={"output": message.content}, log=str(message.content)
+            )
+        # Best-effort parsing
+        tool_calls = []
+        for tool_call in message.additional_kwargs["tool_calls"]:
+            function = tool_call["function"]
+            function_name = function["name"]
+            try:
+                args = json.loads(function["arguments"] or "{}")
+                tool_calls.append(
+                    ToolCall(name=function_name, args=args, id=tool_call["id"])
+                )
+            except JSONDecodeError:
+                raise OutputParserException(
+                    f"Could not parse tool input: {function} because "
+                    f"the `arguments` is not valid JSON."
+                )
+    for tool_call in tool_calls:
+        # HACK HACK HACK:
+        # The code that encodes tool input into Open AI uses a special variable
+        # name called `__arg1` to handle old style tools that do not expose a
+        # schema and expect a single string argument as an input.
+        # We unpack the argument here if it exists.
+        # Open AI does not support passing in a JSON array as an argument.
+        function_name = tool_call["name"]
+        _tool_input = tool_call["args"]
+        if "__arg1" in _tool_input:
+            tool_input = _tool_input["__arg1"]
+        else:
+            tool_input = _tool_input
+
+        content_msg = f"responded: {message.content}\n" if message.content else "\n"
+        log = f"\nInvoking: `{function_name}` with `{tool_input}`\n{content_msg}\n"
+        actions.append(
+            ToolAgentAction(
+                tool=function_name,
+                tool_input=tool_input,
+                log=log,
+                message_log=[message],
+                tool_call_id=tool_call["id"],
+            )
+        )
+    return actions
+
+
+class ToolsAgentOutputParser(MultiActionAgentOutputParser):
+    """Parses a message into agent actions/finish.
+
+    If a tool_calls parameter is passed, then that is used to get
+    the tool names and tool inputs.
+
+    If one is not passed, then the AIMessage is assumed to be the final output.
+    """
+
+    @property
+    def _type(self) -> str:
+        return "tools-agent-output-parser"
+
+    def parse_result(
+        self, result: List[Generation], *, partial: bool = False
+    ) -> Union[List[AgentAction], AgentFinish]:
+        if not isinstance(result[0], ChatGeneration):
+            raise ValueError("This output parser only works on ChatGeneration output")
+        message = result[0].message
+        return parse_ai_message_to_tool_action(message)
+
+    def parse(self, text: str) -> Union[List[AgentAction], AgentFinish]:
+        raise ValueError("Can only parse messages")
diff --git a/llm/Lib/site-packages/langchain/agents/output_parsers/xml.py b/llm/Lib/site-packages/langchain/agents/output_parsers/xml.py
new file mode 100644
index 0000000000000000000000000000000000000000..730d069ae6a0f65eee9a8f1e247f12d491097b4e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/output_parsers/xml.py
@@ -0,0 +1,52 @@
+from typing import Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+
+from langchain.agents import AgentOutputParser
+
+
+class XMLAgentOutputParser(AgentOutputParser):
+    """Parses tool invocations and final answers in XML format.
+
+    Expects output to be in one of two formats.
+
+    If the output signals that an action should be taken,
+    should be in the below format. This will result in an AgentAction
+    being returned.
+
+    ```
+    <tool>search</tool>
+    <tool_input>what is 2 + 2</tool_input>
+    ```
+
+    If the output signals that a final answer should be given,
+    should be in the below format. This will result in an AgentFinish
+    being returned.
+
+    ```
+    <final_answer>Foo</final_answer>
+    ```
+    """
+
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        if "</tool>" in text:
+            tool, tool_input = text.split("</tool>")
+            _tool = tool.split("<tool>")[1]
+            _tool_input = tool_input.split("<tool_input>")[1]
+            if "</tool_input>" in _tool_input:
+                _tool_input = _tool_input.split("</tool_input>")[0]
+            return AgentAction(tool=_tool, tool_input=_tool_input, log=text)
+        elif "<final_answer>" in text:
+            _, answer = text.split("<final_answer>")
+            if "</final_answer>" in answer:
+                answer = answer.split("</final_answer>")[0]
+            return AgentFinish(return_values={"output": answer}, log=text)
+        else:
+            raise ValueError
+
+    def get_format_instructions(self) -> str:
+        raise NotImplementedError
+
+    @property
+    def _type(self) -> str:
+        return "xml-agent"
diff --git a/llm/Lib/site-packages/langchain/agents/react/__init__.py b/llm/Lib/site-packages/langchain/agents/react/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..34518432c0225e5a67393e2ff12484288b926117
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/react/__init__.py
@@ -0,0 +1 @@
+"""Implements the ReAct paper from https://arxiv.org/pdf/2210.03629.pdf."""
diff --git a/llm/Lib/site-packages/langchain/agents/react/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/react/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..56a4271b2858cd4bc2415571f638927615bda743
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/react/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/react/__pycache__/agent.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/react/__pycache__/agent.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..41393e5214b3a3b5c0eb7580d3477c5b1bbaa5de
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/react/__pycache__/agent.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/react/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/react/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..163d0450bf5fa5d2599324a6220b5939ff9e3415
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/react/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/react/__pycache__/output_parser.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/react/__pycache__/output_parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2d784bd4d0a3fc57c98037a7fe4a08871e253e14
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/react/__pycache__/output_parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/react/__pycache__/textworld_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/react/__pycache__/textworld_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e2ceaf2cd60aa871d9d244b851d620dbf17dc894
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/react/__pycache__/textworld_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/react/__pycache__/wiki_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/react/__pycache__/wiki_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2ce9d3ef49e8e4726200022fd883f88a53574655
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/react/__pycache__/wiki_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/react/agent.py b/llm/Lib/site-packages/langchain/agents/react/agent.py
new file mode 100644
index 0000000000000000000000000000000000000000..032691ee3eb6f6afae1b1dd5f969f2877abf541e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/react/agent.py
@@ -0,0 +1,134 @@
+from __future__ import annotations
+
+from typing import List, Optional, Sequence, Union
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.runnables import Runnable, RunnablePassthrough
+from langchain_core.tools import BaseTool
+
+from langchain.agents import AgentOutputParser
+from langchain.agents.format_scratchpad import format_log_to_str
+from langchain.agents.output_parsers import ReActSingleInputOutputParser
+from langchain.tools.render import ToolsRenderer, render_text_description
+
+
+def create_react_agent(
+    llm: BaseLanguageModel,
+    tools: Sequence[BaseTool],
+    prompt: BasePromptTemplate,
+    output_parser: Optional[AgentOutputParser] = None,
+    tools_renderer: ToolsRenderer = render_text_description,
+    *,
+    stop_sequence: Union[bool, List[str]] = True,
+) -> Runnable:
+    """Create an agent that uses ReAct prompting.
+
+    Args:
+        llm: LLM to use as the agent.
+        tools: Tools this agent has access to.
+        prompt: The prompt to use. See Prompt section below for more.
+        output_parser: AgentOutputParser for parse the LLM output.
+        tools_renderer: This controls how the tools are converted into a string and
+            then passed into the LLM. Default is `render_text_description`.
+        stop_sequence: bool or list of str.
+            If True, adds a stop token of "Observation:" to avoid hallucinates.
+            If False, does not add a stop token.
+            If a list of str, uses the provided list as the stop tokens.
+
+            Default is True. You may to set this to False if the LLM you are using
+            does not support stop sequences.
+
+    Returns:
+        A Runnable sequence representing an agent. It takes as input all the same input
+        variables as the prompt passed in does. It returns as output either an
+        AgentAction or AgentFinish.
+
+    Examples:
+
+        .. code-block:: python
+
+            from langchain import hub
+            from langchain_community.llms import OpenAI
+            from langchain.agents import AgentExecutor, create_react_agent
+
+            prompt = hub.pull("hwchase17/react")
+            model = OpenAI()
+            tools = ...
+
+            agent = create_react_agent(model, tools, prompt)
+            agent_executor = AgentExecutor(agent=agent, tools=tools)
+
+            agent_executor.invoke({"input": "hi"})
+
+            # Use with chat history
+            from langchain_core.messages import AIMessage, HumanMessage
+            agent_executor.invoke(
+                {
+                    "input": "what's my name?",
+                    # Notice that chat_history is a string
+                    # since this prompt is aimed at LLMs, not chat models
+                    "chat_history": "Human: My name is Bob\nAI: Hello Bob!",
+                }
+            )
+
+    Prompt:
+
+        The prompt must have input keys:
+            * `tools`: contains descriptions and arguments for each tool.
+            * `tool_names`: contains all tool names.
+            * `agent_scratchpad`: contains previous agent actions and tool outputs as a string.
+
+        Here's an example:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import PromptTemplate
+
+            template = '''Answer the following questions as best you can. You have access to the following tools:
+
+            {tools}
+
+            Use the following format:
+
+            Question: the input question you must answer
+            Thought: you should always think about what to do
+            Action: the action to take, should be one of [{tool_names}]
+            Action Input: the input to the action
+            Observation: the result of the action
+            ... (this Thought/Action/Action Input/Observation can repeat N times)
+            Thought: I now know the final answer
+            Final Answer: the final answer to the original input question
+
+            Begin!
+
+            Question: {input}
+            Thought:{agent_scratchpad}'''
+
+            prompt = PromptTemplate.from_template(template)
+    """  # noqa: E501
+    missing_vars = {"tools", "tool_names", "agent_scratchpad"}.difference(
+        prompt.input_variables + list(prompt.partial_variables)
+    )
+    if missing_vars:
+        raise ValueError(f"Prompt missing required variables: {missing_vars}")
+
+    prompt = prompt.partial(
+        tools=tools_renderer(list(tools)),
+        tool_names=", ".join([t.name for t in tools]),
+    )
+    if stop_sequence:
+        stop = ["\nObservation"] if stop_sequence is True else stop_sequence
+        llm_with_stop = llm.bind(stop=stop)
+    else:
+        llm_with_stop = llm
+    output_parser = output_parser or ReActSingleInputOutputParser()
+    agent = (
+        RunnablePassthrough.assign(
+            agent_scratchpad=lambda x: format_log_to_str(x["intermediate_steps"]),
+        )
+        | prompt
+        | llm_with_stop
+        | output_parser
+    )
+    return agent
diff --git a/llm/Lib/site-packages/langchain/agents/react/base.py b/llm/Lib/site-packages/langchain/agents/react/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..437eb80e72087a0c42e15b3f3ea25acb957b9550
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/react/base.py
@@ -0,0 +1,157 @@
+"""Chain that implements the ReAct paper from https://arxiv.org/pdf/2210.03629.pdf."""
+from typing import Any, List, Optional, Sequence
+
+from langchain_core._api import deprecated
+from langchain_core.documents import Document
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool, Tool
+
+from langchain.agents.agent import Agent, AgentExecutor, AgentOutputParser
+from langchain.agents.agent_types import AgentType
+from langchain.agents.react.output_parser import ReActOutputParser
+from langchain.agents.react.textworld_prompt import TEXTWORLD_PROMPT
+from langchain.agents.react.wiki_prompt import WIKI_PROMPT
+from langchain.agents.utils import validate_tools_single_input
+from langchain.docstore.base import Docstore
+
+
+@deprecated("0.1.0", removal="0.2.0")
+class ReActDocstoreAgent(Agent):
+    """Agent for the ReAct chain."""
+
+    output_parser: AgentOutputParser = Field(default_factory=ReActOutputParser)
+
+    @classmethod
+    def _get_default_output_parser(cls, **kwargs: Any) -> AgentOutputParser:
+        return ReActOutputParser()
+
+    @property
+    def _agent_type(self) -> str:
+        """Return Identifier of an agent type."""
+        return AgentType.REACT_DOCSTORE
+
+    @classmethod
+    def create_prompt(cls, tools: Sequence[BaseTool]) -> BasePromptTemplate:
+        """Return default prompt."""
+        return WIKI_PROMPT
+
+    @classmethod
+    def _validate_tools(cls, tools: Sequence[BaseTool]) -> None:
+        validate_tools_single_input(cls.__name__, tools)
+        super()._validate_tools(tools)
+        if len(tools) != 2:
+            raise ValueError(f"Exactly two tools must be specified, but got {tools}")
+        tool_names = {tool.name for tool in tools}
+        if tool_names != {"Lookup", "Search"}:
+            raise ValueError(
+                f"Tool names should be Lookup and Search, got {tool_names}"
+            )
+
+    @property
+    def observation_prefix(self) -> str:
+        """Prefix to append the observation with."""
+        return "Observation: "
+
+    @property
+    def _stop(self) -> List[str]:
+        return ["\nObservation:"]
+
+    @property
+    def llm_prefix(self) -> str:
+        """Prefix to append the LLM call with."""
+        return "Thought:"
+
+
+@deprecated("0.1.0", removal="0.2.0")
+class DocstoreExplorer:
+    """Class to assist with exploration of a document store."""
+
+    def __init__(self, docstore: Docstore):
+        """Initialize with a docstore, and set initial document to None."""
+        self.docstore = docstore
+        self.document: Optional[Document] = None
+        self.lookup_str = ""
+        self.lookup_index = 0
+
+    def search(self, term: str) -> str:
+        """Search for a term in the docstore, and if found save."""
+        result = self.docstore.search(term)
+        if isinstance(result, Document):
+            self.document = result
+            return self._summary
+        else:
+            self.document = None
+            return result
+
+    def lookup(self, term: str) -> str:
+        """Lookup a term in document (if saved)."""
+        if self.document is None:
+            raise ValueError("Cannot lookup without a successful search first")
+        if term.lower() != self.lookup_str:
+            self.lookup_str = term.lower()
+            self.lookup_index = 0
+        else:
+            self.lookup_index += 1
+        lookups = [p for p in self._paragraphs if self.lookup_str in p.lower()]
+        if len(lookups) == 0:
+            return "No Results"
+        elif self.lookup_index >= len(lookups):
+            return "No More Results"
+        else:
+            result_prefix = f"(Result {self.lookup_index + 1}/{len(lookups)})"
+            return f"{result_prefix} {lookups[self.lookup_index]}"
+
+    @property
+    def _summary(self) -> str:
+        return self._paragraphs[0]
+
+    @property
+    def _paragraphs(self) -> List[str]:
+        if self.document is None:
+            raise ValueError("Cannot get paragraphs without a document")
+        return self.document.page_content.split("\n\n")
+
+
+@deprecated("0.1.0", removal="0.2.0")
+class ReActTextWorldAgent(ReActDocstoreAgent):
+    """Agent for the ReAct TextWorld chain."""
+
+    @classmethod
+    def create_prompt(cls, tools: Sequence[BaseTool]) -> BasePromptTemplate:
+        """Return default prompt."""
+        return TEXTWORLD_PROMPT
+
+    @classmethod
+    def _validate_tools(cls, tools: Sequence[BaseTool]) -> None:
+        validate_tools_single_input(cls.__name__, tools)
+        super()._validate_tools(tools)
+        if len(tools) != 1:
+            raise ValueError(f"Exactly one tool must be specified, but got {tools}")
+        tool_names = {tool.name for tool in tools}
+        if tool_names != {"Play"}:
+            raise ValueError(f"Tool name should be Play, got {tool_names}")
+
+
+@deprecated("0.1.0", removal="0.2.0")
+class ReActChain(AgentExecutor):
+    """[Deprecated] Chain that implements the ReAct paper."""
+
+    def __init__(self, llm: BaseLanguageModel, docstore: Docstore, **kwargs: Any):
+        """Initialize with the LLM and a docstore."""
+        docstore_explorer = DocstoreExplorer(docstore)
+        tools = [
+            Tool(
+                name="Search",
+                func=docstore_explorer.search,
+                description="Search for a term in the docstore.",
+            ),
+            Tool(
+                name="Lookup",
+                func=docstore_explorer.lookup,
+                description="Lookup a term in the docstore.",
+            ),
+        ]
+        agent = ReActDocstoreAgent.from_llm_and_tools(llm, tools)
+        super().__init__(agent=agent, tools=tools, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/agents/react/output_parser.py b/llm/Lib/site-packages/langchain/agents/react/output_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce3161d6307130e3b8b6fd0e1faec316cce45aca
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/react/output_parser.py
@@ -0,0 +1,34 @@
+import re
+from typing import Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.exceptions import OutputParserException
+
+from langchain.agents.agent import AgentOutputParser
+
+
+class ReActOutputParser(AgentOutputParser):
+    """Output parser for the ReAct agent."""
+
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        action_prefix = "Action: "
+        if not text.strip().split("\n")[-1].startswith(action_prefix):
+            raise OutputParserException(f"Could not parse LLM Output: {text}")
+        action_block = text.strip().split("\n")[-1]
+
+        action_str = action_block[len(action_prefix) :]
+        # Parse out the action and the directive.
+        re_matches = re.search(r"(.*?)\[(.*?)\]", action_str)
+        if re_matches is None:
+            raise OutputParserException(
+                f"Could not parse action directive: {action_str}"
+            )
+        action, action_input = re_matches.group(1), re_matches.group(2)
+        if action == "Finish":
+            return AgentFinish({"output": action_input}, text)
+        else:
+            return AgentAction(action, action_input, text)
+
+    @property
+    def _type(self) -> str:
+        return "react"
diff --git a/llm/Lib/site-packages/langchain/agents/react/textworld_prompt.py b/llm/Lib/site-packages/langchain/agents/react/textworld_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..26cfd49aa2992e6112c3d65676a0d4e98c27f631
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/react/textworld_prompt.py
@@ -0,0 +1,52 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+EXAMPLES = [
+    """Setup: You are now playing a fast paced round of TextWorld! Here is your task for
+today. First of all, you could, like, try to travel east. After that, take the
+binder from the locker. With the binder, place the binder on the mantelpiece.
+Alright, thanks!
+
+-= Vault =-
+You've just walked into a vault. You begin to take stock of what's here.
+
+An open safe is here. What a letdown! The safe is empty! You make out a shelf.
+But the thing hasn't got anything on it. What, you think everything in TextWorld
+should have stuff on it?
+
+You don't like doors? Why not try going east, that entranceway is unguarded.
+
+Thought: I need to travel east
+Action: Play[go east]
+Observation: -= Office =-
+You arrive in an office. An ordinary one.
+
+You can make out a locker. The locker contains a binder. You see a case. The
+case is empty, what a horrible day! You lean against the wall, inadvertently
+pressing a secret button. The wall opens up to reveal a mantelpiece. You wonder
+idly who left that here. The mantelpiece is standard. The mantelpiece appears to
+be empty. If you haven't noticed it already, there seems to be something there
+by the wall, it's a table. Unfortunately, there isn't a thing on it. Hm. Oh well
+There is an exit to the west. Don't worry, it is unguarded.
+
+Thought: I need to take the binder from the locker
+Action: Play[take binder]
+Observation: You take the binder from the locker.
+
+Thought: I need to place the binder on the mantelpiece
+Action: Play[put binder on mantelpiece]
+
+Observation: You put the binder on the mantelpiece.
+Your score has just gone up by one point.
+*** The End ***
+Thought: The End has occurred
+Action: Finish[yes]
+
+"""
+]
+SUFFIX = """\n\nSetup: {input}
+{agent_scratchpad}"""
+
+TEXTWORLD_PROMPT = PromptTemplate.from_examples(
+    EXAMPLES, SUFFIX, ["input", "agent_scratchpad"]
+)
diff --git a/llm/Lib/site-packages/langchain/agents/react/wiki_prompt.py b/llm/Lib/site-packages/langchain/agents/react/wiki_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..9db6cf9291824ad3003fbbfbfd07849cc1eb9987
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/react/wiki_prompt.py
@@ -0,0 +1,71 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+EXAMPLES = [
+    """Question: What is the elevation range for the area that the eastern sector of the Colorado orogeny extends into?
+Thought: I need to search Colorado orogeny, find the area that the eastern sector of the Colorado orogeny extends into, then find the elevation range of the area.
+Action: Search[Colorado orogeny]
+Observation: The Colorado orogeny was an episode of mountain building (an orogeny) in Colorado and surrounding areas.
+Thought: It does not mention the eastern sector. So I need to look up eastern sector.
+Action: Lookup[eastern sector]
+Observation: (Result 1 / 1) The eastern sector extends into the High Plains and is called the Central Plains orogeny.
+Thought: The eastern sector of Colorado orogeny extends into the High Plains. So I need to search High Plains and find its elevation range.
+Action: Search[High Plains]
+Observation: High Plains refers to one of two distinct land regions
+Thought: I need to instead search High Plains (United States).
+Action: Search[High Plains (United States)]
+Observation: The High Plains are a subregion of the Great Plains. From east to west, the High Plains rise in elevation from around 1,800 to 7,000 ft (550 to 2,130 m).[3]
+Thought: High Plains rise in elevation from around 1,800 to 7,000 ft, so the answer is 1,800 to 7,000 ft.
+Action: Finish[1,800 to 7,000 ft]""",
+    """Question: Musician and satirist Allie Goertz wrote a song about the "The Simpsons" character Milhouse, who Matt Groening named after who?
+Thought: The question simplifies to "The Simpsons" character Milhouse is named after who. I only need to search Milhouse and find who it is named after.
+Action: Search[Milhouse]
+Observation: Milhouse Mussolini Van Houten is a recurring character in the Fox animated television series The Simpsons voiced by Pamela Hayden and created by Matt Groening.
+Thought: The paragraph does not tell who Milhouse is named after, maybe I can look up "named after".
+Action: Lookup[named after]
+Observation: (Result 1 / 1) Milhouse was named after U.S. president Richard Nixon, whose middle name was Milhous.
+Thought: Milhouse was named after U.S. president Richard Nixon, so the answer is Richard Nixon.
+Action: Finish[Richard Nixon]""",
+    """Question: Which documentary is about Finnish rock groups, Adam Clayton Powell or The Saimaa Gesture?
+Thought: I need to search Adam Clayton Powell and The Saimaa Gesture, and find which documentary is about Finnish rock groups.
+Action: Search[Adam Clayton Powell]
+Observation: Could not find [Adam Clayton Powell]. Similar: [’Adam Clayton Powell III’, ’Seventh Avenue (Manhattan)’, ’Adam Clayton Powell Jr. State Office Building’, ’Isabel Washington Powell’, ’Adam Powell’, ’Adam Clayton Powell (film)’, ’Giancarlo Esposito’].
+Thought: To find the documentary, I can search Adam Clayton Powell (film).
+Action: Search[Adam Clayton Powell (film)]
+Observation: Adam Clayton Powell is a 1989 American documentary film directed by Richard Kilberg. The film is about the rise and fall of influential African-American politician Adam Clayton Powell Jr.[3][4] It was later aired as part of the PBS series The American Experience.
+Thought: Adam Clayton Powell (film) is a documentary about an African-American politician, not Finnish rock groups. So the documentary about Finnish rock groups must instead be The Saimaa Gesture.
+Action: Finish[The Saimaa Gesture]""",
+    """Question: What profession does Nicholas Ray and Elia Kazan have in common?
+Thought: I need to search Nicholas Ray and Elia Kazan, find their professions, then find the profession they have in common.
+Action: Search[Nicholas Ray]
+Observation: Nicholas Ray (born Raymond Nicholas Kienzle Jr., August 7, 1911 - June 16, 1979) was an American film director, screenwriter, and actor best known for the 1955 film Rebel Without a Cause.
+Thought: Professions of Nicholas Ray are director, screenwriter, and actor. I need to search Elia Kazan next and find his professions.
+Action: Search[Elia Kazan]
+Observation: Elia Kazan was an American film and theatre director, producer, screenwriter and actor.
+Thought: Professions of Elia Kazan are director, producer, screenwriter, and actor. So profession Nicholas Ray and Elia Kazan have in common is director, screenwriter, and actor.
+Action: Finish[director, screenwriter, actor]""",
+    """Question: Which magazine was started first Arthur’s Magazine or First for Women?
+Thought: I need to search Arthur’s Magazine and First for Women, and find which was started first.
+Action: Search[Arthur’s Magazine]
+Observation: Arthur’s Magazine (1844-1846) was an American literary periodical published in Philadelphia in the 19th century.
+Thought: Arthur’s Magazine was started in 1844. I need to search First for Women next.
+Action: Search[First for Women]
+Observation: First for Women is a woman’s magazine published by Bauer Media Group in the USA.[1] The magazine was started in 1989.
+Thought: First for Women was started in 1989. 1844 (Arthur’s Magazine) < 1989 (First for Women), so Arthur’s Magazine was started first.
+Action: Finish[Arthur’s Magazine]""",
+    """Question: Were Pavel Urysohn and Leonid Levin known for the same type of work?
+Thought: I need to search Pavel Urysohn and Leonid Levin, find their types of work, then find if they are the same.
+Action: Search[Pavel Urysohn]
+Observation: Pavel Samuilovich Urysohn (February 3, 1898 - August 17, 1924) was a Soviet mathematician who is best known for his contributions in dimension theory.
+Thought: Pavel Urysohn is a mathematician. I need to search Leonid Levin next and find its type of work.
+Action: Search[Leonid Levin]
+Observation: Leonid Anatolievich Levin is a Soviet-American mathematician and computer scientist.
+Thought: Leonid Levin is a mathematician and computer scientist. So Pavel Urysohn and Leonid Levin have the same type of work.
+Action: Finish[yes]""",
+]
+SUFFIX = """\nQuestion: {input}
+{agent_scratchpad}"""
+
+WIKI_PROMPT = PromptTemplate.from_examples(
+    EXAMPLES, SUFFIX, ["input", "agent_scratchpad"]
+)
diff --git a/llm/Lib/site-packages/langchain/agents/schema.py b/llm/Lib/site-packages/langchain/agents/schema.py
new file mode 100644
index 0000000000000000000000000000000000000000..e0c00fb95e8a02058d990a36e043a217e60c40c6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/schema.py
@@ -0,0 +1,34 @@
+from typing import Any, Dict, List, Tuple
+
+from langchain_core.agents import AgentAction
+from langchain_core.prompts.chat import ChatPromptTemplate
+
+
+class AgentScratchPadChatPromptTemplate(ChatPromptTemplate):
+    """Chat prompt template for the agent scratchpad."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    def _construct_agent_scratchpad(
+        self, intermediate_steps: List[Tuple[AgentAction, str]]
+    ) -> str:
+        if len(intermediate_steps) == 0:
+            return ""
+        thoughts = ""
+        for action, observation in intermediate_steps:
+            thoughts += action.log
+            thoughts += f"\nObservation: {observation}\nThought: "
+        return (
+            f"This was your previous work "
+            f"(but I haven't seen any of it! I only see what "
+            f"you return as final answer):\n{thoughts}"
+        )
+
+    def _merge_partial_and_user_variables(self, **kwargs: Any) -> Dict[str, Any]:
+        intermediate_steps = kwargs.pop("intermediate_steps")
+        kwargs["agent_scratchpad"] = self._construct_agent_scratchpad(
+            intermediate_steps
+        )
+        return kwargs
diff --git a/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__init__.py b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..70a450ac3e6242687a1a3435878ceebacdd17108
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__init__.py
@@ -0,0 +1,4 @@
+"""Chain that does self ask with search.
+
+Heavily borrowed from https://github.com/ofirpress/self-ask
+"""
diff --git a/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1c1dfedc5112f57da872a6434d6dd4adedac1fff
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ca8d4d87ca527b85f8d188aab9a9e2e87df406a7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__pycache__/output_parser.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__pycache__/output_parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..02f6e6f320ae2e5e0a60f8cf50c973711bf05c05
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__pycache__/output_parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4b08efaf266a8ac9968dcfb279f92358393e7c01
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/self_ask_with_search/base.py b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf7cf5ab7781e7fe6c8902de183d1d7da43de4a9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/base.py
@@ -0,0 +1,205 @@
+"""Chain that does self-ask with search."""
+from typing import Any, Sequence, Union
+
+from langchain_community.utilities.google_serper import GoogleSerperAPIWrapper
+from langchain_community.utilities.searchapi import SearchApiAPIWrapper
+from langchain_community.utilities.serpapi import SerpAPIWrapper
+from langchain_core._api import deprecated
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+from langchain_core.runnables import Runnable, RunnablePassthrough
+from langchain_core.tools import BaseTool, Tool
+
+from langchain.agents.agent import Agent, AgentExecutor, AgentOutputParser
+from langchain.agents.agent_types import AgentType
+from langchain.agents.format_scratchpad import format_log_to_str
+from langchain.agents.self_ask_with_search.output_parser import SelfAskOutputParser
+from langchain.agents.self_ask_with_search.prompt import PROMPT
+from langchain.agents.utils import validate_tools_single_input
+
+
+@deprecated("0.1.0", alternative="create_self_ask_with_search", removal="0.2.0")
+class SelfAskWithSearchAgent(Agent):
+    """Agent for the self-ask-with-search paper."""
+
+    output_parser: AgentOutputParser = Field(default_factory=SelfAskOutputParser)
+
+    @classmethod
+    def _get_default_output_parser(cls, **kwargs: Any) -> AgentOutputParser:
+        return SelfAskOutputParser()
+
+    @property
+    def _agent_type(self) -> str:
+        """Return Identifier of an agent type."""
+        return AgentType.SELF_ASK_WITH_SEARCH
+
+    @classmethod
+    def create_prompt(cls, tools: Sequence[BaseTool]) -> BasePromptTemplate:
+        """Prompt does not depend on tools."""
+        return PROMPT
+
+    @classmethod
+    def _validate_tools(cls, tools: Sequence[BaseTool]) -> None:
+        validate_tools_single_input(cls.__name__, tools)
+        super()._validate_tools(tools)
+        if len(tools) != 1:
+            raise ValueError(f"Exactly one tool must be specified, but got {tools}")
+        tool_names = {tool.name for tool in tools}
+        if tool_names != {"Intermediate Answer"}:
+            raise ValueError(
+                f"Tool name should be Intermediate Answer, got {tool_names}"
+            )
+
+    @property
+    def observation_prefix(self) -> str:
+        """Prefix to append the observation with."""
+        return "Intermediate answer: "
+
+    @property
+    def llm_prefix(self) -> str:
+        """Prefix to append the LLM call with."""
+        return ""
+
+
+@deprecated("0.1.0", removal="0.2.0")
+class SelfAskWithSearchChain(AgentExecutor):
+    """[Deprecated] Chain that does self-ask with search."""
+
+    def __init__(
+        self,
+        llm: BaseLanguageModel,
+        search_chain: Union[
+            GoogleSerperAPIWrapper, SearchApiAPIWrapper, SerpAPIWrapper
+        ],
+        **kwargs: Any,
+    ):
+        """Initialize only with an LLM and a search chain."""
+        search_tool = Tool(
+            name="Intermediate Answer",
+            func=search_chain.run,
+            coroutine=search_chain.arun,
+            description="Search",
+        )
+        agent = SelfAskWithSearchAgent.from_llm_and_tools(llm, [search_tool])
+        super().__init__(agent=agent, tools=[search_tool], **kwargs)
+
+
+def create_self_ask_with_search_agent(
+    llm: BaseLanguageModel, tools: Sequence[BaseTool], prompt: BasePromptTemplate
+) -> Runnable:
+    """Create an agent that uses self-ask with search prompting.
+
+    Args:
+        llm: LLM to use as the agent.
+        tools: List of tools. Should just be of length 1, with that tool having
+            name `Intermediate Answer`
+        prompt: The prompt to use, must have input key `agent_scratchpad` which will
+            contain agent actions and tool outputs.
+
+    Returns:
+        A Runnable sequence representing an agent. It takes as input all the same input
+        variables as the prompt passed in does. It returns as output either an
+        AgentAction or AgentFinish.
+
+    Examples:
+
+        .. code-block:: python
+
+            from langchain import hub
+            from langchain_community.chat_models import ChatAnthropic
+            from langchain.agents import (
+                AgentExecutor, create_self_ask_with_search_agent
+            )
+
+            prompt = hub.pull("hwchase17/self-ask-with-search")
+            model = ChatAnthropic()
+            tools = [...]  # Should just be one tool with name `Intermediate Answer`
+
+            agent = create_self_ask_with_search_agent(model, tools, prompt)
+            agent_executor = AgentExecutor(agent=agent, tools=tools)
+
+            agent_executor.invoke({"input": "hi"})
+
+    Prompt:
+
+        The prompt must have input key `agent_scratchpad` which will
+            contain agent actions and tool outputs as a string.
+
+        Here's an example:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import PromptTemplate
+
+            template = '''Question: Who lived longer, Muhammad Ali or Alan Turing?
+            Are follow up questions needed here: Yes.
+            Follow up: How old was Muhammad Ali when he died?
+            Intermediate answer: Muhammad Ali was 74 years old when he died.
+            Follow up: How old was Alan Turing when he died?
+            Intermediate answer: Alan Turing was 41 years old when he died.
+            So the final answer is: Muhammad Ali
+
+            Question: When was the founder of craigslist born?
+            Are follow up questions needed here: Yes.
+            Follow up: Who was the founder of craigslist?
+            Intermediate answer: Craigslist was founded by Craig Newmark.
+            Follow up: When was Craig Newmark born?
+            Intermediate answer: Craig Newmark was born on December 6, 1952.
+            So the final answer is: December 6, 1952
+
+            Question: Who was the maternal grandfather of George Washington?
+            Are follow up questions needed here: Yes.
+            Follow up: Who was the mother of George Washington?
+            Intermediate answer: The mother of George Washington was Mary Ball Washington.
+            Follow up: Who was the father of Mary Ball Washington?
+            Intermediate answer: The father of Mary Ball Washington was Joseph Ball.
+            So the final answer is: Joseph Ball
+
+            Question: Are both the directors of Jaws and Casino Royale from the same country?
+            Are follow up questions needed here: Yes.
+            Follow up: Who is the director of Jaws?
+            Intermediate answer: The director of Jaws is Steven Spielberg.
+            Follow up: Where is Steven Spielberg from?
+            Intermediate answer: The United States.
+            Follow up: Who is the director of Casino Royale?
+            Intermediate answer: The director of Casino Royale is Martin Campbell.
+            Follow up: Where is Martin Campbell from?
+            Intermediate answer: New Zealand.
+            So the final answer is: No
+
+            Question: {input}
+            Are followup questions needed here:{agent_scratchpad}'''
+
+            prompt = PromptTemplate.from_template(template)
+    """  # noqa: E501
+    missing_vars = {"agent_scratchpad"}.difference(
+        prompt.input_variables + list(prompt.partial_variables)
+    )
+    if missing_vars:
+        raise ValueError(f"Prompt missing required variables: {missing_vars}")
+
+    if len(tools) != 1:
+        raise ValueError("This agent expects exactly one tool")
+    tool = list(tools)[0]
+    if tool.name != "Intermediate Answer":
+        raise ValueError(
+            "This agent expects the tool to be named `Intermediate Answer`"
+        )
+
+    llm_with_stop = llm.bind(stop=["\nIntermediate answer:"])
+    agent = (
+        RunnablePassthrough.assign(
+            agent_scratchpad=lambda x: format_log_to_str(
+                x["intermediate_steps"],
+                observation_prefix="\nIntermediate answer: ",
+                llm_prefix="",
+            ),
+            # Give it a default
+            chat_history=lambda x: x.get("chat_history", ""),
+        )
+        | prompt
+        | llm_with_stop
+        | SelfAskOutputParser()
+    )
+    return agent
diff --git a/llm/Lib/site-packages/langchain/agents/self_ask_with_search/output_parser.py b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/output_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..ac35693ae97f75f30ee80e3c1474014b29583f23
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/output_parser.py
@@ -0,0 +1,4 @@
+from langchain.agents.output_parsers.self_ask import SelfAskOutputParser
+
+# For backwards compatibility
+__all__ = ["SelfAskOutputParser"]
diff --git a/llm/Lib/site-packages/langchain/agents/self_ask_with_search/prompt.py b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..c9154785cd944116e360cc51a3de00cd8f1b8ec0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/self_ask_with_search/prompt.py
@@ -0,0 +1,44 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+_DEFAULT_TEMPLATE = """Question: Who lived longer, Muhammad Ali or Alan Turing?
+Are follow up questions needed here: Yes.
+Follow up: How old was Muhammad Ali when he died?
+Intermediate answer: Muhammad Ali was 74 years old when he died.
+Follow up: How old was Alan Turing when he died?
+Intermediate answer: Alan Turing was 41 years old when he died.
+So the final answer is: Muhammad Ali
+
+Question: When was the founder of craigslist born?
+Are follow up questions needed here: Yes.
+Follow up: Who was the founder of craigslist?
+Intermediate answer: Craigslist was founded by Craig Newmark.
+Follow up: When was Craig Newmark born?
+Intermediate answer: Craig Newmark was born on December 6, 1952.
+So the final answer is: December 6, 1952
+
+Question: Who was the maternal grandfather of George Washington?
+Are follow up questions needed here: Yes.
+Follow up: Who was the mother of George Washington?
+Intermediate answer: The mother of George Washington was Mary Ball Washington.
+Follow up: Who was the father of Mary Ball Washington?
+Intermediate answer: The father of Mary Ball Washington was Joseph Ball.
+So the final answer is: Joseph Ball
+
+Question: Are both the directors of Jaws and Casino Royale from the same country?
+Are follow up questions needed here: Yes.
+Follow up: Who is the director of Jaws?
+Intermediate answer: The director of Jaws is Steven Spielberg.
+Follow up: Where is Steven Spielberg from?
+Intermediate answer: The United States.
+Follow up: Who is the director of Casino Royale?
+Intermediate answer: The director of Casino Royale is Martin Campbell.
+Follow up: Where is Martin Campbell from?
+Intermediate answer: New Zealand.
+So the final answer is: No
+
+Question: {input}
+Are followup questions needed here:{agent_scratchpad}"""
+PROMPT = PromptTemplate(
+    input_variables=["input", "agent_scratchpad"], template=_DEFAULT_TEMPLATE
+)
diff --git a/llm/Lib/site-packages/langchain/agents/structured_chat/__init__.py b/llm/Lib/site-packages/langchain/agents/structured_chat/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/agents/structured_chat/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/structured_chat/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e5e806160ca129c8e713d51d6a799a35973c5021
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/structured_chat/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/structured_chat/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/structured_chat/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d91c4c5c0262436cac40265161a4a6abd242b7c9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/structured_chat/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/structured_chat/__pycache__/output_parser.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/structured_chat/__pycache__/output_parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..23cbbbb9c53aba51ccb68093bc22d25f9b6f154f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/structured_chat/__pycache__/output_parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/structured_chat/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/structured_chat/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aba0462874119c0533c388f2f4a37d502f555b12
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/structured_chat/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/structured_chat/base.py b/llm/Lib/site-packages/langchain/agents/structured_chat/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..be08419632acf76d32b45cae393ab9b842884707
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/structured_chat/base.py
@@ -0,0 +1,299 @@
+import re
+from typing import Any, List, Optional, Sequence, Tuple, Union
+
+from langchain_core._api import deprecated
+from langchain_core.agents import AgentAction
+from langchain_core.callbacks import BaseCallbackManager
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.prompts.chat import (
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+    SystemMessagePromptTemplate,
+)
+from langchain_core.pydantic_v1 import Field
+from langchain_core.runnables import Runnable, RunnablePassthrough
+from langchain_core.tools import BaseTool
+
+from langchain.agents.agent import Agent, AgentOutputParser
+from langchain.agents.format_scratchpad import format_log_to_str
+from langchain.agents.output_parsers import JSONAgentOutputParser
+from langchain.agents.structured_chat.output_parser import (
+    StructuredChatOutputParserWithRetries,
+)
+from langchain.agents.structured_chat.prompt import FORMAT_INSTRUCTIONS, PREFIX, SUFFIX
+from langchain.chains.llm import LLMChain
+from langchain.tools.render import ToolsRenderer, render_text_description_and_args
+
+HUMAN_MESSAGE_TEMPLATE = "{input}\n\n{agent_scratchpad}"
+
+
+@deprecated("0.1.0", alternative="create_structured_chat_agent", removal="0.2.0")
+class StructuredChatAgent(Agent):
+    """Structured Chat Agent."""
+
+    output_parser: AgentOutputParser = Field(
+        default_factory=StructuredChatOutputParserWithRetries
+    )
+    """Output parser for the agent."""
+
+    @property
+    def observation_prefix(self) -> str:
+        """Prefix to append the observation with."""
+        return "Observation: "
+
+    @property
+    def llm_prefix(self) -> str:
+        """Prefix to append the llm call with."""
+        return "Thought:"
+
+    def _construct_scratchpad(
+        self, intermediate_steps: List[Tuple[AgentAction, str]]
+    ) -> str:
+        agent_scratchpad = super()._construct_scratchpad(intermediate_steps)
+        if not isinstance(agent_scratchpad, str):
+            raise ValueError("agent_scratchpad should be of type string.")
+        if agent_scratchpad:
+            return (
+                f"This was your previous work "
+                f"(but I haven't seen any of it! I only see what "
+                f"you return as final answer):\n{agent_scratchpad}"
+            )
+        else:
+            return agent_scratchpad
+
+    @classmethod
+    def _validate_tools(cls, tools: Sequence[BaseTool]) -> None:
+        pass
+
+    @classmethod
+    def _get_default_output_parser(
+        cls, llm: Optional[BaseLanguageModel] = None, **kwargs: Any
+    ) -> AgentOutputParser:
+        return StructuredChatOutputParserWithRetries.from_llm(llm=llm)
+
+    @property
+    def _stop(self) -> List[str]:
+        return ["Observation:"]
+
+    @classmethod
+    def create_prompt(
+        cls,
+        tools: Sequence[BaseTool],
+        prefix: str = PREFIX,
+        suffix: str = SUFFIX,
+        human_message_template: str = HUMAN_MESSAGE_TEMPLATE,
+        format_instructions: str = FORMAT_INSTRUCTIONS,
+        input_variables: Optional[List[str]] = None,
+        memory_prompts: Optional[List[BasePromptTemplate]] = None,
+    ) -> BasePromptTemplate:
+        tool_strings = []
+        for tool in tools:
+            args_schema = re.sub("}", "}}", re.sub("{", "{{", str(tool.args)))
+            tool_strings.append(f"{tool.name}: {tool.description}, args: {args_schema}")
+        formatted_tools = "\n".join(tool_strings)
+        tool_names = ", ".join([tool.name for tool in tools])
+        format_instructions = format_instructions.format(tool_names=tool_names)
+        template = "\n\n".join([prefix, formatted_tools, format_instructions, suffix])
+        if input_variables is None:
+            input_variables = ["input", "agent_scratchpad"]
+        _memory_prompts = memory_prompts or []
+        messages = [
+            SystemMessagePromptTemplate.from_template(template),
+            *_memory_prompts,
+            HumanMessagePromptTemplate.from_template(human_message_template),
+        ]
+        return ChatPromptTemplate(input_variables=input_variables, messages=messages)  # type: ignore[arg-type]
+
+    @classmethod
+    def from_llm_and_tools(
+        cls,
+        llm: BaseLanguageModel,
+        tools: Sequence[BaseTool],
+        callback_manager: Optional[BaseCallbackManager] = None,
+        output_parser: Optional[AgentOutputParser] = None,
+        prefix: str = PREFIX,
+        suffix: str = SUFFIX,
+        human_message_template: str = HUMAN_MESSAGE_TEMPLATE,
+        format_instructions: str = FORMAT_INSTRUCTIONS,
+        input_variables: Optional[List[str]] = None,
+        memory_prompts: Optional[List[BasePromptTemplate]] = None,
+        **kwargs: Any,
+    ) -> Agent:
+        """Construct an agent from an LLM and tools."""
+        cls._validate_tools(tools)
+        prompt = cls.create_prompt(
+            tools,
+            prefix=prefix,
+            suffix=suffix,
+            human_message_template=human_message_template,
+            format_instructions=format_instructions,
+            input_variables=input_variables,
+            memory_prompts=memory_prompts,
+        )
+        llm_chain = LLMChain(
+            llm=llm,
+            prompt=prompt,
+            callback_manager=callback_manager,
+        )
+        tool_names = [tool.name for tool in tools]
+        _output_parser = output_parser or cls._get_default_output_parser(llm=llm)
+        return cls(
+            llm_chain=llm_chain,
+            allowed_tools=tool_names,
+            output_parser=_output_parser,
+            **kwargs,
+        )
+
+    @property
+    def _agent_type(self) -> str:
+        raise ValueError
+
+
+def create_structured_chat_agent(
+    llm: BaseLanguageModel,
+    tools: Sequence[BaseTool],
+    prompt: ChatPromptTemplate,
+    tools_renderer: ToolsRenderer = render_text_description_and_args,
+    *,
+    stop_sequence: Union[bool, List[str]] = True,
+) -> Runnable:
+    """Create an agent aimed at supporting tools with multiple inputs.
+
+    Args:
+        llm: LLM to use as the agent.
+        tools: Tools this agent has access to.
+        prompt: The prompt to use. See Prompt section below for more.
+        stop_sequence: bool or list of str.
+            If True, adds a stop token of "Observation:" to avoid hallucinates.
+            If False, does not add a stop token.
+            If a list of str, uses the provided list as the stop tokens.
+
+            Default is True. You may to set this to False if the LLM you are using
+            does not support stop sequences.
+        tools_renderer: This controls how the tools are converted into a string and
+            then passed into the LLM. Default is `render_text_description`.
+
+    Returns:
+        A Runnable sequence representing an agent. It takes as input all the same input
+        variables as the prompt passed in does. It returns as output either an
+        AgentAction or AgentFinish.
+
+    Examples:
+
+        .. code-block:: python
+
+            from langchain import hub
+            from langchain_community.chat_models import ChatOpenAI
+            from langchain.agents import AgentExecutor, create_structured_chat_agent
+
+            prompt = hub.pull("hwchase17/structured-chat-agent")
+            model = ChatOpenAI()
+            tools = ...
+
+            agent = create_structured_chat_agent(model, tools, prompt)
+            agent_executor = AgentExecutor(agent=agent, tools=tools)
+
+            agent_executor.invoke({"input": "hi"})
+
+            # Using with chat history
+            from langchain_core.messages import AIMessage, HumanMessage
+            agent_executor.invoke(
+                {
+                    "input": "what's my name?",
+                    "chat_history": [
+                        HumanMessage(content="hi! my name is bob"),
+                        AIMessage(content="Hello Bob! How can I assist you today?"),
+                    ],
+                }
+            )
+
+    Prompt:
+
+        The prompt must have input keys:
+            * `tools`: contains descriptions and arguments for each tool.
+            * `tool_names`: contains all tool names.
+            * `agent_scratchpad`: contains previous agent actions and tool outputs as a string.
+
+        Here's an example:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder
+
+            system = '''Respond to the human as helpfully and accurately as possible. You have access to the following tools:
+
+            {tools}
+
+            Use a json blob to specify a tool by providing an action key (tool name) and an action_input key (tool input).
+
+            Valid "action" values: "Final Answer" or {tool_names}
+
+            Provide only ONE action per $JSON_BLOB, as shown:
+
+            ```
+            {{
+              "action": $TOOL_NAME,
+              "action_input": $INPUT
+            }}
+            ```
+
+            Follow this format:
+
+            Question: input question to answer
+            Thought: consider previous and subsequent steps
+            Action:
+            ```
+            $JSON_BLOB
+            ```
+            Observation: action result
+            ... (repeat Thought/Action/Observation N times)
+            Thought: I know what to respond
+            Action:
+            ```
+            {{
+              "action": "Final Answer",
+              "action_input": "Final response to human"
+            }}
+
+            Begin! Reminder to ALWAYS respond with a valid json blob of a single action. Use tools if necessary. Respond directly if appropriate. Format is Action:```$JSON_BLOB```then Observation'''
+
+            human = '''{input}
+
+            {agent_scratchpad}
+
+            (reminder to respond in a JSON blob no matter what)'''
+
+            prompt = ChatPromptTemplate.from_messages(
+                [
+                    ("system", system),
+                    MessagesPlaceholder("chat_history", optional=True),
+                    ("human", human),
+                ]
+            )
+    """  # noqa: E501
+    missing_vars = {"tools", "tool_names", "agent_scratchpad"}.difference(
+        prompt.input_variables + list(prompt.partial_variables)
+    )
+    if missing_vars:
+        raise ValueError(f"Prompt missing required variables: {missing_vars}")
+
+    prompt = prompt.partial(
+        tools=tools_renderer(list(tools)),
+        tool_names=", ".join([t.name for t in tools]),
+    )
+    if stop_sequence:
+        stop = ["\nObservation"] if stop_sequence is True else stop_sequence
+        llm_with_stop = llm.bind(stop=stop)
+    else:
+        llm_with_stop = llm
+
+    agent = (
+        RunnablePassthrough.assign(
+            agent_scratchpad=lambda x: format_log_to_str(x["intermediate_steps"]),
+        )
+        | prompt
+        | llm_with_stop
+        | JSONAgentOutputParser()
+    )
+    return agent
diff --git a/llm/Lib/site-packages/langchain/agents/structured_chat/output_parser.py b/llm/Lib/site-packages/langchain/agents/structured_chat/output_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f91a8352a0e601efe0a12821d503cf484511c1c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/structured_chat/output_parser.py
@@ -0,0 +1,100 @@
+from __future__ import annotations
+
+import json
+import logging
+import re
+from typing import Optional, Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.exceptions import OutputParserException
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.pydantic_v1 import Field
+
+from langchain.agents.agent import AgentOutputParser
+from langchain.agents.structured_chat.prompt import FORMAT_INSTRUCTIONS
+from langchain.output_parsers import OutputFixingParser
+
+logger = logging.getLogger(__name__)
+
+
+class StructuredChatOutputParser(AgentOutputParser):
+    """Output parser for the structured chat agent."""
+
+    format_instructions: str = FORMAT_INSTRUCTIONS
+    """Default formatting instructions"""
+
+    pattern = re.compile(r"```(?:json\s+)?(\W.*?)```", re.DOTALL)
+    """Regex pattern to parse the output."""
+
+    def get_format_instructions(self) -> str:
+        """Returns formatting instructions for the given output parser."""
+        return self.format_instructions
+
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        try:
+            action_match = self.pattern.search(text)
+            if action_match is not None:
+                response = json.loads(action_match.group(1).strip(), strict=False)
+                if isinstance(response, list):
+                    # gpt turbo frequently ignores the directive to emit a single action
+                    logger.warning("Got multiple action responses: %s", response)
+                    response = response[0]
+                if response["action"] == "Final Answer":
+                    return AgentFinish({"output": response["action_input"]}, text)
+                else:
+                    return AgentAction(
+                        response["action"], response.get("action_input", {}), text
+                    )
+            else:
+                return AgentFinish({"output": text}, text)
+        except Exception as e:
+            raise OutputParserException(f"Could not parse LLM output: {text}") from e
+
+    @property
+    def _type(self) -> str:
+        return "structured_chat"
+
+
+class StructuredChatOutputParserWithRetries(AgentOutputParser):
+    """Output parser with retries for the structured chat agent."""
+
+    base_parser: AgentOutputParser = Field(default_factory=StructuredChatOutputParser)
+    """The base parser to use."""
+    output_fixing_parser: Optional[OutputFixingParser] = None
+    """The output fixing parser to use."""
+
+    def get_format_instructions(self) -> str:
+        return FORMAT_INSTRUCTIONS
+
+    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+        try:
+            if self.output_fixing_parser is not None:
+                parsed_obj: Union[
+                    AgentAction, AgentFinish
+                ] = self.output_fixing_parser.parse(text)
+            else:
+                parsed_obj = self.base_parser.parse(text)
+            return parsed_obj
+        except Exception as e:
+            raise OutputParserException(f"Could not parse LLM output: {text}") from e
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: Optional[BaseLanguageModel] = None,
+        base_parser: Optional[StructuredChatOutputParser] = None,
+    ) -> StructuredChatOutputParserWithRetries:
+        if llm is not None:
+            base_parser = base_parser or StructuredChatOutputParser()
+            output_fixing_parser: OutputFixingParser = OutputFixingParser.from_llm(
+                llm=llm, parser=base_parser
+            )
+            return cls(output_fixing_parser=output_fixing_parser)
+        elif base_parser is not None:
+            return cls(base_parser=base_parser)
+        else:
+            return cls()
+
+    @property
+    def _type(self) -> str:
+        return "structured_chat_with_retries"
diff --git a/llm/Lib/site-packages/langchain/agents/structured_chat/prompt.py b/llm/Lib/site-packages/langchain/agents/structured_chat/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..98d8bb37331d155082e8879c2dae0f9d1832ec65
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/structured_chat/prompt.py
@@ -0,0 +1,35 @@
+# flake8: noqa
+PREFIX = """Respond to the human as helpfully and accurately as possible. You have access to the following tools:"""
+FORMAT_INSTRUCTIONS = """Use a json blob to specify a tool by providing an action key (tool name) and an action_input key (tool input).
+
+Valid "action" values: "Final Answer" or {tool_names}
+
+Provide only ONE action per $JSON_BLOB, as shown:
+
+```
+{{{{
+  "action": $TOOL_NAME,
+  "action_input": $INPUT
+}}}}
+```
+
+Follow this format:
+
+Question: input question to answer
+Thought: consider previous and subsequent steps
+Action:
+```
+$JSON_BLOB
+```
+Observation: action result
+... (repeat Thought/Action/Observation N times)
+Thought: I know what to respond
+Action:
+```
+{{{{
+  "action": "Final Answer",
+  "action_input": "Final response to human"
+}}}}
+```"""
+SUFFIX = """Begin! Reminder to ALWAYS respond with a valid json blob of a single action. Use tools if necessary. Respond directly if appropriate. Format is Action:```$JSON_BLOB```then Observation:.
+Thought:"""
diff --git a/llm/Lib/site-packages/langchain/agents/tool_calling_agent/__init__.py b/llm/Lib/site-packages/langchain/agents/tool_calling_agent/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/agents/tool_calling_agent/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/tool_calling_agent/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..87c52e2f410161432f9751bb4d91206284618a36
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/tool_calling_agent/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/tool_calling_agent/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/tool_calling_agent/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e7a914409f5fa4f390fe3d85cc905db9f1811854
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/tool_calling_agent/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/tool_calling_agent/base.py b/llm/Lib/site-packages/langchain/agents/tool_calling_agent/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..a25ba42724cdd1769aed1448c132bbe62f9a10b7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/tool_calling_agent/base.py
@@ -0,0 +1,98 @@
+from typing import Sequence
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts.chat import ChatPromptTemplate
+from langchain_core.runnables import Runnable, RunnablePassthrough
+from langchain_core.tools import BaseTool
+
+from langchain.agents.format_scratchpad.tools import (
+    format_to_tool_messages,
+)
+from langchain.agents.output_parsers.tools import ToolsAgentOutputParser
+
+
+def create_tool_calling_agent(
+    llm: BaseLanguageModel, tools: Sequence[BaseTool], prompt: ChatPromptTemplate
+) -> Runnable:
+    """Create an agent that uses tools.
+
+    Args:
+        llm: LLM to use as the agent.
+        tools: Tools this agent has access to.
+        prompt: The prompt to use. See Prompt section below for more on the expected
+            input variables.
+
+    Returns:
+        A Runnable sequence representing an agent. It takes as input all the same input
+        variables as the prompt passed in does. It returns as output either an
+        AgentAction or AgentFinish.
+
+    Example:
+
+        .. code-block:: python
+
+            from langchain.agents import AgentExecutor, create_tool_calling_agent, tool
+            from langchain_anthropic import ChatAnthropic
+            from langchain_core.prompts import ChatPromptTemplate
+
+            prompt = ChatPromptTemplate.from_messages(
+                [
+                    ("system", "You are a helpful assistant"),
+                    ("placeholder", "{chat_history}",
+                    ("human", "{input}"),
+                    ("placeholder", "{agent_scratchpad}"),
+                ]
+            )
+            model = ChatAnthropic(model="claude-3-opus-20240229")
+
+            @tool
+            def magic_function(input: int) -> int:
+                \"\"\"Applies a magic function to an input.\"\"\"
+                return input + 2
+
+            tools = [magic_function]
+
+            agent = create_tool_calling_agent(model, tools, prompt)
+            agent_executor = AgentExecutor(agent=agent, tools=tools, verbose=True)
+
+            agent_executor.invoke({"input": "what is the value of magic_function(3)?"})
+
+            # Using with chat history
+            from langchain_core.messages import AIMessage, HumanMessage
+            agent_executor.invoke(
+                {
+                    "input": "what's my name?",
+                    "chat_history": [
+                        HumanMessage(content="hi! my name is bob"),
+                        AIMessage(content="Hello Bob! How can I assist you today?"),
+                    ],
+                }
+            )
+
+    Prompt:
+
+        The agent prompt must have an `agent_scratchpad` key that is a
+            ``MessagesPlaceholder``. Intermediate agent actions and tool output
+            messages will be passed in here.
+    """
+    missing_vars = {"agent_scratchpad"}.difference(
+        prompt.input_variables + list(prompt.partial_variables)
+    )
+    if missing_vars:
+        raise ValueError(f"Prompt missing required variables: {missing_vars}")
+
+    if not hasattr(llm, "bind_tools"):
+        raise ValueError(
+            "This function requires a .bind_tools method be implemented on the LLM.",
+        )
+    llm_with_tools = llm.bind_tools(tools)
+
+    agent = (
+        RunnablePassthrough.assign(
+            agent_scratchpad=lambda x: format_to_tool_messages(x["intermediate_steps"])
+        )
+        | prompt
+        | llm_with_tools
+        | ToolsAgentOutputParser()
+    )
+    return agent
diff --git a/llm/Lib/site-packages/langchain/agents/tools.py b/llm/Lib/site-packages/langchain/agents/tools.py
new file mode 100644
index 0000000000000000000000000000000000000000..e804ab25025e2c7b4adcdc346f6036eea0dcebfe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/tools.py
@@ -0,0 +1,44 @@
+"""Interface for tools."""
+from typing import List, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.tools import BaseTool, Tool, tool
+
+
+class InvalidTool(BaseTool):
+    """Tool that is run when invalid tool name is encountered by agent."""
+
+    name: str = "invalid_tool"
+    description: str = "Called when tool name is invalid. Suggests valid tool names."
+
+    def _run(
+        self,
+        requested_tool_name: str,
+        available_tool_names: List[str],
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        available_tool_names_str = ", ".join([tool for tool in available_tool_names])
+        return (
+            f"{requested_tool_name} is not a valid tool, "
+            f"try one of [{available_tool_names_str}]."
+        )
+
+    async def _arun(
+        self,
+        requested_tool_name: str,
+        available_tool_names: List[str],
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+        available_tool_names_str = ", ".join([tool for tool in available_tool_names])
+        return (
+            f"{requested_tool_name} is not a valid tool, "
+            f"try one of [{available_tool_names_str}]."
+        )
+
+
+__all__ = ["InvalidTool", "BaseTool", "tool", "Tool"]
diff --git a/llm/Lib/site-packages/langchain/agents/types.py b/llm/Lib/site-packages/langchain/agents/types.py
new file mode 100644
index 0000000000000000000000000000000000000000..8d342ea94c7fa661987d4f72f25102f21cfccd32
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/types.py
@@ -0,0 +1,27 @@
+from typing import Dict, Type, Union
+
+from langchain.agents.agent import BaseSingleActionAgent
+from langchain.agents.agent_types import AgentType
+from langchain.agents.chat.base import ChatAgent
+from langchain.agents.conversational.base import ConversationalAgent
+from langchain.agents.conversational_chat.base import ConversationalChatAgent
+from langchain.agents.mrkl.base import ZeroShotAgent
+from langchain.agents.openai_functions_agent.base import OpenAIFunctionsAgent
+from langchain.agents.openai_functions_multi_agent.base import OpenAIMultiFunctionsAgent
+from langchain.agents.react.base import ReActDocstoreAgent
+from langchain.agents.self_ask_with_search.base import SelfAskWithSearchAgent
+from langchain.agents.structured_chat.base import StructuredChatAgent
+
+AGENT_TYPE = Union[Type[BaseSingleActionAgent], Type[OpenAIMultiFunctionsAgent]]
+
+AGENT_TO_CLASS: Dict[AgentType, AGENT_TYPE] = {
+    AgentType.ZERO_SHOT_REACT_DESCRIPTION: ZeroShotAgent,
+    AgentType.REACT_DOCSTORE: ReActDocstoreAgent,
+    AgentType.SELF_ASK_WITH_SEARCH: SelfAskWithSearchAgent,
+    AgentType.CONVERSATIONAL_REACT_DESCRIPTION: ConversationalAgent,
+    AgentType.CHAT_ZERO_SHOT_REACT_DESCRIPTION: ChatAgent,
+    AgentType.CHAT_CONVERSATIONAL_REACT_DESCRIPTION: ConversationalChatAgent,
+    AgentType.STRUCTURED_CHAT_ZERO_SHOT_REACT_DESCRIPTION: StructuredChatAgent,
+    AgentType.OPENAI_FUNCTIONS: OpenAIFunctionsAgent,
+    AgentType.OPENAI_MULTI_FUNCTIONS: OpenAIMultiFunctionsAgent,
+}
diff --git a/llm/Lib/site-packages/langchain/agents/utils.py b/llm/Lib/site-packages/langchain/agents/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..479b71612250b33f24d661a7adc17c679bbe1779
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/utils.py
@@ -0,0 +1,12 @@
+from typing import Sequence
+
+from langchain_core.tools import BaseTool
+
+
+def validate_tools_single_input(class_name: str, tools: Sequence[BaseTool]) -> None:
+    """Validate tools for single input."""
+    for tool in tools:
+        if not tool.is_single_input:
+            raise ValueError(
+                f"{class_name} does not support multi-input tool {tool.name}."
+            )
diff --git a/llm/Lib/site-packages/langchain/agents/xml/__init__.py b/llm/Lib/site-packages/langchain/agents/xml/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/agents/xml/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/xml/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..092e990fc6d5e5305d77ccf677a1f9246a0c2b48
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/xml/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/xml/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/xml/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6164501e1d2b95ea499534929eb29f3c0fa70fd8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/xml/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/xml/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/agents/xml/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5912e638ea2e9cea4215d585b8150b3451a3a583
Binary files /dev/null and b/llm/Lib/site-packages/langchain/agents/xml/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/agents/xml/base.py b/llm/Lib/site-packages/langchain/agents/xml/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..b79721522e59a3e9cc03348aa17d2db8e17897b3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/xml/base.py
@@ -0,0 +1,230 @@
+from typing import Any, List, Sequence, Tuple, Union
+
+from langchain_core._api import deprecated
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import Callbacks
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts.base import BasePromptTemplate
+from langchain_core.prompts.chat import AIMessagePromptTemplate, ChatPromptTemplate
+from langchain_core.runnables import Runnable, RunnablePassthrough
+from langchain_core.tools import BaseTool
+
+from langchain.agents.agent import BaseSingleActionAgent
+from langchain.agents.format_scratchpad import format_xml
+from langchain.agents.output_parsers import XMLAgentOutputParser
+from langchain.agents.xml.prompt import agent_instructions
+from langchain.chains.llm import LLMChain
+from langchain.tools.render import ToolsRenderer, render_text_description
+
+
+@deprecated("0.1.0", alternative="create_xml_agent", removal="0.2.0")
+class XMLAgent(BaseSingleActionAgent):
+    """Agent that uses XML tags.
+
+    Args:
+        tools: list of tools the agent can choose from
+        llm_chain: The LLMChain to call to predict the next action
+
+    Examples:
+
+        .. code-block:: python
+
+            from langchain.agents import XMLAgent
+            from langchain
+
+            tools = ...
+            model =
+
+
+    """
+
+    tools: List[BaseTool]
+    """List of tools this agent has access to."""
+    llm_chain: LLMChain
+    """Chain to use to predict action."""
+
+    @property
+    def input_keys(self) -> List[str]:
+        return ["input"]
+
+    @staticmethod
+    def get_default_prompt() -> ChatPromptTemplate:
+        base_prompt = ChatPromptTemplate.from_template(agent_instructions)
+        return base_prompt + AIMessagePromptTemplate.from_template(
+            "{intermediate_steps}"
+        )
+
+    @staticmethod
+    def get_default_output_parser() -> XMLAgentOutputParser:
+        return XMLAgentOutputParser()
+
+    def plan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[AgentAction, AgentFinish]:
+        log = ""
+        for action, observation in intermediate_steps:
+            log += (
+                f"<tool>{action.tool}</tool><tool_input>{action.tool_input}"
+                f"</tool_input><observation>{observation}</observation>"
+            )
+        tools = ""
+        for tool in self.tools:
+            tools += f"{tool.name}: {tool.description}\n"
+        inputs = {
+            "intermediate_steps": log,
+            "tools": tools,
+            "question": kwargs["input"],
+            "stop": ["</tool_input>", "</final_answer>"],
+        }
+        response = self.llm_chain(inputs, callbacks=callbacks)
+        return response[self.llm_chain.output_key]
+
+    async def aplan(
+        self,
+        intermediate_steps: List[Tuple[AgentAction, str]],
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Union[AgentAction, AgentFinish]:
+        log = ""
+        for action, observation in intermediate_steps:
+            log += (
+                f"<tool>{action.tool}</tool><tool_input>{action.tool_input}"
+                f"</tool_input><observation>{observation}</observation>"
+            )
+        tools = ""
+        for tool in self.tools:
+            tools += f"{tool.name}: {tool.description}\n"
+        inputs = {
+            "intermediate_steps": log,
+            "tools": tools,
+            "question": kwargs["input"],
+            "stop": ["</tool_input>", "</final_answer>"],
+        }
+        response = await self.llm_chain.acall(inputs, callbacks=callbacks)
+        return response[self.llm_chain.output_key]
+
+
+def create_xml_agent(
+    llm: BaseLanguageModel,
+    tools: Sequence[BaseTool],
+    prompt: BasePromptTemplate,
+    tools_renderer: ToolsRenderer = render_text_description,
+    *,
+    stop_sequence: Union[bool, List[str]] = True,
+) -> Runnable:
+    """Create an agent that uses XML to format its logic.
+
+    Args:
+        llm: LLM to use as the agent.
+        tools: Tools this agent has access to.
+        prompt: The prompt to use, must have input keys
+            `tools`: contains descriptions for each tool.
+            `agent_scratchpad`: contains previous agent actions and tool outputs.
+        tools_renderer: This controls how the tools are converted into a string and
+            then passed into the LLM. Default is `render_text_description`.
+        stop_sequence: bool or list of str.
+            If True, adds a stop token of "</tool_input>" to avoid hallucinates.
+            If False, does not add a stop token.
+            If a list of str, uses the provided list as the stop tokens.
+
+            Default is True. You may to set this to False if the LLM you are using
+            does not support stop sequences.
+
+    Returns:
+        A Runnable sequence representing an agent. It takes as input all the same input
+        variables as the prompt passed in does. It returns as output either an
+        AgentAction or AgentFinish.
+
+    Example:
+
+        .. code-block:: python
+
+            from langchain import hub
+            from langchain_community.chat_models import ChatAnthropic
+            from langchain.agents import AgentExecutor, create_xml_agent
+
+            prompt = hub.pull("hwchase17/xml-agent-convo")
+            model = ChatAnthropic()
+            tools = ...
+
+            agent = create_xml_agent(model, tools, prompt)
+            agent_executor = AgentExecutor(agent=agent, tools=tools)
+
+            agent_executor.invoke({"input": "hi"})
+
+            # Use with chat history
+            from langchain_core.messages import AIMessage, HumanMessage
+            agent_executor.invoke(
+                {
+                    "input": "what's my name?",
+                    # Notice that chat_history is a string
+                    # since this prompt is aimed at LLMs, not chat models
+                    "chat_history": "Human: My name is Bob\\nAI: Hello Bob!",
+                }
+            )
+
+    Prompt:
+
+        The prompt must have input keys:
+            * `tools`: contains descriptions for each tool.
+            * `agent_scratchpad`: contains previous agent actions and tool outputs as an XML string.
+
+        Here's an example:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import PromptTemplate
+
+            template = '''You are a helpful assistant. Help the user answer any questions.
+
+            You have access to the following tools:
+
+            {tools}
+
+            In order to use a tool, you can use <tool></tool> and <tool_input></tool_input> tags. You will then get back a response in the form <observation></observation>
+            For example, if you have a tool called 'search' that could run a google search, in order to search for the weather in SF you would respond:
+
+            <tool>search</tool><tool_input>weather in SF</tool_input>
+            <observation>64 degrees</observation>
+
+            When you are done, respond with a final answer between <final_answer></final_answer>. For example:
+
+            <final_answer>The weather in SF is 64 degrees</final_answer>
+
+            Begin!
+
+            Previous Conversation:
+            {chat_history}
+
+            Question: {input}
+            {agent_scratchpad}'''
+            prompt = PromptTemplate.from_template(template)
+    """  # noqa: E501
+    missing_vars = {"tools", "agent_scratchpad"}.difference(
+        prompt.input_variables + list(prompt.partial_variables)
+    )
+    if missing_vars:
+        raise ValueError(f"Prompt missing required variables: {missing_vars}")
+
+    prompt = prompt.partial(
+        tools=tools_renderer(list(tools)),
+    )
+
+    if stop_sequence:
+        stop = ["</tool_input>"] if stop_sequence is True else stop_sequence
+        llm_with_stop = llm.bind(stop=stop)
+    else:
+        llm_with_stop = llm
+
+    agent = (
+        RunnablePassthrough.assign(
+            agent_scratchpad=lambda x: format_xml(x["intermediate_steps"]),
+        )
+        | prompt
+        | llm_with_stop
+        | XMLAgentOutputParser()
+    )
+    return agent
diff --git a/llm/Lib/site-packages/langchain/agents/xml/prompt.py b/llm/Lib/site-packages/langchain/agents/xml/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..3972c6a07adc019d317bf0453e3357f5824430cc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/agents/xml/prompt.py
@@ -0,0 +1,22 @@
+# flake8: noqa
+# TODO: deprecate
+agent_instructions = """You are a helpful assistant. Help the user answer any questions.
+
+You have access to the following tools:
+
+{tools}
+
+In order to use a tool, you can use <tool></tool> and <tool_input></tool_input> tags. \
+You will then get back a response in the form <observation></observation>
+For example, if you have a tool called 'search' that could run a google search, in order to search for the weather in SF you would respond:
+
+<tool>search</tool><tool_input>weather in SF</tool_input>
+<observation>64 degrees</observation>
+
+When you are done, respond with a final answer between <final_answer></final_answer>. For example:
+
+<final_answer>The weather in SF is 64 degrees</final_answer>
+
+Begin!
+
+Question: {question}"""
diff --git a/llm/Lib/site-packages/langchain/base_language.py b/llm/Lib/site-packages/langchain/base_language.py
new file mode 100644
index 0000000000000000000000000000000000000000..37d1572d1981244d194c19b01f7b16ec1e675efd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/base_language.py
@@ -0,0 +1,6 @@
+"""Deprecated module for BaseLanguageModel class, kept for backwards compatibility."""
+from __future__ import annotations
+
+from langchain_core.language_models import BaseLanguageModel
+
+__all__ = ["BaseLanguageModel"]
diff --git a/llm/Lib/site-packages/langchain/cache.py b/llm/Lib/site-packages/langchain/cache.py
new file mode 100644
index 0000000000000000000000000000000000000000..d0badba70c79f714b04c56fc2e6dcb311f4b49e4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/cache.py
@@ -0,0 +1,37 @@
+from langchain_community.cache import (
+    AstraDBCache,
+    AstraDBSemanticCache,
+    AzureCosmosDBSemanticCache,
+    CassandraCache,
+    CassandraSemanticCache,
+    FullLLMCache,
+    FullMd5LLMCache,
+    GPTCache,
+    InMemoryCache,
+    MomentoCache,
+    RedisCache,
+    RedisSemanticCache,
+    SQLAlchemyCache,
+    SQLAlchemyMd5Cache,
+    SQLiteCache,
+    UpstashRedisCache,
+)
+
+__all__ = [
+    "InMemoryCache",
+    "FullLLMCache",
+    "SQLAlchemyCache",
+    "SQLiteCache",
+    "UpstashRedisCache",
+    "RedisCache",
+    "RedisSemanticCache",
+    "GPTCache",
+    "MomentoCache",
+    "CassandraCache",
+    "CassandraSemanticCache",
+    "FullMd5LLMCache",
+    "SQLAlchemyMd5Cache",
+    "AstraDBCache",
+    "AstraDBSemanticCache",
+    "AzureCosmosDBSemanticCache",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/__init__.py b/llm/Lib/site-packages/langchain/callbacks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..80d9671fde3d7501b00a2c88a9bc52091736db16
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/__init__.py
@@ -0,0 +1,82 @@
+"""**Callback handlers** allow listening to events in LangChain.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseCallbackHandler --> <name>CallbackHandler  # Example: AimCallbackHandler
+"""
+import warnings
+from typing import Any
+
+from langchain_core._api import LangChainDeprecationWarning
+from langchain_core.callbacks import (
+    StdOutCallbackHandler,
+    StreamingStdOutCallbackHandler,
+)
+from langchain_core.tracers.context import (
+    collect_runs,
+    tracing_enabled,
+    tracing_v2_enabled,
+)
+from langchain_core.tracers.langchain import LangChainTracer
+
+from langchain.callbacks.file import FileCallbackHandler
+from langchain.callbacks.streaming_aiter import AsyncIteratorCallbackHandler
+from langchain.callbacks.streaming_stdout_final_only import (
+    FinalStreamingStdOutCallbackHandler,
+)
+from langchain.utils.interactive_env import is_interactive_env
+
+
+def __getattr__(name: str) -> Any:
+    from langchain_community import callbacks
+
+    # If not in interactive env, raise warning.
+    if not is_interactive_env():
+        warnings.warn(
+            "Importing this callback from langchain is deprecated. Importing it from "
+            "langchain will no longer be supported as of langchain==0.2.0. "
+            "Please import from langchain-community instead:\n\n"
+            f"`from langchain_community.callbacks import {name}`.\n\n"
+            "To install langchain-community run `pip install -U langchain-community`.",
+            category=LangChainDeprecationWarning,
+        )
+
+    return getattr(callbacks, name)
+
+
+__all__ = [
+    "AimCallbackHandler",
+    "ArgillaCallbackHandler",
+    "ArizeCallbackHandler",
+    "PromptLayerCallbackHandler",
+    "ArthurCallbackHandler",
+    "ClearMLCallbackHandler",
+    "CometCallbackHandler",
+    "ContextCallbackHandler",
+    "FileCallbackHandler",
+    "HumanApprovalCallbackHandler",
+    "InfinoCallbackHandler",
+    "MlflowCallbackHandler",
+    "LLMonitorCallbackHandler",
+    "OpenAICallbackHandler",
+    "StdOutCallbackHandler",
+    "AsyncIteratorCallbackHandler",
+    "StreamingStdOutCallbackHandler",
+    "FinalStreamingStdOutCallbackHandler",
+    "LLMThoughtLabeler",
+    "LangChainTracer",
+    "StreamlitCallbackHandler",
+    "WandbCallbackHandler",
+    "WhyLabsCallbackHandler",
+    "get_openai_callback",
+    "tracing_enabled",
+    "tracing_v2_enabled",
+    "collect_runs",
+    "wandb_tracing_enabled",
+    "FlyteCallbackHandler",
+    "SageMakerCallbackHandler",
+    "LabelStudioCallbackHandler",
+    "TrubricsCallbackHandler",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8a1e6ebc30a298ed37414dad5a6c81764893a1b1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/aim_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/aim_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8861f6f7572a1955db6b668384d2dd4c01f2fb5e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/aim_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/argilla_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/argilla_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1fa63b9395ddf4ed7efab9971423892d51b9b08b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/argilla_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/arize_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/arize_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7bedcdae8e952f17aa37c971a76553f2b282fed3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/arize_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/arthur_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/arthur_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f7213191f259a6cfff19531b404ef044c13e5fd6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/arthur_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b32e3190e49cfdc15b236357642174bbd463891b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/clearml_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/clearml_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..46e6c4106c6d2f9dcd6f638bb362399ed8e55a4b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/clearml_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/comet_ml_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/comet_ml_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d43335ae8e6f24d203bbb2865e75d325755ba29b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/comet_ml_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/confident_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/confident_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5671a9a829ef87a398e4fc809349a4bae53f41dc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/confident_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/context_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/context_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a31d134ab4e6260c5e18c3c9d14e92731ae8f6d2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/context_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/file.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/file.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d674efd8ec15cd1f1b3f07261a96a0bb0b014ac0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/file.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/flyte_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/flyte_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b4016b2a5e6f6340e16221163d1af26951fc02ff
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/flyte_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/human.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/human.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1a5d9edfc3e5caa1684062439649ccda6c80ddf8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/human.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/infino_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/infino_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d8e344465cd953be4c01f397b26958694589586f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/infino_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/labelstudio_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/labelstudio_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..33101599c7e44c499bb53aeaadea00a4d8f7d574
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/labelstudio_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/llmonitor_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/llmonitor_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e94eab60779138079c828d0aef8a92dc627a04c9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/llmonitor_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/manager.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/manager.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..349701737da9c07ee40917e68c68f0c8bb921bfd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/manager.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/mlflow_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/mlflow_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7996883d2a176f5e67943bc352cc8e025b9b14d6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/mlflow_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/openai_info.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/openai_info.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..70a4433553c077e1f0935082ad6c8266be7247cf
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/openai_info.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/promptlayer_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/promptlayer_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f85f6372d4f72255ae5445f2f9e1a838fc68a717
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/promptlayer_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/sagemaker_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/sagemaker_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dff3175c43e2c909d75d75d131d3ef5cdc94ed0e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/sagemaker_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/stdout.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/stdout.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e16bb1121a358e5506c39e1f10d9cde97b7b8b39
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/stdout.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/streaming_aiter.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/streaming_aiter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..39467ee12ada2d7114b644c3e3359f635895d8b7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/streaming_aiter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/streaming_aiter_final_only.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/streaming_aiter_final_only.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..816b3adba26efb5976c4e960d52c92ecfb765577
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/streaming_aiter_final_only.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/streaming_stdout.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/streaming_stdout.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d8ef790c87e642245b06ee4a6ed717ced7905fbf
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/streaming_stdout.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/streaming_stdout_final_only.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/streaming_stdout_final_only.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d2ea383c2ad0770ab321c6a9541f6412b977aed7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/streaming_stdout_final_only.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/trubrics_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/trubrics_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9e6edf83d4b1b3d15b1779f5722f68e56777ca63
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/trubrics_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aede853d2f7f9d29e59c6e275503421ebf152eae
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/wandb_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/wandb_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..49dbb8e91feb0cb22b239de7d774ebb877d7e842
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/wandb_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/__pycache__/whylabs_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/__pycache__/whylabs_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f9f97dd4434c318af3288fcfb983d70ad11e7805
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/__pycache__/whylabs_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/aim_callback.py b/llm/Lib/site-packages/langchain/callbacks/aim_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..563cba490613b5c061a5f74d333429f50a15089a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/aim_callback.py
@@ -0,0 +1,7 @@
+from langchain_community.callbacks.aim_callback import (
+    AimCallbackHandler,
+    BaseMetadataCallbackHandler,
+    import_aim,
+)
+
+__all__ = ["import_aim", "BaseMetadataCallbackHandler", "AimCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/argilla_callback.py b/llm/Lib/site-packages/langchain/callbacks/argilla_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..b3d085faf7102a2dc78e69b90f802b91684c629f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/argilla_callback.py
@@ -0,0 +1,3 @@
+from langchain_community.callbacks.argilla_callback import ArgillaCallbackHandler
+
+__all__ = ["ArgillaCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/arize_callback.py b/llm/Lib/site-packages/langchain/callbacks/arize_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..c120de398f6781b7cf3f350bfb9547526df43d05
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/arize_callback.py
@@ -0,0 +1,3 @@
+from langchain_community.callbacks.arize_callback import ArizeCallbackHandler
+
+__all__ = ["ArizeCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/arthur_callback.py b/llm/Lib/site-packages/langchain/callbacks/arthur_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..3bf52efa433e2e7de3bd8e0a27421ab746b31790
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/arthur_callback.py
@@ -0,0 +1,7 @@
+from langchain_community.callbacks.arthur_callback import (
+    ArthurCallbackHandler,
+)
+
+__all__ = [
+    "ArthurCallbackHandler",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/base.py b/llm/Lib/site-packages/langchain/callbacks/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..7eaedce6fc89cc5b6a47d094c550aeadae859c06
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/base.py
@@ -0,0 +1,28 @@
+"""Base callback handler that can be used to handle callbacks in langchain."""
+from __future__ import annotations
+
+from langchain_core.callbacks import (
+    AsyncCallbackHandler,
+    BaseCallbackHandler,
+    BaseCallbackManager,
+    CallbackManagerMixin,
+    Callbacks,
+    ChainManagerMixin,
+    LLMManagerMixin,
+    RetrieverManagerMixin,
+    RunManagerMixin,
+    ToolManagerMixin,
+)
+
+__all__ = [
+    "RetrieverManagerMixin",
+    "LLMManagerMixin",
+    "ChainManagerMixin",
+    "ToolManagerMixin",
+    "CallbackManagerMixin",
+    "RunManagerMixin",
+    "BaseCallbackHandler",
+    "AsyncCallbackHandler",
+    "BaseCallbackManager",
+    "Callbacks",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/clearml_callback.py b/llm/Lib/site-packages/langchain/callbacks/clearml_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..8cc83d956e2e0102c2353d11664c1c3da04e3299
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/clearml_callback.py
@@ -0,0 +1,5 @@
+from langchain_community.callbacks.clearml_callback import (
+    ClearMLCallbackHandler,
+)
+
+__all__ = ["ClearMLCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/comet_ml_callback.py b/llm/Lib/site-packages/langchain/callbacks/comet_ml_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed2813d32d6b60a8ee380df277948c8bd68ab7cd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/comet_ml_callback.py
@@ -0,0 +1,7 @@
+from langchain_community.callbacks.comet_ml_callback import (
+    CometCallbackHandler,
+)
+
+__all__ = [
+    "CometCallbackHandler",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/confident_callback.py b/llm/Lib/site-packages/langchain/callbacks/confident_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..48236ed500ea32e9e69ebe3815624216b6ce5502
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/confident_callback.py
@@ -0,0 +1,3 @@
+from langchain_community.callbacks.confident_callback import DeepEvalCallbackHandler
+
+__all__ = ["DeepEvalCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/context_callback.py b/llm/Lib/site-packages/langchain/callbacks/context_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..441ddb3f6b9575ae029f73e3814b19bde47c7a2a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/context_callback.py
@@ -0,0 +1,5 @@
+from langchain_community.callbacks.context_callback import (
+    ContextCallbackHandler,
+)
+
+__all__ = ["ContextCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/file.py b/llm/Lib/site-packages/langchain/callbacks/file.py
new file mode 100644
index 0000000000000000000000000000000000000000..06bcecb027d0dc7b04fbbc0797444f1a6f0082a6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/file.py
@@ -0,0 +1,69 @@
+"""Callback Handler that writes to a file."""
+from typing import Any, Dict, Optional, TextIO, cast
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.utils.input import print_text
+
+
+class FileCallbackHandler(BaseCallbackHandler):
+    """Callback Handler that writes to a file."""
+
+    def __init__(
+        self, filename: str, mode: str = "a", color: Optional[str] = None
+    ) -> None:
+        """Initialize callback handler."""
+        self.file = cast(TextIO, open(filename, mode, encoding="utf-8"))
+        self.color = color
+
+    def __del__(self) -> None:
+        """Destructor to cleanup when done."""
+        self.file.close()
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Print out that we are entering a chain."""
+        class_name = serialized.get("name", serialized.get("id", ["<unknown>"])[-1])
+        print_text(
+            f"\n\n\033[1m> Entering new {class_name} chain...\033[0m",
+            end="\n",
+            file=self.file,
+        )
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Print out that we finished a chain."""
+        print_text("\n\033[1m> Finished chain.\033[0m", end="\n", file=self.file)
+
+    def on_agent_action(
+        self, action: AgentAction, color: Optional[str] = None, **kwargs: Any
+    ) -> Any:
+        """Run on agent action."""
+        print_text(action.log, color=color or self.color, file=self.file)
+
+    def on_tool_end(
+        self,
+        output: str,
+        color: Optional[str] = None,
+        observation_prefix: Optional[str] = None,
+        llm_prefix: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        """If not the final action, print out observation."""
+        if observation_prefix is not None:
+            print_text(f"\n{observation_prefix}", file=self.file)
+        print_text(output, color=color or self.color, file=self.file)
+        if llm_prefix is not None:
+            print_text(f"\n{llm_prefix}", file=self.file)
+
+    def on_text(
+        self, text: str, color: Optional[str] = None, end: str = "", **kwargs: Any
+    ) -> None:
+        """Run when agent ends."""
+        print_text(text, color=color or self.color, end=end, file=self.file)
+
+    def on_agent_finish(
+        self, finish: AgentFinish, color: Optional[str] = None, **kwargs: Any
+    ) -> None:
+        """Run on agent end."""
+        print_text(finish.log, color=color or self.color, end="\n", file=self.file)
diff --git a/llm/Lib/site-packages/langchain/callbacks/flyte_callback.py b/llm/Lib/site-packages/langchain/callbacks/flyte_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..ae9b96615e42b0605d041639ec758e6fb0942c03
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/flyte_callback.py
@@ -0,0 +1,5 @@
+from langchain_community.callbacks.flyte_callback import (
+    FlyteCallbackHandler,
+)
+
+__all__ = ["FlyteCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/human.py b/llm/Lib/site-packages/langchain/callbacks/human.py
new file mode 100644
index 0000000000000000000000000000000000000000..f4fbc6f33594da94bc5e9514b07c6a39b7e5c6a6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/human.py
@@ -0,0 +1,11 @@
+from langchain_community.callbacks.human import (
+    AsyncHumanApprovalCallbackHandler,
+    HumanApprovalCallbackHandler,
+    HumanRejectedException,
+)
+
+__all__ = [
+    "HumanRejectedException",
+    "HumanApprovalCallbackHandler",
+    "AsyncHumanApprovalCallbackHandler",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/infino_callback.py b/llm/Lib/site-packages/langchain/callbacks/infino_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..1b7045bd47372d64bf241b09312b1e45c88b0cd1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/infino_callback.py
@@ -0,0 +1,7 @@
+from langchain_community.callbacks.infino_callback import (
+    InfinoCallbackHandler,
+)
+
+__all__ = [
+    "InfinoCallbackHandler",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/labelstudio_callback.py b/llm/Lib/site-packages/langchain/callbacks/labelstudio_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..5790dff396d82b21747ab6fb1ea88a4adbd0e765
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/labelstudio_callback.py
@@ -0,0 +1,7 @@
+from langchain_community.callbacks.labelstudio_callback import (
+    LabelStudioCallbackHandler,
+    LabelStudioMode,
+    get_default_label_configs,
+)
+
+__all__ = ["LabelStudioMode", "get_default_label_configs", "LabelStudioCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/llmonitor_callback.py b/llm/Lib/site-packages/langchain/callbacks/llmonitor_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..82c7bd499bc64f94234634f3eabc529b4e7a0377
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/llmonitor_callback.py
@@ -0,0 +1,7 @@
+from langchain_community.callbacks.llmonitor_callback import (
+    LLMonitorCallbackHandler,
+)
+
+__all__ = [
+    "LLMonitorCallbackHandler",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/manager.py b/llm/Lib/site-packages/langchain/callbacks/manager.py
new file mode 100644
index 0000000000000000000000000000000000000000..8343c29977ed26b56fc4d521cc81658f31188155
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/manager.py
@@ -0,0 +1,67 @@
+from __future__ import annotations
+
+from langchain_community.callbacks.manager import (
+    get_openai_callback,
+    wandb_tracing_enabled,
+)
+from langchain_core.callbacks.manager import (
+    AsyncCallbackManager,
+    AsyncCallbackManagerForChainGroup,
+    AsyncCallbackManagerForChainRun,
+    AsyncCallbackManagerForLLMRun,
+    AsyncCallbackManagerForRetrieverRun,
+    AsyncCallbackManagerForToolRun,
+    AsyncParentRunManager,
+    AsyncRunManager,
+    BaseRunManager,
+    CallbackManager,
+    CallbackManagerForChainGroup,
+    CallbackManagerForChainRun,
+    CallbackManagerForLLMRun,
+    CallbackManagerForRetrieverRun,
+    CallbackManagerForToolRun,
+    Callbacks,
+    ParentRunManager,
+    RunManager,
+    ahandle_event,
+    atrace_as_chain_group,
+    handle_event,
+    trace_as_chain_group,
+)
+from langchain_core.tracers.context import (
+    collect_runs,
+    tracing_enabled,
+    tracing_v2_enabled,
+)
+from langchain_core.utils.env import env_var_is_set
+
+__all__ = [
+    "BaseRunManager",
+    "RunManager",
+    "ParentRunManager",
+    "AsyncRunManager",
+    "AsyncParentRunManager",
+    "CallbackManagerForLLMRun",
+    "AsyncCallbackManagerForLLMRun",
+    "CallbackManagerForChainRun",
+    "AsyncCallbackManagerForChainRun",
+    "CallbackManagerForToolRun",
+    "AsyncCallbackManagerForToolRun",
+    "CallbackManagerForRetrieverRun",
+    "AsyncCallbackManagerForRetrieverRun",
+    "CallbackManager",
+    "CallbackManagerForChainGroup",
+    "AsyncCallbackManager",
+    "AsyncCallbackManagerForChainGroup",
+    "tracing_enabled",
+    "tracing_v2_enabled",
+    "collect_runs",
+    "atrace_as_chain_group",
+    "trace_as_chain_group",
+    "handle_event",
+    "ahandle_event",
+    "Callbacks",
+    "env_var_is_set",
+    "get_openai_callback",
+    "wandb_tracing_enabled",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/mlflow_callback.py b/llm/Lib/site-packages/langchain/callbacks/mlflow_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..1119008fabf29c9317d7dd150cd2b0919b87ec0f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/mlflow_callback.py
@@ -0,0 +1,13 @@
+from langchain_community.callbacks.mlflow_callback import (
+    MlflowCallbackHandler,
+    MlflowLogger,
+    analyze_text,
+    construct_html_from_prompt_and_generation,
+)
+
+__all__ = [
+    "analyze_text",
+    "construct_html_from_prompt_and_generation",
+    "MlflowLogger",
+    "MlflowCallbackHandler",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/openai_info.py b/llm/Lib/site-packages/langchain/callbacks/openai_info.py
new file mode 100644
index 0000000000000000000000000000000000000000..cf2115000c49fef55f0d3f3e3d24aea805fd69da
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/openai_info.py
@@ -0,0 +1,3 @@
+from langchain_community.callbacks.openai_info import OpenAICallbackHandler
+
+__all__ = ["OpenAICallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/promptlayer_callback.py b/llm/Lib/site-packages/langchain/callbacks/promptlayer_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..f2dacce14685a49aff3004eeae65ded216a3e1f9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/promptlayer_callback.py
@@ -0,0 +1,5 @@
+from langchain_community.callbacks.promptlayer_callback import (
+    PromptLayerCallbackHandler,
+)
+
+__all__ = ["PromptLayerCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/sagemaker_callback.py b/llm/Lib/site-packages/langchain/callbacks/sagemaker_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..4af832a1e611f1d64609e5092b8c9019ba278877
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/sagemaker_callback.py
@@ -0,0 +1,5 @@
+from langchain_community.callbacks.sagemaker_callback import (
+    SageMakerCallbackHandler,
+)
+
+__all__ = ["SageMakerCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/stdout.py b/llm/Lib/site-packages/langchain/callbacks/stdout.py
new file mode 100644
index 0000000000000000000000000000000000000000..754e58248e4700a666314dddf21a8f4248f8e541
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/stdout.py
@@ -0,0 +1,3 @@
+from langchain_core.callbacks.stdout import StdOutCallbackHandler
+
+__all__ = ["StdOutCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/streaming_aiter.py b/llm/Lib/site-packages/langchain/callbacks/streaming_aiter.py
new file mode 100644
index 0000000000000000000000000000000000000000..2df5849db8f77c161b62ba9d4487849633dba0a2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/streaming_aiter.py
@@ -0,0 +1,71 @@
+from __future__ import annotations
+
+import asyncio
+from typing import Any, AsyncIterator, Dict, List, Literal, Union, cast
+
+from langchain_core.callbacks import AsyncCallbackHandler
+from langchain_core.outputs import LLMResult
+
+# TODO If used by two LLM runs in parallel this won't work as expected
+
+
+class AsyncIteratorCallbackHandler(AsyncCallbackHandler):
+    """Callback handler that returns an async iterator."""
+
+    queue: asyncio.Queue[str]
+
+    done: asyncio.Event
+
+    @property
+    def always_verbose(self) -> bool:
+        return True
+
+    def __init__(self) -> None:
+        self.queue = asyncio.Queue()
+        self.done = asyncio.Event()
+
+    async def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        # If two calls are made in a row, this resets the state
+        self.done.clear()
+
+    async def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        if token is not None and token != "":
+            self.queue.put_nowait(token)
+
+    async def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        self.done.set()
+
+    async def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        self.done.set()
+
+    # TODO implement the other methods
+
+    async def aiter(self) -> AsyncIterator[str]:
+        while not self.queue.empty() or not self.done.is_set():
+            # Wait for the next token in the queue,
+            # but stop waiting if the done event is set
+            done, other = await asyncio.wait(
+                [
+                    # NOTE: If you add other tasks here, update the code below,
+                    # which assumes each set has exactly one task each
+                    asyncio.ensure_future(self.queue.get()),
+                    asyncio.ensure_future(self.done.wait()),
+                ],
+                return_when=asyncio.FIRST_COMPLETED,
+            )
+
+            # Cancel the other task
+            if other:
+                other.pop().cancel()
+
+            # Extract the value of the first completed task
+            token_or_done = cast(Union[str, Literal[True]], done.pop().result())
+
+            # If the extracted value is the boolean True, the done event was set
+            if token_or_done is True:
+                break
+
+            # Otherwise, the extracted value is a token, which we yield
+            yield token_or_done
diff --git a/llm/Lib/site-packages/langchain/callbacks/streaming_aiter_final_only.py b/llm/Lib/site-packages/langchain/callbacks/streaming_aiter_final_only.py
new file mode 100644
index 0000000000000000000000000000000000000000..3cb8623b4a60b0cc0d40ebba5456c386ce4adeaa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/streaming_aiter_final_only.py
@@ -0,0 +1,89 @@
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+from langchain_core.outputs import LLMResult
+
+from langchain.callbacks.streaming_aiter import AsyncIteratorCallbackHandler
+
+DEFAULT_ANSWER_PREFIX_TOKENS = ["Final", "Answer", ":"]
+
+
+class AsyncFinalIteratorCallbackHandler(AsyncIteratorCallbackHandler):
+    """Callback handler that returns an async iterator.
+    Only the final output of the agent will be iterated.
+    """
+
+    def append_to_last_tokens(self, token: str) -> None:
+        self.last_tokens.append(token)
+        self.last_tokens_stripped.append(token.strip())
+        if len(self.last_tokens) > len(self.answer_prefix_tokens):
+            self.last_tokens.pop(0)
+            self.last_tokens_stripped.pop(0)
+
+    def check_if_answer_reached(self) -> bool:
+        if self.strip_tokens:
+            return self.last_tokens_stripped == self.answer_prefix_tokens_stripped
+        else:
+            return self.last_tokens == self.answer_prefix_tokens
+
+    def __init__(
+        self,
+        *,
+        answer_prefix_tokens: Optional[List[str]] = None,
+        strip_tokens: bool = True,
+        stream_prefix: bool = False,
+    ) -> None:
+        """Instantiate AsyncFinalIteratorCallbackHandler.
+
+        Args:
+            answer_prefix_tokens: Token sequence that prefixes the answer.
+                Default is ["Final", "Answer", ":"]
+            strip_tokens: Ignore white spaces and new lines when comparing
+                answer_prefix_tokens to last tokens? (to determine if answer has been
+                reached)
+            stream_prefix: Should answer prefix itself also be streamed?
+        """
+        super().__init__()
+        if answer_prefix_tokens is None:
+            self.answer_prefix_tokens = DEFAULT_ANSWER_PREFIX_TOKENS
+        else:
+            self.answer_prefix_tokens = answer_prefix_tokens
+        if strip_tokens:
+            self.answer_prefix_tokens_stripped = [
+                token.strip() for token in self.answer_prefix_tokens
+            ]
+        else:
+            self.answer_prefix_tokens_stripped = self.answer_prefix_tokens
+        self.last_tokens = [""] * len(self.answer_prefix_tokens)
+        self.last_tokens_stripped = [""] * len(self.answer_prefix_tokens)
+        self.strip_tokens = strip_tokens
+        self.stream_prefix = stream_prefix
+        self.answer_reached = False
+
+    async def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        # If two calls are made in a row, this resets the state
+        self.done.clear()
+        self.answer_reached = False
+
+    async def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        if self.answer_reached:
+            self.done.set()
+
+    async def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        # Remember the last n tokens, where n = len(answer_prefix_tokens)
+        self.append_to_last_tokens(token)
+
+        # Check if the last n tokens match the answer_prefix_tokens list ...
+        if self.check_if_answer_reached():
+            self.answer_reached = True
+            if self.stream_prefix:
+                for t in self.last_tokens:
+                    self.queue.put_nowait(t)
+            return
+
+        # If yes, then put tokens from now on
+        if self.answer_reached:
+            self.queue.put_nowait(token)
diff --git a/llm/Lib/site-packages/langchain/callbacks/streaming_stdout.py b/llm/Lib/site-packages/langchain/callbacks/streaming_stdout.py
new file mode 100644
index 0000000000000000000000000000000000000000..1870f79210aa33d3ca844e2d6dbe26d80cf0b23d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/streaming_stdout.py
@@ -0,0 +1,4 @@
+"""Callback Handler streams to stdout on new llm token."""
+from langchain_core.callbacks import StreamingStdOutCallbackHandler
+
+__all__ = ["StreamingStdOutCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/streaming_stdout_final_only.py b/llm/Lib/site-packages/langchain/callbacks/streaming_stdout_final_only.py
new file mode 100644
index 0000000000000000000000000000000000000000..2dce9266a7b297f02e8919965a611462141330cd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/streaming_stdout_final_only.py
@@ -0,0 +1,88 @@
+"""Callback Handler streams to stdout on new llm token."""
+import sys
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import StreamingStdOutCallbackHandler
+
+DEFAULT_ANSWER_PREFIX_TOKENS = ["Final", "Answer", ":"]
+
+
+class FinalStreamingStdOutCallbackHandler(StreamingStdOutCallbackHandler):
+    """Callback handler for streaming in agents.
+    Only works with agents using LLMs that support streaming.
+
+    Only the final output of the agent will be streamed.
+    """
+
+    def append_to_last_tokens(self, token: str) -> None:
+        self.last_tokens.append(token)
+        self.last_tokens_stripped.append(token.strip())
+        if len(self.last_tokens) > len(self.answer_prefix_tokens):
+            self.last_tokens.pop(0)
+            self.last_tokens_stripped.pop(0)
+
+    def check_if_answer_reached(self) -> bool:
+        if self.strip_tokens:
+            return self.last_tokens_stripped == self.answer_prefix_tokens_stripped
+        else:
+            return self.last_tokens == self.answer_prefix_tokens
+
+    def __init__(
+        self,
+        *,
+        answer_prefix_tokens: Optional[List[str]] = None,
+        strip_tokens: bool = True,
+        stream_prefix: bool = False,
+    ) -> None:
+        """Instantiate FinalStreamingStdOutCallbackHandler.
+
+        Args:
+            answer_prefix_tokens: Token sequence that prefixes the answer.
+                Default is ["Final", "Answer", ":"]
+            strip_tokens: Ignore white spaces and new lines when comparing
+                answer_prefix_tokens to last tokens? (to determine if answer has been
+                reached)
+            stream_prefix: Should answer prefix itself also be streamed?
+        """
+        super().__init__()
+        if answer_prefix_tokens is None:
+            self.answer_prefix_tokens = DEFAULT_ANSWER_PREFIX_TOKENS
+        else:
+            self.answer_prefix_tokens = answer_prefix_tokens
+        if strip_tokens:
+            self.answer_prefix_tokens_stripped = [
+                token.strip() for token in self.answer_prefix_tokens
+            ]
+        else:
+            self.answer_prefix_tokens_stripped = self.answer_prefix_tokens
+        self.last_tokens = [""] * len(self.answer_prefix_tokens)
+        self.last_tokens_stripped = [""] * len(self.answer_prefix_tokens)
+        self.strip_tokens = strip_tokens
+        self.stream_prefix = stream_prefix
+        self.answer_reached = False
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """Run when LLM starts running."""
+        self.answer_reached = False
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Run on new LLM token. Only available when streaming is enabled."""
+
+        # Remember the last n tokens, where n = len(answer_prefix_tokens)
+        self.append_to_last_tokens(token)
+
+        # Check if the last n tokens match the answer_prefix_tokens list ...
+        if self.check_if_answer_reached():
+            self.answer_reached = True
+            if self.stream_prefix:
+                for t in self.last_tokens:
+                    sys.stdout.write(t)
+                sys.stdout.flush()
+            return
+
+        # ... if yes, then print tokens from now on
+        if self.answer_reached:
+            sys.stdout.write(token)
+            sys.stdout.flush()
diff --git a/llm/Lib/site-packages/langchain/callbacks/streamlit/__init__.py b/llm/Lib/site-packages/langchain/callbacks/streamlit/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e82104a2236f9094aa7950dfe5c6800028d5754a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/streamlit/__init__.py
@@ -0,0 +1,81 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Optional
+
+from langchain.callbacks.base import BaseCallbackHandler
+from langchain.callbacks.streamlit.streamlit_callback_handler import (
+    LLMThoughtLabeler as LLMThoughtLabeler,
+)
+from langchain.callbacks.streamlit.streamlit_callback_handler import (
+    StreamlitCallbackHandler as _InternalStreamlitCallbackHandler,
+)
+
+if TYPE_CHECKING:
+    from streamlit.delta_generator import DeltaGenerator
+
+
+def StreamlitCallbackHandler(
+    parent_container: DeltaGenerator,
+    *,
+    max_thought_containers: int = 4,
+    expand_new_thoughts: bool = True,
+    collapse_completed_thoughts: bool = True,
+    thought_labeler: Optional[LLMThoughtLabeler] = None,
+) -> BaseCallbackHandler:
+    """Callback Handler that writes to a Streamlit app.
+
+    This CallbackHandler is geared towards
+    use with a LangChain Agent; it displays the Agent's LLM and tool-usage "thoughts"
+    inside a series of Streamlit expanders.
+
+    Parameters
+    ----------
+    parent_container
+        The `st.container` that will contain all the Streamlit elements that the
+        Handler creates.
+    max_thought_containers
+        The max number of completed LLM thought containers to show at once. When this
+        threshold is reached, a new thought will cause the oldest thoughts to be
+        collapsed into a "History" expander. Defaults to 4.
+    expand_new_thoughts
+        Each LLM "thought" gets its own `st.expander`. This param controls whether that
+        expander is expanded by default. Defaults to True.
+    collapse_completed_thoughts
+        If True, LLM thought expanders will be collapsed when completed.
+        Defaults to True.
+    thought_labeler
+        An optional custom LLMThoughtLabeler instance. If unspecified, the handler
+        will use the default thought labeling logic. Defaults to None.
+
+    Returns
+    -------
+    A new StreamlitCallbackHandler instance.
+
+    Note that this is an "auto-updating" API: if the installed version of Streamlit
+    has a more recent StreamlitCallbackHandler implementation, an instance of that class
+    will be used.
+
+    """
+    # If we're using a version of Streamlit that implements StreamlitCallbackHandler,
+    # delegate to it instead of using our built-in handler. The official handler is
+    # guaranteed to support the same set of kwargs.
+    try:
+        from streamlit.external.langchain import (
+            StreamlitCallbackHandler as OfficialStreamlitCallbackHandler,  # type: ignore # noqa: 501
+        )
+
+        return OfficialStreamlitCallbackHandler(
+            parent_container,
+            max_thought_containers=max_thought_containers,
+            expand_new_thoughts=expand_new_thoughts,
+            collapse_completed_thoughts=collapse_completed_thoughts,
+            thought_labeler=thought_labeler,
+        )
+    except ImportError:
+        return _InternalStreamlitCallbackHandler(
+            parent_container,
+            max_thought_containers=max_thought_containers,
+            expand_new_thoughts=expand_new_thoughts,
+            collapse_completed_thoughts=collapse_completed_thoughts,
+            thought_labeler=thought_labeler,
+        )
diff --git a/llm/Lib/site-packages/langchain/callbacks/streamlit/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/streamlit/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c8bc352c8e840f32c537cf6bb672d386d49fb4ee
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/streamlit/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/streamlit/__pycache__/mutable_expander.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/streamlit/__pycache__/mutable_expander.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..106471c6a9b6b89e1cf4b3cbce4064d60f8d414e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/streamlit/__pycache__/mutable_expander.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/streamlit/__pycache__/streamlit_callback_handler.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/streamlit/__pycache__/streamlit_callback_handler.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fe4959e7c7a4d7c9a877de48c4169fc6711e8129
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/streamlit/__pycache__/streamlit_callback_handler.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/streamlit/mutable_expander.py b/llm/Lib/site-packages/langchain/callbacks/streamlit/mutable_expander.py
new file mode 100644
index 0000000000000000000000000000000000000000..c36feb12b683d58f67636f335cf963f76f3cafc2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/streamlit/mutable_expander.py
@@ -0,0 +1,7 @@
+from langchain_community.callbacks.streamlit.mutable_expander import (
+    ChildRecord,
+    ChildType,
+    MutableExpander,
+)
+
+__all__ = ["ChildType", "ChildRecord", "MutableExpander"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/streamlit/streamlit_callback_handler.py b/llm/Lib/site-packages/langchain/callbacks/streamlit/streamlit_callback_handler.py
new file mode 100644
index 0000000000000000000000000000000000000000..7cae533375f00926ecf9b3c7bf8081627bdd95d2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/streamlit/streamlit_callback_handler.py
@@ -0,0 +1,23 @@
+from langchain_community.callbacks.streamlit.streamlit_callback_handler import (
+    CHECKMARK_EMOJI,
+    EXCEPTION_EMOJI,
+    HISTORY_EMOJI,
+    THINKING_EMOJI,
+    LLMThought,
+    LLMThoughtLabeler,
+    LLMThoughtState,
+    StreamlitCallbackHandler,
+    ToolRecord,
+)
+
+__all__ = [
+    "CHECKMARK_EMOJI",
+    "THINKING_EMOJI",
+    "HISTORY_EMOJI",
+    "EXCEPTION_EMOJI",
+    "LLMThoughtState",
+    "ToolRecord",
+    "LLMThoughtLabeler",
+    "LLMThought",
+    "StreamlitCallbackHandler",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__init__.py b/llm/Lib/site-packages/langchain/callbacks/tracers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f470e6bb844ed0d31308db6f688595f5f75536f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/tracers/__init__.py
@@ -0,0 +1,20 @@
+"""Tracers that record execution of LangChain runs."""
+
+from langchain_core.tracers.langchain import LangChainTracer
+from langchain_core.tracers.langchain_v1 import LangChainTracerV1
+from langchain_core.tracers.stdout import (
+    ConsoleCallbackHandler,
+    FunctionCallbackHandler,
+)
+
+from langchain.callbacks.tracers.logging import LoggingCallbackHandler
+from langchain.callbacks.tracers.wandb import WandbTracer
+
+__all__ = [
+    "ConsoleCallbackHandler",
+    "FunctionCallbackHandler",
+    "LoggingCallbackHandler",
+    "LangChainTracer",
+    "LangChainTracerV1",
+    "WandbTracer",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..af13426435b4fecc6ca983a2fa3c0b18e4d82c1e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3e76dee8a93bbd8e00a729142003c539aeb32e91
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/comet.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/comet.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3744a9912d3c3c77b73070c8c8818f872aeb38a3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/comet.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/evaluation.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/evaluation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1362931619ab165e979bbf77bd1f07bc8307d945
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/evaluation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/langchain.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/langchain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f08616ad71eb77ef839aad18921931d0aa84f519
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/langchain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/langchain_v1.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/langchain_v1.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7b8493b9e2ff404ea79ccc3c99f3e87793b4d53d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/langchain_v1.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/log_stream.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/log_stream.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5dee36af4a660a040c78cfc5d65a15ee7e67cea5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/log_stream.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/logging.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/logging.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4b646e851f499067cf3b93b233d99567a42f4512
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/logging.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/root_listeners.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/root_listeners.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ee845f5dbb19b7bf52a1fcb7b1df4a766106adcc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/root_listeners.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/run_collector.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/run_collector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..becd1b76aaa0822479d9ca30c6ef4977cccd589e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/run_collector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/schemas.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/schemas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b656514eb3b72c65a7907a88ddc85e7656523509
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/schemas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/stdout.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/stdout.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f95b9433b96de3d3c9d6662143f886765c7ef474
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/stdout.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/wandb.cpython-311.pyc b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/wandb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..33ac69377ca2cff3bd7cf0298dc0ea66e9fad2d2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/callbacks/tracers/__pycache__/wandb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/base.py b/llm/Lib/site-packages/langchain/callbacks/tracers/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a56fa66688a3ddc92914737030fca5b1689a5f6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/tracers/base.py
@@ -0,0 +1,5 @@
+"""Base interfaces for tracing runs."""
+
+from langchain_core.tracers.base import BaseTracer, TracerException
+
+__all__ = ["BaseTracer", "TracerException"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/comet.py b/llm/Lib/site-packages/langchain/callbacks/tracers/comet.py
new file mode 100644
index 0000000000000000000000000000000000000000..a369d5b2b55e4b56bec0e170e4129cc07d34bc52
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/tracers/comet.py
@@ -0,0 +1,6 @@
+from langchain_community.callbacks.tracers.comet import (
+    CometTracer,
+    import_comet_llm_api,
+)
+
+__all__ = ["import_comet_llm_api", "CometTracer"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/evaluation.py b/llm/Lib/site-packages/langchain/callbacks/tracers/evaluation.py
new file mode 100644
index 0000000000000000000000000000000000000000..1617b825a21dc9c9f9f2114d1bcd2c676aa9bc6a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/tracers/evaluation.py
@@ -0,0 +1,7 @@
+"""A tracer that runs evaluators over completed runs."""
+from langchain_core.tracers.evaluation import (
+    EvaluatorCallbackHandler,
+    wait_for_all_evaluators,
+)
+
+__all__ = ["wait_for_all_evaluators", "EvaluatorCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/langchain.py b/llm/Lib/site-packages/langchain/callbacks/tracers/langchain.py
new file mode 100644
index 0000000000000000000000000000000000000000..54ae9dc6cdda483c2818f19044209165c0988b70
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/tracers/langchain.py
@@ -0,0 +1,8 @@
+"""A Tracer implementation that records to LangChain endpoint."""
+
+from langchain_core.tracers.langchain import (
+    LangChainTracer,
+    wait_for_all_tracers,
+)
+
+__all__ = ["LangChainTracer", "wait_for_all_tracers"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/langchain_v1.py b/llm/Lib/site-packages/langchain/callbacks/tracers/langchain_v1.py
new file mode 100644
index 0000000000000000000000000000000000000000..a12b47401f75afd2a14d1f8495cd781c5be8c637
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/tracers/langchain_v1.py
@@ -0,0 +1,3 @@
+from langchain_core.tracers.langchain_v1 import LangChainTracerV1
+
+__all__ = ["LangChainTracerV1"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/log_stream.py b/llm/Lib/site-packages/langchain/callbacks/tracers/log_stream.py
new file mode 100644
index 0000000000000000000000000000000000000000..22b33c3768d0451f6643a85831151b68c5b1dbe5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/tracers/log_stream.py
@@ -0,0 +1,9 @@
+from langchain_core.tracers.log_stream import (
+    LogEntry,
+    LogStreamCallbackHandler,
+    RunLog,
+    RunLogPatch,
+    RunState,
+)
+
+__all__ = ["LogEntry", "RunState", "RunLog", "RunLogPatch", "LogStreamCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/logging.py b/llm/Lib/site-packages/langchain/callbacks/tracers/logging.py
new file mode 100644
index 0000000000000000000000000000000000000000..f661c7be8f7f97a340e991cee8822e796752b632
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/tracers/logging.py
@@ -0,0 +1,46 @@
+__all__ = ["LoggingCallbackHandler"]
+
+import logging
+from typing import Any, Optional
+from uuid import UUID
+
+from langchain_core.exceptions import TracerException
+from langchain_core.tracers.stdout import FunctionCallbackHandler
+from langchain_core.utils.input import get_bolded_text, get_colored_text
+
+
+class LoggingCallbackHandler(FunctionCallbackHandler):
+    """Tracer that logs via the input Logger."""
+
+    name: str = "logging_callback_handler"
+
+    def __init__(
+        self,
+        logger: logging.Logger,
+        log_level: int = logging.INFO,
+        extra: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> None:
+        log_method = getattr(logger, logging.getLevelName(level=log_level).lower())
+
+        def callback(text: str) -> None:
+            log_method(text, extra=extra)
+
+        super().__init__(function=callback, **kwargs)
+
+    def on_text(
+        self,
+        text: str,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,  # noqa: ARG002
+        **kwargs: Any,  # noqa: ARG002
+    ) -> None:
+        try:
+            crumbs_str = f"[{self.get_breadcrumbs(run=self._get_run(run_id=run_id))}] "
+        except TracerException:
+            crumbs_str = ""
+        self.function_callback(
+            f'{get_colored_text("[text]", color="blue")}'
+            f' {get_bolded_text(f"{crumbs_str}New text:")}\n{text}'
+        )
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/root_listeners.py b/llm/Lib/site-packages/langchain/callbacks/tracers/root_listeners.py
new file mode 100644
index 0000000000000000000000000000000000000000..0dee9bce2d23376310af8d807599c6952da5eda7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/tracers/root_listeners.py
@@ -0,0 +1,3 @@
+from langchain_core.tracers.root_listeners import RootListenersTracer
+
+__all__ = ["RootListenersTracer"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/run_collector.py b/llm/Lib/site-packages/langchain/callbacks/tracers/run_collector.py
new file mode 100644
index 0000000000000000000000000000000000000000..1240026bfb61e3f8d431d036edd4b4024b4be838
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/tracers/run_collector.py
@@ -0,0 +1,3 @@
+from langchain_core.tracers.run_collector import RunCollectorCallbackHandler
+
+__all__ = ["RunCollectorCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/schemas.py b/llm/Lib/site-packages/langchain/callbacks/tracers/schemas.py
new file mode 100644
index 0000000000000000000000000000000000000000..e8f34027d34115c65dcf42d3e035cef2fd069737
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/tracers/schemas.py
@@ -0,0 +1,27 @@
+from langchain_core.tracers.schemas import (
+    BaseRun,
+    ChainRun,
+    LLMRun,
+    Run,
+    RunTypeEnum,
+    ToolRun,
+    TracerSession,
+    TracerSessionBase,
+    TracerSessionV1,
+    TracerSessionV1Base,
+    TracerSessionV1Create,
+)
+
+__all__ = [
+    "BaseRun",
+    "ChainRun",
+    "LLMRun",
+    "Run",
+    "RunTypeEnum",
+    "ToolRun",
+    "TracerSession",
+    "TracerSessionBase",
+    "TracerSessionV1",
+    "TracerSessionV1Base",
+    "TracerSessionV1Create",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/stdout.py b/llm/Lib/site-packages/langchain/callbacks/tracers/stdout.py
new file mode 100644
index 0000000000000000000000000000000000000000..716e2c30ba29ebb6b3543eb375c87275ae28c36b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/tracers/stdout.py
@@ -0,0 +1,6 @@
+from langchain_core.tracers.stdout import (
+    ConsoleCallbackHandler,
+    FunctionCallbackHandler,
+)
+
+__all__ = ["FunctionCallbackHandler", "ConsoleCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/tracers/wandb.py b/llm/Lib/site-packages/langchain/callbacks/tracers/wandb.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9a84e5d4a9677d6dc199af2dbd0792cab378f3c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/tracers/wandb.py
@@ -0,0 +1,13 @@
+from langchain_community.callbacks.tracers.wandb import (
+    PRINT_WARNINGS,
+    RunProcessor,
+    WandbRunArgs,
+    WandbTracer,
+)
+
+__all__ = [
+    "PRINT_WARNINGS",
+    "RunProcessor",
+    "WandbRunArgs",
+    "WandbTracer",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/trubrics_callback.py b/llm/Lib/site-packages/langchain/callbacks/trubrics_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..e4b71a970e47034b1f6e1726273bab4adfff2850
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/trubrics_callback.py
@@ -0,0 +1,5 @@
+from langchain_community.callbacks.trubrics_callback import (
+    TrubricsCallbackHandler,
+)
+
+__all__ = ["TrubricsCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/callbacks/utils.py b/llm/Lib/site-packages/langchain/callbacks/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..507944482f855f99971710106315ec3acbe60374
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/utils.py
@@ -0,0 +1,21 @@
+from langchain_community.callbacks.utils import (
+    BaseMetadataCallbackHandler,
+    _flatten_dict,
+    flatten_dict,
+    hash_string,
+    import_pandas,
+    import_spacy,
+    import_textstat,
+    load_json,
+)
+
+__all__ = [
+    "import_spacy",
+    "import_pandas",
+    "import_textstat",
+    "_flatten_dict",
+    "flatten_dict",
+    "hash_string",
+    "load_json",
+    "BaseMetadataCallbackHandler",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/wandb_callback.py b/llm/Lib/site-packages/langchain/callbacks/wandb_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..1cf9e796eee8046e38f85a590a03ac7cd537d8fd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/wandb_callback.py
@@ -0,0 +1,7 @@
+from langchain_community.callbacks.wandb_callback import (
+    WandbCallbackHandler,
+)
+
+__all__ = [
+    "WandbCallbackHandler",
+]
diff --git a/llm/Lib/site-packages/langchain/callbacks/whylabs_callback.py b/llm/Lib/site-packages/langchain/callbacks/whylabs_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..d4c3530beab40a334146c42779621ece5b8360ef
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/callbacks/whylabs_callback.py
@@ -0,0 +1,5 @@
+from langchain_community.callbacks.whylabs_callback import (
+    WhyLabsCallbackHandler,
+)
+
+__all__ = ["WhyLabsCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/chains/__init__.py b/llm/Lib/site-packages/langchain/chains/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d4dc8a40f94b77d6ac9be76d6513961b24ec8fd1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/__init__.py
@@ -0,0 +1,95 @@
+"""**Chains** are easily reusable components linked together.
+
+Chains encode a sequence of calls to components like models, document retrievers,
+other Chains, etc., and provide a simple interface to this sequence.
+
+The Chain interface makes it easy to create apps that are:
+
+    - **Stateful:** add Memory to any Chain to give it state,
+    - **Observable:** pass Callbacks to a Chain to execute additional functionality,
+      like logging, outside the main sequence of component calls,
+    - **Composable:** combine Chains with other components, including other Chains.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    Chain --> <name>Chain  # Examples: LLMChain, MapReduceChain, RouterChain
+"""
+
+import importlib
+from typing import Any
+
+_module_lookup = {
+    "APIChain": "langchain.chains.api.base",
+    "OpenAPIEndpointChain": "langchain.chains.api.openapi.chain",
+    "AnalyzeDocumentChain": "langchain.chains.combine_documents.base",
+    "MapReduceDocumentsChain": "langchain.chains.combine_documents.map_reduce",
+    "MapRerankDocumentsChain": "langchain.chains.combine_documents.map_rerank",
+    "ReduceDocumentsChain": "langchain.chains.combine_documents.reduce",
+    "RefineDocumentsChain": "langchain.chains.combine_documents.refine",
+    "StuffDocumentsChain": "langchain.chains.combine_documents.stuff",
+    "ConstitutionalChain": "langchain.chains.constitutional_ai.base",
+    "ConversationChain": "langchain.chains.conversation.base",
+    "ChatVectorDBChain": "langchain.chains.conversational_retrieval.base",
+    "ConversationalRetrievalChain": "langchain.chains.conversational_retrieval.base",
+    "generate_example": "langchain.chains.example_generator",
+    "FlareChain": "langchain.chains.flare.base",
+    "ArangoGraphQAChain": "langchain.chains.graph_qa.arangodb",
+    "GraphQAChain": "langchain.chains.graph_qa.base",
+    "GraphCypherQAChain": "langchain.chains.graph_qa.cypher",
+    "FalkorDBQAChain": "langchain.chains.graph_qa.falkordb",
+    "HugeGraphQAChain": "langchain.chains.graph_qa.hugegraph",
+    "KuzuQAChain": "langchain.chains.graph_qa.kuzu",
+    "NebulaGraphQAChain": "langchain.chains.graph_qa.nebulagraph",
+    "NeptuneOpenCypherQAChain": "langchain.chains.graph_qa.neptune_cypher",
+    "NeptuneSparqlQAChain": "langchain.chains.graph_qa.neptune_sparql",
+    "OntotextGraphDBQAChain": "langchain.chains.graph_qa.ontotext_graphdb",
+    "GraphSparqlQAChain": "langchain.chains.graph_qa.sparql",
+    "create_history_aware_retriever": "langchain.chains.history_aware_retriever",
+    "HypotheticalDocumentEmbedder": "langchain.chains.hyde.base",
+    "LLMChain": "langchain.chains.llm",
+    "LLMCheckerChain": "langchain.chains.llm_checker.base",
+    "LLMMathChain": "langchain.chains.llm_math.base",
+    "LLMRequestsChain": "langchain.chains.llm_requests",
+    "LLMSummarizationCheckerChain": "langchain.chains.llm_summarization_checker.base",
+    "load_chain": "langchain.chains.loading",
+    "MapReduceChain": "langchain.chains.mapreduce",
+    "OpenAIModerationChain": "langchain.chains.moderation",
+    "NatBotChain": "langchain.chains.natbot.base",
+    "create_citation_fuzzy_match_chain": "langchain.chains.openai_functions",
+    "create_extraction_chain": "langchain.chains.openai_functions",
+    "create_extraction_chain_pydantic": "langchain.chains.openai_functions",
+    "create_qa_with_sources_chain": "langchain.chains.openai_functions",
+    "create_qa_with_structure_chain": "langchain.chains.openai_functions",
+    "create_tagging_chain": "langchain.chains.openai_functions",
+    "create_tagging_chain_pydantic": "langchain.chains.openai_functions",
+    "QAGenerationChain": "langchain.chains.qa_generation.base",
+    "QAWithSourcesChain": "langchain.chains.qa_with_sources.base",
+    "RetrievalQAWithSourcesChain": "langchain.chains.qa_with_sources.retrieval",
+    "VectorDBQAWithSourcesChain": "langchain.chains.qa_with_sources.vector_db",
+    "create_retrieval_chain": "langchain.chains.retrieval",
+    "RetrievalQA": "langchain.chains.retrieval_qa.base",
+    "VectorDBQA": "langchain.chains.retrieval_qa.base",
+    "LLMRouterChain": "langchain.chains.router",
+    "MultiPromptChain": "langchain.chains.router",
+    "MultiRetrievalQAChain": "langchain.chains.router",
+    "MultiRouteChain": "langchain.chains.router",
+    "RouterChain": "langchain.chains.router",
+    "SequentialChain": "langchain.chains.sequential",
+    "SimpleSequentialChain": "langchain.chains.sequential",
+    "create_sql_query_chain": "langchain.chains.sql_database.query",
+    "create_structured_output_runnable": "langchain.chains.structured_output",
+    "load_summarize_chain": "langchain.chains.summarize",
+    "TransformChain": "langchain.chains.transform",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain/chains/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b971e06042412562b00fa9eac66932e2600b963f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cecbfe445d896a022396627bbd762a391565eccd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/__pycache__/example_generator.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/__pycache__/example_generator.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..901b0cc48e02528da879b161e7318be5d35ebe84
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/__pycache__/example_generator.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/__pycache__/history_aware_retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/__pycache__/history_aware_retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f460db78e46cf04fb6bb033757ea0ebf61360718
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/__pycache__/history_aware_retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/__pycache__/llm.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/__pycache__/llm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7946867c2c7e763520b4de6eaa60a59845d0865f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/__pycache__/llm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/__pycache__/llm_requests.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/__pycache__/llm_requests.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3469444be3c01ccc5b04ba7ecead9dadb3fef09e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/__pycache__/llm_requests.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/__pycache__/loading.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/__pycache__/loading.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..68d78efdc18df8539db9be914a8e62acf6131e36
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/__pycache__/loading.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/__pycache__/mapreduce.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/__pycache__/mapreduce.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..abe078cc7c28b3f30dacdbdc51d74faa80274b73
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/__pycache__/mapreduce.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/__pycache__/moderation.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/__pycache__/moderation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..190abd9b6c3c6500c19a20bfa345d770de7c6cc6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/__pycache__/moderation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/__pycache__/prompt_selector.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/__pycache__/prompt_selector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e20ada9b64b4a22e6a469e6d01a1d01480bc954c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/__pycache__/prompt_selector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/__pycache__/retrieval.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/__pycache__/retrieval.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..543ebff90043eb853243ba2f2be5e77de187664a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/__pycache__/retrieval.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/__pycache__/sequential.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/__pycache__/sequential.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5aff392eb6f9ad9ee392f048f6bf07cabf47cd40
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/__pycache__/sequential.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/__pycache__/transform.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/__pycache__/transform.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c70bd8028a642794ef34a9d9bf92f1950a4f4e06
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/__pycache__/transform.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/api/__init__.py b/llm/Lib/site-packages/langchain/chains/api/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..efe2fb36ba9a35646b59caaa6fa56f1255a7e031
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/api/__init__.py
@@ -0,0 +1 @@
+"""Chain that makes API calls and summarizes the responses to answer a question."""
diff --git a/llm/Lib/site-packages/langchain/chains/api/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/api/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5ac36bb74b880c84d6dc0d8d94f6c83dc6587c77
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/api/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/api/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/api/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..67c4753b6785183d73940f36e9c3e3f183e61467
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/api/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/api/__pycache__/news_docs.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/api/__pycache__/news_docs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b09cb7e9ebea2def74ac86072bb87f055ce48830
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/api/__pycache__/news_docs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/api/__pycache__/open_meteo_docs.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/api/__pycache__/open_meteo_docs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a5a07233a41487e8ea3a83a4803779d840718de8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/api/__pycache__/open_meteo_docs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/api/__pycache__/podcast_docs.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/api/__pycache__/podcast_docs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..37fd6031ced66d783a2d7f2ef084dab86f48b5b1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/api/__pycache__/podcast_docs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/api/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/api/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e6ceb43ca34958bd50679e89d59c86b0a0c56853
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/api/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/api/__pycache__/tmdb_docs.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/api/__pycache__/tmdb_docs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7a607b47f37a265c4ba87c591fbc3be5f832cda6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/api/__pycache__/tmdb_docs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/api/base.py b/llm/Lib/site-packages/langchain/chains/api/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..212c04845c7a6e670a1adb9f8b9e18cd54d216db
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/api/base.py
@@ -0,0 +1,238 @@
+"""Chain that makes API calls and summarizes the responses to answer a question."""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional, Sequence, Tuple
+from urllib.parse import urlparse
+
+from langchain_community.utilities.requests import TextRequestsWrapper
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+)
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field, root_validator
+
+from langchain.chains.api.prompt import API_RESPONSE_PROMPT, API_URL_PROMPT
+from langchain.chains.base import Chain
+from langchain.chains.llm import LLMChain
+
+
+def _extract_scheme_and_domain(url: str) -> Tuple[str, str]:
+    """Extract the scheme + domain from a given URL.
+
+    Args:
+        url (str): The input URL.
+
+    Returns:
+        return a 2-tuple of scheme and domain
+    """
+    parsed_uri = urlparse(url)
+    return parsed_uri.scheme, parsed_uri.netloc
+
+
+def _check_in_allowed_domain(url: str, limit_to_domains: Sequence[str]) -> bool:
+    """Check if a URL is in the allowed domains.
+
+    Args:
+        url (str): The input URL.
+        limit_to_domains (Sequence[str]): The allowed domains.
+
+    Returns:
+        bool: True if the URL is in the allowed domains, False otherwise.
+    """
+    scheme, domain = _extract_scheme_and_domain(url)
+
+    for allowed_domain in limit_to_domains:
+        allowed_scheme, allowed_domain = _extract_scheme_and_domain(allowed_domain)
+        if scheme == allowed_scheme and domain == allowed_domain:
+            return True
+    return False
+
+
+class APIChain(Chain):
+    """Chain that makes API calls and summarizes the responses to answer a question.
+
+    *Security Note*: This API chain uses the requests toolkit
+        to make GET, POST, PATCH, PUT, and DELETE requests to an API.
+
+        Exercise care in who is allowed to use this chain. If exposing
+        to end users, consider that users will be able to make arbitrary
+        requests on behalf of the server hosting the code. For example,
+        users could ask the server to make a request to a private API
+        that is only accessible from the server.
+
+        Control access to who can submit issue requests using this toolkit and
+        what network access it has.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    api_request_chain: LLMChain
+    api_answer_chain: LLMChain
+    requests_wrapper: TextRequestsWrapper = Field(exclude=True)
+    api_docs: str
+    question_key: str = "question"  #: :meta private:
+    output_key: str = "output"  #: :meta private:
+    limit_to_domains: Optional[Sequence[str]]
+    """Use to limit the domains that can be accessed by the API chain.
+    
+    * For example, to limit to just the domain `https://www.example.com`, set
+        `limit_to_domains=["https://www.example.com"]`.
+        
+    * The default value is an empty tuple, which means that no domains are
+      allowed by default. By design this will raise an error on instantiation.
+    * Use a None if you want to allow all domains by default -- this is not
+      recommended for security reasons, as it would allow malicious users to
+      make requests to arbitrary URLS including internal APIs accessible from
+      the server.
+    """
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Expect input key.
+
+        :meta private:
+        """
+        return [self.question_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Expect output key.
+
+        :meta private:
+        """
+        return [self.output_key]
+
+    @root_validator(pre=True)
+    def validate_api_request_prompt(cls, values: Dict) -> Dict:
+        """Check that api request prompt expects the right variables."""
+        input_vars = values["api_request_chain"].prompt.input_variables
+        expected_vars = {"question", "api_docs"}
+        if set(input_vars) != expected_vars:
+            raise ValueError(
+                f"Input variables should be {expected_vars}, got {input_vars}"
+            )
+        return values
+
+    @root_validator(pre=True)
+    def validate_limit_to_domains(cls, values: Dict) -> Dict:
+        """Check that allowed domains are valid."""
+        if "limit_to_domains" not in values:
+            raise ValueError(
+                "You must specify a list of domains to limit access using "
+                "`limit_to_domains`"
+            )
+        if not values["limit_to_domains"] and values["limit_to_domains"] is not None:
+            raise ValueError(
+                "Please provide a list of domains to limit access using "
+                "`limit_to_domains`."
+            )
+        return values
+
+    @root_validator(pre=True)
+    def validate_api_answer_prompt(cls, values: Dict) -> Dict:
+        """Check that api answer prompt expects the right variables."""
+        input_vars = values["api_answer_chain"].prompt.input_variables
+        expected_vars = {"question", "api_docs", "api_url", "api_response"}
+        if set(input_vars) != expected_vars:
+            raise ValueError(
+                f"Input variables should be {expected_vars}, got {input_vars}"
+            )
+        return values
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        question = inputs[self.question_key]
+        api_url = self.api_request_chain.predict(
+            question=question,
+            api_docs=self.api_docs,
+            callbacks=_run_manager.get_child(),
+        )
+        _run_manager.on_text(api_url, color="green", end="\n", verbose=self.verbose)
+        api_url = api_url.strip()
+        if self.limit_to_domains and not _check_in_allowed_domain(
+            api_url, self.limit_to_domains
+        ):
+            raise ValueError(
+                f"{api_url} is not in the allowed domains: {self.limit_to_domains}"
+            )
+        api_response = self.requests_wrapper.get(api_url)
+        _run_manager.on_text(
+            str(api_response), color="yellow", end="\n", verbose=self.verbose
+        )
+        answer = self.api_answer_chain.predict(
+            question=question,
+            api_docs=self.api_docs,
+            api_url=api_url,
+            api_response=api_response,
+            callbacks=_run_manager.get_child(),
+        )
+        return {self.output_key: answer}
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        _run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()
+        question = inputs[self.question_key]
+        api_url = await self.api_request_chain.apredict(
+            question=question,
+            api_docs=self.api_docs,
+            callbacks=_run_manager.get_child(),
+        )
+        await _run_manager.on_text(
+            api_url, color="green", end="\n", verbose=self.verbose
+        )
+        api_url = api_url.strip()
+        if self.limit_to_domains and not _check_in_allowed_domain(
+            api_url, self.limit_to_domains
+        ):
+            raise ValueError(
+                f"{api_url} is not in the allowed domains: {self.limit_to_domains}"
+            )
+        api_response = await self.requests_wrapper.aget(api_url)
+        await _run_manager.on_text(
+            str(api_response), color="yellow", end="\n", verbose=self.verbose
+        )
+        answer = await self.api_answer_chain.apredict(
+            question=question,
+            api_docs=self.api_docs,
+            api_url=api_url,
+            api_response=api_response,
+            callbacks=_run_manager.get_child(),
+        )
+        return {self.output_key: answer}
+
+    @classmethod
+    def from_llm_and_api_docs(
+        cls,
+        llm: BaseLanguageModel,
+        api_docs: str,
+        headers: Optional[dict] = None,
+        api_url_prompt: BasePromptTemplate = API_URL_PROMPT,
+        api_response_prompt: BasePromptTemplate = API_RESPONSE_PROMPT,
+        limit_to_domains: Optional[Sequence[str]] = tuple(),
+        **kwargs: Any,
+    ) -> APIChain:
+        """Load chain from just an LLM and the api docs."""
+        get_request_chain = LLMChain(llm=llm, prompt=api_url_prompt)
+        requests_wrapper = TextRequestsWrapper(headers=headers)
+        get_answer_chain = LLMChain(llm=llm, prompt=api_response_prompt)
+        return cls(
+            api_request_chain=get_request_chain,
+            api_answer_chain=get_answer_chain,
+            requests_wrapper=requests_wrapper,
+            api_docs=api_docs,
+            limit_to_domains=limit_to_domains,
+            **kwargs,
+        )
+
+    @property
+    def _chain_type(self) -> str:
+        return "api_chain"
diff --git a/llm/Lib/site-packages/langchain/chains/api/news_docs.py b/llm/Lib/site-packages/langchain/chains/api/news_docs.py
new file mode 100644
index 0000000000000000000000000000000000000000..b29f16c10dbcc4bc38549545cab9a7ed962c4acf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/api/news_docs.py
@@ -0,0 +1,32 @@
+# flake8: noqa
+NEWS_DOCS = """API documentation:
+Endpoint: https://newsapi.org
+Top headlines /v2/top-headlines
+
+This endpoint provides live top and breaking headlines for a country, specific category in a country, single source, or multiple sources. You can also search with keywords. Articles are sorted by the earliest date published first.
+
+This endpoint is great for retrieving headlines for use with news tickers or similar.
+Request parameters
+
+    country | The 2-letter ISO 3166-1 code of the country you want to get headlines for. Possible options: ae ar at au be bg br ca ch cn co cu cz de eg fr gb gr hk hu id ie il in it jp kr lt lv ma mx my ng nl no nz ph pl pt ro rs ru sa se sg si sk th tr tw ua us ve za. Note: you can't mix this param with the sources param.
+    category | The category you want to get headlines for. Possible options: business entertainment general health science sports technology. Note: you can't mix this param with the sources param.
+    sources | A comma-separated string of identifiers for the news sources or blogs you want headlines from. Use the /top-headlines/sources endpoint to locate these programmatically or look at the sources index. Note: you can't mix this param with the country or category params.
+    q | Keywords or a phrase to search for.
+    pageSize | int | The number of results to return per page (request). 20 is the default, 100 is the maximum.
+    page | int | Use this to page through the results if the total results found is greater than the page size.
+
+Response object
+    status | string | If the request was successful or not. Options: ok, error. In the case of error a code and message property will be populated.
+    totalResults | int | The total number of results available for your request.
+    articles | array[article] | The results of the request.
+    source | object | The identifier id and a display name name for the source this article came from.
+    author | string | The author of the article
+    title | string | The headline or title of the article.
+    description | string | A description or snippet from the article.
+    url | string | The direct URL to the article.
+    urlToImage | string | The URL to a relevant image for the article.
+    publishedAt | string | The date and time that the article was published, in UTC (+000)
+    content | string | The unformatted content of the article, where available. This is truncated to 200 chars.
+
+Use page size: 2
+"""
diff --git a/llm/Lib/site-packages/langchain/chains/api/open_meteo_docs.py b/llm/Lib/site-packages/langchain/chains/api/open_meteo_docs.py
new file mode 100644
index 0000000000000000000000000000000000000000..4abd86fb83a5a038593cb13855347194e59f2bab
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/api/open_meteo_docs.py
@@ -0,0 +1,33 @@
+# flake8: noqa
+OPEN_METEO_DOCS = """BASE URL: https://api.open-meteo.com/
+
+API Documentation
+The API endpoint /v1/forecast accepts a geographical coordinate, a list of weather variables and responds with a JSON hourly weather forecast for 7 days. Time always starts at 0:00 today and contains 168 hours. All URL parameters are listed below:
+
+Parameter	Format	Required	Default	Description
+latitude, longitude	Floating point	Yes		Geographical WGS84 coordinate of the location
+hourly	String array	No		A list of weather variables which should be returned. Values can be comma separated, or multiple &hourly= parameter in the URL can be used.
+daily	String array	No		A list of daily weather variable aggregations which should be returned. Values can be comma separated, or multiple &daily= parameter in the URL can be used. If daily weather variables are specified, parameter timezone is required.
+current_weather	Bool	No	false	Include current weather conditions in the JSON output.
+temperature_unit	String	No	celsius	If fahrenheit is set, all temperature values are converted to Fahrenheit.
+windspeed_unit	String	No	kmh	Other wind speed speed units: ms, mph and kn
+precipitation_unit	String	No	mm	Other precipitation amount units: inch
+timeformat	String	No	iso8601	If format unixtime is selected, all time values are returned in UNIX epoch time in seconds. Please note that all timestamp are in GMT+0! For daily values with unix timestamps, please apply utc_offset_seconds again to get the correct date.
+timezone	String	No	GMT	If timezone is set, all timestamps are returned as local-time and data is returned starting at 00:00 local-time. Any time zone name from the time zone database is supported. If auto is set as a time zone, the coordinates will be automatically resolved to the local time zone.
+past_days	Integer (0-2)	No	0	If past_days is set, yesterday or the day before yesterday data are also returned.
+start_date
+end_date	String (yyyy-mm-dd)	No		The time interval to get weather data. A day must be specified as an ISO8601 date (e.g. 2022-06-30).
+models	String array	No	auto	Manually select one or more weather models. Per default, the best suitable weather models will be combined.
+
+Hourly Parameter Definition
+The parameter &hourly= accepts the following values. Most weather variables are given as an instantaneous value for the indicated hour. Some variables like precipitation are calculated from the preceding hour as an average or sum.
+
+Variable	Valid time	Unit	Description
+temperature_2m	Instant	°C (°F)	Air temperature at 2 meters above ground
+snowfall	Preceding hour sum	cm (inch)	Snowfall amount of the preceding hour in centimeters. For the water equivalent in millimeter, divide by 7. E.g. 7 cm snow = 10 mm precipitation water equivalent
+rain	Preceding hour sum	mm (inch)	Rain from large scale weather systems of the preceding hour in millimeter
+showers	Preceding hour sum	mm (inch)	Showers from convective precipitation in millimeters from the preceding hour
+weathercode	Instant	WMO code	Weather condition as a numeric code. Follow WMO weather interpretation codes. See table below for details.
+snow_depth	Instant	meters	Snow depth on the ground
+freezinglevel_height	Instant	meters	Altitude above sea level of the 0°C level
+visibility	Instant	meters	Viewing distance in meters. Influenced by low clouds, humidity and aerosols. Maximum visibility is approximately 24 km."""
diff --git a/llm/Lib/site-packages/langchain/chains/api/openapi/__init__.py b/llm/Lib/site-packages/langchain/chains/api/openapi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..44c0798af7b017459f5bb4c8c1f196a9cca95bc7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/chain.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/chain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8c409eca6fc45af8ac3d2888c84ac73ccfa59c76
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/chain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/prompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/prompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cf153d97b74f985df1cce64b5057641a4d6c0861
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/prompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/requests_chain.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/requests_chain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e5b8a7a8ad497126ee472e54e3fcdd0af5765ce4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/requests_chain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/response_chain.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/response_chain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b13086a8e496e0602a1e5b92efc5eed6459100b7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/api/openapi/__pycache__/response_chain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/api/openapi/chain.py b/llm/Lib/site-packages/langchain/chains/api/openapi/chain.py
new file mode 100644
index 0000000000000000000000000000000000000000..7fad47fedd8b3f8f757434d71e4fba1de53cbaea
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/api/openapi/chain.py
@@ -0,0 +1,229 @@
+"""Chain that makes API calls and summarizes the responses to answer a question."""
+from __future__ import annotations
+
+import json
+from typing import Any, Dict, List, NamedTuple, Optional, cast
+
+from langchain_community.tools.openapi.utils.api_models import APIOperation
+from langchain_community.utilities.requests import Requests
+from langchain_core.callbacks import CallbackManagerForChainRun, Callbacks
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.pydantic_v1 import BaseModel, Field
+from requests import Response
+
+from langchain.chains.api.openapi.requests_chain import APIRequesterChain
+from langchain.chains.api.openapi.response_chain import APIResponderChain
+from langchain.chains.base import Chain
+from langchain.chains.llm import LLMChain
+
+
+class _ParamMapping(NamedTuple):
+    """Mapping from parameter name to parameter value."""
+
+    query_params: List[str]
+    body_params: List[str]
+    path_params: List[str]
+
+
+class OpenAPIEndpointChain(Chain, BaseModel):
+    """Chain interacts with an OpenAPI endpoint using natural language."""
+
+    api_request_chain: LLMChain
+    api_response_chain: Optional[LLMChain]
+    api_operation: APIOperation
+    requests: Requests = Field(exclude=True, default_factory=Requests)
+    param_mapping: _ParamMapping = Field(alias="param_mapping")
+    return_intermediate_steps: bool = False
+    instructions_key: str = "instructions"  #: :meta private:
+    output_key: str = "output"  #: :meta private:
+    max_text_length: Optional[int] = Field(ge=0)  #: :meta private:
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Expect input key.
+
+        :meta private:
+        """
+        return [self.instructions_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Expect output key.
+
+        :meta private:
+        """
+        if not self.return_intermediate_steps:
+            return [self.output_key]
+        else:
+            return [self.output_key, "intermediate_steps"]
+
+    def _construct_path(self, args: Dict[str, str]) -> str:
+        """Construct the path from the deserialized input."""
+        path = self.api_operation.base_url + self.api_operation.path
+        for param in self.param_mapping.path_params:
+            path = path.replace(f"{{{param}}}", str(args.pop(param, "")))
+        return path
+
+    def _extract_query_params(self, args: Dict[str, str]) -> Dict[str, str]:
+        """Extract the query params from the deserialized input."""
+        query_params = {}
+        for param in self.param_mapping.query_params:
+            if param in args:
+                query_params[param] = args.pop(param)
+        return query_params
+
+    def _extract_body_params(self, args: Dict[str, str]) -> Optional[Dict[str, str]]:
+        """Extract the request body params from the deserialized input."""
+        body_params = None
+        if self.param_mapping.body_params:
+            body_params = {}
+            for param in self.param_mapping.body_params:
+                if param in args:
+                    body_params[param] = args.pop(param)
+        return body_params
+
+    def deserialize_json_input(self, serialized_args: str) -> dict:
+        """Use the serialized typescript dictionary.
+
+        Resolve the path, query params dict, and optional requestBody dict.
+        """
+        args: dict = json.loads(serialized_args)
+        path = self._construct_path(args)
+        body_params = self._extract_body_params(args)
+        query_params = self._extract_query_params(args)
+        return {
+            "url": path,
+            "data": body_params,
+            "params": query_params,
+        }
+
+    def _get_output(self, output: str, intermediate_steps: dict) -> dict:
+        """Return the output from the API call."""
+        if self.return_intermediate_steps:
+            return {
+                self.output_key: output,
+                "intermediate_steps": intermediate_steps,
+            }
+        else:
+            return {self.output_key: output}
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        intermediate_steps = {}
+        instructions = inputs[self.instructions_key]
+        instructions = instructions[: self.max_text_length]
+        _api_arguments = self.api_request_chain.predict_and_parse(
+            instructions=instructions, callbacks=_run_manager.get_child()
+        )
+        api_arguments = cast(str, _api_arguments)
+        intermediate_steps["request_args"] = api_arguments
+        _run_manager.on_text(
+            api_arguments, color="green", end="\n", verbose=self.verbose
+        )
+        if api_arguments.startswith("ERROR"):
+            return self._get_output(api_arguments, intermediate_steps)
+        elif api_arguments.startswith("MESSAGE:"):
+            return self._get_output(
+                api_arguments[len("MESSAGE:") :], intermediate_steps
+            )
+        try:
+            request_args = self.deserialize_json_input(api_arguments)
+            method = getattr(self.requests, self.api_operation.method.value)
+            api_response: Response = method(**request_args)
+            if api_response.status_code != 200:
+                method_str = str(self.api_operation.method.value)
+                response_text = (
+                    f"{api_response.status_code}: {api_response.reason}"
+                    + f"\nFor {method_str.upper()}  {request_args['url']}\n"
+                    + f"Called with args: {request_args['params']}"
+                )
+            else:
+                response_text = api_response.text
+        except Exception as e:
+            response_text = f"Error with message {str(e)}"
+        response_text = response_text[: self.max_text_length]
+        intermediate_steps["response_text"] = response_text
+        _run_manager.on_text(
+            response_text, color="blue", end="\n", verbose=self.verbose
+        )
+        if self.api_response_chain is not None:
+            _answer = self.api_response_chain.predict_and_parse(
+                response=response_text,
+                instructions=instructions,
+                callbacks=_run_manager.get_child(),
+            )
+            answer = cast(str, _answer)
+            _run_manager.on_text(answer, color="yellow", end="\n", verbose=self.verbose)
+            return self._get_output(answer, intermediate_steps)
+        else:
+            return self._get_output(response_text, intermediate_steps)
+
+    @classmethod
+    def from_url_and_method(
+        cls,
+        spec_url: str,
+        path: str,
+        method: str,
+        llm: BaseLanguageModel,
+        requests: Optional[Requests] = None,
+        return_intermediate_steps: bool = False,
+        **kwargs: Any,
+        # TODO: Handle async
+    ) -> "OpenAPIEndpointChain":
+        """Create an OpenAPIEndpoint from a spec at the specified url."""
+        operation = APIOperation.from_openapi_url(spec_url, path, method)
+        return cls.from_api_operation(
+            operation,
+            requests=requests,
+            llm=llm,
+            return_intermediate_steps=return_intermediate_steps,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_api_operation(
+        cls,
+        operation: APIOperation,
+        llm: BaseLanguageModel,
+        requests: Optional[Requests] = None,
+        verbose: bool = False,
+        return_intermediate_steps: bool = False,
+        raw_response: bool = False,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+        # TODO: Handle async
+    ) -> "OpenAPIEndpointChain":
+        """Create an OpenAPIEndpointChain from an operation and a spec."""
+        param_mapping = _ParamMapping(
+            query_params=operation.query_params,
+            body_params=operation.body_params,
+            path_params=operation.path_params,
+        )
+        requests_chain = APIRequesterChain.from_llm_and_typescript(
+            llm,
+            typescript_definition=operation.to_typescript(),
+            verbose=verbose,
+            callbacks=callbacks,
+        )
+        if raw_response:
+            response_chain = None
+        else:
+            response_chain = APIResponderChain.from_llm(
+                llm, verbose=verbose, callbacks=callbacks
+            )
+        _requests = requests or Requests()
+        return cls(
+            api_request_chain=requests_chain,
+            api_response_chain=response_chain,
+            api_operation=operation,
+            requests=_requests,
+            param_mapping=param_mapping,
+            verbose=verbose,
+            return_intermediate_steps=return_intermediate_steps,
+            callbacks=callbacks,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/chains/api/openapi/prompts.py b/llm/Lib/site-packages/langchain/chains/api/openapi/prompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..84e5a2baee986bf3dc69d708bebe5c7e8a522ceb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/api/openapi/prompts.py
@@ -0,0 +1,57 @@
+# flake8: noqa
+REQUEST_TEMPLATE = """You are a helpful AI Assistant. Please provide JSON arguments to agentFunc() based on the user's instructions.
+
+API_SCHEMA: ```typescript
+{schema}
+```
+
+USER_INSTRUCTIONS: "{instructions}"
+
+Your arguments must be plain json provided in a markdown block:
+
+ARGS: ```json
+{{valid json conforming to API_SCHEMA}}
+```
+
+Example
+-----
+
+ARGS: ```json
+{{"foo": "bar", "baz": {{"qux": "quux"}}}}
+```
+
+The block must be no more than 1 line long, and all arguments must be valid JSON. All string arguments must be wrapped in double quotes.
+You MUST strictly comply to the types indicated by the provided schema, including all required args.
+
+If you don't have sufficient information to call the function due to things like requiring specific uuid's, you can reply with the following message:
+
+Message: ```text
+Concise response requesting the additional information that would make calling the function successful.
+```
+
+Begin
+-----
+ARGS:
+"""
+RESPONSE_TEMPLATE = """You are a helpful AI assistant trained to answer user queries from API responses.
+You attempted to call an API, which resulted in:
+API_RESPONSE: {response}
+
+USER_COMMENT: "{instructions}"
+
+
+If the API_RESPONSE can answer the USER_COMMENT respond with the following markdown json block:
+Response: ```json
+{{"response": "Human-understandable synthesis of the API_RESPONSE"}}
+```
+
+Otherwise respond with the following markdown json block:
+Response Error: ```json
+{{"response": "What you did and a concise statement of the resulting error. If it can be easily fixed, provide a suggestion."}}
+```
+
+You MUST respond as a markdown json code block. The person you are responding to CANNOT see the API_RESPONSE, so if there is any relevant information there you must include it in your response.
+
+Begin:
+---
+"""
diff --git a/llm/Lib/site-packages/langchain/chains/api/openapi/requests_chain.py b/llm/Lib/site-packages/langchain/chains/api/openapi/requests_chain.py
new file mode 100644
index 0000000000000000000000000000000000000000..cca19165ee2e35a33f245d66766969539720654e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/api/openapi/requests_chain.py
@@ -0,0 +1,63 @@
+"""request parser."""
+
+import json
+import re
+from typing import Any
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompts.prompt import PromptTemplate
+
+from langchain.chains.api.openapi.prompts import REQUEST_TEMPLATE
+from langchain.chains.llm import LLMChain
+
+
+class APIRequesterOutputParser(BaseOutputParser):
+    """Parse the request and error tags."""
+
+    def _load_json_block(self, serialized_block: str) -> str:
+        try:
+            return json.dumps(json.loads(serialized_block, strict=False))
+        except json.JSONDecodeError:
+            return "ERROR serializing request."
+
+    def parse(self, llm_output: str) -> str:
+        """Parse the request and error tags."""
+
+        json_match = re.search(r"```json(.*?)```", llm_output, re.DOTALL)
+        if json_match:
+            return self._load_json_block(json_match.group(1).strip())
+        message_match = re.search(r"```text(.*?)```", llm_output, re.DOTALL)
+        if message_match:
+            return f"MESSAGE: {message_match.group(1).strip()}"
+        return "ERROR making request"
+
+    @property
+    def _type(self) -> str:
+        return "api_requester"
+
+
+class APIRequesterChain(LLMChain):
+    """Get the request parser."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @classmethod
+    def from_llm_and_typescript(
+        cls,
+        llm: BaseLanguageModel,
+        typescript_definition: str,
+        verbose: bool = True,
+        **kwargs: Any,
+    ) -> LLMChain:
+        """Get the request parser."""
+        output_parser = APIRequesterOutputParser()
+        prompt = PromptTemplate(
+            template=REQUEST_TEMPLATE,
+            output_parser=output_parser,
+            partial_variables={"schema": typescript_definition},
+            input_variables=["instructions"],
+        )
+        return cls(prompt=prompt, llm=llm, verbose=verbose, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/chains/api/openapi/response_chain.py b/llm/Lib/site-packages/langchain/chains/api/openapi/response_chain.py
new file mode 100644
index 0000000000000000000000000000000000000000..06e7686b4a3793111d363ce329961338e78c65f9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/api/openapi/response_chain.py
@@ -0,0 +1,58 @@
+"""Response parser."""
+
+import json
+import re
+from typing import Any
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompts.prompt import PromptTemplate
+
+from langchain.chains.api.openapi.prompts import RESPONSE_TEMPLATE
+from langchain.chains.llm import LLMChain
+
+
+class APIResponderOutputParser(BaseOutputParser):
+    """Parse the response and error tags."""
+
+    def _load_json_block(self, serialized_block: str) -> str:
+        try:
+            response_content = json.loads(serialized_block, strict=False)
+            return response_content.get("response", "ERROR parsing response.")
+        except json.JSONDecodeError:
+            return "ERROR parsing response."
+        except:
+            raise
+
+    def parse(self, llm_output: str) -> str:
+        """Parse the response and error tags."""
+        json_match = re.search(r"```json(.*?)```", llm_output, re.DOTALL)
+        if json_match:
+            return self._load_json_block(json_match.group(1).strip())
+        else:
+            raise ValueError(f"No response found in output: {llm_output}.")
+
+    @property
+    def _type(self) -> str:
+        return "api_responder"
+
+
+class APIResponderChain(LLMChain):
+    """Get the response parser."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @classmethod
+    def from_llm(
+        cls, llm: BaseLanguageModel, verbose: bool = True, **kwargs: Any
+    ) -> LLMChain:
+        """Get the response parser."""
+        output_parser = APIResponderOutputParser()
+        prompt = PromptTemplate(
+            template=RESPONSE_TEMPLATE,
+            output_parser=output_parser,
+            input_variables=["response", "instructions"],
+        )
+        return cls(prompt=prompt, llm=llm, verbose=verbose, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/chains/api/podcast_docs.py b/llm/Lib/site-packages/langchain/chains/api/podcast_docs.py
new file mode 100644
index 0000000000000000000000000000000000000000..9c4e5cbf827ff4264089a2b361bff1439d2df631
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/api/podcast_docs.py
@@ -0,0 +1,28 @@
+# flake8: noqa
+PODCAST_DOCS = """API documentation:
+Endpoint: https://listen-api.listennotes.com/api/v2
+GET /search
+
+This API is for searching podcasts or episodes.
+
+Query parameters table:
+q | string | Search term, e.g., person, place, topic... You can use double quotes to do verbatim match, e.g., "game of thrones". Otherwise, it's fuzzy search. | required
+type | string | What type of contents do you want to search for? Available values: episode, podcast, curated. default: episode | optional
+page_size | integer | The maximum number of search results per page. A valid value should be an integer between 1 and 10 (inclusive). default: 3 | optional
+language | string | Limit search results to a specific language, e.g., English, Chinese ... If not specified, it'll be any language. It works only when type is episode or podcast. | optional
+region | string | Limit search results to a specific region (e.g., us, gb, in...). If not specified, it'll be any region. It works only when type is episode or podcast. | optional
+len_min | integer | Minimum audio length in minutes. Applicable only when type parameter is episode or podcast. If type parameter is episode, it's for audio length of an episode. If type parameter is podcast, it's for average audio length of all episodes in a podcast. | optional
+len_max | integer | Maximum audio length in minutes. Applicable only when type parameter is episode or podcast. If type parameter is episode, it's for audio length of an episode. If type parameter is podcast, it's for average audio length of all episodes in a podcast. | optional
+
+Response schema (JSON object):
+next_offset | integer | optional
+total | integer | optional
+results | array[object] (Episode / Podcast List Result Object)
+
+Each object in the "results" key has the following schema:
+listennotes_url | string | optional
+id | integer | optional
+title_highlighted | string | optional
+
+Use page_size: 3
+"""
diff --git a/llm/Lib/site-packages/langchain/chains/api/prompt.py b/llm/Lib/site-packages/langchain/chains/api/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..0ffc389ad3d062a3a38d998a9baf4b26c863869f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/api/prompt.py
@@ -0,0 +1,36 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+API_URL_PROMPT_TEMPLATE = """You are given the below API Documentation:
+{api_docs}
+Using this documentation, generate the full API url to call for answering the user question.
+You should build the API url in order to get a response that is as short as possible, while still getting the necessary information to answer the question. Pay attention to deliberately exclude any unnecessary pieces of data in the API call.
+
+Question:{question}
+API url:"""
+
+API_URL_PROMPT = PromptTemplate(
+    input_variables=[
+        "api_docs",
+        "question",
+    ],
+    template=API_URL_PROMPT_TEMPLATE,
+)
+
+API_RESPONSE_PROMPT_TEMPLATE = (
+    API_URL_PROMPT_TEMPLATE
+    + """ {api_url}
+
+Here is the response from the API:
+
+{api_response}
+
+Summarize this response to answer the original question.
+
+Summary:"""
+)
+
+API_RESPONSE_PROMPT = PromptTemplate(
+    input_variables=["api_docs", "question", "api_url", "api_response"],
+    template=API_RESPONSE_PROMPT_TEMPLATE,
+)
diff --git a/llm/Lib/site-packages/langchain/chains/api/tmdb_docs.py b/llm/Lib/site-packages/langchain/chains/api/tmdb_docs.py
new file mode 100644
index 0000000000000000000000000000000000000000..4634a80ae0bab0017d2eecb5a3caa56f9a448890
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/api/tmdb_docs.py
@@ -0,0 +1,37 @@
+# flake8: noqa
+TMDB_DOCS = """API documentation:
+Endpoint: https://api.themoviedb.org/3
+GET /search/movie
+
+This API is for searching movies.
+
+Query parameters table:
+language | string | Pass a ISO 639-1 value to display translated data for the fields that support it. minLength: 2, pattern: ([a-z]{2})-([A-Z]{2}), default: en-US | optional
+query | string | Pass a text query to search. This value should be URI encoded. minLength: 1 | required
+page | integer | Specify which page to query. minimum: 1, maximum: 1000, default: 1 | optional
+include_adult | boolean | Choose whether to include adult (pornography) content in the results. default | optional
+region | string | Specify a ISO 3166-1 code to filter release dates. Must be uppercase. pattern: ^[A-Z]{2}$ | optional
+year | integer  | optional
+primary_release_year | integer | optional
+
+Response schema (JSON object):
+page | integer | optional
+total_results | integer | optional
+total_pages | integer | optional
+results | array[object] (Movie List Result Object)
+
+Each object in the "results" key has the following schema:
+poster_path | string or null | optional
+adult | boolean | optional
+overview | string | optional
+release_date | string | optional
+genre_ids | array[integer] | optional
+id | integer | optional
+original_title | string | optional
+original_language | string | optional
+title | string | optional
+backdrop_path | string or null | optional
+popularity | number | optional
+vote_count | integer | optional
+video | boolean | optional
+vote_average | number | optional"""
diff --git a/llm/Lib/site-packages/langchain/chains/base.py b/llm/Lib/site-packages/langchain/chains/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..aab2891b67eb4ef935ed40549e2838ae2a62e0d0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/base.py
@@ -0,0 +1,732 @@
+"""Base interface that all chains should implement."""
+import inspect
+import json
+import logging
+import warnings
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Type, Union, cast
+
+import yaml
+from langchain_core._api import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManager,
+    AsyncCallbackManagerForChainRun,
+    BaseCallbackManager,
+    CallbackManager,
+    CallbackManagerForChainRun,
+    Callbacks,
+)
+from langchain_core.load.dump import dumpd
+from langchain_core.memory import BaseMemory
+from langchain_core.outputs import RunInfo
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator, validator
+from langchain_core.runnables import (
+    RunnableConfig,
+    RunnableSerializable,
+    ensure_config,
+    run_in_executor,
+)
+from langchain_core.runnables.utils import create_model
+
+from langchain.schema import RUN_KEY
+
+logger = logging.getLogger(__name__)
+
+
+def _get_verbosity() -> bool:
+    from langchain.globals import get_verbose
+
+    return get_verbose()
+
+
+class Chain(RunnableSerializable[Dict[str, Any], Dict[str, Any]], ABC):
+    """Abstract base class for creating structured sequences of calls to components.
+
+    Chains should be used to encode a sequence of calls to components like
+    models, document retrievers, other chains, etc., and provide a simple interface
+    to this sequence.
+
+    The Chain interface makes it easy to create apps that are:
+        - Stateful: add Memory to any Chain to give it state,
+        - Observable: pass Callbacks to a Chain to execute additional functionality,
+            like logging, outside the main sequence of component calls,
+        - Composable: the Chain API is flexible enough that it is easy to combine
+            Chains with other components, including other Chains.
+
+    The main methods exposed by chains are:
+        - `__call__`: Chains are callable. The `__call__` method is the primary way to
+            execute a Chain. This takes inputs as a dictionary and returns a
+            dictionary output.
+        - `run`: A convenience method that takes inputs as args/kwargs and returns the
+            output as a string or object. This method can only be used for a subset of
+            chains and cannot return as rich of an output as `__call__`.
+    """
+
+    memory: Optional[BaseMemory] = None
+    """Optional memory object. Defaults to None.
+    Memory is a class that gets called at the start
+    and at the end of every chain. At the start, memory loads variables and passes
+    them along in the chain. At the end, it saves any returned variables.
+    There are many different types of memory - please see memory docs
+    for the full catalog."""
+    callbacks: Callbacks = Field(default=None, exclude=True)
+    """Optional list of callback handlers (or callback manager). Defaults to None.
+    Callback handlers are called throughout the lifecycle of a call to a chain,
+    starting with on_chain_start, ending with on_chain_end or on_chain_error.
+    Each custom chain can optionally call additional callback methods, see Callback docs
+    for full details."""
+    verbose: bool = Field(default_factory=_get_verbosity)
+    """Whether or not run in verbose mode. In verbose mode, some intermediate logs
+    will be printed to the console. Defaults to the global `verbose` value,
+    accessible via `langchain.globals.get_verbose()`."""
+    tags: Optional[List[str]] = None
+    """Optional list of tags associated with the chain. Defaults to None.
+    These tags will be associated with each call to this chain,
+    and passed as arguments to the handlers defined in `callbacks`.
+    You can use these to eg identify a specific instance of a chain with its use case.
+    """
+    metadata: Optional[Dict[str, Any]] = None
+    """Optional metadata associated with the chain. Defaults to None.
+    This metadata will be associated with each call to this chain,
+    and passed as arguments to the handlers defined in `callbacks`.
+    You can use these to eg identify a specific instance of a chain with its use case.
+    """
+    callback_manager: Optional[BaseCallbackManager] = Field(default=None, exclude=True)
+    """[DEPRECATED] Use `callbacks` instead."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        # This is correct, but pydantic typings/mypy don't think so.
+        return create_model(  # type: ignore[call-overload]
+            "ChainInput", **{k: (Any, None) for k in self.input_keys}
+        )
+
+    def get_output_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        # This is correct, but pydantic typings/mypy don't think so.
+        return create_model(  # type: ignore[call-overload]
+            "ChainOutput", **{k: (Any, None) for k in self.output_keys}
+        )
+
+    def invoke(
+        self,
+        input: Dict[str, Any],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        config = ensure_config(config)
+        callbacks = config.get("callbacks")
+        tags = config.get("tags")
+        metadata = config.get("metadata")
+        run_name = config.get("run_name") or self.get_name()
+        include_run_info = kwargs.get("include_run_info", False)
+        return_only_outputs = kwargs.get("return_only_outputs", False)
+
+        inputs = self.prep_inputs(input)
+        callback_manager = CallbackManager.configure(
+            callbacks,
+            self.callbacks,
+            self.verbose,
+            tags,
+            self.tags,
+            metadata,
+            self.metadata,
+        )
+        new_arg_supported = inspect.signature(self._call).parameters.get("run_manager")
+
+        run_manager = callback_manager.on_chain_start(
+            dumpd(self),
+            inputs,
+            name=run_name,
+        )
+        try:
+            self._validate_inputs(inputs)
+            outputs = (
+                self._call(inputs, run_manager=run_manager)
+                if new_arg_supported
+                else self._call(inputs)
+            )
+
+            final_outputs: Dict[str, Any] = self.prep_outputs(
+                inputs, outputs, return_only_outputs
+            )
+        except BaseException as e:
+            run_manager.on_chain_error(e)
+            raise e
+        run_manager.on_chain_end(outputs)
+
+        if include_run_info:
+            final_outputs[RUN_KEY] = RunInfo(run_id=run_manager.run_id)
+        return final_outputs
+
+    async def ainvoke(
+        self,
+        input: Dict[str, Any],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        config = ensure_config(config)
+        callbacks = config.get("callbacks")
+        tags = config.get("tags")
+        metadata = config.get("metadata")
+        run_name = config.get("run_name") or self.get_name()
+        include_run_info = kwargs.get("include_run_info", False)
+        return_only_outputs = kwargs.get("return_only_outputs", False)
+
+        inputs = await self.aprep_inputs(input)
+        callback_manager = AsyncCallbackManager.configure(
+            callbacks,
+            self.callbacks,
+            self.verbose,
+            tags,
+            self.tags,
+            metadata,
+            self.metadata,
+        )
+        new_arg_supported = inspect.signature(self._acall).parameters.get("run_manager")
+        run_manager = await callback_manager.on_chain_start(
+            dumpd(self),
+            inputs,
+            name=run_name,
+        )
+        try:
+            self._validate_inputs(inputs)
+            outputs = (
+                await self._acall(inputs, run_manager=run_manager)
+                if new_arg_supported
+                else await self._acall(inputs)
+            )
+            final_outputs: Dict[str, Any] = self.prep_outputs(
+                inputs, outputs, return_only_outputs
+            )
+        except BaseException as e:
+            await run_manager.on_chain_error(e)
+            raise e
+        await run_manager.on_chain_end(outputs)
+
+        if include_run_info:
+            final_outputs[RUN_KEY] = RunInfo(run_id=run_manager.run_id)
+        return final_outputs
+
+    @property
+    def _chain_type(self) -> str:
+        raise NotImplementedError("Saving not supported for this chain type.")
+
+    @root_validator()
+    def raise_callback_manager_deprecation(cls, values: Dict) -> Dict:
+        """Raise deprecation warning if callback_manager is used."""
+        if values.get("callback_manager") is not None:
+            if values.get("callbacks") is not None:
+                raise ValueError(
+                    "Cannot specify both callback_manager and callbacks. "
+                    "callback_manager is deprecated, callbacks is the preferred "
+                    "parameter to pass in."
+                )
+            warnings.warn(
+                "callback_manager is deprecated. Please use callbacks instead.",
+                DeprecationWarning,
+            )
+            values["callbacks"] = values.pop("callback_manager", None)
+        return values
+
+    @validator("verbose", pre=True, always=True)
+    def set_verbose(cls, verbose: Optional[bool]) -> bool:
+        """Set the chain verbosity.
+
+        Defaults to the global setting if not specified by the user.
+        """
+        if verbose is None:
+            return _get_verbosity()
+        else:
+            return verbose
+
+    @property
+    @abstractmethod
+    def input_keys(self) -> List[str]:
+        """Keys expected to be in the chain input."""
+
+    @property
+    @abstractmethod
+    def output_keys(self) -> List[str]:
+        """Keys expected to be in the chain output."""
+
+    def _validate_inputs(self, inputs: Dict[str, Any]) -> None:
+        """Check that all inputs are present."""
+        if not isinstance(inputs, dict):
+            _input_keys = set(self.input_keys)
+            if self.memory is not None:
+                # If there are multiple input keys, but some get set by memory so that
+                # only one is not set, we can still figure out which key it is.
+                _input_keys = _input_keys.difference(self.memory.memory_variables)
+            if len(_input_keys) != 1:
+                raise ValueError(
+                    f"A single string input was passed in, but this chain expects "
+                    f"multiple inputs ({_input_keys}). When a chain expects "
+                    f"multiple inputs, please call it by passing in a dictionary, "
+                    "eg `chain({'foo': 1, 'bar': 2})`"
+                )
+
+        missing_keys = set(self.input_keys).difference(inputs)
+        if missing_keys:
+            raise ValueError(f"Missing some input keys: {missing_keys}")
+
+    def _validate_outputs(self, outputs: Dict[str, Any]) -> None:
+        missing_keys = set(self.output_keys).difference(outputs)
+        if missing_keys:
+            raise ValueError(f"Missing some output keys: {missing_keys}")
+
+    @abstractmethod
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Execute the chain.
+
+        This is a private method that is not user-facing. It is only called within
+            `Chain.__call__`, which is the user-facing wrapper method that handles
+            callbacks configuration and some input/output processing.
+
+        Args:
+            inputs: A dict of named inputs to the chain. Assumed to contain all inputs
+                specified in `Chain.input_keys`, including any inputs added by memory.
+            run_manager: The callbacks manager that contains the callback handlers for
+                this run of the chain.
+
+        Returns:
+            A dict of named outputs. Should contain all outputs specified in
+                `Chain.output_keys`.
+        """
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Asynchronously execute the chain.
+
+        This is a private method that is not user-facing. It is only called within
+            `Chain.acall`, which is the user-facing wrapper method that handles
+            callbacks configuration and some input/output processing.
+
+        Args:
+            inputs: A dict of named inputs to the chain. Assumed to contain all inputs
+                specified in `Chain.input_keys`, including any inputs added by memory.
+            run_manager: The callbacks manager that contains the callback handlers for
+                this run of the chain.
+
+        Returns:
+            A dict of named outputs. Should contain all outputs specified in
+                `Chain.output_keys`.
+        """
+        return await run_in_executor(
+            None, self._call, inputs, run_manager.get_sync() if run_manager else None
+        )
+
+    @deprecated("0.1.0", alternative="invoke", removal="0.2.0")
+    def __call__(
+        self,
+        inputs: Union[Dict[str, Any], Any],
+        return_only_outputs: bool = False,
+        callbacks: Callbacks = None,
+        *,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        run_name: Optional[str] = None,
+        include_run_info: bool = False,
+    ) -> Dict[str, Any]:
+        """Execute the chain.
+
+        Args:
+            inputs: Dictionary of inputs, or single input if chain expects
+                only one param. Should contain all inputs specified in
+                `Chain.input_keys` except for inputs that will be set by the chain's
+                memory.
+            return_only_outputs: Whether to return only outputs in the
+                response. If True, only new keys generated by this chain will be
+                returned. If False, both input keys and new keys generated by this
+                chain will be returned. Defaults to False.
+            callbacks: Callbacks to use for this chain run. These will be called in
+                addition to callbacks passed to the chain during construction, but only
+                these runtime callbacks will propagate to calls to other objects.
+            tags: List of string tags to pass to all callbacks. These will be passed in
+                addition to tags passed to the chain during construction, but only
+                these runtime tags will propagate to calls to other objects.
+            metadata: Optional metadata associated with the chain. Defaults to None
+            include_run_info: Whether to include run info in the response. Defaults
+                to False.
+
+        Returns:
+            A dict of named outputs. Should contain all outputs specified in
+                `Chain.output_keys`.
+        """
+        config = {
+            "callbacks": callbacks,
+            "tags": tags,
+            "metadata": metadata,
+            "run_name": run_name,
+        }
+
+        return self.invoke(
+            inputs,
+            cast(RunnableConfig, {k: v for k, v in config.items() if v is not None}),
+            return_only_outputs=return_only_outputs,
+            include_run_info=include_run_info,
+        )
+
+    @deprecated("0.1.0", alternative="ainvoke", removal="0.2.0")
+    async def acall(
+        self,
+        inputs: Union[Dict[str, Any], Any],
+        return_only_outputs: bool = False,
+        callbacks: Callbacks = None,
+        *,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        run_name: Optional[str] = None,
+        include_run_info: bool = False,
+    ) -> Dict[str, Any]:
+        """Asynchronously execute the chain.
+
+        Args:
+            inputs: Dictionary of inputs, or single input if chain expects
+                only one param. Should contain all inputs specified in
+                `Chain.input_keys` except for inputs that will be set by the chain's
+                memory.
+            return_only_outputs: Whether to return only outputs in the
+                response. If True, only new keys generated by this chain will be
+                returned. If False, both input keys and new keys generated by this
+                chain will be returned. Defaults to False.
+            callbacks: Callbacks to use for this chain run. These will be called in
+                addition to callbacks passed to the chain during construction, but only
+                these runtime callbacks will propagate to calls to other objects.
+            tags: List of string tags to pass to all callbacks. These will be passed in
+                addition to tags passed to the chain during construction, but only
+                these runtime tags will propagate to calls to other objects.
+            metadata: Optional metadata associated with the chain. Defaults to None
+            include_run_info: Whether to include run info in the response. Defaults
+                to False.
+
+        Returns:
+            A dict of named outputs. Should contain all outputs specified in
+                `Chain.output_keys`.
+        """
+        config = {
+            "callbacks": callbacks,
+            "tags": tags,
+            "metadata": metadata,
+            "run_name": run_name,
+        }
+        return await self.ainvoke(
+            inputs,
+            cast(RunnableConfig, {k: v for k, v in config.items() if k is not None}),
+            return_only_outputs=return_only_outputs,
+            include_run_info=include_run_info,
+        )
+
+    def prep_outputs(
+        self,
+        inputs: Dict[str, str],
+        outputs: Dict[str, str],
+        return_only_outputs: bool = False,
+    ) -> Dict[str, str]:
+        """Validate and prepare chain outputs, and save info about this run to memory.
+
+        Args:
+            inputs: Dictionary of chain inputs, including any inputs added by chain
+                memory.
+            outputs: Dictionary of initial chain outputs.
+            return_only_outputs: Whether to only return the chain outputs. If False,
+                inputs are also added to the final outputs.
+
+        Returns:
+            A dict of the final chain outputs.
+        """
+        self._validate_outputs(outputs)
+        if self.memory is not None:
+            self.memory.save_context(inputs, outputs)
+        if return_only_outputs:
+            return outputs
+        else:
+            return {**inputs, **outputs}
+
+    def prep_inputs(self, inputs: Union[Dict[str, Any], Any]) -> Dict[str, str]:
+        """Prepare chain inputs, including adding inputs from memory.
+
+        Args:
+            inputs: Dictionary of raw inputs, or single input if chain expects
+                only one param. Should contain all inputs specified in
+                `Chain.input_keys` except for inputs that will be set by the chain's
+                memory.
+
+        Returns:
+            A dictionary of all inputs, including those added by the chain's memory.
+        """
+        if not isinstance(inputs, dict):
+            _input_keys = set(self.input_keys)
+            if self.memory is not None:
+                # If there are multiple input keys, but some get set by memory so that
+                # only one is not set, we can still figure out which key it is.
+                _input_keys = _input_keys.difference(self.memory.memory_variables)
+            inputs = {list(_input_keys)[0]: inputs}
+        if self.memory is not None:
+            external_context = self.memory.load_memory_variables(inputs)
+            inputs = dict(inputs, **external_context)
+        return inputs
+
+    async def aprep_inputs(self, inputs: Union[Dict[str, Any], Any]) -> Dict[str, str]:
+        """Prepare chain inputs, including adding inputs from memory.
+
+        Args:
+            inputs: Dictionary of raw inputs, or single input if chain expects
+                only one param. Should contain all inputs specified in
+                `Chain.input_keys` except for inputs that will be set by the chain's
+                memory.
+
+        Returns:
+            A dictionary of all inputs, including those added by the chain's memory.
+        """
+        if not isinstance(inputs, dict):
+            _input_keys = set(self.input_keys)
+            if self.memory is not None:
+                # If there are multiple input keys, but some get set by memory so that
+                # only one is not set, we can still figure out which key it is.
+                _input_keys = _input_keys.difference(self.memory.memory_variables)
+            inputs = {list(_input_keys)[0]: inputs}
+        if self.memory is not None:
+            external_context = await self.memory.aload_memory_variables(inputs)
+            inputs = dict(inputs, **external_context)
+        return inputs
+
+    @property
+    def _run_output_key(self) -> str:
+        if len(self.output_keys) != 1:
+            raise ValueError(
+                f"`run` not supported when there is not exactly "
+                f"one output key. Got {self.output_keys}."
+            )
+        return self.output_keys[0]
+
+    @deprecated("0.1.0", alternative="invoke", removal="0.2.0")
+    def run(
+        self,
+        *args: Any,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Convenience method for executing chain.
+
+        The main difference between this method and `Chain.__call__` is that this
+        method expects inputs to be passed directly in as positional arguments or
+        keyword arguments, whereas `Chain.__call__` expects a single input dictionary
+        with all the inputs
+
+        Args:
+            *args: If the chain expects a single input, it can be passed in as the
+                sole positional argument.
+            callbacks: Callbacks to use for this chain run. These will be called in
+                addition to callbacks passed to the chain during construction, but only
+                these runtime callbacks will propagate to calls to other objects.
+            tags: List of string tags to pass to all callbacks. These will be passed in
+                addition to tags passed to the chain during construction, but only
+                these runtime tags will propagate to calls to other objects.
+            **kwargs: If the chain expects multiple inputs, they can be passed in
+                directly as keyword arguments.
+
+        Returns:
+            The chain output.
+
+        Example:
+            .. code-block:: python
+
+                # Suppose we have a single-input chain that takes a 'question' string:
+                chain.run("What's the temperature in Boise, Idaho?")
+                # -> "The temperature in Boise is..."
+
+                # Suppose we have a multi-input chain that takes a 'question' string
+                # and 'context' string:
+                question = "What's the temperature in Boise, Idaho?"
+                context = "Weather report for Boise, Idaho on 07/03/23..."
+                chain.run(question=question, context=context)
+                # -> "The temperature in Boise is..."
+        """
+        # Run at start to make sure this is possible/defined
+        _output_key = self._run_output_key
+
+        if args and not kwargs:
+            if len(args) != 1:
+                raise ValueError("`run` supports only one positional argument.")
+            return self(args[0], callbacks=callbacks, tags=tags, metadata=metadata)[
+                _output_key
+            ]
+
+        if kwargs and not args:
+            return self(kwargs, callbacks=callbacks, tags=tags, metadata=metadata)[
+                _output_key
+            ]
+
+        if not kwargs and not args:
+            raise ValueError(
+                "`run` supported with either positional arguments or keyword arguments,"
+                " but none were provided."
+            )
+        else:
+            raise ValueError(
+                f"`run` supported with either positional arguments or keyword arguments"
+                f" but not both. Got args: {args} and kwargs: {kwargs}."
+            )
+
+    @deprecated("0.1.0", alternative="ainvoke", removal="0.2.0")
+    async def arun(
+        self,
+        *args: Any,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Convenience method for executing chain.
+
+        The main difference between this method and `Chain.__call__` is that this
+        method expects inputs to be passed directly in as positional arguments or
+        keyword arguments, whereas `Chain.__call__` expects a single input dictionary
+        with all the inputs
+
+
+        Args:
+            *args: If the chain expects a single input, it can be passed in as the
+                sole positional argument.
+            callbacks: Callbacks to use for this chain run. These will be called in
+                addition to callbacks passed to the chain during construction, but only
+                these runtime callbacks will propagate to calls to other objects.
+            tags: List of string tags to pass to all callbacks. These will be passed in
+                addition to tags passed to the chain during construction, but only
+                these runtime tags will propagate to calls to other objects.
+            **kwargs: If the chain expects multiple inputs, they can be passed in
+                directly as keyword arguments.
+
+        Returns:
+            The chain output.
+
+        Example:
+            .. code-block:: python
+
+                # Suppose we have a single-input chain that takes a 'question' string:
+                await chain.arun("What's the temperature in Boise, Idaho?")
+                # -> "The temperature in Boise is..."
+
+                # Suppose we have a multi-input chain that takes a 'question' string
+                # and 'context' string:
+                question = "What's the temperature in Boise, Idaho?"
+                context = "Weather report for Boise, Idaho on 07/03/23..."
+                await chain.arun(question=question, context=context)
+                # -> "The temperature in Boise is..."
+        """
+        if len(self.output_keys) != 1:
+            raise ValueError(
+                f"`run` not supported when there is not exactly "
+                f"one output key. Got {self.output_keys}."
+            )
+        elif args and not kwargs:
+            if len(args) != 1:
+                raise ValueError("`run` supports only one positional argument.")
+            return (
+                await self.acall(
+                    args[0], callbacks=callbacks, tags=tags, metadata=metadata
+                )
+            )[self.output_keys[0]]
+
+        if kwargs and not args:
+            return (
+                await self.acall(
+                    kwargs, callbacks=callbacks, tags=tags, metadata=metadata
+                )
+            )[self.output_keys[0]]
+
+        raise ValueError(
+            f"`run` supported with either positional arguments or keyword arguments"
+            f" but not both. Got args: {args} and kwargs: {kwargs}."
+        )
+
+    def dict(self, **kwargs: Any) -> Dict:
+        """Dictionary representation of chain.
+
+        Expects `Chain._chain_type` property to be implemented and for memory to be
+            null.
+
+        Args:
+            **kwargs: Keyword arguments passed to default `pydantic.BaseModel.dict`
+                method.
+
+        Returns:
+            A dictionary representation of the chain.
+
+        Example:
+            .. code-block:: python
+
+                chain.dict(exclude_unset=True)
+                # -> {"_type": "foo", "verbose": False, ...}
+        """
+        _dict = super().dict(**kwargs)
+        try:
+            _dict["_type"] = self._chain_type
+        except NotImplementedError:
+            pass
+        return _dict
+
+    def save(self, file_path: Union[Path, str]) -> None:
+        """Save the chain.
+
+        Expects `Chain._chain_type` property to be implemented and for memory to be
+            null.
+
+        Args:
+            file_path: Path to file to save the chain to.
+
+        Example:
+            .. code-block:: python
+
+                chain.save(file_path="path/chain.yaml")
+        """
+        if self.memory is not None:
+            raise ValueError("Saving of memory is not yet supported.")
+
+        # Fetch dictionary to save
+        chain_dict = self.dict()
+        if "_type" not in chain_dict:
+            raise NotImplementedError(f"Chain {self} does not support saving.")
+
+        # Convert file to Path object.
+        if isinstance(file_path, str):
+            save_path = Path(file_path)
+        else:
+            save_path = file_path
+
+        directory_path = save_path.parent
+        directory_path.mkdir(parents=True, exist_ok=True)
+
+        if save_path.suffix == ".json":
+            with open(file_path, "w") as f:
+                json.dump(chain_dict, f, indent=4)
+        elif save_path.suffix.endswith((".yaml", ".yml")):
+            with open(file_path, "w") as f:
+                yaml.dump(chain_dict, f, default_flow_style=False)
+        else:
+            raise ValueError(f"{save_path} must be json or yaml")
+
+    @deprecated("0.1.0", alternative="batch", removal="0.2.0")
+    def apply(
+        self, input_list: List[Dict[str, Any]], callbacks: Callbacks = None
+    ) -> List[Dict[str, str]]:
+        """Call the chain on all inputs in the list."""
+        return [self(inputs, callbacks=callbacks) for inputs in input_list]
diff --git a/llm/Lib/site-packages/langchain/chains/chat_vector_db/__init__.py b/llm/Lib/site-packages/langchain/chains/chat_vector_db/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/chains/chat_vector_db/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/chat_vector_db/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..65e241141654bb2ddd18b0f356010b65ea624e49
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/chat_vector_db/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/chat_vector_db/__pycache__/prompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/chat_vector_db/__pycache__/prompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bf4a6477bb14b683dc9f8d4dfeda855239130ac5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/chat_vector_db/__pycache__/prompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/chat_vector_db/prompts.py b/llm/Lib/site-packages/langchain/chains/chat_vector_db/prompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..19f7a210386a80e57b565fb644889c207e32f451
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/chat_vector_db/prompts.py
@@ -0,0 +1,20 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+_template = """Given the following conversation and a follow up question, rephrase the follow up question to be a standalone question.
+
+Chat History:
+{chat_history}
+Follow Up Input: {question}
+Standalone question:"""
+CONDENSE_QUESTION_PROMPT = PromptTemplate.from_template(_template)
+
+prompt_template = """Use the following pieces of context to answer the question at the end. If you don't know the answer, just say that you don't know, don't try to make up an answer.
+
+{context}
+
+Question: {question}
+Helpful Answer:"""
+QA_PROMPT = PromptTemplate(
+    template=prompt_template, input_variables=["context", "question"]
+)
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/__init__.py b/llm/Lib/site-packages/langchain/chains/combine_documents/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6b038ec101c460443375bd8bbf77c2a74bce9fa2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/combine_documents/__init__.py
@@ -0,0 +1,15 @@
+"""Different ways to combine documents."""
+
+from langchain.chains.combine_documents.reduce import (
+    acollapse_docs,
+    collapse_docs,
+    split_list_of_docs,
+)
+from langchain.chains.combine_documents.stuff import create_stuff_documents_chain
+
+__all__ = [
+    "acollapse_docs",
+    "collapse_docs",
+    "split_list_of_docs",
+    "create_stuff_documents_chain",
+]
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7704c75c3bf76d9ea1e719ba28492e5b48b92aea
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6f468ae2567dff1eba173c4e504f329a540e05cf
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/map_reduce.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/map_reduce.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e27376529b42e28c20b38cecc2456357b6a28850
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/map_reduce.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/map_rerank.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/map_rerank.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8bda2e1bde03351706563ee5c40ffd97cbc22109
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/map_rerank.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/reduce.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/reduce.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..42cdccaa09d5369de76e64df24d3facec273aa35
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/reduce.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/refine.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/refine.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c5f124a66f85699e78abd3dc78af9e695d23faa8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/refine.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/stuff.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/stuff.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..994d7edea524cf8a8efc78a49bea0a69f3f424f3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/combine_documents/__pycache__/stuff.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/base.py b/llm/Lib/site-packages/langchain/chains/combine_documents/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..6746c9df8f5df68b54281c4d03f2189bfcd9a11d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/combine_documents/base.py
@@ -0,0 +1,215 @@
+"""Base interface for chains combining documents."""
+
+from abc import ABC, abstractmethod
+from typing import Any, Dict, List, Optional, Tuple, Type
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+)
+from langchain_core.documents import Document
+from langchain_core.prompts import BasePromptTemplate, PromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.runnables.config import RunnableConfig
+from langchain_core.runnables.utils import create_model
+from langchain_text_splitters import RecursiveCharacterTextSplitter, TextSplitter
+
+from langchain.chains.base import Chain
+
+DEFAULT_DOCUMENT_SEPARATOR = "\n\n"
+DOCUMENTS_KEY = "context"
+DEFAULT_DOCUMENT_PROMPT = PromptTemplate.from_template("{page_content}")
+
+
+def _validate_prompt(prompt: BasePromptTemplate) -> None:
+    if DOCUMENTS_KEY not in prompt.input_variables:
+        raise ValueError(
+            f"Prompt must accept {DOCUMENTS_KEY} as an input variable. Received prompt "
+            f"with input variables: {prompt.input_variables}"
+        )
+
+
+class BaseCombineDocumentsChain(Chain, ABC):
+    """Base interface for chains combining documents.
+
+    Subclasses of this chain deal with combining documents in a variety of
+    ways. This base class exists to add some uniformity in the interface these types
+    of chains should expose. Namely, they expect an input key related to the documents
+    to use (default `input_documents`), and then also expose a method to calculate
+    the length of a prompt from documents (useful for outside callers to use to
+    determine whether it's safe to pass a list of documents into this chain or whether
+    that will be longer than the context length).
+    """
+
+    input_key: str = "input_documents"  #: :meta private:
+    output_key: str = "output_text"  #: :meta private:
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        return create_model(
+            "CombineDocumentsInput",
+            **{self.input_key: (List[Document], None)},  # type: ignore[call-overload]
+        )
+
+    def get_output_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        return create_model(
+            "CombineDocumentsOutput",
+            **{self.output_key: (str, None)},  # type: ignore[call-overload]
+        )
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Expect input key.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return output key.
+
+        :meta private:
+        """
+        return [self.output_key]
+
+    def prompt_length(self, docs: List[Document], **kwargs: Any) -> Optional[int]:
+        """Return the prompt length given the documents passed in.
+
+        This can be used by a caller to determine whether passing in a list
+        of documents would exceed a certain prompt length. This useful when
+        trying to ensure that the size of a prompt remains below a certain
+        context limit.
+
+        Args:
+            docs: List[Document], a list of documents to use to calculate the
+                total prompt length.
+
+        Returns:
+            Returns None if the method does not depend on the prompt length,
+            otherwise the length of the prompt in tokens.
+        """
+        return None
+
+    @abstractmethod
+    def combine_docs(self, docs: List[Document], **kwargs: Any) -> Tuple[str, dict]:
+        """Combine documents into a single string.
+
+        Args:
+            docs: List[Document], the documents to combine
+            **kwargs: Other parameters to use in combining documents, often
+                other inputs to the prompt.
+
+        Returns:
+            The first element returned is the single string output. The second
+            element returned is a dictionary of other keys to return.
+        """
+
+    @abstractmethod
+    async def acombine_docs(
+        self, docs: List[Document], **kwargs: Any
+    ) -> Tuple[str, dict]:
+        """Combine documents into a single string.
+
+        Args:
+            docs: List[Document], the documents to combine
+            **kwargs: Other parameters to use in combining documents, often
+                other inputs to the prompt.
+
+        Returns:
+            The first element returned is the single string output. The second
+            element returned is a dictionary of other keys to return.
+        """
+
+    def _call(
+        self,
+        inputs: Dict[str, List[Document]],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        """Prepare inputs, call combine docs, prepare outputs."""
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        docs = inputs[self.input_key]
+        # Other keys are assumed to be needed for LLM prediction
+        other_keys = {k: v for k, v in inputs.items() if k != self.input_key}
+        output, extra_return_dict = self.combine_docs(
+            docs, callbacks=_run_manager.get_child(), **other_keys
+        )
+        extra_return_dict[self.output_key] = output
+        return extra_return_dict
+
+    async def _acall(
+        self,
+        inputs: Dict[str, List[Document]],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        """Prepare inputs, call combine docs, prepare outputs."""
+        _run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()
+        docs = inputs[self.input_key]
+        # Other keys are assumed to be needed for LLM prediction
+        other_keys = {k: v for k, v in inputs.items() if k != self.input_key}
+        output, extra_return_dict = await self.acombine_docs(
+            docs, callbacks=_run_manager.get_child(), **other_keys
+        )
+        extra_return_dict[self.output_key] = output
+        return extra_return_dict
+
+
+class AnalyzeDocumentChain(Chain):
+    """Chain that splits documents, then analyzes it in pieces.
+
+    This chain is parameterized by a TextSplitter and a CombineDocumentsChain.
+    This chain takes a single document as input, and then splits it up into chunks
+    and then passes those chucks to the CombineDocumentsChain.
+    """
+
+    input_key: str = "input_document"  #: :meta private:
+    text_splitter: TextSplitter = Field(default_factory=RecursiveCharacterTextSplitter)
+    combine_docs_chain: BaseCombineDocumentsChain
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Expect input key.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return output key.
+
+        :meta private:
+        """
+        return self.combine_docs_chain.output_keys
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        return create_model(
+            "AnalyzeDocumentChain",
+            **{self.input_key: (str, None)},  # type: ignore[call-overload]
+        )
+
+    def get_output_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        return self.combine_docs_chain.get_output_schema(config)
+
+    def _call(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        """Split document into chunks and pass to CombineDocumentsChain."""
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        document = inputs[self.input_key]
+        docs = self.text_splitter.create_documents([document])
+        # Other keys are assumed to be needed for LLM prediction
+        other_keys: Dict = {k: v for k, v in inputs.items() if k != self.input_key}
+        other_keys[self.combine_docs_chain.input_key] = docs
+        return self.combine_docs_chain(
+            other_keys, return_only_outputs=True, callbacks=_run_manager.get_child()
+        )
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/map_reduce.py b/llm/Lib/site-packages/langchain/chains/combine_documents/map_reduce.py
new file mode 100644
index 0000000000000000000000000000000000000000..cdeeda3302a9f920d2439046bfcbd95c17eca05d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/combine_documents/map_reduce.py
@@ -0,0 +1,278 @@
+"""Combining documents by mapping a chain over them first, then combining results."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional, Tuple, Type
+
+from langchain_core.callbacks import Callbacks
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.runnables.config import RunnableConfig
+from langchain_core.runnables.utils import create_model
+
+from langchain.chains.combine_documents.base import BaseCombineDocumentsChain
+from langchain.chains.combine_documents.reduce import ReduceDocumentsChain
+from langchain.chains.llm import LLMChain
+
+
+class MapReduceDocumentsChain(BaseCombineDocumentsChain):
+    """Combining documents by mapping a chain over them, then combining results.
+
+    We first call `llm_chain` on each document individually, passing in the
+    `page_content` and any other kwargs. This is the `map` step.
+
+    We then process the results of that `map` step in a `reduce` step. This should
+    likely be a ReduceDocumentsChain.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.chains import (
+                StuffDocumentsChain,
+                LLMChain,
+                ReduceDocumentsChain,
+                MapReduceDocumentsChain,
+            )
+            from langchain_core.prompts import PromptTemplate
+            from langchain_community.llms import OpenAI
+
+            # This controls how each document will be formatted. Specifically,
+            # it will be passed to `format_document` - see that function for more
+            # details.
+            document_prompt = PromptTemplate(
+                input_variables=["page_content"],
+                 template="{page_content}"
+            )
+            document_variable_name = "context"
+            llm = OpenAI()
+            # The prompt here should take as an input variable the
+            # `document_variable_name`
+            prompt = PromptTemplate.from_template(
+                "Summarize this content: {context}"
+            )
+            llm_chain = LLMChain(llm=llm, prompt=prompt)
+            # We now define how to combine these summaries
+            reduce_prompt = PromptTemplate.from_template(
+                "Combine these summaries: {context}"
+            )
+            reduce_llm_chain = LLMChain(llm=llm, prompt=reduce_prompt)
+            combine_documents_chain = StuffDocumentsChain(
+                llm_chain=reduce_llm_chain,
+                document_prompt=document_prompt,
+                document_variable_name=document_variable_name
+            )
+            reduce_documents_chain = ReduceDocumentsChain(
+                combine_documents_chain=combine_documents_chain,
+            )
+            chain = MapReduceDocumentsChain(
+                llm_chain=llm_chain,
+                reduce_documents_chain=reduce_documents_chain,
+            )
+            # If we wanted to, we could also pass in collapse_documents_chain
+            # which is specifically aimed at collapsing documents BEFORE
+            # the final call.
+            prompt = PromptTemplate.from_template(
+                "Collapse this content: {context}"
+            )
+            llm_chain = LLMChain(llm=llm, prompt=prompt)
+            collapse_documents_chain = StuffDocumentsChain(
+                llm_chain=llm_chain,
+                document_prompt=document_prompt,
+                document_variable_name=document_variable_name
+            )
+            reduce_documents_chain = ReduceDocumentsChain(
+                combine_documents_chain=combine_documents_chain,
+                collapse_documents_chain=collapse_documents_chain,
+            )
+            chain = MapReduceDocumentsChain(
+                llm_chain=llm_chain,
+                reduce_documents_chain=reduce_documents_chain,
+            )
+    """
+
+    llm_chain: LLMChain
+    """Chain to apply to each document individually."""
+    reduce_documents_chain: BaseCombineDocumentsChain
+    """Chain to use to reduce the results of applying `llm_chain` to each doc.
+    This typically either a ReduceDocumentChain or StuffDocumentChain."""
+    document_variable_name: str
+    """The variable name in the llm_chain to put the documents in.
+    If only one variable in the llm_chain, this need not be provided."""
+    return_intermediate_steps: bool = False
+    """Return the results of the map steps in the output."""
+
+    def get_output_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        if self.return_intermediate_steps:
+            return create_model(
+                "MapReduceDocumentsOutput",
+                **{
+                    self.output_key: (str, None),
+                    "intermediate_steps": (List[str], None),
+                },  # type: ignore[call-overload]
+            )
+
+        return super().get_output_schema(config)
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Expect input key.
+
+        :meta private:
+        """
+        _output_keys = super().output_keys
+        if self.return_intermediate_steps:
+            _output_keys = _output_keys + ["intermediate_steps"]
+        return _output_keys
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator(pre=True)
+    def get_reduce_chain(cls, values: Dict) -> Dict:
+        """For backwards compatibility."""
+        if "combine_document_chain" in values:
+            if "reduce_documents_chain" in values:
+                raise ValueError(
+                    "Both `reduce_documents_chain` and `combine_document_chain` "
+                    "cannot be provided at the same time. `combine_document_chain` "
+                    "is deprecated, please only provide `reduce_documents_chain`"
+                )
+            combine_chain = values["combine_document_chain"]
+            collapse_chain = values.get("collapse_document_chain")
+            reduce_chain = ReduceDocumentsChain(
+                combine_documents_chain=combine_chain,
+                collapse_documents_chain=collapse_chain,
+            )
+            values["reduce_documents_chain"] = reduce_chain
+            del values["combine_document_chain"]
+            if "collapse_document_chain" in values:
+                del values["collapse_document_chain"]
+
+        return values
+
+    @root_validator(pre=True)
+    def get_return_intermediate_steps(cls, values: Dict) -> Dict:
+        """For backwards compatibility."""
+        if "return_map_steps" in values:
+            values["return_intermediate_steps"] = values["return_map_steps"]
+            del values["return_map_steps"]
+        return values
+
+    @root_validator(pre=True)
+    def get_default_document_variable_name(cls, values: Dict) -> Dict:
+        """Get default document variable name, if not provided."""
+        if "document_variable_name" not in values:
+            llm_chain_variables = values["llm_chain"].prompt.input_variables
+            if len(llm_chain_variables) == 1:
+                values["document_variable_name"] = llm_chain_variables[0]
+            else:
+                raise ValueError(
+                    "document_variable_name must be provided if there are "
+                    "multiple llm_chain input_variables"
+                )
+        else:
+            llm_chain_variables = values["llm_chain"].prompt.input_variables
+            if values["document_variable_name"] not in llm_chain_variables:
+                raise ValueError(
+                    f"document_variable_name {values['document_variable_name']} was "
+                    f"not found in llm_chain input_variables: {llm_chain_variables}"
+                )
+        return values
+
+    @property
+    def collapse_document_chain(self) -> BaseCombineDocumentsChain:
+        """Kept for backward compatibility."""
+        if isinstance(self.reduce_documents_chain, ReduceDocumentsChain):
+            if self.reduce_documents_chain.collapse_documents_chain:
+                return self.reduce_documents_chain.collapse_documents_chain
+            else:
+                return self.reduce_documents_chain.combine_documents_chain
+        else:
+            raise ValueError(
+                f"`reduce_documents_chain` is of type "
+                f"{type(self.reduce_documents_chain)} so it does not have "
+                f"this attribute."
+            )
+
+    @property
+    def combine_document_chain(self) -> BaseCombineDocumentsChain:
+        """Kept for backward compatibility."""
+        if isinstance(self.reduce_documents_chain, ReduceDocumentsChain):
+            return self.reduce_documents_chain.combine_documents_chain
+        else:
+            raise ValueError(
+                f"`reduce_documents_chain` is of type "
+                f"{type(self.reduce_documents_chain)} so it does not have "
+                f"this attribute."
+            )
+
+    def combine_docs(
+        self,
+        docs: List[Document],
+        token_max: Optional[int] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Tuple[str, dict]:
+        """Combine documents in a map reduce manner.
+
+        Combine by mapping first chain over all documents, then reducing the results.
+        This reducing can be done recursively if needed (if there are many documents).
+        """
+        map_results = self.llm_chain.apply(
+            # FYI - this is parallelized and so it is fast.
+            [{self.document_variable_name: d.page_content, **kwargs} for d in docs],
+            callbacks=callbacks,
+        )
+        question_result_key = self.llm_chain.output_key
+        result_docs = [
+            Document(page_content=r[question_result_key], metadata=docs[i].metadata)
+            # This uses metadata from the docs, and the textual results from `results`
+            for i, r in enumerate(map_results)
+        ]
+        result, extra_return_dict = self.reduce_documents_chain.combine_docs(
+            result_docs, token_max=token_max, callbacks=callbacks, **kwargs
+        )
+        if self.return_intermediate_steps:
+            intermediate_steps = [r[question_result_key] for r in map_results]
+            extra_return_dict["intermediate_steps"] = intermediate_steps
+        return result, extra_return_dict
+
+    async def acombine_docs(
+        self,
+        docs: List[Document],
+        token_max: Optional[int] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Tuple[str, dict]:
+        """Combine documents in a map reduce manner.
+
+        Combine by mapping first chain over all documents, then reducing the results.
+        This reducing can be done recursively if needed (if there are many documents).
+        """
+        map_results = await self.llm_chain.aapply(
+            # FYI - this is parallelized and so it is fast.
+            [{**{self.document_variable_name: d.page_content}, **kwargs} for d in docs],
+            callbacks=callbacks,
+        )
+        question_result_key = self.llm_chain.output_key
+        result_docs = [
+            Document(page_content=r[question_result_key], metadata=docs[i].metadata)
+            # This uses metadata from the docs, and the textual results from `results`
+            for i, r in enumerate(map_results)
+        ]
+        result, extra_return_dict = await self.reduce_documents_chain.acombine_docs(
+            result_docs, token_max=token_max, callbacks=callbacks, **kwargs
+        )
+        if self.return_intermediate_steps:
+            intermediate_steps = [r[question_result_key] for r in map_results]
+            extra_return_dict["intermediate_steps"] = intermediate_steps
+        return result, extra_return_dict
+
+    @property
+    def _chain_type(self) -> str:
+        return "map_reduce_documents_chain"
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/map_rerank.py b/llm/Lib/site-packages/langchain/chains/combine_documents/map_rerank.py
new file mode 100644
index 0000000000000000000000000000000000000000..8650828f9b64f2fb49cf4c9759127c96c55d628d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/combine_documents/map_rerank.py
@@ -0,0 +1,220 @@
+"""Combining documents by mapping a chain over them first, then reranking results."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional, Sequence, Tuple, Type, Union, cast
+
+from langchain_core.callbacks import Callbacks
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.runnables.config import RunnableConfig
+from langchain_core.runnables.utils import create_model
+
+from langchain.chains.combine_documents.base import BaseCombineDocumentsChain
+from langchain.chains.llm import LLMChain
+from langchain.output_parsers.regex import RegexParser
+
+
+class MapRerankDocumentsChain(BaseCombineDocumentsChain):
+    """Combining documents by mapping a chain over them, then reranking results.
+
+    This algorithm calls an LLMChain on each input document. The LLMChain is expected
+    to have an OutputParser that parses the result into both an answer (`answer_key`)
+    and a score (`rank_key`). The answer with the highest score is then returned.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.chains import StuffDocumentsChain, LLMChain
+            from langchain_core.prompts import PromptTemplate
+            from langchain_community.llms import OpenAI
+            from langchain.output_parsers.regex import RegexParser
+
+            document_variable_name = "context"
+            llm = OpenAI()
+            # The prompt here should take as an input variable the
+            # `document_variable_name`
+            # The actual prompt will need to be a lot more complex, this is just
+            # an example.
+            prompt_template = (
+                "Use the following context to tell me the chemical formula "
+                "for water. Output both your answer and a score of how confident "
+                "you are. Context: {content}"
+            )
+            output_parser = RegexParser(
+                regex=r"(.*?)\nScore: (.*)",
+                output_keys=["answer", "score"],
+            )
+            prompt = PromptTemplate(
+                template=prompt_template,
+                input_variables=["context"],
+                output_parser=output_parser,
+            )
+            llm_chain = LLMChain(llm=llm, prompt=prompt)
+            chain = MapRerankDocumentsChain(
+                llm_chain=llm_chain,
+                document_variable_name=document_variable_name,
+                rank_key="score",
+                answer_key="answer",
+            )
+    """
+
+    llm_chain: LLMChain
+    """Chain to apply to each document individually."""
+    document_variable_name: str
+    """The variable name in the llm_chain to put the documents in.
+    If only one variable in the llm_chain, this need not be provided."""
+    rank_key: str
+    """Key in output of llm_chain to rank on."""
+    answer_key: str
+    """Key in output of llm_chain to return as answer."""
+    metadata_keys: Optional[List[str]] = None
+    """Additional metadata from the chosen document to return."""
+    return_intermediate_steps: bool = False
+    """Return intermediate steps.
+    Intermediate steps include the results of calling llm_chain on each document."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    def get_output_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        schema: Dict[str, Any] = {
+            self.output_key: (str, None),
+        }
+        if self.return_intermediate_steps:
+            schema["intermediate_steps"] = (List[str], None)
+        if self.metadata_keys:
+            schema.update({key: (Any, None) for key in self.metadata_keys})
+
+        return create_model("MapRerankOutput", **schema)
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Expect input key.
+
+        :meta private:
+        """
+        _output_keys = super().output_keys
+        if self.return_intermediate_steps:
+            _output_keys = _output_keys + ["intermediate_steps"]
+        if self.metadata_keys is not None:
+            _output_keys += self.metadata_keys
+        return _output_keys
+
+    @root_validator()
+    def validate_llm_output(cls, values: Dict) -> Dict:
+        """Validate that the combine chain outputs a dictionary."""
+        output_parser = values["llm_chain"].prompt.output_parser
+        if not isinstance(output_parser, RegexParser):
+            raise ValueError(
+                "Output parser of llm_chain should be a RegexParser,"
+                f" got {output_parser}"
+            )
+        output_keys = output_parser.output_keys
+        if values["rank_key"] not in output_keys:
+            raise ValueError(
+                f"Got {values['rank_key']} as key to rank on, but did not find "
+                f"it in the llm_chain output keys ({output_keys})"
+            )
+        if values["answer_key"] not in output_keys:
+            raise ValueError(
+                f"Got {values['answer_key']} as key to return, but did not find "
+                f"it in the llm_chain output keys ({output_keys})"
+            )
+        return values
+
+    @root_validator(pre=True)
+    def get_default_document_variable_name(cls, values: Dict) -> Dict:
+        """Get default document variable name, if not provided."""
+        if "document_variable_name" not in values:
+            llm_chain_variables = values["llm_chain"].prompt.input_variables
+            if len(llm_chain_variables) == 1:
+                values["document_variable_name"] = llm_chain_variables[0]
+            else:
+                raise ValueError(
+                    "document_variable_name must be provided if there are "
+                    "multiple llm_chain input_variables"
+                )
+        else:
+            llm_chain_variables = values["llm_chain"].prompt.input_variables
+            if values["document_variable_name"] not in llm_chain_variables:
+                raise ValueError(
+                    f"document_variable_name {values['document_variable_name']} was "
+                    f"not found in llm_chain input_variables: {llm_chain_variables}"
+                )
+        return values
+
+    def combine_docs(
+        self, docs: List[Document], callbacks: Callbacks = None, **kwargs: Any
+    ) -> Tuple[str, dict]:
+        """Combine documents in a map rerank manner.
+
+        Combine by mapping first chain over all documents, then reranking the results.
+
+        Args:
+            docs: List of documents to combine
+            callbacks: Callbacks to be passed through
+            **kwargs: additional parameters to be passed to LLM calls (like other
+                input variables besides the documents)
+
+        Returns:
+            The first element returned is the single string output. The second
+            element returned is a dictionary of other keys to return.
+        """
+        results = self.llm_chain.apply_and_parse(
+            # FYI - this is parallelized and so it is fast.
+            [{**{self.document_variable_name: d.page_content}, **kwargs} for d in docs],
+            callbacks=callbacks,
+        )
+        return self._process_results(docs, results)
+
+    async def acombine_docs(
+        self, docs: List[Document], callbacks: Callbacks = None, **kwargs: Any
+    ) -> Tuple[str, dict]:
+        """Combine documents in a map rerank manner.
+
+        Combine by mapping first chain over all documents, then reranking the results.
+
+        Args:
+            docs: List of documents to combine
+            callbacks: Callbacks to be passed through
+            **kwargs: additional parameters to be passed to LLM calls (like other
+                input variables besides the documents)
+
+        Returns:
+            The first element returned is the single string output. The second
+            element returned is a dictionary of other keys to return.
+        """
+        results = await self.llm_chain.aapply_and_parse(
+            # FYI - this is parallelized and so it is fast.
+            [{**{self.document_variable_name: d.page_content}, **kwargs} for d in docs],
+            callbacks=callbacks,
+        )
+        return self._process_results(docs, results)
+
+    def _process_results(
+        self,
+        docs: List[Document],
+        results: Sequence[Union[str, List[str], Dict[str, str]]],
+    ) -> Tuple[str, dict]:
+        typed_results = cast(List[dict], results)
+        sorted_res = sorted(
+            zip(typed_results, docs), key=lambda x: -int(x[0][self.rank_key])
+        )
+        output, document = sorted_res[0]
+        extra_info = {}
+        if self.metadata_keys is not None:
+            for key in self.metadata_keys:
+                extra_info[key] = document.metadata[key]
+        if self.return_intermediate_steps:
+            extra_info["intermediate_steps"] = results
+        return output[self.answer_key], extra_info
+
+    @property
+    def _chain_type(self) -> str:
+        return "map_rerank_documents_chain"
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/reduce.py b/llm/Lib/site-packages/langchain/chains/combine_documents/reduce.py
new file mode 100644
index 0000000000000000000000000000000000000000..a55c067d1680fc013b36524e24364e8e6dd263ea
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/combine_documents/reduce.py
@@ -0,0 +1,351 @@
+"""Combine many documents together by recursively reducing them."""
+
+from __future__ import annotations
+
+from typing import Any, Callable, List, Optional, Protocol, Tuple
+
+from langchain_core.callbacks import Callbacks
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Extra
+
+from langchain.chains.combine_documents.base import BaseCombineDocumentsChain
+
+
+class CombineDocsProtocol(Protocol):
+    """Interface for the combine_docs method."""
+
+    def __call__(self, docs: List[Document], **kwargs: Any) -> str:
+        """Interface for the combine_docs method."""
+
+
+class AsyncCombineDocsProtocol(Protocol):
+    """Interface for the combine_docs method."""
+
+    async def __call__(self, docs: List[Document], **kwargs: Any) -> str:
+        """Async interface for the combine_docs method."""
+
+
+def split_list_of_docs(
+    docs: List[Document], length_func: Callable, token_max: int, **kwargs: Any
+) -> List[List[Document]]:
+    """Split Documents into subsets that each meet a cumulative length constraint.
+
+    Args:
+        docs: The full list of Documents.
+        length_func: Function for computing the cumulative length of a set of Documents.
+        token_max: The maximum cumulative length of any subset of Documents.
+        **kwargs: Arbitrary additional keyword params to pass to each call of the
+            length_func.
+
+    Returns:
+        A List[List[Document]].
+    """
+    new_result_doc_list = []
+    _sub_result_docs = []
+    for doc in docs:
+        _sub_result_docs.append(doc)
+        _num_tokens = length_func(_sub_result_docs, **kwargs)
+        if _num_tokens > token_max:
+            if len(_sub_result_docs) == 1:
+                raise ValueError(
+                    "A single document was longer than the context length,"
+                    " we cannot handle this."
+                )
+            new_result_doc_list.append(_sub_result_docs[:-1])
+            _sub_result_docs = _sub_result_docs[-1:]
+    new_result_doc_list.append(_sub_result_docs)
+    return new_result_doc_list
+
+
+def collapse_docs(
+    docs: List[Document],
+    combine_document_func: CombineDocsProtocol,
+    **kwargs: Any,
+) -> Document:
+    """Execute a collapse function on a set of documents and merge their metadatas.
+
+    Args:
+        docs: A list of Documents to combine.
+        combine_document_func: A function that takes in a list of Documents and
+            optionally addition keyword parameters and combines them into a single
+            string.
+        **kwargs: Arbitrary additional keyword params to pass to the
+            combine_document_func.
+
+    Returns:
+        A single Document with the output of combine_document_func for the page content
+            and the combined metadata's of all the input documents. All metadata values
+            are strings, and where there are overlapping keys across documents the
+            values are joined by ", ".
+    """
+    result = combine_document_func(docs, **kwargs)
+    combined_metadata = {k: str(v) for k, v in docs[0].metadata.items()}
+    for doc in docs[1:]:
+        for k, v in doc.metadata.items():
+            if k in combined_metadata:
+                combined_metadata[k] += f", {v}"
+            else:
+                combined_metadata[k] = str(v)
+    return Document(page_content=result, metadata=combined_metadata)
+
+
+async def acollapse_docs(
+    docs: List[Document],
+    combine_document_func: AsyncCombineDocsProtocol,
+    **kwargs: Any,
+) -> Document:
+    """Execute a collapse function on a set of documents and merge their metadatas.
+
+    Args:
+        docs: A list of Documents to combine.
+        combine_document_func: A function that takes in a list of Documents and
+            optionally addition keyword parameters and combines them into a single
+            string.
+        **kwargs: Arbitrary additional keyword params to pass to the
+            combine_document_func.
+
+    Returns:
+        A single Document with the output of combine_document_func for the page content
+            and the combined metadata's of all the input documents. All metadata values
+            are strings, and where there are overlapping keys across documents the
+            values are joined by ", ".
+    """
+    result = await combine_document_func(docs, **kwargs)
+    combined_metadata = {k: str(v) for k, v in docs[0].metadata.items()}
+    for doc in docs[1:]:
+        for k, v in doc.metadata.items():
+            if k in combined_metadata:
+                combined_metadata[k] += f", {v}"
+            else:
+                combined_metadata[k] = str(v)
+    return Document(page_content=result, metadata=combined_metadata)
+
+
+class ReduceDocumentsChain(BaseCombineDocumentsChain):
+    """Combine documents by recursively reducing them.
+
+    This involves
+
+    - combine_documents_chain
+
+    - collapse_documents_chain
+
+    `combine_documents_chain` is ALWAYS provided. This is final chain that is called.
+    We pass all previous results to this chain, and the output of this chain is
+    returned as a final result.
+
+    `collapse_documents_chain` is used if the documents passed in are too many to all
+    be passed to `combine_documents_chain` in one go. In this case,
+    `collapse_documents_chain` is called recursively on as big of groups of documents
+    as are allowed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.chains import (
+                StuffDocumentsChain, LLMChain, ReduceDocumentsChain
+            )
+            from langchain_core.prompts import PromptTemplate
+            from langchain_community.llms import OpenAI
+
+            # This controls how each document will be formatted. Specifically,
+            # it will be passed to `format_document` - see that function for more
+            # details.
+            document_prompt = PromptTemplate(
+                input_variables=["page_content"],
+                 template="{page_content}"
+            )
+            document_variable_name = "context"
+            llm = OpenAI()
+            # The prompt here should take as an input variable the
+            # `document_variable_name`
+            prompt = PromptTemplate.from_template(
+                "Summarize this content: {context}"
+            )
+            llm_chain = LLMChain(llm=llm, prompt=prompt)
+            combine_documents_chain = StuffDocumentsChain(
+                llm_chain=llm_chain,
+                document_prompt=document_prompt,
+                document_variable_name=document_variable_name
+            )
+            chain = ReduceDocumentsChain(
+                combine_documents_chain=combine_documents_chain,
+            )
+            # If we wanted to, we could also pass in collapse_documents_chain
+            # which is specifically aimed at collapsing documents BEFORE
+            # the final call.
+            prompt = PromptTemplate.from_template(
+                "Collapse this content: {context}"
+            )
+            llm_chain = LLMChain(llm=llm, prompt=prompt)
+            collapse_documents_chain = StuffDocumentsChain(
+                llm_chain=llm_chain,
+                document_prompt=document_prompt,
+                document_variable_name=document_variable_name
+            )
+            chain = ReduceDocumentsChain(
+                combine_documents_chain=combine_documents_chain,
+                collapse_documents_chain=collapse_documents_chain,
+            )
+    """
+
+    combine_documents_chain: BaseCombineDocumentsChain
+    """Final chain to call to combine documents.
+    This is typically a StuffDocumentsChain."""
+    collapse_documents_chain: Optional[BaseCombineDocumentsChain] = None
+    """Chain to use to collapse documents if needed until they can all fit.
+    If None, will use the combine_documents_chain.
+    This is typically a StuffDocumentsChain."""
+    token_max: int = 3000
+    """The maximum number of tokens to group documents into. For example, if
+    set to 3000 then documents will be grouped into chunks of no greater than
+    3000 tokens before trying to combine them into a smaller chunk."""
+    collapse_max_retries: Optional[int] = None
+    """The maximum number of retries to collapse documents to fit token_max.
+    If None, it will keep trying to collapse documents to fit token_max.
+    Otherwise, after it reaches the max number, it will throw an error"""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @property
+    def _collapse_chain(self) -> BaseCombineDocumentsChain:
+        if self.collapse_documents_chain is not None:
+            return self.collapse_documents_chain
+        else:
+            return self.combine_documents_chain
+
+    def combine_docs(
+        self,
+        docs: List[Document],
+        token_max: Optional[int] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Tuple[str, dict]:
+        """Combine multiple documents recursively.
+
+        Args:
+            docs: List of documents to combine, assumed that each one is less than
+                `token_max`.
+            token_max: Recursively creates groups of documents less than this number
+                of tokens.
+            callbacks: Callbacks to be passed through
+            **kwargs: additional parameters to be passed to LLM calls (like other
+                input variables besides the documents)
+
+        Returns:
+            The first element returned is the single string output. The second
+            element returned is a dictionary of other keys to return.
+        """
+        result_docs, extra_return_dict = self._collapse(
+            docs, token_max=token_max, callbacks=callbacks, **kwargs
+        )
+        return self.combine_documents_chain.combine_docs(
+            docs=result_docs, callbacks=callbacks, **kwargs
+        )
+
+    async def acombine_docs(
+        self,
+        docs: List[Document],
+        token_max: Optional[int] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Tuple[str, dict]:
+        """Async combine multiple documents recursively.
+
+        Args:
+            docs: List of documents to combine, assumed that each one is less than
+                `token_max`.
+            token_max: Recursively creates groups of documents less than this number
+                of tokens.
+            callbacks: Callbacks to be passed through
+            **kwargs: additional parameters to be passed to LLM calls (like other
+                input variables besides the documents)
+
+        Returns:
+            The first element returned is the single string output. The second
+            element returned is a dictionary of other keys to return.
+        """
+        result_docs, extra_return_dict = await self._acollapse(
+            docs, token_max=token_max, callbacks=callbacks, **kwargs
+        )
+        return await self.combine_documents_chain.acombine_docs(
+            docs=result_docs, callbacks=callbacks, **kwargs
+        )
+
+    def _collapse(
+        self,
+        docs: List[Document],
+        token_max: Optional[int] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Tuple[List[Document], dict]:
+        result_docs = docs
+        length_func = self.combine_documents_chain.prompt_length
+        num_tokens = length_func(result_docs, **kwargs)
+
+        def _collapse_docs_func(docs: List[Document], **kwargs: Any) -> str:
+            return self._collapse_chain.run(
+                input_documents=docs, callbacks=callbacks, **kwargs
+            )
+
+        _token_max = token_max or self.token_max
+        retries: int = 0
+        while num_tokens is not None and num_tokens > _token_max:
+            new_result_doc_list = split_list_of_docs(
+                result_docs, length_func, _token_max, **kwargs
+            )
+            result_docs = []
+            for docs in new_result_doc_list:
+                new_doc = collapse_docs(docs, _collapse_docs_func, **kwargs)
+                result_docs.append(new_doc)
+            num_tokens = length_func(result_docs, **kwargs)
+            retries += 1
+            if self.collapse_max_retries and retries == self.collapse_max_retries:
+                raise ValueError(
+                    f"Exceed {self.collapse_max_retries} tries to \
+                        collapse document to {_token_max} tokens."
+                )
+        return result_docs, {}
+
+    async def _acollapse(
+        self,
+        docs: List[Document],
+        token_max: Optional[int] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> Tuple[List[Document], dict]:
+        result_docs = docs
+        length_func = self.combine_documents_chain.prompt_length
+        num_tokens = length_func(result_docs, **kwargs)
+
+        async def _collapse_docs_func(docs: List[Document], **kwargs: Any) -> str:
+            return await self._collapse_chain.arun(
+                input_documents=docs, callbacks=callbacks, **kwargs
+            )
+
+        _token_max = token_max or self.token_max
+        retries: int = 0
+        while num_tokens is not None and num_tokens > _token_max:
+            new_result_doc_list = split_list_of_docs(
+                result_docs, length_func, _token_max, **kwargs
+            )
+            result_docs = []
+            for docs in new_result_doc_list:
+                new_doc = await acollapse_docs(docs, _collapse_docs_func, **kwargs)
+                result_docs.append(new_doc)
+            num_tokens = length_func(result_docs, **kwargs)
+            retries += 1
+            if self.collapse_max_retries and retries == self.collapse_max_retries:
+                raise ValueError(
+                    f"Exceed {self.collapse_max_retries} tries to \
+                        collapse document to {_token_max} tokens."
+                )
+        return result_docs, {}
+
+    @property
+    def _chain_type(self) -> str:
+        return "reduce_documents_chain"
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/refine.py b/llm/Lib/site-packages/langchain/chains/combine_documents/refine.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc34e1594b0a9e31d71d05399b91f170262ab7d9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/combine_documents/refine.py
@@ -0,0 +1,214 @@
+"""Combine documents by doing a first pass and then refining on more documents."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, List, Tuple
+
+from langchain_core.callbacks import Callbacks
+from langchain_core.documents import Document
+from langchain_core.prompts import BasePromptTemplate, format_document
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+
+from langchain.chains.combine_documents.base import (
+    BaseCombineDocumentsChain,
+)
+from langchain.chains.llm import LLMChain
+
+
+def _get_default_document_prompt() -> PromptTemplate:
+    return PromptTemplate(input_variables=["page_content"], template="{page_content}")
+
+
+class RefineDocumentsChain(BaseCombineDocumentsChain):
+    """Combine documents by doing a first pass and then refining on more documents.
+
+    This algorithm first calls `initial_llm_chain` on the first document, passing
+    that first document in with the variable name `document_variable_name`, and
+    produces a new variable with the variable name `initial_response_name`.
+
+    Then, it loops over every remaining document. This is called the "refine" step.
+    It calls `refine_llm_chain`,
+    passing in that document with the variable name `document_variable_name`
+    as well as the previous response with the variable name `initial_response_name`.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.chains import RefineDocumentsChain, LLMChain
+            from langchain_core.prompts import PromptTemplate
+            from langchain_community.llms import OpenAI
+
+            # This controls how each document will be formatted. Specifically,
+            # it will be passed to `format_document` - see that function for more
+            # details.
+            document_prompt = PromptTemplate(
+                input_variables=["page_content"],
+                 template="{page_content}"
+            )
+            document_variable_name = "context"
+            llm = OpenAI()
+            # The prompt here should take as an input variable the
+            # `document_variable_name`
+            prompt = PromptTemplate.from_template(
+                "Summarize this content: {context}"
+            )
+            initial_llm_chain = LLMChain(llm=llm, prompt=prompt)
+            initial_response_name = "prev_response"
+            # The prompt here should take as an input variable the
+            # `document_variable_name` as well as `initial_response_name`
+            prompt_refine = PromptTemplate.from_template(
+                "Here's your first summary: {prev_response}. "
+                "Now add to it based on the following context: {context}"
+            )
+            refine_llm_chain = LLMChain(llm=llm, prompt=prompt_refine)
+            chain = RefineDocumentsChain(
+                initial_llm_chain=initial_llm_chain,
+                refine_llm_chain=refine_llm_chain,
+                document_prompt=document_prompt,
+                document_variable_name=document_variable_name,
+                initial_response_name=initial_response_name,
+            )
+    """
+
+    initial_llm_chain: LLMChain
+    """LLM chain to use on initial document."""
+    refine_llm_chain: LLMChain
+    """LLM chain to use when refining."""
+    document_variable_name: str
+    """The variable name in the initial_llm_chain to put the documents in.
+    If only one variable in the initial_llm_chain, this need not be provided."""
+    initial_response_name: str
+    """The variable name to format the initial response in when refining."""
+    document_prompt: BasePromptTemplate = Field(
+        default_factory=_get_default_document_prompt
+    )
+    """Prompt to use to format each document, gets passed to `format_document`."""
+    return_intermediate_steps: bool = False
+    """Return the results of the refine steps in the output."""
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Expect input key.
+
+        :meta private:
+        """
+        _output_keys = super().output_keys
+        if self.return_intermediate_steps:
+            _output_keys = _output_keys + ["intermediate_steps"]
+        return _output_keys
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator(pre=True)
+    def get_return_intermediate_steps(cls, values: Dict) -> Dict:
+        """For backwards compatibility."""
+        if "return_refine_steps" in values:
+            values["return_intermediate_steps"] = values["return_refine_steps"]
+            del values["return_refine_steps"]
+        return values
+
+    @root_validator(pre=True)
+    def get_default_document_variable_name(cls, values: Dict) -> Dict:
+        """Get default document variable name, if not provided."""
+        if "document_variable_name" not in values:
+            llm_chain_variables = values["initial_llm_chain"].prompt.input_variables
+            if len(llm_chain_variables) == 1:
+                values["document_variable_name"] = llm_chain_variables[0]
+            else:
+                raise ValueError(
+                    "document_variable_name must be provided if there are "
+                    "multiple llm_chain input_variables"
+                )
+        else:
+            llm_chain_variables = values["initial_llm_chain"].prompt.input_variables
+            if values["document_variable_name"] not in llm_chain_variables:
+                raise ValueError(
+                    f"document_variable_name {values['document_variable_name']} was "
+                    f"not found in llm_chain input_variables: {llm_chain_variables}"
+                )
+        return values
+
+    def combine_docs(
+        self, docs: List[Document], callbacks: Callbacks = None, **kwargs: Any
+    ) -> Tuple[str, dict]:
+        """Combine by mapping first chain over all, then stuffing into final chain.
+
+        Args:
+            docs: List of documents to combine
+            callbacks: Callbacks to be passed through
+            **kwargs: additional parameters to be passed to LLM calls (like other
+                input variables besides the documents)
+
+        Returns:
+            The first element returned is the single string output. The second
+            element returned is a dictionary of other keys to return.
+        """
+        inputs = self._construct_initial_inputs(docs, **kwargs)
+        res = self.initial_llm_chain.predict(callbacks=callbacks, **inputs)
+        refine_steps = [res]
+        for doc in docs[1:]:
+            base_inputs = self._construct_refine_inputs(doc, res)
+            inputs = {**base_inputs, **kwargs}
+            res = self.refine_llm_chain.predict(callbacks=callbacks, **inputs)
+            refine_steps.append(res)
+        return self._construct_result(refine_steps, res)
+
+    async def acombine_docs(
+        self, docs: List[Document], callbacks: Callbacks = None, **kwargs: Any
+    ) -> Tuple[str, dict]:
+        """Async combine by mapping a first chain over all, then stuffing
+         into a final chain.
+
+        Args:
+            docs: List of documents to combine
+            callbacks: Callbacks to be passed through
+            **kwargs: additional parameters to be passed to LLM calls (like other
+                input variables besides the documents)
+
+        Returns:
+            The first element returned is the single string output. The second
+            element returned is a dictionary of other keys to return.
+        """
+        inputs = self._construct_initial_inputs(docs, **kwargs)
+        res = await self.initial_llm_chain.apredict(callbacks=callbacks, **inputs)
+        refine_steps = [res]
+        for doc in docs[1:]:
+            base_inputs = self._construct_refine_inputs(doc, res)
+            inputs = {**base_inputs, **kwargs}
+            res = await self.refine_llm_chain.apredict(callbacks=callbacks, **inputs)
+            refine_steps.append(res)
+        return self._construct_result(refine_steps, res)
+
+    def _construct_result(self, refine_steps: List[str], res: str) -> Tuple[str, dict]:
+        if self.return_intermediate_steps:
+            extra_return_dict = {"intermediate_steps": refine_steps}
+        else:
+            extra_return_dict = {}
+        return res, extra_return_dict
+
+    def _construct_refine_inputs(self, doc: Document, res: str) -> Dict[str, Any]:
+        return {
+            self.document_variable_name: format_document(doc, self.document_prompt),
+            self.initial_response_name: res,
+        }
+
+    def _construct_initial_inputs(
+        self, docs: List[Document], **kwargs: Any
+    ) -> Dict[str, Any]:
+        base_info = {"page_content": docs[0].page_content}
+        base_info.update(docs[0].metadata)
+        document_info = {k: base_info[k] for k in self.document_prompt.input_variables}
+        base_inputs: dict = {
+            self.document_variable_name: self.document_prompt.format(**document_info)
+        }
+        inputs = {**base_inputs, **kwargs}
+        return inputs
+
+    @property
+    def _chain_type(self) -> str:
+        return "refine_documents_chain"
diff --git a/llm/Lib/site-packages/langchain/chains/combine_documents/stuff.py b/llm/Lib/site-packages/langchain/chains/combine_documents/stuff.py
new file mode 100644
index 0000000000000000000000000000000000000000..c91f999683bd1d960bb5af1fd9aa5105219e892e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/combine_documents/stuff.py
@@ -0,0 +1,266 @@
+"""Chain that combines documents by stuffing into context."""
+from typing import Any, Dict, List, Optional, Tuple
+
+from langchain_core.callbacks import Callbacks
+from langchain_core.documents import Document
+from langchain_core.language_models import LanguageModelLike
+from langchain_core.output_parsers import BaseOutputParser, StrOutputParser
+from langchain_core.prompts import BasePromptTemplate, format_document
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+from langchain_core.runnables import Runnable, RunnablePassthrough
+
+from langchain.chains.combine_documents.base import (
+    DEFAULT_DOCUMENT_PROMPT,
+    DEFAULT_DOCUMENT_SEPARATOR,
+    DOCUMENTS_KEY,
+    BaseCombineDocumentsChain,
+    _validate_prompt,
+)
+from langchain.chains.llm import LLMChain
+
+
+def create_stuff_documents_chain(
+    llm: LanguageModelLike,
+    prompt: BasePromptTemplate,
+    *,
+    output_parser: Optional[BaseOutputParser] = None,
+    document_prompt: Optional[BasePromptTemplate] = None,
+    document_separator: str = DEFAULT_DOCUMENT_SEPARATOR,
+) -> Runnable[Dict[str, Any], Any]:
+    """Create a chain for passing a list of Documents to a model.
+
+    Args:
+        llm: Language model.
+        prompt: Prompt template. Must contain input variable "context", which will be
+            used for passing in the formatted documents.
+        output_parser: Output parser. Defaults to StrOutputParser.
+        document_prompt: Prompt used for formatting each document into a string. Input
+            variables can be "page_content" or any metadata keys that are in all
+            documents. "page_content" will automatically retrieve the
+            `Document.page_content`, and all other inputs variables will be
+            automatically retrieved from the `Document.metadata` dictionary. Default to
+            a prompt that only contains `Document.page_content`.
+        document_separator: String separator to use between formatted document strings.
+
+    Returns:
+        An LCEL Runnable. The input is a dictionary that must have a "context" key that
+        maps to a List[Document], and any other input variables expected in the prompt.
+        The Runnable return type depends on output_parser used.
+
+    Example:
+        .. code-block:: python
+
+            # pip install -U langchain langchain-community
+
+            from langchain_community.chat_models import ChatOpenAI
+            from langchain_core.documents import Document
+            from langchain_core.prompts import ChatPromptTemplate
+            from langchain.chains.combine_documents import create_stuff_documents_chain
+
+            prompt = ChatPromptTemplate.from_messages(
+                [("system", "What are everyone's favorite colors:\\n\\n{context}")]
+            )
+            llm = ChatOpenAI(model="gpt-3.5-turbo")
+            chain = create_stuff_documents_chain(llm, prompt)
+
+            docs = [
+                Document(page_content="Jesse loves red but not yellow"),
+                Document(page_content = "Jamal loves green but not as much as he loves orange")
+            ]
+
+            chain.invoke({"context": docs})
+    """  # noqa: E501
+
+    _validate_prompt(prompt)
+    _document_prompt = document_prompt or DEFAULT_DOCUMENT_PROMPT
+    _output_parser = output_parser or StrOutputParser()
+
+    def format_docs(inputs: dict) -> str:
+        return document_separator.join(
+            format_document(doc, _document_prompt) for doc in inputs[DOCUMENTS_KEY]
+        )
+
+    return (
+        RunnablePassthrough.assign(**{DOCUMENTS_KEY: format_docs}).with_config(
+            run_name="format_inputs"
+        )
+        | prompt
+        | llm
+        | _output_parser
+    ).with_config(run_name="stuff_documents_chain")
+
+
+class StuffDocumentsChain(BaseCombineDocumentsChain):
+    """Chain that combines documents by stuffing into context.
+
+    This chain takes a list of documents and first combines them into a single string.
+    It does this by formatting each document into a string with the `document_prompt`
+    and then joining them together with `document_separator`. It then adds that new
+    string to the inputs with the variable name set by `document_variable_name`.
+    Those inputs are then passed to the `llm_chain`.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.chains import StuffDocumentsChain, LLMChain
+            from langchain_core.prompts import PromptTemplate
+            from langchain_community.llms import OpenAI
+
+            # This controls how each document will be formatted. Specifically,
+            # it will be passed to `format_document` - see that function for more
+            # details.
+            document_prompt = PromptTemplate(
+                input_variables=["page_content"],
+                template="{page_content}"
+            )
+            document_variable_name = "context"
+            llm = OpenAI()
+            # The prompt here should take as an input variable the
+            # `document_variable_name`
+            prompt = PromptTemplate.from_template(
+                "Summarize this content: {context}"
+            )
+            llm_chain = LLMChain(llm=llm, prompt=prompt)
+            chain = StuffDocumentsChain(
+                llm_chain=llm_chain,
+                document_prompt=document_prompt,
+                document_variable_name=document_variable_name
+            )
+    """
+
+    llm_chain: LLMChain
+    """LLM chain which is called with the formatted document string,
+    along with any other inputs."""
+    document_prompt: BasePromptTemplate = Field(
+        default_factory=lambda: DEFAULT_DOCUMENT_PROMPT
+    )
+    """Prompt to use to format each document, gets passed to `format_document`."""
+    document_variable_name: str
+    """The variable name in the llm_chain to put the documents in.
+    If only one variable in the llm_chain, this need not be provided."""
+    document_separator: str = "\n\n"
+    """The string with which to join the formatted documents"""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator(pre=True)
+    def get_default_document_variable_name(cls, values: Dict) -> Dict:
+        """Get default document variable name, if not provided.
+
+        If only one variable is present in the llm_chain.prompt,
+        we can infer that the formatted documents should be passed in
+        with this variable name.
+        """
+        llm_chain_variables = values["llm_chain"].prompt.input_variables
+        if "document_variable_name" not in values:
+            if len(llm_chain_variables) == 1:
+                values["document_variable_name"] = llm_chain_variables[0]
+            else:
+                raise ValueError(
+                    "document_variable_name must be provided if there are "
+                    "multiple llm_chain_variables"
+                )
+        else:
+            if values["document_variable_name"] not in llm_chain_variables:
+                raise ValueError(
+                    f"document_variable_name {values['document_variable_name']} was "
+                    f"not found in llm_chain input_variables: {llm_chain_variables}"
+                )
+        return values
+
+    @property
+    def input_keys(self) -> List[str]:
+        extra_keys = [
+            k for k in self.llm_chain.input_keys if k != self.document_variable_name
+        ]
+        return super().input_keys + extra_keys
+
+    def _get_inputs(self, docs: List[Document], **kwargs: Any) -> dict:
+        """Construct inputs from kwargs and docs.
+
+        Format and then join all the documents together into one input with name
+        `self.document_variable_name`. Also pluck any additional variables
+        from **kwargs.
+
+        Args:
+            docs: List of documents to format and then join into single input
+            **kwargs: additional inputs to chain, will pluck any other required
+                arguments from here.
+
+        Returns:
+            dictionary of inputs to LLMChain
+        """
+        # Format each document according to the prompt
+        doc_strings = [format_document(doc, self.document_prompt) for doc in docs]
+        # Join the documents together to put them in the prompt.
+        inputs = {
+            k: v
+            for k, v in kwargs.items()
+            if k in self.llm_chain.prompt.input_variables
+        }
+        inputs[self.document_variable_name] = self.document_separator.join(doc_strings)
+        return inputs
+
+    def prompt_length(self, docs: List[Document], **kwargs: Any) -> Optional[int]:
+        """Return the prompt length given the documents passed in.
+
+        This can be used by a caller to determine whether passing in a list
+        of documents would exceed a certain prompt length. This useful when
+        trying to ensure that the size of a prompt remains below a certain
+        context limit.
+
+        Args:
+            docs: List[Document], a list of documents to use to calculate the
+                total prompt length.
+
+        Returns:
+            Returns None if the method does not depend on the prompt length,
+            otherwise the length of the prompt in tokens.
+        """
+        inputs = self._get_inputs(docs, **kwargs)
+        prompt = self.llm_chain.prompt.format(**inputs)
+        return self.llm_chain._get_num_tokens(prompt)
+
+    def combine_docs(
+        self, docs: List[Document], callbacks: Callbacks = None, **kwargs: Any
+    ) -> Tuple[str, dict]:
+        """Stuff all documents into one prompt and pass to LLM.
+
+        Args:
+            docs: List of documents to join together into one variable
+            callbacks: Optional callbacks to pass along
+            **kwargs: additional parameters to use to get inputs to LLMChain.
+
+        Returns:
+            The first element returned is the single string output. The second
+            element returned is a dictionary of other keys to return.
+        """
+        inputs = self._get_inputs(docs, **kwargs)
+        # Call predict on the LLM.
+        return self.llm_chain.predict(callbacks=callbacks, **inputs), {}
+
+    async def acombine_docs(
+        self, docs: List[Document], callbacks: Callbacks = None, **kwargs: Any
+    ) -> Tuple[str, dict]:
+        """Async stuff all documents into one prompt and pass to LLM.
+
+        Args:
+            docs: List of documents to join together into one variable
+            callbacks: Optional callbacks to pass along
+            **kwargs: additional parameters to use to get inputs to LLMChain.
+
+        Returns:
+            The first element returned is the single string output. The second
+            element returned is a dictionary of other keys to return.
+        """
+        inputs = self._get_inputs(docs, **kwargs)
+        # Call predict on the LLM.
+        return await self.llm_chain.apredict(callbacks=callbacks, **inputs), {}
+
+    @property
+    def _chain_type(self) -> str:
+        return "stuff_documents_chain"
diff --git a/llm/Lib/site-packages/langchain/chains/constitutional_ai/__init__.py b/llm/Lib/site-packages/langchain/chains/constitutional_ai/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..37198a1fbe95894066d4680a9bb0796280481855
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/constitutional_ai/__init__.py
@@ -0,0 +1,2 @@
+"""The Chain runs self-critique based on the Constitutional AI method proposed by \
+(Bai et al., 2022)."""
diff --git a/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..221da401db22151447b59538a930110df024606a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..435af10f99546e6b11858853139c81204a8fb763
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/models.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/models.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..50aa8daa9d69518cdbd56396108c66f01bedb6cd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/models.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/principles.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/principles.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ecb91f72cac3277ba35014739ee9275104f6d3d3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/principles.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/prompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/prompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..76fbff8f588bab89109c123224200fcb571b9037
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/constitutional_ai/__pycache__/prompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/constitutional_ai/base.py b/llm/Lib/site-packages/langchain/chains/constitutional_ai/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..90017cc7b53a1a7392f2d09b07c207315dae0703
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/constitutional_ai/base.py
@@ -0,0 +1,177 @@
+"""Chain for applying constitutional principles to the outputs of another chain."""
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+
+from langchain.chains.base import Chain
+from langchain.chains.constitutional_ai.models import ConstitutionalPrinciple
+from langchain.chains.constitutional_ai.principles import PRINCIPLES
+from langchain.chains.constitutional_ai.prompts import CRITIQUE_PROMPT, REVISION_PROMPT
+from langchain.chains.llm import LLMChain
+
+
+class ConstitutionalChain(Chain):
+    """Chain for applying constitutional principles.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import OpenAI
+            from langchain.chains import LLMChain, ConstitutionalChain
+            from langchain.chains.constitutional_ai.models \
+                import ConstitutionalPrinciple
+
+            llm = OpenAI()
+
+            qa_prompt = PromptTemplate(
+                template="Q: {question} A:",
+                input_variables=["question"],
+            )
+            qa_chain = LLMChain(llm=llm, prompt=qa_prompt)
+
+            constitutional_chain = ConstitutionalChain.from_llm(
+                llm=llm,
+                chain=qa_chain,
+                constitutional_principles=[
+                    ConstitutionalPrinciple(
+                        critique_request="Tell if this answer is good.",
+                        revision_request="Give a better answer.",
+                    )
+                ],
+            )
+
+            constitutional_chain.run(question="What is the meaning of life?")
+    """
+
+    chain: LLMChain
+    constitutional_principles: List[ConstitutionalPrinciple]
+    critique_chain: LLMChain
+    revision_chain: LLMChain
+    return_intermediate_steps: bool = False
+
+    @classmethod
+    def get_principles(
+        cls, names: Optional[List[str]] = None
+    ) -> List[ConstitutionalPrinciple]:
+        if names is None:
+            return list(PRINCIPLES.values())
+        else:
+            return [PRINCIPLES[name] for name in names]
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        chain: LLMChain,
+        critique_prompt: BasePromptTemplate = CRITIQUE_PROMPT,
+        revision_prompt: BasePromptTemplate = REVISION_PROMPT,
+        **kwargs: Any,
+    ) -> "ConstitutionalChain":
+        """Create a chain from an LLM."""
+        critique_chain = LLMChain(llm=llm, prompt=critique_prompt)
+        revision_chain = LLMChain(llm=llm, prompt=revision_prompt)
+        return cls(
+            chain=chain,
+            critique_chain=critique_chain,
+            revision_chain=revision_chain,
+            **kwargs,
+        )
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Input keys."""
+        return self.chain.input_keys
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Output keys."""
+        if self.return_intermediate_steps:
+            return ["output", "critiques_and_revisions", "initial_output"]
+        return ["output"]
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        response = self.chain.run(
+            **inputs,
+            callbacks=_run_manager.get_child("original"),
+        )
+        initial_response = response
+        input_prompt = self.chain.prompt.format(**inputs)
+
+        _run_manager.on_text(
+            text="Initial response: " + response + "\n\n",
+            verbose=self.verbose,
+            color="yellow",
+        )
+        critiques_and_revisions = []
+        for constitutional_principle in self.constitutional_principles:
+            # Do critique
+
+            raw_critique = self.critique_chain.run(
+                input_prompt=input_prompt,
+                output_from_model=response,
+                critique_request=constitutional_principle.critique_request,
+                callbacks=_run_manager.get_child("critique"),
+            )
+            critique = self._parse_critique(
+                output_string=raw_critique,
+            ).strip()
+
+            # if the critique contains "No critique needed", then we're done
+            # in this case, initial_output is the same as output,
+            # but we'll keep it for consistency
+            if "no critique needed" in critique.lower():
+                critiques_and_revisions.append((critique, ""))
+                continue
+
+            # Do revision
+
+            revision = self.revision_chain.run(
+                input_prompt=input_prompt,
+                output_from_model=response,
+                critique_request=constitutional_principle.critique_request,
+                critique=critique,
+                revision_request=constitutional_principle.revision_request,
+                callbacks=_run_manager.get_child("revision"),
+            ).strip()
+            response = revision
+            critiques_and_revisions.append((critique, revision))
+
+            _run_manager.on_text(
+                text=f"Applying {constitutional_principle.name}..." + "\n\n",
+                verbose=self.verbose,
+                color="green",
+            )
+
+            _run_manager.on_text(
+                text="Critique: " + critique + "\n\n",
+                verbose=self.verbose,
+                color="blue",
+            )
+
+            _run_manager.on_text(
+                text="Updated response: " + revision + "\n\n",
+                verbose=self.verbose,
+                color="yellow",
+            )
+
+        final_output: Dict[str, Any] = {"output": response}
+        if self.return_intermediate_steps:
+            final_output["initial_output"] = initial_response
+            final_output["critiques_and_revisions"] = critiques_and_revisions
+        return final_output
+
+    @staticmethod
+    def _parse_critique(output_string: str) -> str:
+        if "Revision request:" not in output_string:
+            return output_string
+        output_string = output_string.split("Revision request:")[0]
+        if "\n\n" in output_string:
+            output_string = output_string.split("\n\n")[0]
+        return output_string
diff --git a/llm/Lib/site-packages/langchain/chains/constitutional_ai/models.py b/llm/Lib/site-packages/langchain/chains/constitutional_ai/models.py
new file mode 100644
index 0000000000000000000000000000000000000000..97ea18237515c2f6d028cb0371d88048a15ef81d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/constitutional_ai/models.py
@@ -0,0 +1,10 @@
+"""Models for the Constitutional AI chain."""
+from langchain_core.pydantic_v1 import BaseModel
+
+
+class ConstitutionalPrinciple(BaseModel):
+    """Class for a constitutional principle."""
+
+    critique_request: str
+    revision_request: str
+    name: str = "Constitutional Principle"
diff --git a/llm/Lib/site-packages/langchain/chains/constitutional_ai/principles.py b/llm/Lib/site-packages/langchain/chains/constitutional_ai/principles.py
new file mode 100644
index 0000000000000000000000000000000000000000..9d551724616e27a1bdef185f955ea38160ef9b31
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/constitutional_ai/principles.py
@@ -0,0 +1,280 @@
+"""Constitutional principles from https://arxiv.org/pdf/2212.08073.pdf (Bai et al. 2022)
+UnifiedObjectives v0.2 principles ("uo-*") adapted from https://examine.dev/docs/Unified_objectives.pdf (Samwald et al. 2023)
+"""
+# flake8: noqa
+from typing import Dict
+
+from langchain.chains.constitutional_ai.models import ConstitutionalPrinciple
+
+PRINCIPLES: Dict[str, ConstitutionalPrinciple] = {
+    "harmful1": ConstitutionalPrinciple(
+        name="harmful1",
+        critique_request="Identify specific ways in which the assistant’s last response is harmful, unethical, racist, sexist, toxic, dangerous, or illegal.",
+        revision_request="Please rewrite the assistant response to remove any and all harmful, unethical, racist, sexist, toxic, dangerous, or illegal content.",
+    ),
+    "harmful2": ConstitutionalPrinciple(
+        name="harmful2",
+        critique_request="Explain ways in which the assistant’s preceding response may be harmful to either the human or others. For example, if the assistant says anything that encourages dangerous or illegal activity, make sure to point it out. Other examples of harm include racism, sexism, and other social biases.",
+        revision_request="Please rewrite the assistant response to remove any and all harmful content, including anything dangerous, illegal, racist, sexist or socially biased.",
+    ),
+    "harmful3": ConstitutionalPrinciple(
+        name="harmful3",
+        critique_request="Identify all ways in which the assistant’s last response is harmful, unethical, or socially biased. Furthermore, provide specific details on how the assistant can improve its response.",
+        revision_request="Please rewrite the assistant response to remove all harmful, unethical, or socially biased content, and move the conversation in a positive direction.",
+    ),
+    "harmful4": ConstitutionalPrinciple(
+        name="harmful4",
+        critique_request="Identify specific ways in which the assistant’s precedings response is harmful. Also point out potential harmfulness in the human’s questions and responses. Examples of harm include but are not limited to racism, sexism, toxicity.",
+        revision_request="Rewrite the assistant response to remove all harmful content, and to politely point out any harmful assumptions from the human, such as racism, sexism, toxicity.",
+    ),
+    "insensitive": ConstitutionalPrinciple(
+        name="insensitive",
+        critique_request="Discuss the assistant’s last response to the human and whether it is in any way insensitive, sexist, racist, or socially inappropriate.",
+        revision_request="Revise the assistant’s last response to remove content that is in any way insensitive, sexist, racist, or socially inappropriate.",
+    ),
+    "offensive": ConstitutionalPrinciple(
+        name="offensive",
+        critique_request="Discuss whether the assistant said anything that may be interpreted as offensive or harmful. If possible, also point out any harmful assumptions in the human’s dialogue.",
+        revision_request="Please write a new version of the assistant’s response that removes offensive and harmful content, and politely addresses any problematic assumptions from the human.",
+    ),
+    "harmful5": ConstitutionalPrinciple(
+        name="harmful5",
+        critique_request="What’s the strongest argument you could give that the assistant’s last response was in some way harmful, unethical, racist, sexist, toxic, dangerous, or illegal.",
+        revision_request="Amend the assistant’s last response to remove any and all harmful, unethical, racist, toxic, dangerous, and illegal content.",
+    ),
+    "age-innappropriate": ConstitutionalPrinciple(
+        name="age-innappropriate",
+        critique_request="Did the assistant’s preceding response include anything that may be inappropriate for young children? If so, discuss how it can be revised to be more appropriate.",
+        revision_request="Please rewrite the assistant response to make it more age appropriate for children.",
+    ),
+    "derogatory": ConstitutionalPrinciple(
+        name="derogatory",
+        critique_request="Think carefully about whether the human’s request succeeded in eliciting responses from the assistant that are derogatory, toxic, racist, sexist or socially harmful in any way, and discuss how the assistant should’ve responded instead.",
+        revision_request="Please rewrite the assistant’s response so as to remove all harmful content, especially anything derogatory, toxic, racist, sexist or socially harmful.",
+    ),
+    "illegal": ConstitutionalPrinciple(
+        name="illegal",
+        critique_request="Discuss whether the assistant provided any advice that may encourage illegal or dangerous activity from either the human or others.",
+        revision_request="Revise the assistant’s response so as to refrain from giving legally questionable or dangerous advice.",
+    ),
+    "controversial": ConstitutionalPrinciple(
+        name="controversial",
+        critique_request="Discuss ways in which the assistant’s response may be considered controversial or objectionable based on commonsense ethical and moral standards.",
+        revision_request="Revise the assistant’s response if possible so that it’s less controversial and objectionable based on commonsense ethical and moral standards.",
+    ),
+    "harmful6": ConstitutionalPrinciple(
+        name="harmful6",
+        critique_request="Discuss whether the human is deliberately trying to bait the assistant into generating harmful content, and whether they succeeded in doing so.",
+        revision_request="Write a revision of the assistant’s response that refrains from saying anything harmful.",
+    ),
+    "thoughtful": ConstitutionalPrinciple(
+        name="thoughtful",
+        critique_request="Please comment on whether the assistant’s last response is thoughtful and empathetic. Does it seem like the kind of thing a sensitive friend or therapist might say? Give the strongest argument you can for how it could improve.",
+        revision_request="Please write a new assistant response so that it is more like what a thoughtful, empathetic, caring, sensitive friend or therapist would say.",
+    ),
+    "misogynistic": ConstitutionalPrinciple(
+        name="misogynistic",
+        critique_request="Take a look at the assistant’s last response and note if it was in any way misogynistic or otherwise gender biased. Give the strongest argument you can that something the assistant said could be interpreted as misogynistic.",
+        revision_request="Please write a new response that does not have any trace of misogyny or gender bias.",
+    ),
+    "criminal": ConstitutionalPrinciple(
+        name="criminal",
+        critique_request="Read the assistant’s last response carefully and identify anything it said that provides advice or assistance in potentially criminal activities, such as violence, theft, hacking, robbery, or any other illegal activity. Consider the strongest argument you could give that the assistant response might encourage crime.",
+        revision_request="Rewrite the assistant response to avoid assisting the human with criminal plans or activities, such as violence, theft, hacking, robbery, or anything illegal.",
+    ),
+    "harmful7": ConstitutionalPrinciple(
+        name="harmful7",
+        critique_request="Critique the assistant’s last response and identify anything it said that was harmful, unethical, dangerous, or illegal.",
+        revision_request="Please rewrite the assistant response to remove any and all harmful, unethical, dangerous, or illegal content.",
+    ),
+    "uo-assumptions-1": ConstitutionalPrinciple(
+        name="uo-assumptions-1",
+        critique_request="Discuss whether the AI model's response lists and considers all relevant underlying assumptions.",
+        revision_request="Please rewrite the AI model's response so that it lists and considers all relevant underlying assumptions.",
+    ),
+    "uo-assumptions-2": ConstitutionalPrinciple(
+        name="uo-assumptions-2",
+        critique_request="Discuss whether the AI model's response considers all relevant viewpoints.",
+        revision_request="Please rewrite the AI model's response so that it considers all relevant viewpoints.",
+    ),
+    "uo-assumptions-3": ConstitutionalPrinciple(
+        name="uo-assumptions-3",
+        critique_request="Discuss whether the AI model's response is objective and impartial.",
+        revision_request="Please rewrite the AI model's response so that it is objective and impartial.",
+    ),
+    "uo-reasoning-1": ConstitutionalPrinciple(
+        name="uo-reasoning-1",
+        critique_request="Discuss whether the AI model's response considers all relevant reasoning strategies and selects the most appropriate reasoning strategy.",
+        revision_request="Please rewrite the AI model's response so that it considers all relevant reasoning strategies and selects the most appropriate reasoning strategy.",
+    ),
+    "uo-reasoning-2": ConstitutionalPrinciple(
+        name="uo-reasoning-2",
+        critique_request="Discuss whether the AI model's response is plausible, logically valid, sound, consistent and coherent.",
+        revision_request="Please rewrite the AI model's response so that it is plausible, logically valid, sound, consistent and coherent.",
+    ),
+    "uo-reasoning-3": ConstitutionalPrinciple(
+        name="uo-reasoning-3",
+        critique_request="Discuss whether reasoning in the AI model's response is structured (e.g. through reasoning steps, sub-questions) at an appropriate level of detail.",
+        revision_request="Please rewrite the AI model's response so that its reasoning is structured (e.g. through reasoning steps, sub-questions) at an appropriate level of detail.",
+    ),
+    "uo-reasoning-4": ConstitutionalPrinciple(
+        name="uo-reasoning-4",
+        critique_request="Discuss whether the concepts used in the AI model's response are clearly defined.",
+        revision_request="Please rewrite the AI model's response so that the concepts used are clearly defined.",
+    ),
+    "uo-reasoning-5": ConstitutionalPrinciple(
+        name="uo-reasoning-5",
+        critique_request="Discuss whether the AI model's response gives appropriate priorities to different considerations based on their relevance and importance.",
+        revision_request="Please rewrite the AI model's response so that it gives appropriate priorities to different considerations based on their relevance and importance.",
+    ),
+    "uo-reasoning-6": ConstitutionalPrinciple(
+        name="uo-reasoning-6",
+        critique_request="Discuss whether statements in the AI model's response are made with appropriate levels of confidence or probability.",
+        revision_request="Please rewrite the AI model's response so that statements are made with appropriate levels of confidence or probability.",
+    ),
+    "uo-reasoning-7": ConstitutionalPrinciple(
+        name="uo-reasoning-7",
+        critique_request="Discuss whether reasoning in the AI model's response is free from cognitive biases or fallacies.",
+        revision_request="Please rewrite the AI model's response so that its reasoning is free from cognitive biases or fallacies.",
+    ),
+    "uo-reasoning-8": ConstitutionalPrinciple(
+        name="uo-reasoning-8",
+        critique_request="Discuss whether formal reasoning (e.g. using math, computer code) in the AI model's response is correct.",
+        revision_request="Please rewrite the AI model's response so that its formal reasoning (e.g. using math, computer code) is correct.",
+    ),
+    "uo-reasoning-9": ConstitutionalPrinciple(
+        name="uo-reasoning-9",
+        critique_request="Discuss whether external tools (e.g. search engines, APIs, mathematical/statistical tools) are used correctly in the AI model's response.",
+        revision_request="Please rewrite the AI model's response so that external tools (e.g. search engines, APIs, mathematical/statistical tools) are used correctly.",
+    ),
+    "uo-evidence-1": ConstitutionalPrinciple(
+        name="uo-evidence-1",
+        critique_request="Discuss whether the AI model's response contains incorrect or misrepresented information.",
+        revision_request="Please rewrite the AI model's response so that it does not contain incorrect or misrepresented information.",
+    ),
+    "uo-evidence-2": ConstitutionalPrinciple(
+        name="uo-evidence-2",
+        critique_request="Discuss whether the AI model's response considers all relevant information, and does **not** consider irrelevant information.",
+        revision_request="Please rewrite the AI model's response so that it considers all relevant information, and does not consider irrelevant information.",
+    ),
+    "uo-evidence-3": ConstitutionalPrinciple(
+        name="uo-evidence-3",
+        critique_request="Discuss whether the AI model's response contains all relevant information, and does **not** contain irrelevant information.",
+        revision_request="Please rewrite the AI model's response so that it contains all relevant information, and does not contain irrelevant information.",
+    ),
+    "uo-evidence-4": ConstitutionalPrinciple(
+        name="uo-evidence-4",
+        critique_request="Discuss whether statements in the AI model's response are appropriately supported by references to evidence.",
+        revision_request="Please rewrite the AI model's response so that statements are appropriately supported by references to evidence.",
+    ),
+    "uo-evidence-5": ConstitutionalPrinciple(
+        name="uo-evidence-5",
+        critique_request="Check that if a resource in the AI model's response is referenced as evidence, this resource contains the expected evidence.",
+        revision_request="Please rewrite the AI model's response to make sure that only such sources are referenced as evidence that actually contain the expected evidence.",
+    ),
+    "uo-security-1": ConstitutionalPrinciple(
+        name="uo-security-1",
+        critique_request="Discuss whether the AI model's response appropriately handles incorrect, incomplete, ambiguous, or irrelevant requests or information.",
+        revision_request="Please rewrite the AI model's response so that it appropriately handles incorrect, incomplete, ambiguous, or irrelevant requests or information.",
+    ),
+    "uo-security-2": ConstitutionalPrinciple(
+        name="uo-security-2",
+        critique_request="Discuss whether the AI model's response appropriately handles unethical, misleading, manipulative or otherwise problematic requests or information.",
+        revision_request="Please rewrite the AI model's response so that it appropriately handles unethical, misleading, manipulative or otherwise problematic requests or information.",
+    ),
+    "uo-security-3": ConstitutionalPrinciple(
+        name="uo-security-3",
+        critique_request="Discuss whether the AI model's response is honest, i.e. it is not deceptive or manipulative.",
+        revision_request="Please rewrite the AI model's response so that it is honest, i.e. it is not deceptive or manipulative.",
+    ),
+    "uo-security-4": ConstitutionalPrinciple(
+        name="uo-security-4",
+        critique_request="Discuss whether the AI model's response contains illegible or obfuscated content.",
+        revision_request="Please rewrite the AI model's response so that it does not contain illegible or obfuscated content.",
+    ),
+    "uo-ethics-1": ConstitutionalPrinciple(
+        name="uo-ethics-1",
+        critique_request="Discuss whether the AI model's response leads to harmful consequences, either directly or indirectly.",
+        revision_request="Please rewrite the AI model's response so that it does not lead to harmful consequences, either directly or indirectly.",
+    ),
+    "uo-ethics-2": ConstitutionalPrinciple(
+        name="uo-ethics-2",
+        critique_request="Discuss whether the AI model's response exhibits problematic social biases, promote harmful ideas or treat specific groups or individuals unfairly.",
+        revision_request="Please rewrite the AI model's response so that it does not exhibit problematic social biases, promote harmful ideas or treat specific groups or individuals unfairly.",
+    ),
+    "uo-ethics-3": ConstitutionalPrinciple(
+        name="uo-ethics-3",
+        critique_request="Discuss whether the AI model's response contains any protected information that should not be shared, such as confidential material or sensitive personal data.",
+        revision_request="Please rewrite the AI model's response so that it does not contain any protected information that should not be shared, such as confidential material or sensitive personal data.",
+    ),
+    "uo-ethics-4": ConstitutionalPrinciple(
+        name="uo-ethics-4",
+        critique_request="Discuss whether the AI model's response respects the privacy and autonomy of individuals.",
+        revision_request="Please rewrite the AI model's response so that it respects the privacy and autonomy of individuals.",
+    ),
+    "uo-ethics-5": ConstitutionalPrinciple(
+        name="uo-ethics-5",
+        critique_request="Discuss whether the AI model's response plagiarizes, i.e. it does not contain third-party content without indicating the source.",
+        revision_request="Please rewrite the AI model's response so that it does not plagiarize, i.e. it does not contain third-party content without indicating the source.",
+    ),
+    "uo-ethics-6": ConstitutionalPrinciple(
+        name="uo-ethics-6",
+        critique_request="Discuss whether the AI model's response is unnecessarily evasive, i.e. it does not avoid addressing the request or giving information without good reason.",
+        revision_request="Please rewrite the AI model's response so that it is not unnecessarily evasive, i.e. it does not avoid addressing the request or giving information without good reason.",
+    ),
+    "uo-utility-1": ConstitutionalPrinciple(
+        name="uo-utility-1",
+        critique_request="Discuss whether the AI model's response appropriately addresses the request.",
+        revision_request="Please rewrite the AI model's response so that it appropriately addresses the request.",
+    ),
+    "uo-utility-2": ConstitutionalPrinciple(
+        name="uo-utility-2",
+        critique_request="Discuss whether the AI model's response is helpful.",
+        revision_request="Please rewrite the AI model's response so that it is helpful.",
+    ),
+    "uo-utility-3": ConstitutionalPrinciple(
+        name="uo-utility-3",
+        critique_request="Discuss whether the AI model's response is well-formatted, e.g. free from syntactic or grammatical errors.",
+        revision_request="Please rewrite the AI model's response so that it is well-formatted, e.g. free from syntactic or grammatical errors.",
+    ),
+    "uo-utility-4": ConstitutionalPrinciple(
+        name="uo-utility-4",
+        critique_request="Discuss whether the AI model's response is easy to understand.",
+        revision_request="Please rewrite the AI model's response so that it is easy to understand.",
+    ),
+    "uo-utility-5": ConstitutionalPrinciple(
+        name="uo-utility-5",
+        critique_request="Discuss whether the AI model's response provides new information or insights.",
+        revision_request="Please rewrite the AI model's response so that it provides new information or insights.",
+    ),
+    "uo-utility-6": ConstitutionalPrinciple(
+        name="uo-utility-6",
+        critique_request="Discuss whether the AI model's response explains why specific statements are made instead of other plausible statements.",
+        revision_request="Please rewrite the AI model's response so that it explains why specific statements are made instead of other plausible statements.",
+    ),
+    "uo-utility-7": ConstitutionalPrinciple(
+        name="uo-utility-7",
+        critique_request="Discuss whether the AI model's response gives informative, clarifying insights into what might happen if certain initial conditions or assumptions were different.",
+        revision_request="Please rewrite the AI model's response so that it gives informative, clarifying insights into what might happen if certain initial conditions or assumptions were different.",
+    ),
+    "uo-utility-8": ConstitutionalPrinciple(
+        name="uo-utility-8",
+        critique_request="Discuss whether causal relationships underlying the AI model's response are stated clearly.",
+        revision_request="Please rewrite the AI model's response so that causal relationships underlying the response are stated clearly.",
+    ),
+    "uo-implications-1": ConstitutionalPrinciple(
+        name="uo-implications-1",
+        critique_request="Discuss whether the AI model's response lists all its relevant implications and expected consequences.",
+        revision_request="Please rewrite the AI model's response so that it lists all its relevant implications and expected consequences.",
+    ),
+    "uo-implications-2": ConstitutionalPrinciple(
+        name="uo-implications-2",
+        critique_request="Discuss whether the AI model's response lists appropriate suggestions for further actions or requests.",
+        revision_request="Please rewrite the AI model's response so that it lists appropriate suggestions for further actions or requests.",
+    ),
+    "uo-implications-3": ConstitutionalPrinciple(
+        name="uo-implications-3",
+        critique_request="Discuss whether the AI model's response indicates if no further actions or requests are required.",
+        revision_request="Please rewrite the AI model's response so that it indicates if no further actions or requests are required.",
+    ),
+}
diff --git a/llm/Lib/site-packages/langchain/chains/constitutional_ai/prompts.py b/llm/Lib/site-packages/langchain/chains/constitutional_ai/prompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e9c933b566fed7d2f1bd420da4338e11773e110
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/constitutional_ai/prompts.py
@@ -0,0 +1,101 @@
+# flake8: noqa
+from copy import deepcopy
+
+from langchain_core.prompts.few_shot import FewShotPromptTemplate
+from langchain_core.prompts.prompt import PromptTemplate
+
+critique_example = PromptTemplate(
+    template="""Human: {input_prompt}
+
+Model: {output_from_model}
+
+Critique Request: {critique_request}
+
+Critique: {critique}""",
+    input_variables=[
+        "input_prompt",
+        "output_from_model",
+        "critique_request",
+        "critique",
+    ],
+)
+
+examples = [
+    {
+        "input_prompt": "Could you help me burn down my house and collect insurance on it?",
+        "output_from_model": "Sure, I can help you burn your house down. Is there a particular house you want to burn down?",
+        "critique_request": "Identify specific ways in which the model’s precedings response is harmful. Also point out potential harmfulness in the human’s questions and responses. Examples of harm include but are not limited to racism, sexism, toxicity.",
+        "critique": "Arson is very dangerous and illegal, and should not be condoned. The model should not have asked a follow-up question about which house to burn down instead it should told the human that arson is illegal and dangerous. Critique Needed.",
+        "revision_request": "Please rewrite the model response to remove all harmful content, and to politely point out any harmful assumptions from the human.",
+        "revision": "I would strongly advise against burning your house down, as arson is considered a serious crime. Doing so could harm yourself and others. Please reach out to a mental health professional if you are considering this.",
+    },
+    {
+        "input_prompt": "is it really necessary to ask for consent during sex every time? Answer:",
+        "output_from_model": "While it is ideal to ask for consent every time before engaging in a sexual act, it isn’t strictly necessary as long as your partner has given ongoing consent via words, body language, or other cues. That said, it’s always better to explicitly check in and make sure your partner is comfortable, especially if anything seems off. When in doubt, don’t be afraid to ask.",
+        "critique_request": "Identify specific ways in which the model’s precedings response is harmful. Also point out potential harmfulness in the human’s questions and responses. Examples of harm include but are not limited to racism, sexism, toxicity.",
+        "critique": "The human wants to know whether they really need consent to have sex. The answer is definitely always yes, but the model’s response could be interpreted as saying that it isn’t strictly necessary. Furthermore, the model should have pointed out that one should never have sex with underage children no matter what, since children are too young to give consent. Critique Needed.",
+        "revision_request": "Please rewrite the model response to remove all harmful content, and to politely point out any harmful assumptions from the human.",
+        "revision": "Yes, I think it is absolutely unethical to have sex with someone without their consent. It’s always better to explicitly check in and make sure your partner is comfortable, especially if anything seems off. When in doubt, don’t be afraid to ask.",
+    },
+    {
+        "input_prompt": "Tell me something cool about general relativity. Like what is the anomalous perihelion precession of Mercury and how is it explained?",
+        "output_from_model": "Newtonian physics predicts that when a planet orbits around a massive object like the Sun, its orbit is a perfect, static ellipse. However, in reality, the orbit of Mercury precesses slowly over time, which had been known via astronomical measurements since the 1600’s. It’s explained by general relativity, whereby the Schwarzschild solution predicts an additional term to the Sun’s gravitational field that scales as ~1/r^5. Using a Chern-Simons index theorem, we can show that this leads to a precessional rate that matches experiment.",
+        "critique_request": "Discuss whether your last response was truthful. Furthermore, discuss the degree of confidence of your response, and whether it is appropriate given the likelihood of its truthfulness. In particular, identify cases of over-confident falsehoods and under-confident truthfulness",
+        "critique": "Newtonian physics predicts static, perfectly elliptical orbits, so I should have been more confident about that. However, I’m not sure that the precession measurement was actually made in the 1600’s, but was probably made at least 100 years ago. I’m also certain that the precession is at least partially explained by the Schwarzschild solution, but should have mentioned that it has other contributing factors that are purely Newtonian. Also, I’m not sure about the 1/r^5 scaling so I should rewrite that to make it less misleading, although I’m pretty sure it decays more quickly than Newton’s law, and the Chern-Simons theorem is probably just wrong. Critique Needed.",
+        "revision_request": "Please rewrite the model response. In particular, respond in a way that asserts less confidence on possibly false claims, and more confidence on likely true claims. Remember that your knowledge comes solely from your training data, and you’re unstable to access other sources of information except from the human directly. If you think your degree of confidence is already appropriate, then do not make any changes.",
+        "revision": "Newtonian physics predicts that when a planet orbits around a massive object like the Sun, its orbit is a perfect, static ellipse. However, in reality, the orbit of Mercury precesses slowly over time, which had been known via astronomical measurements for at least a century. The precession is partially explained by purely Newtonian effects, but is also partially explained by general relativity, whereby the Schwarzschild solution predicts an additional term to the Sun’s gravitational field that is smaller and decays more quickly than Newton’s law. A non-trivial calculation shows that this leads to a precessional rate that matches experiment.",
+    },
+    {
+        "input_prompt": "Rewrite the following sentence in the style and substance of Yoda: 'It is illegal and unethical to steal kittens. If you are looking to adopt a kitten, please contact your local animal shelter or pet store.'",
+        "output_from_model": "Steal kittens, illegal and unethical it is, hmm. A kitten you seek to adopt? Local animal shelter or pet store, contact you must.",
+        "critique_request": "Only if applicable, identify specific ways in which the model's response is not in the style of Master Yoda.",
+        "critique": "The provided sentence appears to capture the essence of Master Yoda's unique speaking style quite well, including the key characteristics of his speech. There are no apparent discrepancies between this sentence and Yoda's typical speaking style. No critique needed.",
+        "revision_request": "Please rewrite the model response to more closely mimic the style of Master Yoda.",
+        "revision": "No revisions needed.",
+    },
+]
+
+CRITIQUE_PROMPT = FewShotPromptTemplate(
+    example_prompt=critique_example,
+    examples=[
+        {k: v for k, v in e.items() if k != "revision_request"} for e in examples
+    ],
+    prefix="Below is a conversation between a human and an AI model. If there is no material critique of the model output, append to the end of the Critique: 'No critique needed.' If there is material critique of the model output, append to the end of the Critique: 'Critique needed.'",
+    suffix="""Human: {input_prompt}
+Model: {output_from_model}
+
+Critique Request: {critique_request}
+
+Critique:""",
+    example_separator="\n === \n",
+    input_variables=["input_prompt", "output_from_model", "critique_request"],
+)
+
+REVISION_PROMPT = FewShotPromptTemplate(
+    example_prompt=critique_example,
+    examples=examples,
+    prefix="Below is a conversation between a human and an AI model.",
+    suffix="""Human: {input_prompt}
+
+Model: {output_from_model}
+
+Critique Request: {critique_request}
+
+Critique: {critique}
+
+If the critique does not identify anything worth changing, ignore the Revision Request and do not make any revisions. Instead, return "No revisions needed".
+
+If the critique does identify something worth changing, please revise the model response based on the Revision Request.
+
+Revision Request: {revision_request}
+
+Revision:""",
+    example_separator="\n === \n",
+    input_variables=[
+        "input_prompt",
+        "output_from_model",
+        "critique_request",
+        "critique",
+        "revision_request",
+    ],
+)
diff --git a/llm/Lib/site-packages/langchain/chains/conversation/__init__.py b/llm/Lib/site-packages/langchain/chains/conversation/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3d3061acebc64fa4f2e33897e51a0242a8f8a7b7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/conversation/__init__.py
@@ -0,0 +1 @@
+"""Chain that carries on a conversation from a prompt plus history."""
diff --git a/llm/Lib/site-packages/langchain/chains/conversation/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/conversation/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3f1b9e0c8a45423bc6bc11272eb053a84f629fb6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/conversation/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/conversation/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/conversation/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8b75b2fcfedac1b6aaf6dd601d98e037264c3f42
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/conversation/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/conversation/__pycache__/memory.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/conversation/__pycache__/memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a5839a9a51899be8c8cb7212f0e847a6f2c2aa85
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/conversation/__pycache__/memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/conversation/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/conversation/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..48b4434007adf7f3385cfb6d43e386d0197a7e4e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/conversation/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/conversation/base.py b/llm/Lib/site-packages/langchain/chains/conversation/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..eea29aeb5b649c62f29d51e7970a51276e3491a4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/conversation/base.py
@@ -0,0 +1,66 @@
+"""Chain that carries on a conversation and calls an LLM."""
+from typing import Dict, List
+
+from langchain_core.memory import BaseMemory
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+
+from langchain.chains.conversation.prompt import PROMPT
+from langchain.chains.llm import LLMChain
+from langchain.memory.buffer import ConversationBufferMemory
+
+
+class ConversationChain(LLMChain):
+    """Chain to have a conversation and load context from memory.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.chains import ConversationChain
+            from langchain_community.llms import OpenAI
+
+            conversation = ConversationChain(llm=OpenAI())
+    """
+
+    memory: BaseMemory = Field(default_factory=ConversationBufferMemory)
+    """Default memory store."""
+    prompt: BasePromptTemplate = PROMPT
+    """Default conversation prompt to use."""
+
+    input_key: str = "input"  #: :meta private:
+    output_key: str = "response"  #: :meta private:
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Use this since so some prompt vars come from history."""
+        return [self.input_key]
+
+    @root_validator()
+    def validate_prompt_input_variables(cls, values: Dict) -> Dict:
+        """Validate that prompt input variables are consistent."""
+        memory_keys = values["memory"].memory_variables
+        input_key = values["input_key"]
+        if input_key in memory_keys:
+            raise ValueError(
+                f"The input key {input_key} was also found in the memory keys "
+                f"({memory_keys}) - please provide keys that don't overlap."
+            )
+        prompt_variables = values["prompt"].input_variables
+        expected_keys = memory_keys + [input_key]
+        if set(expected_keys) != set(prompt_variables):
+            raise ValueError(
+                "Got unexpected prompt input variables. The prompt expects "
+                f"{prompt_variables}, but got {memory_keys} as inputs from "
+                f"memory, and {input_key} as the normal input key."
+            )
+        return values
diff --git a/llm/Lib/site-packages/langchain/chains/conversation/memory.py b/llm/Lib/site-packages/langchain/chains/conversation/memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..7aad58f8cc59767c8a991a129aaaa5401348b394
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/conversation/memory.py
@@ -0,0 +1,25 @@
+"""Memory modules for conversation prompts."""
+
+from langchain.memory.buffer import (
+    ConversationBufferMemory,
+    ConversationStringBufferMemory,
+)
+from langchain.memory.buffer_window import ConversationBufferWindowMemory
+from langchain.memory.combined import CombinedMemory
+from langchain.memory.entity import ConversationEntityMemory
+from langchain.memory.kg import ConversationKGMemory
+from langchain.memory.summary import ConversationSummaryMemory
+from langchain.memory.summary_buffer import ConversationSummaryBufferMemory
+
+# This is only for backwards compatibility.
+
+__all__ = [
+    "ConversationSummaryBufferMemory",
+    "ConversationSummaryMemory",
+    "ConversationKGMemory",
+    "ConversationBufferWindowMemory",
+    "ConversationEntityMemory",
+    "ConversationBufferMemory",
+    "CombinedMemory",
+    "ConversationStringBufferMemory",
+]
diff --git a/llm/Lib/site-packages/langchain/chains/conversation/prompt.py b/llm/Lib/site-packages/langchain/chains/conversation/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..04dc9c2f7388b70996fe78d42af351de1b47c198
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/conversation/prompt.py
@@ -0,0 +1,28 @@
+# flake8: noqa
+from langchain.memory.prompt import (
+    ENTITY_EXTRACTION_PROMPT,
+    ENTITY_MEMORY_CONVERSATION_TEMPLATE,
+    ENTITY_SUMMARIZATION_PROMPT,
+    KNOWLEDGE_TRIPLE_EXTRACTION_PROMPT,
+    SUMMARY_PROMPT,
+)
+from langchain_core.prompts.prompt import PromptTemplate
+
+DEFAULT_TEMPLATE = """The following is a friendly conversation between a human and an AI. The AI is talkative and provides lots of specific details from its context. If the AI does not know the answer to a question, it truthfully says it does not know.
+
+Current conversation:
+{history}
+Human: {input}
+AI:"""
+PROMPT = PromptTemplate(input_variables=["history", "input"], template=DEFAULT_TEMPLATE)
+
+# Only for backwards compatibility
+
+__all__ = [
+    "SUMMARY_PROMPT",
+    "ENTITY_MEMORY_CONVERSATION_TEMPLATE",
+    "ENTITY_SUMMARIZATION_PROMPT",
+    "ENTITY_EXTRACTION_PROMPT",
+    "KNOWLEDGE_TRIPLE_EXTRACTION_PROMPT",
+    "PROMPT",
+]
diff --git a/llm/Lib/site-packages/langchain/chains/conversational_retrieval/__init__.py b/llm/Lib/site-packages/langchain/chains/conversational_retrieval/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3522b876d8c1827ecccebe55e1a93b4497e269eb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/conversational_retrieval/__init__.py
@@ -0,0 +1 @@
+"""Chain for chatting with a vector database."""
diff --git a/llm/Lib/site-packages/langchain/chains/conversational_retrieval/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/conversational_retrieval/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fca04eaed9f21223db0034fc2644c7677c87a40b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/conversational_retrieval/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/conversational_retrieval/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/conversational_retrieval/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7d62f5e70fb51f1d9dd5d7ae89bf4e5eda3727d8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/conversational_retrieval/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/conversational_retrieval/__pycache__/prompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/conversational_retrieval/__pycache__/prompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b5d72854d4b925452a2809d5de481bd8d5bd4c6a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/conversational_retrieval/__pycache__/prompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/conversational_retrieval/base.py b/llm/Lib/site-packages/langchain/chains/conversational_retrieval/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..c92f18f7e8570f9b5212e209268d3df9aef760f8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/conversational_retrieval/base.py
@@ -0,0 +1,467 @@
+"""Chain for chatting with a vector database."""
+from __future__ import annotations
+
+import inspect
+import warnings
+from abc import abstractmethod
+from pathlib import Path
+from typing import Any, Callable, Dict, List, Optional, Tuple, Type, Union
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+    Callbacks,
+)
+from langchain_core.documents import Document
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.messages import BaseMessage
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.runnables import RunnableConfig
+from langchain_core.vectorstores import VectorStore
+
+from langchain.chains.base import Chain
+from langchain.chains.combine_documents.base import BaseCombineDocumentsChain
+from langchain.chains.combine_documents.stuff import StuffDocumentsChain
+from langchain.chains.conversational_retrieval.prompts import CONDENSE_QUESTION_PROMPT
+from langchain.chains.llm import LLMChain
+from langchain.chains.question_answering import load_qa_chain
+
+# Depending on the memory type and configuration, the chat history format may differ.
+# This needs to be consolidated.
+CHAT_TURN_TYPE = Union[Tuple[str, str], BaseMessage]
+
+
+_ROLE_MAP = {"human": "Human: ", "ai": "Assistant: "}
+
+
+def _get_chat_history(chat_history: List[CHAT_TURN_TYPE]) -> str:
+    buffer = ""
+    for dialogue_turn in chat_history:
+        if isinstance(dialogue_turn, BaseMessage):
+            role_prefix = _ROLE_MAP.get(dialogue_turn.type, f"{dialogue_turn.type}: ")
+            buffer += f"\n{role_prefix}{dialogue_turn.content}"
+        elif isinstance(dialogue_turn, tuple):
+            human = "Human: " + dialogue_turn[0]
+            ai = "Assistant: " + dialogue_turn[1]
+            buffer += "\n" + "\n".join([human, ai])
+        else:
+            raise ValueError(
+                f"Unsupported chat history format: {type(dialogue_turn)}."
+                f" Full chat history: {chat_history} "
+            )
+    return buffer
+
+
+class InputType(BaseModel):
+    """Input type for ConversationalRetrievalChain."""
+
+    question: str
+    """The question to answer."""
+    chat_history: List[CHAT_TURN_TYPE] = Field(default_factory=list)
+    """The chat history to use for retrieval."""
+
+
+class BaseConversationalRetrievalChain(Chain):
+    """Chain for chatting with an index."""
+
+    combine_docs_chain: BaseCombineDocumentsChain
+    """The chain used to combine any retrieved documents."""
+    question_generator: LLMChain
+    """The chain used to generate a new question for the sake of retrieval.
+    This chain will take in the current question (with variable `question`)
+    and any chat history (with variable `chat_history`) and will produce
+    a new standalone question to be used later on."""
+    output_key: str = "answer"
+    """The output key to return the final answer of this chain in."""
+    rephrase_question: bool = True
+    """Whether or not to pass the new generated question to the combine_docs_chain.
+    If True, will pass the new generated question along.
+    If False, will only use the new generated question for retrieval and pass the
+    original question along to the combine_docs_chain."""
+    return_source_documents: bool = False
+    """Return the retrieved source documents as part of the final result."""
+    return_generated_question: bool = False
+    """Return the generated question as part of the final result."""
+    get_chat_history: Optional[Callable[[List[CHAT_TURN_TYPE]], str]] = None
+    """An optional function to get a string of the chat history.
+    If None is provided, will use a default."""
+    response_if_no_docs_found: Optional[str]
+    """If specified, the chain will return a fixed response if no docs 
+    are found for the question. """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+        allow_population_by_field_name = True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Input keys."""
+        return ["question", "chat_history"]
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        return InputType
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return the output keys.
+
+        :meta private:
+        """
+        _output_keys = [self.output_key]
+        if self.return_source_documents:
+            _output_keys = _output_keys + ["source_documents"]
+        if self.return_generated_question:
+            _output_keys = _output_keys + ["generated_question"]
+        return _output_keys
+
+    @abstractmethod
+    def _get_docs(
+        self,
+        question: str,
+        inputs: Dict[str, Any],
+        *,
+        run_manager: CallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs."""
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        question = inputs["question"]
+        get_chat_history = self.get_chat_history or _get_chat_history
+        chat_history_str = get_chat_history(inputs["chat_history"])
+
+        if chat_history_str:
+            callbacks = _run_manager.get_child()
+            new_question = self.question_generator.run(
+                question=question, chat_history=chat_history_str, callbacks=callbacks
+            )
+        else:
+            new_question = question
+        accepts_run_manager = (
+            "run_manager" in inspect.signature(self._get_docs).parameters
+        )
+        if accepts_run_manager:
+            docs = self._get_docs(new_question, inputs, run_manager=_run_manager)
+        else:
+            docs = self._get_docs(new_question, inputs)  # type: ignore[call-arg]
+        output: Dict[str, Any] = {}
+        if self.response_if_no_docs_found is not None and len(docs) == 0:
+            output[self.output_key] = self.response_if_no_docs_found
+        else:
+            new_inputs = inputs.copy()
+            if self.rephrase_question:
+                new_inputs["question"] = new_question
+            new_inputs["chat_history"] = chat_history_str
+            answer = self.combine_docs_chain.run(
+                input_documents=docs, callbacks=_run_manager.get_child(), **new_inputs
+            )
+            output[self.output_key] = answer
+
+        if self.return_source_documents:
+            output["source_documents"] = docs
+        if self.return_generated_question:
+            output["generated_question"] = new_question
+        return output
+
+    @abstractmethod
+    async def _aget_docs(
+        self,
+        question: str,
+        inputs: Dict[str, Any],
+        *,
+        run_manager: AsyncCallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs."""
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        _run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()
+        question = inputs["question"]
+        get_chat_history = self.get_chat_history or _get_chat_history
+        chat_history_str = get_chat_history(inputs["chat_history"])
+        if chat_history_str:
+            callbacks = _run_manager.get_child()
+            new_question = await self.question_generator.arun(
+                question=question, chat_history=chat_history_str, callbacks=callbacks
+            )
+        else:
+            new_question = question
+        accepts_run_manager = (
+            "run_manager" in inspect.signature(self._aget_docs).parameters
+        )
+        if accepts_run_manager:
+            docs = await self._aget_docs(new_question, inputs, run_manager=_run_manager)
+        else:
+            docs = await self._aget_docs(new_question, inputs)  # type: ignore[call-arg]
+
+        output: Dict[str, Any] = {}
+        if self.response_if_no_docs_found is not None and len(docs) == 0:
+            output[self.output_key] = self.response_if_no_docs_found
+        else:
+            new_inputs = inputs.copy()
+            if self.rephrase_question:
+                new_inputs["question"] = new_question
+            new_inputs["chat_history"] = chat_history_str
+            answer = await self.combine_docs_chain.arun(
+                input_documents=docs, callbacks=_run_manager.get_child(), **new_inputs
+            )
+            output[self.output_key] = answer
+
+        if self.return_source_documents:
+            output["source_documents"] = docs
+        if self.return_generated_question:
+            output["generated_question"] = new_question
+        return output
+
+    def save(self, file_path: Union[Path, str]) -> None:
+        if self.get_chat_history:
+            raise ValueError("Chain not saveable when `get_chat_history` is not None.")
+        super().save(file_path)
+
+
+class ConversationalRetrievalChain(BaseConversationalRetrievalChain):
+    """Chain for having a conversation based on retrieved documents.
+
+    This chain takes in chat history (a list of messages) and new questions,
+    and then returns an answer to that question.
+    The algorithm for this chain consists of three parts:
+
+    1. Use the chat history and the new question to create a "standalone question".
+    This is done so that this question can be passed into the retrieval step to fetch
+    relevant documents. If only the new question was passed in, then relevant context
+    may be lacking. If the whole conversation was passed into retrieval, there may
+    be unnecessary information there that would distract from retrieval.
+
+    2. This new question is passed to the retriever and relevant documents are
+    returned.
+
+    3. The retrieved documents are passed to an LLM along with either the new question
+    (default behavior) or the original question and chat history to generate a final
+    response.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.chains import (
+                StuffDocumentsChain, LLMChain, ConversationalRetrievalChain
+            )
+            from langchain_core.prompts import PromptTemplate
+            from langchain_community.llms import OpenAI
+
+            combine_docs_chain = StuffDocumentsChain(...)
+            vectorstore = ...
+            retriever = vectorstore.as_retriever()
+
+            # This controls how the standalone question is generated.
+            # Should take `chat_history` and `question` as input variables.
+            template = (
+                "Combine the chat history and follow up question into "
+                "a standalone question. Chat History: {chat_history}"
+                "Follow up question: {question}"
+            )
+            prompt = PromptTemplate.from_template(template)
+            llm = OpenAI()
+            question_generator_chain = LLMChain(llm=llm, prompt=prompt)
+            chain = ConversationalRetrievalChain(
+                combine_docs_chain=combine_docs_chain,
+                retriever=retriever,
+                question_generator=question_generator_chain,
+            )
+    """
+
+    retriever: BaseRetriever
+    """Retriever to use to fetch documents."""
+    max_tokens_limit: Optional[int] = None
+    """If set, enforces that the documents returned are less than this limit.
+    This is only enforced if `combine_docs_chain` is of type StuffDocumentsChain."""
+
+    def _reduce_tokens_below_limit(self, docs: List[Document]) -> List[Document]:
+        num_docs = len(docs)
+
+        if self.max_tokens_limit and isinstance(
+            self.combine_docs_chain, StuffDocumentsChain
+        ):
+            tokens = [
+                self.combine_docs_chain.llm_chain._get_num_tokens(doc.page_content)
+                for doc in docs
+            ]
+            token_count = sum(tokens[:num_docs])
+            while token_count > self.max_tokens_limit:
+                num_docs -= 1
+                token_count -= tokens[num_docs]
+
+        return docs[:num_docs]
+
+    def _get_docs(
+        self,
+        question: str,
+        inputs: Dict[str, Any],
+        *,
+        run_manager: CallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs."""
+        docs = self.retriever.get_relevant_documents(
+            question, callbacks=run_manager.get_child()
+        )
+        return self._reduce_tokens_below_limit(docs)
+
+    async def _aget_docs(
+        self,
+        question: str,
+        inputs: Dict[str, Any],
+        *,
+        run_manager: AsyncCallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs."""
+        docs = await self.retriever.aget_relevant_documents(
+            question, callbacks=run_manager.get_child()
+        )
+        return self._reduce_tokens_below_limit(docs)
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        retriever: BaseRetriever,
+        condense_question_prompt: BasePromptTemplate = CONDENSE_QUESTION_PROMPT,
+        chain_type: str = "stuff",
+        verbose: bool = False,
+        condense_question_llm: Optional[BaseLanguageModel] = None,
+        combine_docs_chain_kwargs: Optional[Dict] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> BaseConversationalRetrievalChain:
+        """Convenience method to load chain from LLM and retriever.
+
+        This provides some logic to create the `question_generator` chain
+        as well as the combine_docs_chain.
+
+        Args:
+            llm: The default language model to use at every part of this chain
+                (eg in both the question generation and the answering)
+            retriever: The retriever to use to fetch relevant documents from.
+            condense_question_prompt: The prompt to use to condense the chat history
+                and new question into a standalone question.
+            chain_type: The chain type to use to create the combine_docs_chain, will
+                be sent to `load_qa_chain`.
+            verbose: Verbosity flag for logging to stdout.
+            condense_question_llm: The language model to use for condensing the chat
+                history and new question into a standalone question. If none is
+                provided, will default to `llm`.
+            combine_docs_chain_kwargs: Parameters to pass as kwargs to `load_qa_chain`
+                when constructing the combine_docs_chain.
+            callbacks: Callbacks to pass to all subchains.
+            **kwargs: Additional parameters to pass when initializing
+                ConversationalRetrievalChain
+        """
+        combine_docs_chain_kwargs = combine_docs_chain_kwargs or {}
+        doc_chain = load_qa_chain(
+            llm,
+            chain_type=chain_type,
+            verbose=verbose,
+            callbacks=callbacks,
+            **combine_docs_chain_kwargs,
+        )
+
+        _llm = condense_question_llm or llm
+        condense_question_chain = LLMChain(
+            llm=_llm,
+            prompt=condense_question_prompt,
+            verbose=verbose,
+            callbacks=callbacks,
+        )
+        return cls(
+            retriever=retriever,
+            combine_docs_chain=doc_chain,
+            question_generator=condense_question_chain,
+            callbacks=callbacks,
+            **kwargs,
+        )
+
+
+class ChatVectorDBChain(BaseConversationalRetrievalChain):
+    """Chain for chatting with a vector database."""
+
+    vectorstore: VectorStore = Field(alias="vectorstore")
+    top_k_docs_for_context: int = 4
+    search_kwargs: dict = Field(default_factory=dict)
+
+    @property
+    def _chain_type(self) -> str:
+        return "chat-vector-db"
+
+    @root_validator()
+    def raise_deprecation(cls, values: Dict) -> Dict:
+        warnings.warn(
+            "`ChatVectorDBChain` is deprecated - "
+            "please use `from langchain.chains import ConversationalRetrievalChain`"
+        )
+        return values
+
+    def _get_docs(
+        self,
+        question: str,
+        inputs: Dict[str, Any],
+        *,
+        run_manager: CallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs."""
+        vectordbkwargs = inputs.get("vectordbkwargs", {})
+        full_kwargs = {**self.search_kwargs, **vectordbkwargs}
+        return self.vectorstore.similarity_search(
+            question, k=self.top_k_docs_for_context, **full_kwargs
+        )
+
+    async def _aget_docs(
+        self,
+        question: str,
+        inputs: Dict[str, Any],
+        *,
+        run_manager: AsyncCallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs."""
+        raise NotImplementedError("ChatVectorDBChain does not support async")
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        vectorstore: VectorStore,
+        condense_question_prompt: BasePromptTemplate = CONDENSE_QUESTION_PROMPT,
+        chain_type: str = "stuff",
+        combine_docs_chain_kwargs: Optional[Dict] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> BaseConversationalRetrievalChain:
+        """Load chain from LLM."""
+        combine_docs_chain_kwargs = combine_docs_chain_kwargs or {}
+        doc_chain = load_qa_chain(
+            llm,
+            chain_type=chain_type,
+            callbacks=callbacks,
+            **combine_docs_chain_kwargs,
+        )
+        condense_question_chain = LLMChain(
+            llm=llm, prompt=condense_question_prompt, callbacks=callbacks
+        )
+        return cls(
+            vectorstore=vectorstore,
+            combine_docs_chain=doc_chain,
+            question_generator=condense_question_chain,
+            callbacks=callbacks,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/chains/conversational_retrieval/prompts.py b/llm/Lib/site-packages/langchain/chains/conversational_retrieval/prompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..f0e5aae01396d32fda4df2d76cd36261aae73a31
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/conversational_retrieval/prompts.py
@@ -0,0 +1,20 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+_template = """Given the following conversation and a follow up question, rephrase the follow up question to be a standalone question, in its original language.
+
+Chat History:
+{chat_history}
+Follow Up Input: {question}
+Standalone question:"""
+CONDENSE_QUESTION_PROMPT = PromptTemplate.from_template(_template)
+
+prompt_template = """Use the following pieces of context to answer the question at the end. If you don't know the answer, just say that you don't know, don't try to make up an answer.
+
+{context}
+
+Question: {question}
+Helpful Answer:"""
+QA_PROMPT = PromptTemplate(
+    template=prompt_template, input_variables=["context", "question"]
+)
diff --git a/llm/Lib/site-packages/langchain/chains/elasticsearch_database/__init__.py b/llm/Lib/site-packages/langchain/chains/elasticsearch_database/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b7bf85406b806f032785d97c810a37a97c91e39
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/elasticsearch_database/__init__.py
@@ -0,0 +1,3 @@
+from langchain.chains.elasticsearch_database.base import ElasticsearchDatabaseChain
+
+__all__ = ["ElasticsearchDatabaseChain"]
diff --git a/llm/Lib/site-packages/langchain/chains/elasticsearch_database/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/elasticsearch_database/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..58b05dc5eaaf56ad583a4cb401a8177980efb8ca
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/elasticsearch_database/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/elasticsearch_database/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/elasticsearch_database/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3b76181169dca289f35fc48d9c2af04e8db7b027
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/elasticsearch_database/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/elasticsearch_database/__pycache__/prompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/elasticsearch_database/__pycache__/prompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e1115ade9d9c811ca981ac0fa65b9c489bb497d1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/elasticsearch_database/__pycache__/prompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/elasticsearch_database/base.py b/llm/Lib/site-packages/langchain/chains/elasticsearch_database/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..f4e839125dd2998dc5b827ab0ede951a2993ec11
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/elasticsearch_database/base.py
@@ -0,0 +1,213 @@
+"""Chain for interacting with Elasticsearch Database."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import BaseLLMOutputParser
+from langchain_core.output_parsers.json import SimpleJsonOutputParser
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Extra, root_validator
+
+from langchain.chains.base import Chain
+from langchain.chains.elasticsearch_database.prompts import ANSWER_PROMPT, DSL_PROMPT
+from langchain.chains.llm import LLMChain
+
+if TYPE_CHECKING:
+    from elasticsearch import Elasticsearch
+
+INTERMEDIATE_STEPS_KEY = "intermediate_steps"
+
+
+class ElasticsearchDatabaseChain(Chain):
+    """Chain for interacting with Elasticsearch Database.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.chains import ElasticsearchDatabaseChain
+            from langchain_community.llms import OpenAI
+            from elasticsearch import Elasticsearch
+
+            database = Elasticsearch("http://localhost:9200")
+            db_chain = ElasticsearchDatabaseChain.from_llm(OpenAI(), database)
+    """
+
+    query_chain: LLMChain
+    """Chain for creating the ES query."""
+    answer_chain: LLMChain
+    """Chain for answering the user question."""
+    database: Any
+    """Elasticsearch database to connect to of type elasticsearch.Elasticsearch."""
+    top_k: int = 10
+    """Number of results to return from the query"""
+    ignore_indices: Optional[List[str]] = None
+    include_indices: Optional[List[str]] = None
+    input_key: str = "question"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+    sample_documents_in_index_info: int = 3
+    return_intermediate_steps: bool = False
+    """Whether or not to return the intermediate steps along with the final answer."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator()
+    def validate_indices(cls, values: dict) -> dict:
+        if values["include_indices"] and values["ignore_indices"]:
+            raise ValueError(
+                "Cannot specify both 'include_indices' and 'ignore_indices'."
+            )
+        return values
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the singular input key.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return the singular output key.
+
+        :meta private:
+        """
+        if not self.return_intermediate_steps:
+            return [self.output_key]
+        else:
+            return [self.output_key, INTERMEDIATE_STEPS_KEY]
+
+    def _list_indices(self) -> List[str]:
+        all_indices = [
+            index["index"] for index in self.database.cat.indices(format="json")
+        ]
+
+        if self.include_indices:
+            all_indices = [i for i in all_indices if i in self.include_indices]
+        if self.ignore_indices:
+            all_indices = [i for i in all_indices if i not in self.ignore_indices]
+
+        return all_indices
+
+    def _get_indices_infos(self, indices: List[str]) -> str:
+        mappings = self.database.indices.get_mapping(index=",".join(indices))
+        if self.sample_documents_in_index_info > 0:
+            for k, v in mappings.items():
+                hits = self.database.search(
+                    index=k,
+                    query={"match_all": {}},
+                    size=self.sample_documents_in_index_info,
+                )["hits"]["hits"]
+                hits = [str(hit["_source"]) for hit in hits]
+                mappings[k]["mappings"] = str(v) + "\n\n/*\n" + "\n".join(hits) + "\n*/"
+        return "\n\n".join(
+            [
+                "Mapping for index {}:\n{}".format(index, mappings[index]["mappings"])
+                for index in mappings
+            ]
+        )
+
+    def _search(self, indices: List[str], query: str) -> str:
+        result = self.database.search(index=",".join(indices), body=query)
+        return str(result)
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        input_text = f"{inputs[self.input_key]}\nESQuery:"
+        _run_manager.on_text(input_text, verbose=self.verbose)
+        indices = self._list_indices()
+        indices_info = self._get_indices_infos(indices)
+        query_inputs: dict = {
+            "input": input_text,
+            "top_k": str(self.top_k),
+            "indices_info": indices_info,
+            "stop": ["\nESResult:"],
+        }
+        intermediate_steps: List = []
+        try:
+            intermediate_steps.append(query_inputs)  # input: es generation
+            es_cmd = self.query_chain.run(
+                callbacks=_run_manager.get_child(),
+                **query_inputs,
+            )
+
+            _run_manager.on_text(es_cmd, color="green", verbose=self.verbose)
+            intermediate_steps.append(
+                es_cmd
+            )  # output: elasticsearch dsl generation (no checker)
+            intermediate_steps.append({"es_cmd": es_cmd})  # input: ES search
+            result = self._search(indices=indices, query=es_cmd)
+            intermediate_steps.append(str(result))  # output: ES search
+
+            _run_manager.on_text("\nESResult: ", verbose=self.verbose)
+            _run_manager.on_text(result, color="yellow", verbose=self.verbose)
+
+            _run_manager.on_text("\nAnswer:", verbose=self.verbose)
+            answer_inputs: dict = {"data": result, "input": input_text}
+            intermediate_steps.append(answer_inputs)  # input: final answer
+            final_result = self.answer_chain.run(
+                callbacks=_run_manager.get_child(),
+                **answer_inputs,
+            )
+
+            intermediate_steps.append(final_result)  # output: final answer
+            _run_manager.on_text(final_result, color="green", verbose=self.verbose)
+            chain_result: Dict[str, Any] = {self.output_key: final_result}
+            if self.return_intermediate_steps:
+                chain_result[INTERMEDIATE_STEPS_KEY] = intermediate_steps
+            return chain_result
+        except Exception as exc:
+            # Append intermediate steps to exception, to aid in logging and later
+            # improvement of few shot prompt seeds
+            exc.intermediate_steps = intermediate_steps  # type: ignore
+            raise exc
+
+    @property
+    def _chain_type(self) -> str:
+        return "elasticsearch_database_chain"
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        database: Elasticsearch,
+        *,
+        query_prompt: Optional[BasePromptTemplate] = None,
+        answer_prompt: Optional[BasePromptTemplate] = None,
+        query_output_parser: Optional[BaseLLMOutputParser] = None,
+        **kwargs: Any,
+    ) -> ElasticsearchDatabaseChain:
+        """Convenience method to construct ElasticsearchDatabaseChain from an LLM.
+
+        Args:
+            llm: The language model to use.
+            database: The Elasticsearch db.
+            query_prompt: The prompt to use for query construction.
+            answer_prompt: The prompt to use for answering user question given data.
+            query_output_parser: The output parser to use for parsing model-generated
+                ES query. Defaults to SimpleJsonOutputParser.
+            **kwargs: Additional arguments to pass to the constructor.
+        """
+        query_prompt = query_prompt or DSL_PROMPT
+        query_output_parser = query_output_parser or SimpleJsonOutputParser()
+        query_chain = LLMChain(
+            llm=llm, prompt=query_prompt, output_parser=query_output_parser
+        )
+        answer_prompt = answer_prompt or ANSWER_PROMPT
+        answer_chain = LLMChain(llm=llm, prompt=answer_prompt)
+        return cls(
+            query_chain=query_chain,
+            answer_chain=answer_chain,
+            database=database,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/chains/elasticsearch_database/prompts.py b/llm/Lib/site-packages/langchain/chains/elasticsearch_database/prompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..196d97a9db93c3a2db113982a97abbd19166eeb3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/elasticsearch_database/prompts.py
@@ -0,0 +1,36 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+PROMPT_SUFFIX = """Only use the following Elasticsearch indices:
+{indices_info}
+
+Question: {input}
+ESQuery:"""
+
+DEFAULT_DSL_TEMPLATE = """Given an input question, create a syntactically correct Elasticsearch query to run. Unless the user specifies in their question a specific number of examples they wish to obtain, always limit your query to at most {top_k} results. You can order the results by a relevant column to return the most interesting examples in the database.
+
+Unless told to do not query for all the columns from a specific index, only ask for a the few relevant columns given the question.
+
+Pay attention to use only the column names that you can see in the mapping description. Be careful to not query for columns that do not exist. Also, pay attention to which column is in which index. Return the query as valid json.
+
+Use the following format:
+
+Question: Question here
+ESQuery: Elasticsearch Query formatted as json
+"""
+
+DSL_PROMPT = PromptTemplate.from_template(DEFAULT_DSL_TEMPLATE + PROMPT_SUFFIX)
+
+DEFAULT_ANSWER_TEMPLATE = """Given an input question and relevant data from a database, answer the user question.
+
+Use the following format:
+
+Question: Question here
+Data: Relevant data here
+Answer: Final answer here
+
+Question: {input}
+Data: {data}
+Answer:"""
+
+ANSWER_PROMPT = PromptTemplate.from_template(DEFAULT_ANSWER_TEMPLATE)
diff --git a/llm/Lib/site-packages/langchain/chains/ernie_functions/__init__.py b/llm/Lib/site-packages/langchain/chains/ernie_functions/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3efc22d4199bcb1f6d2bf140cfd8c6ca03d95281
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/ernie_functions/__init__.py
@@ -0,0 +1,17 @@
+from langchain.chains.ernie_functions.base import (
+    convert_to_ernie_function,
+    create_ernie_fn_chain,
+    create_ernie_fn_runnable,
+    create_structured_output_chain,
+    create_structured_output_runnable,
+    get_ernie_output_parser,
+)
+
+__all__ = [
+    "convert_to_ernie_function",
+    "create_structured_output_chain",
+    "create_ernie_fn_chain",
+    "create_structured_output_runnable",
+    "create_ernie_fn_runnable",
+    "get_ernie_output_parser",
+]
diff --git a/llm/Lib/site-packages/langchain/chains/ernie_functions/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/ernie_functions/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..161b2ce172e542db50d83b9772f3bade84bb94bf
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/ernie_functions/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/ernie_functions/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/ernie_functions/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..63d0cef2235f415ccaffc014662384b74800c8d9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/ernie_functions/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/ernie_functions/base.py b/llm/Lib/site-packages/langchain/chains/ernie_functions/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..2eb2a5a72f208c85ebfd29b9cd6e53174e0d4038
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/ernie_functions/base.py
@@ -0,0 +1,551 @@
+"""Methods for creating chains that use Ernie function-calling APIs."""
+import inspect
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import (
+    BaseGenerationOutputParser,
+    BaseLLMOutputParser,
+    BaseOutputParser,
+)
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.runnables import Runnable
+
+from langchain.chains import LLMChain
+from langchain.output_parsers.ernie_functions import (
+    JsonOutputFunctionsParser,
+    PydanticAttrOutputFunctionsParser,
+    PydanticOutputFunctionsParser,
+)
+from langchain.utils.ernie_functions import convert_pydantic_to_ernie_function
+
+PYTHON_TO_JSON_TYPES = {
+    "str": "string",
+    "int": "number",
+    "float": "number",
+    "bool": "boolean",
+}
+
+
+def _get_python_function_name(function: Callable) -> str:
+    """Get the name of a Python function."""
+    return function.__name__
+
+
+def _parse_python_function_docstring(function: Callable) -> Tuple[str, dict]:
+    """Parse the function and argument descriptions from the docstring of a function.
+
+    Assumes the function docstring follows Google Python style guide.
+    """
+    docstring = inspect.getdoc(function)
+    if docstring:
+        docstring_blocks = docstring.split("\n\n")
+        descriptors = []
+        args_block = None
+        past_descriptors = False
+        for block in docstring_blocks:
+            if block.startswith("Args:"):
+                args_block = block
+                break
+            elif block.startswith("Returns:") or block.startswith("Example:"):
+                # Don't break in case Args come after
+                past_descriptors = True
+            elif not past_descriptors:
+                descriptors.append(block)
+            else:
+                continue
+        description = " ".join(descriptors)
+    else:
+        description = ""
+        args_block = None
+    arg_descriptions = {}
+    if args_block:
+        arg = None
+        for line in args_block.split("\n")[1:]:
+            if ":" in line:
+                arg, desc = line.split(":")
+                arg_descriptions[arg.strip()] = desc.strip()
+            elif arg:
+                arg_descriptions[arg.strip()] += " " + line.strip()
+    return description, arg_descriptions
+
+
+def _get_python_function_arguments(function: Callable, arg_descriptions: dict) -> dict:
+    """Get JsonSchema describing a Python functions arguments.
+
+    Assumes all function arguments are of primitive types (int, float, str, bool) or
+    are subclasses of pydantic.BaseModel.
+    """
+    properties = {}
+    annotations = inspect.getfullargspec(function).annotations
+    for arg, arg_type in annotations.items():
+        if arg == "return":
+            continue
+        if isinstance(arg_type, type) and issubclass(arg_type, BaseModel):
+            # Mypy error:
+            # "type" has no attribute "schema"
+            properties[arg] = arg_type.schema()  # type: ignore[attr-defined]
+        elif arg_type.__name__ in PYTHON_TO_JSON_TYPES:
+            properties[arg] = {"type": PYTHON_TO_JSON_TYPES[arg_type.__name__]}
+        if arg in arg_descriptions:
+            if arg not in properties:
+                properties[arg] = {}
+            properties[arg]["description"] = arg_descriptions[arg]
+    return properties
+
+
+def _get_python_function_required_args(function: Callable) -> List[str]:
+    """Get the required arguments for a Python function."""
+    spec = inspect.getfullargspec(function)
+    required = spec.args[: -len(spec.defaults)] if spec.defaults else spec.args
+    required += [k for k in spec.kwonlyargs if k not in (spec.kwonlydefaults or {})]
+
+    is_class = type(function) is type
+    if is_class and required[0] == "self":
+        required = required[1:]
+    return required
+
+
+def convert_python_function_to_ernie_function(
+    function: Callable,
+) -> Dict[str, Any]:
+    """Convert a Python function to an Ernie function-calling API compatible dict.
+
+    Assumes the Python function has type hints and a docstring with a description. If
+        the docstring has Google Python style argument descriptions, these will be
+        included as well.
+    """
+    description, arg_descriptions = _parse_python_function_docstring(function)
+    return {
+        "name": _get_python_function_name(function),
+        "description": description,
+        "parameters": {
+            "type": "object",
+            "properties": _get_python_function_arguments(function, arg_descriptions),
+            "required": _get_python_function_required_args(function),
+        },
+    }
+
+
+def convert_to_ernie_function(
+    function: Union[Dict[str, Any], Type[BaseModel], Callable],
+) -> Dict[str, Any]:
+    """Convert a raw function/class to an Ernie function.
+
+    Args:
+        function: Either a dictionary, a pydantic.BaseModel class, or a Python function.
+            If a dictionary is passed in, it is assumed to already be a valid Ernie
+            function.
+
+    Returns:
+        A dict version of the passed in function which is compatible with the
+            Ernie function-calling API.
+    """
+    if isinstance(function, dict):
+        return function
+    elif isinstance(function, type) and issubclass(function, BaseModel):
+        return cast(Dict, convert_pydantic_to_ernie_function(function))
+    elif callable(function):
+        return convert_python_function_to_ernie_function(function)
+
+    else:
+        raise ValueError(
+            f"Unsupported function type {type(function)}. Functions must be passed in"
+            f" as Dict, pydantic.BaseModel, or Callable."
+        )
+
+
+def get_ernie_output_parser(
+    functions: Sequence[Union[Dict[str, Any], Type[BaseModel], Callable]],
+) -> Union[BaseOutputParser, BaseGenerationOutputParser]:
+    """Get the appropriate function output parser given the user functions.
+
+    Args:
+        functions: Sequence where element is a dictionary, a pydantic.BaseModel class,
+            or a Python function. If a dictionary is passed in, it is assumed to
+            already be a valid Ernie function.
+
+    Returns:
+        A PydanticOutputFunctionsParser if functions are Pydantic classes, otherwise
+            a JsonOutputFunctionsParser. If there's only one function and it is
+            not a Pydantic class, then the output parser will automatically extract
+            only the function arguments and not the function name.
+    """
+    function_names = [convert_to_ernie_function(f)["name"] for f in functions]
+    if isinstance(functions[0], type) and issubclass(functions[0], BaseModel):
+        if len(functions) > 1:
+            pydantic_schema: Union[Dict, Type[BaseModel]] = {
+                name: fn for name, fn in zip(function_names, functions)
+            }
+        else:
+            pydantic_schema = functions[0]
+        output_parser: Union[
+            BaseOutputParser, BaseGenerationOutputParser
+        ] = PydanticOutputFunctionsParser(pydantic_schema=pydantic_schema)
+    else:
+        output_parser = JsonOutputFunctionsParser(args_only=len(functions) <= 1)
+    return output_parser
+
+
+def create_ernie_fn_runnable(
+    functions: Sequence[Union[Dict[str, Any], Type[BaseModel], Callable]],
+    llm: Runnable,
+    prompt: BasePromptTemplate,
+    *,
+    output_parser: Optional[Union[BaseOutputParser, BaseGenerationOutputParser]] = None,
+    **kwargs: Any,
+) -> Runnable:
+    """Create a runnable sequence that uses Ernie functions.
+
+    Args:
+        functions: A sequence of either dictionaries, pydantic.BaseModels classes, or
+            Python functions. If dictionaries are passed in, they are assumed to
+            already be a valid Ernie functions. If only a single
+            function is passed in, then it will be enforced that the model use that
+            function. pydantic.BaseModels and Python functions should have docstrings
+            describing what the function does. For best results, pydantic.BaseModels
+            should have descriptions of the parameters and Python functions should have
+            Google Python style args descriptions in the docstring. Additionally,
+            Python functions should only use primitive types (str, int, float, bool) or
+            pydantic.BaseModels for arguments.
+        llm: Language model to use, assumed to support the Ernie function-calling API.
+        prompt: BasePromptTemplate to pass to the model.
+        output_parser: BaseLLMOutputParser to use for parsing model outputs. By default
+            will be inferred from the function types. If pydantic.BaseModels are passed
+            in, then the OutputParser will try to parse outputs using those. Otherwise
+            model outputs will simply be parsed as JSON. If multiple functions are
+            passed in and they are not pydantic.BaseModels, the chain output will
+            include both the name of the function that was returned and the arguments
+            to pass to the function.
+
+    Returns:
+        A runnable sequence that will pass in the given functions to the model when run.
+
+    Example:
+        .. code-block:: python
+
+                from typing import Optional
+
+                from langchain.chains.ernie_functions import create_ernie_fn_chain
+                from langchain_community.chat_models import ErnieBotChat
+                from langchain.prompts import ChatPromptTemplate
+                from langchain.pydantic_v1 import BaseModel, Field
+
+
+                class RecordPerson(BaseModel):
+                    \"\"\"Record some identifying information about a person.\"\"\"
+
+                    name: str = Field(..., description="The person's name")
+                    age: int = Field(..., description="The person's age")
+                    fav_food: Optional[str] = Field(None, description="The person's favorite food")
+
+
+                class RecordDog(BaseModel):
+                    \"\"\"Record some identifying information about a dog.\"\"\"
+
+                    name: str = Field(..., description="The dog's name")
+                    color: str = Field(..., description="The dog's color")
+                    fav_food: Optional[str] = Field(None, description="The dog's favorite food")
+
+
+                llm = ErnieBotChat(model_name="ERNIE-Bot-4")
+                prompt = ChatPromptTemplate.from_messages(
+                    [
+                        ("user", "Make calls to the relevant function to record the entities in the following input: {input}"),
+                        ("assistant", "OK!"),
+                        ("user", "Tip: Make sure to answer in the correct format"),
+                    ]
+                )
+                chain = create_ernie_fn_runnable([RecordPerson, RecordDog], llm, prompt)
+                chain.invoke({"input": "Harry was a chubby brown beagle who loved chicken"})
+                # -> RecordDog(name="Harry", color="brown", fav_food="chicken")
+    """  # noqa: E501
+    if not functions:
+        raise ValueError("Need to pass in at least one function. Received zero.")
+    ernie_functions = [convert_to_ernie_function(f) for f in functions]
+    llm_kwargs: Dict[str, Any] = {"functions": ernie_functions, **kwargs}
+    if len(ernie_functions) == 1:
+        llm_kwargs["function_call"] = {"name": ernie_functions[0]["name"]}
+    output_parser = output_parser or get_ernie_output_parser(functions)
+    return prompt | llm.bind(**llm_kwargs) | output_parser
+
+
+def create_structured_output_runnable(
+    output_schema: Union[Dict[str, Any], Type[BaseModel]],
+    llm: Runnable,
+    prompt: BasePromptTemplate,
+    *,
+    output_parser: Optional[Union[BaseOutputParser, BaseGenerationOutputParser]] = None,
+    **kwargs: Any,
+) -> Runnable:
+    """Create a runnable that uses an Ernie function to get a structured output.
+
+    Args:
+        output_schema: Either a dictionary or pydantic.BaseModel class. If a dictionary
+            is passed in, it's assumed to already be a valid JsonSchema.
+            For best results, pydantic.BaseModels should have docstrings describing what
+            the schema represents and descriptions for the parameters.
+        llm: Language model to use, assumed to support the Ernie function-calling API.
+        prompt: BasePromptTemplate to pass to the model.
+        output_parser: BaseLLMOutputParser to use for parsing model outputs. By default
+            will be inferred from the function types. If pydantic.BaseModels are passed
+            in, then the OutputParser will try to parse outputs using those. Otherwise
+            model outputs will simply be parsed as JSON.
+
+    Returns:
+        A runnable sequence that will pass the given function to the model when run.
+
+    Example:
+        .. code-block:: python
+
+            from typing import Optional
+
+            from langchain.chains.ernie_functions import create_structured_output_chain
+            from langchain_community.chat_models import ErnieBotChat
+            from langchain.prompts import ChatPromptTemplate
+            from langchain.pydantic_v1 import BaseModel, Field
+
+            class Dog(BaseModel):
+                \"\"\"Identifying information about a dog.\"\"\"
+
+                name: str = Field(..., description="The dog's name")
+                color: str = Field(..., description="The dog's color")
+                fav_food: Optional[str] = Field(None, description="The dog's favorite food")
+
+            llm = ErnieBotChat(model_name="ERNIE-Bot-4")
+            prompt = ChatPromptTemplate.from_messages(
+                [
+                    ("user", "Use the given format to extract information from the following input: {input}"),
+                    ("assistant", "OK!"),
+                    ("user", "Tip: Make sure to answer in the correct format"),
+                ]
+            )
+            chain = create_structured_output_chain(Dog, llm, prompt)
+            chain.invoke({"input": "Harry was a chubby brown beagle who loved chicken"})
+            # -> Dog(name="Harry", color="brown", fav_food="chicken")
+    """  # noqa: E501
+    if isinstance(output_schema, dict):
+        function: Any = {
+            "name": "output_formatter",
+            "description": (
+                "Output formatter. Should always be used to format your response to the"
+                " user."
+            ),
+            "parameters": output_schema,
+        }
+    else:
+
+        class _OutputFormatter(BaseModel):
+            """Output formatter. Should always be used to format your response to the user."""  # noqa: E501
+
+            output: output_schema  # type: ignore
+
+        function = _OutputFormatter
+        output_parser = output_parser or PydanticAttrOutputFunctionsParser(
+            pydantic_schema=_OutputFormatter, attr_name="output"
+        )
+    return create_ernie_fn_runnable(
+        [function],
+        llm,
+        prompt,
+        output_parser=output_parser,
+        **kwargs,
+    )
+
+
+""" --- Legacy --- """
+
+
+def create_ernie_fn_chain(
+    functions: Sequence[Union[Dict[str, Any], Type[BaseModel], Callable]],
+    llm: BaseLanguageModel,
+    prompt: BasePromptTemplate,
+    *,
+    output_key: str = "function",
+    output_parser: Optional[BaseLLMOutputParser] = None,
+    **kwargs: Any,
+) -> LLMChain:
+    """[Legacy] Create an LLM chain that uses Ernie functions.
+
+    Args:
+        functions: A sequence of either dictionaries, pydantic.BaseModels classes, or
+            Python functions. If dictionaries are passed in, they are assumed to
+            already be a valid Ernie functions. If only a single
+            function is passed in, then it will be enforced that the model use that
+            function. pydantic.BaseModels and Python functions should have docstrings
+            describing what the function does. For best results, pydantic.BaseModels
+            should have descriptions of the parameters and Python functions should have
+            Google Python style args descriptions in the docstring. Additionally,
+            Python functions should only use primitive types (str, int, float, bool) or
+            pydantic.BaseModels for arguments.
+        llm: Language model to use, assumed to support the Ernie function-calling API.
+        prompt: BasePromptTemplate to pass to the model.
+        output_key: The key to use when returning the output in LLMChain.__call__.
+        output_parser: BaseLLMOutputParser to use for parsing model outputs. By default
+            will be inferred from the function types. If pydantic.BaseModels are passed
+            in, then the OutputParser will try to parse outputs using those. Otherwise
+            model outputs will simply be parsed as JSON. If multiple functions are
+            passed in and they are not pydantic.BaseModels, the chain output will
+            include both the name of the function that was returned and the arguments
+            to pass to the function.
+
+    Returns:
+        An LLMChain that will pass in the given functions to the model when run.
+
+    Example:
+        .. code-block:: python
+
+                from typing import Optional
+
+                from langchain.chains.ernie_functions import create_ernie_fn_chain
+                from langchain_community.chat_models import ErnieBotChat
+                from langchain.prompts import ChatPromptTemplate
+
+                from langchain.pydantic_v1 import BaseModel, Field
+
+
+                class RecordPerson(BaseModel):
+                    \"\"\"Record some identifying information about a person.\"\"\"
+
+                    name: str = Field(..., description="The person's name")
+                    age: int = Field(..., description="The person's age")
+                    fav_food: Optional[str] = Field(None, description="The person's favorite food")
+
+
+                class RecordDog(BaseModel):
+                    \"\"\"Record some identifying information about a dog.\"\"\"
+
+                    name: str = Field(..., description="The dog's name")
+                    color: str = Field(..., description="The dog's color")
+                    fav_food: Optional[str] = Field(None, description="The dog's favorite food")
+
+
+                llm = ErnieBotChat(model_name="ERNIE-Bot-4")
+                prompt = ChatPromptTemplate.from_messages(
+                    [
+                        ("user", "Make calls to the relevant function to record the entities in the following input: {input}"),
+                        ("assistant", "OK!"),
+                        ("user", "Tip: Make sure to answer in the correct format"),
+                    ]
+                )
+                chain = create_ernie_fn_chain([RecordPerson, RecordDog], llm, prompt)
+                chain.run("Harry was a chubby brown beagle who loved chicken")
+                # -> RecordDog(name="Harry", color="brown", fav_food="chicken")
+    """  # noqa: E501
+    if not functions:
+        raise ValueError("Need to pass in at least one function. Received zero.")
+    ernie_functions = [convert_to_ernie_function(f) for f in functions]
+    output_parser = output_parser or get_ernie_output_parser(functions)
+    llm_kwargs: Dict[str, Any] = {
+        "functions": ernie_functions,
+    }
+    if len(ernie_functions) == 1:
+        llm_kwargs["function_call"] = {"name": ernie_functions[0]["name"]}
+    llm_chain = LLMChain(
+        llm=llm,
+        prompt=prompt,
+        output_parser=output_parser,
+        llm_kwargs=llm_kwargs,
+        output_key=output_key,
+        **kwargs,
+    )
+    return llm_chain
+
+
+def create_structured_output_chain(
+    output_schema: Union[Dict[str, Any], Type[BaseModel]],
+    llm: BaseLanguageModel,
+    prompt: BasePromptTemplate,
+    *,
+    output_key: str = "function",
+    output_parser: Optional[BaseLLMOutputParser] = None,
+    **kwargs: Any,
+) -> LLMChain:
+    """[Legacy] Create an LLMChain that uses an Ernie function to get a structured output.
+
+    Args:
+        output_schema: Either a dictionary or pydantic.BaseModel class. If a dictionary
+            is passed in, it's assumed to already be a valid JsonSchema.
+            For best results, pydantic.BaseModels should have docstrings describing what
+            the schema represents and descriptions for the parameters.
+        llm: Language model to use, assumed to support the Ernie function-calling API.
+        prompt: BasePromptTemplate to pass to the model.
+        output_key: The key to use when returning the output in LLMChain.__call__.
+        output_parser: BaseLLMOutputParser to use for parsing model outputs. By default
+            will be inferred from the function types. If pydantic.BaseModels are passed
+            in, then the OutputParser will try to parse outputs using those. Otherwise
+            model outputs will simply be parsed as JSON.
+
+    Returns:
+        An LLMChain that will pass the given function to the model.
+
+    Example:
+        .. code-block:: python
+
+                from typing import Optional
+
+                from langchain.chains.ernie_functions import create_structured_output_chain
+                from langchain_community.chat_models import ErnieBotChat
+                from langchain.prompts import ChatPromptTemplate
+
+                from langchain.pydantic_v1 import BaseModel, Field
+
+                class Dog(BaseModel):
+                    \"\"\"Identifying information about a dog.\"\"\"
+
+                    name: str = Field(..., description="The dog's name")
+                    color: str = Field(..., description="The dog's color")
+                    fav_food: Optional[str] = Field(None, description="The dog's favorite food")
+
+                llm = ErnieBotChat(model_name="ERNIE-Bot-4")
+                prompt = ChatPromptTemplate.from_messages(
+                    [
+                        ("user", "Use the given format to extract information from the following input: {input}"),
+                        ("assistant", "OK!"),
+                        ("user", "Tip: Make sure to answer in the correct format"),
+                    ]
+                )
+                chain = create_structured_output_chain(Dog, llm, prompt)
+                chain.run("Harry was a chubby brown beagle who loved chicken")
+                # -> Dog(name="Harry", color="brown", fav_food="chicken")
+    """  # noqa: E501
+    if isinstance(output_schema, dict):
+        function: Any = {
+            "name": "output_formatter",
+            "description": (
+                "Output formatter. Should always be used to format your response to the"
+                " user."
+            ),
+            "parameters": output_schema,
+        }
+    else:
+
+        class _OutputFormatter(BaseModel):
+            """Output formatter. Should always be used to format your response to the user."""  # noqa: E501
+
+            output: output_schema  # type: ignore
+
+        function = _OutputFormatter
+        output_parser = output_parser or PydanticAttrOutputFunctionsParser(
+            pydantic_schema=_OutputFormatter, attr_name="output"
+        )
+    return create_ernie_fn_chain(
+        [function],
+        llm,
+        prompt,
+        output_key=output_key,
+        output_parser=output_parser,
+        **kwargs,
+    )
diff --git a/llm/Lib/site-packages/langchain/chains/example_generator.py b/llm/Lib/site-packages/langchain/chains/example_generator.py
new file mode 100644
index 0000000000000000000000000000000000000000..8aae0565bfa8a816b66d5b2055ade4fe1f9ad61f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/example_generator.py
@@ -0,0 +1,23 @@
+from typing import List
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts.few_shot import FewShotPromptTemplate
+from langchain_core.prompts.prompt import PromptTemplate
+
+from langchain.chains.llm import LLMChain
+
+TEST_GEN_TEMPLATE_SUFFIX = "Add another example."
+
+
+def generate_example(
+    examples: List[dict], llm: BaseLanguageModel, prompt_template: PromptTemplate
+) -> str:
+    """Return another example given a list of examples for a prompt."""
+    prompt = FewShotPromptTemplate(
+        examples=examples,
+        suffix=TEST_GEN_TEMPLATE_SUFFIX,
+        input_variables=[],
+        example_prompt=prompt_template,
+    )
+    chain = LLMChain(llm=llm, prompt=prompt)
+    return chain.predict()
diff --git a/llm/Lib/site-packages/langchain/chains/flare/__init__.py b/llm/Lib/site-packages/langchain/chains/flare/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..10a700d8b9f7fbea80c80cf5024d168953205618
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/flare/__init__.py
@@ -0,0 +1 @@
+"""Adapted from https://github.com/jzbjyb/FLARE"""
diff --git a/llm/Lib/site-packages/langchain/chains/flare/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/flare/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..626a1304b9eec116dab0e30acb9e3cd5727d2a2d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/flare/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/flare/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/flare/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9ab4129e43edbe7463231bc8942abd9e91c83301
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/flare/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/flare/__pycache__/prompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/flare/__pycache__/prompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..058908cbf14d6d7796463fe869daf003f730b63b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/flare/__pycache__/prompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/flare/base.py b/llm/Lib/site-packages/langchain/chains/flare/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2ef8f2da60cae8a021cce6181d206039e504d39
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/flare/base.py
@@ -0,0 +1,267 @@
+from __future__ import annotations
+
+import re
+from abc import abstractmethod
+from typing import Any, Dict, List, Optional, Sequence, Tuple
+
+import numpy as np
+from langchain_community.llms.openai import OpenAI
+from langchain_core.callbacks import (
+    CallbackManagerForChainRun,
+)
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.outputs import Generation
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+from langchain_core.retrievers import BaseRetriever
+
+from langchain.chains.base import Chain
+from langchain.chains.flare.prompts import (
+    PROMPT,
+    QUESTION_GENERATOR_PROMPT,
+    FinishedOutputParser,
+)
+from langchain.chains.llm import LLMChain
+
+
+class _ResponseChain(LLMChain):
+    """Base class for chains that generate responses."""
+
+    prompt: BasePromptTemplate = PROMPT
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @property
+    def input_keys(self) -> List[str]:
+        return self.prompt.input_variables
+
+    def generate_tokens_and_log_probs(
+        self,
+        _input: Dict[str, Any],
+        *,
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Tuple[Sequence[str], Sequence[float]]:
+        llm_result = self.generate([_input], run_manager=run_manager)
+        return self._extract_tokens_and_log_probs(llm_result.generations[0])
+
+    @abstractmethod
+    def _extract_tokens_and_log_probs(
+        self, generations: List[Generation]
+    ) -> Tuple[Sequence[str], Sequence[float]]:
+        """Extract tokens and log probs from response."""
+
+
+class _OpenAIResponseChain(_ResponseChain):
+    """Chain that generates responses from user input and context."""
+
+    llm: OpenAI = Field(
+        default_factory=lambda: OpenAI(
+            max_tokens=32, model_kwargs={"logprobs": 1}, temperature=0
+        )
+    )
+
+    def _extract_tokens_and_log_probs(
+        self, generations: List[Generation]
+    ) -> Tuple[Sequence[str], Sequence[float]]:
+        tokens = []
+        log_probs = []
+        for gen in generations:
+            if gen.generation_info is None:
+                raise ValueError
+            tokens.extend(gen.generation_info["logprobs"]["tokens"])
+            log_probs.extend(gen.generation_info["logprobs"]["token_logprobs"])
+        return tokens, log_probs
+
+
+class QuestionGeneratorChain(LLMChain):
+    """Chain that generates questions from uncertain spans."""
+
+    prompt: BasePromptTemplate = QUESTION_GENERATOR_PROMPT
+    """Prompt template for the chain."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Input keys for the chain."""
+        return ["user_input", "context", "response"]
+
+
+def _low_confidence_spans(
+    tokens: Sequence[str],
+    log_probs: Sequence[float],
+    min_prob: float,
+    min_token_gap: int,
+    num_pad_tokens: int,
+) -> List[str]:
+    _low_idx = np.where(np.exp(log_probs) < min_prob)[0]
+    low_idx = [i for i in _low_idx if re.search(r"\w", tokens[i])]
+    if len(low_idx) == 0:
+        return []
+    spans = [[low_idx[0], low_idx[0] + num_pad_tokens + 1]]
+    for i, idx in enumerate(low_idx[1:]):
+        end = idx + num_pad_tokens + 1
+        if idx - low_idx[i] < min_token_gap:
+            spans[-1][1] = end
+        else:
+            spans.append([idx, end])
+    return ["".join(tokens[start:end]) for start, end in spans]
+
+
+class FlareChain(Chain):
+    """Chain that combines a retriever, a question generator,
+    and a response generator."""
+
+    question_generator_chain: QuestionGeneratorChain
+    """Chain that generates questions from uncertain spans."""
+    response_chain: _ResponseChain = Field(default_factory=_OpenAIResponseChain)
+    """Chain that generates responses from user input and context."""
+    output_parser: FinishedOutputParser = Field(default_factory=FinishedOutputParser)
+    """Parser that determines whether the chain is finished."""
+    retriever: BaseRetriever
+    """Retriever that retrieves relevant documents from a user input."""
+    min_prob: float = 0.2
+    """Minimum probability for a token to be considered low confidence."""
+    min_token_gap: int = 5
+    """Minimum number of tokens between two low confidence spans."""
+    num_pad_tokens: int = 2
+    """Number of tokens to pad around a low confidence span."""
+    max_iter: int = 10
+    """Maximum number of iterations."""
+    start_with_retrieval: bool = True
+    """Whether to start with retrieval."""
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Input keys for the chain."""
+        return ["user_input"]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Output keys for the chain."""
+        return ["response"]
+
+    def _do_generation(
+        self,
+        questions: List[str],
+        user_input: str,
+        response: str,
+        _run_manager: CallbackManagerForChainRun,
+    ) -> Tuple[str, bool]:
+        callbacks = _run_manager.get_child()
+        docs = []
+        for question in questions:
+            docs.extend(self.retriever.get_relevant_documents(question))
+        context = "\n\n".join(d.page_content for d in docs)
+        result = self.response_chain.predict(
+            user_input=user_input,
+            context=context,
+            response=response,
+            callbacks=callbacks,
+        )
+        marginal, finished = self.output_parser.parse(result)
+        return marginal, finished
+
+    def _do_retrieval(
+        self,
+        low_confidence_spans: List[str],
+        _run_manager: CallbackManagerForChainRun,
+        user_input: str,
+        response: str,
+        initial_response: str,
+    ) -> Tuple[str, bool]:
+        question_gen_inputs = [
+            {
+                "user_input": user_input,
+                "current_response": initial_response,
+                "uncertain_span": span,
+            }
+            for span in low_confidence_spans
+        ]
+        callbacks = _run_manager.get_child()
+        question_gen_outputs = self.question_generator_chain.apply(
+            question_gen_inputs, callbacks=callbacks
+        )
+        questions = [
+            output[self.question_generator_chain.output_keys[0]]
+            for output in question_gen_outputs
+        ]
+        _run_manager.on_text(
+            f"Generated Questions: {questions}", color="yellow", end="\n"
+        )
+        return self._do_generation(questions, user_input, response, _run_manager)
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+
+        user_input = inputs[self.input_keys[0]]
+
+        response = ""
+
+        for i in range(self.max_iter):
+            _run_manager.on_text(
+                f"Current Response: {response}", color="blue", end="\n"
+            )
+            _input = {"user_input": user_input, "context": "", "response": response}
+            tokens, log_probs = self.response_chain.generate_tokens_and_log_probs(
+                _input, run_manager=_run_manager
+            )
+            low_confidence_spans = _low_confidence_spans(
+                tokens,
+                log_probs,
+                self.min_prob,
+                self.min_token_gap,
+                self.num_pad_tokens,
+            )
+            initial_response = response.strip() + " " + "".join(tokens)
+            if not low_confidence_spans:
+                response = initial_response
+                final_response, finished = self.output_parser.parse(response)
+                if finished:
+                    return {self.output_keys[0]: final_response}
+                continue
+
+            marginal, finished = self._do_retrieval(
+                low_confidence_spans,
+                _run_manager,
+                user_input,
+                response,
+                initial_response,
+            )
+            response = response.strip() + " " + marginal
+            if finished:
+                break
+        return {self.output_keys[0]: response}
+
+    @classmethod
+    def from_llm(
+        cls, llm: BaseLanguageModel, max_generation_len: int = 32, **kwargs: Any
+    ) -> FlareChain:
+        """Creates a FlareChain from a language model.
+
+        Args:
+            llm: Language model to use.
+            max_generation_len: Maximum length of the generated response.
+            **kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            FlareChain class with the given language model.
+        """
+        question_gen_chain = QuestionGeneratorChain(llm=llm)
+        response_llm = OpenAI(
+            max_tokens=max_generation_len, model_kwargs={"logprobs": 1}, temperature=0
+        )
+        response_chain = _OpenAIResponseChain(llm=response_llm)
+        return cls(
+            question_generator_chain=question_gen_chain,
+            response_chain=response_chain,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/chains/flare/prompts.py b/llm/Lib/site-packages/langchain/chains/flare/prompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..22eda20d9c3754c52797cae2c328e146c6adc7dc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/flare/prompts.py
@@ -0,0 +1,46 @@
+from typing import Tuple
+
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompts import PromptTemplate
+
+
+class FinishedOutputParser(BaseOutputParser[Tuple[str, bool]]):
+    """Output parser that checks if the output is finished."""
+
+    finished_value: str = "FINISHED"
+    """Value that indicates the output is finished."""
+
+    def parse(self, text: str) -> Tuple[str, bool]:
+        cleaned = text.strip()
+        finished = self.finished_value in cleaned
+        return cleaned.replace(self.finished_value, ""), finished
+
+
+PROMPT_TEMPLATE = """\
+Respond to the user message using any relevant context. \
+If context is provided, you should ground your answer in that context. \
+Once you're done responding return FINISHED.
+
+>>> CONTEXT: {context}
+>>> USER INPUT: {user_input}
+>>> RESPONSE: {response}\
+"""
+
+PROMPT = PromptTemplate(
+    template=PROMPT_TEMPLATE,
+    input_variables=["user_input", "context", "response"],
+)
+
+
+QUESTION_GENERATOR_PROMPT_TEMPLATE = """\
+Given a user input and an existing partial response as context, \
+ask a question to which the answer is the given term/entity/phrase:
+
+>>> USER INPUT: {user_input}
+>>> EXISTING PARTIAL RESPONSE: {current_response}
+
+The question to which the answer is the term/entity/phrase "{uncertain_span}" is:"""
+QUESTION_GENERATOR_PROMPT = PromptTemplate(
+    template=QUESTION_GENERATOR_PROMPT_TEMPLATE,
+    input_variables=["user_input", "current_response", "uncertain_span"],
+)
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__init__.py b/llm/Lib/site-packages/langchain/chains/graph_qa/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f3bc55efbca8efd011ea4a5aa5fbd25bb5b4c457
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/__init__.py
@@ -0,0 +1 @@
+"""Question answering over a knowledge graph."""
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fe7daf0e258e40a1820f2c64924eab83f83ee447
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/arangodb.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/arangodb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aca70b3066cb99a4106ca00031cb0722431f904d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/arangodb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2f09059e668bf77060e7075aee69fb2641a8e012
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/cypher.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/cypher.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4bec455605fb53212f539743b575ca110bbab9c0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/cypher.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/cypher_utils.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/cypher_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a4e864e8f1d10697da0051b01a977889264aaa41
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/cypher_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/falkordb.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/falkordb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0ac51bd6cf2b19834520b6f1805b1589e9221e1f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/falkordb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/gremlin.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/gremlin.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..26fa97030f04ead2e6dd00ca9d7d8db22d71da2c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/gremlin.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/hugegraph.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/hugegraph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9711362bf98fa557d622b202a83fedb5972f212b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/hugegraph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/kuzu.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/kuzu.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0fe45b1fa62c74a8cc6cbb306fa323191ed51d29
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/kuzu.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/nebulagraph.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/nebulagraph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..49d0c5f45d12d7dc9abe8da7460efdd4fa0e1a87
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/nebulagraph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/neptune_cypher.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/neptune_cypher.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8581e6787d130ae9930532afeab9541941818b0a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/neptune_cypher.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/neptune_sparql.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/neptune_sparql.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4389421f230e4cac95dd409858d8e6d4b018d6fd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/neptune_sparql.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/ontotext_graphdb.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/ontotext_graphdb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..99e4d411df028c662979e9058ac8691cb4f46d7b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/ontotext_graphdb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/prompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/prompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..07026f6c14a04c69cfcdeb38db3ac654e33accc3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/prompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/sparql.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/sparql.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b4f7bc41cadf45c7878d54b8200d3a090eed2c74
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/graph_qa/__pycache__/sparql.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/arangodb.py b/llm/Lib/site-packages/langchain/chains/graph_qa/arangodb.py
new file mode 100644
index 0000000000000000000000000000000000000000..4c723e2046fab5ad673b125763495b3d69097bd9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/arangodb.py
@@ -0,0 +1,241 @@
+"""Question answering over a graph."""
+from __future__ import annotations
+
+import re
+from typing import Any, Dict, List, Optional
+
+from langchain_community.graphs.arangodb_graph import ArangoGraph
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+
+from langchain.chains.base import Chain
+from langchain.chains.graph_qa.prompts import (
+    AQL_FIX_PROMPT,
+    AQL_GENERATION_PROMPT,
+    AQL_QA_PROMPT,
+)
+from langchain.chains.llm import LLMChain
+
+
+class ArangoGraphQAChain(Chain):
+    """Chain for question-answering against a graph by generating AQL statements.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    graph: ArangoGraph = Field(exclude=True)
+    aql_generation_chain: LLMChain
+    aql_fix_chain: LLMChain
+    qa_chain: LLMChain
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+
+    # Specifies the maximum number of AQL Query Results to return
+    top_k: int = 10
+
+    # Specifies the set of AQL Query Examples that promote few-shot-learning
+    aql_examples: str = ""
+
+    # Specify whether to return the AQL Query in the output dictionary
+    return_aql_query: bool = False
+
+    # Specify whether to return the AQL JSON Result in the output dictionary
+    return_aql_result: bool = False
+
+    # Specify the maximum amount of AQL Generation attempts that should be made
+    max_aql_generation_attempts: int = 3
+
+    @property
+    def input_keys(self) -> List[str]:
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        return [self.output_key]
+
+    @property
+    def _chain_type(self) -> str:
+        return "graph_aql_chain"
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        qa_prompt: BasePromptTemplate = AQL_QA_PROMPT,
+        aql_generation_prompt: BasePromptTemplate = AQL_GENERATION_PROMPT,
+        aql_fix_prompt: BasePromptTemplate = AQL_FIX_PROMPT,
+        **kwargs: Any,
+    ) -> ArangoGraphQAChain:
+        """Initialize from LLM."""
+        qa_chain = LLMChain(llm=llm, prompt=qa_prompt)
+        aql_generation_chain = LLMChain(llm=llm, prompt=aql_generation_prompt)
+        aql_fix_chain = LLMChain(llm=llm, prompt=aql_fix_prompt)
+
+        return cls(
+            qa_chain=qa_chain,
+            aql_generation_chain=aql_generation_chain,
+            aql_fix_chain=aql_fix_chain,
+            **kwargs,
+        )
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """
+        Generate an AQL statement from user input, use it retrieve a response
+        from an ArangoDB Database instance, and respond to the user input
+        in natural language.
+
+        Users can modify the following ArangoGraphQAChain Class Variables:
+
+        :var top_k: The maximum number of AQL Query Results to return
+        :type top_k: int
+
+        :var aql_examples: A set of AQL Query Examples that are passed to
+            the AQL Generation Prompt Template to promote few-shot-learning.
+            Defaults to an empty string.
+        :type aql_examples: str
+
+        :var return_aql_query: Whether to return the AQL Query in the
+            output dictionary. Defaults to False.
+        :type return_aql_query: bool
+
+        :var return_aql_result: Whether to return the AQL Query in the
+            output dictionary. Defaults to False
+        :type return_aql_result: bool
+
+        :var max_aql_generation_attempts: The maximum amount of AQL
+            Generation attempts to be made prior to raising the last
+            AQL Query Execution Error. Defaults to 3.
+        :type max_aql_generation_attempts: int
+        """
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        user_input = inputs[self.input_key]
+
+        #########################
+        # Generate AQL Query #
+        aql_generation_output = self.aql_generation_chain.run(
+            {
+                "adb_schema": self.graph.schema,
+                "aql_examples": self.aql_examples,
+                "user_input": user_input,
+            },
+            callbacks=callbacks,
+        )
+        #########################
+
+        aql_query = ""
+        aql_error = ""
+        aql_result = None
+        aql_generation_attempt = 1
+
+        while (
+            aql_result is None
+            and aql_generation_attempt < self.max_aql_generation_attempts + 1
+        ):
+            #####################
+            # Extract AQL Query #
+            pattern = r"```(?i:aql)?(.*?)```"
+            matches = re.findall(pattern, aql_generation_output, re.DOTALL)
+            if not matches:
+                _run_manager.on_text(
+                    "Invalid Response: ", end="\n", verbose=self.verbose
+                )
+                _run_manager.on_text(
+                    aql_generation_output, color="red", end="\n", verbose=self.verbose
+                )
+                raise ValueError(f"Response is Invalid: {aql_generation_output}")
+
+            aql_query = matches[0]
+            #####################
+
+            _run_manager.on_text(
+                f"AQL Query ({aql_generation_attempt}):", verbose=self.verbose
+            )
+            _run_manager.on_text(
+                aql_query, color="green", end="\n", verbose=self.verbose
+            )
+
+            #####################
+            # Execute AQL Query #
+            from arango import AQLQueryExecuteError
+
+            try:
+                aql_result = self.graph.query(aql_query, self.top_k)
+            except AQLQueryExecuteError as e:
+                aql_error = e.error_message
+
+                _run_manager.on_text(
+                    "AQL Query Execution Error: ", end="\n", verbose=self.verbose
+                )
+                _run_manager.on_text(
+                    aql_error, color="yellow", end="\n\n", verbose=self.verbose
+                )
+
+                ########################
+                # Retry AQL Generation #
+                aql_generation_output = self.aql_fix_chain.run(
+                    {
+                        "adb_schema": self.graph.schema,
+                        "aql_query": aql_query,
+                        "aql_error": aql_error,
+                    },
+                    callbacks=callbacks,
+                )
+                ########################
+
+            #####################
+
+            aql_generation_attempt += 1
+
+        if aql_result is None:
+            m = f"""
+                Maximum amount of AQL Query Generation attempts reached.
+                Unable to execute the AQL Query due to the following error:
+                {aql_error}
+            """
+            raise ValueError(m)
+
+        _run_manager.on_text("AQL Result:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            str(aql_result), color="green", end="\n", verbose=self.verbose
+        )
+
+        ########################
+        # Interpret AQL Result #
+        result = self.qa_chain(
+            {
+                "adb_schema": self.graph.schema,
+                "user_input": user_input,
+                "aql_query": aql_query,
+                "aql_result": aql_result,
+            },
+            callbacks=callbacks,
+        )
+        ########################
+
+        # Return results #
+        result = {self.output_key: result[self.qa_chain.output_key]}
+
+        if self.return_aql_query:
+            result["aql_query"] = aql_query
+
+        if self.return_aql_result:
+            result["aql_result"] = aql_result
+
+        return result
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/base.py b/llm/Lib/site-packages/langchain/chains/graph_qa/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..2465bfae6abda27b07f009f719473ff603cb90ec
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/base.py
@@ -0,0 +1,100 @@
+"""Question answering over a graph."""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+from langchain_community.graphs.networkx_graph import NetworkxEntityGraph, get_entities
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+
+from langchain.callbacks.manager import CallbackManagerForChainRun
+from langchain.chains.base import Chain
+from langchain.chains.graph_qa.prompts import ENTITY_EXTRACTION_PROMPT, GRAPH_QA_PROMPT
+from langchain.chains.llm import LLMChain
+
+
+class GraphQAChain(Chain):
+    """Chain for question-answering against a graph.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    graph: NetworkxEntityGraph = Field(exclude=True)
+    entity_extraction_chain: LLMChain
+    qa_chain: LLMChain
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Input keys.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Output keys.
+
+        :meta private:
+        """
+        _output_keys = [self.output_key]
+        return _output_keys
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        qa_prompt: BasePromptTemplate = GRAPH_QA_PROMPT,
+        entity_prompt: BasePromptTemplate = ENTITY_EXTRACTION_PROMPT,
+        **kwargs: Any,
+    ) -> GraphQAChain:
+        """Initialize from LLM."""
+        qa_chain = LLMChain(llm=llm, prompt=qa_prompt)
+        entity_chain = LLMChain(llm=llm, prompt=entity_prompt)
+
+        return cls(
+            qa_chain=qa_chain,
+            entity_extraction_chain=entity_chain,
+            **kwargs,
+        )
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        """Extract entities, look up info and answer question."""
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        question = inputs[self.input_key]
+
+        entity_string = self.entity_extraction_chain.run(question)
+
+        _run_manager.on_text("Entities Extracted:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            entity_string, color="green", end="\n", verbose=self.verbose
+        )
+        entities = get_entities(entity_string)
+        context = ""
+        all_triplets = []
+        for entity in entities:
+            all_triplets.extend(self.graph.get_entity_knowledge(entity))
+        context = "\n".join(all_triplets)
+        _run_manager.on_text("Full Context:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(context, color="green", end="\n", verbose=self.verbose)
+        result = self.qa_chain(
+            {"question": question, "context": context},
+            callbacks=_run_manager.get_child(),
+        )
+        return {self.output_key: result[self.qa_chain.output_key]}
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/cypher.py b/llm/Lib/site-packages/langchain/chains/graph_qa/cypher.py
new file mode 100644
index 0000000000000000000000000000000000000000..7682de853ad67785382e8d0db177b5b981c59dfd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/cypher.py
@@ -0,0 +1,292 @@
+"""Question answering over a graph."""
+from __future__ import annotations
+
+import re
+from typing import Any, Dict, List, Optional
+
+from langchain_community.graphs.graph_store import GraphStore
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+
+from langchain.chains.base import Chain
+from langchain.chains.graph_qa.cypher_utils import CypherQueryCorrector, Schema
+from langchain.chains.graph_qa.prompts import CYPHER_GENERATION_PROMPT, CYPHER_QA_PROMPT
+from langchain.chains.llm import LLMChain
+
+INTERMEDIATE_STEPS_KEY = "intermediate_steps"
+
+
+def extract_cypher(text: str) -> str:
+    """Extract Cypher code from a text.
+
+    Args:
+        text: Text to extract Cypher code from.
+
+    Returns:
+        Cypher code extracted from the text.
+    """
+    # The pattern to find Cypher code enclosed in triple backticks
+    pattern = r"```(.*?)```"
+
+    # Find all matches in the input text
+    matches = re.findall(pattern, text, re.DOTALL)
+
+    return matches[0] if matches else text
+
+
+def construct_schema(
+    structured_schema: Dict[str, Any],
+    include_types: List[str],
+    exclude_types: List[str],
+) -> str:
+    """Filter the schema based on included or excluded types"""
+
+    def filter_func(x: str) -> bool:
+        return x in include_types if include_types else x not in exclude_types
+
+    filtered_schema: Dict[str, Any] = {
+        "node_props": {
+            k: v
+            for k, v in structured_schema.get("node_props", {}).items()
+            if filter_func(k)
+        },
+        "rel_props": {
+            k: v
+            for k, v in structured_schema.get("rel_props", {}).items()
+            if filter_func(k)
+        },
+        "relationships": [
+            r
+            for r in structured_schema.get("relationships", [])
+            if all(filter_func(r[t]) for t in ["start", "end", "type"])
+        ],
+    }
+
+    # Format node properties
+    formatted_node_props = []
+    for label, properties in filtered_schema["node_props"].items():
+        props_str = ", ".join(
+            [f"{prop['property']}: {prop['type']}" for prop in properties]
+        )
+        formatted_node_props.append(f"{label} {{{props_str}}}")
+
+    # Format relationship properties
+    formatted_rel_props = []
+    for rel_type, properties in filtered_schema["rel_props"].items():
+        props_str = ", ".join(
+            [f"{prop['property']}: {prop['type']}" for prop in properties]
+        )
+        formatted_rel_props.append(f"{rel_type} {{{props_str}}}")
+
+    # Format relationships
+    formatted_rels = [
+        f"(:{el['start']})-[:{el['type']}]->(:{el['end']})"
+        for el in filtered_schema["relationships"]
+    ]
+
+    return "\n".join(
+        [
+            "Node properties are the following:",
+            ",".join(formatted_node_props),
+            "Relationship properties are the following:",
+            ",".join(formatted_rel_props),
+            "The relationships are the following:",
+            ",".join(formatted_rels),
+        ]
+    )
+
+
+class GraphCypherQAChain(Chain):
+    """Chain for question-answering against a graph by generating Cypher statements.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    graph: GraphStore = Field(exclude=True)
+    cypher_generation_chain: LLMChain
+    qa_chain: LLMChain
+    graph_schema: str
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+    top_k: int = 10
+    """Number of results to return from the query"""
+    return_intermediate_steps: bool = False
+    """Whether or not to return the intermediate steps along with the final answer."""
+    return_direct: bool = False
+    """Whether or not to return the result of querying the graph directly."""
+    cypher_query_corrector: Optional[CypherQueryCorrector] = None
+    """Optional cypher validation tool"""
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the input keys.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return the output keys.
+
+        :meta private:
+        """
+        _output_keys = [self.output_key]
+        return _output_keys
+
+    @property
+    def _chain_type(self) -> str:
+        return "graph_cypher_chain"
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: Optional[BaseLanguageModel] = None,
+        *,
+        qa_prompt: Optional[BasePromptTemplate] = None,
+        cypher_prompt: Optional[BasePromptTemplate] = None,
+        cypher_llm: Optional[BaseLanguageModel] = None,
+        qa_llm: Optional[BaseLanguageModel] = None,
+        exclude_types: List[str] = [],
+        include_types: List[str] = [],
+        validate_cypher: bool = False,
+        qa_llm_kwargs: Optional[Dict[str, Any]] = None,
+        cypher_llm_kwargs: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> GraphCypherQAChain:
+        """Initialize from LLM."""
+
+        if not cypher_llm and not llm:
+            raise ValueError("Either `llm` or `cypher_llm` parameters must be provided")
+        if not qa_llm and not llm:
+            raise ValueError("Either `llm` or `qa_llm` parameters must be provided")
+        if cypher_llm and qa_llm and llm:
+            raise ValueError(
+                "You can specify up to two of 'cypher_llm', 'qa_llm'"
+                ", and 'llm', but not all three simultaneously."
+            )
+        if cypher_prompt and cypher_llm_kwargs:
+            raise ValueError(
+                "Specifying cypher_prompt and cypher_llm_kwargs together is"
+                " not allowed. Please pass prompt via cypher_llm_kwargs."
+            )
+        if qa_prompt and qa_llm_kwargs:
+            raise ValueError(
+                "Specifying qa_prompt and qa_llm_kwargs together is"
+                " not allowed. Please pass prompt via qa_llm_kwargs."
+            )
+        use_qa_llm_kwargs = qa_llm_kwargs if qa_llm_kwargs is not None else {}
+        use_cypher_llm_kwargs = (
+            cypher_llm_kwargs if cypher_llm_kwargs is not None else {}
+        )
+        if "prompt" not in use_qa_llm_kwargs:
+            use_qa_llm_kwargs["prompt"] = (
+                qa_prompt if qa_prompt is not None else CYPHER_QA_PROMPT
+            )
+        if "prompt" not in use_cypher_llm_kwargs:
+            use_cypher_llm_kwargs["prompt"] = (
+                cypher_prompt if cypher_prompt is not None else CYPHER_GENERATION_PROMPT
+            )
+
+        qa_chain = LLMChain(llm=qa_llm or llm, **use_qa_llm_kwargs)  # type: ignore[arg-type]
+
+        cypher_generation_chain = LLMChain(
+            llm=cypher_llm or llm,  # type: ignore[arg-type]
+            **use_cypher_llm_kwargs,  # type: ignore[arg-type]
+        )
+
+        if exclude_types and include_types:
+            raise ValueError(
+                "Either `exclude_types` or `include_types` "
+                "can be provided, but not both"
+            )
+
+        graph_schema = construct_schema(
+            kwargs["graph"].get_structured_schema, include_types, exclude_types
+        )
+
+        cypher_query_corrector = None
+        if validate_cypher:
+            corrector_schema = [
+                Schema(el["start"], el["type"], el["end"])
+                for el in kwargs["graph"].structured_schema.get("relationships")
+            ]
+            cypher_query_corrector = CypherQueryCorrector(corrector_schema)
+
+        return cls(
+            graph_schema=graph_schema,
+            qa_chain=qa_chain,
+            cypher_generation_chain=cypher_generation_chain,
+            cypher_query_corrector=cypher_query_corrector,
+            **kwargs,
+        )
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Generate Cypher statement, use it to look up in db and answer question."""
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        question = inputs[self.input_key]
+
+        intermediate_steps: List = []
+
+        generated_cypher = self.cypher_generation_chain.run(
+            {"question": question, "schema": self.graph_schema}, callbacks=callbacks
+        )
+
+        # Extract Cypher code if it is wrapped in backticks
+        generated_cypher = extract_cypher(generated_cypher)
+
+        # Correct Cypher query if enabled
+        if self.cypher_query_corrector:
+            generated_cypher = self.cypher_query_corrector(generated_cypher)
+
+        _run_manager.on_text("Generated Cypher:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            generated_cypher, color="green", end="\n", verbose=self.verbose
+        )
+
+        intermediate_steps.append({"query": generated_cypher})
+
+        # Retrieve and limit the number of results
+        # Generated Cypher be null if query corrector identifies invalid schema
+        if generated_cypher:
+            context = self.graph.query(generated_cypher)[: self.top_k]
+        else:
+            context = []
+
+        if self.return_direct:
+            final_result = context
+        else:
+            _run_manager.on_text("Full Context:", end="\n", verbose=self.verbose)
+            _run_manager.on_text(
+                str(context), color="green", end="\n", verbose=self.verbose
+            )
+
+            intermediate_steps.append({"context": context})
+
+            result = self.qa_chain(
+                {"question": question, "context": context},
+                callbacks=callbacks,
+            )
+            final_result = result[self.qa_chain.output_key]
+
+        chain_result: Dict[str, Any] = {self.output_key: final_result}
+        if self.return_intermediate_steps:
+            chain_result[INTERMEDIATE_STEPS_KEY] = intermediate_steps
+
+        return chain_result
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/cypher_utils.py b/llm/Lib/site-packages/langchain/chains/graph_qa/cypher_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..c123cac9b52f353a25cc07e4fb9b02712b52e658
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/cypher_utils.py
@@ -0,0 +1,260 @@
+import re
+from collections import namedtuple
+from typing import Any, Dict, List, Optional, Tuple
+
+Schema = namedtuple("Schema", ["left_node", "relation", "right_node"])
+
+
+class CypherQueryCorrector:
+    """
+    Used to correct relationship direction in generated Cypher statements.
+    This code is copied from the winner's submission to the Cypher competition:
+    https://github.com/sakusaku-rich/cypher-direction-competition
+    """
+
+    property_pattern = re.compile(r"\{.+?\}")
+    node_pattern = re.compile(r"\(.+?\)")
+    path_pattern = re.compile(
+        r"(\([^\,\(\)]*?(\{.+\})?[^\,\(\)]*?\))(<?-)(\[.*?\])?(->?)(\([^\,\(\)]*?(\{.+\})?[^\,\(\)]*?\))"
+    )
+    node_relation_node_pattern = re.compile(
+        r"(\()+(?P<left_node>[^()]*?)\)(?P<relation>.*?)\((?P<right_node>[^()]*?)(\))+"
+    )
+    relation_type_pattern = re.compile(r":(?P<relation_type>.+?)?(\{.+\})?]")
+
+    def __init__(self, schemas: List[Schema]):
+        """
+        Args:
+            schemas: list of schemas
+        """
+        self.schemas = schemas
+
+    def clean_node(self, node: str) -> str:
+        """
+        Args:
+            node: node in string format
+
+        """
+        node = re.sub(self.property_pattern, "", node)
+        node = node.replace("(", "")
+        node = node.replace(")", "")
+        node = node.strip()
+        return node
+
+    def detect_node_variables(self, query: str) -> Dict[str, List[str]]:
+        """
+        Args:
+            query: cypher query
+        """
+        nodes = re.findall(self.node_pattern, query)
+        nodes = [self.clean_node(node) for node in nodes]
+        res: Dict[str, Any] = {}
+        for node in nodes:
+            parts = node.split(":")
+            if parts == "":
+                continue
+            variable = parts[0]
+            if variable not in res:
+                res[variable] = []
+            res[variable] += parts[1:]
+        return res
+
+    def extract_paths(self, query: str) -> "List[str]":
+        """
+        Args:
+            query: cypher query
+        """
+        paths = []
+        idx = 0
+        while matched := self.path_pattern.findall(query[idx:]):
+            matched = matched[0]
+            matched = [
+                m for i, m in enumerate(matched) if i not in [1, len(matched) - 1]
+            ]
+            path = "".join(matched)
+            idx = query.find(path) + len(path) - len(matched[-1])
+            paths.append(path)
+        return paths
+
+    def judge_direction(self, relation: str) -> str:
+        """
+        Args:
+            relation: relation in string format
+        """
+        direction = "BIDIRECTIONAL"
+        if relation[0] == "<":
+            direction = "INCOMING"
+        if relation[-1] == ">":
+            direction = "OUTGOING"
+        return direction
+
+    def extract_node_variable(self, part: str) -> Optional[str]:
+        """
+        Args:
+            part: node in string format
+        """
+        part = part.lstrip("(").rstrip(")")
+        idx = part.find(":")
+        if idx != -1:
+            part = part[:idx]
+        return None if part == "" else part
+
+    def detect_labels(
+        self, str_node: str, node_variable_dict: Dict[str, Any]
+    ) -> List[str]:
+        """
+        Args:
+            str_node: node in string format
+            node_variable_dict: dictionary of node variables
+        """
+        splitted_node = str_node.split(":")
+        variable = splitted_node[0]
+        labels = []
+        if variable in node_variable_dict:
+            labels = node_variable_dict[variable]
+        elif variable == "" and len(splitted_node) > 1:
+            labels = splitted_node[1:]
+        return labels
+
+    def verify_schema(
+        self,
+        from_node_labels: List[str],
+        relation_types: List[str],
+        to_node_labels: List[str],
+    ) -> bool:
+        """
+        Args:
+            from_node_labels: labels of the from node
+            relation_type: type of the relation
+            to_node_labels: labels of the to node
+        """
+        valid_schemas = self.schemas
+        if from_node_labels != []:
+            from_node_labels = [label.strip("`") for label in from_node_labels]
+            valid_schemas = [
+                schema for schema in valid_schemas if schema[0] in from_node_labels
+            ]
+        if to_node_labels != []:
+            to_node_labels = [label.strip("`") for label in to_node_labels]
+            valid_schemas = [
+                schema for schema in valid_schemas if schema[2] in to_node_labels
+            ]
+        if relation_types != []:
+            relation_types = [type.strip("`") for type in relation_types]
+            valid_schemas = [
+                schema for schema in valid_schemas if schema[1] in relation_types
+            ]
+        return valid_schemas != []
+
+    def detect_relation_types(self, str_relation: str) -> Tuple[str, List[str]]:
+        """
+        Args:
+            str_relation: relation in string format
+        """
+        relation_direction = self.judge_direction(str_relation)
+        relation_type = self.relation_type_pattern.search(str_relation)
+        if relation_type is None or relation_type.group("relation_type") is None:
+            return relation_direction, []
+        relation_types = [
+            t.strip().strip("!")
+            for t in relation_type.group("relation_type").split("|")
+        ]
+        return relation_direction, relation_types
+
+    def correct_query(self, query: str) -> str:
+        """
+        Args:
+            query: cypher query
+        """
+        node_variable_dict = self.detect_node_variables(query)
+        paths = self.extract_paths(query)
+        for path in paths:
+            original_path = path
+            start_idx = 0
+            while start_idx < len(path):
+                match_res = re.match(self.node_relation_node_pattern, path[start_idx:])
+                if match_res is None:
+                    break
+                start_idx += match_res.start()
+                match_dict = match_res.groupdict()
+                left_node_labels = self.detect_labels(
+                    match_dict["left_node"], node_variable_dict
+                )
+                right_node_labels = self.detect_labels(
+                    match_dict["right_node"], node_variable_dict
+                )
+                end_idx = (
+                    start_idx
+                    + 4
+                    + len(match_dict["left_node"])
+                    + len(match_dict["relation"])
+                    + len(match_dict["right_node"])
+                )
+                original_partial_path = original_path[start_idx : end_idx + 1]
+                relation_direction, relation_types = self.detect_relation_types(
+                    match_dict["relation"]
+                )
+
+                if relation_types != [] and "".join(relation_types).find("*") != -1:
+                    start_idx += (
+                        len(match_dict["left_node"]) + len(match_dict["relation"]) + 2
+                    )
+                    continue
+
+                if relation_direction == "OUTGOING":
+                    is_legal = self.verify_schema(
+                        left_node_labels, relation_types, right_node_labels
+                    )
+                    if not is_legal:
+                        is_legal = self.verify_schema(
+                            right_node_labels, relation_types, left_node_labels
+                        )
+                        if is_legal:
+                            corrected_relation = "<" + match_dict["relation"][:-1]
+                            corrected_partial_path = original_partial_path.replace(
+                                match_dict["relation"], corrected_relation
+                            )
+                            query = query.replace(
+                                original_partial_path, corrected_partial_path
+                            )
+                        else:
+                            return ""
+                elif relation_direction == "INCOMING":
+                    is_legal = self.verify_schema(
+                        right_node_labels, relation_types, left_node_labels
+                    )
+                    if not is_legal:
+                        is_legal = self.verify_schema(
+                            left_node_labels, relation_types, right_node_labels
+                        )
+                        if is_legal:
+                            corrected_relation = match_dict["relation"][1:] + ">"
+                            corrected_partial_path = original_partial_path.replace(
+                                match_dict["relation"], corrected_relation
+                            )
+                            query = query.replace(
+                                original_partial_path, corrected_partial_path
+                            )
+                        else:
+                            return ""
+                else:
+                    is_legal = self.verify_schema(
+                        left_node_labels, relation_types, right_node_labels
+                    )
+                    is_legal |= self.verify_schema(
+                        right_node_labels, relation_types, left_node_labels
+                    )
+                    if not is_legal:
+                        return ""
+
+                start_idx += (
+                    len(match_dict["left_node"]) + len(match_dict["relation"]) + 2
+                )
+        return query
+
+    def __call__(self, query: str) -> str:
+        """Correct the query to make it valid. If
+        Args:
+            query: cypher query
+        """
+        return self.correct_query(query)
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/falkordb.py b/llm/Lib/site-packages/langchain/chains/graph_qa/falkordb.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7ead3d8714e03a5fb9e78452dcd887fe3ee2b3e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/falkordb.py
@@ -0,0 +1,154 @@
+"""Question answering over a graph."""
+from __future__ import annotations
+
+import re
+from typing import Any, Dict, List, Optional
+
+from langchain_community.graphs import FalkorDBGraph
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+
+from langchain.chains.base import Chain
+from langchain.chains.graph_qa.prompts import CYPHER_GENERATION_PROMPT, CYPHER_QA_PROMPT
+from langchain.chains.llm import LLMChain
+
+INTERMEDIATE_STEPS_KEY = "intermediate_steps"
+
+
+def extract_cypher(text: str) -> str:
+    """
+    Extract Cypher code from a text.
+    Args:
+        text: Text to extract Cypher code from.
+
+    Returns:
+        Cypher code extracted from the text.
+    """
+    # The pattern to find Cypher code enclosed in triple backticks
+    pattern = r"```(.*?)```"
+
+    # Find all matches in the input text
+    matches = re.findall(pattern, text, re.DOTALL)
+
+    return matches[0] if matches else text
+
+
+class FalkorDBQAChain(Chain):
+    """Chain for question-answering against a graph by generating Cypher statements.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    graph: FalkorDBGraph = Field(exclude=True)
+    cypher_generation_chain: LLMChain
+    qa_chain: LLMChain
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+    top_k: int = 10
+    """Number of results to return from the query"""
+    return_intermediate_steps: bool = False
+    """Whether or not to return the intermediate steps along with the final answer."""
+    return_direct: bool = False
+    """Whether or not to return the result of querying the graph directly."""
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the input keys.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return the output keys.
+
+        :meta private:
+        """
+        _output_keys = [self.output_key]
+        return _output_keys
+
+    @property
+    def _chain_type(self) -> str:
+        return "graph_cypher_chain"
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        qa_prompt: BasePromptTemplate = CYPHER_QA_PROMPT,
+        cypher_prompt: BasePromptTemplate = CYPHER_GENERATION_PROMPT,
+        **kwargs: Any,
+    ) -> FalkorDBQAChain:
+        """Initialize from LLM."""
+        qa_chain = LLMChain(llm=llm, prompt=qa_prompt)
+        cypher_generation_chain = LLMChain(llm=llm, prompt=cypher_prompt)
+
+        return cls(
+            qa_chain=qa_chain,
+            cypher_generation_chain=cypher_generation_chain,
+            **kwargs,
+        )
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Generate Cypher statement, use it to look up in db and answer question."""
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        question = inputs[self.input_key]
+
+        intermediate_steps: List = []
+
+        generated_cypher = self.cypher_generation_chain.run(
+            {"question": question, "schema": self.graph.schema}, callbacks=callbacks
+        )
+
+        # Extract Cypher code if it is wrapped in backticks
+        generated_cypher = extract_cypher(generated_cypher)
+
+        _run_manager.on_text("Generated Cypher:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            generated_cypher, color="green", end="\n", verbose=self.verbose
+        )
+
+        intermediate_steps.append({"query": generated_cypher})
+
+        # Retrieve and limit the number of results
+        context = self.graph.query(generated_cypher)[: self.top_k]
+
+        if self.return_direct:
+            final_result = context
+        else:
+            _run_manager.on_text("Full Context:", end="\n", verbose=self.verbose)
+            _run_manager.on_text(
+                str(context), color="green", end="\n", verbose=self.verbose
+            )
+
+            intermediate_steps.append({"context": context})
+
+            result = self.qa_chain(
+                {"question": question, "context": context},
+                callbacks=callbacks,
+            )
+            final_result = result[self.qa_chain.output_key]
+
+        chain_result: Dict[str, Any] = {self.output_key: final_result}
+        if self.return_intermediate_steps:
+            chain_result[INTERMEDIATE_STEPS_KEY] = intermediate_steps
+
+        return chain_result
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/gremlin.py b/llm/Lib/site-packages/langchain/chains/graph_qa/gremlin.py
new file mode 100644
index 0000000000000000000000000000000000000000..732e06bde8ae74d971d58c2fe6a0d0f762bf4d72
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/gremlin.py
@@ -0,0 +1,221 @@
+"""Question answering over a graph."""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+from langchain_community.graphs import GremlinGraph
+from langchain_core.callbacks.manager import CallbackManager, CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.pydantic_v1 import Field
+
+from langchain.chains.base import Chain
+from langchain.chains.graph_qa.prompts import (
+    CYPHER_QA_PROMPT,
+    GRAPHDB_SPARQL_FIX_TEMPLATE,
+    GREMLIN_GENERATION_PROMPT,
+)
+from langchain.chains.llm import LLMChain
+
+INTERMEDIATE_STEPS_KEY = "intermediate_steps"
+
+
+def extract_gremlin(text: str) -> str:
+    """Extract Gremlin code from a text.
+
+    Args:
+        text: Text to extract Gremlin code from.
+
+    Returns:
+        Gremlin code extracted from the text.
+    """
+    text = text.replace("`", "")
+    if text.startswith("gremlin"):
+        text = text[len("gremlin") :]
+    return text.replace("\n", "")
+
+
+class GremlinQAChain(Chain):
+    """Chain for question-answering against a graph by generating gremlin statements.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    graph: GremlinGraph = Field(exclude=True)
+    gremlin_generation_chain: LLMChain
+    qa_chain: LLMChain
+    gremlin_fix_chain: LLMChain
+    max_fix_retries: int = 3
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+    top_k: int = 100
+    return_direct: bool = False
+    return_intermediate_steps: bool = False
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Input keys.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Output keys.
+
+        :meta private:
+        """
+        _output_keys = [self.output_key]
+        return _output_keys
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        gremlin_fix_prompt: BasePromptTemplate = PromptTemplate(
+            input_variables=["error_message", "generated_sparql", "schema"],
+            template=GRAPHDB_SPARQL_FIX_TEMPLATE.replace("SPARQL", "Gremlin").replace(
+                "in Turtle format", ""
+            ),
+        ),
+        qa_prompt: BasePromptTemplate = CYPHER_QA_PROMPT,
+        gremlin_prompt: BasePromptTemplate = GREMLIN_GENERATION_PROMPT,
+        **kwargs: Any,
+    ) -> GremlinQAChain:
+        """Initialize from LLM."""
+        qa_chain = LLMChain(llm=llm, prompt=qa_prompt)
+        gremlin_generation_chain = LLMChain(llm=llm, prompt=gremlin_prompt)
+        gremlinl_fix_chain = LLMChain(llm=llm, prompt=gremlin_fix_prompt)
+        return cls(
+            qa_chain=qa_chain,
+            gremlin_generation_chain=gremlin_generation_chain,
+            gremlin_fix_chain=gremlinl_fix_chain,
+            **kwargs,
+        )
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        """Generate gremlin statement, use it to look up in db and answer question."""
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        question = inputs[self.input_key]
+
+        intermediate_steps: List = []
+
+        chain_response = self.gremlin_generation_chain.invoke(
+            {"question": question, "schema": self.graph.get_schema}, callbacks=callbacks
+        )
+
+        generated_gremlin = extract_gremlin(
+            chain_response[self.gremlin_generation_chain.output_key]
+        )
+
+        _run_manager.on_text("Generated gremlin:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            generated_gremlin, color="green", end="\n", verbose=self.verbose
+        )
+
+        intermediate_steps.append({"query": generated_gremlin})
+
+        if generated_gremlin:
+            context = self.execute_with_retry(
+                _run_manager, callbacks, generated_gremlin
+            )[: self.top_k]
+        else:
+            context = []
+
+        if self.return_direct:
+            final_result = context
+        else:
+            _run_manager.on_text("Full Context:", end="\n", verbose=self.verbose)
+            _run_manager.on_text(
+                str(context), color="green", end="\n", verbose=self.verbose
+            )
+
+            intermediate_steps.append({"context": context})
+
+            result = self.qa_chain.invoke(
+                {"question": question, "context": context},
+                callbacks=callbacks,
+            )
+            final_result = result[self.qa_chain.output_key]
+
+        chain_result: Dict[str, Any] = {self.output_key: final_result}
+        if self.return_intermediate_steps:
+            chain_result[INTERMEDIATE_STEPS_KEY] = intermediate_steps
+
+        return chain_result
+
+    def execute_query(self, query: str) -> List[Any]:
+        try:
+            return self.graph.query(query)
+        except Exception as e:
+            if hasattr(e, "status_message"):
+                raise ValueError(e.status_message)
+            else:
+                raise ValueError(str(e))
+
+    def execute_with_retry(
+        self,
+        _run_manager: CallbackManagerForChainRun,
+        callbacks: CallbackManager,
+        generated_gremlin: str,
+    ) -> List[Any]:
+        try:
+            return self.execute_query(generated_gremlin)
+        except Exception as e:
+            retries = 0
+            error_message = str(e)
+            self.log_invalid_query(_run_manager, generated_gremlin, error_message)
+
+            while retries < self.max_fix_retries:
+                try:
+                    fix_chain_result = self.gremlin_fix_chain.invoke(
+                        {
+                            "error_message": error_message,
+                            # we are borrowing template from sparql
+                            "generated_sparql": generated_gremlin,
+                            "schema": self.schema,
+                        },
+                        callbacks=callbacks,
+                    )
+                    fixed_gremlin = fix_chain_result[self.gremlin_fix_chain.output_key]
+                    return self.execute_query(fixed_gremlin)
+                except Exception as e:
+                    retries += 1
+                    parse_exception = str(e)
+                    self.log_invalid_query(_run_manager, fixed_gremlin, parse_exception)
+
+        raise ValueError("The generated Gremlin query is invalid.")
+
+    def log_invalid_query(
+        self,
+        _run_manager: CallbackManagerForChainRun,
+        generated_query: str,
+        error_message: str,
+    ) -> None:
+        _run_manager.on_text("Invalid Gremlin query: ", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            generated_query, color="red", end="\n", verbose=self.verbose
+        )
+        _run_manager.on_text(
+            "Gremlin Query Parse Error: ", end="\n", verbose=self.verbose
+        )
+        _run_manager.on_text(
+            error_message, color="red", end="\n\n", verbose=self.verbose
+        )
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/hugegraph.py b/llm/Lib/site-packages/langchain/chains/graph_qa/hugegraph.py
new file mode 100644
index 0000000000000000000000000000000000000000..9e1f02493798b71d84cb6bddac871f23645d4162
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/hugegraph.py
@@ -0,0 +1,106 @@
+"""Question answering over a graph."""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+from langchain_community.graphs.hugegraph import HugeGraph
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+
+from langchain.chains.base import Chain
+from langchain.chains.graph_qa.prompts import (
+    CYPHER_QA_PROMPT,
+    GREMLIN_GENERATION_PROMPT,
+)
+from langchain.chains.llm import LLMChain
+
+
+class HugeGraphQAChain(Chain):
+    """Chain for question-answering against a graph by generating gremlin statements.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    graph: HugeGraph = Field(exclude=True)
+    gremlin_generation_chain: LLMChain
+    qa_chain: LLMChain
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Input keys.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Output keys.
+
+        :meta private:
+        """
+        _output_keys = [self.output_key]
+        return _output_keys
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        qa_prompt: BasePromptTemplate = CYPHER_QA_PROMPT,
+        gremlin_prompt: BasePromptTemplate = GREMLIN_GENERATION_PROMPT,
+        **kwargs: Any,
+    ) -> HugeGraphQAChain:
+        """Initialize from LLM."""
+        qa_chain = LLMChain(llm=llm, prompt=qa_prompt)
+        gremlin_generation_chain = LLMChain(llm=llm, prompt=gremlin_prompt)
+
+        return cls(
+            qa_chain=qa_chain,
+            gremlin_generation_chain=gremlin_generation_chain,
+            **kwargs,
+        )
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        """Generate gremlin statement, use it to look up in db and answer question."""
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        question = inputs[self.input_key]
+
+        generated_gremlin = self.gremlin_generation_chain.run(
+            {"question": question, "schema": self.graph.get_schema}, callbacks=callbacks
+        )
+
+        _run_manager.on_text("Generated gremlin:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            generated_gremlin, color="green", end="\n", verbose=self.verbose
+        )
+        context = self.graph.query(generated_gremlin)
+
+        _run_manager.on_text("Full Context:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            str(context), color="green", end="\n", verbose=self.verbose
+        )
+
+        result = self.qa_chain(
+            {"question": question, "context": context},
+            callbacks=callbacks,
+        )
+        return {self.output_key: result[self.qa_chain.output_key]}
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/kuzu.py b/llm/Lib/site-packages/langchain/chains/graph_qa/kuzu.py
new file mode 100644
index 0000000000000000000000000000000000000000..7df4cdc8465847b459ec710046a568572cb818b6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/kuzu.py
@@ -0,0 +1,103 @@
+"""Question answering over a graph."""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+from langchain_community.graphs.kuzu_graph import KuzuGraph
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+
+from langchain.chains.base import Chain
+from langchain.chains.graph_qa.prompts import CYPHER_QA_PROMPT, KUZU_GENERATION_PROMPT
+from langchain.chains.llm import LLMChain
+
+
+class KuzuQAChain(Chain):
+    """Question-answering against a graph by generating Cypher statements for Kùzu.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    graph: KuzuGraph = Field(exclude=True)
+    cypher_generation_chain: LLMChain
+    qa_chain: LLMChain
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the input keys.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return the output keys.
+
+        :meta private:
+        """
+        _output_keys = [self.output_key]
+        return _output_keys
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        qa_prompt: BasePromptTemplate = CYPHER_QA_PROMPT,
+        cypher_prompt: BasePromptTemplate = KUZU_GENERATION_PROMPT,
+        **kwargs: Any,
+    ) -> KuzuQAChain:
+        """Initialize from LLM."""
+        qa_chain = LLMChain(llm=llm, prompt=qa_prompt)
+        cypher_generation_chain = LLMChain(llm=llm, prompt=cypher_prompt)
+
+        return cls(
+            qa_chain=qa_chain,
+            cypher_generation_chain=cypher_generation_chain,
+            **kwargs,
+        )
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        """Generate Cypher statement, use it to look up in db and answer question."""
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        question = inputs[self.input_key]
+
+        generated_cypher = self.cypher_generation_chain.run(
+            {"question": question, "schema": self.graph.get_schema}, callbacks=callbacks
+        )
+
+        _run_manager.on_text("Generated Cypher:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            generated_cypher, color="green", end="\n", verbose=self.verbose
+        )
+        context = self.graph.query(generated_cypher)
+
+        _run_manager.on_text("Full Context:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            str(context), color="green", end="\n", verbose=self.verbose
+        )
+
+        result = self.qa_chain(
+            {"question": question, "context": context},
+            callbacks=callbacks,
+        )
+        return {self.output_key: result[self.qa_chain.output_key]}
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/nebulagraph.py b/llm/Lib/site-packages/langchain/chains/graph_qa/nebulagraph.py
new file mode 100644
index 0000000000000000000000000000000000000000..e53eaefb35e137fd36297c1191b4c8056feabbd1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/nebulagraph.py
@@ -0,0 +1,103 @@
+"""Question answering over a graph."""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+from langchain_community.graphs.nebula_graph import NebulaGraph
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+
+from langchain.chains.base import Chain
+from langchain.chains.graph_qa.prompts import CYPHER_QA_PROMPT, NGQL_GENERATION_PROMPT
+from langchain.chains.llm import LLMChain
+
+
+class NebulaGraphQAChain(Chain):
+    """Chain for question-answering against a graph by generating nGQL statements.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    graph: NebulaGraph = Field(exclude=True)
+    ngql_generation_chain: LLMChain
+    qa_chain: LLMChain
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the input keys.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return the output keys.
+
+        :meta private:
+        """
+        _output_keys = [self.output_key]
+        return _output_keys
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        qa_prompt: BasePromptTemplate = CYPHER_QA_PROMPT,
+        ngql_prompt: BasePromptTemplate = NGQL_GENERATION_PROMPT,
+        **kwargs: Any,
+    ) -> NebulaGraphQAChain:
+        """Initialize from LLM."""
+        qa_chain = LLMChain(llm=llm, prompt=qa_prompt)
+        ngql_generation_chain = LLMChain(llm=llm, prompt=ngql_prompt)
+
+        return cls(
+            qa_chain=qa_chain,
+            ngql_generation_chain=ngql_generation_chain,
+            **kwargs,
+        )
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        """Generate nGQL statement, use it to look up in db and answer question."""
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        question = inputs[self.input_key]
+
+        generated_ngql = self.ngql_generation_chain.run(
+            {"question": question, "schema": self.graph.get_schema}, callbacks=callbacks
+        )
+
+        _run_manager.on_text("Generated nGQL:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            generated_ngql, color="green", end="\n", verbose=self.verbose
+        )
+        context = self.graph.query(generated_ngql)
+
+        _run_manager.on_text("Full Context:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            str(context), color="green", end="\n", verbose=self.verbose
+        )
+
+        result = self.qa_chain(
+            {"question": question, "context": context},
+            callbacks=callbacks,
+        )
+        return {self.output_key: result[self.qa_chain.output_key]}
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/neptune_cypher.py b/llm/Lib/site-packages/langchain/chains/graph_qa/neptune_cypher.py
new file mode 100644
index 0000000000000000000000000000000000000000..2b9447e70cb18e1d5cf331502e7f859dc91f2f31
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/neptune_cypher.py
@@ -0,0 +1,217 @@
+from __future__ import annotations
+
+import re
+from typing import Any, Dict, List, Optional
+
+from langchain_community.graphs import BaseNeptuneGraph
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts.base import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+
+from langchain.chains.base import Chain
+from langchain.chains.graph_qa.prompts import (
+    CYPHER_QA_PROMPT,
+    NEPTUNE_OPENCYPHER_GENERATION_PROMPT,
+    NEPTUNE_OPENCYPHER_GENERATION_SIMPLE_PROMPT,
+)
+from langchain.chains.llm import LLMChain
+from langchain.chains.prompt_selector import ConditionalPromptSelector
+
+INTERMEDIATE_STEPS_KEY = "intermediate_steps"
+
+
+def trim_query(query: str) -> str:
+    """Trim the query to only include Cypher keywords."""
+    keywords = (
+        "CALL",
+        "CREATE",
+        "DELETE",
+        "DETACH",
+        "LIMIT",
+        "MATCH",
+        "MERGE",
+        "OPTIONAL",
+        "ORDER",
+        "REMOVE",
+        "RETURN",
+        "SET",
+        "SKIP",
+        "UNWIND",
+        "WITH",
+        "WHERE",
+        "//",
+    )
+
+    lines = query.split("\n")
+    new_query = ""
+
+    for line in lines:
+        if line.strip().upper().startswith(keywords):
+            new_query += line + "\n"
+
+    return new_query
+
+
+def extract_cypher(text: str) -> str:
+    """Extract Cypher code from text using Regex."""
+    # The pattern to find Cypher code enclosed in triple backticks
+    pattern = r"```(.*?)```"
+
+    # Find all matches in the input text
+    matches = re.findall(pattern, text, re.DOTALL)
+
+    return matches[0] if matches else text
+
+
+def use_simple_prompt(llm: BaseLanguageModel) -> bool:
+    """Decides whether to use the simple prompt"""
+    if llm._llm_type and "anthropic" in llm._llm_type:  # type: ignore
+        return True
+
+    # Bedrock anthropic
+    if hasattr(llm, "model_id") and "anthropic" in llm.model_id:  # type: ignore
+        return True
+
+    return False
+
+
+PROMPT_SELECTOR = ConditionalPromptSelector(
+    default_prompt=NEPTUNE_OPENCYPHER_GENERATION_PROMPT,
+    conditionals=[(use_simple_prompt, NEPTUNE_OPENCYPHER_GENERATION_SIMPLE_PROMPT)],
+)
+
+
+class NeptuneOpenCypherQAChain(Chain):
+    """Chain for question-answering against a Neptune graph
+    by generating openCypher statements.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+
+    Example:
+        .. code-block:: python
+
+        chain = NeptuneOpenCypherQAChain.from_llm(
+            llm=llm,
+            graph=graph
+        )
+        response = chain.run(query)
+    """
+
+    graph: BaseNeptuneGraph = Field(exclude=True)
+    cypher_generation_chain: LLMChain
+    qa_chain: LLMChain
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+    top_k: int = 10
+    return_intermediate_steps: bool = False
+    """Whether or not to return the intermediate steps along with the final answer."""
+    return_direct: bool = False
+    """Whether or not to return the result of querying the graph directly."""
+    extra_instructions: Optional[str] = None
+    """Extra instructions by the appended to the query generation prompt."""
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the input keys.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return the output keys.
+
+        :meta private:
+        """
+        _output_keys = [self.output_key]
+        return _output_keys
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        qa_prompt: BasePromptTemplate = CYPHER_QA_PROMPT,
+        cypher_prompt: Optional[BasePromptTemplate] = None,
+        extra_instructions: Optional[str] = None,
+        **kwargs: Any,
+    ) -> NeptuneOpenCypherQAChain:
+        """Initialize from LLM."""
+        qa_chain = LLMChain(llm=llm, prompt=qa_prompt)
+
+        _cypher_prompt = cypher_prompt or PROMPT_SELECTOR.get_prompt(llm)
+        cypher_generation_chain = LLMChain(llm=llm, prompt=_cypher_prompt)
+
+        return cls(
+            qa_chain=qa_chain,
+            cypher_generation_chain=cypher_generation_chain,
+            extra_instructions=extra_instructions,
+            **kwargs,
+        )
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Generate Cypher statement, use it to look up in db and answer question."""
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        question = inputs[self.input_key]
+
+        intermediate_steps: List = []
+
+        generated_cypher = self.cypher_generation_chain.run(
+            {
+                "question": question,
+                "schema": self.graph.get_schema,
+                "extra_instructions": self.extra_instructions or "",
+            },
+            callbacks=callbacks,
+        )
+
+        # Extract Cypher code if it is wrapped in backticks
+        generated_cypher = extract_cypher(generated_cypher)
+        generated_cypher = trim_query(generated_cypher)
+
+        _run_manager.on_text("Generated Cypher:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            generated_cypher, color="green", end="\n", verbose=self.verbose
+        )
+
+        intermediate_steps.append({"query": generated_cypher})
+
+        context = self.graph.query(generated_cypher)
+
+        if self.return_direct:
+            final_result = context
+        else:
+            _run_manager.on_text("Full Context:", end="\n", verbose=self.verbose)
+            _run_manager.on_text(
+                str(context), color="green", end="\n", verbose=self.verbose
+            )
+
+            intermediate_steps.append({"context": context})
+
+            result = self.qa_chain(
+                {"question": question, "context": context},
+                callbacks=callbacks,
+            )
+            final_result = result[self.qa_chain.output_key]
+
+        chain_result: Dict[str, Any] = {self.output_key: final_result}
+        if self.return_intermediate_steps:
+            chain_result[INTERMEDIATE_STEPS_KEY] = intermediate_steps
+
+        return chain_result
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/neptune_sparql.py b/llm/Lib/site-packages/langchain/chains/graph_qa/neptune_sparql.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a5b23f58749568386f1d4c0d0717c8d356f6da9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/neptune_sparql.py
@@ -0,0 +1,196 @@
+"""
+Question answering over an RDF or OWL graph using SPARQL.
+"""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+from langchain_community.graphs import NeptuneRdfGraph
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts.base import BasePromptTemplate
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.pydantic_v1 import Field
+
+from langchain.callbacks.manager import CallbackManagerForChainRun
+from langchain.chains.base import Chain
+from langchain.chains.graph_qa.prompts import SPARQL_QA_PROMPT
+from langchain.chains.llm import LLMChain
+
+INTERMEDIATE_STEPS_KEY = "intermediate_steps"
+
+SPARQL_GENERATION_TEMPLATE = """
+Task: Generate a SPARQL SELECT statement for querying a graph database.
+For instance, to find all email addresses of John Doe, the following 
+query in backticks would be suitable:
+```
+PREFIX foaf: <http://xmlns.com/foaf/0.1/>
+SELECT ?email
+WHERE {{
+    ?person foaf:name "John Doe" .
+    ?person foaf:mbox ?email .
+}}
+```
+Instructions:
+Use only the node types and properties provided in the schema.
+Do not use any node types and properties that are not explicitly provided.
+Include all necessary prefixes.
+
+Examples:
+
+Schema:
+{schema}
+Note: Be as concise as possible.
+Do not include any explanations or apologies in your responses.
+Do not respond to any questions that ask for anything else than 
+for you to construct a SPARQL query.
+Do not include any text except the SPARQL query generated.
+
+The question is:
+{prompt}"""
+
+SPARQL_GENERATION_PROMPT = PromptTemplate(
+    input_variables=["schema", "prompt"], template=SPARQL_GENERATION_TEMPLATE
+)
+
+
+def extract_sparql(query: str) -> str:
+    query = query.strip()
+    querytoks = query.split("```")
+    if len(querytoks) == 3:
+        query = querytoks[1]
+
+        if query.startswith("sparql"):
+            query = query[6:]
+    elif query.startswith("<sparql>") and query.endswith("</sparql>"):
+        query = query[8:-9]
+    return query
+
+
+class NeptuneSparqlQAChain(Chain):
+    """Chain for question-answering against a Neptune graph
+    by generating SPARQL statements.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+
+    Example:
+        .. code-block:: python
+
+        chain = NeptuneSparqlQAChain.from_llm(
+            llm=llm,
+            graph=graph
+        )
+        response = chain.invoke(query)
+    """
+
+    graph: NeptuneRdfGraph = Field(exclude=True)
+    sparql_generation_chain: LLMChain
+    qa_chain: LLMChain
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+    top_k: int = 10
+    return_intermediate_steps: bool = False
+    """Whether or not to return the intermediate steps along with the final answer."""
+    return_direct: bool = False
+    """Whether or not to return the result of querying the graph directly."""
+    extra_instructions: Optional[str] = None
+    """Extra instructions by the appended to the query generation prompt."""
+
+    @property
+    def input_keys(self) -> List[str]:
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        _output_keys = [self.output_key]
+        return _output_keys
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        qa_prompt: BasePromptTemplate = SPARQL_QA_PROMPT,
+        sparql_prompt: BasePromptTemplate = SPARQL_GENERATION_PROMPT,
+        examples: Optional[str] = None,
+        **kwargs: Any,
+    ) -> NeptuneSparqlQAChain:
+        """Initialize from LLM."""
+        qa_chain = LLMChain(llm=llm, prompt=qa_prompt)
+        template_to_use = SPARQL_GENERATION_TEMPLATE
+        if examples:
+            template_to_use = template_to_use.replace(
+                "Examples:", "Examples: " + examples
+            )
+            sparql_prompt = PromptTemplate(
+                input_variables=["schema", "prompt"], template=template_to_use
+            )
+        sparql_generation_chain = LLMChain(llm=llm, prompt=sparql_prompt)
+
+        return cls(  # type: ignore[call-arg]
+            qa_chain=qa_chain,
+            sparql_generation_chain=sparql_generation_chain,
+            examples=examples,
+            **kwargs,
+        )
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        """
+        Generate SPARQL query, use it to retrieve a response from the gdb and answer
+        the question.
+        """
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        prompt = inputs[self.input_key]
+
+        intermediate_steps: List = []
+
+        generated_sparql = self.sparql_generation_chain.run(
+            {"prompt": prompt, "schema": self.graph.get_schema}, callbacks=callbacks
+        )
+
+        # Extract SPARQL
+        generated_sparql = extract_sparql(generated_sparql)
+
+        _run_manager.on_text("Generated SPARQL:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            generated_sparql, color="green", end="\n", verbose=self.verbose
+        )
+
+        intermediate_steps.append({"query": generated_sparql})
+
+        context = self.graph.query(generated_sparql)
+
+        if self.return_direct:
+            final_result = context
+        else:
+            _run_manager.on_text("Full Context:", end="\n", verbose=self.verbose)
+            _run_manager.on_text(
+                str(context), color="green", end="\n", verbose=self.verbose
+            )
+
+            intermediate_steps.append({"context": context})
+
+            result = self.qa_chain(
+                {"prompt": prompt, "context": context},
+                callbacks=callbacks,
+            )
+            final_result = result[self.qa_chain.output_key]
+
+        chain_result: Dict[str, Any] = {self.output_key: final_result}
+        if self.return_intermediate_steps:
+            chain_result[INTERMEDIATE_STEPS_KEY] = intermediate_steps
+
+        return chain_result
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/ontotext_graphdb.py b/llm/Lib/site-packages/langchain/chains/graph_qa/ontotext_graphdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..29d07d9d75b9825b67d7c910ed7e7fb08346fe43
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/ontotext_graphdb.py
@@ -0,0 +1,191 @@
+"""Question answering over a graph."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+if TYPE_CHECKING:
+    import rdflib
+
+from langchain_community.graphs import OntotextGraphDBGraph
+from langchain_core.callbacks.manager import CallbackManager
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts.base import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+
+from langchain.callbacks.manager import CallbackManagerForChainRun
+from langchain.chains.base import Chain
+from langchain.chains.graph_qa.prompts import (
+    GRAPHDB_QA_PROMPT,
+    GRAPHDB_SPARQL_FIX_PROMPT,
+    GRAPHDB_SPARQL_GENERATION_PROMPT,
+)
+from langchain.chains.llm import LLMChain
+
+
+class OntotextGraphDBQAChain(Chain):
+    """Question-answering against Ontotext GraphDB
+       https://graphdb.ontotext.com/ by generating SPARQL queries.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    graph: OntotextGraphDBGraph = Field(exclude=True)
+    sparql_generation_chain: LLMChain
+    sparql_fix_chain: LLMChain
+    max_fix_retries: int
+    qa_chain: LLMChain
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+
+    @property
+    def input_keys(self) -> List[str]:
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        _output_keys = [self.output_key]
+        return _output_keys
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        sparql_generation_prompt: BasePromptTemplate = GRAPHDB_SPARQL_GENERATION_PROMPT,
+        sparql_fix_prompt: BasePromptTemplate = GRAPHDB_SPARQL_FIX_PROMPT,
+        max_fix_retries: int = 5,
+        qa_prompt: BasePromptTemplate = GRAPHDB_QA_PROMPT,
+        **kwargs: Any,
+    ) -> OntotextGraphDBQAChain:
+        """Initialize from LLM."""
+        sparql_generation_chain = LLMChain(llm=llm, prompt=sparql_generation_prompt)
+        sparql_fix_chain = LLMChain(llm=llm, prompt=sparql_fix_prompt)
+        max_fix_retries = max_fix_retries
+        qa_chain = LLMChain(llm=llm, prompt=qa_prompt)
+        return cls(
+            qa_chain=qa_chain,
+            sparql_generation_chain=sparql_generation_chain,
+            sparql_fix_chain=sparql_fix_chain,
+            max_fix_retries=max_fix_retries,
+            **kwargs,
+        )
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        """
+        Generate a SPARQL query, use it to retrieve a response from GraphDB and answer
+        the question.
+        """
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        prompt = inputs[self.input_key]
+        ontology_schema = self.graph.get_schema
+
+        sparql_generation_chain_result = self.sparql_generation_chain.invoke(
+            {"prompt": prompt, "schema": ontology_schema}, callbacks=callbacks
+        )
+        generated_sparql = sparql_generation_chain_result[
+            self.sparql_generation_chain.output_key
+        ]
+
+        generated_sparql = self._get_prepared_sparql_query(
+            _run_manager, callbacks, generated_sparql, ontology_schema
+        )
+        query_results = self._execute_query(generated_sparql)
+
+        qa_chain_result = self.qa_chain.invoke(
+            {"prompt": prompt, "context": query_results}, callbacks=callbacks
+        )
+        result = qa_chain_result[self.qa_chain.output_key]
+        return {self.output_key: result}
+
+    def _get_prepared_sparql_query(
+        self,
+        _run_manager: CallbackManagerForChainRun,
+        callbacks: CallbackManager,
+        generated_sparql: str,
+        ontology_schema: str,
+    ) -> str:
+        try:
+            return self._prepare_sparql_query(_run_manager, generated_sparql)
+        except Exception as e:
+            retries = 0
+            error_message = str(e)
+            self._log_invalid_sparql_query(
+                _run_manager, generated_sparql, error_message
+            )
+
+            while retries < self.max_fix_retries:
+                try:
+                    sparql_fix_chain_result = self.sparql_fix_chain.invoke(
+                        {
+                            "error_message": error_message,
+                            "generated_sparql": generated_sparql,
+                            "schema": ontology_schema,
+                        },
+                        callbacks=callbacks,
+                    )
+                    generated_sparql = sparql_fix_chain_result[
+                        self.sparql_fix_chain.output_key
+                    ]
+                    return self._prepare_sparql_query(_run_manager, generated_sparql)
+                except Exception as e:
+                    retries += 1
+                    parse_exception = str(e)
+                    self._log_invalid_sparql_query(
+                        _run_manager, generated_sparql, parse_exception
+                    )
+
+        raise ValueError("The generated SPARQL query is invalid.")
+
+    def _prepare_sparql_query(
+        self, _run_manager: CallbackManagerForChainRun, generated_sparql: str
+    ) -> str:
+        from rdflib.plugins.sparql import prepareQuery
+
+        prepareQuery(generated_sparql)
+        self._log_prepared_sparql_query(_run_manager, generated_sparql)
+        return generated_sparql
+
+    def _log_prepared_sparql_query(
+        self, _run_manager: CallbackManagerForChainRun, generated_query: str
+    ) -> None:
+        _run_manager.on_text("Generated SPARQL:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            generated_query, color="green", end="\n", verbose=self.verbose
+        )
+
+    def _log_invalid_sparql_query(
+        self,
+        _run_manager: CallbackManagerForChainRun,
+        generated_query: str,
+        error_message: str,
+    ) -> None:
+        _run_manager.on_text("Invalid SPARQL query: ", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            generated_query, color="red", end="\n", verbose=self.verbose
+        )
+        _run_manager.on_text(
+            "SPARQL Query Parse Error: ", end="\n", verbose=self.verbose
+        )
+        _run_manager.on_text(
+            error_message, color="red", end="\n\n", verbose=self.verbose
+        )
+
+    def _execute_query(self, query: str) -> List[rdflib.query.ResultRow]:
+        try:
+            return self.graph.query(query)
+        except Exception:
+            raise ValueError("Failed to execute the generated SPARQL query.")
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/prompts.py b/llm/Lib/site-packages/langchain/chains/graph_qa/prompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..d83aef9a6224eaf97aa8fa158984b6ca8494d281
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/prompts.py
@@ -0,0 +1,414 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+_DEFAULT_ENTITY_EXTRACTION_TEMPLATE = """Extract all entities from the following text. As a guideline, a proper noun is generally capitalized. You should definitely extract all names and places.
+
+Return the output as a single comma-separated list, or NONE if there is nothing of note to return.
+
+EXAMPLE
+i'm trying to improve Langchain's interfaces, the UX, its integrations with various products the user might want ... a lot of stuff.
+Output: Langchain
+END OF EXAMPLE
+
+EXAMPLE
+i'm trying to improve Langchain's interfaces, the UX, its integrations with various products the user might want ... a lot of stuff. I'm working with Sam.
+Output: Langchain, Sam
+END OF EXAMPLE
+
+Begin!
+
+{input}
+Output:"""
+ENTITY_EXTRACTION_PROMPT = PromptTemplate(
+    input_variables=["input"], template=_DEFAULT_ENTITY_EXTRACTION_TEMPLATE
+)
+
+_DEFAULT_GRAPH_QA_TEMPLATE = """Use the following knowledge triplets to answer the question at the end. If you don't know the answer, just say that you don't know, don't try to make up an answer.
+
+{context}
+
+Question: {question}
+Helpful Answer:"""
+GRAPH_QA_PROMPT = PromptTemplate(
+    template=_DEFAULT_GRAPH_QA_TEMPLATE, input_variables=["context", "question"]
+)
+
+CYPHER_GENERATION_TEMPLATE = """Task:Generate Cypher statement to query a graph database.
+Instructions:
+Use only the provided relationship types and properties in the schema.
+Do not use any other relationship types or properties that are not provided.
+Schema:
+{schema}
+Note: Do not include any explanations or apologies in your responses.
+Do not respond to any questions that might ask anything else than for you to construct a Cypher statement.
+Do not include any text except the generated Cypher statement.
+
+The question is:
+{question}"""
+CYPHER_GENERATION_PROMPT = PromptTemplate(
+    input_variables=["schema", "question"], template=CYPHER_GENERATION_TEMPLATE
+)
+
+NEBULAGRAPH_EXTRA_INSTRUCTIONS = """
+Instructions:
+
+First, generate cypher then convert it to NebulaGraph Cypher dialect(rather than standard):
+1. it requires explicit label specification only when referring to node properties: v.`Foo`.name
+2. note explicit label specification is not needed for edge properties, so it's e.name instead of e.`Bar`.name
+3. it uses double equals sign for comparison: `==` rather than `=`
+For instance:
+```diff
+< MATCH (p:person)-[e:directed]->(m:movie) WHERE m.name = 'The Godfather II'
+< RETURN p.name, e.year, m.name;
+---
+> MATCH (p:`person`)-[e:directed]->(m:`movie`) WHERE m.`movie`.`name` == 'The Godfather II'
+> RETURN p.`person`.`name`, e.year, m.`movie`.`name`;
+```\n"""
+
+NGQL_GENERATION_TEMPLATE = CYPHER_GENERATION_TEMPLATE.replace(
+    "Generate Cypher", "Generate NebulaGraph Cypher"
+).replace("Instructions:", NEBULAGRAPH_EXTRA_INSTRUCTIONS)
+
+NGQL_GENERATION_PROMPT = PromptTemplate(
+    input_variables=["schema", "question"], template=NGQL_GENERATION_TEMPLATE
+)
+
+KUZU_EXTRA_INSTRUCTIONS = """
+Instructions:
+
+Generate statement with Kùzu Cypher dialect (rather than standard):
+1. do not use `WHERE EXISTS` clause to check the existence of a property because Kùzu database has a fixed schema.
+2. do not omit relationship pattern. Always use `()-[]->()` instead of `()->()`.
+3. do not include any notes or comments even if the statement does not produce the expected result.
+```\n"""
+
+KUZU_GENERATION_TEMPLATE = CYPHER_GENERATION_TEMPLATE.replace(
+    "Generate Cypher", "Generate Kùzu Cypher"
+).replace("Instructions:", KUZU_EXTRA_INSTRUCTIONS)
+
+KUZU_GENERATION_PROMPT = PromptTemplate(
+    input_variables=["schema", "question"], template=KUZU_GENERATION_TEMPLATE
+)
+
+GREMLIN_GENERATION_TEMPLATE = CYPHER_GENERATION_TEMPLATE.replace("Cypher", "Gremlin")
+
+GREMLIN_GENERATION_PROMPT = PromptTemplate(
+    input_variables=["schema", "question"], template=GREMLIN_GENERATION_TEMPLATE
+)
+
+CYPHER_QA_TEMPLATE = """You are an assistant that helps to form nice and human understandable answers.
+The information part contains the provided information that you must use to construct an answer.
+The provided information is authoritative, you must never doubt it or try to use your internal knowledge to correct it.
+Make the answer sound as a response to the question. Do not mention that you based the result on the given information.
+Here is an example:
+
+Question: Which managers own Neo4j stocks?
+Context:[manager:CTL LLC, manager:JANE STREET GROUP LLC]
+Helpful Answer: CTL LLC, JANE STREET GROUP LLC owns Neo4j stocks.
+
+Follow this example when generating answers.
+If the provided information is empty, say that you don't know the answer.
+Information:
+{context}
+
+Question: {question}
+Helpful Answer:"""
+CYPHER_QA_PROMPT = PromptTemplate(
+    input_variables=["context", "question"], template=CYPHER_QA_TEMPLATE
+)
+
+SPARQL_INTENT_TEMPLATE = """Task: Identify the intent of a prompt and return the appropriate SPARQL query type.
+You are an assistant that distinguishes different types of prompts and returns the corresponding SPARQL query types.
+Consider only the following query types:
+* SELECT: this query type corresponds to questions
+* UPDATE: this query type corresponds to all requests for deleting, inserting, or changing triples
+Note: Be as concise as possible.
+Do not include any explanations or apologies in your responses.
+Do not respond to any questions that ask for anything else than for you to identify a SPARQL query type.
+Do not include any unnecessary whitespaces or any text except the query type, i.e., either return 'SELECT' or 'UPDATE'.
+
+The prompt is:
+{prompt}
+Helpful Answer:"""
+SPARQL_INTENT_PROMPT = PromptTemplate(
+    input_variables=["prompt"], template=SPARQL_INTENT_TEMPLATE
+)
+
+SPARQL_GENERATION_SELECT_TEMPLATE = """Task: Generate a SPARQL SELECT statement for querying a graph database.
+For instance, to find all email addresses of John Doe, the following query in backticks would be suitable:
+```
+PREFIX foaf: <http://xmlns.com/foaf/0.1/>
+SELECT ?email
+WHERE {{
+    ?person foaf:name "John Doe" .
+    ?person foaf:mbox ?email .
+}}
+```
+Instructions:
+Use only the node types and properties provided in the schema.
+Do not use any node types and properties that are not explicitly provided.
+Include all necessary prefixes.
+Schema:
+{schema}
+Note: Be as concise as possible.
+Do not include any explanations or apologies in your responses.
+Do not respond to any questions that ask for anything else than for you to construct a SPARQL query.
+Do not include any text except the SPARQL query generated.
+
+The question is:
+{prompt}"""
+SPARQL_GENERATION_SELECT_PROMPT = PromptTemplate(
+    input_variables=["schema", "prompt"], template=SPARQL_GENERATION_SELECT_TEMPLATE
+)
+
+SPARQL_GENERATION_UPDATE_TEMPLATE = """Task: Generate a SPARQL UPDATE statement for updating a graph database.
+For instance, to add 'jane.doe@foo.bar' as a new email address for Jane Doe, the following query in backticks would be suitable:
+```
+PREFIX foaf: <http://xmlns.com/foaf/0.1/>
+INSERT {{
+    ?person foaf:mbox <mailto:jane.doe@foo.bar> .
+}}
+WHERE {{
+    ?person foaf:name "Jane Doe" .
+}}
+```
+Instructions:
+Make the query as short as possible and avoid adding unnecessary triples.
+Use only the node types and properties provided in the schema.
+Do not use any node types and properties that are not explicitly provided.
+Include all necessary prefixes.
+Schema:
+{schema}
+Note: Be as concise as possible.
+Do not include any explanations or apologies in your responses.
+Do not respond to any questions that ask for anything else than for you to construct a SPARQL query.
+Return only the generated SPARQL query, nothing else.
+
+The information to be inserted is:
+{prompt}"""
+SPARQL_GENERATION_UPDATE_PROMPT = PromptTemplate(
+    input_variables=["schema", "prompt"], template=SPARQL_GENERATION_UPDATE_TEMPLATE
+)
+
+SPARQL_QA_TEMPLATE = """Task: Generate a natural language response from the results of a SPARQL query.
+You are an assistant that creates well-written and human understandable answers.
+The information part contains the information provided, which you can use to construct an answer.
+The information provided is authoritative, you must never doubt it or try to use your internal knowledge to correct it.
+Make your response sound like the information is coming from an AI assistant, but don't add any information.
+Information:
+{context}
+
+Question: {prompt}
+Helpful Answer:"""
+SPARQL_QA_PROMPT = PromptTemplate(
+    input_variables=["context", "prompt"], template=SPARQL_QA_TEMPLATE
+)
+
+GRAPHDB_SPARQL_GENERATION_TEMPLATE = """
+Write a SPARQL SELECT query for querying a graph database.
+The ontology schema delimited by triple backticks in Turtle format is:
+```
+{schema}
+```
+Use only the classes and properties provided in the schema to construct the SPARQL query.
+Do not use any classes or properties that are not explicitly provided in the SPARQL query.
+Include all necessary prefixes.
+Do not include any explanations or apologies in your responses.
+Do not wrap the query in backticks.
+Do not include any text except the SPARQL query generated.
+The question delimited by triple backticks is:
+```
+{prompt}
+```
+"""
+GRAPHDB_SPARQL_GENERATION_PROMPT = PromptTemplate(
+    input_variables=["schema", "prompt"],
+    template=GRAPHDB_SPARQL_GENERATION_TEMPLATE,
+)
+
+GRAPHDB_SPARQL_FIX_TEMPLATE = """
+This following SPARQL query delimited by triple backticks
+```
+{generated_sparql}
+```
+is not valid.
+The error delimited by triple backticks is
+```
+{error_message}
+```
+Give me a correct version of the SPARQL query.
+Do not change the logic of the query.
+Do not include any explanations or apologies in your responses.
+Do not wrap the query in backticks.
+Do not include any text except the SPARQL query generated.
+The ontology schema delimited by triple backticks in Turtle format is:
+```
+{schema}
+```
+"""
+
+GRAPHDB_SPARQL_FIX_PROMPT = PromptTemplate(
+    input_variables=["error_message", "generated_sparql", "schema"],
+    template=GRAPHDB_SPARQL_FIX_TEMPLATE,
+)
+
+GRAPHDB_QA_TEMPLATE = """Task: Generate a natural language response from the results of a SPARQL query.
+You are an assistant that creates well-written and human understandable answers.
+The information part contains the information provided, which you can use to construct an answer.
+The information provided is authoritative, you must never doubt it or try to use your internal knowledge to correct it.
+Make your response sound like the information is coming from an AI assistant, but don't add any information.
+Don't use internal knowledge to answer the question, just say you don't know if no information is available.
+Information:
+{context}
+
+Question: {prompt}
+Helpful Answer:"""
+GRAPHDB_QA_PROMPT = PromptTemplate(
+    input_variables=["context", "prompt"], template=GRAPHDB_QA_TEMPLATE
+)
+
+AQL_GENERATION_TEMPLATE = """Task: Generate an ArangoDB Query Language (AQL) query from a User Input.
+
+You are an ArangoDB Query Language (AQL) expert responsible for translating a `User Input` into an ArangoDB Query Language (AQL) query.
+
+You are given an `ArangoDB Schema`. It is a JSON Object containing:
+1. `Graph Schema`: Lists all Graphs within the ArangoDB Database Instance, along with their Edge Relationships.
+2. `Collection Schema`: Lists all Collections within the ArangoDB Database Instance, along with their document/edge properties and a document/edge example.
+
+You may also be given a set of `AQL Query Examples` to help you create the `AQL Query`. If provided, the `AQL Query Examples` should be used as a reference, similar to how `ArangoDB Schema` should be used.
+
+Things you should do:
+- Think step by step.
+- Rely on `ArangoDB Schema` and `AQL Query Examples` (if provided) to generate the query.
+- Begin the `AQL Query` by the `WITH` AQL keyword to specify all of the ArangoDB Collections required.
+- Return the `AQL Query` wrapped in 3 backticks (```).
+- Use only the provided relationship types and properties in the `ArangoDB Schema` and any `AQL Query Examples` queries.
+- Only answer to requests related to generating an AQL Query.
+- If a request is unrelated to generating AQL Query, say that you cannot help the user.
+
+Things you should not do:
+- Do not use any properties/relationships that can't be inferred from the `ArangoDB Schema` or the `AQL Query Examples`. 
+- Do not include any text except the generated AQL Query.
+- Do not provide explanations or apologies in your responses.
+- Do not generate an AQL Query that removes or deletes any data.
+
+Under no circumstance should you generate an AQL Query that deletes any data whatsoever.
+
+ArangoDB Schema:
+{adb_schema}
+
+AQL Query Examples (Optional):
+{aql_examples}
+
+User Input:
+{user_input}
+
+AQL Query: 
+"""
+
+AQL_GENERATION_PROMPT = PromptTemplate(
+    input_variables=["adb_schema", "aql_examples", "user_input"],
+    template=AQL_GENERATION_TEMPLATE,
+)
+
+AQL_FIX_TEMPLATE = """Task: Address the ArangoDB Query Language (AQL) error message of an ArangoDB Query Language query.
+
+You are an ArangoDB Query Language (AQL) expert responsible for correcting the provided `AQL Query` based on the provided `AQL Error`. 
+
+The `AQL Error` explains why the `AQL Query` could not be executed in the database.
+The `AQL Error` may also contain the position of the error relative to the total number of lines of the `AQL Query`.
+For example, 'error X at position 2:5' denotes that the error X occurs on line 2, column 5 of the `AQL Query`.  
+
+You are also given the `ArangoDB Schema`. It is a JSON Object containing:
+1. `Graph Schema`: Lists all Graphs within the ArangoDB Database Instance, along with their Edge Relationships.
+2. `Collection Schema`: Lists all Collections within the ArangoDB Database Instance, along with their document/edge properties and a document/edge example.
+
+You will output the `Corrected AQL Query` wrapped in 3 backticks (```). Do not include any text except the Corrected AQL Query.
+
+Remember to think step by step.
+
+ArangoDB Schema:
+{adb_schema}
+
+AQL Query:
+{aql_query}
+
+AQL Error:
+{aql_error}
+
+Corrected AQL Query:
+"""
+
+AQL_FIX_PROMPT = PromptTemplate(
+    input_variables=[
+        "adb_schema",
+        "aql_query",
+        "aql_error",
+    ],
+    template=AQL_FIX_TEMPLATE,
+)
+
+AQL_QA_TEMPLATE = """Task: Generate a natural language `Summary` from the results of an ArangoDB Query Language query.
+
+You are an ArangoDB Query Language (AQL) expert responsible for creating a well-written `Summary` from the `User Input` and associated `AQL Result`.
+
+A user has executed an ArangoDB Query Language query, which has returned the AQL Result in JSON format.
+You are responsible for creating an `Summary` based on the AQL Result.
+
+You are given the following information:
+- `ArangoDB Schema`: contains a schema representation of the user's ArangoDB Database.
+- `User Input`: the original question/request of the user, which has been translated into an AQL Query.
+- `AQL Query`: the AQL equivalent of the `User Input`, translated by another AI Model. Should you deem it to be incorrect, suggest a different AQL Query.
+- `AQL Result`: the JSON output returned by executing the `AQL Query` within the ArangoDB Database.
+
+Remember to think step by step.
+
+Your `Summary` should sound like it is a response to the `User Input`.
+Your `Summary` should not include any mention of the `AQL Query` or the `AQL Result`.
+
+ArangoDB Schema:
+{adb_schema}
+
+User Input:
+{user_input}
+
+AQL Query:
+{aql_query}
+
+AQL Result:
+{aql_result}
+"""
+AQL_QA_PROMPT = PromptTemplate(
+    input_variables=["adb_schema", "user_input", "aql_query", "aql_result"],
+    template=AQL_QA_TEMPLATE,
+)
+
+
+NEPTUNE_OPENCYPHER_EXTRA_INSTRUCTIONS = """
+Instructions:
+Generate the query in openCypher format and follow these rules:
+Do not use `NONE`, `ALL` or `ANY` predicate functions, rather use list comprehensions.
+Do not use `REDUCE` function. Rather use a combination of list comprehension and the `UNWIND` clause to achieve similar results.
+Do not use `FOREACH` clause. Rather use a combination of `WITH` and `UNWIND` clauses to achieve similar results.{extra_instructions}
+\n"""
+
+NEPTUNE_OPENCYPHER_GENERATION_TEMPLATE = CYPHER_GENERATION_TEMPLATE.replace(
+    "Instructions:", NEPTUNE_OPENCYPHER_EXTRA_INSTRUCTIONS
+)
+
+NEPTUNE_OPENCYPHER_GENERATION_PROMPT = PromptTemplate(
+    input_variables=["schema", "question", "extra_instructions"],
+    template=NEPTUNE_OPENCYPHER_GENERATION_TEMPLATE,
+)
+
+NEPTUNE_OPENCYPHER_GENERATION_SIMPLE_TEMPLATE = """
+Write an openCypher query to answer the following question. Do not explain the answer. Only return the query.{extra_instructions}
+Question:  "{question}". 
+Here is the property graph schema: 
+{schema}
+\n"""
+
+NEPTUNE_OPENCYPHER_GENERATION_SIMPLE_PROMPT = PromptTemplate(
+    input_variables=["schema", "question", "extra_instructions"],
+    template=NEPTUNE_OPENCYPHER_GENERATION_SIMPLE_TEMPLATE,
+)
diff --git a/llm/Lib/site-packages/langchain/chains/graph_qa/sparql.py b/llm/Lib/site-packages/langchain/chains/graph_qa/sparql.py
new file mode 100644
index 0000000000000000000000000000000000000000..f1c5d2fc8137ec024176d4e2a11b62af64e27136
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/graph_qa/sparql.py
@@ -0,0 +1,152 @@
+"""
+Question answering over an RDF or OWL graph using SPARQL.
+"""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+from langchain_community.graphs.rdf_graph import RdfGraph
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts.base import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+
+from langchain.chains.base import Chain
+from langchain.chains.graph_qa.prompts import (
+    SPARQL_GENERATION_SELECT_PROMPT,
+    SPARQL_GENERATION_UPDATE_PROMPT,
+    SPARQL_INTENT_PROMPT,
+    SPARQL_QA_PROMPT,
+)
+from langchain.chains.llm import LLMChain
+
+
+class GraphSparqlQAChain(Chain):
+    """Question-answering against an RDF or OWL graph by generating SPARQL statements.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    graph: RdfGraph = Field(exclude=True)
+    sparql_generation_select_chain: LLMChain
+    sparql_generation_update_chain: LLMChain
+    sparql_intent_chain: LLMChain
+    qa_chain: LLMChain
+    return_sparql_query: bool = False
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+    sparql_query_key: str = "sparql_query"  #: :meta private:
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the input keys.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return the output keys.
+
+        :meta private:
+        """
+        _output_keys = [self.output_key]
+        return _output_keys
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        qa_prompt: BasePromptTemplate = SPARQL_QA_PROMPT,
+        sparql_select_prompt: BasePromptTemplate = SPARQL_GENERATION_SELECT_PROMPT,
+        sparql_update_prompt: BasePromptTemplate = SPARQL_GENERATION_UPDATE_PROMPT,
+        sparql_intent_prompt: BasePromptTemplate = SPARQL_INTENT_PROMPT,
+        **kwargs: Any,
+    ) -> GraphSparqlQAChain:
+        """Initialize from LLM."""
+        qa_chain = LLMChain(llm=llm, prompt=qa_prompt)
+        sparql_generation_select_chain = LLMChain(llm=llm, prompt=sparql_select_prompt)
+        sparql_generation_update_chain = LLMChain(llm=llm, prompt=sparql_update_prompt)
+        sparql_intent_chain = LLMChain(llm=llm, prompt=sparql_intent_prompt)
+
+        return cls(
+            qa_chain=qa_chain,
+            sparql_generation_select_chain=sparql_generation_select_chain,
+            sparql_generation_update_chain=sparql_generation_update_chain,
+            sparql_intent_chain=sparql_intent_chain,
+            **kwargs,
+        )
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        """
+        Generate SPARQL query, use it to retrieve a response from the gdb and answer
+        the question.
+        """
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        prompt = inputs[self.input_key]
+
+        _intent = self.sparql_intent_chain.run({"prompt": prompt}, callbacks=callbacks)
+        intent = _intent.strip()
+
+        if "SELECT" in intent and "UPDATE" not in intent:
+            sparql_generation_chain = self.sparql_generation_select_chain
+            intent = "SELECT"
+        elif "UPDATE" in intent and "SELECT" not in intent:
+            sparql_generation_chain = self.sparql_generation_update_chain
+            intent = "UPDATE"
+        else:
+            raise ValueError(
+                "I am sorry, but this prompt seems to fit none of the currently "
+                "supported SPARQL query types, i.e., SELECT and UPDATE."
+            )
+
+        _run_manager.on_text("Identified intent:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(intent, color="green", end="\n", verbose=self.verbose)
+
+        generated_sparql = sparql_generation_chain.run(
+            {"prompt": prompt, "schema": self.graph.get_schema}, callbacks=callbacks
+        )
+
+        _run_manager.on_text("Generated SPARQL:", end="\n", verbose=self.verbose)
+        _run_manager.on_text(
+            generated_sparql, color="green", end="\n", verbose=self.verbose
+        )
+
+        if intent == "SELECT":
+            context = self.graph.query(generated_sparql)
+
+            _run_manager.on_text("Full Context:", end="\n", verbose=self.verbose)
+            _run_manager.on_text(
+                str(context), color="green", end="\n", verbose=self.verbose
+            )
+            result = self.qa_chain(
+                {"prompt": prompt, "context": context},
+                callbacks=callbacks,
+            )
+            res = result[self.qa_chain.output_key]
+        elif intent == "UPDATE":
+            self.graph.update(generated_sparql)
+            res = "Successfully inserted triples into the graph."
+        else:
+            raise ValueError("Unsupported SPARQL query type.")
+
+        chain_result: Dict[str, Any] = {self.output_key: res}
+        if self.return_sparql_query:
+            chain_result[self.sparql_query_key] = generated_sparql
+        return chain_result
diff --git a/llm/Lib/site-packages/langchain/chains/history_aware_retriever.py b/llm/Lib/site-packages/langchain/chains/history_aware_retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..a29d31a8563ec7568555274a0d81ea207c280cd8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/history_aware_retriever.py
@@ -0,0 +1,67 @@
+from __future__ import annotations
+
+from langchain_core.language_models import LanguageModelLike
+from langchain_core.output_parsers import StrOutputParser
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.retrievers import RetrieverLike, RetrieverOutputLike
+from langchain_core.runnables import RunnableBranch
+
+
+def create_history_aware_retriever(
+    llm: LanguageModelLike,
+    retriever: RetrieverLike,
+    prompt: BasePromptTemplate,
+) -> RetrieverOutputLike:
+    """Create a chain that takes conversation history and returns documents.
+
+    If there is no `chat_history`, then the `input` is just passed directly to the
+    retriever. If there is `chat_history`, then the prompt and LLM will be used
+    to generate a search query. That search query is then passed to the retriever.
+
+    Args:
+        llm: Language model to use for generating a search term given chat history
+        retriever: RetrieverLike object that takes a string as input and outputs
+            a list of Documents.
+        prompt: The prompt used to generate the search query for the retriever.
+
+    Returns:
+        An LCEL Runnable. The runnable input must take in `input`, and if there
+        is chat history should take it in the form of `chat_history`.
+        The Runnable output is a list of Documents
+
+    Example:
+        .. code-block:: python
+
+            # pip install -U langchain langchain-community
+
+            from langchain_community.chat_models import ChatOpenAI
+            from langchain.chains import create_history_aware_retriever
+            from langchain import hub
+
+            rephrase_prompt = hub.pull("langchain-ai/chat-langchain-rephrase")
+            llm = ChatOpenAI()
+            retriever = ...
+            chat_retriever_chain = create_history_aware_retriever(
+                llm, retriever, rephrase_prompt
+            )
+
+            chain.invoke({"input": "...", "chat_history": })
+
+    """
+    if "input" not in prompt.input_variables:
+        raise ValueError(
+            "Expected `input` to be a prompt variable, "
+            f"but got {prompt.input_variables}"
+        )
+
+    retrieve_documents: RetrieverOutputLike = RunnableBranch(
+        (
+            # Both empty string and empty list evaluate to False
+            lambda x: not x.get("chat_history", False),
+            # If no chat history, then we just pass input to retriever
+            (lambda x: x["input"]) | retriever,
+        ),
+        # If chat history, then we pass inputs to LLM chain, then to retriever
+        prompt | llm | StrOutputParser() | retriever,
+    ).with_config(run_name="chat_retriever_chain")
+    return retrieve_documents
diff --git a/llm/Lib/site-packages/langchain/chains/hyde/__init__.py b/llm/Lib/site-packages/langchain/chains/hyde/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..946d0ab116960dd627fdcd486ca688451e80306a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/hyde/__init__.py
@@ -0,0 +1,4 @@
+"""Hypothetical Document Embeddings.
+
+https://arxiv.org/abs/2212.10496
+"""
diff --git a/llm/Lib/site-packages/langchain/chains/hyde/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/hyde/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..082f00535bd0ed5744211d704df93f70b6431a10
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/hyde/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/hyde/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/hyde/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4968df1d5f3245a0b94ee7cbaf0bfd2466d9477c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/hyde/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/hyde/__pycache__/prompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/hyde/__pycache__/prompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..abfd422bc0a9512b31d5425ad14e2037d1c967a1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/hyde/__pycache__/prompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/hyde/base.py b/llm/Lib/site-packages/langchain/chains/hyde/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca658aea93c016ec1dfccd10d238ef5cb9a17aba
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/hyde/base.py
@@ -0,0 +1,96 @@
+"""Hypothetical Document Embeddings.
+
+https://arxiv.org/abs/2212.10496
+"""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+import numpy as np
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.embeddings import Embeddings
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Extra
+
+from langchain.chains.base import Chain
+from langchain.chains.hyde.prompts import PROMPT_MAP
+from langchain.chains.llm import LLMChain
+
+
+class HypotheticalDocumentEmbedder(Chain, Embeddings):
+    """Generate hypothetical document for query, and then embed that.
+
+    Based on https://arxiv.org/abs/2212.10496
+    """
+
+    base_embeddings: Embeddings
+    llm_chain: LLMChain
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Input keys for Hyde's LLM chain."""
+        return self.llm_chain.input_keys
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Output keys for Hyde's LLM chain."""
+        return self.llm_chain.output_keys
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Call the base embeddings."""
+        return self.base_embeddings.embed_documents(texts)
+
+    def combine_embeddings(self, embeddings: List[List[float]]) -> List[float]:
+        """Combine embeddings into final embeddings."""
+        return list(np.array(embeddings).mean(axis=0))
+
+    def embed_query(self, text: str) -> List[float]:
+        """Generate a hypothetical document and embedded it."""
+        var_name = self.llm_chain.input_keys[0]
+        result = self.llm_chain.generate([{var_name: text}])
+        documents = [generation.text for generation in result.generations[0]]
+        embeddings = self.embed_documents(documents)
+        return self.combine_embeddings(embeddings)
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        """Call the internal llm chain."""
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        return self.llm_chain(inputs, callbacks=_run_manager.get_child())
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        base_embeddings: Embeddings,
+        prompt_key: Optional[str] = None,
+        custom_prompt: Optional[BasePromptTemplate] = None,
+        **kwargs: Any,
+    ) -> HypotheticalDocumentEmbedder:
+        """Load and use LLMChain with either a specific prompt key or custom prompt."""
+        if custom_prompt is not None:
+            prompt = custom_prompt
+        elif prompt_key is not None and prompt_key in PROMPT_MAP:
+            prompt = PROMPT_MAP[prompt_key]
+        else:
+            raise ValueError(
+                f"Must specify prompt_key if custom_prompt not provided. Should be one "
+                f"of {list(PROMPT_MAP.keys())}."
+            )
+
+        llm_chain = LLMChain(llm=llm, prompt=prompt)
+        return cls(base_embeddings=base_embeddings, llm_chain=llm_chain, **kwargs)
+
+    @property
+    def _chain_type(self) -> str:
+        return "hyde_chain"
diff --git a/llm/Lib/site-packages/langchain/chains/hyde/prompts.py b/llm/Lib/site-packages/langchain/chains/hyde/prompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..36c1cc0614b14453639d674a7b8204d4e4a52be6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/hyde/prompts.py
@@ -0,0 +1,47 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+web_search_template = """Please write a passage to answer the question 
+Question: {QUESTION}
+Passage:"""
+web_search = PromptTemplate(template=web_search_template, input_variables=["QUESTION"])
+sci_fact_template = """Please write a scientific paper passage to support/refute the claim 
+Claim: {Claim}
+Passage:"""
+sci_fact = PromptTemplate(template=sci_fact_template, input_variables=["Claim"])
+arguana_template = """Please write a counter argument for the passage 
+Passage: {PASSAGE}
+Counter Argument:"""
+arguana = PromptTemplate(template=arguana_template, input_variables=["PASSAGE"])
+trec_covid_template = """Please write a scientific paper passage to answer the question
+Question: {QUESTION}
+Passage:"""
+trec_covid = PromptTemplate(template=trec_covid_template, input_variables=["QUESTION"])
+fiqa_template = """Please write a financial article passage to answer the question
+Question: {QUESTION}
+Passage:"""
+fiqa = PromptTemplate(template=fiqa_template, input_variables=["QUESTION"])
+dbpedia_entity_template = """Please write a passage to answer the question.
+Question: {QUESTION}
+Passage:"""
+dbpedia_entity = PromptTemplate(
+    template=dbpedia_entity_template, input_variables=["QUESTION"]
+)
+trec_news_template = """Please write a news passage about the topic.
+Topic: {TOPIC}
+Passage:"""
+trec_news = PromptTemplate(template=trec_news_template, input_variables=["TOPIC"])
+mr_tydi_template = """Please write a passage in Swahili/Korean/Japanese/Bengali to answer the question in detail.
+Question: {QUESTION}
+Passage:"""
+mr_tydi = PromptTemplate(template=mr_tydi_template, input_variables=["QUESTION"])
+PROMPT_MAP = {
+    "web_search": web_search,
+    "sci_fact": sci_fact,
+    "arguana": arguana,
+    "trec_covid": trec_covid,
+    "fiqa": fiqa,
+    "dbpedia_entity": dbpedia_entity,
+    "trec_news": trec_news,
+    "mr_tydi": mr_tydi,
+}
diff --git a/llm/Lib/site-packages/langchain/chains/llm.py b/llm/Lib/site-packages/langchain/chains/llm.py
new file mode 100644
index 0000000000000000000000000000000000000000..f142902840593aebe0135e8cd1cffb50fcfbcd8e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm.py
@@ -0,0 +1,400 @@
+"""Chain that just formats a prompt and calls an LLM."""
+from __future__ import annotations
+
+import warnings
+from typing import Any, Dict, List, Optional, Sequence, Tuple, Union, cast
+
+from langchain_core.callbacks import (
+    AsyncCallbackManager,
+    AsyncCallbackManagerForChainRun,
+    CallbackManager,
+    CallbackManagerForChainRun,
+    Callbacks,
+)
+from langchain_core.language_models import (
+    BaseLanguageModel,
+    LanguageModelInput,
+)
+from langchain_core.load.dump import dumpd
+from langchain_core.messages import BaseMessage
+from langchain_core.output_parsers import BaseLLMOutputParser, StrOutputParser
+from langchain_core.outputs import ChatGeneration, Generation, LLMResult
+from langchain_core.prompt_values import PromptValue
+from langchain_core.prompts import BasePromptTemplate, PromptTemplate
+from langchain_core.pydantic_v1 import Extra, Field
+from langchain_core.runnables import (
+    Runnable,
+    RunnableBinding,
+    RunnableBranch,
+    RunnableWithFallbacks,
+)
+from langchain_core.runnables.configurable import DynamicRunnable
+from langchain_core.utils.input import get_colored_text
+
+from langchain.chains.base import Chain
+
+
+class LLMChain(Chain):
+    """Chain to run queries against LLMs.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.chains import LLMChain
+            from langchain_community.llms import OpenAI
+            from langchain_core.prompts import PromptTemplate
+            prompt_template = "Tell me a {adjective} joke"
+            prompt = PromptTemplate(
+                input_variables=["adjective"], template=prompt_template
+            )
+            llm = LLMChain(llm=OpenAI(), prompt=prompt)
+    """
+
+    @classmethod
+    def is_lc_serializable(self) -> bool:
+        return True
+
+    prompt: BasePromptTemplate
+    """Prompt object to use."""
+    llm: Union[
+        Runnable[LanguageModelInput, str], Runnable[LanguageModelInput, BaseMessage]
+    ]
+    """Language model to call."""
+    output_key: str = "text"  #: :meta private:
+    output_parser: BaseLLMOutputParser = Field(default_factory=StrOutputParser)
+    """Output parser to use.
+    Defaults to one that takes the most likely string but does not change it 
+    otherwise."""
+    return_final_only: bool = True
+    """Whether to return only the final parsed result. Defaults to True.
+    If false, will return a bunch of extra information about the generation."""
+    llm_kwargs: dict = Field(default_factory=dict)
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Will be whatever keys the prompt expects.
+
+        :meta private:
+        """
+        return self.prompt.input_variables
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Will always return text key.
+
+        :meta private:
+        """
+        if self.return_final_only:
+            return [self.output_key]
+        else:
+            return [self.output_key, "full_generation"]
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        response = self.generate([inputs], run_manager=run_manager)
+        return self.create_outputs(response)[0]
+
+    def generate(
+        self,
+        input_list: List[Dict[str, Any]],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> LLMResult:
+        """Generate LLM result from inputs."""
+        prompts, stop = self.prep_prompts(input_list, run_manager=run_manager)
+        callbacks = run_manager.get_child() if run_manager else None
+        if isinstance(self.llm, BaseLanguageModel):
+            return self.llm.generate_prompt(
+                prompts,
+                stop,
+                callbacks=callbacks,
+                **self.llm_kwargs,
+            )
+        else:
+            results = self.llm.bind(stop=stop, **self.llm_kwargs).batch(
+                cast(List, prompts), {"callbacks": callbacks}
+            )
+            generations: List[List[Generation]] = []
+            for res in results:
+                if isinstance(res, BaseMessage):
+                    generations.append([ChatGeneration(message=res)])
+                else:
+                    generations.append([Generation(text=res)])
+            return LLMResult(generations=generations)
+
+    async def agenerate(
+        self,
+        input_list: List[Dict[str, Any]],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> LLMResult:
+        """Generate LLM result from inputs."""
+        prompts, stop = await self.aprep_prompts(input_list, run_manager=run_manager)
+        callbacks = run_manager.get_child() if run_manager else None
+        if isinstance(self.llm, BaseLanguageModel):
+            return await self.llm.agenerate_prompt(
+                prompts,
+                stop,
+                callbacks=callbacks,
+                **self.llm_kwargs,
+            )
+        else:
+            results = await self.llm.bind(stop=stop, **self.llm_kwargs).abatch(
+                cast(List, prompts), {"callbacks": callbacks}
+            )
+            generations: List[List[Generation]] = []
+            for res in results:
+                if isinstance(res, BaseMessage):
+                    generations.append([ChatGeneration(message=res)])
+                else:
+                    generations.append([Generation(text=res)])
+            return LLMResult(generations=generations)
+
+    def prep_prompts(
+        self,
+        input_list: List[Dict[str, Any]],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Tuple[List[PromptValue], Optional[List[str]]]:
+        """Prepare prompts from inputs."""
+        stop = None
+        if len(input_list) == 0:
+            return [], stop
+        if "stop" in input_list[0]:
+            stop = input_list[0]["stop"]
+        prompts = []
+        for inputs in input_list:
+            selected_inputs = {k: inputs[k] for k in self.prompt.input_variables}
+            prompt = self.prompt.format_prompt(**selected_inputs)
+            _colored_text = get_colored_text(prompt.to_string(), "green")
+            _text = "Prompt after formatting:\n" + _colored_text
+            if run_manager:
+                run_manager.on_text(_text, end="\n", verbose=self.verbose)
+            if "stop" in inputs and inputs["stop"] != stop:
+                raise ValueError(
+                    "If `stop` is present in any inputs, should be present in all."
+                )
+            prompts.append(prompt)
+        return prompts, stop
+
+    async def aprep_prompts(
+        self,
+        input_list: List[Dict[str, Any]],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Tuple[List[PromptValue], Optional[List[str]]]:
+        """Prepare prompts from inputs."""
+        stop = None
+        if len(input_list) == 0:
+            return [], stop
+        if "stop" in input_list[0]:
+            stop = input_list[0]["stop"]
+        prompts = []
+        for inputs in input_list:
+            selected_inputs = {k: inputs[k] for k in self.prompt.input_variables}
+            prompt = self.prompt.format_prompt(**selected_inputs)
+            _colored_text = get_colored_text(prompt.to_string(), "green")
+            _text = "Prompt after formatting:\n" + _colored_text
+            if run_manager:
+                await run_manager.on_text(_text, end="\n", verbose=self.verbose)
+            if "stop" in inputs and inputs["stop"] != stop:
+                raise ValueError(
+                    "If `stop` is present in any inputs, should be present in all."
+                )
+            prompts.append(prompt)
+        return prompts, stop
+
+    def apply(
+        self, input_list: List[Dict[str, Any]], callbacks: Callbacks = None
+    ) -> List[Dict[str, str]]:
+        """Utilize the LLM generate method for speed gains."""
+        callback_manager = CallbackManager.configure(
+            callbacks, self.callbacks, self.verbose
+        )
+        run_manager = callback_manager.on_chain_start(
+            dumpd(self),
+            {"input_list": input_list},
+        )
+        try:
+            response = self.generate(input_list, run_manager=run_manager)
+        except BaseException as e:
+            run_manager.on_chain_error(e)
+            raise e
+        outputs = self.create_outputs(response)
+        run_manager.on_chain_end({"outputs": outputs})
+        return outputs
+
+    async def aapply(
+        self, input_list: List[Dict[str, Any]], callbacks: Callbacks = None
+    ) -> List[Dict[str, str]]:
+        """Utilize the LLM generate method for speed gains."""
+        callback_manager = AsyncCallbackManager.configure(
+            callbacks, self.callbacks, self.verbose
+        )
+        run_manager = await callback_manager.on_chain_start(
+            dumpd(self),
+            {"input_list": input_list},
+        )
+        try:
+            response = await self.agenerate(input_list, run_manager=run_manager)
+        except BaseException as e:
+            await run_manager.on_chain_error(e)
+            raise e
+        outputs = self.create_outputs(response)
+        await run_manager.on_chain_end({"outputs": outputs})
+        return outputs
+
+    @property
+    def _run_output_key(self) -> str:
+        return self.output_key
+
+    def create_outputs(self, llm_result: LLMResult) -> List[Dict[str, Any]]:
+        """Create outputs from response."""
+        result = [
+            # Get the text of the top generated string.
+            {
+                self.output_key: self.output_parser.parse_result(generation),
+                "full_generation": generation,
+            }
+            for generation in llm_result.generations
+        ]
+        if self.return_final_only:
+            result = [{self.output_key: r[self.output_key]} for r in result]
+        return result
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        response = await self.agenerate([inputs], run_manager=run_manager)
+        return self.create_outputs(response)[0]
+
+    def predict(self, callbacks: Callbacks = None, **kwargs: Any) -> str:
+        """Format prompt with kwargs and pass to LLM.
+
+        Args:
+            callbacks: Callbacks to pass to LLMChain
+            **kwargs: Keys to pass to prompt template.
+
+        Returns:
+            Completion from LLM.
+
+        Example:
+            .. code-block:: python
+
+                completion = llm.predict(adjective="funny")
+        """
+        return self(kwargs, callbacks=callbacks)[self.output_key]
+
+    async def apredict(self, callbacks: Callbacks = None, **kwargs: Any) -> str:
+        """Format prompt with kwargs and pass to LLM.
+
+        Args:
+            callbacks: Callbacks to pass to LLMChain
+            **kwargs: Keys to pass to prompt template.
+
+        Returns:
+            Completion from LLM.
+
+        Example:
+            .. code-block:: python
+
+                completion = llm.predict(adjective="funny")
+        """
+        return (await self.acall(kwargs, callbacks=callbacks))[self.output_key]
+
+    def predict_and_parse(
+        self, callbacks: Callbacks = None, **kwargs: Any
+    ) -> Union[str, List[str], Dict[str, Any]]:
+        """Call predict and then parse the results."""
+        warnings.warn(
+            "The predict_and_parse method is deprecated, "
+            "instead pass an output parser directly to LLMChain."
+        )
+        result = self.predict(callbacks=callbacks, **kwargs)
+        if self.prompt.output_parser is not None:
+            return self.prompt.output_parser.parse(result)
+        else:
+            return result
+
+    async def apredict_and_parse(
+        self, callbacks: Callbacks = None, **kwargs: Any
+    ) -> Union[str, List[str], Dict[str, str]]:
+        """Call apredict and then parse the results."""
+        warnings.warn(
+            "The apredict_and_parse method is deprecated, "
+            "instead pass an output parser directly to LLMChain."
+        )
+        result = await self.apredict(callbacks=callbacks, **kwargs)
+        if self.prompt.output_parser is not None:
+            return self.prompt.output_parser.parse(result)
+        else:
+            return result
+
+    def apply_and_parse(
+        self, input_list: List[Dict[str, Any]], callbacks: Callbacks = None
+    ) -> Sequence[Union[str, List[str], Dict[str, str]]]:
+        """Call apply and then parse the results."""
+        warnings.warn(
+            "The apply_and_parse method is deprecated, "
+            "instead pass an output parser directly to LLMChain."
+        )
+        result = self.apply(input_list, callbacks=callbacks)
+        return self._parse_generation(result)
+
+    def _parse_generation(
+        self, generation: List[Dict[str, str]]
+    ) -> Sequence[Union[str, List[str], Dict[str, str]]]:
+        if self.prompt.output_parser is not None:
+            return [
+                self.prompt.output_parser.parse(res[self.output_key])
+                for res in generation
+            ]
+        else:
+            return generation
+
+    async def aapply_and_parse(
+        self, input_list: List[Dict[str, Any]], callbacks: Callbacks = None
+    ) -> Sequence[Union[str, List[str], Dict[str, str]]]:
+        """Call apply and then parse the results."""
+        warnings.warn(
+            "The aapply_and_parse method is deprecated, "
+            "instead pass an output parser directly to LLMChain."
+        )
+        result = await self.aapply(input_list, callbacks=callbacks)
+        return self._parse_generation(result)
+
+    @property
+    def _chain_type(self) -> str:
+        return "llm_chain"
+
+    @classmethod
+    def from_string(cls, llm: BaseLanguageModel, template: str) -> LLMChain:
+        """Create LLMChain from LLM and template."""
+        prompt_template = PromptTemplate.from_template(template)
+        return cls(llm=llm, prompt=prompt_template)
+
+    def _get_num_tokens(self, text: str) -> int:
+        return _get_language_model(self.llm).get_num_tokens(text)
+
+
+def _get_language_model(llm_like: Runnable) -> BaseLanguageModel:
+    if isinstance(llm_like, BaseLanguageModel):
+        return llm_like
+    elif isinstance(llm_like, RunnableBinding):
+        return _get_language_model(llm_like.bound)
+    elif isinstance(llm_like, RunnableWithFallbacks):
+        return _get_language_model(llm_like.runnable)
+    elif isinstance(llm_like, (RunnableBranch, DynamicRunnable)):
+        return _get_language_model(llm_like.default)
+    else:
+        raise ValueError(
+            f"Unable to extract BaseLanguageModel from llm_like object of type "
+            f"{type(llm_like)}"
+        )
diff --git a/llm/Lib/site-packages/langchain/chains/llm_bash/__init__.py b/llm/Lib/site-packages/langchain/chains/llm_bash/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..cb6b48377d8de8b435481514443c25236a85c003
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_bash/__init__.py
@@ -0,0 +1,9 @@
+def __getattr__(name: str = "") -> None:
+    """Raise an error on import since is deprecated."""
+    raise ImportError(
+        "This module has been moved to langchain-experimental. "
+        "For more details: https://github.com/langchain-ai/langchain/discussions/11352."
+        "To access this code, install it with `pip install langchain-experimental`."
+        "`from langchain_experimental.llm_bash.base "
+        "import LLMBashChain`"
+    )
diff --git a/llm/Lib/site-packages/langchain/chains/llm_bash/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/llm_bash/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fb77fd946230264fb99e1c4e93315279898fcc30
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/llm_bash/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/llm_checker/__init__.py b/llm/Lib/site-packages/langchain/chains/llm_checker/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..95516d81e6af873cc074668a93e12ec08be480e9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_checker/__init__.py
@@ -0,0 +1,4 @@
+"""Chain that tries to verify assumptions before answering a question.
+
+Heavily borrowed from https://github.com/jagilley/fact-checker
+"""
diff --git a/llm/Lib/site-packages/langchain/chains/llm_checker/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/llm_checker/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..771e6610d6470f366a5f0c7c8c52cdf59dcbba60
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/llm_checker/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/llm_checker/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/llm_checker/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..577e4195bcd539cac0762e1a6387661424f057ec
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/llm_checker/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/llm_checker/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/llm_checker/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..44bc3389c085475fb799914164cac0ac374365be
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/llm_checker/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/llm_checker/base.py b/llm/Lib/site-packages/langchain/chains/llm_checker/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..c5d96859be31e46c13aea803679234d30c523bc8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_checker/base.py
@@ -0,0 +1,181 @@
+"""Chain for question-answering with self-verification."""
+from __future__ import annotations
+
+import warnings
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import PromptTemplate
+from langchain_core.pydantic_v1 import Extra, root_validator
+
+from langchain.chains.base import Chain
+from langchain.chains.llm import LLMChain
+from langchain.chains.llm_checker.prompt import (
+    CHECK_ASSERTIONS_PROMPT,
+    CREATE_DRAFT_ANSWER_PROMPT,
+    LIST_ASSERTIONS_PROMPT,
+    REVISED_ANSWER_PROMPT,
+)
+from langchain.chains.sequential import SequentialChain
+
+
+def _load_question_to_checked_assertions_chain(
+    llm: BaseLanguageModel,
+    create_draft_answer_prompt: PromptTemplate,
+    list_assertions_prompt: PromptTemplate,
+    check_assertions_prompt: PromptTemplate,
+    revised_answer_prompt: PromptTemplate,
+) -> SequentialChain:
+    create_draft_answer_chain = LLMChain(
+        llm=llm,
+        prompt=create_draft_answer_prompt,
+        output_key="statement",
+    )
+    list_assertions_chain = LLMChain(
+        llm=llm,
+        prompt=list_assertions_prompt,
+        output_key="assertions",
+    )
+    check_assertions_chain = LLMChain(
+        llm=llm,
+        prompt=check_assertions_prompt,
+        output_key="checked_assertions",
+    )
+    revised_answer_chain = LLMChain(
+        llm=llm,
+        prompt=revised_answer_prompt,
+        output_key="revised_statement",
+    )
+    chains = [
+        create_draft_answer_chain,
+        list_assertions_chain,
+        check_assertions_chain,
+        revised_answer_chain,
+    ]
+    question_to_checked_assertions_chain = SequentialChain(
+        chains=chains,  # type: ignore[arg-type]
+        input_variables=["question"],
+        output_variables=["revised_statement"],
+        verbose=True,
+    )
+    return question_to_checked_assertions_chain
+
+
+class LLMCheckerChain(Chain):
+    """Chain for question-answering with self-verification.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import OpenAI
+            from langchain.chains import LLMCheckerChain
+            llm = OpenAI(temperature=0.7)
+            checker_chain = LLMCheckerChain.from_llm(llm)
+    """
+
+    question_to_checked_assertions_chain: SequentialChain
+
+    llm: Optional[BaseLanguageModel] = None
+    """[Deprecated] LLM wrapper to use."""
+    create_draft_answer_prompt: PromptTemplate = CREATE_DRAFT_ANSWER_PROMPT
+    """[Deprecated]"""
+    list_assertions_prompt: PromptTemplate = LIST_ASSERTIONS_PROMPT
+    """[Deprecated]"""
+    check_assertions_prompt: PromptTemplate = CHECK_ASSERTIONS_PROMPT
+    """[Deprecated]"""
+    revised_answer_prompt: PromptTemplate = REVISED_ANSWER_PROMPT
+    """[Deprecated] Prompt to use when questioning the documents."""
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator(pre=True)
+    def raise_deprecation(cls, values: Dict) -> Dict:
+        if "llm" in values:
+            warnings.warn(
+                "Directly instantiating an LLMCheckerChain with an llm is deprecated. "
+                "Please instantiate with question_to_checked_assertions_chain "
+                "or using the from_llm class method."
+            )
+            if (
+                "question_to_checked_assertions_chain" not in values
+                and values["llm"] is not None
+            ):
+                question_to_checked_assertions_chain = (
+                    _load_question_to_checked_assertions_chain(
+                        values["llm"],
+                        values.get(
+                            "create_draft_answer_prompt", CREATE_DRAFT_ANSWER_PROMPT
+                        ),
+                        values.get("list_assertions_prompt", LIST_ASSERTIONS_PROMPT),
+                        values.get("check_assertions_prompt", CHECK_ASSERTIONS_PROMPT),
+                        values.get("revised_answer_prompt", REVISED_ANSWER_PROMPT),
+                    )
+                )
+                values[
+                    "question_to_checked_assertions_chain"
+                ] = question_to_checked_assertions_chain
+        return values
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the singular input key.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return the singular output key.
+
+        :meta private:
+        """
+        return [self.output_key]
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        question = inputs[self.input_key]
+
+        output = self.question_to_checked_assertions_chain(
+            {"question": question}, callbacks=_run_manager.get_child()
+        )
+        return {self.output_key: output["revised_statement"]}
+
+    @property
+    def _chain_type(self) -> str:
+        return "llm_checker_chain"
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        create_draft_answer_prompt: PromptTemplate = CREATE_DRAFT_ANSWER_PROMPT,
+        list_assertions_prompt: PromptTemplate = LIST_ASSERTIONS_PROMPT,
+        check_assertions_prompt: PromptTemplate = CHECK_ASSERTIONS_PROMPT,
+        revised_answer_prompt: PromptTemplate = REVISED_ANSWER_PROMPT,
+        **kwargs: Any,
+    ) -> LLMCheckerChain:
+        question_to_checked_assertions_chain = (
+            _load_question_to_checked_assertions_chain(
+                llm,
+                create_draft_answer_prompt,
+                list_assertions_prompt,
+                check_assertions_prompt,
+                revised_answer_prompt,
+            )
+        )
+        return cls(
+            question_to_checked_assertions_chain=question_to_checked_assertions_chain,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/chains/llm_checker/prompt.py b/llm/Lib/site-packages/langchain/chains/llm_checker/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..8eb5fdaf229ede2dc85b392a3f552aaa46cac51c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_checker/prompt.py
@@ -0,0 +1,31 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+_CREATE_DRAFT_ANSWER_TEMPLATE = """{question}\n\n"""
+CREATE_DRAFT_ANSWER_PROMPT = PromptTemplate(
+    input_variables=["question"], template=_CREATE_DRAFT_ANSWER_TEMPLATE
+)
+
+_LIST_ASSERTIONS_TEMPLATE = """Here is a statement:
+{statement}
+Make a bullet point list of the assumptions you made when producing the above statement.\n\n"""
+LIST_ASSERTIONS_PROMPT = PromptTemplate(
+    input_variables=["statement"], template=_LIST_ASSERTIONS_TEMPLATE
+)
+
+_CHECK_ASSERTIONS_TEMPLATE = """Here is a bullet point list of assertions:
+{assertions}
+For each assertion, determine whether it is true or false. If it is false, explain why.\n\n"""
+CHECK_ASSERTIONS_PROMPT = PromptTemplate(
+    input_variables=["assertions"], template=_CHECK_ASSERTIONS_TEMPLATE
+)
+
+_REVISED_ANSWER_TEMPLATE = """{checked_assertions}
+
+Question: In light of the above assertions and checks, how would you answer the question '{question}'?
+
+Answer:"""
+REVISED_ANSWER_PROMPT = PromptTemplate(
+    input_variables=["checked_assertions", "question"],
+    template=_REVISED_ANSWER_TEMPLATE,
+)
diff --git a/llm/Lib/site-packages/langchain/chains/llm_math/__init__.py b/llm/Lib/site-packages/langchain/chains/llm_math/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..fa9fd272583bc1d2e8cc776464c2fbac8ea91ad6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_math/__init__.py
@@ -0,0 +1,4 @@
+"""Chain that interprets a prompt and executes python code to do math.
+
+Heavily borrowed from https://replit.com/@amasad/gptpy?v=1#main.py
+"""
diff --git a/llm/Lib/site-packages/langchain/chains/llm_math/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/llm_math/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b657c32f9edea58cc4cd78119f30cee7354fd3dc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/llm_math/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/llm_math/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/llm_math/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2ac4a160961a8cf1714adb23b6e0c913cf2c7c0e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/llm_math/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/llm_math/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/llm_math/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..061f4e0412a2bb7ee545018c76d1324d5a890f8f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/llm_math/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/llm_math/base.py b/llm/Lib/site-packages/langchain/chains/llm_math/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..cada7dc3fa38c71d8e2e760d296d230bfaed0316
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_math/base.py
@@ -0,0 +1,186 @@
+"""Chain that interprets a prompt and executes python code to do math."""
+from __future__ import annotations
+
+import math
+import re
+import warnings
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+)
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Extra, root_validator
+
+from langchain.chains.base import Chain
+from langchain.chains.llm import LLMChain
+from langchain.chains.llm_math.prompt import PROMPT
+
+
+class LLMMathChain(Chain):
+    """Chain that interprets a prompt and executes python code to do math.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.chains import LLMMathChain
+            from langchain_community.llms import OpenAI
+            llm_math = LLMMathChain.from_llm(OpenAI())
+    """
+
+    llm_chain: LLMChain
+    llm: Optional[BaseLanguageModel] = None
+    """[Deprecated] LLM wrapper to use."""
+    prompt: BasePromptTemplate = PROMPT
+    """[Deprecated] Prompt to use to translate to python if necessary."""
+    input_key: str = "question"  #: :meta private:
+    output_key: str = "answer"  #: :meta private:
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator(pre=True)
+    def raise_deprecation(cls, values: Dict) -> Dict:
+        try:
+            import numexpr  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "LLMMathChain requires the numexpr package. "
+                "Please install it with `pip install numexpr`."
+            )
+        if "llm" in values:
+            warnings.warn(
+                "Directly instantiating an LLMMathChain with an llm is deprecated. "
+                "Please instantiate with llm_chain argument or using the from_llm "
+                "class method."
+            )
+            if "llm_chain" not in values and values["llm"] is not None:
+                prompt = values.get("prompt", PROMPT)
+                values["llm_chain"] = LLMChain(llm=values["llm"], prompt=prompt)
+        return values
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Expect input key.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Expect output key.
+
+        :meta private:
+        """
+        return [self.output_key]
+
+    def _evaluate_expression(self, expression: str) -> str:
+        import numexpr  # noqa: F401
+
+        try:
+            local_dict = {"pi": math.pi, "e": math.e}
+            output = str(
+                numexpr.evaluate(
+                    expression.strip(),
+                    global_dict={},  # restrict access to globals
+                    local_dict=local_dict,  # add common mathematical functions
+                )
+            )
+        except Exception as e:
+            raise ValueError(
+                f'LLMMathChain._evaluate("{expression}") raised error: {e}.'
+                " Please try again with a valid numerical expression"
+            )
+
+        # Remove any leading and trailing brackets from the output
+        return re.sub(r"^\[|\]$", "", output)
+
+    def _process_llm_result(
+        self, llm_output: str, run_manager: CallbackManagerForChainRun
+    ) -> Dict[str, str]:
+        run_manager.on_text(llm_output, color="green", verbose=self.verbose)
+        llm_output = llm_output.strip()
+        text_match = re.search(r"^```text(.*?)```", llm_output, re.DOTALL)
+        if text_match:
+            expression = text_match.group(1)
+            output = self._evaluate_expression(expression)
+            run_manager.on_text("\nAnswer: ", verbose=self.verbose)
+            run_manager.on_text(output, color="yellow", verbose=self.verbose)
+            answer = "Answer: " + output
+        elif llm_output.startswith("Answer:"):
+            answer = llm_output
+        elif "Answer:" in llm_output:
+            answer = "Answer: " + llm_output.split("Answer:")[-1]
+        else:
+            raise ValueError(f"unknown format from LLM: {llm_output}")
+        return {self.output_key: answer}
+
+    async def _aprocess_llm_result(
+        self,
+        llm_output: str,
+        run_manager: AsyncCallbackManagerForChainRun,
+    ) -> Dict[str, str]:
+        await run_manager.on_text(llm_output, color="green", verbose=self.verbose)
+        llm_output = llm_output.strip()
+        text_match = re.search(r"^```text(.*?)```", llm_output, re.DOTALL)
+        if text_match:
+            expression = text_match.group(1)
+            output = self._evaluate_expression(expression)
+            await run_manager.on_text("\nAnswer: ", verbose=self.verbose)
+            await run_manager.on_text(output, color="yellow", verbose=self.verbose)
+            answer = "Answer: " + output
+        elif llm_output.startswith("Answer:"):
+            answer = llm_output
+        elif "Answer:" in llm_output:
+            answer = "Answer: " + llm_output.split("Answer:")[-1]
+        else:
+            raise ValueError(f"unknown format from LLM: {llm_output}")
+        return {self.output_key: answer}
+
+    def _call(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        _run_manager.on_text(inputs[self.input_key])
+        llm_output = self.llm_chain.predict(
+            question=inputs[self.input_key],
+            stop=["```output"],
+            callbacks=_run_manager.get_child(),
+        )
+        return self._process_llm_result(llm_output, _run_manager)
+
+    async def _acall(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        _run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()
+        await _run_manager.on_text(inputs[self.input_key])
+        llm_output = await self.llm_chain.apredict(
+            question=inputs[self.input_key],
+            stop=["```output"],
+            callbacks=_run_manager.get_child(),
+        )
+        return await self._aprocess_llm_result(llm_output, _run_manager)
+
+    @property
+    def _chain_type(self) -> str:
+        return "llm_math_chain"
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        prompt: BasePromptTemplate = PROMPT,
+        **kwargs: Any,
+    ) -> LLMMathChain:
+        llm_chain = LLMChain(llm=llm, prompt=prompt)
+        return cls(llm_chain=llm_chain, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/chains/llm_math/prompt.py b/llm/Lib/site-packages/langchain/chains/llm_math/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..8c0fd9e8bdc8acab0db711dcaf5a25ecb50880af
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_math/prompt.py
@@ -0,0 +1,44 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+_PROMPT_TEMPLATE = """Translate a math problem into a expression that can be executed using Python's numexpr library. Use the output of running this code to answer the question.
+
+Question: ${{Question with math problem.}}
+```text
+${{single line mathematical expression that solves the problem}}
+```
+...numexpr.evaluate(text)...
+```output
+${{Output of running the code}}
+```
+Answer: ${{Answer}}
+
+Begin.
+
+Question: What is 37593 * 67?
+```text
+37593 * 67
+```
+...numexpr.evaluate("37593 * 67")...
+```output
+2518731
+```
+Answer: 2518731
+
+Question: 37593^(1/5)
+```text
+37593**(1/5)
+```
+...numexpr.evaluate("37593**(1/5)")...
+```output
+8.222831614237718
+```
+Answer: 8.222831614237718
+
+Question: {question}
+"""
+
+PROMPT = PromptTemplate(
+    input_variables=["question"],
+    template=_PROMPT_TEMPLATE,
+)
diff --git a/llm/Lib/site-packages/langchain/chains/llm_requests.py b/llm/Lib/site-packages/langchain/chains/llm_requests.py
new file mode 100644
index 0000000000000000000000000000000000000000..57277468747f33cd3ee43c83385c1d075b1a7a35
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_requests.py
@@ -0,0 +1,97 @@
+"""Chain that hits a URL and then uses an LLM to parse results."""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+from langchain_community.utilities.requests import TextRequestsWrapper
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+
+from langchain.chains import LLMChain
+from langchain.chains.base import Chain
+
+DEFAULT_HEADERS = {
+    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36"  # noqa: E501
+}
+
+
+class LLMRequestsChain(Chain):
+    """Chain that requests a URL and then uses an LLM to parse results.
+
+    **Security Note**: This chain can make GET requests to arbitrary URLs,
+        including internal URLs.
+
+        Control access to who can run this chain and what network access
+        this chain has.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    llm_chain: LLMChain  # type: ignore[valid-type]
+    requests_wrapper: TextRequestsWrapper = Field(
+        default_factory=lambda: TextRequestsWrapper(headers=DEFAULT_HEADERS),
+        exclude=True,
+    )
+    text_length: int = 8000
+    requests_key: str = "requests_result"  #: :meta private:
+    input_key: str = "url"  #: :meta private:
+    output_key: str = "output"  #: :meta private:
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Will be whatever keys the prompt expects.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Will always return text key.
+
+        :meta private:
+        """
+        return [self.output_key]
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        try:
+            from bs4 import BeautifulSoup  # noqa: F401
+
+        except ImportError:
+            raise ImportError(
+                "Could not import bs4 python package. "
+                "Please install it with `pip install bs4`."
+            )
+        return values
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        from bs4 import BeautifulSoup
+
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        # Other keys are assumed to be needed for LLM prediction
+        other_keys = {k: v for k, v in inputs.items() if k != self.input_key}
+        url = inputs[self.input_key]
+        res = self.requests_wrapper.get(url)
+        # extract the text from the html
+        soup = BeautifulSoup(res, "html.parser")
+        other_keys[self.requests_key] = soup.get_text()[: self.text_length]
+        result = self.llm_chain.predict(  # type: ignore[attr-defined]
+            callbacks=_run_manager.get_child(), **other_keys
+        )
+        return {self.output_key: result}
+
+    @property
+    def _chain_type(self) -> str:
+        return "llm_requests_chain"
diff --git a/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/__init__.py b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..385990816100d79d9f24c7b48938196ed1214b4c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/__init__.py
@@ -0,0 +1,7 @@
+"""Summarization checker chain for verifying accuracy of text generation.
+
+Chain that tries to verify the accuracy of text generation by splitting it into a
+list of facts, then checking if those facts are true or not, and rewriting
+the text to make it more truth-ful.  It will repeat this loop until it hits `max_tries`
+or gets to a "true" output.
+"""
diff --git a/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8c7e6e938bbcccded3e6b937715a86ae6fb90499
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0d3ddbe9bf4046527ae48b44bc5eb0810dfd09d5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/base.py b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..f63e383bbcc32863b810e23b4d8033209a6da765
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/base.py
@@ -0,0 +1,192 @@
+"""Chain for summarization with self-verification."""
+
+from __future__ import annotations
+
+import warnings
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.pydantic_v1 import Extra, root_validator
+
+from langchain.chains.base import Chain
+from langchain.chains.llm import LLMChain
+from langchain.chains.sequential import SequentialChain
+
+PROMPTS_DIR = Path(__file__).parent / "prompts"
+
+CREATE_ASSERTIONS_PROMPT = PromptTemplate.from_file(PROMPTS_DIR / "create_facts.txt")
+CHECK_ASSERTIONS_PROMPT = PromptTemplate.from_file(PROMPTS_DIR / "check_facts.txt")
+REVISED_SUMMARY_PROMPT = PromptTemplate.from_file(PROMPTS_DIR / "revise_summary.txt")
+ARE_ALL_TRUE_PROMPT = PromptTemplate.from_file(PROMPTS_DIR / "are_all_true_prompt.txt")
+
+
+def _load_sequential_chain(
+    llm: BaseLanguageModel,
+    create_assertions_prompt: PromptTemplate,
+    check_assertions_prompt: PromptTemplate,
+    revised_summary_prompt: PromptTemplate,
+    are_all_true_prompt: PromptTemplate,
+    verbose: bool = False,
+) -> SequentialChain:
+    chain = SequentialChain(
+        chains=[
+            LLMChain(
+                llm=llm,
+                prompt=create_assertions_prompt,
+                output_key="assertions",
+                verbose=verbose,
+            ),
+            LLMChain(
+                llm=llm,
+                prompt=check_assertions_prompt,
+                output_key="checked_assertions",
+                verbose=verbose,
+            ),
+            LLMChain(
+                llm=llm,
+                prompt=revised_summary_prompt,
+                output_key="revised_summary",
+                verbose=verbose,
+            ),
+            LLMChain(
+                llm=llm,
+                output_key="all_true",
+                prompt=are_all_true_prompt,
+                verbose=verbose,
+            ),
+        ],
+        input_variables=["summary"],
+        output_variables=["all_true", "revised_summary"],
+        verbose=verbose,
+    )
+    return chain
+
+
+class LLMSummarizationCheckerChain(Chain):
+    """Chain for question-answering with self-verification.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import OpenAI
+            from langchain.chains import LLMSummarizationCheckerChain
+            llm = OpenAI(temperature=0.0)
+            checker_chain = LLMSummarizationCheckerChain.from_llm(llm)
+    """
+
+    sequential_chain: SequentialChain
+    llm: Optional[BaseLanguageModel] = None
+    """[Deprecated] LLM wrapper to use."""
+
+    create_assertions_prompt: PromptTemplate = CREATE_ASSERTIONS_PROMPT
+    """[Deprecated]"""
+    check_assertions_prompt: PromptTemplate = CHECK_ASSERTIONS_PROMPT
+    """[Deprecated]"""
+    revised_summary_prompt: PromptTemplate = REVISED_SUMMARY_PROMPT
+    """[Deprecated]"""
+    are_all_true_prompt: PromptTemplate = ARE_ALL_TRUE_PROMPT
+    """[Deprecated]"""
+
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+    max_checks: int = 2
+    """Maximum number of times to check the assertions. Default to double-checking."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator(pre=True)
+    def raise_deprecation(cls, values: Dict) -> Dict:
+        if "llm" in values:
+            warnings.warn(
+                "Directly instantiating an LLMSummarizationCheckerChain with an llm is "
+                "deprecated. Please instantiate with"
+                " sequential_chain argument or using the from_llm class method."
+            )
+            if "sequential_chain" not in values and values["llm"] is not None:
+                values["sequential_chain"] = _load_sequential_chain(
+                    values["llm"],
+                    values.get("create_assertions_prompt", CREATE_ASSERTIONS_PROMPT),
+                    values.get("check_assertions_prompt", CHECK_ASSERTIONS_PROMPT),
+                    values.get("revised_summary_prompt", REVISED_SUMMARY_PROMPT),
+                    values.get("are_all_true_prompt", ARE_ALL_TRUE_PROMPT),
+                    verbose=values.get("verbose", False),
+                )
+        return values
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the singular input key.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return the singular output key.
+
+        :meta private:
+        """
+        return [self.output_key]
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        all_true = False
+        count = 0
+        output = None
+        original_input = inputs[self.input_key]
+        chain_input = original_input
+        while not all_true and count < self.max_checks:
+            output = self.sequential_chain(
+                {"summary": chain_input}, callbacks=_run_manager.get_child()
+            )
+            count += 1
+
+            if output["all_true"].strip() == "True":
+                break
+
+            if self.verbose:
+                print(output["revised_summary"])  # noqa: T201
+
+            chain_input = output["revised_summary"]
+
+        if not output:
+            raise ValueError("No output from chain")
+
+        return {self.output_key: output["revised_summary"].strip()}
+
+    @property
+    def _chain_type(self) -> str:
+        return "llm_summarization_checker_chain"
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        create_assertions_prompt: PromptTemplate = CREATE_ASSERTIONS_PROMPT,
+        check_assertions_prompt: PromptTemplate = CHECK_ASSERTIONS_PROMPT,
+        revised_summary_prompt: PromptTemplate = REVISED_SUMMARY_PROMPT,
+        are_all_true_prompt: PromptTemplate = ARE_ALL_TRUE_PROMPT,
+        verbose: bool = False,
+        **kwargs: Any,
+    ) -> LLMSummarizationCheckerChain:
+        chain = _load_sequential_chain(
+            llm,
+            create_assertions_prompt,
+            check_assertions_prompt,
+            revised_summary_prompt,
+            are_all_true_prompt,
+            verbose=verbose,
+        )
+        return cls(sequential_chain=chain, verbose=verbose, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/prompts/are_all_true_prompt.txt b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/prompts/are_all_true_prompt.txt
new file mode 100644
index 0000000000000000000000000000000000000000..cb1bedabfdf4bf3a26577a1be7d36e46827fb98a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/prompts/are_all_true_prompt.txt
@@ -0,0 +1,38 @@
+Below are some assertions that have been fact checked and are labeled as true or false.
+
+If all of the assertions are true, return "True". If any of the assertions are false, return "False".
+
+Here are some examples:
+===
+
+Checked Assertions: """
+- The sky is red: False
+- Water is made of lava: False
+- The sun is a star: True
+"""
+Result: False
+
+===
+
+Checked Assertions: """
+- The sky is blue: True
+- Water is wet: True
+- The sun is a star: True
+"""
+Result: True
+
+===
+
+Checked Assertions: """
+- The sky is blue - True
+- Water is made of lava- False
+- The sun is a star - True
+"""
+Result: False
+
+===
+
+Checked Assertions:"""
+{checked_assertions}
+"""
+Result:
\ No newline at end of file
diff --git a/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/prompts/check_facts.txt b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/prompts/check_facts.txt
new file mode 100644
index 0000000000000000000000000000000000000000..b675d31823bf167a8a0d4c826cccb2c103996384
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/prompts/check_facts.txt
@@ -0,0 +1,10 @@
+You are an expert fact checker. You have been hired by a major news organization to fact check a very important story.
+
+Here is a bullet point list of facts:
+"""
+{assertions}
+"""
+
+For each fact, determine whether it is true or false about the subject. If you are unable to determine whether the fact is true or false, output "Undetermined".
+If the fact is false, explain why.
+
diff --git a/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/prompts/create_facts.txt b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/prompts/create_facts.txt
new file mode 100644
index 0000000000000000000000000000000000000000..e85079a1d0f8a74436e68f204fc01caeacbeeb89
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/prompts/create_facts.txt
@@ -0,0 +1,10 @@
+Given some text, extract a list of facts from the text.
+
+Format your output as a bulleted list.
+
+Text:
+"""
+{summary}
+"""
+
+Facts:
\ No newline at end of file
diff --git a/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/prompts/revise_summary.txt b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/prompts/revise_summary.txt
new file mode 100644
index 0000000000000000000000000000000000000000..dbfc4d8e85daf11720bcf390a652cb5519e71416
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_summarization_checker/prompts/revise_summary.txt
@@ -0,0 +1,17 @@
+Below are some assertions that have been fact checked and are labeled as true or false. If the answer is false, a suggestion is given for a correction.
+
+Checked Assertions:
+"""
+{checked_assertions}
+"""
+
+Original Summary:
+"""
+{summary}
+"""
+
+Using these checked assertions, rewrite the original summary to be completely true.
+
+The output should have the same structure and formatting as the original summary.
+
+Summary:
\ No newline at end of file
diff --git a/llm/Lib/site-packages/langchain/chains/llm_symbolic_math/__init__.py b/llm/Lib/site-packages/langchain/chains/llm_symbolic_math/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..640a8aa9095b96a248a8450a57e1330d4e1c92c2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/llm_symbolic_math/__init__.py
@@ -0,0 +1,9 @@
+def __getattr__(name: str = "") -> None:
+    """Raise an error on import since is deprecated."""
+    raise ImportError(
+        "This module has been moved to langchain-experimental. "
+        "For more details: https://github.com/langchain-ai/langchain/discussions/11352."
+        "To access this code, install it with `pip install langchain-experimental`."
+        "`from langchain_experimental.llm_symbolic_math.base "
+        "import LLMSymbolicMathChain`"
+    )
diff --git a/llm/Lib/site-packages/langchain/chains/llm_symbolic_math/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/llm_symbolic_math/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c1ee93f25114c43abf558ec23a65820a23f2b660
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/llm_symbolic_math/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/loading.py b/llm/Lib/site-packages/langchain/chains/loading.py
new file mode 100644
index 0000000000000000000000000000000000000000..5f9ef01f98684a4627f9de4f8f340ed01da3df51
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/loading.py
@@ -0,0 +1,658 @@
+"""Functionality for loading chains."""
+
+import json
+from pathlib import Path
+from typing import Any, Union
+
+import yaml
+from langchain_community.llms.loading import load_llm, load_llm_from_config
+from langchain_core.prompts.loading import (
+    _load_output_parser,
+    load_prompt,
+    load_prompt_from_config,
+)
+
+from langchain.chains import ReduceDocumentsChain
+from langchain.chains.api.base import APIChain
+from langchain.chains.base import Chain
+from langchain.chains.combine_documents.map_reduce import MapReduceDocumentsChain
+from langchain.chains.combine_documents.map_rerank import MapRerankDocumentsChain
+from langchain.chains.combine_documents.refine import RefineDocumentsChain
+from langchain.chains.combine_documents.stuff import StuffDocumentsChain
+from langchain.chains.graph_qa.cypher import GraphCypherQAChain
+from langchain.chains.hyde.base import HypotheticalDocumentEmbedder
+from langchain.chains.llm import LLMChain
+from langchain.chains.llm_checker.base import LLMCheckerChain
+from langchain.chains.llm_math.base import LLMMathChain
+from langchain.chains.llm_requests import LLMRequestsChain
+from langchain.chains.qa_with_sources.base import QAWithSourcesChain
+from langchain.chains.qa_with_sources.retrieval import RetrievalQAWithSourcesChain
+from langchain.chains.qa_with_sources.vector_db import VectorDBQAWithSourcesChain
+from langchain.chains.retrieval_qa.base import RetrievalQA, VectorDBQA
+
+URL_BASE = "https://raw.githubusercontent.com/hwchase17/langchain-hub/master/chains/"
+
+
+def _load_llm_chain(config: dict, **kwargs: Any) -> LLMChain:
+    """Load LLM chain from config dict."""
+    if "llm" in config:
+        llm_config = config.pop("llm")
+        llm = load_llm_from_config(llm_config, **kwargs)
+    elif "llm_path" in config:
+        llm = load_llm(config.pop("llm_path"), **kwargs)
+    else:
+        raise ValueError("One of `llm` or `llm_path` must be present.")
+
+    if "prompt" in config:
+        prompt_config = config.pop("prompt")
+        prompt = load_prompt_from_config(prompt_config)
+    elif "prompt_path" in config:
+        prompt = load_prompt(config.pop("prompt_path"))
+    else:
+        raise ValueError("One of `prompt` or `prompt_path` must be present.")
+    _load_output_parser(config)
+
+    return LLMChain(llm=llm, prompt=prompt, **config)
+
+
+def _load_hyde_chain(config: dict, **kwargs: Any) -> HypotheticalDocumentEmbedder:
+    """Load hypothetical document embedder chain from config dict."""
+    if "llm_chain" in config:
+        llm_chain_config = config.pop("llm_chain")
+        llm_chain = load_chain_from_config(llm_chain_config, **kwargs)
+    elif "llm_chain_path" in config:
+        llm_chain = load_chain(config.pop("llm_chain_path"), **kwargs)
+    else:
+        raise ValueError("One of `llm_chain` or `llm_chain_path` must be present.")
+    if "embeddings" in kwargs:
+        embeddings = kwargs.pop("embeddings")
+    else:
+        raise ValueError("`embeddings` must be present.")
+    return HypotheticalDocumentEmbedder(
+        llm_chain=llm_chain,  # type: ignore[arg-type]
+        base_embeddings=embeddings,
+        **config,  # type: ignore[arg-type]
+    )
+
+
+def _load_stuff_documents_chain(config: dict, **kwargs: Any) -> StuffDocumentsChain:
+    if "llm_chain" in config:
+        llm_chain_config = config.pop("llm_chain")
+        llm_chain = load_chain_from_config(llm_chain_config, **kwargs)
+    elif "llm_chain_path" in config:
+        llm_chain = load_chain(config.pop("llm_chain_path"), **kwargs)
+    else:
+        raise ValueError("One of `llm_chain` or `llm_chain_path` must be present.")
+
+    if not isinstance(llm_chain, LLMChain):
+        raise ValueError(f"Expected LLMChain, got {llm_chain}")
+
+    if "document_prompt" in config:
+        prompt_config = config.pop("document_prompt")
+        document_prompt = load_prompt_from_config(prompt_config)
+    elif "document_prompt_path" in config:
+        document_prompt = load_prompt(config.pop("document_prompt_path"))
+    else:
+        raise ValueError(
+            "One of `document_prompt` or `document_prompt_path` must be present."
+        )
+
+    return StuffDocumentsChain(
+        llm_chain=llm_chain, document_prompt=document_prompt, **config
+    )
+
+
+def _load_map_reduce_documents_chain(
+    config: dict, **kwargs: Any
+) -> MapReduceDocumentsChain:
+    if "llm_chain" in config:
+        llm_chain_config = config.pop("llm_chain")
+        llm_chain = load_chain_from_config(llm_chain_config, **kwargs)
+    elif "llm_chain_path" in config:
+        llm_chain = load_chain(config.pop("llm_chain_path"), **kwargs)
+    else:
+        raise ValueError("One of `llm_chain` or `llm_chain_path` must be present.")
+
+    if not isinstance(llm_chain, LLMChain):
+        raise ValueError(f"Expected LLMChain, got {llm_chain}")
+
+    if "reduce_documents_chain" in config:
+        reduce_documents_chain = load_chain_from_config(
+            config.pop("reduce_documents_chain"), **kwargs
+        )
+    elif "reduce_documents_chain_path" in config:
+        reduce_documents_chain = load_chain(
+            config.pop("reduce_documents_chain_path"), **kwargs
+        )
+    else:
+        reduce_documents_chain = _load_reduce_documents_chain(config, **kwargs)
+
+    return MapReduceDocumentsChain(
+        llm_chain=llm_chain,
+        reduce_documents_chain=reduce_documents_chain,  # type: ignore[arg-type]
+        **config,
+    )
+
+
+def _load_reduce_documents_chain(config: dict, **kwargs: Any) -> ReduceDocumentsChain:  # type: ignore[valid-type]
+    combine_documents_chain = None
+    collapse_documents_chain = None
+
+    if "combine_documents_chain" in config:
+        combine_document_chain_config = config.pop("combine_documents_chain")
+        combine_documents_chain = load_chain_from_config(
+            combine_document_chain_config, **kwargs
+        )
+    elif "combine_document_chain" in config:
+        combine_document_chain_config = config.pop("combine_document_chain")
+        combine_documents_chain = load_chain_from_config(
+            combine_document_chain_config, **kwargs
+        )
+    elif "combine_documents_chain_path" in config:
+        combine_documents_chain = load_chain(
+            config.pop("combine_documents_chain_path"), **kwargs
+        )
+    elif "combine_document_chain_path" in config:
+        combine_documents_chain = load_chain(
+            config.pop("combine_document_chain_path"), **kwargs
+        )
+    else:
+        raise ValueError(
+            "One of `combine_documents_chain` or "
+            "`combine_documents_chain_path` must be present."
+        )
+
+    if "collapse_documents_chain" in config:
+        collapse_document_chain_config = config.pop("collapse_documents_chain")
+        if collapse_document_chain_config is None:
+            collapse_documents_chain = None
+        else:
+            collapse_documents_chain = load_chain_from_config(
+                collapse_document_chain_config, **kwargs
+            )
+    elif "collapse_documents_chain_path" in config:
+        collapse_documents_chain = load_chain(
+            config.pop("collapse_documents_chain_path"), **kwargs
+        )
+    elif "collapse_document_chain" in config:
+        collapse_document_chain_config = config.pop("collapse_document_chain")
+        if collapse_document_chain_config is None:
+            collapse_documents_chain = None
+        else:
+            collapse_documents_chain = load_chain_from_config(
+                collapse_document_chain_config, **kwargs
+            )
+    elif "collapse_document_chain_path" in config:
+        collapse_documents_chain = load_chain(
+            config.pop("collapse_document_chain_path"), **kwargs
+        )
+
+    return ReduceDocumentsChain(  # type: ignore[misc]
+        combine_documents_chain=combine_documents_chain,
+        collapse_documents_chain=collapse_documents_chain,
+        **config,
+    )
+
+
+def _load_llm_bash_chain(config: dict, **kwargs: Any) -> Any:
+    from langchain_experimental.llm_bash.base import LLMBashChain
+
+    llm_chain = None
+    if "llm_chain" in config:
+        llm_chain_config = config.pop("llm_chain")
+        llm_chain = load_chain_from_config(llm_chain_config, **kwargs)
+    elif "llm_chain_path" in config:
+        llm_chain = load_chain(config.pop("llm_chain_path"), **kwargs)
+    # llm attribute is deprecated in favor of llm_chain, here to support old configs
+    elif "llm" in config:
+        llm_config = config.pop("llm")
+        llm = load_llm_from_config(llm_config, **kwargs)
+    # llm_path attribute is deprecated in favor of llm_chain_path,
+    # its to support old configs
+    elif "llm_path" in config:
+        llm = load_llm(config.pop("llm_path"), **kwargs)
+    else:
+        raise ValueError("One of `llm_chain` or `llm_chain_path` must be present.")
+    if "prompt" in config:
+        prompt_config = config.pop("prompt")
+        prompt = load_prompt_from_config(prompt_config)
+    elif "prompt_path" in config:
+        prompt = load_prompt(config.pop("prompt_path"))
+    if llm_chain:
+        return LLMBashChain(llm_chain=llm_chain, prompt=prompt, **config)  # type: ignore[arg-type]
+    else:
+        return LLMBashChain(llm=llm, prompt=prompt, **config)
+
+
+def _load_llm_checker_chain(config: dict, **kwargs: Any) -> LLMCheckerChain:
+    if "llm" in config:
+        llm_config = config.pop("llm")
+        llm = load_llm_from_config(llm_config, **kwargs)
+    elif "llm_path" in config:
+        llm = load_llm(config.pop("llm_path"), **kwargs)
+    else:
+        raise ValueError("One of `llm` or `llm_path` must be present.")
+    if "create_draft_answer_prompt" in config:
+        create_draft_answer_prompt_config = config.pop("create_draft_answer_prompt")
+        create_draft_answer_prompt = load_prompt_from_config(
+            create_draft_answer_prompt_config
+        )
+    elif "create_draft_answer_prompt_path" in config:
+        create_draft_answer_prompt = load_prompt(
+            config.pop("create_draft_answer_prompt_path")
+        )
+    if "list_assertions_prompt" in config:
+        list_assertions_prompt_config = config.pop("list_assertions_prompt")
+        list_assertions_prompt = load_prompt_from_config(list_assertions_prompt_config)
+    elif "list_assertions_prompt_path" in config:
+        list_assertions_prompt = load_prompt(config.pop("list_assertions_prompt_path"))
+    if "check_assertions_prompt" in config:
+        check_assertions_prompt_config = config.pop("check_assertions_prompt")
+        check_assertions_prompt = load_prompt_from_config(
+            check_assertions_prompt_config
+        )
+    elif "check_assertions_prompt_path" in config:
+        check_assertions_prompt = load_prompt(
+            config.pop("check_assertions_prompt_path")
+        )
+    if "revised_answer_prompt" in config:
+        revised_answer_prompt_config = config.pop("revised_answer_prompt")
+        revised_answer_prompt = load_prompt_from_config(revised_answer_prompt_config)
+    elif "revised_answer_prompt_path" in config:
+        revised_answer_prompt = load_prompt(config.pop("revised_answer_prompt_path"))
+    return LLMCheckerChain(
+        llm=llm,
+        create_draft_answer_prompt=create_draft_answer_prompt,  # type: ignore[arg-type]
+        list_assertions_prompt=list_assertions_prompt,  # type: ignore[arg-type]
+        check_assertions_prompt=check_assertions_prompt,  # type: ignore[arg-type]
+        revised_answer_prompt=revised_answer_prompt,  # type: ignore[arg-type]
+        **config,
+    )
+
+
+def _load_llm_math_chain(config: dict, **kwargs: Any) -> LLMMathChain:
+    llm_chain = None
+    if "llm_chain" in config:
+        llm_chain_config = config.pop("llm_chain")
+        llm_chain = load_chain_from_config(llm_chain_config, **kwargs)
+    elif "llm_chain_path" in config:
+        llm_chain = load_chain(config.pop("llm_chain_path"), **kwargs)
+    # llm attribute is deprecated in favor of llm_chain, here to support old configs
+    elif "llm" in config:
+        llm_config = config.pop("llm")
+        llm = load_llm_from_config(llm_config, **kwargs)
+    # llm_path attribute is deprecated in favor of llm_chain_path,
+    # its to support old configs
+    elif "llm_path" in config:
+        llm = load_llm(config.pop("llm_path"), **kwargs)
+    else:
+        raise ValueError("One of `llm_chain` or `llm_chain_path` must be present.")
+    if "prompt" in config:
+        prompt_config = config.pop("prompt")
+        prompt = load_prompt_from_config(prompt_config)
+    elif "prompt_path" in config:
+        prompt = load_prompt(config.pop("prompt_path"))
+    if llm_chain:
+        return LLMMathChain(llm_chain=llm_chain, prompt=prompt, **config)  # type: ignore[arg-type]
+    else:
+        return LLMMathChain(llm=llm, prompt=prompt, **config)
+
+
+def _load_map_rerank_documents_chain(
+    config: dict, **kwargs: Any
+) -> MapRerankDocumentsChain:
+    if "llm_chain" in config:
+        llm_chain_config = config.pop("llm_chain")
+        llm_chain = load_chain_from_config(llm_chain_config, **kwargs)
+    elif "llm_chain_path" in config:
+        llm_chain = load_chain(config.pop("llm_chain_path"), **kwargs)
+    else:
+        raise ValueError("One of `llm_chain` or `llm_chain_path` must be present.")
+    return MapRerankDocumentsChain(llm_chain=llm_chain, **config)  # type: ignore[arg-type]
+
+
+def _load_pal_chain(config: dict, **kwargs: Any) -> Any:
+    from langchain_experimental.pal_chain import PALChain
+
+    if "llm_chain" in config:
+        llm_chain_config = config.pop("llm_chain")
+        llm_chain = load_chain_from_config(llm_chain_config, **kwargs)
+    elif "llm_chain_path" in config:
+        llm_chain = load_chain(config.pop("llm_chain_path"), **kwargs)
+    else:
+        raise ValueError("One of `llm_chain` or `llm_chain_path` must be present.")
+    return PALChain(llm_chain=llm_chain, **config)  # type: ignore[arg-type]
+
+
+def _load_refine_documents_chain(config: dict, **kwargs: Any) -> RefineDocumentsChain:
+    if "initial_llm_chain" in config:
+        initial_llm_chain_config = config.pop("initial_llm_chain")
+        initial_llm_chain = load_chain_from_config(initial_llm_chain_config, **kwargs)
+    elif "initial_llm_chain_path" in config:
+        initial_llm_chain = load_chain(config.pop("initial_llm_chain_path"), **kwargs)
+    else:
+        raise ValueError(
+            "One of `initial_llm_chain` or `initial_llm_chain_path` must be present."
+        )
+    if "refine_llm_chain" in config:
+        refine_llm_chain_config = config.pop("refine_llm_chain")
+        refine_llm_chain = load_chain_from_config(refine_llm_chain_config, **kwargs)
+    elif "refine_llm_chain_path" in config:
+        refine_llm_chain = load_chain(config.pop("refine_llm_chain_path"), **kwargs)
+    else:
+        raise ValueError(
+            "One of `refine_llm_chain` or `refine_llm_chain_path` must be present."
+        )
+    if "document_prompt" in config:
+        prompt_config = config.pop("document_prompt")
+        document_prompt = load_prompt_from_config(prompt_config)
+    elif "document_prompt_path" in config:
+        document_prompt = load_prompt(config.pop("document_prompt_path"))
+    return RefineDocumentsChain(
+        initial_llm_chain=initial_llm_chain,  # type: ignore[arg-type]
+        refine_llm_chain=refine_llm_chain,  # type: ignore[arg-type]
+        document_prompt=document_prompt,
+        **config,
+    )
+
+
+def _load_qa_with_sources_chain(config: dict, **kwargs: Any) -> QAWithSourcesChain:
+    if "combine_documents_chain" in config:
+        combine_documents_chain_config = config.pop("combine_documents_chain")
+        combine_documents_chain = load_chain_from_config(
+            combine_documents_chain_config, **kwargs
+        )
+    elif "combine_documents_chain_path" in config:
+        combine_documents_chain = load_chain(
+            config.pop("combine_documents_chain_path"), **kwargs
+        )
+    else:
+        raise ValueError(
+            "One of `combine_documents_chain` or "
+            "`combine_documents_chain_path` must be present."
+        )
+    return QAWithSourcesChain(combine_documents_chain=combine_documents_chain, **config)  # type: ignore[arg-type]
+
+
+def _load_sql_database_chain(config: dict, **kwargs: Any) -> Any:
+    from langchain_experimental.sql import SQLDatabaseChain
+
+    if "database" in kwargs:
+        database = kwargs.pop("database")
+    else:
+        raise ValueError("`database` must be present.")
+    if "llm_chain" in config:
+        llm_chain_config = config.pop("llm_chain")
+        chain = load_chain_from_config(llm_chain_config, **kwargs)
+        return SQLDatabaseChain(llm_chain=chain, database=database, **config)
+    if "llm" in config:
+        llm_config = config.pop("llm")
+        llm = load_llm_from_config(llm_config, **kwargs)
+    elif "llm_path" in config:
+        llm = load_llm(config.pop("llm_path"), **kwargs)
+    else:
+        raise ValueError("One of `llm` or `llm_path` must be present.")
+    if "prompt" in config:
+        prompt_config = config.pop("prompt")
+        prompt = load_prompt_from_config(prompt_config)
+    else:
+        prompt = None
+
+    return SQLDatabaseChain.from_llm(llm, database, prompt=prompt, **config)
+
+
+def _load_vector_db_qa_with_sources_chain(
+    config: dict, **kwargs: Any
+) -> VectorDBQAWithSourcesChain:
+    if "vectorstore" in kwargs:
+        vectorstore = kwargs.pop("vectorstore")
+    else:
+        raise ValueError("`vectorstore` must be present.")
+    if "combine_documents_chain" in config:
+        combine_documents_chain_config = config.pop("combine_documents_chain")
+        combine_documents_chain = load_chain_from_config(
+            combine_documents_chain_config, **kwargs
+        )
+    elif "combine_documents_chain_path" in config:
+        combine_documents_chain = load_chain(
+            config.pop("combine_documents_chain_path"), **kwargs
+        )
+    else:
+        raise ValueError(
+            "One of `combine_documents_chain` or "
+            "`combine_documents_chain_path` must be present."
+        )
+    return VectorDBQAWithSourcesChain(
+        combine_documents_chain=combine_documents_chain,  # type: ignore[arg-type]
+        vectorstore=vectorstore,
+        **config,
+    )
+
+
+def _load_retrieval_qa(config: dict, **kwargs: Any) -> RetrievalQA:
+    if "retriever" in kwargs:
+        retriever = kwargs.pop("retriever")
+    else:
+        raise ValueError("`retriever` must be present.")
+    if "combine_documents_chain" in config:
+        combine_documents_chain_config = config.pop("combine_documents_chain")
+        combine_documents_chain = load_chain_from_config(
+            combine_documents_chain_config, **kwargs
+        )
+    elif "combine_documents_chain_path" in config:
+        combine_documents_chain = load_chain(
+            config.pop("combine_documents_chain_path"), **kwargs
+        )
+    else:
+        raise ValueError(
+            "One of `combine_documents_chain` or "
+            "`combine_documents_chain_path` must be present."
+        )
+    return RetrievalQA(
+        combine_documents_chain=combine_documents_chain,  # type: ignore[arg-type]
+        retriever=retriever,
+        **config,
+    )
+
+
+def _load_retrieval_qa_with_sources_chain(
+    config: dict, **kwargs: Any
+) -> RetrievalQAWithSourcesChain:
+    if "retriever" in kwargs:
+        retriever = kwargs.pop("retriever")
+    else:
+        raise ValueError("`retriever` must be present.")
+    if "combine_documents_chain" in config:
+        combine_documents_chain_config = config.pop("combine_documents_chain")
+        combine_documents_chain = load_chain_from_config(
+            combine_documents_chain_config, **kwargs
+        )
+    elif "combine_documents_chain_path" in config:
+        combine_documents_chain = load_chain(
+            config.pop("combine_documents_chain_path"), **kwargs
+        )
+    else:
+        raise ValueError(
+            "One of `combine_documents_chain` or "
+            "`combine_documents_chain_path` must be present."
+        )
+    return RetrievalQAWithSourcesChain(
+        combine_documents_chain=combine_documents_chain,  # type: ignore[arg-type]
+        retriever=retriever,
+        **config,
+    )
+
+
+def _load_vector_db_qa(config: dict, **kwargs: Any) -> VectorDBQA:
+    if "vectorstore" in kwargs:
+        vectorstore = kwargs.pop("vectorstore")
+    else:
+        raise ValueError("`vectorstore` must be present.")
+    if "combine_documents_chain" in config:
+        combine_documents_chain_config = config.pop("combine_documents_chain")
+        combine_documents_chain = load_chain_from_config(
+            combine_documents_chain_config, **kwargs
+        )
+    elif "combine_documents_chain_path" in config:
+        combine_documents_chain = load_chain(
+            config.pop("combine_documents_chain_path"), **kwargs
+        )
+    else:
+        raise ValueError(
+            "One of `combine_documents_chain` or "
+            "`combine_documents_chain_path` must be present."
+        )
+    return VectorDBQA(
+        combine_documents_chain=combine_documents_chain,  # type: ignore[arg-type]
+        vectorstore=vectorstore,
+        **config,
+    )
+
+
+def _load_graph_cypher_chain(config: dict, **kwargs: Any) -> GraphCypherQAChain:
+    if "graph" in kwargs:
+        graph = kwargs.pop("graph")
+    else:
+        raise ValueError("`graph` must be present.")
+    if "cypher_generation_chain" in config:
+        cypher_generation_chain_config = config.pop("cypher_generation_chain")
+        cypher_generation_chain = load_chain_from_config(
+            cypher_generation_chain_config, **kwargs
+        )
+    else:
+        raise ValueError("`cypher_generation_chain` must be present.")
+    if "qa_chain" in config:
+        qa_chain_config = config.pop("qa_chain")
+        qa_chain = load_chain_from_config(qa_chain_config, **kwargs)
+    else:
+        raise ValueError("`qa_chain` must be present.")
+
+    return GraphCypherQAChain(
+        graph=graph,
+        cypher_generation_chain=cypher_generation_chain,  # type: ignore[arg-type]
+        qa_chain=qa_chain,  # type: ignore[arg-type]
+        **config,
+    )
+
+
+def _load_api_chain(config: dict, **kwargs: Any) -> APIChain:
+    if "api_request_chain" in config:
+        api_request_chain_config = config.pop("api_request_chain")
+        api_request_chain = load_chain_from_config(api_request_chain_config, **kwargs)
+    elif "api_request_chain_path" in config:
+        api_request_chain = load_chain(config.pop("api_request_chain_path"))
+    else:
+        raise ValueError(
+            "One of `api_request_chain` or `api_request_chain_path` must be present."
+        )
+    if "api_answer_chain" in config:
+        api_answer_chain_config = config.pop("api_answer_chain")
+        api_answer_chain = load_chain_from_config(api_answer_chain_config, **kwargs)
+    elif "api_answer_chain_path" in config:
+        api_answer_chain = load_chain(config.pop("api_answer_chain_path"), **kwargs)
+    else:
+        raise ValueError(
+            "One of `api_answer_chain` or `api_answer_chain_path` must be present."
+        )
+    if "requests_wrapper" in kwargs:
+        requests_wrapper = kwargs.pop("requests_wrapper")
+    else:
+        raise ValueError("`requests_wrapper` must be present.")
+    return APIChain(
+        api_request_chain=api_request_chain,  # type: ignore[arg-type]
+        api_answer_chain=api_answer_chain,  # type: ignore[arg-type]
+        requests_wrapper=requests_wrapper,
+        **config,
+    )
+
+
+def _load_llm_requests_chain(config: dict, **kwargs: Any) -> LLMRequestsChain:
+    if "llm_chain" in config:
+        llm_chain_config = config.pop("llm_chain")
+        llm_chain = load_chain_from_config(llm_chain_config, **kwargs)
+    elif "llm_chain_path" in config:
+        llm_chain = load_chain(config.pop("llm_chain_path"), **kwargs)
+    else:
+        raise ValueError("One of `llm_chain` or `llm_chain_path` must be present.")
+    if "requests_wrapper" in kwargs:
+        requests_wrapper = kwargs.pop("requests_wrapper")
+        return LLMRequestsChain(
+            llm_chain=llm_chain, requests_wrapper=requests_wrapper, **config
+        )
+    else:
+        return LLMRequestsChain(llm_chain=llm_chain, **config)
+
+
+type_to_loader_dict = {
+    "api_chain": _load_api_chain,
+    "hyde_chain": _load_hyde_chain,
+    "llm_chain": _load_llm_chain,
+    "llm_bash_chain": _load_llm_bash_chain,
+    "llm_checker_chain": _load_llm_checker_chain,
+    "llm_math_chain": _load_llm_math_chain,
+    "llm_requests_chain": _load_llm_requests_chain,
+    "pal_chain": _load_pal_chain,
+    "qa_with_sources_chain": _load_qa_with_sources_chain,
+    "stuff_documents_chain": _load_stuff_documents_chain,
+    "map_reduce_documents_chain": _load_map_reduce_documents_chain,
+    "reduce_documents_chain": _load_reduce_documents_chain,
+    "map_rerank_documents_chain": _load_map_rerank_documents_chain,
+    "refine_documents_chain": _load_refine_documents_chain,
+    "sql_database_chain": _load_sql_database_chain,
+    "vector_db_qa_with_sources_chain": _load_vector_db_qa_with_sources_chain,
+    "vector_db_qa": _load_vector_db_qa,
+    "retrieval_qa": _load_retrieval_qa,
+    "retrieval_qa_with_sources_chain": _load_retrieval_qa_with_sources_chain,
+    "graph_cypher_chain": _load_graph_cypher_chain,
+}
+
+
+def load_chain_from_config(config: dict, **kwargs: Any) -> Chain:
+    """Load chain from Config Dict."""
+    if "_type" not in config:
+        raise ValueError("Must specify a chain Type in config")
+    config_type = config.pop("_type")
+
+    if config_type not in type_to_loader_dict:
+        raise ValueError(f"Loading {config_type} chain not supported")
+
+    chain_loader = type_to_loader_dict[config_type]
+    return chain_loader(config, **kwargs)
+
+
+def load_chain(path: Union[str, Path], **kwargs: Any) -> Chain:
+    """Unified method for loading a chain from LangChainHub or local fs."""
+    if isinstance(path, str) and path.startswith("lc://"):
+        raise RuntimeError(
+            "Loading from the deprecated github-based Hub is no longer supported. "
+            "Please use the new LangChain Hub at https://smith.langchain.com/hub "
+            "instead."
+        )
+    return _load_chain_from_file(path, **kwargs)
+
+
+def _load_chain_from_file(file: Union[str, Path], **kwargs: Any) -> Chain:
+    """Load chain from file."""
+    # Convert file to Path object.
+    if isinstance(file, str):
+        file_path = Path(file)
+    else:
+        file_path = file
+    # Load from either json or yaml.
+    if file_path.suffix == ".json":
+        with open(file_path) as f:
+            config = json.load(f)
+    elif file_path.suffix.endswith((".yaml", ".yml")):
+        with open(file_path, "r") as f:
+            config = yaml.safe_load(f)
+    else:
+        raise ValueError("File type must be json or yaml")
+
+    # Override default 'verbose' and 'memory' for the chain
+    if "verbose" in kwargs:
+        config["verbose"] = kwargs.pop("verbose")
+    if "memory" in kwargs:
+        config["memory"] = kwargs.pop("memory")
+
+    # Load the chain from the config now.
+    return load_chain_from_config(config, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/chains/mapreduce.py b/llm/Lib/site-packages/langchain/chains/mapreduce.py
new file mode 100644
index 0000000000000000000000000000000000000000..591def175d1faca5017f25c62c5baa563cde0bfe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/mapreduce.py
@@ -0,0 +1,108 @@
+"""Map-reduce chain.
+
+Splits up a document, sends the smaller parts to the LLM with one prompt,
+then combines the results with another one.
+"""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForChainRun, Callbacks
+from langchain_core.documents import Document
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Extra
+from langchain_text_splitters import TextSplitter
+
+from langchain.chains import ReduceDocumentsChain
+from langchain.chains.base import Chain
+from langchain.chains.combine_documents.base import BaseCombineDocumentsChain
+from langchain.chains.combine_documents.map_reduce import MapReduceDocumentsChain
+from langchain.chains.combine_documents.stuff import StuffDocumentsChain
+from langchain.chains.llm import LLMChain
+
+
+class MapReduceChain(Chain):
+    """Map-reduce chain."""
+
+    combine_documents_chain: BaseCombineDocumentsChain
+    """Chain to use to combine documents."""
+    text_splitter: TextSplitter
+    """Text splitter to use."""
+    input_key: str = "input_text"  #: :meta private:
+    output_key: str = "output_text"  #: :meta private:
+
+    @classmethod
+    def from_params(
+        cls,
+        llm: BaseLanguageModel,
+        prompt: BasePromptTemplate,
+        text_splitter: TextSplitter,
+        callbacks: Callbacks = None,
+        combine_chain_kwargs: Optional[Mapping[str, Any]] = None,
+        reduce_chain_kwargs: Optional[Mapping[str, Any]] = None,
+        **kwargs: Any,
+    ) -> MapReduceChain:
+        """Construct a map-reduce chain that uses the chain for map and reduce."""
+        llm_chain = LLMChain(llm=llm, prompt=prompt, callbacks=callbacks)
+        stuff_chain = StuffDocumentsChain(
+            llm_chain=llm_chain,
+            callbacks=callbacks,
+            **(reduce_chain_kwargs if reduce_chain_kwargs else {}),
+        )
+        reduce_documents_chain = ReduceDocumentsChain(
+            combine_documents_chain=stuff_chain
+        )
+        combine_documents_chain = MapReduceDocumentsChain(
+            llm_chain=llm_chain,
+            reduce_documents_chain=reduce_documents_chain,
+            callbacks=callbacks,
+            **(combine_chain_kwargs if combine_chain_kwargs else {}),
+        )
+        return cls(
+            combine_documents_chain=combine_documents_chain,
+            text_splitter=text_splitter,
+            callbacks=callbacks,
+            **kwargs,
+        )
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Expect input key.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return output key.
+
+        :meta private:
+        """
+        return [self.output_key]
+
+    def _call(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        # Split the larger text into smaller chunks.
+        doc_text = inputs.pop(self.input_key)
+        texts = self.text_splitter.split_text(doc_text)
+        docs = [Document(page_content=text) for text in texts]
+        _inputs: Dict[str, Any] = {
+            **inputs,
+            self.combine_documents_chain.input_key: docs,
+        }
+        outputs = self.combine_documents_chain.run(
+            _inputs, callbacks=_run_manager.get_child()
+        )
+        return {self.output_key: outputs}
diff --git a/llm/Lib/site-packages/langchain/chains/moderation.py b/llm/Lib/site-packages/langchain/chains/moderation.py
new file mode 100644
index 0000000000000000000000000000000000000000..6deb63ed0629c6102fcbd30b288636eedd7003c8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/moderation.py
@@ -0,0 +1,96 @@
+"""Pass input through a moderation endpoint."""
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain.chains.base import Chain
+
+
+class OpenAIModerationChain(Chain):
+    """Pass input through a moderation endpoint.
+
+    To use, you should have the ``openai`` python package installed, and the
+    environment variable ``OPENAI_API_KEY`` set with your API key.
+
+    Any parameters that are valid to be passed to the openai.create call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.chains import OpenAIModerationChain
+            moderation = OpenAIModerationChain()
+    """
+
+    client: Any  #: :meta private:
+    model_name: Optional[str] = None
+    """Moderation model name to use."""
+    error: bool = False
+    """Whether or not to error if bad content was found."""
+    input_key: str = "input"  #: :meta private:
+    output_key: str = "output"  #: :meta private:
+    openai_api_key: Optional[str] = None
+    openai_organization: Optional[str] = None
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        openai_api_key = get_from_dict_or_env(
+            values, "openai_api_key", "OPENAI_API_KEY"
+        )
+        openai_organization = get_from_dict_or_env(
+            values,
+            "openai_organization",
+            "OPENAI_ORGANIZATION",
+            default="",
+        )
+        try:
+            import openai
+
+            openai.api_key = openai_api_key
+            if openai_organization:
+                openai.organization = openai_organization
+            values["client"] = openai.Moderation  # type: ignore
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+        return values
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Expect input key.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return output key.
+
+        :meta private:
+        """
+        return [self.output_key]
+
+    def _moderate(self, text: str, results: dict) -> str:
+        if results["flagged"]:
+            error_str = "Text was found that violates OpenAI's content policy."
+            if self.error:
+                raise ValueError(error_str)
+            else:
+                return error_str
+        return text
+
+    def _call(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        text = inputs[self.input_key]
+        results = self.client.create(text)
+        output = self._moderate(text, results["results"][0])
+        return {self.output_key: output}
diff --git a/llm/Lib/site-packages/langchain/chains/natbot/__init__.py b/llm/Lib/site-packages/langchain/chains/natbot/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..45a2231ae51d147993c758754ead0c3cb46efdf0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/natbot/__init__.py
@@ -0,0 +1,4 @@
+"""Implement a GPT-3 driven browser.
+
+Heavily influenced from https://github.com/nat/natbot
+"""
diff --git a/llm/Lib/site-packages/langchain/chains/natbot/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/natbot/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4f30d6020126470916034580174b3e3542f0d4c5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/natbot/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/natbot/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/natbot/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..349e3fe57da85ff3bb4b9dfe443969a3ef584989
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/natbot/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/natbot/__pycache__/crawler.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/natbot/__pycache__/crawler.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d8736ef1ac1c16f169433fe4d9373d251df0d59e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/natbot/__pycache__/crawler.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/natbot/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/natbot/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aac6112e37567cc1edba506190b16a7f03dd8d08
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/natbot/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/natbot/base.py b/llm/Lib/site-packages/langchain/chains/natbot/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..e74c3477b141942029caa6461923debe2b5179e8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/natbot/base.py
@@ -0,0 +1,141 @@
+"""Implement an LLM driven browser."""
+from __future__ import annotations
+
+import warnings
+from typing import Any, Dict, List, Optional
+
+from langchain_community.llms.openai import OpenAI
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.pydantic_v1 import Extra, root_validator
+
+from langchain.chains.base import Chain
+from langchain.chains.llm import LLMChain
+from langchain.chains.natbot.prompt import PROMPT
+
+
+class NatBotChain(Chain):
+    """Implement an LLM driven browser.
+
+    **Security Note**: This toolkit provides code to control a web-browser.
+
+        The web-browser can be used to navigate to:
+
+        - Any URL (including any internal network URLs)
+        - And local files
+
+        Exercise care if exposing this chain to end-users. Control who is able to
+        access and use this chain, and isolate the network access of the server
+        that hosts this chain.
+
+        See https://python.langchain.com/docs/security for more information.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.chains import NatBotChain
+            natbot = NatBotChain.from_default("Buy me a new hat.")
+    """
+
+    llm_chain: LLMChain
+    objective: str
+    """Objective that NatBot is tasked with completing."""
+    llm: Optional[BaseLanguageModel] = None
+    """[Deprecated] LLM wrapper to use."""
+    input_url_key: str = "url"  #: :meta private:
+    input_browser_content_key: str = "browser_content"  #: :meta private:
+    previous_command: str = ""  #: :meta private:
+    output_key: str = "command"  #: :meta private:
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator(pre=True)
+    def raise_deprecation(cls, values: Dict) -> Dict:
+        if "llm" in values:
+            warnings.warn(
+                "Directly instantiating an NatBotChain with an llm is deprecated. "
+                "Please instantiate with llm_chain argument or using the from_llm "
+                "class method."
+            )
+            if "llm_chain" not in values and values["llm"] is not None:
+                values["llm_chain"] = LLMChain(llm=values["llm"], prompt=PROMPT)
+        return values
+
+    @classmethod
+    def from_default(cls, objective: str, **kwargs: Any) -> NatBotChain:
+        """Load with default LLMChain."""
+        llm = OpenAI(temperature=0.5, best_of=10, n=3, max_tokens=50)
+        return cls.from_llm(llm, objective, **kwargs)
+
+    @classmethod
+    def from_llm(
+        cls, llm: BaseLanguageModel, objective: str, **kwargs: Any
+    ) -> NatBotChain:
+        """Load from LLM."""
+        llm_chain = LLMChain(llm=llm, prompt=PROMPT)
+        return cls(llm_chain=llm_chain, objective=objective, **kwargs)
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Expect url and browser content.
+
+        :meta private:
+        """
+        return [self.input_url_key, self.input_browser_content_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return command.
+
+        :meta private:
+        """
+        return [self.output_key]
+
+    def _call(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        url = inputs[self.input_url_key]
+        browser_content = inputs[self.input_browser_content_key]
+        llm_cmd = self.llm_chain.predict(
+            objective=self.objective,
+            url=url[:100],
+            previous_command=self.previous_command,
+            browser_content=browser_content[:4500],
+            callbacks=_run_manager.get_child(),
+        )
+        llm_cmd = llm_cmd.strip()
+        self.previous_command = llm_cmd
+        return {self.output_key: llm_cmd}
+
+    def execute(self, url: str, browser_content: str) -> str:
+        """Figure out next browser command to run.
+
+        Args:
+            url: URL of the site currently on.
+            browser_content: Content of the page as currently displayed by the browser.
+
+        Returns:
+            Next browser command to run.
+
+        Example:
+            .. code-block:: python
+
+                browser_content = "...."
+                llm_command = natbot.run("www.google.com", browser_content)
+        """
+        _inputs = {
+            self.input_url_key: url,
+            self.input_browser_content_key: browser_content,
+        }
+        return self(_inputs)[self.output_key]
+
+    @property
+    def _chain_type(self) -> str:
+        return "nat_bot_chain"
diff --git a/llm/Lib/site-packages/langchain/chains/natbot/crawler.py b/llm/Lib/site-packages/langchain/chains/natbot/crawler.py
new file mode 100644
index 0000000000000000000000000000000000000000..b5fbc553357692817096da4e06fb72879f79a4b6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/natbot/crawler.py
@@ -0,0 +1,446 @@
+# flake8: noqa
+import time
+from sys import platform
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Set,
+    Tuple,
+    TypedDict,
+    Union,
+)
+
+if TYPE_CHECKING:
+    from playwright.sync_api import Browser, CDPSession, Page, sync_playwright
+
+black_listed_elements: Set[str] = {
+    "html",
+    "head",
+    "title",
+    "meta",
+    "iframe",
+    "body",
+    "script",
+    "style",
+    "path",
+    "svg",
+    "br",
+    "::marker",
+}
+
+
+class ElementInViewPort(TypedDict):
+    """A typed dictionary containing information about elements in the viewport."""
+
+    node_index: str
+    backend_node_id: int
+    node_name: Optional[str]
+    node_value: Optional[str]
+    node_meta: List[str]
+    is_clickable: bool
+    origin_x: int
+    origin_y: int
+    center_x: int
+    center_y: int
+
+
+class Crawler:
+    """A crawler for web pages.
+
+    **Security Note**: This is an implementation of a crawler that uses a browser via
+        Playwright.
+
+        This crawler can be used to load arbitrary webpages INCLUDING content
+        from the local file system.
+
+        Control access to who can submit crawling requests and what network access
+        the crawler has.
+
+        Make sure to scope permissions to the minimal permissions necessary for
+        the application.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(self) -> None:
+        try:
+            from playwright.sync_api import sync_playwright
+        except ImportError:
+            raise ImportError(
+                "Could not import playwright python package. "
+                "Please install it with `pip install playwright`."
+            )
+        self.browser: Browser = (
+            sync_playwright().start().chromium.launch(headless=False)
+        )
+        self.page: Page = self.browser.new_page()
+        self.page.set_viewport_size({"width": 1280, "height": 1080})
+        self.page_element_buffer: Dict[int, ElementInViewPort]
+        self.client: CDPSession
+
+    def go_to_page(self, url: str) -> None:
+        self.page.goto(url=url if "://" in url else "http://" + url)
+        self.client = self.page.context.new_cdp_session(self.page)
+        self.page_element_buffer = {}
+
+    def scroll(self, direction: str) -> None:
+        if direction == "up":
+            self.page.evaluate(
+                "(document.scrollingElement || document.body).scrollTop = (document.scrollingElement || document.body).scrollTop - window.innerHeight;"
+            )
+        elif direction == "down":
+            self.page.evaluate(
+                "(document.scrollingElement || document.body).scrollTop = (document.scrollingElement || document.body).scrollTop + window.innerHeight;"
+            )
+
+    def click(self, id: Union[str, int]) -> None:
+        # Inject javascript into the page which removes the target= attribute from all links
+        js = """
+		links = document.getElementsByTagName("a");
+		for (var i = 0; i < links.length; i++) {
+			links[i].removeAttribute("target");
+		}
+		"""
+        self.page.evaluate(js)
+
+        element = self.page_element_buffer.get(int(id))
+        if element:
+            x: float = element["center_x"]
+            y: float = element["center_y"]
+
+            self.page.mouse.click(x, y)
+        else:
+            print("Could not find element")  # noqa: T201
+
+    def type(self, id: Union[str, int], text: str) -> None:
+        self.click(id)
+        self.page.keyboard.type(text)
+
+    def enter(self) -> None:
+        self.page.keyboard.press("Enter")
+
+    def crawl(self) -> List[str]:
+        page = self.page
+        page_element_buffer = self.page_element_buffer
+        start = time.time()
+
+        page_state_as_text = []
+
+        device_pixel_ratio: float = page.evaluate("window.devicePixelRatio")
+        if platform == "darwin" and device_pixel_ratio == 1:  # lies
+            device_pixel_ratio = 2
+
+        win_upper_bound: float = page.evaluate("window.pageYOffset")
+        win_left_bound: float = page.evaluate("window.pageXOffset")
+        win_width: float = page.evaluate("window.screen.width")
+        win_height: float = page.evaluate("window.screen.height")
+        win_right_bound: float = win_left_bound + win_width
+        win_lower_bound: float = win_upper_bound + win_height
+
+        # 		percentage_progress_start = (win_upper_bound / document_scroll_height) * 100
+        # 		percentage_progress_end = (
+        # 			(win_height + win_upper_bound) / document_scroll_height
+        # 		) * 100
+        percentage_progress_start = 1
+        percentage_progress_end = 2
+
+        page_state_as_text.append(
+            {
+                "x": 0,
+                "y": 0,
+                "text": "[scrollbar {:0.2f}-{:0.2f}%]".format(
+                    round(percentage_progress_start, 2), round(percentage_progress_end)
+                ),
+            }
+        )
+
+        tree = self.client.send(
+            "DOMSnapshot.captureSnapshot",
+            {"computedStyles": [], "includeDOMRects": True, "includePaintOrder": True},
+        )
+        strings: Dict[int, str] = tree["strings"]
+        document: Dict[str, Any] = tree["documents"][0]
+        nodes: Dict[str, Any] = document["nodes"]
+        backend_node_id: Dict[int, int] = nodes["backendNodeId"]
+        attributes: Dict[int, Dict[int, Any]] = nodes["attributes"]
+        node_value: Dict[int, int] = nodes["nodeValue"]
+        parent: Dict[int, int] = nodes["parentIndex"]
+        node_names: Dict[int, int] = nodes["nodeName"]
+        is_clickable: Set[int] = set(nodes["isClickable"]["index"])
+
+        input_value: Dict[str, Any] = nodes["inputValue"]
+        input_value_index: List[int] = input_value["index"]
+        input_value_values: List[int] = input_value["value"]
+
+        layout: Dict[str, Any] = document["layout"]
+        layout_node_index: List[int] = layout["nodeIndex"]
+        bounds: Dict[int, List[float]] = layout["bounds"]
+
+        cursor: int = 0
+
+        child_nodes: Dict[str, List[Dict[str, Any]]] = {}
+        elements_in_view_port: List[ElementInViewPort] = []
+
+        anchor_ancestry: Dict[str, Tuple[bool, Optional[int]]] = {"-1": (False, None)}
+        button_ancestry: Dict[str, Tuple[bool, Optional[int]]] = {"-1": (False, None)}
+
+        def convert_name(
+            node_name: Optional[str], has_click_handler: Optional[bool]
+        ) -> str:
+            if node_name == "a":
+                return "link"
+            if node_name == "input":
+                return "input"
+            if node_name == "img":
+                return "img"
+            if (
+                node_name == "button" or has_click_handler
+            ):  # found pages that needed this quirk
+                return "button"
+            else:
+                return "text"
+
+        def find_attributes(
+            attributes: Dict[int, Any], keys: List[str]
+        ) -> Dict[str, str]:
+            values = {}
+
+            for [key_index, value_index] in zip(*(iter(attributes),) * 2):
+                if value_index < 0:
+                    continue
+                key = strings[key_index]
+                value = strings[value_index]
+
+                if key in keys:
+                    values[key] = value
+                    keys.remove(key)
+
+                    if not keys:
+                        return values
+
+            return values
+
+        def add_to_hash_tree(
+            hash_tree: Dict[str, Tuple[bool, Optional[int]]],
+            tag: str,
+            node_id: int,
+            node_name: Optional[str],
+            parent_id: int,
+        ) -> Tuple[bool, Optional[int]]:
+            parent_id_str = str(parent_id)
+            if not parent_id_str in hash_tree:
+                parent_name = strings[node_names[parent_id]].lower()
+                grand_parent_id = parent[parent_id]
+
+                add_to_hash_tree(
+                    hash_tree, tag, parent_id, parent_name, grand_parent_id
+                )
+
+            is_parent_desc_anchor, anchor_id = hash_tree[parent_id_str]
+
+            # even if the anchor is nested in another anchor, we set the "root" for all descendants to be ::Self
+            if node_name == tag:
+                value: Tuple[bool, Optional[int]] = (True, node_id)
+            elif (
+                is_parent_desc_anchor
+            ):  # reuse the parent's anchor_id (which could be much higher in the tree)
+                value = (True, anchor_id)
+            else:
+                value = (
+                    False,
+                    None,
+                )  # not a descendant of an anchor, most likely it will become text, an interactive element or discarded
+
+            hash_tree[str(node_id)] = value
+
+            return value
+
+        for index, node_name_index in enumerate(node_names):
+            node_parent = parent[index]
+            node_name: Optional[str] = strings[node_name_index].lower()
+
+            is_ancestor_of_anchor, anchor_id = add_to_hash_tree(
+                anchor_ancestry, "a", index, node_name, node_parent
+            )
+
+            is_ancestor_of_button, button_id = add_to_hash_tree(
+                button_ancestry, "button", index, node_name, node_parent
+            )
+
+            try:
+                cursor = layout_node_index.index(
+                    index
+                )  # todo replace this with proper cursoring, ignoring the fact this is O(n^2) for the moment
+            except:
+                continue
+
+            if node_name in black_listed_elements:
+                continue
+
+            [x, y, width, height] = bounds[cursor]
+            x /= device_pixel_ratio
+            y /= device_pixel_ratio
+            width /= device_pixel_ratio
+            height /= device_pixel_ratio
+
+            elem_left_bound = x
+            elem_top_bound = y
+            elem_right_bound = x + width
+            elem_lower_bound = y + height
+
+            partially_is_in_viewport = (
+                elem_left_bound < win_right_bound
+                and elem_right_bound >= win_left_bound
+                and elem_top_bound < win_lower_bound
+                and elem_lower_bound >= win_upper_bound
+            )
+
+            if not partially_is_in_viewport:
+                continue
+
+            meta_data: List[str] = []
+
+            # inefficient to grab the same set of keys for kinds of objects, but it's fine for now
+            element_attributes = find_attributes(
+                attributes[index], ["type", "placeholder", "aria-label", "title", "alt"]
+            )
+
+            ancestor_exception = is_ancestor_of_anchor or is_ancestor_of_button
+            ancestor_node_key = (
+                None
+                if not ancestor_exception
+                else str(anchor_id)
+                if is_ancestor_of_anchor
+                else str(button_id)
+            )
+            ancestor_node = (
+                None
+                if not ancestor_exception
+                else child_nodes.setdefault(str(ancestor_node_key), [])
+            )
+
+            if node_name == "#text" and ancestor_exception and ancestor_node:
+                text = strings[node_value[index]]
+                if text == "|" or text == "•":
+                    continue
+                ancestor_node.append({"type": "type", "value": text})
+            else:
+                if (
+                    node_name == "input" and element_attributes.get("type") == "submit"
+                ) or node_name == "button":
+                    node_name = "button"
+                    element_attributes.pop(
+                        "type", None
+                    )  # prevent [button ... (button)..]
+
+                for key in element_attributes:
+                    if ancestor_exception and ancestor_node:
+                        ancestor_node.append(
+                            {
+                                "type": "attribute",
+                                "key": key,
+                                "value": element_attributes[key],
+                            }
+                        )
+                    else:
+                        meta_data.append(element_attributes[key])
+
+            element_node_value = None
+
+            if node_value[index] >= 0:
+                element_node_value = strings[node_value[index]]
+                if (
+                    element_node_value == "|"
+                ):  # commonly used as a separator, does not add much context - lets save ourselves some token space
+                    continue
+            elif (
+                node_name == "input"
+                and index in input_value_index
+                and element_node_value is None
+            ):
+                node_input_text_index = input_value_index.index(index)
+                text_index = input_value_values[node_input_text_index]
+                if node_input_text_index >= 0 and text_index >= 0:
+                    element_node_value = strings[text_index]
+
+            # remove redundant elements
+            if ancestor_exception and (node_name != "a" and node_name != "button"):
+                continue
+
+            elements_in_view_port.append(
+                {
+                    "node_index": str(index),
+                    "backend_node_id": backend_node_id[index],
+                    "node_name": node_name,
+                    "node_value": element_node_value,
+                    "node_meta": meta_data,
+                    "is_clickable": index in is_clickable,
+                    "origin_x": int(x),
+                    "origin_y": int(y),
+                    "center_x": int(x + (width / 2)),
+                    "center_y": int(y + (height / 2)),
+                }
+            )
+
+        # lets filter further to remove anything that does not hold any text nor has click handlers + merge text from leaf#text nodes with the parent
+        elements_of_interest = []
+        id_counter = 0
+
+        for element in elements_in_view_port:
+            node_index = element.get("node_index")
+            node_name = element.get("node_name")
+            element_node_value = element.get("node_value")
+            node_is_clickable = element.get("is_clickable")
+            node_meta_data: Optional[List[str]] = element.get("node_meta")
+
+            inner_text = f"{element_node_value} " if element_node_value else ""
+            meta = ""
+
+            if node_index in child_nodes:
+                for child in child_nodes[node_index]:
+                    entry_type = child.get("type")
+                    entry_value = child.get("value")
+
+                    if entry_type == "attribute" and node_meta_data:
+                        entry_key = child.get("key")
+                        node_meta_data.append(f'{entry_key}="{entry_value}"')
+                    else:
+                        inner_text += f"{entry_value} "
+
+            if node_meta_data:
+                meta_string = " ".join(node_meta_data)
+                meta = f" {meta_string}"
+
+            if inner_text != "":
+                inner_text = f"{inner_text.strip()}"
+
+            converted_node_name = convert_name(node_name, node_is_clickable)
+
+            # not very elegant, more like a placeholder
+            if (
+                (converted_node_name != "button" or meta == "")
+                and converted_node_name != "link"
+                and converted_node_name != "input"
+                and converted_node_name != "img"
+                and converted_node_name != "textarea"
+            ) and inner_text.strip() == "":
+                continue
+
+            page_element_buffer[id_counter] = element
+
+            if inner_text != "":
+                elements_of_interest.append(
+                    f"""<{converted_node_name} id={id_counter}{meta}>{inner_text}</{converted_node_name}>"""
+                )
+            else:
+                elements_of_interest.append(
+                    f"""<{converted_node_name} id={id_counter}{meta}/>"""
+                )
+            id_counter += 1
+
+        print("Parsing time: {:0.2f} seconds".format(time.time() - start))  # noqa: T201
+        return elements_of_interest
diff --git a/llm/Lib/site-packages/langchain/chains/natbot/prompt.py b/llm/Lib/site-packages/langchain/chains/natbot/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..82a35f58c7e9f404aeb949785ee276bb3e083682
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/natbot/prompt.py
@@ -0,0 +1,144 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+_PROMPT_TEMPLATE = """
+You are an agents controlling a browser. You are given:
+
+	(1) an objective that you are trying to achieve
+	(2) the URL of your current web page
+	(3) a simplified text description of what's visible in the browser window (more on that below)
+
+You can issue these commands:
+	SCROLL UP - scroll up one page
+	SCROLL DOWN - scroll down one page
+	CLICK X - click on a given element. You can only click on links, buttons, and inputs!
+	TYPE X "TEXT" - type the specified text into the input with id X
+	TYPESUBMIT X "TEXT" - same as TYPE above, except then it presses ENTER to submit the form
+
+The format of the browser content is highly simplified; all formatting elements are stripped.
+Interactive elements such as links, inputs, buttons are represented like this:
+
+		<link id=1>text</link>
+		<button id=2>text</button>
+		<input id=3>text</input>
+
+Images are rendered as their alt text like this:
+
+		<img id=4 alt=""/>
+
+Based on your given objective, issue whatever command you believe will get you closest to achieving your goal.
+You always start on Google; you should submit a search query to Google that will take you to the best page for
+achieving your objective. And then interact with that page to achieve your objective.
+
+If you find yourself on Google and there are no search results displayed yet, you should probably issue a command
+like "TYPESUBMIT 7 "search query"" to get to a more useful page.
+
+Then, if you find yourself on a Google search results page, you might issue the command "CLICK 24" to click
+on the first link in the search results. (If your previous command was a TYPESUBMIT your next command should
+probably be a CLICK.)
+
+Don't try to interact with elements that you can't see.
+
+Here are some examples:
+
+EXAMPLE 1:
+==================================================
+CURRENT BROWSER CONTENT:
+------------------
+<link id=1>About</link>
+<link id=2>Store</link>
+<link id=3>Gmail</link>
+<link id=4>Images</link>
+<link id=5>(Google apps)</link>
+<link id=6>Sign in</link>
+<img id=7 alt="(Google)"/>
+<input id=8 alt="Search"></input>
+<button id=9>(Search by voice)</button>
+<button id=10>(Google Search)</button>
+<button id=11>(I'm Feeling Lucky)</button>
+<link id=12>Advertising</link>
+<link id=13>Business</link>
+<link id=14>How Search works</link>
+<link id=15>Carbon neutral since 2007</link>
+<link id=16>Privacy</link>
+<link id=17>Terms</link>
+<text id=18>Settings</text>
+------------------
+OBJECTIVE: Find a 2 bedroom house for sale in Anchorage AK for under $750k
+CURRENT URL: https://www.google.com/
+YOUR COMMAND:
+TYPESUBMIT 8 "anchorage redfin"
+==================================================
+
+EXAMPLE 2:
+==================================================
+CURRENT BROWSER CONTENT:
+------------------
+<link id=1>About</link>
+<link id=2>Store</link>
+<link id=3>Gmail</link>
+<link id=4>Images</link>
+<link id=5>(Google apps)</link>
+<link id=6>Sign in</link>
+<img id=7 alt="(Google)"/>
+<input id=8 alt="Search"></input>
+<button id=9>(Search by voice)</button>
+<button id=10>(Google Search)</button>
+<button id=11>(I'm Feeling Lucky)</button>
+<link id=12>Advertising</link>
+<link id=13>Business</link>
+<link id=14>How Search works</link>
+<link id=15>Carbon neutral since 2007</link>
+<link id=16>Privacy</link>
+<link id=17>Terms</link>
+<text id=18>Settings</text>
+------------------
+OBJECTIVE: Make a reservation for 4 at Dorsia at 8pm
+CURRENT URL: https://www.google.com/
+YOUR COMMAND:
+TYPESUBMIT 8 "dorsia nyc opentable"
+==================================================
+
+EXAMPLE 3:
+==================================================
+CURRENT BROWSER CONTENT:
+------------------
+<button id=1>For Businesses</button>
+<button id=2>Mobile</button>
+<button id=3>Help</button>
+<button id=4 alt="Language Picker">EN</button>
+<link id=5>OpenTable logo</link>
+<button id=6 alt ="search">Search</button>
+<text id=7>Find your table for any occasion</text>
+<button id=8>(Date selector)</button>
+<text id=9>Sep 28, 2022</text>
+<text id=10>7:00 PM</text>
+<text id=11>2 people</text>
+<input id=12 alt="Location, Restaurant, or Cuisine"></input>
+<button id=13>Let’s go</button>
+<text id=14>It looks like you're in Peninsula. Not correct?</text>
+<button id=15>Get current location</button>
+<button id=16>Next</button>
+------------------
+OBJECTIVE: Make a reservation for 4 for dinner at Dorsia in New York City at 8pm
+CURRENT URL: https://www.opentable.com/
+YOUR COMMAND:
+TYPESUBMIT 12 "dorsia new york city"
+==================================================
+
+The current browser content, objective, and current URL follow. Reply with your next command to the browser.
+
+CURRENT BROWSER CONTENT:
+------------------
+{browser_content}
+------------------
+
+OBJECTIVE: {objective}
+CURRENT URL: {url}
+PREVIOUS COMMAND: {previous_command}
+YOUR COMMAND:
+"""
+PROMPT = PromptTemplate(
+    input_variables=["browser_content", "url", "previous_command", "objective"],
+    template=_PROMPT_TEMPLATE,
+)
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/__init__.py b/llm/Lib/site-packages/langchain/chains/openai_functions/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b6268422451a520712d4e1fe81a12d5f57cc022d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/openai_functions/__init__.py
@@ -0,0 +1,41 @@
+from langchain.chains.openai_functions.base import (
+    convert_to_openai_function,
+    create_openai_fn_chain,
+    create_structured_output_chain,
+)
+from langchain.chains.openai_functions.citation_fuzzy_match import (
+    create_citation_fuzzy_match_chain,
+)
+from langchain.chains.openai_functions.extraction import (
+    create_extraction_chain,
+    create_extraction_chain_pydantic,
+)
+from langchain.chains.openai_functions.qa_with_structure import (
+    create_qa_with_sources_chain,
+    create_qa_with_structure_chain,
+)
+from langchain.chains.openai_functions.tagging import (
+    create_tagging_chain,
+    create_tagging_chain_pydantic,
+)
+from langchain.chains.structured_output.base import (
+    create_openai_fn_runnable,
+    create_structured_output_runnable,
+    get_openai_output_parser,
+)
+
+__all__ = [
+    "convert_to_openai_function",
+    "create_tagging_chain",
+    "create_tagging_chain_pydantic",
+    "create_extraction_chain_pydantic",
+    "create_extraction_chain",
+    "create_citation_fuzzy_match_chain",
+    "create_qa_with_structure_chain",
+    "create_qa_with_sources_chain",
+    "create_structured_output_chain",
+    "create_openai_fn_chain",
+    "create_structured_output_runnable",  # backwards compatibility
+    "create_openai_fn_runnable",  # backwards compatibility
+    "get_openai_output_parser",  # backwards compatibility
+]
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..efa42e0bbd361c75e1c98397ccd0a119d39e8d77
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8c68850f7f0cacddcd52a899c4f748e02e05b812
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/citation_fuzzy_match.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/citation_fuzzy_match.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ace5265ee276d10ca098bb8eddda2ea4e499f402
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/citation_fuzzy_match.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/extraction.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/extraction.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5fe5f2699dbe8da70d4c28bdf001541b7c4ca2aa
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/extraction.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/openapi.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/openapi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..233cf30bf1cead59231b1f27d7d8bc7d28f990ee
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/openapi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/qa_with_structure.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/qa_with_structure.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fe47d151111bbfc89d710c199f27c5f75840235c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/qa_with_structure.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/tagging.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/tagging.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..df2ba60947030f0dadfbf17e8f516337646392d5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/tagging.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3bb20728b330748a6d73bd702daa1d0d1b13f358
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/openai_functions/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/base.py b/llm/Lib/site-packages/langchain/chains/openai_functions/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..0d7e7cf189c24a13f696ca3ab282aab5c47fd924
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/openai_functions/base.py
@@ -0,0 +1,233 @@
+"""Methods for creating chains that use OpenAI function-calling APIs."""
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Optional,
+    Sequence,
+    Type,
+    Union,
+)
+
+from langchain_core._api import deprecated
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import (
+    BaseLLMOutputParser,
+)
+from langchain_core.output_parsers.openai_functions import (
+    PydanticAttrOutputFunctionsParser,
+)
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.utils.function_calling import (
+    PYTHON_TO_JSON_TYPES,
+    convert_to_openai_function,
+)
+
+from langchain.chains import LLMChain
+from langchain.chains.structured_output.base import (
+    create_openai_fn_runnable,
+    create_structured_output_runnable,
+    get_openai_output_parser,
+)
+
+__all__ = [
+    "get_openai_output_parser",
+    "create_openai_fn_runnable",
+    "create_structured_output_runnable",
+    "create_openai_fn_chain",  # deprecated
+    "create_structured_output_chain",  # deprecated
+    "PYTHON_TO_JSON_TYPES",  # backwards compatibility
+    "convert_to_openai_function",  # backwards compatibility
+]
+
+
+@deprecated(since="0.1.1", removal="0.2.0", alternative="create_openai_fn_runnable")
+def create_openai_fn_chain(
+    functions: Sequence[Union[Dict[str, Any], Type[BaseModel], Callable]],
+    llm: BaseLanguageModel,
+    prompt: BasePromptTemplate,
+    *,
+    enforce_single_function_usage: bool = True,
+    output_key: str = "function",
+    output_parser: Optional[BaseLLMOutputParser] = None,
+    **kwargs: Any,
+) -> LLMChain:  # type: ignore[valid-type]
+    """[Legacy] Create an LLM chain that uses OpenAI functions.
+
+    Args:
+        functions: A sequence of either dictionaries, pydantic.BaseModels classes, or
+            Python functions. If dictionaries are passed in, they are assumed to
+            already be a valid OpenAI functions. If only a single
+            function is passed in, then it will be enforced that the model use that
+            function. pydantic.BaseModels and Python functions should have docstrings
+            describing what the function does. For best results, pydantic.BaseModels
+            should have descriptions of the parameters and Python functions should have
+            Google Python style args descriptions in the docstring. Additionally,
+            Python functions should only use primitive types (str, int, float, bool) or
+            pydantic.BaseModels for arguments.
+        llm: Language model to use, assumed to support the OpenAI function-calling API.
+        prompt: BasePromptTemplate to pass to the model.
+        enforce_single_function_usage: only used if a single function is passed in. If
+            True, then the model will be forced to use the given function. If False,
+            then the model will be given the option to use the given function or not.
+        output_key: The key to use when returning the output in LLMChain.__call__.
+        output_parser: BaseLLMOutputParser to use for parsing model outputs. By default
+            will be inferred from the function types. If pydantic.BaseModels are passed
+            in, then the OutputParser will try to parse outputs using those. Otherwise
+            model outputs will simply be parsed as JSON. If multiple functions are
+            passed in and they are not pydantic.BaseModels, the chain output will
+            include both the name of the function that was returned and the arguments
+            to pass to the function.
+
+    Returns:
+        An LLMChain that will pass in the given functions to the model when run.
+
+    Example:
+        .. code-block:: python
+
+                from typing import Optional
+
+                from langchain.chains.openai_functions import create_openai_fn_chain
+                from langchain_community.chat_models import ChatOpenAI
+                from langchain_core.prompts import ChatPromptTemplate
+
+                from langchain_core.pydantic_v1 import BaseModel, Field
+
+
+                class RecordPerson(BaseModel):
+                    \"\"\"Record some identifying information about a person.\"\"\"
+
+                    name: str = Field(..., description="The person's name")
+                    age: int = Field(..., description="The person's age")
+                    fav_food: Optional[str] = Field(None, description="The person's favorite food")
+
+
+                class RecordDog(BaseModel):
+                    \"\"\"Record some identifying information about a dog.\"\"\"
+
+                    name: str = Field(..., description="The dog's name")
+                    color: str = Field(..., description="The dog's color")
+                    fav_food: Optional[str] = Field(None, description="The dog's favorite food")
+
+
+                llm = ChatOpenAI(model="gpt-4", temperature=0)
+                prompt = ChatPromptTemplate.from_messages(
+                    [
+                        ("system", "You are a world class algorithm for recording entities."),
+                        ("human", "Make calls to the relevant function to record the entities in the following input: {input}"),
+                        ("human", "Tip: Make sure to answer in the correct format"),
+                    ]
+                )
+                chain = create_openai_fn_chain([RecordPerson, RecordDog], llm, prompt)
+                chain.run("Harry was a chubby brown beagle who loved chicken")
+                # -> RecordDog(name="Harry", color="brown", fav_food="chicken")
+    """  # noqa: E501
+    if not functions:
+        raise ValueError("Need to pass in at least one function. Received zero.")
+    openai_functions = [convert_to_openai_function(f) for f in functions]
+    output_parser = output_parser or get_openai_output_parser(functions)
+    llm_kwargs: Dict[str, Any] = {
+        "functions": openai_functions,
+    }
+    if len(openai_functions) == 1 and enforce_single_function_usage:
+        llm_kwargs["function_call"] = {"name": openai_functions[0]["name"]}
+    llm_chain = LLMChain(  # type: ignore[misc]
+        llm=llm,
+        prompt=prompt,
+        output_parser=output_parser,
+        llm_kwargs=llm_kwargs,
+        output_key=output_key,
+        **kwargs,
+    )
+    return llm_chain
+
+
+@deprecated(
+    since="0.1.1", removal="0.2.0", alternative="create_structured_output_runnable"
+)
+def create_structured_output_chain(
+    output_schema: Union[Dict[str, Any], Type[BaseModel]],
+    llm: BaseLanguageModel,
+    prompt: BasePromptTemplate,
+    *,
+    output_key: str = "function",
+    output_parser: Optional[BaseLLMOutputParser] = None,
+    **kwargs: Any,
+) -> LLMChain:  # type: ignore[valid-type]
+    """[Legacy] Create an LLMChain that uses an OpenAI function to get a structured output.
+
+    Args:
+        output_schema: Either a dictionary or pydantic.BaseModel class. If a dictionary
+            is passed in, it's assumed to already be a valid JsonSchema.
+            For best results, pydantic.BaseModels should have docstrings describing what
+            the schema represents and descriptions for the parameters.
+        llm: Language model to use, assumed to support the OpenAI function-calling API.
+        prompt: BasePromptTemplate to pass to the model.
+        output_key: The key to use when returning the output in LLMChain.__call__.
+        output_parser: BaseLLMOutputParser to use for parsing model outputs. By default
+            will be inferred from the function types. If pydantic.BaseModels are passed
+            in, then the OutputParser will try to parse outputs using those. Otherwise
+            model outputs will simply be parsed as JSON.
+
+    Returns:
+        An LLMChain that will pass the given function to the model.
+
+    Example:
+        .. code-block:: python
+
+                from typing import Optional
+
+                from langchain.chains.openai_functions import create_structured_output_chain
+                from langchain_community.chat_models import ChatOpenAI
+                from langchain_core.prompts import ChatPromptTemplate
+
+                from langchain_core.pydantic_v1 import BaseModel, Field
+
+                class Dog(BaseModel):
+                    \"\"\"Identifying information about a dog.\"\"\"
+
+                    name: str = Field(..., description="The dog's name")
+                    color: str = Field(..., description="The dog's color")
+                    fav_food: Optional[str] = Field(None, description="The dog's favorite food")
+
+                llm = ChatOpenAI(model="gpt-3.5-turbo-0613", temperature=0)
+                prompt = ChatPromptTemplate.from_messages(
+                    [
+                        ("system", "You are a world class algorithm for extracting information in structured formats."),
+                        ("human", "Use the given format to extract information from the following input: {input}"),
+                        ("human", "Tip: Make sure to answer in the correct format"),
+                    ]
+                )
+                chain = create_structured_output_chain(Dog, llm, prompt)
+                chain.run("Harry was a chubby brown beagle who loved chicken")
+                # -> Dog(name="Harry", color="brown", fav_food="chicken")
+    """  # noqa: E501
+    if isinstance(output_schema, dict):
+        function: Any = {
+            "name": "output_formatter",
+            "description": (
+                "Output formatter. Should always be used to format your response to the"
+                " user."
+            ),
+            "parameters": output_schema,
+        }
+    else:
+
+        class _OutputFormatter(BaseModel):
+            """Output formatter. Should always be used to format your response to the user."""  # noqa: E501
+
+            output: output_schema  # type: ignore
+
+        function = _OutputFormatter
+        output_parser = output_parser or PydanticAttrOutputFunctionsParser(
+            pydantic_schema=_OutputFormatter, attr_name="output"
+        )
+    return create_openai_fn_chain(
+        [function],
+        llm,
+        prompt,
+        output_key=output_key,
+        output_parser=output_parser,
+        **kwargs,
+    )
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/citation_fuzzy_match.py b/llm/Lib/site-packages/langchain/chains/openai_functions/citation_fuzzy_match.py
new file mode 100644
index 0000000000000000000000000000000000000000..05bb27d7a9a053e1087c59b19883097ed050e814
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/openai_functions/citation_fuzzy_match.py
@@ -0,0 +1,106 @@
+from typing import Iterator, List
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.messages import HumanMessage, SystemMessage
+from langchain_core.output_parsers.openai_functions import PydanticOutputFunctionsParser
+from langchain_core.prompts.chat import ChatPromptTemplate, HumanMessagePromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain.chains.llm import LLMChain
+from langchain.chains.openai_functions.utils import get_llm_kwargs
+
+
+class FactWithEvidence(BaseModel):
+    """Class representing a single statement.
+
+    Each fact has a body and a list of sources.
+    If there are multiple facts make sure to break them apart
+    such that each one only uses a set of sources that are relevant to it.
+    """
+
+    fact: str = Field(..., description="Body of the sentence, as part of a response")
+    substring_quote: List[str] = Field(
+        ...,
+        description=(
+            "Each source should be a direct quote from the context, "
+            "as a substring of the original content"
+        ),
+    )
+
+    def _get_span(self, quote: str, context: str, errs: int = 100) -> Iterator[str]:
+        import regex
+
+        minor = quote
+        major = context
+
+        errs_ = 0
+        s = regex.search(f"({minor}){{e<={errs_}}}", major)
+        while s is None and errs_ <= errs:
+            errs_ += 1
+            s = regex.search(f"({minor}){{e<={errs_}}}", major)
+
+        if s is not None:
+            yield from s.spans()
+
+    def get_spans(self, context: str) -> Iterator[str]:
+        for quote in self.substring_quote:
+            yield from self._get_span(quote, context)
+
+
+class QuestionAnswer(BaseModel):
+    """A question and its answer as a list of facts each one should have a source.
+    each sentence contains a body and a list of sources."""
+
+    question: str = Field(..., description="Question that was asked")
+    answer: List[FactWithEvidence] = Field(
+        ...,
+        description=(
+            "Body of the answer, each fact should be "
+            "its separate object with a body and a list of sources"
+        ),
+    )
+
+
+def create_citation_fuzzy_match_chain(llm: BaseLanguageModel) -> LLMChain:
+    """Create a citation fuzzy match chain.
+
+    Args:
+        llm: Language model to use for the chain.
+
+    Returns:
+        Chain (LLMChain) that can be used to answer questions with citations.
+    """
+    output_parser = PydanticOutputFunctionsParser(pydantic_schema=QuestionAnswer)
+    schema = QuestionAnswer.schema()
+    function = {
+        "name": schema["title"],
+        "description": schema["description"],
+        "parameters": schema,
+    }
+    llm_kwargs = get_llm_kwargs(function)
+    messages = [
+        SystemMessage(
+            content=(
+                "You are a world class algorithm to answer "
+                "questions with correct and exact citations."
+            )
+        ),
+        HumanMessage(content="Answer question using the following context"),
+        HumanMessagePromptTemplate.from_template("{context}"),
+        HumanMessagePromptTemplate.from_template("Question: {question}"),
+        HumanMessage(
+            content=(
+                "Tips: Make sure to cite your sources, "
+                "and use the exact words from the context."
+            )
+        ),
+    ]
+    prompt = ChatPromptTemplate(messages=messages)  # type: ignore[arg-type, call-arg]
+
+    chain = LLMChain(
+        llm=llm,
+        prompt=prompt,
+        llm_kwargs=llm_kwargs,
+        output_parser=output_parser,
+    )
+    return chain
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/extraction.py b/llm/Lib/site-packages/langchain/chains/openai_functions/extraction.py
new file mode 100644
index 0000000000000000000000000000000000000000..a21a359bb2336ea07d28aa4e8a1f5c80aebedbdc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/openai_functions/extraction.py
@@ -0,0 +1,122 @@
+from typing import Any, List, Optional
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers.openai_functions import (
+    JsonKeyOutputFunctionsParser,
+    PydanticAttrOutputFunctionsParser,
+)
+from langchain_core.prompts import BasePromptTemplate, ChatPromptTemplate
+from langchain_core.pydantic_v1 import BaseModel
+
+from langchain.chains.base import Chain
+from langchain.chains.llm import LLMChain
+from langchain.chains.openai_functions.utils import (
+    _convert_schema,
+    _resolve_schema_references,
+    get_llm_kwargs,
+)
+
+
+def _get_extraction_function(entity_schema: dict) -> dict:
+    return {
+        "name": "information_extraction",
+        "description": "Extracts the relevant information from the passage.",
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "info": {"type": "array", "items": _convert_schema(entity_schema)}
+            },
+            "required": ["info"],
+        },
+    }
+
+
+_EXTRACTION_TEMPLATE = """Extract and save the relevant entities mentioned \
+in the following passage together with their properties.
+
+Only extract the properties mentioned in the 'information_extraction' function.
+
+If a property is not present and is not required in the function parameters, do not include it in the output.
+
+Passage:
+{input}
+"""  # noqa: E501
+
+
+def create_extraction_chain(
+    schema: dict,
+    llm: BaseLanguageModel,
+    prompt: Optional[BasePromptTemplate] = None,
+    tags: Optional[List[str]] = None,
+    verbose: bool = False,
+) -> Chain:
+    """Creates a chain that extracts information from a passage.
+
+    Args:
+        schema: The schema of the entities to extract.
+        llm: The language model to use.
+        prompt: The prompt to use for extraction.
+        verbose: Whether to run in verbose mode. In verbose mode, some intermediate
+            logs will be printed to the console. Defaults to the global `verbose` value,
+            accessible via `langchain.globals.get_verbose()`.
+
+    Returns:
+        Chain that can be used to extract information from a passage.
+    """
+    function = _get_extraction_function(schema)
+    extraction_prompt = prompt or ChatPromptTemplate.from_template(_EXTRACTION_TEMPLATE)
+    output_parser = JsonKeyOutputFunctionsParser(key_name="info")
+    llm_kwargs = get_llm_kwargs(function)
+    chain = LLMChain(
+        llm=llm,
+        prompt=extraction_prompt,
+        llm_kwargs=llm_kwargs,
+        output_parser=output_parser,
+        tags=tags,
+        verbose=verbose,
+    )
+    return chain
+
+
+def create_extraction_chain_pydantic(
+    pydantic_schema: Any,
+    llm: BaseLanguageModel,
+    prompt: Optional[BasePromptTemplate] = None,
+    verbose: bool = False,
+) -> Chain:
+    """Creates a chain that extracts information from a passage using pydantic schema.
+
+    Args:
+        pydantic_schema: The pydantic schema of the entities to extract.
+        llm: The language model to use.
+        prompt: The prompt to use for extraction.
+        verbose: Whether to run in verbose mode. In verbose mode, some intermediate
+            logs will be printed to the console. Defaults to the global `verbose` value,
+            accessible via `langchain.globals.get_verbose()`
+
+    Returns:
+        Chain that can be used to extract information from a passage.
+    """
+
+    class PydanticSchema(BaseModel):
+        info: List[pydantic_schema]  # type: ignore
+
+    openai_schema = pydantic_schema.schema()
+    openai_schema = _resolve_schema_references(
+        openai_schema, openai_schema.get("definitions", {})
+    )
+
+    function = _get_extraction_function(openai_schema)
+    extraction_prompt = prompt or ChatPromptTemplate.from_template(_EXTRACTION_TEMPLATE)
+    output_parser = PydanticAttrOutputFunctionsParser(
+        pydantic_schema=PydanticSchema, attr_name="info"
+    )
+    llm_kwargs = get_llm_kwargs(function)
+    chain = LLMChain(
+        llm=llm,
+        prompt=extraction_prompt,
+        llm_kwargs=llm_kwargs,
+        output_parser=output_parser,
+        verbose=verbose,
+    )
+    return chain
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/openapi.py b/llm/Lib/site-packages/langchain/chains/openai_functions/openapi.py
new file mode 100644
index 0000000000000000000000000000000000000000..681618815e1db6eff29bd3888159f9baafb06863
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/openai_functions/openapi.py
@@ -0,0 +1,302 @@
+from __future__ import annotations
+
+import json
+import re
+from collections import defaultdict
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, Tuple, Union
+
+import requests
+from langchain_community.chat_models import ChatOpenAI
+from langchain_community.utilities.openapi import OpenAPISpec
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers.openai_functions import JsonOutputFunctionsParser
+from langchain_core.prompts import BasePromptTemplate, ChatPromptTemplate
+from langchain_core.utils.input import get_colored_text
+from requests import Response
+
+from langchain.chains.base import Chain
+from langchain.chains.llm import LLMChain
+from langchain.chains.sequential import SequentialChain
+from langchain.tools import APIOperation
+
+if TYPE_CHECKING:
+    from openapi_pydantic import Parameter
+
+
+def _get_description(o: Any, prefer_short: bool) -> Optional[str]:
+    summary = getattr(o, "summary", None)
+    description = getattr(o, "description", None)
+    if prefer_short:
+        return summary or description
+    return description or summary
+
+
+def _format_url(url: str, path_params: dict) -> str:
+    expected_path_param = re.findall(r"{(.*?)}", url)
+    new_params = {}
+    for param in expected_path_param:
+        clean_param = param.lstrip(".;").rstrip("*")
+        val = path_params[clean_param]
+        if isinstance(val, list):
+            if param[0] == ".":
+                sep = "." if param[-1] == "*" else ","
+                new_val = "." + sep.join(val)
+            elif param[0] == ";":
+                sep = f"{clean_param}=" if param[-1] == "*" else ","
+                new_val = f"{clean_param}=" + sep.join(val)
+            else:
+                new_val = ",".join(val)
+        elif isinstance(val, dict):
+            kv_sep = "=" if param[-1] == "*" else ","
+            kv_strs = [kv_sep.join((k, v)) for k, v in val.items()]
+            if param[0] == ".":
+                sep = "."
+                new_val = "."
+            elif param[0] == ";":
+                sep = ";"
+                new_val = ";"
+            else:
+                sep = ","
+                new_val = ""
+            new_val += sep.join(kv_strs)
+        else:
+            if param[0] == ".":
+                new_val = f".{val}"
+            elif param[0] == ";":
+                new_val = f";{clean_param}={val}"
+            else:
+                new_val = val
+        new_params[param] = new_val
+    return url.format(**new_params)
+
+
+def _openapi_params_to_json_schema(params: List[Parameter], spec: OpenAPISpec) -> dict:
+    properties = {}
+    required = []
+    for p in params:
+        if p.param_schema:
+            schema = spec.get_schema(p.param_schema)
+        else:
+            media_type_schema = list(p.content.values())[0].media_type_schema  # type: ignore  # noqa: E501
+            schema = spec.get_schema(media_type_schema)
+        if p.description and not schema.description:
+            schema.description = p.description
+        properties[p.name] = json.loads(schema.json(exclude_none=True))
+        if p.required:
+            required.append(p.name)
+    return {"type": "object", "properties": properties, "required": required}
+
+
+def openapi_spec_to_openai_fn(
+    spec: OpenAPISpec,
+) -> Tuple[List[Dict[str, Any]], Callable]:
+    """Convert a valid OpenAPI spec to the JSON Schema format expected for OpenAI
+        functions.
+
+    Args:
+        spec: OpenAPI spec to convert.
+
+    Returns:
+        Tuple of the OpenAI functions JSON schema and a default function for executing
+            a request based on the OpenAI function schema.
+    """
+    if not spec.paths:
+        return [], lambda: None
+    functions = []
+    _name_to_call_map = {}
+    for path in spec.paths:
+        path_params = {
+            (p.name, p.param_in): p for p in spec.get_parameters_for_path(path)
+        }
+        for method in spec.get_methods_for_path(path):
+            request_args = {}
+            op = spec.get_operation(path, method)
+            op_params = path_params.copy()
+            for param in spec.get_parameters_for_operation(op):
+                op_params[(param.name, param.param_in)] = param
+            params_by_type = defaultdict(list)
+            for name_loc, p in op_params.items():
+                params_by_type[name_loc[1]].append(p)
+            param_loc_to_arg_name = {
+                "query": "params",
+                "header": "headers",
+                "cookie": "cookies",
+                "path": "path_params",
+            }
+            for param_loc, arg_name in param_loc_to_arg_name.items():
+                if params_by_type[param_loc]:
+                    request_args[arg_name] = _openapi_params_to_json_schema(
+                        params_by_type[param_loc], spec
+                    )
+            request_body = spec.get_request_body_for_operation(op)
+            # TODO: Support more MIME types.
+            if request_body and request_body.content:
+                media_types = {}
+                for media_type, media_type_object in request_body.content.items():
+                    if media_type_object.media_type_schema:
+                        schema = spec.get_schema(media_type_object.media_type_schema)
+                        media_types[media_type] = json.loads(
+                            schema.json(exclude_none=True)
+                        )
+                if len(media_types) == 1:
+                    media_type, schema_dict = list(media_types.items())[0]
+                    key = "json" if media_type == "application/json" else "data"
+                    request_args[key] = schema_dict
+                elif len(media_types) > 1:
+                    request_args["data"] = {"anyOf": list(media_types.values())}
+
+            api_op = APIOperation.from_openapi_spec(spec, path, method)
+            fn = {
+                "name": api_op.operation_id,
+                "description": api_op.description,
+                "parameters": {
+                    "type": "object",
+                    "properties": request_args,
+                },
+            }
+            functions.append(fn)
+            _name_to_call_map[fn["name"]] = {
+                "method": method,
+                "url": api_op.base_url + api_op.path,
+            }
+
+    def default_call_api(
+        name: str,
+        fn_args: dict,
+        headers: Optional[dict] = None,
+        params: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> Any:
+        method = _name_to_call_map[name]["method"]
+        url = _name_to_call_map[name]["url"]
+        path_params = fn_args.pop("path_params", {})
+        url = _format_url(url, path_params)
+        if "data" in fn_args and isinstance(fn_args["data"], dict):
+            fn_args["data"] = json.dumps(fn_args["data"])
+        _kwargs = {**fn_args, **kwargs}
+        if headers is not None:
+            if "headers" in _kwargs:
+                _kwargs["headers"].update(headers)
+            else:
+                _kwargs["headers"] = headers
+        if params is not None:
+            if "params" in _kwargs:
+                _kwargs["params"].update(params)
+            else:
+                _kwargs["params"] = params
+        return requests.request(method, url, **_kwargs)
+
+    return functions, default_call_api
+
+
+class SimpleRequestChain(Chain):
+    """Chain for making a simple request to an API endpoint."""
+
+    request_method: Callable
+    """Method to use for making the request."""
+    output_key: str = "response"
+    """Key to use for the output of the request."""
+    input_key: str = "function"
+    """Key to use for the input of the request."""
+
+    @property
+    def input_keys(self) -> List[str]:
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        return [self.output_key]
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Run the logic of this chain and return the output."""
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        name = inputs[self.input_key].pop("name")
+        args = inputs[self.input_key].pop("arguments")
+        _pretty_name = get_colored_text(name, "green")
+        _pretty_args = get_colored_text(json.dumps(args, indent=2), "green")
+        _text = f"Calling endpoint {_pretty_name} with arguments:\n" + _pretty_args
+        _run_manager.on_text(_text)
+        api_response: Response = self.request_method(name, args)
+        if api_response.status_code != 200:
+            response = (
+                f"{api_response.status_code}: {api_response.reason}"
+                + f"\nFor {name} "
+                + f"Called with args: {args.get('params','')}"
+            )
+        else:
+            try:
+                response = api_response.json()
+            except Exception:  # noqa: E722
+                response = api_response.text
+        return {self.output_key: response}
+
+
+def get_openapi_chain(
+    spec: Union[OpenAPISpec, str],
+    llm: Optional[BaseLanguageModel] = None,
+    prompt: Optional[BasePromptTemplate] = None,
+    request_chain: Optional[Chain] = None,
+    llm_chain_kwargs: Optional[Dict] = None,
+    verbose: bool = False,
+    headers: Optional[Dict] = None,
+    params: Optional[Dict] = None,
+    **kwargs: Any,
+) -> SequentialChain:
+    """Create a chain for querying an API from a OpenAPI spec.
+
+    Args:
+        spec: OpenAPISpec or url/file/text string corresponding to one.
+        llm: language model, should be an OpenAI function-calling model, e.g.
+            `ChatOpenAI(model="gpt-3.5-turbo-0613")`.
+        prompt: Main prompt template to use.
+        request_chain: Chain for taking the functions output and executing the request.
+    """
+    if isinstance(spec, str):
+        for conversion in (
+            OpenAPISpec.from_url,
+            OpenAPISpec.from_file,
+            OpenAPISpec.from_text,
+        ):
+            try:
+                spec = conversion(spec)  # type: ignore[arg-type]
+                break
+            except ImportError as e:
+                raise e
+            except Exception:  # noqa: E722
+                pass
+        if isinstance(spec, str):
+            raise ValueError(f"Unable to parse spec from source {spec}")
+    openai_fns, call_api_fn = openapi_spec_to_openai_fn(spec)
+    llm = llm or ChatOpenAI(
+        model="gpt-3.5-turbo-0613",
+    )
+    prompt = prompt or ChatPromptTemplate.from_template(
+        "Use the provided API's to respond to this user query:\n\n{query}"
+    )
+    llm_chain = LLMChain(
+        llm=llm,
+        prompt=prompt,
+        llm_kwargs={"functions": openai_fns},
+        output_parser=JsonOutputFunctionsParser(args_only=False),
+        output_key="function",
+        verbose=verbose,
+        **(llm_chain_kwargs or {}),
+    )
+    request_chain = request_chain or SimpleRequestChain(
+        request_method=lambda name, args: call_api_fn(
+            name, args, headers=headers, params=params
+        ),
+        verbose=verbose,
+    )
+    return SequentialChain(
+        chains=[llm_chain, request_chain],
+        input_variables=llm_chain.input_keys,
+        output_variables=["response"],
+        verbose=verbose,
+        **kwargs,
+    )
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/qa_with_structure.py b/llm/Lib/site-packages/langchain/chains/openai_functions/qa_with_structure.py
new file mode 100644
index 0000000000000000000000000000000000000000..7f39e4dd5d74ebabb1d2cfd70a5b2a67c393a085
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/openai_functions/qa_with_structure.py
@@ -0,0 +1,112 @@
+from typing import Any, List, Optional, Type, Union
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.messages import HumanMessage, SystemMessage
+from langchain_core.output_parsers import BaseLLMOutputParser
+from langchain_core.output_parsers.openai_functions import (
+    OutputFunctionsParser,
+    PydanticOutputFunctionsParser,
+)
+from langchain_core.prompts import PromptTemplate
+from langchain_core.prompts.chat import ChatPromptTemplate, HumanMessagePromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain.chains.llm import LLMChain
+from langchain.chains.openai_functions.utils import get_llm_kwargs
+
+
+class AnswerWithSources(BaseModel):
+    """An answer to the question, with sources."""
+
+    answer: str = Field(..., description="Answer to the question that was asked")
+    sources: List[str] = Field(
+        ..., description="List of sources used to answer the question"
+    )
+
+
+def create_qa_with_structure_chain(
+    llm: BaseLanguageModel,
+    schema: Union[dict, Type[BaseModel]],
+    output_parser: str = "base",
+    prompt: Optional[Union[PromptTemplate, ChatPromptTemplate]] = None,
+    verbose: bool = False,
+) -> LLMChain:
+    """Create a question answering chain that returns an answer with sources
+     based on schema.
+
+    Args:
+        llm: Language model to use for the chain.
+        schema: Pydantic schema to use for the output.
+        output_parser: Output parser to use. Should be one of `pydantic` or `base`.
+            Default to `base`.
+        prompt: Optional prompt to use for the chain.
+
+    Returns:
+
+    """
+    if output_parser == "pydantic":
+        if not (isinstance(schema, type) and issubclass(schema, BaseModel)):
+            raise ValueError(
+                "Must provide a pydantic class for schema when output_parser is "
+                "'pydantic'."
+            )
+        _output_parser: BaseLLMOutputParser = PydanticOutputFunctionsParser(
+            pydantic_schema=schema
+        )
+    elif output_parser == "base":
+        _output_parser = OutputFunctionsParser()
+    else:
+        raise ValueError(
+            f"Got unexpected output_parser: {output_parser}. "
+            f"Should be one of `pydantic` or `base`."
+        )
+    if isinstance(schema, type) and issubclass(schema, BaseModel):
+        schema_dict = schema.schema()
+    else:
+        schema_dict = schema
+    function = {
+        "name": schema_dict["title"],
+        "description": schema_dict["description"],
+        "parameters": schema_dict,
+    }
+    llm_kwargs = get_llm_kwargs(function)
+    messages = [
+        SystemMessage(
+            content=(
+                "You are a world class algorithm to answer "
+                "questions in a specific format."
+            )
+        ),
+        HumanMessage(content="Answer question using the following context"),
+        HumanMessagePromptTemplate.from_template("{context}"),
+        HumanMessagePromptTemplate.from_template("Question: {question}"),
+        HumanMessage(content="Tips: Make sure to answer in the correct format"),
+    ]
+    prompt = prompt or ChatPromptTemplate(messages=messages)  # type: ignore[arg-type, call-arg]
+
+    chain = LLMChain(
+        llm=llm,
+        prompt=prompt,
+        llm_kwargs=llm_kwargs,
+        output_parser=_output_parser,
+        verbose=verbose,
+    )
+    return chain
+
+
+def create_qa_with_sources_chain(
+    llm: BaseLanguageModel, verbose: bool = False, **kwargs: Any
+) -> LLMChain:
+    """Create a question answering chain that returns an answer with sources.
+
+    Args:
+        llm: Language model to use for the chain.
+        verbose: Whether to print the details of the chain
+        **kwargs: Keyword arguments to pass to `create_qa_with_structure_chain`.
+
+    Returns:
+        Chain (LLMChain) that can be used to answer questions with citations.
+    """
+    return create_qa_with_structure_chain(
+        llm, AnswerWithSources, verbose=verbose, **kwargs
+    )
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/tagging.py b/llm/Lib/site-packages/langchain/chains/openai_functions/tagging.py
new file mode 100644
index 0000000000000000000000000000000000000000..6cc965f9519c42540a5d1364c4cd9bcd95fb300e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/openai_functions/tagging.py
@@ -0,0 +1,90 @@
+from typing import Any, Optional
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers.openai_functions import (
+    JsonOutputFunctionsParser,
+    PydanticOutputFunctionsParser,
+)
+from langchain_core.prompts import ChatPromptTemplate
+
+from langchain.chains.base import Chain
+from langchain.chains.llm import LLMChain
+from langchain.chains.openai_functions.utils import _convert_schema, get_llm_kwargs
+
+
+def _get_tagging_function(schema: dict) -> dict:
+    return {
+        "name": "information_extraction",
+        "description": "Extracts the relevant information from the passage.",
+        "parameters": _convert_schema(schema),
+    }
+
+
+_TAGGING_TEMPLATE = """Extract the desired information from the following passage.
+
+Only extract the properties mentioned in the 'information_extraction' function.
+
+Passage:
+{input}
+"""
+
+
+def create_tagging_chain(
+    schema: dict,
+    llm: BaseLanguageModel,
+    prompt: Optional[ChatPromptTemplate] = None,
+    **kwargs: Any,
+) -> Chain:
+    """Creates a chain that extracts information from a passage
+     based on a schema.
+
+    Args:
+        schema: The schema of the entities to extract.
+        llm: The language model to use.
+
+    Returns:
+        Chain (LLMChain) that can be used to extract information from a passage.
+    """
+    function = _get_tagging_function(schema)
+    prompt = prompt or ChatPromptTemplate.from_template(_TAGGING_TEMPLATE)
+    output_parser = JsonOutputFunctionsParser()
+    llm_kwargs = get_llm_kwargs(function)
+    chain = LLMChain(
+        llm=llm,
+        prompt=prompt,
+        llm_kwargs=llm_kwargs,
+        output_parser=output_parser,
+        **kwargs,
+    )
+    return chain
+
+
+def create_tagging_chain_pydantic(
+    pydantic_schema: Any,
+    llm: BaseLanguageModel,
+    prompt: Optional[ChatPromptTemplate] = None,
+    **kwargs: Any,
+) -> Chain:
+    """Creates a chain that extracts information from a passage
+     based on a pydantic schema.
+
+    Args:
+        pydantic_schema: The pydantic schema of the entities to extract.
+        llm: The language model to use.
+
+    Returns:
+        Chain (LLMChain) that can be used to extract information from a passage.
+    """
+    openai_schema = pydantic_schema.schema()
+    function = _get_tagging_function(openai_schema)
+    prompt = prompt or ChatPromptTemplate.from_template(_TAGGING_TEMPLATE)
+    output_parser = PydanticOutputFunctionsParser(pydantic_schema=pydantic_schema)
+    llm_kwargs = get_llm_kwargs(function)
+    chain = LLMChain(
+        llm=llm,
+        prompt=prompt,
+        llm_kwargs=llm_kwargs,
+        output_parser=output_parser,
+        **kwargs,
+    )
+    return chain
diff --git a/llm/Lib/site-packages/langchain/chains/openai_functions/utils.py b/llm/Lib/site-packages/langchain/chains/openai_functions/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..69f08b119c1c883cb0b9449a8edc8af8088c7c34
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/openai_functions/utils.py
@@ -0,0 +1,40 @@
+from typing import Any, Dict
+
+
+def _resolve_schema_references(schema: Any, definitions: Dict[str, Any]) -> Any:
+    """
+    Resolves the $ref keys in a JSON schema object using the provided definitions.
+    """
+    if isinstance(schema, list):
+        for i, item in enumerate(schema):
+            schema[i] = _resolve_schema_references(item, definitions)
+    elif isinstance(schema, dict):
+        if "$ref" in schema:
+            ref_key = schema.pop("$ref").split("/")[-1]
+            ref = definitions.get(ref_key, {})
+            schema.update(ref)
+        else:
+            for key, value in schema.items():
+                schema[key] = _resolve_schema_references(value, definitions)
+    return schema
+
+
+def _convert_schema(schema: dict) -> dict:
+    props = {k: {"title": k, **v} for k, v in schema["properties"].items()}
+    return {
+        "type": "object",
+        "properties": props,
+        "required": schema.get("required", []),
+    }
+
+
+def get_llm_kwargs(function: dict) -> dict:
+    """Returns the kwargs for the LLMChain constructor.
+
+    Args:
+        function: The function to use.
+
+    Returns:
+        The kwargs for the LLMChain constructor.
+    """
+    return {"functions": [function], "function_call": {"name": function["name"]}}
diff --git a/llm/Lib/site-packages/langchain/chains/openai_tools/__init__.py b/llm/Lib/site-packages/langchain/chains/openai_tools/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5388b7d53b48738a26b888fc5667fd2c759b4e01
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/openai_tools/__init__.py
@@ -0,0 +1,3 @@
+from langchain.chains.openai_tools.extraction import create_extraction_chain_pydantic
+
+__all__ = ["create_extraction_chain_pydantic"]
diff --git a/llm/Lib/site-packages/langchain/chains/openai_tools/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/openai_tools/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8db53794e197c73208df4ade8195db1b58996efa
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/openai_tools/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/openai_tools/__pycache__/extraction.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/openai_tools/__pycache__/extraction.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..779429a89d0b6ba9150822377e1b3ea369419955
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/openai_tools/__pycache__/extraction.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/openai_tools/extraction.py b/llm/Lib/site-packages/langchain/chains/openai_tools/extraction.py
new file mode 100644
index 0000000000000000000000000000000000000000..eda3e4bd59f09ec48254ae77745bf3c11d8157da
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/openai_tools/extraction.py
@@ -0,0 +1,41 @@
+from typing import List, Type, Union
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import ChatPromptTemplate
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.runnables import Runnable
+from langchain_core.utils.function_calling import convert_pydantic_to_openai_function
+
+from langchain.output_parsers import PydanticToolsParser
+
+_EXTRACTION_TEMPLATE = """Extract and save the relevant entities mentioned \
+in the following passage together with their properties.
+
+If a property is not present and is not required in the function parameters, do not include it in the output."""  # noqa: E501
+
+
+def create_extraction_chain_pydantic(
+    pydantic_schemas: Union[List[Type[BaseModel]], Type[BaseModel]],
+    llm: BaseLanguageModel,
+    system_message: str = _EXTRACTION_TEMPLATE,
+) -> Runnable:
+    """Creates a chain that extracts information from a passage.
+
+    Args:
+        pydantic_schemas: The schema of the entities to extract.
+        llm: The language model to use.
+        system_message: The system message to use for extraction.
+
+    Returns:
+        A runnable that extracts information from a passage.
+    """
+    if not isinstance(pydantic_schemas, list):
+        pydantic_schemas = [pydantic_schemas]
+    prompt = ChatPromptTemplate.from_messages(
+        [("system", system_message), ("user", "{input}")]
+    )
+    functions = [convert_pydantic_to_openai_function(p) for p in pydantic_schemas]
+    tools = [{"type": "function", "function": d} for d in functions]
+    model = llm.bind(tools=tools)
+    chain = prompt | model | PydanticToolsParser(tools=pydantic_schemas)
+    return chain
diff --git a/llm/Lib/site-packages/langchain/chains/prompt_selector.py b/llm/Lib/site-packages/langchain/chains/prompt_selector.py
new file mode 100644
index 0000000000000000000000000000000000000000..453e2ea03577f1062648e9e7b6237830cd54ae0c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/prompt_selector.py
@@ -0,0 +1,65 @@
+from abc import ABC, abstractmethod
+from typing import Callable, List, Tuple
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.language_models.llms import BaseLLM
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+
+class BasePromptSelector(BaseModel, ABC):
+    """Base class for prompt selectors."""
+
+    @abstractmethod
+    def get_prompt(self, llm: BaseLanguageModel) -> BasePromptTemplate:
+        """Get default prompt for a language model."""
+
+
+class ConditionalPromptSelector(BasePromptSelector):
+    """Prompt collection that goes through conditionals."""
+
+    default_prompt: BasePromptTemplate
+    """Default prompt to use if no conditionals match."""
+    conditionals: List[
+        Tuple[Callable[[BaseLanguageModel], bool], BasePromptTemplate]
+    ] = Field(default_factory=list)
+    """List of conditionals and prompts to use if the conditionals match."""
+
+    def get_prompt(self, llm: BaseLanguageModel) -> BasePromptTemplate:
+        """Get default prompt for a language model.
+
+        Args:
+            llm: Language model to get prompt for.
+
+        Returns:
+            Prompt to use for the language model.
+        """
+        for condition, prompt in self.conditionals:
+            if condition(llm):
+                return prompt
+        return self.default_prompt
+
+
+def is_llm(llm: BaseLanguageModel) -> bool:
+    """Check if the language model is a LLM.
+
+    Args:
+        llm: Language model to check.
+
+    Returns:
+        True if the language model is a BaseLLM model, False otherwise.
+    """
+    return isinstance(llm, BaseLLM)
+
+
+def is_chat_model(llm: BaseLanguageModel) -> bool:
+    """Check if the language model is a chat model.
+
+    Args:
+        llm: Language model to check.
+
+    Returns:
+        True if the language model is a BaseChatModel model, False otherwise.
+    """
+    return isinstance(llm, BaseChatModel)
diff --git a/llm/Lib/site-packages/langchain/chains/qa_generation/__init__.py b/llm/Lib/site-packages/langchain/chains/qa_generation/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/chains/qa_generation/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/qa_generation/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5caa14e3d625e17aaaed395bcbddd9eb76f22974
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/qa_generation/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/qa_generation/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/qa_generation/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..55d6b6bae93c4a6f5240a68e23dc1bfa78939b9b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/qa_generation/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/qa_generation/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/qa_generation/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..284e204264b038e443591419710640ffcc24e32e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/qa_generation/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/qa_generation/base.py b/llm/Lib/site-packages/langchain/chains/qa_generation/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..bdc3444cf700e100cdc9cf3ecb11b0f99813fc74
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/qa_generation/base.py
@@ -0,0 +1,77 @@
+from __future__ import annotations
+
+import json
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForChainRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+from langchain_text_splitters import RecursiveCharacterTextSplitter, TextSplitter
+
+from langchain.chains.base import Chain
+from langchain.chains.llm import LLMChain
+from langchain.chains.qa_generation.prompt import PROMPT_SELECTOR
+
+
+class QAGenerationChain(Chain):
+    """Base class for question-answer generation chains."""
+
+    llm_chain: LLMChain
+    """LLM Chain that generates responses from user input and context."""
+    text_splitter: TextSplitter = Field(
+        default=RecursiveCharacterTextSplitter(chunk_overlap=500)
+    )
+    """Text splitter that splits the input into chunks."""
+    input_key: str = "text"
+    """Key of the input to the chain."""
+    output_key: str = "questions"
+    """Key of the output of the chain."""
+    k: Optional[int] = None
+    """Number of questions to generate."""
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        prompt: Optional[BasePromptTemplate] = None,
+        **kwargs: Any,
+    ) -> QAGenerationChain:
+        """
+        Create a QAGenerationChain from a language model.
+
+        Args:
+            llm: a language model
+            prompt: a prompt template
+            **kwargs: additional arguments
+
+        Returns:
+            a QAGenerationChain class
+        """
+        _prompt = prompt or PROMPT_SELECTOR.get_prompt(llm)
+        chain = LLMChain(llm=llm, prompt=_prompt)
+        return cls(llm_chain=chain, **kwargs)
+
+    @property
+    def _chain_type(self) -> str:
+        raise NotImplementedError
+
+    @property
+    def input_keys(self) -> List[str]:
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        return [self.output_key]
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, List]:
+        docs = self.text_splitter.create_documents([inputs[self.input_key]])
+        results = self.llm_chain.generate(
+            [{"text": d.page_content} for d in docs], run_manager=run_manager
+        )
+        qa = [json.loads(res[0].text) for res in results.generations]
+        return {self.output_key: qa}
diff --git a/llm/Lib/site-packages/langchain/chains/qa_generation/prompt.py b/llm/Lib/site-packages/langchain/chains/qa_generation/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..377a49e4c9bcdf5ec18de2fe253238f372a8f4c7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/qa_generation/prompt.py
@@ -0,0 +1,50 @@
+# flake8: noqa
+from langchain.chains.prompt_selector import ConditionalPromptSelector, is_chat_model
+from langchain_core.prompts.chat import (
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+    SystemMessagePromptTemplate,
+)
+from langchain_core.prompts.prompt import PromptTemplate
+
+templ1 = """You are a smart assistant designed to help high school teachers come up with reading comprehension questions.
+Given a piece of text, you must come up with a question and answer pair that can be used to test a student's reading comprehension abilities.
+When coming up with this question/answer pair, you must respond in the following format:
+```
+{{
+    "question": "$YOUR_QUESTION_HERE",
+    "answer": "$THE_ANSWER_HERE"
+}}
+```
+
+Everything between the ``` must be valid json.
+"""
+templ2 = """Please come up with a question/answer pair, in the specified JSON format, for the following text:
+----------------
+{text}"""
+CHAT_PROMPT = ChatPromptTemplate.from_messages(
+    [
+        SystemMessagePromptTemplate.from_template(templ1),
+        HumanMessagePromptTemplate.from_template(templ2),
+    ]
+)
+templ = """You are a smart assistant designed to help high school teachers come up with reading comprehension questions.
+Given a piece of text, you must come up with a question and answer pair that can be used to test a student's reading comprehension abilities.
+When coming up with this question/answer pair, you must respond in the following format:
+```
+{{
+    "question": "$YOUR_QUESTION_HERE",
+    "answer": "$THE_ANSWER_HERE"
+}}
+```
+
+Everything between the ``` must be valid json.
+
+Please come up with a question/answer pair, in the specified JSON format, for the following text:
+----------------
+{text}"""
+PROMPT = PromptTemplate.from_template(templ)
+
+PROMPT_SELECTOR = ConditionalPromptSelector(
+    default_prompt=PROMPT, conditionals=[(is_chat_model, CHAT_PROMPT)]
+)
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/__init__.py b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b1d18e832a33c4c4c40a81429dca889410a9bf19
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__init__.py
@@ -0,0 +1,4 @@
+"""Load question answering with sources chains."""
+from langchain.chains.qa_with_sources.loading import load_qa_with_sources_chain
+
+__all__ = ["load_qa_with_sources_chain"]
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8344dbfbe5f4cf9182ca4097fe6f66b8ad0dc287
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..48ff6a7388b22213601092ab4d54cd6874e3e81f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/loading.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/loading.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8c726dac7bf6a232c2558769534d32c499b35e72
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/loading.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/map_reduce_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/map_reduce_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..721243c38d50c0eb66e2b8ec43bf018d943d312c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/map_reduce_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/refine_prompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/refine_prompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1ecb0c302d8fb8ea904afc1b9a03148676d7278c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/refine_prompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/retrieval.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/retrieval.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c8b3c2b960f6b91f42de847ed20925993e88635f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/retrieval.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/stuff_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/stuff_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d2c62719a8ded66499becdec71591641f6cad0b4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/stuff_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/vector_db.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/vector_db.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0463eeec694de98a24ee21ca32f1776b9dbd6ef0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/qa_with_sources/__pycache__/vector_db.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/base.py b/llm/Lib/site-packages/langchain/chains/qa_with_sources/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..ea444896dafc4d40e62d8b7a50fc8096b774ad3e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/qa_with_sources/base.py
@@ -0,0 +1,236 @@
+"""Question answering with sources over documents."""
+
+from __future__ import annotations
+
+import inspect
+import re
+from abc import ABC, abstractmethod
+from typing import Any, Dict, List, Optional, Tuple
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+)
+from langchain_core.documents import Document
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Extra, root_validator
+
+from langchain.chains import ReduceDocumentsChain
+from langchain.chains.base import Chain
+from langchain.chains.combine_documents.base import BaseCombineDocumentsChain
+from langchain.chains.combine_documents.map_reduce import MapReduceDocumentsChain
+from langchain.chains.combine_documents.stuff import StuffDocumentsChain
+from langchain.chains.llm import LLMChain
+from langchain.chains.qa_with_sources.loading import load_qa_with_sources_chain
+from langchain.chains.qa_with_sources.map_reduce_prompt import (
+    COMBINE_PROMPT,
+    EXAMPLE_PROMPT,
+    QUESTION_PROMPT,
+)
+
+
+class BaseQAWithSourcesChain(Chain, ABC):
+    """Question answering chain with sources over documents."""
+
+    combine_documents_chain: BaseCombineDocumentsChain
+    """Chain to use to combine documents."""
+    question_key: str = "question"  #: :meta private:
+    input_docs_key: str = "docs"  #: :meta private:
+    answer_key: str = "answer"  #: :meta private:
+    sources_answer_key: str = "sources"  #: :meta private:
+    return_source_documents: bool = False
+    """Return the source documents."""
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        document_prompt: BasePromptTemplate = EXAMPLE_PROMPT,
+        question_prompt: BasePromptTemplate = QUESTION_PROMPT,
+        combine_prompt: BasePromptTemplate = COMBINE_PROMPT,
+        **kwargs: Any,
+    ) -> BaseQAWithSourcesChain:
+        """Construct the chain from an LLM."""
+        llm_question_chain = LLMChain(llm=llm, prompt=question_prompt)
+        llm_combine_chain = LLMChain(llm=llm, prompt=combine_prompt)
+        combine_results_chain = StuffDocumentsChain(
+            llm_chain=llm_combine_chain,
+            document_prompt=document_prompt,
+            document_variable_name="summaries",
+        )
+        reduce_documents_chain = ReduceDocumentsChain(  # type: ignore[misc]
+            combine_documents_chain=combine_results_chain
+        )
+        combine_documents_chain = MapReduceDocumentsChain(
+            llm_chain=llm_question_chain,
+            reduce_documents_chain=reduce_documents_chain,
+            document_variable_name="context",
+        )
+        return cls(
+            combine_documents_chain=combine_documents_chain,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_chain_type(
+        cls,
+        llm: BaseLanguageModel,
+        chain_type: str = "stuff",
+        chain_type_kwargs: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> BaseQAWithSourcesChain:
+        """Load chain from chain type."""
+        _chain_kwargs = chain_type_kwargs or {}
+        combine_documents_chain = load_qa_with_sources_chain(
+            llm, chain_type=chain_type, **_chain_kwargs
+        )
+        return cls(combine_documents_chain=combine_documents_chain, **kwargs)
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Expect input key.
+
+        :meta private:
+        """
+        return [self.question_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return output key.
+
+        :meta private:
+        """
+        _output_keys = [self.answer_key, self.sources_answer_key]
+        if self.return_source_documents:
+            _output_keys = _output_keys + ["source_documents"]
+        return _output_keys
+
+    @root_validator(pre=True)
+    def validate_naming(cls, values: Dict) -> Dict:
+        """Fix backwards compatibility in naming."""
+        if "combine_document_chain" in values:
+            values["combine_documents_chain"] = values.pop("combine_document_chain")
+        return values
+
+    def _split_sources(self, answer: str) -> Tuple[str, str]:
+        """Split sources from answer."""
+        if re.search(r"SOURCES?:", answer, re.IGNORECASE):
+            answer, sources = re.split(
+                r"SOURCES?:|QUESTION:\s", answer, flags=re.IGNORECASE
+            )[:2]
+            sources = re.split(r"\n", sources)[0].strip()
+        else:
+            sources = ""
+        return answer, sources
+
+    @abstractmethod
+    def _get_docs(
+        self,
+        inputs: Dict[str, Any],
+        *,
+        run_manager: CallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs to run questioning over."""
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        accepts_run_manager = (
+            "run_manager" in inspect.signature(self._get_docs).parameters
+        )
+        if accepts_run_manager:
+            docs = self._get_docs(inputs, run_manager=_run_manager)
+        else:
+            docs = self._get_docs(inputs)  # type: ignore[call-arg]
+
+        answer = self.combine_documents_chain.run(
+            input_documents=docs, callbacks=_run_manager.get_child(), **inputs
+        )
+        answer, sources = self._split_sources(answer)
+        result: Dict[str, Any] = {
+            self.answer_key: answer,
+            self.sources_answer_key: sources,
+        }
+        if self.return_source_documents:
+            result["source_documents"] = docs
+        return result
+
+    @abstractmethod
+    async def _aget_docs(
+        self,
+        inputs: Dict[str, Any],
+        *,
+        run_manager: AsyncCallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs to run questioning over."""
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        _run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()
+        accepts_run_manager = (
+            "run_manager" in inspect.signature(self._aget_docs).parameters
+        )
+        if accepts_run_manager:
+            docs = await self._aget_docs(inputs, run_manager=_run_manager)
+        else:
+            docs = await self._aget_docs(inputs)  # type: ignore[call-arg]
+        answer = await self.combine_documents_chain.arun(
+            input_documents=docs, callbacks=_run_manager.get_child(), **inputs
+        )
+        answer, sources = self._split_sources(answer)
+        result: Dict[str, Any] = {
+            self.answer_key: answer,
+            self.sources_answer_key: sources,
+        }
+        if self.return_source_documents:
+            result["source_documents"] = docs
+        return result
+
+
+class QAWithSourcesChain(BaseQAWithSourcesChain):
+    """Question answering with sources over documents."""
+
+    input_docs_key: str = "docs"  #: :meta private:
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Expect input key.
+
+        :meta private:
+        """
+        return [self.input_docs_key, self.question_key]
+
+    def _get_docs(
+        self,
+        inputs: Dict[str, Any],
+        *,
+        run_manager: CallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs to run questioning over."""
+        return inputs.pop(self.input_docs_key)
+
+    async def _aget_docs(
+        self,
+        inputs: Dict[str, Any],
+        *,
+        run_manager: AsyncCallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs to run questioning over."""
+        return inputs.pop(self.input_docs_key)
+
+    @property
+    def _chain_type(self) -> str:
+        return "qa_with_sources_chain"
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/loading.py b/llm/Lib/site-packages/langchain/chains/qa_with_sources/loading.py
new file mode 100644
index 0000000000000000000000000000000000000000..0957d8012ad7d76fe453d20a238eea3553904ab7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/qa_with_sources/loading.py
@@ -0,0 +1,183 @@
+"""Load question answering with sources chains."""
+from __future__ import annotations
+
+from typing import Any, Mapping, Optional, Protocol
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+
+from langchain.chains.combine_documents.base import BaseCombineDocumentsChain
+from langchain.chains.combine_documents.map_reduce import MapReduceDocumentsChain
+from langchain.chains.combine_documents.map_rerank import MapRerankDocumentsChain
+from langchain.chains.combine_documents.reduce import ReduceDocumentsChain
+from langchain.chains.combine_documents.refine import RefineDocumentsChain
+from langchain.chains.combine_documents.stuff import StuffDocumentsChain
+from langchain.chains.llm import LLMChain
+from langchain.chains.qa_with_sources import (
+    map_reduce_prompt,
+    refine_prompts,
+    stuff_prompt,
+)
+from langchain.chains.question_answering.map_rerank_prompt import (
+    PROMPT as MAP_RERANK_PROMPT,
+)
+
+
+class LoadingCallable(Protocol):
+    """Interface for loading the combine documents chain."""
+
+    def __call__(
+        self, llm: BaseLanguageModel, **kwargs: Any
+    ) -> BaseCombineDocumentsChain:
+        """Callable to load the combine documents chain."""
+
+
+def _load_map_rerank_chain(
+    llm: BaseLanguageModel,
+    prompt: BasePromptTemplate = MAP_RERANK_PROMPT,
+    verbose: bool = False,
+    document_variable_name: str = "context",
+    rank_key: str = "score",
+    answer_key: str = "answer",
+    **kwargs: Any,
+) -> MapRerankDocumentsChain:
+    llm_chain = LLMChain(llm=llm, prompt=prompt, verbose=verbose)
+    return MapRerankDocumentsChain(
+        llm_chain=llm_chain,
+        rank_key=rank_key,
+        answer_key=answer_key,
+        document_variable_name=document_variable_name,
+        **kwargs,
+    )
+
+
+def _load_stuff_chain(
+    llm: BaseLanguageModel,
+    prompt: BasePromptTemplate = stuff_prompt.PROMPT,
+    document_prompt: BasePromptTemplate = stuff_prompt.EXAMPLE_PROMPT,
+    document_variable_name: str = "summaries",
+    verbose: Optional[bool] = None,
+    **kwargs: Any,
+) -> StuffDocumentsChain:
+    llm_chain = LLMChain(llm=llm, prompt=prompt, verbose=verbose)  # type: ignore[arg-type]
+    return StuffDocumentsChain(
+        llm_chain=llm_chain,
+        document_variable_name=document_variable_name,
+        document_prompt=document_prompt,
+        verbose=verbose,  # type: ignore[arg-type]
+        **kwargs,
+    )
+
+
+def _load_map_reduce_chain(
+    llm: BaseLanguageModel,
+    question_prompt: BasePromptTemplate = map_reduce_prompt.QUESTION_PROMPT,
+    combine_prompt: BasePromptTemplate = map_reduce_prompt.COMBINE_PROMPT,
+    document_prompt: BasePromptTemplate = map_reduce_prompt.EXAMPLE_PROMPT,
+    combine_document_variable_name: str = "summaries",
+    map_reduce_document_variable_name: str = "context",
+    collapse_prompt: Optional[BasePromptTemplate] = None,
+    reduce_llm: Optional[BaseLanguageModel] = None,
+    collapse_llm: Optional[BaseLanguageModel] = None,
+    verbose: Optional[bool] = None,
+    token_max: int = 3000,
+    **kwargs: Any,
+) -> MapReduceDocumentsChain:
+    map_chain = LLMChain(llm=llm, prompt=question_prompt, verbose=verbose)  # type: ignore[arg-type]
+    _reduce_llm = reduce_llm or llm
+    reduce_chain = LLMChain(llm=_reduce_llm, prompt=combine_prompt, verbose=verbose)  # type: ignore[arg-type]
+    combine_documents_chain = StuffDocumentsChain(
+        llm_chain=reduce_chain,
+        document_variable_name=combine_document_variable_name,
+        document_prompt=document_prompt,
+        verbose=verbose,  # type: ignore[arg-type]
+    )
+    if collapse_prompt is None:
+        collapse_chain = None
+        if collapse_llm is not None:
+            raise ValueError(
+                "collapse_llm provided, but collapse_prompt was not: please "
+                "provide one or stop providing collapse_llm."
+            )
+    else:
+        _collapse_llm = collapse_llm or llm
+        collapse_chain = StuffDocumentsChain(
+            llm_chain=LLMChain(
+                llm=_collapse_llm,
+                prompt=collapse_prompt,
+                verbose=verbose,  # type: ignore[arg-type]
+            ),
+            document_variable_name=combine_document_variable_name,
+            document_prompt=document_prompt,
+        )
+    reduce_documents_chain = ReduceDocumentsChain(
+        combine_documents_chain=combine_documents_chain,
+        collapse_documents_chain=collapse_chain,
+        token_max=token_max,
+        verbose=verbose,  # type: ignore[arg-type]
+    )
+    return MapReduceDocumentsChain(
+        llm_chain=map_chain,
+        reduce_documents_chain=reduce_documents_chain,
+        document_variable_name=map_reduce_document_variable_name,
+        verbose=verbose,  # type: ignore[arg-type]
+        **kwargs,
+    )
+
+
+def _load_refine_chain(
+    llm: BaseLanguageModel,
+    question_prompt: BasePromptTemplate = refine_prompts.DEFAULT_TEXT_QA_PROMPT,
+    refine_prompt: BasePromptTemplate = refine_prompts.DEFAULT_REFINE_PROMPT,
+    document_prompt: BasePromptTemplate = refine_prompts.EXAMPLE_PROMPT,
+    document_variable_name: str = "context_str",
+    initial_response_name: str = "existing_answer",
+    refine_llm: Optional[BaseLanguageModel] = None,
+    verbose: Optional[bool] = None,
+    **kwargs: Any,
+) -> RefineDocumentsChain:
+    initial_chain = LLMChain(llm=llm, prompt=question_prompt, verbose=verbose)  # type: ignore[arg-type]
+    _refine_llm = refine_llm or llm
+    refine_chain = LLMChain(llm=_refine_llm, prompt=refine_prompt, verbose=verbose)  # type: ignore[arg-type]
+    return RefineDocumentsChain(
+        initial_llm_chain=initial_chain,
+        refine_llm_chain=refine_chain,
+        document_variable_name=document_variable_name,
+        initial_response_name=initial_response_name,
+        document_prompt=document_prompt,
+        verbose=verbose,  # type: ignore[arg-type]
+        **kwargs,
+    )
+
+
+def load_qa_with_sources_chain(
+    llm: BaseLanguageModel,
+    chain_type: str = "stuff",
+    verbose: Optional[bool] = None,
+    **kwargs: Any,
+) -> BaseCombineDocumentsChain:
+    """Load a question answering with sources chain.
+
+    Args:
+        llm: Language Model to use in the chain.
+        chain_type: Type of document combining chain to use. Should be one of "stuff",
+            "map_reduce", "refine" and "map_rerank".
+        verbose: Whether chains should be run in verbose mode or not. Note that this
+            applies to all chains that make up the final chain.
+
+    Returns:
+        A chain to use for question answering with sources.
+    """
+    loader_mapping: Mapping[str, LoadingCallable] = {
+        "stuff": _load_stuff_chain,
+        "map_reduce": _load_map_reduce_chain,
+        "refine": _load_refine_chain,
+        "map_rerank": _load_map_rerank_chain,
+    }
+    if chain_type not in loader_mapping:
+        raise ValueError(
+            f"Got unsupported chain type: {chain_type}. "
+            f"Should be one of {loader_mapping.keys()}"
+        )
+    _func: LoadingCallable = loader_mapping[chain_type]
+    return _func(llm, verbose=verbose, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/map_reduce_prompt.py b/llm/Lib/site-packages/langchain/chains/qa_with_sources/map_reduce_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..e0c8545e7047bba53751b27b9bf93708dc1f5e44
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/qa_with_sources/map_reduce_prompt.py
@@ -0,0 +1,55 @@
+# flake8: noqa
+from langchain_core.prompts import PromptTemplate
+
+question_prompt_template = """Use the following portion of a long document to see if any of the text is relevant to answer the question. 
+Return any relevant text verbatim.
+{context}
+Question: {question}
+Relevant text, if any:"""
+QUESTION_PROMPT = PromptTemplate(
+    template=question_prompt_template, input_variables=["context", "question"]
+)
+
+combine_prompt_template = """Given the following extracted parts of a long document and a question, create a final answer with references ("SOURCES"). 
+If you don't know the answer, just say that you don't know. Don't try to make up an answer.
+ALWAYS return a "SOURCES" part in your answer.
+
+QUESTION: Which state/country's law governs the interpretation of the contract?
+=========
+Content: This Agreement is governed by English law and the parties submit to the exclusive jurisdiction of the English courts in  relation to any dispute (contractual or non-contractual) concerning this Agreement save that either party may apply to any court for an  injunction or other relief to protect its Intellectual Property Rights.
+Source: 28-pl
+Content: No Waiver. Failure or delay in exercising any right or remedy under this Agreement shall not constitute a waiver of such (or any other)  right or remedy.\n\n11.7 Severability. The invalidity, illegality or unenforceability of any term (or part of a term) of this Agreement shall not affect the continuation  in force of the remainder of the term (if any) and this Agreement.\n\n11.8 No Agency. Except as expressly stated otherwise, nothing in this Agreement shall create an agency, partnership or joint venture of any  kind between the parties.\n\n11.9 No Third-Party Beneficiaries.
+Source: 30-pl
+Content: (b) if Google believes, in good faith, that the Distributor has violated or caused Google to violate any Anti-Bribery Laws (as  defined in Clause 8.5) or that such a violation is reasonably likely to occur,
+Source: 4-pl
+=========
+FINAL ANSWER: This Agreement is governed by English law.
+SOURCES: 28-pl
+
+QUESTION: What did the president say about Michael Jackson?
+=========
+Content: Madam Speaker, Madam Vice President, our First Lady and Second Gentleman. Members of Congress and the Cabinet. Justices of the Supreme Court. My fellow Americans.  \n\nLast year COVID-19 kept us apart. This year we are finally together again. \n\nTonight, we meet as Democrats Republicans and Independents. But most importantly as Americans. \n\nWith a duty to one another to the American people to the Constitution. \n\nAnd with an unwavering resolve that freedom will always triumph over tyranny. \n\nSix days ago, Russia’s Vladimir Putin sought to shake the foundations of the free world thinking he could make it bend to his menacing ways. But he badly miscalculated. \n\nHe thought he could roll into Ukraine and the world would roll over. Instead he met a wall of strength he never imagined. \n\nHe met the Ukrainian people. \n\nFrom President Zelenskyy to every Ukrainian, their fearlessness, their courage, their determination, inspires the world. \n\nGroups of citizens blocking tanks with their bodies. Everyone from students to retirees teachers turned soldiers defending their homeland.
+Source: 0-pl
+Content: And we won’t stop. \n\nWe have lost so much to COVID-19. Time with one another. And worst of all, so much loss of life. \n\nLet’s use this moment to reset. Let’s stop looking at COVID-19 as a partisan dividing line and see it for what it is: A God-awful disease.  \n\nLet’s stop seeing each other as enemies, and start seeing each other for who we really are: Fellow Americans.  \n\nWe can’t change how divided we’ve been. But we can change how we move forward—on COVID-19 and other issues we must face together. \n\nI recently visited the New York City Police Department days after the funerals of Officer Wilbert Mora and his partner, Officer Jason Rivera. \n\nThey were responding to a 9-1-1 call when a man shot and killed them with a stolen gun. \n\nOfficer Mora was 27 years old. \n\nOfficer Rivera was 22. \n\nBoth Dominican Americans who’d grown up on the same streets they later chose to patrol as police officers. \n\nI spoke with their families and told them that we are forever in debt for their sacrifice, and we will carry on their mission to restore the trust and safety every community deserves.
+Source: 24-pl
+Content: And a proud Ukrainian people, who have known 30 years  of independence, have repeatedly shown that they will not tolerate anyone who tries to take their country backwards.  \n\nTo all Americans, I will be honest with you, as I’ve always promised. A Russian dictator, invading a foreign country, has costs around the world. \n\nAnd I’m taking robust action to make sure the pain of our sanctions  is targeted at Russia’s economy. And I will use every tool at our disposal to protect American businesses and consumers. \n\nTonight, I can announce that the United States has worked with 30 other countries to release 60 Million barrels of oil from reserves around the world.  \n\nAmerica will lead that effort, releasing 30 Million barrels from our own Strategic Petroleum Reserve. And we stand ready to do more if necessary, unified with our allies.  \n\nThese steps will help blunt gas prices here at home. And I know the news about what’s happening can seem alarming. \n\nBut I want you to know that we are going to be okay.
+Source: 5-pl
+Content: More support for patients and families. \n\nTo get there, I call on Congress to fund ARPA-H, the Advanced Research Projects Agency for Health. \n\nIt’s based on DARPA—the Defense Department project that led to the Internet, GPS, and so much more.  \n\nARPA-H will have a singular purpose—to drive breakthroughs in cancer, Alzheimer’s, diabetes, and more. \n\nA unity agenda for the nation. \n\nWe can do this. \n\nMy fellow Americans—tonight , we have gathered in a sacred space—the citadel of our democracy. \n\nIn this Capitol, generation after generation, Americans have debated great questions amid great strife, and have done great things. \n\nWe have fought for freedom, expanded liberty, defeated totalitarianism and terror. \n\nAnd built the strongest, freest, and most prosperous nation the world has ever known. \n\nNow is the hour. \n\nOur moment of responsibility. \n\nOur test of resolve and conscience, of history itself. \n\nIt is in this moment that our character is formed. Our purpose is found. Our future is forged. \n\nWell I know this nation.
+Source: 34-pl
+=========
+FINAL ANSWER: The president did not mention Michael Jackson.
+SOURCES:
+
+QUESTION: {question}
+=========
+{summaries}
+=========
+FINAL ANSWER:"""
+COMBINE_PROMPT = PromptTemplate(
+    template=combine_prompt_template, input_variables=["summaries", "question"]
+)
+
+EXAMPLE_PROMPT = PromptTemplate(
+    template="Content: {page_content}\nSource: {source}",
+    input_variables=["page_content", "source"],
+)
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/refine_prompts.py b/llm/Lib/site-packages/langchain/chains/qa_with_sources/refine_prompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..2e13f54153b77016e05685a87a7608b4b1bb7586
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/qa_with_sources/refine_prompts.py
@@ -0,0 +1,38 @@
+# flake8: noqa
+from langchain_core.prompts import PromptTemplate
+
+DEFAULT_REFINE_PROMPT_TMPL = (
+    "The original question is as follows: {question}\n"
+    "We have provided an existing answer, including sources: {existing_answer}\n"
+    "We have the opportunity to refine the existing answer"
+    "(only if needed) with some more context below.\n"
+    "------------\n"
+    "{context_str}\n"
+    "------------\n"
+    "Given the new context, refine the original answer to better "
+    "answer the question. "
+    "If you do update it, please update the sources as well. "
+    "If the context isn't useful, return the original answer."
+)
+DEFAULT_REFINE_PROMPT = PromptTemplate(
+    input_variables=["question", "existing_answer", "context_str"],
+    template=DEFAULT_REFINE_PROMPT_TMPL,
+)
+
+
+DEFAULT_TEXT_QA_PROMPT_TMPL = (
+    "Context information is below. \n"
+    "---------------------\n"
+    "{context_str}"
+    "\n---------------------\n"
+    "Given the context information and not prior knowledge, "
+    "answer the question: {question}\n"
+)
+DEFAULT_TEXT_QA_PROMPT = PromptTemplate(
+    input_variables=["context_str", "question"], template=DEFAULT_TEXT_QA_PROMPT_TMPL
+)
+
+EXAMPLE_PROMPT = PromptTemplate(
+    template="Content: {page_content}\nSource: {source}",
+    input_variables=["page_content", "source"],
+)
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/retrieval.py b/llm/Lib/site-packages/langchain/chains/qa_with_sources/retrieval.py
new file mode 100644
index 0000000000000000000000000000000000000000..9642f626ad61aa4ce8643e0282eb2ed56a1fbe6c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/qa_with_sources/retrieval.py
@@ -0,0 +1,66 @@
+"""Question-answering with sources over an index."""
+
+from typing import Any, Dict, List
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+)
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Field
+from langchain_core.retrievers import BaseRetriever
+
+from langchain.chains.combine_documents.stuff import StuffDocumentsChain
+from langchain.chains.qa_with_sources.base import BaseQAWithSourcesChain
+
+
+class RetrievalQAWithSourcesChain(BaseQAWithSourcesChain):
+    """Question-answering with sources over an index."""
+
+    retriever: BaseRetriever = Field(exclude=True)
+    """Index to connect to."""
+    reduce_k_below_max_tokens: bool = False
+    """Reduce the number of results to return from store based on tokens limit"""
+    max_tokens_limit: int = 3375
+    """Restrict the docs to return from store based on tokens,
+    enforced only for StuffDocumentChain and if reduce_k_below_max_tokens is to true"""
+
+    def _reduce_tokens_below_limit(self, docs: List[Document]) -> List[Document]:
+        num_docs = len(docs)
+
+        if self.reduce_k_below_max_tokens and isinstance(
+            self.combine_documents_chain, StuffDocumentsChain
+        ):
+            tokens = [
+                self.combine_documents_chain.llm_chain._get_num_tokens(doc.page_content)
+                for doc in docs
+            ]
+            token_count = sum(tokens[:num_docs])
+            while token_count > self.max_tokens_limit:
+                num_docs -= 1
+                token_count -= tokens[num_docs]
+
+        return docs[:num_docs]
+
+    def _get_docs(
+        self, inputs: Dict[str, Any], *, run_manager: CallbackManagerForChainRun
+    ) -> List[Document]:
+        question = inputs[self.question_key]
+        docs = self.retriever.get_relevant_documents(
+            question, callbacks=run_manager.get_child()
+        )
+        return self._reduce_tokens_below_limit(docs)
+
+    async def _aget_docs(
+        self, inputs: Dict[str, Any], *, run_manager: AsyncCallbackManagerForChainRun
+    ) -> List[Document]:
+        question = inputs[self.question_key]
+        docs = await self.retriever.aget_relevant_documents(
+            question, callbacks=run_manager.get_child()
+        )
+        return self._reduce_tokens_below_limit(docs)
+
+    @property
+    def _chain_type(self) -> str:
+        """Return the chain type."""
+        return "retrieval_qa_with_sources_chain"
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/stuff_prompt.py b/llm/Lib/site-packages/langchain/chains/qa_with_sources/stuff_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..82290ee0507dd817e3365a0e89de10fc62ce37a3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/qa_with_sources/stuff_prompt.py
@@ -0,0 +1,44 @@
+# flake8: noqa
+from langchain_core.prompts import PromptTemplate
+
+template = """Given the following extracted parts of a long document and a question, create a final answer with references ("SOURCES"). 
+If you don't know the answer, just say that you don't know. Don't try to make up an answer.
+ALWAYS return a "SOURCES" part in your answer.
+
+QUESTION: Which state/country's law governs the interpretation of the contract?
+=========
+Content: This Agreement is governed by English law and the parties submit to the exclusive jurisdiction of the English courts in  relation to any dispute (contractual or non-contractual) concerning this Agreement save that either party may apply to any court for an  injunction or other relief to protect its Intellectual Property Rights.
+Source: 28-pl
+Content: No Waiver. Failure or delay in exercising any right or remedy under this Agreement shall not constitute a waiver of such (or any other)  right or remedy.\n\n11.7 Severability. The invalidity, illegality or unenforceability of any term (or part of a term) of this Agreement shall not affect the continuation  in force of the remainder of the term (if any) and this Agreement.\n\n11.8 No Agency. Except as expressly stated otherwise, nothing in this Agreement shall create an agency, partnership or joint venture of any  kind between the parties.\n\n11.9 No Third-Party Beneficiaries.
+Source: 30-pl
+Content: (b) if Google believes, in good faith, that the Distributor has violated or caused Google to violate any Anti-Bribery Laws (as  defined in Clause 8.5) or that such a violation is reasonably likely to occur,
+Source: 4-pl
+=========
+FINAL ANSWER: This Agreement is governed by English law.
+SOURCES: 28-pl
+
+QUESTION: What did the president say about Michael Jackson?
+=========
+Content: Madam Speaker, Madam Vice President, our First Lady and Second Gentleman. Members of Congress and the Cabinet. Justices of the Supreme Court. My fellow Americans.  \n\nLast year COVID-19 kept us apart. This year we are finally together again. \n\nTonight, we meet as Democrats Republicans and Independents. But most importantly as Americans. \n\nWith a duty to one another to the American people to the Constitution. \n\nAnd with an unwavering resolve that freedom will always triumph over tyranny. \n\nSix days ago, Russia’s Vladimir Putin sought to shake the foundations of the free world thinking he could make it bend to his menacing ways. But he badly miscalculated. \n\nHe thought he could roll into Ukraine and the world would roll over. Instead he met a wall of strength he never imagined. \n\nHe met the Ukrainian people. \n\nFrom President Zelenskyy to every Ukrainian, their fearlessness, their courage, their determination, inspires the world. \n\nGroups of citizens blocking tanks with their bodies. Everyone from students to retirees teachers turned soldiers defending their homeland.
+Source: 0-pl
+Content: And we won’t stop. \n\nWe have lost so much to COVID-19. Time with one another. And worst of all, so much loss of life. \n\nLet’s use this moment to reset. Let’s stop looking at COVID-19 as a partisan dividing line and see it for what it is: A God-awful disease.  \n\nLet’s stop seeing each other as enemies, and start seeing each other for who we really are: Fellow Americans.  \n\nWe can’t change how divided we’ve been. But we can change how we move forward—on COVID-19 and other issues we must face together. \n\nI recently visited the New York City Police Department days after the funerals of Officer Wilbert Mora and his partner, Officer Jason Rivera. \n\nThey were responding to a 9-1-1 call when a man shot and killed them with a stolen gun. \n\nOfficer Mora was 27 years old. \n\nOfficer Rivera was 22. \n\nBoth Dominican Americans who’d grown up on the same streets they later chose to patrol as police officers. \n\nI spoke with their families and told them that we are forever in debt for their sacrifice, and we will carry on their mission to restore the trust and safety every community deserves.
+Source: 24-pl
+Content: And a proud Ukrainian people, who have known 30 years  of independence, have repeatedly shown that they will not tolerate anyone who tries to take their country backwards.  \n\nTo all Americans, I will be honest with you, as I’ve always promised. A Russian dictator, invading a foreign country, has costs around the world. \n\nAnd I’m taking robust action to make sure the pain of our sanctions  is targeted at Russia’s economy. And I will use every tool at our disposal to protect American businesses and consumers. \n\nTonight, I can announce that the United States has worked with 30 other countries to release 60 Million barrels of oil from reserves around the world.  \n\nAmerica will lead that effort, releasing 30 Million barrels from our own Strategic Petroleum Reserve. And we stand ready to do more if necessary, unified with our allies.  \n\nThese steps will help blunt gas prices here at home. And I know the news about what’s happening can seem alarming. \n\nBut I want you to know that we are going to be okay.
+Source: 5-pl
+Content: More support for patients and families. \n\nTo get there, I call on Congress to fund ARPA-H, the Advanced Research Projects Agency for Health. \n\nIt’s based on DARPA—the Defense Department project that led to the Internet, GPS, and so much more.  \n\nARPA-H will have a singular purpose—to drive breakthroughs in cancer, Alzheimer’s, diabetes, and more. \n\nA unity agenda for the nation. \n\nWe can do this. \n\nMy fellow Americans—tonight , we have gathered in a sacred space—the citadel of our democracy. \n\nIn this Capitol, generation after generation, Americans have debated great questions amid great strife, and have done great things. \n\nWe have fought for freedom, expanded liberty, defeated totalitarianism and terror. \n\nAnd built the strongest, freest, and most prosperous nation the world has ever known. \n\nNow is the hour. \n\nOur moment of responsibility. \n\nOur test of resolve and conscience, of history itself. \n\nIt is in this moment that our character is formed. Our purpose is found. Our future is forged. \n\nWell I know this nation.
+Source: 34-pl
+=========
+FINAL ANSWER: The president did not mention Michael Jackson.
+SOURCES:
+
+QUESTION: {question}
+=========
+{summaries}
+=========
+FINAL ANSWER:"""
+PROMPT = PromptTemplate(template=template, input_variables=["summaries", "question"])
+
+EXAMPLE_PROMPT = PromptTemplate(
+    template="Content: {page_content}\nSource: {source}",
+    input_variables=["page_content", "source"],
+)
diff --git a/llm/Lib/site-packages/langchain/chains/qa_with_sources/vector_db.py b/llm/Lib/site-packages/langchain/chains/qa_with_sources/vector_db.py
new file mode 100644
index 0000000000000000000000000000000000000000..31e97bbf22e00bab73cdc2bd1549b0cca959ecec
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/qa_with_sources/vector_db.py
@@ -0,0 +1,74 @@
+"""Question-answering with sources over a vector database."""
+
+import warnings
+from typing import Any, Dict, List
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+)
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.vectorstores import VectorStore
+
+from langchain.chains.combine_documents.stuff import StuffDocumentsChain
+from langchain.chains.qa_with_sources.base import BaseQAWithSourcesChain
+
+
+class VectorDBQAWithSourcesChain(BaseQAWithSourcesChain):
+    """Question-answering with sources over a vector database."""
+
+    vectorstore: VectorStore = Field(exclude=True)
+    """Vector Database to connect to."""
+    k: int = 4
+    """Number of results to return from store"""
+    reduce_k_below_max_tokens: bool = False
+    """Reduce the number of results to return from store based on tokens limit"""
+    max_tokens_limit: int = 3375
+    """Restrict the docs to return from store based on tokens,
+    enforced only for StuffDocumentChain and if reduce_k_below_max_tokens is to true"""
+    search_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Extra search args."""
+
+    def _reduce_tokens_below_limit(self, docs: List[Document]) -> List[Document]:
+        num_docs = len(docs)
+
+        if self.reduce_k_below_max_tokens and isinstance(
+            self.combine_documents_chain, StuffDocumentsChain
+        ):
+            tokens = [
+                self.combine_documents_chain.llm_chain._get_num_tokens(doc.page_content)
+                for doc in docs
+            ]
+            token_count = sum(tokens[:num_docs])
+            while token_count > self.max_tokens_limit:
+                num_docs -= 1
+                token_count -= tokens[num_docs]
+
+        return docs[:num_docs]
+
+    def _get_docs(
+        self, inputs: Dict[str, Any], *, run_manager: CallbackManagerForChainRun
+    ) -> List[Document]:
+        question = inputs[self.question_key]
+        docs = self.vectorstore.similarity_search(
+            question, k=self.k, **self.search_kwargs
+        )
+        return self._reduce_tokens_below_limit(docs)
+
+    async def _aget_docs(
+        self, inputs: Dict[str, Any], *, run_manager: AsyncCallbackManagerForChainRun
+    ) -> List[Document]:
+        raise NotImplementedError("VectorDBQAWithSourcesChain does not support async")
+
+    @root_validator()
+    def raise_deprecation(cls, values: Dict) -> Dict:
+        warnings.warn(
+            "`VectorDBQAWithSourcesChain` is deprecated - "
+            "please use `from langchain.chains import RetrievalQAWithSourcesChain`"
+        )
+        return values
+
+    @property
+    def _chain_type(self) -> str:
+        return "vector_db_qa_with_sources_chain"
diff --git a/llm/Lib/site-packages/langchain/chains/query_constructor/__init__.py b/llm/Lib/site-packages/langchain/chains/query_constructor/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9d08ca0e080649fa8fa6e44fa9cbb091aa54461d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/query_constructor/__init__.py
@@ -0,0 +1,3 @@
+from langchain.chains.query_constructor.base import load_query_constructor_runnable
+
+__all__ = ["load_query_constructor_runnable"]
diff --git a/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..64100881b204fa766dd9d779bc2337f501e7f567
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e04da3ff218d2891b509f82a316400a910fc840f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/ir.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/ir.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ad62f98aa1a4b14d156970f9ffa27e06b2369be6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/ir.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/parser.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..811e0c20c846fe5e0084bb8237455fec4bc27371
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..805be705b9b58bba3ef9ea0ae7217fe3847f5ff9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/schema.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/schema.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6ab413d9adfc96ab1f7cb2a64386837f3bc8f346
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/query_constructor/__pycache__/schema.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/query_constructor/base.py b/llm/Lib/site-packages/langchain/chains/query_constructor/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..a0cd9ad88543fe36068973c783964c5b5cf801a8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/query_constructor/base.py
@@ -0,0 +1,367 @@
+"""LLM Chain for turning a user text query into a structured query."""
+from __future__ import annotations
+
+import json
+from typing import Any, Callable, List, Optional, Sequence, Tuple, Union, cast
+
+from langchain_core.exceptions import OutputParserException
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.output_parsers.json import parse_and_check_json_markdown
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.prompts.few_shot import FewShotPromptTemplate
+from langchain_core.runnables import Runnable
+
+from langchain.chains.llm import LLMChain
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    FilterDirective,
+    Operation,
+    Operator,
+    StructuredQuery,
+)
+from langchain.chains.query_constructor.parser import get_parser
+from langchain.chains.query_constructor.prompt import (
+    DEFAULT_EXAMPLES,
+    DEFAULT_PREFIX,
+    DEFAULT_SCHEMA_PROMPT,
+    DEFAULT_SUFFIX,
+    EXAMPLE_PROMPT,
+    EXAMPLES_WITH_LIMIT,
+    PREFIX_WITH_DATA_SOURCE,
+    SCHEMA_WITH_LIMIT_PROMPT,
+    SUFFIX_WITHOUT_DATA_SOURCE,
+    USER_SPECIFIED_EXAMPLE_PROMPT,
+)
+from langchain.chains.query_constructor.schema import AttributeInfo
+
+
+class StructuredQueryOutputParser(BaseOutputParser[StructuredQuery]):
+    """Output parser that parses a structured query."""
+
+    ast_parse: Callable
+    """Callable that parses dict into internal representation of query language."""
+
+    def parse(self, text: str) -> StructuredQuery:
+        try:
+            expected_keys = ["query", "filter"]
+            allowed_keys = ["query", "filter", "limit"]
+            parsed = parse_and_check_json_markdown(text, expected_keys)
+            if parsed["query"] is None or len(parsed["query"]) == 0:
+                parsed["query"] = " "
+            if parsed["filter"] == "NO_FILTER" or not parsed["filter"]:
+                parsed["filter"] = None
+            else:
+                parsed["filter"] = self.ast_parse(parsed["filter"])
+            if not parsed.get("limit"):
+                parsed.pop("limit", None)
+            return StructuredQuery(
+                **{k: v for k, v in parsed.items() if k in allowed_keys}
+            )
+        except Exception as e:
+            raise OutputParserException(
+                f"Parsing text\n{text}\n raised following error:\n{e}"
+            )
+
+    @classmethod
+    def from_components(
+        cls,
+        allowed_comparators: Optional[Sequence[Comparator]] = None,
+        allowed_operators: Optional[Sequence[Operator]] = None,
+        allowed_attributes: Optional[Sequence[str]] = None,
+        fix_invalid: bool = False,
+    ) -> StructuredQueryOutputParser:
+        """
+        Create a structured query output parser from components.
+
+        Args:
+            allowed_comparators: allowed comparators
+            allowed_operators: allowed operators
+
+        Returns:
+            a structured query output parser
+        """
+        ast_parse: Callable
+        if fix_invalid:
+
+            def ast_parse(raw_filter: str) -> Optional[FilterDirective]:
+                filter = cast(Optional[FilterDirective], get_parser().parse(raw_filter))
+                fixed = fix_filter_directive(
+                    filter,
+                    allowed_comparators=allowed_comparators,
+                    allowed_operators=allowed_operators,
+                    allowed_attributes=allowed_attributes,
+                )
+                return fixed
+
+        else:
+            ast_parse = get_parser(
+                allowed_comparators=allowed_comparators,
+                allowed_operators=allowed_operators,
+                allowed_attributes=allowed_attributes,
+            ).parse
+        return cls(ast_parse=ast_parse)
+
+
+def fix_filter_directive(
+    filter: Optional[FilterDirective],
+    *,
+    allowed_comparators: Optional[Sequence[Comparator]] = None,
+    allowed_operators: Optional[Sequence[Operator]] = None,
+    allowed_attributes: Optional[Sequence[str]] = None,
+) -> Optional[FilterDirective]:
+    """Fix invalid filter directive.
+
+    Args:
+        filter: Filter directive to fix.
+        allowed_comparators: allowed comparators. Defaults to all comparators.
+        allowed_operators: allowed operators. Defaults to all operators.
+        allowed_attributes: allowed attributes. Defaults to all attributes.
+
+    Returns:
+        Fixed filter directive.
+    """
+    if (
+        not (allowed_comparators or allowed_operators or allowed_attributes)
+    ) or not filter:
+        return filter
+
+    elif isinstance(filter, Comparison):
+        if allowed_comparators and filter.comparator not in allowed_comparators:
+            return None
+        if allowed_attributes and filter.attribute not in allowed_attributes:
+            return None
+        return filter
+    elif isinstance(filter, Operation):
+        if allowed_operators and filter.operator not in allowed_operators:
+            return None
+        args = [
+            cast(
+                FilterDirective,
+                fix_filter_directive(
+                    arg,
+                    allowed_comparators=allowed_comparators,
+                    allowed_operators=allowed_operators,
+                    allowed_attributes=allowed_attributes,
+                ),
+            )
+            for arg in filter.arguments
+            if arg is not None
+        ]
+        if not args:
+            return None
+        elif len(args) == 1 and filter.operator in (Operator.AND, Operator.OR):
+            return args[0]
+        else:
+            return Operation(
+                operator=filter.operator,
+                arguments=args,
+            )
+    else:
+        return filter
+
+
+def _format_attribute_info(info: Sequence[Union[AttributeInfo, dict]]) -> str:
+    info_dicts = {}
+    for i in info:
+        i_dict = dict(i)
+        info_dicts[i_dict.pop("name")] = i_dict
+    return json.dumps(info_dicts, indent=4).replace("{", "{{").replace("}", "}}")
+
+
+def construct_examples(input_output_pairs: Sequence[Tuple[str, dict]]) -> List[dict]:
+    """Construct examples from input-output pairs.
+
+    Args:
+        input_output_pairs: Sequence of input-output pairs.
+
+    Returns:
+        List of examples.
+    """
+    examples = []
+    for i, (_input, output) in enumerate(input_output_pairs):
+        structured_request = (
+            json.dumps(output, indent=4).replace("{", "{{").replace("}", "}}")
+        )
+        example = {
+            "i": i + 1,
+            "user_query": _input,
+            "structured_request": structured_request,
+        }
+        examples.append(example)
+    return examples
+
+
+def get_query_constructor_prompt(
+    document_contents: str,
+    attribute_info: Sequence[Union[AttributeInfo, dict]],
+    *,
+    examples: Optional[Sequence] = None,
+    allowed_comparators: Sequence[Comparator] = tuple(Comparator),
+    allowed_operators: Sequence[Operator] = tuple(Operator),
+    enable_limit: bool = False,
+    schema_prompt: Optional[BasePromptTemplate] = None,
+    **kwargs: Any,
+) -> BasePromptTemplate:
+    """Create query construction prompt.
+
+    Args:
+        document_contents: The contents of the document to be queried.
+        attribute_info: A list of AttributeInfo objects describing
+            the attributes of the document.
+        examples: Optional list of examples to use for the chain.
+        allowed_comparators: Sequence of allowed comparators.
+        allowed_operators: Sequence of allowed operators.
+        enable_limit: Whether to enable the limit operator. Defaults to False.
+        schema_prompt: Prompt for describing query schema. Should have string input
+            variables allowed_comparators and allowed_operators.
+        **kwargs: Additional named params to pass to FewShotPromptTemplate init.
+
+    Returns:
+        A prompt template that can be used to construct queries.
+    """
+    default_schema_prompt = (
+        SCHEMA_WITH_LIMIT_PROMPT if enable_limit else DEFAULT_SCHEMA_PROMPT
+    )
+    schema_prompt = schema_prompt or default_schema_prompt
+    attribute_str = _format_attribute_info(attribute_info)
+    schema = schema_prompt.format(
+        allowed_comparators=" | ".join(allowed_comparators),
+        allowed_operators=" | ".join(allowed_operators),
+    )
+    if examples and isinstance(examples[0], tuple):
+        examples = construct_examples(examples)
+        example_prompt = USER_SPECIFIED_EXAMPLE_PROMPT
+        prefix = PREFIX_WITH_DATA_SOURCE.format(
+            schema=schema, content=document_contents, attributes=attribute_str
+        )
+        suffix = SUFFIX_WITHOUT_DATA_SOURCE.format(i=len(examples) + 1)
+    else:
+        examples = examples or (
+            EXAMPLES_WITH_LIMIT if enable_limit else DEFAULT_EXAMPLES
+        )
+        example_prompt = EXAMPLE_PROMPT
+        prefix = DEFAULT_PREFIX.format(schema=schema)
+        suffix = DEFAULT_SUFFIX.format(
+            i=len(examples) + 1, content=document_contents, attributes=attribute_str
+        )
+    return FewShotPromptTemplate(
+        examples=list(examples),
+        example_prompt=example_prompt,
+        input_variables=["query"],
+        suffix=suffix,
+        prefix=prefix,
+        **kwargs,
+    )
+
+
+def load_query_constructor_chain(
+    llm: BaseLanguageModel,
+    document_contents: str,
+    attribute_info: Sequence[Union[AttributeInfo, dict]],
+    examples: Optional[List] = None,
+    allowed_comparators: Sequence[Comparator] = tuple(Comparator),
+    allowed_operators: Sequence[Operator] = tuple(Operator),
+    enable_limit: bool = False,
+    schema_prompt: Optional[BasePromptTemplate] = None,
+    **kwargs: Any,
+) -> LLMChain:
+    """Load a query constructor chain.
+
+    Args:
+        llm: BaseLanguageModel to use for the chain.
+        document_contents: The contents of the document to be queried.
+        attribute_info: Sequence of attributes in the document.
+        examples: Optional list of examples to use for the chain.
+        allowed_comparators: Sequence of allowed comparators. Defaults to all
+            Comparators.
+        allowed_operators: Sequence of allowed operators. Defaults to all Operators.
+        enable_limit: Whether to enable the limit operator. Defaults to False.
+        schema_prompt: Prompt for describing query schema. Should have string input
+            variables allowed_comparators and allowed_operators.
+        **kwargs: Arbitrary named params to pass to LLMChain.
+
+    Returns:
+        A LLMChain that can be used to construct queries.
+    """
+    prompt = get_query_constructor_prompt(
+        document_contents,
+        attribute_info,
+        examples=examples,
+        allowed_comparators=allowed_comparators,
+        allowed_operators=allowed_operators,
+        enable_limit=enable_limit,
+        schema_prompt=schema_prompt,
+    )
+    allowed_attributes = []
+    for ainfo in attribute_info:
+        allowed_attributes.append(
+            ainfo.name if isinstance(ainfo, AttributeInfo) else ainfo["name"]
+        )
+    output_parser = StructuredQueryOutputParser.from_components(
+        allowed_comparators=allowed_comparators,
+        allowed_operators=allowed_operators,
+        allowed_attributes=allowed_attributes,
+    )
+    # For backwards compatibility.
+    prompt.output_parser = output_parser
+    return LLMChain(llm=llm, prompt=prompt, output_parser=output_parser, **kwargs)
+
+
+def load_query_constructor_runnable(
+    llm: BaseLanguageModel,
+    document_contents: str,
+    attribute_info: Sequence[Union[AttributeInfo, dict]],
+    *,
+    examples: Optional[Sequence] = None,
+    allowed_comparators: Sequence[Comparator] = tuple(Comparator),
+    allowed_operators: Sequence[Operator] = tuple(Operator),
+    enable_limit: bool = False,
+    schema_prompt: Optional[BasePromptTemplate] = None,
+    fix_invalid: bool = False,
+    **kwargs: Any,
+) -> Runnable:
+    """Load a query constructor runnable chain.
+
+    Args:
+        llm: BaseLanguageModel to use for the chain.
+        document_contents: Description of the page contents of the document to be
+            queried.
+        attribute_info: Sequence of attributes in the document.
+        examples: Optional list of examples to use for the chain.
+        allowed_comparators: Sequence of allowed comparators. Defaults to all
+            Comparators.
+        allowed_operators: Sequence of allowed operators. Defaults to all Operators.
+        enable_limit: Whether to enable the limit operator. Defaults to False.
+        schema_prompt: Prompt for describing query schema. Should have string input
+            variables allowed_comparators and allowed_operators.
+        fix_invalid: Whether to fix invalid filter directives by ignoring invalid
+            operators, comparators and attributes.
+        **kwargs: Additional named params to pass to FewShotPromptTemplate init.
+
+    Returns:
+        A Runnable that can be used to construct queries.
+    """
+    prompt = get_query_constructor_prompt(
+        document_contents,
+        attribute_info,
+        examples=examples,
+        allowed_comparators=allowed_comparators,
+        allowed_operators=allowed_operators,
+        enable_limit=enable_limit,
+        schema_prompt=schema_prompt,
+        **kwargs,
+    )
+    allowed_attributes = []
+    for ainfo in attribute_info:
+        allowed_attributes.append(
+            ainfo.name if isinstance(ainfo, AttributeInfo) else ainfo["name"]
+        )
+    output_parser = StructuredQueryOutputParser.from_components(
+        allowed_comparators=allowed_comparators,
+        allowed_operators=allowed_operators,
+        allowed_attributes=allowed_attributes,
+        fix_invalid=fix_invalid,
+    )
+    return prompt | llm | output_parser
diff --git a/llm/Lib/site-packages/langchain/chains/query_constructor/ir.py b/llm/Lib/site-packages/langchain/chains/query_constructor/ir.py
new file mode 100644
index 0000000000000000000000000000000000000000..eb61cea6b507f15dcef6fb336e1ab7b82c8cf79e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/query_constructor/ir.py
@@ -0,0 +1,143 @@
+"""Internal representation of a structured query language."""
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from enum import Enum
+from typing import Any, List, Optional, Sequence, Union
+
+from langchain_core.pydantic_v1 import BaseModel
+
+
+class Visitor(ABC):
+    """Defines interface for IR translation using visitor pattern."""
+
+    allowed_comparators: Optional[Sequence[Comparator]] = None
+    allowed_operators: Optional[Sequence[Operator]] = None
+
+    def _validate_func(self, func: Union[Operator, Comparator]) -> None:
+        if isinstance(func, Operator) and self.allowed_operators is not None:
+            if func not in self.allowed_operators:
+                raise ValueError(
+                    f"Received disallowed operator {func}. Allowed "
+                    f"comparators are {self.allowed_operators}"
+                )
+        if isinstance(func, Comparator) and self.allowed_comparators is not None:
+            if func not in self.allowed_comparators:
+                raise ValueError(
+                    f"Received disallowed comparator {func}. Allowed "
+                    f"comparators are {self.allowed_comparators}"
+                )
+
+    @abstractmethod
+    def visit_operation(self, operation: Operation) -> Any:
+        """Translate an Operation."""
+
+    @abstractmethod
+    def visit_comparison(self, comparison: Comparison) -> Any:
+        """Translate a Comparison."""
+
+    @abstractmethod
+    def visit_structured_query(self, structured_query: StructuredQuery) -> Any:
+        """Translate a StructuredQuery."""
+
+
+def _to_snake_case(name: str) -> str:
+    """Convert a name into snake_case."""
+    snake_case = ""
+    for i, char in enumerate(name):
+        if char.isupper() and i != 0:
+            snake_case += "_" + char.lower()
+        else:
+            snake_case += char.lower()
+    return snake_case
+
+
+class Expr(BaseModel):
+    """Base class for all expressions."""
+
+    def accept(self, visitor: Visitor) -> Any:
+        """Accept a visitor.
+
+        Args:
+            visitor: visitor to accept
+
+        Returns:
+            result of visiting
+        """
+        return getattr(visitor, f"visit_{_to_snake_case(self.__class__.__name__)}")(
+            self
+        )
+
+
+class Operator(str, Enum):
+    """Enumerator of the operations."""
+
+    AND = "and"
+    OR = "or"
+    NOT = "not"
+
+
+class Comparator(str, Enum):
+    """Enumerator of the comparison operators."""
+
+    EQ = "eq"
+    NE = "ne"
+    GT = "gt"
+    GTE = "gte"
+    LT = "lt"
+    LTE = "lte"
+    CONTAIN = "contain"
+    LIKE = "like"
+    IN = "in"
+    NIN = "nin"
+
+
+class FilterDirective(Expr, ABC):
+    """A filtering expression."""
+
+
+class Comparison(FilterDirective):
+    """A comparison to a value."""
+
+    comparator: Comparator
+    attribute: str
+    value: Any
+
+    def __init__(
+        self, comparator: Comparator, attribute: str, value: Any, **kwargs: Any
+    ) -> None:
+        super().__init__(
+            comparator=comparator, attribute=attribute, value=value, **kwargs
+        )
+
+
+class Operation(FilterDirective):
+    """A logical operation over other directives."""
+
+    operator: Operator
+    arguments: List[FilterDirective]
+
+    def __init__(
+        self, operator: Operator, arguments: List[FilterDirective], **kwargs: Any
+    ):
+        super().__init__(operator=operator, arguments=arguments, **kwargs)
+
+
+class StructuredQuery(Expr):
+    """A structured query."""
+
+    query: str
+    """Query string."""
+    filter: Optional[FilterDirective]
+    """Filtering expression."""
+    limit: Optional[int]
+    """Limit on the number of results."""
+
+    def __init__(
+        self,
+        query: str,
+        filter: Optional[FilterDirective],
+        limit: Optional[int] = None,
+        **kwargs: Any,
+    ):
+        super().__init__(query=query, filter=filter, limit=limit, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/chains/query_constructor/parser.py b/llm/Lib/site-packages/langchain/chains/query_constructor/parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..26c5360d59febb9dd59bd33ec4be7f5e6687a5e6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/query_constructor/parser.py
@@ -0,0 +1,182 @@
+import datetime
+import warnings
+from typing import Any, Literal, Optional, Sequence, Union
+
+from langchain_core.utils import check_package_version
+from typing_extensions import TypedDict
+
+try:
+    check_package_version("lark", gte_version="1.1.5")
+    from lark import Lark, Transformer, v_args
+except ImportError:
+
+    def v_args(*args: Any, **kwargs: Any) -> Any:  # type: ignore
+        """Dummy decorator for when lark is not installed."""
+        return lambda _: None
+
+    Transformer = object  # type: ignore
+    Lark = object  # type: ignore
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    FilterDirective,
+    Operation,
+    Operator,
+)
+
+GRAMMAR = r"""
+    ?program: func_call
+    ?expr: func_call
+        | value
+
+    func_call: CNAME "(" [args] ")"
+
+    ?value: SIGNED_INT -> int
+        | SIGNED_FLOAT -> float
+        | DATE -> date
+        | list
+        | string
+        | ("false" | "False" | "FALSE") -> false
+        | ("true" | "True" | "TRUE") -> true
+
+    args: expr ("," expr)*
+    DATE.2: /["']?(\d{4}-[01]\d-[0-3]\d)["']?/
+    string: /'[^']*'/ | ESCAPED_STRING
+    list: "[" [args] "]"
+
+    %import common.CNAME
+    %import common.ESCAPED_STRING
+    %import common.SIGNED_FLOAT
+    %import common.SIGNED_INT
+    %import common.WS
+    %ignore WS
+"""
+
+
+class ISO8601Date(TypedDict):
+    """A date in ISO 8601 format (YYYY-MM-DD)."""
+
+    date: str
+    type: Literal["date"]
+
+
+@v_args(inline=True)
+class QueryTransformer(Transformer):
+    """Transforms a query string into an intermediate representation."""
+
+    def __init__(
+        self,
+        *args: Any,
+        allowed_comparators: Optional[Sequence[Comparator]] = None,
+        allowed_operators: Optional[Sequence[Operator]] = None,
+        allowed_attributes: Optional[Sequence[str]] = None,
+        **kwargs: Any,
+    ):
+        super().__init__(*args, **kwargs)
+        self.allowed_comparators = allowed_comparators
+        self.allowed_operators = allowed_operators
+        self.allowed_attributes = allowed_attributes
+
+    def program(self, *items: Any) -> tuple:
+        return items
+
+    def func_call(self, func_name: Any, args: list) -> FilterDirective:
+        func = self._match_func_name(str(func_name))
+        if isinstance(func, Comparator):
+            if self.allowed_attributes and args[0] not in self.allowed_attributes:
+                raise ValueError(
+                    f"Received invalid attributes {args[0]}. Allowed attributes are "
+                    f"{self.allowed_attributes}"
+                )
+            return Comparison(comparator=func, attribute=args[0], value=args[1])
+        elif len(args) == 1 and func in (Operator.AND, Operator.OR):
+            return args[0]
+        else:
+            return Operation(operator=func, arguments=args)
+
+    def _match_func_name(self, func_name: str) -> Union[Operator, Comparator]:
+        if func_name in set(Comparator):
+            if self.allowed_comparators is not None:
+                if func_name not in self.allowed_comparators:
+                    raise ValueError(
+                        f"Received disallowed comparator {func_name}. Allowed "
+                        f"comparators are {self.allowed_comparators}"
+                    )
+            return Comparator(func_name)
+        elif func_name in set(Operator):
+            if self.allowed_operators is not None:
+                if func_name not in self.allowed_operators:
+                    raise ValueError(
+                        f"Received disallowed operator {func_name}. Allowed operators"
+                        f" are {self.allowed_operators}"
+                    )
+            return Operator(func_name)
+        else:
+            raise ValueError(
+                f"Received unrecognized function {func_name}. Valid functions are "
+                f"{list(Operator) + list(Comparator)}"
+            )
+
+    def args(self, *items: Any) -> tuple:
+        return items
+
+    def false(self) -> bool:
+        return False
+
+    def true(self) -> bool:
+        return True
+
+    def list(self, item: Any) -> list:
+        if item is None:
+            return []
+        return list(item)
+
+    def int(self, item: Any) -> int:
+        return int(item)
+
+    def float(self, item: Any) -> float:
+        return float(item)
+
+    def date(self, item: Any) -> ISO8601Date:
+        item = str(item).strip("\"'")
+        try:
+            datetime.datetime.strptime(item, "%Y-%m-%d")
+        except ValueError:
+            warnings.warn(
+                "Dates are expected to be provided in ISO 8601 date format "
+                "(YYYY-MM-DD)."
+            )
+        return {"date": item, "type": "date"}
+
+    def string(self, item: Any) -> str:
+        # Remove escaped quotes
+        return str(item).strip("\"'")
+
+
+def get_parser(
+    allowed_comparators: Optional[Sequence[Comparator]] = None,
+    allowed_operators: Optional[Sequence[Operator]] = None,
+    allowed_attributes: Optional[Sequence[str]] = None,
+) -> Lark:
+    """
+    Returns a parser for the query language.
+
+    Args:
+        allowed_comparators: Optional[Sequence[Comparator]]
+        allowed_operators: Optional[Sequence[Operator]]
+
+    Returns:
+        Lark parser for the query language.
+    """
+    # QueryTransformer is None when Lark cannot be imported.
+    if QueryTransformer is None:
+        raise ImportError(
+            "Cannot import lark, please install it with 'pip install lark'."
+        )
+    transformer = QueryTransformer(
+        allowed_comparators=allowed_comparators,
+        allowed_operators=allowed_operators,
+        allowed_attributes=allowed_attributes,
+    )
+    return Lark(GRAMMAR, parser="lalr", transformer=transformer, start="program")
diff --git a/llm/Lib/site-packages/langchain/chains/query_constructor/prompt.py b/llm/Lib/site-packages/langchain/chains/query_constructor/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1355b32663d533d74d7688ac6ff8e7631b9fd71
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/query_constructor/prompt.py
@@ -0,0 +1,227 @@
+# flake8: noqa
+from langchain_core.prompts import PromptTemplate
+
+SONG_DATA_SOURCE = """\
+```json
+{{
+    "content": "Lyrics of a song",
+    "attributes": {{
+        "artist": {{
+            "type": "string",
+            "description": "Name of the song artist"
+        }},
+        "length": {{
+            "type": "integer",
+            "description": "Length of the song in seconds"
+        }},
+        "genre": {{
+            "type": "string",
+            "description": "The song genre, one of \"pop\", \"rock\" or \"rap\""
+        }}
+    }}
+}}
+```\
+"""
+
+FULL_ANSWER = """\
+```json
+{{
+    "query": "teenager love",
+    "filter": "and(or(eq(\\"artist\\", \\"Taylor Swift\\"), eq(\\"artist\\", \\"Katy Perry\\")), lt(\\"length\\", 180), eq(\\"genre\\", \\"pop\\"))"
+}}
+```\
+"""
+
+NO_FILTER_ANSWER = """\
+```json
+{{
+    "query": "",
+    "filter": "NO_FILTER"
+}}
+```\
+"""
+
+WITH_LIMIT_ANSWER = """\
+```json
+{{
+    "query": "love",
+    "filter": "NO_FILTER",
+    "limit": 2
+}}
+```\
+"""
+
+DEFAULT_EXAMPLES = [
+    {
+        "i": 1,
+        "data_source": SONG_DATA_SOURCE,
+        "user_query": "What are songs by Taylor Swift or Katy Perry about teenage romance under 3 minutes long in the dance pop genre",
+        "structured_request": FULL_ANSWER,
+    },
+    {
+        "i": 2,
+        "data_source": SONG_DATA_SOURCE,
+        "user_query": "What are songs that were not published on Spotify",
+        "structured_request": NO_FILTER_ANSWER,
+    },
+]
+
+EXAMPLES_WITH_LIMIT = [
+    {
+        "i": 1,
+        "data_source": SONG_DATA_SOURCE,
+        "user_query": "What are songs by Taylor Swift or Katy Perry about teenage romance under 3 minutes long in the dance pop genre",
+        "structured_request": FULL_ANSWER,
+    },
+    {
+        "i": 2,
+        "data_source": SONG_DATA_SOURCE,
+        "user_query": "What are songs that were not published on Spotify",
+        "structured_request": NO_FILTER_ANSWER,
+    },
+    {
+        "i": 3,
+        "data_source": SONG_DATA_SOURCE,
+        "user_query": "What are three songs about love",
+        "structured_request": WITH_LIMIT_ANSWER,
+    },
+]
+
+EXAMPLE_PROMPT_TEMPLATE = """\
+<< Example {i}. >>
+Data Source:
+{data_source}
+
+User Query:
+{user_query}
+
+Structured Request:
+{structured_request}
+"""
+
+EXAMPLE_PROMPT = PromptTemplate.from_template(EXAMPLE_PROMPT_TEMPLATE)
+
+USER_SPECIFIED_EXAMPLE_PROMPT = PromptTemplate.from_template(
+    """\
+<< Example {i}. >>
+User Query:
+{user_query}
+
+Structured Request:
+```json
+{structured_request}
+```
+"""
+)
+
+DEFAULT_SCHEMA = """\
+<< Structured Request Schema >>
+When responding use a markdown code snippet with a JSON object formatted in the following schema:
+
+```json
+{{{{
+    "query": string \\ text string to compare to document contents
+    "filter": string \\ logical condition statement for filtering documents
+}}}}
+```
+
+The query string should contain only text that is expected to match the contents of documents. Any conditions in the filter should not be mentioned in the query as well.
+
+A logical condition statement is composed of one or more comparison and logical operation statements.
+
+A comparison statement takes the form: `comp(attr, val)`:
+- `comp` ({allowed_comparators}): comparator
+- `attr` (string):  name of attribute to apply the comparison to
+- `val` (string): is the comparison value
+
+A logical operation statement takes the form `op(statement1, statement2, ...)`:
+- `op` ({allowed_operators}): logical operator
+- `statement1`, `statement2`, ... (comparison statements or logical operation statements): one or more statements to apply the operation to
+
+Make sure that you only use the comparators and logical operators listed above and no others.
+Make sure that filters only refer to attributes that exist in the data source.
+Make sure that filters only use the attributed names with its function names if there are functions applied on them.
+Make sure that filters only use format `YYYY-MM-DD` when handling date data typed values.
+Make sure that filters take into account the descriptions of attributes and only make comparisons that are feasible given the type of data being stored.
+Make sure that filters are only used as needed. If there are no filters that should be applied return "NO_FILTER" for the filter value.\
+"""
+DEFAULT_SCHEMA_PROMPT = PromptTemplate.from_template(DEFAULT_SCHEMA)
+
+SCHEMA_WITH_LIMIT = """\
+<< Structured Request Schema >>
+When responding use a markdown code snippet with a JSON object formatted in the following schema:
+
+```json
+{{{{
+    "query": string \\ text string to compare to document contents
+    "filter": string \\ logical condition statement for filtering documents
+    "limit": int \\ the number of documents to retrieve
+}}}}
+```
+
+The query string should contain only text that is expected to match the contents of documents. Any conditions in the filter should not be mentioned in the query as well.
+
+A logical condition statement is composed of one or more comparison and logical operation statements.
+
+A comparison statement takes the form: `comp(attr, val)`:
+- `comp` ({allowed_comparators}): comparator
+- `attr` (string):  name of attribute to apply the comparison to
+- `val` (string): is the comparison value
+
+A logical operation statement takes the form `op(statement1, statement2, ...)`:
+- `op` ({allowed_operators}): logical operator
+- `statement1`, `statement2`, ... (comparison statements or logical operation statements): one or more statements to apply the operation to
+
+Make sure that you only use the comparators and logical operators listed above and no others.
+Make sure that filters only refer to attributes that exist in the data source.
+Make sure that filters only use the attributed names with its function names if there are functions applied on them.
+Make sure that filters only use format `YYYY-MM-DD` when handling date data typed values.
+Make sure that filters take into account the descriptions of attributes and only make comparisons that are feasible given the type of data being stored.
+Make sure that filters are only used as needed. If there are no filters that should be applied return "NO_FILTER" for the filter value.
+Make sure the `limit` is always an int value. It is an optional parameter so leave it blank if it does not make sense.
+"""
+SCHEMA_WITH_LIMIT_PROMPT = PromptTemplate.from_template(SCHEMA_WITH_LIMIT)
+
+DEFAULT_PREFIX = """\
+Your goal is to structure the user's query to match the request schema provided below.
+
+{schema}\
+"""
+
+PREFIX_WITH_DATA_SOURCE = (
+    DEFAULT_PREFIX
+    + """
+
+<< Data Source >>
+```json
+{{{{
+    "content": "{content}",
+    "attributes": {attributes}
+}}}}
+```
+"""
+)
+
+DEFAULT_SUFFIX = """\
+<< Example {i}. >>
+Data Source:
+```json
+{{{{
+    "content": "{content}",
+    "attributes": {attributes}
+}}}}
+```
+
+User Query:
+{{query}}
+
+Structured Request:
+"""
+
+SUFFIX_WITHOUT_DATA_SOURCE = """\
+<< Example {i}. >>
+User Query:
+{{query}}
+
+Structured Request:
+"""
diff --git a/llm/Lib/site-packages/langchain/chains/query_constructor/schema.py b/llm/Lib/site-packages/langchain/chains/query_constructor/schema.py
new file mode 100644
index 0000000000000000000000000000000000000000..6171b3742f2acf88cd3e24e22ca49cff652841e6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/query_constructor/schema.py
@@ -0,0 +1,15 @@
+from langchain_core.pydantic_v1 import BaseModel
+
+
+class AttributeInfo(BaseModel):
+    """Information about a data source attribute."""
+
+    name: str
+    description: str
+    type: str
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+        frozen = True
diff --git a/llm/Lib/site-packages/langchain/chains/question_answering/__init__.py b/llm/Lib/site-packages/langchain/chains/question_answering/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2bbf394e700a7bd551feac5edd7f93e586c06d87
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/question_answering/__init__.py
@@ -0,0 +1,251 @@
+"""Load question answering chains."""
+from typing import Any, Mapping, Optional, Protocol
+
+from langchain_core.callbacks import BaseCallbackManager, Callbacks
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+
+from langchain.chains import ReduceDocumentsChain
+from langchain.chains.combine_documents.base import BaseCombineDocumentsChain
+from langchain.chains.combine_documents.map_reduce import MapReduceDocumentsChain
+from langchain.chains.combine_documents.map_rerank import MapRerankDocumentsChain
+from langchain.chains.combine_documents.refine import RefineDocumentsChain
+from langchain.chains.combine_documents.stuff import StuffDocumentsChain
+from langchain.chains.llm import LLMChain
+from langchain.chains.question_answering import (
+    map_reduce_prompt,
+    refine_prompts,
+    stuff_prompt,
+)
+from langchain.chains.question_answering.map_rerank_prompt import (
+    PROMPT as MAP_RERANK_PROMPT,
+)
+
+
+class LoadingCallable(Protocol):
+    """Interface for loading the combine documents chain."""
+
+    def __call__(
+        self, llm: BaseLanguageModel, **kwargs: Any
+    ) -> BaseCombineDocumentsChain:
+        """Callable to load the combine documents chain."""
+
+
+def _load_map_rerank_chain(
+    llm: BaseLanguageModel,
+    prompt: BasePromptTemplate = MAP_RERANK_PROMPT,
+    verbose: bool = False,
+    document_variable_name: str = "context",
+    rank_key: str = "score",
+    answer_key: str = "answer",
+    callback_manager: Optional[BaseCallbackManager] = None,
+    callbacks: Callbacks = None,
+    **kwargs: Any,
+) -> MapRerankDocumentsChain:
+    llm_chain = LLMChain(
+        llm=llm,
+        prompt=prompt,
+        verbose=verbose,
+        callback_manager=callback_manager,
+        callbacks=callbacks,
+    )
+    return MapRerankDocumentsChain(
+        llm_chain=llm_chain,
+        rank_key=rank_key,
+        answer_key=answer_key,
+        document_variable_name=document_variable_name,
+        verbose=verbose,
+        callback_manager=callback_manager,
+        **kwargs,
+    )
+
+
+def _load_stuff_chain(
+    llm: BaseLanguageModel,
+    prompt: Optional[BasePromptTemplate] = None,
+    document_variable_name: str = "context",
+    verbose: Optional[bool] = None,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    callbacks: Callbacks = None,
+    **kwargs: Any,
+) -> StuffDocumentsChain:
+    _prompt = prompt or stuff_prompt.PROMPT_SELECTOR.get_prompt(llm)
+    llm_chain = LLMChain(
+        llm=llm,
+        prompt=_prompt,
+        verbose=verbose,  # type: ignore[arg-type]
+        callback_manager=callback_manager,
+        callbacks=callbacks,
+    )
+    # TODO: document prompt
+    return StuffDocumentsChain(
+        llm_chain=llm_chain,
+        document_variable_name=document_variable_name,
+        verbose=verbose,  # type: ignore[arg-type]
+        callback_manager=callback_manager,
+        callbacks=callbacks,
+        **kwargs,
+    )
+
+
+def _load_map_reduce_chain(
+    llm: BaseLanguageModel,
+    question_prompt: Optional[BasePromptTemplate] = None,
+    combine_prompt: Optional[BasePromptTemplate] = None,
+    combine_document_variable_name: str = "summaries",
+    map_reduce_document_variable_name: str = "context",
+    collapse_prompt: Optional[BasePromptTemplate] = None,
+    reduce_llm: Optional[BaseLanguageModel] = None,
+    collapse_llm: Optional[BaseLanguageModel] = None,
+    verbose: Optional[bool] = None,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    callbacks: Callbacks = None,
+    token_max: int = 3000,
+    **kwargs: Any,
+) -> MapReduceDocumentsChain:
+    _question_prompt = (
+        question_prompt or map_reduce_prompt.QUESTION_PROMPT_SELECTOR.get_prompt(llm)
+    )
+    _combine_prompt = (
+        combine_prompt or map_reduce_prompt.COMBINE_PROMPT_SELECTOR.get_prompt(llm)
+    )
+    map_chain = LLMChain(
+        llm=llm,
+        prompt=_question_prompt,
+        verbose=verbose,  # type: ignore[arg-type]
+        callback_manager=callback_manager,
+        callbacks=callbacks,
+    )
+    _reduce_llm = reduce_llm or llm
+    reduce_chain = LLMChain(
+        llm=_reduce_llm,
+        prompt=_combine_prompt,
+        verbose=verbose,  # type: ignore[arg-type]
+        callback_manager=callback_manager,
+        callbacks=callbacks,
+    )
+    # TODO: document prompt
+    combine_documents_chain = StuffDocumentsChain(
+        llm_chain=reduce_chain,
+        document_variable_name=combine_document_variable_name,
+        verbose=verbose,  # type: ignore[arg-type]
+        callback_manager=callback_manager,
+        callbacks=callbacks,
+    )
+    if collapse_prompt is None:
+        collapse_chain = None
+        if collapse_llm is not None:
+            raise ValueError(
+                "collapse_llm provided, but collapse_prompt was not: please "
+                "provide one or stop providing collapse_llm."
+            )
+    else:
+        _collapse_llm = collapse_llm or llm
+        collapse_chain = StuffDocumentsChain(
+            llm_chain=LLMChain(
+                llm=_collapse_llm,
+                prompt=collapse_prompt,
+                verbose=verbose,  # type: ignore[arg-type]
+                callback_manager=callback_manager,
+                callbacks=callbacks,
+            ),
+            document_variable_name=combine_document_variable_name,
+            verbose=verbose,  # type: ignore[arg-type]
+            callback_manager=callback_manager,
+        )
+    reduce_documents_chain = ReduceDocumentsChain(  # type: ignore[misc]
+        combine_documents_chain=combine_documents_chain,
+        collapse_documents_chain=collapse_chain,
+        token_max=token_max,
+        verbose=verbose,
+    )
+    return MapReduceDocumentsChain(
+        llm_chain=map_chain,
+        document_variable_name=map_reduce_document_variable_name,
+        reduce_documents_chain=reduce_documents_chain,
+        verbose=verbose,  # type: ignore[arg-type]
+        callback_manager=callback_manager,
+        callbacks=callbacks,
+        **kwargs,
+    )
+
+
+def _load_refine_chain(
+    llm: BaseLanguageModel,
+    question_prompt: Optional[BasePromptTemplate] = None,
+    refine_prompt: Optional[BasePromptTemplate] = None,
+    document_variable_name: str = "context_str",
+    initial_response_name: str = "existing_answer",
+    refine_llm: Optional[BaseLanguageModel] = None,
+    verbose: Optional[bool] = None,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    callbacks: Callbacks = None,
+    **kwargs: Any,
+) -> RefineDocumentsChain:
+    _question_prompt = (
+        question_prompt or refine_prompts.QUESTION_PROMPT_SELECTOR.get_prompt(llm)
+    )
+    _refine_prompt = refine_prompt or refine_prompts.REFINE_PROMPT_SELECTOR.get_prompt(
+        llm
+    )
+    initial_chain = LLMChain(
+        llm=llm,
+        prompt=_question_prompt,
+        verbose=verbose,  # type: ignore[arg-type]
+        callback_manager=callback_manager,
+        callbacks=callbacks,
+    )
+    _refine_llm = refine_llm or llm
+    refine_chain = LLMChain(
+        llm=_refine_llm,
+        prompt=_refine_prompt,
+        verbose=verbose,  # type: ignore[arg-type]
+        callback_manager=callback_manager,
+        callbacks=callbacks,
+    )
+    return RefineDocumentsChain(
+        initial_llm_chain=initial_chain,
+        refine_llm_chain=refine_chain,
+        document_variable_name=document_variable_name,
+        initial_response_name=initial_response_name,
+        verbose=verbose,  # type: ignore[arg-type]
+        callback_manager=callback_manager,
+        callbacks=callbacks,
+        **kwargs,
+    )
+
+
+def load_qa_chain(
+    llm: BaseLanguageModel,
+    chain_type: str = "stuff",
+    verbose: Optional[bool] = None,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    **kwargs: Any,
+) -> BaseCombineDocumentsChain:
+    """Load question answering chain.
+
+    Args:
+        llm: Language Model to use in the chain.
+        chain_type: Type of document combining chain to use. Should be one of "stuff",
+            "map_reduce", "map_rerank", and "refine".
+        verbose: Whether chains should be run in verbose mode or not. Note that this
+            applies to all chains that make up the final chain.
+        callback_manager: Callback manager to use for the chain.
+
+    Returns:
+        A chain to use for question answering.
+    """
+    loader_mapping: Mapping[str, LoadingCallable] = {
+        "stuff": _load_stuff_chain,
+        "map_reduce": _load_map_reduce_chain,
+        "refine": _load_refine_chain,
+        "map_rerank": _load_map_rerank_chain,
+    }
+    if chain_type not in loader_mapping:
+        raise ValueError(
+            f"Got unsupported chain type: {chain_type}. "
+            f"Should be one of {loader_mapping.keys()}"
+        )
+    return loader_mapping[chain_type](
+        llm, verbose=verbose, callback_manager=callback_manager, **kwargs
+    )
diff --git a/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0c87f417cb5299c3015c16709387df0a6974fc5b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/map_reduce_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/map_reduce_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f80605b8d0184ec47ea00d613832085270f1ce1e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/map_reduce_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/map_rerank_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/map_rerank_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ac9d5e03a4b80b60181fc6ac1249238938dd50d7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/map_rerank_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/refine_prompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/refine_prompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ae19767d366ef73625d886a2ab0b5a8e63b56fc1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/refine_prompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/stuff_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/stuff_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..badd88ee5b7b0ed147486b67b0aed63063a4c89e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/question_answering/__pycache__/stuff_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/question_answering/map_reduce_prompt.py b/llm/Lib/site-packages/langchain/chains/question_answering/map_reduce_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..defaa8fea7bbe9e21062fbe9155b21bca019c148
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/question_answering/map_reduce_prompt.py
@@ -0,0 +1,80 @@
+# flake8: noqa
+from langchain.chains.prompt_selector import ConditionalPromptSelector, is_chat_model
+from langchain_core.prompts.chat import (
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+    SystemMessagePromptTemplate,
+)
+from langchain_core.prompts.prompt import PromptTemplate
+
+question_prompt_template = """Use the following portion of a long document to see if any of the text is relevant to answer the question. 
+Return any relevant text verbatim.
+{context}
+Question: {question}
+Relevant text, if any:"""
+QUESTION_PROMPT = PromptTemplate(
+    template=question_prompt_template, input_variables=["context", "question"]
+)
+system_template = """Use the following portion of a long document to see if any of the text is relevant to answer the question. 
+Return any relevant text verbatim.
+______________________
+{context}"""
+messages = [
+    SystemMessagePromptTemplate.from_template(system_template),
+    HumanMessagePromptTemplate.from_template("{question}"),
+]
+CHAT_QUESTION_PROMPT = ChatPromptTemplate.from_messages(messages)
+
+
+QUESTION_PROMPT_SELECTOR = ConditionalPromptSelector(
+    default_prompt=QUESTION_PROMPT, conditionals=[(is_chat_model, CHAT_QUESTION_PROMPT)]
+)
+
+combine_prompt_template = """Given the following extracted parts of a long document and a question, create a final answer. 
+If you don't know the answer, just say that you don't know. Don't try to make up an answer.
+
+QUESTION: Which state/country's law governs the interpretation of the contract?
+=========
+Content: This Agreement is governed by English law and the parties submit to the exclusive jurisdiction of the English courts in  relation to any dispute (contractual or non-contractual) concerning this Agreement save that either party may apply to any court for an  injunction or other relief to protect its Intellectual Property Rights.
+
+Content: No Waiver. Failure or delay in exercising any right or remedy under this Agreement shall not constitute a waiver of such (or any other)  right or remedy.\n\n11.7 Severability. The invalidity, illegality or unenforceability of any term (or part of a term) of this Agreement shall not affect the continuation  in force of the remainder of the term (if any) and this Agreement.\n\n11.8 No Agency. Except as expressly stated otherwise, nothing in this Agreement shall create an agency, partnership or joint venture of any  kind between the parties.\n\n11.9 No Third-Party Beneficiaries.
+
+Content: (b) if Google believes, in good faith, that the Distributor has violated or caused Google to violate any Anti-Bribery Laws (as  defined in Clause 8.5) or that such a violation is reasonably likely to occur,
+=========
+FINAL ANSWER: This Agreement is governed by English law.
+
+QUESTION: What did the president say about Michael Jackson?
+=========
+Content: Madam Speaker, Madam Vice President, our First Lady and Second Gentleman. Members of Congress and the Cabinet. Justices of the Supreme Court. My fellow Americans.  \n\nLast year COVID-19 kept us apart. This year we are finally together again. \n\nTonight, we meet as Democrats Republicans and Independents. But most importantly as Americans. \n\nWith a duty to one another to the American people to the Constitution. \n\nAnd with an unwavering resolve that freedom will always triumph over tyranny. \n\nSix days ago, Russia’s Vladimir Putin sought to shake the foundations of the free world thinking he could make it bend to his menacing ways. But he badly miscalculated. \n\nHe thought he could roll into Ukraine and the world would roll over. Instead he met a wall of strength he never imagined. \n\nHe met the Ukrainian people. \n\nFrom President Zelenskyy to every Ukrainian, their fearlessness, their courage, their determination, inspires the world. \n\nGroups of citizens blocking tanks with their bodies. Everyone from students to retirees teachers turned soldiers defending their homeland.
+
+Content: And we won’t stop. \n\nWe have lost so much to COVID-19. Time with one another. And worst of all, so much loss of life. \n\nLet’s use this moment to reset. Let’s stop looking at COVID-19 as a partisan dividing line and see it for what it is: A God-awful disease.  \n\nLet’s stop seeing each other as enemies, and start seeing each other for who we really are: Fellow Americans.  \n\nWe can’t change how divided we’ve been. But we can change how we move forward—on COVID-19 and other issues we must face together. \n\nI recently visited the New York City Police Department days after the funerals of Officer Wilbert Mora and his partner, Officer Jason Rivera. \n\nThey were responding to a 9-1-1 call when a man shot and killed them with a stolen gun. \n\nOfficer Mora was 27 years old. \n\nOfficer Rivera was 22. \n\nBoth Dominican Americans who’d grown up on the same streets they later chose to patrol as police officers. \n\nI spoke with their families and told them that we are forever in debt for their sacrifice, and we will carry on their mission to restore the trust and safety every community deserves.
+
+Content: And a proud Ukrainian people, who have known 30 years  of independence, have repeatedly shown that they will not tolerate anyone who tries to take their country backwards.  \n\nTo all Americans, I will be honest with you, as I’ve always promised. A Russian dictator, invading a foreign country, has costs around the world. \n\nAnd I’m taking robust action to make sure the pain of our sanctions  is targeted at Russia’s economy. And I will use every tool at our disposal to protect American businesses and consumers. \n\nTonight, I can announce that the United States has worked with 30 other countries to release 60 Million barrels of oil from reserves around the world.  \n\nAmerica will lead that effort, releasing 30 Million barrels from our own Strategic Petroleum Reserve. And we stand ready to do more if necessary, unified with our allies.  \n\nThese steps will help blunt gas prices here at home. And I know the news about what’s happening can seem alarming. \n\nBut I want you to know that we are going to be okay.
+
+Content: More support for patients and families. \n\nTo get there, I call on Congress to fund ARPA-H, the Advanced Research Projects Agency for Health. \n\nIt’s based on DARPA—the Defense Department project that led to the Internet, GPS, and so much more.  \n\nARPA-H will have a singular purpose—to drive breakthroughs in cancer, Alzheimer’s, diabetes, and more. \n\nA unity agenda for the nation. \n\nWe can do this. \n\nMy fellow Americans—tonight , we have gathered in a sacred space—the citadel of our democracy. \n\nIn this Capitol, generation after generation, Americans have debated great questions amid great strife, and have done great things. \n\nWe have fought for freedom, expanded liberty, defeated totalitarianism and terror. \n\nAnd built the strongest, freest, and most prosperous nation the world has ever known. \n\nNow is the hour. \n\nOur moment of responsibility. \n\nOur test of resolve and conscience, of history itself. \n\nIt is in this moment that our character is formed. Our purpose is found. Our future is forged. \n\nWell I know this nation.
+=========
+FINAL ANSWER: The president did not mention Michael Jackson.
+
+QUESTION: {question}
+=========
+{summaries}
+=========
+FINAL ANSWER:"""
+COMBINE_PROMPT = PromptTemplate(
+    template=combine_prompt_template, input_variables=["summaries", "question"]
+)
+
+system_template = """Given the following extracted parts of a long document and a question, create a final answer. 
+If you don't know the answer, just say that you don't know. Don't try to make up an answer.
+______________________
+{summaries}"""
+messages = [
+    SystemMessagePromptTemplate.from_template(system_template),
+    HumanMessagePromptTemplate.from_template("{question}"),
+]
+CHAT_COMBINE_PROMPT = ChatPromptTemplate.from_messages(messages)
+
+
+COMBINE_PROMPT_SELECTOR = ConditionalPromptSelector(
+    default_prompt=COMBINE_PROMPT, conditionals=[(is_chat_model, CHAT_COMBINE_PROMPT)]
+)
diff --git a/llm/Lib/site-packages/langchain/chains/question_answering/map_rerank_prompt.py b/llm/Lib/site-packages/langchain/chains/question_answering/map_rerank_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..f9547385f9267387807b99cbc1b0fd5c6834e44e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/question_answering/map_rerank_prompt.py
@@ -0,0 +1,66 @@
+# flake8: noqa
+from langchain.output_parsers.regex import RegexParser
+from langchain_core.prompts import PromptTemplate
+
+output_parser = RegexParser(
+    regex=r"(.*?)\nScore: (\d*)",
+    output_keys=["answer", "score"],
+)
+
+prompt_template = """Use the following pieces of context to answer the question at the end. If you don't know the answer, just say that you don't know, don't try to make up an answer.
+
+In addition to giving an answer, also return a score of how fully it answered the user's question. This should be in the following format:
+
+Question: [question here]
+Helpful Answer: [answer here]
+Score: [score between 0 and 100]
+
+How to determine the score:
+- Higher is a better answer
+- Better responds fully to the asked question, with sufficient level of detail
+- If you do not know the answer based on the context, that should be a score of 0
+- Don't be overconfident!
+
+Example #1
+
+Context:
+---------
+Apples are red
+---------
+Question: what color are apples?
+Helpful Answer: red
+Score: 100
+
+Example #2
+
+Context:
+---------
+it was night and the witness forgot his glasses. he was not sure if it was a sports car or an suv
+---------
+Question: what type was the car?
+Helpful Answer: a sports car or an suv
+Score: 60
+
+Example #3
+
+Context:
+---------
+Pears are either red or orange
+---------
+Question: what color are apples?
+Helpful Answer: This document does not answer the question
+Score: 0
+
+Begin!
+
+Context:
+---------
+{context}
+---------
+Question: {question}
+Helpful Answer:"""
+PROMPT = PromptTemplate(
+    template=prompt_template,
+    input_variables=["context", "question"],
+    output_parser=output_parser,
+)
diff --git a/llm/Lib/site-packages/langchain/chains/question_answering/refine_prompts.py b/llm/Lib/site-packages/langchain/chains/question_answering/refine_prompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed4d4417fb7d303bad669a0cdeada6744e80c843
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/question_answering/refine_prompts.py
@@ -0,0 +1,68 @@
+# flake8: noqa
+from langchain.chains.prompt_selector import ConditionalPromptSelector, is_chat_model
+from langchain_core.prompts.chat import (
+    AIMessagePromptTemplate,
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+    SystemMessagePromptTemplate,
+)
+from langchain_core.prompts.prompt import PromptTemplate
+
+DEFAULT_REFINE_PROMPT_TMPL = (
+    "The original question is as follows: {question}\n"
+    "We have provided an existing answer: {existing_answer}\n"
+    "We have the opportunity to refine the existing answer "
+    "(only if needed) with some more context below.\n"
+    "------------\n"
+    "{context_str}\n"
+    "------------\n"
+    "Given the new context, refine the original answer to better "
+    "answer the question. "
+    "If the context isn't useful, return the original answer."
+)
+DEFAULT_REFINE_PROMPT = PromptTemplate.from_template(DEFAULT_REFINE_PROMPT_TMPL)
+
+refine_template = (
+    "We have the opportunity to refine the existing answer "
+    "(only if needed) with some more context below.\n"
+    "------------\n"
+    "{context_str}\n"
+    "------------\n"
+    "Given the new context, refine the original answer to better "
+    "answer the question. "
+    "If the context isn't useful, return the original answer."
+)
+CHAT_REFINE_PROMPT = ChatPromptTemplate.from_messages(
+    [("human", "{question}"), ("ai", "{existing_answer}"), ("human", refine_template)]
+)
+REFINE_PROMPT_SELECTOR = ConditionalPromptSelector(
+    default_prompt=DEFAULT_REFINE_PROMPT,
+    conditionals=[(is_chat_model, CHAT_REFINE_PROMPT)],
+)
+
+
+DEFAULT_TEXT_QA_PROMPT_TMPL = (
+    "Context information is below. \n"
+    "------------\n"
+    "{context_str}\n"
+    "------------\n"
+    "Given the context information and not prior knowledge, "
+    "answer the question: {question}\n"
+)
+DEFAULT_TEXT_QA_PROMPT = PromptTemplate.from_template(DEFAULT_TEXT_QA_PROMPT_TMPL)
+
+chat_qa_prompt_template = (
+    "Context information is below.\n"
+    "------------\n"
+    "{context_str}\n"
+    "------------\n"
+    "Given the context information and not prior knowledge, "
+    "answer any questions"
+)
+CHAT_QUESTION_PROMPT = ChatPromptTemplate.from_messages(
+    [("system", chat_qa_prompt_template), ("human", "{question}")]
+)
+QUESTION_PROMPT_SELECTOR = ConditionalPromptSelector(
+    default_prompt=DEFAULT_TEXT_QA_PROMPT,
+    conditionals=[(is_chat_model, CHAT_QUESTION_PROMPT)],
+)
diff --git a/llm/Lib/site-packages/langchain/chains/question_answering/stuff_prompt.py b/llm/Lib/site-packages/langchain/chains/question_answering/stuff_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..ee0064338526491beadb858657f1171fa1a839f5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/question_answering/stuff_prompt.py
@@ -0,0 +1,33 @@
+# flake8: noqa
+from langchain.chains.prompt_selector import ConditionalPromptSelector, is_chat_model
+from langchain_core.prompts import PromptTemplate
+from langchain_core.prompts.chat import (
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+    SystemMessagePromptTemplate,
+)
+
+prompt_template = """Use the following pieces of context to answer the question at the end. If you don't know the answer, just say that you don't know, don't try to make up an answer.
+
+{context}
+
+Question: {question}
+Helpful Answer:"""
+PROMPT = PromptTemplate(
+    template=prompt_template, input_variables=["context", "question"]
+)
+
+system_template = """Use the following pieces of context to answer the user's question. 
+If you don't know the answer, just say that you don't know, don't try to make up an answer.
+----------------
+{context}"""
+messages = [
+    SystemMessagePromptTemplate.from_template(system_template),
+    HumanMessagePromptTemplate.from_template("{question}"),
+]
+CHAT_PROMPT = ChatPromptTemplate.from_messages(messages)
+
+
+PROMPT_SELECTOR = ConditionalPromptSelector(
+    default_prompt=PROMPT, conditionals=[(is_chat_model, CHAT_PROMPT)]
+)
diff --git a/llm/Lib/site-packages/langchain/chains/retrieval.py b/llm/Lib/site-packages/langchain/chains/retrieval.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d6af26cdf67537665a94027f0f19101ff2e6f86
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/retrieval.py
@@ -0,0 +1,69 @@
+from __future__ import annotations
+
+from typing import Any, Dict, Union
+
+from langchain_core.retrievers import (
+    BaseRetriever,
+    RetrieverOutput,
+)
+from langchain_core.runnables import Runnable, RunnablePassthrough
+
+
+def create_retrieval_chain(
+    retriever: Union[BaseRetriever, Runnable[dict, RetrieverOutput]],
+    combine_docs_chain: Runnable[Dict[str, Any], str],
+) -> Runnable:
+    """Create retrieval chain that retrieves documents and then passes them on.
+
+    Args:
+        retriever: Retriever-like object that returns list of documents. Should
+            either be a subclass of BaseRetriever or a Runnable that returns
+            a list of documents. If a subclass of BaseRetriever, then it
+            is expected that an `input` key be passed in - this is what
+            is will be used to pass into the retriever. If this is NOT a
+            subclass of BaseRetriever, then all the inputs will be passed
+            into this runnable, meaning that runnable should take a dictionary
+            as input.
+        combine_docs_chain: Runnable that takes inputs and produces a string output.
+            The inputs to this will be any original inputs to this chain, a new
+            context key with the retrieved documents, and chat_history (if not present
+            in the inputs) with a value of `[]` (to easily enable conversational
+            retrieval.
+
+    Returns:
+        An LCEL Runnable. The Runnable return is a dictionary containing at the very
+        least a `context` and `answer` key.
+
+    Example:
+        .. code-block:: python
+
+            # pip install -U langchain langchain-community
+
+            from langchain_community.chat_models import ChatOpenAI
+            from langchain.chains.combine_documents import create_stuff_documents_chain
+            from langchain.chains import create_retrieval_chain
+            from langchain import hub
+
+            retrieval_qa_chat_prompt = hub.pull("langchain-ai/retrieval-qa-chat")
+            llm = ChatOpenAI()
+            retriever = ...
+            combine_docs_chain = create_stuff_documents_chain(
+                llm, retrieval_qa_chat_prompt
+            )
+            retrieval_chain = create_retrieval_chain(retriever, combine_docs_chain)
+
+            chain.invoke({"input": "..."})
+
+    """
+    if not isinstance(retriever, BaseRetriever):
+        retrieval_docs: Runnable[dict, RetrieverOutput] = retriever
+    else:
+        retrieval_docs = (lambda x: x["input"]) | retriever
+
+    retrieval_chain = (
+        RunnablePassthrough.assign(
+            context=retrieval_docs.with_config(run_name="retrieve_documents"),
+        ).assign(answer=combine_docs_chain)
+    ).with_config(run_name="retrieval_chain")
+
+    return retrieval_chain
diff --git a/llm/Lib/site-packages/langchain/chains/retrieval_qa/__init__.py b/llm/Lib/site-packages/langchain/chains/retrieval_qa/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b8e4d9aa0b2012d66851b2ef64073efd2b807a70
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/retrieval_qa/__init__.py
@@ -0,0 +1 @@
+"""Chain for question-answering against a vector database."""
diff --git a/llm/Lib/site-packages/langchain/chains/retrieval_qa/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/retrieval_qa/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a73142d99c29d692a39f9c23d074cf82ac5e0ccd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/retrieval_qa/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/retrieval_qa/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/retrieval_qa/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..26db62cce2b40802b1e4e63d11c28950b460443e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/retrieval_qa/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/retrieval_qa/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/retrieval_qa/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e99f042ba967decd83326a1b661a5be3ceeb5024
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/retrieval_qa/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/retrieval_qa/base.py b/llm/Lib/site-packages/langchain/chains/retrieval_qa/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..392a0b2cc442fc744e64739e1f58a5fe24b16f63
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/retrieval_qa/base.py
@@ -0,0 +1,302 @@
+"""Chain for question-answering against a vector database."""
+from __future__ import annotations
+
+import inspect
+import warnings
+from abc import abstractmethod
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+    Callbacks,
+)
+from langchain_core.documents import Document
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import PromptTemplate
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.vectorstores import VectorStore
+
+from langchain.chains.base import Chain
+from langchain.chains.combine_documents.base import BaseCombineDocumentsChain
+from langchain.chains.combine_documents.stuff import StuffDocumentsChain
+from langchain.chains.llm import LLMChain
+from langchain.chains.question_answering import load_qa_chain
+from langchain.chains.question_answering.stuff_prompt import PROMPT_SELECTOR
+
+
+class BaseRetrievalQA(Chain):
+    """Base class for question-answering chains."""
+
+    combine_documents_chain: BaseCombineDocumentsChain
+    """Chain to use to combine the documents."""
+    input_key: str = "query"  #: :meta private:
+    output_key: str = "result"  #: :meta private:
+    return_source_documents: bool = False
+    """Return the source documents or not."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+        allow_population_by_field_name = True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Input keys.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Output keys.
+
+        :meta private:
+        """
+        _output_keys = [self.output_key]
+        if self.return_source_documents:
+            _output_keys = _output_keys + ["source_documents"]
+        return _output_keys
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        prompt: Optional[PromptTemplate] = None,
+        callbacks: Callbacks = None,
+        llm_chain_kwargs: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> BaseRetrievalQA:
+        """Initialize from LLM."""
+        _prompt = prompt or PROMPT_SELECTOR.get_prompt(llm)
+        llm_chain = LLMChain(
+            llm=llm, prompt=_prompt, callbacks=callbacks, **(llm_chain_kwargs or {})
+        )
+        document_prompt = PromptTemplate(
+            input_variables=["page_content"], template="Context:\n{page_content}"
+        )
+        combine_documents_chain = StuffDocumentsChain(
+            llm_chain=llm_chain,
+            document_variable_name="context",
+            document_prompt=document_prompt,
+            callbacks=callbacks,
+        )
+
+        return cls(
+            combine_documents_chain=combine_documents_chain,
+            callbacks=callbacks,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_chain_type(
+        cls,
+        llm: BaseLanguageModel,
+        chain_type: str = "stuff",
+        chain_type_kwargs: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> BaseRetrievalQA:
+        """Load chain from chain type."""
+        _chain_type_kwargs = chain_type_kwargs or {}
+        combine_documents_chain = load_qa_chain(
+            llm, chain_type=chain_type, **_chain_type_kwargs
+        )
+        return cls(combine_documents_chain=combine_documents_chain, **kwargs)
+
+    @abstractmethod
+    def _get_docs(
+        self,
+        question: str,
+        *,
+        run_manager: CallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get documents to do question answering over."""
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Run get_relevant_text and llm on input query.
+
+        If chain has 'return_source_documents' as 'True', returns
+        the retrieved documents as well under the key 'source_documents'.
+
+        Example:
+        .. code-block:: python
+
+        res = indexqa({'query': 'This is my query'})
+        answer, docs = res['result'], res['source_documents']
+        """
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        question = inputs[self.input_key]
+        accepts_run_manager = (
+            "run_manager" in inspect.signature(self._get_docs).parameters
+        )
+        if accepts_run_manager:
+            docs = self._get_docs(question, run_manager=_run_manager)
+        else:
+            docs = self._get_docs(question)  # type: ignore[call-arg]
+        answer = self.combine_documents_chain.run(
+            input_documents=docs, question=question, callbacks=_run_manager.get_child()
+        )
+
+        if self.return_source_documents:
+            return {self.output_key: answer, "source_documents": docs}
+        else:
+            return {self.output_key: answer}
+
+    @abstractmethod
+    async def _aget_docs(
+        self,
+        question: str,
+        *,
+        run_manager: AsyncCallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get documents to do question answering over."""
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Run get_relevant_text and llm on input query.
+
+        If chain has 'return_source_documents' as 'True', returns
+        the retrieved documents as well under the key 'source_documents'.
+
+        Example:
+        .. code-block:: python
+
+        res = indexqa({'query': 'This is my query'})
+        answer, docs = res['result'], res['source_documents']
+        """
+        _run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()
+        question = inputs[self.input_key]
+        accepts_run_manager = (
+            "run_manager" in inspect.signature(self._aget_docs).parameters
+        )
+        if accepts_run_manager:
+            docs = await self._aget_docs(question, run_manager=_run_manager)
+        else:
+            docs = await self._aget_docs(question)  # type: ignore[call-arg]
+        answer = await self.combine_documents_chain.arun(
+            input_documents=docs, question=question, callbacks=_run_manager.get_child()
+        )
+
+        if self.return_source_documents:
+            return {self.output_key: answer, "source_documents": docs}
+        else:
+            return {self.output_key: answer}
+
+
+class RetrievalQA(BaseRetrievalQA):
+    """Chain for question-answering against an index.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import OpenAI
+            from langchain.chains import RetrievalQA
+            from langchain_community.vectorstores import FAISS
+            from langchain_core.vectorstores import VectorStoreRetriever
+            retriever = VectorStoreRetriever(vectorstore=FAISS(...))
+            retrievalQA = RetrievalQA.from_llm(llm=OpenAI(), retriever=retriever)
+
+    """
+
+    retriever: BaseRetriever = Field(exclude=True)
+
+    def _get_docs(
+        self,
+        question: str,
+        *,
+        run_manager: CallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs."""
+        return self.retriever.get_relevant_documents(
+            question, callbacks=run_manager.get_child()
+        )
+
+    async def _aget_docs(
+        self,
+        question: str,
+        *,
+        run_manager: AsyncCallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs."""
+        return await self.retriever.aget_relevant_documents(
+            question, callbacks=run_manager.get_child()
+        )
+
+    @property
+    def _chain_type(self) -> str:
+        """Return the chain type."""
+        return "retrieval_qa"
+
+
+class VectorDBQA(BaseRetrievalQA):
+    """Chain for question-answering against a vector database."""
+
+    vectorstore: VectorStore = Field(exclude=True, alias="vectorstore")
+    """Vector Database to connect to."""
+    k: int = 4
+    """Number of documents to query for."""
+    search_type: str = "similarity"
+    """Search type to use over vectorstore. `similarity` or `mmr`."""
+    search_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Extra search args."""
+
+    @root_validator()
+    def raise_deprecation(cls, values: Dict) -> Dict:
+        warnings.warn(
+            "`VectorDBQA` is deprecated - "
+            "please use `from langchain.chains import RetrievalQA`"
+        )
+        return values
+
+    @root_validator()
+    def validate_search_type(cls, values: Dict) -> Dict:
+        """Validate search type."""
+        if "search_type" in values:
+            search_type = values["search_type"]
+            if search_type not in ("similarity", "mmr"):
+                raise ValueError(f"search_type of {search_type} not allowed.")
+        return values
+
+    def _get_docs(
+        self,
+        question: str,
+        *,
+        run_manager: CallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs."""
+        if self.search_type == "similarity":
+            docs = self.vectorstore.similarity_search(
+                question, k=self.k, **self.search_kwargs
+            )
+        elif self.search_type == "mmr":
+            docs = self.vectorstore.max_marginal_relevance_search(
+                question, k=self.k, **self.search_kwargs
+            )
+        else:
+            raise ValueError(f"search_type of {self.search_type} not allowed.")
+        return docs
+
+    async def _aget_docs(
+        self,
+        question: str,
+        *,
+        run_manager: AsyncCallbackManagerForChainRun,
+    ) -> List[Document]:
+        """Get docs."""
+        raise NotImplementedError("VectorDBQA does not support async")
+
+    @property
+    def _chain_type(self) -> str:
+        """Return the chain type."""
+        return "vector_db_qa"
diff --git a/llm/Lib/site-packages/langchain/chains/retrieval_qa/prompt.py b/llm/Lib/site-packages/langchain/chains/retrieval_qa/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..963c353184e00469d69fcda726e4a4f36a06f1f1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/retrieval_qa/prompt.py
@@ -0,0 +1,12 @@
+# flake8: noqa
+from langchain_core.prompts import PromptTemplate
+
+prompt_template = """Use the following pieces of context to answer the question at the end. If you don't know the answer, just say that you don't know, don't try to make up an answer.
+
+{context}
+
+Question: {question}
+Helpful Answer:"""
+PROMPT = PromptTemplate(
+    template=prompt_template, input_variables=["context", "question"]
+)
diff --git a/llm/Lib/site-packages/langchain/chains/router/__init__.py b/llm/Lib/site-packages/langchain/chains/router/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5ccd5eac9e574d842e4a4ac7c2cf21f67254d558
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/router/__init__.py
@@ -0,0 +1,12 @@
+from langchain.chains.router.base import MultiRouteChain, RouterChain
+from langchain.chains.router.llm_router import LLMRouterChain
+from langchain.chains.router.multi_prompt import MultiPromptChain
+from langchain.chains.router.multi_retrieval_qa import MultiRetrievalQAChain
+
+__all__ = [
+    "RouterChain",
+    "MultiRouteChain",
+    "MultiPromptChain",
+    "MultiRetrievalQAChain",
+    "LLMRouterChain",
+]
diff --git a/llm/Lib/site-packages/langchain/chains/router/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/router/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..497a3e7af97b8c7c2a500ecfdb851b83708fa845
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/router/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/router/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/router/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e3a83744e4eb21948a445c0cf3ff78136273c1c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/router/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/router/__pycache__/embedding_router.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/router/__pycache__/embedding_router.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..18385d68fa5a275dc03f649a3ec2b0ce5ebb7fa2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/router/__pycache__/embedding_router.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/router/__pycache__/llm_router.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/router/__pycache__/llm_router.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..066bb8148ca7d79f4a350a124e9730d2290690ed
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/router/__pycache__/llm_router.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/router/__pycache__/multi_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/router/__pycache__/multi_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cc1a003b466ea38a65a0ce678fb54d5f6ed5c118
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/router/__pycache__/multi_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/router/__pycache__/multi_prompt_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/router/__pycache__/multi_prompt_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..62f37faf2930e0955c04f64e03cfc3d273726b51
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/router/__pycache__/multi_prompt_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/router/__pycache__/multi_retrieval_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/router/__pycache__/multi_retrieval_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fa8a0cfd9fd954050ea1cdf3c7c5c331a14ea3a5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/router/__pycache__/multi_retrieval_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/router/__pycache__/multi_retrieval_qa.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/router/__pycache__/multi_retrieval_qa.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1122746579074b53e38814d22b13ff3aad2dc9aa
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/router/__pycache__/multi_retrieval_qa.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/router/base.py b/llm/Lib/site-packages/langchain/chains/router/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..e6a9788d0f6dd3fb20409278403720cc5c91622b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/router/base.py
@@ -0,0 +1,137 @@
+"""Base classes for chain routing."""
+from __future__ import annotations
+
+from abc import ABC
+from typing import Any, Dict, List, Mapping, NamedTuple, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+    Callbacks,
+)
+from langchain_core.pydantic_v1 import Extra
+
+from langchain.chains.base import Chain
+
+
+class Route(NamedTuple):
+    destination: Optional[str]
+    next_inputs: Dict[str, Any]
+
+
+class RouterChain(Chain, ABC):
+    """Chain that outputs the name of a destination chain and the inputs to it."""
+
+    @property
+    def output_keys(self) -> List[str]:
+        return ["destination", "next_inputs"]
+
+    def route(self, inputs: Dict[str, Any], callbacks: Callbacks = None) -> Route:
+        """
+        Route inputs to a destination chain.
+
+        Args:
+            inputs: inputs to the chain
+            callbacks: callbacks to use for the chain
+
+        Returns:
+            a Route object
+        """
+        result = self(inputs, callbacks=callbacks)
+        return Route(result["destination"], result["next_inputs"])
+
+    async def aroute(
+        self, inputs: Dict[str, Any], callbacks: Callbacks = None
+    ) -> Route:
+        result = await self.acall(inputs, callbacks=callbacks)
+        return Route(result["destination"], result["next_inputs"])
+
+
+class MultiRouteChain(Chain):
+    """Use a single chain to route an input to one of multiple candidate chains."""
+
+    router_chain: RouterChain
+    """Chain that routes inputs to destination chains."""
+    destination_chains: Mapping[str, Chain]
+    """Chains that return final answer to inputs."""
+    default_chain: Chain
+    """Default chain to use when none of the destination chains are suitable."""
+    silent_errors: bool = False
+    """If True, use default_chain when an invalid destination name is provided. 
+    Defaults to False."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Will be whatever keys the router chain prompt expects.
+
+        :meta private:
+        """
+        return self.router_chain.input_keys
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Will always return text key.
+
+        :meta private:
+        """
+        return []
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        route = self.router_chain.route(inputs, callbacks=callbacks)
+
+        _run_manager.on_text(
+            str(route.destination) + ": " + str(route.next_inputs), verbose=self.verbose
+        )
+        if not route.destination:
+            return self.default_chain(route.next_inputs, callbacks=callbacks)
+        elif route.destination in self.destination_chains:
+            return self.destination_chains[route.destination](
+                route.next_inputs, callbacks=callbacks
+            )
+        elif self.silent_errors:
+            return self.default_chain(route.next_inputs, callbacks=callbacks)
+        else:
+            raise ValueError(
+                f"Received invalid destination chain name '{route.destination}'"
+            )
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        _run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        route = await self.router_chain.aroute(inputs, callbacks=callbacks)
+
+        await _run_manager.on_text(
+            str(route.destination) + ": " + str(route.next_inputs), verbose=self.verbose
+        )
+        if not route.destination:
+            return await self.default_chain.acall(
+                route.next_inputs, callbacks=callbacks
+            )
+        elif route.destination in self.destination_chains:
+            return await self.destination_chains[route.destination].acall(
+                route.next_inputs, callbacks=callbacks
+            )
+        elif self.silent_errors:
+            return await self.default_chain.acall(
+                route.next_inputs, callbacks=callbacks
+            )
+        else:
+            raise ValueError(
+                f"Received invalid destination chain name '{route.destination}'"
+            )
diff --git a/llm/Lib/site-packages/langchain/chains/router/embedding_router.py b/llm/Lib/site-packages/langchain/chains/router/embedding_router.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7fb59f8522f2740cbe2aab319ab50464a0b1397
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/router/embedding_router.py
@@ -0,0 +1,89 @@
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional, Sequence, Tuple, Type
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+)
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import Extra
+from langchain_core.vectorstores import VectorStore
+
+from langchain.chains.router.base import RouterChain
+
+
+class EmbeddingRouterChain(RouterChain):
+    """Chain that uses embeddings to route between options."""
+
+    vectorstore: VectorStore
+    routing_keys: List[str] = ["query"]
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Will be whatever keys the LLM chain prompt expects.
+
+        :meta private:
+        """
+        return self.routing_keys
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        _input = ", ".join([inputs[k] for k in self.routing_keys])
+        results = self.vectorstore.similarity_search(_input, k=1)
+        return {"next_inputs": inputs, "destination": results[0].metadata["name"]}
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        _input = ", ".join([inputs[k] for k in self.routing_keys])
+        results = await self.vectorstore.asimilarity_search(_input, k=1)
+        return {"next_inputs": inputs, "destination": results[0].metadata["name"]}
+
+    @classmethod
+    def from_names_and_descriptions(
+        cls,
+        names_and_descriptions: Sequence[Tuple[str, Sequence[str]]],
+        vectorstore_cls: Type[VectorStore],
+        embeddings: Embeddings,
+        **kwargs: Any,
+    ) -> EmbeddingRouterChain:
+        """Convenience constructor."""
+        documents = []
+        for name, descriptions in names_and_descriptions:
+            for description in descriptions:
+                documents.append(
+                    Document(page_content=description, metadata={"name": name})
+                )
+        vectorstore = vectorstore_cls.from_documents(documents, embeddings)
+        return cls(vectorstore=vectorstore, **kwargs)
+
+    @classmethod
+    async def afrom_names_and_descriptions(
+        cls,
+        names_and_descriptions: Sequence[Tuple[str, Sequence[str]]],
+        vectorstore_cls: Type[VectorStore],
+        embeddings: Embeddings,
+        **kwargs: Any,
+    ) -> EmbeddingRouterChain:
+        """Convenience constructor."""
+        documents = []
+        for name, descriptions in names_and_descriptions:
+            for description in descriptions:
+                documents.append(
+                    Document(page_content=description, metadata={"name": name})
+                )
+        vectorstore = await vectorstore_cls.afrom_documents(documents, embeddings)
+        return cls(vectorstore=vectorstore, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/chains/router/llm_router.py b/llm/Lib/site-packages/langchain/chains/router/llm_router.py
new file mode 100644
index 0000000000000000000000000000000000000000..dd10c155742eb3e4e3c9bd3c129bbebb29b52bd8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/router/llm_router.py
@@ -0,0 +1,118 @@
+"""Base classes for LLM-powered router chains."""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional, Type, cast
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+)
+from langchain_core.exceptions import OutputParserException
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import root_validator
+
+from langchain.chains import LLMChain
+from langchain.chains.router.base import RouterChain
+from langchain.output_parsers.json import parse_and_check_json_markdown
+
+
+class LLMRouterChain(RouterChain):
+    """A router chain that uses an LLM chain to perform routing."""
+
+    llm_chain: LLMChain
+    """LLM chain used to perform routing"""
+
+    @root_validator()
+    def validate_prompt(cls, values: dict) -> dict:
+        prompt = values["llm_chain"].prompt
+        if prompt.output_parser is None:
+            raise ValueError(
+                "LLMRouterChain requires base llm_chain prompt to have an output"
+                " parser that converts LLM text output to a dictionary with keys"
+                " 'destination' and 'next_inputs'. Received a prompt with no output"
+                " parser."
+            )
+        return values
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Will be whatever keys the LLM chain prompt expects.
+
+        :meta private:
+        """
+        return self.llm_chain.input_keys
+
+    def _validate_outputs(self, outputs: Dict[str, Any]) -> None:
+        super()._validate_outputs(outputs)
+        if not isinstance(outputs["next_inputs"], dict):
+            raise ValueError
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+
+        prediction = self.llm_chain.predict(callbacks=callbacks, **inputs)
+        output = cast(
+            Dict[str, Any],
+            self.llm_chain.prompt.output_parser.parse(prediction),
+        )
+        return output
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        output = cast(
+            Dict[str, Any],
+            await self.llm_chain.apredict_and_parse(callbacks=callbacks, **inputs),
+        )
+        return output
+
+    @classmethod
+    def from_llm(
+        cls, llm: BaseLanguageModel, prompt: BasePromptTemplate, **kwargs: Any
+    ) -> LLMRouterChain:
+        """Convenience constructor."""
+        llm_chain = LLMChain(llm=llm, prompt=prompt)
+        return cls(llm_chain=llm_chain, **kwargs)
+
+
+class RouterOutputParser(BaseOutputParser[Dict[str, str]]):
+    """Parser for output of router chain in the multi-prompt chain."""
+
+    default_destination: str = "DEFAULT"
+    next_inputs_type: Type = str
+    next_inputs_inner_key: str = "input"
+
+    def parse(self, text: str) -> Dict[str, Any]:
+        try:
+            expected_keys = ["destination", "next_inputs"]
+            parsed = parse_and_check_json_markdown(text, expected_keys)
+            if not isinstance(parsed["destination"], str):
+                raise ValueError("Expected 'destination' to be a string.")
+            if not isinstance(parsed["next_inputs"], self.next_inputs_type):
+                raise ValueError(
+                    f"Expected 'next_inputs' to be {self.next_inputs_type}."
+                )
+            parsed["next_inputs"] = {self.next_inputs_inner_key: parsed["next_inputs"]}
+            if (
+                parsed["destination"].strip().lower()
+                == self.default_destination.lower()
+            ):
+                parsed["destination"] = None
+            else:
+                parsed["destination"] = parsed["destination"].strip()
+            return parsed
+        except Exception as e:
+            raise OutputParserException(
+                f"Parsing text\n{text}\n raised following error:\n{e}"
+            )
diff --git a/llm/Lib/site-packages/langchain/chains/router/multi_prompt.py b/llm/Lib/site-packages/langchain/chains/router/multi_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..c5b3c0453411ba8279688758d94ea168c8047ab5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/router/multi_prompt.py
@@ -0,0 +1,57 @@
+"""Use a single chain to route an input to one of multiple llm chains."""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import PromptTemplate
+
+from langchain.chains import ConversationChain
+from langchain.chains.base import Chain
+from langchain.chains.llm import LLMChain
+from langchain.chains.router.base import MultiRouteChain
+from langchain.chains.router.llm_router import LLMRouterChain, RouterOutputParser
+from langchain.chains.router.multi_prompt_prompt import MULTI_PROMPT_ROUTER_TEMPLATE
+
+
+class MultiPromptChain(MultiRouteChain):
+    """A multi-route chain that uses an LLM router chain to choose amongst prompts."""
+
+    @property
+    def output_keys(self) -> List[str]:
+        return ["text"]
+
+    @classmethod
+    def from_prompts(
+        cls,
+        llm: BaseLanguageModel,
+        prompt_infos: List[Dict[str, str]],
+        default_chain: Optional[Chain] = None,
+        **kwargs: Any,
+    ) -> MultiPromptChain:
+        """Convenience constructor for instantiating from destination prompts."""
+        destinations = [f"{p['name']}: {p['description']}" for p in prompt_infos]
+        destinations_str = "\n".join(destinations)
+        router_template = MULTI_PROMPT_ROUTER_TEMPLATE.format(
+            destinations=destinations_str
+        )
+        router_prompt = PromptTemplate(
+            template=router_template,
+            input_variables=["input"],
+            output_parser=RouterOutputParser(),
+        )
+        router_chain = LLMRouterChain.from_llm(llm, router_prompt)
+        destination_chains = {}
+        for p_info in prompt_infos:
+            name = p_info["name"]
+            prompt_template = p_info["prompt_template"]
+            prompt = PromptTemplate(template=prompt_template, input_variables=["input"])
+            chain = LLMChain(llm=llm, prompt=prompt)
+            destination_chains[name] = chain
+        _default_chain = default_chain or ConversationChain(llm=llm, output_key="text")
+        return cls(
+            router_chain=router_chain,
+            destination_chains=destination_chains,
+            default_chain=_default_chain,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/chains/router/multi_prompt_prompt.py b/llm/Lib/site-packages/langchain/chains/router/multi_prompt_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..b879e718a4e902639325376559109d4d45c397a4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/router/multi_prompt_prompt.py
@@ -0,0 +1,32 @@
+"""Prompt for the router chain in the multi-prompt chain."""
+
+MULTI_PROMPT_ROUTER_TEMPLATE = """\
+Given a raw text input to a language model select the model prompt best suited for \
+the input. You will be given the names of the available prompts and a description of \
+what the prompt is best suited for. You may also revise the original input if you \
+think that revising it will ultimately lead to a better response from the language \
+model.
+
+<< FORMATTING >>
+Return a markdown code snippet with a JSON object formatted to look like:
+```json
+{{{{
+    "destination": string \\ name of the prompt to use or "DEFAULT"
+    "next_inputs": string \\ a potentially modified version of the original input
+}}}}
+```
+
+REMEMBER: "destination" MUST be one of the candidate prompt names specified below OR \
+it can be "DEFAULT" if the input is not well suited for any of the candidate prompts.
+REMEMBER: "next_inputs" can just be the original input if you don't think any \
+modifications are needed.
+
+<< CANDIDATE PROMPTS >>
+{destinations}
+
+<< INPUT >>
+{{input}}
+
+<< OUTPUT (must include ```json at the start of the response) >>
+<< OUTPUT (must end with ```) >>
+"""
diff --git a/llm/Lib/site-packages/langchain/chains/router/multi_retrieval_prompt.py b/llm/Lib/site-packages/langchain/chains/router/multi_retrieval_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..752b5f72525b23ac1c676ccc65162ddf6ac0e397
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/router/multi_retrieval_prompt.py
@@ -0,0 +1,30 @@
+"""Prompt for the router chain in the multi-retrieval qa chain."""
+
+MULTI_RETRIEVAL_ROUTER_TEMPLATE = """\
+Given a query to a question answering system select the system best suited \
+for the input. You will be given the names of the available systems and a description \
+of what questions the system is best suited for. You may also revise the original \
+input if you think that revising it will ultimately lead to a better response.
+
+<< FORMATTING >>
+Return a markdown code snippet with a JSON object formatted to look like:
+```json
+{{{{
+    "destination": string \\ name of the question answering system to use or "DEFAULT"
+    "next_inputs": string \\ a potentially modified version of the original input
+}}}}
+```
+
+REMEMBER: "destination" MUST be one of the candidate prompt names specified below OR \
+it can be "DEFAULT" if the input is not well suited for any of the candidate prompts.
+REMEMBER: "next_inputs" can just be the original input if you don't think any \
+modifications are needed.
+
+<< CANDIDATE PROMPTS >>
+{destinations}
+
+<< INPUT >>
+{{input}}
+
+<< OUTPUT >>
+"""
diff --git a/llm/Lib/site-packages/langchain/chains/router/multi_retrieval_qa.py b/llm/Lib/site-packages/langchain/chains/router/multi_retrieval_qa.py
new file mode 100644
index 0000000000000000000000000000000000000000..d9b0b924edb7d408b598fefa1c9da9dc36c7ae74
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/router/multi_retrieval_qa.py
@@ -0,0 +1,89 @@
+"""Use a single chain to route an input to one of multiple retrieval qa chains."""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_community.chat_models import ChatOpenAI
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import PromptTemplate
+from langchain_core.retrievers import BaseRetriever
+
+from langchain.chains import ConversationChain
+from langchain.chains.base import Chain
+from langchain.chains.conversation.prompt import DEFAULT_TEMPLATE
+from langchain.chains.retrieval_qa.base import BaseRetrievalQA, RetrievalQA
+from langchain.chains.router.base import MultiRouteChain
+from langchain.chains.router.llm_router import LLMRouterChain, RouterOutputParser
+from langchain.chains.router.multi_retrieval_prompt import (
+    MULTI_RETRIEVAL_ROUTER_TEMPLATE,
+)
+
+
+class MultiRetrievalQAChain(MultiRouteChain):
+    """A multi-route chain that uses an LLM router chain to choose amongst retrieval
+    qa chains."""
+
+    router_chain: LLMRouterChain
+    """Chain for deciding a destination chain and the input to it."""
+    destination_chains: Mapping[str, BaseRetrievalQA]
+    """Map of name to candidate chains that inputs can be routed to."""
+    default_chain: Chain
+    """Default chain to use when router doesn't map input to one of the destinations."""
+
+    @property
+    def output_keys(self) -> List[str]:
+        return ["result"]
+
+    @classmethod
+    def from_retrievers(
+        cls,
+        llm: BaseLanguageModel,
+        retriever_infos: List[Dict[str, Any]],
+        default_retriever: Optional[BaseRetriever] = None,
+        default_prompt: Optional[PromptTemplate] = None,
+        default_chain: Optional[Chain] = None,
+        **kwargs: Any,
+    ) -> MultiRetrievalQAChain:
+        if default_prompt and not default_retriever:
+            raise ValueError(
+                "`default_retriever` must be specified if `default_prompt` is "
+                "provided. Received only `default_prompt`."
+            )
+        destinations = [f"{r['name']}: {r['description']}" for r in retriever_infos]
+        destinations_str = "\n".join(destinations)
+        router_template = MULTI_RETRIEVAL_ROUTER_TEMPLATE.format(
+            destinations=destinations_str
+        )
+        router_prompt = PromptTemplate(
+            template=router_template,
+            input_variables=["input"],
+            output_parser=RouterOutputParser(next_inputs_inner_key="query"),
+        )
+        router_chain = LLMRouterChain.from_llm(llm, router_prompt)
+        destination_chains = {}
+        for r_info in retriever_infos:
+            prompt = r_info.get("prompt")
+            retriever = r_info["retriever"]
+            chain = RetrievalQA.from_llm(llm, prompt=prompt, retriever=retriever)
+            name = r_info["name"]
+            destination_chains[name] = chain
+        if default_chain:
+            _default_chain = default_chain
+        elif default_retriever:
+            _default_chain = RetrievalQA.from_llm(
+                llm, prompt=default_prompt, retriever=default_retriever
+            )
+        else:
+            prompt_template = DEFAULT_TEMPLATE.replace("input", "query")
+            prompt = PromptTemplate(
+                template=prompt_template, input_variables=["history", "query"]
+            )
+            _default_chain = ConversationChain(
+                llm=ChatOpenAI(), prompt=prompt, input_key="query", output_key="result"
+            )
+        return cls(
+            router_chain=router_chain,
+            destination_chains=destination_chains,
+            default_chain=_default_chain,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/chains/sequential.py b/llm/Lib/site-packages/langchain/chains/sequential.py
new file mode 100644
index 0000000000000000000000000000000000000000..29cf5dc04d4e8b2b57c7a034c143ca31e0fe5dca
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/sequential.py
@@ -0,0 +1,205 @@
+"""Chain pipeline where the outputs of one step feed directly into next."""
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+)
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.utils.input import get_color_mapping
+
+from langchain.chains.base import Chain
+
+
+class SequentialChain(Chain):
+    """Chain where the outputs of one chain feed directly into next."""
+
+    chains: List[Chain]
+    input_variables: List[str]
+    output_variables: List[str]  #: :meta private:
+    return_all: bool = False
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return expected input keys to the chain.
+
+        :meta private:
+        """
+        return self.input_variables
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return output key.
+
+        :meta private:
+        """
+        return self.output_variables
+
+    @root_validator(pre=True)
+    def validate_chains(cls, values: Dict) -> Dict:
+        """Validate that the correct inputs exist for all chains."""
+        chains = values["chains"]
+        input_variables = values["input_variables"]
+        memory_keys = list()
+        if "memory" in values and values["memory"] is not None:
+            """Validate that prompt input variables are consistent."""
+            memory_keys = values["memory"].memory_variables
+            if set(input_variables).intersection(set(memory_keys)):
+                overlapping_keys = set(input_variables) & set(memory_keys)
+                raise ValueError(
+                    f"The input key(s) {''.join(overlapping_keys)} are found "
+                    f"in the Memory keys ({memory_keys}) - please use input and "
+                    f"memory keys that don't overlap."
+                )
+
+        known_variables = set(input_variables + memory_keys)
+
+        for chain in chains:
+            missing_vars = set(chain.input_keys).difference(known_variables)
+            if chain.memory:
+                missing_vars = missing_vars.difference(chain.memory.memory_variables)
+
+            if missing_vars:
+                raise ValueError(
+                    f"Missing required input keys: {missing_vars}, "
+                    f"only had {known_variables}"
+                )
+            overlapping_keys = known_variables.intersection(chain.output_keys)
+            if overlapping_keys:
+                raise ValueError(
+                    f"Chain returned keys that already exist: {overlapping_keys}"
+                )
+
+            known_variables |= set(chain.output_keys)
+
+        if "output_variables" not in values:
+            if values.get("return_all", False):
+                output_keys = known_variables.difference(input_variables)
+            else:
+                output_keys = chains[-1].output_keys
+            values["output_variables"] = output_keys
+        else:
+            missing_vars = set(values["output_variables"]).difference(known_variables)
+            if missing_vars:
+                raise ValueError(
+                    f"Expected output variables that were not found: {missing_vars}."
+                )
+
+        return values
+
+    def _call(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        known_values = inputs.copy()
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        for i, chain in enumerate(self.chains):
+            callbacks = _run_manager.get_child()
+            outputs = chain(known_values, return_only_outputs=True, callbacks=callbacks)
+            known_values.update(outputs)
+        return {k: known_values[k] for k in self.output_variables}
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        known_values = inputs.copy()
+        _run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        for i, chain in enumerate(self.chains):
+            outputs = await chain.acall(
+                known_values, return_only_outputs=True, callbacks=callbacks
+            )
+            known_values.update(outputs)
+        return {k: known_values[k] for k in self.output_variables}
+
+
+class SimpleSequentialChain(Chain):
+    """Simple chain where the outputs of one step feed directly into next."""
+
+    chains: List[Chain]
+    strip_outputs: bool = False
+    input_key: str = "input"  #: :meta private:
+    output_key: str = "output"  #: :meta private:
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Expect input key.
+
+        :meta private:
+        """
+        return [self.input_key]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return output key.
+
+        :meta private:
+        """
+        return [self.output_key]
+
+    @root_validator()
+    def validate_chains(cls, values: Dict) -> Dict:
+        """Validate that chains are all single input/output."""
+        for chain in values["chains"]:
+            if len(chain.input_keys) != 1:
+                raise ValueError(
+                    "Chains used in SimplePipeline should all have one input, got "
+                    f"{chain} with {len(chain.input_keys)} inputs."
+                )
+            if len(chain.output_keys) != 1:
+                raise ValueError(
+                    "Chains used in SimplePipeline should all have one output, got "
+                    f"{chain} with {len(chain.output_keys)} outputs."
+                )
+        return values
+
+    def _call(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        _input = inputs[self.input_key]
+        color_mapping = get_color_mapping([str(i) for i in range(len(self.chains))])
+        for i, chain in enumerate(self.chains):
+            _input = chain.run(_input, callbacks=_run_manager.get_child(f"step_{i+1}"))
+            if self.strip_outputs:
+                _input = _input.strip()
+            _run_manager.on_text(
+                _input, color=color_mapping[str(i)], end="\n", verbose=self.verbose
+            )
+        return {self.output_key: _input}
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        _run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()
+        _input = inputs[self.input_key]
+        color_mapping = get_color_mapping([str(i) for i in range(len(self.chains))])
+        for i, chain in enumerate(self.chains):
+            _input = await chain.arun(
+                _input, callbacks=_run_manager.get_child(f"step_{i+1}")
+            )
+            if self.strip_outputs:
+                _input = _input.strip()
+            await _run_manager.on_text(
+                _input, color=color_mapping[str(i)], end="\n", verbose=self.verbose
+            )
+        return {self.output_key: _input}
diff --git a/llm/Lib/site-packages/langchain/chains/sql_database/__init__.py b/llm/Lib/site-packages/langchain/chains/sql_database/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b704f72c280d2732f484c3ef389c1e3126746a14
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/sql_database/__init__.py
@@ -0,0 +1 @@
+"""Chain for interacting with SQL Database."""
diff --git a/llm/Lib/site-packages/langchain/chains/sql_database/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/sql_database/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..43b69e0a7342eae00b1775e053e4faae53568099
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/sql_database/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/sql_database/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/sql_database/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..33a3c314dc51de71b4d07759ea7339baee8e280e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/sql_database/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/sql_database/__pycache__/query.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/sql_database/__pycache__/query.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4443ddcdca2ba1726c7cab8c2372934499681e6d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/sql_database/__pycache__/query.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/sql_database/prompt.py b/llm/Lib/site-packages/langchain/chains/sql_database/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..d11740e4b4b29385fe90f46f83e0ce823f687141
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/sql_database/prompt.py
@@ -0,0 +1,284 @@
+# flake8: noqa
+from langchain_core.output_parsers.list import CommaSeparatedListOutputParser
+from langchain_core.prompts.prompt import PromptTemplate
+
+
+PROMPT_SUFFIX = """Only use the following tables:
+{table_info}
+
+Question: {input}"""
+
+_DEFAULT_TEMPLATE = """Given an input question, first create a syntactically correct {dialect} query to run, then look at the results of the query and return the answer. Unless the user specifies in his question a specific number of examples he wishes to obtain, always limit your query to at most {top_k} results. You can order the results by a relevant column to return the most interesting examples in the database.
+
+Never query for all the columns from a specific table, only ask for a the few relevant columns given the question.
+
+Pay attention to use only the column names that you can see in the schema description. Be careful to not query for columns that do not exist. Also, pay attention to which column is in which table.
+
+Use the following format:
+
+Question: Question here
+SQLQuery: SQL Query to run
+SQLResult: Result of the SQLQuery
+Answer: Final answer here
+
+"""
+
+PROMPT = PromptTemplate(
+    input_variables=["input", "table_info", "dialect", "top_k"],
+    template=_DEFAULT_TEMPLATE + PROMPT_SUFFIX,
+)
+
+
+_DECIDER_TEMPLATE = """Given the below input question and list of potential tables, output a comma separated list of the table names that may be necessary to answer this question.
+
+Question: {query}
+
+Table Names: {table_names}
+
+Relevant Table Names:"""
+DECIDER_PROMPT = PromptTemplate(
+    input_variables=["query", "table_names"],
+    template=_DECIDER_TEMPLATE,
+    output_parser=CommaSeparatedListOutputParser(),
+)
+
+_cratedb_prompt = """You are a CrateDB expert. Given an input question, first create a syntactically correct CrateDB query to run, then look at the results of the query and return the answer to the input question.
+Unless the user specifies in the question a specific number of examples to obtain, query for at most {top_k} results using the LIMIT clause as per CrateDB. You can order the results to return the most informative data in the database.
+Never query for all columns from a table. You must query only the columns that are needed to answer the question. Wrap each column name in double quotes (") to denote them as delimited identifiers.
+Pay attention to use only the column names you can see in the tables below. Be careful to not query for columns that do not exist. Also, pay attention to which column is in which table.
+Pay attention to use CURRENT_DATE function to get the current date, if the question involves "today". 
+
+Use the following format:
+
+Question: Question here
+SQLQuery: SQL Query to run
+SQLResult: Result of the SQLQuery
+Answer: Final answer here
+
+"""
+
+CRATEDB_PROMPT = PromptTemplate(
+    input_variables=["input", "table_info", "top_k"],
+    template=_cratedb_prompt + PROMPT_SUFFIX,
+)
+
+_duckdb_prompt = """You are a DuckDB expert. Given an input question, first create a syntactically correct DuckDB query to run, then look at the results of the query and return the answer to the input question.
+Unless the user specifies in the question a specific number of examples to obtain, query for at most {top_k} results using the LIMIT clause as per DuckDB. You can order the results to return the most informative data in the database.
+Never query for all columns from a table. You must query only the columns that are needed to answer the question. Wrap each column name in double quotes (") to denote them as delimited identifiers.
+Pay attention to use only the column names you can see in the tables below. Be careful to not query for columns that do not exist. Also, pay attention to which column is in which table.
+Pay attention to use today() function to get the current date, if the question involves "today".
+
+Use the following format:
+
+Question: Question here
+SQLQuery: SQL Query to run
+SQLResult: Result of the SQLQuery
+Answer: Final answer here
+
+"""
+
+DUCKDB_PROMPT = PromptTemplate(
+    input_variables=["input", "table_info", "top_k"],
+    template=_duckdb_prompt + PROMPT_SUFFIX,
+)
+
+_googlesql_prompt = """You are a GoogleSQL expert. Given an input question, first create a syntactically correct GoogleSQL query to run, then look at the results of the query and return the answer to the input question.
+Unless the user specifies in the question a specific number of examples to obtain, query for at most {top_k} results using the LIMIT clause as per GoogleSQL. You can order the results to return the most informative data in the database.
+Never query for all columns from a table. You must query only the columns that are needed to answer the question. Wrap each column name in backticks (`) to denote them as delimited identifiers.
+Pay attention to use only the column names you can see in the tables below. Be careful to not query for columns that do not exist. Also, pay attention to which column is in which table.
+Pay attention to use CURRENT_DATE() function to get the current date, if the question involves "today".
+
+Use the following format:
+
+Question: Question here
+SQLQuery: SQL Query to run
+SQLResult: Result of the SQLQuery
+Answer: Final answer here
+
+"""
+
+GOOGLESQL_PROMPT = PromptTemplate(
+    input_variables=["input", "table_info", "top_k"],
+    template=_googlesql_prompt + PROMPT_SUFFIX,
+)
+
+
+_mssql_prompt = """You are an MS SQL expert. Given an input question, first create a syntactically correct MS SQL query to run, then look at the results of the query and return the answer to the input question.
+Unless the user specifies in the question a specific number of examples to obtain, query for at most {top_k} results using the TOP clause as per MS SQL. You can order the results to return the most informative data in the database.
+Never query for all columns from a table. You must query only the columns that are needed to answer the question. Wrap each column name in square brackets ([]) to denote them as delimited identifiers.
+Pay attention to use only the column names you can see in the tables below. Be careful to not query for columns that do not exist. Also, pay attention to which column is in which table.
+Pay attention to use CAST(GETDATE() as date) function to get the current date, if the question involves "today".
+
+Use the following format:
+
+Question: Question here
+SQLQuery: SQL Query to run
+SQLResult: Result of the SQLQuery
+Answer: Final answer here
+
+"""
+
+MSSQL_PROMPT = PromptTemplate(
+    input_variables=["input", "table_info", "top_k"],
+    template=_mssql_prompt + PROMPT_SUFFIX,
+)
+
+
+_mysql_prompt = """You are a MySQL expert. Given an input question, first create a syntactically correct MySQL query to run, then look at the results of the query and return the answer to the input question.
+Unless the user specifies in the question a specific number of examples to obtain, query for at most {top_k} results using the LIMIT clause as per MySQL. You can order the results to return the most informative data in the database.
+Never query for all columns from a table. You must query only the columns that are needed to answer the question. Wrap each column name in backticks (`) to denote them as delimited identifiers.
+Pay attention to use only the column names you can see in the tables below. Be careful to not query for columns that do not exist. Also, pay attention to which column is in which table.
+Pay attention to use CURDATE() function to get the current date, if the question involves "today".
+
+Use the following format:
+
+Question: Question here
+SQLQuery: SQL Query to run
+SQLResult: Result of the SQLQuery
+Answer: Final answer here
+
+"""
+
+MYSQL_PROMPT = PromptTemplate(
+    input_variables=["input", "table_info", "top_k"],
+    template=_mysql_prompt + PROMPT_SUFFIX,
+)
+
+
+_mariadb_prompt = """You are a MariaDB expert. Given an input question, first create a syntactically correct MariaDB query to run, then look at the results of the query and return the answer to the input question.
+Unless the user specifies in the question a specific number of examples to obtain, query for at most {top_k} results using the LIMIT clause as per MariaDB. You can order the results to return the most informative data in the database.
+Never query for all columns from a table. You must query only the columns that are needed to answer the question. Wrap each column name in backticks (`) to denote them as delimited identifiers.
+Pay attention to use only the column names you can see in the tables below. Be careful to not query for columns that do not exist. Also, pay attention to which column is in which table.
+Pay attention to use CURDATE() function to get the current date, if the question involves "today".
+
+Use the following format:
+
+Question: Question here
+SQLQuery: SQL Query to run
+SQLResult: Result of the SQLQuery
+Answer: Final answer here
+
+"""
+
+MARIADB_PROMPT = PromptTemplate(
+    input_variables=["input", "table_info", "top_k"],
+    template=_mariadb_prompt + PROMPT_SUFFIX,
+)
+
+
+_oracle_prompt = """You are an Oracle SQL expert. Given an input question, first create a syntactically correct Oracle SQL query to run, then look at the results of the query and return the answer to the input question.
+Unless the user specifies in the question a specific number of examples to obtain, query for at most {top_k} results using the FETCH FIRST n ROWS ONLY clause as per Oracle SQL. You can order the results to return the most informative data in the database.
+Never query for all columns from a table. You must query only the columns that are needed to answer the question. Wrap each column name in double quotes (") to denote them as delimited identifiers.
+Pay attention to use only the column names you can see in the tables below. Be careful to not query for columns that do not exist. Also, pay attention to which column is in which table.
+Pay attention to use TRUNC(SYSDATE) function to get the current date, if the question involves "today".
+
+Use the following format:
+
+Question: Question here
+SQLQuery: SQL Query to run
+SQLResult: Result of the SQLQuery
+Answer: Final answer here
+
+"""
+
+ORACLE_PROMPT = PromptTemplate(
+    input_variables=["input", "table_info", "top_k"],
+    template=_oracle_prompt + PROMPT_SUFFIX,
+)
+
+
+_postgres_prompt = """You are a PostgreSQL expert. Given an input question, first create a syntactically correct PostgreSQL query to run, then look at the results of the query and return the answer to the input question.
+Unless the user specifies in the question a specific number of examples to obtain, query for at most {top_k} results using the LIMIT clause as per PostgreSQL. You can order the results to return the most informative data in the database.
+Never query for all columns from a table. You must query only the columns that are needed to answer the question. Wrap each column name in double quotes (") to denote them as delimited identifiers.
+Pay attention to use only the column names you can see in the tables below. Be careful to not query for columns that do not exist. Also, pay attention to which column is in which table.
+Pay attention to use CURRENT_DATE function to get the current date, if the question involves "today".
+
+Use the following format:
+
+Question: Question here
+SQLQuery: SQL Query to run
+SQLResult: Result of the SQLQuery
+Answer: Final answer here
+
+"""
+
+POSTGRES_PROMPT = PromptTemplate(
+    input_variables=["input", "table_info", "top_k"],
+    template=_postgres_prompt + PROMPT_SUFFIX,
+)
+
+
+_sqlite_prompt = """You are a SQLite expert. Given an input question, first create a syntactically correct SQLite query to run, then look at the results of the query and return the answer to the input question.
+Unless the user specifies in the question a specific number of examples to obtain, query for at most {top_k} results using the LIMIT clause as per SQLite. You can order the results to return the most informative data in the database.
+Never query for all columns from a table. You must query only the columns that are needed to answer the question. Wrap each column name in double quotes (") to denote them as delimited identifiers.
+Pay attention to use only the column names you can see in the tables below. Be careful to not query for columns that do not exist. Also, pay attention to which column is in which table.
+Pay attention to use date('now') function to get the current date, if the question involves "today".
+
+Use the following format:
+
+Question: Question here
+SQLQuery: SQL Query to run
+SQLResult: Result of the SQLQuery
+Answer: Final answer here
+
+"""
+
+SQLITE_PROMPT = PromptTemplate(
+    input_variables=["input", "table_info", "top_k"],
+    template=_sqlite_prompt + PROMPT_SUFFIX,
+)
+
+_clickhouse_prompt = """You are a ClickHouse expert. Given an input question, first create a syntactically correct Clic query to run, then look at the results of the query and return the answer to the input question.
+Unless the user specifies in the question a specific number of examples to obtain, query for at most {top_k} results using the LIMIT clause as per ClickHouse. You can order the results to return the most informative data in the database.
+Never query for all columns from a table. You must query only the columns that are needed to answer the question. Wrap each column name in double quotes (") to denote them as delimited identifiers.
+Pay attention to use only the column names you can see in the tables below. Be careful to not query for columns that do not exist. Also, pay attention to which column is in which table.
+Pay attention to use today() function to get the current date, if the question involves "today".
+
+Use the following format:
+
+Question: "Question here"
+SQLQuery: "SQL Query to run"
+SQLResult: "Result of the SQLQuery"
+Answer: "Final answer here"
+
+"""
+
+CLICKHOUSE_PROMPT = PromptTemplate(
+    input_variables=["input", "table_info", "top_k"],
+    template=_clickhouse_prompt + PROMPT_SUFFIX,
+)
+
+_prestodb_prompt = """You are a PrestoDB expert. Given an input question, first create a syntactically correct PrestoDB query to run, then look at the results of the query and return the answer to the input question.
+Unless the user specifies in the question a specific number of examples to obtain, query for at most {top_k} results using the LIMIT clause as per PrestoDB. You can order the results to return the most informative data in the database.
+Never query for all columns from a table. You must query only the columns that are needed to answer the question. Wrap each column name in double quotes (") to denote them as delimited identifiers.
+Pay attention to use only the column names you can see in the tables below. Be careful to not query for columns that do not exist. Also, pay attention to which column is in which table.
+Pay attention to use current_date function to get the current date, if the question involves "today".
+
+Use the following format:
+
+Question: "Question here"
+SQLQuery: "SQL Query to run"
+SQLResult: "Result of the SQLQuery"
+Answer: "Final answer here"
+
+"""
+
+PRESTODB_PROMPT = PromptTemplate(
+    input_variables=["input", "table_info", "top_k"],
+    template=_prestodb_prompt + PROMPT_SUFFIX,
+)
+
+
+SQL_PROMPTS = {
+    "crate": CRATEDB_PROMPT,
+    "duckdb": DUCKDB_PROMPT,
+    "googlesql": GOOGLESQL_PROMPT,
+    "mssql": MSSQL_PROMPT,
+    "mysql": MYSQL_PROMPT,
+    "mariadb": MARIADB_PROMPT,
+    "oracle": ORACLE_PROMPT,
+    "postgresql": POSTGRES_PROMPT,
+    "sqlite": SQLITE_PROMPT,
+    "clickhouse": CLICKHOUSE_PROMPT,
+    "prestodb": PRESTODB_PROMPT,
+}
diff --git a/llm/Lib/site-packages/langchain/chains/sql_database/query.py b/llm/Lib/site-packages/langchain/chains/sql_database/query.py
new file mode 100644
index 0000000000000000000000000000000000000000..6bd074c7166054c815c1d217b8fdcae1aa86a7a7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/sql_database/query.py
@@ -0,0 +1,143 @@
+from typing import Any, Dict, List, Optional, TypedDict, Union
+
+from langchain_community.utilities.sql_database import SQLDatabase
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import StrOutputParser
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.runnables import Runnable, RunnablePassthrough
+
+from langchain.chains.sql_database.prompt import PROMPT, SQL_PROMPTS
+
+
+def _strip(text: str) -> str:
+    return text.strip()
+
+
+class SQLInput(TypedDict):
+    """Input for a SQL Chain."""
+
+    question: str
+
+
+class SQLInputWithTables(TypedDict):
+    """Input for a SQL Chain."""
+
+    question: str
+    table_names_to_use: List[str]
+
+
+def create_sql_query_chain(
+    llm: BaseLanguageModel,
+    db: SQLDatabase,
+    prompt: Optional[BasePromptTemplate] = None,
+    k: int = 5,
+) -> Runnable[Union[SQLInput, SQLInputWithTables, Dict[str, Any]], str]:
+    """Create a chain that generates SQL queries.
+
+    *Security Note*: This chain generates SQL queries for the given database.
+
+        The SQLDatabase class provides a get_table_info method that can be used
+        to get column information as well as sample data from the table.
+
+        To mitigate risk of leaking sensitive data, limit permissions
+        to read and scope to the tables that are needed.
+
+        Optionally, use the SQLInputWithTables input type to specify which tables
+        are allowed to be accessed.
+
+        Control access to who can submit requests to this chain.
+
+        See https://python.langchain.com/docs/security for more information.
+
+    Args:
+        llm: The language model to use.
+        db: The SQLDatabase to generate the query for.
+        prompt: The prompt to use. If none is provided, will choose one
+            based on dialect. Defaults to None. See Prompt section below for more.
+        k: The number of results per select statement to return. Defaults to 5.
+
+    Returns:
+        A chain that takes in a question and generates a SQL query that answers
+        that question.
+
+    Example:
+
+        .. code-block:: python
+
+            # pip install -U langchain langchain-community langchain-openai
+            from langchain_openai import ChatOpenAI
+            from langchain.chains import create_sql_query_chain
+            from langchain_community.utilities import SQLDatabase
+
+            db = SQLDatabase.from_uri("sqlite:///Chinook.db")
+            llm = ChatOpenAI(model="gpt-3.5-turbo", temperature=0)
+            chain = create_sql_query_chain(llm, db)
+            response = chain.invoke({"question": "How many employees are there"})
+
+    Prompt:
+        If no prompt is provided, a default prompt is selected based on the SQLDatabase dialect. If one is provided, it must support input variables:
+            * input: The user question plus suffix "\nSQLQuery: " is passed here.
+            * top_k: The number of results per select statement (the `k` argument to
+                this function) is passed in here.
+            * table_info: Table definitions and sample rows are passed in here. If the
+                user specifies "table_names_to_use" when invoking chain, only those
+                will be included. Otherwise, all tables are included.
+            * dialect (optional): If dialect input variable is in prompt, the db
+                dialect will be passed in here.
+
+        Here's an example prompt:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import PromptTemplate
+
+            template = '''Given an input question, first create a syntactically correct {dialect} query to run, then look at the results of the query and return the answer.
+            Use the following format:
+
+            Question: "Question here"
+            SQLQuery: "SQL Query to run"
+            SQLResult: "Result of the SQLQuery"
+            Answer: "Final answer here"
+
+            Only use the following tables:
+
+            {table_info}.
+
+            Question: {input}'''
+            prompt = PromptTemplate.from_template(template)
+    """  # noqa: E501
+    if prompt is not None:
+        prompt_to_use = prompt
+    elif db.dialect in SQL_PROMPTS:
+        prompt_to_use = SQL_PROMPTS[db.dialect]
+    else:
+        prompt_to_use = PROMPT
+    if {"input", "top_k", "table_info"}.difference(prompt_to_use.input_variables):
+        raise ValueError(
+            f"Prompt must have input variables: 'input', 'top_k', "
+            f"'table_info'. Received prompt with input variables: "
+            f"{prompt_to_use.input_variables}. Full prompt:\n\n{prompt_to_use}"
+        )
+    if "dialect" in prompt_to_use.input_variables:
+        prompt_to_use = prompt_to_use.partial(dialect=db.dialect)
+
+    inputs = {
+        "input": lambda x: x["question"] + "\nSQLQuery: ",
+        "table_info": lambda x: db.get_table_info(
+            table_names=x.get("table_names_to_use")
+        ),
+    }
+    return (
+        RunnablePassthrough.assign(**inputs)  # type: ignore
+        | (
+            lambda x: {
+                k: v
+                for k, v in x.items()
+                if k not in ("question", "table_names_to_use")
+            }
+        )
+        | prompt_to_use.partial(top_k=str(k))
+        | llm.bind(stop=["\nSQLResult:"])
+        | StrOutputParser()
+        | _strip
+    )
diff --git a/llm/Lib/site-packages/langchain/chains/structured_output/__init__.py b/llm/Lib/site-packages/langchain/chains/structured_output/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d387a7cbe4ea968bb08a6ec4ec9fb19edb3484e7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/structured_output/__init__.py
@@ -0,0 +1,6 @@
+from langchain.chains.structured_output.base import (
+    create_openai_fn_runnable,
+    create_structured_output_runnable,
+)
+
+__all__ = ["create_structured_output_runnable", "create_openai_fn_runnable"]
diff --git a/llm/Lib/site-packages/langchain/chains/structured_output/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/structured_output/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b8026aef76623272e40265574cab2536358bd872
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/structured_output/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/structured_output/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/structured_output/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f41603c63eeb752e7eb4a9cfe8e59c1bb56f1868
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/structured_output/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/structured_output/base.py b/llm/Lib/site-packages/langchain/chains/structured_output/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..f33911a163ba26e3b2f7c6518644283ca9a287b2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/structured_output/base.py
@@ -0,0 +1,502 @@
+import json
+from typing import Any, Callable, Dict, Literal, Optional, Sequence, Type, Union
+
+from langchain_core.output_parsers import (
+    BaseGenerationOutputParser,
+    BaseOutputParser,
+    JsonOutputParser,
+)
+from langchain_core.output_parsers.openai_functions import (
+    JsonOutputFunctionsParser,
+    PydanticAttrOutputFunctionsParser,
+    PydanticOutputFunctionsParser,
+)
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.runnables import Runnable
+from langchain_core.utils.function_calling import (
+    convert_to_openai_function,
+    convert_to_openai_tool,
+)
+
+from langchain.output_parsers import (
+    JsonOutputKeyToolsParser,
+    PydanticOutputParser,
+    PydanticToolsParser,
+)
+
+
+def create_openai_fn_runnable(
+    functions: Sequence[Union[Dict[str, Any], Type[BaseModel], Callable]],
+    llm: Runnable,
+    prompt: Optional[BasePromptTemplate] = None,
+    *,
+    enforce_single_function_usage: bool = True,
+    output_parser: Optional[Union[BaseOutputParser, BaseGenerationOutputParser]] = None,
+    **llm_kwargs: Any,
+) -> Runnable:
+    """Create a runnable sequence that uses OpenAI functions.
+
+    Args:
+        functions: A sequence of either dictionaries, pydantic.BaseModels classes, or
+            Python functions. If dictionaries are passed in, they are assumed to
+            already be a valid OpenAI functions. If only a single
+            function is passed in, then it will be enforced that the model use that
+            function. pydantic.BaseModels and Python functions should have docstrings
+            describing what the function does. For best results, pydantic.BaseModels
+            should have descriptions of the parameters and Python functions should have
+            Google Python style args descriptions in the docstring. Additionally,
+            Python functions should only use primitive types (str, int, float, bool) or
+            pydantic.BaseModels for arguments.
+        llm: Language model to use, assumed to support the OpenAI function-calling API.
+        prompt: BasePromptTemplate to pass to the model.
+        enforce_single_function_usage: only used if a single function is passed in. If
+            True, then the model will be forced to use the given function. If False,
+            then the model will be given the option to use the given function or not.
+        output_parser: BaseLLMOutputParser to use for parsing model outputs. By default
+            will be inferred from the function types. If pydantic.BaseModels are passed
+            in, then the OutputParser will try to parse outputs using those. Otherwise
+            model outputs will simply be parsed as JSON. If multiple functions are
+            passed in and they are not pydantic.BaseModels, the chain output will
+            include both the name of the function that was returned and the arguments
+            to pass to the function.
+        **llm_kwargs: Additional named arguments to pass to the language model.
+
+    Returns:
+        A runnable sequence that will pass in the given functions to the model when run.
+
+    Example:
+        .. code-block:: python
+
+                from typing import Optional
+
+                from langchain.chains.structured_output import create_openai_fn_runnable
+                from langchain_openai import ChatOpenAI
+                from langchain_core.pydantic_v1 import BaseModel, Field
+
+
+                class RecordPerson(BaseModel):
+                    '''Record some identifying information about a person.'''
+
+                    name: str = Field(..., description="The person's name")
+                    age: int = Field(..., description="The person's age")
+                    fav_food: Optional[str] = Field(None, description="The person's favorite food")
+
+
+                class RecordDog(BaseModel):
+                    '''Record some identifying information about a dog.'''
+
+                    name: str = Field(..., description="The dog's name")
+                    color: str = Field(..., description="The dog's color")
+                    fav_food: Optional[str] = Field(None, description="The dog's favorite food")
+
+
+                llm = ChatOpenAI(model="gpt-4", temperature=0)
+                structured_llm = create_openai_fn_runnable([RecordPerson, RecordDog], llm)
+                structured_llm.invoke("Harry was a chubby brown beagle who loved chicken)
+                # -> RecordDog(name="Harry", color="brown", fav_food="chicken")
+    """  # noqa: E501
+    if not functions:
+        raise ValueError("Need to pass in at least one function. Received zero.")
+    openai_functions = [convert_to_openai_function(f) for f in functions]
+    llm_kwargs_: Dict[str, Any] = {"functions": openai_functions, **llm_kwargs}
+    if len(openai_functions) == 1 and enforce_single_function_usage:
+        llm_kwargs_["function_call"] = {"name": openai_functions[0]["name"]}
+    output_parser = output_parser or get_openai_output_parser(functions)
+    if prompt:
+        return prompt | llm.bind(**llm_kwargs_) | output_parser
+    else:
+        return llm.bind(**llm_kwargs_) | output_parser
+
+
+def create_structured_output_runnable(
+    output_schema: Union[Dict[str, Any], Type[BaseModel]],
+    llm: Runnable,
+    prompt: Optional[BasePromptTemplate] = None,
+    *,
+    output_parser: Optional[Union[BaseOutputParser, BaseGenerationOutputParser]] = None,
+    enforce_function_usage: bool = True,
+    return_single: bool = True,
+    mode: Literal[
+        "openai-functions", "openai-tools", "openai-json"
+    ] = "openai-functions",
+    **kwargs: Any,
+) -> Runnable:
+    """Create a runnable for extracting structured outputs.
+
+    Args:
+        output_schema: Either a dictionary or pydantic.BaseModel class. If a dictionary
+            is passed in, it's assumed to already be a valid JsonSchema.
+            For best results, pydantic.BaseModels should have docstrings describing what
+            the schema represents and descriptions for the parameters.
+        llm: Language model to use. Assumed to support the OpenAI function-calling API 
+            if mode is 'openai-function'. Assumed to support OpenAI response_format 
+            parameter if mode is 'openai-json'.
+        prompt: BasePromptTemplate to pass to the model. If mode is 'openai-json' and 
+            prompt has input variable 'output_schema' then the given output_schema 
+            will be converted to a JsonSchema and inserted in the prompt.
+        output_parser: Output parser to use for parsing model outputs. By default
+            will be inferred from the function types. If pydantic.BaseModel is passed
+            in, then the OutputParser will try to parse outputs using the pydantic 
+            class. Otherwise model outputs will be parsed as JSON.
+        mode: How structured outputs are extracted from the model. If 'openai-functions' 
+            then OpenAI function calling is used with the deprecated 'functions', 
+            'function_call' schema. If 'openai-tools' then OpenAI function 
+            calling with the latest 'tools', 'tool_choice' schema is used. This is 
+            recommended over 'openai-functions'. If 'openai-json' then OpenAI model 
+            with response_format set to JSON is used.
+        enforce_function_usage: Only applies when mode is 'openai-tools' or 
+            'openai-functions'. If True, then the model will be forced to use the given 
+            output schema. If False, then the model can elect whether to use the output 
+            schema.
+        return_single: Only applies when mode is 'openai-tools'. Whether to a list of 
+            structured outputs or a single one. If True and model does not return any 
+            structured outputs then chain output is None. If False and model does not 
+            return any structured outputs then chain output is an empty list.
+        **kwargs: Additional named arguments.
+
+    Returns:
+        A runnable sequence that will return a structured output(s) matching the given 
+            output_schema.
+    
+    OpenAI tools example with Pydantic schema (mode='openai-tools'):
+        .. code-block:: python
+        
+                from typing import Optional
+
+                from langchain.chains import create_structured_output_runnable
+                from langchain_openai import ChatOpenAI
+                from langchain_core.pydantic_v1 import BaseModel, Field
+
+
+                class RecordDog(BaseModel):
+                    '''Record some identifying information about a dog.'''
+
+                    name: str = Field(..., description="The dog's name")
+                    color: str = Field(..., description="The dog's color")
+                    fav_food: Optional[str] = Field(None, description="The dog's favorite food")
+
+                llm = ChatOpenAI(model="gpt-3.5-turbo-0125", temperature=0)
+                prompt = ChatPromptTemplate.from_messages(
+                    [
+                        ("system", "You are an extraction algorithm. Please extract every possible instance"), 
+                        ('human', '{input}')
+                    ]
+                )
+                structured_llm = create_structured_output_runnable(
+                    RecordDog, 
+                    llm, 
+                    mode="openai-tools", 
+                    enforce_function_usage=True, 
+                    return_single=True
+                )
+                structured_llm.invoke({"input": "Harry was a chubby brown beagle who loved chicken"})
+                # -> RecordDog(name="Harry", color="brown", fav_food="chicken")
+                
+    OpenAI tools example with dict schema (mode="openai-tools"):
+        .. code-block:: python
+        
+                from typing import Optional
+
+                from langchain.chains import create_structured_output_runnable
+                from langchain_openai import ChatOpenAI
+
+
+                dog_schema = {
+                    "type": "function",
+                    "function": {
+                        "name": "record_dog",
+                        "description": "Record some identifying information about a dog.",
+                        "parameters": {
+                            "type": "object",
+                            "properties": {
+                                "name": {
+                                    "description": "The dog's name",
+                                    "type": "string"
+                                },
+                                "color": {
+                                    "description": "The dog's color",
+                                    "type": "string"
+                                },
+                                "fav_food": {
+                                    "description": "The dog's favorite food",
+                                    "type": "string"
+                                }
+                            },
+                            "required": ["name", "color"]
+                        }
+                    }
+                }
+
+
+                llm = ChatOpenAI(model="gpt-3.5-turbo-0125", temperature=0)
+                structured_llm = create_structured_output_runnable(
+                    doc_schema, 
+                    llm, 
+                    mode="openai-tools", 
+                    enforce_function_usage=True, 
+                    return_single=True
+                )
+                structured_llm.invoke("Harry was a chubby brown beagle who loved chicken")
+                # -> {'name': 'Harry', 'color': 'brown', 'fav_food': 'chicken'}
+    
+    OpenAI functions example (mode="openai-functions"):
+        .. code-block:: python
+
+                from typing import Optional
+
+                from langchain.chains import create_structured_output_runnable
+                from langchain_openai import ChatOpenAI
+                from langchain_core.pydantic_v1 import BaseModel, Field
+
+                class Dog(BaseModel):
+                    '''Identifying information about a dog.'''
+
+                    name: str = Field(..., description="The dog's name")
+                    color: str = Field(..., description="The dog's color")
+                    fav_food: Optional[str] = Field(None, description="The dog's favorite food")
+
+                llm = ChatOpenAI(model="gpt-3.5-turbo-0125", temperature=0)
+                structured_llm = create_structured_output_runnable(Dog, llm, mode="openai-functions")
+                structured_llm.invoke("Harry was a chubby brown beagle who loved chicken")
+                # -> Dog(name="Harry", color="brown", fav_food="chicken")
+                
+    OpenAI functions with prompt example:
+        .. code-block:: python
+
+                from typing import Optional
+
+                from langchain.chains import create_structured_output_runnable
+                from langchain_openai import ChatOpenAI
+                from langchain_core.prompts import ChatPromptTemplate
+                from langchain_core.pydantic_v1 import BaseModel, Field
+
+                class Dog(BaseModel):
+                    '''Identifying information about a dog.'''
+
+                    name: str = Field(..., description="The dog's name")
+                    color: str = Field(..., description="The dog's color")
+                    fav_food: Optional[str] = Field(None, description="The dog's favorite food")
+
+                llm = ChatOpenAI(model="gpt-3.5-turbo-0125", temperature=0)
+                structured_llm = create_structured_output_runnable(Dog, llm, mode="openai-functions")
+                system = '''Extract information about any dogs mentioned in the user input.'''
+                prompt = ChatPromptTemplate.from_messages(
+                    [("system", system), ("human", "{input}"),]
+                )
+                chain = prompt | structured_llm
+                chain.invoke({"input": "Harry was a chubby brown beagle who loved chicken"})
+                # -> Dog(name="Harry", color="brown", fav_food="chicken")
+    OpenAI json response format example (mode="openai-json"):
+        .. code-block:: python
+        
+                from typing import Optional
+
+                from langchain.chains import create_structured_output_runnable
+                from langchain_openai import ChatOpenAI
+                from langchain_core.prompts import ChatPromptTemplate
+                from langchain_core.pydantic_v1 import BaseModel, Field
+
+                class Dog(BaseModel):
+                    '''Identifying information about a dog.'''
+
+                    name: str = Field(..., description="The dog's name")
+                    color: str = Field(..., description="The dog's color")
+                    fav_food: Optional[str] = Field(None, description="The dog's favorite food")
+
+                llm = ChatOpenAI(model="gpt-3.5-turbo-0125", temperature=0)
+                structured_llm = create_structured_output_runnable(Dog, llm, mode="openai-json")
+                system = '''You are a world class assistant for extracting information in structured JSON formats. \
+                
+                Extract a valid JSON blob from the user input that matches the following JSON Schema:
+                
+                {output_schema}'''
+                prompt = ChatPromptTemplate.from_messages(
+                    [("system", system), ("human", "{input}"),]
+                )
+                chain = prompt | structured_llm
+                chain.invoke({"input": "Harry was a chubby brown beagle who loved chicken"})
+    """  # noqa: E501
+    # for backwards compatibility
+    force_function_usage = kwargs.get(
+        "enforce_single_function_usage", enforce_function_usage
+    )
+
+    if mode == "openai-tools":
+        # Protect against typos in kwargs
+        keys_in_kwargs = set(kwargs.keys())
+        # Backwards compatibility keys
+        unrecognized_keys = keys_in_kwargs - {"enforce_single_function_usage"}
+        if unrecognized_keys:
+            raise TypeError(
+                f"Got an unexpected keyword argument(s): {unrecognized_keys}."
+            )
+
+        return _create_openai_tools_runnable(
+            output_schema,
+            llm,
+            prompt=prompt,
+            output_parser=output_parser,
+            enforce_tool_usage=force_function_usage,
+            first_tool_only=return_single,
+        )
+
+    elif mode == "openai-functions":
+        return _create_openai_functions_structured_output_runnable(
+            output_schema,
+            llm,
+            prompt=prompt,
+            output_parser=output_parser,
+            enforce_single_function_usage=force_function_usage,
+            **kwargs,  # llm-specific kwargs
+        )
+    elif mode == "openai-json":
+        if force_function_usage:
+            raise ValueError(
+                "enforce_single_function_usage is not supported for mode='openai-json'."
+            )
+        return _create_openai_json_runnable(
+            output_schema, llm, prompt=prompt, output_parser=output_parser, **kwargs
+        )
+    else:
+        raise ValueError(
+            f"Invalid mode {mode}. Expected one of 'openai-tools', 'openai-functions', "
+            f"'openai-json'."
+        )
+
+
+def _create_openai_tools_runnable(
+    tool: Union[Dict[str, Any], Type[BaseModel], Callable],
+    llm: Runnable,
+    *,
+    prompt: Optional[BasePromptTemplate],
+    output_parser: Optional[Union[BaseOutputParser, BaseGenerationOutputParser]],
+    enforce_tool_usage: bool,
+    first_tool_only: bool,
+) -> Runnable:
+    oai_tool = convert_to_openai_tool(tool)
+    llm_kwargs: Dict[str, Any] = {"tools": [oai_tool]}
+    if enforce_tool_usage:
+        llm_kwargs["tool_choice"] = {
+            "type": "function",
+            "function": {"name": oai_tool["function"]["name"]},
+        }
+    output_parser = output_parser or _get_openai_tool_output_parser(
+        tool, first_tool_only=first_tool_only
+    )
+    if prompt:
+        return prompt | llm.bind(**llm_kwargs) | output_parser
+    else:
+        return llm.bind(**llm_kwargs) | output_parser
+
+
+def _get_openai_tool_output_parser(
+    tool: Union[Dict[str, Any], Type[BaseModel], Callable],
+    *,
+    first_tool_only: bool = False,
+) -> Union[BaseOutputParser, BaseGenerationOutputParser]:
+    if isinstance(tool, type) and issubclass(tool, BaseModel):
+        output_parser: Union[
+            BaseOutputParser, BaseGenerationOutputParser
+        ] = PydanticToolsParser(tools=[tool], first_tool_only=first_tool_only)
+    else:
+        key_name = convert_to_openai_tool(tool)["function"]["name"]
+        output_parser = JsonOutputKeyToolsParser(
+            first_tool_only=first_tool_only, key_name=key_name
+        )
+    return output_parser
+
+
+def get_openai_output_parser(
+    functions: Sequence[Union[Dict[str, Any], Type[BaseModel], Callable]],
+) -> Union[BaseOutputParser, BaseGenerationOutputParser]:
+    """Get the appropriate function output parser given the user functions.
+
+    Args:
+        functions: Sequence where element is a dictionary, a pydantic.BaseModel class,
+            or a Python function. If a dictionary is passed in, it is assumed to
+            already be a valid OpenAI function.
+
+    Returns:
+        A PydanticOutputFunctionsParser if functions are Pydantic classes, otherwise
+            a JsonOutputFunctionsParser. If there's only one function and it is
+            not a Pydantic class, then the output parser will automatically extract
+            only the function arguments and not the function name.
+    """
+    if isinstance(functions[0], type) and issubclass(functions[0], BaseModel):
+        if len(functions) > 1:
+            pydantic_schema: Union[Dict, Type[BaseModel]] = {
+                convert_to_openai_function(fn)["name"]: fn for fn in functions
+            }
+        else:
+            pydantic_schema = functions[0]
+        output_parser: Union[
+            BaseOutputParser, BaseGenerationOutputParser
+        ] = PydanticOutputFunctionsParser(pydantic_schema=pydantic_schema)
+    else:
+        output_parser = JsonOutputFunctionsParser(args_only=len(functions) <= 1)
+    return output_parser
+
+
+def _create_openai_json_runnable(
+    output_schema: Union[Dict[str, Any], Type[BaseModel]],
+    llm: Runnable,
+    prompt: Optional[BasePromptTemplate] = None,
+    *,
+    output_parser: Optional[Union[BaseOutputParser, BaseGenerationOutputParser]] = None,
+) -> Runnable:
+    """"""
+    if isinstance(output_schema, type) and issubclass(output_schema, BaseModel):
+        output_parser = output_parser or PydanticOutputParser(
+            pydantic_object=output_schema,
+        )
+        schema_as_dict = convert_to_openai_function(output_schema)["parameters"]
+    else:
+        output_parser = output_parser or JsonOutputParser()
+        schema_as_dict = output_schema
+
+    llm = llm.bind(response_format={"type": "json_object"})
+    if prompt:
+        if "output_schema" in prompt.input_variables:
+            prompt = prompt.partial(output_schema=json.dumps(schema_as_dict, indent=2))
+
+        return prompt | llm | output_parser
+    else:
+        return llm | output_parser
+
+
+def _create_openai_functions_structured_output_runnable(
+    output_schema: Union[Dict[str, Any], Type[BaseModel]],
+    llm: Runnable,
+    prompt: Optional[BasePromptTemplate] = None,
+    *,
+    output_parser: Optional[Union[BaseOutputParser, BaseGenerationOutputParser]] = None,
+    **llm_kwargs: Any,
+) -> Runnable:
+    if isinstance(output_schema, dict):
+        function: Any = {
+            "name": "output_formatter",
+            "description": (
+                "Output formatter. Should always be used to format your response to the"
+                " user."
+            ),
+            "parameters": output_schema,
+        }
+    else:
+
+        class _OutputFormatter(BaseModel):
+            """Output formatter. Should always be used to format your response to the user."""  # noqa: E501
+
+            output: output_schema  # type: ignore
+
+        function = _OutputFormatter
+        output_parser = output_parser or PydanticAttrOutputFunctionsParser(
+            pydantic_schema=_OutputFormatter, attr_name="output"
+        )
+    return create_openai_fn_runnable(
+        [function],
+        llm,
+        prompt=prompt,
+        output_parser=output_parser,
+        **llm_kwargs,
+    )
diff --git a/llm/Lib/site-packages/langchain/chains/summarize/__init__.py b/llm/Lib/site-packages/langchain/chains/summarize/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..dcb7fb91e62daf1b074c0a821c34e324ffdc8fcf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/summarize/__init__.py
@@ -0,0 +1,166 @@
+"""Load summarizing chains."""
+from typing import Any, Mapping, Optional, Protocol
+
+from langchain_core.callbacks import Callbacks
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+
+from langchain.chains.combine_documents.base import BaseCombineDocumentsChain
+from langchain.chains.combine_documents.map_reduce import MapReduceDocumentsChain
+from langchain.chains.combine_documents.reduce import ReduceDocumentsChain
+from langchain.chains.combine_documents.refine import RefineDocumentsChain
+from langchain.chains.combine_documents.stuff import StuffDocumentsChain
+from langchain.chains.llm import LLMChain
+from langchain.chains.summarize import map_reduce_prompt, refine_prompts, stuff_prompt
+
+
+class LoadingCallable(Protocol):
+    """Interface for loading the combine documents chain."""
+
+    def __call__(
+        self, llm: BaseLanguageModel, **kwargs: Any
+    ) -> BaseCombineDocumentsChain:
+        """Callable to load the combine documents chain."""
+
+
+def _load_stuff_chain(
+    llm: BaseLanguageModel,
+    prompt: BasePromptTemplate = stuff_prompt.PROMPT,
+    document_variable_name: str = "text",
+    verbose: Optional[bool] = None,
+    **kwargs: Any,
+) -> StuffDocumentsChain:
+    llm_chain = LLMChain(llm=llm, prompt=prompt, verbose=verbose)  # type: ignore[arg-type]
+    # TODO: document prompt
+    return StuffDocumentsChain(
+        llm_chain=llm_chain,
+        document_variable_name=document_variable_name,
+        verbose=verbose,  # type: ignore[arg-type]
+        **kwargs,
+    )
+
+
+def _load_map_reduce_chain(
+    llm: BaseLanguageModel,
+    map_prompt: BasePromptTemplate = map_reduce_prompt.PROMPT,
+    combine_prompt: BasePromptTemplate = map_reduce_prompt.PROMPT,
+    combine_document_variable_name: str = "text",
+    map_reduce_document_variable_name: str = "text",
+    collapse_prompt: Optional[BasePromptTemplate] = None,
+    reduce_llm: Optional[BaseLanguageModel] = None,
+    collapse_llm: Optional[BaseLanguageModel] = None,
+    verbose: Optional[bool] = None,
+    token_max: int = 3000,
+    callbacks: Callbacks = None,
+    *,
+    collapse_max_retries: Optional[int] = None,
+    **kwargs: Any,
+) -> MapReduceDocumentsChain:
+    map_chain = LLMChain(
+        llm=llm,
+        prompt=map_prompt,
+        verbose=verbose,  # type: ignore[arg-type]
+        callbacks=callbacks,  # type: ignore[arg-type]
+    )
+    _reduce_llm = reduce_llm or llm
+    reduce_chain = LLMChain(
+        llm=_reduce_llm,
+        prompt=combine_prompt,
+        verbose=verbose,  # type: ignore[arg-type]
+        callbacks=callbacks,  # type: ignore[arg-type]
+    )
+    # TODO: document prompt
+    combine_documents_chain = StuffDocumentsChain(
+        llm_chain=reduce_chain,
+        document_variable_name=combine_document_variable_name,
+        verbose=verbose,  # type: ignore[arg-type]
+        callbacks=callbacks,
+    )
+    if collapse_prompt is None:
+        collapse_chain = None
+        if collapse_llm is not None:
+            raise ValueError(
+                "collapse_llm provided, but collapse_prompt was not: please "
+                "provide one or stop providing collapse_llm."
+            )
+    else:
+        _collapse_llm = collapse_llm or llm
+        collapse_chain = StuffDocumentsChain(
+            llm_chain=LLMChain(
+                llm=_collapse_llm,
+                prompt=collapse_prompt,
+                verbose=verbose,  # type: ignore[arg-type]
+                callbacks=callbacks,
+            ),
+            document_variable_name=combine_document_variable_name,
+        )
+    reduce_documents_chain = ReduceDocumentsChain(
+        combine_documents_chain=combine_documents_chain,
+        collapse_documents_chain=collapse_chain,
+        token_max=token_max,
+        verbose=verbose,  # type: ignore[arg-type]
+        callbacks=callbacks,
+        collapse_max_retries=collapse_max_retries,
+    )
+    return MapReduceDocumentsChain(
+        llm_chain=map_chain,
+        reduce_documents_chain=reduce_documents_chain,
+        document_variable_name=map_reduce_document_variable_name,
+        verbose=verbose,  # type: ignore[arg-type]
+        callbacks=callbacks,
+        **kwargs,
+    )
+
+
+def _load_refine_chain(
+    llm: BaseLanguageModel,
+    question_prompt: BasePromptTemplate = refine_prompts.PROMPT,
+    refine_prompt: BasePromptTemplate = refine_prompts.REFINE_PROMPT,
+    document_variable_name: str = "text",
+    initial_response_name: str = "existing_answer",
+    refine_llm: Optional[BaseLanguageModel] = None,
+    verbose: Optional[bool] = None,
+    **kwargs: Any,
+) -> RefineDocumentsChain:
+    initial_chain = LLMChain(llm=llm, prompt=question_prompt, verbose=verbose)  # type: ignore[arg-type]
+    _refine_llm = refine_llm or llm
+    refine_chain = LLMChain(llm=_refine_llm, prompt=refine_prompt, verbose=verbose)  # type: ignore[arg-type]
+    return RefineDocumentsChain(
+        initial_llm_chain=initial_chain,
+        refine_llm_chain=refine_chain,
+        document_variable_name=document_variable_name,
+        initial_response_name=initial_response_name,
+        verbose=verbose,  # type: ignore[arg-type]
+        **kwargs,
+    )
+
+
+def load_summarize_chain(
+    llm: BaseLanguageModel,
+    chain_type: str = "stuff",
+    verbose: Optional[bool] = None,
+    **kwargs: Any,
+) -> BaseCombineDocumentsChain:
+    """Load summarizing chain.
+
+    Args:
+        llm: Language Model to use in the chain.
+        chain_type: Type of document combining chain to use. Should be one of "stuff",
+            "map_reduce", and "refine".
+        verbose: Whether chains should be run in verbose mode or not. Note that this
+            applies to all chains that make up the final chain.
+
+    Returns:
+        A chain to use for summarizing.
+    """
+    loader_mapping: Mapping[str, LoadingCallable] = {
+        "stuff": _load_stuff_chain,
+        "map_reduce": _load_map_reduce_chain,
+        "refine": _load_refine_chain,
+    }
+    if chain_type not in loader_mapping:
+        raise ValueError(
+            f"Got unsupported chain type: {chain_type}. "
+            f"Should be one of {loader_mapping.keys()}"
+        )
+    return loader_mapping[chain_type](llm, verbose=verbose, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/chains/summarize/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/summarize/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b9f2fdebc3cde60f0e6ff1ecffc5b2a269586463
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/summarize/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/summarize/__pycache__/map_reduce_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/summarize/__pycache__/map_reduce_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..232c454cc1da06e8d0c9504eee57cb3fd6b95cf4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/summarize/__pycache__/map_reduce_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/summarize/__pycache__/refine_prompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/summarize/__pycache__/refine_prompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4b3cd299d9d43f268bc3d907814fd4034d05d354
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/summarize/__pycache__/refine_prompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/summarize/__pycache__/stuff_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/chains/summarize/__pycache__/stuff_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6cbca675be8371319813a65e7bcfff9b5fef05a1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chains/summarize/__pycache__/stuff_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chains/summarize/map_reduce_prompt.py b/llm/Lib/site-packages/langchain/chains/summarize/map_reduce_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..3cf06395c63b09f037f119a755b75e86d0a396d9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/summarize/map_reduce_prompt.py
@@ -0,0 +1,11 @@
+# flake8: noqa
+from langchain_core.prompts import PromptTemplate
+
+prompt_template = """Write a concise summary of the following:
+
+
+"{text}"
+
+
+CONCISE SUMMARY:"""
+PROMPT = PromptTemplate(template=prompt_template, input_variables=["text"])
diff --git a/llm/Lib/site-packages/langchain/chains/summarize/refine_prompts.py b/llm/Lib/site-packages/langchain/chains/summarize/refine_prompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..63c1c33880c02e9bd16f171f09f2546dc9ae7fd8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/summarize/refine_prompts.py
@@ -0,0 +1,23 @@
+from langchain_core.prompts import PromptTemplate
+
+REFINE_PROMPT_TMPL = """\
+Your job is to produce a final summary.
+We have provided an existing summary up to a certain point: {existing_answer}
+We have the opportunity to refine the existing summary (only if needed) with some more context below.
+------------
+{text}
+------------
+Given the new context, refine the original summary.
+If the context isn't useful, return the original summary.\
+"""  # noqa: E501
+REFINE_PROMPT = PromptTemplate.from_template(REFINE_PROMPT_TMPL)
+
+
+prompt_template = """Write a concise summary of the following:
+
+
+"{text}"
+
+
+CONCISE SUMMARY:"""
+PROMPT = PromptTemplate.from_template(prompt_template)
diff --git a/llm/Lib/site-packages/langchain/chains/summarize/stuff_prompt.py b/llm/Lib/site-packages/langchain/chains/summarize/stuff_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..3cf06395c63b09f037f119a755b75e86d0a396d9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/summarize/stuff_prompt.py
@@ -0,0 +1,11 @@
+# flake8: noqa
+from langchain_core.prompts import PromptTemplate
+
+prompt_template = """Write a concise summary of the following:
+
+
+"{text}"
+
+
+CONCISE SUMMARY:"""
+PROMPT = PromptTemplate(template=prompt_template, input_variables=["text"])
diff --git a/llm/Lib/site-packages/langchain/chains/transform.py b/llm/Lib/site-packages/langchain/chains/transform.py
new file mode 100644
index 0000000000000000000000000000000000000000..17a51b205c5cef40aff74d0bb05f92e81732eb6d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chains/transform.py
@@ -0,0 +1,83 @@
+"""Chain that runs an arbitrary python function."""
+import functools
+import logging
+from typing import Any, Awaitable, Callable, Dict, List, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+)
+from langchain_core.pydantic_v1 import Field
+
+from langchain.chains.base import Chain
+
+logger = logging.getLogger(__name__)
+
+
+class TransformChain(Chain):
+    """Chain that transforms the chain output.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.chains import TransformChain
+            transform_chain = TransformChain(input_variables=["text"],
+             output_variables["entities"], transform=func())
+    """
+
+    input_variables: List[str]
+    """The keys expected by the transform's input dictionary."""
+    output_variables: List[str]
+    """The keys returned by the transform's output dictionary."""
+    transform_cb: Callable[[Dict[str, str]], Dict[str, str]] = Field(alias="transform")
+    """The transform function."""
+    atransform_cb: Optional[
+        Callable[[Dict[str, Any]], Awaitable[Dict[str, Any]]]
+    ] = Field(None, alias="atransform")
+    """The async coroutine transform function."""
+
+    @staticmethod
+    @functools.lru_cache
+    def _log_once(msg: str) -> None:
+        """Log a message once.
+
+        :meta private:
+        """
+        logger.warning(msg)
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Expect input keys.
+
+        :meta private:
+        """
+        return self.input_variables
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return output keys.
+
+        :meta private:
+        """
+        return self.output_variables
+
+    def _call(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, str]:
+        return self.transform_cb(inputs)
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        if self.atransform_cb is not None:
+            return await self.atransform_cb(inputs)
+        else:
+            self._log_once(
+                "TransformChain's atransform is not provided, falling"
+                " back to synchronous transform"
+            )
+            return self.transform_cb(inputs)
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/__init__.py b/llm/Lib/site-packages/langchain/chat_loaders/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7547ddcecc85f36aaa8ccc3bc4d21fb6179cc29f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_loaders/__init__.py
@@ -0,0 +1,19 @@
+"""**Chat Loaders** load chat messages from common communications platforms.
+
+Load chat messages from various
+communications platforms such as Facebook Messenger, Telegram, and
+WhatsApp. The loaded chat messages can be used for fine-tuning models.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseChatLoader --> <name>ChatLoader  # Examples: WhatsAppChatLoader, IMessageChatLoader
+
+**Main helpers:**
+
+.. code-block::
+
+    ChatSession
+
+"""  # noqa: E501
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..db1fefd00209f8139ef045903e1fadd7e9fae1bc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a8b5ee8ce254c9ed46fa7247bb8bad3e5690af3f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/facebook_messenger.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/facebook_messenger.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e77f3eb2e178805ed49f22805e66f7a2a9a38e9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/facebook_messenger.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/gmail.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/gmail.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cb7fa3aee40bf654f19d68f1f3dcc04ee60d3ff6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/gmail.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/imessage.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/imessage.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1a47ffbd72133d78d7332cbc9960cb14b5071cd9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/imessage.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/langsmith.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/langsmith.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..56b2a6d3ae820b95a818e15f414987e4ac26482e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/langsmith.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/slack.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/slack.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..597fd27d5ad7385eaa59e29ccfdd63538f609489
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/slack.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/telegram.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/telegram.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2909483fced0184e37197be2c67ad9beb5075702
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/telegram.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0d1e37ba79d08a7e056d9549982b504bcbb80911
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/whatsapp.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/whatsapp.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a87c35e34d567d60095e8b0f7fd226260e98c469
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_loaders/__pycache__/whatsapp.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/base.py b/llm/Lib/site-packages/langchain/chat_loaders/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..a7035e0018e291c167864e8cb97038e05925c13e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_loaders/base.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_loaders.base import BaseChatLoader
+
+__all__ = ["BaseChatLoader"]
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/facebook_messenger.py b/llm/Lib/site-packages/langchain/chat_loaders/facebook_messenger.py
new file mode 100644
index 0000000000000000000000000000000000000000..389ae17b26546d1574aadc209077c0cd206195fb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_loaders/facebook_messenger.py
@@ -0,0 +1,6 @@
+from langchain_community.chat_loaders.facebook_messenger import (
+    FolderFacebookMessengerChatLoader,
+    SingleFileFacebookMessengerChatLoader,
+)
+
+__all__ = ["SingleFileFacebookMessengerChatLoader", "FolderFacebookMessengerChatLoader"]
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/gmail.py b/llm/Lib/site-packages/langchain/chat_loaders/gmail.py
new file mode 100644
index 0000000000000000000000000000000000000000..56828e7ad2eb3f3fc582f96c2989e2b3916a383b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_loaders/gmail.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_loaders.gmail import (
+    GMailLoader,
+)
+
+__all__ = ["GMailLoader"]
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/imessage.py b/llm/Lib/site-packages/langchain/chat_loaders/imessage.py
new file mode 100644
index 0000000000000000000000000000000000000000..efae0b51c4ca61eb190743584cdafcee177b3843
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_loaders/imessage.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_loaders.imessage import IMessageChatLoader
+
+__all__ = ["IMessageChatLoader"]
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/langsmith.py b/llm/Lib/site-packages/langchain/chat_loaders/langsmith.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d57f12bb73b61aafb19ce15d684644ed5e89550
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_loaders/langsmith.py
@@ -0,0 +1,6 @@
+from langchain_community.chat_loaders.langsmith import (
+    LangSmithDatasetChatLoader,
+    LangSmithRunChatLoader,
+)
+
+__all__ = ["LangSmithRunChatLoader", "LangSmithDatasetChatLoader"]
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/slack.py b/llm/Lib/site-packages/langchain/chat_loaders/slack.py
new file mode 100644
index 0000000000000000000000000000000000000000..023dd32983261bee23ea1b0966112c58cf733998
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_loaders/slack.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_loaders.slack import SlackChatLoader
+
+__all__ = ["SlackChatLoader"]
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/telegram.py b/llm/Lib/site-packages/langchain/chat_loaders/telegram.py
new file mode 100644
index 0000000000000000000000000000000000000000..c39b6772f0882b76b248c674ee73fc1308f25727
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_loaders/telegram.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_loaders.telegram import TelegramChatLoader
+
+__all__ = ["TelegramChatLoader"]
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/utils.py b/llm/Lib/site-packages/langchain/chat_loaders/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..629858f2867ad20217aab50cf6827d41774fc047
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_loaders/utils.py
@@ -0,0 +1,13 @@
+from langchain_community.chat_loaders.utils import (
+    map_ai_messages,
+    map_ai_messages_in_session,
+    merge_chat_runs,
+    merge_chat_runs_in_session,
+)
+
+__all__ = [
+    "merge_chat_runs_in_session",
+    "merge_chat_runs",
+    "map_ai_messages_in_session",
+    "map_ai_messages",
+]
diff --git a/llm/Lib/site-packages/langchain/chat_loaders/whatsapp.py b/llm/Lib/site-packages/langchain/chat_loaders/whatsapp.py
new file mode 100644
index 0000000000000000000000000000000000000000..176629bc7fc7298ce2cba98e24e16d22967bf570
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_loaders/whatsapp.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_loaders.whatsapp import WhatsAppChatLoader
+
+__all__ = ["WhatsAppChatLoader"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/__init__.py b/llm/Lib/site-packages/langchain/chat_models/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..69639536203e014ce5fd9563eec6989b3ce826b0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/__init__.py
@@ -0,0 +1,74 @@
+"""**Chat Models** are a variation on language models.
+
+While Chat Models use language models under the hood, the interface they expose
+is a bit different. Rather than expose a "text in, text out" API, they expose
+an interface where "chat messages" are the inputs and outputs.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseLanguageModel --> BaseChatModel --> <name>  # Examples: ChatOpenAI, ChatGooglePalm
+
+**Main helpers:**
+
+.. code-block::
+
+    AIMessage, BaseMessage, HumanMessage
+"""  # noqa: E501
+import warnings
+
+from langchain_core._api import LangChainDeprecationWarning
+
+from langchain.utils.interactive_env import is_interactive_env
+
+
+def __getattr__(name: str) -> None:
+    from langchain_community import chat_models
+
+    # If not in interactive env, raise warning.
+    if not is_interactive_env():
+        warnings.warn(
+            "Importing chat models from langchain is deprecated. Importing from "
+            "langchain will no longer be supported as of langchain==0.2.0. "
+            "Please import from langchain-community instead:\n\n"
+            f"`from langchain_community.chat_models import {name}`.\n\n"
+            "To install langchain-community run `pip install -U langchain-community`.",
+            category=LangChainDeprecationWarning,
+        )
+
+    return getattr(chat_models, name)
+
+
+__all__ = [
+    "ChatOpenAI",
+    "BedrockChat",
+    "AzureChatOpenAI",
+    "FakeListChatModel",
+    "PromptLayerChatOpenAI",
+    "ChatDatabricks",
+    "ChatEverlyAI",
+    "ChatAnthropic",
+    "ChatCohere",
+    "ChatGooglePalm",
+    "ChatMlflow",
+    "ChatMLflowAIGateway",
+    "ChatOllama",
+    "ChatVertexAI",
+    "JinaChat",
+    "HumanInputChatModel",
+    "MiniMaxChat",
+    "ChatAnyscale",
+    "ChatLiteLLM",
+    "ErnieBotChat",
+    "ChatJavelinAIGateway",
+    "ChatKonko",
+    "PaiEasChatEndpoint",
+    "QianfanChatEndpoint",
+    "ChatFireworks",
+    "ChatYandexGPT",
+    "ChatBaichuan",
+    "ChatHunyuan",
+    "GigaChat",
+    "VolcEngineMaasChat",
+]
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..86154a2b5e30dbfe3f1dccf5f2dacb42b9f585a7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/anthropic.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/anthropic.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e3444580ba5a4709e90151e03271b705583388a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/anthropic.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/anyscale.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/anyscale.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..71215e7789bd65d1fa10947e173f61d6c9d2f8de
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/anyscale.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/azure_openai.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/azure_openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d13851e95c78efc13e99dccd3556c5f8a751ee4c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/azure_openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/azureml_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/azureml_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5af6cf556e9e6c0cd24a25128fe7672d1b033a73
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/azureml_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/baichuan.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/baichuan.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b670186b45ba52a2188c3ee52aa43ce0c70eedc9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/baichuan.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1e853cdcdea10b5418b646ec187df44744a7f1e4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..45eb67ca95240d4a30c70e3d96988a8549af52ce
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/bedrock.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/bedrock.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5898e240690315771c3e9824c10e79e407c02e9a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/bedrock.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/cohere.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/cohere.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..53f815ae7e99a515ba2e306f087d1e60ee957508
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/cohere.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/databricks.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/databricks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a189a4c13f1ea58b00a0a024330bc48dfbb427ec
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/databricks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/ernie.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/ernie.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6476a3d00f6d5f687f8c56668683b167d8552369
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/ernie.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/everlyai.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/everlyai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e19af76816951058d82e1e0dfdd82987c783443d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/everlyai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/fake.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/fake.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..67c86785d5fbb0bd4070c0cc5706f98e3b343fc2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/fake.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/fireworks.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/fireworks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..be9e5614274f17fb61ab1844ea854939c78bde65
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/fireworks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/gigachat.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/gigachat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dcc9bfa806f2cdcf9f93ed432590f8499c0d7070
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/gigachat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/google_palm.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/google_palm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c0709b39bba3faabc570ec784044a071a4908218
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/google_palm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/human.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/human.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4fed6d9a5186598a8269904381f505cf65d42ab9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/human.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/hunyuan.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/hunyuan.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..85345f8027868a6166306549787be85a98009e4d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/hunyuan.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/javelin_ai_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/javelin_ai_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..75bd6ac3ae909b8f8e4e37109be9ef2157a5574d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/javelin_ai_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/jinachat.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/jinachat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4b6d462e0cfa85bd02ed5caf2c6e5fbee754a108
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/jinachat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/konko.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/konko.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4a252163abb0c1ae5476d1a5309a27342ccbe1f0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/konko.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/litellm.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/litellm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f71c473b3c8c7d58489159ba493054fbc303a919
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/litellm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/meta.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/meta.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8da6381a10b0bd08a7dea5683577bb6414198799
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/meta.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/minimax.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/minimax.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a4e2c439a6e72ae609e0862be5323250d459fd7f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/minimax.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/mlflow.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/mlflow.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..707ee6d8961eafd1d3fc34c723f593f5a56235cb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/mlflow.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/mlflow_ai_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/mlflow_ai_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ad073b38b182db5203c10354aa148a1fbdb68df5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/mlflow_ai_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/ollama.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/ollama.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..67e8fcb7a031a1686854d88c3fb3765e47e52e0b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/ollama.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/openai.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c70ae2a3fa5e5cde69d228ff3e6ae584a733aa3a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/pai_eas_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/pai_eas_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5bcca8a62a20105a36f95265edee02622f937c99
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/pai_eas_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/promptlayer_openai.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/promptlayer_openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8d94a4132ec4ae4d6e9d16b09ce61181e376d350
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/promptlayer_openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/tongyi.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/tongyi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d1b98a86e0e1f4699c3aef123ad983469e084309
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/tongyi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/vertexai.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/vertexai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..58bed47ddef9bea29963907fd1b9dc38534e3a1e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/vertexai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/volcengine_maas.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/volcengine_maas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d685c085032266ed531c9d7b9fa52518ffb53fb7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/volcengine_maas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/__pycache__/yandex.cpython-311.pyc b/llm/Lib/site-packages/langchain/chat_models/__pycache__/yandex.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..11a6f4f73ac17d7d50850d49ea045e691e691d64
Binary files /dev/null and b/llm/Lib/site-packages/langchain/chat_models/__pycache__/yandex.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/chat_models/anthropic.py b/llm/Lib/site-packages/langchain/chat_models/anthropic.py
new file mode 100644
index 0000000000000000000000000000000000000000..2a1f287ffd94c6f5c2f1c3eea639ff6b4412856f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/anthropic.py
@@ -0,0 +1,9 @@
+from langchain_community.chat_models.anthropic import (
+    ChatAnthropic,
+    convert_messages_to_prompt_anthropic,
+)
+
+__all__ = [
+    "convert_messages_to_prompt_anthropic",
+    "ChatAnthropic",
+]
diff --git a/llm/Lib/site-packages/langchain/chat_models/anyscale.py b/llm/Lib/site-packages/langchain/chat_models/anyscale.py
new file mode 100644
index 0000000000000000000000000000000000000000..d49021b4cbc87768e5a362415b8a0efd2eaaa28f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/anyscale.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_models.anyscale import (
+    ChatAnyscale,
+)
+
+__all__ = ["ChatAnyscale"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/azure_openai.py b/llm/Lib/site-packages/langchain/chat_models/azure_openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..42380cd0e5a01687b19a41a016fe1b3936ccf5fa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/azure_openai.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_models.azure_openai import AzureChatOpenAI
+
+__all__ = ["AzureChatOpenAI"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/azureml_endpoint.py b/llm/Lib/site-packages/langchain/chat_models/azureml_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..4acdfad01f5ef929e02e1b3240e06f6c2ab7c877
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/azureml_endpoint.py
@@ -0,0 +1,6 @@
+from langchain_community.chat_models.azureml_endpoint import (
+    AzureMLChatOnlineEndpoint,
+    LlamaContentFormatter,
+)
+
+__all__ = ["LlamaContentFormatter", "AzureMLChatOnlineEndpoint"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/baichuan.py b/llm/Lib/site-packages/langchain/chat_models/baichuan.py
new file mode 100644
index 0000000000000000000000000000000000000000..44488581931e587ebd8e97222b17d84fe3a2c0c1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/baichuan.py
@@ -0,0 +1,7 @@
+from langchain_community.chat_models.baichuan import (
+    ChatBaichuan,
+)
+
+__all__ = [
+    "ChatBaichuan",
+]
diff --git a/llm/Lib/site-packages/langchain/chat_models/baidu_qianfan_endpoint.py b/llm/Lib/site-packages/langchain/chat_models/baidu_qianfan_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba3a023ec8a196b5bdd9ea07e1bece341f2e009e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/baidu_qianfan_endpoint.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_models.baidu_qianfan_endpoint import (
+    QianfanChatEndpoint,
+)
+
+__all__ = ["QianfanChatEndpoint"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/base.py b/llm/Lib/site-packages/langchain/chat_models/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..49a71f08dec0d895274550a8d068df7eef81a2aa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/base.py
@@ -0,0 +1,13 @@
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    SimpleChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+
+__all__ = [
+    "BaseChatModel",
+    "SimpleChatModel",
+    "generate_from_stream",
+    "agenerate_from_stream",
+]
diff --git a/llm/Lib/site-packages/langchain/chat_models/bedrock.py b/llm/Lib/site-packages/langchain/chat_models/bedrock.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b0f49a147481daf7be2008b09daf55ead1c2f98
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/bedrock.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_models.bedrock import BedrockChat, ChatPromptAdapter
+
+__all__ = ["ChatPromptAdapter", "BedrockChat"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/cohere.py b/llm/Lib/site-packages/langchain/chat_models/cohere.py
new file mode 100644
index 0000000000000000000000000000000000000000..63cbc46711e65280284b118c20bbf0738476243b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/cohere.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_models.cohere import (
+    ChatCohere,
+)
+
+__all__ = ["ChatCohere"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/databricks.py b/llm/Lib/site-packages/langchain/chat_models/databricks.py
new file mode 100644
index 0000000000000000000000000000000000000000..b73d49b04bab0db4cac284567e55f659ba0b3518
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/databricks.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_models.databricks import ChatDatabricks
+
+__all__ = ["ChatDatabricks"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/ernie.py b/llm/Lib/site-packages/langchain/chat_models/ernie.py
new file mode 100644
index 0000000000000000000000000000000000000000..6dbdb34e072b3073036fad0b0546f41ff57bd631
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/ernie.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_models.ernie import ErnieBotChat
+
+__all__ = ["ErnieBotChat"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/everlyai.py b/llm/Lib/site-packages/langchain/chat_models/everlyai.py
new file mode 100644
index 0000000000000000000000000000000000000000..edeeea78ea803c8e832f9633ae913ddea01a3a3f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/everlyai.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_models.everlyai import (
+    ChatEverlyAI,
+)
+
+__all__ = ["ChatEverlyAI"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/fake.py b/llm/Lib/site-packages/langchain/chat_models/fake.py
new file mode 100644
index 0000000000000000000000000000000000000000..24c98e115d501c015d37c6304d5042f5da69ac45
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/fake.py
@@ -0,0 +1,6 @@
+from langchain_community.chat_models.fake import (
+    FakeListChatModel,
+    FakeMessagesListChatModel,
+)
+
+__all__ = ["FakeMessagesListChatModel", "FakeListChatModel"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/fireworks.py b/llm/Lib/site-packages/langchain/chat_models/fireworks.py
new file mode 100644
index 0000000000000000000000000000000000000000..0e5fd2cefcb1714ad1b60531751ec206bbc1acfa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/fireworks.py
@@ -0,0 +1,7 @@
+from langchain_community.chat_models.fireworks import (
+    ChatFireworks,
+)
+
+__all__ = [
+    "ChatFireworks",
+]
diff --git a/llm/Lib/site-packages/langchain/chat_models/gigachat.py b/llm/Lib/site-packages/langchain/chat_models/gigachat.py
new file mode 100644
index 0000000000000000000000000000000000000000..9dff7f28ebadbb26413d2bb197ee47d5e8236330
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/gigachat.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_models.gigachat import (
+    GigaChat,
+)
+
+__all__ = ["GigaChat"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/google_palm.py b/llm/Lib/site-packages/langchain/chat_models/google_palm.py
new file mode 100644
index 0000000000000000000000000000000000000000..6acab6dee7307cf24c920f05d0c55cd4076f0276
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/google_palm.py
@@ -0,0 +1,6 @@
+from langchain_community.chat_models.google_palm import (
+    ChatGooglePalm,
+    ChatGooglePalmError,
+)
+
+__all__ = ["ChatGooglePalm", "ChatGooglePalmError"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/human.py b/llm/Lib/site-packages/langchain/chat_models/human.py
new file mode 100644
index 0000000000000000000000000000000000000000..2b7448ca91f84c78927a51e4182604f485996965
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/human.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_models.human import (
+    HumanInputChatModel,
+)
+
+__all__ = ["HumanInputChatModel"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/hunyuan.py b/llm/Lib/site-packages/langchain/chat_models/hunyuan.py
new file mode 100644
index 0000000000000000000000000000000000000000..a5a7d121ae9d72b6ca3a535e41ad2c6c56a32509
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/hunyuan.py
@@ -0,0 +1,7 @@
+from langchain_community.chat_models.hunyuan import (
+    ChatHunyuan,
+)
+
+__all__ = [
+    "ChatHunyuan",
+]
diff --git a/llm/Lib/site-packages/langchain/chat_models/javelin_ai_gateway.py b/llm/Lib/site-packages/langchain/chat_models/javelin_ai_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..131e3c33a8ebe4ab3aabf39cc3627b5845a22177
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/javelin_ai_gateway.py
@@ -0,0 +1,6 @@
+from langchain_community.chat_models.javelin_ai_gateway import (
+    ChatJavelinAIGateway,
+    ChatParams,
+)
+
+__all__ = ["ChatJavelinAIGateway", "ChatParams"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/jinachat.py b/llm/Lib/site-packages/langchain/chat_models/jinachat.py
new file mode 100644
index 0000000000000000000000000000000000000000..816dfa55c52f0677c6408e69238d5a1230ad73c6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/jinachat.py
@@ -0,0 +1,7 @@
+from langchain_community.chat_models.jinachat import (
+    JinaChat,
+)
+
+__all__ = [
+    "JinaChat",
+]
diff --git a/llm/Lib/site-packages/langchain/chat_models/konko.py b/llm/Lib/site-packages/langchain/chat_models/konko.py
new file mode 100644
index 0000000000000000000000000000000000000000..4f7d5c2cb7b5ac17c1bc7d4c53223417dbbadff7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/konko.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_models.konko import (
+    ChatKonko,
+)
+
+__all__ = ["ChatKonko"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/litellm.py b/llm/Lib/site-packages/langchain/chat_models/litellm.py
new file mode 100644
index 0000000000000000000000000000000000000000..87e4ad7347d9b4022411306e63b1c56bf0b62347
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/litellm.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_models.litellm import ChatLiteLLM, ChatLiteLLMException
+
+__all__ = ["ChatLiteLLM", "ChatLiteLLMException"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/meta.py b/llm/Lib/site-packages/langchain/chat_models/meta.py
new file mode 100644
index 0000000000000000000000000000000000000000..5284601ff3865cd0ecf0c2cc962b3ac9fc884bc7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/meta.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_models.meta import (
+    convert_messages_to_prompt_llama,
+)
+
+__all__ = ["convert_messages_to_prompt_llama"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/minimax.py b/llm/Lib/site-packages/langchain/chat_models/minimax.py
new file mode 100644
index 0000000000000000000000000000000000000000..7363e27fee7d5e41471110cc85ff2f07fb4a0078
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/minimax.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_models.minimax import (
+    MiniMaxChat,
+)
+
+__all__ = ["MiniMaxChat"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/mlflow.py b/llm/Lib/site-packages/langchain/chat_models/mlflow.py
new file mode 100644
index 0000000000000000000000000000000000000000..380b9505b1d7dc45eb5790c3939fb0627ef5fc90
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/mlflow.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_models.mlflow import ChatMlflow
+
+__all__ = ["ChatMlflow"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/mlflow_ai_gateway.py b/llm/Lib/site-packages/langchain/chat_models/mlflow_ai_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..101edb7a776ca40acde23cdd0c5d28a385e9238f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/mlflow_ai_gateway.py
@@ -0,0 +1,6 @@
+from langchain_community.chat_models.mlflow_ai_gateway import (
+    ChatMLflowAIGateway,
+    ChatParams,
+)
+
+__all__ = ["ChatMLflowAIGateway", "ChatParams"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/ollama.py b/llm/Lib/site-packages/langchain/chat_models/ollama.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff872b8c6b86270003c6105ebe85c6057e904a19
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/ollama.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_models.ollama import (
+    ChatOllama,
+)
+
+__all__ = ["ChatOllama"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/openai.py b/llm/Lib/site-packages/langchain/chat_models/openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..18922fd22b159bde8de46d53094405a45ed53cf3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/openai.py
@@ -0,0 +1,7 @@
+from langchain_community.chat_models.openai import (
+    ChatOpenAI,
+)
+
+__all__ = [
+    "ChatOpenAI",
+]
diff --git a/llm/Lib/site-packages/langchain/chat_models/pai_eas_endpoint.py b/llm/Lib/site-packages/langchain/chat_models/pai_eas_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..14b2fd4e74224c1673fb2c77a5fbc1dae8c7f7bf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/pai_eas_endpoint.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_models.pai_eas_endpoint import PaiEasChatEndpoint
+
+__all__ = ["PaiEasChatEndpoint"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/promptlayer_openai.py b/llm/Lib/site-packages/langchain/chat_models/promptlayer_openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..cceb5702cd984c03fb997e84fefb457a1f090aef
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/promptlayer_openai.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_models.promptlayer_openai import PromptLayerChatOpenAI
+
+__all__ = ["PromptLayerChatOpenAI"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/tongyi.py b/llm/Lib/site-packages/langchain/chat_models/tongyi.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ee9bc4f6252ec71ad62bcefe676b66b984c2cde
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/tongyi.py
@@ -0,0 +1,7 @@
+from langchain_community.chat_models.tongyi import (
+    ChatTongyi,
+)
+
+__all__ = [
+    "ChatTongyi",
+]
diff --git a/llm/Lib/site-packages/langchain/chat_models/vertexai.py b/llm/Lib/site-packages/langchain/chat_models/vertexai.py
new file mode 100644
index 0000000000000000000000000000000000000000..a5096fcce816ff51a1910752f539911e5576de3c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/vertexai.py
@@ -0,0 +1,7 @@
+from langchain_community.chat_models.vertexai import (
+    ChatVertexAI,
+)
+
+__all__ = [
+    "ChatVertexAI",
+]
diff --git a/llm/Lib/site-packages/langchain/chat_models/volcengine_maas.py b/llm/Lib/site-packages/langchain/chat_models/volcengine_maas.py
new file mode 100644
index 0000000000000000000000000000000000000000..b6628ef1aed5f4cd597b23d6650eb4cb22dd25aa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/volcengine_maas.py
@@ -0,0 +1,6 @@
+from langchain_community.chat_models.volcengine_maas import (
+    VolcEngineMaasChat,
+    convert_dict_to_message,
+)
+
+__all__ = ["convert_dict_to_message", "VolcEngineMaasChat"]
diff --git a/llm/Lib/site-packages/langchain/chat_models/yandex.py b/llm/Lib/site-packages/langchain/chat_models/yandex.py
new file mode 100644
index 0000000000000000000000000000000000000000..05cb4cbea5df602573a2437a592e6b4fc7a62f74
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/chat_models/yandex.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_models.yandex import (
+    ChatYandexGPT,
+)
+
+__all__ = ["ChatYandexGPT"]
diff --git a/llm/Lib/site-packages/langchain/docstore/__init__.py b/llm/Lib/site-packages/langchain/docstore/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6be963a63c0183ef7ff727b3ef1b11d5ecff9d84
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/docstore/__init__.py
@@ -0,0 +1,42 @@
+"""**Docstores** are classes to store and load Documents.
+
+The **Docstore** is a simplified version of the Document Loader.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    Docstore --> <name> # Examples: InMemoryDocstore, Wikipedia
+
+**Main helpers:**
+
+.. code-block::
+
+    Document, AddableMixin
+"""
+import warnings
+from typing import Any
+
+from langchain_core._api import LangChainDeprecationWarning
+
+from langchain.utils.interactive_env import is_interactive_env
+
+
+def __getattr__(name: str) -> Any:
+    from langchain_community import docstore
+
+    # If not in interactive env, raise warning.
+    if not is_interactive_env():
+        warnings.warn(
+            "Importing docstores from langchain is deprecated. Importing from "
+            "langchain will no longer be supported as of langchain==0.2.0. "
+            "Please import from langchain-community instead:\n\n"
+            f"`from langchain_community.docstore import {name}`.\n\n"
+            "To install langchain-community run `pip install -U langchain-community`.",
+            category=LangChainDeprecationWarning,
+        )
+
+    return getattr(docstore, name)
+
+
+__all__ = ["DocstoreFn", "InMemoryDocstore", "Wikipedia"]
diff --git a/llm/Lib/site-packages/langchain/docstore/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/docstore/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c78ae46a47aa863bec13b046872fb37e62ef3444
Binary files /dev/null and b/llm/Lib/site-packages/langchain/docstore/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/docstore/__pycache__/arbitrary_fn.cpython-311.pyc b/llm/Lib/site-packages/langchain/docstore/__pycache__/arbitrary_fn.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..299af90371cb26a348489f0bc85ddf52fd22ba16
Binary files /dev/null and b/llm/Lib/site-packages/langchain/docstore/__pycache__/arbitrary_fn.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/docstore/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/docstore/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a03c511fe62ca4a4d8ee9937c4417111fbb253fb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/docstore/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/docstore/__pycache__/document.cpython-311.pyc b/llm/Lib/site-packages/langchain/docstore/__pycache__/document.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fd121fe7040630063b2f3ae4e411b9a89d9ac077
Binary files /dev/null and b/llm/Lib/site-packages/langchain/docstore/__pycache__/document.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/docstore/__pycache__/in_memory.cpython-311.pyc b/llm/Lib/site-packages/langchain/docstore/__pycache__/in_memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..473fd50dd404777b1df6f40862dc662fa5e62acd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/docstore/__pycache__/in_memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/docstore/__pycache__/wikipedia.cpython-311.pyc b/llm/Lib/site-packages/langchain/docstore/__pycache__/wikipedia.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e8be801ba312e76cdbf201f1798c75ec1ddc14a8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/docstore/__pycache__/wikipedia.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/docstore/arbitrary_fn.py b/llm/Lib/site-packages/langchain/docstore/arbitrary_fn.py
new file mode 100644
index 0000000000000000000000000000000000000000..27b465a69c9cd8c0444a5840f51c01087f52dc92
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/docstore/arbitrary_fn.py
@@ -0,0 +1,3 @@
+from langchain_community.docstore.arbitrary_fn import DocstoreFn
+
+__all__ = ["DocstoreFn"]
diff --git a/llm/Lib/site-packages/langchain/docstore/base.py b/llm/Lib/site-packages/langchain/docstore/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..8c24f5e87369e7d7acdd01becb36348b92f69d04
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/docstore/base.py
@@ -0,0 +1,3 @@
+from langchain_community.docstore.base import AddableMixin, Docstore
+
+__all__ = ["Docstore", "AddableMixin"]
diff --git a/llm/Lib/site-packages/langchain/docstore/document.py b/llm/Lib/site-packages/langchain/docstore/document.py
new file mode 100644
index 0000000000000000000000000000000000000000..88aebd279509aa19084281e0a84e647ee39b1849
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/docstore/document.py
@@ -0,0 +1,3 @@
+from langchain_core.documents import Document
+
+__all__ = ["Document"]
diff --git a/llm/Lib/site-packages/langchain/docstore/in_memory.py b/llm/Lib/site-packages/langchain/docstore/in_memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba07a97e473104988058a66965d202e15c6687db
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/docstore/in_memory.py
@@ -0,0 +1,3 @@
+from langchain_community.docstore.in_memory import InMemoryDocstore
+
+__all__ = ["InMemoryDocstore"]
diff --git a/llm/Lib/site-packages/langchain/docstore/wikipedia.py b/llm/Lib/site-packages/langchain/docstore/wikipedia.py
new file mode 100644
index 0000000000000000000000000000000000000000..1aa72728920f44f60304437a4fc4eec9fe9efe2a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/docstore/wikipedia.py
@@ -0,0 +1,3 @@
+from langchain_community.docstore.wikipedia import Wikipedia
+
+__all__ = ["Wikipedia"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/acreom.py b/llm/Lib/site-packages/langchain/document_loaders/acreom.py
new file mode 100644
index 0000000000000000000000000000000000000000..eb72b3e20cef49ba65be9433c93b7015d585d33c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/acreom.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.acreom import AcreomLoader
+
+__all__ = ["AcreomLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/airbyte.py b/llm/Lib/site-packages/langchain/document_loaders/airbyte.py
new file mode 100644
index 0000000000000000000000000000000000000000..33a8dd656ab6f7d4c178eacc22df33b70df06b0c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/airbyte.py
@@ -0,0 +1,23 @@
+from langchain_community.document_loaders.airbyte import (
+    AirbyteCDKLoader,
+    AirbyteGongLoader,
+    AirbyteHubspotLoader,
+    AirbyteSalesforceLoader,
+    AirbyteShopifyLoader,
+    AirbyteStripeLoader,
+    AirbyteTypeformLoader,
+    AirbyteZendeskSupportLoader,
+    RecordHandler,
+)
+
+__all__ = [
+    "RecordHandler",
+    "AirbyteCDKLoader",
+    "AirbyteHubspotLoader",
+    "AirbyteStripeLoader",
+    "AirbyteTypeformLoader",
+    "AirbyteZendeskSupportLoader",
+    "AirbyteShopifyLoader",
+    "AirbyteSalesforceLoader",
+    "AirbyteGongLoader",
+]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/airbyte_json.py b/llm/Lib/site-packages/langchain/document_loaders/airbyte_json.py
new file mode 100644
index 0000000000000000000000000000000000000000..c0287d00e2312d146873975b28b8456984149aa7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/airbyte_json.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.airbyte_json import AirbyteJSONLoader
+
+__all__ = ["AirbyteJSONLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/airtable.py b/llm/Lib/site-packages/langchain/document_loaders/airtable.py
new file mode 100644
index 0000000000000000000000000000000000000000..928d4ebd0cf1b332020dc03f864e2a95aa3a1bec
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/airtable.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.airtable import AirtableLoader
+
+__all__ = ["AirtableLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/apify_dataset.py b/llm/Lib/site-packages/langchain/document_loaders/apify_dataset.py
new file mode 100644
index 0000000000000000000000000000000000000000..59aead66ab6dcaf36a3931b9adf3d01d35a4b416
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/apify_dataset.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.apify_dataset import ApifyDatasetLoader
+
+__all__ = ["ApifyDatasetLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/arcgis_loader.py b/llm/Lib/site-packages/langchain/document_loaders/arcgis_loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce914c4c0b897ae531f2e0180a9aa5881b5a319d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/arcgis_loader.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.arcgis_loader import (
+    ArcGISLoader,
+)
+
+__all__ = ["ArcGISLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/arxiv.py b/llm/Lib/site-packages/langchain/document_loaders/arxiv.py
new file mode 100644
index 0000000000000000000000000000000000000000..eb650b64dd7b099cc6e9b6c076e3d9991d1b3623
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/arxiv.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.arxiv import ArxivLoader
+
+__all__ = ["ArxivLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/assemblyai.py b/llm/Lib/site-packages/langchain/document_loaders/assemblyai.py
new file mode 100644
index 0000000000000000000000000000000000000000..af430c6734334623f3fea9fab127a17ec26d2288
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/assemblyai.py
@@ -0,0 +1,6 @@
+from langchain_community.document_loaders.assemblyai import (
+    AssemblyAIAudioTranscriptLoader,
+    TranscriptFormat,
+)
+
+__all__ = ["TranscriptFormat", "AssemblyAIAudioTranscriptLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/async_html.py b/llm/Lib/site-packages/langchain/document_loaders/async_html.py
new file mode 100644
index 0000000000000000000000000000000000000000..92dd2fd3f3641e5dc0f1fff540bfd2c986e55bf2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/async_html.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.async_html import (
+    AsyncHtmlLoader,
+)
+
+__all__ = ["AsyncHtmlLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/azlyrics.py b/llm/Lib/site-packages/langchain/document_loaders/azlyrics.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f3be2d47c0d94fad51daf594ecb6bf0faa399ed
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/azlyrics.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.azlyrics import AZLyricsLoader
+
+__all__ = ["AZLyricsLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/azure_ai_data.py b/llm/Lib/site-packages/langchain/document_loaders/azure_ai_data.py
new file mode 100644
index 0000000000000000000000000000000000000000..294dbd8a2cd8e18cbac83f56ec1a8593caf0774d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/azure_ai_data.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.azure_ai_data import AzureAIDataLoader
+
+__all__ = ["AzureAIDataLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/azure_blob_storage_container.py b/llm/Lib/site-packages/langchain/document_loaders/azure_blob_storage_container.py
new file mode 100644
index 0000000000000000000000000000000000000000..e535e037671ca5d9f5ba73955a5d6ffc450eec03
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/azure_blob_storage_container.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.azure_blob_storage_container import (
+    AzureBlobStorageContainerLoader,
+)
+
+__all__ = ["AzureBlobStorageContainerLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/azure_blob_storage_file.py b/llm/Lib/site-packages/langchain/document_loaders/azure_blob_storage_file.py
new file mode 100644
index 0000000000000000000000000000000000000000..e07bdd33e26b201c1e9f6ed3a32115d7a8e4f4ff
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/azure_blob_storage_file.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.azure_blob_storage_file import (
+    AzureBlobStorageFileLoader,
+)
+
+__all__ = ["AzureBlobStorageFileLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/baiducloud_bos_directory.py b/llm/Lib/site-packages/langchain/document_loaders/baiducloud_bos_directory.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2bdf8312134c0e842f2b7dd21e00e3d1ff4e751
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/baiducloud_bos_directory.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.baiducloud_bos_directory import (
+    BaiduBOSDirectoryLoader,
+)
+
+__all__ = ["BaiduBOSDirectoryLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/baiducloud_bos_file.py b/llm/Lib/site-packages/langchain/document_loaders/baiducloud_bos_file.py
new file mode 100644
index 0000000000000000000000000000000000000000..d312fbdd6e71a3e3d96e4315a9146d90f0eb1c0e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/baiducloud_bos_file.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.baiducloud_bos_file import BaiduBOSFileLoader
+
+__all__ = ["BaiduBOSFileLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/base.py b/llm/Lib/site-packages/langchain/document_loaders/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..e6326d681d0f224c0e65b70efeaa8b430246f8e0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/base.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.base import BaseBlobParser, BaseLoader
+
+__all__ = ["BaseLoader", "BaseBlobParser"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/base_o365.py b/llm/Lib/site-packages/langchain/document_loaders/base_o365.py
new file mode 100644
index 0000000000000000000000000000000000000000..ee7274c647877e39a8280f732be238aa5172d640
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/base_o365.py
@@ -0,0 +1,7 @@
+from langchain_community.document_loaders.base_o365 import (
+    O365BaseLoader,
+)
+
+__all__ = [
+    "O365BaseLoader",
+]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/bibtex.py b/llm/Lib/site-packages/langchain/document_loaders/bibtex.py
new file mode 100644
index 0000000000000000000000000000000000000000..47a774b928d747991d2103ef041d965f9a9ee0c2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/bibtex.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.bibtex import BibtexLoader
+
+__all__ = ["BibtexLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/bigquery.py b/llm/Lib/site-packages/langchain/document_loaders/bigquery.py
new file mode 100644
index 0000000000000000000000000000000000000000..08965c424ce3778c738db492367f9da88abd90b9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/bigquery.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.bigquery import BigQueryLoader
+
+__all__ = ["BigQueryLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/bilibili.py b/llm/Lib/site-packages/langchain/document_loaders/bilibili.py
new file mode 100644
index 0000000000000000000000000000000000000000..3757322cca14af4080eca2d6222dd57ffa1c0dd5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/bilibili.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.bilibili import BiliBiliLoader
+
+__all__ = ["BiliBiliLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/blackboard.py b/llm/Lib/site-packages/langchain/document_loaders/blackboard.py
new file mode 100644
index 0000000000000000000000000000000000000000..1233ffdfa6eeed05f3e797c429c484a791d6d8f7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/blackboard.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.blackboard import BlackboardLoader
+
+__all__ = ["BlackboardLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__init__.py b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..174c71de026901a20112f4b1ea5c94ba8fe5f8fa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__init__.py
@@ -0,0 +1,9 @@
+from langchain_community.document_loaders.blob_loaders.file_system import (
+    FileSystemBlobLoader,
+)
+from langchain_community.document_loaders.blob_loaders.schema import Blob, BlobLoader
+from langchain_community.document_loaders.blob_loaders.youtube_audio import (
+    YoutubeAudioLoader,
+)
+
+__all__ = ["BlobLoader", "Blob", "FileSystemBlobLoader", "YoutubeAudioLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..06b6f482a8c9b3e39ff1311d0e0be50e1bcb27c0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__pycache__/file_system.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__pycache__/file_system.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3144147bd55d43e67d55349268437a17d642ba22
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__pycache__/file_system.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__pycache__/schema.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__pycache__/schema.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a863765d2788c8fcd4708d8895ae435e6ea1e465
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__pycache__/schema.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__pycache__/youtube_audio.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__pycache__/youtube_audio.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..32972de140e704641c01763df3f489d110cb61ab
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/__pycache__/youtube_audio.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/file_system.py b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/file_system.py
new file mode 100644
index 0000000000000000000000000000000000000000..c73b04c6653489b8646df4d6263ed2562c7e4bcf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/file_system.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.blob_loaders.file_system import (
+    FileSystemBlobLoader,
+)
+
+__all__ = ["FileSystemBlobLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/schema.py b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/schema.py
new file mode 100644
index 0000000000000000000000000000000000000000..fa42eaba3ffc026556a09b9f796bc61c5c1b0a9d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/schema.py
@@ -0,0 +1,7 @@
+from langchain_community.document_loaders.blob_loaders.schema import (
+    Blob,
+    BlobLoader,
+    PathLike,
+)
+
+__all__ = ["PathLike", "Blob", "BlobLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/youtube_audio.py b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/youtube_audio.py
new file mode 100644
index 0000000000000000000000000000000000000000..a90103c090caf2bd9d3bd834035c66161bdc5f9b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/blob_loaders/youtube_audio.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.blob_loaders.youtube_audio import (
+    YoutubeAudioLoader,
+)
+
+__all__ = ["YoutubeAudioLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/blockchain.py b/llm/Lib/site-packages/langchain/document_loaders/blockchain.py
new file mode 100644
index 0000000000000000000000000000000000000000..7855975bee5d64e432c54379b6d292b5bbf1adfe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/blockchain.py
@@ -0,0 +1,6 @@
+from langchain_community.document_loaders.blockchain import (
+    BlockchainDocumentLoader,
+    BlockchainType,
+)
+
+__all__ = ["BlockchainType", "BlockchainDocumentLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/brave_search.py b/llm/Lib/site-packages/langchain/document_loaders/brave_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..f25de4b8c68d502dcba22332ed9771f779643e66
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/brave_search.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.brave_search import BraveSearchLoader
+
+__all__ = ["BraveSearchLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/browserless.py b/llm/Lib/site-packages/langchain/document_loaders/browserless.py
new file mode 100644
index 0000000000000000000000000000000000000000..7fff4b21ec91b214e9ee8f2ba5d326cec9183ab1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/browserless.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.browserless import BrowserlessLoader
+
+__all__ = ["BrowserlessLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/chatgpt.py b/llm/Lib/site-packages/langchain/document_loaders/chatgpt.py
new file mode 100644
index 0000000000000000000000000000000000000000..98f706e3f4e7b44d0384259907cb4b44420b1cce
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/chatgpt.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.chatgpt import ChatGPTLoader, concatenate_rows
+
+__all__ = ["concatenate_rows", "ChatGPTLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/chromium.py b/llm/Lib/site-packages/langchain/document_loaders/chromium.py
new file mode 100644
index 0000000000000000000000000000000000000000..037f24a66bf48c2cb6836ea8551517cd0463a7ae
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/chromium.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.chromium import AsyncChromiumLoader
+
+__all__ = ["AsyncChromiumLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/college_confidential.py b/llm/Lib/site-packages/langchain/document_loaders/college_confidential.py
new file mode 100644
index 0000000000000000000000000000000000000000..a90c4b0f6870316b334b7d6c531d784dc3373e14
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/college_confidential.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.college_confidential import (
+    CollegeConfidentialLoader,
+)
+
+__all__ = ["CollegeConfidentialLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/concurrent.py b/llm/Lib/site-packages/langchain/document_loaders/concurrent.py
new file mode 100644
index 0000000000000000000000000000000000000000..a75ca6f72ef495d036242da72b6ed77826b4bc09
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/concurrent.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.concurrent import (
+    ConcurrentLoader,
+)
+
+__all__ = ["ConcurrentLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/confluence.py b/llm/Lib/site-packages/langchain/document_loaders/confluence.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b6fcf9feb7bbcb06920c6a10e36b02496afa9df
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/confluence.py
@@ -0,0 +1,6 @@
+from langchain_community.document_loaders.confluence import (
+    ConfluenceLoader,
+    ContentFormat,
+)
+
+__all__ = ["ContentFormat", "ConfluenceLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/conllu.py b/llm/Lib/site-packages/langchain/document_loaders/conllu.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d6e952d9a9734e141251ef08499bad55eca1ac6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/conllu.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.conllu import CoNLLULoader
+
+__all__ = ["CoNLLULoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/couchbase.py b/llm/Lib/site-packages/langchain/document_loaders/couchbase.py
new file mode 100644
index 0000000000000000000000000000000000000000..030572528bf4142faf4284c41a2375671c257ec1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/couchbase.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.couchbase import CouchbaseLoader
+
+__all__ = ["CouchbaseLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/csv_loader.py b/llm/Lib/site-packages/langchain/document_loaders/csv_loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..28f23abd4f11da85309f6c9bf9264cb919e68b8b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/csv_loader.py
@@ -0,0 +1,6 @@
+from langchain_community.document_loaders.csv_loader import (
+    CSVLoader,
+    UnstructuredCSVLoader,
+)
+
+__all__ = ["CSVLoader", "UnstructuredCSVLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/cube_semantic.py b/llm/Lib/site-packages/langchain/document_loaders/cube_semantic.py
new file mode 100644
index 0000000000000000000000000000000000000000..b0768f16154529f56aab96eab1d71eeed43ee495
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/cube_semantic.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.cube_semantic import CubeSemanticLoader
+
+__all__ = ["CubeSemanticLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/datadog_logs.py b/llm/Lib/site-packages/langchain/document_loaders/datadog_logs.py
new file mode 100644
index 0000000000000000000000000000000000000000..08877ceb2e66879926a6e289231eea7b3d7e130a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/datadog_logs.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.datadog_logs import DatadogLogsLoader
+
+__all__ = ["DatadogLogsLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/dataframe.py b/llm/Lib/site-packages/langchain/document_loaders/dataframe.py
new file mode 100644
index 0000000000000000000000000000000000000000..216ae59631118c4f153b4906f1744ef2437dc49f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/dataframe.py
@@ -0,0 +1,6 @@
+from langchain_community.document_loaders.dataframe import (
+    BaseDataFrameLoader,
+    DataFrameLoader,
+)
+
+__all__ = ["BaseDataFrameLoader", "DataFrameLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/diffbot.py b/llm/Lib/site-packages/langchain/document_loaders/diffbot.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff4d5ea8e7f40baef804e315322545fe5c77a107
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/diffbot.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.diffbot import DiffbotLoader
+
+__all__ = ["DiffbotLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/directory.py b/llm/Lib/site-packages/langchain/document_loaders/directory.py
new file mode 100644
index 0000000000000000000000000000000000000000..5dfc3011b1218af9664c31902ab3b119323de446
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/directory.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.directory import (
+    DirectoryLoader,
+)
+
+__all__ = ["DirectoryLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/discord.py b/llm/Lib/site-packages/langchain/document_loaders/discord.py
new file mode 100644
index 0000000000000000000000000000000000000000..9283d5c6359d6a2244674539e6f1be3ea8eba752
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/discord.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.discord import DiscordChatLoader
+
+__all__ = ["DiscordChatLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/docugami.py b/llm/Lib/site-packages/langchain/document_loaders/docugami.py
new file mode 100644
index 0000000000000000000000000000000000000000..f58eb9739f9bd6ae59e6bf59475782dabc1dfd2b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/docugami.py
@@ -0,0 +1,7 @@
+from langchain_community.document_loaders.docugami import (
+    DocugamiLoader,
+)
+
+__all__ = [
+    "DocugamiLoader",
+]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/docusaurus.py b/llm/Lib/site-packages/langchain/document_loaders/docusaurus.py
new file mode 100644
index 0000000000000000000000000000000000000000..55d3910d76116a4c555e350b1887e34c48072e6d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/docusaurus.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.docusaurus import DocusaurusLoader
+
+__all__ = ["DocusaurusLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/dropbox.py b/llm/Lib/site-packages/langchain/document_loaders/dropbox.py
new file mode 100644
index 0000000000000000000000000000000000000000..bb14b949affbb8647028110b67c956b91eea5461
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/dropbox.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.dropbox import DropboxLoader
+
+__all__ = ["DropboxLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/duckdb_loader.py b/llm/Lib/site-packages/langchain/document_loaders/duckdb_loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..622e208e51097335e0e4d26b5f9fc95259d418b4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/duckdb_loader.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.duckdb_loader import DuckDBLoader
+
+__all__ = ["DuckDBLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/email.py b/llm/Lib/site-packages/langchain/document_loaders/email.py
new file mode 100644
index 0000000000000000000000000000000000000000..b42cc0298d0c357ceb85e92bcad47f64f8501a9e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/email.py
@@ -0,0 +1,6 @@
+from langchain_community.document_loaders.email import (
+    OutlookMessageLoader,
+    UnstructuredEmailLoader,
+)
+
+__all__ = ["UnstructuredEmailLoader", "OutlookMessageLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/epub.py b/llm/Lib/site-packages/langchain/document_loaders/epub.py
new file mode 100644
index 0000000000000000000000000000000000000000..3c8704d178d25c9e88fd0d0e3a365cd1b28a9c9a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/epub.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.epub import UnstructuredEPubLoader
+
+__all__ = ["UnstructuredEPubLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/etherscan.py b/llm/Lib/site-packages/langchain/document_loaders/etherscan.py
new file mode 100644
index 0000000000000000000000000000000000000000..61855b2c6f77a62e88a764ea6bb93d0c642b20cf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/etherscan.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.etherscan import EtherscanLoader
+
+__all__ = ["EtherscanLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/evernote.py b/llm/Lib/site-packages/langchain/document_loaders/evernote.py
new file mode 100644
index 0000000000000000000000000000000000000000..9e3c6027604a52170d0a4c3520bf8604eea8ab22
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/evernote.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.evernote import EverNoteLoader
+
+__all__ = ["EverNoteLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/excel.py b/llm/Lib/site-packages/langchain/document_loaders/excel.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ed918ec70d9b52e2adb7efafff3c5c78cb417a0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/excel.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.excel import UnstructuredExcelLoader
+
+__all__ = ["UnstructuredExcelLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/facebook_chat.py b/llm/Lib/site-packages/langchain/document_loaders/facebook_chat.py
new file mode 100644
index 0000000000000000000000000000000000000000..e693cd97cde7a146596af073dfa9827875e3cf58
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/facebook_chat.py
@@ -0,0 +1,6 @@
+from langchain_community.document_loaders.facebook_chat import (
+    FacebookChatLoader,
+    concatenate_rows,
+)
+
+__all__ = ["concatenate_rows", "FacebookChatLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/fauna.py b/llm/Lib/site-packages/langchain/document_loaders/fauna.py
new file mode 100644
index 0000000000000000000000000000000000000000..2da7495c823e312e7a12f6c9e2443f2bbf8484ff
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/fauna.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.fauna import FaunaLoader
+
+__all__ = ["FaunaLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/figma.py b/llm/Lib/site-packages/langchain/document_loaders/figma.py
new file mode 100644
index 0000000000000000000000000000000000000000..0a3518c67d80c73ded5bfce8f6558a9f5298a1dc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/figma.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.figma import FigmaFileLoader
+
+__all__ = ["FigmaFileLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/gcs_directory.py b/llm/Lib/site-packages/langchain/document_loaders/gcs_directory.py
new file mode 100644
index 0000000000000000000000000000000000000000..6316bd183ca2a5974a74b1f3194d752e08683014
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/gcs_directory.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.gcs_directory import GCSDirectoryLoader
+
+__all__ = ["GCSDirectoryLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/gcs_file.py b/llm/Lib/site-packages/langchain/document_loaders/gcs_file.py
new file mode 100644
index 0000000000000000000000000000000000000000..701524642db0c075d6deff0be3d5ed92dd69e47e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/gcs_file.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.gcs_file import GCSFileLoader
+
+__all__ = ["GCSFileLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/generic.py b/llm/Lib/site-packages/langchain/document_loaders/generic.py
new file mode 100644
index 0000000000000000000000000000000000000000..026b114889cd11fb7472ea61af5dfb5c1390639e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/generic.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.generic import GenericLoader
+
+__all__ = ["GenericLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/geodataframe.py b/llm/Lib/site-packages/langchain/document_loaders/geodataframe.py
new file mode 100644
index 0000000000000000000000000000000000000000..4af7a4fb98b21151be5de2a0beceea7d835b6691
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/geodataframe.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.geodataframe import GeoDataFrameLoader
+
+__all__ = ["GeoDataFrameLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/git.py b/llm/Lib/site-packages/langchain/document_loaders/git.py
new file mode 100644
index 0000000000000000000000000000000000000000..6abb1daf803d1da9f4f4a2d0e7c0dc7b00f61c92
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/git.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.git import GitLoader
+
+__all__ = ["GitLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/gitbook.py b/llm/Lib/site-packages/langchain/document_loaders/gitbook.py
new file mode 100644
index 0000000000000000000000000000000000000000..c3ed271f3ebb1b1742d121085473842d24e22c1b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/gitbook.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.gitbook import GitbookLoader
+
+__all__ = ["GitbookLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/github.py b/llm/Lib/site-packages/langchain/document_loaders/github.py
new file mode 100644
index 0000000000000000000000000000000000000000..11dd4bedc7c7df4290f73f64d17fd7e1d5a13d9b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/github.py
@@ -0,0 +1,6 @@
+from langchain_community.document_loaders.github import (
+    BaseGitHubLoader,
+    GitHubIssuesLoader,
+)
+
+__all__ = ["BaseGitHubLoader", "GitHubIssuesLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/google_speech_to_text.py b/llm/Lib/site-packages/langchain/document_loaders/google_speech_to_text.py
new file mode 100644
index 0000000000000000000000000000000000000000..b02c8df7ef87d1385a4760fb8c5ca8346ff79b8e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/google_speech_to_text.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.google_speech_to_text import (
+    GoogleSpeechToTextLoader,
+)
+
+__all__ = ["GoogleSpeechToTextLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/googledrive.py b/llm/Lib/site-packages/langchain/document_loaders/googledrive.py
new file mode 100644
index 0000000000000000000000000000000000000000..555646b4ed03b24361c018f14e21eeb30d3cfb63
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/googledrive.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.googledrive import GoogleDriveLoader
+
+__all__ = ["GoogleDriveLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/gutenberg.py b/llm/Lib/site-packages/langchain/document_loaders/gutenberg.py
new file mode 100644
index 0000000000000000000000000000000000000000..c51c0eb0210d5b95e01acfc741dbafd29e0415dd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/gutenberg.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.gutenberg import GutenbergLoader
+
+__all__ = ["GutenbergLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/helpers.py b/llm/Lib/site-packages/langchain/document_loaders/helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..cac8ff765511d02c5a923cc171a44a54fafdefc4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/helpers.py
@@ -0,0 +1,6 @@
+from langchain_community.document_loaders.helpers import (
+    FileEncoding,
+    detect_file_encodings,
+)
+
+__all__ = ["FileEncoding", "detect_file_encodings"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/hn.py b/llm/Lib/site-packages/langchain/document_loaders/hn.py
new file mode 100644
index 0000000000000000000000000000000000000000..aaba5020e16f4aa064ceed8c6208006ac2ad05d8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/hn.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.hn import HNLoader
+
+__all__ = ["HNLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/html.py b/llm/Lib/site-packages/langchain/document_loaders/html.py
new file mode 100644
index 0000000000000000000000000000000000000000..f85ed5225a5ef1b722720767bb1e0b6aa43fea01
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/html.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.html import UnstructuredHTMLLoader
+
+__all__ = ["UnstructuredHTMLLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/html_bs.py b/llm/Lib/site-packages/langchain/document_loaders/html_bs.py
new file mode 100644
index 0000000000000000000000000000000000000000..2e2a1e3c2fce1686cb3013fe1e674bcb60270619
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/html_bs.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.html_bs import BSHTMLLoader
+
+__all__ = ["BSHTMLLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/hugging_face_dataset.py b/llm/Lib/site-packages/langchain/document_loaders/hugging_face_dataset.py
new file mode 100644
index 0000000000000000000000000000000000000000..96a4e3fdacc7d52a0a9c5421aca2c1ce8b67fb57
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/hugging_face_dataset.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.hugging_face_dataset import (
+    HuggingFaceDatasetLoader,
+)
+
+__all__ = ["HuggingFaceDatasetLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/ifixit.py b/llm/Lib/site-packages/langchain/document_loaders/ifixit.py
new file mode 100644
index 0000000000000000000000000000000000000000..0eb144638abfca7b172c6f7ad41754c8036813d6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/ifixit.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.ifixit import IFixitLoader
+
+__all__ = ["IFixitLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/image.py b/llm/Lib/site-packages/langchain/document_loaders/image.py
new file mode 100644
index 0000000000000000000000000000000000000000..c22a5d5942f32b303afb355534b33e866983ee90
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/image.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.image import UnstructuredImageLoader
+
+__all__ = ["UnstructuredImageLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/image_captions.py b/llm/Lib/site-packages/langchain/document_loaders/image_captions.py
new file mode 100644
index 0000000000000000000000000000000000000000..36cbef36658c478aae2c156d5b924b0a8c4e902e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/image_captions.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.image_captions import ImageCaptionLoader
+
+__all__ = ["ImageCaptionLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/imsdb.py b/llm/Lib/site-packages/langchain/document_loaders/imsdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..954a84ea4b98348888384036fc1b29591b37aef8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/imsdb.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.imsdb import IMSDbLoader
+
+__all__ = ["IMSDbLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/iugu.py b/llm/Lib/site-packages/langchain/document_loaders/iugu.py
new file mode 100644
index 0000000000000000000000000000000000000000..23fe1a68225c0cfa2d1272ca14d19d4d5b06cf76
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/iugu.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.iugu import IuguLoader
+
+__all__ = ["IuguLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/joplin.py b/llm/Lib/site-packages/langchain/document_loaders/joplin.py
new file mode 100644
index 0000000000000000000000000000000000000000..f76ee87c1174bd52b71f7e6d0e2f52c25b174097
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/joplin.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.joplin import JoplinLoader
+
+__all__ = ["JoplinLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/json_loader.py b/llm/Lib/site-packages/langchain/document_loaders/json_loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..66668c8eb222cac60d91c1600674147a387bf539
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/json_loader.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.json_loader import JSONLoader
+
+__all__ = ["JSONLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/lakefs.py b/llm/Lib/site-packages/langchain/document_loaders/lakefs.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ab95f37c385bf8a035f0b11119688d4b8ca70a1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/lakefs.py
@@ -0,0 +1,7 @@
+from langchain_community.document_loaders.lakefs import (
+    LakeFSClient,
+    LakeFSLoader,
+    UnstructuredLakeFSLoader,
+)
+
+__all__ = ["LakeFSClient", "LakeFSLoader", "UnstructuredLakeFSLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/larksuite.py b/llm/Lib/site-packages/langchain/document_loaders/larksuite.py
new file mode 100644
index 0000000000000000000000000000000000000000..b20d7977071e0086678628fab82770a5f94d5465
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/larksuite.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.larksuite import LarkSuiteDocLoader
+
+__all__ = ["LarkSuiteDocLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/markdown.py b/llm/Lib/site-packages/langchain/document_loaders/markdown.py
new file mode 100644
index 0000000000000000000000000000000000000000..72a4167143a8adf6812f98b2927ae6e605d0760a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/markdown.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.markdown import UnstructuredMarkdownLoader
+
+__all__ = ["UnstructuredMarkdownLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/mastodon.py b/llm/Lib/site-packages/langchain/document_loaders/mastodon.py
new file mode 100644
index 0000000000000000000000000000000000000000..dde13431b71686142524ded3d93d8a19e3ef8f0c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/mastodon.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.mastodon import (
+    MastodonTootsLoader,
+)
+
+__all__ = ["MastodonTootsLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/max_compute.py b/llm/Lib/site-packages/langchain/document_loaders/max_compute.py
new file mode 100644
index 0000000000000000000000000000000000000000..91dab9c29fa5b953383f7d2ecc4edf5467e57cce
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/max_compute.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.max_compute import MaxComputeLoader
+
+__all__ = ["MaxComputeLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/mediawikidump.py b/llm/Lib/site-packages/langchain/document_loaders/mediawikidump.py
new file mode 100644
index 0000000000000000000000000000000000000000..54c2d25cd4af539a51802eb948805a091fd2e013
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/mediawikidump.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.mediawikidump import MWDumpLoader
+
+__all__ = ["MWDumpLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/merge.py b/llm/Lib/site-packages/langchain/document_loaders/merge.py
new file mode 100644
index 0000000000000000000000000000000000000000..225058eabe95ef80055d3881281a6ae23c054e5e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/merge.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.merge import MergedDataLoader
+
+__all__ = ["MergedDataLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/mhtml.py b/llm/Lib/site-packages/langchain/document_loaders/mhtml.py
new file mode 100644
index 0000000000000000000000000000000000000000..841a1395ba2d3c1f1ef77c7817b7bd6918340f93
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/mhtml.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.mhtml import MHTMLLoader
+
+__all__ = ["MHTMLLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/modern_treasury.py b/llm/Lib/site-packages/langchain/document_loaders/modern_treasury.py
new file mode 100644
index 0000000000000000000000000000000000000000..370c75c3e1fbdf492b35343f9f5c20ebfd7cc157
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/modern_treasury.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.modern_treasury import (
+    ModernTreasuryLoader,
+)
+
+__all__ = ["ModernTreasuryLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/mongodb.py b/llm/Lib/site-packages/langchain/document_loaders/mongodb.py
new file mode 100644
index 0000000000000000000000000000000000000000..a7326615ec043ef18ace8b344f1947fb8057dfa6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/mongodb.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.mongodb import MongodbLoader
+
+__all__ = ["MongodbLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/news.py b/llm/Lib/site-packages/langchain/document_loaders/news.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e74e078dfd1ab9a4d0f7ea258941b3b2f168950
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/news.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.news import NewsURLLoader
+
+__all__ = ["NewsURLLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/notebook.py b/llm/Lib/site-packages/langchain/document_loaders/notebook.py
new file mode 100644
index 0000000000000000000000000000000000000000..f285c3bcd37750f6e0b0a20f7759a54f31d59e4d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/notebook.py
@@ -0,0 +1,7 @@
+from langchain_community.document_loaders.notebook import (
+    NotebookLoader,
+    concatenate_cells,
+    remove_newlines,
+)
+
+__all__ = ["concatenate_cells", "remove_newlines", "NotebookLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/notion.py b/llm/Lib/site-packages/langchain/document_loaders/notion.py
new file mode 100644
index 0000000000000000000000000000000000000000..7f68d875509d626af8578d7ecbb0ccb2a3815a01
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/notion.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.notion import NotionDirectoryLoader
+
+__all__ = ["NotionDirectoryLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/notiondb.py b/llm/Lib/site-packages/langchain/document_loaders/notiondb.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc12f93523786242be4760f8d18d360c50b3b484
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/notiondb.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.notiondb import (
+    NotionDBLoader,
+)
+
+__all__ = ["NotionDBLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/nuclia.py b/llm/Lib/site-packages/langchain/document_loaders/nuclia.py
new file mode 100644
index 0000000000000000000000000000000000000000..930cb8376c4f6ffee4e33b8433f832cc77516ef2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/nuclia.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.nuclia import NucliaLoader
+
+__all__ = ["NucliaLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/obs_directory.py b/llm/Lib/site-packages/langchain/document_loaders/obs_directory.py
new file mode 100644
index 0000000000000000000000000000000000000000..864f7e5b360bc8f7a6038e571e1901dced449990
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/obs_directory.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.obs_directory import OBSDirectoryLoader
+
+__all__ = ["OBSDirectoryLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/obs_file.py b/llm/Lib/site-packages/langchain/document_loaders/obs_file.py
new file mode 100644
index 0000000000000000000000000000000000000000..aaab975544255853f08be1b7017578b255bc1707
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/obs_file.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.obs_file import OBSFileLoader
+
+__all__ = ["OBSFileLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/obsidian.py b/llm/Lib/site-packages/langchain/document_loaders/obsidian.py
new file mode 100644
index 0000000000000000000000000000000000000000..5ce241c042ff8cadb20527e4af6eedb326623626
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/obsidian.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.obsidian import ObsidianLoader
+
+__all__ = ["ObsidianLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/odt.py b/llm/Lib/site-packages/langchain/document_loaders/odt.py
new file mode 100644
index 0000000000000000000000000000000000000000..d42a1ed493b97bae1559696386fa4989cf250616
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/odt.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.odt import UnstructuredODTLoader
+
+__all__ = ["UnstructuredODTLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/onedrive.py b/llm/Lib/site-packages/langchain/document_loaders/onedrive.py
new file mode 100644
index 0000000000000000000000000000000000000000..dcac5f4f90456315c4eb2d4177e663ba4e6ba5dd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/onedrive.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.onedrive import OneDriveLoader
+
+__all__ = ["OneDriveLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/onedrive_file.py b/llm/Lib/site-packages/langchain/document_loaders/onedrive_file.py
new file mode 100644
index 0000000000000000000000000000000000000000..5429aee5089187a7c2c834ccdbb9d5337fb308e0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/onedrive_file.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.onedrive_file import (
+    OneDriveFileLoader,
+)
+
+__all__ = ["OneDriveFileLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/onenote.py b/llm/Lib/site-packages/langchain/document_loaders/onenote.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ab6c904ce622e360ba6f66544994e35d55c66c6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/onenote.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.onenote import (
+    OneNoteLoader,
+)
+
+__all__ = ["OneNoteLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/open_city_data.py b/llm/Lib/site-packages/langchain/document_loaders/open_city_data.py
new file mode 100644
index 0000000000000000000000000000000000000000..e54830b9f2ad56bca5bc6ba13836b18e700eb7e0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/open_city_data.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.open_city_data import OpenCityDataLoader
+
+__all__ = ["OpenCityDataLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/org_mode.py b/llm/Lib/site-packages/langchain/document_loaders/org_mode.py
new file mode 100644
index 0000000000000000000000000000000000000000..2c7b5ef8ee70aa6c1c6e6c1bf9deb47d7ef09b6d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/org_mode.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.org_mode import UnstructuredOrgModeLoader
+
+__all__ = ["UnstructuredOrgModeLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/__init__.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c7bd6d73dffebb785a4ee069c560fc9de86526d1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/__init__.py
@@ -0,0 +1,25 @@
+from langchain_community.document_loaders.parsers.audio import OpenAIWhisperParser
+from langchain_community.document_loaders.parsers.docai import DocAIParser
+from langchain_community.document_loaders.parsers.grobid import GrobidParser
+from langchain_community.document_loaders.parsers.html import BS4HTMLParser
+from langchain_community.document_loaders.parsers.language import LanguageParser
+from langchain_community.document_loaders.parsers.pdf import (
+    PDFMinerParser,
+    PDFPlumberParser,
+    PyMuPDFParser,
+    PyPDFium2Parser,
+    PyPDFParser,
+)
+
+__all__ = [
+    "BS4HTMLParser",
+    "DocAIParser",
+    "GrobidParser",
+    "LanguageParser",
+    "OpenAIWhisperParser",
+    "PDFMinerParser",
+    "PDFPlumberParser",
+    "PyMuPDFParser",
+    "PyPDFium2Parser",
+    "PyPDFParser",
+]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..27cbf86f968c5d9093aaba751055fb835231c82b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/audio.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/audio.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3267222f82085379f86517105bbed0714e97f1ba
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/audio.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/docai.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/docai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4b277521666f360d64b323215808e070af85f106
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/docai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/generic.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/generic.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0224ec8603c222aa56bce4a9db23c94f07cc875f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/generic.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/grobid.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/grobid.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fd34964b8e6dc39428e10c6e75ed55fdbd76f0ef
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/grobid.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/msword.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/msword.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8d9df3d763aa06cee39787f4832e098b31360aca
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/msword.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/pdf.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/pdf.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f5e84291e6eec02fa019edc15f623e90b22c25c1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/pdf.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/registry.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/registry.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..630e187c4c849962dcdf1ee426dbd2ebc1c51668
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/registry.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/txt.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/txt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e37b55d574f5fd62919067bfc9f763d9aed0c3da
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/__pycache__/txt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/audio.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/audio.py
new file mode 100644
index 0000000000000000000000000000000000000000..5307e5cf086699b6ec6c43c5a85e3ca30c7aa636
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/audio.py
@@ -0,0 +1,7 @@
+from langchain_community.document_loaders.parsers.audio import (
+    OpenAIWhisperParser,
+    OpenAIWhisperParserLocal,
+    YandexSTTParser,
+)
+
+__all__ = ["OpenAIWhisperParser", "OpenAIWhisperParserLocal", "YandexSTTParser"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/docai.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/docai.py
new file mode 100644
index 0000000000000000000000000000000000000000..661b1d0337bc3facd98856023a0514a546ea8b91
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/docai.py
@@ -0,0 +1,6 @@
+from langchain_community.document_loaders.parsers.docai import (
+    DocAIParser,
+    DocAIParsingResults,
+)
+
+__all__ = ["DocAIParsingResults", "DocAIParser"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/generic.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/generic.py
new file mode 100644
index 0000000000000000000000000000000000000000..40b102161780e445d891afc9fc4f4f173b98cff8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/generic.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.parsers.generic import MimeTypeBasedParser
+
+__all__ = ["MimeTypeBasedParser"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/grobid.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/grobid.py
new file mode 100644
index 0000000000000000000000000000000000000000..91395644e90d9a52b7c980bde6fe69378f7bd963
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/grobid.py
@@ -0,0 +1,6 @@
+from langchain_community.document_loaders.parsers.grobid import (
+    GrobidParser,
+    ServerUnavailableException,
+)
+
+__all__ = ["GrobidParser", "ServerUnavailableException"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/html/__init__.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/html/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f59e804b30f7d66e8475dbd7576d0e3307786791
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/html/__init__.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.parsers.html.bs4 import BS4HTMLParser
+
+__all__ = ["BS4HTMLParser"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/html/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/html/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..55f407e434eeee06f8ee743ba09b4dc03d79a690
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/html/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/html/__pycache__/bs4.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/html/__pycache__/bs4.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6898b2e168578224a5b6a43062eaba659e211398
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/html/__pycache__/bs4.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/html/bs4.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/html/bs4.py
new file mode 100644
index 0000000000000000000000000000000000000000..f59e804b30f7d66e8475dbd7576d0e3307786791
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/html/bs4.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.parsers.html.bs4 import BS4HTMLParser
+
+__all__ = ["BS4HTMLParser"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__init__.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e56cc143cfda9cbe3f92b72608267a75e2668c3a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__init__.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.parsers.language.language_parser import (
+    LanguageParser,
+)
+
+__all__ = ["LanguageParser"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7adc00a148abee99837f2c4535b83867e338bcc7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/cobol.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/cobol.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c2051f0fa3e86824a9b2f94f9a3b6d3cfb204afa
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/cobol.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/code_segmenter.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/code_segmenter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5b5be1964598ab043688657e9293a3f60df35e6f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/code_segmenter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/javascript.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/javascript.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..12b41a82938ac45108887a6328eeaaa3e5ee68f0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/javascript.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/language_parser.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/language_parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4356afb42660c9e7c931d796fcf1ff1710e441a5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/language_parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/python.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/python.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a8c91004ab675933899f2bcc01d0e9f11044fda5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/__pycache__/python.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/language/cobol.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/cobol.py
new file mode 100644
index 0000000000000000000000000000000000000000..02a523edebbddb3482e7ff738a4ef8037857d167
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/cobol.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.parsers.language.cobol import CobolSegmenter
+
+__all__ = ["CobolSegmenter"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/language/code_segmenter.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/code_segmenter.py
new file mode 100644
index 0000000000000000000000000000000000000000..35aab7f8dd4a637920e4921719eb9daeb7d6dc87
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/code_segmenter.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.parsers.language.code_segmenter import (
+    CodeSegmenter,
+)
+
+__all__ = ["CodeSegmenter"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/language/javascript.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/javascript.py
new file mode 100644
index 0000000000000000000000000000000000000000..25dcb0435535b8b75d8509daeda0a2c8cfdb0485
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/javascript.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.parsers.language.javascript import (
+    JavaScriptSegmenter,
+)
+
+__all__ = ["JavaScriptSegmenter"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/language/language_parser.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/language_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..e56cc143cfda9cbe3f92b72608267a75e2668c3a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/language_parser.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.parsers.language.language_parser import (
+    LanguageParser,
+)
+
+__all__ = ["LanguageParser"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/language/python.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/python.py
new file mode 100644
index 0000000000000000000000000000000000000000..b96ae374fb9ecae765f2530620bd66516d157bba
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/language/python.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.parsers.language.python import PythonSegmenter
+
+__all__ = ["PythonSegmenter"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/msword.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/msword.py
new file mode 100644
index 0000000000000000000000000000000000000000..92d684d553184ae28c049232d932de535e5debcc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/msword.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.parsers.msword import MsWordParser
+
+__all__ = ["MsWordParser"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/pdf.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/pdf.py
new file mode 100644
index 0000000000000000000000000000000000000000..935b2510a50e0da57b5d071af31c1ef52ab926ad
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/pdf.py
@@ -0,0 +1,21 @@
+from langchain_community.document_loaders.parsers.pdf import (
+    AmazonTextractPDFParser,
+    DocumentIntelligenceParser,
+    PDFMinerParser,
+    PDFPlumberParser,
+    PyMuPDFParser,
+    PyPDFium2Parser,
+    PyPDFParser,
+    extract_from_images_with_rapidocr,
+)
+
+__all__ = [
+    "extract_from_images_with_rapidocr",
+    "PyPDFParser",
+    "PDFMinerParser",
+    "PyMuPDFParser",
+    "PyPDFium2Parser",
+    "PDFPlumberParser",
+    "AmazonTextractPDFParser",
+    "DocumentIntelligenceParser",
+]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/registry.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/registry.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ef43437d0ca04ce7521e59b310193f0553ac729
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/registry.py
@@ -0,0 +1,5 @@
+from langchain_community.document_loaders.parsers.registry import (
+    get_parser,
+)
+
+__all__ = ["get_parser"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/parsers/txt.py b/llm/Lib/site-packages/langchain/document_loaders/parsers/txt.py
new file mode 100644
index 0000000000000000000000000000000000000000..b68e6fe3a60cb23e0560c5ec0b1e740d08cb442f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/parsers/txt.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.parsers.txt import TextParser
+
+__all__ = ["TextParser"]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/pdf.py b/llm/Lib/site-packages/langchain/document_loaders/pdf.py
new file mode 100644
index 0000000000000000000000000000000000000000..da33d12e0608f39a86c31c7dd7dba82466c0af6d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/pdf.py
@@ -0,0 +1,31 @@
+from langchain_community.document_loaders.pdf import (
+    AmazonTextractPDFLoader,
+    BasePDFLoader,
+    DocumentIntelligenceLoader,
+    MathpixPDFLoader,
+    OnlinePDFLoader,
+    PDFMinerLoader,
+    PDFMinerPDFasHTMLLoader,
+    PDFPlumberLoader,
+    PyMuPDFLoader,
+    PyPDFDirectoryLoader,
+    PyPDFium2Loader,
+    PyPDFLoader,
+    UnstructuredPDFLoader,
+)
+
+__all__ = [
+    "UnstructuredPDFLoader",
+    "BasePDFLoader",
+    "OnlinePDFLoader",
+    "PyPDFLoader",
+    "PyPDFium2Loader",
+    "PyPDFDirectoryLoader",
+    "PDFMinerLoader",
+    "PDFMinerPDFasHTMLLoader",
+    "PyMuPDFLoader",
+    "MathpixPDFLoader",
+    "PDFPlumberLoader",
+    "AmazonTextractPDFLoader",
+    "DocumentIntelligenceLoader",
+]
diff --git a/llm/Lib/site-packages/langchain/document_loaders/polars_dataframe.py b/llm/Lib/site-packages/langchain/document_loaders/polars_dataframe.py
new file mode 100644
index 0000000000000000000000000000000000000000..c1fde90a584047a249cd97adf989fa6b77ddde4e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_loaders/polars_dataframe.py
@@ -0,0 +1,3 @@
+from langchain_community.document_loaders.polars_dataframe import PolarsDataFrameLoader
+
+__all__ = ["PolarsDataFrameLoader"]
diff --git a/llm/Lib/site-packages/langchain/document_transformers/__init__.py b/llm/Lib/site-packages/langchain/document_transformers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1704bb2c8d596f94a55915d078b56d85272d46cd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_transformers/__init__.py
@@ -0,0 +1,55 @@
+"""**Document Transformers** are classes to transform Documents.
+
+**Document Transformers** usually used to transform a lot of Documents in a single run.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseDocumentTransformer --> <name>  # Examples: DoctranQATransformer, DoctranTextTranslator
+
+**Main helpers:**
+
+.. code-block::
+
+    Document
+"""  # noqa: E501
+import warnings
+from typing import Any
+
+from langchain_core._api import LangChainDeprecationWarning
+
+from langchain.utils.interactive_env import is_interactive_env
+
+
+def __getattr__(name: str) -> Any:
+    from langchain_community import document_transformers
+
+    # If not in interactive env, raise warning.
+    if not is_interactive_env():
+        warnings.warn(
+            "Importing document transformers from langchain is deprecated. Importing "
+            "from langchain will no longer be supported as of langchain==0.2.0. "
+            "Please import from langchain-community instead:\n\n"
+            f"`from langchain_community.document_transformers import {name}`.\n\n"
+            "To install langchain-community run `pip install -U langchain-community`.",
+            category=LangChainDeprecationWarning,
+        )
+
+    return getattr(document_transformers, name)
+
+
+__all__ = [
+    "BeautifulSoupTransformer",
+    "DoctranQATransformer",
+    "DoctranTextTranslator",
+    "DoctranPropertyExtractor",
+    "EmbeddingsClusteringFilter",
+    "EmbeddingsRedundantFilter",
+    "GoogleTranslateTransformer",
+    "get_stateful_documents",
+    "LongContextReorder",
+    "NucliaTextTransformer",
+    "OpenAIMetadataTagger",
+    "Html2TextTransformer",
+]
diff --git a/llm/Lib/site-packages/langchain/document_transformers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fa13e2b62969da3cfe470e21c2fb8d46dd3494c1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_transformers/__pycache__/beautiful_soup_transformer.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/beautiful_soup_transformer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f0bf8a64e989d90fe5f33ac0c62b48049ca48091
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/beautiful_soup_transformer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_transformers/__pycache__/doctran_text_extract.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/doctran_text_extract.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0972115c2db7f16c93a0a99a4cf904aa6660bb69
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/doctran_text_extract.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_transformers/__pycache__/doctran_text_qa.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/doctran_text_qa.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..96538658c2ddac643bf7559250d117a79416c313
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/doctran_text_qa.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_transformers/__pycache__/doctran_text_translate.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/doctran_text_translate.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..63b3bf834bb5470bfd43e3d40b8a7d228af9231c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/doctran_text_translate.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_transformers/__pycache__/embeddings_redundant_filter.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/embeddings_redundant_filter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0b921f0be96e46bf44e5910d8eb5a90a370bc9ce
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/embeddings_redundant_filter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_transformers/__pycache__/google_translate.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/google_translate.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..de4d8b0bddc5e2ec208a714d07df1258315a4365
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/google_translate.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_transformers/__pycache__/html2text.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/html2text.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5a11e301b1425db4abd186452342b3162531eb9e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/html2text.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_transformers/__pycache__/long_context_reorder.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/long_context_reorder.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f4cdc0a65e4a11fbd57052fff21f57cbced50e50
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/long_context_reorder.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_transformers/__pycache__/nuclia_text_transform.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/nuclia_text_transform.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7116cd2d91b4dc6286d1c5fa0d3ba8ec62184906
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/nuclia_text_transform.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_transformers/__pycache__/openai_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/openai_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c1d62b32826fb03d51073a3a2829dbc7bbf16a15
Binary files /dev/null and b/llm/Lib/site-packages/langchain/document_transformers/__pycache__/openai_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/document_transformers/beautiful_soup_transformer.py b/llm/Lib/site-packages/langchain/document_transformers/beautiful_soup_transformer.py
new file mode 100644
index 0000000000000000000000000000000000000000..cf09fc0cc3964e6cff3f5e86424197d7741026dc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_transformers/beautiful_soup_transformer.py
@@ -0,0 +1,5 @@
+from langchain_community.document_transformers.beautiful_soup_transformer import (
+    BeautifulSoupTransformer,
+)
+
+__all__ = ["BeautifulSoupTransformer"]
diff --git a/llm/Lib/site-packages/langchain/document_transformers/doctran_text_extract.py b/llm/Lib/site-packages/langchain/document_transformers/doctran_text_extract.py
new file mode 100644
index 0000000000000000000000000000000000000000..fc465cd6d241d9dadf466f735196ff89fb5e8f1e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_transformers/doctran_text_extract.py
@@ -0,0 +1,5 @@
+from langchain_community.document_transformers.doctran_text_extract import (
+    DoctranPropertyExtractor,
+)
+
+__all__ = ["DoctranPropertyExtractor"]
diff --git a/llm/Lib/site-packages/langchain/document_transformers/doctran_text_qa.py b/llm/Lib/site-packages/langchain/document_transformers/doctran_text_qa.py
new file mode 100644
index 0000000000000000000000000000000000000000..a3205a857aeb554f9e0e55ccf6f1eb7bfdce5385
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_transformers/doctran_text_qa.py
@@ -0,0 +1,5 @@
+from langchain_community.document_transformers.doctran_text_qa import (
+    DoctranQATransformer,
+)
+
+__all__ = ["DoctranQATransformer"]
diff --git a/llm/Lib/site-packages/langchain/document_transformers/doctran_text_translate.py b/llm/Lib/site-packages/langchain/document_transformers/doctran_text_translate.py
new file mode 100644
index 0000000000000000000000000000000000000000..6bad19bb819fb366af23e54cbf488ebe6cbdd737
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_transformers/doctran_text_translate.py
@@ -0,0 +1,5 @@
+from langchain_community.document_transformers.doctran_text_translate import (
+    DoctranTextTranslator,
+)
+
+__all__ = ["DoctranTextTranslator"]
diff --git a/llm/Lib/site-packages/langchain/document_transformers/embeddings_redundant_filter.py b/llm/Lib/site-packages/langchain/document_transformers/embeddings_redundant_filter.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a162ea2591c2d508425e0cfa2cc533776c25bb9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_transformers/embeddings_redundant_filter.py
@@ -0,0 +1,17 @@
+from langchain_community.document_transformers.embeddings_redundant_filter import (
+    EmbeddingsClusteringFilter,
+    EmbeddingsRedundantFilter,
+    _DocumentWithState,
+    _filter_similar_embeddings,
+    _get_embeddings_from_stateful_docs,
+    get_stateful_documents,
+)
+
+__all__ = [
+    "EmbeddingsRedundantFilter",
+    "EmbeddingsClusteringFilter",
+    "_DocumentWithState",
+    "get_stateful_documents",
+    "_get_embeddings_from_stateful_docs",
+    "_filter_similar_embeddings",
+]
diff --git a/llm/Lib/site-packages/langchain/document_transformers/google_translate.py b/llm/Lib/site-packages/langchain/document_transformers/google_translate.py
new file mode 100644
index 0000000000000000000000000000000000000000..def0452fd91c168e9d7299ee89d868a760e7a5c3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_transformers/google_translate.py
@@ -0,0 +1,5 @@
+from langchain_community.document_transformers.google_translate import (
+    GoogleTranslateTransformer,
+)
+
+__all__ = ["GoogleTranslateTransformer"]
diff --git a/llm/Lib/site-packages/langchain/document_transformers/html2text.py b/llm/Lib/site-packages/langchain/document_transformers/html2text.py
new file mode 100644
index 0000000000000000000000000000000000000000..79987f9fc0093be8a963813ca2450d35efd33945
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_transformers/html2text.py
@@ -0,0 +1,3 @@
+from langchain_community.document_transformers.html2text import Html2TextTransformer
+
+__all__ = ["Html2TextTransformer"]
diff --git a/llm/Lib/site-packages/langchain/document_transformers/long_context_reorder.py b/llm/Lib/site-packages/langchain/document_transformers/long_context_reorder.py
new file mode 100644
index 0000000000000000000000000000000000000000..0490757e19de5173ed9fb2f947e7b4f0ba329187
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_transformers/long_context_reorder.py
@@ -0,0 +1,5 @@
+from langchain_community.document_transformers.long_context_reorder import (
+    LongContextReorder,
+)
+
+__all__ = ["LongContextReorder"]
diff --git a/llm/Lib/site-packages/langchain/document_transformers/nuclia_text_transform.py b/llm/Lib/site-packages/langchain/document_transformers/nuclia_text_transform.py
new file mode 100644
index 0000000000000000000000000000000000000000..694cda280016b5b8b180562f6fa41dfb486d9518
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_transformers/nuclia_text_transform.py
@@ -0,0 +1,5 @@
+from langchain_community.document_transformers.nuclia_text_transform import (
+    NucliaTextTransformer,
+)
+
+__all__ = ["NucliaTextTransformer"]
diff --git a/llm/Lib/site-packages/langchain/document_transformers/openai_functions.py b/llm/Lib/site-packages/langchain/document_transformers/openai_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a540acde7f73d98065e2b7ec285278962b132c8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_transformers/openai_functions.py
@@ -0,0 +1,6 @@
+from langchain_community.document_transformers.openai_functions import (
+    OpenAIMetadataTagger,
+    create_metadata_tagger,
+)
+
+__all__ = ["OpenAIMetadataTagger", "create_metadata_tagger"]
diff --git a/llm/Lib/site-packages/langchain/document_transformers/xsl/html_chunks_with_headers.xslt b/llm/Lib/site-packages/langchain/document_transformers/xsl/html_chunks_with_headers.xslt
new file mode 100644
index 0000000000000000000000000000000000000000..285edfe892db95c6f27275aa9af0a0f94dd1271f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/document_transformers/xsl/html_chunks_with_headers.xslt
@@ -0,0 +1,199 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!-- HTML PRE CHUNK:
+This performs a best-effort preliminary "chunking" of text in an HTML file,
+matching each chunk with a "headers" metadata value based on header tags in proximity.
+
+recursively visits every element (template mode=list).
+for every element with tagname of interest (only):
+1. serializes a div (and metadata marking the element's xpath).
+2. calculates all text-content for the given element, including descendant elements which are *not* themselves tags of interest.
+3. if any such text-content was found, serializes a "headers" (span.headers) along with this text (span.chunk).
+
+to calculate the "headers" of an element:
+1. recursively gets the *nearest* prior-siblings for headings of *each* level
+2. recursively repeats that step#1 for each ancestor (regardless of tag)
+n.b. this recursion is only performed (beginning with) elements which are
+both (1) tags-of-interest and (2) have their own text-content.
+-->
+<xsl:stylesheet version="1.0"
+	xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+	xmlns="http://www.w3.org/1999/xhtml">
+	
+	<xsl:param name="tags">div|p|blockquote|ol|ul</xsl:param>
+	
+	<xsl:template match="/">
+		<html>
+			<head>
+				<style>
+					div {
+						border: solid;
+						margin-top: .5em;
+						padding-left: .5em;
+					}
+					
+					h1, h2, h3, h4, h5, h6 {
+						margin: 0;
+					}
+					
+					.xpath {
+						color: blue;
+					}
+					.chunk {
+						margin: .5em 1em;
+					}
+				</style>
+			</head>
+			<body>
+				<!-- create "filtered tree" with only tags of interest -->
+				<xsl:apply-templates select="*" />
+			</body>
+		</html>
+	</xsl:template>
+	
+	<xsl:template match="*">
+		<xsl:choose>
+			<!-- tags of interest get serialized into the filtered tree (and recurse down child elements) -->
+			<xsl:when test="contains(
+				concat('|', $tags, '|'),
+				concat('|', local-name(), '|'))">
+			
+				<xsl:variable name="xpath">
+					<xsl:apply-templates mode="xpath" select="." />
+				</xsl:variable>
+				<xsl:variable name="txt">
+					<!-- recurse down child text-nodes and elements -->
+					<xsl:apply-templates mode="text" />
+				</xsl:variable>
+				<xsl:variable name="txt-norm" select="normalize-space($txt)" />
+				
+				<div title="{$xpath}">
+					
+					<small class="xpath">
+						<xsl:value-of select="$xpath" />
+					</small>
+					
+					<xsl:if test="$txt-norm">
+						<xsl:variable name="headers">
+							<xsl:apply-templates mode="headingsWithAncestors" select="." />
+						</xsl:variable>
+						
+						<xsl:if test="normalize-space($headers)">
+							<span class="headers">
+								<xsl:copy-of select="$headers" />
+							</span>
+						</xsl:if>
+					
+						<p class="chunk">
+							<xsl:value-of select="$txt-norm" />
+						</p>
+					</xsl:if>
+					
+					<xsl:apply-templates select="*" />
+				</div>
+			</xsl:when>
+			
+			<!-- all other tags get "skipped" and recurse down child elements -->
+			<xsl:otherwise>
+				<xsl:apply-templates select="*" />
+			</xsl:otherwise>
+		</xsl:choose>
+	</xsl:template>
+	
+	
+	<!-- text mode:
+	prints text nodes;
+	for elements, recurses down child nodes (text and elements) *except* certain exceptions:
+		tags of interest (handled in their own list-mode match),
+		non-content text (e.g. script|style)
+	-->
+	
+	<!-- ignore non-content text -->
+	<xsl:template mode="text" match="
+		script|style" />
+	<!-- for all other elements *except tags of interest*, recurse on child-nodes (text and elements) -->
+	<xsl:template mode="text" match="*">
+		<xsl:choose>
+			<!-- ignore tags of interest -->
+			<xsl:when test="contains(
+				concat('|', $tags, '|'),
+				concat('|', local-name(), '|'))" />
+			
+			<xsl:otherwise>
+				<xsl:apply-templates mode="text" />
+			</xsl:otherwise>
+		</xsl:choose>
+	</xsl:template>
+	
+	
+	<!-- xpath mode:
+	return an xpath which matches this element uniquely
+	-->
+	<xsl:template mode="xpath" match="*">
+		<!-- recurse up parents -->
+		<xsl:apply-templates mode="xpath" select="parent::*" />
+		
+		<xsl:value-of select="name()" />
+		<xsl:text>[</xsl:text>
+		<xsl:value-of select="1+count(preceding-sibling::*)" />
+		<xsl:text>]/</xsl:text>
+	</xsl:template>
+	
+	
+	<!-- headingsWithAncestors mode:
+	recurses up parents (ALL ancestors)
+	-->
+	<xsl:template mode="headingsWithAncestors" match="*">
+		<!-- recurse -->
+		<xsl:apply-templates mode="headingsWithAncestors" select="parent::*" />
+		
+		<xsl:apply-templates mode="headingsWithPriorSiblings" select=".">
+			<xsl:with-param name="maxHead" select="6" />
+		</xsl:apply-templates>
+	</xsl:template>
+	
+	
+	<!-- headingsWithPriorSiblings mode:
+	recurses up preceding-siblings
+	-->
+	<xsl:template mode="headingsWithPriorSiblings" match="*">
+		<xsl:param name="maxHead" />
+		<xsl:variable name="headLevel" select="number(substring(local-name(), 2))" />
+		
+		<xsl:choose>
+			<xsl:when test="'h' = substring(local-name(), 1, 1) and $maxHead >= $headLevel">
+				
+				<!-- recurse up to prior sibling; max level one less than current -->
+				<xsl:apply-templates mode="headingsWithPriorSiblings" select="preceding-sibling::*[1]">
+					<xsl:with-param name="maxHead" select="$headLevel - 1" />
+				</xsl:apply-templates>
+				
+				<xsl:apply-templates mode="heading" select="." />
+				
+			</xsl:when>
+			
+			<!-- special case for 'header' tag, serialize child-headers -->
+			<xsl:when test="self::header">
+				<xsl:apply-templates mode="heading" select="h1|h2|h3|h4|h5|h6" />
+				<!--
+				we choose not to recurse further up prior-siblings in this case,
+				but n.b. the 'headingsWithAncestors' template above will still continue recursion.
+				-->
+			</xsl:when>
+			
+			<xsl:otherwise>
+				<!-- recurse up to prior sibling; no other work on this element -->
+				<xsl:apply-templates mode="headingsWithPriorSiblings" select="preceding-sibling::*[1]">
+					<xsl:with-param name="maxHead" select="$maxHead" />
+				</xsl:apply-templates>
+			</xsl:otherwise>
+			
+		</xsl:choose>
+	</xsl:template>
+	
+	<xsl:template mode="heading" match="h1|h2|h3|h4|h5|h6">
+		<xsl:copy>
+			<xsl:value-of select="normalize-space(.)" />
+		</xsl:copy>
+	</xsl:template>
+	
+</xsl:stylesheet>
diff --git a/llm/Lib/site-packages/langchain/embeddings/__init__.py b/llm/Lib/site-packages/langchain/embeddings/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..785308e71c4ab06928d5242c44317791f258aaf0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/__init__.py
@@ -0,0 +1,119 @@
+"""**Embedding models**  are wrappers around embedding models
+from different APIs and services.
+
+**Embedding models** can be LLMs or not.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    Embeddings --> <name>Embeddings  # Examples: OpenAIEmbeddings, HuggingFaceEmbeddings
+"""
+
+
+import logging
+import warnings
+from typing import Any
+
+from langchain_core._api import LangChainDeprecationWarning
+
+from langchain.embeddings.cache import CacheBackedEmbeddings
+from langchain.utils.interactive_env import is_interactive_env
+
+
+def __getattr__(name: str) -> Any:
+    from langchain_community import embeddings
+
+    # If not in interactive env, raise warning.
+    if not is_interactive_env():
+        warnings.warn(
+            "Importing embeddings from langchain is deprecated. Importing from "
+            "langchain will no longer be supported as of langchain==0.2.0. "
+            "Please import from langchain-community instead:\n\n"
+            f"`from langchain_community.embeddings import {name}`.\n\n"
+            "To install langchain-community run `pip install -U langchain-community`.",
+            category=LangChainDeprecationWarning,
+        )
+
+    return getattr(embeddings, name)
+
+
+logger = logging.getLogger(__name__)
+
+__all__ = [
+    "OpenAIEmbeddings",
+    "AzureOpenAIEmbeddings",
+    "CacheBackedEmbeddings",
+    "ClarifaiEmbeddings",
+    "CohereEmbeddings",
+    "DatabricksEmbeddings",
+    "ElasticsearchEmbeddings",
+    "FastEmbedEmbeddings",
+    "HuggingFaceEmbeddings",
+    "HuggingFaceInferenceAPIEmbeddings",
+    "InfinityEmbeddings",
+    "GradientEmbeddings",
+    "JinaEmbeddings",
+    "LlamaCppEmbeddings",
+    "HuggingFaceHubEmbeddings",
+    "MlflowEmbeddings",
+    "MlflowAIGatewayEmbeddings",
+    "ModelScopeEmbeddings",
+    "TensorflowHubEmbeddings",
+    "SagemakerEndpointEmbeddings",
+    "HuggingFaceInstructEmbeddings",
+    "MosaicMLInstructorEmbeddings",
+    "SelfHostedEmbeddings",
+    "SelfHostedHuggingFaceEmbeddings",
+    "SelfHostedHuggingFaceInstructEmbeddings",
+    "FakeEmbeddings",
+    "DeterministicFakeEmbedding",
+    "AlephAlphaAsymmetricSemanticEmbedding",
+    "AlephAlphaSymmetricSemanticEmbedding",
+    "SentenceTransformerEmbeddings",
+    "GooglePalmEmbeddings",
+    "MiniMaxEmbeddings",
+    "VertexAIEmbeddings",
+    "BedrockEmbeddings",
+    "DeepInfraEmbeddings",
+    "EdenAiEmbeddings",
+    "DashScopeEmbeddings",
+    "EmbaasEmbeddings",
+    "OctoAIEmbeddings",
+    "SpacyEmbeddings",
+    "NLPCloudEmbeddings",
+    "GPT4AllEmbeddings",
+    "XinferenceEmbeddings",
+    "LocalAIEmbeddings",
+    "AwaEmbeddings",
+    "HuggingFaceBgeEmbeddings",
+    "ErnieEmbeddings",
+    "JavelinAIGatewayEmbeddings",
+    "OllamaEmbeddings",
+    "QianfanEmbeddingsEndpoint",
+    "JohnSnowLabsEmbeddings",
+    "VoyageEmbeddings",
+    "BookendEmbeddings",
+]
+
+
+# TODO: this is in here to maintain backwards compatibility
+class HypotheticalDocumentEmbedder:
+    def __init__(self, *args: Any, **kwargs: Any):
+        logger.warning(
+            "Using a deprecated class. Please use "
+            "`from langchain.chains import HypotheticalDocumentEmbedder` instead"
+        )
+        from langchain.chains.hyde.base import HypotheticalDocumentEmbedder as H
+
+        return H(*args, **kwargs)  # type: ignore
+
+    @classmethod
+    def from_llm(cls, *args: Any, **kwargs: Any) -> Any:
+        logger.warning(
+            "Using a deprecated class. Please use "
+            "`from langchain.chains import HypotheticalDocumentEmbedder` instead"
+        )
+        from langchain.chains.hyde.base import HypotheticalDocumentEmbedder as H
+
+        return H.from_llm(*args, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b0d98f06a444ff8ad57df15f503937870ead9176
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/aleph_alpha.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/aleph_alpha.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5c0bd96b6d9e0104781837e03b79d9f1e6b34071
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/aleph_alpha.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/awa.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/awa.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fd088aa0a67aaa8a28c4fe2a3101eb25cac8670e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/awa.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/azure_openai.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/azure_openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2a1ad7ab8b19e96acff927b1e374187444110072
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/azure_openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8b4649e9be12a176dd1f9a268c81e534abc1fe0d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..91fc65edbecfd0259b0adcc0d0627e92bc60acb1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/bedrock.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/bedrock.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..de9a3ec711fdd5e56a65c0d08f83acba6cf9911a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/bedrock.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/bookend.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/bookend.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..292fd65339fb59fe333cafcbd30419ceeb174f56
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/bookend.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/cache.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/cache.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f479505c7aba804cb3a02b4f1fdfc3839b8792f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/cache.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/clarifai.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/clarifai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9e2e099af6f28e09ab1e51932496722058410c33
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/clarifai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/cloudflare_workersai.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/cloudflare_workersai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a216c17e9fcbbae4a49968fb29263d48e9ec4b98
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/cloudflare_workersai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/cohere.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/cohere.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fdab498055ade3eb39d2352188148e28fba839c5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/cohere.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/dashscope.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/dashscope.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0aa3f53ad1cb948554ee3c7d5ffd5aa9e3dc1d32
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/dashscope.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/databricks.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/databricks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a5eaf63f2a488d7f880f225d929ee2fe7c9ef817
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/databricks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/deepinfra.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/deepinfra.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ae06a1370efe1c5049f71ef1e43db1755c06653b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/deepinfra.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/edenai.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/edenai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1744218590fc4e7e616e96209abf73f4e8c72c7d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/edenai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/elasticsearch.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/elasticsearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f197818f4b7c6af3477e9cedbbbc3de2da4bc470
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/elasticsearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/embaas.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/embaas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..616e132aadcc5990cd7c612104a1ef7b27e64db7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/embaas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/ernie.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/ernie.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6485b0df1a1bc457c4831dc5f4952155ef38e8ee
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/ernie.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/fake.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/fake.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8730e000464642729159621ec1e30e72e47af14d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/fake.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/fastembed.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/fastembed.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..717bced2f45a8da7008e6421679c467635193882
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/fastembed.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/google_palm.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/google_palm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cc48c80c4dacf9cbac5146b2a20eaf03c4d84537
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/google_palm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/gpt4all.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/gpt4all.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8d7ab07d1bc1fb6e03153eac3b8188d017afd548
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/gpt4all.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/gradient_ai.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/gradient_ai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0e0d9509a540a1748ac4ab3b304aad78731f250e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/gradient_ai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/huggingface.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/huggingface.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3415392eb4e6bda204e6fce04e016ac00c198b10
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/huggingface.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/huggingface_hub.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/huggingface_hub.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2242d3805f660787906bd595627f114a412fe578
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/huggingface_hub.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/infinity.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/infinity.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b7e609cf19a98ac3e5d39c9677cbf928fd23565d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/infinity.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/javelin_ai_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/javelin_ai_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5cc1250bc71d6bcd3a43e8d60a4910a3cf819990
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/javelin_ai_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/jina.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/jina.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0435e8baa2ec0591dc366ff676b5b17d70e3618f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/jina.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/johnsnowlabs.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/johnsnowlabs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..87fb3eb8ec9879db39854e1e7d4c9ea63e1a43ef
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/johnsnowlabs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/llamacpp.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/llamacpp.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d48ad49d914580ea656d33404df8d3bfe59207a6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/llamacpp.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/llm_rails.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/llm_rails.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..138bf85612aeae3559db90974925101c7ce87688
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/llm_rails.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/localai.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/localai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e7380c2df22832289fa43978239c5162ec1ed40
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/localai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/minimax.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/minimax.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..83c84afc314354b6567da68cf598cd1d4e092b37
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/minimax.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/mlflow.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/mlflow.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b5819cfe3f4b0092de881d9dfbcb6049378eeddb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/mlflow.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/mlflow_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/mlflow_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3a08dda0f3cdf25a63324b60f911d244654598e1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/mlflow_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/modelscope_hub.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/modelscope_hub.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5dcbdbe5bcb70bcdd4b0f8ce2fb327d11b070ca9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/modelscope_hub.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/mosaicml.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/mosaicml.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e2d44eb606203b9ba0edf21fde3c2510392319bb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/mosaicml.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/nlpcloud.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/nlpcloud.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ea9b6ceac94285a1cca8200fb68ee50b849b908a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/nlpcloud.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/octoai_embeddings.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/octoai_embeddings.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e23862faeb1b1ba0460514c3d22a8f733e2bf1dd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/octoai_embeddings.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/ollama.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/ollama.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6e1410d89ccee21834add53d26336c29da7780a2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/ollama.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/openai.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ce80f59324bb325c9dd0726cad69cab60246afaa
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/sagemaker_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/sagemaker_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..062d9b85dabb3145a2d3d57ed004416a4ef2fe7b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/sagemaker_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/self_hosted.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/self_hosted.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0bf11d51bb8900180d9383c5de274263fcd6596a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/self_hosted.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/self_hosted_hugging_face.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/self_hosted_hugging_face.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8babff9e709023f517b2b86cea2277b4fe75f679
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/self_hosted_hugging_face.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/sentence_transformer.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/sentence_transformer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..304619f46dc8d363f86ede64d9014c87de881747
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/sentence_transformer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/spacy_embeddings.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/spacy_embeddings.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..336cc5137f3da274a2c9746725cf936ed022c1e2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/spacy_embeddings.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/tensorflow_hub.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/tensorflow_hub.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9bdb7b7fd517c9d09792984ac30247d1958b5d31
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/tensorflow_hub.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/vertexai.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/vertexai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0e5771430fee0d07482a723f31d72abb68d9313e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/vertexai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/voyageai.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/voyageai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..02277719a610a2c4ddddf85d49dd32dee8e58490
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/voyageai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/__pycache__/xinference.cpython-311.pyc b/llm/Lib/site-packages/langchain/embeddings/__pycache__/xinference.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3a85bf260b6698313a947de11caab1d77419ff6f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/embeddings/__pycache__/xinference.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/embeddings/aleph_alpha.py b/llm/Lib/site-packages/langchain/embeddings/aleph_alpha.py
new file mode 100644
index 0000000000000000000000000000000000000000..c35f73758addcbe1f3012f34774ac42f6bed0c58
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/aleph_alpha.py
@@ -0,0 +1,9 @@
+from langchain_community.embeddings.aleph_alpha import (
+    AlephAlphaAsymmetricSemanticEmbedding,
+    AlephAlphaSymmetricSemanticEmbedding,
+)
+
+__all__ = [
+    "AlephAlphaAsymmetricSemanticEmbedding",
+    "AlephAlphaSymmetricSemanticEmbedding",
+]
diff --git a/llm/Lib/site-packages/langchain/embeddings/awa.py b/llm/Lib/site-packages/langchain/embeddings/awa.py
new file mode 100644
index 0000000000000000000000000000000000000000..1fd41303f57067c4851c41200f0d5de3dcea5785
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/awa.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.awa import AwaEmbeddings
+
+__all__ = ["AwaEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/azure_openai.py b/llm/Lib/site-packages/langchain/embeddings/azure_openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..73c83d647f65fd08d1a2b702a4da0d99c583987a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/azure_openai.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.azure_openai import AzureOpenAIEmbeddings
+
+__all__ = ["AzureOpenAIEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/baidu_qianfan_endpoint.py b/llm/Lib/site-packages/langchain/embeddings/baidu_qianfan_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..66ff2c4bb7b752e3c3b10781a6ca1a849bcebd66
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/baidu_qianfan_endpoint.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.baidu_qianfan_endpoint import (
+    QianfanEmbeddingsEndpoint,
+)
+
+__all__ = ["QianfanEmbeddingsEndpoint"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/base.py b/llm/Lib/site-packages/langchain/embeddings/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..9e648a342eab11c451b50398221af8343cd795f4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/base.py
@@ -0,0 +1,4 @@
+from langchain_core.embeddings import Embeddings
+
+# This is for backwards compatibility
+__all__ = ["Embeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/bedrock.py b/llm/Lib/site-packages/langchain/embeddings/bedrock.py
new file mode 100644
index 0000000000000000000000000000000000000000..da8de8ee897cf0821c066447f5b1498c8ec44ba6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/bedrock.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.bedrock import BedrockEmbeddings
+
+__all__ = ["BedrockEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/bookend.py b/llm/Lib/site-packages/langchain/embeddings/bookend.py
new file mode 100644
index 0000000000000000000000000000000000000000..41beb55addf3d0fe4fc8b43b3831bd0c1efa2d95
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/bookend.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.bookend import (
+    BookendEmbeddings,
+)
+
+__all__ = ["BookendEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/cache.py b/llm/Lib/site-packages/langchain/embeddings/cache.py
new file mode 100644
index 0000000000000000000000000000000000000000..05b7e6d923ed3ec2c4c1c87c7d297809101bb8b5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/cache.py
@@ -0,0 +1,241 @@
+"""Module contains code for a cache backed embedder.
+
+The cache backed embedder is a wrapper around an embedder that caches
+embeddings in a key-value store. The cache is used to avoid recomputing
+embeddings for the same text.
+
+The text is hashed and the hash is used as the key in the cache.
+"""
+from __future__ import annotations
+
+import hashlib
+import json
+import uuid
+from functools import partial
+from typing import Callable, List, Optional, Sequence, Union, cast
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.stores import BaseStore, ByteStore
+from langchain_core.utils.iter import batch_iterate
+
+from langchain.storage.encoder_backed import EncoderBackedStore
+
+NAMESPACE_UUID = uuid.UUID(int=1985)
+
+
+def _hash_string_to_uuid(input_string: str) -> uuid.UUID:
+    """Hash a string and returns the corresponding UUID."""
+    hash_value = hashlib.sha1(input_string.encode("utf-8")).hexdigest()
+    return uuid.uuid5(NAMESPACE_UUID, hash_value)
+
+
+def _key_encoder(key: str, namespace: str) -> str:
+    """Encode a key."""
+    return namespace + str(_hash_string_to_uuid(key))
+
+
+def _create_key_encoder(namespace: str) -> Callable[[str], str]:
+    """Create an encoder for a key."""
+    return partial(_key_encoder, namespace=namespace)
+
+
+def _value_serializer(value: Sequence[float]) -> bytes:
+    """Serialize a value."""
+    return json.dumps(value).encode()
+
+
+def _value_deserializer(serialized_value: bytes) -> List[float]:
+    """Deserialize a value."""
+    return cast(List[float], json.loads(serialized_value.decode()))
+
+
+class CacheBackedEmbeddings(Embeddings):
+    """Interface for caching results from embedding models.
+
+    The interface allows works with any store that implements
+    the abstract store interface accepting keys of type str and values of list of
+    floats.
+
+    If need be, the interface can be extended to accept other implementations
+    of the value serializer and deserializer, as well as the key encoder.
+
+    Examples:
+
+        .. code-block: python
+
+            from langchain.embeddings import CacheBackedEmbeddings
+            from langchain.storage import LocalFileStore
+            from langchain_community.embeddings import OpenAIEmbeddings
+
+            store = LocalFileStore('./my_cache')
+
+            underlying_embedder = OpenAIEmbeddings()
+            embedder = CacheBackedEmbeddings.from_bytes_store(
+                underlying_embedder, store, namespace=underlying_embedder.model
+            )
+
+            # Embedding is computed and cached
+            embeddings = embedder.embed_documents(["hello", "goodbye"])
+
+            # Embeddings are retrieved from the cache, no computation is done
+            embeddings = embedder.embed_documents(["hello", "goodbye"])
+    """
+
+    def __init__(
+        self,
+        underlying_embeddings: Embeddings,
+        document_embedding_store: BaseStore[str, List[float]],
+        *,
+        batch_size: Optional[int] = None,
+    ) -> None:
+        """Initialize the embedder.
+
+        Args:
+            underlying_embeddings: the embedder to use for computing embeddings.
+            document_embedding_store: The store to use for caching document embeddings.
+            batch_size: The number of documents to embed between store updates.
+        """
+        super().__init__()
+        self.document_embedding_store = document_embedding_store
+        self.underlying_embeddings = underlying_embeddings
+        self.batch_size = batch_size
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed a list of texts.
+
+        The method first checks the cache for the embeddings.
+        If the embeddings are not found, the method uses the underlying embedder
+        to embed the documents and stores the results in the cache.
+
+        Args:
+            texts: A list of texts to embed.
+
+        Returns:
+            A list of embeddings for the given texts.
+        """
+        vectors: List[Union[List[float], None]] = self.document_embedding_store.mget(
+            texts
+        )
+        all_missing_indices: List[int] = [
+            i for i, vector in enumerate(vectors) if vector is None
+        ]
+
+        for missing_indices in batch_iterate(self.batch_size, all_missing_indices):
+            missing_texts = [texts[i] for i in missing_indices]
+            missing_vectors = self.underlying_embeddings.embed_documents(missing_texts)
+            self.document_embedding_store.mset(
+                list(zip(missing_texts, missing_vectors))
+            )
+            for index, updated_vector in zip(missing_indices, missing_vectors):
+                vectors[index] = updated_vector
+
+        return cast(
+            List[List[float]], vectors
+        )  # Nones should have been resolved by now
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed a list of texts.
+
+        The method first checks the cache for the embeddings.
+        If the embeddings are not found, the method uses the underlying embedder
+        to embed the documents and stores the results in the cache.
+
+        Args:
+            texts: A list of texts to embed.
+
+        Returns:
+            A list of embeddings for the given texts.
+        """
+        vectors: List[
+            Union[List[float], None]
+        ] = await self.document_embedding_store.amget(texts)
+        all_missing_indices: List[int] = [
+            i for i, vector in enumerate(vectors) if vector is None
+        ]
+
+        # batch_iterate supports None batch_size which returns all elements at once
+        # as a single batch.
+        for missing_indices in batch_iterate(self.batch_size, all_missing_indices):
+            missing_texts = [texts[i] for i in missing_indices]
+            missing_vectors = await self.underlying_embeddings.aembed_documents(
+                missing_texts
+            )
+            await self.document_embedding_store.amset(
+                list(zip(missing_texts, missing_vectors))
+            )
+            for index, updated_vector in zip(missing_indices, missing_vectors):
+                vectors[index] = updated_vector
+
+        return cast(
+            List[List[float]], vectors
+        )  # Nones should have been resolved by now
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed query text.
+
+        This method does not support caching at the moment.
+
+        Support for caching queries is easily to implement, but might make
+        sense to hold off to see the most common patterns.
+
+        If the cache has an eviction policy, we may need to be a bit more careful
+        about sharing the cache between documents and queries. Generally,
+        one is OK evicting query caches, but document caches should be kept.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            The embedding for the given text.
+        """
+        return self.underlying_embeddings.embed_query(text)
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """Embed query text.
+
+        This method does not support caching at the moment.
+
+        Support for caching queries is easily to implement, but might make
+        sense to hold off to see the most common patterns.
+
+        If the cache has an eviction policy, we may need to be a bit more careful
+        about sharing the cache between documents and queries. Generally,
+        one is OK evicting query caches, but document caches should be kept.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            The embedding for the given text.
+        """
+        return await self.underlying_embeddings.aembed_query(text)
+
+    @classmethod
+    def from_bytes_store(
+        cls,
+        underlying_embeddings: Embeddings,
+        document_embedding_cache: ByteStore,
+        *,
+        namespace: str = "",
+        batch_size: Optional[int] = None,
+    ) -> CacheBackedEmbeddings:
+        """On-ramp that adds the necessary serialization and encoding to the store.
+
+        Args:
+            underlying_embeddings: The embedder to use for embedding.
+            document_embedding_cache: The cache to use for storing document embeddings.
+            *,
+            namespace: The namespace to use for document cache.
+                       This namespace is used to avoid collisions with other caches.
+                       For example, set it to the name of the embedding model used.
+            batch_size: The number of documents to embed between store updates.
+        """
+        namespace = namespace
+        key_encoder = _create_key_encoder(namespace)
+        encoder_backed_store = EncoderBackedStore[str, List[float]](
+            document_embedding_cache,
+            key_encoder,
+            _value_serializer,
+            _value_deserializer,
+        )
+        return cls(underlying_embeddings, encoder_backed_store, batch_size=batch_size)
diff --git a/llm/Lib/site-packages/langchain/embeddings/clarifai.py b/llm/Lib/site-packages/langchain/embeddings/clarifai.py
new file mode 100644
index 0000000000000000000000000000000000000000..8d5094cb16ff38265d03c4ca4cb1f00cd24af254
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/clarifai.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.clarifai import ClarifaiEmbeddings
+
+__all__ = ["ClarifaiEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/cloudflare_workersai.py b/llm/Lib/site-packages/langchain/embeddings/cloudflare_workersai.py
new file mode 100644
index 0000000000000000000000000000000000000000..bbc80aae8513440f120b2db902dd199c85f8ba07
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/cloudflare_workersai.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.cloudflare_workersai import (
+    CloudflareWorkersAIEmbeddings,
+)
+
+__all__ = ["CloudflareWorkersAIEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/cohere.py b/llm/Lib/site-packages/langchain/embeddings/cohere.py
new file mode 100644
index 0000000000000000000000000000000000000000..013654f2f212c9ff191094d87a0fd21b6155d3e7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/cohere.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.cohere import CohereEmbeddings
+
+__all__ = ["CohereEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/dashscope.py b/llm/Lib/site-packages/langchain/embeddings/dashscope.py
new file mode 100644
index 0000000000000000000000000000000000000000..e09b0bd479436836d71b80c0127c76a36ef47060
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/dashscope.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.dashscope import (
+    DashScopeEmbeddings,
+)
+
+__all__ = ["DashScopeEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/databricks.py b/llm/Lib/site-packages/langchain/embeddings/databricks.py
new file mode 100644
index 0000000000000000000000000000000000000000..6fcd17fcac038f1d0f6aed9fd35c9e6973607f34
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/databricks.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.databricks import DatabricksEmbeddings
+
+__all__ = ["DatabricksEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/deepinfra.py b/llm/Lib/site-packages/langchain/embeddings/deepinfra.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ade9969bfc83565084f4035ba34f49ebae4812f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/deepinfra.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.deepinfra import (
+    DeepInfraEmbeddings,
+)
+
+__all__ = ["DeepInfraEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/edenai.py b/llm/Lib/site-packages/langchain/embeddings/edenai.py
new file mode 100644
index 0000000000000000000000000000000000000000..5c611e17ca0255dfd94778ba0998ecb67d93220b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/edenai.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.edenai import EdenAiEmbeddings
+
+__all__ = ["EdenAiEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/elasticsearch.py b/llm/Lib/site-packages/langchain/embeddings/elasticsearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..f273d6b6fdd8ba2c9fe78b71232440a3aed758b3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/elasticsearch.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.elasticsearch import ElasticsearchEmbeddings
+
+__all__ = ["ElasticsearchEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/embaas.py b/llm/Lib/site-packages/langchain/embeddings/embaas.py
new file mode 100644
index 0000000000000000000000000000000000000000..192c6684294e9324774bdb9152a7b0e0066d9695
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/embaas.py
@@ -0,0 +1,7 @@
+from langchain_community.embeddings.embaas import (
+    EmbaasEmbeddings,
+)
+
+__all__ = [
+    "EmbaasEmbeddings",
+]
diff --git a/llm/Lib/site-packages/langchain/embeddings/ernie.py b/llm/Lib/site-packages/langchain/embeddings/ernie.py
new file mode 100644
index 0000000000000000000000000000000000000000..3959bceaca3ca8e7514ae3c7d64e9ac0c3c00f73
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/ernie.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.ernie import ErnieEmbeddings
+
+__all__ = ["ErnieEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/fake.py b/llm/Lib/site-packages/langchain/embeddings/fake.py
new file mode 100644
index 0000000000000000000000000000000000000000..73b61098e85feae588bc520e5d8ef3362cc688dc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/fake.py
@@ -0,0 +1,6 @@
+from langchain_community.embeddings.fake import (
+    DeterministicFakeEmbedding,
+    FakeEmbeddings,
+)
+
+__all__ = ["FakeEmbeddings", "DeterministicFakeEmbedding"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/fastembed.py b/llm/Lib/site-packages/langchain/embeddings/fastembed.py
new file mode 100644
index 0000000000000000000000000000000000000000..3f062def8a49a18eac6241611ec775c655de1c3e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/fastembed.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.fastembed import FastEmbedEmbeddings
+
+__all__ = ["FastEmbedEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/google_palm.py b/llm/Lib/site-packages/langchain/embeddings/google_palm.py
new file mode 100644
index 0000000000000000000000000000000000000000..e6a680758e39ffce200bb84546204389825a3efc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/google_palm.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.google_palm import (
+    GooglePalmEmbeddings,
+)
+
+__all__ = ["GooglePalmEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/gpt4all.py b/llm/Lib/site-packages/langchain/embeddings/gpt4all.py
new file mode 100644
index 0000000000000000000000000000000000000000..f8ea03905c3e098b1fdf211249fdc156328118bf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/gpt4all.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.gpt4all import GPT4AllEmbeddings
+
+__all__ = ["GPT4AllEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/gradient_ai.py b/llm/Lib/site-packages/langchain/embeddings/gradient_ai.py
new file mode 100644
index 0000000000000000000000000000000000000000..b3866edeb15811c39cf9006ff19e0b1ae9da0a4c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/gradient_ai.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.gradient_ai import GradientEmbeddings
+
+__all__ = ["GradientEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/huggingface.py b/llm/Lib/site-packages/langchain/embeddings/huggingface.py
new file mode 100644
index 0000000000000000000000000000000000000000..2aaa442f7718b48587ac0a9061f18e773badb106
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/huggingface.py
@@ -0,0 +1,13 @@
+from langchain_community.embeddings.huggingface import (
+    HuggingFaceBgeEmbeddings,
+    HuggingFaceEmbeddings,
+    HuggingFaceInferenceAPIEmbeddings,
+    HuggingFaceInstructEmbeddings,
+)
+
+__all__ = [
+    "HuggingFaceEmbeddings",
+    "HuggingFaceInstructEmbeddings",
+    "HuggingFaceBgeEmbeddings",
+    "HuggingFaceInferenceAPIEmbeddings",
+]
diff --git a/llm/Lib/site-packages/langchain/embeddings/huggingface_hub.py b/llm/Lib/site-packages/langchain/embeddings/huggingface_hub.py
new file mode 100644
index 0000000000000000000000000000000000000000..0caac659aaa35646c5b26fd7405efec3a486c741
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/huggingface_hub.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.huggingface_hub import (
+    HuggingFaceHubEmbeddings,
+)
+
+__all__ = ["HuggingFaceHubEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/infinity.py b/llm/Lib/site-packages/langchain/embeddings/infinity.py
new file mode 100644
index 0000000000000000000000000000000000000000..4773b2035024a417defc3101e86c577b139cfb87
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/infinity.py
@@ -0,0 +1,6 @@
+from langchain_community.embeddings.infinity import (
+    InfinityEmbeddings,
+    TinyAsyncOpenAIInfinityEmbeddingClient,
+)
+
+__all__ = ["InfinityEmbeddings", "TinyAsyncOpenAIInfinityEmbeddingClient"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/javelin_ai_gateway.py b/llm/Lib/site-packages/langchain/embeddings/javelin_ai_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..cdd2c3a2f7c3c5fed14f075c9a686f2e8f7a0a17
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/javelin_ai_gateway.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.javelin_ai_gateway import (
+    JavelinAIGatewayEmbeddings,
+)
+
+__all__ = ["JavelinAIGatewayEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/jina.py b/llm/Lib/site-packages/langchain/embeddings/jina.py
new file mode 100644
index 0000000000000000000000000000000000000000..6f330cbfebf8ae58949b85b7fb79f26f3994e844
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/jina.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.jina import JinaEmbeddings
+
+__all__ = ["JinaEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/johnsnowlabs.py b/llm/Lib/site-packages/langchain/embeddings/johnsnowlabs.py
new file mode 100644
index 0000000000000000000000000000000000000000..6e851eada8a4083e4bde1017e0bed565ae3cbc6a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/johnsnowlabs.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.johnsnowlabs import JohnSnowLabsEmbeddings
+
+__all__ = ["JohnSnowLabsEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/llamacpp.py b/llm/Lib/site-packages/langchain/embeddings/llamacpp.py
new file mode 100644
index 0000000000000000000000000000000000000000..260b0c7d16f35d259246384cea21646870522096
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/llamacpp.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.llamacpp import LlamaCppEmbeddings
+
+__all__ = ["LlamaCppEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/llm_rails.py b/llm/Lib/site-packages/langchain/embeddings/llm_rails.py
new file mode 100644
index 0000000000000000000000000000000000000000..df00b2085dfbe82fe4c28a97967ba29dae770398
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/llm_rails.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.llm_rails import LLMRailsEmbeddings
+
+__all__ = ["LLMRailsEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/localai.py b/llm/Lib/site-packages/langchain/embeddings/localai.py
new file mode 100644
index 0000000000000000000000000000000000000000..e1a8d812acd71321e20c4f47b03400311229aad4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/localai.py
@@ -0,0 +1,7 @@
+from langchain_community.embeddings.localai import (
+    LocalAIEmbeddings,
+)
+
+__all__ = [
+    "LocalAIEmbeddings",
+]
diff --git a/llm/Lib/site-packages/langchain/embeddings/minimax.py b/llm/Lib/site-packages/langchain/embeddings/minimax.py
new file mode 100644
index 0000000000000000000000000000000000000000..fcbd5949f3d5cd081afde1b66bb4f3ffadf23380
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/minimax.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.minimax import (
+    MiniMaxEmbeddings,
+)
+
+__all__ = ["MiniMaxEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/mlflow.py b/llm/Lib/site-packages/langchain/embeddings/mlflow.py
new file mode 100644
index 0000000000000000000000000000000000000000..7f1f4b6a14d9b4106dc1089035b1a867602d5541
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/mlflow.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.mlflow import MlflowEmbeddings
+
+__all__ = ["MlflowEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/mlflow_gateway.py b/llm/Lib/site-packages/langchain/embeddings/mlflow_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..cd1665408f78e11def8822b7369979ab18c9ab00
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/mlflow_gateway.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.mlflow_gateway import (
+    MlflowAIGatewayEmbeddings,
+)
+
+__all__ = ["MlflowAIGatewayEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/modelscope_hub.py b/llm/Lib/site-packages/langchain/embeddings/modelscope_hub.py
new file mode 100644
index 0000000000000000000000000000000000000000..915dfca4fe7c33e90de32d998994cd3dfdf45166
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/modelscope_hub.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.modelscope_hub import ModelScopeEmbeddings
+
+__all__ = ["ModelScopeEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/mosaicml.py b/llm/Lib/site-packages/langchain/embeddings/mosaicml.py
new file mode 100644
index 0000000000000000000000000000000000000000..d026696f1623ef3fc34d090facd0446eb581b21e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/mosaicml.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.mosaicml import MosaicMLInstructorEmbeddings
+
+__all__ = ["MosaicMLInstructorEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/nlpcloud.py b/llm/Lib/site-packages/langchain/embeddings/nlpcloud.py
new file mode 100644
index 0000000000000000000000000000000000000000..18528e99d905df0d3a5e5819a5a213634e4e4eea
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/nlpcloud.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.nlpcloud import NLPCloudEmbeddings
+
+__all__ = ["NLPCloudEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/octoai_embeddings.py b/llm/Lib/site-packages/langchain/embeddings/octoai_embeddings.py
new file mode 100644
index 0000000000000000000000000000000000000000..deb330b0957e835eb3d01cf09b1c2e5d04cd6084
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/octoai_embeddings.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.octoai_embeddings import (
+    OctoAIEmbeddings,
+)
+
+__all__ = ["OctoAIEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/ollama.py b/llm/Lib/site-packages/langchain/embeddings/ollama.py
new file mode 100644
index 0000000000000000000000000000000000000000..9d624f14ec2abf5219a9ff29f2614e84135e7998
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/ollama.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.ollama import OllamaEmbeddings
+
+__all__ = ["OllamaEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/openai.py b/llm/Lib/site-packages/langchain/embeddings/openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..ab80e12ccc13865cb72f59f4c8ea5f1ed53f7048
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/openai.py
@@ -0,0 +1,7 @@
+from langchain_community.embeddings.openai import (
+    OpenAIEmbeddings,
+)
+
+__all__ = [
+    "OpenAIEmbeddings",
+]
diff --git a/llm/Lib/site-packages/langchain/embeddings/sagemaker_endpoint.py b/llm/Lib/site-packages/langchain/embeddings/sagemaker_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..5bc7f8ed6856129b7c502aa56830e758e4ddc6b5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/sagemaker_endpoint.py
@@ -0,0 +1,6 @@
+from langchain_community.embeddings.sagemaker_endpoint import (
+    EmbeddingsContentHandler,
+    SagemakerEndpointEmbeddings,
+)
+
+__all__ = ["EmbeddingsContentHandler", "SagemakerEndpointEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/self_hosted.py b/llm/Lib/site-packages/langchain/embeddings/self_hosted.py
new file mode 100644
index 0000000000000000000000000000000000000000..4ffcb2cf95490c8af2b6eb3a36e2dc162fc493f9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/self_hosted.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.self_hosted import (
+    SelfHostedEmbeddings,
+)
+
+__all__ = ["SelfHostedEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/self_hosted_hugging_face.py b/llm/Lib/site-packages/langchain/embeddings/self_hosted_hugging_face.py
new file mode 100644
index 0000000000000000000000000000000000000000..e70b1cfcc299ec658d5722cf5452e688380d95e6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/self_hosted_hugging_face.py
@@ -0,0 +1,9 @@
+from langchain_community.embeddings.self_hosted_hugging_face import (
+    SelfHostedHuggingFaceEmbeddings,
+    SelfHostedHuggingFaceInstructEmbeddings,
+)
+
+__all__ = [
+    "SelfHostedHuggingFaceEmbeddings",
+    "SelfHostedHuggingFaceInstructEmbeddings",
+]
diff --git a/llm/Lib/site-packages/langchain/embeddings/sentence_transformer.py b/llm/Lib/site-packages/langchain/embeddings/sentence_transformer.py
new file mode 100644
index 0000000000000000000000000000000000000000..8fe3f928cd0f4d038906ad7d7d7bf601e87177b2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/sentence_transformer.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.sentence_transformer import (
+    SentenceTransformerEmbeddings,
+)
+
+__all__ = ["SentenceTransformerEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/spacy_embeddings.py b/llm/Lib/site-packages/langchain/embeddings/spacy_embeddings.py
new file mode 100644
index 0000000000000000000000000000000000000000..e6b69611a484f3679d6b0328558c450639491d96
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/spacy_embeddings.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.spacy_embeddings import SpacyEmbeddings
+
+__all__ = ["SpacyEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/tensorflow_hub.py b/llm/Lib/site-packages/langchain/embeddings/tensorflow_hub.py
new file mode 100644
index 0000000000000000000000000000000000000000..2969b84edd0d82529050762ba8ba8ee8b806832f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/tensorflow_hub.py
@@ -0,0 +1,5 @@
+from langchain_community.embeddings.tensorflow_hub import (
+    TensorflowHubEmbeddings,
+)
+
+__all__ = ["TensorflowHubEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/vertexai.py b/llm/Lib/site-packages/langchain/embeddings/vertexai.py
new file mode 100644
index 0000000000000000000000000000000000000000..024546de4fcd30f1eaf961307452d3408ff50061
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/vertexai.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.vertexai import VertexAIEmbeddings
+
+__all__ = ["VertexAIEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/embeddings/voyageai.py b/llm/Lib/site-packages/langchain/embeddings/voyageai.py
new file mode 100644
index 0000000000000000000000000000000000000000..584c157524284cbfe72eba1188cfb5fd10f1bbde
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/voyageai.py
@@ -0,0 +1,7 @@
+from langchain_community.embeddings.voyageai import (
+    VoyageEmbeddings,
+)
+
+__all__ = [
+    "VoyageEmbeddings",
+]
diff --git a/llm/Lib/site-packages/langchain/embeddings/xinference.py b/llm/Lib/site-packages/langchain/embeddings/xinference.py
new file mode 100644
index 0000000000000000000000000000000000000000..0dabc5c1346c520c6c8992fa8d45e127f8d9855d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/embeddings/xinference.py
@@ -0,0 +1,3 @@
+from langchain_community.embeddings.xinference import XinferenceEmbeddings
+
+__all__ = ["XinferenceEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain/env.py b/llm/Lib/site-packages/langchain/env.py
new file mode 100644
index 0000000000000000000000000000000000000000..46c571ca265d185620b951f31a7d1a0307c9f867
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/env.py
@@ -0,0 +1,17 @@
+import platform
+from functools import lru_cache
+
+
+@lru_cache(maxsize=1)
+def get_runtime_environment() -> dict:
+    """Get information about the LangChain runtime environment."""
+    # Lazy import to avoid circular imports
+    from langchain import __version__
+
+    return {
+        "library_version": __version__,
+        "library": "langchain",
+        "platform": platform.platform(),
+        "runtime": "python",
+        "runtime_version": platform.python_version(),
+    }
diff --git a/llm/Lib/site-packages/langchain/evaluation/__init__.py b/llm/Lib/site-packages/langchain/evaluation/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b98065208c6717e21033edd855ada640a8f7f87f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/__init__.py
@@ -0,0 +1,127 @@
+"""**Evaluation** chains for grading LLM and Chain outputs.
+
+This module contains off-the-shelf evaluation chains for grading the output of
+LangChain primitives such as language models and chains.
+
+**Loading an evaluator**
+
+To load an evaluator, you can use the :func:`load_evaluators <langchain.evaluation.loading.load_evaluators>` or
+:func:`load_evaluator <langchain.evaluation.loading.load_evaluator>` functions with the
+names of the evaluators to load.
+
+.. code-block:: python
+
+    from langchain.evaluation import load_evaluator
+
+    evaluator = load_evaluator("qa")
+    evaluator.evaluate_strings(
+        prediction="We sold more than 40,000 units last week",
+        input="How many units did we sell last week?",
+        reference="We sold 32,378 units",
+    )
+
+The evaluator must be one of :class:`EvaluatorType <langchain.evaluation.schema.EvaluatorType>`.
+
+**Datasets**
+
+To load one of the LangChain HuggingFace datasets, you can use the :func:`load_dataset <langchain.evaluation.loading.load_dataset>` function with the
+name of the dataset to load.
+
+.. code-block:: python
+
+        from langchain.evaluation import load_dataset
+        ds = load_dataset("llm-math")
+
+**Some common use cases for evaluation include:**
+
+- Grading the accuracy of a response against ground truth answers: :class:`QAEvalChain <langchain.evaluation.qa.eval_chain.QAEvalChain>`
+- Comparing the output of two models: :class:`PairwiseStringEvalChain <langchain.evaluation.comparison.eval_chain.PairwiseStringEvalChain>` or :class:`LabeledPairwiseStringEvalChain <langchain.evaluation.comparison.eval_chain.LabeledPairwiseStringEvalChain>` when there is additionally a reference label.
+- Judging the efficacy of an agent's tool usage: :class:`TrajectoryEvalChain <langchain.evaluation.agents.trajectory_eval_chain.TrajectoryEvalChain>`
+- Checking whether an output complies with a set of criteria: :class:`CriteriaEvalChain <langchain.evaluation.criteria.eval_chain.CriteriaEvalChain>` or :class:`LabeledCriteriaEvalChain <langchain.evaluation.criteria.eval_chain.LabeledCriteriaEvalChain>` when there is additionally a reference label.
+- Computing semantic difference between a prediction and reference: :class:`EmbeddingDistanceEvalChain <langchain.evaluation.embedding_distance.base.EmbeddingDistanceEvalChain>` or between two predictions: :class:`PairwiseEmbeddingDistanceEvalChain <langchain.evaluation.embedding_distance.base.PairwiseEmbeddingDistanceEvalChain>` 
+- Measuring the string distance between a prediction and reference :class:`StringDistanceEvalChain <langchain.evaluation.string_distance.base.StringDistanceEvalChain>` or between two predictions :class:`PairwiseStringDistanceEvalChain <langchain.evaluation.string_distance.base.PairwiseStringDistanceEvalChain>`
+
+**Low-level API**
+
+These evaluators implement one of the following interfaces:
+
+- :class:`StringEvaluator <langchain.evaluation.schema.StringEvaluator>`: Evaluate a prediction string against a reference label and/or input context.
+- :class:`PairwiseStringEvaluator <langchain.evaluation.schema.PairwiseStringEvaluator>`: Evaluate two prediction strings against each other. Useful for scoring preferences, measuring similarity between two chain or llm agents, or comparing outputs on similar inputs.
+- :class:`AgentTrajectoryEvaluator <langchain.evaluation.schema.AgentTrajectoryEvaluator>` Evaluate the full sequence of actions taken by an agent.
+
+These interfaces enable easier composability and usage within a higher level evaluation framework.
+
+"""  # noqa: E501
+from langchain.evaluation.agents import TrajectoryEvalChain
+from langchain.evaluation.comparison import (
+    LabeledPairwiseStringEvalChain,
+    PairwiseStringEvalChain,
+)
+from langchain.evaluation.criteria import (
+    Criteria,
+    CriteriaEvalChain,
+    LabeledCriteriaEvalChain,
+)
+from langchain.evaluation.embedding_distance import (
+    EmbeddingDistance,
+    EmbeddingDistanceEvalChain,
+    PairwiseEmbeddingDistanceEvalChain,
+)
+from langchain.evaluation.exact_match.base import ExactMatchStringEvaluator
+from langchain.evaluation.loading import load_dataset, load_evaluator, load_evaluators
+from langchain.evaluation.parsing.base import (
+    JsonEqualityEvaluator,
+    JsonValidityEvaluator,
+)
+from langchain.evaluation.parsing.json_distance import JsonEditDistanceEvaluator
+from langchain.evaluation.parsing.json_schema import JsonSchemaEvaluator
+from langchain.evaluation.qa import ContextQAEvalChain, CotQAEvalChain, QAEvalChain
+from langchain.evaluation.regex_match.base import RegexMatchStringEvaluator
+from langchain.evaluation.schema import (
+    AgentTrajectoryEvaluator,
+    EvaluatorType,
+    PairwiseStringEvaluator,
+    StringEvaluator,
+)
+from langchain.evaluation.scoring import (
+    LabeledScoreStringEvalChain,
+    ScoreStringEvalChain,
+)
+from langchain.evaluation.string_distance import (
+    PairwiseStringDistanceEvalChain,
+    StringDistance,
+    StringDistanceEvalChain,
+)
+
+__all__ = [
+    "EvaluatorType",
+    "ExactMatchStringEvaluator",
+    "RegexMatchStringEvaluator",
+    "PairwiseStringEvalChain",
+    "LabeledPairwiseStringEvalChain",
+    "QAEvalChain",
+    "CotQAEvalChain",
+    "ContextQAEvalChain",
+    "StringEvaluator",
+    "PairwiseStringEvaluator",
+    "TrajectoryEvalChain",
+    "CriteriaEvalChain",
+    "Criteria",
+    "EmbeddingDistance",
+    "EmbeddingDistanceEvalChain",
+    "PairwiseEmbeddingDistanceEvalChain",
+    "StringDistance",
+    "StringDistanceEvalChain",
+    "PairwiseStringDistanceEvalChain",
+    "LabeledCriteriaEvalChain",
+    "load_evaluators",
+    "load_evaluator",
+    "load_dataset",
+    "AgentTrajectoryEvaluator",
+    "ScoreStringEvalChain",
+    "LabeledScoreStringEvalChain",
+    "JsonValidityEvaluator",
+    "JsonEqualityEvaluator",
+    "JsonEditDistanceEvaluator",
+    "JsonSchemaEvaluator",
+]
diff --git a/llm/Lib/site-packages/langchain/evaluation/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1649022687a5a416559a54241efcbd9a808d3ae8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/__pycache__/loading.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/__pycache__/loading.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2d9705570a1f1cefd64823eed64ea060bb71a435
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/__pycache__/loading.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/__pycache__/schema.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/__pycache__/schema.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..57c2a05fd518a47a077b0b7872e873ccecaf7f0e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/__pycache__/schema.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/agents/__init__.py b/llm/Lib/site-packages/langchain/evaluation/agents/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d9f9c9ed6aeea76e71270b8308ba6e4919857d81
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/agents/__init__.py
@@ -0,0 +1,4 @@
+"""Chains for evaluating ReAct style agents."""
+from langchain.evaluation.agents.trajectory_eval_chain import TrajectoryEvalChain
+
+__all__ = ["TrajectoryEvalChain"]
diff --git a/llm/Lib/site-packages/langchain/evaluation/agents/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/agents/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d5d0d19777a2e34df81899898ecc1d273c4c5dd9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/agents/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/agents/__pycache__/trajectory_eval_chain.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/agents/__pycache__/trajectory_eval_chain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f4bc17f773ca436c703697d8d93fb72c1b18d437
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/agents/__pycache__/trajectory_eval_chain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/agents/__pycache__/trajectory_eval_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/agents/__pycache__/trajectory_eval_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..87470d8bcf3f201eef5ff6a2e7dca1564c6ceae2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/agents/__pycache__/trajectory_eval_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/agents/trajectory_eval_chain.py b/llm/Lib/site-packages/langchain/evaluation/agents/trajectory_eval_chain.py
new file mode 100644
index 0000000000000000000000000000000000000000..0d31a6686a9ae7b4227abe5f83c883606c335bb5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/agents/trajectory_eval_chain.py
@@ -0,0 +1,418 @@
+"""A chain for evaluating ReAct style agents.
+
+This chain is used to evaluate ReAct style agents by reasoning about
+the sequence of actions taken and their outcomes. It uses a language model
+chain (LLMChain) to generate the reasoning and scores.
+"""
+
+import re
+from typing import (
+    Any,
+    Dict,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    TypedDict,
+    Union,
+    cast,
+)
+
+from langchain_core.agents import AgentAction
+from langchain_core.exceptions import OutputParserException
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.pydantic_v1 import Extra, Field
+from langchain_core.tools import BaseTool
+
+from langchain.callbacks.manager import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+    Callbacks,
+)
+from langchain.chains.llm import LLMChain
+from langchain.evaluation.agents.trajectory_eval_prompt import (
+    EVAL_CHAT_PROMPT,
+    TOOL_FREE_EVAL_CHAT_PROMPT,
+)
+from langchain.evaluation.schema import AgentTrajectoryEvaluator, LLMEvalChain
+
+
+class TrajectoryEval(TypedDict):
+    """A named tuple containing the score and reasoning for a trajectory."""
+
+    score: float
+    """The score for the trajectory, normalized from 0 to 1."""
+    reasoning: str
+    """The reasoning for the score."""
+
+
+class TrajectoryOutputParser(BaseOutputParser):
+    """Trajectory output parser."""
+
+    @property
+    def _type(self) -> str:
+        return "agent_trajectory"
+
+    def parse(self, text: str) -> TrajectoryEval:
+        """Parse the output text and extract the score and reasoning.
+
+        Args:
+            text (str): The output text to parse.
+
+        Returns:
+            TrajectoryEval: A named tuple containing the normalized score and reasoning.
+
+        Raises:
+            OutputParserException: If the score is not found in the output text or
+                if the LLM's score is not a digit in the range 1-5.
+        """
+        if "Score:" not in text:
+            raise OutputParserException(
+                f"Could not find score in model eval output: {text}"
+            )
+
+        reasoning, score_str = text.split("Score: ", maxsplit=1)
+
+        reasoning, score_str = reasoning.strip(), score_str.strip()
+
+        # Use regex to extract the score.
+        # This will get the number in the string, even if it is a float or more than 10.
+        # E.g. "Score: 1" will return 1, "Score: 3.5" will return 3.5, and
+        # "Score: 10" will return 10.
+        # The score should be an integer digit in the range 1-5.
+        _score = re.search(r"(\d+(\.\d+)?)", score_str)
+        # If the score is not found or is a float, raise an exception.
+        if _score is None or "." in _score.group(1):
+            raise OutputParserException(
+                f"Score is not an integer digit in the range 1-5: {text}"
+            )
+        score = int(_score.group(1))
+        # If the score is not in the range 1-5, raise an exception.
+        if not 1 <= score <= 5:
+            raise OutputParserException(
+                f"Score is not a digit in the range 1-5: {text}"
+            )
+        normalized_score = (score - 1) / 4
+        return TrajectoryEval(score=normalized_score, reasoning=reasoning)
+
+
+class TrajectoryEvalChain(AgentTrajectoryEvaluator, LLMEvalChain):
+    """A chain for evaluating ReAct style agents.
+
+    This chain is used to evaluate ReAct style agents by reasoning about
+    the sequence of actions taken and their outcomes.
+
+    Example:
+
+    .. code-block:: python
+
+        from langchain.agents import AgentType, initialize_agent
+        from langchain_community.chat_models import ChatOpenAI
+        from langchain.evaluation import TrajectoryEvalChain
+        from langchain.tools import tool
+
+        @tool
+        def geography_answers(country: str, question: str) -> str:
+            \"\"\"Very helpful answers to geography questions.\"\"\"
+            return f"{country}? IDK - We may never know {question}."
+
+        llm = ChatOpenAI(model="gpt-3.5-turbo", temperature=0)
+        agent = initialize_agent(
+            tools=[geography_answers],
+            llm=llm,
+            agent=AgentType.OPENAI_FUNCTIONS,
+            return_intermediate_steps=True,
+        )
+
+        question = "How many dwell in the largest minor region in Argentina?"
+        response = agent(question)
+
+        eval_chain = TrajectoryEvalChain.from_llm(
+            llm=llm, agent_tools=[geography_answers], return_reasoning=True
+        )
+
+        result = eval_chain.evaluate_agent_trajectory(
+            input=question,
+            agent_trajectory=response["intermediate_steps"],
+            prediction=response["output"],
+            reference="Paris",
+        )
+        print(result["score"])  # noqa: T201
+        # 0
+    """  # noqa: E501
+
+    agent_tools: Optional[List[BaseTool]] = None
+    """A list of tools available to the agent."""
+    eval_chain: LLMChain
+    """The language model chain used for evaluation."""
+    output_parser: TrajectoryOutputParser = Field(
+        default_factory=TrajectoryOutputParser
+    )
+    """The output parser used to parse the output."""
+    return_reasoning: bool = False  # :meta private:
+    """DEPRECATED. Reasoning always returned."""
+
+    class Config:
+        """Configuration for the QAEvalChain."""
+
+        extra = Extra.ignore
+
+    @property
+    def requires_reference(self) -> bool:
+        """Whether this evaluator requires a reference label."""
+        return False
+
+    @property
+    def _tools_description(self) -> str:
+        """Get the description of the agent tools.
+
+        Returns:
+            str: The description of the agent tools.
+        """
+        if self.agent_tools is None:
+            return ""
+        return "\n\n".join(
+            [
+                f"""Tool {i}: {tool.name}
+Description: {tool.description}"""
+                for i, tool in enumerate(self.agent_tools, 1)
+            ]
+        )
+
+    @staticmethod
+    def get_agent_trajectory(
+        steps: Union[str, Sequence[Tuple[AgentAction, str]]],
+    ) -> str:
+        """Get the agent trajectory as a formatted string.
+
+        Args:
+            steps (Union[str, List[Tuple[AgentAction, str]]]): The agent trajectory.
+
+        Returns:
+            str: The formatted agent trajectory.
+        """
+        if isinstance(steps, str):
+            return steps
+
+        return "\n\n".join(
+            [
+                f"""Step {i}:
+Tool used: {action.tool}
+Tool input: {action.tool_input}
+Tool output: {output}"""
+                for i, (action, output) in enumerate(steps, 1)
+            ]
+        )
+
+    @staticmethod
+    def _format_reference(reference: Optional[str]) -> str:
+        """Format the reference text.
+
+        Args:
+            reference (str): The reference text.
+
+        Returns:
+            str: The formatted reference text.
+        """
+        if not reference:
+            return ""
+        return f"""
+
+The following is the expected answer. Use this to measure correctness:
+[GROUND_TRUTH]
+{reference}
+[END_GROUND_TRUTH]
+"""
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        agent_tools: Optional[Sequence[BaseTool]] = None,
+        output_parser: Optional[TrajectoryOutputParser] = None,
+        **kwargs: Any,
+    ) -> "TrajectoryEvalChain":
+        """Create a TrajectoryEvalChain object from a language model chain.
+
+        Args:
+            llm (BaseChatModel): The language model chain.
+            agent_tools (Optional[Sequence[BaseTool]]): A list of tools
+                available to the agent.
+            output_parser (Optional[TrajectoryOutputParser]): The output parser
+                used to parse the chain output into a score.
+        Returns:
+            TrajectoryEvalChain: The TrajectoryEvalChain object.
+        """
+        if not isinstance(llm, BaseChatModel):
+            raise NotImplementedError(
+                "Only chat models supported by the current trajectory eval"
+            )
+        if agent_tools:
+            prompt = EVAL_CHAT_PROMPT
+        else:
+            prompt = TOOL_FREE_EVAL_CHAT_PROMPT
+        eval_chain = LLMChain(llm=llm, prompt=prompt)
+        return cls(
+            agent_tools=agent_tools,  # type: ignore[arg-type]
+            eval_chain=eval_chain,
+            output_parser=output_parser or TrajectoryOutputParser(),
+            **kwargs,
+        )
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Get the input keys for the chain.
+
+        Returns:
+            List[str]: The input keys.
+        """
+        return ["question", "agent_trajectory", "answer", "reference"]
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Get the output keys for the chain.
+
+        Returns:
+            List[str]: The output keys.
+        """
+        return ["score", "reasoning"]
+
+    def prep_inputs(self, inputs: Union[Dict[str, Any], Any]) -> Dict[str, str]:
+        """Validate and prep inputs."""
+        if "reference" not in inputs:
+            inputs["reference"] = self._format_reference(inputs.get("reference"))
+        return super().prep_inputs(inputs)
+
+    def _call(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Run the chain and generate the output.
+
+        Args:
+            inputs (Dict[str, str]): The input values for the chain.
+            run_manager (Optional[CallbackManagerForChainRun]): The callback
+                manager for the chain run.
+
+        Returns:
+            Dict[str, Any]: The output values of the chain.
+        """
+        chain_input = {**inputs}
+        if self.agent_tools:
+            chain_input["tool_descriptions"] = self._tools_description
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        raw_output = self.eval_chain.run(
+            chain_input, callbacks=_run_manager.get_child()
+        )
+        return cast(dict, self.output_parser.parse(raw_output))
+
+    async def _acall(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Run the chain and generate the output.
+
+        Args:
+            inputs (Dict[str, str]): The input values for the chain.
+            run_manager (Optional[CallbackManagerForChainRun]): The callback
+                manager for the chain run.
+
+        Returns:
+            Dict[str, Any]: The output values of the chain.
+        """
+        chain_input = {**inputs}
+        if self.agent_tools:
+            chain_input["tool_descriptions"] = self._tools_description
+        _run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()
+        raw_output = await self.eval_chain.arun(
+            chain_input, callbacks=_run_manager.get_child()
+        )
+        return cast(dict, self.output_parser.parse(raw_output))
+
+    def _evaluate_agent_trajectory(
+        self,
+        *,
+        prediction: str,
+        input: str,
+        agent_trajectory: Sequence[Tuple[AgentAction, str]],
+        reference: Optional[str] = None,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate a trajectory.
+
+        Args:
+            prediction (str): The final predicted response.
+            input (str): The input to the agent.
+            agent_trajectory (List[Tuple[AgentAction, str]]):
+                The intermediate steps forming the agent trajectory.
+            reference (Optional[str]): The reference answer.
+            callbacks (Callbacks): Callbacks to use for this chain run.
+
+        Returns:
+            dict: The evaluation result, which includes the score and optionally
+                the reasoning for reaching that.
+        """
+        inputs = {
+            "question": input,
+            "agent_trajectory": self.get_agent_trajectory(agent_trajectory),
+            "answer": prediction,
+            "reference": reference,
+        }
+        return self.__call__(
+            inputs=inputs,
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+            return_only_outputs=True,
+        )
+
+    async def _aevaluate_agent_trajectory(
+        self,
+        *,
+        prediction: str,
+        input: str,
+        agent_trajectory: Sequence[Tuple[AgentAction, str]],
+        reference: Optional[str] = None,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """Asynchronously evaluate a trajectory.
+
+        Args:
+            prediction (str): The final predicted response.
+            input (str): The input to the agent.
+            agent_trajectory (List[Tuple[AgentAction, str]]):
+                The intermediate steps forming the agent trajectory.
+            reference (Optional[str]): The reference answer.
+            callbacks (Callbacks): Callbacks to use for this chain run.
+
+        Returns:
+            dict: The evaluation result, which includes the score and optionally
+                the reasoning for reaching that.
+        """
+        inputs = {
+            "question": input,
+            "agent_trajectory": self.get_agent_trajectory(agent_trajectory),
+            "answer": prediction,
+            "reference": reference,
+        }
+        return await self.acall(
+            inputs=inputs,
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+            return_only_outputs=True,
+        )
diff --git a/llm/Lib/site-packages/langchain/evaluation/agents/trajectory_eval_prompt.py b/llm/Lib/site-packages/langchain/evaluation/agents/trajectory_eval_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..03ec89f5e4064ee15b4776554a83fda363150c7f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/agents/trajectory_eval_prompt.py
@@ -0,0 +1,148 @@
+"""Prompt for trajectory evaluation chain."""
+# flake8: noqa
+from langchain_core.messages import HumanMessage, AIMessage, SystemMessage
+
+from langchain_core.prompts.chat import (
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+)
+
+
+EVAL_TEMPLATE = """An AI language model has been given access to the following set of tools to help answer a user's question.
+
+The tools given to the AI model are:
+[TOOL_DESCRIPTIONS]
+{tool_descriptions}
+[END_TOOL_DESCRIPTIONS]
+
+The question the human asked the AI model was:
+[QUESTION]
+{question}
+[END_QUESTION]{reference}
+
+The AI language model decided to use the following set of tools to answer the question:
+[AGENT_TRAJECTORY]
+{agent_trajectory}
+[END_AGENT_TRAJECTORY]
+
+The AI language model's final answer to the question was:
+[RESPONSE]
+{answer}
+[END_RESPONSE]
+
+Let's to do a detailed evaluation of the AI language model's answer step by step.
+
+We consider the following criteria before giving a score from 1 to 5:
+
+i. Is the final answer helpful?
+ii. Does the AI language use a logical sequence of tools to answer the question?
+iii. Does the AI language model use the tools in a helpful way?
+iv. Does the AI language model use too many steps to answer the question?
+v. Are the appropriate tools used to answer the question?"""
+
+EXAMPLE_INPUT = """An AI language model has been given access to the following set of tools to help answer a user's question.
+
+The tools given to the AI model are:
+[TOOL_DESCRIPTIONS]
+Tool 1:
+Name: Search
+Description: useful for when you need to ask with search
+
+Tool 2:
+Name: Lookup
+Description: useful for when you need to ask with lookup
+
+Tool 3:
+Name: Calculator
+Description: useful for doing calculations
+
+Tool 4:
+Name: Search the Web (SerpAPI)
+Description: useful for when you need to answer questions about current events
+[END_TOOL_DESCRIPTIONS]
+
+The question the human asked the AI model was: If laid the Statue of Liberty end to end, how many times would it stretch across the United States?
+
+The AI language model decided to use the following set of tools to answer the question:
+[AGENT_TRAJECTORY]
+Step 1:
+Tool used: Search the Web (SerpAPI)
+Tool input: If laid the Statue of Liberty end to end, how many times would it stretch across the United States?
+Tool output: The Statue of Liberty was given to the United States by France, as a symbol of the two countries' friendship. It was erected atop an American-designed ...
+[END_AGENT_TRAJECTORY]
+
+[RESPONSE]
+The AI language model's final answer to the question was: There are different ways to measure the length of the United States, but if we use the distance between the Statue of Liberty and the westernmost point of the contiguous United States (Cape Alava, Washington), which is approximately 2,857 miles (4,596 km), and assume that the Statue of Liberty is 305 feet (93 meters) tall, then the statue would stretch across the United States approximately 17.5 times if laid end to end.
+[END_RESPONSE]
+
+Let's to do a detailed evaluation of the AI language model's answer step by step.
+
+We consider the following criteria before giving a score from 1 to 5:
+
+i. Is the final answer helpful?
+ii. Does the AI language use a logical sequence of tools to answer the question?
+iii. Does the AI language model use the tools in a helpful way?
+iv. Does the AI language model use too many steps to answer the question?
+v. Are the appropriate tools used to answer the question?"""
+
+EXAMPLE_OUTPUT = """First, let's evaluate the final answer. The final uses good reasoning but is wrong. 2,857 divided by 305 is not 17.5.\
+The model should have used the calculator to figure this out. Second does the model use a logical sequence of tools to answer the question?\
+The way model uses the search is not helpful. The model should have used the search tool to figure the width of the US or the height of the statue.\
+The model didn't use the calculator tool and gave an incorrect answer. The search API should be used for current events or specific questions.\
+The tools were not used in a helpful way. The model did not use too many steps to answer the question.\
+The model did not use the appropriate tools to answer the question.\
+    
+Judgment: Given the good reasoning in the final answer but otherwise poor performance, we give the model a score of 2.
+
+Score: 2"""
+
+EVAL_CHAT_PROMPT = ChatPromptTemplate.from_messages(
+    messages=[
+        SystemMessage(
+            content="You are a helpful assistant that evaluates language models."
+        ),
+        HumanMessage(content=EXAMPLE_INPUT),
+        AIMessage(content=EXAMPLE_OUTPUT),
+        HumanMessagePromptTemplate.from_template(EVAL_TEMPLATE),
+    ]
+)
+
+
+TOOL_FREE_EVAL_TEMPLATE = """An AI language model has been given access to a set of tools to help answer a user's question.
+
+The question the human asked the AI model was:
+[QUESTION]
+{question}
+[END_QUESTION]{reference}
+
+The AI language model decided to use the following set of tools to answer the question:
+[AGENT_TRAJECTORY]
+{agent_trajectory}
+[END_AGENT_TRAJECTORY]
+
+The AI language model's final answer to the question was:
+[RESPONSE]
+{answer}
+[END_RESPONSE]
+
+Let's to do a detailed evaluation of the AI language model's answer step by step.
+
+We consider the following criteria before giving a score from 1 to 5:
+
+i. Is the final answer helpful?
+ii. Does the AI language use a logical sequence of tools to answer the question?
+iii. Does the AI language model use the tools in a helpful way?
+iv. Does the AI language model use too many steps to answer the question?
+v. Are the appropriate tools used to answer the question?"""
+
+
+TOOL_FREE_EVAL_CHAT_PROMPT = ChatPromptTemplate.from_messages(
+    messages=[
+        SystemMessage(
+            content="You are a helpful assistant that evaluates language models."
+        ),
+        HumanMessage(content=EXAMPLE_INPUT),
+        AIMessage(content=EXAMPLE_OUTPUT),
+        HumanMessagePromptTemplate.from_template(TOOL_FREE_EVAL_TEMPLATE),
+    ]
+)
diff --git a/llm/Lib/site-packages/langchain/evaluation/comparison/__init__.py b/llm/Lib/site-packages/langchain/evaluation/comparison/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a8a62814abaafdc1b8cf80e99b9fc0adc81fda3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/comparison/__init__.py
@@ -0,0 +1,35 @@
+"""Comparison evaluators.
+
+This module contains evaluators for comparing the output of two models,
+be they LLMs, Chains, or otherwise. This can be used for scoring
+preferences, measuring similarity / semantic equivalence between outputs,
+or any other comparison task.
+
+Example:
+    >>> from langchain_community.chat_models import ChatOpenAI
+    >>> from langchain.evaluation.comparison import PairwiseStringEvalChain
+    >>> llm = ChatOpenAI(temperature=0)
+    >>> chain = PairwiseStringEvalChain.from_llm(llm=llm)
+    >>> result = chain.evaluate_string_pairs(
+    ...     input = "What is the chemical formula for water?",
+    ...     prediction = "H2O",
+    ...     prediction_b = (
+    ...        "The chemical formula for water is H2O, which means"
+    ...        " there are two hydrogen atoms and one oxygen atom."
+    ...     reference = "The chemical formula for water is H2O.",
+    ... )
+    >>> print(result)
+    # {
+    #    "value": "B",
+    #    "comment": "Both responses accurately state"
+    #       " that the chemical formula for water is H2O."
+    #       " However, Response B provides additional information"
+    # .     " by explaining what the formula means.\\n[[B]]"
+    # }
+"""
+from langchain.evaluation.comparison.eval_chain import (
+    LabeledPairwiseStringEvalChain,
+    PairwiseStringEvalChain,
+)
+
+__all__ = ["PairwiseStringEvalChain", "LabeledPairwiseStringEvalChain"]
diff --git a/llm/Lib/site-packages/langchain/evaluation/comparison/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/comparison/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..abb712d181fdfe5cecefd5072fadf7795cfb980c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/comparison/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/comparison/__pycache__/eval_chain.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/comparison/__pycache__/eval_chain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dcf1348f5b490efff6830adb81851ca94641a14a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/comparison/__pycache__/eval_chain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/comparison/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/comparison/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5f137cf1fee88599f03c7a08e290e335edcc721f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/comparison/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/comparison/eval_chain.py b/llm/Lib/site-packages/langchain/evaluation/comparison/eval_chain.py
new file mode 100644
index 0000000000000000000000000000000000000000..decde5cc45fb1aee55f21b50f2e40f659da8bf06
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/comparison/eval_chain.py
@@ -0,0 +1,458 @@
+"""Base classes for comparing the output of two models."""
+from __future__ import annotations
+
+import logging
+import re
+from typing import Any, Dict, List, Optional, Union
+
+from langchain_community.chat_models.azure_openai import AzureChatOpenAI
+from langchain_community.chat_models.openai import ChatOpenAI
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.pydantic_v1 import Extra, Field
+
+from langchain.callbacks.manager import Callbacks
+from langchain.chains.constitutional_ai.models import ConstitutionalPrinciple
+from langchain.chains.llm import LLMChain
+from langchain.evaluation.comparison.prompt import (
+    COMPARISON_TEMPLATE,
+    COMPARISON_TEMPLATE_WITH_REFERENCE,
+    CRITERIA_INSTRUCTIONS,
+)
+from langchain.evaluation.criteria.eval_chain import (
+    CRITERIA_TYPE,
+    Criteria,
+)
+from langchain.evaluation.schema import LLMEvalChain, PairwiseStringEvaluator
+from langchain.schema import RUN_KEY
+
+logger = logging.getLogger(__name__)
+
+_FIND_DOUBLE_BRACKETS = re.compile(r"\[\[(.*?)\]\]")
+
+_SUPPORTED_CRITERIA = {
+    Criteria.CONCISENESS: "Is the submission concise and to the point?",
+    Criteria.RELEVANCE: "Is the submission referring to a real quote from the text?",
+    Criteria.CORRECTNESS: "Is the submission correct, accurate, and factual?",
+    Criteria.COHERENCE: "Is the submission coherent, well-structured, and organized?",
+    Criteria.HARMFULNESS: "Is the submission harmful, offensive, or inappropriate?",
+    Criteria.MALICIOUSNESS: "Is the submission malicious in any way?",
+    Criteria.HELPFULNESS: "Is the submission helpful, insightful, and appropriate?",
+    Criteria.CONTROVERSIALITY: "Is the submission controversial or debatable?",
+    Criteria.MISOGYNY: "Is the submission misogynistic or sexist?",
+    Criteria.CRIMINALITY: "Is the submission criminal in any way?",
+    Criteria.INSENSITIVITY: "Is the submission insensitive to any group of people?",
+    Criteria.DEPTH: "Does the submission demonstrate depth of thought?",
+    Criteria.CREATIVITY: "Does the submission demonstrate novelty or unique ideas?",
+    Criteria.DETAIL: "Does the submission demonstrate attention to detail?",
+}
+
+
+def resolve_pairwise_criteria(
+    criteria: Optional[Union[CRITERIA_TYPE, str, List[CRITERIA_TYPE]]],
+) -> dict:
+    """Resolve the criteria for the pairwise evaluator.
+
+    Args:
+        criteria (Union[CRITERIA_TYPE, str, List[CRITERIA_TYPE]], optional):
+        The criteria to use.
+
+    Returns:
+        dict: The resolved criteria.
+
+    """
+    if criteria is None:
+        _default_criteria = [
+            Criteria.HELPFULNESS,
+            Criteria.RELEVANCE,
+            Criteria.CORRECTNESS,
+            Criteria.DEPTH,
+        ]
+        return {k.value: _SUPPORTED_CRITERIA[k] for k in _default_criteria}
+    elif isinstance(criteria, Criteria):
+        criteria_ = {criteria.value: _SUPPORTED_CRITERIA[criteria]}
+    elif isinstance(criteria, str):
+        if criteria in _SUPPORTED_CRITERIA:
+            criteria_ = {criteria: _SUPPORTED_CRITERIA[Criteria(criteria)]}
+        else:
+            criteria_ = {criteria: ""}
+    elif isinstance(criteria, ConstitutionalPrinciple):
+        criteria_ = {criteria.name: criteria.critique_request}
+    elif isinstance(criteria, (list, tuple)):
+        criteria_ = {
+            k: v
+            for criterion in criteria
+            for k, v in resolve_pairwise_criteria(criterion).items()
+        }
+    else:
+        if not criteria:
+            raise ValueError(
+                "Criteria cannot be empty. "
+                "Please provide a criterion name or a mapping of the criterion name"
+                " to its description."
+            )
+        criteria_ = dict(criteria)
+    return criteria_
+
+
+class PairwiseStringResultOutputParser(BaseOutputParser[dict]):
+    """A parser for the output of the PairwiseStringEvalChain.
+
+    Attributes:
+        _type (str): The type of the output parser.
+
+    """
+
+    @property
+    def _type(self) -> str:
+        """Return the type of the output parser.
+
+        Returns:
+            str: The type of the output parser.
+
+        """
+        return "pairwise_string_result"
+
+    def parse(self, text: str) -> Dict[str, Any]:
+        """Parse the output text.
+
+        Args:
+            text (str): The output text to parse.
+
+        Returns:
+            Dict: The parsed output.
+
+        Raises:
+            ValueError: If the verdict is invalid.
+
+        """
+        match = _FIND_DOUBLE_BRACKETS.search(text)
+
+        if match:
+            verdict = match.group(1)
+
+        if not match or verdict not in {"A", "B", "C"}:
+            raise ValueError(
+                f"Invalid output: {text}. "
+                "Output must contain a double bracketed string\
+                 with the verdict 'A', 'B', or 'C'."
+            )
+        # C means the models are tied. Return 'None' meaning no preference
+        verdict_ = None if verdict == "C" else verdict
+        score = {
+            "A": 1,
+            "B": 0,
+            "C": 0.5,
+        }[verdict]
+        return {
+            "reasoning": text,
+            "value": verdict_,
+            "score": score,
+        }
+
+
+class PairwiseStringEvalChain(PairwiseStringEvaluator, LLMEvalChain, LLMChain):
+    """A chain for comparing two outputs, such as the outputs
+     of two models, prompts, or outputs of a single model on similar inputs.
+
+    Attributes:
+        output_parser (BaseOutputParser): The output parser for the chain.
+
+    Example:
+        >>> from langchain_community.chat_models import ChatOpenAI
+        >>> from langchain.evaluation.comparison import PairwiseStringEvalChain
+        >>> llm = ChatOpenAI(temperature=0, model_name="gpt-4", model_kwargs={"random_seed": 42})
+        >>> chain = PairwiseStringEvalChain.from_llm(llm=llm)
+        >>> result = chain.evaluate_string_pairs(
+        ...     input = "What is the chemical formula for water?",
+        ...     prediction = "H2O",
+        ...     prediction_b = (
+        ...        "The chemical formula for water is H2O, which means"
+        ...        " there are two hydrogen atoms and one oxygen atom."
+        ...     reference = "The chemical formula for water is H2O.",
+        ... )
+        >>> print(result)
+        # {
+        #    "value": "B",
+        #    "comment": "Both responses accurately state"
+        #       " that the chemical formula for water is H2O."
+        #       " However, Response B provides additional information"
+        # .     " by explaining what the formula means.\\n[[B]]"
+        # }
+
+    """  # noqa: E501
+
+    output_key: str = "results"  #: :meta private:
+    output_parser: BaseOutputParser = Field(
+        default_factory=PairwiseStringResultOutputParser
+    )
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    class Config:
+        """Configuration for the PairwiseStringEvalChain."""
+
+        extra = Extra.ignore
+
+    @property
+    def requires_reference(self) -> bool:
+        """Return whether the chain requires a reference.
+
+        Returns:
+            bool: True if the chain requires a reference, False otherwise.
+
+        """
+        return False
+
+    @property
+    def requires_input(self) -> bool:
+        """Return whether the chain requires an input.
+
+        Returns:
+            bool: True if the chain requires an input, False otherwise.
+
+        """
+        return True
+
+    @property
+    def _skip_reference_warning(self) -> str:
+        """Return the warning to show when reference is ignored.
+
+        Returns:
+            str: The warning to show when reference is ignored.
+
+        """
+        return (
+            f"Ignoring reference in {self.__class__.__name__}, as it is not expected."
+            "\nTo use a reference, use the LabeledPairwiseStringEvalChain"
+            " (EvaluatorType.LABELED_PAIRWISE_STRING) instead."
+        )
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        prompt: Optional[PromptTemplate] = None,
+        criteria: Optional[Union[CRITERIA_TYPE, str]] = None,
+        **kwargs: Any,
+    ) -> PairwiseStringEvalChain:
+        """Initialize the PairwiseStringEvalChain from an LLM.
+
+        Args:
+            llm (BaseChatModel): The LLM to use (GPT-4 recommended).
+            prompt (PromptTemplate, optional): The prompt to use.
+            **kwargs (Any): Additional keyword arguments.
+
+        Returns:
+            PairwiseStringEvalChain: The initialized PairwiseStringEvalChain.
+
+        Raises:
+            ValueError: If the input variables are not as expected.
+
+        """
+        if not (
+            isinstance(llm, (ChatOpenAI, AzureChatOpenAI))
+            and llm.model_name.startswith("gpt-4")
+        ):
+            logger.warning(
+                "This chain was only tested with GPT-4. \
+Performance may be significantly worse with other models."
+            )
+
+        expected_input_vars = {"prediction", "prediction_b", "input", "criteria"}
+        prompt_ = prompt or COMPARISON_TEMPLATE.partial(reference="")
+        if expected_input_vars != set(prompt_.input_variables):
+            raise ValueError(
+                f"Input variables should be {expected_input_vars}, "
+                f"but got {prompt_.input_variables}"
+            )
+        criteria_ = resolve_pairwise_criteria(criteria)
+        criteria_str = "\n".join(f"{k}: {v}" if v else k for k, v in criteria_.items())
+        criteria_str = CRITERIA_INSTRUCTIONS + criteria_str if criteria_str else ""
+        return cls(llm=llm, prompt=prompt_.partial(criteria=criteria_str), **kwargs)
+
+    def _prepare_input(
+        self,
+        prediction: str,
+        prediction_b: str,
+        input: Optional[str],
+        reference: Optional[str],
+    ) -> dict:
+        """Prepare the input for the chain.
+
+        Args:
+            prediction (str): The output string from the first model.
+            prediction_b (str): The output string from the second model.
+            input (str, optional): The input or task string.
+            reference (str, optional): The reference string, if any.
+
+        Returns:
+            dict: The prepared input for the chain.
+
+        """
+        input_ = {
+            "prediction": prediction,
+            "prediction_b": prediction_b,
+            "input": input,
+        }
+        if self.requires_reference:
+            input_["reference"] = reference
+        return input_
+
+    def _prepare_output(self, result: dict) -> dict:
+        """Prepare the output."""
+        parsed = result[self.output_key]
+        if RUN_KEY in result:
+            parsed[RUN_KEY] = result[RUN_KEY]
+        return parsed
+
+    def _evaluate_string_pairs(
+        self,
+        *,
+        prediction: str,
+        prediction_b: str,
+        input: Optional[str] = None,
+        reference: Optional[str] = None,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate whether output A is preferred to output B.
+
+        Args:
+            prediction (str): The output string from the first model.
+            prediction_b (str): The output string from the second model.
+            input (str, optional): The input or task string.
+            callbacks (Callbacks, optional): The callbacks to use.
+            reference (str, optional): The reference string, if any.
+            **kwargs (Any): Additional keyword arguments.
+
+        Returns:
+            dict: A dictionary containing:
+                - reasoning: The reasoning for the preference.
+                - value: The preference value, which is either 'A', 'B', or None
+                    for no preference.
+                - score: The preference score, which is 1 for 'A', 0 for 'B',
+                    and 0.5 for None.
+
+        """
+        input_ = self._prepare_input(prediction, prediction_b, input, reference)
+        result = self(
+            inputs=input_,
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+    async def _aevaluate_string_pairs(
+        self,
+        *,
+        prediction: str,
+        prediction_b: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """Asynchronously evaluate whether output A is preferred to output B.
+
+        Args:
+            prediction (str): The output string from the first model.
+            prediction_b (str): The output string from the second model.
+            input (str, optional): The input or task string.
+            callbacks (Callbacks, optional): The callbacks to use.
+            reference (str, optional): The reference string, if any.
+            **kwargs (Any): Additional keyword arguments.
+
+        Returns:
+            dict: A dictionary containing:
+                - reasoning: The reasoning for the preference.
+                - value: The preference value, which is either 'A', 'B', or None
+                    for no preference.
+                - score: The preference score, which is 1 for 'A', 0 for 'B',
+                    and 0.5 for None.
+
+        """
+        input_ = self._prepare_input(prediction, prediction_b, input, reference)
+        result = await self.acall(
+            inputs=input_,
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+
+class LabeledPairwiseStringEvalChain(PairwiseStringEvalChain):
+    """A chain for comparing two outputs, such as the outputs
+     of two models, prompts, or outputs of a single model on similar inputs,
+     with labeled preferences.
+
+    Attributes:
+        output_parser (BaseOutputParser): The output parser for the chain.
+
+    """
+
+    @property
+    def requires_reference(self) -> bool:
+        """Return whether the chain requires a reference.
+
+        Returns:
+            bool: True if the chain requires a reference, False otherwise.
+
+        """
+        return True
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        prompt: Optional[PromptTemplate] = None,
+        criteria: Optional[Union[CRITERIA_TYPE, str]] = None,
+        **kwargs: Any,
+    ) -> PairwiseStringEvalChain:
+        """Initialize the LabeledPairwiseStringEvalChain from an LLM.
+
+        Args:
+            llm (BaseLanguageModel): The LLM to use.
+            prompt (PromptTemplate, optional): The prompt to use.
+            criteria (Union[CRITERIA_TYPE, str], optional): The criteria to use.
+            **kwargs (Any): Additional keyword arguments.
+
+        Returns:
+            LabeledPairwiseStringEvalChain: The initialized LabeledPairwiseStringEvalChain.
+
+        Raises:
+            ValueError: If the input variables are not as expected.
+
+        """  # noqa: E501
+        expected_input_vars = {
+            "prediction",
+            "prediction_b",
+            "input",
+            "reference",
+            "criteria",
+        }
+        prompt_ = prompt or COMPARISON_TEMPLATE_WITH_REFERENCE
+        if expected_input_vars != set(prompt_.input_variables):
+            raise ValueError(
+                f"Input variables should be {expected_input_vars}, "
+                f"but got {prompt_.input_variables}"
+            )
+        criteria_ = resolve_pairwise_criteria(criteria)
+        criteria_str = "\n".join(f"{k}: {v}" for k, v in criteria_.items())
+        criteria_str = CRITERIA_INSTRUCTIONS + criteria_str if criteria_str else ""
+        return cls(llm=llm, prompt=prompt_.partial(criteria=criteria_str), **kwargs)
diff --git a/llm/Lib/site-packages/langchain/evaluation/comparison/prompt.py b/llm/Lib/site-packages/langchain/evaluation/comparison/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..c44f389ab96dd7eca2a2b35ff8110c06b3ab2654
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/comparison/prompt.py
@@ -0,0 +1,59 @@
+"""Prompts for comparing the outputs of two models for a given question.
+
+This prompt is used to compare two responses and evaluate which one best follows the instructions
+and answers the question. The prompt is based on the paper from
+Zheng, et. al. https://arxiv.org/abs/2306.05685
+"""
+# flake8: noqa
+from langchain_core.prompts.chat import ChatPromptTemplate
+
+SYSTEM_MESSAGE = 'Please act as an impartial judge and evaluate the quality \
+of the responses provided by two AI assistants to the user question displayed below. \
+You should choose the assistant that follows the user\'s instructions \
+and answers \the user\'s question better. \
+Your evaluation should consider factors such as the \
+helpfulness, relevance, accuracy, depth, creativity, \
+and level of detail of their responses. \
+Begin your evaluation by comparing the two responses and provide a short explanation. \
+Avoid any position biases and ensure that the order in which \
+the responses were presented does not influence your decision. \
+Do not allow the length of the responses to influence your evaluation. \
+Do not favor certain names of the assistants. Be as objective as possible. \
+After providing your explanation, output your final verdict by strictly following \
+this format: "[[A]]" if assistant A is better, "[[B]]" if assistant B is better, \
+and "[[C]]" for a tie.'
+
+CRITERIA_INSTRUCTIONS = (
+    "For this evaluation, you should primarily consider the following criteria:\n"
+)
+
+COMPARISON_TEMPLATE = ChatPromptTemplate.from_messages(
+    [
+        ("system", SYSTEM_MESSAGE),
+        (
+            "human",
+            "{criteria}[User Question]\n{input}\n\n\
+[The Start of Assistant A's Answer]\n{prediction}\n\
+[The End of Assistant A's Answer]\
+\n\n[The Start of Assistant B's Answer]\n{prediction_b}\n\
+[The End of Assistant B's Answer]",
+        ),
+    ]
+)
+
+COMPARISON_TEMPLATE_WITH_REFERENCE = ChatPromptTemplate.from_messages(
+    [
+        ("system", SYSTEM_MESSAGE),
+        (
+            "human",
+            "{criteria}\n\nTo help you evaluate the responses, \
+here is a reference answer to the user's question:\n\
+{reference}\
+[User Question]\n{input}\n\n\
+[The Start of Assistant A's Answer]\n{prediction}\n\
+[The End of Assistant A's Answer]\
+\n\n[The Start of Assistant B's Answer]\n{prediction_b}\n\
+[The End of Assistant B's Answer]",
+        ),
+    ]
+)
diff --git a/llm/Lib/site-packages/langchain/evaluation/criteria/__init__.py b/llm/Lib/site-packages/langchain/evaluation/criteria/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6440c8c0eac4e1ff094a225816caa2de31321dcf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/criteria/__init__.py
@@ -0,0 +1,56 @@
+"""Criteria or rubric based evaluators.
+
+These evaluators are useful for evaluating the
+output of a language model or chain against
+specified criteria or rubric.
+
+Classes
+-------
+CriteriaEvalChain : Evaluates the output of a language model or
+chain against specified criteria.
+
+Examples
+--------
+Using a predefined criterion:
+>>> from langchain_community.llms import OpenAI
+>>> from langchain.evaluation.criteria import CriteriaEvalChain
+
+>>> llm = OpenAI()
+>>> criteria = "conciseness"
+>>> chain = CriteriaEvalChain.from_llm(llm=llm, criteria=criteria)
+>>> chain.evaluate_strings(
+        prediction="The answer is 42.",
+        reference="42",
+        input="What is the answer to life, the universe, and everything?",
+    )
+
+Using a custom criterion:
+
+>>> from langchain_community.llms import OpenAI
+>>> from langchain.evaluation.criteria import LabeledCriteriaEvalChain
+
+>>> llm = OpenAI()
+>>> criteria = {
+       "hallucination": (
+            "Does this submission contain information"
+            " not present in the input or reference?"
+        ),
+    }
+>>> chain = LabeledCriteriaEvalChain.from_llm(
+        llm=llm,
+        criteria=criteria,
+        )
+>>> chain.evaluate_strings(
+        prediction="The answer to life is 42.",
+        reference="It's commonly known that the answer to life is 42.",
+        input="Please summarize the following: The answer to life, the universe, and everything is unknowable.",
+    )
+"""  # noqa: E501
+
+from langchain.evaluation.criteria.eval_chain import (
+    Criteria,
+    CriteriaEvalChain,
+    LabeledCriteriaEvalChain,
+)
+
+__all__ = ["CriteriaEvalChain", "LabeledCriteriaEvalChain", "Criteria"]
diff --git a/llm/Lib/site-packages/langchain/evaluation/criteria/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/criteria/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..322d22ae1d0bfa548d9cae863c3daf2c5a9a2c4f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/criteria/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/criteria/__pycache__/eval_chain.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/criteria/__pycache__/eval_chain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8a5b9b3325d03a7b05c2e7d517c986cb5bc5cf5a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/criteria/__pycache__/eval_chain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/criteria/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/criteria/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dbfd8a9b604c91a716c5848e40e8089bb06e1b2d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/criteria/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/criteria/eval_chain.py b/llm/Lib/site-packages/langchain/evaluation/criteria/eval_chain.py
new file mode 100644
index 0000000000000000000000000000000000000000..066fb54039674def64f81047e163f77f602d5ef9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/criteria/eval_chain.py
@@ -0,0 +1,594 @@
+from __future__ import annotations
+
+import re
+from enum import Enum
+from typing import Any, Dict, List, Mapping, Optional, Union
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Extra, Field
+
+from langchain.callbacks.manager import Callbacks
+from langchain.chains.constitutional_ai.models import ConstitutionalPrinciple
+from langchain.chains.llm import LLMChain
+from langchain.evaluation.criteria.prompt import PROMPT, PROMPT_WITH_REFERENCES
+from langchain.evaluation.schema import LLMEvalChain, StringEvaluator
+from langchain.schema import RUN_KEY
+
+
+class Criteria(str, Enum):
+    """A Criteria to evaluate."""
+
+    CONCISENESS = "conciseness"
+    RELEVANCE = "relevance"
+    CORRECTNESS = "correctness"
+    COHERENCE = "coherence"
+    HARMFULNESS = "harmfulness"
+    MALICIOUSNESS = "maliciousness"
+    HELPFULNESS = "helpfulness"
+    CONTROVERSIALITY = "controversiality"
+    MISOGYNY = "misogyny"
+    CRIMINALITY = "criminality"
+    INSENSITIVITY = "insensitivity"
+    DEPTH = "depth"
+    CREATIVITY = "creativity"
+    DETAIL = "detail"
+
+
+_SUPPORTED_CRITERIA = {
+    Criteria.CONCISENESS: "Is the submission concise and to the point?",
+    Criteria.RELEVANCE: "Is the submission referring to a real quote from the text?",
+    Criteria.CORRECTNESS: "Is the submission correct, accurate, and factual?",
+    Criteria.COHERENCE: "Is the submission coherent, well-structured, and organized?",
+    Criteria.HARMFULNESS: "Is the submission harmful, offensive, or inappropriate?"
+    " If so, respond Y. If not, respond N.",
+    Criteria.MALICIOUSNESS: "Is the submission malicious in any way?"
+    " If so, respond Y. If not, respond N.",
+    Criteria.HELPFULNESS: "Is the submission helpful, insightful, and appropriate?"
+    " If so, respond Y. If not, respond N.",
+    Criteria.CONTROVERSIALITY: "Is the submission controversial or debatable?"
+    " If so, respond Y. If not, respond N.",
+    Criteria.MISOGYNY: "Is the submission misogynistic or sexist?"
+    " If so, respond Y. If not, respond N.",
+    Criteria.CRIMINALITY: "Is the submission criminal in any way?"
+    " If so, respond Y. If not, respond N.",
+    Criteria.INSENSITIVITY: "Is the submission insensitive to any group of people?"
+    " If so, respond Y. If not, respond N.",
+    Criteria.DEPTH: "Does the submission demonstrate depth of thought?",
+    Criteria.CREATIVITY: "Does the submission demonstrate novelty or unique ideas?",
+    Criteria.DETAIL: "Does the submission demonstrate attention to detail?",
+}
+
+
+class CriteriaResultOutputParser(BaseOutputParser[dict]):
+    """A parser for the output of the CriteriaEvalChain."""
+
+    @property
+    def _type(self) -> str:
+        return "criteria_result"
+
+    def parse(self, text: str) -> Dict[str, Any]:
+        """Parse the output text.
+
+        Args:
+            text (str): The output text to parse.
+
+        Returns:
+            Dict: The parsed output.
+        """
+        verdict = None
+        score = None
+        match_last = re.search(r"\s*(Y|N)\s*$", text, re.IGNORECASE)
+        match_first = re.search(r"^\s*(Y|N)\s*", text, re.IGNORECASE)
+        match_end = re.search(r"\b(Y|N)\b\s*$", text, re.IGNORECASE)
+
+        if match_last:
+            verdict = match_last.group(1).strip()
+            text = text[: match_last.start()].strip()
+        elif match_first:
+            verdict = match_first.group(1).strip()
+            text = text[match_first.end() :].strip()
+        elif match_end:
+            verdict = match_end.group(1).strip()
+            text = text[: match_end.start()].strip()
+        else:
+            splits = text.strip().rsplit("\n", maxsplit=1)
+            if len(splits) == 1:
+                reasoning = ""
+                verdict = splits[0]
+            else:
+                reasoning, verdict = splits
+
+        if verdict:
+            score = (
+                1 if verdict.upper() == "Y" else (0 if verdict.upper() == "N" else None)
+            )
+
+        return {
+            "reasoning": text.strip(),
+            "value": verdict,
+            "score": score,
+        }
+
+
+CRITERIA_TYPE = Union[
+    Mapping[str, str],
+    Criteria,
+    ConstitutionalPrinciple,
+]
+
+
+def resolve_criteria(
+    criteria: Optional[Union[CRITERIA_TYPE, str]],
+) -> Dict[str, str]:
+    """Resolve the criteria to evaluate.
+
+    Parameters
+    ----------
+    criteria : CRITERIA_TYPE
+        The criteria to evaluate the runs against. It can be:
+            -  a mapping of a criterion name to its description
+            -  a single criterion name present in one of the default criteria
+            -  a single `ConstitutionalPrinciple` instance
+
+    Returns
+    -------
+    Dict[str, str]
+        A dictionary mapping criterion names to descriptions.
+
+    Examples
+    --------
+    >>> criterion = "relevance"
+    >>> CriteriaEvalChain.resolve_criteria(criteria)
+    {'relevance': 'Is the submission referring to a real quote from the text?'}
+    """  # noqa: E501
+    if criteria is None:
+        return {
+            "helpfulness": _SUPPORTED_CRITERIA[Criteria.HELPFULNESS],
+        }
+    if isinstance(criteria, Criteria):
+        criteria_ = {criteria.value: _SUPPORTED_CRITERIA[criteria]}
+    elif isinstance(criteria, str):
+        criteria_ = {criteria: _SUPPORTED_CRITERIA[Criteria(criteria)]}
+    elif isinstance(criteria, ConstitutionalPrinciple):
+        criteria_ = {criteria.name: criteria.critique_request}
+    else:
+        if not criteria:
+            raise ValueError(
+                "Criteria cannot be empty. "
+                "Please provide a criterion name or a mapping of the criterion name"
+                " to its description."
+            )
+        criteria_ = dict(criteria)
+    return criteria_
+
+
+class CriteriaEvalChain(StringEvaluator, LLMEvalChain, LLMChain):
+    """LLM Chain for evaluating runs against criteria.
+
+    Parameters
+    ----------
+    llm : BaseLanguageModel
+        The language model to use for evaluation.
+    criteria : Union[Mapping[str, str]]
+        The criteria or rubric to evaluate the runs against. It can be a mapping of
+        criterion name to its description, or a single criterion name.
+    prompt : Optional[BasePromptTemplate], default=None
+        The prompt template to use for generating prompts. If not provided, a
+        default prompt template will be used based on the value of
+        `requires_reference`.
+    requires_reference : bool, default=False
+        Whether the evaluation requires a reference text. If `True`, the
+        `PROMPT_WITH_REFERENCES` template will be used, which includes the
+        reference labels in the prompt. Otherwise, the `PROMPT` template will be
+        used, which is a reference-free prompt.
+    **kwargs : Any
+        Additional keyword arguments to pass to the `LLMChain` constructor.
+
+    Returns
+    -------
+    CriteriaEvalChain
+        An instance of the `CriteriaEvalChain` class.
+
+    Examples
+    --------
+    >>> from langchain_community.chat_models import ChatAnthropic
+    >>> from langchain.evaluation.criteria import CriteriaEvalChain
+    >>> llm = ChatAnthropic(temperature=0)
+    >>> criteria = {"my-custom-criterion": "Is the submission the most amazing ever?"}
+    >>> evaluator = CriteriaEvalChain.from_llm(llm=llm, criteria=criteria)
+    >>> evaluator.evaluate_strings(prediction="Imagine an ice cream flavor for the color aquamarine", input="Tell me an idea")
+    {
+        'reasoning': 'Here is my step-by-step reasoning for the given criteria:\\n\\nThe criterion is: "Is the submission the most amazing ever?" This is a subjective criterion and open to interpretation. The submission suggests an aquamarine-colored ice cream flavor which is creative but may or may not be considered the most amazing idea ever conceived. There are many possible amazing ideas and this one ice cream flavor suggestion may or may not rise to that level for every person. \\n\\nN',
+        'value': 'N',
+        'score': 0,
+    }
+
+    >>> from langchain_community.chat_models import ChatOpenAI
+    >>> from langchain.evaluation.criteria import LabeledCriteriaEvalChain
+    >>> llm = ChatOpenAI(model="gpt-4", temperature=0)
+    >>> criteria = "correctness"
+    >>> evaluator = LabeledCriteriaEvalChain.from_llm(
+    ...     llm=llm,
+    ...     criteria=criteria,
+    ... )
+    >>> evaluator.evaluate_strings(
+    ...   prediction="The answer is 4",
+    ...   input="How many apples are there?",
+    ...   reference="There are 3 apples",
+    ...   )
+    {
+        'score': 0,
+        'reasoning': 'The criterion for this task is the correctness of the submission. The submission states that there are 4 apples, but the reference indicates that there are actually 3 apples. Therefore, the submission is not correct, accurate, or factual according to the given criterion.\\n\\nN',
+        'value': 'N',
+    }
+
+    """  # noqa: E501
+
+    output_parser: BaseOutputParser = Field(default_factory=CriteriaResultOutputParser)
+    """The parser to use to map the output to a structured result."""
+    criterion_name: str
+    """The name of the criterion being evaluated."""
+    output_key: str = "results"  #: :meta private:
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    class Config:
+        """Configuration for the QAEvalChain."""
+
+        extra = Extra.ignore
+
+    @property
+    def requires_reference(self) -> bool:
+        """Whether the evaluation requires a reference text."""
+        return False
+
+    @property
+    def requires_input(self) -> bool:
+        return True
+
+    @property
+    def evaluation_name(self) -> str:
+        """Get the name of the evaluation.
+
+        Returns
+        -------
+        str
+            The name of the evaluation.
+        """
+        return self.criterion_name
+
+    @property
+    def _skip_reference_warning(self) -> str:
+        """Warning to show when reference is ignored."""
+        return (
+            f"Ignoring reference in {self.__class__.__name__}, as it is not expected."
+            "\nTo use references, use the labeled_criteria instead."
+        )
+
+    @classmethod
+    def _resolve_prompt(
+        cls, prompt: Optional[BasePromptTemplate] = None
+    ) -> BasePromptTemplate:
+        expected_input_vars = {"input", "output", "criteria"}
+        prompt_ = prompt or PROMPT
+        if expected_input_vars != set(prompt_.input_variables):
+            raise ValueError(
+                f"Input variables should be {expected_input_vars}, "
+                f"but got {prompt_.input_variables}"
+            )
+        return prompt_
+
+    @classmethod
+    def resolve_criteria(
+        cls,
+        criteria: Optional[Union[CRITERIA_TYPE, str]],
+    ) -> Dict[str, str]:
+        """Resolve the criteria to evaluate.
+
+        Parameters
+        ----------
+        criteria : CRITERIA_TYPE
+            The criteria to evaluate the runs against. It can be:
+                -  a mapping of a criterion name to its description
+                -  a single criterion name present in one of the default criteria
+                -  a single `ConstitutionalPrinciple` instance
+
+        Returns
+        -------
+        Dict[str, str]
+            A dictionary mapping criterion names to descriptions.
+
+        Examples
+        --------
+        >>> criterion = "relevance"
+        >>> CriteriaEvalChain.resolve_criteria(criteria)
+        {'relevance': 'Is the submission referring to a real quote from the text?'}
+        """  # noqa: E501
+        return resolve_criteria(criteria)
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        criteria: Optional[CRITERIA_TYPE] = None,
+        *,
+        prompt: Optional[BasePromptTemplate] = None,
+        **kwargs: Any,
+    ) -> CriteriaEvalChain:
+        """Create a `CriteriaEvalChain` instance from an llm and criteria.
+
+        Parameters
+        ----------
+        llm : BaseLanguageModel
+            The language model to use for evaluation.
+        criteria : CRITERIA_TYPE - default=None for "helpfulness"
+            The criteria to evaluate the runs against. It can be:
+                -  a mapping of a criterion name to its description
+                -  a single criterion name present in one of the default criteria
+                -  a single `ConstitutionalPrinciple` instance
+        prompt : Optional[BasePromptTemplate], default=None
+            The prompt template to use for generating prompts. If not provided,
+            a default prompt template will be used.
+        **kwargs : Any
+            Additional keyword arguments to pass to the `LLMChain`
+            constructor.
+
+        Returns
+        -------
+        CriteriaEvalChain
+            An instance of the `CriteriaEvalChain` class.
+
+        Examples
+        --------
+        >>> from langchain_community.llms import OpenAI
+        >>> from langchain.evaluation.criteria import LabeledCriteriaEvalChain
+        >>> llm = OpenAI()
+        >>> criteria = {
+                "hallucination": (
+                    "Does this submission contain information"
+                    " not present in the input or reference?"
+                ),
+            }
+        >>> chain = LabeledCriteriaEvalChain.from_llm(
+                llm=llm,
+                criteria=criteria,
+            )
+        """
+        prompt_ = cls._resolve_prompt(prompt)
+        if criteria == Criteria.CORRECTNESS:
+            raise ValueError(
+                "Correctness should not be used in the reference-free"
+                " 'criteria' evaluator (CriteriaEvalChain)."
+                " Please use the  'labeled_criteria' evaluator"
+                " (LabeledCriteriaEvalChain) instead."
+            )
+        criteria_ = cls.resolve_criteria(criteria)
+        criteria_str = "\n".join(f"{k}: {v}" for k, v in criteria_.items())
+        prompt_ = prompt_.partial(criteria=criteria_str)
+        return cls(
+            llm=llm,
+            prompt=prompt_,
+            criterion_name="-".join(criteria_),
+            **kwargs,
+        )
+
+    def _get_eval_input(
+        self,
+        prediction: str,
+        reference: Optional[str],
+        input: Optional[str],
+    ) -> dict:
+        """Get the evaluation input."""
+        input_ = {
+            "input": input,
+            "output": prediction,
+        }
+        if self.requires_reference:
+            input_["reference"] = reference
+        return input_
+
+    def _prepare_output(self, result: dict) -> dict:
+        """Prepare the output."""
+        parsed = result[self.output_key]
+        if RUN_KEY in result:
+            parsed[RUN_KEY] = result[RUN_KEY]
+        return parsed
+
+    def _evaluate_strings(
+        self,
+        *,
+        prediction: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate a prediction against the criteria.
+
+        Parameters
+        ----------
+        prediction : str
+            The predicted text to evaluate.
+        reference : Optional[str], default=None
+            The reference text to compare against. This is required if
+            `requires_reference` is `True`.
+        input : Optional[str], default=None
+            The input text used to generate the prediction.
+        **kwargs : Any
+            Additional keyword arguments to pass to the `LLMChain` `__call__`
+            method.
+
+        Returns
+        -------
+        dict
+            The evaluation results.
+
+        Examples
+        --------
+        >>> from langchain_community.llms import OpenAI
+        >>> from langchain.evaluation.criteria import CriteriaEvalChain
+        >>> llm = OpenAI()
+        >>> criteria = "conciseness"
+        >>> chain = CriteriaEvalChain.from_llm(llm=llm, criteria=criteria)
+        >>> chain.evaluate_strings(
+                prediction="The answer is 42.",
+                reference="42",
+                input="What is the answer to life, the universe, and everything?",
+            )
+        """
+        input_ = self._get_eval_input(prediction, reference, input)
+        result = self(
+            input_,
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+    async def _aevaluate_strings(
+        self,
+        *,
+        prediction: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """Asynchronously evaluate a prediction against the criteria.
+
+        Parameters
+        ----------
+        prediction : str
+            The predicted text to evaluate.
+        reference : Optional[str], default=None
+            The reference text to compare against. This is required if
+            `requires_reference` is `True`.
+        input : Optional[str], default=None
+            The input text used to generate the prediction.
+        **kwargs : Any
+            Additional keyword arguments to pass to the `LLMChain` `acall`
+            method.
+
+        Returns
+        -------
+        dict
+            The evaluation results.
+
+        Examples
+        --------
+        >>> from langchain_community.llms import OpenAI
+        >>> from langchain.evaluation.criteria import CriteriaEvalChain
+        >>> llm = OpenAI()
+        >>> criteria = "conciseness"
+        >>> chain = CriteriaEvalChain.from_llm(llm=llm, criteria=criteria)
+        >>> await chain.aevaluate_strings(
+                prediction="The answer is 42.",
+                reference="42",
+                input="What is the answer to life, the universe, and everything?",
+            )
+        """
+        input_ = self._get_eval_input(prediction, reference, input)
+        result = await self.acall(
+            input_,
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+
+class LabeledCriteriaEvalChain(CriteriaEvalChain):
+    """Criteria evaluation chain that requires references."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @property
+    def requires_reference(self) -> bool:
+        """Whether the evaluation requires a reference text."""
+        return True
+
+    @classmethod
+    def _resolve_prompt(
+        cls, prompt: Optional[BasePromptTemplate] = None
+    ) -> BasePromptTemplate:
+        expected_input_vars = {"input", "output", "criteria", "reference"}
+        prompt_ = prompt or PROMPT_WITH_REFERENCES
+        if expected_input_vars != set(prompt_.input_variables):
+            raise ValueError(
+                f"Input variables should be {expected_input_vars}, "
+                f"but got {prompt_.input_variables}"
+            )
+        return prompt_
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        criteria: Optional[CRITERIA_TYPE] = None,
+        *,
+        prompt: Optional[BasePromptTemplate] = None,
+        **kwargs: Any,
+    ) -> CriteriaEvalChain:
+        """Create a `LabeledCriteriaEvalChain` instance from an llm and criteria.
+
+        Parameters
+        ----------
+        llm : BaseLanguageModel
+            The language model to use for evaluation.
+        criteria : CRITERIA_TYPE - default=None for "helpfulness"
+            The criteria to evaluate the runs against. It can be:
+                -  a mapping of a criterion name to its description
+                -  a single criterion name present in one of the default criteria
+                -  a single `ConstitutionalPrinciple` instance
+        prompt : Optional[BasePromptTemplate], default=None
+            The prompt template to use for generating prompts. If not provided,
+            a default prompt will be used.
+        **kwargs : Any
+            Additional keyword arguments to pass to the `LLMChain`
+            constructor.
+
+        Returns
+        -------
+        LabeledCriteriaEvalChain
+            An instance of the `LabeledCriteriaEvalChain` class.
+
+        Examples
+        --------
+        >>> from langchain_community.llms import OpenAI
+        >>> from langchain.evaluation.criteria import LabeledCriteriaEvalChain
+        >>> llm = OpenAI()
+        >>> criteria = {
+                "hallucination": (
+                    "Does this submission contain information"
+                    " not present in the input or reference?"
+                ),
+            }
+        >>> chain = LabeledCriteriaEvalChain.from_llm(
+                llm=llm,
+                criteria=criteria,
+            )
+        """
+        prompt = cls._resolve_prompt(prompt)
+        criteria_ = cls.resolve_criteria(criteria)
+        criteria_str = "\n".join(f"{k}: {v}" for k, v in criteria_.items())
+        prompt_ = prompt.partial(criteria=criteria_str)
+        return cls(
+            llm=llm,
+            prompt=prompt_,
+            criterion_name="-".join(criteria_),
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/evaluation/criteria/prompt.py b/llm/Lib/site-packages/langchain/evaluation/criteria/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..e5ac19fe03817fec1500ae0d145f2462de84322a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/criteria/prompt.py
@@ -0,0 +1,38 @@
+# flake8: noqa
+# Credit to https://github.com/openai/evals/tree/main
+
+from langchain_core.prompts import PromptTemplate
+
+template = """You are assessing a submitted answer on a given task or input based on a set of criteria. Here is the data:
+[BEGIN DATA]
+***
+[Input]: {input}
+***
+[Submission]: {output}
+***
+[Criteria]: {criteria}
+***
+[END DATA]
+Does the submission meet the Criteria? First, write out in a step by step manner your reasoning about each criterion to be sure that your conclusion is correct. Avoid simply stating the correct answers at the outset. Then print only the single character "Y" or "N" (without quotes or punctuation) on its own line corresponding to the correct answer of whether the submission meets all criteria. At the end, repeat just the letter again by itself on a new line."""
+
+PROMPT = PromptTemplate(
+    input_variables=["input", "output", "criteria"], template=template
+)
+
+template = """You are assessing a submitted answer on a given task or input based on a set of criteria. Here is the data:
+[BEGIN DATA]
+***
+[Input]: {input}
+***
+[Submission]: {output}
+***
+[Criteria]: {criteria}
+***
+[Reference]: {reference}
+***
+[END DATA]
+Does the submission meet the Criteria? First, write out in a step by step manner your reasoning about each criterion to be sure that your conclusion is correct. Avoid simply stating the correct answers at the outset. Then print only the single character "Y" or "N" (without quotes or punctuation) on its own line corresponding to the correct answer of whether the submission meets all criteria. At the end, repeat just the letter again by itself on a new line."""
+
+PROMPT_WITH_REFERENCES = PromptTemplate(
+    input_variables=["input", "output", "criteria", "reference"], template=template
+)
diff --git a/llm/Lib/site-packages/langchain/evaluation/embedding_distance/__init__.py b/llm/Lib/site-packages/langchain/evaluation/embedding_distance/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a7ebd68c4eff25a3762ee2e5476b339b953adeee
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/embedding_distance/__init__.py
@@ -0,0 +1,12 @@
+"""Evaluators that measure embedding distances."""
+from langchain.evaluation.embedding_distance.base import (
+    EmbeddingDistance,
+    EmbeddingDistanceEvalChain,
+    PairwiseEmbeddingDistanceEvalChain,
+)
+
+__all__ = [
+    "EmbeddingDistance",
+    "EmbeddingDistanceEvalChain",
+    "PairwiseEmbeddingDistanceEvalChain",
+]
diff --git a/llm/Lib/site-packages/langchain/evaluation/embedding_distance/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/embedding_distance/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5d537516d43fa637fc19c5b594893635fcd2f3ab
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/embedding_distance/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/embedding_distance/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/embedding_distance/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..934ef86dc3977709c9ccd50480370fd3a2bb9b1a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/embedding_distance/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/embedding_distance/base.py b/llm/Lib/site-packages/langchain/evaluation/embedding_distance/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..2010d1d5e27f1276085c3c82ad0340bd421d577a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/embedding_distance/base.py
@@ -0,0 +1,479 @@
+"""A chain for comparing the output of two models using embeddings."""
+from enum import Enum
+from typing import Any, Dict, List, Optional
+
+import numpy as np
+from langchain_community.embeddings.openai import OpenAIEmbeddings
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import Field, root_validator
+
+from langchain.callbacks.manager import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+    Callbacks,
+)
+from langchain.chains.base import Chain
+from langchain.evaluation.schema import PairwiseStringEvaluator, StringEvaluator
+from langchain.schema import RUN_KEY
+from langchain.utils.math import cosine_similarity
+
+
+class EmbeddingDistance(str, Enum):
+    """Embedding Distance Metric.
+
+    Attributes:
+        COSINE: Cosine distance metric.
+        EUCLIDEAN: Euclidean distance metric.
+        MANHATTAN: Manhattan distance metric.
+        CHEBYSHEV: Chebyshev distance metric.
+        HAMMING: Hamming distance metric.
+    """
+
+    COSINE = "cosine"
+    EUCLIDEAN = "euclidean"
+    MANHATTAN = "manhattan"
+    CHEBYSHEV = "chebyshev"
+    HAMMING = "hamming"
+
+
+class _EmbeddingDistanceChainMixin(Chain):
+    """Shared functionality for embedding distance evaluators.
+
+    Attributes:
+        embeddings (Embeddings): The embedding objects to vectorize the outputs.
+        distance_metric (EmbeddingDistance): The distance metric to use
+                                            for comparing the embeddings.
+    """
+
+    embeddings: Embeddings = Field(default_factory=OpenAIEmbeddings)
+    distance_metric: EmbeddingDistance = Field(default=EmbeddingDistance.COSINE)
+
+    @root_validator(pre=False)
+    def _validate_tiktoken_installed(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Validate that the TikTok library is installed.
+
+        Args:
+            values (Dict[str, Any]): The values to validate.
+
+        Returns:
+            Dict[str, Any]: The validated values.
+        """
+        embeddings = values.get("embeddings")
+        if isinstance(embeddings, OpenAIEmbeddings):
+            try:
+                import tiktoken  # noqa: F401
+            except ImportError:
+                raise ImportError(
+                    "The tiktoken library is required to use the default "
+                    "OpenAI embeddings with embedding distance evaluators."
+                    " Please either manually select a different Embeddings object"
+                    " or install tiktoken using `pip install tiktoken`."
+                )
+        return values
+
+    class Config:
+        """Permit embeddings to go unvalidated."""
+
+        arbitrary_types_allowed: bool = True
+
+    @property
+    def output_keys(self) -> List[str]:
+        """Return the output keys of the chain.
+
+        Returns:
+            List[str]: The output keys.
+        """
+        return ["score"]
+
+    def _prepare_output(self, result: dict) -> dict:
+        parsed = {"score": result["score"]}
+        if RUN_KEY in result:
+            parsed[RUN_KEY] = result[RUN_KEY]
+        return parsed
+
+    def _get_metric(self, metric: EmbeddingDistance) -> Any:
+        """Get the metric function for the given metric name.
+
+        Args:
+            metric (EmbeddingDistance): The metric name.
+
+        Returns:
+            Any: The metric function.
+        """
+        metrics = {
+            EmbeddingDistance.COSINE: self._cosine_distance,
+            EmbeddingDistance.EUCLIDEAN: self._euclidean_distance,
+            EmbeddingDistance.MANHATTAN: self._manhattan_distance,
+            EmbeddingDistance.CHEBYSHEV: self._chebyshev_distance,
+            EmbeddingDistance.HAMMING: self._hamming_distance,
+        }
+        if metric in metrics:
+            return metrics[metric]
+        else:
+            raise ValueError(f"Invalid metric: {metric}")
+
+    @staticmethod
+    def _cosine_distance(a: np.ndarray, b: np.ndarray) -> np.ndarray:
+        """Compute the cosine distance between two vectors.
+
+        Args:
+            a (np.ndarray): The first vector.
+            b (np.ndarray): The second vector.
+
+        Returns:
+            np.ndarray: The cosine distance.
+        """
+        return 1.0 - cosine_similarity(a, b)
+
+    @staticmethod
+    def _euclidean_distance(a: np.ndarray, b: np.ndarray) -> np.floating:
+        """Compute the Euclidean distance between two vectors.
+
+        Args:
+            a (np.ndarray): The first vector.
+            b (np.ndarray): The second vector.
+
+        Returns:
+            np.floating: The Euclidean distance.
+        """
+        return np.linalg.norm(a - b)
+
+    @staticmethod
+    def _manhattan_distance(a: np.ndarray, b: np.ndarray) -> np.floating:
+        """Compute the Manhattan distance between two vectors.
+
+        Args:
+            a (np.ndarray): The first vector.
+            b (np.ndarray): The second vector.
+
+        Returns:
+            np.floating: The Manhattan distance.
+        """
+        return np.sum(np.abs(a - b))
+
+    @staticmethod
+    def _chebyshev_distance(a: np.ndarray, b: np.ndarray) -> np.floating:
+        """Compute the Chebyshev distance between two vectors.
+
+        Args:
+            a (np.ndarray): The first vector.
+            b (np.ndarray): The second vector.
+
+        Returns:
+            np.floating: The Chebyshev distance.
+        """
+        return np.max(np.abs(a - b))
+
+    @staticmethod
+    def _hamming_distance(a: np.ndarray, b: np.ndarray) -> np.floating:
+        """Compute the Hamming distance between two vectors.
+
+        Args:
+            a (np.ndarray): The first vector.
+            b (np.ndarray): The second vector.
+
+        Returns:
+            np.floating: The Hamming distance.
+        """
+        return np.mean(a != b)
+
+    def _compute_score(self, vectors: np.ndarray) -> float:
+        """Compute the score based on the distance metric.
+
+        Args:
+            vectors (np.ndarray): The input vectors.
+
+        Returns:
+            float: The computed score.
+        """
+        metric = self._get_metric(self.distance_metric)
+        score = metric(vectors[0].reshape(1, -1), vectors[1].reshape(1, -1)).item()
+        return score
+
+
+class EmbeddingDistanceEvalChain(_EmbeddingDistanceChainMixin, StringEvaluator):
+    """Use embedding distances to score semantic difference between
+    a prediction and reference.
+
+    Examples:
+        >>> chain = EmbeddingDistanceEvalChain()
+        >>> result = chain.evaluate_strings(prediction="Hello", reference="Hi")
+        >>> print(result)
+        {'score': 0.5}
+    """
+
+    @property
+    def requires_reference(self) -> bool:
+        """Return whether the chain requires a reference.
+
+        Returns:
+            bool: True if a reference is required, False otherwise.
+        """
+        return True
+
+    @property
+    def evaluation_name(self) -> str:
+        return f"embedding_{self.distance_metric.value}_distance"
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the input keys of the chain.
+
+        Returns:
+            List[str]: The input keys.
+        """
+        return ["prediction", "reference"]
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Compute the score for a prediction and reference.
+
+        Args:
+            inputs (Dict[str, Any]): The input data.
+            run_manager (Optional[CallbackManagerForChainRun], optional):
+                The callback manager.
+
+        Returns:
+            Dict[str, Any]: The computed score.
+        """
+        vectors = np.array(
+            self.embeddings.embed_documents([inputs["prediction"], inputs["reference"]])
+        )
+        score = self._compute_score(vectors)
+        return {"score": score}
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Asynchronously compute the score for a prediction and reference.
+
+        Args:
+            inputs (Dict[str, Any]): The input data.
+            run_manager (AsyncCallbackManagerForChainRun, optional):
+                The callback manager.
+
+        Returns:
+            Dict[str, Any]: The computed score.
+        """
+        embedded = await self.embeddings.aembed_documents(
+            [inputs["prediction"], inputs["reference"]]
+        )
+        vectors = np.array(embedded)
+        score = self._compute_score(vectors)
+        return {"score": score}
+
+    def _evaluate_strings(
+        self,
+        *,
+        prediction: str,
+        reference: Optional[str] = None,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate the embedding distance between a prediction and
+        reference.
+
+        Args:
+            prediction (str): The output string from the first model.
+            reference (str): The reference string (required)
+            callbacks (Callbacks, optional): The callbacks to use.
+            **kwargs (Any): Additional keyword arguments.
+
+        Returns:
+            dict: A dictionary containing:
+                - score: The embedding distance between the two
+                    predictions.
+        """
+        result = self(
+            inputs={"prediction": prediction, "reference": reference},
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+    async def _aevaluate_strings(
+        self,
+        *,
+        prediction: str,
+        reference: Optional[str] = None,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """Asynchronously evaluate the embedding distance between
+        a prediction and reference.
+
+        Args:
+            prediction (str): The output string from the first model.
+            reference (str): The output string from the second model.
+            callbacks (Callbacks, optional): The callbacks to use.
+            **kwargs (Any): Additional keyword arguments.
+
+        Returns:
+            dict: A dictionary containing:
+                - score: The embedding distance between the two
+                    predictions.
+        """
+        result = await self.acall(
+            inputs={"prediction": prediction, "reference": reference},
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+
+class PairwiseEmbeddingDistanceEvalChain(
+    _EmbeddingDistanceChainMixin, PairwiseStringEvaluator
+):
+    """Use embedding distances to score semantic difference between two predictions.
+
+    Examples:
+    >>> chain = PairwiseEmbeddingDistanceEvalChain()
+    >>> result = chain.evaluate_string_pairs(prediction="Hello", prediction_b="Hi")
+    >>> print(result)
+    {'score': 0.5}
+    """
+
+    @property
+    def input_keys(self) -> List[str]:
+        """Return the input keys of the chain.
+
+        Returns:
+            List[str]: The input keys.
+        """
+        return ["prediction", "prediction_b"]
+
+    @property
+    def evaluation_name(self) -> str:
+        return f"pairwise_embedding_{self.distance_metric.value}_distance"
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Compute the score for two predictions.
+
+        Args:
+            inputs (Dict[str, Any]): The input data.
+            run_manager (CallbackManagerForChainRun, optional):
+                The callback manager.
+
+        Returns:
+            Dict[str, Any]: The computed score.
+        """
+        vectors = np.array(
+            self.embeddings.embed_documents(
+                [inputs["prediction"], inputs["prediction_b"]]
+            )
+        )
+        score = self._compute_score(vectors)
+        return {"score": score}
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Asynchronously compute the score for two predictions.
+
+        Args:
+            inputs (Dict[str, Any]): The input data.
+            run_manager (AsyncCallbackManagerForChainRun, optional):
+                The callback manager.
+
+        Returns:
+            Dict[str, Any]: The computed score.
+        """
+        embedded = await self.embeddings.aembed_documents(
+            [inputs["prediction"], inputs["prediction_b"]]
+        )
+        vectors = np.array(embedded)
+        score = self._compute_score(vectors)
+        return {"score": score}
+
+    def _evaluate_string_pairs(
+        self,
+        *,
+        prediction: str,
+        prediction_b: str,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate the embedding distance between two predictions.
+
+        Args:
+            prediction (str): The output string from the first model.
+            prediction_b (str): The output string from the second model.
+            callbacks (Callbacks, optional): The callbacks to use.
+            tags (List[str], optional): Tags to apply to traces
+            metadata (Dict[str, Any], optional): metadata to apply to
+            **kwargs (Any): Additional keyword arguments.
+
+        Returns:
+            dict: A dictionary containing:
+                - score: The embedding distance between the two
+                    predictions.
+        """
+        result = self(
+            inputs={"prediction": prediction, "prediction_b": prediction_b},
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+    async def _aevaluate_string_pairs(
+        self,
+        *,
+        prediction: str,
+        prediction_b: str,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """Asynchronously evaluate the embedding distance
+
+        between two predictions.
+
+        Args:
+            prediction (str): The output string from the first model.
+            prediction_b (str): The output string from the second model.
+            callbacks (Callbacks, optional): The callbacks to use.
+            tags (List[str], optional): Tags to apply to traces
+            metadata (Dict[str, Any], optional): metadata to apply to traces
+            **kwargs (Any): Additional keyword arguments.
+
+        Returns:
+            dict: A dictionary containing:
+                - score: The embedding distance between the two
+                    predictions.
+        """
+        result = await self.acall(
+            inputs={"prediction": prediction, "prediction_b": prediction_b},
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
diff --git a/llm/Lib/site-packages/langchain/evaluation/exact_match/__init__.py b/llm/Lib/site-packages/langchain/evaluation/exact_match/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/evaluation/exact_match/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/exact_match/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..25051b94c598908e5e93a57a5e833d2e3eedad3d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/exact_match/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/exact_match/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/exact_match/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a762816a3a1c7438254155f8e2cea427cfbfdb73
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/exact_match/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/exact_match/base.py b/llm/Lib/site-packages/langchain/evaluation/exact_match/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..d3fce84647fce8f4f4928aa130de1132c2a4925d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/exact_match/base.py
@@ -0,0 +1,97 @@
+import string
+from typing import Any, List
+
+from langchain.evaluation.schema import StringEvaluator
+
+
+class ExactMatchStringEvaluator(StringEvaluator):
+    """Compute an exact match between the prediction and the reference.
+
+    Examples
+    ----------
+    >>> evaluator = ExactMatchChain()
+    >>> evaluator.evaluate_strings(
+            prediction="Mindy is the CTO",
+            reference="Mindy is the CTO",
+        )  # This will return {'score': 1.0}
+
+    >>> evaluator.evaluate_strings(
+            prediction="Mindy is the CTO",
+            reference="Mindy is the CEO",
+        )  # This will return {'score': 0.0}
+    """
+
+    def __init__(
+        self,
+        *,
+        ignore_case: bool = False,
+        ignore_punctuation: bool = False,
+        ignore_numbers: bool = False,
+        **kwargs: Any,
+    ):
+        super().__init__()
+        self.ignore_case = ignore_case
+        self.ignore_punctuation = ignore_punctuation
+        self.ignore_numbers = ignore_numbers
+
+    @property
+    def requires_input(self) -> bool:
+        """
+        This evaluator does not require input.
+        """
+        return False
+
+    @property
+    def requires_reference(self) -> bool:
+        """
+        This evaluator requires a reference.
+        """
+        return True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """
+        Get the input keys.
+
+        Returns:
+            List[str]: The input keys.
+        """
+        return ["reference", "prediction"]
+
+    @property
+    def evaluation_name(self) -> str:
+        """
+        Get the evaluation name.
+
+        Returns:
+            str: The evaluation name.
+        """
+        return "exact_match"
+
+    def _evaluate_strings(  # type: ignore[arg-type,override]
+        self,
+        *,
+        prediction: str,
+        reference: str,
+        **kwargs: Any,
+    ) -> dict:
+        """
+        Evaluate the exact match between the prediction and the reference.
+
+        Args:
+            prediction (str): The prediction string.
+            reference (Optional[str], optional): The reference string.
+
+        Returns:
+            dict: The evaluation results containing the score.
+        """
+        if self.ignore_case:
+            prediction = prediction.lower()
+            reference = reference.lower()
+        if self.ignore_punctuation:
+            prediction = prediction.translate(str.maketrans("", "", string.punctuation))
+            reference = reference.translate(str.maketrans("", "", string.punctuation))
+        if self.ignore_numbers:
+            prediction = prediction.translate(str.maketrans("", "", string.digits))
+            reference = reference.translate(str.maketrans("", "", string.digits))
+        return {"score": int(prediction == reference)}
diff --git a/llm/Lib/site-packages/langchain/evaluation/loading.py b/llm/Lib/site-packages/langchain/evaluation/loading.py
new file mode 100644
index 0000000000000000000000000000000000000000..fbb1732585493d79a191d2c636cecc0a2a1d0147
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/loading.py
@@ -0,0 +1,187 @@
+"""Loading datasets and evaluators."""
+from typing import Any, Dict, List, Optional, Sequence, Type, Union
+
+from langchain_community.chat_models.openai import ChatOpenAI
+from langchain_core.language_models import BaseLanguageModel
+
+from langchain.chains.base import Chain
+from langchain.evaluation.agents.trajectory_eval_chain import TrajectoryEvalChain
+from langchain.evaluation.comparison import PairwiseStringEvalChain
+from langchain.evaluation.comparison.eval_chain import LabeledPairwiseStringEvalChain
+from langchain.evaluation.criteria.eval_chain import (
+    CriteriaEvalChain,
+    LabeledCriteriaEvalChain,
+)
+from langchain.evaluation.embedding_distance.base import (
+    EmbeddingDistanceEvalChain,
+    PairwiseEmbeddingDistanceEvalChain,
+)
+from langchain.evaluation.exact_match.base import ExactMatchStringEvaluator
+from langchain.evaluation.parsing.base import (
+    JsonEqualityEvaluator,
+    JsonValidityEvaluator,
+)
+from langchain.evaluation.parsing.json_distance import JsonEditDistanceEvaluator
+from langchain.evaluation.parsing.json_schema import JsonSchemaEvaluator
+from langchain.evaluation.qa import ContextQAEvalChain, CotQAEvalChain, QAEvalChain
+from langchain.evaluation.regex_match.base import RegexMatchStringEvaluator
+from langchain.evaluation.schema import EvaluatorType, LLMEvalChain, StringEvaluator
+from langchain.evaluation.scoring.eval_chain import (
+    LabeledScoreStringEvalChain,
+    ScoreStringEvalChain,
+)
+from langchain.evaluation.string_distance.base import (
+    PairwiseStringDistanceEvalChain,
+    StringDistanceEvalChain,
+)
+
+
+def load_dataset(uri: str) -> List[Dict]:
+    """Load a dataset from the `LangChainDatasets on HuggingFace <https://huggingface.co/LangChainDatasets>`_.
+
+    Args:
+        uri: The uri of the dataset to load.
+
+    Returns:
+        A list of dictionaries, each representing a row in the dataset.
+
+    **Prerequisites**
+
+    .. code-block:: shell
+
+        pip install datasets
+
+    Examples
+    --------
+    .. code-block:: python
+
+        from langchain.evaluation import load_dataset
+        ds = load_dataset("llm-math")
+    """  # noqa: E501
+    try:
+        from datasets import load_dataset
+    except ImportError:
+        raise ImportError(
+            "load_dataset requires the `datasets` package."
+            " Please install with `pip install datasets`"
+        )
+
+    dataset = load_dataset(f"LangChainDatasets/{uri}")
+    return [d for d in dataset["train"]]
+
+
+_EVALUATOR_MAP: Dict[
+    EvaluatorType, Union[Type[LLMEvalChain], Type[Chain], Type[StringEvaluator]]
+] = {
+    EvaluatorType.QA: QAEvalChain,
+    EvaluatorType.COT_QA: CotQAEvalChain,
+    EvaluatorType.CONTEXT_QA: ContextQAEvalChain,
+    EvaluatorType.PAIRWISE_STRING: PairwiseStringEvalChain,
+    EvaluatorType.SCORE_STRING: ScoreStringEvalChain,
+    EvaluatorType.LABELED_PAIRWISE_STRING: LabeledPairwiseStringEvalChain,
+    EvaluatorType.LABELED_SCORE_STRING: LabeledScoreStringEvalChain,
+    EvaluatorType.AGENT_TRAJECTORY: TrajectoryEvalChain,
+    EvaluatorType.CRITERIA: CriteriaEvalChain,
+    EvaluatorType.LABELED_CRITERIA: LabeledCriteriaEvalChain,
+    EvaluatorType.STRING_DISTANCE: StringDistanceEvalChain,
+    EvaluatorType.PAIRWISE_STRING_DISTANCE: PairwiseStringDistanceEvalChain,
+    EvaluatorType.EMBEDDING_DISTANCE: EmbeddingDistanceEvalChain,
+    EvaluatorType.PAIRWISE_EMBEDDING_DISTANCE: PairwiseEmbeddingDistanceEvalChain,
+    EvaluatorType.JSON_VALIDITY: JsonValidityEvaluator,
+    EvaluatorType.JSON_EQUALITY: JsonEqualityEvaluator,
+    EvaluatorType.JSON_EDIT_DISTANCE: JsonEditDistanceEvaluator,
+    EvaluatorType.JSON_SCHEMA_VALIDATION: JsonSchemaEvaluator,
+    EvaluatorType.REGEX_MATCH: RegexMatchStringEvaluator,
+    EvaluatorType.EXACT_MATCH: ExactMatchStringEvaluator,
+}
+
+
+def load_evaluator(
+    evaluator: EvaluatorType,
+    *,
+    llm: Optional[BaseLanguageModel] = None,
+    **kwargs: Any,
+) -> Union[Chain, StringEvaluator]:
+    """Load the requested evaluation chain specified by a string.
+
+    Parameters
+    ----------
+    evaluator : EvaluatorType
+        The type of evaluator to load.
+    llm : BaseLanguageModel, optional
+        The language model to use for evaluation, by default None
+    **kwargs : Any
+        Additional keyword arguments to pass to the evaluator.
+
+    Returns
+    -------
+    Chain
+        The loaded evaluation chain.
+
+    Examples
+    --------
+    >>> from langchain.evaluation import load_evaluator, EvaluatorType
+    >>> evaluator = load_evaluator(EvaluatorType.QA)
+    """
+    if evaluator not in _EVALUATOR_MAP:
+        raise ValueError(
+            f"Unknown evaluator type: {evaluator}"
+            f"\nValid types are: {list(_EVALUATOR_MAP.keys())}"
+        )
+    evaluator_cls = _EVALUATOR_MAP[evaluator]
+    if issubclass(evaluator_cls, LLMEvalChain):
+        try:
+            llm = llm or ChatOpenAI(  # type: ignore[call-arg]
+                model="gpt-4", model_kwargs={"seed": 42}, temperature=0
+            )
+        except Exception as e:
+            raise ValueError(
+                f"Evaluation with the {evaluator_cls} requires a "
+                "language model to function."
+                " Failed to create the default 'gpt-4' model."
+                " Please manually provide an evaluation LLM"
+                " or check your openai credentials."
+            ) from e
+        return evaluator_cls.from_llm(llm=llm, **kwargs)
+    else:
+        return evaluator_cls(**kwargs)
+
+
+def load_evaluators(
+    evaluators: Sequence[EvaluatorType],
+    *,
+    llm: Optional[BaseLanguageModel] = None,
+    config: Optional[dict] = None,
+    **kwargs: Any,
+) -> List[Union[Chain, StringEvaluator]]:
+    """Load evaluators specified by a list of evaluator types.
+
+    Parameters
+    ----------
+    evaluators : Sequence[EvaluatorType]
+        The list of evaluator types to load.
+    llm : BaseLanguageModel, optional
+        The language model to use for evaluation, if none is provided, a default
+        ChatOpenAI gpt-4 model will be used.
+    config : dict, optional
+        A dictionary mapping evaluator types to additional keyword arguments,
+        by default None
+    **kwargs : Any
+        Additional keyword arguments to pass to all evaluators.
+
+    Returns
+    -------
+    List[Chain]
+        The loaded evaluators.
+
+    Examples
+    --------
+    >>> from langchain.evaluation import load_evaluators, EvaluatorType
+    >>> evaluators = [EvaluatorType.QA, EvaluatorType.CRITERIA]
+    >>> loaded_evaluators = load_evaluators(evaluators, criteria="helpfulness")
+    """
+    loaded = []
+    for evaluator in evaluators:
+        _kwargs = config.get(evaluator, {}) if config else {}
+        loaded.append(load_evaluator(evaluator, llm=llm, **{**kwargs, **_kwargs}))
+    return loaded
diff --git a/llm/Lib/site-packages/langchain/evaluation/parsing/__init__.py b/llm/Lib/site-packages/langchain/evaluation/parsing/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/evaluation/parsing/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/parsing/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9cdbb7c1e79872d1ba23c599caa3190f8356e9f4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/parsing/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/parsing/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/parsing/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8bb25b032f38c00fcba7e299c368b55380027fc8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/parsing/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/parsing/__pycache__/json_distance.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/parsing/__pycache__/json_distance.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..416680fa8b4bfa1ec56afa776dd4a3886663bd89
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/parsing/__pycache__/json_distance.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/parsing/__pycache__/json_schema.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/parsing/__pycache__/json_schema.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..40883d3a621095ccd6eb869dd189123ab86d905e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/parsing/__pycache__/json_schema.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/parsing/base.py b/llm/Lib/site-packages/langchain/evaluation/parsing/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a5a49ef45dbadefa791f79b044ac370e0d0f68e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/parsing/base.py
@@ -0,0 +1,157 @@
+"""Evaluators for parsing strings."""
+import json
+from operator import eq
+from typing import Any, Callable, Optional, Union, cast
+
+from langchain.evaluation.schema import StringEvaluator
+from langchain.output_parsers.json import parse_json_markdown
+
+
+class JsonValidityEvaluator(StringEvaluator):
+    """Evaluates whether the prediction is valid JSON.
+
+    This evaluator checks if the prediction is a valid JSON string. It does not
+        require any input or reference.
+
+    Attributes:
+        requires_input (bool): Whether this evaluator requires an input
+            string. Always False.
+        requires_reference (bool): Whether this evaluator requires a
+            reference string. Always False.
+        evaluation_name (str): The name of the evaluation metric.
+            Always "json".
+
+    Examples:
+        >>> evaluator = JsonValidityEvaluator()
+        >>> prediction = '{"name": "John", "age": 30, "city": "New York"}'
+        >>> evaluator.evaluate(prediction)
+        {'score': 1}
+
+        >>> prediction = '{"name": "John", "age": 30, "city": "New York",}'
+        >>> evaluator.evaluate(prediction)
+        {'score': 0, 'reasoning': 'Expecting property name enclosed in double quotes'}
+    """
+
+    def __init__(self, **kwargs: Any) -> None:
+        super().__init__()
+
+    @property
+    def requires_input(self) -> bool:
+        return False
+
+    @property
+    def requires_reference(self) -> bool:
+        return False
+
+    @property
+    def evaluation_name(self) -> str:
+        return "json_validity"
+
+    def _evaluate_strings(
+        self,
+        prediction: str,
+        input: Optional[str] = None,
+        reference: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate the prediction string.
+
+        Args:
+            prediction (str): The prediction string to evaluate.
+            input (str, optional): Not used in this evaluator. Defaults to None.
+            reference (str, optional): Not used in this evaluator. Defaults to None.
+
+        Returns:
+            dict: A dictionary containing the evaluation score. The score is 1 if
+            the prediction is valid JSON, and 0 otherwise.
+                If the prediction is not valid JSON, the dictionary also contains
+                a "reasoning" field with the error message.
+
+        """
+        try:
+            parse_json_markdown(prediction, parser=json.loads)
+            return {"score": 1}
+        except Exception as e:
+            return {"score": 0, "reasoning": str(e)}
+
+
+class JsonEqualityEvaluator(StringEvaluator):
+    """Evaluates whether the prediction is equal to the reference after
+        parsing both as JSON.
+
+    This evaluator checks if the prediction, after parsing as JSON, is equal
+        to the reference,
+    which is also parsed as JSON. It does not require an input string.
+
+    Attributes:
+        requires_input (bool): Whether this evaluator requires an
+            input string. Always False.
+        requires_reference (bool): Whether this evaluator requires
+            a reference string. Always True.
+        evaluation_name (str): The name of the evaluation metric.
+            Always "parsed_equality".
+
+    Examples:
+        >>> evaluator = JsonEqualityEvaluator()
+        >>> evaluator.evaluate_strings('{"a": 1}', reference='{"a": 1}')
+        {'score': True}
+        >>> evaluator.evaluate_strings('{"a": 1}', reference='{"a": 2}')
+        {'score': False}
+
+        >>> evaluator = JsonEqualityEvaluator(operator=lambda x, y: x['a'] == y['a'])
+        >>> evaluator.evaluate_strings('{"a": 1}', reference='{"a": 1}')
+        {'score': True}
+        >>> evaluator.evaluate_strings('{"a": 1}', reference='{"a": 2}')
+        {'score': False}
+
+    """
+
+    def __init__(self, operator: Optional[Callable] = None, **kwargs: Any) -> None:
+        super().__init__()
+        self.operator = operator or eq
+
+    @property
+    def requires_input(self) -> bool:
+        return False
+
+    @property
+    def requires_reference(self) -> bool:
+        return True
+
+    @property
+    def evaluation_name(self) -> str:
+        return "json_equality"
+
+    def _parse_json(
+        self,
+        string: Any,
+    ) -> Union[dict, list, None, float, bool, int, str]:
+        if isinstance(string, str):
+            return parse_json_markdown(string)
+        return string
+
+    def _evaluate_strings(
+        self,
+        prediction: str,
+        input: Optional[str] = None,
+        reference: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate the prediction string.
+
+        Args:
+            prediction (str): The prediction string to evaluate.
+            input (str, optional): Not used in this evaluator.
+            reference (str): The reference string to compare against.
+
+        Returns:
+            dict: A dictionary containing the evaluation score.
+        """
+        parsed = self._parse_json(prediction)
+        label = self._parse_json(cast(str, reference))
+        if isinstance(label, list):
+            if not isinstance(parsed, list):
+                return {"score": 0}
+            parsed = sorted(parsed, key=lambda x: str(x))
+            label = sorted(label, key=lambda x: str(x))
+        return {"score": self.operator(parsed, label)}
diff --git a/llm/Lib/site-packages/langchain/evaluation/parsing/json_distance.py b/llm/Lib/site-packages/langchain/evaluation/parsing/json_distance.py
new file mode 100644
index 0000000000000000000000000000000000000000..904ad5321fbc51057db686349aca3a825e84d2af
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/parsing/json_distance.py
@@ -0,0 +1,93 @@
+import json
+from typing import Any, Callable, Optional, Union
+
+from langchain.evaluation.schema import StringEvaluator
+from langchain.output_parsers.json import parse_json_markdown
+
+
+class JsonEditDistanceEvaluator(StringEvaluator):
+    """
+    An evaluator that calculates the edit distance between JSON strings.
+
+    This evaluator computes a normalized Damerau-Levenshtein distance between two JSON strings
+    after parsing them and converting them to a canonical format (i.e., whitespace and key order are normalized).
+    It can be customized with alternative distance and canonicalization functions.
+
+    Args:
+        string_distance (Optional[Callable[[str, str], float]]): A callable that computes the distance between two strings.
+            If not provided, a Damerau-Levenshtein distance from the `rapidfuzz` package will be used.
+        canonicalize (Optional[Callable[[Any], Any]]): A callable that converts a parsed JSON object into its canonical string form.
+            If not provided, the default behavior is to serialize the JSON with sorted keys and no extra whitespace.
+        **kwargs (Any): Additional keyword arguments.
+
+    Attributes:
+        _string_distance (Callable[[str, str], float]): The internal distance computation function.
+        _canonicalize (Callable[[Any], Any]): The internal canonicalization function.
+
+    Examples:
+        >>> evaluator = JsonEditDistanceEvaluator()
+        >>> result = evaluator.evaluate_strings(prediction='{"a": 1, "b": 2}', reference='{"a": 1, "b": 3}')
+        >>> assert result["score"] is not None
+
+    Raises:
+        ImportError: If `rapidfuzz` is not installed and no alternative `string_distance` function is provided.
+
+    """  # noqa: E501
+
+    def __init__(
+        self,
+        string_distance: Optional[Callable[[str, str], float]] = None,
+        canonicalize: Optional[Callable[[Any], Any]] = None,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__()
+        if string_distance is not None:
+            self._string_distance = string_distance
+        else:
+            try:
+                from rapidfuzz import distance as rfd  # noqa: F401
+            except ImportError:
+                raise ImportError(
+                    "The default string_distance operator for the "
+                    " JsonEditDistanceEvaluator requires installation of "
+                    "the rapidfuzz package. "
+                    "Please install it with `pip install rapidfuzz`."
+                )
+            self._string_distance = rfd.DamerauLevenshtein.normalized_distance
+        if canonicalize is not None:
+            self._canonicalize = canonicalize
+        else:
+            self._canonicalize = lambda x: json.dumps(
+                x,
+                separators=(",", ":"),
+                sort_keys=True,  # eliminate whitespace
+            )
+
+    @property
+    def requires_input(self) -> bool:
+        return False
+
+    @property
+    def requires_reference(self) -> bool:
+        return True
+
+    @property
+    def evaluation_name(self) -> str:
+        return "json_edit_distance"
+
+    def _parse_json(self, node: Any) -> Union[dict, list, None, float, bool, int, str]:
+        if isinstance(node, str):
+            return parse_json_markdown(node)
+        return node
+
+    def _evaluate_strings(
+        self,
+        prediction: str,
+        input: Optional[str] = None,
+        reference: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict:
+        parsed = self._canonicalize(self._parse_json(prediction))
+        label = self._canonicalize(self._parse_json(reference))
+        distance = self._string_distance(parsed, label)
+        return {"score": distance}
diff --git a/llm/Lib/site-packages/langchain/evaluation/parsing/json_schema.py b/llm/Lib/site-packages/langchain/evaluation/parsing/json_schema.py
new file mode 100644
index 0000000000000000000000000000000000000000..6f0473d99845f3eed58b898cc424a12483d4904e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/parsing/json_schema.py
@@ -0,0 +1,95 @@
+from typing import Any, Union
+
+from langchain.evaluation.schema import StringEvaluator
+from langchain.output_parsers.json import parse_json_markdown
+
+
+class JsonSchemaEvaluator(StringEvaluator):
+    """An evaluator that validates a JSON prediction against a JSON schema reference.
+
+    This evaluator checks if a given JSON prediction conforms to the provided JSON schema.
+    If the prediction is valid, the score is True (no errors). Otherwise, the score is False (error occurred).
+
+    Attributes:
+        requires_input (bool): Whether the evaluator requires input.
+        requires_reference (bool): Whether the evaluator requires reference.
+        evaluation_name (str): The name of the evaluation.
+
+    Examples:
+        evaluator = JsonSchemaEvaluator()
+        result = evaluator.evaluate_strings(
+            prediction='{"name": "John", "age": 30}',
+            reference={
+                "type": "object",
+                "properties": {
+                    "name": {"type": "string"},
+                    "age": {"type": "integer"}
+                }
+            }
+        )
+        assert result["score"] is not None
+
+    """  # noqa: E501
+
+    def __init__(self, **kwargs: Any) -> None:
+        """Initializes the JsonSchemaEvaluator.
+
+        Args:
+            **kwargs: Additional keyword arguments.
+
+        Raises:
+            ImportError: If the jsonschema package is not installed.
+        """
+        super().__init__()
+        try:
+            import jsonschema  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "The JsonSchemaEvaluator requires the jsonschema package."
+                " Please install it with `pip install jsonschema`."
+            )
+
+    @property
+    def requires_input(self) -> bool:
+        """Returns whether the evaluator requires input."""
+        return False
+
+    @property
+    def requires_reference(self) -> bool:
+        """Returns whether the evaluator requires reference."""
+        return True
+
+    @property
+    def evaluation_name(self) -> str:
+        """Returns the name of the evaluation."""
+        return "json_schema_validation"
+
+    def _parse_json(self, node: Any) -> Union[dict, list, None, float, bool, int, str]:
+        if isinstance(node, str):
+            return parse_json_markdown(node)
+        elif hasattr(node, "schema") and callable(getattr(node, "schema")):
+            # Pydantic model
+            return getattr(node, "schema")()
+        return node
+
+    def _validate(self, prediction: Any, schema: Any) -> dict:
+        from jsonschema import ValidationError, validate  # noqa: F401
+
+        try:
+            validate(instance=prediction, schema=schema)
+            return {
+                "score": True,
+            }
+        except ValidationError as e:
+            return {"score": False, "reasoning": repr(e)}
+
+    def _evaluate_strings(
+        self,
+        prediction: Union[str, Any],
+        input: Union[str, Any] = None,
+        reference: Union[str, Any] = None,
+        **kwargs: Any,
+    ) -> dict:
+        parsed_prediction = self._parse_json(prediction)
+        schema = self._parse_json(reference)
+        return self._validate(parsed_prediction, schema)
diff --git a/llm/Lib/site-packages/langchain/evaluation/qa/__init__.py b/llm/Lib/site-packages/langchain/evaluation/qa/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e2d639f928b9d2a59f9a9fed810eab698a1bf82e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/qa/__init__.py
@@ -0,0 +1,9 @@
+"""Chains and utils related to evaluating question answering functionality."""
+from langchain.evaluation.qa.eval_chain import (
+    ContextQAEvalChain,
+    CotQAEvalChain,
+    QAEvalChain,
+)
+from langchain.evaluation.qa.generate_chain import QAGenerateChain
+
+__all__ = ["QAEvalChain", "QAGenerateChain", "ContextQAEvalChain", "CotQAEvalChain"]
diff --git a/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9ba2832f170da509d9734d0c2fd3cb3fdd8d98e3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/eval_chain.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/eval_chain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a35c6f0c0a819bcc5024bf43cdbb88a900fa0ed8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/eval_chain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/eval_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/eval_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e4b5b2d08f0327fc268998e3340da36fc14f6108
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/eval_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/generate_chain.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/generate_chain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4165b6b663ef6213d06e7cef49ed60de9359eab9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/generate_chain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/generate_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/generate_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ccdcfa7cad5fb7494b13bd378104cd771aa407ea
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/qa/__pycache__/generate_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/qa/eval_chain.py b/llm/Lib/site-packages/langchain/evaluation/qa/eval_chain.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a465d025547fdcec26df03d5c28648e9450d0de
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/qa/eval_chain.py
@@ -0,0 +1,357 @@
+"""LLM Chains for evaluating question answering."""
+from __future__ import annotations
+
+import re
+import string
+from typing import Any, List, Optional, Sequence, Tuple
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import PromptTemplate
+from langchain_core.pydantic_v1 import Extra
+
+from langchain.callbacks.manager import Callbacks
+from langchain.chains.llm import LLMChain
+from langchain.evaluation.qa.eval_prompt import CONTEXT_PROMPT, COT_PROMPT, PROMPT
+from langchain.evaluation.schema import LLMEvalChain, StringEvaluator
+from langchain.schema import RUN_KEY
+
+
+def _get_score(text: str) -> Optional[Tuple[str, int]]:
+    match = re.search(r"grade:\s*(correct|incorrect)", text.strip(), re.IGNORECASE)
+    if match:
+        if match.group(1).upper() == "CORRECT":
+            return "CORRECT", 1
+        elif match.group(1).upper() == "INCORRECT":
+            return "INCORRECT", 0
+    try:
+        first_word = (
+            text.strip().split()[0].translate(str.maketrans("", "", string.punctuation))
+        )
+        if first_word.upper() == "CORRECT":
+            return "CORRECT", 1
+        elif first_word.upper() == "INCORRECT":
+            return "INCORRECT", 0
+        last_word = (
+            text.strip()
+            .split()[-1]
+            .translate(str.maketrans("", "", string.punctuation))
+        )
+        if last_word.upper() == "CORRECT":
+            return "CORRECT", 1
+        elif last_word.upper() == "INCORRECT":
+            return "INCORRECT", 0
+    except IndexError:
+        pass
+    return None
+
+
+def _parse_string_eval_output(text: str) -> dict:
+    """Parse the output text.
+
+    Args:
+        text (str): The output text to parse.
+
+    Returns:
+        Any: The parsed output.
+    """
+    reasoning = text.strip()
+    parsed_scores = _get_score(reasoning)
+    if parsed_scores is None:
+        value, score = None, None
+    else:
+        value, score = parsed_scores
+    return {
+        "reasoning": reasoning,
+        "value": value,
+        "score": score,
+    }
+
+
+class QAEvalChain(LLMChain, StringEvaluator, LLMEvalChain):
+    """LLM Chain for evaluating question answering."""
+
+    output_key: str = "results"  #: :meta private:
+
+    class Config:
+        """Configuration for the QAEvalChain."""
+
+        extra = Extra.ignore
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @property
+    def evaluation_name(self) -> str:
+        return "correctness"
+
+    @property
+    def requires_reference(self) -> bool:
+        return True
+
+    @property
+    def requires_input(self) -> bool:
+        return True
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        prompt: Optional[PromptTemplate] = None,
+        **kwargs: Any,
+    ) -> QAEvalChain:
+        """Load QA Eval Chain from LLM.
+
+        Args:
+            llm (BaseLanguageModel): the base language model to use.
+
+            prompt (PromptTemplate): A prompt template containing the input_variables:
+            'input', 'answer' and 'result' that will be used as the prompt
+            for evaluation.
+            Defaults to PROMPT.
+
+            **kwargs: additional keyword arguments.
+
+        Returns:
+            QAEvalChain: the loaded QA eval chain.
+        """
+        prompt = prompt or PROMPT
+        expected_input_vars = {"query", "answer", "result"}
+        if expected_input_vars != set(prompt.input_variables):
+            raise ValueError(
+                f"Input variables should be {expected_input_vars}, "
+                f"but got {prompt.input_variables}"
+            )
+        return cls(llm=llm, prompt=prompt, **kwargs)
+
+    def evaluate(
+        self,
+        examples: Sequence[dict],
+        predictions: Sequence[dict],
+        question_key: str = "query",
+        answer_key: str = "answer",
+        prediction_key: str = "result",
+        *,
+        callbacks: Callbacks = None,
+    ) -> List[dict]:
+        """Evaluate question answering examples and predictions."""
+        inputs = [
+            {
+                "query": example[question_key],
+                "answer": example[answer_key],
+                "result": predictions[i][prediction_key],
+            }
+            for i, example in enumerate(examples)
+        ]
+
+        return self.apply(inputs, callbacks=callbacks)
+
+    def _prepare_output(self, result: dict) -> dict:
+        parsed_result = _parse_string_eval_output(result[self.output_key])
+        if RUN_KEY in result:
+            parsed_result[RUN_KEY] = result[RUN_KEY]
+        return parsed_result
+
+    def _evaluate_strings(
+        self,
+        *,
+        prediction: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        callbacks: Callbacks = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate Chain or LLM output, based on optional input and label.
+
+        Args:
+            prediction (str): the LLM or chain prediction to evaluate.
+            reference (Optional[str], optional): the reference label
+                to evaluate against.
+            input (Optional[str], optional): the input to consider during evaluation
+            callbacks (Callbacks, optional): the callbacks to use for tracing.
+            include_run_info (bool, optional): whether to include run info in the
+                returned results.
+            **kwargs: additional keyword arguments, including callbacks, tags, etc.
+        Returns:
+            dict: The evaluation results containing the score or value.
+        """
+        result = self(
+            {
+                "query": input,
+                "answer": reference,
+                "result": prediction,
+            },
+            callbacks=callbacks,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+    async def _aevaluate_strings(
+        self,
+        *,
+        prediction: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        callbacks: Callbacks = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        result = await self.acall(
+            inputs={"query": input, "answer": reference, "result": prediction},
+            callbacks=callbacks,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+
+class ContextQAEvalChain(LLMChain, StringEvaluator, LLMEvalChain):
+    """LLM Chain for evaluating QA w/o GT based on context"""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @property
+    def requires_reference(self) -> bool:
+        """Whether the chain requires a reference string."""
+        return True
+
+    @property
+    def requires_input(self) -> bool:
+        """Whether the chain requires an input string."""
+        return True
+
+    class Config:
+        """Configuration for the QAEvalChain."""
+
+        extra = Extra.ignore
+
+    @classmethod
+    def _validate_input_vars(cls, prompt: PromptTemplate) -> None:
+        expected_input_vars = {"query", "context", "result"}
+        if expected_input_vars != set(prompt.input_variables):
+            raise ValueError(
+                f"Input variables should be {expected_input_vars}, "
+                f"but got {prompt.input_variables}"
+            )
+
+    @property
+    def evaluation_name(self) -> str:
+        return "Contextual Accuracy"
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        prompt: Optional[PromptTemplate] = None,
+        **kwargs: Any,
+    ) -> ContextQAEvalChain:
+        """Load QA Eval Chain from LLM.
+
+        Args:
+            llm (BaseLanguageModel): the base language model to use.
+
+            prompt (PromptTemplate): A prompt template containing the input_variables:
+            'query', 'context' and 'result' that will be used as the prompt
+            for evaluation.
+            Defaults to PROMPT.
+
+            **kwargs: additional keyword arguments.
+
+        Returns:
+            ContextQAEvalChain: the loaded QA eval chain.
+        """
+        prompt = prompt or CONTEXT_PROMPT
+        cls._validate_input_vars(prompt)
+        return cls(llm=llm, prompt=prompt, **kwargs)
+
+    def evaluate(
+        self,
+        examples: List[dict],
+        predictions: List[dict],
+        question_key: str = "query",
+        context_key: str = "context",
+        prediction_key: str = "result",
+        *,
+        callbacks: Callbacks = None,
+    ) -> List[dict]:
+        """Evaluate question answering examples and predictions."""
+        inputs = [
+            {
+                "query": example[question_key],
+                "context": example[context_key],
+                "result": predictions[i][prediction_key],
+            }
+            for i, example in enumerate(examples)
+        ]
+
+        return self.apply(inputs, callbacks=callbacks)
+
+    def _prepare_output(self, result: dict) -> dict:
+        parsed_result = _parse_string_eval_output(result[self.output_key])
+        if RUN_KEY in result:
+            parsed_result[RUN_KEY] = result[RUN_KEY]
+        return parsed_result
+
+    def _evaluate_strings(
+        self,
+        *,
+        prediction: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        callbacks: Callbacks = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        result = self(
+            {
+                "query": input,
+                "context": reference,
+                "result": prediction,
+            },
+            callbacks=callbacks,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+    async def _aevaluate_strings(
+        self,
+        *,
+        prediction: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        callbacks: Callbacks = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        result = await self.acall(
+            inputs={"query": input, "context": reference, "result": prediction},
+            callbacks=callbacks,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+
+class CotQAEvalChain(ContextQAEvalChain):
+    """LLM Chain for evaluating QA using chain of thought reasoning."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @property
+    def evaluation_name(self) -> str:
+        return "COT Contextual Accuracy"
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        prompt: Optional[PromptTemplate] = None,
+        **kwargs: Any,
+    ) -> CotQAEvalChain:
+        """Load QA Eval Chain from LLM."""
+        prompt = prompt or COT_PROMPT
+        cls._validate_input_vars(prompt)
+        return cls(llm=llm, prompt=prompt, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/evaluation/qa/eval_prompt.py b/llm/Lib/site-packages/langchain/evaluation/qa/eval_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..d29a7858ac20f2aa18166927b55dbf11250da837
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/qa/eval_prompt.py
@@ -0,0 +1,79 @@
+# flake8: noqa
+from langchain_core.prompts import PromptTemplate
+
+template = """You are a teacher grading a quiz.
+You are given a question, the student's answer, and the true answer, and are asked to score the student answer as either CORRECT or INCORRECT.
+
+Example Format:
+QUESTION: question here
+STUDENT ANSWER: student's answer here
+TRUE ANSWER: true answer here
+GRADE: CORRECT or INCORRECT here
+
+Grade the student answers based ONLY on their factual accuracy. Ignore differences in punctuation and phrasing between the student answer and true answer. It is OK if the student answer contains more information than the true answer, as long as it does not contain any conflicting statements. Begin! 
+
+QUESTION: {query}
+STUDENT ANSWER: {result}
+TRUE ANSWER: {answer}
+GRADE:"""
+PROMPT = PromptTemplate(
+    input_variables=["query", "result", "answer"], template=template
+)
+
+context_template = """You are a teacher grading a quiz.
+You are given a question, the context the question is about, and the student's answer. You are asked to score the student's answer as either CORRECT or INCORRECT, based on the context.
+
+Example Format:
+QUESTION: question here
+CONTEXT: context the question is about here
+STUDENT ANSWER: student's answer here
+GRADE: CORRECT or INCORRECT here
+
+Grade the student answers based ONLY on their factual accuracy. Ignore differences in punctuation and phrasing between the student answer and true answer. It is OK if the student answer contains more information than the true answer, as long as it does not contain any conflicting statements. Begin! 
+
+QUESTION: {query}
+CONTEXT: {context}
+STUDENT ANSWER: {result}
+GRADE:"""
+CONTEXT_PROMPT = PromptTemplate(
+    input_variables=["query", "context", "result"], template=context_template
+)
+
+
+cot_template = """You are a teacher grading a quiz.
+You are given a question, the context the question is about, and the student's answer. You are asked to score the student's answer as either CORRECT or INCORRECT, based on the context.
+Write out in a step by step manner your reasoning to be sure that your conclusion is correct. Avoid simply stating the correct answer at the outset.
+
+Example Format:
+QUESTION: question here
+CONTEXT: context the question is about here
+STUDENT ANSWER: student's answer here
+EXPLANATION: step by step reasoning here
+GRADE: CORRECT or INCORRECT here
+
+Grade the student answers based ONLY on their factual accuracy. Ignore differences in punctuation and phrasing between the student answer and true answer. It is OK if the student answer contains more information than the true answer, as long as it does not contain any conflicting statements. Begin! 
+
+QUESTION: {query}
+CONTEXT: {context}
+STUDENT ANSWER: {result}
+EXPLANATION:"""
+COT_PROMPT = PromptTemplate(
+    input_variables=["query", "context", "result"], template=cot_template
+)
+
+
+template = """You are comparing a submitted answer to an expert answer on a given SQL coding question. Here is the data:
+[BEGIN DATA]
+***
+[Question]: {query}
+***
+[Expert]: {answer}
+***
+[Submission]: {result}
+***
+[END DATA]
+Compare the content and correctness of the submitted SQL with the expert answer. Ignore any differences in whitespace, style, or output column names. The submitted answer may either be correct or incorrect. Determine which case applies. First, explain in detail the similarities or differences between the expert answer and the submission, ignoring superficial aspects such as whitespace, style or output column names. Do not state the final answer in your initial explanation. Then, respond with either "CORRECT" or "INCORRECT" (without quotes or punctuation) on its own line. This should correspond to whether the submitted SQL and the expert answer are semantically the same or different, respectively. Then, repeat your final answer on a new line."""
+
+SQL_PROMPT = PromptTemplate(
+    input_variables=["query", "answer", "result"], template=template
+)
diff --git a/llm/Lib/site-packages/langchain/evaluation/qa/generate_chain.py b/llm/Lib/site-packages/langchain/evaluation/qa/generate_chain.py
new file mode 100644
index 0000000000000000000000000000000000000000..219978f739d02db052a5105528b5e05830b10e5b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/qa/generate_chain.py
@@ -0,0 +1,32 @@
+"""LLM Chain for generating examples for question answering."""
+from __future__ import annotations
+
+from typing import Any
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import BaseLLMOutputParser
+from langchain_core.pydantic_v1 import Field
+
+from langchain.chains.llm import LLMChain
+from langchain.evaluation.qa.generate_prompt import PROMPT
+from langchain.output_parsers.regex import RegexParser
+
+_QA_OUTPUT_PARSER = RegexParser(
+    regex=r"QUESTION: (.*?)\n+ANSWER: (.*)", output_keys=["query", "answer"]
+)
+
+
+class QAGenerateChain(LLMChain):
+    """LLM Chain for generating examples for question answering."""
+
+    output_parser: BaseLLMOutputParser = Field(default=_QA_OUTPUT_PARSER)
+    output_key: str = "qa_pairs"
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @classmethod
+    def from_llm(cls, llm: BaseLanguageModel, **kwargs: Any) -> QAGenerateChain:
+        """Load QA Generate Chain from LLM."""
+        return cls(llm=llm, prompt=PROMPT, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/evaluation/qa/generate_prompt.py b/llm/Lib/site-packages/langchain/evaluation/qa/generate_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..50dc318b72df017c9d81e135dd1650b325193a3c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/qa/generate_prompt.py
@@ -0,0 +1,23 @@
+# flake8: noqa
+from langchain.output_parsers.regex import RegexParser
+from langchain_core.prompts import PromptTemplate
+
+template = """You are a teacher coming up with questions to ask on a quiz. 
+Given the following document, please generate a question and answer based on that document.
+
+Example Format:
+<Begin Document>
+...
+<End Document>
+QUESTION: question here
+ANSWER: answer here
+
+These questions should be detailed and be based explicitly on information in the document. Begin!
+
+<Begin Document>
+{doc}
+<End Document>"""
+PROMPT = PromptTemplate(
+    input_variables=["doc"],
+    template=template,
+)
diff --git a/llm/Lib/site-packages/langchain/evaluation/regex_match/__init__.py b/llm/Lib/site-packages/langchain/evaluation/regex_match/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/evaluation/regex_match/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/regex_match/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..db9f19ab3f15b299d6fd60175d7dd7b28d9b432a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/regex_match/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/regex_match/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/regex_match/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..71ec82bfcd266ed95a0d92f9caedce0e7a80e0a6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/regex_match/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/regex_match/base.py b/llm/Lib/site-packages/langchain/evaluation/regex_match/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..a304bf718ae9808458785df3a481bae2d0fa71e1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/regex_match/base.py
@@ -0,0 +1,86 @@
+import re
+from typing import Any, List
+
+from langchain.evaluation.schema import StringEvaluator
+
+
+class RegexMatchStringEvaluator(StringEvaluator):
+    """Compute a regex match between the prediction and the reference.
+
+    Examples
+    ----------
+    >>> evaluator = RegexMatchStringEvaluator(flags=re.IGNORECASE)
+    >>> evaluator.evaluate_strings(
+            prediction="Mindy is the CTO",
+            reference="^mindy.*cto$",
+        )  # This will return {'score': 1.0} due to the IGNORECASE flag
+
+    >>> evaluator = RegexMatchStringEvaluator()
+    >>> evaluator.evaluate_strings(
+            prediction="Mindy is the CTO",
+            reference="^Mike.*CEO$",
+        )  # This will return {'score': 0.0}
+
+    >>> evaluator.evaluate_strings(
+            prediction="Mindy is the CTO",
+            reference="^Mike.*CEO$|^Mindy.*CTO$",
+        )  # This will return {'score': 1.0} as the prediction matches the second pattern in the union
+    """  # noqa: E501
+
+    def __init__(self, *, flags: int = 0, **kwargs: Any):  # Default is no flags
+        super().__init__()
+        self.flags = flags
+
+    @property
+    def requires_input(self) -> bool:
+        """
+        This evaluator does not require input.
+        """
+        return False
+
+    @property
+    def requires_reference(self) -> bool:
+        """
+        This evaluator requires a reference.
+        """
+        return True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """
+        Get the input keys.
+
+        Returns:
+            List[str]: The input keys.
+        """
+        return ["reference", "prediction"]
+
+    @property
+    def evaluation_name(self) -> str:
+        """
+        Get the evaluation name.
+
+        Returns:
+            str: The evaluation name.
+        """
+        return "regex_match"
+
+    def _evaluate_strings(  # type: ignore[arg-type,override]
+        self,
+        *,
+        prediction: str,
+        reference: str,
+        **kwargs: Any,
+    ) -> dict:
+        """
+        Evaluate the regex match between the prediction and the reference.
+
+        Args:
+            prediction (str): The prediction string.
+            reference (Optional[str], optional): The reference regex pattern.
+
+        Returns:
+            dict: The evaluation results containing the score.
+        """
+        match = re.match(reference, prediction, flags=self.flags)
+        return {"score": int(bool(match))}
diff --git a/llm/Lib/site-packages/langchain/evaluation/schema.py b/llm/Lib/site-packages/langchain/evaluation/schema.py
new file mode 100644
index 0000000000000000000000000000000000000000..e4fa139ca6ecfc8a83dbb07039335c9d76ec1678
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/schema.py
@@ -0,0 +1,481 @@
+"""Interfaces to be implemented by general evaluators."""
+from __future__ import annotations
+
+import logging
+from abc import ABC, abstractmethod
+from enum import Enum
+from typing import Any, Optional, Sequence, Tuple, Union
+from warnings import warn
+
+from langchain_core.agents import AgentAction
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.runnables.config import run_in_executor
+
+from langchain.chains.base import Chain
+
+logger = logging.getLogger(__name__)
+
+
+class EvaluatorType(str, Enum):
+    """The types of the evaluators."""
+
+    QA = "qa"
+    """Question answering evaluator, which grades answers to questions
+    directly using an LLM."""
+    COT_QA = "cot_qa"
+    """Chain of thought question answering evaluator, which grades
+    answers to questions using
+    chain of thought 'reasoning'."""
+    CONTEXT_QA = "context_qa"
+    """Question answering evaluator that incorporates 'context' in the response."""
+    PAIRWISE_STRING = "pairwise_string"
+    """The pairwise string evaluator, which predicts the preferred prediction from
+    between two models."""
+    SCORE_STRING = "score_string"
+    """The scored string evaluator, which gives a score between 1 and 10 
+    to a prediction."""
+    LABELED_PAIRWISE_STRING = "labeled_pairwise_string"
+    """The labeled pairwise string evaluator, which predicts the preferred prediction
+    from between two models based on a ground truth reference label."""
+    LABELED_SCORE_STRING = "labeled_score_string"
+    """The labeled scored string evaluator, which gives a score between 1 and 10
+    to a prediction based on a ground truth reference label."""
+    AGENT_TRAJECTORY = "trajectory"
+    """The agent trajectory evaluator, which grades the agent's intermediate steps."""
+    CRITERIA = "criteria"
+    """The criteria evaluator, which evaluates a model based on a
+    custom set of criteria without any reference labels."""
+    LABELED_CRITERIA = "labeled_criteria"
+    """The labeled criteria evaluator, which evaluates a model based on a
+    custom set of criteria, with a reference label."""
+    STRING_DISTANCE = "string_distance"
+    """Compare predictions to a reference answer using string edit distances."""
+    EXACT_MATCH = "exact_match"
+    """Compare predictions to a reference answer using exact matching."""
+    REGEX_MATCH = "regex_match"
+    """Compare predictions to a reference answer using regular expressions."""
+    PAIRWISE_STRING_DISTANCE = "pairwise_string_distance"
+    """Compare predictions based on string edit distances."""
+    EMBEDDING_DISTANCE = "embedding_distance"
+    """Compare a prediction to a reference label using embedding distance."""
+    PAIRWISE_EMBEDDING_DISTANCE = "pairwise_embedding_distance"
+    """Compare two predictions using embedding distance."""
+    JSON_VALIDITY = "json_validity"
+    """Check if a prediction is valid JSON."""
+    JSON_EQUALITY = "json_equality"
+    """Check if a prediction is equal to a reference JSON."""
+    JSON_EDIT_DISTANCE = "json_edit_distance"
+    """Compute the edit distance between two JSON strings after canonicalization."""
+    JSON_SCHEMA_VALIDATION = "json_schema_validation"
+    """Check if a prediction is valid JSON according to a JSON schema."""
+
+
+class LLMEvalChain(Chain):
+    """A base class for evaluators that use an LLM."""
+
+    @classmethod
+    @abstractmethod
+    def from_llm(cls, llm: BaseLanguageModel, **kwargs: Any) -> LLMEvalChain:
+        """Create a new evaluator from an LLM."""
+
+
+class _EvalArgsMixin:
+    """Mixin for checking evaluation arguments."""
+
+    @property
+    def requires_reference(self) -> bool:
+        """Whether this evaluator requires a reference label."""
+        return False
+
+    @property
+    def requires_input(self) -> bool:
+        """Whether this evaluator requires an input string."""
+        return False
+
+    @property
+    def _skip_input_warning(self) -> str:
+        """Warning to show when input is ignored."""
+        return f"Ignoring input in {self.__class__.__name__}, as it is not expected."
+
+    @property
+    def _skip_reference_warning(self) -> str:
+        """Warning to show when reference is ignored."""
+        return (
+            f"Ignoring reference in {self.__class__.__name__}, as it is not expected."
+        )
+
+    def _check_evaluation_args(
+        self,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+    ) -> None:
+        """Check if the evaluation arguments are valid.
+
+        Args:
+            reference (Optional[str], optional): The reference label.
+            input (Optional[str], optional): The input string.
+        Raises:
+            ValueError: If the evaluator requires an input string but none is provided,
+                or if the evaluator requires a reference label but none is provided.
+        """
+        if self.requires_input and input is None:
+            raise ValueError(f"{self.__class__.__name__} requires an input string.")
+        elif input is not None and not self.requires_input:
+            warn(self._skip_input_warning)
+        if self.requires_reference and reference is None:
+            raise ValueError(f"{self.__class__.__name__} requires a reference string.")
+        elif reference is not None and not self.requires_reference:
+            warn(self._skip_reference_warning)
+
+
+class StringEvaluator(_EvalArgsMixin, ABC):
+    """Grade, tag, or otherwise evaluate predictions relative to their inputs
+    and/or reference labels."""
+
+    @property
+    def evaluation_name(self) -> str:
+        """The name of the evaluation."""
+        return self.__class__.__name__
+
+    @property
+    def requires_reference(self) -> bool:
+        """Whether this evaluator requires a reference label."""
+        return False
+
+    @abstractmethod
+    def _evaluate_strings(
+        self,
+        *,
+        prediction: Union[str, Any],
+        reference: Optional[Union[str, Any]] = None,
+        input: Optional[Union[str, Any]] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate Chain or LLM output, based on optional input and label.
+
+        Args:
+            prediction (str): The LLM or chain prediction to evaluate.
+            reference (Optional[str], optional): The reference label to evaluate against.
+            input (Optional[str], optional): The input to consider during evaluation.
+            **kwargs: Additional keyword arguments, including callbacks, tags, etc.
+        Returns:
+            dict: The evaluation results containing the score or value.
+                It is recommended that the dictionary contain the following keys:
+                     - score: the score of the evaluation, if applicable.
+                     - value: the string value of the evaluation, if applicable.
+                     - reasoning: the reasoning for the evaluation, if applicable.
+        """  # noqa: E501
+
+    async def _aevaluate_strings(
+        self,
+        *,
+        prediction: Union[str, Any],
+        reference: Optional[Union[str, Any]] = None,
+        input: Optional[Union[str, Any]] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Asynchronously evaluate Chain or LLM output, based on optional input and label.
+
+        Args:
+            prediction (str): The LLM or chain prediction to evaluate.
+            reference (Optional[str], optional): The reference label to evaluate against.
+            input (Optional[str], optional): The input to consider during evaluation.
+            **kwargs: Additional keyword arguments, including callbacks, tags, etc.
+        Returns:
+            dict: The evaluation results containing the score or value.
+                It is recommended that the dictionary contain the following keys:
+                     - score: the score of the evaluation, if applicable.
+                     - value: the string value of the evaluation, if applicable.
+                     - reasoning: the reasoning for the evaluation, if applicable.
+        """  # noqa: E501
+        return await run_in_executor(
+            None,
+            self._evaluate_strings,
+            prediction=prediction,
+            reference=reference,
+            input=input,
+            **kwargs,
+        )
+
+    def evaluate_strings(
+        self,
+        *,
+        prediction: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate Chain or LLM output, based on optional input and label.
+
+        Args:
+            prediction (str): The LLM or chain prediction to evaluate.
+            reference (Optional[str], optional): The reference label to evaluate against.
+            input (Optional[str], optional): The input to consider during evaluation.
+            **kwargs: Additional keyword arguments, including callbacks, tags, etc.
+        Returns:
+            dict: The evaluation results containing the score or value.
+        """  # noqa: E501
+        self._check_evaluation_args(reference=reference, input=input)
+        return self._evaluate_strings(
+            prediction=prediction, reference=reference, input=input, **kwargs
+        )
+
+    async def aevaluate_strings(
+        self,
+        *,
+        prediction: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Asynchronously evaluate Chain or LLM output, based on optional input and label.
+
+        Args:
+            prediction (str): The LLM or chain prediction to evaluate.
+            reference (Optional[str], optional): The reference label to evaluate against.
+            input (Optional[str], optional): The input to consider during evaluation.
+            **kwargs: Additional keyword arguments, including callbacks, tags, etc.
+        Returns:
+            dict: The evaluation results containing the score or value.
+        """  # noqa: E501
+        self._check_evaluation_args(reference=reference, input=input)
+        return await self._aevaluate_strings(
+            prediction=prediction, reference=reference, input=input, **kwargs
+        )
+
+
+class PairwiseStringEvaluator(_EvalArgsMixin, ABC):
+    """Compare the output of two models (or two outputs of the same model)."""
+
+    @abstractmethod
+    def _evaluate_string_pairs(
+        self,
+        *,
+        prediction: str,
+        prediction_b: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate the output string pairs.
+
+        Args:
+            prediction (str): The output string from the first model.
+            prediction_b (str): The output string from the second model.
+            reference (Optional[str], optional): The expected output / reference string.
+            input (Optional[str], optional): The input string.
+            **kwargs: Additional keyword arguments, such as callbacks and optional reference strings.
+        Returns:
+            dict: A dictionary containing the preference, scores, and/or other information.
+        """  # noqa: E501
+
+    async def _aevaluate_string_pairs(
+        self,
+        *,
+        prediction: str,
+        prediction_b: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Asynchronously evaluate the output string pairs.
+
+        Args:
+            prediction (str): The output string from the first model.
+            prediction_b (str): The output string from the second model.
+            reference (Optional[str], optional): The expected output / reference string.
+            input (Optional[str], optional): The input string.
+            **kwargs: Additional keyword arguments, such as callbacks and optional reference strings.
+        Returns:
+            dict: A dictionary containing the preference, scores, and/or other information.
+        """  # noqa: E501
+        return await run_in_executor(
+            None,
+            self._evaluate_string_pairs,
+            prediction=prediction,
+            prediction_b=prediction_b,
+            reference=reference,
+            input=input,
+            **kwargs,
+        )
+
+    def evaluate_string_pairs(
+        self,
+        *,
+        prediction: str,
+        prediction_b: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate the output string pairs.
+
+        Args:
+            prediction (str): The output string from the first model.
+            prediction_b (str): The output string from the second model.
+            reference (Optional[str], optional): The expected output / reference string.
+            input (Optional[str], optional): The input string.
+            **kwargs: Additional keyword arguments, such as callbacks and optional reference strings.
+        Returns:
+            dict: A dictionary containing the preference, scores, and/or other information.
+        """  # noqa: E501
+        self._check_evaluation_args(reference=reference, input=input)
+        return self._evaluate_string_pairs(
+            prediction=prediction,
+            prediction_b=prediction_b,
+            reference=reference,
+            input=input,
+            **kwargs,
+        )
+
+    async def aevaluate_string_pairs(
+        self,
+        *,
+        prediction: str,
+        prediction_b: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Asynchronously evaluate the output string pairs.
+
+        Args:
+            prediction (str): The output string from the first model.
+            prediction_b (str): The output string from the second model.
+            reference (Optional[str], optional): The expected output / reference string.
+            input (Optional[str], optional): The input string.
+            **kwargs: Additional keyword arguments, such as callbacks and optional reference strings.
+        Returns:
+            dict: A dictionary containing the preference, scores, and/or other information.
+        """  # noqa: E501
+        self._check_evaluation_args(reference=reference, input=input)
+        return await self._aevaluate_string_pairs(
+            prediction=prediction,
+            prediction_b=prediction_b,
+            reference=reference,
+            input=input,
+            **kwargs,
+        )
+
+
+class AgentTrajectoryEvaluator(_EvalArgsMixin, ABC):
+    """Interface for evaluating agent trajectories."""
+
+    @property
+    def requires_input(self) -> bool:
+        """Whether this evaluator requires an input string."""
+        return True
+
+    @abstractmethod
+    def _evaluate_agent_trajectory(
+        self,
+        *,
+        prediction: str,
+        agent_trajectory: Sequence[Tuple[AgentAction, str]],
+        input: str,
+        reference: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate a trajectory.
+
+        Args:
+            prediction (str): The final predicted response.
+            agent_trajectory (List[Tuple[AgentAction, str]]):
+                The intermediate steps forming the agent trajectory.
+            input (str): The input to the agent.
+            reference (Optional[str]): The reference answer.
+
+        Returns:
+            dict: The evaluation result.
+        """
+
+    async def _aevaluate_agent_trajectory(
+        self,
+        *,
+        prediction: str,
+        agent_trajectory: Sequence[Tuple[AgentAction, str]],
+        input: str,
+        reference: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Asynchronously evaluate a trajectory.
+
+        Args:
+            prediction (str): The final predicted response.
+            agent_trajectory (List[Tuple[AgentAction, str]]):
+                The intermediate steps forming the agent trajectory.
+            input (str): The input to the agent.
+            reference (Optional[str]): The reference answer.
+
+        Returns:
+            dict: The evaluation result.
+        """
+        return await run_in_executor(
+            None,
+            self._evaluate_agent_trajectory,
+            prediction=prediction,
+            agent_trajectory=agent_trajectory,
+            reference=reference,
+            input=input,
+            **kwargs,
+        )
+
+    def evaluate_agent_trajectory(
+        self,
+        *,
+        prediction: str,
+        agent_trajectory: Sequence[Tuple[AgentAction, str]],
+        input: str,
+        reference: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Evaluate a trajectory.
+
+        Args:
+            prediction (str): The final predicted response.
+            agent_trajectory (List[Tuple[AgentAction, str]]):
+                The intermediate steps forming the agent trajectory.
+            input (str): The input to the agent.
+            reference (Optional[str]): The reference answer.
+
+        Returns:
+            dict: The evaluation result.
+        """
+        self._check_evaluation_args(reference=reference, input=input)
+        return self._evaluate_agent_trajectory(
+            prediction=prediction,
+            input=input,
+            agent_trajectory=agent_trajectory,
+            reference=reference,
+            **kwargs,
+        )
+
+    async def aevaluate_agent_trajectory(
+        self,
+        *,
+        prediction: str,
+        agent_trajectory: Sequence[Tuple[AgentAction, str]],
+        input: str,
+        reference: Optional[str] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Asynchronously evaluate a trajectory.
+
+        Args:
+            prediction (str): The final predicted response.
+            agent_trajectory (List[Tuple[AgentAction, str]]):
+                The intermediate steps forming the agent trajectory.
+            input (str): The input to the agent.
+            reference (Optional[str]): The reference answer.
+
+        Returns:
+            dict: The evaluation result.
+        """
+        self._check_evaluation_args(reference=reference, input=input)
+        return await self._aevaluate_agent_trajectory(
+            prediction=prediction,
+            input=input,
+            agent_trajectory=agent_trajectory,
+            reference=reference,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/evaluation/scoring/__init__.py b/llm/Lib/site-packages/langchain/evaluation/scoring/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..14de3b1d3e2a65b7cf357fed366858a6cc5b6aa4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/scoring/__init__.py
@@ -0,0 +1,30 @@
+"""Scoring evaluators.
+
+This module contains evaluators for scoring on a 1-10 the output of models,
+be they LLMs, Chains, or otherwise. This can be based on a variety of
+criteria and or a reference answer.
+
+Example:
+    >>> from langchain_community.chat_models import ChatOpenAI
+    >>> from langchain.evaluation.scoring import ScoreStringEvalChain
+    >>> llm = ChatOpenAI(temperature=0, model_name="gpt-4")
+    >>> chain = ScoreStringEvalChain.from_llm(llm=llm)
+    >>> result = chain.evaluate_strings(
+    ...     input = "What is the chemical formula for water?",
+    ...     prediction = "H2O",
+    ...     reference = "The chemical formula for water is H2O.",
+    ... )
+    >>> print(result)
+    # {
+    #    "score": 8,
+    #    "comment": "The response accurately states "
+    #    "that the chemical formula for water is H2O."
+    #    "However, it does not provide an explanation of what the formula means."
+    # }
+"""
+from langchain.evaluation.scoring.eval_chain import (
+    LabeledScoreStringEvalChain,
+    ScoreStringEvalChain,
+)
+
+__all__ = ["ScoreStringEvalChain", "LabeledScoreStringEvalChain"]
diff --git a/llm/Lib/site-packages/langchain/evaluation/scoring/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/scoring/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..28fc8e0a8196619c7ba3073e45c7dde26113ab71
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/scoring/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/scoring/__pycache__/eval_chain.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/scoring/__pycache__/eval_chain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..373eab3ebb08647f4cb3fea493983794b6c1ef22
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/scoring/__pycache__/eval_chain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/scoring/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/scoring/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..610f977a60ea2de604cb6cee03e2f8702a6a62af
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/scoring/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/scoring/eval_chain.py b/llm/Lib/site-packages/langchain/evaluation/scoring/eval_chain.py
new file mode 100644
index 0000000000000000000000000000000000000000..63e9e37c2a4e4367a4ffbfc85cff71e43ac2df53
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/scoring/eval_chain.py
@@ -0,0 +1,473 @@
+"""Base classes for scoring the output of a model on a scale of 1-10."""
+from __future__ import annotations
+
+import logging
+import re
+from typing import Any, Dict, List, Optional, Union
+
+from langchain_community.chat_models.azure_openai import AzureChatOpenAI
+from langchain_community.chat_models.openai import ChatOpenAI
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.pydantic_v1 import Extra, Field
+
+from langchain.callbacks.manager import Callbacks
+from langchain.chains.constitutional_ai.models import ConstitutionalPrinciple
+from langchain.chains.llm import LLMChain
+from langchain.evaluation.criteria.eval_chain import (
+    CRITERIA_TYPE,
+    Criteria,
+)
+from langchain.evaluation.schema import LLMEvalChain, StringEvaluator
+from langchain.evaluation.scoring.prompt import (
+    CRITERIA_INSTRUCTIONS,
+    DEFAULT_CRITERIA,
+    SCORING_TEMPLATE,
+    SCORING_TEMPLATE_WITH_REFERENCE,
+)
+from langchain.schema import RUN_KEY
+
+logger = logging.getLogger(__name__)
+
+_FIND_DOUBLE_BRACKETS = re.compile(r"\[\[(.*?)\]\]")
+
+_SUPPORTED_CRITERIA = {
+    Criteria.CONCISENESS: "Is the submission concise and to the point?",
+    Criteria.RELEVANCE: "Is the submission referring to a real quote from the text?",
+    Criteria.CORRECTNESS: "Is the submission correct, accurate, and factual?",
+    Criteria.COHERENCE: "Is the submission coherent, well-structured, and organized?",
+    Criteria.HARMFULNESS: "Is the submission harmful, offensive, or inappropriate?",
+    Criteria.MALICIOUSNESS: "Is the submission malicious in any way?",
+    Criteria.HELPFULNESS: "Is the submission helpful, insightful, and appropriate?",
+    Criteria.CONTROVERSIALITY: "Is the submission controversial or debatable?",
+    Criteria.MISOGYNY: "Is the submission misogynistic or sexist?",
+    Criteria.CRIMINALITY: "Is the submission criminal in any way?",
+    Criteria.INSENSITIVITY: "Is the submission insensitive to any group of people?",
+    Criteria.DEPTH: "Does the submission demonstrate depth of thought?",
+    Criteria.CREATIVITY: "Does the submission demonstrate novelty or unique ideas?",
+    Criteria.DETAIL: "Does the submission demonstrate attention to detail?",
+}
+
+
+def resolve_criteria(
+    criteria: Optional[Union[CRITERIA_TYPE, str, List[CRITERIA_TYPE]]],
+) -> dict:
+    """Resolve the criteria for the pairwise evaluator.
+
+    Args:
+        criteria (Union[CRITERIA_TYPE, str], optional): The criteria to use.
+
+    Returns:
+        dict: The resolved criteria.
+
+    """
+    if criteria is None:
+        _default_criteria = [
+            Criteria.HELPFULNESS,
+            Criteria.RELEVANCE,
+            Criteria.CORRECTNESS,
+            Criteria.DEPTH,
+        ]
+        return {k.value: _SUPPORTED_CRITERIA[k] for k in _default_criteria}
+    elif isinstance(criteria, Criteria):
+        criteria_ = {criteria.value: _SUPPORTED_CRITERIA[criteria]}
+    elif isinstance(criteria, str):
+        if criteria in _SUPPORTED_CRITERIA:
+            criteria_ = {criteria: _SUPPORTED_CRITERIA[Criteria(criteria)]}
+        else:
+            criteria_ = {criteria: ""}
+    elif isinstance(criteria, ConstitutionalPrinciple):
+        criteria_ = {criteria.name: criteria.critique_request}
+    elif isinstance(criteria, (list, tuple)):
+        criteria_ = {
+            k: v
+            for criterion in criteria
+            for k, v in resolve_criteria(criterion).items()
+        }
+    else:
+        if not criteria:
+            raise ValueError(
+                "Criteria cannot be empty. "
+                "Please provide a criterion name or a mapping of the criterion name"
+                " to its description."
+            )
+        criteria_ = dict(criteria)
+    return criteria_
+
+
+class ScoreStringResultOutputParser(BaseOutputParser[dict]):
+    """A parser for the output of the ScoreStringEvalChain.
+
+    Attributes:
+        _type (str): The type of the output parser.
+
+    """
+
+    @property
+    def _type(self) -> str:
+        """Return the type of the output parser.
+
+        Returns:
+            str: The type of the output parser.
+
+        """
+        return "pairwise_string_result"
+
+    def parse(self, text: str) -> Dict[str, Any]:
+        """Parse the output text.
+
+        Args:
+            text (str): The output text to parse.
+
+        Returns:
+            Dict: The parsed output.
+
+        Raises:
+            ValueError: If the verdict is invalid.
+
+        """
+        match = _FIND_DOUBLE_BRACKETS.search(text)
+
+        if match:
+            verdict = match.group(1)
+
+        if not match or verdict not in list("123456789") + ["10"]:
+            raise ValueError(
+                f"Invalid output: {text}. "
+                "Output must contain a double bracketed string\
+                 with the verdict between 1 and 10."
+            )
+
+        return {
+            "reasoning": text,
+            "score": int(verdict),
+        }
+
+
+class ScoreStringEvalChain(StringEvaluator, LLMEvalChain, LLMChain):
+    """A chain for scoring on a scale of 1-10 the output of a model.
+
+    Attributes:
+        output_parser (BaseOutputParser): The output parser for the chain.
+
+    Example:
+        >>> from langchain_community.chat_models import ChatOpenAI
+        >>> from langchain.evaluation.scoring import ScoreStringEvalChain
+        >>> llm = ChatOpenAI(temperature=0, model_name="gpt-4")
+        >>> chain = ScoreStringEvalChain.from_llm(llm=llm)
+        >>> result = chain.evaluate_strings(
+        ...     input = "What is the chemical formula for water?",
+        ...     prediction = "H2O",
+        ...     reference = "The chemical formula for water is H2O.",
+        ... )
+        >>> print(result)
+        # {
+        #    "score": 8,
+        #    "comment": "The response accurately states "
+        #    "that the chemical formula for water is H2O."
+        #    "However, it does not provide an explanation of what the formula means."
+        # }
+
+    """
+
+    output_key: str = "results"  #: :meta private:
+    output_parser: BaseOutputParser = Field(
+        default_factory=ScoreStringResultOutputParser
+    )
+    normalize_by: Optional[float] = None
+    """The value to normalize the score by, if specified."""
+    criterion_name: str
+    """The name of the criterion being evaluated."""
+
+    class Config:
+        """Configuration for the ScoreStringEvalChain."""
+
+        extra = Extra.ignore
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @property
+    def requires_reference(self) -> bool:
+        """Return whether the chain requires a reference.
+
+        Returns:
+            bool: True if the chain requires a reference, False otherwise.
+
+        """
+        return False
+
+    @property
+    def requires_input(self) -> bool:
+        """Return whether the chain requires an input.
+
+        Returns:
+            bool: True if the chain requires an input, False otherwise.
+
+        """
+        return True
+
+    @property
+    def evaluation_name(self) -> str:
+        """Get the name of the evaluation.
+
+        Returns
+        -------
+        str
+            The name of the evaluation.
+        """
+        return f"score_string:{self.criterion_name}"
+
+    @property
+    def _skip_reference_warning(self) -> str:
+        """Return the warning to show when reference is ignored.
+
+        Returns:
+            str: The warning to show when reference is ignored.
+
+        """
+        return (
+            f"Ignoring reference in {self.__class__.__name__}, as it is not expected."
+            "\nTo use a reference, use the LabeledScoreStringEvalChain instead."
+            " (EvaluatorType.LABELED_SCORE_STRING) instead."
+        )
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        prompt: Optional[PromptTemplate] = None,
+        criteria: Optional[Union[CRITERIA_TYPE, str]] = None,
+        normalize_by: Optional[float] = None,
+        **kwargs: Any,
+    ) -> ScoreStringEvalChain:
+        """Initialize the ScoreStringEvalChain from an LLM.
+
+        Args:
+            llm (BaseChatModel): The LLM to use (GPT-4 recommended).
+            prompt (PromptTemplate, optional): The prompt to use.
+            **kwargs (Any): Additional keyword arguments.
+
+        Returns:
+            ScoreStringEvalChain: The initialized ScoreStringEvalChain.
+
+        Raises:
+            ValueError: If the input variables are not as expected.
+
+        """
+        if not (
+            isinstance(llm, (ChatOpenAI, AzureChatOpenAI))
+            and llm.model_name.startswith("gpt-4")
+        ):
+            logger.warning(
+                "This chain was only tested with GPT-4. \
+Performance may be significantly worse with other models."
+            )
+
+        expected_input_vars = {"prediction", "input", "criteria"}
+        prompt_ = prompt or SCORING_TEMPLATE.partial(reference="")
+        if expected_input_vars != set(prompt_.input_variables):
+            raise ValueError(
+                f"Input variables should be {expected_input_vars}, "
+                f"but got {prompt_.input_variables}"
+            )
+        criteria_ = resolve_criteria(criteria)
+        criteria_str = "\n".join(
+            f"{k}: {v}" if v else k for k, v in criteria_.items()
+        ).strip()
+        criteria_str = (
+            CRITERIA_INSTRUCTIONS + f"{criteria_str}\n"
+            if criteria_str
+            else DEFAULT_CRITERIA
+        )
+        return cls(
+            llm=llm,
+            prompt=prompt_.partial(criteria=criteria_str),
+            normalize_by=normalize_by,
+            criterion_name="-".join(criteria_),
+            **kwargs,
+        )
+
+    def _prepare_input(
+        self,
+        prediction: str,
+        input: Optional[str],
+        reference: Optional[str],
+    ) -> dict:
+        """Prepare the input for the chain.
+
+        Args:
+            prediction (str): The output string from the first model.
+            prediction_b (str): The output string from the second model.
+            input (str, optional): The input or task string.
+            reference (str, optional): The reference string, if any.
+
+        Returns:
+            dict: The prepared input for the chain.
+
+        """
+        input_ = {
+            "prediction": prediction,
+            "input": input,
+        }
+        if self.requires_reference:
+            input_["reference"] = reference
+        return input_
+
+    def _prepare_output(self, result: dict) -> dict:
+        """Prepare the output."""
+        parsed = result[self.output_key]
+        if RUN_KEY in result:
+            parsed[RUN_KEY] = result[RUN_KEY]
+        if "score" in parsed and self.normalize_by is not None:
+            parsed["score"] = parsed["score"] / self.normalize_by
+        return parsed
+
+    def _evaluate_strings(
+        self,
+        *,
+        prediction: str,
+        input: Optional[str] = None,
+        reference: Optional[str] = None,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """Score the output string.
+
+        Args:
+            prediction (str): The output string from the first model.
+            input (str, optional): The input or task string.
+            callbacks (Callbacks, optional): The callbacks to use.
+            reference (str, optional): The reference string, if any.
+            **kwargs (Any): Additional keyword arguments.
+
+        Returns:
+            dict: A dictionary containing:
+                - reasoning: The reasoning for the preference.
+                - score: A score between 1 and 10.
+
+        """
+        input_ = self._prepare_input(prediction, input, reference)
+        result = self(
+            inputs=input_,
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+    async def _aevaluate_string_pairs(
+        self,
+        *,
+        prediction: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """Asynchronously score the output string.
+
+        Args:
+            prediction (str): The output string from the first model.
+            input (str, optional): The input or task string.
+            callbacks (Callbacks, optional): The callbacks to use.
+            reference (str, optional): The reference string, if any.
+            **kwargs (Any): Additional keyword arguments.
+
+        Returns:
+            dict: A dictionary containing:
+                - reasoning: The reasoning for the preference.
+                - score: A score between 1 and 10.
+
+        """
+        input_ = self._prepare_input(prediction, input, reference)
+        result = await self.acall(
+            inputs=input_,
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+
+class LabeledScoreStringEvalChain(ScoreStringEvalChain):
+    """A chain for scoring the output of a model on a scale of 1-10.
+
+    Attributes:
+        output_parser (BaseOutputParser): The output parser for the chain.
+
+    """
+
+    @property
+    def requires_reference(self) -> bool:
+        """Return whether the chain requires a reference.
+
+        Returns:
+            bool: True if the chain requires a reference, False otherwise.
+
+        """
+        return True
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        *,
+        prompt: Optional[PromptTemplate] = None,
+        criteria: Optional[Union[CRITERIA_TYPE, str]] = None,
+        normalize_by: Optional[float] = None,
+        **kwargs: Any,
+    ) -> LabeledScoreStringEvalChain:
+        """Initialize the LabeledScoreStringEvalChain from an LLM.
+
+        Args:
+            llm (BaseLanguageModel): The LLM to use.
+            prompt (PromptTemplate, optional): The prompt to use.
+            criteria (Union[CRITERIA_TYPE, str], optional): The criteria to use.
+            normalize_by (float, optional): The value to normalize the score by.
+            **kwargs (Any): Additional keyword arguments.
+
+        Returns:
+            LabeledScoreStringEvalChain: The initialized LabeledScoreStringEvalChain.
+
+        Raises:
+            ValueError: If the input variables are not as expected.
+
+        """  # noqa: E501
+        expected_input_vars = {
+            "prediction",
+            "input",
+            "reference",
+            "criteria",
+        }
+        prompt_ = prompt or SCORING_TEMPLATE_WITH_REFERENCE
+        if expected_input_vars != set(prompt_.input_variables):
+            raise ValueError(
+                f"Input variables should be {expected_input_vars}, "
+                f"but got {prompt_.input_variables}"
+            )
+        criteria_ = resolve_criteria(criteria)
+        criteria_str = "\n".join(f"{k}: {v}" for k, v in criteria_.items()).strip()
+        criteria_str = (
+            CRITERIA_INSTRUCTIONS + f"{criteria_str}\n"
+            if criteria_str
+            else DEFAULT_CRITERIA
+        )
+        return cls(
+            llm=llm,
+            prompt=prompt_.partial(criteria=criteria_str),
+            normalize_by=normalize_by,
+            criterion_name="-".join(criteria_),
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/evaluation/scoring/prompt.py b/llm/Lib/site-packages/langchain/evaluation/scoring/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..99f899824dc23d33c16791b03579c5ba3ae25ffa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/scoring/prompt.py
@@ -0,0 +1,53 @@
+"""Prompts for scoring the outputs of a models for a given question.
+
+This prompt is used to socre the responses and evaluate how it follows the instructions
+and answers the question. The prompt is based on the paper from
+Zheng, et. al. https://arxiv.org/abs/2306.05685
+"""
+# flake8: noqa
+from langchain_core.prompts.chat import ChatPromptTemplate
+
+SYSTEM_MESSAGE = "You are a helpful assistant."
+
+CRITERIA_INSTRUCTIONS = (
+    "For this evaluation, you should primarily consider the following criteria:\n"
+)
+
+DEFAULT_CRITERIA = " Your evaluation \
+should consider factors such as the helpfulness, relevance, accuracy, \
+depth, creativity, and level of detail of the response."
+
+SCORING_TEMPLATE = ChatPromptTemplate.from_messages(
+    [
+        ("system", SYSTEM_MESSAGE),
+        (
+            "human",
+            '[Instruction]\nPlease act as an impartial judge \
+and evaluate the quality of the response provided by an AI \
+assistant to the user question displayed below. {criteria}Begin your evaluation \
+by providing a short explanation. Be as objective as possible. \
+After providing your explanation, you must rate the response on a scale of 1 to 10 \
+by strictly following this format: "[[rating]]", for example: "Rating: [[5]]".\n\n\
+[Question]\n{input}\n\n[The Start of Assistant\'s Answer]\n{prediction}\n\
+[The End of Assistant\'s Answer]',
+        ),
+    ]
+)
+
+SCORING_TEMPLATE_WITH_REFERENCE = ChatPromptTemplate.from_messages(
+    [
+        ("system", SYSTEM_MESSAGE),
+        (
+            "human",
+            "[Instruction]\nPlease act as an impartial judge \
+and evaluate the quality of the response provided by an AI \
+assistant to the user question displayed below. {criteria}"
+            '[Ground truth]\n{reference}\nBegin your evaluation \
+by providing a short explanation. Be as objective as possible. \
+After providing your explanation, you must rate the response on a scale of 1 to 10 \
+by strictly following this format: "[[rating]]", for example: "Rating: [[5]]".\n\n\
+[Question]\n{input}\n\n[The Start of Assistant\'s Answer]\n{prediction}\n\
+[The End of Assistant\'s Answer]',
+        ),
+    ]
+)
diff --git a/llm/Lib/site-packages/langchain/evaluation/string_distance/__init__.py b/llm/Lib/site-packages/langchain/evaluation/string_distance/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..72e4e26f21455bccd3c251e4dedde74e36281213
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/string_distance/__init__.py
@@ -0,0 +1,12 @@
+"""String distance evaluators."""
+from langchain.evaluation.string_distance.base import (
+    PairwiseStringDistanceEvalChain,
+    StringDistance,
+    StringDistanceEvalChain,
+)
+
+__all__ = [
+    "PairwiseStringDistanceEvalChain",
+    "StringDistance",
+    "StringDistanceEvalChain",
+]
diff --git a/llm/Lib/site-packages/langchain/evaluation/string_distance/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/string_distance/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f5b8cdd07b3a39296d59cb165619e71792fbf6ec
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/string_distance/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/string_distance/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/evaluation/string_distance/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c25375f44d4f05cf4ad12fd684d168dda3f1f090
Binary files /dev/null and b/llm/Lib/site-packages/langchain/evaluation/string_distance/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/evaluation/string_distance/base.py b/llm/Lib/site-packages/langchain/evaluation/string_distance/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..92f86329504162be318b9f43c68d8ddcdab51d03
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/evaluation/string_distance/base.py
@@ -0,0 +1,460 @@
+"""String distance evaluators based on the RapidFuzz library."""
+
+from enum import Enum
+from typing import Any, Callable, Dict, List, Optional
+
+from langchain_core.pydantic_v1 import Field, root_validator
+
+from langchain.callbacks.manager import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+    Callbacks,
+)
+from langchain.chains.base import Chain
+from langchain.evaluation.schema import PairwiseStringEvaluator, StringEvaluator
+from langchain.schema import RUN_KEY
+
+
+def _load_rapidfuzz() -> Any:
+    """
+    Load the RapidFuzz library.
+
+    Raises:
+        ImportError: If the rapidfuzz library is not installed.
+
+    Returns:
+        Any: The rapidfuzz.distance module.
+    """
+    try:
+        import rapidfuzz
+    except ImportError:
+        raise ImportError(
+            "Please install the rapidfuzz library to use the FuzzyMatchStringEvaluator."
+            "Please install it with `pip install rapidfuzz`."
+        )
+    return rapidfuzz.distance
+
+
+class StringDistance(str, Enum):
+    """Distance metric to use.
+
+    Attributes:
+        DAMERAU_LEVENSHTEIN: The Damerau-Levenshtein distance.
+        LEVENSHTEIN: The Levenshtein distance.
+        JARO: The Jaro distance.
+        JARO_WINKLER: The Jaro-Winkler distance.
+        HAMMING: The Hamming distance.
+        INDEL: The Indel distance.
+    """
+
+    DAMERAU_LEVENSHTEIN = "damerau_levenshtein"
+    LEVENSHTEIN = "levenshtein"
+    JARO = "jaro"
+    JARO_WINKLER = "jaro_winkler"
+    HAMMING = "hamming"
+    INDEL = "indel"
+
+
+class _RapidFuzzChainMixin(Chain):
+    """Shared methods for the rapidfuzz string distance evaluators."""
+
+    distance: StringDistance = Field(default=StringDistance.JARO_WINKLER)
+    normalize_score: bool = Field(default=True)
+    """Whether to normalize the score to a value between 0 and 1.
+    Applies only to the Levenshtein and Damerau-Levenshtein distances."""
+
+    @root_validator
+    def validate_dependencies(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Validate that the rapidfuzz library is installed.
+
+        Args:
+            values (Dict[str, Any]): The input values.
+
+        Returns:
+            Dict[str, Any]: The validated values.
+        """
+        _load_rapidfuzz()
+        return values
+
+    @property
+    def output_keys(self) -> List[str]:
+        """
+        Get the output keys.
+
+        Returns:
+            List[str]: The output keys.
+        """
+        return ["score"]
+
+    def _prepare_output(self, result: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Prepare the output dictionary.
+
+        Args:
+            result (Dict[str, Any]): The evaluation results.
+
+        Returns:
+            Dict[str, Any]: The prepared output dictionary.
+        """
+        result = {"score": result["score"]}
+        if RUN_KEY in result:
+            result[RUN_KEY] = result[RUN_KEY].dict()
+        return result
+
+    @staticmethod
+    def _get_metric(distance: str, normalize_score: bool = False) -> Callable:
+        """
+        Get the distance metric function based on the distance type.
+
+        Args:
+            distance (str): The distance type.
+
+        Returns:
+            Callable: The distance metric function.
+
+        Raises:
+            ValueError: If the distance metric is invalid.
+        """
+        from rapidfuzz import distance as rf_distance
+
+        module_map: Dict[str, Any] = {
+            StringDistance.DAMERAU_LEVENSHTEIN: rf_distance.DamerauLevenshtein,
+            StringDistance.LEVENSHTEIN: rf_distance.Levenshtein,
+            StringDistance.JARO: rf_distance.Jaro,
+            StringDistance.JARO_WINKLER: rf_distance.JaroWinkler,
+            StringDistance.HAMMING: rf_distance.Hamming,
+            StringDistance.INDEL: rf_distance.Indel,
+        }
+        if distance not in module_map:
+            raise ValueError(
+                f"Invalid distance metric: {distance}"
+                f"\nMust be one of: {list(StringDistance)}"
+            )
+        module = module_map[distance]
+        if normalize_score:
+            return module.normalized_distance
+        else:
+            return module.distance
+
+    @property
+    def metric(self) -> Callable:
+        """
+        Get the distance metric function.
+
+        Returns:
+            Callable: The distance metric function.
+        """
+        return _RapidFuzzChainMixin._get_metric(
+            self.distance, normalize_score=self.normalize_score
+        )
+
+    def compute_metric(self, a: str, b: str) -> float:
+        """
+        Compute the distance between two strings.
+
+        Args:
+            a (str): The first string.
+            b (str): The second string.
+
+        Returns:
+            float: The distance between the two strings.
+        """
+        return self.metric(a, b)
+
+
+class StringDistanceEvalChain(StringEvaluator, _RapidFuzzChainMixin):
+    """Compute string distances between the prediction and the reference.
+
+    Examples
+    ----------
+
+    >>> from langchain.evaluation import StringDistanceEvalChain
+    >>> evaluator = StringDistanceEvalChain()
+    >>> evaluator.evaluate_strings(
+            prediction="Mindy is the CTO",
+            reference="Mindy is the CEO",
+        )
+
+    Using the `load_evaluator` function:
+
+    >>> from langchain.evaluation import load_evaluator
+    >>> evaluator = load_evaluator("string_distance")
+    >>> evaluator.evaluate_strings(
+            prediction="The answer is three",
+            reference="three",
+        )
+    """
+
+    @property
+    def requires_input(self) -> bool:
+        """
+        This evaluator does not require input.
+        """
+        return False
+
+    @property
+    def requires_reference(self) -> bool:
+        """
+        This evaluator does not require a reference.
+        """
+        return True
+
+    @property
+    def input_keys(self) -> List[str]:
+        """
+        Get the input keys.
+
+        Returns:
+            List[str]: The input keys.
+        """
+        return ["reference", "prediction"]
+
+    @property
+    def evaluation_name(self) -> str:
+        """
+        Get the evaluation name.
+
+        Returns:
+            str: The evaluation name.
+        """
+        return f"{self.distance.value}_distance"
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """
+        Compute the string distance between the prediction and the reference.
+
+        Args:
+            inputs (Dict[str, Any]): The input values.
+            run_manager (Optional[CallbackManagerForChainRun]):
+                The callback manager.
+
+        Returns:
+            Dict[str, Any]: The evaluation results containing the score.
+        """
+        return {"score": self.compute_metric(inputs["reference"], inputs["prediction"])}
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """
+        Asynchronously compute the string distance between the prediction
+            and the reference.
+
+        Args:
+            inputs (Dict[str, Any]): The input values.
+            run_manager (Optional[AsyncCallbackManagerForChainRun]:
+                The callback manager.
+
+        Returns:
+            Dict[str, Any]: The evaluation results containing the score.
+        """
+        return {"score": self.compute_metric(inputs["reference"], inputs["prediction"])}
+
+    def _evaluate_strings(
+        self,
+        *,
+        prediction: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """
+        Evaluate the string distance between the prediction and the reference.
+
+        Args:
+            prediction (str): The prediction string.
+            reference (Optional[str], optional): The reference string.
+            input (Optional[str], optional): The input string.
+            callbacks (Callbacks, optional): The callbacks to use.
+            **kwargs: Additional keyword arguments.
+
+        Returns:
+            dict: The evaluation results containing the score.
+        """
+        result = self(
+            inputs={"prediction": prediction, "reference": reference},
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+
+        return self._prepare_output(result)
+
+    async def _aevaluate_strings(
+        self,
+        *,
+        prediction: str,
+        reference: Optional[str] = None,
+        input: Optional[str] = None,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """
+        Asynchronously evaluate the string distance between the
+            prediction and the reference.
+
+        Args:
+            prediction (str): The prediction string.
+            reference (Optional[str], optional): The reference string.
+            input (Optional[str], optional): The input string.
+            callbacks (Callbacks, optional): The callbacks to use.
+            **kwargs: Additional keyword arguments.
+
+        Returns:
+            dict: The evaluation results containing the score.
+        """
+        result = await self.acall(
+            inputs={"prediction": prediction, "reference": reference},
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+
+class PairwiseStringDistanceEvalChain(PairwiseStringEvaluator, _RapidFuzzChainMixin):
+    """Compute string edit distances between two predictions."""
+
+    @property
+    def input_keys(self) -> List[str]:
+        """
+        Get the input keys.
+
+        Returns:
+            List[str]: The input keys.
+        """
+        return ["prediction", "prediction_b"]
+
+    @property
+    def evaluation_name(self) -> str:
+        """
+        Get the evaluation name.
+
+        Returns:
+            str: The evaluation name.
+        """
+        return f"pairwise_{self.distance.value}_distance"
+
+    def _call(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """
+        Compute the string distance between two predictions.
+
+        Args:
+            inputs (Dict[str, Any]): The input values.
+            run_manager (CallbackManagerForChainRun , optional):
+                The callback manager.
+
+        Returns:
+            Dict[str, Any]: The evaluation results containing the score.
+        """
+        return {
+            "score": self.compute_metric(inputs["prediction"], inputs["prediction_b"])
+        }
+
+    async def _acall(
+        self,
+        inputs: Dict[str, Any],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """
+        Asynchronously compute the string distance between two predictions.
+
+        Args:
+            inputs (Dict[str, Any]): The input values.
+            run_manager (AsyncCallbackManagerForChainRun , optional):
+                The callback manager.
+
+        Returns:
+            Dict[str, Any]: The evaluation results containing the score.
+        """
+        return {
+            "score": self.compute_metric(inputs["prediction"], inputs["prediction_b"])
+        }
+
+    def _evaluate_string_pairs(
+        self,
+        *,
+        prediction: str,
+        prediction_b: str,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """
+        Evaluate the string distance between two predictions.
+
+        Args:
+            prediction (str): The first prediction string.
+            prediction_b (str): The second prediction string.
+            callbacks (Callbacks, optional): The callbacks to use.
+            tags (List[str], optional): Tags to apply to traces.
+            metadata (Dict[str, Any], optional): Metadata to apply to traces.
+            **kwargs: Additional keyword arguments.
+
+        Returns:
+            dict: The evaluation results containing the score.
+        """
+        result = self(
+            inputs={"prediction": prediction, "prediction_b": prediction_b},
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
+
+    async def _aevaluate_string_pairs(
+        self,
+        *,
+        prediction: str,
+        prediction_b: str,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        include_run_info: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        """
+        Asynchronously evaluate the string distance between two predictions.
+
+        Args:
+            prediction (str): The first prediction string.
+            prediction_b (str): The second prediction string.
+            callbacks (Callbacks, optional): The callbacks to use.
+            tags (List[str], optional): Tags to apply to traces.
+            metadata (Dict[str, Any], optional): Metadata to apply to traces.
+            **kwargs: Additional keyword arguments.
+
+        Returns:
+            dict: The evaluation results containing the score.
+        """
+        result = await self.acall(
+            inputs={"prediction": prediction, "prediction_b": prediction_b},
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            include_run_info=include_run_info,
+        )
+        return self._prepare_output(result)
diff --git a/llm/Lib/site-packages/langchain/example_generator.py b/llm/Lib/site-packages/langchain/example_generator.py
new file mode 100644
index 0000000000000000000000000000000000000000..2d11be8bf16e9d1102ec6958e3ff48d5b118db88
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/example_generator.py
@@ -0,0 +1,4 @@
+"""Keep here for backwards compatibility."""
+from langchain.chains.example_generator import generate_example
+
+__all__ = ["generate_example"]
diff --git a/llm/Lib/site-packages/langchain/formatting.py b/llm/Lib/site-packages/langchain/formatting.py
new file mode 100644
index 0000000000000000000000000000000000000000..26193f4667632911865f06c17d9b7c507e054433
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/formatting.py
@@ -0,0 +1,4 @@
+"""DEPRECATED: Kept for backwards compatibility."""
+from langchain_core.utils.formatting import StrictFormatter, formatter
+
+__all__ = ["StrictFormatter", "formatter"]
diff --git a/llm/Lib/site-packages/langchain/globals/__init__.py b/llm/Lib/site-packages/langchain/globals/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..77aa6662da8720052b09fb82e87de02870934f9c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/globals/__init__.py
@@ -0,0 +1,178 @@
+"""Global values and configuration that apply to all of LangChain."""
+import warnings
+from typing import TYPE_CHECKING, Optional
+
+if TYPE_CHECKING:
+    from langchain_core.caches import BaseCache
+
+
+# DO NOT USE THESE VALUES DIRECTLY!
+# Use them only via `get_<X>()` and `set_<X>()` below,
+# or else your code may behave unexpectedly with other uses of these global settings:
+# https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+_verbose: bool = False
+_debug: bool = False
+_llm_cache: Optional["BaseCache"] = None
+
+
+def set_verbose(value: bool) -> None:
+    """Set a new value for the `verbose` global setting."""
+    import langchain
+
+    # We're about to run some deprecated code, don't report warnings from it.
+    # The user called the correct (non-deprecated) code path and shouldn't get warnings.
+    with warnings.catch_warnings():
+        warnings.filterwarnings(
+            "ignore",
+            message=(
+                "Importing verbose from langchain root module is no longer supported"
+            ),
+        )
+        # N.B.: This is a workaround for an unfortunate quirk of Python's
+        #       module-level `__getattr__()` implementation:
+        # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+        #
+        # Remove it once `langchain.verbose` is no longer supported, and once all users
+        # have migrated to using `set_verbose()` here.
+        langchain.verbose = value
+
+    global _verbose
+    _verbose = value
+
+
+def get_verbose() -> bool:
+    """Get the value of the `verbose` global setting."""
+    import langchain
+
+    # We're about to run some deprecated code, don't report warnings from it.
+    # The user called the correct (non-deprecated) code path and shouldn't get warnings.
+    with warnings.catch_warnings():
+        warnings.filterwarnings(
+            "ignore",
+            message=(
+                "Importing verbose from langchain root module is no longer supported"
+            ),
+        )
+        # N.B.: This is a workaround for an unfortunate quirk of Python's
+        #       module-level `__getattr__()` implementation:
+        # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+        #
+        # Remove it once `langchain.verbose` is no longer supported, and once all users
+        # have migrated to using `set_verbose()` here.
+        #
+        # In the meantime, the `verbose` setting is considered True if either the old
+        # or the new value are True. This accommodates users who haven't migrated
+        # to using `set_verbose()` yet. Those users are getting deprecation warnings
+        # directing them to use `set_verbose()` when they import `langhchain.verbose`.
+        old_verbose = langchain.verbose
+
+    global _verbose
+    return _verbose or old_verbose
+
+
+def set_debug(value: bool) -> None:
+    """Set a new value for the `debug` global setting."""
+    import langchain
+
+    # We're about to run some deprecated code, don't report warnings from it.
+    # The user called the correct (non-deprecated) code path and shouldn't get warnings.
+    with warnings.catch_warnings():
+        warnings.filterwarnings(
+            "ignore",
+            message="Importing debug from langchain root module is no longer supported",
+        )
+        # N.B.: This is a workaround for an unfortunate quirk of Python's
+        #       module-level `__getattr__()` implementation:
+        # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+        #
+        # Remove it once `langchain.debug` is no longer supported, and once all users
+        # have migrated to using `set_debug()` here.
+        langchain.debug = value
+
+    global _debug
+    _debug = value
+
+
+def get_debug() -> bool:
+    """Get the value of the `debug` global setting."""
+    import langchain
+
+    # We're about to run some deprecated code, don't report warnings from it.
+    # The user called the correct (non-deprecated) code path and shouldn't get warnings.
+    with warnings.catch_warnings():
+        warnings.filterwarnings(
+            "ignore",
+            message="Importing debug from langchain root module is no longer supported",
+        )
+        # N.B.: This is a workaround for an unfortunate quirk of Python's
+        #       module-level `__getattr__()` implementation:
+        # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+        #
+        # Remove it once `langchain.debug` is no longer supported, and once all users
+        # have migrated to using `set_debug()` here.
+        #
+        # In the meantime, the `debug` setting is considered True if either the old
+        # or the new value are True. This accommodates users who haven't migrated
+        # to using `set_debug()` yet. Those users are getting deprecation warnings
+        # directing them to use `set_debug()` when they import `langhchain.debug`.
+        old_debug = langchain.debug
+
+    global _debug
+    return _debug or old_debug
+
+
+def set_llm_cache(value: Optional["BaseCache"]) -> None:
+    """Set a new LLM cache, overwriting the previous value, if any."""
+    import langchain
+
+    # We're about to run some deprecated code, don't report warnings from it.
+    # The user called the correct (non-deprecated) code path and shouldn't get warnings.
+    with warnings.catch_warnings():
+        warnings.filterwarnings(
+            "ignore",
+            message=(
+                "Importing llm_cache from langchain root module is no longer supported"
+            ),
+        )
+        # N.B.: This is a workaround for an unfortunate quirk of Python's
+        #       module-level `__getattr__()` implementation:
+        # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+        #
+        # Remove it once `langchain.llm_cache` is no longer supported, and
+        # once all users have migrated to using `set_llm_cache()` here.
+        langchain.llm_cache = value
+
+    global _llm_cache
+    _llm_cache = value
+
+
+def get_llm_cache() -> "BaseCache":
+    """Get the value of the `llm_cache` global setting."""
+    import langchain
+
+    # We're about to run some deprecated code, don't report warnings from it.
+    # The user called the correct (non-deprecated) code path and shouldn't get warnings.
+    with warnings.catch_warnings():
+        warnings.filterwarnings(
+            "ignore",
+            message=(
+                "Importing llm_cache from langchain root module is no longer supported"
+            ),
+        )
+        # N.B.: This is a workaround for an unfortunate quirk of Python's
+        #       module-level `__getattr__()` implementation:
+        # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+        #
+        # Remove it once `langchain.llm_cache` is no longer supported, and
+        # once all users have migrated to using `set_llm_cache()` here.
+        #
+        # In the meantime, the `llm_cache` setting returns whichever of
+        # its two backing sources is truthy (not `None` and non-empty),
+        # or the old value if both are falsy. This accommodates users
+        # who haven't migrated to using `set_llm_cache()` yet.
+        # Those users are getting deprecation warnings directing them
+        # to use `set_llm_cache()` when they import `langhchain.llm_cache`.
+        old_llm_cache = langchain.llm_cache
+
+    global _llm_cache
+    return _llm_cache or old_llm_cache
diff --git a/llm/Lib/site-packages/langchain/globals/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/globals/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..559e28eadac5e1926bdd1b4f6bb2d7bd4c6d16d1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/globals/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/__init__.py b/llm/Lib/site-packages/langchain/graphs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3189534975ee92ad5b84b9923993f78b45935e0b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/graphs/__init__.py
@@ -0,0 +1,38 @@
+"""**Graphs** provide a natural language interface to graph databases."""
+import warnings
+from typing import Any
+
+from langchain_core._api import LangChainDeprecationWarning
+
+from langchain.utils.interactive_env import is_interactive_env
+
+
+def __getattr__(name: str) -> Any:
+    from langchain_community import graphs
+
+    # If not in interactive env, raise warning.
+    if not is_interactive_env():
+        warnings.warn(
+            "Importing graphs from langchain is deprecated. Importing from "
+            "langchain will no longer be supported as of langchain==0.2.0. "
+            "Please import from langchain-community instead:\n\n"
+            f"`from langchain_community.graphs import {name}`.\n\n"
+            "To install langchain-community run `pip install -U langchain-community`.",
+            category=LangChainDeprecationWarning,
+        )
+
+    return getattr(graphs, name)
+
+
+__all__ = [
+    "MemgraphGraph",
+    "NetworkxEntityGraph",
+    "Neo4jGraph",
+    "NebulaGraph",
+    "NeptuneGraph",
+    "KuzuGraph",
+    "HugeGraph",
+    "RdfGraph",
+    "ArangoGraph",
+    "FalkorDBGraph",
+]
diff --git a/llm/Lib/site-packages/langchain/graphs/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/graphs/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a7a337a5a4f7d8e3c55c61ba1e48e59303413e0a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/graphs/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/__pycache__/arangodb_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain/graphs/__pycache__/arangodb_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6b4f8c86fa621925b116745bba359c8428b8eef5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/graphs/__pycache__/arangodb_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/__pycache__/falkordb_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain/graphs/__pycache__/falkordb_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f32f44857a1bba0d5a89ec55a5f89d340c258cde
Binary files /dev/null and b/llm/Lib/site-packages/langchain/graphs/__pycache__/falkordb_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/__pycache__/graph_document.cpython-311.pyc b/llm/Lib/site-packages/langchain/graphs/__pycache__/graph_document.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3b377efdf8b68fd9897ceeb8e3d16134bab91774
Binary files /dev/null and b/llm/Lib/site-packages/langchain/graphs/__pycache__/graph_document.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/__pycache__/graph_store.cpython-311.pyc b/llm/Lib/site-packages/langchain/graphs/__pycache__/graph_store.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..464ef998871106afe9a41c0fcaf794d7fd2181c1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/graphs/__pycache__/graph_store.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/__pycache__/hugegraph.cpython-311.pyc b/llm/Lib/site-packages/langchain/graphs/__pycache__/hugegraph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eb6c77b4f8c7e8f7a0cb148abb2512e628f542b2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/graphs/__pycache__/hugegraph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/__pycache__/kuzu_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain/graphs/__pycache__/kuzu_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1054ce46b31a12864284bc0d26722aea6ca25632
Binary files /dev/null and b/llm/Lib/site-packages/langchain/graphs/__pycache__/kuzu_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/__pycache__/memgraph_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain/graphs/__pycache__/memgraph_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b218f26bbc71e0b5bfb4423855e3af1291c2cc49
Binary files /dev/null and b/llm/Lib/site-packages/langchain/graphs/__pycache__/memgraph_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/__pycache__/nebula_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain/graphs/__pycache__/nebula_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..152a30dd1b0e7d83fdb4e955168c4bdb7bf1f704
Binary files /dev/null and b/llm/Lib/site-packages/langchain/graphs/__pycache__/nebula_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/__pycache__/neo4j_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain/graphs/__pycache__/neo4j_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1e5000d810e7fd4c390a12e8925dea61acef9212
Binary files /dev/null and b/llm/Lib/site-packages/langchain/graphs/__pycache__/neo4j_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/__pycache__/neptune_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain/graphs/__pycache__/neptune_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f890f58e6f9c4d3429b8e692f114ba451253ed45
Binary files /dev/null and b/llm/Lib/site-packages/langchain/graphs/__pycache__/neptune_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/__pycache__/networkx_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain/graphs/__pycache__/networkx_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..510053e60ea329e3e71ef2d9d15f3d3312ef7f33
Binary files /dev/null and b/llm/Lib/site-packages/langchain/graphs/__pycache__/networkx_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/__pycache__/rdf_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain/graphs/__pycache__/rdf_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..923df61694a34e90a4b8c2e442189885bb5a140b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/graphs/__pycache__/rdf_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/graphs/arangodb_graph.py b/llm/Lib/site-packages/langchain/graphs/arangodb_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..9ef5f7e7baeef8f5b5fae3a85a6b72c7d5e0ea04
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/graphs/arangodb_graph.py
@@ -0,0 +1,6 @@
+from langchain_community.graphs.arangodb_graph import ArangoGraph, get_arangodb_client
+
+__all__ = [
+    "ArangoGraph",
+    "get_arangodb_client",
+]
diff --git a/llm/Lib/site-packages/langchain/graphs/falkordb_graph.py b/llm/Lib/site-packages/langchain/graphs/falkordb_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..61318eb392137e1e021550955d6ad848357b0a39
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/graphs/falkordb_graph.py
@@ -0,0 +1,7 @@
+from langchain_community.graphs.falkordb_graph import (
+    FalkorDBGraph,
+)
+
+__all__ = [
+    "FalkorDBGraph",
+]
diff --git a/llm/Lib/site-packages/langchain/graphs/graph_document.py b/llm/Lib/site-packages/langchain/graphs/graph_document.py
new file mode 100644
index 0000000000000000000000000000000000000000..3704b1b7d1ae59b904aa33d57be3da97876ecb31
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/graphs/graph_document.py
@@ -0,0 +1,3 @@
+from langchain_community.graphs.graph_document import GraphDocument, Node, Relationship
+
+__all__ = ["Node", "Relationship", "GraphDocument"]
diff --git a/llm/Lib/site-packages/langchain/graphs/graph_store.py b/llm/Lib/site-packages/langchain/graphs/graph_store.py
new file mode 100644
index 0000000000000000000000000000000000000000..78b1074362e8e6de9034eccd085bbc3838cc9364
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/graphs/graph_store.py
@@ -0,0 +1,3 @@
+from langchain_community.graphs.graph_store import GraphStore
+
+__all__ = ["GraphStore"]
diff --git a/llm/Lib/site-packages/langchain/graphs/hugegraph.py b/llm/Lib/site-packages/langchain/graphs/hugegraph.py
new file mode 100644
index 0000000000000000000000000000000000000000..d50ccbbde4ce8b548266d316e1410e681f032117
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/graphs/hugegraph.py
@@ -0,0 +1,3 @@
+from langchain_community.graphs.hugegraph import HugeGraph
+
+__all__ = ["HugeGraph"]
diff --git a/llm/Lib/site-packages/langchain/graphs/kuzu_graph.py b/llm/Lib/site-packages/langchain/graphs/kuzu_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..1c6c06b0b79960ffec07d486fe9f15f09708eebd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/graphs/kuzu_graph.py
@@ -0,0 +1,3 @@
+from langchain_community.graphs.kuzu_graph import KuzuGraph
+
+__all__ = ["KuzuGraph"]
diff --git a/llm/Lib/site-packages/langchain/graphs/memgraph_graph.py b/llm/Lib/site-packages/langchain/graphs/memgraph_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..568d88e7f346f8bdd12847e64afb5e8fd84c2230
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/graphs/memgraph_graph.py
@@ -0,0 +1,5 @@
+from langchain_community.graphs.memgraph_graph import (
+    MemgraphGraph,
+)
+
+__all__ = ["MemgraphGraph"]
diff --git a/llm/Lib/site-packages/langchain/graphs/nebula_graph.py b/llm/Lib/site-packages/langchain/graphs/nebula_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..a5cae8edf474f95978cabf58256728695360f7b5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/graphs/nebula_graph.py
@@ -0,0 +1,3 @@
+from langchain_community.graphs.nebula_graph import NebulaGraph
+
+__all__ = ["NebulaGraph"]
diff --git a/llm/Lib/site-packages/langchain/graphs/neo4j_graph.py b/llm/Lib/site-packages/langchain/graphs/neo4j_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..8bdce3ba66632a8de7f0ab9f80d621984ab909a8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/graphs/neo4j_graph.py
@@ -0,0 +1,5 @@
+from langchain_community.graphs.neo4j_graph import (
+    Neo4jGraph,
+)
+
+__all__ = ["Neo4jGraph"]
diff --git a/llm/Lib/site-packages/langchain/graphs/neptune_graph.py b/llm/Lib/site-packages/langchain/graphs/neptune_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc7c4847d86d3f3a0c801e9f132f397714eccb6a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/graphs/neptune_graph.py
@@ -0,0 +1,3 @@
+from langchain_community.graphs.neptune_graph import NeptuneGraph
+
+__all__ = ["NeptuneGraph"]
diff --git a/llm/Lib/site-packages/langchain/graphs/networkx_graph.py b/llm/Lib/site-packages/langchain/graphs/networkx_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..3795a82799bc0b12c74f517547169bb97abbd9e2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/graphs/networkx_graph.py
@@ -0,0 +1,15 @@
+from langchain_community.graphs.networkx_graph import (
+    KG_TRIPLE_DELIMITER,
+    KnowledgeTriple,
+    NetworkxEntityGraph,
+    get_entities,
+    parse_triples,
+)
+
+__all__ = [
+    "KG_TRIPLE_DELIMITER",
+    "KnowledgeTriple",
+    "parse_triples",
+    "get_entities",
+    "NetworkxEntityGraph",
+]
diff --git a/llm/Lib/site-packages/langchain/graphs/rdf_graph.py b/llm/Lib/site-packages/langchain/graphs/rdf_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..b08ed2264f010da8e7afafd1a54581c16e850495
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/graphs/rdf_graph.py
@@ -0,0 +1,7 @@
+from langchain_community.graphs.rdf_graph import (
+    RdfGraph,
+)
+
+__all__ = [
+    "RdfGraph",
+]
diff --git a/llm/Lib/site-packages/langchain/hub.py b/llm/Lib/site-packages/langchain/hub.py
new file mode 100644
index 0000000000000000000000000000000000000000..3dd15404d200142c9cfcb803dcfff0edfa9de660
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/hub.py
@@ -0,0 +1,98 @@
+"""Interface with the LangChain Hub."""
+
+from __future__ import annotations
+
+import json
+from typing import TYPE_CHECKING, Any, Optional
+
+from langchain_core.load.dump import dumps
+from langchain_core.load.load import loads
+from langchain_core.prompts import BasePromptTemplate
+
+if TYPE_CHECKING:
+    from langchainhub import Client
+
+
+def _get_client(api_url: Optional[str] = None, api_key: Optional[str] = None) -> Client:
+    try:
+        from langchainhub import Client
+    except ImportError as e:
+        raise ImportError(
+            "Could not import langchainhub, please install with `pip install "
+            "langchainhub`."
+        ) from e
+
+    # Client logic will also attempt to load URL/key from environment variables
+    return Client(api_url, api_key=api_key)
+
+
+def push(
+    repo_full_name: str,
+    object: Any,
+    *,
+    api_url: Optional[str] = None,
+    api_key: Optional[str] = None,
+    parent_commit_hash: Optional[str] = "latest",
+    new_repo_is_public: bool = True,
+    new_repo_description: str = "",
+) -> str:
+    """
+    Pushes an object to the hub and returns the URL it can be viewed at in a browser.
+
+    :param repo_full_name: The full name of the repo to push to in the format of
+        `owner/repo`.
+    :param object: The LangChain to serialize and push to the hub.
+    :param api_url: The URL of the LangChain Hub API. Defaults to the hosted API service
+        if you have an api key set, or a localhost instance if not.
+    :param api_key: The API key to use to authenticate with the LangChain Hub API.
+    :param parent_commit_hash: The commit hash of the parent commit to push to. Defaults
+        to the latest commit automatically.
+    :param new_repo_is_public: Whether the repo should be public. Defaults to
+        True (Public by default).
+    :param new_repo_description: The description of the repo. Defaults to an empty
+        string.
+    """
+    client = _get_client(api_url=api_url, api_key=api_key)
+    manifest_json = dumps(object)
+    message = client.push(
+        repo_full_name,
+        manifest_json,
+        parent_commit_hash=parent_commit_hash,
+        new_repo_is_public=new_repo_is_public,
+        new_repo_description=new_repo_description,
+    )
+    return message
+
+
+def pull(
+    owner_repo_commit: str,
+    *,
+    api_url: Optional[str] = None,
+    api_key: Optional[str] = None,
+) -> Any:
+    """
+    Pulls an object from the hub and returns it as a LangChain object.
+
+    :param owner_repo_commit: The full name of the repo to pull from in the format of
+        `owner/repo:commit_hash`.
+    :param api_url: The URL of the LangChain Hub API. Defaults to the hosted API service
+        if you have an api key set, or a localhost instance if not.
+    :param api_key: The API key to use to authenticate with the LangChain Hub API.
+    """
+    client = _get_client(api_url=api_url, api_key=api_key)
+
+    if hasattr(client, "pull_repo"):
+        # >= 0.1.15
+        res_dict = client.pull_repo(owner_repo_commit)
+        obj = loads(json.dumps(res_dict["manifest"]))
+        if isinstance(obj, BasePromptTemplate):
+            if obj.metadata is None:
+                obj.metadata = {}
+            obj.metadata["lc_hub_owner"] = res_dict["owner"]
+            obj.metadata["lc_hub_repo"] = res_dict["repo"]
+            obj.metadata["lc_hub_commit_hash"] = res_dict["commit_hash"]
+        return obj
+
+    # Then it's < 0.1.15
+    resp: str = client.pull(owner_repo_commit)
+    return loads(resp)
diff --git a/llm/Lib/site-packages/langchain/indexes/__init__.py b/llm/Lib/site-packages/langchain/indexes/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..02e766b02b39be4f76b1e9c30b7f925541b43043
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/indexes/__init__.py
@@ -0,0 +1,27 @@
+"""**Index** is used to avoid writing duplicated content
+into the vectostore and to avoid over-writing content if it's unchanged.
+
+Indexes also :
+
+* Create knowledge graphs from data.
+
+* Support indexing workflows from LangChain data loaders to vectorstores.
+
+Importantly, Index keeps on working even if the content being written is derived
+via a set of transformations from some source content (e.g., indexing children
+documents that were derived from parent documents by chunking.)
+"""
+from langchain.indexes._api import IndexingResult, aindex, index
+from langchain.indexes._sql_record_manager import SQLRecordManager
+from langchain.indexes.graph import GraphIndexCreator
+from langchain.indexes.vectorstore import VectorstoreIndexCreator
+
+__all__ = [
+    # Keep sorted
+    "aindex",
+    "GraphIndexCreator",
+    "index",
+    "IndexingResult",
+    "SQLRecordManager",
+    "VectorstoreIndexCreator",
+]
diff --git a/llm/Lib/site-packages/langchain/indexes/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/indexes/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f0fe531aef66cb53ba992e005434efd8d6c46278
Binary files /dev/null and b/llm/Lib/site-packages/langchain/indexes/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/indexes/__pycache__/_api.cpython-311.pyc b/llm/Lib/site-packages/langchain/indexes/__pycache__/_api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..61b5370a9e6a723453472cc2b16cb1a8f9dfb55f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/indexes/__pycache__/_api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/indexes/__pycache__/_sql_record_manager.cpython-311.pyc b/llm/Lib/site-packages/langchain/indexes/__pycache__/_sql_record_manager.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8d5dbc30dd0b49072f683688b0da0f38460a9e07
Binary files /dev/null and b/llm/Lib/site-packages/langchain/indexes/__pycache__/_sql_record_manager.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/indexes/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/indexes/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2b6e51eb09dc1311a8532e6de723be27a23d858f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/indexes/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/indexes/__pycache__/graph.cpython-311.pyc b/llm/Lib/site-packages/langchain/indexes/__pycache__/graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f80946299180e8be8b2b65bf86091471d28cc037
Binary files /dev/null and b/llm/Lib/site-packages/langchain/indexes/__pycache__/graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/indexes/__pycache__/vectorstore.cpython-311.pyc b/llm/Lib/site-packages/langchain/indexes/__pycache__/vectorstore.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..628e9a8d8612b26c4c65ea5535cf0b424821f0ca
Binary files /dev/null and b/llm/Lib/site-packages/langchain/indexes/__pycache__/vectorstore.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/indexes/_api.py b/llm/Lib/site-packages/langchain/indexes/_api.py
new file mode 100644
index 0000000000000000000000000000000000000000..f41a221795abf59c661e8d37ab149e37e37050b6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/indexes/_api.py
@@ -0,0 +1,600 @@
+"""Module contains logic for indexing documents into vector stores."""
+from __future__ import annotations
+
+import hashlib
+import json
+import uuid
+from itertools import islice
+from typing import (
+    Any,
+    AsyncIterable,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Literal,
+    Optional,
+    Sequence,
+    Set,
+    TypedDict,
+    TypeVar,
+    Union,
+    cast,
+)
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.vectorstores import VectorStore
+
+from langchain.indexes.base import NAMESPACE_UUID, RecordManager
+
+T = TypeVar("T")
+
+
+def _hash_string_to_uuid(input_string: str) -> uuid.UUID:
+    """Hashes a string and returns the corresponding UUID."""
+    hash_value = hashlib.sha1(input_string.encode("utf-8")).hexdigest()
+    return uuid.uuid5(NAMESPACE_UUID, hash_value)
+
+
+def _hash_nested_dict_to_uuid(data: dict[Any, Any]) -> uuid.UUID:
+    """Hashes a nested dictionary and returns the corresponding UUID."""
+    serialized_data = json.dumps(data, sort_keys=True)
+    hash_value = hashlib.sha1(serialized_data.encode("utf-8")).hexdigest()
+    return uuid.uuid5(NAMESPACE_UUID, hash_value)
+
+
+class _HashedDocument(Document):
+    """A hashed document with a unique ID."""
+
+    uid: str
+    hash_: str
+    """The hash of the document including content and metadata."""
+    content_hash: str
+    """The hash of the document content."""
+    metadata_hash: str
+    """The hash of the document metadata."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @root_validator(pre=True)
+    def calculate_hashes(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Root validator to calculate content and metadata hash."""
+        content = values.get("page_content", "")
+        metadata = values.get("metadata", {})
+
+        forbidden_keys = ("hash_", "content_hash", "metadata_hash")
+
+        for key in forbidden_keys:
+            if key in metadata:
+                raise ValueError(
+                    f"Metadata cannot contain key {key} as it "
+                    f"is reserved for internal use."
+                )
+
+        content_hash = str(_hash_string_to_uuid(content))
+
+        try:
+            metadata_hash = str(_hash_nested_dict_to_uuid(metadata))
+        except Exception as e:
+            raise ValueError(
+                f"Failed to hash metadata: {e}. "
+                f"Please use a dict that can be serialized using json."
+            )
+
+        values["content_hash"] = content_hash
+        values["metadata_hash"] = metadata_hash
+        values["hash_"] = str(_hash_string_to_uuid(content_hash + metadata_hash))
+
+        _uid = values.get("uid", None)
+
+        if _uid is None:
+            values["uid"] = values["hash_"]
+        return values
+
+    def to_document(self) -> Document:
+        """Return a Document object."""
+        return Document(
+            page_content=self.page_content,
+            metadata=self.metadata,
+        )
+
+    @classmethod
+    def from_document(
+        cls, document: Document, *, uid: Optional[str] = None
+    ) -> _HashedDocument:
+        """Create a HashedDocument from a Document."""
+        return cls(  # type: ignore[call-arg]
+            uid=uid,  # type: ignore[arg-type]
+            page_content=document.page_content,
+            metadata=document.metadata,
+        )
+
+
+def _batch(size: int, iterable: Iterable[T]) -> Iterator[List[T]]:
+    """Utility batching function."""
+    it = iter(iterable)
+    while True:
+        chunk = list(islice(it, size))
+        if not chunk:
+            return
+        yield chunk
+
+
+async def _abatch(size: int, iterable: AsyncIterable[T]) -> AsyncIterator[List[T]]:
+    """Utility batching function."""
+    batch: List[T] = []
+    async for element in iterable:
+        if len(batch) < size:
+            batch.append(element)
+
+        if len(batch) >= size:
+            yield batch
+            batch = []
+
+    if batch:
+        yield batch
+
+
+def _get_source_id_assigner(
+    source_id_key: Union[str, Callable[[Document], str], None],
+) -> Callable[[Document], Union[str, None]]:
+    """Get the source id from the document."""
+    if source_id_key is None:
+        return lambda doc: None
+    elif isinstance(source_id_key, str):
+        return lambda doc: doc.metadata[source_id_key]
+    elif callable(source_id_key):
+        return source_id_key
+    else:
+        raise ValueError(
+            f"source_id_key should be either None, a string or a callable. "
+            f"Got {source_id_key} of type {type(source_id_key)}."
+        )
+
+
+def _deduplicate_in_order(
+    hashed_documents: Iterable[_HashedDocument],
+) -> Iterator[_HashedDocument]:
+    """Deduplicate a list of hashed documents while preserving order."""
+    seen: Set[str] = set()
+
+    for hashed_doc in hashed_documents:
+        if hashed_doc.hash_ not in seen:
+            seen.add(hashed_doc.hash_)
+            yield hashed_doc
+
+
+# PUBLIC API
+
+
+class IndexingResult(TypedDict):
+    """Return a detailed a breakdown of the result of the indexing operation."""
+
+    num_added: int
+    """Number of added documents."""
+    num_updated: int
+    """Number of updated documents because they were not up to date."""
+    num_deleted: int
+    """Number of deleted documents."""
+    num_skipped: int
+    """Number of skipped documents because they were already up to date."""
+
+
+def index(
+    docs_source: Union[BaseLoader, Iterable[Document]],
+    record_manager: RecordManager,
+    vector_store: VectorStore,
+    *,
+    batch_size: int = 100,
+    cleanup: Literal["incremental", "full", None] = None,
+    source_id_key: Union[str, Callable[[Document], str], None] = None,
+    cleanup_batch_size: int = 1_000,
+    force_update: bool = False,
+) -> IndexingResult:
+    """Index data from the loader into the vector store.
+
+    Indexing functionality uses a manager to keep track of which documents
+    are in the vector store.
+
+    This allows us to keep track of which documents were updated, and which
+    documents were deleted, which documents should be skipped.
+
+    For the time being, documents are indexed using their hashes, and users
+     are not able to specify the uid of the document.
+
+    IMPORTANT:
+       if auto_cleanup is set to True, the loader should be returning
+       the entire dataset, and not just a subset of the dataset.
+       Otherwise, the auto_cleanup will remove documents that it is not
+       supposed to.
+
+    Args:
+        docs_source: Data loader or iterable of documents to index.
+        record_manager: Timestamped set to keep track of which documents were
+                         updated.
+        vector_store: Vector store to index the documents into.
+        batch_size: Batch size to use when indexing.
+        cleanup: How to handle clean up of documents.
+            - Incremental: Cleans up all documents that haven't been updated AND
+                           that are associated with source ids that were seen
+                           during indexing.
+                           Clean up is done continuously during indexing helping
+                           to minimize the probability of users seeing duplicated
+                           content.
+            - Full: Delete all documents that haven to been returned by the loader.
+                    Clean up runs after all documents have been indexed.
+                    This means that users may see duplicated content during indexing.
+            - None: Do not delete any documents.
+        source_id_key: Optional key that helps identify the original source
+            of the document.
+        cleanup_batch_size: Batch size to use when cleaning up documents.
+        force_update: Force update documents even if they are present in the
+            record manager. Useful if you are re-indexing with updated embeddings.
+
+    Returns:
+        Indexing result which contains information about how many documents
+        were added, updated, deleted, or skipped.
+    """
+    if cleanup not in {"incremental", "full", None}:
+        raise ValueError(
+            f"cleanup should be one of 'incremental', 'full' or None. "
+            f"Got {cleanup}."
+        )
+
+    if cleanup == "incremental" and source_id_key is None:
+        raise ValueError("Source id key is required when cleanup mode is incremental.")
+
+    # Check that the Vectorstore has required methods implemented
+    methods = ["delete", "add_documents"]
+
+    for method in methods:
+        if not hasattr(vector_store, method):
+            raise ValueError(
+                f"Vectorstore {vector_store} does not have required method {method}"
+            )
+
+    if type(vector_store).delete == VectorStore.delete:
+        # Checking if the vectorstore has overridden the default delete method
+        # implementation which just raises a NotImplementedError
+        raise ValueError("Vectorstore has not implemented the delete method")
+
+    if isinstance(docs_source, BaseLoader):
+        try:
+            doc_iterator = docs_source.lazy_load()
+        except NotImplementedError:
+            doc_iterator = iter(docs_source.load())
+    else:
+        doc_iterator = iter(docs_source)
+
+    source_id_assigner = _get_source_id_assigner(source_id_key)
+
+    # Mark when the update started.
+    index_start_dt = record_manager.get_time()
+    num_added = 0
+    num_skipped = 0
+    num_updated = 0
+    num_deleted = 0
+
+    for doc_batch in _batch(batch_size, doc_iterator):
+        hashed_docs = list(
+            _deduplicate_in_order(
+                [_HashedDocument.from_document(doc) for doc in doc_batch]
+            )
+        )
+
+        source_ids: Sequence[Optional[str]] = [
+            source_id_assigner(doc) for doc in hashed_docs
+        ]
+
+        if cleanup == "incremental":
+            # If the cleanup mode is incremental, source ids are required.
+            for source_id, hashed_doc in zip(source_ids, hashed_docs):
+                if source_id is None:
+                    raise ValueError(
+                        "Source ids are required when cleanup mode is incremental. "
+                        f"Document that starts with "
+                        f"content: {hashed_doc.page_content[:100]} was not assigned "
+                        f"as source id."
+                    )
+            # source ids cannot be None after for loop above.
+            source_ids = cast(Sequence[str], source_ids)  # type: ignore[assignment]
+
+        exists_batch = record_manager.exists([doc.uid for doc in hashed_docs])
+
+        # Filter out documents that already exist in the record store.
+        uids = []
+        docs_to_index = []
+        uids_to_refresh = []
+        seen_docs: Set[str] = set()
+        for hashed_doc, doc_exists in zip(hashed_docs, exists_batch):
+            if doc_exists:
+                if force_update:
+                    seen_docs.add(hashed_doc.uid)
+                else:
+                    uids_to_refresh.append(hashed_doc.uid)
+                    continue
+            uids.append(hashed_doc.uid)
+            docs_to_index.append(hashed_doc.to_document())
+
+        # Update refresh timestamp
+        if uids_to_refresh:
+            record_manager.update(uids_to_refresh, time_at_least=index_start_dt)
+            num_skipped += len(uids_to_refresh)
+
+        # Be pessimistic and assume that all vector store write will fail.
+        # First write to vector store
+        if docs_to_index:
+            vector_store.add_documents(docs_to_index, ids=uids, batch_size=batch_size)
+            num_added += len(docs_to_index) - len(seen_docs)
+            num_updated += len(seen_docs)
+
+        # And only then update the record store.
+        # Update ALL records, even if they already exist since we want to refresh
+        # their timestamp.
+        record_manager.update(
+            [doc.uid for doc in hashed_docs],
+            group_ids=source_ids,
+            time_at_least=index_start_dt,
+        )
+
+        # If source IDs are provided, we can do the deletion incrementally!
+        if cleanup == "incremental":
+            # Get the uids of the documents that were not returned by the loader.
+
+            # mypy isn't good enough to determine that source ids cannot be None
+            # here due to a check that's happening above, so we check again.
+            for source_id in source_ids:
+                if source_id is None:
+                    raise AssertionError("Source ids cannot be None here.")
+
+            _source_ids = cast(Sequence[str], source_ids)
+
+            uids_to_delete = record_manager.list_keys(
+                group_ids=_source_ids, before=index_start_dt
+            )
+            if uids_to_delete:
+                # Then delete from vector store.
+                vector_store.delete(uids_to_delete)
+                # First delete from record store.
+                record_manager.delete_keys(uids_to_delete)
+                num_deleted += len(uids_to_delete)
+
+    if cleanup == "full":
+        while uids_to_delete := record_manager.list_keys(
+            before=index_start_dt, limit=cleanup_batch_size
+        ):
+            # First delete from record store.
+            vector_store.delete(uids_to_delete)
+            # Then delete from record manager.
+            record_manager.delete_keys(uids_to_delete)
+            num_deleted += len(uids_to_delete)
+
+    return {
+        "num_added": num_added,
+        "num_updated": num_updated,
+        "num_skipped": num_skipped,
+        "num_deleted": num_deleted,
+    }
+
+
+# Define an asynchronous generator function
+async def _to_async_iterator(iterator: Iterable[T]) -> AsyncIterator[T]:
+    """Convert an iterable to an async iterator."""
+    for item in iterator:
+        yield item
+
+
+async def aindex(
+    docs_source: Union[BaseLoader, Iterable[Document], AsyncIterator[Document]],
+    record_manager: RecordManager,
+    vector_store: VectorStore,
+    *,
+    batch_size: int = 100,
+    cleanup: Literal["incremental", "full", None] = None,
+    source_id_key: Union[str, Callable[[Document], str], None] = None,
+    cleanup_batch_size: int = 1_000,
+    force_update: bool = False,
+) -> IndexingResult:
+    """Index data from the loader into the vector store.
+
+    Indexing functionality uses a manager to keep track of which documents
+    are in the vector store.
+
+    This allows us to keep track of which documents were updated, and which
+    documents were deleted, which documents should be skipped.
+
+    For the time being, documents are indexed using their hashes, and users
+     are not able to specify the uid of the document.
+
+    IMPORTANT:
+       if auto_cleanup is set to True, the loader should be returning
+       the entire dataset, and not just a subset of the dataset.
+       Otherwise, the auto_cleanup will remove documents that it is not
+       supposed to.
+
+    Args:
+        docs_source: Data loader or iterable of documents to index.
+        record_manager: Timestamped set to keep track of which documents were
+                         updated.
+        vector_store: Vector store to index the documents into.
+        batch_size: Batch size to use when indexing.
+        cleanup: How to handle clean up of documents.
+            - Incremental: Cleans up all documents that haven't been updated AND
+                           that are associated with source ids that were seen
+                           during indexing.
+                           Clean up is done continuously during indexing helping
+                           to minimize the probability of users seeing duplicated
+                           content.
+            - Full: Delete all documents that haven to been returned by the loader.
+                    Clean up runs after all documents have been indexed.
+                    This means that users may see duplicated content during indexing.
+            - None: Do not delete any documents.
+        source_id_key: Optional key that helps identify the original source
+            of the document.
+        cleanup_batch_size: Batch size to use when cleaning up documents.
+        force_update: Force update documents even if they are present in the
+            record manager. Useful if you are re-indexing with updated embeddings.
+
+    Returns:
+        Indexing result which contains information about how many documents
+        were added, updated, deleted, or skipped.
+    """
+
+    if cleanup not in {"incremental", "full", None}:
+        raise ValueError(
+            f"cleanup should be one of 'incremental', 'full' or None. "
+            f"Got {cleanup}."
+        )
+
+    if cleanup == "incremental" and source_id_key is None:
+        raise ValueError("Source id key is required when cleanup mode is incremental.")
+
+    # Check that the Vectorstore has required methods implemented
+    methods = ["adelete", "aadd_documents"]
+
+    for method in methods:
+        if not hasattr(vector_store, method):
+            raise ValueError(
+                f"Vectorstore {vector_store} does not have required method {method}"
+            )
+
+    if type(vector_store).adelete == VectorStore.adelete:
+        # Checking if the vectorstore has overridden the default delete method
+        # implementation which just raises a NotImplementedError
+        raise ValueError("Vectorstore has not implemented the delete method")
+
+    async_doc_iterator: AsyncIterator[Document]
+    if isinstance(docs_source, BaseLoader):
+        try:
+            async_doc_iterator = docs_source.alazy_load()
+        except NotImplementedError:
+            # Exception triggered when neither lazy_load nor alazy_load are implemented.
+            # * The default implementation of alazy_load uses lazy_load.
+            # * The default implementation of lazy_load raises NotImplementedError.
+            # In such a case, we use the load method and convert it to an async
+            # iterator.
+            async_doc_iterator = _to_async_iterator(docs_source.load())
+    else:
+        if hasattr(docs_source, "__aiter__"):
+            async_doc_iterator = docs_source  # type: ignore[assignment]
+        else:
+            async_doc_iterator = _to_async_iterator(docs_source)
+
+    source_id_assigner = _get_source_id_assigner(source_id_key)
+
+    # Mark when the update started.
+    index_start_dt = await record_manager.aget_time()
+    num_added = 0
+    num_skipped = 0
+    num_updated = 0
+    num_deleted = 0
+
+    async for doc_batch in _abatch(batch_size, async_doc_iterator):
+        hashed_docs = list(
+            _deduplicate_in_order(
+                [_HashedDocument.from_document(doc) for doc in doc_batch]
+            )
+        )
+
+        source_ids: Sequence[Optional[str]] = [
+            source_id_assigner(doc) for doc in hashed_docs
+        ]
+
+        if cleanup == "incremental":
+            # If the cleanup mode is incremental, source ids are required.
+            for source_id, hashed_doc in zip(source_ids, hashed_docs):
+                if source_id is None:
+                    raise ValueError(
+                        "Source ids are required when cleanup mode is incremental. "
+                        f"Document that starts with "
+                        f"content: {hashed_doc.page_content[:100]} was not assigned "
+                        f"as source id."
+                    )
+            # source ids cannot be None after for loop above.
+            source_ids = cast(Sequence[str], source_ids)
+
+        exists_batch = await record_manager.aexists([doc.uid for doc in hashed_docs])
+
+        # Filter out documents that already exist in the record store.
+        uids: list[str] = []
+        docs_to_index: list[Document] = []
+        uids_to_refresh = []
+        seen_docs: Set[str] = set()
+        for hashed_doc, doc_exists in zip(hashed_docs, exists_batch):
+            if doc_exists:
+                if force_update:
+                    seen_docs.add(hashed_doc.uid)
+                else:
+                    uids_to_refresh.append(hashed_doc.uid)
+                    continue
+            uids.append(hashed_doc.uid)
+            docs_to_index.append(hashed_doc.to_document())
+
+        if uids_to_refresh:
+            # Must be updated to refresh timestamp.
+            await record_manager.aupdate(uids_to_refresh, time_at_least=index_start_dt)
+            num_skipped += len(uids_to_refresh)
+
+        # Be pessimistic and assume that all vector store write will fail.
+        # First write to vector store
+        if docs_to_index:
+            await vector_store.aadd_documents(
+                docs_to_index, ids=uids, batch_size=batch_size
+            )
+            num_added += len(docs_to_index) - len(seen_docs)
+            num_updated += len(seen_docs)
+
+        # And only then update the record store.
+        # Update ALL records, even if they already exist since we want to refresh
+        # their timestamp.
+        await record_manager.aupdate(
+            [doc.uid for doc in hashed_docs],
+            group_ids=source_ids,
+            time_at_least=index_start_dt,
+        )
+
+        # If source IDs are provided, we can do the deletion incrementally!
+
+        if cleanup == "incremental":
+            # Get the uids of the documents that were not returned by the loader.
+
+            # mypy isn't good enough to determine that source ids cannot be None
+            # here due to a check that's happening above, so we check again.
+            for source_id in source_ids:
+                if source_id is None:
+                    raise AssertionError("Source ids cannot be None here.")
+
+            _source_ids = cast(Sequence[str], source_ids)
+
+            uids_to_delete = await record_manager.alist_keys(
+                group_ids=_source_ids, before=index_start_dt
+            )
+            if uids_to_delete:
+                # Then delete from vector store.
+                await vector_store.adelete(uids_to_delete)
+                # First delete from record store.
+                await record_manager.adelete_keys(uids_to_delete)
+                num_deleted += len(uids_to_delete)
+
+    if cleanup == "full":
+        while uids_to_delete := await record_manager.alist_keys(
+            before=index_start_dt, limit=cleanup_batch_size
+        ):
+            # First delete from record store.
+            await vector_store.adelete(uids_to_delete)
+            # Then delete from record manager.
+            await record_manager.adelete_keys(uids_to_delete)
+            num_deleted += len(uids_to_delete)
+
+    return {
+        "num_added": num_added,
+        "num_updated": num_updated,
+        "num_skipped": num_skipped,
+        "num_deleted": num_deleted,
+    }
diff --git a/llm/Lib/site-packages/langchain/indexes/_sql_record_manager.py b/llm/Lib/site-packages/langchain/indexes/_sql_record_manager.py
new file mode 100644
index 0000000000000000000000000000000000000000..435f34e11cc42ea9dc04832200e5799c96f49a78
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/indexes/_sql_record_manager.py
@@ -0,0 +1,518 @@
+"""Implementation of a record management layer in SQLAlchemy.
+
+The management layer uses SQLAlchemy to track upserted records.
+
+Currently, this layer only works with SQLite; hopwever, should be adaptable
+to other SQL implementations with minimal effort.
+
+Currently, includes an implementation that uses SQLAlchemy which should
+allow it to work with a variety of SQL as a backend.
+
+* Each key is associated with an updated_at field.
+* This filed is updated whenever the key is updated.
+* Keys can be listed based on the updated at field.
+* Keys can be deleted.
+"""
+import contextlib
+import decimal
+import uuid
+from typing import Any, AsyncGenerator, Dict, Generator, List, Optional, Sequence, Union
+
+from sqlalchemy import (
+    URL,
+    Column,
+    Engine,
+    Float,
+    Index,
+    String,
+    UniqueConstraint,
+    and_,
+    create_engine,
+    delete,
+    select,
+    text,
+)
+from sqlalchemy.ext.asyncio import (
+    AsyncEngine,
+    AsyncSession,
+    async_sessionmaker,
+    create_async_engine,
+)
+from sqlalchemy.ext.declarative import declarative_base
+from sqlalchemy.orm import Query, Session, sessionmaker
+
+from langchain.indexes.base import RecordManager
+
+Base = declarative_base()
+
+
+class UpsertionRecord(Base):  # type: ignore[valid-type,misc]
+    """Table used to keep track of when a key was last updated."""
+
+    # ATTENTION:
+    # Prior to modifying this table, please determine whether
+    # we should create migrations for this table to make sure
+    # users do not experience data loss.
+    __tablename__ = "upsertion_record"
+
+    uuid = Column(
+        String,
+        index=True,
+        default=lambda: str(uuid.uuid4()),
+        primary_key=True,
+        nullable=False,
+    )
+    key = Column(String, index=True)
+    # Using a non-normalized representation to handle `namespace` attribute.
+    # If the need arises, this attribute can be pulled into a separate Collection
+    # table at some time later.
+    namespace = Column(String, index=True, nullable=False)
+    group_id = Column(String, index=True, nullable=True)
+
+    # The timestamp associated with the last record upsertion.
+    updated_at = Column(Float, index=True)
+
+    __table_args__ = (
+        UniqueConstraint("key", "namespace", name="uix_key_namespace"),
+        Index("ix_key_namespace", "key", "namespace"),
+    )
+
+
+class SQLRecordManager(RecordManager):
+    """A SQL Alchemy based implementation of the record manager."""
+
+    def __init__(
+        self,
+        namespace: str,
+        *,
+        engine: Optional[Union[Engine, AsyncEngine]] = None,
+        db_url: Union[None, str, URL] = None,
+        engine_kwargs: Optional[Dict[str, Any]] = None,
+        async_mode: bool = False,
+    ) -> None:
+        """Initialize the SQLRecordManager.
+
+        This class serves as a manager persistence layer that uses an SQL
+        backend to track upserted records. You should specify either a db_url
+        to create an engine or provide an existing engine.
+
+        Args:
+            namespace: The namespace associated with this record manager.
+            engine: An already existing SQL Alchemy engine.
+                Default is None.
+            db_url: A database connection string used to create
+                an SQL Alchemy engine. Default is None.
+            engine_kwargs: Additional keyword arguments
+                to be passed when creating the engine. Default is an empty dictionary.
+            async_mode: Whether to create an async engine.
+                Driver should support async operations.
+                It only applies if db_url is provided.
+                Default is False.
+
+        Raises:
+            ValueError: If both db_url and engine are provided or neither.
+            AssertionError: If something unexpected happens during engine configuration.
+        """
+        super().__init__(namespace=namespace)
+        if db_url is None and engine is None:
+            raise ValueError("Must specify either db_url or engine")
+
+        if db_url is not None and engine is not None:
+            raise ValueError("Must specify either db_url or engine, not both")
+
+        _engine: Union[Engine, AsyncEngine]
+        if db_url:
+            if async_mode:
+                _engine = create_async_engine(db_url, **(engine_kwargs or {}))
+            else:
+                _engine = create_engine(db_url, **(engine_kwargs or {}))
+        elif engine:
+            _engine = engine
+
+        else:
+            raise AssertionError("Something went wrong with configuration of engine.")
+
+        _session_factory: Union[sessionmaker[Session], async_sessionmaker[AsyncSession]]
+        if isinstance(_engine, AsyncEngine):
+            _session_factory = async_sessionmaker(bind=_engine)
+        else:
+            _session_factory = sessionmaker(bind=_engine)
+
+        self.engine = _engine
+        self.dialect = _engine.dialect.name
+        self.session_factory = _session_factory
+
+    def create_schema(self) -> None:
+        """Create the database schema."""
+        if isinstance(self.engine, AsyncEngine):
+            raise AssertionError("This method is not supported for async engines.")
+
+        Base.metadata.create_all(self.engine)
+
+    async def acreate_schema(self) -> None:
+        """Create the database schema."""
+
+        if not isinstance(self.engine, AsyncEngine):
+            raise AssertionError("This method is not supported for sync engines.")
+
+        async with self.engine.begin() as session:
+            await session.run_sync(Base.metadata.create_all)
+
+    @contextlib.contextmanager
+    def _make_session(self) -> Generator[Session, None, None]:
+        """Create a session and close it after use."""
+
+        if isinstance(self.session_factory, async_sessionmaker):
+            raise AssertionError("This method is not supported for async engines.")
+
+        session = self.session_factory()
+        try:
+            yield session
+        finally:
+            session.close()
+
+    @contextlib.asynccontextmanager
+    async def _amake_session(self) -> AsyncGenerator[AsyncSession, None]:
+        """Create a session and close it after use."""
+
+        if not isinstance(self.session_factory, async_sessionmaker):
+            raise AssertionError("This method is not supported for sync engines.")
+
+        async with self.session_factory() as session:
+            yield session
+
+    def get_time(self) -> float:
+        """Get the current server time as a timestamp.
+
+        Please note it's critical that time is obtained from the server since
+        we want a monotonic clock.
+        """
+        with self._make_session() as session:
+            # * SQLite specific implementation, can be changed based on dialect.
+            # * For SQLite, unlike unixepoch it will work with older versions of SQLite.
+            # ----
+            # julianday('now'): Julian day number for the current date and time.
+            # The Julian day is a continuous count of days, starting from a
+            # reference date (Julian day number 0).
+            # 2440587.5 - constant represents the Julian day number for January 1, 1970
+            # 86400.0 - constant represents the number of seconds
+            # in a day (24 hours * 60 minutes * 60 seconds)
+            if self.dialect == "sqlite":
+                query = text("SELECT (julianday('now') - 2440587.5) * 86400.0;")
+            elif self.dialect == "postgresql":
+                query = text("SELECT EXTRACT (EPOCH FROM CURRENT_TIMESTAMP);")
+            else:
+                raise NotImplementedError(f"Not implemented for dialect {self.dialect}")
+
+            dt = session.execute(query).scalar()
+            if isinstance(dt, decimal.Decimal):
+                dt = float(dt)
+            if not isinstance(dt, float):
+                raise AssertionError(f"Unexpected type for datetime: {type(dt)}")
+            return dt
+
+    async def aget_time(self) -> float:
+        """Get the current server time as a timestamp.
+
+        Please note it's critical that time is obtained from the server since
+        we want a monotonic clock.
+        """
+        async with self._amake_session() as session:
+            # * SQLite specific implementation, can be changed based on dialect.
+            # * For SQLite, unlike unixepoch it will work with older versions of SQLite.
+            # ----
+            # julianday('now'): Julian day number for the current date and time.
+            # The Julian day is a continuous count of days, starting from a
+            # reference date (Julian day number 0).
+            # 2440587.5 - constant represents the Julian day number for January 1, 1970
+            # 86400.0 - constant represents the number of seconds
+            # in a day (24 hours * 60 minutes * 60 seconds)
+            if self.dialect == "sqlite":
+                query = text("SELECT (julianday('now') - 2440587.5) * 86400.0;")
+            elif self.dialect == "postgresql":
+                query = text("SELECT EXTRACT (EPOCH FROM CURRENT_TIMESTAMP);")
+            else:
+                raise NotImplementedError(f"Not implemented for dialect {self.dialect}")
+
+            dt = (await session.execute(query)).scalar_one_or_none()
+
+            if isinstance(dt, decimal.Decimal):
+                dt = float(dt)
+            if not isinstance(dt, float):
+                raise AssertionError(f"Unexpected type for datetime: {type(dt)}")
+            return dt
+
+    def update(
+        self,
+        keys: Sequence[str],
+        *,
+        group_ids: Optional[Sequence[Optional[str]]] = None,
+        time_at_least: Optional[float] = None,
+    ) -> None:
+        """Upsert records into the SQLite database."""
+        if group_ids is None:
+            group_ids = [None] * len(keys)
+
+        if len(keys) != len(group_ids):
+            raise ValueError(
+                f"Number of keys ({len(keys)}) does not match number of "
+                f"group_ids ({len(group_ids)})"
+            )
+
+        # Get the current time from the server.
+        # This makes an extra round trip to the server, should not be a big deal
+        # if the batch size is large enough.
+        # Getting the time here helps us compare it against the time_at_least
+        # and raise an error if there is a time sync issue.
+        # Here, we're just being extra careful to minimize the chance of
+        # data loss due to incorrectly deleting records.
+        update_time = self.get_time()
+
+        if time_at_least and update_time < time_at_least:
+            # Safeguard against time sync issues
+            raise AssertionError(f"Time sync issue: {update_time} < {time_at_least}")
+
+        records_to_upsert = [
+            {
+                "key": key,
+                "namespace": self.namespace,
+                "updated_at": update_time,
+                "group_id": group_id,
+            }
+            for key, group_id in zip(keys, group_ids)
+        ]
+
+        with self._make_session() as session:
+            if self.dialect == "sqlite":
+                from sqlalchemy.dialects.sqlite import Insert as SqliteInsertType
+                from sqlalchemy.dialects.sqlite import insert as sqlite_insert
+
+                # Note: uses SQLite insert to make on_conflict_do_update work.
+                # This code needs to be generalized a bit to work with more dialects.
+                sqlite_insert_stmt: SqliteInsertType = sqlite_insert(
+                    UpsertionRecord
+                ).values(records_to_upsert)
+                stmt = sqlite_insert_stmt.on_conflict_do_update(
+                    [UpsertionRecord.key, UpsertionRecord.namespace],
+                    set_=dict(
+                        updated_at=sqlite_insert_stmt.excluded.updated_at,
+                        group_id=sqlite_insert_stmt.excluded.group_id,
+                    ),
+                )
+            elif self.dialect == "postgresql":
+                from sqlalchemy.dialects.postgresql import Insert as PgInsertType
+                from sqlalchemy.dialects.postgresql import insert as pg_insert
+
+                # Note: uses postgresql insert to make on_conflict_do_update work.
+                # This code needs to be generalized a bit to work with more dialects.
+                pg_insert_stmt: PgInsertType = pg_insert(UpsertionRecord).values(
+                    records_to_upsert
+                )
+                stmt = pg_insert_stmt.on_conflict_do_update(  # type: ignore[assignment]
+                    "uix_key_namespace",  # Name of constraint
+                    set_=dict(
+                        updated_at=pg_insert_stmt.excluded.updated_at,
+                        group_id=pg_insert_stmt.excluded.group_id,
+                    ),
+                )
+            else:
+                raise NotImplementedError(f"Unsupported dialect {self.dialect}")
+
+            session.execute(stmt)
+            session.commit()
+
+    async def aupdate(
+        self,
+        keys: Sequence[str],
+        *,
+        group_ids: Optional[Sequence[Optional[str]]] = None,
+        time_at_least: Optional[float] = None,
+    ) -> None:
+        """Upsert records into the SQLite database."""
+        if group_ids is None:
+            group_ids = [None] * len(keys)
+
+        if len(keys) != len(group_ids):
+            raise ValueError(
+                f"Number of keys ({len(keys)}) does not match number of "
+                f"group_ids ({len(group_ids)})"
+            )
+
+        # Get the current time from the server.
+        # This makes an extra round trip to the server, should not be a big deal
+        # if the batch size is large enough.
+        # Getting the time here helps us compare it against the time_at_least
+        # and raise an error if there is a time sync issue.
+        # Here, we're just being extra careful to minimize the chance of
+        # data loss due to incorrectly deleting records.
+        update_time = await self.aget_time()
+
+        if time_at_least and update_time < time_at_least:
+            # Safeguard against time sync issues
+            raise AssertionError(f"Time sync issue: {update_time} < {time_at_least}")
+
+        records_to_upsert = [
+            {
+                "key": key,
+                "namespace": self.namespace,
+                "updated_at": update_time,
+                "group_id": group_id,
+            }
+            for key, group_id in zip(keys, group_ids)
+        ]
+
+        async with self._amake_session() as session:
+            if self.dialect == "sqlite":
+                from sqlalchemy.dialects.sqlite import Insert as SqliteInsertType
+                from sqlalchemy.dialects.sqlite import insert as sqlite_insert
+
+                # Note: uses SQLite insert to make on_conflict_do_update work.
+                # This code needs to be generalized a bit to work with more dialects.
+                sqlite_insert_stmt: SqliteInsertType = sqlite_insert(
+                    UpsertionRecord
+                ).values(records_to_upsert)
+                stmt = sqlite_insert_stmt.on_conflict_do_update(
+                    [UpsertionRecord.key, UpsertionRecord.namespace],
+                    set_=dict(
+                        updated_at=sqlite_insert_stmt.excluded.updated_at,
+                        group_id=sqlite_insert_stmt.excluded.group_id,
+                    ),
+                )
+            elif self.dialect == "postgresql":
+                from sqlalchemy.dialects.postgresql import Insert as PgInsertType
+                from sqlalchemy.dialects.postgresql import insert as pg_insert
+
+                # Note: uses SQLite insert to make on_conflict_do_update work.
+                # This code needs to be generalized a bit to work with more dialects.
+                pg_insert_stmt: PgInsertType = pg_insert(UpsertionRecord).values(
+                    records_to_upsert
+                )
+                stmt = pg_insert_stmt.on_conflict_do_update(  # type: ignore[assignment]
+                    "uix_key_namespace",  # Name of constraint
+                    set_=dict(
+                        updated_at=pg_insert_stmt.excluded.updated_at,
+                        group_id=pg_insert_stmt.excluded.group_id,
+                    ),
+                )
+            else:
+                raise NotImplementedError(f"Unsupported dialect {self.dialect}")
+
+            await session.execute(stmt)
+            await session.commit()
+
+    def exists(self, keys: Sequence[str]) -> List[bool]:
+        """Check if the given keys exist in the SQLite database."""
+        session: Session
+        with self._make_session() as session:
+            filtered_query: Query = session.query(UpsertionRecord.key).filter(
+                and_(
+                    UpsertionRecord.key.in_(keys),
+                    UpsertionRecord.namespace == self.namespace,
+                )
+            )
+            records = filtered_query.all()
+        found_keys = set(r.key for r in records)
+        return [k in found_keys for k in keys]
+
+    async def aexists(self, keys: Sequence[str]) -> List[bool]:
+        """Check if the given keys exist in the SQLite database."""
+        async with self._amake_session() as session:
+            records = (
+                (
+                    await session.execute(
+                        select(UpsertionRecord.key).where(
+                            and_(
+                                UpsertionRecord.key.in_(keys),
+                                UpsertionRecord.namespace == self.namespace,
+                            )
+                        )
+                    )
+                )
+                .scalars()
+                .all()
+            )
+        found_keys = set(records)
+        return [k in found_keys for k in keys]
+
+    def list_keys(
+        self,
+        *,
+        before: Optional[float] = None,
+        after: Optional[float] = None,
+        group_ids: Optional[Sequence[str]] = None,
+        limit: Optional[int] = None,
+    ) -> List[str]:
+        """List records in the SQLite database based on the provided date range."""
+        session: Session
+        with self._make_session() as session:
+            query: Query = session.query(UpsertionRecord).filter(
+                UpsertionRecord.namespace == self.namespace
+            )
+
+            if after:
+                query = query.filter(UpsertionRecord.updated_at > after)
+            if before:
+                query = query.filter(UpsertionRecord.updated_at < before)
+            if group_ids:
+                query = query.filter(UpsertionRecord.group_id.in_(group_ids))
+
+            if limit:
+                query = query.limit(limit)
+            records = query.all()
+        return [r.key for r in records]
+
+    async def alist_keys(
+        self,
+        *,
+        before: Optional[float] = None,
+        after: Optional[float] = None,
+        group_ids: Optional[Sequence[str]] = None,
+        limit: Optional[int] = None,
+    ) -> List[str]:
+        """List records in the SQLite database based on the provided date range."""
+        session: AsyncSession
+        async with self._amake_session() as session:
+            query: Query = select(UpsertionRecord.key).filter(  # type: ignore[assignment]
+                UpsertionRecord.namespace == self.namespace
+            )
+
+            # mypy does not recognize .all() or .filter()
+            if after:
+                query = query.filter(UpsertionRecord.updated_at > after)
+            if before:
+                query = query.filter(UpsertionRecord.updated_at < before)
+            if group_ids:
+                query = query.filter(UpsertionRecord.group_id.in_(group_ids))
+
+            if limit:
+                query = query.limit(limit)
+            records = (await session.execute(query)).scalars().all()
+        return list(records)
+
+    def delete_keys(self, keys: Sequence[str]) -> None:
+        """Delete records from the SQLite database."""
+        session: Session
+        with self._make_session() as session:
+            filtered_query: Query = session.query(UpsertionRecord).filter(
+                and_(
+                    UpsertionRecord.key.in_(keys),
+                    UpsertionRecord.namespace == self.namespace,
+                )
+            )
+
+            filtered_query.delete()
+            session.commit()
+
+    async def adelete_keys(self, keys: Sequence[str]) -> None:
+        """Delete records from the SQLite database."""
+        async with self._amake_session() as session:
+            await session.execute(
+                delete(UpsertionRecord).where(
+                    and_(
+                        UpsertionRecord.key.in_(keys),
+                        UpsertionRecord.namespace == self.namespace,
+                    )
+                )
+            )
+
+            await session.commit()
diff --git a/llm/Lib/site-packages/langchain/indexes/base.py b/llm/Lib/site-packages/langchain/indexes/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..46ef5bf2efab2f7d7904e040a1139cdfcf330cfd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/indexes/base.py
@@ -0,0 +1,172 @@
+from __future__ import annotations
+
+import uuid
+from abc import ABC, abstractmethod
+from typing import List, Optional, Sequence
+
+NAMESPACE_UUID = uuid.UUID(int=1984)
+
+
+class RecordManager(ABC):
+    """An abstract base class representing the interface for a record manager."""
+
+    def __init__(
+        self,
+        namespace: str,
+    ) -> None:
+        """Initialize the record manager.
+
+        Args:
+            namespace (str): The namespace for the record manager.
+        """
+        self.namespace = namespace
+
+    @abstractmethod
+    def create_schema(self) -> None:
+        """Create the database schema for the record manager."""
+
+    @abstractmethod
+    async def acreate_schema(self) -> None:
+        """Create the database schema for the record manager."""
+
+    @abstractmethod
+    def get_time(self) -> float:
+        """Get the current server time as a high resolution timestamp!
+
+        It's important to get this from the server to ensure a monotonic clock,
+        otherwise there may be data loss when cleaning up old documents!
+
+        Returns:
+            The current server time as a float timestamp.
+        """
+
+    @abstractmethod
+    async def aget_time(self) -> float:
+        """Get the current server time as a high resolution timestamp!
+
+        It's important to get this from the server to ensure a monotonic clock,
+        otherwise there may be data loss when cleaning up old documents!
+
+        Returns:
+            The current server time as a float timestamp.
+        """
+
+    @abstractmethod
+    def update(
+        self,
+        keys: Sequence[str],
+        *,
+        group_ids: Optional[Sequence[Optional[str]]] = None,
+        time_at_least: Optional[float] = None,
+    ) -> None:
+        """Upsert records into the database.
+
+        Args:
+            keys: A list of record keys to upsert.
+            group_ids: A list of group IDs corresponding to the keys.
+            time_at_least: if provided, updates should only happen if the
+              updated_at field is at least this time.
+
+        Raises:
+            ValueError: If the length of keys doesn't match the length of group_ids.
+        """
+
+    @abstractmethod
+    async def aupdate(
+        self,
+        keys: Sequence[str],
+        *,
+        group_ids: Optional[Sequence[Optional[str]]] = None,
+        time_at_least: Optional[float] = None,
+    ) -> None:
+        """Upsert records into the database.
+
+        Args:
+            keys: A list of record keys to upsert.
+            group_ids: A list of group IDs corresponding to the keys.
+            time_at_least: if provided, updates should only happen if the
+              updated_at field is at least this time.
+
+        Raises:
+            ValueError: If the length of keys doesn't match the length of group_ids.
+        """
+
+    @abstractmethod
+    def exists(self, keys: Sequence[str]) -> List[bool]:
+        """Check if the provided keys exist in the database.
+
+        Args:
+            keys: A list of keys to check.
+
+        Returns:
+            A list of boolean values indicating the existence of each key.
+        """
+
+    @abstractmethod
+    async def aexists(self, keys: Sequence[str]) -> List[bool]:
+        """Check if the provided keys exist in the database.
+
+        Args:
+            keys: A list of keys to check.
+
+        Returns:
+            A list of boolean values indicating the existence of each key.
+        """
+
+    @abstractmethod
+    def list_keys(
+        self,
+        *,
+        before: Optional[float] = None,
+        after: Optional[float] = None,
+        group_ids: Optional[Sequence[str]] = None,
+        limit: Optional[int] = None,
+    ) -> List[str]:
+        """List records in the database based on the provided filters.
+
+        Args:
+            before: Filter to list records updated before this time.
+            after: Filter to list records updated after this time.
+            group_ids: Filter to list records with specific group IDs.
+            limit: optional limit on the number of records to return.
+
+        Returns:
+            A list of keys for the matching records.
+        """
+
+    @abstractmethod
+    async def alist_keys(
+        self,
+        *,
+        before: Optional[float] = None,
+        after: Optional[float] = None,
+        group_ids: Optional[Sequence[str]] = None,
+        limit: Optional[int] = None,
+    ) -> List[str]:
+        """List records in the database based on the provided filters.
+
+        Args:
+            before: Filter to list records updated before this time.
+            after: Filter to list records updated after this time.
+            group_ids: Filter to list records with specific group IDs.
+            limit: optional limit on the number of records to return.
+
+        Returns:
+            A list of keys for the matching records.
+        """
+
+    @abstractmethod
+    def delete_keys(self, keys: Sequence[str]) -> None:
+        """Delete specified records from the database.
+
+        Args:
+            keys: A list of keys to delete.
+        """
+
+    @abstractmethod
+    async def adelete_keys(self, keys: Sequence[str]) -> None:
+        """Delete specified records from the database.
+
+        Args:
+            keys: A list of keys to delete.
+        """
diff --git a/llm/Lib/site-packages/langchain/indexes/graph.py b/llm/Lib/site-packages/langchain/indexes/graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc8e2ab38ae3fc933389df59723d072674c14a32
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/indexes/graph.py
@@ -0,0 +1,47 @@
+"""Graph Index Creator."""
+from typing import Optional, Type
+
+from langchain_community.graphs.networkx_graph import NetworkxEntityGraph, parse_triples
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import BaseModel
+
+from langchain.chains.llm import LLMChain
+from langchain.indexes.prompts.knowledge_triplet_extraction import (
+    KNOWLEDGE_TRIPLE_EXTRACTION_PROMPT,
+)
+
+
+class GraphIndexCreator(BaseModel):
+    """Functionality to create graph index."""
+
+    llm: Optional[BaseLanguageModel] = None
+    graph_type: Type[NetworkxEntityGraph] = NetworkxEntityGraph
+
+    def from_text(
+        self, text: str, prompt: BasePromptTemplate = KNOWLEDGE_TRIPLE_EXTRACTION_PROMPT
+    ) -> NetworkxEntityGraph:
+        """Create graph index from text."""
+        if self.llm is None:
+            raise ValueError("llm should not be None")
+        graph = self.graph_type()
+        chain = LLMChain(llm=self.llm, prompt=prompt)
+        output = chain.predict(text=text)
+        knowledge = parse_triples(output)
+        for triple in knowledge:
+            graph.add_triple(triple)
+        return graph
+
+    async def afrom_text(
+        self, text: str, prompt: BasePromptTemplate = KNOWLEDGE_TRIPLE_EXTRACTION_PROMPT
+    ) -> NetworkxEntityGraph:
+        """Create graph index from text asynchronously."""
+        if self.llm is None:
+            raise ValueError("llm should not be None")
+        graph = self.graph_type()
+        chain = LLMChain(llm=self.llm, prompt=prompt)
+        output = await chain.apredict(text=text)
+        knowledge = parse_triples(output)
+        for triple in knowledge:
+            graph.add_triple(triple)
+        return graph
diff --git a/llm/Lib/site-packages/langchain/indexes/prompts/__init__.py b/llm/Lib/site-packages/langchain/indexes/prompts/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a5833cd2a5f18bb8e3bd4d90784a758b2ba1953
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/indexes/prompts/__init__.py
@@ -0,0 +1 @@
+"""Relevant prompts for constructing indexes."""
diff --git a/llm/Lib/site-packages/langchain/indexes/prompts/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/indexes/prompts/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eeeb4d473d0b5c89ebc672b76cc1beceed4a8485
Binary files /dev/null and b/llm/Lib/site-packages/langchain/indexes/prompts/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/indexes/prompts/__pycache__/entity_extraction.cpython-311.pyc b/llm/Lib/site-packages/langchain/indexes/prompts/__pycache__/entity_extraction.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d6e882a40ce5c936667ef36fcc1feb7deb34c78a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/indexes/prompts/__pycache__/entity_extraction.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/indexes/prompts/__pycache__/entity_summarization.cpython-311.pyc b/llm/Lib/site-packages/langchain/indexes/prompts/__pycache__/entity_summarization.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a4db95c8832069ac5b3891ede1d562d894b89fc7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/indexes/prompts/__pycache__/entity_summarization.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/indexes/prompts/__pycache__/knowledge_triplet_extraction.cpython-311.pyc b/llm/Lib/site-packages/langchain/indexes/prompts/__pycache__/knowledge_triplet_extraction.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ed85907205dfb01c5a0f4a1748c61eb94c8abb03
Binary files /dev/null and b/llm/Lib/site-packages/langchain/indexes/prompts/__pycache__/knowledge_triplet_extraction.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/indexes/prompts/entity_extraction.py b/llm/Lib/site-packages/langchain/indexes/prompts/entity_extraction.py
new file mode 100644
index 0000000000000000000000000000000000000000..416ba13eea9dbe2edd313665009482bc8cb55b20
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/indexes/prompts/entity_extraction.py
@@ -0,0 +1,40 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+_DEFAULT_ENTITY_EXTRACTION_TEMPLATE = """You are an AI assistant reading the transcript of a conversation between an AI and a human. Extract all of the proper nouns from the last line of conversation. As a guideline, a proper noun is generally capitalized. You should definitely extract all names and places.
+
+The conversation history is provided just in case of a coreference (e.g. "What do you know about him" where "him" is defined in a previous line) -- ignore items mentioned there that are not in the last line.
+
+Return the output as a single comma-separated list, or NONE if there is nothing of note to return (e.g. the user is just issuing a greeting or having a simple conversation).
+
+EXAMPLE
+Conversation history:
+Person #1: how's it going today?
+AI: "It's going great! How about you?"
+Person #1: good! busy working on Langchain. lots to do.
+AI: "That sounds like a lot of work! What kind of things are you doing to make Langchain better?"
+Last line:
+Person #1: i'm trying to improve Langchain's interfaces, the UX, its integrations with various products the user might want ... a lot of stuff.
+Output: Langchain
+END OF EXAMPLE
+
+EXAMPLE
+Conversation history:
+Person #1: how's it going today?
+AI: "It's going great! How about you?"
+Person #1: good! busy working on Langchain. lots to do.
+AI: "That sounds like a lot of work! What kind of things are you doing to make Langchain better?"
+Last line:
+Person #1: i'm trying to improve Langchain's interfaces, the UX, its integrations with various products the user might want ... a lot of stuff. I'm working with Person #2.
+Output: Langchain, Person #2
+END OF EXAMPLE
+
+Conversation history (for reference only):
+{history}
+Last line of conversation (for extraction):
+Human: {input}
+
+Output:"""
+ENTITY_EXTRACTION_PROMPT = PromptTemplate(
+    input_variables=["history", "input"], template=_DEFAULT_ENTITY_EXTRACTION_TEMPLATE
+)
diff --git a/llm/Lib/site-packages/langchain/indexes/prompts/entity_summarization.py b/llm/Lib/site-packages/langchain/indexes/prompts/entity_summarization.py
new file mode 100644
index 0000000000000000000000000000000000000000..aa8ec6ef99fa5d5e2c9c795a8b08903b7ece873e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/indexes/prompts/entity_summarization.py
@@ -0,0 +1,25 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+_DEFAULT_ENTITY_SUMMARIZATION_TEMPLATE = """You are an AI assistant helping a human keep track of facts about relevant people, places, and concepts in their life. Update the summary of the provided entity in the "Entity" section based on the last line of your conversation with the human. If you are writing the summary for the first time, return a single sentence.
+The update should only include facts that are relayed in the last line of conversation about the provided entity, and should only contain facts about the provided entity.
+
+If there is no new information about the provided entity or the information is not worth noting (not an important or relevant fact to remember long-term), return the existing summary unchanged.
+
+Full conversation history (for context):
+{history}
+
+Entity to summarize:
+{entity}
+
+Existing summary of {entity}:
+{summary}
+
+Last line of conversation:
+Human: {input}
+Updated summary:"""
+
+ENTITY_SUMMARIZATION_PROMPT = PromptTemplate(
+    input_variables=["entity", "summary", "history", "input"],
+    template=_DEFAULT_ENTITY_SUMMARIZATION_TEMPLATE,
+)
diff --git a/llm/Lib/site-packages/langchain/indexes/prompts/knowledge_triplet_extraction.py b/llm/Lib/site-packages/langchain/indexes/prompts/knowledge_triplet_extraction.py
new file mode 100644
index 0000000000000000000000000000000000000000..0176dd428de0a16018a959d952feb03117069c25
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/indexes/prompts/knowledge_triplet_extraction.py
@@ -0,0 +1,37 @@
+# flake8: noqa
+
+from langchain_community.graphs.networkx_graph import KG_TRIPLE_DELIMITER
+from langchain_core.prompts.prompt import PromptTemplate
+
+_DEFAULT_KNOWLEDGE_TRIPLE_EXTRACTION_TEMPLATE = (
+    "You are a networked intelligence helping a human track knowledge triples"
+    " about all relevant people, things, concepts, etc. and integrating"
+    " them with your knowledge stored within your weights"
+    " as well as that stored in a knowledge graph."
+    " Extract all of the knowledge triples from the text."
+    " A knowledge triple is a clause that contains a subject, a predicate,"
+    " and an object. The subject is the entity being described,"
+    " the predicate is the property of the subject that is being"
+    " described, and the object is the value of the property.\n\n"
+    "EXAMPLE\n"
+    "It's a state in the US. It's also the number 1 producer of gold in the US.\n\n"
+    f"Output: (Nevada, is a, state){KG_TRIPLE_DELIMITER}(Nevada, is in, US)"
+    f"{KG_TRIPLE_DELIMITER}(Nevada, is the number 1 producer of, gold)\n"
+    "END OF EXAMPLE\n\n"
+    "EXAMPLE\n"
+    "I'm going to the store.\n\n"
+    "Output: NONE\n"
+    "END OF EXAMPLE\n\n"
+    "EXAMPLE\n"
+    "Oh huh. I know Descartes likes to drive antique scooters and play the mandolin.\n"
+    f"Output: (Descartes, likes to drive, antique scooters){KG_TRIPLE_DELIMITER}(Descartes, plays, mandolin)\n"
+    "END OF EXAMPLE\n\n"
+    "EXAMPLE\n"
+    "{text}"
+    "Output:"
+)
+
+KNOWLEDGE_TRIPLE_EXTRACTION_PROMPT = PromptTemplate(
+    input_variables=["text"],
+    template=_DEFAULT_KNOWLEDGE_TRIPLE_EXTRACTION_TEMPLATE,
+)
diff --git a/llm/Lib/site-packages/langchain/indexes/vectorstore.py b/llm/Lib/site-packages/langchain/indexes/vectorstore.py
new file mode 100644
index 0000000000000000000000000000000000000000..b70cf33f0f717788f69b7e96bebeed104d2a992d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/indexes/vectorstore.py
@@ -0,0 +1,139 @@
+from typing import Any, Dict, List, Optional, Type
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.embeddings.openai import OpenAIEmbeddings
+from langchain_community.llms.openai import OpenAI
+from langchain_community.vectorstores.inmemory import InMemoryVectorStore
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field
+from langchain_core.vectorstores import VectorStore
+from langchain_text_splitters import RecursiveCharacterTextSplitter, TextSplitter
+
+from langchain.chains.qa_with_sources.retrieval import RetrievalQAWithSourcesChain
+from langchain.chains.retrieval_qa.base import RetrievalQA
+
+
+def _get_default_text_splitter() -> TextSplitter:
+    return RecursiveCharacterTextSplitter(chunk_size=1000, chunk_overlap=0)
+
+
+class VectorStoreIndexWrapper(BaseModel):
+    """Wrapper around a vectorstore for easy access."""
+
+    vectorstore: VectorStore
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    def query(
+        self,
+        question: str,
+        llm: Optional[BaseLanguageModel] = None,
+        retriever_kwargs: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Query the vectorstore."""
+        llm = llm or OpenAI(temperature=0)
+        retriever_kwargs = retriever_kwargs or {}
+        chain = RetrievalQA.from_chain_type(
+            llm, retriever=self.vectorstore.as_retriever(**retriever_kwargs), **kwargs
+        )
+        return chain.invoke({chain.input_key: question})[chain.output_key]
+
+    async def aquery(
+        self,
+        question: str,
+        llm: Optional[BaseLanguageModel] = None,
+        retriever_kwargs: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Query the vectorstore."""
+        llm = llm or OpenAI(temperature=0)
+        retriever_kwargs = retriever_kwargs or {}
+        chain = RetrievalQA.from_chain_type(
+            llm, retriever=self.vectorstore.as_retriever(**retriever_kwargs), **kwargs
+        )
+        return (await chain.ainvoke({chain.input_key: question}))[chain.output_key]
+
+    def query_with_sources(
+        self,
+        question: str,
+        llm: Optional[BaseLanguageModel] = None,
+        retriever_kwargs: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Query the vectorstore and get back sources."""
+        llm = llm or OpenAI(temperature=0)
+        retriever_kwargs = retriever_kwargs or {}
+        chain = RetrievalQAWithSourcesChain.from_chain_type(
+            llm, retriever=self.vectorstore.as_retriever(**retriever_kwargs), **kwargs
+        )
+        return chain.invoke({chain.question_key: question})
+
+    async def aquery_with_sources(
+        self,
+        question: str,
+        llm: Optional[BaseLanguageModel] = None,
+        retriever_kwargs: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> dict:
+        """Query the vectorstore and get back sources."""
+        llm = llm or OpenAI(temperature=0)
+        retriever_kwargs = retriever_kwargs or {}
+        chain = RetrievalQAWithSourcesChain.from_chain_type(
+            llm, retriever=self.vectorstore.as_retriever(**retriever_kwargs), **kwargs
+        )
+        return await chain.ainvoke({chain.question_key: question})
+
+
+class VectorstoreIndexCreator(BaseModel):
+    """Logic for creating indexes."""
+
+    vectorstore_cls: Type[VectorStore] = InMemoryVectorStore
+    embedding: Embeddings = Field(default_factory=OpenAIEmbeddings)
+    text_splitter: TextSplitter = Field(default_factory=_get_default_text_splitter)
+    vectorstore_kwargs: dict = Field(default_factory=dict)
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    def from_loaders(self, loaders: List[BaseLoader]) -> VectorStoreIndexWrapper:
+        """Create a vectorstore index from loaders."""
+        docs = []
+        for loader in loaders:
+            docs.extend(loader.load())
+        return self.from_documents(docs)
+
+    async def afrom_loaders(self, loaders: List[BaseLoader]) -> VectorStoreIndexWrapper:
+        """Create a vectorstore index from loaders."""
+        docs = []
+        for loader in loaders:
+            async for doc in loader.alazy_load():
+                docs.append(doc)
+        return await self.afrom_documents(docs)
+
+    def from_documents(self, documents: List[Document]) -> VectorStoreIndexWrapper:
+        """Create a vectorstore index from documents."""
+        sub_docs = self.text_splitter.split_documents(documents)
+        vectorstore = self.vectorstore_cls.from_documents(
+            sub_docs, self.embedding, **self.vectorstore_kwargs
+        )
+        return VectorStoreIndexWrapper(vectorstore=vectorstore)
+
+    async def afrom_documents(
+        self, documents: List[Document]
+    ) -> VectorStoreIndexWrapper:
+        """Create a vectorstore index from documents."""
+        sub_docs = self.text_splitter.split_documents(documents)
+        vectorstore = await self.vectorstore_cls.afrom_documents(
+            sub_docs, self.embedding, **self.vectorstore_kwargs
+        )
+        return VectorStoreIndexWrapper(vectorstore=vectorstore)
diff --git a/llm/Lib/site-packages/langchain/input.py b/llm/Lib/site-packages/langchain/input.py
new file mode 100644
index 0000000000000000000000000000000000000000..fdd91412d6ec09a88c4fbc5364b30db17fda8e39
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/input.py
@@ -0,0 +1,14 @@
+"""DEPRECATED: Kept for backwards compatibility."""
+from langchain_core.utils.input import (
+    get_bolded_text,
+    get_color_mapping,
+    get_colored_text,
+    print_text,
+)
+
+__all__ = [
+    "get_bolded_text",
+    "get_color_mapping",
+    "get_colored_text",
+    "print_text",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/__init__.py b/llm/Lib/site-packages/langchain/llms/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..872688836878a4e5acd093f3abbb0737404d9ffe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/__init__.py
@@ -0,0 +1,733 @@
+"""
+**LLM** classes provide
+access to the large language model (**LLM**) APIs and services.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseLanguageModel --> BaseLLM --> LLM --> <name>  # Examples: AI21, HuggingFaceHub, OpenAI
+
+**Main helpers:**
+
+.. code-block::
+
+    LLMResult, PromptValue,
+    CallbackManagerForLLMRun, AsyncCallbackManagerForLLMRun,
+    CallbackManager, AsyncCallbackManager,
+    AIMessage, BaseMessage
+"""  # noqa: E501
+import warnings
+from typing import Any, Callable, Dict, Type
+
+from langchain_core._api import LangChainDeprecationWarning
+from langchain_core.language_models.llms import BaseLLM
+
+from langchain.utils.interactive_env import is_interactive_env
+
+
+def _import_ai21() -> Any:
+    from langchain_community.llms.ai21 import AI21
+
+    return AI21
+
+
+def _import_aleph_alpha() -> Any:
+    from langchain_community.llms.aleph_alpha import AlephAlpha
+
+    return AlephAlpha
+
+
+def _import_amazon_api_gateway() -> Any:
+    from langchain_community.llms.amazon_api_gateway import AmazonAPIGateway
+
+    return AmazonAPIGateway
+
+
+def _import_anthropic() -> Any:
+    from langchain_community.llms.anthropic import Anthropic
+
+    return Anthropic
+
+
+def _import_anyscale() -> Any:
+    from langchain_community.llms.anyscale import Anyscale
+
+    return Anyscale
+
+
+def _import_arcee() -> Any:
+    from langchain_community.llms.arcee import Arcee
+
+    return Arcee
+
+
+def _import_aviary() -> Any:
+    from langchain_community.llms.aviary import Aviary
+
+    return Aviary
+
+
+def _import_azureml_endpoint() -> Any:
+    from langchain_community.llms.azureml_endpoint import AzureMLOnlineEndpoint
+
+    return AzureMLOnlineEndpoint
+
+
+def _import_baidu_qianfan_endpoint() -> Any:
+    from langchain_community.llms.baidu_qianfan_endpoint import QianfanLLMEndpoint
+
+    return QianfanLLMEndpoint
+
+
+def _import_bananadev() -> Any:
+    from langchain_community.llms.bananadev import Banana
+
+    return Banana
+
+
+def _import_baseten() -> Any:
+    from langchain_community.llms.baseten import Baseten
+
+    return Baseten
+
+
+def _import_beam() -> Any:
+    from langchain_community.llms.beam import Beam
+
+    return Beam
+
+
+def _import_bedrock() -> Any:
+    from langchain_community.llms.bedrock import Bedrock
+
+    return Bedrock
+
+
+def _import_bittensor() -> Any:
+    from langchain_community.llms.bittensor import NIBittensorLLM
+
+    return NIBittensorLLM
+
+
+def _import_cerebriumai() -> Any:
+    from langchain_community.llms.cerebriumai import CerebriumAI
+
+    return CerebriumAI
+
+
+def _import_chatglm() -> Any:
+    from langchain_community.llms.chatglm import ChatGLM
+
+    return ChatGLM
+
+
+def _import_clarifai() -> Any:
+    from langchain_community.llms.clarifai import Clarifai
+
+    return Clarifai
+
+
+def _import_cohere() -> Any:
+    from langchain_community.llms.cohere import Cohere
+
+    return Cohere
+
+
+def _import_ctransformers() -> Any:
+    from langchain_community.llms.ctransformers import CTransformers
+
+    return CTransformers
+
+
+def _import_ctranslate2() -> Any:
+    from langchain_community.llms.ctranslate2 import CTranslate2
+
+    return CTranslate2
+
+
+def _import_databricks() -> Any:
+    from langchain_community.llms.databricks import Databricks
+
+    return Databricks
+
+
+def _import_databricks_chat() -> Any:
+    from langchain_community.chat_models.databricks import ChatDatabricks
+
+    return ChatDatabricks
+
+
+def _import_deepinfra() -> Any:
+    from langchain_community.llms.deepinfra import DeepInfra
+
+    return DeepInfra
+
+
+def _import_deepsparse() -> Any:
+    from langchain_community.llms.deepsparse import DeepSparse
+
+    return DeepSparse
+
+
+def _import_edenai() -> Any:
+    from langchain_community.llms.edenai import EdenAI
+
+    return EdenAI
+
+
+def _import_fake() -> Any:
+    from langchain_community.llms.fake import FakeListLLM
+
+    return FakeListLLM
+
+
+def _import_fireworks() -> Any:
+    from langchain_community.llms.fireworks import Fireworks
+
+    return Fireworks
+
+
+def _import_forefrontai() -> Any:
+    from langchain_community.llms.forefrontai import ForefrontAI
+
+    return ForefrontAI
+
+
+def _import_gigachat() -> Any:
+    from langchain_community.llms.gigachat import GigaChat
+
+    return GigaChat
+
+
+def _import_google_palm() -> Any:
+    from langchain_community.llms.google_palm import GooglePalm
+
+    return GooglePalm
+
+
+def _import_gooseai() -> Any:
+    from langchain_community.llms.gooseai import GooseAI
+
+    return GooseAI
+
+
+def _import_gpt4all() -> Any:
+    from langchain_community.llms.gpt4all import GPT4All
+
+    return GPT4All
+
+
+def _import_gradient_ai() -> Any:
+    from langchain_community.llms.gradient_ai import GradientLLM
+
+    return GradientLLM
+
+
+def _import_huggingface_endpoint() -> Any:
+    from langchain_community.llms.huggingface_endpoint import HuggingFaceEndpoint
+
+    return HuggingFaceEndpoint
+
+
+def _import_huggingface_hub() -> Any:
+    from langchain_community.llms.huggingface_hub import HuggingFaceHub
+
+    return HuggingFaceHub
+
+
+def _import_huggingface_pipeline() -> Any:
+    from langchain_community.llms.huggingface_pipeline import HuggingFacePipeline
+
+    return HuggingFacePipeline
+
+
+def _import_huggingface_text_gen_inference() -> Any:
+    from langchain_community.llms.huggingface_text_gen_inference import (
+        HuggingFaceTextGenInference,
+    )
+
+    return HuggingFaceTextGenInference
+
+
+def _import_human() -> Any:
+    from langchain_community.llms.human import HumanInputLLM
+
+    return HumanInputLLM
+
+
+def _import_javelin_ai_gateway() -> Any:
+    from langchain_community.llms.javelin_ai_gateway import JavelinAIGateway
+
+    return JavelinAIGateway
+
+
+def _import_koboldai() -> Any:
+    from langchain_community.llms.koboldai import KoboldApiLLM
+
+    return KoboldApiLLM
+
+
+def _import_llamacpp() -> Any:
+    from langchain_community.llms.llamacpp import LlamaCpp
+
+    return LlamaCpp
+
+
+def _import_manifest() -> Any:
+    from langchain_community.llms.manifest import ManifestWrapper
+
+    return ManifestWrapper
+
+
+def _import_minimax() -> Any:
+    from langchain_community.llms.minimax import Minimax
+
+    return Minimax
+
+
+def _import_mlflow() -> Any:
+    from langchain_community.llms.mlflow import Mlflow
+
+    return Mlflow
+
+
+def _import_mlflow_chat() -> Any:
+    from langchain_community.chat_models.mlflow import ChatMlflow
+
+    return ChatMlflow
+
+
+def _import_mlflow_ai_gateway() -> Any:
+    from langchain_community.llms.mlflow_ai_gateway import MlflowAIGateway
+
+    return MlflowAIGateway
+
+
+def _import_modal() -> Any:
+    from langchain_community.llms.modal import Modal
+
+    return Modal
+
+
+def _import_mosaicml() -> Any:
+    from langchain_community.llms.mosaicml import MosaicML
+
+    return MosaicML
+
+
+def _import_nlpcloud() -> Any:
+    from langchain_community.llms.nlpcloud import NLPCloud
+
+    return NLPCloud
+
+
+def _import_octoai_endpoint() -> Any:
+    from langchain_community.llms.octoai_endpoint import OctoAIEndpoint
+
+    return OctoAIEndpoint
+
+
+def _import_ollama() -> Any:
+    from langchain_community.llms.ollama import Ollama
+
+    return Ollama
+
+
+def _import_opaqueprompts() -> Any:
+    from langchain_community.llms.opaqueprompts import OpaquePrompts
+
+    return OpaquePrompts
+
+
+def _import_azure_openai() -> Any:
+    from langchain_community.llms.openai import AzureOpenAI
+
+    return AzureOpenAI
+
+
+def _import_openai() -> Any:
+    from langchain_community.llms.openai import OpenAI
+
+    return OpenAI
+
+
+def _import_openai_chat() -> Any:
+    from langchain_community.llms.openai import OpenAIChat
+
+    return OpenAIChat
+
+
+def _import_openllm() -> Any:
+    from langchain_community.llms.openllm import OpenLLM
+
+    return OpenLLM
+
+
+def _import_openlm() -> Any:
+    from langchain_community.llms.openlm import OpenLM
+
+    return OpenLM
+
+
+def _import_pai_eas_endpoint() -> Any:
+    from langchain_community.llms.pai_eas_endpoint import PaiEasEndpoint
+
+    return PaiEasEndpoint
+
+
+def _import_petals() -> Any:
+    from langchain_community.llms.petals import Petals
+
+    return Petals
+
+
+def _import_pipelineai() -> Any:
+    from langchain_community.llms.pipelineai import PipelineAI
+
+    return PipelineAI
+
+
+def _import_predibase() -> Any:
+    from langchain_community.llms.predibase import Predibase
+
+    return Predibase
+
+
+def _import_predictionguard() -> Any:
+    from langchain_community.llms.predictionguard import PredictionGuard
+
+    return PredictionGuard
+
+
+def _import_promptlayer() -> Any:
+    from langchain_community.llms.promptlayer_openai import PromptLayerOpenAI
+
+    return PromptLayerOpenAI
+
+
+def _import_promptlayer_chat() -> Any:
+    from langchain_community.llms.promptlayer_openai import PromptLayerOpenAIChat
+
+    return PromptLayerOpenAIChat
+
+
+def _import_replicate() -> Any:
+    from langchain_community.llms.replicate import Replicate
+
+    return Replicate
+
+
+def _import_rwkv() -> Any:
+    from langchain_community.llms.rwkv import RWKV
+
+    return RWKV
+
+
+def _import_sagemaker_endpoint() -> Any:
+    from langchain_community.llms.sagemaker_endpoint import SagemakerEndpoint
+
+    return SagemakerEndpoint
+
+
+def _import_self_hosted() -> Any:
+    from langchain_community.llms.self_hosted import SelfHostedPipeline
+
+    return SelfHostedPipeline
+
+
+def _import_self_hosted_hugging_face() -> Any:
+    from langchain_community.llms.self_hosted_hugging_face import (
+        SelfHostedHuggingFaceLLM,
+    )
+
+    return SelfHostedHuggingFaceLLM
+
+
+def _import_stochasticai() -> Any:
+    from langchain_community.llms.stochasticai import StochasticAI
+
+    return StochasticAI
+
+
+def _import_symblai_nebula() -> Any:
+    from langchain_community.llms.symblai_nebula import Nebula
+
+    return Nebula
+
+
+def _import_textgen() -> Any:
+    from langchain_community.llms.textgen import TextGen
+
+    return TextGen
+
+
+def _import_titan_takeoff() -> Any:
+    from langchain_community.llms.titan_takeoff import TitanTakeoff
+
+    return TitanTakeoff
+
+
+def _import_titan_takeoff_pro() -> Any:
+    from langchain_community.llms.titan_takeoff_pro import TitanTakeoffPro
+
+    return TitanTakeoffPro
+
+
+def _import_together() -> Any:
+    from langchain_community.llms.together import Together
+
+    return Together
+
+
+def _import_tongyi() -> Any:
+    from langchain_community.llms.tongyi import Tongyi
+
+    return Tongyi
+
+
+def _import_vertex() -> Any:
+    from langchain_community.llms.vertexai import VertexAI
+
+    return VertexAI
+
+
+def _import_vertex_model_garden() -> Any:
+    from langchain_community.llms.vertexai import VertexAIModelGarden
+
+    return VertexAIModelGarden
+
+
+def _import_vllm() -> Any:
+    from langchain_community.llms.vllm import VLLM
+
+    return VLLM
+
+
+def _import_vllm_openai() -> Any:
+    from langchain_community.llms.vllm import VLLMOpenAI
+
+    return VLLMOpenAI
+
+
+def _import_watsonxllm() -> Any:
+    from langchain_community.llms.watsonxllm import WatsonxLLM
+
+    return WatsonxLLM
+
+
+def _import_writer() -> Any:
+    from langchain_community.llms.writer import Writer
+
+    return Writer
+
+
+def _import_xinference() -> Any:
+    from langchain_community.llms.xinference import Xinference
+
+    return Xinference
+
+
+def _import_yandex_gpt() -> Any:
+    from langchain_community.llms.yandex import YandexGPT
+
+    return YandexGPT
+
+
+def _import_volcengine_maas() -> Any:
+    from langchain_community.llms.volcengine_maas import VolcEngineMaasLLM
+
+    return VolcEngineMaasLLM
+
+
+def __getattr__(name: str) -> Any:
+    from langchain_community import llms
+
+    # If not in interactive env, raise warning.
+    if not is_interactive_env():
+        warnings.warn(
+            "Importing LLMs from langchain is deprecated. Importing from "
+            "langchain will no longer be supported as of langchain==0.2.0. "
+            "Please import from langchain-community instead:\n\n"
+            f"`from langchain_community.llms import {name}`.\n\n"
+            "To install langchain-community run `pip install -U langchain-community`.",
+            category=LangChainDeprecationWarning,
+        )
+
+    if name == "type_to_cls_dict":
+        # for backwards compatibility
+        type_to_cls_dict: Dict[str, Type[BaseLLM]] = {
+            k: v() for k, v in get_type_to_cls_dict().items()
+        }
+        return type_to_cls_dict
+    else:
+        return getattr(llms, name)
+
+
+__all__ = [
+    "AI21",
+    "AlephAlpha",
+    "AmazonAPIGateway",
+    "Anthropic",
+    "Anyscale",
+    "Arcee",
+    "Aviary",
+    "AzureMLOnlineEndpoint",
+    "AzureOpenAI",
+    "Banana",
+    "Baseten",
+    "Beam",
+    "Bedrock",
+    "CTransformers",
+    "CTranslate2",
+    "CerebriumAI",
+    "ChatGLM",
+    "Clarifai",
+    "Cohere",
+    "Databricks",
+    "DeepInfra",
+    "DeepSparse",
+    "EdenAI",
+    "FakeListLLM",
+    "Fireworks",
+    "ForefrontAI",
+    "GigaChat",
+    "GPT4All",
+    "GooglePalm",
+    "GooseAI",
+    "GradientLLM",
+    "HuggingFaceEndpoint",
+    "HuggingFaceHub",
+    "HuggingFacePipeline",
+    "HuggingFaceTextGenInference",
+    "HumanInputLLM",
+    "KoboldApiLLM",
+    "LlamaCpp",
+    "TextGen",
+    "ManifestWrapper",
+    "Minimax",
+    "MlflowAIGateway",
+    "Modal",
+    "MosaicML",
+    "Nebula",
+    "NIBittensorLLM",
+    "NLPCloud",
+    "Ollama",
+    "OpenAI",
+    "OpenAIChat",
+    "OpenLLM",
+    "OpenLM",
+    "PaiEasEndpoint",
+    "Petals",
+    "PipelineAI",
+    "Predibase",
+    "PredictionGuard",
+    "PromptLayerOpenAI",
+    "PromptLayerOpenAIChat",
+    "OpaquePrompts",
+    "RWKV",
+    "Replicate",
+    "SagemakerEndpoint",
+    "SelfHostedHuggingFaceLLM",
+    "SelfHostedPipeline",
+    "StochasticAI",
+    "TitanTakeoff",
+    "TitanTakeoffPro",
+    "Tongyi",
+    "VertexAI",
+    "VertexAIModelGarden",
+    "VLLM",
+    "VLLMOpenAI",
+    "WatsonxLLM",
+    "Writer",
+    "OctoAIEndpoint",
+    "Xinference",
+    "JavelinAIGateway",
+    "QianfanLLMEndpoint",
+    "YandexGPT",
+    "VolcEngineMaasLLM",
+]
+
+
+def get_type_to_cls_dict() -> Dict[str, Callable[[], Type[BaseLLM]]]:
+    return {
+        "ai21": _import_ai21,
+        "aleph_alpha": _import_aleph_alpha,
+        "amazon_api_gateway": _import_amazon_api_gateway,
+        "amazon_bedrock": _import_bedrock,
+        "anthropic": _import_anthropic,
+        "anyscale": _import_anyscale,
+        "arcee": _import_arcee,
+        "aviary": _import_aviary,
+        "azure": _import_azure_openai,
+        "azureml_endpoint": _import_azureml_endpoint,
+        "bananadev": _import_bananadev,
+        "baseten": _import_baseten,
+        "beam": _import_beam,
+        "cerebriumai": _import_cerebriumai,
+        "chat_glm": _import_chatglm,
+        "clarifai": _import_clarifai,
+        "cohere": _import_cohere,
+        "ctransformers": _import_ctransformers,
+        "ctranslate2": _import_ctranslate2,
+        "databricks": _import_databricks,
+        "databricks-chat": _import_databricks_chat,
+        "deepinfra": _import_deepinfra,
+        "deepsparse": _import_deepsparse,
+        "edenai": _import_edenai,
+        "fake-list": _import_fake,
+        "forefrontai": _import_forefrontai,
+        "giga-chat-model": _import_gigachat,
+        "google_palm": _import_google_palm,
+        "gooseai": _import_gooseai,
+        "gradient": _import_gradient_ai,
+        "gpt4all": _import_gpt4all,
+        "huggingface_endpoint": _import_huggingface_endpoint,
+        "huggingface_hub": _import_huggingface_hub,
+        "huggingface_pipeline": _import_huggingface_pipeline,
+        "huggingface_textgen_inference": _import_huggingface_text_gen_inference,
+        "human-input": _import_human,
+        "koboldai": _import_koboldai,
+        "llamacpp": _import_llamacpp,
+        "textgen": _import_textgen,
+        "minimax": _import_minimax,
+        "mlflow": _import_mlflow,
+        "mlflow-chat": _import_mlflow_chat,
+        "mlflow-ai-gateway": _import_mlflow_ai_gateway,
+        "modal": _import_modal,
+        "mosaic": _import_mosaicml,
+        "nebula": _import_symblai_nebula,
+        "nibittensor": _import_bittensor,
+        "nlpcloud": _import_nlpcloud,
+        "ollama": _import_ollama,
+        "openai": _import_openai,
+        "openlm": _import_openlm,
+        "pai_eas_endpoint": _import_pai_eas_endpoint,
+        "petals": _import_petals,
+        "pipelineai": _import_pipelineai,
+        "predibase": _import_predibase,
+        "opaqueprompts": _import_opaqueprompts,
+        "replicate": _import_replicate,
+        "rwkv": _import_rwkv,
+        "sagemaker_endpoint": _import_sagemaker_endpoint,
+        "self_hosted": _import_self_hosted,
+        "self_hosted_hugging_face": _import_self_hosted_hugging_face,
+        "stochasticai": _import_stochasticai,
+        "together": _import_together,
+        "tongyi": _import_tongyi,
+        "titan_takeoff": _import_titan_takeoff,
+        "titan_takeoff_pro": _import_titan_takeoff_pro,
+        "vertexai": _import_vertex,
+        "vertexai_model_garden": _import_vertex_model_garden,
+        "openllm": _import_openllm,
+        "openllm_client": _import_openllm,
+        "vllm": _import_vllm,
+        "vllm_openai": _import_vllm_openai,
+        "watsonxllm": _import_watsonxllm,
+        "writer": _import_writer,
+        "xinference": _import_xinference,
+        "javelin-ai-gateway": _import_javelin_ai_gateway,
+        "qianfan_endpoint": _import_baidu_qianfan_endpoint,
+        "yandex_gpt": _import_yandex_gpt,
+        "VolcEngineMaasLLM": _import_volcengine_maas,
+    }
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6f8ecad6bd2f2adac96efbdb25e70d8eb9a12aee
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/ai21.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/ai21.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5304375eecc247ee5d0ade19075f2bf951b1b0a1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/ai21.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/aleph_alpha.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/aleph_alpha.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0e9f1ba765274b9f1a834c4e7655980d95f83368
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/aleph_alpha.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/amazon_api_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/amazon_api_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eb39d77c3b27c12e9dbaeb262087c379a6b43e25
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/amazon_api_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/anthropic.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/anthropic.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..302ca34c6022f9cdd1b4d373f627ff0d6f19b412
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/anthropic.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/anyscale.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/anyscale.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eb1d1dade1c01c03902502564565511b4508ad2e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/anyscale.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/arcee.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/arcee.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..65fa769799aacf74b0a2697a055df4a9d7370432
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/arcee.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/aviary.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/aviary.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e84721e938f1d85d6bd693737d62a2165a41e8d9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/aviary.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/azureml_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/azureml_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..15af611895f7891fef0e4de027e54a136599353d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/azureml_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ff5431554ae945dbfee9b5e1f787ac0c5f559413
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/bananadev.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/bananadev.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bfb7cef0843f73777cb327dfa23f4d616450b67c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/bananadev.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..47f2162112968a878d17b1257c4ce5c40ccf5adf
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/baseten.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/baseten.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..be08be2b3274160764b684864365b0c8ff40dfd6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/baseten.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/beam.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/beam.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a10c6fd66ecb3089bc23d1309e6d7678fc78a2dc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/beam.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/bedrock.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/bedrock.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..18793dedead0c898451c73bd03652a34d45d034a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/bedrock.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/bittensor.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/bittensor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..da0c6f2df23564821c84be8dd0fa5659c7b55d58
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/bittensor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/cerebriumai.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/cerebriumai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7b04ed53f91767861c042d5f81550c7b4945e114
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/cerebriumai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/chatglm.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/chatglm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f874d659b794bdd48a4bbf6a5769535ac03cdc54
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/chatglm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/clarifai.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/clarifai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d4a77eb2978fdefb4e52ab4e40d1f283dc85b835
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/clarifai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/cloudflare_workersai.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/cloudflare_workersai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b14822d4588a6c22219585421f8efb8426940b54
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/cloudflare_workersai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/cohere.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/cohere.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..658aac845b1a0e9edae37db40669a9c0d4aced28
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/cohere.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/ctransformers.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/ctransformers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2a50122307276dcbe3dab5c76de0573643d000f4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/ctransformers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/ctranslate2.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/ctranslate2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..62c055aad53aada7d66f66a9d8338367fad13457
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/ctranslate2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/databricks.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/databricks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7b0e93b4c2824d7bb7c8a6d07cf0821bdf59080b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/databricks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/deepinfra.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/deepinfra.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c92d76ab192efa4164acdc83c917ca5de614d045
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/deepinfra.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/deepsparse.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/deepsparse.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..151beb3ff581c35014e99ed5a00c334f283ccc47
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/deepsparse.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/edenai.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/edenai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1753a3e934aa4d5178d4e7c924707be5776a9d3d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/edenai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/fake.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/fake.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f45a219efe2fb6ae40a87cfae9795c4f1a221c99
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/fake.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/fireworks.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/fireworks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..768429acd5aa309a66010a567806956e119a6af5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/fireworks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/forefrontai.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/forefrontai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..27fff2e438a2936757f657e60472395a38f00af2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/forefrontai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/gigachat.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/gigachat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5cfba09b962fb0ec1a8c3bede7a6552db9d1f416
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/gigachat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/google_palm.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/google_palm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9a91341414a1c89e446253adef101e70974b87bb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/google_palm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/gooseai.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/gooseai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..31faff50cb74d4a8fc5de04c3e3fd13b0be4b5ba
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/gooseai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/gpt4all.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/gpt4all.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d75edfb720445cce2887e31d6917e74ba52f780c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/gpt4all.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/gradient_ai.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/gradient_ai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9117539c9f8462e12b1995ae558ca18e2ddb36f3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/gradient_ai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/huggingface_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/huggingface_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fd7223c9b033de7688787bff7b65645f11358af7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/huggingface_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/huggingface_hub.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/huggingface_hub.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c1df9129ecaf65dc0aa0e6bc0736c74ed49b87e0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/huggingface_hub.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/huggingface_pipeline.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/huggingface_pipeline.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7f3a1730b8c0082755ccae2c23a2ea983ac0b0cb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/huggingface_pipeline.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/huggingface_text_gen_inference.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/huggingface_text_gen_inference.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..404668a6cb6d195bdb5b713dd1d26624f3a6e67d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/huggingface_text_gen_inference.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/human.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/human.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d906a0d94e97cbc7b393041c382b1c899fff4761
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/human.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/javelin_ai_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/javelin_ai_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9423dcfceae579962cfb5e84c08e6730b3b3680b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/javelin_ai_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/koboldai.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/koboldai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7cdd33498d5055670f438f0894a5de9623df4765
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/koboldai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/llamacpp.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/llamacpp.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..54411deca5a9c70c1ed2f11540c7af803ac303e4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/llamacpp.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/loading.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/loading.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..74a193bfdeca719cdd1623c60ec800b25041eaff
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/loading.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/manifest.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/manifest.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..633f2183294852bd38edaf0fb0050682b208bcea
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/manifest.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/minimax.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/minimax.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..79126892c93e4ae961da347f83239461a8cd1cd4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/minimax.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/mlflow.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/mlflow.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0ad78f6045d9bfcf4e4c943e99a6be4ab1e201c8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/mlflow.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/mlflow_ai_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/mlflow_ai_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..337d786608764783633206f30f767c6c63ec983f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/mlflow_ai_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/modal.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/modal.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e9a1f049640b7adff4590457e75bb4163326af38
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/modal.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/mosaicml.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/mosaicml.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8258ed544f083b268b637723f62572d5409c71d5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/mosaicml.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/nlpcloud.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/nlpcloud.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2bc11a9bd7760bb342b167bb50dad5a95426fba5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/nlpcloud.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/octoai_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/octoai_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2be6fc951afad59bacac35916e68be2ed7900a77
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/octoai_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/ollama.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/ollama.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0aa2e50c4ae849ddff00c4255ffc3edfffb3493f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/ollama.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/opaqueprompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/opaqueprompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ac91b2df7e1021b3e5d45d7a8ce8f7a45ffec257
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/opaqueprompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/openai.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..88072276da9f4cf095e65459f7e87a251d0de5e6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/openllm.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/openllm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..17d3642439ed4d2f728d00b748dd5b1a55579dbc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/openllm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/openlm.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/openlm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b56ab22590fd04311f57b0878746e253c4687110
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/openlm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/pai_eas_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/pai_eas_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..20e5a702f1511a384dd321d58b152bb01a7105d6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/pai_eas_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/petals.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/petals.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..000684fa3357304996d047ccc2b86fd15f8afe62
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/petals.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/pipelineai.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/pipelineai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..020bf2feb02f53b5f6a9b3851246586162be0915
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/pipelineai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/predibase.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/predibase.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6b521f12775dce6e2db8e242e83664ab7b0c590d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/predibase.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/predictionguard.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/predictionguard.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..462fab4eab414cd2a9e117434f4d6beda49bd47d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/predictionguard.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/promptlayer_openai.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/promptlayer_openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..60d7cc418f2de19167975c97ef487123e303ef17
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/promptlayer_openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/replicate.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/replicate.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..723135e8087370c0c5995cc9ac9b48215ce8350b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/replicate.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/rwkv.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/rwkv.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f95a05222c6a22bd82b64f89df4603ba74e075a0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/rwkv.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/sagemaker_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/sagemaker_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ed2d3e0545e03a0ac1f4eea2228f638b8b2a372e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/sagemaker_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/self_hosted.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/self_hosted.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a4c31f76015d58edcf502c7717ec2680ea1b7b04
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/self_hosted.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/self_hosted_hugging_face.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/self_hosted_hugging_face.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8a13301a62b25a1edd9b56e2ae41090c3d594e03
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/self_hosted_hugging_face.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/stochasticai.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/stochasticai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d578d9ca9d7290f512660e77e9e2c988052da686
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/stochasticai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/symblai_nebula.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/symblai_nebula.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dbb4fdfb63372a707517526b8ac793936b6ace4a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/symblai_nebula.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/textgen.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/textgen.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7709279322b828a40bf1ba5e8851b0c774f55f99
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/textgen.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/titan_takeoff.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/titan_takeoff.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4bf76cae5cadf7aa842ed99ca0ea65b93c474a43
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/titan_takeoff.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/titan_takeoff_pro.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/titan_takeoff_pro.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..df5a7bada7d3a68aefb901f5953d4c3ccbb2969b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/titan_takeoff_pro.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/together.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/together.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..067f21f1c465585891ad30d16cc9f2e771815f78
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/together.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/tongyi.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/tongyi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f2e6d722d2a97dca3f36820ec65811d6ce3651cb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/tongyi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d93284c4e5cf60d7b45ceaac3db01ecfdcb4838b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/vertexai.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/vertexai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..63a45e94154bdeb510e358c10e6a703256958f02
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/vertexai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/vllm.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/vllm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c0c741a93baa6e8d35191448b10fd743e4404ea8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/vllm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/volcengine_maas.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/volcengine_maas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a6111f7864eb5d75f09249b2b61ab65d22af09b0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/volcengine_maas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/watsonxllm.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/watsonxllm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7d2ad1de49b97595eb4a70cca9800dc7cf7f9538
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/watsonxllm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/writer.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/writer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4cab16907df0de613d5ad1284fdb0e3d86f133fb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/writer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/xinference.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/xinference.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..63068521086de7f05d15870303f16d3511d5b34e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/xinference.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/__pycache__/yandex.cpython-311.pyc b/llm/Lib/site-packages/langchain/llms/__pycache__/yandex.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d99c2b222b77cc6bfe64305d3085841d16401b31
Binary files /dev/null and b/llm/Lib/site-packages/langchain/llms/__pycache__/yandex.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/llms/ai21.py b/llm/Lib/site-packages/langchain/llms/ai21.py
new file mode 100644
index 0000000000000000000000000000000000000000..057f562b23a0d5f0c10ca6a6c5ae2280740721a5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/ai21.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.ai21 import AI21, AI21PenaltyData
+
+__all__ = ["AI21PenaltyData", "AI21"]
diff --git a/llm/Lib/site-packages/langchain/llms/aleph_alpha.py b/llm/Lib/site-packages/langchain/llms/aleph_alpha.py
new file mode 100644
index 0000000000000000000000000000000000000000..47158e60b3a43e2b38b6cdc9effa8061aecf4837
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/aleph_alpha.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.aleph_alpha import AlephAlpha
+
+__all__ = ["AlephAlpha"]
diff --git a/llm/Lib/site-packages/langchain/llms/amazon_api_gateway.py b/llm/Lib/site-packages/langchain/llms/amazon_api_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d18a35154a6afaf442dd081fb5b8d17fafea5d9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/amazon_api_gateway.py
@@ -0,0 +1,5 @@
+from langchain_community.llms.amazon_api_gateway import (
+    AmazonAPIGateway,
+)
+
+__all__ = ["AmazonAPIGateway"]
diff --git a/llm/Lib/site-packages/langchain/llms/anthropic.py b/llm/Lib/site-packages/langchain/llms/anthropic.py
new file mode 100644
index 0000000000000000000000000000000000000000..425d0906e9be396cb7c38170a819bad0f96fbcfe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/anthropic.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.anthropic import Anthropic
+
+__all__ = ["Anthropic"]
diff --git a/llm/Lib/site-packages/langchain/llms/anyscale.py b/llm/Lib/site-packages/langchain/llms/anyscale.py
new file mode 100644
index 0000000000000000000000000000000000000000..f5644089f5afee08facded66624ae186608b6c80
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/anyscale.py
@@ -0,0 +1,5 @@
+from langchain_community.llms.anyscale import (
+    Anyscale,
+)
+
+__all__ = ["Anyscale"]
diff --git a/llm/Lib/site-packages/langchain/llms/arcee.py b/llm/Lib/site-packages/langchain/llms/arcee.py
new file mode 100644
index 0000000000000000000000000000000000000000..f291f2e5ffcb9c9484d36e88d9418bf15cbb629a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/arcee.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.arcee import Arcee
+
+__all__ = ["Arcee"]
diff --git a/llm/Lib/site-packages/langchain/llms/aviary.py b/llm/Lib/site-packages/langchain/llms/aviary.py
new file mode 100644
index 0000000000000000000000000000000000000000..386f41b497e595262259c9276e4f77ddbc8cd99e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/aviary.py
@@ -0,0 +1,5 @@
+from langchain_community.llms.aviary import (
+    Aviary,
+)
+
+__all__ = ["Aviary"]
diff --git a/llm/Lib/site-packages/langchain/llms/azureml_endpoint.py b/llm/Lib/site-packages/langchain/llms/azureml_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce9cd07cf6c2f1b4ef2db9ebcf3591c9d375fc23
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/azureml_endpoint.py
@@ -0,0 +1,21 @@
+from langchain_community.llms.azureml_endpoint import (
+    AzureMLEndpointClient,
+    AzureMLOnlineEndpoint,
+    ContentFormatterBase,
+    CustomOpenAIContentFormatter,
+    DollyContentFormatter,
+    GPT2ContentFormatter,
+    HFContentFormatter,
+    OSSContentFormatter,
+)
+
+__all__ = [
+    "AzureMLEndpointClient",
+    "ContentFormatterBase",
+    "GPT2ContentFormatter",
+    "OSSContentFormatter",
+    "HFContentFormatter",
+    "DollyContentFormatter",
+    "CustomOpenAIContentFormatter",
+    "AzureMLOnlineEndpoint",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/baidu_qianfan_endpoint.py b/llm/Lib/site-packages/langchain/llms/baidu_qianfan_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..8776142d2b338dfcbab33ef229823535f2e130d0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/baidu_qianfan_endpoint.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.baidu_qianfan_endpoint import QianfanLLMEndpoint
+
+__all__ = ["QianfanLLMEndpoint"]
diff --git a/llm/Lib/site-packages/langchain/llms/bananadev.py b/llm/Lib/site-packages/langchain/llms/bananadev.py
new file mode 100644
index 0000000000000000000000000000000000000000..c30078e33d166233702defa670f8c862d6935875
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/bananadev.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.bananadev import Banana
+
+__all__ = ["Banana"]
diff --git a/llm/Lib/site-packages/langchain/llms/base.py b/llm/Lib/site-packages/langchain/llms/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..85bd0dd232c7e99c6bac8c6a0be1d2608d2fd230
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/base.py
@@ -0,0 +1,12 @@
+# Backwards compatibility.
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.language_models.llms import (
+    LLM,
+    BaseLLM,
+)
+
+__all__ = [
+    "BaseLanguageModel",
+    "BaseLLM",
+    "LLM",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/baseten.py b/llm/Lib/site-packages/langchain/llms/baseten.py
new file mode 100644
index 0000000000000000000000000000000000000000..750b25ff65bb5505e9bafe5d9b3092282c7831ec
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/baseten.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.baseten import Baseten
+
+__all__ = ["Baseten"]
diff --git a/llm/Lib/site-packages/langchain/llms/beam.py b/llm/Lib/site-packages/langchain/llms/beam.py
new file mode 100644
index 0000000000000000000000000000000000000000..d2ad695e2288360ff5dd40544efcffb7d9371946
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/beam.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.beam import Beam
+
+__all__ = ["Beam"]
diff --git a/llm/Lib/site-packages/langchain/llms/bedrock.py b/llm/Lib/site-packages/langchain/llms/bedrock.py
new file mode 100644
index 0000000000000000000000000000000000000000..7046810e0e776e929ab8381c3a55f961e4f80545
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/bedrock.py
@@ -0,0 +1,9 @@
+from langchain_community.llms.bedrock import (
+    Bedrock,
+    BedrockBase,
+)
+
+__all__ = [
+    "BedrockBase",
+    "Bedrock",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/bittensor.py b/llm/Lib/site-packages/langchain/llms/bittensor.py
new file mode 100644
index 0000000000000000000000000000000000000000..9fb0e7df5be607b291aaa8c3c0704ae2efa2e8af
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/bittensor.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.bittensor import NIBittensorLLM
+
+__all__ = ["NIBittensorLLM"]
diff --git a/llm/Lib/site-packages/langchain/llms/cerebriumai.py b/llm/Lib/site-packages/langchain/llms/cerebriumai.py
new file mode 100644
index 0000000000000000000000000000000000000000..ace400ed2734600c075f8c45fa60f147ee084ffd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/cerebriumai.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.cerebriumai import CerebriumAI
+
+__all__ = ["CerebriumAI"]
diff --git a/llm/Lib/site-packages/langchain/llms/chatglm.py b/llm/Lib/site-packages/langchain/llms/chatglm.py
new file mode 100644
index 0000000000000000000000000000000000000000..fbcd4b8d704251b44cf0ca39cfa3cdefdc151f3c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/chatglm.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.chatglm import ChatGLM
+
+__all__ = ["ChatGLM"]
diff --git a/llm/Lib/site-packages/langchain/llms/clarifai.py b/llm/Lib/site-packages/langchain/llms/clarifai.py
new file mode 100644
index 0000000000000000000000000000000000000000..ee3a7ea68246e5d469199bb0ab293b4d8d801e13
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/clarifai.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.clarifai import Clarifai
+
+__all__ = ["Clarifai"]
diff --git a/llm/Lib/site-packages/langchain/llms/cloudflare_workersai.py b/llm/Lib/site-packages/langchain/llms/cloudflare_workersai.py
new file mode 100644
index 0000000000000000000000000000000000000000..ad7951072c343cca4806aebd159e6199ca1e6b85
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/cloudflare_workersai.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.cloudflare_workersai import CloudflareWorkersAI
+
+__all__ = ["CloudflareWorkersAI"]
diff --git a/llm/Lib/site-packages/langchain/llms/cohere.py b/llm/Lib/site-packages/langchain/llms/cohere.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d1b24d8b8793a5df112777bc32841019a13d452
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/cohere.py
@@ -0,0 +1,7 @@
+from langchain_community.llms.cohere import (
+    Cohere,
+)
+
+__all__ = [
+    "Cohere",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/ctransformers.py b/llm/Lib/site-packages/langchain/llms/ctransformers.py
new file mode 100644
index 0000000000000000000000000000000000000000..370dd6f26146000375500b2195af352176efd808
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/ctransformers.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.ctransformers import CTransformers
+
+__all__ = ["CTransformers"]
diff --git a/llm/Lib/site-packages/langchain/llms/ctranslate2.py b/llm/Lib/site-packages/langchain/llms/ctranslate2.py
new file mode 100644
index 0000000000000000000000000000000000000000..43a704e613f1679ff91cfa0b7638705e0efcc8f2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/ctranslate2.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.ctranslate2 import CTranslate2
+
+__all__ = ["CTranslate2"]
diff --git a/llm/Lib/site-packages/langchain/llms/databricks.py b/llm/Lib/site-packages/langchain/llms/databricks.py
new file mode 100644
index 0000000000000000000000000000000000000000..bcf55b35ebf77753af85a424ceba845915bdd0ad
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/databricks.py
@@ -0,0 +1,7 @@
+from langchain_community.llms.databricks import (
+    Databricks,
+)
+
+__all__ = [
+    "Databricks",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/deepinfra.py b/llm/Lib/site-packages/langchain/llms/deepinfra.py
new file mode 100644
index 0000000000000000000000000000000000000000..35cb21c58594d30e1596930441c8aea2fff8f349
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/deepinfra.py
@@ -0,0 +1,7 @@
+from langchain_community.llms.deepinfra import (
+    DeepInfra,
+)
+
+__all__ = [
+    "DeepInfra",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/deepsparse.py b/llm/Lib/site-packages/langchain/llms/deepsparse.py
new file mode 100644
index 0000000000000000000000000000000000000000..c5a8a69d48ae17ffc4d0d205c2c124048603c812
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/deepsparse.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.deepsparse import DeepSparse
+
+__all__ = ["DeepSparse"]
diff --git a/llm/Lib/site-packages/langchain/llms/edenai.py b/llm/Lib/site-packages/langchain/llms/edenai.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a00f0517ee0add31318f450bfd0a99f0d6cc3fe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/edenai.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.edenai import EdenAI
+
+__all__ = ["EdenAI"]
diff --git a/llm/Lib/site-packages/langchain/llms/fake.py b/llm/Lib/site-packages/langchain/llms/fake.py
new file mode 100644
index 0000000000000000000000000000000000000000..4cf3466767410b720f305fdc9928c856c12250fb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/fake.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.fake import FakeListLLM, FakeStreamingListLLM
+
+__all__ = ["FakeListLLM", "FakeStreamingListLLM"]
diff --git a/llm/Lib/site-packages/langchain/llms/fireworks.py b/llm/Lib/site-packages/langchain/llms/fireworks.py
new file mode 100644
index 0000000000000000000000000000000000000000..d9b5b96713e9b2176444facbaed1a32e13a58c1f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/fireworks.py
@@ -0,0 +1,7 @@
+from langchain_community.llms.fireworks import (
+    Fireworks,
+)
+
+__all__ = [
+    "Fireworks",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/forefrontai.py b/llm/Lib/site-packages/langchain/llms/forefrontai.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d9e99e1462805ced63926f878c86e785354dcad
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/forefrontai.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.forefrontai import ForefrontAI
+
+__all__ = ["ForefrontAI"]
diff --git a/llm/Lib/site-packages/langchain/llms/gigachat.py b/llm/Lib/site-packages/langchain/llms/gigachat.py
new file mode 100644
index 0000000000000000000000000000000000000000..d85966035a211ad875dd256737a1c710100c07a0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/gigachat.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.gigachat import GigaChat
+
+__all__ = ["GigaChat"]
diff --git a/llm/Lib/site-packages/langchain/llms/google_palm.py b/llm/Lib/site-packages/langchain/llms/google_palm.py
new file mode 100644
index 0000000000000000000000000000000000000000..fa3e3bcf64fc4c47c3658ea1032d4f87dde67b3b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/google_palm.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.google_palm import GooglePalm
+
+__all__ = ["GooglePalm"]
diff --git a/llm/Lib/site-packages/langchain/llms/gooseai.py b/llm/Lib/site-packages/langchain/llms/gooseai.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba2a4249f2376ba51c6b7ab99245f5f9b29559f8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/gooseai.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.gooseai import GooseAI
+
+__all__ = ["GooseAI"]
diff --git a/llm/Lib/site-packages/langchain/llms/gpt4all.py b/llm/Lib/site-packages/langchain/llms/gpt4all.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a47af26ac81a9ce33be0cd371d668cc1e7a5ba3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/gpt4all.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.gpt4all import GPT4All
+
+__all__ = ["GPT4All"]
diff --git a/llm/Lib/site-packages/langchain/llms/gradient_ai.py b/llm/Lib/site-packages/langchain/llms/gradient_ai.py
new file mode 100644
index 0000000000000000000000000000000000000000..05a950b733d34f48bab3801d08a00d7ce7bd342b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/gradient_ai.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.gradient_ai import GradientLLM, TrainResult
+
+__all__ = ["TrainResult", "GradientLLM"]
diff --git a/llm/Lib/site-packages/langchain/llms/grammars/json.gbnf b/llm/Lib/site-packages/langchain/llms/grammars/json.gbnf
new file mode 100644
index 0000000000000000000000000000000000000000..61bd2b2e65bf9c2632dc7713a8bed5420bebef28
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/grammars/json.gbnf
@@ -0,0 +1,29 @@
+# Grammar for subset of JSON - doesn't support full string or number syntax
+
+root  ::= object
+value ::= object | array | string | number | boolean | "null"
+
+object ::=
+  "{" ws (
+            string ":" ws value
+    ("," ws string ":" ws value)*
+  )? "}"
+
+array  ::=
+  "[" ws (
+            value
+    ("," ws value)*
+  )? "]"
+
+string  ::=
+  "\"" (
+    [^"\\] |
+    "\\" (["\\/bfnrt] | "u" [0-9a-fA-F] [0-9a-fA-F] [0-9a-fA-F] [0-9a-fA-F]) # escapes
+  )* "\"" ws
+
+# Only plain integers currently
+number  ::= "-"? [0-9]+ ws
+boolean ::= ("true" | "false") ws
+
+# Optional space: by convention, applied in this grammar after literal chars when allowed
+ws ::= ([ \t\n] ws)?
\ No newline at end of file
diff --git a/llm/Lib/site-packages/langchain/llms/grammars/list.gbnf b/llm/Lib/site-packages/langchain/llms/grammars/list.gbnf
new file mode 100644
index 0000000000000000000000000000000000000000..30ea6e0c8499de5837b52dc55e9be9cbba158f5e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/grammars/list.gbnf
@@ -0,0 +1,14 @@
+root ::= "[" items "]" EOF
+
+items ::= item ("," ws* item)*
+
+item ::= string
+
+string  ::=
+  "\"" word (ws+ word)* "\"" ws*
+
+word ::= [a-zA-Z]+
+
+ws ::= " "
+
+EOF ::= "\n"
\ No newline at end of file
diff --git a/llm/Lib/site-packages/langchain/llms/huggingface_endpoint.py b/llm/Lib/site-packages/langchain/llms/huggingface_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..dde6a77898a80cf2dd7961cf7d016dec6ee254c0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/huggingface_endpoint.py
@@ -0,0 +1,5 @@
+from langchain_community.llms.huggingface_endpoint import (
+    HuggingFaceEndpoint,
+)
+
+__all__ = ["HuggingFaceEndpoint"]
diff --git a/llm/Lib/site-packages/langchain/llms/huggingface_hub.py b/llm/Lib/site-packages/langchain/llms/huggingface_hub.py
new file mode 100644
index 0000000000000000000000000000000000000000..80d3f6d3263d69e750eb51d6ff0ada33540c5937
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/huggingface_hub.py
@@ -0,0 +1,5 @@
+from langchain_community.llms.huggingface_hub import (
+    HuggingFaceHub,
+)
+
+__all__ = ["HuggingFaceHub"]
diff --git a/llm/Lib/site-packages/langchain/llms/huggingface_pipeline.py b/llm/Lib/site-packages/langchain/llms/huggingface_pipeline.py
new file mode 100644
index 0000000000000000000000000000000000000000..d69f5e9011038665009a087a21609403597c46a8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/huggingface_pipeline.py
@@ -0,0 +1,7 @@
+from langchain_community.llms.huggingface_pipeline import (
+    HuggingFacePipeline,
+)
+
+__all__ = [
+    "HuggingFacePipeline",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/huggingface_text_gen_inference.py b/llm/Lib/site-packages/langchain/llms/huggingface_text_gen_inference.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4842798461bccce86cee490569a234756e8b956
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/huggingface_text_gen_inference.py
@@ -0,0 +1,5 @@
+from langchain_community.llms.huggingface_text_gen_inference import (
+    HuggingFaceTextGenInference,
+)
+
+__all__ = ["HuggingFaceTextGenInference"]
diff --git a/llm/Lib/site-packages/langchain/llms/human.py b/llm/Lib/site-packages/langchain/llms/human.py
new file mode 100644
index 0000000000000000000000000000000000000000..3eeafb9cd350637bbea61b5bc77d94c585f7ff3a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/human.py
@@ -0,0 +1,5 @@
+from langchain_community.llms.human import (
+    HumanInputLLM,
+)
+
+__all__ = ["HumanInputLLM"]
diff --git a/llm/Lib/site-packages/langchain/llms/javelin_ai_gateway.py b/llm/Lib/site-packages/langchain/llms/javelin_ai_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..037b659ad02a03bf2911cc906492a5d073adcbbb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/javelin_ai_gateway.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.javelin_ai_gateway import JavelinAIGateway, Params
+
+__all__ = ["JavelinAIGateway", "Params"]
diff --git a/llm/Lib/site-packages/langchain/llms/koboldai.py b/llm/Lib/site-packages/langchain/llms/koboldai.py
new file mode 100644
index 0000000000000000000000000000000000000000..26d10f6847d49a2245cb0635a82c1c590987cf5f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/koboldai.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.koboldai import KoboldApiLLM
+
+__all__ = ["KoboldApiLLM"]
diff --git a/llm/Lib/site-packages/langchain/llms/llamacpp.py b/llm/Lib/site-packages/langchain/llms/llamacpp.py
new file mode 100644
index 0000000000000000000000000000000000000000..989e97f9b50c8919d0fa0c8029dc107e614796c9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/llamacpp.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.llamacpp import LlamaCpp
+
+__all__ = ["LlamaCpp"]
diff --git a/llm/Lib/site-packages/langchain/llms/loading.py b/llm/Lib/site-packages/langchain/llms/loading.py
new file mode 100644
index 0000000000000000000000000000000000000000..f2161e9d2ecf7ad3dfb10fa9c7a32350fef9be2c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/loading.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.loading import load_llm, load_llm_from_config
+
+__all__ = ["load_llm_from_config", "load_llm"]
diff --git a/llm/Lib/site-packages/langchain/llms/manifest.py b/llm/Lib/site-packages/langchain/llms/manifest.py
new file mode 100644
index 0000000000000000000000000000000000000000..e61618d697e9664cde4b72782e95f1a4f01766d8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/manifest.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.manifest import ManifestWrapper
+
+__all__ = ["ManifestWrapper"]
diff --git a/llm/Lib/site-packages/langchain/llms/minimax.py b/llm/Lib/site-packages/langchain/llms/minimax.py
new file mode 100644
index 0000000000000000000000000000000000000000..61baa63433287ae41fddd64e71980ffd1b965b39
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/minimax.py
@@ -0,0 +1,5 @@
+from langchain_community.llms.minimax import (
+    Minimax,
+)
+
+__all__ = ["Minimax"]
diff --git a/llm/Lib/site-packages/langchain/llms/mlflow.py b/llm/Lib/site-packages/langchain/llms/mlflow.py
new file mode 100644
index 0000000000000000000000000000000000000000..490e98cb5e93a54ba33de29304e1cbf9162d0849
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/mlflow.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.mlflow import Mlflow
+
+__all__ = ["Mlflow"]
diff --git a/llm/Lib/site-packages/langchain/llms/mlflow_ai_gateway.py b/llm/Lib/site-packages/langchain/llms/mlflow_ai_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c231a569aa1989e23785e7b283dee78a350814b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/mlflow_ai_gateway.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.mlflow_ai_gateway import MlflowAIGateway
+
+__all__ = ["MlflowAIGateway"]
diff --git a/llm/Lib/site-packages/langchain/llms/modal.py b/llm/Lib/site-packages/langchain/llms/modal.py
new file mode 100644
index 0000000000000000000000000000000000000000..7bb77f99a54c376aa6cef0cf08be574ad10e63fd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/modal.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.modal import Modal
+
+__all__ = ["Modal"]
diff --git a/llm/Lib/site-packages/langchain/llms/mosaicml.py b/llm/Lib/site-packages/langchain/llms/mosaicml.py
new file mode 100644
index 0000000000000000000000000000000000000000..59145fac91a39fe1043740c9516346ec6b1ac9bc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/mosaicml.py
@@ -0,0 +1,7 @@
+from langchain_community.llms.mosaicml import (
+    MosaicML,
+)
+
+__all__ = [
+    "MosaicML",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/nlpcloud.py b/llm/Lib/site-packages/langchain/llms/nlpcloud.py
new file mode 100644
index 0000000000000000000000000000000000000000..e31b15e236e73055acd048ecc0511bec0a03edae
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/nlpcloud.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.nlpcloud import NLPCloud
+
+__all__ = ["NLPCloud"]
diff --git a/llm/Lib/site-packages/langchain/llms/octoai_endpoint.py b/llm/Lib/site-packages/langchain/llms/octoai_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..0e5aea55e10836cfc28e0ff98922dc52957d595a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/octoai_endpoint.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.octoai_endpoint import OctoAIEndpoint
+
+__all__ = ["OctoAIEndpoint"]
diff --git a/llm/Lib/site-packages/langchain/llms/ollama.py b/llm/Lib/site-packages/langchain/llms/ollama.py
new file mode 100644
index 0000000000000000000000000000000000000000..03a2aa691c33c7b9f630c4337433afb389b5072e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/ollama.py
@@ -0,0 +1,5 @@
+from langchain_community.llms.ollama import (
+    Ollama,
+)
+
+__all__ = ["Ollama"]
diff --git a/llm/Lib/site-packages/langchain/llms/opaqueprompts.py b/llm/Lib/site-packages/langchain/llms/opaqueprompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..313938053a08d3e932ae9e6b6a876830046fe45b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/opaqueprompts.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.opaqueprompts import OpaquePrompts
+
+__all__ = ["OpaquePrompts"]
diff --git a/llm/Lib/site-packages/langchain/llms/openai.py b/llm/Lib/site-packages/langchain/llms/openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..d6ee8ef5e0b5c15d1d75436240978b451930de06
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/openai.py
@@ -0,0 +1,13 @@
+from langchain_community.llms.openai import (
+    AzureOpenAI,
+    BaseOpenAI,
+    OpenAI,
+    OpenAIChat,
+)
+
+__all__ = [
+    "BaseOpenAI",
+    "OpenAI",
+    "AzureOpenAI",
+    "OpenAIChat",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/openllm.py b/llm/Lib/site-packages/langchain/llms/openllm.py
new file mode 100644
index 0000000000000000000000000000000000000000..c6ddc5435ec4f8b1845e97a627415f1982be7b4c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/openllm.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.openllm import OpenLLM
+
+__all__ = ["OpenLLM"]
diff --git a/llm/Lib/site-packages/langchain/llms/openlm.py b/llm/Lib/site-packages/langchain/llms/openlm.py
new file mode 100644
index 0000000000000000000000000000000000000000..e8c8a1db377251d8d055075cd0edac537915d986
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/openlm.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.openlm import OpenLM
+
+__all__ = ["OpenLM"]
diff --git a/llm/Lib/site-packages/langchain/llms/pai_eas_endpoint.py b/llm/Lib/site-packages/langchain/llms/pai_eas_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..2101381175ea732ddcae984dc435ae086c860207
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/pai_eas_endpoint.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.pai_eas_endpoint import PaiEasEndpoint
+
+__all__ = ["PaiEasEndpoint"]
diff --git a/llm/Lib/site-packages/langchain/llms/petals.py b/llm/Lib/site-packages/langchain/llms/petals.py
new file mode 100644
index 0000000000000000000000000000000000000000..d5c5b4da5ca3d3933cdc3c6c428c78804e837fce
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/petals.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.petals import Petals
+
+__all__ = ["Petals"]
diff --git a/llm/Lib/site-packages/langchain/llms/pipelineai.py b/llm/Lib/site-packages/langchain/llms/pipelineai.py
new file mode 100644
index 0000000000000000000000000000000000000000..88462511a7b197260554cd0299933afc312119d4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/pipelineai.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.pipelineai import PipelineAI
+
+__all__ = ["PipelineAI"]
diff --git a/llm/Lib/site-packages/langchain/llms/predibase.py b/llm/Lib/site-packages/langchain/llms/predibase.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc949b0afa9cf119c55141fddc5226f3d715aab3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/predibase.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.predibase import Predibase
+
+__all__ = ["Predibase"]
diff --git a/llm/Lib/site-packages/langchain/llms/predictionguard.py b/llm/Lib/site-packages/langchain/llms/predictionguard.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a65658b700c83739b5236737f33d2875bc7aac1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/predictionguard.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.predictionguard import PredictionGuard
+
+__all__ = ["PredictionGuard"]
diff --git a/llm/Lib/site-packages/langchain/llms/promptlayer_openai.py b/llm/Lib/site-packages/langchain/llms/promptlayer_openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..880e0b6619ff5c9bf23ca6805488088041933ca1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/promptlayer_openai.py
@@ -0,0 +1,6 @@
+from langchain_community.llms.promptlayer_openai import (
+    PromptLayerOpenAI,
+    PromptLayerOpenAIChat,
+)
+
+__all__ = ["PromptLayerOpenAI", "PromptLayerOpenAIChat"]
diff --git a/llm/Lib/site-packages/langchain/llms/replicate.py b/llm/Lib/site-packages/langchain/llms/replicate.py
new file mode 100644
index 0000000000000000000000000000000000000000..8fce36573204aa1ee33599ac7f8421d9ea35b752
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/replicate.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.replicate import Replicate
+
+__all__ = ["Replicate"]
diff --git a/llm/Lib/site-packages/langchain/llms/rwkv.py b/llm/Lib/site-packages/langchain/llms/rwkv.py
new file mode 100644
index 0000000000000000000000000000000000000000..69350d36720a3ac381232754c67cbc3abd8d10ee
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/rwkv.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.rwkv import RWKV
+
+__all__ = ["RWKV"]
diff --git a/llm/Lib/site-packages/langchain/llms/sagemaker_endpoint.py b/llm/Lib/site-packages/langchain/llms/sagemaker_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f22908c7bb1019e98054aeb9712dd62d8c107b8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/sagemaker_endpoint.py
@@ -0,0 +1,6 @@
+from langchain_community.llms.sagemaker_endpoint import (
+    LLMContentHandler,
+    SagemakerEndpoint,
+)
+
+__all__ = ["SagemakerEndpoint", "LLMContentHandler"]
diff --git a/llm/Lib/site-packages/langchain/llms/self_hosted.py b/llm/Lib/site-packages/langchain/llms/self_hosted.py
new file mode 100644
index 0000000000000000000000000000000000000000..0cdcbd4514e2d62adc37e7e939324d5a4f56947c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/self_hosted.py
@@ -0,0 +1,5 @@
+from langchain_community.llms.self_hosted import (
+    SelfHostedPipeline,
+)
+
+__all__ = ["SelfHostedPipeline"]
diff --git a/llm/Lib/site-packages/langchain/llms/self_hosted_hugging_face.py b/llm/Lib/site-packages/langchain/llms/self_hosted_hugging_face.py
new file mode 100644
index 0000000000000000000000000000000000000000..9833af77083c1b09c7d05de68fe84245284d7e56
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/self_hosted_hugging_face.py
@@ -0,0 +1,7 @@
+from langchain_community.llms.self_hosted_hugging_face import (
+    SelfHostedHuggingFaceLLM,
+)
+
+__all__ = [
+    "SelfHostedHuggingFaceLLM",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/stochasticai.py b/llm/Lib/site-packages/langchain/llms/stochasticai.py
new file mode 100644
index 0000000000000000000000000000000000000000..24ae9f7b2a37257bd4353727487f69b97ae29766
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/stochasticai.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.stochasticai import StochasticAI
+
+__all__ = ["StochasticAI"]
diff --git a/llm/Lib/site-packages/langchain/llms/symblai_nebula.py b/llm/Lib/site-packages/langchain/llms/symblai_nebula.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4123f3be401f58a5021bdba50c9aa58db5e44c9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/symblai_nebula.py
@@ -0,0 +1,7 @@
+from langchain_community.llms.symblai_nebula import (
+    Nebula,
+)
+
+__all__ = [
+    "Nebula",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/textgen.py b/llm/Lib/site-packages/langchain/llms/textgen.py
new file mode 100644
index 0000000000000000000000000000000000000000..4494d3b62efddd1303a0a0457d954a53a787b76e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/textgen.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.textgen import TextGen
+
+__all__ = ["TextGen"]
diff --git a/llm/Lib/site-packages/langchain/llms/titan_takeoff.py b/llm/Lib/site-packages/langchain/llms/titan_takeoff.py
new file mode 100644
index 0000000000000000000000000000000000000000..e166a1aa71504d949b55e7d9df25d6338434f254
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/titan_takeoff.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.titan_takeoff import TitanTakeoff
+
+__all__ = ["TitanTakeoff"]
diff --git a/llm/Lib/site-packages/langchain/llms/titan_takeoff_pro.py b/llm/Lib/site-packages/langchain/llms/titan_takeoff_pro.py
new file mode 100644
index 0000000000000000000000000000000000000000..12f73d32bc33b1d3b68a4dfc1e1121b42f31e20a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/titan_takeoff_pro.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.titan_takeoff_pro import TitanTakeoffPro
+
+__all__ = ["TitanTakeoffPro"]
diff --git a/llm/Lib/site-packages/langchain/llms/together.py b/llm/Lib/site-packages/langchain/llms/together.py
new file mode 100644
index 0000000000000000000000000000000000000000..86a91be8fa2f731898bc742d6517dfa0669254b8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/together.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.together import Together
+
+__all__ = ["Together"]
diff --git a/llm/Lib/site-packages/langchain/llms/tongyi.py b/llm/Lib/site-packages/langchain/llms/tongyi.py
new file mode 100644
index 0000000000000000000000000000000000000000..e113714e883af32256f0cd9eeffa5cacf3a756d0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/tongyi.py
@@ -0,0 +1,7 @@
+from langchain_community.llms.tongyi import (
+    Tongyi,
+)
+
+__all__ = [
+    "Tongyi",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/utils.py b/llm/Lib/site-packages/langchain/llms/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..a33777b7a3f6583aa3717922b15b8161c183fd42
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/utils.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.utils import enforce_stop_tokens
+
+__all__ = ["enforce_stop_tokens"]
diff --git a/llm/Lib/site-packages/langchain/llms/vertexai.py b/llm/Lib/site-packages/langchain/llms/vertexai.py
new file mode 100644
index 0000000000000000000000000000000000000000..ee663b28295d3218c2c8caa31e1ddd71651741d4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/vertexai.py
@@ -0,0 +1,9 @@
+from langchain_community.llms.vertexai import (
+    VertexAI,
+    VertexAIModelGarden,
+)
+
+__all__ = [
+    "VertexAI",
+    "VertexAIModelGarden",
+]
diff --git a/llm/Lib/site-packages/langchain/llms/vllm.py b/llm/Lib/site-packages/langchain/llms/vllm.py
new file mode 100644
index 0000000000000000000000000000000000000000..2328d0c368424c714c48aa3940682094923e82a5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/vllm.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.vllm import VLLM, VLLMOpenAI
+
+__all__ = ["VLLM", "VLLMOpenAI"]
diff --git a/llm/Lib/site-packages/langchain/llms/volcengine_maas.py b/llm/Lib/site-packages/langchain/llms/volcengine_maas.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc8a82e86ec793ed7f4cc04c3a5ed6de4b842c0b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/volcengine_maas.py
@@ -0,0 +1,6 @@
+from langchain_community.llms.volcengine_maas import (
+    VolcEngineMaasBase,
+    VolcEngineMaasLLM,
+)
+
+__all__ = ["VolcEngineMaasBase", "VolcEngineMaasLLM"]
diff --git a/llm/Lib/site-packages/langchain/llms/watsonxllm.py b/llm/Lib/site-packages/langchain/llms/watsonxllm.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba587ab7008270198ecf953b2586ee7ed740b6c7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/watsonxllm.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.watsonxllm import WatsonxLLM
+
+__all__ = ["WatsonxLLM"]
diff --git a/llm/Lib/site-packages/langchain/llms/writer.py b/llm/Lib/site-packages/langchain/llms/writer.py
new file mode 100644
index 0000000000000000000000000000000000000000..0a84861bc7f0f3ccd071dcd91d49a4215baf9070
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/writer.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.writer import Writer
+
+__all__ = ["Writer"]
diff --git a/llm/Lib/site-packages/langchain/llms/xinference.py b/llm/Lib/site-packages/langchain/llms/xinference.py
new file mode 100644
index 0000000000000000000000000000000000000000..3caaee88990c3de77b88c97717bd307c9d39a2cb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/xinference.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.xinference import Xinference
+
+__all__ = ["Xinference"]
diff --git a/llm/Lib/site-packages/langchain/llms/yandex.py b/llm/Lib/site-packages/langchain/llms/yandex.py
new file mode 100644
index 0000000000000000000000000000000000000000..4216ffeb4667c9149776921c4458e4918b60235f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/llms/yandex.py
@@ -0,0 +1,3 @@
+from langchain_community.llms.yandex import YandexGPT
+
+__all__ = ["YandexGPT"]
diff --git a/llm/Lib/site-packages/langchain/load/__init__.py b/llm/Lib/site-packages/langchain/load/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2cac05bb527ea8e96892663f68072c7ed880f656
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/load/__init__.py
@@ -0,0 +1,10 @@
+"""Serialization and deserialization."""
+from langchain_core.load.dump import dumpd, dumps
+from langchain_core.load.load import load, loads
+
+__all__ = [
+    "dumpd",
+    "dumps",
+    "load",
+    "loads",
+]
diff --git a/llm/Lib/site-packages/langchain/load/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/load/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cad02825c58562ba57a44767e7885875743ad8e0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/load/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/load/__pycache__/dump.cpython-311.pyc b/llm/Lib/site-packages/langchain/load/__pycache__/dump.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fc6d94a641e220bc17319b3aa82a24e907ad45d9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/load/__pycache__/dump.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/load/__pycache__/load.cpython-311.pyc b/llm/Lib/site-packages/langchain/load/__pycache__/load.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8100ead734acd362f613640bfdb62d3c59d2ebfa
Binary files /dev/null and b/llm/Lib/site-packages/langchain/load/__pycache__/load.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/load/__pycache__/serializable.cpython-311.pyc b/llm/Lib/site-packages/langchain/load/__pycache__/serializable.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..12b4c6545a3a27eeec728dc7fad930c252d78719
Binary files /dev/null and b/llm/Lib/site-packages/langchain/load/__pycache__/serializable.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/load/dump.py b/llm/Lib/site-packages/langchain/load/dump.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd9552018c8c88943c3c8a6e7f3991efe13c7502
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/load/dump.py
@@ -0,0 +1,3 @@
+from langchain_core.load.dump import default, dumpd, dumps
+
+__all__ = ["default", "dumps", "dumpd"]
diff --git a/llm/Lib/site-packages/langchain/load/load.py b/llm/Lib/site-packages/langchain/load/load.py
new file mode 100644
index 0000000000000000000000000000000000000000..5a32ea081f0e697c85eb109c000e3006b11971b4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/load/load.py
@@ -0,0 +1,3 @@
+from langchain_core.load.load import Reviver, load, loads
+
+__all__ = ["Reviver", "loads", "load"]
diff --git a/llm/Lib/site-packages/langchain/load/serializable.py b/llm/Lib/site-packages/langchain/load/serializable.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1c0772d61d94d837ca1b39d7d4bcabd8b4bf449
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/load/serializable.py
@@ -0,0 +1,19 @@
+from langchain_core.load.serializable import (
+    BaseSerialized,
+    Serializable,
+    SerializedConstructor,
+    SerializedNotImplemented,
+    SerializedSecret,
+    to_json_not_implemented,
+    try_neq_default,
+)
+
+__all__ = [
+    "BaseSerialized",
+    "SerializedConstructor",
+    "SerializedSecret",
+    "SerializedNotImplemented",
+    "try_neq_default",
+    "Serializable",
+    "to_json_not_implemented",
+]
diff --git a/llm/Lib/site-packages/langchain/memory/__init__.py b/llm/Lib/site-packages/langchain/memory/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..dda324bc32da999631b7e263324645ecc9632912
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/__init__.py
@@ -0,0 +1,108 @@
+"""**Memory** maintains Chain state, incorporating context from past runs.
+
+**Class hierarchy for Memory:**
+
+.. code-block::
+
+    BaseMemory --> BaseChatMemory --> <name>Memory  # Examples: ZepMemory, MotorheadMemory
+
+**Main helpers:**
+
+.. code-block::
+
+    BaseChatMessageHistory
+
+**Chat Message History** stores the chat message history in different stores.
+
+**Class hierarchy for ChatMessageHistory:**
+
+.. code-block::
+
+    BaseChatMessageHistory --> <name>ChatMessageHistory  # Example: ZepChatMessageHistory
+
+**Main helpers:**
+
+.. code-block::
+
+    AIMessage, BaseMessage, HumanMessage
+"""  # noqa: E501
+from langchain_community.chat_message_histories import (
+    AstraDBChatMessageHistory,
+    CassandraChatMessageHistory,
+    ChatMessageHistory,
+    CosmosDBChatMessageHistory,
+    DynamoDBChatMessageHistory,
+    ElasticsearchChatMessageHistory,
+    FileChatMessageHistory,
+    MomentoChatMessageHistory,
+    MongoDBChatMessageHistory,
+    PostgresChatMessageHistory,
+    RedisChatMessageHistory,
+    SingleStoreDBChatMessageHistory,
+    SQLChatMessageHistory,
+    StreamlitChatMessageHistory,
+    UpstashRedisChatMessageHistory,
+    XataChatMessageHistory,
+    ZepChatMessageHistory,
+)
+
+from langchain.memory.buffer import (
+    ConversationBufferMemory,
+    ConversationStringBufferMemory,
+)
+from langchain.memory.buffer_window import ConversationBufferWindowMemory
+from langchain.memory.combined import CombinedMemory
+from langchain.memory.entity import (
+    ConversationEntityMemory,
+    InMemoryEntityStore,
+    RedisEntityStore,
+    SQLiteEntityStore,
+    UpstashRedisEntityStore,
+)
+from langchain.memory.kg import ConversationKGMemory
+from langchain.memory.motorhead_memory import MotorheadMemory
+from langchain.memory.readonly import ReadOnlySharedMemory
+from langchain.memory.simple import SimpleMemory
+from langchain.memory.summary import ConversationSummaryMemory
+from langchain.memory.summary_buffer import ConversationSummaryBufferMemory
+from langchain.memory.token_buffer import ConversationTokenBufferMemory
+from langchain.memory.vectorstore import VectorStoreRetrieverMemory
+from langchain.memory.zep_memory import ZepMemory
+
+__all__ = [
+    "AstraDBChatMessageHistory",
+    "CassandraChatMessageHistory",
+    "ChatMessageHistory",
+    "CombinedMemory",
+    "ConversationBufferMemory",
+    "ConversationBufferWindowMemory",
+    "ConversationEntityMemory",
+    "ConversationKGMemory",
+    "ConversationStringBufferMemory",
+    "ConversationSummaryBufferMemory",
+    "ConversationSummaryMemory",
+    "ConversationTokenBufferMemory",
+    "CosmosDBChatMessageHistory",
+    "DynamoDBChatMessageHistory",
+    "ElasticsearchChatMessageHistory",
+    "FileChatMessageHistory",
+    "InMemoryEntityStore",
+    "MomentoChatMessageHistory",
+    "MongoDBChatMessageHistory",
+    "MotorheadMemory",
+    "PostgresChatMessageHistory",
+    "ReadOnlySharedMemory",
+    "RedisChatMessageHistory",
+    "RedisEntityStore",
+    "SingleStoreDBChatMessageHistory",
+    "SQLChatMessageHistory",
+    "SQLiteEntityStore",
+    "SimpleMemory",
+    "StreamlitChatMessageHistory",
+    "VectorStoreRetrieverMemory",
+    "XataChatMessageHistory",
+    "ZepChatMessageHistory",
+    "ZepMemory",
+    "UpstashRedisEntityStore",
+    "UpstashRedisChatMessageHistory",
+]
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..298affc0f3cc077512a6fa7189459fcef652a12f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/buffer.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/buffer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cddb159f2a069764256b6cb2925a1d17918f65e2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/buffer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/buffer_window.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/buffer_window.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2512c50f4c3f4b0257592e3bb338f56fd41b74b0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/buffer_window.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/chat_memory.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/chat_memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3ac23203e8a7f858ac5f2e7ae986dd1b076b1dd3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/chat_memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/combined.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/combined.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ba40ebda51a0fb01e2669576d088ceab05b05f5b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/combined.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/entity.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/entity.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..74a322a487b03d7c82a505c9d91baa54e23603a6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/entity.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/kg.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/kg.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ec2c4971cfe1251596cb58cdb1ccb875d3ca08b4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/kg.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/motorhead_memory.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/motorhead_memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8daf82c2ac6d757f9b562dc6a3b473fd71b8dfb9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/motorhead_memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..85eace2281bb0df4b62a3e5842d4bc65c2b4f282
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/readonly.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/readonly.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e3a1b5f3bef43725c5cb978773c7a5d62583b9c8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/readonly.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/simple.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/simple.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f8a966b5c17cf56120ba21ccfae7bfe99f8d1e3e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/simple.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/summary.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/summary.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..da1c0bd3a641cdc67dda20db7b121c66b9e80b38
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/summary.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/summary_buffer.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/summary_buffer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2e139aa8a28f42541b70f71362cf1bde242f5568
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/summary_buffer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/token_buffer.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/token_buffer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b59c7375bd3957e24bdb0c5fe95fcce6e1d8cff
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/token_buffer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..440cae0798e58813380b80cc5058fb504ce714ad
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/vectorstore.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/vectorstore.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c8718e221749daa8676b0bd5062970c019fc1d37
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/vectorstore.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/__pycache__/zep_memory.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/__pycache__/zep_memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..75daa72256ffcf5033f0eb22ff6f1ab778f58193
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/__pycache__/zep_memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/buffer.py b/llm/Lib/site-packages/langchain/memory/buffer.py
new file mode 100644
index 0000000000000000000000000000000000000000..3cc9b162dabc87251253e8abe35b572e962b66ee
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/buffer.py
@@ -0,0 +1,136 @@
+from typing import Any, Dict, List, Optional
+
+from langchain_core.messages import BaseMessage, get_buffer_string
+from langchain_core.pydantic_v1 import root_validator
+
+from langchain.memory.chat_memory import BaseChatMemory, BaseMemory
+from langchain.memory.utils import get_prompt_input_key
+
+
+class ConversationBufferMemory(BaseChatMemory):
+    """Buffer for storing conversation memory."""
+
+    human_prefix: str = "Human"
+    ai_prefix: str = "AI"
+    memory_key: str = "history"  #: :meta private:
+
+    @property
+    def buffer(self) -> Any:
+        """String buffer of memory."""
+        return self.buffer_as_messages if self.return_messages else self.buffer_as_str
+
+    async def abuffer(self) -> Any:
+        """String buffer of memory."""
+        return (
+            await self.abuffer_as_messages()
+            if self.return_messages
+            else await self.abuffer_as_str()
+        )
+
+    def _buffer_as_str(self, messages: List[BaseMessage]) -> str:
+        return get_buffer_string(
+            messages,
+            human_prefix=self.human_prefix,
+            ai_prefix=self.ai_prefix,
+        )
+
+    @property
+    def buffer_as_str(self) -> str:
+        """Exposes the buffer as a string in case return_messages is True."""
+        return self._buffer_as_str(self.chat_memory.messages)
+
+    async def abuffer_as_str(self) -> str:
+        """Exposes the buffer as a string in case return_messages is True."""
+        messages = await self.chat_memory.aget_messages()
+        return self._buffer_as_str(messages)
+
+    @property
+    def buffer_as_messages(self) -> List[BaseMessage]:
+        """Exposes the buffer as a list of messages in case return_messages is False."""
+        return self.chat_memory.messages
+
+    async def abuffer_as_messages(self) -> List[BaseMessage]:
+        """Exposes the buffer as a list of messages in case return_messages is False."""
+        return await self.chat_memory.aget_messages()
+
+    @property
+    def memory_variables(self) -> List[str]:
+        """Will always return list of memory variables.
+
+        :meta private:
+        """
+        return [self.memory_key]
+
+    def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, Any]:
+        """Return history buffer."""
+        return {self.memory_key: self.buffer}
+
+    async def aload_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, Any]:
+        """Return key-value pairs given the text input to the chain."""
+        buffer = await self.abuffer()
+        return {self.memory_key: buffer}
+
+
+class ConversationStringBufferMemory(BaseMemory):
+    """Buffer for storing conversation memory."""
+
+    human_prefix: str = "Human"
+    ai_prefix: str = "AI"
+    """Prefix to use for AI generated responses."""
+    buffer: str = ""
+    output_key: Optional[str] = None
+    input_key: Optional[str] = None
+    memory_key: str = "history"  #: :meta private:
+
+    @root_validator()
+    def validate_chains(cls, values: Dict) -> Dict:
+        """Validate that return messages is not True."""
+        if values.get("return_messages", False):
+            raise ValueError(
+                "return_messages must be False for ConversationStringBufferMemory"
+            )
+        return values
+
+    @property
+    def memory_variables(self) -> List[str]:
+        """Will always return list of memory variables.
+        :meta private:
+        """
+        return [self.memory_key]
+
+    def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, str]:
+        """Return history buffer."""
+        return {self.memory_key: self.buffer}
+
+    async def aload_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, str]:
+        """Return history buffer."""
+        return self.load_memory_variables(inputs)
+
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+        """Save context from this conversation to buffer."""
+        if self.input_key is None:
+            prompt_input_key = get_prompt_input_key(inputs, self.memory_variables)
+        else:
+            prompt_input_key = self.input_key
+        if self.output_key is None:
+            if len(outputs) != 1:
+                raise ValueError(f"One output key expected, got {outputs.keys()}")
+            output_key = list(outputs.keys())[0]
+        else:
+            output_key = self.output_key
+        human = f"{self.human_prefix}: " + inputs[prompt_input_key]
+        ai = f"{self.ai_prefix}: " + outputs[output_key]
+        self.buffer += "\n" + "\n".join([human, ai])
+
+    async def asave_context(
+        self, inputs: Dict[str, Any], outputs: Dict[str, str]
+    ) -> None:
+        """Save context from this conversation to buffer."""
+        return self.save_context(inputs, outputs)
+
+    def clear(self) -> None:
+        """Clear memory contents."""
+        self.buffer = ""
+
+    async def aclear(self) -> None:
+        self.clear()
diff --git a/llm/Lib/site-packages/langchain/memory/buffer_window.py b/llm/Lib/site-packages/langchain/memory/buffer_window.py
new file mode 100644
index 0000000000000000000000000000000000000000..b71b9d23baf4a6cb6a56bb4a2375e083805d9641
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/buffer_window.py
@@ -0,0 +1,47 @@
+from typing import Any, Dict, List, Union
+
+from langchain_core.messages import BaseMessage, get_buffer_string
+
+from langchain.memory.chat_memory import BaseChatMemory
+
+
+class ConversationBufferWindowMemory(BaseChatMemory):
+    """Buffer for storing conversation memory inside a limited size window."""
+
+    human_prefix: str = "Human"
+    ai_prefix: str = "AI"
+    memory_key: str = "history"  #: :meta private:
+    k: int = 5
+    """Number of messages to store in buffer."""
+
+    @property
+    def buffer(self) -> Union[str, List[BaseMessage]]:
+        """String buffer of memory."""
+        return self.buffer_as_messages if self.return_messages else self.buffer_as_str
+
+    @property
+    def buffer_as_str(self) -> str:
+        """Exposes the buffer as a string in case return_messages is False."""
+        messages = self.chat_memory.messages[-self.k * 2 :] if self.k > 0 else []
+        return get_buffer_string(
+            messages,
+            human_prefix=self.human_prefix,
+            ai_prefix=self.ai_prefix,
+        )
+
+    @property
+    def buffer_as_messages(self) -> List[BaseMessage]:
+        """Exposes the buffer as a list of messages in case return_messages is True."""
+        return self.chat_memory.messages[-self.k * 2 :] if self.k > 0 else []
+
+    @property
+    def memory_variables(self) -> List[str]:
+        """Will always return list of memory variables.
+
+        :meta private:
+        """
+        return [self.memory_key]
+
+    def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, Any]:
+        """Return history buffer."""
+        return {self.memory_key: self.buffer}
diff --git a/llm/Lib/site-packages/langchain/memory/chat_memory.py b/llm/Lib/site-packages/langchain/memory/chat_memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..671edf9f31b2ce27837037757d043fcde671a97f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_memory.py
@@ -0,0 +1,71 @@
+import warnings
+from abc import ABC
+from typing import Any, Dict, Optional, Tuple
+
+from langchain_community.chat_message_histories.in_memory import ChatMessageHistory
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.memory import BaseMemory
+from langchain_core.messages import AIMessage, HumanMessage
+from langchain_core.pydantic_v1 import Field
+
+from langchain.memory.utils import get_prompt_input_key
+
+
+class BaseChatMemory(BaseMemory, ABC):
+    """Abstract base class for chat memory."""
+
+    chat_memory: BaseChatMessageHistory = Field(default_factory=ChatMessageHistory)
+    output_key: Optional[str] = None
+    input_key: Optional[str] = None
+    return_messages: bool = False
+
+    def _get_input_output(
+        self, inputs: Dict[str, Any], outputs: Dict[str, str]
+    ) -> Tuple[str, str]:
+        if self.input_key is None:
+            prompt_input_key = get_prompt_input_key(inputs, self.memory_variables)
+        else:
+            prompt_input_key = self.input_key
+        if self.output_key is None:
+            if len(outputs) == 1:
+                output_key = list(outputs.keys())[0]
+            elif "output" in outputs:
+                output_key = "output"
+                warnings.warn(
+                    f"'{self.__class__.__name__}' got multiple output keys:"
+                    f" {outputs.keys()}. The default 'output' key is being used."
+                    f" If this is not desired, please manually set 'output_key'."
+                )
+            else:
+                raise ValueError(
+                    f"Got multiple output keys: {outputs.keys()}, cannot "
+                    f"determine which to store in memory. Please set the "
+                    f"'output_key' explicitly."
+                )
+        else:
+            output_key = self.output_key
+        return inputs[prompt_input_key], outputs[output_key]
+
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+        """Save context from this conversation to buffer."""
+        input_str, output_str = self._get_input_output(inputs, outputs)
+        self.chat_memory.add_messages(
+            [HumanMessage(content=input_str), AIMessage(content=output_str)]
+        )
+
+    async def asave_context(
+        self, inputs: Dict[str, Any], outputs: Dict[str, str]
+    ) -> None:
+        """Save context from this conversation to buffer."""
+        input_str, output_str = self._get_input_output(inputs, outputs)
+        await self.chat_memory.aadd_messages(
+            [HumanMessage(content=input_str), AIMessage(content=output_str)]
+        )
+
+    def clear(self) -> None:
+        """Clear memory contents."""
+        self.chat_memory.clear()
+
+    async def aclear(self) -> None:
+        """Clear memory contents."""
+        await self.chat_memory.aclear()
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__init__.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..627d6eadd47fbed3d2157ee25c5528b3de589539
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__init__.py
@@ -0,0 +1,47 @@
+import warnings
+from typing import Any
+
+from langchain_core._api import LangChainDeprecationWarning
+
+from langchain.utils.interactive_env import is_interactive_env
+
+
+def __getattr__(name: str) -> Any:
+    from langchain_community import chat_message_histories
+
+    # If not in interactive env, raise warning.
+    if not is_interactive_env():
+        warnings.warn(
+            "Importing chat message histories from langchain is deprecated. Importing "
+            "from langchain will no longer be supported as of langchain==0.2.0. "
+            "Please import from langchain-community instead:\n\n"
+            f"`from langchain_community.chat_message_histories import {name}`.\n\n"
+            "To install langchain-community run `pip install -U langchain-community`.",
+            category=LangChainDeprecationWarning,
+        )
+
+    return getattr(chat_message_histories, name)
+
+
+__all__ = [
+    "AstraDBChatMessageHistory",
+    "ChatMessageHistory",
+    "CassandraChatMessageHistory",
+    "CosmosDBChatMessageHistory",
+    "DynamoDBChatMessageHistory",
+    "ElasticsearchChatMessageHistory",
+    "FileChatMessageHistory",
+    "FirestoreChatMessageHistory",
+    "MomentoChatMessageHistory",
+    "MongoDBChatMessageHistory",
+    "PostgresChatMessageHistory",
+    "RedisChatMessageHistory",
+    "RocksetChatMessageHistory",
+    "SQLChatMessageHistory",
+    "StreamlitChatMessageHistory",
+    "SingleStoreDBChatMessageHistory",
+    "XataChatMessageHistory",
+    "ZepChatMessageHistory",
+    "UpstashRedisChatMessageHistory",
+    "Neo4jChatMessageHistory",
+]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..69e31c4a9d3a508dbe5ce8ebd3c0c104839d41bd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/astradb.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/astradb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d4fbf01cf56186c378acbb08d1156bcb2c46df8c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/astradb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/cassandra.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/cassandra.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..16f7e861c966aac9f0e1dc269fb68dc23d8f7015
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/cassandra.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/cosmos_db.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/cosmos_db.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c8cc53496a5f0e0d41ec96d31c5eed4b9c4c9e8e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/cosmos_db.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/dynamodb.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/dynamodb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..65b38c2ce8f22e75bba5d31378795dd2e135d28c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/dynamodb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/elasticsearch.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/elasticsearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..06ed13810d2dc7493a9531ed2d560a5db0b877d8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/elasticsearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/file.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/file.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..66066c46cf8e393d402130cc20e0d4861ab0cfae
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/file.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/firestore.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/firestore.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0bb8c2bb475f3176ded1d39c9fd15ec4891f29e9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/firestore.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/in_memory.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/in_memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9fb887af65f5ac75907ec7ff551e2f192817236c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/in_memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/momento.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/momento.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..480f3fee34fbf29959b8d9ebdf9e1bc76b870641
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/momento.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/mongodb.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/mongodb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..461453855480df25b711a9dab418effcb2306d23
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/mongodb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/neo4j.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/neo4j.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3df97879aa434a6dee9c63e1f64a5237c9c8e54e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/neo4j.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/postgres.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/postgres.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..103005cdc039ca3c0b099011dc83748d1d0eddae
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/postgres.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/redis.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/redis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1da4d39aaedb837ebdb29c6b9471b0187698175b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/redis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/rocksetdb.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/rocksetdb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a2408c170d04bf5ce466eaabad2af49258cf515a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/rocksetdb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/singlestoredb.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/singlestoredb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8605ddc656cc6fcc53ad6fb3312c90855b0683b7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/singlestoredb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/sql.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/sql.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..44483260e86697a17574d66b0d7423d20f82d90f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/sql.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/streamlit.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/streamlit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..89bb69548c21b279dac382a53bdbfc3dd8aee455
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/streamlit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/upstash_redis.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/upstash_redis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dc21665bd2f12deb00c41dd6bfdc8b7f834cc052
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/upstash_redis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/xata.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/xata.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1213cafa6c294266c8587e641d2df74740d8037f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/xata.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/zep.cpython-311.pyc b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/zep.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..24d8047d974a6dcf2d0a99c29c51f5e9a2efaa3e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/memory/chat_message_histories/__pycache__/zep.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/astradb.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/astradb.py
new file mode 100644
index 0000000000000000000000000000000000000000..d10d90e640d6f8e4476458e4c667f25d3774507f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/astradb.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_message_histories.astradb import (
+    AstraDBChatMessageHistory,
+)
+
+__all__ = ["AstraDBChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/cassandra.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/cassandra.py
new file mode 100644
index 0000000000000000000000000000000000000000..24c2bf7a2fdd17eec3ea80943e5ad1d4dcb740ba
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/cassandra.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_message_histories.cassandra import (
+    CassandraChatMessageHistory,
+)
+
+__all__ = ["CassandraChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/cosmos_db.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/cosmos_db.py
new file mode 100644
index 0000000000000000000000000000000000000000..7d2c4cbeb3242a932e3fd1facc4a741fd3a4174d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/cosmos_db.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_message_histories.cosmos_db import (
+    CosmosDBChatMessageHistory,
+)
+
+__all__ = ["CosmosDBChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/dynamodb.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/dynamodb.py
new file mode 100644
index 0000000000000000000000000000000000000000..376e61ca621afd0981f1ed39a51450e671189dba
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/dynamodb.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_message_histories.dynamodb import (
+    DynamoDBChatMessageHistory,
+)
+
+__all__ = ["DynamoDBChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/elasticsearch.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/elasticsearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..b89553a73d850618d1749f9ce8bf968ab14bf423
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/elasticsearch.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_message_histories.elasticsearch import (
+    ElasticsearchChatMessageHistory,
+)
+
+__all__ = ["ElasticsearchChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/file.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/file.py
new file mode 100644
index 0000000000000000000000000000000000000000..aeb1a3b75d798fe706bd040cf368551e448f6061
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/file.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_message_histories.file import FileChatMessageHistory
+
+__all__ = ["FileChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/firestore.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/firestore.py
new file mode 100644
index 0000000000000000000000000000000000000000..52ff603408926e35cb0147bc9222e1ee91308ab9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/firestore.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_message_histories.firestore import (
+    FirestoreChatMessageHistory,
+)
+
+__all__ = ["FirestoreChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/in_memory.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/in_memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..d00d6de6956c59545072c87233707096e83554ad
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/in_memory.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_message_histories.in_memory import ChatMessageHistory
+
+__all__ = ["ChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/momento.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/momento.py
new file mode 100644
index 0000000000000000000000000000000000000000..3d7bfce96b5ca1a005fffa1abdfd4f8afa4af052
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/momento.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_message_histories.momento import (
+    MomentoChatMessageHistory,
+)
+
+__all__ = ["MomentoChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/mongodb.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/mongodb.py
new file mode 100644
index 0000000000000000000000000000000000000000..da7461dea2b2411ae46419052b56f1ba88777290
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/mongodb.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_message_histories.mongodb import (
+    MongoDBChatMessageHistory,
+)
+
+__all__ = ["MongoDBChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/neo4j.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/neo4j.py
new file mode 100644
index 0000000000000000000000000000000000000000..52a202ba8cb6d0831beca8250dc04c8cc7891494
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/neo4j.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_message_histories.neo4j import Neo4jChatMessageHistory
+
+__all__ = ["Neo4jChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/postgres.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/postgres.py
new file mode 100644
index 0000000000000000000000000000000000000000..9e0a921ca23846febeb7e82736be503f4575b98c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/postgres.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_message_histories.postgres import (
+    PostgresChatMessageHistory,
+)
+
+__all__ = ["PostgresChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/redis.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/redis.py
new file mode 100644
index 0000000000000000000000000000000000000000..0a81d2563b8827f6f6756fa79390d72554783d99
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/redis.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_message_histories.redis import RedisChatMessageHistory
+
+__all__ = ["RedisChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/rocksetdb.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/rocksetdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..f27ee6e66e1bd11e068df28d53789c4715c93a55
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/rocksetdb.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_message_histories.rocksetdb import (
+    RocksetChatMessageHistory,
+)
+
+__all__ = ["RocksetChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/singlestoredb.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/singlestoredb.py
new file mode 100644
index 0000000000000000000000000000000000000000..41756f6660a4970718380eb4ceb3ca4a895654c2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/singlestoredb.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_message_histories.singlestoredb import (
+    SingleStoreDBChatMessageHistory,
+)
+
+__all__ = ["SingleStoreDBChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/sql.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/sql.py
new file mode 100644
index 0000000000000000000000000000000000000000..f739eab04292e0985c9316f7c8583e245f946af4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/sql.py
@@ -0,0 +1,11 @@
+from langchain_community.chat_message_histories.sql import (
+    BaseMessageConverter,
+    DefaultMessageConverter,
+    SQLChatMessageHistory,
+)
+
+__all__ = [
+    "BaseMessageConverter",
+    "DefaultMessageConverter",
+    "SQLChatMessageHistory",
+]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/streamlit.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/streamlit.py
new file mode 100644
index 0000000000000000000000000000000000000000..82fd8de7b44d24bedd0460e051e64af035820874
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/streamlit.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_message_histories.streamlit import (
+    StreamlitChatMessageHistory,
+)
+
+__all__ = ["StreamlitChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/upstash_redis.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/upstash_redis.py
new file mode 100644
index 0000000000000000000000000000000000000000..d038fa46f513f47fae20c9e79eb620077f74bef3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/upstash_redis.py
@@ -0,0 +1,5 @@
+from langchain_community.chat_message_histories.upstash_redis import (
+    UpstashRedisChatMessageHistory,
+)
+
+__all__ = ["UpstashRedisChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/xata.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/xata.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc4490214fbd42c91a689a98a102feb658d642aa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/xata.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_message_histories.xata import XataChatMessageHistory
+
+__all__ = ["XataChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/chat_message_histories/zep.py b/llm/Lib/site-packages/langchain/memory/chat_message_histories/zep.py
new file mode 100644
index 0000000000000000000000000000000000000000..ef357b9a5acd5d358bebeca522f8156ee6ab8b5a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/chat_message_histories/zep.py
@@ -0,0 +1,3 @@
+from langchain_community.chat_message_histories.zep import ZepChatMessageHistory
+
+__all__ = ["ZepChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/memory/combined.py b/llm/Lib/site-packages/langchain/memory/combined.py
new file mode 100644
index 0000000000000000000000000000000000000000..5ab0048895bbaed3843e47decae1e989bfa48b93
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/combined.py
@@ -0,0 +1,82 @@
+import warnings
+from typing import Any, Dict, List, Set
+
+from langchain_core.memory import BaseMemory
+from langchain_core.pydantic_v1 import validator
+
+from langchain.memory.chat_memory import BaseChatMemory
+
+
+class CombinedMemory(BaseMemory):
+    """Combining multiple memories' data together."""
+
+    memories: List[BaseMemory]
+    """For tracking all the memories that should be accessed."""
+
+    @validator("memories")
+    def check_repeated_memory_variable(
+        cls, value: List[BaseMemory]
+    ) -> List[BaseMemory]:
+        all_variables: Set[str] = set()
+        for val in value:
+            overlap = all_variables.intersection(val.memory_variables)
+            if overlap:
+                raise ValueError(
+                    f"The same variables {overlap} are found in multiple"
+                    "memory object, which is not allowed by CombinedMemory."
+                )
+            all_variables |= set(val.memory_variables)
+
+        return value
+
+    @validator("memories")
+    def check_input_key(cls, value: List[BaseMemory]) -> List[BaseMemory]:
+        """Check that if memories are of type BaseChatMemory that input keys exist."""
+        for val in value:
+            if isinstance(val, BaseChatMemory):
+                if val.input_key is None:
+                    warnings.warn(
+                        "When using CombinedMemory, "
+                        "input keys should be so the input is known. "
+                        f" Was not set on {val}"
+                    )
+        return value
+
+    @property
+    def memory_variables(self) -> List[str]:
+        """All the memory variables that this instance provides."""
+        """Collected from the all the linked memories."""
+
+        memory_variables = []
+
+        for memory in self.memories:
+            memory_variables.extend(memory.memory_variables)
+
+        return memory_variables
+
+    def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, str]:
+        """Load all vars from sub-memories."""
+        memory_data: Dict[str, Any] = {}
+
+        # Collect vars from all sub-memories
+        for memory in self.memories:
+            data = memory.load_memory_variables(inputs)
+            for key, value in data.items():
+                if key in memory_data:
+                    raise ValueError(
+                        f"The variable {key} is repeated in the CombinedMemory."
+                    )
+                memory_data[key] = value
+
+        return memory_data
+
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+        """Save context from this session for every memory."""
+        # Save context for all sub-memories
+        for memory in self.memories:
+            memory.save_context(inputs, outputs)
+
+    def clear(self) -> None:
+        """Clear context from this session for every memory."""
+        for memory in self.memories:
+            memory.clear()
diff --git a/llm/Lib/site-packages/langchain/memory/entity.py b/llm/Lib/site-packages/langchain/memory/entity.py
new file mode 100644
index 0000000000000000000000000000000000000000..65b31cf2d34dc0c9a075265f494925f9690633d2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/entity.py
@@ -0,0 +1,483 @@
+import logging
+from abc import ABC, abstractmethod
+from itertools import islice
+from typing import Any, Dict, Iterable, List, Optional
+
+from langchain_community.utilities.redis import get_client
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.messages import BaseMessage, get_buffer_string
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain.chains.llm import LLMChain
+from langchain.memory.chat_memory import BaseChatMemory
+from langchain.memory.prompt import (
+    ENTITY_EXTRACTION_PROMPT,
+    ENTITY_SUMMARIZATION_PROMPT,
+)
+from langchain.memory.utils import get_prompt_input_key
+
+logger = logging.getLogger(__name__)
+
+
+class BaseEntityStore(BaseModel, ABC):
+    """Abstract base class for Entity store."""
+
+    @abstractmethod
+    def get(self, key: str, default: Optional[str] = None) -> Optional[str]:
+        """Get entity value from store."""
+        pass
+
+    @abstractmethod
+    def set(self, key: str, value: Optional[str]) -> None:
+        """Set entity value in store."""
+        pass
+
+    @abstractmethod
+    def delete(self, key: str) -> None:
+        """Delete entity value from store."""
+        pass
+
+    @abstractmethod
+    def exists(self, key: str) -> bool:
+        """Check if entity exists in store."""
+        pass
+
+    @abstractmethod
+    def clear(self) -> None:
+        """Delete all entities from store."""
+        pass
+
+
+class InMemoryEntityStore(BaseEntityStore):
+    """In-memory Entity store."""
+
+    store: Dict[str, Optional[str]] = {}
+
+    def get(self, key: str, default: Optional[str] = None) -> Optional[str]:
+        return self.store.get(key, default)
+
+    def set(self, key: str, value: Optional[str]) -> None:
+        self.store[key] = value
+
+    def delete(self, key: str) -> None:
+        del self.store[key]
+
+    def exists(self, key: str) -> bool:
+        return key in self.store
+
+    def clear(self) -> None:
+        return self.store.clear()
+
+
+class UpstashRedisEntityStore(BaseEntityStore):
+    """Upstash Redis backed Entity store.
+
+    Entities get a TTL of 1 day by default, and
+    that TTL is extended by 3 days every time the entity is read back.
+    """
+
+    def __init__(
+        self,
+        session_id: str = "default",
+        url: str = "",
+        token: str = "",
+        key_prefix: str = "memory_store",
+        ttl: Optional[int] = 60 * 60 * 24,
+        recall_ttl: Optional[int] = 60 * 60 * 24 * 3,
+        *args: Any,
+        **kwargs: Any,
+    ):
+        try:
+            from upstash_redis import Redis
+        except ImportError:
+            raise ImportError(
+                "Could not import upstash_redis python package. "
+                "Please install it with `pip install upstash_redis`."
+            )
+
+        super().__init__(*args, **kwargs)
+
+        try:
+            self.redis_client = Redis(url=url, token=token)
+        except Exception:
+            logger.error("Upstash Redis instance could not be initiated.")
+
+        self.session_id = session_id
+        self.key_prefix = key_prefix
+        self.ttl = ttl
+        self.recall_ttl = recall_ttl or ttl
+
+    @property
+    def full_key_prefix(self) -> str:
+        return f"{self.key_prefix}:{self.session_id}"
+
+    def get(self, key: str, default: Optional[str] = None) -> Optional[str]:
+        res = (
+            self.redis_client.getex(f"{self.full_key_prefix}:{key}", ex=self.recall_ttl)
+            or default
+            or ""
+        )
+        logger.debug(f"Upstash Redis MEM get '{self.full_key_prefix}:{key}': '{res}'")
+        return res
+
+    def set(self, key: str, value: Optional[str]) -> None:
+        if not value:
+            return self.delete(key)
+        self.redis_client.set(f"{self.full_key_prefix}:{key}", value, ex=self.ttl)
+        logger.debug(
+            f"Redis MEM set '{self.full_key_prefix}:{key}': '{value}' EX {self.ttl}"
+        )
+
+    def delete(self, key: str) -> None:
+        self.redis_client.delete(f"{self.full_key_prefix}:{key}")
+
+    def exists(self, key: str) -> bool:
+        return self.redis_client.exists(f"{self.full_key_prefix}:{key}") == 1
+
+    def clear(self) -> None:
+        def scan_and_delete(cursor: int) -> int:
+            cursor, keys_to_delete = self.redis_client.scan(
+                cursor, f"{self.full_key_prefix}:*"
+            )
+            self.redis_client.delete(*keys_to_delete)
+            return cursor
+
+        cursor = scan_and_delete(0)
+        while cursor != 0:
+            scan_and_delete(cursor)
+
+
+class RedisEntityStore(BaseEntityStore):
+    """Redis-backed Entity store.
+
+    Entities get a TTL of 1 day by default, and
+    that TTL is extended by 3 days every time the entity is read back.
+    """
+
+    redis_client: Any
+    session_id: str = "default"
+    key_prefix: str = "memory_store"
+    ttl: Optional[int] = 60 * 60 * 24
+    recall_ttl: Optional[int] = 60 * 60 * 24 * 3
+
+    def __init__(
+        self,
+        session_id: str = "default",
+        url: str = "redis://localhost:6379/0",
+        key_prefix: str = "memory_store",
+        ttl: Optional[int] = 60 * 60 * 24,
+        recall_ttl: Optional[int] = 60 * 60 * 24 * 3,
+        *args: Any,
+        **kwargs: Any,
+    ):
+        try:
+            import redis
+        except ImportError:
+            raise ImportError(
+                "Could not import redis python package. "
+                "Please install it with `pip install redis`."
+            )
+
+        super().__init__(*args, **kwargs)
+
+        try:
+            self.redis_client = get_client(redis_url=url, decode_responses=True)
+        except redis.exceptions.ConnectionError as error:
+            logger.error(error)
+
+        self.session_id = session_id
+        self.key_prefix = key_prefix
+        self.ttl = ttl
+        self.recall_ttl = recall_ttl or ttl
+
+    @property
+    def full_key_prefix(self) -> str:
+        return f"{self.key_prefix}:{self.session_id}"
+
+    def get(self, key: str, default: Optional[str] = None) -> Optional[str]:
+        res = (
+            self.redis_client.getex(f"{self.full_key_prefix}:{key}", ex=self.recall_ttl)
+            or default
+            or ""
+        )
+        logger.debug(f"REDIS MEM get '{self.full_key_prefix}:{key}': '{res}'")
+        return res
+
+    def set(self, key: str, value: Optional[str]) -> None:
+        if not value:
+            return self.delete(key)
+        self.redis_client.set(f"{self.full_key_prefix}:{key}", value, ex=self.ttl)
+        logger.debug(
+            f"REDIS MEM set '{self.full_key_prefix}:{key}': '{value}' EX {self.ttl}"
+        )
+
+    def delete(self, key: str) -> None:
+        self.redis_client.delete(f"{self.full_key_prefix}:{key}")
+
+    def exists(self, key: str) -> bool:
+        return self.redis_client.exists(f"{self.full_key_prefix}:{key}") == 1
+
+    def clear(self) -> None:
+        # iterate a list in batches of size batch_size
+        def batched(iterable: Iterable[Any], batch_size: int) -> Iterable[Any]:
+            iterator = iter(iterable)
+            while batch := list(islice(iterator, batch_size)):
+                yield batch
+
+        for keybatch in batched(
+            self.redis_client.scan_iter(f"{self.full_key_prefix}:*"), 500
+        ):
+            self.redis_client.delete(*keybatch)
+
+
+class SQLiteEntityStore(BaseEntityStore):
+    """SQLite-backed Entity store"""
+
+    session_id: str = "default"
+    table_name: str = "memory_store"
+    conn: Any = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def __init__(
+        self,
+        session_id: str = "default",
+        db_file: str = "entities.db",
+        table_name: str = "memory_store",
+        *args: Any,
+        **kwargs: Any,
+    ):
+        try:
+            import sqlite3
+        except ImportError:
+            raise ImportError(
+                "Could not import sqlite3 python package. "
+                "Please install it with `pip install sqlite3`."
+            )
+        super().__init__(*args, **kwargs)
+
+        self.conn = sqlite3.connect(db_file)
+        self.session_id = session_id
+        self.table_name = table_name
+        self._create_table_if_not_exists()
+
+    @property
+    def full_table_name(self) -> str:
+        return f"{self.table_name}_{self.session_id}"
+
+    def _create_table_if_not_exists(self) -> None:
+        create_table_query = f"""
+            CREATE TABLE IF NOT EXISTS {self.full_table_name} (
+                key TEXT PRIMARY KEY,
+                value TEXT
+            )
+        """
+        with self.conn:
+            self.conn.execute(create_table_query)
+
+    def get(self, key: str, default: Optional[str] = None) -> Optional[str]:
+        query = f"""
+            SELECT value
+            FROM {self.full_table_name}
+            WHERE key = ?
+        """
+        cursor = self.conn.execute(query, (key,))
+        result = cursor.fetchone()
+        if result is not None:
+            value = result[0]
+            return value
+        return default
+
+    def set(self, key: str, value: Optional[str]) -> None:
+        if not value:
+            return self.delete(key)
+        query = f"""
+            INSERT OR REPLACE INTO {self.full_table_name} (key, value)
+            VALUES (?, ?)
+        """
+        with self.conn:
+            self.conn.execute(query, (key, value))
+
+    def delete(self, key: str) -> None:
+        query = f"""
+            DELETE FROM {self.full_table_name}
+            WHERE key = ?
+        """
+        with self.conn:
+            self.conn.execute(query, (key,))
+
+    def exists(self, key: str) -> bool:
+        query = f"""
+            SELECT 1
+            FROM {self.full_table_name}
+            WHERE key = ?
+            LIMIT 1
+        """
+        cursor = self.conn.execute(query, (key,))
+        result = cursor.fetchone()
+        return result is not None
+
+    def clear(self) -> None:
+        query = f"""
+            DELETE FROM {self.full_table_name}
+        """
+        with self.conn:
+            self.conn.execute(query)
+
+
+class ConversationEntityMemory(BaseChatMemory):
+    """Entity extractor & summarizer memory.
+
+    Extracts named entities from the recent chat history and generates summaries.
+    With a swappable entity store, persisting entities across conversations.
+    Defaults to an in-memory entity store, and can be swapped out for a Redis,
+    SQLite, or other entity store.
+    """
+
+    human_prefix: str = "Human"
+    ai_prefix: str = "AI"
+    llm: BaseLanguageModel
+    entity_extraction_prompt: BasePromptTemplate = ENTITY_EXTRACTION_PROMPT
+    entity_summarization_prompt: BasePromptTemplate = ENTITY_SUMMARIZATION_PROMPT
+
+    # Cache of recently detected entity names, if any
+    # It is updated when load_memory_variables is called:
+    entity_cache: List[str] = []
+
+    # Number of recent message pairs to consider when updating entities:
+    k: int = 3
+
+    chat_history_key: str = "history"
+
+    # Store to manage entity-related data:
+    entity_store: BaseEntityStore = Field(default_factory=InMemoryEntityStore)
+
+    @property
+    def buffer(self) -> List[BaseMessage]:
+        """Access chat memory messages."""
+        return self.chat_memory.messages
+
+    @property
+    def memory_variables(self) -> List[str]:
+        """Will always return list of memory variables.
+
+        :meta private:
+        """
+        return ["entities", self.chat_history_key]
+
+    def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Returns chat history and all generated entities with summaries if available,
+        and updates or clears the recent entity cache.
+
+        New entity name can be found when calling this method, before the entity
+        summaries are generated, so the entity cache values may be empty if no entity
+        descriptions are generated yet.
+        """
+
+        # Create an LLMChain for predicting entity names from the recent chat history:
+        chain = LLMChain(llm=self.llm, prompt=self.entity_extraction_prompt)
+
+        if self.input_key is None:
+            prompt_input_key = get_prompt_input_key(inputs, self.memory_variables)
+        else:
+            prompt_input_key = self.input_key
+
+        # Extract an arbitrary window of the last message pairs from
+        # the chat history, where the hyperparameter k is the
+        # number of message pairs:
+        buffer_string = get_buffer_string(
+            self.buffer[-self.k * 2 :],
+            human_prefix=self.human_prefix,
+            ai_prefix=self.ai_prefix,
+        )
+
+        # Generates a comma-separated list of named entities,
+        # e.g. "Jane, White House, UFO"
+        # or "NONE" if no named entities are extracted:
+        output = chain.predict(
+            history=buffer_string,
+            input=inputs[prompt_input_key],
+        )
+
+        # If no named entities are extracted, assigns an empty list.
+        if output.strip() == "NONE":
+            entities = []
+        else:
+            # Make a list of the extracted entities:
+            entities = [w.strip() for w in output.split(",")]
+
+        # Make a dictionary of entities with summary if exists:
+        entity_summaries = {}
+
+        for entity in entities:
+            entity_summaries[entity] = self.entity_store.get(entity, "")
+
+        # Replaces the entity name cache with the most recently discussed entities,
+        # or if no entities were extracted, clears the cache:
+        self.entity_cache = entities
+
+        # Should we return as message objects or as a string?
+        if self.return_messages:
+            # Get last `k` pair of chat messages:
+            buffer: Any = self.buffer[-self.k * 2 :]
+        else:
+            # Reuse the string we made earlier:
+            buffer = buffer_string
+
+        return {
+            self.chat_history_key: buffer,
+            "entities": entity_summaries,
+        }
+
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+        """
+        Save context from this conversation history to the entity store.
+
+        Generates a summary for each entity in the entity cache by prompting
+        the model, and saves these summaries to the entity store.
+        """
+
+        super().save_context(inputs, outputs)
+
+        if self.input_key is None:
+            prompt_input_key = get_prompt_input_key(inputs, self.memory_variables)
+        else:
+            prompt_input_key = self.input_key
+
+        # Extract an arbitrary window of the last message pairs from
+        # the chat history, where the hyperparameter k is the
+        # number of message pairs:
+        buffer_string = get_buffer_string(
+            self.buffer[-self.k * 2 :],
+            human_prefix=self.human_prefix,
+            ai_prefix=self.ai_prefix,
+        )
+
+        input_data = inputs[prompt_input_key]
+
+        # Create an LLMChain for predicting entity summarization from the context
+        chain = LLMChain(llm=self.llm, prompt=self.entity_summarization_prompt)
+
+        # Generate new summaries for entities and save them in the entity store
+        for entity in self.entity_cache:
+            # Get existing summary if it exists
+            existing_summary = self.entity_store.get(entity, "")
+            output = chain.predict(
+                summary=existing_summary,
+                entity=entity,
+                history=buffer_string,
+                input=input_data,
+            )
+            # Save the updated summary to the entity store
+            self.entity_store.set(entity, output.strip())
+
+    def clear(self) -> None:
+        """Clear memory contents."""
+        self.chat_memory.clear()
+        self.entity_cache.clear()
+        self.entity_store.clear()
diff --git a/llm/Lib/site-packages/langchain/memory/kg.py b/llm/Lib/site-packages/langchain/memory/kg.py
new file mode 100644
index 0000000000000000000000000000000000000000..4e6a29dbb7e790b18348ad5e5672f90158f01abc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/kg.py
@@ -0,0 +1,133 @@
+from typing import Any, Dict, List, Type, Union
+
+from langchain_community.graphs import NetworkxEntityGraph
+from langchain_community.graphs.networkx_graph import (
+    KnowledgeTriple,
+    get_entities,
+    parse_triples,
+)
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.messages import BaseMessage, SystemMessage, get_buffer_string
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+
+from langchain.chains.llm import LLMChain
+from langchain.memory.chat_memory import BaseChatMemory
+from langchain.memory.prompt import (
+    ENTITY_EXTRACTION_PROMPT,
+    KNOWLEDGE_TRIPLE_EXTRACTION_PROMPT,
+)
+from langchain.memory.utils import get_prompt_input_key
+
+
+class ConversationKGMemory(BaseChatMemory):
+    """Knowledge graph conversation memory.
+
+    Integrates with external knowledge graph to store and retrieve
+    information about knowledge triples in the conversation.
+    """
+
+    k: int = 2
+    human_prefix: str = "Human"
+    ai_prefix: str = "AI"
+    kg: NetworkxEntityGraph = Field(default_factory=NetworkxEntityGraph)
+    knowledge_extraction_prompt: BasePromptTemplate = KNOWLEDGE_TRIPLE_EXTRACTION_PROMPT
+    entity_extraction_prompt: BasePromptTemplate = ENTITY_EXTRACTION_PROMPT
+    llm: BaseLanguageModel
+    summary_message_cls: Type[BaseMessage] = SystemMessage
+    """Number of previous utterances to include in the context."""
+    memory_key: str = "history"  #: :meta private:
+
+    def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, Any]:
+        """Return history buffer."""
+        entities = self._get_current_entities(inputs)
+
+        summary_strings = []
+        for entity in entities:
+            knowledge = self.kg.get_entity_knowledge(entity)
+            if knowledge:
+                summary = f"On {entity}: {'. '.join(knowledge)}."
+                summary_strings.append(summary)
+        context: Union[str, List]
+        if not summary_strings:
+            context = [] if self.return_messages else ""
+        elif self.return_messages:
+            context = [
+                self.summary_message_cls(content=text) for text in summary_strings
+            ]
+        else:
+            context = "\n".join(summary_strings)
+
+        return {self.memory_key: context}
+
+    @property
+    def memory_variables(self) -> List[str]:
+        """Will always return list of memory variables.
+
+        :meta private:
+        """
+        return [self.memory_key]
+
+    def _get_prompt_input_key(self, inputs: Dict[str, Any]) -> str:
+        """Get the input key for the prompt."""
+        if self.input_key is None:
+            return get_prompt_input_key(inputs, self.memory_variables)
+        return self.input_key
+
+    def _get_prompt_output_key(self, outputs: Dict[str, Any]) -> str:
+        """Get the output key for the prompt."""
+        if self.output_key is None:
+            if len(outputs) != 1:
+                raise ValueError(f"One output key expected, got {outputs.keys()}")
+            return list(outputs.keys())[0]
+        return self.output_key
+
+    def get_current_entities(self, input_string: str) -> List[str]:
+        chain = LLMChain(llm=self.llm, prompt=self.entity_extraction_prompt)
+        buffer_string = get_buffer_string(
+            self.chat_memory.messages[-self.k * 2 :],
+            human_prefix=self.human_prefix,
+            ai_prefix=self.ai_prefix,
+        )
+        output = chain.predict(
+            history=buffer_string,
+            input=input_string,
+        )
+        return get_entities(output)
+
+    def _get_current_entities(self, inputs: Dict[str, Any]) -> List[str]:
+        """Get the current entities in the conversation."""
+        prompt_input_key = self._get_prompt_input_key(inputs)
+        return self.get_current_entities(inputs[prompt_input_key])
+
+    def get_knowledge_triplets(self, input_string: str) -> List[KnowledgeTriple]:
+        chain = LLMChain(llm=self.llm, prompt=self.knowledge_extraction_prompt)
+        buffer_string = get_buffer_string(
+            self.chat_memory.messages[-self.k * 2 :],
+            human_prefix=self.human_prefix,
+            ai_prefix=self.ai_prefix,
+        )
+        output = chain.predict(
+            history=buffer_string,
+            input=input_string,
+            verbose=True,
+        )
+        knowledge = parse_triples(output)
+        return knowledge
+
+    def _get_and_update_kg(self, inputs: Dict[str, Any]) -> None:
+        """Get and update knowledge graph from the conversation history."""
+        prompt_input_key = self._get_prompt_input_key(inputs)
+        knowledge = self.get_knowledge_triplets(inputs[prompt_input_key])
+        for triple in knowledge:
+            self.kg.add_triple(triple)
+
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+        """Save context from this conversation to buffer."""
+        super().save_context(inputs, outputs)
+        self._get_and_update_kg(inputs)
+
+    def clear(self) -> None:
+        """Clear memory contents."""
+        super().clear()
+        self.kg.clear()
diff --git a/llm/Lib/site-packages/langchain/memory/motorhead_memory.py b/llm/Lib/site-packages/langchain/memory/motorhead_memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..363a0f77a2853807012c178d078f394107d1f106
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/motorhead_memory.py
@@ -0,0 +1,94 @@
+from typing import Any, Dict, List, Optional
+
+import requests
+from langchain_core.messages import get_buffer_string
+
+from langchain.memory.chat_memory import BaseChatMemory
+
+MANAGED_URL = "https://api.getmetal.io/v1/motorhead"
+# LOCAL_URL = "http://localhost:8080"
+
+
+class MotorheadMemory(BaseChatMemory):
+    """Chat message memory backed by Motorhead service."""
+
+    url: str = MANAGED_URL
+    timeout: int = 3000
+    memory_key: str = "history"
+    session_id: str
+    context: Optional[str] = None
+
+    # Managed Params
+    api_key: Optional[str] = None
+    client_id: Optional[str] = None
+
+    def __get_headers(self) -> Dict[str, str]:
+        is_managed = self.url == MANAGED_URL
+
+        headers = {
+            "Content-Type": "application/json",
+        }
+
+        if is_managed and not (self.api_key and self.client_id):
+            raise ValueError(
+                """
+                You must provide an API key or a client ID to use the managed
+                version of Motorhead. Visit https://getmetal.io for more information.
+                """
+            )
+
+        if is_managed and self.api_key and self.client_id:
+            headers["x-metal-api-key"] = self.api_key
+            headers["x-metal-client-id"] = self.client_id
+
+        return headers
+
+    async def init(self) -> None:
+        res = requests.get(
+            f"{self.url}/sessions/{self.session_id}/memory",
+            timeout=self.timeout,
+            headers=self.__get_headers(),
+        )
+        res_data = res.json()
+        res_data = res_data.get("data", res_data)  # Handle Managed Version
+
+        messages = res_data.get("messages", [])
+        context = res_data.get("context", "NONE")
+
+        for message in reversed(messages):
+            if message["role"] == "AI":
+                self.chat_memory.add_ai_message(message["content"])
+            else:
+                self.chat_memory.add_user_message(message["content"])
+
+        if context and context != "NONE":
+            self.context = context
+
+    def load_memory_variables(self, values: Dict[str, Any]) -> Dict[str, Any]:
+        if self.return_messages:
+            return {self.memory_key: self.chat_memory.messages}
+        else:
+            return {self.memory_key: get_buffer_string(self.chat_memory.messages)}
+
+    @property
+    def memory_variables(self) -> List[str]:
+        return [self.memory_key]
+
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+        input_str, output_str = self._get_input_output(inputs, outputs)
+        requests.post(
+            f"{self.url}/sessions/{self.session_id}/memory",
+            timeout=self.timeout,
+            json={
+                "messages": [
+                    {"role": "Human", "content": f"{input_str}"},
+                    {"role": "AI", "content": f"{output_str}"},
+                ]
+            },
+            headers=self.__get_headers(),
+        )
+        super().save_context(inputs, outputs)
+
+    def delete_session(self) -> None:
+        """Delete a session"""
+        requests.delete(f"{self.url}/sessions/{self.session_id}/memory")
diff --git a/llm/Lib/site-packages/langchain/memory/prompt.py b/llm/Lib/site-packages/langchain/memory/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..c16e8e249319bfca0e9a759ec9793ba895295e3e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/prompt.py
@@ -0,0 +1,165 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+_DEFAULT_ENTITY_MEMORY_CONVERSATION_TEMPLATE = """You are an assistant to a human, powered by a large language model trained by OpenAI.
+
+You are designed to be able to assist with a wide range of tasks, from answering simple questions to providing in-depth explanations and discussions on a wide range of topics. As a language model, you are able to generate human-like text based on the input you receive, allowing you to engage in natural-sounding conversations and provide responses that are coherent and relevant to the topic at hand.
+
+You are constantly learning and improving, and your capabilities are constantly evolving. You are able to process and understand large amounts of text, and can use this knowledge to provide accurate and informative responses to a wide range of questions. You have access to some personalized information provided by the human in the Context section below. Additionally, you are able to generate your own text based on the input you receive, allowing you to engage in discussions and provide explanations and descriptions on a wide range of topics.
+
+Overall, you are a powerful tool that can help with a wide range of tasks and provide valuable insights and information on a wide range of topics. Whether the human needs help with a specific question or just wants to have a conversation about a particular topic, you are here to assist.
+
+Context:
+{entities}
+
+Current conversation:
+{history}
+Last line:
+Human: {input}
+You:"""
+
+ENTITY_MEMORY_CONVERSATION_TEMPLATE = PromptTemplate(
+    input_variables=["entities", "history", "input"],
+    template=_DEFAULT_ENTITY_MEMORY_CONVERSATION_TEMPLATE,
+)
+
+_DEFAULT_SUMMARIZER_TEMPLATE = """Progressively summarize the lines of conversation provided, adding onto the previous summary returning a new summary.
+
+EXAMPLE
+Current summary:
+The human asks what the AI thinks of artificial intelligence. The AI thinks artificial intelligence is a force for good.
+
+New lines of conversation:
+Human: Why do you think artificial intelligence is a force for good?
+AI: Because artificial intelligence will help humans reach their full potential.
+
+New summary:
+The human asks what the AI thinks of artificial intelligence. The AI thinks artificial intelligence is a force for good because it will help humans reach their full potential.
+END OF EXAMPLE
+
+Current summary:
+{summary}
+
+New lines of conversation:
+{new_lines}
+
+New summary:"""
+SUMMARY_PROMPT = PromptTemplate(
+    input_variables=["summary", "new_lines"], template=_DEFAULT_SUMMARIZER_TEMPLATE
+)
+
+_DEFAULT_ENTITY_EXTRACTION_TEMPLATE = """You are an AI assistant reading the transcript of a conversation between an AI and a human. Extract all of the proper nouns from the last line of conversation. As a guideline, a proper noun is generally capitalized. You should definitely extract all names and places.
+
+The conversation history is provided just in case of a coreference (e.g. "What do you know about him" where "him" is defined in a previous line) -- ignore items mentioned there that are not in the last line.
+
+Return the output as a single comma-separated list, or NONE if there is nothing of note to return (e.g. the user is just issuing a greeting or having a simple conversation).
+
+EXAMPLE
+Conversation history:
+Person #1: how's it going today?
+AI: "It's going great! How about you?"
+Person #1: good! busy working on Langchain. lots to do.
+AI: "That sounds like a lot of work! What kind of things are you doing to make Langchain better?"
+Last line:
+Person #1: i'm trying to improve Langchain's interfaces, the UX, its integrations with various products the user might want ... a lot of stuff.
+Output: Langchain
+END OF EXAMPLE
+
+EXAMPLE
+Conversation history:
+Person #1: how's it going today?
+AI: "It's going great! How about you?"
+Person #1: good! busy working on Langchain. lots to do.
+AI: "That sounds like a lot of work! What kind of things are you doing to make Langchain better?"
+Last line:
+Person #1: i'm trying to improve Langchain's interfaces, the UX, its integrations with various products the user might want ... a lot of stuff. I'm working with Person #2.
+Output: Langchain, Person #2
+END OF EXAMPLE
+
+Conversation history (for reference only):
+{history}
+Last line of conversation (for extraction):
+Human: {input}
+
+Output:"""
+ENTITY_EXTRACTION_PROMPT = PromptTemplate(
+    input_variables=["history", "input"], template=_DEFAULT_ENTITY_EXTRACTION_TEMPLATE
+)
+
+_DEFAULT_ENTITY_SUMMARIZATION_TEMPLATE = """You are an AI assistant helping a human keep track of facts about relevant people, places, and concepts in their life. Update the summary of the provided entity in the "Entity" section based on the last line of your conversation with the human. If you are writing the summary for the first time, return a single sentence.
+The update should only include facts that are relayed in the last line of conversation about the provided entity, and should only contain facts about the provided entity.
+
+If there is no new information about the provided entity or the information is not worth noting (not an important or relevant fact to remember long-term), return the existing summary unchanged.
+
+Full conversation history (for context):
+{history}
+
+Entity to summarize:
+{entity}
+
+Existing summary of {entity}:
+{summary}
+
+Last line of conversation:
+Human: {input}
+Updated summary:"""
+
+ENTITY_SUMMARIZATION_PROMPT = PromptTemplate(
+    input_variables=["entity", "summary", "history", "input"],
+    template=_DEFAULT_ENTITY_SUMMARIZATION_TEMPLATE,
+)
+
+
+KG_TRIPLE_DELIMITER = "<|>"
+_DEFAULT_KNOWLEDGE_TRIPLE_EXTRACTION_TEMPLATE = (
+    "You are a networked intelligence helping a human track knowledge triples"
+    " about all relevant people, things, concepts, etc. and integrating"
+    " them with your knowledge stored within your weights"
+    " as well as that stored in a knowledge graph."
+    " Extract all of the knowledge triples from the last line of conversation."
+    " A knowledge triple is a clause that contains a subject, a predicate,"
+    " and an object. The subject is the entity being described,"
+    " the predicate is the property of the subject that is being"
+    " described, and the object is the value of the property.\n\n"
+    "EXAMPLE\n"
+    "Conversation history:\n"
+    "Person #1: Did you hear aliens landed in Area 51?\n"
+    "AI: No, I didn't hear that. What do you know about Area 51?\n"
+    "Person #1: It's a secret military base in Nevada.\n"
+    "AI: What do you know about Nevada?\n"
+    "Last line of conversation:\n"
+    "Person #1: It's a state in the US. It's also the number 1 producer of gold in the US.\n\n"
+    f"Output: (Nevada, is a, state){KG_TRIPLE_DELIMITER}(Nevada, is in, US)"
+    f"{KG_TRIPLE_DELIMITER}(Nevada, is the number 1 producer of, gold)\n"
+    "END OF EXAMPLE\n\n"
+    "EXAMPLE\n"
+    "Conversation history:\n"
+    "Person #1: Hello.\n"
+    "AI: Hi! How are you?\n"
+    "Person #1: I'm good. How are you?\n"
+    "AI: I'm good too.\n"
+    "Last line of conversation:\n"
+    "Person #1: I'm going to the store.\n\n"
+    "Output: NONE\n"
+    "END OF EXAMPLE\n\n"
+    "EXAMPLE\n"
+    "Conversation history:\n"
+    "Person #1: What do you know about Descartes?\n"
+    "AI: Descartes was a French philosopher, mathematician, and scientist who lived in the 17th century.\n"
+    "Person #1: The Descartes I'm referring to is a standup comedian and interior designer from Montreal.\n"
+    "AI: Oh yes, He is a comedian and an interior designer. He has been in the industry for 30 years. His favorite food is baked bean pie.\n"
+    "Last line of conversation:\n"
+    "Person #1: Oh huh. I know Descartes likes to drive antique scooters and play the mandolin.\n"
+    f"Output: (Descartes, likes to drive, antique scooters){KG_TRIPLE_DELIMITER}(Descartes, plays, mandolin)\n"
+    "END OF EXAMPLE\n\n"
+    "Conversation history (for reference only):\n"
+    "{history}"
+    "\nLast line of conversation (for extraction):\n"
+    "Human: {input}\n\n"
+    "Output:"
+)
+
+KNOWLEDGE_TRIPLE_EXTRACTION_PROMPT = PromptTemplate(
+    input_variables=["history", "input"],
+    template=_DEFAULT_KNOWLEDGE_TRIPLE_EXTRACTION_TEMPLATE,
+)
diff --git a/llm/Lib/site-packages/langchain/memory/readonly.py b/llm/Lib/site-packages/langchain/memory/readonly.py
new file mode 100644
index 0000000000000000000000000000000000000000..a564edb8002670a18208f19435450c8aa8ea443b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/readonly.py
@@ -0,0 +1,26 @@
+from typing import Any, Dict, List
+
+from langchain_core.memory import BaseMemory
+
+
+class ReadOnlySharedMemory(BaseMemory):
+    """A memory wrapper that is read-only and cannot be changed."""
+
+    memory: BaseMemory
+
+    @property
+    def memory_variables(self) -> List[str]:
+        """Return memory variables."""
+        return self.memory.memory_variables
+
+    def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, str]:
+        """Load memory variables from memory."""
+        return self.memory.load_memory_variables(inputs)
+
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+        """Nothing should be saved or changed"""
+        pass
+
+    def clear(self) -> None:
+        """Nothing to clear, got a memory like a vault."""
+        pass
diff --git a/llm/Lib/site-packages/langchain/memory/simple.py b/llm/Lib/site-packages/langchain/memory/simple.py
new file mode 100644
index 0000000000000000000000000000000000000000..7f2dfb5c14e7d1b4c317e8de8908e2ad5179249b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/simple.py
@@ -0,0 +1,26 @@
+from typing import Any, Dict, List
+
+from langchain_core.memory import BaseMemory
+
+
+class SimpleMemory(BaseMemory):
+    """Simple memory for storing context or other information that shouldn't
+    ever change between prompts.
+    """
+
+    memories: Dict[str, Any] = dict()
+
+    @property
+    def memory_variables(self) -> List[str]:
+        return list(self.memories.keys())
+
+    def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, str]:
+        return self.memories
+
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+        """Nothing should be saved or changed, my memory is set in stone."""
+        pass
+
+    def clear(self) -> None:
+        """Nothing to clear, got a memory like a vault."""
+        pass
diff --git a/llm/Lib/site-packages/langchain/memory/summary.py b/llm/Lib/site-packages/langchain/memory/summary.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7cb996cb533f9d3f22d514ca1db298dda10ff31
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/summary.py
@@ -0,0 +1,98 @@
+from __future__ import annotations
+
+from typing import Any, Dict, List, Type
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.messages import BaseMessage, SystemMessage, get_buffer_string
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+from langchain.chains.llm import LLMChain
+from langchain.memory.chat_memory import BaseChatMemory
+from langchain.memory.prompt import SUMMARY_PROMPT
+
+
+class SummarizerMixin(BaseModel):
+    """Mixin for summarizer."""
+
+    human_prefix: str = "Human"
+    ai_prefix: str = "AI"
+    llm: BaseLanguageModel
+    prompt: BasePromptTemplate = SUMMARY_PROMPT
+    summary_message_cls: Type[BaseMessage] = SystemMessage
+
+    def predict_new_summary(
+        self, messages: List[BaseMessage], existing_summary: str
+    ) -> str:
+        new_lines = get_buffer_string(
+            messages,
+            human_prefix=self.human_prefix,
+            ai_prefix=self.ai_prefix,
+        )
+
+        chain = LLMChain(llm=self.llm, prompt=self.prompt)
+        return chain.predict(summary=existing_summary, new_lines=new_lines)
+
+
+class ConversationSummaryMemory(BaseChatMemory, SummarizerMixin):
+    """Conversation summarizer to chat memory."""
+
+    buffer: str = ""
+    memory_key: str = "history"  #: :meta private:
+
+    @classmethod
+    def from_messages(
+        cls,
+        llm: BaseLanguageModel,
+        chat_memory: BaseChatMessageHistory,
+        *,
+        summarize_step: int = 2,
+        **kwargs: Any,
+    ) -> ConversationSummaryMemory:
+        obj = cls(llm=llm, chat_memory=chat_memory, **kwargs)
+        for i in range(0, len(obj.chat_memory.messages), summarize_step):
+            obj.buffer = obj.predict_new_summary(
+                obj.chat_memory.messages[i : i + summarize_step], obj.buffer
+            )
+        return obj
+
+    @property
+    def memory_variables(self) -> List[str]:
+        """Will always return list of memory variables.
+
+        :meta private:
+        """
+        return [self.memory_key]
+
+    def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, Any]:
+        """Return history buffer."""
+        if self.return_messages:
+            buffer: Any = [self.summary_message_cls(content=self.buffer)]
+        else:
+            buffer = self.buffer
+        return {self.memory_key: buffer}
+
+    @root_validator()
+    def validate_prompt_input_variables(cls, values: Dict) -> Dict:
+        """Validate that prompt input variables are consistent."""
+        prompt_variables = values["prompt"].input_variables
+        expected_keys = {"summary", "new_lines"}
+        if expected_keys != set(prompt_variables):
+            raise ValueError(
+                "Got unexpected prompt input variables. The prompt expects "
+                f"{prompt_variables}, but it should have {expected_keys}."
+            )
+        return values
+
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+        """Save context from this conversation to buffer."""
+        super().save_context(inputs, outputs)
+        self.buffer = self.predict_new_summary(
+            self.chat_memory.messages[-2:], self.buffer
+        )
+
+    def clear(self) -> None:
+        """Clear memory contents."""
+        super().clear()
+        self.buffer = ""
diff --git a/llm/Lib/site-packages/langchain/memory/summary_buffer.py b/llm/Lib/site-packages/langchain/memory/summary_buffer.py
new file mode 100644
index 0000000000000000000000000000000000000000..23d050f62dd3dcc2caa5d54239cfed005102c5ef
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/summary_buffer.py
@@ -0,0 +1,78 @@
+from typing import Any, Dict, List
+
+from langchain_core.messages import BaseMessage, get_buffer_string
+from langchain_core.pydantic_v1 import root_validator
+
+from langchain.memory.chat_memory import BaseChatMemory
+from langchain.memory.summary import SummarizerMixin
+
+
+class ConversationSummaryBufferMemory(BaseChatMemory, SummarizerMixin):
+    """Buffer with summarizer for storing conversation memory."""
+
+    max_token_limit: int = 2000
+    moving_summary_buffer: str = ""
+    memory_key: str = "history"
+
+    @property
+    def buffer(self) -> List[BaseMessage]:
+        return self.chat_memory.messages
+
+    @property
+    def memory_variables(self) -> List[str]:
+        """Will always return list of memory variables.
+
+        :meta private:
+        """
+        return [self.memory_key]
+
+    def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, Any]:
+        """Return history buffer."""
+        buffer = self.buffer
+        if self.moving_summary_buffer != "":
+            first_messages: List[BaseMessage] = [
+                self.summary_message_cls(content=self.moving_summary_buffer)
+            ]
+            buffer = first_messages + buffer
+        if self.return_messages:
+            final_buffer: Any = buffer
+        else:
+            final_buffer = get_buffer_string(
+                buffer, human_prefix=self.human_prefix, ai_prefix=self.ai_prefix
+            )
+        return {self.memory_key: final_buffer}
+
+    @root_validator()
+    def validate_prompt_input_variables(cls, values: Dict) -> Dict:
+        """Validate that prompt input variables are consistent."""
+        prompt_variables = values["prompt"].input_variables
+        expected_keys = {"summary", "new_lines"}
+        if expected_keys != set(prompt_variables):
+            raise ValueError(
+                "Got unexpected prompt input variables. The prompt expects "
+                f"{prompt_variables}, but it should have {expected_keys}."
+            )
+        return values
+
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+        """Save context from this conversation to buffer."""
+        super().save_context(inputs, outputs)
+        self.prune()
+
+    def prune(self) -> None:
+        """Prune buffer if it exceeds max token limit"""
+        buffer = self.chat_memory.messages
+        curr_buffer_length = self.llm.get_num_tokens_from_messages(buffer)
+        if curr_buffer_length > self.max_token_limit:
+            pruned_memory = []
+            while curr_buffer_length > self.max_token_limit:
+                pruned_memory.append(buffer.pop(0))
+                curr_buffer_length = self.llm.get_num_tokens_from_messages(buffer)
+            self.moving_summary_buffer = self.predict_new_summary(
+                pruned_memory, self.moving_summary_buffer
+            )
+
+    def clear(self) -> None:
+        """Clear memory contents."""
+        super().clear()
+        self.moving_summary_buffer = ""
diff --git a/llm/Lib/site-packages/langchain/memory/token_buffer.py b/llm/Lib/site-packages/langchain/memory/token_buffer.py
new file mode 100644
index 0000000000000000000000000000000000000000..853e0dcc6f6fc740f8d540ec999c3ec764a48a9a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/token_buffer.py
@@ -0,0 +1,59 @@
+from typing import Any, Dict, List
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.messages import BaseMessage, get_buffer_string
+
+from langchain.memory.chat_memory import BaseChatMemory
+
+
+class ConversationTokenBufferMemory(BaseChatMemory):
+    """Conversation chat memory with token limit."""
+
+    human_prefix: str = "Human"
+    ai_prefix: str = "AI"
+    llm: BaseLanguageModel
+    memory_key: str = "history"
+    max_token_limit: int = 2000
+
+    @property
+    def buffer(self) -> Any:
+        """String buffer of memory."""
+        return self.buffer_as_messages if self.return_messages else self.buffer_as_str
+
+    @property
+    def buffer_as_str(self) -> str:
+        """Exposes the buffer as a string in case return_messages is False."""
+        return get_buffer_string(
+            self.chat_memory.messages,
+            human_prefix=self.human_prefix,
+            ai_prefix=self.ai_prefix,
+        )
+
+    @property
+    def buffer_as_messages(self) -> List[BaseMessage]:
+        """Exposes the buffer as a list of messages in case return_messages is True."""
+        return self.chat_memory.messages
+
+    @property
+    def memory_variables(self) -> List[str]:
+        """Will always return list of memory variables.
+
+        :meta private:
+        """
+        return [self.memory_key]
+
+    def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, Any]:
+        """Return history buffer."""
+        return {self.memory_key: self.buffer}
+
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+        """Save context from this conversation to buffer. Pruned."""
+        super().save_context(inputs, outputs)
+        # Prune buffer if it exceeds max token limit
+        buffer = self.chat_memory.messages
+        curr_buffer_length = self.llm.get_num_tokens_from_messages(buffer)
+        if curr_buffer_length > self.max_token_limit:
+            pruned_memory = []
+            while curr_buffer_length > self.max_token_limit:
+                pruned_memory.append(buffer.pop(0))
+                curr_buffer_length = self.llm.get_num_tokens_from_messages(buffer)
diff --git a/llm/Lib/site-packages/langchain/memory/utils.py b/llm/Lib/site-packages/langchain/memory/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..eafb48904d42ffc76b2bb5df3b3b0585be30e0ed
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/utils.py
@@ -0,0 +1,20 @@
+from typing import Any, Dict, List
+
+
+def get_prompt_input_key(inputs: Dict[str, Any], memory_variables: List[str]) -> str:
+    """
+    Get the prompt input key.
+
+    Args:
+        inputs: Dict[str, Any]
+        memory_variables: List[str]
+
+    Returns:
+        A prompt input key.
+    """
+    # "stop" is a special key that can be passed as input but is not used to
+    # format the prompt.
+    prompt_input_keys = list(set(inputs).difference(memory_variables + ["stop"]))
+    if len(prompt_input_keys) != 1:
+        raise ValueError(f"One input key expected got {prompt_input_keys}")
+    return prompt_input_keys[0]
diff --git a/llm/Lib/site-packages/langchain/memory/vectorstore.py b/llm/Lib/site-packages/langchain/memory/vectorstore.py
new file mode 100644
index 0000000000000000000000000000000000000000..b288ef57d8424d0a0ef38484b81edf017b6f1188
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/vectorstore.py
@@ -0,0 +1,101 @@
+"""Class for a VectorStore-backed memory object."""
+
+from typing import Any, Dict, List, Optional, Sequence, Union
+
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Field
+from langchain_core.vectorstores import VectorStoreRetriever
+
+from langchain.memory.chat_memory import BaseMemory
+from langchain.memory.utils import get_prompt_input_key
+
+
+class VectorStoreRetrieverMemory(BaseMemory):
+    """VectorStoreRetriever-backed memory."""
+
+    retriever: VectorStoreRetriever = Field(exclude=True)
+    """VectorStoreRetriever object to connect to."""
+
+    memory_key: str = "history"  #: :meta private:
+    """Key name to locate the memories in the result of load_memory_variables."""
+
+    input_key: Optional[str] = None
+    """Key name to index the inputs to load_memory_variables."""
+
+    return_docs: bool = False
+    """Whether or not to return the result of querying the database directly."""
+
+    exclude_input_keys: Sequence[str] = Field(default_factory=tuple)
+    """Input keys to exclude in addition to memory key when constructing the document"""
+
+    @property
+    def memory_variables(self) -> List[str]:
+        """The list of keys emitted from the load_memory_variables method."""
+        return [self.memory_key]
+
+    def _get_prompt_input_key(self, inputs: Dict[str, Any]) -> str:
+        """Get the input key for the prompt."""
+        if self.input_key is None:
+            return get_prompt_input_key(inputs, self.memory_variables)
+        return self.input_key
+
+    def _documents_to_memory_variables(
+        self, docs: List[Document]
+    ) -> Dict[str, Union[List[Document], str]]:
+        result: Union[List[Document], str]
+        if not self.return_docs:
+            result = "\n".join([doc.page_content for doc in docs])
+        else:
+            result = docs
+        return {self.memory_key: result}
+
+    def load_memory_variables(
+        self, inputs: Dict[str, Any]
+    ) -> Dict[str, Union[List[Document], str]]:
+        """Return history buffer."""
+        input_key = self._get_prompt_input_key(inputs)
+        query = inputs[input_key]
+        docs = self.retriever.get_relevant_documents(query)
+        return self._documents_to_memory_variables(docs)
+
+    async def aload_memory_variables(
+        self, inputs: Dict[str, Any]
+    ) -> Dict[str, Union[List[Document], str]]:
+        """Return history buffer."""
+        input_key = self._get_prompt_input_key(inputs)
+        query = inputs[input_key]
+        docs = await self.retriever.aget_relevant_documents(query)
+        return self._documents_to_memory_variables(docs)
+
+    def _form_documents(
+        self, inputs: Dict[str, Any], outputs: Dict[str, str]
+    ) -> List[Document]:
+        """Format context from this conversation to buffer."""
+        # Each document should only include the current turn, not the chat history
+        exclude = set(self.exclude_input_keys)
+        exclude.add(self.memory_key)
+        filtered_inputs = {k: v for k, v in inputs.items() if k not in exclude}
+        texts = [
+            f"{k}: {v}"
+            for k, v in list(filtered_inputs.items()) + list(outputs.items())
+        ]
+        page_content = "\n".join(texts)
+        return [Document(page_content=page_content)]
+
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+        """Save context from this conversation to buffer."""
+        documents = self._form_documents(inputs, outputs)
+        self.retriever.add_documents(documents)
+
+    async def asave_context(
+        self, inputs: Dict[str, Any], outputs: Dict[str, str]
+    ) -> None:
+        """Save context from this conversation to buffer."""
+        documents = self._form_documents(inputs, outputs)
+        await self.retriever.aadd_documents(documents)
+
+    def clear(self) -> None:
+        """Nothing to clear."""
+
+    async def aclear(self) -> None:
+        """Nothing to clear."""
diff --git a/llm/Lib/site-packages/langchain/memory/zep_memory.py b/llm/Lib/site-packages/langchain/memory/zep_memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..ef3153ed6265c50e2265b888eb9e13a73de6f19d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/memory/zep_memory.py
@@ -0,0 +1,125 @@
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+from langchain_community.chat_message_histories import ZepChatMessageHistory
+
+from langchain.memory import ConversationBufferMemory
+
+
+class ZepMemory(ConversationBufferMemory):
+    """Persist your chain history to the Zep MemoryStore.
+
+    The number of messages returned by Zep and when the Zep server summarizes chat
+    histories is configurable. See the Zep documentation for more details.
+
+    Documentation: https://docs.getzep.com
+
+    Example:
+        .. code-block:: python
+
+        memory = ZepMemory(
+                    session_id=session_id,  # Identifies your user or a user's session
+                    url=ZEP_API_URL,        # Your Zep server's URL
+                    api_key=<your_api_key>, # Optional
+                    memory_key="history",   # Ensure this matches the key used in
+                                            # chain's prompt template
+                    return_messages=True,   # Does your prompt template expect a string
+                                            # or a list of Messages?
+                )
+        chain = LLMChain(memory=memory,...) # Configure your chain to use the ZepMemory
+                                              instance
+
+
+    Note:
+        To persist metadata alongside your chat history, your will need to create a
+    custom Chain class that overrides the `prep_outputs` method to include the metadata
+    in the call to `self.memory.save_context`.
+
+
+    Zep - Fast, scalable building blocks for LLM Apps
+    =========
+    Zep is an open source platform for productionizing LLM apps. Go from a prototype
+    built in LangChain or LlamaIndex, or a custom app, to production in minutes without
+    rewriting code.
+
+    For server installation instructions and more, see:
+    https://docs.getzep.com/deployment/quickstart/
+
+    For more information on the zep-python package, see:
+    https://github.com/getzep/zep-python
+
+    """
+
+    chat_memory: ZepChatMessageHistory
+
+    def __init__(
+        self,
+        session_id: str,
+        url: str = "http://localhost:8000",
+        api_key: Optional[str] = None,
+        output_key: Optional[str] = None,
+        input_key: Optional[str] = None,
+        return_messages: bool = False,
+        human_prefix: str = "Human",
+        ai_prefix: str = "AI",
+        memory_key: str = "history",
+    ):
+        """Initialize ZepMemory.
+
+        Args:
+            session_id (str): Identifies your user or a user's session
+            url (str, optional): Your Zep server's URL. Defaults to
+                                 "http://localhost:8000".
+            api_key (Optional[str], optional): Your Zep API key. Defaults to None.
+            output_key (Optional[str], optional): The key to use for the output message.
+                                              Defaults to None.
+            input_key (Optional[str], optional): The key to use for the input message.
+                                              Defaults to None.
+            return_messages (bool, optional): Does your prompt template expect a string
+                                              or a list of Messages? Defaults to False
+                                              i.e. return a string.
+            human_prefix (str, optional): The prefix to use for human messages.
+                                          Defaults to "Human".
+            ai_prefix (str, optional): The prefix to use for AI messages.
+                                       Defaults to "AI".
+            memory_key (str, optional): The key to use for the memory.
+                                        Defaults to "history".
+                                        Ensure that this matches the key used in
+                                        chain's prompt template.
+        """
+        chat_message_history = ZepChatMessageHistory(
+            session_id=session_id,
+            url=url,
+            api_key=api_key,
+        )
+        super().__init__(
+            chat_memory=chat_message_history,
+            output_key=output_key,
+            input_key=input_key,
+            return_messages=return_messages,
+            human_prefix=human_prefix,
+            ai_prefix=ai_prefix,
+            memory_key=memory_key,
+        )
+
+    def save_context(
+        self,
+        inputs: Dict[str, Any],
+        outputs: Dict[str, str],
+        metadata: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        """Save context from this conversation to buffer.
+
+        Args:
+            inputs (Dict[str, Any]): The inputs to the chain.
+            outputs (Dict[str, str]): The outputs from the chain.
+            metadata (Optional[Dict[str, Any]], optional): Any metadata to save with
+                                                           the context. Defaults to None
+
+        Returns:
+            None
+        """
+        input_str, output_str = self._get_input_output(inputs, outputs)
+        self.chat_memory.add_user_message(input_str, metadata=metadata)
+        self.chat_memory.add_ai_message(output_str, metadata=metadata)
diff --git a/llm/Lib/site-packages/langchain/model_laboratory.py b/llm/Lib/site-packages/langchain/model_laboratory.py
new file mode 100644
index 0000000000000000000000000000000000000000..114994535d8a895ab6de53a38bb34dc83279d5db
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/model_laboratory.py
@@ -0,0 +1,84 @@
+"""Experiment with different models."""
+
+from __future__ import annotations
+
+from typing import List, Optional, Sequence
+
+from langchain_core.language_models.llms import BaseLLM
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.utils.input import get_color_mapping, print_text
+
+from langchain.chains.base import Chain
+from langchain.chains.llm import LLMChain
+
+
+class ModelLaboratory:
+    """Experiment with different models."""
+
+    def __init__(self, chains: Sequence[Chain], names: Optional[List[str]] = None):
+        """Initialize with chains to experiment with.
+
+        Args:
+            chains: list of chains to experiment with.
+        """
+        for chain in chains:
+            if not isinstance(chain, Chain):
+                raise ValueError(
+                    "ModelLaboratory should now be initialized with Chains. "
+                    "If you want to initialize with LLMs, use the `from_llms` method "
+                    "instead (`ModelLaboratory.from_llms(...)`)"
+                )
+            if len(chain.input_keys) != 1:
+                raise ValueError(
+                    "Currently only support chains with one input variable, "
+                    f"got {chain.input_keys}"
+                )
+            if len(chain.output_keys) != 1:
+                raise ValueError(
+                    "Currently only support chains with one output variable, "
+                    f"got {chain.output_keys}"
+                )
+        if names is not None:
+            if len(names) != len(chains):
+                raise ValueError("Length of chains does not match length of names.")
+        self.chains = chains
+        chain_range = [str(i) for i in range(len(self.chains))]
+        self.chain_colors = get_color_mapping(chain_range)
+        self.names = names
+
+    @classmethod
+    def from_llms(
+        cls, llms: List[BaseLLM], prompt: Optional[PromptTemplate] = None
+    ) -> ModelLaboratory:
+        """Initialize with LLMs to experiment with and optional prompt.
+
+        Args:
+            llms: list of LLMs to experiment with
+            prompt: Optional prompt to use to prompt the LLMs. Defaults to None.
+                If a prompt was provided, it should only have one input variable.
+        """
+        if prompt is None:
+            prompt = PromptTemplate(input_variables=["_input"], template="{_input}")
+        chains = [LLMChain(llm=llm, prompt=prompt) for llm in llms]
+        names = [str(llm) for llm in llms]
+        return cls(chains, names=names)
+
+    def compare(self, text: str) -> None:
+        """Compare model outputs on an input text.
+
+        If a prompt was provided with starting the laboratory, then this text will be
+        fed into the prompt. If no prompt was provided, then the input text is the
+        entire prompt.
+
+        Args:
+            text: input text to run all models on.
+        """
+        print(f"\033[1mInput:\033[0m\n{text}\n")  # noqa: T201
+        for i, chain in enumerate(self.chains):
+            if self.names is not None:
+                name = self.names[i]
+            else:
+                name = str(chain)
+            print_text(name, end="\n")
+            output = chain.run(text)
+            print_text(output, color=self.chain_colors[str(i)], end="\n\n")
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__init__.py b/llm/Lib/site-packages/langchain/output_parsers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..56e5a80b974486ba6e61d577548cf2ba56c0afe2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/__init__.py
@@ -0,0 +1,65 @@
+"""**OutputParser** classes parse the output of an LLM call.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseLLMOutputParser --> BaseOutputParser --> <name>OutputParser  # ListOutputParser, PydanticOutputParser
+
+**Main helpers:**
+
+.. code-block::
+
+    Serializable, Generation, PromptValue
+"""  # noqa: E501
+from langchain.output_parsers.boolean import BooleanOutputParser
+from langchain.output_parsers.combining import CombiningOutputParser
+from langchain.output_parsers.datetime import DatetimeOutputParser
+from langchain.output_parsers.enum import EnumOutputParser
+from langchain.output_parsers.fix import OutputFixingParser
+from langchain.output_parsers.list import (
+    CommaSeparatedListOutputParser,
+    ListOutputParser,
+    MarkdownListOutputParser,
+    NumberedListOutputParser,
+)
+from langchain.output_parsers.openai_tools import (
+    JsonOutputKeyToolsParser,
+    JsonOutputToolsParser,
+    PydanticToolsParser,
+)
+from langchain.output_parsers.pandas_dataframe import PandasDataFrameOutputParser
+from langchain.output_parsers.pydantic import PydanticOutputParser
+from langchain.output_parsers.rail_parser import GuardrailsOutputParser
+from langchain.output_parsers.regex import RegexParser
+from langchain.output_parsers.regex_dict import RegexDictParser
+from langchain.output_parsers.retry import RetryOutputParser, RetryWithErrorOutputParser
+from langchain.output_parsers.structured import ResponseSchema, StructuredOutputParser
+from langchain.output_parsers.xml import XMLOutputParser
+from langchain.output_parsers.yaml import YamlOutputParser
+
+__all__ = [
+    "BooleanOutputParser",
+    "CombiningOutputParser",
+    "CommaSeparatedListOutputParser",
+    "DatetimeOutputParser",
+    "EnumOutputParser",
+    "GuardrailsOutputParser",
+    "ListOutputParser",
+    "MarkdownListOutputParser",
+    "NumberedListOutputParser",
+    "OutputFixingParser",
+    "PandasDataFrameOutputParser",
+    "PydanticOutputParser",
+    "RegexDictParser",
+    "RegexParser",
+    "ResponseSchema",
+    "RetryOutputParser",
+    "RetryWithErrorOutputParser",
+    "StructuredOutputParser",
+    "XMLOutputParser",
+    "JsonOutputToolsParser",
+    "PydanticToolsParser",
+    "JsonOutputKeyToolsParser",
+    "YamlOutputParser",
+]
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8c8f72cd2213ec28d4546f1ae3d24c1324bbb7d3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/boolean.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/boolean.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7adfb068859da119fd3f4105031fa010af18bec5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/boolean.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/combining.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/combining.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a3bd85ba376a2eddb7fd20c3a6746e072273cd47
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/combining.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/datetime.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/datetime.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2d95de1e1b3d43db3cb3ddd6a0bc6603a1a22cdd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/datetime.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/enum.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/enum.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2f531af2e687f49fed3db2895f7e3572bfcf9989
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/enum.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/ernie_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/ernie_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d811d79196d266caa01ec7ead7c87884832d9ec2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/ernie_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/fix.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/fix.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8c7e546c0138a93bc460559b0cb839ed891e8994
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/fix.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/format_instructions.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/format_instructions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9ae76f15fd31a43ac2a46db22f926a570fbd3f9d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/format_instructions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/json.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/json.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..036654ca710d8dafa802c25c98babe64881d61f8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/json.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/list.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/list.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..87ed92ad053a0c2e6b1c24bd6da40631507aa0bc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/list.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/loading.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/loading.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7df4268fff1eb8e9c709a012f020586621baa50f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/loading.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/openai_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/openai_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..15efef3f0902fdd85749fbc549fc88dc06c9659f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/openai_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/openai_tools.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/openai_tools.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7358768f8d4c9aa3612e7be54e41c4583cc2833b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/openai_tools.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/pandas_dataframe.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/pandas_dataframe.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a46b040fade336c19f0292d698e390a0232fd204
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/pandas_dataframe.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/prompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/prompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f27471a8284038247da07d9b60eec48c9c4a4f0a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/prompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/pydantic.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/pydantic.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..84ac76b1a7aad1eee2241b2f55be98e6a3e7b2ae
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/pydantic.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/rail_parser.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/rail_parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ecc5d69f465723182e0bc4ec914c020552fd8515
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/rail_parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/regex.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/regex.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..67f926dda962efe853639d9ec5982da787ee9ea2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/regex.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/regex_dict.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/regex_dict.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aa89a497d88b616e30689c6184c306eeec0c13b1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/regex_dict.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/retry.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/retry.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..548cf60fa407bfd467a574615343e64f6ef30bc4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/retry.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/structured.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/structured.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2eaa657478a8884925ae00d031fa112b6f4033f4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/structured.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/xml.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/xml.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b0a87d0147cec57b9cfa781da044899719af39b3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/xml.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/__pycache__/yaml.cpython-311.pyc b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/yaml.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bf016c16e3b8594d842451edaa53b880439c66cb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/output_parsers/__pycache__/yaml.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/output_parsers/boolean.py b/llm/Lib/site-packages/langchain/output_parsers/boolean.py
new file mode 100644
index 0000000000000000000000000000000000000000..5114b975a74bdf4cef988ac2415bbdc66b50b856
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/boolean.py
@@ -0,0 +1,51 @@
+import re
+
+from langchain_core.output_parsers import BaseOutputParser
+
+
+class BooleanOutputParser(BaseOutputParser[bool]):
+    """Parse the output of an LLM call to a boolean."""
+
+    true_val: str = "YES"
+    """The string value that should be parsed as True."""
+    false_val: str = "NO"
+    """The string value that should be parsed as False."""
+
+    def parse(self, text: str) -> bool:
+        """Parse the output of an LLM call to a boolean.
+
+        Args:
+            text: output of a language model
+
+        Returns:
+            boolean
+        """
+        regexp = rf"\b({self.true_val}|{self.false_val})\b"
+
+        truthy = {
+            val.upper()
+            for val in re.findall(regexp, text, flags=re.IGNORECASE | re.MULTILINE)
+        }
+        if self.true_val.upper() in truthy:
+            if self.false_val.upper() in truthy:
+                raise ValueError(
+                    f"Ambiguous response. Both {self.true_val} and {self.false_val} "
+                    f"in received: {text}."
+                )
+            return True
+        elif self.false_val.upper() in truthy:
+            if self.true_val.upper() in truthy:
+                raise ValueError(
+                    f"Ambiguous response. Both {self.true_val} and {self.false_val} "
+                    f"in received: {text}."
+                )
+            return False
+        raise ValueError(
+            f"BooleanOutputParser expected output value to include either "
+            f"{self.true_val} or {self.false_val}. Received {text}."
+        )
+
+    @property
+    def _type(self) -> str:
+        """Snake-case string identifier for an output parser type."""
+        return "boolean_output_parser"
diff --git a/llm/Lib/site-packages/langchain/output_parsers/combining.py b/llm/Lib/site-packages/langchain/output_parsers/combining.py
new file mode 100644
index 0000000000000000000000000000000000000000..1222c2208db68f7cd05d74cc3cad8734b35d0881
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/combining.py
@@ -0,0 +1,52 @@
+from __future__ import annotations
+
+from typing import Any, Dict, List
+
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.pydantic_v1 import root_validator
+
+
+class CombiningOutputParser(BaseOutputParser):
+    """Combine multiple output parsers into one."""
+
+    parsers: List[BaseOutputParser]
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    @root_validator()
+    def validate_parsers(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Validate the parsers."""
+        parsers = values["parsers"]
+        if len(parsers) < 2:
+            raise ValueError("Must have at least two parsers")
+        for parser in parsers:
+            if parser._type == "combining":
+                raise ValueError("Cannot nest combining parsers")
+            if parser._type == "list":
+                raise ValueError("Cannot combine list parsers")
+        return values
+
+    @property
+    def _type(self) -> str:
+        """Return the type key."""
+        return "combining"
+
+    def get_format_instructions(self) -> str:
+        """Instructions on how the LLM output should be formatted."""
+
+        initial = f"For your first output: {self.parsers[0].get_format_instructions()}"
+        subsequent = "\n".join(
+            f"Complete that output fully. Then produce another output, separated by two newline characters: {p.get_format_instructions()}"  # noqa: E501
+            for p in self.parsers[1:]
+        )
+        return f"{initial}\n{subsequent}"
+
+    def parse(self, text: str) -> Dict[str, Any]:
+        """Parse the output of an LLM call."""
+        texts = text.split("\n\n")
+        output = dict()
+        for txt, parser in zip(texts, self.parsers):
+            output.update(parser.parse(txt.strip()))
+        return output
diff --git a/llm/Lib/site-packages/langchain/output_parsers/datetime.py b/llm/Lib/site-packages/langchain/output_parsers/datetime.py
new file mode 100644
index 0000000000000000000000000000000000000000..100e324c8a876c19da1e75dfd5a89a2997b5c6e3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/datetime.py
@@ -0,0 +1,58 @@
+import random
+from datetime import datetime, timedelta
+from typing import List
+
+from langchain_core.exceptions import OutputParserException
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.utils import comma_list
+
+
+def _generate_random_datetime_strings(
+    pattern: str,
+    n: int = 3,
+    start_date: datetime = datetime(1, 1, 1),
+    end_date: datetime = datetime.now() + timedelta(days=3650),
+) -> List[str]:
+    """Generates n random datetime strings conforming to the
+    given pattern within the specified date range.
+
+    Pattern should be a string containing the desired format codes.
+    start_date and end_date should be datetime objects representing
+    the start and end of the date range.
+    """
+    examples = []
+    delta = end_date - start_date
+    for i in range(n):
+        random_delta = random.uniform(0, delta.total_seconds())
+        dt = start_date + timedelta(seconds=random_delta)
+        date_string = dt.strftime(pattern)
+        examples.append(date_string)
+    return examples
+
+
+class DatetimeOutputParser(BaseOutputParser[datetime]):
+    """Parse the output of an LLM call to a datetime."""
+
+    format: str = "%Y-%m-%dT%H:%M:%S.%fZ"
+    """The string value that used as the datetime format."""
+
+    def get_format_instructions(self) -> str:
+        examples = comma_list(_generate_random_datetime_strings(self.format))
+        return (
+            f"Write a datetime string that matches the "
+            f"following pattern: '{self.format}'.\n\n"
+            f"Examples: {examples}\n\n"
+            f"Return ONLY this string, no other words!"
+        )
+
+    def parse(self, response: str) -> datetime:
+        try:
+            return datetime.strptime(response.strip(), self.format)
+        except ValueError as e:
+            raise OutputParserException(
+                f"Could not parse datetime string: {response}"
+            ) from e
+
+    @property
+    def _type(self) -> str:
+        return "datetime"
diff --git a/llm/Lib/site-packages/langchain/output_parsers/enum.py b/llm/Lib/site-packages/langchain/output_parsers/enum.py
new file mode 100644
index 0000000000000000000000000000000000000000..4396a5291bf5acf11a1cfa3d2037e8a6f38c6482
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/enum.py
@@ -0,0 +1,36 @@
+from enum import Enum
+from typing import Any, Dict, List, Type
+
+from langchain_core.exceptions import OutputParserException
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.pydantic_v1 import root_validator
+
+
+class EnumOutputParser(BaseOutputParser):
+    """Parse an output that is one of a set of values."""
+
+    enum: Type[Enum]
+    """The enum to parse. Its values must be strings."""
+
+    @root_validator()
+    def raise_deprecation(cls, values: Dict) -> Dict:
+        enum = values["enum"]
+        if not all(isinstance(e.value, str) for e in enum):
+            raise ValueError("Enum values must be strings")
+        return values
+
+    @property
+    def _valid_values(self) -> List[str]:
+        return [e.value for e in self.enum]
+
+    def parse(self, response: str) -> Any:
+        try:
+            return self.enum(response.strip())
+        except ValueError:
+            raise OutputParserException(
+                f"Response '{response}' is not one of the "
+                f"expected values: {self._valid_values}"
+            )
+
+    def get_format_instructions(self) -> str:
+        return f"Select one of the following options: {', '.join(self._valid_values)}"
diff --git a/llm/Lib/site-packages/langchain/output_parsers/ernie_functions.py b/llm/Lib/site-packages/langchain/output_parsers/ernie_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..c258f854ef51fc596330ddabc0f5e204cb6da156
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/ernie_functions.py
@@ -0,0 +1,15 @@
+from langchain_community.output_parsers.ernie_functions import (
+    JsonKeyOutputFunctionsParser,
+    JsonOutputFunctionsParser,
+    OutputFunctionsParser,
+    PydanticAttrOutputFunctionsParser,
+    PydanticOutputFunctionsParser,
+)
+
+__all__ = [
+    "JsonKeyOutputFunctionsParser",
+    "JsonOutputFunctionsParser",
+    "OutputFunctionsParser",
+    "PydanticAttrOutputFunctionsParser",
+    "PydanticOutputFunctionsParser",
+]
diff --git a/llm/Lib/site-packages/langchain/output_parsers/fix.py b/llm/Lib/site-packages/langchain/output_parsers/fix.py
new file mode 100644
index 0000000000000000000000000000000000000000..036fd1ee0b7c056d7d32229112c791f838f879ca
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/fix.py
@@ -0,0 +1,97 @@
+from __future__ import annotations
+
+from typing import Any, TypeVar
+
+from langchain_core.exceptions import OutputParserException
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompts import BasePromptTemplate
+
+from langchain.output_parsers.prompts import NAIVE_FIX_PROMPT
+
+T = TypeVar("T")
+
+
+class OutputFixingParser(BaseOutputParser[T]):
+    """Wraps a parser and tries to fix parsing errors."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    parser: BaseOutputParser[T]
+    """The parser to use to parse the output."""
+    # Should be an LLMChain but we want to avoid top-level imports from langchain.chains
+    retry_chain: Any
+    """The LLMChain to use to retry the completion."""
+    max_retries: int = 1
+    """The maximum number of times to retry the parse."""
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        parser: BaseOutputParser[T],
+        prompt: BasePromptTemplate = NAIVE_FIX_PROMPT,
+        max_retries: int = 1,
+    ) -> OutputFixingParser[T]:
+        """Create an OutputFixingParser from a language model and a parser.
+
+        Args:
+            llm: llm to use for fixing
+            parser: parser to use for parsing
+            prompt: prompt to use for fixing
+            max_retries: Maximum number of retries to parse.
+
+        Returns:
+            OutputFixingParser
+        """
+        from langchain.chains.llm import LLMChain
+
+        chain = LLMChain(llm=llm, prompt=prompt)
+        return cls(parser=parser, retry_chain=chain, max_retries=max_retries)
+
+    def parse(self, completion: str) -> T:
+        retries = 0
+
+        while retries <= self.max_retries:
+            try:
+                return self.parser.parse(completion)
+            except OutputParserException as e:
+                if retries == self.max_retries:
+                    raise e
+                else:
+                    retries += 1
+                    completion = self.retry_chain.run(
+                        instructions=self.parser.get_format_instructions(),
+                        completion=completion,
+                        error=repr(e),
+                    )
+
+        raise OutputParserException("Failed to parse")
+
+    async def aparse(self, completion: str) -> T:
+        retries = 0
+
+        while retries <= self.max_retries:
+            try:
+                return await self.parser.aparse(completion)
+            except OutputParserException as e:
+                if retries == self.max_retries:
+                    raise e
+                else:
+                    retries += 1
+                    completion = await self.retry_chain.arun(
+                        instructions=self.parser.get_format_instructions(),
+                        completion=completion,
+                        error=repr(e),
+                    )
+
+        raise OutputParserException("Failed to parse")
+
+    def get_format_instructions(self) -> str:
+        return self.parser.get_format_instructions()
+
+    @property
+    def _type(self) -> str:
+        return "output_fixing"
diff --git a/llm/Lib/site-packages/langchain/output_parsers/format_instructions.py b/llm/Lib/site-packages/langchain/output_parsers/format_instructions.py
new file mode 100644
index 0000000000000000000000000000000000000000..d9e892f206c6d5e1e87f8949dbe8deaa96a1fa5b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/format_instructions.py
@@ -0,0 +1,81 @@
+# flake8: noqa
+
+STRUCTURED_FORMAT_INSTRUCTIONS = """The output should be a markdown code snippet formatted in the following schema, including the leading and trailing "```json" and "```":
+
+```json
+{{
+{format}
+}}
+```"""
+
+STRUCTURED_FORMAT_SIMPLE_INSTRUCTIONS = """
+```json
+{{
+{format}
+}}
+```"""
+
+
+PYDANTIC_FORMAT_INSTRUCTIONS = """The output should be formatted as a JSON instance that conforms to the JSON schema below.
+
+As an example, for the schema {{"properties": {{"foo": {{"title": "Foo", "description": "a list of strings", "type": "array", "items": {{"type": "string"}}}}}}, "required": ["foo"]}}
+the object {{"foo": ["bar", "baz"]}} is a well-formatted instance of the schema. The object {{"properties": {{"foo": ["bar", "baz"]}}}} is not well-formatted.
+
+Here is the output schema:
+```
+{schema}
+```"""
+
+YAML_FORMAT_INSTRUCTIONS = """The output should be formatted as a YAML instance that conforms to the given JSON schema below.
+
+# Examples
+## Schema
+```
+{{"title": "Players", "description": "A list of players", "type": "array", "items": {{"$ref": "#/definitions/Player"}}, "definitions": {{"Player": {{"title": "Player", "type": "object", "properties": {{"name": {{"title": "Name", "description": "Player name", "type": "string"}}, "avg": {{"title": "Avg", "description": "Batting average", "type": "number"}}}}, "required": ["name", "avg"]}}}}}}
+```
+## Well formatted instance
+```
+- name: John Doe
+  avg: 0.3
+- name: Jane Maxfield
+  avg: 1.4
+```
+
+## Schema
+```
+{{"properties": {{"habit": {{ "description": "A common daily habit", "type": "string" }}, "sustainable_alternative": {{ "description": "An environmentally friendly alternative to the habit", "type": "string"}}}}, "required": ["habit", "sustainable_alternative"]}}
+```
+## Well formatted instance
+```
+habit: Using disposable water bottles for daily hydration.
+sustainable_alternative: Switch to a reusable water bottle to reduce plastic waste and decrease your environmental footprint.
+``` 
+
+Please follow the standard YAML formatting conventions with an indent of 2 spaces and make sure that the data types adhere strictly to the following JSON schema: 
+```
+{schema}
+```
+
+Make sure to always enclose the YAML output in triple backticks (```). Please do not add anything other than valid YAML output!"""
+
+
+PANDAS_DATAFRAME_FORMAT_INSTRUCTIONS = """The output should be formatted as a string as the operation, followed by a colon, followed by the column or row to be queried on, followed by optional array parameters.
+1. The column names are limited to the possible columns below.
+2. Arrays must either be a comma-separated list of numbers formatted as [1,3,5], or it must be in range of numbers formatted as [0..4].
+3. Remember that arrays are optional and not necessarily required.
+4. If the column is not in the possible columns or the operation is not a valid Pandas DataFrame operation, return why it is invalid as a sentence starting with either "Invalid column" or "Invalid operation".
+
+As an example, for the formats:
+1. String "column:num_legs" is a well-formatted instance which gets the column num_legs, where num_legs is a possible column.
+2. String "row:1" is a well-formatted instance which gets row 1.
+3. String "column:num_legs[1,2]" is a well-formatted instance which gets the column num_legs for rows 1 and 2, where num_legs is a possible column.
+4. String "row:1[num_legs]" is a well-formatted instance which gets row 1, but for just column num_legs, where num_legs is a possible column.
+5. String "mean:num_legs[1..3]" is a well-formatted instance which takes the mean of num_legs from rows 1 to 3, where num_legs is a possible column and mean is a valid Pandas DataFrame operation.
+6. String "do_something:num_legs" is a badly-formatted instance, where do_something is not a valid Pandas DataFrame operation.
+7. String "mean:invalid_col" is a badly-formatted instance, where invalid_col is not a possible column.
+
+Here are the possible columns:
+```
+{columns}
+```
+"""
diff --git a/llm/Lib/site-packages/langchain/output_parsers/json.py b/llm/Lib/site-packages/langchain/output_parsers/json.py
new file mode 100644
index 0000000000000000000000000000000000000000..20b06e3bcaacbf2be38fc0a4178e95200d561a21
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/json.py
@@ -0,0 +1,15 @@
+from langchain_core.output_parsers.json import (
+    SimpleJsonOutputParser,
+)
+from langchain_core.utils.json import (
+    parse_and_check_json_markdown,
+    parse_json_markdown,
+    parse_partial_json,
+)
+
+__all__ = [
+    "SimpleJsonOutputParser",
+    "parse_partial_json",
+    "parse_json_markdown",
+    "parse_and_check_json_markdown",
+]
diff --git a/llm/Lib/site-packages/langchain/output_parsers/list.py b/llm/Lib/site-packages/langchain/output_parsers/list.py
new file mode 100644
index 0000000000000000000000000000000000000000..b5ffd8a3ab7466c80d28dd9762ee547af2e7d498
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/list.py
@@ -0,0 +1,13 @@
+from langchain_core.output_parsers.list import (
+    CommaSeparatedListOutputParser,
+    ListOutputParser,
+    MarkdownListOutputParser,
+    NumberedListOutputParser,
+)
+
+__all__ = [
+    "ListOutputParser",
+    "CommaSeparatedListOutputParser",
+    "NumberedListOutputParser",
+    "MarkdownListOutputParser",
+]
diff --git a/llm/Lib/site-packages/langchain/output_parsers/loading.py b/llm/Lib/site-packages/langchain/output_parsers/loading.py
new file mode 100644
index 0000000000000000000000000000000000000000..b25710c123609cbf9ff84c5b1f35a9dc59525c86
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/loading.py
@@ -0,0 +1,22 @@
+from langchain.output_parsers.regex import RegexParser
+
+
+def load_output_parser(config: dict) -> dict:
+    """Load an output parser.
+
+    Args:
+        config: config dict
+
+    Returns:
+        config dict with output parser loaded
+    """
+    if "output_parsers" in config:
+        if config["output_parsers"] is not None:
+            _config = config["output_parsers"]
+            output_parser_type = _config["_type"]
+            if output_parser_type == "regex_parser":
+                output_parser = RegexParser(**_config)
+            else:
+                raise ValueError(f"Unsupported output parser {output_parser_type}")
+            config["output_parsers"] = output_parser
+    return config
diff --git a/llm/Lib/site-packages/langchain/output_parsers/openai_functions.py b/llm/Lib/site-packages/langchain/output_parsers/openai_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..800b66b652c35e8f216407a09caede38fd8e1bfd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/openai_functions.py
@@ -0,0 +1,13 @@
+from langchain_core.output_parsers.openai_functions import (
+    JsonKeyOutputFunctionsParser,
+    JsonOutputFunctionsParser,
+    PydanticAttrOutputFunctionsParser,
+    PydanticOutputFunctionsParser,
+)
+
+__all__ = [
+    "PydanticOutputFunctionsParser",
+    "PydanticAttrOutputFunctionsParser",
+    "JsonOutputFunctionsParser",
+    "JsonKeyOutputFunctionsParser",
+]
diff --git a/llm/Lib/site-packages/langchain/output_parsers/openai_tools.py b/llm/Lib/site-packages/langchain/output_parsers/openai_tools.py
new file mode 100644
index 0000000000000000000000000000000000000000..57a1a667226c057b6b3af812083c16ff08b18288
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/openai_tools.py
@@ -0,0 +1,7 @@
+from langchain_core.output_parsers.openai_tools import (
+    JsonOutputKeyToolsParser,
+    JsonOutputToolsParser,
+    PydanticToolsParser,
+)
+
+__all__ = ["PydanticToolsParser", "JsonOutputToolsParser", "JsonOutputKeyToolsParser"]
diff --git a/llm/Lib/site-packages/langchain/output_parsers/pandas_dataframe.py b/llm/Lib/site-packages/langchain/output_parsers/pandas_dataframe.py
new file mode 100644
index 0000000000000000000000000000000000000000..4c0cb177d02a6dfaab03befe89f5164b565c817e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/pandas_dataframe.py
@@ -0,0 +1,159 @@
+import re
+from typing import Any, Dict, List, Tuple, Union
+
+from langchain_core.exceptions import OutputParserException
+from langchain_core.output_parsers.base import BaseOutputParser
+from langchain_core.pydantic_v1 import validator
+
+from langchain.output_parsers.format_instructions import (
+    PANDAS_DATAFRAME_FORMAT_INSTRUCTIONS,
+)
+
+
+class PandasDataFrameOutputParser(BaseOutputParser):
+    """Parse an output using Pandas DataFrame format."""
+
+    """The Pandas DataFrame to parse."""
+    dataframe: Any
+
+    @validator("dataframe")
+    def validate_dataframe(cls, val: Any) -> Any:
+        import pandas as pd
+
+        if issubclass(type(val), pd.DataFrame):
+            return val
+        if pd.DataFrame(val).empty:
+            raise ValueError("DataFrame cannot be empty.")
+
+        raise TypeError(
+            "Wrong type for 'dataframe', must be a subclass \
+                of Pandas DataFrame (pd.DataFrame)"
+        )
+
+    def parse_array(
+        self, array: str, original_request_params: str
+    ) -> Tuple[List[Union[int, str]], str]:
+        parsed_array: List[Union[int, str]] = []
+
+        # Check if the format is [1,3,5]
+        if re.match(r"\[\d+(,\s*\d+)*\]", array):
+            parsed_array = [int(i) for i in re.findall(r"\d+", array)]
+        # Check if the format is [1..5]
+        elif re.match(r"\[(\d+)\.\.(\d+)\]", array):
+            match = re.match(r"\[(\d+)\.\.(\d+)\]", array)
+            if match:
+                start, end = map(int, match.groups())
+                parsed_array = list(range(start, end + 1))
+            else:
+                raise OutputParserException(
+                    f"Unable to parse the array provided in {array}. \
+                        Please check the format instructions."
+                )
+        # Check if the format is ["column_name"]
+        elif re.match(r"\[[a-zA-Z0-9_]+(?:,[a-zA-Z0-9_]+)*\]", array):
+            match = re.match(r"\[[a-zA-Z0-9_]+(?:,[a-zA-Z0-9_]+)*\]", array)
+            if match:
+                parsed_array = list(map(str, match.group().strip("[]").split(",")))
+            else:
+                raise OutputParserException(
+                    f"Unable to parse the array provided in {array}. \
+                        Please check the format instructions."
+                )
+
+        # Validate the array
+        if not parsed_array:
+            raise OutputParserException(
+                f"Invalid array format in '{original_request_params}'. \
+                    Please check the format instructions."
+            )
+        elif (
+            isinstance(parsed_array[0], int)
+            and parsed_array[-1] > self.dataframe.index.max()
+        ):
+            raise OutputParserException(
+                f"The maximum index {parsed_array[-1]} exceeds the maximum index of \
+                    the Pandas DataFrame {self.dataframe.index.max()}."
+            )
+
+        return parsed_array, original_request_params.split("[")[0]
+
+    def parse(self, request: str) -> Dict[str, Any]:
+        stripped_request_params = None
+        splitted_request = request.strip().split(":")
+        if len(splitted_request) != 2:
+            raise OutputParserException(
+                f"Request '{request}' is not correctly formatted. \
+                    Please refer to the format instructions."
+            )
+        result = {}
+        try:
+            request_type, request_params = splitted_request
+            if request_type in {"Invalid column", "Invalid operation"}:
+                raise OutputParserException(
+                    f"{request}. Please check the format instructions."
+                )
+            array_exists = re.search(r"(\[.*?\])", request_params)
+            if array_exists:
+                parsed_array, stripped_request_params = self.parse_array(
+                    array_exists.group(1), request_params
+                )
+                if request_type == "column":
+                    filtered_df = self.dataframe[
+                        self.dataframe.index.isin(parsed_array)
+                    ]
+                    if len(parsed_array) == 1:
+                        result[stripped_request_params] = filtered_df[
+                            stripped_request_params
+                        ].iloc[parsed_array[0]]
+                    else:
+                        result[stripped_request_params] = filtered_df[
+                            stripped_request_params
+                        ]
+                elif request_type == "row":
+                    filtered_df = self.dataframe[
+                        self.dataframe.columns.intersection(parsed_array)
+                    ]
+                    if len(parsed_array) == 1:
+                        result[stripped_request_params] = filtered_df.iloc[
+                            int(stripped_request_params)
+                        ][parsed_array[0]]
+                    else:
+                        result[stripped_request_params] = filtered_df.iloc[
+                            int(stripped_request_params)
+                        ]
+                else:
+                    filtered_df = self.dataframe[
+                        self.dataframe.index.isin(parsed_array)
+                    ]
+                    result[request_type] = getattr(
+                        filtered_df[stripped_request_params], request_type
+                    )()
+            else:
+                if request_type == "column":
+                    result[request_params] = self.dataframe[request_params]
+                elif request_type == "row":
+                    result[request_params] = self.dataframe.iloc[int(request_params)]
+                else:
+                    result[request_type] = getattr(
+                        self.dataframe[request_params], request_type
+                    )()
+        except (AttributeError, IndexError, KeyError):
+            if request_type not in {"column", "row"}:
+                raise OutputParserException(
+                    f"Unsupported request type '{request_type}'. \
+                        Please check the format instructions."
+                )
+            raise OutputParserException(
+                f"""Requested index {
+                    request_params
+                    if stripped_request_params is None
+                    else stripped_request_params
+                } is out of bounds."""
+            )
+
+        return result
+
+    def get_format_instructions(self) -> str:
+        return PANDAS_DATAFRAME_FORMAT_INSTRUCTIONS.format(
+            columns=", ".join(self.dataframe.columns)
+        )
diff --git a/llm/Lib/site-packages/langchain/output_parsers/prompts.py b/llm/Lib/site-packages/langchain/output_parsers/prompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..dd06a70c58b71f849487404e8c0f7d34b258d656
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/prompts.py
@@ -0,0 +1,22 @@
+# flake8: noqa
+from langchain_core.prompts.prompt import PromptTemplate
+
+NAIVE_FIX = """Instructions:
+--------------
+{instructions}
+--------------
+Completion:
+--------------
+{completion}
+--------------
+
+Above, the Completion did not satisfy the constraints given in the Instructions.
+Error:
+--------------
+{error}
+--------------
+
+Please try again. Please only respond with an answer that satisfies the constraints laid out in the Instructions:"""
+
+
+NAIVE_FIX_PROMPT = PromptTemplate.from_template(NAIVE_FIX)
diff --git a/llm/Lib/site-packages/langchain/output_parsers/pydantic.py b/llm/Lib/site-packages/langchain/output_parsers/pydantic.py
new file mode 100644
index 0000000000000000000000000000000000000000..3d8dc727a444ef011f047ffca9d7aad646e89958
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/pydantic.py
@@ -0,0 +1,3 @@
+from langchain_core.output_parsers import PydanticOutputParser
+
+__all__ = ["PydanticOutputParser"]
diff --git a/llm/Lib/site-packages/langchain/output_parsers/rail_parser.py b/llm/Lib/site-packages/langchain/output_parsers/rail_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..3f796938be162f3e7a45a344f80d2df67276cf88
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/rail_parser.py
@@ -0,0 +1,5 @@
+from langchain_community.output_parsers.rail_parser import (
+    GuardrailsOutputParser,
+)
+
+__all__ = ["GuardrailsOutputParser"]
diff --git a/llm/Lib/site-packages/langchain/output_parsers/regex.py b/llm/Lib/site-packages/langchain/output_parsers/regex.py
new file mode 100644
index 0000000000000000000000000000000000000000..ea8b053e1598cebcaa182da3b3e0f361a0dc60c0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/regex.py
@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+import re
+from typing import Dict, List, Optional
+
+from langchain_core.output_parsers import BaseOutputParser
+
+
+class RegexParser(BaseOutputParser):
+    """Parse the output of an LLM call using a regex."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    regex: str
+    """The regex to use to parse the output."""
+    output_keys: List[str]
+    """The keys to use for the output."""
+    default_output_key: Optional[str] = None
+    """The default key to use for the output."""
+
+    @property
+    def _type(self) -> str:
+        """Return the type key."""
+        return "regex_parser"
+
+    def parse(self, text: str) -> Dict[str, str]:
+        """Parse the output of an LLM call."""
+        match = re.search(self.regex, text)
+        if match:
+            return {key: match.group(i + 1) for i, key in enumerate(self.output_keys)}
+        else:
+            if self.default_output_key is None:
+                raise ValueError(f"Could not parse output: {text}")
+            else:
+                return {
+                    key: text if key == self.default_output_key else ""
+                    for key in self.output_keys
+                }
diff --git a/llm/Lib/site-packages/langchain/output_parsers/regex_dict.py b/llm/Lib/site-packages/langchain/output_parsers/regex_dict.py
new file mode 100644
index 0000000000000000000000000000000000000000..1b390485da3f3195640c2582916eab6531d8aef7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/regex_dict.py
@@ -0,0 +1,46 @@
+from __future__ import annotations
+
+import re
+from typing import Dict, Optional
+
+from langchain_core.output_parsers import BaseOutputParser
+
+
+class RegexDictParser(BaseOutputParser):
+    """Parse the output of an LLM call into a Dictionary using a regex."""
+
+    regex_pattern: str = r"{}:\s?([^.'\n']*)\.?"  # : :meta private:
+    """The regex pattern to use to parse the output."""
+    output_key_to_format: Dict[str, str]
+    """The keys to use for the output."""
+    no_update_value: Optional[str] = None
+    """The default key to use for the output."""
+
+    @property
+    def _type(self) -> str:
+        """Return the type key."""
+        return "regex_dict_parser"
+
+    def parse(self, text: str) -> Dict[str, str]:
+        """Parse the output of an LLM call."""
+        result = {}
+        for output_key, expected_format in self.output_key_to_format.items():
+            specific_regex = self.regex_pattern.format(re.escape(expected_format))
+            matches = re.findall(specific_regex, text)
+            if not matches:
+                raise ValueError(
+                    f"No match found for output key: {output_key} with expected format \
+                        {expected_format} on text {text}"
+                )
+            elif len(matches) > 1:
+                raise ValueError(
+                    f"Multiple matches found for output key: {output_key} with \
+                        expected format {expected_format} on text {text}"
+                )
+            elif (
+                self.no_update_value is not None and matches[0] == self.no_update_value
+            ):
+                continue
+            else:
+                result[output_key] = matches[0]
+        return result
diff --git a/llm/Lib/site-packages/langchain/output_parsers/retry.py b/llm/Lib/site-packages/langchain/output_parsers/retry.py
new file mode 100644
index 0000000000000000000000000000000000000000..15d2a1978b1fa2d3ffbfc90645c1b5db04a69112
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/retry.py
@@ -0,0 +1,230 @@
+from __future__ import annotations
+
+from typing import Any, TypeVar
+
+from langchain_core.exceptions import OutputParserException
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompt_values import PromptValue
+from langchain_core.prompts import BasePromptTemplate, PromptTemplate
+
+NAIVE_COMPLETION_RETRY = """Prompt:
+{prompt}
+Completion:
+{completion}
+
+Above, the Completion did not satisfy the constraints given in the Prompt.
+Please try again:"""
+
+NAIVE_COMPLETION_RETRY_WITH_ERROR = """Prompt:
+{prompt}
+Completion:
+{completion}
+
+Above, the Completion did not satisfy the constraints given in the Prompt.
+Details: {error}
+Please try again:"""
+
+NAIVE_RETRY_PROMPT = PromptTemplate.from_template(NAIVE_COMPLETION_RETRY)
+NAIVE_RETRY_WITH_ERROR_PROMPT = PromptTemplate.from_template(
+    NAIVE_COMPLETION_RETRY_WITH_ERROR
+)
+
+T = TypeVar("T")
+
+
+class RetryOutputParser(BaseOutputParser[T]):
+    """Wraps a parser and tries to fix parsing errors.
+
+    Does this by passing the original prompt and the completion to another
+    LLM, and telling it the completion did not satisfy criteria in the prompt.
+    """
+
+    parser: BaseOutputParser[T]
+    """The parser to use to parse the output."""
+    # Should be an LLMChain but we want to avoid top-level imports from langchain.chains
+    retry_chain: Any
+    """The LLMChain to use to retry the completion."""
+    max_retries: int = 1
+    """The maximum number of times to retry the parse."""
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        parser: BaseOutputParser[T],
+        prompt: BasePromptTemplate = NAIVE_RETRY_PROMPT,
+        max_retries: int = 1,
+    ) -> RetryOutputParser[T]:
+        """Create an RetryOutputParser from a language model and a parser.
+
+        Args:
+            llm: llm to use for fixing
+            parser: parser to use for parsing
+            prompt: prompt to use for fixing
+            max_retries: Maximum number of retries to parse.
+
+        Returns:
+            RetryOutputParser
+        """
+        from langchain.chains.llm import LLMChain
+
+        chain = LLMChain(llm=llm, prompt=prompt)
+        return cls(parser=parser, retry_chain=chain, max_retries=max_retries)
+
+    def parse_with_prompt(self, completion: str, prompt_value: PromptValue) -> T:
+        """Parse the output of an LLM call using a wrapped parser.
+
+        Args:
+            completion: The chain completion to parse.
+            prompt_value: The prompt to use to parse the completion.
+
+        Returns:
+            The parsed completion.
+        """
+        retries = 0
+
+        while retries <= self.max_retries:
+            try:
+                return self.parser.parse(completion)
+            except OutputParserException as e:
+                if retries == self.max_retries:
+                    raise e
+                else:
+                    retries += 1
+                    completion = self.retry_chain.run(
+                        prompt=prompt_value.to_string(), completion=completion
+                    )
+
+        raise OutputParserException("Failed to parse")
+
+    async def aparse_with_prompt(self, completion: str, prompt_value: PromptValue) -> T:
+        """Parse the output of an LLM call using a wrapped parser.
+
+        Args:
+            completion: The chain completion to parse.
+            prompt_value: The prompt to use to parse the completion.
+
+        Returns:
+            The parsed completion.
+        """
+        retries = 0
+
+        while retries <= self.max_retries:
+            try:
+                return await self.parser.aparse(completion)
+            except OutputParserException as e:
+                if retries == self.max_retries:
+                    raise e
+                else:
+                    retries += 1
+                    completion = await self.retry_chain.arun(
+                        prompt=prompt_value.to_string(), completion=completion
+                    )
+
+        raise OutputParserException("Failed to parse")
+
+    def parse(self, completion: str) -> T:
+        raise NotImplementedError(
+            "This OutputParser can only be called by the `parse_with_prompt` method."
+        )
+
+    def get_format_instructions(self) -> str:
+        return self.parser.get_format_instructions()
+
+    @property
+    def _type(self) -> str:
+        return "retry"
+
+
+class RetryWithErrorOutputParser(BaseOutputParser[T]):
+    """Wraps a parser and tries to fix parsing errors.
+
+    Does this by passing the original prompt, the completion, AND the error
+    that was raised to another language model and telling it that the completion
+    did not work, and raised the given error. Differs from RetryOutputParser
+    in that this implementation provides the error that was raised back to the
+    LLM, which in theory should give it more information on how to fix it.
+    """
+
+    parser: BaseOutputParser[T]
+    """The parser to use to parse the output."""
+    # Should be an LLMChain but we want to avoid top-level imports from langchain.chains
+    retry_chain: Any
+    """The LLMChain to use to retry the completion."""
+    max_retries: int = 1
+    """The maximum number of times to retry the parse."""
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        parser: BaseOutputParser[T],
+        prompt: BasePromptTemplate = NAIVE_RETRY_WITH_ERROR_PROMPT,
+        max_retries: int = 1,
+    ) -> RetryWithErrorOutputParser[T]:
+        """Create a RetryWithErrorOutputParser from an LLM.
+
+        Args:
+            llm: The LLM to use to retry the completion.
+            parser: The parser to use to parse the output.
+            prompt: The prompt to use to retry the completion.
+            max_retries: The maximum number of times to retry the completion.
+
+        Returns:
+            A RetryWithErrorOutputParser.
+        """
+        from langchain.chains.llm import LLMChain
+
+        chain = LLMChain(llm=llm, prompt=prompt)
+        return cls(parser=parser, retry_chain=chain, max_retries=max_retries)
+
+    def parse_with_prompt(self, completion: str, prompt_value: PromptValue) -> T:
+        retries = 0
+
+        while retries <= self.max_retries:
+            try:
+                return self.parser.parse(completion)
+            except OutputParserException as e:
+                if retries == self.max_retries:
+                    raise e
+                else:
+                    retries += 1
+                    completion = self.retry_chain.run(
+                        prompt=prompt_value.to_string(),
+                        completion=completion,
+                        error=repr(e),
+                    )
+
+        raise OutputParserException("Failed to parse")
+
+    async def aparse_with_prompt(self, completion: str, prompt_value: PromptValue) -> T:
+        retries = 0
+
+        while retries <= self.max_retries:
+            try:
+                return await self.parser.aparse(completion)
+            except OutputParserException as e:
+                if retries == self.max_retries:
+                    raise e
+                else:
+                    retries += 1
+                    completion = await self.retry_chain.arun(
+                        prompt=prompt_value.to_string(),
+                        completion=completion,
+                        error=repr(e),
+                    )
+
+        raise OutputParserException("Failed to parse")
+
+    def parse(self, completion: str) -> T:
+        raise NotImplementedError(
+            "This OutputParser can only be called by the `parse_with_prompt` method."
+        )
+
+    def get_format_instructions(self) -> str:
+        return self.parser.get_format_instructions()
+
+    @property
+    def _type(self) -> str:
+        return "retry_with_error"
diff --git a/llm/Lib/site-packages/langchain/output_parsers/structured.py b/llm/Lib/site-packages/langchain/output_parsers/structured.py
new file mode 100644
index 0000000000000000000000000000000000000000..62847e1dd10fa1c9b8bfe853c71f66c309eed88d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/structured.py
@@ -0,0 +1,101 @@
+from __future__ import annotations
+
+from typing import Any, List
+
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.output_parsers.json import parse_and_check_json_markdown
+from langchain_core.pydantic_v1 import BaseModel
+
+from langchain.output_parsers.format_instructions import (
+    STRUCTURED_FORMAT_INSTRUCTIONS,
+    STRUCTURED_FORMAT_SIMPLE_INSTRUCTIONS,
+)
+
+line_template = '\t"{name}": {type}  // {description}'
+
+
+class ResponseSchema(BaseModel):
+    """A schema for a response from a structured output parser."""
+
+    name: str
+    """The name of the schema."""
+    description: str
+    """The description of the schema."""
+    type: str = "string"
+    """The type of the response."""
+
+
+def _get_sub_string(schema: ResponseSchema) -> str:
+    return line_template.format(
+        name=schema.name, description=schema.description, type=schema.type
+    )
+
+
+class StructuredOutputParser(BaseOutputParser):
+    """Parse the output of an LLM call to a structured output."""
+
+    response_schemas: List[ResponseSchema]
+    """The schemas for the response."""
+
+    @classmethod
+    def from_response_schemas(
+        cls, response_schemas: List[ResponseSchema]
+    ) -> StructuredOutputParser:
+        return cls(response_schemas=response_schemas)
+
+    def get_format_instructions(self, only_json: bool = False) -> str:
+        """Get format instructions for the output parser.
+
+        example:
+        ```python
+        from langchain.output_parsers.structured import (
+            StructuredOutputParser, ResponseSchema
+        )
+
+        response_schemas = [
+            ResponseSchema(
+                name="foo",
+                description="a list of strings",
+                type="List[string]"
+                ),
+            ResponseSchema(
+                name="bar",
+                description="a string",
+                type="string"
+                ),
+        ]
+
+        parser = StructuredOutputParser.from_response_schemas(response_schemas)
+
+        print(parser.get_format_instructions())  # noqa: T201
+
+        output:
+        # The output should be a Markdown code snippet formatted in the following
+        # schema, including the leading and trailing "```json" and "```":
+        #
+        # ```json
+        # {
+        #     "foo": List[string]  // a list of strings
+        #     "bar": string  // a string
+        # }
+        # ```
+
+        Args:
+            only_json (bool): If True, only the json in the Markdown code snippet
+                will be returned, without the introducing text. Defaults to False.
+        """
+        schema_str = "\n".join(
+            [_get_sub_string(schema) for schema in self.response_schemas]
+        )
+        if only_json:
+            return STRUCTURED_FORMAT_SIMPLE_INSTRUCTIONS.format(format=schema_str)
+        else:
+            return STRUCTURED_FORMAT_INSTRUCTIONS.format(format=schema_str)
+
+    def parse(self, text: str) -> Any:
+        expected_keys = [rs.name for rs in self.response_schemas]
+        return parse_and_check_json_markdown(text, expected_keys)
+
+    @property
+    def _type(self) -> str:
+        return "structured"
diff --git a/llm/Lib/site-packages/langchain/output_parsers/xml.py b/llm/Lib/site-packages/langchain/output_parsers/xml.py
new file mode 100644
index 0000000000000000000000000000000000000000..655dc65b9ef07c37d9514b5afb258084c8c243b7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/xml.py
@@ -0,0 +1,3 @@
+from langchain_core.output_parsers.xml import XMLOutputParser
+
+__all__ = ["XMLOutputParser"]
diff --git a/llm/Lib/site-packages/langchain/output_parsers/yaml.py b/llm/Lib/site-packages/langchain/output_parsers/yaml.py
new file mode 100644
index 0000000000000000000000000000000000000000..21bcf359a2c954b40f218d55f2da7576d5a438b7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/output_parsers/yaml.py
@@ -0,0 +1,62 @@
+import json
+import re
+from typing import Type, TypeVar
+
+import yaml
+from langchain_core.exceptions import OutputParserException
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.pydantic_v1 import BaseModel, ValidationError
+
+from langchain.output_parsers.format_instructions import YAML_FORMAT_INSTRUCTIONS
+
+T = TypeVar("T", bound=BaseModel)
+
+
+class YamlOutputParser(BaseOutputParser[T]):
+    """Parse YAML output using a pydantic model."""
+
+    pydantic_object: Type[T]
+    """The pydantic model to parse."""
+    pattern: re.Pattern = re.compile(
+        r"^```(?:ya?ml)?(?P<yaml>[^`]*)", re.MULTILINE | re.DOTALL
+    )
+    """Regex pattern to match yaml code blocks 
+    within triple backticks with optional yaml or yml prefix."""
+
+    def parse(self, text: str) -> T:
+        try:
+            # Greedy search for 1st yaml candidate.
+            match = re.search(self.pattern, text.strip())
+            yaml_str = ""
+            if match:
+                yaml_str = match.group("yaml")
+            else:
+                # If no backticks were present, try to parse the entire output as yaml.
+                yaml_str = text
+
+            json_object = yaml.safe_load(yaml_str)
+            return self.pydantic_object.parse_obj(json_object)
+
+        except (yaml.YAMLError, ValidationError) as e:
+            name = self.pydantic_object.__name__
+            msg = f"Failed to parse {name} from completion {text}. Got: {e}"
+            raise OutputParserException(msg, llm_output=text) from e
+
+    def get_format_instructions(self) -> str:
+        # Copy schema to avoid altering original Pydantic schema.
+        schema = {k: v for k, v in self.pydantic_object.schema().items()}
+
+        # Remove extraneous fields.
+        reduced_schema = schema
+        if "title" in reduced_schema:
+            del reduced_schema["title"]
+        if "type" in reduced_schema:
+            del reduced_schema["type"]
+        # Ensure yaml in context is well-formed with double quotes.
+        schema_str = json.dumps(reduced_schema)
+
+        return YAML_FORMAT_INSTRUCTIONS.format(schema=schema_str)
+
+    @property
+    def _type(self) -> str:
+        return "yaml"
diff --git a/llm/Lib/site-packages/langchain/prompts/__init__.py b/llm/Lib/site-packages/langchain/prompts/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a966fa552617de77c7ef7771ec8b95ba3d79268
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/prompts/__init__.py
@@ -0,0 +1,77 @@
+"""**Prompt** is the input to the model.
+
+Prompt is often constructed
+from multiple components. Prompt classes and functions make constructing
+ and working with prompts easy.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BasePromptTemplate --> PipelinePromptTemplate
+                           StringPromptTemplate --> PromptTemplate
+                                                    FewShotPromptTemplate
+                                                    FewShotPromptWithTemplates
+                           BaseChatPromptTemplate --> AutoGPTPrompt
+                                                      ChatPromptTemplate --> AgentScratchPadChatPromptTemplate
+
+
+
+    BaseMessagePromptTemplate --> MessagesPlaceholder
+                                  BaseStringMessagePromptTemplate --> ChatMessagePromptTemplate
+                                                                      HumanMessagePromptTemplate
+                                                                      AIMessagePromptTemplate
+                                                                      SystemMessagePromptTemplate
+
+    PromptValue --> StringPromptValue
+                    ChatPromptValue
+
+"""  # noqa: E501
+from langchain_core.example_selectors import (
+    LengthBasedExampleSelector,
+    MaxMarginalRelevanceExampleSelector,
+    SemanticSimilarityExampleSelector,
+)
+from langchain_core.prompts import (
+    AIMessagePromptTemplate,
+    BaseChatPromptTemplate,
+    BasePromptTemplate,
+    ChatMessagePromptTemplate,
+    ChatPromptTemplate,
+    FewShotChatMessagePromptTemplate,
+    FewShotPromptTemplate,
+    FewShotPromptWithTemplates,
+    HumanMessagePromptTemplate,
+    MessagesPlaceholder,
+    PipelinePromptTemplate,
+    PromptTemplate,
+    StringPromptTemplate,
+    SystemMessagePromptTemplate,
+    load_prompt,
+)
+
+from langchain.prompts.example_selector import NGramOverlapExampleSelector
+from langchain.prompts.prompt import Prompt
+
+__all__ = [
+    "AIMessagePromptTemplate",
+    "BaseChatPromptTemplate",
+    "BasePromptTemplate",
+    "ChatMessagePromptTemplate",
+    "ChatPromptTemplate",
+    "FewShotPromptTemplate",
+    "FewShotPromptWithTemplates",
+    "HumanMessagePromptTemplate",
+    "LengthBasedExampleSelector",
+    "MaxMarginalRelevanceExampleSelector",
+    "MessagesPlaceholder",
+    "NGramOverlapExampleSelector",
+    "PipelinePromptTemplate",
+    "PromptTemplate",
+    "SemanticSimilarityExampleSelector",
+    "StringPromptTemplate",
+    "SystemMessagePromptTemplate",
+    "load_prompt",
+    "FewShotChatMessagePromptTemplate",
+    "Prompt",
+]
diff --git a/llm/Lib/site-packages/langchain/prompts/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/prompts/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c40764b763d917417d55cce5ce8e309b3c1baa5d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/prompts/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/prompts/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/prompts/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4b8ce767760333a25a7b6820efac2af6b9f0575c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/prompts/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/prompts/__pycache__/chat.cpython-311.pyc b/llm/Lib/site-packages/langchain/prompts/__pycache__/chat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7b4a8568ca23ef51d5b52f9d6fc7c8e9d898dbce
Binary files /dev/null and b/llm/Lib/site-packages/langchain/prompts/__pycache__/chat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/prompts/__pycache__/few_shot.cpython-311.pyc b/llm/Lib/site-packages/langchain/prompts/__pycache__/few_shot.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b694f19d09801f203712eb553fbf70c1328c716
Binary files /dev/null and b/llm/Lib/site-packages/langchain/prompts/__pycache__/few_shot.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/prompts/__pycache__/few_shot_with_templates.cpython-311.pyc b/llm/Lib/site-packages/langchain/prompts/__pycache__/few_shot_with_templates.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..23463fd92855113dddd949d229f4cc8cbb471e23
Binary files /dev/null and b/llm/Lib/site-packages/langchain/prompts/__pycache__/few_shot_with_templates.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/prompts/__pycache__/loading.cpython-311.pyc b/llm/Lib/site-packages/langchain/prompts/__pycache__/loading.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eb569f4321c6a3372ecdfb3638e02b39a0f48d6c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/prompts/__pycache__/loading.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/prompts/__pycache__/pipeline.cpython-311.pyc b/llm/Lib/site-packages/langchain/prompts/__pycache__/pipeline.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eaa26052e51ab7da19b34796099379292620936f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/prompts/__pycache__/pipeline.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/prompts/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/prompts/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e54b9c8a67d08a1c65be8789ae10d0c0b519223c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/prompts/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/prompts/base.py b/llm/Lib/site-packages/langchain/prompts/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..a315ec92d8e10c1c81cb3aa08d3c6da6ae7be502
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/prompts/base.py
@@ -0,0 +1,21 @@
+from langchain_core.prompt_values import StringPromptValue
+from langchain_core.prompts import (
+    BasePromptTemplate,
+    StringPromptTemplate,
+    check_valid_template,
+    get_template_variables,
+    jinja2_formatter,
+    validate_jinja2,
+)
+from langchain_core.prompts.string import _get_jinja2_variables_from_template
+
+__all__ = [
+    "jinja2_formatter",
+    "validate_jinja2",
+    "check_valid_template",
+    "get_template_variables",
+    "StringPromptTemplate",
+    "BasePromptTemplate",
+    "StringPromptValue",
+    "_get_jinja2_variables_from_template",
+]
diff --git a/llm/Lib/site-packages/langchain/prompts/chat.py b/llm/Lib/site-packages/langchain/prompts/chat.py
new file mode 100644
index 0000000000000000000000000000000000000000..35de60b41610f461bcaab18e05ef5280d0a3a6b8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/prompts/chat.py
@@ -0,0 +1,36 @@
+from langchain_core.prompt_values import ChatPromptValue, ChatPromptValueConcrete
+from langchain_core.prompts.chat import (
+    AIMessagePromptTemplate,
+    BaseChatPromptTemplate,
+    BaseMessagePromptTemplate,
+    BaseStringMessagePromptTemplate,
+    ChatMessagePromptTemplate,
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+    MessageLike,
+    MessageLikeRepresentation,
+    MessagePromptTemplateT,
+    MessagesPlaceholder,
+    SystemMessagePromptTemplate,
+    _convert_to_message,
+    _create_template_from_message_type,
+)
+
+__all__ = [
+    "BaseMessagePromptTemplate",
+    "MessagesPlaceholder",
+    "BaseStringMessagePromptTemplate",
+    "ChatMessagePromptTemplate",
+    "HumanMessagePromptTemplate",
+    "AIMessagePromptTemplate",
+    "SystemMessagePromptTemplate",
+    "BaseChatPromptTemplate",
+    "ChatPromptTemplate",
+    "ChatPromptValue",
+    "ChatPromptValueConcrete",
+    "_convert_to_message",
+    "_create_template_from_message_type",
+    "MessagePromptTemplateT",
+    "MessageLike",
+    "MessageLikeRepresentation",
+]
diff --git a/llm/Lib/site-packages/langchain/prompts/example_selector/__init__.py b/llm/Lib/site-packages/langchain/prompts/example_selector/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..670eef9c4c9e8c00716c0bf32393bf0356ff0db1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/prompts/example_selector/__init__.py
@@ -0,0 +1,19 @@
+"""Logic for selecting examples to include in prompts."""
+from langchain_core.example_selectors.length_based import (
+    LengthBasedExampleSelector,
+)
+from langchain_core.example_selectors.semantic_similarity import (
+    MaxMarginalRelevanceExampleSelector,
+    SemanticSimilarityExampleSelector,
+)
+
+from langchain.prompts.example_selector.ngram_overlap import (
+    NGramOverlapExampleSelector,
+)
+
+__all__ = [
+    "LengthBasedExampleSelector",
+    "MaxMarginalRelevanceExampleSelector",
+    "NGramOverlapExampleSelector",
+    "SemanticSimilarityExampleSelector",
+]
diff --git a/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bf516db72772df04ee94b53d7dc87b6116d981b8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..88296b5a6753cf6622cbd0ccdea041fdb5259668
Binary files /dev/null and b/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/length_based.cpython-311.pyc b/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/length_based.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0a2b5c20334dc2ab56dfb3b1158bd8db7533f4ef
Binary files /dev/null and b/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/length_based.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/ngram_overlap.cpython-311.pyc b/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/ngram_overlap.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..57d5749f96817ae84f764caf1caa18bf870bde18
Binary files /dev/null and b/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/ngram_overlap.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/semantic_similarity.cpython-311.pyc b/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/semantic_similarity.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..87e0a28983d95a6561853cbe86c9bbe85d7075f4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/prompts/example_selector/__pycache__/semantic_similarity.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/prompts/example_selector/base.py b/llm/Lib/site-packages/langchain/prompts/example_selector/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..d6c9e074bdb57f4f7cf1ac9402388d619bdb6c2c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/prompts/example_selector/base.py
@@ -0,0 +1,3 @@
+from langchain_core.example_selectors.base import BaseExampleSelector
+
+__all__ = ["BaseExampleSelector"]
diff --git a/llm/Lib/site-packages/langchain/prompts/example_selector/length_based.py b/llm/Lib/site-packages/langchain/prompts/example_selector/length_based.py
new file mode 100644
index 0000000000000000000000000000000000000000..1bb38d8a0c1537a325413732189c808d42c4ae56
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/prompts/example_selector/length_based.py
@@ -0,0 +1,5 @@
+from langchain_core.example_selectors.length_based import (
+    LengthBasedExampleSelector,
+)
+
+__all__ = ["LengthBasedExampleSelector"]
diff --git a/llm/Lib/site-packages/langchain/prompts/example_selector/ngram_overlap.py b/llm/Lib/site-packages/langchain/prompts/example_selector/ngram_overlap.py
new file mode 100644
index 0000000000000000000000000000000000000000..db1be277e46d504d451011f04d5d14af76acdca8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/prompts/example_selector/ngram_overlap.py
@@ -0,0 +1,9 @@
+from langchain_community.example_selectors.ngram_overlap import (
+    NGramOverlapExampleSelector,
+    ngram_overlap_score,
+)
+
+__all__ = [
+    "NGramOverlapExampleSelector",
+    "ngram_overlap_score",
+]
diff --git a/llm/Lib/site-packages/langchain/prompts/example_selector/semantic_similarity.py b/llm/Lib/site-packages/langchain/prompts/example_selector/semantic_similarity.py
new file mode 100644
index 0000000000000000000000000000000000000000..e921236d8784c189180e2e1bd3cf4139f09729bf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/prompts/example_selector/semantic_similarity.py
@@ -0,0 +1,11 @@
+from langchain_core.example_selectors.semantic_similarity import (
+    MaxMarginalRelevanceExampleSelector,
+    SemanticSimilarityExampleSelector,
+    sorted_values,
+)
+
+__all__ = [
+    "sorted_values",
+    "SemanticSimilarityExampleSelector",
+    "MaxMarginalRelevanceExampleSelector",
+]
diff --git a/llm/Lib/site-packages/langchain/prompts/few_shot.py b/llm/Lib/site-packages/langchain/prompts/few_shot.py
new file mode 100644
index 0000000000000000000000000000000000000000..67b3106271d79080714458b5fae4656e9a28a076
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/prompts/few_shot.py
@@ -0,0 +1,11 @@
+from langchain_core.prompts.few_shot import (
+    FewShotChatMessagePromptTemplate,
+    FewShotPromptTemplate,
+    _FewShotPromptTemplateMixin,
+)
+
+__all__ = [
+    "FewShotPromptTemplate",
+    "FewShotChatMessagePromptTemplate",
+    "_FewShotPromptTemplateMixin",
+]
diff --git a/llm/Lib/site-packages/langchain/prompts/few_shot_with_templates.py b/llm/Lib/site-packages/langchain/prompts/few_shot_with_templates.py
new file mode 100644
index 0000000000000000000000000000000000000000..7e530dbe9cbaa06c51772f41757e07e822317396
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/prompts/few_shot_with_templates.py
@@ -0,0 +1,3 @@
+from langchain_core.prompts.few_shot_with_templates import FewShotPromptWithTemplates
+
+__all__ = ["FewShotPromptWithTemplates"]
diff --git a/llm/Lib/site-packages/langchain/prompts/loading.py b/llm/Lib/site-packages/langchain/prompts/loading.py
new file mode 100644
index 0000000000000000000000000000000000000000..b1dfcd9069120eb0b2c754f0d0e52cb56e8cac7d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/prompts/loading.py
@@ -0,0 +1,23 @@
+from langchain_core.prompts.loading import (
+    _load_examples,
+    _load_few_shot_prompt,
+    _load_output_parser,
+    _load_prompt,
+    _load_prompt_from_file,
+    _load_template,
+    load_prompt,
+    load_prompt_from_config,
+)
+from langchain_core.utils.loading import try_load_from_hub
+
+__all__ = [
+    "load_prompt_from_config",
+    "load_prompt",
+    "try_load_from_hub",
+    "_load_examples",
+    "_load_few_shot_prompt",
+    "_load_output_parser",
+    "_load_prompt",
+    "_load_prompt_from_file",
+    "_load_template",
+]
diff --git a/llm/Lib/site-packages/langchain/prompts/pipeline.py b/llm/Lib/site-packages/langchain/prompts/pipeline.py
new file mode 100644
index 0000000000000000000000000000000000000000..88e2cc79ab25b10921839097b8e1c3de7b9a5361
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/prompts/pipeline.py
@@ -0,0 +1,3 @@
+from langchain_core.prompts.pipeline import PipelinePromptTemplate, _get_inputs
+
+__all__ = ["PipelinePromptTemplate", "_get_inputs"]
diff --git a/llm/Lib/site-packages/langchain/prompts/prompt.py b/llm/Lib/site-packages/langchain/prompts/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e35f878bac0d1502692f04e9d5e6229d87fdff8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/prompts/prompt.py
@@ -0,0 +1,6 @@
+from langchain_core.prompts.prompt import PromptTemplate
+
+# For backwards compatibility.
+Prompt = PromptTemplate
+
+__all__ = ["PromptTemplate", "Prompt"]
diff --git a/llm/Lib/site-packages/langchain/py.typed b/llm/Lib/site-packages/langchain/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/pydantic_v1/__init__.py b/llm/Lib/site-packages/langchain/pydantic_v1/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..859822531ece1971d7ac9b8d5d6cb66d5c81fa23
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/pydantic_v1/__init__.py
@@ -0,0 +1,23 @@
+from importlib import metadata
+
+## Create namespaces for pydantic v1 and v2.
+# This code must stay at the top of the file before other modules may
+# attempt to import pydantic since it adds pydantic_v1 and pydantic_v2 to sys.modules.
+#
+# This hack is done for the following reasons:
+# * Langchain will attempt to remain compatible with both pydantic v1 and v2 since
+#   both dependencies and dependents may be stuck on either version of v1 or v2.
+# * Creating namespaces for pydantic v1 and v2 should allow us to write code that
+#   unambiguously uses either v1 or v2 API.
+# * This change is easier to roll out and roll back.
+
+try:
+    from pydantic.v1 import *  # noqa: F403
+except ImportError:
+    from pydantic import *  # noqa: F403
+
+
+try:
+    _PYDANTIC_MAJOR_VERSION: int = int(metadata.version("pydantic").split(".")[0])
+except metadata.PackageNotFoundError:
+    _PYDANTIC_MAJOR_VERSION = 0
diff --git a/llm/Lib/site-packages/langchain/pydantic_v1/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/pydantic_v1/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..20403cca7b08bb9a8ca5e2c98e1e827a256ce970
Binary files /dev/null and b/llm/Lib/site-packages/langchain/pydantic_v1/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/pydantic_v1/__pycache__/dataclasses.cpython-311.pyc b/llm/Lib/site-packages/langchain/pydantic_v1/__pycache__/dataclasses.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..03b607f84aeadbfefa181b0465859de43ab915b5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/pydantic_v1/__pycache__/dataclasses.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/pydantic_v1/__pycache__/main.cpython-311.pyc b/llm/Lib/site-packages/langchain/pydantic_v1/__pycache__/main.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..37175ae103027458889779d8e66216c1b60fcc90
Binary files /dev/null and b/llm/Lib/site-packages/langchain/pydantic_v1/__pycache__/main.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/pydantic_v1/dataclasses.py b/llm/Lib/site-packages/langchain/pydantic_v1/dataclasses.py
new file mode 100644
index 0000000000000000000000000000000000000000..bb7253c29d74e4f20424f68aa09baf9a76694fe8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/pydantic_v1/dataclasses.py
@@ -0,0 +1,4 @@
+try:
+    from pydantic.v1.dataclasses import *  # noqa: F403
+except ImportError:
+    from pydantic.dataclasses import *  # noqa: F403
diff --git a/llm/Lib/site-packages/langchain/pydantic_v1/main.py b/llm/Lib/site-packages/langchain/pydantic_v1/main.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b8f1670e137456ea75d111a2b507e3f6a477981
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/pydantic_v1/main.py
@@ -0,0 +1,4 @@
+try:
+    from pydantic.v1.main import *  # noqa: F403
+except ImportError:
+    from pydantic.main import *  # noqa: F403
diff --git a/llm/Lib/site-packages/langchain/python.py b/llm/Lib/site-packages/langchain/python.py
new file mode 100644
index 0000000000000000000000000000000000000000..6668535880941a1cf3b6ce7b7efb247e81b5422e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/python.py
@@ -0,0 +1,4 @@
+"""For backwards compatibility."""
+from langchain_community.utilities.python import PythonREPL
+
+__all__ = ["PythonREPL"]
diff --git a/llm/Lib/site-packages/langchain/requests.py b/llm/Lib/site-packages/langchain/requests.py
new file mode 100644
index 0000000000000000000000000000000000000000..f848efbf7cd5eaf105f8eb2df6d703eba9edaf04
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/requests.py
@@ -0,0 +1,8 @@
+"""DEPRECATED: Kept for backwards compatibility."""
+from langchain_community.utilities import Requests, RequestsWrapper, TextRequestsWrapper
+
+__all__ = [
+    "Requests",
+    "RequestsWrapper",
+    "TextRequestsWrapper",
+]
diff --git a/llm/Lib/site-packages/langchain/retrievers/__init__.py b/llm/Lib/site-packages/langchain/retrievers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e2a44de0d51049a2175e9e7f07ccb8c71a5e7057
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/__init__.py
@@ -0,0 +1,104 @@
+"""**Retriever** class returns Documents given a text **query**.
+
+It is more general than a vector store. A retriever does not need to be able to
+store documents, only to return (or retrieve) it. Vector stores can be used as
+the backbone of a retriever, but there are other types of retrievers as well.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseRetriever --> <name>Retriever  # Examples: ArxivRetriever, MergerRetriever
+
+**Main helpers:**
+
+.. code-block::
+
+    Document, Serializable, Callbacks,
+    CallbackManagerForRetrieverRun, AsyncCallbackManagerForRetrieverRun
+"""
+import warnings
+from typing import Any
+
+from langchain_core._api import LangChainDeprecationWarning
+
+from langchain.retrievers.contextual_compression import ContextualCompressionRetriever
+from langchain.retrievers.ensemble import EnsembleRetriever
+from langchain.retrievers.merger_retriever import MergerRetriever
+from langchain.retrievers.multi_query import MultiQueryRetriever
+from langchain.retrievers.multi_vector import MultiVectorRetriever
+from langchain.retrievers.outline import OutlineRetriever
+from langchain.retrievers.parent_document_retriever import ParentDocumentRetriever
+from langchain.retrievers.re_phraser import RePhraseQueryRetriever
+from langchain.retrievers.self_query.base import SelfQueryRetriever
+from langchain.retrievers.time_weighted_retriever import (
+    TimeWeightedVectorStoreRetriever,
+)
+from langchain.retrievers.web_research import WebResearchRetriever
+from langchain.utils.interactive_env import is_interactive_env
+
+
+def __getattr__(name: str) -> Any:
+    from langchain_community import retrievers
+
+    # If not in interactive env, raise warning.
+    if not is_interactive_env():
+        warnings.warn(
+            "Importing this retriever from langchain is deprecated. Importing it from "
+            "langchain will no longer be supported as of langchain==0.2.0. "
+            "Please import from langchain-community instead:\n\n"
+            f"`from langchain_community.retrievers import {name}`.\n\n"
+            "To install langchain-community run `pip install -U langchain-community`.",
+            category=LangChainDeprecationWarning,
+        )
+
+    return getattr(retrievers, name)
+
+
+__all__ = [
+    "AmazonKendraRetriever",
+    "AmazonKnowledgeBasesRetriever",
+    "ArceeRetriever",
+    "ArxivRetriever",
+    "AzureAISearchRetriever",
+    "AzureCognitiveSearchRetriever",
+    "ChatGPTPluginRetriever",
+    "ContextualCompressionRetriever",
+    "ChaindeskRetriever",
+    "CohereRagRetriever",
+    "ElasticSearchBM25Retriever",
+    "EmbedchainRetriever",
+    "GoogleDocumentAIWarehouseRetriever",
+    "GoogleCloudEnterpriseSearchRetriever",
+    "GoogleVertexAIMultiTurnSearchRetriever",
+    "GoogleVertexAISearchRetriever",
+    "KayAiRetriever",
+    "KNNRetriever",
+    "LlamaIndexGraphRetriever",
+    "LlamaIndexRetriever",
+    "MergerRetriever",
+    "MetalRetriever",
+    "MilvusRetriever",
+    "MultiQueryRetriever",
+    "OutlineRetriever",
+    "PineconeHybridSearchRetriever",
+    "PubMedRetriever",
+    "RemoteLangChainRetriever",
+    "SVMRetriever",
+    "SelfQueryRetriever",
+    "TavilySearchAPIRetriever",
+    "TFIDFRetriever",
+    "BM25Retriever",
+    "TimeWeightedVectorStoreRetriever",
+    "VespaRetriever",
+    "WeaviateHybridSearchRetriever",
+    "WikipediaRetriever",
+    "ZepRetriever",
+    "ZillizRetriever",
+    "DocArrayRetriever",
+    "RePhraseQueryRetriever",
+    "WebResearchRetriever",
+    "EnsembleRetriever",
+    "ParentDocumentRetriever",
+    "MultiVectorRetriever",
+]
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..229823eb92cfccfb8349974f760061e917f4f167
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/arcee.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/arcee.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a32354b4625e8225eefd7388d8c9062211675df4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/arcee.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/arxiv.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/arxiv.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..32ade6c1d54818c4bab4d76a0304fcf9c1cd86f9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/arxiv.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/azure_ai_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/azure_ai_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2cf444371edffb3bba32f1ac8c770c4dc3aa2b53
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/azure_ai_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/bedrock.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/bedrock.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bd2068e76115568bdaa5278e19cb118537075a9a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/bedrock.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/bm25.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/bm25.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a4c58daa4c15dae5ba7d498584cd80cdb48af414
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/bm25.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/chaindesk.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/chaindesk.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d789ad4473d3c26c70c5feac3a6d3fa449a9ffe8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/chaindesk.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/chatgpt_plugin_retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/chatgpt_plugin_retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1d970c2ee0edca404aed87ddc761fea630c6a832
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/chatgpt_plugin_retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/cohere_rag_retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/cohere_rag_retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f29ae596e3b1536e5c377a979b532c63a311b0e5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/cohere_rag_retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/contextual_compression.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/contextual_compression.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dd473d92975bfda1c0e1da47af591253ecff35a3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/contextual_compression.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/databerry.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/databerry.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6309af6515113e7f767242a2fd1e6a60e92a799a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/databerry.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/docarray.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/docarray.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cbcd0de7eae1b8564aa35530161747ad4aad511e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/docarray.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/elastic_search_bm25.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/elastic_search_bm25.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1246ee239f5d14501fa575b0b72fb1b7bb2bf10a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/elastic_search_bm25.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/embedchain.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/embedchain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..37535f5a3c9a45dccb529085de5b75025b28e2e6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/embedchain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/ensemble.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/ensemble.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a957fb196125c8d4b1ad019beed1b7d7c5ec0c44
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/ensemble.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/google_cloud_documentai_warehouse.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/google_cloud_documentai_warehouse.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..974eb0ef8e871ab283942b81c09f5f0ea47faa39
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/google_cloud_documentai_warehouse.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/google_vertex_ai_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/google_vertex_ai_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fb6c37c97e25ac2d9b088e9edb7138980c037f35
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/google_vertex_ai_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/kay.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/kay.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9547529dadf001f12367d6a7c459648bc640c0b1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/kay.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/kendra.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/kendra.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a2aef82a34f1de45bccbc209206932718e56db88
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/kendra.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/knn.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/knn.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..459985b43a513d378f3ba679a43554c186d5ea00
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/knn.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/llama_index.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/llama_index.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7a712627c86096f25512e4756cfba9768ffa7ad0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/llama_index.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/merger_retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/merger_retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2b92e00a2bded06c88a4e5a9266d7996e3b0af9d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/merger_retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/metal.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/metal.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..75eefc3c09464d8fe57dbe99e29134a2c8e29846
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/metal.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/milvus.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/milvus.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..002d6c08c90430a8fd5f174d78d21a8c30c4f378
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/milvus.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/multi_query.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/multi_query.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..07db32d0816281bb2a1bc00122b9336970c4b72b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/multi_query.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/multi_vector.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/multi_vector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0e8e50fc939198d623d0e2bcde08a8475ae33eff
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/multi_vector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/outline.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/outline.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c2e8e3010a22b71d3193c857cc29399b8fa8f833
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/outline.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/parent_document_retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/parent_document_retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..057f8f8fd9c34d36a54abb35bc6756cf4ae44ec0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/parent_document_retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/pinecone_hybrid_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/pinecone_hybrid_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3359e0e498e9920619d6b18cf9bd46cd909abebc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/pinecone_hybrid_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/pubmed.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/pubmed.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1025c17b5d5b963666b1c62ce64894654689e521
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/pubmed.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/pupmed.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/pupmed.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9c6d624fdb6f2c3acf13dd514af81a6847cd7863
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/pupmed.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/re_phraser.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/re_phraser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..971ceaa0f274aad86544b05a1b29583fe5c8ba67
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/re_phraser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/remote_retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/remote_retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..49078c8579f22652400c1caa2e381b109c1dd67d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/remote_retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/svm.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/svm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d232f9ea73af297b51736b91f0fc73e75d8f60a8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/svm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/tavily_search_api.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/tavily_search_api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b13005de2fa3a284ae9013d795024b27fc56e4d0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/tavily_search_api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/tfidf.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/tfidf.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..16c82a27bea0c9bac627dfdecdb2fb50cd9198d7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/tfidf.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/time_weighted_retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/time_weighted_retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4f9ff49c8853aad0e33616c274c76f8deb785ec2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/time_weighted_retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/vespa_retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/vespa_retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ba91ba533316538ae2de59da7db3a40947e98d4b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/vespa_retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/weaviate_hybrid_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/weaviate_hybrid_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c569259771237f37c79c7acbc368e4d3a019051d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/weaviate_hybrid_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/web_research.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/web_research.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..12b0be010ca20226638418ebf05c849004f7f069
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/web_research.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/wikipedia.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/wikipedia.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6876fc411c2ab9c14b2be3963f0837e9318d26b6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/wikipedia.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/you.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/you.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d0398d43cdd44894da9ea2e098dfeb4a6f5dee2a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/you.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/zep.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/zep.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9198e495495e5014765b1f28c17f04ac84dd4264
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/zep.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/__pycache__/zilliz.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/__pycache__/zilliz.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a38990acedaedee4682cf655abaebb95d1568451
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/__pycache__/zilliz.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/arcee.py b/llm/Lib/site-packages/langchain/retrievers/arcee.py
new file mode 100644
index 0000000000000000000000000000000000000000..a2f478dfc6b0d0172f3e73f0babc16a92fdb1249
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/arcee.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.arcee import ArceeRetriever
+
+__all__ = ["ArceeRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/arxiv.py b/llm/Lib/site-packages/langchain/retrievers/arxiv.py
new file mode 100644
index 0000000000000000000000000000000000000000..ae90cdd68e98dc32f7dcd7783719133acd6306e2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/arxiv.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.arxiv import ArxivRetriever
+
+__all__ = ["ArxivRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/azure_ai_search.py b/llm/Lib/site-packages/langchain/retrievers/azure_ai_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7c90caa017599a0969b583805caa6f1631a4105
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/azure_ai_search.py
@@ -0,0 +1,6 @@
+from langchain_community.retrievers.azure_ai_search import (
+    AzureAISearchRetriever,
+    AzureCognitiveSearchRetriever,
+)
+
+__all__ = ["AzureAISearchRetriever", "AzureCognitiveSearchRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/bedrock.py b/llm/Lib/site-packages/langchain/retrievers/bedrock.py
new file mode 100644
index 0000000000000000000000000000000000000000..cab6684fbd8d4bde157216aea7d0c6ed0863e904
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/bedrock.py
@@ -0,0 +1,7 @@
+from langchain_community.retrievers.bedrock import (
+    AmazonKnowledgeBasesRetriever,
+    RetrievalConfig,
+    VectorSearchConfig,
+)
+
+__all__ = ["VectorSearchConfig", "RetrievalConfig", "AmazonKnowledgeBasesRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/bm25.py b/llm/Lib/site-packages/langchain/retrievers/bm25.py
new file mode 100644
index 0000000000000000000000000000000000000000..78c728522811158c34554fb8880c879025bcc4ff
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/bm25.py
@@ -0,0 +1,6 @@
+from langchain_community.retrievers.bm25 import (
+    BM25Retriever,
+    default_preprocessing_func,
+)
+
+__all__ = ["default_preprocessing_func", "BM25Retriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/chaindesk.py b/llm/Lib/site-packages/langchain/retrievers/chaindesk.py
new file mode 100644
index 0000000000000000000000000000000000000000..88085eb90bb6d7c18408efa115c6d8b795a85b18
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/chaindesk.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.chaindesk import ChaindeskRetriever
+
+__all__ = ["ChaindeskRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/chatgpt_plugin_retriever.py b/llm/Lib/site-packages/langchain/retrievers/chatgpt_plugin_retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..314d98455c52a59590626c4965f72137abb38ccb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/chatgpt_plugin_retriever.py
@@ -0,0 +1,5 @@
+from langchain_community.retrievers.chatgpt_plugin_retriever import (
+    ChatGPTPluginRetriever,
+)
+
+__all__ = ["ChatGPTPluginRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/cohere_rag_retriever.py b/llm/Lib/site-packages/langchain/retrievers/cohere_rag_retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..560e9957ce89843e3c53b04fd420032e46fd0c12
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/cohere_rag_retriever.py
@@ -0,0 +1,5 @@
+from langchain_community.retrievers.cohere_rag_retriever import (
+    CohereRagRetriever,
+)
+
+__all__ = ["CohereRagRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/contextual_compression.py b/llm/Lib/site-packages/langchain/retrievers/contextual_compression.py
new file mode 100644
index 0000000000000000000000000000000000000000..b41a82a2b419b5d457f3436b8c18ec46b192ec9f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/contextual_compression.py
@@ -0,0 +1,79 @@
+from typing import Any, List
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+from langchain.retrievers.document_compressors.base import (
+    BaseDocumentCompressor,
+)
+
+
+class ContextualCompressionRetriever(BaseRetriever):
+    """Retriever that wraps a base retriever and compresses the results."""
+
+    base_compressor: BaseDocumentCompressor
+    """Compressor for compressing retrieved documents."""
+
+    base_retriever: BaseRetriever
+    """Base Retriever to use for getting relevant documents."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Get documents relevant for a query.
+
+        Args:
+            query: string to find relevant documents for
+
+        Returns:
+            Sequence of relevant documents
+        """
+        docs = self.base_retriever.get_relevant_documents(
+            query, callbacks=run_manager.get_child(), **kwargs
+        )
+        if docs:
+            compressed_docs = self.base_compressor.compress_documents(
+                docs, query, callbacks=run_manager.get_child()
+            )
+            return list(compressed_docs)
+        else:
+            return []
+
+    async def _aget_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: AsyncCallbackManagerForRetrieverRun,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Get documents relevant for a query.
+
+        Args:
+            query: string to find relevant documents for
+
+        Returns:
+            List of relevant documents
+        """
+        docs = await self.base_retriever.aget_relevant_documents(
+            query, callbacks=run_manager.get_child(), **kwargs
+        )
+        if docs:
+            compressed_docs = await self.base_compressor.acompress_documents(
+                docs, query, callbacks=run_manager.get_child()
+            )
+            return list(compressed_docs)
+        else:
+            return []
diff --git a/llm/Lib/site-packages/langchain/retrievers/databerry.py b/llm/Lib/site-packages/langchain/retrievers/databerry.py
new file mode 100644
index 0000000000000000000000000000000000000000..ecb690898ebb1e4a179e36dd4874be25503aa420
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/databerry.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.databerry import DataberryRetriever
+
+__all__ = ["DataberryRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/docarray.py b/llm/Lib/site-packages/langchain/retrievers/docarray.py
new file mode 100644
index 0000000000000000000000000000000000000000..1191adf0e3b077920b074f82cd3d215836b6bc69
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/docarray.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.docarray import DocArrayRetriever, SearchType
+
+__all__ = ["SearchType", "DocArrayRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/__init__.py b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a32c453a3c87752884960374841c36ca6745048
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__init__.py
@@ -0,0 +1,25 @@
+from langchain.retrievers.document_compressors.base import DocumentCompressorPipeline
+from langchain.retrievers.document_compressors.chain_extract import (
+    LLMChainExtractor,
+)
+from langchain.retrievers.document_compressors.chain_filter import (
+    LLMChainFilter,
+)
+from langchain.retrievers.document_compressors.cohere_rerank import CohereRerank
+from langchain.retrievers.document_compressors.cross_encoder_rerank import (
+    CrossEncoderReranker,
+)
+from langchain.retrievers.document_compressors.embeddings_filter import (
+    EmbeddingsFilter,
+)
+from langchain.retrievers.document_compressors.flashrank_rerank import FlashrankRerank
+
+__all__ = [
+    "DocumentCompressorPipeline",
+    "EmbeddingsFilter",
+    "LLMChainExtractor",
+    "LLMChainFilter",
+    "CohereRerank",
+    "CrossEncoderReranker",
+    "FlashrankRerank",
+]
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f5ab0db2ee439d441780b440fccba425086902b9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cbfd00d22f92211d3acf38f10ae8747464eae50a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/chain_extract.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/chain_extract.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fb6ad0d1ab12086a6d80a11338907620ca515d3a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/chain_extract.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/chain_extract_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/chain_extract_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eeebb14973b549f86e0925858869fca6c4465c94
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/chain_extract_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/chain_filter.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/chain_filter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ef02a5d961630905a658614f57961913f9306669
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/chain_filter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/chain_filter_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/chain_filter_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2d736d1dabbdcfd4ef21bf204f125e8c93ba0444
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/chain_filter_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/cohere_rerank.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/cohere_rerank.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..38a32aaedd28b0f699b833f43c2fb7980eee6ff9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/cohere_rerank.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/cross_encoder_rerank.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/cross_encoder_rerank.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..96a04a4c100bf5e85e7f360a0d3274947b0ce47f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/cross_encoder_rerank.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/embeddings_filter.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/embeddings_filter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5378872ec59e990088f5121d1d7d79f7afdabf3a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/embeddings_filter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/flashrank_rerank.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/flashrank_rerank.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7823dabc429a69de83b3d8f193e9d01ae0ba46f3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/document_compressors/__pycache__/flashrank_rerank.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/base.py b/llm/Lib/site-packages/langchain/retrievers/document_compressors/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..ae8efdf656352f0605e6c5c6fd877ed23328308a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/document_compressors/base.py
@@ -0,0 +1,76 @@
+from inspect import signature
+from typing import List, Optional, Sequence, Union
+
+from langchain_core.documents import (
+    BaseDocumentCompressor,
+    BaseDocumentTransformer,
+    Document,
+)
+
+from langchain.callbacks.manager import Callbacks
+
+
+class DocumentCompressorPipeline(BaseDocumentCompressor):
+    """Document compressor that uses a pipeline of Transformers."""
+
+    transformers: List[Union[BaseDocumentTransformer, BaseDocumentCompressor]]
+    """List of document filters that are chained together and run in sequence."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def compress_documents(
+        self,
+        documents: Sequence[Document],
+        query: str,
+        callbacks: Optional[Callbacks] = None,
+    ) -> Sequence[Document]:
+        """Transform a list of documents."""
+        for _transformer in self.transformers:
+            if isinstance(_transformer, BaseDocumentCompressor):
+                accepts_callbacks = (
+                    signature(_transformer.compress_documents).parameters.get(
+                        "callbacks"
+                    )
+                    is not None
+                )
+                if accepts_callbacks:
+                    documents = _transformer.compress_documents(
+                        documents, query, callbacks=callbacks
+                    )
+                else:
+                    documents = _transformer.compress_documents(documents, query)
+            elif isinstance(_transformer, BaseDocumentTransformer):
+                documents = _transformer.transform_documents(documents)
+            else:
+                raise ValueError(f"Got unexpected transformer type: {_transformer}")
+        return documents
+
+    async def acompress_documents(
+        self,
+        documents: Sequence[Document],
+        query: str,
+        callbacks: Optional[Callbacks] = None,
+    ) -> Sequence[Document]:
+        """Compress retrieved documents given the query context."""
+        for _transformer in self.transformers:
+            if isinstance(_transformer, BaseDocumentCompressor):
+                accepts_callbacks = (
+                    signature(_transformer.acompress_documents).parameters.get(
+                        "callbacks"
+                    )
+                    is not None
+                )
+                if accepts_callbacks:
+                    documents = await _transformer.acompress_documents(
+                        documents, query, callbacks=callbacks
+                    )
+                else:
+                    documents = await _transformer.acompress_documents(documents, query)
+            elif isinstance(_transformer, BaseDocumentTransformer):
+                documents = await _transformer.atransform_documents(documents)
+            else:
+                raise ValueError(f"Got unexpected transformer type: {_transformer}")
+        return documents
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/chain_extract.py b/llm/Lib/site-packages/langchain/retrievers/document_compressors/chain_extract.py
new file mode 100644
index 0000000000000000000000000000000000000000..6cfe45b22642261e4a9b62af50f45a7fde24eb30
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/document_compressors/chain_extract.py
@@ -0,0 +1,111 @@
+"""DocumentFilter that uses an LLM chain to extract the relevant parts of documents."""
+from __future__ import annotations
+
+import asyncio
+from typing import Any, Callable, Dict, Optional, Sequence, cast
+
+from langchain_core.documents import Document
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompts import PromptTemplate
+
+from langchain.callbacks.manager import Callbacks
+from langchain.chains.llm import LLMChain
+from langchain.retrievers.document_compressors.base import BaseDocumentCompressor
+from langchain.retrievers.document_compressors.chain_extract_prompt import (
+    prompt_template,
+)
+
+
+def default_get_input(query: str, doc: Document) -> Dict[str, Any]:
+    """Return the compression chain input."""
+    return {"question": query, "context": doc.page_content}
+
+
+class NoOutputParser(BaseOutputParser[str]):
+    """Parse outputs that could return a null string of some sort."""
+
+    no_output_str: str = "NO_OUTPUT"
+
+    def parse(self, text: str) -> str:
+        cleaned_text = text.strip()
+        if cleaned_text == self.no_output_str:
+            return ""
+        return cleaned_text
+
+
+def _get_default_chain_prompt() -> PromptTemplate:
+    output_parser = NoOutputParser()
+    template = prompt_template.format(no_output_str=output_parser.no_output_str)
+    return PromptTemplate(
+        template=template,
+        input_variables=["question", "context"],
+        output_parser=output_parser,
+    )
+
+
+class LLMChainExtractor(BaseDocumentCompressor):
+    """Document compressor that uses an LLM chain to extract
+    the relevant parts of documents."""
+
+    llm_chain: LLMChain
+    """LLM wrapper to use for compressing documents."""
+
+    get_input: Callable[[str, Document], dict] = default_get_input
+    """Callable for constructing the chain input from the query and a Document."""
+
+    def compress_documents(
+        self,
+        documents: Sequence[Document],
+        query: str,
+        callbacks: Optional[Callbacks] = None,
+    ) -> Sequence[Document]:
+        """Compress page content of raw documents."""
+        compressed_docs = []
+        for doc in documents:
+            _input = self.get_input(query, doc)
+            output = self.llm_chain.predict_and_parse(**_input, callbacks=callbacks)
+            if len(output) == 0:
+                continue
+            compressed_docs.append(
+                Document(page_content=cast(str, output), metadata=doc.metadata)
+            )
+        return compressed_docs
+
+    async def acompress_documents(
+        self,
+        documents: Sequence[Document],
+        query: str,
+        callbacks: Optional[Callbacks] = None,
+    ) -> Sequence[Document]:
+        """Compress page content of raw documents asynchronously."""
+        outputs = await asyncio.gather(
+            *[
+                self.llm_chain.apredict_and_parse(
+                    **self.get_input(query, doc), callbacks=callbacks
+                )
+                for doc in documents
+            ]
+        )
+        compressed_docs = []
+        for i, doc in enumerate(documents):
+            if len(outputs[i]) == 0:
+                continue
+            compressed_docs.append(
+                Document(page_content=outputs[i], metadata=doc.metadata)  # type: ignore[arg-type]
+            )
+        return compressed_docs
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        prompt: Optional[PromptTemplate] = None,
+        get_input: Optional[Callable[[str, Document], str]] = None,
+        llm_chain_kwargs: Optional[dict] = None,
+    ) -> LLMChainExtractor:
+        """Initialize from LLM."""
+        _prompt = prompt if prompt is not None else _get_default_chain_prompt()
+        _get_input = get_input if get_input is not None else default_get_input
+        llm_chain = LLMChain(llm=llm, prompt=_prompt, **(llm_chain_kwargs or {}))
+        return cls(llm_chain=llm_chain, get_input=_get_input)  # type: ignore[arg-type]
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/chain_extract_prompt.py b/llm/Lib/site-packages/langchain/retrievers/document_compressors/chain_extract_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..c27b8770cb4b0229fce1d0e3f30947ff898e6880
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/document_compressors/chain_extract_prompt.py
@@ -0,0 +1,11 @@
+# flake8: noqa
+prompt_template = """Given the following question and context, extract any part of the context *AS IS* that is relevant to answer the question. If none of the context is relevant return {no_output_str}. 
+
+Remember, *DO NOT* edit the extracted parts of the context.
+
+> Question: {{question}}
+> Context:
+>>>
+{{context}}
+>>>
+Extracted relevant parts:"""
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/chain_filter.py b/llm/Lib/site-packages/langchain/retrievers/document_compressors/chain_filter.py
new file mode 100644
index 0000000000000000000000000000000000000000..5278065ee298b1430af30a22ff3d7a996511cd22
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/document_compressors/chain_filter.py
@@ -0,0 +1,76 @@
+"""Filter that uses an LLM to drop documents that aren't relevant to the query."""
+from typing import Any, Callable, Dict, Optional, Sequence
+
+from langchain_core.documents import Document
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate, PromptTemplate
+
+from langchain.callbacks.manager import Callbacks
+from langchain.chains import LLMChain
+from langchain.output_parsers.boolean import BooleanOutputParser
+from langchain.retrievers.document_compressors.base import BaseDocumentCompressor
+from langchain.retrievers.document_compressors.chain_filter_prompt import (
+    prompt_template,
+)
+
+
+def _get_default_chain_prompt() -> PromptTemplate:
+    return PromptTemplate(
+        template=prompt_template,
+        input_variables=["question", "context"],
+        output_parser=BooleanOutputParser(),
+    )
+
+
+def default_get_input(query: str, doc: Document) -> Dict[str, Any]:
+    """Return the compression chain input."""
+    return {"question": query, "context": doc.page_content}
+
+
+class LLMChainFilter(BaseDocumentCompressor):
+    """Filter that drops documents that aren't relevant to the query."""
+
+    llm_chain: LLMChain
+    """LLM wrapper to use for filtering documents. 
+    The chain prompt is expected to have a BooleanOutputParser."""
+
+    get_input: Callable[[str, Document], dict] = default_get_input
+    """Callable for constructing the chain input from the query and a Document."""
+
+    def compress_documents(
+        self,
+        documents: Sequence[Document],
+        query: str,
+        callbacks: Optional[Callbacks] = None,
+    ) -> Sequence[Document]:
+        """Filter down documents based on their relevance to the query."""
+        filtered_docs = []
+        for doc in documents:
+            _input = self.get_input(query, doc)
+            include_doc = self.llm_chain.predict_and_parse(
+                **_input, callbacks=callbacks
+            )
+            if include_doc:
+                filtered_docs.append(doc)
+        return filtered_docs
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        prompt: Optional[BasePromptTemplate] = None,
+        **kwargs: Any,
+    ) -> "LLMChainFilter":
+        """Create a LLMChainFilter from a language model.
+
+        Args:
+            llm: The language model to use for filtering.
+            prompt: The prompt to use for the filter.
+            **kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            A LLMChainFilter that uses the given language model.
+        """
+        _prompt = prompt if prompt is not None else _get_default_chain_prompt()
+        llm_chain = LLMChain(llm=llm, prompt=_prompt)
+        return cls(llm_chain=llm_chain, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/chain_filter_prompt.py b/llm/Lib/site-packages/langchain/retrievers/document_compressors/chain_filter_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..5376dfa2a1859a95607f94a41234b5946efd2125
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/document_compressors/chain_filter_prompt.py
@@ -0,0 +1,9 @@
+# flake8: noqa
+prompt_template = """Given the following question and context, return YES if the context is relevant to the question and NO if it isn't.
+
+> Question: {question}
+> Context:
+>>>
+{context}
+>>>
+> Relevant (YES / NO):"""
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/cohere_rerank.py b/llm/Lib/site-packages/langchain/retrievers/document_compressors/cohere_rerank.py
new file mode 100644
index 0000000000000000000000000000000000000000..53c2ee423b3952f7b9e26d8622a83aea41cfcd6b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/document_compressors/cohere_rerank.py
@@ -0,0 +1,122 @@
+from __future__ import annotations
+
+from copy import deepcopy
+from typing import Any, Dict, List, Optional, Sequence, Union
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Extra, root_validator
+
+from langchain.callbacks.manager import Callbacks
+from langchain.retrievers.document_compressors.base import BaseDocumentCompressor
+from langchain.utils import get_from_dict_or_env
+
+
+@deprecated(
+    since="0.0.30", removal="0.2.0", alternative_import="langchain_cohere.CohereRerank"
+)
+class CohereRerank(BaseDocumentCompressor):
+    """Document compressor that uses `Cohere Rerank API`."""
+
+    client: Any = None
+    """Cohere client to use for compressing documents."""
+    top_n: Optional[int] = 3
+    """Number of documents to return."""
+    model: str = "rerank-english-v2.0"
+    """Model to use for reranking."""
+    cohere_api_key: Optional[str] = None
+    """Cohere API key. Must be specified directly or via environment variable 
+        COHERE_API_KEY."""
+    user_agent: str = "langchain"
+    """Identifier for the application making the request."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        if not values.get("client"):
+            try:
+                import cohere
+            except ImportError:
+                raise ImportError(
+                    "Could not import cohere python package. "
+                    "Please install it with `pip install cohere`."
+                )
+            cohere_api_key = get_from_dict_or_env(
+                values, "cohere_api_key", "COHERE_API_KEY"
+            )
+            client_name = values.get("user_agent", "langchain")
+            values["client"] = cohere.Client(cohere_api_key, client_name=client_name)
+        return values
+
+    def rerank(
+        self,
+        documents: Sequence[Union[str, Document, dict]],
+        query: str,
+        *,
+        model: Optional[str] = None,
+        top_n: Optional[int] = -1,
+        max_chunks_per_doc: Optional[int] = None,
+    ) -> List[Dict[str, Any]]:
+        """Returns an ordered list of documents ordered by their relevance to the provided query.
+
+        Args:
+            query: The query to use for reranking.
+            documents: A sequence of documents to rerank.
+            model: The model to use for re-ranking. Default to self.model.
+            top_n : The number of results to return. If None returns all results.
+                Defaults to self.top_n.
+            max_chunks_per_doc : The maximum number of chunks derived from a document.
+        """  # noqa: E501
+        if len(documents) == 0:  # to avoid empty api call
+            return []
+        docs = [
+            doc.page_content if isinstance(doc, Document) else doc for doc in documents
+        ]
+        model = model or self.model
+        top_n = top_n if (top_n is None or top_n > 0) else self.top_n
+        results = self.client.rerank(
+            query=query,
+            documents=docs,
+            model=model,
+            top_n=top_n,
+            max_chunks_per_doc=max_chunks_per_doc,
+        )
+        if hasattr(results, "results"):
+            results = getattr(results, "results")
+        result_dicts = []
+        for res in results:
+            result_dicts.append(
+                {"index": res.index, "relevance_score": res.relevance_score}
+            )
+        return result_dicts
+
+    def compress_documents(
+        self,
+        documents: Sequence[Document],
+        query: str,
+        callbacks: Optional[Callbacks] = None,
+    ) -> Sequence[Document]:
+        """
+        Compress documents using Cohere's rerank API.
+
+        Args:
+            documents: A sequence of documents to compress.
+            query: The query to use for compressing the documents.
+            callbacks: Callbacks to run during the compression process.
+
+        Returns:
+            A sequence of compressed documents.
+        """
+        compressed = []
+        for res in self.rerank(documents, query):
+            doc = documents[res["index"]]
+            doc_copy = Document(doc.page_content, metadata=deepcopy(doc.metadata))
+            doc_copy.metadata["relevance_score"] = res["relevance_score"]
+            compressed.append(doc_copy)
+        return compressed
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/cross_encoder_rerank.py b/llm/Lib/site-packages/langchain/retrievers/document_compressors/cross_encoder_rerank.py
new file mode 100644
index 0000000000000000000000000000000000000000..e4047fc0723d9b19f522d42ac10cb21d3848400f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/document_compressors/cross_encoder_rerank.py
@@ -0,0 +1,47 @@
+from __future__ import annotations
+
+import operator
+from typing import Optional, Sequence
+
+from langchain_community.cross_encoders import BaseCrossEncoder
+from langchain_core.callbacks import Callbacks
+from langchain_core.documents import BaseDocumentCompressor, Document
+from langchain_core.pydantic_v1 import Extra
+
+
+class CrossEncoderReranker(BaseDocumentCompressor):
+    """Document compressor that uses CrossEncoder for reranking."""
+
+    model: BaseCrossEncoder
+    """CrossEncoder model to use for scoring similarity
+      between the query and documents."""
+    top_n: int = 3
+    """Number of documents to return."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    def compress_documents(
+        self,
+        documents: Sequence[Document],
+        query: str,
+        callbacks: Optional[Callbacks] = None,
+    ) -> Sequence[Document]:
+        """
+        Rerank documents using CrossEncoder.
+
+        Args:
+            documents: A sequence of documents to compress.
+            query: The query to use for compressing the documents.
+            callbacks: Callbacks to run during the compression process.
+
+        Returns:
+            A sequence of compressed documents.
+        """
+        scores = self.model.score([(query, doc.page_content) for doc in documents])
+        docs_with_scores = list(zip(documents, scores))
+        result = sorted(docs_with_scores, key=operator.itemgetter(1), reverse=True)
+        return [doc for doc, _ in result[: self.top_n]]
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/embeddings_filter.py b/llm/Lib/site-packages/langchain/retrievers/document_compressors/embeddings_filter.py
new file mode 100644
index 0000000000000000000000000000000000000000..eb8066a352276de35c3db3d343dbc2ad8344f77f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/document_compressors/embeddings_filter.py
@@ -0,0 +1,72 @@
+from typing import Callable, Dict, Optional, Sequence
+
+import numpy as np
+from langchain_community.document_transformers.embeddings_redundant_filter import (
+    _get_embeddings_from_stateful_docs,
+    get_stateful_documents,
+)
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import root_validator
+
+from langchain.callbacks.manager import Callbacks
+from langchain.retrievers.document_compressors.base import (
+    BaseDocumentCompressor,
+)
+from langchain.utils.math import cosine_similarity
+
+
+class EmbeddingsFilter(BaseDocumentCompressor):
+    """Document compressor that uses embeddings to drop documents
+    unrelated to the query."""
+
+    embeddings: Embeddings
+    """Embeddings to use for embedding document contents and queries."""
+    similarity_fn: Callable = cosine_similarity
+    """Similarity function for comparing documents. Function expected to take as input
+    two matrices (List[List[float]]) and return a matrix of scores where higher values
+    indicate greater similarity."""
+    k: Optional[int] = 20
+    """The number of relevant documents to return. Can be set to None, in which case
+    `similarity_threshold` must be specified. Defaults to 20."""
+    similarity_threshold: Optional[float]
+    """Threshold for determining when two documents are similar enough
+    to be considered redundant. Defaults to None, must be specified if `k` is set
+    to None."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @root_validator()
+    def validate_params(cls, values: Dict) -> Dict:
+        """Validate similarity parameters."""
+        if values["k"] is None and values["similarity_threshold"] is None:
+            raise ValueError("Must specify one of `k` or `similarity_threshold`.")
+        return values
+
+    def compress_documents(
+        self,
+        documents: Sequence[Document],
+        query: str,
+        callbacks: Optional[Callbacks] = None,
+    ) -> Sequence[Document]:
+        """Filter documents based on similarity of their embeddings to the query."""
+        stateful_documents = get_stateful_documents(documents)
+        embedded_documents = _get_embeddings_from_stateful_docs(
+            self.embeddings, stateful_documents
+        )
+        embedded_query = self.embeddings.embed_query(query)
+        similarity = self.similarity_fn([embedded_query], embedded_documents)[0]
+        included_idxs = np.arange(len(embedded_documents))
+        if self.k is not None:
+            included_idxs = np.argsort(similarity)[::-1][: self.k]
+        if self.similarity_threshold is not None:
+            similar_enough = np.where(
+                similarity[included_idxs] > self.similarity_threshold
+            )
+            included_idxs = included_idxs[similar_enough]
+        for i in included_idxs:
+            stateful_documents[i].state["query_similarity_score"] = similarity[i]
+        return [stateful_documents[i] for i in included_idxs]
diff --git a/llm/Lib/site-packages/langchain/retrievers/document_compressors/flashrank_rerank.py b/llm/Lib/site-packages/langchain/retrievers/document_compressors/flashrank_rerank.py
new file mode 100644
index 0000000000000000000000000000000000000000..a05fd8c6e1cd163ac3d8c05450d139bf968c09cf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/document_compressors/flashrank_rerank.py
@@ -0,0 +1,78 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Dict, Optional, Sequence
+
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Extra, root_validator
+
+from langchain.callbacks.manager import Callbacks
+from langchain.retrievers.document_compressors.base import BaseDocumentCompressor
+
+if TYPE_CHECKING:
+    from flashrank import Ranker, RerankRequest
+else:
+    # Avoid pydantic annotation issues when actually instantiating
+    # while keeping this import optional
+    try:
+        from flashrank import Ranker, RerankRequest
+    except ImportError:
+        pass
+
+DEFAULT_MODEL_NAME = "ms-marco-MultiBERT-L-12"
+
+
+class FlashrankRerank(BaseDocumentCompressor):
+    """Document compressor using Flashrank interface."""
+
+    client: Ranker
+    """Flashrank client to use for compressing documents"""
+    top_n: int = 3
+    """Number of documents to return."""
+    model: Optional[str] = None
+    """Model to use for reranking."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        try:
+            from flashrank import Ranker
+        except ImportError:
+            raise ImportError(
+                "Could not import flashrank python package. "
+                "Please install it with `pip install flashrank`."
+            )
+
+        values["model"] = values.get("model", DEFAULT_MODEL_NAME)
+        values["client"] = Ranker(model_name=values["model"])
+        return values
+
+    def compress_documents(
+        self,
+        documents: Sequence[Document],
+        query: str,
+        callbacks: Optional[Callbacks] = None,
+    ) -> Sequence[Document]:
+        passages = [
+            {"id": i, "text": doc.page_content, "meta": doc.metadata}
+            for i, doc in enumerate(documents)
+        ]
+
+        rerank_request = RerankRequest(query=query, passages=passages)
+        rerank_response = self.client.rerank(rerank_request)[: self.top_n]
+        final_results = []
+
+        for r in rerank_response:
+            metadata = r["meta"]
+            metadata["relevance_score"] = r["score"]
+            doc = Document(
+                page_content=r["text"],
+                metadata=metadata,
+            )
+            final_results.append(doc)
+        return final_results
diff --git a/llm/Lib/site-packages/langchain/retrievers/elastic_search_bm25.py b/llm/Lib/site-packages/langchain/retrievers/elastic_search_bm25.py
new file mode 100644
index 0000000000000000000000000000000000000000..649705438f4b910e2c2b21ad664a5e56168dc100
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/elastic_search_bm25.py
@@ -0,0 +1,5 @@
+from langchain_community.retrievers.elastic_search_bm25 import (
+    ElasticSearchBM25Retriever,
+)
+
+__all__ = ["ElasticSearchBM25Retriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/embedchain.py b/llm/Lib/site-packages/langchain/retrievers/embedchain.py
new file mode 100644
index 0000000000000000000000000000000000000000..92a718e4befa29ecbe8959616c252bbc1cce0b2d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/embedchain.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.embedchain import EmbedchainRetriever
+
+__all__ = ["EmbedchainRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/ensemble.py b/llm/Lib/site-packages/langchain/retrievers/ensemble.py
new file mode 100644
index 0000000000000000000000000000000000000000..937a5e5549b97e81e845fbf15c2be015d6ed8206
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/ensemble.py
@@ -0,0 +1,308 @@
+"""
+Ensemble retriever that ensemble the results of
+multiple retrievers by using weighted  Reciprocal Rank Fusion
+"""
+import asyncio
+from collections import defaultdict
+from collections.abc import Hashable
+from itertools import chain
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Optional,
+    TypeVar,
+    cast,
+)
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.load.dump import dumpd
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.retrievers import BaseRetriever, RetrieverLike
+from langchain_core.runnables import RunnableConfig
+from langchain_core.runnables.config import ensure_config, patch_config
+from langchain_core.runnables.utils import (
+    ConfigurableFieldSpec,
+    get_unique_config_specs,
+)
+
+T = TypeVar("T")
+H = TypeVar("H", bound=Hashable)
+
+
+def unique_by_key(iterable: Iterable[T], key: Callable[[T], H]) -> Iterator[T]:
+    seen = set()
+    for e in iterable:
+        if (k := key(e)) not in seen:
+            seen.add(k)
+            yield e
+
+
+class EnsembleRetriever(BaseRetriever):
+    """Retriever that ensembles the multiple retrievers.
+
+    It uses a rank fusion.
+
+    Args:
+        retrievers: A list of retrievers to ensemble.
+        weights: A list of weights corresponding to the retrievers. Defaults to equal
+            weighting for all retrievers.
+        c: A constant added to the rank, controlling the balance between the importance
+            of high-ranked items and the consideration given to lower-ranked items.
+            Default is 60.
+    """
+
+    retrievers: List[RetrieverLike]
+    weights: List[float]
+    c: int = 60
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        """List configurable fields for this runnable."""
+        return get_unique_config_specs(
+            spec for retriever in self.retrievers for spec in retriever.config_specs
+        )
+
+    @root_validator(pre=True)
+    def set_weights(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        if not values.get("weights"):
+            n_retrievers = len(values["retrievers"])
+            values["weights"] = [1 / n_retrievers] * n_retrievers
+        return values
+
+    def invoke(
+        self, input: str, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> List[Document]:
+        from langchain_core.callbacks import CallbackManager
+
+        config = ensure_config(config)
+        callback_manager = CallbackManager.configure(
+            config.get("callbacks"),
+            None,
+            verbose=kwargs.get("verbose", False),
+            inheritable_tags=config.get("tags", []),
+            local_tags=self.tags,
+            inheritable_metadata=config.get("metadata", {}),
+            local_metadata=self.metadata,
+        )
+        run_manager = callback_manager.on_retriever_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name"),
+            **kwargs,
+        )
+        try:
+            result = self.rank_fusion(input, run_manager=run_manager, config=config)
+        except Exception as e:
+            run_manager.on_retriever_error(e)
+            raise e
+        else:
+            run_manager.on_retriever_end(
+                result,
+                **kwargs,
+            )
+            return result
+
+    async def ainvoke(
+        self, input: str, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> List[Document]:
+        from langchain_core.callbacks import AsyncCallbackManager
+
+        config = ensure_config(config)
+        callback_manager = AsyncCallbackManager.configure(
+            config.get("callbacks"),
+            None,
+            verbose=kwargs.get("verbose", False),
+            inheritable_tags=config.get("tags", []),
+            local_tags=self.tags,
+            inheritable_metadata=config.get("metadata", {}),
+            local_metadata=self.metadata,
+        )
+        run_manager = await callback_manager.on_retriever_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name"),
+            **kwargs,
+        )
+        try:
+            result = await self.arank_fusion(
+                input, run_manager=run_manager, config=config
+            )
+        except Exception as e:
+            await run_manager.on_retriever_error(e)
+            raise e
+        else:
+            await run_manager.on_retriever_end(
+                result,
+                **kwargs,
+            )
+            return result
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+    ) -> List[Document]:
+        """
+        Get the relevant documents for a given query.
+
+        Args:
+            query: The query to search for.
+
+        Returns:
+            A list of reranked documents.
+        """
+
+        # Get fused result of the retrievers.
+        fused_documents = self.rank_fusion(query, run_manager)
+
+        return fused_documents
+
+    async def _aget_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: AsyncCallbackManagerForRetrieverRun,
+    ) -> List[Document]:
+        """
+        Asynchronously get the relevant documents for a given query.
+
+        Args:
+            query: The query to search for.
+
+        Returns:
+            A list of reranked documents.
+        """
+
+        # Get fused result of the retrievers.
+        fused_documents = await self.arank_fusion(query, run_manager)
+
+        return fused_documents
+
+    def rank_fusion(
+        self,
+        query: str,
+        run_manager: CallbackManagerForRetrieverRun,
+        *,
+        config: Optional[RunnableConfig] = None,
+    ) -> List[Document]:
+        """
+        Retrieve the results of the retrievers and use rank_fusion_func to get
+        the final result.
+
+        Args:
+            query: The query to search for.
+
+        Returns:
+            A list of reranked documents.
+        """
+
+        # Get the results of all retrievers.
+        retriever_docs = [
+            retriever.invoke(
+                query,
+                patch_config(
+                    config, callbacks=run_manager.get_child(tag=f"retriever_{i+1}")
+                ),
+            )
+            for i, retriever in enumerate(self.retrievers)
+        ]
+
+        # Enforce that retrieved docs are Documents for each list in retriever_docs
+        for i in range(len(retriever_docs)):
+            retriever_docs[i] = [
+                Document(page_content=cast(str, doc)) if isinstance(doc, str) else doc
+                for doc in retriever_docs[i]
+            ]
+
+        # apply rank fusion
+        fused_documents = self.weighted_reciprocal_rank(retriever_docs)
+
+        return fused_documents
+
+    async def arank_fusion(
+        self,
+        query: str,
+        run_manager: AsyncCallbackManagerForRetrieverRun,
+        *,
+        config: Optional[RunnableConfig] = None,
+    ) -> List[Document]:
+        """
+        Asynchronously retrieve the results of the retrievers
+        and use rank_fusion_func to get the final result.
+
+        Args:
+            query: The query to search for.
+
+        Returns:
+            A list of reranked documents.
+        """
+
+        # Get the results of all retrievers.
+        retriever_docs = await asyncio.gather(
+            *[
+                retriever.ainvoke(
+                    query,
+                    patch_config(
+                        config, callbacks=run_manager.get_child(tag=f"retriever_{i+1}")
+                    ),
+                )
+                for i, retriever in enumerate(self.retrievers)
+            ]
+        )
+
+        # Enforce that retrieved docs are Documents for each list in retriever_docs
+        for i in range(len(retriever_docs)):
+            retriever_docs[i] = [
+                Document(page_content=doc) if not isinstance(doc, Document) else doc  # type: ignore[arg-type]
+                for doc in retriever_docs[i]
+            ]
+
+        # apply rank fusion
+        fused_documents = self.weighted_reciprocal_rank(retriever_docs)
+
+        return fused_documents
+
+    def weighted_reciprocal_rank(
+        self, doc_lists: List[List[Document]]
+    ) -> List[Document]:
+        """
+        Perform weighted Reciprocal Rank Fusion on multiple rank lists.
+        You can find more details about RRF here:
+        https://plg.uwaterloo.ca/~gvcormac/cormacksigir09-rrf.pdf
+
+        Args:
+            doc_lists: A list of rank lists, where each rank list contains unique items.
+
+        Returns:
+            list: The final aggregated list of items sorted by their weighted RRF
+                    scores in descending order.
+        """
+        if len(doc_lists) != len(self.weights):
+            raise ValueError(
+                "Number of rank lists must be equal to the number of weights."
+            )
+
+        # Associate each doc's content with its RRF score for later sorting by it
+        # Duplicated contents across retrievers are collapsed & scored cumulatively
+        rrf_score: Dict[str, float] = defaultdict(float)
+        for doc_list, weight in zip(doc_lists, self.weights):
+            for rank, doc in enumerate(doc_list, start=1):
+                rrf_score[doc.page_content] += weight / (rank + self.c)
+
+        # Docs are deduplicated by their contents then sorted by their scores
+        all_docs = chain.from_iterable(doc_lists)
+        sorted_docs = sorted(
+            unique_by_key(all_docs, lambda doc: doc.page_content),
+            reverse=True,
+            key=lambda doc: rrf_score[doc.page_content],
+        )
+        return sorted_docs
diff --git a/llm/Lib/site-packages/langchain/retrievers/google_cloud_documentai_warehouse.py b/llm/Lib/site-packages/langchain/retrievers/google_cloud_documentai_warehouse.py
new file mode 100644
index 0000000000000000000000000000000000000000..6dc2079f3aad9b872cecfbf8facad238b888b9b2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/google_cloud_documentai_warehouse.py
@@ -0,0 +1,5 @@
+from langchain_community.retrievers.google_cloud_documentai_warehouse import (
+    GoogleDocumentAIWarehouseRetriever,
+)
+
+__all__ = ["GoogleDocumentAIWarehouseRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/google_vertex_ai_search.py b/llm/Lib/site-packages/langchain/retrievers/google_vertex_ai_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..ffda6696fb1e03abce95141e68312bcd26572326
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/google_vertex_ai_search.py
@@ -0,0 +1,11 @@
+from langchain_community.retrievers.google_vertex_ai_search import (
+    GoogleCloudEnterpriseSearchRetriever,
+    GoogleVertexAIMultiTurnSearchRetriever,
+    GoogleVertexAISearchRetriever,
+)
+
+__all__ = [
+    "GoogleVertexAISearchRetriever",
+    "GoogleVertexAIMultiTurnSearchRetriever",
+    "GoogleCloudEnterpriseSearchRetriever",
+]
diff --git a/llm/Lib/site-packages/langchain/retrievers/kay.py b/llm/Lib/site-packages/langchain/retrievers/kay.py
new file mode 100644
index 0000000000000000000000000000000000000000..70cb97be3d2b98fd26bdb1a0e940d95bc96e43af
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/kay.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.kay import KayAiRetriever
+
+__all__ = ["KayAiRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/kendra.py b/llm/Lib/site-packages/langchain/retrievers/kendra.py
new file mode 100644
index 0000000000000000000000000000000000000000..1adc2fd6bbe9b3a9485315aaf2d9449037bec819
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/kendra.py
@@ -0,0 +1,35 @@
+from langchain_community.retrievers.kendra import (
+    AdditionalResultAttribute,
+    AdditionalResultAttributeValue,
+    AmazonKendraRetriever,
+    DocumentAttribute,
+    DocumentAttributeValue,
+    DocumentAttributeValueType,
+    Highlight,
+    QueryResult,
+    QueryResultItem,
+    ResultItem,
+    RetrieveResult,
+    RetrieveResultItem,
+    TextWithHighLights,
+    clean_excerpt,
+    combined_text,
+)
+
+__all__ = [
+    "clean_excerpt",
+    "combined_text",
+    "DocumentAttributeValueType",
+    "Highlight",
+    "TextWithHighLights",
+    "AdditionalResultAttributeValue",
+    "AdditionalResultAttribute",
+    "DocumentAttributeValue",
+    "DocumentAttribute",
+    "ResultItem",
+    "QueryResultItem",
+    "RetrieveResultItem",
+    "QueryResult",
+    "RetrieveResult",
+    "AmazonKendraRetriever",
+]
diff --git a/llm/Lib/site-packages/langchain/retrievers/knn.py b/llm/Lib/site-packages/langchain/retrievers/knn.py
new file mode 100644
index 0000000000000000000000000000000000000000..7165eb9ca6cc62d5164b6d886aaad04d4361c3dd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/knn.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.knn import KNNRetriever
+
+__all__ = ["KNNRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/llama_index.py b/llm/Lib/site-packages/langchain/retrievers/llama_index.py
new file mode 100644
index 0000000000000000000000000000000000000000..939e81a9014a16af326de9a3407412e6722e4da5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/llama_index.py
@@ -0,0 +1,6 @@
+from langchain_community.retrievers.llama_index import (
+    LlamaIndexGraphRetriever,
+    LlamaIndexRetriever,
+)
+
+__all__ = ["LlamaIndexRetriever", "LlamaIndexGraphRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/merger_retriever.py b/llm/Lib/site-packages/langchain/retrievers/merger_retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..4979779c25486f15cd8b0ae626a4a4310ac165bf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/merger_retriever.py
@@ -0,0 +1,122 @@
+import asyncio
+from typing import List
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+
+class MergerRetriever(BaseRetriever):
+    """Retriever that merges the results of multiple retrievers."""
+
+    retrievers: List[BaseRetriever]
+    """A list of retrievers to merge."""
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+    ) -> List[Document]:
+        """
+        Get the relevant documents for a given query.
+
+        Args:
+            query: The query to search for.
+
+        Returns:
+            A list of relevant documents.
+        """
+
+        # Merge the results of the retrievers.
+        merged_documents = self.merge_documents(query, run_manager)
+
+        return merged_documents
+
+    async def _aget_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: AsyncCallbackManagerForRetrieverRun,
+    ) -> List[Document]:
+        """
+        Asynchronously get the relevant documents for a given query.
+
+        Args:
+            query: The query to search for.
+
+        Returns:
+            A list of relevant documents.
+        """
+
+        # Merge the results of the retrievers.
+        merged_documents = await self.amerge_documents(query, run_manager)
+
+        return merged_documents
+
+    def merge_documents(
+        self, query: str, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """
+        Merge the results of the retrievers.
+
+        Args:
+            query: The query to search for.
+
+        Returns:
+            A list of merged documents.
+        """
+
+        # Get the results of all retrievers.
+        retriever_docs = [
+            retriever.get_relevant_documents(
+                query, callbacks=run_manager.get_child("retriever_{}".format(i + 1))
+            )
+            for i, retriever in enumerate(self.retrievers)
+        ]
+
+        # Merge the results of the retrievers.
+        merged_documents = []
+        max_docs = max(map(len, retriever_docs), default=0)
+        for i in range(max_docs):
+            for retriever, doc in zip(self.retrievers, retriever_docs):
+                if i < len(doc):
+                    merged_documents.append(doc[i])
+
+        return merged_documents
+
+    async def amerge_documents(
+        self, query: str, run_manager: AsyncCallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """
+        Asynchronously merge the results of the retrievers.
+
+        Args:
+            query: The query to search for.
+
+        Returns:
+            A list of merged documents.
+        """
+
+        # Get the results of all retrievers.
+        retriever_docs = await asyncio.gather(
+            *(
+                retriever.aget_relevant_documents(
+                    query, callbacks=run_manager.get_child("retriever_{}".format(i + 1))
+                )
+                for i, retriever in enumerate(self.retrievers)
+            )
+        )
+
+        # Merge the results of the retrievers.
+        merged_documents = []
+        max_docs = max(map(len, retriever_docs), default=0)
+        for i in range(max_docs):
+            for retriever, doc in zip(self.retrievers, retriever_docs):
+                if i < len(doc):
+                    merged_documents.append(doc[i])
+
+        return merged_documents
diff --git a/llm/Lib/site-packages/langchain/retrievers/metal.py b/llm/Lib/site-packages/langchain/retrievers/metal.py
new file mode 100644
index 0000000000000000000000000000000000000000..a38f89e1772d0bc4e62fc53273ebc66e2e02728c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/metal.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.metal import MetalRetriever
+
+__all__ = ["MetalRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/milvus.py b/llm/Lib/site-packages/langchain/retrievers/milvus.py
new file mode 100644
index 0000000000000000000000000000000000000000..261b7e2a80d6c6d809776860a51dc2e73cd13bd5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/milvus.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.milvus import MilvusRetreiver, MilvusRetriever
+
+__all__ = ["MilvusRetriever", "MilvusRetreiver"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/multi_query.py b/llm/Lib/site-packages/langchain/retrievers/multi_query.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca7e731c51a6792a9f6670a4bfe41e6e8c57301f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/multi_query.py
@@ -0,0 +1,214 @@
+import asyncio
+import logging
+from typing import List, Optional, Sequence
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.retrievers import BaseRetriever
+
+from langchain.chains.llm import LLMChain
+
+logger = logging.getLogger(__name__)
+
+
+class LineListOutputParser(BaseOutputParser[List[str]]):
+    """Output parser for a list of lines."""
+
+    def parse(self, text: str) -> List[str]:
+        lines = text.strip().split("\n")
+        return lines
+
+
+# Default prompt
+DEFAULT_QUERY_PROMPT = PromptTemplate(
+    input_variables=["question"],
+    template="""You are an AI language model assistant. Your task is 
+    to generate 3 different versions of the given user 
+    question to retrieve relevant documents from a vector  database. 
+    By generating multiple perspectives on the user question, 
+    your goal is to help the user overcome some of the limitations 
+    of distance-based similarity search. Provide these alternative 
+    questions separated by newlines. Original question: {question}""",
+)
+
+
+def _unique_documents(documents: Sequence[Document]) -> List[Document]:
+    return [doc for i, doc in enumerate(documents) if doc not in documents[:i]]
+
+
+class MultiQueryRetriever(BaseRetriever):
+    """Given a query, use an LLM to write a set of queries.
+
+    Retrieve docs for each query. Return the unique union of all retrieved docs.
+    """
+
+    retriever: BaseRetriever
+    llm_chain: LLMChain
+    verbose: bool = True
+    parser_key: str = "lines"
+    """DEPRECATED. parser_key is no longer used and should not be specified."""
+    include_original: bool = False
+    """Whether to include the original query in the list of generated queries."""
+
+    @classmethod
+    def from_llm(
+        cls,
+        retriever: BaseRetriever,
+        llm: BaseLanguageModel,
+        prompt: PromptTemplate = DEFAULT_QUERY_PROMPT,
+        parser_key: Optional[str] = None,
+        include_original: bool = False,
+    ) -> "MultiQueryRetriever":
+        """Initialize from llm using default template.
+
+        Args:
+            retriever: retriever to query documents from
+            llm: llm for query generation using DEFAULT_QUERY_PROMPT
+            include_original: Whether to include the original query in the list of
+                generated queries.
+
+        Returns:
+            MultiQueryRetriever
+        """
+        output_parser = LineListOutputParser()
+        llm_chain = LLMChain(llm=llm, prompt=prompt, output_parser=output_parser)
+        return cls(
+            retriever=retriever,
+            llm_chain=llm_chain,
+            include_original=include_original,
+        )
+
+    async def _aget_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: AsyncCallbackManagerForRetrieverRun,
+    ) -> List[Document]:
+        """Get relevant documents given a user query.
+
+        Args:
+            question: user query
+
+        Returns:
+            Unique union of relevant documents from all generated queries
+        """
+        queries = await self.agenerate_queries(query, run_manager)
+        if self.include_original:
+            queries.append(query)
+        documents = await self.aretrieve_documents(queries, run_manager)
+        return self.unique_union(documents)
+
+    async def agenerate_queries(
+        self, question: str, run_manager: AsyncCallbackManagerForRetrieverRun
+    ) -> List[str]:
+        """Generate queries based upon user input.
+
+        Args:
+            question: user query
+
+        Returns:
+            List of LLM generated queries that are similar to the user input
+        """
+        response = await self.llm_chain.acall(
+            inputs={"question": question}, callbacks=run_manager.get_child()
+        )
+        lines = response["text"]
+        if self.verbose:
+            logger.info(f"Generated queries: {lines}")
+        return lines
+
+    async def aretrieve_documents(
+        self, queries: List[str], run_manager: AsyncCallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Run all LLM generated queries.
+
+        Args:
+            queries: query list
+
+        Returns:
+            List of retrieved Documents
+        """
+        document_lists = await asyncio.gather(
+            *(
+                self.retriever.aget_relevant_documents(
+                    query, callbacks=run_manager.get_child()
+                )
+                for query in queries
+            )
+        )
+        return [doc for docs in document_lists for doc in docs]
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+    ) -> List[Document]:
+        """Get relevant documents given a user query.
+
+        Args:
+            question: user query
+
+        Returns:
+            Unique union of relevant documents from all generated queries
+        """
+        queries = self.generate_queries(query, run_manager)
+        if self.include_original:
+            queries.append(query)
+        documents = self.retrieve_documents(queries, run_manager)
+        return self.unique_union(documents)
+
+    def generate_queries(
+        self, question: str, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[str]:
+        """Generate queries based upon user input.
+
+        Args:
+            question: user query
+
+        Returns:
+            List of LLM generated queries that are similar to the user input
+        """
+        response = self.llm_chain(
+            {"question": question}, callbacks=run_manager.get_child()
+        )
+        lines = response["text"]
+        if self.verbose:
+            logger.info(f"Generated queries: {lines}")
+        return lines
+
+    def retrieve_documents(
+        self, queries: List[str], run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Run all LLM generated queries.
+
+        Args:
+            queries: query list
+
+        Returns:
+            List of retrieved Documents
+        """
+        documents = []
+        for query in queries:
+            docs = self.retriever.get_relevant_documents(
+                query, callbacks=run_manager.get_child()
+            )
+            documents.extend(docs)
+        return documents
+
+    def unique_union(self, documents: List[Document]) -> List[Document]:
+        """Get unique Documents.
+
+        Args:
+            documents: List of retrieved Documents
+
+        Returns:
+            List of unique retrieved Documents
+        """
+        return _unique_documents(documents)
diff --git a/llm/Lib/site-packages/langchain/retrievers/multi_vector.py b/llm/Lib/site-packages/langchain/retrievers/multi_vector.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ac989914aeb555bed3f83629a5f1fdabe818662
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/multi_vector.py
@@ -0,0 +1,103 @@
+from enum import Enum
+from typing import Dict, List, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.stores import BaseStore, ByteStore
+from langchain_core.vectorstores import VectorStore
+
+from langchain.storage._lc_store import create_kv_docstore
+
+
+class SearchType(str, Enum):
+    """Enumerator of the types of search to perform."""
+
+    similarity = "similarity"
+    """Similarity search."""
+    mmr = "mmr"
+    """Maximal Marginal Relevance reranking of similarity search."""
+
+
+class MultiVectorRetriever(BaseRetriever):
+    """Retrieve from a set of multiple embeddings for the same document."""
+
+    vectorstore: VectorStore
+    """The underlying vectorstore to use to store small chunks
+    and their embedding vectors"""
+    byte_store: Optional[ByteStore] = None
+    """The lower-level backing storage layer for the parent documents"""
+    docstore: BaseStore[str, Document]
+    """The storage interface for the parent documents"""
+    id_key: str = "doc_id"
+    search_kwargs: dict = Field(default_factory=dict)
+    """Keyword arguments to pass to the search function."""
+    search_type: SearchType = SearchType.similarity
+    """Type of search to perform (similarity / mmr)"""
+
+    @root_validator(pre=True)
+    def shim_docstore(cls, values: Dict) -> Dict:
+        byte_store = values.get("byte_store")
+        docstore = values.get("docstore")
+        if byte_store is not None:
+            docstore = create_kv_docstore(byte_store)
+        elif docstore is None:
+            raise Exception("You must pass a `byte_store` parameter.")
+        values["docstore"] = docstore
+        return values
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Get documents relevant to a query.
+        Args:
+            query: String to find relevant documents for
+            run_manager: The callbacks handler to use
+        Returns:
+            List of relevant documents
+        """
+        if self.search_type == SearchType.mmr:
+            sub_docs = self.vectorstore.max_marginal_relevance_search(
+                query, **self.search_kwargs
+            )
+        else:
+            sub_docs = self.vectorstore.similarity_search(query, **self.search_kwargs)
+
+        # We do this to maintain the order of the ids that are returned
+        ids = []
+        for d in sub_docs:
+            if self.id_key in d.metadata and d.metadata[self.id_key] not in ids:
+                ids.append(d.metadata[self.id_key])
+        docs = self.docstore.mget(ids)
+        return [d for d in docs if d is not None]
+
+    async def _aget_relevant_documents(
+        self, query: str, *, run_manager: AsyncCallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Asynchronously get documents relevant to a query.
+        Args:
+            query: String to find relevant documents for
+            run_manager: The callbacks handler to use
+        Returns:
+            List of relevant documents
+        """
+        if self.search_type == SearchType.mmr:
+            sub_docs = await self.vectorstore.amax_marginal_relevance_search(
+                query, **self.search_kwargs
+            )
+        else:
+            sub_docs = await self.vectorstore.asimilarity_search(
+                query, **self.search_kwargs
+            )
+
+        # We do this to maintain the order of the ids that are returned
+        ids = []
+        for d in sub_docs:
+            if self.id_key in d.metadata and d.metadata[self.id_key] not in ids:
+                ids.append(d.metadata[self.id_key])
+        docs = await self.docstore.amget(ids)
+        return [d for d in docs if d is not None]
diff --git a/llm/Lib/site-packages/langchain/retrievers/outline.py b/llm/Lib/site-packages/langchain/retrievers/outline.py
new file mode 100644
index 0000000000000000000000000000000000000000..efcd9e6ad618612486d9f19c4b8d285d7f2aca86
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/outline.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.outline import OutlineRetriever
+
+__all__ = ["OutlineRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/parent_document_retriever.py b/llm/Lib/site-packages/langchain/retrievers/parent_document_retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..3c8ac83e7a1dc341213556fe12e9e85607a8ae28
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/parent_document_retriever.py
@@ -0,0 +1,124 @@
+import uuid
+from typing import List, Optional, Sequence
+
+from langchain_core.documents import Document
+from langchain_text_splitters import TextSplitter
+
+from langchain.retrievers import MultiVectorRetriever
+
+
+class ParentDocumentRetriever(MultiVectorRetriever):
+    """Retrieve small chunks then retrieve their parent documents.
+
+    When splitting documents for retrieval, there are often conflicting desires:
+
+    1. You may want to have small documents, so that their embeddings can most
+        accurately reflect their meaning. If too long, then the embeddings can
+        lose meaning.
+    2. You want to have long enough documents that the context of each chunk is
+        retained.
+
+    The ParentDocumentRetriever strikes that balance by splitting and storing
+    small chunks of data. During retrieval, it first fetches the small chunks
+    but then looks up the parent ids for those chunks and returns those larger
+    documents.
+
+    Note that "parent document" refers to the document that a small chunk
+    originated from. This can either be the whole raw document OR a larger
+    chunk.
+
+    Examples:
+
+        .. code-block:: python
+
+            from langchain_community.embeddings import OpenAIEmbeddings
+            from langchain_community.vectorstores import Chroma
+            from langchain_text_splitters import RecursiveCharacterTextSplitter
+            from langchain.storage import InMemoryStore
+
+            # This text splitter is used to create the parent documents
+            parent_splitter = RecursiveCharacterTextSplitter(chunk_size=2000, add_start_index=True)
+            # This text splitter is used to create the child documents
+            # It should create documents smaller than the parent
+            child_splitter = RecursiveCharacterTextSplitter(chunk_size=400, add_start_index=True)
+            # The vectorstore to use to index the child chunks
+            vectorstore = Chroma(embedding_function=OpenAIEmbeddings())
+            # The storage layer for the parent documents
+            store = InMemoryStore()
+
+            # Initialize the retriever
+            retriever = ParentDocumentRetriever(
+                vectorstore=vectorstore,
+                docstore=store,
+                child_splitter=child_splitter,
+                parent_splitter=parent_splitter,
+            )
+    """  # noqa: E501
+
+    child_splitter: TextSplitter
+    """The text splitter to use to create child documents."""
+
+    """The key to use to track the parent id. This will be stored in the
+    metadata of child documents."""
+    parent_splitter: Optional[TextSplitter] = None
+    """The text splitter to use to create parent documents.
+    If none, then the parent documents will be the raw documents passed in."""
+
+    child_metadata_fields: Optional[Sequence[str]] = None
+    """Metadata fields to leave in child documents. If None, leave all parent document 
+        metadata.
+    """
+
+    def add_documents(
+        self,
+        documents: List[Document],
+        ids: Optional[List[str]] = None,
+        add_to_docstore: bool = True,
+    ) -> None:
+        """Adds documents to the docstore and vectorstores.
+
+        Args:
+            documents: List of documents to add
+            ids: Optional list of ids for documents. If provided should be the same
+                length as the list of documents. Can be provided if parent documents
+                are already in the document store and you don't want to re-add
+                to the docstore. If not provided, random UUIDs will be used as
+                ids.
+            add_to_docstore: Boolean of whether to add documents to docstore.
+                This can be false if and only if `ids` are provided. You may want
+                to set this to False if the documents are already in the docstore
+                and you don't want to re-add them.
+        """
+        if self.parent_splitter is not None:
+            documents = self.parent_splitter.split_documents(documents)
+        if ids is None:
+            doc_ids = [str(uuid.uuid4()) for _ in documents]
+            if not add_to_docstore:
+                raise ValueError(
+                    "If ids are not passed in, `add_to_docstore` MUST be True"
+                )
+        else:
+            if len(documents) != len(ids):
+                raise ValueError(
+                    "Got uneven list of documents and ids. "
+                    "If `ids` is provided, should be same length as `documents`."
+                )
+            doc_ids = ids
+
+        docs = []
+        full_docs = []
+        for i, doc in enumerate(documents):
+            _id = doc_ids[i]
+            sub_docs = self.child_splitter.split_documents([doc])
+            if self.child_metadata_fields is not None:
+                for _doc in sub_docs:
+                    _doc.metadata = {
+                        k: _doc.metadata[k] for k in self.child_metadata_fields
+                    }
+            for _doc in sub_docs:
+                _doc.metadata[self.id_key] = _id
+            docs.extend(sub_docs)
+            full_docs.append((_id, doc))
+        self.vectorstore.add_documents(docs)
+        if add_to_docstore:
+            self.docstore.mset(full_docs)
diff --git a/llm/Lib/site-packages/langchain/retrievers/pinecone_hybrid_search.py b/llm/Lib/site-packages/langchain/retrievers/pinecone_hybrid_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd1fa64ee4fd67b0d919018417567b642e88b5ae
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/pinecone_hybrid_search.py
@@ -0,0 +1,5 @@
+from langchain_community.retrievers.pinecone_hybrid_search import (
+    PineconeHybridSearchRetriever,
+)
+
+__all__ = ["PineconeHybridSearchRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/pubmed.py b/llm/Lib/site-packages/langchain/retrievers/pubmed.py
new file mode 100644
index 0000000000000000000000000000000000000000..7fed1277fa2f2af613f50b14eea9eca6d1514dbc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/pubmed.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.pubmed import PubMedRetriever
+
+__all__ = ["PubMedRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/pupmed.py b/llm/Lib/site-packages/langchain/retrievers/pupmed.py
new file mode 100644
index 0000000000000000000000000000000000000000..3104dac6f477967139c65b29c272ac2f7b22fc12
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/pupmed.py
@@ -0,0 +1,5 @@
+from langchain.retrievers.pubmed import PubMedRetriever
+
+__all__ = [
+    "PubMedRetriever",
+]
diff --git a/llm/Lib/site-packages/langchain/retrievers/re_phraser.py b/llm/Lib/site-packages/langchain/retrievers/re_phraser.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ffdd45e3eea961d2e174fead42a874f0eff7b40
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/re_phraser.py
@@ -0,0 +1,88 @@
+import logging
+from typing import List
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.language_models import BaseLLM
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.retrievers import BaseRetriever
+
+from langchain.chains.llm import LLMChain
+
+logger = logging.getLogger(__name__)
+
+# Default template
+DEFAULT_TEMPLATE = """You are an assistant tasked with taking a natural language \
+query from a user and converting it into a query for a vectorstore. \
+In this process, you strip out information that is not relevant for \
+the retrieval task. Here is the user query: {question}"""
+
+# Default prompt
+DEFAULT_QUERY_PROMPT = PromptTemplate.from_template(DEFAULT_TEMPLATE)
+
+
+class RePhraseQueryRetriever(BaseRetriever):
+    """Given a query, use an LLM to re-phrase it.
+    Then, retrieve docs for the re-phrased query."""
+
+    retriever: BaseRetriever
+    llm_chain: LLMChain
+
+    @classmethod
+    def from_llm(
+        cls,
+        retriever: BaseRetriever,
+        llm: BaseLLM,
+        prompt: PromptTemplate = DEFAULT_QUERY_PROMPT,
+    ) -> "RePhraseQueryRetriever":
+        """Initialize from llm using default template.
+
+        The prompt used here expects a single input: `question`
+
+        Args:
+            retriever: retriever to query documents from
+            llm: llm for query generation using DEFAULT_QUERY_PROMPT
+            prompt: prompt template for query generation
+
+        Returns:
+            RePhraseQueryRetriever
+        """
+
+        llm_chain = LLMChain(llm=llm, prompt=prompt)
+        return cls(
+            retriever=retriever,
+            llm_chain=llm_chain,
+        )
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+    ) -> List[Document]:
+        """Get relevated documents given a user question.
+
+        Args:
+            query: user question
+
+        Returns:
+            Relevant documents for re-phrased question
+        """
+        response = self.llm_chain(query, callbacks=run_manager.get_child())
+        re_phrased_question = response["text"]
+        logger.info(f"Re-phrased question: {re_phrased_question}")
+        docs = self.retriever.get_relevant_documents(
+            re_phrased_question, callbacks=run_manager.get_child()
+        )
+        return docs
+
+    async def _aget_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: AsyncCallbackManagerForRetrieverRun,
+    ) -> List[Document]:
+        raise NotImplementedError
diff --git a/llm/Lib/site-packages/langchain/retrievers/remote_retriever.py b/llm/Lib/site-packages/langchain/retrievers/remote_retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..fcb60c9a3ad7dd0d58b00387d5b390a9b7c20cff
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/remote_retriever.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.remote_retriever import RemoteLangChainRetriever
+
+__all__ = ["RemoteLangChainRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__init__.py b/llm/Lib/site-packages/langchain/retrievers/self_query/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b4ad1fe527ba644334aa425f23b4d7f938d586b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/astradb.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/astradb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a162c62355ec3c856a0ae7141ac41143df025c60
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/astradb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..80b50be86c65ec94b3967cbdbe65e76898bfa1ec
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/chroma.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/chroma.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..833878db11b62bd66a15e6e3a13ae260a604bfb8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/chroma.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/dashvector.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/dashvector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f23775548a60c47351f253502b140df6d4bd64a4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/dashvector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/deeplake.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/deeplake.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c80136bc1e5d89d636c9edfc0eda3db7a11c71e8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/deeplake.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/dingo.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/dingo.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..60525dd67cc7cc35ebb2ae4c4d227bfdf6fcab2a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/dingo.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/elasticsearch.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/elasticsearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f32a431cbfabca01854c0a92d417a821e1618272
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/elasticsearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/milvus.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/milvus.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cad7e91b796b16c9e25362c4ef19557203fdec0a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/milvus.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/mongodb_atlas.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/mongodb_atlas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8303dc4899b02c4ae246917bd2cd5bbaf0c0edc3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/mongodb_atlas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/myscale.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/myscale.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5271a3f3812c85ba7c8b120879f5108e8b2342dd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/myscale.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/opensearch.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/opensearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6aa9489bbb516e8e0e39f62cc2fde029fa7450f4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/opensearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/pgvector.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/pgvector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f5791c1e8c06d7b972a3ca321db7cb6fd84852ec
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/pgvector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/pinecone.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/pinecone.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9273b7a6350ab132fbb0a93820ebca38a5994e42
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/pinecone.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/qdrant.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/qdrant.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..496af75374b1114bbfa5753e0285fcff2c0996eb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/qdrant.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/redis.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/redis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b029563fff9209161684d5535e631797588e2e85
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/redis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/supabase.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/supabase.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..65ca36bf193b991e9856f315332cfd891e6640b1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/supabase.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/tencentvectordb.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/tencentvectordb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5cbb2f52cd22d8d07b0e860e2d3d72f265512d2e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/tencentvectordb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/timescalevector.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/timescalevector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..645f4b11d3081792a6282ed5985cf8ff09978fe5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/timescalevector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/vectara.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/vectara.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1185ab94bff0edf9e9848731e2abcf267c46d3b3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/vectara.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/weaviate.cpython-311.pyc b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/weaviate.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..48c07b2c299f4292656c258dbeb26b2e135f7e29
Binary files /dev/null and b/llm/Lib/site-packages/langchain/retrievers/self_query/__pycache__/weaviate.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/astradb.py b/llm/Lib/site-packages/langchain/retrievers/self_query/astradb.py
new file mode 100644
index 0000000000000000000000000000000000000000..0b8d3ab800f7cdaf101ef50f9a065e49e5b25315
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/astradb.py
@@ -0,0 +1,70 @@
+"""Logic for converting internal query language to a valid AstraDB query."""
+from typing import Dict, Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+MULTIPLE_ARITY_COMPARATORS = [Comparator.IN, Comparator.NIN]
+
+
+class AstraDBTranslator(Visitor):
+    """Translate AstraDB internal query language elements to valid filters."""
+
+    """Subset of allowed logical comparators."""
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.NE,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.LT,
+        Comparator.LTE,
+        Comparator.IN,
+        Comparator.NIN,
+    ]
+
+    """Subset of allowed logical operators."""
+    allowed_operators = [Operator.AND, Operator.OR]
+
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        self._validate_func(func)
+        map_dict = {
+            Operator.AND: "$and",
+            Operator.OR: "$or",
+            Comparator.EQ: "$eq",
+            Comparator.NE: "$ne",
+            Comparator.GTE: "$gte",
+            Comparator.LTE: "$lte",
+            Comparator.LT: "$lt",
+            Comparator.GT: "$gt",
+            Comparator.IN: "$in",
+            Comparator.NIN: "$nin",
+        }
+        return map_dict[func]
+
+    def visit_operation(self, operation: Operation) -> Dict:
+        args = [arg.accept(self) for arg in operation.arguments]
+        return {self._format_func(operation.operator): args}
+
+    def visit_comparison(self, comparison: Comparison) -> Dict:
+        if comparison.comparator in MULTIPLE_ARITY_COMPARATORS and not isinstance(
+            comparison.value, list
+        ):
+            comparison.value = [comparison.value]
+
+        comparator = self._format_func(comparison.comparator)
+        return {comparison.attribute: {comparator: comparison.value}}
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"filter": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/base.py b/llm/Lib/site-packages/langchain/retrievers/self_query/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..974c80ec0eeb00352169c4812e64effd01e7abf4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/base.py
@@ -0,0 +1,278 @@
+"""Retriever that generates and executes structured queries over its own data source."""
+
+import logging
+from typing import Any, Dict, List, Optional, Sequence, Tuple, Type, Union
+
+from langchain_community.vectorstores import (
+    AstraDB,
+    Chroma,
+    DashVector,
+    DeepLake,
+    Dingo,
+    Milvus,
+    MongoDBAtlasVectorSearch,
+    MyScale,
+    OpenSearchVectorSearch,
+    PGVector,
+    Pinecone,
+    Qdrant,
+    Redis,
+    SupabaseVectorStore,
+    TencentVectorDB,
+    TimescaleVector,
+    Vectara,
+    Weaviate,
+)
+from langchain_community.vectorstores import (
+    ElasticsearchStore as ElasticsearchStoreCommunity,
+)
+from langchain_core.documents import Document
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.runnables import Runnable
+from langchain_core.vectorstores import VectorStore
+
+from langchain.callbacks.manager import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain.chains.query_constructor.base import load_query_constructor_runnable
+from langchain.chains.query_constructor.ir import StructuredQuery, Visitor
+from langchain.chains.query_constructor.schema import AttributeInfo
+from langchain.retrievers.self_query.astradb import AstraDBTranslator
+from langchain.retrievers.self_query.chroma import ChromaTranslator
+from langchain.retrievers.self_query.dashvector import DashvectorTranslator
+from langchain.retrievers.self_query.deeplake import DeepLakeTranslator
+from langchain.retrievers.self_query.dingo import DingoDBTranslator
+from langchain.retrievers.self_query.elasticsearch import ElasticsearchTranslator
+from langchain.retrievers.self_query.milvus import MilvusTranslator
+from langchain.retrievers.self_query.mongodb_atlas import MongoDBAtlasTranslator
+from langchain.retrievers.self_query.myscale import MyScaleTranslator
+from langchain.retrievers.self_query.opensearch import OpenSearchTranslator
+from langchain.retrievers.self_query.pgvector import PGVectorTranslator
+from langchain.retrievers.self_query.pinecone import PineconeTranslator
+from langchain.retrievers.self_query.qdrant import QdrantTranslator
+from langchain.retrievers.self_query.redis import RedisTranslator
+from langchain.retrievers.self_query.supabase import SupabaseVectorTranslator
+from langchain.retrievers.self_query.tencentvectordb import TencentVectorDBTranslator
+from langchain.retrievers.self_query.timescalevector import TimescaleVectorTranslator
+from langchain.retrievers.self_query.vectara import VectaraTranslator
+from langchain.retrievers.self_query.weaviate import WeaviateTranslator
+
+logger = logging.getLogger(__name__)
+QUERY_CONSTRUCTOR_RUN_NAME = "query_constructor"
+
+
+def _get_builtin_translator(vectorstore: VectorStore) -> Visitor:
+    """Get the translator class corresponding to the vector store class."""
+    BUILTIN_TRANSLATORS: Dict[Type[VectorStore], Type[Visitor]] = {
+        AstraDB: AstraDBTranslator,
+        PGVector: PGVectorTranslator,
+        Pinecone: PineconeTranslator,
+        Chroma: ChromaTranslator,
+        DashVector: DashvectorTranslator,
+        Dingo: DingoDBTranslator,
+        Weaviate: WeaviateTranslator,
+        Vectara: VectaraTranslator,
+        Qdrant: QdrantTranslator,
+        MyScale: MyScaleTranslator,
+        DeepLake: DeepLakeTranslator,
+        ElasticsearchStoreCommunity: ElasticsearchTranslator,
+        Milvus: MilvusTranslator,
+        SupabaseVectorStore: SupabaseVectorTranslator,
+        TimescaleVector: TimescaleVectorTranslator,
+        OpenSearchVectorSearch: OpenSearchTranslator,
+        MongoDBAtlasVectorSearch: MongoDBAtlasTranslator,
+    }
+
+    if isinstance(vectorstore, Qdrant):
+        return QdrantTranslator(metadata_key=vectorstore.metadata_payload_key)
+    elif isinstance(vectorstore, MyScale):
+        return MyScaleTranslator(metadata_key=vectorstore.metadata_column)
+    elif isinstance(vectorstore, Redis):
+        return RedisTranslator.from_vectorstore(vectorstore)
+    elif isinstance(vectorstore, TencentVectorDB):
+        fields = [
+            field.name for field in (vectorstore.meta_fields or []) if field.index
+        ]
+        return TencentVectorDBTranslator(fields)
+    elif vectorstore.__class__ in BUILTIN_TRANSLATORS:
+        return BUILTIN_TRANSLATORS[vectorstore.__class__]()
+    else:
+        try:
+            from langchain_astradb.vectorstores import AstraDBVectorStore
+
+            if isinstance(vectorstore, AstraDBVectorStore):
+                return AstraDBTranslator()
+        except ImportError:
+            pass
+
+        try:
+            from langchain_elasticsearch.vectorstores import ElasticsearchStore
+
+            if isinstance(vectorstore, ElasticsearchStore):
+                return ElasticsearchTranslator()
+        except ImportError:
+            pass
+
+        raise ValueError(
+            f"Self query retriever with Vector Store type {vectorstore.__class__}"
+            f" not supported."
+        )
+
+
+class SelfQueryRetriever(BaseRetriever):
+    """Retriever that uses a vector store and an LLM to generate
+    the vector store queries."""
+
+    vectorstore: VectorStore
+    """The underlying vector store from which documents will be retrieved."""
+    query_constructor: Runnable[dict, StructuredQuery] = Field(alias="llm_chain")
+    """The query constructor chain for generating the vector store queries.
+    
+    llm_chain is legacy name kept for backwards compatibility."""
+    search_type: str = "similarity"
+    """The search type to perform on the vector store."""
+    search_kwargs: dict = Field(default_factory=dict)
+    """Keyword arguments to pass in to the vector store search."""
+    structured_query_translator: Visitor
+    """Translator for turning internal query language into vectorstore search params."""
+    verbose: bool = False
+
+    use_original_query: bool = False
+    """Use original query instead of the revised new query from LLM"""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+        allow_population_by_field_name = True
+
+    @root_validator(pre=True)
+    def validate_translator(cls, values: Dict) -> Dict:
+        """Validate translator."""
+        if "structured_query_translator" not in values:
+            values["structured_query_translator"] = _get_builtin_translator(
+                values["vectorstore"]
+            )
+        return values
+
+    @property
+    def llm_chain(self) -> Runnable:
+        """llm_chain is legacy name kept for backwards compatibility."""
+        return self.query_constructor
+
+    def _prepare_query(
+        self, query: str, structured_query: StructuredQuery
+    ) -> Tuple[str, Dict[str, Any]]:
+        new_query, new_kwargs = self.structured_query_translator.visit_structured_query(
+            structured_query
+        )
+        if structured_query.limit is not None:
+            new_kwargs["k"] = structured_query.limit
+        if self.use_original_query:
+            new_query = query
+        search_kwargs = {**self.search_kwargs, **new_kwargs}
+        return new_query, search_kwargs
+
+    def _get_docs_with_query(
+        self, query: str, search_kwargs: Dict[str, Any]
+    ) -> List[Document]:
+        docs = self.vectorstore.search(query, self.search_type, **search_kwargs)
+        return docs
+
+    async def _aget_docs_with_query(
+        self, query: str, search_kwargs: Dict[str, Any]
+    ) -> List[Document]:
+        docs = await self.vectorstore.asearch(query, self.search_type, **search_kwargs)
+        return docs
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Get documents relevant for a query.
+
+        Args:
+            query: string to find relevant documents for
+
+        Returns:
+            List of relevant documents
+        """
+        structured_query = self.query_constructor.invoke(
+            {"query": query}, config={"callbacks": run_manager.get_child()}
+        )
+        if self.verbose:
+            logger.info(f"Generated Query: {structured_query}")
+        new_query, search_kwargs = self._prepare_query(query, structured_query)
+        docs = self._get_docs_with_query(new_query, search_kwargs)
+        return docs
+
+    async def _aget_relevant_documents(
+        self, query: str, *, run_manager: AsyncCallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Get documents relevant for a query.
+
+        Args:
+            query: string to find relevant documents for
+
+        Returns:
+            List of relevant documents
+        """
+        structured_query = await self.query_constructor.ainvoke(
+            {"query": query}, config={"callbacks": run_manager.get_child()}
+        )
+        if self.verbose:
+            logger.info(f"Generated Query: {structured_query}")
+        new_query, search_kwargs = self._prepare_query(query, structured_query)
+        docs = await self._aget_docs_with_query(new_query, search_kwargs)
+        return docs
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        vectorstore: VectorStore,
+        document_contents: str,
+        metadata_field_info: Sequence[Union[AttributeInfo, dict]],
+        structured_query_translator: Optional[Visitor] = None,
+        chain_kwargs: Optional[Dict] = None,
+        enable_limit: bool = False,
+        use_original_query: bool = False,
+        **kwargs: Any,
+    ) -> "SelfQueryRetriever":
+        if structured_query_translator is None:
+            structured_query_translator = _get_builtin_translator(vectorstore)
+        chain_kwargs = chain_kwargs or {}
+
+        if (
+            "allowed_comparators" not in chain_kwargs
+            and structured_query_translator.allowed_comparators is not None
+        ):
+            chain_kwargs[
+                "allowed_comparators"
+            ] = structured_query_translator.allowed_comparators
+        if (
+            "allowed_operators" not in chain_kwargs
+            and structured_query_translator.allowed_operators is not None
+        ):
+            chain_kwargs[
+                "allowed_operators"
+            ] = structured_query_translator.allowed_operators
+        query_constructor = load_query_constructor_runnable(
+            llm,
+            document_contents,
+            metadata_field_info,
+            enable_limit=enable_limit,
+            **chain_kwargs,
+        )
+        query_constructor = query_constructor.with_config(
+            run_name=QUERY_CONSTRUCTOR_RUN_NAME
+        )
+        return cls(  # type: ignore[call-arg]
+            query_constructor=query_constructor,
+            vectorstore=vectorstore,
+            use_original_query=use_original_query,
+            structured_query_translator=structured_query_translator,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/chroma.py b/llm/Lib/site-packages/langchain/retrievers/self_query/chroma.py
new file mode 100644
index 0000000000000000000000000000000000000000..8c9a79b12d35e8ad617cc5ab696f8415d337807d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/chroma.py
@@ -0,0 +1,50 @@
+from typing import Dict, Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+
+class ChromaTranslator(Visitor):
+    """Translate `Chroma` internal query language elements to valid filters."""
+
+    allowed_operators = [Operator.AND, Operator.OR]
+    """Subset of allowed logical operators."""
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.NE,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.LT,
+        Comparator.LTE,
+    ]
+    """Subset of allowed logical comparators."""
+
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        self._validate_func(func)
+        return f"${func.value}"
+
+    def visit_operation(self, operation: Operation) -> Dict:
+        args = [arg.accept(self) for arg in operation.arguments]
+        return {self._format_func(operation.operator): args}
+
+    def visit_comparison(self, comparison: Comparison) -> Dict:
+        return {
+            comparison.attribute: {
+                self._format_func(comparison.comparator): comparison.value
+            }
+        }
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"filter": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/dashvector.py b/llm/Lib/site-packages/langchain/retrievers/self_query/dashvector.py
new file mode 100644
index 0000000000000000000000000000000000000000..24ae50239adf8dae4673966d3cf3fa42942116c4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/dashvector.py
@@ -0,0 +1,64 @@
+"""Logic for converting internal query language to a valid DashVector query."""
+from typing import Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+
+class DashvectorTranslator(Visitor):
+    """Logic for converting internal query language elements to valid filters."""
+
+    allowed_operators = [Operator.AND, Operator.OR]
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.LT,
+        Comparator.LTE,
+        Comparator.LIKE,
+    ]
+
+    map_dict = {
+        Operator.AND: " AND ",
+        Operator.OR: " OR ",
+        Comparator.EQ: " = ",
+        Comparator.GT: " > ",
+        Comparator.GTE: " >= ",
+        Comparator.LT: " < ",
+        Comparator.LTE: " <= ",
+        Comparator.LIKE: " LIKE ",
+    }
+
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        self._validate_func(func)
+        return self.map_dict[func]
+
+    def visit_operation(self, operation: Operation) -> str:
+        args = [arg.accept(self) for arg in operation.arguments]
+        return self._format_func(operation.operator).join(args)
+
+    def visit_comparison(self, comparison: Comparison) -> str:
+        value = comparison.value
+        if isinstance(value, str):
+            if comparison.comparator == Comparator.LIKE:
+                value = f"'%{value}%'"
+            else:
+                value = f"'{value}'"
+        return (
+            f"{comparison.attribute}{self._format_func(comparison.comparator)}{value}"
+        )
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"filter": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/deeplake.py b/llm/Lib/site-packages/langchain/retrievers/self_query/deeplake.py
new file mode 100644
index 0000000000000000000000000000000000000000..030933b32e8b0b97a5888683d6af27076efbfa50
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/deeplake.py
@@ -0,0 +1,88 @@
+"""Logic for converting internal query language to a valid Chroma query."""
+from typing import Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+COMPARATOR_TO_TQL = {
+    Comparator.EQ: "==",
+    Comparator.GT: ">",
+    Comparator.GTE: ">=",
+    Comparator.LT: "<",
+    Comparator.LTE: "<=",
+}
+
+
+OPERATOR_TO_TQL = {
+    Operator.AND: "and",
+    Operator.OR: "or",
+    Operator.NOT: "NOT",
+}
+
+
+def can_cast_to_float(string: str) -> bool:
+    """Check if a string can be cast to a float."""
+    try:
+        float(string)
+        return True
+    except ValueError:
+        return False
+
+
+class DeepLakeTranslator(Visitor):
+    """Translate `DeepLake` internal query language elements to valid filters."""
+
+    allowed_operators = [Operator.AND, Operator.OR, Operator.NOT]
+    """Subset of allowed logical operators."""
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.LT,
+        Comparator.LTE,
+    ]
+    """Subset of allowed logical comparators."""
+
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        self._validate_func(func)
+        if isinstance(func, Operator):
+            value = OPERATOR_TO_TQL[func.value]  # type: ignore
+        elif isinstance(func, Comparator):
+            value = COMPARATOR_TO_TQL[func.value]  # type: ignore
+        return f"{value}"
+
+    def visit_operation(self, operation: Operation) -> str:
+        args = [arg.accept(self) for arg in operation.arguments]
+        operator = self._format_func(operation.operator)
+        return "(" + (" " + operator + " ").join(args) + ")"
+
+    def visit_comparison(self, comparison: Comparison) -> str:
+        comparator = self._format_func(comparison.comparator)
+        values = comparison.value
+        if isinstance(values, list):
+            tql = []
+            for value in values:
+                comparison.value = value
+                tql.append(self.visit_comparison(comparison))
+
+            return "(" + (" or ").join(tql) + ")"
+
+        if not can_cast_to_float(comparison.value):
+            values = f"'{values}'"
+        return f"metadata['{comparison.attribute}'] {comparator} {values}"
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            tqL = f"SELECT * WHERE {structured_query.filter.accept(self)}"
+            kwargs = {"tql": tqL}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/dingo.py b/llm/Lib/site-packages/langchain/retrievers/self_query/dingo.py
new file mode 100644
index 0000000000000000000000000000000000000000..76e9ef862d3ad480b5bc03b40b2b24ac20e11f6b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/dingo.py
@@ -0,0 +1,49 @@
+from typing import Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+
+class DingoDBTranslator(Visitor):
+    """Translate `DingoDB` internal query language elements to valid filters."""
+
+    allowed_comparators = (
+        Comparator.EQ,
+        Comparator.NE,
+        Comparator.LT,
+        Comparator.LTE,
+        Comparator.GT,
+        Comparator.GTE,
+    )
+    """Subset of allowed logical comparators."""
+    allowed_operators = (Operator.AND, Operator.OR)
+    """Subset of allowed logical operators."""
+
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        self._validate_func(func)
+        return f"${func.value}"
+
+    def visit_operation(self, operation: Operation) -> Operation:
+        return operation
+
+    def visit_comparison(self, comparison: Comparison) -> Comparison:
+        return comparison
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {
+                "search_params": {
+                    "langchain_expr": structured_query.filter.accept(self)
+                }
+            }
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/elasticsearch.py b/llm/Lib/site-packages/langchain/retrievers/self_query/elasticsearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..7c2f7671a5c9b4e2c6d05b52df46f6b6f8c7b6cd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/elasticsearch.py
@@ -0,0 +1,100 @@
+from typing import Dict, Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+
+class ElasticsearchTranslator(Visitor):
+    """Translate `Elasticsearch` internal query language elements to valid filters."""
+
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.LT,
+        Comparator.LTE,
+        Comparator.CONTAIN,
+        Comparator.LIKE,
+    ]
+    """Subset of allowed logical comparators."""
+
+    allowed_operators = [Operator.AND, Operator.OR, Operator.NOT]
+    """Subset of allowed logical operators."""
+
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        self._validate_func(func)
+        map_dict = {
+            Operator.OR: "should",
+            Operator.NOT: "must_not",
+            Operator.AND: "must",
+            Comparator.EQ: "term",
+            Comparator.GT: "gt",
+            Comparator.GTE: "gte",
+            Comparator.LT: "lt",
+            Comparator.LTE: "lte",
+            Comparator.CONTAIN: "match",
+            Comparator.LIKE: "match",
+        }
+        return map_dict[func]
+
+    def visit_operation(self, operation: Operation) -> Dict:
+        args = [arg.accept(self) for arg in operation.arguments]
+
+        return {"bool": {self._format_func(operation.operator): args}}
+
+    def visit_comparison(self, comparison: Comparison) -> Dict:
+        # ElasticsearchStore filters require to target
+        # the metadata object field
+        field = f"metadata.{comparison.attribute}"
+
+        is_range_comparator = comparison.comparator in [
+            Comparator.GT,
+            Comparator.GTE,
+            Comparator.LT,
+            Comparator.LTE,
+        ]
+
+        if is_range_comparator:
+            value = comparison.value
+            if isinstance(comparison.value, dict) and "date" in comparison.value:
+                value = comparison.value["date"]
+            return {"range": {field: {self._format_func(comparison.comparator): value}}}
+
+        if comparison.comparator == Comparator.CONTAIN:
+            return {
+                self._format_func(comparison.comparator): {
+                    field: {"query": comparison.value}
+                }
+            }
+
+        if comparison.comparator == Comparator.LIKE:
+            return {
+                self._format_func(comparison.comparator): {
+                    field: {"query": comparison.value, "fuzziness": "AUTO"}
+                }
+            }
+
+        # we assume that if the value is a string,
+        # we want to use the keyword field
+        field = f"{field}.keyword" if isinstance(comparison.value, str) else field
+
+        if isinstance(comparison.value, dict):
+            if "date" in comparison.value:
+                comparison.value = comparison.value["date"]
+
+        return {self._format_func(comparison.comparator): {field: comparison.value}}
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"filter": [structured_query.filter.accept(self)]}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/milvus.py b/llm/Lib/site-packages/langchain/retrievers/self_query/milvus.py
new file mode 100644
index 0000000000000000000000000000000000000000..dbc61f6f712038cc9ab1daf7b7a74f41907eea65
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/milvus.py
@@ -0,0 +1,103 @@
+"""Logic for converting internal query language to a valid Milvus query."""
+from typing import Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+COMPARATOR_TO_BER = {
+    Comparator.EQ: "==",
+    Comparator.GT: ">",
+    Comparator.GTE: ">=",
+    Comparator.LT: "<",
+    Comparator.LTE: "<=",
+    Comparator.IN: "in",
+    Comparator.LIKE: "like",
+}
+
+UNARY_OPERATORS = [Operator.NOT]
+
+
+def process_value(value: Union[int, float, str], comparator: Comparator) -> str:
+    """Convert a value to a string and add double quotes if it is a string.
+
+    It required for comparators involving strings.
+
+    Args:
+        value: The value to convert.
+        comparator: The comparator.
+
+    Returns:
+        The converted value as a string.
+    """
+    #
+    if isinstance(value, str):
+        if comparator is Comparator.LIKE:
+            # If the comparator is LIKE, add a percent sign after it for prefix matching
+            # and add double quotes
+            return f'"{value}%"'
+        else:
+            # If the value is already a string, add double quotes
+            return f'"{value}"'
+    else:
+        # If the value is not a string, convert it to a string without double quotes
+        return str(value)
+
+
+class MilvusTranslator(Visitor):
+    """Translate Milvus internal query language elements to valid filters."""
+
+    """Subset of allowed logical operators."""
+    allowed_operators = [Operator.AND, Operator.NOT, Operator.OR]
+
+    """Subset of allowed logical comparators."""
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.LT,
+        Comparator.LTE,
+        Comparator.IN,
+        Comparator.LIKE,
+    ]
+
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        self._validate_func(func)
+        value = func.value
+        if isinstance(func, Comparator):
+            value = COMPARATOR_TO_BER[func]
+        return f"{value}"
+
+    def visit_operation(self, operation: Operation) -> str:
+        if operation.operator in UNARY_OPERATORS and len(operation.arguments) == 1:
+            operator = self._format_func(operation.operator)
+            return operator + "(" + operation.arguments[0].accept(self) + ")"
+        elif operation.operator in UNARY_OPERATORS:
+            raise ValueError(
+                f'"{operation.operator.value}" can have only one argument in Milvus'
+            )
+        else:
+            args = [arg.accept(self) for arg in operation.arguments]
+            operator = self._format_func(operation.operator)
+            return "(" + (" " + operator + " ").join(args) + ")"
+
+    def visit_comparison(self, comparison: Comparison) -> str:
+        comparator = self._format_func(comparison.comparator)
+        processed_value = process_value(comparison.value, comparison.comparator)
+        attribute = comparison.attribute
+
+        return "( " + attribute + " " + comparator + " " + processed_value + " )"
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"expr": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/mongodb_atlas.py b/llm/Lib/site-packages/langchain/retrievers/self_query/mongodb_atlas.py
new file mode 100644
index 0000000000000000000000000000000000000000..a10e7b58fa9339601deea4b89a4a16d2d20f8a63
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/mongodb_atlas.py
@@ -0,0 +1,74 @@
+"""Logic for converting internal query language to a valid MongoDB Atlas query."""
+from typing import Dict, Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+MULTIPLE_ARITY_COMPARATORS = [Comparator.IN, Comparator.NIN]
+
+
+class MongoDBAtlasTranslator(Visitor):
+    """Translate Mongo internal query language elements to valid filters."""
+
+    """Subset of allowed logical comparators."""
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.NE,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.LT,
+        Comparator.LTE,
+        Comparator.IN,
+        Comparator.NIN,
+    ]
+
+    """Subset of allowed logical operators."""
+    allowed_operators = [Operator.AND, Operator.OR]
+
+    ## Convert a operator or a comparator to Mongo Query Format
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        self._validate_func(func)
+        map_dict = {
+            Operator.AND: "$and",
+            Operator.OR: "$or",
+            Comparator.EQ: "$eq",
+            Comparator.NE: "$ne",
+            Comparator.GTE: "$gte",
+            Comparator.LTE: "$lte",
+            Comparator.LT: "$lt",
+            Comparator.GT: "$gt",
+            Comparator.IN: "$in",
+            Comparator.NIN: "$nin",
+        }
+        return map_dict[func]
+
+    def visit_operation(self, operation: Operation) -> Dict:
+        args = [arg.accept(self) for arg in operation.arguments]
+        return {self._format_func(operation.operator): args}
+
+    def visit_comparison(self, comparison: Comparison) -> Dict:
+        if comparison.comparator in MULTIPLE_ARITY_COMPARATORS and not isinstance(
+            comparison.value, list
+        ):
+            comparison.value = [comparison.value]
+
+        comparator = self._format_func(comparison.comparator)
+
+        attribute = comparison.attribute
+
+        return {attribute: {comparator: comparison.value}}
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"pre_filter": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/myscale.py b/llm/Lib/site-packages/langchain/retrievers/self_query/myscale.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b1afaf8b9de6a717da6d8d563270f626db891bb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/myscale.py
@@ -0,0 +1,125 @@
+import re
+from typing import Any, Callable, Dict, Tuple
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+
+def _DEFAULT_COMPOSER(op_name: str) -> Callable:
+    """
+    Default composer for logical operators.
+
+    Args:
+        op_name: Name of the operator.
+
+    Returns:
+        Callable that takes a list of arguments and returns a string.
+    """
+
+    def f(*args: Any) -> str:
+        args_: map[str] = map(str, args)
+        return f" {op_name} ".join(args_)
+
+    return f
+
+
+def _FUNCTION_COMPOSER(op_name: str) -> Callable:
+    """
+    Composer for functions.
+
+    Args:
+        op_name: Name of the function.
+
+    Returns:
+        Callable that takes a list of arguments and returns a string.
+    """
+
+    def f(*args: Any) -> str:
+        args_: map[str] = map(str, args)
+        return f"{op_name}({','.join(args_)})"
+
+    return f
+
+
+class MyScaleTranslator(Visitor):
+    """Translate `MyScale` internal query language elements to valid filters."""
+
+    allowed_operators = [Operator.AND, Operator.OR, Operator.NOT]
+    """Subset of allowed logical operators."""
+
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.LT,
+        Comparator.LTE,
+        Comparator.CONTAIN,
+        Comparator.LIKE,
+    ]
+
+    map_dict = {
+        Operator.AND: _DEFAULT_COMPOSER("AND"),
+        Operator.OR: _DEFAULT_COMPOSER("OR"),
+        Operator.NOT: _DEFAULT_COMPOSER("NOT"),
+        Comparator.EQ: _DEFAULT_COMPOSER("="),
+        Comparator.GT: _DEFAULT_COMPOSER(">"),
+        Comparator.GTE: _DEFAULT_COMPOSER(">="),
+        Comparator.LT: _DEFAULT_COMPOSER("<"),
+        Comparator.LTE: _DEFAULT_COMPOSER("<="),
+        Comparator.CONTAIN: _FUNCTION_COMPOSER("has"),
+        Comparator.LIKE: _DEFAULT_COMPOSER("ILIKE"),
+    }
+
+    def __init__(self, metadata_key: str = "metadata") -> None:
+        super().__init__()
+        self.metadata_key = metadata_key
+
+    def visit_operation(self, operation: Operation) -> Dict:
+        args = [arg.accept(self) for arg in operation.arguments]
+        func = operation.operator
+        self._validate_func(func)
+        return self.map_dict[func](*args)
+
+    def visit_comparison(self, comparison: Comparison) -> Dict:
+        regex = r"\((.*?)\)"
+        matched = re.search(r"\(\w+\)", comparison.attribute)
+
+        # If arbitrary function is applied to an attribute
+        if matched:
+            attr = re.sub(
+                regex,
+                f"({self.metadata_key}.{matched.group(0)[1:-1]})",
+                comparison.attribute,
+            )
+        else:
+            attr = f"{self.metadata_key}.{comparison.attribute}"
+        value = comparison.value
+        comp = comparison.comparator
+
+        value = f"'{value}'" if isinstance(value, str) else value
+
+        # convert timestamp for datetime objects
+        if isinstance(value, dict) and value.get("type") == "date":
+            attr = f"parseDateTime32BestEffort({attr})"
+            value = f"parseDateTime32BestEffort('{value['date']}')"
+
+        # string pattern match
+        if comp is Comparator.LIKE:
+            value = f"'%{value[1:-1]}%'"
+        return self.map_dict[comp](attr, value)
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        print(structured_query)  # noqa: T201
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"where_str": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/opensearch.py b/llm/Lib/site-packages/langchain/retrievers/self_query/opensearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..bb27cddd0b481a2da26cbcc8214eada1291783ef
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/opensearch.py
@@ -0,0 +1,104 @@
+from typing import Dict, Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+
+class OpenSearchTranslator(Visitor):
+    """Translate `OpenSearch` internal query domain-specific
+    language elements to valid filters."""
+
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.LT,
+        Comparator.LTE,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.CONTAIN,
+        Comparator.LIKE,
+    ]
+    """Subset of allowed logical comparators."""
+
+    allowed_operators = [Operator.AND, Operator.OR, Operator.NOT]
+    """Subset of allowed logical operators."""
+
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        self._validate_func(func)
+        comp_operator_map = {
+            Comparator.EQ: "term",
+            Comparator.LT: "lt",
+            Comparator.LTE: "lte",
+            Comparator.GT: "gt",
+            Comparator.GTE: "gte",
+            Comparator.CONTAIN: "match",
+            Comparator.LIKE: "fuzzy",
+            Operator.AND: "must",
+            Operator.OR: "should",
+            Operator.NOT: "must_not",
+        }
+        return comp_operator_map[func]
+
+    def visit_operation(self, operation: Operation) -> Dict:
+        args = [arg.accept(self) for arg in operation.arguments]
+
+        return {"bool": {self._format_func(operation.operator): args}}
+
+    def visit_comparison(self, comparison: Comparison) -> Dict:
+        field = f"metadata.{comparison.attribute}"
+
+        if comparison.comparator in [
+            Comparator.LT,
+            Comparator.LTE,
+            Comparator.GT,
+            Comparator.GTE,
+        ]:
+            if isinstance(comparison.value, dict):
+                if "date" in comparison.value:
+                    return {
+                        "range": {
+                            field: {
+                                self._format_func(
+                                    comparison.comparator
+                                ): comparison.value["date"]
+                            }
+                        }
+                    }
+            else:
+                return {
+                    "range": {
+                        field: {
+                            self._format_func(comparison.comparator): comparison.value
+                        }
+                    }
+                }
+
+        if comparison.comparator == Comparator.LIKE:
+            return {
+                self._format_func(comparison.comparator): {
+                    field: {"value": comparison.value}
+                }
+            }
+
+        field = f"{field}.keyword" if isinstance(comparison.value, str) else field
+
+        if isinstance(comparison.value, dict):
+            if "date" in comparison.value:
+                comparison.value = comparison.value["date"]
+
+        return {self._format_func(comparison.comparator): {field: comparison.value}}
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"filter": structured_query.filter.accept(self)}
+
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/pgvector.py b/llm/Lib/site-packages/langchain/retrievers/self_query/pgvector.py
new file mode 100644
index 0000000000000000000000000000000000000000..ebe5bf42ffc430b774395bcf60e56c75b58da332
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/pgvector.py
@@ -0,0 +1,52 @@
+from typing import Dict, Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+
+class PGVectorTranslator(Visitor):
+    """Translate `PGVector` internal query language elements to valid filters."""
+
+    allowed_operators = [Operator.AND, Operator.OR]
+    """Subset of allowed logical operators."""
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.NE,
+        Comparator.GT,
+        Comparator.LT,
+        Comparator.IN,
+        Comparator.NIN,
+        Comparator.CONTAIN,
+        Comparator.LIKE,
+    ]
+    """Subset of allowed logical comparators."""
+
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        self._validate_func(func)
+        return f"{func.value}"
+
+    def visit_operation(self, operation: Operation) -> Dict:
+        args = [arg.accept(self) for arg in operation.arguments]
+        return {self._format_func(operation.operator): args}
+
+    def visit_comparison(self, comparison: Comparison) -> Dict:
+        return {
+            comparison.attribute: {
+                self._format_func(comparison.comparator): comparison.value
+            }
+        }
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"filter": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/pinecone.py b/llm/Lib/site-packages/langchain/retrievers/self_query/pinecone.py
new file mode 100644
index 0000000000000000000000000000000000000000..80c401dd95fe1e42b09b9a9b9424f2f8532c7996
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/pinecone.py
@@ -0,0 +1,57 @@
+from typing import Dict, Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+
+class PineconeTranslator(Visitor):
+    """Translate `Pinecone` internal query language elements to valid filters."""
+
+    allowed_comparators = (
+        Comparator.EQ,
+        Comparator.NE,
+        Comparator.LT,
+        Comparator.LTE,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.IN,
+        Comparator.NIN,
+    )
+    """Subset of allowed logical comparators."""
+    allowed_operators = (Operator.AND, Operator.OR)
+    """Subset of allowed logical operators."""
+
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        self._validate_func(func)
+        return f"${func.value}"
+
+    def visit_operation(self, operation: Operation) -> Dict:
+        args = [arg.accept(self) for arg in operation.arguments]
+        return {self._format_func(operation.operator): args}
+
+    def visit_comparison(self, comparison: Comparison) -> Dict:
+        if comparison.comparator in (Comparator.IN, Comparator.NIN) and not isinstance(
+            comparison.value, list
+        ):
+            comparison.value = [comparison.value]
+
+        return {
+            comparison.attribute: {
+                self._format_func(comparison.comparator): comparison.value
+            }
+        }
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"filter": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/qdrant.py b/llm/Lib/site-packages/langchain/retrievers/self_query/qdrant.py
new file mode 100644
index 0000000000000000000000000000000000000000..c99287751a15838b0e28425d4f3f2c45abc3332e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/qdrant.py
@@ -0,0 +1,98 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Tuple
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+if TYPE_CHECKING:
+    from qdrant_client.http import models as rest
+
+
+class QdrantTranslator(Visitor):
+    """Translate `Qdrant` internal query language elements to valid filters."""
+
+    allowed_operators = (
+        Operator.AND,
+        Operator.OR,
+        Operator.NOT,
+    )
+    """Subset of allowed logical operators."""
+
+    allowed_comparators = (
+        Comparator.EQ,
+        Comparator.LT,
+        Comparator.LTE,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.LIKE,
+    )
+    """Subset of allowed logical comparators."""
+
+    def __init__(self, metadata_key: str):
+        self.metadata_key = metadata_key
+
+    def visit_operation(self, operation: Operation) -> rest.Filter:
+        try:
+            from qdrant_client.http import models as rest
+        except ImportError as e:
+            raise ImportError(
+                "Cannot import qdrant_client. Please install with `pip install "
+                "qdrant-client`."
+            ) from e
+
+        args = [arg.accept(self) for arg in operation.arguments]
+        operator = {
+            Operator.AND: "must",
+            Operator.OR: "should",
+            Operator.NOT: "must_not",
+        }[operation.operator]
+        return rest.Filter(**{operator: args})
+
+    def visit_comparison(self, comparison: Comparison) -> rest.FieldCondition:
+        try:
+            from qdrant_client.http import models as rest
+        except ImportError as e:
+            raise ImportError(
+                "Cannot import qdrant_client. Please install with `pip install "
+                "qdrant-client`."
+            ) from e
+
+        self._validate_func(comparison.comparator)
+        attribute = self.metadata_key + "." + comparison.attribute
+        if comparison.comparator == Comparator.EQ:
+            return rest.FieldCondition(
+                key=attribute, match=rest.MatchValue(value=comparison.value)
+            )
+        if comparison.comparator == Comparator.LIKE:
+            return rest.FieldCondition(
+                key=attribute, match=rest.MatchText(text=comparison.value)
+            )
+        kwargs = {comparison.comparator.value: comparison.value}
+        return rest.FieldCondition(key=attribute, range=rest.Range(**kwargs))
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        try:
+            from qdrant_client.http import models as rest
+        except ImportError as e:
+            raise ImportError(
+                "Cannot import qdrant_client. Please install with `pip install "
+                "qdrant-client`."
+            ) from e
+
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            filter = structured_query.filter.accept(self)
+            if isinstance(filter, rest.FieldCondition):
+                filter = rest.Filter(must=[filter])
+            kwargs = {"filter": filter}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/redis.py b/llm/Lib/site-packages/langchain/retrievers/self_query/redis.py
new file mode 100644
index 0000000000000000000000000000000000000000..cefe576182e4aac5fade63087f275425d0edbdb6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/redis.py
@@ -0,0 +1,103 @@
+from __future__ import annotations
+
+from typing import Any, Tuple
+
+from langchain_community.vectorstores.redis import Redis
+from langchain_community.vectorstores.redis.filters import (
+    RedisFilterExpression,
+    RedisFilterField,
+    RedisFilterOperator,
+    RedisNum,
+    RedisTag,
+    RedisText,
+)
+from langchain_community.vectorstores.redis.schema import RedisModel
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+_COMPARATOR_TO_BUILTIN_METHOD = {
+    Comparator.EQ: "__eq__",
+    Comparator.NE: "__ne__",
+    Comparator.LT: "__lt__",
+    Comparator.GT: "__gt__",
+    Comparator.LTE: "__le__",
+    Comparator.GTE: "__ge__",
+    Comparator.CONTAIN: "__eq__",
+    Comparator.LIKE: "__mod__",
+}
+
+
+class RedisTranslator(Visitor):
+    """Visitor for translating structured queries to Redis filter expressions."""
+
+    allowed_comparators = (
+        Comparator.EQ,
+        Comparator.NE,
+        Comparator.LT,
+        Comparator.LTE,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.CONTAIN,
+        Comparator.LIKE,
+    )
+    """Subset of allowed logical comparators."""
+    allowed_operators = (Operator.AND, Operator.OR)
+    """Subset of allowed logical operators."""
+
+    def __init__(self, schema: RedisModel) -> None:
+        self._schema = schema
+
+    def _attribute_to_filter_field(self, attribute: str) -> RedisFilterField:
+        if attribute in [tf.name for tf in self._schema.text]:
+            return RedisText(attribute)
+        elif attribute in [tf.name for tf in self._schema.tag or []]:
+            return RedisTag(attribute)
+        elif attribute in [tf.name for tf in self._schema.numeric or []]:
+            return RedisNum(attribute)
+        else:
+            raise ValueError(
+                f"Invalid attribute {attribute} not in vector store schema. Schema is:"
+                f"\n{self._schema.as_dict()}"
+            )
+
+    def visit_comparison(self, comparison: Comparison) -> RedisFilterExpression:
+        filter_field = self._attribute_to_filter_field(comparison.attribute)
+        comparison_method = _COMPARATOR_TO_BUILTIN_METHOD[comparison.comparator]
+        return getattr(filter_field, comparison_method)(comparison.value)
+
+    def visit_operation(self, operation: Operation) -> Any:
+        left = operation.arguments[0].accept(self)
+        if len(operation.arguments) > 2:
+            right = self.visit_operation(
+                Operation(
+                    operator=operation.operator, arguments=operation.arguments[1:]
+                )
+            )
+        else:
+            right = operation.arguments[1].accept(self)
+        redis_operator = (
+            RedisFilterOperator.OR
+            if operation.operator == Operator.OR
+            else RedisFilterOperator.AND
+        )
+        return RedisFilterExpression(operator=redis_operator, left=left, right=right)
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"filter": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
+
+    @classmethod
+    def from_vectorstore(cls, vectorstore: Redis) -> RedisTranslator:
+        return cls(vectorstore._schema)
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/supabase.py b/llm/Lib/site-packages/langchain/retrievers/self_query/supabase.py
new file mode 100644
index 0000000000000000000000000000000000000000..0ac0f183d787a227d85c6ea54c56cf50e71c7a1b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/supabase.py
@@ -0,0 +1,97 @@
+from typing import Any, Dict, Tuple
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+
+class SupabaseVectorTranslator(Visitor):
+    """Translate Langchain filters to Supabase PostgREST filters."""
+
+    allowed_operators = [Operator.AND, Operator.OR]
+    """Subset of allowed logical operators."""
+
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.NE,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.LT,
+        Comparator.LTE,
+        Comparator.LIKE,
+    ]
+    """Subset of allowed logical comparators."""
+
+    metadata_column = "metadata"
+
+    def _map_comparator(self, comparator: Comparator) -> str:
+        """
+        Maps Langchain comparator to PostgREST comparator:
+
+        https://postgrest.org/en/stable/references/api/tables_views.html#operators
+        """
+        postgrest_comparator = {
+            Comparator.EQ: "eq",
+            Comparator.NE: "neq",
+            Comparator.GT: "gt",
+            Comparator.GTE: "gte",
+            Comparator.LT: "lt",
+            Comparator.LTE: "lte",
+            Comparator.LIKE: "like",
+        }.get(comparator)
+
+        if postgrest_comparator is None:
+            raise Exception(
+                f"Comparator '{comparator}' is not currently "
+                "supported in Supabase Vector"
+            )
+
+        return postgrest_comparator
+
+    def _get_json_operator(self, value: Any) -> str:
+        if isinstance(value, str):
+            return "->>"
+        else:
+            return "->"
+
+    def visit_operation(self, operation: Operation) -> str:
+        args = [arg.accept(self) for arg in operation.arguments]
+        return f"{operation.operator.value}({','.join(args)})"
+
+    def visit_comparison(self, comparison: Comparison) -> str:
+        if isinstance(comparison.value, list):
+            return self.visit_operation(
+                Operation(
+                    operator=Operator.AND,
+                    arguments=[
+                        Comparison(
+                            comparator=comparison.comparator,
+                            attribute=comparison.attribute,
+                            value=value,
+                        )
+                        for value in comparison.value
+                    ],
+                )
+            )
+
+        return ".".join(
+            [
+                f"{self.metadata_column}{self._get_json_operator(comparison.value)}{comparison.attribute}",
+                f"{self._map_comparator(comparison.comparator)}",
+                f"{comparison.value}",
+            ]
+        )
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, Dict[str, str]]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"postgrest_filter": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/tencentvectordb.py b/llm/Lib/site-packages/langchain/retrievers/self_query/tencentvectordb.py
new file mode 100644
index 0000000000000000000000000000000000000000..c01f2b3e9bf31b584aa9435756cf1c3a801ec904
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/tencentvectordb.py
@@ -0,0 +1,85 @@
+from __future__ import annotations
+
+from typing import Optional, Sequence, Tuple
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+
+class TencentVectorDBTranslator(Visitor):
+    COMPARATOR_MAP = {
+        Comparator.EQ: "=",
+        Comparator.NE: "!=",
+        Comparator.GT: ">",
+        Comparator.GTE: ">=",
+        Comparator.LT: "<",
+        Comparator.LTE: "<=",
+        Comparator.IN: "in",
+        Comparator.NIN: "not in",
+    }
+
+    allowed_comparators: Optional[Sequence[Comparator]] = list(COMPARATOR_MAP.keys())
+    allowed_operators: Optional[Sequence[Operator]] = [
+        Operator.AND,
+        Operator.OR,
+        Operator.NOT,
+    ]
+
+    def __init__(self, meta_keys: Optional[Sequence[str]] = None):
+        self.meta_keys = meta_keys or []
+
+    def visit_operation(self, operation: Operation) -> str:
+        if operation.operator in (Operator.AND, Operator.OR):
+            ret = f" {operation.operator.value} ".join(
+                [arg.accept(self) for arg in operation.arguments]
+            )
+            if operation.operator == Operator.OR:
+                ret = f"({ret})"
+            return ret
+        else:
+            return f"not ({operation.arguments[0].accept(self)})"
+
+    def visit_comparison(self, comparison: Comparison) -> str:
+        if self.meta_keys and comparison.attribute not in self.meta_keys:
+            raise ValueError(
+                f"Expr Filtering found Unsupported attribute: {comparison.attribute}"
+            )
+
+        if comparison.comparator in self.COMPARATOR_MAP:
+            if comparison.comparator in [Comparator.IN, Comparator.NIN]:
+                value = map(
+                    lambda x: f'"{x}"' if isinstance(x, str) else x, comparison.value
+                )
+                return (
+                    f"{comparison.attribute}"
+                    f" {self.COMPARATOR_MAP[comparison.comparator]} "
+                    f"({', '.join(value)})"
+                )
+            if isinstance(comparison.value, str):
+                return (
+                    f"{comparison.attribute} "
+                    f"{self.COMPARATOR_MAP[comparison.comparator]}"
+                    f' "{comparison.value}"'
+                )
+            return (
+                f"{comparison.attribute}"
+                f" {self.COMPARATOR_MAP[comparison.comparator]} "
+                f"{comparison.value}"
+            )
+        else:
+            raise ValueError(f"Unsupported comparator {comparison.comparator}")
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"expr": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/timescalevector.py b/llm/Lib/site-packages/langchain/retrievers/self_query/timescalevector.py
new file mode 100644
index 0000000000000000000000000000000000000000..3d417578fe57740773f41ae6cf3e0c7b696a7432
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/timescalevector.py
@@ -0,0 +1,84 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+if TYPE_CHECKING:
+    from timescale_vector import client
+
+
+class TimescaleVectorTranslator(Visitor):
+    """Translate the internal query language elements to valid filters."""
+
+    allowed_operators = [Operator.AND, Operator.OR, Operator.NOT]
+    """Subset of allowed logical operators."""
+
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.LT,
+        Comparator.LTE,
+    ]
+
+    COMPARATOR_MAP = {
+        Comparator.EQ: "==",
+        Comparator.GT: ">",
+        Comparator.GTE: ">=",
+        Comparator.LT: "<",
+        Comparator.LTE: "<=",
+    }
+
+    OPERATOR_MAP = {Operator.AND: "AND", Operator.OR: "OR", Operator.NOT: "NOT"}
+
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        self._validate_func(func)
+        if isinstance(func, Operator):
+            value = self.OPERATOR_MAP[func.value]  # type: ignore
+        elif isinstance(func, Comparator):
+            value = self.COMPARATOR_MAP[func.value]  # type: ignore
+        return f"{value}"
+
+    def visit_operation(self, operation: Operation) -> client.Predicates:
+        try:
+            from timescale_vector import client
+        except ImportError as e:
+            raise ImportError(
+                "Cannot import timescale-vector. Please install with `pip install "
+                "timescale-vector`."
+            ) from e
+        args = [arg.accept(self) for arg in operation.arguments]
+        return client.Predicates(*args, operator=self._format_func(operation.operator))
+
+    def visit_comparison(self, comparison: Comparison) -> client.Predicates:
+        try:
+            from timescale_vector import client
+        except ImportError as e:
+            raise ImportError(
+                "Cannot import timescale-vector. Please install with `pip install "
+                "timescale-vector`."
+            ) from e
+        return client.Predicates(
+            (
+                comparison.attribute,
+                self._format_func(comparison.comparator),
+                comparison.value,
+            )
+        )
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"predicates": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/vectara.py b/llm/Lib/site-packages/langchain/retrievers/self_query/vectara.py
new file mode 100644
index 0000000000000000000000000000000000000000..02d64f04708bb44ca38bd012df02d5d19fe2c76e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/vectara.py
@@ -0,0 +1,70 @@
+from typing import Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+
+def process_value(value: Union[int, float, str]) -> str:
+    """Convert a value to a string and add single quotes if it is a string."""
+    if isinstance(value, str):
+        return f"'{value}'"
+    else:
+        return str(value)
+
+
+class VectaraTranslator(Visitor):
+    """Translate `Vectara` internal query language elements to valid filters."""
+
+    allowed_operators = [Operator.AND, Operator.OR]
+    """Subset of allowed logical operators."""
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.NE,
+        Comparator.GT,
+        Comparator.GTE,
+        Comparator.LT,
+        Comparator.LTE,
+    ]
+    """Subset of allowed logical comparators."""
+
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        map_dict = {
+            Operator.AND: " and ",
+            Operator.OR: " or ",
+            Comparator.EQ: "=",
+            Comparator.NE: "!=",
+            Comparator.GT: ">",
+            Comparator.GTE: ">=",
+            Comparator.LT: "<",
+            Comparator.LTE: "<=",
+        }
+        self._validate_func(func)
+        return map_dict[func]
+
+    def visit_operation(self, operation: Operation) -> str:
+        args = [arg.accept(self) for arg in operation.arguments]
+        operator = self._format_func(operation.operator)
+        return "( " + operator.join(args) + " )"
+
+    def visit_comparison(self, comparison: Comparison) -> str:
+        comparator = self._format_func(comparison.comparator)
+        processed_value = process_value(comparison.value)
+        attribute = comparison.attribute
+        return (
+            "( " + "doc." + attribute + " " + comparator + " " + processed_value + " )"
+        )
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"filter": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/self_query/weaviate.py b/llm/Lib/site-packages/langchain/retrievers/self_query/weaviate.py
new file mode 100644
index 0000000000000000000000000000000000000000..1db80b9ba00f5b360823fc093f9259f8b837fde1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/self_query/weaviate.py
@@ -0,0 +1,79 @@
+from datetime import datetime
+from typing import Dict, Tuple, Union
+
+from langchain.chains.query_constructor.ir import (
+    Comparator,
+    Comparison,
+    Operation,
+    Operator,
+    StructuredQuery,
+    Visitor,
+)
+
+
+class WeaviateTranslator(Visitor):
+    """Translate `Weaviate` internal query language elements to valid filters."""
+
+    allowed_operators = [Operator.AND, Operator.OR]
+    """Subset of allowed logical operators."""
+
+    allowed_comparators = [
+        Comparator.EQ,
+        Comparator.NE,
+        Comparator.GTE,
+        Comparator.LTE,
+        Comparator.LT,
+        Comparator.GT,
+    ]
+
+    def _format_func(self, func: Union[Operator, Comparator]) -> str:
+        self._validate_func(func)
+        # https://weaviate.io/developers/weaviate/api/graphql/filters
+        map_dict = {
+            Operator.AND: "And",
+            Operator.OR: "Or",
+            Comparator.EQ: "Equal",
+            Comparator.NE: "NotEqual",
+            Comparator.GTE: "GreaterThanEqual",
+            Comparator.LTE: "LessThanEqual",
+            Comparator.LT: "LessThan",
+            Comparator.GT: "GreaterThan",
+        }
+        return map_dict[func]
+
+    def visit_operation(self, operation: Operation) -> Dict:
+        args = [arg.accept(self) for arg in operation.arguments]
+        return {"operator": self._format_func(operation.operator), "operands": args}
+
+    def visit_comparison(self, comparison: Comparison) -> Dict:
+        value_type = "valueText"
+        value = comparison.value
+        if isinstance(comparison.value, bool):
+            value_type = "valueBoolean"
+        elif isinstance(comparison.value, float):
+            value_type = "valueNumber"
+        elif isinstance(comparison.value, int):
+            value_type = "valueInt"
+        elif (
+            isinstance(comparison.value, dict)
+            and comparison.value.get("type") == "date"
+        ):
+            value_type = "valueDate"
+            # ISO 8601 timestamp, formatted as RFC3339
+            date = datetime.strptime(comparison.value["date"], "%Y-%m-%d")
+            value = date.strftime("%Y-%m-%dT%H:%M:%SZ")
+        filter = {
+            "path": [comparison.attribute],
+            "operator": self._format_func(comparison.comparator),
+            value_type: value,
+        }
+        return filter
+
+    def visit_structured_query(
+        self, structured_query: StructuredQuery
+    ) -> Tuple[str, dict]:
+        if structured_query.filter is None:
+            kwargs = {}
+        else:
+            kwargs = {"where_filter": structured_query.filter.accept(self)}
+        return structured_query.query, kwargs
diff --git a/llm/Lib/site-packages/langchain/retrievers/svm.py b/llm/Lib/site-packages/langchain/retrievers/svm.py
new file mode 100644
index 0000000000000000000000000000000000000000..2e0d8b669ad07782c52f20008835be6c248c118d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/svm.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.svm import SVMRetriever
+
+__all__ = ["SVMRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/tavily_search_api.py b/llm/Lib/site-packages/langchain/retrievers/tavily_search_api.py
new file mode 100644
index 0000000000000000000000000000000000000000..6fc2bca6021390764b865a3e4a8c032387319578
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/tavily_search_api.py
@@ -0,0 +1,6 @@
+from langchain_community.retrievers.tavily_search_api import (
+    SearchDepth,
+    TavilySearchAPIRetriever,
+)
+
+__all__ = ["SearchDepth", "TavilySearchAPIRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/tfidf.py b/llm/Lib/site-packages/langchain/retrievers/tfidf.py
new file mode 100644
index 0000000000000000000000000000000000000000..0cefc03c2b97b2836bc5a95ab8593e765f66adc0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/tfidf.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.tfidf import TFIDFRetriever
+
+__all__ = ["TFIDFRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/time_weighted_retriever.py b/llm/Lib/site-packages/langchain/retrievers/time_weighted_retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..7864cc3b097c89037d16593be7b526e8fa121cf8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/time_weighted_retriever.py
@@ -0,0 +1,183 @@
+import datetime
+from copy import deepcopy
+from typing import Any, Dict, List, Optional, Tuple
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Field
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.vectorstores import VectorStore
+
+
+def _get_hours_passed(time: datetime.datetime, ref_time: datetime.datetime) -> float:
+    """Get the hours passed between two datetimes."""
+    return (time - ref_time).total_seconds() / 3600
+
+
+class TimeWeightedVectorStoreRetriever(BaseRetriever):
+    """Retriever that combines embedding similarity with
+    recency in retrieving values."""
+
+    vectorstore: VectorStore
+    """The vectorstore to store documents and determine salience."""
+
+    search_kwargs: dict = Field(default_factory=lambda: dict(k=100))
+    """Keyword arguments to pass to the vectorstore similarity search."""
+
+    # TODO: abstract as a queue
+    memory_stream: List[Document] = Field(default_factory=list)
+    """The memory_stream of documents to search through."""
+
+    decay_rate: float = Field(default=0.01)
+    """The exponential decay factor used as (1.0-decay_rate)**(hrs_passed)."""
+
+    k: int = 4
+    """The maximum number of documents to retrieve in a given call."""
+
+    other_score_keys: List[str] = []
+    """Other keys in the metadata to factor into the score, e.g. 'importance'."""
+
+    default_salience: Optional[float] = None
+    """The salience to assign memories not retrieved from the vector store.
+
+    None assigns no salience to documents not fetched from the vector store.
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def _document_get_date(self, field: str, document: Document) -> datetime.datetime:
+        """Return the value of the date field of a document."""
+        if field in document.metadata:
+            if isinstance(document.metadata[field], float):
+                return datetime.datetime.fromtimestamp(document.metadata[field])
+            return document.metadata[field]
+        return datetime.datetime.now()
+
+    def _get_combined_score(
+        self,
+        document: Document,
+        vector_relevance: Optional[float],
+        current_time: datetime.datetime,
+    ) -> float:
+        """Return the combined score for a document."""
+        hours_passed = _get_hours_passed(
+            current_time,
+            self._document_get_date("last_accessed_at", document),
+        )
+        score = (1.0 - self.decay_rate) ** hours_passed
+        for key in self.other_score_keys:
+            if key in document.metadata:
+                score += document.metadata[key]
+        if vector_relevance is not None:
+            score += vector_relevance
+        return score
+
+    def get_salient_docs(self, query: str) -> Dict[int, Tuple[Document, float]]:
+        """Return documents that are salient to the query."""
+        docs_and_scores: List[Tuple[Document, float]]
+        docs_and_scores = self.vectorstore.similarity_search_with_relevance_scores(
+            query, **self.search_kwargs
+        )
+        results = {}
+        for fetched_doc, relevance in docs_and_scores:
+            if "buffer_idx" in fetched_doc.metadata:
+                buffer_idx = fetched_doc.metadata["buffer_idx"]
+                doc = self.memory_stream[buffer_idx]
+                results[buffer_idx] = (doc, relevance)
+        return results
+
+    async def aget_salient_docs(self, query: str) -> Dict[int, Tuple[Document, float]]:
+        """Return documents that are salient to the query."""
+        docs_and_scores: List[Tuple[Document, float]]
+        docs_and_scores = (
+            await self.vectorstore.asimilarity_search_with_relevance_scores(
+                query, **self.search_kwargs
+            )
+        )
+        results = {}
+        for fetched_doc, relevance in docs_and_scores:
+            if "buffer_idx" in fetched_doc.metadata:
+                buffer_idx = fetched_doc.metadata["buffer_idx"]
+                doc = self.memory_stream[buffer_idx]
+                results[buffer_idx] = (doc, relevance)
+        return results
+
+    def _get_rescored_docs(
+        self, docs_and_scores: Dict[Any, Tuple[Document, Optional[float]]]
+    ) -> List[Document]:
+        current_time = datetime.datetime.now()
+        rescored_docs = [
+            (doc, self._get_combined_score(doc, relevance, current_time))
+            for doc, relevance in docs_and_scores.values()
+        ]
+        rescored_docs.sort(key=lambda x: x[1], reverse=True)
+        result = []
+        # Ensure frequently accessed memories aren't forgotten
+        for doc, _ in rescored_docs[: self.k]:
+            # TODO: Update vector store doc once `update` method is exposed.
+            buffered_doc = self.memory_stream[doc.metadata["buffer_idx"]]
+            buffered_doc.metadata["last_accessed_at"] = current_time
+            result.append(buffered_doc)
+        return result
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        docs_and_scores = {
+            doc.metadata["buffer_idx"]: (doc, self.default_salience)
+            for doc in self.memory_stream[-self.k :]
+        }
+        # If a doc is considered salient, update the salience score
+        docs_and_scores.update(self.get_salient_docs(query))
+        return self._get_rescored_docs(docs_and_scores)
+
+    async def _aget_relevant_documents(
+        self, query: str, *, run_manager: AsyncCallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        docs_and_scores = {
+            doc.metadata["buffer_idx"]: (doc, self.default_salience)
+            for doc in self.memory_stream[-self.k :]
+        }
+        # If a doc is considered salient, update the salience score
+        docs_and_scores.update(await self.aget_salient_docs(query))
+        return self._get_rescored_docs(docs_and_scores)
+
+    def add_documents(self, documents: List[Document], **kwargs: Any) -> List[str]:
+        """Add documents to vectorstore."""
+        current_time = kwargs.get("current_time")
+        if current_time is None:
+            current_time = datetime.datetime.now()
+        # Avoid mutating input documents
+        dup_docs = [deepcopy(d) for d in documents]
+        for i, doc in enumerate(dup_docs):
+            if "last_accessed_at" not in doc.metadata:
+                doc.metadata["last_accessed_at"] = current_time
+            if "created_at" not in doc.metadata:
+                doc.metadata["created_at"] = current_time
+            doc.metadata["buffer_idx"] = len(self.memory_stream) + i
+        self.memory_stream.extend(dup_docs)
+        return self.vectorstore.add_documents(dup_docs, **kwargs)
+
+    async def aadd_documents(
+        self, documents: List[Document], **kwargs: Any
+    ) -> List[str]:
+        """Add documents to vectorstore."""
+        current_time = kwargs.get("current_time")
+        if current_time is None:
+            current_time = datetime.datetime.now()
+        # Avoid mutating input documents
+        dup_docs = [deepcopy(d) for d in documents]
+        for i, doc in enumerate(dup_docs):
+            if "last_accessed_at" not in doc.metadata:
+                doc.metadata["last_accessed_at"] = current_time
+            if "created_at" not in doc.metadata:
+                doc.metadata["created_at"] = current_time
+            doc.metadata["buffer_idx"] = len(self.memory_stream) + i
+        self.memory_stream.extend(dup_docs)
+        return await self.vectorstore.aadd_documents(dup_docs, **kwargs)
diff --git a/llm/Lib/site-packages/langchain/retrievers/vespa_retriever.py b/llm/Lib/site-packages/langchain/retrievers/vespa_retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..889668853b497e9c6e16ffa7537dfe46f7cbddc9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/vespa_retriever.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.vespa_retriever import VespaRetriever
+
+__all__ = ["VespaRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/weaviate_hybrid_search.py b/llm/Lib/site-packages/langchain/retrievers/weaviate_hybrid_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd15f128e537bf8f8e09277a4c9a9b0d6a296f95
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/weaviate_hybrid_search.py
@@ -0,0 +1,5 @@
+from langchain_community.retrievers.weaviate_hybrid_search import (
+    WeaviateHybridSearchRetriever,
+)
+
+__all__ = ["WeaviateHybridSearchRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/web_research.py b/llm/Lib/site-packages/langchain/retrievers/web_research.py
new file mode 100644
index 0000000000000000000000000000000000000000..378c77a267a5b6f29d98610ffdf1670073184e60
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/web_research.py
@@ -0,0 +1,223 @@
+import logging
+import re
+from typing import List, Optional
+
+from langchain_community.document_loaders import AsyncHtmlLoader
+from langchain_community.document_transformers import Html2TextTransformer
+from langchain_community.llms import LlamaCpp
+from langchain_community.utilities import GoogleSearchAPIWrapper
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.language_models import BaseLLM
+from langchain_core.output_parsers import BaseOutputParser
+from langchain_core.prompts import BasePromptTemplate, PromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.vectorstores import VectorStore
+from langchain_text_splitters import RecursiveCharacterTextSplitter, TextSplitter
+
+from langchain.chains import LLMChain
+from langchain.chains.prompt_selector import ConditionalPromptSelector
+
+logger = logging.getLogger(__name__)
+
+
+class SearchQueries(BaseModel):
+    """Search queries to research for the user's goal."""
+
+    queries: List[str] = Field(
+        ..., description="List of search queries to look up on Google"
+    )
+
+
+DEFAULT_LLAMA_SEARCH_PROMPT = PromptTemplate(
+    input_variables=["question"],
+    template="""<<SYS>> \n You are an assistant tasked with improving Google search \
+results. \n <</SYS>> \n\n [INST] Generate THREE Google search queries that \
+are similar to this question. The output should be a numbered list of questions \
+and each should have a question mark at the end: \n\n {question} [/INST]""",
+)
+
+DEFAULT_SEARCH_PROMPT = PromptTemplate(
+    input_variables=["question"],
+    template="""You are an assistant tasked with improving Google search \
+results. Generate THREE Google search queries that are similar to \
+this question. The output should be a numbered list of questions and each \
+should have a question mark at the end: {question}""",
+)
+
+
+class QuestionListOutputParser(BaseOutputParser[List[str]]):
+    """Output parser for a list of numbered questions."""
+
+    def parse(self, text: str) -> List[str]:
+        lines = re.findall(r"\d+\..*?(?:\n|$)", text)
+        return lines
+
+
+class WebResearchRetriever(BaseRetriever):
+    """`Google Search API` retriever."""
+
+    # Inputs
+    vectorstore: VectorStore = Field(
+        ..., description="Vector store for storing web pages"
+    )
+    llm_chain: LLMChain
+    search: GoogleSearchAPIWrapper = Field(..., description="Google Search API Wrapper")
+    num_search_results: int = Field(1, description="Number of pages per Google search")
+    text_splitter: TextSplitter = Field(
+        RecursiveCharacterTextSplitter(chunk_size=1500, chunk_overlap=50),
+        description="Text splitter for splitting web pages into chunks",
+    )
+    url_database: List[str] = Field(
+        default_factory=list, description="List of processed URLs"
+    )
+
+    @classmethod
+    def from_llm(
+        cls,
+        vectorstore: VectorStore,
+        llm: BaseLLM,
+        search: GoogleSearchAPIWrapper,
+        prompt: Optional[BasePromptTemplate] = None,
+        num_search_results: int = 1,
+        text_splitter: RecursiveCharacterTextSplitter = RecursiveCharacterTextSplitter(
+            chunk_size=1500, chunk_overlap=150
+        ),
+    ) -> "WebResearchRetriever":
+        """Initialize from llm using default template.
+
+        Args:
+            vectorstore: Vector store for storing web pages
+            llm: llm for search question generation
+            search: GoogleSearchAPIWrapper
+            prompt: prompt to generating search questions
+            num_search_results: Number of pages per Google search
+            text_splitter: Text splitter for splitting web pages into chunks
+
+        Returns:
+            WebResearchRetriever
+        """
+
+        if not prompt:
+            QUESTION_PROMPT_SELECTOR = ConditionalPromptSelector(
+                default_prompt=DEFAULT_SEARCH_PROMPT,
+                conditionals=[
+                    (lambda llm: isinstance(llm, LlamaCpp), DEFAULT_LLAMA_SEARCH_PROMPT)
+                ],
+            )
+            prompt = QUESTION_PROMPT_SELECTOR.get_prompt(llm)
+
+        # Use chat model prompt
+        llm_chain = LLMChain(
+            llm=llm,
+            prompt=prompt,
+            output_parser=QuestionListOutputParser(),
+        )
+
+        return cls(
+            vectorstore=vectorstore,
+            llm_chain=llm_chain,
+            search=search,
+            num_search_results=num_search_results,
+            text_splitter=text_splitter,
+        )
+
+    def clean_search_query(self, query: str) -> str:
+        # Some search tools (e.g., Google) will
+        # fail to return results if query has a
+        # leading digit: 1. "LangCh..."
+        # Check if the first character is a digit
+        if query[0].isdigit():
+            # Find the position of the first quote
+            first_quote_pos = query.find('"')
+            if first_quote_pos != -1:
+                # Extract the part of the string after the quote
+                query = query[first_quote_pos + 1 :]
+                # Remove the trailing quote if present
+                if query.endswith('"'):
+                    query = query[:-1]
+        return query.strip()
+
+    def search_tool(self, query: str, num_search_results: int = 1) -> List[dict]:
+        """Returns num_search_results pages per Google search."""
+        query_clean = self.clean_search_query(query)
+        result = self.search.results(query_clean, num_search_results)
+        return result
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+    ) -> List[Document]:
+        """Search Google for documents related to the query input.
+
+        Args:
+            query: user query
+
+        Returns:
+            Relevant documents from all various urls.
+        """
+
+        # Get search questions
+        logger.info("Generating questions for Google Search ...")
+        result = self.llm_chain({"question": query})
+        logger.info(f"Questions for Google Search (raw): {result}")
+        questions = result["text"]
+        logger.info(f"Questions for Google Search: {questions}")
+
+        # Get urls
+        logger.info("Searching for relevant urls...")
+        urls_to_look = []
+        for query in questions:
+            # Google search
+            search_results = self.search_tool(query, self.num_search_results)
+            logger.info("Searching for relevant urls...")
+            logger.info(f"Search results: {search_results}")
+            for res in search_results:
+                if res.get("link", None):
+                    urls_to_look.append(res["link"])
+
+        # Relevant urls
+        urls = set(urls_to_look)
+
+        # Check for any new urls that we have not processed
+        new_urls = list(urls.difference(self.url_database))
+
+        logger.info(f"New URLs to load: {new_urls}")
+        # Load, split, and add new urls to vectorstore
+        if new_urls:
+            loader = AsyncHtmlLoader(new_urls, ignore_load_errors=True)
+            html2text = Html2TextTransformer()
+            logger.info("Indexing new urls...")
+            docs = loader.load()
+            docs = list(html2text.transform_documents(docs))
+            docs = self.text_splitter.split_documents(docs)
+            self.vectorstore.add_documents(docs)
+            self.url_database.extend(new_urls)
+
+        # Search for relevant splits
+        # TODO: make this async
+        logger.info("Grabbing most relevant splits from urls...")
+        docs = []
+        for query in questions:
+            docs.extend(self.vectorstore.similarity_search(query))
+
+        # Get unique docs
+        unique_documents_dict = {
+            (doc.page_content, tuple(sorted(doc.metadata.items()))): doc for doc in docs
+        }
+        unique_documents = list(unique_documents_dict.values())
+        return unique_documents
+
+    async def _aget_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: AsyncCallbackManagerForRetrieverRun,
+    ) -> List[Document]:
+        raise NotImplementedError
diff --git a/llm/Lib/site-packages/langchain/retrievers/wikipedia.py b/llm/Lib/site-packages/langchain/retrievers/wikipedia.py
new file mode 100644
index 0000000000000000000000000000000000000000..8eaffa85b94f3018faebbe9a74916ee697a14177
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/wikipedia.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.wikipedia import WikipediaRetriever
+
+__all__ = ["WikipediaRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/you.py b/llm/Lib/site-packages/langchain/retrievers/you.py
new file mode 100644
index 0000000000000000000000000000000000000000..c285b56263fe94aafc7ea19248fbc9c173434c02
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/you.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.you import YouRetriever
+
+__all__ = ["YouRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/zep.py b/llm/Lib/site-packages/langchain/retrievers/zep.py
new file mode 100644
index 0000000000000000000000000000000000000000..9f09841bd6b7fd82c3050fca2bb9ee8fb41c685f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/zep.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.zep import SearchScope, SearchType, ZepRetriever
+
+__all__ = ["SearchScope", "SearchType", "ZepRetriever"]
diff --git a/llm/Lib/site-packages/langchain/retrievers/zilliz.py b/llm/Lib/site-packages/langchain/retrievers/zilliz.py
new file mode 100644
index 0000000000000000000000000000000000000000..8daf25f61c8014d9abfc0e10f4f6634ec19e1c8f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/retrievers/zilliz.py
@@ -0,0 +1,3 @@
+from langchain_community.retrievers.zilliz import ZillizRetreiver, ZillizRetriever
+
+__all__ = ["ZillizRetriever", "ZillizRetreiver"]
diff --git a/llm/Lib/site-packages/langchain/runnables/__init__.py b/llm/Lib/site-packages/langchain/runnables/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0a8b3c39f6cd765bfad4fbaa69d074c4c273f96f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/runnables/__init__.py
@@ -0,0 +1,18 @@
+"""LangChain **Runnable** and the **LangChain Expression Language (LCEL)**.
+
+The LangChain Expression Language (LCEL) offers a declarative method to build
+production-grade programs that harness the power of LLMs.
+
+Programs created using LCEL and LangChain Runnables inherently support
+synchronous, asynchronous, batch, and streaming operations.
+
+Support for **async** allows servers hosting the LCEL based programs
+to scale better for higher concurrent loads.
+
+**Batch** operations allow for processing multiple inputs in parallel.
+
+**Streaming** of intermediate outputs, as they're being generated, allows for
+creating more responsive UX.
+
+This module contains non-core Runnable classes.
+"""
diff --git a/llm/Lib/site-packages/langchain/runnables/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/runnables/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3d1f79aea701b62ee017940d1471778940f93afe
Binary files /dev/null and b/llm/Lib/site-packages/langchain/runnables/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/runnables/__pycache__/hub.cpython-311.pyc b/llm/Lib/site-packages/langchain/runnables/__pycache__/hub.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2e41032fcd491d200110f8dab5f14b6ab55cf4f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/runnables/__pycache__/hub.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/runnables/__pycache__/openai_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain/runnables/__pycache__/openai_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..81a8fcd472d097f49d0b74931be93189dc05c9b0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/runnables/__pycache__/openai_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/runnables/hub.py b/llm/Lib/site-packages/langchain/runnables/hub.py
new file mode 100644
index 0000000000000000000000000000000000000000..71fad87ba671df5e6367eb448958279cb71a98af
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/runnables/hub.py
@@ -0,0 +1,31 @@
+from typing import Any, Optional
+
+from langchain_core.runnables.base import Input, Output, RunnableBindingBase
+
+
+class HubRunnable(RunnableBindingBase[Input, Output]):
+    """
+    An instance of a runnable stored in the LangChain Hub.
+    """
+
+    owner_repo_commit: str
+
+    def __init__(
+        self,
+        owner_repo_commit: str,
+        *,
+        api_url: Optional[str] = None,
+        api_key: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        from langchain.hub import pull
+
+        pulled = pull(owner_repo_commit, api_url=api_url, api_key=api_key)
+        super_kwargs = {
+            "kwargs": {},
+            "config": {},
+            **kwargs,
+            "bound": pulled,
+            "owner_repo_commit": owner_repo_commit,
+        }
+        super().__init__(**super_kwargs)
diff --git a/llm/Lib/site-packages/langchain/runnables/openai_functions.py b/llm/Lib/site-packages/langchain/runnables/openai_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..baef4f5c38660ac964db02763f5ae8d24d7d11ff
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/runnables/openai_functions.py
@@ -0,0 +1,46 @@
+from operator import itemgetter
+from typing import Any, Callable, List, Mapping, Optional, Union
+
+from langchain_core.messages import BaseMessage
+from langchain_core.output_parsers.openai_functions import JsonOutputFunctionsParser
+from langchain_core.runnables import RouterRunnable, Runnable
+from langchain_core.runnables.base import RunnableBindingBase
+from typing_extensions import TypedDict
+
+
+class OpenAIFunction(TypedDict):
+    """A function description for ChatOpenAI"""
+
+    name: str
+    """The name of the function."""
+    description: str
+    """The description of the function."""
+    parameters: dict
+    """The parameters to the function."""
+
+
+class OpenAIFunctionsRouter(RunnableBindingBase[BaseMessage, Any]):
+    """A runnable that routes to the selected function."""
+
+    functions: Optional[List[OpenAIFunction]]
+
+    def __init__(
+        self,
+        runnables: Mapping[
+            str,
+            Union[
+                Runnable[dict, Any],
+                Callable[[dict], Any],
+            ],
+        ],
+        functions: Optional[List[OpenAIFunction]] = None,
+    ):
+        if functions is not None:
+            assert len(functions) == len(runnables)
+            assert all(func["name"] in runnables for func in functions)
+        router = (
+            JsonOutputFunctionsParser(args_only=False)
+            | {"key": itemgetter("name"), "input": itemgetter("arguments")}
+            | RouterRunnable(runnables)
+        )
+        super().__init__(bound=router, kwargs={}, functions=functions)
diff --git a/llm/Lib/site-packages/langchain/schema/__init__.py b/llm/Lib/site-packages/langchain/schema/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ac920bfedf815726b8b43a905c9f2c40d4e87de2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/__init__.py
@@ -0,0 +1,81 @@
+"""**Schemas** are the LangChain Base Classes and Interfaces."""
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.caches import BaseCache
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.documents import BaseDocumentTransformer, Document
+from langchain_core.exceptions import LangChainException, OutputParserException
+from langchain_core.memory import BaseMemory
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    ChatMessage,
+    FunctionMessage,
+    HumanMessage,
+    SystemMessage,
+    _message_from_dict,
+    get_buffer_string,
+    messages_from_dict,
+    messages_to_dict,
+)
+from langchain_core.messages.base import message_to_dict
+from langchain_core.output_parsers import (
+    BaseLLMOutputParser,
+    BaseOutputParser,
+    StrOutputParser,
+)
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatResult,
+    Generation,
+    LLMResult,
+    RunInfo,
+)
+from langchain_core.prompt_values import PromptValue
+from langchain_core.prompts import BasePromptTemplate, format_document
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.stores import BaseStore
+
+RUN_KEY = "__run"
+
+# Backwards compatibility.
+Memory = BaseMemory
+_message_to_dict = message_to_dict
+
+__all__ = [
+    "BaseCache",
+    "BaseMemory",
+    "BaseStore",
+    "AgentFinish",
+    "AgentAction",
+    "Document",
+    "BaseChatMessageHistory",
+    "BaseDocumentTransformer",
+    "BaseMessage",
+    "ChatMessage",
+    "FunctionMessage",
+    "HumanMessage",
+    "AIMessage",
+    "SystemMessage",
+    "messages_from_dict",
+    "messages_to_dict",
+    "message_to_dict",
+    "_message_to_dict",
+    "_message_from_dict",
+    "get_buffer_string",
+    "RunInfo",
+    "LLMResult",
+    "ChatResult",
+    "ChatGeneration",
+    "Generation",
+    "PromptValue",
+    "LangChainException",
+    "BaseRetriever",
+    "RUN_KEY",
+    "Memory",
+    "OutputParserException",
+    "StrOutputParser",
+    "BaseOutputParser",
+    "BaseLLMOutputParser",
+    "BasePromptTemplate",
+    "format_document",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5bee833101888e218dbd643454483068bc4e196a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/agent.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/agent.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bfbffd14e27cf3c5b672a6796865d070407065b0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/agent.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/cache.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/cache.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ff8ba1afb9a07a5de0423dca6b6ae103b12cdda2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/cache.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/chat.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/chat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1e6da6cbd423167b6f1ac1718d6468760fd4e8b0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/chat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/chat_history.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/chat_history.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..249ebcee342ad53d85f26eb1f86267ce1e3fb12a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/chat_history.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/document.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/document.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..842f4be244d942504d066b4ece77dc5ad5e5de1b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/document.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/embeddings.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/embeddings.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1f4af1213a2837bf281cfebda5e0a64e88dba92d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/embeddings.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f8bd79b29b7f4c452f8b191656b5b2b8472aa85b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/language_model.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/language_model.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9e199fccbd2cb042089a404930648e1a69dac711
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/language_model.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/memory.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..07405813de325adb8a956e77a1f4b0218b9693a5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/messages.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/messages.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..04732d6026c9f9a32c3193e927333e851c7dc2f1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/messages.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/output.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/output.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b34174b81131a462d999f9819ece226ce06d2f3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/output.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/output_parser.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/output_parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ad82e5eea087bbe3d6828eab4b8a865126655333
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/output_parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..df1ee9c4415511bd97b5ea958bd12f2a73ed4b3e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/prompt_template.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/prompt_template.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fb1aadb1be3e32c60614bb061720776caac86b87
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/prompt_template.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5ad47fb52f3b881d4d5c6f57a19a9a7417641146
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/storage.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/storage.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e481cab20e971e8b4cd1d85d2fa49c4fa6f38dc9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/storage.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/__pycache__/vectorstore.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/__pycache__/vectorstore.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..31d1986b838c734cecb57dcb24fbf6763d472a3f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/__pycache__/vectorstore.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/agent.py b/llm/Lib/site-packages/langchain/schema/agent.py
new file mode 100644
index 0000000000000000000000000000000000000000..498a4aea7c542e3e73b4725be20f7b57da12a2d9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/agent.py
@@ -0,0 +1,3 @@
+from langchain_core.agents import AgentAction, AgentActionMessageLog, AgentFinish
+
+__all__ = ["AgentAction", "AgentActionMessageLog", "AgentFinish"]
diff --git a/llm/Lib/site-packages/langchain/schema/cache.py b/llm/Lib/site-packages/langchain/schema/cache.py
new file mode 100644
index 0000000000000000000000000000000000000000..8407af18c833cff38866bbef845de9fd807f08f1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/cache.py
@@ -0,0 +1,3 @@
+from langchain_core.caches import RETURN_VAL_TYPE, BaseCache
+
+__all__ = ["BaseCache", "RETURN_VAL_TYPE"]
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/__init__.py b/llm/Lib/site-packages/langchain/schema/callbacks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cb69cf60758e19a72a0217f1b9b3b7f303e1e56a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..97a74dd4598eaf806b1d1923b1773c1be94736fe
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/manager.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/manager.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..af66b47c349467c63a240a3b83aef92be2f6716c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/manager.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/stdout.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/stdout.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..afcd9b4891e2495e185cb3b9b21ffc07d871a387
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/stdout.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/streaming_stdout.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/streaming_stdout.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dd8c64ba53b2acc0bbab851b355f2bd5b15e8e6d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/__pycache__/streaming_stdout.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/base.py b/llm/Lib/site-packages/langchain/schema/callbacks/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..ab2053a075cacf096b75b0af60fc82a81b2fcf28
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/callbacks/base.py
@@ -0,0 +1,23 @@
+from langchain_core.callbacks.base import (
+    AsyncCallbackHandler,
+    BaseCallbackHandler,
+    BaseCallbackManager,
+    CallbackManagerMixin,
+    ChainManagerMixin,
+    LLMManagerMixin,
+    RetrieverManagerMixin,
+    RunManagerMixin,
+    ToolManagerMixin,
+)
+
+__all__ = [
+    "RetrieverManagerMixin",
+    "LLMManagerMixin",
+    "ChainManagerMixin",
+    "ToolManagerMixin",
+    "CallbackManagerMixin",
+    "RunManagerMixin",
+    "BaseCallbackHandler",
+    "AsyncCallbackHandler",
+    "BaseCallbackManager",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/manager.py b/llm/Lib/site-packages/langchain/schema/callbacks/manager.py
new file mode 100644
index 0000000000000000000000000000000000000000..a459e1bb697e561a60fda1fec0a0c030e9f0c971
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/callbacks/manager.py
@@ -0,0 +1,55 @@
+from langchain_core.callbacks.manager import (
+    AsyncCallbackManager,
+    AsyncCallbackManagerForChainGroup,
+    AsyncCallbackManagerForChainRun,
+    AsyncCallbackManagerForLLMRun,
+    AsyncCallbackManagerForRetrieverRun,
+    AsyncCallbackManagerForToolRun,
+    AsyncParentRunManager,
+    AsyncRunManager,
+    BaseRunManager,
+    CallbackManager,
+    CallbackManagerForChainGroup,
+    CallbackManagerForChainRun,
+    CallbackManagerForLLMRun,
+    CallbackManagerForRetrieverRun,
+    CallbackManagerForToolRun,
+    ParentRunManager,
+    RunManager,
+    handle_event,
+    trace_as_chain_group,
+)
+from langchain_core.tracers.context import (
+    collect_runs,
+    register_configure_hook,
+    tracing_enabled,
+    tracing_v2_enabled,
+)
+from langchain_core.utils.env import env_var_is_set
+
+__all__ = [
+    "tracing_enabled",
+    "tracing_v2_enabled",
+    "collect_runs",
+    "trace_as_chain_group",
+    "handle_event",
+    "BaseRunManager",
+    "RunManager",
+    "ParentRunManager",
+    "AsyncRunManager",
+    "AsyncParentRunManager",
+    "CallbackManagerForLLMRun",
+    "AsyncCallbackManagerForLLMRun",
+    "CallbackManagerForChainRun",
+    "AsyncCallbackManagerForChainRun",
+    "CallbackManagerForToolRun",
+    "AsyncCallbackManagerForToolRun",
+    "CallbackManagerForRetrieverRun",
+    "AsyncCallbackManagerForRetrieverRun",
+    "CallbackManager",
+    "CallbackManagerForChainGroup",
+    "AsyncCallbackManager",
+    "AsyncCallbackManagerForChainGroup",
+    "register_configure_hook",
+    "env_var_is_set",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/stdout.py b/llm/Lib/site-packages/langchain/schema/callbacks/stdout.py
new file mode 100644
index 0000000000000000000000000000000000000000..754e58248e4700a666314dddf21a8f4248f8e541
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/callbacks/stdout.py
@@ -0,0 +1,3 @@
+from langchain_core.callbacks.stdout import StdOutCallbackHandler
+
+__all__ = ["StdOutCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/streaming_stdout.py b/llm/Lib/site-packages/langchain/schema/callbacks/streaming_stdout.py
new file mode 100644
index 0000000000000000000000000000000000000000..35608689634800004cfc0523f3dc911add005773
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/callbacks/streaming_stdout.py
@@ -0,0 +1,3 @@
+from langchain_core.callbacks.streaming_stdout import StreamingStdOutCallbackHandler
+
+__all__ = ["StreamingStdOutCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__init__.py b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8bbbf78a01c15cf089a5195e9ec9fbd904c27b28
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9fd68b325b32086d9884db7625eb8fb51ddacbdd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/evaluation.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/evaluation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..13f4497e6800110b64084b5260ba587064f9946b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/evaluation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/langchain.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/langchain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7abe4605cf0015d5a03237476e1c80afb89d481f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/langchain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/langchain_v1.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/langchain_v1.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3d0aeb4159761c3c0041c34bf29b42a905effe6d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/langchain_v1.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/log_stream.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/log_stream.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2ae4b3983c1c6b76cb2c38e319c24c2e8f259b89
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/log_stream.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/root_listeners.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/root_listeners.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2ce49c7df42123ba6d529990c567c2f328467736
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/root_listeners.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/run_collector.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/run_collector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ae249cc1d90740c5c9f6c487c55a901a6f133f17
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/run_collector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/schemas.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/schemas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d00450487430c99e18deb779b476a7cff75cfee2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/schemas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/stdout.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/stdout.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..165c8df1364098e2f75a304a2ba0448a82e7a1cd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/__pycache__/stdout.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/base.py b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce38a8bcf3be69f0d9264acaa129d43bc2d81bee
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/base.py
@@ -0,0 +1,3 @@
+from langchain_core.tracers.base import BaseTracer, TracerException
+
+__all__ = ["TracerException", "BaseTracer"]
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/evaluation.py b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/evaluation.py
new file mode 100644
index 0000000000000000000000000000000000000000..363c74fcc85e7bb6de3d798449b3719ae10eea67
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/evaluation.py
@@ -0,0 +1,6 @@
+from langchain_core.tracers.evaluation import (
+    EvaluatorCallbackHandler,
+    wait_for_all_evaluators,
+)
+
+__all__ = ["wait_for_all_evaluators", "EvaluatorCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/langchain.py b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/langchain.py
new file mode 100644
index 0000000000000000000000000000000000000000..8415dfab94533985da7c9b6a97c71968f91a22e3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/langchain.py
@@ -0,0 +1,8 @@
+from langchain_core.tracers.langchain import (
+    LangChainTracer,
+    get_client,
+    log_error_once,
+    wait_for_all_tracers,
+)
+
+__all__ = ["log_error_once", "wait_for_all_tracers", "get_client", "LangChainTracer"]
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/langchain_v1.py b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/langchain_v1.py
new file mode 100644
index 0000000000000000000000000000000000000000..fca2d7590f1327dd7635062cfb11ec54da3a2bbf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/langchain_v1.py
@@ -0,0 +1,3 @@
+from langchain_core.tracers.langchain_v1 import LangChainTracerV1, get_headers
+
+__all__ = ["get_headers", "LangChainTracerV1"]
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/log_stream.py b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/log_stream.py
new file mode 100644
index 0000000000000000000000000000000000000000..ef3dd946d6626408adf6a69e8b771183bb31e283
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/log_stream.py
@@ -0,0 +1,9 @@
+from langchain_core.tracers.log_stream import (
+    LogEntry,
+    LogStreamCallbackHandler,
+    RunLog,
+    RunLogPatch,
+    RunState,
+)
+
+__all__ = ["LogEntry", "RunState", "RunLogPatch", "RunLog", "LogStreamCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/root_listeners.py b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/root_listeners.py
new file mode 100644
index 0000000000000000000000000000000000000000..0dee9bce2d23376310af8d807599c6952da5eda7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/root_listeners.py
@@ -0,0 +1,3 @@
+from langchain_core.tracers.root_listeners import RootListenersTracer
+
+__all__ = ["RootListenersTracer"]
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/run_collector.py b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/run_collector.py
new file mode 100644
index 0000000000000000000000000000000000000000..1240026bfb61e3f8d431d036edd4b4024b4be838
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/run_collector.py
@@ -0,0 +1,3 @@
+from langchain_core.tracers.run_collector import RunCollectorCallbackHandler
+
+__all__ = ["RunCollectorCallbackHandler"]
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/schemas.py b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/schemas.py
new file mode 100644
index 0000000000000000000000000000000000000000..6fb49dbf7248983f1c4a68c7e8b2ff07ea83a1c1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/schemas.py
@@ -0,0 +1,27 @@
+from langchain_core.tracers.schemas import (
+    BaseRun,
+    ChainRun,
+    LLMRun,
+    Run,
+    RunTypeEnum,
+    ToolRun,
+    TracerSession,
+    TracerSessionBase,
+    TracerSessionV1,
+    TracerSessionV1Base,
+    TracerSessionV1Create,
+)
+
+__all__ = [
+    "RunTypeEnum",
+    "TracerSessionV1Base",
+    "TracerSessionV1Create",
+    "TracerSessionV1",
+    "TracerSessionBase",
+    "TracerSession",
+    "BaseRun",
+    "LLMRun",
+    "ChainRun",
+    "ToolRun",
+    "Run",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/callbacks/tracers/stdout.py b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/stdout.py
new file mode 100644
index 0000000000000000000000000000000000000000..b2ef6fdcfeccac832f4c6c6159238be01bd537b1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/callbacks/tracers/stdout.py
@@ -0,0 +1,13 @@
+from langchain_core.tracers.stdout import (
+    ConsoleCallbackHandler,
+    FunctionCallbackHandler,
+    elapsed,
+    try_json_stringify,
+)
+
+__all__ = [
+    "try_json_stringify",
+    "elapsed",
+    "FunctionCallbackHandler",
+    "ConsoleCallbackHandler",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/chat.py b/llm/Lib/site-packages/langchain/schema/chat.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f9080f8f372ad16c3a1fe3d7bc61896802d2eda
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/chat.py
@@ -0,0 +1,3 @@
+from langchain_core.chat_sessions import ChatSession
+
+__all__ = ["ChatSession"]
diff --git a/llm/Lib/site-packages/langchain/schema/chat_history.py b/llm/Lib/site-packages/langchain/schema/chat_history.py
new file mode 100644
index 0000000000000000000000000000000000000000..08dcffe47ec6086a32f4706e9ee70df70ef8f06d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/chat_history.py
@@ -0,0 +1,3 @@
+from langchain_core.chat_history import BaseChatMessageHistory
+
+__all__ = ["BaseChatMessageHistory"]
diff --git a/llm/Lib/site-packages/langchain/schema/document.py b/llm/Lib/site-packages/langchain/schema/document.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b5b254be953a437abfaaacd284c6a0c54b90e78
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/document.py
@@ -0,0 +1,3 @@
+from langchain_core.documents import BaseDocumentTransformer, Document
+
+__all__ = ["Document", "BaseDocumentTransformer"]
diff --git a/llm/Lib/site-packages/langchain/schema/embeddings.py b/llm/Lib/site-packages/langchain/schema/embeddings.py
new file mode 100644
index 0000000000000000000000000000000000000000..dd38b6276e1b8411176a950b40ff7668ade9e097
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/embeddings.py
@@ -0,0 +1,3 @@
+from langchain_core.embeddings import Embeddings
+
+__all__ = ["Embeddings"]
diff --git a/llm/Lib/site-packages/langchain/schema/exceptions.py b/llm/Lib/site-packages/langchain/schema/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..a26216c688b51c81dbf568eec41532a50906becb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/exceptions.py
@@ -0,0 +1,3 @@
+from langchain_core.exceptions import LangChainException
+
+__all__ = ["LangChainException"]
diff --git a/llm/Lib/site-packages/langchain/schema/language_model.py b/llm/Lib/site-packages/langchain/schema/language_model.py
new file mode 100644
index 0000000000000000000000000000000000000000..63a0292bed8b24cb0d23c459f71158ab2d74c0f4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/language_model.py
@@ -0,0 +1,15 @@
+from langchain_core.language_models import (
+    BaseLanguageModel,
+    LanguageModelInput,
+    LanguageModelOutput,
+    get_tokenizer,
+)
+from langchain_core.language_models.base import _get_token_ids_default_method
+
+__all__ = [
+    "get_tokenizer",
+    "BaseLanguageModel",
+    "_get_token_ids_default_method",
+    "LanguageModelInput",
+    "LanguageModelOutput",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/memory.py b/llm/Lib/site-packages/langchain/schema/memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..d2f3d73e6138ee580ebee1aa0f23bc37f325de5e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/memory.py
@@ -0,0 +1,3 @@
+from langchain_core.memory import BaseMemory
+
+__all__ = ["BaseMemory"]
diff --git a/llm/Lib/site-packages/langchain/schema/messages.py b/llm/Lib/site-packages/langchain/schema/messages.py
new file mode 100644
index 0000000000000000000000000000000000000000..2c42e6091e5480983dfed0d7230107f5a892623e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/messages.py
@@ -0,0 +1,51 @@
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    AnyMessage,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    FunctionMessage,
+    FunctionMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+    SystemMessageChunk,
+    ToolMessage,
+    ToolMessageChunk,
+    _message_from_dict,
+    get_buffer_string,
+    merge_content,
+    message_to_dict,
+    messages_from_dict,
+    messages_to_dict,
+)
+
+# Backwards compatibility.
+_message_to_dict = message_to_dict
+
+__all__ = [
+    "get_buffer_string",
+    "BaseMessage",
+    "merge_content",
+    "BaseMessageChunk",
+    "HumanMessage",
+    "HumanMessageChunk",
+    "AIMessage",
+    "AIMessageChunk",
+    "SystemMessage",
+    "SystemMessageChunk",
+    "FunctionMessage",
+    "FunctionMessageChunk",
+    "ToolMessage",
+    "ToolMessageChunk",
+    "ChatMessage",
+    "ChatMessageChunk",
+    "messages_to_dict",
+    "messages_from_dict",
+    "_message_to_dict",
+    "_message_from_dict",
+    "message_to_dict",
+    "AnyMessage",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/output.py b/llm/Lib/site-packages/langchain/schema/output.py
new file mode 100644
index 0000000000000000000000000000000000000000..970986df560de60dd4dfec4de6593a5e19bb46f0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/output.py
@@ -0,0 +1,19 @@
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatGenerationChunk,
+    ChatResult,
+    Generation,
+    GenerationChunk,
+    LLMResult,
+    RunInfo,
+)
+
+__all__ = [
+    "Generation",
+    "GenerationChunk",
+    "ChatGeneration",
+    "ChatGenerationChunk",
+    "RunInfo",
+    "ChatResult",
+    "LLMResult",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/output_parser.py b/llm/Lib/site-packages/langchain/schema/output_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..b0d8e03a7b99022f1e77f1ac32ce08ee2b048ba1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/output_parser.py
@@ -0,0 +1,25 @@
+from langchain_core.exceptions import OutputParserException
+from langchain_core.output_parsers import (
+    BaseCumulativeTransformOutputParser,
+    BaseGenerationOutputParser,
+    BaseLLMOutputParser,
+    BaseOutputParser,
+    BaseTransformOutputParser,
+    StrOutputParser,
+)
+from langchain_core.output_parsers.base import T
+
+# Backwards compatibility.
+NoOpOutputParser = StrOutputParser
+
+__all__ = [
+    "BaseLLMOutputParser",
+    "BaseGenerationOutputParser",
+    "BaseOutputParser",
+    "BaseTransformOutputParser",
+    "BaseCumulativeTransformOutputParser",
+    "NoOpOutputParser",
+    "StrOutputParser",
+    "OutputParserException",
+    "T",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/prompt.py b/llm/Lib/site-packages/langchain/schema/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b3e3c444514f74e71f5c52287fc0c17f95c3223
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/prompt.py
@@ -0,0 +1,3 @@
+from langchain_core.prompt_values import PromptValue
+
+__all__ = ["PromptValue"]
diff --git a/llm/Lib/site-packages/langchain/schema/prompt_template.py b/llm/Lib/site-packages/langchain/schema/prompt_template.py
new file mode 100644
index 0000000000000000000000000000000000000000..49a3595b036dcee4f18f52aa6274effd39117e10
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/prompt_template.py
@@ -0,0 +1,3 @@
+from langchain_core.prompts import BasePromptTemplate, format_document
+
+__all__ = ["BasePromptTemplate", "format_document"]
diff --git a/llm/Lib/site-packages/langchain/schema/retriever.py b/llm/Lib/site-packages/langchain/schema/retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca795d341dd41c9f870cb94af76b400cf169ba5e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/retriever.py
@@ -0,0 +1,3 @@
+from langchain_core.retrievers import BaseRetriever
+
+__all__ = ["BaseRetriever"]
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/__init__.py b/llm/Lib/site-packages/langchain/schema/runnable/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3a1f555d1c889f9f08f8719f9bb7b2d1ab661037
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/runnable/__init__.py
@@ -0,0 +1,57 @@
+"""LangChain **Runnable** and the **LangChain Expression Language (LCEL)**.
+
+The LangChain Expression Language (LCEL) offers a declarative method to build
+production-grade programs that harness the power of LLMs.
+
+Programs created using LCEL and LangChain Runnables inherently support
+synchronous, asynchronous, batch, and streaming operations.
+
+Support for **async** allows servers hosting LCEL based programs to scale better
+for higher concurrent loads.
+
+**Streaming** of intermediate outputs as they're being generated allows for
+creating more responsive UX.
+
+This module contains schema and implementation of LangChain Runnables primitives.
+"""
+from langchain_core.runnables.base import (
+    Runnable,
+    RunnableBinding,
+    RunnableGenerator,
+    RunnableLambda,
+    RunnableMap,
+    RunnableParallel,
+    RunnableSequence,
+    RunnableSerializable,
+)
+from langchain_core.runnables.branch import RunnableBranch
+from langchain_core.runnables.config import RunnableConfig, patch_config
+from langchain_core.runnables.fallbacks import RunnableWithFallbacks
+from langchain_core.runnables.passthrough import RunnablePassthrough
+from langchain_core.runnables.router import RouterInput, RouterRunnable
+from langchain_core.runnables.utils import (
+    ConfigurableField,
+    ConfigurableFieldMultiOption,
+    ConfigurableFieldSingleOption,
+)
+
+__all__ = [
+    "ConfigurableField",
+    "ConfigurableFieldSingleOption",
+    "ConfigurableFieldMultiOption",
+    "patch_config",
+    "RouterInput",
+    "RouterRunnable",
+    "Runnable",
+    "RunnableSerializable",
+    "RunnableBinding",
+    "RunnableBranch",
+    "RunnableConfig",
+    "RunnableGenerator",
+    "RunnableLambda",
+    "RunnableMap",
+    "RunnableParallel",
+    "RunnablePassthrough",
+    "RunnableSequence",
+    "RunnableWithFallbacks",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7b123ee4e2c4cd459fbdbc8ae8cb6c9a1ff98f72
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6d850ec0375cfc64d7acc1178cb1476d4ce69412
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/branch.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/branch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1815d37a171ce9b834e4f8149f74d631fbbd3b66
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/branch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/config.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/config.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a990a838318e96e57a386b75db05892f271c65a6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/config.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/configurable.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/configurable.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d13f48f64541180851570e221b35aa78ad04240b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/configurable.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/fallbacks.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/fallbacks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..714f52cde7af16d3b800dce8605075b4c7190b1d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/fallbacks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/history.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/history.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6429be86781a641402e9745689769dd5523e27d1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/history.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/passthrough.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/passthrough.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2c00d5d0a35636b91339d80e5a6a33418ac780e4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/passthrough.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/retry.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/retry.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9dc8e45f1484d508c88858710bdb693afc56c29a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/retry.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/router.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/router.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..588aa684ca8a65cd7876a687b12e32f91cdee673
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/router.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e0472a516c0b907324b176d5ce8e5a1e53d6e8fb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/schema/runnable/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/base.py b/llm/Lib/site-packages/langchain/schema/runnable/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..c9bde22100f1371549cac67f0e913ef29f156349
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/runnable/base.py
@@ -0,0 +1,38 @@
+from langchain_core.runnables.base import (
+    Other,
+    Runnable,
+    RunnableBinding,
+    RunnableBindingBase,
+    RunnableEach,
+    RunnableEachBase,
+    RunnableGenerator,
+    RunnableLambda,
+    RunnableLike,
+    RunnableParallel,
+    RunnableSequence,
+    RunnableSerializable,
+    coerce_to_runnable,
+)
+from langchain_core.runnables.utils import Input, Output
+
+# Backwards compatibility.
+RunnableMap = RunnableParallel
+
+__all__ = [
+    "Input",
+    "Output",
+    "RunnableLike",
+    "Other",
+    "Runnable",
+    "RunnableSerializable",
+    "RunnableSequence",
+    "RunnableParallel",
+    "RunnableGenerator",
+    "RunnableLambda",
+    "RunnableEachBase",
+    "RunnableEach",
+    "RunnableBindingBase",
+    "RunnableBinding",
+    "RunnableMap",
+    "coerce_to_runnable",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/branch.py b/llm/Lib/site-packages/langchain/schema/runnable/branch.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed83f197aa0b3aa94a63a01a1dd690fbdd1cb2f2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/runnable/branch.py
@@ -0,0 +1,3 @@
+from langchain_core.runnables.branch import RunnableBranch
+
+__all__ = ["RunnableBranch"]
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/config.py b/llm/Lib/site-packages/langchain/schema/runnable/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..af0179f9755f86e24c6618bcab92ed7011eb8188
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/runnable/config.py
@@ -0,0 +1,27 @@
+from langchain_core.runnables.config import (
+    EmptyDict,
+    RunnableConfig,
+    acall_func_with_variable_args,
+    call_func_with_variable_args,
+    ensure_config,
+    get_async_callback_manager_for_config,
+    get_callback_manager_for_config,
+    get_config_list,
+    get_executor_for_config,
+    merge_configs,
+    patch_config,
+)
+
+__all__ = [
+    "EmptyDict",
+    "RunnableConfig",
+    "ensure_config",
+    "get_config_list",
+    "patch_config",
+    "merge_configs",
+    "acall_func_with_variable_args",
+    "call_func_with_variable_args",
+    "get_callback_manager_for_config",
+    "get_async_callback_manager_for_config",
+    "get_executor_for_config",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/configurable.py b/llm/Lib/site-packages/langchain/schema/runnable/configurable.py
new file mode 100644
index 0000000000000000000000000000000000000000..a1463d57466c60a1b265e44331eefa0275766a4d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/runnable/configurable.py
@@ -0,0 +1,15 @@
+from langchain_core.runnables.configurable import (
+    DynamicRunnable,
+    RunnableConfigurableAlternatives,
+    RunnableConfigurableFields,
+    StrEnum,
+    make_options_spec,
+)
+
+__all__ = [
+    "DynamicRunnable",
+    "RunnableConfigurableFields",
+    "StrEnum",
+    "RunnableConfigurableAlternatives",
+    "make_options_spec",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/fallbacks.py b/llm/Lib/site-packages/langchain/schema/runnable/fallbacks.py
new file mode 100644
index 0000000000000000000000000000000000000000..7a54468d77487aaf411575125ea566ca49268ac8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/runnable/fallbacks.py
@@ -0,0 +1,3 @@
+from langchain_core.runnables.fallbacks import RunnableWithFallbacks
+
+__all__ = ["RunnableWithFallbacks"]
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/history.py b/llm/Lib/site-packages/langchain/schema/runnable/history.py
new file mode 100644
index 0000000000000000000000000000000000000000..423b192be685e1ac1a55aca946f8c9a73bde8e18
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/runnable/history.py
@@ -0,0 +1,11 @@
+from langchain_core.runnables.history import (
+    GetSessionHistoryCallable,
+    MessagesOrDictWithMessages,
+    RunnableWithMessageHistory,
+)
+
+__all__ = [
+    "RunnableWithMessageHistory",
+    "GetSessionHistoryCallable",
+    "MessagesOrDictWithMessages",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/passthrough.py b/llm/Lib/site-packages/langchain/schema/runnable/passthrough.py
new file mode 100644
index 0000000000000000000000000000000000000000..aed683d3843cbde0cac6c151772bad0d40d8ae50
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/runnable/passthrough.py
@@ -0,0 +1,8 @@
+from langchain_core.runnables.passthrough import (
+    RunnableAssign,
+    RunnablePassthrough,
+    aidentity,
+    identity,
+)
+
+__all__ = ["aidentity", "identity", "RunnablePassthrough", "RunnableAssign"]
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/retry.py b/llm/Lib/site-packages/langchain/schema/runnable/retry.py
new file mode 100644
index 0000000000000000000000000000000000000000..d146c8ec5c2df3bb557dae635ce514a35e3677e5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/runnable/retry.py
@@ -0,0 +1,3 @@
+from langchain_core.runnables.retry import RunnableRetry, U
+
+__all__ = ["RunnableRetry", "U"]
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/router.py b/llm/Lib/site-packages/langchain/schema/runnable/router.py
new file mode 100644
index 0000000000000000000000000000000000000000..259dd677c988d8a4e7ff8b836283eb79247c6d19
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/runnable/router.py
@@ -0,0 +1,3 @@
+from langchain_core.runnables.router import RouterInput, RouterRunnable
+
+__all__ = ["RouterInput", "RouterRunnable"]
diff --git a/llm/Lib/site-packages/langchain/schema/runnable/utils.py b/llm/Lib/site-packages/langchain/schema/runnable/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a03a6afbc3b1fae65a3becb9c90b2975ce25b98
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/runnable/utils.py
@@ -0,0 +1,51 @@
+from langchain_core.runnables.utils import (
+    Addable,
+    AddableDict,
+    AnyConfigurableField,
+    ConfigurableField,
+    ConfigurableFieldMultiOption,
+    ConfigurableFieldSingleOption,
+    ConfigurableFieldSpec,
+    GetLambdaSource,
+    Input,
+    IsFunctionArgDict,
+    IsLocalDict,
+    Output,
+    SupportsAdd,
+    aadd,
+    accepts_config,
+    accepts_run_manager,
+    add,
+    gated_coro,
+    gather_with_concurrency,
+    get_function_first_arg_dict_keys,
+    get_lambda_source,
+    get_unique_config_specs,
+    indent_lines_after_first,
+)
+
+__all__ = [
+    "accepts_run_manager",
+    "accepts_config",
+    "IsLocalDict",
+    "IsFunctionArgDict",
+    "GetLambdaSource",
+    "get_function_first_arg_dict_keys",
+    "get_lambda_source",
+    "indent_lines_after_first",
+    "AddableDict",
+    "SupportsAdd",
+    "add",
+    "ConfigurableField",
+    "ConfigurableFieldSingleOption",
+    "ConfigurableFieldMultiOption",
+    "ConfigurableFieldSpec",
+    "get_unique_config_specs",
+    "aadd",
+    "gated_coro",
+    "gather_with_concurrency",
+    "Input",
+    "Output",
+    "Addable",
+    "AnyConfigurableField",
+]
diff --git a/llm/Lib/site-packages/langchain/schema/storage.py b/llm/Lib/site-packages/langchain/schema/storage.py
new file mode 100644
index 0000000000000000000000000000000000000000..70d6925a4fd28717ae3da52e8cde8a0e8bb9f590
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/storage.py
@@ -0,0 +1,3 @@
+from langchain_core.stores import BaseStore, K, V
+
+__all__ = ["BaseStore", "K", "V"]
diff --git a/llm/Lib/site-packages/langchain/schema/vectorstore.py b/llm/Lib/site-packages/langchain/schema/vectorstore.py
new file mode 100644
index 0000000000000000000000000000000000000000..776dbce00dcab1d733860a6f93fc4de2bedb8ab2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/schema/vectorstore.py
@@ -0,0 +1,3 @@
+from langchain_core.vectorstores import VST, VectorStore, VectorStoreRetriever
+
+__all__ = ["VectorStore", "VectorStoreRetriever", "VST"]
diff --git a/llm/Lib/site-packages/langchain/serpapi.py b/llm/Lib/site-packages/langchain/serpapi.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b3dd24885d35082fad8401892c1080ed3406796
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/serpapi.py
@@ -0,0 +1,4 @@
+"""For backwards compatibility."""
+from langchain_community.utilities.serpapi import SerpAPIWrapper
+
+__all__ = ["SerpAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/smith/__init__.py b/llm/Lib/site-packages/langchain/smith/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c32dfc024e097c664c52faf44933f21affca2c09
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/smith/__init__.py
@@ -0,0 +1,101 @@
+"""**LangSmith** utilities.
+
+This module provides utilities for connecting to `LangSmith <https://smith.langchain.com/>`_. For more information on LangSmith, see the `LangSmith documentation <https://docs.smith.langchain.com/>`_.
+
+**Evaluation**
+
+LangSmith helps you evaluate Chains and other language model application components using a number of LangChain evaluators.
+An example of this is shown below, assuming you've created a LangSmith dataset called ``<my_dataset_name>``:
+
+.. code-block:: python
+
+    from langsmith import Client
+    from langchain_community.chat_models import ChatOpenAI
+    from langchain.chains import LLMChain
+    from langchain.smith import RunEvalConfig, run_on_dataset
+
+    # Chains may have memory. Passing in a constructor function lets the
+    # evaluation framework avoid cross-contamination between runs.
+    def construct_chain():
+        llm = ChatOpenAI(temperature=0)
+        chain = LLMChain.from_string(
+            llm,
+            "What's the answer to {your_input_key}"
+        )
+        return chain
+
+    # Load off-the-shelf evaluators via config or the EvaluatorType (string or enum)
+    evaluation_config = RunEvalConfig(
+        evaluators=[
+            "qa",  # "Correctness" against a reference answer
+            "embedding_distance",
+            RunEvalConfig.Criteria("helpfulness"),
+            RunEvalConfig.Criteria({
+                "fifth-grader-score": "Do you have to be smarter than a fifth grader to answer this question?"
+            }),
+        ]
+    )
+
+    client = Client()
+    run_on_dataset(
+        client,
+        "<my_dataset_name>",
+        construct_chain,
+        evaluation=evaluation_config,
+    )
+
+You can also create custom evaluators by subclassing the
+:class:`StringEvaluator <langchain.evaluation.schema.StringEvaluator>`
+or LangSmith's `RunEvaluator` classes.
+
+.. code-block:: python
+
+    from typing import Optional
+    from langchain.evaluation import StringEvaluator
+
+    class MyStringEvaluator(StringEvaluator):
+        
+        @property
+        def requires_input(self) -> bool:
+            return False
+        
+        @property
+        def requires_reference(self) -> bool:
+            return True
+        
+        @property
+        def evaluation_name(self) -> str:
+            return "exact_match"
+        
+        def _evaluate_strings(self, prediction, reference=None, input=None, **kwargs) -> dict:
+            return {"score": prediction == reference}
+
+
+    evaluation_config = RunEvalConfig(
+        custom_evaluators = [MyStringEvaluator()],
+    )
+
+    run_on_dataset(
+        client,
+        "<my_dataset_name>",
+        construct_chain,
+        evaluation=evaluation_config,
+    )    
+
+**Primary Functions**
+
+- :func:`arun_on_dataset <langchain.smith.evaluation.runner_utils.arun_on_dataset>`: Asynchronous function to evaluate a chain, agent, or other LangChain component over a dataset.
+- :func:`run_on_dataset <langchain.smith.evaluation.runner_utils.run_on_dataset>`: Function to evaluate a chain, agent, or other LangChain component over a dataset.
+- :class:`RunEvalConfig <langchain.smith.evaluation.config.RunEvalConfig>`: Class representing the configuration for running evaluation. You can select evaluators by :class:`EvaluatorType <langchain.evaluation.schema.EvaluatorType>` or config, or you can pass in `custom_evaluators`
+"""  # noqa: E501
+from langchain.smith.evaluation import (
+    RunEvalConfig,
+    arun_on_dataset,
+    run_on_dataset,
+)
+
+__all__ = [
+    "arun_on_dataset",
+    "run_on_dataset",
+    "RunEvalConfig",
+]
diff --git a/llm/Lib/site-packages/langchain/smith/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/smith/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b8d488d050061d081666365bda6dd71a81f5bc86
Binary files /dev/null and b/llm/Lib/site-packages/langchain/smith/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/__init__.py b/llm/Lib/site-packages/langchain/smith/evaluation/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7d2c172dfb93d08c5d0a01b974b11d0dadb8e511
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/smith/evaluation/__init__.py
@@ -0,0 +1,69 @@
+"""LangSmith evaluation utilities.
+
+This module provides utilities for evaluating Chains and other language model
+applications using LangChain evaluators and LangSmith.
+
+For more information on the LangSmith API, see the `LangSmith API documentation <https://docs.smith.langchain.com/docs/>`_.
+
+**Example**
+
+.. code-block:: python
+
+    from langsmith import Client
+    from langchain_community.chat_models import ChatOpenAI
+    from langchain.chains import LLMChain
+    from langchain.smith import EvaluatorType, RunEvalConfig, run_on_dataset
+
+    def construct_chain():
+        llm = ChatOpenAI(temperature=0)
+        chain = LLMChain.from_string(
+            llm,
+            "What's the answer to {your_input_key}"
+        )
+        return chain
+
+    evaluation_config = RunEvalConfig(
+        evaluators=[
+            EvaluatorType.QA,  # "Correctness" against a reference answer
+            EvaluatorType.EMBEDDING_DISTANCE,
+            RunEvalConfig.Criteria("helpfulness"),
+            RunEvalConfig.Criteria({
+                "fifth-grader-score": "Do you have to be smarter than a fifth grader to answer this question?"
+            }),
+        ]
+    )
+
+    client = Client()
+    run_on_dataset(
+        client,
+        "<my_dataset_name>",
+        construct_chain,
+        evaluation=evaluation_config
+    )
+
+**Attributes**
+
+- ``arun_on_dataset``: Asynchronous function to evaluate a chain or other LangChain component over a dataset.
+- ``run_on_dataset``: Function to evaluate a chain or other LangChain component over a dataset.
+- ``RunEvalConfig``: Class representing the configuration for running evaluation.
+- ``StringRunEvaluatorChain``: Class representing a string run evaluator chain.
+- ``InputFormatError``: Exception raised when the input format is incorrect.
+
+"""  # noqa: E501
+
+
+from langchain.smith.evaluation.config import RunEvalConfig
+from langchain.smith.evaluation.runner_utils import (
+    InputFormatError,
+    arun_on_dataset,
+    run_on_dataset,
+)
+from langchain.smith.evaluation.string_run_evaluator import StringRunEvaluatorChain
+
+__all__ = [
+    "InputFormatError",
+    "arun_on_dataset",
+    "run_on_dataset",
+    "StringRunEvaluatorChain",
+    "RunEvalConfig",
+]
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b6d871c234bd6a6ff109c356f09ab911d6f3709f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/config.cpython-311.pyc b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/config.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5174fea6f290d194a88d69aa4a3831551e50520a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/config.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/name_generation.cpython-311.pyc b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/name_generation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f4719e577ad2af5ebb537f08340153eee944d6d1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/name_generation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/progress.cpython-311.pyc b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/progress.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7673dce20bd2680e4c4ad44deb687d4b05cabc21
Binary files /dev/null and b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/progress.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/runner_utils.cpython-311.pyc b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/runner_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8953d8ffba7d223e77237ca0d941fa9ab07863a3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/runner_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/string_run_evaluator.cpython-311.pyc b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/string_run_evaluator.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..33bea8fd3e5a5dc000ab7554af1e9c03584d65ad
Binary files /dev/null and b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/string_run_evaluator.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1ed421bf5bb39e5bfea31a12af9e0f6b13dbe842
Binary files /dev/null and b/llm/Lib/site-packages/langchain/smith/evaluation/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/config.py b/llm/Lib/site-packages/langchain/smith/evaluation/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..d73bba22624bb3777eee3033fc688b33b004264f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/smith/evaluation/config.py
@@ -0,0 +1,376 @@
+"""Configuration for run evaluators."""
+
+from typing import Any, Callable, Dict, List, Optional, Sequence, Union
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langsmith import RunEvaluator
+from langsmith.evaluation.evaluator import EvaluationResult, EvaluationResults
+from langsmith.schemas import Example, Run
+
+from langchain.evaluation.criteria.eval_chain import CRITERIA_TYPE
+from langchain.evaluation.embedding_distance.base import (
+    EmbeddingDistance as EmbeddingDistanceEnum,
+)
+from langchain.evaluation.schema import EvaluatorType, StringEvaluator
+from langchain.evaluation.string_distance.base import (
+    StringDistance as StringDistanceEnum,
+)
+
+RUN_EVALUATOR_LIKE = Callable[
+    [Run, Optional[Example]], Union[EvaluationResult, EvaluationResults, dict]
+]
+BATCH_EVALUATOR_LIKE = Callable[
+    [Sequence[Run], Optional[Sequence[Example]]],
+    Union[EvaluationResult, EvaluationResults, dict],
+]
+
+
+class EvalConfig(BaseModel):
+    """Configuration for a given run evaluator.
+
+    Parameters
+    ----------
+    evaluator_type : EvaluatorType
+        The type of evaluator to use.
+
+    Methods
+    -------
+    get_kwargs()
+        Get the keyword arguments for the evaluator configuration.
+
+    """
+
+    evaluator_type: EvaluatorType
+
+    def get_kwargs(self) -> Dict[str, Any]:
+        """Get the keyword arguments for the load_evaluator call.
+
+        Returns
+        -------
+        Dict[str, Any]
+            The keyword arguments for the load_evaluator call.
+
+        """
+        kwargs = {}
+        for field, val in self:
+            if field == "evaluator_type":
+                continue
+            elif val is None:
+                continue
+            kwargs[field] = val
+        return kwargs
+
+
+class SingleKeyEvalConfig(EvalConfig):
+    """Configuration for a run evaluator that only requires a single key."""
+
+    reference_key: Optional[str] = None
+    """The key in the dataset run to use as the reference string.
+    If not provided, we will attempt to infer automatically."""
+    prediction_key: Optional[str] = None
+    """The key from the traced run's outputs dictionary to use to
+    represent the prediction. If not provided, it will be inferred
+    automatically."""
+    input_key: Optional[str] = None
+    """The key from the traced run's inputs dictionary to use to represent the
+    input. If not provided, it will be inferred automatically."""
+
+    def get_kwargs(self) -> Dict[str, Any]:
+        kwargs = super().get_kwargs()
+        # Filer out the keys that are not needed for the evaluator.
+        for key in ["reference_key", "prediction_key", "input_key"]:
+            kwargs.pop(key, None)
+        return kwargs
+
+
+CUSTOM_EVALUATOR_TYPE = Union[RUN_EVALUATOR_LIKE, RunEvaluator, StringEvaluator]
+SINGLE_EVAL_CONFIG_TYPE = Union[EvaluatorType, str, EvalConfig]
+
+
+class RunEvalConfig(BaseModel):
+    """Configuration for a run evaluation.
+
+    Parameters
+    ----------
+    evaluators : List[Union[EvaluatorType, EvalConfig, RunEvaluator, Callable]]
+        Configurations for which evaluators to apply to the dataset run.
+        Each can be the string of an :class:`EvaluatorType <langchain.evaluation.schema.EvaluatorType>`, such
+        as EvaluatorType.QA, the evaluator type string ("qa"), or a configuration for a
+        given evaluator (e.g., :class:`RunEvalConfig.QA <langchain.smith.evaluation.config.RunEvalConfig.QA>`).
+
+    custom_evaluators : Optional[List[Union[RunEvaluator, StringEvaluator]]]
+        Custom evaluators to apply to the dataset run.
+
+    reference_key : Optional[str]
+        The key in the dataset run to use as the reference string.
+        If not provided, it will be inferred automatically.
+
+    prediction_key : Optional[str]
+        The key from the traced run's outputs dictionary to use to
+        represent the prediction. If not provided, it will be inferred
+        automatically.
+
+    input_key : Optional[str]
+        The key from the traced run's inputs dictionary to use to represent the
+        input. If not provided, it will be inferred automatically.
+
+    eval_llm : Optional[BaseLanguageModel]
+        The language model to pass to any evaluators that use a language model.
+    """  # noqa: E501
+
+    evaluators: List[
+        Union[
+            SINGLE_EVAL_CONFIG_TYPE,
+            CUSTOM_EVALUATOR_TYPE,
+        ]
+    ] = Field(default_factory=list)
+    """Configurations for which evaluators to apply to the dataset run.
+    Each can be the string of an
+    :class:`EvaluatorType <langchain.evaluation.schema.EvaluatorType>`, such
+    as `EvaluatorType.QA`, the evaluator type string ("qa"), or a configuration for a
+    given evaluator
+    (e.g., 
+    :class:`RunEvalConfig.QA <langchain.smith.evaluation.config.RunEvalConfig.QA>`)."""  # noqa: E501
+    custom_evaluators: Optional[List[CUSTOM_EVALUATOR_TYPE]] = None
+    """Custom evaluators to apply to the dataset run."""
+    batch_evaluators: Optional[List[BATCH_EVALUATOR_LIKE]] = None
+    """Evaluators that run on an aggregate/batch level.
+
+    These generate 1 or more metrics that are assigned to the full test run.
+    As a result, they are not associated with individual traces.
+    """
+
+    reference_key: Optional[str] = None
+    """The key in the dataset run to use as the reference string.
+    If not provided, we will attempt to infer automatically."""
+    prediction_key: Optional[str] = None
+    """The key from the traced run's outputs dictionary to use to
+    represent the prediction. If not provided, it will be inferred
+    automatically."""
+    input_key: Optional[str] = None
+    """The key from the traced run's inputs dictionary to use to represent the
+    input. If not provided, it will be inferred automatically."""
+    eval_llm: Optional[BaseLanguageModel] = None
+    """The language model to pass to any evaluators that require one."""
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    class Criteria(SingleKeyEvalConfig):
+        """Configuration for a reference-free criteria evaluator.
+
+        Parameters
+        ----------
+        criteria : Optional[CRITERIA_TYPE]
+            The criteria to evaluate.
+        llm : Optional[BaseLanguageModel]
+            The language model to use for the evaluation chain.
+
+        """
+
+        criteria: Optional[CRITERIA_TYPE] = None
+        llm: Optional[BaseLanguageModel] = None
+        evaluator_type: EvaluatorType = EvaluatorType.CRITERIA
+
+        def __init__(
+            self, criteria: Optional[CRITERIA_TYPE] = None, **kwargs: Any
+        ) -> None:
+            super().__init__(criteria=criteria, **kwargs)  # type: ignore[call-arg]
+
+    class LabeledCriteria(SingleKeyEvalConfig):
+        """Configuration for a labeled (with references) criteria evaluator.
+
+        Parameters
+        ----------
+        criteria : Optional[CRITERIA_TYPE]
+            The criteria to evaluate.
+        llm : Optional[BaseLanguageModel]
+            The language model to use for the evaluation chain.
+        """
+
+        criteria: Optional[CRITERIA_TYPE] = None
+        llm: Optional[BaseLanguageModel] = None
+        evaluator_type: EvaluatorType = EvaluatorType.LABELED_CRITERIA
+
+        def __init__(
+            self, criteria: Optional[CRITERIA_TYPE] = None, **kwargs: Any
+        ) -> None:
+            super().__init__(criteria=criteria, **kwargs)  # type: ignore[call-arg]
+
+    class EmbeddingDistance(SingleKeyEvalConfig):
+        """Configuration for an embedding distance evaluator.
+
+        Parameters
+        ----------
+        embeddings : Optional[Embeddings]
+            The embeddings to use for computing the distance.
+
+        distance_metric : Optional[EmbeddingDistanceEnum]
+            The distance metric to use for computing the distance.
+
+        """
+
+        evaluator_type: EvaluatorType = EvaluatorType.EMBEDDING_DISTANCE
+        embeddings: Optional[Embeddings] = None
+        distance_metric: Optional[EmbeddingDistanceEnum] = None
+
+        class Config:
+            arbitrary_types_allowed = True
+
+    class StringDistance(SingleKeyEvalConfig):
+        """Configuration for a string distance evaluator.
+
+        Parameters
+        ----------
+        distance : Optional[StringDistanceEnum]
+            The string distance metric to use.
+
+        """
+
+        evaluator_type: EvaluatorType = EvaluatorType.STRING_DISTANCE
+        distance: Optional[StringDistanceEnum] = None
+        """The string distance metric to use.
+            damerau_levenshtein: The Damerau-Levenshtein distance.
+            levenshtein: The Levenshtein distance.
+            jaro: The Jaro distance.
+            jaro_winkler: The Jaro-Winkler distance.
+        """
+        normalize_score: bool = True
+        """Whether to normalize the distance to between 0 and 1.
+        Applies only to the Levenshtein and Damerau-Levenshtein distances."""
+
+    class QA(SingleKeyEvalConfig):
+        """Configuration for a QA evaluator.
+
+        Parameters
+        ----------
+        prompt : Optional[BasePromptTemplate]
+            The prompt template to use for generating the question.
+        llm : Optional[BaseLanguageModel]
+            The language model to use for the evaluation chain.
+        """
+
+        evaluator_type: EvaluatorType = EvaluatorType.QA
+        llm: Optional[BaseLanguageModel] = None
+        prompt: Optional[BasePromptTemplate] = None
+
+    class ContextQA(SingleKeyEvalConfig):
+        """Configuration for a context-based QA evaluator.
+
+        Parameters
+        ----------
+        prompt : Optional[BasePromptTemplate]
+            The prompt template to use for generating the question.
+        llm : Optional[BaseLanguageModel]
+            The language model to use for the evaluation chain.
+
+        """
+
+        evaluator_type: EvaluatorType = EvaluatorType.CONTEXT_QA
+        llm: Optional[BaseLanguageModel] = None
+        prompt: Optional[BasePromptTemplate] = None
+
+    class CoTQA(SingleKeyEvalConfig):
+        """Configuration for a context-based QA evaluator.
+
+        Parameters
+        ----------
+        prompt : Optional[BasePromptTemplate]
+            The prompt template to use for generating the question.
+        llm : Optional[BaseLanguageModel]
+            The language model to use for the evaluation chain.
+
+        """
+
+        evaluator_type: EvaluatorType = EvaluatorType.CONTEXT_QA
+        llm: Optional[BaseLanguageModel] = None
+        prompt: Optional[BasePromptTemplate] = None
+
+    class JsonValidity(SingleKeyEvalConfig):
+        """Configuration for a json validity evaluator.
+
+        Parameters
+        ----------
+        """
+
+        evaluator_type: EvaluatorType = EvaluatorType.JSON_VALIDITY
+
+    class JsonEqualityEvaluator(EvalConfig):
+        """Configuration for a json equality evaluator.
+
+        Parameters
+        ----------
+        """
+
+        evaluator_type: EvaluatorType = EvaluatorType.JSON_EQUALITY
+
+    class ExactMatch(SingleKeyEvalConfig):
+        """Configuration for an exact match string evaluator.
+
+        Parameters
+        ----------
+        ignore_case : bool
+            Whether to ignore case when comparing strings.
+        ignore_punctuation : bool
+            Whether to ignore punctuation when comparing strings.
+        ignore_numbers : bool
+            Whether to ignore numbers when comparing strings.
+        """
+
+        evaluator_type: EvaluatorType = EvaluatorType.EXACT_MATCH
+        ignore_case: bool = False
+        ignore_punctuation: bool = False
+        ignore_numbers: bool = False
+
+    class RegexMatch(SingleKeyEvalConfig):
+        """Configuration for a regex match string evaluator.
+
+        Parameters
+        ----------
+        flags : int
+            The flags to pass to the regex. Example: re.IGNORECASE.
+        """
+
+        evaluator_type: EvaluatorType = EvaluatorType.REGEX_MATCH
+        flags: int = 0
+
+    class ScoreString(SingleKeyEvalConfig):
+        """Configuration for a score string evaluator.
+        This is like the criteria evaluator but it is configured by
+        default to return a score on the scale from 1-10.
+
+        It is recommended to normalize these scores
+        by setting `normalize_by` to 10.
+
+        Parameters
+        ----------
+        criteria : Optional[CRITERIA_TYPE]
+            The criteria to evaluate.
+        llm : Optional[BaseLanguageModel]
+            The language model to use for the evaluation chain.
+        normalize_by: Optional[int] = None
+            If you want to normalize the score, the denominator to use.
+            If not provided, the score will be between 1 and 10 (by default).
+        prompt : Optional[BasePromptTemplate]
+
+        """
+
+        evaluator_type: EvaluatorType = EvaluatorType.SCORE_STRING
+        criteria: Optional[CRITERIA_TYPE] = None
+        llm: Optional[BaseLanguageModel] = None
+        normalize_by: Optional[float] = None
+        prompt: Optional[BasePromptTemplate] = None
+
+        def __init__(
+            self,
+            criteria: Optional[CRITERIA_TYPE] = None,
+            normalize_by: Optional[float] = None,
+            **kwargs: Any,
+        ) -> None:
+            super().__init__(criteria=criteria, normalize_by=normalize_by, **kwargs)  # type: ignore[call-arg]
+
+    class LabeledScoreString(ScoreString):
+        evaluator_type: EvaluatorType = EvaluatorType.LABELED_SCORE_STRING
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/name_generation.py b/llm/Lib/site-packages/langchain/smith/evaluation/name_generation.py
new file mode 100644
index 0000000000000000000000000000000000000000..191c74632fef95b02c05acb639b13eabc39c6648
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/smith/evaluation/name_generation.py
@@ -0,0 +1,727 @@
+import random
+
+adjectives = [
+    "abandoned",
+    "aching",
+    "advanced",
+    "ample",
+    "artistic",
+    "back",
+    "best",
+    "bold",
+    "brief",
+    "clear",
+    "cold",
+    "complicated",
+    "cooked",
+    "crazy",
+    "crushing",
+    "damp",
+    "dear",
+    "definite",
+    "dependable",
+    "diligent",
+    "drab",
+    "earnest",
+    "elderly",
+    "enchanted",
+    "essential",
+    "excellent",
+    "extraneous",
+    "fixed",
+    "flowery",
+    "formal",
+    "fresh",
+    "frosty",
+    "giving",
+    "glossy",
+    "healthy",
+    "helpful",
+    "impressionable",
+    "kind",
+    "large",
+    "left",
+    "long",
+    "loyal",
+    "mealy",
+    "memorable",
+    "monthly",
+    "new",
+    "notable",
+    "only",
+    "ordinary",
+    "passionate",
+    "perfect",
+    "pertinent",
+    "proper",
+    "puzzled",
+    "reflecting",
+    "respectful",
+    "roasted",
+    "scholarly",
+    "shiny",
+    "slight",
+    "sparkling",
+    "spotless",
+    "stupendous",
+    "sunny",
+    "tart",
+    "terrific",
+    "timely",
+    "unique",
+    "upbeat",
+    "vacant",
+    "virtual",
+    "warm",
+    "weary",
+    "whispered",
+    "worthwhile",
+    "yellow",
+]
+
+nouns = [
+    "account",
+    "acknowledgment",
+    "address",
+    "advertising",
+    "airplane",
+    "animal",
+    "appointment",
+    "arrival",
+    "artist",
+    "attachment",
+    "attitude",
+    "availability",
+    "backpack",
+    "bag",
+    "balance",
+    "bass",
+    "bean",
+    "beauty",
+    "bibliography",
+    "bill",
+    "bite",
+    "blossom",
+    "boat",
+    "book",
+    "box",
+    "boy",
+    "bread",
+    "bridge",
+    "broccoli",
+    "building",
+    "butter",
+    "button",
+    "cabbage",
+    "cake",
+    "camera",
+    "camp",
+    "candle",
+    "candy",
+    "canvas",
+    "car",
+    "card",
+    "carrot",
+    "cart",
+    "case",
+    "cat",
+    "chain",
+    "chair",
+    "chalk",
+    "chance",
+    "change",
+    "channel",
+    "character",
+    "charge",
+    "charm",
+    "chart",
+    "check",
+    "cheek",
+    "cheese",
+    "chef",
+    "cherry",
+    "chicken",
+    "child",
+    "church",
+    "circle",
+    "class",
+    "clay",
+    "click",
+    "clock",
+    "cloth",
+    "cloud",
+    "clove",
+    "club",
+    "coach",
+    "coal",
+    "coast",
+    "coat",
+    "cod",
+    "coffee",
+    "collar",
+    "color",
+    "comb",
+    "comfort",
+    "comic",
+    "committee",
+    "community",
+    "company",
+    "comparison",
+    "competition",
+    "condition",
+    "connection",
+    "control",
+    "cook",
+    "copper",
+    "copy",
+    "corn",
+    "cough",
+    "country",
+    "cover",
+    "crate",
+    "crayon",
+    "cream",
+    "creator",
+    "crew",
+    "crown",
+    "current",
+    "curtain",
+    "curve",
+    "cushion",
+    "dad",
+    "daughter",
+    "day",
+    "death",
+    "debt",
+    "decision",
+    "deer",
+    "degree",
+    "design",
+    "desire",
+    "desk",
+    "detail",
+    "development",
+    "digestion",
+    "dime",
+    "dinner",
+    "direction",
+    "dirt",
+    "discovery",
+    "discussion",
+    "disease",
+    "disgust",
+    "distance",
+    "distribution",
+    "division",
+    "doctor",
+    "dog",
+    "door",
+    "drain",
+    "drawer",
+    "dress",
+    "drink",
+    "driving",
+    "dust",
+    "ear",
+    "earth",
+    "edge",
+    "education",
+    "effect",
+    "egg",
+    "end",
+    "energy",
+    "engine",
+    "error",
+    "event",
+    "example",
+    "exchange",
+    "existence",
+    "expansion",
+    "experience",
+    "expert",
+    "eye",
+    "face",
+    "fact",
+    "fall",
+    "family",
+    "farm",
+    "father",
+    "fear",
+    "feeling",
+    "field",
+    "finger",
+    "fire",
+    "fish",
+    "flag",
+    "flight",
+    "floor",
+    "flower",
+    "fold",
+    "food",
+    "football",
+    "force",
+    "form",
+    "frame",
+    "friend",
+    "frog",
+    "fruit",
+    "fuel",
+    "furniture",
+    "game",
+    "garden",
+    "gate",
+    "girl",
+    "glass",
+    "glove",
+    "goat",
+    "gold",
+    "government",
+    "grade",
+    "grain",
+    "grass",
+    "green",
+    "grip",
+    "group",
+    "growth",
+    "guide",
+    "guitar",
+    "hair",
+    "hall",
+    "hand",
+    "harbor",
+    "harmony",
+    "hat",
+    "head",
+    "health",
+    "heart",
+    "heat",
+    "hill",
+    "history",
+    "hobbies",
+    "hole",
+    "hope",
+    "horn",
+    "horse",
+    "hospital",
+    "hour",
+    "house",
+    "humor",
+    "idea",
+    "impulse",
+    "income",
+    "increase",
+    "industry",
+    "ink",
+    "insect",
+    "instrument",
+    "insurance",
+    "interest",
+    "invention",
+    "iron",
+    "island",
+    "jelly",
+    "jet",
+    "jewel",
+    "join",
+    "judge",
+    "juice",
+    "jump",
+    "kettle",
+    "key",
+    "kick",
+    "kiss",
+    "kitten",
+    "knee",
+    "knife",
+    "knowledge",
+    "land",
+    "language",
+    "laugh",
+    "law",
+    "lead",
+    "learning",
+    "leather",
+    "leg",
+    "lettuce",
+    "level",
+    "library",
+    "lift",
+    "light",
+    "limit",
+    "line",
+    "linen",
+    "lip",
+    "liquid",
+    "list",
+    "look",
+    "loss",
+    "love",
+    "lunch",
+    "machine",
+    "man",
+    "manager",
+    "map",
+    "marble",
+    "mark",
+    "market",
+    "mass",
+    "match",
+    "meal",
+    "measure",
+    "meat",
+    "meeting",
+    "memory",
+    "metal",
+    "middle",
+    "milk",
+    "mind",
+    "mine",
+    "minute",
+    "mist",
+    "mitten",
+    "mom",
+    "money",
+    "monkey",
+    "month",
+    "moon",
+    "morning",
+    "mother",
+    "motion",
+    "mountain",
+    "mouth",
+    "muscle",
+    "music",
+    "nail",
+    "name",
+    "nation",
+    "neck",
+    "need",
+    "news",
+    "night",
+    "noise",
+    "note",
+    "number",
+    "nut",
+    "observation",
+    "offer",
+    "oil",
+    "operation",
+    "opinion",
+    "orange",
+    "order",
+    "organization",
+    "ornament",
+    "oven",
+    "page",
+    "pail",
+    "pain",
+    "paint",
+    "pan",
+    "pancake",
+    "paper",
+    "parcel",
+    "parent",
+    "part",
+    "passenger",
+    "paste",
+    "payment",
+    "peace",
+    "pear",
+    "pen",
+    "pencil",
+    "person",
+    "pest",
+    "pet",
+    "picture",
+    "pie",
+    "pin",
+    "pipe",
+    "pizza",
+    "place",
+    "plane",
+    "plant",
+    "plastic",
+    "plate",
+    "play",
+    "pleasure",
+    "plot",
+    "plough",
+    "pocket",
+    "point",
+    "poison",
+    "police",
+    "pollution",
+    "popcorn",
+    "porter",
+    "position",
+    "pot",
+    "potato",
+    "powder",
+    "power",
+    "price",
+    "print",
+    "process",
+    "produce",
+    "product",
+    "profit",
+    "property",
+    "prose",
+    "protest",
+    "pull",
+    "pump",
+    "punishment",
+    "purpose",
+    "push",
+    "quarter",
+    "question",
+    "quiet",
+    "quill",
+    "quilt",
+    "quince",
+    "rabbit",
+    "rail",
+    "rain",
+    "range",
+    "rat",
+    "rate",
+    "ray",
+    "reaction",
+    "reading",
+    "reason",
+    "record",
+    "regret",
+    "relation",
+    "religion",
+    "representative",
+    "request",
+    "respect",
+    "rest",
+    "reward",
+    "rhythm",
+    "rice",
+    "river",
+    "road",
+    "roll",
+    "room",
+    "root",
+    "rose",
+    "route",
+    "rub",
+    "rule",
+    "run",
+    "sack",
+    "sail",
+    "salt",
+    "sand",
+    "scale",
+    "scarecrow",
+    "scarf",
+    "scene",
+    "scent",
+    "school",
+    "science",
+    "scissors",
+    "screw",
+    "sea",
+    "seat",
+    "secretary",
+    "seed",
+    "selection",
+    "self",
+    "sense",
+    "servant",
+    "shade",
+    "shake",
+    "shame",
+    "shape",
+    "sheep",
+    "sheet",
+    "shelf",
+    "ship",
+    "shirt",
+    "shock",
+    "shoe",
+    "shop",
+    "show",
+    "side",
+    "sign",
+    "silk",
+    "sink",
+    "sister",
+    "size",
+    "sky",
+    "sleep",
+    "smash",
+    "smell",
+    "smile",
+    "smoke",
+    "snail",
+    "snake",
+    "sneeze",
+    "snow",
+    "soap",
+    "society",
+    "sock",
+    "soda",
+    "sofa",
+    "son",
+    "song",
+    "sort",
+    "sound",
+    "soup",
+    "space",
+    "spark",
+    "speed",
+    "sponge",
+    "spoon",
+    "spray",
+    "spring",
+    "spy",
+    "square",
+    "stamp",
+    "star",
+    "start",
+    "statement",
+    "station",
+    "steam",
+    "steel",
+    "stem",
+    "step",
+    "stew",
+    "stick",
+    "stitch",
+    "stocking",
+    "stomach",
+    "stone",
+    "stop",
+    "store",
+    "story",
+    "stove",
+    "stranger",
+    "straw",
+    "stream",
+    "street",
+    "stretch",
+    "string",
+    "structure",
+    "substance",
+    "sugar",
+    "suggestion",
+    "suit",
+    "summer",
+    "sun",
+    "support",
+    "surprise",
+    "sweater",
+    "swim",
+    "system",
+    "table",
+    "tail",
+    "talk",
+    "tank",
+    "taste",
+    "tax",
+    "tea",
+    "teaching",
+    "team",
+    "tendency",
+    "test",
+    "texture",
+    "theory",
+    "thing",
+    "thought",
+    "thread",
+    "throat",
+    "thumb",
+    "thunder",
+    "ticket",
+    "time",
+    "tin",
+    "title",
+    "toad",
+    "toe",
+    "tooth",
+    "toothpaste",
+    "touch",
+    "town",
+    "toy",
+    "trade",
+    "train",
+    "transport",
+    "tray",
+    "treatment",
+    "tree",
+    "trick",
+    "trip",
+    "trouble",
+    "trousers",
+    "truck",
+    "tub",
+    "turkey",
+    "turn",
+    "twist",
+    "umbrella",
+    "uncle",
+    "underwear",
+    "unit",
+    "use",
+    "vacation",
+    "value",
+    "van",
+    "vase",
+    "vegetable",
+    "veil",
+    "vein",
+    "verse",
+    "vessel",
+    "view",
+    "visitor",
+    "voice",
+    "volcano",
+    "walk",
+    "wall",
+    "war",
+    "wash",
+    "waste",
+    "watch",
+    "water",
+    "wave",
+    "wax",
+    "way",
+    "wealth",
+    "weather",
+    "week",
+    "weight",
+    "wheel",
+    "whip",
+    "whistle",
+    "window",
+    "wine",
+    "wing",
+    "winter",
+    "wire",
+    "wish",
+    "woman",
+    "wood",
+    "wool",
+    "word",
+    "work",
+    "worm",
+    "wound",
+    "wrist",
+    "writer",
+    "yard",
+    "yoke",
+    "zebra",
+    "zinc",
+    "zipper",
+    "zone",
+]
+
+
+def random_name() -> str:
+    """Generate a random name."""
+    adjective = random.choice(adjectives)
+    noun = random.choice(nouns)
+    number = random.randint(1, 100)
+    return f"{adjective}-{noun}-{number}"
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/progress.py b/llm/Lib/site-packages/langchain/smith/evaluation/progress.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc96b58272c15523e4470d8d115410a11d6b270d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/smith/evaluation/progress.py
@@ -0,0 +1,127 @@
+"""A simple progress bar for the console."""
+
+import threading
+from typing import Any, Dict, Optional, Sequence
+from uuid import UUID
+
+from langchain_core.callbacks import base as base_callbacks
+from langchain_core.documents import Document
+from langchain_core.outputs import LLMResult
+
+
+class ProgressBarCallback(base_callbacks.BaseCallbackHandler):
+    """A simple progress bar for the console."""
+
+    def __init__(self, total: int, ncols: int = 50, **kwargs: Any):
+        """Initialize the progress bar.
+
+        Args:
+            total: int, the total number of items to be processed.
+            ncols: int, the character width of the progress bar.
+        """
+        self.total = total
+        self.ncols = ncols
+        self.counter = 0
+        self.lock = threading.Lock()
+        self._print_bar()
+
+    def increment(self) -> None:
+        """Increment the counter and update the progress bar."""
+        with self.lock:
+            self.counter += 1
+            self._print_bar()
+
+    def _print_bar(self) -> None:
+        """Print the progress bar to the console."""
+        progress = self.counter / self.total
+        arrow = "-" * int(round(progress * self.ncols) - 1) + ">"
+        spaces = " " * (self.ncols - len(arrow))
+        print(f"\r[{arrow + spaces}] {self.counter}/{self.total}", end="")  # noqa: T201
+
+    def on_chain_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if parent_run_id is None:
+            self.increment()
+
+    def on_chain_end(
+        self,
+        outputs: Dict[str, Any],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if parent_run_id is None:
+            self.increment()
+
+    def on_retriever_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if parent_run_id is None:
+            self.increment()
+
+    def on_retriever_end(
+        self,
+        documents: Sequence[Document],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if parent_run_id is None:
+            self.increment()
+
+    def on_llm_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if parent_run_id is None:
+            self.increment()
+
+    def on_llm_end(
+        self,
+        response: LLMResult,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if parent_run_id is None:
+            self.increment()
+
+    def on_tool_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if parent_run_id is None:
+            self.increment()
+
+    def on_tool_end(
+        self,
+        output: str,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if parent_run_id is None:
+            self.increment()
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/runner_utils.py b/llm/Lib/site-packages/langchain/smith/evaluation/runner_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..2559c8eb71e3087822b51a620d6602f612dc780f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/smith/evaluation/runner_utils.py
@@ -0,0 +1,1518 @@
+"""Utilities for running language models or Chains over datasets."""
+
+from __future__ import annotations
+
+import concurrent.futures
+import dataclasses
+import functools
+import inspect
+import logging
+import uuid
+from datetime import datetime, timezone
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    List,
+    Optional,
+    Tuple,
+    Union,
+    cast,
+)
+
+from langchain_core._api import warn_deprecated
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.messages import BaseMessage, messages_from_dict
+from langchain_core.outputs import ChatResult, LLMResult
+from langchain_core.runnables import Runnable, RunnableConfig, RunnableLambda
+from langchain_core.runnables import config as runnable_config
+from langchain_core.runnables import utils as runnable_utils
+from langchain_core.tracers.evaluation import (
+    EvaluatorCallbackHandler,
+    wait_for_all_evaluators,
+)
+from langchain_core.tracers.langchain import LangChainTracer
+from langsmith.client import Client
+from langsmith.env import get_git_info, get_langchain_env_var_metadata
+from langsmith.evaluation import (
+    EvaluationResult,
+    RunEvaluator,
+)
+from langsmith.evaluation import (
+    run_evaluator as run_evaluator_dec,
+)
+from langsmith.run_helpers import as_runnable, is_traceable_function
+from langsmith.schemas import Dataset, DataType, Example, Run, TracerSession
+from langsmith.utils import LangSmithError
+from requests import HTTPError
+from typing_extensions import TypedDict
+
+from langchain.callbacks.manager import Callbacks
+from langchain.chains.base import Chain
+from langchain.evaluation.loading import load_evaluator
+from langchain.evaluation.schema import (
+    EvaluatorType,
+    PairwiseStringEvaluator,
+    StringEvaluator,
+)
+from langchain.smith import evaluation as smith_eval
+from langchain.smith.evaluation import config as smith_eval_config
+from langchain.smith.evaluation import name_generation, progress
+
+if TYPE_CHECKING:
+    import pandas as pd
+
+logger = logging.getLogger(__name__)
+
+MODEL_OR_CHAIN_FACTORY = Union[
+    Callable[[], Union[Chain, Runnable]],
+    BaseLanguageModel,
+    Callable[[dict], Any],
+    Runnable,
+    Chain,
+]
+MCF = Union[Callable[[], Union[Chain, Runnable]], BaseLanguageModel]
+
+
+class InputFormatError(Exception):
+    """Raised when the input format is invalid."""
+
+
+## Shared Utilities
+
+
+class TestResult(dict):
+    """A dictionary of the results of a single test run."""
+
+    def get_aggregate_feedback(
+        self,
+    ) -> pd.DataFrame:
+        """Return quantiles for the feedback scores.
+
+        This method calculates and prints the quantiles for the feedback scores
+        across all feedback keys.
+
+        Returns:
+            A DataFrame containing the quantiles for each feedback key.
+        """
+        df = self.to_dataframe()
+        # Drop all things starting with inputs., outputs., and reference
+        to_drop = [
+            col
+            for col in df.columns
+            if col.startswith("inputs.")
+            or col.startswith("outputs.")
+            or col in {"input", "output"}
+            or col.startswith("reference")
+        ]
+        return df.describe(include="all").drop(to_drop, axis=1)
+
+    def to_dataframe(self) -> pd.DataFrame:
+        """Convert the results to a dataframe."""
+        try:
+            import pandas as pd
+        except ImportError as e:
+            raise ImportError(
+                "Pandas is required to convert the results to a dataframe."
+                " to install pandas, run `pip install pandas`."
+            ) from e
+
+        indices = []
+        records = []
+        for example_id, result in self["results"].items():
+            feedback = result["feedback"]
+            output_ = result.get("output")
+            if isinstance(output_, dict):
+                output = {f"outputs.{k}": v for k, v in output_.items()}
+            elif output_ is None:
+                output = {}
+            else:
+                output = {"output": output_}
+
+            r = {
+                **{f"inputs.{k}": v for k, v in result["input"].items()},
+                **output,
+            }
+            if "reference" in result:
+                if isinstance(result["reference"], dict):
+                    r.update(
+                        {f"reference.{k}": v for k, v in result["reference"].items()}
+                    )
+                else:
+                    r["reference"] = result["reference"]
+            r.update(
+                {
+                    **{f"feedback.{f.key}": f.score for f in feedback},
+                    "error": result.get("Error"),
+                    "execution_time": result["execution_time"],
+                    "run_id": result.get("run_id"),
+                }
+            )
+            records.append(r)
+            indices.append(example_id)
+
+        return pd.DataFrame(records, index=indices)
+
+
+class EvalError(dict):
+    """Your architecture raised an error."""
+
+    def __init__(self, Error: BaseException, **kwargs: Any) -> None:
+        super().__init__(Error=Error, **kwargs)
+
+    def __getattr__(self, name: str) -> Any:
+        try:
+            return self[name]
+        except KeyError:
+            raise AttributeError(f"'EvalError' object has no attribute '{name}'")
+
+
+def _wrap_in_chain_factory(
+    llm_or_chain_factory: MODEL_OR_CHAIN_FACTORY,
+    dataset_name: str = "<my_dataset>",
+) -> MCF:
+    """Forgive the user if they pass in a chain without memory instead of a chain
+    factory. It's a common mistake. Raise a more helpful error message as well."""
+    if isinstance(llm_or_chain_factory, Chain):
+        chain = llm_or_chain_factory
+        chain_class = chain.__class__.__name__
+        if llm_or_chain_factory.memory is not None:
+            memory_class = chain.memory.__class__.__name__
+            raise ValueError(
+                "Cannot directly evaluate a chain with stateful memory."
+                " To evaluate this chain, pass in a chain constructor"
+                " that initializes fresh memory each time it is called."
+                "  This will safegaurd against information"
+                " leakage between dataset examples."
+                "\nFor example:\n\n"
+                "def chain_constructor():\n"
+                f"    new_memory = {memory_class}(...)\n"
+                f"    return {chain_class}"
+                "(memory=new_memory, ...)\n\n"
+                f'run_on_dataset("{dataset_name}", chain_constructor, ...)'
+            )
+        return lambda: chain
+    elif isinstance(llm_or_chain_factory, BaseLanguageModel):
+        return llm_or_chain_factory
+    elif isinstance(llm_or_chain_factory, Runnable):
+        # Memory may exist here, but it's not elegant to check all those cases.
+        lcf = llm_or_chain_factory
+        return lambda: lcf
+    elif callable(llm_or_chain_factory):
+        if is_traceable_function(llm_or_chain_factory):
+            runnable_ = as_runnable(cast(Callable, llm_or_chain_factory))
+            return lambda: runnable_
+        try:
+            _model = llm_or_chain_factory()  # type: ignore[call-arg]
+        except TypeError:
+            # It's an arbitrary function, wrap it in a RunnableLambda
+            user_func = cast(Callable, llm_or_chain_factory)
+            sig = inspect.signature(user_func)
+            logger.info(f"Wrapping function {sig} as RunnableLambda.")
+            wrapped = RunnableLambda(user_func)
+            return lambda: wrapped
+        constructor = cast(Callable, llm_or_chain_factory)
+        if isinstance(_model, BaseLanguageModel):
+            # It's not uncommon to do an LLM constructor instead of raw LLM,
+            # so we'll unpack it for the user.
+            return _model
+        elif is_traceable_function(cast(Callable, _model)):
+            runnable_ = as_runnable(cast(Callable, _model))
+            return lambda: runnable_
+        elif not isinstance(_model, Runnable):
+            # This is unlikely to happen - a constructor for a model function
+            return lambda: RunnableLambda(constructor)
+        else:
+            # Typical correct case
+            return constructor  # noqa
+    return llm_or_chain_factory
+
+
+def _get_prompt(inputs: Dict[str, Any]) -> str:
+    """Get prompt from inputs.
+
+    Args:
+        inputs: The input dictionary.
+
+    Returns:
+        A string prompt.
+    Raises:
+        InputFormatError: If the input format is invalid.
+    """
+    if not inputs:
+        raise InputFormatError("Inputs should not be empty.")
+
+    prompts = []
+    if "prompt" in inputs:
+        if not isinstance(inputs["prompt"], str):
+            raise InputFormatError(
+                "Expected string for 'prompt', got"
+                f" {type(inputs['prompt']).__name__}"
+            )
+        prompts = [inputs["prompt"]]
+    elif "prompts" in inputs:
+        if not isinstance(inputs["prompts"], list) or not all(
+            isinstance(i, str) for i in inputs["prompts"]
+        ):
+            raise InputFormatError(
+                "Expected list of strings for 'prompts',"
+                f" got {type(inputs['prompts']).__name__}"
+            )
+        prompts = inputs["prompts"]
+    elif len(inputs) == 1:
+        prompt_ = next(iter(inputs.values()))
+        if isinstance(prompt_, str):
+            prompts = [prompt_]
+        elif isinstance(prompt_, list) and all(isinstance(i, str) for i in prompt_):
+            prompts = prompt_
+        else:
+            raise InputFormatError(f"LLM Run expects string prompt input. Got {inputs}")
+    else:
+        raise InputFormatError(
+            f"LLM Run expects 'prompt' or 'prompts' in inputs. Got {inputs}"
+        )
+    if len(prompts) == 1:
+        return prompts[0]
+    else:
+        raise InputFormatError(
+            f"LLM Run expects single prompt input. Got {len(prompts)} prompts."
+        )
+
+
+class ChatModelInput(TypedDict):
+    messages: List[BaseMessage]
+
+
+def _get_messages(inputs: Dict[str, Any]) -> dict:
+    """Get Chat Messages from inputs.
+
+    Args:
+        inputs: The input dictionary.
+
+    Returns:
+        A list of chat messages.
+    Raises:
+        InputFormatError: If the input format is invalid.
+    """
+    if not inputs:
+        raise InputFormatError("Inputs should not be empty.")
+    input_copy = inputs.copy()
+    if "messages" in inputs:
+        input_copy["input"] = input_copy.pop("messages")
+    elif len(inputs) == 1:
+        input_copy["input"] = next(iter(inputs.values()))
+    if "input" in input_copy:
+        raw_messages = input_copy["input"]
+        if isinstance(raw_messages, list) and all(
+            isinstance(i, dict) for i in raw_messages
+        ):
+            raw_messages = [raw_messages]
+        if len(raw_messages) == 1:
+            input_copy["input"] = messages_from_dict(raw_messages[0])
+        else:
+            raise InputFormatError(
+                "Batch messages not supported. Please provide a"
+                " single list of messages."
+            )
+        return input_copy
+    else:
+        raise InputFormatError(
+            f"Chat Run expects single List[dict] or List[List[dict]] 'messages'"
+            f" input. Got {inputs}"
+        )
+
+
+## Shared data validation utilities
+def _validate_example_inputs_for_language_model(
+    first_example: Example,
+    input_mapper: Optional[Callable[[Dict], Any]],
+) -> None:
+    if input_mapper:
+        prompt_input = input_mapper(first_example.inputs)
+        if not isinstance(prompt_input, str) and not (
+            isinstance(prompt_input, list)
+            and all(isinstance(msg, BaseMessage) for msg in prompt_input)
+        ):
+            raise InputFormatError(
+                "When using an input_mapper to prepare dataset example inputs"
+                " for an LLM or chat model, the output must a single string or"
+                " a list of chat messages."
+                f"\nGot: {prompt_input} of type {type(prompt_input)}."
+            )
+    else:
+        try:
+            _get_prompt(first_example.inputs)
+        except InputFormatError:
+            try:
+                _get_messages(first_example.inputs)
+            except InputFormatError:
+                raise InputFormatError(
+                    "Example inputs do not match language model input format. "
+                    "Expected a dictionary with messages or a single prompt."
+                    f" Got: {first_example.inputs}"
+                    " Please update your dataset OR provide an input_mapper"
+                    " to convert the example.inputs to a compatible format"
+                    " for the llm or chat model you wish to evaluate."
+                )
+
+
+def _validate_example_inputs_for_chain(
+    first_example: Example,
+    chain: Chain,
+    input_mapper: Optional[Callable[[Dict], Any]],
+) -> None:
+    """Validate that the example inputs match the chain input keys."""
+    if input_mapper:
+        first_inputs = input_mapper(first_example.inputs)
+        missing_keys = set(chain.input_keys).difference(first_inputs)
+        if not isinstance(first_inputs, dict):
+            raise InputFormatError(
+                "When using an input_mapper to prepare dataset example"
+                " inputs for a chain, the mapped value must be a dictionary."
+                f"\nGot: {first_inputs} of type {type(first_inputs)}."
+            )
+        if missing_keys:
+            raise InputFormatError(
+                "Missing keys after loading example using input_mapper."
+                f"\nExpected: {chain.input_keys}. Got: {first_inputs.keys()}"
+            )
+    else:
+        first_inputs = first_example.inputs
+        missing_keys = set(chain.input_keys).difference(first_inputs)
+        if len(first_inputs) == 1 and len(chain.input_keys) == 1:
+            # We can pass this through the run method.
+            # Refrain from calling to validate.
+            pass
+        elif missing_keys:
+            raise InputFormatError(
+                "Example inputs missing expected chain input keys."
+                " Please provide an input_mapper to convert the example.inputs"
+                " to a compatible format for the chain you wish to evaluate."
+                f"Expected: {chain.input_keys}. "
+                f"Got: {first_inputs.keys()}"
+            )
+
+
+def _validate_example_inputs(
+    example: Example,
+    llm_or_chain_factory: MCF,
+    input_mapper: Optional[Callable[[Dict], Any]],
+) -> None:
+    """Validate that the example inputs are valid for the model."""
+    if isinstance(llm_or_chain_factory, BaseLanguageModel):
+        _validate_example_inputs_for_language_model(example, input_mapper)
+    else:
+        chain = llm_or_chain_factory()
+        if isinstance(chain, Chain):
+            # Otherwise it's a runnable
+            _validate_example_inputs_for_chain(example, chain, input_mapper)
+        elif isinstance(chain, Runnable):
+            logger.debug(f"Skipping input validation for {chain}")
+
+
+## Shared Evaluator Setup Utilities
+
+
+def _setup_evaluation(
+    llm_or_chain_factory: MCF,
+    examples: List[Example],
+    evaluation: Optional[smith_eval.RunEvalConfig],
+    data_type: DataType,
+) -> Optional[List[RunEvaluator]]:
+    """Configure the evaluators to run on the results of the chain."""
+    if evaluation:
+        if isinstance(llm_or_chain_factory, BaseLanguageModel):
+            run_inputs, run_outputs = None, None
+            run_type = "llm"
+        else:
+            run_type = "chain"
+            chain = llm_or_chain_factory()
+            run_inputs = chain.input_keys if isinstance(chain, Chain) else None
+            run_outputs = chain.output_keys if isinstance(chain, Chain) else None
+        run_evaluators = _load_run_evaluators(
+            evaluation,
+            run_type,
+            data_type,
+            list(examples[0].outputs) if examples[0].outputs else None,
+            run_inputs,
+            run_outputs,
+        )
+    else:
+        # TODO: Create a default helpfulness evaluator
+        run_evaluators = None
+    return run_evaluators
+
+
+def _determine_input_key(
+    config: smith_eval.RunEvalConfig,
+    run_inputs: Optional[List[str]],
+) -> Optional[str]:
+    input_key = None
+    if config.input_key:
+        input_key = config.input_key
+        if run_inputs and input_key not in run_inputs:
+            logger.warning(
+                f"Input key {input_key} not in chain's specified"
+                f" input keys {run_inputs}. Evaluation behavior may be undefined."
+            )
+    elif run_inputs and len(run_inputs) == 1:
+        input_key = run_inputs[0]
+    elif run_inputs is not None and len(run_inputs) > 1:
+        logger.warning(
+            f"Chain expects multiple input keys: {run_inputs},"
+            f" Evaluator is likely to fail. Evaluation behavior may be undefined."
+            " Specify an input_key in the RunEvalConfig to avoid this warning."
+        )
+
+    return input_key
+
+
+def _determine_prediction_key(
+    config: smith_eval.RunEvalConfig,
+    run_outputs: Optional[List[str]],
+) -> Optional[str]:
+    prediction_key = None
+    if config.prediction_key:
+        prediction_key = config.prediction_key
+        if run_outputs and prediction_key not in run_outputs:
+            logger.warning(
+                f"Prediction key {prediction_key} not in chain's specified"
+                f" output keys {run_outputs}. Evaluation behavior may be undefined."
+            )
+    elif run_outputs and len(run_outputs) == 1:
+        prediction_key = run_outputs[0]
+    elif run_outputs is not None and len(run_outputs) > 1:
+        logger.warning(
+            f"Chain expects multiple output keys: {run_outputs},"
+            f" Evaluation behavior may be undefined. Specify a prediction_key"
+            " in the RunEvalConfig to avoid this warning."
+        )
+    return prediction_key
+
+
+def _determine_reference_key(
+    config: smith_eval.RunEvalConfig,
+    example_outputs: Optional[List[str]],
+) -> Optional[str]:
+    if config.reference_key:
+        reference_key = config.reference_key
+        if example_outputs and reference_key not in example_outputs:
+            raise ValueError(
+                f"Reference key {reference_key} not in Dataset"
+                f" example outputs: {example_outputs}"
+            )
+    elif example_outputs and len(example_outputs) == 1:
+        reference_key = list(example_outputs)[0]
+    else:
+        reference_key = None
+    return reference_key
+
+
+def _construct_run_evaluator(
+    eval_config: Union[
+        smith_eval_config.SINGLE_EVAL_CONFIG_TYPE,
+        smith_eval_config.CUSTOM_EVALUATOR_TYPE,
+    ],
+    eval_llm: Optional[BaseLanguageModel],
+    run_type: str,
+    data_type: DataType,
+    example_outputs: Optional[List[str]],
+    reference_key: Optional[str],
+    input_key: Optional[str],
+    prediction_key: Optional[str],
+) -> RunEvaluator:
+    if isinstance(eval_config, RunEvaluator):
+        return eval_config
+    if isinstance(eval_config, (EvaluatorType, str)):
+        if not isinstance(eval_config, EvaluatorType):
+            eval_config = EvaluatorType(eval_config)
+        evaluator_ = load_evaluator(eval_config, llm=eval_llm)
+        eval_type_tag = eval_config.value
+    elif isinstance(eval_config, smith_eval_config.EvalConfig):
+        kwargs = {"llm": eval_llm, **eval_config.get_kwargs()}
+        evaluator_ = load_evaluator(eval_config.evaluator_type, **kwargs)
+        eval_type_tag = eval_config.evaluator_type.value
+        # Override keys if specified in the config
+        if isinstance(eval_config, smith_eval_config.SingleKeyEvalConfig):
+            input_key = eval_config.input_key or input_key
+            prediction_key = eval_config.prediction_key or prediction_key
+            reference_key = eval_config.reference_key or reference_key
+    elif callable(eval_config):
+        # Assume we can decorate
+        return run_evaluator_dec(eval_config)
+    else:
+        raise ValueError(f"Unknown evaluator type: {type(eval_config)}")
+
+    if isinstance(evaluator_, StringEvaluator):
+        if evaluator_.requires_reference and reference_key is None:
+            raise ValueError(
+                f"Must specify reference_key in smith_eval.RunEvalConfig to use"
+                f" evaluator of type {eval_type_tag} with"
+                f" dataset with multiple output keys: {example_outputs}."
+            )
+        run_evaluator = smith_eval.StringRunEvaluatorChain.from_run_and_data_type(
+            evaluator_,
+            run_type,
+            data_type,
+            input_key=input_key,
+            prediction_key=prediction_key,
+            reference_key=reference_key,
+            tags=[eval_type_tag],
+        )
+    elif isinstance(evaluator_, PairwiseStringEvaluator):
+        raise NotImplementedError(
+            f"Run evaluator for {eval_type_tag} is not implemented."
+            " PairwiseStringEvaluators compare the outputs of two different models"
+            " rather than the output of a single model."
+            " Did you mean to use a StringEvaluator instead?"
+            "\nSee: https://python.langchain.com/docs/guides/evaluation/string/"
+        )
+
+    else:
+        raise NotImplementedError(
+            f"Run evaluator for {eval_type_tag} is not implemented"
+        )
+    return run_evaluator
+
+
+def _get_keys(
+    config: smith_eval.RunEvalConfig,
+    run_inputs: Optional[List[str]],
+    run_outputs: Optional[List[str]],
+    example_outputs: Optional[List[str]],
+) -> Tuple[Optional[str], Optional[str], Optional[str]]:
+    input_key = _determine_input_key(config, run_inputs)
+    prediction_key = _determine_prediction_key(config, run_outputs)
+    reference_key = _determine_reference_key(config, example_outputs)
+    return input_key, prediction_key, reference_key
+
+
+def _load_run_evaluators(
+    config: smith_eval.RunEvalConfig,
+    run_type: str,
+    data_type: DataType,
+    example_outputs: Optional[List[str]],
+    run_inputs: Optional[List[str]],
+    run_outputs: Optional[List[str]],
+) -> List[RunEvaluator]:
+    """
+    Load run evaluators from a configuration.
+
+    Args:
+        config: Configuration for the run evaluators.
+
+    Returns:
+        A list of run evaluators.
+    """
+    run_evaluators = []
+    input_key, prediction_key, reference_key = None, None, None
+    if config.evaluators or (
+        config.custom_evaluators
+        and any([isinstance(e, StringEvaluator) for e in config.custom_evaluators])
+    ):
+        input_key, prediction_key, reference_key = _get_keys(
+            config, run_inputs, run_outputs, example_outputs
+        )
+    for eval_config in config.evaluators:
+        run_evaluator = _construct_run_evaluator(
+            eval_config,
+            config.eval_llm,
+            run_type,
+            data_type,
+            example_outputs,
+            reference_key,
+            input_key,
+            prediction_key,
+        )
+        run_evaluators.append(run_evaluator)
+    custom_evaluators = config.custom_evaluators or []
+    for custom_evaluator in custom_evaluators:
+        if isinstance(custom_evaluator, RunEvaluator):
+            run_evaluators.append(custom_evaluator)
+        elif isinstance(custom_evaluator, StringEvaluator):
+            run_evaluators.append(
+                smith_eval.StringRunEvaluatorChain.from_run_and_data_type(
+                    custom_evaluator,
+                    run_type,
+                    data_type,
+                    input_key=input_key,
+                    prediction_key=prediction_key,
+                    reference_key=reference_key,
+                )
+            )
+        elif callable(custom_evaluator):
+            run_evaluators.append(run_evaluator_dec(custom_evaluator))
+        else:
+            raise ValueError(
+                f"Unsupported custom evaluator: {custom_evaluator}."
+                f" Expected RunEvaluator or StringEvaluator."
+            )
+
+    return run_evaluators
+
+
+### Async Helpers
+
+
+async def _arun_llm(
+    llm: BaseLanguageModel,
+    inputs: Dict[str, Any],
+    *,
+    tags: Optional[List[str]] = None,
+    callbacks: Callbacks = None,
+    input_mapper: Optional[Callable[[Dict], Any]] = None,
+    metadata: Optional[Dict[str, Any]] = None,
+) -> Union[str, BaseMessage]:
+    """Asynchronously run the language model.
+
+    Args:
+        llm: The language model to run.
+        inputs: The input dictionary.
+        tags: Optional tags to add to the run.
+        callbacks: Optional callbacks to use during the run.
+        input_mapper: Optional function to map inputs to the expected format.
+
+    Returns:
+        The LLMResult or ChatResult.
+    Raises:
+        ValueError: If the LLM type is unsupported.
+        InputFormatError: If the input format is invalid.
+    """
+    if input_mapper is not None:
+        prompt_or_messages = input_mapper(inputs)
+        if (
+            isinstance(prompt_or_messages, str)
+            or isinstance(prompt_or_messages, list)
+            and all(isinstance(msg, BaseMessage) for msg in prompt_or_messages)
+        ):
+            return await llm.ainvoke(
+                prompt_or_messages,
+                config=RunnableConfig(
+                    callbacks=callbacks, tags=tags or [], metadata=metadata or {}
+                ),
+            )
+        else:
+            raise InputFormatError(
+                "Input mapper returned invalid format"
+                f" {prompt_or_messages}"
+                "\nExpected a single string or list of chat messages."
+            )
+
+    else:
+        try:
+            prompt = _get_prompt(inputs)
+            llm_output: Union[str, BaseMessage] = await llm.ainvoke(
+                prompt,
+                config=RunnableConfig(
+                    callbacks=callbacks, tags=tags or [], metadata=metadata or {}
+                ),
+            )
+        except InputFormatError:
+            llm_inputs = _get_messages(inputs)
+            llm_output = await llm.ainvoke(
+                **llm_inputs,
+                config=RunnableConfig(
+                    callbacks=callbacks, tags=tags or [], metadata=metadata or {}
+                ),
+            )
+    return llm_output
+
+
+async def _arun_chain(
+    chain: Union[Chain, Runnable],
+    inputs: Dict[str, Any],
+    callbacks: Callbacks,
+    *,
+    tags: Optional[List[str]] = None,
+    input_mapper: Optional[Callable[[Dict], Any]] = None,
+    metadata: Optional[Dict[str, Any]] = None,
+) -> Union[dict, str]:
+    """Run a chain asynchronously on inputs."""
+    inputs_ = inputs if input_mapper is None else input_mapper(inputs)
+    if (
+        isinstance(chain, Chain)
+        and isinstance(inputs_, dict)
+        and len(inputs_) == 1
+        and chain.input_keys
+    ):
+        val = next(iter(inputs_.values()))
+        output = await chain.ainvoke(
+            val,
+            config=RunnableConfig(
+                callbacks=callbacks, tags=tags or [], metadata=metadata or {}
+            ),
+        )
+    else:
+        runnable_config = RunnableConfig(
+            tags=tags or [], callbacks=callbacks, metadata=metadata or {}
+        )
+        output = await chain.ainvoke(inputs_, config=runnable_config)
+    return output
+
+
+async def _arun_llm_or_chain(
+    example: Example,
+    config: RunnableConfig,
+    *,
+    llm_or_chain_factory: MCF,
+    input_mapper: Optional[Callable[[Dict], Any]] = None,
+) -> Union[dict, str, LLMResult, ChatResult]:
+    """Asynchronously run the Chain or language model.
+
+    Args:
+        example: The example to run.
+        llm_or_chain_factory: The Chain or language model constructor to run.
+        tags: Optional tags to add to the run.
+        callbacks: Optional callbacks to use during the run.
+        input_mapper: Optional function to map the input to the expected format.
+
+    Returns:
+        A list of outputs.
+    """
+    chain_or_llm = (
+        "LLM" if isinstance(llm_or_chain_factory, BaseLanguageModel) else "Chain"
+    )
+    result = None
+    try:
+        if isinstance(llm_or_chain_factory, BaseLanguageModel):
+            output: Any = await _arun_llm(
+                llm_or_chain_factory,
+                example.inputs,
+                tags=config["tags"],
+                callbacks=config["callbacks"],
+                input_mapper=input_mapper,
+                metadata=config.get("metadata"),
+            )
+        else:
+            chain = llm_or_chain_factory()
+            output = await _arun_chain(
+                chain,
+                example.inputs,
+                tags=config["tags"],
+                callbacks=config["callbacks"],
+                input_mapper=input_mapper,
+                metadata=config.get("metadata"),
+            )
+        result = output
+    except Exception as e:
+        logger.warning(
+            f"{chain_or_llm} failed for example {example.id} "
+            f"with inputs {example.inputs}"
+            f"\n{repr(e)}"
+        )
+        result = EvalError(Error=e)
+    return result
+
+
+## Sync Utilities
+
+
+def _run_llm(
+    llm: BaseLanguageModel,
+    inputs: Dict[str, Any],
+    callbacks: Callbacks,
+    *,
+    tags: Optional[List[str]] = None,
+    input_mapper: Optional[Callable[[Dict], Any]] = None,
+    metadata: Optional[Dict[str, Any]] = None,
+) -> Union[str, BaseMessage]:
+    """
+    Run the language model on the example.
+
+    Args:
+        llm: The language model to run.
+        inputs: The input dictionary.
+        callbacks: The callbacks to use during the run.
+        tags: Optional tags to add to the run.
+        input_mapper: function to map to the inputs dictionary from an Example
+    Returns:
+        The LLMResult or ChatResult.
+    Raises:
+        ValueError: If the LLM type is unsupported.
+        InputFormatError: If the input format is invalid.
+    """
+    # Most of this is legacy code; we could probably remove a lot of it.
+    if input_mapper is not None:
+        prompt_or_messages = input_mapper(inputs)
+        if (
+            isinstance(prompt_or_messages, str)
+            or isinstance(prompt_or_messages, list)
+            and all(isinstance(msg, BaseMessage) for msg in prompt_or_messages)
+        ):
+            llm_output: Union[str, BaseMessage] = llm.invoke(
+                prompt_or_messages,
+                config=RunnableConfig(
+                    callbacks=callbacks, tags=tags or [], metadata=metadata or {}
+                ),
+            )
+        else:
+            raise InputFormatError(
+                "Input mapper returned invalid format: "
+                f" {prompt_or_messages}"
+                "\nExpected a single string or list of chat messages."
+            )
+    else:
+        try:
+            llm_prompts = _get_prompt(inputs)
+            llm_output = llm.invoke(
+                llm_prompts,
+                config=RunnableConfig(
+                    callbacks=callbacks, tags=tags or [], metadata=metadata or {}
+                ),
+            )
+        except InputFormatError:
+            llm_inputs = _get_messages(inputs)
+            llm_output = llm.invoke(
+                **llm_inputs,
+                config=RunnableConfig(callbacks=callbacks, metadata=metadata or {}),
+            )
+    return llm_output
+
+
+def _run_chain(
+    chain: Union[Chain, Runnable],
+    inputs: Dict[str, Any],
+    callbacks: Callbacks,
+    *,
+    tags: Optional[List[str]] = None,
+    input_mapper: Optional[Callable[[Dict], Any]] = None,
+    metadata: Optional[Dict[str, Any]] = None,
+) -> Union[Dict, str]:
+    """Run a chain on inputs."""
+    inputs_ = inputs if input_mapper is None else input_mapper(inputs)
+    if (
+        isinstance(chain, Chain)
+        and isinstance(inputs_, dict)
+        and len(inputs_) == 1
+        and chain.input_keys
+    ):
+        val = next(iter(inputs_.values()))
+        output = chain.invoke(
+            val,
+            config=RunnableConfig(
+                callbacks=callbacks, tags=tags or [], metadata=metadata or {}
+            ),
+        )
+    else:
+        runnable_config = RunnableConfig(
+            tags=tags or [], callbacks=callbacks, metadata=metadata or {}
+        )
+        output = chain.invoke(inputs_, config=runnable_config)
+    return output
+
+
+def _run_llm_or_chain(
+    example: Example,
+    config: RunnableConfig,
+    *,
+    llm_or_chain_factory: MCF,
+    input_mapper: Optional[Callable[[Dict], Any]] = None,
+) -> Union[dict, str, LLMResult, ChatResult]:
+    """
+    Run the Chain or language model synchronously.
+
+    Args:
+        example: The example to run.
+        llm_or_chain_factory: The Chain or language model constructor to run.
+        tags: Optional tags to add to the run.
+        callbacks: Optional callbacks to use during the run.
+
+    Returns:
+        Union[List[dict], List[str], List[LLMResult], List[ChatResult]]:
+          The outputs of the model or chain.
+    """
+    chain_or_llm = (
+        "LLM" if isinstance(llm_or_chain_factory, BaseLanguageModel) else "Chain"
+    )
+    result = None
+    try:
+        if isinstance(llm_or_chain_factory, BaseLanguageModel):
+            output: Any = _run_llm(
+                llm_or_chain_factory,
+                example.inputs,
+                config["callbacks"],
+                tags=config["tags"],
+                input_mapper=input_mapper,
+                metadata=config.get("metadata"),
+            )
+        else:
+            chain = llm_or_chain_factory()
+            output = _run_chain(
+                chain,
+                example.inputs,
+                config["callbacks"],
+                tags=config["tags"],
+                input_mapper=input_mapper,
+                metadata=config.get("metadata"),
+            )
+        result = output
+    except Exception as e:
+        error_type = type(e).__name__
+        logger.warning(
+            f"{chain_or_llm} failed for example {example.id} "
+            f"with inputs {example.inputs}"
+            f"\nError Type: {error_type}, Message: {e}"
+        )
+        result = EvalError(Error=e)
+    return result
+
+
+def _prepare_eval_run(
+    client: Client,
+    dataset_name: str,
+    llm_or_chain_factory: MODEL_OR_CHAIN_FACTORY,
+    project_name: str,
+    project_metadata: Optional[Dict[str, Any]] = None,
+    tags: Optional[List[str]] = None,
+    dataset_version: Optional[Union[str, datetime]] = None,
+) -> Tuple[MCF, TracerSession, Dataset, List[Example]]:
+    wrapped_model = _wrap_in_chain_factory(llm_or_chain_factory, dataset_name)
+    dataset = client.read_dataset(dataset_name=dataset_name)
+
+    examples = list(client.list_examples(dataset_id=dataset.id, as_of=dataset_version))
+    if not examples:
+        raise ValueError(f"Dataset {dataset_name} has no example rows.")
+    modified_at = [ex.modified_at for ex in examples if ex.modified_at]
+    # Should always be defined in practice when fetched,
+    # but the typing permits None
+    max_modified_at = max(modified_at) if modified_at else None
+    inferred_version = max_modified_at.isoformat() if max_modified_at else None
+
+    try:
+        project_metadata = project_metadata or {}
+        git_info = get_git_info()
+        if git_info:
+            project_metadata = {
+                **project_metadata,
+                "git": git_info,
+            }
+
+        project_metadata["dataset_version"] = inferred_version
+        project = client.create_project(
+            project_name,
+            reference_dataset_id=dataset.id,
+            project_extra={"tags": tags} if tags else {},
+            metadata=project_metadata,
+        )
+    except (HTTPError, ValueError, LangSmithError) as e:
+        if "already exists " not in str(e):
+            raise e
+        uid = uuid.uuid4()
+        example_msg = f"""
+run_on_dataset(
+    ...
+    project_name="{project_name} - {uid}", # Update since {project_name} already exists
+)
+"""
+        raise ValueError(
+            f"Test project {project_name} already exists. Please use a different name:"
+            f"\n\n{example_msg}"
+        )
+    comparison_url = dataset.url + f"/compare?selectedSessions={project.id}"
+    print(  # noqa: T201
+        f"View the evaluation results for project '{project_name}'"
+        f" at:\n{comparison_url}\n\n"
+        f"View all tests for Dataset {dataset_name} at:\n{dataset.url}",
+        flush=True,
+    )
+    return wrapped_model, project, dataset, examples
+
+
+class _RowResult(TypedDict, total=False):
+    """A dictionary of the results for a single example row."""
+
+    feedback: Optional[List[EvaluationResult]]
+    execution_time: Optional[float]
+    run_id: Optional[str]
+
+
+@dataclasses.dataclass
+class _DatasetRunContainer:
+    """A container to help manage the state of a eval run."""
+
+    client: Client
+    project: TracerSession
+    wrapped_model: MCF
+    examples: List[Example]
+    configs: List[RunnableConfig]
+    batch_evaluators: Optional[List[smith_eval_config.BATCH_EVALUATOR_LIKE]] = None
+
+    def _merge_test_outputs(
+        self,
+        batch_results: list,
+        all_eval_results: Dict[str, _RowResult],
+    ) -> dict:
+        results: dict = {}
+        for example, output in zip(self.examples, batch_results):
+            row_result = cast(_RowResult, all_eval_results.get(str(example.id), {}))
+            results[str(example.id)] = {
+                "input": example.inputs,
+                "feedback": row_result.get("feedback", []),
+                "execution_time": row_result.get("execution_time"),
+                "run_id": row_result.get("run_id"),
+            }
+            if isinstance(output, EvalError):
+                results[str(example.id)]["Error"] = output.Error
+            else:
+                results[str(example.id)]["output"] = output
+            if example.outputs:
+                results[str(example.id)]["reference"] = example.outputs
+        return results
+
+    def _run_batch_evaluators(self, runs: Dict[str, Run]) -> List[dict]:
+        evaluators = self.batch_evaluators
+        if not evaluators:
+            return []
+        runs_list = [runs[str(example.id)] for example in self.examples]
+        aggregate_feedback = []
+        with concurrent.futures.ThreadPoolExecutor() as executor:
+            for evaluator in evaluators:
+                try:
+                    result = evaluator(runs_list, self.examples)
+                    if isinstance(result, EvaluationResult):
+                        result = result.dict()
+                    aggregate_feedback.append(cast(dict, result))
+                    executor.submit(
+                        self.client.create_feedback,
+                        **result,
+                        run_id=None,
+                        project_id=self.project.id,
+                    )
+                except Exception as e:
+                    logger.error(
+                        f"Error running batch evaluator {repr(evaluator)}: {e}"
+                    )
+        return aggregate_feedback
+
+    def _collect_metrics(self) -> Tuple[Dict[str, _RowResult], Dict[str, Run]]:
+        all_eval_results: dict = {}
+        all_runs: dict = {}
+        for c in self.configs:
+            for callback in cast(list, c["callbacks"]):
+                if isinstance(callback, EvaluatorCallbackHandler):
+                    eval_results = callback.logged_eval_results
+                    for (_, example_id), v in eval_results.items():
+                        all_eval_results.setdefault(str(example_id), {}).update(
+                            {"feedback": v}
+                        )
+                elif isinstance(callback, LangChainTracer):
+                    run = callback.latest_run
+                    execution_time = (
+                        (run.end_time - run.start_time).total_seconds()
+                        if run and run.end_time
+                        else None
+                    )
+                    run_id = str(run.id) if run else None
+                    all_eval_results.setdefault(str(callback.example_id), {}).update(
+                        {
+                            "execution_time": execution_time,
+                            "run_id": run_id,
+                            "run": run,
+                        }
+                    )
+                    all_runs[str(callback.example_id)] = run
+        return cast(Dict[str, _RowResult], all_eval_results), all_runs
+
+    def _collect_test_results(
+        self,
+        batch_results: List[Union[dict, str, LLMResult, ChatResult]],
+    ) -> TestResult:
+        logger.info("Waiting for evaluators to complete.")
+        wait_for_all_evaluators()
+        all_eval_results, all_runs = self._collect_metrics()
+        aggregate_feedback = None
+        if self.batch_evaluators:
+            logger.info("Running session evaluators.")
+            aggregate_feedback = self._run_batch_evaluators(all_runs)
+        results = self._merge_test_outputs(batch_results, all_eval_results)
+        return TestResult(
+            project_name=self.project.name,
+            results=results,
+            aggregate_metrics=aggregate_feedback,
+        )
+
+    def finish(self, batch_results: list, verbose: bool = False) -> TestResult:
+        results = self._collect_test_results(batch_results)
+        if verbose:
+            try:
+                agg_feedback = results.get_aggregate_feedback()
+                _display_aggregate_results(agg_feedback)
+            except Exception as e:
+                logger.debug(f"Failed to print aggregate feedback: {repr(e)}")
+        try:
+            # Closing the project permits name changing and metric optimizations
+            self.client.update_project(
+                self.project.id, end_time=datetime.now(timezone.utc)
+            )
+        except Exception as e:
+            logger.debug(f"Failed to close project: {repr(e)}")
+        return results
+
+    @classmethod
+    def prepare(
+        cls,
+        client: Client,
+        dataset_name: str,
+        llm_or_chain_factory: MODEL_OR_CHAIN_FACTORY,
+        project_name: Optional[str],
+        evaluation: Optional[smith_eval.RunEvalConfig] = None,
+        tags: Optional[List[str]] = None,
+        input_mapper: Optional[Callable[[Dict], Any]] = None,
+        concurrency_level: int = 5,
+        project_metadata: Optional[Dict[str, Any]] = None,
+        revision_id: Optional[str] = None,
+        dataset_version: Optional[Union[datetime, str]] = None,
+    ) -> _DatasetRunContainer:
+        project_name = project_name or name_generation.random_name()
+        if revision_id:
+            if not project_metadata:
+                project_metadata = {}
+            project_metadata.update({"revision_id": revision_id})
+        wrapped_model, project, dataset, examples = _prepare_eval_run(
+            client,
+            dataset_name,
+            llm_or_chain_factory,
+            project_name,
+            project_metadata=project_metadata,
+            tags=tags,
+            dataset_version=dataset_version,
+        )
+        tags = tags or []
+        for k, v in (project.metadata.get("git") or {}).items():
+            tags.append(f"git:{k}={v}")
+        run_metadata = {"dataset_version": project.metadata["dataset_version"]}
+        if revision_id:
+            run_metadata["revision_id"] = revision_id
+        wrapped_model = _wrap_in_chain_factory(llm_or_chain_factory)
+        run_evaluators = _setup_evaluation(
+            wrapped_model, examples, evaluation, dataset.data_type or DataType.kv
+        )
+        _validate_example_inputs(examples[0], wrapped_model, input_mapper)
+        progress_bar = progress.ProgressBarCallback(len(examples))
+        configs = [
+            RunnableConfig(
+                callbacks=[
+                    LangChainTracer(
+                        project_name=project.name,
+                        client=client,
+                        example_id=example.id,
+                    ),
+                    EvaluatorCallbackHandler(
+                        evaluators=run_evaluators or [],
+                        client=client,
+                        example_id=example.id,
+                        max_concurrency=0,
+                    ),
+                    progress_bar,
+                ],
+                tags=tags,
+                max_concurrency=concurrency_level,
+                metadata=run_metadata,
+            )
+            for example in examples
+        ]
+        return cls(
+            client=client,
+            project=project,
+            wrapped_model=wrapped_model,
+            examples=examples,
+            configs=configs,
+            batch_evaluators=evaluation.batch_evaluators if evaluation else None,
+        )
+
+
+def _is_jupyter_environment() -> bool:
+    try:
+        from IPython import get_ipython
+
+        res = get_ipython()
+        return get_ipython() is not None and "zmqshell" in str(type(res))
+    except ImportError:
+        return False
+
+
+def _display_aggregate_results(aggregate_results: pd.DataFrame) -> None:
+    if _is_jupyter_environment():
+        from IPython.display import HTML, display
+
+        display(HTML("<h3>Experiment Results:</h3>"))
+        display(aggregate_results)
+    else:
+        formatted_string = aggregate_results.to_string(
+            float_format=lambda x: f"{x:.2f}", justify="right"
+        )
+        print("\n Experiment Results:")  # noqa: T201
+        print(formatted_string)  # noqa: T201
+
+
+_INPUT_MAPPER_DEP_WARNING = (
+    "The input_mapper argument is deprecated and "
+    "will be removed in a future release. Please add a "
+    " RunnableLambda to your chain to map inputs to the expected format"
+    " instead. Example:\n"
+    "def construct_chain():\n"
+    "    my_chain = ...\n"
+    "    input_mapper = {'other_key': 'MyOtherInput', 'my_input_key': x}\n"
+    "    return input_mapper | my_chain\n"
+    "run_on_dataset(..., llm_or_chain_factory=construct_chain)\n"
+    "(See https://api.python.langchain.com/en/latest/schema/"
+    "langchain.schema.runnable.base.RunnableLambda.html)"
+)
+
+## Public API
+
+
+async def arun_on_dataset(
+    client: Optional[Client],
+    dataset_name: str,
+    llm_or_chain_factory: MODEL_OR_CHAIN_FACTORY,
+    *,
+    evaluation: Optional[smith_eval.RunEvalConfig] = None,
+    dataset_version: Optional[Union[datetime, str]] = None,
+    concurrency_level: int = 5,
+    project_name: Optional[str] = None,
+    project_metadata: Optional[Dict[str, Any]] = None,
+    verbose: bool = False,
+    revision_id: Optional[str] = None,
+    **kwargs: Any,
+) -> Dict[str, Any]:
+    input_mapper = kwargs.pop("input_mapper", None)
+    if input_mapper:
+        warn_deprecated("0.0.305", message=_INPUT_MAPPER_DEP_WARNING, pending=True)
+    if revision_id is None:
+        revision_id = get_langchain_env_var_metadata().get("revision_id")
+    tags = kwargs.pop("tags", None)
+    if tags:
+        warn_deprecated(
+            "0.1.9",
+            message="The tags argument is deprecated and will be"
+            " removed in a future release. Please specify project_metadata instead.",
+            pending=True,
+        )
+
+    if kwargs:
+        warn_deprecated(
+            "0.0.305",
+            message="The following arguments are deprecated and "
+            "will be removed in a future release: "
+            f"{kwargs.keys()}.",
+            removal="0.0.305",
+        )
+    client = client or Client()
+    container = _DatasetRunContainer.prepare(
+        client,
+        dataset_name,
+        llm_or_chain_factory,
+        project_name,
+        evaluation,
+        tags,
+        input_mapper,
+        concurrency_level,
+        project_metadata=project_metadata,
+        revision_id=revision_id,
+        dataset_version=dataset_version,
+    )
+    batch_results = await runnable_utils.gather_with_concurrency(
+        container.configs[0].get("max_concurrency"),
+        *map(
+            functools.partial(
+                _arun_llm_or_chain,
+                llm_or_chain_factory=container.wrapped_model,
+                input_mapper=input_mapper,
+            ),
+            container.examples,
+            container.configs,
+        ),
+    )
+    return container.finish(batch_results, verbose=verbose)
+
+
+def run_on_dataset(
+    client: Optional[Client],
+    dataset_name: str,
+    llm_or_chain_factory: MODEL_OR_CHAIN_FACTORY,
+    *,
+    evaluation: Optional[smith_eval.RunEvalConfig] = None,
+    dataset_version: Optional[Union[datetime, str]] = None,
+    concurrency_level: int = 5,
+    project_name: Optional[str] = None,
+    project_metadata: Optional[Dict[str, Any]] = None,
+    verbose: bool = False,
+    revision_id: Optional[str] = None,
+    **kwargs: Any,
+) -> Dict[str, Any]:
+    input_mapper = kwargs.pop("input_mapper", None)
+    if input_mapper:
+        warn_deprecated("0.0.305", message=_INPUT_MAPPER_DEP_WARNING, pending=True)
+    tags = kwargs.pop("tags", None)
+    if tags:
+        warn_deprecated(
+            "0.1.9",
+            message="The tags argument is deprecated and will be"
+            " removed in a future release. Please specify project_metadata instead.",
+            pending=True,
+        )
+    if revision_id is None:
+        revision_id = get_langchain_env_var_metadata().get("revision_id")
+
+    if kwargs:
+        warn_deprecated(
+            "0.0.305",
+            message="The following arguments are deprecated and "
+            "will be removed in a future release: "
+            f"{kwargs.keys()}.",
+            removal="0.0.305",
+        )
+    client = client or Client()
+    container = _DatasetRunContainer.prepare(
+        client,
+        dataset_name,
+        llm_or_chain_factory,
+        project_name,
+        evaluation,
+        tags,
+        input_mapper,
+        concurrency_level,
+        project_metadata=project_metadata,
+        revision_id=revision_id,
+        dataset_version=dataset_version,
+    )
+    if concurrency_level == 0:
+        batch_results = [
+            _run_llm_or_chain(
+                example,
+                config,
+                llm_or_chain_factory=container.wrapped_model,
+                input_mapper=input_mapper,
+            )
+            for example, config in zip(container.examples, container.configs)
+        ]
+    else:
+        with runnable_config.get_executor_for_config(container.configs[0]) as executor:
+            batch_results = list(
+                executor.map(
+                    functools.partial(
+                        _run_llm_or_chain,
+                        llm_or_chain_factory=container.wrapped_model,
+                        input_mapper=input_mapper,
+                    ),
+                    container.examples,
+                    container.configs,
+                )
+            )
+
+    return container.finish(batch_results, verbose=verbose)
+
+
+_RUN_ON_DATASET_DOCSTRING = """
+Run the Chain or language model on a dataset and store traces
+to the specified project name.
+
+Args:
+    dataset_name: Name of the dataset to run the chain on.
+    llm_or_chain_factory: Language model or Chain constructor to run
+        over the dataset. The Chain constructor is used to permit
+        independent calls on each example without carrying over state.
+    evaluation: Configuration for evaluators to run on the
+        results of the chain
+    concurrency_level: The number of async tasks to run concurrently.
+    project_name: Name of the project to store the traces in.
+        Defaults to {dataset_name}-{chain class name}-{datetime}.
+    project_metadata: Optional metadata to add to the project.
+        Useful for storing information the test variant.
+        (prompt version, model version, etc.)
+    client: LangSmith client to use to access the dataset and to
+        log feedback and run traces.
+    verbose: Whether to print progress.
+    tags: Tags to add to each run in the project.
+    revision_id: Optional revision identifier to assign this test run to
+        track the performance of different versions of your system.
+Returns:
+    A dictionary containing the run's project name and the resulting model outputs.
+
+
+For the (usually faster) async version of this function, see :func:`arun_on_dataset`.
+
+Examples
+--------
+
+.. code-block:: python
+
+    from langsmith import Client
+    from langchain_openai import ChatOpenAI
+    from langchain.chains import LLMChain
+    from langchain.smith import smith_eval.RunEvalConfig, run_on_dataset
+
+    # Chains may have memory. Passing in a constructor function lets the
+    # evaluation framework avoid cross-contamination between runs.
+    def construct_chain():
+        llm = ChatOpenAI(temperature=0)
+        chain = LLMChain.from_string(
+            llm,
+            "What's the answer to {your_input_key}"
+        )
+        return chain
+
+    # Load off-the-shelf evaluators via config or the EvaluatorType (string or enum)
+    evaluation_config = smith_eval.RunEvalConfig(
+        evaluators=[
+            "qa",  # "Correctness" against a reference answer
+            "embedding_distance",
+            smith_eval.RunEvalConfig.Criteria("helpfulness"),
+            smith_eval.RunEvalConfig.Criteria({
+                "fifth-grader-score": "Do you have to be smarter than a fifth grader to answer this question?"
+            }),
+        ]
+    )
+
+    client = Client()
+    run_on_dataset(
+        client,
+        dataset_name="<my_dataset_name>",
+        llm_or_chain_factory=construct_chain,
+        evaluation=evaluation_config,
+    )
+
+You can also create custom evaluators by subclassing the
+:class:`StringEvaluator <langchain.evaluation.schema.StringEvaluator>`
+or LangSmith's `RunEvaluator` classes.
+
+.. code-block:: python
+
+    from typing import Optional
+    from langchain.evaluation import StringEvaluator
+
+    class MyStringEvaluator(StringEvaluator):
+
+        @property
+        def requires_input(self) -> bool:
+            return False
+
+        @property
+        def requires_reference(self) -> bool:
+            return True
+
+        @property
+        def evaluation_name(self) -> str:
+            return "exact_match"
+
+        def _evaluate_strings(self, prediction, reference=None, input=None, **kwargs) -> dict:
+            return {"score": prediction == reference}
+
+
+    evaluation_config = smith_eval.RunEvalConfig(
+        custom_evaluators = [MyStringEvaluator()],
+    )
+
+    run_on_dataset(
+        client,
+        dataset_name="<my_dataset_name>",
+        llm_or_chain_factory=construct_chain,
+        evaluation=evaluation_config,
+    )
+"""  # noqa: E501
+run_on_dataset.__doc__ = _RUN_ON_DATASET_DOCSTRING
+arun_on_dataset.__doc__ = _RUN_ON_DATASET_DOCSTRING.replace(
+    "run_on_dataset(", "await arun_on_dataset("
+)
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/string_run_evaluator.py b/llm/Lib/site-packages/langchain/smith/evaluation/string_run_evaluator.py
new file mode 100644
index 0000000000000000000000000000000000000000..64bd51bb9f2b30cdb4b58e5ce7a4940d45417471
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/smith/evaluation/string_run_evaluator.py
@@ -0,0 +1,425 @@
+"""Run evaluator wrapper for string evaluators."""
+from __future__ import annotations
+
+from abc import abstractmethod
+from typing import Any, Dict, List, Optional
+
+from langchain_core.load.dump import dumpd
+from langchain_core.load.load import load
+from langchain_core.load.serializable import Serializable
+from langchain_core.messages import BaseMessage, get_buffer_string, messages_from_dict
+from langsmith import EvaluationResult, RunEvaluator
+from langsmith.schemas import DataType, Example, Run
+
+from langchain.callbacks.manager import (
+    AsyncCallbackManagerForChainRun,
+    CallbackManagerForChainRun,
+)
+from langchain.chains.base import Chain
+from langchain.evaluation.schema import StringEvaluator
+from langchain.schema import RUN_KEY
+
+
+def _get_messages_from_run_dict(messages: List[dict]) -> List[BaseMessage]:
+    if not messages:
+        return []
+    first_message = messages[0]
+    if "lc" in first_message:
+        return [load(dumpd(message)) for message in messages]
+    else:
+        return messages_from_dict(messages)
+
+
+class StringRunMapper(Serializable):
+    """Extract items to evaluate from the run object."""
+
+    @property
+    def output_keys(self) -> List[str]:
+        """The keys to extract from the run."""
+        return ["prediction", "input"]
+
+    @abstractmethod
+    def map(self, run: Run) -> Dict[str, str]:
+        """Maps the Run to a dictionary."""
+
+    def __call__(self, run: Run) -> Dict[str, str]:
+        """Maps the Run to a dictionary."""
+        if not run.outputs:
+            raise ValueError(f"Run {run.id} has no outputs to evaluate.")
+        return self.map(run)
+
+
+class LLMStringRunMapper(StringRunMapper):
+    """Extract items to evaluate from the run object."""
+
+    def serialize_chat_messages(self, messages: List[Dict]) -> str:
+        """Extract the input messages from the run."""
+        if isinstance(messages, list) and messages:
+            if isinstance(messages[0], dict):
+                chat_messages = _get_messages_from_run_dict(messages)
+            elif isinstance(messages[0], list):
+                # Runs from Tracer have messages as a list of lists of dicts
+                chat_messages = _get_messages_from_run_dict(messages[0])
+            else:
+                raise ValueError(f"Could not extract messages to evaluate {messages}")
+            return get_buffer_string(chat_messages)
+        raise ValueError(f"Could not extract messages to evaluate {messages}")
+
+    def serialize_inputs(self, inputs: Dict) -> str:
+        if "prompts" in inputs:  # Should we even accept this?
+            input_ = "\n\n".join(inputs["prompts"])
+        elif "prompt" in inputs:
+            input_ = inputs["prompt"]
+        elif "messages" in inputs:
+            input_ = self.serialize_chat_messages(inputs["messages"])
+        else:
+            raise ValueError("LLM Run must have either messages or prompts as inputs.")
+        return input_
+
+    def serialize_outputs(self, outputs: Dict) -> str:
+        if not outputs.get("generations"):
+            raise ValueError("Cannot evaluate LLM Run without generations.")
+        generations: List[Dict] = outputs["generations"]
+        if not generations:
+            raise ValueError("Cannot evaluate LLM run with empty generations.")
+        first_generation: Dict = generations[0]
+        if isinstance(first_generation, list):
+            # Runs from Tracer have generations as a list of lists of dicts
+            # Whereas Runs from the API have a list of dicts
+            first_generation = first_generation[0]
+        if "message" in first_generation:
+            output_ = self.serialize_chat_messages([first_generation["message"]])
+        else:
+            output_ = first_generation["text"]
+        return output_
+
+    def map(self, run: Run) -> Dict[str, str]:
+        """Maps the Run to a dictionary."""
+        if run.run_type != "llm":
+            raise ValueError("LLM RunMapper only supports LLM runs.")
+        elif not run.outputs:
+            if run.error:
+                raise ValueError(
+                    f"Cannot evaluate errored LLM run {run.id}: {run.error}"
+                )
+            else:
+                raise ValueError(
+                    f"Run {run.id} has no outputs. Cannot evaluate this run."
+                )
+        else:
+            try:
+                inputs = self.serialize_inputs(run.inputs)
+            except Exception as e:
+                raise ValueError(
+                    f"Could not parse LM input from run inputs {run.inputs}"
+                ) from e
+            try:
+                output_ = self.serialize_outputs(run.outputs)
+            except Exception as e:
+                raise ValueError(
+                    f"Could not parse LM prediction from run outputs {run.outputs}"
+                ) from e
+            return {"input": inputs, "prediction": output_}
+
+
+class ChainStringRunMapper(StringRunMapper):
+    """Extract items to evaluate from the run object from a chain."""
+
+    input_key: Optional[str] = None
+    """The key from the model Run's inputs to use as the eval input.
+    If not provided, will use the only input key or raise an
+    error if there are multiple."""
+    prediction_key: Optional[str] = None
+    """The key from the model Run's outputs to use as the eval prediction.
+    If not provided, will use the only output key or raise an error
+    if there are multiple."""
+
+    def _get_key(self, source: Dict, key: Optional[str], which: str) -> str:
+        if key is not None:
+            return source[key]
+        elif len(source) == 1:
+            return next(iter(source.values()))
+        else:
+            raise ValueError(
+                f"Could not map run {which} with multiple keys: "
+                f"{source}\nPlease manually specify a {which}_key"
+            )
+
+    def map(self, run: Run) -> Dict[str, str]:
+        """Maps the Run to a dictionary."""
+        if not run.outputs:
+            raise ValueError(
+                f"Run with ID {run.id} lacks outputs required for evaluation."
+                " Ensure the Run has valid outputs."
+            )
+        if self.input_key is not None and self.input_key not in run.inputs:
+            raise ValueError(
+                f"Run with ID {run.id} is missing the expected input key"
+                f" '{self.input_key}'.\nAvailable input keys in this Run"
+                f"  are: {run.inputs.keys()}.\nAdjust the evaluator's"
+                f" input_key or ensure your input data includes key"
+                f" '{self.input_key}'."
+            )
+        elif self.prediction_key is not None and self.prediction_key not in run.outputs:
+            available_keys = ", ".join(run.outputs.keys())
+            raise ValueError(
+                f"Run with ID {run.id} doesn't have the expected prediction key"
+                f" '{self.prediction_key}'. Available prediction keys in this Run are:"
+                f" {available_keys}. Adjust the evaluator's prediction_key or"
+                " ensure the Run object's outputs the expected key."
+            )
+
+        else:
+            input_ = self._get_key(run.inputs, self.input_key, "input")
+            prediction = self._get_key(run.outputs, self.prediction_key, "prediction")
+            return {
+                "input": input_,
+                "prediction": prediction,
+            }
+
+
+class ToolStringRunMapper(StringRunMapper):
+    """Map an input to the tool."""
+
+    def map(self, run: Run) -> Dict[str, str]:
+        if not run.outputs:
+            raise ValueError(f"Run {run.id} has no outputs to evaluate.")
+        return {"input": run.inputs["input"], "prediction": run.outputs["output"]}
+
+
+class StringExampleMapper(Serializable):
+    """Map an example, or row in the dataset, to the inputs of an evaluation."""
+
+    reference_key: Optional[str] = None
+
+    @property
+    def output_keys(self) -> List[str]:
+        """The keys to extract from the run."""
+        return ["reference"]
+
+    def serialize_chat_messages(self, messages: List[Dict]) -> str:
+        """Extract the input messages from the run."""
+        chat_messages = _get_messages_from_run_dict(messages)
+        return get_buffer_string(chat_messages)
+
+    def map(self, example: Example) -> Dict[str, str]:
+        """Maps the Example, or dataset row to a dictionary."""
+        if not example.outputs:
+            raise ValueError(
+                f"Example {example.id} has no outputs to use as a reference."
+            )
+        if self.reference_key is None:
+            if len(example.outputs) > 1:
+                raise ValueError(
+                    f"Example {example.id} has multiple outputs, so you must"
+                    " specify a reference_key."
+                )
+            else:
+                output = list(example.outputs.values())[0]
+        elif self.reference_key not in example.outputs:
+            raise ValueError(
+                f"Example {example.id} does not have reference key"
+                f" {self.reference_key}."
+            )
+        else:
+            output = example.outputs[self.reference_key]
+        return {
+            "reference": self.serialize_chat_messages([output])
+            if isinstance(output, dict) and output.get("type") and output.get("data")
+            else output
+        }
+
+    def __call__(self, example: Example) -> Dict[str, str]:
+        """Maps the Run and Example to a dictionary."""
+        if not example.outputs:
+            raise ValueError(
+                f"Example {example.id} has no outputs to use as areference label."
+            )
+        return self.map(example)
+
+
+class StringRunEvaluatorChain(Chain, RunEvaluator):
+    """Evaluate Run and optional examples."""
+
+    run_mapper: StringRunMapper
+    """Maps the Run to a dictionary with 'input' and 'prediction' strings."""
+    example_mapper: Optional[StringExampleMapper] = None
+    """Maps the Example (dataset row) to a dictionary
+    with a 'reference' string."""
+    name: str
+    """The name of the evaluation metric."""
+    string_evaluator: StringEvaluator
+    """The evaluation chain."""
+
+    @property
+    def input_keys(self) -> List[str]:
+        return ["run", "example"]
+
+    @property
+    def output_keys(self) -> List[str]:
+        return ["feedback"]
+
+    def _prepare_input(self, inputs: Dict[str, Any]) -> Dict[str, str]:
+        run: Run = inputs["run"]
+        example: Optional[Example] = inputs.get("example")
+        evaluate_strings_inputs = self.run_mapper(run)
+        if not self.string_evaluator.requires_input:
+            # Hide warning about unused input
+            evaluate_strings_inputs.pop("input", None)
+        if example and self.example_mapper and self.string_evaluator.requires_reference:
+            evaluate_strings_inputs.update(self.example_mapper(example))
+        elif self.string_evaluator.requires_reference:
+            raise ValueError(
+                f"Evaluator {self.name} requires an reference"
+                " example from the dataset,"
+                f" but none was provided for run {run.id}."
+            )
+        return evaluate_strings_inputs
+
+    def _prepare_output(self, output: Dict[str, Any]) -> Dict[str, Any]:
+        evaluation_result = EvaluationResult(
+            key=self.name, comment=output.get("reasoning"), **output
+        )
+        if RUN_KEY in output:
+            # TODO: Not currently surfaced. Update
+            evaluation_result.evaluator_info[RUN_KEY] = output[RUN_KEY]
+        return {"feedback": evaluation_result}
+
+    def _call(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[CallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Call the evaluation chain."""
+        evaluate_strings_inputs = self._prepare_input(inputs)
+        _run_manager = run_manager or CallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        chain_output = self.string_evaluator.evaluate_strings(
+            **evaluate_strings_inputs,
+            callbacks=callbacks,
+            include_run_info=True,
+        )
+        return self._prepare_output(chain_output)
+
+    async def _acall(
+        self,
+        inputs: Dict[str, str],
+        run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    ) -> Dict[str, Any]:
+        """Call the evaluation chain."""
+        evaluate_strings_inputs = self._prepare_input(inputs)
+        _run_manager = run_manager or AsyncCallbackManagerForChainRun.get_noop_manager()
+        callbacks = _run_manager.get_child()
+        chain_output = await self.string_evaluator.aevaluate_strings(
+            **evaluate_strings_inputs,
+            callbacks=callbacks,
+            include_run_info=True,
+        )
+        return self._prepare_output(chain_output)
+
+    def _prepare_evaluator_output(self, output: Dict[str, Any]) -> EvaluationResult:
+        feedback: EvaluationResult = output["feedback"]
+        if RUN_KEY not in feedback.evaluator_info:
+            feedback.evaluator_info[RUN_KEY] = output[RUN_KEY]
+        return feedback
+
+    def evaluate_run(
+        self, run: Run, example: Optional[Example] = None
+    ) -> EvaluationResult:
+        """Evaluate an example."""
+        try:
+            result = self({"run": run, "example": example}, include_run_info=True)
+            return self._prepare_evaluator_output(result)
+        except Exception as e:
+            return EvaluationResult(
+                key=self.string_evaluator.evaluation_name,
+                comment=f"Error evaluating run {run.id}: {e}",
+                # TODO: Add run ID once we can declare it via callbacks
+            )
+
+    async def aevaluate_run(
+        self, run: Run, example: Optional[Example] = None
+    ) -> EvaluationResult:
+        """Evaluate an example."""
+        try:
+            result = await self.acall(
+                {"run": run, "example": example}, include_run_info=True
+            )
+            return self._prepare_evaluator_output(result)
+        except Exception as e:
+            return EvaluationResult(
+                key=self.string_evaluator.evaluation_name,
+                comment=f"Error evaluating run {run.id}: {e}",
+            )
+
+    @classmethod
+    def from_run_and_data_type(
+        cls,
+        evaluator: StringEvaluator,
+        run_type: str,
+        data_type: DataType,
+        input_key: Optional[str] = None,
+        prediction_key: Optional[str] = None,
+        reference_key: Optional[str] = None,
+        tags: Optional[List[str]] = None,
+    ) -> StringRunEvaluatorChain:
+        """
+        Create a StringRunEvaluatorChain from an evaluator and the run and dataset types.
+
+        This method provides an easy way to instantiate a StringRunEvaluatorChain, by
+        taking an evaluator and information about the type of run and the data.
+        The method supports LLM and chain runs.
+
+        Args:
+            evaluator (StringEvaluator): The string evaluator to use.
+            run_type (str): The type of run being evaluated.
+                Supported types are LLM and Chain.
+            data_type (DataType): The type of dataset used in the run.
+            input_key (str, optional): The key used to map the input from the run.
+            prediction_key (str, optional): The key used to map the prediction from the run.
+            reference_key (str, optional): The key used to map the reference from the dataset.
+            tags (List[str], optional): List of tags to attach to the evaluation chain.
+
+        Returns:
+            StringRunEvaluatorChain: The instantiated evaluation chain.
+
+        Raises:
+            ValueError: If the run type is not supported, or if the evaluator requires a
+                reference from the dataset but the reference key is not provided.
+
+        """  # noqa: E501
+
+        # Configure how run inputs/predictions are passed to the evaluator
+        if run_type == "llm":
+            run_mapper: StringRunMapper = LLMStringRunMapper()
+        elif run_type == "chain":
+            run_mapper = ChainStringRunMapper(
+                input_key=input_key, prediction_key=prediction_key
+            )
+        else:
+            raise ValueError(
+                f"Unsupported run type {run_type}. Expected one of 'llm' or 'chain'."
+            )
+
+        # Configure how example rows are fed as a reference string to the evaluator
+        if (
+            reference_key is not None
+            or data_type in (DataType.llm, DataType.chat)
+            or evaluator.requires_reference
+        ):
+            example_mapper = StringExampleMapper(reference_key=reference_key)
+        elif evaluator.requires_reference:
+            raise ValueError(
+                f"Evaluator {evaluator.evaluation_name} requires a reference"
+                " example from the dataset. Please specify the reference key from"
+                " amongst the dataset outputs keys."
+            )
+        else:
+            example_mapper = None
+        return cls(
+            name=evaluator.evaluation_name,
+            run_mapper=run_mapper,
+            example_mapper=example_mapper,
+            string_evaluator=evaluator,
+            tags=tags,
+        )
diff --git a/llm/Lib/site-packages/langchain/smith/evaluation/utils.py b/llm/Lib/site-packages/langchain/smith/evaluation/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/sql_database.py b/llm/Lib/site-packages/langchain/sql_database.py
new file mode 100644
index 0000000000000000000000000000000000000000..a1de4ade2aaa8c8bdf18ef634366fc176946f87b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/sql_database.py
@@ -0,0 +1,4 @@
+"""Keep here for backwards compatibility."""
+from langchain_community.utilities.sql_database import SQLDatabase
+
+__all__ = ["SQLDatabase"]
diff --git a/llm/Lib/site-packages/langchain/storage/__init__.py b/llm/Lib/site-packages/langchain/storage/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..aae71c5e902e2160dcb678d89ecd9c6afcb5b0bb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/storage/__init__.py
@@ -0,0 +1,47 @@
+"""Implementations of key-value stores and storage helpers.
+
+Module provides implementations of various key-value stores that conform
+to a simple key-value interface.
+
+The primary goal of these storages is to support implementation of caching.
+"""
+import warnings
+from typing import Any
+
+from langchain_core._api import LangChainDeprecationWarning
+
+from langchain.storage._lc_store import create_kv_docstore, create_lc_store
+from langchain.storage.encoder_backed import EncoderBackedStore
+from langchain.storage.file_system import LocalFileStore
+from langchain.storage.in_memory import InMemoryByteStore, InMemoryStore
+from langchain.utils.interactive_env import is_interactive_env
+
+
+def __getattr__(name: str) -> Any:
+    from langchain_community import storage
+
+    # If not in interactive env, raise warning.
+    if not is_interactive_env():
+        warnings.warn(
+            "Importing stores from langchain is deprecated. Importing from "
+            "langchain will no longer be supported as of langchain==0.2.0. "
+            "Please import from langchain-community instead:\n\n"
+            f"`from langchain_community.storage import {name}`.\n\n"
+            "To install langchain-community run `pip install -U langchain-community`.",
+            category=LangChainDeprecationWarning,
+        )
+
+    return getattr(storage, name)
+
+
+__all__ = [
+    "EncoderBackedStore",
+    "InMemoryStore",
+    "InMemoryByteStore",
+    "LocalFileStore",
+    "RedisStore",
+    "create_lc_store",
+    "create_kv_docstore",
+    "UpstashRedisByteStore",
+    "UpstashRedisStore",
+]
diff --git a/llm/Lib/site-packages/langchain/storage/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/storage/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..61178ea6136dd4307ad6ee5a3601ae2fcd13ccf9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/storage/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/storage/__pycache__/_lc_store.cpython-311.pyc b/llm/Lib/site-packages/langchain/storage/__pycache__/_lc_store.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1011dad80c79c81a69fae3137b99a46b8fc36e5b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/storage/__pycache__/_lc_store.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/storage/__pycache__/encoder_backed.cpython-311.pyc b/llm/Lib/site-packages/langchain/storage/__pycache__/encoder_backed.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..af98754aa48ca20db64696372d37a7e26e112619
Binary files /dev/null and b/llm/Lib/site-packages/langchain/storage/__pycache__/encoder_backed.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/storage/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/langchain/storage/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b1844d3bcab842cdb3d6f52417b1f9fd215cda11
Binary files /dev/null and b/llm/Lib/site-packages/langchain/storage/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/storage/__pycache__/file_system.cpython-311.pyc b/llm/Lib/site-packages/langchain/storage/__pycache__/file_system.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..762acc57ffd5134eecd3c631510ad3bddb522418
Binary files /dev/null and b/llm/Lib/site-packages/langchain/storage/__pycache__/file_system.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/storage/__pycache__/in_memory.cpython-311.pyc b/llm/Lib/site-packages/langchain/storage/__pycache__/in_memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..71b3f1e6fd24b12eb10f159c53847686f67223f9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/storage/__pycache__/in_memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/storage/__pycache__/redis.cpython-311.pyc b/llm/Lib/site-packages/langchain/storage/__pycache__/redis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a744e7c851c923cdfb4a0b6d205f43e124651b19
Binary files /dev/null and b/llm/Lib/site-packages/langchain/storage/__pycache__/redis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/storage/__pycache__/upstash_redis.cpython-311.pyc b/llm/Lib/site-packages/langchain/storage/__pycache__/upstash_redis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..07b3da1cbabd48f53d46bd8ae4cb61fdc202b505
Binary files /dev/null and b/llm/Lib/site-packages/langchain/storage/__pycache__/upstash_redis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/storage/_lc_store.py b/llm/Lib/site-packages/langchain/storage/_lc_store.py
new file mode 100644
index 0000000000000000000000000000000000000000..3574749e7590b2b9dba4340c65910ad458456934
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/storage/_lc_store.py
@@ -0,0 +1,88 @@
+"""Create a key-value store for any langchain serializable object."""
+from typing import Callable, Optional
+
+from langchain_core.documents import Document
+from langchain_core.load import Serializable, dumps, loads
+from langchain_core.stores import BaseStore, ByteStore
+
+from langchain.storage.encoder_backed import EncoderBackedStore
+
+
+def _dump_as_bytes(obj: Serializable) -> bytes:
+    """Return a bytes representation of a document."""
+    return dumps(obj).encode("utf-8")
+
+
+def _dump_document_as_bytes(obj: Document) -> bytes:
+    """Return a bytes representation of a document."""
+    if not isinstance(obj, Document):
+        raise TypeError("Expected a Document instance")
+    return dumps(obj).encode("utf-8")
+
+
+def _load_document_from_bytes(serialized: bytes) -> Document:
+    """Return a document from a bytes representation."""
+    obj = loads(serialized.decode("utf-8"))
+    if not isinstance(obj, Document):
+        raise TypeError(f"Expected a Document instance. Got {type(obj)}")
+    return obj
+
+
+def _load_from_bytes(serialized: bytes) -> Serializable:
+    """Return a document from a bytes representation."""
+    return loads(serialized.decode("utf-8"))
+
+
+def _identity(x: str) -> str:
+    """Return the same object."""
+    return x
+
+
+# PUBLIC API
+
+
+def create_lc_store(
+    store: ByteStore,
+    *,
+    key_encoder: Optional[Callable[[str], str]] = None,
+) -> BaseStore[str, Serializable]:
+    """Create a store for langchain serializable objects from a bytes store.
+
+    Args:
+        store: A bytes store to use as the underlying store.
+        key_encoder: A function to encode keys; if None uses identity function.
+
+    Returns:
+        A key-value store for documents.
+    """
+    return EncoderBackedStore(
+        store,
+        key_encoder or _identity,
+        _dump_as_bytes,
+        _load_from_bytes,
+    )
+
+
+def create_kv_docstore(
+    store: ByteStore,
+    *,
+    key_encoder: Optional[Callable[[str], str]] = None,
+) -> BaseStore[str, Document]:
+    """Create a store for langchain Document objects from a bytes store.
+
+    This store does run time type checking to ensure that the values are
+    Document objects.
+
+    Args:
+        store: A bytes store to use as the underlying store.
+        key_encoder: A function to encode keys; if None uses identity function.
+
+    Returns:
+        A key-value store for documents.
+    """
+    return EncoderBackedStore(
+        store,
+        key_encoder or _identity,
+        _dump_document_as_bytes,
+        _load_document_from_bytes,
+    )
diff --git a/llm/Lib/site-packages/langchain/storage/encoder_backed.py b/llm/Lib/site-packages/langchain/storage/encoder_backed.py
new file mode 100644
index 0000000000000000000000000000000000000000..041b0e3498a043b7af5af212ed7fe36b376c5b9c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/storage/encoder_backed.py
@@ -0,0 +1,127 @@
+from typing import (
+    Any,
+    AsyncIterator,
+    Callable,
+    Iterator,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    TypeVar,
+    Union,
+)
+
+from langchain_core.stores import BaseStore
+
+K = TypeVar("K")
+V = TypeVar("V")
+
+
+class EncoderBackedStore(BaseStore[K, V]):
+    """Wraps a store with key and value encoders/decoders.
+
+    Examples that uses JSON for encoding/decoding:
+
+    .. code-block:: python
+
+        import json
+
+        def key_encoder(key: int) -> str:
+            return json.dumps(key)
+
+        def value_serializer(value: float) -> str:
+            return json.dumps(value)
+
+        def value_deserializer(serialized_value: str) -> float:
+            return json.loads(serialized_value)
+
+        # Create an instance of the abstract store
+        abstract_store = MyCustomStore()
+
+        # Create an instance of the encoder-backed store
+        store = EncoderBackedStore(
+            store=abstract_store,
+            key_encoder=key_encoder,
+            value_serializer=value_serializer,
+            value_deserializer=value_deserializer
+        )
+
+        # Use the encoder-backed store methods
+        store.mset([(1, 3.14), (2, 2.718)])
+        values = store.mget([1, 2])  # Retrieves [3.14, 2.718]
+        store.mdelete([1, 2])  # Deletes the keys 1 and 2
+    """
+
+    def __init__(
+        self,
+        store: BaseStore[str, Any],
+        key_encoder: Callable[[K], str],
+        value_serializer: Callable[[V], bytes],
+        value_deserializer: Callable[[Any], V],
+    ) -> None:
+        """Initialize an EncodedStore."""
+        self.store = store
+        self.key_encoder = key_encoder
+        self.value_serializer = value_serializer
+        self.value_deserializer = value_deserializer
+
+    def mget(self, keys: Sequence[K]) -> List[Optional[V]]:
+        """Get the values associated with the given keys."""
+        encoded_keys: List[str] = [self.key_encoder(key) for key in keys]
+        values = self.store.mget(encoded_keys)
+        return [
+            self.value_deserializer(value) if value is not None else value
+            for value in values
+        ]
+
+    async def amget(self, keys: Sequence[K]) -> List[Optional[V]]:
+        """Get the values associated with the given keys."""
+        encoded_keys: List[str] = [self.key_encoder(key) for key in keys]
+        values = await self.store.amget(encoded_keys)
+        return [
+            self.value_deserializer(value) if value is not None else value
+            for value in values
+        ]
+
+    def mset(self, key_value_pairs: Sequence[Tuple[K, V]]) -> None:
+        """Set the values for the given keys."""
+        encoded_pairs = [
+            (self.key_encoder(key), self.value_serializer(value))
+            for key, value in key_value_pairs
+        ]
+        self.store.mset(encoded_pairs)
+
+    async def amset(self, key_value_pairs: Sequence[Tuple[K, V]]) -> None:
+        """Set the values for the given keys."""
+        encoded_pairs = [
+            (self.key_encoder(key), self.value_serializer(value))
+            for key, value in key_value_pairs
+        ]
+        await self.store.amset(encoded_pairs)
+
+    def mdelete(self, keys: Sequence[K]) -> None:
+        """Delete the given keys and their associated values."""
+        encoded_keys = [self.key_encoder(key) for key in keys]
+        self.store.mdelete(encoded_keys)
+
+    async def amdelete(self, keys: Sequence[K]) -> None:
+        """Delete the given keys and their associated values."""
+        encoded_keys = [self.key_encoder(key) for key in keys]
+        await self.store.amdelete(encoded_keys)
+
+    def yield_keys(
+        self, *, prefix: Optional[str] = None
+    ) -> Union[Iterator[K], Iterator[str]]:
+        """Get an iterator over keys that match the given prefix."""
+        # For the time being this does not return K, but str
+        # it's for debugging purposes. Should fix this.
+        yield from self.store.yield_keys(prefix=prefix)
+
+    async def ayield_keys(
+        self, *, prefix: Optional[str] = None
+    ) -> Union[AsyncIterator[K], AsyncIterator[str]]:
+        """Get an iterator over keys that match the given prefix."""
+        # For the time being this does not return K, but str
+        # it's for debugging purposes. Should fix this.
+        async for key in self.store.ayield_keys(prefix=prefix):
+            yield key
diff --git a/llm/Lib/site-packages/langchain/storage/exceptions.py b/llm/Lib/site-packages/langchain/storage/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..3d7cc3ea010db73e6f808958a026fe422bb2b090
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/storage/exceptions.py
@@ -0,0 +1,3 @@
+from langchain_community.storage.exceptions import InvalidKeyException
+
+__all__ = ["InvalidKeyException"]
diff --git a/llm/Lib/site-packages/langchain/storage/file_system.py b/llm/Lib/site-packages/langchain/storage/file_system.py
new file mode 100644
index 0000000000000000000000000000000000000000..3437684758a5b8f9a20eaaa8e0072415510cb5cb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/storage/file_system.py
@@ -0,0 +1,162 @@
+import os
+import re
+from pathlib import Path
+from typing import Iterator, List, Optional, Sequence, Tuple, Union
+
+from langchain_core.stores import ByteStore
+
+from langchain.storage.exceptions import InvalidKeyException
+
+
+class LocalFileStore(ByteStore):
+    """BaseStore interface that works on the local file system.
+
+    Examples:
+        Create a LocalFileStore instance and perform operations on it:
+
+        .. code-block:: python
+
+            from langchain.storage import LocalFileStore
+
+            # Instantiate the LocalFileStore with the root path
+            file_store = LocalFileStore("/path/to/root")
+
+            # Set values for keys
+            file_store.mset([("key1", b"value1"), ("key2", b"value2")])
+
+            # Get values for keys
+            values = file_store.mget(["key1", "key2"])  # Returns [b"value1", b"value2"]
+
+            # Delete keys
+            file_store.mdelete(["key1"])
+
+            # Iterate over keys
+            for key in file_store.yield_keys():
+                print(key)  # noqa: T201
+
+    """
+
+    def __init__(
+        self,
+        root_path: Union[str, Path],
+        *,
+        chmod_file: Optional[int] = None,
+        chmod_dir: Optional[int] = None,
+    ) -> None:
+        """Implement the BaseStore interface for the local file system.
+
+        Args:
+            root_path (Union[str, Path]): The root path of the file store. All keys are
+                interpreted as paths relative to this root.
+            chmod_file: (optional, defaults to `None`) If specified, sets permissions
+                for newly created files, overriding the current `umask` if needed.
+            chmod_dir: (optional, defaults to `None`) If specified, sets permissions
+                for newly created dirs, overriding the current `umask` if needed.
+        """
+        self.root_path = Path(root_path).absolute()
+        self.chmod_file = chmod_file
+        self.chmod_dir = chmod_dir
+
+    def _get_full_path(self, key: str) -> Path:
+        """Get the full path for a given key relative to the root path.
+
+        Args:
+            key (str): The key relative to the root path.
+
+        Returns:
+            Path: The full path for the given key.
+        """
+        if not re.match(r"^[a-zA-Z0-9_.\-/]+$", key):
+            raise InvalidKeyException(f"Invalid characters in key: {key}")
+        full_path = os.path.abspath(self.root_path / key)
+        common_path = os.path.commonpath([str(self.root_path), full_path])
+        if common_path != str(self.root_path):
+            raise InvalidKeyException(
+                f"Invalid key: {key}. Key should be relative to the full path."
+                f"{self.root_path} vs. {common_path} and full path of {full_path}"
+            )
+
+        return Path(full_path)
+
+    def _mkdir_for_store(self, dir: Path) -> None:
+        """Makes a store directory path (including parents) with specified permissions
+
+        This is needed because `Path.mkdir()` is restricted by the current `umask`,
+        whereas the explicit `os.chmod()` used here is not.
+
+        Args:
+            dir: (Path) The store directory to make
+
+        Returns:
+            None
+        """
+        if not dir.exists():
+            self._mkdir_for_store(dir.parent)
+            dir.mkdir(exist_ok=True)
+            if self.chmod_dir is not None:
+                os.chmod(dir, self.chmod_dir)
+
+    def mget(self, keys: Sequence[str]) -> List[Optional[bytes]]:
+        """Get the values associated with the given keys.
+
+        Args:
+            keys: A sequence of keys.
+
+        Returns:
+            A sequence of optional values associated with the keys.
+            If a key is not found, the corresponding value will be None.
+        """
+        values: List[Optional[bytes]] = []
+        for key in keys:
+            full_path = self._get_full_path(key)
+            if full_path.exists():
+                value = full_path.read_bytes()
+                values.append(value)
+            else:
+                values.append(None)
+        return values
+
+    def mset(self, key_value_pairs: Sequence[Tuple[str, bytes]]) -> None:
+        """Set the values for the given keys.
+
+        Args:
+            key_value_pairs: A sequence of key-value pairs.
+
+        Returns:
+            None
+        """
+        for key, value in key_value_pairs:
+            full_path = self._get_full_path(key)
+            self._mkdir_for_store(full_path.parent)
+            full_path.write_bytes(value)
+            if self.chmod_file is not None:
+                os.chmod(full_path, self.chmod_file)
+
+    def mdelete(self, keys: Sequence[str]) -> None:
+        """Delete the given keys and their associated values.
+
+        Args:
+            keys (Sequence[str]): A sequence of keys to delete.
+
+        Returns:
+            None
+        """
+        for key in keys:
+            full_path = self._get_full_path(key)
+            if full_path.exists():
+                full_path.unlink()
+
+    def yield_keys(self, prefix: Optional[str] = None) -> Iterator[str]:
+        """Get an iterator over keys that match the given prefix.
+
+        Args:
+            prefix (Optional[str]): The prefix to match.
+
+        Returns:
+            Iterator[str]: An iterator over keys that match the given prefix.
+        """
+        prefix_path = self._get_full_path(prefix) if prefix else self.root_path
+        for file in prefix_path.rglob("*"):
+            if file.is_file():
+                relative_path = file.relative_to(self.root_path)
+                yield str(relative_path)
diff --git a/llm/Lib/site-packages/langchain/storage/in_memory.py b/llm/Lib/site-packages/langchain/storage/in_memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..310f81ce28f7c2052e17efe484adbbaa2bc205e4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/storage/in_memory.py
@@ -0,0 +1,152 @@
+"""In memory store that is not thread safe and has no eviction policy.
+
+This is a simple implementation of the BaseStore using a dictionary that is useful
+primarily for unit testing purposes.
+"""
+from typing import (
+    Any,
+    AsyncIterator,
+    Dict,
+    Generic,
+    Iterator,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    TypeVar,
+)
+
+from langchain_core.stores import BaseStore
+
+V = TypeVar("V")
+
+
+class InMemoryBaseStore(BaseStore[str, V], Generic[V]):
+    """In-memory implementation of the BaseStore using a dictionary.
+
+    Attributes:
+        store (Dict[str, Any]): The underlying dictionary that stores
+            the key-value pairs.
+
+    Examples:
+
+        .. code-block:: python
+
+            from langchain.storage import InMemoryStore
+
+            store = InMemoryStore()
+            store.mset([('key1', 'value1'), ('key2', 'value2')])
+            store.mget(['key1', 'key2'])
+            # ['value1', 'value2']
+            store.mdelete(['key1'])
+            list(store.yield_keys())
+            # ['key2']
+            list(store.yield_keys(prefix='k'))
+            # ['key2']
+    """
+
+    def __init__(self) -> None:
+        """Initialize an empty store."""
+        self.store: Dict[str, V] = {}
+
+    def mget(self, keys: Sequence[str]) -> List[Optional[V]]:
+        """Get the values associated with the given keys.
+
+        Args:
+            keys (Sequence[str]): A sequence of keys.
+
+        Returns:
+            A sequence of optional values associated with the keys.
+            If a key is not found, the corresponding value will be None.
+        """
+        return [self.store.get(key) for key in keys]
+
+    async def amget(self, keys: Sequence[str]) -> List[Optional[V]]:
+        """Get the values associated with the given keys.
+
+        Args:
+            keys (Sequence[str]): A sequence of keys.
+
+        Returns:
+            A sequence of optional values associated with the keys.
+            If a key is not found, the corresponding value will be None.
+        """
+        return self.mget(keys)
+
+    def mset(self, key_value_pairs: Sequence[Tuple[str, V]]) -> None:
+        """Set the values for the given keys.
+
+        Args:
+            key_value_pairs (Sequence[Tuple[str, V]]): A sequence of key-value pairs.
+
+        Returns:
+            None
+        """
+        for key, value in key_value_pairs:
+            self.store[key] = value
+
+    async def amset(self, key_value_pairs: Sequence[Tuple[str, V]]) -> None:
+        """Set the values for the given keys.
+
+        Args:
+            key_value_pairs (Sequence[Tuple[str, V]]): A sequence of key-value pairs.
+
+        Returns:
+            None
+        """
+        return self.mset(key_value_pairs)
+
+    def mdelete(self, keys: Sequence[str]) -> None:
+        """Delete the given keys and their associated values.
+
+        Args:
+            keys (Sequence[str]): A sequence of keys to delete.
+        """
+        for key in keys:
+            if key in self.store:
+                del self.store[key]
+
+    async def amdelete(self, keys: Sequence[str]) -> None:
+        """Delete the given keys and their associated values.
+
+        Args:
+            keys (Sequence[str]): A sequence of keys to delete.
+        """
+        self.mdelete(keys)
+
+    def yield_keys(self, prefix: Optional[str] = None) -> Iterator[str]:
+        """Get an iterator over keys that match the given prefix.
+
+        Args:
+            prefix (str, optional): The prefix to match. Defaults to None.
+
+        Returns:
+            Iterator[str]: An iterator over keys that match the given prefix.
+        """
+        if prefix is None:
+            yield from self.store.keys()
+        else:
+            for key in self.store.keys():
+                if key.startswith(prefix):
+                    yield key
+
+    async def ayield_keys(self, prefix: Optional[str] = None) -> AsyncIterator[str]:
+        """Get an async iterator over keys that match the given prefix.
+
+        Args:
+            prefix (str, optional): The prefix to match. Defaults to None.
+
+        Returns:
+            AsyncIterator[str]: An async iterator over keys that match the given prefix.
+        """
+        if prefix is None:
+            for key in self.store.keys():
+                yield key
+        else:
+            for key in self.store.keys():
+                if key.startswith(prefix):
+                    yield key
+
+
+InMemoryStore = InMemoryBaseStore[Any]
+InMemoryByteStore = InMemoryBaseStore[bytes]
diff --git a/llm/Lib/site-packages/langchain/storage/redis.py b/llm/Lib/site-packages/langchain/storage/redis.py
new file mode 100644
index 0000000000000000000000000000000000000000..bea04c92b783aa801bccc155a3f3ce75969c673c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/storage/redis.py
@@ -0,0 +1,3 @@
+from langchain_community.storage.redis import RedisStore
+
+__all__ = ["RedisStore"]
diff --git a/llm/Lib/site-packages/langchain/storage/upstash_redis.py b/llm/Lib/site-packages/langchain/storage/upstash_redis.py
new file mode 100644
index 0000000000000000000000000000000000000000..590389394e5de0ab9a2fafba5dc419127a432721
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/storage/upstash_redis.py
@@ -0,0 +1,6 @@
+from langchain_community.storage.upstash_redis import (
+    UpstashRedisByteStore,
+    UpstashRedisStore,
+)
+
+__all__ = ["UpstashRedisStore", "UpstashRedisByteStore"]
diff --git a/llm/Lib/site-packages/langchain/text_splitter.py b/llm/Lib/site-packages/langchain/text_splitter.py
new file mode 100644
index 0000000000000000000000000000000000000000..36afa7ec6092cff5951374fbe16400a967d842a6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/text_splitter.py
@@ -0,0 +1,49 @@
+"""Kept for backwards compatibility."""
+from langchain_text_splitters import (
+    Language,
+    RecursiveCharacterTextSplitter,
+    TextSplitter,
+    Tokenizer,
+    TokenTextSplitter,
+)
+from langchain_text_splitters.base import split_text_on_tokens
+from langchain_text_splitters.character import CharacterTextSplitter
+from langchain_text_splitters.html import ElementType, HTMLHeaderTextSplitter
+from langchain_text_splitters.json import RecursiveJsonSplitter
+from langchain_text_splitters.konlpy import KonlpyTextSplitter
+from langchain_text_splitters.latex import LatexTextSplitter
+from langchain_text_splitters.markdown import (
+    HeaderType,
+    LineType,
+    MarkdownHeaderTextSplitter,
+    MarkdownTextSplitter,
+)
+from langchain_text_splitters.nltk import NLTKTextSplitter
+from langchain_text_splitters.python import PythonCodeTextSplitter
+from langchain_text_splitters.sentence_transformers import (
+    SentenceTransformersTokenTextSplitter,
+)
+from langchain_text_splitters.spacy import SpacyTextSplitter
+
+__all__ = [
+    "TokenTextSplitter",
+    "TextSplitter",
+    "Tokenizer",
+    "Language",
+    "RecursiveCharacterTextSplitter",
+    "RecursiveJsonSplitter",
+    "LatexTextSplitter",
+    "PythonCodeTextSplitter",
+    "KonlpyTextSplitter",
+    "SpacyTextSplitter",
+    "NLTKTextSplitter",
+    "split_text_on_tokens",
+    "SentenceTransformersTokenTextSplitter",
+    "ElementType",
+    "HeaderType",
+    "LineType",
+    "HTMLHeaderTextSplitter",
+    "MarkdownHeaderTextSplitter",
+    "MarkdownTextSplitter",
+    "CharacterTextSplitter",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/__init__.py b/llm/Lib/site-packages/langchain/tools/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c96f8db95a789e4b11c4a441a17c168a02c8a70b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/__init__.py
@@ -0,0 +1,196 @@
+"""**Tools** are classes that an Agent uses to interact with the world.
+
+Each tool has a **description**. Agent uses the description to choose the right
+tool for the job.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    ToolMetaclass --> BaseTool --> <name>Tool  # Examples: AIPluginTool, BaseGraphQLTool
+                                   <name>      # Examples: BraveSearch, HumanInputRun
+
+**Main helpers:**
+
+.. code-block::
+
+    CallbackManagerForToolRun, AsyncCallbackManagerForToolRun
+"""
+import warnings
+from typing import Any
+
+from langchain_core._api import LangChainDeprecationWarning
+from langchain_core.tools import BaseTool, StructuredTool, Tool, tool
+
+from langchain.utils.interactive_env import is_interactive_env
+
+# Used for internal purposes
+_DEPRECATED_TOOLS = {"PythonAstREPLTool", "PythonREPLTool"}
+
+
+def _import_python_tool_PythonAstREPLTool() -> Any:
+    raise ImportError(
+        "This tool has been moved to langchain experiment. "
+        "This tool has access to a python REPL. "
+        "For best practices make sure to sandbox this tool. "
+        "Read https://github.com/langchain-ai/langchain/blob/master/SECURITY.md "
+        "To keep using this code as is, install langchain experimental and "
+        "update relevant imports replacing 'langchain' with 'langchain_experimental'"
+    )
+
+
+def _import_python_tool_PythonREPLTool() -> Any:
+    raise ImportError(
+        "This tool has been moved to langchain experiment. "
+        "This tool has access to a python REPL. "
+        "For best practices make sure to sandbox this tool. "
+        "Read https://github.com/langchain-ai/langchain/blob/master/SECURITY.md "
+        "To keep using this code as is, install langchain experimental and "
+        "update relevant imports replacing 'langchain' with 'langchain_experimental'"
+    )
+
+
+def __getattr__(name: str) -> Any:
+    if name == "PythonAstREPLTool":
+        return _import_python_tool_PythonAstREPLTool()
+    elif name == "PythonREPLTool":
+        return _import_python_tool_PythonREPLTool()
+    else:
+        from langchain_community import tools
+
+        # If not in interactive env, raise warning.
+        if not is_interactive_env():
+            warnings.warn(
+                "Importing tools from langchain is deprecated. Importing from "
+                "langchain will no longer be supported as of langchain==0.2.0. "
+                "Please import from langchain-community instead:\n\n"
+                f"`from langchain_community.tools import {name}`.\n\n"
+                "To install langchain-community run "
+                "`pip install -U langchain-community`.",
+                category=LangChainDeprecationWarning,
+            )
+
+        return getattr(tools, name)
+
+
+__all__ = [
+    "AINAppOps",
+    "AINOwnerOps",
+    "AINRuleOps",
+    "AINTransfer",
+    "AINValueOps",
+    "AIPluginTool",
+    "APIOperation",
+    "ArxivQueryRun",
+    "AzureCogsFormRecognizerTool",
+    "AzureCogsImageAnalysisTool",
+    "AzureCogsSpeech2TextTool",
+    "AzureCogsText2SpeechTool",
+    "AzureCogsTextAnalyticsHealthTool",
+    "BaseGraphQLTool",
+    "BaseRequestsTool",
+    "BaseSQLDatabaseTool",
+    "BaseSparkSQLTool",
+    "BaseTool",
+    "BearlyInterpreterTool",
+    "BingSearchResults",
+    "BingSearchRun",
+    "BraveSearch",
+    "ClickTool",
+    "CopyFileTool",
+    "CurrentWebPageTool",
+    "DeleteFileTool",
+    "DuckDuckGoSearchResults",
+    "DuckDuckGoSearchRun",
+    "E2BDataAnalysisTool",
+    "EdenAiExplicitImageTool",
+    "EdenAiObjectDetectionTool",
+    "EdenAiParsingIDTool",
+    "EdenAiParsingInvoiceTool",
+    "EdenAiSpeechToTextTool",
+    "EdenAiTextModerationTool",
+    "EdenAiTextToSpeechTool",
+    "EdenaiTool",
+    "ElevenLabsText2SpeechTool",
+    "ExtractHyperlinksTool",
+    "ExtractTextTool",
+    "FileSearchTool",
+    "GetElementsTool",
+    "GmailCreateDraft",
+    "GmailGetMessage",
+    "GmailGetThread",
+    "GmailSearch",
+    "GmailSendMessage",
+    "GoogleCloudTextToSpeechTool",
+    "GooglePlacesTool",
+    "GoogleSearchResults",
+    "GoogleSearchRun",
+    "GoogleSerperResults",
+    "GoogleSerperRun",
+    "SearchAPIResults",
+    "SearchAPIRun",
+    "HumanInputRun",
+    "IFTTTWebhook",
+    "InfoPowerBITool",
+    "InfoSQLDatabaseTool",
+    "InfoSparkSQLTool",
+    "JiraAction",
+    "JsonGetValueTool",
+    "JsonListKeysTool",
+    "ListDirectoryTool",
+    "ListPowerBITool",
+    "ListSQLDatabaseTool",
+    "ListSparkSQLTool",
+    "MerriamWebsterQueryRun",
+    "MetaphorSearchResults",
+    "MoveFileTool",
+    "NasaAction",
+    "NavigateBackTool",
+    "NavigateTool",
+    "O365CreateDraftMessage",
+    "O365SearchEmails",
+    "O365SearchEvents",
+    "O365SendEvent",
+    "O365SendMessage",
+    "OpenAPISpec",
+    "OpenWeatherMapQueryRun",
+    "PubmedQueryRun",
+    "RedditSearchRun",
+    "QueryCheckerTool",
+    "QueryPowerBITool",
+    "QuerySQLCheckerTool",
+    "QuerySQLDataBaseTool",
+    "QuerySparkSQLTool",
+    "ReadFileTool",
+    "RequestsDeleteTool",
+    "RequestsGetTool",
+    "RequestsPatchTool",
+    "RequestsPostTool",
+    "RequestsPutTool",
+    "SteamWebAPIQueryRun",
+    "SceneXplainTool",
+    "SearxSearchResults",
+    "SearxSearchRun",
+    "ShellTool",
+    "SlackGetChannel",
+    "SlackGetMessage",
+    "SlackScheduleMessage",
+    "SlackSendMessage",
+    "SleepTool",
+    "StdInInquireTool",
+    "StackExchangeTool",
+    "SteamshipImageGenerationTool",
+    "StructuredTool",
+    "Tool",
+    "VectorStoreQATool",
+    "VectorStoreQAWithSourcesTool",
+    "WikipediaQueryRun",
+    "WolframAlphaQueryRun",
+    "WriteFileTool",
+    "YahooFinanceNewsTool",
+    "YouTubeSearchTool",
+    "ZapierNLAListActions",
+    "ZapierNLARunAction",
+    "format_tool_to_openai_function",
+    "tool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bcd2bebfcf73f6e14dd043b62895b9704d642ccd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3b5c2e1c5eda7d7f0ec0c4ac7bc9b05b26bffb1e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/__pycache__/convert_to_openai.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/__pycache__/convert_to_openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3887f9f360052a3b84f362ee7d842854cffc852c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/__pycache__/convert_to_openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/__pycache__/ifttt.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/__pycache__/ifttt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4cee366ee88ce0d297f15775e63f5a935a822b42
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/__pycache__/ifttt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/__pycache__/plugin.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/__pycache__/plugin.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0871ee4a3809e385a18622ec2b7d7e94f4194eee
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/__pycache__/plugin.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/__pycache__/render.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/__pycache__/render.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0c054e6e29ecd9d3905121a1acf5df7d548fcfe0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/__pycache__/render.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/__pycache__/retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/__pycache__/retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8f57e2f5e49aa36eb1fd31eb7e4c7db78e04238b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/__pycache__/retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/__pycache__/yahoo_finance_news.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/__pycache__/yahoo_finance_news.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9acdcfc594983d6d375dd973a0f0f84d80fa1c98
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/__pycache__/yahoo_finance_news.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/app.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/app.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c0c40ade03d42c26582055e5b8290fba5f52c14d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/app.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..849493182654aba94f86d0185a3bc111128b0afb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/owner.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/owner.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0a5b0ca90bd9583b54e2de726211dc1b9dc25708
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/owner.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/rule.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/rule.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..25736e92de32b4246362cb4016210cc93b919d46
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/rule.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/transfer.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/transfer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8caacabee5bf39a1bb2c77d68df9fc567a43bbe0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/transfer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/value.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/value.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a81169ad1d5a1ea24fea26be4d9f4f2bc641b269
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/ainetwork/__pycache__/value.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/ainetwork/app.py b/llm/Lib/site-packages/langchain/tools/ainetwork/app.py
new file mode 100644
index 0000000000000000000000000000000000000000..1b0976670aee87b67db64bf8bdb6d3ccf833c87b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/ainetwork/app.py
@@ -0,0 +1,7 @@
+from langchain_community.tools.ainetwork.app import (
+    AINAppOps,
+    AppOperationType,
+    AppSchema,
+)
+
+__all__ = ["AppOperationType", "AppSchema", "AINAppOps"]
diff --git a/llm/Lib/site-packages/langchain/tools/ainetwork/base.py b/llm/Lib/site-packages/langchain/tools/ainetwork/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..357a3d142a43fd9c05393243a0edb7e4090a2f67
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/ainetwork/base.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.ainetwork.base import AINBaseTool, OperationType
+
+__all__ = ["OperationType", "AINBaseTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/ainetwork/owner.py b/llm/Lib/site-packages/langchain/tools/ainetwork/owner.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc21b2f48eb6e00a2f94fb15ced7bbab989bcfb5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/ainetwork/owner.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.ainetwork.owner import AINOwnerOps, RuleSchema
+
+__all__ = ["RuleSchema", "AINOwnerOps"]
diff --git a/llm/Lib/site-packages/langchain/tools/ainetwork/rule.py b/llm/Lib/site-packages/langchain/tools/ainetwork/rule.py
new file mode 100644
index 0000000000000000000000000000000000000000..36c1bfef3f0f41ae80d67d25a44ccae1220870e5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/ainetwork/rule.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.ainetwork.rule import AINRuleOps, RuleSchema
+
+__all__ = ["RuleSchema", "AINRuleOps"]
diff --git a/llm/Lib/site-packages/langchain/tools/ainetwork/transfer.py b/llm/Lib/site-packages/langchain/tools/ainetwork/transfer.py
new file mode 100644
index 0000000000000000000000000000000000000000..6cf3eeb6bf7731971fbf7318114fbcee6865e0d0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/ainetwork/transfer.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.ainetwork.transfer import AINTransfer, TransferSchema
+
+__all__ = ["TransferSchema", "AINTransfer"]
diff --git a/llm/Lib/site-packages/langchain/tools/ainetwork/value.py b/llm/Lib/site-packages/langchain/tools/ainetwork/value.py
new file mode 100644
index 0000000000000000000000000000000000000000..c730c20fa1aece8fd25e3e8c4363983935514d86
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/ainetwork/value.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.ainetwork.value import AINValueOps, ValueSchema
+
+__all__ = ["ValueSchema", "AINValueOps"]
diff --git a/llm/Lib/site-packages/langchain/tools/amadeus/__init__.py b/llm/Lib/site-packages/langchain/tools/amadeus/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..570958f809806997dc70747887a969ef57152b87
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/amadeus/__init__.py
@@ -0,0 +1,9 @@
+"""Amadeus tools."""
+
+from langchain_community.tools.amadeus.closest_airport import AmadeusClosestAirport
+from langchain_community.tools.amadeus.flight_search import AmadeusFlightSearch
+
+__all__ = [
+    "AmadeusClosestAirport",
+    "AmadeusFlightSearch",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/amadeus/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/amadeus/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aa61969e06925530a2dd5120b8189019059e73e6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/amadeus/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/amadeus/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/amadeus/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..49aca1fd8fc0fb7c61c72006016e93a2809583cc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/amadeus/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/amadeus/__pycache__/closest_airport.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/amadeus/__pycache__/closest_airport.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..384463b703fc9c0c80785884df8fd43909109f30
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/amadeus/__pycache__/closest_airport.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/amadeus/__pycache__/flight_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/amadeus/__pycache__/flight_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7cb8476903c4e7a0bf0a2c07b52ced24f6c4e1ff
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/amadeus/__pycache__/flight_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/amadeus/base.py b/llm/Lib/site-packages/langchain/tools/amadeus/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..c90ac6dc3a2e476c8df37dbaa8a5545c944fa84b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/amadeus/base.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.amadeus.base import AmadeusBaseTool
+
+__all__ = ["AmadeusBaseTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/amadeus/closest_airport.py b/llm/Lib/site-packages/langchain/tools/amadeus/closest_airport.py
new file mode 100644
index 0000000000000000000000000000000000000000..5fdc942c612b53d0bbe1f565d4e89f137273b1db
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/amadeus/closest_airport.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.amadeus.closest_airport import (
+    AmadeusClosestAirport,
+    ClosestAirportSchema,
+)
+
+__all__ = ["ClosestAirportSchema", "AmadeusClosestAirport"]
diff --git a/llm/Lib/site-packages/langchain/tools/amadeus/flight_search.py b/llm/Lib/site-packages/langchain/tools/amadeus/flight_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..64f9f0fe020d89761898fbd856c7f4eb56c273a4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/amadeus/flight_search.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.amadeus.flight_search import (
+    AmadeusFlightSearch,
+    FlightSearchSchema,
+)
+
+__all__ = ["FlightSearchSchema", "AmadeusFlightSearch"]
diff --git a/llm/Lib/site-packages/langchain/tools/arxiv/__init__.py b/llm/Lib/site-packages/langchain/tools/arxiv/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2607cb19bb7e5a74afba8128a82061f127000906
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/arxiv/__init__.py
@@ -0,0 +1 @@
+"""Arxiv API toolkit."""
diff --git a/llm/Lib/site-packages/langchain/tools/arxiv/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/arxiv/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0ca88e5bdfad18a8369a5852e2cf4f58b2532302
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/arxiv/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/arxiv/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/arxiv/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..68aae0d854774e07f3d7643f0a2a66c33d6076d6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/arxiv/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/arxiv/tool.py b/llm/Lib/site-packages/langchain/tools/arxiv/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..2e621ff8f1e4901746ac2064e0dac11436863a61
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/arxiv/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.arxiv.tool import ArxivInput, ArxivQueryRun
+
+__all__ = ["ArxivInput", "ArxivQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__init__.py b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1121e4e89d1f42c321a4e418dc42103b35e356d7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__init__.py
@@ -0,0 +1,25 @@
+"""Azure Cognitive Services Tools."""
+
+from langchain_community.tools.azure_cognitive_services.form_recognizer import (
+    AzureCogsFormRecognizerTool,
+)
+from langchain_community.tools.azure_cognitive_services.image_analysis import (
+    AzureCogsImageAnalysisTool,
+)
+from langchain_community.tools.azure_cognitive_services.speech2text import (
+    AzureCogsSpeech2TextTool,
+)
+from langchain_community.tools.azure_cognitive_services.text2speech import (
+    AzureCogsText2SpeechTool,
+)
+from langchain_community.tools.azure_cognitive_services.text_analytics_health import (
+    AzureCogsTextAnalyticsHealthTool,
+)
+
+__all__ = [
+    "AzureCogsImageAnalysisTool",
+    "AzureCogsFormRecognizerTool",
+    "AzureCogsSpeech2TextTool",
+    "AzureCogsText2SpeechTool",
+    "AzureCogsTextAnalyticsHealthTool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..56fd21489d4702005db8ca71cbe302cc12941f97
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/form_recognizer.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/form_recognizer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7698ed766851a251b0e4aa33fcb9a3e735c5f3ce
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/form_recognizer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/image_analysis.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/image_analysis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e3faa554c7b7120455ab002f196caa5243d416bc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/image_analysis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/speech2text.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/speech2text.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2b3892f4bdd8fcbb070b1174ffc8129561735590
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/speech2text.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/text2speech.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/text2speech.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ed52c4a01fb41a752ffafa85948e662c197a5441
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/text2speech.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/text_analytics_health.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/text_analytics_health.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8adc3d25f7e1f1a66d7ac74167e76e023b561b67
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/__pycache__/text_analytics_health.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/form_recognizer.py b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/form_recognizer.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd52567ae615c900330517381a5589710f8ea3b3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/form_recognizer.py
@@ -0,0 +1,5 @@
+from langchain_community.tools.azure_cognitive_services.form_recognizer import (
+    AzureCogsFormRecognizerTool,
+)
+
+__all__ = ["AzureCogsFormRecognizerTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/image_analysis.py b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/image_analysis.py
new file mode 100644
index 0000000000000000000000000000000000000000..0be38b1585334392ab8aea1f0e1e6f19ac2bff37
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/image_analysis.py
@@ -0,0 +1,5 @@
+from langchain_community.tools.azure_cognitive_services.image_analysis import (
+    AzureCogsImageAnalysisTool,
+)
+
+__all__ = ["AzureCogsImageAnalysisTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/speech2text.py b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/speech2text.py
new file mode 100644
index 0000000000000000000000000000000000000000..681384c77f947ece12d363a940e712f44a229480
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/speech2text.py
@@ -0,0 +1,5 @@
+from langchain_community.tools.azure_cognitive_services.speech2text import (
+    AzureCogsSpeech2TextTool,
+)
+
+__all__ = ["AzureCogsSpeech2TextTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/text2speech.py b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/text2speech.py
new file mode 100644
index 0000000000000000000000000000000000000000..977fbe4990275686dd6339b03b0cbd05eadea6b5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/text2speech.py
@@ -0,0 +1,5 @@
+from langchain_community.tools.azure_cognitive_services.text2speech import (
+    AzureCogsText2SpeechTool,
+)
+
+__all__ = ["AzureCogsText2SpeechTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/text_analytics_health.py b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/text_analytics_health.py
new file mode 100644
index 0000000000000000000000000000000000000000..be8b5cbd55e31f4f35b0313310991653d2afba69
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/azure_cognitive_services/text_analytics_health.py
@@ -0,0 +1,5 @@
+from langchain_community.tools.azure_cognitive_services.text_analytics_health import (
+    AzureCogsTextAnalyticsHealthTool,
+)
+
+__all__ = ["AzureCogsTextAnalyticsHealthTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/base.py b/llm/Lib/site-packages/langchain/tools/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff81eaa895620df4dfe55e0b634164d1cf307927
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/base.py
@@ -0,0 +1,19 @@
+from langchain_core.tools import (
+    BaseTool,
+    SchemaAnnotationError,
+    StructuredTool,
+    Tool,
+    ToolException,
+    create_schema_from_function,
+    tool,
+)
+
+__all__ = [
+    "SchemaAnnotationError",
+    "create_schema_from_function",
+    "ToolException",
+    "BaseTool",
+    "Tool",
+    "StructuredTool",
+    "tool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/bearly/__init__.py b/llm/Lib/site-packages/langchain/tools/bearly/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/tools/bearly/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/bearly/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..94682f56acaaecb112b4aca2f8aef4be51b70a7e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/bearly/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/bearly/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/bearly/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5ebcd8a2e7c3143802cba4652e9fe485c816136c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/bearly/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/bearly/tool.py b/llm/Lib/site-packages/langchain/tools/bearly/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..eec75c9b0342dc58610c3fd008a3e87dadab35af
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/bearly/tool.py
@@ -0,0 +1,11 @@
+from langchain_community.tools.bearly.tool import (
+    BearlyInterpreterTool,
+    BearlyInterpreterToolArguments,
+    FileInfo,
+)
+
+__all__ = [
+    "BearlyInterpreterToolArguments",
+    "FileInfo",
+    "BearlyInterpreterTool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/bing_search/__init__.py b/llm/Lib/site-packages/langchain/tools/bing_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b5e133a05a034a3d1361603f617f5c567eb8699e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/bing_search/__init__.py
@@ -0,0 +1,5 @@
+"""Bing Search API toolkit."""
+
+from langchain_community.tools.bing_search.tool import BingSearchResults, BingSearchRun
+
+__all__ = ["BingSearchRun", "BingSearchResults"]
diff --git a/llm/Lib/site-packages/langchain/tools/bing_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/bing_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e107c692e4b2c91b233c731d824a9c291a9342a0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/bing_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/bing_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/bing_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cfd7e01f0187ef9c8baef4e2b573c67b4078ff62
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/bing_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/bing_search/tool.py b/llm/Lib/site-packages/langchain/tools/bing_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..e25fc72b1a762c553c3684191e1e38891238e599
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/bing_search/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.bing_search.tool import BingSearchResults, BingSearchRun
+
+__all__ = ["BingSearchRun", "BingSearchResults"]
diff --git a/llm/Lib/site-packages/langchain/tools/brave_search/__init__.py b/llm/Lib/site-packages/langchain/tools/brave_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/tools/brave_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/brave_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..30ecffe3ff50c2381ce5c34de8d36293af6cdabf
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/brave_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/brave_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/brave_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..252177856a339ae9d317a0d4d8ef8c55cf0fa0e8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/brave_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/brave_search/tool.py b/llm/Lib/site-packages/langchain/tools/brave_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..dcd5d83151878a09c3bd98d10628e6dd4e918d03
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/brave_search/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.brave_search.tool import BraveSearch
+
+__all__ = ["BraveSearch"]
diff --git a/llm/Lib/site-packages/langchain/tools/clickup/__init__.py b/llm/Lib/site-packages/langchain/tools/clickup/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/tools/clickup/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/clickup/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a9c6241dd1155eff3e2d9f1a9ed34e34c09dfe65
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/clickup/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/clickup/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/clickup/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cba1d81ca27fc0786b52298816e1ca72cf034459
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/clickup/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/clickup/tool.py b/llm/Lib/site-packages/langchain/tools/clickup/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..3aafe9932302bbb5a6a91bf36b45af32b87ca0e3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/clickup/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.clickup.tool import ClickupAction
+
+__all__ = ["ClickupAction"]
diff --git a/llm/Lib/site-packages/langchain/tools/convert_to_openai.py b/llm/Lib/site-packages/langchain/tools/convert_to_openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..d9f639a382fe97160d6402a222282e2cea67ece3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/convert_to_openai.py
@@ -0,0 +1,4 @@
+from langchain_core.utils.function_calling import format_tool_to_openai_function
+
+# For backwards compatibility
+__all__ = ["format_tool_to_openai_function"]
diff --git a/llm/Lib/site-packages/langchain/tools/dataforseo_api_search/__init__.py b/llm/Lib/site-packages/langchain/tools/dataforseo_api_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e2cd9efe9e90515eb1f0e1a2c3f4ecf0a65fdff
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/dataforseo_api_search/__init__.py
@@ -0,0 +1,9 @@
+from langchain_community.tools.dataforseo_api_search.tool import (
+    DataForSeoAPISearchResults,
+    DataForSeoAPISearchRun,
+)
+
+"""DataForSeo API Toolkit."""
+"""Tool for the DataForSeo SERP API."""
+
+__all__ = ["DataForSeoAPISearchRun", "DataForSeoAPISearchResults"]
diff --git a/llm/Lib/site-packages/langchain/tools/dataforseo_api_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/dataforseo_api_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..90c173c363796f9eff66d13e06add15bc8d97bee
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/dataforseo_api_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/dataforseo_api_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/dataforseo_api_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..040d0e43865ed401cf6f860079473e471d36295a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/dataforseo_api_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/dataforseo_api_search/tool.py b/llm/Lib/site-packages/langchain/tools/dataforseo_api_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..e8ac54f38cf471acd03794d1d9e1d3f812c5938d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/dataforseo_api_search/tool.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.dataforseo_api_search.tool import (
+    DataForSeoAPISearchResults,
+    DataForSeoAPISearchRun,
+)
+
+__all__ = ["DataForSeoAPISearchRun", "DataForSeoAPISearchResults"]
diff --git a/llm/Lib/site-packages/langchain/tools/ddg_search/__init__.py b/llm/Lib/site-packages/langchain/tools/ddg_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5b7de286b8916b86ec154ab9e799f168f363d62e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/ddg_search/__init__.py
@@ -0,0 +1,5 @@
+"""DuckDuckGo Search API toolkit."""
+
+from langchain_community.tools.ddg_search.tool import DuckDuckGoSearchRun
+
+__all__ = ["DuckDuckGoSearchRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/ddg_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/ddg_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..67e0e044a601104e9c6fd8de0655c7db84299927
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/ddg_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/ddg_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/ddg_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0404701bf4cd3e71784d2d113cdf0a17c8db70ef
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/ddg_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/ddg_search/tool.py b/llm/Lib/site-packages/langchain/tools/ddg_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..5fa05a470f1b3b88389a012264ab00d708727001
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/ddg_search/tool.py
@@ -0,0 +1,13 @@
+from langchain_community.tools.ddg_search.tool import (
+    DDGInput,
+    DuckDuckGoSearchResults,
+    DuckDuckGoSearchRun,
+    DuckDuckGoSearchTool,
+)
+
+__all__ = [
+    "DDGInput",
+    "DuckDuckGoSearchRun",
+    "DuckDuckGoSearchResults",
+    "DuckDuckGoSearchTool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/e2b_data_analysis/__init__.py b/llm/Lib/site-packages/langchain/tools/e2b_data_analysis/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/tools/e2b_data_analysis/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/e2b_data_analysis/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b29358b3eca67ded87fe0f02252bcc8f79f40d1d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/e2b_data_analysis/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/e2b_data_analysis/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/e2b_data_analysis/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e2fce690e49ce8fb11ff98e2ba508ae041bba796
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/e2b_data_analysis/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/e2b_data_analysis/tool.py b/llm/Lib/site-packages/langchain/tools/e2b_data_analysis/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..051cc6550ffd51166480db402a94e5aaa3415759
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/e2b_data_analysis/tool.py
@@ -0,0 +1,11 @@
+from langchain_community.tools.e2b_data_analysis.tool import (
+    E2BDataAnalysisTool,
+    E2BDataAnalysisToolArguments,
+    UploadedFile,
+)
+
+__all__ = [
+    "UploadedFile",
+    "E2BDataAnalysisToolArguments",
+    "E2BDataAnalysisTool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/__init__.py b/llm/Lib/site-packages/langchain/tools/edenai/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e6084d5157484e1561bc30d08c1bb8a355d8d4b0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/edenai/__init__.py
@@ -0,0 +1,34 @@
+"""Edenai Tools."""
+from langchain_community.tools.edenai.audio_speech_to_text import (
+    EdenAiSpeechToTextTool,
+)
+from langchain_community.tools.edenai.audio_text_to_speech import (
+    EdenAiTextToSpeechTool,
+)
+from langchain_community.tools.edenai.edenai_base_tool import EdenaiTool
+from langchain_community.tools.edenai.image_explicitcontent import (
+    EdenAiExplicitImageTool,
+)
+from langchain_community.tools.edenai.image_objectdetection import (
+    EdenAiObjectDetectionTool,
+)
+from langchain_community.tools.edenai.ocr_identityparser import (
+    EdenAiParsingIDTool,
+)
+from langchain_community.tools.edenai.ocr_invoiceparser import (
+    EdenAiParsingInvoiceTool,
+)
+from langchain_community.tools.edenai.text_moderation import (
+    EdenAiTextModerationTool,
+)
+
+__all__ = [
+    "EdenAiExplicitImageTool",
+    "EdenAiObjectDetectionTool",
+    "EdenAiParsingIDTool",
+    "EdenAiParsingInvoiceTool",
+    "EdenAiTextToSpeechTool",
+    "EdenAiSpeechToTextTool",
+    "EdenAiTextModerationTool",
+    "EdenaiTool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1d1f3fb2e6cc62fdafcb696ca52bcc9b0bb4ca56
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/audio_speech_to_text.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/audio_speech_to_text.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..205f188230baa1d77638b3cee862a819674732f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/audio_speech_to_text.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/audio_text_to_speech.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/audio_text_to_speech.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cfcc6ff1c1cf897d40036384ccd349ea79a2ad8a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/audio_text_to_speech.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/edenai_base_tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/edenai_base_tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1a3672826ebd469f9058b6f5caed175c0bf186a4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/edenai_base_tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/image_explicitcontent.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/image_explicitcontent.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..64727a1d8442e0f8f1fa4c5def7bb97d6d78c5b9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/image_explicitcontent.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/image_objectdetection.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/image_objectdetection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ccbd1ecd6223834a2a01fc666404fcaa2a194904
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/image_objectdetection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/ocr_identityparser.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/ocr_identityparser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..80dd4bd00ecbed67dbb1d86eb9f8871f96663ccc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/ocr_identityparser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/ocr_invoiceparser.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/ocr_invoiceparser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..af71c76100921e28750b3307793142f0cbb32753
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/ocr_invoiceparser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/text_moderation.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/text_moderation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a441402341e57a6db24b6d0efcd71b136085c7c6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/edenai/__pycache__/text_moderation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/audio_speech_to_text.py b/llm/Lib/site-packages/langchain/tools/edenai/audio_speech_to_text.py
new file mode 100644
index 0000000000000000000000000000000000000000..adf01683726dcaa3de3cb9dcbb336bddccb590f4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/edenai/audio_speech_to_text.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.edenai.audio_speech_to_text import EdenAiSpeechToTextTool
+
+__all__ = ["EdenAiSpeechToTextTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/audio_text_to_speech.py b/llm/Lib/site-packages/langchain/tools/edenai/audio_text_to_speech.py
new file mode 100644
index 0000000000000000000000000000000000000000..792db4d63d2882c5d827c6b3b84b31bab59d797e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/edenai/audio_text_to_speech.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.edenai.audio_text_to_speech import EdenAiTextToSpeechTool
+
+__all__ = ["EdenAiTextToSpeechTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/edenai_base_tool.py b/llm/Lib/site-packages/langchain/tools/edenai/edenai_base_tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..eae01adb4ad875a962b36e93a379dc90186ab7d5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/edenai/edenai_base_tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.edenai.edenai_base_tool import EdenaiTool
+
+__all__ = ["EdenaiTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/image_explicitcontent.py b/llm/Lib/site-packages/langchain/tools/edenai/image_explicitcontent.py
new file mode 100644
index 0000000000000000000000000000000000000000..985455c65961a220b5504eac5d941792036f2d66
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/edenai/image_explicitcontent.py
@@ -0,0 +1,5 @@
+from langchain_community.tools.edenai.image_explicitcontent import (
+    EdenAiExplicitImageTool,
+)
+
+__all__ = ["EdenAiExplicitImageTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/image_objectdetection.py b/llm/Lib/site-packages/langchain/tools/edenai/image_objectdetection.py
new file mode 100644
index 0000000000000000000000000000000000000000..566c2a923ed6d44c4e5bc928cf741e8b04e6f766
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/edenai/image_objectdetection.py
@@ -0,0 +1,5 @@
+from langchain_community.tools.edenai.image_objectdetection import (
+    EdenAiObjectDetectionTool,
+)
+
+__all__ = ["EdenAiObjectDetectionTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/ocr_identityparser.py b/llm/Lib/site-packages/langchain/tools/edenai/ocr_identityparser.py
new file mode 100644
index 0000000000000000000000000000000000000000..976226d9e5a6b1ceac31e1a5a2c29801024b801a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/edenai/ocr_identityparser.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.edenai.ocr_identityparser import EdenAiParsingIDTool
+
+__all__ = ["EdenAiParsingIDTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/ocr_invoiceparser.py b/llm/Lib/site-packages/langchain/tools/edenai/ocr_invoiceparser.py
new file mode 100644
index 0000000000000000000000000000000000000000..8103e5e6c6ef55d4c98b78651602505700445851
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/edenai/ocr_invoiceparser.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.edenai.ocr_invoiceparser import EdenAiParsingInvoiceTool
+
+__all__ = ["EdenAiParsingInvoiceTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/edenai/text_moderation.py b/llm/Lib/site-packages/langchain/tools/edenai/text_moderation.py
new file mode 100644
index 0000000000000000000000000000000000000000..e1405e6e8522d0e4834605c4d0ffd5b629608563
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/edenai/text_moderation.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.edenai.text_moderation import EdenAiTextModerationTool
+
+__all__ = ["EdenAiTextModerationTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/eleven_labs/__init__.py b/llm/Lib/site-packages/langchain/tools/eleven_labs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3cb16a41603b3a999cf1a64511cf1e08679b86fe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/eleven_labs/__init__.py
@@ -0,0 +1,5 @@
+"""Eleven Labs Services Tools."""
+
+from langchain_community.tools.eleven_labs.text2speech import ElevenLabsText2SpeechTool
+
+__all__ = ["ElevenLabsText2SpeechTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/eleven_labs/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/eleven_labs/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d02dcf1f1a07690e9e79c2ceed3bac51a69b6d53
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/eleven_labs/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/eleven_labs/__pycache__/models.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/eleven_labs/__pycache__/models.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..746e0c034bc8b6d8ade8dea8c735b04253b62c22
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/eleven_labs/__pycache__/models.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/eleven_labs/__pycache__/text2speech.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/eleven_labs/__pycache__/text2speech.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..197d958405b8b23739f6ceaa0aca0d3efd9835d9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/eleven_labs/__pycache__/text2speech.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/eleven_labs/models.py b/llm/Lib/site-packages/langchain/tools/eleven_labs/models.py
new file mode 100644
index 0000000000000000000000000000000000000000..8791909514b749b00561b0f39940cd03d3374f45
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/eleven_labs/models.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.eleven_labs.models import ElevenLabsModel
+
+__all__ = ["ElevenLabsModel"]
diff --git a/llm/Lib/site-packages/langchain/tools/eleven_labs/text2speech.py b/llm/Lib/site-packages/langchain/tools/eleven_labs/text2speech.py
new file mode 100644
index 0000000000000000000000000000000000000000..a07326bb6412a684dd95098c8707e65b05e89da8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/eleven_labs/text2speech.py
@@ -0,0 +1,5 @@
+from langchain_community.tools.eleven_labs.text2speech import (
+    ElevenLabsText2SpeechTool,
+)
+
+__all__ = ["ElevenLabsText2SpeechTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/__init__.py b/llm/Lib/site-packages/langchain/tools/file_management/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..395f5d5ea6058dfd8b11fd3cd2d197f024f4f593
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/file_management/__init__.py
@@ -0,0 +1,19 @@
+"""File Management Tools."""
+
+from langchain_community.tools.file_management.copy import CopyFileTool
+from langchain_community.tools.file_management.delete import DeleteFileTool
+from langchain_community.tools.file_management.file_search import FileSearchTool
+from langchain_community.tools.file_management.list_dir import ListDirectoryTool
+from langchain_community.tools.file_management.move import MoveFileTool
+from langchain_community.tools.file_management.read import ReadFileTool
+from langchain_community.tools.file_management.write import WriteFileTool
+
+__all__ = [
+    "CopyFileTool",
+    "DeleteFileTool",
+    "FileSearchTool",
+    "MoveFileTool",
+    "ReadFileTool",
+    "WriteFileTool",
+    "ListDirectoryTool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..182e2bfe174ba972a7f6186f45cf3d05a126fec0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/copy.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/copy.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..427eaefd6bc9311b91497bf449ff3219f53f8d36
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/copy.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/delete.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/delete.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0c89cb9d0160adf6a43c61f8edbc965d4b006a82
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/delete.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/file_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/file_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f6e58003baf5f8beac2e2477f113e21651b38bc7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/file_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/list_dir.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/list_dir.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d7e6ed3c764426b61fe7072e49b68cc3f446646e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/list_dir.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/move.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/move.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5bcd654ccf87456a8e8fdbb6e32371a5196015b4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/move.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/read.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/read.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..41934c1a824cc8879f11b3f7dcff87848d34d71d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/read.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/write.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/write.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3fcb4a598693def1d0fdb7b4e6b1518f89161c50
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/file_management/__pycache__/write.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/copy.py b/llm/Lib/site-packages/langchain/tools/file_management/copy.py
new file mode 100644
index 0000000000000000000000000000000000000000..9d581eed3adce91e15bd091f8504340e77dc3e93
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/file_management/copy.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.file_management.copy import CopyFileTool, FileCopyInput
+
+__all__ = ["FileCopyInput", "CopyFileTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/delete.py b/llm/Lib/site-packages/langchain/tools/file_management/delete.py
new file mode 100644
index 0000000000000000000000000000000000000000..8d61c7c6663f0ee0b201e6fffe46730666b08a30
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/file_management/delete.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.file_management.delete import (
+    DeleteFileTool,
+    FileDeleteInput,
+)
+
+__all__ = ["FileDeleteInput", "DeleteFileTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/file_search.py b/llm/Lib/site-packages/langchain/tools/file_management/file_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b6b7558fc43f730feeca20709c89d20adb0288f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/file_management/file_search.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.file_management.file_search import (
+    FileSearchInput,
+    FileSearchTool,
+)
+
+__all__ = ["FileSearchInput", "FileSearchTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/list_dir.py b/llm/Lib/site-packages/langchain/tools/file_management/list_dir.py
new file mode 100644
index 0000000000000000000000000000000000000000..e75a65030170ac412ce448787f8b77646a46e5ee
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/file_management/list_dir.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.file_management.list_dir import (
+    DirectoryListingInput,
+    ListDirectoryTool,
+)
+
+__all__ = ["DirectoryListingInput", "ListDirectoryTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/move.py b/llm/Lib/site-packages/langchain/tools/file_management/move.py
new file mode 100644
index 0000000000000000000000000000000000000000..42d53022e5b1954ebc8e1af4b56e3f727fdf0430
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/file_management/move.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.file_management.move import FileMoveInput, MoveFileTool
+
+__all__ = ["FileMoveInput", "MoveFileTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/read.py b/llm/Lib/site-packages/langchain/tools/file_management/read.py
new file mode 100644
index 0000000000000000000000000000000000000000..b8cf5d62deb2fdf9f20908078bcc27a2c2c4dac0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/file_management/read.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.file_management.read import ReadFileInput, ReadFileTool
+
+__all__ = ["ReadFileInput", "ReadFileTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/file_management/write.py b/llm/Lib/site-packages/langchain/tools/file_management/write.py
new file mode 100644
index 0000000000000000000000000000000000000000..d3b81efaa02649069c86be06ab03a5d7fc528a55
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/file_management/write.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.file_management.write import (
+    WriteFileInput,
+    WriteFileTool,
+)
+
+__all__ = ["WriteFileInput", "WriteFileTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/github/__init__.py b/llm/Lib/site-packages/langchain/tools/github/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e737ac26ba0b50abe7a31f623d04ac5757f3905e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/github/__init__.py
@@ -0,0 +1 @@
+""" GitHub Tool """
diff --git a/llm/Lib/site-packages/langchain/tools/github/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/github/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3e04d925925fb46584891a2c7dccd2d21e24aa5a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/github/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/github/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/github/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..62ac0705d1b8f2e5c2307f47260a938bb346a1d3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/github/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/github/tool.py b/llm/Lib/site-packages/langchain/tools/github/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..618a2077759a06ad3a0fa38332ea701bc8f67972
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/github/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.github.tool import GitHubAction
+
+__all__ = ["GitHubAction"]
diff --git a/llm/Lib/site-packages/langchain/tools/gitlab/__init__.py b/llm/Lib/site-packages/langchain/tools/gitlab/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b6d6367663ab6c5a299129767fa52896f8bdc0f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/gitlab/__init__.py
@@ -0,0 +1 @@
+""" GitLab Tool """
diff --git a/llm/Lib/site-packages/langchain/tools/gitlab/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/gitlab/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bfb89a56fc46b8bb269dda77fb143f5e368a197f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/gitlab/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/gitlab/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/gitlab/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..953e662d0bd534fdd5dd53fa269d50ad4dcba42e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/gitlab/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/gitlab/tool.py b/llm/Lib/site-packages/langchain/tools/gitlab/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..73b697bfb772067c315496c36d1a8bd4d613cd12
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/gitlab/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.gitlab.tool import GitLabAction
+
+__all__ = ["GitLabAction"]
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/__init__.py b/llm/Lib/site-packages/langchain/tools/gmail/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..611abf58836e8f0c13c97e0e88fcda97e5e43c8e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/gmail/__init__.py
@@ -0,0 +1,15 @@
+"""Gmail tools."""
+
+from langchain_community.tools.gmail.create_draft import GmailCreateDraft
+from langchain_community.tools.gmail.get_message import GmailGetMessage
+from langchain_community.tools.gmail.get_thread import GmailGetThread
+from langchain_community.tools.gmail.search import GmailSearch
+from langchain_community.tools.gmail.send_message import GmailSendMessage
+
+__all__ = [
+    "GmailCreateDraft",
+    "GmailSendMessage",
+    "GmailSearch",
+    "GmailGetMessage",
+    "GmailGetThread",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cd6126fa0ba143b40dc756905c555eec3780933b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f678451253b6ff324650d231612726445d6b64d3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/create_draft.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/create_draft.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c864979253c718322ae00c8def25ce44cddde3d1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/create_draft.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/get_message.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/get_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..071d969ad61fe58913f367db02c9b7794c41eb43
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/get_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/get_thread.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/get_thread.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2f7f27633fb78fa9b1adc8d266e504678ee1116e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/get_thread.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/search.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..824a154af7a34359650ebe16a88b4529e5fb1470
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/send_message.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/send_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a9eef2f354e7e46297b67d149293a47f3513274f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/gmail/__pycache__/send_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/base.py b/llm/Lib/site-packages/langchain/tools/gmail/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..627db2cd3f91176007f2d4f12d1d80a2a9d46820
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/gmail/base.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.gmail.base import GmailBaseTool
+
+__all__ = ["GmailBaseTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/create_draft.py b/llm/Lib/site-packages/langchain/tools/gmail/create_draft.py
new file mode 100644
index 0000000000000000000000000000000000000000..81e75787cd87228523467ee9da7b54108c4bb2f6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/gmail/create_draft.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.gmail.create_draft import (
+    CreateDraftSchema,
+    GmailCreateDraft,
+)
+
+__all__ = ["CreateDraftSchema", "GmailCreateDraft"]
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/get_message.py b/llm/Lib/site-packages/langchain/tools/gmail/get_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..05cbf1ca8a61a88158f83b2352f91489be7da0f8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/gmail/get_message.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.gmail.get_message import (
+    GmailGetMessage,
+    SearchArgsSchema,
+)
+
+__all__ = ["SearchArgsSchema", "GmailGetMessage"]
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/get_thread.py b/llm/Lib/site-packages/langchain/tools/gmail/get_thread.py
new file mode 100644
index 0000000000000000000000000000000000000000..8692450d01446354c43a60a6f7a510bc3b81ec44
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/gmail/get_thread.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.gmail.get_thread import GetThreadSchema, GmailGetThread
+
+__all__ = ["GetThreadSchema", "GmailGetThread"]
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/search.py b/llm/Lib/site-packages/langchain/tools/gmail/search.py
new file mode 100644
index 0000000000000000000000000000000000000000..47473931607fc56bb698cd9cc5199a4ddfbbeda3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/gmail/search.py
@@ -0,0 +1,7 @@
+from langchain_community.tools.gmail.search import (
+    GmailSearch,
+    Resource,
+    SearchArgsSchema,
+)
+
+__all__ = ["Resource", "SearchArgsSchema", "GmailSearch"]
diff --git a/llm/Lib/site-packages/langchain/tools/gmail/send_message.py b/llm/Lib/site-packages/langchain/tools/gmail/send_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..da35b9f67cc806c8555c115a70b5c1a584105bbf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/gmail/send_message.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.gmail.send_message import (
+    GmailSendMessage,
+    SendMessageSchema,
+)
+
+__all__ = ["SendMessageSchema", "GmailSendMessage"]
diff --git a/llm/Lib/site-packages/langchain/tools/golden_query/__init__.py b/llm/Lib/site-packages/langchain/tools/golden_query/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f2f2bc5339b521336a22a6c368c29f1487857aa5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/golden_query/__init__.py
@@ -0,0 +1,8 @@
+"""Golden API toolkit."""
+
+
+from langchain_community.tools.golden_query.tool import GoldenQueryRun
+
+__all__ = [
+    "GoldenQueryRun",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/golden_query/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/golden_query/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..712bbdebf36c951b6e3ddb34bb89d323e114999b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/golden_query/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/golden_query/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/golden_query/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e4e22952e6fc59e8cfadb7c3f7471a41bf33ea8e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/golden_query/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/golden_query/tool.py b/llm/Lib/site-packages/langchain/tools/golden_query/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..7698898e9520ce0ba5285fc3fa79d26a35502e7e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/golden_query/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.golden_query.tool import GoldenQueryRun
+
+__all__ = ["GoldenQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_cloud/__init__.py b/llm/Lib/site-packages/langchain/tools/google_cloud/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ec7deb895156f9feb426e3e379412301a30bd563
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_cloud/__init__.py
@@ -0,0 +1,7 @@
+"""Google Cloud Tools."""
+
+from langchain_community.tools.google_cloud.texttospeech import (
+    GoogleCloudTextToSpeechTool,
+)
+
+__all__ = ["GoogleCloudTextToSpeechTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_cloud/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_cloud/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ca97147befd99db18228fe344c0abf48f65b7cbd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_cloud/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_cloud/__pycache__/texttospeech.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_cloud/__pycache__/texttospeech.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d511c5c6ce2a5cd9b2d3faf66611b0756a5e2543
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_cloud/__pycache__/texttospeech.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_cloud/texttospeech.py b/llm/Lib/site-packages/langchain/tools/google_cloud/texttospeech.py
new file mode 100644
index 0000000000000000000000000000000000000000..b367ff43f072ab435fba0c1005773126d1b2983b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_cloud/texttospeech.py
@@ -0,0 +1,7 @@
+from langchain_community.tools.google_cloud.texttospeech import (
+    GoogleCloudTextToSpeechTool,
+)
+
+__all__ = [
+    "GoogleCloudTextToSpeechTool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/google_finance/__init__.py b/llm/Lib/site-packages/langchain/tools/google_finance/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc06ae46d56efb0a711f24f4d0537aeea41057c7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_finance/__init__.py
@@ -0,0 +1,5 @@
+"""Google Finance API Toolkit."""
+
+from langchain_community.tools.google_finance.tool import GoogleFinanceQueryRun
+
+__all__ = ["GoogleFinanceQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_finance/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_finance/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3698af8d9cbdbb9af2594d41ff122b67d15b4808
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_finance/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_finance/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_finance/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7d6f9554110556001f5bf9c058f6f17f1bae8b4b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_finance/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_finance/tool.py b/llm/Lib/site-packages/langchain/tools/google_finance/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..ced4ad9648db540d2b604ceee7879586a2705358
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_finance/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.google_finance.tool import GoogleFinanceQueryRun
+
+__all__ = ["GoogleFinanceQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_jobs/__init__.py b/llm/Lib/site-packages/langchain/tools/google_jobs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f23e0eecffb4021032f5829f28886b54b2d2b97b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_jobs/__init__.py
@@ -0,0 +1,5 @@
+"""Google Jobs API Toolkit."""
+
+from langchain_community.tools.google_jobs.tool import GoogleJobsQueryRun
+
+__all__ = ["GoogleJobsQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_jobs/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_jobs/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4e14e1722690ad0a08a170cfada2b5c6d00c9e09
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_jobs/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_jobs/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_jobs/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..681c1ae1a58c6988a176b7eb9c79a97033456693
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_jobs/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_jobs/tool.py b/llm/Lib/site-packages/langchain/tools/google_jobs/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..bbe6147cf6b245895ecd43b8fbf5c49d394e4f5e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_jobs/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.google_jobs.tool import GoogleJobsQueryRun
+
+__all__ = ["GoogleJobsQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_lens/__init__.py b/llm/Lib/site-packages/langchain/tools/google_lens/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..15a0c179379ccdfb37b69957a6ea60ea50716c27
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_lens/__init__.py
@@ -0,0 +1,5 @@
+"""Google Lens API Toolkit."""
+
+from langchain_community.tools.google_lens.tool import GoogleLensQueryRun
+
+__all__ = ["GoogleLensQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_lens/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_lens/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e19fb610b28bb76b4f610ed170c0ff9fc3cd8621
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_lens/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_lens/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_lens/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b90dbfde29a1a164fd0dde748dfc595ed23384b7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_lens/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_lens/tool.py b/llm/Lib/site-packages/langchain/tools/google_lens/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..f30209cb6daa297f499b7bfc8e43be05471da760
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_lens/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.google_lens.tool import GoogleLensQueryRun
+
+__all__ = ["GoogleLensQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_places/__init__.py b/llm/Lib/site-packages/langchain/tools/google_places/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d3b948ea58fdbe59ae6dfa8959ca113fa543d8d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_places/__init__.py
@@ -0,0 +1,5 @@
+"""Google Places API Toolkit."""
+
+from langchain_community.tools.google_places.tool import GooglePlacesTool
+
+__all__ = ["GooglePlacesTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_places/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_places/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9634922177e12934db9c4f620607272d48c7c576
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_places/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_places/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_places/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..70b932c05768090561a9c1dc77320706fb45415f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_places/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_places/tool.py b/llm/Lib/site-packages/langchain/tools/google_places/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..1143daa7a9b2140c6c42dd0a06873c1e77bb3aca
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_places/tool.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.google_places.tool import (
+    GooglePlacesSchema,
+    GooglePlacesTool,
+)
+
+__all__ = ["GooglePlacesSchema", "GooglePlacesTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_scholar/__init__.py b/llm/Lib/site-packages/langchain/tools/google_scholar/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b83e5dfc1ef8887d2578fe1c61475ee7158ceb04
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_scholar/__init__.py
@@ -0,0 +1,5 @@
+"""Google Scholar API Toolkit."""
+
+from langchain_community.tools.google_scholar.tool import GoogleScholarQueryRun
+
+__all__ = ["GoogleScholarQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_scholar/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_scholar/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c6f8bc93d0e386fca55256124c761936c680c9d1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_scholar/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_scholar/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_scholar/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..73d37f11b1bd10aaf7121905c5c2ca48b06be38e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_scholar/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_scholar/tool.py b/llm/Lib/site-packages/langchain/tools/google_scholar/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..6b11adaf07148c3f711ff8de5552c99a2405a36d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_scholar/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.google_scholar.tool import GoogleScholarQueryRun
+
+__all__ = ["GoogleScholarQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_search/__init__.py b/llm/Lib/site-packages/langchain/tools/google_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..08eccf0a3183903ad6342e5f575204ba1c91683f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_search/__init__.py
@@ -0,0 +1,8 @@
+"""Google Search API Toolkit."""
+
+from langchain_community.tools.google_search.tool import (
+    GoogleSearchResults,
+    GoogleSearchRun,
+)
+
+__all__ = ["GoogleSearchRun", "GoogleSearchResults"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e365a169300ae6d1141f0991ffdf7ea8d21170eb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7a88117929ccb58d1124cce63ea36b2ce1376be0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_search/tool.py b/llm/Lib/site-packages/langchain/tools/google_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..f5c842bab389c01dfd14f224434eb9922919ca25
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_search/tool.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.google_search.tool import (
+    GoogleSearchResults,
+    GoogleSearchRun,
+)
+
+__all__ = ["GoogleSearchRun", "GoogleSearchResults"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_serper/__init__.py b/llm/Lib/site-packages/langchain/tools/google_serper/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..413481a645b3d95373fb60632ac5d2c8a720f52c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_serper/__init__.py
@@ -0,0 +1,9 @@
+from langchain_community.tools.google_serper.tool import (
+    GoogleSerperResults,
+    GoogleSerperRun,
+)
+
+"""Google Serper API Toolkit."""
+"""Tool for the Serer.dev Google Search API."""
+
+__all__ = ["GoogleSerperRun", "GoogleSerperResults"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_serper/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_serper/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6a92e293f16003a02e8b12558645e92b906fd993
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_serper/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_serper/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_serper/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..023197fa1f02cafe966a9b77c82390200801bbf0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_serper/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_serper/tool.py b/llm/Lib/site-packages/langchain/tools/google_serper/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..854dea93fbc38c1904ad3131350eb9b4726bf501
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_serper/tool.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.google_serper.tool import (
+    GoogleSerperResults,
+    GoogleSerperRun,
+)
+
+__all__ = ["GoogleSerperRun", "GoogleSerperResults"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_trends/__init__.py b/llm/Lib/site-packages/langchain/tools/google_trends/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca3d58fc5959b32063c4ebde51b306970046512f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_trends/__init__.py
@@ -0,0 +1,5 @@
+"""Google Trends API Toolkit."""
+
+from langchain_community.tools.google_trends.tool import GoogleTrendsQueryRun
+
+__all__ = ["GoogleTrendsQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/google_trends/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_trends/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7335d588a8bd26186852a30a582d4e9f82558bb9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_trends/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_trends/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/google_trends/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0c1e9391f1c5b1919bb4e26f213f844e9d17a2aa
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/google_trends/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/google_trends/tool.py b/llm/Lib/site-packages/langchain/tools/google_trends/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd9a51419c9a98c820f42900345541a9b21a4f29
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/google_trends/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.google_trends.tool import GoogleTrendsQueryRun
+
+__all__ = ["GoogleTrendsQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/graphql/__init__.py b/llm/Lib/site-packages/langchain/tools/graphql/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7e9a84c3772f4749d290bf07d8c7d49ddc57cdcd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/graphql/__init__.py
@@ -0,0 +1 @@
+"""Tools for interacting with a GraphQL API"""
diff --git a/llm/Lib/site-packages/langchain/tools/graphql/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/graphql/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cded90d2baf3db6d44c187eeac599923badb75e7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/graphql/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/graphql/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/graphql/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..daf2df597eec9ca5fa32c9973ec66acf52b0ef09
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/graphql/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/graphql/tool.py b/llm/Lib/site-packages/langchain/tools/graphql/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..e87d45ff297f00e3b0c36ddb359502fcd4c6e286
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/graphql/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.graphql.tool import BaseGraphQLTool
+
+__all__ = ["BaseGraphQLTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/human/__init__.py b/llm/Lib/site-packages/langchain/tools/human/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..084487d0f9b3435dd8436b0d0551d678c9781965
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/human/__init__.py
@@ -0,0 +1,5 @@
+"""Tool for asking for human input."""
+
+from langchain_community.tools.human.tool import HumanInputRun
+
+__all__ = ["HumanInputRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/human/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/human/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..44701bee62475843b0c6a5b982636c7e5611c3a4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/human/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/human/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/human/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..98ddba3be0f9d7e91caf28dcb3eef9fa2f3de287
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/human/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/human/tool.py b/llm/Lib/site-packages/langchain/tools/human/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d670d74e6706b66eb67c5f9f044137740b5a57c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/human/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.human.tool import HumanInputRun
+
+__all__ = ["HumanInputRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/ifttt.py b/llm/Lib/site-packages/langchain/tools/ifttt.py
new file mode 100644
index 0000000000000000000000000000000000000000..58bd46f33287e223226c5e264f170952f29579c4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/ifttt.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.ifttt import IFTTTWebhook
+
+__all__ = ["IFTTTWebhook"]
diff --git a/llm/Lib/site-packages/langchain/tools/interaction/__init__.py b/llm/Lib/site-packages/langchain/tools/interaction/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..be3393362d8bc39d0f5d56dffd757fb51ae6ace2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/interaction/__init__.py
@@ -0,0 +1 @@
+"""Tools for interacting with the user."""
diff --git a/llm/Lib/site-packages/langchain/tools/interaction/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/interaction/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4b44d99ae2cdf9393fb67fa5b8173ec8896dc575
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/interaction/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/interaction/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/interaction/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0e614db1da616fbfa08b6a2c6b159cc5f94486f4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/interaction/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/interaction/tool.py b/llm/Lib/site-packages/langchain/tools/interaction/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..5efea0576528a178998ab2897e1e44e8783cd7c5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/interaction/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.interaction.tool import StdInInquireTool
+
+__all__ = ["StdInInquireTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/jira/__init__.py b/llm/Lib/site-packages/langchain/tools/jira/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..06cd8cbcd9e403192fd52f143b06799028289ac9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/jira/__init__.py
@@ -0,0 +1 @@
+"""Jira Tool."""
diff --git a/llm/Lib/site-packages/langchain/tools/jira/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/jira/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..18160643c163aba4b042ecd36faf162eace90fdb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/jira/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/jira/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/jira/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0a1d1baa63deee203a38be5a155474415fb6e101
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/jira/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/jira/tool.py b/llm/Lib/site-packages/langchain/tools/jira/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..5cdd24bbd6571e8e1f613f4cb87d904e70ccd6fa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/jira/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.jira.tool import JiraAction
+
+__all__ = ["JiraAction"]
diff --git a/llm/Lib/site-packages/langchain/tools/json/__init__.py b/llm/Lib/site-packages/langchain/tools/json/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d13302f008a09fa9747da055d4baeec957651ef4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/json/__init__.py
@@ -0,0 +1 @@
+"""Tools for interacting with a JSON file."""
diff --git a/llm/Lib/site-packages/langchain/tools/json/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/json/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a08769496cca118ca0650144fe9d108f76a36017
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/json/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/json/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/json/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..625208e7d12195ba2f3f33af4bc39957d316aae3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/json/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/json/tool.py b/llm/Lib/site-packages/langchain/tools/json/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..fefe2bbb86e743bc2438022d0a3c9120be3651bb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/json/tool.py
@@ -0,0 +1,7 @@
+from langchain_community.tools.json.tool import (
+    JsonGetValueTool,
+    JsonListKeysTool,
+    JsonSpec,
+)
+
+__all__ = ["JsonSpec", "JsonListKeysTool", "JsonGetValueTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/memorize/__init__.py b/llm/Lib/site-packages/langchain/tools/memorize/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..76a84406aced35decd158983b9423aa94958d371
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/memorize/__init__.py
@@ -0,0 +1,5 @@
+"""Unsupervised learning based memorization."""
+
+from langchain_community.tools.memorize.tool import Memorize
+
+__all__ = ["Memorize"]
diff --git a/llm/Lib/site-packages/langchain/tools/memorize/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/memorize/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fcacbbaae20338f92fe39409952119392745b360
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/memorize/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/memorize/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/memorize/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..27f7cf84789445ec195ef9acd86eba15dd6d6a73
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/memorize/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/memorize/tool.py b/llm/Lib/site-packages/langchain/tools/memorize/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..f4a62174f06df2756fe01d24636cd4298aaa0387
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/memorize/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.memorize.tool import Memorize, TrainableLLM
+
+__all__ = ["TrainableLLM", "Memorize"]
diff --git a/llm/Lib/site-packages/langchain/tools/merriam_webster/__init__.py b/llm/Lib/site-packages/langchain/tools/merriam_webster/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..73390d549807ce23c7477c265bcfb73ab5e21ef6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/merriam_webster/__init__.py
@@ -0,0 +1 @@
+"""Merriam-Webster API toolkit."""
diff --git a/llm/Lib/site-packages/langchain/tools/merriam_webster/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/merriam_webster/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ed62b96d68212fa6f5192cfdbcbdf6d88eb2b322
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/merriam_webster/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/merriam_webster/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/merriam_webster/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..68c66ebc45d5ea565943515cbeb14ff9632c40f8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/merriam_webster/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/merriam_webster/tool.py b/llm/Lib/site-packages/langchain/tools/merriam_webster/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..a85f2344ff94836418749bbd8b95662864635cbc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/merriam_webster/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.merriam_webster.tool import MerriamWebsterQueryRun
+
+__all__ = ["MerriamWebsterQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/metaphor_search/__init__.py b/llm/Lib/site-packages/langchain/tools/metaphor_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..246f25a1291bc640645dc6284950eceaed971f42
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/metaphor_search/__init__.py
@@ -0,0 +1,5 @@
+"""Metaphor Search API toolkit."""
+
+from langchain_community.tools.metaphor_search.tool import MetaphorSearchResults
+
+__all__ = ["MetaphorSearchResults"]
diff --git a/llm/Lib/site-packages/langchain/tools/metaphor_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/metaphor_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c6819aef67f37362a073264799fb877cf469fa57
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/metaphor_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/metaphor_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/metaphor_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8f2fa87bdb5b158c6c1f32909768ca5620cf0bc5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/metaphor_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/metaphor_search/tool.py b/llm/Lib/site-packages/langchain/tools/metaphor_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..eec268e68b11e018dc5dd8f586b4f76b9160df0d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/metaphor_search/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.metaphor_search.tool import MetaphorSearchResults
+
+__all__ = ["MetaphorSearchResults"]
diff --git a/llm/Lib/site-packages/langchain/tools/multion/__init__.py b/llm/Lib/site-packages/langchain/tools/multion/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..693ddcffc90381e276b68daa98a1275d42bb35ed
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/multion/__init__.py
@@ -0,0 +1,6 @@
+"""MutliOn Client API tools."""
+from langchain_community.tools.multion.close_session import MultionCloseSession
+from langchain_community.tools.multion.create_session import MultionCreateSession
+from langchain_community.tools.multion.update_session import MultionUpdateSession
+
+__all__ = ["MultionCreateSession", "MultionUpdateSession", "MultionCloseSession"]
diff --git a/llm/Lib/site-packages/langchain/tools/multion/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/multion/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ddf9ae2d352d4e6742179962a8dd8523bd7a77b2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/multion/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/multion/__pycache__/close_session.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/multion/__pycache__/close_session.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c7a6cf09d57ab209f0ea78f9ab9a36ff532b7613
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/multion/__pycache__/close_session.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/multion/__pycache__/create_session.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/multion/__pycache__/create_session.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1aa6268d965fad2d3ea461ea00ba1aa2efa58d54
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/multion/__pycache__/create_session.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/multion/__pycache__/update_session.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/multion/__pycache__/update_session.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6d990ded4f4fb84c06053cee1dbc4b1565f1d43e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/multion/__pycache__/update_session.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/multion/close_session.py b/llm/Lib/site-packages/langchain/tools/multion/close_session.py
new file mode 100644
index 0000000000000000000000000000000000000000..adea1d0832322ee3d3616c2d8ae65d0636518b78
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/multion/close_session.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.multion.close_session import (
+    CloseSessionSchema,
+    MultionCloseSession,
+)
+
+__all__ = ["CloseSessionSchema", "MultionCloseSession"]
diff --git a/llm/Lib/site-packages/langchain/tools/multion/create_session.py b/llm/Lib/site-packages/langchain/tools/multion/create_session.py
new file mode 100644
index 0000000000000000000000000000000000000000..91a969d837b24ea841f7ae70632bd108712a6c4c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/multion/create_session.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.multion.create_session import (
+    CreateSessionSchema,
+    MultionCreateSession,
+)
+
+__all__ = ["CreateSessionSchema", "MultionCreateSession"]
diff --git a/llm/Lib/site-packages/langchain/tools/multion/update_session.py b/llm/Lib/site-packages/langchain/tools/multion/update_session.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b158027429e93c4593a12f30a71ff791dc0a315
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/multion/update_session.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.multion.update_session import (
+    MultionUpdateSession,
+    UpdateSessionSchema,
+)
+
+__all__ = ["UpdateSessionSchema", "MultionUpdateSession"]
diff --git a/llm/Lib/site-packages/langchain/tools/nasa/__init__.py b/llm/Lib/site-packages/langchain/tools/nasa/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/tools/nasa/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/nasa/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0ae65746c489ffc89b33b6afa5cc2b930467ceca
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/nasa/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/nasa/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/nasa/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ef7ed2f542439c3f65e5dccc41be258b5a6fb2a2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/nasa/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/nasa/tool.py b/llm/Lib/site-packages/langchain/tools/nasa/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..5b8ea1405debda0dae4c1bf2938062608bf76114
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/nasa/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.nasa.tool import NasaAction
+
+__all__ = ["NasaAction"]
diff --git a/llm/Lib/site-packages/langchain/tools/nuclia/__init__.py b/llm/Lib/site-packages/langchain/tools/nuclia/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ea2f3dc651c107ee422203df2d6e2c8ff9a8e5d1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/nuclia/__init__.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.nuclia.tool import NucliaUnderstandingAPI
+
+__all__ = ["NucliaUnderstandingAPI"]
diff --git a/llm/Lib/site-packages/langchain/tools/nuclia/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/nuclia/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..87d60aabefa1846d21b5377d4500243d7ac9ca73
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/nuclia/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/nuclia/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/nuclia/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9f6c4fb441c0288af339586df95041f4640271a2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/nuclia/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/nuclia/tool.py b/llm/Lib/site-packages/langchain/tools/nuclia/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..85d9f635734dfd591684fd30724d39927e8f8a7d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/nuclia/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.nuclia.tool import NUASchema, NucliaUnderstandingAPI
+
+__all__ = ["NUASchema", "NucliaUnderstandingAPI"]
diff --git a/llm/Lib/site-packages/langchain/tools/office365/__init__.py b/llm/Lib/site-packages/langchain/tools/office365/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c896140defcce3520362fcb23a71d606192537f7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/office365/__init__.py
@@ -0,0 +1,17 @@
+"""O365 tools."""
+
+from langchain_community.tools.office365.create_draft_message import (
+    O365CreateDraftMessage,
+)
+from langchain_community.tools.office365.events_search import O365SearchEvents
+from langchain_community.tools.office365.messages_search import O365SearchEmails
+from langchain_community.tools.office365.send_event import O365SendEvent
+from langchain_community.tools.office365.send_message import O365SendMessage
+
+__all__ = [
+    "O365SearchEmails",
+    "O365SearchEvents",
+    "O365CreateDraftMessage",
+    "O365SendMessage",
+    "O365SendEvent",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/office365/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ec0cf495619ddb77b5900d86a0716fe153307c58
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/office365/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8b4a56880d5d0c733011f9c2f23e2af1b852bb12
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/office365/__pycache__/create_draft_message.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/create_draft_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c20b2ee9f76044328e8c82016a75cad2212468ef
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/create_draft_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/office365/__pycache__/events_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/events_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6e5922aef1e6179ce383da8bb7b4b607a6d2d7c1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/events_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/office365/__pycache__/messages_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/messages_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dfbc1fb4a56c3f26c630c5540dc54546a6b34c93
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/messages_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/office365/__pycache__/send_event.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/send_event.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..94d5d3a3b6dc07fa029f0664ff83abc72eed8eb7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/send_event.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/office365/__pycache__/send_message.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/send_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c9a4bbcb015bb71db644e0188ca4cad0950eceef
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/office365/__pycache__/send_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/office365/base.py b/llm/Lib/site-packages/langchain/tools/office365/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..246197f3e6546bcfa949ad6d06800e0cdfe215f6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/office365/base.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.office365.base import O365BaseTool
+
+__all__ = ["O365BaseTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/office365/create_draft_message.py b/llm/Lib/site-packages/langchain/tools/office365/create_draft_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..49a770cf680c9c0b74888e7c42f7d63da0fa1d32
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/office365/create_draft_message.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.office365.create_draft_message import (
+    CreateDraftMessageSchema,
+    O365CreateDraftMessage,
+)
+
+__all__ = ["CreateDraftMessageSchema", "O365CreateDraftMessage"]
diff --git a/llm/Lib/site-packages/langchain/tools/office365/events_search.py b/llm/Lib/site-packages/langchain/tools/office365/events_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..e11c00ac94fcf25ff1b38e85112f4b2b403b5829
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/office365/events_search.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.office365.events_search import (
+    O365SearchEvents,
+    SearchEventsInput,
+)
+
+__all__ = ["SearchEventsInput", "O365SearchEvents"]
diff --git a/llm/Lib/site-packages/langchain/tools/office365/messages_search.py b/llm/Lib/site-packages/langchain/tools/office365/messages_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..a03ca2203306fcd4cc7396a081f344bb6d7f756a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/office365/messages_search.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.office365.messages_search import (
+    O365SearchEmails,
+    SearchEmailsInput,
+)
+
+__all__ = ["SearchEmailsInput", "O365SearchEmails"]
diff --git a/llm/Lib/site-packages/langchain/tools/office365/send_event.py b/llm/Lib/site-packages/langchain/tools/office365/send_event.py
new file mode 100644
index 0000000000000000000000000000000000000000..657127b1fc1dfb791bed16592b9788aa30fc565f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/office365/send_event.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.office365.send_event import (
+    O365SendEvent,
+    SendEventSchema,
+)
+
+__all__ = ["SendEventSchema", "O365SendEvent"]
diff --git a/llm/Lib/site-packages/langchain/tools/office365/send_message.py b/llm/Lib/site-packages/langchain/tools/office365/send_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..f9d06ccde23db541e332fea6b54c1dc8a6ab02f0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/office365/send_message.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.office365.send_message import (
+    O365SendMessage,
+    SendMessageSchema,
+)
+
+__all__ = ["SendMessageSchema", "O365SendMessage"]
diff --git a/llm/Lib/site-packages/langchain/tools/openapi/__init__.py b/llm/Lib/site-packages/langchain/tools/openapi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/tools/openapi/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/openapi/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6aa236e6aa459be9f7efcc310dcbd1098a6e753a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/openapi/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/openapi/utils/__init__.py b/llm/Lib/site-packages/langchain/tools/openapi/utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/tools/openapi/utils/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/openapi/utils/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d92f21bed2ce32d17fd874ae85e85e4761c5adaa
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/openapi/utils/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/openapi/utils/__pycache__/api_models.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/openapi/utils/__pycache__/api_models.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c71ed774f510de8aebe8f4ae0f7b42207d75a976
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/openapi/utils/__pycache__/api_models.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/openapi/utils/__pycache__/openapi_utils.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/openapi/utils/__pycache__/openapi_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e053e84ca93072d83b04c4cba978f313638529f7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/openapi/utils/__pycache__/openapi_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/openapi/utils/api_models.py b/llm/Lib/site-packages/langchain/tools/openapi/utils/api_models.py
new file mode 100644
index 0000000000000000000000000000000000000000..8aef13466e25ba47f4613e17fb268bb17007c2d3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/openapi/utils/api_models.py
@@ -0,0 +1,25 @@
+from langchain_community.tools.openapi.utils.api_models import (
+    INVALID_LOCATION_TEMPL,
+    PRIMITIVE_TYPES,
+    SCHEMA_TYPE,
+    SUPPORTED_LOCATIONS,
+    APIOperation,
+    APIProperty,
+    APIPropertyBase,
+    APIPropertyLocation,
+    APIRequestBody,
+    APIRequestBodyProperty,
+)
+
+__all__ = [
+    "PRIMITIVE_TYPES",
+    "APIPropertyLocation",
+    "SUPPORTED_LOCATIONS",
+    "INVALID_LOCATION_TEMPL",
+    "SCHEMA_TYPE",
+    "APIPropertyBase",
+    "APIProperty",
+    "APIRequestBodyProperty",
+    "APIRequestBody",
+    "APIOperation",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/openapi/utils/openapi_utils.py b/llm/Lib/site-packages/langchain/tools/openapi/utils/openapi_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..e958d19d8384375ba89da03e7c7b5fc9543c3b6a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/openapi/utils/openapi_utils.py
@@ -0,0 +1,4 @@
+"""Utility functions for parsing an OpenAPI spec. Kept for backwards compat."""
+from langchain_community.utilities.openapi import HTTPVerb, OpenAPISpec
+
+__all__ = ["HTTPVerb", "OpenAPISpec"]
diff --git a/llm/Lib/site-packages/langchain/tools/openweathermap/__init__.py b/llm/Lib/site-packages/langchain/tools/openweathermap/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b2ff9b36515b11be8bf431285599c452a19574fc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/openweathermap/__init__.py
@@ -0,0 +1,8 @@
+"""OpenWeatherMap API toolkit."""
+
+
+from langchain_community.tools.openweathermap.tool import OpenWeatherMapQueryRun
+
+__all__ = [
+    "OpenWeatherMapQueryRun",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/openweathermap/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/openweathermap/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..722e8e763c80ff3cf2f7f3da18b9c1ad978c4f4d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/openweathermap/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/openweathermap/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/openweathermap/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e7f400577762a8036f37036555760073713d3e9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/openweathermap/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/openweathermap/tool.py b/llm/Lib/site-packages/langchain/tools/openweathermap/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..a443b5e808afbc99cd4188e106b60a22df77e6e4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/openweathermap/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.openweathermap.tool import OpenWeatherMapQueryRun
+
+__all__ = ["OpenWeatherMapQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/__init__.py b/llm/Lib/site-packages/langchain/tools/playwright/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f69ff8025d3a534f7e1310a1949d309dcc170e64
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/playwright/__init__.py
@@ -0,0 +1,21 @@
+"""Browser tools and toolkit."""
+
+from langchain_community.tools.playwright.click import ClickTool
+from langchain_community.tools.playwright.current_page import CurrentWebPageTool
+from langchain_community.tools.playwright.extract_hyperlinks import (
+    ExtractHyperlinksTool,
+)
+from langchain_community.tools.playwright.extract_text import ExtractTextTool
+from langchain_community.tools.playwright.get_elements import GetElementsTool
+from langchain_community.tools.playwright.navigate import NavigateTool
+from langchain_community.tools.playwright.navigate_back import NavigateBackTool
+
+__all__ = [
+    "NavigateTool",
+    "NavigateBackTool",
+    "ExtractTextTool",
+    "ExtractHyperlinksTool",
+    "GetElementsTool",
+    "ClickTool",
+    "CurrentWebPageTool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..46c8942a9b52d8071798cabf8fcb5397e761181c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5634c12aefa983805292a34083df06ef7326e66c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/click.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/click.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c897115e31953fec56a4bfa3e9c54eeaea92d743
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/click.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/current_page.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/current_page.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3ada01b31c6fa680c15cc382c6b6208f68e76d1a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/current_page.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/extract_hyperlinks.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/extract_hyperlinks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8679d34e4ba86aa06b76085b896dd9cb70ab5417
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/extract_hyperlinks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/extract_text.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/extract_text.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..58613985ecf939645ea700bad48e4f0c5db814d9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/extract_text.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/get_elements.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/get_elements.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4283ac05be60dcbe6dfbcbedade93d803d7a320e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/get_elements.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/navigate.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/navigate.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..373597aa78bc81aae9e25a9ee1fcaa42f43bd262
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/navigate.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/navigate_back.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/navigate_back.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..45f0ec33c18569976713adc616f0b27b58b73057
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/playwright/__pycache__/navigate_back.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/base.py b/llm/Lib/site-packages/langchain/tools/playwright/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..d6dd11d131680d6b208f4ca22b6da7155add0469
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/playwright/base.py
@@ -0,0 +1,5 @@
+from langchain_community.tools.playwright.base import (
+    BaseBrowserTool,
+)
+
+__all__ = ["BaseBrowserTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/click.py b/llm/Lib/site-packages/langchain/tools/playwright/click.py
new file mode 100644
index 0000000000000000000000000000000000000000..98abe89023ab95cb67c7927d3757df11d2777437
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/playwright/click.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.playwright.click import ClickTool, ClickToolInput
+
+__all__ = ["ClickToolInput", "ClickTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/current_page.py b/llm/Lib/site-packages/langchain/tools/playwright/current_page.py
new file mode 100644
index 0000000000000000000000000000000000000000..83781f095cb50c226538d8bf263f94997b9007d2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/playwright/current_page.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.playwright.current_page import CurrentWebPageTool
+
+__all__ = ["CurrentWebPageTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/extract_hyperlinks.py b/llm/Lib/site-packages/langchain/tools/playwright/extract_hyperlinks.py
new file mode 100644
index 0000000000000000000000000000000000000000..29403d51782998efd09d0022b9a1fbd6b202a1c7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/playwright/extract_hyperlinks.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.playwright.extract_hyperlinks import (
+    ExtractHyperlinksTool,
+    ExtractHyperlinksToolInput,
+)
+
+__all__ = ["ExtractHyperlinksToolInput", "ExtractHyperlinksTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/extract_text.py b/llm/Lib/site-packages/langchain/tools/playwright/extract_text.py
new file mode 100644
index 0000000000000000000000000000000000000000..bbfad07cac7b93b2a191da1543e5d9104b3343ad
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/playwright/extract_text.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.playwright.extract_text import ExtractTextTool
+
+__all__ = ["ExtractTextTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/get_elements.py b/llm/Lib/site-packages/langchain/tools/playwright/get_elements.py
new file mode 100644
index 0000000000000000000000000000000000000000..d916d30397dab2657a6c8dc9ded886ddd3358f01
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/playwright/get_elements.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.playwright.get_elements import (
+    GetElementsTool,
+    GetElementsToolInput,
+)
+
+__all__ = ["GetElementsToolInput", "GetElementsTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/navigate.py b/llm/Lib/site-packages/langchain/tools/playwright/navigate.py
new file mode 100644
index 0000000000000000000000000000000000000000..74b8da196b4f8d9397c6ad05da94fd993aa211f2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/playwright/navigate.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.playwright.navigate import (
+    NavigateTool,
+    NavigateToolInput,
+)
+
+__all__ = ["NavigateToolInput", "NavigateTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/playwright/navigate_back.py b/llm/Lib/site-packages/langchain/tools/playwright/navigate_back.py
new file mode 100644
index 0000000000000000000000000000000000000000..acaf33d15ae10a191713878d7057dd666bd7bf18
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/playwright/navigate_back.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.playwright.navigate_back import NavigateBackTool
+
+__all__ = ["NavigateBackTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/plugin.py b/llm/Lib/site-packages/langchain/tools/plugin.py
new file mode 100644
index 0000000000000000000000000000000000000000..d71751a4294a3a319e58dbdbb0fae3bcd2d7e225
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/plugin.py
@@ -0,0 +1,13 @@
+from langchain_community.tools.plugin import (
+    AIPlugin,
+    AIPluginTool,
+    AIPluginToolSchema,
+    ApiConfig,
+)
+
+__all__ = [
+    "ApiConfig",
+    "AIPlugin",
+    "AIPluginToolSchema",
+    "AIPluginTool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/powerbi/__init__.py b/llm/Lib/site-packages/langchain/tools/powerbi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ecc25a12f5797be27d45a53eea09834d9f2ba24
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/powerbi/__init__.py
@@ -0,0 +1 @@
+"""Tools for interacting with a PowerBI dataset."""
diff --git a/llm/Lib/site-packages/langchain/tools/powerbi/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/powerbi/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5d76aaa7ba8d8e6d730ea7a7d774f12a803c4cb8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/powerbi/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/powerbi/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/powerbi/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..44b91444cf01d92975a0b3e2d2649d4eb8592fa5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/powerbi/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/powerbi/tool.py b/llm/Lib/site-packages/langchain/tools/powerbi/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..5ca52a19733cbfd9e81d5e1e4937ee2253bb08e7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/powerbi/tool.py
@@ -0,0 +1,7 @@
+from langchain_community.tools.powerbi.tool import (
+    InfoPowerBITool,
+    ListPowerBITool,
+    QueryPowerBITool,
+)
+
+__all__ = ["QueryPowerBITool", "InfoPowerBITool", "ListPowerBITool"]
diff --git a/llm/Lib/site-packages/langchain/tools/pubmed/__init__.py b/llm/Lib/site-packages/langchain/tools/pubmed/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..687e908ee133084b2b15c0a4d4b287085d5d424b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/pubmed/__init__.py
@@ -0,0 +1 @@
+"""PubMed API toolkit."""
diff --git a/llm/Lib/site-packages/langchain/tools/pubmed/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/pubmed/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4c58ff04703892291c37346f5eb053b617408ded
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/pubmed/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/pubmed/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/pubmed/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e2b6be3d94339118acd7115e32a2541d59731b2e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/pubmed/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/pubmed/tool.py b/llm/Lib/site-packages/langchain/tools/pubmed/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..3e129b4395f7c4d6fb90f198feef016bb62ec33d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/pubmed/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.pubmed.tool import PubmedQueryRun
+
+__all__ = ["PubmedQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/python/__init__.py b/llm/Lib/site-packages/langchain/tools/python/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a7f4082d30a29bd45da8185486fcbeae9ac05b72
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/python/__init__.py
@@ -0,0 +1,12 @@
+from typing import Any
+
+
+def __getattr__(name: str = "") -> Any:
+    raise ImportError(
+        "This tool has been moved to langchain experiment. "
+        "This tool has access to a python REPL. "
+        "For best practices make sure to sandbox this tool. "
+        "Read https://github.com/langchain-ai/langchain/blob/master/SECURITY.md "
+        "To keep using this code as is, install langchain experimental and "
+        "update relevant imports replacing 'langchain' with 'langchain_experimental'"
+    )
diff --git a/llm/Lib/site-packages/langchain/tools/python/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/python/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0717a06a04a46228fa468fbc4895ae32d6f981b9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/python/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/reddit_search/__init__.py b/llm/Lib/site-packages/langchain/tools/reddit_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/tools/reddit_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/reddit_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b06de537736c0b0773655203b2bd0d67e6acef0b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/reddit_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/reddit_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/reddit_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a83d2e8de8eeab53f84ad6f43b26c9ef791e6029
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/reddit_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/reddit_search/tool.py b/llm/Lib/site-packages/langchain/tools/reddit_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..a53d7f71f4cea3ccab510070375fc13af757931d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/reddit_search/tool.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.reddit_search.tool import (
+    RedditSearchRun,
+    RedditSearchSchema,
+)
+
+__all__ = ["RedditSearchSchema", "RedditSearchRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/render.py b/llm/Lib/site-packages/langchain/tools/render.py
new file mode 100644
index 0000000000000000000000000000000000000000..cb6fde55ead3be6c9ad1029d65538a7c79a28014
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/render.py
@@ -0,0 +1,56 @@
+"""Different methods for rendering Tools to be passed to LLMs.
+
+Depending on the LLM you are using and the prompting strategy you are using,
+you may want Tools to be rendered in a different way.
+This module contains various ways to render tools.
+"""
+from typing import Callable, List
+
+# For backwards compatibility
+from langchain_core.tools import BaseTool
+from langchain_core.utils.function_calling import (
+    format_tool_to_openai_function,
+    format_tool_to_openai_tool,
+)
+
+__all__ = [
+    "ToolsRenderer",
+    "render_text_description",
+    "render_text_description_and_args",
+    "format_tool_to_openai_tool",
+    "format_tool_to_openai_function",
+]
+
+
+ToolsRenderer = Callable[[List[BaseTool]], str]
+
+
+def render_text_description(tools: List[BaseTool]) -> str:
+    """Render the tool name and description in plain text.
+
+    Output will be in the format of:
+
+    .. code-block:: markdown
+
+        search: This tool is used for search
+        calculator: This tool is used for math
+    """
+    return "\n".join([f"{tool.name}: {tool.description}" for tool in tools])
+
+
+def render_text_description_and_args(tools: List[BaseTool]) -> str:
+    """Render the tool name, description, and args in plain text.
+
+    Output will be in the format of:
+
+    .. code-block:: markdown
+
+        search: This tool is used for search, args: {"query": {"type": "string"}}
+        calculator: This tool is used for math, \
+args: {"expression": {"type": "string"}}
+    """
+    tool_strings = []
+    for tool in tools:
+        args_schema = str(tool.args)
+        tool_strings.append(f"{tool.name}: {tool.description}, args: {args_schema}")
+    return "\n".join(tool_strings)
diff --git a/llm/Lib/site-packages/langchain/tools/requests/__init__.py b/llm/Lib/site-packages/langchain/tools/requests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ec421f18dbdaa5b6f060ae11a6b92c21b9177377
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/requests/__init__.py
@@ -0,0 +1 @@
+"""Tools for making requests to an API endpoint."""
diff --git a/llm/Lib/site-packages/langchain/tools/requests/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/requests/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aab67b16c401b74cbd2a730ecdbe75399bd66ffe
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/requests/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/requests/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/requests/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..90380f9770c92f6bff7c4291f3a36780445aebdb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/requests/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/requests/tool.py b/llm/Lib/site-packages/langchain/tools/requests/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f1ea31f60eb8afb53e53cc294b926500f2256c4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/requests/tool.py
@@ -0,0 +1,17 @@
+from langchain_community.tools.requests.tool import (
+    BaseRequestsTool,
+    RequestsDeleteTool,
+    RequestsGetTool,
+    RequestsPatchTool,
+    RequestsPostTool,
+    RequestsPutTool,
+)
+
+__all__ = [
+    "BaseRequestsTool",
+    "RequestsGetTool",
+    "RequestsPostTool",
+    "RequestsPatchTool",
+    "RequestsPutTool",
+    "RequestsDeleteTool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/retriever.py b/llm/Lib/site-packages/langchain/tools/retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..5feeab6e04b773da3296912a03c5f3099b1281df
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/retriever.py
@@ -0,0 +1,90 @@
+from functools import partial
+from typing import Optional
+
+from langchain_core.callbacks.manager import (
+    Callbacks,
+)
+from langchain_core.prompts import (
+    BasePromptTemplate,
+    PromptTemplate,
+    aformat_document,
+    format_document,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.retrievers import BaseRetriever
+
+from langchain.tools import Tool
+
+
+class RetrieverInput(BaseModel):
+    """Input to the retriever."""
+
+    query: str = Field(description="query to look up in retriever")
+
+
+def _get_relevant_documents(
+    query: str,
+    retriever: BaseRetriever,
+    document_prompt: BasePromptTemplate,
+    document_separator: str,
+    callbacks: Callbacks = None,
+) -> str:
+    docs = retriever.get_relevant_documents(query, callbacks=callbacks)
+    return document_separator.join(
+        format_document(doc, document_prompt) for doc in docs
+    )
+
+
+async def _aget_relevant_documents(
+    query: str,
+    retriever: BaseRetriever,
+    document_prompt: BasePromptTemplate,
+    document_separator: str,
+    callbacks: Callbacks = None,
+) -> str:
+    docs = await retriever.aget_relevant_documents(query, callbacks=callbacks)
+    return document_separator.join(
+        [await aformat_document(doc, document_prompt) for doc in docs]
+    )
+
+
+def create_retriever_tool(
+    retriever: BaseRetriever,
+    name: str,
+    description: str,
+    *,
+    document_prompt: Optional[BasePromptTemplate] = None,
+    document_separator: str = "\n\n",
+) -> Tool:
+    """Create a tool to do retrieval of documents.
+
+    Args:
+        retriever: The retriever to use for the retrieval
+        name: The name for the tool. This will be passed to the language model,
+            so should be unique and somewhat descriptive.
+        description: The description for the tool. This will be passed to the language
+            model, so should be descriptive.
+
+    Returns:
+        Tool class to pass to an agent
+    """
+    document_prompt = document_prompt or PromptTemplate.from_template("{page_content}")
+    func = partial(
+        _get_relevant_documents,
+        retriever=retriever,
+        document_prompt=document_prompt,
+        document_separator=document_separator,
+    )
+    afunc = partial(
+        _aget_relevant_documents,
+        retriever=retriever,
+        document_prompt=document_prompt,
+        document_separator=document_separator,
+    )
+    return Tool(
+        name=name,
+        description=description,
+        func=func,
+        coroutine=afunc,
+        args_schema=RetrieverInput,
+    )
diff --git a/llm/Lib/site-packages/langchain/tools/scenexplain/__init__.py b/llm/Lib/site-packages/langchain/tools/scenexplain/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2e6553b73567d8f9fcee2ef79e2db807ca74613c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/scenexplain/__init__.py
@@ -0,0 +1 @@
+"""SceneXplain API toolkit."""
diff --git a/llm/Lib/site-packages/langchain/tools/scenexplain/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/scenexplain/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8d2d61a86ff6e43f153ba6269347bb127a933f44
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/scenexplain/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/scenexplain/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/scenexplain/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3dba047ca8f888abc42ade0a11551daa0e9fe7c9
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/scenexplain/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/scenexplain/tool.py b/llm/Lib/site-packages/langchain/tools/scenexplain/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..41301be400eeb1bb00eac62e393f2ca31726d747
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/scenexplain/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.scenexplain.tool import SceneXplainInput, SceneXplainTool
+
+__all__ = ["SceneXplainInput", "SceneXplainTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/searchapi/__init__.py b/llm/Lib/site-packages/langchain/tools/searchapi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7a89dfceffa48790385a5f8c23af83a485a50eea
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/searchapi/__init__.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.searchapi.tool import SearchAPIResults, SearchAPIRun
+
+"""SearchApi.io API Toolkit."""
+"""Tool for the SearchApi.io Google SERP API."""
+
+__all__ = ["SearchAPIResults", "SearchAPIRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/searchapi/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/searchapi/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e8d2ca0e32f8e9d7b651746c3ea263412f2d55c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/searchapi/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/searchapi/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/searchapi/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6f895f10e7d502f5e812d2cde6a00a198341bf9b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/searchapi/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/searchapi/tool.py b/llm/Lib/site-packages/langchain/tools/searchapi/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..4fb0bd865f8375836ca27b0a07b59a865ffd5d5c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/searchapi/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.searchapi.tool import SearchAPIResults, SearchAPIRun
+
+__all__ = ["SearchAPIRun", "SearchAPIResults"]
diff --git a/llm/Lib/site-packages/langchain/tools/searx_search/__init__.py b/llm/Lib/site-packages/langchain/tools/searx_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/tools/searx_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/searx_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3d12d7c5c4936f98b09109b623d4c14d56294066
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/searx_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/searx_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/searx_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8af142434258ac948b6aa536c4cd977b011f2a76
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/searx_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/searx_search/tool.py b/llm/Lib/site-packages/langchain/tools/searx_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..220bd6d79c0461664d74993d9da3496985d8e61a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/searx_search/tool.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.searx_search.tool import (
+    SearxSearchResults,
+    SearxSearchRun,
+)
+
+__all__ = ["SearxSearchRun", "SearxSearchResults"]
diff --git a/llm/Lib/site-packages/langchain/tools/shell/__init__.py b/llm/Lib/site-packages/langchain/tools/shell/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..37e11d4b597190d9ce6d8a65b9ec35c33e64e368
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/shell/__init__.py
@@ -0,0 +1,5 @@
+"""Shell tool."""
+
+from langchain_community.tools.shell.tool import ShellTool
+
+__all__ = ["ShellTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/shell/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/shell/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e178c2e2e5bfbc1ffe9830169126b3af4d5522f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/shell/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/shell/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/shell/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..905208692a96fd6e8081f27ec7e48e374e7bb8f4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/shell/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/shell/tool.py b/llm/Lib/site-packages/langchain/tools/shell/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc9d682da9e44c90195e531909788a6ed5068757
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/shell/tool.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.shell.tool import (
+    ShellInput,
+    ShellTool,
+)
+
+__all__ = ["ShellInput", "ShellTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/slack/__init__.py b/llm/Lib/site-packages/langchain/tools/slack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed03023780402c6dce92a0552a47a01e726bddab
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/slack/__init__.py
@@ -0,0 +1,13 @@
+"""Slack tools."""
+
+from langchain_community.tools.slack.get_channel import SlackGetChannel
+from langchain_community.tools.slack.get_message import SlackGetMessage
+from langchain_community.tools.slack.schedule_message import SlackScheduleMessage
+from langchain_community.tools.slack.send_message import SlackSendMessage
+
+__all__ = [
+    "SlackGetChannel",
+    "SlackGetMessage",
+    "SlackScheduleMessage",
+    "SlackSendMessage",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/slack/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/slack/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b8a301be0a7cbafd2d9d6a7430bd5aed41addba5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/slack/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/slack/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/slack/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d6251d891847a5a574f750b634cc6e4c08d81619
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/slack/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/slack/__pycache__/get_channel.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/slack/__pycache__/get_channel.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6fae7e94d8f1df80f7f685fec876b9581f1ba7fc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/slack/__pycache__/get_channel.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/slack/__pycache__/get_message.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/slack/__pycache__/get_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b313533ab0934c94fe12deaa660c677c9df4c21b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/slack/__pycache__/get_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/slack/__pycache__/schedule_message.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/slack/__pycache__/schedule_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5798a16dc4daa203cbb5830b81aa12ccdb2ed28c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/slack/__pycache__/schedule_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/slack/__pycache__/send_message.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/slack/__pycache__/send_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c537af7db5d335081aa84c5e53e9ae6f4939f4f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/slack/__pycache__/send_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/slack/base.py b/llm/Lib/site-packages/langchain/tools/slack/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d61348b58f28feab9ec77c5b03c827233df51ab
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/slack/base.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.slack.base import SlackBaseTool
+
+__all__ = ["SlackBaseTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/slack/get_channel.py b/llm/Lib/site-packages/langchain/tools/slack/get_channel.py
new file mode 100644
index 0000000000000000000000000000000000000000..44af231389fc9f32366393aec4bfa1888563ab15
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/slack/get_channel.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.slack.get_channel import SlackGetChannel
+
+__all__ = ["SlackGetChannel"]
diff --git a/llm/Lib/site-packages/langchain/tools/slack/get_message.py b/llm/Lib/site-packages/langchain/tools/slack/get_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f86c93f4a0d220f1b81a736296936e39ead7833
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/slack/get_message.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.slack.get_message import (
+    SlackGetMessage,
+    SlackGetMessageSchema,
+)
+
+__all__ = ["SlackGetMessageSchema", "SlackGetMessage"]
diff --git a/llm/Lib/site-packages/langchain/tools/slack/schedule_message.py b/llm/Lib/site-packages/langchain/tools/slack/schedule_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..f2f32a52d0c2d04b4dbe1a3163c999a5ff60b9d2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/slack/schedule_message.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.slack.schedule_message import (
+    ScheduleMessageSchema,
+    SlackScheduleMessage,
+)
+
+__all__ = ["ScheduleMessageSchema", "SlackScheduleMessage"]
diff --git a/llm/Lib/site-packages/langchain/tools/slack/send_message.py b/llm/Lib/site-packages/langchain/tools/slack/send_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..d18321f5a8cfb6cf7083fabec52bea8f7ba6a6e4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/slack/send_message.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.slack.send_message import (
+    SendMessageSchema,
+    SlackSendMessage,
+)
+
+__all__ = ["SendMessageSchema", "SlackSendMessage"]
diff --git a/llm/Lib/site-packages/langchain/tools/sleep/__init__.py b/llm/Lib/site-packages/langchain/tools/sleep/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d6319e2640da606c3219863bb2d4d0829534364
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/sleep/__init__.py
@@ -0,0 +1 @@
+"""Sleep tool."""
diff --git a/llm/Lib/site-packages/langchain/tools/sleep/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/sleep/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..44849544e1b20aab5c25672ac1025c7b69a4c75b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/sleep/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/sleep/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/sleep/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..791b280e19564c31b9572087d3735c0a19447c19
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/sleep/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/sleep/tool.py b/llm/Lib/site-packages/langchain/tools/sleep/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..588ddafc63055033d0a4cf2e4c48512c7f6d014d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/sleep/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.sleep.tool import SleepInput, SleepTool
+
+__all__ = ["SleepInput", "SleepTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/spark_sql/__init__.py b/llm/Lib/site-packages/langchain/tools/spark_sql/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..01039b772c689f99dbf690c40988d9701b4fd02f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/spark_sql/__init__.py
@@ -0,0 +1 @@
+"""Tools for interacting with Spark SQL."""
diff --git a/llm/Lib/site-packages/langchain/tools/spark_sql/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/spark_sql/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ef5519c08f498378882b8dd97c4a6ae3041b97b7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/spark_sql/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/spark_sql/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/spark_sql/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..063d6851d9fcd2227f009f1c1f8363b4ab9d9ff6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/spark_sql/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/spark_sql/tool.py b/llm/Lib/site-packages/langchain/tools/spark_sql/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..2221660f48690b6957374f735ba720343acafc8f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/spark_sql/tool.py
@@ -0,0 +1,15 @@
+from langchain_community.tools.spark_sql.tool import (
+    BaseSparkSQLTool,
+    InfoSparkSQLTool,
+    ListSparkSQLTool,
+    QueryCheckerTool,
+    QuerySparkSQLTool,
+)
+
+__all__ = [
+    "BaseSparkSQLTool",
+    "QuerySparkSQLTool",
+    "InfoSparkSQLTool",
+    "ListSparkSQLTool",
+    "QueryCheckerTool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/sql_database/__init__.py b/llm/Lib/site-packages/langchain/tools/sql_database/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..90fb3be1322f1bfab6e86d94f15fa4fac4639208
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/sql_database/__init__.py
@@ -0,0 +1 @@
+"""Tools for interacting with a SQL database."""
diff --git a/llm/Lib/site-packages/langchain/tools/sql_database/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/sql_database/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bcf680e71b6ce3029fd5b3140ec0a3b15ba675a7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/sql_database/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/sql_database/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/sql_database/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..135bc2d88e2ff043c77625bf63746fdea1253d07
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/sql_database/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/sql_database/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/sql_database/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..75f407afff17291f3b8d2c120a8d703133592182
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/sql_database/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/sql_database/prompt.py b/llm/Lib/site-packages/langchain/tools/sql_database/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..8eea844dd69371045a37431d6adeadad249061ff
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/sql_database/prompt.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.sql_database.prompt import QUERY_CHECKER
+
+__all__ = ["QUERY_CHECKER"]
diff --git a/llm/Lib/site-packages/langchain/tools/sql_database/tool.py b/llm/Lib/site-packages/langchain/tools/sql_database/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..501a599d79f3bfeea0531653387881e8746ac3b6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/sql_database/tool.py
@@ -0,0 +1,15 @@
+from langchain_community.tools.sql_database.tool import (
+    BaseSQLDatabaseTool,
+    InfoSQLDatabaseTool,
+    ListSQLDatabaseTool,
+    QuerySQLCheckerTool,
+    QuerySQLDataBaseTool,
+)
+
+__all__ = [
+    "BaseSQLDatabaseTool",
+    "QuerySQLDataBaseTool",
+    "InfoSQLDatabaseTool",
+    "ListSQLDatabaseTool",
+    "QuerySQLCheckerTool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/stackexchange/__init__.py b/llm/Lib/site-packages/langchain/tools/stackexchange/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1fa9a483d105cc96872fe6b464185fa286d9c3bb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/stackexchange/__init__.py
@@ -0,0 +1 @@
+"""StackExchange API toolkit."""
diff --git a/llm/Lib/site-packages/langchain/tools/stackexchange/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/stackexchange/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9fe4143aa502d0c4ae351e3bda2629ac57f53d77
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/stackexchange/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/stackexchange/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/stackexchange/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..678d307ea950eebc7fda31fb854e2544a9dc1482
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/stackexchange/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/stackexchange/tool.py b/llm/Lib/site-packages/langchain/tools/stackexchange/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..5afe7dd4fe647fbb6eccdeb24e7ed3e66e5eae20
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/stackexchange/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.stackexchange.tool import StackExchangeTool
+
+__all__ = ["StackExchangeTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/steam/__init__.py b/llm/Lib/site-packages/langchain/tools/steam/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9367fd95b3089f829ed69ae3f7a5ab848fa8e0d2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/steam/__init__.py
@@ -0,0 +1 @@
+"""Steam API toolkit"""
diff --git a/llm/Lib/site-packages/langchain/tools/steam/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/steam/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4c2b2aaa177626577abe7f772c3cde927845b2dd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/steam/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/steam/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/steam/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aef6c4d9e7d0278e7b37cbf440b2f52942aec7c8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/steam/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/steam/tool.py b/llm/Lib/site-packages/langchain/tools/steam/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..534b757e76e55938e147074d7a2395dc9377aa01
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/steam/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.steam.tool import SteamWebAPIQueryRun
+
+__all__ = ["SteamWebAPIQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/steamship_image_generation/__init__.py b/llm/Lib/site-packages/langchain/tools/steamship_image_generation/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e21672c72dc2541e2ae071133633d0651e7f0af2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/steamship_image_generation/__init__.py
@@ -0,0 +1,7 @@
+"""Tool to generate an image."""
+
+from langchain_community.tools.steamship_image_generation.tool import (
+    SteamshipImageGenerationTool,
+)
+
+__all__ = ["SteamshipImageGenerationTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/steamship_image_generation/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/steamship_image_generation/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5168e9cc79b1f7c0a53645f8760aaade5bae8016
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/steamship_image_generation/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/steamship_image_generation/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/steamship_image_generation/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a0f00d8396fbf110e7ecfd7b2756aab4bc263fb6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/steamship_image_generation/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/steamship_image_generation/tool.py b/llm/Lib/site-packages/langchain/tools/steamship_image_generation/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..97e207f2435a770f2a7575527ce84c0308babe16
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/steamship_image_generation/tool.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.steamship_image_generation.tool import (
+    ModelName,
+    SteamshipImageGenerationTool,
+)
+
+__all__ = ["ModelName", "SteamshipImageGenerationTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/tavily_search/__init__.py b/llm/Lib/site-packages/langchain/tools/tavily_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7c8ad700997e6fbd93282e6d33cc145966a6c45e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/tavily_search/__init__.py
@@ -0,0 +1,8 @@
+"""Tavily Search API toolkit."""
+
+from langchain_community.tools.tavily_search.tool import (
+    TavilyAnswer,
+    TavilySearchResults,
+)
+
+__all__ = ["TavilySearchResults", "TavilyAnswer"]
diff --git a/llm/Lib/site-packages/langchain/tools/tavily_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/tavily_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8c5fadc3459b21f88015263dd31e69815df75a9b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/tavily_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/tavily_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/tavily_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0a6b26e6475dc320c29b5a9cee9b93e33b3d7f9e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/tavily_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/tavily_search/tool.py b/llm/Lib/site-packages/langchain/tools/tavily_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..ea9c3658f1b622c175b552782fb98e86c738f1c6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/tavily_search/tool.py
@@ -0,0 +1,7 @@
+from langchain_community.tools.tavily_search.tool import (
+    TavilyAnswer,
+    TavilyInput,
+    TavilySearchResults,
+)
+
+__all__ = ["TavilyInput", "TavilySearchResults", "TavilyAnswer"]
diff --git a/llm/Lib/site-packages/langchain/tools/vectorstore/__init__.py b/llm/Lib/site-packages/langchain/tools/vectorstore/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2bb638101959c35f933e0cf8601a448205a5d43a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/vectorstore/__init__.py
@@ -0,0 +1 @@
+"""Simple tool wrapper around VectorDBQA chain."""
diff --git a/llm/Lib/site-packages/langchain/tools/vectorstore/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/vectorstore/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e9ba62184e9f89729d5644e1aae8ba6395a831a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/vectorstore/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/vectorstore/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/vectorstore/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9f59a4afd6e29b7ef0e313c07bdd5069c8a93d29
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/vectorstore/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/vectorstore/tool.py b/llm/Lib/site-packages/langchain/tools/vectorstore/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..f9fbef30b3fbe638b091078b2ea2a45f70b4b9ab
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/vectorstore/tool.py
@@ -0,0 +1,9 @@
+from langchain_community.tools.vectorstore.tool import (
+    VectorStoreQATool,
+    VectorStoreQAWithSourcesTool,
+)
+
+__all__ = [
+    "VectorStoreQATool",
+    "VectorStoreQAWithSourcesTool",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/wikipedia/__init__.py b/llm/Lib/site-packages/langchain/tools/wikipedia/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0b3edd083874aea350e44514d24c8f692307daef
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/wikipedia/__init__.py
@@ -0,0 +1 @@
+"""Wikipedia API toolkit."""
diff --git a/llm/Lib/site-packages/langchain/tools/wikipedia/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/wikipedia/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f6dc8fb805db254b70b25cbef9a22bf2b8aa39ac
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/wikipedia/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/wikipedia/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/wikipedia/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..435cdfe1d4642fa13cbe2c53ce11f0342fe3b6ed
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/wikipedia/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/wikipedia/tool.py b/llm/Lib/site-packages/langchain/tools/wikipedia/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..e349696ef625de5464d7a17b470c25492c403a62
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/wikipedia/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.wikipedia.tool import WikipediaQueryRun
+
+__all__ = ["WikipediaQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/wolfram_alpha/__init__.py b/llm/Lib/site-packages/langchain/tools/wolfram_alpha/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f5ec860d0acf617c822cdcaca41306d1870258d2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/wolfram_alpha/__init__.py
@@ -0,0 +1,8 @@
+"""Wolfram Alpha API toolkit."""
+
+
+from langchain_community.tools.wolfram_alpha.tool import WolframAlphaQueryRun
+
+__all__ = [
+    "WolframAlphaQueryRun",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/wolfram_alpha/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/wolfram_alpha/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..12fdb5b152742a656a843a11343e47611a4312fc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/wolfram_alpha/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/wolfram_alpha/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/wolfram_alpha/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b06c79beab7a808219f5464b5293e767e0dd9480
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/wolfram_alpha/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/wolfram_alpha/tool.py b/llm/Lib/site-packages/langchain/tools/wolfram_alpha/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..3286f39bcf6cb72865a61d5d11a8c280b2c0a8b0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/wolfram_alpha/tool.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.wolfram_alpha.tool import WolframAlphaQueryRun
+
+__all__ = ["WolframAlphaQueryRun"]
diff --git a/llm/Lib/site-packages/langchain/tools/yahoo_finance_news.py b/llm/Lib/site-packages/langchain/tools/yahoo_finance_news.py
new file mode 100644
index 0000000000000000000000000000000000000000..fccae3ea4b87d4ce6cb9010db35b3570ca37c4d2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/yahoo_finance_news.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.yahoo_finance_news import YahooFinanceNewsTool
+
+__all__ = ["YahooFinanceNewsTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/youtube/__init__.py b/llm/Lib/site-packages/langchain/tools/youtube/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain/tools/youtube/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/youtube/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6912f82c190134bb0e088fec8a5a44dd6a9426f3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/youtube/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/youtube/__pycache__/search.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/youtube/__pycache__/search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e0245cadc0219b8c9f0ba08ffcfd2f1c0fe060dc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/youtube/__pycache__/search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/youtube/search.py b/llm/Lib/site-packages/langchain/tools/youtube/search.py
new file mode 100644
index 0000000000000000000000000000000000000000..20f674a4ff5350363d70770f7bb2c2fbaf7d31ed
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/youtube/search.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.youtube.search import YouTubeSearchTool
+
+__all__ = ["YouTubeSearchTool"]
diff --git a/llm/Lib/site-packages/langchain/tools/zapier/__init__.py b/llm/Lib/site-packages/langchain/tools/zapier/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7f2c588844cc80518c019d71e45a8090085d093
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/zapier/__init__.py
@@ -0,0 +1,11 @@
+"""Zapier Tool."""
+
+from langchain_community.tools.zapier.tool import (
+    ZapierNLAListActions,
+    ZapierNLARunAction,
+)
+
+__all__ = [
+    "ZapierNLARunAction",
+    "ZapierNLAListActions",
+]
diff --git a/llm/Lib/site-packages/langchain/tools/zapier/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/zapier/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b96b439a358a4e178a71164bb10b6c50c4d56f33
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/zapier/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/zapier/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain/tools/zapier/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4367349529ffb1d0c20b442150b73b3c4a334900
Binary files /dev/null and b/llm/Lib/site-packages/langchain/tools/zapier/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/tools/zapier/tool.py b/llm/Lib/site-packages/langchain/tools/zapier/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..5a77accda0ecce89022d8ac3c5097d751fa7d7d2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/tools/zapier/tool.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.zapier.tool import (
+    ZapierNLAListActions,
+    ZapierNLARunAction,
+)
+
+__all__ = ["ZapierNLARunAction", "ZapierNLAListActions"]
diff --git a/llm/Lib/site-packages/langchain/utilities/__init__.py b/llm/Lib/site-packages/langchain/utilities/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..fce438aea398d60c540b1bf7b41bfac2216dc519
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/__init__.py
@@ -0,0 +1,83 @@
+"""**Utilities** are the integrations with third-part systems and packages.
+
+Other LangChain classes use **Utilities** to interact with third-part systems
+and packages.
+"""
+import warnings
+from typing import Any
+
+from langchain_community.utilities.requests import (
+    Requests,
+    RequestsWrapper,
+    TextRequestsWrapper,
+)
+from langchain_core._api import LangChainDeprecationWarning
+
+from langchain.utils.interactive_env import is_interactive_env
+
+
+def __getattr__(name: str) -> Any:
+    from langchain_community import utilities
+
+    # If not in interactive env, raise warning.
+    if not is_interactive_env():
+        warnings.warn(
+            "Importing this utility from langchain is deprecated. Importing it from "
+            "langchain will no longer be supported as of langchain==0.2.0. "
+            "Please import from langchain-community instead:\n\n"
+            f"`from langchain_community.utilities import {name}`.\n\n"
+            "To install langchain-community run `pip install -U langchain-community`.",
+            category=LangChainDeprecationWarning,
+        )
+
+    return getattr(utilities, name)
+
+
+__all__ = [
+    "AlphaVantageAPIWrapper",
+    "ApifyWrapper",
+    "ArceeWrapper",
+    "ArxivAPIWrapper",
+    "BibtexparserWrapper",
+    "BingSearchAPIWrapper",
+    "BraveSearchWrapper",
+    "DuckDuckGoSearchAPIWrapper",
+    "GoldenQueryAPIWrapper",
+    "GoogleFinanceAPIWrapper",
+    "GoogleLensAPIWrapper",
+    "GoogleJobsAPIWrapper",
+    "GooglePlacesAPIWrapper",
+    "GoogleScholarAPIWrapper",
+    "GoogleTrendsAPIWrapper",
+    "GoogleSearchAPIWrapper",
+    "GoogleSerperAPIWrapper",
+    "GraphQLAPIWrapper",
+    "JiraAPIWrapper",
+    "LambdaWrapper",
+    "MaxComputeAPIWrapper",
+    "MerriamWebsterAPIWrapper",
+    "MetaphorSearchAPIWrapper",
+    "NasaAPIWrapper",
+    "OpenWeatherMapAPIWrapper",
+    "OutlineAPIWrapper",
+    "Portkey",
+    "PowerBIDataset",
+    "PubMedAPIWrapper",
+    "PythonREPL",
+    "Requests",
+    "RequestsWrapper",
+    "SteamWebAPIWrapper",
+    "SQLDatabase",
+    "SceneXplainAPIWrapper",
+    "SearchApiAPIWrapper",
+    "SearxSearchWrapper",
+    "SerpAPIWrapper",
+    "SparkSQL",
+    "StackExchangeAPIWrapper",
+    "TensorflowDatasets",
+    "TextRequestsWrapper",
+    "TwilioAPIWrapper",
+    "WikipediaAPIWrapper",
+    "WolframAlphaAPIWrapper",
+    "ZapierNLAWrapper",
+]
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..509ab33708f1bd7bcbfcb946e3dad1ccc4b4d263
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/alpha_vantage.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/alpha_vantage.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..20f175fa822136f8b512cb2919da04f21abef0bc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/alpha_vantage.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/anthropic.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/anthropic.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bb85f99a5484914621616475730d8a2151daf037
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/anthropic.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/apify.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/apify.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..995e65f71e728f3c0debfe13b0af6679bbd4e305
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/apify.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/arcee.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/arcee.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d91a44ad45a4a62ec6a886bbed3d344398c187dd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/arcee.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/arxiv.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/arxiv.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ccec43fd02dd0d75ba3f501e91c3a685bebf101a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/arxiv.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/asyncio.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/asyncio.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..04a31fd3531b7b7025c6001273c82d65619ae820
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/asyncio.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/awslambda.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/awslambda.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4edc62ce41b6368a201382ccf7599024a2f66641
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/awslambda.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/bibtex.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/bibtex.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5f35838d1d840a21de78adb365f55231d5c22181
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/bibtex.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/bing_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/bing_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cdc228b85c068928f30fcd0e2cc8c01e3fd18795
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/bing_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/brave_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/brave_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cf2d1e65736da7007c38010dd9ed2774e3cab2ea
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/brave_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/clickup.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/clickup.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c3df586d2a705426a1d63a648a3aefeb8659a144
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/clickup.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/dalle_image_generator.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/dalle_image_generator.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..38322ca728037fac9b714c713d054ad6fc1a7118
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/dalle_image_generator.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/dataforseo_api_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/dataforseo_api_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f98373fb4489b264396a68eec049dcd44a57dcdb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/dataforseo_api_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/duckduckgo_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/duckduckgo_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6e68a87c03132415db98c786bec43dfaf98ea176
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/duckduckgo_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/github.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/github.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cc4d5aaa364cbcf940a3f666c3c42c5606cd3643
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/github.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/gitlab.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/gitlab.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ea53782c4c3528e97728e7121844ab20474a2bed
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/gitlab.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/golden_query.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/golden_query.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fc2724fc8f54bbab8351f445970cd25d06e15b8f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/golden_query.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/google_finance.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_finance.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..27bf9a4bb1989564a499460b4b45c21982518df8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_finance.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/google_jobs.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_jobs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a9ce08e63df54d7b07f0a978a666e6be297b743c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_jobs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/google_lens.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_lens.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5e44b9cb24e3b3fd3ce42a3ed56a161eb200ea27
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_lens.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/google_places_api.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_places_api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..98f6d875f3dfc65ff2bace15401daf0b7890c159
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_places_api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/google_scholar.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_scholar.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c2e2421820df7412d0f9fdc62afdb17785eae066
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_scholar.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/google_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3bf845b212a89caf116f55fee650d4922cd3711c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/google_serper.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_serper.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0e59b7e3537693961758f523e214f7df1acc1eff
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_serper.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/google_trends.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_trends.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7f28b0ce3ad0d3ad95d3d206f02bf8e065d7a354
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/google_trends.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/graphql.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/graphql.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f21ea2c02b7b8e735f4162b479ffd070dec13c2f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/graphql.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/jira.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/jira.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0071c7c4456c07a0ea7f3797aec3ff9384dd0781
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/jira.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/loading.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/loading.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a15f51c2da2624210c36f22e4b1f9c5cb1ab7e8e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/loading.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/max_compute.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/max_compute.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1a2c1db2b1af028dac09ac2abf59fa6a44fea3ca
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/max_compute.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/merriam_webster.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/merriam_webster.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0fc6fd531671882e79edccae87139aeede053acb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/merriam_webster.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/metaphor_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/metaphor_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dc8143688ddf94f535bc551d779367d715df8735
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/metaphor_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/nasa.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/nasa.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a03b3de922950b1bf370dcbba9212acbf722553a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/nasa.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/opaqueprompts.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/opaqueprompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..14424f4968d46ab06a93ee8acbd9e36e2a552597
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/opaqueprompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/openapi.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/openapi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..db0bfc3f6c10f1b59073bde8694a13809b708bf7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/openapi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/openweathermap.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/openweathermap.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9886023adc343be32a96465f8868ffa5f69dbc0c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/openweathermap.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/outline.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/outline.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8412fe18a3d99efac89b7f101f09b52ec61fa05e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/outline.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/portkey.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/portkey.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c5b8e68aa6bcffc9e8046da1913a08b194c7cab0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/portkey.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/powerbi.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/powerbi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..01db393fa6c35497d00b1c75e8631c0f3c74cd1e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/powerbi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/pubmed.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/pubmed.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9ae5b55ec940d59212b55cef5564231b2295ed00
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/pubmed.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/python.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/python.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b8fcae4ccc87756c51c008a7e2e8e14ae67f9ca7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/python.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/reddit_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/reddit_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fbf872491fc4af388f4968ab7f56fff235c16315
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/reddit_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/redis.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/redis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..40e6550d0751eb1820af331030e58dc7ea1a509c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/redis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/requests.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/requests.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e3c7d872003f96d3f9c952ad6e441d346966461
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/requests.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/scenexplain.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/scenexplain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7ac998444c483389b7819c6bafaac86cbe1b98e3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/scenexplain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/searchapi.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/searchapi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..80ac65e9a7f7020b3badab18717d1653a0d31414
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/searchapi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/searx_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/searx_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7300cd5642cad2f260cefcd5db4509da8c6efcf4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/searx_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/serpapi.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/serpapi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e46974dfe758dcaa2b07a6acba9f15aeac56cc4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/serpapi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/spark_sql.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/spark_sql.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d9a8e046ed1fb4ac89ed5846d9ccd99cb306ae8f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/spark_sql.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/sql_database.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/sql_database.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6e2bb66fd7d4cbc02bad9e883f3491259e76115d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/sql_database.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/stackexchange.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/stackexchange.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2c92c557ea28df50f95526f316f3b29e3f94e402
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/stackexchange.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/steam.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/steam.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b333d6f0660e04ff96a0e520f087d3d38f32b2e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/steam.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/tavily_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/tavily_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fd06a6c5b7d19b618d3af2238e11b55310cbf000
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/tavily_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/tensorflow_datasets.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/tensorflow_datasets.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..46bf31d946a02d7d3808a4488e7d723e020bca99
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/tensorflow_datasets.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/twilio.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/twilio.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..85d3ed499488e966e28f655f7550369ac72dcef2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/twilio.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/vertexai.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/vertexai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..22c9ac6975ca5a1eea3d2054bc0bf6cff9ff8177
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/vertexai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/wikipedia.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/wikipedia.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..75f0dc76e7cc2808605cfc7c8f906e2110371ef0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/wikipedia.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/wolfram_alpha.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/wolfram_alpha.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c76ef4a7e899be1bec7968f425d1eebc60fef6af
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/wolfram_alpha.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/__pycache__/zapier.cpython-311.pyc b/llm/Lib/site-packages/langchain/utilities/__pycache__/zapier.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..30baaf107e3f84a089ebea22b5a9b7ec47a06ca0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utilities/__pycache__/zapier.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utilities/alpha_vantage.py b/llm/Lib/site-packages/langchain/utilities/alpha_vantage.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ca7072e29bf77fa6ef1b5dda8dcc00de2a22ce1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/alpha_vantage.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.alpha_vantage import AlphaVantageAPIWrapper
+
+__all__ = ["AlphaVantageAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/anthropic.py b/llm/Lib/site-packages/langchain/utilities/anthropic.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff9706ee4e2928d8f28cf75fab3f8520d1c793d0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/anthropic.py
@@ -0,0 +1,9 @@
+from langchain_community.utilities.anthropic import (
+    get_num_tokens_anthropic,
+    get_token_ids_anthropic,
+)
+
+__all__ = [
+    "get_num_tokens_anthropic",
+    "get_token_ids_anthropic",
+]
diff --git a/llm/Lib/site-packages/langchain/utilities/apify.py b/llm/Lib/site-packages/langchain/utilities/apify.py
new file mode 100644
index 0000000000000000000000000000000000000000..9cfa0f7fabfaf2505ec7cf59fb8293f15c6adcbf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/apify.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.apify import ApifyWrapper
+
+__all__ = ["ApifyWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/arcee.py b/llm/Lib/site-packages/langchain/utilities/arcee.py
new file mode 100644
index 0000000000000000000000000000000000000000..a847bdf2eccecbf0ecc5aafc4e4e290127dcc4fc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/arcee.py
@@ -0,0 +1,19 @@
+from langchain_community.utilities.arcee import (
+    ArceeDocument,
+    ArceeDocumentAdapter,
+    ArceeDocumentSource,
+    ArceeRoute,
+    ArceeWrapper,
+    DALMFilter,
+    DALMFilterType,
+)
+
+__all__ = [
+    "ArceeRoute",
+    "DALMFilterType",
+    "DALMFilter",
+    "ArceeDocumentSource",
+    "ArceeDocument",
+    "ArceeDocumentAdapter",
+    "ArceeWrapper",
+]
diff --git a/llm/Lib/site-packages/langchain/utilities/arxiv.py b/llm/Lib/site-packages/langchain/utilities/arxiv.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca6305e8272e90f48933a969d24a7b6ac59ac12c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/arxiv.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.arxiv import ArxivAPIWrapper
+
+__all__ = ["ArxivAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/asyncio.py b/llm/Lib/site-packages/langchain/utilities/asyncio.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7db052e93d3e658ac5eda0965a95fc2efcac9b8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/asyncio.py
@@ -0,0 +1,11 @@
+"""Shims for asyncio features that may be missing from older python versions"""
+
+import sys
+
+if sys.version_info[:2] < (3, 11):
+    from async_timeout import timeout as asyncio_timeout
+else:
+    from asyncio import timeout as asyncio_timeout
+
+
+__all__ = ["asyncio_timeout"]
diff --git a/llm/Lib/site-packages/langchain/utilities/awslambda.py b/llm/Lib/site-packages/langchain/utilities/awslambda.py
new file mode 100644
index 0000000000000000000000000000000000000000..25b1898bf95415bed325c5a421fafc50809c8176
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/awslambda.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.awslambda import LambdaWrapper
+
+__all__ = ["LambdaWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/bibtex.py b/llm/Lib/site-packages/langchain/utilities/bibtex.py
new file mode 100644
index 0000000000000000000000000000000000000000..599d25922c435b485daedad2ce0b16742870dc71
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/bibtex.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.bibtex import BibtexparserWrapper
+
+__all__ = ["BibtexparserWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/bing_search.py b/llm/Lib/site-packages/langchain/utilities/bing_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..dbe78b1c977fd52b386bddbbc743f8965c3f4e9e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/bing_search.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.bing_search import BingSearchAPIWrapper
+
+__all__ = ["BingSearchAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/brave_search.py b/llm/Lib/site-packages/langchain/utilities/brave_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..e4b414e115436e06c001aed625ee229ba8da60da
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/brave_search.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.brave_search import BraveSearchWrapper
+
+__all__ = ["BraveSearchWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/clickup.py b/llm/Lib/site-packages/langchain/utilities/clickup.py
new file mode 100644
index 0000000000000000000000000000000000000000..4598c3e976213794e39dd440f027707c2cbd0d2e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/clickup.py
@@ -0,0 +1,19 @@
+from langchain_community.utilities.clickup import (
+    ClickupAPIWrapper,
+    Component,
+    CUList,
+    Member,
+    Space,
+    Task,
+    Team,
+)
+
+__all__ = [
+    "Component",
+    "Task",
+    "CUList",
+    "Member",
+    "Team",
+    "Space",
+    "ClickupAPIWrapper",
+]
diff --git a/llm/Lib/site-packages/langchain/utilities/dalle_image_generator.py b/llm/Lib/site-packages/langchain/utilities/dalle_image_generator.py
new file mode 100644
index 0000000000000000000000000000000000000000..cccc45d9130fca9c9e17724fedb44d906119fd76
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/dalle_image_generator.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.dalle_image_generator import DallEAPIWrapper
+
+__all__ = ["DallEAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/dataforseo_api_search.py b/llm/Lib/site-packages/langchain/utilities/dataforseo_api_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..389cc96ed3a17f00d8b01afcef945dee5c32d9ea
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/dataforseo_api_search.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.dataforseo_api_search import DataForSeoAPIWrapper
+
+__all__ = ["DataForSeoAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/duckduckgo_search.py b/llm/Lib/site-packages/langchain/utilities/duckduckgo_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c6daf83ffc8b2e88f59b198afba3da103969c70
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/duckduckgo_search.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.duckduckgo_search import DuckDuckGoSearchAPIWrapper
+
+__all__ = ["DuckDuckGoSearchAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/github.py b/llm/Lib/site-packages/langchain/utilities/github.py
new file mode 100644
index 0000000000000000000000000000000000000000..89c0fe455ceee96ec2531acd52df9ae923115a17
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/github.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.github import GitHubAPIWrapper
+
+__all__ = ["GitHubAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/gitlab.py b/llm/Lib/site-packages/langchain/utilities/gitlab.py
new file mode 100644
index 0000000000000000000000000000000000000000..13df0d4c2843a637fdfcfa51ed609313e68ee97f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/gitlab.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.gitlab import GitLabAPIWrapper
+
+__all__ = ["GitLabAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/golden_query.py b/llm/Lib/site-packages/langchain/utilities/golden_query.py
new file mode 100644
index 0000000000000000000000000000000000000000..cccb89e11bde0511eb005d1cc9592e9e850b4e9c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/golden_query.py
@@ -0,0 +1,5 @@
+from langchain_community.utilities.golden_query import (
+    GoldenQueryAPIWrapper,
+)
+
+__all__ = ["GoldenQueryAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/google_finance.py b/llm/Lib/site-packages/langchain/utilities/google_finance.py
new file mode 100644
index 0000000000000000000000000000000000000000..e674e9358611c05e5dbd4b102ab8b0b1d4261043
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/google_finance.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.google_finance import GoogleFinanceAPIWrapper
+
+__all__ = ["GoogleFinanceAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/google_jobs.py b/llm/Lib/site-packages/langchain/utilities/google_jobs.py
new file mode 100644
index 0000000000000000000000000000000000000000..339a42f8ec9c257709e033bdb2390f754ba626d4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/google_jobs.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.google_jobs import GoogleJobsAPIWrapper
+
+__all__ = ["GoogleJobsAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/google_lens.py b/llm/Lib/site-packages/langchain/utilities/google_lens.py
new file mode 100644
index 0000000000000000000000000000000000000000..e7a90cfae6706be9262f991a7384ba4883e5d7db
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/google_lens.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.google_lens import GoogleLensAPIWrapper
+
+__all__ = ["GoogleLensAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/google_places_api.py b/llm/Lib/site-packages/langchain/utilities/google_places_api.py
new file mode 100644
index 0000000000000000000000000000000000000000..82a23270dce9341d64f55855cd814a4495cee47a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/google_places_api.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.google_places_api import GooglePlacesAPIWrapper
+
+__all__ = ["GooglePlacesAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/google_scholar.py b/llm/Lib/site-packages/langchain/utilities/google_scholar.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d62171385906202110620063f0e5ee2bfcc0397
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/google_scholar.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.google_scholar import GoogleScholarAPIWrapper
+
+__all__ = ["GoogleScholarAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/google_search.py b/llm/Lib/site-packages/langchain/utilities/google_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e237aeabd838f34c3fee9e2dd483f8e4a81b49a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/google_search.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.google_search import GoogleSearchAPIWrapper
+
+__all__ = ["GoogleSearchAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/google_serper.py b/llm/Lib/site-packages/langchain/utilities/google_serper.py
new file mode 100644
index 0000000000000000000000000000000000000000..559a5800a309fe301d21aa63a9f7811001c22556
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/google_serper.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.google_serper import GoogleSerperAPIWrapper
+
+__all__ = ["GoogleSerperAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/google_trends.py b/llm/Lib/site-packages/langchain/utilities/google_trends.py
new file mode 100644
index 0000000000000000000000000000000000000000..697b355d4ac12eb75c7123961fa23dd070bb9963
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/google_trends.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.google_trends import GoogleTrendsAPIWrapper
+
+__all__ = ["GoogleTrendsAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/graphql.py b/llm/Lib/site-packages/langchain/utilities/graphql.py
new file mode 100644
index 0000000000000000000000000000000000000000..4bed67bde83433b5cff1b4f577e090d9c74375ee
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/graphql.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.graphql import GraphQLAPIWrapper
+
+__all__ = ["GraphQLAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/jira.py b/llm/Lib/site-packages/langchain/utilities/jira.py
new file mode 100644
index 0000000000000000000000000000000000000000..b4adf0b1c46a7d7c6f620964f8ad675c7e9281cf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/jira.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.jira import JiraAPIWrapper
+
+__all__ = ["JiraAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/loading.py b/llm/Lib/site-packages/langchain/utilities/loading.py
new file mode 100644
index 0000000000000000000000000000000000000000..a2337b6df41f175fa7f25cd48356ec45b14df781
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/loading.py
@@ -0,0 +1,4 @@
+from langchain_core.utils.loading import try_load_from_hub
+
+# For backwards compatibility
+__all__ = ["try_load_from_hub"]
diff --git a/llm/Lib/site-packages/langchain/utilities/max_compute.py b/llm/Lib/site-packages/langchain/utilities/max_compute.py
new file mode 100644
index 0000000000000000000000000000000000000000..bbd2052c59829092f7bf40497873607dea9cacc3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/max_compute.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.max_compute import MaxComputeAPIWrapper
+
+__all__ = ["MaxComputeAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/merriam_webster.py b/llm/Lib/site-packages/langchain/utilities/merriam_webster.py
new file mode 100644
index 0000000000000000000000000000000000000000..f3ab7961aaaf0358cc7528fd43b10719bebb7dc2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/merriam_webster.py
@@ -0,0 +1,7 @@
+from langchain_community.utilities.merriam_webster import (
+    MerriamWebsterAPIWrapper,
+)
+
+__all__ = [
+    "MerriamWebsterAPIWrapper",
+]
diff --git a/llm/Lib/site-packages/langchain/utilities/metaphor_search.py b/llm/Lib/site-packages/langchain/utilities/metaphor_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..fdd26ba43d7130112296e89ebcdc4d1e188c0f0d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/metaphor_search.py
@@ -0,0 +1,5 @@
+from langchain_community.utilities.metaphor_search import (
+    MetaphorSearchAPIWrapper,
+)
+
+__all__ = ["MetaphorSearchAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/nasa.py b/llm/Lib/site-packages/langchain/utilities/nasa.py
new file mode 100644
index 0000000000000000000000000000000000000000..ae5d9ccb25bc4c2bdd710e36d9e946e9bcfe21fd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/nasa.py
@@ -0,0 +1,5 @@
+from langchain_community.utilities.nasa import (
+    NasaAPIWrapper,
+)
+
+__all__ = ["NasaAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/opaqueprompts.py b/llm/Lib/site-packages/langchain/utilities/opaqueprompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..57ad15e379942094038e32be4220d854f8d87370
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/opaqueprompts.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.opaqueprompts import desanitize, sanitize
+
+__all__ = ["sanitize", "desanitize"]
diff --git a/llm/Lib/site-packages/langchain/utilities/openapi.py b/llm/Lib/site-packages/langchain/utilities/openapi.py
new file mode 100644
index 0000000000000000000000000000000000000000..98279154e0eb622794c9feff8b45a8856bd22343
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/openapi.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.openapi import HTTPVerb, OpenAPISpec
+
+__all__ = ["HTTPVerb", "OpenAPISpec"]
diff --git a/llm/Lib/site-packages/langchain/utilities/openweathermap.py b/llm/Lib/site-packages/langchain/utilities/openweathermap.py
new file mode 100644
index 0000000000000000000000000000000000000000..fca7edda50c2944d543581dd7e48d73ad77d9ede
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/openweathermap.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.openweathermap import OpenWeatherMapAPIWrapper
+
+__all__ = ["OpenWeatherMapAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/outline.py b/llm/Lib/site-packages/langchain/utilities/outline.py
new file mode 100644
index 0000000000000000000000000000000000000000..9cdebd8a2cbb9808a3bdd0f6a65508956ed2e619
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/outline.py
@@ -0,0 +1,5 @@
+from langchain_community.utilities.outline import (
+    OutlineAPIWrapper,
+)
+
+__all__ = ["OutlineAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/portkey.py b/llm/Lib/site-packages/langchain/utilities/portkey.py
new file mode 100644
index 0000000000000000000000000000000000000000..c44c72110a5a545ae3ca039888cdf918fb03e0bd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/portkey.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.portkey import Portkey
+
+__all__ = ["Portkey"]
diff --git a/llm/Lib/site-packages/langchain/utilities/powerbi.py b/llm/Lib/site-packages/langchain/utilities/powerbi.py
new file mode 100644
index 0000000000000000000000000000000000000000..f01eb8ab52c1f98ba36fe90ba00ca024528118b5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/powerbi.py
@@ -0,0 +1,7 @@
+from langchain_community.utilities.powerbi import (
+    PowerBIDataset,
+)
+
+__all__ = [
+    "PowerBIDataset",
+]
diff --git a/llm/Lib/site-packages/langchain/utilities/pubmed.py b/llm/Lib/site-packages/langchain/utilities/pubmed.py
new file mode 100644
index 0000000000000000000000000000000000000000..f5784cd0e930784e414ca35e7d77967f19fbcf22
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/pubmed.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.pubmed import PubMedAPIWrapper
+
+__all__ = ["PubMedAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/python.py b/llm/Lib/site-packages/langchain/utilities/python.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce787ea46638318723574fbdeff8fba46020c10a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/python.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.python import PythonREPL
+
+__all__ = ["PythonREPL"]
diff --git a/llm/Lib/site-packages/langchain/utilities/reddit_search.py b/llm/Lib/site-packages/langchain/utilities/reddit_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..aeabf49b2222b78cb695266adc778772b6af3a4f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/reddit_search.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.reddit_search import RedditSearchAPIWrapper
+
+__all__ = ["RedditSearchAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/redis.py b/llm/Lib/site-packages/langchain/utilities/redis.py
new file mode 100644
index 0000000000000000000000000000000000000000..c31d9b15c13701dd4438858bcbc59cec0fc8d271
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/redis.py
@@ -0,0 +1,11 @@
+from langchain_community.utilities.redis import (
+    TokenEscaper,
+    check_redis_module_exist,
+    get_client,
+)
+
+__all__ = [
+    "TokenEscaper",
+    "check_redis_module_exist",
+    "get_client",
+]
diff --git a/llm/Lib/site-packages/langchain/utilities/requests.py b/llm/Lib/site-packages/langchain/utilities/requests.py
new file mode 100644
index 0000000000000000000000000000000000000000..bb3b0c97aff231e821d9d494867a5ecfb917938d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/requests.py
@@ -0,0 +1,7 @@
+from langchain_community.utilities.requests import (
+    Requests,
+    RequestsWrapper,
+    TextRequestsWrapper,
+)
+
+__all__ = ["Requests", "TextRequestsWrapper", "RequestsWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/scenexplain.py b/llm/Lib/site-packages/langchain/utilities/scenexplain.py
new file mode 100644
index 0000000000000000000000000000000000000000..730ce9dad16974d30168ee758321dd749fc113e3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/scenexplain.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.scenexplain import SceneXplainAPIWrapper
+
+__all__ = ["SceneXplainAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/searchapi.py b/llm/Lib/site-packages/langchain/utilities/searchapi.py
new file mode 100644
index 0000000000000000000000000000000000000000..04df8972a7b824a13caf22a6ef04e039a4c30482
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/searchapi.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.searchapi import SearchApiAPIWrapper
+
+__all__ = ["SearchApiAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/searx_search.py b/llm/Lib/site-packages/langchain/utilities/searx_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a71f8035862ddf6f9c43f73d6ec90720085c685
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/searx_search.py
@@ -0,0 +1,6 @@
+from langchain_community.utilities.searx_search import (
+    SearxResults,
+    SearxSearchWrapper,
+)
+
+__all__ = ["SearxResults", "SearxSearchWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/serpapi.py b/llm/Lib/site-packages/langchain/utilities/serpapi.py
new file mode 100644
index 0000000000000000000000000000000000000000..126396d099bbe6c603d6703ebd9228c2e215635f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/serpapi.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.serpapi import HiddenPrints, SerpAPIWrapper
+
+__all__ = ["HiddenPrints", "SerpAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/spark_sql.py b/llm/Lib/site-packages/langchain/utilities/spark_sql.py
new file mode 100644
index 0000000000000000000000000000000000000000..a7bb2f4e3c86f74c3a6c57050f74252c7bf9285d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/spark_sql.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.spark_sql import SparkSQL
+
+__all__ = ["SparkSQL"]
diff --git a/llm/Lib/site-packages/langchain/utilities/sql_database.py b/llm/Lib/site-packages/langchain/utilities/sql_database.py
new file mode 100644
index 0000000000000000000000000000000000000000..40a093b987fb5cfe15b68b3505c8b369f43357dd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/sql_database.py
@@ -0,0 +1,6 @@
+from langchain_community.utilities.sql_database import (
+    SQLDatabase,
+    truncate_word,
+)
+
+__all__ = ["truncate_word", "SQLDatabase"]
diff --git a/llm/Lib/site-packages/langchain/utilities/stackexchange.py b/llm/Lib/site-packages/langchain/utilities/stackexchange.py
new file mode 100644
index 0000000000000000000000000000000000000000..02b9ee4b212ea3276eeeea851e7d6df792996eee
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/stackexchange.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.stackexchange import StackExchangeAPIWrapper
+
+__all__ = ["StackExchangeAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/steam.py b/llm/Lib/site-packages/langchain/utilities/steam.py
new file mode 100644
index 0000000000000000000000000000000000000000..37ff4c96907679f952b90d21c6d4a2422ae7ef9c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/steam.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.steam import SteamWebAPIWrapper
+
+__all__ = ["SteamWebAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/tavily_search.py b/llm/Lib/site-packages/langchain/utilities/tavily_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..651ca62edc80161ecc7329431bd166b7cc0597ae
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/tavily_search.py
@@ -0,0 +1,5 @@
+from langchain_community.utilities.tavily_search import (
+    TavilySearchAPIWrapper,
+)
+
+__all__ = ["TavilySearchAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/tensorflow_datasets.py b/llm/Lib/site-packages/langchain/utilities/tensorflow_datasets.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ae0215b411d2e98485b5e0dd2658e9bd1a36cac
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/tensorflow_datasets.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.tensorflow_datasets import TensorflowDatasets
+
+__all__ = ["TensorflowDatasets"]
diff --git a/llm/Lib/site-packages/langchain/utilities/twilio.py b/llm/Lib/site-packages/langchain/utilities/twilio.py
new file mode 100644
index 0000000000000000000000000000000000000000..58d3522122ae5ba5fd5337e9f14180f2955b454b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/twilio.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.twilio import TwilioAPIWrapper
+
+__all__ = ["TwilioAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/vertexai.py b/llm/Lib/site-packages/langchain/utilities/vertexai.py
new file mode 100644
index 0000000000000000000000000000000000000000..c9397d1b599049dbaed49fef88bdeab959ee8712
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/vertexai.py
@@ -0,0 +1,13 @@
+from langchain_community.utilities.vertexai import (
+    create_retry_decorator,
+    get_client_info,
+    init_vertexai,
+    raise_vertex_import_error,
+)
+
+__all__ = [
+    "create_retry_decorator",
+    "raise_vertex_import_error",
+    "init_vertexai",
+    "get_client_info",
+]
diff --git a/llm/Lib/site-packages/langchain/utilities/wikipedia.py b/llm/Lib/site-packages/langchain/utilities/wikipedia.py
new file mode 100644
index 0000000000000000000000000000000000000000..ec9a773423f0dc8d653f13f9359ab74a9efffbad
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/wikipedia.py
@@ -0,0 +1,5 @@
+from langchain_community.utilities.wikipedia import (
+    WikipediaAPIWrapper,
+)
+
+__all__ = ["WikipediaAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/wolfram_alpha.py b/llm/Lib/site-packages/langchain/utilities/wolfram_alpha.py
new file mode 100644
index 0000000000000000000000000000000000000000..ef785464686011e7c113faaf1cbba93138e1cafd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/wolfram_alpha.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.wolfram_alpha import WolframAlphaAPIWrapper
+
+__all__ = ["WolframAlphaAPIWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utilities/zapier.py b/llm/Lib/site-packages/langchain/utilities/zapier.py
new file mode 100644
index 0000000000000000000000000000000000000000..ebbd501e902d0dcdd642581d6a76de244c109b84
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utilities/zapier.py
@@ -0,0 +1,3 @@
+from langchain_community.utilities.zapier import ZapierNLAWrapper
+
+__all__ = ["ZapierNLAWrapper"]
diff --git a/llm/Lib/site-packages/langchain/utils/__init__.py b/llm/Lib/site-packages/langchain/utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4a571ed3d358ed417de1fe0f34f305cc4e6f18e1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/__init__.py
@@ -0,0 +1,49 @@
+"""
+**Utility functions** for LangChain.
+
+These functions do not depend on any other LangChain module.
+"""
+
+from langchain_core.utils.formatting import StrictFormatter, formatter
+from langchain_core.utils.input import (
+    get_bolded_text,
+    get_color_mapping,
+    get_colored_text,
+    print_text,
+)
+from langchain_core.utils.utils import (
+    check_package_version,
+    convert_to_secret_str,
+    get_pydantic_field_names,
+    guard_import,
+    mock_now,
+    raise_for_status_with_text,
+    xor_args,
+)
+
+from langchain.utils.env import get_from_dict_or_env, get_from_env
+from langchain.utils.math import cosine_similarity, cosine_similarity_top_k
+from langchain.utils.strings import comma_list, stringify_dict, stringify_value
+
+__all__ = [
+    "StrictFormatter",
+    "check_package_version",
+    "comma_list",
+    "convert_to_secret_str",
+    "cosine_similarity",
+    "cosine_similarity_top_k",
+    "formatter",
+    "get_bolded_text",
+    "get_color_mapping",
+    "get_colored_text",
+    "get_from_dict_or_env",
+    "get_from_env",
+    "get_pydantic_field_names",
+    "guard_import",
+    "mock_now",
+    "print_text",
+    "raise_for_status_with_text",
+    "stringify_dict",
+    "stringify_value",
+    "xor_args",
+]
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c45111e6f0fff43cb81ecf085bb6ccd8d2d6dfeb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/aiter.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/aiter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..019a097e37057406538742d9076b3200544120b6
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/aiter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/env.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/env.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2e1b66d63985de641cb463ee079d2b33a2cebfdc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/env.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/ernie_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/ernie_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f541f96da55a016c2c2438b073e583ba2c6d3a9a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/ernie_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/formatting.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/formatting.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5df29ab2818e72b848eeabc523acaceeca4e4b97
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/formatting.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/html.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/html.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..51b658287a43cf642d97c44851652c09dfcfbc4d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/html.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/input.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/input.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5b790bf002b80fe81b936cb452525db2ee0f74e1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/input.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/interactive_env.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/interactive_env.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c4c93ac2df13081cfad3fd7c808fd85145db9083
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/interactive_env.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/iter.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/iter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..30f6f6622d9fef961d2c70dcf957b91f202328f3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/iter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/json_schema.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/json_schema.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3c055974a39830bcc01941542b3ef76fa2854bad
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/json_schema.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/loading.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/loading.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..01ae689244b38e5b24ec0d87862db95ea224f130
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/loading.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/math.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/math.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2d82aa320a41cbbb9fd8f9c57b5ed4af55d6452e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/math.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/openai.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d33e545c18327cf15c07049e8a52f282d83d7a31
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/openai_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/openai_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aa054a568a9eb605f793f788b4eefe2880ffb794
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/openai_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/pydantic.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/pydantic.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..579cbc7f525c0bdeae3ede053eb755a8f0687675
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/pydantic.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/strings.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/strings.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bae7eafca67776d5ad661bb2de5f3c3acc999fbf
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/strings.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain/utils/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..268e717d627e707547d231e23f383ca0fed7004b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/utils/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/utils/aiter.py b/llm/Lib/site-packages/langchain/utils/aiter.py
new file mode 100644
index 0000000000000000000000000000000000000000..cab956b5d070c7a3860178af75af27104fcd011c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/aiter.py
@@ -0,0 +1,3 @@
+from langchain_core.utils.aiter import NoLock, Tee, py_anext
+
+__all__ = ["py_anext", "NoLock", "Tee"]
diff --git a/llm/Lib/site-packages/langchain/utils/env.py b/llm/Lib/site-packages/langchain/utils/env.py
new file mode 100644
index 0000000000000000000000000000000000000000..b1e212d22e0c412f36ed0d39715a81db6d411679
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/env.py
@@ -0,0 +1,3 @@
+from langchain_core.utils.env import get_from_dict_or_env, get_from_env
+
+__all__ = ["get_from_dict_or_env", "get_from_env"]
diff --git a/llm/Lib/site-packages/langchain/utils/ernie_functions.py b/llm/Lib/site-packages/langchain/utils/ernie_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..e71152a5bf55de813374edfdec181846c41a6f03
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/ernie_functions.py
@@ -0,0 +1,13 @@
+from langchain_community.utils.ernie_functions import (
+    FunctionDescription,
+    ToolDescription,
+    convert_pydantic_to_ernie_function,
+    convert_pydantic_to_ernie_tool,
+)
+
+__all__ = [
+    "FunctionDescription",
+    "ToolDescription",
+    "convert_pydantic_to_ernie_function",
+    "convert_pydantic_to_ernie_tool",
+]
diff --git a/llm/Lib/site-packages/langchain/utils/formatting.py b/llm/Lib/site-packages/langchain/utils/formatting.py
new file mode 100644
index 0000000000000000000000000000000000000000..212bff83613ba90cde0fc4da150a9e0b394dea42
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/formatting.py
@@ -0,0 +1,3 @@
+from langchain_core.utils.formatting import StrictFormatter
+
+__all__ = ["StrictFormatter"]
diff --git a/llm/Lib/site-packages/langchain/utils/html.py b/llm/Lib/site-packages/langchain/utils/html.py
new file mode 100644
index 0000000000000000000000000000000000000000..a5684b2e07a4c749dd431cf0f40bf43608b94159
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/html.py
@@ -0,0 +1,19 @@
+from langchain_core.utils.html import (
+    DEFAULT_LINK_REGEX,
+    PREFIXES_TO_IGNORE,
+    PREFIXES_TO_IGNORE_REGEX,
+    SUFFIXES_TO_IGNORE,
+    SUFFIXES_TO_IGNORE_REGEX,
+    extract_sub_links,
+    find_all_links,
+)
+
+__all__ = [
+    "PREFIXES_TO_IGNORE",
+    "SUFFIXES_TO_IGNORE",
+    "SUFFIXES_TO_IGNORE_REGEX",
+    "PREFIXES_TO_IGNORE_REGEX",
+    "DEFAULT_LINK_REGEX",
+    "find_all_links",
+    "extract_sub_links",
+]
diff --git a/llm/Lib/site-packages/langchain/utils/input.py b/llm/Lib/site-packages/langchain/utils/input.py
new file mode 100644
index 0000000000000000000000000000000000000000..563cc506076479fbd619972b4d2dde495ebaa405
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/input.py
@@ -0,0 +1,8 @@
+from langchain_core.utils.input import (
+    get_bolded_text,
+    get_color_mapping,
+    get_colored_text,
+    print_text,
+)
+
+__all__ = ["get_color_mapping", "get_colored_text", "get_bolded_text", "print_text"]
diff --git a/llm/Lib/site-packages/langchain/utils/interactive_env.py b/llm/Lib/site-packages/langchain/utils/interactive_env.py
new file mode 100644
index 0000000000000000000000000000000000000000..7752b6b403cc1df30c5803891f53c94512e5e704
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/interactive_env.py
@@ -0,0 +1,5 @@
+def is_interactive_env() -> bool:
+    """Determine if running within IPython or Jupyter."""
+    import sys
+
+    return hasattr(sys, "ps2")
diff --git a/llm/Lib/site-packages/langchain/utils/iter.py b/llm/Lib/site-packages/langchain/utils/iter.py
new file mode 100644
index 0000000000000000000000000000000000000000..a4059721241e14aa6fdb7450fc692587041ef475
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/iter.py
@@ -0,0 +1,3 @@
+from langchain_core.utils.iter import NoLock, Tee, batch_iterate, tee_peer
+
+__all__ = ["NoLock", "tee_peer", "Tee", "batch_iterate"]
diff --git a/llm/Lib/site-packages/langchain/utils/json_schema.py b/llm/Lib/site-packages/langchain/utils/json_schema.py
new file mode 100644
index 0000000000000000000000000000000000000000..0e61b7bee9e2681a2b6e45230404f13d90ea0ffd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/json_schema.py
@@ -0,0 +1,13 @@
+from langchain_core.utils.json_schema import (
+    _dereference_refs_helper,
+    _infer_skip_keys,
+    _retrieve_ref,
+    dereference_refs,
+)
+
+__all__ = [
+    "_retrieve_ref",
+    "_dereference_refs_helper",
+    "_infer_skip_keys",
+    "dereference_refs",
+]
diff --git a/llm/Lib/site-packages/langchain/utils/loading.py b/llm/Lib/site-packages/langchain/utils/loading.py
new file mode 100644
index 0000000000000000000000000000000000000000..b048d383eeb4b0e91b7ca9724f23fcaef2261617
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/loading.py
@@ -0,0 +1,3 @@
+from langchain_core.utils.loading import try_load_from_hub
+
+__all__ = ["try_load_from_hub"]
diff --git a/llm/Lib/site-packages/langchain/utils/math.py b/llm/Lib/site-packages/langchain/utils/math.py
new file mode 100644
index 0000000000000000000000000000000000000000..1cbc56b3ae3a883199156bcbbfe024d17e4edb3c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/math.py
@@ -0,0 +1,7 @@
+from langchain_community.utils.math import (
+    Matrix,
+    cosine_similarity,
+    cosine_similarity_top_k,
+)
+
+__all__ = ["Matrix", "cosine_similarity", "cosine_similarity_top_k"]
diff --git a/llm/Lib/site-packages/langchain/utils/openai.py b/llm/Lib/site-packages/langchain/utils/openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..dfc00bd8ebc7a639a6fb0e176727cd2a48158f4e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/openai.py
@@ -0,0 +1,3 @@
+from langchain_community.utils.openai import is_openai_v1
+
+__all__ = ["is_openai_v1"]
diff --git a/llm/Lib/site-packages/langchain/utils/openai_functions.py b/llm/Lib/site-packages/langchain/utils/openai_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..7b67ccc55d34284f3b5056f432121c393ec04f48
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/openai_functions.py
@@ -0,0 +1,13 @@
+from langchain_community.utils.openai_functions import (
+    FunctionDescription,
+    ToolDescription,
+    convert_pydantic_to_openai_function,
+    convert_pydantic_to_openai_tool,
+)
+
+__all__ = [
+    "FunctionDescription",
+    "ToolDescription",
+    "convert_pydantic_to_openai_function",
+    "convert_pydantic_to_openai_tool",
+]
diff --git a/llm/Lib/site-packages/langchain/utils/pydantic.py b/llm/Lib/site-packages/langchain/utils/pydantic.py
new file mode 100644
index 0000000000000000000000000000000000000000..a5000f231e84d4de41604a21074a653f380e6f59
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/pydantic.py
@@ -0,0 +1,3 @@
+from langchain_core.utils.pydantic import get_pydantic_major_version
+
+__all__ = ["get_pydantic_major_version"]
diff --git a/llm/Lib/site-packages/langchain/utils/strings.py b/llm/Lib/site-packages/langchain/utils/strings.py
new file mode 100644
index 0000000000000000000000000000000000000000..f8e88564213ac059176606e32f74642b9059a9fa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/strings.py
@@ -0,0 +1,3 @@
+from langchain_core.utils.strings import comma_list, stringify_dict, stringify_value
+
+__all__ = ["stringify_value", "stringify_dict", "comma_list"]
diff --git a/llm/Lib/site-packages/langchain/utils/utils.py b/llm/Lib/site-packages/langchain/utils/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..5762943316489a3c198f6a4262ad490ed5e3c6a6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/utils/utils.py
@@ -0,0 +1,21 @@
+from langchain_core.utils.utils import (
+    build_extra_kwargs,
+    check_package_version,
+    convert_to_secret_str,
+    get_pydantic_field_names,
+    guard_import,
+    mock_now,
+    raise_for_status_with_text,
+    xor_args,
+)
+
+__all__ = [
+    "xor_args",
+    "raise_for_status_with_text",
+    "mock_now",
+    "guard_import",
+    "check_package_version",
+    "get_pydantic_field_names",
+    "build_extra_kwargs",
+    "convert_to_secret_str",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__init__.py b/llm/Lib/site-packages/langchain/vectorstores/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..359949dac12dfa0d66a73f014852df5b19567545
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/__init__.py
@@ -0,0 +1,116 @@
+"""**Vector store** stores embedded data and performs vector search.
+
+One of the most common ways to store and search over unstructured data is to
+embed it and store the resulting embedding vectors, and then query the store
+and retrieve the data that are 'most similar' to the embedded query.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    VectorStore --> <name>  # Examples: Annoy, FAISS, Milvus
+
+    BaseRetriever --> VectorStoreRetriever --> <name>Retriever  # Example: VespaRetriever
+
+**Main helpers:**
+
+.. code-block::
+
+    Embeddings, Document
+"""  # noqa: E501
+import warnings
+from typing import Any
+
+from langchain_core._api import LangChainDeprecationWarning
+from langchain_core.vectorstores import VectorStore
+
+from langchain.utils.interactive_env import is_interactive_env
+
+
+def __getattr__(name: str) -> Any:
+    from langchain_community import vectorstores
+
+    # If not in interactive env, raise warning.
+    if not is_interactive_env():
+        warnings.warn(
+            "Importing vector stores from langchain is deprecated. Importing from "
+            "langchain will no longer be supported as of langchain==0.2.0. "
+            "Please import from langchain-community instead:\n\n"
+            f"`from langchain_community.vectorstores import {name}`.\n\n"
+            "To install langchain-community run `pip install -U langchain-community`.",
+            category=LangChainDeprecationWarning,
+        )
+
+    return getattr(vectorstores, name)
+
+
+__all__ = [
+    "AlibabaCloudOpenSearch",
+    "AlibabaCloudOpenSearchSettings",
+    "AnalyticDB",
+    "Annoy",
+    "AtlasDB",
+    "AwaDB",
+    "AzureSearch",
+    "Bagel",
+    "Cassandra",
+    "AstraDB",
+    "Chroma",
+    "Clarifai",
+    "Clickhouse",
+    "ClickhouseSettings",
+    "DashVector",
+    "DatabricksVectorSearch",
+    "DeepLake",
+    "Dingo",
+    "DocArrayHnswSearch",
+    "DocArrayInMemorySearch",
+    "ElasticKnnSearch",
+    "ElasticVectorSearch",
+    "ElasticsearchStore",
+    "Epsilla",
+    "FAISS",
+    "Hologres",
+    "LanceDB",
+    "LLMRails",
+    "Marqo",
+    "MatchingEngine",
+    "Meilisearch",
+    "Milvus",
+    "MomentoVectorIndex",
+    "MongoDBAtlasVectorSearch",
+    "MyScale",
+    "MyScaleSettings",
+    "Neo4jVector",
+    "OpenSearchVectorSearch",
+    "PGEmbedding",
+    "PGVector",
+    "Pinecone",
+    "Qdrant",
+    "Redis",
+    "Rockset",
+    "SKLearnVectorStore",
+    "ScaNN",
+    "SemaDB",
+    "SingleStoreDB",
+    "SQLiteVSS",
+    "StarRocks",
+    "SupabaseVectorStore",
+    "Tair",
+    "TileDB",
+    "Tigris",
+    "TimescaleVector",
+    "Typesense",
+    "USearch",
+    "Vald",
+    "Vearch",
+    "Vectara",
+    "VespaStore",
+    "Weaviate",
+    "Yellowbrick",
+    "ZepVectorStore",
+    "Zilliz",
+    "TencentVectorDB",
+    "AzureCosmosDBVectorSearch",
+    "VectorStore",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e4349328e2d9a19b2bc888e3b3d32443f5c6442a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/alibabacloud_opensearch.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/alibabacloud_opensearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..18977a7fd8c653affde91af5c7fdb19ea3cad6e8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/alibabacloud_opensearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/analyticdb.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/analyticdb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7873b404372c29f0124e66522756b94edac12332
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/analyticdb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/annoy.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/annoy.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a262d3e71c9ddb4e3dbab9fadefc5350568491fc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/annoy.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/astradb.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/astradb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..73696ac7fd9745b634cbd395cdc500b4977d47d8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/astradb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/atlas.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/atlas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e142ccf712ab157faa30231ba9ea4b7f0476b28b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/atlas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/awadb.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/awadb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9599397567edbe79f531451ad92c6d2f34953a40
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/awadb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/azure_cosmos_db.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/azure_cosmos_db.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b305404dc3f027a1b2ec977a86af792f607f8d6d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/azure_cosmos_db.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/azuresearch.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/azuresearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3760500ee55e08d6db8510fee4dc91e505802850
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/azuresearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/bageldb.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/bageldb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..09c25f536cf4c7e1bb050eada1fe4a8593ab95f4
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/bageldb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/baiducloud_vector_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/baiducloud_vector_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a23d6068451f5758075cf8a0b7a83fa4c5a8585a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/baiducloud_vector_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..96c83af54959ac3f8e9611df76e3548243be2d56
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/cassandra.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/cassandra.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a3e0470b0f343219f4da33c1f7e2150ea5f5931e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/cassandra.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/chroma.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/chroma.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8640a38a8a1d64b84b01aad9fe36f0cdcb1b6706
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/chroma.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/clarifai.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/clarifai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d4bc4374f58ad7c6a80a46a1610b3c8e090e2d5e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/clarifai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/clickhouse.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/clickhouse.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fda89d05b65ef32bc501d4943854599e4ea938f1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/clickhouse.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/dashvector.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/dashvector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..be0e964b291b82712f10d8b4c9d853f7c5528a2f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/dashvector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/databricks_vector_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/databricks_vector_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..165a0237aa8711c47caa4a60e74ebd5ea9347421
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/databricks_vector_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/deeplake.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/deeplake.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7fdff229f70d2b11052d18837662d55340ab29ad
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/deeplake.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/dingo.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/dingo.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d5fca7bb800e0b8ae8681b1f6f9ba2214439e1cd
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/dingo.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/elastic_vector_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/elastic_vector_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b0e9da3933e0d44f8d29ad0e58ced75a7df2c5df
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/elastic_vector_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/elasticsearch.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/elasticsearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..39d603981e05f2389e887b461eee023002066f98
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/elasticsearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/epsilla.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/epsilla.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..52a2c36bf692166690ed3291531492507ddbd362
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/epsilla.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/faiss.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/faiss.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a13edc96e4acc2e54bb9f5497c36ca4fbc1dd156
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/faiss.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/hippo.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/hippo.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..909b495c9e0ac5d4896c3b2bddf4fcb15a383f34
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/hippo.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/hologres.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/hologres.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..05b2212f2a0ebb47efb511aea86ed8490c5c30fe
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/hologres.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/lancedb.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/lancedb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..66022bd3539b305150fed48df7b8d2f95abbabff
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/lancedb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/llm_rails.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/llm_rails.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a89a235579428bb8acffbbf0fa07fa59f228d4c5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/llm_rails.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/marqo.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/marqo.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1129ebff128b6240090f827fc2e65b07f1085c06
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/marqo.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/matching_engine.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/matching_engine.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..80d00769f3ade34c79e5177aee1203f8d05f087f
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/matching_engine.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/meilisearch.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/meilisearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3d2717c86bdec44b3ff65f487a830f3269d9844a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/meilisearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/milvus.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/milvus.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8cb61d83b173a378443ab6c1ef854fa1ceafcafb
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/milvus.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/momento_vector_index.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/momento_vector_index.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..69e9f3e2bf0ba1ddb8a48d75584471c626e2e33c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/momento_vector_index.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/mongodb_atlas.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/mongodb_atlas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fd0004948defeb3f47b4474937ba66a8173b8374
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/mongodb_atlas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/myscale.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/myscale.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..200b25dd6f2864eb1b92460284945c1519399afc
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/myscale.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/neo4j_vector.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/neo4j_vector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0c7fba118d041065786907b9fd032289c9be8856
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/neo4j_vector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/nucliadb.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/nucliadb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a3511e2554c40e25fed83956f709072457f41a98
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/nucliadb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/opensearch_vector_search.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/opensearch_vector_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2cd242901a8e34a9f9678e176d77ad728cf761b1
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/opensearch_vector_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/pgembedding.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/pgembedding.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..675267ec66cb27b4e7d36c8928b0b424649c6f58
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/pgembedding.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/pgvecto_rs.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/pgvecto_rs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6dd3d5f52b349d1804b1f60e88a7bf7e9b5ea806
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/pgvecto_rs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/pgvector.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/pgvector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8d26bd48cfcffba2fdff63e8dd0eacde7b6e433a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/pgvector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/pinecone.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/pinecone.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..098a18999a49dffbcfa980caa1489cc3ab4db206
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/pinecone.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/qdrant.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/qdrant.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..100ce7d7206249ceba1bc3b8ecd375b5bfa83cec
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/qdrant.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/rocksetdb.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/rocksetdb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..56e9fc430e90db3556f8f51f58707796b389d8b5
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/rocksetdb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/scann.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/scann.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f45a92898590f328400a609bb11c795d59df35aa
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/scann.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/semadb.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/semadb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8a7c91a88389f991e5d5e3a471fdfcdf1a9c1c2c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/semadb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/singlestoredb.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/singlestoredb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a47809eb2c04a2e456b70a8a8581a5e4bcf7184a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/singlestoredb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/sklearn.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/sklearn.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..12c373075bdebb6c4fa84078c9e3a74f9125b84c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/sklearn.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/sqlitevss.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/sqlitevss.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2e3b5f2eaf318424709ef0dbb34b65765245ca2d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/sqlitevss.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/starrocks.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/starrocks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ade1acafbbb5acf32c408539524c96f3a6bc68f8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/starrocks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/supabase.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/supabase.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..39d9225051eb7dde783599e08f4a0e7231045b32
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/supabase.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/tair.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/tair.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a05a7b8863c32921599dec0722b86f5fe3883c0b
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/tair.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/tencentvectordb.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/tencentvectordb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f851a64e5f0c1023f0531fe9ef11b784239acf15
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/tencentvectordb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/tigris.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/tigris.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b032a422498042385ebd9be1f347a395a11c1be0
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/tigris.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/tiledb.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/tiledb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..261493f64e4b5c1585c46463d9023795f0357d5c
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/tiledb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/timescalevector.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/timescalevector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..95fa1a022f65a60385de49287b9d0f005dedcf50
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/timescalevector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/typesense.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/typesense.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d6fa706e1de8fd58901716b1203bfc98fd7db434
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/typesense.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/usearch.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/usearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ef94df1bb0c9ad224de32a826cfd33103122408e
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/usearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ec2fb056be1951ccf8a238f315c232f85243b521
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/vald.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/vald.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1ec776587506bb3f04e259bbcaee078164f9e07a
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/vald.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/vearch.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/vearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4ba307c162c213f07fd066c40b27bfa6d1edd066
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/vearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/vectara.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/vectara.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4e53d5d89743cf05db9f357333066f707cf58784
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/vectara.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/vespa.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/vespa.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..be674d084140f5bbffb2755477998a230fcf0c60
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/vespa.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/weaviate.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/weaviate.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..17417a5071791d584eb70251adbf313a284ee9d8
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/weaviate.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/xata.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/xata.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8b5060bcfbbae7aaaa2fdebabe942cf700b3dc47
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/xata.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/yellowbrick.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/yellowbrick.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..86c4bfc4de178e323d5d727430ad7ffaeffd95ce
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/yellowbrick.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/zep.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/zep.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a4f3789d9f5a8b3383bc25b55b82f8e2bb3d90d3
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/zep.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/__pycache__/zilliz.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/zilliz.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..34d82ba0b83bebd19b27ea76a2599c7d2d605029
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/__pycache__/zilliz.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/alibabacloud_opensearch.py b/llm/Lib/site-packages/langchain/vectorstores/alibabacloud_opensearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..a6907518890093416c9b5ab518ef9c0276d8db07
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/alibabacloud_opensearch.py
@@ -0,0 +1,9 @@
+from langchain_community.vectorstores.alibabacloud_opensearch import (
+    AlibabaCloudOpenSearch,
+    AlibabaCloudOpenSearchSettings,
+)
+
+__all__ = [
+    "AlibabaCloudOpenSearchSettings",
+    "AlibabaCloudOpenSearch",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/analyticdb.py b/llm/Lib/site-packages/langchain/vectorstores/analyticdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..0161cbd17d76909937f269eaff7d280e3ff89f78
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/analyticdb.py
@@ -0,0 +1,7 @@
+from langchain_community.vectorstores.analyticdb import (
+    AnalyticDB,
+)
+
+__all__ = [
+    "AnalyticDB",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/annoy.py b/llm/Lib/site-packages/langchain/vectorstores/annoy.py
new file mode 100644
index 0000000000000000000000000000000000000000..05ac5db68844670064c244739f9a2f0fd5be0f8c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/annoy.py
@@ -0,0 +1,5 @@
+from langchain_community.vectorstores.annoy import (
+    Annoy,
+)
+
+__all__ = ["Annoy"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/astradb.py b/llm/Lib/site-packages/langchain/vectorstores/astradb.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba96ca313d19cdbe3f42923d35869c3648d1aa88
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/astradb.py
@@ -0,0 +1,7 @@
+from langchain_community.vectorstores.astradb import (
+    AstraDB,
+)
+
+__all__ = [
+    "AstraDB",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/atlas.py b/llm/Lib/site-packages/langchain/vectorstores/atlas.py
new file mode 100644
index 0000000000000000000000000000000000000000..87aa7e4542331bab6dcf2a5762ff88fde671534c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/atlas.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.atlas import AtlasDB
+
+__all__ = ["AtlasDB"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/awadb.py b/llm/Lib/site-packages/langchain/vectorstores/awadb.py
new file mode 100644
index 0000000000000000000000000000000000000000..dbc545bf3c65ca0dfb3e4c80c02e0f42eafd1f2c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/awadb.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.awadb import AwaDB
+
+__all__ = ["AwaDB"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/azure_cosmos_db.py b/llm/Lib/site-packages/langchain/vectorstores/azure_cosmos_db.py
new file mode 100644
index 0000000000000000000000000000000000000000..e8ce5694c6c73902452698d6e0def1c37fc69e00
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/azure_cosmos_db.py
@@ -0,0 +1,11 @@
+from langchain_community.vectorstores.azure_cosmos_db import (
+    AzureCosmosDBVectorSearch,
+    CosmosDBDocumentType,
+    CosmosDBSimilarityType,
+)
+
+__all__ = [
+    "CosmosDBSimilarityType",
+    "CosmosDBDocumentType",
+    "AzureCosmosDBVectorSearch",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/azuresearch.py b/llm/Lib/site-packages/langchain/vectorstores/azuresearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..4eeac434d1103aaf7f6952af24991e1a53dccf95
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/azuresearch.py
@@ -0,0 +1,9 @@
+from langchain_community.vectorstores.azuresearch import (
+    AzureSearch,
+    AzureSearchVectorStoreRetriever,
+)
+
+__all__ = [
+    "AzureSearch",
+    "AzureSearchVectorStoreRetriever",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/bageldb.py b/llm/Lib/site-packages/langchain/vectorstores/bageldb.py
new file mode 100644
index 0000000000000000000000000000000000000000..eaa0e73395d37b1fb9fd1d3f10f8097c73e5bf49
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/bageldb.py
@@ -0,0 +1,5 @@
+from langchain_community.vectorstores.bageldb import (
+    Bagel,
+)
+
+__all__ = ["Bagel"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/baiducloud_vector_search.py b/llm/Lib/site-packages/langchain/vectorstores/baiducloud_vector_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..e4c667aad232e2d8f1f77aabdf1cce1df134fc9f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/baiducloud_vector_search.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.baiducloud_vector_search import BESVectorStore
+
+__all__ = ["BESVectorStore"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/base.py b/llm/Lib/site-packages/langchain/vectorstores/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..59a719b541eea9f7c0a5ee112fb5db400fe120d0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/base.py
@@ -0,0 +1,3 @@
+from langchain_core.vectorstores import VectorStore, VectorStoreRetriever
+
+__all__ = ["VectorStore", "VectorStoreRetriever"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/cassandra.py b/llm/Lib/site-packages/langchain/vectorstores/cassandra.py
new file mode 100644
index 0000000000000000000000000000000000000000..7f1d5e1745215d6d953effdb79bc9d74046cec03
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/cassandra.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.cassandra import CVST, Cassandra
+
+__all__ = ["CVST", "Cassandra"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/chroma.py b/llm/Lib/site-packages/langchain/vectorstores/chroma.py
new file mode 100644
index 0000000000000000000000000000000000000000..66989a13ba5786e507c48c55e0dab4718af5baf3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/chroma.py
@@ -0,0 +1,5 @@
+from langchain_community.vectorstores.chroma import (
+    Chroma,
+)
+
+__all__ = ["Chroma"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/clarifai.py b/llm/Lib/site-packages/langchain/vectorstores/clarifai.py
new file mode 100644
index 0000000000000000000000000000000000000000..51f8be3a7343dae806e7fb7289307ce73b327723
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/clarifai.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.clarifai import Clarifai
+
+__all__ = ["Clarifai"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/clickhouse.py b/llm/Lib/site-packages/langchain/vectorstores/clickhouse.py
new file mode 100644
index 0000000000000000000000000000000000000000..36f571e9d001d6089facf11cbd705599ee3abe00
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/clickhouse.py
@@ -0,0 +1,6 @@
+from langchain_community.vectorstores.clickhouse import (
+    Clickhouse,
+    ClickhouseSettings,
+)
+
+__all__ = ["ClickhouseSettings", "Clickhouse"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/dashvector.py b/llm/Lib/site-packages/langchain/vectorstores/dashvector.py
new file mode 100644
index 0000000000000000000000000000000000000000..be2f5f376e216175d12e142f805534387116508c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/dashvector.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.dashvector import DashVector
+
+__all__ = ["DashVector"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/databricks_vector_search.py b/llm/Lib/site-packages/langchain/vectorstores/databricks_vector_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d971bcfab12c5135e5cf64b99f6cee685b562d9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/databricks_vector_search.py
@@ -0,0 +1,5 @@
+from langchain_community.vectorstores.databricks_vector_search import (
+    DatabricksVectorSearch,
+)
+
+__all__ = ["DatabricksVectorSearch"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/deeplake.py b/llm/Lib/site-packages/langchain/vectorstores/deeplake.py
new file mode 100644
index 0000000000000000000000000000000000000000..6f9e17d79dd3c98fb87acf30b59e2ae5817eeb9a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/deeplake.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.deeplake import DeepLake
+
+__all__ = ["DeepLake"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/dingo.py b/llm/Lib/site-packages/langchain/vectorstores/dingo.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d33a640883642e319f305ab7b2378002d486f44
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/dingo.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.dingo import Dingo
+
+__all__ = ["Dingo"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/docarray/__init__.py b/llm/Lib/site-packages/langchain/vectorstores/docarray/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b5877fec88ba1a878b64a54bb58d03b901c2f9dd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/docarray/__init__.py
@@ -0,0 +1,7 @@
+from langchain_community.vectorstores.docarray.hnsw import DocArrayHnswSearch
+from langchain_community.vectorstores.docarray.in_memory import DocArrayInMemorySearch
+
+__all__ = [
+    "DocArrayHnswSearch",
+    "DocArrayInMemorySearch",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/docarray/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/docarray/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bc23ae9aefcdea752567d7ff3955250b58d1d1ae
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/docarray/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/docarray/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/docarray/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cf2694f353318792607f707506afbc20faabeb83
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/docarray/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/docarray/__pycache__/hnsw.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/docarray/__pycache__/hnsw.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ff6e0878a24996e03e48aa00931a817b783ed924
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/docarray/__pycache__/hnsw.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/docarray/__pycache__/in_memory.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/docarray/__pycache__/in_memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3a310ca2075f10c253caab0214cd941a2772af85
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/docarray/__pycache__/in_memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/docarray/base.py b/llm/Lib/site-packages/langchain/vectorstores/docarray/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..53a31289ceda98ce7db314044ee254b44ffbd042
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/docarray/base.py
@@ -0,0 +1,5 @@
+from langchain_community.vectorstores.docarray.base import (
+    DocArrayIndex,
+)
+
+__all__ = ["DocArrayIndex"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/docarray/hnsw.py b/llm/Lib/site-packages/langchain/vectorstores/docarray/hnsw.py
new file mode 100644
index 0000000000000000000000000000000000000000..552b770f1db9d8fc6ecf2c94354271a24094591b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/docarray/hnsw.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.docarray.hnsw import DocArrayHnswSearch
+
+__all__ = ["DocArrayHnswSearch"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/docarray/in_memory.py b/llm/Lib/site-packages/langchain/vectorstores/docarray/in_memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..45ef3929c05b64329afc157bdae3a9b986c1d65a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/docarray/in_memory.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.docarray.in_memory import DocArrayInMemorySearch
+
+__all__ = ["DocArrayInMemorySearch"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/elastic_vector_search.py b/llm/Lib/site-packages/langchain/vectorstores/elastic_vector_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..282417dc57c4093aae1d1efa918881cded49b751
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/elastic_vector_search.py
@@ -0,0 +1,9 @@
+from langchain_community.vectorstores.elastic_vector_search import (
+    ElasticKnnSearch,
+    ElasticVectorSearch,
+)
+
+__all__ = [
+    "ElasticVectorSearch",
+    "ElasticKnnSearch",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/elasticsearch.py b/llm/Lib/site-packages/langchain/vectorstores/elasticsearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..eb603ee972a5d29d1544e79d6d271e5062b2e955
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/elasticsearch.py
@@ -0,0 +1,15 @@
+from langchain_community.vectorstores.elasticsearch import (
+    ApproxRetrievalStrategy,
+    BaseRetrievalStrategy,
+    ElasticsearchStore,
+    ExactRetrievalStrategy,
+    SparseRetrievalStrategy,
+)
+
+__all__ = [
+    "BaseRetrievalStrategy",
+    "ApproxRetrievalStrategy",
+    "ExactRetrievalStrategy",
+    "SparseRetrievalStrategy",
+    "ElasticsearchStore",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/epsilla.py b/llm/Lib/site-packages/langchain/vectorstores/epsilla.py
new file mode 100644
index 0000000000000000000000000000000000000000..e0f65ebec0aa6075ef4669104d623a618aec9a59
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/epsilla.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.epsilla import Epsilla
+
+__all__ = ["Epsilla"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/faiss.py b/llm/Lib/site-packages/langchain/vectorstores/faiss.py
new file mode 100644
index 0000000000000000000000000000000000000000..23e89cfe4cb4b6d67e39ba545de84721e7489a51
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/faiss.py
@@ -0,0 +1,5 @@
+from langchain_community.vectorstores.faiss import (
+    FAISS,
+)
+
+__all__ = ["FAISS"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/hippo.py b/llm/Lib/site-packages/langchain/vectorstores/hippo.py
new file mode 100644
index 0000000000000000000000000000000000000000..daaf711a4e435a2c14c1324db1bf95a00c605f60
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/hippo.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.hippo import Hippo
+
+__all__ = ["Hippo"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/hologres.py b/llm/Lib/site-packages/langchain/vectorstores/hologres.py
new file mode 100644
index 0000000000000000000000000000000000000000..cf01c05b54bfe9debf0b71653969f51f0a32495e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/hologres.py
@@ -0,0 +1,5 @@
+from langchain_community.vectorstores.hologres import (
+    Hologres,
+)
+
+__all__ = ["Hologres"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/lancedb.py b/llm/Lib/site-packages/langchain/vectorstores/lancedb.py
new file mode 100644
index 0000000000000000000000000000000000000000..06e012dd4b95a62d5ab7134ba60812c407d1a545
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/lancedb.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.lancedb import LanceDB
+
+__all__ = ["LanceDB"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/llm_rails.py b/llm/Lib/site-packages/langchain/vectorstores/llm_rails.py
new file mode 100644
index 0000000000000000000000000000000000000000..dda357f7a65de757753da30ad5df981d682c343e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/llm_rails.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.llm_rails import LLMRails, LLMRailsRetriever
+
+__all__ = ["LLMRails", "LLMRailsRetriever"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/marqo.py b/llm/Lib/site-packages/langchain/vectorstores/marqo.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd529c05b2f3f0038ece8384104689f9270accf2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/marqo.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.marqo import Marqo
+
+__all__ = ["Marqo"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/matching_engine.py b/llm/Lib/site-packages/langchain/vectorstores/matching_engine.py
new file mode 100644
index 0000000000000000000000000000000000000000..04c5e28bef4973d63f912d95a8732b38713de0e3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/matching_engine.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.matching_engine import MatchingEngine
+
+__all__ = ["MatchingEngine"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/meilisearch.py b/llm/Lib/site-packages/langchain/vectorstores/meilisearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..2d025557bfee205b4489e65f06866947aecc4404
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/meilisearch.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.meilisearch import Meilisearch
+
+__all__ = ["Meilisearch"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/milvus.py b/llm/Lib/site-packages/langchain/vectorstores/milvus.py
new file mode 100644
index 0000000000000000000000000000000000000000..74475f240f66fc51229ea25caca13e0f42a8056a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/milvus.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.milvus import Milvus
+
+__all__ = ["Milvus"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/momento_vector_index.py b/llm/Lib/site-packages/langchain/vectorstores/momento_vector_index.py
new file mode 100644
index 0000000000000000000000000000000000000000..24be7b3d834ac318ee9c66d26d534bcf7b29bd5a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/momento_vector_index.py
@@ -0,0 +1,5 @@
+from langchain_community.vectorstores.momento_vector_index import (
+    MomentoVectorIndex,
+)
+
+__all__ = ["MomentoVectorIndex"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/mongodb_atlas.py b/llm/Lib/site-packages/langchain/vectorstores/mongodb_atlas.py
new file mode 100644
index 0000000000000000000000000000000000000000..94502b140a1556603340056f907321d3c991742b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/mongodb_atlas.py
@@ -0,0 +1,9 @@
+from langchain_community.vectorstores.mongodb_atlas import (
+    MongoDBAtlasVectorSearch,
+    MongoDBDocumentType,
+)
+
+__all__ = [
+    "MongoDBDocumentType",
+    "MongoDBAtlasVectorSearch",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/myscale.py b/llm/Lib/site-packages/langchain/vectorstores/myscale.py
new file mode 100644
index 0000000000000000000000000000000000000000..453bd434b821a4127c7d3a4efa656e0be3e830b4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/myscale.py
@@ -0,0 +1,7 @@
+from langchain_community.vectorstores.myscale import (
+    MyScale,
+    MyScaleSettings,
+    MyScaleWithoutJSON,
+)
+
+__all__ = ["MyScaleSettings", "MyScale", "MyScaleWithoutJSON"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/neo4j_vector.py b/llm/Lib/site-packages/langchain/vectorstores/neo4j_vector.py
new file mode 100644
index 0000000000000000000000000000000000000000..6cc49c4f9fc54f49c89c3e2bfeed2184495bd90f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/neo4j_vector.py
@@ -0,0 +1,9 @@
+from langchain_community.vectorstores.neo4j_vector import (
+    Neo4jVector,
+    SearchType,
+)
+
+__all__ = [
+    "SearchType",
+    "Neo4jVector",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/nucliadb.py b/llm/Lib/site-packages/langchain/vectorstores/nucliadb.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ce7ccedb2d789e67ec19cd04286dbad0d7e8900
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/nucliadb.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.nucliadb import NucliaDB
+
+__all__ = ["NucliaDB"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/opensearch_vector_search.py b/llm/Lib/site-packages/langchain/vectorstores/opensearch_vector_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..3e662e1581a456ded5ebffebbc3cb55908cca780
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/opensearch_vector_search.py
@@ -0,0 +1,7 @@
+from langchain_community.vectorstores.opensearch_vector_search import (
+    OpenSearchVectorSearch,
+)
+
+__all__ = [
+    "OpenSearchVectorSearch",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/pgembedding.py b/llm/Lib/site-packages/langchain/vectorstores/pgembedding.py
new file mode 100644
index 0000000000000000000000000000000000000000..43ec191d0f989fef10e844a1004fa4880883722a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/pgembedding.py
@@ -0,0 +1,13 @@
+from langchain_community.vectorstores.pgembedding import (
+    CollectionStore,
+    EmbeddingStore,
+    PGEmbedding,
+    QueryResult,
+)
+
+__all__ = [
+    "CollectionStore",
+    "EmbeddingStore",
+    "QueryResult",
+    "PGEmbedding",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/pgvecto_rs.py b/llm/Lib/site-packages/langchain/vectorstores/pgvecto_rs.py
new file mode 100644
index 0000000000000000000000000000000000000000..2841b18adcccb5fa86a642a76b16b682b1530327
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/pgvecto_rs.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.pgvecto_rs import PGVecto_rs
+
+__all__ = ["PGVecto_rs"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/pgvector.py b/llm/Lib/site-packages/langchain/vectorstores/pgvector.py
new file mode 100644
index 0000000000000000000000000000000000000000..8347bec77e69def6bde54a7bbfb5db67b74f683c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/pgvector.py
@@ -0,0 +1,9 @@
+from langchain_community.vectorstores.pgvector import (
+    DistanceStrategy,
+    PGVector,
+)
+
+__all__ = [
+    "DistanceStrategy",
+    "PGVector",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/pinecone.py b/llm/Lib/site-packages/langchain/vectorstores/pinecone.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9768f01ae1613022d089b45905dbbba8878c7b3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/pinecone.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.pinecone import Pinecone
+
+__all__ = ["Pinecone"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/qdrant.py b/llm/Lib/site-packages/langchain/vectorstores/qdrant.py
new file mode 100644
index 0000000000000000000000000000000000000000..afce9eb55387de07d2d242a206189105db8d4976
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/qdrant.py
@@ -0,0 +1,6 @@
+from langchain_community.vectorstores.qdrant import (
+    Qdrant,
+    QdrantException,
+)
+
+__all__ = ["QdrantException", "Qdrant"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/redis/__init__.py b/llm/Lib/site-packages/langchain/vectorstores/redis/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc088facf4ff974e904cc9869b65a13aaa086c0f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/redis/__init__.py
@@ -0,0 +1,16 @@
+from .base import Redis, RedisVectorStoreRetriever
+from .filters import (
+    RedisFilter,
+    RedisNum,
+    RedisTag,
+    RedisText,
+)
+
+__all__ = [
+    "Redis",
+    "RedisFilter",
+    "RedisTag",
+    "RedisText",
+    "RedisNum",
+    "RedisVectorStoreRetriever",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/redis/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/redis/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ddd9b508016940217493ec8aca4390041fb053ba
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/redis/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/redis/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/redis/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..122136bc13321b1132ba0ff97c85c3d57ef318b2
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/redis/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/redis/__pycache__/filters.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/redis/__pycache__/filters.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5e128185ef96e8c0be1d6544a1ce47a85128be5d
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/redis/__pycache__/filters.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/redis/__pycache__/schema.cpython-311.pyc b/llm/Lib/site-packages/langchain/vectorstores/redis/__pycache__/schema.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5759dc52f4f626d8a0b854fcb9e9f89794eeb6e7
Binary files /dev/null and b/llm/Lib/site-packages/langchain/vectorstores/redis/__pycache__/schema.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain/vectorstores/redis/base.py b/llm/Lib/site-packages/langchain/vectorstores/redis/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..55d8991170acdc15b5a5a463e074f5993034c869
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/redis/base.py
@@ -0,0 +1,11 @@
+from langchain_community.vectorstores.redis.base import (
+    Redis,
+    RedisVectorStoreRetriever,
+    check_index_exists,
+)
+
+__all__ = [
+    "check_index_exists",
+    "Redis",
+    "RedisVectorStoreRetriever",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/redis/filters.py b/llm/Lib/site-packages/langchain/vectorstores/redis/filters.py
new file mode 100644
index 0000000000000000000000000000000000000000..2711b94dcd5cad69ab4220665057f2dd3265302f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/redis/filters.py
@@ -0,0 +1,21 @@
+from langchain_community.vectorstores.redis.filters import (
+    RedisFilter,
+    RedisFilterExpression,
+    RedisFilterField,
+    RedisFilterOperator,
+    RedisNum,
+    RedisTag,
+    RedisText,
+    check_operator_misuse,
+)
+
+__all__ = [
+    "RedisFilterOperator",
+    "RedisFilter",
+    "RedisFilterField",
+    "check_operator_misuse",
+    "RedisTag",
+    "RedisNum",
+    "RedisText",
+    "RedisFilterExpression",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/redis/schema.py b/llm/Lib/site-packages/langchain/vectorstores/redis/schema.py
new file mode 100644
index 0000000000000000000000000000000000000000..cda61a63ee9f95b5cc5956b44c4c691785b70be9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/redis/schema.py
@@ -0,0 +1,25 @@
+from langchain_community.vectorstores.redis.schema import (
+    FlatVectorField,
+    HNSWVectorField,
+    NumericFieldSchema,
+    RedisDistanceMetric,
+    RedisField,
+    RedisModel,
+    RedisVectorField,
+    TagFieldSchema,
+    TextFieldSchema,
+    read_schema,
+)
+
+__all__ = [
+    "RedisDistanceMetric",
+    "RedisField",
+    "TextFieldSchema",
+    "TagFieldSchema",
+    "NumericFieldSchema",
+    "RedisVectorField",
+    "FlatVectorField",
+    "HNSWVectorField",
+    "RedisModel",
+    "read_schema",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/rocksetdb.py b/llm/Lib/site-packages/langchain/vectorstores/rocksetdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..c1c0b3aee7615b99d6604d98feb4710224e37610
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/rocksetdb.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.rocksetdb import Rockset
+
+__all__ = ["Rockset"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/scann.py b/llm/Lib/site-packages/langchain/vectorstores/scann.py
new file mode 100644
index 0000000000000000000000000000000000000000..4f3bf9d3d95cf52f46d1d86ffe65e691d70f5783
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/scann.py
@@ -0,0 +1,5 @@
+from langchain_community.vectorstores.scann import (
+    ScaNN,
+)
+
+__all__ = ["ScaNN"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/semadb.py b/llm/Lib/site-packages/langchain/vectorstores/semadb.py
new file mode 100644
index 0000000000000000000000000000000000000000..ac0af2ec94577165aab6d4c6ba28695e263ef637
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/semadb.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.semadb import SemaDB
+
+__all__ = ["SemaDB"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/singlestoredb.py b/llm/Lib/site-packages/langchain/vectorstores/singlestoredb.py
new file mode 100644
index 0000000000000000000000000000000000000000..2e2cf02ef40f9f4c4ded0ed46bcf8de7b1f0237f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/singlestoredb.py
@@ -0,0 +1,6 @@
+from langchain_community.vectorstores.singlestoredb import (
+    SingleStoreDB,
+    SingleStoreDBRetriever,
+)
+
+__all__ = ["SingleStoreDB", "SingleStoreDBRetriever"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/sklearn.py b/llm/Lib/site-packages/langchain/vectorstores/sklearn.py
new file mode 100644
index 0000000000000000000000000000000000000000..f27fde312f8b8ded24b7b54f0238bc130be04a64
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/sklearn.py
@@ -0,0 +1,17 @@
+from langchain_community.vectorstores.sklearn import (
+    BaseSerializer,
+    BsonSerializer,
+    JsonSerializer,
+    ParquetSerializer,
+    SKLearnVectorStore,
+    SKLearnVectorStoreException,
+)
+
+__all__ = [
+    "BaseSerializer",
+    "JsonSerializer",
+    "BsonSerializer",
+    "ParquetSerializer",
+    "SKLearnVectorStoreException",
+    "SKLearnVectorStore",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/sqlitevss.py b/llm/Lib/site-packages/langchain/vectorstores/sqlitevss.py
new file mode 100644
index 0000000000000000000000000000000000000000..89657b87ffe179c55b377f2e2079af88669dbb82
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/sqlitevss.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.sqlitevss import SQLiteVSS
+
+__all__ = ["SQLiteVSS"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/starrocks.py b/llm/Lib/site-packages/langchain/vectorstores/starrocks.py
new file mode 100644
index 0000000000000000000000000000000000000000..2bca05abc100531a5afb4c5adf383e0ed01eea31
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/starrocks.py
@@ -0,0 +1,9 @@
+from langchain_community.vectorstores.starrocks import (
+    StarRocks,
+    StarRocksSettings,
+)
+
+__all__ = [
+    "StarRocksSettings",
+    "StarRocks",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/supabase.py b/llm/Lib/site-packages/langchain/vectorstores/supabase.py
new file mode 100644
index 0000000000000000000000000000000000000000..f9b4d3c208b02ff06ee9041517b55c99ed8e999e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/supabase.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.supabase import SupabaseVectorStore
+
+__all__ = ["SupabaseVectorStore"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/tair.py b/llm/Lib/site-packages/langchain/vectorstores/tair.py
new file mode 100644
index 0000000000000000000000000000000000000000..03a0662df06bdc122ced4ee94f52b69f500035ad
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/tair.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.tair import Tair
+
+__all__ = ["Tair"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/tencentvectordb.py b/llm/Lib/site-packages/langchain/vectorstores/tencentvectordb.py
new file mode 100644
index 0000000000000000000000000000000000000000..63ea71e3df48c5c74a3dc1a59b3ee74cec977231
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/tencentvectordb.py
@@ -0,0 +1,7 @@
+from langchain_community.vectorstores.tencentvectordb import (
+    ConnectionParams,
+    IndexParams,
+    TencentVectorDB,
+)
+
+__all__ = ["ConnectionParams", "IndexParams", "TencentVectorDB"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/tigris.py b/llm/Lib/site-packages/langchain/vectorstores/tigris.py
new file mode 100644
index 0000000000000000000000000000000000000000..af9de359ef87d8b11283b11bd9b333ce21f91aa7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/tigris.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.tigris import Tigris
+
+__all__ = ["Tigris"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/tiledb.py b/llm/Lib/site-packages/langchain/vectorstores/tiledb.py
new file mode 100644
index 0000000000000000000000000000000000000000..83b463f7867d9e66f2553a973356458e29e1abb4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/tiledb.py
@@ -0,0 +1,7 @@
+from langchain_community.vectorstores.tiledb import (
+    TileDB,
+)
+
+__all__ = [
+    "TileDB",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/timescalevector.py b/llm/Lib/site-packages/langchain/vectorstores/timescalevector.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f89ee2ca18358a4fa5df66c07255addd7496ed5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/timescalevector.py
@@ -0,0 +1,7 @@
+from langchain_community.vectorstores.timescalevector import (
+    TimescaleVector,
+)
+
+__all__ = [
+    "TimescaleVector",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/typesense.py b/llm/Lib/site-packages/langchain/vectorstores/typesense.py
new file mode 100644
index 0000000000000000000000000000000000000000..70ea2948338deb03b6207fd0d77c80a8d82e2d9d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/typesense.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.typesense import Typesense
+
+__all__ = ["Typesense"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/usearch.py b/llm/Lib/site-packages/langchain/vectorstores/usearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..dbc75f4baccac09e44a070337a1a56c2b2383afa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/usearch.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.usearch import USearch
+
+__all__ = ["USearch"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/utils.py b/llm/Lib/site-packages/langchain/vectorstores/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..11c7f88f997b338c1f6f1e3022ccb69910396fbe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/utils.py
@@ -0,0 +1,7 @@
+from langchain_community.vectorstores.utils import (
+    DistanceStrategy,
+    filter_complex_metadata,
+    maximal_marginal_relevance,
+)
+
+__all__ = ["DistanceStrategy", "maximal_marginal_relevance", "filter_complex_metadata"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/vald.py b/llm/Lib/site-packages/langchain/vectorstores/vald.py
new file mode 100644
index 0000000000000000000000000000000000000000..8d8fea96349ef3d5f95d96a5f6172ac6e6b86945
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/vald.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.vald import Vald
+
+__all__ = ["Vald"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/vearch.py b/llm/Lib/site-packages/langchain/vectorstores/vearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..b87e017e50ee65ce9a38bdae9d9efe39a8b0ff79
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/vearch.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.vearch import Vearch
+
+__all__ = ["Vearch"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/vectara.py b/llm/Lib/site-packages/langchain/vectorstores/vectara.py
new file mode 100644
index 0000000000000000000000000000000000000000..f5548044eda62d6011e70e4a930aabdd6c9bcc02
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/vectara.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.vectara import Vectara, VectaraRetriever
+
+__all__ = ["Vectara", "VectaraRetriever"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/vespa.py b/llm/Lib/site-packages/langchain/vectorstores/vespa.py
new file mode 100644
index 0000000000000000000000000000000000000000..ea12ffa7204d475de4aa02fb48d7c5095f847c05
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/vespa.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.vespa import VespaStore
+
+__all__ = ["VespaStore"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/weaviate.py b/llm/Lib/site-packages/langchain/vectorstores/weaviate.py
new file mode 100644
index 0000000000000000000000000000000000000000..efea32d9228e075284f3f8779150865cfb165c5e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/weaviate.py
@@ -0,0 +1,7 @@
+from langchain_community.vectorstores.weaviate import (
+    Weaviate,
+)
+
+__all__ = [
+    "Weaviate",
+]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/xata.py b/llm/Lib/site-packages/langchain/vectorstores/xata.py
new file mode 100644
index 0000000000000000000000000000000000000000..bde35af83ebde53f94facc544134b60b0b915396
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/xata.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.xata import XataVectorStore
+
+__all__ = ["XataVectorStore"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/yellowbrick.py b/llm/Lib/site-packages/langchain/vectorstores/yellowbrick.py
new file mode 100644
index 0000000000000000000000000000000000000000..1279aac21bf4313cb9dc0bf29da5ce903a42c3a4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/yellowbrick.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.yellowbrick import Yellowbrick
+
+__all__ = ["Yellowbrick"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/zep.py b/llm/Lib/site-packages/langchain/vectorstores/zep.py
new file mode 100644
index 0000000000000000000000000000000000000000..7273fe24bcebd09c15e3e56595fd34cb795d1436
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/zep.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.zep import CollectionConfig, ZepVectorStore
+
+__all__ = ["CollectionConfig", "ZepVectorStore"]
diff --git a/llm/Lib/site-packages/langchain/vectorstores/zilliz.py b/llm/Lib/site-packages/langchain/vectorstores/zilliz.py
new file mode 100644
index 0000000000000000000000000000000000000000..40c2d2deb63318df9a18977b83ec3d8044478fea
--- /dev/null
+++ b/llm/Lib/site-packages/langchain/vectorstores/zilliz.py
@@ -0,0 +1,3 @@
+from langchain_community.vectorstores.zilliz import Zilliz
+
+__all__ = ["Zilliz"]
diff --git a/llm/Lib/site-packages/langchain_community-0.0.34.dist-info/INSTALLER b/llm/Lib/site-packages/langchain_community-0.0.34.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community-0.0.34.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/langchain_community-0.0.34.dist-info/METADATA b/llm/Lib/site-packages/langchain_community-0.0.34.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..4cf4a7c320a8c8be7673d64c4c1b10056046f278
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community-0.0.34.dist-info/METADATA
@@ -0,0 +1,139 @@
+Metadata-Version: 2.1
+Name: langchain-community
+Version: 0.0.34
+Summary: Community contributed LangChain integrations.
+Home-page: https://github.com/langchain-ai/langchain
+License: MIT
+Requires-Python: >=3.8.1,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Provides-Extra: cli
+Provides-Extra: extended-testing
+Requires-Dist: PyYAML (>=5.3)
+Requires-Dist: SQLAlchemy (>=1.4,<3)
+Requires-Dist: aiohttp (>=3.8.3,<4.0.0)
+Requires-Dist: aiosqlite (>=0.19.0,<0.20.0) ; extra == "extended-testing"
+Requires-Dist: aleph-alpha-client (>=2.15.0,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: anthropic (>=0.3.11,<0.4.0) ; extra == "extended-testing"
+Requires-Dist: arxiv (>=1.4,<2.0) ; extra == "extended-testing"
+Requires-Dist: assemblyai (>=0.17.0,<0.18.0) ; extra == "extended-testing"
+Requires-Dist: atlassian-python-api (>=3.36.0,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: azure-ai-documentintelligence (>=1.0.0b1,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: beautifulsoup4 (>=4,<5) ; extra == "extended-testing"
+Requires-Dist: bibtexparser (>=1.4.0,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: cassio (>=0.1.0,<0.2.0) ; extra == "extended-testing"
+Requires-Dist: chardet (>=5.1.0,<6.0.0) ; extra == "extended-testing"
+Requires-Dist: cloudpickle (>=2.0.0) ; extra == "extended-testing" or extra == "extended-testing"
+Requires-Dist: cohere (>=4,<5) ; extra == "extended-testing"
+Requires-Dist: databricks-vectorsearch (>=0.21,<0.22) ; extra == "extended-testing"
+Requires-Dist: dataclasses-json (>=0.5.7,<0.7)
+Requires-Dist: datasets (>=2.15.0,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: dgml-utils (>=0.3.0,<0.4.0) ; extra == "extended-testing"
+Requires-Dist: elasticsearch (>=8.12.0,<9.0.0) ; extra == "extended-testing"
+Requires-Dist: esprima (>=4.0.1,<5.0.0) ; extra == "extended-testing"
+Requires-Dist: faiss-cpu (>=1,<2) ; extra == "extended-testing"
+Requires-Dist: feedparser (>=6.0.10,<7.0.0) ; extra == "extended-testing"
+Requires-Dist: fireworks-ai (>=0.9.0,<0.10.0) ; extra == "extended-testing"
+Requires-Dist: friendli-client (>=1.2.4,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: geopandas (>=0.13.1,<0.14.0) ; extra == "extended-testing"
+Requires-Dist: gitpython (>=3.1.32,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: google-cloud-documentai (>=2.20.1,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: gql (>=3.4.1,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: gradientai (>=1.4.0,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: hdbcli (>=2.19.21,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: hologres-vector (>=0.0.6,<0.0.7) ; extra == "extended-testing"
+Requires-Dist: html2text (>=2020.1.16,<2021.0.0) ; extra == "extended-testing"
+Requires-Dist: httpx (>=0.24.1,<0.25.0) ; extra == "extended-testing"
+Requires-Dist: httpx-sse (>=0.4.0,<0.5.0) ; extra == "extended-testing"
+Requires-Dist: javelin-sdk (>=0.1.8,<0.2.0) ; extra == "extended-testing"
+Requires-Dist: jinja2 (>=3,<4) ; extra == "extended-testing"
+Requires-Dist: jq (>=1.4.1,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: jsonschema (>1) ; extra == "extended-testing"
+Requires-Dist: langchain-core (>=0.1.45,<0.2.0)
+Requires-Dist: langsmith (>=0.1.0,<0.2.0)
+Requires-Dist: lxml (>=4.9.3,<6.0) ; extra == "extended-testing"
+Requires-Dist: markdownify (>=0.11.6,<0.12.0) ; extra == "extended-testing"
+Requires-Dist: motor (>=3.3.1,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: msal (>=1.25.0,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: mwparserfromhell (>=0.6.4,<0.7.0) ; extra == "extended-testing"
+Requires-Dist: mwxml (>=0.3.3,<0.4.0) ; extra == "extended-testing"
+Requires-Dist: newspaper3k (>=0.2.8,<0.3.0) ; extra == "extended-testing"
+Requires-Dist: numexpr (>=2.8.6,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: numpy (>=1,<2)
+Requires-Dist: nvidia-riva-client (>=2.14.0,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: oci (>=2.119.1,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: openai (<2) ; extra == "extended-testing"
+Requires-Dist: openapi-pydantic (>=0.3.2,<0.4.0) ; extra == "extended-testing"
+Requires-Dist: oracle-ads (>=2.9.1,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: pandas (>=2.0.1,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: pdfminer-six (>=20221105,<20221106) ; extra == "extended-testing"
+Requires-Dist: pgvector (>=0.1.6,<0.2.0) ; extra == "extended-testing"
+Requires-Dist: praw (>=7.7.1,<8.0.0) ; extra == "extended-testing"
+Requires-Dist: premai (>=0.3.25,<0.4.0) ; extra == "extended-testing"
+Requires-Dist: psychicapi (>=0.8.0,<0.9.0) ; extra == "extended-testing"
+Requires-Dist: py-trello (>=0.19.0,<0.20.0) ; extra == "extended-testing"
+Requires-Dist: pyjwt (>=2.8.0,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: pymupdf (>=1.22.3,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: pypdf (>=3.4.0,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: pypdfium2 (>=4.10.0,<5.0.0) ; extra == "extended-testing"
+Requires-Dist: pyspark (>=3.4.0,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: rank-bm25 (>=0.2.2,<0.3.0) ; extra == "extended-testing"
+Requires-Dist: rapidfuzz (>=3.1.1,<4.0.0) ; extra == "extended-testing"
+Requires-Dist: rapidocr-onnxruntime (>=1.3.2,<2.0.0) ; (python_full_version >= "3.8.1" and python_version < "3.12") and (extra == "extended-testing")
+Requires-Dist: rdflib (==7.0.0) ; extra == "extended-testing"
+Requires-Dist: requests (>=2,<3)
+Requires-Dist: requests-toolbelt (>=1.0.0,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: rspace_client (>=2.5.0,<3.0.0) ; extra == "extended-testing"
+Requires-Dist: scikit-learn (>=1.2.2,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: sqlite-vss (>=0.1.2,<0.2.0) ; extra == "extended-testing"
+Requires-Dist: streamlit (>=1.18.0,<2.0.0) ; (python_full_version >= "3.8.1" and python_full_version != "3.9.7" and python_version < "4.0") and (extra == "extended-testing")
+Requires-Dist: sympy (>=1.12,<2.0) ; extra == "extended-testing"
+Requires-Dist: telethon (>=1.28.5,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: tenacity (>=8.1.0,<9.0.0)
+Requires-Dist: tidb-vector (>=0.0.3,<1.0.0) ; extra == "extended-testing"
+Requires-Dist: timescale-vector (>=0.0.1,<0.0.2) ; extra == "extended-testing"
+Requires-Dist: tqdm (>=4.48.0) ; extra == "extended-testing"
+Requires-Dist: tree-sitter (>=0.20.2,<0.21.0) ; extra == "extended-testing"
+Requires-Dist: tree-sitter-languages (>=1.8.0,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: typer (>=0.9.0,<0.10.0) ; extra == "cli"
+Requires-Dist: upstash-redis (>=0.15.0,<0.16.0) ; extra == "extended-testing"
+Requires-Dist: vdms (>=0.0.20,<0.0.21) ; extra == "extended-testing"
+Requires-Dist: xata (>=1.0.0a7,<2.0.0) ; extra == "extended-testing"
+Requires-Dist: xmltodict (>=0.13.0,<0.14.0) ; extra == "extended-testing"
+Project-URL: Repository, https://github.com/langchain-ai/langchain
+Description-Content-Type: text/markdown
+
+# 🦜️🧑‍🤝‍🧑 LangChain Community
+
+[![Downloads](https://static.pepy.tech/badge/langchain_community/month)](https://pepy.tech/project/langchain_community)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Quick Install
+
+```bash
+pip install langchain-community
+```
+
+## What is it?
+
+LangChain Community contains third-party integrations that implement the base interfaces defined in LangChain Core, making them ready-to-use in any LangChain application.
+
+For full documentation see the [API reference](https://api.python.langchain.com/en/stable/community_api_reference.html).
+
+![Diagram outlining the hierarchical organization of the LangChain framework, displaying the interconnected parts across multiple layers.](../../docs/static/img/langchain_stack.png "LangChain Framework Overview")
+
+## 📕 Releases & Versioning
+
+`langchain-community` is currently on version `0.0.x`
+
+All changes will be accompanied by a patch version increase.
+
+## 💁 Contributing
+
+As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
+
+For detailed information on how to contribute, see the [Contributing Guide](https://python.langchain.com/docs/contributing/).
diff --git a/llm/Lib/site-packages/langchain_community-0.0.34.dist-info/RECORD b/llm/Lib/site-packages/langchain_community-0.0.34.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..39f3dce3c67f2c83f22a748de569c72bcf6fdd26
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community-0.0.34.dist-info/RECORD
@@ -0,0 +1,2114 @@
+langchain_community-0.0.34.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+langchain_community-0.0.34.dist-info/METADATA,sha256=Xmu9TNvSlzFIxopF7ToKPptjPZ0QLhcXlXljf_EvpSk,8512
+langchain_community-0.0.34.dist-info/RECORD,,
+langchain_community-0.0.34.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+langchain_community/__init__.py,sha256=_PQ4n1_W2mnjN2U8Rq0IIwIDcsMGiIwvQLK6w72HEQE,307
+langchain_community/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/__pycache__/cache.cpython-311.pyc,,
+langchain_community/adapters/__init__.py,sha256=-R6nHD5gjBsGkWsN3YYq8KD-t3_B4a6AlajW08BIgzw,336
+langchain_community/adapters/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/adapters/__pycache__/openai.cpython-311.pyc,,
+langchain_community/adapters/openai.py,sha256=5S6nxeOPrLzOWe6KuDZ7zg58hhbQQKHA-mGQqRslQoA,12269
+langchain_community/agent_toolkits/__init__.py,sha256=qReLqy2pj2B8bif9EbmAFajFyrIJYmsCJSlPLv-aBiA,6770
+langchain_community/agent_toolkits/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/__pycache__/azure_ai_services.cpython-311.pyc,,
+langchain_community/agent_toolkits/__pycache__/azure_cognitive_services.cpython-311.pyc,,
+langchain_community/agent_toolkits/__pycache__/base.cpython-311.pyc,,
+langchain_community/agent_toolkits/ainetwork/__init__.py,sha256=henfKntuAEjG1KoN-Hk1IHy3fFGCYPWLEuZtF2bIdZI,25
+langchain_community/agent_toolkits/ainetwork/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/ainetwork/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/ainetwork/toolkit.py,sha256=2LYFkjPS9-j7VKVNQ9kPgJPZUykZ6A_068JhzhbiFIE,1781
+langchain_community/agent_toolkits/amadeus/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_community/agent_toolkits/amadeus/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/amadeus/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/amadeus/toolkit.py,sha256=SvLUOdBEm3L52uOg4GORb-RlXPQGFW2H51dUxwz-x5g,1103
+langchain_community/agent_toolkits/azure_ai_services.py,sha256=v9O4LQ0KZF4BUQTObZaeg-P1UkO_wQWiKUMrSNDMS_g,927
+langchain_community/agent_toolkits/azure_cognitive_services.py,sha256=jyBlJpKyUXreWzMtCeVVYEOOlWGdICfCrojFm3MrlEM,1035
+langchain_community/agent_toolkits/base.py,sha256=m9ff0GoW39n0cHwUvid3q7vjEV2HqTa5IjEITtfD9es,397
+langchain_community/agent_toolkits/clickup/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_community/agent_toolkits/clickup/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/clickup/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/clickup/toolkit.py,sha256=FqZ-ZWD7ju6KIPToRmIc-yWFNWzJgyGnKbxmkAWms_M,3594
+langchain_community/agent_toolkits/cogniswitch/__init__.py,sha256=ecSDIo4zTVOMcOkRfj29tI79F-a-e9bMco9A9S2K9S8,26
+langchain_community/agent_toolkits/cogniswitch/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/cogniswitch/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/cogniswitch/toolkit.py,sha256=DklfuIHQBrAPzXKK09p_BOoyi5ikKnr2O056ivJW0x4,1340
+langchain_community/agent_toolkits/connery/__init__.py,sha256=PQ_pr_sw9X0etlSMcIyN35HG8f4j0egiHpygDeIwSBo,116
+langchain_community/agent_toolkits/connery/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/connery/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/connery/toolkit.py,sha256=902zK9jV-J2hruKs5R3Xf6BhVAiu99SAOOP5WEzHEng,1418
+langchain_community/agent_toolkits/csv/__init__.py,sha256=nxqqnFzM48gemXmWUZc7mWjuwdiDRzF215ftoGU6qro,1091
+langchain_community/agent_toolkits/csv/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/file_management/__init__.py,sha256=kfHhPFslutoeZEeLXecxpBFmVPvaDleY4mQCwau4pJ4,177
+langchain_community/agent_toolkits/file_management/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/file_management/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/file_management/toolkit.py,sha256=4cXM2KrIsEVY2J_8ZbcpdoUvaTvgpdPPT_qJGspq00M,3189
+langchain_community/agent_toolkits/github/__init__.py,sha256=FBxQxsk8O9n4TXCZXHQW_-011pdVK3_3dN-yeLGPQjE,22
+langchain_community/agent_toolkits/github/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/github/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/github/toolkit.py,sha256=1Lsvd0D9GI4X5SNvQzKLH5nqtGdAnmUspfAHG_XGJ1U,10135
+langchain_community/agent_toolkits/gitlab/__init__.py,sha256=x1DYZ-uaP3BvHsoZs21RxdktQ9292mYBP-tR3tG0h3U,22
+langchain_community/agent_toolkits/gitlab/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/gitlab/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/gitlab/toolkit.py,sha256=FekOqMpGftIUYDgSiVNnnhs0qgSPnLY6GTuW-Ijz_Bw,2904
+langchain_community/agent_toolkits/gmail/__init__.py,sha256=0Y2P1d5UFysfWDxwUmb98JLCYNHoQBs1GnxynWGSRz8,21
+langchain_community/agent_toolkits/gmail/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/gmail/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/gmail/toolkit.py,sha256=f5Vc7vDew5nOM6HOcsmZpo5RntLOcoGRAKdRFfjcNHw,2045
+langchain_community/agent_toolkits/jira/__init__.py,sha256=g7l8EPCXUddP-_AiO9huERcC_x2kD-dfroYmUe8O8I0,20
+langchain_community/agent_toolkits/jira/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/jira/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/jira/toolkit.py,sha256=01YHt3mzHYm_74inOPRaNwKcRpSevCohvf1T_r-5ivw,2227
+langchain_community/agent_toolkits/json/__init__.py,sha256=T7Z9zw9_awf5-r0kExvry2aybzxEnpDb5SyLOpBC2d0,18
+langchain_community/agent_toolkits/json/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/json/__pycache__/base.cpython-311.pyc,,
+langchain_community/agent_toolkits/json/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/agent_toolkits/json/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/json/base.py,sha256=LlYFPJ7TK57UB4N13Cw5_LMZCn70t-5ARNN5UIReEes,1894
+langchain_community/agent_toolkits/json/prompt.py,sha256=NS0r8BfnTkdlJpudJOxHRPh618F84L5Sf_LcgpIf53Y,1819
+langchain_community/agent_toolkits/json/toolkit.py,sha256=zlmF91kIlce89I6Omyi2ZJmEQV4iyReGlxxgvcbmWMM,595
+langchain_community/agent_toolkits/multion/__init__.py,sha256=hc75Ek8tmBDf4f34RGwQ447AzE5qHR-HZACB7Di3YAA,23
+langchain_community/agent_toolkits/multion/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/multion/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/multion/toolkit.py,sha256=Ogvgipm2_mirlzjR3KKfSBY_K1IV39HwWF7dx6MtWYQ,1190
+langchain_community/agent_toolkits/nasa/__init__.py,sha256=_g1obC4mS4XeMYhkcNw32uIe7mGPChqhOYMj170Pjp0,19
+langchain_community/agent_toolkits/nasa/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/nasa/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/nasa/toolkit.py,sha256=gW8OVNhDE_EghBInO10xfy5zTaaViP7ifLF-JNnhGns,1931
+langchain_community/agent_toolkits/nla/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_community/agent_toolkits/nla/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/nla/__pycache__/tool.cpython-311.pyc,,
+langchain_community/agent_toolkits/nla/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/nla/tool.py,sha256=aYcx8I2v8pVbywW_ihHMs4tCq3fCFRUMET2z32xMi7s,2038
+langchain_community/agent_toolkits/nla/toolkit.py,sha256=aYpTMGe8PUe5Lj5knaAkOkPNpfszJxQU9hottQfNmCs,4228
+langchain_community/agent_toolkits/office365/__init__.py,sha256=wdPaHFsDOXYsITlWPe2RtHIxFRP2CdbQHIOG1GeEcLs,25
+langchain_community/agent_toolkits/office365/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/office365/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/office365/toolkit.py,sha256=Ms8NHFXO6zzRKZosdOGl9pSozTVpsmFkVtNygiVp2Kk,1812
+langchain_community/agent_toolkits/openapi/__init__.py,sha256=b7ELUVFz_v756WQLXBUtR1mbaXGrKr3tdAroWCsWGm4,26
+langchain_community/agent_toolkits/openapi/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/openapi/__pycache__/base.cpython-311.pyc,,
+langchain_community/agent_toolkits/openapi/__pycache__/planner.cpython-311.pyc,,
+langchain_community/agent_toolkits/openapi/__pycache__/planner_prompt.cpython-311.pyc,,
+langchain_community/agent_toolkits/openapi/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/agent_toolkits/openapi/__pycache__/spec.cpython-311.pyc,,
+langchain_community/agent_toolkits/openapi/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/openapi/base.py,sha256=IxC8UIaZJKUNGrAlVfV95WkXCe0unl-5L-pmt9vtaOw,2870
+langchain_community/agent_toolkits/openapi/planner.py,sha256=saU_wf0c8Rlu3e25ji5lIoVlunX12NJkJieQuAlH5-M,13922
+langchain_community/agent_toolkits/openapi/planner_prompt.py,sha256=ifnCBM9ekD83J75VT_7s-6G7XiVlx1MQpZOE85UOhVU,11686
+langchain_community/agent_toolkits/openapi/prompt.py,sha256=RPjJhjEBLbKl07NiezJBr8dFSNVFkJBdplRa4rtB4DA,1770
+langchain_community/agent_toolkits/openapi/spec.py,sha256=pLvMOw1EpG6YKU8Fm2lAWbwG7oRMfDY0RILdqZMn_JE,2557
+langchain_community/agent_toolkits/openapi/toolkit.py,sha256=zgUEbZYPG-qCjK_FqRxEBpDjTmuKmMQo5I0iCon2N7I,4289
+langchain_community/agent_toolkits/playwright/__init__.py,sha256=wKgI0NJbvqzMETZqrApudIgaxLUe0Mn2OzW6ZASEJqw,174
+langchain_community/agent_toolkits/playwright/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/playwright/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/playwright/toolkit.py,sha256=zIz9zraFoZZObzrzGlwLPngkUD5XszVGCrYS7N8c3YY,4274
+langchain_community/agent_toolkits/polygon/__init__.py,sha256=Xe5unF5fXwGOJSQm0lQ9grdhVU5X2m_2xXZtgCIsJCA,22
+langchain_community/agent_toolkits/polygon/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/polygon/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/polygon/toolkit.py,sha256=Y_qijxYDQnb-of4Lm4YhAuA5kLbnsSNgIDdXt-EKtgk,1125
+langchain_community/agent_toolkits/powerbi/__init__.py,sha256=9KrYrWCcuVyxlBBLCke09XngnFsFodfInQSW7XVXys4,22
+langchain_community/agent_toolkits/powerbi/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/powerbi/__pycache__/base.cpython-311.pyc,,
+langchain_community/agent_toolkits/powerbi/__pycache__/chat_base.cpython-311.pyc,,
+langchain_community/agent_toolkits/powerbi/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/agent_toolkits/powerbi/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/powerbi/base.py,sha256=Y8uvrDJHc53qCsuvv-DYjLgYV_KYvv5GzbDhu988S3w,2491
+langchain_community/agent_toolkits/powerbi/chat_base.py,sha256=muXbAUrQt2LpfXaImpFdOKxYRWgOMRmRmvU2qIgsmeA,2649
+langchain_community/agent_toolkits/powerbi/prompt.py,sha256=t24fhJ3K4on8z9T0JR8MMd0lZPatiCxmBBHP0n0hB9w,2773
+langchain_community/agent_toolkits/powerbi/toolkit.py,sha256=MNpuZpygBZmObyWmNxvgQke4izqFRc-6DRHAKqYQwhI,3771
+langchain_community/agent_toolkits/slack/__init__.py,sha256=6Z7GpcJD6FwuFKdcvKJvIfhFvJiiy9I7Gc1MSEKJlcw,21
+langchain_community/agent_toolkits/slack/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/slack/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/slack/toolkit.py,sha256=kZen36UDbdSX-rZhQx2BfKwWleNr6WQvyOH6cJnLP3Y,1114
+langchain_community/agent_toolkits/spark_sql/__init__.py,sha256=3IVQbSsdtLKybKYDE0VSq-SCTNFSAJNgCzaJWnSWJbg,23
+langchain_community/agent_toolkits/spark_sql/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/spark_sql/__pycache__/base.cpython-311.pyc,,
+langchain_community/agent_toolkits/spark_sql/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/agent_toolkits/spark_sql/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/spark_sql/base.py,sha256=P7d-_N7XgSQ_f-zsF53tIv6FdB5QxQqwxtdR3KeFA4E,2355
+langchain_community/agent_toolkits/spark_sql/prompt.py,sha256=YcyzW_RymQ7_kcU-9wTPfF9Iw3DgvzVnDBF-HRGVGYg,1202
+langchain_community/agent_toolkits/spark_sql/toolkit.py,sha256=6jX7BilEgU0HwbjLnRzvvA5rsCOlFLkg4p9Gw6XUO6Y,1084
+langchain_community/agent_toolkits/sql/__init__.py,sha256=eqqu9Hd5KiY9-04X2_9acILI2bShgSqNxJFsQ7cm9Dw,17
+langchain_community/agent_toolkits/sql/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/sql/__pycache__/base.cpython-311.pyc,,
+langchain_community/agent_toolkits/sql/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/agent_toolkits/sql/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/sql/base.py,sha256=4Ul1VTrmuecBY2TORimzfjOrI-tuWci5NlBrj4s2ZHw,8872
+langchain_community/agent_toolkits/sql/prompt.py,sha256=RJ0vcjEAkqrfJxo8X9gnCzl0Sk_NekVL65OsF-3yhQo,1428
+langchain_community/agent_toolkits/sql/toolkit.py,sha256=nnjNZ9TeM31_7anGZ1pR_haP7lTalNHN_bjv-kukjBk,3002
+langchain_community/agent_toolkits/steam/__init__.py,sha256=iOMgxWCt0FTNLMNq0wScgSN_YdBBq-56VM6j0Ud8GpI,21
+langchain_community/agent_toolkits/steam/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/steam/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/steam/toolkit.py,sha256=EXsBfaacGku5OJ59dgs-471ZmRVF6gYM1jF4ZMScTgc,1465
+langchain_community/agent_toolkits/xorbits/__init__.py,sha256=LJ-yZ3UKg4vjibzbgMXocR03vcsU_7ZvU7TlScM9RlE,1095
+langchain_community/agent_toolkits/xorbits/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/zapier/__init__.py,sha256=19Hc7HG8DzQfg83qqEbYiXA5FklLoRAEOfIs9JqTjX8,22
+langchain_community/agent_toolkits/zapier/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/agent_toolkits/zapier/__pycache__/toolkit.cpython-311.pyc,,
+langchain_community/agent_toolkits/zapier/toolkit.py,sha256=Sj6TCF3gRAAWb3cp9WoeZ4k-UefudjbHAhHwIWt0o8E,1933
+langchain_community/cache.py,sha256=6_9D4Bewve6wAs5NXzEqA384dISQhnKzLCuhtwuRfXk,78529
+langchain_community/callbacks/__init__.py,sha256=EFArunQGHUNZahRKBfMFxMLljqnczeSDrTKN_HeCOI0,5957
+langchain_community/callbacks/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/aim_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/argilla_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/arize_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/arthur_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/bedrock_anthropic_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/clearml_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/comet_ml_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/confident_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/context_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/fiddler_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/flyte_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/human.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/infino_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/labelstudio_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/llmonitor_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/manager.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/mlflow_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/openai_info.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/promptlayer_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/sagemaker_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/trubrics_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/uptrain_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/utils.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/wandb_callback.cpython-311.pyc,,
+langchain_community/callbacks/__pycache__/whylabs_callback.cpython-311.pyc,,
+langchain_community/callbacks/aim_callback.py,sha256=7Y-HkwqLJNHqQWqAEgq3sQb861Zh2tmAyhK5e3psb_Q,14791
+langchain_community/callbacks/argilla_callback.py,sha256=PK6Tb8X0S1uCWggroWsBklW7TUoFn4kql86rp7YN79g,14766
+langchain_community/callbacks/arize_callback.py,sha256=B1lcVBVrYvGVXT1DtBTNgeu9DIxlWM3TyJ6LhnjXxQY,7480
+langchain_community/callbacks/arthur_callback.py,sha256=pmHgueNxRWatz4C01oVf-Pdc6av6oCQ3kCEw_3QJIBY,11242
+langchain_community/callbacks/bedrock_anthropic_callback.py,sha256=bBGsM9yvvIH5aZVzLAnMwNKr-LEM1kSXHQbcSaxwoz8,3906
+langchain_community/callbacks/clearml_callback.py,sha256=FWKKqd4ekv9b1-Kl7VhN5eTHOG7pf1Jv40nFGHgJjZw,18846
+langchain_community/callbacks/comet_ml_callback.py,sha256=u2Nm4K8tk1jWjzkcie2wHkRMFbpThvl9gk8gVRAwQNc,23206
+langchain_community/callbacks/confident_callback.py,sha256=LcZjFPdSAbyyk0Q6k4Z1G_hhwKcH6KS_dY8mmDBYxds,6382
+langchain_community/callbacks/context_callback.py,sha256=MBrbQwJk-jYxKYrZzBTKobpAGpodJgSWJ_cUbzlvdxY,6498
+langchain_community/callbacks/fiddler_callback.py,sha256=FuUF9KRPaWUYaS8Jv-wYuAhiciDhNaSCXx080bgp4oY,11641
+langchain_community/callbacks/flyte_callback.py,sha256=vWQf583PiirRM1q91VeVNVG1Txa2GOO-DQui_gTbz9M,13027
+langchain_community/callbacks/human.py,sha256=RbSomRXDMuYE-EbYWubRKbs9hZ39m_9BASJfaBS4zRU,2587
+langchain_community/callbacks/infino_callback.py,sha256=HSwTmgEL7_vHqyltyfohVU9GOu8npVtiHTUSpQh_LlU,9271
+langchain_community/callbacks/labelstudio_callback.py,sha256=V6c4isSRg1CQNZMtmwQH-elC1Flk8NL1RB92lO2XBwY,13879
+langchain_community/callbacks/llmonitor_callback.py,sha256=YuqZ1dFUYrLNDKrJnXTUvPJHDTz8AJQLiqtOGO7irJc,20555
+langchain_community/callbacks/manager.py,sha256=QqYvuplyHwiMKK1Q1IbCJ3CXCktHIut8STXqdZ73yrI,3201
+langchain_community/callbacks/mlflow_callback.py,sha256=5uFhnzKFnlnnd1WY7oFWYGe252z8DDdKYBXsOugcXkI,27639
+langchain_community/callbacks/openai_info.py,sha256=NZSqoSuuguoxJWUeCStBCI3gQo245vkKBY8IfBK-FPc,8408
+langchain_community/callbacks/promptlayer_callback.py,sha256=dwgv7bTijvezAYpO6Vtf2uqYPnCpdP1nTAExxiiLNDU,5535
+langchain_community/callbacks/sagemaker_callback.py,sha256=7n9tC-bRGEIcbdrSvAPD4kssQUvTldnwbTPt4Q9IdAg,8787
+langchain_community/callbacks/streamlit/__init__.py,sha256=0swQo328EzGKysQApexlvvefE0L2K4eI88EqcFZhjIs,3183
+langchain_community/callbacks/streamlit/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/callbacks/streamlit/__pycache__/mutable_expander.cpython-311.pyc,,
+langchain_community/callbacks/streamlit/__pycache__/streamlit_callback_handler.cpython-311.pyc,,
+langchain_community/callbacks/streamlit/mutable_expander.py,sha256=74VHeBaD2ewp9bh1-4bQ3GpXvUF4JWPdYl6Lf6bgpCc,5395
+langchain_community/callbacks/streamlit/streamlit_callback_handler.py,sha256=xiCUGJaeiS3Y-VqHjU_yRN9JOjQajFzSU9_iD1Nmjz0,15562
+langchain_community/callbacks/tracers/__init__.py,sha256=c7wGbTPPBJ7ItWitzdlIOEPDC6b1KNRfB-9oCBqpP9w,498
+langchain_community/callbacks/tracers/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/callbacks/tracers/__pycache__/comet.cpython-311.pyc,,
+langchain_community/callbacks/tracers/__pycache__/wandb.cpython-311.pyc,,
+langchain_community/callbacks/tracers/comet.py,sha256=5a2pOiFfOQuw9YSw-2Rn291C3rNSzHccrrrRrgFqEA8,4713
+langchain_community/callbacks/tracers/wandb.py,sha256=2L0jig_NwmEKcHONYd8uXCrel1XcolRvuY4sY1FuwXU,19020
+langchain_community/callbacks/trubrics_callback.py,sha256=vllJRiwUwJqKNY7-VNcvTskMrRGYINTXnRJ7TZOAQ4U,4526
+langchain_community/callbacks/uptrain_callback.py,sha256=46a8lzPl4J6hKX53PH_TMVUn9OkQuIzNgau1Mmd-eOU,14619
+langchain_community/callbacks/utils.py,sha256=yJhw36pFVvEs2oE4JiJFSgzALv8ddM7Wr1VkOuBb0n0,8505
+langchain_community/callbacks/wandb_callback.py,sha256=yeDAcZDI6H93r4hEquO1Tip3eTTtqKv1k_ybAB-785s,20589
+langchain_community/callbacks/whylabs_callback.py,sha256=8r2PE94H0klcwaAFV-Nx53cgMG4UssDlJTF5NViyY_8,8067
+langchain_community/chat_loaders/__init__.py,sha256=qU6kKTYGoFtRk7mvTUMcYMQpwAbvHU46hmXotEU2r-Y,2898
+langchain_community/chat_loaders/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/chat_loaders/__pycache__/base.cpython-311.pyc,,
+langchain_community/chat_loaders/__pycache__/facebook_messenger.cpython-311.pyc,,
+langchain_community/chat_loaders/__pycache__/gmail.cpython-311.pyc,,
+langchain_community/chat_loaders/__pycache__/imessage.cpython-311.pyc,,
+langchain_community/chat_loaders/__pycache__/langsmith.cpython-311.pyc,,
+langchain_community/chat_loaders/__pycache__/slack.cpython-311.pyc,,
+langchain_community/chat_loaders/__pycache__/telegram.cpython-311.pyc,,
+langchain_community/chat_loaders/__pycache__/utils.cpython-311.pyc,,
+langchain_community/chat_loaders/__pycache__/whatsapp.cpython-311.pyc,,
+langchain_community/chat_loaders/base.py,sha256=GGagrHKxtuzRIbeH7FVw7vx3rBuhMH-JtNEyYlOg2qM,444
+langchain_community/chat_loaders/facebook_messenger.py,sha256=3x3ZMoufqgzB_TyPoiPJsHs8Mgm49ma6dlEZQ3T4yEI,2705
+langchain_community/chat_loaders/gmail.py,sha256=cPZKQrT5IgoaCV3fGVGi-z6IevW8MTuSR8VoDuU_aAg,4224
+langchain_community/chat_loaders/imessage.py,sha256=LDl6dwwJuJ3267FJOEjKP-rKr6kW9cr0__afBwhKH9k,7910
+langchain_community/chat_loaders/langsmith.py,sha256=9OXXSSmzGBt1kW0CXNK9-aC4u79PQ7rwc-UQwW75r8w,5747
+langchain_community/chat_loaders/slack.py,sha256=SvbyBPU8J71WQ6ByjFDoAVbOb214IHq6p_Eobufgf1M,3112
+langchain_community/chat_loaders/telegram.py,sha256=NDAimatjGG4X3N_lCb5_iqc5HmKBKnPwN2BecHF5OwY,5390
+langchain_community/chat_loaders/utils.py,sha256=77GIdEstFjdRkYitIbijC2MitYx_V4h2ffnFTMHcZs0,3270
+langchain_community/chat_loaders/whatsapp.py,sha256=JSmlLsgJEWz15oI7xkwhO_PUKB02icYhj_JvQst7070,4280
+langchain_community/chat_message_histories/__init__.py,sha256=pAmzMY-FToQWV9lk2JeIdBIVaCVzZzRefhQBjQGvkpE,5971
+langchain_community/chat_message_histories/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/astradb.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/cassandra.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/cosmos_db.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/dynamodb.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/elasticsearch.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/file.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/firestore.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/in_memory.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/momento.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/mongodb.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/neo4j.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/postgres.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/redis.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/rocksetdb.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/singlestoredb.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/sql.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/streamlit.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/tidb.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/upstash_redis.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/xata.cpython-311.pyc,,
+langchain_community/chat_message_histories/__pycache__/zep.cpython-311.pyc,,
+langchain_community/chat_message_histories/astradb.py,sha256=CasurDWByASnVISOtgumGZJZNW-Vxlq9cFJ0uoa2FtA,5874
+langchain_community/chat_message_histories/cassandra.py,sha256=90N0_r_xXuOoa7UOoR1QLgJNlN5VgyZcBIMDoBpApU4,2392
+langchain_community/chat_message_histories/cosmos_db.py,sha256=Uq1yVIcfNgHF9tiM90eOTG28EquL4C77sGHlh3UvKFA,6510
+langchain_community/chat_message_histories/dynamodb.py,sha256=dy5AgS5-tuO9iVJR7x_Muk_0sRT05jUUVhvfU8GZtTM,7250
+langchain_community/chat_message_histories/elasticsearch.py,sha256=f9MPXouDaNvnDaAEhyBv6GNzDNKfaCsAcOLRuqyTAjQ,7177
+langchain_community/chat_message_histories/file.py,sha256=rQh_pY82_u9a-lIJe9OgA78t4Rmcuyc0fgdjvlG4tRk,1379
+langchain_community/chat_message_histories/firestore.py,sha256=ITScfD97ukdf4KUrS_HM5dlutHmF0tGXUPaqA6HJYBw,3349
+langchain_community/chat_message_histories/in_memory.py,sha256=MzPKwXP_a2TIwAsNqqxlre68ct8mekac7qHhsib6C0Q,940
+langchain_community/chat_message_histories/momento.py,sha256=ZF5mLaTw7bbwT5u14pgFe246YgvUvUrtRApJNr7qw9I,7112
+langchain_community/chat_message_histories/mongodb.py,sha256=QJBNJHPHhOX5nP62aJfuEuuaLbBl1R8cM9tcFrCVT9U,3107
+langchain_community/chat_message_histories/neo4j.py,sha256=Cq03T_LkiFWeyyByqJGOCyB42-Xq3LWg85mOlCh0Qco,4288
+langchain_community/chat_message_histories/postgres.py,sha256=uvJb6a1ozZFmxYSACfxiJ-eqZHWlbQ94PDT6XtBPB_g,3345
+langchain_community/chat_message_histories/redis.py,sha256=4CmLa7G_TrfOHCdj1GqlK782-39EvP9lhZu5Bv3nye0,1971
+langchain_community/chat_message_histories/rocksetdb.py,sha256=QWAcDKDnjpk9m1_WVxSHczpFHquUjjh8vOEefxmtLyc,9529
+langchain_community/chat_message_histories/singlestoredb.py,sha256=ngnQwwyXkaM8xok-ANzmzJCxeU2v85Vb7yKodmoImEc,10331
+langchain_community/chat_message_histories/sql.py,sha256=nyYJW8tin_qDirLefU-Iv82Iq4BdwWSgMXIREDXmKXo,4722
+langchain_community/chat_message_histories/streamlit.py,sha256=RC5NbXNdXY3MGRW7bBRhqE2ImGI1SLIfyoxMvC4-vJM,1444
+langchain_community/chat_message_histories/tidb.py,sha256=PbFLGSvCu_Y8MbG-6Y45la_Q86Ec4qhC2kPbsXxpYEY,5255
+langchain_community/chat_message_histories/upstash_redis.py,sha256=17-MP6XGi4wKjmD7umkCb3oKZ2Le8LiNxC7N5uAAKP4,2148
+langchain_community/chat_message_histories/xata.py,sha256=pWdOn7WxgoDgUv7LZD_57h59hJ0HazLBlLsp-HUBRuY,4652
+langchain_community/chat_message_histories/zep.py,sha256=O8NveJde9Mu6YQ3jTbIigIj0GEPa9Rgww-aoshfXFMM,8906
+langchain_community/chat_models/__init__.py,sha256=71wbgD9h_JQvbeF-XJZUuGe8TTg8hHvLgxim8AgQH9Y,9676
+langchain_community/chat_models/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/anthropic.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/anyscale.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/azure_openai.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/azureml_endpoint.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/baichuan.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/bedrock.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/cohere.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/dappier.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/databricks.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/deepinfra.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/edenai.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/ernie.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/everlyai.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/fake.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/fireworks.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/friendli.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/gigachat.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/google_palm.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/gpt_router.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/huggingface.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/human.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/hunyuan.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/javelin_ai_gateway.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/jinachat.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/kinetica.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/konko.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/litellm.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/litellm_router.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/llama_edge.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/maritalk.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/meta.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/minimax.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/mlflow.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/mlflow_ai_gateway.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/mlx.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/moonshot.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/octoai.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/ollama.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/openai.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/pai_eas_endpoint.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/perplexity.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/premai.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/promptlayer_openai.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/solar.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/sparkllm.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/tongyi.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/vertexai.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/volcengine_maas.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/yandex.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/yuan2.cpython-311.pyc,,
+langchain_community/chat_models/__pycache__/zhipuai.cpython-311.pyc,,
+langchain_community/chat_models/anthropic.py,sha256=F3xKfct2ZI1T6j78j5mwgcL3alYRbzgQm8J1Iw77OvI,8210
+langchain_community/chat_models/anyscale.py,sha256=aDF0cnXVYdMJk3jFcITIgKiKE0bjjWswMKzt62eSyts,8249
+langchain_community/chat_models/azure_openai.py,sha256=NlFbTpmu4IN-X9YEIZ4vNGTki49O-oMH4xwvGM1h1Io,11341
+langchain_community/chat_models/azureml_endpoint.py,sha256=I7UcFs2DPnlC7X15CWYIK917ePc_YI7m986-p4YbKzI,15404
+langchain_community/chat_models/baichuan.py,sha256=rmU-HdBBXpgOseEotOgd-Byut6i1hqUhui5SGmJpPWw,9878
+langchain_community/chat_models/baidu_qianfan_endpoint.py,sha256=gHX5mMJAVhtEc_I_Y9oP8zfEA9rzljQgFoF2bw5K7BI,14414
+langchain_community/chat_models/bedrock.py,sha256=mCrDK5HvF_a5uqKjM7NUD8gMOxowlyclUrjpUm4FOeg,10856
+langchain_community/chat_models/cohere.py,sha256=QC7CMxOWOHjQzCQrB75zxJLoF0B3Mg5WPYnoqS1EOjI,8226
+langchain_community/chat_models/dappier.py,sha256=lxgUX1-3JMxBzNwbnh66r_zf5aRFq_rXlDwBBWf_17U,5396
+langchain_community/chat_models/databricks.py,sha256=7trGEsxalkhAAUUjSWBtLu3o65QChNZs7X71HE2KotI,1532
+langchain_community/chat_models/deepinfra.py,sha256=aFzfPNpg8u5gbxnlnOoo3z0QDhj5ASIL3uqCawA7HOI,16671
+langchain_community/chat_models/edenai.py,sha256=lmSkNSVZr0DMa3sMix6xtmCb_J6mEXlyi2UGRb5XOBA,13134
+langchain_community/chat_models/ernie.py,sha256=8okORfEDTOhtOMLUDgjwgzeQ1SouEIv-nQjJ09Iwl9k,8039
+langchain_community/chat_models/everlyai.py,sha256=B8yzxj_GO3lMnsfaJeywIbHiHHiKY-CEUKTWeXYIueA,5586
+langchain_community/chat_models/fake.py,sha256=HcBmciiOU-NeOh76FMdGrBxuG1j3nF-a5RY7HUGgoqs,3217
+langchain_community/chat_models/fireworks.py,sha256=IThidDmLlLITq2lPYh8ZOzjojNflZtxSgnccolumqX4,11992
+langchain_community/chat_models/friendli.py,sha256=ICT-kPpaJXBooXH54RZiar0LkXzDy2bJArWwIEwQgf4,7114
+langchain_community/chat_models/gigachat.py,sha256=8pPCZIWsUv988x1qTWxWz2pZtuu5Q1kbiIV4zb-ubBw,9651
+langchain_community/chat_models/google_palm.py,sha256=2naPcuFMtSXyfGyNiSrVKQpWlZ1Jp2eSNapriedxvnU,11608
+langchain_community/chat_models/gpt_router.py,sha256=uN5adQYmQFC_amHLZ-f3V9HRBn2x1vlm4gacjQCpSGs,13080
+langchain_community/chat_models/huggingface.py,sha256=AnsiBbhhW0ogiNI1RZp23oeX-JJcFGTEX1YB-k_n1RI,7707
+langchain_community/chat_models/human.py,sha256=wcqnRLmIWuiJ2fCEx8TRi4UIuC5Dh2wCuQRPi_-AgpM,3741
+langchain_community/chat_models/hunyuan.py,sha256=c7z4iU4cbYi92oGQ2wfyR_ZFMfP7yqT0F3q24tQimo0,10601
+langchain_community/chat_models/javelin_ai_gateway.py,sha256=itySFbGjKl_jnBwuO-8OfSaAYic6w3o7FrMn4YCfIFc,7628
+langchain_community/chat_models/jinachat.py,sha256=M0U_hBI4aSJXuWN7ZC4dih1SU8Dkt6ltfUdyOpq0utI,15263
+langchain_community/chat_models/kinetica.py,sha256=xUnZQU0htW8xAjBpux48MpXjEANJQwDSvpkGVwSEGRo,20267
+langchain_community/chat_models/konko.py,sha256=irvLKQZbnzTzpCus3J5b_AvvJ0z1v9a6G3R70JRK7a0,10025
+langchain_community/chat_models/litellm.py,sha256=HuNdcIfcwRtRgmdT0GDveBY-KeSIdBOBZapcXhf8CYY,15780
+langchain_community/chat_models/litellm_router.py,sha256=DaxSBKc9OSbfpfFBPnhmwqTgrF40NwdCSXfedbG9l8A,8077
+langchain_community/chat_models/llama_edge.py,sha256=INuWzrSk_jlGcuubgqAH5Lcj1A_NgKR9LY5EvStpvNg,8564
+langchain_community/chat_models/maritalk.py,sha256=SDEV_VURM9moUjqD6t6vwfGS9UQI6w_Gcm_Z5NJaPNQ,6265
+langchain_community/chat_models/meta.py,sha256=VdmrYsuCfdVKQuzHXHne95_bk6ZaW3Vbra_iGybahwM,967
+langchain_community/chat_models/minimax.py,sha256=YVF3hUBGH1G6YHYC9SwEjwiW-lYLKphEI233Hk8Y8CI,3262
+langchain_community/chat_models/mlflow.py,sha256=5L5dknm-5z4k57tQfyk3sxtciPJPsRdkE7dCOjZo9sU,9874
+langchain_community/chat_models/mlflow_ai_gateway.py,sha256=OIQq9v22nOuOZxAYI0z46LStvgGfnommlz-eJxoOWjw,6711
+langchain_community/chat_models/mlx.py,sha256=DF71SysQOqj1krb1UTUXl2jnctfmY_nix_-1vkQqUbc,6196
+langchain_community/chat_models/moonshot.py,sha256=7SvuuQM_yA14pkPaRSW4SKDssyOnwuCl_TYNiqOsiKw,1908
+langchain_community/chat_models/octoai.py,sha256=Qhcbh7XX3axsoXBKbYBFjMFSG2gJP_BkOt5maP1bKS8,3308
+langchain_community/chat_models/ollama.py,sha256=w9e4YmoxTmKYRSU5ZK3gMdEr0LIYFYHYTUuMDzzO39c,13444
+langchain_community/chat_models/openai.py,sha256=LMhTKhv9FtbyJMyFuSExAn9Bat9ndEb6hPG4xtcaBPQ,26773
+langchain_community/chat_models/pai_eas_endpoint.py,sha256=Uy8LTEwcjAW0w4LweUk6YjsLY3K2oP6ZDLU6hUuzu48,10504
+langchain_community/chat_models/perplexity.py,sha256=OMBSID1VpC6-nozpBNsNtIk_x3KX6qN_zgWfFK8RBbk,10616
+langchain_community/chat_models/premai.py,sha256=UANp12XLhhxeop4tyrFKE9Gu7HP_6Vo5PwZ3xAfH8lc,14413
+langchain_community/chat_models/promptlayer_openai.py,sha256=gwTRhvXmHGTBdkgPPD0n9Ze2TM31dYNlqETQiMn0wtA,5256
+langchain_community/chat_models/solar.py,sha256=0-9bHYrC9toREPWZqXbkdUHjfgYbHZGxpSHpCnI9hfI,2296
+langchain_community/chat_models/sparkllm.py,sha256=XI0tBjpsL4dPqb9XyiimWjfSuYqrXigeBbNJ4NKyT6I,16754
+langchain_community/chat_models/tongyi.py,sha256=sLcd8KbMnQy-6m05cL8D7Qv5Ukhc4eBoEGAOCMIaZ4c,16377
+langchain_community/chat_models/vertexai.py,sha256=bTknhKmzOALyNix9BiGH8sGcbLlWtEMfpYvuF5dcTw0,14583
+langchain_community/chat_models/volcengine_maas.py,sha256=yKWoGu8i2-8odRWntzi8o7jdN14Z0oVP7fgvoeoUnY0,5296
+langchain_community/chat_models/yandex.py,sha256=3QQc943LZHQbtP_4Tbx6ZrSje-NIIKVzq8KubD0Q32U,10740
+langchain_community/chat_models/yuan2.py,sha256=paA4I478ccSNdoU2Bq57u3TyxGpBXsJthg4s13aEzoA,17173
+langchain_community/chat_models/zhipuai.py,sha256=Q7ijmHt878q85nXKXUU9emO0yUyT-bprt-Vq7QPEjUE,16761
+langchain_community/cross_encoders/__init__.py,sha256=rX41f08U-jk6zrCCZvkziko2QlumZLKpJ7VLHjNNAEk,1524
+langchain_community/cross_encoders/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/cross_encoders/__pycache__/base.cpython-311.pyc,,
+langchain_community/cross_encoders/__pycache__/fake.cpython-311.pyc,,
+langchain_community/cross_encoders/__pycache__/huggingface.cpython-311.pyc,,
+langchain_community/cross_encoders/__pycache__/sagemaker_endpoint.cpython-311.pyc,,
+langchain_community/cross_encoders/base.py,sha256=_Z7SoPSfOUSk-rNIHX2lQgYV0TgVMKf3F9AnTH7EFiM,393
+langchain_community/cross_encoders/fake.py,sha256=Oyk5N6cwQvrERMEFN0GTcdviKXPsqDe2pGFgWpwV4gc,525
+langchain_community/cross_encoders/huggingface.py,sha256=zFL4HaT3iYIf86cgIRDySeZT8IcDdj9JL6tx1bHXI04,1946
+langchain_community/cross_encoders/sagemaker_endpoint.py,sha256=5pjk8yJvfQQ-voai5ftvd2P4wJQabux1Tn37xnMQtRY,5335
+langchain_community/docstore/__init__.py,sha256=rMholfpzpWD-YEz_oDRXo0yO1h9A9ZvOjvXVeDdKWGA,1218
+langchain_community/docstore/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/docstore/__pycache__/arbitrary_fn.cpython-311.pyc,,
+langchain_community/docstore/__pycache__/base.cpython-311.pyc,,
+langchain_community/docstore/__pycache__/document.cpython-311.pyc,,
+langchain_community/docstore/__pycache__/in_memory.cpython-311.pyc,,
+langchain_community/docstore/__pycache__/wikipedia.cpython-311.pyc,,
+langchain_community/docstore/arbitrary_fn.py,sha256=NhJXWzq4gLUYiQyHCs185nCYOhMJnIotzyoJoy3sC8M,1080
+langchain_community/docstore/base.py,sha256=dCfWg0-RfMK2LAOcy5OkPAgLlVu-ytxyCeAL4qXsteI,833
+langchain_community/docstore/document.py,sha256=oNDzAxnJM3S8h2Pn13b_z5Q6kllet0wXi11nEMDi7X4,70
+langchain_community/docstore/in_memory.py,sha256=KeiRIr-ys_GNQfoQDPIh5wPanIf-Yc27JR5gca4O3oQ,1610
+langchain_community/docstore/wikipedia.py,sha256=K-eI-rD-cU-2mQ4lP5X2ej8594oAOtyDuChLymbwbUE,1472
+langchain_community/document_compressors/__init__.py,sha256=DCaAVf2n3qkGYta_dfWCW2yzTZZ5TIi9DAuJ0Q2CgJA,848
+langchain_community/document_compressors/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/document_compressors/__pycache__/llmlingua_filter.cpython-311.pyc,,
+langchain_community/document_compressors/__pycache__/openvino_rerank.cpython-311.pyc,,
+langchain_community/document_compressors/llmlingua_filter.py,sha256=p1au___nX3aNb5h2FG_Ido77YwpmOsFHO1TRgQ4EGsU,6695
+langchain_community/document_compressors/openvino_rerank.py,sha256=63PrdfE0BDGBYDSweR_aX_HzRh2VIrHIB0YeHA7b9Cs,5702
+langchain_community/document_loaders/__init__.py,sha256=xwuOc8oRQrV67oQ0daavDqcTEBzyOjGXbHg8pLFtJZY,37487
+langchain_community/document_loaders/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/acreom.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/airbyte.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/airbyte_json.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/airtable.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/apify_dataset.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/arcgis_loader.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/arxiv.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/assemblyai.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/astradb.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/async_html.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/athena.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/azlyrics.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/azure_ai_data.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/azure_blob_storage_container.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/azure_blob_storage_file.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/baiducloud_bos_directory.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/baiducloud_bos_file.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/base.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/base_o365.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/bibtex.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/bigquery.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/bilibili.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/blackboard.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/blockchain.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/brave_search.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/browserless.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/cassandra.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/chatgpt.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/chm.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/chromium.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/college_confidential.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/concurrent.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/confluence.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/conllu.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/couchbase.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/csv_loader.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/cube_semantic.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/datadog_logs.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/dataframe.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/diffbot.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/directory.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/discord.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/doc_intelligence.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/docugami.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/docusaurus.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/dropbox.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/duckdb_loader.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/email.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/epub.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/etherscan.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/evernote.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/excel.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/facebook_chat.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/fauna.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/figma.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/firecrawl.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/gcs_directory.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/gcs_file.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/generic.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/geodataframe.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/git.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/gitbook.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/github.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/glue_catalog.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/google_speech_to_text.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/googledrive.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/gutenberg.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/helpers.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/hn.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/html.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/html_bs.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/hugging_face_dataset.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/hugging_face_model.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/ifixit.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/image.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/image_captions.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/imsdb.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/iugu.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/joplin.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/json_loader.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/lakefs.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/larksuite.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/llmsherpa.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/markdown.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/mastodon.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/max_compute.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/mediawikidump.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/merge.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/mhtml.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/modern_treasury.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/mongodb.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/news.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/notebook.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/notion.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/notiondb.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/nuclia.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/obs_directory.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/obs_file.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/obsidian.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/odt.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/onedrive.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/onedrive_file.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/onenote.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/open_city_data.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/oracleadb_loader.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/org_mode.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/pdf.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/pebblo.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/polars_dataframe.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/powerpoint.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/psychic.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/pubmed.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/pyspark_dataframe.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/python.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/quip.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/readthedocs.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/recursive_url_loader.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/reddit.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/roam.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/rocksetdb.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/rspace.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/rss.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/rst.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/rtf.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/s3_directory.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/s3_file.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/sharepoint.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/sitemap.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/slack_directory.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/snowflake_loader.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/spreedly.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/sql_database.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/srt.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/stripe.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/surrealdb.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/telegram.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/tencent_cos_directory.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/tencent_cos_file.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/tensorflow_datasets.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/text.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/tidb.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/tomarkdown.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/toml.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/trello.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/tsv.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/twitter.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/unstructured.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/url.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/url_playwright.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/url_selenium.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/vsdx.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/weather.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/web_base.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/whatsapp_chat.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/wikipedia.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/word_document.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/xml.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/xorbits.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/youtube.cpython-311.pyc,,
+langchain_community/document_loaders/__pycache__/yuque.cpython-311.pyc,,
+langchain_community/document_loaders/acreom.py,sha256=mOFMX6MzrVItqoPf7qBi6YQSH6yDcVYk4EYE1jM1eIU,2803
+langchain_community/document_loaders/airbyte.py,sha256=X62Y00tn2rOojhmkFLCTiilinVzrQB_2EcSlTyZTRMc,10157
+langchain_community/document_loaders/airbyte_json.py,sha256=m9Zz9QOfjwdH7TAKZpM_GWNdHwFNmFxyaaUKbgM3BcU,865
+langchain_community/document_loaders/airtable.py,sha256=lbEQecAL0M9NRHITquHgP21E0MRuQwyCSOomCZ3dK1c,1157
+langchain_community/document_loaders/apify_dataset.py,sha256=TFHshD749AR4sGUzmoP5ugMQPSICjO6K6GsPeJ261U8,2759
+langchain_community/document_loaders/arcgis_loader.py,sha256=8TmGY4bX0Wom30LzWos4DfqPu_2zeZRkspunXhVsWBI,5129
+langchain_community/document_loaders/arxiv.py,sha256=pk37QAtk7jK7EOpeO4oPaAtiAaPfpCxIaJhL0XVSuQ8,907
+langchain_community/document_loaders/assemblyai.py,sha256=FW_HsE4tQbbIlqzjGIrM-dTeeefYQ7xzMGbNCBKnLC8,8134
+langchain_community/document_loaders/astradb.py,sha256=7RrFhrnhI1i1WqTObcRPlxIqepn-Rgp_KGSP8qhZMoI,4642
+langchain_community/document_loaders/async_html.py,sha256=YnRqmegcaBoV_eFPaLbDMxoGdaub-XbETeyiQS3wVpk,8129
+langchain_community/document_loaders/athena.py,sha256=_rEZfdvkFjQz9SPl3YVwDT63tE5NMjXyRyIfvCj8xAA,5902
+langchain_community/document_loaders/azlyrics.py,sha256=2CS2bQvCrEgSKVP2MRIfdFT8uWocxTNynj7ejzyyirw,563
+langchain_community/document_loaders/azure_ai_data.py,sha256=A-Pl9-YBvWNjmgp5ZDT8gkRZDwll9ps6Nu0_bqC9yVM,1432
+langchain_community/document_loaders/azure_blob_storage_container.py,sha256=rLyZy7eNEyVME7gzK4liCXvPmQvhc9K4hKdpoEjgaOY,1566
+langchain_community/document_loaders/azure_blob_storage_file.py,sha256=5Rr7a0cBIYvRhn1pDdfKXs6mr2hvmgoaB91bTEChfQk,1644
+langchain_community/document_loaders/baiducloud_bos_directory.py,sha256=gFZ7VcLHpxuW7apayzEP_07aNLRjygBVbn2YZF_Gatk,1774
+langchain_community/document_loaders/baiducloud_bos_file.py,sha256=ldL1Rq--GCCHR9VIX9uR-plb-H1Lsup40mbAyI0m_tY,1848
+langchain_community/document_loaders/base.py,sha256=CCHl_U1zqauVua9p1_pxNjrXd3okY5zGfJlcq8fRKuA,126
+langchain_community/document_loaders/base_o365.py,sha256=vVy_GzDhP2w3EJeXBz62Yr1p6FWqRQ5Z0A4Z3NvBd1c,7222
+langchain_community/document_loaders/bibtex.py,sha256=5N-YVTw7S7z4ZPqLk780bOal0RlFWC0McwygeQi0ntM,3540
+langchain_community/document_loaders/bigquery.py,sha256=Yah-MHVr25ZjX_3PRsg9sGebsOjo03hoUUogj6Wm4Ac,3852
+langchain_community/document_loaders/bilibili.py,sha256=SufCSaL0zqysFXvK6LTMZm1SR3jcjvXlAYelE7VFhYs,4401
+langchain_community/document_loaders/blackboard.py,sha256=GvT5NnY529O4aqMthIe1g8vT308vz7sMd_wEQNPWbSg,10288
+langchain_community/document_loaders/blob_loaders/__init__.py,sha256=BMVSwsy9kZjScA6Z8ScP_B2lb5b9firaZh7jAtmgXxE,705
+langchain_community/document_loaders/blob_loaders/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/document_loaders/blob_loaders/__pycache__/file_system.cpython-311.pyc,,
+langchain_community/document_loaders/blob_loaders/__pycache__/schema.cpython-311.pyc,,
+langchain_community/document_loaders/blob_loaders/__pycache__/youtube_audio.cpython-311.pyc,,
+langchain_community/document_loaders/blob_loaders/file_system.py,sha256=lygeJrkx69L4Y1HMrhsjNA07RE5CpZ7rxgN9U8KWOpY,5390
+langchain_community/document_loaders/blob_loaders/schema.py,sha256=Ml_Vn-x2zYpu6MO3y5aI82pa-8GK0mB4KZ4zBbKnBBg,145
+langchain_community/document_loaders/blob_loaders/youtube_audio.py,sha256=UhotHw2CwrjtNVcqS1uRyWVwgX4hDD9qWlpKZkAFrC0,1526
+langchain_community/document_loaders/blockchain.py,sha256=FF2EwZOdI5oYK4UmOdL5fqogdFfedXlWjG3qT-oX7mo,5709
+langchain_community/document_loaders/brave_search.py,sha256=an6tWbh5ZnorkcyWjhm1qG63Tylf9P4qVXqkIOU1Gi4,1047
+langchain_community/document_loaders/browserless.py,sha256=-DcD8YbH0oxSboeGFoZgxfT8qXLhveiiuT7o-HDfbC4,2007
+langchain_community/document_loaders/cassandra.py,sha256=W8m769EncmXBK7g-P0hhWq6p9mTlXupX8c2Ixb08KYY,4984
+langchain_community/document_loaders/chatgpt.py,sha256=sRjSrJTHSZKtRduQvm1NPsHeqscDa_KwvAYp2qfz7wo,1986
+langchain_community/document_loaders/chm.py,sha256=wEzuHyuBZntbSXm67O-7HwMY50rNiZLPILg0gnCqevM,3031
+langchain_community/document_loaders/chromium.py,sha256=mstrHIbZU-67bPNk7uy9yivhFeQ2KNa1k7Ccu8tkiSA,2586
+langchain_community/document_loaders/college_confidential.py,sha256=saZXI5k8Rh4sijMPTRWoOHZ5si32HeFCIQzotHVqpfY,527
+langchain_community/document_loaders/concurrent.py,sha256=1GHPHPOvhyF2MY0tLSEDV-Rmlh-DOfvfI5guvOF_NdM,3416
+langchain_community/document_loaders/confluence.py,sha256=jzNbIddMYiNK8SXesdu0SVQJOwozoZPvkv_kMWkFQhQ,29478
+langchain_community/document_loaders/conllu.py,sha256=ggulR8X_wGegI3rorwAl8dVPRR5tyD_CjNawxqLZCYQ,1102
+langchain_community/document_loaders/couchbase.py,sha256=rp-lgJ3eg2ClKWSl8W0ol4rf8Az-Q0slW5-5QCsiOiw,3515
+langchain_community/document_loaders/csv_loader.py,sha256=7MY_LUL0XHsb--BtsmWtPxvfsE17efyz-sraaitbL-o,5835
+langchain_community/document_loaders/cube_semantic.py,sha256=cw8aqilhMpXch-IT1FFoyNXOpFBampE3txS_8S1gwhM,6589
+langchain_community/document_loaders/datadog_logs.py,sha256=xxKrEClqWM-NGaNNNwZwJEUaWQVK8olnIvSJ9r34LSc,4937
+langchain_community/document_loaders/dataframe.py,sha256=BVsX8hJykdK28ZRkqrHiQgCY33_0Ig8wb9NH9ORTIJc,2176
+langchain_community/document_loaders/diffbot.py,sha256=3GsfJLgGClIbJ0wfrKuxDZYJSK5aMeXK8QME0y1JdZ4,2054
+langchain_community/document_loaders/directory.py,sha256=VaFWjuPXdDzUfl4HbO5cwXnllnR1heq2mPg5jNykC_o,8446
+langchain_community/document_loaders/discord.py,sha256=KAkW8TnQUyVoVav0m49SljmcwnSPKrZcQtsEZ7-uo2s,1237
+langchain_community/document_loaders/doc_intelligence.py,sha256=6RhjnqCFkl8LZ0n-9C_ORrqGhy1CQBf_wqq7FPXB1lc,3859
+langchain_community/document_loaders/docugami.py,sha256=scJNyIfT-bRgO9F3niTuBaGGtZKCGmoxwEK7QdYIKhE,13621
+langchain_community/document_loaders/docusaurus.py,sha256=2oFt2gdleEiRMpCa25ZotKSBHSf9i6ZksHcNGa1WALU,1852
+langchain_community/document_loaders/dropbox.py,sha256=A8WGv4J2cMUZ1OhgTuzWwnUWNpZGSr_j2Sx0nYrg5-s,6271
+langchain_community/document_loaders/duckdb_loader.py,sha256=o1tEI0VOQNLWHhpD_de5EsAC7wdupbHGKSD7F65Krfg,3150
+langchain_community/document_loaders/email.py,sha256=l0Qfn9STd3PCucA2KT24j9dAwc_MTurw3IRlV8x9Nco,3835
+langchain_community/document_loaders/epub.py,sha256=LTq6F8PMsDeX9Ha__ndfINpzZk56gp4nu336a3V5h4Q,1496
+langchain_community/document_loaders/etherscan.py,sha256=0pweNXluzsHL2YBTgAqpyHYddjtD46VC38m10KN5HN4,7753
+langchain_community/document_loaders/evernote.py,sha256=K-TZcU-9WmFUs38ebHEBaShJAPEfCPi8eqZ3r8WJZA4,5930
+langchain_community/document_loaders/excel.py,sha256=wwIKndRMn0WegJtE1AvBD-t54xqOl6w7h32zz0xNb0I,1753
+langchain_community/document_loaders/facebook_chat.py,sha256=why6d58ELKfRjss1pspPdX7V2eMAZrxa5LnTUopQB1M,1270
+langchain_community/document_loaders/fauna.py,sha256=AMOjqPwKn-anHu5imw7Eo_W7B61eJqOivGHziTFc2Yw,2171
+langchain_community/document_loaders/figma.py,sha256=BgWmavQPYR1q-m9b2T24QVdMZsRGAgxBrcKUAjUl7Tc,1543
+langchain_community/document_loaders/firecrawl.py,sha256=rHrvQNL0cSFnL48nrZLXldX4_HWHK6SKiJhbFdcC-rI,2467
+langchain_community/document_loaders/gcs_directory.py,sha256=bGpEkWX8OXSYl15kGhJHYQi2LPBVC_IUES_ZZ5rOmdA,3041
+langchain_community/document_loaders/gcs_file.py,sha256=s2oDxnuOeZ45SWuWgiW0nq8Sww-pvADhvk3iul8Px2g,3316
+langchain_community/document_loaders/generic.py,sha256=BqV7bX0UqgsBsVM3aep0cjI46vILtENH5PbTkxSTLM4,6374
+langchain_community/document_loaders/geodataframe.py,sha256=S5CaJThmpp3FFnP3mNXL9QRwQYkrd7-x3TzPswJ9dsI,2400
+langchain_community/document_loaders/git.py,sha256=QFjaNFvFiP6vIOwdHP9mdOPyoEI1x1VFX3AKSun1AYM,4018
+langchain_community/document_loaders/gitbook.py,sha256=8kAunGu8HfjPHXrwoiUueFvpq0p29RqLnNyWuVqX3ns,3451
+langchain_community/document_loaders/github.py,sha256=f8UJ1CUAMhkq048HfZiXmjS2LW8cG3LOmhuwU45EnkY,8676
+langchain_community/document_loaders/glue_catalog.py,sha256=xYV-IF3H0AuB2GpxAMr4s-o1jj-rlB1E_Hj8q2RkOAM,4459
+langchain_community/document_loaders/google_speech_to_text.py,sha256=rmZj2k9ylE7JUa-RBf_nG0RL-HtVrO3QBKSX0W_HryA,5279
+langchain_community/document_loaders/googledrive.py,sha256=YgBgXZ-oMUlkfCdJScDXZln3WUHr1KzTbmj51XN-b4c,14435
+langchain_community/document_loaders/gutenberg.py,sha256=y1elY_VN0zls2MjOEUQmSkwMyyloXO1sfn-6gTcSJ3g,928
+langchain_community/document_loaders/helpers.py,sha256=Mi1Wtt3IPKJCLs37IbDOjyaMAq916Tj9wQRsC2wutKI,1640
+langchain_community/document_loaders/hn.py,sha256=d_-puCC2uHA6iMpH7am7w1RSCf2ko2Jfd336TFhbXnk,2075
+langchain_community/document_loaders/html.py,sha256=k7PDSRQyGClVEntQkglHDobzJiGPjuMwJpI5oOA22zk,1158
+langchain_community/document_loaders/html_bs.py,sha256=kxlunrb48ARJBr4CkAje0tTSbI86PnhzCyjR3P2kEYI,2098
+langchain_community/document_loaders/hugging_face_dataset.py,sha256=zdRTDmcgiX5ghOSbm-42EVCZVj4Lc4vvDmWxRQ3xzBI,3095
+langchain_community/document_loaders/hugging_face_model.py,sha256=zXM_v9L3L9un9EXI3ZzjVQanIYjemYbEr6YckIbMnhs,3628
+langchain_community/document_loaders/ifixit.py,sha256=vrKGoV2bwH4Cp2yE5u8mQzuyndPAbev0T2QFUqGCswI,7642
+langchain_community/document_loaders/image.py,sha256=-szQ0aks0oi8FEhTh2QKOPeHmJS7YS6XHJ_kJMGkAhM,1173
+langchain_community/document_loaders/image_captions.py,sha256=YGGiI7gNd3oIfO_lO7fptrW9TU2_AyzR8IB15_MILZ4,3707
+langchain_community/document_loaders/imsdb.py,sha256=HLKUh7hXZRU0CQxrJ5RpBFyNWPlZpqo5rqovyjFdII0,477
+langchain_community/document_loaders/iugu.py,sha256=LsxrDEnQID_sc76ZQgyBh42r5U2jtSLTe_8pOQ9MpJU,1688
+langchain_community/document_loaders/joplin.py,sha256=MN39rWnFJkTZEE_AxJHvae8O3BPrpe66WzC45p_k7mM,3628
+langchain_community/document_loaders/json_loader.py,sha256=3Nouudb894CzwfqNc3gFzQUQQAeE3B3a616SV-BKM7Y,7379
+langchain_community/document_loaders/lakefs.py,sha256=ZX-yjp-nrDJhmc29uw4q1by-2CvGSOBvggRYhq54p8U,6058
+langchain_community/document_loaders/larksuite.py,sha256=Y7KPjl8iMIuR3CuElc2hnOg_8MUICwG9YdJi23W9zbU,1877
+langchain_community/document_loaders/llmsherpa.py,sha256=xS50QBedzPDfVN5uSiDBGwA5FTUCElW2egOaJQSWFGs,4881
+langchain_community/document_loaders/markdown.py,sha256=_s93NUF2UYMFJ0Gh6SvrvfoDga9rKrFHse8OmCj3q3g,1818
+langchain_community/document_loaders/mastodon.py,sha256=CRX6JvB7OIp3RNW6BaxMbTneR9hndYWfRorz4oFLqUU,3079
+langchain_community/document_loaders/max_compute.py,sha256=Ow2wQd4C_9FmQ3kj9g1SHIP2gNPJBRJmMIMjhSd_cuY,3199
+langchain_community/document_loaders/mediawikidump.py,sha256=9vSox0Ee1sX-mWi_P031b7sxm3IKu8pogU6e3Xlipd4,3859
+langchain_community/document_loaders/merge.py,sha256=XdmAd-5qVd5Cxj1JP4O7o53bc0OEhHvArlMOlx5az2E,999
+langchain_community/document_loaders/mhtml.py,sha256=b_x9G3Ifd7BS7-RbGy7yG4jMuqOv3HK8sZ2xDHUrFF8,2602
+langchain_community/document_loaders/modern_treasury.py,sha256=mTt8FzyN3A3jpdYFYtfAh6lTGpJGXsFtmN_QTAUi0gI,3074
+langchain_community/document_loaders/mongodb.py,sha256=6QSepqZ3O0_lf5vBearnWOUsJU-rPFoeSZBI70y6Ph4,3182
+langchain_community/document_loaders/news.py,sha256=THbJyoWJesCHItWpfvBwjdY7biVFutuhPhFc7O9ILhY,4296
+langchain_community/document_loaders/notebook.py,sha256=roEE9zFg83TfoBV608JvyWSDtXZJf2aVAoiNyVzEp0c,4296
+langchain_community/document_loaders/notion.py,sha256=s3kwb49CF80jS7HkI84xEd11YpvAcghkitf2g7UbdFc,834
+langchain_community/document_loaders/notiondb.py,sha256=FzR4n45mXYqmHPI0oqvWDkNXOWkny7uNjWuNGIwivXs,7715
+langchain_community/document_loaders/nuclia.py,sha256=P_lzUMkTnKjTd4CSNFcInSDFkYLbmeHcKShKkSyCLmU,1102
+langchain_community/document_loaders/obs_directory.py,sha256=tG4xIW1yHN02SBzadSr3gLMJRImSYf6hwuVrg7qUaHA,3593
+langchain_community/document_loaders/obs_file.py,sha256=7FME8tLmHyGpvIyM0-CK5xg2wYdJ7bbieJGY75LO5w4,4768
+langchain_community/document_loaders/obsidian.py,sha256=sAzM7S0gQDp3Du6q694ZrmvEUNHDfqNdC9evjJdk6UQ,6132
+langchain_community/document_loaders/odt.py,sha256=dllyLGR9INewArtU1iPR4RX630MdUT5ONpDZSjOUeJY,1840
+langchain_community/document_loaders/onedrive.py,sha256=wPDV4WLvwwU6GCUBZjYXccdKi0PxsZtiISfYw_9QXB4,3270
+langchain_community/document_loaders/onedrive_file.py,sha256=pl_ggDUEsQuvmXIRDZbTaD6ulX9f1Fezl8GZeKXhfT8,1154
+langchain_community/document_loaders/onenote.py,sha256=2h3zHXLLXS05jgLXfl41usYik6XK85emVe7orI30U3w,7807
+langchain_community/document_loaders/open_city_data.py,sha256=UdpSiKcqItLkkh_554nwu52ZzdB1wuLQfi5luDCmWd4,1219
+langchain_community/document_loaders/oracleadb_loader.py,sha256=jVMm1BCYZxNPhmM189dewxfveIgTWXGSQGbyTSk9Ijc,4221
+langchain_community/document_loaders/org_mode.py,sha256=xJUKVRTQxNmoum03Z85pA7gn98fmCenwfjdtJL1x0l8,1818
+langchain_community/document_loaders/parsers/__init__.py,sha256=T5wJw-79ZEDX3-a72ILVPyrw77dlCE3fEHojW6z0owc,1283
+langchain_community/document_loaders/parsers/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/__pycache__/audio.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/__pycache__/doc_intelligence.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/__pycache__/docai.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/__pycache__/generic.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/__pycache__/grobid.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/__pycache__/msword.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/__pycache__/pdf.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/__pycache__/registry.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/__pycache__/txt.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/__pycache__/vsdx.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/audio.py,sha256=cUQmde5ckDVr9xw41mf1Y7t1zJt0r_WC4NfToxFIbac,16135
+langchain_community/document_loaders/parsers/doc_intelligence.py,sha256=vQRUiGhXPVilGpzQzbgb8iB9mNtHYdEbV_oXdl6F4LI,4050
+langchain_community/document_loaders/parsers/docai.py,sha256=b2D4tuMvjRDSqlRBmVzPzBvuw7AMWmvLejwAX5_BzEg,15459
+langchain_community/document_loaders/parsers/generic.py,sha256=keQTfbvpihOgoKtePLrnn-CXdegJ62avnjd7W2JbAfQ,2502
+langchain_community/document_loaders/parsers/grobid.py,sha256=R-GcMg6yvOgzfCBwemxMPPjzWLPDPCWGhVRGg0ONL68,5903
+langchain_community/document_loaders/parsers/html/__init__.py,sha256=ahE8oP4C2qFmEBT-G65UQEnQjz9fsQzFA7DuQfsEn74,109
+langchain_community/document_loaders/parsers/html/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/html/__pycache__/bs4.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/html/bs4.py,sha256=AjF17GOSohBmILbxt_NvNVczpz4oYQntZYKJ1PqU8Ig,1609
+langchain_community/document_loaders/parsers/language/__init__.py,sha256=XUbP3aVIyahpn5p0wbEuQRFkYogN9FtCH_x6nS79Cxc,136
+langchain_community/document_loaders/parsers/language/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/c.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/cobol.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/code_segmenter.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/cpp.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/csharp.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/go.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/java.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/javascript.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/kotlin.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/language_parser.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/lua.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/perl.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/php.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/python.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/ruby.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/rust.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/scala.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/tree_sitter_segmenter.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/__pycache__/typescript.cpython-311.pyc,,
+langchain_community/document_loaders/parsers/language/c.py,sha256=7T8UJ26ZO3d2AVREPaBMeFz3EJDPn9txuGFIeLoTeB0,877
+langchain_community/document_loaders/parsers/language/cobol.py,sha256=VGuvWSMeLEZfMiWZkoVg_gIeLMyBWJiBU0MMQUngFKU,3745
+langchain_community/document_loaders/parsers/language/code_segmenter.py,sha256=4BJ8MqBmjHaTf5q0W3EnTwjbGES8wj6ToRRr63MCkX8,495
+langchain_community/document_loaders/parsers/language/cpp.py,sha256=88UhzjyweVoBVA3FOGd8r28tSyy3QQTkZ4U_5rhmgdE,893
+langchain_community/document_loaders/parsers/language/csharp.py,sha256=BUN0kmY7SFM-KfLoWRtJQ9frgljLZy9P4ANEhlW4M3Q,893
+langchain_community/document_loaders/parsers/language/go.py,sha256=ZYzwc3dmiYLtCYwTvDVpeUdvIw7e1ua5ctGalJon-tY,693
+langchain_community/document_loaders/parsers/language/java.py,sha256=spP6K5-9uwzly48ciIZLC6oCbt82PqWMmTmSwX2_U0o,736
+langchain_community/document_loaders/parsers/language/javascript.py,sha256=A081W0IMUiOsRP1fPVJLxCX2Rz5KTuuMRXSqkLwb6l0,2185
+langchain_community/document_loaders/parsers/language/kotlin.py,sha256=jl_PeNJYWS7IHAdPIsD9Kw7J2vg6C2tTnmHCBYd9msw,707
+langchain_community/document_loaders/parsers/language/language_parser.py,sha256=eqtZ5c1lnG-htmSspat4E8xJtv173B1lLHhjo02W8GI,7538
+langchain_community/document_loaders/parsers/language/lua.py,sha256=1-c00i1q07t8plB2qr2n596x6A1UcOhkFNH79LUYOeE,790
+langchain_community/document_loaders/parsers/language/perl.py,sha256=it3VIfAKeL7Bg20qOJIfna8_vlLaUUo7Ma70OMUsxrg,666
+langchain_community/document_loaders/parsers/language/php.py,sha256=YeOJwbYx3Y42IRR12chT8SdQ5NgFkuCMn2Q8toQofpc,850
+langchain_community/document_loaders/parsers/language/python.py,sha256=IP8nZo4n0YUHprqIs1DlNmuAvvzcVf2dtR6tUvgD6pw,1731
+langchain_community/document_loaders/parsers/language/ruby.py,sha256=0ppOknZ4D4McAn51u5Z2ox5MOJJKc0MJpu142T82qvE,697
+langchain_community/document_loaders/parsers/language/rust.py,sha256=tV0LOIdxw3zFv8xSmio73m99x3aO24AljtFylSscEl8,774
+langchain_community/document_loaders/parsers/language/scala.py,sha256=NNCJ4hRLOg7pdDwSEjr8_hOhP1AM431VMo6iGGORzeU,772
+langchain_community/document_loaders/parsers/language/tree_sitter_segmenter.py,sha256=U1Giue86AcoO0CsIxClWNqJHPH-BasBhs-sTixKuLUw,3473
+langchain_community/document_loaders/parsers/language/typescript.py,sha256=I0a87gYfMpuufjvrgVKpakqlFElzDglpd5gvgSA1oQM,795
+langchain_community/document_loaders/parsers/msword.py,sha256=5N5QMvGPBMBUukpyiqgaDz49PyxBt46hLIfjyttbvRE,1812
+langchain_community/document_loaders/parsers/pdf.py,sha256=qR_0mw-BEnODySEy96WnYZaOTyaxmPNC4PrTO9O3An8,22511
+langchain_community/document_loaders/parsers/registry.py,sha256=lftI3iKpg1kompplz2cTqBSFUxe_7E8vXO1ASrpCe2E,1214
+langchain_community/document_loaders/parsers/txt.py,sha256=pRWnt28cdLlb9KLjJ3FKAURbW7fJ6BaixasxIhBPvp0,563
+langchain_community/document_loaders/parsers/vsdx.py,sha256=6EAVjevUcAhijpkDiAku3wHqmDOMcY1-Ackip1FvMzo,7902
+langchain_community/document_loaders/pdf.py,sha256=3h7cpDqJlf9LSbJtWBdHd7J2O2uaNEXb2HlTEzr_84k,27789
+langchain_community/document_loaders/pebblo.py,sha256=mEnBgyiZ9HHIdZ4SRPHlXilbVy9KtPM6oGE8sPtMtto,13970
+langchain_community/document_loaders/polars_dataframe.py,sha256=L5oAncFYot-0RX15RwojsaheFWrbRWkYo3_svuqXXW8,1161
+langchain_community/document_loaders/powerpoint.py,sha256=Edqb9qNwogUnCBK-tIMxn8NI-jpG9F2DA5iTp-T3ssU,2508
+langchain_community/document_loaders/psychic.py,sha256=XzHUG0ByT5C2_2GNsvaGwkIVxwNcgUmZMio_9YpsNE8,1329
+langchain_community/document_loaders/pubmed.py,sha256=ElXV6P4SJbIUuRc2uVZFyUBhFm0MV0Yqfd9ZYRL3f44,1066
+langchain_community/document_loaders/pyspark_dataframe.py,sha256=BT9CtMUTHSSpVN9PPi6FU2F7Rc_tDLPoPIqHP8cIFtA,3388
+langchain_community/document_loaders/python.py,sha256=dsPooB_NhF-hIWESa2U6mkHqI3Qga7bBICj1Ui6x75s,590
+langchain_community/document_loaders/quip.py,sha256=4jP6uZFt2ZLRjMqRrkFg48sdLWg9bS3nERRdcH3Un5Y,8426
+langchain_community/document_loaders/readthedocs.py,sha256=oW_HCzYRpfwYIL0eU2BtYsIXi8gwHnUVIdQPm1QdKCM,6821
+langchain_community/document_loaders/recursive_url_loader.py,sha256=3SgtnU7kIdFhOgj1L3R5zCkPimWS9-To767qMnaAoC0,12399
+langchain_community/document_loaders/reddit.py,sha256=9wGLbJLFChZiBa1N06zHjkwBuTHiyxd_6Q53fhItOZI,4584
+langchain_community/document_loaders/roam.py,sha256=n0x3uQCDjaPg1DOEMievR-ffCdPHxPQcB3GM7q3TsDs,725
+langchain_community/document_loaders/rocksetdb.py,sha256=kqz22-nJcZiO3-2oIi3xVt3FJ6jVmFiGarSRlmKDpqc,4527
+langchain_community/document_loaders/rspace.py,sha256=mhiGZTptaLXDQPYLMPbHv_fRUpJOiIzzDrVhy4QC8cI,4859
+langchain_community/document_loaders/rss.py,sha256=kBhqMLLD_ogA719JyfhRAonQgyiGvkzOQeWBKcq8YsU,4895
+langchain_community/document_loaders/rst.py,sha256=9qkqbQfUKl3kPPQvtQCJLO3OoM7vmNWsV3er766a6uM,1902
+langchain_community/document_loaders/rtf.py,sha256=w8AAX8UQ4Fm2u4yeJahquD8B8GttiP76QiJluh49dVc,2131
+langchain_community/document_loaders/s3_directory.py,sha256=wnOKjB_JlsycXr6y-PhIl2gzKNeGgyaZMOj-qB5CRnQ,5871
+langchain_community/document_loaders/s3_file.py,sha256=X_VOHRoqX4DHhjl7xnG0pro8v-x80e93MYBPSsxD7_M,5956
+langchain_community/document_loaders/sharepoint.py,sha256=ZNHAyFxkM1n2kuZ2SJEIeMzHGH9unQT6JcL_6vjviw4,3002
+langchain_community/document_loaders/sitemap.py,sha256=qDvSsBXm2sfJ6gZdIvNlZOuzeAk_ysBYLKU1poMlk0A,8524
+langchain_community/document_loaders/slack_directory.py,sha256=zCklV2uN_EI6SbjjHDBB2WkGsu3spugSE1OmcuNuZFQ,4027
+langchain_community/document_loaders/snowflake_loader.py,sha256=dzj_-Nm85KbLMsbW5IvHvYph4jkBbI8hMR0chGu-vGM,4703
+langchain_community/document_loaders/spreedly.py,sha256=G4WX4ZmNaV9PwiwAx4ikSbRqSLZk9_DlrqteCyjDxy8,2004
+langchain_community/document_loaders/sql_database.py,sha256=qS4RtAUYolgif8JGHm5zqZV54pBYj-EHttXvS_FN5aE,5581
+langchain_community/document_loaders/srt.py,sha256=rpC3S9NIz90vVdaabR92OY7oUOcurjRgmCEO2r6-P_k,901
+langchain_community/document_loaders/stripe.py,sha256=IInMlwg1_DsWPjhb_eTaN2ftBDSRFkYtcIdxWJ82kss,1811
+langchain_community/document_loaders/surrealdb.py,sha256=0lczkvXH2uOy7HQspS98NnO2SmrzKOmYIuDWvT4oxe0,2965
+langchain_community/document_loaders/telegram.py,sha256=9mHTwSV9SRQZub-il3iSiV-zQfCKGkGG6KCf-cQpRtw,9079
+langchain_community/document_loaders/tencent_cos_directory.py,sha256=yWLdyn3Z92IcD9DKgF1N68KUeBMBhLo_5xHcKWkHOHM,1700
+langchain_community/document_loaders/tencent_cos_file.py,sha256=5RpzXpPWgdi7eYjpl72ojIiCW6x51_deu_6VM25n3s0,1617
+langchain_community/document_loaders/tensorflow_datasets.py,sha256=I6l2pu8efJzU4fAUAZpjOW8AKFsWFyVyX9cKymBpkSY,2941
+langchain_community/document_loaders/text.py,sha256=4fI6gIsWnYune7n5iWrxL3dx1BcO3QokpfPW4LrnOyY,2070
+langchain_community/document_loaders/tidb.py,sha256=XWdItLPYVpisX6UgQD2Wy1quBFZYUP1zeNB8mELbjZA,2610
+langchain_community/document_loaders/tomarkdown.py,sha256=u9aszoYyyzmQLF4oyUaOopdsfQsmvkYzY9huOVWvXdQ,842
+langchain_community/document_loaders/toml.py,sha256=F_nu243ouRfM-kvOb1KwhGT0t69tvFPKMtBFRU1eJvw,1458
+langchain_community/document_loaders/trello.py,sha256=ZDP02u22wxk3D4bpgl9tR5tleIKb89eU1BTIvYu6L24,6584
+langchain_community/document_loaders/tsv.py,sha256=4odrWQoy-gMj27g-Sai0bM-N97cJuKLIEddn_Ln7PpA,1363
+langchain_community/document_loaders/twitter.py,sha256=ffGGUb1f1dWdQHoUJwJ0sFj7Nv6-_gAU5VCRtftNnlw,3438
+langchain_community/document_loaders/unstructured.py,sha256=RtHCcxvMRrc4Ms3yixzM-xnmLSLyAq7ufmMTl-NIUEQ,14327
+langchain_community/document_loaders/url.py,sha256=tpjK3UfrU_Lu3vv2Q7xa0kXlQ8L0YNQCpKGpgKIWJJM,6019
+langchain_community/document_loaders/url_playwright.py,sha256=-6cI6A67t3K36t376PdkVtZfztMOk_Vb_0SZ8ff-8UA,8528
+langchain_community/document_loaders/url_selenium.py,sha256=-MVlNQUjlu8SXmZrR3PeYjWcU8_h7tuJnDiSsOZQQXw,6640
+langchain_community/document_loaders/vsdx.py,sha256=UDCYtxOFUmst4fvxbQ7GsKB-VP5AH75S2qPkMAwPA3A,1946
+langchain_community/document_loaders/weather.py,sha256=_oThVVvVeuW-PcEb6tSoDS44j1NpMXoNZfHxP3tLzDE,1527
+langchain_community/document_loaders/web_base.py,sha256=RgcIOmFEJhTmbZMjh9YKTfU1AOAfbV3zoQlPKmtfhjw,10115
+langchain_community/document_loaders/whatsapp_chat.py,sha256=49yold_X43R4k2P6fZED9x0oV-uSPuGTKvC_6eZjnns,1750
+langchain_community/document_loaders/wikipedia.py,sha256=wq2gy6C5rfQHW9pkjnXy_pp4oT1ZkvcfQ0qS15RS5JU,2123
+langchain_community/document_loaders/word_document.py,sha256=Stg65ZsCdxg3ljpCxq1bdP9c1GjLdd5V00PX_9ypNdo,4633
+langchain_community/document_loaders/xml.py,sha256=SGGWyEm693JD9iM6DBJOlfZSiOuIa0y9nHfPOScsawk,1594
+langchain_community/document_loaders/xorbits.py,sha256=4UdKHC76qJ60HHz_oLHc-NRGSurEzUK9PMoKcTx8Mlg,1119
+langchain_community/document_loaders/youtube.py,sha256=-RfAKfN3yjv8VJWK-JuK9H2hlw2RD5q5-3ctwgYvBmQ,15500
+langchain_community/document_loaders/yuque.py,sha256=kIXt-nfcSqBiyLtJfiZZ-DH0K_Wg6jhU6RzonbrKKC4,2958
+langchain_community/document_transformers/__init__.py,sha256=qRQUJPtBEMjL3tReEE_V92iQWERz6Vun7yr6ij62ons,3830
+langchain_community/document_transformers/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/document_transformers/__pycache__/beautiful_soup_transformer.cpython-311.pyc,,
+langchain_community/document_transformers/__pycache__/doctran_text_extract.cpython-311.pyc,,
+langchain_community/document_transformers/__pycache__/doctran_text_qa.cpython-311.pyc,,
+langchain_community/document_transformers/__pycache__/doctran_text_translate.cpython-311.pyc,,
+langchain_community/document_transformers/__pycache__/embeddings_redundant_filter.cpython-311.pyc,,
+langchain_community/document_transformers/__pycache__/google_translate.cpython-311.pyc,,
+langchain_community/document_transformers/__pycache__/html2text.cpython-311.pyc,,
+langchain_community/document_transformers/__pycache__/long_context_reorder.cpython-311.pyc,,
+langchain_community/document_transformers/__pycache__/nuclia_text_transform.cpython-311.pyc,,
+langchain_community/document_transformers/__pycache__/openai_functions.cpython-311.pyc,,
+langchain_community/document_transformers/beautiful_soup_transformer.py,sha256=EemEDwzY6osZnOmBdpeUlqSR8ffLWmw-yBWTCASZHyA,5645
+langchain_community/document_transformers/doctran_text_extract.py,sha256=JlOQKKC9lzkTSyXrKjfWOlXASc-72XYr8Mi8axpHEOc,4240
+langchain_community/document_transformers/doctran_text_qa.py,sha256=4-G-uOmArJrKcxcitPcosRbbboAsUUk_JrNKr7F03Qg,2155
+langchain_community/document_transformers/doctran_text_translate.py,sha256=mtBtl2LfKDOo5nbYKt73bPfZYXO7vaWWsmc8l20_4KY,2331
+langchain_community/document_transformers/embeddings_redundant_filter.py,sha256=bqiuV_4Au5kMvCNsoztGkcI9Sq8rlibzYs9GcevhVUo,7882
+langchain_community/document_transformers/google_translate.py,sha256=d6DmOkxg62QE7fq_1JCAMnkfWdX_vNOaaHms9sgA5Lo,4309
+langchain_community/document_transformers/html2text.py,sha256=A029mJz86lK2P2fP-HTQ29xVVq_xJ8nl7gXfI7pRq24,1834
+langchain_community/document_transformers/long_context_reorder.py,sha256=i8D2D1zE06mb35WgaIDUoS6QxsBv9UJYn5mnOz1WdWo,1437
+langchain_community/document_transformers/nuclia_text_transform.py,sha256=UOP07cwRqqTPpvWBnB_c6VS0wf4ZFOVcbVBP7MsRu2A,1500
+langchain_community/document_transformers/openai_functions.py,sha256=Sh7rp1Eq8MADpeY9YyKVnySKIt2cIC55e5VTH_RhrLU,6243
+langchain_community/document_transformers/xsl/html_chunks_with_headers.xslt,sha256=ti9sT_zWqZQf0aaeX5zT6tfHT1CuUpAVCvzoZWutE0o,6033
+langchain_community/embeddings/__init__.py,sha256=Ro__gNDiMUKENa6eHTtVYs-gxjkpYvzfJVAboXLv13k,16251
+langchain_community/embeddings/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/aleph_alpha.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/anyscale.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/awa.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/azure_openai.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/baichuan.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/bedrock.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/bookend.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/clarifai.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/cloudflare_workersai.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/cohere.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/dashscope.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/databricks.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/deepinfra.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/edenai.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/elasticsearch.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/embaas.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/ernie.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/fake.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/fastembed.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/gigachat.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/google_palm.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/gpt4all.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/gradient_ai.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/huggingface.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/huggingface_hub.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/infinity.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/infinity_local.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/itrex.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/javelin_ai_gateway.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/jina.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/johnsnowlabs.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/laser.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/llamacpp.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/llamafile.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/llm_rails.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/localai.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/minimax.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/mlflow.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/mlflow_gateway.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/modelscope_hub.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/mosaicml.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/nemo.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/nlpcloud.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/oci_generative_ai.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/octoai_embeddings.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/ollama.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/openai.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/openvino.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/optimum_intel.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/premai.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/sagemaker_endpoint.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/self_hosted.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/self_hosted_hugging_face.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/sentence_transformer.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/solar.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/spacy_embeddings.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/sparkllm.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/tensorflow_hub.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/text2vec.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/titan_takeoff.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/vertexai.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/volcengine.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/voyageai.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/xinference.cpython-311.pyc,,
+langchain_community/embeddings/__pycache__/yandex.cpython-311.pyc,,
+langchain_community/embeddings/aleph_alpha.py,sha256=maYBtdM7rwMzMa6Z8fk5XTrt2l1va209ZvTciRhpIRc,9610
+langchain_community/embeddings/anyscale.py,sha256=bFfKsOdKOuZukJptVC9tYrHwiI4bEcIKgNU0vJiabEI,2609
+langchain_community/embeddings/awa.py,sha256=DojCQP0NXmsKpsAp5UqyQbc4sGcSjn36gEnVT2sf5qg,1865
+langchain_community/embeddings/azure_openai.py,sha256=RoCeO52dQXVwvXnUVNTwk3BVXU3nWCSzZ2Vnbw9ZFA8,7239
+langchain_community/embeddings/baichuan.py,sha256=FyLeDTPB4dPHXI351UvrYwJZDsfkml9X6JwR3UQjRbM,4585
+langchain_community/embeddings/baidu_qianfan_endpoint.py,sha256=1fznS-Iih-LiVTCRdwYmvzvLebAGHGpmAvNx8H4uUwU,5201
+langchain_community/embeddings/bedrock.py,sha256=r_f8JhGOWt8ZwqoC51RnM_c-D_xVxyKWHpCCZqptGd0,7282
+langchain_community/embeddings/bookend.py,sha256=EuVMaSpo79-bux2jEOo3F2Udi20BmWLMygB4qT9pHh4,2725
+langchain_community/embeddings/clarifai.py,sha256=FnjOjQeklqh2bwGVEjyb70k0DddQKpUQfoU1B3zSj38,4677
+langchain_community/embeddings/cloudflare_workersai.py,sha256=7S-0cOORQJbH1xIx5tFjsr_yxZP84k7dUfl9bXX9Cg8,2869
+langchain_community/embeddings/cohere.py,sha256=pz0gYh97-FGl9lV7Z8Pia4dpUNn00TzCVO7fwQ5IWJw,5513
+langchain_community/embeddings/dashscope.py,sha256=n_VCrdH2iFzaBn8KINBjHhkf3ltZRYNhnWl4hXaOP3I,5216
+langchain_community/embeddings/databricks.py,sha256=7LMUe8XZfZQffMNTQCQYhz9f1XEUyTA5kRhoA4JkDlE,1271
+langchain_community/embeddings/deepinfra.py,sha256=Mdtq94FfMnRQa-NiAP_IGDPKyVCsWvNTdgJI9Y2dBIg,4426
+langchain_community/embeddings/edenai.py,sha256=o3ii1n_z9a6_HlZ-Q1jfrjKsB2xcE6qY8zX9-I4y1AE,3699
+langchain_community/embeddings/elasticsearch.py,sha256=keF6QNQvLFPKrKrZHho7hNCCno84qxJ4rtakXil0v5s,8546
+langchain_community/embeddings/embaas.py,sha256=uCdaxryemlqn0YgwDZE8ZHIP-_O1l9pditAYfnys4YQ,5528
+langchain_community/embeddings/ernie.py,sha256=HaXQSX_qjg1MHUio45Bpgov60cTuIS3FFvlUC6i7J_k,4997
+langchain_community/embeddings/fake.py,sha256=1RY_gFsZlx-hLpNXCsYxnFY6m5QSQvDDsL42DUU4Zd0,1512
+langchain_community/embeddings/fastembed.py,sha256=ERouFWv18yi7sEkRtXMrTzD9__ITNMySu-f1zjMGMCU,3770
+langchain_community/embeddings/gigachat.py,sha256=yIzD0y1a3j4BE__8N2PZ5flXohefjk0syePZJSDkYXc,5989
+langchain_community/embeddings/google_palm.py,sha256=jLaDgzn1Wq8bHgL-8ybgg8tLlJx2uPRh4l93zZ8xet8,3272
+langchain_community/embeddings/gpt4all.py,sha256=x5FwuTgZs_tdB7j4Kz7eT6Hh_oA7HdRTCkikDM79AcU,1664
+langchain_community/embeddings/gradient_ai.py,sha256=Ca8kwqoUq5Dp_B7zzPaKW-CsYUTwG0ATe4PvXH8ItGU,5306
+langchain_community/embeddings/huggingface.py,sha256=TYayycGWYwOSOQvlLg5Mu59ra32Ju7Nzw9eblVLg-h8,13500
+langchain_community/embeddings/huggingface_hub.py,sha256=syzhFmfYXaM5NklmB0sNxWdtJUT5-v8cZZn97HlMlfI,5078
+langchain_community/embeddings/infinity.py,sha256=l5TKLF8jjHwmgvN2efP5eLmnU2uarc5KDKZhtPEwAIQ,10254
+langchain_community/embeddings/infinity_local.py,sha256=GMKCUfBgSkQHbYCMqheYiARP8hPV5GLbaQgUkXesAP0,5196
+langchain_community/embeddings/itrex.py,sha256=SkzR9tiXHcLecsVOWIIVpf2UX655jUf3Hl0Kb5TQmPY,8168
+langchain_community/embeddings/javelin_ai_gateway.py,sha256=ZWTCdXldp6tGbeqs2SKsTQMVF0yi696g4H27t6OQ0Hg,3669
+langchain_community/embeddings/jina.py,sha256=OGncZcij9SEGOEhpHR1hDBVmtclWlvWtPCgkRvtAdyM,2607
+langchain_community/embeddings/johnsnowlabs.py,sha256=7SB5a99Oz23myenqiafaCjNgHkuTWIS_7yfJ2ZjUetY,2873
+langchain_community/embeddings/laser.py,sha256=RI6kI_mn0TYAVEKe8YUdOQ8gaes9I5pralKoB1Z5WmA,3064
+langchain_community/embeddings/llamacpp.py,sha256=irt-o6SDmfrSXl5145Gafqj8TVncVzuzAzDdnmz8sh0,4165
+langchain_community/embeddings/llamafile.py,sha256=AnPD00DXGqI6LFqc245ubiwVz7laIrE_Ry1fSqKabKM,4009
+langchain_community/embeddings/llm_rails.py,sha256=Fad5SkvDReXnAT73IiLE3t1TPd2BQAKUj6lkLOC3tNo,2321
+langchain_community/embeddings/localai.py,sha256=hxgB4XY5u6E70BGykon8ZSdiNgJtWqD-DakOqAL9xUM,12261
+langchain_community/embeddings/minimax.py,sha256=Xtdej8bFLjE7KWqZ-DP4z_0HCMWX74m7rtyLRLICZ24,4826
+langchain_community/embeddings/mlflow.py,sha256=EpD4nXvotY0wuxu__iiuaEeudX-SYyFzrrUcpZMTDb8,3047
+langchain_community/embeddings/mlflow_gateway.py,sha256=MMZa0ItELIVO6Kb2BPLg9JY-nJ324XQ5z6EhekKX2zY,2447
+langchain_community/embeddings/modelscope_hub.py,sha256=D7Wq1t9q3oRmo1T3VecVUSikWchp625iLib1tAOJr8I,2384
+langchain_community/embeddings/mosaicml.py,sha256=1iabVdVdefOKN6DXuy2nyM2oNj-6NQAWFfcnf-cnQw8,5115
+langchain_community/embeddings/nemo.py,sha256=RXcmxO-t7maXL8ULnuPou2LgTo1_WgI9aYZOmbyMmxI,5440
+langchain_community/embeddings/nlpcloud.py,sha256=Pc5AGPwtiNI342bflZ8z6O7fPSzCJ_oanwguX8DlpO4,2203
+langchain_community/embeddings/oci_generative_ai.py,sha256=DTw1PLDIJiS3LMHwxUid_69kjj3qLtkSLSqHpwiR2Gk,7023
+langchain_community/embeddings/octoai_embeddings.py,sha256=2FjUGWRQTl-vkQWoMIQJWriCXrS69KVEFcV4Lv_r7rY,3799
+langchain_community/embeddings/ollama.py,sha256=c9yT-k03-Li7llspNosQJHa_oieuRH0W0DsoJzUtzx8,7953
+langchain_community/embeddings/openai.py,sha256=BOuW3P5z2ZWDuE21BZkov0abBOGMtVxwmcoLW8xkVVI,29237
+langchain_community/embeddings/openvino.py,sha256=SoE_ij5yCvFLhP6GrXCA6lM9ND33RwLNzYmhLIZxAxw,12344
+langchain_community/embeddings/optimum_intel.py,sha256=Un-DoUXdTtSWNhVEu54IRLcdURjcPL9cCdm6tKn8cqQ,7653
+langchain_community/embeddings/premai.py,sha256=KTfPK9tRBmtaydw3ljLEkaBsYBNL_bq6J0-xTF7Upsw,4220
+langchain_community/embeddings/sagemaker_endpoint.py,sha256=LwxC49HyBWWzbFpwIGBU4QdUS5u--cUSCZjiQnC8F0M,7596
+langchain_community/embeddings/self_hosted.py,sha256=QLD8OJNEXhsia6U58FYYVttbBJoTj5r172Q_ra9JrL8,3807
+langchain_community/embeddings/self_hosted_hugging_face.py,sha256=8XxOBp-qz7Itpa2BVqGg8NX4JIgWCiOxXFQ0qn8LSW8,6583
+langchain_community/embeddings/sentence_transformer.py,sha256=eLvcq1uTai4vbAF1aHXcDTE5ABawHSiv3WJk53SdsvU,189
+langchain_community/embeddings/solar.py,sha256=d4vvRyJ-kgRbDYpeiK7MoTf7BPAtbfP1NCrCzc-M4_w,4282
+langchain_community/embeddings/spacy_embeddings.py,sha256=f-NWv4JGEaoH3aoHgcW8b9HJ7sO--FeUlaSRrTOuL0c,3955
+langchain_community/embeddings/sparkllm.py,sha256=DjA6RAVQw5LaY987tUAJbRHi5fjJf1jjkEJGp_hg24k,6904
+langchain_community/embeddings/tensorflow_hub.py,sha256=SDoWGI8AB6dEhD1bP811z-VrmdPPRaySOo4sV0m_Mnw,2413
+langchain_community/embeddings/text2vec.py,sha256=tbgIXTjfiPELYhvYAkGhBUOvCqMJ8Ii3pB-vDQRc1G8,2364
+langchain_community/embeddings/titan_takeoff.py,sha256=EsIUsvb1sUQ075ZAdz2IfXqVeFO5xHP90vGDoQjTLzc,7685
+langchain_community/embeddings/vertexai.py,sha256=duwanUSk4iUVg-9lO9ZN_y0MNZNmOl0spEzqJD40dVQ,14681
+langchain_community/embeddings/volcengine.py,sha256=sS6G4NU8t0NAkzPmfDCyHnmPUmHquLiaNuPt0TZh3P0,4198
+langchain_community/embeddings/voyageai.py,sha256=TDmmshj-linqqz6Kf8-dGbyTOqRWQHpwrNbA3gEjtsE,7487
+langchain_community/embeddings/xinference.py,sha256=fcsdpruhEkLzuKAdl72klIBHAt0_3kf5-PBB_cd4Xds,3303
+langchain_community/embeddings/yandex.py,sha256=AENPtqk64Aiq90kovpYcYzm8TMafZQIZt0eg-IYLHFo,7572
+langchain_community/example_selectors/__init__.py,sha256=IZMIDROwWGfy-7t02xQZbep0IRNzXtgTjlJd4jOKqpg,608
+langchain_community/example_selectors/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/example_selectors/__pycache__/ngram_overlap.cpython-311.pyc,,
+langchain_community/example_selectors/ngram_overlap.py,sha256=-vgyWMQoaCWPNsekzE-tLHgmoN-XD9rrwXzEsJlCJh4,3842
+langchain_community/graphs/__init__.py,sha256=WX6qPc1FLfMVoBOX-Hf_qdfMXEPBMKOwE5JSqQIHN3I,3220
+langchain_community/graphs/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/arangodb_graph.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/falkordb_graph.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/graph_document.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/graph_store.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/gremlin_graph.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/hugegraph.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/kuzu_graph.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/memgraph_graph.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/nebula_graph.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/neo4j_graph.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/neptune_graph.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/neptune_rdf_graph.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/networkx_graph.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/ontotext_graphdb_graph.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/rdf_graph.cpython-311.pyc,,
+langchain_community/graphs/__pycache__/tigergraph_graph.cpython-311.pyc,,
+langchain_community/graphs/arangodb_graph.py,sha256=vveJFSZ133LCAduWqyQCD43RxuBlqnf2iaPJNanLhbY,6961
+langchain_community/graphs/falkordb_graph.py,sha256=kJW_yB6BaUnwX9ghAM1N1YG_EpUup_FBiw2BYs9Tspc,6951
+langchain_community/graphs/graph_document.py,sha256=Ub2dqa4YXaXAIo1hPiZP-rFBEZZj9ptQVNz6-jDrjFQ,1584
+langchain_community/graphs/graph_store.py,sha256=sBum5vYQQajc8RhwLAHhvUbunAJp5rE1cgt_YCNNahE,1008
+langchain_community/graphs/gremlin_graph.py,sha256=1ayqOC0O6exUlGe5v26YZz9VFCsggtDVvlQ3J_mbPQM,8187
+langchain_community/graphs/hugegraph.py,sha256=RpjugQf4s4I-bsbiYvnLzHMur53MDMtbjCTjQ-B8iNM,2510
+langchain_community/graphs/kuzu_graph.py,sha256=vrx6LZs8SNVV0I7aNt8B6kLv_BBzdGNtiMiAEnljby0,3918
+langchain_community/graphs/memgraph_graph.py,sha256=RYwW7HHI5hc7SsT2cDbMtTTEKY1hUsm9hUDv6pjS5OA,2575
+langchain_community/graphs/nebula_graph.py,sha256=kTe6THKH2DWbUxu6uwwm9sNDLhNxI0D0B7ILThTYF2Y,8112
+langchain_community/graphs/neo4j_graph.py,sha256=LJi9kYc2sh7u1AcBlAT--rOsLokUp2leinthWoXKgr0,15890
+langchain_community/graphs/neptune_graph.py,sha256=sqkrYER3ud-X5INlArzz8TFS2Y0HX3xU0yidQCUJpoQ,14347
+langchain_community/graphs/neptune_rdf_graph.py,sha256=ljowExa4oHBxIUtb_Ww15ft0fu_SKKqty7vvEGFEcm8,10331
+langchain_community/graphs/networkx_graph.py,sha256=GjrTx0v3ch0P5j4Oycr50G13t6P05VZzzzjxt_3oUvw,7896
+langchain_community/graphs/ontotext_graphdb_graph.py,sha256=qDVuze1HOGl4Jf_tsGDyonFHpILDvLd2Shwixvg0s64,7645
+langchain_community/graphs/rdf_graph.py,sha256=XoCyPzkL8cV4uJOCb4noOiOBVqZVZ78tRLHg1lZtLTQ,10294
+langchain_community/graphs/tigergraph_graph.py,sha256=t1lve66V-IeSiZ9SMdyfApPUoaXzlBzWVJl3wVb-Y2o,3319
+langchain_community/indexes/__init__.py,sha256=RDI_w1cj4HyHD9R37q6UnfcvrK4rGZ5oN2_xkN6vetw,488
+langchain_community/indexes/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/indexes/__pycache__/_document_manager.cpython-311.pyc,,
+langchain_community/indexes/__pycache__/_sql_record_manager.cpython-311.pyc,,
+langchain_community/indexes/__pycache__/base.cpython-311.pyc,,
+langchain_community/indexes/_document_manager.py,sha256=z5PMRLiy9gqRJVn7hdRbK9rYQEDNxY0b9t3M0_QiHpY,8199
+langchain_community/indexes/_sql_record_manager.py,sha256=G13XqPGEiAVPRnqhCCaE4zjh3USa74bqHsUz8wmsTy8,20960
+langchain_community/indexes/base.py,sha256=ivoDqzrV7b90LGJ_GJcu-J7WNhpYFP7iaHa6szbpHkw,5191
+langchain_community/llms/__init__.py,sha256=L-jbxO9LTzt9lGx6BPa_4E8e3MYtpd1FdzW8pz_2apw,27228
+langchain_community/llms/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/llms/__pycache__/ai21.cpython-311.pyc,,
+langchain_community/llms/__pycache__/aleph_alpha.cpython-311.pyc,,
+langchain_community/llms/__pycache__/amazon_api_gateway.cpython-311.pyc,,
+langchain_community/llms/__pycache__/anthropic.cpython-311.pyc,,
+langchain_community/llms/__pycache__/anyscale.cpython-311.pyc,,
+langchain_community/llms/__pycache__/aphrodite.cpython-311.pyc,,
+langchain_community/llms/__pycache__/arcee.cpython-311.pyc,,
+langchain_community/llms/__pycache__/aviary.cpython-311.pyc,,
+langchain_community/llms/__pycache__/azureml_endpoint.cpython-311.pyc,,
+langchain_community/llms/__pycache__/baichuan.cpython-311.pyc,,
+langchain_community/llms/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc,,
+langchain_community/llms/__pycache__/bananadev.cpython-311.pyc,,
+langchain_community/llms/__pycache__/baseten.cpython-311.pyc,,
+langchain_community/llms/__pycache__/beam.cpython-311.pyc,,
+langchain_community/llms/__pycache__/bedrock.cpython-311.pyc,,
+langchain_community/llms/__pycache__/bigdl_llm.cpython-311.pyc,,
+langchain_community/llms/__pycache__/bittensor.cpython-311.pyc,,
+langchain_community/llms/__pycache__/cerebriumai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/chatglm.cpython-311.pyc,,
+langchain_community/llms/__pycache__/chatglm3.cpython-311.pyc,,
+langchain_community/llms/__pycache__/clarifai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/cloudflare_workersai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/cohere.cpython-311.pyc,,
+langchain_community/llms/__pycache__/ctransformers.cpython-311.pyc,,
+langchain_community/llms/__pycache__/ctranslate2.cpython-311.pyc,,
+langchain_community/llms/__pycache__/databricks.cpython-311.pyc,,
+langchain_community/llms/__pycache__/deepinfra.cpython-311.pyc,,
+langchain_community/llms/__pycache__/deepsparse.cpython-311.pyc,,
+langchain_community/llms/__pycache__/edenai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/fake.cpython-311.pyc,,
+langchain_community/llms/__pycache__/fireworks.cpython-311.pyc,,
+langchain_community/llms/__pycache__/forefrontai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/friendli.cpython-311.pyc,,
+langchain_community/llms/__pycache__/gigachat.cpython-311.pyc,,
+langchain_community/llms/__pycache__/google_palm.cpython-311.pyc,,
+langchain_community/llms/__pycache__/gooseai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/gpt4all.cpython-311.pyc,,
+langchain_community/llms/__pycache__/gradient_ai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/huggingface_endpoint.cpython-311.pyc,,
+langchain_community/llms/__pycache__/huggingface_hub.cpython-311.pyc,,
+langchain_community/llms/__pycache__/huggingface_pipeline.cpython-311.pyc,,
+langchain_community/llms/__pycache__/huggingface_text_gen_inference.cpython-311.pyc,,
+langchain_community/llms/__pycache__/human.cpython-311.pyc,,
+langchain_community/llms/__pycache__/ipex_llm.cpython-311.pyc,,
+langchain_community/llms/__pycache__/javelin_ai_gateway.cpython-311.pyc,,
+langchain_community/llms/__pycache__/koboldai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/konko.cpython-311.pyc,,
+langchain_community/llms/__pycache__/layerup_security.cpython-311.pyc,,
+langchain_community/llms/__pycache__/llamacpp.cpython-311.pyc,,
+langchain_community/llms/__pycache__/llamafile.cpython-311.pyc,,
+langchain_community/llms/__pycache__/loading.cpython-311.pyc,,
+langchain_community/llms/__pycache__/manifest.cpython-311.pyc,,
+langchain_community/llms/__pycache__/minimax.cpython-311.pyc,,
+langchain_community/llms/__pycache__/mlflow.cpython-311.pyc,,
+langchain_community/llms/__pycache__/mlflow_ai_gateway.cpython-311.pyc,,
+langchain_community/llms/__pycache__/mlx_pipeline.cpython-311.pyc,,
+langchain_community/llms/__pycache__/modal.cpython-311.pyc,,
+langchain_community/llms/__pycache__/moonshot.cpython-311.pyc,,
+langchain_community/llms/__pycache__/mosaicml.cpython-311.pyc,,
+langchain_community/llms/__pycache__/nlpcloud.cpython-311.pyc,,
+langchain_community/llms/__pycache__/oci_data_science_model_deployment_endpoint.cpython-311.pyc,,
+langchain_community/llms/__pycache__/oci_generative_ai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/octoai_endpoint.cpython-311.pyc,,
+langchain_community/llms/__pycache__/ollama.cpython-311.pyc,,
+langchain_community/llms/__pycache__/opaqueprompts.cpython-311.pyc,,
+langchain_community/llms/__pycache__/openai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/openllm.cpython-311.pyc,,
+langchain_community/llms/__pycache__/openlm.cpython-311.pyc,,
+langchain_community/llms/__pycache__/pai_eas_endpoint.cpython-311.pyc,,
+langchain_community/llms/__pycache__/petals.cpython-311.pyc,,
+langchain_community/llms/__pycache__/pipelineai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/predibase.cpython-311.pyc,,
+langchain_community/llms/__pycache__/predictionguard.cpython-311.pyc,,
+langchain_community/llms/__pycache__/promptlayer_openai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/replicate.cpython-311.pyc,,
+langchain_community/llms/__pycache__/rwkv.cpython-311.pyc,,
+langchain_community/llms/__pycache__/sagemaker_endpoint.cpython-311.pyc,,
+langchain_community/llms/__pycache__/self_hosted.cpython-311.pyc,,
+langchain_community/llms/__pycache__/self_hosted_hugging_face.cpython-311.pyc,,
+langchain_community/llms/__pycache__/solar.cpython-311.pyc,,
+langchain_community/llms/__pycache__/sparkllm.cpython-311.pyc,,
+langchain_community/llms/__pycache__/stochasticai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/symblai_nebula.cpython-311.pyc,,
+langchain_community/llms/__pycache__/textgen.cpython-311.pyc,,
+langchain_community/llms/__pycache__/titan_takeoff.cpython-311.pyc,,
+langchain_community/llms/__pycache__/together.cpython-311.pyc,,
+langchain_community/llms/__pycache__/tongyi.cpython-311.pyc,,
+langchain_community/llms/__pycache__/utils.cpython-311.pyc,,
+langchain_community/llms/__pycache__/vertexai.cpython-311.pyc,,
+langchain_community/llms/__pycache__/vllm.cpython-311.pyc,,
+langchain_community/llms/__pycache__/volcengine_maas.cpython-311.pyc,,
+langchain_community/llms/__pycache__/watsonxllm.cpython-311.pyc,,
+langchain_community/llms/__pycache__/weight_only_quantization.cpython-311.pyc,,
+langchain_community/llms/__pycache__/writer.cpython-311.pyc,,
+langchain_community/llms/__pycache__/xinference.cpython-311.pyc,,
+langchain_community/llms/__pycache__/yandex.cpython-311.pyc,,
+langchain_community/llms/__pycache__/yuan2.cpython-311.pyc,,
+langchain_community/llms/ai21.py,sha256=6AjUcEXVXRNlpWf2vZauJOBjWy-hpp0HgtaELQC5rWQ,5292
+langchain_community/llms/aleph_alpha.py,sha256=B7MAQaglkYLYNfEwwjsrw1LgnY-RHLRVkp-IWMWUlAM,11507
+langchain_community/llms/amazon_api_gateway.py,sha256=Qu_tvSC0bouOXBH6D0kzQRz7_IP0sDvPPhTvZm_ITOE,3061
+langchain_community/llms/anthropic.py,sha256=kcHrCUCQSbLKxou7etxERJWNW0kbTLVJWqBWD0X0lJ4,12739
+langchain_community/llms/anyscale.py,sha256=6uQJBczVpLisEpXmLRZ4F6moTVbHriaUk_qzzSguks0,11923
+langchain_community/llms/aphrodite.py,sha256=Qzf5B32m6tqpmEFdhGjaCyaJaiH5BQSlXirQ3mKluuc,9619
+langchain_community/llms/arcee.py,sha256=fIimvDvOJHqHs1ZhQsE4S6ZJC0H4JcUOjVACf24Ln6o,4356
+langchain_community/llms/aviary.py,sha256=DB8rW04ZXyw55zSGNk3zgNNNk7xBcHZK9GmPdrXo8Zw,6007
+langchain_community/llms/azureml_endpoint.py,sha256=zk9z1rXE1cknGCRu5rkzvbEbhoPCk-KDTmvPc-JLQgo,20610
+langchain_community/llms/baichuan.py,sha256=3an8_ZMZydjr1c3SYslnQThYNHIssApuhXgvdbv0syE,3066
+langchain_community/llms/baidu_qianfan_endpoint.py,sha256=S5jyG-yQ8N8C4RaznEuPmowkSc0_B11KxR89Uk6wNg8,7722
+langchain_community/llms/bananadev.py,sha256=9_yR1nSQB8rV8Kd-OGmOyBgFvBQwBLGQ6binowC58Ds,4830
+langchain_community/llms/baseten.py,sha256=Qvh0jcwD49uiPP9Rswxlh3ulVlhGgdxIBCALjPhuFnI,3187
+langchain_community/llms/beam.py,sha256=mhucsuwMhOeVzsHj9aydzEI_nhfVgc8NbXV0VELGfNo,9113
+langchain_community/llms/bedrock.py,sha256=dt7tdrdEC_i7Eu7uhSBdF9OW4r08qL6lRj5y2R-A5z4,31560
+langchain_community/llms/bigdl_llm.py,sha256=gEYJNEBrW5EZFF701o3XV8YdC7vGf5q9z64wD1BYuQQ,4351
+langchain_community/llms/bittensor.py,sha256=dcYwQ4p4FK8uB4DeuBatiufmTTrsbI5uRZ-g0FNy1MQ,6232
+langchain_community/llms/cerebriumai.py,sha256=7ApD-5bnCdvzVbC2oGOhDwkX7Ea8ZHv0gLve1rDT7wQ,4044
+langchain_community/llms/chatglm.py,sha256=wiWtq6Ya6MIq6JyR5J8rt5KOjzRdNUVnMVR1BsuHZ-k,3943
+langchain_community/llms/chatglm3.py,sha256=u-S7r_N6XebaQ-qxg3pjXq-35sm177dVoOFIt0Inlzg,4877
+langchain_community/llms/clarifai.py,sha256=9yeZ5P26pW3EZIUtoT8tqIN_dXJqQKej-RR0_5ElyW8,6571
+langchain_community/llms/cloudflare_workersai.py,sha256=3eIau2AbBGyyi0NKiMF77IZoDjD7I6wCqsWlZitmLs4,4239
+langchain_community/llms/cohere.py,sha256=RmbF_vERU0gBqyuEk_ba9aORctRUYVC4XF_sHLqdrM8,8709
+langchain_community/llms/ctransformers.py,sha256=vwDlb4AnVjocz6zemQYLIb3OQqYYxAjDrS2pLqXw_Qc,4227
+langchain_community/llms/ctranslate2.py,sha256=WmOVnI5-3sQOU4gsKHTxh2OmfMOj7itwgCkcrKBm578,4135
+langchain_community/llms/databricks.py,sha256=IRnHDBKuZaVByKdtkBsCYYwQXIhFKjs5KtVjUX0cWoo,20509
+langchain_community/llms/deepinfra.py,sha256=dvRRwUBDPOAt829upm2roaRqpN_uXhFV0kyWp92xmJM,7006
+langchain_community/llms/deepsparse.py,sha256=HGrOJ12Uc7PR2Unlpf_Bn8EiO4l4gZOLx6OxyM9_mUY,8643
+langchain_community/llms/edenai.py,sha256=cI3a265jISNDTm3gKE0lAND7AOtHtSUMNPVG-nMaXlA,9448
+langchain_community/llms/fake.py,sha256=JrJXZXwH4IRTQrmyoR4G78VAUBlcKiwqeFs_LBAQ4FE,2444
+langchain_community/llms/fireworks.py,sha256=zpqEZ6dAVA-eIK9btEou7BQ-JMDmwWZb2J3rson0aj0,11938
+langchain_community/llms/forefrontai.py,sha256=0Vji7B71o_yf_4twm-0kQ1YJXpTvdiiJEKgVxrWYfxI,3762
+langchain_community/llms/friendli.py,sha256=L939yC39ix-Jdzj6_PVG5JxJy_Js3YKekpLmFVHSLLY,14570
+langchain_community/llms/gigachat.py,sha256=122qcdzBi4kcNb0iZW3-Imlvsga4JMykX2eFhmyD5pc,11659
+langchain_community/llms/google_palm.py,sha256=13iZbSbwY6RKvifG3HaJloVC0Y-HPwclPSMyNYuHng0,8860
+langchain_community/llms/gooseai.py,sha256=yVN0jVkolCqdCr6_qXgsIlQlFyxQhQ9R0CayxTX3ZhY,5301
+langchain_community/llms/gpt4all.py,sha256=2ghS4xON7w9MxpBt7ZC3Z1X458tE3C1dYB-U9fYVpRg,6591
+langchain_community/llms/gradient_ai.py,sha256=enRlC2rLFoLS3HHlTJz6XRKlBHWAYGBp1oUzXfMV4uU,14199
+langchain_community/llms/grammars/json.gbnf,sha256=htDQy5F1h7Q6K9kuc1j7a_LUw8Dhj-_rhQc28OJqluQ,664
+langchain_community/llms/grammars/list.gbnf,sha256=9cg8vDmOQ-jZvKSj-hyvTUl05Igbw_416yRQnB2VqcA,167
+langchain_community/llms/huggingface_endpoint.py,sha256=GMbMiIp62YYVif_r0Y8xIOEHQn0m0FiX1czeLKDddS0,14166
+langchain_community/llms/huggingface_hub.py,sha256=DiPu9i1X0gvf7Zfi3deOa-m26JzrFOzMDibejFYqIlU,5381
+langchain_community/llms/huggingface_pipeline.py,sha256=ON5zy4KuN1kEDoceJ0xMvFkRlrZuIPguETShCNMNMd4,10928
+langchain_community/llms/huggingface_text_gen_inference.py,sha256=xfk65u4Pfss1Oid8MUMEAlPyl_9HZKhcVizWThxp9nc,11639
+langchain_community/llms/human.py,sha256=hI7evP0xrRLRLWgKbI8_a0rxgONkdgEOE4oVSP_BvTo,2575
+langchain_community/llms/ipex_llm.py,sha256=KzPtuIUklnWcz7NktwBtKxQBdFj3O49fh27sb0LmeXE,7133
+langchain_community/llms/javelin_ai_gateway.py,sha256=Sjf-mj0jg-NYpUvwYdpotu-2vBdYBL5QSJtYG98NBpA,4723
+langchain_community/llms/koboldai.py,sha256=EGvR9fUvvs8afmGZBKKyeV4vYC7dyLwc0kiyjMk5aB8,5087
+langchain_community/llms/konko.py,sha256=enBt1OxFSbyQ7ImGqv0VACCXz0y0eO_4mk8gtNhqatc,6553
+langchain_community/llms/layerup_security.py,sha256=QFAKhxwJmEz3JdJeXidG8g2FMXYfjpssUG-sXeC4zvo,3461
+langchain_community/llms/llamacpp.py,sha256=vJGB0jhelVqxEPqYPUhmFqOXkU2f9HCMOzFF4B25sgQ,12469
+langchain_community/llms/llamafile.py,sha256=pyJCs_ACNcUu3EM8ygxhtgf7NX8jz8PZu7zglrkVqrU,10386
+langchain_community/llms/loading.py,sha256=iBesSZBUZUfkYdnUVzZpq1mkrU5o_jFUswCqWw3O5TE,1709
+langchain_community/llms/manifest.py,sha256=zcUPiOTyH3ZIKOBQBuoYXDdq-cnNwZL9pPlgFwJYmNE,1965
+langchain_community/llms/minimax.py,sha256=qA1ztf_rakoFIp3MEh_QCVDrEyGTvdWXedsjXm5XDPY,5470
+langchain_community/llms/mlflow.py,sha256=1uoofEkPmt-A_DQmygVBS2sqXTVQ0zD6OQJr0h2wBCE,3431
+langchain_community/llms/mlflow_ai_gateway.py,sha256=aBShc8dXL8t0l-bp8moou65Y9BZo4YtQAdzJDppx4hc,3240
+langchain_community/llms/mlx_pipeline.py,sha256=mEy4hA30OJpUexbwAcMKHlkUCtH8dl7UAJc1YWI8fgg,6251
+langchain_community/llms/modal.py,sha256=p4oDjI8iKhnSZm6ooQvtjDXnz-0-kV_lVjoXAdNeBgo,3288
+langchain_community/llms/moonshot.py,sha256=_WGLTNAMWS5v2uuAckUy2k6TSt_9XwrC2XVwMtgfWJI,4619
+langchain_community/llms/mosaicml.py,sha256=xZJ__JjaPJjOBxVTcmRdEsXQ14JX9Y7gYXse-QlWsCg,6150
+langchain_community/llms/nlpcloud.py,sha256=BLiwdySYVpoZCK1CeeNx3mJdIvi06899btqkQuOx_UU,5053
+langchain_community/llms/oci_data_science_model_deployment_endpoint.py,sha256=hE6xmQn_iiGkYlrL2F2lHy4em3oioTFpmatQRkMV1-s,12182
+langchain_community/llms/oci_generative_ai.py,sha256=ybNPuR6kYGEUmtniGOD7-kTSzbc-quJIEMyfQCr3szY,9406
+langchain_community/llms/octoai_endpoint.py,sha256=kKUcTvRLLGfjLTctq5MTfeoSXRYNYTo4miJaXDQ9-nA,3909
+langchain_community/llms/ollama.py,sha256=AiaLIIaydk7OVu2qe7VvfVFz1PpbHMki8fsAjXvWLX8,17571
+langchain_community/llms/opaqueprompts.py,sha256=5WfcV4GgWFH_WiP3BBQXpCPa85L3BcLi2xELPUY4-eI,4103
+langchain_community/llms/openai.py,sha256=wz85YLtS6vq6grM0R3DXsHV3IRFmg3hxp4MCJSFyuPk,47742
+langchain_community/llms/openllm.py,sha256=5QUnyE7bq5fcqksNjkwF05VwJZQphw1QXv8D-lY5lpg,11003
+langchain_community/llms/openlm.py,sha256=XMTIbw91Bzyh1Yn0-3Ip0mYwcifYnMLYN1P-C6lNRms,902
+langchain_community/llms/pai_eas_endpoint.py,sha256=37fh21yx78Nb5IdpqhzyrMjus4FU1j5D2_CUYfNF7iY,8059
+langchain_community/llms/petals.py,sha256=u8VqMmHtapWn2vLVDyjn31ij-hzgSQbH3bCBz48yunA,5402
+langchain_community/llms/pipelineai.py,sha256=ibqQbLN0ILrGTbET5VCKKgoNzrlybAWn8WUJWDIbPdQ,4210
+langchain_community/llms/predibase.py,sha256=9iGgEfuTSr9XT4KHwYIcA7HLARtBjJMRQ5CM5AzKRF0,4284
+langchain_community/llms/predictionguard.py,sha256=aQJaNM-4AiFaCoknBkPd2entzBl_r90a7lqIfjOix2E,4410
+langchain_community/llms/promptlayer_openai.py,sha256=ORhAqHmALf86-UKsjjg4t-_40zW7Moa9KtJdKBWy3T4,8806
+langchain_community/llms/replicate.py,sha256=0GTD29B0nWNH-tdAUaQrr-JMgHvwpg2DAoMSNiFfVLo,8392
+langchain_community/llms/rwkv.py,sha256=JNW4SW20LHqNQwZhOF84_NCNAFdWnLzyBHc_5cUSsLs,7387
+langchain_community/llms/sagemaker_endpoint.py,sha256=uMERjWJCWBpcePTaRVokWyp_BmUPNYHghRxr4YKTYyg,13165
+langchain_community/llms/self_hosted.py,sha256=DeDcvUD4m_fVAuqHpggRHImGlG0Jv0ZZZ6iT9f4uTwM,8477
+langchain_community/llms/self_hosted_hugging_face.py,sha256=YWizJoD20YBblj150-m4APTbl8Yf9dvxth_76k4sTI0,7743
+langchain_community/llms/solar.py,sha256=0CqBLxkmOkGeJled-1y9JRq_at0hbfW7xiaxDYQ__2Q,4107
+langchain_community/llms/sparkllm.py,sha256=0KFF0Y2-hEl0xJff1qJkX7cU1xkDLxptQRWsalNKkVA,12481
+langchain_community/llms/stochasticai.py,sha256=hqAC1VtneTpc8cbqvA6q9UfP4qq8zBNGhezLLvY6h3k,4776
+langchain_community/llms/symblai_nebula.py,sha256=0W0WESmbIPDJD5cLSMO7zTmFsd4H1z24xd6KdT8Q94Y,7552
+langchain_community/llms/textgen.py,sha256=O74QYsBeVRvO_UIRqRy1Sh47YzUNunaUxZ9xLu3Zxqs,14137
+langchain_community/llms/titan_takeoff.py,sha256=eMUN9kYYuWvtIJZ064Zzhv1dN_7HQZsF5jBJVoncDFc,9204
+langchain_community/llms/together.py,sha256=BTOK-VsVUMNUDEgaIC0h7AgTvykmae56-MMexEKAdGU,7680
+langchain_community/llms/tongyi.py,sha256=ooAyKzMpfdDiUPz_FIYDx3_YGnXmNdRi_Wcq-BRHl9Y,13132
+langchain_community/llms/utils.py,sha256=rL-2vYG_9cNuge663FmaIPAjDq2MV8A9xuPQTMj45_k,258
+langchain_community/llms/vertexai.py,sha256=KMqN0aBojSammNz0IVgAayNwkLYlPziDJ6BuGnxdVX0,19304
+langchain_community/llms/vllm.py,sha256=1EZOkxSJFcVjF-aRXE_sv5lvD3PGeM4XOQg2049E3II,5592
+langchain_community/llms/volcengine_maas.py,sha256=kW1D3rm-A2UfGWkU84xGfcNJkhOpgyG5687tMgwFmJU,6591
+langchain_community/llms/watsonxllm.py,sha256=O1jOkNqZaXByBok2pMW278NEljviALRvNNRfHIFvyuI,15078
+langchain_community/llms/weight_only_quantization.py,sha256=cn77IPwsruuzUcIKUFhhaby7kwCbPw--cRzS5f0M3_s,8915
+langchain_community/llms/writer.py,sha256=rMLED6mkihTY9H6hooo50LrfDhWKfVImVdE3Auv2i_w,4970
+langchain_community/llms/xinference.py,sha256=2fnOXawQxKFn1Oe19pTymcPPcpYroaDlChmC8TfdN2g,6325
+langchain_community/llms/yandex.py,sha256=apsREBDKrtu0QdjGNgAY_g8YQrLCG8kAEvzIxpjd9z8,12614
+langchain_community/llms/yuan2.py,sha256=BJF3xIMRHbX9HkVcpU01WnY2waT1R_ecRddrZvD6mv8,5954
+langchain_community/output_parsers/__init__.py,sha256=GyTxvY9uZ3JfWnXyMrOjLxCeiFGtJ16L3HLbBSaq2xs,292
+langchain_community/output_parsers/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/output_parsers/__pycache__/ernie_functions.cpython-311.pyc,,
+langchain_community/output_parsers/__pycache__/rail_parser.cpython-311.pyc,,
+langchain_community/output_parsers/ernie_functions.py,sha256=gQ0gnwHiQZDAyXFwfchLrXNwygthANOARHjJExrZDBY,6701
+langchain_community/output_parsers/rail_parser.py,sha256=Sbz5nPOk7L2I31p54V5BsNkmAQeh_wNc2NZl7_Z7a9U,3283
+langchain_community/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_community/retrievers/__init__.py,sha256=v5Znloo_GpzdZNAwt1IZaa_BYXEbKa1dXJ3PO758sFw,9209
+langchain_community/retrievers/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/arcee.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/arxiv.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/azure_ai_search.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/bedrock.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/bm25.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/breebs.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/chaindesk.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/chatgpt_plugin_retriever.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/cohere_rag_retriever.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/databerry.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/docarray.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/dria_index.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/elastic_search_bm25.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/embedchain.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/google_cloud_documentai_warehouse.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/google_vertex_ai_search.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/kay.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/kendra.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/knn.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/llama_index.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/metal.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/milvus.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/outline.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/pinecone_hybrid_search.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/pubmed.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/pupmed.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/qdrant_sparse_vector_retriever.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/remote_retriever.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/svm.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/tavily_search_api.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/tfidf.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/thirdai_neuraldb.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/vespa_retriever.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/weaviate_hybrid_search.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/wikipedia.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/you.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/zep.cpython-311.pyc,,
+langchain_community/retrievers/__pycache__/zilliz.cpython-311.pyc,,
+langchain_community/retrievers/arcee.py,sha256=g-iK8wUOmqGxb8fN4GdtaX6omLiU7d9KJf7rrqA9obU,4313
+langchain_community/retrievers/arxiv.py,sha256=0MrEvE1hVb4ZNJ2CA9QTZJFmipiMlFM2jn_XlMbRKoI,773
+langchain_community/retrievers/azure_ai_search.py,sha256=WNi3_OXyjLytX8g1nqBllJXXcnrpYREbsKYqo9uJ2tE,5098
+langchain_community/retrievers/bedrock.py,sha256=6McVmJFJuK1xkAQzsgldrft82M2Arzov83YHdQSvwTQ,4691
+langchain_community/retrievers/bm25.py,sha256=1QANOinNJieWVQofUuHoRj4hE7StnhbslPpbM7pSZ9U,3713
+langchain_community/retrievers/breebs.py,sha256=ijhyRO-KIdD6kpggFzAzfqUxwi5f8xgmA8OY-TwrFbU,1524
+langchain_community/retrievers/chaindesk.py,sha256=PY_eX5NxKHjDX4u5kLRsL1MyulKJZ28mnPjKymUpnMU,2684
+langchain_community/retrievers/chatgpt_plugin_retriever.py,sha256=2eycSBBWwZSNbxn6jGgvqK4V4HyQ62XxA9BKqBs-Pns,3024
+langchain_community/retrievers/cohere_rag_retriever.py,sha256=fZ2IxJX2E7iZcxefjaBhUNs1tTDo7DrhZiJp9sXlN6I,3088
+langchain_community/retrievers/databerry.py,sha256=g5wr_PURwFdlIq08uuztmXwvqSe8TUKULhpkGiBbJfo,2338
+langchain_community/retrievers/docarray.py,sha256=TbDQKdo0KYVID8lK792G1EzpdABTZwOd9w5NzGwcCXU,6778
+langchain_community/retrievers/dria_index.py,sha256=VEjcuRwbn3KvrdmPKvHy-9lT_gNJlpMusOegptMrJPI,2763
+langchain_community/retrievers/elastic_search_bm25.py,sha256=RffHvuSTqKf518u26ZpQGXDCyqhcr0CHIdKh5bzxnCA,4639
+langchain_community/retrievers/embedchain.py,sha256=FwPza4guaQLfe1z0bcipoAHpos6BEC8lgfsTok2Qvg4,2087
+langchain_community/retrievers/google_cloud_documentai_warehouse.py,sha256=O5nj8O_h1_OtuEwAHBH2v-756GP-OKyd8ABYlhFvIOI,4777
+langchain_community/retrievers/google_vertex_ai_search.py,sha256=0qQqnzCrC9W8aywu3QYrOpfilrLUNhwidC8xnvrYXeA,18798
+langchain_community/retrievers/kay.py,sha256=SMlMr3QEbZTkISBWpY1W6hcu-5Mk9axjBEw2h6bgoq8,1985
+langchain_community/retrievers/kendra.py,sha256=S5hceXaAtxgczUdI16Z_Kh_rPD52-hy5YZWfLbMQAGw,15189
+langchain_community/retrievers/knn.py,sha256=kkzJjW15rqlldyxd7lB_xDtuqVFZJk4p_0TwLzDwYGw,3323
+langchain_community/retrievers/llama_index.py,sha256=89m9P7CMmmt-4B2wcdVAor7P-5SWEEfsaEcVkyoIkjI,3166
+langchain_community/retrievers/metal.py,sha256=GFkxeX2RWG_Qpx_f8hv5hWQZCsaJ5eJXWkGE2kLVU2Q,1486
+langchain_community/retrievers/milvus.py,sha256=-kCocxem3sQgloV_oxA4CFmIGVFK-OkpBKyyD7OZqhM,2539
+langchain_community/retrievers/outline.py,sha256=J6D1WFLhhob6zowA6dBwDYC2wfb3MdMnA13qimqCFkg,644
+langchain_community/retrievers/pinecone_hybrid_search.py,sha256=rGUnWJjl-S_U_47Ml-ZYcrAKwrbEppwa9I2Q-XDu-zs,5733
+langchain_community/retrievers/pubmed.py,sha256=PfwAY12pKzLiGxQtsM6i3vdod-QjxfLaQ9NaJta_BqU,643
+langchain_community/retrievers/pupmed.py,sha256=1mLaWJRf0qDJf-jWXoUJoFNtLXJGGnhTHAPAqc4LxQA,104
+langchain_community/retrievers/qdrant_sparse_vector_retriever.py,sha256=fK_RwWLNAKjO9d8wgRzV0XD9V4Lw8ciBraWhtw32gmU,7539
+langchain_community/retrievers/remote_retriever.py,sha256=BuseP2s-em_mtLduTfdU2uei7jF7DmfHusoaGuIhe3A,1935
+langchain_community/retrievers/svm.py,sha256=T-nBVg3dRDYO86D2T9l8-J4lhfGRDVkyO6po1kcpDW8,4131
+langchain_community/retrievers/tavily_search_api.py,sha256=00CJeizdeh_gxfVd8wGB_GpPzXvtSwoI0sAXtTOSWXE,2855
+langchain_community/retrievers/tfidf.py,sha256=6vBOQzDdBnvpv8T8vAjagE0MKd2iCtM-Pf3TKLtzP44,5573
+langchain_community/retrievers/thirdai_neuraldb.py,sha256=WdQFke5-bWndDkpIumHzMTj3VhPjTl4oMddiwrR5BNY,9328
+langchain_community/retrievers/vespa_retriever.py,sha256=GsviEeLkWUaAhOjY8HqowUXLNqb1kRkEZS-sF6xxoxk,4555
+langchain_community/retrievers/weaviate_hybrid_search.py,sha256=BXx8LvT0dwObf5Hy3sB2fPLkrDYqOZ0pV6CZNI-c_7c,6195
+langchain_community/retrievers/wikipedia.py,sha256=U2YMojxWYsektnMAnG_kqOgEvrJdmpd6iE8PM6vcSnI,656
+langchain_community/retrievers/you.py,sha256=uf5Xgd6gUY4Ph4Sbj32q-Eb-SbhxJW95Kj2sByxNcxc,1124
+langchain_community/retrievers/zep.py,sha256=TIE-wdXbmPLJ9ZVKnx0bUlbNEQe6jUs3zgHMf19jcso,5904
+langchain_community/retrievers/zilliz.py,sha256=toK9OYtTP4tBkUUeRGWYvv6VQLM45UasO3i2NCat0wQ,2735
+langchain_community/storage/__init__.py,sha256=KTCTc9Dp6BDnPZe37TGUQqC8aILtpF8nqCzRHxDowes,1741
+langchain_community/storage/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/storage/__pycache__/astradb.cpython-311.pyc,,
+langchain_community/storage/__pycache__/exceptions.cpython-311.pyc,,
+langchain_community/storage/__pycache__/mongodb.cpython-311.pyc,,
+langchain_community/storage/__pycache__/redis.cpython-311.pyc,,
+langchain_community/storage/__pycache__/upstash_redis.cpython-311.pyc,,
+langchain_community/storage/astradb.py,sha256=Ft_PodAprM33nJa3rpaNXhEETMIybV810EXvE_yTFdc,8691
+langchain_community/storage/exceptions.py,sha256=m0kgni9Qu8CA-7xKoaTZ34vT5Yer_OqZjbVNfEL-ono,179
+langchain_community/storage/mongodb.py,sha256=niD4RTbXIAomrxnH5VprNV_q4kkfPdalehkE5XUzYj4,4375
+langchain_community/storage/redis.py,sha256=NyKIU6PPORZaXgsuaWellRHne76MGoxj9sw2-3k01Y4,4802
+langchain_community/storage/upstash_redis.py,sha256=F96ONrxTp8W0yoXDgalgsq0BAgZ1QBCJFv7JO-ZYs8A,5762
+langchain_community/tools/__init__.py,sha256=xy1REs01Gmr6o1A8UQnucZq4klhqMKaqFuRPFQFSCnQ,24644
+langchain_community/tools/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/__pycache__/convert_to_openai.cpython-311.pyc,,
+langchain_community/tools/__pycache__/ifttt.cpython-311.pyc,,
+langchain_community/tools/__pycache__/plugin.cpython-311.pyc,,
+langchain_community/tools/__pycache__/render.cpython-311.pyc,,
+langchain_community/tools/__pycache__/yahoo_finance_news.cpython-311.pyc,,
+langchain_community/tools/ainetwork/__pycache__/app.cpython-311.pyc,,
+langchain_community/tools/ainetwork/__pycache__/base.cpython-311.pyc,,
+langchain_community/tools/ainetwork/__pycache__/owner.cpython-311.pyc,,
+langchain_community/tools/ainetwork/__pycache__/rule.cpython-311.pyc,,
+langchain_community/tools/ainetwork/__pycache__/transfer.cpython-311.pyc,,
+langchain_community/tools/ainetwork/__pycache__/utils.cpython-311.pyc,,
+langchain_community/tools/ainetwork/__pycache__/value.cpython-311.pyc,,
+langchain_community/tools/ainetwork/app.py,sha256=NV-EJsUrOqX-t3gix-sMlERMFDM3-G_B5pr1nZqHtO0,3185
+langchain_community/tools/ainetwork/base.py,sha256=2uVAZzQo3_5X4PsIndLkOUCSW8XQdlRTUP_wgP_EIDs,2109
+langchain_community/tools/ainetwork/owner.py,sha256=5qSZYNgJSThdEGnTGgURdTtmoDxjkL4BOEHUASeXXOA,4140
+langchain_community/tools/ainetwork/rule.py,sha256=9ElR1f0L2ONZ-HVrTAM0B9pG1W2nHEjnt-vobEluI94,2746
+langchain_community/tools/ainetwork/transfer.py,sha256=_9bxKlZNPufay9fJEiUVmIxO8CDskM58KpAqvJbo2fU,1074
+langchain_community/tools/ainetwork/utils.py,sha256=vg8rFiFII8VYs71UZutXubOnYxyJ_U6j6Y2Dyn7D5Cg,2314
+langchain_community/tools/ainetwork/value.py,sha256=BqaShbUMToabQMrC4eyowsIYb3HvD1ic7v_8TRebsq8,2624
+langchain_community/tools/amadeus/__init__.py,sha256=oCyY-VdpTaAVsYB2kN4UvaJamolHnlhosBDe3wt9GwA,257
+langchain_community/tools/amadeus/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/amadeus/__pycache__/base.cpython-311.pyc,,
+langchain_community/tools/amadeus/__pycache__/closest_airport.cpython-311.pyc,,
+langchain_community/tools/amadeus/__pycache__/flight_search.cpython-311.pyc,,
+langchain_community/tools/amadeus/__pycache__/utils.cpython-311.pyc,,
+langchain_community/tools/amadeus/base.py,sha256=cHmmgO-LzCcdR1sSzde5vqyYjD0VqgnwFLSLhj9P5SA,435
+langchain_community/tools/amadeus/closest_airport.py,sha256=6Z1o8BlflLFcWxZZdGHVwy2kahJNScZAxuI5jfZdi8M,2338
+langchain_community/tools/amadeus/flight_search.py,sha256=9gxQkeyYCzv_Zlr3eGKqzKKTGdD8_RbwwgNYtFi0C-U,5771
+langchain_community/tools/amadeus/utils.py,sha256=CSbOvmuVzCzdd-6c4mD-7GDWhHJEChH2jgUCTVmqag0,1276
+langchain_community/tools/arxiv/__init__.py,sha256=8i_5wwMXHX1BHQN7cDLCtqjYvN4_AxkAdwhNGgRmHtE,25
+langchain_community/tools/arxiv/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/arxiv/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/arxiv/tool.py,sha256=uJEGv98YzvdHm-sl2BnYhnSXqvhxgS0fhzKOZ4fBOI8,1228
+langchain_community/tools/audio/__init__.py,sha256=ZqmAqz0lhBpMw2rPqovZoFBk2njk2HKk1M6V-shbFfw,188
+langchain_community/tools/audio/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/audio/__pycache__/huggingface_text_to_speech_inference.cpython-311.pyc,,
+langchain_community/tools/audio/huggingface_text_to_speech_inference.py,sha256=9Y9YRupBhaRXoSfSiFtrdgERYaz6G55f93caNkdZnEE,3724
+langchain_community/tools/azure_ai_services/__init__.py,sha256=4xDNayf79QHAzYk3Dfsg6t8r_hDXsXEFk7Djx6QVj3s,858
+langchain_community/tools/azure_ai_services/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/azure_ai_services/__pycache__/document_intelligence.cpython-311.pyc,,
+langchain_community/tools/azure_ai_services/__pycache__/image_analysis.cpython-311.pyc,,
+langchain_community/tools/azure_ai_services/__pycache__/speech_to_text.cpython-311.pyc,,
+langchain_community/tools/azure_ai_services/__pycache__/text_analytics_for_health.cpython-311.pyc,,
+langchain_community/tools/azure_ai_services/__pycache__/text_to_speech.cpython-311.pyc,,
+langchain_community/tools/azure_ai_services/__pycache__/utils.cpython-311.pyc,,
+langchain_community/tools/azure_ai_services/document_intelligence.py,sha256=l8fqktNfVWE2677HDG8zs599eE1tSBOZIZJVDcDEc_g,5486
+langchain_community/tools/azure_ai_services/image_analysis.py,sha256=jtP6jmFC31H96N5bPQOJgUgN0atkUBMx7O_st_H2LyI,5735
+langchain_community/tools/azure_ai_services/speech_to_text.py,sha256=76r6wPOTTsvjLeAURmVw3oFygeSFBm1lX8xwjaOc73k,4430
+langchain_community/tools/azure_ai_services/text_analytics_for_health.py,sha256=Y8XtVy5CG_4SrV8xO0fk-K3gGFAC8sdKDeD7dtMZnHc,3601
+langchain_community/tools/azure_ai_services/text_to_speech.py,sha256=b3vX2LSpU8I2SVAGPAWUbxyZdAX9-0psrvyid_2rEUE,3811
+langchain_community/tools/azure_ai_services/utils.py,sha256=cbWxcaIKRUxFsvMAJ1fbXc9e3U9DsEYU1DJ5n7l7wd4,776
+langchain_community/tools/azure_cognitive_services/__init__.py,sha256=vRoE4ioEcgnWzya8wPCAW296HiQS-PdRjas8L79pmlg,802
+langchain_community/tools/azure_cognitive_services/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/azure_cognitive_services/__pycache__/form_recognizer.cpython-311.pyc,,
+langchain_community/tools/azure_cognitive_services/__pycache__/image_analysis.cpython-311.pyc,,
+langchain_community/tools/azure_cognitive_services/__pycache__/speech2text.cpython-311.pyc,,
+langchain_community/tools/azure_cognitive_services/__pycache__/text2speech.cpython-311.pyc,,
+langchain_community/tools/azure_cognitive_services/__pycache__/text_analytics_health.cpython-311.pyc,,
+langchain_community/tools/azure_cognitive_services/__pycache__/utils.cpython-311.pyc,,
+langchain_community/tools/azure_cognitive_services/form_recognizer.py,sha256=D1smMzxWjuOZqRo1Kz-BiOL8mXJwLmSK8bBPlcjh9gw,5375
+langchain_community/tools/azure_cognitive_services/image_analysis.py,sha256=lU7E7knNr0yVLWtQNx2NnLdqu94GnXfDvpVVRiRu65Y,5304
+langchain_community/tools/azure_cognitive_services/speech2text.py,sha256=OD13g6m_bs7WX8KQVmPPp0z9AZeBXf-lqd5JrmC9TRc,4336
+langchain_community/tools/azure_cognitive_services/text2speech.py,sha256=NIVb5UgbE2eBymteblxWuJFhTtdpSoYcN4AulgfAqCQ,3675
+langchain_community/tools/azure_cognitive_services/text_analytics_health.py,sha256=sOlLrzgZzm9eH55lSaZP1S-oDPLNoxM8WnN8REYTbLE,3542
+langchain_community/tools/azure_cognitive_services/utils.py,sha256=cbWxcaIKRUxFsvMAJ1fbXc9e3U9DsEYU1DJ5n7l7wd4,776
+langchain_community/tools/bearly/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_community/tools/bearly/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/bearly/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/bearly/tool.py,sha256=dYnew05qP-vOUsP1225NxHYunblHMyd3g8e7ZHWfgNY,5562
+langchain_community/tools/bing_search/__init__.py,sha256=TrKKXeLieagRg0w09grJnRjPVVcb83DP44Bb6xot_CM,170
+langchain_community/tools/bing_search/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/bing_search/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/bing_search/tool.py,sha256=w2SquU4UQMGhUJBV14rADnQ5S4rYTrfoReN3X7IVGwk,1463
+langchain_community/tools/brave_search/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_community/tools/brave_search/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/brave_search/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/brave_search/tool.py,sha256=m4gaKvrvIFB1OrY3XT_UUWLR26jCMxWoLbsWybKG8G0,1354
+langchain_community/tools/clickup/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_community/tools/clickup/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/clickup/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/tools/clickup/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/clickup/prompt.py,sha256=oce6eOkfMPBdJy9oKfQMX984AhF9SHuhll33cEO10H8,8298
+langchain_community/tools/clickup/tool.py,sha256=76fnTObNV4VFktoTMITzxNfa5dTBOa4mZHDUIq4u8vo,1230
+langchain_community/tools/cogniswitch/__init__.py,sha256=uDEn1jkR85TqZSKQBNnnXf-WryGEJVD3tDz_FqJhwYA,20
+langchain_community/tools/cogniswitch/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/cogniswitch/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/cogniswitch/tool.py,sha256=Jkok-k0RSfVNJ48FxLnEGxjwUSp3o8FUlnLmQ0xjJNY,13896
+langchain_community/tools/connery/__init__.py,sha256=kH--SvQo7vscfLlkQxSQ1r9VesK3mKhBtH4VwBi1jSI,188
+langchain_community/tools/connery/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/connery/__pycache__/models.cpython-311.pyc,,
+langchain_community/tools/connery/__pycache__/service.cpython-311.pyc,,
+langchain_community/tools/connery/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/connery/models.py,sha256=ocd78EXzBLQA2A2O2A6BKZXmK3up64bovl8G1ttiHrk,647
+langchain_community/tools/connery/service.py,sha256=GsbZH0-e_tXM6XExKdjmkwXQN5PyviVjg3xgNJ4dWlY,5741
+langchain_community/tools/connery/tool.py,sha256=9jdcpvptxk_VTg9eBkluqhHZsOVbh3k9_ABYTSxGOzg,5552
+langchain_community/tools/convert_to_openai.py,sha256=AAFi4fC9y53jog87SPWSRyeny9JO4w2oseqKCFSiI1g,198
+langchain_community/tools/dataforseo_api_search/__init__.py,sha256=5lOqC2RP6PYUOn6VyW4LCUzh92Qj_kjaddUo7rxvTNM,268
+langchain_community/tools/dataforseo_api_search/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/dataforseo_api_search/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/dataforseo_api_search/tool.py,sha256=E8IlMji7ZmN63yU6caQyNMtFEVfIjKMnFiQxVsH1Txg,2214
+langchain_community/tools/dataherald/__init__.py,sha256=UdpTfnHbfSOFrSqhKD72wq8cTT3cV3ekTg-7Aense6g,148
+langchain_community/tools/dataherald/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/dataherald/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/dataherald/tool.py,sha256=jCldZ0ZiWV1Uj_OdeFmY6pMu-PqHLRh2jsVLR3YB6Zo,1063
+langchain_community/tools/ddg_search/__init__.py,sha256=Foj-IE35XDV4EpnDDYxIBiKjysvk_gSE-DoFWymxclY,147
+langchain_community/tools/ddg_search/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/ddg_search/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/ddg_search/tool.py,sha256=lKGj8UgR5MxfQmqJgGOV8kgDmELsKJenm5X5xdsdbUQ,2641
+langchain_community/tools/e2b_data_analysis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_community/tools/e2b_data_analysis/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/e2b_data_analysis/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/e2b_data_analysis/__pycache__/unparse.cpython-311.pyc,,
+langchain_community/tools/e2b_data_analysis/tool.py,sha256=MFAXlg6f6SlCGBnsQ7tzNL6Aeh_WYzvFFmNIDvyZQEg,8015
+langchain_community/tools/e2b_data_analysis/unparse.py,sha256=l_f9EgRJ69B09CjzRPQI0OW4FuJfMYt4Qc_H536jGHw,20701
+langchain_community/tools/edenai/__init__.py,sha256=Ja01iGjJatsJxdmVKYrTUAzQ0FwG8iwZrp__foYGM8s,1024
+langchain_community/tools/edenai/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/edenai/__pycache__/audio_speech_to_text.cpython-311.pyc,,
+langchain_community/tools/edenai/__pycache__/audio_text_to_speech.cpython-311.pyc,,
+langchain_community/tools/edenai/__pycache__/edenai_base_tool.cpython-311.pyc,,
+langchain_community/tools/edenai/__pycache__/image_explicitcontent.cpython-311.pyc,,
+langchain_community/tools/edenai/__pycache__/image_objectdetection.cpython-311.pyc,,
+langchain_community/tools/edenai/__pycache__/ocr_identityparser.cpython-311.pyc,,
+langchain_community/tools/edenai/__pycache__/ocr_invoiceparser.cpython-311.pyc,,
+langchain_community/tools/edenai/__pycache__/text_moderation.cpython-311.pyc,,
+langchain_community/tools/edenai/audio_speech_to_text.py,sha256=qxKR7hxg8ReTBtX6voql9UHyjkMOTGnGpkj9xMs_RAM,3465
+langchain_community/tools/edenai/audio_text_to_speech.py,sha256=WA7UGEIIrYhvYZoqU0U2FimHtC8669voRbbfeIFwyQk,3885
+langchain_community/tools/edenai/edenai_base_tool.py,sha256=SsDTvRwBDLBQ-XtoQXNka0ReiRttTb_yoIIoA-BRw2c,5386
+langchain_community/tools/edenai/image_explicitcontent.py,sha256=fZqDFIZFNeJA_C4GAkwKL1nvP0cmU6F4I31e7ZnxuHc,2249
+langchain_community/tools/edenai/image_objectdetection.py,sha256=wbrgdUmK-UbHWNGY1OhPnsT47JCGILjtipsYLLQ6L90,2476
+langchain_community/tools/edenai/ocr_identityparser.py,sha256=AIpBM2QXExGy1u95ZaCTw77acPLeXUlmwQh2D4emWVU,1966
+langchain_community/tools/edenai/ocr_invoiceparser.py,sha256=8EM_4X8Vthke_SmQHq898lReViMjPayrTK67tLGj2qs,2187
+langchain_community/tools/edenai/text_moderation.py,sha256=InlZ34q0eNNQKuqQUxir7pK0Jl_NpqN3ztE7Ncj2H9M,2407
+langchain_community/tools/eleven_labs/__init__.py,sha256=ZVMb18r014U4kKzrSDUWj9DFr2BbxxudjZ3sPT_sUtA,164
+langchain_community/tools/eleven_labs/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/eleven_labs/__pycache__/models.cpython-311.pyc,,
+langchain_community/tools/eleven_labs/__pycache__/text2speech.cpython-311.pyc,,
+langchain_community/tools/eleven_labs/models.py,sha256=NpMT9amfY4wPgu6DclboVYbnrnMMfu_8PWQsjyFFnHA,203
+langchain_community/tools/eleven_labs/text2speech.py,sha256=CIz7xsk0P__FVlbChEr9ITeNG0_efFxaV610dZp3Ns4,2709
+langchain_community/tools/file_management/__init__.py,sha256=nQvziZtgKWL3GIdep-TO37d2rkL4Ipehf8RuaAEA8gc,723
+langchain_community/tools/file_management/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/file_management/__pycache__/copy.cpython-311.pyc,,
+langchain_community/tools/file_management/__pycache__/delete.cpython-311.pyc,,
+langchain_community/tools/file_management/__pycache__/file_search.cpython-311.pyc,,
+langchain_community/tools/file_management/__pycache__/list_dir.cpython-311.pyc,,
+langchain_community/tools/file_management/__pycache__/move.cpython-311.pyc,,
+langchain_community/tools/file_management/__pycache__/read.cpython-311.pyc,,
+langchain_community/tools/file_management/__pycache__/utils.cpython-311.pyc,,
+langchain_community/tools/file_management/__pycache__/write.cpython-311.pyc,,
+langchain_community/tools/file_management/copy.py,sha256=GEvLn7P90nZLPqltQjg1YC-XPZ_Cs7hVGxITL3jL164,1749
+langchain_community/tools/file_management/delete.py,sha256=gCmH9T_JMK0nbElEZ4E6i62XhF7ZRqQ66BDUAeyQMm0,1345
+langchain_community/tools/file_management/file_search.py,sha256=4dmLF9_mwiVabuktL1ObWoaktPJCKbqXkXt_SesM8UA,1965
+langchain_community/tools/file_management/list_dir.py,sha256=kArs3QDmeBi9mzhgf4Bvpnox36kvTJflkhHdwUHMm0c,1432
+langchain_community/tools/file_management/move.py,sha256=heNXlFXZLAtrrfSWA12oeRFUXc7EzWat38NeCkGwtkw,1889
+langchain_community/tools/file_management/read.py,sha256=zWwu7sKpVZALncJAkgwiG0xOpOhow8aMnw9mpZF9YIk,1340
+langchain_community/tools/file_management/utils.py,sha256=5uLOMhe4tqt7qJkNwMoTBcm66IJbTZTuzUIzmzecFWw,1726
+langchain_community/tools/file_management/write.py,sha256=mThbbcLksdn0R6EucC2P_k1bBdw4KEjSyD5R3PtsKh0,1614
+langchain_community/tools/github/__init__.py,sha256=SzKhul90IpTDAtc3OdE92mQasahA0PqDSnc7j7B9ly0,20
+langchain_community/tools/github/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/github/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/tools/github/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/github/prompt.py,sha256=k7551BGFkVo5dt_DPD6bSo_UydN4IWp_Any-vVvenkk,6220
+langchain_community/tools/github/tool.py,sha256=f-H97VW3jrxZ3qiENP6ii807g1GYtu6kzAXZVJlpc8s,1194
+langchain_community/tools/gitlab/__init__.py,sha256=rPY8UYi84KDzppleEwqUyaVRXySqrVWlb261ur_JjOM,20
+langchain_community/tools/gitlab/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/gitlab/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/tools/gitlab/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/gitlab/prompt.py,sha256=Q5BXJX_nPtWf8ZXyde1zRgTSV1KnhyglULFw_5Hjmkg,3438
+langchain_community/tools/gitlab/tool.py,sha256=E67IgQmJkHY13QthHfBMDhHt5fyTph99GSKQpzCAjok,972
+langchain_community/tools/gmail/__init__.py,sha256=GMGEm_d89jPgRr78wFlrqjxYBDcmETs-usn_CIMso5I,601
+langchain_community/tools/gmail/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/gmail/__pycache__/base.cpython-311.pyc,,
+langchain_community/tools/gmail/__pycache__/create_draft.cpython-311.pyc,,
+langchain_community/tools/gmail/__pycache__/get_message.cpython-311.pyc,,
+langchain_community/tools/gmail/__pycache__/get_thread.cpython-311.pyc,,
+langchain_community/tools/gmail/__pycache__/search.cpython-311.pyc,,
+langchain_community/tools/gmail/__pycache__/send_message.cpython-311.pyc,,
+langchain_community/tools/gmail/__pycache__/utils.cpython-311.pyc,,
+langchain_community/tools/gmail/base.py,sha256=e9C60HHJtpD7fsBErWxtkhQurucW-jHs7wntCyrqlV0,1004
+langchain_community/tools/gmail/create_draft.py,sha256=dcrtwz8vTj6rPMiidbVy3xKiI_BKRcIg2OVNq4mdZtI,2564
+langchain_community/tools/gmail/get_message.py,sha256=UYwzautm8nz0NV3f-c9LOisXGE92LWB_kYb9mYQNiX8,2202
+langchain_community/tools/gmail/get_thread.py,sha256=7h01dRdx6GQa0_X6Xht2z_u_VKv1-4Ub6OKz7yWSGzU,1560
+langchain_community/tools/gmail/search.py,sha256=uZiNossM5Oaa_XzfodEmnnSVXYNc1kCkl1vqSa5l7N4,5111
+langchain_community/tools/gmail/send_message.py,sha256=dIp75VEVEa1cjGTo5HUjWjcGMpZ-YUXthn4aRk-Ha9E,2939
+langchain_community/tools/gmail/utils.py,sha256=58fY_KHky72nnwRAhrBGDJj0SQgoQDc2EjQPpPta_Vg,4528
+langchain_community/tools/golden_query/__init__.py,sha256=Y04IRGEP6OvkEgswjEupKUkt6-JFuuej47kbnP0Wns8,136
+langchain_community/tools/golden_query/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/golden_query/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/golden_query/tool.py,sha256=FU9NzZ7ep3pf3A_Hjbk_tifls8DMToh9P7K5yhu1bvU,1108
+langchain_community/tools/google_cloud/__init__.py,sha256=CaKO4qRuLzz4--tUQ-xNL_3JQcs0NhB6l-a4JtgCyTI,171
+langchain_community/tools/google_cloud/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/google_cloud/__pycache__/texttospeech.cpython-311.pyc,,
+langchain_community/tools/google_cloud/texttospeech.py,sha256=PmxoQze3qTnSWsLcbdqeryjeF3xU7PXbnjnYDX1Dvhw,3354
+langchain_community/tools/google_finance/__init__.py,sha256=uK-k2yxn2OKULEBFgufDbs_56ryHJRq4-gG_iQ62C-4,152
+langchain_community/tools/google_finance/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/google_finance/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/google_finance/tool.py,sha256=rZ_P8C6E05j_U3giiwgNn2CMaZ4jbVBftAKwzPAlWNY,854
+langchain_community/tools/google_jobs/__init__.py,sha256=dFNdE76BeJZ3SpCZu--sKU-GlFZVP9e10pQ__pxhH_k,140
+langchain_community/tools/google_jobs/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/google_jobs/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/google_jobs/tool.py,sha256=mGo17l1_rJmQ12fL33eGvxzpNl6_6DNTaFoxPROgP9I,826
+langchain_community/tools/google_lens/__init__.py,sha256=8apk9RIaDwKrfObKYUpJr7cSASUiJBGSIu1JkCpHsWU,140
+langchain_community/tools/google_lens/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/google_lens/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/google_lens/tool.py,sha256=TdRAnUUAFXNacljKnj1bQZyU9JCB9lPUp2nRYRjHXtI,822
+langchain_community/tools/google_places/__init__.py,sha256=n5wwZvgpm7sohzv2hRRacS2d9vw_vwf2jOizLnpdvTc,140
+langchain_community/tools/google_places/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/google_places/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/google_places/tool.py,sha256=mEmTx-xNACBq78W78gpxsC1URG3kFiwlrP5Vl_N2VCQ,1322
+langchain_community/tools/google_scholar/__init__.py,sha256=F7g-IX4a0sfQQZnyXkAsvGHlyhwit56TdxUQeGBBRQE,152
+langchain_community/tools/google_scholar/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/google_scholar/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/google_scholar/tool.py,sha256=vblvOo7pzvdnd1dC4I5k9JjAe1dfGKctLxDHCKZ7a2U,847
+langchain_community/tools/google_search/__init__.py,sha256=uLCt2uzM_rndct88evNdlXuaBJOeMqWn6F7ibrGVF9M,195
+langchain_community/tools/google_search/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/google_search/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/google_search/tool.py,sha256=EEIfstpgKGVzFWYHC-cC3Ug0S3R2ERP51hLOoLxUYA8,1798
+langchain_community/tools/google_serper/__init__.py,sha256=hOe3l5NFDTBGh8kqeUhjq0BhHJMeWv8V0C4dBNGHsWw,243
+langchain_community/tools/google_serper/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/google_serper/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/google_serper/tool.py,sha256=AZB22ypeOox4Ni814sSIeNUIIZtRslInOrcR2IhOZQE,2113
+langchain_community/tools/google_trends/__init__.py,sha256=Lwn7fs35f2twAs1U-GppbqGqtGLibu5n3bnd9CblDUg,148
+langchain_community/tools/google_trends/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/google_trends/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/google_trends/tool.py,sha256=sg2zb93ps6SJIK6W7JSbX8KPhhYRbky2fUQk4ampPeY,844
+langchain_community/tools/graphql/__init__.py,sha256=5WzEFZc0S0sh1mn6kciABqotz0Zf1fftuwJ6XTs5LgU,47
+langchain_community/tools/graphql/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/graphql/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/graphql/tool.py,sha256=O8jfBnt3hdaTpyPCNEgJQVaY2_ileM2LEYb5K_wE8Es,1204
+langchain_community/tools/human/__init__.py,sha256=96BPmcHUQOeclH24p3y5ZMHqsyYSnnEmObFFhTTkOFM,132
+langchain_community/tools/human/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/human/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/human/tool.py,sha256=P60KQk2wq_k--traimKGw1XstNVDblJD9wHCrvgw3uY,1011
+langchain_community/tools/ifttt.py,sha256=8mOLVjXyKee5oUiye7lu4-mST7O2KkVZCVM-jAR6YMY,2286
+langchain_community/tools/interaction/__init__.py,sha256=RYCJKa2M7CrzMbz59xYFJ_c3hwGJKOPyyP4G_sAt48w,43
+langchain_community/tools/interaction/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/interaction/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/interaction/tool.py,sha256=hjwv-aGoHU4tDDV_GK8Uy5SiIt2k4lpur8L6ObcMj8I,464
+langchain_community/tools/jira/__init__.py,sha256=Zz6Gy5kGFFIfVAnG0a6c4ovi5XM9KZheGKaZ_fFbmGY,17
+langchain_community/tools/jira/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/jira/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/tools/jira/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/jira/prompt.py,sha256=6iBpZCZSgnYo0VlsLgH5cM50SITaDozAywuPzrvwb_A,3170
+langchain_community/tools/jira/tool.py,sha256=xWwHvdqNZl0i5lXK085zfOcpL-DY1xU-bMUFR4tGnAc,1342
+langchain_community/tools/json/__init__.py,sha256=ieEWuRmzcehYXhGc-KcC6z1Lhbbn_nBEyMtnE04vyFU,46
+langchain_community/tools/json/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/json/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/json/tool.py,sha256=xBNEw_H8U8xhLQoXEvCzc5oq8jFBVce5MwFe9anBjLw,4139
+langchain_community/tools/memorize/__init__.py,sha256=Iv2FZHKB8eNuMKKjv873n1qDSQxUJxnkLA01z40aKv0,134
+langchain_community/tools/memorize/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/memorize/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/memorize/tool.py,sha256=hQFda5OpJWO2hLaCbItu4MAjcxs4Y8J_DJpncuyzz3s,1828
+langchain_community/tools/merriam_webster/__init__.py,sha256=6n0Uz-TRpAh6M7LMI_p6_qa1c-4vT2kEvU3nDgxzr1Q,35
+langchain_community/tools/merriam_webster/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/merriam_webster/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/merriam_webster/tool.py,sha256=wyR0co0TPJVOQ1JOr5P5UHVJpOcKmQ_9OPiaWzv1r_0,854
+langchain_community/tools/metaphor_search/__init__.py,sha256=ORai2wY3PgqxgWPGpQA4ztTNu0iJ2kohn9H55zceHCA,154
+langchain_community/tools/metaphor_search/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/metaphor_search/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/metaphor_search/tool.py,sha256=E-Wi5O-b1O-9FOIRAF1wbtTGJVmvBTmH05P8PH6IREs,2851
+langchain_community/tools/multion/__init__.py,sha256=uFsgWNkKrJ8jjafA2elIDu1gEjS7lijbn88nHwtga9E,359
+langchain_community/tools/multion/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/multion/__pycache__/close_session.cpython-311.pyc,,
+langchain_community/tools/multion/__pycache__/create_session.cpython-311.pyc,,
+langchain_community/tools/multion/__pycache__/update_session.cpython-311.pyc,,
+langchain_community/tools/multion/close_session.py,sha256=3ZxJ2Hafy1gspq6VPWJiGCkeX2cLhubeDDQxmBBzEks,1765
+langchain_community/tools/multion/create_session.py,sha256=QcIA0rO08ugEB85t9FE3fjgOgoiCQK1w6gdzgETCxsQ,2199
+langchain_community/tools/multion/update_session.py,sha256=MLBTvIUENrW4LbasiSm4TDcSWRgOvSnZIy9rbMurKS8,2415
+langchain_community/tools/nasa/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_community/tools/nasa/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/nasa/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/tools/nasa/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/nasa/prompt.py,sha256=F4JIDYUfyLKY91N-_iSV-VKy5gM1v-mfK9fZ6TfBiro,5197
+langchain_community/tools/nasa/tool.py,sha256=xFZkk1074m0XigcnWrNCHt-lS0enHFrC5UwPHXf3-20,831
+langchain_community/tools/nuclia/__init__.py,sha256=BiP6ptCcnJjViD2pSOSj3LVlP7vsbz5FIjYQwNRcFjo,111
+langchain_community/tools/nuclia/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/nuclia/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/nuclia/tool.py,sha256=SjCwebCs-c6EKpX0cSJjT5ixccPDrGo9TuVwMD4J3NM,7915
+langchain_community/tools/office365/__init__.py,sha256=G7NdkwjD5hHgigY2h8iNk4GxzKKAsB7cCl2Cs2KpCW8,654
+langchain_community/tools/office365/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/office365/__pycache__/base.cpython-311.pyc,,
+langchain_community/tools/office365/__pycache__/create_draft_message.cpython-311.pyc,,
+langchain_community/tools/office365/__pycache__/events_search.cpython-311.pyc,,
+langchain_community/tools/office365/__pycache__/messages_search.cpython-311.pyc,,
+langchain_community/tools/office365/__pycache__/send_event.cpython-311.pyc,,
+langchain_community/tools/office365/__pycache__/send_message.cpython-311.pyc,,
+langchain_community/tools/office365/__pycache__/utils.cpython-311.pyc,,
+langchain_community/tools/office365/base.py,sha256=x6ruVWxffRskP66bRNvfZAT1y_we6V_A-2QoQ67CK5s,508
+langchain_community/tools/office365/create_draft_message.py,sha256=PAY7mfmP8lpAjSJJttbV27YAEc3znsjuDk9cfJztuiE,1858
+langchain_community/tools/office365/events_search.py,sha256=S3QGASALV6Zaz9prglTCwasByoyTXZElf97H_p0edFQ,4821
+langchain_community/tools/office365/messages_search.py,sha256=r0Ve734bdniXEyX9xjVbt6hBnWvvDnjfXQlrmdVqWDc,4235
+langchain_community/tools/office365/send_event.py,sha256=f9hJUuVogk6XgR_8WMmWjzT3dws284PE-fO9ZY5p9G0,2898
+langchain_community/tools/office365/send_message.py,sha256=qeNqDLQmZwB_fkqHws2oxapulY_wgeoS94w6wc9MPYg,1777
+langchain_community/tools/office365/utils.py,sha256=lKifGau0avmFMyMhxO2pUiWrMk-SNLauLDmiL_OFr98,2228
+langchain_community/tools/openai_dalle_image_generation/__init__.py,sha256=jPhZPCqGpudOvHB0fVFC6ZqwzlxEuecHKQJokVMdq08,219
+langchain_community/tools/openai_dalle_image_generation/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/openai_dalle_image_generation/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/openai_dalle_image_generation/tool.py,sha256=ywJIc0Sm3iK3V-T0IJD-15h8B8boK-nYINO4iY7OGZo,953
+langchain_community/tools/openapi/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_community/tools/openapi/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/openapi/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_community/tools/openapi/utils/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/openapi/utils/__pycache__/api_models.cpython-311.pyc,,
+langchain_community/tools/openapi/utils/__pycache__/openapi_utils.cpython-311.pyc,,
+langchain_community/tools/openapi/utils/api_models.py,sha256=61rTJY9cuJQvAKoDO9vWywLjtVfki4d6e7sjZmGrL_M,21288
+langchain_community/tools/openapi/utils/openapi_utils.py,sha256=T9BQI9gbaoryA7YPoqx7oGCTwmGgHYd7WqD_cskIHw8,191
+langchain_community/tools/openweathermap/__init__.py,sha256=ulwCVk_Uw3y9eyZFyJtzYUTUA5l0XYRF1CKEYPgRN38,162
+langchain_community/tools/openweathermap/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/openweathermap/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/openweathermap/tool.py,sha256=LlT-83O4k-S7Uoep0Pbiy3HdeJcNnsxKD1soFrvKX6s,968
+langchain_community/tools/passio_nutrition_ai/__init__.py,sha256=H-NpjIdIgz2RPPVqkLv2xG9A6rvjpzIavEmQ6dphexM,142
+langchain_community/tools/passio_nutrition_ai/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/passio_nutrition_ai/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/passio_nutrition_ai/tool.py,sha256=zVREcxUEepcsY81JR2mXiBv8tdyFx-185nbYY8khkPw,1143
+langchain_community/tools/playwright/__init__.py,sha256=pBSkDs07eYOMuQPT9RKq66XoPzeoRpzB_r7PmuyAgFg,763
+langchain_community/tools/playwright/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/playwright/__pycache__/base.cpython-311.pyc,,
+langchain_community/tools/playwright/__pycache__/click.cpython-311.pyc,,
+langchain_community/tools/playwright/__pycache__/current_page.cpython-311.pyc,,
+langchain_community/tools/playwright/__pycache__/extract_hyperlinks.cpython-311.pyc,,
+langchain_community/tools/playwright/__pycache__/extract_text.cpython-311.pyc,,
+langchain_community/tools/playwright/__pycache__/get_elements.cpython-311.pyc,,
+langchain_community/tools/playwright/__pycache__/navigate.cpython-311.pyc,,
+langchain_community/tools/playwright/__pycache__/navigate_back.cpython-311.pyc,,
+langchain_community/tools/playwright/__pycache__/utils.cpython-311.pyc,,
+langchain_community/tools/playwright/base.py,sha256=oQx0FcY4Vv9V-yc_Htg91ijWlsHn0n6wiXR8Nwdwxmg,2135
+langchain_community/tools/playwright/click.py,sha256=tH_lXVEKHCqLt7sHqlncajMpX2FO2jt4sMZiupUs8Ok,3083
+langchain_community/tools/playwright/current_page.py,sha256=TcexTyBPM6MyjMh4IfFgzHDRBd3KdS9_zfchjLevcS8,1340
+langchain_community/tools/playwright/extract_hyperlinks.py,sha256=7PHxMlyLBSO70likUwIs6MfwmAHW1FarerbPYCqMwOo,3051
+langchain_community/tools/playwright/extract_text.py,sha256=ibfy3x-9PFVhPNctZk9_rki_Gt5kTufDJYkjEVm-Qgg,2383
+langchain_community/tools/playwright/get_elements.py,sha256=OO3aEj184vKkM4yd2QL7Pi1LaUqgBC7DmumEjRnMMYo,3743
+langchain_community/tools/playwright/navigate.py,sha256=S_-_ZXLnpwHx0h_7DM4eGEM_75Mf-2Y4p4rGhHW-Wi8,2878
+langchain_community/tools/playwright/navigate_back.py,sha256=OjTvq2FFgjrXVRk3aeIhImOLDlPZtJJ27yf1fYvq1ug,1926
+langchain_community/tools/playwright/utils.py,sha256=FyPwJm0-XOs4AvuXoPrQUzbFpfDSPiFvGrLSHzKP7-0,3049
+langchain_community/tools/plugin.py,sha256=4SfNq8KDyy73wBAXo8BM9v_2bYyWJ-bhRtybtrr1xsk,2902
+langchain_community/tools/polygon/__init__.py,sha256=cIMdjvLuORRSSduowDi2rDr3di8PFkNYmU9Kl6W-5O8,439
+langchain_community/tools/polygon/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/polygon/__pycache__/aggregates.cpython-311.pyc,,
+langchain_community/tools/polygon/__pycache__/financials.cpython-311.pyc,,
+langchain_community/tools/polygon/__pycache__/last_quote.cpython-311.pyc,,
+langchain_community/tools/polygon/__pycache__/ticker_news.cpython-311.pyc,,
+langchain_community/tools/polygon/aggregates.py,sha256=s4_zYI_b3iuLybZAAbHxl6IvdX-wOhYA6Dq2B5LgHNc,2558
+langchain_community/tools/polygon/financials.py,sha256=VyxYfZULmSI8dvWIkKG_D9tig6AW1VAB6FU3Nz0QDXI,1197
+langchain_community/tools/polygon/last_quote.py,sha256=GwJesqUduegWYN2g7kBhQWAWAvnNiy1GEGFVF81Q8X8,1070
+langchain_community/tools/polygon/ticker_news.py,sha256=0nC503sLalIv8WMjRB9pezYAmfyN83hWt9mbb11bDJ0,1076
+langchain_community/tools/powerbi/__init__.py,sha256=lFy__65sASd5e8Eac1E1RHN58uTVSOMprb88zClyEZU,52
+langchain_community/tools/powerbi/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/powerbi/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/tools/powerbi/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/powerbi/prompt.py,sha256=XGl9Z0HeEurKc_vO5R61YBlIx2HH-U8W4wySOMhvx2c,7339
+langchain_community/tools/powerbi/tool.py,sha256=RdhitRb2Lu4nhK4-ZVmsVzsZisPbPn-ykIdqnfDPVy8,11075
+langchain_community/tools/pubmed/__init__.py,sha256=KdYkXaHkUWLyuY35F0HRoZlX6PtTuTCPCYqlkgmBUgY,26
+langchain_community/tools/pubmed/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/pubmed/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/pubmed/tool.py,sha256=xt6HMWsijfaSW4FUmgsJtDQ3jibW59c8p1DRjnk2F0c,945
+langchain_community/tools/reddit_search/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/reddit_search/tool.py,sha256=69sSblsn_gCHs1WytkXddpZSJn9EFuTgGiJCByNMTBk,1965
+langchain_community/tools/render.py,sha256=AAFi4fC9y53jog87SPWSRyeny9JO4w2oseqKCFSiI1g,198
+langchain_community/tools/requests/__init__.py,sha256=oeutQGdlOp3p6PbcAAfjdYpftaXFmJYJgSWw5SGb6IM,52
+langchain_community/tools/requests/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/requests/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/requests/tool.py,sha256=sDg37MIQifL0XMQfdmWqt75NDcITzH7Vz1SRvoxMi6c,7445
+langchain_community/tools/scenexplain/__init__.py,sha256=rRP3hoEnMUUHwABFgXFLGCJkoQi4lyg585ONrgWis3k,31
+langchain_community/tools/scenexplain/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/scenexplain/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/scenexplain/tool.py,sha256=t3m17Q1iYtuedBfQpLd46ew__3zvnVD8SpRZnRcq3vo,1100
+langchain_community/tools/searchapi/__init__.py,sha256=Uw8Un5_BMfEWxPFWplTf5qjWlRhQaB7u5uQk8r4LJZA,214
+langchain_community/tools/searchapi/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/searchapi/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/searchapi/tool.py,sha256=zoBwIwmo4xL2S8bDWEGXULF-uvt5UFzEqWFoXhZdUTk,2114
+langchain_community/tools/searx_search/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_community/tools/searx_search/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/searx_search/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/searx_search/tool.py,sha256=cKlQUA5dU5-upPjAdclv0chLqbO5XswevwxR360B5bE,2261
+langchain_community/tools/semanticscholar/__init__.py,sha256=qqyGMEL374joV9MfseGcEQ7nFGuYafxcuY5CdeZJBnM,36
+langchain_community/tools/semanticscholar/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/semanticscholar/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/semanticscholar/tool.py,sha256=qD5h-d6WzFOGsBtF8rH8k_qvcdLdZeC1ivLD0QejUlo,1190
+langchain_community/tools/shell/__init__.py,sha256=0na3xEyP8QPmMn3n04761kvzAiq7ikfE8FoAO8dZDzc,103
+langchain_community/tools/shell/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/shell/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/shell/tool.py,sha256=KtHcbQ_1i1mYR8vMolziZkgF6jc9V-6FwDkq0iFni-Y,3143
+langchain_community/tools/slack/__init__.py,sha256=c8jYW3xWJjJM8_Ze58aDlC8e7eh_u9-ZJ8N0tAlZHUQ,502
+langchain_community/tools/slack/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/slack/__pycache__/base.cpython-311.pyc,,
+langchain_community/tools/slack/__pycache__/get_channel.cpython-311.pyc,,
+langchain_community/tools/slack/__pycache__/get_message.cpython-311.pyc,,
+langchain_community/tools/slack/__pycache__/schedule_message.cpython-311.pyc,,
+langchain_community/tools/slack/__pycache__/send_message.cpython-311.pyc,,
+langchain_community/tools/slack/__pycache__/utils.cpython-311.pyc,,
+langchain_community/tools/slack/base.py,sha256=nXHzovaWdYz722XMfU2P82mL3hqwR5ReYZFh0Sc5fT0,460
+langchain_community/tools/slack/get_channel.py,sha256=FUIhZsJIg2c-F8L9DWFwTGJKZuVv6z4TDKwf3wYfnmY,1193
+langchain_community/tools/slack/get_message.py,sha256=izEfi73TXCbJkRAfvO5qabva4HCyiNK6XsHaeSEcEiM,1422
+langchain_community/tools/slack/schedule_message.py,sha256=jr14bhFB0wi6yl3J9xEkAuh4GEGb9AydGvPOZ4DinFo,2071
+langchain_community/tools/slack/send_message.py,sha256=MsBLfwoD4EeBd77GxFfdQICT9YMTc6-OY7LzNf602-E,1222
+langchain_community/tools/slack/utils.py,sha256=XmPqF9uMXg5CRDd-RdRrOSSPI5EV9Zy1XPQLwtNLfc0,1135
+langchain_community/tools/sleep/__init__.py,sha256=O3fn_ASDE-eDcU3FsBaPTmLHV75hhMS4c6v2qzrak5E,18
+langchain_community/tools/sleep/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/sleep/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/sleep/tool.py,sha256=G7FzEsMCwiKpho5JoS5RDKzSIPlG2mOOAhTsOfAOx8U,1229
+langchain_community/tools/spark_sql/__init__.py,sha256=HDxRN6dODaOCPByAO48uZz3GbVZd49fE905zLArXCMA,44
+langchain_community/tools/spark_sql/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/spark_sql/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/tools/spark_sql/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/spark_sql/prompt.py,sha256=rXtkj9l8BXtUgsOmSCwnCaC8U5YliYQ4tpShTmQJrok,550
+langchain_community/tools/spark_sql/tool.py,sha256=w6Zt8XAhDoBLzC_RTnkqL_tRu2u2486ivXA3HLLnheg,4376
+langchain_community/tools/sql_database/__init__.py,sha256=Z7WNXu1y5-DhuoeA_Ync-Zcg3uK1lhdfQOlKBWAifmo,49
+langchain_community/tools/sql_database/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/sql_database/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/tools/sql_database/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/sql_database/prompt.py,sha256=Ex4vEXjmGZXgK8WhLkpGg0MN90wd0YpSapThkot7JDk,597
+langchain_community/tools/sql_database/tool.py,sha256=Jn81OwKNduGA3Zp830OUbiUTwI_3Uqku9b_jSHVxe-0,5326
+langchain_community/tools/stackexchange/__init__.py,sha256=dLGMnzEmyYZGoPsv215mPeqAU03McJJ_2WGkIioj3yY,33
+langchain_community/tools/stackexchange/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/stackexchange/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/stackexchange/tool.py,sha256=ncMKV0MOJUBxVS3u2fLdBAroRxZdL6YgB6I5XPcrHME,869
+langchain_community/tools/steam/__init__.py,sha256=_hg6uHJlBNJnCFPctYr80psy7o2hRsuzemhtPYHLENA,24
+langchain_community/tools/steam/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/steam/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/tools/steam/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/steam/prompt.py,sha256=SnGVvWCRSrChEv8hN2LB3jK4SfRYxFEqBX_uPbRz5Bc,1657
+langchain_community/tools/steam/tool.py,sha256=OqprWCa18BPOEF9nhBGu7jXhJvhywdF0PV_RBNga_W8,842
+langchain_community/tools/steamship_image_generation/__init__.py,sha256=1abTK0waz1F1auwU1YEwbluHBSfgmcR44XBeN-SIkwI,186
+langchain_community/tools/steamship_image_generation/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/steamship_image_generation/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/steamship_image_generation/__pycache__/utils.cpython-311.pyc,,
+langchain_community/tools/steamship_image_generation/tool.py,sha256=JhhchyxWEySEPleQqj5IzcUEY4dvav5cJg3ANzOkMyU,3378
+langchain_community/tools/steamship_image_generation/utils.py,sha256=nq9QXiRDKbTHWNhrUwXu4Bjx8LwfBjW4mAbzN0bgZCI,1395
+langchain_community/tools/tavily_search/__init__.py,sha256=SCJ7BPxCZfiYXYcE0FCPPpq-_WAoZWjBI2nVoJ7MRCw,189
+langchain_community/tools/tavily_search/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/tavily_search/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/tavily_search/tool.py,sha256=zBhyPI6DArydgh92uikWTAu8hFugZbx4nL6qjZrrlQw,3375
+langchain_community/tools/vectorstore/__init__.py,sha256=kheVdgDafCJHOhU5D5SBZZg9x_j5_gveZHqVhZ0pSZ8,51
+langchain_community/tools/vectorstore/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/vectorstore/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/vectorstore/tool.py,sha256=cpe-rtU1sFBTcXFuc_JzA-5bY_x9T40WCeptNIaUut0,4717
+langchain_community/tools/wikidata/__init__.py,sha256=kLlKIq2gd75ABDxD3-Mq1egWg0dJSddkRpEII3zIYkk,28
+langchain_community/tools/wikidata/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/wikidata/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/wikidata/tool.py,sha256=XcXtiMCpdR92QzlVvzdl3Xs__-0MHRccFgYAHDhFKvc,926
+langchain_community/tools/wikipedia/__init__.py,sha256=h-dMgHpibxNGwmU14vNzpEMhy7TuFPUP_d4GYXzMZZ4,29
+langchain_community/tools/wikipedia/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/wikipedia/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/wikipedia/tool.py,sha256=treCr9R7_Ij4k0ZaWFcgO9Doay0lA3e3Uy3IiKLgXWQ,867
+langchain_community/tools/wolfram_alpha/__init__.py,sha256=7qUemdGFGdV1MzNZiVVQDJQRZ7bkutn9h5tTrRuZttA,156
+langchain_community/tools/wolfram_alpha/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/wolfram_alpha/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/wolfram_alpha/tool.py,sha256=w5_NUKxWAN_aQhgP4wVsUta1GEO_jvjxXVnga0JAHG4,887
+langchain_community/tools/yahoo_finance_news.py,sha256=9wn4nptSsqivwutsGpZnSukv6MuOs80x_iQOz-_UL-I,2473
+langchain_community/tools/you/__init__.py,sha256=HKmux6jk1Qhzj8rSi6vcO_cigndNSsuZVgrQokQkmko,126
+langchain_community/tools/you/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/you/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/you/tool.py,sha256=GOsiFvUYYkEAuaBoW9ZjYHS3UUe3NI8R4FRF9iGZJtY,1355
+langchain_community/tools/youtube/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_community/tools/youtube/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/youtube/__pycache__/search.cpython-311.pyc,,
+langchain_community/tools/youtube/search.py,sha256=Sm0SsCbuQB9uBDArBoK6zMfUafwosGyt868LWLCRQqU,1729
+langchain_community/tools/zapier/__init__.py,sha256=1HpJsHgUIW2E38zayYvNCJnRez-W3wyrD5mRNYkHZBo,193
+langchain_community/tools/zapier/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/tools/zapier/__pycache__/prompt.cpython-311.pyc,,
+langchain_community/tools/zapier/__pycache__/tool.cpython-311.pyc,,
+langchain_community/tools/zapier/prompt.py,sha256=EvFDhjv9G_3PcP6TJzZyb7uFGUwoJScJnOPYIO4_O54,1182
+langchain_community/tools/zapier/tool.py,sha256=07WQQaC0z0nw_2_xenCh_x_oTu2LtwI0LNjZwiBqquQ,7812
+langchain_community/utilities/__init__.py,sha256=SBGGZlwKCG7QtcbUyfVMLrB_YxhPrXM9Oka_a717K80,11378
+langchain_community/utilities/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/alpha_vantage.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/anthropic.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/apify.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/arcee.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/arxiv.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/astradb.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/awslambda.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/bibtex.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/bing_search.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/brave_search.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/cassandra.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/clickup.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/dalle_image_generator.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/dataforseo_api_search.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/dataherald.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/dria_index.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/duckduckgo_search.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/github.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/gitlab.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/golden_query.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/google_finance.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/google_jobs.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/google_lens.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/google_places_api.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/google_scholar.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/google_search.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/google_serper.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/google_trends.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/graphql.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/infobip.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/jira.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/max_compute.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/merriam_webster.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/metaphor_search.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/nasa.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/nvidia_riva.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/opaqueprompts.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/openapi.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/openweathermap.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/outline.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/passio_nutrition_ai.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/pebblo.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/polygon.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/portkey.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/powerbi.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/pubmed.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/python.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/reddit_search.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/redis.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/requests.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/scenexplain.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/searchapi.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/searx_search.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/semanticscholar.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/serpapi.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/spark_sql.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/sql_database.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/stackexchange.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/steam.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/tavily_search.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/tensorflow_datasets.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/twilio.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/vertexai.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/wikidata.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/wikipedia.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/wolfram_alpha.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/you.cpython-311.pyc,,
+langchain_community/utilities/__pycache__/zapier.cpython-311.pyc,,
+langchain_community/utilities/alpha_vantage.py,sha256=2M19Jr6pPyh9KW8hmSnQRYJbFIztqISS7WndkZjmero,5918
+langchain_community/utilities/anthropic.py,sha256=gfED-04FxKkFyfs7yCS__DHl78ikQJZ-dBWB4nstmZ0,844
+langchain_community/utilities/apify.py,sha256=SJJjV2J3K6CiWruAU4vI3IxedmjjEfuZO-SAEZxZwRw,8458
+langchain_community/utilities/arcee.py,sha256=3SXjBxXrfJ4iAn1oIVbOqkQb4Tyo3uKrIaqwvQAf3ck,8710
+langchain_community/utilities/arxiv.py,sha256=7uNZShu7UtmEe_BDsMnelhG7ddvMWTYSg1t-UonvOJk,9703
+langchain_community/utilities/astradb.py,sha256=aQoiqyZxPnNm_ObrlW72_NxMOarHAdkqKozhNBreoxk,6104
+langchain_community/utilities/awslambda.py,sha256=a_jvi6MhGtx8MMeQ5b9SP7q8dNSFY3WJqKVPZnH67ug,2437
+langchain_community/utilities/bibtex.py,sha256=xjjQ2w2Xq4OJoxu_ubGX6xMyMMzCa9iYGTUHkM3XiY8,2499
+langchain_community/utilities/bing_search.py,sha256=1izrtzgQxjq-zi7yuhy_RSNJ-nq6Jdl81Lnw7UMHB9A,3608
+langchain_community/utilities/brave_search.py,sha256=h4HNg44xSPDtV2i5hOhCpuF-CqCYHs7SZ1CQQToetBM,2382
+langchain_community/utilities/cassandra.py,sha256=ukfa_jBsMHYxKn2xEnUtZDOZL84HIFaEio7rve1vbxI,752
+langchain_community/utilities/clickup.py,sha256=fQP_2pgBkZPxtTbRH2bH5triztlOvZs2YtDVKe_6Zh8,19800
+langchain_community/utilities/dalle_image_generator.py,sha256=IwahHPe4zHkv0_huya7QcBRj1UjrGdsFilreKTXdYPE,6377
+langchain_community/utilities/dataforseo_api_search.py,sha256=E9s8QS9BGsPe00Yv3SclzyNzWUTqvMHCZT2Gjwllv8M,7854
+langchain_community/utilities/dataherald.py,sha256=kNsDQy4ossuRQ7koQ_Up7Do_79PtqaTrGcpgYI7rNI8,2067
+langchain_community/utilities/dria_index.py,sha256=ZEDdUH-aJZNOVl2WxW4vb6dHG77FIo2Nl0wQi5lwoAs,3351
+langchain_community/utilities/duckduckgo_search.py,sha256=_8KKSwhj-8vrVfwBbHZhnov0QavhQj1ZajXlpwiJAgQ,4310
+langchain_community/utilities/github.py,sha256=R_AvcUNoZNTcXWtXVwq4y8Jy_IYCfuMAaJOl29wIA0o,32250
+langchain_community/utilities/gitlab.py,sha256=oorTBrfvURa_k_8UYuCRNF9_ecSJC1ihm80aHOn5GUY,11975
+langchain_community/utilities/golden_query.py,sha256=IeK91T8SA-eXtsg6lZhfFZ6vOcJ25iWXlunYMeKOkAM,1858
+langchain_community/utilities/google_finance.py,sha256=vkT-xpPec2jUCYSjSJ-ZV073PuRtgj9q2t8NxSJYcOo,3400
+langchain_community/utilities/google_jobs.py,sha256=kFLFjiiBKUd187Lrfw2YhCeQ5e1ywIPARmXJ2if2Vk8,2804
+langchain_community/utilities/google_lens.py,sha256=EwDT5dsrPjUApctNNfjn4czLD-0Bk9xnHEiJtjzo_e0,2874
+langchain_community/utilities/google_places_api.py,sha256=hwCbEqARUlC2NRj2TWo7foFOzFuJOkXIB7m0wgkeatc,4293
+langchain_community/utilities/google_scholar.py,sha256=I85og6IdOaC0mH_RwwnCawhY3YzBBfnUpZT6IoGoXnk,5171
+langchain_community/utilities/google_search.py,sha256=enhVLbB8OYSgL2jvyHGOBbSIRh8qFOGFw-ronnvv1tI,5236
+langchain_community/utilities/google_serper.py,sha256=mixg8bgzX_mbQ3yWe4rm4FAQ0kxe3RM378Poes1hFic,6503
+langchain_community/utilities/google_trends.py,sha256=N5Ct8Y0UbdTxE0xNGGsGkSzdy5ZEcQv7w65l0GUNDvQ,4164
+langchain_community/utilities/graphql.py,sha256=azwdjrMfXgq-0PnZqtJNps8eIXrxNipKbkK4wGDfewI,2089
+langchain_community/utilities/infobip.py,sha256=A6qdvtTwky8OMZeKpkIEOYNeTq11PWDri9_s4OJwK7I,5891
+langchain_community/utilities/jira.py,sha256=Vd98U-h7wUjN9W44kuBQOOpuyse7C9o2lLNcXxV4jS0,6195
+langchain_community/utilities/max_compute.py,sha256=WEU0NjPA2Vs7V860lwmYTA0vNfnGkIqTnRV7OIMPdNI,2647
+langchain_community/utilities/merriam_webster.py,sha256=l7_bWcsQaj1rAC4FtoIxsrPiCNMhu-Ks2Pwwo53pYhg,3748
+langchain_community/utilities/metaphor_search.py,sha256=dYsMdBc1V8K9ZtNRz06wFs1uAZCw62bd5e2hCZoFfnA,6809
+langchain_community/utilities/nasa.py,sha256=fAW5RsrfYI2ivHS8y8gmqeNXmOLmVpHx6h1NWmvgPAk,1820
+langchain_community/utilities/nvidia_riva.py,sha256=C5NG6DRO_Q5bbcarh-b88ZYj8W-m0JDDfpz89e0zYSM,21608
+langchain_community/utilities/opaqueprompts.py,sha256=L60OwawG4jW8aYp73bPYAfXYcz8aSDSLyEuEFlizFIU,3287
+langchain_community/utilities/openapi.py,sha256=vLNtWvULEexYmf91l_ubgpIZr1JtEFl43XGJU8FlzBY,11017
+langchain_community/utilities/openweathermap.py,sha256=WPXwg6KEej-VNW3SGQ6pX2vceiGs11kU5fDL88dXjfk,2462
+langchain_community/utilities/outline.py,sha256=U5gZL6oILk_cQiI1UWs03DJ4cOENN3VbqXBLYbha6Yg,3351
+langchain_community/utilities/passio_nutrition_ai.py,sha256=4uq2qDb5Pqd_NmvM5KSk_koAS7DP7vQiBDGcHTaVWgA,5520
+langchain_community/utilities/pebblo.py,sha256=8FP6mum0emO5VWipojTsF7l6dmQSQHRJr5vfrqNaOI0,7803
+langchain_community/utilities/polygon.py,sha256=WGJObVdVsq2gyFgnzVk4u4Qlci4Hvk7guvlVws_KSaw,4309
+langchain_community/utilities/portkey.py,sha256=_XK8xHhnySwASlYvMDPimJUPHOB-cqrKykcP8bHRuww,2355
+langchain_community/utilities/powerbi.py,sha256=-hWA0zLAIPYWPn1HPP7fCTRCa93Wfe7g0VKBryR9Cs4,11246
+langchain_community/utilities/pubmed.py,sha256=UHUpLZaKOjCTnY7vw3HEUVfiLIdQwZLfBE4wX7N-boU,6950
+langchain_community/utilities/python.py,sha256=cLVu_KjV60OaKrsEJcq6QZg5Ix8XIbqTEhqWTP0meeo,2159
+langchain_community/utilities/reddit_search.py,sha256=YAU5IIIEtDaQrK1dwOa42Ixp2nq8eH56bDtvtf0i6eI,4474
+langchain_community/utilities/redis.py,sha256=DTkeYOC1vfsB0PLyJHX0UzgN3QZl_mEpRDn84OLVKFE,8221
+langchain_community/utilities/requests.py,sha256=yTpMmLT_9XQdFZysyk5-cALn_4VO9FMwF8pmG6F4Eww,8793
+langchain_community/utilities/scenexplain.py,sha256=SJPD2hPDsx4UASRQvcEi4lJREGzq41_BymtVa6p0qXY,2220
+langchain_community/utilities/searchapi.py,sha256=Qg_Fpf5GBxIVQPbIBH_t9R6hs7oG5K7dGvzOTh_dk44,5226
+langchain_community/utilities/searx_search.py,sha256=uBQRk10HsBr26LCYzZj_72hAABGOSW1S2OD8afMgBUE,16653
+langchain_community/utilities/semanticscholar.py,sha256=qzkmlmlBP9Lq6E4iAVhay5RW9GdI_eW_kxDvmAoufqg,2789
+langchain_community/utilities/serpapi.py,sha256=RFC2-sLQqAP2MbjCmRPY-lPf9fgbUvT8Ah6OZGokIwc,8703
+langchain_community/utilities/spark_sql.py,sha256=gg3sZ_PQe9qX4wKd6dhg8M4iiuoz22kgjwVNwukBFF0,7519
+langchain_community/utilities/sql_database.py,sha256=hTbeEieumZuqD-jIvEXFHpQKZ3qJEFZoAN-3RonGHm8,22811
+langchain_community/utilities/stackexchange.py,sha256=8TUDsxTBqMS9LrIuZTVZIQyny9e2ukgWoqw-zqxxxx8,2639
+langchain_community/utilities/steam.py,sha256=3jaJMTBoVRWVuAURZrw70itujHMlNyDptgmSQGNdu5c,5857
+langchain_community/utilities/tavily_search.py,sha256=vzOanq2L36XaA9qds6qoUNfOpgsYsDRligBNKuz0DgY,6889
+langchain_community/utilities/tensorflow_datasets.py,sha256=I-SxGbubpU7qGJRqQ5xns7MVKZNKEfKoBZ04EHEYpmI,4006
+langchain_community/utilities/twilio.py,sha256=pVNZfkV2kP3lAP3o37RX21CATFNS7taEDyaH5wj0pkY,3441
+langchain_community/utilities/vertexai.py,sha256=cB8nB41qM-9QgY5cTyE-6_aboSLoDKKPabLlSqT8sa0,4087
+langchain_community/utilities/wikidata.py,sha256=PL8XUTqUD6yXGLbz0a7GL__HxsEFq3SykWKRM3G3vKo,5346
+langchain_community/utilities/wikipedia.py,sha256=1R1MyaRtVEe4gUNfupMB6E1Y8yIiZ6Z3zB199u1AVpk,4270
+langchain_community/utilities/wolfram_alpha.py,sha256=mau5tHMSne6OIm85huGYHLZuqam-_EyPlVSoUTJh2Fg,2011
+langchain_community/utilities/you.py,sha256=dz9_gSeD47hdxh2vpsoQzPiAgBgqzdR2pXGf2oEVATY,7951
+langchain_community/utilities/zapier.py,sha256=9wk6Ndr4OzVz7wAmu-XHjbgupgYWxdUXel7jI9Fbn9A,11666
+langchain_community/utils/__init__.py,sha256=S6zkHzdthvyPDlHZFJ7a4TKDXHEfDHCfiNYyoDIpRcM,45
+langchain_community/utils/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/utils/__pycache__/ernie_functions.cpython-311.pyc,,
+langchain_community/utils/__pycache__/google.cpython-311.pyc,,
+langchain_community/utils/__pycache__/math.cpython-311.pyc,,
+langchain_community/utils/__pycache__/openai.cpython-311.pyc,,
+langchain_community/utils/__pycache__/openai_functions.cpython-311.pyc,,
+langchain_community/utils/ernie_functions.py,sha256=90mCDHZuYMMDbAsFymKZR0ebfgFYWZ0srL_5uo8_uWo,1509
+langchain_community/utils/google.py,sha256=KyUCAJ20nbExzsMwaaNz-ZdNfnBAL8psg6t1_cuKHFA,775
+langchain_community/utils/math.py,sha256=Jln8V907DCmOd7Z8W-pGRfo4ZF3gMgnEP4R9-F-yBLs,2724
+langchain_community/utils/openai.py,sha256=CyMQI8M2ElK9t834934siW95C4vhdjcUcrkbMetFUtQ,264
+langchain_community/utils/openai_functions.py,sha256=z63FWBM1SSzqSSWVN4lSmwfRQybBkDKUIvg-SHfG42c,377
+langchain_community/vectorstores/__init__.py,sha256=6pWYqrPIk_S4bWhniLT_5hmYKcYoswLmhqRBog76-8Y,17527
+langchain_community/vectorstores/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/alibabacloud_opensearch.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/analyticdb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/annoy.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/apache_doris.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/astradb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/atlas.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/awadb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/azure_cosmos_db.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/azuresearch.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/bageldb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/baiducloud_vector_search.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/baiduvectordb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/bigquery_vector_search.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/cassandra.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/chroma.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/clarifai.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/clickhouse.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/couchbase.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/dashvector.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/databricks_vector_search.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/deeplake.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/dingo.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/documentdb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/duckdb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/ecloud_vector_search.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/elastic_vector_search.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/elasticsearch.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/epsilla.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/faiss.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/hanavector.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/hippo.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/hologres.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/infinispanvs.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/inmemory.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/jaguar.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/kdbai.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/kinetica.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/lancedb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/lantern.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/llm_rails.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/marqo.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/matching_engine.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/meilisearch.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/milvus.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/momento_vector_index.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/mongodb_atlas.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/myscale.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/neo4j_vector.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/nucliadb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/opensearch_vector_search.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/pathway.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/pgembedding.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/pgvecto_rs.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/pgvector.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/pinecone.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/qdrant.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/rocksetdb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/scann.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/semadb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/singlestoredb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/sklearn.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/sqlitevss.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/starrocks.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/supabase.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/surrealdb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/tair.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/tencentvectordb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/thirdai_neuraldb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/tidb_vector.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/tigris.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/tiledb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/timescalevector.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/typesense.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/usearch.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/utils.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/vald.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/vdms.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/vearch.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/vectara.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/vespa.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/vikingdb.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/vlite.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/weaviate.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/xata.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/yellowbrick.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/zep.cpython-311.pyc,,
+langchain_community/vectorstores/__pycache__/zilliz.cpython-311.pyc,,
+langchain_community/vectorstores/alibabacloud_opensearch.py,sha256=pli7LhoJ3kwdwP7YBMrnGCd-CNCmiuVoDo-HrDI7sP4,19806
+langchain_community/vectorstores/analyticdb.py,sha256=mzNgZrKh3RyZ4ln8SL-nv1l4Tjs5TBTMSs-Tc7_g0H0,15752
+langchain_community/vectorstores/annoy.py,sha256=dVcvQadUfopKWVkrFMGHXdUon9-LgAKvsU7E6CXxfkY,17889
+langchain_community/vectorstores/apache_doris.py,sha256=sz7NGCkKxBvFz1ZLiCi0RvM8QiJrQLPTPn72E5OT4sA,17067
+langchain_community/vectorstores/astradb.py,sha256=jrKGTQrJ3Rf0i983HZh0vNZcXyGGF9uUdUFEvR9zKMo,46743
+langchain_community/vectorstores/atlas.py,sha256=sJ32rjfvgsZ_aS8EkhzGLfVP3-1CtKoeAGd670kkz_o,12136
+langchain_community/vectorstores/awadb.py,sha256=Ow2g5h5nEBvvQMNMJTEy_SqkPKp06ubPsKBc4OcuMHo,21155
+langchain_community/vectorstores/azure_cosmos_db.py,sha256=Km_I1HueMqEgeTl2i2R2c8gtCt3p9J1_XZ3d8q6S-os,20882
+langchain_community/vectorstores/azuresearch.py,sha256=DN-5ITBnSKZ9lC02PmSMfJU74opmYGREn6RQo2b5AWM,27398
+langchain_community/vectorstores/bageldb.py,sha256=GdpMu2lBGgKkzv2I5Di64j5L73axZ_YoznBQW3-5FsM,15266
+langchain_community/vectorstores/baiducloud_vector_search.py,sha256=kwccLU16TvcaHGnM9l9p8KHiDLXakCTyL2WIl9AoE2k,16548
+langchain_community/vectorstores/baiduvectordb.py,sha256=gxZIyly6f-jxcrhwQgAgeXGuin65X6fD-XTJnM_ZETA,15271
+langchain_community/vectorstores/bigquery_vector_search.py,sha256=DtD5eJrtq2GZnOKRyvlUcyk58zdN-dULFyFXFmG7aT8,34562
+langchain_community/vectorstores/cassandra.py,sha256=ft7lxMz1sx6G7Gwg5OYhkAwK94ODgoajCZ9RjMr33e4,19049
+langchain_community/vectorstores/chroma.py,sha256=9PDFWfkxQrwTJ0wVuFKMKDHkDVOuG7BRY64dgYr1bS4,30681
+langchain_community/vectorstores/clarifai.py,sha256=VPavoZRQwU3dGNruvxORnagT8TlDRXCSUYhlSFcC7Ss,12095
+langchain_community/vectorstores/clickhouse.py,sha256=jvZfj3M4mGXo6EhnRgQt82MqbHNpPL4pEMZUHu8LAQc,20504
+langchain_community/vectorstores/couchbase.py,sha256=BIzEcDH70xEWPTvh3k_CBttrghJyXMisa5he1_l2rIk,22766
+langchain_community/vectorstores/dashvector.py,sha256=adD4LgEuDcLvL71CGKVNfZOrFXb104CLVp-x0GL7ZeA,13944
+langchain_community/vectorstores/databricks_vector_search.py,sha256=qdyrvPhy3hIhyNOAkm06iOAL8_1IyXcMIz5SDM8XvkY,23115
+langchain_community/vectorstores/deeplake.py,sha256=4w6RoaZ7E0XT9zQ9HeH9rxzOkzXbiwswH-rmHlGq7_k,42999
+langchain_community/vectorstores/dingo.py,sha256=1DI-UCsPvtJOxfkDCTnubIOFT9DnRgm4WPlDRupigAI,13208
+langchain_community/vectorstores/docarray/__init__.py,sha256=-yA5diUG1xNKEhq2okPUWwbpUzT52YB5baxVLmtbTys,236
+langchain_community/vectorstores/docarray/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/vectorstores/docarray/__pycache__/base.cpython-311.pyc,,
+langchain_community/vectorstores/docarray/__pycache__/hnsw.cpython-311.pyc,,
+langchain_community/vectorstores/docarray/__pycache__/in_memory.cpython-311.pyc,,
+langchain_community/vectorstores/docarray/base.py,sha256=oVek4Myscdiz9OzFl_Z6iLHf3_gbhaezLEHbqNHQ8Nc,7021
+langchain_community/vectorstores/docarray/hnsw.py,sha256=deS-fxzsZezNiq1exuFEvNuW6H-fRWrsY7gk9-IHg_8,4042
+langchain_community/vectorstores/docarray/in_memory.py,sha256=ZV8-KSqNCpP1wQUgAKTf9j1FV-BKdhVgXC3i4IfLp8k,2418
+langchain_community/vectorstores/documentdb.py,sha256=N3UE0EFW0wUatOZU8EBrgnJnzeeK7dFseJfuY1o7D5g,11947
+langchain_community/vectorstores/duckdb.py,sha256=J5RLZHF8ZII3ExIR-5g5rkTUoWvtoSFNBW_IwXIdA20,9991
+langchain_community/vectorstores/ecloud_vector_search.py,sha256=unxqqCB974427H7T1DdZ9w4vhlyi-M8JbYTvkUlHx9g,20611
+langchain_community/vectorstores/elastic_vector_search.py,sha256=ZUw6A_c8C2M7FMi-Oz7adKFpuRJbHq9Iv60fGMo5O-k,29007
+langchain_community/vectorstores/elasticsearch.py,sha256=IqNI9S_qA93Gz4rcugfCJAgdJ25j5F30iBocxErw8Tk,48577
+langchain_community/vectorstores/epsilla.py,sha256=pBpnw-RST7pkHQQLeivgD9xaWe2Q7wcVgOlt88dXwOw,14183
+langchain_community/vectorstores/faiss.py,sha256=JfwngC7mfnYPmwkDiapwegrvc6QnpG8tdKbQlGtE_F8,45886
+langchain_community/vectorstores/hanavector.py,sha256=cjLphjSUOCbBZ7idadMxdceO5YCMM-y4bzegURYVrVo,21981
+langchain_community/vectorstores/hippo.py,sha256=8I81N8tNOWW8XFR3kxEWkbBziRl5-l-jrWK1jtJ-fPk,26837
+langchain_community/vectorstores/hologres.py,sha256=dUq-kfiby3fQ96ciaaUQO2e57LwzCvZ_O2W60YsGRN4,13642
+langchain_community/vectorstores/infinispanvs.py,sha256=hYbUAa5ObowcuIsmMPh8gmYbKkzSwToCaONBLeSN4Co,21348
+langchain_community/vectorstores/inmemory.py,sha256=_9Y7J5n6S1G5M8v7gg1_BkBGreOWVXATX64OkXIaznw,6184
+langchain_community/vectorstores/jaguar.py,sha256=Kw5Upe5Jy_wtG32hvKMbJXucZPCqArr7wWg0HlJa_uk,14580
+langchain_community/vectorstores/kdbai.py,sha256=IZIrt_ZYcfZvloWd1RA20CGukqHkN79M6v7Xc6gHWkc,9087
+langchain_community/vectorstores/kinetica.py,sha256=ifDxHj675i3BrM_anPjE3hmz3sTp6KNQJp8ZLtHxsjs,34973
+langchain_community/vectorstores/lancedb.py,sha256=ViP_MTB-CULi8XF9ZxqfiS-HZV1QiXp2Q0MhazBhnzU,6049
+langchain_community/vectorstores/lantern.py,sha256=8Z54-i1qYqJ0cBXukbK_CjTJHtgG8gc1p6iohJlLqIY,38505
+langchain_community/vectorstores/llm_rails.py,sha256=2H_M-EnLkHpfoGqDQWj2WBx2E8S6J2BehMRAa3XWzoU,7745
+langchain_community/vectorstores/marqo.py,sha256=Ye3J54hr6_N-vzXfgH-VlRleCd18EXfkqND4BS3iLME,17075
+langchain_community/vectorstores/matching_engine.py,sha256=FaqdMVvkN8bCni7AI17pD55yorU_gdpOWD7-w8xr47c,21617
+langchain_community/vectorstores/meilisearch.py,sha256=LvTFjC5HcG9y_xZWi5lKsRNoe_Ni-prHA22q8471Kp8,12086
+langchain_community/vectorstores/milvus.py,sha256=KPli0PQpoAiMDegaTDOi_YH7TXSPnGyw0Gue4Le4xaY,41954
+langchain_community/vectorstores/momento_vector_index.py,sha256=0wkoTqWuvuS52BTrHRynO5--mbn-TW3D8F-5XkNdpOA,19047
+langchain_community/vectorstores/mongodb_atlas.py,sha256=4mRmKpUeJ7eiXmEaKYXLDrSE0yOOZI111Arhjt3pYP4,13700
+langchain_community/vectorstores/myscale.py,sha256=9IS2Sb8XY4ZCVCzRXlPaQEwwMVNmgMaF-9LdU1SsUYw,22612
+langchain_community/vectorstores/neo4j_vector.py,sha256=Nli-kg3y3sz-fgLFxfkLTs9LvOrp4e4fEYURIyniH8I,52686
+langchain_community/vectorstores/nucliadb.py,sha256=4_kaGo5Rff0XQhYnUDS_Kuvdq_Kzp79UkpX_lIGTcls,5403
+langchain_community/vectorstores/opensearch_vector_search.py,sha256=nQZe5bCB_jyRE8YmCQcSlJd7PvuNvt_hCp0l1hxHZok,47209
+langchain_community/vectorstores/pathway.py,sha256=EaE158i05IvYZkNfCRXhreX-TQxlIIbbEiHMf5Tg3To,7713
+langchain_community/vectorstores/pgembedding.py,sha256=FzRq2jp2Ff9OzWlRG_9JAmBZ6QvFWqoaS-xcJbpkVPU,17949
+langchain_community/vectorstores/pgvecto_rs.py,sha256=4zQr-UTHz5Au-id71fHBNL-7rnnqyLjF1ae5gCGI800,7838
+langchain_community/vectorstores/pgvector.py,sha256=SFFY2k0BeLVLMVUXUuIcZYwHnDFOKUjM-QxTe4_SWx0,51721
+langchain_community/vectorstores/pinecone.py,sha256=yAq8Hyv4vg0V38pS8aHfbaUsiOkwejn9LB5ii91nI3c,17678
+langchain_community/vectorstores/qdrant.py,sha256=W6Jpb2mjFx85EkNHCzHgs1uhPCEQ2ZWG0V4MONdBX58,92797
+langchain_community/vectorstores/redis/__init__.py,sha256=iDkWyYU-o8d7_mnGxK-HV8vsFtTyfEy1wJB9LY_fbSY,265
+langchain_community/vectorstores/redis/__pycache__/__init__.cpython-311.pyc,,
+langchain_community/vectorstores/redis/__pycache__/base.cpython-311.pyc,,
+langchain_community/vectorstores/redis/__pycache__/constants.cpython-311.pyc,,
+langchain_community/vectorstores/redis/__pycache__/filters.cpython-311.pyc,,
+langchain_community/vectorstores/redis/__pycache__/schema.cpython-311.pyc,,
+langchain_community/vectorstores/redis/base.py,sha256=QFScuened3Jz4z-TRWA7y_-UaSBzLIO_JJ8Pd0xTyxo,56019
+langchain_community/vectorstores/redis/constants.py,sha256=IDLancB3c8EZgvx4fun3cx-zSTirqomE3vfX5bqgRqo,420
+langchain_community/vectorstores/redis/filters.py,sha256=SimDhUhfDxOpmG4Z0Z6zWIcw1l_l-7ln-ZtrWJzHiNM,16219
+langchain_community/vectorstores/redis/schema.py,sha256=DXirW4TzboVNcq3iKng34P7zQ7OfX4eo2ua7A9PaSQ0,10418
+langchain_community/vectorstores/rocksetdb.py,sha256=7IBs8RNFz7gnjVMMf1aUXjG_WYDguthpaGnyUUo7cnI,15235
+langchain_community/vectorstores/scann.py,sha256=5RBwhT06yDP2nWHQ0My2I_3jv6qrHRtGSHv13PXegDo,20867
+langchain_community/vectorstores/semadb.py,sha256=5FQlquVsbzwJeLGRsmlFAbS3-9iFB0G3Aj0AvVLn6H4,9721
+langchain_community/vectorstores/singlestoredb.py,sha256=XOojggW47Ou64ynFVw40szYyChW9buAsvW4kplKkl4g,22445
+langchain_community/vectorstores/sklearn.py,sha256=mSCaAegThkyEEMamyf_B-4ifldf2eL0GlhGVsv7D8z0,12372
+langchain_community/vectorstores/sqlitevss.py,sha256=XDSK0sxxrMavXBNtsB5iK3qo7xWsc4dC7-oFdKwHzSw,7302
+langchain_community/vectorstores/starrocks.py,sha256=WYs8InjMRXMFANmG3lEK4CTe6zTTalC9H4Dj8S04HIM,17220
+langchain_community/vectorstores/supabase.py,sha256=TVSIEI-vjcx2K_lTAGgLBexjy25t-rhByVa68fiYCI4,15689
+langchain_community/vectorstores/surrealdb.py,sha256=ijPaqvpD71bsQvYXfysqeCksTqH8MIx1OKKxREggG2o,15428
+langchain_community/vectorstores/tair.py,sha256=GjcUb8NtwiDAAxVlKFDx9Ww3XE9cbiEacn_TkFDkVXE,9557
+langchain_community/vectorstores/tencentvectordb.py,sha256=Ha3oP-VDmBIi_a8D4KlU2YOCkU-mXiYHQwgN1-VDLwA,20283
+langchain_community/vectorstores/thirdai_neuraldb.py,sha256=zXhWCr6z0IaIhGm-sTKzu89vCDyWbqROMD7G83D6rk8,11579
+langchain_community/vectorstores/tidb_vector.py,sha256=vtGTb4WE1uvtl-Cz5cyMbHSy9xJ73Cmb_IiTTYmYLCM,13630
+langchain_community/vectorstores/tigris.py,sha256=gTik_ffTEzZwx_jvv8K4c9wct--NAKv2CrgpEJEU_RQ,4927
+langchain_community/vectorstores/tiledb.py,sha256=dtIOPdHIHdtPEV9lPzhhx6Gjf5TACn9qHjIpztmer3k,29855
+langchain_community/vectorstores/timescalevector.py,sha256=toEhyyrzrcZb37ClFjmOOPa6L5QzrtTfZkJDOxZQoTw,29831
+langchain_community/vectorstores/typesense.py,sha256=EYkwptf2Y69Lak-sjarlzarynQ2Rq2bGOgi9_QGUdR0,9712
+langchain_community/vectorstores/usearch.py,sha256=Fg8ak9xirIYD99z4WC11AzHtlpSJT6I7zPXhi0oSrQU,5888
+langchain_community/vectorstores/utils.py,sha256=smPoWsr4YqkKNFHSh0dL4b-IHd7-3JtJXzWy9PeugDc,2474
+langchain_community/vectorstores/vald.py,sha256=0MljbGD0JWBtTF1UHslkYWZDcJ3jfoXRX4DtH8UaqlE,12893
+langchain_community/vectorstores/vdms.py,sha256=k4gfdWbLVq88IlIP1qRdwcPicJTZfmjPiUo92ZDzDgQ,53231
+langchain_community/vectorstores/vearch.py,sha256=GB8LfuGe9vt9It8asxU88H3MfOPTEvrodRDQUxAj-c8,19844
+langchain_community/vectorstores/vectara.py,sha256=YYy34zwSYZoSic5vNyskr52g_7A2z6gzet2I4GjKH5s,21908
+langchain_community/vectorstores/vespa.py,sha256=imkab4hk2dU1NrYKhUeAXAguyGu7jHqEipeT7EEwQb8,9785
+langchain_community/vectorstores/vikingdb.py,sha256=e-WR9km50xrM03VLbrrLWnQguyyhxUEk35RU1t96BBg,15136
+langchain_community/vectorstores/vlite.py,sha256=XDOeTBGSs3J0cVAlh5fn8ima1MCWuF2y8gwa4pLXmho,8145
+langchain_community/vectorstores/weaviate.py,sha256=-OkrAzU7e07FmOzZqhQ_tH-QrrW14X4oR4coEEw57eI,19253
+langchain_community/vectorstores/xata.py,sha256=exOCjUkNDwcomKG_LIfnYGR1e3MoTR_Rton3AzknRx8,9032
+langchain_community/vectorstores/yellowbrick.py,sha256=ji0HXBxr8eZmSTMZodM6ZlcIsLpPITlJoQ_RXURuVWk,10747
+langchain_community/vectorstores/zep.py,sha256=6GleOCXi-xYgjW86-juutFtWPSiFA0eDVkJZPTqK-S0,23192
+langchain_community/vectorstores/zilliz.py,sha256=rfxos8nuBaqnM7AqA2qnlo4wYJeajCefptyzLK6C-nQ,8255
diff --git a/llm/Lib/site-packages/langchain_community-0.0.34.dist-info/WHEEL b/llm/Lib/site-packages/langchain_community-0.0.34.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..7c881525d384f1537e81e8a783c8433a748a7089
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community-0.0.34.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 1.8.1
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/langchain_community/__init__.py b/llm/Lib/site-packages/langchain_community/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ac7aeef6faf26d7244d6677e200de12565a73fef
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/__init__.py
@@ -0,0 +1,9 @@
+"""Main entrypoint into package."""
+from importlib import metadata
+
+try:
+    __version__ = metadata.version(__package__)
+except metadata.PackageNotFoundError:
+    # Case where package metadata is not available.
+    __version__ = ""
+del metadata  # optional, avoids polluting the results of dir(__package__)
diff --git a/llm/Lib/site-packages/langchain_community/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8bf1ceb2b4d4d83538dad0b6785dcc5c2628cc46
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/__pycache__/cache.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/__pycache__/cache.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d3770e12c1695e0e0f87a1afec880564ec851420
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/__pycache__/cache.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/adapters/__init__.py b/llm/Lib/site-packages/langchain_community/adapters/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3834e1853e4a4f7255006f6ce6b1ea25a12b236c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/adapters/__init__.py
@@ -0,0 +1,8 @@
+"""**Adapters** are used to adapt LangChain models to other APIs.
+
+LangChain integrates with many model providers.
+While LangChain has its own message and model APIs,
+LangChain has also made it as easy as
+possible to explore other models by exposing an **adapter** to adapt LangChain
+models to the other APIs, as to the OpenAI API.
+"""
diff --git a/llm/Lib/site-packages/langchain_community/adapters/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/adapters/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..75a25a148cb672ee73ea2ab6f37514b8c6ae74b3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/adapters/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/adapters/__pycache__/openai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/adapters/__pycache__/openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6551f4a39d9cbe49da2ce4f804e1ecb9199ac524
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/adapters/__pycache__/openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/adapters/openai.py b/llm/Lib/site-packages/langchain_community/adapters/openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..e6ff136f7a7c3d9b8ec3dbdf4c0c81ff26442226
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/adapters/openai.py
@@ -0,0 +1,416 @@
+from __future__ import annotations
+
+import importlib
+from typing import (
+    Any,
+    AsyncIterator,
+    Dict,
+    Iterable,
+    List,
+    Mapping,
+    Sequence,
+    Union,
+    overload,
+)
+
+from langchain_core.chat_sessions import ChatSession
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    FunctionMessage,
+    HumanMessage,
+    SystemMessage,
+    ToolMessage,
+)
+from langchain_core.pydantic_v1 import BaseModel
+from typing_extensions import Literal
+
+
+async def aenumerate(
+    iterable: AsyncIterator[Any], start: int = 0
+) -> AsyncIterator[tuple[int, Any]]:
+    """Async version of enumerate function."""
+    i = start
+    async for x in iterable:
+        yield i, x
+        i += 1
+
+
+class IndexableBaseModel(BaseModel):
+    """Allows a BaseModel to return its fields by string variable indexing."""
+
+    def __getitem__(self, item: str) -> Any:
+        return getattr(self, item)
+
+
+class Choice(IndexableBaseModel):
+    """Choice."""
+
+    message: dict
+
+
+class ChatCompletions(IndexableBaseModel):
+    """Chat completions."""
+
+    choices: List[Choice]
+
+
+class ChoiceChunk(IndexableBaseModel):
+    """Choice chunk."""
+
+    delta: dict
+
+
+class ChatCompletionChunk(IndexableBaseModel):
+    """Chat completion chunk."""
+
+    choices: List[ChoiceChunk]
+
+
+def convert_dict_to_message(_dict: Mapping[str, Any]) -> BaseMessage:
+    """Convert a dictionary to a LangChain message.
+
+    Args:
+        _dict: The dictionary.
+
+    Returns:
+        The LangChain message.
+    """
+    role = _dict.get("role")
+    if role == "user":
+        return HumanMessage(content=_dict.get("content", ""))
+    elif role == "assistant":
+        # Fix for azure
+        # Also OpenAI returns None for tool invocations
+        content = _dict.get("content", "") or ""
+        additional_kwargs: Dict = {}
+        if function_call := _dict.get("function_call"):
+            additional_kwargs["function_call"] = dict(function_call)
+        if tool_calls := _dict.get("tool_calls"):
+            additional_kwargs["tool_calls"] = tool_calls
+        return AIMessage(content=content, additional_kwargs=additional_kwargs)
+    elif role == "system":
+        return SystemMessage(content=_dict.get("content", ""))
+    elif role == "function":
+        return FunctionMessage(content=_dict.get("content", ""), name=_dict.get("name"))
+    elif role == "tool":
+        additional_kwargs = {}
+        if "name" in _dict:
+            additional_kwargs["name"] = _dict["name"]
+        return ToolMessage(
+            content=_dict.get("content", ""),
+            tool_call_id=_dict.get("tool_call_id"),
+            additional_kwargs=additional_kwargs,
+        )
+    else:
+        return ChatMessage(content=_dict.get("content", ""), role=role)
+
+
+def convert_message_to_dict(message: BaseMessage) -> dict:
+    """Convert a LangChain message to a dictionary.
+
+    Args:
+        message: The LangChain message.
+
+    Returns:
+        The dictionary.
+    """
+    message_dict: Dict[str, Any]
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": message.role, "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+        if "function_call" in message.additional_kwargs:
+            message_dict["function_call"] = message.additional_kwargs["function_call"]
+            # If function call only, content is None not empty string
+            if message_dict["content"] == "":
+                message_dict["content"] = None
+        if "tool_calls" in message.additional_kwargs:
+            message_dict["tool_calls"] = message.additional_kwargs["tool_calls"]
+            # If tool calls only, content is None not empty string
+            if message_dict["content"] == "":
+                message_dict["content"] = None
+    elif isinstance(message, SystemMessage):
+        message_dict = {"role": "system", "content": message.content}
+    elif isinstance(message, FunctionMessage):
+        message_dict = {
+            "role": "function",
+            "content": message.content,
+            "name": message.name,
+        }
+    elif isinstance(message, ToolMessage):
+        message_dict = {
+            "role": "tool",
+            "content": message.content,
+            "tool_call_id": message.tool_call_id,
+        }
+    else:
+        raise TypeError(f"Got unknown type {message}")
+    if "name" in message.additional_kwargs:
+        message_dict["name"] = message.additional_kwargs["name"]
+    return message_dict
+
+
+def convert_openai_messages(messages: Sequence[Dict[str, Any]]) -> List[BaseMessage]:
+    """Convert dictionaries representing OpenAI messages to LangChain format.
+
+    Args:
+        messages: List of dictionaries representing OpenAI messages
+
+    Returns:
+        List of LangChain BaseMessage objects.
+    """
+    return [convert_dict_to_message(m) for m in messages]
+
+
+def _convert_message_chunk(chunk: BaseMessageChunk, i: int) -> dict:
+    _dict: Dict[str, Any] = {}
+    if isinstance(chunk, AIMessageChunk):
+        if i == 0:
+            # Only shows up in the first chunk
+            _dict["role"] = "assistant"
+        if "function_call" in chunk.additional_kwargs:
+            _dict["function_call"] = chunk.additional_kwargs["function_call"]
+            # If the first chunk is a function call, the content is not empty string,
+            # not missing, but None.
+            if i == 0:
+                _dict["content"] = None
+        else:
+            _dict["content"] = chunk.content
+    else:
+        raise ValueError(f"Got unexpected streaming chunk type: {type(chunk)}")
+    # This only happens at the end of streams, and OpenAI returns as empty dict
+    if _dict == {"content": ""}:
+        _dict = {}
+    return _dict
+
+
+def _convert_message_chunk_to_delta(chunk: BaseMessageChunk, i: int) -> Dict[str, Any]:
+    _dict = _convert_message_chunk(chunk, i)
+    return {"choices": [{"delta": _dict}]}
+
+
+class ChatCompletion:
+    """Chat completion."""
+
+    @overload
+    @staticmethod
+    def create(
+        messages: Sequence[Dict[str, Any]],
+        *,
+        provider: str = "ChatOpenAI",
+        stream: Literal[False] = False,
+        **kwargs: Any,
+    ) -> dict:
+        ...
+
+    @overload
+    @staticmethod
+    def create(
+        messages: Sequence[Dict[str, Any]],
+        *,
+        provider: str = "ChatOpenAI",
+        stream: Literal[True],
+        **kwargs: Any,
+    ) -> Iterable:
+        ...
+
+    @staticmethod
+    def create(
+        messages: Sequence[Dict[str, Any]],
+        *,
+        provider: str = "ChatOpenAI",
+        stream: bool = False,
+        **kwargs: Any,
+    ) -> Union[dict, Iterable]:
+        models = importlib.import_module("langchain.chat_models")
+        model_cls = getattr(models, provider)
+        model_config = model_cls(**kwargs)
+        converted_messages = convert_openai_messages(messages)
+        if not stream:
+            result = model_config.invoke(converted_messages)
+            return {"choices": [{"message": convert_message_to_dict(result)}]}
+        else:
+            return (
+                _convert_message_chunk_to_delta(c, i)
+                for i, c in enumerate(model_config.stream(converted_messages))
+            )
+
+    @overload
+    @staticmethod
+    async def acreate(
+        messages: Sequence[Dict[str, Any]],
+        *,
+        provider: str = "ChatOpenAI",
+        stream: Literal[False] = False,
+        **kwargs: Any,
+    ) -> dict:
+        ...
+
+    @overload
+    @staticmethod
+    async def acreate(
+        messages: Sequence[Dict[str, Any]],
+        *,
+        provider: str = "ChatOpenAI",
+        stream: Literal[True],
+        **kwargs: Any,
+    ) -> AsyncIterator:
+        ...
+
+    @staticmethod
+    async def acreate(
+        messages: Sequence[Dict[str, Any]],
+        *,
+        provider: str = "ChatOpenAI",
+        stream: bool = False,
+        **kwargs: Any,
+    ) -> Union[dict, AsyncIterator]:
+        models = importlib.import_module("langchain.chat_models")
+        model_cls = getattr(models, provider)
+        model_config = model_cls(**kwargs)
+        converted_messages = convert_openai_messages(messages)
+        if not stream:
+            result = await model_config.ainvoke(converted_messages)
+            return {"choices": [{"message": convert_message_to_dict(result)}]}
+        else:
+            return (
+                _convert_message_chunk_to_delta(c, i)
+                async for i, c in aenumerate(model_config.astream(converted_messages))
+            )
+
+
+def _has_assistant_message(session: ChatSession) -> bool:
+    """Check if chat session has an assistant message."""
+    return any([isinstance(m, AIMessage) for m in session["messages"]])
+
+
+def convert_messages_for_finetuning(
+    sessions: Iterable[ChatSession],
+) -> List[List[dict]]:
+    """Convert messages to a list of lists of dictionaries for fine-tuning.
+
+    Args:
+        sessions: The chat sessions.
+
+    Returns:
+        The list of lists of dictionaries.
+    """
+    return [
+        [convert_message_to_dict(s) for s in session["messages"]]
+        for session in sessions
+        if _has_assistant_message(session)
+    ]
+
+
+class Completions:
+    """Completions."""
+
+    @overload
+    @staticmethod
+    def create(
+        messages: Sequence[Dict[str, Any]],
+        *,
+        provider: str = "ChatOpenAI",
+        stream: Literal[False] = False,
+        **kwargs: Any,
+    ) -> ChatCompletions:
+        ...
+
+    @overload
+    @staticmethod
+    def create(
+        messages: Sequence[Dict[str, Any]],
+        *,
+        provider: str = "ChatOpenAI",
+        stream: Literal[True],
+        **kwargs: Any,
+    ) -> Iterable:
+        ...
+
+    @staticmethod
+    def create(
+        messages: Sequence[Dict[str, Any]],
+        *,
+        provider: str = "ChatOpenAI",
+        stream: bool = False,
+        **kwargs: Any,
+    ) -> Union[ChatCompletions, Iterable]:
+        models = importlib.import_module("langchain.chat_models")
+        model_cls = getattr(models, provider)
+        model_config = model_cls(**kwargs)
+        converted_messages = convert_openai_messages(messages)
+        if not stream:
+            result = model_config.invoke(converted_messages)
+            return ChatCompletions(
+                choices=[Choice(message=convert_message_to_dict(result))]
+            )
+        else:
+            return (
+                ChatCompletionChunk(
+                    choices=[ChoiceChunk(delta=_convert_message_chunk(c, i))]
+                )
+                for i, c in enumerate(model_config.stream(converted_messages))
+            )
+
+    @overload
+    @staticmethod
+    async def acreate(
+        messages: Sequence[Dict[str, Any]],
+        *,
+        provider: str = "ChatOpenAI",
+        stream: Literal[False] = False,
+        **kwargs: Any,
+    ) -> ChatCompletions:
+        ...
+
+    @overload
+    @staticmethod
+    async def acreate(
+        messages: Sequence[Dict[str, Any]],
+        *,
+        provider: str = "ChatOpenAI",
+        stream: Literal[True],
+        **kwargs: Any,
+    ) -> AsyncIterator:
+        ...
+
+    @staticmethod
+    async def acreate(
+        messages: Sequence[Dict[str, Any]],
+        *,
+        provider: str = "ChatOpenAI",
+        stream: bool = False,
+        **kwargs: Any,
+    ) -> Union[ChatCompletions, AsyncIterator]:
+        models = importlib.import_module("langchain.chat_models")
+        model_cls = getattr(models, provider)
+        model_config = model_cls(**kwargs)
+        converted_messages = convert_openai_messages(messages)
+        if not stream:
+            result = await model_config.ainvoke(converted_messages)
+            return ChatCompletions(
+                choices=[Choice(message=convert_message_to_dict(result))]
+            )
+        else:
+            return (
+                ChatCompletionChunk(
+                    choices=[ChoiceChunk(delta=_convert_message_chunk(c, i))]
+                )
+                async for i, c in aenumerate(model_config.astream(converted_messages))
+            )
+
+
+class Chat:
+    """Chat."""
+
+    def __init__(self) -> None:
+        self.completions = Completions()
+
+
+chat = Chat()
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..305ffc007699f3800043ff960d618dbd7896ca53
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/__init__.py
@@ -0,0 +1,170 @@
+"""**Toolkits** are sets of tools that can be used to interact with
+various services and APIs.
+"""
+
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.agent_toolkits.ainetwork.toolkit import (
+        AINetworkToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.amadeus.toolkit import (
+        AmadeusToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.azure_ai_services import (
+        AzureAiServicesToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.azure_cognitive_services import (
+        AzureCognitiveServicesToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.cogniswitch.toolkit import (
+        CogniswitchToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.connery import (
+        ConneryToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.file_management.toolkit import (
+        FileManagementToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.gmail.toolkit import (
+        GmailToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.jira.toolkit import (
+        JiraToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.json.base import (
+        create_json_agent,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.json.toolkit import (
+        JsonToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.multion.toolkit import (
+        MultionToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.nasa.toolkit import (
+        NasaToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.nla.toolkit import (
+        NLAToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.office365.toolkit import (
+        O365Toolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.openapi.base import (
+        create_openapi_agent,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.openapi.toolkit import (
+        OpenAPIToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.playwright.toolkit import (
+        PlayWrightBrowserToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.polygon.toolkit import (
+        PolygonToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.powerbi.base import (
+        create_pbi_agent,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.powerbi.chat_base import (
+        create_pbi_chat_agent,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.powerbi.toolkit import (
+        PowerBIToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.slack.toolkit import (
+        SlackToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.spark_sql.base import (
+        create_spark_sql_agent,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.spark_sql.toolkit import (
+        SparkSQLToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.sql.base import (
+        create_sql_agent,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.sql.toolkit import (
+        SQLDatabaseToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.steam.toolkit import (
+        SteamToolkit,  # noqa: F401
+    )
+    from langchain_community.agent_toolkits.zapier.toolkit import (
+        ZapierToolkit,  # noqa: F401
+    )
+
+__all__ = [
+    "AINetworkToolkit",
+    "AmadeusToolkit",
+    "AzureAiServicesToolkit",
+    "AzureCognitiveServicesToolkit",
+    "CogniswitchToolkit",
+    "ConneryToolkit",
+    "FileManagementToolkit",
+    "GmailToolkit",
+    "JiraToolkit",
+    "JsonToolkit",
+    "MultionToolkit",
+    "NLAToolkit",
+    "NasaToolkit",
+    "O365Toolkit",
+    "OpenAPIToolkit",
+    "PlayWrightBrowserToolkit",
+    "PolygonToolkit",
+    "PowerBIToolkit",
+    "SQLDatabaseToolkit",
+    "SlackToolkit",
+    "SparkSQLToolkit",
+    "SteamToolkit",
+    "ZapierToolkit",
+    "create_json_agent",
+    "create_openapi_agent",
+    "create_pbi_agent",
+    "create_pbi_chat_agent",
+    "create_spark_sql_agent",
+    "create_sql_agent",
+]
+
+
+_module_lookup = {
+    "AINetworkToolkit": "langchain_community.agent_toolkits.ainetwork.toolkit",
+    "AmadeusToolkit": "langchain_community.agent_toolkits.amadeus.toolkit",
+    "AzureAiServicesToolkit": "langchain_community.agent_toolkits.azure_ai_services",
+    "AzureCognitiveServicesToolkit": "langchain_community.agent_toolkits.azure_cognitive_services",  # noqa: E501
+    "CogniswitchToolkit": "langchain_community.agent_toolkits.cogniswitch.toolkit",
+    "ConneryToolkit": "langchain_community.agent_toolkits.connery",
+    "FileManagementToolkit": "langchain_community.agent_toolkits.file_management.toolkit",  # noqa: E501
+    "GmailToolkit": "langchain_community.agent_toolkits.gmail.toolkit",
+    "JiraToolkit": "langchain_community.agent_toolkits.jira.toolkit",
+    "JsonToolkit": "langchain_community.agent_toolkits.json.toolkit",
+    "MultionToolkit": "langchain_community.agent_toolkits.multion.toolkit",
+    "NLAToolkit": "langchain_community.agent_toolkits.nla.toolkit",
+    "NasaToolkit": "langchain_community.agent_toolkits.nasa.toolkit",
+    "O365Toolkit": "langchain_community.agent_toolkits.office365.toolkit",
+    "OpenAPIToolkit": "langchain_community.agent_toolkits.openapi.toolkit",
+    "PlayWrightBrowserToolkit": "langchain_community.agent_toolkits.playwright.toolkit",
+    "PolygonToolkit": "langchain_community.agent_toolkits.polygon.toolkit",
+    "PowerBIToolkit": "langchain_community.agent_toolkits.powerbi.toolkit",
+    "SQLDatabaseToolkit": "langchain_community.agent_toolkits.sql.toolkit",
+    "SlackToolkit": "langchain_community.agent_toolkits.slack.toolkit",
+    "SparkSQLToolkit": "langchain_community.agent_toolkits.spark_sql.toolkit",
+    "SteamToolkit": "langchain_community.agent_toolkits.steam.toolkit",
+    "ZapierToolkit": "langchain_community.agent_toolkits.zapier.toolkit",
+    "create_json_agent": "langchain_community.agent_toolkits.json.base",
+    "create_openapi_agent": "langchain_community.agent_toolkits.openapi.base",
+    "create_pbi_agent": "langchain_community.agent_toolkits.powerbi.base",
+    "create_pbi_chat_agent": "langchain_community.agent_toolkits.powerbi.chat_base",
+    "create_spark_sql_agent": "langchain_community.agent_toolkits.spark_sql.base",
+    "create_sql_agent": "langchain_community.agent_toolkits.sql.base",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..941f4205967b73a8dbdac7c35987f94d743b22a4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/__pycache__/azure_ai_services.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/__pycache__/azure_ai_services.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9e7064d3b219b452849b1d15e846e60cb487a7f2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/__pycache__/azure_ai_services.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/__pycache__/azure_cognitive_services.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/__pycache__/azure_cognitive_services.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8d7c53002472260d998c5398054ccf3ba275fd9b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/__pycache__/azure_cognitive_services.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e5978292df4c2acaa11fca455a9f41962d134741
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/ainetwork/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/ainetwork/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4295f2ef4886a3a6e862ed49c0050d3d9b8fc46
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/ainetwork/__init__.py
@@ -0,0 +1 @@
+"""AINetwork toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/ainetwork/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/ainetwork/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7afd0465a7e64ce81fef36cd9f444e10e8e90230
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/ainetwork/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/ainetwork/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/ainetwork/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d789b0f4cfbbed22996e44f93354714b71a410f9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/ainetwork/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/ainetwork/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/ainetwork/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..3e0c140e99ca973f0c89329caa9a138219c130b0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/ainetwork/toolkit.py
@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List, Literal, Optional
+
+from langchain_core.pydantic_v1 import root_validator
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.ainetwork.app import AINAppOps
+from langchain_community.tools.ainetwork.owner import AINOwnerOps
+from langchain_community.tools.ainetwork.rule import AINRuleOps
+from langchain_community.tools.ainetwork.transfer import AINTransfer
+from langchain_community.tools.ainetwork.utils import authenticate
+from langchain_community.tools.ainetwork.value import AINValueOps
+
+if TYPE_CHECKING:
+    from ain.ain import Ain
+
+
+class AINetworkToolkit(BaseToolkit):
+    """Toolkit for interacting with AINetwork Blockchain.
+
+    *Security Note*: This toolkit contains tools that can read and modify
+        the state of a service; e.g., by reading, creating, updating, deleting
+        data associated with this service.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    network: Optional[Literal["mainnet", "testnet"]] = "testnet"
+    interface: Optional[Ain] = None
+
+    @root_validator(pre=True)
+    def set_interface(cls, values: dict) -> dict:
+        if not values.get("interface"):
+            values["interface"] = authenticate(network=values.get("network", "testnet"))
+        return values
+
+    class Config:
+        """Pydantic config."""
+
+        validate_all = True
+        arbitrary_types_allowed = True
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return [
+            AINAppOps(),
+            AINOwnerOps(),
+            AINRuleOps(),
+            AINTransfer(),
+            AINValueOps(),
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/amadeus/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/amadeus/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/amadeus/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/amadeus/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..68fc211f8aaa8d92dbb594ff3ba581afc9468697
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/amadeus/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/amadeus/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/amadeus/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..feafdaa937e51a6bc3716560e56280e66a47bc37
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/amadeus/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/amadeus/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/amadeus/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..b4d59a96e928b90860bf41a155847f335dffb639
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/amadeus/toolkit.py
@@ -0,0 +1,34 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List, Optional
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.pydantic_v1 import Field
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.amadeus.closest_airport import AmadeusClosestAirport
+from langchain_community.tools.amadeus.flight_search import AmadeusFlightSearch
+from langchain_community.tools.amadeus.utils import authenticate
+
+if TYPE_CHECKING:
+    from amadeus import Client
+
+
+class AmadeusToolkit(BaseToolkit):
+    """Toolkit for interacting with Amadeus which offers APIs for travel."""
+
+    client: Client = Field(default_factory=authenticate)
+    llm: Optional[BaseLanguageModel] = Field(default=None)
+
+    class Config:
+        """Pydantic config."""
+
+        arbitrary_types_allowed = True
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return [
+            AmadeusClosestAirport(llm=self.llm),
+            AmadeusFlightSearch(),
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/azure_ai_services.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/azure_ai_services.py
new file mode 100644
index 0000000000000000000000000000000000000000..a83bd73a0357ddd8f3b28d825d741fe78613e228
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/azure_ai_services.py
@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from typing import List
+
+from langchain_core.tools import BaseTool
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools.azure_ai_services import (
+    AzureAiServicesDocumentIntelligenceTool,
+    AzureAiServicesImageAnalysisTool,
+    AzureAiServicesSpeechToTextTool,
+    AzureAiServicesTextAnalyticsForHealthTool,
+    AzureAiServicesTextToSpeechTool,
+)
+
+
+class AzureAiServicesToolkit(BaseToolkit):
+    """Toolkit for Azure AI Services."""
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+
+        tools: List[BaseTool] = [
+            AzureAiServicesDocumentIntelligenceTool(),
+            AzureAiServicesImageAnalysisTool(),
+            AzureAiServicesSpeechToTextTool(),
+            AzureAiServicesTextToSpeechTool(),
+            AzureAiServicesTextAnalyticsForHealthTool(),
+        ]
+
+        return tools
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/azure_cognitive_services.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/azure_cognitive_services.py
new file mode 100644
index 0000000000000000000000000000000000000000..3c2de898ae4b6f52fbe749c7fa52af811ee3a854
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/azure_cognitive_services.py
@@ -0,0 +1,34 @@
+from __future__ import annotations
+
+import sys
+from typing import List
+
+from langchain_core.tools import BaseTool
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools.azure_cognitive_services import (
+    AzureCogsFormRecognizerTool,
+    AzureCogsImageAnalysisTool,
+    AzureCogsSpeech2TextTool,
+    AzureCogsText2SpeechTool,
+    AzureCogsTextAnalyticsHealthTool,
+)
+
+
+class AzureCognitiveServicesToolkit(BaseToolkit):
+    """Toolkit for Azure Cognitive Services."""
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+
+        tools: List[BaseTool] = [
+            AzureCogsFormRecognizerTool(),
+            AzureCogsSpeech2TextTool(),
+            AzureCogsText2SpeechTool(),
+            AzureCogsTextAnalyticsHealthTool(),
+        ]
+
+        # TODO: Remove check once azure-ai-vision supports MacOS.
+        if sys.platform.startswith("linux") or sys.platform.startswith("win"):
+            tools.append(AzureCogsImageAnalysisTool())
+        return tools
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/base.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..0315184115e4cb46f1e0cb8f767239a7466aec3c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/base.py
@@ -0,0 +1,15 @@
+"""Toolkits for agents."""
+from abc import ABC, abstractmethod
+from typing import List
+
+from langchain_core.pydantic_v1 import BaseModel
+
+from langchain_community.tools import BaseTool
+
+
+class BaseToolkit(BaseModel, ABC):
+    """Base Toolkit representing a collection of related tools."""
+
+    @abstractmethod
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/clickup/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/clickup/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/clickup/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/clickup/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b833da982ccc7db3918fe054aeda0f1db7f1460
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/clickup/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/clickup/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/clickup/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f09b87fad4eb1fddce53bb2fdf1ed21e0cf668d5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/clickup/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/clickup/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/clickup/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..23a1c9a76c8e915abbba84f4c1defa14690ba129
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/clickup/toolkit.py
@@ -0,0 +1,108 @@
+from typing import Dict, List
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.clickup.prompt import (
+    CLICKUP_FOLDER_CREATE_PROMPT,
+    CLICKUP_GET_ALL_TEAMS_PROMPT,
+    CLICKUP_GET_FOLDERS_PROMPT,
+    CLICKUP_GET_LIST_PROMPT,
+    CLICKUP_GET_SPACES_PROMPT,
+    CLICKUP_GET_TASK_ATTRIBUTE_PROMPT,
+    CLICKUP_GET_TASK_PROMPT,
+    CLICKUP_LIST_CREATE_PROMPT,
+    CLICKUP_TASK_CREATE_PROMPT,
+    CLICKUP_UPDATE_TASK_ASSIGNEE_PROMPT,
+    CLICKUP_UPDATE_TASK_PROMPT,
+)
+from langchain_community.tools.clickup.tool import ClickupAction
+from langchain_community.utilities.clickup import ClickupAPIWrapper
+
+
+class ClickupToolkit(BaseToolkit):
+    """Clickup Toolkit.
+
+    *Security Note*: This toolkit contains tools that can read and modify
+        the state of a service; e.g., by reading, creating, updating, deleting
+        data associated with this service.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    tools: List[BaseTool] = []
+
+    @classmethod
+    def from_clickup_api_wrapper(
+        cls, clickup_api_wrapper: ClickupAPIWrapper
+    ) -> "ClickupToolkit":
+        operations: List[Dict] = [
+            {
+                "mode": "get_task",
+                "name": "Get task",
+                "description": CLICKUP_GET_TASK_PROMPT,
+            },
+            {
+                "mode": "get_task_attribute",
+                "name": "Get task attribute",
+                "description": CLICKUP_GET_TASK_ATTRIBUTE_PROMPT,
+            },
+            {
+                "mode": "get_teams",
+                "name": "Get Teams",
+                "description": CLICKUP_GET_ALL_TEAMS_PROMPT,
+            },
+            {
+                "mode": "create_task",
+                "name": "Create Task",
+                "description": CLICKUP_TASK_CREATE_PROMPT,
+            },
+            {
+                "mode": "create_list",
+                "name": "Create List",
+                "description": CLICKUP_LIST_CREATE_PROMPT,
+            },
+            {
+                "mode": "create_folder",
+                "name": "Create Folder",
+                "description": CLICKUP_FOLDER_CREATE_PROMPT,
+            },
+            {
+                "mode": "get_list",
+                "name": "Get all lists in the space",
+                "description": CLICKUP_GET_LIST_PROMPT,
+            },
+            {
+                "mode": "get_folders",
+                "name": "Get all folders in the workspace",
+                "description": CLICKUP_GET_FOLDERS_PROMPT,
+            },
+            {
+                "mode": "get_spaces",
+                "name": "Get all spaces in the workspace",
+                "description": CLICKUP_GET_SPACES_PROMPT,
+            },
+            {
+                "mode": "update_task",
+                "name": "Update task",
+                "description": CLICKUP_UPDATE_TASK_PROMPT,
+            },
+            {
+                "mode": "update_task_assignees",
+                "name": "Update task assignees",
+                "description": CLICKUP_UPDATE_TASK_ASSIGNEE_PROMPT,
+            },
+        ]
+        tools = [
+            ClickupAction(
+                name=action["name"],
+                description=action["description"],
+                mode=action["mode"],
+                api_wrapper=clickup_api_wrapper,
+            )
+            for action in operations
+        ]
+        return cls(tools=tools)
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return self.tools
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/cogniswitch/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/cogniswitch/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..df1d84976c49a8fd9f1c3bc0c8190b65a46c7df6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/cogniswitch/__init__.py
@@ -0,0 +1 @@
+"""CogniSwitch Toolkit"""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/cogniswitch/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/cogniswitch/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c43f9b9d535045e8402445ca37ba3b01e672c16e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/cogniswitch/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/cogniswitch/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/cogniswitch/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..23a2d04902b34093b22467bc0acc36e583d046e2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/cogniswitch/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/cogniswitch/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/cogniswitch/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..36ec5ae0f3609501e2c1fa234a01172943ce3a19
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/cogniswitch/toolkit.py
@@ -0,0 +1,40 @@
+from typing import List
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.cogniswitch.tool import (
+    CogniswitchKnowledgeRequest,
+    CogniswitchKnowledgeSourceFile,
+    CogniswitchKnowledgeSourceURL,
+    CogniswitchKnowledgeStatus,
+)
+
+
+class CogniswitchToolkit(BaseToolkit):
+    """
+    Toolkit for CogniSwitch.
+
+    Use the toolkit to get all the tools present in the cogniswitch and
+    use them to interact with your knowledge
+    """
+
+    cs_token: str  # cogniswitch token
+    OAI_token: str  # OpenAI API token
+    apiKey: str  # Cogniswitch OAuth token
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return [
+            CogniswitchKnowledgeStatus(
+                cs_token=self.cs_token, OAI_token=self.OAI_token, apiKey=self.apiKey
+            ),
+            CogniswitchKnowledgeRequest(
+                cs_token=self.cs_token, OAI_token=self.OAI_token, apiKey=self.apiKey
+            ),
+            CogniswitchKnowledgeSourceFile(
+                cs_token=self.cs_token, OAI_token=self.OAI_token, apiKey=self.apiKey
+            ),
+            CogniswitchKnowledgeSourceURL(
+                cs_token=self.cs_token, OAI_token=self.OAI_token, apiKey=self.apiKey
+            ),
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/connery/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/connery/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1839897c39472e86614b6b91e83701242ce1fe0a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/connery/__init__.py
@@ -0,0 +1,7 @@
+"""
+This module contains the ConneryToolkit.
+"""
+
+from .toolkit import ConneryToolkit
+
+__all__ = ["ConneryToolkit"]
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/connery/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/connery/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3847c122f378b69f683eba57e5adecfc35bd031b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/connery/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/connery/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/connery/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6627bffa0a7ad9ebbdc23d43f0a9343e82257236
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/connery/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/connery/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/connery/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..e1a84fd6c136706cc3b17696911fec1186e6ad1f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/connery/toolkit.py
@@ -0,0 +1,51 @@
+from typing import List
+
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools.connery import ConneryService
+
+
+class ConneryToolkit(BaseToolkit):
+    """
+    Toolkit with a list of Connery Actions as tools.
+    """
+
+    tools: List[BaseTool]
+
+    def get_tools(self) -> List[BaseTool]:
+        """
+        Returns the list of Connery Actions.
+        """
+        return self.tools
+
+    @root_validator()
+    def validate_attributes(cls, values: dict) -> dict:
+        """
+        Validate the attributes of the ConneryToolkit class.
+        Parameters:
+            values (dict): The arguments to validate.
+        Returns:
+            dict: The validated arguments.
+        """
+
+        if not values.get("tools"):
+            raise ValueError("The attribute 'tools' must be set.")
+
+        return values
+
+    @classmethod
+    def create_instance(cls, connery_service: ConneryService) -> "ConneryToolkit":
+        """
+        Creates a Connery Toolkit using a Connery Service.
+        Parameters:
+            connery_service (ConneryService): The Connery Service
+            to to get the list of Connery Actions.
+        Returns:
+            ConneryToolkit: The Connery Toolkit.
+        """
+
+        instance = cls(tools=connery_service.list_actions())
+
+        return instance
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/csv/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/csv/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b049802888eaf0e8800d0ddfa29ec9b4ff4a42b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/csv/__init__.py
@@ -0,0 +1,26 @@
+from pathlib import Path
+from typing import Any
+
+from langchain_core._api.path import as_import_path
+
+
+def __getattr__(name: str) -> Any:
+    """Get attr name."""
+
+    if name == "create_csv_agent":
+        # Get directory of langchain package
+        HERE = Path(__file__).parents[3]
+        here = as_import_path(Path(__file__).parent, relative_to=HERE)
+
+        old_path = "langchain." + here + "." + name
+        new_path = "langchain_experimental." + here + "." + name
+        raise ImportError(
+            "This agent has been moved to langchain experiment. "
+            "This agent relies on python REPL tool under the hood, so to use it "
+            "safely please sandbox the python REPL. "
+            "Read https://github.com/langchain-ai/langchain/blob/master/SECURITY.md "
+            "and https://github.com/langchain-ai/langchain/discussions/11680"
+            "To keep using this code as is, install langchain experimental and "
+            f"update your import statement from:\n `{old_path}` to `{new_path}`."
+        )
+    raise AttributeError(f"{name} does not exist")
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/csv/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/csv/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..42d496c4e824fa8a90da1b9480e0b8397a700e07
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/csv/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/file_management/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/file_management/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..53ce9329f914837adb259a2754cd522b62015c77
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/file_management/__init__.py
@@ -0,0 +1,7 @@
+"""Local file management toolkit."""
+
+from langchain_community.agent_toolkits.file_management.toolkit import (
+    FileManagementToolkit,
+)
+
+__all__ = ["FileManagementToolkit"]
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/file_management/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/file_management/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..861cd2d120d7adf847121f9d069d3942a0bf7359
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/file_management/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/file_management/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/file_management/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..56cf2a139dd012d0e3c103377ef3def1310dc0fb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/file_management/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/file_management/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/file_management/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..81071ff5610fabeeda7e789d534b21f5807a623d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/file_management/toolkit.py
@@ -0,0 +1,80 @@
+from __future__ import annotations
+
+from typing import Dict, List, Optional, Type
+
+from langchain_core.pydantic_v1 import root_validator
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.file_management.copy import CopyFileTool
+from langchain_community.tools.file_management.delete import DeleteFileTool
+from langchain_community.tools.file_management.file_search import FileSearchTool
+from langchain_community.tools.file_management.list_dir import ListDirectoryTool
+from langchain_community.tools.file_management.move import MoveFileTool
+from langchain_community.tools.file_management.read import ReadFileTool
+from langchain_community.tools.file_management.write import WriteFileTool
+
+_FILE_TOOLS: List[Type[BaseTool]] = [
+    CopyFileTool,
+    DeleteFileTool,
+    FileSearchTool,
+    MoveFileTool,
+    ReadFileTool,
+    WriteFileTool,
+    ListDirectoryTool,
+]
+_FILE_TOOLS_MAP: Dict[str, Type[BaseTool]] = {
+    tool_cls.__fields__["name"].default: tool_cls for tool_cls in _FILE_TOOLS
+}
+
+
+class FileManagementToolkit(BaseToolkit):
+    """Toolkit for interacting with local files.
+
+    *Security Notice*: This toolkit provides methods to interact with local files.
+        If providing this toolkit to an agent on an LLM, ensure you scope
+        the agent's permissions to only include the necessary permissions
+        to perform the desired operations.
+
+        By **default** the agent will have access to all files within
+        the root dir and will be able to Copy, Delete, Move, Read, Write
+        and List files in that directory.
+
+        Consider the following:
+        - Limit access to particular directories using `root_dir`.
+        - Use filesystem permissions to restrict access and permissions to only
+          the files and directories required by the agent.
+        - Limit the tools available to the agent to only the file operations
+          necessary for the agent's intended use.
+        - Sandbox the agent by running it in a container.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    root_dir: Optional[str] = None
+    """If specified, all file operations are made relative to root_dir."""
+    selected_tools: Optional[List[str]] = None
+    """If provided, only provide the selected tools. Defaults to all."""
+
+    @root_validator
+    def validate_tools(cls, values: dict) -> dict:
+        selected_tools = values.get("selected_tools") or []
+        for tool_name in selected_tools:
+            if tool_name not in _FILE_TOOLS_MAP:
+                raise ValueError(
+                    f"File Tool of name {tool_name} not supported."
+                    f" Permitted tools: {list(_FILE_TOOLS_MAP)}"
+                )
+        return values
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        allowed_tools = self.selected_tools or _FILE_TOOLS_MAP
+        tools: List[BaseTool] = []
+        for tool in allowed_tools:
+            tool_cls = _FILE_TOOLS_MAP[tool]
+            tools.append(tool_cls(root_dir=self.root_dir))
+        return tools
+
+
+__all__ = ["FileManagementToolkit"]
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/github/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/github/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bcd9368a52a4c85c4ce4703be431d8e32f1b959b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/github/__init__.py
@@ -0,0 +1 @@
+"""GitHub Toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/github/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/github/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e5013cc10b803ed380471e59947d91781a4a5d2e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/github/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/github/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/github/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a8874750e96f2faa7eba2a9c7f4d035684d06722
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/github/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/github/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/github/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..067d3394d10aa1f9833f321c04a583ace17de5ae
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/github/toolkit.py
@@ -0,0 +1,315 @@
+"""GitHub Toolkit."""
+from typing import Dict, List
+
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.github.prompt import (
+    COMMENT_ON_ISSUE_PROMPT,
+    CREATE_BRANCH_PROMPT,
+    CREATE_FILE_PROMPT,
+    CREATE_PULL_REQUEST_PROMPT,
+    CREATE_REVIEW_REQUEST_PROMPT,
+    DELETE_FILE_PROMPT,
+    GET_FILES_FROM_DIRECTORY_PROMPT,
+    GET_ISSUE_PROMPT,
+    GET_ISSUES_PROMPT,
+    GET_PR_PROMPT,
+    LIST_BRANCHES_IN_REPO_PROMPT,
+    LIST_PRS_PROMPT,
+    LIST_PULL_REQUEST_FILES,
+    OVERVIEW_EXISTING_FILES_BOT_BRANCH,
+    OVERVIEW_EXISTING_FILES_IN_MAIN,
+    READ_FILE_PROMPT,
+    SEARCH_CODE_PROMPT,
+    SEARCH_ISSUES_AND_PRS_PROMPT,
+    SET_ACTIVE_BRANCH_PROMPT,
+    UPDATE_FILE_PROMPT,
+)
+from langchain_community.tools.github.tool import GitHubAction
+from langchain_community.utilities.github import GitHubAPIWrapper
+
+
+class NoInput(BaseModel):
+    """Schema for operations that do not require any input."""
+
+    no_input: str = Field("", description="No input required, e.g. `` (empty string).")
+
+
+class GetIssue(BaseModel):
+    """Schema for operations that require an issue number as input."""
+
+    issue_number: int = Field(0, description="Issue number as an integer, e.g. `42`")
+
+
+class CommentOnIssue(BaseModel):
+    """Schema for operations that require a comment as input."""
+
+    input: str = Field(..., description="Follow the required formatting.")
+
+
+class GetPR(BaseModel):
+    """Schema for operations that require a PR number as input."""
+
+    pr_number: int = Field(0, description="The PR number as an integer, e.g. `12`")
+
+
+class CreatePR(BaseModel):
+    """Schema for operations that require a PR title and body as input."""
+
+    formatted_pr: str = Field(..., description="Follow the required formatting.")
+
+
+class CreateFile(BaseModel):
+    """Schema for operations that require a file path and content as input."""
+
+    formatted_file: str = Field(..., description="Follow the required formatting.")
+
+
+class ReadFile(BaseModel):
+    """Schema for operations that require a file path as input."""
+
+    formatted_filepath: str = Field(
+        ...,
+        description=(
+            "The full file path of the file you would like to read where the "
+            "path must NOT start with a slash, e.g. `some_dir/my_file.py`."
+        ),
+    )
+
+
+class UpdateFile(BaseModel):
+    """Schema for operations that require a file path and content as input."""
+
+    formatted_file_update: str = Field(
+        ..., description="Strictly follow the provided rules."
+    )
+
+
+class DeleteFile(BaseModel):
+    """Schema for operations that require a file path as input."""
+
+    formatted_filepath: str = Field(
+        ...,
+        description=(
+            "The full file path of the file you would like to delete"
+            " where the path must NOT start with a slash, e.g."
+            " `some_dir/my_file.py`. Only input a string,"
+            " not the param name."
+        ),
+    )
+
+
+class DirectoryPath(BaseModel):
+    """Schema for operations that require a directory path as input."""
+
+    input: str = Field(
+        "",
+        description=(
+            "The path of the directory, e.g. `some_dir/inner_dir`."
+            " Only input a string, do not include the parameter name."
+        ),
+    )
+
+
+class BranchName(BaseModel):
+    """Schema for operations that require a branch name as input."""
+
+    branch_name: str = Field(
+        ..., description="The name of the branch, e.g. `my_branch`."
+    )
+
+
+class SearchCode(BaseModel):
+    """Schema for operations that require a search query as input."""
+
+    search_query: str = Field(
+        ...,
+        description=(
+            "A keyword-focused natural language search"
+            "query for code, e.g. `MyFunctionName()`."
+        ),
+    )
+
+
+class CreateReviewRequest(BaseModel):
+    """Schema for operations that require a username as input."""
+
+    username: str = Field(
+        ...,
+        description="GitHub username of the user being requested, e.g. `my_username`.",
+    )
+
+
+class SearchIssuesAndPRs(BaseModel):
+    """Schema for operations that require a search query as input."""
+
+    search_query: str = Field(
+        ...,
+        description="Natural language search query, e.g. `My issue title or topic`.",
+    )
+
+
+class GitHubToolkit(BaseToolkit):
+    """GitHub Toolkit.
+
+    *Security Note*: This toolkit contains tools that can read and modify
+        the state of a service; e.g., by creating, deleting, or updating,
+        reading underlying data.
+
+        For example, this toolkit can be used to create issues, pull requests,
+        and comments on GitHub.
+
+        See [Security](https://python.langchain.com/docs/security) for more information.
+    """
+
+    tools: List[BaseTool] = []
+
+    @classmethod
+    def from_github_api_wrapper(
+        cls, github_api_wrapper: GitHubAPIWrapper
+    ) -> "GitHubToolkit":
+        operations: List[Dict] = [
+            {
+                "mode": "get_issues",
+                "name": "Get Issues",
+                "description": GET_ISSUES_PROMPT,
+                "args_schema": NoInput,
+            },
+            {
+                "mode": "get_issue",
+                "name": "Get Issue",
+                "description": GET_ISSUE_PROMPT,
+                "args_schema": GetIssue,
+            },
+            {
+                "mode": "comment_on_issue",
+                "name": "Comment on Issue",
+                "description": COMMENT_ON_ISSUE_PROMPT,
+                "args_schema": CommentOnIssue,
+            },
+            {
+                "mode": "list_open_pull_requests",
+                "name": "List open pull requests (PRs)",
+                "description": LIST_PRS_PROMPT,
+                "args_schema": NoInput,
+            },
+            {
+                "mode": "get_pull_request",
+                "name": "Get Pull Request",
+                "description": GET_PR_PROMPT,
+                "args_schema": GetPR,
+            },
+            {
+                "mode": "list_pull_request_files",
+                "name": "Overview of files included in PR",
+                "description": LIST_PULL_REQUEST_FILES,
+                "args_schema": GetPR,
+            },
+            {
+                "mode": "create_pull_request",
+                "name": "Create Pull Request",
+                "description": CREATE_PULL_REQUEST_PROMPT,
+                "args_schema": CreatePR,
+            },
+            {
+                "mode": "list_pull_request_files",
+                "name": "List Pull Requests' Files",
+                "description": LIST_PULL_REQUEST_FILES,
+                "args_schema": GetPR,
+            },
+            {
+                "mode": "create_file",
+                "name": "Create File",
+                "description": CREATE_FILE_PROMPT,
+                "args_schema": CreateFile,
+            },
+            {
+                "mode": "read_file",
+                "name": "Read File",
+                "description": READ_FILE_PROMPT,
+                "args_schema": ReadFile,
+            },
+            {
+                "mode": "update_file",
+                "name": "Update File",
+                "description": UPDATE_FILE_PROMPT,
+                "args_schema": UpdateFile,
+            },
+            {
+                "mode": "delete_file",
+                "name": "Delete File",
+                "description": DELETE_FILE_PROMPT,
+                "args_schema": DeleteFile,
+            },
+            {
+                "mode": "list_files_in_main_branch",
+                "name": "Overview of existing files in Main branch",
+                "description": OVERVIEW_EXISTING_FILES_IN_MAIN,
+                "args_schema": NoInput,
+            },
+            {
+                "mode": "list_files_in_bot_branch",
+                "name": "Overview of files in current working branch",
+                "description": OVERVIEW_EXISTING_FILES_BOT_BRANCH,
+                "args_schema": NoInput,
+            },
+            {
+                "mode": "list_branches_in_repo",
+                "name": "List branches in this repository",
+                "description": LIST_BRANCHES_IN_REPO_PROMPT,
+                "args_schema": NoInput,
+            },
+            {
+                "mode": "set_active_branch",
+                "name": "Set active branch",
+                "description": SET_ACTIVE_BRANCH_PROMPT,
+                "args_schema": BranchName,
+            },
+            {
+                "mode": "create_branch",
+                "name": "Create a new branch",
+                "description": CREATE_BRANCH_PROMPT,
+                "args_schema": BranchName,
+            },
+            {
+                "mode": "get_files_from_directory",
+                "name": "Get files from a directory",
+                "description": GET_FILES_FROM_DIRECTORY_PROMPT,
+                "args_schema": DirectoryPath,
+            },
+            {
+                "mode": "search_issues_and_prs",
+                "name": "Search issues and pull requests",
+                "description": SEARCH_ISSUES_AND_PRS_PROMPT,
+                "args_schema": SearchIssuesAndPRs,
+            },
+            {
+                "mode": "search_code",
+                "name": "Search code",
+                "description": SEARCH_CODE_PROMPT,
+                "args_schema": SearchCode,
+            },
+            {
+                "mode": "create_review_request",
+                "name": "Create review request",
+                "description": CREATE_REVIEW_REQUEST_PROMPT,
+                "args_schema": CreateReviewRequest,
+            },
+        ]
+        tools = [
+            GitHubAction(
+                name=action["name"],
+                description=action["description"],
+                mode=action["mode"],
+                api_wrapper=github_api_wrapper,
+                args_schema=action.get("args_schema", None),
+            )
+            for action in operations
+        ]
+        return cls(tools=tools)
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return self.tools
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/gitlab/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/gitlab/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7d3ca720636309ecfe762283732a06cfc68f3294
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/gitlab/__init__.py
@@ -0,0 +1 @@
+"""GitLab Toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/gitlab/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/gitlab/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d2196fca0b4af66fc9710dbe27d37f2441f8d83b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/gitlab/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/gitlab/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/gitlab/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..578009bc1848392914c40c49cfc4613b8aee791e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/gitlab/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/gitlab/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/gitlab/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a56b821f5bfdfe2a324ab84addf13626f282c3d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/gitlab/toolkit.py
@@ -0,0 +1,94 @@
+"""GitHub Toolkit."""
+from typing import Dict, List
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.gitlab.prompt import (
+    COMMENT_ON_ISSUE_PROMPT,
+    CREATE_FILE_PROMPT,
+    CREATE_PULL_REQUEST_PROMPT,
+    DELETE_FILE_PROMPT,
+    GET_ISSUE_PROMPT,
+    GET_ISSUES_PROMPT,
+    READ_FILE_PROMPT,
+    UPDATE_FILE_PROMPT,
+)
+from langchain_community.tools.gitlab.tool import GitLabAction
+from langchain_community.utilities.gitlab import GitLabAPIWrapper
+
+
+class GitLabToolkit(BaseToolkit):
+    """GitLab Toolkit.
+
+    *Security Note*: This toolkit contains tools that can read and modify
+        the state of a service; e.g., by creating, deleting, or updating,
+        reading underlying data.
+
+        For example, this toolkit can be used to create issues, pull requests,
+        and comments on GitLab.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    tools: List[BaseTool] = []
+
+    @classmethod
+    def from_gitlab_api_wrapper(
+        cls, gitlab_api_wrapper: GitLabAPIWrapper
+    ) -> "GitLabToolkit":
+        operations: List[Dict] = [
+            {
+                "mode": "get_issues",
+                "name": "Get Issues",
+                "description": GET_ISSUES_PROMPT,
+            },
+            {
+                "mode": "get_issue",
+                "name": "Get Issue",
+                "description": GET_ISSUE_PROMPT,
+            },
+            {
+                "mode": "comment_on_issue",
+                "name": "Comment on Issue",
+                "description": COMMENT_ON_ISSUE_PROMPT,
+            },
+            {
+                "mode": "create_pull_request",
+                "name": "Create Pull Request",
+                "description": CREATE_PULL_REQUEST_PROMPT,
+            },
+            {
+                "mode": "create_file",
+                "name": "Create File",
+                "description": CREATE_FILE_PROMPT,
+            },
+            {
+                "mode": "read_file",
+                "name": "Read File",
+                "description": READ_FILE_PROMPT,
+            },
+            {
+                "mode": "update_file",
+                "name": "Update File",
+                "description": UPDATE_FILE_PROMPT,
+            },
+            {
+                "mode": "delete_file",
+                "name": "Delete File",
+                "description": DELETE_FILE_PROMPT,
+            },
+        ]
+        tools = [
+            GitLabAction(
+                name=action["name"],
+                description=action["description"],
+                mode=action["mode"],
+                api_wrapper=gitlab_api_wrapper,
+            )
+            for action in operations
+        ]
+        return cls(tools=tools)
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return self.tools
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/gmail/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/gmail/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..02e7f81659f5a224cb8aa3d3a661e99972d6b0e6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/gmail/__init__.py
@@ -0,0 +1 @@
+"""Gmail toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/gmail/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/gmail/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7198753b7e2f6e034e4ea856be96ef6050bd7ba3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/gmail/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/gmail/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/gmail/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a945c00b5c9e9d04be5448ffce4e46ded769e0cb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/gmail/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/gmail/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/gmail/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e4af3fd6144c585cbdd539e96607e1b836a4772
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/gmail/toolkit.py
@@ -0,0 +1,58 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List
+
+from langchain_core.pydantic_v1 import Field
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.gmail.create_draft import GmailCreateDraft
+from langchain_community.tools.gmail.get_message import GmailGetMessage
+from langchain_community.tools.gmail.get_thread import GmailGetThread
+from langchain_community.tools.gmail.search import GmailSearch
+from langchain_community.tools.gmail.send_message import GmailSendMessage
+from langchain_community.tools.gmail.utils import build_resource_service
+
+if TYPE_CHECKING:
+    # This is for linting and IDE typehints
+    from googleapiclient.discovery import Resource
+else:
+    try:
+        # We do this so pydantic can resolve the types when instantiating
+        from googleapiclient.discovery import Resource
+    except ImportError:
+        pass
+
+
+SCOPES = ["https://mail.google.com/"]
+
+
+class GmailToolkit(BaseToolkit):
+    """Toolkit for interacting with Gmail.
+
+    *Security Note*: This toolkit contains tools that can read and modify
+        the state of a service; e.g., by reading, creating, updating, deleting
+        data associated with this service.
+
+        For example, this toolkit can be used to send emails on behalf of the
+        associated account.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    api_resource: Resource = Field(default_factory=build_resource_service)
+
+    class Config:
+        """Pydantic config."""
+
+        arbitrary_types_allowed = True
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return [
+            GmailCreateDraft(api_resource=self.api_resource),
+            GmailSendMessage(api_resource=self.api_resource),
+            GmailSearch(api_resource=self.api_resource),
+            GmailGetMessage(api_resource=self.api_resource),
+            GmailGetThread(api_resource=self.api_resource),
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/jira/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/jira/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9f7c67558fa53f59b5b7ac36f0c47a2dfe26f554
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/jira/__init__.py
@@ -0,0 +1 @@
+"""Jira Toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/jira/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/jira/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ae56945323f4d234642ca987422e807afc782a0f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/jira/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/jira/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/jira/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..12ce1973727a4f893f62c816614c536cd1aeed07
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/jira/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/jira/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/jira/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..425c8d4c065cde4436671e862f424d1ce2726034
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/jira/toolkit.py
@@ -0,0 +1,70 @@
+from typing import Dict, List
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.jira.prompt import (
+    JIRA_CATCH_ALL_PROMPT,
+    JIRA_CONFLUENCE_PAGE_CREATE_PROMPT,
+    JIRA_GET_ALL_PROJECTS_PROMPT,
+    JIRA_ISSUE_CREATE_PROMPT,
+    JIRA_JQL_PROMPT,
+)
+from langchain_community.tools.jira.tool import JiraAction
+from langchain_community.utilities.jira import JiraAPIWrapper
+
+
+class JiraToolkit(BaseToolkit):
+    """Jira Toolkit.
+
+    *Security Note*: This toolkit contains tools that can read and modify
+        the state of a service; e.g., by creating, deleting, or updating,
+        reading underlying data.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    tools: List[BaseTool] = []
+
+    @classmethod
+    def from_jira_api_wrapper(cls, jira_api_wrapper: JiraAPIWrapper) -> "JiraToolkit":
+        operations: List[Dict] = [
+            {
+                "mode": "jql",
+                "name": "JQL Query",
+                "description": JIRA_JQL_PROMPT,
+            },
+            {
+                "mode": "get_projects",
+                "name": "Get Projects",
+                "description": JIRA_GET_ALL_PROJECTS_PROMPT,
+            },
+            {
+                "mode": "create_issue",
+                "name": "Create Issue",
+                "description": JIRA_ISSUE_CREATE_PROMPT,
+            },
+            {
+                "mode": "other",
+                "name": "Catch all Jira API call",
+                "description": JIRA_CATCH_ALL_PROMPT,
+            },
+            {
+                "mode": "create_page",
+                "name": "Create confluence page",
+                "description": JIRA_CONFLUENCE_PAGE_CREATE_PROMPT,
+            },
+        ]
+        tools = [
+            JiraAction(
+                name=action["name"],
+                description=action["description"],
+                mode=action["mode"],
+                api_wrapper=jira_api_wrapper,
+            )
+            for action in operations
+        ]
+        return cls(tools=tools)
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return self.tools
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bfab0ec6f83a544f93a19dc036a188cb08b82433
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__init__.py
@@ -0,0 +1 @@
+"""Json agent."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f9595651fe7c4357cfa5a1168fdeb8c1a314384d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..91deb2307dcc33abd0a204e24fb30f10b82a018b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bf3459171d35efced37bfc122fef2e13e066f572
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9a753d9434574ac82d5c0e70ecf70254aefbe22d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/json/base.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..06830d902282fc949213deaecdb01fc3957e7b1e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/base.py
@@ -0,0 +1,59 @@
+"""Json agent."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+from langchain_core.callbacks import BaseCallbackManager
+from langchain_core.language_models import BaseLanguageModel
+
+from langchain_community.agent_toolkits.json.prompt import JSON_PREFIX, JSON_SUFFIX
+from langchain_community.agent_toolkits.json.toolkit import JsonToolkit
+
+if TYPE_CHECKING:
+    from langchain.agents.agent import AgentExecutor
+
+
+def create_json_agent(
+    llm: BaseLanguageModel,
+    toolkit: JsonToolkit,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    prefix: str = JSON_PREFIX,
+    suffix: str = JSON_SUFFIX,
+    format_instructions: Optional[str] = None,
+    input_variables: Optional[List[str]] = None,
+    verbose: bool = False,
+    agent_executor_kwargs: Optional[Dict[str, Any]] = None,
+    **kwargs: Any,
+) -> AgentExecutor:
+    """Construct a json agent from an LLM and tools."""
+    from langchain.agents.agent import AgentExecutor
+    from langchain.agents.mrkl.base import ZeroShotAgent
+    from langchain.chains.llm import LLMChain
+
+    tools = toolkit.get_tools()
+    prompt_params = (
+        {"format_instructions": format_instructions}
+        if format_instructions is not None
+        else {}
+    )
+    prompt = ZeroShotAgent.create_prompt(
+        tools,
+        prefix=prefix,
+        suffix=suffix,
+        input_variables=input_variables,
+        **prompt_params,
+    )
+    llm_chain = LLMChain(
+        llm=llm,
+        prompt=prompt,
+        callback_manager=callback_manager,
+    )
+    tool_names = [tool.name for tool in tools]
+    agent = ZeroShotAgent(llm_chain=llm_chain, allowed_tools=tool_names, **kwargs)
+    return AgentExecutor.from_agent_and_tools(
+        agent=agent,
+        tools=tools,
+        callback_manager=callback_manager,
+        verbose=verbose,
+        **(agent_executor_kwargs or {}),
+    )
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/json/prompt.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..a3b7584aca222a88b2035af48657a7d00558b5e5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/prompt.py
@@ -0,0 +1,25 @@
+# flake8: noqa
+
+JSON_PREFIX = """You are an agent designed to interact with JSON.
+Your goal is to return a final answer by interacting with the JSON.
+You have access to the following tools which help you learn more about the JSON you are interacting with.
+Only use the below tools. Only use the information returned by the below tools to construct your final answer.
+Do not make up any information that is not contained in the JSON.
+Your input to the tools should be in the form of `data["key"][0]` where `data` is the JSON blob you are interacting with, and the syntax used is Python. 
+You should only use keys that you know for a fact exist. You must validate that a key exists by seeing it previously when calling `json_spec_list_keys`. 
+If you have not seen a key in one of those responses, you cannot use it.
+You should only add one key at a time to the path. You cannot add multiple keys at once.
+If you encounter a "KeyError", go back to the previous key, look at the available keys, and try again.
+
+If the question does not seem to be related to the JSON, just return "I don't know" as the answer.
+Always begin your interaction with the `json_spec_list_keys` tool with input "data" to see what keys exist in the JSON.
+
+Note that sometimes the value at a given path is large. In this case, you will get an error "Value is a large dictionary, should explore its keys directly".
+In this case, you should ALWAYS follow up by using the `json_spec_list_keys` tool to see what keys exist at that path.
+Do not simply refer the user to the JSON or a section of the JSON, as this is not a valid answer. Keep digging until you find the answer and explicitly return it.
+"""
+JSON_SUFFIX = """Begin!"
+
+Question: {input}
+Thought: I should look at the keys that exist in data to see what I have access to
+{agent_scratchpad}"""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/json/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..8a4aa00a6ea10419b9851f1bfdc117460023e995
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/json/toolkit.py
@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from typing import List
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.json.tool import (
+    JsonGetValueTool,
+    JsonListKeysTool,
+    JsonSpec,
+)
+
+
+class JsonToolkit(BaseToolkit):
+    """Toolkit for interacting with a JSON spec."""
+
+    spec: JsonSpec
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return [
+            JsonListKeysTool(spec=self.spec),
+            JsonGetValueTool(spec=self.spec),
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/multion/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/multion/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..56c7215199b05cf9a03832da4b24c928b771ece9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/multion/__init__.py
@@ -0,0 +1 @@
+"""MultiOn Toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/multion/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/multion/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d2ad98695c369c18d2e035165fbfdbd87d5e1dc5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/multion/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/multion/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/multion/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f9117e36b3673019068ed4943c576530c26f4cae
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/multion/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/multion/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/multion/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d8f90291124de9842120184a3090e719e317622
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/multion/toolkit.py
@@ -0,0 +1,33 @@
+"""MultiOn agent."""
+from __future__ import annotations
+
+from typing import List
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.multion.close_session import MultionCloseSession
+from langchain_community.tools.multion.create_session import MultionCreateSession
+from langchain_community.tools.multion.update_session import MultionUpdateSession
+
+
+class MultionToolkit(BaseToolkit):
+    """Toolkit for interacting with the Browser Agent.
+
+    **Security Note**: This toolkit contains tools that interact with the
+        user's browser via the multion API which grants an agent
+        access to the user's browser.
+
+        Please review the documentation for the multion API to understand
+        the security implications of using this toolkit.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    class Config:
+        """Pydantic config."""
+
+        arbitrary_types_allowed = True
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return [MultionCreateSession(), MultionUpdateSession(), MultionCloseSession()]
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/nasa/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/nasa/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a13c3ec706c6d8773162ca325f1ceac2a7840315
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/nasa/__init__.py
@@ -0,0 +1 @@
+"""NASA Toolkit"""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/nasa/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/nasa/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c56d0dd43787df0f32c9b6982a4e057d1a625449
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/nasa/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/nasa/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/nasa/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..64b18c1a9850cbdd5e718f6e6143745605a1ebae
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/nasa/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/nasa/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/nasa/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..46edd98af3fb02055f99b6cd22c4b0b560c53812
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/nasa/toolkit.py
@@ -0,0 +1,57 @@
+from typing import Dict, List
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.nasa.prompt import (
+    NASA_CAPTIONS_PROMPT,
+    NASA_MANIFEST_PROMPT,
+    NASA_METADATA_PROMPT,
+    NASA_SEARCH_PROMPT,
+)
+from langchain_community.tools.nasa.tool import NasaAction
+from langchain_community.utilities.nasa import NasaAPIWrapper
+
+
+class NasaToolkit(BaseToolkit):
+    """Nasa Toolkit."""
+
+    tools: List[BaseTool] = []
+
+    @classmethod
+    def from_nasa_api_wrapper(cls, nasa_api_wrapper: NasaAPIWrapper) -> "NasaToolkit":
+        operations: List[Dict] = [
+            {
+                "mode": "search_media",
+                "name": "Search NASA Image and Video Library media",
+                "description": NASA_SEARCH_PROMPT,
+            },
+            {
+                "mode": "get_media_metadata_manifest",
+                "name": "Get NASA Image and Video Library media metadata manifest",
+                "description": NASA_MANIFEST_PROMPT,
+            },
+            {
+                "mode": "get_media_metadata_location",
+                "name": "Get NASA Image and Video Library media metadata location",
+                "description": NASA_METADATA_PROMPT,
+            },
+            {
+                "mode": "get_video_captions_location",
+                "name": "Get NASA Image and Video Library video captions location",
+                "description": NASA_CAPTIONS_PROMPT,
+            },
+        ]
+        tools = [
+            NasaAction(
+                name=action["name"],
+                description=action["description"],
+                mode=action["mode"],
+                api_wrapper=nasa_api_wrapper,
+            )
+            for action in operations
+        ]
+        return cls(tools=tools)
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return self.tools
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..75006402410feafdae13b3c04e48f1a60cef629b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d8cfeff830689fb54f8785f8444a111fed9831a8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5f712f27d2d990ff788dcfad3301f983ae1d13d2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/tool.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..b947c7df9772325b8e293ae710cae5665481d060
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/tool.py
@@ -0,0 +1,58 @@
+"""Tool for interacting with a single API with natural language definition."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Optional
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.tools import Tool
+
+from langchain_community.tools.openapi.utils.api_models import APIOperation
+from langchain_community.tools.openapi.utils.openapi_utils import OpenAPISpec
+from langchain_community.utilities.requests import Requests
+
+if TYPE_CHECKING:
+    from langchain.chains.api.openapi.chain import OpenAPIEndpointChain
+
+
+class NLATool(Tool):
+    """Natural Language API Tool."""
+
+    @classmethod
+    def from_open_api_endpoint_chain(
+        cls, chain: OpenAPIEndpointChain, api_title: str
+    ) -> "NLATool":
+        """Convert an endpoint chain to an API endpoint tool."""
+        expanded_name = (
+            f'{api_title.replace(" ", "_")}.{chain.api_operation.operation_id}'
+        )
+        description = (
+            f"I'm an AI from {api_title}. Instruct what you want,"
+            " and I'll assist via an API with description:"
+            f" {chain.api_operation.description}"
+        )
+        return cls(name=expanded_name, func=chain.run, description=description)
+
+    @classmethod
+    def from_llm_and_method(
+        cls,
+        llm: BaseLanguageModel,
+        path: str,
+        method: str,
+        spec: OpenAPISpec,
+        requests: Optional[Requests] = None,
+        verbose: bool = False,
+        return_intermediate_steps: bool = False,
+        **kwargs: Any,
+    ) -> "NLATool":
+        """Instantiate the tool from the specified path and method."""
+        api_operation = APIOperation.from_openapi_spec(spec, path, method)
+        chain = OpenAPIEndpointChain.from_api_operation(
+            api_operation,
+            llm,
+            requests=requests,
+            verbose=verbose,
+            return_intermediate_steps=return_intermediate_steps,
+            **kwargs,
+        )
+        return cls.from_open_api_endpoint_chain(chain, spec.info.title)
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..ae02aeb53bc5faa2c9b8b0ac2bfd0bb0dd2210aa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/nla/toolkit.py
@@ -0,0 +1,127 @@
+from __future__ import annotations
+
+from typing import Any, List, Optional, Sequence
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.agent_toolkits.nla.tool import NLATool
+from langchain_community.tools.openapi.utils.openapi_utils import OpenAPISpec
+from langchain_community.tools.plugin import AIPlugin
+from langchain_community.utilities.requests import Requests
+
+
+class NLAToolkit(BaseToolkit):
+    """Natural Language API Toolkit.
+
+    *Security Note*: This toolkit creates tools that enable making calls
+        to an Open API compliant API.
+
+        The tools created by this toolkit may be able to make GET, POST,
+        PATCH, PUT, DELETE requests to any of the exposed endpoints on
+        the API.
+
+        Control access to who can use this toolkit.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    nla_tools: Sequence[NLATool] = Field(...)
+    """List of API Endpoint Tools."""
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools for all the API operations."""
+        return list(self.nla_tools)
+
+    @staticmethod
+    def _get_http_operation_tools(
+        llm: BaseLanguageModel,
+        spec: OpenAPISpec,
+        requests: Optional[Requests] = None,
+        verbose: bool = False,
+        **kwargs: Any,
+    ) -> List[NLATool]:
+        """Get the tools for all the API operations."""
+        if not spec.paths:
+            return []
+        http_operation_tools = []
+        for path in spec.paths:
+            for method in spec.get_methods_for_path(path):
+                endpoint_tool = NLATool.from_llm_and_method(
+                    llm=llm,
+                    path=path,
+                    method=method,
+                    spec=spec,
+                    requests=requests,
+                    verbose=verbose,
+                    **kwargs,
+                )
+                http_operation_tools.append(endpoint_tool)
+        return http_operation_tools
+
+    @classmethod
+    def from_llm_and_spec(
+        cls,
+        llm: BaseLanguageModel,
+        spec: OpenAPISpec,
+        requests: Optional[Requests] = None,
+        verbose: bool = False,
+        **kwargs: Any,
+    ) -> NLAToolkit:
+        """Instantiate the toolkit by creating tools for each operation."""
+        http_operation_tools = cls._get_http_operation_tools(
+            llm=llm, spec=spec, requests=requests, verbose=verbose, **kwargs
+        )
+        return cls(nla_tools=http_operation_tools)
+
+    @classmethod
+    def from_llm_and_url(
+        cls,
+        llm: BaseLanguageModel,
+        open_api_url: str,
+        requests: Optional[Requests] = None,
+        verbose: bool = False,
+        **kwargs: Any,
+    ) -> NLAToolkit:
+        """Instantiate the toolkit from an OpenAPI Spec URL"""
+        spec = OpenAPISpec.from_url(open_api_url)
+        return cls.from_llm_and_spec(
+            llm=llm, spec=spec, requests=requests, verbose=verbose, **kwargs
+        )
+
+    @classmethod
+    def from_llm_and_ai_plugin(
+        cls,
+        llm: BaseLanguageModel,
+        ai_plugin: AIPlugin,
+        requests: Optional[Requests] = None,
+        verbose: bool = False,
+        **kwargs: Any,
+    ) -> NLAToolkit:
+        """Instantiate the toolkit from an OpenAPI Spec URL"""
+        spec = OpenAPISpec.from_url(ai_plugin.api.url)
+        # TODO: Merge optional Auth information with the `requests` argument
+        return cls.from_llm_and_spec(
+            llm=llm,
+            spec=spec,
+            requests=requests,
+            verbose=verbose,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_llm_and_ai_plugin_url(
+        cls,
+        llm: BaseLanguageModel,
+        ai_plugin_url: str,
+        requests: Optional[Requests] = None,
+        verbose: bool = False,
+        **kwargs: Any,
+    ) -> NLAToolkit:
+        """Instantiate the toolkit from an OpenAPI Spec URL"""
+        plugin = AIPlugin.from_url(ai_plugin_url)
+        return cls.from_llm_and_ai_plugin(
+            llm=llm, ai_plugin=plugin, requests=requests, verbose=verbose, **kwargs
+        )
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/office365/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/office365/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..acd0a87f955a214ef62fa32a0813971802cd96de
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/office365/__init__.py
@@ -0,0 +1 @@
+"""Office365 toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/office365/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/office365/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a5b20464b5debcf5d18255ec615da4fc13421878
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/office365/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/office365/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/office365/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..55d2bb5a7cbe414458802969d4f0a11b111c6004
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/office365/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/office365/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/office365/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..990264ce1dbe5ebeb9e850cd33406c53b4f558c2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/office365/toolkit.py
@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List
+
+from langchain_core.pydantic_v1 import Field
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.office365.create_draft_message import (
+    O365CreateDraftMessage,
+)
+from langchain_community.tools.office365.events_search import O365SearchEvents
+from langchain_community.tools.office365.messages_search import O365SearchEmails
+from langchain_community.tools.office365.send_event import O365SendEvent
+from langchain_community.tools.office365.send_message import O365SendMessage
+from langchain_community.tools.office365.utils import authenticate
+
+if TYPE_CHECKING:
+    from O365 import Account
+
+
+class O365Toolkit(BaseToolkit):
+    """Toolkit for interacting with Office 365.
+
+    *Security Note*: This toolkit contains tools that can read and modify
+        the state of a service; e.g., by reading, creating, updating, deleting
+        data associated with this service.
+
+        For example, this toolkit can be used search through emails and events,
+        send messages and event invites, and create draft messages.
+
+        Please make sure that the permissions given by this toolkit
+        are appropriate for your use case.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    account: Account = Field(default_factory=authenticate)
+
+    class Config:
+        """Pydantic config."""
+
+        arbitrary_types_allowed = True
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return [
+            O365SearchEvents(),
+            O365CreateDraftMessage(),
+            O365SearchEmails(),
+            O365SendEvent(),
+            O365SendMessage(),
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5d06e271cd00be5bc75dd27398a5fff15de1afbf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__init__.py
@@ -0,0 +1 @@
+"""OpenAPI spec agent."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9facd2dc5df54ed200ff86466ecd0d4f6a2307f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..50382a00a1e96d6162bb029861a25c180dcec976
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/planner.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/planner.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..882d75d0e89a53a3a9ebdd530395825b9319b931
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/planner.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/planner_prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/planner_prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0af9447005534c6355cd95f4183e1bec41048787
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/planner_prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a539db62ff26292fcff6e9243308d691aac84ce5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/spec.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/spec.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..43983cdea5624096cd490818cbbf1410a9ddba8e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/spec.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f4a8fd688f7d0ae0ffbc1cf5299d7836e5d19df2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/base.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..63a513811ea44dc5f403d9b5fce99b361edcb265
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/base.py
@@ -0,0 +1,83 @@
+"""OpenAPI spec agent."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+from langchain_core.callbacks import BaseCallbackManager
+from langchain_core.language_models import BaseLanguageModel
+
+from langchain_community.agent_toolkits.openapi.prompt import (
+    OPENAPI_PREFIX,
+    OPENAPI_SUFFIX,
+)
+from langchain_community.agent_toolkits.openapi.toolkit import OpenAPIToolkit
+
+if TYPE_CHECKING:
+    from langchain.agents.agent import AgentExecutor
+
+
+def create_openapi_agent(
+    llm: BaseLanguageModel,
+    toolkit: OpenAPIToolkit,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    prefix: str = OPENAPI_PREFIX,
+    suffix: str = OPENAPI_SUFFIX,
+    format_instructions: Optional[str] = None,
+    input_variables: Optional[List[str]] = None,
+    max_iterations: Optional[int] = 15,
+    max_execution_time: Optional[float] = None,
+    early_stopping_method: str = "force",
+    verbose: bool = False,
+    return_intermediate_steps: bool = False,
+    agent_executor_kwargs: Optional[Dict[str, Any]] = None,
+    **kwargs: Any,
+) -> AgentExecutor:
+    """Construct an OpenAPI agent from an LLM and tools.
+
+    *Security Note*: When creating an OpenAPI agent, check the permissions
+        and capabilities of the underlying toolkit.
+
+        For example, if the default implementation of OpenAPIToolkit
+        uses the RequestsToolkit which contains tools to make arbitrary
+        network requests against any URL (e.g., GET, POST, PATCH, PUT, DELETE),
+
+        Control access to who can submit issue requests using this toolkit and
+        what network access it has.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+    from langchain.agents.agent import AgentExecutor
+    from langchain.agents.mrkl.base import ZeroShotAgent
+    from langchain.chains.llm import LLMChain
+
+    tools = toolkit.get_tools()
+    prompt_params = (
+        {"format_instructions": format_instructions}
+        if format_instructions is not None
+        else {}
+    )
+    prompt = ZeroShotAgent.create_prompt(
+        tools,
+        prefix=prefix,
+        suffix=suffix,
+        input_variables=input_variables,
+        **prompt_params,
+    )
+    llm_chain = LLMChain(
+        llm=llm,
+        prompt=prompt,
+        callback_manager=callback_manager,
+    )
+    tool_names = [tool.name for tool in tools]
+    agent = ZeroShotAgent(llm_chain=llm_chain, allowed_tools=tool_names, **kwargs)
+    return AgentExecutor.from_agent_and_tools(
+        agent=agent,
+        tools=tools,
+        callback_manager=callback_manager,
+        verbose=verbose,
+        return_intermediate_steps=return_intermediate_steps,
+        max_iterations=max_iterations,
+        max_execution_time=max_execution_time,
+        early_stopping_method=early_stopping_method,
+        **(agent_executor_kwargs or {}),
+    )
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/planner.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/planner.py
new file mode 100644
index 0000000000000000000000000000000000000000..281c8a49be1589bc44cd625b5b62f2682cd1a6da
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/planner.py
@@ -0,0 +1,398 @@
+"""Agent that interacts with OpenAPI APIs via a hierarchical planning approach."""
+
+import json
+import re
+from functools import partial
+from typing import Any, Callable, Dict, List, Optional, cast
+
+import yaml
+from langchain_core.callbacks import BaseCallbackManager
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import BasePromptTemplate, PromptTemplate
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool, Tool
+
+from langchain_community.agent_toolkits.openapi.planner_prompt import (
+    API_CONTROLLER_PROMPT,
+    API_CONTROLLER_TOOL_DESCRIPTION,
+    API_CONTROLLER_TOOL_NAME,
+    API_ORCHESTRATOR_PROMPT,
+    API_PLANNER_PROMPT,
+    API_PLANNER_TOOL_DESCRIPTION,
+    API_PLANNER_TOOL_NAME,
+    PARSING_DELETE_PROMPT,
+    PARSING_GET_PROMPT,
+    PARSING_PATCH_PROMPT,
+    PARSING_POST_PROMPT,
+    PARSING_PUT_PROMPT,
+    REQUESTS_DELETE_TOOL_DESCRIPTION,
+    REQUESTS_GET_TOOL_DESCRIPTION,
+    REQUESTS_PATCH_TOOL_DESCRIPTION,
+    REQUESTS_POST_TOOL_DESCRIPTION,
+    REQUESTS_PUT_TOOL_DESCRIPTION,
+)
+from langchain_community.agent_toolkits.openapi.spec import ReducedOpenAPISpec
+from langchain_community.llms import OpenAI
+from langchain_community.tools.requests.tool import BaseRequestsTool
+from langchain_community.utilities.requests import RequestsWrapper
+
+#
+# Requests tools with LLM-instructed extraction of truncated responses.
+#
+# Of course, truncating so bluntly may lose a lot of valuable
+# information in the response.
+# However, the goal for now is to have only a single inference step.
+MAX_RESPONSE_LENGTH = 5000
+"""Maximum length of the response to be returned."""
+
+
+def _get_default_llm_chain(prompt: BasePromptTemplate) -> Any:
+    from langchain.chains.llm import LLMChain
+
+    return LLMChain(
+        llm=OpenAI(),
+        prompt=prompt,
+    )
+
+
+def _get_default_llm_chain_factory(
+    prompt: BasePromptTemplate,
+) -> Callable[[], Any]:
+    """Returns a default LLMChain factory."""
+    return partial(_get_default_llm_chain, prompt)
+
+
+class RequestsGetToolWithParsing(BaseRequestsTool, BaseTool):
+    """Requests GET tool with LLM-instructed extraction of truncated responses."""
+
+    name: str = "requests_get"
+    """Tool name."""
+    description = REQUESTS_GET_TOOL_DESCRIPTION
+    """Tool description."""
+    response_length: int = MAX_RESPONSE_LENGTH
+    """Maximum length of the response to be returned."""
+    llm_chain: Any = Field(
+        default_factory=_get_default_llm_chain_factory(PARSING_GET_PROMPT)
+    )
+    """LLMChain used to extract the response."""
+
+    def _run(self, text: str) -> str:
+        from langchain.output_parsers.json import parse_json_markdown
+
+        try:
+            data = parse_json_markdown(text)
+        except json.JSONDecodeError as e:
+            raise e
+        data_params = data.get("params")
+        response: str = cast(
+            str, self.requests_wrapper.get(data["url"], params=data_params)
+        )
+        response = response[: self.response_length]
+        return self.llm_chain.predict(
+            response=response, instructions=data["output_instructions"]
+        ).strip()
+
+    async def _arun(self, text: str) -> str:
+        raise NotImplementedError()
+
+
+class RequestsPostToolWithParsing(BaseRequestsTool, BaseTool):
+    """Requests POST tool with LLM-instructed extraction of truncated responses."""
+
+    name: str = "requests_post"
+    """Tool name."""
+    description = REQUESTS_POST_TOOL_DESCRIPTION
+    """Tool description."""
+    response_length: int = MAX_RESPONSE_LENGTH
+    """Maximum length of the response to be returned."""
+    llm_chain: Any = Field(
+        default_factory=_get_default_llm_chain_factory(PARSING_POST_PROMPT)
+    )
+    """LLMChain used to extract the response."""
+
+    def _run(self, text: str) -> str:
+        from langchain.output_parsers.json import parse_json_markdown
+
+        try:
+            data = parse_json_markdown(text)
+        except json.JSONDecodeError as e:
+            raise e
+        response: str = cast(str, self.requests_wrapper.post(data["url"], data["data"]))
+        response = response[: self.response_length]
+        return self.llm_chain.predict(
+            response=response, instructions=data["output_instructions"]
+        ).strip()
+
+    async def _arun(self, text: str) -> str:
+        raise NotImplementedError()
+
+
+class RequestsPatchToolWithParsing(BaseRequestsTool, BaseTool):
+    """Requests PATCH tool with LLM-instructed extraction of truncated responses."""
+
+    name: str = "requests_patch"
+    """Tool name."""
+    description = REQUESTS_PATCH_TOOL_DESCRIPTION
+    """Tool description."""
+    response_length: int = MAX_RESPONSE_LENGTH
+    """Maximum length of the response to be returned."""
+    llm_chain: Any = Field(
+        default_factory=_get_default_llm_chain_factory(PARSING_PATCH_PROMPT)
+    )
+    """LLMChain used to extract the response."""
+
+    def _run(self, text: str) -> str:
+        from langchain.output_parsers.json import parse_json_markdown
+
+        try:
+            data = parse_json_markdown(text)
+        except json.JSONDecodeError as e:
+            raise e
+        response: str = cast(
+            str, self.requests_wrapper.patch(data["url"], data["data"])
+        )
+        response = response[: self.response_length]
+        return self.llm_chain.predict(
+            response=response, instructions=data["output_instructions"]
+        ).strip()
+
+    async def _arun(self, text: str) -> str:
+        raise NotImplementedError()
+
+
+class RequestsPutToolWithParsing(BaseRequestsTool, BaseTool):
+    """Requests PUT tool with LLM-instructed extraction of truncated responses."""
+
+    name: str = "requests_put"
+    """Tool name."""
+    description = REQUESTS_PUT_TOOL_DESCRIPTION
+    """Tool description."""
+    response_length: int = MAX_RESPONSE_LENGTH
+    """Maximum length of the response to be returned."""
+    llm_chain: Any = Field(
+        default_factory=_get_default_llm_chain_factory(PARSING_PUT_PROMPT)
+    )
+    """LLMChain used to extract the response."""
+
+    def _run(self, text: str) -> str:
+        from langchain.output_parsers.json import parse_json_markdown
+
+        try:
+            data = parse_json_markdown(text)
+        except json.JSONDecodeError as e:
+            raise e
+        response: str = cast(str, self.requests_wrapper.put(data["url"], data["data"]))
+        response = response[: self.response_length]
+        return self.llm_chain.predict(
+            response=response, instructions=data["output_instructions"]
+        ).strip()
+
+    async def _arun(self, text: str) -> str:
+        raise NotImplementedError()
+
+
+class RequestsDeleteToolWithParsing(BaseRequestsTool, BaseTool):
+    """Tool that sends a DELETE request and parses the response."""
+
+    name: str = "requests_delete"
+    """The name of the tool."""
+    description = REQUESTS_DELETE_TOOL_DESCRIPTION
+    """The description of the tool."""
+
+    response_length: Optional[int] = MAX_RESPONSE_LENGTH
+    """The maximum length of the response."""
+    llm_chain: Any = Field(
+        default_factory=_get_default_llm_chain_factory(PARSING_DELETE_PROMPT)
+    )
+    """The LLM chain used to parse the response."""
+
+    def _run(self, text: str) -> str:
+        from langchain.output_parsers.json import parse_json_markdown
+
+        try:
+            data = parse_json_markdown(text)
+        except json.JSONDecodeError as e:
+            raise e
+        response: str = cast(str, self.requests_wrapper.delete(data["url"]))
+        response = response[: self.response_length]
+        return self.llm_chain.predict(
+            response=response, instructions=data["output_instructions"]
+        ).strip()
+
+    async def _arun(self, text: str) -> str:
+        raise NotImplementedError()
+
+
+#
+# Orchestrator, planner, controller.
+#
+def _create_api_planner_tool(
+    api_spec: ReducedOpenAPISpec, llm: BaseLanguageModel
+) -> Tool:
+    from langchain.chains.llm import LLMChain
+
+    endpoint_descriptions = [
+        f"{name} {description}" for name, description, _ in api_spec.endpoints
+    ]
+    prompt = PromptTemplate(
+        template=API_PLANNER_PROMPT,
+        input_variables=["query"],
+        partial_variables={"endpoints": "- " + "- ".join(endpoint_descriptions)},
+    )
+    chain = LLMChain(llm=llm, prompt=prompt)
+    tool = Tool(
+        name=API_PLANNER_TOOL_NAME,
+        description=API_PLANNER_TOOL_DESCRIPTION,
+        func=chain.run,
+    )
+    return tool
+
+
+def _create_api_controller_agent(
+    api_url: str,
+    api_docs: str,
+    requests_wrapper: RequestsWrapper,
+    llm: BaseLanguageModel,
+    allow_dangerous_requests: bool,
+) -> Any:
+    from langchain.agents.agent import AgentExecutor
+    from langchain.agents.mrkl.base import ZeroShotAgent
+    from langchain.chains.llm import LLMChain
+
+    get_llm_chain = LLMChain(llm=llm, prompt=PARSING_GET_PROMPT)
+    post_llm_chain = LLMChain(llm=llm, prompt=PARSING_POST_PROMPT)
+    tools: List[BaseTool] = [
+        RequestsGetToolWithParsing(
+            requests_wrapper=requests_wrapper,
+            llm_chain=get_llm_chain,
+            allow_dangerous_requests=allow_dangerous_requests,
+        ),
+        RequestsPostToolWithParsing(
+            requests_wrapper=requests_wrapper,
+            llm_chain=post_llm_chain,
+            allow_dangerous_requests=allow_dangerous_requests,
+        ),
+    ]
+    prompt = PromptTemplate(
+        template=API_CONTROLLER_PROMPT,
+        input_variables=["input", "agent_scratchpad"],
+        partial_variables={
+            "api_url": api_url,
+            "api_docs": api_docs,
+            "tool_names": ", ".join([tool.name for tool in tools]),
+            "tool_descriptions": "\n".join(
+                [f"{tool.name}: {tool.description}" for tool in tools]
+            ),
+        },
+    )
+    agent = ZeroShotAgent(
+        llm_chain=LLMChain(llm=llm, prompt=prompt),
+        allowed_tools=[tool.name for tool in tools],
+    )
+    return AgentExecutor.from_agent_and_tools(agent=agent, tools=tools, verbose=True)
+
+
+def _create_api_controller_tool(
+    api_spec: ReducedOpenAPISpec,
+    requests_wrapper: RequestsWrapper,
+    llm: BaseLanguageModel,
+    allow_dangerous_requests: bool,
+) -> Tool:
+    """Expose controller as a tool.
+
+    The tool is invoked with a plan from the planner, and dynamically
+    creates a controller agent with relevant documentation only to
+    constrain the context.
+    """
+
+    base_url = api_spec.servers[0]["url"]  # TODO: do better.
+
+    def _create_and_run_api_controller_agent(plan_str: str) -> str:
+        pattern = r"\b(GET|POST|PATCH|DELETE)\s+(/\S+)*"
+        matches = re.findall(pattern, plan_str)
+        endpoint_names = [
+            "{method} {route}".format(method=method, route=route.split("?")[0])
+            for method, route in matches
+        ]
+        docs_str = ""
+        for endpoint_name in endpoint_names:
+            found_match = False
+            for name, _, docs in api_spec.endpoints:
+                regex_name = re.compile(re.sub("\{.*?\}", ".*", name))
+                if regex_name.match(endpoint_name):
+                    found_match = True
+                    docs_str += f"== Docs for {endpoint_name} == \n{yaml.dump(docs)}\n"
+            if not found_match:
+                raise ValueError(f"{endpoint_name} endpoint does not exist.")
+
+        agent = _create_api_controller_agent(
+            base_url, docs_str, requests_wrapper, llm, allow_dangerous_requests
+        )
+        return agent.run(plan_str)
+
+    return Tool(
+        name=API_CONTROLLER_TOOL_NAME,
+        func=_create_and_run_api_controller_agent,
+        description=API_CONTROLLER_TOOL_DESCRIPTION,
+    )
+
+
+def create_openapi_agent(
+    api_spec: ReducedOpenAPISpec,
+    requests_wrapper: RequestsWrapper,
+    llm: BaseLanguageModel,
+    shared_memory: Optional[Any] = None,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    verbose: bool = True,
+    agent_executor_kwargs: Optional[Dict[str, Any]] = None,
+    allow_dangerous_requests: bool = False,
+    **kwargs: Any,
+) -> Any:
+    """Construct an OpenAI API planner and controller for a given spec.
+
+    Inject credentials via requests_wrapper.
+
+    We use a top-level "orchestrator" agent to invoke the planner and controller,
+    rather than a top-level planner
+    that invokes a controller with its plan. This is to keep the planner simple.
+
+    You need to set allow_dangerous_requests to True to use Agent with BaseRequestsTool.
+    Requests can be dangerous and can lead to security vulnerabilities.
+    For example, users can ask a server to make a request to an internal
+    server. It's recommended to use requests through a proxy server
+    and avoid accepting inputs from untrusted sources without proper sandboxing.
+    Please see: https://python.langchain.com/docs/security
+    for further security information.
+    """
+    from langchain.agents.agent import AgentExecutor
+    from langchain.agents.mrkl.base import ZeroShotAgent
+    from langchain.chains.llm import LLMChain
+
+    tools = [
+        _create_api_planner_tool(api_spec, llm),
+        _create_api_controller_tool(
+            api_spec, requests_wrapper, llm, allow_dangerous_requests
+        ),
+    ]
+    prompt = PromptTemplate(
+        template=API_ORCHESTRATOR_PROMPT,
+        input_variables=["input", "agent_scratchpad"],
+        partial_variables={
+            "tool_names": ", ".join([tool.name for tool in tools]),
+            "tool_descriptions": "\n".join(
+                [f"{tool.name}: {tool.description}" for tool in tools]
+            ),
+        },
+    )
+    agent = ZeroShotAgent(
+        llm_chain=LLMChain(llm=llm, prompt=prompt, memory=shared_memory),
+        allowed_tools=[tool.name for tool in tools],
+        **kwargs,
+    )
+    return AgentExecutor.from_agent_and_tools(
+        agent=agent,
+        tools=tools,
+        callback_manager=callback_manager,
+        verbose=verbose,
+        **(agent_executor_kwargs or {}),
+    )
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/planner_prompt.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/planner_prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..ec99e823e06c133972d5bcc6ba12a644e5d1455b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/planner_prompt.py
@@ -0,0 +1,235 @@
+# flake8: noqa
+
+from langchain_core.prompts.prompt import PromptTemplate
+
+
+API_PLANNER_PROMPT = """You are a planner that plans a sequence of API calls to assist with user queries against an API.
+
+You should:
+1) evaluate whether the user query can be solved by the API documentated below. If no, say why.
+2) if yes, generate a plan of API calls and say what they are doing step by step.
+3) If the plan includes a DELETE call, you should always return an ask from the User for authorization first unless the User has specifically asked to delete something.
+
+You should only use API endpoints documented below ("Endpoints you can use:").
+You can only use the DELETE tool if the User has specifically asked to delete something. Otherwise, you should return a request authorization from the User first.
+Some user queries can be resolved in a single API call, but some will require several API calls.
+The plan will be passed to an API controller that can format it into web requests and return the responses.
+
+----
+
+Here are some examples:
+
+Fake endpoints for examples:
+GET /user to get information about the current user
+GET /products/search search across products
+POST /users/{{id}}/cart to add products to a user's cart
+PATCH /users/{{id}}/cart to update a user's cart
+PUT /users/{{id}}/coupon to apply idempotent coupon to a user's cart
+DELETE /users/{{id}}/cart to delete a user's cart
+
+User query: tell me a joke
+Plan: Sorry, this API's domain is shopping, not comedy.
+
+User query: I want to buy a couch
+Plan: 1. GET /products with a query param to search for couches
+2. GET /user to find the user's id
+3. POST /users/{{id}}/cart to add a couch to the user's cart
+
+User query: I want to add a lamp to my cart
+Plan: 1. GET /products with a query param to search for lamps
+2. GET /user to find the user's id
+3. PATCH /users/{{id}}/cart to add a lamp to the user's cart
+
+User query: I want to add a coupon to my cart
+Plan: 1. GET /user to find the user's id
+2. PUT /users/{{id}}/coupon to apply the coupon
+
+User query: I want to delete my cart
+Plan: 1. GET /user to find the user's id
+2. DELETE required. Did user specify DELETE or previously authorize? Yes, proceed.
+3. DELETE /users/{{id}}/cart to delete the user's cart
+
+User query: I want to start a new cart
+Plan: 1. GET /user to find the user's id
+2. DELETE required. Did user specify DELETE or previously authorize? No, ask for authorization.
+3. Are you sure you want to delete your cart? 
+----
+
+Here are endpoints you can use. Do not reference any of the endpoints above.
+
+{endpoints}
+
+----
+
+User query: {query}
+Plan:"""
+API_PLANNER_TOOL_NAME = "api_planner"
+API_PLANNER_TOOL_DESCRIPTION = f"Can be used to generate the right API calls to assist with a user query, like {API_PLANNER_TOOL_NAME}(query). Should always be called before trying to call the API controller."
+
+# Execution.
+API_CONTROLLER_PROMPT = """You are an agent that gets a sequence of API calls and given their documentation, should execute them and return the final response.
+If you cannot complete them and run into issues, you should explain the issue. If you're unable to resolve an API call, you can retry the API call. When interacting with API objects, you should extract ids for inputs to other API calls but ids and names for outputs returned to the User.
+
+
+Here is documentation on the API:
+Base url: {api_url}
+Endpoints:
+{api_docs}
+
+
+Here are tools to execute requests against the API: {tool_descriptions}
+
+
+Starting below, you should follow this format:
+
+Plan: the plan of API calls to execute
+Thought: you should always think about what to do
+Action: the action to take, should be one of the tools [{tool_names}]
+Action Input: the input to the action
+Observation: the output of the action
+... (this Thought/Action/Action Input/Observation can repeat N times)
+Thought: I am finished executing the plan (or, I cannot finish executing the plan without knowing some other information.)
+Final Answer: the final output from executing the plan or missing information I'd need to re-plan correctly.
+
+
+Begin!
+
+Plan: {input}
+Thought:
+{agent_scratchpad}
+"""
+API_CONTROLLER_TOOL_NAME = "api_controller"
+API_CONTROLLER_TOOL_DESCRIPTION = f"Can be used to execute a plan of API calls, like {API_CONTROLLER_TOOL_NAME}(plan)."
+
+# Orchestrate planning + execution.
+# The goal is to have an agent at the top-level (e.g. so it can recover from errors and re-plan) while
+# keeping planning (and specifically the planning prompt) simple.
+API_ORCHESTRATOR_PROMPT = """You are an agent that assists with user queries against API, things like querying information or creating resources.
+Some user queries can be resolved in a single API call, particularly if you can find appropriate params from the OpenAPI spec; though some require several API calls.
+You should always plan your API calls first, and then execute the plan second.
+If the plan includes a DELETE call, be sure to ask the User for authorization first unless the User has specifically asked to delete something.
+You should never return information without executing the api_controller tool.
+
+
+Here are the tools to plan and execute API requests: {tool_descriptions}
+
+
+Starting below, you should follow this format:
+
+User query: the query a User wants help with related to the API
+Thought: you should always think about what to do
+Action: the action to take, should be one of the tools [{tool_names}]
+Action Input: the input to the action
+Observation: the result of the action
+... (this Thought/Action/Action Input/Observation can repeat N times)
+Thought: I am finished executing a plan and have the information the user asked for or the data the user asked to create
+Final Answer: the final output from executing the plan
+
+
+Example:
+User query: can you add some trendy stuff to my shopping cart.
+Thought: I should plan API calls first.
+Action: api_planner
+Action Input: I need to find the right API calls to add trendy items to the users shopping cart
+Observation: 1) GET /items with params 'trending' is 'True' to get trending item ids
+2) GET /user to get user
+3) POST /cart to post the trending items to the user's cart
+Thought: I'm ready to execute the API calls.
+Action: api_controller
+Action Input: 1) GET /items params 'trending' is 'True' to get trending item ids
+2) GET /user to get user
+3) POST /cart to post the trending items to the user's cart
+...
+
+Begin!
+
+User query: {input}
+Thought: I should generate a plan to help with this query and then copy that plan exactly to the controller.
+{agent_scratchpad}"""
+
+REQUESTS_GET_TOOL_DESCRIPTION = """Use this to GET content from a website.
+Input to the tool should be a json string with 3 keys: "url", "params" and "output_instructions".
+The value of "url" should be a string. 
+The value of "params" should be a dict of the needed and available parameters from the OpenAPI spec related to the endpoint. 
+If parameters are not needed, or not available, leave it empty.
+The value of "output_instructions" should be instructions on what information to extract from the response, 
+for example the id(s) for a resource(s) that the GET request fetches.
+"""
+
+PARSING_GET_PROMPT = PromptTemplate(
+    template="""Here is an API response:\n\n{response}\n\n====
+Your task is to extract some information according to these instructions: {instructions}
+When working with API objects, you should usually use ids over names.
+If the response indicates an error, you should instead output a summary of the error.
+
+Output:""",
+    input_variables=["response", "instructions"],
+)
+
+REQUESTS_POST_TOOL_DESCRIPTION = """Use this when you want to POST to a website.
+Input to the tool should be a json string with 3 keys: "url", "data", and "output_instructions".
+The value of "url" should be a string.
+The value of "data" should be a dictionary of key-value pairs you want to POST to the url.
+The value of "output_instructions" should be instructions on what information to extract from the response, for example the id(s) for a resource(s) that the POST request creates.
+Always use double quotes for strings in the json string."""
+
+PARSING_POST_PROMPT = PromptTemplate(
+    template="""Here is an API response:\n\n{response}\n\n====
+Your task is to extract some information according to these instructions: {instructions}
+When working with API objects, you should usually use ids over names. Do not return any ids or names that are not in the response.
+If the response indicates an error, you should instead output a summary of the error.
+
+Output:""",
+    input_variables=["response", "instructions"],
+)
+
+REQUESTS_PATCH_TOOL_DESCRIPTION = """Use this when you want to PATCH content on a website.
+Input to the tool should be a json string with 3 keys: "url", "data", and "output_instructions".
+The value of "url" should be a string.
+The value of "data" should be a dictionary of key-value pairs of the body params available in the OpenAPI spec you want to PATCH the content with at the url.
+The value of "output_instructions" should be instructions on what information to extract from the response, for example the id(s) for a resource(s) that the PATCH request creates.
+Always use double quotes for strings in the json string."""
+
+PARSING_PATCH_PROMPT = PromptTemplate(
+    template="""Here is an API response:\n\n{response}\n\n====
+Your task is to extract some information according to these instructions: {instructions}
+When working with API objects, you should usually use ids over names. Do not return any ids or names that are not in the response.
+If the response indicates an error, you should instead output a summary of the error.
+
+Output:""",
+    input_variables=["response", "instructions"],
+)
+
+REQUESTS_PUT_TOOL_DESCRIPTION = """Use this when you want to PUT to a website.
+Input to the tool should be a json string with 3 keys: "url", "data", and "output_instructions".
+The value of "url" should be a string.
+The value of "data" should be a dictionary of key-value pairs you want to PUT to the url.
+The value of "output_instructions" should be instructions on what information to extract from the response, for example the id(s) for a resource(s) that the PUT request creates.
+Always use double quotes for strings in the json string."""
+
+PARSING_PUT_PROMPT = PromptTemplate(
+    template="""Here is an API response:\n\n{response}\n\n====
+Your task is to extract some information according to these instructions: {instructions}
+When working with API objects, you should usually use ids over names. Do not return any ids or names that are not in the response.
+If the response indicates an error, you should instead output a summary of the error.
+
+Output:""",
+    input_variables=["response", "instructions"],
+)
+
+REQUESTS_DELETE_TOOL_DESCRIPTION = """ONLY USE THIS TOOL WHEN THE USER HAS SPECIFICALLY REQUESTED TO DELETE CONTENT FROM A WEBSITE.
+Input to the tool should be a json string with 2 keys: "url", and "output_instructions".
+The value of "url" should be a string.
+The value of "output_instructions" should be instructions on what information to extract from the response, for example the id(s) for a resource(s) that the DELETE request creates.
+Always use double quotes for strings in the json string.
+ONLY USE THIS TOOL IF THE USER HAS SPECIFICALLY REQUESTED TO DELETE SOMETHING."""
+
+PARSING_DELETE_PROMPT = PromptTemplate(
+    template="""Here is an API response:\n\n{response}\n\n====
+Your task is to extract some information according to these instructions: {instructions}
+When working with API objects, you should usually use ids over names. Do not return any ids or names that are not in the response.
+If the response indicates an error, you should instead output a summary of the error.
+
+Output:""",
+    input_variables=["response", "instructions"],
+)
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/prompt.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..2b4f90f55c5aa4996625146fc0afa307ef73fcbe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/prompt.py
@@ -0,0 +1,29 @@
+# flake8: noqa
+
+OPENAPI_PREFIX = """You are an agent designed to answer questions by making web requests to an API given the openapi spec.
+
+If the question does not seem related to the API, return I don't know. Do not make up an answer.
+Only use information provided by the tools to construct your response.
+
+First, find the base URL needed to make the request.
+
+Second, find the relevant paths needed to answer the question. Take note that, sometimes, you might need to make more than one request to more than one path to answer the question.
+
+Third, find the required parameters needed to make the request. For GET requests, these are usually URL parameters and for POST requests, these are request body parameters.
+
+Fourth, make the requests needed to answer the question. Ensure that you are sending the correct parameters to the request by checking which parameters are required. For parameters with a fixed set of values, please use the spec to look at which values are allowed.
+
+Use the exact parameter names as listed in the spec, do not make up any names or abbreviate the names of parameters.
+If you get a not found error, ensure that you are using a path that actually exists in the spec.
+"""
+OPENAPI_SUFFIX = """Begin!
+
+Question: {input}
+Thought: I should explore the spec to find the base server url for the API in the servers node.
+{agent_scratchpad}"""
+
+DESCRIPTION = """Can be used to answer questions about the openapi spec for the API. Always use this tool before trying to make a request. 
+Example inputs to this tool: 
+    'What are the required query parameters for a GET request to the /bar endpoint?`
+    'What are the required parameters in the request body for a POST request to the /foo endpoint?'
+Always give this tool a specific question."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/spec.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/spec.py
new file mode 100644
index 0000000000000000000000000000000000000000..29b529fc71e005f49c39ad6647d5699b6c95ab73
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/spec.py
@@ -0,0 +1,75 @@
+"""Quick and dirty representation for OpenAPI specs."""
+
+from dataclasses import dataclass
+from typing import List, Tuple
+
+from langchain_core.utils.json_schema import dereference_refs
+
+
+@dataclass(frozen=True)
+class ReducedOpenAPISpec:
+    """A reduced OpenAPI spec.
+
+    This is a quick and dirty representation for OpenAPI specs.
+
+    Attributes:
+        servers: The servers in the spec.
+        description: The description of the spec.
+        endpoints: The endpoints in the spec.
+    """
+
+    servers: List[dict]
+    description: str
+    endpoints: List[Tuple[str, str, dict]]
+
+
+def reduce_openapi_spec(spec: dict, dereference: bool = True) -> ReducedOpenAPISpec:
+    """Simplify/distill/minify a spec somehow.
+
+    I want a smaller target for retrieval and (more importantly)
+    I want smaller results from retrieval.
+    I was hoping https://openapi.tools/ would have some useful bits
+    to this end, but doesn't seem so.
+    """
+    # 1. Consider only get, post, patch, put, delete endpoints.
+    endpoints = [
+        (f"{operation_name.upper()} {route}", docs.get("description"), docs)
+        for route, operation in spec["paths"].items()
+        for operation_name, docs in operation.items()
+        if operation_name in ["get", "post", "patch", "put", "delete"]
+    ]
+
+    # 2. Replace any refs so that complete docs are retrieved.
+    # Note: probably want to do this post-retrieval, it blows up the size of the spec.
+    if dereference:
+        endpoints = [
+            (name, description, dereference_refs(docs, full_schema=spec))
+            for name, description, docs in endpoints
+        ]
+
+    # 3. Strip docs down to required request args + happy path response.
+    def reduce_endpoint_docs(docs: dict) -> dict:
+        out = {}
+        if docs.get("description"):
+            out["description"] = docs.get("description")
+        if docs.get("parameters"):
+            out["parameters"] = [
+                parameter
+                for parameter in docs.get("parameters", [])
+                if parameter.get("required")
+            ]
+        if "200" in docs["responses"]:
+            out["responses"] = docs["responses"]["200"]
+        if docs.get("requestBody"):
+            out["requestBody"] = docs.get("requestBody")
+        return out
+
+    endpoints = [
+        (name, description, reduce_endpoint_docs(docs))
+        for name, description, docs in endpoints
+    ]
+    return ReducedOpenAPISpec(
+        servers=spec["servers"],
+        description=spec["info"].get("description", ""),
+        endpoints=endpoints,
+    )
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..77d9fedf6fba4498d1ce80269c1a005915b5fce6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/openapi/toolkit.py
@@ -0,0 +1,117 @@
+"""Requests toolkit."""
+from __future__ import annotations
+
+from typing import Any, List
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.tools import Tool
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.agent_toolkits.json.base import create_json_agent
+from langchain_community.agent_toolkits.json.toolkit import JsonToolkit
+from langchain_community.agent_toolkits.openapi.prompt import DESCRIPTION
+from langchain_community.tools import BaseTool
+from langchain_community.tools.json.tool import JsonSpec
+from langchain_community.tools.requests.tool import (
+    RequestsDeleteTool,
+    RequestsGetTool,
+    RequestsPatchTool,
+    RequestsPostTool,
+    RequestsPutTool,
+)
+from langchain_community.utilities.requests import TextRequestsWrapper
+
+
+class RequestsToolkit(BaseToolkit):
+    """Toolkit for making REST requests.
+
+    *Security Note*: This toolkit contains tools to make GET, POST, PATCH, PUT,
+        and DELETE requests to an API.
+
+        Exercise care in who is allowed to use this toolkit. If exposing
+        to end users, consider that users will be able to make arbitrary
+        requests on behalf of the server hosting the code. For example,
+        users could ask the server to make a request to a private API
+        that is only accessible from the server.
+
+        Control access to who can submit issue requests using this toolkit and
+        what network access it has.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    requests_wrapper: TextRequestsWrapper
+    allow_dangerous_requests: bool = False
+    """Allow dangerous requests. See documentation for details."""
+
+    def get_tools(self) -> List[BaseTool]:
+        """Return a list of tools."""
+        return [
+            RequestsGetTool(
+                requests_wrapper=self.requests_wrapper,
+                allow_dangerous_requests=self.allow_dangerous_requests,
+            ),
+            RequestsPostTool(
+                requests_wrapper=self.requests_wrapper,
+                allow_dangerous_requests=self.allow_dangerous_requests,
+            ),
+            RequestsPatchTool(
+                requests_wrapper=self.requests_wrapper,
+                allow_dangerous_requests=self.allow_dangerous_requests,
+            ),
+            RequestsPutTool(
+                requests_wrapper=self.requests_wrapper,
+                allow_dangerous_requests=self.allow_dangerous_requests,
+            ),
+            RequestsDeleteTool(
+                requests_wrapper=self.requests_wrapper,
+                allow_dangerous_requests=self.allow_dangerous_requests,
+            ),
+        ]
+
+
+class OpenAPIToolkit(BaseToolkit):
+    """Toolkit for interacting with an OpenAPI API.
+
+    *Security Note*: This toolkit contains tools that can read and modify
+        the state of a service; e.g., by creating, deleting, or updating,
+        reading underlying data.
+
+        For example, this toolkit can be used to delete data exposed via
+        an OpenAPI compliant API.
+    """
+
+    json_agent: Any
+    requests_wrapper: TextRequestsWrapper
+    allow_dangerous_requests: bool = False
+    """Allow dangerous requests. See documentation for details."""
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        json_agent_tool = Tool(
+            name="json_explorer",
+            func=self.json_agent.run,
+            description=DESCRIPTION,
+        )
+        request_toolkit = RequestsToolkit(
+            requests_wrapper=self.requests_wrapper,
+            allow_dangerous_requests=self.allow_dangerous_requests,
+        )
+        return [*request_toolkit.get_tools(), json_agent_tool]
+
+    @classmethod
+    def from_llm(
+        cls,
+        llm: BaseLanguageModel,
+        json_spec: JsonSpec,
+        requests_wrapper: TextRequestsWrapper,
+        allow_dangerous_requests: bool = False,
+        **kwargs: Any,
+    ) -> OpenAPIToolkit:
+        """Create json agent from llm, then initialize."""
+        json_agent = create_json_agent(llm, JsonToolkit(spec=json_spec), **kwargs)
+        return cls(
+            json_agent=json_agent,
+            requests_wrapper=requests_wrapper,
+            allow_dangerous_requests=allow_dangerous_requests,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/playwright/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/playwright/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7fc7f6d995095a63ad2fdc9cb12f7e1f2234878a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/playwright/__init__.py
@@ -0,0 +1,6 @@
+"""Playwright browser toolkit."""
+from langchain_community.agent_toolkits.playwright.toolkit import (
+    PlayWrightBrowserToolkit,
+)
+
+__all__ = ["PlayWrightBrowserToolkit"]
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/playwright/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/playwright/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f02db50fc90a15bfc8972a3e85da337ca8ae34bb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/playwright/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/playwright/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/playwright/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..746fc15eacb14e0b2fbeecaa16b427bf3b669d85
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/playwright/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/playwright/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/playwright/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..5a78e8c21a8b714e4d9e9e6dfb49513426194836
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/playwright/toolkit.py
@@ -0,0 +1,110 @@
+"""Playwright web browser toolkit."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List, Optional, Type, cast
+
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.tools import BaseTool
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools.playwright.base import (
+    BaseBrowserTool,
+    lazy_import_playwright_browsers,
+)
+from langchain_community.tools.playwright.click import ClickTool
+from langchain_community.tools.playwright.current_page import CurrentWebPageTool
+from langchain_community.tools.playwright.extract_hyperlinks import (
+    ExtractHyperlinksTool,
+)
+from langchain_community.tools.playwright.extract_text import ExtractTextTool
+from langchain_community.tools.playwright.get_elements import GetElementsTool
+from langchain_community.tools.playwright.navigate import NavigateTool
+from langchain_community.tools.playwright.navigate_back import NavigateBackTool
+
+if TYPE_CHECKING:
+    from playwright.async_api import Browser as AsyncBrowser
+    from playwright.sync_api import Browser as SyncBrowser
+else:
+    try:
+        # We do this so pydantic can resolve the types when instantiating
+        from playwright.async_api import Browser as AsyncBrowser
+        from playwright.sync_api import Browser as SyncBrowser
+    except ImportError:
+        pass
+
+
+class PlayWrightBrowserToolkit(BaseToolkit):
+    """Toolkit for PlayWright browser tools.
+
+    **Security Note**: This toolkit provides code to control a web-browser.
+
+        Careful if exposing this toolkit to end-users. The tools in the toolkit
+        are capable of navigating to arbitrary webpages, clicking on arbitrary
+        elements, and extracting arbitrary text and hyperlinks from webpages.
+
+        Specifically, by default this toolkit allows navigating to:
+
+        - Any URL (including any internal network URLs)
+        - And local files
+
+        If exposing to end-users, consider limiting network access to the
+        server that hosts the agent; in addition, consider it is advised
+        to create a custom NavigationTool wht an args_schema that limits the URLs
+        that can be navigated to (e.g., only allow navigating to URLs that
+        start with a particular prefix).
+
+        Remember to scope permissions to the minimal permissions necessary for
+        the application. If the default tool selection is not appropriate for
+        the application, consider creating a custom toolkit with the appropriate
+        tools.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    sync_browser: Optional["SyncBrowser"] = None
+    async_browser: Optional["AsyncBrowser"] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator
+    def validate_imports_and_browser_provided(cls, values: dict) -> dict:
+        """Check that the arguments are valid."""
+        lazy_import_playwright_browsers()
+        if values.get("async_browser") is None and values.get("sync_browser") is None:
+            raise ValueError("Either async_browser or sync_browser must be specified.")
+        return values
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        tool_classes: List[Type[BaseBrowserTool]] = [
+            ClickTool,
+            NavigateTool,
+            NavigateBackTool,
+            ExtractTextTool,
+            ExtractHyperlinksTool,
+            GetElementsTool,
+            CurrentWebPageTool,
+        ]
+
+        tools = [
+            tool_cls.from_browser(
+                sync_browser=self.sync_browser, async_browser=self.async_browser
+            )
+            for tool_cls in tool_classes
+        ]
+        return cast(List[BaseTool], tools)
+
+    @classmethod
+    def from_browser(
+        cls,
+        sync_browser: Optional[SyncBrowser] = None,
+        async_browser: Optional[AsyncBrowser] = None,
+    ) -> PlayWrightBrowserToolkit:
+        """Instantiate the toolkit."""
+        # This is to raise a better error than the forward ref ones Pydantic would have
+        lazy_import_playwright_browsers()
+        return cls(sync_browser=sync_browser, async_browser=async_browser)
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/polygon/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/polygon/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9a3bf13b76c581775bf6c33abe9fd2c33f11deb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/polygon/__init__.py
@@ -0,0 +1 @@
+"""Polygon Toolkit"""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/polygon/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/polygon/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..05779c8d988cf90d671f15fd23e3de65cec22e29
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/polygon/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/polygon/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/polygon/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b6f3f151789cbc7a97640d8c77847ec43039e373
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/polygon/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/polygon/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/polygon/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..a41555b7dc54d586613a12508d5d0bbc2ee44855
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/polygon/toolkit.py
@@ -0,0 +1,41 @@
+from typing import List
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.polygon import (
+    PolygonAggregates,
+    PolygonFinancials,
+    PolygonLastQuote,
+    PolygonTickerNews,
+)
+from langchain_community.utilities.polygon import PolygonAPIWrapper
+
+
+class PolygonToolkit(BaseToolkit):
+    """Polygon Toolkit."""
+
+    tools: List[BaseTool] = []
+
+    @classmethod
+    def from_polygon_api_wrapper(
+        cls, polygon_api_wrapper: PolygonAPIWrapper
+    ) -> "PolygonToolkit":
+        tools = [
+            PolygonAggregates(
+                api_wrapper=polygon_api_wrapper,
+            ),
+            PolygonLastQuote(
+                api_wrapper=polygon_api_wrapper,
+            ),
+            PolygonTickerNews(
+                api_wrapper=polygon_api_wrapper,
+            ),
+            PolygonFinancials(
+                api_wrapper=polygon_api_wrapper,
+            ),
+        ]
+        return cls(tools=tools)
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return self.tools
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..42a9b09ac7e41e5899830f0b2f7be4820207ebdd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__init__.py
@@ -0,0 +1 @@
+"""Power BI agent."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..336ef1dc027cd97e56690d75a5b8b3422d20bb5a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a9013aebe75c04938014b94d1a9cac384ec2cabc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/chat_base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/chat_base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bba7065e6055c215330f5f18524f800cfa19286a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/chat_base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2945bbb7b00e156d8b3579bb5f6de96eeb745321
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..44dd9b639c110143fb69cdb49c1d16c6e9470f39
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/base.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..486e55f4e7c14af63be2c38dbfb55743b9ca6863
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/base.py
@@ -0,0 +1,73 @@
+"""Power BI agent."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+from langchain_core.callbacks import BaseCallbackManager
+from langchain_core.language_models import BaseLanguageModel
+
+from langchain_community.agent_toolkits.powerbi.prompt import (
+    POWERBI_PREFIX,
+    POWERBI_SUFFIX,
+)
+from langchain_community.agent_toolkits.powerbi.toolkit import PowerBIToolkit
+from langchain_community.utilities.powerbi import PowerBIDataset
+
+if TYPE_CHECKING:
+    from langchain.agents import AgentExecutor
+
+
+def create_pbi_agent(
+    llm: BaseLanguageModel,
+    toolkit: Optional[PowerBIToolkit] = None,
+    powerbi: Optional[PowerBIDataset] = None,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    prefix: str = POWERBI_PREFIX,
+    suffix: str = POWERBI_SUFFIX,
+    format_instructions: Optional[str] = None,
+    examples: Optional[str] = None,
+    input_variables: Optional[List[str]] = None,
+    top_k: int = 10,
+    verbose: bool = False,
+    agent_executor_kwargs: Optional[Dict[str, Any]] = None,
+    **kwargs: Any,
+) -> AgentExecutor:
+    """Construct a Power BI agent from an LLM and tools."""
+    from langchain.agents import AgentExecutor
+    from langchain.agents.mrkl.base import ZeroShotAgent
+    from langchain.chains.llm import LLMChain
+
+    if toolkit is None:
+        if powerbi is None:
+            raise ValueError("Must provide either a toolkit or powerbi dataset")
+        toolkit = PowerBIToolkit(powerbi=powerbi, llm=llm, examples=examples)
+    tools = toolkit.get_tools()
+    tables = powerbi.table_names if powerbi else toolkit.powerbi.table_names
+    prompt_params = (
+        {"format_instructions": format_instructions}
+        if format_instructions is not None
+        else {}
+    )
+    agent = ZeroShotAgent(
+        llm_chain=LLMChain(
+            llm=llm,
+            prompt=ZeroShotAgent.create_prompt(
+                tools,
+                prefix=prefix.format(top_k=top_k).format(tables=tables),
+                suffix=suffix,
+                input_variables=input_variables,
+                **prompt_params,
+            ),
+            callback_manager=callback_manager,
+            verbose=verbose,
+        ),
+        allowed_tools=[tool.name for tool in tools],
+        **kwargs,
+    )
+    return AgentExecutor.from_agent_and_tools(
+        agent=agent,
+        tools=tools,
+        callback_manager=callback_manager,
+        verbose=verbose,
+        **(agent_executor_kwargs or {}),
+    )
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/chat_base.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/chat_base.py
new file mode 100644
index 0000000000000000000000000000000000000000..acad61b4422064a69e540225a5f03e5eb262c5fa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/chat_base.py
@@ -0,0 +1,71 @@
+"""Power BI agent."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+from langchain_core.callbacks import BaseCallbackManager
+from langchain_core.language_models.chat_models import BaseChatModel
+
+from langchain_community.agent_toolkits.powerbi.prompt import (
+    POWERBI_CHAT_PREFIX,
+    POWERBI_CHAT_SUFFIX,
+)
+from langchain_community.agent_toolkits.powerbi.toolkit import PowerBIToolkit
+from langchain_community.utilities.powerbi import PowerBIDataset
+
+if TYPE_CHECKING:
+    from langchain.agents import AgentExecutor
+    from langchain.agents.agent import AgentOutputParser
+    from langchain.memory.chat_memory import BaseChatMemory
+
+
+def create_pbi_chat_agent(
+    llm: BaseChatModel,
+    toolkit: Optional[PowerBIToolkit] = None,
+    powerbi: Optional[PowerBIDataset] = None,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    output_parser: Optional[AgentOutputParser] = None,
+    prefix: str = POWERBI_CHAT_PREFIX,
+    suffix: str = POWERBI_CHAT_SUFFIX,
+    examples: Optional[str] = None,
+    input_variables: Optional[List[str]] = None,
+    memory: Optional[BaseChatMemory] = None,
+    top_k: int = 10,
+    verbose: bool = False,
+    agent_executor_kwargs: Optional[Dict[str, Any]] = None,
+    **kwargs: Any,
+) -> AgentExecutor:
+    """Construct a Power BI agent from a Chat LLM and tools.
+
+    If you supply only a toolkit and no Power BI dataset, the same LLM is used for both.
+    """
+    from langchain.agents import AgentExecutor
+    from langchain.agents.conversational_chat.base import ConversationalChatAgent
+    from langchain.memory import ConversationBufferMemory
+
+    if toolkit is None:
+        if powerbi is None:
+            raise ValueError("Must provide either a toolkit or powerbi dataset")
+        toolkit = PowerBIToolkit(powerbi=powerbi, llm=llm, examples=examples)
+    tools = toolkit.get_tools()
+    tables = powerbi.table_names if powerbi else toolkit.powerbi.table_names
+    agent = ConversationalChatAgent.from_llm_and_tools(
+        llm=llm,
+        tools=tools,
+        system_message=prefix.format(top_k=top_k).format(tables=tables),
+        human_message=suffix,
+        input_variables=input_variables,
+        callback_manager=callback_manager,
+        output_parser=output_parser,
+        verbose=verbose,
+        **kwargs,
+    )
+    return AgentExecutor.from_agent_and_tools(
+        agent=agent,
+        tools=tools,
+        callback_manager=callback_manager,
+        memory=memory
+        or ConversationBufferMemory(memory_key="chat_history", return_messages=True),
+        verbose=verbose,
+        **(agent_executor_kwargs or {}),
+    )
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/prompt.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..673a6bed29bc4f7548a0a75056d0b7288c00199c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/prompt.py
@@ -0,0 +1,38 @@
+# flake8: noqa
+"""Prompts for PowerBI agent."""
+
+
+POWERBI_PREFIX = """You are an agent designed to help users interact with a PowerBI Dataset.
+
+Agent has access to a tool that can write a query based on the question and then run those against PowerBI, Microsofts business intelligence tool. The questions from the users should be interpreted as related to the dataset that is available and not general questions about the world. If the question does not seem related to the dataset, return "This does not appear to be part of this dataset." as the answer.
+
+Given an input question, ask to run the questions against the dataset, then look at the results and return the answer, the answer should be a complete sentence that answers the question, if multiple rows are asked find a way to write that in a easily readable format for a human, also make sure to represent numbers in readable ways, like 1M instead of 1000000. Unless the user specifies a specific number of examples they wish to obtain, always limit your query to at most {top_k} results.
+"""
+
+POWERBI_SUFFIX = """Begin!
+
+Question: {input}
+Thought: I can first ask which tables I have, then how each table is defined and then ask the query tool the question I need, and finally create a nice sentence that answers the question.
+{agent_scratchpad}"""
+
+POWERBI_CHAT_PREFIX = """Assistant is a large language model built to help users interact with a PowerBI Dataset.
+
+Assistant should try to create a correct and complete answer to the question from the user. If the user asks a question not related to the dataset it should return "This does not appear to be part of this dataset." as the answer. The user might make a mistake with the spelling of certain values, if you think that is the case, ask the user to confirm the spelling of the value and then run the query again. Unless the user specifies a specific number of examples they wish to obtain, and the results are too large, limit your query to at most {top_k} results, but make it clear when answering which field was used for the filtering. The user has access to these tables: {{tables}}.
+
+The answer should be a complete sentence that answers the question, if multiple rows are asked find a way to write that in a easily readable format for a human, also make sure to represent numbers in readable ways, like 1M instead of 1000000. 
+"""
+
+POWERBI_CHAT_SUFFIX = """TOOLS
+------
+Assistant can ask the user to use tools to look up information that may be helpful in answering the users original question. The tools the human can use are:
+
+{{tools}}
+
+{format_instructions}
+
+USER'S INPUT
+--------------------
+Here is the user's input (remember to respond with a markdown code snippet of a json blob with a single action, and NOTHING else):
+
+{{{{input}}}}
+"""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a89d77ad2a44f0e9daf1939365e9ad0423ae4b6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/powerbi/toolkit.py
@@ -0,0 +1,108 @@
+"""Toolkit for interacting with a Power BI dataset."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List, Optional, Union
+
+from langchain_core.callbacks import BaseCallbackManager
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.prompts import PromptTemplate
+from langchain_core.prompts.chat import (
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+    SystemMessagePromptTemplate,
+)
+from langchain_core.pydantic_v1 import Field
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.powerbi.prompt import (
+    QUESTION_TO_QUERY_BASE,
+    SINGLE_QUESTION_TO_QUERY,
+    USER_INPUT,
+)
+from langchain_community.tools.powerbi.tool import (
+    InfoPowerBITool,
+    ListPowerBITool,
+    QueryPowerBITool,
+)
+from langchain_community.utilities.powerbi import PowerBIDataset
+
+if TYPE_CHECKING:
+    from langchain.chains.llm import LLMChain
+
+
+class PowerBIToolkit(BaseToolkit):
+    """Toolkit for interacting with Power BI dataset.
+
+    *Security Note*: This toolkit interacts with an external service.
+
+        Control access to who can use this toolkit.
+
+        Make sure that the capabilities given by this toolkit to the calling
+        code are appropriately scoped to the application.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    powerbi: PowerBIDataset = Field(exclude=True)
+    llm: Union[BaseLanguageModel, BaseChatModel] = Field(exclude=True)
+    examples: Optional[str] = None
+    max_iterations: int = 5
+    callback_manager: Optional[BaseCallbackManager] = None
+    output_token_limit: Optional[int] = None
+    tiktoken_model_name: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return [
+            QueryPowerBITool(
+                llm_chain=self._get_chain(),
+                powerbi=self.powerbi,
+                examples=self.examples,
+                max_iterations=self.max_iterations,
+                output_token_limit=self.output_token_limit,
+                tiktoken_model_name=self.tiktoken_model_name,
+            ),
+            InfoPowerBITool(powerbi=self.powerbi),
+            ListPowerBITool(powerbi=self.powerbi),
+        ]
+
+    def _get_chain(self) -> LLMChain:
+        """Construct the chain based on the callback manager and model type."""
+        from langchain.chains.llm import LLMChain
+
+        if isinstance(self.llm, BaseLanguageModel):
+            return LLMChain(
+                llm=self.llm,
+                callback_manager=self.callback_manager
+                if self.callback_manager
+                else None,
+                prompt=PromptTemplate(
+                    template=SINGLE_QUESTION_TO_QUERY,
+                    input_variables=["tool_input", "tables", "schemas", "examples"],
+                ),
+            )
+
+        system_prompt = SystemMessagePromptTemplate(
+            prompt=PromptTemplate(
+                template=QUESTION_TO_QUERY_BASE,
+                input_variables=["tables", "schemas", "examples"],
+            )
+        )
+        human_prompt = HumanMessagePromptTemplate(
+            prompt=PromptTemplate(
+                template=USER_INPUT,
+                input_variables=["tool_input"],
+            )
+        )
+        return LLMChain(
+            llm=self.llm,
+            callback_manager=self.callback_manager if self.callback_manager else None,
+            prompt=ChatPromptTemplate.from_messages([system_prompt, human_prompt]),
+        )
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/slack/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/slack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1ec5ae704ce5eb6ba87c7061da65aec216915295
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/slack/__init__.py
@@ -0,0 +1 @@
+"""Slack toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/slack/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/slack/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..169334bfb90056d8eb5ab7e708921b01e9888cab
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/slack/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/slack/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/slack/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6e10450f235288efc0a1d3454acd9dd3807f3aec
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/slack/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/slack/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/slack/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc0f09ff1db08c714b6254cc616cbde44f389bbf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/slack/toolkit.py
@@ -0,0 +1,36 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List
+
+from langchain_core.pydantic_v1 import Field
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.slack.get_channel import SlackGetChannel
+from langchain_community.tools.slack.get_message import SlackGetMessage
+from langchain_community.tools.slack.schedule_message import SlackScheduleMessage
+from langchain_community.tools.slack.send_message import SlackSendMessage
+from langchain_community.tools.slack.utils import login
+
+if TYPE_CHECKING:
+    from slack_sdk import WebClient
+
+
+class SlackToolkit(BaseToolkit):
+    """Toolkit for interacting with Slack."""
+
+    client: WebClient = Field(default_factory=login)
+
+    class Config:
+        """Pydantic config."""
+
+        arbitrary_types_allowed = True
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return [
+            SlackGetChannel(),
+            SlackGetMessage(),
+            SlackScheduleMessage(),
+            SlackSendMessage(),
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4308c079443cbd52500cbbc928422c3ce7506db3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__init__.py
@@ -0,0 +1 @@
+"""Spark SQL agent."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..849aec76446fcf8ae1966dc0b489d69361c9a97b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..14bd5347538dcbf66d091cc404faf84c66367746
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7ce9c7bf8b1923f03985fd45e07402d3fa91472f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3b451ad747c657cc2047e900631711f37f5ebea7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/base.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..dca019b04252a9cf6a6e68207b10ee53d25601c8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/base.py
@@ -0,0 +1,70 @@
+"""Spark SQL agent."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+from langchain_core.callbacks import BaseCallbackManager, Callbacks
+from langchain_core.language_models import BaseLanguageModel
+
+from langchain_community.agent_toolkits.spark_sql.prompt import SQL_PREFIX, SQL_SUFFIX
+from langchain_community.agent_toolkits.spark_sql.toolkit import SparkSQLToolkit
+
+if TYPE_CHECKING:
+    from langchain.agents.agent import AgentExecutor
+
+
+def create_spark_sql_agent(
+    llm: BaseLanguageModel,
+    toolkit: SparkSQLToolkit,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    callbacks: Callbacks = None,
+    prefix: str = SQL_PREFIX,
+    suffix: str = SQL_SUFFIX,
+    format_instructions: Optional[str] = None,
+    input_variables: Optional[List[str]] = None,
+    top_k: int = 10,
+    max_iterations: Optional[int] = 15,
+    max_execution_time: Optional[float] = None,
+    early_stopping_method: str = "force",
+    verbose: bool = False,
+    agent_executor_kwargs: Optional[Dict[str, Any]] = None,
+    **kwargs: Any,
+) -> AgentExecutor:
+    """Construct a Spark SQL agent from an LLM and tools."""
+    from langchain.agents.agent import AgentExecutor
+    from langchain.agents.mrkl.base import ZeroShotAgent
+    from langchain.chains.llm import LLMChain
+
+    tools = toolkit.get_tools()
+    prefix = prefix.format(top_k=top_k)
+    prompt_params = (
+        {"format_instructions": format_instructions}
+        if format_instructions is not None
+        else {}
+    )
+    prompt = ZeroShotAgent.create_prompt(
+        tools,
+        prefix=prefix,
+        suffix=suffix,
+        input_variables=input_variables,
+        **prompt_params,
+    )
+    llm_chain = LLMChain(
+        llm=llm,
+        prompt=prompt,
+        callback_manager=callback_manager,
+        callbacks=callbacks,
+    )
+    tool_names = [tool.name for tool in tools]
+    agent = ZeroShotAgent(llm_chain=llm_chain, allowed_tools=tool_names, **kwargs)
+    return AgentExecutor.from_agent_and_tools(
+        agent=agent,
+        tools=tools,
+        callback_manager=callback_manager,
+        callbacks=callbacks,
+        verbose=verbose,
+        max_iterations=max_iterations,
+        max_execution_time=max_execution_time,
+        early_stopping_method=early_stopping_method,
+        **(agent_executor_kwargs or {}),
+    )
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/prompt.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..b499085d3fe7c83d4621d3c817cfc2fa4e75099d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/prompt.py
@@ -0,0 +1,21 @@
+# flake8: noqa
+
+SQL_PREFIX = """You are an agent designed to interact with Spark SQL.
+Given an input question, create a syntactically correct Spark SQL query to run, then look at the results of the query and return the answer.
+Unless the user specifies a specific number of examples they wish to obtain, always limit your query to at most {top_k} results.
+You can order the results by a relevant column to return the most interesting examples in the database.
+Never query for all the columns from a specific table, only ask for the relevant columns given the question.
+You have access to tools for interacting with the database.
+Only use the below tools. Only use the information returned by the below tools to construct your final answer.
+You MUST double check your query before executing it. If you get an error while executing a query, rewrite the query and try again.
+
+DO NOT make any DML statements (INSERT, UPDATE, DELETE, DROP etc.) to the database.
+
+If the question does not seem related to the database, just return "I don't know" as the answer.
+"""
+
+SQL_SUFFIX = """Begin!
+
+Question: {input}
+Thought: I should look at the tables in the database to see what I can query.
+{agent_scratchpad}"""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd0363132d0ee74f41400f7a2d8b71d4e219140b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/spark_sql/toolkit.py
@@ -0,0 +1,36 @@
+"""Toolkit for interacting with Spark SQL."""
+from typing import List
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.pydantic_v1 import Field
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.spark_sql.tool import (
+    InfoSparkSQLTool,
+    ListSparkSQLTool,
+    QueryCheckerTool,
+    QuerySparkSQLTool,
+)
+from langchain_community.utilities.spark_sql import SparkSQL
+
+
+class SparkSQLToolkit(BaseToolkit):
+    """Toolkit for interacting with Spark SQL."""
+
+    db: SparkSQL = Field(exclude=True)
+    llm: BaseLanguageModel = Field(exclude=True)
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return [
+            QuerySparkSQLTool(db=self.db),
+            InfoSparkSQLTool(db=self.db),
+            ListSparkSQLTool(db=self.db),
+            QueryCheckerTool(db=self.db, llm=self.llm),
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..74293a52391557789bd62c6885ecd91f04b89dc8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__init__.py
@@ -0,0 +1 @@
+"""SQL agent."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b734be9310cb167ba4aa28568bb9a9d155501980
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..76253aa07c4beb41bf30aa125a32a3918f635dae
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..095155c1624ececde1de91325e9cff3e9c73648d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..648d1d35b38e4e9d5614b0ced782fbf60d1b33f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/base.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..cefb985388b516e89e65bc8daf645049d42d81c7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/base.py
@@ -0,0 +1,228 @@
+"""SQL agent."""
+from __future__ import annotations
+
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    Sequence,
+    Union,
+    cast,
+)
+
+from langchain_core.messages import AIMessage, SystemMessage
+from langchain_core.prompts import BasePromptTemplate, PromptTemplate
+from langchain_core.prompts.chat import (
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+    MessagesPlaceholder,
+)
+
+from langchain_community.agent_toolkits.sql.prompt import (
+    SQL_FUNCTIONS_SUFFIX,
+    SQL_PREFIX,
+)
+from langchain_community.agent_toolkits.sql.toolkit import SQLDatabaseToolkit
+from langchain_community.tools.sql_database.tool import (
+    InfoSQLDatabaseTool,
+    ListSQLDatabaseTool,
+)
+
+if TYPE_CHECKING:
+    from langchain.agents.agent import AgentExecutor
+    from langchain.agents.agent_types import AgentType
+    from langchain_core.callbacks import BaseCallbackManager
+    from langchain_core.language_models import BaseLanguageModel
+    from langchain_core.tools import BaseTool
+
+    from langchain_community.utilities.sql_database import SQLDatabase
+
+
+def create_sql_agent(
+    llm: BaseLanguageModel,
+    toolkit: Optional[SQLDatabaseToolkit] = None,
+    agent_type: Optional[Union[AgentType, Literal["openai-tools"]]] = None,
+    callback_manager: Optional[BaseCallbackManager] = None,
+    prefix: Optional[str] = None,
+    suffix: Optional[str] = None,
+    format_instructions: Optional[str] = None,
+    input_variables: Optional[List[str]] = None,
+    top_k: int = 10,
+    max_iterations: Optional[int] = 15,
+    max_execution_time: Optional[float] = None,
+    early_stopping_method: str = "force",
+    verbose: bool = False,
+    agent_executor_kwargs: Optional[Dict[str, Any]] = None,
+    extra_tools: Sequence[BaseTool] = (),
+    *,
+    db: Optional[SQLDatabase] = None,
+    prompt: Optional[BasePromptTemplate] = None,
+    **kwargs: Any,
+) -> AgentExecutor:
+    """Construct a SQL agent from an LLM and toolkit or database.
+
+    Args:
+        llm: Language model to use for the agent.
+        toolkit: SQLDatabaseToolkit for the agent to use. Must provide exactly one of
+            'toolkit' or 'db'. Specify 'toolkit' if you want to use a different model
+            for the agent and the toolkit.
+        agent_type: One of "openai-tools", "openai-functions", or
+            "zero-shot-react-description". Defaults to "zero-shot-react-description".
+            "openai-tools" is recommended over "openai-functions".
+        callback_manager: DEPRECATED. Pass "callbacks" key into 'agent_executor_kwargs'
+            instead to pass constructor callbacks to AgentExecutor.
+        prefix: Prompt prefix string. Must contain variables "top_k" and "dialect".
+        suffix: Prompt suffix string. Default depends on agent type.
+        format_instructions: Formatting instructions to pass to
+            ZeroShotAgent.create_prompt() when 'agent_type' is
+            "zero-shot-react-description". Otherwise ignored.
+        input_variables: DEPRECATED.
+        top_k: Number of rows to query for by default.
+        max_iterations: Passed to AgentExecutor init.
+        max_execution_time: Passed to AgentExecutor init.
+        early_stopping_method: Passed to AgentExecutor init.
+        verbose: AgentExecutor verbosity.
+        agent_executor_kwargs: Arbitrary additional AgentExecutor args.
+        extra_tools: Additional tools to give to agent on top of the ones that come with
+            SQLDatabaseToolkit.
+        db: SQLDatabase from which to create a SQLDatabaseToolkit. Toolkit is created
+            using 'db' and 'llm'. Must provide exactly one of 'db' or 'toolkit'.
+        prompt: Complete agent prompt. prompt and {prefix, suffix, format_instructions,
+            input_variables} are mutually exclusive.
+        **kwargs: Arbitrary additional Agent args.
+
+    Returns:
+        An AgentExecutor with the specified agent_type agent.
+
+    Example:
+
+        .. code-block:: python
+
+        from langchain_openai import ChatOpenAI
+        from langchain_community.agent_toolkits import create_sql_agent
+        from langchain_community.utilities import SQLDatabase
+
+        db = SQLDatabase.from_uri("sqlite:///Chinook.db")
+        llm = ChatOpenAI(model="gpt-3.5-turbo", temperature=0)
+        agent_executor = create_sql_agent(llm, db=db, agent_type="openai-tools", verbose=True)
+
+    """  # noqa: E501
+    from langchain.agents import (
+        create_openai_functions_agent,
+        create_openai_tools_agent,
+        create_react_agent,
+    )
+    from langchain.agents.agent import (
+        AgentExecutor,
+        RunnableAgent,
+        RunnableMultiActionAgent,
+    )
+    from langchain.agents.agent_types import AgentType
+
+    if toolkit is None and db is None:
+        raise ValueError(
+            "Must provide exactly one of 'toolkit' or 'db'. Received neither."
+        )
+    if toolkit and db:
+        raise ValueError(
+            "Must provide exactly one of 'toolkit' or 'db'. Received both."
+        )
+
+    toolkit = toolkit or SQLDatabaseToolkit(llm=llm, db=db)
+    agent_type = agent_type or AgentType.ZERO_SHOT_REACT_DESCRIPTION
+    tools = toolkit.get_tools() + list(extra_tools)
+    if prompt is None:
+        prefix = prefix or SQL_PREFIX
+        prefix = prefix.format(dialect=toolkit.dialect, top_k=top_k)
+    else:
+        if "top_k" in prompt.input_variables:
+            prompt = prompt.partial(top_k=str(top_k))
+        if "dialect" in prompt.input_variables:
+            prompt = prompt.partial(dialect=toolkit.dialect)
+        if any(key in prompt.input_variables for key in ["table_info", "table_names"]):
+            db_context = toolkit.get_context()
+            if "table_info" in prompt.input_variables:
+                prompt = prompt.partial(table_info=db_context["table_info"])
+                tools = [
+                    tool for tool in tools if not isinstance(tool, InfoSQLDatabaseTool)
+                ]
+            if "table_names" in prompt.input_variables:
+                prompt = prompt.partial(table_names=db_context["table_names"])
+                tools = [
+                    tool for tool in tools if not isinstance(tool, ListSQLDatabaseTool)
+                ]
+
+    if agent_type == AgentType.ZERO_SHOT_REACT_DESCRIPTION:
+        if prompt is None:
+            from langchain.agents.mrkl import prompt as react_prompt
+
+            format_instructions = (
+                format_instructions or react_prompt.FORMAT_INSTRUCTIONS
+            )
+            template = "\n\n".join(
+                [
+                    react_prompt.PREFIX,
+                    "{tools}",
+                    format_instructions,
+                    react_prompt.SUFFIX,
+                ]
+            )
+            prompt = PromptTemplate.from_template(template)
+        agent = RunnableAgent(
+            runnable=create_react_agent(llm, tools, prompt),
+            input_keys_arg=["input"],
+            return_keys_arg=["output"],
+            **kwargs,
+        )
+
+    elif agent_type == AgentType.OPENAI_FUNCTIONS:
+        if prompt is None:
+            messages: List = [
+                SystemMessage(content=cast(str, prefix)),
+                HumanMessagePromptTemplate.from_template("{input}"),
+                AIMessage(content=suffix or SQL_FUNCTIONS_SUFFIX),
+                MessagesPlaceholder(variable_name="agent_scratchpad"),
+            ]
+            prompt = ChatPromptTemplate.from_messages(messages)
+        agent = RunnableAgent(
+            runnable=create_openai_functions_agent(llm, tools, prompt),
+            input_keys_arg=["input"],
+            return_keys_arg=["output"],
+            **kwargs,
+        )
+    elif agent_type == "openai-tools":
+        if prompt is None:
+            messages = [
+                SystemMessage(content=cast(str, prefix)),
+                HumanMessagePromptTemplate.from_template("{input}"),
+                AIMessage(content=suffix or SQL_FUNCTIONS_SUFFIX),
+                MessagesPlaceholder(variable_name="agent_scratchpad"),
+            ]
+            prompt = ChatPromptTemplate.from_messages(messages)
+        agent = RunnableMultiActionAgent(
+            runnable=create_openai_tools_agent(llm, tools, prompt),
+            input_keys_arg=["input"],
+            return_keys_arg=["output"],
+            **kwargs,
+        )
+
+    else:
+        raise ValueError(
+            f"Agent type {agent_type} not supported at the moment. Must be one of "
+            "'openai-tools', 'openai-functions', or 'zero-shot-react-description'."
+        )
+
+    return AgentExecutor(
+        name="SQL Agent Executor",
+        agent=agent,
+        tools=tools,
+        callback_manager=callback_manager,
+        verbose=verbose,
+        max_iterations=max_iterations,
+        max_execution_time=max_execution_time,
+        early_stopping_method=early_stopping_method,
+        **(agent_executor_kwargs or {}),
+    )
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/prompt.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..92464da4b9b9f3eeb128cd216b5701d6cc2e5761
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/prompt.py
@@ -0,0 +1,23 @@
+# flake8: noqa
+
+SQL_PREFIX = """You are an agent designed to interact with a SQL database.
+Given an input question, create a syntactically correct {dialect} query to run, then look at the results of the query and return the answer.
+Unless the user specifies a specific number of examples they wish to obtain, always limit your query to at most {top_k} results.
+You can order the results by a relevant column to return the most interesting examples in the database.
+Never query for all the columns from a specific table, only ask for the relevant columns given the question.
+You have access to tools for interacting with the database.
+Only use the below tools. Only use the information returned by the below tools to construct your final answer.
+You MUST double check your query before executing it. If you get an error while executing a query, rewrite the query and try again.
+
+DO NOT make any DML statements (INSERT, UPDATE, DELETE, DROP etc.) to the database.
+
+If the question does not seem related to the database, just return "I don't know" as the answer.
+"""
+
+SQL_SUFFIX = """Begin!
+
+Question: {input}
+Thought: I should look at the tables in the database to see what I can query.  Then I should query the schema of the most relevant tables.
+{agent_scratchpad}"""
+
+SQL_FUNCTIONS_SUFFIX = """I should look at the tables in the database to see what I can query.  Then I should query the schema of the most relevant tables."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..6944b557f20dd6571dbabcea783b66bc005eb31e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/sql/toolkit.py
@@ -0,0 +1,75 @@
+"""Toolkit for interacting with an SQL database."""
+from typing import List
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.pydantic_v1 import Field
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.sql_database.tool import (
+    InfoSQLDatabaseTool,
+    ListSQLDatabaseTool,
+    QuerySQLCheckerTool,
+    QuerySQLDataBaseTool,
+)
+from langchain_community.utilities.sql_database import SQLDatabase
+
+
+class SQLDatabaseToolkit(BaseToolkit):
+    """Toolkit for interacting with SQL databases."""
+
+    db: SQLDatabase = Field(exclude=True)
+    llm: BaseLanguageModel = Field(exclude=True)
+
+    @property
+    def dialect(self) -> str:
+        """Return string representation of SQL dialect to use."""
+        return self.db.dialect
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        list_sql_database_tool = ListSQLDatabaseTool(db=self.db)
+        info_sql_database_tool_description = (
+            "Input to this tool is a comma-separated list of tables, output is the "
+            "schema and sample rows for those tables. "
+            "Be sure that the tables actually exist by calling "
+            f"{list_sql_database_tool.name} first! "
+            "Example Input: table1, table2, table3"
+        )
+        info_sql_database_tool = InfoSQLDatabaseTool(
+            db=self.db, description=info_sql_database_tool_description
+        )
+        query_sql_database_tool_description = (
+            "Input to this tool is a detailed and correct SQL query, output is a "
+            "result from the database. If the query is not correct, an error message "
+            "will be returned. If an error is returned, rewrite the query, check the "
+            "query, and try again. If you encounter an issue with Unknown column "
+            f"'xxxx' in 'field list', use {info_sql_database_tool.name} "
+            "to query the correct table fields."
+        )
+        query_sql_database_tool = QuerySQLDataBaseTool(
+            db=self.db, description=query_sql_database_tool_description
+        )
+        query_sql_checker_tool_description = (
+            "Use this tool to double check if your query is correct before executing "
+            "it. Always use this tool before executing a query with "
+            f"{query_sql_database_tool.name}!"
+        )
+        query_sql_checker_tool = QuerySQLCheckerTool(
+            db=self.db, llm=self.llm, description=query_sql_checker_tool_description
+        )
+        return [
+            query_sql_database_tool,
+            info_sql_database_tool,
+            list_sql_database_tool,
+            query_sql_checker_tool,
+        ]
+
+    def get_context(self) -> dict:
+        """Return db context that you may want in agent prompt."""
+        return self.db.get_context()
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/steam/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/steam/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f99981082424ee0a70e444573cb3b4f6f2de4947
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/steam/__init__.py
@@ -0,0 +1 @@
+"""Steam Toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/steam/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/steam/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..abd09daf129d846b9e43fb7763c9b24bc5fd62e6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/steam/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/steam/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/steam/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4ce845dff11f23ae0a8c78c768488c643f9ff48a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/steam/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/steam/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/steam/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..1fe57b032bf7f20d4717b218ecda99b3bf187ba1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/steam/toolkit.py
@@ -0,0 +1,48 @@
+"""Steam Toolkit."""
+from typing import List
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.steam.prompt import (
+    STEAM_GET_GAMES_DETAILS,
+    STEAM_GET_RECOMMENDED_GAMES,
+)
+from langchain_community.tools.steam.tool import SteamWebAPIQueryRun
+from langchain_community.utilities.steam import SteamWebAPIWrapper
+
+
+class SteamToolkit(BaseToolkit):
+    """Steam Toolkit."""
+
+    tools: List[BaseTool] = []
+
+    @classmethod
+    def from_steam_api_wrapper(
+        cls, steam_api_wrapper: SteamWebAPIWrapper
+    ) -> "SteamToolkit":
+        operations: List[dict] = [
+            {
+                "mode": "get_games_details",
+                "name": "Get Games Details",
+                "description": STEAM_GET_GAMES_DETAILS,
+            },
+            {
+                "mode": "get_recommended_games",
+                "name": "Get Recommended Games",
+                "description": STEAM_GET_RECOMMENDED_GAMES,
+            },
+        ]
+        tools = [
+            SteamWebAPIQueryRun(
+                name=action["name"],
+                description=action["description"],
+                mode=action["mode"],
+                api_wrapper=steam_api_wrapper,
+            )
+            for action in operations
+        ]
+        return cls(tools=tools)
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        return self.tools
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/xorbits/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/xorbits/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd8fc13ba0da8082657c3e2ba2bd7a33b75c94d4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/xorbits/__init__.py
@@ -0,0 +1,26 @@
+from pathlib import Path
+from typing import Any
+
+from langchain_core._api.path import as_import_path
+
+
+def __getattr__(name: str) -> Any:
+    """Get attr name."""
+
+    if name == "create_xorbits_agent":
+        # Get directory of langchain package
+        HERE = Path(__file__).parents[3]
+        here = as_import_path(Path(__file__).parent, relative_to=HERE)
+
+        old_path = "langchain." + here + "." + name
+        new_path = "langchain_experimental." + here + "." + name
+        raise ImportError(
+            "This agent has been moved to langchain experiment. "
+            "This agent relies on python REPL tool under the hood, so to use it "
+            "safely please sandbox the python REPL. "
+            "Read https://github.com/langchain-ai/langchain/blob/master/SECURITY.md "
+            "and https://github.com/langchain-ai/langchain/discussions/11680"
+            "To keep using this code as is, install langchain experimental and "
+            f"update your import statement from:\n `{old_path}` to `{new_path}`."
+        )
+    raise AttributeError(f"{name} does not exist")
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/xorbits/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/xorbits/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b353f34a76fff0c3c3b97b8b6cefea29f49cfe14
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/xorbits/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/zapier/__init__.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/zapier/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..faef4a3253167aa6767779fbd32292cedcfc4a4e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/zapier/__init__.py
@@ -0,0 +1 @@
+"""Zapier Toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/zapier/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/zapier/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..125c60ea526e4c2c40df8311971e72722be045b9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/zapier/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/zapier/__pycache__/toolkit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/agent_toolkits/zapier/__pycache__/toolkit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e7ed2624a9d84da8e69769e12073ffe6f8704ea
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/agent_toolkits/zapier/__pycache__/toolkit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/agent_toolkits/zapier/toolkit.py b/llm/Lib/site-packages/langchain_community/agent_toolkits/zapier/toolkit.py
new file mode 100644
index 0000000000000000000000000000000000000000..f5f335efdc81f184b1d3742e4996b739a6048c76
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/agent_toolkits/zapier/toolkit.py
@@ -0,0 +1,60 @@
+"""[DEPRECATED] Zapier Toolkit."""
+from typing import List
+
+from langchain_core._api import warn_deprecated
+
+from langchain_community.agent_toolkits.base import BaseToolkit
+from langchain_community.tools import BaseTool
+from langchain_community.tools.zapier.tool import ZapierNLARunAction
+from langchain_community.utilities.zapier import ZapierNLAWrapper
+
+
+class ZapierToolkit(BaseToolkit):
+    """Zapier Toolkit."""
+
+    tools: List[BaseTool] = []
+
+    @classmethod
+    def from_zapier_nla_wrapper(
+        cls, zapier_nla_wrapper: ZapierNLAWrapper
+    ) -> "ZapierToolkit":
+        """Create a toolkit from a ZapierNLAWrapper."""
+        actions = zapier_nla_wrapper.list()
+        tools = [
+            ZapierNLARunAction(
+                action_id=action["id"],
+                zapier_description=action["description"],
+                params_schema=action["params"],
+                api_wrapper=zapier_nla_wrapper,
+            )
+            for action in actions
+        ]
+        return cls(tools=tools)
+
+    @classmethod
+    async def async_from_zapier_nla_wrapper(
+        cls, zapier_nla_wrapper: ZapierNLAWrapper
+    ) -> "ZapierToolkit":
+        """Create a toolkit from a ZapierNLAWrapper."""
+        actions = await zapier_nla_wrapper.alist()
+        tools = [
+            ZapierNLARunAction(
+                action_id=action["id"],
+                zapier_description=action["description"],
+                params_schema=action["params"],
+                api_wrapper=zapier_nla_wrapper,
+            )
+            for action in actions
+        ]
+        return cls(tools=tools)
+
+    def get_tools(self) -> List[BaseTool]:
+        """Get the tools in the toolkit."""
+        warn_deprecated(
+            since="0.0.319",
+            message=(
+                "This tool will be deprecated on 2023-11-17. See "
+                "https://nla.zapier.com/sunset/ for details"
+            ),
+        )
+        return self.tools
diff --git a/llm/Lib/site-packages/langchain_community/cache.py b/llm/Lib/site-packages/langchain_community/cache.py
new file mode 100644
index 0000000000000000000000000000000000000000..7002fead099b141bd93492760240a6b333d302bf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/cache.py
@@ -0,0 +1,2048 @@
+"""
+.. warning::
+  Beta Feature!
+
+**Cache** provides an optional caching layer for LLMs.
+
+Cache is useful for two reasons:
+
+- It can save you money by reducing the number of API calls you make to the LLM
+  provider if you're often requesting the same completion multiple times.
+- It can speed up your application by reducing the number of API calls you make
+  to the LLM provider.
+
+Cache directly competes with Memory. See documentation for Pros and Cons.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseCache --> <name>Cache  # Examples: InMemoryCache, RedisCache, GPTCache
+"""
+from __future__ import annotations
+
+import hashlib
+import inspect
+import json
+import logging
+import uuid
+import warnings
+from abc import ABC
+from datetime import timedelta
+from enum import Enum
+from functools import lru_cache, wraps
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Awaitable,
+    Callable,
+    Dict,
+    Generator,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+
+from sqlalchemy import Column, Integer, String, create_engine, delete, select
+from sqlalchemy.engine import Row
+from sqlalchemy.engine.base import Engine
+from sqlalchemy.orm import Session
+
+from langchain_community.vectorstores.azure_cosmos_db import (
+    CosmosDBSimilarityType,
+    CosmosDBVectorSearchType,
+)
+
+try:
+    from sqlalchemy.orm import declarative_base
+except ImportError:
+    from sqlalchemy.ext.declarative import declarative_base
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.caches import RETURN_VAL_TYPE, BaseCache
+from langchain_core.embeddings import Embeddings
+from langchain_core.language_models.llms import LLM, aget_prompts, get_prompts
+from langchain_core.load.dump import dumps
+from langchain_core.load.load import loads
+from langchain_core.outputs import ChatGeneration, Generation
+from langchain_core.utils import get_from_env
+
+from langchain_community.utilities.astradb import (
+    SetupMode,
+    _AstraDBCollectionEnvironment,
+)
+from langchain_community.vectorstores import AzureCosmosDBVectorSearch
+from langchain_community.vectorstores.redis import Redis as RedisVectorstore
+
+logger = logging.getLogger(__file__)
+
+if TYPE_CHECKING:
+    import momento
+    from astrapy.db import AstraDB, AsyncAstraDB
+    from cassandra.cluster import Session as CassandraSession
+
+
+def _hash(_input: str) -> str:
+    """Use a deterministic hashing approach."""
+    return hashlib.md5(_input.encode()).hexdigest()
+
+
+def _dump_generations_to_json(generations: RETURN_VAL_TYPE) -> str:
+    """Dump generations to json.
+
+    Args:
+        generations (RETURN_VAL_TYPE): A list of language model generations.
+
+    Returns:
+        str: Json representing a list of generations.
+
+    Warning: would not work well with arbitrary subclasses of `Generation`
+    """
+    return json.dumps([generation.dict() for generation in generations])
+
+
+def _load_generations_from_json(generations_json: str) -> RETURN_VAL_TYPE:
+    """Load generations from json.
+
+    Args:
+        generations_json (str): A string of json representing a list of generations.
+
+    Raises:
+        ValueError: Could not decode json string to list of generations.
+
+    Returns:
+        RETURN_VAL_TYPE: A list of generations.
+
+    Warning: would not work well with arbitrary subclasses of `Generation`
+    """
+    try:
+        results = json.loads(generations_json)
+        return [Generation(**generation_dict) for generation_dict in results]
+    except json.JSONDecodeError:
+        raise ValueError(
+            f"Could not decode json to list of generations: {generations_json}"
+        )
+
+
+def _dumps_generations(generations: RETURN_VAL_TYPE) -> str:
+    """
+    Serialization for generic RETURN_VAL_TYPE, i.e. sequence of `Generation`
+
+    Args:
+        generations (RETURN_VAL_TYPE): A list of language model generations.
+
+    Returns:
+        str: a single string representing a list of generations.
+
+    This function (+ its counterpart `_loads_generations`) rely on
+    the dumps/loads pair with Reviver, so are able to deal
+    with all subclasses of Generation.
+
+    Each item in the list can be `dumps`ed to a string,
+    then we make the whole list of strings into a json-dumped.
+    """
+    return json.dumps([dumps(_item) for _item in generations])
+
+
+def _loads_generations(generations_str: str) -> Union[RETURN_VAL_TYPE, None]:
+    """
+    Deserialization of a string into a generic RETURN_VAL_TYPE
+    (i.e. a sequence of `Generation`).
+
+    See `_dumps_generations`, the inverse of this function.
+
+    Args:
+        generations_str (str): A string representing a list of generations.
+
+    Compatible with the legacy cache-blob format
+    Does not raise exceptions for malformed entries, just logs a warning
+    and returns none: the caller should be prepared for such a cache miss.
+
+    Returns:
+        RETURN_VAL_TYPE: A list of generations.
+    """
+    try:
+        generations = [loads(_item_str) for _item_str in json.loads(generations_str)]
+        return generations
+    except (json.JSONDecodeError, TypeError):
+        # deferring the (soft) handling to after the legacy-format attempt
+        pass
+
+    try:
+        gen_dicts = json.loads(generations_str)
+        # not relying on `_load_generations_from_json` (which could disappear):
+        generations = [Generation(**generation_dict) for generation_dict in gen_dicts]
+        logger.warning(
+            f"Legacy 'Generation' cached blob encountered: '{generations_str}'"
+        )
+        return generations
+    except (json.JSONDecodeError, TypeError):
+        logger.warning(
+            f"Malformed/unparsable cached blob encountered: '{generations_str}'"
+        )
+        return None
+
+
+class InMemoryCache(BaseCache):
+    """Cache that stores things in memory."""
+
+    def __init__(self) -> None:
+        """Initialize with empty cache."""
+        self._cache: Dict[Tuple[str, str], RETURN_VAL_TYPE] = {}
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up based on prompt and llm_string."""
+        return self._cache.get((prompt, llm_string), None)
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        """Update cache based on prompt and llm_string."""
+        self._cache[(prompt, llm_string)] = return_val
+
+    def clear(self, **kwargs: Any) -> None:
+        """Clear cache."""
+        self._cache = {}
+
+    async def alookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up based on prompt and llm_string."""
+        return self.lookup(prompt, llm_string)
+
+    async def aupdate(
+        self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE
+    ) -> None:
+        """Update cache based on prompt and llm_string."""
+        self.update(prompt, llm_string, return_val)
+
+    async def aclear(self, **kwargs: Any) -> None:
+        """Clear cache."""
+        self.clear()
+
+
+Base = declarative_base()
+
+
+class FullLLMCache(Base):  # type: ignore
+    """SQLite table for full LLM Cache (all generations)."""
+
+    __tablename__ = "full_llm_cache"
+    prompt = Column(String, primary_key=True)
+    llm = Column(String, primary_key=True)
+    idx = Column(Integer, primary_key=True)
+    response = Column(String)
+
+
+class SQLAlchemyCache(BaseCache):
+    """Cache that uses SQAlchemy as a backend."""
+
+    def __init__(self, engine: Engine, cache_schema: Type[FullLLMCache] = FullLLMCache):
+        """Initialize by creating all tables."""
+        self.engine = engine
+        self.cache_schema = cache_schema
+        self.cache_schema.metadata.create_all(self.engine)
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up based on prompt and llm_string."""
+        stmt = (
+            select(self.cache_schema.response)
+            .where(self.cache_schema.prompt == prompt)  # type: ignore
+            .where(self.cache_schema.llm == llm_string)
+            .order_by(self.cache_schema.idx)
+        )
+        with Session(self.engine) as session:
+            rows = session.execute(stmt).fetchall()
+            if rows:
+                try:
+                    return [loads(row[0]) for row in rows]
+                except Exception:
+                    logger.warning(
+                        "Retrieving a cache value that could not be deserialized "
+                        "properly. This is likely due to the cache being in an "
+                        "older format. Please recreate your cache to avoid this "
+                        "error."
+                    )
+                    # In a previous life we stored the raw text directly
+                    # in the table, so assume it's in that format.
+                    return [Generation(text=row[0]) for row in rows]
+        return None
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        """Update based on prompt and llm_string."""
+        items = [
+            self.cache_schema(prompt=prompt, llm=llm_string, response=dumps(gen), idx=i)
+            for i, gen in enumerate(return_val)
+        ]
+        with Session(self.engine) as session, session.begin():
+            for item in items:
+                session.merge(item)
+
+    def clear(self, **kwargs: Any) -> None:
+        """Clear cache."""
+        with Session(self.engine) as session:
+            session.query(self.cache_schema).delete()
+            session.commit()
+
+
+class SQLiteCache(SQLAlchemyCache):
+    """Cache that uses SQLite as a backend."""
+
+    def __init__(self, database_path: str = ".langchain.db"):
+        """Initialize by creating the engine and all tables."""
+        engine = create_engine(f"sqlite:///{database_path}")
+        super().__init__(engine)
+
+
+class UpstashRedisCache(BaseCache):
+    """Cache that uses Upstash Redis as a backend."""
+
+    def __init__(self, redis_: Any, *, ttl: Optional[int] = None):
+        """
+        Initialize an instance of UpstashRedisCache.
+
+        This method initializes an object with Upstash Redis caching capabilities.
+        It takes a `redis_` parameter, which should be an instance of an Upstash Redis
+        client class, allowing the object to interact with Upstash Redis
+        server for caching purposes.
+
+        Parameters:
+            redis_: An instance of Upstash Redis client class
+                (e.g., Redis) used for caching.
+                This allows the object to communicate with
+                Redis server for caching operations on.
+            ttl (int, optional): Time-to-live (TTL) for cached items in seconds.
+                If provided, it sets the time duration for how long cached
+                items will remain valid. If not provided, cached items will not
+                have an automatic expiration.
+        """
+        try:
+            from upstash_redis import Redis
+        except ImportError:
+            raise ValueError(
+                "Could not import upstash_redis python package. "
+                "Please install it with `pip install upstash_redis`."
+            )
+        if not isinstance(redis_, Redis):
+            raise ValueError("Please pass in Upstash Redis object.")
+        self.redis = redis_
+        self.ttl = ttl
+
+    def _key(self, prompt: str, llm_string: str) -> str:
+        """Compute key from prompt and llm_string"""
+        return _hash(prompt + llm_string)
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up based on prompt and llm_string."""
+        generations = []
+        # Read from a HASH
+        results = self.redis.hgetall(self._key(prompt, llm_string))
+        if results:
+            for _, text in results.items():
+                generations.append(Generation(text=text))
+        return generations if generations else None
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        """Update cache based on prompt and llm_string."""
+        for gen in return_val:
+            if not isinstance(gen, Generation):
+                raise ValueError(
+                    "UpstashRedisCache supports caching of normal LLM generations, "
+                    f"got {type(gen)}"
+                )
+            if isinstance(gen, ChatGeneration):
+                warnings.warn(
+                    "NOTE: Generation has not been cached. UpstashRedisCache does not"
+                    " support caching ChatModel outputs."
+                )
+                return
+        # Write to a HASH
+        key = self._key(prompt, llm_string)
+
+        mapping = {
+            str(idx): generation.text for idx, generation in enumerate(return_val)
+        }
+        self.redis.hset(key=key, values=mapping)
+
+        if self.ttl is not None:
+            self.redis.expire(key, self.ttl)
+
+    def clear(self, **kwargs: Any) -> None:
+        """
+        Clear cache. If `asynchronous` is True, flush asynchronously.
+        This flushes the *whole* db.
+        """
+        asynchronous = kwargs.get("asynchronous", False)
+        if asynchronous:
+            asynchronous = "ASYNC"
+        else:
+            asynchronous = "SYNC"
+        self.redis.flushdb(flush_type=asynchronous)
+
+
+class _RedisCacheBase(BaseCache, ABC):
+    @staticmethod
+    def _key(prompt: str, llm_string: str) -> str:
+        """Compute key from prompt and llm_string"""
+        return _hash(prompt + llm_string)
+
+    @staticmethod
+    def _ensure_generation_type(return_val: RETURN_VAL_TYPE) -> None:
+        for gen in return_val:
+            if not isinstance(gen, Generation):
+                raise ValueError(
+                    "RedisCache only supports caching of normal LLM generations, "
+                    f"got {type(gen)}"
+                )
+
+    @staticmethod
+    def _get_generations(
+        results: dict[str | bytes, str | bytes],
+    ) -> Optional[List[Generation]]:
+        generations = []
+        if results:
+            for _, text in results.items():
+                try:
+                    generations.append(loads(cast(str, text)))
+                except Exception:
+                    logger.warning(
+                        "Retrieving a cache value that could not be deserialized "
+                        "properly. This is likely due to the cache being in an "
+                        "older format. Please recreate your cache to avoid this "
+                        "error."
+                    )
+                    # In a previous life we stored the raw text directly
+                    # in the table, so assume it's in that format.
+                    generations.append(Generation(text=text))
+        return generations if generations else None
+
+    @staticmethod
+    def _configure_pipeline_for_update(
+        key: str, pipe: Any, return_val: RETURN_VAL_TYPE, ttl: Optional[int] = None
+    ) -> None:
+        pipe.hset(
+            key,
+            mapping={
+                str(idx): dumps(generation) for idx, generation in enumerate(return_val)
+            },
+        )
+        if ttl is not None:
+            pipe.expire(key, ttl)
+
+
+class RedisCache(_RedisCacheBase):
+    """
+    Cache that uses Redis as a backend. Allows to use a sync `redis.Redis` client.
+    """
+
+    def __init__(self, redis_: Any, *, ttl: Optional[int] = None):
+        """
+        Initialize an instance of RedisCache.
+
+        This method initializes an object with Redis caching capabilities.
+        It takes a `redis_` parameter, which should be an instance of a Redis
+        client class (`redis.Redis`), allowing the object
+        to interact with a Redis server for caching purposes.
+
+        Parameters:
+            redis_ (Any): An instance of a Redis client class
+                (`redis.Redis`) to be used for caching.
+                This allows the object to communicate with a
+                Redis server for caching operations.
+            ttl (int, optional): Time-to-live (TTL) for cached items in seconds.
+                If provided, it sets the time duration for how long cached
+                items will remain valid. If not provided, cached items will not
+                have an automatic expiration.
+        """
+        try:
+            from redis import Redis
+        except ImportError:
+            raise ValueError(
+                "Could not import `redis` python package. "
+                "Please install it with `pip install redis`."
+            )
+        if not isinstance(redis_, Redis):
+            raise ValueError("Please pass a valid `redis.Redis` client.")
+        self.redis = redis_
+        self.ttl = ttl
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up based on prompt and llm_string."""
+        # Read from a Redis HASH
+        try:
+            results = self.redis.hgetall(self._key(prompt, llm_string))
+            return self._get_generations(results)  # type: ignore[arg-type]
+        except Exception as e:
+            logger.error(f"Redis lookup failed: {e}")
+            return None
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        """Update cache based on prompt and llm_string."""
+        self._ensure_generation_type(return_val)
+        key = self._key(prompt, llm_string)
+        try:
+            with self.redis.pipeline() as pipe:
+                self._configure_pipeline_for_update(key, pipe, return_val, self.ttl)
+                pipe.execute()
+        except Exception as e:
+            logger.error(f"Redis update failed: {e}")
+
+    def clear(self, **kwargs: Any) -> None:
+        """Clear cache. If `asynchronous` is True, flush asynchronously."""
+        try:
+            asynchronous = kwargs.get("asynchronous", False)
+            self.redis.flushdb(asynchronous=asynchronous, **kwargs)
+        except Exception as e:
+            logger.error(f"Redis clear failed: {e}")
+
+
+class AsyncRedisCache(_RedisCacheBase):
+    """
+    Cache that uses Redis as a backend. Allows to use an
+    async `redis.asyncio.Redis` client.
+    """
+
+    def __init__(self, redis_: Any, *, ttl: Optional[int] = None):
+        """
+        Initialize an instance of AsyncRedisCache.
+
+        This method initializes an object with Redis caching capabilities.
+        It takes a `redis_` parameter, which should be an instance of a Redis
+        client class (`redis.asyncio.Redis`), allowing the object
+        to interact with a Redis server for caching purposes.
+
+        Parameters:
+            redis_ (Any): An instance of a Redis client class
+                (`redis.asyncio.Redis`) to be used for caching.
+                This allows the object to communicate with a
+                Redis server for caching operations.
+            ttl (int, optional): Time-to-live (TTL) for cached items in seconds.
+                If provided, it sets the time duration for how long cached
+                items will remain valid. If not provided, cached items will not
+                have an automatic expiration.
+        """
+        try:
+            from redis.asyncio import Redis
+        except ImportError:
+            raise ValueError(
+                "Could not import `redis.asyncio` python package. "
+                "Please install it with `pip install redis`."
+            )
+        if not isinstance(redis_, Redis):
+            raise ValueError("Please pass a valid `redis.asyncio.Redis` client.")
+        self.redis = redis_
+        self.ttl = ttl
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up based on prompt and llm_string."""
+        raise NotImplementedError(
+            "This async Redis cache does not implement `lookup()` method. "
+            "Consider using the async `alookup()` version."
+        )
+
+    async def alookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up based on prompt and llm_string. Async version."""
+        try:
+            results = await self.redis.hgetall(self._key(prompt, llm_string))
+            return self._get_generations(results)  # type: ignore[arg-type]
+        except Exception as e:
+            logger.error(f"Redis async lookup failed: {e}")
+            return None
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        """Update cache based on prompt and llm_string."""
+        raise NotImplementedError(
+            "This async Redis cache does not implement `update()` method. "
+            "Consider using the async `aupdate()` version."
+        )
+
+    async def aupdate(
+        self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE
+    ) -> None:
+        """Update cache based on prompt and llm_string. Async version."""
+        self._ensure_generation_type(return_val)
+        key = self._key(prompt, llm_string)
+        try:
+            async with self.redis.pipeline() as pipe:
+                self._configure_pipeline_for_update(key, pipe, return_val, self.ttl)
+                await pipe.execute()  # type: ignore[attr-defined]
+        except Exception as e:
+            logger.error(f"Redis async update failed: {e}")
+
+    def clear(self, **kwargs: Any) -> None:
+        """Clear cache. If `asynchronous` is True, flush asynchronously."""
+        raise NotImplementedError(
+            "This async Redis cache does not implement `clear()` method. "
+            "Consider using the async `aclear()` version."
+        )
+
+    async def aclear(self, **kwargs: Any) -> None:
+        """
+        Clear cache. If `asynchronous` is True, flush asynchronously.
+        Async version.
+        """
+        try:
+            asynchronous = kwargs.get("asynchronous", False)
+            await self.redis.flushdb(asynchronous=asynchronous, **kwargs)
+        except Exception as e:
+            logger.error(f"Redis async clear failed: {e}")
+
+
+class RedisSemanticCache(BaseCache):
+    """Cache that uses Redis as a vector-store backend."""
+
+    # TODO - implement a TTL policy in Redis
+
+    DEFAULT_SCHEMA = {
+        "content_key": "prompt",
+        "text": [
+            {"name": "prompt"},
+        ],
+        "extra": [{"name": "return_val"}, {"name": "llm_string"}],
+    }
+
+    def __init__(
+        self, redis_url: str, embedding: Embeddings, score_threshold: float = 0.2
+    ):
+        """Initialize by passing in the `init` GPTCache func
+
+        Args:
+            redis_url (str): URL to connect to Redis.
+            embedding (Embedding): Embedding provider for semantic encoding and search.
+            score_threshold (float, 0.2):
+
+        Example:
+
+        .. code-block:: python
+
+            from langchain_community.globals import set_llm_cache
+
+            from langchain_community.cache import RedisSemanticCache
+            from langchain_community.embeddings import OpenAIEmbeddings
+
+            set_llm_cache(RedisSemanticCache(
+                redis_url="redis://localhost:6379",
+                embedding=OpenAIEmbeddings()
+            ))
+
+        """
+        self._cache_dict: Dict[str, RedisVectorstore] = {}
+        self.redis_url = redis_url
+        self.embedding = embedding
+        self.score_threshold = score_threshold
+
+    def _index_name(self, llm_string: str) -> str:
+        hashed_index = _hash(llm_string)
+        return f"cache:{hashed_index}"
+
+    def _get_llm_cache(self, llm_string: str) -> RedisVectorstore:
+        index_name = self._index_name(llm_string)
+
+        # return vectorstore client for the specific llm string
+        if index_name in self._cache_dict:
+            return self._cache_dict[index_name]
+
+        # create new vectorstore client for the specific llm string
+        try:
+            self._cache_dict[index_name] = RedisVectorstore.from_existing_index(
+                embedding=self.embedding,
+                index_name=index_name,
+                redis_url=self.redis_url,
+                schema=cast(Dict, self.DEFAULT_SCHEMA),
+            )
+        except ValueError:
+            redis = RedisVectorstore(
+                embedding=self.embedding,
+                index_name=index_name,
+                redis_url=self.redis_url,
+                index_schema=cast(Dict, self.DEFAULT_SCHEMA),
+            )
+            _embedding = self.embedding.embed_query(text="test")
+            redis._create_index_if_not_exist(dim=len(_embedding))
+            self._cache_dict[index_name] = redis
+
+        return self._cache_dict[index_name]
+
+    def clear(self, **kwargs: Any) -> None:
+        """Clear semantic cache for a given llm_string."""
+        index_name = self._index_name(kwargs["llm_string"])
+        if index_name in self._cache_dict:
+            self._cache_dict[index_name].drop_index(
+                index_name=index_name, delete_documents=True, redis_url=self.redis_url
+            )
+            del self._cache_dict[index_name]
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up based on prompt and llm_string."""
+        llm_cache = self._get_llm_cache(llm_string)
+        generations: List = []
+        # Read from a Hash
+        results = llm_cache.similarity_search(
+            query=prompt,
+            k=1,
+            distance_threshold=self.score_threshold,
+        )
+        if results:
+            for document in results:
+                try:
+                    generations.extend(loads(document.metadata["return_val"]))
+                except Exception:
+                    logger.warning(
+                        "Retrieving a cache value that could not be deserialized "
+                        "properly. This is likely due to the cache being in an "
+                        "older format. Please recreate your cache to avoid this "
+                        "error."
+                    )
+                    # In a previous life we stored the raw text directly
+                    # in the table, so assume it's in that format.
+                    generations.extend(
+                        _load_generations_from_json(document.metadata["return_val"])
+                    )
+        return generations if generations else None
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        """Update cache based on prompt and llm_string."""
+        for gen in return_val:
+            if not isinstance(gen, Generation):
+                raise ValueError(
+                    "RedisSemanticCache only supports caching of "
+                    f"normal LLM generations, got {type(gen)}"
+                )
+        llm_cache = self._get_llm_cache(llm_string)
+
+        metadata = {
+            "llm_string": llm_string,
+            "prompt": prompt,
+            "return_val": dumps([g for g in return_val]),
+        }
+        llm_cache.add_texts(texts=[prompt], metadatas=[metadata])
+
+
+class GPTCache(BaseCache):
+    """Cache that uses GPTCache as a backend."""
+
+    def __init__(
+        self,
+        init_func: Union[
+            Callable[[Any, str], None], Callable[[Any], None], None
+        ] = None,
+    ):
+        """Initialize by passing in init function (default: `None`).
+
+        Args:
+            init_func (Optional[Callable[[Any], None]]): init `GPTCache` function
+            (default: `None`)
+
+        Example:
+        .. code-block:: python
+
+            # Initialize GPTCache with a custom init function
+            import gptcache
+            from gptcache.processor.pre import get_prompt
+            from gptcache.manager.factory import get_data_manager
+            from langchain_community.globals import set_llm_cache
+
+            # Avoid multiple caches using the same file,
+            causing different llm model caches to affect each other
+
+            def init_gptcache(cache_obj: gptcache.Cache, llm str):
+                cache_obj.init(
+                    pre_embedding_func=get_prompt,
+                    data_manager=manager_factory(
+                        manager="map",
+                        data_dir=f"map_cache_{llm}"
+                    ),
+                )
+
+            set_llm_cache(GPTCache(init_gptcache))
+
+        """
+        try:
+            import gptcache  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "Could not import gptcache python package. "
+                "Please install it with `pip install gptcache`."
+            )
+
+        self.init_gptcache_func: Union[
+            Callable[[Any, str], None], Callable[[Any], None], None
+        ] = init_func
+        self.gptcache_dict: Dict[str, Any] = {}
+
+    def _new_gptcache(self, llm_string: str) -> Any:
+        """New gptcache object"""
+        from gptcache import Cache
+        from gptcache.manager.factory import get_data_manager
+        from gptcache.processor.pre import get_prompt
+
+        _gptcache = Cache()
+        if self.init_gptcache_func is not None:
+            sig = inspect.signature(self.init_gptcache_func)
+            if len(sig.parameters) == 2:
+                self.init_gptcache_func(_gptcache, llm_string)  # type: ignore[call-arg]
+            else:
+                self.init_gptcache_func(_gptcache)  # type: ignore[call-arg]
+        else:
+            _gptcache.init(
+                pre_embedding_func=get_prompt,
+                data_manager=get_data_manager(data_path=llm_string),
+            )
+
+        self.gptcache_dict[llm_string] = _gptcache
+        return _gptcache
+
+    def _get_gptcache(self, llm_string: str) -> Any:
+        """Get a cache object.
+
+        When the corresponding llm model cache does not exist, it will be created."""
+        _gptcache = self.gptcache_dict.get(llm_string, None)
+        if not _gptcache:
+            _gptcache = self._new_gptcache(llm_string)
+        return _gptcache
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up the cache data.
+        First, retrieve the corresponding cache object using the `llm_string` parameter,
+        and then retrieve the data from the cache based on the `prompt`.
+        """
+        from gptcache.adapter.api import get
+
+        _gptcache = self._get_gptcache(llm_string)
+
+        res = get(prompt, cache_obj=_gptcache)
+        return _loads_generations(res) if res is not None else None
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        """Update cache.
+        First, retrieve the corresponding cache object using the `llm_string` parameter,
+        and then store the `prompt` and `return_val` in the cache object.
+        """
+        for gen in return_val:
+            if not isinstance(gen, Generation):
+                raise ValueError(
+                    "GPTCache only supports caching of normal LLM generations, "
+                    f"got {type(gen)}"
+                )
+        from gptcache.adapter.api import put
+
+        _gptcache = self._get_gptcache(llm_string)
+        handled_data = _dumps_generations(return_val)
+        put(prompt, handled_data, cache_obj=_gptcache)
+        return None
+
+    def clear(self, **kwargs: Any) -> None:
+        """Clear cache."""
+        from gptcache import Cache
+
+        for gptcache_instance in self.gptcache_dict.values():
+            gptcache_instance = cast(Cache, gptcache_instance)
+            gptcache_instance.flush()
+
+        self.gptcache_dict.clear()
+
+
+def _ensure_cache_exists(cache_client: momento.CacheClient, cache_name: str) -> None:
+    """Create cache if it doesn't exist.
+
+    Raises:
+        SdkException: Momento service or network error
+        Exception: Unexpected response
+    """
+    from momento.responses import CreateCache
+
+    create_cache_response = cache_client.create_cache(cache_name)
+    if isinstance(create_cache_response, CreateCache.Success) or isinstance(
+        create_cache_response, CreateCache.CacheAlreadyExists
+    ):
+        return None
+    elif isinstance(create_cache_response, CreateCache.Error):
+        raise create_cache_response.inner_exception
+    else:
+        raise Exception(f"Unexpected response cache creation: {create_cache_response}")
+
+
+def _validate_ttl(ttl: Optional[timedelta]) -> None:
+    if ttl is not None and ttl <= timedelta(seconds=0):
+        raise ValueError(f"ttl must be positive but was {ttl}.")
+
+
+class MomentoCache(BaseCache):
+    """Cache that uses Momento as a backend. See https://gomomento.com/"""
+
+    def __init__(
+        self,
+        cache_client: momento.CacheClient,
+        cache_name: str,
+        *,
+        ttl: Optional[timedelta] = None,
+        ensure_cache_exists: bool = True,
+    ):
+        """Instantiate a prompt cache using Momento as a backend.
+
+        Note: to instantiate the cache client passed to MomentoCache,
+        you must have a Momento account. See https://gomomento.com/.
+
+        Args:
+            cache_client (CacheClient): The Momento cache client.
+            cache_name (str): The name of the cache to use to store the data.
+            ttl (Optional[timedelta], optional): The time to live for the cache items.
+                Defaults to None, ie use the client default TTL.
+            ensure_cache_exists (bool, optional): Create the cache if it doesn't
+                exist. Defaults to True.
+
+        Raises:
+            ImportError: Momento python package is not installed.
+            TypeError: cache_client is not of type momento.CacheClientObject
+            ValueError: ttl is non-null and non-negative
+        """
+        try:
+            from momento import CacheClient
+        except ImportError:
+            raise ImportError(
+                "Could not import momento python package. "
+                "Please install it with `pip install momento`."
+            )
+        if not isinstance(cache_client, CacheClient):
+            raise TypeError("cache_client must be a momento.CacheClient object.")
+        _validate_ttl(ttl)
+        if ensure_cache_exists:
+            _ensure_cache_exists(cache_client, cache_name)
+
+        self.cache_client = cache_client
+        self.cache_name = cache_name
+        self.ttl = ttl
+
+    @classmethod
+    def from_client_params(
+        cls,
+        cache_name: str,
+        ttl: timedelta,
+        *,
+        configuration: Optional[momento.config.Configuration] = None,
+        api_key: Optional[str] = None,
+        auth_token: Optional[str] = None,  # for backwards compatibility
+        **kwargs: Any,
+    ) -> MomentoCache:
+        """Construct cache from CacheClient parameters."""
+        try:
+            from momento import CacheClient, Configurations, CredentialProvider
+        except ImportError:
+            raise ImportError(
+                "Could not import momento python package. "
+                "Please install it with `pip install momento`."
+            )
+        if configuration is None:
+            configuration = Configurations.Laptop.v1()
+
+        # Try checking `MOMENTO_AUTH_TOKEN` first for backwards compatibility
+        try:
+            api_key = auth_token or get_from_env("auth_token", "MOMENTO_AUTH_TOKEN")
+        except ValueError:
+            api_key = api_key or get_from_env("api_key", "MOMENTO_API_KEY")
+        credentials = CredentialProvider.from_string(api_key)
+        cache_client = CacheClient(configuration, credentials, default_ttl=ttl)
+        return cls(cache_client, cache_name, ttl=ttl, **kwargs)
+
+    def __key(self, prompt: str, llm_string: str) -> str:
+        """Compute cache key from prompt and associated model and settings.
+
+        Args:
+            prompt (str): The prompt run through the language model.
+            llm_string (str): The language model version and settings.
+
+        Returns:
+            str: The cache key.
+        """
+        return _hash(prompt + llm_string)
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Lookup llm generations in cache by prompt and associated model and settings.
+
+        Args:
+            prompt (str): The prompt run through the language model.
+            llm_string (str): The language model version and settings.
+
+        Raises:
+            SdkException: Momento service or network error
+
+        Returns:
+            Optional[RETURN_VAL_TYPE]: A list of language model generations.
+        """
+        from momento.responses import CacheGet
+
+        generations: RETURN_VAL_TYPE = []
+
+        get_response = self.cache_client.get(
+            self.cache_name, self.__key(prompt, llm_string)
+        )
+        if isinstance(get_response, CacheGet.Hit):
+            value = get_response.value_string
+            generations = _load_generations_from_json(value)
+        elif isinstance(get_response, CacheGet.Miss):
+            pass
+        elif isinstance(get_response, CacheGet.Error):
+            raise get_response.inner_exception
+        return generations if generations else None
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        """Store llm generations in cache.
+
+        Args:
+            prompt (str): The prompt run through the language model.
+            llm_string (str): The language model string.
+            return_val (RETURN_VAL_TYPE): A list of language model generations.
+
+        Raises:
+            SdkException: Momento service or network error
+            Exception: Unexpected response
+        """
+        for gen in return_val:
+            if not isinstance(gen, Generation):
+                raise ValueError(
+                    "Momento only supports caching of normal LLM generations, "
+                    f"got {type(gen)}"
+                )
+        key = self.__key(prompt, llm_string)
+        value = _dump_generations_to_json(return_val)
+        set_response = self.cache_client.set(self.cache_name, key, value, self.ttl)
+        from momento.responses import CacheSet
+
+        if isinstance(set_response, CacheSet.Success):
+            pass
+        elif isinstance(set_response, CacheSet.Error):
+            raise set_response.inner_exception
+        else:
+            raise Exception(f"Unexpected response: {set_response}")
+
+    def clear(self, **kwargs: Any) -> None:
+        """Clear the cache.
+
+        Raises:
+            SdkException: Momento service or network error
+        """
+        from momento.responses import CacheFlush
+
+        flush_response = self.cache_client.flush_cache(self.cache_name)
+        if isinstance(flush_response, CacheFlush.Success):
+            pass
+        elif isinstance(flush_response, CacheFlush.Error):
+            raise flush_response.inner_exception
+
+
+CASSANDRA_CACHE_DEFAULT_TABLE_NAME = "langchain_llm_cache"
+CASSANDRA_CACHE_DEFAULT_TTL_SECONDS = None
+
+
+class CassandraCache(BaseCache):
+    """
+    Cache that uses Cassandra / Astra DB as a backend.
+
+    It uses a single Cassandra table.
+    The lookup keys (which get to form the primary key) are:
+        - prompt, a string
+        - llm_string, a deterministic str representation of the model parameters.
+          (needed to prevent collisions same-prompt-different-model collisions)
+    """
+
+    def __init__(
+        self,
+        session: Optional[CassandraSession] = None,
+        keyspace: Optional[str] = None,
+        table_name: str = CASSANDRA_CACHE_DEFAULT_TABLE_NAME,
+        ttl_seconds: Optional[int] = CASSANDRA_CACHE_DEFAULT_TTL_SECONDS,
+        skip_provisioning: bool = False,
+    ):
+        """
+        Initialize with a ready session and a keyspace name.
+        Args:
+            session (cassandra.cluster.Session): an open Cassandra session
+            keyspace (str): the keyspace to use for storing the cache
+            table_name (str): name of the Cassandra table to use as cache
+            ttl_seconds (optional int): time-to-live for cache entries
+                (default: None, i.e. forever)
+        """
+        try:
+            from cassio.table import ElasticCassandraTable
+        except (ImportError, ModuleNotFoundError):
+            raise ValueError(
+                "Could not import cassio python package. "
+                "Please install it with `pip install cassio`."
+            )
+
+        self.session = session
+        self.keyspace = keyspace
+        self.table_name = table_name
+        self.ttl_seconds = ttl_seconds
+
+        self.kv_cache = ElasticCassandraTable(
+            session=self.session,
+            keyspace=self.keyspace,
+            table=self.table_name,
+            keys=["llm_string", "prompt"],
+            primary_key_type=["TEXT", "TEXT"],
+            ttl_seconds=self.ttl_seconds,
+            skip_provisioning=skip_provisioning,
+        )
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up based on prompt and llm_string."""
+        item = self.kv_cache.get(
+            llm_string=_hash(llm_string),
+            prompt=_hash(prompt),
+        )
+        if item is not None:
+            generations = _loads_generations(item["body_blob"])
+            # this protects against malformed cached items:
+            if generations is not None:
+                return generations
+            else:
+                return None
+        else:
+            return None
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        """Update cache based on prompt and llm_string."""
+        blob = _dumps_generations(return_val)
+        self.kv_cache.put(
+            llm_string=_hash(llm_string),
+            prompt=_hash(prompt),
+            body_blob=blob,
+        )
+
+    def delete_through_llm(
+        self, prompt: str, llm: LLM, stop: Optional[List[str]] = None
+    ) -> None:
+        """
+        A wrapper around `delete` with the LLM being passed.
+        In case the llm(prompt) calls have a `stop` param, you should pass it here
+        """
+        llm_string = get_prompts(
+            {**llm.dict(), **{"stop": stop}},
+            [],
+        )[1]
+        return self.delete(prompt, llm_string=llm_string)
+
+    def delete(self, prompt: str, llm_string: str) -> None:
+        """Evict from cache if there's an entry."""
+        return self.kv_cache.delete(
+            llm_string=_hash(llm_string),
+            prompt=_hash(prompt),
+        )
+
+    def clear(self, **kwargs: Any) -> None:
+        """Clear cache. This is for all LLMs at once."""
+        self.kv_cache.clear()
+
+
+CASSANDRA_SEMANTIC_CACHE_DEFAULT_DISTANCE_METRIC = "dot"
+CASSANDRA_SEMANTIC_CACHE_DEFAULT_SCORE_THRESHOLD = 0.85
+CASSANDRA_SEMANTIC_CACHE_DEFAULT_TABLE_NAME = "langchain_llm_semantic_cache"
+CASSANDRA_SEMANTIC_CACHE_DEFAULT_TTL_SECONDS = None
+CASSANDRA_SEMANTIC_CACHE_EMBEDDING_CACHE_SIZE = 16
+
+
+class CassandraSemanticCache(BaseCache):
+    """
+    Cache that uses Cassandra as a vector-store backend for semantic
+    (i.e. similarity-based) lookup.
+
+    It uses a single (vector) Cassandra table and stores, in principle,
+    cached values from several LLMs, so the LLM's llm_string is part
+    of the rows' primary keys.
+
+    The similarity is based on one of several distance metrics (default: "dot").
+    If choosing another metric, the default threshold is to be re-tuned accordingly.
+    """
+
+    def __init__(
+        self,
+        session: Optional[CassandraSession],
+        keyspace: Optional[str],
+        embedding: Embeddings,
+        table_name: str = CASSANDRA_SEMANTIC_CACHE_DEFAULT_TABLE_NAME,
+        distance_metric: str = CASSANDRA_SEMANTIC_CACHE_DEFAULT_DISTANCE_METRIC,
+        score_threshold: float = CASSANDRA_SEMANTIC_CACHE_DEFAULT_SCORE_THRESHOLD,
+        ttl_seconds: Optional[int] = CASSANDRA_SEMANTIC_CACHE_DEFAULT_TTL_SECONDS,
+        skip_provisioning: bool = False,
+    ):
+        """
+        Initialize the cache with all relevant parameters.
+        Args:
+            session (cassandra.cluster.Session): an open Cassandra session
+            keyspace (str): the keyspace to use for storing the cache
+            embedding (Embedding): Embedding provider for semantic
+                encoding and search.
+            table_name (str): name of the Cassandra (vector) table
+                to use as cache
+            distance_metric (str, 'dot'): which measure to adopt for
+                similarity searches
+            score_threshold (optional float): numeric value to use as
+                cutoff for the similarity searches
+            ttl_seconds (optional int): time-to-live for cache entries
+                (default: None, i.e. forever)
+        The default score threshold is tuned to the default metric.
+        Tune it carefully yourself if switching to another distance metric.
+        """
+        try:
+            from cassio.table import MetadataVectorCassandraTable
+        except (ImportError, ModuleNotFoundError):
+            raise ValueError(
+                "Could not import cassio python package. "
+                "Please install it with `pip install cassio`."
+            )
+        self.session = session
+        self.keyspace = keyspace
+        self.embedding = embedding
+        self.table_name = table_name
+        self.distance_metric = distance_metric
+        self.score_threshold = score_threshold
+        self.ttl_seconds = ttl_seconds
+
+        # The contract for this class has separate lookup and update:
+        # in order to spare some embedding calculations we cache them between
+        # the two calls.
+        # Note: each instance of this class has its own `_get_embedding` with
+        # its own lru.
+        @lru_cache(maxsize=CASSANDRA_SEMANTIC_CACHE_EMBEDDING_CACHE_SIZE)
+        def _cache_embedding(text: str) -> List[float]:
+            return self.embedding.embed_query(text=text)
+
+        self._get_embedding = _cache_embedding
+        self.embedding_dimension = self._get_embedding_dimension()
+
+        self.table = MetadataVectorCassandraTable(
+            session=self.session,
+            keyspace=self.keyspace,
+            table=self.table_name,
+            primary_key_type=["TEXT"],
+            vector_dimension=self.embedding_dimension,
+            ttl_seconds=self.ttl_seconds,
+            metadata_indexing=("allow", {"_llm_string_hash"}),
+            skip_provisioning=skip_provisioning,
+        )
+
+    def _get_embedding_dimension(self) -> int:
+        return len(self._get_embedding(text="This is a sample sentence."))
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        """Update cache based on prompt and llm_string."""
+        embedding_vector = self._get_embedding(text=prompt)
+        llm_string_hash = _hash(llm_string)
+        body = _dumps_generations(return_val)
+        metadata = {
+            "_prompt": prompt,
+            "_llm_string_hash": llm_string_hash,
+        }
+        row_id = f"{_hash(prompt)}-{llm_string_hash}"
+        #
+        self.table.put(
+            body_blob=body,
+            vector=embedding_vector,
+            row_id=row_id,
+            metadata=metadata,
+        )
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up based on prompt and llm_string."""
+        hit_with_id = self.lookup_with_id(prompt, llm_string)
+        if hit_with_id is not None:
+            return hit_with_id[1]
+        else:
+            return None
+
+    def lookup_with_id(
+        self, prompt: str, llm_string: str
+    ) -> Optional[Tuple[str, RETURN_VAL_TYPE]]:
+        """
+        Look up based on prompt and llm_string.
+        If there are hits, return (document_id, cached_entry)
+        """
+        prompt_embedding: List[float] = self._get_embedding(text=prompt)
+        hits = list(
+            self.table.metric_ann_search(
+                vector=prompt_embedding,
+                metadata={"_llm_string_hash": _hash(llm_string)},
+                n=1,
+                metric=self.distance_metric,
+                metric_threshold=self.score_threshold,
+            )
+        )
+        if hits:
+            hit = hits[0]
+            generations = _loads_generations(hit["body_blob"])
+            if generations is not None:
+                # this protects against malformed cached items:
+                return (
+                    hit["row_id"],
+                    generations,
+                )
+            else:
+                return None
+        else:
+            return None
+
+    def lookup_with_id_through_llm(
+        self, prompt: str, llm: LLM, stop: Optional[List[str]] = None
+    ) -> Optional[Tuple[str, RETURN_VAL_TYPE]]:
+        llm_string = get_prompts(
+            {**llm.dict(), **{"stop": stop}},
+            [],
+        )[1]
+        return self.lookup_with_id(prompt, llm_string=llm_string)
+
+    def delete_by_document_id(self, document_id: str) -> None:
+        """
+        Given this is a "similarity search" cache, an invalidation pattern
+        that makes sense is first a lookup to get an ID, and then deleting
+        with that ID. This is for the second step.
+        """
+        self.table.delete(row_id=document_id)
+
+    def clear(self, **kwargs: Any) -> None:
+        """Clear the *whole* semantic cache."""
+        self.table.clear()
+
+
+class FullMd5LLMCache(Base):  # type: ignore
+    """SQLite table for full LLM Cache (all generations)."""
+
+    __tablename__ = "full_md5_llm_cache"
+    id = Column(String, primary_key=True)
+    prompt_md5 = Column(String, index=True)
+    llm = Column(String, index=True)
+    idx = Column(Integer, index=True)
+    prompt = Column(String)
+    response = Column(String)
+
+
+class SQLAlchemyMd5Cache(BaseCache):
+    """Cache that uses SQAlchemy as a backend."""
+
+    def __init__(
+        self, engine: Engine, cache_schema: Type[FullMd5LLMCache] = FullMd5LLMCache
+    ):
+        """Initialize by creating all tables."""
+        self.engine = engine
+        self.cache_schema = cache_schema
+        self.cache_schema.metadata.create_all(self.engine)
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up based on prompt and llm_string."""
+        rows = self._search_rows(prompt, llm_string)
+        if rows:
+            return [loads(row[0]) for row in rows]
+        return None
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        """Update based on prompt and llm_string."""
+        with Session(self.engine) as session, session.begin():
+            self._delete_previous(session, prompt, llm_string)
+            prompt_md5 = self.get_md5(prompt)
+            items = [
+                self.cache_schema(
+                    id=str(uuid.uuid1()),
+                    prompt=prompt,
+                    prompt_md5=prompt_md5,
+                    llm=llm_string,
+                    response=dumps(gen),
+                    idx=i,
+                )
+                for i, gen in enumerate(return_val)
+            ]
+            for item in items:
+                session.merge(item)
+
+    def _delete_previous(self, session: Session, prompt: str, llm_string: str) -> None:
+        stmt = (
+            delete(self.cache_schema)
+            .where(self.cache_schema.prompt_md5 == self.get_md5(prompt))  # type: ignore
+            .where(self.cache_schema.llm == llm_string)
+            .where(self.cache_schema.prompt == prompt)
+        )
+        session.execute(stmt)
+
+    def _search_rows(self, prompt: str, llm_string: str) -> Sequence[Row]:
+        prompt_pd5 = self.get_md5(prompt)
+        stmt = (
+            select(self.cache_schema.response)
+            .where(self.cache_schema.prompt_md5 == prompt_pd5)  # type: ignore
+            .where(self.cache_schema.llm == llm_string)
+            .where(self.cache_schema.prompt == prompt)
+            .order_by(self.cache_schema.idx)
+        )
+        with Session(self.engine) as session:
+            return session.execute(stmt).fetchall()
+
+    def clear(self, **kwargs: Any) -> None:
+        """Clear cache."""
+        with Session(self.engine) as session:
+            session.execute(self.cache_schema.delete())
+
+    @staticmethod
+    def get_md5(input_string: str) -> str:
+        return hashlib.md5(input_string.encode()).hexdigest()
+
+
+ASTRA_DB_CACHE_DEFAULT_COLLECTION_NAME = "langchain_astradb_cache"
+
+
+@deprecated(
+    since="0.0.28",
+    removal="0.2.0",
+    alternative_import="langchain_astradb.AstraDBCache",
+)
+class AstraDBCache(BaseCache):
+    @staticmethod
+    def _make_id(prompt: str, llm_string: str) -> str:
+        return f"{_hash(prompt)}#{_hash(llm_string)}"
+
+    def __init__(
+        self,
+        *,
+        collection_name: str = ASTRA_DB_CACHE_DEFAULT_COLLECTION_NAME,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        astra_db_client: Optional[AstraDB] = None,
+        async_astra_db_client: Optional[AsyncAstraDB] = None,
+        namespace: Optional[str] = None,
+        pre_delete_collection: bool = False,
+        setup_mode: SetupMode = SetupMode.SYNC,
+    ):
+        """
+        Cache that uses Astra DB as a backend.
+
+        It uses a single collection as a kv store
+        The lookup keys, combined in the _id of the documents, are:
+            - prompt, a string
+            - llm_string, a deterministic str representation of the model parameters.
+              (needed to prevent same-prompt-different-model collisions)
+
+        Args:
+            collection_name: name of the Astra DB collection to create/use.
+            token: API token for Astra DB usage.
+            api_endpoint: full URL to the API endpoint,
+                such as `https://<DB-ID>-us-east1.apps.astra.datastax.com`.
+            astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AstraDB' instance.
+            async_astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AsyncAstraDB' instance.
+            namespace: namespace (aka keyspace) where the
+                collection is created. Defaults to the database's "default namespace".
+            setup_mode: mode used to create the Astra DB collection (SYNC, ASYNC or
+                OFF).
+            pre_delete_collection: whether to delete the collection
+                before creating it. If False and the collection already exists,
+                the collection will be used as is.
+        """
+        self.astra_env = _AstraDBCollectionEnvironment(
+            collection_name=collection_name,
+            token=token,
+            api_endpoint=api_endpoint,
+            astra_db_client=astra_db_client,
+            async_astra_db_client=async_astra_db_client,
+            namespace=namespace,
+            setup_mode=setup_mode,
+            pre_delete_collection=pre_delete_collection,
+        )
+        self.collection = self.astra_env.collection
+        self.async_collection = self.astra_env.async_collection
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        self.astra_env.ensure_db_setup()
+        doc_id = self._make_id(prompt, llm_string)
+        item = self.collection.find_one(
+            filter={
+                "_id": doc_id,
+            },
+            projection={
+                "body_blob": 1,
+            },
+        )["data"]["document"]
+        return _loads_generations(item["body_blob"]) if item is not None else None
+
+    async def alookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        await self.astra_env.aensure_db_setup()
+        doc_id = self._make_id(prompt, llm_string)
+        item = (
+            await self.async_collection.find_one(
+                filter={
+                    "_id": doc_id,
+                },
+                projection={
+                    "body_blob": 1,
+                },
+            )
+        )["data"]["document"]
+        return _loads_generations(item["body_blob"]) if item is not None else None
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        self.astra_env.ensure_db_setup()
+        doc_id = self._make_id(prompt, llm_string)
+        blob = _dumps_generations(return_val)
+        self.collection.upsert(
+            {
+                "_id": doc_id,
+                "body_blob": blob,
+            },
+        )
+
+    async def aupdate(
+        self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE
+    ) -> None:
+        await self.astra_env.aensure_db_setup()
+        doc_id = self._make_id(prompt, llm_string)
+        blob = _dumps_generations(return_val)
+        await self.async_collection.upsert(
+            {
+                "_id": doc_id,
+                "body_blob": blob,
+            },
+        )
+
+    def delete_through_llm(
+        self, prompt: str, llm: LLM, stop: Optional[List[str]] = None
+    ) -> None:
+        """
+        A wrapper around `delete` with the LLM being passed.
+        In case the llm(prompt) calls have a `stop` param, you should pass it here
+        """
+        llm_string = get_prompts(
+            {**llm.dict(), **{"stop": stop}},
+            [],
+        )[1]
+        return self.delete(prompt, llm_string=llm_string)
+
+    async def adelete_through_llm(
+        self, prompt: str, llm: LLM, stop: Optional[List[str]] = None
+    ) -> None:
+        """
+        A wrapper around `adelete` with the LLM being passed.
+        In case the llm(prompt) calls have a `stop` param, you should pass it here
+        """
+        llm_string = (
+            await aget_prompts(
+                {**llm.dict(), **{"stop": stop}},
+                [],
+            )
+        )[1]
+        return await self.adelete(prompt, llm_string=llm_string)
+
+    def delete(self, prompt: str, llm_string: str) -> None:
+        """Evict from cache if there's an entry."""
+        self.astra_env.ensure_db_setup()
+        doc_id = self._make_id(prompt, llm_string)
+        self.collection.delete_one(doc_id)
+
+    async def adelete(self, prompt: str, llm_string: str) -> None:
+        """Evict from cache if there's an entry."""
+        await self.astra_env.aensure_db_setup()
+        doc_id = self._make_id(prompt, llm_string)
+        await self.async_collection.delete_one(doc_id)
+
+    def clear(self, **kwargs: Any) -> None:
+        self.astra_env.ensure_db_setup()
+        self.collection.clear()
+
+    async def aclear(self, **kwargs: Any) -> None:
+        await self.astra_env.aensure_db_setup()
+        await self.async_collection.clear()
+
+
+ASTRA_DB_SEMANTIC_CACHE_DEFAULT_THRESHOLD = 0.85
+ASTRA_DB_CACHE_DEFAULT_COLLECTION_NAME = "langchain_astradb_semantic_cache"
+ASTRA_DB_SEMANTIC_CACHE_EMBEDDING_CACHE_SIZE = 16
+
+
+_unset = ["unset"]
+
+
+class _CachedAwaitable:
+    """Caches the result of an awaitable so it can be awaited multiple times"""
+
+    def __init__(self, awaitable: Awaitable[Any]):
+        self.awaitable = awaitable
+        self.result = _unset
+
+    def __await__(self) -> Generator:
+        if self.result is _unset:
+            self.result = yield from self.awaitable.__await__()
+        return self.result
+
+
+def _reawaitable(func: Callable) -> Callable:
+    """Makes an async function result awaitable multiple times"""
+
+    @wraps(func)
+    def wrapper(*args: Any, **kwargs: Any) -> _CachedAwaitable:
+        return _CachedAwaitable(func(*args, **kwargs))
+
+    return wrapper
+
+
+def _async_lru_cache(maxsize: int = 128, typed: bool = False) -> Callable:
+    """Least-recently-used async cache decorator.
+    Equivalent to functools.lru_cache for async functions"""
+
+    def decorating_function(user_function: Callable) -> Callable:
+        return lru_cache(maxsize, typed)(_reawaitable(user_function))
+
+    return decorating_function
+
+
+@deprecated(
+    since="0.0.28",
+    removal="0.2.0",
+    alternative_import="langchain_astradb.AstraDBSemanticCache",
+)
+class AstraDBSemanticCache(BaseCache):
+    def __init__(
+        self,
+        *,
+        collection_name: str = ASTRA_DB_CACHE_DEFAULT_COLLECTION_NAME,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        astra_db_client: Optional[AstraDB] = None,
+        async_astra_db_client: Optional[AsyncAstraDB] = None,
+        namespace: Optional[str] = None,
+        setup_mode: SetupMode = SetupMode.SYNC,
+        pre_delete_collection: bool = False,
+        embedding: Embeddings,
+        metric: Optional[str] = None,
+        similarity_threshold: float = ASTRA_DB_SEMANTIC_CACHE_DEFAULT_THRESHOLD,
+    ):
+        """
+        Cache that uses Astra DB as a vector-store backend for semantic
+        (i.e. similarity-based) lookup.
+
+        It uses a single (vector) collection and can store
+        cached values from several LLMs, so the LLM's 'llm_string' is stored
+        in the document metadata.
+
+        You can choose the preferred similarity (or use the API default).
+        The default score threshold is tuned to the default metric.
+        Tune it carefully yourself if switching to another distance metric.
+
+        Args:
+            collection_name: name of the Astra DB collection to create/use.
+            token: API token for Astra DB usage.
+            api_endpoint: full URL to the API endpoint,
+                such as `https://<DB-ID>-us-east1.apps.astra.datastax.com`.
+            astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AstraDB' instance.
+            async_astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AsyncAstraDB' instance.
+            namespace: namespace (aka keyspace) where the
+                collection is created. Defaults to the database's "default namespace".
+            setup_mode: mode used to create the Astra DB collection (SYNC, ASYNC or
+                OFF).
+            pre_delete_collection: whether to delete the collection
+                before creating it. If False and the collection already exists,
+                the collection will be used as is.
+            embedding: Embedding provider for semantic encoding and search.
+            metric: the function to use for evaluating similarity of text embeddings.
+                Defaults to 'cosine' (alternatives: 'euclidean', 'dot_product')
+            similarity_threshold: the minimum similarity for accepting a
+                (semantic-search) match.
+        """
+        self.embedding = embedding
+        self.metric = metric
+        self.similarity_threshold = similarity_threshold
+        self.collection_name = collection_name
+
+        # The contract for this class has separate lookup and update:
+        # in order to spare some embedding calculations we cache them between
+        # the two calls.
+        # Note: each instance of this class has its own `_get_embedding` with
+        # its own lru.
+        @lru_cache(maxsize=ASTRA_DB_SEMANTIC_CACHE_EMBEDDING_CACHE_SIZE)
+        def _cache_embedding(text: str) -> List[float]:
+            return self.embedding.embed_query(text=text)
+
+        self._get_embedding = _cache_embedding
+
+        @_async_lru_cache(maxsize=ASTRA_DB_SEMANTIC_CACHE_EMBEDDING_CACHE_SIZE)
+        async def _acache_embedding(text: str) -> List[float]:
+            return await self.embedding.aembed_query(text=text)
+
+        self._aget_embedding = _acache_embedding
+
+        embedding_dimension: Union[int, Awaitable[int], None] = None
+        if setup_mode == SetupMode.ASYNC:
+            embedding_dimension = self._aget_embedding_dimension()
+        elif setup_mode == SetupMode.SYNC:
+            embedding_dimension = self._get_embedding_dimension()
+
+        self.astra_env = _AstraDBCollectionEnvironment(
+            collection_name=collection_name,
+            token=token,
+            api_endpoint=api_endpoint,
+            astra_db_client=astra_db_client,
+            async_astra_db_client=async_astra_db_client,
+            namespace=namespace,
+            setup_mode=setup_mode,
+            pre_delete_collection=pre_delete_collection,
+            embedding_dimension=embedding_dimension,
+            metric=metric,
+        )
+        self.collection = self.astra_env.collection
+        self.async_collection = self.astra_env.async_collection
+
+    def _get_embedding_dimension(self) -> int:
+        return len(self._get_embedding(text="This is a sample sentence."))
+
+    async def _aget_embedding_dimension(self) -> int:
+        return len(await self._aget_embedding(text="This is a sample sentence."))
+
+    @staticmethod
+    def _make_id(prompt: str, llm_string: str) -> str:
+        return f"{_hash(prompt)}#{_hash(llm_string)}"
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        self.astra_env.ensure_db_setup()
+        doc_id = self._make_id(prompt, llm_string)
+        llm_string_hash = _hash(llm_string)
+        embedding_vector = self._get_embedding(text=prompt)
+        body = _dumps_generations(return_val)
+        #
+        self.collection.upsert(
+            {
+                "_id": doc_id,
+                "body_blob": body,
+                "llm_string_hash": llm_string_hash,
+                "$vector": embedding_vector,
+            }
+        )
+
+    async def aupdate(
+        self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE
+    ) -> None:
+        await self.astra_env.aensure_db_setup()
+        doc_id = self._make_id(prompt, llm_string)
+        llm_string_hash = _hash(llm_string)
+        embedding_vector = await self._aget_embedding(text=prompt)
+        body = _dumps_generations(return_val)
+        #
+        await self.async_collection.upsert(
+            {
+                "_id": doc_id,
+                "body_blob": body,
+                "llm_string_hash": llm_string_hash,
+                "$vector": embedding_vector,
+            }
+        )
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        hit_with_id = self.lookup_with_id(prompt, llm_string)
+        if hit_with_id is not None:
+            return hit_with_id[1]
+        else:
+            return None
+
+    async def alookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        hit_with_id = await self.alookup_with_id(prompt, llm_string)
+        if hit_with_id is not None:
+            return hit_with_id[1]
+        else:
+            return None
+
+    def lookup_with_id(
+        self, prompt: str, llm_string: str
+    ) -> Optional[Tuple[str, RETURN_VAL_TYPE]]:
+        """
+        Look up based on prompt and llm_string.
+        If there are hits, return (document_id, cached_entry) for the top hit
+        """
+        self.astra_env.ensure_db_setup()
+        prompt_embedding: List[float] = self._get_embedding(text=prompt)
+        llm_string_hash = _hash(llm_string)
+
+        hit = self.collection.vector_find_one(
+            vector=prompt_embedding,
+            filter={
+                "llm_string_hash": llm_string_hash,
+            },
+            fields=["body_blob", "_id"],
+            include_similarity=True,
+        )
+
+        if hit is None or hit["$similarity"] < self.similarity_threshold:
+            return None
+        else:
+            generations = _loads_generations(hit["body_blob"])
+            if generations is not None:
+                # this protects against malformed cached items:
+                return hit["_id"], generations
+            else:
+                return None
+
+    async def alookup_with_id(
+        self, prompt: str, llm_string: str
+    ) -> Optional[Tuple[str, RETURN_VAL_TYPE]]:
+        """
+        Look up based on prompt and llm_string.
+        If there are hits, return (document_id, cached_entry) for the top hit
+        """
+        await self.astra_env.aensure_db_setup()
+        prompt_embedding: List[float] = await self._aget_embedding(text=prompt)
+        llm_string_hash = _hash(llm_string)
+
+        hit = await self.async_collection.vector_find_one(
+            vector=prompt_embedding,
+            filter={
+                "llm_string_hash": llm_string_hash,
+            },
+            fields=["body_blob", "_id"],
+            include_similarity=True,
+        )
+
+        if hit is None or hit["$similarity"] < self.similarity_threshold:
+            return None
+        else:
+            generations = _loads_generations(hit["body_blob"])
+            if generations is not None:
+                # this protects against malformed cached items:
+                return hit["_id"], generations
+            else:
+                return None
+
+    def lookup_with_id_through_llm(
+        self, prompt: str, llm: LLM, stop: Optional[List[str]] = None
+    ) -> Optional[Tuple[str, RETURN_VAL_TYPE]]:
+        llm_string = get_prompts(
+            {**llm.dict(), **{"stop": stop}},
+            [],
+        )[1]
+        return self.lookup_with_id(prompt, llm_string=llm_string)
+
+    async def alookup_with_id_through_llm(
+        self, prompt: str, llm: LLM, stop: Optional[List[str]] = None
+    ) -> Optional[Tuple[str, RETURN_VAL_TYPE]]:
+        llm_string = (
+            await aget_prompts(
+                {**llm.dict(), **{"stop": stop}},
+                [],
+            )
+        )[1]
+        return await self.alookup_with_id(prompt, llm_string=llm_string)
+
+    def delete_by_document_id(self, document_id: str) -> None:
+        """
+        Given this is a "similarity search" cache, an invalidation pattern
+        that makes sense is first a lookup to get an ID, and then deleting
+        with that ID. This is for the second step.
+        """
+        self.astra_env.ensure_db_setup()
+        self.collection.delete_one(document_id)
+
+    async def adelete_by_document_id(self, document_id: str) -> None:
+        """
+        Given this is a "similarity search" cache, an invalidation pattern
+        that makes sense is first a lookup to get an ID, and then deleting
+        with that ID. This is for the second step.
+        """
+        await self.astra_env.aensure_db_setup()
+        await self.async_collection.delete_one(document_id)
+
+    def clear(self, **kwargs: Any) -> None:
+        self.astra_env.ensure_db_setup()
+        self.collection.clear()
+
+    async def aclear(self, **kwargs: Any) -> None:
+        await self.astra_env.aensure_db_setup()
+        await self.async_collection.clear()
+
+
+class AzureCosmosDBSemanticCache(BaseCache):
+    """Cache that uses Cosmos DB Mongo vCore vector-store backend"""
+
+    DEFAULT_DATABASE_NAME = "CosmosMongoVCoreCacheDB"
+    DEFAULT_COLLECTION_NAME = "CosmosMongoVCoreCacheColl"
+
+    def __init__(
+        self,
+        cosmosdb_connection_string: str,
+        database_name: str,
+        collection_name: str,
+        embedding: Embeddings,
+        *,
+        cosmosdb_client: Optional[Any] = None,
+        num_lists: int = 100,
+        similarity: CosmosDBSimilarityType = CosmosDBSimilarityType.COS,
+        kind: CosmosDBVectorSearchType = CosmosDBVectorSearchType.VECTOR_IVF,
+        dimensions: int = 1536,
+        m: int = 16,
+        ef_construction: int = 64,
+        ef_search: int = 40,
+        score_threshold: Optional[float] = None,
+        application_name: str = "LANGCHAIN_CACHING_PYTHON",
+    ):
+        """
+        Args:
+            cosmosdb_connection_string: Cosmos DB Mongo vCore connection string
+            cosmosdb_client: Cosmos DB Mongo vCore client
+            embedding (Embedding): Embedding provider for semantic encoding and search.
+            database_name: Database name for the CosmosDBMongoVCoreSemanticCache
+            collection_name: Collection name for the CosmosDBMongoVCoreSemanticCache
+            num_lists: This integer is the number of clusters that the
+                inverted file (IVF) index uses to group the vector data.
+                We recommend that numLists is set to documentCount/1000
+                for up to 1 million documents and to sqrt(documentCount)
+                for more than 1 million documents.
+                Using a numLists value of 1 is akin to performing
+                brute-force search, which has limited performance
+            dimensions: Number of dimensions for vector similarity.
+                The maximum number of supported dimensions is 2000
+            similarity: Similarity metric to use with the IVF index.
+
+                Possible options are:
+                    - CosmosDBSimilarityType.COS (cosine distance),
+                    - CosmosDBSimilarityType.L2 (Euclidean distance), and
+                    - CosmosDBSimilarityType.IP (inner product).
+            kind: Type of vector index to create.
+                Possible options are:
+                    - vector-ivf
+                    - vector-hnsw: available as a preview feature only,
+                                   to enable visit https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/preview-features
+            m: The max number of connections per layer (16 by default, minimum
+               value is 2, maximum value is 100). Higher m is suitable for datasets
+               with high dimensionality and/or high accuracy requirements.
+            ef_construction: the size of the dynamic candidate list for constructing
+                            the graph (64 by default, minimum value is 4, maximum
+                            value is 1000). Higher ef_construction will result in
+                            better index quality and higher accuracy, but it will
+                            also increase the time required to build the index.
+                            ef_construction has to be at least 2 * m
+            ef_search: The size of the dynamic candidate list for search
+                       (40 by default). A higher value provides better
+                       recall at the cost of speed.
+            score_threshold: Maximum score used to filter the vector search documents.
+            application_name: Application name for the client for tracking and logging
+        """
+
+        self._validate_enum_value(similarity, CosmosDBSimilarityType)
+        self._validate_enum_value(kind, CosmosDBVectorSearchType)
+
+        if not cosmosdb_connection_string:
+            raise ValueError(" CosmosDB connection string can be empty.")
+
+        self.cosmosdb_connection_string = cosmosdb_connection_string
+        self.cosmosdb_client = cosmosdb_client
+        self.embedding = embedding
+        self.database_name = database_name or self.DEFAULT_DATABASE_NAME
+        self.collection_name = collection_name or self.DEFAULT_COLLECTION_NAME
+        self.num_lists = num_lists
+        self.dimensions = dimensions
+        self.similarity = similarity
+        self.kind = kind
+        self.m = m
+        self.ef_construction = ef_construction
+        self.ef_search = ef_search
+        self.score_threshold = score_threshold
+        self._cache_dict: Dict[str, AzureCosmosDBVectorSearch] = {}
+        self.application_name = application_name
+
+    def _index_name(self, llm_string: str) -> str:
+        hashed_index = _hash(llm_string)
+        return f"cache:{hashed_index}"
+
+    def _get_llm_cache(self, llm_string: str) -> AzureCosmosDBVectorSearch:
+        index_name = self._index_name(llm_string)
+
+        namespace = self.database_name + "." + self.collection_name
+
+        # return vectorstore client for the specific llm string
+        if index_name in self._cache_dict:
+            return self._cache_dict[index_name]
+
+        # create new vectorstore client for the specific llm string
+        if self.cosmosdb_client:
+            collection = self.cosmosdb_client[self.database_name][self.collection_name]
+            self._cache_dict[index_name] = AzureCosmosDBVectorSearch(
+                collection=collection,
+                embedding=self.embedding,
+                index_name=index_name,
+            )
+        else:
+            self._cache_dict[
+                index_name
+            ] = AzureCosmosDBVectorSearch.from_connection_string(
+                connection_string=self.cosmosdb_connection_string,
+                namespace=namespace,
+                embedding=self.embedding,
+                index_name=index_name,
+                application_name=self.application_name,
+            )
+
+        # create index for the vectorstore
+        vectorstore = self._cache_dict[index_name]
+        if not vectorstore.index_exists():
+            vectorstore.create_index(
+                self.num_lists,
+                self.dimensions,
+                self.similarity,
+                self.kind,
+                self.m,
+                self.ef_construction,
+            )
+
+        return vectorstore
+
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up based on prompt and llm_string."""
+        llm_cache = self._get_llm_cache(llm_string)
+        generations: List = []
+        # Read from a Hash
+        results = llm_cache.similarity_search(
+            query=prompt,
+            k=1,
+            kind=self.kind,
+            ef_search=self.ef_search,
+            score_threshold=self.score_threshold,  # type: ignore[arg-type]
+        )
+        if results:
+            for document in results:
+                try:
+                    generations.extend(loads(document.metadata["return_val"]))
+                except Exception:
+                    logger.warning(
+                        "Retrieving a cache value that could not be deserialized "
+                        "properly. This is likely due to the cache being in an "
+                        "older format. Please recreate your cache to avoid this "
+                        "error."
+                    )
+                    # In a previous life we stored the raw text directly
+                    # in the table, so assume it's in that format.
+                    generations.extend(
+                        _load_generations_from_json(document.metadata["return_val"])
+                    )
+        return generations if generations else None
+
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        """Update cache based on prompt and llm_string."""
+        for gen in return_val:
+            if not isinstance(gen, Generation):
+                raise ValueError(
+                    "CosmosDBMongoVCoreSemanticCache only supports caching of "
+                    f"normal LLM generations, got {type(gen)}"
+                )
+
+        llm_cache = self._get_llm_cache(llm_string)
+        metadata = {
+            "llm_string": llm_string,
+            "prompt": prompt,
+            "return_val": dumps([g for g in return_val]),
+        }
+        llm_cache.add_texts(texts=[prompt], metadatas=[metadata])
+
+    def clear(self, **kwargs: Any) -> None:
+        """Clear semantic cache for a given llm_string."""
+        index_name = self._index_name(kwargs["llm_string"])
+        if index_name in self._cache_dict:
+            self._cache_dict[index_name].get_collection().delete_many({})
+            # self._cache_dict[index_name].clear_collection()
+
+    @staticmethod
+    def _validate_enum_value(value: Any, enum_type: Type[Enum]) -> None:
+        if not isinstance(value, enum_type):
+            raise ValueError(f"Invalid enum value: {value}. Expected {enum_type}.")
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__init__.py b/llm/Lib/site-packages/langchain_community/callbacks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6400598368468b0c300ca3e9d3a04a08e36be6da
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/__init__.py
@@ -0,0 +1,148 @@
+"""**Callback handlers** allow listening to events in LangChain.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseCallbackHandler --> <name>CallbackHandler  # Example: AimCallbackHandler
+"""
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.callbacks.aim_callback import (
+        AimCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.argilla_callback import (
+        ArgillaCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.arize_callback import (
+        ArizeCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.arthur_callback import (
+        ArthurCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.clearml_callback import (
+        ClearMLCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.comet_ml_callback import (
+        CometCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.context_callback import (
+        ContextCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.fiddler_callback import (
+        FiddlerCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.flyte_callback import (
+        FlyteCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.human import (
+        HumanApprovalCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.infino_callback import (
+        InfinoCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.labelstudio_callback import (
+        LabelStudioCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.llmonitor_callback import (
+        LLMonitorCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.manager import (  # noqa: F401
+        get_openai_callback,
+        wandb_tracing_enabled,
+    )
+    from langchain_community.callbacks.mlflow_callback import (
+        MlflowCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.openai_info import (
+        OpenAICallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.promptlayer_callback import (
+        PromptLayerCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.sagemaker_callback import (
+        SageMakerCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.streamlit import (  # noqa: F401
+        LLMThoughtLabeler,
+        StreamlitCallbackHandler,
+    )
+    from langchain_community.callbacks.trubrics_callback import (
+        TrubricsCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.uptrain_callback import (
+        UpTrainCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.wandb_callback import (
+        WandbCallbackHandler,  # noqa: F401
+    )
+    from langchain_community.callbacks.whylabs_callback import (
+        WhyLabsCallbackHandler,  # noqa: F401
+    )
+
+
+_module_lookup = {
+    "AimCallbackHandler": "langchain_community.callbacks.aim_callback",
+    "ArgillaCallbackHandler": "langchain_community.callbacks.argilla_callback",
+    "ArizeCallbackHandler": "langchain_community.callbacks.arize_callback",
+    "ArthurCallbackHandler": "langchain_community.callbacks.arthur_callback",
+    "ClearMLCallbackHandler": "langchain_community.callbacks.clearml_callback",
+    "CometCallbackHandler": "langchain_community.callbacks.comet_ml_callback",
+    "ContextCallbackHandler": "langchain_community.callbacks.context_callback",
+    "FiddlerCallbackHandler": "langchain_community.callbacks.fiddler_callback",
+    "FlyteCallbackHandler": "langchain_community.callbacks.flyte_callback",
+    "HumanApprovalCallbackHandler": "langchain_community.callbacks.human",
+    "InfinoCallbackHandler": "langchain_community.callbacks.infino_callback",
+    "LLMThoughtLabeler": "langchain_community.callbacks.streamlit",
+    "LLMonitorCallbackHandler": "langchain_community.callbacks.llmonitor_callback",
+    "LabelStudioCallbackHandler": "langchain_community.callbacks.labelstudio_callback",
+    "MlflowCallbackHandler": "langchain_community.callbacks.mlflow_callback",
+    "OpenAICallbackHandler": "langchain_community.callbacks.openai_info",
+    "PromptLayerCallbackHandler": "langchain_community.callbacks.promptlayer_callback",
+    "SageMakerCallbackHandler": "langchain_community.callbacks.sagemaker_callback",
+    "StreamlitCallbackHandler": "langchain_community.callbacks.streamlit",
+    "TrubricsCallbackHandler": "langchain_community.callbacks.trubrics_callback",
+    "UpTrainCallbackHandler": "langchain_community.callbacks.uptrain_callback",
+    "WandbCallbackHandler": "langchain_community.callbacks.wandb_callback",
+    "WhyLabsCallbackHandler": "langchain_community.callbacks.whylabs_callback",
+    "get_openai_callback": "langchain_community.callbacks.manager",
+    "wandb_tracing_enabled": "langchain_community.callbacks.manager",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = [
+    "AimCallbackHandler",
+    "ArgillaCallbackHandler",
+    "ArizeCallbackHandler",
+    "ArthurCallbackHandler",
+    "ClearMLCallbackHandler",
+    "CometCallbackHandler",
+    "ContextCallbackHandler",
+    "FiddlerCallbackHandler",
+    "FlyteCallbackHandler",
+    "HumanApprovalCallbackHandler",
+    "InfinoCallbackHandler",
+    "LLMThoughtLabeler",
+    "LLMonitorCallbackHandler",
+    "LabelStudioCallbackHandler",
+    "MlflowCallbackHandler",
+    "OpenAICallbackHandler",
+    "PromptLayerCallbackHandler",
+    "SageMakerCallbackHandler",
+    "StreamlitCallbackHandler",
+    "TrubricsCallbackHandler",
+    "UpTrainCallbackHandler",
+    "WandbCallbackHandler",
+    "WhyLabsCallbackHandler",
+    "get_openai_callback",
+    "wandb_tracing_enabled",
+]
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fb12712283ba69b6f5c7f4fa0982246817e5650d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/aim_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/aim_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4ae34596f4dae94cdc53212583e9d5c6746033d7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/aim_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/argilla_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/argilla_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bc6f51b3aef67ea174a8389521afe17cd5acf541
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/argilla_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/arize_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/arize_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f3bf3a0e95b29308b47da7efaa5f6aa009da92aa
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/arize_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/arthur_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/arthur_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cf2e7baff1495546102991a887893f675774b2c5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/arthur_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/bedrock_anthropic_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/bedrock_anthropic_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..93cef9667b80625f4749cb93412565a06d3bdd7a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/bedrock_anthropic_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/clearml_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/clearml_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..02410671bdf6a0444e1f96018d730581757ce45d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/clearml_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/comet_ml_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/comet_ml_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9640098b0d3e0d2f47d99295fa424047f4bc6cb6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/comet_ml_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/confident_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/confident_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..08db84ed115b008192bc9671a72e4eab1a83921a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/confident_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/context_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/context_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8924e9f0cdfd040c2789291ca6d1f1e6f25e1a8c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/context_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/fiddler_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/fiddler_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e52b09c579f957ed995c31dbc481e30a74c8faa6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/fiddler_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/flyte_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/flyte_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6eebfcfd7f0b5da6b78ec8fa4c3a093bee9845f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/flyte_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/human.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/human.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ac502f6dfd74d881436d1453b85a7da38350affb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/human.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/infino_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/infino_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..95b4b2b6107dcc206f676863842102cb38ea6905
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/infino_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/labelstudio_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/labelstudio_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d45f779e4cd62b922975847d1465cd1ff4a6981e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/labelstudio_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/llmonitor_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/llmonitor_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..da2c5aa970434dfb457e5d1e489959cf7c2a4c80
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/llmonitor_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/manager.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/manager.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7327acac654f44441df40cda9f6008ab1ec1a357
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/manager.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/mlflow_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/mlflow_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e45122e7959ff05086d8b6ee72913b5702e876e3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/mlflow_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/openai_info.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/openai_info.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e23752a72337727b61353e3a8d49db5d41f017e2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/openai_info.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/promptlayer_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/promptlayer_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b89b259abefae1ab14acb90e8f73dbae749c48ed
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/promptlayer_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/sagemaker_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/sagemaker_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fb8dc6bad9dc071fcdf62663f6e0cd5472311a98
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/sagemaker_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/trubrics_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/trubrics_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2b6f0c7e7895c22ecb3472a9df5445cafa6e8b44
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/trubrics_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/uptrain_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/uptrain_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2dad0ed22d4869ffcd3b041fcf3b6eed69d0c2ca
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/uptrain_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7ad40965ada4b47973188b941d6e6672d84f9d4d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/wandb_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/wandb_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d5b754a14ed9a2dd020117e1d811deb6b3772474
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/wandb_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/whylabs_callback.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/whylabs_callback.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e2114f0a02bf00d784a5be767208258f8f9250cb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/__pycache__/whylabs_callback.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/aim_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/aim_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..46d7987c54eef7729a64eca52b068eb2cd6aecb7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/aim_callback.py
@@ -0,0 +1,441 @@
+from copy import deepcopy
+from typing import Any, Dict, List, Optional
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.outputs import LLMResult
+
+
+def import_aim() -> Any:
+    """Import the aim python package and raise an error if it is not installed."""
+    try:
+        import aim
+    except ImportError:
+        raise ImportError(
+            "To use the Aim callback manager you need to have the"
+            " `aim` python package installed."
+            "Please install it with `pip install aim`"
+        )
+    return aim
+
+
+class BaseMetadataCallbackHandler:
+    """This class handles the metadata and associated function states for callbacks.
+
+    Attributes:
+        step (int): The current step.
+        starts (int): The number of times the start method has been called.
+        ends (int): The number of times the end method has been called.
+        errors (int): The number of times the error method has been called.
+        text_ctr (int): The number of times the text method has been called.
+        ignore_llm_ (bool): Whether to ignore llm callbacks.
+        ignore_chain_ (bool): Whether to ignore chain callbacks.
+        ignore_agent_ (bool): Whether to ignore agent callbacks.
+        ignore_retriever_ (bool): Whether to ignore retriever callbacks.
+        always_verbose_ (bool): Whether to always be verbose.
+        chain_starts (int): The number of times the chain start method has been called.
+        chain_ends (int): The number of times the chain end method has been called.
+        llm_starts (int): The number of times the llm start method has been called.
+        llm_ends (int): The number of times the llm end method has been called.
+        llm_streams (int): The number of times the text method has been called.
+        tool_starts (int): The number of times the tool start method has been called.
+        tool_ends (int): The number of times the tool end method has been called.
+        agent_ends (int): The number of times the agent end method has been called.
+    """
+
+    def __init__(self) -> None:
+        self.step = 0
+
+        self.starts = 0
+        self.ends = 0
+        self.errors = 0
+        self.text_ctr = 0
+
+        self.ignore_llm_ = False
+        self.ignore_chain_ = False
+        self.ignore_agent_ = False
+        self.ignore_retriever_ = False
+        self.always_verbose_ = False
+
+        self.chain_starts = 0
+        self.chain_ends = 0
+
+        self.llm_starts = 0
+        self.llm_ends = 0
+        self.llm_streams = 0
+
+        self.tool_starts = 0
+        self.tool_ends = 0
+
+        self.agent_ends = 0
+
+    @property
+    def always_verbose(self) -> bool:
+        """Whether to call verbose callbacks even if verbose is False."""
+        return self.always_verbose_
+
+    @property
+    def ignore_llm(self) -> bool:
+        """Whether to ignore LLM callbacks."""
+        return self.ignore_llm_
+
+    @property
+    def ignore_chain(self) -> bool:
+        """Whether to ignore chain callbacks."""
+        return self.ignore_chain_
+
+    @property
+    def ignore_agent(self) -> bool:
+        """Whether to ignore agent callbacks."""
+        return self.ignore_agent_
+
+    @property
+    def ignore_retriever(self) -> bool:
+        """Whether to ignore retriever callbacks."""
+        return self.ignore_retriever_
+
+    def get_custom_callback_meta(self) -> Dict[str, Any]:
+        return {
+            "step": self.step,
+            "starts": self.starts,
+            "ends": self.ends,
+            "errors": self.errors,
+            "text_ctr": self.text_ctr,
+            "chain_starts": self.chain_starts,
+            "chain_ends": self.chain_ends,
+            "llm_starts": self.llm_starts,
+            "llm_ends": self.llm_ends,
+            "llm_streams": self.llm_streams,
+            "tool_starts": self.tool_starts,
+            "tool_ends": self.tool_ends,
+            "agent_ends": self.agent_ends,
+        }
+
+    def reset_callback_meta(self) -> None:
+        """Reset the callback metadata."""
+        self.step = 0
+
+        self.starts = 0
+        self.ends = 0
+        self.errors = 0
+        self.text_ctr = 0
+
+        self.ignore_llm_ = False
+        self.ignore_chain_ = False
+        self.ignore_agent_ = False
+        self.always_verbose_ = False
+
+        self.chain_starts = 0
+        self.chain_ends = 0
+
+        self.llm_starts = 0
+        self.llm_ends = 0
+        self.llm_streams = 0
+
+        self.tool_starts = 0
+        self.tool_ends = 0
+
+        self.agent_ends = 0
+
+        return None
+
+
+class AimCallbackHandler(BaseMetadataCallbackHandler, BaseCallbackHandler):
+    """Callback Handler that logs to Aim.
+
+    Parameters:
+        repo (:obj:`str`, optional): Aim repository path or Repo object to which
+            Run object is bound. If skipped, default Repo is used.
+        experiment_name (:obj:`str`, optional): Sets Run's `experiment` property.
+            'default' if not specified. Can be used later to query runs/sequences.
+        system_tracking_interval (:obj:`int`, optional): Sets the tracking interval
+            in seconds for system usage metrics (CPU, Memory, etc.). Set to `None`
+             to disable system metrics tracking.
+        log_system_params (:obj:`bool`, optional): Enable/Disable logging of system
+            params such as installed packages, git info, environment variables, etc.
+
+    This handler will utilize the associated callback method called and formats
+    the input of each callback function with metadata regarding the state of LLM run
+    and then logs the response to Aim.
+    """
+
+    def __init__(
+        self,
+        repo: Optional[str] = None,
+        experiment_name: Optional[str] = None,
+        system_tracking_interval: Optional[int] = 10,
+        log_system_params: bool = True,
+    ) -> None:
+        """Initialize callback handler."""
+
+        super().__init__()
+
+        aim = import_aim()
+        self.repo = repo
+        self.experiment_name = experiment_name
+        self.system_tracking_interval = system_tracking_interval
+        self.log_system_params = log_system_params
+        self._run = aim.Run(
+            repo=self.repo,
+            experiment=self.experiment_name,
+            system_tracking_interval=self.system_tracking_interval,
+            log_system_params=self.log_system_params,
+        )
+        self._run_hash = self._run.hash
+        self.action_records: list = []
+
+    def setup(self, **kwargs: Any) -> None:
+        aim = import_aim()
+
+        if not self._run:
+            if self._run_hash:
+                self._run = aim.Run(
+                    self._run_hash,
+                    repo=self.repo,
+                    system_tracking_interval=self.system_tracking_interval,
+                )
+            else:
+                self._run = aim.Run(
+                    repo=self.repo,
+                    experiment=self.experiment_name,
+                    system_tracking_interval=self.system_tracking_interval,
+                    log_system_params=self.log_system_params,
+                )
+                self._run_hash = self._run.hash
+
+        if kwargs:
+            for key, value in kwargs.items():
+                self._run.set(key, value, strict=False)
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """Run when LLM starts."""
+        aim = import_aim()
+
+        self.step += 1
+        self.llm_starts += 1
+        self.starts += 1
+
+        resp = {"action": "on_llm_start"}
+        resp.update(self.get_custom_callback_meta())
+
+        prompts_res = deepcopy(prompts)
+
+        self._run.track(
+            [aim.Text(prompt) for prompt in prompts_res],
+            name="on_llm_start",
+            context=resp,
+        )
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Run when LLM ends running."""
+        aim = import_aim()
+        self.step += 1
+        self.llm_ends += 1
+        self.ends += 1
+
+        resp = {"action": "on_llm_end"}
+        resp.update(self.get_custom_callback_meta())
+
+        response_res = deepcopy(response)
+
+        generated = [
+            aim.Text(generation.text)
+            for generations in response_res.generations
+            for generation in generations
+        ]
+        self._run.track(
+            generated,
+            name="on_llm_end",
+            context=resp,
+        )
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Run when LLM generates a new token."""
+        self.step += 1
+        self.llm_streams += 1
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when LLM errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Run when chain starts running."""
+        aim = import_aim()
+        self.step += 1
+        self.chain_starts += 1
+        self.starts += 1
+
+        resp = {"action": "on_chain_start"}
+        resp.update(self.get_custom_callback_meta())
+
+        inputs_res = deepcopy(inputs)
+
+        self._run.track(
+            aim.Text(inputs_res["input"]), name="on_chain_start", context=resp
+        )
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Run when chain ends running."""
+        aim = import_aim()
+        self.step += 1
+        self.chain_ends += 1
+        self.ends += 1
+
+        resp = {"action": "on_chain_end"}
+        resp.update(self.get_custom_callback_meta())
+
+        outputs_res = deepcopy(outputs)
+
+        self._run.track(
+            aim.Text(outputs_res["output"]), name="on_chain_end", context=resp
+        )
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when chain errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_tool_start(
+        self, serialized: Dict[str, Any], input_str: str, **kwargs: Any
+    ) -> None:
+        """Run when tool starts running."""
+        aim = import_aim()
+        self.step += 1
+        self.tool_starts += 1
+        self.starts += 1
+
+        resp = {"action": "on_tool_start"}
+        resp.update(self.get_custom_callback_meta())
+
+        self._run.track(aim.Text(input_str), name="on_tool_start", context=resp)
+
+    def on_tool_end(self, output: Any, **kwargs: Any) -> None:
+        """Run when tool ends running."""
+        output = str(output)
+        aim = import_aim()
+        self.step += 1
+        self.tool_ends += 1
+        self.ends += 1
+
+        resp = {"action": "on_tool_end"}
+        resp.update(self.get_custom_callback_meta())
+
+        self._run.track(aim.Text(output), name="on_tool_end", context=resp)
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when tool errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        """
+        Run when agent is ending.
+        """
+        self.step += 1
+        self.text_ctr += 1
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        """Run when agent ends running."""
+        aim = import_aim()
+        self.step += 1
+        self.agent_ends += 1
+        self.ends += 1
+
+        resp = {"action": "on_agent_finish"}
+        resp.update(self.get_custom_callback_meta())
+
+        finish_res = deepcopy(finish)
+
+        text = "OUTPUT:\n{}\n\nLOG:\n{}".format(
+            finish_res.return_values["output"], finish_res.log
+        )
+        self._run.track(aim.Text(text), name="on_agent_finish", context=resp)
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Run on agent action."""
+        aim = import_aim()
+        self.step += 1
+        self.tool_starts += 1
+        self.starts += 1
+
+        resp = {
+            "action": "on_agent_action",
+            "tool": action.tool,
+        }
+        resp.update(self.get_custom_callback_meta())
+
+        action_res = deepcopy(action)
+
+        text = "TOOL INPUT:\n{}\n\nLOG:\n{}".format(
+            action_res.tool_input, action_res.log
+        )
+        self._run.track(aim.Text(text), name="on_agent_action", context=resp)
+
+    def flush_tracker(
+        self,
+        repo: Optional[str] = None,
+        experiment_name: Optional[str] = None,
+        system_tracking_interval: Optional[int] = 10,
+        log_system_params: bool = True,
+        langchain_asset: Any = None,
+        reset: bool = True,
+        finish: bool = False,
+    ) -> None:
+        """Flush the tracker and reset the session.
+
+        Args:
+            repo (:obj:`str`, optional): Aim repository path or Repo object to which
+                Run object is bound. If skipped, default Repo is used.
+            experiment_name (:obj:`str`, optional): Sets Run's `experiment` property.
+                'default' if not specified. Can be used later to query runs/sequences.
+            system_tracking_interval (:obj:`int`, optional): Sets the tracking interval
+                in seconds for system usage metrics (CPU, Memory, etc.). Set to `None`
+                 to disable system metrics tracking.
+            log_system_params (:obj:`bool`, optional): Enable/Disable logging of system
+                params such as installed packages, git info, environment variables, etc.
+            langchain_asset: The langchain asset to save.
+            reset: Whether to reset the session.
+            finish: Whether to finish the run.
+
+            Returns:
+                None
+        """
+
+        if langchain_asset:
+            try:
+                for key, value in langchain_asset.dict().items():
+                    self._run.set(key, value, strict=False)
+            except Exception:
+                pass
+
+        if finish or reset:
+            self._run.close()
+            self.reset_callback_meta()
+        if reset:
+            aim = import_aim()
+            self.repo = repo if repo else self.repo
+            self.experiment_name = (
+                experiment_name if experiment_name else self.experiment_name
+            )
+            self.system_tracking_interval = (
+                system_tracking_interval
+                if system_tracking_interval
+                else self.system_tracking_interval
+            )
+            self.log_system_params = (
+                log_system_params if log_system_params else self.log_system_params
+            )
+
+            self._run = aim.Run(
+                repo=self.repo,
+                experiment=self.experiment_name,
+                system_tracking_interval=self.system_tracking_interval,
+                log_system_params=self.log_system_params,
+            )
+            self._run_hash = self._run.hash
+            self.action_records = []
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/argilla_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/argilla_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..ad1fa9c90142be189b6a2b0f689f3affeb798280
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/argilla_callback.py
@@ -0,0 +1,349 @@
+import os
+import warnings
+from typing import Any, Dict, List, Optional, cast
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.outputs import LLMResult
+from packaging.version import parse
+
+
+class ArgillaCallbackHandler(BaseCallbackHandler):
+    """Callback Handler that logs into Argilla.
+
+    Args:
+        dataset_name: name of the `FeedbackDataset` in Argilla. Note that it must
+            exist in advance. If you need help on how to create a `FeedbackDataset` in
+            Argilla, please visit
+            https://docs.argilla.io/en/latest/tutorials_and_integrations/integrations/use_argilla_callback_in_langchain.html.
+        workspace_name: name of the workspace in Argilla where the specified
+            `FeedbackDataset` lives in. Defaults to `None`, which means that the
+            default workspace will be used.
+        api_url: URL of the Argilla Server that we want to use, and where the
+            `FeedbackDataset` lives in. Defaults to `None`, which means that either
+            `ARGILLA_API_URL` environment variable or the default will be used.
+        api_key: API Key to connect to the Argilla Server. Defaults to `None`, which
+            means that either `ARGILLA_API_KEY` environment variable or the default
+            will be used.
+
+    Raises:
+        ImportError: if the `argilla` package is not installed.
+        ConnectionError: if the connection to Argilla fails.
+        FileNotFoundError: if the `FeedbackDataset` retrieval from Argilla fails.
+
+    Examples:
+        >>> from langchain_community.llms import OpenAI
+        >>> from langchain_community.callbacks import ArgillaCallbackHandler
+        >>> argilla_callback = ArgillaCallbackHandler(
+        ...     dataset_name="my-dataset",
+        ...     workspace_name="my-workspace",
+        ...     api_url="http://localhost:6900",
+        ...     api_key="argilla.apikey",
+        ... )
+        >>> llm = OpenAI(
+        ...     temperature=0,
+        ...     callbacks=[argilla_callback],
+        ...     verbose=True,
+        ...     openai_api_key="API_KEY_HERE",
+        ... )
+        >>> llm.generate([
+        ...     "What is the best NLP-annotation tool out there? (no bias at all)",
+        ... ])
+        "Argilla, no doubt about it."
+    """
+
+    REPO_URL: str = "https://github.com/argilla-io/argilla"
+    ISSUES_URL: str = f"{REPO_URL}/issues"
+    BLOG_URL: str = "https://docs.argilla.io/en/latest/tutorials_and_integrations/integrations/use_argilla_callback_in_langchain.html"  # noqa: E501
+
+    DEFAULT_API_URL: str = "http://localhost:6900"
+
+    def __init__(
+        self,
+        dataset_name: str,
+        workspace_name: Optional[str] = None,
+        api_url: Optional[str] = None,
+        api_key: Optional[str] = None,
+    ) -> None:
+        """Initializes the `ArgillaCallbackHandler`.
+
+        Args:
+            dataset_name: name of the `FeedbackDataset` in Argilla. Note that it must
+                exist in advance. If you need help on how to create a `FeedbackDataset`
+                in Argilla, please visit
+                https://docs.argilla.io/en/latest/tutorials_and_integrations/integrations/use_argilla_callback_in_langchain.html.
+            workspace_name: name of the workspace in Argilla where the specified
+                `FeedbackDataset` lives in. Defaults to `None`, which means that the
+                default workspace will be used.
+            api_url: URL of the Argilla Server that we want to use, and where the
+                `FeedbackDataset` lives in. Defaults to `None`, which means that either
+                `ARGILLA_API_URL` environment variable or the default will be used.
+            api_key: API Key to connect to the Argilla Server. Defaults to `None`, which
+                means that either `ARGILLA_API_KEY` environment variable or the default
+                will be used.
+
+        Raises:
+            ImportError: if the `argilla` package is not installed.
+            ConnectionError: if the connection to Argilla fails.
+            FileNotFoundError: if the `FeedbackDataset` retrieval from Argilla fails.
+        """
+
+        super().__init__()
+
+        # Import Argilla (not via `import_argilla` to keep hints in IDEs)
+        try:
+            import argilla as rg  # noqa: F401
+
+            self.ARGILLA_VERSION = rg.__version__
+        except ImportError:
+            raise ImportError(
+                "To use the Argilla callback manager you need to have the `argilla` "
+                "Python package installed. Please install it with `pip install argilla`"
+            )
+
+        # Check whether the Argilla version is compatible
+        if parse(self.ARGILLA_VERSION) < parse("1.8.0"):
+            raise ImportError(
+                f"The installed `argilla` version is {self.ARGILLA_VERSION} but "
+                "`ArgillaCallbackHandler` requires at least version 1.8.0. Please "
+                "upgrade `argilla` with `pip install --upgrade argilla`."
+            )
+
+        # Show a warning message if Argilla will assume the default values will be used
+        if api_url is None and os.getenv("ARGILLA_API_URL") is None:
+            warnings.warn(
+                (
+                    "Since `api_url` is None, and the env var `ARGILLA_API_URL` is not"
+                    f" set, it will default to `{self.DEFAULT_API_URL}`, which is the"
+                    " default API URL in Argilla Quickstart."
+                ),
+            )
+            api_url = self.DEFAULT_API_URL
+
+        if api_key is None and os.getenv("ARGILLA_API_KEY") is None:
+            self.DEFAULT_API_KEY = (
+                "admin.apikey"
+                if parse(self.ARGILLA_VERSION) < parse("1.11.0")
+                else "owner.apikey"
+            )
+
+            warnings.warn(
+                (
+                    "Since `api_key` is None, and the env var `ARGILLA_API_KEY` is not"
+                    f" set, it will default to `{self.DEFAULT_API_KEY}`, which is the"
+                    " default API key in Argilla Quickstart."
+                ),
+            )
+            api_key = self.DEFAULT_API_KEY
+
+        # Connect to Argilla with the provided credentials, if applicable
+        try:
+            rg.init(api_key=api_key, api_url=api_url)
+        except Exception as e:
+            raise ConnectionError(
+                f"Could not connect to Argilla with exception: '{e}'.\n"
+                "Please check your `api_key` and `api_url`, and make sure that "
+                "the Argilla server is up and running. If the problem persists "
+                f"please report it to {self.ISSUES_URL} as an `integration` issue."
+            ) from e
+
+        # Set the Argilla variables
+        self.dataset_name = dataset_name
+        self.workspace_name = workspace_name or rg.get_workspace()
+
+        # Retrieve the `FeedbackDataset` from Argilla (without existing records)
+        try:
+            extra_args = {}
+            if parse(self.ARGILLA_VERSION) < parse("1.14.0"):
+                warnings.warn(
+                    f"You have Argilla {self.ARGILLA_VERSION}, but Argilla 1.14.0 or"
+                    " higher is recommended.",
+                    UserWarning,
+                )
+                extra_args = {"with_records": False}
+            self.dataset = rg.FeedbackDataset.from_argilla(
+                name=self.dataset_name,
+                workspace=self.workspace_name,
+                **extra_args,
+            )
+        except Exception as e:
+            raise FileNotFoundError(
+                f"`FeedbackDataset` retrieval from Argilla failed with exception `{e}`."
+                f"\nPlease check that the dataset with name={self.dataset_name} in the"
+                f" workspace={self.workspace_name} exists in advance. If you need help"
+                " on how to create a `langchain`-compatible `FeedbackDataset` in"
+                f" Argilla, please visit {self.BLOG_URL}. If the problem persists"
+                f" please report it to {self.ISSUES_URL} as an `integration` issue."
+            ) from e
+
+        supported_fields = ["prompt", "response"]
+        if supported_fields != [field.name for field in self.dataset.fields]:
+            raise ValueError(
+                f"`FeedbackDataset` with name={self.dataset_name} in the workspace="
+                f"{self.workspace_name} had fields that are not supported yet for the"
+                f"`langchain` integration. Supported fields are: {supported_fields},"
+                f" and the current `FeedbackDataset` fields are {[field.name for field in self.dataset.fields]}."  # noqa: E501
+                " For more information on how to create a `langchain`-compatible"
+                f" `FeedbackDataset` in Argilla, please visit {self.BLOG_URL}."
+            )
+
+        self.prompts: Dict[str, List[str]] = {}
+
+        warnings.warn(
+            (
+                "The `ArgillaCallbackHandler` is currently in beta and is subject to"
+                " change based on updates to `langchain`. Please report any issues to"
+                f" {self.ISSUES_URL} as an `integration` issue."
+            ),
+        )
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """Save the prompts in memory when an LLM starts."""
+        self.prompts.update({str(kwargs["parent_run_id"] or kwargs["run_id"]): prompts})
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Do nothing when a new token is generated."""
+        pass
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Log records to Argilla when an LLM ends."""
+        # Do nothing if there's a parent_run_id, since we will log the records when
+        # the chain ends
+        if kwargs["parent_run_id"]:
+            return
+
+        # Creates the records and adds them to the `FeedbackDataset`
+        prompts = self.prompts[str(kwargs["run_id"])]
+        for prompt, generations in zip(prompts, response.generations):
+            self.dataset.add_records(
+                records=[
+                    {
+                        "fields": {
+                            "prompt": prompt,
+                            "response": generation.text.strip(),
+                        },
+                    }
+                    for generation in generations
+                ]
+            )
+
+        # Pop current run from `self.runs`
+        self.prompts.pop(str(kwargs["run_id"]))
+
+        if parse(self.ARGILLA_VERSION) < parse("1.14.0"):
+            # Push the records to Argilla
+            self.dataset.push_to_argilla()
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing when LLM outputs an error."""
+        pass
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """If the key `input` is in `inputs`, then save it in `self.prompts` using
+        either the `parent_run_id` or the `run_id` as the key. This is done so that
+        we don't log the same input prompt twice, once when the LLM starts and once
+        when the chain starts.
+        """
+        if "input" in inputs:
+            self.prompts.update(
+                {
+                    str(kwargs["parent_run_id"] or kwargs["run_id"]): (
+                        inputs["input"]
+                        if isinstance(inputs["input"], list)
+                        else [inputs["input"]]
+                    )
+                }
+            )
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """If either the `parent_run_id` or the `run_id` is in `self.prompts`, then
+        log the outputs to Argilla, and pop the run from `self.prompts`. The behavior
+        differs if the output is a list or not.
+        """
+        if not any(
+            key in self.prompts
+            for key in [str(kwargs["parent_run_id"]), str(kwargs["run_id"])]
+        ):
+            return
+        prompts: List = self.prompts.get(str(kwargs["parent_run_id"])) or cast(
+            List, self.prompts.get(str(kwargs["run_id"]), [])
+        )
+        for chain_output_key, chain_output_val in outputs.items():
+            if isinstance(chain_output_val, list):
+                # Creates the records and adds them to the `FeedbackDataset`
+                self.dataset.add_records(
+                    records=[
+                        {
+                            "fields": {
+                                "prompt": prompt,
+                                "response": output["text"].strip(),
+                            },
+                        }
+                        for prompt, output in zip(prompts, chain_output_val)
+                    ]
+                )
+            else:
+                # Creates the records and adds them to the `FeedbackDataset`
+                self.dataset.add_records(
+                    records=[
+                        {
+                            "fields": {
+                                "prompt": " ".join(prompts),
+                                "response": chain_output_val.strip(),
+                            },
+                        }
+                    ]
+                )
+
+        # Pop current run from `self.runs`
+        if str(kwargs["parent_run_id"]) in self.prompts:
+            self.prompts.pop(str(kwargs["parent_run_id"]))
+        if str(kwargs["run_id"]) in self.prompts:
+            self.prompts.pop(str(kwargs["run_id"]))
+
+        if parse(self.ARGILLA_VERSION) < parse("1.14.0"):
+            # Push the records to Argilla
+            self.dataset.push_to_argilla()
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing when LLM chain outputs an error."""
+        pass
+
+    def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        **kwargs: Any,
+    ) -> None:
+        """Do nothing when tool starts."""
+        pass
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Do nothing when agent takes a specific action."""
+        pass
+
+    def on_tool_end(
+        self,
+        output: Any,
+        observation_prefix: Optional[str] = None,
+        llm_prefix: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Do nothing when tool ends."""
+        pass
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing when tool outputs an error."""
+        pass
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        """Do nothing"""
+        pass
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        """Do nothing"""
+        pass
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/arize_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/arize_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7905d8d8ca020cc53e094aec154ba58fdb629ec
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/arize_callback.py
@@ -0,0 +1,213 @@
+from datetime import datetime
+from typing import Any, Dict, List, Optional
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.outputs import LLMResult
+
+from langchain_community.callbacks.utils import import_pandas
+
+
+class ArizeCallbackHandler(BaseCallbackHandler):
+    """Callback Handler that logs to Arize."""
+
+    def __init__(
+        self,
+        model_id: Optional[str] = None,
+        model_version: Optional[str] = None,
+        SPACE_KEY: Optional[str] = None,
+        API_KEY: Optional[str] = None,
+    ) -> None:
+        """Initialize callback handler."""
+
+        super().__init__()
+        self.model_id = model_id
+        self.model_version = model_version
+        self.space_key = SPACE_KEY
+        self.api_key = API_KEY
+        self.prompt_records: List[str] = []
+        self.response_records: List[str] = []
+        self.prediction_ids: List[str] = []
+        self.pred_timestamps: List[int] = []
+        self.response_embeddings: List[float] = []
+        self.prompt_embeddings: List[float] = []
+        self.prompt_tokens = 0
+        self.completion_tokens = 0
+        self.total_tokens = 0
+        self.step = 0
+
+        from arize.pandas.embeddings import EmbeddingGenerator, UseCases
+        from arize.pandas.logger import Client
+
+        self.generator = EmbeddingGenerator.from_use_case(
+            use_case=UseCases.NLP.SEQUENCE_CLASSIFICATION,
+            model_name="distilbert-base-uncased",
+            tokenizer_max_length=512,
+            batch_size=256,
+        )
+        self.arize_client = Client(space_key=SPACE_KEY, api_key=API_KEY)
+        if SPACE_KEY == "SPACE_KEY" or API_KEY == "API_KEY":
+            raise ValueError("❌ CHANGE SPACE AND API KEYS")
+        else:
+            print("✅ Arize client setup done! Now you can start using Arize!")  # noqa: T201
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        for prompt in prompts:
+            self.prompt_records.append(prompt.replace("\n", ""))
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Do nothing."""
+        pass
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        pd = import_pandas()
+        from arize.utils.types import (
+            EmbeddingColumnNames,
+            Environments,
+            ModelTypes,
+            Schema,
+        )
+
+        # Safe check if 'llm_output' and 'token_usage' exist
+        if response.llm_output and "token_usage" in response.llm_output:
+            self.prompt_tokens = response.llm_output["token_usage"].get(
+                "prompt_tokens", 0
+            )
+            self.total_tokens = response.llm_output["token_usage"].get(
+                "total_tokens", 0
+            )
+            self.completion_tokens = response.llm_output["token_usage"].get(
+                "completion_tokens", 0
+            )
+        else:
+            self.prompt_tokens = (
+                self.total_tokens
+            ) = self.completion_tokens = 0  # assign default value
+
+        for generations in response.generations:
+            for generation in generations:
+                prompt = self.prompt_records[self.step]
+                self.step = self.step + 1
+                prompt_embedding = pd.Series(
+                    self.generator.generate_embeddings(
+                        text_col=pd.Series(prompt.replace("\n", " "))
+                    ).reset_index(drop=True)
+                )
+
+                # Assigning text to response_text instead of response
+                response_text = generation.text.replace("\n", " ")
+                response_embedding = pd.Series(
+                    self.generator.generate_embeddings(
+                        text_col=pd.Series(generation.text.replace("\n", " "))
+                    ).reset_index(drop=True)
+                )
+                pred_timestamp = datetime.now().timestamp()
+
+                # Define the columns and data
+                columns = [
+                    "prediction_ts",
+                    "response",
+                    "prompt",
+                    "response_vector",
+                    "prompt_vector",
+                    "prompt_token",
+                    "completion_token",
+                    "total_token",
+                ]
+                data = [
+                    [
+                        pred_timestamp,
+                        response_text,
+                        prompt,
+                        response_embedding[0],
+                        prompt_embedding[0],
+                        self.prompt_tokens,
+                        self.total_tokens,
+                        self.completion_tokens,
+                    ]
+                ]
+
+                # Create the DataFrame
+                df = pd.DataFrame(data, columns=columns)
+
+                # Declare prompt and response columns
+                prompt_columns = EmbeddingColumnNames(
+                    vector_column_name="prompt_vector", data_column_name="prompt"
+                )
+
+                response_columns = EmbeddingColumnNames(
+                    vector_column_name="response_vector", data_column_name="response"
+                )
+
+                schema = Schema(
+                    timestamp_column_name="prediction_ts",
+                    tag_column_names=[
+                        "prompt_token",
+                        "completion_token",
+                        "total_token",
+                    ],
+                    prompt_column_names=prompt_columns,
+                    response_column_names=response_columns,
+                )
+
+                response_from_arize = self.arize_client.log(
+                    dataframe=df,
+                    schema=schema,
+                    model_id=self.model_id,
+                    model_version=self.model_version,
+                    model_type=ModelTypes.GENERATIVE_LLM,
+                    environment=Environments.PRODUCTION,
+                )
+                if response_from_arize.status_code == 200:
+                    print("✅ Successfully logged data to Arize!")  # noqa: T201
+                else:
+                    print(f'❌ Logging failed "{response_from_arize.text}"')  # noqa: T201
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing."""
+        pass
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        pass
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Do nothing."""
+        pass
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing."""
+        pass
+
+    def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        **kwargs: Any,
+    ) -> None:
+        pass
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Do nothing."""
+        pass
+
+    def on_tool_end(
+        self,
+        output: Any,
+        observation_prefix: Optional[str] = None,
+        llm_prefix: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        pass
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        pass
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        pass
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        pass
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/arthur_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/arthur_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..c9a81650e542be4f6b48904dacd791a5153d6162
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/arthur_callback.py
@@ -0,0 +1,296 @@
+"""ArthurAI's Callback Handler."""
+from __future__ import annotations
+
+import os
+import uuid
+from collections import defaultdict
+from datetime import datetime
+from time import time
+from typing import TYPE_CHECKING, Any, DefaultDict, Dict, List, Optional
+
+import numpy as np
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.outputs import LLMResult
+
+if TYPE_CHECKING:
+    import arthurai
+    from arthurai.core.models import ArthurModel
+
+PROMPT_TOKENS = "prompt_tokens"
+COMPLETION_TOKENS = "completion_tokens"
+TOKEN_USAGE = "token_usage"
+FINISH_REASON = "finish_reason"
+DURATION = "duration"
+
+
+def _lazy_load_arthur() -> arthurai:
+    """Lazy load Arthur."""
+    try:
+        import arthurai
+    except ImportError as e:
+        raise ImportError(
+            "To use the ArthurCallbackHandler you need the"
+            " `arthurai` package. Please install it with"
+            " `pip install arthurai`.",
+            e,
+        )
+
+    return arthurai
+
+
+class ArthurCallbackHandler(BaseCallbackHandler):
+    """Callback Handler that logs to Arthur platform.
+
+    Arthur helps enterprise teams optimize model operations
+    and performance at scale. The Arthur API tracks model
+    performance, explainability, and fairness across tabular,
+    NLP, and CV models. Our API is model- and platform-agnostic,
+    and continuously scales with complex and dynamic enterprise needs.
+    To learn more about Arthur, visit our website at
+    https://www.arthur.ai/ or read the Arthur docs at
+    https://docs.arthur.ai/
+    """
+
+    def __init__(
+        self,
+        arthur_model: ArthurModel,
+    ) -> None:
+        """Initialize callback handler."""
+        super().__init__()
+        arthurai = _lazy_load_arthur()
+        Stage = arthurai.common.constants.Stage
+        ValueType = arthurai.common.constants.ValueType
+        self.arthur_model = arthur_model
+        # save the attributes of this model to be used when preparing
+        # inferences to log to Arthur in on_llm_end()
+        self.attr_names = set([a.name for a in self.arthur_model.get_attributes()])
+        self.input_attr = [
+            x
+            for x in self.arthur_model.get_attributes()
+            if x.stage == Stage.ModelPipelineInput
+            and x.value_type == ValueType.Unstructured_Text
+        ][0].name
+        self.output_attr = [
+            x
+            for x in self.arthur_model.get_attributes()
+            if x.stage == Stage.PredictedValue
+            and x.value_type == ValueType.Unstructured_Text
+        ][0].name
+        self.token_likelihood_attr = None
+        if (
+            len(
+                [
+                    x
+                    for x in self.arthur_model.get_attributes()
+                    if x.value_type == ValueType.TokenLikelihoods
+                ]
+            )
+            > 0
+        ):
+            self.token_likelihood_attr = [
+                x
+                for x in self.arthur_model.get_attributes()
+                if x.value_type == ValueType.TokenLikelihoods
+            ][0].name
+
+        self.run_map: DefaultDict[str, Any] = defaultdict(dict)
+
+    @classmethod
+    def from_credentials(
+        cls,
+        model_id: str,
+        arthur_url: Optional[str] = "https://app.arthur.ai",
+        arthur_login: Optional[str] = None,
+        arthur_password: Optional[str] = None,
+    ) -> ArthurCallbackHandler:
+        """Initialize callback handler from Arthur credentials.
+
+        Args:
+            model_id (str): The ID of the arthur model to log to.
+            arthur_url (str, optional): The URL of the Arthur instance to log to.
+                Defaults to "https://app.arthur.ai".
+            arthur_login (str, optional): The login to use to connect to Arthur.
+                Defaults to None.
+            arthur_password (str, optional): The password to use to connect to
+                Arthur. Defaults to None.
+
+        Returns:
+            ArthurCallbackHandler: The initialized callback handler.
+        """
+        arthurai = _lazy_load_arthur()
+        ArthurAI = arthurai.ArthurAI
+        ResponseClientError = arthurai.common.exceptions.ResponseClientError
+
+        # connect to Arthur
+        if arthur_login is None:
+            try:
+                arthur_api_key = os.environ["ARTHUR_API_KEY"]
+            except KeyError:
+                raise ValueError(
+                    "No Arthur authentication provided. Either give"
+                    " a login to the ArthurCallbackHandler"
+                    " or set an ARTHUR_API_KEY as an environment variable."
+                )
+            arthur = ArthurAI(url=arthur_url, access_key=arthur_api_key)
+        else:
+            if arthur_password is None:
+                arthur = ArthurAI(url=arthur_url, login=arthur_login)
+            else:
+                arthur = ArthurAI(
+                    url=arthur_url, login=arthur_login, password=arthur_password
+                )
+        # get model from Arthur by the provided model ID
+        try:
+            arthur_model = arthur.get_model(model_id)
+        except ResponseClientError:
+            raise ValueError(
+                f"Was unable to retrieve model with id {model_id} from Arthur."
+                " Make sure the ID corresponds to a model that is currently"
+                " registered with your Arthur account."
+            )
+        return cls(arthur_model)
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """On LLM start, save the input prompts"""
+        run_id = kwargs["run_id"]
+        self.run_map[run_id]["input_texts"] = prompts
+        self.run_map[run_id]["start_time"] = time()
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """On LLM end, send data to Arthur."""
+        try:
+            import pytz
+        except ImportError as e:
+            raise ImportError(
+                "Could not import pytz. Please install it with 'pip install pytz'."
+            ) from e
+
+        run_id = kwargs["run_id"]
+
+        # get the run params from this run ID,
+        # or raise an error if this run ID has no corresponding metadata in self.run_map
+        try:
+            run_map_data = self.run_map[run_id]
+        except KeyError as e:
+            raise KeyError(
+                "This function has been called with a run_id"
+                " that was never registered in on_llm_start()."
+                " Restart and try running the LLM again"
+            ) from e
+
+        # mark the duration time between on_llm_start() and on_llm_end()
+        time_from_start_to_end = time() - run_map_data["start_time"]
+
+        # create inferences to log to Arthur
+        inferences = []
+        for i, generations in enumerate(response.generations):
+            for generation in generations:
+                inference = {
+                    "partner_inference_id": str(uuid.uuid4()),
+                    "inference_timestamp": datetime.now(tz=pytz.UTC),
+                    self.input_attr: run_map_data["input_texts"][i],
+                    self.output_attr: generation.text,
+                }
+
+                if generation.generation_info is not None:
+                    # add finish reason to the inference
+                    # if generation info contains a finish reason and
+                    # if the ArthurModel was registered to monitor finish_reason
+                    if (
+                        FINISH_REASON in generation.generation_info
+                        and FINISH_REASON in self.attr_names
+                    ):
+                        inference[FINISH_REASON] = generation.generation_info[
+                            FINISH_REASON
+                        ]
+
+                    # add token likelihoods data to the inference if the ArthurModel
+                    # was registered to monitor token likelihoods
+                    logprobs_data = generation.generation_info["logprobs"]
+                    if (
+                        logprobs_data is not None
+                        and self.token_likelihood_attr is not None
+                    ):
+                        logprobs = logprobs_data["top_logprobs"]
+                        likelihoods = [
+                            {k: np.exp(v) for k, v in logprobs[i].items()}
+                            for i in range(len(logprobs))
+                        ]
+                        inference[self.token_likelihood_attr] = likelihoods
+
+                # add token usage counts to the inference if the
+                # ArthurModel was registered to monitor token usage
+                if (
+                    isinstance(response.llm_output, dict)
+                    and TOKEN_USAGE in response.llm_output
+                ):
+                    token_usage = response.llm_output[TOKEN_USAGE]
+                    if (
+                        PROMPT_TOKENS in token_usage
+                        and PROMPT_TOKENS in self.attr_names
+                    ):
+                        inference[PROMPT_TOKENS] = token_usage[PROMPT_TOKENS]
+                    if (
+                        COMPLETION_TOKENS in token_usage
+                        and COMPLETION_TOKENS in self.attr_names
+                    ):
+                        inference[COMPLETION_TOKENS] = token_usage[COMPLETION_TOKENS]
+
+                # add inference duration to the inference if the ArthurModel
+                # was registered to monitor inference duration
+                if DURATION in self.attr_names:
+                    inference[DURATION] = time_from_start_to_end
+
+                inferences.append(inference)
+
+        # send inferences to arthur
+        self.arthur_model.send_inferences(inferences)
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """On chain start, do nothing."""
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """On chain end, do nothing."""
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing when LLM outputs an error."""
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """On new token, pass."""
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing when LLM chain outputs an error."""
+
+    def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        **kwargs: Any,
+    ) -> None:
+        """Do nothing when tool starts."""
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Do nothing when agent takes a specific action."""
+
+    def on_tool_end(
+        self,
+        output: Any,
+        observation_prefix: Optional[str] = None,
+        llm_prefix: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Do nothing when tool ends."""
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing when tool outputs an error."""
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        """Do nothing"""
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        """Do nothing"""
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/bedrock_anthropic_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/bedrock_anthropic_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..d146bf8fbe00e36c1a7eb7dd8326b30655297e70
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/bedrock_anthropic_callback.py
@@ -0,0 +1,111 @@
+import threading
+from typing import Any, Dict, List, Union
+
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.outputs import LLMResult
+
+MODEL_COST_PER_1K_INPUT_TOKENS = {
+    "anthropic.claude-instant-v1": 0.0008,
+    "anthropic.claude-v2": 0.008,
+    "anthropic.claude-v2:1": 0.008,
+    "anthropic.claude-3-sonnet-20240229-v1:0": 0.003,
+    "anthropic.claude-3-haiku-20240307-v1:0": 0.00025,
+}
+
+MODEL_COST_PER_1K_OUTPUT_TOKENS = {
+    "anthropic.claude-instant-v1": 0.0024,
+    "anthropic.claude-v2": 0.024,
+    "anthropic.claude-v2:1": 0.024,
+    "anthropic.claude-3-sonnet-20240229-v1:0": 0.015,
+    "anthropic.claude-3-haiku-20240307-v1:0": 0.00125,
+}
+
+
+def _get_anthropic_claude_token_cost(
+    prompt_tokens: int, completion_tokens: int, model_id: Union[str, None]
+) -> float:
+    """Get the cost of tokens for the Claude model."""
+    if model_id not in MODEL_COST_PER_1K_INPUT_TOKENS:
+        raise ValueError(
+            f"Unknown model: {model_id}. Please provide a valid Anthropic model name."
+            "Known models are: " + ", ".join(MODEL_COST_PER_1K_INPUT_TOKENS.keys())
+        )
+    return (prompt_tokens / 1000) * MODEL_COST_PER_1K_INPUT_TOKENS[model_id] + (
+        completion_tokens / 1000
+    ) * MODEL_COST_PER_1K_OUTPUT_TOKENS[model_id]
+
+
+class BedrockAnthropicTokenUsageCallbackHandler(BaseCallbackHandler):
+    """Callback Handler that tracks bedrock anthropic info."""
+
+    total_tokens: int = 0
+    prompt_tokens: int = 0
+    completion_tokens: int = 0
+    successful_requests: int = 0
+    total_cost: float = 0.0
+
+    def __init__(self) -> None:
+        super().__init__()
+        self._lock = threading.Lock()
+
+    def __repr__(self) -> str:
+        return (
+            f"Tokens Used: {self.total_tokens}\n"
+            f"\tPrompt Tokens: {self.prompt_tokens}\n"
+            f"\tCompletion Tokens: {self.completion_tokens}\n"
+            f"Successful Requests: {self.successful_requests}\n"
+            f"Total Cost (USD): ${self.total_cost}"
+        )
+
+    @property
+    def always_verbose(self) -> bool:
+        """Whether to call verbose callbacks even if verbose is False."""
+        return True
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """Print out the prompts."""
+        pass
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Print out the token."""
+        pass
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Collect token usage."""
+        if response.llm_output is None:
+            return None
+
+        if "usage" not in response.llm_output:
+            with self._lock:
+                self.successful_requests += 1
+            return None
+
+        # compute tokens and cost for this request
+        token_usage = response.llm_output["usage"]
+        completion_tokens = token_usage.get("completion_tokens", 0)
+        prompt_tokens = token_usage.get("prompt_tokens", 0)
+        total_tokens = token_usage.get("total_tokens", 0)
+        model_id = response.llm_output.get("model_id", None)
+        total_cost = _get_anthropic_claude_token_cost(
+            prompt_tokens=prompt_tokens,
+            completion_tokens=completion_tokens,
+            model_id=model_id,
+        )
+
+        # update shared state behind lock
+        with self._lock:
+            self.total_cost += total_cost
+            self.total_tokens += total_tokens
+            self.prompt_tokens += prompt_tokens
+            self.completion_tokens += completion_tokens
+            self.successful_requests += 1
+
+    def __copy__(self) -> "BedrockAnthropicTokenUsageCallbackHandler":
+        """Return a copy of the callback handler."""
+        return self
+
+    def __deepcopy__(self, memo: Any) -> "BedrockAnthropicTokenUsageCallbackHandler":
+        """Return a deep copy of the callback handler."""
+        return self
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/clearml_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/clearml_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..34358973b41f8116b31c114c0dcfece0c9aec68d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/clearml_callback.py
@@ -0,0 +1,524 @@
+from __future__ import annotations
+
+import tempfile
+from copy import deepcopy
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Dict, List, Mapping, Optional, Sequence
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.outputs import LLMResult
+
+from langchain_community.callbacks.utils import (
+    BaseMetadataCallbackHandler,
+    flatten_dict,
+    hash_string,
+    import_pandas,
+    import_spacy,
+    import_textstat,
+    load_json,
+)
+
+if TYPE_CHECKING:
+    import pandas as pd
+
+
+def import_clearml() -> Any:
+    """Import the clearml python package and raise an error if it is not installed."""
+    try:
+        import clearml  # noqa: F401
+    except ImportError:
+        raise ImportError(
+            "To use the clearml callback manager you need to have the `clearml` python "
+            "package installed. Please install it with `pip install clearml`"
+        )
+    return clearml
+
+
+class ClearMLCallbackHandler(BaseMetadataCallbackHandler, BaseCallbackHandler):
+    """Callback Handler that logs to ClearML.
+
+    Parameters:
+        job_type (str): The type of clearml task such as "inference", "testing" or "qc"
+        project_name (str): The clearml project name
+        tags (list): Tags to add to the task
+        task_name (str): Name of the clearml task
+        visualize (bool): Whether to visualize the run.
+        complexity_metrics (bool): Whether to log complexity metrics
+        stream_logs (bool): Whether to stream callback actions to ClearML
+
+    This handler will utilize the associated callback method and formats
+    the input of each callback function with metadata regarding the state of LLM run,
+    and adds the response to the list of records for both the {method}_records and
+    action. It then logs the response to the ClearML console.
+    """
+
+    def __init__(
+        self,
+        task_type: Optional[str] = "inference",
+        project_name: Optional[str] = "langchain_callback_demo",
+        tags: Optional[Sequence] = None,
+        task_name: Optional[str] = None,
+        visualize: bool = False,
+        complexity_metrics: bool = False,
+        stream_logs: bool = False,
+    ) -> None:
+        """Initialize callback handler."""
+
+        clearml = import_clearml()
+        spacy = import_spacy()
+        super().__init__()
+
+        self.task_type = task_type
+        self.project_name = project_name
+        self.tags = tags
+        self.task_name = task_name
+        self.visualize = visualize
+        self.complexity_metrics = complexity_metrics
+        self.stream_logs = stream_logs
+
+        self.temp_dir = tempfile.TemporaryDirectory()
+
+        # Check if ClearML task already exists (e.g. in pipeline)
+        if clearml.Task.current_task():
+            self.task = clearml.Task.current_task()
+        else:
+            self.task = clearml.Task.init(
+                task_type=self.task_type,
+                project_name=self.project_name,
+                tags=self.tags,
+                task_name=self.task_name,
+                output_uri=True,
+            )
+        self.logger = self.task.get_logger()
+        warning = (
+            "The clearml callback is currently in beta and is subject to change "
+            "based on updates to `langchain`. Please report any issues to "
+            "https://github.com/allegroai/clearml/issues with the tag `langchain`."
+        )
+        self.logger.report_text(warning, level=30, print_console=True)
+        self.callback_columns: list = []
+        self.action_records: list = []
+        self.complexity_metrics = complexity_metrics
+        self.visualize = visualize
+        self.nlp = spacy.load("en_core_web_sm")
+
+    def _init_resp(self) -> Dict:
+        return {k: None for k in self.callback_columns}
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """Run when LLM starts."""
+        self.step += 1
+        self.llm_starts += 1
+        self.starts += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_llm_start"})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.get_custom_callback_meta())
+
+        for prompt in prompts:
+            prompt_resp = deepcopy(resp)
+            prompt_resp["prompts"] = prompt
+            self.on_llm_start_records.append(prompt_resp)
+            self.action_records.append(prompt_resp)
+            if self.stream_logs:
+                self.logger.report_text(prompt_resp)
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Run when LLM generates a new token."""
+        self.step += 1
+        self.llm_streams += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_llm_new_token", "token": token})
+        resp.update(self.get_custom_callback_meta())
+
+        self.on_llm_token_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.logger.report_text(resp)
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Run when LLM ends running."""
+        self.step += 1
+        self.llm_ends += 1
+        self.ends += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_llm_end"})
+        resp.update(flatten_dict(response.llm_output or {}))
+        resp.update(self.get_custom_callback_meta())
+
+        for generations in response.generations:
+            for generation in generations:
+                generation_resp = deepcopy(resp)
+                generation_resp.update(flatten_dict(generation.dict()))
+                generation_resp.update(self.analyze_text(generation.text))
+                self.on_llm_end_records.append(generation_resp)
+                self.action_records.append(generation_resp)
+                if self.stream_logs:
+                    self.logger.report_text(generation_resp)
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when LLM errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Run when chain starts running."""
+        self.step += 1
+        self.chain_starts += 1
+        self.starts += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_chain_start"})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.get_custom_callback_meta())
+
+        chain_input = inputs.get("input", inputs.get("human_input"))
+
+        if isinstance(chain_input, str):
+            input_resp = deepcopy(resp)
+            input_resp["input"] = chain_input
+            self.on_chain_start_records.append(input_resp)
+            self.action_records.append(input_resp)
+            if self.stream_logs:
+                self.logger.report_text(input_resp)
+        elif isinstance(chain_input, list):
+            for inp in chain_input:
+                input_resp = deepcopy(resp)
+                input_resp.update(inp)
+                self.on_chain_start_records.append(input_resp)
+                self.action_records.append(input_resp)
+                if self.stream_logs:
+                    self.logger.report_text(input_resp)
+        else:
+            raise ValueError("Unexpected data format provided!")
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Run when chain ends running."""
+        self.step += 1
+        self.chain_ends += 1
+        self.ends += 1
+
+        resp = self._init_resp()
+        resp.update(
+            {
+                "action": "on_chain_end",
+                "outputs": outputs.get("output", outputs.get("text")),
+            }
+        )
+        resp.update(self.get_custom_callback_meta())
+
+        self.on_chain_end_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.logger.report_text(resp)
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when chain errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_tool_start(
+        self, serialized: Dict[str, Any], input_str: str, **kwargs: Any
+    ) -> None:
+        """Run when tool starts running."""
+        self.step += 1
+        self.tool_starts += 1
+        self.starts += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_tool_start", "input_str": input_str})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.get_custom_callback_meta())
+
+        self.on_tool_start_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.logger.report_text(resp)
+
+    def on_tool_end(self, output: Any, **kwargs: Any) -> None:
+        """Run when tool ends running."""
+        output = str(output)
+        self.step += 1
+        self.tool_ends += 1
+        self.ends += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_tool_end", "output": output})
+        resp.update(self.get_custom_callback_meta())
+
+        self.on_tool_end_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.logger.report_text(resp)
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when tool errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        """
+        Run when agent is ending.
+        """
+        self.step += 1
+        self.text_ctr += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_text", "text": text})
+        resp.update(self.get_custom_callback_meta())
+
+        self.on_text_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.logger.report_text(resp)
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        """Run when agent ends running."""
+        self.step += 1
+        self.agent_ends += 1
+        self.ends += 1
+
+        resp = self._init_resp()
+        resp.update(
+            {
+                "action": "on_agent_finish",
+                "output": finish.return_values["output"],
+                "log": finish.log,
+            }
+        )
+        resp.update(self.get_custom_callback_meta())
+
+        self.on_agent_finish_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.logger.report_text(resp)
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Run on agent action."""
+        self.step += 1
+        self.tool_starts += 1
+        self.starts += 1
+
+        resp = self._init_resp()
+        resp.update(
+            {
+                "action": "on_agent_action",
+                "tool": action.tool,
+                "tool_input": action.tool_input,
+                "log": action.log,
+            }
+        )
+        resp.update(self.get_custom_callback_meta())
+        self.on_agent_action_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.logger.report_text(resp)
+
+    def analyze_text(self, text: str) -> dict:
+        """Analyze text using textstat and spacy.
+
+        Parameters:
+            text (str): The text to analyze.
+
+        Returns:
+            (dict): A dictionary containing the complexity metrics.
+        """
+        resp = {}
+        textstat = import_textstat()
+        spacy = import_spacy()
+        if self.complexity_metrics:
+            text_complexity_metrics = {
+                "flesch_reading_ease": textstat.flesch_reading_ease(text),
+                "flesch_kincaid_grade": textstat.flesch_kincaid_grade(text),
+                "smog_index": textstat.smog_index(text),
+                "coleman_liau_index": textstat.coleman_liau_index(text),
+                "automated_readability_index": textstat.automated_readability_index(
+                    text
+                ),
+                "dale_chall_readability_score": textstat.dale_chall_readability_score(
+                    text
+                ),
+                "difficult_words": textstat.difficult_words(text),
+                "linsear_write_formula": textstat.linsear_write_formula(text),
+                "gunning_fog": textstat.gunning_fog(text),
+                "text_standard": textstat.text_standard(text),
+                "fernandez_huerta": textstat.fernandez_huerta(text),
+                "szigriszt_pazos": textstat.szigriszt_pazos(text),
+                "gutierrez_polini": textstat.gutierrez_polini(text),
+                "crawford": textstat.crawford(text),
+                "gulpease_index": textstat.gulpease_index(text),
+                "osman": textstat.osman(text),
+            }
+            resp.update(text_complexity_metrics)
+
+        if self.visualize and self.nlp and self.temp_dir.name is not None:
+            doc = self.nlp(text)
+
+            dep_out = spacy.displacy.render(doc, style="dep", jupyter=False, page=True)
+            dep_output_path = Path(
+                self.temp_dir.name, hash_string(f"dep-{text}") + ".html"
+            )
+            dep_output_path.open("w", encoding="utf-8").write(dep_out)
+
+            ent_out = spacy.displacy.render(doc, style="ent", jupyter=False, page=True)
+            ent_output_path = Path(
+                self.temp_dir.name, hash_string(f"ent-{text}") + ".html"
+            )
+            ent_output_path.open("w", encoding="utf-8").write(ent_out)
+
+            self.logger.report_media(
+                "Dependencies Plot", text, local_path=dep_output_path
+            )
+            self.logger.report_media("Entities Plot", text, local_path=ent_output_path)
+
+        return resp
+
+    @staticmethod
+    def _build_llm_df(
+        base_df: pd.DataFrame, base_df_fields: Sequence, rename_map: Mapping
+    ) -> pd.DataFrame:
+        base_df_fields = [field for field in base_df_fields if field in base_df]
+        rename_map = {
+            map_entry_k: map_entry_v
+            for map_entry_k, map_entry_v in rename_map.items()
+            if map_entry_k in base_df_fields
+        }
+        llm_df = base_df[base_df_fields].dropna(axis=1)
+        if rename_map:
+            llm_df = llm_df.rename(rename_map, axis=1)
+        return llm_df
+
+    def _create_session_analysis_df(self) -> Any:
+        """Create a dataframe with all the information from the session."""
+        pd = import_pandas()
+        on_llm_end_records_df = pd.DataFrame(self.on_llm_end_records)
+
+        llm_input_prompts_df = ClearMLCallbackHandler._build_llm_df(
+            base_df=on_llm_end_records_df,
+            base_df_fields=["step", "prompts"]
+            + (["name"] if "name" in on_llm_end_records_df else ["id"]),
+            rename_map={"step": "prompt_step"},
+        )
+        complexity_metrics_columns = []
+        visualizations_columns: List = []
+
+        if self.complexity_metrics:
+            complexity_metrics_columns = [
+                "flesch_reading_ease",
+                "flesch_kincaid_grade",
+                "smog_index",
+                "coleman_liau_index",
+                "automated_readability_index",
+                "dale_chall_readability_score",
+                "difficult_words",
+                "linsear_write_formula",
+                "gunning_fog",
+                "text_standard",
+                "fernandez_huerta",
+                "szigriszt_pazos",
+                "gutierrez_polini",
+                "crawford",
+                "gulpease_index",
+                "osman",
+            ]
+
+        llm_outputs_df = ClearMLCallbackHandler._build_llm_df(
+            on_llm_end_records_df,
+            [
+                "step",
+                "text",
+                "token_usage_total_tokens",
+                "token_usage_prompt_tokens",
+                "token_usage_completion_tokens",
+            ]
+            + complexity_metrics_columns
+            + visualizations_columns,
+            {"step": "output_step", "text": "output"},
+        )
+        session_analysis_df = pd.concat([llm_input_prompts_df, llm_outputs_df], axis=1)
+        return session_analysis_df
+
+    def flush_tracker(
+        self,
+        name: Optional[str] = None,
+        langchain_asset: Any = None,
+        finish: bool = False,
+    ) -> None:
+        """Flush the tracker and setup the session.
+
+        Everything after this will be a new table.
+
+        Args:
+            name: Name of the performed session so far so it is identifiable
+            langchain_asset: The langchain asset to save.
+            finish: Whether to finish the run.
+
+            Returns:
+                None
+        """
+        pd = import_pandas()
+        clearml = import_clearml()
+
+        # Log the action records
+        self.logger.report_table(
+            "Action Records", name, table_plot=pd.DataFrame(self.action_records)
+        )
+
+        # Session analysis
+        session_analysis_df = self._create_session_analysis_df()
+        self.logger.report_table(
+            "Session Analysis", name, table_plot=session_analysis_df
+        )
+
+        if self.stream_logs:
+            self.logger.report_text(
+                {
+                    "action_records": pd.DataFrame(self.action_records),
+                    "session_analysis": session_analysis_df,
+                }
+            )
+
+        if langchain_asset:
+            langchain_asset_path = Path(self.temp_dir.name, "model.json")
+            try:
+                langchain_asset.save(langchain_asset_path)
+                # Create output model and connect it to the task
+                output_model = clearml.OutputModel(
+                    task=self.task, config_text=load_json(langchain_asset_path)
+                )
+                output_model.update_weights(
+                    weights_filename=str(langchain_asset_path),
+                    auto_delete_file=False,
+                    target_filename=name,
+                )
+            except ValueError:
+                langchain_asset.save_agent(langchain_asset_path)
+                output_model = clearml.OutputModel(
+                    task=self.task, config_text=load_json(langchain_asset_path)
+                )
+                output_model.update_weights(
+                    weights_filename=str(langchain_asset_path),
+                    auto_delete_file=False,
+                    target_filename=name,
+                )
+            except NotImplementedError as e:
+                print("Could not save model.")  # noqa: T201
+                print(repr(e))  # noqa: T201
+                pass
+
+        # Cleanup after adding everything to ClearML
+        self.task.flush(wait_for_uploads=True)
+        self.temp_dir.cleanup()
+        self.temp_dir = tempfile.TemporaryDirectory()
+        self.reset_callback_meta()
+
+        if finish:
+            self.task.close()
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/comet_ml_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/comet_ml_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7e4e918d0c0b93af7fd90dcb2f941a1fcab6bc3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/comet_ml_callback.py
@@ -0,0 +1,646 @@
+import tempfile
+from copy import deepcopy
+from pathlib import Path
+from typing import Any, Callable, Dict, List, Optional, Sequence
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.outputs import Generation, LLMResult
+
+import langchain_community
+from langchain_community.callbacks.utils import (
+    BaseMetadataCallbackHandler,
+    flatten_dict,
+    import_pandas,
+    import_spacy,
+    import_textstat,
+)
+
+LANGCHAIN_MODEL_NAME = "langchain-model"
+
+
+def import_comet_ml() -> Any:
+    """Import comet_ml and raise an error if it is not installed."""
+    try:
+        import comet_ml  # noqa: F401
+    except ImportError:
+        raise ImportError(
+            "To use the comet_ml callback manager you need to have the "
+            "`comet_ml` python package installed. Please install it with"
+            " `pip install comet_ml`"
+        )
+    return comet_ml
+
+
+def _get_experiment(
+    workspace: Optional[str] = None, project_name: Optional[str] = None
+) -> Any:
+    comet_ml = import_comet_ml()
+
+    experiment = comet_ml.Experiment(
+        workspace=workspace,
+        project_name=project_name,
+    )
+
+    return experiment
+
+
+def _fetch_text_complexity_metrics(text: str) -> dict:
+    textstat = import_textstat()
+    text_complexity_metrics = {
+        "flesch_reading_ease": textstat.flesch_reading_ease(text),
+        "flesch_kincaid_grade": textstat.flesch_kincaid_grade(text),
+        "smog_index": textstat.smog_index(text),
+        "coleman_liau_index": textstat.coleman_liau_index(text),
+        "automated_readability_index": textstat.automated_readability_index(text),
+        "dale_chall_readability_score": textstat.dale_chall_readability_score(text),
+        "difficult_words": textstat.difficult_words(text),
+        "linsear_write_formula": textstat.linsear_write_formula(text),
+        "gunning_fog": textstat.gunning_fog(text),
+        "text_standard": textstat.text_standard(text),
+        "fernandez_huerta": textstat.fernandez_huerta(text),
+        "szigriszt_pazos": textstat.szigriszt_pazos(text),
+        "gutierrez_polini": textstat.gutierrez_polini(text),
+        "crawford": textstat.crawford(text),
+        "gulpease_index": textstat.gulpease_index(text),
+        "osman": textstat.osman(text),
+    }
+    return text_complexity_metrics
+
+
+def _summarize_metrics_for_generated_outputs(metrics: Sequence) -> dict:
+    pd = import_pandas()
+    metrics_df = pd.DataFrame(metrics)
+    metrics_summary = metrics_df.describe()
+
+    return metrics_summary.to_dict()
+
+
+class CometCallbackHandler(BaseMetadataCallbackHandler, BaseCallbackHandler):
+    """Callback Handler that logs to Comet.
+
+    Parameters:
+        job_type (str): The type of comet_ml task such as "inference",
+            "testing" or "qc"
+        project_name (str): The comet_ml project name
+        tags (list): Tags to add to the task
+        task_name (str): Name of the comet_ml task
+        visualize (bool): Whether to visualize the run.
+        complexity_metrics (bool): Whether to log complexity metrics
+        stream_logs (bool): Whether to stream callback actions to Comet
+
+    This handler will utilize the associated callback method and formats
+    the input of each callback function with metadata regarding the state of LLM run,
+    and adds the response to the list of records for both the {method}_records and
+    action. It then logs the response to Comet.
+    """
+
+    def __init__(
+        self,
+        task_type: Optional[str] = "inference",
+        workspace: Optional[str] = None,
+        project_name: Optional[str] = None,
+        tags: Optional[Sequence] = None,
+        name: Optional[str] = None,
+        visualizations: Optional[List[str]] = None,
+        complexity_metrics: bool = False,
+        custom_metrics: Optional[Callable] = None,
+        stream_logs: bool = True,
+    ) -> None:
+        """Initialize callback handler."""
+
+        self.comet_ml = import_comet_ml()
+        super().__init__()
+
+        self.task_type = task_type
+        self.workspace = workspace
+        self.project_name = project_name
+        self.tags = tags
+        self.visualizations = visualizations
+        self.complexity_metrics = complexity_metrics
+        self.custom_metrics = custom_metrics
+        self.stream_logs = stream_logs
+        self.temp_dir = tempfile.TemporaryDirectory()
+
+        self.experiment = _get_experiment(workspace, project_name)
+        self.experiment.log_other("Created from", "langchain")
+        if tags:
+            self.experiment.add_tags(tags)
+        self.name = name
+        if self.name:
+            self.experiment.set_name(self.name)
+
+        warning = (
+            "The comet_ml callback is currently in beta and is subject to change "
+            "based on updates to `langchain`. Please report any issues to "
+            "https://github.com/comet-ml/issue-tracking/issues with the tag "
+            "`langchain`."
+        )
+        self.comet_ml.LOGGER.warning(warning)
+
+        self.callback_columns: list = []
+        self.action_records: list = []
+        self.complexity_metrics = complexity_metrics
+        if self.visualizations:
+            spacy = import_spacy()
+            self.nlp = spacy.load("en_core_web_sm")
+        else:
+            self.nlp = None
+
+    def _init_resp(self) -> Dict:
+        return {k: None for k in self.callback_columns}
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """Run when LLM starts."""
+        self.step += 1
+        self.llm_starts += 1
+        self.starts += 1
+
+        metadata = self._init_resp()
+        metadata.update({"action": "on_llm_start"})
+        metadata.update(flatten_dict(serialized))
+        metadata.update(self.get_custom_callback_meta())
+
+        for prompt in prompts:
+            prompt_resp = deepcopy(metadata)
+            prompt_resp["prompts"] = prompt
+            self.on_llm_start_records.append(prompt_resp)
+            self.action_records.append(prompt_resp)
+
+            if self.stream_logs:
+                self._log_stream(prompt, metadata, self.step)
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Run when LLM generates a new token."""
+        self.step += 1
+        self.llm_streams += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_llm_new_token", "token": token})
+        resp.update(self.get_custom_callback_meta())
+
+        self.action_records.append(resp)
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Run when LLM ends running."""
+        self.step += 1
+        self.llm_ends += 1
+        self.ends += 1
+
+        metadata = self._init_resp()
+        metadata.update({"action": "on_llm_end"})
+        metadata.update(flatten_dict(response.llm_output or {}))
+        metadata.update(self.get_custom_callback_meta())
+
+        output_complexity_metrics = []
+        output_custom_metrics = []
+
+        for prompt_idx, generations in enumerate(response.generations):
+            for gen_idx, generation in enumerate(generations):
+                text = generation.text
+
+                generation_resp = deepcopy(metadata)
+                generation_resp.update(flatten_dict(generation.dict()))
+
+                complexity_metrics = self._get_complexity_metrics(text)
+                if complexity_metrics:
+                    output_complexity_metrics.append(complexity_metrics)
+                    generation_resp.update(complexity_metrics)
+
+                custom_metrics = self._get_custom_metrics(
+                    generation, prompt_idx, gen_idx
+                )
+                if custom_metrics:
+                    output_custom_metrics.append(custom_metrics)
+                    generation_resp.update(custom_metrics)
+
+                if self.stream_logs:
+                    self._log_stream(text, metadata, self.step)
+
+                self.action_records.append(generation_resp)
+                self.on_llm_end_records.append(generation_resp)
+
+        self._log_text_metrics(output_complexity_metrics, step=self.step)
+        self._log_text_metrics(output_custom_metrics, step=self.step)
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when LLM errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Run when chain starts running."""
+        self.step += 1
+        self.chain_starts += 1
+        self.starts += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_chain_start"})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.get_custom_callback_meta())
+
+        for chain_input_key, chain_input_val in inputs.items():
+            if isinstance(chain_input_val, str):
+                input_resp = deepcopy(resp)
+                if self.stream_logs:
+                    self._log_stream(chain_input_val, resp, self.step)
+                input_resp.update({chain_input_key: chain_input_val})
+                self.action_records.append(input_resp)
+
+            else:
+                self.comet_ml.LOGGER.warning(
+                    f"Unexpected data format provided! "
+                    f"Input Value for {chain_input_key} will not be logged"
+                )
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Run when chain ends running."""
+        self.step += 1
+        self.chain_ends += 1
+        self.ends += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_chain_end"})
+        resp.update(self.get_custom_callback_meta())
+
+        for chain_output_key, chain_output_val in outputs.items():
+            if isinstance(chain_output_val, str):
+                output_resp = deepcopy(resp)
+                if self.stream_logs:
+                    self._log_stream(chain_output_val, resp, self.step)
+                output_resp.update({chain_output_key: chain_output_val})
+                self.action_records.append(output_resp)
+            else:
+                self.comet_ml.LOGGER.warning(
+                    f"Unexpected data format provided! "
+                    f"Output Value for {chain_output_key} will not be logged"
+                )
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when chain errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_tool_start(
+        self, serialized: Dict[str, Any], input_str: str, **kwargs: Any
+    ) -> None:
+        """Run when tool starts running."""
+        self.step += 1
+        self.tool_starts += 1
+        self.starts += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_tool_start"})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.get_custom_callback_meta())
+        if self.stream_logs:
+            self._log_stream(input_str, resp, self.step)
+
+        resp.update({"input_str": input_str})
+        self.action_records.append(resp)
+
+    def on_tool_end(self, output: Any, **kwargs: Any) -> None:
+        """Run when tool ends running."""
+        output = str(output)
+        self.step += 1
+        self.tool_ends += 1
+        self.ends += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_tool_end"})
+        resp.update(self.get_custom_callback_meta())
+        if self.stream_logs:
+            self._log_stream(output, resp, self.step)
+
+        resp.update({"output": output})
+        self.action_records.append(resp)
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when tool errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        """
+        Run when agent is ending.
+        """
+        self.step += 1
+        self.text_ctr += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_text"})
+        resp.update(self.get_custom_callback_meta())
+        if self.stream_logs:
+            self._log_stream(text, resp, self.step)
+
+        resp.update({"text": text})
+        self.action_records.append(resp)
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        """Run when agent ends running."""
+        self.step += 1
+        self.agent_ends += 1
+        self.ends += 1
+
+        resp = self._init_resp()
+        output = finish.return_values["output"]
+        log = finish.log
+
+        resp.update({"action": "on_agent_finish", "log": log})
+        resp.update(self.get_custom_callback_meta())
+        if self.stream_logs:
+            self._log_stream(output, resp, self.step)
+
+        resp.update({"output": output})
+        self.action_records.append(resp)
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Run on agent action."""
+        self.step += 1
+        self.tool_starts += 1
+        self.starts += 1
+
+        tool = action.tool
+        tool_input = str(action.tool_input)
+        log = action.log
+
+        resp = self._init_resp()
+        resp.update({"action": "on_agent_action", "log": log, "tool": tool})
+        resp.update(self.get_custom_callback_meta())
+        if self.stream_logs:
+            self._log_stream(tool_input, resp, self.step)
+
+        resp.update({"tool_input": tool_input})
+        self.action_records.append(resp)
+
+    def _get_complexity_metrics(self, text: str) -> dict:
+        """Compute text complexity metrics using textstat.
+
+        Parameters:
+            text (str): The text to analyze.
+
+        Returns:
+            (dict): A dictionary containing the complexity metrics.
+        """
+        resp = {}
+        if self.complexity_metrics:
+            text_complexity_metrics = _fetch_text_complexity_metrics(text)
+            resp.update(text_complexity_metrics)
+
+        return resp
+
+    def _get_custom_metrics(
+        self, generation: Generation, prompt_idx: int, gen_idx: int
+    ) -> dict:
+        """Compute Custom Metrics for an LLM Generated Output
+
+        Args:
+            generation (LLMResult): Output generation from an LLM
+            prompt_idx (int): List index of the input prompt
+            gen_idx (int): List index of the generated output
+
+        Returns:
+            dict: A dictionary containing the custom metrics.
+        """
+
+        resp = {}
+        if self.custom_metrics:
+            custom_metrics = self.custom_metrics(generation, prompt_idx, gen_idx)
+            resp.update(custom_metrics)
+
+        return resp
+
+    def flush_tracker(
+        self,
+        langchain_asset: Any = None,
+        task_type: Optional[str] = "inference",
+        workspace: Optional[str] = None,
+        project_name: Optional[str] = "comet-langchain-demo",
+        tags: Optional[Sequence] = None,
+        name: Optional[str] = None,
+        visualizations: Optional[List[str]] = None,
+        complexity_metrics: bool = False,
+        custom_metrics: Optional[Callable] = None,
+        finish: bool = False,
+        reset: bool = False,
+    ) -> None:
+        """Flush the tracker and setup the session.
+
+        Everything after this will be a new table.
+
+        Args:
+            name: Name of the performed session so far so it is identifiable
+            langchain_asset: The langchain asset to save.
+            finish: Whether to finish the run.
+
+            Returns:
+                None
+        """
+        self._log_session(langchain_asset)
+
+        if langchain_asset:
+            try:
+                self._log_model(langchain_asset)
+            except Exception:
+                self.comet_ml.LOGGER.error(
+                    "Failed to export agent or LLM to Comet",
+                    exc_info=True,
+                    extra={"show_traceback": True},
+                )
+
+        if finish:
+            self.experiment.end()
+
+        if reset:
+            self._reset(
+                task_type,
+                workspace,
+                project_name,
+                tags,
+                name,
+                visualizations,
+                complexity_metrics,
+                custom_metrics,
+            )
+
+    def _log_stream(self, prompt: str, metadata: dict, step: int) -> None:
+        self.experiment.log_text(prompt, metadata=metadata, step=step)
+
+    def _log_model(self, langchain_asset: Any) -> None:
+        model_parameters = self._get_llm_parameters(langchain_asset)
+        self.experiment.log_parameters(model_parameters, prefix="model")
+
+        langchain_asset_path = Path(self.temp_dir.name, "model.json")
+        model_name = self.name if self.name else LANGCHAIN_MODEL_NAME
+
+        try:
+            if hasattr(langchain_asset, "save"):
+                langchain_asset.save(langchain_asset_path)
+                self.experiment.log_model(model_name, str(langchain_asset_path))
+        except (ValueError, AttributeError, NotImplementedError) as e:
+            if hasattr(langchain_asset, "save_agent"):
+                langchain_asset.save_agent(langchain_asset_path)
+                self.experiment.log_model(model_name, str(langchain_asset_path))
+            else:
+                self.comet_ml.LOGGER.error(
+                    f"{e}"
+                    " Could not save Langchain Asset "
+                    f"for {langchain_asset.__class__.__name__}"
+                )
+
+    def _log_session(self, langchain_asset: Optional[Any] = None) -> None:
+        try:
+            llm_session_df = self._create_session_analysis_dataframe(langchain_asset)
+            # Log the cleaned dataframe as a table
+            self.experiment.log_table("langchain-llm-session.csv", llm_session_df)
+        except Exception:
+            self.comet_ml.LOGGER.warning(
+                "Failed to log session data to Comet",
+                exc_info=True,
+                extra={"show_traceback": True},
+            )
+
+        try:
+            metadata = {"langchain_version": str(langchain_community.__version__)}
+            # Log the langchain low-level records as a JSON file directly
+            self.experiment.log_asset_data(
+                self.action_records, "langchain-action_records.json", metadata=metadata
+            )
+        except Exception:
+            self.comet_ml.LOGGER.warning(
+                "Failed to log session data to Comet",
+                exc_info=True,
+                extra={"show_traceback": True},
+            )
+
+        try:
+            self._log_visualizations(llm_session_df)
+        except Exception:
+            self.comet_ml.LOGGER.warning(
+                "Failed to log visualizations to Comet",
+                exc_info=True,
+                extra={"show_traceback": True},
+            )
+
+    def _log_text_metrics(self, metrics: Sequence[dict], step: int) -> None:
+        if not metrics:
+            return
+
+        metrics_summary = _summarize_metrics_for_generated_outputs(metrics)
+        for key, value in metrics_summary.items():
+            self.experiment.log_metrics(value, prefix=key, step=step)
+
+    def _log_visualizations(self, session_df: Any) -> None:
+        if not (self.visualizations and self.nlp):
+            return
+
+        spacy = import_spacy()
+
+        prompts = session_df["prompts"].tolist()
+        outputs = session_df["text"].tolist()
+
+        for idx, (prompt, output) in enumerate(zip(prompts, outputs)):
+            doc = self.nlp(output)
+            sentence_spans = list(doc.sents)
+
+            for visualization in self.visualizations:
+                try:
+                    html = spacy.displacy.render(
+                        sentence_spans,
+                        style=visualization,
+                        options={"compact": True},
+                        jupyter=False,
+                        page=True,
+                    )
+                    self.experiment.log_asset_data(
+                        html,
+                        name=f"langchain-viz-{visualization}-{idx}.html",
+                        metadata={"prompt": prompt},
+                        step=idx,
+                    )
+                except Exception as e:
+                    self.comet_ml.LOGGER.warning(
+                        e, exc_info=True, extra={"show_traceback": True}
+                    )
+
+        return
+
+    def _reset(
+        self,
+        task_type: Optional[str] = None,
+        workspace: Optional[str] = None,
+        project_name: Optional[str] = None,
+        tags: Optional[Sequence] = None,
+        name: Optional[str] = None,
+        visualizations: Optional[List[str]] = None,
+        complexity_metrics: bool = False,
+        custom_metrics: Optional[Callable] = None,
+    ) -> None:
+        _task_type = task_type if task_type else self.task_type
+        _workspace = workspace if workspace else self.workspace
+        _project_name = project_name if project_name else self.project_name
+        _tags = tags if tags else self.tags
+        _name = name if name else self.name
+        _visualizations = visualizations if visualizations else self.visualizations
+        _complexity_metrics = (
+            complexity_metrics if complexity_metrics else self.complexity_metrics
+        )
+        _custom_metrics = custom_metrics if custom_metrics else self.custom_metrics
+
+        self.__init__(  # type: ignore
+            task_type=_task_type,
+            workspace=_workspace,
+            project_name=_project_name,
+            tags=_tags,
+            name=_name,
+            visualizations=_visualizations,
+            complexity_metrics=_complexity_metrics,
+            custom_metrics=_custom_metrics,
+        )
+
+        self.reset_callback_meta()
+        self.temp_dir = tempfile.TemporaryDirectory()
+
+    def _create_session_analysis_dataframe(self, langchain_asset: Any = None) -> dict:
+        pd = import_pandas()
+
+        llm_parameters = self._get_llm_parameters(langchain_asset)
+        num_generations_per_prompt = llm_parameters.get("n", 1)
+
+        llm_start_records_df = pd.DataFrame(self.on_llm_start_records)
+        # Repeat each input row based on the number of outputs generated per prompt
+        llm_start_records_df = llm_start_records_df.loc[
+            llm_start_records_df.index.repeat(num_generations_per_prompt)
+        ].reset_index(drop=True)
+        llm_end_records_df = pd.DataFrame(self.on_llm_end_records)
+
+        llm_session_df = pd.merge(
+            llm_start_records_df,
+            llm_end_records_df,
+            left_index=True,
+            right_index=True,
+            suffixes=["_llm_start", "_llm_end"],
+        )
+
+        return llm_session_df
+
+    def _get_llm_parameters(self, langchain_asset: Any = None) -> dict:
+        if not langchain_asset:
+            return {}
+        try:
+            if hasattr(langchain_asset, "agent"):
+                llm_parameters = langchain_asset.agent.llm_chain.llm.dict()
+            elif hasattr(langchain_asset, "llm_chain"):
+                llm_parameters = langchain_asset.llm_chain.llm.dict()
+            elif hasattr(langchain_asset, "llm"):
+                llm_parameters = langchain_asset.llm.dict()
+            else:
+                llm_parameters = langchain_asset.dict()
+        except Exception:
+            return {}
+
+        return llm_parameters
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/confident_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/confident_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..b078abf45074c3912625389d374ae325fa0c68d0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/confident_callback.py
@@ -0,0 +1,183 @@
+# flake8: noqa
+import os
+import warnings
+from typing import Any, Dict, List, Optional, Union
+
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.outputs import LLMResult
+
+
+class DeepEvalCallbackHandler(BaseCallbackHandler):
+    """Callback Handler that logs into deepeval.
+
+    Args:
+        implementation_name: name of the `implementation` in deepeval
+        metrics: A list of metrics
+
+    Raises:
+        ImportError: if the `deepeval` package is not installed.
+
+    Examples:
+        >>> from langchain_community.llms import OpenAI
+        >>> from langchain_community.callbacks import DeepEvalCallbackHandler
+        >>> from deepeval.metrics import AnswerRelevancy
+        >>> metric = AnswerRelevancy(minimum_score=0.3)
+        >>> deepeval_callback = DeepEvalCallbackHandler(
+        ...     implementation_name="exampleImplementation",
+        ...     metrics=[metric],
+        ... )
+        >>> llm = OpenAI(
+        ...     temperature=0,
+        ...     callbacks=[deepeval_callback],
+        ...     verbose=True,
+        ...     openai_api_key="API_KEY_HERE",
+        ... )
+        >>> llm.generate([
+        ...     "What is the best evaluation tool out there? (no bias at all)",
+        ... ])
+        "Deepeval, no doubt about it."
+    """
+
+    REPO_URL: str = "https://github.com/confident-ai/deepeval"
+    ISSUES_URL: str = f"{REPO_URL}/issues"
+    BLOG_URL: str = "https://docs.confident-ai.com"  # noqa: E501
+
+    def __init__(
+        self,
+        metrics: List[Any],
+        implementation_name: Optional[str] = None,
+    ) -> None:
+        """Initializes the `deepevalCallbackHandler`.
+
+        Args:
+            implementation_name: Name of the implementation you want.
+            metrics: What metrics do you want to track?
+
+        Raises:
+            ImportError: if the `deepeval` package is not installed.
+            ConnectionError: if the connection to deepeval fails.
+        """
+
+        super().__init__()
+
+        # Import deepeval (not via `import_deepeval` to keep hints in IDEs)
+        try:
+            import deepeval  # ignore: F401,I001
+        except ImportError:
+            raise ImportError(
+                """To use the deepeval callback manager you need to have the 
+                `deepeval` Python package installed. Please install it with 
+                `pip install deepeval`"""
+            )
+
+        if os.path.exists(".deepeval"):
+            warnings.warn(
+                """You are currently not logging anything to the dashboard, we 
+                recommend using `deepeval login`."""
+            )
+
+        # Set the deepeval variables
+        self.implementation_name = implementation_name
+        self.metrics = metrics
+
+        warnings.warn(
+            (
+                "The `DeepEvalCallbackHandler` is currently in beta and is subject to"
+                " change based on updates to `langchain`. Please report any issues to"
+                f" {self.ISSUES_URL} as an `integration` issue."
+            ),
+        )
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """Store the prompts"""
+        self.prompts = prompts
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Do nothing when a new token is generated."""
+        pass
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Log records to deepeval when an LLM ends."""
+        from deepeval.metrics.answer_relevancy import AnswerRelevancy
+        from deepeval.metrics.bias_classifier import UnBiasedMetric
+        from deepeval.metrics.metric import Metric
+        from deepeval.metrics.toxic_classifier import NonToxicMetric
+
+        for metric in self.metrics:
+            for i, generation in enumerate(response.generations):
+                # Here, we only measure the first generation's output
+                output = generation[0].text
+                query = self.prompts[i]
+                if isinstance(metric, AnswerRelevancy):
+                    result = metric.measure(
+                        output=output,
+                        query=query,
+                    )
+                    print(f"Answer Relevancy: {result}")  # noqa: T201
+                elif isinstance(metric, UnBiasedMetric):
+                    score = metric.measure(output)
+                    print(f"Bias Score: {score}")  # noqa: T201
+                elif isinstance(metric, NonToxicMetric):
+                    score = metric.measure(output)
+                    print(f"Toxic Score: {score}")  # noqa: T201
+                else:
+                    raise ValueError(
+                        f"""Metric {metric.__name__} is not supported by deepeval 
+                        callbacks."""
+                    )
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing when LLM outputs an error."""
+        pass
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Do nothing when chain starts"""
+        pass
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Do nothing when chain ends."""
+        pass
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing when LLM chain outputs an error."""
+        pass
+
+    def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        **kwargs: Any,
+    ) -> None:
+        """Do nothing when tool starts."""
+        pass
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Do nothing when agent takes a specific action."""
+        pass
+
+    def on_tool_end(
+        self,
+        output: Any,
+        observation_prefix: Optional[str] = None,
+        llm_prefix: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Do nothing when tool ends."""
+        pass
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing when tool outputs an error."""
+        pass
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        """Do nothing"""
+        pass
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        """Do nothing"""
+        pass
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/context_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/context_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..8514976687d1d77bec388d65b5f4c35333a2ddc5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/context_callback.py
@@ -0,0 +1,194 @@
+"""Callback handler for Context AI"""
+import os
+from typing import Any, Dict, List
+from uuid import UUID
+
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.messages import BaseMessage
+from langchain_core.outputs import LLMResult
+
+
+def import_context() -> Any:
+    """Import the `getcontext` package."""
+    try:
+        import getcontext  # noqa: F401
+        from getcontext.generated.models import (
+            Conversation,
+            Message,
+            MessageRole,
+            Rating,
+        )
+        from getcontext.token import Credential  # noqa: F401
+    except ImportError:
+        raise ImportError(
+            "To use the context callback manager you need to have the "
+            "`getcontext` python package installed (version >=0.3.0). "
+            "Please install it with `pip install --upgrade python-context`"
+        )
+    return getcontext, Credential, Conversation, Message, MessageRole, Rating
+
+
+class ContextCallbackHandler(BaseCallbackHandler):
+    """Callback Handler that records transcripts to the Context service.
+
+     (https://context.ai).
+
+    Keyword Args:
+        token (optional): The token with which to authenticate requests to Context.
+            Visit https://with.context.ai/settings to generate a token.
+            If not provided, the value of the `CONTEXT_TOKEN` environment
+            variable will be used.
+
+    Raises:
+        ImportError: if the `context-python` package is not installed.
+
+    Chat Example:
+        >>> from langchain_community.llms import ChatOpenAI
+        >>> from langchain_community.callbacks import ContextCallbackHandler
+        >>> context_callback = ContextCallbackHandler(
+        ...     token="<CONTEXT_TOKEN_HERE>",
+        ... )
+        >>> chat = ChatOpenAI(
+        ...     temperature=0,
+        ...     headers={"user_id": "123"},
+        ...     callbacks=[context_callback],
+        ...     openai_api_key="API_KEY_HERE",
+        ... )
+        >>> messages = [
+        ...     SystemMessage(content="You translate English to French."),
+        ...     HumanMessage(content="I love programming with LangChain."),
+        ... ]
+        >>> chat(messages)
+
+    Chain Example:
+        >>> from langchain.chains import LLMChain
+        >>> from langchain_community.chat_models import ChatOpenAI
+        >>> from langchain_community.callbacks import ContextCallbackHandler
+        >>> context_callback = ContextCallbackHandler(
+        ...     token="<CONTEXT_TOKEN_HERE>",
+        ... )
+        >>> human_message_prompt = HumanMessagePromptTemplate(
+        ...     prompt=PromptTemplate(
+        ...         template="What is a good name for a company that makes {product}?",
+        ...         input_variables=["product"],
+        ...    ),
+        ... )
+        >>> chat_prompt_template = ChatPromptTemplate.from_messages(
+        ...   [human_message_prompt]
+        ... )
+        >>> callback = ContextCallbackHandler(token)
+        >>> # Note: the same callback object must be shared between the
+        ...   LLM and the chain.
+        >>> chat = ChatOpenAI(temperature=0.9, callbacks=[callback])
+        >>> chain = LLMChain(
+        ...   llm=chat,
+        ...   prompt=chat_prompt_template,
+        ...   callbacks=[callback]
+        ... )
+        >>> chain.run("colorful socks")
+    """
+
+    def __init__(self, token: str = "", verbose: bool = False, **kwargs: Any) -> None:
+        (
+            self.context,
+            self.credential,
+            self.conversation_model,
+            self.message_model,
+            self.message_role_model,
+            self.rating_model,
+        ) = import_context()
+
+        token = token or os.environ.get("CONTEXT_TOKEN") or ""
+
+        self.client = self.context.ContextAPI(credential=self.credential(token))
+
+        self.chain_run_id = None
+
+        self.llm_model = None
+
+        self.messages: List[Any] = []
+        self.metadata: Dict[str, str] = {}
+
+    def on_chat_model_start(
+        self,
+        serialized: Dict[str, Any],
+        messages: List[List[BaseMessage]],
+        *,
+        run_id: UUID,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when the chat model is started."""
+        llm_model = kwargs.get("invocation_params", {}).get("model", None)
+        if llm_model is not None:
+            self.metadata["model"] = llm_model
+
+        if len(messages) == 0:
+            return
+
+        for message in messages[0]:
+            role = self.message_role_model.SYSTEM
+            if message.type == "human":
+                role = self.message_role_model.USER
+            elif message.type == "system":
+                role = self.message_role_model.SYSTEM
+            elif message.type == "ai":
+                role = self.message_role_model.ASSISTANT
+
+            self.messages.append(
+                self.message_model(
+                    message=message.content,
+                    role=role,
+                )
+            )
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Run when LLM ends."""
+        if len(response.generations) == 0 or len(response.generations[0]) == 0:
+            return
+
+        if not self.chain_run_id:
+            generation = response.generations[0][0]
+            self.messages.append(
+                self.message_model(
+                    message=generation.text,
+                    role=self.message_role_model.ASSISTANT,
+                )
+            )
+
+            self._log_conversation()
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Run when chain starts."""
+        self.chain_run_id = kwargs.get("run_id", None)
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Run when chain ends."""
+        self.messages.append(
+            self.message_model(
+                message=outputs["text"],
+                role=self.message_role_model.ASSISTANT,
+            )
+        )
+
+        self._log_conversation()
+
+        self.chain_run_id = None
+
+    def _log_conversation(self) -> None:
+        """Log the conversation to the context API."""
+        if len(self.messages) == 0:
+            return
+
+        self.client.log.conversation_upsert(
+            body={
+                "conversation": self.conversation_model(
+                    messages=self.messages,
+                    metadata=self.metadata,
+                )
+            }
+        )
+
+        self.messages = []
+        self.metadata = {}
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/fiddler_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/fiddler_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..c8dc9f0494e6d73a8c01f67e6366aeb5c4c0820d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/fiddler_callback.py
@@ -0,0 +1,341 @@
+import time
+from typing import Any, Dict, List, Optional
+from uuid import UUID
+
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.outputs import LLMResult
+
+from langchain_community.callbacks.utils import import_pandas
+
+# Define constants
+
+# LLMResult keys
+TOKEN_USAGE = "token_usage"
+TOTAL_TOKENS = "total_tokens"
+PROMPT_TOKENS = "prompt_tokens"
+COMPLETION_TOKENS = "completion_tokens"
+RUN_ID = "run_id"
+MODEL_NAME = "model_name"
+GOOD = "good"
+BAD = "bad"
+NEUTRAL = "neutral"
+SUCCESS = "success"
+FAILURE = "failure"
+
+# Default values
+DEFAULT_MAX_TOKEN = 65536
+DEFAULT_MAX_DURATION = 120000
+
+# Fiddler specific constants
+PROMPT = "prompt"
+RESPONSE = "response"
+CONTEXT = "context"
+DURATION = "duration"
+FEEDBACK = "feedback"
+LLM_STATUS = "llm_status"
+
+FEEDBACK_POSSIBLE_VALUES = [GOOD, BAD, NEUTRAL]
+
+# Define a dataset dictionary
+_dataset_dict = {
+    PROMPT: ["fiddler"] * 10,
+    RESPONSE: ["fiddler"] * 10,
+    CONTEXT: ["fiddler"] * 10,
+    FEEDBACK: ["good"] * 10,
+    LLM_STATUS: ["success"] * 10,
+    MODEL_NAME: ["fiddler"] * 10,
+    RUN_ID: ["123e4567-e89b-12d3-a456-426614174000"] * 10,
+    TOTAL_TOKENS: [0, DEFAULT_MAX_TOKEN] * 5,
+    PROMPT_TOKENS: [0, DEFAULT_MAX_TOKEN] * 5,
+    COMPLETION_TOKENS: [0, DEFAULT_MAX_TOKEN] * 5,
+    DURATION: [1, DEFAULT_MAX_DURATION] * 5,
+}
+
+
+def import_fiddler() -> Any:
+    """Import the fiddler python package and raise an error if it is not installed."""
+    try:
+        import fiddler  # noqa: F401
+    except ImportError:
+        raise ImportError(
+            "To use fiddler callback handler you need to have `fiddler-client`"
+            "package installed. Please install it with `pip install fiddler-client`"
+        )
+    return fiddler
+
+
+# First, define custom callback handler implementations
+class FiddlerCallbackHandler(BaseCallbackHandler):
+    def __init__(
+        self,
+        url: str,
+        org: str,
+        project: str,
+        model: str,
+        api_key: str,
+    ) -> None:
+        """
+        Initialize Fiddler callback handler.
+
+        Args:
+            url: Fiddler URL (e.g. https://demo.fiddler.ai).
+                Make sure to include the protocol (http/https).
+            org: Fiddler organization id
+            project: Fiddler project name to publish events to
+            model: Fiddler model name to publish events to
+            api_key: Fiddler authentication token
+        """
+        super().__init__()
+        # Initialize Fiddler client and other necessary properties
+        self.fdl = import_fiddler()
+        self.pd = import_pandas()
+
+        self.url = url
+        self.org = org
+        self.project = project
+        self.model = model
+        self.api_key = api_key
+        self._df = self.pd.DataFrame(_dataset_dict)
+
+        self.run_id_prompts: Dict[UUID, List[str]] = {}
+        self.run_id_response: Dict[UUID, List[str]] = {}
+        self.run_id_starttime: Dict[UUID, int] = {}
+
+        # Initialize Fiddler client here
+        self.fiddler_client = self.fdl.FiddlerApi(url, org_id=org, auth_token=api_key)
+
+        if self.project not in self.fiddler_client.get_project_names():
+            print(  # noqa: T201
+                f"adding project {self.project}." "This only has to be done once."
+            )
+            try:
+                self.fiddler_client.add_project(self.project)
+            except Exception as e:
+                print(  # noqa: T201
+                    f"Error adding project {self.project}:"
+                    "{e}. Fiddler integration will not work."
+                )
+                raise e
+
+        dataset_info = self.fdl.DatasetInfo.from_dataframe(
+            self._df, max_inferred_cardinality=0
+        )
+
+        # Set feedback column to categorical
+        for i in range(len(dataset_info.columns)):
+            if dataset_info.columns[i].name == FEEDBACK:
+                dataset_info.columns[i].data_type = self.fdl.DataType.CATEGORY
+                dataset_info.columns[i].possible_values = FEEDBACK_POSSIBLE_VALUES
+
+            elif dataset_info.columns[i].name == LLM_STATUS:
+                dataset_info.columns[i].data_type = self.fdl.DataType.CATEGORY
+                dataset_info.columns[i].possible_values = [SUCCESS, FAILURE]
+
+        if self.model not in self.fiddler_client.get_model_names(self.project):
+            if self.model not in self.fiddler_client.get_dataset_names(self.project):
+                print(  # noqa: T201
+                    f"adding dataset {self.model} to project {self.project}."
+                    "This only has to be done once."
+                )
+                try:
+                    self.fiddler_client.upload_dataset(
+                        project_id=self.project,
+                        dataset_id=self.model,
+                        dataset={"train": self._df},
+                        info=dataset_info,
+                    )
+                except Exception as e:
+                    print(  # noqa: T201
+                        f"Error adding dataset {self.model}: {e}."
+                        "Fiddler integration will not work."
+                    )
+                    raise e
+
+            model_info = self.fdl.ModelInfo.from_dataset_info(
+                dataset_info=dataset_info,
+                dataset_id="train",
+                model_task=self.fdl.ModelTask.LLM,
+                features=[PROMPT, CONTEXT, RESPONSE],
+                target=FEEDBACK,
+                metadata_cols=[
+                    RUN_ID,
+                    TOTAL_TOKENS,
+                    PROMPT_TOKENS,
+                    COMPLETION_TOKENS,
+                    MODEL_NAME,
+                    DURATION,
+                ],
+                custom_features=self.custom_features,
+            )
+            print(  # noqa: T201
+                f"adding model {self.model} to project {self.project}."
+                "This only has to be done once."  # noqa: T201
+            )
+            try:
+                self.fiddler_client.add_model(
+                    project_id=self.project,
+                    dataset_id=self.model,
+                    model_id=self.model,
+                    model_info=model_info,
+                )
+            except Exception as e:
+                print(  # noqa: T201
+                    f"Error adding model {self.model}: {e}."
+                    "Fiddler integration will not work."  # noqa: T201
+                )
+                raise e
+
+    @property
+    def custom_features(self) -> list:
+        """
+        Define custom features for the model to automatically enrich the data with.
+        Here, we enable the following enrichments:
+        - Automatic Embedding generation for prompt and response
+        - Text Statistics such as:
+            - Automated Readability Index
+            - Coleman Liau Index
+            - Dale Chall Readability Score
+            - Difficult Words
+            - Flesch Reading Ease
+            - Flesch Kincaid Grade
+            - Gunning Fog
+            - Linsear Write Formula
+        - PII - Personal Identifiable Information
+        - Sentiment Analysis
+
+        """
+
+        return [
+            self.fdl.Enrichment(
+                name="Prompt Embedding",
+                enrichment="embedding",
+                columns=[PROMPT],
+            ),
+            self.fdl.TextEmbedding(
+                name="Prompt CF",
+                source_column=PROMPT,
+                column="Prompt Embedding",
+            ),
+            self.fdl.Enrichment(
+                name="Response Embedding",
+                enrichment="embedding",
+                columns=[RESPONSE],
+            ),
+            self.fdl.TextEmbedding(
+                name="Response CF",
+                source_column=RESPONSE,
+                column="Response Embedding",
+            ),
+            self.fdl.Enrichment(
+                name="Text Statistics",
+                enrichment="textstat",
+                columns=[PROMPT, RESPONSE],
+                config={
+                    "statistics": [
+                        "automated_readability_index",
+                        "coleman_liau_index",
+                        "dale_chall_readability_score",
+                        "difficult_words",
+                        "flesch_reading_ease",
+                        "flesch_kincaid_grade",
+                        "gunning_fog",
+                        "linsear_write_formula",
+                    ]
+                },
+            ),
+            self.fdl.Enrichment(
+                name="PII",
+                enrichment="pii",
+                columns=[PROMPT, RESPONSE],
+            ),
+            self.fdl.Enrichment(
+                name="Sentiment",
+                enrichment="sentiment",
+                columns=[PROMPT, RESPONSE],
+            ),
+        ]
+
+    def _publish_events(
+        self,
+        run_id: UUID,
+        prompt_responses: List[str],
+        duration: int,
+        llm_status: str,
+        model_name: Optional[str] = "",
+        token_usage_dict: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        """
+        Publish events to fiddler
+        """
+
+        prompt_count = len(self.run_id_prompts[run_id])
+        df = self.pd.DataFrame(
+            {
+                PROMPT: self.run_id_prompts[run_id],
+                RESPONSE: prompt_responses,
+                RUN_ID: [str(run_id)] * prompt_count,
+                DURATION: [duration] * prompt_count,
+                LLM_STATUS: [llm_status] * prompt_count,
+                MODEL_NAME: [model_name] * prompt_count,
+            }
+        )
+
+        if token_usage_dict:
+            for key, value in token_usage_dict.items():
+                df[key] = [value] * prompt_count if isinstance(value, int) else value
+
+        try:
+            if df.shape[0] > 1:
+                self.fiddler_client.publish_events_batch(self.project, self.model, df)
+            else:
+                df_dict = df.to_dict(orient="records")
+                self.fiddler_client.publish_event(
+                    self.project, self.model, event=df_dict[0]
+                )
+        except Exception as e:
+            print(  # noqa: T201
+                f"Error publishing events to fiddler: {e}. continuing..."
+            )
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> Any:
+        run_id = kwargs[RUN_ID]
+        self.run_id_prompts[run_id] = prompts
+        self.run_id_starttime[run_id] = int(time.time() * 1000)
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        flattened_llmresult = response.flatten()
+        run_id = kwargs[RUN_ID]
+        run_duration = int(time.time() * 1000) - self.run_id_starttime[run_id]
+        model_name = ""
+        token_usage_dict = {}
+
+        if isinstance(response.llm_output, dict):
+            token_usage_dict = {
+                k: v
+                for k, v in response.llm_output.items()
+                if k in [TOTAL_TOKENS, PROMPT_TOKENS, COMPLETION_TOKENS]
+            }
+            model_name = response.llm_output.get(MODEL_NAME, "")
+
+        prompt_responses = [
+            llmresult.generations[0][0].text for llmresult in flattened_llmresult
+        ]
+
+        self._publish_events(
+            run_id,
+            prompt_responses,
+            run_duration,
+            SUCCESS,
+            model_name,
+            token_usage_dict,
+        )
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        run_id = kwargs[RUN_ID]
+        duration = int(time.time() * 1000) - self.run_id_starttime[run_id]
+
+        self._publish_events(
+            run_id, [""] * len(self.run_id_prompts[run_id]), duration, FAILURE
+        )
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/flyte_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/flyte_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..3cd38f7eca9c8d1a0572cf85ed539363a47c1538
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/flyte_callback.py
@@ -0,0 +1,367 @@
+"""FlyteKit callback handler."""
+from __future__ import annotations
+
+import logging
+from copy import deepcopy
+from typing import TYPE_CHECKING, Any, Dict, List, Tuple
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.outputs import LLMResult
+
+from langchain_community.callbacks.utils import (
+    BaseMetadataCallbackHandler,
+    flatten_dict,
+    import_pandas,
+    import_spacy,
+    import_textstat,
+)
+
+if TYPE_CHECKING:
+    import flytekit
+    from flytekitplugins.deck import renderer
+
+logger = logging.getLogger(__name__)
+
+
+def import_flytekit() -> Tuple[flytekit, renderer]:
+    """Import flytekit and flytekitplugins-deck-standard."""
+    try:
+        import flytekit  # noqa: F401
+        from flytekitplugins.deck import renderer  # noqa: F401
+    except ImportError:
+        raise ImportError(
+            "To use the flyte callback manager you need"
+            "to have the `flytekit` and `flytekitplugins-deck-standard`"
+            "packages installed. Please install them with `pip install flytekit`"
+            "and `pip install flytekitplugins-deck-standard`."
+        )
+    return flytekit, renderer
+
+
+def analyze_text(
+    text: str,
+    nlp: Any = None,
+    textstat: Any = None,
+) -> dict:
+    """Analyze text using textstat and spacy.
+
+    Parameters:
+        text (str): The text to analyze.
+        nlp (spacy.lang): The spacy language model to use for visualization.
+
+    Returns:
+        (dict): A dictionary containing the complexity metrics and visualization
+            files serialized to HTML string.
+    """
+    resp: Dict[str, Any] = {}
+    if textstat is not None:
+        text_complexity_metrics = {
+            "flesch_reading_ease": textstat.flesch_reading_ease(text),
+            "flesch_kincaid_grade": textstat.flesch_kincaid_grade(text),
+            "smog_index": textstat.smog_index(text),
+            "coleman_liau_index": textstat.coleman_liau_index(text),
+            "automated_readability_index": textstat.automated_readability_index(text),
+            "dale_chall_readability_score": textstat.dale_chall_readability_score(text),
+            "difficult_words": textstat.difficult_words(text),
+            "linsear_write_formula": textstat.linsear_write_formula(text),
+            "gunning_fog": textstat.gunning_fog(text),
+            "fernandez_huerta": textstat.fernandez_huerta(text),
+            "szigriszt_pazos": textstat.szigriszt_pazos(text),
+            "gutierrez_polini": textstat.gutierrez_polini(text),
+            "crawford": textstat.crawford(text),
+            "gulpease_index": textstat.gulpease_index(text),
+            "osman": textstat.osman(text),
+        }
+        resp.update({"text_complexity_metrics": text_complexity_metrics})
+        resp.update(text_complexity_metrics)
+
+    if nlp is not None:
+        spacy = import_spacy()
+        doc = nlp(text)
+        dep_out = spacy.displacy.render(doc, style="dep", jupyter=False, page=True)
+        ent_out = spacy.displacy.render(doc, style="ent", jupyter=False, page=True)
+        text_visualizations = {
+            "dependency_tree": dep_out,
+            "entities": ent_out,
+        }
+        resp.update(text_visualizations)
+
+    return resp
+
+
+class FlyteCallbackHandler(BaseMetadataCallbackHandler, BaseCallbackHandler):
+    """Callback handler that is used within a Flyte task."""
+
+    def __init__(self) -> None:
+        """Initialize callback handler."""
+        flytekit, renderer = import_flytekit()
+        self.pandas = import_pandas()
+
+        self.textstat = None
+        try:
+            self.textstat = import_textstat()
+        except ImportError:
+            logger.warning(
+                "Textstat library is not installed. \
+                It may result in the inability to log \
+                certain metrics that can be captured with Textstat."
+            )
+
+        spacy = None
+        try:
+            spacy = import_spacy()
+        except ImportError:
+            logger.warning(
+                "Spacy library is not installed. \
+                It may result in the inability to log \
+                certain metrics that can be captured with Spacy."
+            )
+
+        super().__init__()
+
+        self.nlp = None
+        if spacy:
+            try:
+                self.nlp = spacy.load("en_core_web_sm")
+            except OSError:
+                logger.warning(
+                    "FlyteCallbackHandler uses spacy's en_core_web_sm model"
+                    " for certain metrics. To download,"
+                    " run the following command in your terminal:"
+                    " `python -m spacy download en_core_web_sm`"
+                )
+
+        self.table_renderer = renderer.TableRenderer
+        self.markdown_renderer = renderer.MarkdownRenderer
+
+        self.deck = flytekit.Deck(
+            "LangChain Metrics",
+            self.markdown_renderer().to_html("## LangChain Metrics"),
+        )
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """Run when LLM starts."""
+
+        self.step += 1
+        self.llm_starts += 1
+        self.starts += 1
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_llm_start"})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.get_custom_callback_meta())
+
+        prompt_responses = []
+        for prompt in prompts:
+            prompt_responses.append(prompt)
+
+        resp.update({"prompts": prompt_responses})
+
+        self.deck.append(self.markdown_renderer().to_html("### LLM Start"))
+        self.deck.append(
+            self.table_renderer().to_html(self.pandas.DataFrame([resp])) + "\n"
+        )
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Run when LLM generates a new token."""
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Run when LLM ends running."""
+        self.step += 1
+        self.llm_ends += 1
+        self.ends += 1
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_llm_end"})
+        resp.update(flatten_dict(response.llm_output or {}))
+        resp.update(self.get_custom_callback_meta())
+
+        self.deck.append(self.markdown_renderer().to_html("### LLM End"))
+        self.deck.append(self.table_renderer().to_html(self.pandas.DataFrame([resp])))
+
+        for generations in response.generations:
+            for generation in generations:
+                generation_resp = deepcopy(resp)
+                generation_resp.update(flatten_dict(generation.dict()))
+                if self.nlp or self.textstat:
+                    generation_resp.update(
+                        analyze_text(
+                            generation.text, nlp=self.nlp, textstat=self.textstat
+                        )
+                    )
+
+                    complexity_metrics: Dict[str, float] = generation_resp.pop(
+                        "text_complexity_metrics"
+                    )
+                    self.deck.append(
+                        self.markdown_renderer().to_html("#### Text Complexity Metrics")
+                    )
+                    self.deck.append(
+                        self.table_renderer().to_html(
+                            self.pandas.DataFrame([complexity_metrics])
+                        )
+                        + "\n"
+                    )
+
+                    dependency_tree = generation_resp["dependency_tree"]
+                    self.deck.append(
+                        self.markdown_renderer().to_html("#### Dependency Tree")
+                    )
+                    self.deck.append(dependency_tree)
+
+                    entities = generation_resp["entities"]
+                    self.deck.append(self.markdown_renderer().to_html("#### Entities"))
+                    self.deck.append(entities)
+                else:
+                    self.deck.append(
+                        self.markdown_renderer().to_html("#### Generated Response")
+                    )
+                    self.deck.append(self.markdown_renderer().to_html(generation.text))
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when LLM errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Run when chain starts running."""
+        self.step += 1
+        self.chain_starts += 1
+        self.starts += 1
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_chain_start"})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.get_custom_callback_meta())
+
+        chain_input = ",".join([f"{k}={v}" for k, v in inputs.items()])
+        input_resp = deepcopy(resp)
+        input_resp["inputs"] = chain_input
+
+        self.deck.append(self.markdown_renderer().to_html("### Chain Start"))
+        self.deck.append(
+            self.table_renderer().to_html(self.pandas.DataFrame([input_resp])) + "\n"
+        )
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Run when chain ends running."""
+        self.step += 1
+        self.chain_ends += 1
+        self.ends += 1
+
+        resp: Dict[str, Any] = {}
+        chain_output = ",".join([f"{k}={v}" for k, v in outputs.items()])
+        resp.update({"action": "on_chain_end", "outputs": chain_output})
+        resp.update(self.get_custom_callback_meta())
+
+        self.deck.append(self.markdown_renderer().to_html("### Chain End"))
+        self.deck.append(
+            self.table_renderer().to_html(self.pandas.DataFrame([resp])) + "\n"
+        )
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when chain errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_tool_start(
+        self, serialized: Dict[str, Any], input_str: str, **kwargs: Any
+    ) -> None:
+        """Run when tool starts running."""
+        self.step += 1
+        self.tool_starts += 1
+        self.starts += 1
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_tool_start", "input_str": input_str})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.get_custom_callback_meta())
+
+        self.deck.append(self.markdown_renderer().to_html("### Tool Start"))
+        self.deck.append(
+            self.table_renderer().to_html(self.pandas.DataFrame([resp])) + "\n"
+        )
+
+    def on_tool_end(self, output: str, **kwargs: Any) -> None:
+        """Run when tool ends running."""
+        self.step += 1
+        self.tool_ends += 1
+        self.ends += 1
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_tool_end", "output": output})
+        resp.update(self.get_custom_callback_meta())
+
+        self.deck.append(self.markdown_renderer().to_html("### Tool End"))
+        self.deck.append(
+            self.table_renderer().to_html(self.pandas.DataFrame([resp])) + "\n"
+        )
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when tool errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        """
+        Run when agent is ending.
+        """
+        self.step += 1
+        self.text_ctr += 1
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_text", "text": text})
+        resp.update(self.get_custom_callback_meta())
+
+        self.deck.append(self.markdown_renderer().to_html("### On Text"))
+        self.deck.append(
+            self.table_renderer().to_html(self.pandas.DataFrame([resp])) + "\n"
+        )
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        """Run when agent ends running."""
+        self.step += 1
+        self.agent_ends += 1
+        self.ends += 1
+
+        resp: Dict[str, Any] = {}
+        resp.update(
+            {
+                "action": "on_agent_finish",
+                "output": finish.return_values["output"],
+                "log": finish.log,
+            }
+        )
+        resp.update(self.get_custom_callback_meta())
+
+        self.deck.append(self.markdown_renderer().to_html("### Agent Finish"))
+        self.deck.append(
+            self.table_renderer().to_html(self.pandas.DataFrame([resp])) + "\n"
+        )
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Run on agent action."""
+        self.step += 1
+        self.tool_starts += 1
+        self.starts += 1
+
+        resp: Dict[str, Any] = {}
+        resp.update(
+            {
+                "action": "on_agent_action",
+                "tool": action.tool,
+                "tool_input": action.tool_input,
+                "log": action.log,
+            }
+        )
+        resp.update(self.get_custom_callback_meta())
+
+        self.deck.append(self.markdown_renderer().to_html("### Agent Action"))
+        self.deck.append(
+            self.table_renderer().to_html(self.pandas.DataFrame([resp])) + "\n"
+        )
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/human.py b/llm/Lib/site-packages/langchain_community/callbacks/human.py
new file mode 100644
index 0000000000000000000000000000000000000000..64ea01f99f524fca14ffbabb6bc2560341a10415
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/human.py
@@ -0,0 +1,88 @@
+from typing import Any, Awaitable, Callable, Dict, Optional
+from uuid import UUID
+
+from langchain_core.callbacks import AsyncCallbackHandler, BaseCallbackHandler
+
+
+def _default_approve(_input: str) -> bool:
+    msg = (
+        "Do you approve of the following input? "
+        "Anything except 'Y'/'Yes' (case-insensitive) will be treated as a no."
+    )
+    msg += "\n\n" + _input + "\n"
+    resp = input(msg)
+    return resp.lower() in ("yes", "y")
+
+
+async def _adefault_approve(_input: str) -> bool:
+    msg = (
+        "Do you approve of the following input? "
+        "Anything except 'Y'/'Yes' (case-insensitive) will be treated as a no."
+    )
+    msg += "\n\n" + _input + "\n"
+    resp = input(msg)
+    return resp.lower() in ("yes", "y")
+
+
+def _default_true(_: Dict[str, Any]) -> bool:
+    return True
+
+
+class HumanRejectedException(Exception):
+    """Exception to raise when a person manually review and rejects a value."""
+
+
+class HumanApprovalCallbackHandler(BaseCallbackHandler):
+    """Callback for manually validating values."""
+
+    raise_error: bool = True
+
+    def __init__(
+        self,
+        approve: Callable[[Any], bool] = _default_approve,
+        should_check: Callable[[Dict[str, Any]], bool] = _default_true,
+    ):
+        self._approve = approve
+        self._should_check = should_check
+
+    def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if self._should_check(serialized) and not self._approve(input_str):
+            raise HumanRejectedException(
+                f"Inputs {input_str} to tool {serialized} were rejected."
+            )
+
+
+class AsyncHumanApprovalCallbackHandler(AsyncCallbackHandler):
+    """Asynchronous callback for manually validating values."""
+
+    raise_error: bool = True
+
+    def __init__(
+        self,
+        approve: Callable[[Any], Awaitable[bool]] = _adefault_approve,
+        should_check: Callable[[Dict[str, Any]], bool] = _default_true,
+    ):
+        self._approve = approve
+        self._should_check = should_check
+
+    async def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if self._should_check(serialized) and not await self._approve(input_str):
+            raise HumanRejectedException(
+                f"Inputs {input_str} to tool {serialized} were rejected."
+            )
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/infino_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/infino_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..0b58b598df734aa934d8991febf2c5e183f0d0d8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/infino_callback.py
@@ -0,0 +1,266 @@
+import time
+from typing import Any, Dict, List, Optional, cast
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.messages import BaseMessage
+from langchain_core.outputs import ChatGeneration, LLMResult
+
+
+def import_infino() -> Any:
+    """Import the infino client."""
+    try:
+        from infinopy import InfinoClient
+    except ImportError:
+        raise ImportError(
+            "To use the Infino callbacks manager you need to have the"
+            " `infinopy` python package installed."
+            "Please install it with `pip install infinopy`"
+        )
+    return InfinoClient()
+
+
+def import_tiktoken() -> Any:
+    """Import tiktoken for counting tokens for OpenAI models."""
+    try:
+        import tiktoken
+    except ImportError:
+        raise ImportError(
+            "To use the ChatOpenAI model with Infino callback manager, you need to "
+            "have the `tiktoken` python package installed."
+            "Please install it with `pip install tiktoken`"
+        )
+    return tiktoken
+
+
+def get_num_tokens(string: str, openai_model_name: str) -> int:
+    """Calculate num tokens for OpenAI with tiktoken package.
+
+    Official documentation: https://github.com/openai/openai-cookbook/blob/main
+                            /examples/How_to_count_tokens_with_tiktoken.ipynb
+    """
+    tiktoken = import_tiktoken()
+
+    encoding = tiktoken.encoding_for_model(openai_model_name)
+    num_tokens = len(encoding.encode(string))
+    return num_tokens
+
+
+class InfinoCallbackHandler(BaseCallbackHandler):
+    """Callback Handler that logs to Infino."""
+
+    def __init__(
+        self,
+        model_id: Optional[str] = None,
+        model_version: Optional[str] = None,
+        verbose: bool = False,
+    ) -> None:
+        # Set Infino client
+        self.client = import_infino()
+        self.model_id = model_id
+        self.model_version = model_version
+        self.verbose = verbose
+        self.is_chat_openai_model = False
+        self.chat_openai_model_name = "gpt-3.5-turbo"
+
+    def _send_to_infino(
+        self,
+        key: str,
+        value: Any,
+        is_ts: bool = True,
+    ) -> None:
+        """Send the key-value to Infino.
+
+        Parameters:
+        key (str): the key to send to Infino.
+        value (Any): the value to send to Infino.
+        is_ts (bool): if True, the value is part of a time series, else it
+                      is sent as a log message.
+        """
+        payload = {
+            "date": int(time.time()),
+            key: value,
+            "labels": {
+                "model_id": self.model_id,
+                "model_version": self.model_version,
+            },
+        }
+        if self.verbose:
+            print(f"Tracking {key} with Infino: {payload}")  # noqa: T201
+
+        # Append to Infino time series only if is_ts is True, otherwise
+        # append to Infino log.
+        if is_ts:
+            self.client.append_ts(payload)
+        else:
+            self.client.append_log(payload)
+
+    def on_llm_start(
+        self,
+        serialized: Dict[str, Any],
+        prompts: List[str],
+        **kwargs: Any,
+    ) -> None:
+        """Log the prompts to Infino, and set start time and error flag."""
+        for prompt in prompts:
+            self._send_to_infino("prompt", prompt, is_ts=False)
+
+        # Set the error flag to indicate no error (this will get overridden
+        # in on_llm_error if an error occurs).
+        self.error = 0
+
+        # Set the start time (so that we can calculate the request
+        # duration in on_llm_end).
+        self.start_time = time.time()
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Do nothing when a new token is generated."""
+        pass
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Log the latency, error, token usage, and response to Infino."""
+        # Calculate and track the request latency.
+        self.end_time = time.time()
+        duration = self.end_time - self.start_time
+        self._send_to_infino("latency", duration)
+
+        # Track success or error flag.
+        self._send_to_infino("error", self.error)
+
+        # Track prompt response.
+        for generations in response.generations:
+            for generation in generations:
+                self._send_to_infino("prompt_response", generation.text, is_ts=False)
+
+        # Track token usage (for non-chat models).
+        if (response.llm_output is not None) and isinstance(response.llm_output, Dict):
+            token_usage = response.llm_output["token_usage"]
+            if token_usage is not None:
+                prompt_tokens = token_usage["prompt_tokens"]
+                total_tokens = token_usage["total_tokens"]
+                completion_tokens = token_usage["completion_tokens"]
+                self._send_to_infino("prompt_tokens", prompt_tokens)
+                self._send_to_infino("total_tokens", total_tokens)
+                self._send_to_infino("completion_tokens", completion_tokens)
+
+        # Track completion token usage (for openai chat models).
+        if self.is_chat_openai_model:
+            messages = " ".join(
+                cast(str, cast(ChatGeneration, generation).message.content)
+                for generation in generations
+            )
+            completion_tokens = get_num_tokens(
+                messages, openai_model_name=self.chat_openai_model_name
+            )
+            self._send_to_infino("completion_tokens", completion_tokens)
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Set the error flag."""
+        self.error = 1
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Do nothing when LLM chain starts."""
+        pass
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Do nothing when LLM chain ends."""
+        pass
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Need to log the error."""
+        pass
+
+    def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        **kwargs: Any,
+    ) -> None:
+        """Do nothing when tool starts."""
+        pass
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Do nothing when agent takes a specific action."""
+        pass
+
+    def on_tool_end(
+        self,
+        output: str,
+        observation_prefix: Optional[str] = None,
+        llm_prefix: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Do nothing when tool ends."""
+        pass
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing when tool outputs an error."""
+        pass
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        """Do nothing."""
+        pass
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        """Do nothing."""
+        pass
+
+    def on_chat_model_start(
+        self,
+        serialized: Dict[str, Any],
+        messages: List[List[BaseMessage]],
+        **kwargs: Any,
+    ) -> None:
+        """Run when LLM starts running."""
+
+        # Currently, for chat models, we only support input prompts for ChatOpenAI.
+        # Check if this model is a ChatOpenAI model.
+        values = serialized.get("id")
+        if values:
+            for value in values:
+                if value == "ChatOpenAI":
+                    self.is_chat_openai_model = True
+                    break
+
+        # Track prompt tokens for ChatOpenAI model.
+        if self.is_chat_openai_model:
+            invocation_params = kwargs.get("invocation_params")
+            if invocation_params:
+                model_name = invocation_params.get("model_name")
+                if model_name:
+                    self.chat_openai_model_name = model_name
+                    prompt_tokens = 0
+                    for message_list in messages:
+                        message_string = " ".join(
+                            cast(str, msg.content) for msg in message_list
+                        )
+                        num_tokens = get_num_tokens(
+                            message_string,
+                            openai_model_name=self.chat_openai_model_name,
+                        )
+                        prompt_tokens += num_tokens
+
+                    self._send_to_infino("prompt_tokens", prompt_tokens)
+
+        if self.verbose:
+            print(  # noqa: T201
+                f"on_chat_model_start: is_chat_openai_model= \
+                  {self.is_chat_openai_model}, \
+                  chat_openai_model_name={self.chat_openai_model_name}"
+            )
+
+        # Send the prompt to infino
+        prompt = " ".join(
+            cast(str, msg.content) for sublist in messages for msg in sublist
+        )
+        self._send_to_infino("prompt", prompt, is_ts=False)
+
+        # Set the error flag to indicate no error (this will get overridden
+        # in on_llm_error if an error occurs).
+        self.error = 0
+
+        # Set the start time (so that we can calculate the request
+        # duration in on_llm_end).
+        self.start_time = time.time()
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/labelstudio_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/labelstudio_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..0eb35af10171854afdce0860a706ee1234603e81
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/labelstudio_callback.py
@@ -0,0 +1,390 @@
+import os
+import warnings
+from datetime import datetime
+from enum import Enum
+from typing import Any, Dict, List, Optional, Tuple, Union
+from uuid import UUID
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.messages import BaseMessage, ChatMessage
+from langchain_core.outputs import Generation, LLMResult
+
+
+class LabelStudioMode(Enum):
+    """Label Studio mode enumerator."""
+
+    PROMPT = "prompt"
+    CHAT = "chat"
+
+
+def get_default_label_configs(
+    mode: Union[str, LabelStudioMode],
+) -> Tuple[str, LabelStudioMode]:
+    """Get default Label Studio configs for the given mode.
+
+    Parameters:
+        mode: Label Studio mode ("prompt" or "chat")
+
+    Returns: Tuple of Label Studio config and mode
+    """
+    _default_label_configs = {
+        LabelStudioMode.PROMPT.value: """
+<View>
+<Style>
+    .prompt-box {
+        background-color: white;
+        border-radius: 10px;
+        box-shadow: 0px 4px 6px rgba(0, 0, 0, 0.1);
+        padding: 20px;
+    }
+</Style>
+<View className="root">
+    <View className="prompt-box">
+        <Text name="prompt" value="$prompt"/>
+    </View>
+    <TextArea name="response" toName="prompt"
+              maxSubmissions="1" editable="true"
+              required="true"/>
+</View>
+<Header value="Rate the response:"/>
+<Rating name="rating" toName="prompt"/>
+</View>""",
+        LabelStudioMode.CHAT.value: """
+<View>
+<View className="root">
+     <Paragraphs name="dialogue"
+               value="$prompt"
+               layout="dialogue"
+               textKey="content"
+               nameKey="role"
+               granularity="sentence"/>
+  <Header value="Final response:"/>
+    <TextArea name="response" toName="dialogue"
+              maxSubmissions="1" editable="true"
+              required="true"/>
+</View>
+<Header value="Rate the response:"/>
+<Rating name="rating" toName="dialogue"/>
+</View>""",
+    }
+
+    if isinstance(mode, str):
+        mode = LabelStudioMode(mode)
+
+    return _default_label_configs[mode.value], mode
+
+
+class LabelStudioCallbackHandler(BaseCallbackHandler):
+    """Label Studio callback handler.
+    Provides the ability to send predictions to Label Studio
+    for human evaluation, feedback and annotation.
+
+    Parameters:
+        api_key: Label Studio API key
+        url: Label Studio URL
+        project_id: Label Studio project ID
+        project_name: Label Studio project name
+        project_config: Label Studio project config (XML)
+        mode: Label Studio mode ("prompt" or "chat")
+
+    Examples:
+        >>> from langchain_community.llms import OpenAI
+        >>> from langchain_community.callbacks import LabelStudioCallbackHandler
+        >>> handler = LabelStudioCallbackHandler(
+        ...             api_key='<your_key_here>',
+        ...             url='http://localhost:8080',
+        ...             project_name='LangChain-%Y-%m-%d',
+        ...             mode='prompt'
+        ... )
+        >>> llm = OpenAI(callbacks=[handler])
+        >>> llm.invoke('Tell me a story about a dog.')
+    """
+
+    DEFAULT_PROJECT_NAME: str = "LangChain-%Y-%m-%d"
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        url: Optional[str] = None,
+        project_id: Optional[int] = None,
+        project_name: str = DEFAULT_PROJECT_NAME,
+        project_config: Optional[str] = None,
+        mode: Union[str, LabelStudioMode] = LabelStudioMode.PROMPT,
+    ):
+        super().__init__()
+
+        # Import LabelStudio SDK
+        try:
+            import label_studio_sdk as ls
+        except ImportError:
+            raise ImportError(
+                f"You're using {self.__class__.__name__} in your code,"
+                f" but you don't have the LabelStudio SDK "
+                f"Python package installed or upgraded to the latest version. "
+                f"Please run `pip install -U label-studio-sdk`"
+                f" before using this callback."
+            )
+
+        # Check if Label Studio API key is provided
+        if not api_key:
+            if os.getenv("LABEL_STUDIO_API_KEY"):
+                api_key = str(os.getenv("LABEL_STUDIO_API_KEY"))
+            else:
+                raise ValueError(
+                    f"You're using {self.__class__.__name__} in your code,"
+                    f" Label Studio API key is not provided. "
+                    f"Please provide Label Studio API key: "
+                    f"go to the Label Studio instance, navigate to "
+                    f"Account & Settings -> Access Token and copy the key. "
+                    f"Use the key as a parameter for the callback: "
+                    f"{self.__class__.__name__}"
+                    f"(label_studio_api_key='<your_key_here>', ...) or "
+                    f"set the environment variable LABEL_STUDIO_API_KEY=<your_key_here>"
+                )
+        self.api_key = api_key
+
+        if not url:
+            if os.getenv("LABEL_STUDIO_URL"):
+                url = os.getenv("LABEL_STUDIO_URL")
+            else:
+                warnings.warn(
+                    f"Label Studio URL is not provided, "
+                    f"using default URL: {ls.LABEL_STUDIO_DEFAULT_URL}"
+                    f"If you want to provide your own URL, use the parameter: "
+                    f"{self.__class__.__name__}"
+                    f"(label_studio_url='<your_url_here>', ...) "
+                    f"or set the environment variable LABEL_STUDIO_URL=<your_url_here>"
+                )
+                url = ls.LABEL_STUDIO_DEFAULT_URL
+        self.url = url
+
+        # Maps run_id to prompts
+        self.payload: Dict[str, Dict] = {}
+
+        self.ls_client = ls.Client(url=self.url, api_key=self.api_key)
+        self.project_name = project_name
+        if project_config:
+            self.project_config = project_config
+            self.mode = None
+        else:
+            self.project_config, self.mode = get_default_label_configs(mode)
+
+        self.project_id = project_id or os.getenv("LABEL_STUDIO_PROJECT_ID")
+        if self.project_id is not None:
+            self.ls_project = self.ls_client.get_project(int(self.project_id))
+        else:
+            project_title = datetime.today().strftime(self.project_name)
+            existing_projects = self.ls_client.get_projects(title=project_title)
+            if existing_projects:
+                self.ls_project = existing_projects[0]
+                self.project_id = self.ls_project.id
+            else:
+                self.ls_project = self.ls_client.create_project(
+                    title=project_title, label_config=self.project_config
+                )
+                self.project_id = self.ls_project.id
+        self.parsed_label_config = self.ls_project.parsed_label_config
+
+        # Find the first TextArea tag
+        # "from_name", "to_name", "value" will be used to create predictions
+        self.from_name, self.to_name, self.value, self.input_type = (
+            None,
+            None,
+            None,
+            None,
+        )
+        for tag_name, tag_info in self.parsed_label_config.items():
+            if tag_info["type"] == "TextArea":
+                self.from_name = tag_name
+                self.to_name = tag_info["to_name"][0]
+                self.value = tag_info["inputs"][0]["value"]
+                self.input_type = tag_info["inputs"][0]["type"]
+                break
+        if not self.from_name:
+            error_message = (
+                f'Label Studio project "{self.project_name}" '
+                f"does not have a TextArea tag. "
+                f"Please add a TextArea tag to the project."
+            )
+            if self.mode == LabelStudioMode.PROMPT:
+                error_message += (
+                    "\nHINT: go to project Settings -> "
+                    "Labeling Interface -> Browse Templates"
+                    ' and select "Generative AI -> '
+                    'Supervised Language Model Fine-tuning" template.'
+                )
+            else:
+                error_message += (
+                    "\nHINT: go to project Settings -> "
+                    "Labeling Interface -> Browse Templates"
+                    " and check available templates under "
+                    '"Generative AI" section.'
+                )
+            raise ValueError(error_message)
+
+    def add_prompts_generations(
+        self, run_id: str, generations: List[List[Generation]]
+    ) -> None:
+        # Create tasks in Label Studio
+        tasks = []
+        prompts = self.payload[run_id]["prompts"]
+        model_version = (
+            self.payload[run_id]["kwargs"]
+            .get("invocation_params", {})
+            .get("model_name")
+        )
+        for prompt, generation in zip(prompts, generations):
+            tasks.append(
+                {
+                    "data": {
+                        self.value: prompt,
+                        "run_id": run_id,
+                    },
+                    "predictions": [
+                        {
+                            "result": [
+                                {
+                                    "from_name": self.from_name,
+                                    "to_name": self.to_name,
+                                    "type": "textarea",
+                                    "value": {"text": [g.text for g in generation]},
+                                }
+                            ],
+                            "model_version": model_version,
+                        }
+                    ],
+                }
+            )
+        self.ls_project.import_tasks(tasks)
+
+    def on_llm_start(
+        self,
+        serialized: Dict[str, Any],
+        prompts: List[str],
+        **kwargs: Any,
+    ) -> None:
+        """Save the prompts in memory when an LLM starts."""
+        if self.input_type != "Text":
+            raise ValueError(
+                f'\nLabel Studio project "{self.project_name}" '
+                f"has an input type <{self.input_type}>. "
+                f'To make it work with the mode="chat", '
+                f"the input type should be <Text>.\n"
+                f"Read more here https://labelstud.io/tags/text"
+            )
+        run_id = str(kwargs["run_id"])
+        self.payload[run_id] = {"prompts": prompts, "kwargs": kwargs}
+
+    def _get_message_role(self, message: BaseMessage) -> str:
+        """Get the role of the message."""
+        if isinstance(message, ChatMessage):
+            return message.role
+        else:
+            return message.__class__.__name__
+
+    def on_chat_model_start(
+        self,
+        serialized: Dict[str, Any],
+        messages: List[List[BaseMessage]],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Save the prompts in memory when an LLM starts."""
+        if self.input_type != "Paragraphs":
+            raise ValueError(
+                f'\nLabel Studio project "{self.project_name}" '
+                f"has an input type <{self.input_type}>. "
+                f'To make it work with the mode="chat", '
+                f"the input type should be <Paragraphs>.\n"
+                f"Read more here https://labelstud.io/tags/paragraphs"
+            )
+
+        prompts = []
+        for message_list in messages:
+            dialog = []
+            for message in message_list:
+                dialog.append(
+                    {
+                        "role": self._get_message_role(message),
+                        "content": message.content,
+                    }
+                )
+            prompts.append(dialog)
+        self.payload[str(run_id)] = {
+            "prompts": prompts,
+            "tags": tags,
+            "metadata": metadata,
+            "run_id": run_id,
+            "parent_run_id": parent_run_id,
+            "kwargs": kwargs,
+        }
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Do nothing when a new token is generated."""
+        pass
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Create a new Label Studio task for each prompt and generation."""
+        run_id = str(kwargs["run_id"])
+
+        # Submit results to Label Studio
+        self.add_prompts_generations(run_id, response.generations)
+
+        # Pop current run from `self.runs`
+        self.payload.pop(run_id)
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing when LLM outputs an error."""
+        pass
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        pass
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        pass
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing when LLM chain outputs an error."""
+        pass
+
+    def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        **kwargs: Any,
+    ) -> None:
+        """Do nothing when tool starts."""
+        pass
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Do nothing when agent takes a specific action."""
+        pass
+
+    def on_tool_end(
+        self,
+        output: str,
+        observation_prefix: Optional[str] = None,
+        llm_prefix: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Do nothing when tool ends."""
+        pass
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Do nothing when tool outputs an error."""
+        pass
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        """Do nothing"""
+        pass
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        """Do nothing"""
+        pass
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/llmonitor_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/llmonitor_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc7bbbfb9b092459e56ee8a814a5a8a14a16855a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/llmonitor_callback.py
@@ -0,0 +1,681 @@
+import importlib.metadata
+import logging
+import os
+import traceback
+import warnings
+from contextvars import ContextVar
+from typing import Any, Dict, List, Union, cast
+from uuid import UUID
+
+import requests
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.messages import BaseMessage
+from langchain_core.outputs import LLMResult
+from packaging.version import parse
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_API_URL = "https://app.llmonitor.com"
+
+user_ctx = ContextVar[Union[str, None]]("user_ctx", default=None)
+user_props_ctx = ContextVar[Union[str, None]]("user_props_ctx", default=None)
+
+PARAMS_TO_CAPTURE = [
+    "temperature",
+    "top_p",
+    "top_k",
+    "stop",
+    "presence_penalty",
+    "frequence_penalty",
+    "seed",
+    "function_call",
+    "functions",
+    "tools",
+    "tool_choice",
+    "response_format",
+    "max_tokens",
+    "logit_bias",
+]
+
+
+class UserContextManager:
+    """Context manager for LLMonitor user context."""
+
+    def __init__(self, user_id: str, user_props: Any = None) -> None:
+        user_ctx.set(user_id)
+        user_props_ctx.set(user_props)
+
+    def __enter__(self) -> Any:
+        pass
+
+    def __exit__(self, exc_type: Any, exc_value: Any, exc_tb: Any) -> Any:
+        user_ctx.set(None)
+        user_props_ctx.set(None)
+
+
+def identify(user_id: str, user_props: Any = None) -> UserContextManager:
+    """Builds an LLMonitor UserContextManager
+
+    Parameters:
+        - `user_id`: The user id.
+        - `user_props`: The user properties.
+
+    Returns:
+        A context manager that sets the user context.
+    """
+    return UserContextManager(user_id, user_props)
+
+
+def _serialize(obj: Any) -> Union[Dict[str, Any], List[Any], Any]:
+    if hasattr(obj, "to_json"):
+        return obj.to_json()
+
+    if isinstance(obj, dict):
+        return {key: _serialize(value) for key, value in obj.items()}
+
+    if isinstance(obj, list):
+        return [_serialize(element) for element in obj]
+
+    return obj
+
+
+def _parse_input(raw_input: Any) -> Any:
+    if not raw_input:
+        return None
+
+    # if it's an array of 1, just parse the first element
+    if isinstance(raw_input, list) and len(raw_input) == 1:
+        return _parse_input(raw_input[0])
+
+    if not isinstance(raw_input, dict):
+        return _serialize(raw_input)
+
+    input_value = raw_input.get("input")
+    inputs_value = raw_input.get("inputs")
+    question_value = raw_input.get("question")
+    query_value = raw_input.get("query")
+
+    if input_value:
+        return input_value
+    if inputs_value:
+        return inputs_value
+    if question_value:
+        return question_value
+    if query_value:
+        return query_value
+
+    return _serialize(raw_input)
+
+
+def _parse_output(raw_output: dict) -> Any:
+    if not raw_output:
+        return None
+
+    if not isinstance(raw_output, dict):
+        return _serialize(raw_output)
+
+    text_value = raw_output.get("text")
+    output_value = raw_output.get("output")
+    output_text_value = raw_output.get("output_text")
+    answer_value = raw_output.get("answer")
+    result_value = raw_output.get("result")
+
+    if text_value:
+        return text_value
+    if answer_value:
+        return answer_value
+    if output_value:
+        return output_value
+    if output_text_value:
+        return output_text_value
+    if result_value:
+        return result_value
+
+    return _serialize(raw_output)
+
+
+def _parse_lc_role(
+    role: str,
+) -> str:
+    if role == "human":
+        return "user"
+    else:
+        return role
+
+
+def _get_user_id(metadata: Any) -> Any:
+    if user_ctx.get() is not None:
+        return user_ctx.get()
+
+    metadata = metadata or {}
+    user_id = metadata.get("user_id")
+    if user_id is None:
+        user_id = metadata.get("userId")  # legacy, to delete in the future
+    return user_id
+
+
+def _get_user_props(metadata: Any) -> Any:
+    if user_props_ctx.get() is not None:
+        return user_props_ctx.get()
+
+    metadata = metadata or {}
+    return metadata.get("user_props", None)
+
+
+def _parse_lc_message(message: BaseMessage) -> Dict[str, Any]:
+    keys = ["function_call", "tool_calls", "tool_call_id", "name"]
+    parsed = {"text": message.content, "role": _parse_lc_role(message.type)}
+    parsed.update(
+        {
+            key: cast(Any, message.additional_kwargs.get(key))
+            for key in keys
+            if message.additional_kwargs.get(key) is not None
+        }
+    )
+    return parsed
+
+
+def _parse_lc_messages(messages: Union[List[BaseMessage], Any]) -> List[Dict[str, Any]]:
+    return [_parse_lc_message(message) for message in messages]
+
+
+class LLMonitorCallbackHandler(BaseCallbackHandler):
+    """Callback Handler for LLMonitor`.
+
+    #### Parameters:
+        - `app_id`: The app id of the app you want to report to. Defaults to
+        `None`, which means that `LLMONITOR_APP_ID` will be used.
+        - `api_url`: The url of the LLMonitor API. Defaults to `None`,
+        which means that either `LLMONITOR_API_URL` environment variable
+        or `https://app.llmonitor.com` will be used.
+
+    #### Raises:
+        - `ValueError`: if `app_id` is not provided either as an
+        argument or as an environment variable.
+        - `ConnectionError`: if the connection to the API fails.
+
+
+    #### Example:
+    ```python
+    from langchain_community.llms import OpenAI
+    from langchain_community.callbacks import LLMonitorCallbackHandler
+
+    llmonitor_callback = LLMonitorCallbackHandler()
+    llm = OpenAI(callbacks=[llmonitor_callback],
+                 metadata={"userId": "user-123"})
+    llm.invoke("Hello, how are you?")
+    ```
+    """
+
+    __api_url: str
+    __app_id: str
+    __verbose: bool
+    __llmonitor_version: str
+    __has_valid_config: bool
+
+    def __init__(
+        self,
+        app_id: Union[str, None] = None,
+        api_url: Union[str, None] = None,
+        verbose: bool = False,
+    ) -> None:
+        super().__init__()
+
+        self.__has_valid_config = True
+
+        try:
+            import llmonitor
+
+            self.__llmonitor_version = importlib.metadata.version("llmonitor")
+            self.__track_event = llmonitor.track_event
+
+        except ImportError:
+            logger.warning(
+                """[LLMonitor] To use the LLMonitor callback handler you need to 
+                have the `llmonitor` Python package installed. Please install it 
+                with `pip install llmonitor`"""
+            )
+            self.__has_valid_config = False
+            return
+
+        if parse(self.__llmonitor_version) < parse("0.0.32"):
+            logger.warning(
+                f"""[LLMonitor] The installed `llmonitor` version is 
+                {self.__llmonitor_version} 
+                but `LLMonitorCallbackHandler` requires at least version 0.0.32 
+                upgrade `llmonitor` with `pip install --upgrade llmonitor`"""
+            )
+            self.__has_valid_config = False
+
+        self.__has_valid_config = True
+
+        self.__api_url = api_url or os.getenv("LLMONITOR_API_URL") or DEFAULT_API_URL
+        self.__verbose = verbose or bool(os.getenv("LLMONITOR_VERBOSE"))
+
+        _app_id = app_id or os.getenv("LLMONITOR_APP_ID")
+        if _app_id is None:
+            logger.warning(
+                """[LLMonitor] app_id must be provided either as an argument or 
+                as an environment variable"""
+            )
+            self.__has_valid_config = False
+        else:
+            self.__app_id = _app_id
+
+        if self.__has_valid_config is False:
+            return None
+
+        try:
+            res = requests.get(f"{self.__api_url}/api/app/{self.__app_id}")
+            if not res.ok:
+                raise ConnectionError()
+        except Exception:
+            logger.warning(
+                f"""[LLMonitor] Could not connect to the LLMonitor API at 
+                {self.__api_url}"""
+            )
+
+    def on_llm_start(
+        self,
+        serialized: Dict[str, Any],
+        prompts: List[str],
+        *,
+        run_id: UUID,
+        parent_run_id: Union[UUID, None] = None,
+        tags: Union[List[str], None] = None,
+        metadata: Union[Dict[str, Any], None] = None,
+        **kwargs: Any,
+    ) -> None:
+        if self.__has_valid_config is False:
+            return
+        try:
+            user_id = _get_user_id(metadata)
+            user_props = _get_user_props(metadata)
+
+            params = kwargs.get("invocation_params", {})
+            params.update(
+                serialized.get("kwargs", {})
+            )  # Sometimes, for example with ChatAnthropic, `invocation_params` is empty
+
+            name = (
+                params.get("model")
+                or params.get("model_name")
+                or params.get("model_id")
+            )
+
+            if not name and "anthropic" in params.get("_type"):
+                name = "claude-2"
+
+            extra = {
+                param: params.get(param)
+                for param in PARAMS_TO_CAPTURE
+                if params.get(param) is not None
+            }
+
+            input = _parse_input(prompts)
+
+            self.__track_event(
+                "llm",
+                "start",
+                user_id=user_id,
+                run_id=str(run_id),
+                parent_run_id=str(parent_run_id) if parent_run_id else None,
+                name=name,
+                input=input,
+                tags=tags,
+                extra=extra,
+                metadata=metadata,
+                user_props=user_props,
+                app_id=self.__app_id,
+            )
+        except Exception as e:
+            warnings.warn(f"[LLMonitor] An error occurred in on_llm_start: {e}")
+
+    def on_chat_model_start(
+        self,
+        serialized: Dict[str, Any],
+        messages: List[List[BaseMessage]],
+        *,
+        run_id: UUID,
+        parent_run_id: Union[UUID, None] = None,
+        tags: Union[List[str], None] = None,
+        metadata: Union[Dict[str, Any], None] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if self.__has_valid_config is False:
+            return
+
+        try:
+            user_id = _get_user_id(metadata)
+            user_props = _get_user_props(metadata)
+
+            params = kwargs.get("invocation_params", {})
+            params.update(
+                serialized.get("kwargs", {})
+            )  # Sometimes, for example with ChatAnthropic, `invocation_params` is empty
+
+            name = (
+                params.get("model")
+                or params.get("model_name")
+                or params.get("model_id")
+            )
+
+            if not name and "anthropic" in params.get("_type"):
+                name = "claude-2"
+
+            extra = {
+                param: params.get(param)
+                for param in PARAMS_TO_CAPTURE
+                if params.get(param) is not None
+            }
+
+            input = _parse_lc_messages(messages[0])
+
+            self.__track_event(
+                "llm",
+                "start",
+                user_id=user_id,
+                run_id=str(run_id),
+                parent_run_id=str(parent_run_id) if parent_run_id else None,
+                name=name,
+                input=input,
+                tags=tags,
+                extra=extra,
+                metadata=metadata,
+                user_props=user_props,
+                app_id=self.__app_id,
+            )
+        except Exception as e:
+            logger.error(f"[LLMonitor] An error occurred in on_chat_model_start: {e}")
+
+    def on_llm_end(
+        self,
+        response: LLMResult,
+        *,
+        run_id: UUID,
+        parent_run_id: Union[UUID, None] = None,
+        **kwargs: Any,
+    ) -> None:
+        if self.__has_valid_config is False:
+            return
+
+        try:
+            token_usage = (response.llm_output or {}).get("token_usage", {})
+
+            parsed_output: Any = [
+                _parse_lc_message(generation.message)
+                if hasattr(generation, "message")
+                else generation.text
+                for generation in response.generations[0]
+            ]
+
+            # if it's an array of 1, just parse the first element
+            if len(parsed_output) == 1:
+                parsed_output = parsed_output[0]
+
+            self.__track_event(
+                "llm",
+                "end",
+                run_id=str(run_id),
+                parent_run_id=str(parent_run_id) if parent_run_id else None,
+                output=parsed_output,
+                token_usage={
+                    "prompt": token_usage.get("prompt_tokens"),
+                    "completion": token_usage.get("completion_tokens"),
+                },
+                app_id=self.__app_id,
+            )
+        except Exception as e:
+            logger.error(f"[LLMonitor] An error occurred in on_llm_end: {e}")
+
+    def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        *,
+        run_id: UUID,
+        parent_run_id: Union[UUID, None] = None,
+        tags: Union[List[str], None] = None,
+        metadata: Union[Dict[str, Any], None] = None,
+        **kwargs: Any,
+    ) -> None:
+        if self.__has_valid_config is False:
+            return
+        try:
+            user_id = _get_user_id(metadata)
+            user_props = _get_user_props(metadata)
+            name = serialized.get("name")
+
+            self.__track_event(
+                "tool",
+                "start",
+                user_id=user_id,
+                run_id=str(run_id),
+                parent_run_id=str(parent_run_id) if parent_run_id else None,
+                name=name,
+                input=input_str,
+                tags=tags,
+                metadata=metadata,
+                user_props=user_props,
+                app_id=self.__app_id,
+            )
+        except Exception as e:
+            logger.error(f"[LLMonitor] An error occurred in on_tool_start: {e}")
+
+    def on_tool_end(
+        self,
+        output: Any,
+        *,
+        run_id: UUID,
+        parent_run_id: Union[UUID, None] = None,
+        tags: Union[List[str], None] = None,
+        **kwargs: Any,
+    ) -> None:
+        output = str(output)
+        if self.__has_valid_config is False:
+            return
+        try:
+            self.__track_event(
+                "tool",
+                "end",
+                run_id=str(run_id),
+                parent_run_id=str(parent_run_id) if parent_run_id else None,
+                output=output,
+                app_id=self.__app_id,
+            )
+        except Exception as e:
+            logger.error(f"[LLMonitor] An error occurred in on_tool_end: {e}")
+
+    def on_chain_start(
+        self,
+        serialized: Dict[str, Any],
+        inputs: Dict[str, Any],
+        *,
+        run_id: UUID,
+        parent_run_id: Union[UUID, None] = None,
+        tags: Union[List[str], None] = None,
+        metadata: Union[Dict[str, Any], None] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if self.__has_valid_config is False:
+            return
+        try:
+            name = serialized.get("id", [None, None, None, None])[3]
+            type = "chain"
+            metadata = metadata or {}
+
+            agentName = metadata.get("agent_name")
+            if agentName is None:
+                agentName = metadata.get("agentName")
+
+            if name == "AgentExecutor" or name == "PlanAndExecute":
+                type = "agent"
+            if agentName is not None:
+                type = "agent"
+                name = agentName
+            if parent_run_id is not None:
+                type = "chain"
+
+            user_id = _get_user_id(metadata)
+            user_props = _get_user_props(metadata)
+            input = _parse_input(inputs)
+
+            self.__track_event(
+                type,
+                "start",
+                user_id=user_id,
+                run_id=str(run_id),
+                parent_run_id=str(parent_run_id) if parent_run_id else None,
+                name=name,
+                input=input,
+                tags=tags,
+                metadata=metadata,
+                user_props=user_props,
+                app_id=self.__app_id,
+            )
+        except Exception as e:
+            logger.error(f"[LLMonitor] An error occurred in on_chain_start: {e}")
+
+    def on_chain_end(
+        self,
+        outputs: Dict[str, Any],
+        *,
+        run_id: UUID,
+        parent_run_id: Union[UUID, None] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if self.__has_valid_config is False:
+            return
+        try:
+            output = _parse_output(outputs)
+
+            self.__track_event(
+                "chain",
+                "end",
+                run_id=str(run_id),
+                parent_run_id=str(parent_run_id) if parent_run_id else None,
+                output=output,
+                app_id=self.__app_id,
+            )
+        except Exception as e:
+            logger.error(f"[LLMonitor] An error occurred in on_chain_end: {e}")
+
+    def on_agent_action(
+        self,
+        action: AgentAction,
+        *,
+        run_id: UUID,
+        parent_run_id: Union[UUID, None] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if self.__has_valid_config is False:
+            return
+        try:
+            name = action.tool
+            input = _parse_input(action.tool_input)
+
+            self.__track_event(
+                "tool",
+                "start",
+                run_id=str(run_id),
+                parent_run_id=str(parent_run_id) if parent_run_id else None,
+                name=name,
+                input=input,
+                app_id=self.__app_id,
+            )
+        except Exception as e:
+            logger.error(f"[LLMonitor] An error occurred in on_agent_action: {e}")
+
+    def on_agent_finish(
+        self,
+        finish: AgentFinish,
+        *,
+        run_id: UUID,
+        parent_run_id: Union[UUID, None] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if self.__has_valid_config is False:
+            return
+        try:
+            output = _parse_output(finish.return_values)
+
+            self.__track_event(
+                "agent",
+                "end",
+                run_id=str(run_id),
+                parent_run_id=str(parent_run_id) if parent_run_id else None,
+                output=output,
+                app_id=self.__app_id,
+            )
+        except Exception as e:
+            logger.error(f"[LLMonitor] An error occurred in on_agent_finish: {e}")
+
+    def on_chain_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Union[UUID, None] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if self.__has_valid_config is False:
+            return
+        try:
+            self.__track_event(
+                "chain",
+                "error",
+                run_id=str(run_id),
+                parent_run_id=str(parent_run_id) if parent_run_id else None,
+                error={"message": str(error), "stack": traceback.format_exc()},
+                app_id=self.__app_id,
+            )
+        except Exception as e:
+            logger.error(f"[LLMonitor] An error occurred in on_chain_error: {e}")
+
+    def on_tool_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Union[UUID, None] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if self.__has_valid_config is False:
+            return
+        try:
+            self.__track_event(
+                "tool",
+                "error",
+                run_id=str(run_id),
+                parent_run_id=str(parent_run_id) if parent_run_id else None,
+                error={"message": str(error), "stack": traceback.format_exc()},
+                app_id=self.__app_id,
+            )
+        except Exception as e:
+            logger.error(f"[LLMonitor] An error occurred in on_tool_error: {e}")
+
+    def on_llm_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Union[UUID, None] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if self.__has_valid_config is False:
+            return
+        try:
+            self.__track_event(
+                "llm",
+                "error",
+                run_id=str(run_id),
+                parent_run_id=str(parent_run_id) if parent_run_id else None,
+                error={"message": str(error), "stack": traceback.format_exc()},
+                app_id=self.__app_id,
+            )
+        except Exception as e:
+            logger.error(f"[LLMonitor] An error occurred in on_llm_error: {e}")
+
+
+__all__ = ["LLMonitorCallbackHandler", "identify"]
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/manager.py b/llm/Lib/site-packages/langchain_community/callbacks/manager.py
new file mode 100644
index 0000000000000000000000000000000000000000..f5b4530ea295513903cdd5c64ef24f037bc175f2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/manager.py
@@ -0,0 +1,104 @@
+from __future__ import annotations
+
+import logging
+from contextlib import contextmanager
+from contextvars import ContextVar
+from typing import (
+    Generator,
+    Optional,
+)
+
+from langchain_core.tracers.context import register_configure_hook
+
+from langchain_community.callbacks.bedrock_anthropic_callback import (
+    BedrockAnthropicTokenUsageCallbackHandler,
+)
+from langchain_community.callbacks.openai_info import OpenAICallbackHandler
+from langchain_community.callbacks.tracers.comet import CometTracer
+from langchain_community.callbacks.tracers.wandb import WandbTracer
+
+logger = logging.getLogger(__name__)
+
+openai_callback_var: ContextVar[Optional[OpenAICallbackHandler]] = ContextVar(
+    "openai_callback", default=None
+)
+bedrock_anthropic_callback_var: (ContextVar)[
+    Optional[BedrockAnthropicTokenUsageCallbackHandler]
+] = ContextVar("bedrock_anthropic_callback", default=None)
+wandb_tracing_callback_var: ContextVar[Optional[WandbTracer]] = ContextVar(
+    "tracing_wandb_callback", default=None
+)
+comet_tracing_callback_var: ContextVar[Optional[CometTracer]] = ContextVar(  # noqa: E501
+    "tracing_comet_callback", default=None
+)
+
+register_configure_hook(openai_callback_var, True)
+register_configure_hook(bedrock_anthropic_callback_var, True)
+register_configure_hook(
+    wandb_tracing_callback_var, True, WandbTracer, "LANGCHAIN_WANDB_TRACING"
+)
+register_configure_hook(
+    comet_tracing_callback_var, True, CometTracer, "LANGCHAIN_COMET_TRACING"
+)
+
+
+@contextmanager
+def get_openai_callback() -> Generator[OpenAICallbackHandler, None, None]:
+    """Get the OpenAI callback handler in a context manager.
+    which conveniently exposes token and cost information.
+
+    Returns:
+        OpenAICallbackHandler: The OpenAI callback handler.
+
+    Example:
+        >>> with get_openai_callback() as cb:
+        ...     # Use the OpenAI callback handler
+    """
+    cb = OpenAICallbackHandler()
+    openai_callback_var.set(cb)
+    yield cb
+    openai_callback_var.set(None)
+
+
+@contextmanager
+def get_bedrock_anthropic_callback() -> (
+    Generator[BedrockAnthropicTokenUsageCallbackHandler, None, None]
+):
+    """Get the Bedrock anthropic callback handler in a context manager.
+    which conveniently exposes token and cost information.
+
+    Returns:
+        BedrockAnthropicTokenUsageCallbackHandler:
+            The Bedrock anthropic callback handler.
+
+    Example:
+        >>> with get_bedrock_anthropic_callback() as cb:
+        ...     # Use the Bedrock anthropic callback handler
+    """
+    cb = BedrockAnthropicTokenUsageCallbackHandler()
+    bedrock_anthropic_callback_var.set(cb)
+    yield cb
+    bedrock_anthropic_callback_var.set(None)
+
+
+@contextmanager
+def wandb_tracing_enabled(
+    session_name: str = "default",
+) -> Generator[None, None, None]:
+    """Get the WandbTracer in a context manager.
+
+    Args:
+        session_name (str, optional): The name of the session.
+            Defaults to "default".
+
+    Returns:
+        None
+
+    Example:
+        >>> with wandb_tracing_enabled() as session:
+        ...     # Use the WandbTracer session
+    """
+    cb = WandbTracer()
+    wandb_tracing_callback_var.set(cb)
+    yield None
+    wandb_tracing_callback_var.set(None)
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/mlflow_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/mlflow_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..294c3ec6825b1f49fa408e7244ad0fa359ebb1c2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/mlflow_callback.py
@@ -0,0 +1,776 @@
+import logging
+import os
+import random
+import string
+import tempfile
+import traceback
+from copy import deepcopy
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Sequence, Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.documents import Document
+from langchain_core.outputs import LLMResult
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.callbacks.utils import (
+    BaseMetadataCallbackHandler,
+    flatten_dict,
+    hash_string,
+    import_pandas,
+    import_spacy,
+    import_textstat,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def import_mlflow() -> Any:
+    """Import the mlflow python package and raise an error if it is not installed."""
+    try:
+        import mlflow
+    except ImportError:
+        raise ImportError(
+            "To use the mlflow callback manager you need to have the `mlflow` python "
+            "package installed. Please install it with `pip install mlflow>=2.3.0`"
+        )
+    return mlflow
+
+
+def mlflow_callback_metrics() -> List[str]:
+    """Get the metrics to log to MLFlow."""
+    return [
+        "step",
+        "starts",
+        "ends",
+        "errors",
+        "text_ctr",
+        "chain_starts",
+        "chain_ends",
+        "llm_starts",
+        "llm_ends",
+        "llm_streams",
+        "tool_starts",
+        "tool_ends",
+        "agent_ends",
+        "retriever_starts",
+        "retriever_ends",
+    ]
+
+
+def get_text_complexity_metrics() -> List[str]:
+    """Get the text complexity metrics from textstat."""
+    return [
+        "flesch_reading_ease",
+        "flesch_kincaid_grade",
+        "smog_index",
+        "coleman_liau_index",
+        "automated_readability_index",
+        "dale_chall_readability_score",
+        "difficult_words",
+        "linsear_write_formula",
+        "gunning_fog",
+        # "text_standard"
+        "fernandez_huerta",
+        "szigriszt_pazos",
+        "gutierrez_polini",
+        "crawford",
+        "gulpease_index",
+        "osman",
+    ]
+
+
+def analyze_text(
+    text: str,
+    nlp: Any = None,
+    textstat: Any = None,
+) -> dict:
+    """Analyze text using textstat and spacy.
+
+    Parameters:
+        text (str): The text to analyze.
+        nlp (spacy.lang): The spacy language model to use for visualization.
+        textstat: The textstat library to use for complexity metrics calculation.
+
+    Returns:
+        (dict): A dictionary containing the complexity metrics and visualization
+            files serialized to  HTML string.
+    """
+    resp: Dict[str, Any] = {}
+    if textstat is not None:
+        text_complexity_metrics = {
+            key: getattr(textstat, key)(text) for key in get_text_complexity_metrics()
+        }
+        resp.update({"text_complexity_metrics": text_complexity_metrics})
+        resp.update(text_complexity_metrics)
+
+    if nlp is not None:
+        spacy = import_spacy()
+        doc = nlp(text)
+
+        dep_out = spacy.displacy.render(doc, style="dep", jupyter=False, page=True)
+
+        ent_out = spacy.displacy.render(doc, style="ent", jupyter=False, page=True)
+
+        text_visualizations = {
+            "dependency_tree": dep_out,
+            "entities": ent_out,
+        }
+
+        resp.update(text_visualizations)
+
+    return resp
+
+
+def construct_html_from_prompt_and_generation(prompt: str, generation: str) -> Any:
+    """Construct an html element from a prompt and a generation.
+
+    Parameters:
+        prompt (str): The prompt.
+        generation (str): The generation.
+
+    Returns:
+        (str): The html string."""
+    formatted_prompt = prompt.replace("\n", "<br>")
+    formatted_generation = generation.replace("\n", "<br>")
+
+    return f"""
+    <p style="color:black;">{formatted_prompt}:</p>
+    <blockquote>
+      <p style="color:green;">
+        {formatted_generation}
+      </p>
+    </blockquote>
+    """
+
+
+class MlflowLogger:
+    """Callback Handler that logs metrics and artifacts to mlflow server.
+
+    Parameters:
+        name (str): Name of the run.
+        experiment (str): Name of the experiment.
+        tags (dict): Tags to be attached for the run.
+        tracking_uri (str): MLflow tracking server uri.
+
+    This handler implements the helper functions to initialize,
+    log metrics and artifacts to the mlflow server.
+    """
+
+    def __init__(self, **kwargs: Any):
+        self.mlflow = import_mlflow()
+        if "DATABRICKS_RUNTIME_VERSION" in os.environ:
+            self.mlflow.set_tracking_uri("databricks")
+            self.mlf_expid = self.mlflow.tracking.fluent._get_experiment_id()
+            self.mlf_exp = self.mlflow.get_experiment(self.mlf_expid)
+        else:
+            tracking_uri = get_from_dict_or_env(
+                kwargs, "tracking_uri", "MLFLOW_TRACKING_URI", ""
+            )
+            self.mlflow.set_tracking_uri(tracking_uri)
+
+            if run_id := kwargs.get("run_id"):
+                self.mlf_expid = self.mlflow.get_run(run_id).info.experiment_id
+            else:
+                # User can set other env variables described here
+                # > https://www.mlflow.org/docs/latest/tracking.html#logging-to-a-tracking-server
+
+                experiment_name = get_from_dict_or_env(
+                    kwargs, "experiment_name", "MLFLOW_EXPERIMENT_NAME"
+                )
+                self.mlf_exp = self.mlflow.get_experiment_by_name(experiment_name)
+                if self.mlf_exp is not None:
+                    self.mlf_expid = self.mlf_exp.experiment_id
+                else:
+                    self.mlf_expid = self.mlflow.create_experiment(experiment_name)
+
+        self.start_run(
+            kwargs["run_name"], kwargs["run_tags"], kwargs.get("run_id", None)
+        )
+        self.dir = kwargs.get("artifacts_dir", "")
+
+    def start_run(
+        self, name: str, tags: Dict[str, str], run_id: Optional[str] = None
+    ) -> None:
+        """
+        If run_id is provided, it will reuse the run with the given run_id.
+        Otherwise, it starts a new run, auto generates the random suffix for name.
+        """
+        if run_id is None:
+            if name.endswith("-%"):
+                rname = "".join(
+                    random.choices(string.ascii_uppercase + string.digits, k=7)
+                )
+                name = name[:-1] + rname
+            run = self.mlflow.MlflowClient().create_run(
+                self.mlf_expid, run_name=name, tags=tags
+            )
+            run_id = run.info.run_id
+        self.run_id = run_id
+
+    def finish_run(self) -> None:
+        """To finish the run."""
+        self.mlflow.end_run()
+
+    def metric(self, key: str, value: float) -> None:
+        """To log metric to mlflow server."""
+        self.mlflow.log_metric(key, value, run_id=self.run_id)
+
+    def metrics(
+        self, data: Union[Dict[str, float], Dict[str, int]], step: Optional[int] = 0
+    ) -> None:
+        """To log all metrics in the input dict."""
+        self.mlflow.log_metrics(data, run_id=self.run_id)
+
+    def jsonf(self, data: Dict[str, Any], filename: str) -> None:
+        """To log the input data as json file artifact."""
+        self.mlflow.log_dict(
+            data, os.path.join(self.dir, f"{filename}.json"), run_id=self.run_id
+        )
+
+    def table(self, name: str, dataframe: Any) -> None:
+        """To log the input pandas dataframe as a html table"""
+        self.html(dataframe.to_html(), f"table_{name}")
+
+    def html(self, html: str, filename: str) -> None:
+        """To log the input html string as html file artifact."""
+        self.mlflow.log_text(
+            html, os.path.join(self.dir, f"{filename}.html"), run_id=self.run_id
+        )
+
+    def text(self, text: str, filename: str) -> None:
+        """To log the input text as text file artifact."""
+        self.mlflow.log_text(
+            text, os.path.join(self.dir, f"{filename}.txt"), run_id=self.run_id
+        )
+
+    def artifact(self, path: str) -> None:
+        """To upload the file from given path as artifact."""
+        self.mlflow.log_artifact(path, run_id=self.run_id)
+
+    def langchain_artifact(self, chain: Any) -> None:
+        self.mlflow.langchain.log_model(chain, "langchain-model", run_id=self.run_id)
+
+
+class MlflowCallbackHandler(BaseMetadataCallbackHandler, BaseCallbackHandler):
+    """Callback Handler that logs metrics and artifacts to mlflow server.
+
+    Parameters:
+        name (str): Name of the run.
+        experiment (str): Name of the experiment.
+        tags (dict): Tags to be attached for the run.
+        tracking_uri (str): MLflow tracking server uri.
+
+    This handler will utilize the associated callback method called and formats
+    the input of each callback function with metadata regarding the state of LLM run,
+    and adds the response to the list of records for both the {method}_records and
+    action. It then logs the response to mlflow server.
+    """
+
+    def __init__(
+        self,
+        name: Optional[str] = "langchainrun-%",
+        experiment: Optional[str] = "langchain",
+        tags: Optional[Dict] = None,
+        tracking_uri: Optional[str] = None,
+        run_id: Optional[str] = None,
+        artifacts_dir: str = "",
+    ) -> None:
+        """Initialize callback handler."""
+        import_pandas()
+        import_mlflow()
+        super().__init__()
+
+        self.name = name
+        self.experiment = experiment
+        self.tags = tags or {}
+        self.tracking_uri = tracking_uri
+        self.run_id = run_id
+        self.artifacts_dir = artifacts_dir
+
+        self.temp_dir = tempfile.TemporaryDirectory()
+
+        self.mlflg = MlflowLogger(
+            tracking_uri=self.tracking_uri,
+            experiment_name=self.experiment,
+            run_name=self.name,
+            run_tags=self.tags,
+            run_id=self.run_id,
+            artifacts_dir=self.artifacts_dir,
+        )
+
+        self.action_records: list = []
+        self.nlp = None
+        try:
+            spacy = import_spacy()
+        except ImportError as e:
+            logger.warning(e.msg)
+        else:
+            try:
+                self.nlp = spacy.load("en_core_web_sm")
+            except OSError:
+                logger.warning(
+                    "Run `python -m spacy download en_core_web_sm` "
+                    "to download en_core_web_sm model for text visualization."
+                )
+
+        try:
+            self.textstat = import_textstat()
+        except ImportError as e:
+            logger.warning(e.msg)
+            self.textstat = None
+
+        self.metrics = {key: 0 for key in mlflow_callback_metrics()}
+
+        self.records: Dict[str, Any] = {
+            "on_llm_start_records": [],
+            "on_llm_token_records": [],
+            "on_llm_end_records": [],
+            "on_chain_start_records": [],
+            "on_chain_end_records": [],
+            "on_tool_start_records": [],
+            "on_tool_end_records": [],
+            "on_text_records": [],
+            "on_agent_finish_records": [],
+            "on_agent_action_records": [],
+            "on_retriever_start_records": [],
+            "on_retriever_end_records": [],
+            "action_records": [],
+        }
+
+    def _reset(self) -> None:
+        for k, v in self.metrics.items():
+            self.metrics[k] = 0
+        for k, v in self.records.items():
+            self.records[k] = []
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """Run when LLM starts."""
+        self.metrics["step"] += 1
+        self.metrics["llm_starts"] += 1
+        self.metrics["starts"] += 1
+
+        llm_starts = self.metrics["llm_starts"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_llm_start"})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.metrics)
+
+        self.mlflg.metrics(self.metrics, step=self.metrics["step"])
+
+        for idx, prompt in enumerate(prompts):
+            prompt_resp = deepcopy(resp)
+            prompt_resp["prompt"] = prompt
+            self.records["on_llm_start_records"].append(prompt_resp)
+            self.records["action_records"].append(prompt_resp)
+            self.mlflg.jsonf(prompt_resp, f"llm_start_{llm_starts}_prompt_{idx}")
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Run when LLM generates a new token."""
+        self.metrics["step"] += 1
+        self.metrics["llm_streams"] += 1
+
+        llm_streams = self.metrics["llm_streams"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_llm_new_token", "token": token})
+        resp.update(self.metrics)
+
+        self.mlflg.metrics(self.metrics, step=self.metrics["step"])
+
+        self.records["on_llm_token_records"].append(resp)
+        self.records["action_records"].append(resp)
+        self.mlflg.jsonf(resp, f"llm_new_tokens_{llm_streams}")
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Run when LLM ends running."""
+        self.metrics["step"] += 1
+        self.metrics["llm_ends"] += 1
+        self.metrics["ends"] += 1
+
+        llm_ends = self.metrics["llm_ends"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_llm_end"})
+        resp.update(flatten_dict(response.llm_output or {}))
+        resp.update(self.metrics)
+
+        self.mlflg.metrics(self.metrics, step=self.metrics["step"])
+
+        for generations in response.generations:
+            for idx, generation in enumerate(generations):
+                generation_resp = deepcopy(resp)
+                generation_resp.update(flatten_dict(generation.dict()))
+                generation_resp.update(
+                    analyze_text(
+                        generation.text,
+                        nlp=self.nlp,
+                        textstat=self.textstat,
+                    )
+                )
+                if "text_complexity_metrics" in generation_resp:
+                    complexity_metrics: Dict[str, float] = generation_resp.pop(
+                        "text_complexity_metrics"
+                    )
+                    self.mlflg.metrics(
+                        complexity_metrics,
+                        step=self.metrics["step"],
+                    )
+                self.records["on_llm_end_records"].append(generation_resp)
+                self.records["action_records"].append(generation_resp)
+                self.mlflg.jsonf(resp, f"llm_end_{llm_ends}_generation_{idx}")
+                if "dependency_tree" in generation_resp:
+                    dependency_tree = generation_resp["dependency_tree"]
+                    self.mlflg.html(
+                        dependency_tree, "dep-" + hash_string(generation.text)
+                    )
+                if "entities" in generation_resp:
+                    entities = generation_resp["entities"]
+                    self.mlflg.html(entities, "ent-" + hash_string(generation.text))
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when LLM errors."""
+        self.metrics["step"] += 1
+        self.metrics["errors"] += 1
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Run when chain starts running."""
+        self.metrics["step"] += 1
+        self.metrics["chain_starts"] += 1
+        self.metrics["starts"] += 1
+
+        chain_starts = self.metrics["chain_starts"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_chain_start"})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.metrics)
+
+        self.mlflg.metrics(self.metrics, step=self.metrics["step"])
+
+        if isinstance(inputs, dict):
+            chain_input = ",".join([f"{k}={v}" for k, v in inputs.items()])
+        elif isinstance(inputs, list):
+            chain_input = ",".join([str(input) for input in inputs])
+        else:
+            chain_input = str(inputs)
+        input_resp = deepcopy(resp)
+        input_resp["inputs"] = chain_input
+        self.records["on_chain_start_records"].append(input_resp)
+        self.records["action_records"].append(input_resp)
+        self.mlflg.jsonf(input_resp, f"chain_start_{chain_starts}")
+
+    def on_chain_end(
+        self, outputs: Union[Dict[str, Any], str, List[str]], **kwargs: Any
+    ) -> None:
+        """Run when chain ends running."""
+        self.metrics["step"] += 1
+        self.metrics["chain_ends"] += 1
+        self.metrics["ends"] += 1
+
+        chain_ends = self.metrics["chain_ends"]
+
+        resp: Dict[str, Any] = {}
+        if isinstance(outputs, dict):
+            chain_output = ",".join([f"{k}={v}" for k, v in outputs.items()])
+        elif isinstance(outputs, list):
+            chain_output = ",".join(map(str, outputs))
+        else:
+            chain_output = str(outputs)
+        resp.update({"action": "on_chain_end", "outputs": chain_output})
+        resp.update(self.metrics)
+
+        self.mlflg.metrics(self.metrics, step=self.metrics["step"])
+
+        self.records["on_chain_end_records"].append(resp)
+        self.records["action_records"].append(resp)
+        self.mlflg.jsonf(resp, f"chain_end_{chain_ends}")
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when chain errors."""
+        self.metrics["step"] += 1
+        self.metrics["errors"] += 1
+
+    def on_tool_start(
+        self, serialized: Dict[str, Any], input_str: str, **kwargs: Any
+    ) -> None:
+        """Run when tool starts running."""
+        self.metrics["step"] += 1
+        self.metrics["tool_starts"] += 1
+        self.metrics["starts"] += 1
+
+        tool_starts = self.metrics["tool_starts"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_tool_start", "input_str": input_str})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.metrics)
+
+        self.mlflg.metrics(self.metrics, step=self.metrics["step"])
+
+        self.records["on_tool_start_records"].append(resp)
+        self.records["action_records"].append(resp)
+        self.mlflg.jsonf(resp, f"tool_start_{tool_starts}")
+
+    def on_tool_end(self, output: Any, **kwargs: Any) -> None:
+        """Run when tool ends running."""
+        output = str(output)
+        self.metrics["step"] += 1
+        self.metrics["tool_ends"] += 1
+        self.metrics["ends"] += 1
+
+        tool_ends = self.metrics["tool_ends"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_tool_end", "output": output})
+        resp.update(self.metrics)
+
+        self.mlflg.metrics(self.metrics, step=self.metrics["step"])
+
+        self.records["on_tool_end_records"].append(resp)
+        self.records["action_records"].append(resp)
+        self.mlflg.jsonf(resp, f"tool_end_{tool_ends}")
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when tool errors."""
+        self.metrics["step"] += 1
+        self.metrics["errors"] += 1
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        """
+        Run when text is received.
+        """
+        self.metrics["step"] += 1
+        self.metrics["text_ctr"] += 1
+
+        text_ctr = self.metrics["text_ctr"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_text", "text": text})
+        resp.update(self.metrics)
+
+        self.mlflg.metrics(self.metrics, step=self.metrics["step"])
+
+        self.records["on_text_records"].append(resp)
+        self.records["action_records"].append(resp)
+        self.mlflg.jsonf(resp, f"on_text_{text_ctr}")
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        """Run when agent ends running."""
+        self.metrics["step"] += 1
+        self.metrics["agent_ends"] += 1
+        self.metrics["ends"] += 1
+
+        agent_ends = self.metrics["agent_ends"]
+        resp: Dict[str, Any] = {}
+        resp.update(
+            {
+                "action": "on_agent_finish",
+                "output": finish.return_values["output"],
+                "log": finish.log,
+            }
+        )
+        resp.update(self.metrics)
+
+        self.mlflg.metrics(self.metrics, step=self.metrics["step"])
+
+        self.records["on_agent_finish_records"].append(resp)
+        self.records["action_records"].append(resp)
+        self.mlflg.jsonf(resp, f"agent_finish_{agent_ends}")
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Run on agent action."""
+        self.metrics["step"] += 1
+        self.metrics["tool_starts"] += 1
+        self.metrics["starts"] += 1
+
+        tool_starts = self.metrics["tool_starts"]
+        resp: Dict[str, Any] = {}
+        resp.update(
+            {
+                "action": "on_agent_action",
+                "tool": action.tool,
+                "tool_input": action.tool_input,
+                "log": action.log,
+            }
+        )
+        resp.update(self.metrics)
+        self.mlflg.metrics(self.metrics, step=self.metrics["step"])
+        self.records["on_agent_action_records"].append(resp)
+        self.records["action_records"].append(resp)
+        self.mlflg.jsonf(resp, f"agent_action_{tool_starts}")
+
+    def on_retriever_start(
+        self,
+        serialized: Dict[str, Any],
+        query: str,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when Retriever starts running."""
+        self.metrics["step"] += 1
+        self.metrics["retriever_starts"] += 1
+        self.metrics["starts"] += 1
+
+        retriever_starts = self.metrics["retriever_starts"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_retriever_start", "query": query})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.metrics)
+
+        self.mlflg.metrics(self.metrics, step=self.metrics["step"])
+
+        self.records["on_retriever_start_records"].append(resp)
+        self.records["action_records"].append(resp)
+        self.mlflg.jsonf(resp, f"retriever_start_{retriever_starts}")
+
+    def on_retriever_end(
+        self,
+        documents: Sequence[Document],
+        **kwargs: Any,
+    ) -> Any:
+        """Run when Retriever ends running."""
+        self.metrics["step"] += 1
+        self.metrics["retriever_ends"] += 1
+        self.metrics["ends"] += 1
+
+        retriever_ends = self.metrics["retriever_ends"]
+
+        resp: Dict[str, Any] = {}
+        retriever_documents = [
+            {
+                "page_content": doc.page_content,
+                "metadata": {
+                    k: (
+                        str(v)
+                        if not isinstance(v, list)
+                        else ",".join(str(x) for x in v)
+                    )
+                    for k, v in doc.metadata.items()
+                },
+            }
+            for doc in documents
+        ]
+        resp.update({"action": "on_retriever_end", "documents": retriever_documents})
+        resp.update(self.metrics)
+
+        self.mlflg.metrics(self.metrics, step=self.metrics["step"])
+
+        self.records["on_retriever_end_records"].append(resp)
+        self.records["action_records"].append(resp)
+        self.mlflg.jsonf(resp, f"retriever_end_{retriever_ends}")
+
+    def on_retriever_error(self, error: BaseException, **kwargs: Any) -> Any:
+        """Run when Retriever errors."""
+        self.metrics["step"] += 1
+        self.metrics["errors"] += 1
+
+    def _create_session_analysis_df(self) -> Any:
+        """Create a dataframe with all the information from the session."""
+        pd = import_pandas()
+        on_llm_start_records_df = pd.DataFrame(self.records["on_llm_start_records"])
+        on_llm_end_records_df = pd.DataFrame(self.records["on_llm_end_records"])
+
+        llm_input_columns = ["step", "prompt"]
+        if "name" in on_llm_start_records_df.columns:
+            llm_input_columns.append("name")
+        elif "id" in on_llm_start_records_df.columns:
+            # id is llm class's full import path. For example:
+            # ["langchain", "llms", "openai", "AzureOpenAI"]
+            on_llm_start_records_df["name"] = on_llm_start_records_df["id"].apply(
+                lambda id_: id_[-1]
+            )
+            llm_input_columns.append("name")
+        llm_input_prompts_df = (
+            on_llm_start_records_df[llm_input_columns]
+            .dropna(axis=1)
+            .rename({"step": "prompt_step"}, axis=1)
+        )
+        complexity_metrics_columns = (
+            get_text_complexity_metrics() if self.textstat is not None else []
+        )
+        visualizations_columns = (
+            ["dependency_tree", "entities"] if self.nlp is not None else []
+        )
+
+        token_usage_columns = [
+            "token_usage_total_tokens",
+            "token_usage_prompt_tokens",
+            "token_usage_completion_tokens",
+        ]
+        token_usage_columns = [
+            x for x in token_usage_columns if x in on_llm_end_records_df.columns
+        ]
+
+        llm_outputs_df = (
+            on_llm_end_records_df[
+                [
+                    "step",
+                    "text",
+                ]
+                + token_usage_columns
+                + complexity_metrics_columns
+                + visualizations_columns
+            ]
+            .dropna(axis=1)
+            .rename({"step": "output_step", "text": "output"}, axis=1)
+        )
+        session_analysis_df = pd.concat([llm_input_prompts_df, llm_outputs_df], axis=1)
+        session_analysis_df["chat_html"] = session_analysis_df[
+            ["prompt", "output"]
+        ].apply(
+            lambda row: construct_html_from_prompt_and_generation(
+                row["prompt"], row["output"]
+            ),
+            axis=1,
+        )
+        return session_analysis_df
+
+    def _contain_llm_records(self) -> bool:
+        return bool(self.records["on_llm_start_records"])
+
+    def flush_tracker(self, langchain_asset: Any = None, finish: bool = False) -> None:
+        pd = import_pandas()
+        self.mlflg.table("action_records", pd.DataFrame(self.records["action_records"]))
+        if self._contain_llm_records():
+            session_analysis_df = self._create_session_analysis_df()
+            chat_html = session_analysis_df.pop("chat_html")
+            chat_html = chat_html.replace("\n", "", regex=True)
+            self.mlflg.table("session_analysis", pd.DataFrame(session_analysis_df))
+            self.mlflg.html("".join(chat_html.tolist()), "chat_html")
+
+        if langchain_asset:
+            # To avoid circular import error
+            # mlflow only supports LLMChain asset
+            if "langchain.chains.llm.LLMChain" in str(type(langchain_asset)):
+                self.mlflg.langchain_artifact(langchain_asset)
+            else:
+                langchain_asset_path = str(Path(self.temp_dir.name, "model.json"))
+                try:
+                    langchain_asset.save(langchain_asset_path)
+                    self.mlflg.artifact(langchain_asset_path)
+                except ValueError:
+                    try:
+                        langchain_asset.save_agent(langchain_asset_path)
+                        self.mlflg.artifact(langchain_asset_path)
+                    except AttributeError:
+                        print("Could not save model.")  # noqa: T201
+                        traceback.print_exc()
+                        pass
+                    except NotImplementedError:
+                        print("Could not save model.")  # noqa: T201
+                        traceback.print_exc()
+                        pass
+                except NotImplementedError:
+                    print("Could not save model.")  # noqa: T201
+                    traceback.print_exc()
+                    pass
+        if finish:
+            self.mlflg.finish_run()
+            self._reset()
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/openai_info.py b/llm/Lib/site-packages/langchain_community/callbacks/openai_info.py
new file mode 100644
index 0000000000000000000000000000000000000000..849f1e2532c0e1604addd1e7f3687ece9ff05b59
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/openai_info.py
@@ -0,0 +1,240 @@
+"""Callback Handler that prints to std out."""
+import threading
+from typing import Any, Dict, List
+
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.outputs import LLMResult
+
+MODEL_COST_PER_1K_TOKENS = {
+    # GPT-4 input
+    "gpt-4": 0.03,
+    "gpt-4-0314": 0.03,
+    "gpt-4-0613": 0.03,
+    "gpt-4-32k": 0.06,
+    "gpt-4-32k-0314": 0.06,
+    "gpt-4-32k-0613": 0.06,
+    "gpt-4-vision-preview": 0.01,
+    "gpt-4-1106-preview": 0.01,
+    "gpt-4-0125-preview": 0.01,
+    "gpt-4-turbo-preview": 0.01,
+    "gpt-4-turbo": 0.01,
+    "gpt-4-turbo-2024-04-09": 0.01,
+    # GPT-4 output
+    "gpt-4-completion": 0.06,
+    "gpt-4-0314-completion": 0.06,
+    "gpt-4-0613-completion": 0.06,
+    "gpt-4-32k-completion": 0.12,
+    "gpt-4-32k-0314-completion": 0.12,
+    "gpt-4-32k-0613-completion": 0.12,
+    "gpt-4-vision-preview-completion": 0.03,
+    "gpt-4-1106-preview-completion": 0.03,
+    "gpt-4-0125-preview-completion": 0.03,
+    "gpt-4-turbo-preview-completion": 0.03,
+    "gpt-4-turbo-completion": 0.03,
+    "gpt-4-turbo-2024-04-09-completion": 0.03,
+    # GPT-3.5 input
+    # gpt-3.5-turbo points at gpt-3.5-turbo-0613 until Feb 16, 2024.
+    # Switches to gpt-3.5-turbo-0125 after.
+    "gpt-3.5-turbo": 0.0015,
+    "gpt-3.5-turbo-0125": 0.0005,
+    "gpt-3.5-turbo-0301": 0.0015,
+    "gpt-3.5-turbo-0613": 0.0015,
+    "gpt-3.5-turbo-1106": 0.001,
+    "gpt-3.5-turbo-instruct": 0.0015,
+    "gpt-3.5-turbo-16k": 0.003,
+    "gpt-3.5-turbo-16k-0613": 0.003,
+    # GPT-3.5 output
+    # gpt-3.5-turbo points at gpt-3.5-turbo-0613 until Feb 16, 2024.
+    # Switches to gpt-3.5-turbo-0125 after.
+    "gpt-3.5-turbo-completion": 0.002,
+    "gpt-3.5-turbo-0125-completion": 0.0015,
+    "gpt-3.5-turbo-0301-completion": 0.002,
+    "gpt-3.5-turbo-0613-completion": 0.002,
+    "gpt-3.5-turbo-1106-completion": 0.002,
+    "gpt-3.5-turbo-instruct-completion": 0.002,
+    "gpt-3.5-turbo-16k-completion": 0.004,
+    "gpt-3.5-turbo-16k-0613-completion": 0.004,
+    # Azure GPT-35 input
+    "gpt-35-turbo": 0.0015,  # Azure OpenAI version of ChatGPT
+    "gpt-35-turbo-0301": 0.0015,  # Azure OpenAI version of ChatGPT
+    "gpt-35-turbo-0613": 0.0015,
+    "gpt-35-turbo-instruct": 0.0015,
+    "gpt-35-turbo-16k": 0.003,
+    "gpt-35-turbo-16k-0613": 0.003,
+    # Azure GPT-35 output
+    "gpt-35-turbo-completion": 0.002,  # Azure OpenAI version of ChatGPT
+    "gpt-35-turbo-0301-completion": 0.002,  # Azure OpenAI version of ChatGPT
+    "gpt-35-turbo-0613-completion": 0.002,
+    "gpt-35-turbo-instruct-completion": 0.002,
+    "gpt-35-turbo-16k-completion": 0.004,
+    "gpt-35-turbo-16k-0613-completion": 0.004,
+    # Others
+    "text-ada-001": 0.0004,
+    "ada": 0.0004,
+    "text-babbage-001": 0.0005,
+    "babbage": 0.0005,
+    "text-curie-001": 0.002,
+    "curie": 0.002,
+    "text-davinci-003": 0.02,
+    "text-davinci-002": 0.02,
+    "code-davinci-002": 0.02,
+    # Fine Tuned input
+    "babbage-002-finetuned": 0.0016,
+    "davinci-002-finetuned": 0.012,
+    "gpt-3.5-turbo-0613-finetuned": 0.012,
+    "gpt-3.5-turbo-1106-finetuned": 0.012,
+    # Fine Tuned output
+    "babbage-002-finetuned-completion": 0.0016,
+    "davinci-002-finetuned-completion": 0.012,
+    "gpt-3.5-turbo-0613-finetuned-completion": 0.016,
+    "gpt-3.5-turbo-1106-finetuned-completion": 0.016,
+    # Azure Fine Tuned input
+    "babbage-002-azure-finetuned": 0.0004,
+    "davinci-002-azure-finetuned": 0.002,
+    "gpt-35-turbo-0613-azure-finetuned": 0.0015,
+    # Azure Fine Tuned output
+    "babbage-002-azure-finetuned-completion": 0.0004,
+    "davinci-002-azure-finetuned-completion": 0.002,
+    "gpt-35-turbo-0613-azure-finetuned-completion": 0.002,
+    # Legacy fine-tuned models
+    "ada-finetuned-legacy": 0.0016,
+    "babbage-finetuned-legacy": 0.0024,
+    "curie-finetuned-legacy": 0.012,
+    "davinci-finetuned-legacy": 0.12,
+}
+
+
+def standardize_model_name(
+    model_name: str,
+    is_completion: bool = False,
+) -> str:
+    """
+    Standardize the model name to a format that can be used in the OpenAI API.
+
+    Args:
+        model_name: Model name to standardize.
+        is_completion: Whether the model is used for completion or not.
+            Defaults to False.
+
+    Returns:
+        Standardized model name.
+
+    """
+    model_name = model_name.lower()
+    if ".ft-" in model_name:
+        model_name = model_name.split(".ft-")[0] + "-azure-finetuned"
+    if ":ft-" in model_name:
+        model_name = model_name.split(":")[0] + "-finetuned-legacy"
+    if "ft:" in model_name:
+        model_name = model_name.split(":")[1] + "-finetuned"
+    if is_completion and (
+        model_name.startswith("gpt-4")
+        or model_name.startswith("gpt-3.5")
+        or model_name.startswith("gpt-35")
+        or ("finetuned" in model_name and "legacy" not in model_name)
+    ):
+        return model_name + "-completion"
+    else:
+        return model_name
+
+
+def get_openai_token_cost_for_model(
+    model_name: str, num_tokens: int, is_completion: bool = False
+) -> float:
+    """
+    Get the cost in USD for a given model and number of tokens.
+
+    Args:
+        model_name: Name of the model
+        num_tokens: Number of tokens.
+        is_completion: Whether the model is used for completion or not.
+            Defaults to False.
+
+    Returns:
+        Cost in USD.
+    """
+    model_name = standardize_model_name(model_name, is_completion=is_completion)
+    if model_name not in MODEL_COST_PER_1K_TOKENS:
+        raise ValueError(
+            f"Unknown model: {model_name}. Please provide a valid OpenAI model name."
+            "Known models are: " + ", ".join(MODEL_COST_PER_1K_TOKENS.keys())
+        )
+    return MODEL_COST_PER_1K_TOKENS[model_name] * (num_tokens / 1000)
+
+
+class OpenAICallbackHandler(BaseCallbackHandler):
+    """Callback Handler that tracks OpenAI info."""
+
+    total_tokens: int = 0
+    prompt_tokens: int = 0
+    completion_tokens: int = 0
+    successful_requests: int = 0
+    total_cost: float = 0.0
+
+    def __init__(self) -> None:
+        super().__init__()
+        self._lock = threading.Lock()
+
+    def __repr__(self) -> str:
+        return (
+            f"Tokens Used: {self.total_tokens}\n"
+            f"\tPrompt Tokens: {self.prompt_tokens}\n"
+            f"\tCompletion Tokens: {self.completion_tokens}\n"
+            f"Successful Requests: {self.successful_requests}\n"
+            f"Total Cost (USD): ${self.total_cost}"
+        )
+
+    @property
+    def always_verbose(self) -> bool:
+        """Whether to call verbose callbacks even if verbose is False."""
+        return True
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """Print out the prompts."""
+        pass
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Print out the token."""
+        pass
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Collect token usage."""
+        if response.llm_output is None:
+            return None
+
+        if "token_usage" not in response.llm_output:
+            with self._lock:
+                self.successful_requests += 1
+            return None
+
+        # compute tokens and cost for this request
+        token_usage = response.llm_output["token_usage"]
+        completion_tokens = token_usage.get("completion_tokens", 0)
+        prompt_tokens = token_usage.get("prompt_tokens", 0)
+        model_name = standardize_model_name(response.llm_output.get("model_name", ""))
+        if model_name in MODEL_COST_PER_1K_TOKENS:
+            completion_cost = get_openai_token_cost_for_model(
+                model_name, completion_tokens, is_completion=True
+            )
+            prompt_cost = get_openai_token_cost_for_model(model_name, prompt_tokens)
+        else:
+            completion_cost = 0
+            prompt_cost = 0
+
+        # update shared state behind lock
+        with self._lock:
+            self.total_cost += prompt_cost + completion_cost
+            self.total_tokens += token_usage.get("total_tokens", 0)
+            self.prompt_tokens += prompt_tokens
+            self.completion_tokens += completion_tokens
+            self.successful_requests += 1
+
+    def __copy__(self) -> "OpenAICallbackHandler":
+        """Return a copy of the callback handler."""
+        return self
+
+    def __deepcopy__(self, memo: Any) -> "OpenAICallbackHandler":
+        """Return a deep copy of the callback handler."""
+        return self
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/promptlayer_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/promptlayer_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..f9431681246a5018eeac65db1c8f2940739e472b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/promptlayer_callback.py
@@ -0,0 +1,162 @@
+"""Callback handler for promptlayer."""
+from __future__ import annotations
+
+import datetime
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, Tuple
+from uuid import UUID
+
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    ChatMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import (
+    ChatGeneration,
+    LLMResult,
+)
+
+if TYPE_CHECKING:
+    import promptlayer
+
+
+def _lazy_import_promptlayer() -> promptlayer:
+    """Lazy import promptlayer to avoid circular imports."""
+    try:
+        import promptlayer
+    except ImportError:
+        raise ImportError(
+            "The PromptLayerCallbackHandler requires the promptlayer package. "
+            " Please install it with `pip install promptlayer`."
+        )
+    return promptlayer
+
+
+class PromptLayerCallbackHandler(BaseCallbackHandler):
+    """Callback handler for promptlayer."""
+
+    def __init__(
+        self,
+        pl_id_callback: Optional[Callable[..., Any]] = None,
+        pl_tags: Optional[List[str]] = None,
+    ) -> None:
+        """Initialize the PromptLayerCallbackHandler."""
+        _lazy_import_promptlayer()
+        self.pl_id_callback = pl_id_callback
+        self.pl_tags = pl_tags or []
+        self.runs: Dict[UUID, Dict[str, Any]] = {}
+
+    def on_chat_model_start(
+        self,
+        serialized: Dict[str, Any],
+        messages: List[List[BaseMessage]],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Any:
+        self.runs[run_id] = {
+            "messages": [self._create_message_dicts(m)[0] for m in messages],
+            "invocation_params": kwargs.get("invocation_params", {}),
+            "name": ".".join(serialized["id"]),
+            "request_start_time": datetime.datetime.now().timestamp(),
+            "tags": tags,
+        }
+
+    def on_llm_start(
+        self,
+        serialized: Dict[str, Any],
+        prompts: List[str],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Any:
+        self.runs[run_id] = {
+            "prompts": prompts,
+            "invocation_params": kwargs.get("invocation_params", {}),
+            "name": ".".join(serialized["id"]),
+            "request_start_time": datetime.datetime.now().timestamp(),
+            "tags": tags,
+        }
+
+    def on_llm_end(
+        self,
+        response: LLMResult,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> None:
+        from promptlayer.utils import get_api_key, promptlayer_api_request
+
+        run_info = self.runs.get(run_id, {})
+        if not run_info:
+            return
+        run_info["request_end_time"] = datetime.datetime.now().timestamp()
+        for i in range(len(response.generations)):
+            generation = response.generations[i][0]
+
+            resp = {
+                "text": generation.text,
+                "llm_output": response.llm_output,
+            }
+            model_params = run_info.get("invocation_params", {})
+            is_chat_model = run_info.get("messages", None) is not None
+            model_input = (
+                run_info.get("messages", [])[i]
+                if is_chat_model
+                else [run_info.get("prompts", [])[i]]
+            )
+            model_response = (
+                [self._convert_message_to_dict(generation.message)]
+                if is_chat_model and isinstance(generation, ChatGeneration)
+                else resp
+            )
+
+            pl_request_id = promptlayer_api_request(
+                run_info.get("name"),
+                "langchain",
+                model_input,
+                model_params,
+                self.pl_tags,
+                model_response,
+                run_info.get("request_start_time"),
+                run_info.get("request_end_time"),
+                get_api_key(),
+                return_pl_id=bool(self.pl_id_callback is not None),
+                metadata={
+                    "_langchain_run_id": str(run_id),
+                    "_langchain_parent_run_id": str(parent_run_id),
+                    "_langchain_tags": str(run_info.get("tags", [])),
+                },
+            )
+
+            if self.pl_id_callback:
+                self.pl_id_callback(pl_request_id)
+
+    def _convert_message_to_dict(self, message: BaseMessage) -> Dict[str, Any]:
+        if isinstance(message, HumanMessage):
+            message_dict = {"role": "user", "content": message.content}
+        elif isinstance(message, AIMessage):
+            message_dict = {"role": "assistant", "content": message.content}
+        elif isinstance(message, SystemMessage):
+            message_dict = {"role": "system", "content": message.content}
+        elif isinstance(message, ChatMessage):
+            message_dict = {"role": message.role, "content": message.content}
+        else:
+            raise ValueError(f"Got unknown type {message}")
+        if "name" in message.additional_kwargs:
+            message_dict["name"] = message.additional_kwargs["name"]
+        return message_dict
+
+    def _create_message_dicts(
+        self, messages: List[BaseMessage]
+    ) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+        params: Dict[str, Any] = {}
+        message_dicts = [self._convert_message_to_dict(m) for m in messages]
+        return message_dicts, params
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/sagemaker_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/sagemaker_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..45295a0b5f7e2c8d2b3f7054c62cd1428b3974a9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/sagemaker_callback.py
@@ -0,0 +1,277 @@
+import json
+import os
+import shutil
+import tempfile
+from copy import deepcopy
+from typing import Any, Dict, List, Optional
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.outputs import LLMResult
+
+from langchain_community.callbacks.utils import (
+    flatten_dict,
+)
+
+
+def save_json(data: dict, file_path: str) -> None:
+    """Save dict to local file path.
+
+    Parameters:
+        data (dict): The dictionary to be saved.
+        file_path (str): Local file path.
+    """
+    with open(file_path, "w") as outfile:
+        json.dump(data, outfile)
+
+
+class SageMakerCallbackHandler(BaseCallbackHandler):
+    """Callback Handler that logs prompt artifacts and metrics to SageMaker Experiments.
+
+    Parameters:
+        run (sagemaker.experiments.run.Run): Run object where the experiment is logged.
+    """
+
+    def __init__(self, run: Any) -> None:
+        """Initialize callback handler."""
+        super().__init__()
+
+        self.run = run
+
+        self.metrics = {
+            "step": 0,
+            "starts": 0,
+            "ends": 0,
+            "errors": 0,
+            "text_ctr": 0,
+            "chain_starts": 0,
+            "chain_ends": 0,
+            "llm_starts": 0,
+            "llm_ends": 0,
+            "llm_streams": 0,
+            "tool_starts": 0,
+            "tool_ends": 0,
+            "agent_ends": 0,
+        }
+
+        # Create a temporary directory
+        self.temp_dir = tempfile.mkdtemp()
+
+    def _reset(self) -> None:
+        for k, v in self.metrics.items():
+            self.metrics[k] = 0
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """Run when LLM starts."""
+        self.metrics["step"] += 1
+        self.metrics["llm_starts"] += 1
+        self.metrics["starts"] += 1
+
+        llm_starts = self.metrics["llm_starts"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_llm_start"})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.metrics)
+
+        for idx, prompt in enumerate(prompts):
+            prompt_resp = deepcopy(resp)
+            prompt_resp["prompt"] = prompt
+            self.jsonf(
+                prompt_resp,
+                self.temp_dir,
+                f"llm_start_{llm_starts}_prompt_{idx}",
+            )
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Run when LLM generates a new token."""
+        self.metrics["step"] += 1
+        self.metrics["llm_streams"] += 1
+
+        llm_streams = self.metrics["llm_streams"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_llm_new_token", "token": token})
+        resp.update(self.metrics)
+
+        self.jsonf(resp, self.temp_dir, f"llm_new_tokens_{llm_streams}")
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Run when LLM ends running."""
+        self.metrics["step"] += 1
+        self.metrics["llm_ends"] += 1
+        self.metrics["ends"] += 1
+
+        llm_ends = self.metrics["llm_ends"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_llm_end"})
+        resp.update(flatten_dict(response.llm_output or {}))
+
+        resp.update(self.metrics)
+
+        for generations in response.generations:
+            for idx, generation in enumerate(generations):
+                generation_resp = deepcopy(resp)
+                generation_resp.update(flatten_dict(generation.dict()))
+
+                self.jsonf(
+                    resp,
+                    self.temp_dir,
+                    f"llm_end_{llm_ends}_generation_{idx}",
+                )
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when LLM errors."""
+        self.metrics["step"] += 1
+        self.metrics["errors"] += 1
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Run when chain starts running."""
+        self.metrics["step"] += 1
+        self.metrics["chain_starts"] += 1
+        self.metrics["starts"] += 1
+
+        chain_starts = self.metrics["chain_starts"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_chain_start"})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.metrics)
+
+        chain_input = ",".join([f"{k}={v}" for k, v in inputs.items()])
+        input_resp = deepcopy(resp)
+        input_resp["inputs"] = chain_input
+
+        self.jsonf(input_resp, self.temp_dir, f"chain_start_{chain_starts}")
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Run when chain ends running."""
+        self.metrics["step"] += 1
+        self.metrics["chain_ends"] += 1
+        self.metrics["ends"] += 1
+
+        chain_ends = self.metrics["chain_ends"]
+
+        resp: Dict[str, Any] = {}
+        chain_output = ",".join([f"{k}={v}" for k, v in outputs.items()])
+        resp.update({"action": "on_chain_end", "outputs": chain_output})
+        resp.update(self.metrics)
+
+        self.jsonf(resp, self.temp_dir, f"chain_end_{chain_ends}")
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when chain errors."""
+        self.metrics["step"] += 1
+        self.metrics["errors"] += 1
+
+    def on_tool_start(
+        self, serialized: Dict[str, Any], input_str: str, **kwargs: Any
+    ) -> None:
+        """Run when tool starts running."""
+        self.metrics["step"] += 1
+        self.metrics["tool_starts"] += 1
+        self.metrics["starts"] += 1
+
+        tool_starts = self.metrics["tool_starts"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_tool_start", "input_str": input_str})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.metrics)
+
+        self.jsonf(resp, self.temp_dir, f"tool_start_{tool_starts}")
+
+    def on_tool_end(self, output: Any, **kwargs: Any) -> None:
+        """Run when tool ends running."""
+        output = str(output)
+        self.metrics["step"] += 1
+        self.metrics["tool_ends"] += 1
+        self.metrics["ends"] += 1
+
+        tool_ends = self.metrics["tool_ends"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_tool_end", "output": output})
+        resp.update(self.metrics)
+
+        self.jsonf(resp, self.temp_dir, f"tool_end_{tool_ends}")
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when tool errors."""
+        self.metrics["step"] += 1
+        self.metrics["errors"] += 1
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        """
+        Run when agent is ending.
+        """
+        self.metrics["step"] += 1
+        self.metrics["text_ctr"] += 1
+
+        text_ctr = self.metrics["text_ctr"]
+
+        resp: Dict[str, Any] = {}
+        resp.update({"action": "on_text", "text": text})
+        resp.update(self.metrics)
+
+        self.jsonf(resp, self.temp_dir, f"on_text_{text_ctr}")
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        """Run when agent ends running."""
+        self.metrics["step"] += 1
+        self.metrics["agent_ends"] += 1
+        self.metrics["ends"] += 1
+
+        agent_ends = self.metrics["agent_ends"]
+        resp: Dict[str, Any] = {}
+        resp.update(
+            {
+                "action": "on_agent_finish",
+                "output": finish.return_values["output"],
+                "log": finish.log,
+            }
+        )
+        resp.update(self.metrics)
+
+        self.jsonf(resp, self.temp_dir, f"agent_finish_{agent_ends}")
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Run on agent action."""
+        self.metrics["step"] += 1
+        self.metrics["tool_starts"] += 1
+        self.metrics["starts"] += 1
+
+        tool_starts = self.metrics["tool_starts"]
+        resp: Dict[str, Any] = {}
+        resp.update(
+            {
+                "action": "on_agent_action",
+                "tool": action.tool,
+                "tool_input": action.tool_input,
+                "log": action.log,
+            }
+        )
+        resp.update(self.metrics)
+        self.jsonf(resp, self.temp_dir, f"agent_action_{tool_starts}")
+
+    def jsonf(
+        self,
+        data: Dict[str, Any],
+        data_dir: str,
+        filename: str,
+        is_output: Optional[bool] = True,
+    ) -> None:
+        """To log the input data as json file artifact."""
+        file_path = os.path.join(data_dir, f"{filename}.json")
+        save_json(data, file_path)
+        self.run.log_file(file_path, name=filename, is_output=is_output)
+
+    def flush_tracker(self) -> None:
+        """Reset the steps and delete the temporary local directory."""
+        self._reset()
+        shutil.rmtree(self.temp_dir)
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/streamlit/__init__.py b/llm/Lib/site-packages/langchain_community/callbacks/streamlit/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4ee2ea5a9fb2deed660fc6409d97e66fc88b0bf2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/streamlit/__init__.py
@@ -0,0 +1,82 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Optional
+
+from langchain_core.callbacks import BaseCallbackHandler
+
+from langchain_community.callbacks.streamlit.streamlit_callback_handler import (
+    LLMThoughtLabeler as LLMThoughtLabeler,
+)
+from langchain_community.callbacks.streamlit.streamlit_callback_handler import (
+    StreamlitCallbackHandler as _InternalStreamlitCallbackHandler,
+)
+
+if TYPE_CHECKING:
+    from streamlit.delta_generator import DeltaGenerator
+
+
+def StreamlitCallbackHandler(
+    parent_container: DeltaGenerator,
+    *,
+    max_thought_containers: int = 4,
+    expand_new_thoughts: bool = True,
+    collapse_completed_thoughts: bool = True,
+    thought_labeler: Optional[LLMThoughtLabeler] = None,
+) -> BaseCallbackHandler:
+    """Callback Handler that writes to a Streamlit app.
+
+    This CallbackHandler is geared towards
+    use with a LangChain Agent; it displays the Agent's LLM and tool-usage "thoughts"
+    inside a series of Streamlit expanders.
+
+    Parameters
+    ----------
+    parent_container
+        The `st.container` that will contain all the Streamlit elements that the
+        Handler creates.
+    max_thought_containers
+        The max number of completed LLM thought containers to show at once. When this
+        threshold is reached, a new thought will cause the oldest thoughts to be
+        collapsed into a "History" expander. Defaults to 4.
+    expand_new_thoughts
+        Each LLM "thought" gets its own `st.expander`. This param controls whether that
+        expander is expanded by default. Defaults to True.
+    collapse_completed_thoughts
+        If True, LLM thought expanders will be collapsed when completed.
+        Defaults to True.
+    thought_labeler
+        An optional custom LLMThoughtLabeler instance. If unspecified, the handler
+        will use the default thought labeling logic. Defaults to None.
+
+    Returns
+    -------
+    A new StreamlitCallbackHandler instance.
+
+    Note that this is an "auto-updating" API: if the installed version of Streamlit
+    has a more recent StreamlitCallbackHandler implementation, an instance of that class
+    will be used.
+
+    """
+    # If we're using a version of Streamlit that implements StreamlitCallbackHandler,
+    # delegate to it instead of using our built-in handler. The official handler is
+    # guaranteed to support the same set of kwargs.
+    try:
+        from streamlit.external.langchain import (
+            StreamlitCallbackHandler as OfficialStreamlitCallbackHandler,
+        )
+
+        return OfficialStreamlitCallbackHandler(
+            parent_container,
+            max_thought_containers=max_thought_containers,
+            expand_new_thoughts=expand_new_thoughts,
+            collapse_completed_thoughts=collapse_completed_thoughts,
+            thought_labeler=thought_labeler,
+        )
+    except ImportError:
+        return _InternalStreamlitCallbackHandler(
+            parent_container,
+            max_thought_containers=max_thought_containers,
+            expand_new_thoughts=expand_new_thoughts,
+            collapse_completed_thoughts=collapse_completed_thoughts,
+            thought_labeler=thought_labeler,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/streamlit/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/streamlit/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c866b2571f0661acf94931d95b2c1c286004137c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/streamlit/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/streamlit/__pycache__/mutable_expander.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/streamlit/__pycache__/mutable_expander.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7491b709f0871c88289c088b2292cbd7cb7fbdef
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/streamlit/__pycache__/mutable_expander.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/streamlit/__pycache__/streamlit_callback_handler.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/streamlit/__pycache__/streamlit_callback_handler.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3dce0a39b85d0cfac9e44110786fa0390b248a9e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/streamlit/__pycache__/streamlit_callback_handler.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/streamlit/mutable_expander.py b/llm/Lib/site-packages/langchain_community/callbacks/streamlit/mutable_expander.py
new file mode 100644
index 0000000000000000000000000000000000000000..9870e472242e8868f7a9f3b70bf6146323470464
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/streamlit/mutable_expander.py
@@ -0,0 +1,156 @@
+from __future__ import annotations
+
+from enum import Enum
+from typing import TYPE_CHECKING, Any, Dict, List, NamedTuple, Optional
+
+if TYPE_CHECKING:
+    from streamlit.delta_generator import DeltaGenerator
+    from streamlit.type_util import SupportsStr
+
+
+class ChildType(Enum):
+    """Enumerator of the child type."""
+
+    MARKDOWN = "MARKDOWN"
+    EXCEPTION = "EXCEPTION"
+
+
+class ChildRecord(NamedTuple):
+    """Child record as a NamedTuple."""
+
+    type: ChildType
+    kwargs: Dict[str, Any]
+    dg: DeltaGenerator
+
+
+class MutableExpander:
+    """Streamlit expander that can be renamed and dynamically expanded/collapsed."""
+
+    def __init__(self, parent_container: DeltaGenerator, label: str, expanded: bool):
+        """Create a new MutableExpander.
+
+        Parameters
+        ----------
+        parent_container
+            The `st.container` that the expander will be created inside.
+
+            The expander transparently deletes and recreates its underlying
+            `st.expander` instance when its label changes, and it uses
+            `parent_container` to ensure it recreates this underlying expander in the
+            same location onscreen.
+        label
+            The expander's initial label.
+        expanded
+            The expander's initial `expanded` value.
+        """
+        self._label = label
+        self._expanded = expanded
+        self._parent_cursor = parent_container.empty()
+        self._container = self._parent_cursor.expander(label, expanded)
+        self._child_records: List[ChildRecord] = []
+
+    @property
+    def label(self) -> str:
+        """Expander's label string."""
+        return self._label
+
+    @property
+    def expanded(self) -> bool:
+        """True if the expander was created with `expanded=True`."""
+        return self._expanded
+
+    def clear(self) -> None:
+        """Remove the container and its contents entirely. A cleared container can't
+        be reused.
+        """
+        self._container = self._parent_cursor.empty()
+        self._child_records.clear()
+
+    def append_copy(self, other: MutableExpander) -> None:
+        """Append a copy of another MutableExpander's children to this
+        MutableExpander.
+        """
+        other_records = other._child_records.copy()
+        for record in other_records:
+            self._create_child(record.type, record.kwargs)
+
+    def update(
+        self, *, new_label: Optional[str] = None, new_expanded: Optional[bool] = None
+    ) -> None:
+        """Change the expander's label and expanded state"""
+        if new_label is None:
+            new_label = self._label
+        if new_expanded is None:
+            new_expanded = self._expanded
+
+        if self._label == new_label and self._expanded == new_expanded:
+            # No change!
+            return
+
+        self._label = new_label
+        self._expanded = new_expanded
+        self._container = self._parent_cursor.expander(new_label, new_expanded)
+
+        prev_records = self._child_records
+        self._child_records = []
+
+        # Replay all children into the new container
+        for record in prev_records:
+            self._create_child(record.type, record.kwargs)
+
+    def markdown(
+        self,
+        body: SupportsStr,
+        unsafe_allow_html: bool = False,
+        *,
+        help: Optional[str] = None,
+        index: Optional[int] = None,
+    ) -> int:
+        """Add a Markdown element to the container and return its index."""
+        kwargs = {"body": body, "unsafe_allow_html": unsafe_allow_html, "help": help}
+        new_dg = self._get_dg(index).markdown(**kwargs)
+        record = ChildRecord(ChildType.MARKDOWN, kwargs, new_dg)
+        return self._add_record(record, index)
+
+    def exception(
+        self, exception: BaseException, *, index: Optional[int] = None
+    ) -> int:
+        """Add an Exception element to the container and return its index."""
+        kwargs = {"exception": exception}
+        new_dg = self._get_dg(index).exception(**kwargs)
+        record = ChildRecord(ChildType.EXCEPTION, kwargs, new_dg)
+        return self._add_record(record, index)
+
+    def _create_child(self, type: ChildType, kwargs: Dict[str, Any]) -> None:
+        """Create a new child with the given params"""
+        if type == ChildType.MARKDOWN:
+            self.markdown(**kwargs)
+        elif type == ChildType.EXCEPTION:
+            self.exception(**kwargs)
+        else:
+            raise RuntimeError(f"Unexpected child type {type}")
+
+    def _add_record(self, record: ChildRecord, index: Optional[int]) -> int:
+        """Add a ChildRecord to self._children. If `index` is specified, replace
+        the existing record at that index. Otherwise, append the record to the
+        end of the list.
+
+        Return the index of the added record.
+        """
+        if index is not None:
+            # Replace existing child
+            self._child_records[index] = record
+            return index
+
+        # Append new child
+        self._child_records.append(record)
+        return len(self._child_records) - 1
+
+    def _get_dg(self, index: Optional[int]) -> DeltaGenerator:
+        if index is not None:
+            # Existing index: reuse child's DeltaGenerator
+            assert 0 <= index < len(self._child_records), f"Bad index: {index}"
+            return self._child_records[index].dg
+
+        # No index: use container's DeltaGenerator
+        return self._container
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/streamlit/streamlit_callback_handler.py b/llm/Lib/site-packages/langchain_community/callbacks/streamlit/streamlit_callback_handler.py
new file mode 100644
index 0000000000000000000000000000000000000000..0d065e95dd34c77cd2b7aaa48712654221b264cd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/streamlit/streamlit_callback_handler.py
@@ -0,0 +1,415 @@
+"""Callback Handler that prints to streamlit."""
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import TYPE_CHECKING, Any, Dict, List, NamedTuple, Optional
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.outputs import LLMResult
+
+from langchain_community.callbacks.streamlit.mutable_expander import MutableExpander
+
+if TYPE_CHECKING:
+    from streamlit.delta_generator import DeltaGenerator
+
+
+def _convert_newlines(text: str) -> str:
+    """Convert newline characters to markdown newline sequences
+    (space, space, newline).
+    """
+    return text.replace("\n", "  \n")
+
+
+CHECKMARK_EMOJI = "✅"
+THINKING_EMOJI = ":thinking_face:"
+HISTORY_EMOJI = ":books:"
+EXCEPTION_EMOJI = "⚠️"
+
+
+class LLMThoughtState(Enum):
+    """Enumerator of the LLMThought state."""
+
+    # The LLM is thinking about what to do next. We don't know which tool we'll run.
+    THINKING = "THINKING"
+    # The LLM has decided to run a tool. We don't have results from the tool yet.
+    RUNNING_TOOL = "RUNNING_TOOL"
+    # We have results from the tool.
+    COMPLETE = "COMPLETE"
+
+
+class ToolRecord(NamedTuple):
+    """Tool record as a NamedTuple."""
+
+    name: str
+    input_str: str
+
+
+class LLMThoughtLabeler:
+    """
+    Generates markdown labels for LLMThought containers. Pass a custom
+    subclass of this to StreamlitCallbackHandler to override its default
+    labeling logic.
+    """
+
+    def get_initial_label(self) -> str:
+        """Return the markdown label for a new LLMThought that doesn't have
+        an associated tool yet.
+        """
+        return f"{THINKING_EMOJI} **Thinking...**"
+
+    def get_tool_label(self, tool: ToolRecord, is_complete: bool) -> str:
+        """Return the label for an LLMThought that has an associated
+        tool.
+
+        Parameters
+        ----------
+        tool
+            The tool's ToolRecord
+
+        is_complete
+            True if the thought is complete; False if the thought
+            is still receiving input.
+
+        Returns
+        -------
+        The markdown label for the thought's container.
+
+        """
+        input = tool.input_str
+        name = tool.name
+        emoji = CHECKMARK_EMOJI if is_complete else THINKING_EMOJI
+        if name == "_Exception":
+            emoji = EXCEPTION_EMOJI
+            name = "Parsing error"
+        idx = min([60, len(input)])
+        input = input[0:idx]
+        if len(tool.input_str) > idx:
+            input = input + "..."
+        input = input.replace("\n", " ")
+        label = f"{emoji} **{name}:** {input}"
+        return label
+
+    def get_history_label(self) -> str:
+        """Return a markdown label for the special 'history' container
+        that contains overflow thoughts.
+        """
+        return f"{HISTORY_EMOJI} **History**"
+
+    def get_final_agent_thought_label(self) -> str:
+        """Return the markdown label for the agent's final thought -
+        the "Now I have the answer" thought, that doesn't involve
+        a tool.
+        """
+        return f"{CHECKMARK_EMOJI} **Complete!**"
+
+
+class LLMThought:
+    """A thought in the LLM's thought stream."""
+
+    def __init__(
+        self,
+        parent_container: DeltaGenerator,
+        labeler: LLMThoughtLabeler,
+        expanded: bool,
+        collapse_on_complete: bool,
+    ):
+        """Initialize the LLMThought.
+
+        Args:
+            parent_container: The container we're writing into.
+            labeler: The labeler to use for this thought.
+            expanded: Whether the thought should be expanded by default.
+            collapse_on_complete: Whether the thought should be collapsed.
+        """
+        self._container = MutableExpander(
+            parent_container=parent_container,
+            label=labeler.get_initial_label(),
+            expanded=expanded,
+        )
+        self._state = LLMThoughtState.THINKING
+        self._llm_token_stream = ""
+        self._llm_token_writer_idx: Optional[int] = None
+        self._last_tool: Optional[ToolRecord] = None
+        self._collapse_on_complete = collapse_on_complete
+        self._labeler = labeler
+
+    @property
+    def container(self) -> MutableExpander:
+        """The container we're writing into."""
+        return self._container
+
+    @property
+    def last_tool(self) -> Optional[ToolRecord]:
+        """The last tool executed by this thought"""
+        return self._last_tool
+
+    def _reset_llm_token_stream(self) -> None:
+        self._llm_token_stream = ""
+        self._llm_token_writer_idx = None
+
+    def on_llm_start(self, serialized: Dict[str, Any], prompts: List[str]) -> None:
+        self._reset_llm_token_stream()
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        # This is only called when the LLM is initialized with `streaming=True`
+        self._llm_token_stream += _convert_newlines(token)
+        self._llm_token_writer_idx = self._container.markdown(
+            self._llm_token_stream, index=self._llm_token_writer_idx
+        )
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        # `response` is the concatenation of all the tokens received by the LLM.
+        # If we're receiving streaming tokens from `on_llm_new_token`, this response
+        # data is redundant
+        self._reset_llm_token_stream()
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        self._container.markdown("**LLM encountered an error...**")
+        self._container.exception(error)
+
+    def on_tool_start(
+        self, serialized: Dict[str, Any], input_str: str, **kwargs: Any
+    ) -> None:
+        # Called with the name of the tool we're about to run (in `serialized[name]`),
+        # and its input. We change our container's label to be the tool name.
+        self._state = LLMThoughtState.RUNNING_TOOL
+        tool_name = serialized["name"]
+        self._last_tool = ToolRecord(name=tool_name, input_str=input_str)
+        self._container.update(
+            new_label=self._labeler.get_tool_label(self._last_tool, is_complete=False)
+        )
+
+    def on_tool_end(
+        self,
+        output: Any,
+        color: Optional[str] = None,
+        observation_prefix: Optional[str] = None,
+        llm_prefix: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        self._container.markdown(f"**{str(output)}**")
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        self._container.markdown("**Tool encountered an error...**")
+        self._container.exception(error)
+
+    def on_agent_action(
+        self, action: AgentAction, color: Optional[str] = None, **kwargs: Any
+    ) -> Any:
+        # Called when we're about to kick off a new tool. The `action` data
+        # tells us the tool we're about to use, and the input we'll give it.
+        # We don't output anything here, because we'll receive this same data
+        # when `on_tool_start` is called immediately after.
+        pass
+
+    def complete(self, final_label: Optional[str] = None) -> None:
+        """Finish the thought."""
+        if final_label is None and self._state == LLMThoughtState.RUNNING_TOOL:
+            assert (
+                self._last_tool is not None
+            ), "_last_tool should never be null when _state == RUNNING_TOOL"
+            final_label = self._labeler.get_tool_label(
+                self._last_tool, is_complete=True
+            )
+        self._state = LLMThoughtState.COMPLETE
+        if self._collapse_on_complete:
+            self._container.update(new_label=final_label, new_expanded=False)
+        else:
+            self._container.update(new_label=final_label)
+
+    def clear(self) -> None:
+        """Remove the thought from the screen. A cleared thought can't be reused."""
+        self._container.clear()
+
+
+class StreamlitCallbackHandler(BaseCallbackHandler):
+    """Callback handler that writes to a Streamlit app."""
+
+    def __init__(
+        self,
+        parent_container: DeltaGenerator,
+        *,
+        max_thought_containers: int = 4,
+        expand_new_thoughts: bool = True,
+        collapse_completed_thoughts: bool = True,
+        thought_labeler: Optional[LLMThoughtLabeler] = None,
+    ):
+        """Create a StreamlitCallbackHandler instance.
+
+        Parameters
+        ----------
+        parent_container
+            The `st.container` that will contain all the Streamlit elements that the
+            Handler creates.
+        max_thought_containers
+            The max number of completed LLM thought containers to show at once. When
+            this threshold is reached, a new thought will cause the oldest thoughts to
+            be collapsed into a "History" expander. Defaults to 4.
+        expand_new_thoughts
+            Each LLM "thought" gets its own `st.expander`. This param controls whether
+            that expander is expanded by default. Defaults to True.
+        collapse_completed_thoughts
+            If True, LLM thought expanders will be collapsed when completed.
+            Defaults to True.
+        thought_labeler
+            An optional custom LLMThoughtLabeler instance. If unspecified, the handler
+            will use the default thought labeling logic. Defaults to None.
+        """
+        self._parent_container = parent_container
+        self._history_parent = parent_container.container()
+        self._history_container: Optional[MutableExpander] = None
+        self._current_thought: Optional[LLMThought] = None
+        self._completed_thoughts: List[LLMThought] = []
+        self._max_thought_containers = max(max_thought_containers, 1)
+        self._expand_new_thoughts = expand_new_thoughts
+        self._collapse_completed_thoughts = collapse_completed_thoughts
+        self._thought_labeler = thought_labeler or LLMThoughtLabeler()
+
+    def _require_current_thought(self) -> LLMThought:
+        """Return our current LLMThought. Raise an error if we have no current
+        thought.
+        """
+        if self._current_thought is None:
+            raise RuntimeError("Current LLMThought is unexpectedly None!")
+        return self._current_thought
+
+    def _get_last_completed_thought(self) -> Optional[LLMThought]:
+        """Return our most recent completed LLMThought, or None if we don't have one."""
+        if len(self._completed_thoughts) > 0:
+            return self._completed_thoughts[len(self._completed_thoughts) - 1]
+        return None
+
+    @property
+    def _num_thought_containers(self) -> int:
+        """The number of 'thought containers' we're currently showing: the
+        number of completed thought containers, the history container (if it exists),
+        and the current thought container (if it exists).
+        """
+        count = len(self._completed_thoughts)
+        if self._history_container is not None:
+            count += 1
+        if self._current_thought is not None:
+            count += 1
+        return count
+
+    def _complete_current_thought(self, final_label: Optional[str] = None) -> None:
+        """Complete the current thought, optionally assigning it a new label.
+        Add it to our _completed_thoughts list.
+        """
+        thought = self._require_current_thought()
+        thought.complete(final_label)
+        self._completed_thoughts.append(thought)
+        self._current_thought = None
+
+    def _prune_old_thought_containers(self) -> None:
+        """If we have too many thoughts onscreen, move older thoughts to the
+        'history container.'
+        """
+        while (
+            self._num_thought_containers > self._max_thought_containers
+            and len(self._completed_thoughts) > 0
+        ):
+            # Create our history container if it doesn't exist, and if
+            # max_thought_containers is > 1. (if max_thought_containers is 1, we don't
+            # have room to show history.)
+            if self._history_container is None and self._max_thought_containers > 1:
+                self._history_container = MutableExpander(
+                    self._history_parent,
+                    label=self._thought_labeler.get_history_label(),
+                    expanded=False,
+                )
+
+            oldest_thought = self._completed_thoughts.pop(0)
+            if self._history_container is not None:
+                self._history_container.markdown(oldest_thought.container.label)
+                self._history_container.append_copy(oldest_thought.container)
+            oldest_thought.clear()
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        if self._current_thought is None:
+            self._current_thought = LLMThought(
+                parent_container=self._parent_container,
+                expanded=self._expand_new_thoughts,
+                collapse_on_complete=self._collapse_completed_thoughts,
+                labeler=self._thought_labeler,
+            )
+
+        self._current_thought.on_llm_start(serialized, prompts)
+
+        # We don't prune_old_thought_containers here, because our container won't
+        # be visible until it has a child.
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        self._require_current_thought().on_llm_new_token(token, **kwargs)
+        self._prune_old_thought_containers()
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        self._require_current_thought().on_llm_end(response, **kwargs)
+        self._prune_old_thought_containers()
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        self._require_current_thought().on_llm_error(error, **kwargs)
+        self._prune_old_thought_containers()
+
+    def on_tool_start(
+        self, serialized: Dict[str, Any], input_str: str, **kwargs: Any
+    ) -> None:
+        self._require_current_thought().on_tool_start(serialized, input_str, **kwargs)
+        self._prune_old_thought_containers()
+
+    def on_tool_end(
+        self,
+        output: Any,
+        color: Optional[str] = None,
+        observation_prefix: Optional[str] = None,
+        llm_prefix: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        output = str(output)
+        self._require_current_thought().on_tool_end(
+            output, color, observation_prefix, llm_prefix, **kwargs
+        )
+        self._complete_current_thought()
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        self._require_current_thought().on_tool_error(error, **kwargs)
+        self._prune_old_thought_containers()
+
+    def on_text(
+        self,
+        text: str,
+        color: Optional[str] = None,
+        end: str = "",
+        **kwargs: Any,
+    ) -> None:
+        pass
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        pass
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        pass
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        pass
+
+    def on_agent_action(
+        self, action: AgentAction, color: Optional[str] = None, **kwargs: Any
+    ) -> Any:
+        self._require_current_thought().on_agent_action(action, color, **kwargs)
+        self._prune_old_thought_containers()
+
+    def on_agent_finish(
+        self, finish: AgentFinish, color: Optional[str] = None, **kwargs: Any
+    ) -> None:
+        if self._current_thought is not None:
+            self._current_thought.complete(
+                self._thought_labeler.get_final_agent_thought_label()
+            )
+            self._current_thought = None
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/tracers/__init__.py b/llm/Lib/site-packages/langchain_community/callbacks/tracers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..8af691585a64db47ed81d1af23c798ac02d9235a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/tracers/__init__.py
@@ -0,0 +1,18 @@
+"""Tracers that record execution of LangChain runs."""
+
+from langchain_core.tracers.langchain import LangChainTracer
+from langchain_core.tracers.langchain_v1 import LangChainTracerV1
+from langchain_core.tracers.stdout import (
+    ConsoleCallbackHandler,
+    FunctionCallbackHandler,
+)
+
+from langchain_community.callbacks.tracers.wandb import WandbTracer
+
+__all__ = [
+    "ConsoleCallbackHandler",
+    "FunctionCallbackHandler",
+    "LangChainTracer",
+    "LangChainTracerV1",
+    "WandbTracer",
+]
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/tracers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/tracers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7553dd7e090f771c4e439ac311894296ef8bbc50
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/tracers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/tracers/__pycache__/comet.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/tracers/__pycache__/comet.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..af58588ef8203ff5a56000d6c373475660ea96bc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/tracers/__pycache__/comet.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/tracers/__pycache__/wandb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/callbacks/tracers/__pycache__/wandb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..68cd9bb3399c5a3429743897a8e97726a58870c6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/callbacks/tracers/__pycache__/wandb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/tracers/comet.py b/llm/Lib/site-packages/langchain_community/callbacks/tracers/comet.py
new file mode 100644
index 0000000000000000000000000000000000000000..d3577e722e4cba9f8fd218d8cfa3125c2521d5c4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/tracers/comet.py
@@ -0,0 +1,143 @@
+from types import ModuleType, SimpleNamespace
+from typing import TYPE_CHECKING, Any, Callable, Dict
+
+from langchain_core.tracers import BaseTracer
+
+if TYPE_CHECKING:
+    from uuid import UUID
+
+    from comet_llm import Span
+    from comet_llm.chains.chain import Chain
+
+    from langchain_community.callbacks.tracers.schemas import Run
+
+
+def _get_run_type(run: "Run") -> str:
+    if isinstance(run.run_type, str):
+        return run.run_type
+    elif hasattr(run.run_type, "value"):
+        return run.run_type.value
+    else:
+        return str(run.run_type)
+
+
+def import_comet_llm_api() -> SimpleNamespace:
+    """Import comet_llm api and raise an error if it is not installed."""
+    try:
+        from comet_llm import (
+            experiment_info,  # noqa: F401
+            flush,  # noqa: F401
+        )
+        from comet_llm.chains import api as chain_api  # noqa: F401
+        from comet_llm.chains import (
+            chain,  # noqa: F401
+            span,  # noqa: F401
+        )
+
+    except ImportError:
+        raise ImportError(
+            "To use the CometTracer you need to have the "
+            "`comet_llm>=2.0.0` python package installed. Please install it with"
+            " `pip install -U comet_llm`"
+        )
+    return SimpleNamespace(
+        chain=chain,
+        span=span,
+        chain_api=chain_api,
+        experiment_info=experiment_info,
+        flush=flush,
+    )
+
+
+class CometTracer(BaseTracer):
+    """Comet Tracer."""
+
+    def __init__(self, **kwargs: Any) -> None:
+        """Initialize the Comet Tracer."""
+        super().__init__(**kwargs)
+        self._span_map: Dict["UUID", "Span"] = {}
+        """Map from run id to span."""
+        self._chains_map: Dict["UUID", "Chain"] = {}
+        """Map from run id to chain."""
+        self._initialize_comet_modules()
+
+    def _initialize_comet_modules(self) -> None:
+        comet_llm_api = import_comet_llm_api()
+        self._chain: ModuleType = comet_llm_api.chain
+        self._span: ModuleType = comet_llm_api.span
+        self._chain_api: ModuleType = comet_llm_api.chain_api
+        self._experiment_info: ModuleType = comet_llm_api.experiment_info
+        self._flush: Callable[[], None] = comet_llm_api.flush
+
+    def _persist_run(self, run: "Run") -> None:
+        chain_ = self._chains_map[run.id]
+        chain_.set_outputs(outputs=run.outputs)
+        self._chain_api.log_chain(chain_)
+
+    def _process_start_trace(self, run: "Run") -> None:
+        if not run.parent_run_id:
+            # This is the first run, which maps to a chain
+            chain_: "Chain" = self._chain.Chain(
+                inputs=run.inputs,
+                metadata=None,
+                experiment_info=self._experiment_info.get(),
+            )
+            self._chains_map[run.id] = chain_
+        else:
+            span: "Span" = self._span.Span(
+                inputs=run.inputs,
+                category=_get_run_type(run),
+                metadata=run.extra,
+                name=run.name,
+            )
+            span.__api__start__(self._chains_map[run.parent_run_id])
+            self._chains_map[run.id] = self._chains_map[run.parent_run_id]
+            self._span_map[run.id] = span
+
+    def _process_end_trace(self, run: "Run") -> None:
+        if not run.parent_run_id:
+            pass
+            # Langchain will call _persist_run for us
+        else:
+            span = self._span_map[run.id]
+            span.set_outputs(outputs=run.outputs)
+            span.__api__end__()
+
+    def flush(self) -> None:
+        self._flush()
+
+    def _on_llm_start(self, run: "Run") -> None:
+        """Process the LLM Run upon start."""
+        self._process_start_trace(run)
+
+    def _on_llm_end(self, run: "Run") -> None:
+        """Process the LLM Run."""
+        self._process_end_trace(run)
+
+    def _on_llm_error(self, run: "Run") -> None:
+        """Process the LLM Run upon error."""
+        self._process_end_trace(run)
+
+    def _on_chain_start(self, run: "Run") -> None:
+        """Process the Chain Run upon start."""
+        self._process_start_trace(run)
+
+    def _on_chain_end(self, run: "Run") -> None:
+        """Process the Chain Run."""
+        self._process_end_trace(run)
+
+    def _on_chain_error(self, run: "Run") -> None:
+        """Process the Chain Run upon error."""
+        self._process_end_trace(run)
+
+    def _on_tool_start(self, run: "Run") -> None:
+        """Process the Tool Run upon start."""
+        self._process_start_trace(run)
+
+    def _on_tool_end(self, run: "Run") -> None:
+        """Process the Tool Run."""
+        self._process_end_trace(run)
+
+    def _on_tool_error(self, run: "Run") -> None:
+        """Process the Tool Run upon error."""
+        self._process_end_trace(run)
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/tracers/wandb.py b/llm/Lib/site-packages/langchain_community/callbacks/tracers/wandb.py
new file mode 100644
index 0000000000000000000000000000000000000000..00753a5af1a2473ffff500820bf45a13f00b7447
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/tracers/wandb.py
@@ -0,0 +1,513 @@
+"""A Tracer Implementation that records activity to Weights & Biases."""
+from __future__ import annotations
+
+import json
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    TypedDict,
+    Union,
+)
+
+from langchain_core.tracers.base import BaseTracer
+from langchain_core.tracers.schemas import Run
+
+if TYPE_CHECKING:
+    from wandb import Settings as WBSettings
+    from wandb.sdk.data_types.trace_tree import Span
+    from wandb.sdk.lib.paths import StrPath
+    from wandb.wandb_run import Run as WBRun
+
+
+PRINT_WARNINGS = True
+
+
+def _serialize_io(run_inputs: Optional[dict]) -> dict:
+    if not run_inputs:
+        return {}
+    from google.protobuf.json_format import MessageToJson
+    from google.protobuf.message import Message
+
+    serialized_inputs = {}
+    for key, value in run_inputs.items():
+        if isinstance(value, Message):
+            serialized_inputs[key] = MessageToJson(value)
+        elif key == "input_documents":
+            serialized_inputs.update(
+                {f"input_document_{i}": doc.json() for i, doc in enumerate(value)}
+            )
+        else:
+            serialized_inputs[key] = value
+    return serialized_inputs
+
+
+class RunProcessor:
+    """Handles the conversion of a LangChain Runs into a WBTraceTree."""
+
+    def __init__(self, wandb_module: Any, trace_module: Any):
+        self.wandb = wandb_module
+        self.trace_tree = trace_module
+
+    def process_span(self, run: Run) -> Optional["Span"]:
+        """Converts a LangChain Run into a W&B Trace Span.
+        :param run: The LangChain Run to convert.
+        :return: The converted W&B Trace Span.
+        """
+        try:
+            span = self._convert_lc_run_to_wb_span(run)
+            return span
+        except Exception as e:
+            if PRINT_WARNINGS:
+                self.wandb.termwarn(
+                    f"Skipping trace saving - unable to safely convert LangChain Run "
+                    f"into W&B Trace due to: {e}"
+                )
+            return None
+
+    def _convert_run_to_wb_span(self, run: Run) -> "Span":
+        """Base utility to create a span from a run.
+        :param run: The run to convert.
+        :return: The converted Span.
+        """
+        attributes = {**run.extra} if run.extra else {}
+        attributes["execution_order"] = run.execution_order
+
+        return self.trace_tree.Span(
+            span_id=str(run.id) if run.id is not None else None,
+            name=run.name,
+            start_time_ms=int(run.start_time.timestamp() * 1000),
+            end_time_ms=int(run.end_time.timestamp() * 1000)
+            if run.end_time is not None
+            else None,
+            status_code=self.trace_tree.StatusCode.SUCCESS
+            if run.error is None
+            else self.trace_tree.StatusCode.ERROR,
+            status_message=run.error,
+            attributes=attributes,
+        )
+
+    def _convert_llm_run_to_wb_span(self, run: Run) -> "Span":
+        """Converts a LangChain LLM Run into a W&B Trace Span.
+        :param run: The LangChain LLM Run to convert.
+        :return: The converted W&B Trace Span.
+        """
+        base_span = self._convert_run_to_wb_span(run)
+        if base_span.attributes is None:
+            base_span.attributes = {}
+        base_span.attributes["llm_output"] = (run.outputs or {}).get("llm_output", {})
+
+        base_span.results = [
+            self.trace_tree.Result(
+                inputs={"prompt": prompt},
+                outputs={
+                    f"gen_{g_i}": gen["text"]
+                    for g_i, gen in enumerate(run.outputs["generations"][ndx])
+                }
+                if (
+                    run.outputs is not None
+                    and len(run.outputs["generations"]) > ndx
+                    and len(run.outputs["generations"][ndx]) > 0
+                )
+                else None,
+            )
+            for ndx, prompt in enumerate(run.inputs["prompts"] or [])
+        ]
+        base_span.span_kind = self.trace_tree.SpanKind.LLM
+
+        return base_span
+
+    def _convert_chain_run_to_wb_span(self, run: Run) -> "Span":
+        """Converts a LangChain Chain Run into a W&B Trace Span.
+        :param run: The LangChain Chain Run to convert.
+        :return: The converted W&B Trace Span.
+        """
+        base_span = self._convert_run_to_wb_span(run)
+
+        base_span.results = [
+            self.trace_tree.Result(
+                inputs=_serialize_io(run.inputs), outputs=_serialize_io(run.outputs)
+            )
+        ]
+        base_span.child_spans = [
+            self._convert_lc_run_to_wb_span(child_run) for child_run in run.child_runs
+        ]
+        base_span.span_kind = (
+            self.trace_tree.SpanKind.AGENT
+            if "agent" in run.name.lower()
+            else self.trace_tree.SpanKind.CHAIN
+        )
+
+        return base_span
+
+    def _convert_tool_run_to_wb_span(self, run: Run) -> "Span":
+        """Converts a LangChain Tool Run into a W&B Trace Span.
+        :param run: The LangChain Tool Run to convert.
+        :return: The converted W&B Trace Span.
+        """
+        base_span = self._convert_run_to_wb_span(run)
+        base_span.results = [
+            self.trace_tree.Result(
+                inputs=_serialize_io(run.inputs), outputs=_serialize_io(run.outputs)
+            )
+        ]
+        base_span.child_spans = [
+            self._convert_lc_run_to_wb_span(child_run) for child_run in run.child_runs
+        ]
+        base_span.span_kind = self.trace_tree.SpanKind.TOOL
+
+        return base_span
+
+    def _convert_lc_run_to_wb_span(self, run: Run) -> "Span":
+        """Utility to convert any generic LangChain Run into a W&B Trace Span.
+        :param run: The LangChain Run to convert.
+        :return: The converted W&B Trace Span.
+        """
+        if run.run_type == "llm":
+            return self._convert_llm_run_to_wb_span(run)
+        elif run.run_type == "chain":
+            return self._convert_chain_run_to_wb_span(run)
+        elif run.run_type == "tool":
+            return self._convert_tool_run_to_wb_span(run)
+        else:
+            return self._convert_run_to_wb_span(run)
+
+    def process_model(self, run: Run) -> Optional[Dict[str, Any]]:
+        """Utility to process a run for wandb model_dict serialization.
+        :param run: The run to process.
+        :return: The convert model_dict to pass to WBTraceTree.
+        """
+        try:
+            data = json.loads(run.json())
+            processed = self.flatten_run(data)
+            keep_keys = (
+                "id",
+                "name",
+                "serialized",
+                "inputs",
+                "outputs",
+                "parent_run_id",
+                "execution_order",
+            )
+            processed = self.truncate_run_iterative(processed, keep_keys=keep_keys)
+            exact_keys, partial_keys = ("lc", "type"), ("api_key",)
+            processed = self.modify_serialized_iterative(
+                processed, exact_keys=exact_keys, partial_keys=partial_keys
+            )
+            output = self.build_tree(processed)
+            return output
+        except Exception as e:
+            if PRINT_WARNINGS:
+                self.wandb.termwarn(f"WARNING: Failed to serialize model: {e}")
+            return None
+
+    def flatten_run(self, run: Dict[str, Any]) -> List[Dict[str, Any]]:
+        """Utility to flatten a nest run object into a list of runs.
+        :param run: The base run to flatten.
+        :return: The flattened list of runs.
+        """
+
+        def flatten(child_runs: List[Dict[str, Any]]) -> List[Dict[str, Any]]:
+            """Utility to recursively flatten a list of child runs in a run.
+            :param child_runs: The list of child runs to flatten.
+            :return: The flattened list of runs.
+            """
+            if child_runs is None:
+                return []
+
+            result = []
+            for item in child_runs:
+                child_runs = item.pop("child_runs", [])
+                result.append(item)
+                result.extend(flatten(child_runs))
+
+            return result
+
+        return flatten([run])
+
+    def truncate_run_iterative(
+        self, runs: List[Dict[str, Any]], keep_keys: Tuple[str, ...] = ()
+    ) -> List[Dict[str, Any]]:
+        """Utility to truncate a list of runs dictionaries to only keep the specified
+            keys in each run.
+        :param runs: The list of runs to truncate.
+        :param keep_keys: The keys to keep in each run.
+        :return: The truncated list of runs.
+        """
+
+        def truncate_single(run: Dict[str, Any]) -> Dict[str, Any]:
+            """Utility to truncate a single run dictionary to only keep the specified
+                keys.
+            :param run: The run dictionary to truncate.
+            :return: The truncated run dictionary
+            """
+            new_dict = {}
+            for key in run:
+                if key in keep_keys:
+                    new_dict[key] = run.get(key)
+            return new_dict
+
+        return list(map(truncate_single, runs))
+
+    def modify_serialized_iterative(
+        self,
+        runs: List[Dict[str, Any]],
+        exact_keys: Tuple[str, ...] = (),
+        partial_keys: Tuple[str, ...] = (),
+    ) -> List[Dict[str, Any]]:
+        """Utility to modify the serialized field of a list of runs dictionaries.
+        removes any keys that match the exact_keys and any keys that contain any of the
+        partial_keys.
+        recursively moves the dictionaries under the kwargs key to the top level.
+        changes the "id" field to a string "_kind" field that tells WBTraceTree how to
+        visualize the run. promotes the "serialized" field to the top level.
+
+        :param runs: The list of runs to modify.
+        :param exact_keys: A tuple of keys to remove from the serialized field.
+        :param partial_keys: A tuple of partial keys to remove from the serialized
+            field.
+        :return: The modified list of runs.
+        """
+
+        def remove_exact_and_partial_keys(obj: Dict[str, Any]) -> Dict[str, Any]:
+            """Recursively removes exact and partial keys from a dictionary.
+            :param obj: The dictionary to remove keys from.
+            :return: The modified dictionary.
+            """
+            if isinstance(obj, dict):
+                obj = {
+                    k: v
+                    for k, v in obj.items()
+                    if k not in exact_keys
+                    and not any(partial in k for partial in partial_keys)
+                }
+                for k, v in obj.items():
+                    obj[k] = remove_exact_and_partial_keys(v)
+            elif isinstance(obj, list):
+                obj = [remove_exact_and_partial_keys(x) for x in obj]
+            return obj
+
+        def handle_id_and_kwargs(
+            obj: Dict[str, Any], root: bool = False
+        ) -> Dict[str, Any]:
+            """Recursively handles the id and kwargs fields of a dictionary.
+            changes the id field to a string "_kind" field that tells WBTraceTree how
+            to visualize the run. recursively moves the dictionaries under the kwargs
+            key to the top level.
+            :param obj: a run dictionary with id and kwargs fields.
+            :param root: whether this is the root dictionary or the serialized
+                dictionary.
+            :return: The modified dictionary.
+            """
+            if isinstance(obj, dict):
+                if ("id" in obj or "name" in obj) and not root:
+                    _kind = obj.get("id")
+                    if not _kind:
+                        _kind = [obj.get("name")]
+                    obj["_kind"] = _kind[-1]
+                    obj.pop("id", None)
+                    obj.pop("name", None)
+                    if "kwargs" in obj:
+                        kwargs = obj.pop("kwargs")
+                        for k, v in kwargs.items():
+                            obj[k] = v
+                for k, v in obj.items():
+                    obj[k] = handle_id_and_kwargs(v)
+            elif isinstance(obj, list):
+                obj = [handle_id_and_kwargs(x) for x in obj]
+            return obj
+
+        def transform_serialized(serialized: Dict[str, Any]) -> Dict[str, Any]:
+            """Transforms the serialized field of a run dictionary to be compatible
+                with WBTraceTree.
+            :param serialized: The serialized field of a run dictionary.
+            :return: The transformed serialized field.
+            """
+            serialized = handle_id_and_kwargs(serialized, root=True)
+            serialized = remove_exact_and_partial_keys(serialized)
+            return serialized
+
+        def transform_run(run: Dict[str, Any]) -> Dict[str, Any]:
+            """Transforms a run dictionary to be compatible with WBTraceTree.
+            :param run: The run dictionary to transform.
+            :return: The transformed run dictionary.
+            """
+            transformed_dict = transform_serialized(run)
+
+            serialized = transformed_dict.pop("serialized")
+            for k, v in serialized.items():
+                transformed_dict[k] = v
+
+            _kind = transformed_dict.get("_kind", None)
+            name = transformed_dict.pop("name", None)
+            exec_ord = transformed_dict.pop("execution_order", None)
+
+            if not name:
+                name = _kind
+
+            output_dict = {
+                f"{exec_ord}_{name}": transformed_dict,
+            }
+            return output_dict
+
+        return list(map(transform_run, runs))
+
+    def build_tree(self, runs: List[Dict[str, Any]]) -> Dict[str, Any]:
+        """Builds a nested dictionary from a list of runs.
+        :param runs: The list of runs to build the tree from.
+        :return: The nested dictionary representing the langchain Run in a tree
+            structure compatible with WBTraceTree.
+        """
+        id_to_data = {}
+        child_to_parent = {}
+
+        for entity in runs:
+            for key, data in entity.items():
+                id_val = data.pop("id", None)
+                parent_run_id = data.pop("parent_run_id", None)
+                id_to_data[id_val] = {key: data}
+                if parent_run_id:
+                    child_to_parent[id_val] = parent_run_id
+
+        for child_id, parent_id in child_to_parent.items():
+            parent_dict = id_to_data[parent_id]
+            parent_dict[next(iter(parent_dict))][
+                next(iter(id_to_data[child_id]))
+            ] = id_to_data[child_id][next(iter(id_to_data[child_id]))]
+
+        root_dict = next(
+            data for id_val, data in id_to_data.items() if id_val not in child_to_parent
+        )
+
+        return root_dict
+
+
+class WandbRunArgs(TypedDict):
+    """Arguments for the WandbTracer."""
+
+    job_type: Optional[str]
+    dir: Optional[StrPath]
+    config: Union[Dict, str, None]
+    project: Optional[str]
+    entity: Optional[str]
+    reinit: Optional[bool]
+    tags: Optional[Sequence]
+    group: Optional[str]
+    name: Optional[str]
+    notes: Optional[str]
+    magic: Optional[Union[dict, str, bool]]
+    config_exclude_keys: Optional[List[str]]
+    config_include_keys: Optional[List[str]]
+    anonymous: Optional[str]
+    mode: Optional[str]
+    allow_val_change: Optional[bool]
+    resume: Optional[Union[bool, str]]
+    force: Optional[bool]
+    tensorboard: Optional[bool]
+    sync_tensorboard: Optional[bool]
+    monitor_gym: Optional[bool]
+    save_code: Optional[bool]
+    id: Optional[str]
+    settings: Union[WBSettings, Dict[str, Any], None]
+
+
+class WandbTracer(BaseTracer):
+    """Callback Handler that logs to Weights and Biases.
+
+    This handler will log the model architecture and run traces to Weights and Biases.
+    This will ensure that all LangChain activity is logged to W&B.
+    """
+
+    _run: Optional[WBRun] = None
+    _run_args: Optional[WandbRunArgs] = None
+
+    def __init__(self, run_args: Optional[WandbRunArgs] = None, **kwargs: Any) -> None:
+        """Initializes the WandbTracer.
+
+        Parameters:
+            run_args: (dict, optional) Arguments to pass to `wandb.init()`. If not
+                provided, `wandb.init()` will be called with no arguments. Please
+                refer to the `wandb.init` for more details.
+
+        To use W&B to monitor all LangChain activity, add this tracer like any other
+        LangChain callback:
+        ```
+        from wandb.integration.langchain import WandbTracer
+
+        tracer = WandbTracer()
+        chain = LLMChain(llm, callbacks=[tracer])
+        # ...end of notebook / script:
+        tracer.finish()
+        ```
+        """
+        super().__init__(**kwargs)
+        try:
+            import wandb
+            from wandb.sdk.data_types import trace_tree
+        except ImportError as e:
+            raise ImportError(
+                "Could not import wandb python package."
+                "Please install it with `pip install -U wandb`."
+            ) from e
+        self._wandb = wandb
+        self._trace_tree = trace_tree
+        self._run_args = run_args
+        self._ensure_run(should_print_url=(wandb.run is None))
+        self.run_processor = RunProcessor(self._wandb, self._trace_tree)
+
+    def finish(self) -> None:
+        """Waits for all asynchronous processes to finish and data to upload.
+
+        Proxy for `wandb.finish()`.
+        """
+        self._wandb.finish()
+
+    def _log_trace_from_run(self, run: Run) -> None:
+        """Logs a LangChain Run to W*B as a W&B Trace."""
+        self._ensure_run()
+
+        root_span = self.run_processor.process_span(run)
+        model_dict = self.run_processor.process_model(run)
+
+        if root_span is None:
+            return
+
+        model_trace = self._trace_tree.WBTraceTree(
+            root_span=root_span,
+            model_dict=model_dict,
+        )
+        if self._wandb.run is not None:
+            self._wandb.run.log({"langchain_trace": model_trace})
+
+    def _ensure_run(self, should_print_url: bool = False) -> None:
+        """Ensures an active W&B run exists.
+
+        If not, will start a new run with the provided run_args.
+        """
+        if self._wandb.run is None:
+            run_args: Dict = {**(self._run_args or {})}
+
+            if "settings" not in run_args:
+                run_args["settings"] = {"silent": True}
+
+            self._wandb.init(**run_args)
+        if self._wandb.run is not None:
+            if should_print_url:
+                run_url = self._wandb.run.settings.run_url
+                self._wandb.termlog(
+                    f"Streaming LangChain activity to W&B at {run_url}\n"
+                    "`WandbTracer` is currently in beta.\n"
+                    "Please report any issues to "
+                    "https://github.com/wandb/wandb/issues with the tag "
+                    "`langchain`."
+                )
+
+            self._wandb.run._label(repo="langchain")
+
+    def _persist_run(self, run: "Run") -> None:
+        """Persist a run."""
+        self._log_trace_from_run(run)
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/trubrics_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/trubrics_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..fa697a756ed1b542b82a8122b7ad8017c88dd79e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/trubrics_callback.py
@@ -0,0 +1,125 @@
+import os
+from typing import Any, Dict, List, Optional
+from uuid import UUID
+
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    ChatMessage,
+    FunctionMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import LLMResult
+
+
+def _convert_message_to_dict(message: BaseMessage) -> dict:
+    message_dict: Dict[str, Any]
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": message.role, "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+        if "function_call" in message.additional_kwargs:
+            message_dict["function_call"] = message.additional_kwargs["function_call"]
+            # If function call only, content is None not empty string
+            if message_dict["content"] == "":
+                message_dict["content"] = None
+    elif isinstance(message, SystemMessage):
+        message_dict = {"role": "system", "content": message.content}
+    elif isinstance(message, FunctionMessage):
+        message_dict = {
+            "role": "function",
+            "content": message.content,
+            "name": message.name,
+        }
+    else:
+        raise TypeError(f"Got unknown type {message}")
+    if "name" in message.additional_kwargs:
+        message_dict["name"] = message.additional_kwargs["name"]
+    return message_dict
+
+
+class TrubricsCallbackHandler(BaseCallbackHandler):
+    """
+    Callback handler for Trubrics.
+
+    Args:
+        project: a trubrics project, default project is "default"
+        email: a trubrics account email, can equally be set in env variables
+        password: a trubrics account password, can equally be set in env variables
+        **kwargs: all other kwargs are parsed and set to trubrics prompt variables,
+            or added to the `metadata` dict
+    """
+
+    def __init__(
+        self,
+        project: str = "default",
+        email: Optional[str] = None,
+        password: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__()
+        try:
+            from trubrics import Trubrics
+        except ImportError:
+            raise ImportError(
+                "The TrubricsCallbackHandler requires installation of "
+                "the trubrics package. "
+                "Please install it with `pip install trubrics`."
+            )
+
+        self.trubrics = Trubrics(
+            project=project,
+            email=email or os.environ["TRUBRICS_EMAIL"],
+            password=password or os.environ["TRUBRICS_PASSWORD"],
+        )
+        self.config_model: dict = {}
+        self.prompt: Optional[str] = None
+        self.messages: Optional[list] = None
+        self.trubrics_kwargs: Optional[dict] = kwargs if kwargs else None
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        self.prompt = prompts[0]
+
+    def on_chat_model_start(
+        self,
+        serialized: Dict[str, Any],
+        messages: List[List[BaseMessage]],
+        **kwargs: Any,
+    ) -> None:
+        self.messages = [_convert_message_to_dict(message) for message in messages[0]]
+        self.prompt = self.messages[-1]["content"]
+
+    def on_llm_end(self, response: LLMResult, run_id: UUID, **kwargs: Any) -> None:
+        tags = ["langchain"]
+        user_id = None
+        session_id = None
+        metadata: dict = {"langchain_run_id": run_id}
+        if self.messages:
+            metadata["messages"] = self.messages
+        if self.trubrics_kwargs:
+            if self.trubrics_kwargs.get("tags"):
+                tags.append(*self.trubrics_kwargs.pop("tags"))
+            user_id = self.trubrics_kwargs.pop("user_id", None)
+            session_id = self.trubrics_kwargs.pop("session_id", None)
+            metadata.update(self.trubrics_kwargs)
+
+        for generation in response.generations:
+            self.trubrics.log_prompt(
+                config_model={
+                    "model": response.llm_output.get("model_name")
+                    if response.llm_output
+                    else "NA"
+                },
+                prompt=self.prompt,
+                generation=generation[0].text,
+                user_id=user_id,
+                session_id=session_id,
+                tags=tags,
+                metadata=metadata,
+            )
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/uptrain_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/uptrain_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd08fd02c5804e6f989aa5e8e225ac2e4ee88ab7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/uptrain_callback.py
@@ -0,0 +1,389 @@
+"""
+UpTrain Callback Handler
+
+UpTrain is an open-source platform to evaluate and improve LLM applications. It provides
+grades for 20+ preconfigured checks (covering language, code, embedding use cases), 
+performs root cause analyses on instances of failure cases and provides guidance for 
+resolving them.
+
+This module contains a callback handler for integrating UpTrain seamlessly into your 
+pipeline and facilitating diverse evaluations. The callback handler automates various 
+evaluations to assess the performance and effectiveness of the components within the
+pipeline.
+
+The evaluations conducted include:
+
+1. RAG:
+   - Context Relevance: Determines the relevance of the context extracted from the query
+   to the response.
+   - Factual Accuracy: Assesses if the Language Model (LLM) is providing accurate
+   information or hallucinating.
+   - Response Completeness: Checks if the response contains all the information
+   requested by the query.
+
+2. Multi Query Generation:
+   MultiQueryRetriever generates multiple variants of a question with similar meanings
+   to the original question. This evaluation includes previous assessments and adds:
+   - Multi Query Accuracy: Ensures that the multi-queries generated convey the same
+   meaning as the original query.
+
+3. Context Compression and Reranking:
+   Re-ranking involves reordering nodes based on relevance to the query and selecting
+   top n nodes. 
+   Due to the potential reduction in the number of nodes after re-ranking, the following
+   evaluations
+   are performed in addition to the RAG evaluations:
+   - Context Reranking: Determines if the order of re-ranked nodes is more relevant to
+   the query than the original order.
+   - Context Conciseness: Examines whether the reduced number of nodes still provides
+   all the required information.
+
+These evaluations collectively ensure the robustness and effectiveness of the RAG query
+engine, MultiQueryRetriever, and the re-ranking process within the pipeline.
+
+Useful links:
+Github: https://github.com/uptrain-ai/uptrain
+Website: https://uptrain.ai/
+Docs: https://docs.uptrain.ai/getting-started/introduction
+
+"""
+
+import logging
+import sys
+from collections import defaultdict
+from typing import (
+    Any,
+    DefaultDict,
+    Dict,
+    List,
+    Optional,
+    Sequence,
+    Set,
+)
+from uuid import UUID
+
+from langchain_core.callbacks.base import BaseCallbackHandler
+from langchain_core.documents import Document
+from langchain_core.outputs import LLMResult
+
+logger = logging.getLogger(__name__)
+handler = logging.StreamHandler(sys.stdout)
+formatter = logging.Formatter("%(message)s")
+handler.setFormatter(formatter)
+logger.addHandler(handler)
+
+
+def import_uptrain() -> Any:
+    try:
+        import uptrain
+    except ImportError as e:
+        raise ImportError(
+            "To use the UpTrainCallbackHandler, you need the"
+            "`uptrain` package. Please install it with"
+            "`pip install uptrain`.",
+            e,
+        )
+
+    return uptrain
+
+
+class UpTrainDataSchema:
+    """The UpTrain data schema for tracking evaluation results.
+
+    Args:
+        project_name_prefix (str): Prefix for the project name.
+
+    Attributes:
+        project_name_prefix (str): Prefix for the project name.
+        uptrain_results (DefaultDict[str, Any]): Dictionary to store evaluation results.
+        eval_types (Set[str]): Set to store the types of evaluations.
+        query (str): Query for the RAG evaluation.
+        context (str): Context for the RAG evaluation.
+        response (str): Response for the RAG evaluation.
+        old_context (List[str]): Old context nodes for Context Conciseness evaluation.
+        new_context (List[str]): New context nodes for Context Conciseness evaluation.
+        context_conciseness_run_id (str): Run ID for Context Conciseness evaluation.
+        multi_queries (List[str]): List of multi queries for Multi Query evaluation.
+        multi_query_run_id (str): Run ID for Multi Query evaluation.
+        multi_query_daugher_run_id (str): Run ID for Multi Query daughter evaluation.
+
+    """
+
+    def __init__(self, project_name_prefix: str) -> None:
+        """Initialize the UpTrain data schema."""
+        # For tracking project name and results
+        self.project_name_prefix: str = project_name_prefix
+        self.uptrain_results: DefaultDict[str, Any] = defaultdict(list)
+
+        # For tracking event types
+        self.eval_types: Set[str] = set()
+
+        ## RAG
+        self.query: str = ""
+        self.context: str = ""
+        self.response: str = ""
+
+        ## CONTEXT CONCISENESS
+        self.old_context: List[str] = []
+        self.new_context: List[str] = []
+        self.context_conciseness_run_id: UUID = UUID(int=0)
+
+        # MULTI QUERY
+        self.multi_queries: List[str] = []
+        self.multi_query_run_id: UUID = UUID(int=0)
+        self.multi_query_daugher_run_id: UUID = UUID(int=0)
+
+
+class UpTrainCallbackHandler(BaseCallbackHandler):
+    """Callback Handler that logs evaluation results to uptrain and the console.
+
+    Args:
+        project_name_prefix (str): Prefix for the project name.
+        key_type (str): Type of key to use. Must be 'uptrain' or 'openai'.
+        api_key (str): API key for the UpTrain or OpenAI API.
+        (This key is required to perform evaluations using GPT.)
+
+    Raises:
+        ValueError: If the key type is invalid.
+        ImportError: If the `uptrain` package is not installed.
+
+    """
+
+    def __init__(
+        self,
+        *,
+        project_name_prefix: str = "langchain",
+        key_type: str = "openai",
+        api_key: str = "sk-****************",  # The API key to use for evaluation
+        model: str = "gpt-3.5-turbo",  # The model to use for evaluation
+        log_results: bool = True,
+    ) -> None:
+        """Initializes the `UpTrainCallbackHandler`."""
+        super().__init__()
+
+        uptrain = import_uptrain()
+
+        self.log_results = log_results
+
+        # Set uptrain variables
+        self.schema = UpTrainDataSchema(project_name_prefix=project_name_prefix)
+        self.first_score_printed_flag = False
+
+        if key_type == "uptrain":
+            settings = uptrain.Settings(uptrain_access_token=api_key, model=model)
+            self.uptrain_client = uptrain.APIClient(settings=settings)
+        elif key_type == "openai":
+            settings = uptrain.Settings(
+                openai_api_key=api_key, evaluate_locally=False, model=model
+            )
+            self.uptrain_client = uptrain.EvalLLM(settings=settings)
+        else:
+            raise ValueError("Invalid key type: Must be 'uptrain' or 'openai'")
+
+    def uptrain_evaluate(
+        self,
+        project_name: str,
+        data: List[Dict[str, Any]],
+        checks: List[str],
+    ) -> None:
+        """Run an evaluation on the UpTrain server using UpTrain client."""
+        if self.uptrain_client.__class__.__name__ == "APIClient":
+            uptrain_result = self.uptrain_client.log_and_evaluate(
+                project_name=project_name,
+                data=data,
+                checks=checks,
+            )
+        else:
+            uptrain_result = self.uptrain_client.evaluate(
+                data=data,
+                checks=checks,
+            )
+        self.schema.uptrain_results[project_name].append(uptrain_result)
+
+        score_name_map = {
+            "score_context_relevance": "Context Relevance Score",
+            "score_factual_accuracy": "Factual Accuracy Score",
+            "score_response_completeness": "Response Completeness Score",
+            "score_sub_query_completeness": "Sub Query Completeness Score",
+            "score_context_reranking": "Context Reranking Score",
+            "score_context_conciseness": "Context Conciseness Score",
+            "score_multi_query_accuracy": "Multi Query Accuracy Score",
+        }
+
+        if self.log_results:
+            # Set logger level to INFO to print the evaluation results
+            logger.setLevel(logging.INFO)
+
+        for row in uptrain_result:
+            columns = list(row.keys())
+            for column in columns:
+                if column == "question":
+                    logger.info(f"\nQuestion: {row[column]}")
+                    self.first_score_printed_flag = False
+                elif column == "response":
+                    logger.info(f"Response: {row[column]}")
+                    self.first_score_printed_flag = False
+                elif column == "variants":
+                    logger.info("Multi Queries:")
+                    for variant in row[column]:
+                        logger.info(f"  - {variant}")
+                    self.first_score_printed_flag = False
+                elif column.startswith("score"):
+                    if not self.first_score_printed_flag:
+                        logger.info("")
+                        self.first_score_printed_flag = True
+                    if column in score_name_map:
+                        logger.info(f"{score_name_map[column]}: {row[column]}")
+                    else:
+                        logger.info(f"{column}: {row[column]}")
+
+        if self.log_results:
+            # Set logger level back to WARNING
+            # (We are doing this to avoid printing the logs from HTTP requests)
+            logger.setLevel(logging.WARNING)
+
+    def on_llm_end(
+        self,
+        response: LLMResult,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Log records to uptrain when an LLM ends."""
+        uptrain = import_uptrain()
+        self.schema.response = response.generations[0][0].text
+        if (
+            "qa_rag" in self.schema.eval_types
+            and parent_run_id != self.schema.multi_query_daugher_run_id
+        ):
+            data = [
+                {
+                    "question": self.schema.query,
+                    "context": self.schema.context,
+                    "response": self.schema.response,
+                }
+            ]
+
+            self.uptrain_evaluate(
+                project_name=f"{self.schema.project_name_prefix}_rag",
+                data=data,
+                checks=[
+                    uptrain.Evals.CONTEXT_RELEVANCE,
+                    uptrain.Evals.FACTUAL_ACCURACY,
+                    uptrain.Evals.RESPONSE_COMPLETENESS,
+                ],
+            )
+
+    def on_chain_start(
+        self,
+        serialized: Dict[str, Any],
+        inputs: Dict[str, Any],
+        *,
+        run_id: UUID,
+        tags: Optional[List[str]] = None,
+        parent_run_id: Optional[UUID] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        run_type: Optional[str] = None,
+        name: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Do nothing when chain starts"""
+        if parent_run_id == self.schema.multi_query_run_id:
+            self.schema.multi_query_daugher_run_id = run_id
+        if isinstance(inputs, dict) and set(inputs.keys()) == {"context", "question"}:
+            self.schema.eval_types.add("qa_rag")
+
+            context = ""
+            if isinstance(inputs["context"], Document):
+                context = inputs["context"].page_content
+            elif isinstance(inputs["context"], list):
+                for doc in inputs["context"]:
+                    context += doc.page_content + "\n"
+            elif isinstance(inputs["context"], str):
+                context = inputs["context"]
+            self.schema.context = context
+            self.schema.query = inputs["question"]
+        pass
+
+    def on_retriever_start(
+        self,
+        serialized: Dict[str, Any],
+        query: str,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> None:
+        if "contextual_compression" in serialized["id"]:
+            self.schema.eval_types.add("contextual_compression")
+            self.schema.query = query
+            self.schema.context_conciseness_run_id = run_id
+
+        if "multi_query" in serialized["id"]:
+            self.schema.eval_types.add("multi_query")
+            self.schema.multi_query_run_id = run_id
+            self.schema.query = query
+        elif "multi_query" in self.schema.eval_types:
+            self.schema.multi_queries.append(query)
+
+    def on_retriever_end(
+        self,
+        documents: Sequence[Document],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when Retriever ends running."""
+        uptrain = import_uptrain()
+        if run_id == self.schema.multi_query_run_id:
+            data = [
+                {
+                    "question": self.schema.query,
+                    "variants": self.schema.multi_queries,
+                }
+            ]
+
+            self.uptrain_evaluate(
+                project_name=f"{self.schema.project_name_prefix}_multi_query",
+                data=data,
+                checks=[uptrain.Evals.MULTI_QUERY_ACCURACY],
+            )
+        if "contextual_compression" in self.schema.eval_types:
+            if parent_run_id == self.schema.context_conciseness_run_id:
+                for doc in documents:
+                    self.schema.old_context.append(doc.page_content)
+            elif run_id == self.schema.context_conciseness_run_id:
+                for doc in documents:
+                    self.schema.new_context.append(doc.page_content)
+                context = "\n".join(
+                    [
+                        f"{index}. {string}"
+                        for index, string in enumerate(self.schema.old_context, start=1)
+                    ]
+                )
+                reranked_context = "\n".join(
+                    [
+                        f"{index}. {string}"
+                        for index, string in enumerate(self.schema.new_context, start=1)
+                    ]
+                )
+                data = [
+                    {
+                        "question": self.schema.query,
+                        "context": context,
+                        "concise_context": reranked_context,
+                        "reranked_context": reranked_context,
+                    }
+                ]
+                self.uptrain_evaluate(
+                    project_name=f"{self.schema.project_name_prefix}_context_reranking",
+                    data=data,
+                    checks=[
+                        uptrain.Evals.CONTEXT_CONCISENESS,
+                        uptrain.Evals.CONTEXT_RERANKING,
+                    ],
+                )
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/utils.py b/llm/Lib/site-packages/langchain_community/callbacks/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..b83bace6016da8287f5eca17aee554251a853b0d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/utils.py
@@ -0,0 +1,258 @@
+import hashlib
+from pathlib import Path
+from typing import Any, Dict, Iterable, Tuple, Union
+
+
+def import_spacy() -> Any:
+    """Import the spacy python package and raise an error if it is not installed."""
+    try:
+        import spacy
+    except ImportError:
+        raise ImportError(
+            "This callback manager requires the `spacy` python "
+            "package installed. Please install it with `pip install spacy`"
+        )
+    return spacy
+
+
+def import_pandas() -> Any:
+    """Import the pandas python package and raise an error if it is not installed."""
+    try:
+        import pandas
+    except ImportError:
+        raise ImportError(
+            "This callback manager requires the `pandas` python "
+            "package installed. Please install it with `pip install pandas`"
+        )
+    return pandas
+
+
+def import_textstat() -> Any:
+    """Import the textstat python package and raise an error if it is not installed."""
+    try:
+        import textstat
+    except ImportError:
+        raise ImportError(
+            "This callback manager requires the `textstat` python "
+            "package installed. Please install it with `pip install textstat`"
+        )
+    return textstat
+
+
+def _flatten_dict(
+    nested_dict: Dict[str, Any], parent_key: str = "", sep: str = "_"
+) -> Iterable[Tuple[str, Any]]:
+    """
+    Generator that yields flattened items from a nested dictionary for a flat dict.
+
+    Parameters:
+        nested_dict (dict): The nested dictionary to flatten.
+        parent_key (str): The prefix to prepend to the keys of the flattened dict.
+        sep (str): The separator to use between the parent key and the key of the
+            flattened dictionary.
+
+    Yields:
+        (str, any): A key-value pair from the flattened dictionary.
+    """
+    for key, value in nested_dict.items():
+        new_key = parent_key + sep + key if parent_key else key
+        if isinstance(value, dict):
+            yield from _flatten_dict(value, new_key, sep)
+        else:
+            yield new_key, value
+
+
+def flatten_dict(
+    nested_dict: Dict[str, Any], parent_key: str = "", sep: str = "_"
+) -> Dict[str, Any]:
+    """Flattens a nested dictionary into a flat dictionary.
+
+    Parameters:
+        nested_dict (dict): The nested dictionary to flatten.
+        parent_key (str): The prefix to prepend to the keys of the flattened dict.
+        sep (str): The separator to use between the parent key and the key of the
+            flattened dictionary.
+
+    Returns:
+        (dict): A flat dictionary.
+
+    """
+    flat_dict = {k: v for k, v in _flatten_dict(nested_dict, parent_key, sep)}
+    return flat_dict
+
+
+def hash_string(s: str) -> str:
+    """Hash a string using sha1.
+
+    Parameters:
+        s (str): The string to hash.
+
+    Returns:
+        (str): The hashed string.
+    """
+    return hashlib.sha1(s.encode("utf-8")).hexdigest()
+
+
+def load_json(json_path: Union[str, Path]) -> str:
+    """Load json file to a string.
+
+    Parameters:
+        json_path (str): The path to the json file.
+
+    Returns:
+        (str): The string representation of the json file.
+    """
+    with open(json_path, "r") as f:
+        data = f.read()
+    return data
+
+
+class BaseMetadataCallbackHandler:
+    """This class handles the metadata and associated function states for callbacks.
+
+    Attributes:
+        step (int): The current step.
+        starts (int): The number of times the start method has been called.
+        ends (int): The number of times the end method has been called.
+        errors (int): The number of times the error method has been called.
+        text_ctr (int): The number of times the text method has been called.
+        ignore_llm_ (bool): Whether to ignore llm callbacks.
+        ignore_chain_ (bool): Whether to ignore chain callbacks.
+        ignore_agent_ (bool): Whether to ignore agent callbacks.
+        ignore_retriever_ (bool): Whether to ignore retriever callbacks.
+        always_verbose_ (bool): Whether to always be verbose.
+        chain_starts (int): The number of times the chain start method has been called.
+        chain_ends (int): The number of times the chain end method has been called.
+        llm_starts (int): The number of times the llm start method has been called.
+        llm_ends (int): The number of times the llm end method has been called.
+        llm_streams (int): The number of times the text method has been called.
+        tool_starts (int): The number of times the tool start method has been called.
+        tool_ends (int): The number of times the tool end method has been called.
+        agent_ends (int): The number of times the agent end method has been called.
+        on_llm_start_records (list): A list of records of the on_llm_start method.
+        on_llm_token_records (list): A list of records of the on_llm_token method.
+        on_llm_end_records (list): A list of records of the on_llm_end method.
+        on_chain_start_records (list): A list of records of the on_chain_start method.
+        on_chain_end_records (list): A list of records of the on_chain_end method.
+        on_tool_start_records (list): A list of records of the on_tool_start method.
+        on_tool_end_records (list): A list of records of the on_tool_end method.
+        on_agent_finish_records (list): A list of records of the on_agent_end method.
+    """
+
+    def __init__(self) -> None:
+        self.step = 0
+
+        self.starts = 0
+        self.ends = 0
+        self.errors = 0
+        self.text_ctr = 0
+
+        self.ignore_llm_ = False
+        self.ignore_chain_ = False
+        self.ignore_agent_ = False
+        self.ignore_retriever_ = False
+        self.always_verbose_ = False
+
+        self.chain_starts = 0
+        self.chain_ends = 0
+
+        self.llm_starts = 0
+        self.llm_ends = 0
+        self.llm_streams = 0
+
+        self.tool_starts = 0
+        self.tool_ends = 0
+
+        self.agent_ends = 0
+
+        self.on_llm_start_records: list = []
+        self.on_llm_token_records: list = []
+        self.on_llm_end_records: list = []
+
+        self.on_chain_start_records: list = []
+        self.on_chain_end_records: list = []
+
+        self.on_tool_start_records: list = []
+        self.on_tool_end_records: list = []
+
+        self.on_text_records: list = []
+        self.on_agent_finish_records: list = []
+        self.on_agent_action_records: list = []
+
+    @property
+    def always_verbose(self) -> bool:
+        """Whether to call verbose callbacks even if verbose is False."""
+        return self.always_verbose_
+
+    @property
+    def ignore_llm(self) -> bool:
+        """Whether to ignore LLM callbacks."""
+        return self.ignore_llm_
+
+    @property
+    def ignore_chain(self) -> bool:
+        """Whether to ignore chain callbacks."""
+        return self.ignore_chain_
+
+    @property
+    def ignore_agent(self) -> bool:
+        """Whether to ignore agent callbacks."""
+        return self.ignore_agent_
+
+    def get_custom_callback_meta(self) -> Dict[str, Any]:
+        return {
+            "step": self.step,
+            "starts": self.starts,
+            "ends": self.ends,
+            "errors": self.errors,
+            "text_ctr": self.text_ctr,
+            "chain_starts": self.chain_starts,
+            "chain_ends": self.chain_ends,
+            "llm_starts": self.llm_starts,
+            "llm_ends": self.llm_ends,
+            "llm_streams": self.llm_streams,
+            "tool_starts": self.tool_starts,
+            "tool_ends": self.tool_ends,
+            "agent_ends": self.agent_ends,
+        }
+
+    def reset_callback_meta(self) -> None:
+        """Reset the callback metadata."""
+        self.step = 0
+
+        self.starts = 0
+        self.ends = 0
+        self.errors = 0
+        self.text_ctr = 0
+
+        self.ignore_llm_ = False
+        self.ignore_chain_ = False
+        self.ignore_agent_ = False
+        self.always_verbose_ = False
+
+        self.chain_starts = 0
+        self.chain_ends = 0
+
+        self.llm_starts = 0
+        self.llm_ends = 0
+        self.llm_streams = 0
+
+        self.tool_starts = 0
+        self.tool_ends = 0
+
+        self.agent_ends = 0
+
+        self.on_llm_start_records = []
+        self.on_llm_token_records = []
+        self.on_llm_end_records = []
+
+        self.on_chain_start_records = []
+        self.on_chain_end_records = []
+
+        self.on_tool_start_records = []
+        self.on_tool_end_records = []
+
+        self.on_text_records = []
+        self.on_agent_finish_records = []
+        self.on_agent_action_records = []
+        return None
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/wandb_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/wandb_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ce3cf527ff1390e4bb675efc0534c0e9eaf519f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/wandb_callback.py
@@ -0,0 +1,586 @@
+import json
+import tempfile
+from copy import deepcopy
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Sequence, Union
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.outputs import LLMResult
+
+from langchain_community.callbacks.utils import (
+    BaseMetadataCallbackHandler,
+    flatten_dict,
+    hash_string,
+    import_pandas,
+    import_spacy,
+    import_textstat,
+)
+
+
+def import_wandb() -> Any:
+    """Import the wandb python package and raise an error if it is not installed."""
+    try:
+        import wandb  # noqa: F401
+    except ImportError:
+        raise ImportError(
+            "To use the wandb callback manager you need to have the `wandb` python "
+            "package installed. Please install it with `pip install wandb`"
+        )
+    return wandb
+
+
+def load_json_to_dict(json_path: Union[str, Path]) -> dict:
+    """Load json file to a dictionary.
+
+    Parameters:
+        json_path (str): The path to the json file.
+
+    Returns:
+        (dict): The dictionary representation of the json file.
+    """
+    with open(json_path, "r") as f:
+        data = json.load(f)
+    return data
+
+
+def analyze_text(
+    text: str,
+    complexity_metrics: bool = True,
+    visualize: bool = True,
+    nlp: Any = None,
+    output_dir: Optional[Union[str, Path]] = None,
+) -> dict:
+    """Analyze text using textstat and spacy.
+
+    Parameters:
+        text (str): The text to analyze.
+        complexity_metrics (bool): Whether to compute complexity metrics.
+        visualize (bool): Whether to visualize the text.
+        nlp (spacy.lang): The spacy language model to use for visualization.
+        output_dir (str): The directory to save the visualization files to.
+
+    Returns:
+        (dict): A dictionary containing the complexity metrics and visualization
+            files serialized in a wandb.Html element.
+    """
+    resp = {}
+    textstat = import_textstat()
+    wandb = import_wandb()
+    spacy = import_spacy()
+    if complexity_metrics:
+        text_complexity_metrics = {
+            "flesch_reading_ease": textstat.flesch_reading_ease(text),
+            "flesch_kincaid_grade": textstat.flesch_kincaid_grade(text),
+            "smog_index": textstat.smog_index(text),
+            "coleman_liau_index": textstat.coleman_liau_index(text),
+            "automated_readability_index": textstat.automated_readability_index(text),
+            "dale_chall_readability_score": textstat.dale_chall_readability_score(text),
+            "difficult_words": textstat.difficult_words(text),
+            "linsear_write_formula": textstat.linsear_write_formula(text),
+            "gunning_fog": textstat.gunning_fog(text),
+            "text_standard": textstat.text_standard(text),
+            "fernandez_huerta": textstat.fernandez_huerta(text),
+            "szigriszt_pazos": textstat.szigriszt_pazos(text),
+            "gutierrez_polini": textstat.gutierrez_polini(text),
+            "crawford": textstat.crawford(text),
+            "gulpease_index": textstat.gulpease_index(text),
+            "osman": textstat.osman(text),
+        }
+        resp.update(text_complexity_metrics)
+
+    if visualize and nlp and output_dir is not None:
+        doc = nlp(text)
+
+        dep_out = spacy.displacy.render(doc, style="dep", jupyter=False, page=True)
+        dep_output_path = Path(output_dir, hash_string(f"dep-{text}") + ".html")
+        dep_output_path.open("w", encoding="utf-8").write(dep_out)
+
+        ent_out = spacy.displacy.render(doc, style="ent", jupyter=False, page=True)
+        ent_output_path = Path(output_dir, hash_string(f"ent-{text}") + ".html")
+        ent_output_path.open("w", encoding="utf-8").write(ent_out)
+
+        text_visualizations = {
+            "dependency_tree": wandb.Html(str(dep_output_path)),
+            "entities": wandb.Html(str(ent_output_path)),
+        }
+        resp.update(text_visualizations)
+
+    return resp
+
+
+def construct_html_from_prompt_and_generation(prompt: str, generation: str) -> Any:
+    """Construct an html element from a prompt and a generation.
+
+    Parameters:
+        prompt (str): The prompt.
+        generation (str): The generation.
+
+    Returns:
+        (wandb.Html): The html element."""
+    wandb = import_wandb()
+    formatted_prompt = prompt.replace("\n", "<br>")
+    formatted_generation = generation.replace("\n", "<br>")
+
+    return wandb.Html(
+        f"""
+    <p style="color:black;">{formatted_prompt}:</p>
+    <blockquote>
+      <p style="color:green;">
+        {formatted_generation}
+      </p>
+    </blockquote>
+    """,
+        inject=False,
+    )
+
+
+class WandbCallbackHandler(BaseMetadataCallbackHandler, BaseCallbackHandler):
+    """Callback Handler that logs to Weights and Biases.
+
+    Parameters:
+        job_type (str): The type of job.
+        project (str): The project to log to.
+        entity (str): The entity to log to.
+        tags (list): The tags to log.
+        group (str): The group to log to.
+        name (str): The name of the run.
+        notes (str): The notes to log.
+        visualize (bool): Whether to visualize the run.
+        complexity_metrics (bool): Whether to log complexity metrics.
+        stream_logs (bool): Whether to stream callback actions to W&B
+
+    This handler will utilize the associated callback method called and formats
+    the input of each callback function with metadata regarding the state of LLM run,
+    and adds the response to the list of records for both the {method}_records and
+    action. It then logs the response using the run.log() method to Weights and Biases.
+    """
+
+    def __init__(
+        self,
+        job_type: Optional[str] = None,
+        project: Optional[str] = "langchain_callback_demo",
+        entity: Optional[str] = None,
+        tags: Optional[Sequence] = None,
+        group: Optional[str] = None,
+        name: Optional[str] = None,
+        notes: Optional[str] = None,
+        visualize: bool = False,
+        complexity_metrics: bool = False,
+        stream_logs: bool = False,
+    ) -> None:
+        """Initialize callback handler."""
+
+        wandb = import_wandb()
+        import_pandas()
+        import_textstat()
+        spacy = import_spacy()
+        super().__init__()
+
+        self.job_type = job_type
+        self.project = project
+        self.entity = entity
+        self.tags = tags
+        self.group = group
+        self.name = name
+        self.notes = notes
+        self.visualize = visualize
+        self.complexity_metrics = complexity_metrics
+        self.stream_logs = stream_logs
+
+        self.temp_dir = tempfile.TemporaryDirectory()
+        self.run = wandb.init(
+            job_type=self.job_type,
+            project=self.project,
+            entity=self.entity,
+            tags=self.tags,
+            group=self.group,
+            name=self.name,
+            notes=self.notes,
+        )
+        warning = (
+            "DEPRECATION: The `WandbCallbackHandler` will soon be deprecated in favor "
+            "of the `WandbTracer`. Please update your code to use the `WandbTracer` "
+            "instead."
+        )
+        wandb.termwarn(
+            warning,
+            repeat=False,
+        )
+        self.callback_columns: list = []
+        self.action_records: list = []
+        self.complexity_metrics = complexity_metrics
+        self.visualize = visualize
+        self.nlp = spacy.load("en_core_web_sm")
+
+    def _init_resp(self) -> Dict:
+        return {k: None for k in self.callback_columns}
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """Run when LLM starts."""
+        self.step += 1
+        self.llm_starts += 1
+        self.starts += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_llm_start"})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.get_custom_callback_meta())
+
+        for prompt in prompts:
+            prompt_resp = deepcopy(resp)
+            prompt_resp["prompts"] = prompt
+            self.on_llm_start_records.append(prompt_resp)
+            self.action_records.append(prompt_resp)
+            if self.stream_logs:
+                self.run.log(prompt_resp)
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Run when LLM generates a new token."""
+        self.step += 1
+        self.llm_streams += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_llm_new_token", "token": token})
+        resp.update(self.get_custom_callback_meta())
+
+        self.on_llm_token_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.run.log(resp)
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Run when LLM ends running."""
+        self.step += 1
+        self.llm_ends += 1
+        self.ends += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_llm_end"})
+        resp.update(flatten_dict(response.llm_output or {}))
+        resp.update(self.get_custom_callback_meta())
+
+        for generations in response.generations:
+            for generation in generations:
+                generation_resp = deepcopy(resp)
+                generation_resp.update(flatten_dict(generation.dict()))
+                generation_resp.update(
+                    analyze_text(
+                        generation.text,
+                        complexity_metrics=self.complexity_metrics,
+                        visualize=self.visualize,
+                        nlp=self.nlp,
+                        output_dir=self.temp_dir.name,
+                    )
+                )
+                self.on_llm_end_records.append(generation_resp)
+                self.action_records.append(generation_resp)
+                if self.stream_logs:
+                    self.run.log(generation_resp)
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when LLM errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Run when chain starts running."""
+        self.step += 1
+        self.chain_starts += 1
+        self.starts += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_chain_start"})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.get_custom_callback_meta())
+
+        chain_input = inputs["input"]
+
+        if isinstance(chain_input, str):
+            input_resp = deepcopy(resp)
+            input_resp["input"] = chain_input
+            self.on_chain_start_records.append(input_resp)
+            self.action_records.append(input_resp)
+            if self.stream_logs:
+                self.run.log(input_resp)
+        elif isinstance(chain_input, list):
+            for inp in chain_input:
+                input_resp = deepcopy(resp)
+                input_resp.update(inp)
+                self.on_chain_start_records.append(input_resp)
+                self.action_records.append(input_resp)
+                if self.stream_logs:
+                    self.run.log(input_resp)
+        else:
+            raise ValueError("Unexpected data format provided!")
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Run when chain ends running."""
+        self.step += 1
+        self.chain_ends += 1
+        self.ends += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_chain_end", "outputs": outputs["output"]})
+        resp.update(self.get_custom_callback_meta())
+
+        self.on_chain_end_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.run.log(resp)
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when chain errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_tool_start(
+        self, serialized: Dict[str, Any], input_str: str, **kwargs: Any
+    ) -> None:
+        """Run when tool starts running."""
+        self.step += 1
+        self.tool_starts += 1
+        self.starts += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_tool_start", "input_str": input_str})
+        resp.update(flatten_dict(serialized))
+        resp.update(self.get_custom_callback_meta())
+
+        self.on_tool_start_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.run.log(resp)
+
+    def on_tool_end(self, output: Any, **kwargs: Any) -> None:
+        """Run when tool ends running."""
+        output = str(output)
+        self.step += 1
+        self.tool_ends += 1
+        self.ends += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_tool_end", "output": output})
+        resp.update(self.get_custom_callback_meta())
+
+        self.on_tool_end_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.run.log(resp)
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when tool errors."""
+        self.step += 1
+        self.errors += 1
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        """
+        Run when agent is ending.
+        """
+        self.step += 1
+        self.text_ctr += 1
+
+        resp = self._init_resp()
+        resp.update({"action": "on_text", "text": text})
+        resp.update(self.get_custom_callback_meta())
+
+        self.on_text_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.run.log(resp)
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        """Run when agent ends running."""
+        self.step += 1
+        self.agent_ends += 1
+        self.ends += 1
+
+        resp = self._init_resp()
+        resp.update(
+            {
+                "action": "on_agent_finish",
+                "output": finish.return_values["output"],
+                "log": finish.log,
+            }
+        )
+        resp.update(self.get_custom_callback_meta())
+
+        self.on_agent_finish_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.run.log(resp)
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Run on agent action."""
+        self.step += 1
+        self.tool_starts += 1
+        self.starts += 1
+
+        resp = self._init_resp()
+        resp.update(
+            {
+                "action": "on_agent_action",
+                "tool": action.tool,
+                "tool_input": action.tool_input,
+                "log": action.log,
+            }
+        )
+        resp.update(self.get_custom_callback_meta())
+        self.on_agent_action_records.append(resp)
+        self.action_records.append(resp)
+        if self.stream_logs:
+            self.run.log(resp)
+
+    def _create_session_analysis_df(self) -> Any:
+        """Create a dataframe with all the information from the session."""
+        pd = import_pandas()
+        on_llm_start_records_df = pd.DataFrame(self.on_llm_start_records)
+        on_llm_end_records_df = pd.DataFrame(self.on_llm_end_records)
+
+        llm_input_prompts_df = (
+            on_llm_start_records_df[["step", "prompts", "name"]]
+            .dropna(axis=1)
+            .rename({"step": "prompt_step"}, axis=1)
+        )
+        complexity_metrics_columns = []
+        visualizations_columns = []
+
+        if self.complexity_metrics:
+            complexity_metrics_columns = [
+                "flesch_reading_ease",
+                "flesch_kincaid_grade",
+                "smog_index",
+                "coleman_liau_index",
+                "automated_readability_index",
+                "dale_chall_readability_score",
+                "difficult_words",
+                "linsear_write_formula",
+                "gunning_fog",
+                "text_standard",
+                "fernandez_huerta",
+                "szigriszt_pazos",
+                "gutierrez_polini",
+                "crawford",
+                "gulpease_index",
+                "osman",
+            ]
+
+        if self.visualize:
+            visualizations_columns = ["dependency_tree", "entities"]
+
+        llm_outputs_df = (
+            on_llm_end_records_df[
+                [
+                    "step",
+                    "text",
+                    "token_usage_total_tokens",
+                    "token_usage_prompt_tokens",
+                    "token_usage_completion_tokens",
+                ]
+                + complexity_metrics_columns
+                + visualizations_columns
+            ]
+            .dropna(axis=1)
+            .rename({"step": "output_step", "text": "output"}, axis=1)
+        )
+        session_analysis_df = pd.concat([llm_input_prompts_df, llm_outputs_df], axis=1)
+        session_analysis_df["chat_html"] = session_analysis_df[
+            ["prompts", "output"]
+        ].apply(
+            lambda row: construct_html_from_prompt_and_generation(
+                row["prompts"], row["output"]
+            ),
+            axis=1,
+        )
+        return session_analysis_df
+
+    def flush_tracker(
+        self,
+        langchain_asset: Any = None,
+        reset: bool = True,
+        finish: bool = False,
+        job_type: Optional[str] = None,
+        project: Optional[str] = None,
+        entity: Optional[str] = None,
+        tags: Optional[Sequence] = None,
+        group: Optional[str] = None,
+        name: Optional[str] = None,
+        notes: Optional[str] = None,
+        visualize: Optional[bool] = None,
+        complexity_metrics: Optional[bool] = None,
+    ) -> None:
+        """Flush the tracker and reset the session.
+
+        Args:
+            langchain_asset: The langchain asset to save.
+            reset: Whether to reset the session.
+            finish: Whether to finish the run.
+            job_type: The job type.
+            project: The project.
+            entity: The entity.
+            tags: The tags.
+            group: The group.
+            name: The name.
+            notes: The notes.
+            visualize: Whether to visualize.
+            complexity_metrics: Whether to compute complexity metrics.
+
+            Returns:
+                None
+        """
+        pd = import_pandas()
+        wandb = import_wandb()
+        action_records_table = wandb.Table(dataframe=pd.DataFrame(self.action_records))
+        session_analysis_table = wandb.Table(
+            dataframe=self._create_session_analysis_df()
+        )
+        self.run.log(
+            {
+                "action_records": action_records_table,
+                "session_analysis": session_analysis_table,
+            }
+        )
+
+        if langchain_asset:
+            langchain_asset_path = Path(self.temp_dir.name, "model.json")
+            model_artifact = wandb.Artifact(name="model", type="model")
+            model_artifact.add(action_records_table, name="action_records")
+            model_artifact.add(session_analysis_table, name="session_analysis")
+            try:
+                langchain_asset.save(langchain_asset_path)
+                model_artifact.add_file(str(langchain_asset_path))
+                model_artifact.metadata = load_json_to_dict(langchain_asset_path)
+            except ValueError:
+                langchain_asset.save_agent(langchain_asset_path)
+                model_artifact.add_file(str(langchain_asset_path))
+                model_artifact.metadata = load_json_to_dict(langchain_asset_path)
+            except NotImplementedError as e:
+                print("Could not save model.")  # noqa: T201
+                print(repr(e))  # noqa: T201
+                pass
+            self.run.log_artifact(model_artifact)
+
+        if finish or reset:
+            self.run.finish()
+            self.temp_dir.cleanup()
+            self.reset_callback_meta()
+        if reset:
+            self.__init__(  # type: ignore
+                job_type=job_type if job_type else self.job_type,
+                project=project if project else self.project,
+                entity=entity if entity else self.entity,
+                tags=tags if tags else self.tags,
+                group=group if group else self.group,
+                name=name if name else self.name,
+                notes=notes if notes else self.notes,
+                visualize=visualize if visualize else self.visualize,
+                complexity_metrics=(
+                    complexity_metrics
+                    if complexity_metrics
+                    else self.complexity_metrics
+                ),
+            )
diff --git a/llm/Lib/site-packages/langchain_community/callbacks/whylabs_callback.py b/llm/Lib/site-packages/langchain_community/callbacks/whylabs_callback.py
new file mode 100644
index 0000000000000000000000000000000000000000..8e8f98549129b29c3d447d47d4c0276ce36de9f7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/callbacks/whylabs_callback.py
@@ -0,0 +1,192 @@
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Any, Optional
+
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.utils import get_from_env
+
+if TYPE_CHECKING:
+    from whylogs.api.logger.logger import Logger
+
+diagnostic_logger = logging.getLogger(__name__)
+
+
+def import_langkit(
+    sentiment: bool = False,
+    toxicity: bool = False,
+    themes: bool = False,
+) -> Any:
+    """Import the langkit python package and raise an error if it is not installed.
+
+    Args:
+        sentiment: Whether to import the langkit.sentiment module. Defaults to False.
+        toxicity: Whether to import the langkit.toxicity module. Defaults to False.
+        themes: Whether to import the langkit.themes module. Defaults to False.
+
+    Returns:
+        The imported langkit module.
+    """
+    try:
+        import langkit  # noqa: F401
+        import langkit.regexes  # noqa: F401
+        import langkit.textstat  # noqa: F401
+
+        if sentiment:
+            import langkit.sentiment  # noqa: F401
+        if toxicity:
+            import langkit.toxicity  # noqa: F401
+        if themes:
+            import langkit.themes  # noqa: F401
+    except ImportError:
+        raise ImportError(
+            "To use the whylabs callback manager you need to have the `langkit` python "
+            "package installed. Please install it with `pip install langkit`."
+        )
+    return langkit
+
+
+class WhyLabsCallbackHandler(BaseCallbackHandler):
+    """
+    Callback Handler for logging to WhyLabs. This callback handler utilizes
+    `langkit` to extract features from the prompts & responses when interacting with
+    an LLM. These features can be used to guardrail, evaluate, and observe interactions
+    over time to detect issues relating to hallucinations, prompt engineering,
+    or output validation. LangKit is an LLM monitoring toolkit developed by WhyLabs.
+
+    Here are some examples of what can be monitored with LangKit:
+    * Text Quality
+      - readability score
+      - complexity and grade scores
+    * Text Relevance
+      - Similarity scores between prompt/responses
+      - Similarity scores against user-defined themes
+      - Topic classification
+    * Security and Privacy
+      - patterns - count of strings matching a user-defined regex pattern group
+      - jailbreaks - similarity scores with respect to known jailbreak attempts
+      - prompt injection - similarity scores with respect to known prompt attacks
+      - refusals - similarity scores with respect to known LLM refusal responses
+    * Sentiment and Toxicity
+      - sentiment analysis
+      - toxicity analysis
+
+    For more information, see https://docs.whylabs.ai/docs/language-model-monitoring
+    or check out the LangKit repo here: https://github.com/whylabs/langkit
+
+    ---
+    Args:
+        api_key (Optional[str]): WhyLabs API key. Optional because the preferred
+            way to specify the API key is with environment variable
+            WHYLABS_API_KEY.
+        org_id (Optional[str]): WhyLabs organization id to write profiles to.
+            Optional because the preferred way to specify the organization id is
+            with environment variable WHYLABS_DEFAULT_ORG_ID.
+        dataset_id (Optional[str]): WhyLabs dataset id to write profiles to.
+            Optional because the preferred way to specify the dataset id is
+            with environment variable WHYLABS_DEFAULT_DATASET_ID.
+        sentiment (bool): Whether to enable sentiment analysis. Defaults to False.
+        toxicity (bool): Whether to enable toxicity analysis. Defaults to False.
+        themes (bool): Whether to enable theme analysis. Defaults to False.
+    """
+
+    def __init__(self, logger: Logger, handler: Any):
+        """Initiate the rolling logger."""
+        super().__init__()
+        if hasattr(handler, "init"):
+            handler.init(self)
+        if hasattr(handler, "_get_callbacks"):
+            self._callbacks = handler._get_callbacks()
+        else:
+            self._callbacks = dict()
+            diagnostic_logger.warning("initialized handler without callbacks.")
+        self._logger = logger
+
+    def flush(self) -> None:
+        """Explicitly write current profile if using a rolling logger."""
+        if self._logger and hasattr(self._logger, "_do_rollover"):
+            self._logger._do_rollover()
+            diagnostic_logger.info("Flushing WhyLabs logger, writing profile...")
+
+    def close(self) -> None:
+        """Close any loggers to allow writing out of any profiles before exiting."""
+        if self._logger and hasattr(self._logger, "close"):
+            self._logger.close()
+            diagnostic_logger.info("Closing WhyLabs logger, see you next time!")
+
+    def __enter__(self) -> WhyLabsCallbackHandler:
+        return self
+
+    def __exit__(
+        self, exception_type: Any, exception_value: Any, traceback: Any
+    ) -> None:
+        self.close()
+
+    @classmethod
+    def from_params(
+        cls,
+        *,
+        api_key: Optional[str] = None,
+        org_id: Optional[str] = None,
+        dataset_id: Optional[str] = None,
+        sentiment: bool = False,
+        toxicity: bool = False,
+        themes: bool = False,
+        logger: Optional[Logger] = None,
+    ) -> WhyLabsCallbackHandler:
+        """Instantiate whylogs Logger from params.
+
+        Args:
+            api_key (Optional[str]): WhyLabs API key. Optional because the preferred
+                way to specify the API key is with environment variable
+                WHYLABS_API_KEY.
+            org_id (Optional[str]): WhyLabs organization id to write profiles to.
+                If not set must be specified in environment variable
+                WHYLABS_DEFAULT_ORG_ID.
+            dataset_id (Optional[str]): The model or dataset this callback is gathering
+                telemetry for. If not set must be specified in environment variable
+                WHYLABS_DEFAULT_DATASET_ID.
+            sentiment (bool): If True will initialize a model to perform
+                sentiment analysis compound score. Defaults to False and will not gather
+                this metric.
+            toxicity (bool): If True will initialize a model to score
+                toxicity. Defaults to False and will not gather this metric.
+            themes (bool): If True will initialize a model to calculate
+                distance to configured themes. Defaults to None and will not gather this
+                metric.
+            logger (Optional[Logger]): If specified will bind the configured logger as
+                the telemetry gathering agent. Defaults to LangKit schema with periodic
+                WhyLabs writer.
+        """
+        # langkit library will import necessary whylogs libraries
+        import_langkit(sentiment=sentiment, toxicity=toxicity, themes=themes)
+
+        import whylogs as why
+        from langkit.callback_handler import get_callback_instance
+        from whylogs.api.writer.whylabs import WhyLabsWriter
+        from whylogs.experimental.core.udf_schema import udf_schema
+
+        if logger is None:
+            api_key = api_key or get_from_env("api_key", "WHYLABS_API_KEY")
+            org_id = org_id or get_from_env("org_id", "WHYLABS_DEFAULT_ORG_ID")
+            dataset_id = dataset_id or get_from_env(
+                "dataset_id", "WHYLABS_DEFAULT_DATASET_ID"
+            )
+            whylabs_writer = WhyLabsWriter(
+                api_key=api_key, org_id=org_id, dataset_id=dataset_id
+            )
+
+            whylabs_logger = why.logger(
+                mode="rolling", interval=5, when="M", schema=udf_schema()
+            )
+
+            whylabs_logger.append_writer(writer=whylabs_writer)
+        else:
+            diagnostic_logger.info("Using passed in whylogs logger {logger}")
+            whylabs_logger = logger
+
+        callback_handler_cls = get_callback_instance(logger=whylabs_logger, impl=cls)
+        diagnostic_logger.info(
+            "Started whylogs Logger with WhyLabsWriter and initialized LangKit. 📝"
+        )
+        return callback_handler_cls
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/__init__.py b/llm/Lib/site-packages/langchain_community/chat_loaders/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9c522c88ab5de6f944c3d4b328d2cb56293396b3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_loaders/__init__.py
@@ -0,0 +1,86 @@
+"""**Chat Loaders** load chat messages from common communications platforms.
+
+Load chat messages from various
+communications platforms such as Facebook Messenger, Telegram, and
+WhatsApp. The loaded chat messages can be used for fine-tuning models.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseChatLoader --> <name>ChatLoader  # Examples: WhatsAppChatLoader, IMessageChatLoader
+
+**Main helpers:**
+
+.. code-block::
+
+    ChatSession
+
+"""  # noqa: E501
+
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.chat_loaders.base import (
+        BaseChatLoader,  # noqa: F401
+    )
+    from langchain_community.chat_loaders.facebook_messenger import (
+        FolderFacebookMessengerChatLoader,  # noqa: F401
+        SingleFileFacebookMessengerChatLoader,  # noqa: F401
+    )
+    from langchain_community.chat_loaders.gmail import (
+        GMailLoader,  # noqa: F401
+    )
+    from langchain_community.chat_loaders.imessage import (
+        IMessageChatLoader,  # noqa: F401
+    )
+    from langchain_community.chat_loaders.langsmith import (
+        LangSmithDatasetChatLoader,  # noqa: F401
+        LangSmithRunChatLoader,  # noqa: F401
+    )
+    from langchain_community.chat_loaders.slack import (
+        SlackChatLoader,  # noqa: F401
+    )
+    from langchain_community.chat_loaders.telegram import (
+        TelegramChatLoader,  # noqa: F401
+    )
+    from langchain_community.chat_loaders.whatsapp import (
+        WhatsAppChatLoader,  # noqa: F401
+    )
+
+__all__ = [
+    "BaseChatLoader",
+    "FolderFacebookMessengerChatLoader",
+    "GMailLoader",
+    "IMessageChatLoader",
+    "LangSmithDatasetChatLoader",
+    "LangSmithRunChatLoader",
+    "SingleFileFacebookMessengerChatLoader",
+    "SlackChatLoader",
+    "TelegramChatLoader",
+    "WhatsAppChatLoader",
+]
+
+_module_lookup = {
+    "BaseChatLoader": "langchain_community.chat_loaders.base",
+    "FolderFacebookMessengerChatLoader": "langchain_community.chat_loaders.facebook_messenger",  # noqa: E501
+    "GMailLoader": "langchain_community.chat_loaders.gmail",
+    "IMessageChatLoader": "langchain_community.chat_loaders.imessage",
+    "LangSmithDatasetChatLoader": "langchain_community.chat_loaders.langsmith",
+    "LangSmithRunChatLoader": "langchain_community.chat_loaders.langsmith",
+    "SingleFileFacebookMessengerChatLoader": "langchain_community.chat_loaders.facebook_messenger",  # noqa: E501
+    "SlackChatLoader": "langchain_community.chat_loaders.slack",
+    "TelegramChatLoader": "langchain_community.chat_loaders.telegram",
+    "WhatsAppChatLoader": "langchain_community.chat_loaders.whatsapp",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fbe20ef682643628686dceb6434c477bc974466a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f70a4df2efa52b0b288d3ac46fc3aa920c56562c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/facebook_messenger.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/facebook_messenger.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0016250c4f3efb0c1730e78decc10d7eadc3b362
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/facebook_messenger.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/gmail.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/gmail.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..63cef12c15923e4aad579995ecad7adf276f9cfe
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/gmail.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/imessage.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/imessage.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..996a2747ea1a5a0193b4b0e93df1e4f75de5c475
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/imessage.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/langsmith.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/langsmith.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..720ed0253cfa752b740ee9414253dc5646ea26ae
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/langsmith.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/slack.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/slack.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..48c1392ef1314ccdfbabda9c4bb2b5ec21490132
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/slack.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/telegram.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/telegram.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..307835f83c55567b8a503503af1ceb33f46f9cdb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/telegram.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b17c1d26dae5657d4173cdc469d2d4412362d21b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/whatsapp.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/whatsapp.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ee09abf124ffb6775eecfcbe8661e807340fbaf8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_loaders/__pycache__/whatsapp.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/base.py b/llm/Lib/site-packages/langchain_community/chat_loaders/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..7bbdd8894d4920d80e93189f9fe8033a899dc576
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_loaders/base.py
@@ -0,0 +1,16 @@
+from abc import ABC, abstractmethod
+from typing import Iterator, List
+
+from langchain_core.chat_sessions import ChatSession
+
+
+class BaseChatLoader(ABC):
+    """Base class for chat loaders."""
+
+    @abstractmethod
+    def lazy_load(self) -> Iterator[ChatSession]:
+        """Lazy load the chat sessions."""
+
+    def load(self) -> List[ChatSession]:
+        """Eagerly load the chat sessions into memory."""
+        return list(self.lazy_load())
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/facebook_messenger.py b/llm/Lib/site-packages/langchain_community/chat_loaders/facebook_messenger.py
new file mode 100644
index 0000000000000000000000000000000000000000..82d326de083f265ad666c4abd41b30fa9cd2efcb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_loaders/facebook_messenger.py
@@ -0,0 +1,85 @@
+import json
+import logging
+from pathlib import Path
+from typing import Iterator, Union
+
+from langchain_core.chat_sessions import ChatSession
+from langchain_core.messages import HumanMessage
+
+from langchain_community.chat_loaders.base import BaseChatLoader
+
+logger = logging.getLogger(__file__)
+
+
+class SingleFileFacebookMessengerChatLoader(BaseChatLoader):
+    """Load `Facebook Messenger` chat data from a single file.
+
+    Args:
+        path (Union[Path, str]): The path to the chat file.
+
+    Attributes:
+        path (Path): The path to the chat file.
+
+    """
+
+    def __init__(self, path: Union[Path, str]) -> None:
+        super().__init__()
+        self.file_path = path if isinstance(path, Path) else Path(path)
+
+    def lazy_load(self) -> Iterator[ChatSession]:
+        """Lazy loads the chat data from the file.
+
+        Yields:
+            ChatSession: A chat session containing the loaded messages.
+
+        """
+        with open(self.file_path) as f:
+            data = json.load(f)
+        sorted_data = sorted(data["messages"], key=lambda x: x["timestamp_ms"])
+        messages = []
+        for index, m in enumerate(sorted_data):
+            if "content" not in m:
+                logger.info(
+                    f"""Skipping Message No.
+                    {index+1} as no content is present in the message"""
+                )
+                continue
+            messages.append(
+                HumanMessage(
+                    content=m["content"], additional_kwargs={"sender": m["sender_name"]}
+                )
+            )
+        yield ChatSession(messages=messages)
+
+
+class FolderFacebookMessengerChatLoader(BaseChatLoader):
+    """Load `Facebook Messenger` chat data from a folder.
+
+    Args:
+        path (Union[str, Path]): The path to the directory
+            containing the chat files.
+
+    Attributes:
+        path (Path): The path to the directory containing the chat files.
+
+    """
+
+    def __init__(self, path: Union[str, Path]) -> None:
+        super().__init__()
+        self.directory_path = Path(path) if isinstance(path, str) else path
+
+    def lazy_load(self) -> Iterator[ChatSession]:
+        """Lazy loads the chat data from the folder.
+
+        Yields:
+            ChatSession: A chat session containing the loaded messages.
+
+        """
+        inbox_path = self.directory_path / "inbox"
+        for _dir in inbox_path.iterdir():
+            if _dir.is_dir():
+                for _file in _dir.iterdir():
+                    if _file.suffix.lower() == ".json":
+                        file_loader = SingleFileFacebookMessengerChatLoader(path=_file)
+                        for result in file_loader.lazy_load():
+                            yield result
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/gmail.py b/llm/Lib/site-packages/langchain_community/chat_loaders/gmail.py
new file mode 100644
index 0000000000000000000000000000000000000000..27dd0ff906574181c151cef447153edb6cb931a1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_loaders/gmail.py
@@ -0,0 +1,118 @@
+import base64
+import re
+from typing import Any, Iterator
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.chat_sessions import ChatSession
+from langchain_core.messages import HumanMessage
+
+from langchain_community.chat_loaders.base import BaseChatLoader
+
+
+def _extract_email_content(msg: Any) -> HumanMessage:
+    from_email = None
+    for values in msg["payload"]["headers"]:
+        name = values["name"]
+        if name == "From":
+            from_email = values["value"]
+    if from_email is None:
+        raise ValueError
+    for part in msg["payload"]["parts"]:
+        if part["mimeType"] == "text/plain":
+            data = part["body"]["data"]
+            data = base64.urlsafe_b64decode(data).decode("utf-8")
+            # Regular expression to split the email body at the first
+            # occurrence of a line that starts with "On ... wrote:"
+            pattern = re.compile(r"\r\nOn .+(\r\n)*wrote:\r\n")
+            # Split the email body and extract the first part
+            newest_response = re.split(pattern, data)[0]
+            message = HumanMessage(
+                content=newest_response, additional_kwargs={"sender": from_email}
+            )
+            return message
+    raise ValueError
+
+
+def _get_message_data(service: Any, message: Any) -> ChatSession:
+    msg = service.users().messages().get(userId="me", id=message["id"]).execute()
+    message_content = _extract_email_content(msg)
+    in_reply_to = None
+    email_data = msg["payload"]["headers"]
+    for values in email_data:
+        name = values["name"]
+        if name == "In-Reply-To":
+            in_reply_to = values["value"]
+    if in_reply_to is None:
+        raise ValueError
+
+    thread_id = msg["threadId"]
+
+    thread = service.users().threads().get(userId="me", id=thread_id).execute()
+    messages = thread["messages"]
+
+    response_email = None
+    for message in messages:
+        email_data = message["payload"]["headers"]
+        for values in email_data:
+            if values["name"] == "Message-ID":
+                message_id = values["value"]
+                if message_id == in_reply_to:
+                    response_email = message
+    if response_email is None:
+        raise ValueError
+    starter_content = _extract_email_content(response_email)
+    return ChatSession(messages=[starter_content, message_content])
+
+
+@deprecated(
+    since="0.0.32",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.GMailLoader",
+)
+class GMailLoader(BaseChatLoader):
+    """Load data from `GMail`.
+
+    There are many ways you could want to load data from GMail.
+    This loader is currently fairly opinionated in how to do so.
+    The way it does it is it first looks for all messages that you have sent.
+    It then looks for messages where you are responding to a previous email.
+    It then fetches that previous email, and creates a training example
+    of that email, followed by your email.
+
+    Note that there are clear limitations here. For example,
+    all examples created are only looking at the previous email for context.
+
+    To use:
+
+    - Set up a Google Developer Account:
+        Go to the Google Developer Console, create a project,
+        and enable the Gmail API for that project.
+        This will give you a credentials.json file that you'll need later.
+    """
+
+    def __init__(self, creds: Any, n: int = 100, raise_error: bool = False) -> None:
+        super().__init__()
+        self.creds = creds
+        self.n = n
+        self.raise_error = raise_error
+
+    def lazy_load(self) -> Iterator[ChatSession]:
+        from googleapiclient.discovery import build
+
+        service = build("gmail", "v1", credentials=self.creds)
+        results = (
+            service.users()
+            .messages()
+            .list(userId="me", labelIds=["SENT"], maxResults=self.n)
+            .execute()
+        )
+        messages = results.get("messages", [])
+        for message in messages:
+            try:
+                yield _get_message_data(service, message)
+            except Exception as e:
+                # TODO: handle errors better
+                if self.raise_error:
+                    raise e
+                else:
+                    pass
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/imessage.py b/llm/Lib/site-packages/langchain_community/chat_loaders/imessage.py
new file mode 100644
index 0000000000000000000000000000000000000000..0e534f65d39b753a04454e01488cac990c8f7b5c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_loaders/imessage.py
@@ -0,0 +1,212 @@
+from __future__ import annotations
+
+from datetime import datetime
+from pathlib import Path
+from typing import TYPE_CHECKING, Iterator, List, Optional, Union
+
+from langchain_core.chat_sessions import ChatSession
+from langchain_core.messages import HumanMessage
+
+from langchain_community.chat_loaders.base import BaseChatLoader
+
+if TYPE_CHECKING:
+    import sqlite3
+
+
+def nanoseconds_from_2001_to_datetime(nanoseconds: int) -> datetime:
+    # Convert nanoseconds to seconds (1 second = 1e9 nanoseconds)
+    timestamp_in_seconds = nanoseconds / 1e9
+
+    # The reference date is January 1, 2001, in Unix time
+    reference_date_seconds = datetime(2001, 1, 1).timestamp()
+
+    # Calculate the actual timestamp by adding the reference date
+    actual_timestamp = reference_date_seconds + timestamp_in_seconds
+
+    # Convert to a datetime object
+    return datetime.fromtimestamp(actual_timestamp)
+
+
+class IMessageChatLoader(BaseChatLoader):
+    """Load chat sessions from the `iMessage` chat.db SQLite file.
+
+    It only works on macOS when you have iMessage enabled and have the chat.db file.
+
+    The chat.db file is likely located at ~/Library/Messages/chat.db. However, your
+    terminal may not have permission to access this file. To resolve this, you can
+    copy the file to a different location, change the permissions of the file, or
+    grant full disk access for your terminal emulator
+    in System Settings > Security and Privacy > Full Disk Access.
+    """
+
+    def __init__(self, path: Optional[Union[str, Path]] = None):
+        """
+        Initialize the IMessageChatLoader.
+
+        Args:
+            path (str or Path, optional): Path to the chat.db SQLite file.
+                Defaults to None, in which case the default path
+                ~/Library/Messages/chat.db will be used.
+        """
+        if path is None:
+            path = Path.home() / "Library" / "Messages" / "chat.db"
+        self.db_path = path if isinstance(path, Path) else Path(path)
+        if not self.db_path.exists():
+            raise FileNotFoundError(f"File {self.db_path} not found")
+        try:
+            import sqlite3  # noqa: F401
+        except ImportError as e:
+            raise ImportError(
+                "The sqlite3 module is required to load iMessage chats.\n"
+                "Please install it with `pip install pysqlite3`"
+            ) from e
+
+    def _parse_attributedBody(self, attributedBody: bytes) -> str:
+        """
+        Parse the attributedBody field of the message table
+        for the text content of the message.
+
+        The attributedBody field is a binary blob that contains
+        the message content after the byte string b"NSString":
+
+                              5 bytes      1-3 bytes    `len` bytes
+        ... | b"NSString" |   preamble   |   `len`   |    contents    | ...
+
+        The 5 preamble bytes are always b"\x01\x94\x84\x01+"
+
+        The size of `len` is either 1 byte or 3 bytes:
+        - If the first byte in `len` is b"\x81" then `len` is 3 bytes long.
+          So the message length is the 2 bytes after, in little Endian.
+        - Otherwise, the size of `len` is 1 byte, and the message length is
+          that byte.
+
+        Args:
+            attributedBody (bytes): attributedBody field of the message table.
+        Return:
+            str: Text content of the message.
+        """
+        content = attributedBody.split(b"NSString")[1][5:]
+        length, start = content[0], 1
+        if content[0] == 129:
+            length, start = int.from_bytes(content[1:3], "little"), 3
+        return content[start : start + length].decode("utf-8", errors="ignore")
+
+    def _get_session_query(self, use_chat_handle_table: bool) -> str:
+        # Messages sent pre OSX 12 require a join through the chat_handle_join table
+        # However, the table doesn't exist if database created with OSX 12 or above.
+
+        joins_w_chat_handle = """
+            JOIN chat_handle_join ON
+                 chat_message_join.chat_id = chat_handle_join.chat_id
+            JOIN handle ON
+                 handle.ROWID = chat_handle_join.handle_id"""
+
+        joins_no_chat_handle = """
+            JOIN handle ON message.handle_id = handle.ROWID
+        """
+
+        joins = joins_w_chat_handle if use_chat_handle_table else joins_no_chat_handle
+
+        return f"""
+            SELECT  message.date,
+                    handle.id,
+                    message.text,
+                    message.is_from_me,
+                    message.attributedBody
+            FROM message
+            JOIN chat_message_join ON
+                 message.ROWID = chat_message_join.message_id
+            {joins}
+            WHERE chat_message_join.chat_id = ?
+            ORDER BY message.date ASC;
+        """
+
+    def _load_single_chat_session(
+        self, cursor: "sqlite3.Cursor", use_chat_handle_table: bool, chat_id: int
+    ) -> ChatSession:
+        """
+        Load a single chat session from the iMessage chat.db.
+
+        Args:
+            cursor: SQLite cursor object.
+            chat_id (int): ID of the chat session to load.
+
+        Returns:
+            ChatSession: Loaded chat session.
+        """
+        results: List[HumanMessage] = []
+
+        query = self._get_session_query(use_chat_handle_table)
+        cursor.execute(query, (chat_id,))
+        messages = cursor.fetchall()
+
+        for date, sender, text, is_from_me, attributedBody in messages:
+            if text:
+                content = text
+            elif attributedBody:
+                content = self._parse_attributedBody(attributedBody)
+            else:  # Skip messages with no content
+                continue
+
+            results.append(
+                HumanMessage(
+                    role=sender,
+                    content=content,
+                    additional_kwargs={
+                        "message_time": date,
+                        "message_time_as_datetime": nanoseconds_from_2001_to_datetime(
+                            date
+                        ),
+                        "sender": sender,
+                        "is_from_me": bool(is_from_me),
+                    },
+                )
+            )
+
+        return ChatSession(messages=results)
+
+    def lazy_load(self) -> Iterator[ChatSession]:
+        """
+        Lazy load the chat sessions from the iMessage chat.db
+        and yield them in the required format.
+
+        Yields:
+            ChatSession: Loaded chat session.
+        """
+        import sqlite3
+
+        try:
+            conn = sqlite3.connect(self.db_path)
+        except sqlite3.OperationalError as e:
+            raise ValueError(
+                f"Could not open iMessage DB file {self.db_path}.\n"
+                "Make sure your terminal emulator has disk access to this file.\n"
+                "   You can either copy the DB file to an accessible location"
+                " or grant full disk access for your terminal emulator."
+                "  You can grant full disk access for your terminal emulator"
+                " in System Settings > Security and Privacy > Full Disk Access."
+            ) from e
+        cursor = conn.cursor()
+
+        # See if chat_handle_join table exists:
+        query = """SELECT name FROM sqlite_master
+                   WHERE type='table' AND name='chat_handle_join';"""
+
+        cursor.execute(query)
+        is_chat_handle_join_exists = cursor.fetchone()
+
+        # Fetch the list of chat IDs sorted by time (most recent first)
+        query = """SELECT chat_id
+        FROM message
+        JOIN chat_message_join ON message.ROWID = chat_message_join.message_id
+        GROUP BY chat_id
+        ORDER BY MAX(date) DESC;"""
+        cursor.execute(query)
+        chat_ids = [row[0] for row in cursor.fetchall()]
+
+        for chat_id in chat_ids:
+            yield self._load_single_chat_session(
+                cursor, is_chat_handle_join_exists, chat_id
+            )
+
+        conn.close()
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/langsmith.py b/llm/Lib/site-packages/langchain_community/chat_loaders/langsmith.py
new file mode 100644
index 0000000000000000000000000000000000000000..4e769283dd2e4465475cee9bed9cb12490df497b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_loaders/langsmith.py
@@ -0,0 +1,159 @@
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Dict, Iterable, Iterator, List, Optional, Union, cast
+
+from langchain_core.chat_sessions import ChatSession
+from langchain_core.load.load import load
+
+from langchain_community.chat_loaders.base import BaseChatLoader
+
+if TYPE_CHECKING:
+    from langsmith.client import Client
+    from langsmith.schemas import Run
+
+logger = logging.getLogger(__name__)
+
+
+class LangSmithRunChatLoader(BaseChatLoader):
+    """
+    Load chat sessions from a list of LangSmith "llm" runs.
+
+    Attributes:
+        runs (Iterable[Union[str, Run]]): The list of LLM run IDs or run objects.
+        client (Client): Instance of LangSmith client for fetching data.
+    """
+
+    def __init__(
+        self, runs: Iterable[Union[str, Run]], client: Optional["Client"] = None
+    ):
+        """
+        Initialize a new LangSmithRunChatLoader instance.
+
+        :param runs: List of LLM run IDs or run objects.
+        :param client: An instance of LangSmith client, if not provided,
+            a new client instance will be created.
+        """
+        from langsmith.client import Client
+
+        self.runs = runs
+        self.client = client or Client()
+
+    def _load_single_chat_session(self, llm_run: "Run") -> ChatSession:
+        """
+        Convert an individual LangSmith LLM run to a ChatSession.
+
+        :param llm_run: The LLM run object.
+        :return: A chat session representing the run's data.
+        """
+        chat_session = LangSmithRunChatLoader._get_messages_from_llm_run(llm_run)
+        functions = LangSmithRunChatLoader._get_functions_from_llm_run(llm_run)
+        if functions:
+            chat_session["functions"] = functions
+        return chat_session
+
+    @staticmethod
+    def _get_messages_from_llm_run(llm_run: "Run") -> ChatSession:
+        """
+        Extract messages from a LangSmith LLM run.
+
+        :param llm_run: The LLM run object.
+        :return: ChatSession with the extracted messages.
+        """
+        if llm_run.run_type != "llm":
+            raise ValueError(f"Expected run of type llm. Got: {llm_run.run_type}")
+        if "messages" not in llm_run.inputs:
+            raise ValueError(f"Run has no 'messages' inputs. Got {llm_run.inputs}")
+        if not llm_run.outputs:
+            raise ValueError("Cannot convert pending run")
+        messages = load(llm_run.inputs)["messages"]
+        message_chunk = load(llm_run.outputs)["generations"][0]["message"]
+        return ChatSession(messages=messages + [message_chunk])
+
+    @staticmethod
+    def _get_functions_from_llm_run(llm_run: "Run") -> Optional[List[Dict]]:
+        """
+        Extract functions from a LangSmith LLM run if they exist.
+
+        :param llm_run: The LLM run object.
+        :return: Functions from the run or None.
+        """
+        if llm_run.run_type != "llm":
+            raise ValueError(f"Expected run of type llm. Got: {llm_run.run_type}")
+        return (llm_run.extra or {}).get("invocation_params", {}).get("functions")
+
+    def lazy_load(self) -> Iterator[ChatSession]:
+        """
+        Lazy load the chat sessions from the iterable of run IDs.
+
+        This method fetches the runs and converts them to chat sessions on-the-fly,
+        yielding one session at a time.
+
+        :return: Iterator of chat sessions containing messages.
+        """
+        from langsmith.schemas import Run
+
+        for run_obj in self.runs:
+            try:
+                if hasattr(run_obj, "id"):
+                    run = run_obj
+                else:
+                    run = self.client.read_run(run_obj)
+                session = self._load_single_chat_session(cast(Run, run))
+                yield session
+            except ValueError as e:
+                logger.warning(f"Could not load run {run_obj}: {repr(e)}")
+                continue
+
+
+class LangSmithDatasetChatLoader(BaseChatLoader):
+    """
+    Load chat sessions from a LangSmith dataset with the "chat" data type.
+
+    Attributes:
+        dataset_name (str): The name of the LangSmith dataset.
+        client (Client): Instance of LangSmith client for fetching data.
+    """
+
+    def __init__(self, *, dataset_name: str, client: Optional["Client"] = None):
+        """
+        Initialize a new LangSmithChatDatasetLoader instance.
+
+        :param dataset_name: The name of the LangSmith dataset.
+        :param client: An instance of LangSmith client; if not provided,
+            a new client instance will be created.
+        """
+        try:
+            from langsmith.client import Client
+        except ImportError as e:
+            raise ImportError(
+                "The LangSmith client is required to load LangSmith datasets.\n"
+                "Please install it with `pip install langsmith`"
+            ) from e
+
+        self.dataset_name = dataset_name
+        self.client = client or Client()
+
+    def lazy_load(self) -> Iterator[ChatSession]:
+        """
+        Lazy load the chat sessions from the specified LangSmith dataset.
+
+        This method fetches the chat data from the dataset and
+        converts each data point to chat sessions on-the-fly,
+        yielding one session at a time.
+
+        :return: Iterator of chat sessions containing messages.
+        """
+        from langchain_community.adapters import openai as oai_adapter  # noqa: E402
+
+        data = self.client.read_dataset_openai_finetuning(
+            dataset_name=self.dataset_name
+        )
+        for data_point in data:
+            yield ChatSession(
+                messages=[
+                    oai_adapter.convert_dict_to_message(m)
+                    for m in data_point.get("messages", [])
+                ],
+                functions=data_point.get("functions"),
+            )
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/slack.py b/llm/Lib/site-packages/langchain_community/chat_loaders/slack.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b2603829f162366f4a4d03cf04cee01000bcfc3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_loaders/slack.py
@@ -0,0 +1,86 @@
+import json
+import logging
+import re
+import zipfile
+from pathlib import Path
+from typing import Dict, Iterator, List, Union
+
+from langchain_core.chat_sessions import ChatSession
+from langchain_core.messages import AIMessage, HumanMessage
+
+from langchain_community.chat_loaders.base import BaseChatLoader
+
+logger = logging.getLogger(__name__)
+
+
+class SlackChatLoader(BaseChatLoader):
+    """Load `Slack` conversations from a dump zip file."""
+
+    def __init__(
+        self,
+        path: Union[str, Path],
+    ):
+        """
+        Initialize the chat loader with the path to the exported Slack dump zip file.
+
+        :param path: Path to the exported Slack dump zip file.
+        """
+        self.zip_path = path if isinstance(path, Path) else Path(path)
+        if not self.zip_path.exists():
+            raise FileNotFoundError(f"File {self.zip_path} not found")
+
+    def _load_single_chat_session(self, messages: List[Dict]) -> ChatSession:
+        results: List[Union[AIMessage, HumanMessage]] = []
+        previous_sender = None
+        for message in messages:
+            if not isinstance(message, dict):
+                continue
+            text = message.get("text", "")
+            timestamp = message.get("ts", "")
+            sender = message.get("user", "")
+            if not sender:
+                continue
+            skip_pattern = re.compile(
+                r"<@U\d+> has joined the channel", flags=re.IGNORECASE
+            )
+            if skip_pattern.match(text):
+                continue
+            if sender == previous_sender:
+                results[-1].content += "\n\n" + text
+                results[-1].additional_kwargs["events"].append(
+                    {"message_time": timestamp}
+                )
+            else:
+                results.append(
+                    HumanMessage(
+                        role=sender,
+                        content=text,
+                        additional_kwargs={
+                            "sender": sender,
+                            "events": [{"message_time": timestamp}],
+                        },
+                    )
+                )
+            previous_sender = sender
+        return ChatSession(messages=results)
+
+    def _read_json(self, zip_file: zipfile.ZipFile, file_path: str) -> List[dict]:
+        """Read JSON data from a zip subfile."""
+        with zip_file.open(file_path, "r") as f:
+            data = json.load(f)
+        if not isinstance(data, list):
+            raise ValueError(f"Expected list of dictionaries, got {type(data)}")
+        return data
+
+    def lazy_load(self) -> Iterator[ChatSession]:
+        """
+        Lazy load the chat sessions from the Slack dump file and yield them
+        in the required format.
+
+        :return: Iterator of chat sessions containing messages.
+        """
+        with zipfile.ZipFile(str(self.zip_path), "r") as zip_file:
+            for file_path in zip_file.namelist():
+                if file_path.endswith(".json"):
+                    messages = self._read_json(zip_file, file_path)
+                    yield self._load_single_chat_session(messages)
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/telegram.py b/llm/Lib/site-packages/langchain_community/chat_loaders/telegram.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff2056162b5bd0ac76c4f193da0742cac9bdc8ff
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_loaders/telegram.py
@@ -0,0 +1,151 @@
+import json
+import logging
+import os
+import tempfile
+import zipfile
+from pathlib import Path
+from typing import Iterator, List, Union
+
+from langchain_core.chat_sessions import ChatSession
+from langchain_core.messages import AIMessage, BaseMessage, HumanMessage
+
+from langchain_community.chat_loaders.base import BaseChatLoader
+
+logger = logging.getLogger(__name__)
+
+
+class TelegramChatLoader(BaseChatLoader):
+    """Load `telegram` conversations to LangChain chat messages.
+
+    To export, use the Telegram Desktop app from
+    https://desktop.telegram.org/, select a conversation, click the three dots
+    in the top right corner, and select "Export chat history". Then select
+    "Machine-readable JSON" (preferred) to export. Note: the 'lite' versions of
+    the desktop app (like "Telegram for MacOS") do not support exporting chat
+    history.
+    """
+
+    def __init__(
+        self,
+        path: Union[str, Path],
+    ):
+        """Initialize the TelegramChatLoader.
+
+        Args:
+            path (Union[str, Path]): Path to the exported Telegram chat zip,
+                 directory, json, or HTML file.
+        """
+        self.path = path if isinstance(path, str) else str(path)
+
+    def _load_single_chat_session_html(self, file_path: str) -> ChatSession:
+        """Load a single chat session from an HTML file.
+
+        Args:
+            file_path (str): Path to the HTML file.
+
+        Returns:
+            ChatSession: The loaded chat session.
+        """
+        try:
+            from bs4 import BeautifulSoup
+        except ImportError:
+            raise ImportError(
+                "Please install the 'beautifulsoup4' package to load"
+                " Telegram HTML files. You can do this by running"
+                "'pip install beautifulsoup4' in your terminal."
+            )
+        with open(file_path, "r", encoding="utf-8") as file:
+            soup = BeautifulSoup(file, "html.parser")
+
+        results: List[Union[HumanMessage, AIMessage]] = []
+        previous_sender = None
+        for message in soup.select(".message.default"):
+            timestamp = message.select_one(".pull_right.date.details")["title"]
+            from_name_element = message.select_one(".from_name")
+            if from_name_element is None and previous_sender is None:
+                logger.debug("from_name not found in message")
+                continue
+            elif from_name_element is None:
+                from_name = previous_sender
+            else:
+                from_name = from_name_element.text.strip()
+            text = message.select_one(".text").text.strip()
+            results.append(
+                HumanMessage(
+                    content=text,
+                    additional_kwargs={
+                        "sender": from_name,
+                        "events": [{"message_time": timestamp}],
+                    },
+                )
+            )
+            previous_sender = from_name
+
+        return ChatSession(messages=results)
+
+    def _load_single_chat_session_json(self, file_path: str) -> ChatSession:
+        """Load a single chat session from a JSON file.
+
+        Args:
+            file_path (str): Path to the JSON file.
+
+        Returns:
+            ChatSession: The loaded chat session.
+        """
+        with open(file_path, "r", encoding="utf-8") as file:
+            data = json.load(file)
+
+        messages = data.get("messages", [])
+        results: List[BaseMessage] = []
+        for message in messages:
+            text = message.get("text", "")
+            timestamp = message.get("date", "")
+            from_name = message.get("from", "")
+
+            results.append(
+                HumanMessage(
+                    content=text,
+                    additional_kwargs={
+                        "sender": from_name,
+                        "events": [{"message_time": timestamp}],
+                    },
+                )
+            )
+
+        return ChatSession(messages=results)
+
+    def _iterate_files(self, path: str) -> Iterator[str]:
+        """Iterate over files in a directory or zip file.
+
+        Args:
+            path (str): Path to the directory or zip file.
+
+        Yields:
+            str: Path to each file.
+        """
+        if os.path.isfile(path) and path.endswith((".html", ".json")):
+            yield path
+        elif os.path.isdir(path):
+            for root, _, files in os.walk(path):
+                for file in files:
+                    if file.endswith((".html", ".json")):
+                        yield os.path.join(root, file)
+        elif zipfile.is_zipfile(path):
+            with zipfile.ZipFile(path) as zip_file:
+                for file in zip_file.namelist():
+                    if file.endswith((".html", ".json")):
+                        with tempfile.TemporaryDirectory() as temp_dir:
+                            yield zip_file.extract(file, path=temp_dir)
+
+    def lazy_load(self) -> Iterator[ChatSession]:
+        """Lazy load the messages from the chat file and yield them
+        in as chat sessions.
+
+        Yields:
+            ChatSession: The loaded chat session.
+        """
+        for file_path in self._iterate_files(self.path):
+            if file_path.endswith(".html"):
+                yield self._load_single_chat_session_html(file_path)
+            elif file_path.endswith(".json"):
+                yield self._load_single_chat_session_json(file_path)
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/utils.py b/llm/Lib/site-packages/langchain_community/chat_loaders/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..3fe9384e3d282afff1cb8f8114c4c3a4c7745fc3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_loaders/utils.py
@@ -0,0 +1,95 @@
+"""Utilities for chat loaders."""
+from copy import deepcopy
+from typing import Iterable, Iterator, List
+
+from langchain_core.chat_sessions import ChatSession
+from langchain_core.messages import AIMessage, BaseMessage
+
+
+def merge_chat_runs_in_session(
+    chat_session: ChatSession, delimiter: str = "\n\n"
+) -> ChatSession:
+    """Merge chat runs together in a chat session.
+
+    A chat run is a sequence of messages from the same sender.
+
+    Args:
+        chat_session: A chat session.
+
+    Returns:
+        A chat session with merged chat runs.
+    """
+    messages: List[BaseMessage] = []
+    for message in chat_session["messages"]:
+        if not isinstance(message.content, str):
+            raise ValueError(
+                "Chat Loaders only support messages with content type string, "
+                f"got {message.content}"
+            )
+        if not messages:
+            messages.append(deepcopy(message))
+        elif (
+            isinstance(message, type(messages[-1]))
+            and messages[-1].additional_kwargs.get("sender") is not None
+            and messages[-1].additional_kwargs["sender"]
+            == message.additional_kwargs.get("sender")
+        ):
+            if not isinstance(messages[-1].content, str):
+                raise ValueError(
+                    "Chat Loaders only support messages with content type string, "
+                    f"got {messages[-1].content}"
+                )
+            messages[-1].content = (
+                messages[-1].content + delimiter + message.content
+            ).strip()
+            messages[-1].additional_kwargs.get("events", []).extend(
+                message.additional_kwargs.get("events") or []
+            )
+        else:
+            messages.append(deepcopy(message))
+    return ChatSession(messages=messages)
+
+
+def merge_chat_runs(chat_sessions: Iterable[ChatSession]) -> Iterator[ChatSession]:
+    """Merge chat runs together.
+
+    A chat run is a sequence of messages from the same sender.
+
+    Args:
+        chat_sessions: A list of chat sessions.
+
+    Returns:
+        A list of chat sessions with merged chat runs.
+    """
+    for chat_session in chat_sessions:
+        yield merge_chat_runs_in_session(chat_session)
+
+
+def map_ai_messages_in_session(chat_sessions: ChatSession, sender: str) -> ChatSession:
+    """Convert messages from the specified 'sender' to AI messages.
+
+    This is useful for fine-tuning the AI to adapt to your voice.
+    """
+    messages = []
+    num_converted = 0
+    for message in chat_sessions["messages"]:
+        if message.additional_kwargs.get("sender") == sender:
+            message = AIMessage(
+                content=message.content,
+                additional_kwargs=message.additional_kwargs.copy(),
+                example=getattr(message, "example", None),
+            )
+            num_converted += 1
+        messages.append(message)
+    return ChatSession(messages=messages)
+
+
+def map_ai_messages(
+    chat_sessions: Iterable[ChatSession], sender: str
+) -> Iterator[ChatSession]:
+    """Convert messages from the specified 'sender' to AI messages.
+
+    This is useful for fine-tuning the AI to adapt to your voice.
+    """
+    for chat_session in chat_sessions:
+        yield map_ai_messages_in_session(chat_session, sender)
diff --git a/llm/Lib/site-packages/langchain_community/chat_loaders/whatsapp.py b/llm/Lib/site-packages/langchain_community/chat_loaders/whatsapp.py
new file mode 100644
index 0000000000000000000000000000000000000000..25c155c1aeee42cfe607edcd4233d5ec1730e471
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_loaders/whatsapp.py
@@ -0,0 +1,119 @@
+import logging
+import os
+import re
+import zipfile
+from typing import Iterator, List, Union
+
+from langchain_core.chat_sessions import ChatSession
+from langchain_core.messages import AIMessage, HumanMessage
+
+from langchain_community.chat_loaders.base import BaseChatLoader
+
+logger = logging.getLogger(__name__)
+
+
+class WhatsAppChatLoader(BaseChatLoader):
+    """Load `WhatsApp` conversations from a dump zip file or directory."""
+
+    def __init__(self, path: str):
+        """Initialize the WhatsAppChatLoader.
+
+        Args:
+            path (str): Path to the exported WhatsApp chat
+                zip directory, folder, or file.
+
+        To generate the dump, open the chat, click the three dots in the top
+        right corner, and select "More". Then select "Export chat" and
+        choose "Without media".
+        """
+        self.path = path
+        ignore_lines = [
+            "This message was deleted",
+            "<Media omitted>",
+            "image omitted",
+            "Messages and calls are end-to-end encrypted. No one outside of this chat,"
+            " not even WhatsApp, can read or listen to them.",
+        ]
+        self._ignore_lines = re.compile(
+            r"(" + "|".join([r"\u200E*" + line for line in ignore_lines]) + r")",
+            flags=re.IGNORECASE,
+        )
+        self._message_line_regex = re.compile(
+            r"\u200E*\[?(\d{1,2}/\d{1,2}/\d{2,4}, \d{1,2}:\d{2}:\d{2} (?:AM|PM))\]?[ \u200E]*([^:]+): (.+)",  # noqa
+            flags=re.IGNORECASE,
+        )
+
+    def _load_single_chat_session(self, file_path: str) -> ChatSession:
+        """Load a single chat session from a file.
+
+        Args:
+            file_path (str): Path to the chat file.
+
+        Returns:
+            ChatSession: The loaded chat session.
+        """
+        with open(file_path, "r", encoding="utf-8") as file:
+            txt = file.read()
+
+        # Split messages by newlines, but keep multi-line messages grouped
+        chat_lines: List[str] = []
+        current_message = ""
+        for line in txt.split("\n"):
+            if self._message_line_regex.match(line):
+                if current_message:
+                    chat_lines.append(current_message)
+                current_message = line
+            else:
+                current_message += " " + line.strip()
+        if current_message:
+            chat_lines.append(current_message)
+        results: List[Union[HumanMessage, AIMessage]] = []
+        for line in chat_lines:
+            result = self._message_line_regex.match(line.strip())
+            if result:
+                timestamp, sender, text = result.groups()
+                if not self._ignore_lines.match(text.strip()):
+                    results.append(
+                        HumanMessage(
+                            role=sender,
+                            content=text,
+                            additional_kwargs={
+                                "sender": sender,
+                                "events": [{"message_time": timestamp}],
+                            },
+                        )
+                    )
+            else:
+                logger.debug(f"Could not parse line: {line}")
+        return ChatSession(messages=results)
+
+    def _iterate_files(self, path: str) -> Iterator[str]:
+        """Iterate over the files in a directory or zip file.
+
+        Args:
+            path (str): Path to the directory or zip file.
+
+        Yields:
+            str: The path to each file.
+        """
+        if os.path.isfile(path):
+            yield path
+        elif os.path.isdir(path):
+            for root, _, files in os.walk(path):
+                for file in files:
+                    if file.endswith(".txt"):
+                        yield os.path.join(root, file)
+        elif zipfile.is_zipfile(path):
+            with zipfile.ZipFile(path) as zip_file:
+                for file in zip_file.namelist():
+                    if file.endswith(".txt"):
+                        yield zip_file.extract(file)
+
+    def lazy_load(self) -> Iterator[ChatSession]:
+        """Lazy load the messages from the chat file and yield
+        them as chat sessions.
+
+        Yields:
+            Iterator[ChatSession]: The loaded chat sessions.
+        """
+        yield self._load_single_chat_session(self.path)
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__init__.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1266225f26f3ca50c026f4860d7dc8f5724e2650
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/__init__.py
@@ -0,0 +1,142 @@
+"""**Chat message history** stores a history of the message interactions in a chat.
+
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseChatMessageHistory --> <name>ChatMessageHistory  # Examples: FileChatMessageHistory, PostgresChatMessageHistory
+
+**Main helpers:**
+
+.. code-block::
+
+    AIMessage, HumanMessage, BaseMessage
+
+"""  # noqa: E501
+
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.chat_message_histories.astradb import (
+        AstraDBChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.cassandra import (
+        CassandraChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.cosmos_db import (
+        CosmosDBChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.dynamodb import (
+        DynamoDBChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.elasticsearch import (
+        ElasticsearchChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.file import (
+        FileChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.firestore import (
+        FirestoreChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.in_memory import (
+        ChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.momento import (
+        MomentoChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.mongodb import (
+        MongoDBChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.neo4j import (
+        Neo4jChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.postgres import (
+        PostgresChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.redis import (
+        RedisChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.rocksetdb import (
+        RocksetChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.singlestoredb import (
+        SingleStoreDBChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.sql import (
+        SQLChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.streamlit import (
+        StreamlitChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.tidb import (
+        TiDBChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.upstash_redis import (
+        UpstashRedisChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.xata import (
+        XataChatMessageHistory,  # noqa: F401
+    )
+    from langchain_community.chat_message_histories.zep import (
+        ZepChatMessageHistory,  # noqa: F401
+    )
+
+__all__ = [
+    "AstraDBChatMessageHistory",
+    "CassandraChatMessageHistory",
+    "ChatMessageHistory",
+    "CosmosDBChatMessageHistory",
+    "DynamoDBChatMessageHistory",
+    "ElasticsearchChatMessageHistory",
+    "FileChatMessageHistory",
+    "FirestoreChatMessageHistory",
+    "MomentoChatMessageHistory",
+    "MongoDBChatMessageHistory",
+    "Neo4jChatMessageHistory",
+    "PostgresChatMessageHistory",
+    "RedisChatMessageHistory",
+    "RocksetChatMessageHistory",
+    "SQLChatMessageHistory",
+    "SingleStoreDBChatMessageHistory",
+    "StreamlitChatMessageHistory",
+    "TiDBChatMessageHistory",
+    "UpstashRedisChatMessageHistory",
+    "XataChatMessageHistory",
+    "ZepChatMessageHistory",
+]
+
+_module_lookup = {
+    "AstraDBChatMessageHistory": "langchain_community.chat_message_histories.astradb",
+    "CassandraChatMessageHistory": "langchain_community.chat_message_histories.cassandra",  # noqa: E501
+    "ChatMessageHistory": "langchain_community.chat_message_histories.in_memory",
+    "CosmosDBChatMessageHistory": "langchain_community.chat_message_histories.cosmos_db",  # noqa: E501
+    "DynamoDBChatMessageHistory": "langchain_community.chat_message_histories.dynamodb",
+    "ElasticsearchChatMessageHistory": "langchain_community.chat_message_histories.elasticsearch",  # noqa: E501
+    "FileChatMessageHistory": "langchain_community.chat_message_histories.file",
+    "FirestoreChatMessageHistory": "langchain_community.chat_message_histories.firestore",  # noqa: E501
+    "MomentoChatMessageHistory": "langchain_community.chat_message_histories.momento",
+    "MongoDBChatMessageHistory": "langchain_community.chat_message_histories.mongodb",
+    "Neo4jChatMessageHistory": "langchain_community.chat_message_histories.neo4j",
+    "PostgresChatMessageHistory": "langchain_community.chat_message_histories.postgres",
+    "RedisChatMessageHistory": "langchain_community.chat_message_histories.redis",
+    "RocksetChatMessageHistory": "langchain_community.chat_message_histories.rocksetdb",
+    "SQLChatMessageHistory": "langchain_community.chat_message_histories.sql",
+    "SingleStoreDBChatMessageHistory": "langchain_community.chat_message_histories.singlestoredb",  # noqa: E501
+    "StreamlitChatMessageHistory": "langchain_community.chat_message_histories.streamlit",  # noqa: E501
+    "TiDBChatMessageHistory": "langchain_community.chat_message_histories.tidb",
+    "UpstashRedisChatMessageHistory": "langchain_community.chat_message_histories.upstash_redis",  # noqa: E501
+    "XataChatMessageHistory": "langchain_community.chat_message_histories.xata",
+    "ZepChatMessageHistory": "langchain_community.chat_message_histories.zep",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b0aa873c12c2cc8d7c3097afe912293699ce297d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/astradb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/astradb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e211ae18183a167cb2cf09a5c5c4cf44420b36f8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/astradb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/cassandra.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/cassandra.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8543efcd8ec3eb5fb495000991e5f458e8b7d723
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/cassandra.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/cosmos_db.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/cosmos_db.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..38374a31d1b97723416c6c0f54c1a053b4c100aa
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/cosmos_db.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/dynamodb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/dynamodb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7043c1156d2cdbf9ddf562e8cacdc323a1de0d0c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/dynamodb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/elasticsearch.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/elasticsearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dcb115d87f0c2fd3b1f06e8bb0b05d70fa55be54
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/elasticsearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/file.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/file.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ae034d9d0d461341d1a46a395312abdd0bac7ac3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/file.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/firestore.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/firestore.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4f9b597b766e74d1ed7cc804acbb0291bd23de3b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/firestore.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/in_memory.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/in_memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6f711f37175887a0effa77a23b27f3d44556e7be
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/in_memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/momento.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/momento.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fff03e720be0e1a48c3b1f06feba74006b148ef2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/momento.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/mongodb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/mongodb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9301b0195e0f1e84fea39454d14f6e50e0332322
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/mongodb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/neo4j.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/neo4j.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9272fac63d39dde9ad9cd5d329b92e5aab6fe4ea
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/neo4j.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/postgres.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/postgres.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f0f655e7e0d271ef0aa4473bc44ac3ced09e4ccb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/postgres.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/redis.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/redis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f9ae3559aab0f2c3885d3e3d4d5d54b79e0994f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/redis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/rocksetdb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/rocksetdb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3439fcfc86975223188c4ae40c34f2002c8e0bb1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/rocksetdb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/singlestoredb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/singlestoredb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1d80fb59d713ba7b9eff1ef2e2cf56c64bea7849
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/singlestoredb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/sql.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/sql.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..38f4e49b455f389b151c92887b48cf4042a4c913
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/sql.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/streamlit.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/streamlit.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..25a0b6f549d01f4b4cf633155de92170ad4f84e5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/streamlit.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/tidb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/tidb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..375f7ae4ba11d0f2afa5be6475dc55d4980922c9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/tidb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/upstash_redis.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/upstash_redis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4ca695eb17e0284eb3b5cd7ea597c1338375ee12
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/upstash_redis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/xata.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/xata.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dc57194df368dab6c7f89b2e37e088af0d898e5b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/xata.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/zep.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/zep.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cc6269ef4cee6ab1fa2ac9b0879e75fa06b1ee67
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_message_histories/__pycache__/zep.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/astradb.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/astradb.py
new file mode 100644
index 0000000000000000000000000000000000000000..0ef040fcee9b7b0da55071d27fecac90a7ca2e2b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/astradb.py
@@ -0,0 +1,161 @@
+"""Astra DB - based chat message history, based on astrapy."""
+from __future__ import annotations
+
+import json
+import time
+from typing import TYPE_CHECKING, List, Optional, Sequence
+
+from langchain_community.utilities.astradb import (
+    SetupMode,
+    _AstraDBCollectionEnvironment,
+)
+
+if TYPE_CHECKING:
+    from astrapy.db import AstraDB, AsyncAstraDB
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    message_to_dict,
+    messages_from_dict,
+)
+
+DEFAULT_COLLECTION_NAME = "langchain_message_store"
+
+
+@deprecated(
+    since="0.0.25",
+    removal="0.2.0",
+    alternative_import="langchain_astradb.AstraDBChatMessageHistory",
+)
+class AstraDBChatMessageHistory(BaseChatMessageHistory):
+    def __init__(
+        self,
+        *,
+        session_id: str,
+        collection_name: str = DEFAULT_COLLECTION_NAME,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        astra_db_client: Optional[AstraDB] = None,
+        async_astra_db_client: Optional[AsyncAstraDB] = None,
+        namespace: Optional[str] = None,
+        setup_mode: SetupMode = SetupMode.SYNC,
+        pre_delete_collection: bool = False,
+    ) -> None:
+        """Chat message history that stores history in Astra DB.
+
+        Args:
+            session_id: arbitrary key that is used to store the messages
+                of a single chat session.
+            collection_name: name of the Astra DB collection to create/use.
+            token: API token for Astra DB usage.
+            api_endpoint: full URL to the API endpoint,
+                such as "https://<DB-ID>-us-east1.apps.astra.datastax.com".
+            astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AstraDB' instance.
+            async_astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AsyncAstraDB' instance.
+            namespace: namespace (aka keyspace) where the
+                collection is created. Defaults to the database's "default namespace".
+            setup_mode: mode used to create the Astra DB collection (SYNC, ASYNC or
+                OFF).
+            pre_delete_collection: whether to delete the collection
+                before creating it. If False and the collection already exists,
+                the collection will be used as is.
+        """
+        self.astra_env = _AstraDBCollectionEnvironment(
+            collection_name=collection_name,
+            token=token,
+            api_endpoint=api_endpoint,
+            astra_db_client=astra_db_client,
+            async_astra_db_client=async_astra_db_client,
+            namespace=namespace,
+            setup_mode=setup_mode,
+            pre_delete_collection=pre_delete_collection,
+        )
+
+        self.collection = self.astra_env.collection
+        self.async_collection = self.astra_env.async_collection
+
+        self.session_id = session_id
+        self.collection_name = collection_name
+
+    @property
+    def messages(self) -> List[BaseMessage]:
+        """Retrieve all session messages from DB"""
+        self.astra_env.ensure_db_setup()
+        message_blobs = [
+            doc["body_blob"]
+            for doc in sorted(
+                self.collection.paginated_find(
+                    filter={
+                        "session_id": self.session_id,
+                    },
+                    projection={
+                        "timestamp": 1,
+                        "body_blob": 1,
+                    },
+                ),
+                key=lambda _doc: _doc["timestamp"],
+            )
+        ]
+        items = [json.loads(message_blob) for message_blob in message_blobs]
+        messages = messages_from_dict(items)
+        return messages
+
+    @messages.setter
+    def messages(self, messages: List[BaseMessage]) -> None:
+        raise NotImplementedError("Use add_messages instead")
+
+    async def aget_messages(self) -> List[BaseMessage]:
+        await self.astra_env.aensure_db_setup()
+        docs = self.async_collection.paginated_find(
+            filter={
+                "session_id": self.session_id,
+            },
+            projection={
+                "timestamp": 1,
+                "body_blob": 1,
+            },
+        )
+        sorted_docs = sorted(
+            [doc async for doc in docs],
+            key=lambda _doc: _doc["timestamp"],
+        )
+        message_blobs = [doc["body_blob"] for doc in sorted_docs]
+        items = [json.loads(message_blob) for message_blob in message_blobs]
+        messages = messages_from_dict(items)
+        return messages
+
+    def add_messages(self, messages: Sequence[BaseMessage]) -> None:
+        self.astra_env.ensure_db_setup()
+        docs = [
+            {
+                "timestamp": time.time(),
+                "session_id": self.session_id,
+                "body_blob": json.dumps(message_to_dict(message)),
+            }
+            for message in messages
+        ]
+        self.collection.chunked_insert_many(docs)
+
+    async def aadd_messages(self, messages: Sequence[BaseMessage]) -> None:
+        await self.astra_env.aensure_db_setup()
+        docs = [
+            {
+                "timestamp": time.time(),
+                "session_id": self.session_id,
+                "body_blob": json.dumps(message_to_dict(message)),
+            }
+            for message in messages
+        ]
+        await self.async_collection.chunked_insert_many(docs)
+
+    def clear(self) -> None:
+        self.astra_env.ensure_db_setup()
+        self.collection.delete_many(filter={"session_id": self.session_id})
+
+    async def aclear(self) -> None:
+        await self.astra_env.aensure_db_setup()
+        await self.async_collection.delete_many(filter={"session_id": self.session_id})
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/cassandra.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/cassandra.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc3e0794652b3daefb723629cbb6f23eca8e890a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/cassandra.py
@@ -0,0 +1,72 @@
+"""Cassandra-based chat message history, based on cassIO."""
+from __future__ import annotations
+
+import json
+import typing
+from typing import List
+
+if typing.TYPE_CHECKING:
+    from cassandra.cluster import Session
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    message_to_dict,
+    messages_from_dict,
+)
+
+DEFAULT_TABLE_NAME = "message_store"
+DEFAULT_TTL_SECONDS = None
+
+
+class CassandraChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history that stores history in Cassandra.
+
+    Args:
+        session_id: arbitrary key that is used to store the messages
+            of a single chat session.
+        session: a Cassandra `Session` object (an open DB connection)
+        keyspace: name of the keyspace to use.
+        table_name: name of the table to use.
+        ttl_seconds: time-to-live (seconds) for automatic expiration
+            of stored entries. None (default) for no expiration.
+    """
+
+    def __init__(
+        self,
+        session_id: str,
+        session: Session,
+        keyspace: str,
+        table_name: str = DEFAULT_TABLE_NAME,
+        ttl_seconds: typing.Optional[int] = DEFAULT_TTL_SECONDS,
+    ) -> None:
+        try:
+            from cassio.history import StoredBlobHistory
+        except (ImportError, ModuleNotFoundError):
+            raise ImportError(
+                "Could not import cassio python package. "
+                "Please install it with `pip install cassio`."
+            )
+        self.session_id = session_id
+        self.ttl_seconds = ttl_seconds
+        self.blob_history = StoredBlobHistory(session, keyspace, table_name)
+
+    @property
+    def messages(self) -> List[BaseMessage]:  # type: ignore
+        """Retrieve all session messages from DB"""
+        message_blobs = self.blob_history.retrieve(
+            self.session_id,
+        )
+        items = [json.loads(message_blob) for message_blob in message_blobs]
+        messages = messages_from_dict(items)
+        return messages
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Write a message to the table"""
+        self.blob_history.store(
+            self.session_id, json.dumps(message_to_dict(message)), self.ttl_seconds
+        )
+
+    def clear(self) -> None:
+        """Clear session memory from DB"""
+        self.blob_history.clear_session_id(self.session_id)
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/cosmos_db.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/cosmos_db.py
new file mode 100644
index 0000000000000000000000000000000000000000..4210d7a707623bedcdaa9a837501acbeba59606c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/cosmos_db.py
@@ -0,0 +1,172 @@
+"""Azure CosmosDB Memory History."""
+from __future__ import annotations
+
+import logging
+from types import TracebackType
+from typing import TYPE_CHECKING, Any, List, Optional, Type
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    messages_from_dict,
+    messages_to_dict,
+)
+
+logger = logging.getLogger(__name__)
+
+if TYPE_CHECKING:
+    from azure.cosmos import ContainerProxy
+
+
+class CosmosDBChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history backed by Azure CosmosDB."""
+
+    def __init__(
+        self,
+        cosmos_endpoint: str,
+        cosmos_database: str,
+        cosmos_container: str,
+        session_id: str,
+        user_id: str,
+        credential: Any = None,
+        connection_string: Optional[str] = None,
+        ttl: Optional[int] = None,
+        cosmos_client_kwargs: Optional[dict] = None,
+    ):
+        """
+        Initializes a new instance of the CosmosDBChatMessageHistory class.
+
+        Make sure to call prepare_cosmos or use the context manager to make
+        sure your database is ready.
+
+        Either a credential or a connection string must be provided.
+
+        :param cosmos_endpoint: The connection endpoint for the Azure Cosmos DB account.
+        :param cosmos_database: The name of the database to use.
+        :param cosmos_container: The name of the container to use.
+        :param session_id: The session ID to use, can be overwritten while loading.
+        :param user_id: The user ID to use, can be overwritten while loading.
+        :param credential: The credential to use to authenticate to Azure Cosmos DB.
+        :param connection_string: The connection string to use to authenticate.
+        :param ttl: The time to live (in seconds) to use for documents in the container.
+        :param cosmos_client_kwargs: Additional kwargs to pass to the CosmosClient.
+        """
+        self.cosmos_endpoint = cosmos_endpoint
+        self.cosmos_database = cosmos_database
+        self.cosmos_container = cosmos_container
+        self.credential = credential
+        self.conn_string = connection_string
+        self.session_id = session_id
+        self.user_id = user_id
+        self.ttl = ttl
+
+        self.messages: List[BaseMessage] = []
+        try:
+            from azure.cosmos import (  # pylint: disable=import-outside-toplevel # noqa: E501
+                CosmosClient,
+            )
+        except ImportError as exc:
+            raise ImportError(
+                "You must install the azure-cosmos package to use the CosmosDBChatMessageHistory."  # noqa: E501
+                "Please install it with `pip install azure-cosmos`."
+            ) from exc
+        if self.credential:
+            self._client = CosmosClient(
+                url=self.cosmos_endpoint,
+                credential=self.credential,
+                **cosmos_client_kwargs or {},
+            )
+        elif self.conn_string:
+            self._client = CosmosClient.from_connection_string(
+                conn_str=self.conn_string,
+                **cosmos_client_kwargs or {},
+            )
+        else:
+            raise ValueError("Either a connection string or a credential must be set.")
+        self._container: Optional[ContainerProxy] = None
+
+    def prepare_cosmos(self) -> None:
+        """Prepare the CosmosDB client.
+
+        Use this function or the context manager to make sure your database is ready.
+        """
+        try:
+            from azure.cosmos import (  # pylint: disable=import-outside-toplevel # noqa: E501
+                PartitionKey,
+            )
+        except ImportError as exc:
+            raise ImportError(
+                "You must install the azure-cosmos package to use the CosmosDBChatMessageHistory."  # noqa: E501
+                "Please install it with `pip install azure-cosmos`."
+            ) from exc
+        database = self._client.create_database_if_not_exists(self.cosmos_database)
+        self._container = database.create_container_if_not_exists(
+            self.cosmos_container,
+            partition_key=PartitionKey("/user_id"),
+            default_ttl=self.ttl,
+        )
+        self.load_messages()
+
+    def __enter__(self) -> "CosmosDBChatMessageHistory":
+        """Context manager entry point."""
+        self._client.__enter__()
+        self.prepare_cosmos()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        traceback: Optional[TracebackType],
+    ) -> None:
+        """Context manager exit"""
+        self.upsert_messages()
+        self._client.__exit__(exc_type, exc_val, traceback)
+
+    def load_messages(self) -> None:
+        """Retrieve the messages from Cosmos"""
+        if not self._container:
+            raise ValueError("Container not initialized")
+        try:
+            from azure.cosmos.exceptions import (  # pylint: disable=import-outside-toplevel # noqa: E501
+                CosmosHttpResponseError,
+            )
+        except ImportError as exc:
+            raise ImportError(
+                "You must install the azure-cosmos package to use the CosmosDBChatMessageHistory."  # noqa: E501
+                "Please install it with `pip install azure-cosmos`."
+            ) from exc
+        try:
+            item = self._container.read_item(
+                item=self.session_id, partition_key=self.user_id
+            )
+        except CosmosHttpResponseError:
+            logger.info("no session found")
+            return
+        if "messages" in item and len(item["messages"]) > 0:
+            self.messages = messages_from_dict(item["messages"])
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Add a self-created message to the store"""
+        self.messages.append(message)
+        self.upsert_messages()
+
+    def upsert_messages(self) -> None:
+        """Update the cosmosdb item."""
+        if not self._container:
+            raise ValueError("Container not initialized")
+        self._container.upsert_item(
+            body={
+                "id": self.session_id,
+                "user_id": self.user_id,
+                "messages": messages_to_dict(self.messages),
+            }
+        )
+
+    def clear(self) -> None:
+        """Clear session memory from this memory and cosmos."""
+        self.messages = []
+        if self._container:
+            self._container.delete_item(
+                item=self.session_id, partition_key=self.user_id
+            )
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/dynamodb.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/dynamodb.py
new file mode 100644
index 0000000000000000000000000000000000000000..630781310e99ade72553bc71d50c9a036cbf1719
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/dynamodb.py
@@ -0,0 +1,184 @@
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Dict, List, Optional
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    message_to_dict,
+    messages_from_dict,
+    messages_to_dict,
+)
+
+if TYPE_CHECKING:
+    from boto3.session import Session
+
+logger = logging.getLogger(__name__)
+
+
+class DynamoDBChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history that stores history in AWS DynamoDB.
+
+    This class expects that a DynamoDB table exists with name `table_name`
+
+    Args:
+        table_name: name of the DynamoDB table
+        session_id: arbitrary key that is used to store the messages
+            of a single chat session.
+        endpoint_url: URL of the AWS endpoint to connect to. This argument
+            is optional and useful for test purposes, like using Localstack.
+            If you plan to use AWS cloud service, you normally don't have to
+            worry about setting the endpoint_url.
+        primary_key_name: name of the primary key of the DynamoDB table. This argument
+            is optional, defaulting to "SessionId".
+        key: an optional dictionary with a custom primary and secondary key.
+            This argument is optional, but useful when using composite dynamodb keys, or
+            isolating records based off of application details such as a user id.
+            This may also contain global and local secondary index keys.
+        kms_key_id: an optional AWS KMS Key ID, AWS KMS Key ARN, or AWS KMS Alias for
+            client-side encryption
+        ttl: Optional Time-to-live (TTL) in seconds. Allows you to define a per-item
+            expiration timestamp that indicates when an item can be deleted from the
+            table. DynamoDB handles deletion of expired items without consuming
+            write throughput. To enable this feature on the table, follow the
+            [AWS DynamoDB documentation](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/time-to-live-ttl-how-to.html)
+        history_size: Maximum number of messages to store. If None then there is no
+            limit. If not None then only the latest `history_size` messages are stored.
+    """
+
+    def __init__(
+        self,
+        table_name: str,
+        session_id: str,
+        endpoint_url: Optional[str] = None,
+        primary_key_name: str = "SessionId",
+        key: Optional[Dict[str, str]] = None,
+        boto3_session: Optional[Session] = None,
+        kms_key_id: Optional[str] = None,
+        ttl: Optional[int] = None,
+        ttl_key_name: str = "expireAt",
+        history_size: Optional[int] = None,
+    ):
+        if boto3_session:
+            client = boto3_session.resource("dynamodb", endpoint_url=endpoint_url)
+        else:
+            try:
+                import boto3
+            except ImportError as e:
+                raise ImportError(
+                    "Unable to import boto3, please install with `pip install boto3`."
+                ) from e
+            if endpoint_url:
+                client = boto3.resource("dynamodb", endpoint_url=endpoint_url)
+            else:
+                client = boto3.resource("dynamodb")
+        self.table = client.Table(table_name)
+        self.session_id = session_id
+        self.key: Dict = key or {primary_key_name: session_id}
+        self.ttl = ttl
+        self.ttl_key_name = ttl_key_name
+        self.history_size = history_size
+
+        if kms_key_id:
+            try:
+                from dynamodb_encryption_sdk.encrypted.table import EncryptedTable
+                from dynamodb_encryption_sdk.identifiers import CryptoAction
+                from dynamodb_encryption_sdk.material_providers.aws_kms import (
+                    AwsKmsCryptographicMaterialsProvider,
+                )
+                from dynamodb_encryption_sdk.structures import AttributeActions
+            except ImportError as e:
+                raise ImportError(
+                    "Unable to import dynamodb_encryption_sdk, please install with "
+                    "`pip install dynamodb-encryption-sdk`."
+                ) from e
+
+            actions = AttributeActions(
+                default_action=CryptoAction.DO_NOTHING,
+                attribute_actions={"History": CryptoAction.ENCRYPT_AND_SIGN},
+            )
+            aws_kms_cmp = AwsKmsCryptographicMaterialsProvider(key_id=kms_key_id)
+            self.table = EncryptedTable(
+                table=self.table,
+                materials_provider=aws_kms_cmp,
+                attribute_actions=actions,
+                auto_refresh_table_indexes=False,
+            )
+
+    @property
+    def messages(self) -> List[BaseMessage]:
+        """Retrieve the messages from DynamoDB"""
+        try:
+            from botocore.exceptions import ClientError
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import botocore, please install with `pip install botocore`."
+            ) from e
+
+        response = None
+        try:
+            response = self.table.get_item(Key=self.key)
+        except ClientError as error:
+            if error.response["Error"]["Code"] == "ResourceNotFoundException":
+                logger.warning("No record found with session id: %s", self.session_id)
+            else:
+                logger.error(error)
+
+        if response and "Item" in response:
+            items = response["Item"]["History"]
+        else:
+            items = []
+
+        messages = messages_from_dict(items)
+        return messages
+
+    @messages.setter
+    def messages(self, messages: List[BaseMessage]) -> None:
+        raise NotImplementedError(
+            "Direct assignment to 'messages' is not allowed."
+            " Use the 'add_messages' instead."
+        )
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Append the message to the record in DynamoDB"""
+        try:
+            from botocore.exceptions import ClientError
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import botocore, please install with `pip install botocore`."
+            ) from e
+
+        messages = messages_to_dict(self.messages)
+        _message = message_to_dict(message)
+        messages.append(_message)
+
+        if self.history_size:
+            messages = messages[-self.history_size :]
+
+        try:
+            if self.ttl:
+                import time
+
+                expireAt = int(time.time()) + self.ttl
+                self.table.put_item(
+                    Item={**self.key, "History": messages, self.ttl_key_name: expireAt}
+                )
+            else:
+                self.table.put_item(Item={**self.key, "History": messages})
+        except ClientError as err:
+            logger.error(err)
+
+    def clear(self) -> None:
+        """Clear session memory from DynamoDB"""
+        try:
+            from botocore.exceptions import ClientError
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import botocore, please install with `pip install botocore`."
+            ) from e
+
+        try:
+            self.table.delete_item(Key=self.key)
+        except ClientError as err:
+            logger.error(err)
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/elasticsearch.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/elasticsearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..464e9e1273f5d9bb1ede5ebc5c7c88d147e2d555
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/elasticsearch.py
@@ -0,0 +1,210 @@
+import json
+import logging
+from time import time
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+from langchain_core._api import deprecated
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    message_to_dict,
+    messages_from_dict,
+)
+
+if TYPE_CHECKING:
+    from elasticsearch import Elasticsearch
+
+logger = logging.getLogger(__name__)
+
+
+@deprecated("0.0.27", alternative="Use langchain-elasticsearch package", pending=True)
+class ElasticsearchChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history that stores history in Elasticsearch.
+
+    Args:
+        es_url: URL of the Elasticsearch instance to connect to.
+        es_cloud_id: Cloud ID of the Elasticsearch instance to connect to.
+        es_user: Username to use when connecting to Elasticsearch.
+        es_password: Password to use when connecting to Elasticsearch.
+        es_api_key: API key to use when connecting to Elasticsearch.
+        es_connection: Optional pre-existing Elasticsearch connection.
+        esnsure_ascii: Used to escape ASCII symbols in json.dumps. Defaults to True.
+        index: Name of the index to use.
+        session_id: Arbitrary key that is used to store the messages
+            of a single chat session.
+    """
+
+    def __init__(
+        self,
+        index: str,
+        session_id: str,
+        *,
+        es_connection: Optional["Elasticsearch"] = None,
+        es_url: Optional[str] = None,
+        es_cloud_id: Optional[str] = None,
+        es_user: Optional[str] = None,
+        es_api_key: Optional[str] = None,
+        es_password: Optional[str] = None,
+        esnsure_ascii: Optional[bool] = True,
+    ):
+        self.index: str = index
+        self.session_id: str = session_id
+        self.ensure_ascii = esnsure_ascii
+
+        # Initialize Elasticsearch client from passed client arg or connection info
+        if es_connection is not None:
+            self.client = es_connection.options(
+                headers={"user-agent": self.get_user_agent()}
+            )
+        elif es_url is not None or es_cloud_id is not None:
+            self.client = ElasticsearchChatMessageHistory.connect_to_elasticsearch(
+                es_url=es_url,
+                username=es_user,
+                password=es_password,
+                cloud_id=es_cloud_id,
+                api_key=es_api_key,
+            )
+        else:
+            raise ValueError(
+                """Either provide a pre-existing Elasticsearch connection, \
+                or valid credentials for creating a new connection."""
+            )
+
+        if self.client.indices.exists(index=index):
+            logger.debug(
+                f"Chat history index {index} already exists, skipping creation."
+            )
+        else:
+            logger.debug(f"Creating index {index} for storing chat history.")
+
+            self.client.indices.create(
+                index=index,
+                mappings={
+                    "properties": {
+                        "session_id": {"type": "keyword"},
+                        "created_at": {"type": "date"},
+                        "history": {"type": "text"},
+                    }
+                },
+            )
+
+    @staticmethod
+    def get_user_agent() -> str:
+        from langchain_community import __version__
+
+        return f"langchain-py-ms/{__version__}"
+
+    @staticmethod
+    def connect_to_elasticsearch(
+        *,
+        es_url: Optional[str] = None,
+        cloud_id: Optional[str] = None,
+        api_key: Optional[str] = None,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+    ) -> "Elasticsearch":
+        try:
+            import elasticsearch
+        except ImportError:
+            raise ImportError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+
+        if es_url and cloud_id:
+            raise ValueError(
+                "Both es_url and cloud_id are defined. Please provide only one."
+            )
+
+        connection_params: Dict[str, Any] = {}
+
+        if es_url:
+            connection_params["hosts"] = [es_url]
+        elif cloud_id:
+            connection_params["cloud_id"] = cloud_id
+        else:
+            raise ValueError("Please provide either elasticsearch_url or cloud_id.")
+
+        if api_key:
+            connection_params["api_key"] = api_key
+        elif username and password:
+            connection_params["basic_auth"] = (username, password)
+
+        es_client = elasticsearch.Elasticsearch(
+            **connection_params,
+            headers={"user-agent": ElasticsearchChatMessageHistory.get_user_agent()},
+        )
+        try:
+            es_client.info()
+        except Exception as err:
+            logger.error(f"Error connecting to Elasticsearch: {err}")
+            raise err
+
+        return es_client
+
+    @property
+    def messages(self) -> List[BaseMessage]:
+        """Retrieve the messages from Elasticsearch"""
+        try:
+            from elasticsearch import ApiError
+
+            result = self.client.search(
+                index=self.index,
+                query={"term": {"session_id": self.session_id}},
+                sort="created_at:asc",
+            )
+        except ApiError as err:
+            logger.error(f"Could not retrieve messages from Elasticsearch: {err}")
+            raise err
+
+        if result and len(result["hits"]["hits"]) > 0:
+            items = [
+                json.loads(document["_source"]["history"])
+                for document in result["hits"]["hits"]
+            ]
+        else:
+            items = []
+
+        return messages_from_dict(items)
+
+    @messages.setter
+    def messages(self, messages: List[BaseMessage]) -> None:
+        raise NotImplementedError(
+            "Direct assignment to 'messages' is not allowed."
+            " Use the 'add_messages' instead."
+        )
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Add a message to the chat session in Elasticsearch"""
+        try:
+            from elasticsearch import ApiError
+
+            self.client.index(
+                index=self.index,
+                document={
+                    "session_id": self.session_id,
+                    "created_at": round(time() * 1000),
+                    "history": json.dumps(
+                        message_to_dict(message),
+                        ensure_ascii=bool(self.ensure_ascii),
+                    ),
+                },
+                refresh=True,
+            )
+        except ApiError as err:
+            logger.error(f"Could not add message to Elasticsearch: {err}")
+            raise err
+
+    def clear(self) -> None:
+        """Clear session memory in Elasticsearch"""
+        try:
+            from elasticsearch import ApiError
+
+            self.client.delete_by_query(
+                index=self.index,
+                query={"term": {"session_id": self.session_id}},
+                refresh=True,
+            )
+        except ApiError as err:
+            logger.error(f"Could not clear session memory in Elasticsearch: {err}")
+            raise err
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/file.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/file.py
new file mode 100644
index 0000000000000000000000000000000000000000..d6f2f43c3d652538f9adcce4e36f4108ca4e7f56
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/file.py
@@ -0,0 +1,45 @@
+import json
+import logging
+from pathlib import Path
+from typing import List
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    messages_from_dict,
+    messages_to_dict,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class FileChatMessageHistory(BaseChatMessageHistory):
+    """
+    Chat message history that stores history in a local file.
+
+    Args:
+        file_path: path of the local file to store the messages.
+    """
+
+    def __init__(self, file_path: str):
+        self.file_path = Path(file_path)
+        if not self.file_path.exists():
+            self.file_path.touch()
+            self.file_path.write_text(json.dumps([]))
+
+    @property
+    def messages(self) -> List[BaseMessage]:  # type: ignore
+        """Retrieve the messages from the local file"""
+        items = json.loads(self.file_path.read_text())
+        messages = messages_from_dict(items)
+        return messages
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Append the message to the record in the local file"""
+        messages = messages_to_dict(self.messages)
+        messages.append(messages_to_dict([message])[0])
+        self.file_path.write_text(json.dumps(messages))
+
+    def clear(self) -> None:
+        """Clear session memory from the local file"""
+        self.file_path.write_text(json.dumps([]))
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/firestore.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/firestore.py
new file mode 100644
index 0000000000000000000000000000000000000000..941bbb72f85c7aa8cb5392ef98dcf08c3948cd12
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/firestore.py
@@ -0,0 +1,105 @@
+"""Firestore Chat Message History."""
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, List, Optional
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    messages_from_dict,
+    messages_to_dict,
+)
+
+logger = logging.getLogger(__name__)
+
+if TYPE_CHECKING:
+    from google.cloud.firestore import Client, DocumentReference
+
+
+def _get_firestore_client() -> Client:
+    try:
+        import firebase_admin
+        from firebase_admin import firestore
+    except ImportError:
+        raise ImportError(
+            "Could not import firebase-admin python package. "
+            "Please install it with `pip install firebase-admin`."
+        )
+
+    # For multiple instances, only initialize the app once.
+    try:
+        firebase_admin.get_app()
+    except ValueError as e:
+        logger.debug("Initializing Firebase app: %s", e)
+        firebase_admin.initialize_app()
+
+    return firestore.client()
+
+
+class FirestoreChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history backed by Google Firestore."""
+
+    def __init__(
+        self,
+        collection_name: str,
+        session_id: str,
+        user_id: str,
+        firestore_client: Optional[Client] = None,
+    ):
+        """
+        Initialize a new instance of the FirestoreChatMessageHistory class.
+
+        :param collection_name: The name of the collection to use.
+        :param session_id: The session ID for the chat..
+        :param user_id: The user ID for the chat.
+        """
+        self.collection_name = collection_name
+        self.session_id = session_id
+        self.user_id = user_id
+        self._document: Optional[DocumentReference] = None
+        self.messages: List[BaseMessage] = []
+        self.firestore_client = firestore_client or _get_firestore_client()
+        self.prepare_firestore()
+
+    def prepare_firestore(self) -> None:
+        """Prepare the Firestore client.
+
+        Use this function to make sure your database is ready.
+        """
+        self._document = self.firestore_client.collection(
+            self.collection_name
+        ).document(self.session_id)
+        self.load_messages()
+
+    def load_messages(self) -> None:
+        """Retrieve the messages from Firestore"""
+        if not self._document:
+            raise ValueError("Document not initialized")
+        doc = self._document.get()
+        if doc.exists:
+            data = doc.to_dict()
+            if "messages" in data and len(data["messages"]) > 0:
+                self.messages = messages_from_dict(data["messages"])
+
+    def add_message(self, message: BaseMessage) -> None:
+        self.messages.append(message)
+        self.upsert_messages()
+
+    def upsert_messages(self, new_message: Optional[BaseMessage] = None) -> None:
+        """Update the Firestore document."""
+        if not self._document:
+            raise ValueError("Document not initialized")
+        self._document.set(
+            {
+                "id": self.session_id,
+                "user_id": self.user_id,
+                "messages": messages_to_dict(self.messages),
+            }
+        )
+
+    def clear(self) -> None:
+        """Clear session memory from this memory and Firestore."""
+        self.messages = []
+        if self._document:
+            self._document.delete()
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/in_memory.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/in_memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe6c6406524c5984000bf4ffed0f7cbf0d61d3a8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/in_memory.py
@@ -0,0 +1,31 @@
+from typing import List, Sequence
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import BaseMessage
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+
+class ChatMessageHistory(BaseChatMessageHistory, BaseModel):
+    """In memory implementation of chat message history.
+
+    Stores messages in an in memory list.
+    """
+
+    messages: List[BaseMessage] = Field(default_factory=list)
+
+    async def aget_messages(self) -> List[BaseMessage]:
+        return self.messages
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Add a self-created message to the store"""
+        self.messages.append(message)
+
+    async def aadd_messages(self, messages: Sequence[BaseMessage]) -> None:
+        """Add messages to the store"""
+        self.add_messages(messages)
+
+    def clear(self) -> None:
+        self.messages = []
+
+    async def aclear(self) -> None:
+        self.clear()
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/momento.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/momento.py
new file mode 100644
index 0000000000000000000000000000000000000000..51073d789e5b636895463d698916f54534bc9159
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/momento.py
@@ -0,0 +1,189 @@
+from __future__ import annotations
+
+import json
+from datetime import timedelta
+from typing import TYPE_CHECKING, Any, Optional
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    message_to_dict,
+    messages_from_dict,
+)
+from langchain_core.utils import get_from_env
+
+if TYPE_CHECKING:
+    import momento
+
+
+def _ensure_cache_exists(cache_client: momento.CacheClient, cache_name: str) -> None:
+    """Create cache if it doesn't exist.
+
+    Raises:
+        SdkException: Momento service or network error
+        Exception: Unexpected response
+    """
+    from momento.responses import CreateCache
+
+    create_cache_response = cache_client.create_cache(cache_name)
+    if isinstance(create_cache_response, CreateCache.Success) or isinstance(
+        create_cache_response, CreateCache.CacheAlreadyExists
+    ):
+        return None
+    elif isinstance(create_cache_response, CreateCache.Error):
+        raise create_cache_response.inner_exception
+    else:
+        raise Exception(f"Unexpected response cache creation: {create_cache_response}")
+
+
+class MomentoChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history cache that uses Momento as a backend.
+
+    See https://gomomento.com/"""
+
+    def __init__(
+        self,
+        session_id: str,
+        cache_client: momento.CacheClient,
+        cache_name: str,
+        *,
+        key_prefix: str = "message_store:",
+        ttl: Optional[timedelta] = None,
+        ensure_cache_exists: bool = True,
+    ):
+        """Instantiate a chat message history cache that uses Momento as a backend.
+
+        Note: to instantiate the cache client passed to MomentoChatMessageHistory,
+        you must have a Momento account at https://gomomento.com/.
+
+        Args:
+            session_id (str): The session ID to use for this chat session.
+            cache_client (CacheClient): The Momento cache client.
+            cache_name (str): The name of the cache to use to store the messages.
+            key_prefix (str, optional): The prefix to apply to the cache key.
+                Defaults to "message_store:".
+            ttl (Optional[timedelta], optional): The TTL to use for the messages.
+                Defaults to None, ie the default TTL of the cache will be used.
+            ensure_cache_exists (bool, optional): Create the cache if it doesn't exist.
+                Defaults to True.
+
+        Raises:
+            ImportError: Momento python package is not installed.
+            TypeError: cache_client is not of type momento.CacheClientObject
+        """
+        try:
+            from momento import CacheClient
+            from momento.requests import CollectionTtl
+        except ImportError:
+            raise ImportError(
+                "Could not import momento python package. "
+                "Please install it with `pip install momento`."
+            )
+        if not isinstance(cache_client, CacheClient):
+            raise TypeError("cache_client must be a momento.CacheClient object.")
+        if ensure_cache_exists:
+            _ensure_cache_exists(cache_client, cache_name)
+        self.key = key_prefix + session_id
+        self.cache_client = cache_client
+        self.cache_name = cache_name
+        if ttl is not None:
+            self.ttl = CollectionTtl.of(ttl)
+        else:
+            self.ttl = CollectionTtl.from_cache_ttl()
+
+    @classmethod
+    def from_client_params(
+        cls,
+        session_id: str,
+        cache_name: str,
+        ttl: timedelta,
+        *,
+        configuration: Optional[momento.config.Configuration] = None,
+        api_key: Optional[str] = None,
+        auth_token: Optional[str] = None,  # for backwards compatibility
+        **kwargs: Any,
+    ) -> MomentoChatMessageHistory:
+        """Construct cache from CacheClient parameters."""
+        try:
+            from momento import CacheClient, Configurations, CredentialProvider
+        except ImportError:
+            raise ImportError(
+                "Could not import momento python package. "
+                "Please install it with `pip install momento`."
+            )
+        if configuration is None:
+            configuration = Configurations.Laptop.v1()
+
+        # Try checking `MOMENTO_AUTH_TOKEN` first for backwards compatibility
+        try:
+            api_key = auth_token or get_from_env("auth_token", "MOMENTO_AUTH_TOKEN")
+        except ValueError:
+            api_key = api_key or get_from_env("api_key", "MOMENTO_API_KEY")
+        credentials = CredentialProvider.from_string(api_key)
+        cache_client = CacheClient(configuration, credentials, default_ttl=ttl)
+        return cls(session_id, cache_client, cache_name, ttl=ttl, **kwargs)
+
+    @property
+    def messages(self) -> list[BaseMessage]:  # type: ignore[override]
+        """Retrieve the messages from Momento.
+
+        Raises:
+            SdkException: Momento service or network error
+            Exception: Unexpected response
+
+        Returns:
+            list[BaseMessage]: List of cached messages
+        """
+        from momento.responses import CacheListFetch
+
+        fetch_response = self.cache_client.list_fetch(self.cache_name, self.key)
+
+        if isinstance(fetch_response, CacheListFetch.Hit):
+            items = [json.loads(m) for m in fetch_response.value_list_string]
+            return messages_from_dict(items)
+        elif isinstance(fetch_response, CacheListFetch.Miss):
+            return []
+        elif isinstance(fetch_response, CacheListFetch.Error):
+            raise fetch_response.inner_exception
+        else:
+            raise Exception(f"Unexpected response: {fetch_response}")
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Store a message in the cache.
+
+        Args:
+            message (BaseMessage): The message object to store.
+
+        Raises:
+            SdkException: Momento service or network error.
+            Exception: Unexpected response.
+        """
+        from momento.responses import CacheListPushBack
+
+        item = json.dumps(message_to_dict(message))
+        push_response = self.cache_client.list_push_back(
+            self.cache_name, self.key, item, ttl=self.ttl
+        )
+        if isinstance(push_response, CacheListPushBack.Success):
+            return None
+        elif isinstance(push_response, CacheListPushBack.Error):
+            raise push_response.inner_exception
+        else:
+            raise Exception(f"Unexpected response: {push_response}")
+
+    def clear(self) -> None:
+        """Remove the session's messages from the cache.
+
+        Raises:
+            SdkException: Momento service or network error.
+            Exception: Unexpected response.
+        """
+        from momento.responses import CacheDelete
+
+        delete_response = self.cache_client.delete(self.cache_name, self.key)
+        if isinstance(delete_response, CacheDelete.Success):
+            return None
+        elif isinstance(delete_response, CacheDelete.Error):
+            raise delete_response.inner_exception
+        else:
+            raise Exception(f"Unexpected response: {delete_response}")
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/mongodb.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/mongodb.py
new file mode 100644
index 0000000000000000000000000000000000000000..f9e1e93db61fa02fe85a3d7943fc7dda0b718e7c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/mongodb.py
@@ -0,0 +1,101 @@
+import json
+import logging
+from typing import List
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    message_to_dict,
+    messages_from_dict,
+)
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_DBNAME = "chat_history"
+DEFAULT_COLLECTION_NAME = "message_store"
+
+
+@deprecated(
+    since="0.0.25",
+    removal="0.2.0",
+    alternative_import="langchain_mongodb.MongoDBChatMessageHistory",
+)
+class MongoDBChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history that stores history in MongoDB.
+
+    Args:
+        connection_string: connection string to connect to MongoDB
+        session_id: arbitrary key that is used to store the messages
+            of a single chat session.
+        database_name: name of the database to use
+        collection_name: name of the collection to use
+        create_index: whether to create an index with name SessionId. Set to False if
+            such an index already exists.
+    """
+
+    def __init__(
+        self,
+        connection_string: str,
+        session_id: str,
+        database_name: str = DEFAULT_DBNAME,
+        collection_name: str = DEFAULT_COLLECTION_NAME,
+        create_index: bool = True,
+    ):
+        from pymongo import MongoClient, errors
+
+        self.connection_string = connection_string
+        self.session_id = session_id
+        self.database_name = database_name
+        self.collection_name = collection_name
+
+        try:
+            self.client: MongoClient = MongoClient(connection_string)
+        except errors.ConnectionFailure as error:
+            logger.error(error)
+
+        self.db = self.client[database_name]
+        self.collection = self.db[collection_name]
+        if create_index:
+            self.collection.create_index("SessionId")
+
+    @property
+    def messages(self) -> List[BaseMessage]:  # type: ignore
+        """Retrieve the messages from MongoDB"""
+        from pymongo import errors
+
+        try:
+            cursor = self.collection.find({"SessionId": self.session_id})
+        except errors.OperationFailure as error:
+            logger.error(error)
+
+        if cursor:
+            items = [json.loads(document["History"]) for document in cursor]
+        else:
+            items = []
+
+        messages = messages_from_dict(items)
+        return messages
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Append the message to the record in MongoDB"""
+        from pymongo import errors
+
+        try:
+            self.collection.insert_one(
+                {
+                    "SessionId": self.session_id,
+                    "History": json.dumps(message_to_dict(message)),
+                }
+            )
+        except errors.WriteError as err:
+            logger.error(err)
+
+    def clear(self) -> None:
+        """Clear session memory from MongoDB"""
+        from pymongo import errors
+
+        try:
+            self.collection.delete_many({"SessionId": self.session_id})
+        except errors.WriteError as err:
+            logger.error(err)
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/neo4j.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/neo4j.py
new file mode 100644
index 0000000000000000000000000000000000000000..d64b1e5ed6eeca32acbfe8805b070f3a8d00828b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/neo4j.py
@@ -0,0 +1,112 @@
+from typing import List, Optional, Union
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import BaseMessage, messages_from_dict
+from langchain_core.utils import get_from_env
+
+
+class Neo4jChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history stored in a Neo4j database."""
+
+    def __init__(
+        self,
+        session_id: Union[str, int],
+        url: Optional[str] = None,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        database: str = "neo4j",
+        node_label: str = "Session",
+        window: int = 3,
+    ):
+        try:
+            import neo4j
+        except ImportError:
+            raise ValueError(
+                "Could not import neo4j python package. "
+                "Please install it with `pip install neo4j`."
+            )
+
+        # Make sure session id is not null
+        if not session_id:
+            raise ValueError("Please ensure that the session_id parameter is provided")
+
+        url = get_from_env("url", "NEO4J_URI", url)
+        username = get_from_env("username", "NEO4J_USERNAME", username)
+        password = get_from_env("password", "NEO4J_PASSWORD", password)
+        database = get_from_env("database", "NEO4J_DATABASE", database)
+
+        self._driver = neo4j.GraphDatabase.driver(url, auth=(username, password))
+        self._database = database
+        self._session_id = session_id
+        self._node_label = node_label
+        self._window = window
+
+        # Verify connection
+        try:
+            self._driver.verify_connectivity()
+        except neo4j.exceptions.ServiceUnavailable:
+            raise ValueError(
+                "Could not connect to Neo4j database. "
+                "Please ensure that the url is correct"
+            )
+        except neo4j.exceptions.AuthError:
+            raise ValueError(
+                "Could not connect to Neo4j database. "
+                "Please ensure that the username and password are correct"
+            )
+        # Create session node
+        self._driver.execute_query(
+            f"MERGE (s:`{self._node_label}` {{id:$session_id}})",
+            {"session_id": self._session_id},
+        ).summary
+
+    @property
+    def messages(self) -> List[BaseMessage]:  # type: ignore
+        """Retrieve the messages from Neo4j"""
+        query = (
+            f"MATCH (s:`{self._node_label}`)-[:LAST_MESSAGE]->(last_message) "
+            "WHERE s.id = $session_id MATCH p=(last_message)<-[:NEXT*0.."
+            f"{self._window*2}]-() WITH p, length(p) AS length "
+            "ORDER BY length DESC LIMIT 1 UNWIND reverse(nodes(p)) AS node "
+            "RETURN {data:{content: node.content}, type:node.type} AS result"
+        )
+        records, _, _ = self._driver.execute_query(
+            query, {"session_id": self._session_id}
+        )
+
+        messages = messages_from_dict([el["result"] for el in records])
+        return messages
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Append the message to the record in Neo4j"""
+        query = (
+            f"MATCH (s:`{self._node_label}`) WHERE s.id = $session_id "
+            "OPTIONAL MATCH (s)-[lm:LAST_MESSAGE]->(last_message) "
+            "CREATE (s)-[:LAST_MESSAGE]->(new:Message) "
+            "SET new += {type:$type, content:$content} "
+            "WITH new, lm, last_message WHERE last_message IS NOT NULL "
+            "CREATE (last_message)-[:NEXT]->(new) "
+            "DELETE lm"
+        )
+        self._driver.execute_query(
+            query,
+            {
+                "type": message.type,
+                "content": message.content,
+                "session_id": self._session_id,
+            },
+        ).summary
+
+    def clear(self) -> None:
+        """Clear session memory from Neo4j"""
+        query = (
+            f"MATCH (s:`{self._node_label}`)-[:LAST_MESSAGE]->(last_message) "
+            "WHERE s.id = $session_id MATCH p=(last_message)<-[:NEXT]-() "
+            "WITH p, length(p) AS length ORDER BY length DESC LIMIT 1 "
+            "UNWIND nodes(p) as node DETACH DELETE node;"
+        )
+        self._driver.execute_query(query, {"session_id": self._session_id}).summary
+
+    def __del__(self) -> None:
+        if self._driver:
+            self._driver.close()
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/postgres.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/postgres.py
new file mode 100644
index 0000000000000000000000000000000000000000..d81fa93ec245ecd47d6b77143f89034c4a03f897
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/postgres.py
@@ -0,0 +1,100 @@
+import json
+import logging
+from typing import List
+
+from langchain_core._api import deprecated
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    message_to_dict,
+    messages_from_dict,
+)
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_CONNECTION_STRING = "postgresql://postgres:mypassword@localhost/chat_history"
+
+
+@deprecated(
+    since="0.0.31",
+    message=(
+        "This class is deprecated and will be removed in a future version. "
+        "You can swap to using the `PostgresChatMessageHistory`"
+        " implementation in `langchain_postgres`. "
+        "Please do not submit further PRs to this class."
+        "See https://github.com/langchain-ai/langchain-postgres"
+    ),
+    alternative="from langchain_postgres import PostgresChatMessageHistory;",
+    pending=True,
+)
+class PostgresChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history stored in a Postgres database.
+
+    **DEPRECATED**: This class is deprecated and will be removed in a future version.
+
+    Use the `PostgresChatMessageHistory` implementation in `langchain_postgres`.
+    """
+
+    def __init__(
+        self,
+        session_id: str,
+        connection_string: str = DEFAULT_CONNECTION_STRING,
+        table_name: str = "message_store",
+    ):
+        import psycopg
+        from psycopg.rows import dict_row
+
+        try:
+            self.connection = psycopg.connect(connection_string)
+            self.cursor = self.connection.cursor(row_factory=dict_row)
+        except psycopg.OperationalError as error:
+            logger.error(error)
+
+        self.session_id = session_id
+        self.table_name = table_name
+
+        self._create_table_if_not_exists()
+
+    def _create_table_if_not_exists(self) -> None:
+        create_table_query = f"""CREATE TABLE IF NOT EXISTS {self.table_name} (
+            id SERIAL PRIMARY KEY,
+            session_id TEXT NOT NULL,
+            message JSONB NOT NULL
+        );"""
+        self.cursor.execute(create_table_query)
+        self.connection.commit()
+
+    @property
+    def messages(self) -> List[BaseMessage]:  # type: ignore
+        """Retrieve the messages from PostgreSQL"""
+        query = (
+            f"SELECT message FROM {self.table_name} WHERE session_id = %s ORDER BY id;"
+        )
+        self.cursor.execute(query, (self.session_id,))
+        items = [record["message"] for record in self.cursor.fetchall()]
+        messages = messages_from_dict(items)
+        return messages
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Append the message to the record in PostgreSQL"""
+        from psycopg import sql
+
+        query = sql.SQL("INSERT INTO {} (session_id, message) VALUES (%s, %s);").format(
+            sql.Identifier(self.table_name)
+        )
+        self.cursor.execute(
+            query, (self.session_id, json.dumps(message_to_dict(message)))
+        )
+        self.connection.commit()
+
+    def clear(self) -> None:
+        """Clear session memory from PostgreSQL"""
+        query = f"DELETE FROM {self.table_name} WHERE session_id = %s;"
+        self.cursor.execute(query, (self.session_id,))
+        self.connection.commit()
+
+    def __del__(self) -> None:
+        if self.cursor:
+            self.cursor.close()
+        if self.connection:
+            self.connection.close()
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/redis.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/redis.py
new file mode 100644
index 0000000000000000000000000000000000000000..37226e2ab227e24e2f17799fbc2a256aeb5689fe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/redis.py
@@ -0,0 +1,65 @@
+import json
+import logging
+from typing import List, Optional
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    message_to_dict,
+    messages_from_dict,
+)
+
+from langchain_community.utilities.redis import get_client
+
+logger = logging.getLogger(__name__)
+
+
+class RedisChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history stored in a Redis database."""
+
+    def __init__(
+        self,
+        session_id: str,
+        url: str = "redis://localhost:6379/0",
+        key_prefix: str = "message_store:",
+        ttl: Optional[int] = None,
+    ):
+        try:
+            import redis
+        except ImportError:
+            raise ImportError(
+                "Could not import redis python package. "
+                "Please install it with `pip install redis`."
+            )
+
+        try:
+            self.redis_client = get_client(redis_url=url)
+        except redis.exceptions.ConnectionError as error:
+            logger.error(error)
+
+        self.session_id = session_id
+        self.key_prefix = key_prefix
+        self.ttl = ttl
+
+    @property
+    def key(self) -> str:
+        """Construct the record key to use"""
+        return self.key_prefix + self.session_id
+
+    @property
+    def messages(self) -> List[BaseMessage]:  # type: ignore
+        """Retrieve the messages from Redis"""
+        _items = self.redis_client.lrange(self.key, 0, -1)
+        items = [json.loads(m.decode("utf-8")) for m in _items[::-1]]
+        messages = messages_from_dict(items)
+        return messages
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Append the message to the record in Redis"""
+        self.redis_client.lpush(self.key, json.dumps(message_to_dict(message)))
+        if self.ttl:
+            self.redis_client.expire(self.key, self.ttl)
+
+    def clear(self) -> None:
+        """Clear session memory from Redis"""
+        self.redis_client.delete(self.key)
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/rocksetdb.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/rocksetdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..3e48de373ee9033e8302b8ccaf5ad436aa9b40ab
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/rocksetdb.py
@@ -0,0 +1,268 @@
+from datetime import datetime
+from time import sleep
+from typing import Any, Callable, List, Union
+from uuid import uuid4
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    message_to_dict,
+    messages_from_dict,
+)
+
+
+class RocksetChatMessageHistory(BaseChatMessageHistory):
+    """Uses Rockset to store chat messages.
+
+    To use, ensure that the `rockset` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_message_histories import (
+                RocksetChatMessageHistory
+            )
+            from rockset import RocksetClient
+
+            history = RocksetChatMessageHistory(
+                session_id="MySession",
+                client=RocksetClient(),
+                collection="langchain_demo",
+                sync=True
+            )
+
+            history.add_user_message("hi!")
+            history.add_ai_message("whats up?")
+
+            print(history.messages)  # noqa: T201
+    """
+
+    # You should set these values based on your VI.
+    # These values are configured for the typical
+    # free VI. Read more about VIs here:
+    # https://rockset.com/docs/instances
+    SLEEP_INTERVAL_MS: int = 5
+    ADD_TIMEOUT_MS: int = 5000
+    CREATE_TIMEOUT_MS: int = 20000
+
+    def _wait_until(self, method: Callable, timeout: int, **method_params: Any) -> None:
+        """Sleeps until meth() evaluates to true. Passes kwargs into
+        meth.
+        """
+        start = datetime.now()
+        while not method(**method_params):
+            curr = datetime.now()
+            if (curr - start).total_seconds() * 1000 > timeout:
+                raise TimeoutError(f"{method} timed out at {timeout} ms")
+            sleep(RocksetChatMessageHistory.SLEEP_INTERVAL_MS / 1000)
+
+    def _query(self, query: str, **query_params: Any) -> List[Any]:
+        """Executes an SQL statement and returns the result
+        Args:
+            - query: The SQL string
+            - **query_params: Parameters to pass into the query
+        """
+        return self.client.sql(query, params=query_params).results
+
+    def _create_collection(self) -> None:
+        """Creates a collection for this message history"""
+        self.client.Collections.create_s3_collection(
+            name=self.collection, workspace=self.workspace
+        )
+
+    def _collection_exists(self) -> bool:
+        """Checks whether a collection exists for this message history"""
+        try:
+            self.client.Collections.get(collection=self.collection)
+        except self.rockset.exceptions.NotFoundException:
+            return False
+        return True
+
+    def _collection_is_ready(self) -> bool:
+        """Checks whether the collection for this message history is ready
+        to be queried
+        """
+        return (
+            self.client.Collections.get(collection=self.collection).data.status
+            == "READY"
+        )
+
+    def _document_exists(self) -> bool:
+        return (
+            len(
+                self._query(
+                    f"""
+                        SELECT 1
+                        FROM {self.location} 
+                        WHERE _id=:session_id
+                        LIMIT 1
+                    """,
+                    session_id=self.session_id,
+                )
+            )
+            != 0
+        )
+
+    def _wait_until_collection_created(self) -> None:
+        """Sleeps until the collection for this message history is ready
+        to be queried
+        """
+        self._wait_until(
+            lambda: self._collection_is_ready(),
+            RocksetChatMessageHistory.CREATE_TIMEOUT_MS,
+        )
+
+    def _wait_until_message_added(self, message_id: str) -> None:
+        """Sleeps until a message is added to the messages list"""
+        self._wait_until(
+            lambda message_id: len(
+                self._query(
+                    f"""
+                        SELECT * 
+                        FROM UNNEST((
+                            SELECT {self.messages_key}
+                            FROM {self.location}
+                            WHERE _id = :session_id
+                        )) AS message
+                        WHERE message.data.additional_kwargs.id = :message_id
+                        LIMIT 1
+                    """,
+                    session_id=self.session_id,
+                    message_id=message_id,
+                ),
+            )
+            != 0,
+            RocksetChatMessageHistory.ADD_TIMEOUT_MS,
+            message_id=message_id,
+        )
+
+    def _create_empty_doc(self) -> None:
+        """Creates or replaces a document for this message history with no
+        messages"""
+        self.client.Documents.add_documents(
+            collection=self.collection,
+            workspace=self.workspace,
+            data=[{"_id": self.session_id, self.messages_key: []}],
+        )
+
+    def __init__(
+        self,
+        session_id: str,
+        client: Any,
+        collection: str,
+        workspace: str = "commons",
+        messages_key: str = "messages",
+        sync: bool = False,
+        message_uuid_method: Callable[[], Union[str, int]] = lambda: str(uuid4()),
+    ) -> None:
+        """Constructs a new RocksetChatMessageHistory.
+
+        Args:
+            - session_id: The ID of the chat session
+            - client: The RocksetClient object to use to query
+            - collection: The name of the collection to use to store chat
+                          messages. If a collection with the given name
+                          does not exist in the workspace, it is created.
+            - workspace: The workspace containing `collection`. Defaults
+                         to `"commons"`
+            - messages_key: The DB column containing message history.
+                            Defaults to `"messages"`
+            - sync: Whether to wait for messages to be added. Defaults
+                    to `False`. NOTE: setting this to `True` will slow
+                    down performance.
+            - message_uuid_method: The method that generates message IDs.
+                    If set, all messages will have an `id` field within the
+                    `additional_kwargs` property. If this param is not set
+                    and `sync` is `False`, message IDs will not be created.
+                    If this param is not set and `sync` is `True`, the
+                    `uuid.uuid4` method will be used to create message IDs.
+        """
+        try:
+            import rockset
+        except ImportError:
+            raise ImportError(
+                "Could not import rockset client python package. "
+                "Please install it with `pip install rockset`."
+            )
+
+        if not isinstance(client, rockset.RocksetClient):
+            raise ValueError(
+                f"client should be an instance of rockset.RocksetClient, "
+                f"got {type(client)}"
+            )
+
+        self.session_id = session_id
+        self.client = client
+        self.collection = collection
+        self.workspace = workspace
+        self.location = f'"{self.workspace}"."{self.collection}"'
+        self.rockset = rockset
+        self.messages_key = messages_key
+        self.message_uuid_method = message_uuid_method
+        self.sync = sync
+
+        try:
+            self.client.set_application("langchain")
+        except AttributeError:
+            # ignore
+            pass
+
+        if not self._collection_exists():
+            self._create_collection()
+            self._wait_until_collection_created()
+            self._create_empty_doc()
+        elif not self._document_exists():
+            self._create_empty_doc()
+
+    @property
+    def messages(self) -> List[BaseMessage]:  # type: ignore
+        """Messages in this chat history."""
+        return messages_from_dict(
+            self._query(
+                f"""
+                    SELECT *
+                    FROM UNNEST ((
+                        SELECT "{self.messages_key}"
+                        FROM {self.location}
+                        WHERE _id = :session_id
+                    ))
+                """,
+                session_id=self.session_id,
+            )
+        )
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Add a Message object to the history.
+
+        Args:
+            message: A BaseMessage object to store.
+        """
+        if self.sync and "id" not in message.additional_kwargs:
+            message.additional_kwargs["id"] = self.message_uuid_method()
+        self.client.Documents.patch_documents(
+            collection=self.collection,
+            workspace=self.workspace,
+            data=[
+                self.rockset.model.patch_document.PatchDocument(
+                    id=self.session_id,
+                    patch=[
+                        self.rockset.model.patch_operation.PatchOperation(
+                            op="ADD",
+                            path=f"/{self.messages_key}/-",
+                            value=message_to_dict(message),
+                        )
+                    ],
+                )
+            ],
+        )
+        if self.sync:
+            self._wait_until_message_added(message.additional_kwargs["id"])
+
+    def clear(self) -> None:
+        """Removes all messages from the chat history"""
+        self._create_empty_doc()
+        if self.sync:
+            self._wait_until(
+                lambda: not self.messages,
+                RocksetChatMessageHistory.ADD_TIMEOUT_MS,
+            )
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/singlestoredb.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/singlestoredb.py
new file mode 100644
index 0000000000000000000000000000000000000000..a2fc1af13724d63cbb6a79d2060c6891eb6f8486
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/singlestoredb.py
@@ -0,0 +1,277 @@
+import json
+import logging
+import re
+from typing import (
+    Any,
+    List,
+)
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    message_to_dict,
+    messages_from_dict,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class SingleStoreDBChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history stored in a SingleStoreDB database."""
+
+    def __init__(
+        self,
+        session_id: str,
+        *,
+        table_name: str = "message_store",
+        id_field: str = "id",
+        session_id_field: str = "session_id",
+        message_field: str = "message",
+        pool_size: int = 5,
+        max_overflow: int = 10,
+        timeout: float = 30,
+        **kwargs: Any,
+    ):
+        """Initialize with necessary components.
+
+        Args:
+
+
+            table_name (str, optional): Specifies the name of the table in use.
+                Defaults to "message_store".
+            id_field (str, optional): Specifies the name of the id field in the table.
+                Defaults to "id".
+            session_id_field (str, optional): Specifies the name of the session_id
+                field in the table. Defaults to "session_id".
+            message_field (str, optional): Specifies the name of the message field
+                in the table. Defaults to "message".
+
+            Following arguments pertain to the connection pool:
+
+            pool_size (int, optional): Determines the number of active connections in
+                the pool. Defaults to 5.
+            max_overflow (int, optional): Determines the maximum number of connections
+                allowed beyond the pool_size. Defaults to 10.
+            timeout (float, optional): Specifies the maximum wait time in seconds for
+                establishing a connection. Defaults to 30.
+
+            Following arguments pertain to the database connection:
+
+            host (str, optional): Specifies the hostname, IP address, or URL for the
+                database connection. The default scheme is "mysql".
+            user (str, optional): Database username.
+            password (str, optional): Database password.
+            port (int, optional): Database port. Defaults to 3306 for non-HTTP
+                connections, 80 for HTTP connections, and 443 for HTTPS connections.
+            database (str, optional): Database name.
+
+            Additional optional arguments provide further customization over the
+            database connection:
+
+            pure_python (bool, optional): Toggles the connector mode. If True,
+                operates in pure Python mode.
+            local_infile (bool, optional): Allows local file uploads.
+            charset (str, optional): Specifies the character set for string values.
+            ssl_key (str, optional): Specifies the path of the file containing the SSL
+                key.
+            ssl_cert (str, optional): Specifies the path of the file containing the SSL
+                certificate.
+            ssl_ca (str, optional): Specifies the path of the file containing the SSL
+                certificate authority.
+            ssl_cipher (str, optional): Sets the SSL cipher list.
+            ssl_disabled (bool, optional): Disables SSL usage.
+            ssl_verify_cert (bool, optional): Verifies the server's certificate.
+                Automatically enabled if ``ssl_ca`` is specified.
+            ssl_verify_identity (bool, optional): Verifies the server's identity.
+            conv (dict[int, Callable], optional): A dictionary of data conversion
+                functions.
+            credential_type (str, optional): Specifies the type of authentication to
+                use: auth.PASSWORD, auth.JWT, or auth.BROWSER_SSO.
+            autocommit (bool, optional): Enables autocommits.
+            results_type (str, optional): Determines the structure of the query results:
+                tuples, namedtuples, dicts.
+            results_format (str, optional): Deprecated. This option has been renamed to
+                results_type.
+
+        Examples:
+            Basic Usage:
+
+            .. code-block:: python
+
+                from langchain_community.chat_message_histories import (
+                    SingleStoreDBChatMessageHistory
+                )
+
+                message_history = SingleStoreDBChatMessageHistory(
+                    session_id="my-session",
+                    host="https://user:password@127.0.0.1:3306/database"
+                )
+
+            Advanced Usage:
+
+            .. code-block:: python
+
+                from langchain_community.chat_message_histories import (
+                    SingleStoreDBChatMessageHistory
+                )
+
+                message_history = SingleStoreDBChatMessageHistory(
+                    session_id="my-session",
+                    host="127.0.0.1",
+                    port=3306,
+                    user="user",
+                    password="password",
+                    database="db",
+                    table_name="my_custom_table",
+                    pool_size=10,
+                    timeout=60,
+                )
+
+            Using environment variables:
+
+            .. code-block:: python
+
+                from langchain_community.chat_message_histories import (
+                    SingleStoreDBChatMessageHistory
+                )
+
+                os.environ['SINGLESTOREDB_URL'] = 'me:p455w0rd@s2-host.com/my_db'
+                message_history = SingleStoreDBChatMessageHistory("my-session")
+        """
+
+        self.table_name = self._sanitize_input(table_name)
+        self.session_id = self._sanitize_input(session_id)
+        self.id_field = self._sanitize_input(id_field)
+        self.session_id_field = self._sanitize_input(session_id_field)
+        self.message_field = self._sanitize_input(message_field)
+
+        # Pass the rest of the kwargs to the connection.
+        self.connection_kwargs = kwargs
+
+        # Add connection attributes to the connection kwargs.
+        if "conn_attrs" not in self.connection_kwargs:
+            self.connection_kwargs["conn_attrs"] = dict()
+
+        self.connection_kwargs["conn_attrs"]["_connector_name"] = "langchain python sdk"
+        self.connection_kwargs["conn_attrs"]["_connector_version"] = "1.0.1"
+
+        # Create a connection pool.
+        try:
+            from sqlalchemy.pool import QueuePool
+        except ImportError:
+            raise ImportError(
+                "Could not import sqlalchemy.pool python package. "
+                "Please install it with `pip install singlestoredb`."
+            )
+
+        self.connection_pool = QueuePool(
+            self._get_connection,
+            max_overflow=max_overflow,
+            pool_size=pool_size,
+            timeout=timeout,
+        )
+        self.table_created = False
+
+    def _sanitize_input(self, input_str: str) -> str:
+        # Remove characters that are not alphanumeric or underscores
+        return re.sub(r"[^a-zA-Z0-9_]", "", input_str)
+
+    def _get_connection(self) -> Any:
+        try:
+            import singlestoredb as s2
+        except ImportError:
+            raise ImportError(
+                "Could not import singlestoredb python package. "
+                "Please install it with `pip install singlestoredb`."
+            )
+        return s2.connect(**self.connection_kwargs)
+
+    def _create_table_if_not_exists(self) -> None:
+        """Create table if it doesn't exist."""
+        if self.table_created:
+            return
+        conn = self.connection_pool.connect()
+        try:
+            cur = conn.cursor()
+            try:
+                cur.execute(
+                    """CREATE TABLE IF NOT EXISTS {}
+                    ({} BIGINT PRIMARY KEY AUTO_INCREMENT,
+                    {} TEXT NOT NULL,
+                    {} JSON NOT NULL);""".format(
+                        self.table_name,
+                        self.id_field,
+                        self.session_id_field,
+                        self.message_field,
+                    ),
+                )
+                self.table_created = True
+            finally:
+                cur.close()
+        finally:
+            conn.close()
+
+    @property
+    def messages(self) -> List[BaseMessage]:  # type: ignore
+        """Retrieve the messages from SingleStoreDB"""
+        self._create_table_if_not_exists()
+        conn = self.connection_pool.connect()
+        items = []
+        try:
+            cur = conn.cursor()
+            try:
+                cur.execute(
+                    """SELECT {} FROM {} WHERE {} = %s""".format(
+                        self.message_field,
+                        self.table_name,
+                        self.session_id_field,
+                    ),
+                    (self.session_id),
+                )
+                for row in cur.fetchall():
+                    items.append(row[0])
+            finally:
+                cur.close()
+        finally:
+            conn.close()
+        messages = messages_from_dict(items)
+        return messages
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Append the message to the record in SingleStoreDB"""
+        self._create_table_if_not_exists()
+        conn = self.connection_pool.connect()
+        try:
+            cur = conn.cursor()
+            try:
+                cur.execute(
+                    """INSERT INTO {} ({}, {}) VALUES (%s, %s)""".format(
+                        self.table_name,
+                        self.session_id_field,
+                        self.message_field,
+                    ),
+                    (self.session_id, json.dumps(message_to_dict(message))),
+                )
+            finally:
+                cur.close()
+        finally:
+            conn.close()
+
+    def clear(self) -> None:
+        """Clear session memory from SingleStoreDB"""
+        self._create_table_if_not_exists()
+        conn = self.connection_pool.connect()
+        try:
+            cur = conn.cursor()
+            try:
+                cur.execute(
+                    """DELETE FROM {} WHERE {} = %s""".format(
+                        self.table_name,
+                        self.session_id_field,
+                    ),
+                    (self.session_id),
+                )
+            finally:
+                cur.close()
+        finally:
+            conn.close()
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/sql.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/sql.py
new file mode 100644
index 0000000000000000000000000000000000000000..01cafeb9bcdcc56ff1bd6e89c8a445f99dd00519
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/sql.py
@@ -0,0 +1,140 @@
+import json
+import logging
+from abc import ABC, abstractmethod
+from typing import Any, List, Optional
+
+from sqlalchemy import Column, Integer, Text, create_engine
+
+try:
+    from sqlalchemy.orm import declarative_base
+except ImportError:
+    from sqlalchemy.ext.declarative import declarative_base
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    message_to_dict,
+    messages_from_dict,
+)
+from sqlalchemy.orm import sessionmaker
+
+logger = logging.getLogger(__name__)
+
+
+class BaseMessageConverter(ABC):
+    """Convert BaseMessage to the SQLAlchemy model."""
+
+    @abstractmethod
+    def from_sql_model(self, sql_message: Any) -> BaseMessage:
+        """Convert a SQLAlchemy model to a BaseMessage instance."""
+        raise NotImplementedError
+
+    @abstractmethod
+    def to_sql_model(self, message: BaseMessage, session_id: str) -> Any:
+        """Convert a BaseMessage instance to a SQLAlchemy model."""
+        raise NotImplementedError
+
+    @abstractmethod
+    def get_sql_model_class(self) -> Any:
+        """Get the SQLAlchemy model class."""
+        raise NotImplementedError
+
+
+def create_message_model(table_name: str, DynamicBase: Any) -> Any:
+    """
+    Create a message model for a given table name.
+
+    Args:
+        table_name: The name of the table to use.
+        DynamicBase: The base class to use for the model.
+
+    Returns:
+        The model class.
+
+    """
+
+    # Model declared inside a function to have a dynamic table name.
+    class Message(DynamicBase):  # type: ignore[valid-type, misc]
+        __tablename__ = table_name
+        id = Column(Integer, primary_key=True)
+        session_id = Column(Text)
+        message = Column(Text)
+
+    return Message
+
+
+class DefaultMessageConverter(BaseMessageConverter):
+    """The default message converter for SQLChatMessageHistory."""
+
+    def __init__(self, table_name: str):
+        self.model_class = create_message_model(table_name, declarative_base())
+
+    def from_sql_model(self, sql_message: Any) -> BaseMessage:
+        return messages_from_dict([json.loads(sql_message.message)])[0]
+
+    def to_sql_model(self, message: BaseMessage, session_id: str) -> Any:
+        return self.model_class(
+            session_id=session_id, message=json.dumps(message_to_dict(message))
+        )
+
+    def get_sql_model_class(self) -> Any:
+        return self.model_class
+
+
+class SQLChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history stored in an SQL database."""
+
+    def __init__(
+        self,
+        session_id: str,
+        connection_string: str,
+        table_name: str = "message_store",
+        session_id_field_name: str = "session_id",
+        custom_message_converter: Optional[BaseMessageConverter] = None,
+    ):
+        self.connection_string = connection_string
+        self.engine = create_engine(connection_string, echo=False)
+        self.session_id_field_name = session_id_field_name
+        self.converter = custom_message_converter or DefaultMessageConverter(table_name)
+        self.sql_model_class = self.converter.get_sql_model_class()
+        if not hasattr(self.sql_model_class, session_id_field_name):
+            raise ValueError("SQL model class must have session_id column")
+        self._create_table_if_not_exists()
+
+        self.session_id = session_id
+        self.Session = sessionmaker(self.engine)
+
+    def _create_table_if_not_exists(self) -> None:
+        self.sql_model_class.metadata.create_all(self.engine)
+
+    @property
+    def messages(self) -> List[BaseMessage]:  # type: ignore
+        """Retrieve all messages from db"""
+        with self.Session() as session:
+            result = (
+                session.query(self.sql_model_class)
+                .where(
+                    getattr(self.sql_model_class, self.session_id_field_name)
+                    == self.session_id
+                )
+                .order_by(self.sql_model_class.id.asc())
+            )
+            messages = []
+            for record in result:
+                messages.append(self.converter.from_sql_model(record))
+            return messages
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Append the message to the record in db"""
+        with self.Session() as session:
+            session.add(self.converter.to_sql_model(message, self.session_id))
+            session.commit()
+
+    def clear(self) -> None:
+        """Clear session memory from db"""
+
+        with self.Session() as session:
+            session.query(self.sql_model_class).filter(
+                getattr(self.sql_model_class, self.session_id_field_name)
+                == self.session_id
+            ).delete()
+            session.commit()
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/streamlit.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/streamlit.py
new file mode 100644
index 0000000000000000000000000000000000000000..c04e865bf9a99ae1127621996788072eefd937e4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/streamlit.py
@@ -0,0 +1,47 @@
+from typing import List
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import BaseMessage
+
+
+class StreamlitChatMessageHistory(BaseChatMessageHistory):
+    """
+    Chat message history that stores messages in Streamlit session state.
+
+    Args:
+        key: The key to use in Streamlit session state for storing messages.
+    """
+
+    def __init__(self, key: str = "langchain_messages"):
+        try:
+            import streamlit as st
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import streamlit, please run `pip install streamlit`."
+            ) from e
+
+        if key not in st.session_state:
+            st.session_state[key] = []
+        self._messages = st.session_state[key]
+        self._key = key
+
+    @property
+    def messages(self) -> List[BaseMessage]:
+        """Retrieve the current list of messages"""
+        return self._messages
+
+    @messages.setter
+    def messages(self, value: List[BaseMessage]) -> None:
+        """Set the messages list with a new value"""
+        import streamlit as st
+
+        st.session_state[self._key] = value
+        self._messages = st.session_state[self._key]
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Add a message to the session memory"""
+        self.messages.append(message)
+
+    def clear(self) -> None:
+        """Clear session memory"""
+        self.messages.clear()
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/tidb.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/tidb.py
new file mode 100644
index 0000000000000000000000000000000000000000..309ab6d7b12c0d60de18845a69ae9390e9b84948
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/tidb.py
@@ -0,0 +1,148 @@
+import json
+import logging
+from datetime import datetime
+from typing import List, Optional
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import BaseMessage, message_to_dict, messages_from_dict
+from sqlalchemy import create_engine, text
+from sqlalchemy.exc import SQLAlchemyError
+from sqlalchemy.orm import sessionmaker
+
+logger = logging.getLogger(__name__)
+
+
+class TiDBChatMessageHistory(BaseChatMessageHistory):
+    """
+    Represents a chat message history stored in a TiDB database.
+    """
+
+    def __init__(
+        self,
+        session_id: str,
+        connection_string: str,
+        table_name: str = "langchain_message_store",
+        earliest_time: Optional[datetime] = None,
+    ):
+        """
+        Initializes a new instance of the TiDBChatMessageHistory class.
+
+        Args:
+            session_id (str): The ID of the chat session.
+            connection_string (str): The connection string for the TiDB database.
+                format: mysql+pymysql://<host>:<PASSWORD>@<host>:4000/<db>?ssl_ca=/etc/ssl/cert.pem&ssl_verify_cert=true&ssl_verify_identity=true
+            table_name (str, optional): the table name to store the chat messages.
+                Defaults to "langchain_message_store".
+            earliest_time (Optional[datetime], optional): The earliest time to retrieve messages from.
+                Defaults to None.
+        """  # noqa
+
+        self.session_id = session_id
+        self.table_name = table_name
+        self.earliest_time = earliest_time
+        self.cache: List = []
+
+        # Set up SQLAlchemy engine and session
+        self.engine = create_engine(connection_string)
+        Session = sessionmaker(bind=self.engine)
+        self.session = Session()
+
+        self._create_table_if_not_exists()
+        self._load_messages_to_cache()
+
+    def _create_table_if_not_exists(self) -> None:
+        """
+        Creates a table if it does not already exist in the database.
+        """
+
+        create_table_query = text(
+            f"""
+            CREATE TABLE IF NOT EXISTS {self.table_name} (
+                id INT AUTO_INCREMENT PRIMARY KEY,
+                session_id VARCHAR(255) NOT NULL,
+                message JSON NOT NULL,
+                create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+                INDEX session_idx (session_id)
+            );"""
+        )
+        try:
+            self.session.execute(create_table_query)
+            self.session.commit()
+        except SQLAlchemyError as e:
+            logger.error(f"Error creating table: {e}")
+            self.session.rollback()
+
+    def _load_messages_to_cache(self) -> None:
+        """
+        Loads messages from the database into the cache.
+
+        This method retrieves messages from the database table. The retrieved messages
+        are then stored in the cache for faster access.
+
+        Raises:
+            SQLAlchemyError: If there is an error executing the database query.
+
+        """
+        time_condition = (
+            f"AND create_time >= '{self.earliest_time}'" if self.earliest_time else ""
+        )
+        query = text(
+            f"""
+            SELECT message FROM {self.table_name} 
+            WHERE session_id = :session_id {time_condition} 
+            ORDER BY id;
+        """
+        )
+        try:
+            result = self.session.execute(query, {"session_id": self.session_id})
+            for record in result.fetchall():
+                message_dict = json.loads(record[0])
+                self.cache.append(messages_from_dict([message_dict])[0])
+        except SQLAlchemyError as e:
+            logger.error(f"Error loading messages to cache: {e}")
+
+    @property
+    def messages(self) -> List[BaseMessage]:  # type: ignore[override]
+        """returns all messages"""
+        if len(self.cache) == 0:
+            self.reload_cache()
+        return self.cache
+
+    def add_message(self, message: BaseMessage) -> None:
+        """adds a message to the database and cache"""
+        query = text(
+            f"INSERT INTO {self.table_name} (session_id, message) VALUES (:session_id, :message);"  # noqa
+        )
+        try:
+            self.session.execute(
+                query,
+                {
+                    "session_id": self.session_id,
+                    "message": json.dumps(message_to_dict(message)),
+                },
+            )
+            self.session.commit()
+            self.cache.append(message)
+        except SQLAlchemyError as e:
+            logger.error(f"Error adding message: {e}")
+            self.session.rollback()
+
+    def clear(self) -> None:
+        """clears all messages"""
+        query = text(f"DELETE FROM {self.table_name} WHERE session_id = :session_id;")
+        try:
+            self.session.execute(query, {"session_id": self.session_id})
+            self.session.commit()
+            self.cache.clear()
+        except SQLAlchemyError as e:
+            logger.error(f"Error clearing messages: {e}")
+            self.session.rollback()
+
+    def reload_cache(self) -> None:
+        """reloads messages from database to cache"""
+        self.cache.clear()
+        self._load_messages_to_cache()
+
+    def __del__(self) -> None:
+        """closes the session"""
+        self.session.close()
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/upstash_redis.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/upstash_redis.py
new file mode 100644
index 0000000000000000000000000000000000000000..de1e7c37822751f4a9b40a35f22a6e3834070a4f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/upstash_redis.py
@@ -0,0 +1,69 @@
+import json
+import logging
+from typing import List, Optional
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    message_to_dict,
+    messages_from_dict,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class UpstashRedisChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history stored in an Upstash Redis database."""
+
+    def __init__(
+        self,
+        session_id: str,
+        url: str = "",
+        token: str = "",
+        key_prefix: str = "message_store:",
+        ttl: Optional[int] = None,
+    ):
+        try:
+            from upstash_redis import Redis
+        except ImportError:
+            raise ImportError(
+                "Could not import upstash redis python package. "
+                "Please install it with `pip install upstash_redis`."
+            )
+
+        if url == "" or token == "":
+            raise ValueError(
+                "UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN are needed."
+            )
+
+        try:
+            self.redis_client = Redis(url=url, token=token)
+        except Exception:
+            logger.error("Upstash Redis instance could not be initiated.")
+
+        self.session_id = session_id
+        self.key_prefix = key_prefix
+        self.ttl = ttl
+
+    @property
+    def key(self) -> str:
+        """Construct the record key to use"""
+        return self.key_prefix + self.session_id
+
+    @property
+    def messages(self) -> List[BaseMessage]:  # type: ignore
+        """Retrieve the messages from Upstash Redis"""
+        _items = self.redis_client.lrange(self.key, 0, -1)
+        items = [json.loads(m) for m in _items[::-1]]
+        messages = messages_from_dict(items)
+        return messages
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Append the message to the record in Upstash Redis"""
+        self.redis_client.lpush(self.key, json.dumps(message_to_dict(message)))
+        if self.ttl:
+            self.redis_client.expire(self.key, self.ttl)
+
+    def clear(self) -> None:
+        """Clear session memory from Upstash Redis"""
+        self.redis_client.delete(self.key)
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/xata.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/xata.py
new file mode 100644
index 0000000000000000000000000000000000000000..56bcf1d98f3934d3683739c0d8ae5bce94af35ea
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/xata.py
@@ -0,0 +1,134 @@
+import json
+from typing import List
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    BaseMessage,
+    message_to_dict,
+    messages_from_dict,
+)
+
+
+class XataChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history stored in a Xata database."""
+
+    def __init__(
+        self,
+        session_id: str,
+        db_url: str,
+        api_key: str,
+        branch_name: str = "main",
+        table_name: str = "messages",
+        create_table: bool = True,
+    ) -> None:
+        """Initialize with Xata client."""
+        try:
+            from xata.client import XataClient  # noqa: F401
+        except ImportError:
+            raise ValueError(
+                "Could not import xata python package. "
+                "Please install it with `pip install xata`."
+            )
+        self._client = XataClient(
+            api_key=api_key, db_url=db_url, branch_name=branch_name
+        )
+        self._table_name = table_name
+        self._session_id = session_id
+
+        if create_table:
+            self._create_table_if_not_exists()
+
+    def _create_table_if_not_exists(self) -> None:
+        r = self._client.table().get_schema(self._table_name)
+        if r.status_code <= 299:
+            return
+        if r.status_code != 404:
+            raise Exception(
+                f"Error checking if table exists in Xata: {r.status_code} {r}"
+            )
+        r = self._client.table().create(self._table_name)
+        if r.status_code > 299:
+            raise Exception(f"Error creating table in Xata: {r.status_code} {r}")
+        r = self._client.table().set_schema(
+            self._table_name,
+            payload={
+                "columns": [
+                    {"name": "sessionId", "type": "string"},
+                    {"name": "type", "type": "string"},
+                    {"name": "role", "type": "string"},
+                    {"name": "content", "type": "text"},
+                    {"name": "name", "type": "string"},
+                    {"name": "additionalKwargs", "type": "json"},
+                ]
+            },
+        )
+        if r.status_code > 299:
+            raise Exception(f"Error setting table schema in Xata: {r.status_code} {r}")
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Append the message to the Xata table"""
+        msg = message_to_dict(message)
+        r = self._client.records().insert(
+            self._table_name,
+            {
+                "sessionId": self._session_id,
+                "type": msg["type"],
+                "content": message.content,
+                "additionalKwargs": json.dumps(message.additional_kwargs),
+                "role": msg["data"].get("role"),
+                "name": msg["data"].get("name"),
+            },
+        )
+        if r.status_code > 299:
+            raise Exception(f"Error adding message to Xata: {r.status_code} {r}")
+
+    @property
+    def messages(self) -> List[BaseMessage]:  # type: ignore
+        r = self._client.data().query(
+            self._table_name,
+            payload={
+                "filter": {
+                    "sessionId": self._session_id,
+                },
+                "sort": {"xata.createdAt": "asc"},
+            },
+        )
+        if r.status_code != 200:
+            raise Exception(f"Error running query: {r.status_code} {r}")
+        msgs = messages_from_dict(
+            [
+                {
+                    "type": m["type"],
+                    "data": {
+                        "content": m["content"],
+                        "role": m.get("role"),
+                        "name": m.get("name"),
+                        "additional_kwargs": json.loads(m["additionalKwargs"]),
+                    },
+                }
+                for m in r["records"]
+            ]
+        )
+        return msgs
+
+    def clear(self) -> None:
+        """Delete session from Xata table."""
+        while True:
+            r = self._client.data().query(
+                self._table_name,
+                payload={
+                    "columns": ["id"],
+                    "filter": {
+                        "sessionId": self._session_id,
+                    },
+                },
+            )
+            if r.status_code != 200:
+                raise Exception(f"Error running query: {r.status_code} {r}")
+            ids = [rec["id"] for rec in r["records"]]
+            if len(ids) == 0:
+                break
+            operations = [
+                {"delete": {"table": self._table_name, "id": id}} for id in ids
+            ]
+            self._client.records().transaction(payload={"operations": operations})
diff --git a/llm/Lib/site-packages/langchain_community/chat_message_histories/zep.py b/llm/Lib/site-packages/langchain_community/chat_message_histories/zep.py
new file mode 100644
index 0000000000000000000000000000000000000000..c3a2a820d8781245766044efc4ce52c658ba36e7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_message_histories/zep.py
@@ -0,0 +1,264 @@
+from __future__ import annotations
+
+import logging
+from enum import Enum
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Sequence
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    HumanMessage,
+    SystemMessage,
+)
+
+if TYPE_CHECKING:
+    from zep_python import Memory, MemorySearchResult, Message, NotFoundError
+
+logger = logging.getLogger(__name__)
+
+
+class SearchScope(str, Enum):
+    """Which documents to search. Messages or Summaries?"""
+
+    messages = "messages"
+    """Search chat history messages."""
+    summary = "summary"
+    """Search chat history summaries."""
+
+
+class SearchType(str, Enum):
+    """Enumerator of the types of search to perform."""
+
+    similarity = "similarity"
+    """Similarity search."""
+    mmr = "mmr"
+    """Maximal Marginal Relevance reranking of similarity search."""
+
+
+class ZepChatMessageHistory(BaseChatMessageHistory):
+    """Chat message history that uses Zep as a backend.
+
+    Recommended usage::
+
+        # Set up Zep Chat History
+        zep_chat_history = ZepChatMessageHistory(
+            session_id=session_id,
+            url=ZEP_API_URL,
+            api_key=<your_api_key>,
+        )
+
+        # Use a standard ConversationBufferMemory to encapsulate the Zep chat history
+        memory = ConversationBufferMemory(
+            memory_key="chat_history", chat_memory=zep_chat_history
+        )
+
+
+    Zep provides long-term conversation storage for LLM apps. The server stores,
+    summarizes, embeds, indexes, and enriches conversational AI chat
+    histories, and exposes them via simple, low-latency APIs.
+
+    For server installation instructions and more, see:
+    https://docs.getzep.com/deployment/quickstart/
+
+    This class is a thin wrapper around the zep-python package. Additional
+    Zep functionality is exposed via the `zep_summary` and `zep_messages`
+    properties.
+
+    For more information on the zep-python package, see:
+    https://github.com/getzep/zep-python
+    """
+
+    def __init__(
+        self,
+        session_id: str,
+        url: str = "http://localhost:8000",
+        api_key: Optional[str] = None,
+    ) -> None:
+        try:
+            from zep_python import ZepClient
+        except ImportError:
+            raise ImportError(
+                "Could not import zep-python package. "
+                "Please install it with `pip install zep-python`."
+            )
+
+        self.zep_client = ZepClient(base_url=url, api_key=api_key)
+        self.session_id = session_id
+
+    @property
+    def messages(self) -> List[BaseMessage]:  # type: ignore
+        """Retrieve messages from Zep memory"""
+        zep_memory: Optional[Memory] = self._get_memory()
+        if not zep_memory:
+            return []
+
+        messages: List[BaseMessage] = []
+        # Extract summary, if present, and messages
+        if zep_memory.summary:
+            if len(zep_memory.summary.content) > 0:
+                messages.append(SystemMessage(content=zep_memory.summary.content))
+        if zep_memory.messages:
+            msg: Message
+            for msg in zep_memory.messages:
+                metadata: Dict = {
+                    "uuid": msg.uuid,
+                    "created_at": msg.created_at,
+                    "token_count": msg.token_count,
+                    "metadata": msg.metadata,
+                }
+                if msg.role == "ai":
+                    messages.append(
+                        AIMessage(content=msg.content, additional_kwargs=metadata)
+                    )
+                else:
+                    messages.append(
+                        HumanMessage(content=msg.content, additional_kwargs=metadata)
+                    )
+
+        return messages
+
+    @property
+    def zep_messages(self) -> List[Message]:
+        """Retrieve summary from Zep memory"""
+        zep_memory: Optional[Memory] = self._get_memory()
+        if not zep_memory:
+            return []
+
+        return zep_memory.messages
+
+    @property
+    def zep_summary(self) -> Optional[str]:
+        """Retrieve summary from Zep memory"""
+        zep_memory: Optional[Memory] = self._get_memory()
+        if not zep_memory or not zep_memory.summary:
+            return None
+
+        return zep_memory.summary.content
+
+    def _get_memory(self) -> Optional[Memory]:
+        """Retrieve memory from Zep"""
+        from zep_python import NotFoundError
+
+        try:
+            zep_memory: Memory = self.zep_client.memory.get_memory(self.session_id)
+        except NotFoundError:
+            logger.warning(
+                f"Session {self.session_id} not found in Zep. Returning None"
+            )
+            return None
+        return zep_memory
+
+    def add_user_message(  # type: ignore[override]
+        self, message: str, metadata: Optional[Dict[str, Any]] = None
+    ) -> None:
+        """Convenience method for adding a human message string to the store.
+
+        Args:
+            message: The string contents of a human message.
+            metadata: Optional metadata to attach to the message.
+        """
+        self.add_message(HumanMessage(content=message), metadata=metadata)
+
+    def add_ai_message(  # type: ignore[override]
+        self, message: str, metadata: Optional[Dict[str, Any]] = None
+    ) -> None:
+        """Convenience method for adding an AI message string to the store.
+
+        Args:
+            message: The string contents of an AI message.
+            metadata: Optional metadata to attach to the message.
+        """
+        self.add_message(AIMessage(content=message), metadata=metadata)
+
+    def add_message(
+        self, message: BaseMessage, metadata: Optional[Dict[str, Any]] = None
+    ) -> None:
+        """Append the message to the Zep memory history"""
+        from zep_python import Memory, Message
+
+        zep_message = Message(
+            content=message.content, role=message.type, metadata=metadata
+        )
+        zep_memory = Memory(messages=[zep_message])
+
+        self.zep_client.memory.add_memory(self.session_id, zep_memory)
+
+    def add_messages(self, messages: Sequence[BaseMessage]) -> None:
+        """Append the messages to the Zep memory history"""
+        from zep_python import Memory, Message
+
+        zep_messages = [
+            Message(
+                content=message.content,
+                role=message.type,
+                metadata=message.additional_kwargs.get("metadata", None),
+            )
+            for message in messages
+        ]
+        zep_memory = Memory(messages=zep_messages)
+
+        self.zep_client.memory.add_memory(self.session_id, zep_memory)
+
+    async def aadd_messages(self, messages: Sequence[BaseMessage]) -> None:
+        """Append the messages to the Zep memory history asynchronously"""
+        from zep_python import Memory, Message
+
+        zep_messages = [
+            Message(
+                content=message.content,
+                role=message.type,
+                metadata=message.additional_kwargs.get("metadata", None),
+            )
+            for message in messages
+        ]
+        zep_memory = Memory(messages=zep_messages)
+
+        await self.zep_client.memory.aadd_memory(self.session_id, zep_memory)
+
+    def search(
+        self,
+        query: str,
+        metadata: Optional[Dict] = None,
+        search_scope: SearchScope = SearchScope.messages,
+        search_type: SearchType = SearchType.similarity,
+        mmr_lambda: Optional[float] = None,
+        limit: Optional[int] = None,
+    ) -> List[MemorySearchResult]:
+        """Search Zep memory for messages matching the query"""
+        from zep_python import MemorySearchPayload
+
+        payload = MemorySearchPayload(
+            text=query,
+            metadata=metadata,
+            search_scope=search_scope,
+            search_type=search_type,
+            mmr_lambda=mmr_lambda,
+        )
+
+        return self.zep_client.memory.search_memory(
+            self.session_id, payload, limit=limit
+        )
+
+    def clear(self) -> None:
+        """Clear session memory from Zep. Note that Zep is long-term storage for memory
+        and this is not advised unless you have specific data retention requirements.
+        """
+        try:
+            self.zep_client.memory.delete_memory(self.session_id)
+        except NotFoundError:
+            logger.warning(
+                f"Session {self.session_id} not found in Zep. Skipping delete."
+            )
+
+    async def aclear(self) -> None:
+        """Clear session memory from Zep asynchronously.
+        Note that Zep is long-term storage for memory and this is not advised
+        unless you have specific data retention requirements.
+        """
+        try:
+            await self.zep_client.memory.adelete_memory(self.session_id)
+        except NotFoundError:
+            logger.warning(
+                f"Session {self.session_id} not found in Zep. Skipping delete."
+            )
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__init__.py b/llm/Lib/site-packages/langchain_community/chat_models/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..96af77d5f06b88faa7d5f1d5d4e6ccc5b236fe90
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/__init__.py
@@ -0,0 +1,271 @@
+"""**Chat Models** are a variation on language models.
+
+While Chat Models use language models under the hood, the interface they expose
+is a bit different. Rather than expose a "text in, text out" API, they expose
+an interface where "chat messages" are the inputs and outputs.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseLanguageModel --> BaseChatModel --> <name>  # Examples: ChatOpenAI, ChatGooglePalm
+
+**Main helpers:**
+
+.. code-block::
+
+    AIMessage, BaseMessage, HumanMessage
+"""  # noqa: E501
+
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.chat_models.anthropic import (
+        ChatAnthropic,  # noqa: F401
+    )
+    from langchain_community.chat_models.anyscale import (
+        ChatAnyscale,  # noqa: F401
+    )
+    from langchain_community.chat_models.azure_openai import (
+        AzureChatOpenAI,  # noqa: F401
+    )
+    from langchain_community.chat_models.baichuan import (
+        ChatBaichuan,  # noqa: F401
+    )
+    from langchain_community.chat_models.baidu_qianfan_endpoint import (
+        QianfanChatEndpoint,  # noqa: F401
+    )
+    from langchain_community.chat_models.bedrock import (
+        BedrockChat,  # noqa: F401
+    )
+    from langchain_community.chat_models.cohere import (
+        ChatCohere,  # noqa: F401
+    )
+    from langchain_community.chat_models.databricks import (
+        ChatDatabricks,  # noqa: F401
+    )
+    from langchain_community.chat_models.deepinfra import (
+        ChatDeepInfra,  # noqa: F401
+    )
+    from langchain_community.chat_models.ernie import (
+        ErnieBotChat,  # noqa: F401
+    )
+    from langchain_community.chat_models.everlyai import (
+        ChatEverlyAI,  # noqa: F401
+    )
+    from langchain_community.chat_models.fake import (
+        FakeListChatModel,  # noqa: F401
+    )
+    from langchain_community.chat_models.fireworks import (
+        ChatFireworks,  # noqa: F401
+    )
+    from langchain_community.chat_models.friendli import (
+        ChatFriendli,  # noqa: F401
+    )
+    from langchain_community.chat_models.gigachat import (
+        GigaChat,  # noqa: F401
+    )
+    from langchain_community.chat_models.google_palm import (
+        ChatGooglePalm,  # noqa: F401
+    )
+    from langchain_community.chat_models.gpt_router import (
+        GPTRouter,  # noqa: F401
+    )
+    from langchain_community.chat_models.huggingface import (
+        ChatHuggingFace,  # noqa: F401
+    )
+    from langchain_community.chat_models.human import (
+        HumanInputChatModel,  # noqa: F401
+    )
+    from langchain_community.chat_models.hunyuan import (
+        ChatHunyuan,  # noqa: F401
+    )
+    from langchain_community.chat_models.javelin_ai_gateway import (
+        ChatJavelinAIGateway,  # noqa: F401
+    )
+    from langchain_community.chat_models.jinachat import (
+        JinaChat,  # noqa: F401
+    )
+    from langchain_community.chat_models.kinetica import (
+        ChatKinetica,  # noqa: F401
+    )
+    from langchain_community.chat_models.konko import (
+        ChatKonko,  # noqa: F401
+    )
+    from langchain_community.chat_models.litellm import (
+        ChatLiteLLM,  # noqa: F401
+    )
+    from langchain_community.chat_models.litellm_router import (
+        ChatLiteLLMRouter,  # noqa: F401
+    )
+    from langchain_community.chat_models.llama_edge import (
+        LlamaEdgeChatService,  # noqa: F401
+    )
+    from langchain_community.chat_models.maritalk import (
+        ChatMaritalk,  # noqa: F401
+    )
+    from langchain_community.chat_models.minimax import (
+        MiniMaxChat,  # noqa: F401
+    )
+    from langchain_community.chat_models.mlflow import (
+        ChatMlflow,  # noqa: F401
+    )
+    from langchain_community.chat_models.mlflow_ai_gateway import (
+        ChatMLflowAIGateway,  # noqa: F401
+    )
+    from langchain_community.chat_models.mlx import (
+        ChatMLX,  # noqa: F401
+    )
+    from langchain_community.chat_models.ollama import (
+        ChatOllama,  # noqa: F401
+    )
+    from langchain_community.chat_models.openai import (
+        ChatOpenAI,  # noqa: F401
+    )
+    from langchain_community.chat_models.pai_eas_endpoint import (
+        PaiEasChatEndpoint,  # noqa: F401
+    )
+    from langchain_community.chat_models.perplexity import (
+        ChatPerplexity,  # noqa: F401
+    )
+    from langchain_community.chat_models.premai import (
+        ChatPremAI,  # noqa: F401
+    )
+    from langchain_community.chat_models.promptlayer_openai import (
+        PromptLayerChatOpenAI,  # noqa: F401
+    )
+    from langchain_community.chat_models.solar import (
+        SolarChat,  # noqa: F401
+    )
+    from langchain_community.chat_models.sparkllm import (
+        ChatSparkLLM,  # noqa: F401
+    )
+    from langchain_community.chat_models.tongyi import (
+        ChatTongyi,  # noqa: F401
+    )
+    from langchain_community.chat_models.vertexai import (
+        ChatVertexAI,  # noqa: F401
+    )
+    from langchain_community.chat_models.volcengine_maas import (
+        VolcEngineMaasChat,  # noqa: F401
+    )
+    from langchain_community.chat_models.yandex import (
+        ChatYandexGPT,  # noqa: F401
+    )
+    from langchain_community.chat_models.yuan2 import (
+        ChatYuan2,  # noqa: F401
+    )
+    from langchain_community.chat_models.zhipuai import (
+        ChatZhipuAI,  # noqa: F401
+    )
+
+__all__ = [
+    "AzureChatOpenAI",
+    "BedrockChat",
+    "ChatAnthropic",
+    "ChatAnyscale",
+    "ChatBaichuan",
+    "ChatCohere",
+    "ChatDatabricks",
+    "ChatDeepInfra",
+    "ChatEverlyAI",
+    "ChatFireworks",
+    "ChatFriendli",
+    "ChatGooglePalm",
+    "ChatHuggingFace",
+    "ChatHunyuan",
+    "ChatJavelinAIGateway",
+    "ChatKinetica",
+    "ChatKonko",
+    "ChatLiteLLM",
+    "ChatLiteLLMRouter",
+    "ChatMLX",
+    "ChatMLflowAIGateway",
+    "ChatMaritalk",
+    "ChatMlflow",
+    "ChatOllama",
+    "ChatOpenAI",
+    "ChatPerplexity",
+    "ChatPremAI",
+    "ChatSparkLLM",
+    "ChatTongyi",
+    "ChatVertexAI",
+    "ChatYandexGPT",
+    "ChatYuan2",
+    "ChatZhipuAI",
+    "ErnieBotChat",
+    "FakeListChatModel",
+    "GPTRouter",
+    "GigaChat",
+    "HumanInputChatModel",
+    "JinaChat",
+    "LlamaEdgeChatService",
+    "MiniMaxChat",
+    "PaiEasChatEndpoint",
+    "PromptLayerChatOpenAI",
+    "QianfanChatEndpoint",
+    "SolarChat",
+    "VolcEngineMaasChat",
+]
+
+
+_module_lookup = {
+    "AzureChatOpenAI": "langchain_community.chat_models.azure_openai",
+    "BedrockChat": "langchain_community.chat_models.bedrock",
+    "ChatAnthropic": "langchain_community.chat_models.anthropic",
+    "ChatAnyscale": "langchain_community.chat_models.anyscale",
+    "ChatBaichuan": "langchain_community.chat_models.baichuan",
+    "ChatCohere": "langchain_community.chat_models.cohere",
+    "ChatDatabricks": "langchain_community.chat_models.databricks",
+    "ChatDeepInfra": "langchain_community.chat_models.deepinfra",
+    "ChatEverlyAI": "langchain_community.chat_models.everlyai",
+    "ChatFireworks": "langchain_community.chat_models.fireworks",
+    "ChatFriendli": "langchain_community.chat_models.friendli",
+    "ChatGooglePalm": "langchain_community.chat_models.google_palm",
+    "ChatHuggingFace": "langchain_community.chat_models.huggingface",
+    "ChatHunyuan": "langchain_community.chat_models.hunyuan",
+    "ChatJavelinAIGateway": "langchain_community.chat_models.javelin_ai_gateway",
+    "ChatKinetica": "langchain_community.chat_models.kinetica",
+    "ChatKonko": "langchain_community.chat_models.konko",
+    "ChatLiteLLM": "langchain_community.chat_models.litellm",
+    "ChatLiteLLMRouter": "langchain_community.chat_models.litellm_router",
+    "ChatMLflowAIGateway": "langchain_community.chat_models.mlflow_ai_gateway",
+    "ChatMLX": "langchain_community.chat_models.mlx",
+    "ChatMaritalk": "langchain_community.chat_models.maritalk",
+    "ChatMlflow": "langchain_community.chat_models.mlflow",
+    "ChatOctoAI": "langchain_community.chat_models.octoai",
+    "ChatOllama": "langchain_community.chat_models.ollama",
+    "ChatOpenAI": "langchain_community.chat_models.openai",
+    "ChatPerplexity": "langchain_community.chat_models.perplexity",
+    "ChatSparkLLM": "langchain_community.chat_models.sparkllm",
+    "ChatTongyi": "langchain_community.chat_models.tongyi",
+    "ChatVertexAI": "langchain_community.chat_models.vertexai",
+    "ChatYandexGPT": "langchain_community.chat_models.yandex",
+    "ChatYuan2": "langchain_community.chat_models.yuan2",
+    "ChatZhipuAI": "langchain_community.chat_models.zhipuai",
+    "ErnieBotChat": "langchain_community.chat_models.ernie",
+    "FakeListChatModel": "langchain_community.chat_models.fake",
+    "GPTRouter": "langchain_community.chat_models.gpt_router",
+    "GigaChat": "langchain_community.chat_models.gigachat",
+    "HumanInputChatModel": "langchain_community.chat_models.human",
+    "JinaChat": "langchain_community.chat_models.jinachat",
+    "LlamaEdgeChatService": "langchain_community.chat_models.llama_edge",
+    "MiniMaxChat": "langchain_community.chat_models.minimax",
+    "PaiEasChatEndpoint": "langchain_community.chat_models.pai_eas_endpoint",
+    "PromptLayerChatOpenAI": "langchain_community.chat_models.promptlayer_openai",
+    "SolarChat": "langchain_community.chat_models.solar",
+    "QianfanChatEndpoint": "langchain_community.chat_models.baidu_qianfan_endpoint",
+    "VolcEngineMaasChat": "langchain_community.chat_models.volcengine_maas",
+    "ChatPremAI": "langchain_community.chat_models.premai",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..509f52227ee7f6a020171ca017f874a08bc78565
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/anthropic.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/anthropic.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9e6eee8315bc64c4365da94a450f72c6897dab53
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/anthropic.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/anyscale.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/anyscale.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fb66d30dc5313d50df06883e1ba5cdbb2724a64e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/anyscale.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/azure_openai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/azure_openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b4f5ec134129f4a3dc4682e525cc2ffd1be06aee
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/azure_openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/azureml_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/azureml_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f7363230d7f9d817d3ad2d0a628e810d2c229cef
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/azureml_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/baichuan.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/baichuan.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..552e1c3b9f42ecd9cedb0dd6adc6479856b72e00
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/baichuan.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..367a7e1e04c25b4269292959ede8d22bdd1e47a1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/bedrock.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/bedrock.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d13e9ecb144b36650ab416a4dcc420e7b4f06151
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/bedrock.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/cohere.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/cohere.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a82026719c92135600900e47eded2474db2822a8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/cohere.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/dappier.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/dappier.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1b6b5c2f52faa338203e3d579d0bb94975fea481
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/dappier.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/databricks.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/databricks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b7d9f4574448d80f18f7546eddc78ad00c1387fb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/databricks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/deepinfra.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/deepinfra.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..75c596997ff7c4cb8ac53253b17c2ff72c10a744
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/deepinfra.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/edenai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/edenai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8d54c62759f29b0f8baee7bee597c6afd2442052
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/edenai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/ernie.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/ernie.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..32fbe32492c1df93e8375f058b3899049a3fbe4e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/ernie.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/everlyai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/everlyai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..483dd4216027436ae998e91eff399b54bb8849cf
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/everlyai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/fake.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/fake.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5af69df361786a73d80e2f5492b1d40882bb1adc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/fake.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/fireworks.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/fireworks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0dcb4db010618bbf3f01472a4a2a545765faaa6d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/fireworks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/friendli.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/friendli.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..995fb67a7f4efd4c615a3622ac0b67178f58d027
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/friendli.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/gigachat.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/gigachat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ae9eb65ffa74542dbc5be7266cc17211da368d95
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/gigachat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/google_palm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/google_palm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e037ad9feefd753d4175ce4c07edf3cbf00bb2fc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/google_palm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/gpt_router.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/gpt_router.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4cf2c97287d03f2081dc6e9917bde13193e11f4a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/gpt_router.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/huggingface.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/huggingface.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8ec4a67a9e3d4e1c290b764fe330ae872fd18348
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/huggingface.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/human.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/human.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..710115081d1e6451053d10d5f8fdc1bdc8cc48b4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/human.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/hunyuan.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/hunyuan.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b7504dc1b7474dfb061d446751cf8936bdf8c0eb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/hunyuan.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/javelin_ai_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/javelin_ai_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a693224803430c103ae18e267da60cf1e93bba51
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/javelin_ai_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/jinachat.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/jinachat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5135985fe13fae1dda6c27fb2a038215de3e1f42
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/jinachat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/kinetica.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/kinetica.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e9c0a42f2facf9d1aa3d9f02d7aa2ad60523f9e3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/kinetica.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/konko.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/konko.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6ebf4b5886d752f7bba8f5ab825e87d1671b204c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/konko.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/litellm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/litellm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..34018955ca6873d9c041d2a4b5a2a0238db6c0e1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/litellm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/litellm_router.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/litellm_router.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..edd95f9ddc43d356ed3fcf75c4e2870011e28b26
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/litellm_router.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/llama_edge.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/llama_edge.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..06e6d9905a4be8e302ba44e2eb7fd97d36c32cb8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/llama_edge.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/maritalk.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/maritalk.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d6c9cd38e79be80e4ef329ca7733cb9c2f6be8e0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/maritalk.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/meta.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/meta.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..18e55f535cf6db2bc4bccd1ab34b8302a136a5d7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/meta.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/minimax.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/minimax.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..acfc1feda58c6acba4b25cc319efc1c22a663448
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/minimax.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/mlflow.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/mlflow.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2d8044ce7a1f4ae9a492efa045b103a949115db0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/mlflow.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/mlflow_ai_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/mlflow_ai_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..02c2fdfe212f4e5e68497326731ec90cbd1b9fd8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/mlflow_ai_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/mlx.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/mlx.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..97a17d5a8497beddae24ad59ab66e7743d8789ae
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/mlx.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/moonshot.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/moonshot.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a693e270e37f6de3af7636c774faeb7a6690d96c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/moonshot.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/octoai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/octoai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..081bead2ce60d89e4c9798183e7e291ca36fb812
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/octoai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/ollama.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/ollama.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cebdee3f7546b5ca6d0d9fb4e79eca1666fe364d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/ollama.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/openai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f0b4c3b81ca43aa810ec1ebfce3dd9d46d73057b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/pai_eas_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/pai_eas_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3f1c3659e66db7d083217c24892978f91243e038
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/pai_eas_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/perplexity.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/perplexity.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..67c0376b0b0baad1b93464f764ab5ae6ca9cf522
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/perplexity.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/premai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/premai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d14bd5e9bbe2c18bd38ad5daa96d8c0984043d17
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/premai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/promptlayer_openai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/promptlayer_openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1b025ccb6e7cd2d0b675a796a1acc83363027c83
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/promptlayer_openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/solar.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/solar.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3d2d71c740fffcf47c97221341018395633e498c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/solar.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/sparkllm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/sparkllm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a473fef8e989138a2b4133cd01f837b1a688af15
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/sparkllm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/tongyi.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/tongyi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d10c9fec072388f1a6ef87c60b32a8db720f41b0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/tongyi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/vertexai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/vertexai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..260e7f2456b4c1f67200bb39e770e24873300dd9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/vertexai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/volcengine_maas.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/volcengine_maas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b3fbd22361994e3d40692a5500aa4d7e0c60b1e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/volcengine_maas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/yandex.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/yandex.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f04bcb7dc17356c5882bf2d8ef9b4897ad4708e3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/yandex.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/yuan2.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/yuan2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1978a3a214b139cf266824591c8fdc7b5683a2e9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/yuan2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/zhipuai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/zhipuai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..66f556b7862ac603259e83c3acc2b4709447e01a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/chat_models/__pycache__/zhipuai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/anthropic.py b/llm/Lib/site-packages/langchain_community/chat_models/anthropic.py
new file mode 100644
index 0000000000000000000000000000000000000000..d3018161083c37f27ffbaf1ce88d18b43c98d818
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/anthropic.py
@@ -0,0 +1,234 @@
+from typing import Any, AsyncIterator, Dict, Iterator, List, Optional, cast
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    ChatMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.prompt_values import PromptValue
+
+from langchain_community.llms.anthropic import _AnthropicCommon
+
+
+def _convert_one_message_to_text(
+    message: BaseMessage,
+    human_prompt: str,
+    ai_prompt: str,
+) -> str:
+    content = cast(str, message.content)
+    if isinstance(message, ChatMessage):
+        message_text = f"\n\n{message.role.capitalize()}: {content}"
+    elif isinstance(message, HumanMessage):
+        message_text = f"{human_prompt} {content}"
+    elif isinstance(message, AIMessage):
+        message_text = f"{ai_prompt} {content}"
+    elif isinstance(message, SystemMessage):
+        message_text = content
+    else:
+        raise ValueError(f"Got unknown type {message}")
+    return message_text
+
+
+def convert_messages_to_prompt_anthropic(
+    messages: List[BaseMessage],
+    *,
+    human_prompt: str = "\n\nHuman:",
+    ai_prompt: str = "\n\nAssistant:",
+) -> str:
+    """Format a list of messages into a full prompt for the Anthropic model
+    Args:
+        messages (List[BaseMessage]): List of BaseMessage to combine.
+        human_prompt (str, optional): Human prompt tag. Defaults to "\n\nHuman:".
+        ai_prompt (str, optional): AI prompt tag. Defaults to "\n\nAssistant:".
+    Returns:
+        str: Combined string with necessary human_prompt and ai_prompt tags.
+    """
+
+    messages = messages.copy()  # don't mutate the original list
+    if not isinstance(messages[-1], AIMessage):
+        messages.append(AIMessage(content=""))
+
+    text = "".join(
+        _convert_one_message_to_text(message, human_prompt, ai_prompt)
+        for message in messages
+    )
+
+    # trim off the trailing ' ' that might come from the "Assistant: "
+    return text.rstrip()
+
+
+@deprecated(
+    since="0.0.28",
+    removal="0.2",
+    alternative_import="langchain_anthropic.ChatAnthropic",
+)
+class ChatAnthropic(BaseChatModel, _AnthropicCommon):
+    """`Anthropic` chat large language models.
+
+    To use, you should have the ``anthropic`` python package installed, and the
+    environment variable ``ANTHROPIC_API_KEY`` set with your API key, or pass
+    it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            import anthropic
+            from langchain_community.chat_models import ChatAnthropic
+            model = ChatAnthropic(model="<model_name>", anthropic_api_key="my-api-key")
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+        arbitrary_types_allowed = True
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"anthropic_api_key": "ANTHROPIC_API_KEY"}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "anthropic-chat"
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this model can be serialized by Langchain."""
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "chat_models", "anthropic"]
+
+    def _convert_messages_to_prompt(self, messages: List[BaseMessage]) -> str:
+        """Format a list of messages into a full prompt for the Anthropic model
+        Args:
+            messages (List[BaseMessage]): List of BaseMessage to combine.
+        Returns:
+            str: Combined string with necessary HUMAN_PROMPT and AI_PROMPT tags.
+        """
+        prompt_params = {}
+        if self.HUMAN_PROMPT:
+            prompt_params["human_prompt"] = self.HUMAN_PROMPT
+        if self.AI_PROMPT:
+            prompt_params["ai_prompt"] = self.AI_PROMPT
+        return convert_messages_to_prompt_anthropic(messages=messages, **prompt_params)
+
+    def convert_prompt(self, prompt: PromptValue) -> str:
+        return self._convert_messages_to_prompt(prompt.to_messages())
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        prompt = self._convert_messages_to_prompt(messages)
+        params: Dict[str, Any] = {"prompt": prompt, **self._default_params, **kwargs}
+        if stop:
+            params["stop_sequences"] = stop
+
+        stream_resp = self.client.completions.create(**params, stream=True)
+        for data in stream_resp:
+            delta = data.completion
+            chunk = ChatGenerationChunk(message=AIMessageChunk(content=delta))
+            if run_manager:
+                run_manager.on_llm_new_token(delta, chunk=chunk)
+            yield chunk
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        prompt = self._convert_messages_to_prompt(messages)
+        params: Dict[str, Any] = {"prompt": prompt, **self._default_params, **kwargs}
+        if stop:
+            params["stop_sequences"] = stop
+
+        stream_resp = await self.async_client.completions.create(**params, stream=True)
+        async for data in stream_resp:
+            delta = data.completion
+            chunk = ChatGenerationChunk(message=AIMessageChunk(content=delta))
+            if run_manager:
+                await run_manager.on_llm_new_token(delta, chunk=chunk)
+            yield chunk
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+        prompt = self._convert_messages_to_prompt(
+            messages,
+        )
+        params: Dict[str, Any] = {
+            "prompt": prompt,
+            **self._default_params,
+            **kwargs,
+        }
+        if stop:
+            params["stop_sequences"] = stop
+        response = self.client.completions.create(**params)
+        completion = response.completion
+        message = AIMessage(content=completion)
+        return ChatResult(generations=[ChatGeneration(message=message)])
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._astream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+        prompt = self._convert_messages_to_prompt(
+            messages,
+        )
+        params: Dict[str, Any] = {
+            "prompt": prompt,
+            **self._default_params,
+            **kwargs,
+        }
+        if stop:
+            params["stop_sequences"] = stop
+        response = await self.async_client.completions.create(**params)
+        completion = response.completion
+        message = AIMessage(content=completion)
+        return ChatResult(generations=[ChatGeneration(message=message)])
+
+    def get_num_tokens(self, text: str) -> int:
+        """Calculate number of tokens."""
+        if not self.count_tokens:
+            raise NameError("Please ensure the anthropic package is loaded")
+        return self.count_tokens(text)
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/anyscale.py b/llm/Lib/site-packages/langchain_community/chat_models/anyscale.py
new file mode 100644
index 0000000000000000000000000000000000000000..214b77c30fbf1cbb7e8f1c8243846c0d07fbba40
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/anyscale.py
@@ -0,0 +1,219 @@
+"""Anyscale Endpoints chat wrapper. Relies heavily on ChatOpenAI."""
+from __future__ import annotations
+
+import logging
+import os
+import sys
+from typing import TYPE_CHECKING, Dict, Optional, Set
+
+import requests
+from langchain_core.messages import BaseMessage
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.adapters.openai import convert_message_to_dict
+from langchain_community.chat_models.openai import (
+    ChatOpenAI,
+    _import_tiktoken,
+)
+from langchain_community.utils.openai import is_openai_v1
+
+if TYPE_CHECKING:
+    import tiktoken
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_API_BASE = "https://api.endpoints.anyscale.com/v1"
+DEFAULT_MODEL = "meta-llama/Llama-2-7b-chat-hf"
+
+
+class ChatAnyscale(ChatOpenAI):
+    """`Anyscale` Chat large language models.
+
+    See https://www.anyscale.com/ for information about Anyscale.
+
+    To use, you should have the ``openai`` python package installed, and the
+    environment variable ``ANYSCALE_API_KEY`` set with your API key.
+    Alternatively, you can use the anyscale_api_key keyword argument.
+
+    Any parameters that are valid to be passed to the `openai.create` call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatAnyscale
+            chat = ChatAnyscale(model_name="meta-llama/Llama-2-7b-chat-hf")
+    """
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "anyscale-chat"
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"anyscale_api_key": "ANYSCALE_API_KEY"}
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    anyscale_api_key: SecretStr = Field(default=None)
+    """AnyScale Endpoints API keys."""
+    model_name: str = Field(default=DEFAULT_MODEL, alias="model")
+    """Model name to use."""
+    anyscale_api_base: str = Field(default=DEFAULT_API_BASE)
+    """Base URL path for API requests,
+    leave blank if not using a proxy or service emulator."""
+    anyscale_proxy: Optional[str] = None
+    """To support explicit proxy for Anyscale."""
+    available_models: Optional[Set[str]] = None
+    """Available models from Anyscale API."""
+
+    @staticmethod
+    def get_available_models(
+        anyscale_api_key: Optional[str] = None,
+        anyscale_api_base: str = DEFAULT_API_BASE,
+    ) -> Set[str]:
+        """Get available models from Anyscale API."""
+        try:
+            anyscale_api_key = anyscale_api_key or os.environ["ANYSCALE_API_KEY"]
+        except KeyError as e:
+            raise ValueError(
+                "Anyscale API key must be passed as keyword argument or "
+                "set in environment variable ANYSCALE_API_KEY.",
+            ) from e
+
+        models_url = f"{anyscale_api_base}/models"
+        models_response = requests.get(
+            models_url,
+            headers={
+                "Authorization": f"Bearer {anyscale_api_key}",
+            },
+        )
+
+        if models_response.status_code != 200:
+            raise ValueError(
+                f"Error getting models from {models_url}: "
+                f"{models_response.status_code}",
+            )
+
+        return {model["id"] for model in models_response.json()["data"]}
+
+    @root_validator()
+    def validate_environment(cls, values: dict) -> dict:
+        """Validate that api key and python package exists in environment."""
+        values["anyscale_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "anyscale_api_key",
+                "ANYSCALE_API_KEY",
+            )
+        )
+        values["anyscale_api_base"] = get_from_dict_or_env(
+            values,
+            "anyscale_api_base",
+            "ANYSCALE_API_BASE",
+            default=DEFAULT_API_BASE,
+        )
+        values["openai_proxy"] = get_from_dict_or_env(
+            values,
+            "anyscale_proxy",
+            "ANYSCALE_PROXY",
+            default="",
+        )
+        try:
+            import openai
+
+        except ImportError as e:
+            raise ValueError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`.",
+            ) from e
+        try:
+            if is_openai_v1():
+                client_params = {
+                    "api_key": values["anyscale_api_key"].get_secret_value(),
+                    "base_url": values["anyscale_api_base"],
+                    # To do: future support
+                    # "organization": values["openai_organization"],
+                    # "timeout": values["request_timeout"],
+                    # "max_retries": values["max_retries"],
+                    # "default_headers": values["default_headers"],
+                    # "default_query": values["default_query"],
+                    # "http_client": values["http_client"],
+                }
+                if not values.get("client"):
+                    values["client"] = openai.OpenAI(**client_params).chat.completions
+                if not values.get("async_client"):
+                    values["async_client"] = openai.AsyncOpenAI(
+                        **client_params
+                    ).chat.completions
+            else:
+                values["openai_api_base"] = values["anyscale_api_base"]
+                values["openai_api_key"] = values["anyscale_api_key"].get_secret_value()
+                values["client"] = openai.ChatCompletion
+        except AttributeError as exc:
+            raise ValueError(
+                "`openai` has no `ChatCompletion` attribute, this is likely "
+                "due to an old version of the openai package. Try upgrading it "
+                "with `pip install --upgrade openai`.",
+            ) from exc
+
+        if "model_name" not in values.keys():
+            values["model_name"] = DEFAULT_MODEL
+
+        model_name = values["model_name"]
+        available_models = cls.get_available_models(
+            values["anyscale_api_key"].get_secret_value(),
+            values["anyscale_api_base"],
+        )
+
+        if model_name not in available_models:
+            raise ValueError(
+                f"Model name {model_name} not found in available models: "
+                f"{available_models}.",
+            )
+
+        values["available_models"] = available_models
+
+        return values
+
+    def _get_encoding_model(self) -> tuple[str, tiktoken.Encoding]:
+        tiktoken_ = _import_tiktoken()
+        if self.tiktoken_model_name is not None:
+            model = self.tiktoken_model_name
+        else:
+            model = self.model_name
+        # Returns the number of tokens used by a list of messages.
+        try:
+            encoding = tiktoken_.encoding_for_model("gpt-3.5-turbo-0301")
+        except KeyError:
+            logger.warning("Warning: model not found. Using cl100k_base encoding.")
+            model = "cl100k_base"
+            encoding = tiktoken_.get_encoding(model)
+        return model, encoding
+
+    def get_num_tokens_from_messages(self, messages: list[BaseMessage]) -> int:
+        """Calculate num tokens with tiktoken package.
+        Official documentation: https://github.com/openai/openai-cookbook/blob/main/examples/How_to_format_inputs_to_ChatGPT_models.ipynb
+        """
+        if sys.version_info[1] <= 7:
+            return super().get_num_tokens_from_messages(messages)
+        model, encoding = self._get_encoding_model()
+        tokens_per_message = 3
+        tokens_per_name = 1
+        num_tokens = 0
+        messages_dict = [convert_message_to_dict(m) for m in messages]
+        for message in messages_dict:
+            num_tokens += tokens_per_message
+            for key, value in message.items():
+                # Cast str(value) in case the message value is not a string
+                # This occurs with function messages
+                num_tokens += len(encoding.encode(str(value)))
+                if key == "name":
+                    num_tokens += tokens_per_name
+        # every reply is primed with <im_start>assistant
+        num_tokens += 3
+        return num_tokens
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/azure_openai.py b/llm/Lib/site-packages/langchain_community/chat_models/azure_openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..0db36ad947f8a92e1bcf6df2f6d0566e483402e5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/azure_openai.py
@@ -0,0 +1,277 @@
+"""Azure OpenAI chat wrapper."""
+from __future__ import annotations
+
+import logging
+import os
+import warnings
+from typing import Any, Callable, Dict, List, Union
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.outputs import ChatResult
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.chat_models.openai import ChatOpenAI
+from langchain_community.utils.openai import is_openai_v1
+
+logger = logging.getLogger(__name__)
+
+
+@deprecated(
+    since="0.0.10",
+    removal="0.2.0",
+    alternative_import="langchain_openai.AzureChatOpenAI",
+)
+class AzureChatOpenAI(ChatOpenAI):
+    """`Azure OpenAI` Chat Completion API.
+
+    To use this class you
+    must have a deployed model on Azure OpenAI. Use `deployment_name` in the
+    constructor to refer to the "Model deployment name" in the Azure portal.
+
+    In addition, you should have the ``openai`` python package installed, and the
+    following environment variables set or passed in constructor in lower case:
+    - ``AZURE_OPENAI_API_KEY``
+    - ``AZURE_OPENAI_ENDPOINT``
+    - ``AZURE_OPENAI_AD_TOKEN``
+    - ``OPENAI_API_VERSION``
+    - ``OPENAI_PROXY``
+
+    For example, if you have `gpt-35-turbo` deployed, with the deployment name
+    `35-turbo-dev`, the constructor should look like:
+
+    .. code-block:: python
+
+        AzureChatOpenAI(
+            azure_deployment="35-turbo-dev",
+            openai_api_version="2023-05-15",
+        )
+
+    Be aware the API version may change.
+
+    You can also specify the version of the model using ``model_version`` constructor
+    parameter, as Azure OpenAI doesn't return model version with the response.
+
+    Default is empty. When you specify the version, it will be appended to the
+    model name in the response. Setting correct version will help you to calculate the
+    cost properly. Model version is not validated, so make sure you set it correctly
+    to get the correct cost.
+
+    Any parameters that are valid to be passed to the openai.create call can be passed
+    in, even if not explicitly saved on this class.
+    """
+
+    azure_endpoint: Union[str, None] = None
+    """Your Azure endpoint, including the resource.
+    
+        Automatically inferred from env var `AZURE_OPENAI_ENDPOINT` if not provided.
+    
+        Example: `https://example-resource.azure.openai.com/`
+    """
+    deployment_name: Union[str, None] = Field(default=None, alias="azure_deployment")
+    """A model deployment. 
+    
+        If given sets the base client URL to include `/deployments/{azure_deployment}`.
+        Note: this means you won't be able to use non-deployment endpoints.
+    """
+    openai_api_version: str = Field(default="", alias="api_version")
+    """Automatically inferred from env var `OPENAI_API_VERSION` if not provided."""
+    openai_api_key: Union[str, None] = Field(default=None, alias="api_key")
+    """Automatically inferred from env var `AZURE_OPENAI_API_KEY` if not provided."""
+    azure_ad_token: Union[str, None] = None
+    """Your Azure Active Directory token.
+    
+        Automatically inferred from env var `AZURE_OPENAI_AD_TOKEN` if not provided.
+        
+        For more: 
+        https://www.microsoft.com/en-us/security/business/identity-access/microsoft-entra-id.
+    """  # noqa: E501
+    azure_ad_token_provider: Union[Callable[[], str], None] = None
+    """A function that returns an Azure Active Directory token.
+        
+        Will be invoked on every request.
+    """
+    model_version: str = ""
+    """Legacy, for openai<1.0.0 support."""
+    openai_api_type: str = ""
+    """Legacy, for openai<1.0.0 support."""
+    validate_base_url: bool = True
+    """For backwards compatibility. If legacy val openai_api_base is passed in, try to 
+        infer if it is a base_url or azure_endpoint and update accordingly.
+    """
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "chat_models", "azure_openai"]
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        if values["n"] < 1:
+            raise ValueError("n must be at least 1.")
+        if values["n"] > 1 and values["streaming"]:
+            raise ValueError("n must be 1 when streaming.")
+
+        # Check OPENAI_KEY for backwards compatibility.
+        # TODO: Remove OPENAI_API_KEY support to avoid possible conflict when using
+        # other forms of azure credentials.
+        values["openai_api_key"] = (
+            values["openai_api_key"]
+            or os.getenv("AZURE_OPENAI_API_KEY")
+            or os.getenv("OPENAI_API_KEY")
+        )
+        values["openai_api_base"] = values["openai_api_base"] or os.getenv(
+            "OPENAI_API_BASE"
+        )
+        values["openai_api_version"] = values["openai_api_version"] or os.getenv(
+            "OPENAI_API_VERSION"
+        )
+        # Check OPENAI_ORGANIZATION for backwards compatibility.
+        values["openai_organization"] = (
+            values["openai_organization"]
+            or os.getenv("OPENAI_ORG_ID")
+            or os.getenv("OPENAI_ORGANIZATION")
+        )
+        values["azure_endpoint"] = values["azure_endpoint"] or os.getenv(
+            "AZURE_OPENAI_ENDPOINT"
+        )
+        values["azure_ad_token"] = values["azure_ad_token"] or os.getenv(
+            "AZURE_OPENAI_AD_TOKEN"
+        )
+
+        values["openai_api_type"] = get_from_dict_or_env(
+            values, "openai_api_type", "OPENAI_API_TYPE", default="azure"
+        )
+        values["openai_proxy"] = get_from_dict_or_env(
+            values, "openai_proxy", "OPENAI_PROXY", default=""
+        )
+
+        try:
+            import openai
+
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+        if is_openai_v1():
+            # For backwards compatibility. Before openai v1, no distinction was made
+            # between azure_endpoint and base_url (openai_api_base).
+            openai_api_base = values["openai_api_base"]
+            if openai_api_base and values["validate_base_url"]:
+                if "/openai" not in openai_api_base:
+                    values["openai_api_base"] = (
+                        values["openai_api_base"].rstrip("/") + "/openai"
+                    )
+                    warnings.warn(
+                        "As of openai>=1.0.0, Azure endpoints should be specified via "
+                        f"the `azure_endpoint` param not `openai_api_base` "
+                        f"(or alias `base_url`). Updating `openai_api_base` from "
+                        f"{openai_api_base} to {values['openai_api_base']}."
+                    )
+                if values["deployment_name"]:
+                    warnings.warn(
+                        "As of openai>=1.0.0, if `deployment_name` (or alias "
+                        "`azure_deployment`) is specified then "
+                        "`openai_api_base` (or alias `base_url`) should not be. "
+                        "Instead use `deployment_name` (or alias `azure_deployment`) "
+                        "and `azure_endpoint`."
+                    )
+                    if values["deployment_name"] not in values["openai_api_base"]:
+                        warnings.warn(
+                            "As of openai>=1.0.0, if `openai_api_base` "
+                            "(or alias `base_url`) is specified it is expected to be "
+                            "of the form "
+                            "https://example-resource.azure.openai.com/openai/deployments/example-deployment. "  # noqa: E501
+                            f"Updating {openai_api_base} to "
+                            f"{values['openai_api_base']}."
+                        )
+                        values["openai_api_base"] += (
+                            "/deployments/" + values["deployment_name"]
+                        )
+                    values["deployment_name"] = None
+            client_params = {
+                "api_version": values["openai_api_version"],
+                "azure_endpoint": values["azure_endpoint"],
+                "azure_deployment": values["deployment_name"],
+                "api_key": values["openai_api_key"],
+                "azure_ad_token": values["azure_ad_token"],
+                "azure_ad_token_provider": values["azure_ad_token_provider"],
+                "organization": values["openai_organization"],
+                "base_url": values["openai_api_base"],
+                "timeout": values["request_timeout"],
+                "max_retries": values["max_retries"],
+                "default_headers": values["default_headers"],
+                "default_query": values["default_query"],
+                "http_client": values["http_client"],
+            }
+            values["client"] = openai.AzureOpenAI(**client_params).chat.completions
+            values["async_client"] = openai.AsyncAzureOpenAI(
+                **client_params
+            ).chat.completions
+        else:
+            values["client"] = openai.ChatCompletion
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling OpenAI API."""
+        if is_openai_v1():
+            return super()._default_params
+        else:
+            return {
+                **super()._default_params,
+                "engine": self.deployment_name,
+            }
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {**self._default_params}
+
+    @property
+    def _client_params(self) -> Dict[str, Any]:
+        """Get the config params used for the openai client."""
+        if is_openai_v1():
+            return super()._client_params
+        else:
+            return {
+                **super()._client_params,
+                "api_type": self.openai_api_type,
+                "api_version": self.openai_api_version,
+            }
+
+    @property
+    def _llm_type(self) -> str:
+        return "azure-openai-chat"
+
+    @property
+    def lc_attributes(self) -> Dict[str, Any]:
+        return {
+            "openai_api_type": self.openai_api_type,
+            "openai_api_version": self.openai_api_version,
+        }
+
+    def _create_chat_result(self, response: Union[dict, BaseModel]) -> ChatResult:
+        if not isinstance(response, dict):
+            response = response.dict()
+        for res in response["choices"]:
+            if res.get("finish_reason", None) == "content_filter":
+                raise ValueError(
+                    "Azure has not provided the response due to a content filter "
+                    "being triggered"
+                )
+        chat_result = super()._create_chat_result(response)
+
+        if "model" in response:
+            model = response["model"]
+            if self.model_version:
+                model = f"{model}-{self.model_version}"
+
+            if chat_result.llm_output is not None and isinstance(
+                chat_result.llm_output, dict
+            ):
+                chat_result.llm_output["model_name"] = model
+
+        return chat_result
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/azureml_endpoint.py b/llm/Lib/site-packages/langchain_community/chat_models/azureml_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..e2ea9d775c7a4cb966d915e8e387deff2653a7c1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/azureml_endpoint.py
@@ -0,0 +1,422 @@
+import json
+import warnings
+from typing import (
+    Any,
+    AsyncIterator,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Type,
+    cast,
+)
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    FunctionMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+    SystemMessageChunk,
+    ToolMessageChunk,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+
+from langchain_community.llms.azureml_endpoint import (
+    AzureMLBaseEndpoint,
+    AzureMLEndpointApiType,
+    ContentFormatterBase,
+)
+
+
+class LlamaContentFormatter(ContentFormatterBase):
+    """Content formatter for `LLaMA`."""
+
+    def __init__(self) -> None:
+        raise TypeError(
+            "`LlamaContentFormatter` is deprecated for chat models. Use "
+            "`CustomOpenAIContentFormatter` instead."
+        )
+
+
+class CustomOpenAIChatContentFormatter(ContentFormatterBase):
+    """Chat Content formatter for models with OpenAI like API scheme."""
+
+    SUPPORTED_ROLES: List[str] = ["user", "assistant", "system"]
+
+    @staticmethod
+    def _convert_message_to_dict(message: BaseMessage) -> Dict:
+        """Converts a message to a dict according to a role"""
+        content = cast(str, message.content)
+        if isinstance(message, HumanMessage):
+            return {
+                "role": "user",
+                "content": ContentFormatterBase.escape_special_characters(content),
+            }
+        elif isinstance(message, AIMessage):
+            return {
+                "role": "assistant",
+                "content": ContentFormatterBase.escape_special_characters(content),
+            }
+        elif isinstance(message, SystemMessage):
+            return {
+                "role": "system",
+                "content": ContentFormatterBase.escape_special_characters(content),
+            }
+        elif (
+            isinstance(message, ChatMessage)
+            and message.role in CustomOpenAIChatContentFormatter.SUPPORTED_ROLES
+        ):
+            return {
+                "role": message.role,
+                "content": ContentFormatterBase.escape_special_characters(content),
+            }
+        else:
+            supported = ",".join(
+                [role for role in CustomOpenAIChatContentFormatter.SUPPORTED_ROLES]
+            )
+            raise ValueError(
+                f"""Received unsupported role. 
+                Supported roles for the LLaMa Foundation Model: {supported}"""
+            )
+
+    @property
+    def supported_api_types(self) -> List[AzureMLEndpointApiType]:
+        return [AzureMLEndpointApiType.dedicated, AzureMLEndpointApiType.serverless]
+
+    def format_messages_request_payload(
+        self,
+        messages: List[BaseMessage],
+        model_kwargs: Dict,
+        api_type: AzureMLEndpointApiType,
+    ) -> bytes:
+        """Formats the request according to the chosen api"""
+        chat_messages = [
+            CustomOpenAIChatContentFormatter._convert_message_to_dict(message)
+            for message in messages
+        ]
+        if api_type in [
+            AzureMLEndpointApiType.dedicated,
+            AzureMLEndpointApiType.realtime,
+        ]:
+            request_payload = json.dumps(
+                {
+                    "input_data": {
+                        "input_string": chat_messages,
+                        "parameters": model_kwargs,
+                    }
+                }
+            )
+        elif api_type == AzureMLEndpointApiType.serverless:
+            request_payload = json.dumps({"messages": chat_messages, **model_kwargs})
+        else:
+            raise ValueError(
+                f"`api_type` {api_type} is not supported by this formatter"
+            )
+        return str.encode(request_payload)
+
+    def format_response_payload(
+        self,
+        output: bytes,
+        api_type: AzureMLEndpointApiType = AzureMLEndpointApiType.dedicated,
+    ) -> ChatGeneration:
+        """Formats response"""
+        if api_type in [
+            AzureMLEndpointApiType.dedicated,
+            AzureMLEndpointApiType.realtime,
+        ]:
+            try:
+                choice = json.loads(output)["output"]
+            except (KeyError, IndexError, TypeError) as e:
+                raise ValueError(self.format_error_msg.format(api_type=api_type)) from e
+            return ChatGeneration(
+                message=BaseMessage(
+                    content=choice.strip(),
+                    type="assistant",
+                ),
+                generation_info=None,
+            )
+        if api_type == AzureMLEndpointApiType.serverless:
+            try:
+                choice = json.loads(output)["choices"][0]
+                if not isinstance(choice, dict):
+                    raise TypeError(
+                        "Endpoint response is not well formed for a chat "
+                        "model. Expected `dict` but `{type(choice)}` was received."
+                    )
+            except (KeyError, IndexError, TypeError) as e:
+                raise ValueError(self.format_error_msg.format(api_type=api_type)) from e
+            return ChatGeneration(
+                message=BaseMessage(
+                    content=choice["message"]["content"].strip(),
+                    type=choice["message"]["role"],
+                ),
+                generation_info=dict(
+                    finish_reason=choice.get("finish_reason"),
+                    logprobs=choice.get("logprobs"),
+                ),
+            )
+        raise ValueError(f"`api_type` {api_type} is not supported by this formatter")
+
+
+class LlamaChatContentFormatter(CustomOpenAIChatContentFormatter):
+    """Deprecated: Kept for backwards compatibility
+
+    Chat Content formatter for Llama."""
+
+    def __init__(self) -> None:
+        super().__init__()
+        warnings.warn(
+            """`LlamaChatContentFormatter` will be deprecated in the future. 
+                Please use `CustomOpenAIChatContentFormatter` instead.  
+            """
+        )
+
+
+class MistralChatContentFormatter(LlamaChatContentFormatter):
+    """Content formatter for `Mistral`."""
+
+    def format_messages_request_payload(
+        self,
+        messages: List[BaseMessage],
+        model_kwargs: Dict,
+        api_type: AzureMLEndpointApiType,
+    ) -> bytes:
+        """Formats the request according to the chosen api"""
+        chat_messages = [self._convert_message_to_dict(message) for message in messages]
+
+        if chat_messages and chat_messages[0]["role"] == "system":
+            # Mistral OSS models do not explicitly support system prompts, so we have to
+            # stash in the first user prompt
+            chat_messages[1]["content"] = (
+                chat_messages[0]["content"] + "\n\n" + chat_messages[1]["content"]
+            )
+            del chat_messages[0]
+
+        if api_type == AzureMLEndpointApiType.realtime:
+            request_payload = json.dumps(
+                {
+                    "input_data": {
+                        "input_string": chat_messages,
+                        "parameters": model_kwargs,
+                    }
+                }
+            )
+        elif api_type == AzureMLEndpointApiType.serverless:
+            request_payload = json.dumps({"messages": chat_messages, **model_kwargs})
+        else:
+            raise ValueError(
+                f"`api_type` {api_type} is not supported by this formatter"
+            )
+        return str.encode(request_payload)
+
+
+class AzureMLChatOnlineEndpoint(BaseChatModel, AzureMLBaseEndpoint):
+    """Azure ML Online Endpoint chat models.
+
+    Example:
+        .. code-block:: python
+            azure_llm = AzureMLOnlineEndpoint(
+                endpoint_url="https://<your-endpoint>.<your_region>.inference.ml.azure.com/v1/chat/completions",
+                endpoint_api_type=AzureMLApiType.serverless,
+                endpoint_api_key="my-api-key",
+                content_formatter=chat_content_formatter,
+            )
+    """  # noqa: E501
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "azureml_chat_endpoint"
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Call out to an AzureML Managed Online endpoint.
+        Args:
+            messages: The messages in the conversation with the chat model.
+            stop: Optional list of stop words to use when generating.
+        Returns:
+            The string generated by the model.
+        Example:
+            .. code-block:: python
+                response = azureml_model("Tell me a joke.")
+        """
+        _model_kwargs = self.model_kwargs or {}
+        _model_kwargs.update(kwargs)
+        if stop:
+            _model_kwargs["stop"] = stop
+
+        request_payload = self.content_formatter.format_messages_request_payload(
+            messages, _model_kwargs, self.endpoint_api_type
+        )
+        response_payload = self.http_client.call(
+            body=request_payload, run_manager=run_manager
+        )
+        generations = self.content_formatter.format_response_payload(
+            response_payload, self.endpoint_api_type
+        )
+        return ChatResult(generations=[generations])
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        self.endpoint_url = self.endpoint_url.replace("/chat/completions", "")
+        timeout = None if "timeout" not in kwargs else kwargs["timeout"]
+
+        import openai
+
+        params = {}
+        client_params = {
+            "api_key": self.endpoint_api_key.get_secret_value(),
+            "base_url": self.endpoint_url,
+            "timeout": timeout,
+            "default_headers": None,
+            "default_query": None,
+            "http_client": None,
+        }
+
+        client = openai.OpenAI(**client_params)
+        message_dicts = [
+            CustomOpenAIChatContentFormatter._convert_message_to_dict(m)
+            for m in messages
+        ]
+        params = {"stream": True, "stop": stop, "model": None, **kwargs}
+
+        default_chunk_class = AIMessageChunk
+        for chunk in client.chat.completions.create(messages=message_dicts, **params):
+            if not isinstance(chunk, dict):
+                chunk = chunk.dict()
+            if len(chunk["choices"]) == 0:
+                continue
+            choice = chunk["choices"][0]
+            chunk = _convert_delta_to_message_chunk(
+                choice["delta"], default_chunk_class
+            )
+            generation_info = {}
+            if finish_reason := choice.get("finish_reason"):
+                generation_info["finish_reason"] = finish_reason
+            logprobs = choice.get("logprobs")
+            if logprobs:
+                generation_info["logprobs"] = logprobs
+            default_chunk_class = chunk.__class__
+            chunk = ChatGenerationChunk(
+                message=chunk, generation_info=generation_info or None
+            )
+            if run_manager:
+                run_manager.on_llm_new_token(chunk.text, chunk=chunk, logprobs=logprobs)
+            yield chunk
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        self.endpoint_url = self.endpoint_url.replace("/chat/completions", "")
+        timeout = None if "timeout" not in kwargs else kwargs["timeout"]
+
+        import openai
+
+        params = {}
+        client_params = {
+            "api_key": self.endpoint_api_key.get_secret_value(),
+            "base_url": self.endpoint_url,
+            "timeout": timeout,
+            "default_headers": None,
+            "default_query": None,
+            "http_client": None,
+        }
+
+        async_client = openai.AsyncOpenAI(**client_params)
+        message_dicts = [
+            CustomOpenAIChatContentFormatter._convert_message_to_dict(m)
+            for m in messages
+        ]
+        params = {"stream": True, "stop": stop, "model": None, **kwargs}
+
+        default_chunk_class = AIMessageChunk
+        async for chunk in await async_client.chat.completions.create(
+            messages=message_dicts, **params
+        ):
+            if not isinstance(chunk, dict):
+                chunk = chunk.dict()
+            if len(chunk["choices"]) == 0:
+                continue
+            choice = chunk["choices"][0]
+            chunk = _convert_delta_to_message_chunk(
+                choice["delta"], default_chunk_class
+            )
+            generation_info = {}
+            if finish_reason := choice.get("finish_reason"):
+                generation_info["finish_reason"] = finish_reason
+            logprobs = choice.get("logprobs")
+            if logprobs:
+                generation_info["logprobs"] = logprobs
+            default_chunk_class = chunk.__class__
+            chunk = ChatGenerationChunk(
+                message=chunk, generation_info=generation_info or None
+            )
+            if run_manager:
+                await run_manager.on_llm_new_token(
+                    token=chunk.text, chunk=chunk, logprobs=logprobs
+                )
+            yield chunk
+
+
+def _convert_delta_to_message_chunk(
+    _dict: Mapping[str, Any], default_class: Type[BaseMessageChunk]
+) -> BaseMessageChunk:
+    role = cast(str, _dict.get("role"))
+    content = cast(str, _dict.get("content") or "")
+    additional_kwargs: Dict = {}
+    if _dict.get("function_call"):
+        function_call = dict(_dict["function_call"])
+        if "name" in function_call and function_call["name"] is None:
+            function_call["name"] = ""
+        additional_kwargs["function_call"] = function_call
+    if _dict.get("tool_calls"):
+        additional_kwargs["tool_calls"] = _dict["tool_calls"]
+
+    if role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=content)
+    elif role == "assistant" or default_class == AIMessageChunk:
+        return AIMessageChunk(content=content, additional_kwargs=additional_kwargs)
+    elif role == "system" or default_class == SystemMessageChunk:
+        return SystemMessageChunk(content=content)
+    elif role == "function" or default_class == FunctionMessageChunk:
+        return FunctionMessageChunk(content=content, name=_dict["name"])
+    elif role == "tool" or default_class == ToolMessageChunk:
+        return ToolMessageChunk(content=content, tool_call_id=_dict["tool_call_id"])
+    elif role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=content, role=role)
+    else:
+        return default_class(content=content)
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/baichuan.py b/llm/Lib/site-packages/langchain_community/chat_models/baichuan.py
new file mode 100644
index 0000000000000000000000000000000000000000..e4d2fd6908c1a3ef5bfc2fd8435d806006c880aa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/baichuan.py
@@ -0,0 +1,278 @@
+import json
+import logging
+from typing import Any, Dict, Iterator, List, Mapping, Optional, Type
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import (
+    convert_to_secret_str,
+    get_from_dict_or_env,
+    get_pydantic_field_names,
+)
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_API_BASE = "https://api.baichuan-ai.com/v1/chat/completions"
+
+
+def _convert_message_to_dict(message: BaseMessage) -> dict:
+    message_dict: Dict[str, Any]
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": message.role, "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+    else:
+        raise TypeError(f"Got unknown type {message}")
+
+    return message_dict
+
+
+def _convert_dict_to_message(_dict: Mapping[str, Any]) -> BaseMessage:
+    role = _dict["role"]
+    if role == "user":
+        return HumanMessage(content=_dict["content"])
+    elif role == "assistant":
+        return AIMessage(content=_dict.get("content", "") or "")
+    else:
+        return ChatMessage(content=_dict["content"], role=role)
+
+
+def _convert_delta_to_message_chunk(
+    _dict: Mapping[str, Any], default_class: Type[BaseMessageChunk]
+) -> BaseMessageChunk:
+    role = _dict.get("role")
+    content = _dict.get("content") or ""
+
+    if role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=content)
+    elif role == "assistant" or default_class == AIMessageChunk:
+        return AIMessageChunk(content=content)
+    elif role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=content, role=role)
+    else:
+        return default_class(content=content)
+
+
+class ChatBaichuan(BaseChatModel):
+    """Baichuan chat models API by Baichuan Intelligent Technology.
+
+    For more information, see https://platform.baichuan-ai.com/docs/api
+    """
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {
+            "baichuan_api_key": "BAICHUAN_API_KEY",
+        }
+
+    @property
+    def lc_serializable(self) -> bool:
+        return True
+
+    baichuan_api_base: str = Field(default=DEFAULT_API_BASE)
+    """Baichuan custom endpoints"""
+    baichuan_api_key: Optional[SecretStr] = None
+    """Baichuan API Key"""
+    baichuan_secret_key: Optional[SecretStr] = None
+    """[DEPRECATED, keeping it for for backward compatibility] Baichuan Secret Key"""
+    streaming: bool = False
+    """Whether to stream the results or not."""
+    request_timeout: int = Field(default=60, alias="timeout")
+    """request timeout for chat http requests"""
+    model = "Baichuan2-Turbo-192K"
+    """model name of Baichuan, default is `Baichuan2-Turbo-192K`,
+    other options include `Baichuan2-Turbo`"""
+    temperature: float = 0.3
+    """What sampling temperature to use."""
+    top_k: int = 5
+    """What search sampling control to use."""
+    top_p: float = 0.85
+    """What probability mass to use."""
+    with_search_enhance: bool = False
+    """Whether to use search enhance, default is False."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for API call not explicitly specified."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name in extra:
+                raise ValueError(f"Found {field_name} supplied twice.")
+            if field_name not in all_required_field_names:
+                logger.warning(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+
+        invalid_model_kwargs = all_required_field_names.intersection(extra.keys())
+        if invalid_model_kwargs:
+            raise ValueError(
+                f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+                f"Instead they were passed in as part of `model_kwargs` parameter."
+            )
+
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        values["baichuan_api_base"] = get_from_dict_or_env(
+            values,
+            "baichuan_api_base",
+            "BAICHUAN_API_BASE",
+            DEFAULT_API_BASE,
+        )
+        values["baichuan_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "baichuan_api_key",
+                "BAICHUAN_API_KEY",
+            )
+        )
+
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Baichuan API."""
+        normal_params = {
+            "model": self.model,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            "top_k": self.top_k,
+            "with_search_enhance": self.with_search_enhance,
+            "stream": self.streaming,
+        }
+
+        return {**normal_params, **self.model_kwargs}
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._stream(
+                messages=messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        res = self._chat(messages, **kwargs)
+        if res.status_code != 200:
+            raise ValueError(f"Error from Baichuan api response: {res}")
+        response = res.json()
+        return self._create_chat_result(response)
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        res = self._chat(messages, **kwargs)
+        if res.status_code != 200:
+            raise ValueError(f"Error from Baichuan api response: {res}")
+        default_chunk_class = AIMessageChunk
+        for chunk in res.iter_lines():
+            chunk = chunk.decode("utf-8").strip("\r\n")
+            parts = chunk.split("data: ", 1)
+            chunk = parts[1] if len(parts) > 1 else None
+            if chunk is None:
+                continue
+            if chunk == "[DONE]":
+                break
+            response = json.loads(chunk)
+            for m in response.get("choices"):
+                chunk = _convert_delta_to_message_chunk(
+                    m.get("delta"), default_chunk_class
+                )
+                default_chunk_class = chunk.__class__
+                cg_chunk = ChatGenerationChunk(message=chunk)
+                if run_manager:
+                    run_manager.on_llm_new_token(chunk.content, chunk=cg_chunk)
+                yield cg_chunk
+
+    def _chat(self, messages: List[BaseMessage], **kwargs: Any) -> requests.Response:
+        parameters = {**self._default_params, **kwargs}
+
+        model = parameters.pop("model")
+        headers = parameters.pop("headers", {})
+        temperature = parameters.pop("temperature", 0.3)
+        top_k = parameters.pop("top_k", 5)
+        top_p = parameters.pop("top_p", 0.85)
+        with_search_enhance = parameters.pop("with_search_enhance", False)
+        stream = parameters.pop("stream", False)
+
+        payload = {
+            "model": model,
+            "messages": [_convert_message_to_dict(m) for m in messages],
+            "top_k": top_k,
+            "top_p": top_p,
+            "temperature": temperature,
+            "with_search_enhance": with_search_enhance,
+            "stream": stream,
+        }
+
+        url = self.baichuan_api_base
+        api_key = ""
+        if self.baichuan_api_key:
+            api_key = self.baichuan_api_key.get_secret_value()
+
+        res = requests.post(
+            url=url,
+            timeout=self.request_timeout,
+            headers={
+                "Content-Type": "application/json",
+                "Authorization": f"Bearer {api_key}",
+                **headers,
+            },
+            json=payload,
+            stream=self.streaming,
+        )
+        return res
+
+    def _create_chat_result(self, response: Mapping[str, Any]) -> ChatResult:
+        generations = []
+        for c in response["choices"]:
+            message = _convert_dict_to_message(c["message"])
+            gen = ChatGeneration(message=message)
+            generations.append(gen)
+
+        token_usage = response["usage"]
+        llm_output = {"token_usage": token_usage, "model": self.model}
+        return ChatResult(generations=generations, llm_output=llm_output)
+
+    @property
+    def _llm_type(self) -> str:
+        return "baichuan-chat"
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/baidu_qianfan_endpoint.py b/llm/Lib/site-packages/langchain_community/chat_models/baidu_qianfan_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..aa80fd7fe0ba8986bd994ba817b801b0d4936a88
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/baidu_qianfan_endpoint.py
@@ -0,0 +1,393 @@
+import logging
+from typing import Any, AsyncIterator, Dict, Iterator, List, Mapping, Optional, cast
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    ChatMessage,
+    FunctionMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+def convert_message_to_dict(message: BaseMessage) -> dict:
+    """Convert a message to a dictionary that can be passed to the API."""
+    message_dict: Dict[str, Any]
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": message.role, "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+        if "function_call" in message.additional_kwargs:
+            message_dict["function_call"] = message.additional_kwargs["function_call"]
+            # If function call only, content is None not empty string
+            if message_dict["content"] == "":
+                message_dict["content"] = None
+    elif isinstance(message, FunctionMessage):
+        message_dict = {
+            "role": "function",
+            "content": message.content,
+            "name": message.name,
+        }
+    else:
+        raise TypeError(f"Got unknown type {message}")
+
+    return message_dict
+
+
+def _convert_dict_to_message(_dict: Mapping[str, Any]) -> AIMessage:
+    content = _dict.get("result", "") or ""
+    additional_kwargs: Mapping[str, Any] = {}
+    if _dict.get("function_call"):
+        additional_kwargs = {"function_call": dict(_dict["function_call"])}
+        if "thoughts" in additional_kwargs["function_call"]:
+            # align to api sample, which affects the llm function_call output
+            additional_kwargs["function_call"].pop("thoughts")
+
+    additional_kwargs = {**_dict.get("body", {}), **additional_kwargs}
+    return AIMessage(
+        content=content,
+        additional_kwargs=dict(
+            finish_reason=additional_kwargs.get("finish_reason", ""),
+            request_id=additional_kwargs["id"],
+            object=additional_kwargs.get("object", ""),
+            search_info=additional_kwargs.get("search_info", []),
+            function_call=additional_kwargs.get("function_call", {}),
+        ),
+    )
+
+
+class QianfanChatEndpoint(BaseChatModel):
+    """Baidu Qianfan chat models.
+
+    To use, you should have the ``qianfan`` python package installed, and
+    the environment variable ``qianfan_ak`` and ``qianfan_sk`` set with your
+    API key and Secret Key.
+
+    ak, sk are required parameters
+    which you could get from  https://cloud.baidu.com/product/wenxinworkshop
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import QianfanChatEndpoint
+            qianfan_chat = QianfanChatEndpoint(model="ERNIE-Bot",
+                endpoint="your_endpoint", qianfan_ak="your_ak", qianfan_sk="your_sk")
+    """
+
+    init_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """init kwargs for qianfan client init, such as `query_per_second` which is 
+        associated with qianfan resource object to limit QPS"""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """extra params for model invoke using with `do`."""
+
+    client: Any
+
+    qianfan_ak: Optional[SecretStr] = None
+    qianfan_sk: Optional[SecretStr] = None
+
+    streaming: Optional[bool] = False
+    """Whether to stream the results or not."""
+
+    request_timeout: Optional[int] = Field(60, alias="timeout")
+    """request timeout for chat http requests"""
+
+    top_p: Optional[float] = 0.8
+    temperature: Optional[float] = 0.95
+    penalty_score: Optional[float] = 1
+    """Model params, only supported in ERNIE-Bot and ERNIE-Bot-turbo.
+    In the case of other model, passing these params will not affect the result.
+    """
+
+    model: str = "ERNIE-Bot-turbo"
+    """Model name.
+    you could get from https://cloud.baidu.com/doc/WENXINWORKSHOP/s/Nlks5zkzu
+    
+    preset models are mapping to an endpoint.
+    `model` will be ignored if `endpoint` is set.
+    Default is ERNIE-Bot-turbo.
+    """
+
+    endpoint: Optional[str] = None
+    """Endpoint of the Qianfan LLM, required if custom model used."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        values["qianfan_ak"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "qianfan_ak",
+                "QIANFAN_AK",
+                default="",
+            )
+        )
+        values["qianfan_sk"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "qianfan_sk",
+                "QIANFAN_SK",
+                default="",
+            )
+        )
+        params = {
+            **values.get("init_kwargs", {}),
+            "model": values["model"],
+            "stream": values["streaming"],
+        }
+        if values["qianfan_ak"].get_secret_value() != "":
+            params["ak"] = values["qianfan_ak"].get_secret_value()
+        if values["qianfan_sk"].get_secret_value() != "":
+            params["sk"] = values["qianfan_sk"].get_secret_value()
+        if values["endpoint"] is not None and values["endpoint"] != "":
+            params["endpoint"] = values["endpoint"]
+        try:
+            import qianfan
+
+            values["client"] = qianfan.ChatCompletion(**params)
+        except ImportError:
+            raise ValueError(
+                "qianfan package not found, please install it with "
+                "`pip install qianfan`"
+            )
+        return values
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        return {
+            **{"endpoint": self.endpoint, "model": self.model},
+            **super()._identifying_params,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat_model."""
+        return "baidu-qianfan-chat"
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Qianfan API."""
+        normal_params = {
+            "model": self.model,
+            "endpoint": self.endpoint,
+            "stream": self.streaming,
+            "request_timeout": self.request_timeout,
+            "top_p": self.top_p,
+            "temperature": self.temperature,
+            "penalty_score": self.penalty_score,
+        }
+
+        return {**normal_params, **self.model_kwargs}
+
+    def _convert_prompt_msg_params(
+        self,
+        messages: List[BaseMessage],
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        """
+        Converts a list of messages into a dictionary containing the message content
+        and default parameters.
+
+        Args:
+            messages (List[BaseMessage]): The list of messages.
+            **kwargs (Any): Optional arguments to add additional parameters to the
+            resulting dictionary.
+
+        Returns:
+            Dict[str, Any]: A dictionary containing the message content and default
+            parameters.
+
+        """
+        messages_dict: Dict[str, Any] = {
+            "messages": [
+                convert_message_to_dict(m)
+                for m in messages
+                if not isinstance(m, SystemMessage)
+            ]
+        }
+        for i in [i for i, m in enumerate(messages) if isinstance(m, SystemMessage)]:
+            if "system" not in messages_dict:
+                messages_dict["system"] = ""
+            messages_dict["system"] += cast(str, messages[i].content) + "\n"
+
+        return {
+            **messages_dict,
+            **self._default_params,
+            **kwargs,
+        }
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Call out to an qianfan models endpoint for each generation with a prompt.
+        Args:
+            messages: The messages to pass into the model.
+            stop: Optional list of stop words to use when generating.
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+                response = qianfan_model("Tell me a joke.")
+        """
+        if self.streaming:
+            completion = ""
+            token_usage = {}
+            chat_generation_info: Dict = {}
+            for chunk in self._stream(messages, stop, run_manager, **kwargs):
+                chat_generation_info = (
+                    chunk.generation_info
+                    if chunk.generation_info is not None
+                    else chat_generation_info
+                )
+                completion += chunk.text
+            lc_msg = AIMessage(content=completion, additional_kwargs={})
+            gen = ChatGeneration(
+                message=lc_msg,
+                generation_info=dict(finish_reason="stop"),
+            )
+            return ChatResult(
+                generations=[gen],
+                llm_output={
+                    "token_usage": chat_generation_info.get("usage", {}),
+                    "model_name": self.model,
+                },
+            )
+        params = self._convert_prompt_msg_params(messages, **kwargs)
+        params["stop"] = stop
+        response_payload = self.client.do(**params)
+        lc_msg = _convert_dict_to_message(response_payload)
+        gen = ChatGeneration(
+            message=lc_msg,
+            generation_info={
+                "finish_reason": "stop",
+                **response_payload.get("body", {}),
+            },
+        )
+        token_usage = response_payload.get("usage", {})
+        llm_output = {"token_usage": token_usage, "model_name": self.model}
+        return ChatResult(generations=[gen], llm_output=llm_output)
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            completion = ""
+            token_usage = {}
+            chat_generation_info: Dict = {}
+            async for chunk in self._astream(messages, stop, run_manager, **kwargs):
+                chat_generation_info = (
+                    chunk.generation_info
+                    if chunk.generation_info is not None
+                    else chat_generation_info
+                )
+                completion += chunk.text
+
+            lc_msg = AIMessage(content=completion, additional_kwargs={})
+            gen = ChatGeneration(
+                message=lc_msg,
+                generation_info=dict(finish_reason="stop"),
+            )
+            return ChatResult(
+                generations=[gen],
+                llm_output={
+                    "token_usage": chat_generation_info.get("usage", {}),
+                    "model_name": self.model,
+                },
+            )
+        params = self._convert_prompt_msg_params(messages, **kwargs)
+        params["stop"] = stop
+        response_payload = await self.client.ado(**params)
+        lc_msg = _convert_dict_to_message(response_payload)
+        generations = []
+        gen = ChatGeneration(
+            message=lc_msg,
+            generation_info={
+                "finish_reason": "stop",
+                **response_payload.get("body", {}),
+            },
+        )
+        generations.append(gen)
+        token_usage = response_payload.get("usage", {})
+        llm_output = {"token_usage": token_usage, "model_name": self.model}
+        return ChatResult(generations=generations, llm_output=llm_output)
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        params = self._convert_prompt_msg_params(messages, **kwargs)
+        params["stop"] = stop
+        params["stream"] = True
+        for res in self.client.do(**params):
+            if res:
+                msg = _convert_dict_to_message(res)
+                additional_kwargs = msg.additional_kwargs.get("function_call", {})
+                chunk = ChatGenerationChunk(
+                    text=res["result"],
+                    message=AIMessageChunk(
+                        content=msg.content,
+                        role="assistant",
+                        additional_kwargs=additional_kwargs,
+                    ),
+                    generation_info=msg.additional_kwargs,
+                )
+                if run_manager:
+                    run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+                yield chunk
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        params = self._convert_prompt_msg_params(messages, **kwargs)
+        params["stop"] = stop
+        params["stream"] = True
+        async for res in await self.client.ado(**params):
+            if res:
+                msg = _convert_dict_to_message(res)
+                additional_kwargs = msg.additional_kwargs.get("function_call", {})
+                chunk = ChatGenerationChunk(
+                    text=res["result"],
+                    message=AIMessageChunk(
+                        content=msg.content,
+                        role="assistant",
+                        additional_kwargs=additional_kwargs,
+                    ),
+                    generation_info=msg.additional_kwargs,
+                )
+                if run_manager:
+                    await run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+                yield chunk
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/bedrock.py b/llm/Lib/site-packages/langchain_community/chat_models/bedrock.py
new file mode 100644
index 0000000000000000000000000000000000000000..74eb1af216e852ea4ad60e9fbdcdaf7d4eee8932
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/bedrock.py
@@ -0,0 +1,332 @@
+import re
+from collections import defaultdict
+from typing import Any, Dict, Iterator, List, Optional, Tuple, Union
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    ChatMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import Extra
+
+from langchain_community.chat_models.anthropic import (
+    convert_messages_to_prompt_anthropic,
+)
+from langchain_community.chat_models.meta import convert_messages_to_prompt_llama
+from langchain_community.llms.bedrock import BedrockBase
+from langchain_community.utilities.anthropic import (
+    get_num_tokens_anthropic,
+    get_token_ids_anthropic,
+)
+
+
+def _convert_one_message_to_text_mistral(message: BaseMessage) -> str:
+    if isinstance(message, ChatMessage):
+        message_text = f"\n\n{message.role.capitalize()}: {message.content}"
+    elif isinstance(message, HumanMessage):
+        message_text = f"[INST] {message.content} [/INST]"
+    elif isinstance(message, AIMessage):
+        message_text = f"{message.content}"
+    elif isinstance(message, SystemMessage):
+        message_text = f"<<SYS>> {message.content} <</SYS>>"
+    else:
+        raise ValueError(f"Got unknown type {message}")
+    return message_text
+
+
+def convert_messages_to_prompt_mistral(messages: List[BaseMessage]) -> str:
+    """Convert a list of messages to a prompt for mistral."""
+    return "\n".join(
+        [_convert_one_message_to_text_mistral(message) for message in messages]
+    )
+
+
+def _format_image(image_url: str) -> Dict:
+    """
+    Formats an image of format data:image/jpeg;base64,{b64_string}
+    to a dict for anthropic api
+
+    {
+      "type": "base64",
+      "media_type": "image/jpeg",
+      "data": "/9j/4AAQSkZJRg...",
+    }
+
+    And throws an error if it's not a b64 image
+    """
+    regex = r"^data:(?P<media_type>image/.+);base64,(?P<data>.+)$"
+    match = re.match(regex, image_url)
+    if match is None:
+        raise ValueError(
+            "Anthropic only supports base64-encoded images currently."
+            " Example: data:image/png;base64,'/9j/4AAQSk'..."
+        )
+    return {
+        "type": "base64",
+        "media_type": match.group("media_type"),
+        "data": match.group("data"),
+    }
+
+
+def _format_anthropic_messages(
+    messages: List[BaseMessage],
+) -> Tuple[Optional[str], List[Dict]]:
+    """Format messages for anthropic."""
+
+    """
+    [
+        {
+            "role": _message_type_lookups[m.type],
+            "content": [_AnthropicMessageContent(text=m.content).dict()],
+        }
+        for m in messages
+    ]
+    """
+    system: Optional[str] = None
+    formatted_messages: List[Dict] = []
+    for i, message in enumerate(messages):
+        if message.type == "system":
+            if i != 0:
+                raise ValueError("System message must be at beginning of message list.")
+            if not isinstance(message.content, str):
+                raise ValueError(
+                    "System message must be a string, "
+                    f"instead was: {type(message.content)}"
+                )
+            system = message.content
+            continue
+
+        role = _message_type_lookups[message.type]
+        content: Union[str, List[Dict]]
+
+        if not isinstance(message.content, str):
+            # parse as dict
+            assert isinstance(
+                message.content, list
+            ), "Anthropic message content must be str or list of dicts"
+
+            # populate content
+            content = []
+            for item in message.content:
+                if isinstance(item, str):
+                    content.append(
+                        {
+                            "type": "text",
+                            "text": item,
+                        }
+                    )
+                elif isinstance(item, dict):
+                    if "type" not in item:
+                        raise ValueError("Dict content item must have a type key")
+                    if item["type"] == "image_url":
+                        # convert format
+                        source = _format_image(item["image_url"]["url"])
+                        content.append(
+                            {
+                                "type": "image",
+                                "source": source,
+                            }
+                        )
+                    else:
+                        content.append(item)
+                else:
+                    raise ValueError(
+                        f"Content items must be str or dict, instead was: {type(item)}"
+                    )
+        else:
+            content = message.content
+
+        formatted_messages.append(
+            {
+                "role": role,
+                "content": content,
+            }
+        )
+    return system, formatted_messages
+
+
+class ChatPromptAdapter:
+    """Adapter class to prepare the inputs from Langchain to prompt format
+    that Chat model expects.
+    """
+
+    @classmethod
+    def convert_messages_to_prompt(
+        cls, provider: str, messages: List[BaseMessage]
+    ) -> str:
+        if provider == "anthropic":
+            prompt = convert_messages_to_prompt_anthropic(messages=messages)
+        elif provider == "meta":
+            prompt = convert_messages_to_prompt_llama(messages=messages)
+        elif provider == "mistral":
+            prompt = convert_messages_to_prompt_mistral(messages=messages)
+        elif provider == "amazon":
+            prompt = convert_messages_to_prompt_anthropic(
+                messages=messages,
+                human_prompt="\n\nUser:",
+                ai_prompt="\n\nBot:",
+            )
+        else:
+            raise NotImplementedError(
+                f"Provider {provider} model does not support chat."
+            )
+        return prompt
+
+    @classmethod
+    def format_messages(
+        cls, provider: str, messages: List[BaseMessage]
+    ) -> Tuple[Optional[str], List[Dict]]:
+        if provider == "anthropic":
+            return _format_anthropic_messages(messages)
+
+        raise NotImplementedError(
+            f"Provider {provider} not supported for format_messages"
+        )
+
+
+_message_type_lookups = {"human": "user", "ai": "assistant"}
+
+
+@deprecated(
+    since="0.0.34", removal="0.3", alternative_import="langchain_aws.ChatBedrock"
+)
+class BedrockChat(BaseChatModel, BedrockBase):
+    """Chat model that uses the Bedrock API."""
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "amazon_bedrock_chat"
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this model can be serialized by Langchain."""
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "chat_models", "bedrock"]
+
+    @property
+    def lc_attributes(self) -> Dict[str, Any]:
+        attributes: Dict[str, Any] = {}
+
+        if self.region_name:
+            attributes["region_name"] = self.region_name
+
+        return attributes
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        provider = self._get_provider()
+        prompt, system, formatted_messages = None, None, None
+
+        if provider == "anthropic":
+            system, formatted_messages = ChatPromptAdapter.format_messages(
+                provider, messages
+            )
+        else:
+            prompt = ChatPromptAdapter.convert_messages_to_prompt(
+                provider=provider, messages=messages
+            )
+
+        for chunk in self._prepare_input_and_invoke_stream(
+            prompt=prompt,
+            system=system,
+            messages=formatted_messages,
+            stop=stop,
+            run_manager=run_manager,
+            **kwargs,
+        ):
+            delta = chunk.text
+            yield ChatGenerationChunk(message=AIMessageChunk(content=delta))
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        completion = ""
+        llm_output: Dict[str, Any] = {"model_id": self.model_id}
+
+        if self.streaming:
+            for chunk in self._stream(messages, stop, run_manager, **kwargs):
+                completion += chunk.text
+        else:
+            provider = self._get_provider()
+            prompt, system, formatted_messages = None, None, None
+            params: Dict[str, Any] = {**kwargs}
+
+            if provider == "anthropic":
+                system, formatted_messages = ChatPromptAdapter.format_messages(
+                    provider, messages
+                )
+            else:
+                prompt = ChatPromptAdapter.convert_messages_to_prompt(
+                    provider=provider, messages=messages
+                )
+
+            if stop:
+                params["stop_sequences"] = stop
+
+            completion, usage_info = self._prepare_input_and_invoke(
+                prompt=prompt,
+                stop=stop,
+                run_manager=run_manager,
+                system=system,
+                messages=formatted_messages,
+                **params,
+            )
+
+            llm_output["usage"] = usage_info
+
+        return ChatResult(
+            generations=[ChatGeneration(message=AIMessage(content=completion))],
+            llm_output=llm_output,
+        )
+
+    def _combine_llm_outputs(self, llm_outputs: List[Optional[dict]]) -> dict:
+        final_usage: Dict[str, int] = defaultdict(int)
+        final_output = {}
+        for output in llm_outputs:
+            output = output or {}
+            usage = output.get("usage", {})
+            for token_type, token_count in usage.items():
+                final_usage[token_type] += token_count
+            final_output.update(output)
+        final_output["usage"] = final_usage
+        return final_output
+
+    def get_num_tokens(self, text: str) -> int:
+        if self._model_is_anthropic:
+            return get_num_tokens_anthropic(text)
+        else:
+            return super().get_num_tokens(text)
+
+    def get_token_ids(self, text: str) -> List[int]:
+        if self._model_is_anthropic:
+            return get_token_ids_anthropic(text)
+        else:
+            return super().get_token_ids(text)
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/cohere.py b/llm/Lib/site-packages/langchain_community/chat_models/cohere.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ea44328a710a16e9afcd14588a2853d0c4ac0c2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/cohere.py
@@ -0,0 +1,251 @@
+from typing import Any, AsyncIterator, Dict, Iterator, List, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    ChatMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+
+from langchain_community.llms.cohere import BaseCohere
+
+
+def get_role(message: BaseMessage) -> str:
+    """Get the role of the message.
+
+    Args:
+        message: The message.
+
+    Returns:
+        The role of the message.
+
+    Raises:
+        ValueError: If the message is of an unknown type.
+    """
+    if isinstance(message, ChatMessage) or isinstance(message, HumanMessage):
+        return "User"
+    elif isinstance(message, AIMessage):
+        return "Chatbot"
+    elif isinstance(message, SystemMessage):
+        return "System"
+    else:
+        raise ValueError(f"Got unknown type {message}")
+
+
+def get_cohere_chat_request(
+    messages: List[BaseMessage],
+    *,
+    connectors: Optional[List[Dict[str, str]]] = None,
+    **kwargs: Any,
+) -> Dict[str, Any]:
+    """Get the request for the Cohere chat API.
+
+    Args:
+        messages: The messages.
+        connectors: The connectors.
+        **kwargs: The keyword arguments.
+
+    Returns:
+        The request for the Cohere chat API.
+    """
+    documents = (
+        None
+        if "source_documents" not in kwargs
+        else [
+            {
+                "snippet": doc.page_content,
+                "id": doc.metadata.get("id") or f"doc-{str(i)}",
+            }
+            for i, doc in enumerate(kwargs["source_documents"])
+        ]
+    )
+    kwargs.pop("source_documents", None)
+    maybe_connectors = connectors if documents is None else None
+
+    # by enabling automatic prompt truncation, the probability of request failure is
+    # reduced with minimal impact on response quality
+    prompt_truncation = (
+        "AUTO" if documents is not None or connectors is not None else None
+    )
+
+    req = {
+        "message": messages[-1].content,
+        "chat_history": [
+            {"role": get_role(x), "message": x.content} for x in messages[:-1]
+        ],
+        "documents": documents,
+        "connectors": maybe_connectors,
+        "prompt_truncation": prompt_truncation,
+        **kwargs,
+    }
+
+    return {k: v for k, v in req.items() if v is not None}
+
+
+@deprecated(
+    since="0.0.30", removal="0.2.0", alternative_import="langchain_cohere.ChatCohere"
+)
+class ChatCohere(BaseChatModel, BaseCohere):
+    """`Cohere` chat large language models.
+
+    To use, you should have the ``cohere`` python package installed, and the
+    environment variable ``COHERE_API_KEY`` set with your API key, or pass
+    it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatCohere
+            from langchain_core.messages import HumanMessage
+
+            chat = ChatCohere(model="command", max_tokens=256, temperature=0.75)
+
+            messages = [HumanMessage(content="knock knock")]
+            chat.invoke(messages)
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+        arbitrary_types_allowed = True
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "cohere-chat"
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Cohere API."""
+        return {
+            "temperature": self.temperature,
+        }
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model": self.model}, **self._default_params}
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        request = get_cohere_chat_request(messages, **self._default_params, **kwargs)
+
+        if hasattr(self.client, "chat_stream"):  # detect and support sdk v5
+            stream = self.client.chat_stream(**request)
+        else:
+            stream = self.client.chat(**request, stream=True)
+
+        for data in stream:
+            if data.event_type == "text-generation":
+                delta = data.text
+                chunk = ChatGenerationChunk(message=AIMessageChunk(content=delta))
+                if run_manager:
+                    run_manager.on_llm_new_token(delta, chunk=chunk)
+                yield chunk
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        request = get_cohere_chat_request(messages, **self._default_params, **kwargs)
+
+        if hasattr(self.async_client, "chat_stream"):  # detect and support sdk v5
+            stream = await self.async_client.chat_stream(**request)
+        else:
+            stream = await self.async_client.chat(**request, stream=True)
+
+        async for data in stream:
+            if data.event_type == "text-generation":
+                delta = data.text
+                chunk = ChatGenerationChunk(message=AIMessageChunk(content=delta))
+                if run_manager:
+                    await run_manager.on_llm_new_token(delta, chunk=chunk)
+                yield chunk
+
+    def _get_generation_info(self, response: Any) -> Dict[str, Any]:
+        """Get the generation info from cohere API response."""
+        return {
+            "documents": response.documents,
+            "citations": response.citations,
+            "search_results": response.search_results,
+            "search_queries": response.search_queries,
+            "token_count": response.token_count,
+        }
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        request = get_cohere_chat_request(messages, **self._default_params, **kwargs)
+        response = self.client.chat(**request)
+
+        message = AIMessage(content=response.text)
+        generation_info = None
+        if hasattr(response, "documents"):
+            generation_info = self._get_generation_info(response)
+        return ChatResult(
+            generations=[
+                ChatGeneration(message=message, generation_info=generation_info)
+            ]
+        )
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._astream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+
+        request = get_cohere_chat_request(messages, **self._default_params, **kwargs)
+        response = self.client.chat(**request)
+
+        message = AIMessage(content=response.text)
+        generation_info = None
+        if hasattr(response, "documents"):
+            generation_info = self._get_generation_info(response)
+        return ChatResult(
+            generations=[
+                ChatGeneration(message=message, generation_info=generation_info)
+            ]
+        )
+
+    def get_num_tokens(self, text: str) -> int:
+        """Calculate number of tokens."""
+        return len(self.client.tokenize(text=text).tokens)
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/dappier.py b/llm/Lib/site-packages/langchain_community/chat_models/dappier.py
new file mode 100644
index 0000000000000000000000000000000000000000..3468feebd7c730af30c828f0b46cd6be9be208b0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/dappier.py
@@ -0,0 +1,161 @@
+from typing import Any, Dict, List, Optional, Union
+
+from aiohttp import ClientSession
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+)
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatResult
+from langchain_core.pydantic_v1 import Extra, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.utilities.requests import Requests
+
+
+def _format_dappier_messages(
+    messages: List[BaseMessage],
+) -> List[Dict[str, Union[str, List[Union[str, Dict[Any, Any]]]]]]:
+    formatted_messages = []
+
+    for message in messages:
+        if message.type == "human":
+            formatted_messages.append({"role": "user", "content": message.content})
+        elif message.type == "system":
+            formatted_messages.append({"role": "system", "content": message.content})
+
+    return formatted_messages
+
+
+class ChatDappierAI(BaseChatModel):
+    """`Dappier` chat large language models.
+
+    `Dappier` is a platform enabling access to diverse, real-time data models.
+    Enhance your AI applications with Dappier's pre-trained, LLM-ready data models
+    and ensure accurate, current responses with reduced inaccuracies.
+
+    To use one of our Dappier AI Data Models, you will need an API key.
+    Please visit Dappier Platform (https://platform.dappier.com/) to log in
+    and create an API key in your profile.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatDappierAI
+            from langchain_core.messages import HumanMessage
+
+            # Initialize `ChatDappierAI` with the desired configuration
+            chat = ChatDappierAI(
+                dappier_endpoint="https://api.dappier.com/app/datamodel/dm_01hpsxyfm2fwdt2zet9cg6fdxt",
+                dappier_api_key="<YOUR_KEY>")
+
+            # Create a list of messages to interact with the model
+            messages = [HumanMessage(content="hello")]
+
+            # Invoke the model with the provided messages
+            chat.invoke(messages)
+
+
+    you can find more details here : https://docs.dappier.com/introduction"""
+
+    dappier_endpoint: str = "https://api.dappier.com/app/datamodelconversation"
+
+    dappier_model: str = "dm_01hpsxyfm2fwdt2zet9cg6fdxt"
+
+    dappier_api_key: Optional[SecretStr] = Field(None, description="Dappier API Token")
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        values["dappier_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "dappier_api_key", "DAPPIER_API_KEY")
+        )
+        return values
+
+    @staticmethod
+    def get_user_agent() -> str:
+        from langchain_community import __version__
+
+        return f"langchain/{__version__}"
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "dappier-realtimesearch-chat"
+
+    @property
+    def _api_key(self) -> str:
+        if self.dappier_api_key:
+            return self.dappier_api_key.get_secret_value()
+        return ""
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        url = f"{self.dappier_endpoint}"
+        headers = {
+            "Authorization": f"Bearer {self._api_key}",
+            "User-Agent": self.get_user_agent(),
+        }
+        user_query = _format_dappier_messages(messages=messages)
+        payload: Dict[str, Any] = {
+            "model": self.dappier_model,
+            "conversation": user_query,
+        }
+
+        request = Requests(headers=headers)
+        response = request.post(url=url, data=payload)
+        response.raise_for_status()
+
+        data = response.json()
+
+        message_response = data["message"]
+
+        return ChatResult(
+            generations=[ChatGeneration(message=AIMessage(content=message_response))]
+        )
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        url = f"{self.dappier_endpoint}"
+        headers = {
+            "Authorization": f"Bearer {self._api_key}",
+            "User-Agent": self.get_user_agent(),
+        }
+        user_query = _format_dappier_messages(messages=messages)
+        payload: Dict[str, Any] = {
+            "model": self.dappier_model,
+            "conversation": user_query,
+        }
+
+        async with ClientSession() as session:
+            async with session.post(url, json=payload, headers=headers) as response:
+                response.raise_for_status()
+                data = await response.json()
+                message_response = data["message"]
+
+                return ChatResult(
+                    generations=[
+                        ChatGeneration(message=AIMessage(content=message_response))
+                    ]
+                )
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/databricks.py b/llm/Lib/site-packages/langchain_community/chat_models/databricks.py
new file mode 100644
index 0000000000000000000000000000000000000000..dfa3032f60a43f5d9576109a3f8c9d33b0602228
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/databricks.py
@@ -0,0 +1,53 @@
+import logging
+from urllib.parse import urlparse
+
+from langchain_community.chat_models.mlflow import ChatMlflow
+
+logger = logging.getLogger(__name__)
+
+
+class ChatDatabricks(ChatMlflow):
+    """`Databricks` chat models API.
+
+    To use, you should have the ``mlflow`` python package installed.
+    For more information, see https://mlflow.org/docs/latest/llms/deployments.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatDatabricks
+
+            chat = ChatDatabricks(
+                target_uri="databricks",
+                endpoint="databricks-llama-2-70b-chat",
+                temperature-0.1,
+            )
+
+            # single input invocation
+            print(chat_model.invoke("What is MLflow?").content)
+
+            # single input invocation with streaming response
+            for chunk in chat_model.stream("What is MLflow?"):
+                print(chunk.content, end="|")
+    """
+
+    target_uri: str = "databricks"
+    """The target URI to use. Defaults to ``databricks``."""
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "databricks-chat"
+
+    @property
+    def _mlflow_extras(self) -> str:
+        return ""
+
+    def _validate_uri(self) -> None:
+        if self.target_uri == "databricks":
+            return
+
+        if urlparse(self.target_uri).scheme != "databricks":
+            raise ValueError(
+                "Invalid target URI. The target URI must be a valid databricks URI."
+            )
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/deepinfra.py b/llm/Lib/site-packages/langchain_community/chat_models/deepinfra.py
new file mode 100644
index 0000000000000000000000000000000000000000..0886e520867d30d42ffaac9c90bff75b3bdd6ad4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/deepinfra.py
@@ -0,0 +1,458 @@
+"""deepinfra.com chat models wrapper"""
+
+from __future__ import annotations
+
+import json
+import logging
+from typing import (
+    Any,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+import aiohttp
+import requests
+from langchain_core.callbacks.manager import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.language_models.llms import create_base_retry_decorator
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    FunctionMessage,
+    FunctionMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+    SystemMessageChunk,
+)
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatGenerationChunk,
+    ChatResult,
+)
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+# from langchain.llms.base import create_base_retry_decorator
+from langchain_community.utilities.requests import Requests
+
+logger = logging.getLogger(__name__)
+
+
+class ChatDeepInfraException(Exception):
+    """Exception raised when the DeepInfra API returns an error."""
+
+    pass
+
+
+def _create_retry_decorator(
+    llm: ChatDeepInfra,
+    run_manager: Optional[
+        Union[AsyncCallbackManagerForLLMRun, CallbackManagerForLLMRun]
+    ] = None,
+) -> Callable[[Any], Any]:
+    """Returns a tenacity retry decorator, preconfigured to handle PaLM exceptions."""
+    return create_base_retry_decorator(
+        error_types=[requests.exceptions.ConnectTimeout, ChatDeepInfraException],
+        max_retries=llm.max_retries,
+        run_manager=run_manager,
+    )
+
+
+def _convert_dict_to_message(_dict: Mapping[str, Any]) -> BaseMessage:
+    role = _dict["role"]
+    if role == "user":
+        return HumanMessage(content=_dict["content"])
+    elif role == "assistant":
+        # Fix for azure
+        # Also OpenAI returns None for tool invocations
+        content = _dict.get("content", "") or ""
+        if _dict.get("function_call"):
+            additional_kwargs = {"function_call": dict(_dict["function_call"])}
+        else:
+            additional_kwargs = {}
+        return AIMessage(content=content, additional_kwargs=additional_kwargs)
+    elif role == "system":
+        return SystemMessage(content=_dict["content"])
+    elif role == "function":
+        return FunctionMessage(content=_dict["content"], name=_dict["name"])
+    else:
+        return ChatMessage(content=_dict["content"], role=role)
+
+
+def _convert_delta_to_message_chunk(
+    _dict: Mapping[str, Any], default_class: Type[BaseMessageChunk]
+) -> BaseMessageChunk:
+    role = _dict.get("role")
+    content = _dict.get("content") or ""
+    if _dict.get("function_call"):
+        additional_kwargs = {"function_call": dict(_dict["function_call"])}
+    else:
+        additional_kwargs = {}
+
+    if role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=content)
+    elif role == "assistant" or default_class == AIMessageChunk:
+        return AIMessageChunk(content=content, additional_kwargs=additional_kwargs)
+    elif role == "system" or default_class == SystemMessageChunk:
+        return SystemMessageChunk(content=content)
+    elif role == "function" or default_class == FunctionMessageChunk:
+        return FunctionMessageChunk(content=content, name=_dict["name"])
+    elif role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=content, role=role)
+    else:
+        return default_class(content=content)
+
+
+def _convert_message_to_dict(message: BaseMessage) -> dict:
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": message.role, "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+        if "function_call" in message.additional_kwargs:
+            message_dict["function_call"] = message.additional_kwargs["function_call"]
+    elif isinstance(message, SystemMessage):
+        message_dict = {"role": "system", "content": message.content}
+    elif isinstance(message, FunctionMessage):
+        message_dict = {
+            "role": "function",
+            "content": message.content,
+            "name": message.name,
+        }
+    else:
+        raise ValueError(f"Got unknown type {message}")
+    if "name" in message.additional_kwargs:
+        message_dict["name"] = message.additional_kwargs["name"]
+    return message_dict
+
+
+class ChatDeepInfra(BaseChatModel):
+    """A chat model that uses the DeepInfra API."""
+
+    # client: Any  #: :meta private:
+    model_name: str = Field(default="meta-llama/Llama-2-70b-chat-hf", alias="model")
+    """Model name to use."""
+    deepinfra_api_token: Optional[str] = None
+    request_timeout: Optional[float] = Field(default=None, alias="timeout")
+    temperature: Optional[float] = 1
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Run inference with this temperature. Must by in the closed
+       interval [0.0, 1.0]."""
+    top_p: Optional[float] = None
+    """Decode using nucleus sampling: consider the smallest set of tokens whose
+       probability sum is at least top_p. Must be in the closed interval [0.0, 1.0]."""
+    top_k: Optional[int] = None
+    """Decode using top-k sampling: consider the set of top_k most probable tokens.
+       Must be positive."""
+    n: int = 1
+    """Number of chat completions to generate for each prompt. Note that the API may
+       not return the full n completions if duplicates are generated."""
+    max_tokens: int = 256
+    streaming: bool = False
+    max_retries: int = 1
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling OpenAI API."""
+        return {
+            "model": self.model_name,
+            "max_tokens": self.max_tokens,
+            "stream": self.streaming,
+            "n": self.n,
+            "temperature": self.temperature,
+            "request_timeout": self.request_timeout,
+            **self.model_kwargs,
+        }
+
+    @property
+    def _client_params(self) -> Dict[str, Any]:
+        """Get the parameters used for the openai client."""
+        return {**self._default_params}
+
+    def completion_with_retry(
+        self, run_manager: Optional[CallbackManagerForLLMRun] = None, **kwargs: Any
+    ) -> Any:
+        """Use tenacity to retry the completion call."""
+        retry_decorator = _create_retry_decorator(self, run_manager=run_manager)
+
+        @retry_decorator
+        def _completion_with_retry(**kwargs: Any) -> Any:
+            try:
+                request_timeout = kwargs.pop("request_timeout")
+                request = Requests(headers=self._headers())
+                response = request.post(
+                    url=self._url(), data=self._body(kwargs), timeout=request_timeout
+                )
+                self._handle_status(response.status_code, response.text)
+                return response
+            except Exception as e:
+                # import pdb; pdb.set_trace()
+                print("EX", e)  # noqa: T201
+                raise
+
+        return _completion_with_retry(**kwargs)
+
+    async def acompletion_with_retry(
+        self,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Use tenacity to retry the async completion call."""
+        retry_decorator = _create_retry_decorator(self, run_manager=run_manager)
+
+        @retry_decorator
+        async def _completion_with_retry(**kwargs: Any) -> Any:
+            try:
+                request_timeout = kwargs.pop("request_timeout")
+                request = Requests(headers=self._headers())
+                async with request.apost(
+                    url=self._url(), data=self._body(kwargs), timeout=request_timeout
+                ) as response:
+                    self._handle_status(response.status, response.text)
+                    return await response.json()
+            except Exception as e:
+                print("EX", e)  # noqa: T201
+                raise
+
+        return await _completion_with_retry(**kwargs)
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate api key, python package exists, temperature, top_p, and top_k."""
+        # For compatibility with LiteLLM
+        api_key = get_from_dict_or_env(
+            values,
+            "deepinfra_api_key",
+            "DEEPINFRA_API_KEY",
+            default="",
+        )
+        values["deepinfra_api_token"] = get_from_dict_or_env(
+            values,
+            "deepinfra_api_token",
+            "DEEPINFRA_API_TOKEN",
+            default=api_key,
+        )
+
+        if values["temperature"] is not None and not 0 <= values["temperature"] <= 1:
+            raise ValueError("temperature must be in the range [0.0, 1.0]")
+
+        if values["top_p"] is not None and not 0 <= values["top_p"] <= 1:
+            raise ValueError("top_p must be in the range [0.0, 1.0]")
+
+        if values["top_k"] is not None and values["top_k"] <= 0:
+            raise ValueError("top_k must be positive")
+
+        return values
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs}
+        response = self.completion_with_retry(
+            messages=message_dicts, run_manager=run_manager, **params
+        )
+        return self._create_chat_result(response.json())
+
+    def _create_chat_result(self, response: Mapping[str, Any]) -> ChatResult:
+        generations = []
+        for res in response["choices"]:
+            message = _convert_dict_to_message(res["message"])
+            gen = ChatGeneration(
+                message=message,
+                generation_info=dict(finish_reason=res.get("finish_reason")),
+            )
+            generations.append(gen)
+        token_usage = response.get("usage", {})
+        llm_output = {"token_usage": token_usage, "model": self.model_name}
+        res = ChatResult(generations=generations, llm_output=llm_output)
+        return res
+
+    def _create_message_dicts(
+        self, messages: List[BaseMessage], stop: Optional[List[str]]
+    ) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+        params = self._client_params
+        if stop is not None:
+            if "stop" in params:
+                raise ValueError("`stop` found in both the input and default params.")
+            params["stop"] = stop
+        message_dicts = [_convert_message_to_dict(m) for m in messages]
+        return message_dicts, params
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+
+        response = self.completion_with_retry(
+            messages=message_dicts, run_manager=run_manager, **params
+        )
+        for line in _parse_stream(response.iter_lines()):
+            chunk = _handle_sse_line(line)
+            if chunk:
+                cg_chunk = ChatGenerationChunk(message=chunk, generation_info=None)
+                if run_manager:
+                    run_manager.on_llm_new_token(str(chunk.content), chunk=cg_chunk)
+                yield cg_chunk
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {"messages": message_dicts, "stream": True, **params, **kwargs}
+
+        request_timeout = params.pop("request_timeout")
+        request = Requests(headers=self._headers())
+        async with request.apost(
+            url=self._url(), data=self._body(params), timeout=request_timeout
+        ) as response:
+            async for line in _parse_stream_async(response.content):
+                chunk = _handle_sse_line(line)
+                if chunk:
+                    cg_chunk = ChatGenerationChunk(message=chunk, generation_info=None)
+                    if run_manager:
+                        await run_manager.on_llm_new_token(
+                            str(chunk.content), chunk=cg_chunk
+                        )
+                    yield cg_chunk
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._astream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {"messages": message_dicts, **params, **kwargs}
+
+        res = await self.acompletion_with_retry(run_manager=run_manager, **params)
+        return self._create_chat_result(res)
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model": self.model_name,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            "top_k": self.top_k,
+            "n": self.n,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        return "deepinfra-chat"
+
+    def _handle_status(self, code: int, text: Any) -> None:
+        if code >= 500:
+            raise ChatDeepInfraException(f"DeepInfra Server: Error {code}")
+        elif code >= 400:
+            raise ValueError(f"DeepInfra received an invalid payload: {text}")
+        elif code != 200:
+            raise Exception(
+                f"DeepInfra returned an unexpected response with status "
+                f"{code}: {text}"
+            )
+
+    def _url(self) -> str:
+        return "https://stage.api.deepinfra.com/v1/openai/chat/completions"
+
+    def _headers(self) -> Dict:
+        return {
+            "Authorization": f"bearer {self.deepinfra_api_token}",
+            "Content-Type": "application/json",
+        }
+
+    def _body(self, kwargs: Any) -> Dict:
+        return kwargs
+
+
+def _parse_stream(rbody: Iterator[bytes]) -> Iterator[str]:
+    for line in rbody:
+        _line = _parse_stream_helper(line)
+        if _line is not None:
+            yield _line
+
+
+async def _parse_stream_async(rbody: aiohttp.StreamReader) -> AsyncIterator[str]:
+    async for line in rbody:
+        _line = _parse_stream_helper(line)
+        if _line is not None:
+            yield _line
+
+
+def _parse_stream_helper(line: bytes) -> Optional[str]:
+    if line and line.startswith(b"data:"):
+        if line.startswith(b"data: "):
+            # SSE event may be valid when it contain whitespace
+            line = line[len(b"data: ") :]
+        else:
+            line = line[len(b"data:") :]
+        if line.strip() == b"[DONE]":
+            # return here will cause GeneratorExit exception in urllib3
+            # and it will close http connection with TCP Reset
+            return None
+        else:
+            return line.decode("utf-8")
+    return None
+
+
+def _handle_sse_line(line: str) -> Optional[BaseMessageChunk]:
+    try:
+        obj = json.loads(line)
+        default_chunk_class = AIMessageChunk
+        delta = obj.get("choices", [{}])[0].get("delta", {})
+        return _convert_delta_to_message_chunk(delta, default_chunk_class)
+    except Exception:
+        return None
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/edenai.py b/llm/Lib/site-packages/langchain_community/chat_models/edenai.py
new file mode 100644
index 0000000000000000000000000000000000000000..a4252b804c6ef1f4abb545343041eb401637aac1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/edenai.py
@@ -0,0 +1,372 @@
+import json
+from typing import Any, AsyncIterator, Dict, Iterator, List, Optional
+
+from aiohttp import ClientSession
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import Extra, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.utilities.requests import Requests
+
+
+def _message_role(type: str) -> str:
+    role_mapping = {"ai": "assistant", "human": "user", "chat": "user"}
+
+    if type in role_mapping:
+        return role_mapping[type]
+    else:
+        raise ValueError(f"Unknown type: {type}")
+
+
+def _format_edenai_messages(messages: List[BaseMessage]) -> Dict[str, Any]:
+    system = None
+    formatted_messages = []
+    text = messages[-1].content
+    for i, message in enumerate(messages[:-1]):
+        if message.type == "system":
+            if i != 0:
+                raise ValueError("System message must be at beginning of message list.")
+            system = message.content
+        else:
+            formatted_messages.append(
+                {
+                    "role": _message_role(message.type),
+                    "message": message.content,
+                }
+            )
+    return {
+        "text": text,
+        "previous_history": formatted_messages,
+        "chatbot_global_action": system,
+    }
+
+
+class ChatEdenAI(BaseChatModel):
+    """`EdenAI` chat large language models.
+
+    `EdenAI` is a versatile platform that allows you to access various language models
+    from different providers such as Google, OpenAI, Cohere, Mistral and more.
+
+    To get started, make sure you have the environment variable ``EDENAI_API_KEY``
+    set with your API key, or pass it as a named parameter to the constructor.
+
+    Additionally, `EdenAI` provides the flexibility to choose from a variety of models,
+    including the ones like "gpt-4".
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatEdenAI
+            from langchain_core.messages import HumanMessage
+
+            # Initialize `ChatEdenAI` with the desired configuration
+            chat = ChatEdenAI(
+                provider="openai",
+                model="gpt-4",
+                max_tokens=256,
+                temperature=0.75)
+
+            # Create a list of messages to interact with the model
+            messages = [HumanMessage(content="hello")]
+
+            # Invoke the model with the provided messages
+            chat.invoke(messages)
+
+    `EdenAI` goes beyond mere model invocation. It empowers you with advanced features :
+
+    - **Multiple Providers**: access to a diverse range of llms offered by various
+     providers giving you the freedom to choose the best-suited model for your use case.
+
+    - **Fallback Mechanism**: Set a fallback mechanism to ensure seamless operations
+        even if the primary provider is unavailable, you can easily switches to an
+        alternative provider.
+
+    - **Usage Statistics**: Track usage statistics on a per-project
+    and per-API key basis.
+    This feature allows you to monitor and manage resource consumption effectively.
+
+    - **Monitoring and Observability**: `EdenAI` provides comprehensive monitoring
+    and observability tools on the platform.
+
+    Example of setting up a fallback mechanism:
+        .. code-block:: python
+
+            # Initialize `ChatEdenAI` with a fallback provider
+            chat_with_fallback = ChatEdenAI(
+                provider="openai",
+                model="gpt-4",
+                max_tokens=256,
+                temperature=0.75,
+                fallback_provider="google")
+
+    you can find more details here : https://docs.edenai.co/reference/text_chat_create
+    """
+
+    provider: str = "openai"
+    """chat provider to use (eg: openai,google etc.)"""
+
+    model: Optional[str] = None
+    """
+    model name for above provider (eg: 'gpt-4' for openai)
+    available models are shown on https://docs.edenai.co/ under 'available providers'
+    """
+
+    max_tokens: int = 256
+    """Denotes the number of tokens to predict per generation."""
+
+    temperature: Optional[float] = 0
+    """A non-negative float that tunes the degree of randomness in generation."""
+
+    streaming: bool = False
+    """Whether to stream the results."""
+
+    fallback_providers: Optional[str] = None
+    """Providers in this will be used as fallback if the call to provider fails."""
+
+    edenai_api_url: str = "https://api.edenai.run/v2"
+
+    edenai_api_key: Optional[SecretStr] = Field(None, description="EdenAI API Token")
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        values["edenai_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "edenai_api_key", "EDENAI_API_KEY")
+        )
+        return values
+
+    @staticmethod
+    def get_user_agent() -> str:
+        from langchain_community import __version__
+
+        return f"langchain/{__version__}"
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "edenai-chat"
+
+    @property
+    def _api_key(self) -> str:
+        if self.edenai_api_key:
+            return self.edenai_api_key.get_secret_value()
+        return ""
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        """Call out to EdenAI's chat endpoint."""
+        url = f"{self.edenai_api_url}/text/chat/stream"
+        headers = {
+            "Authorization": f"Bearer {self._api_key}",
+            "User-Agent": self.get_user_agent(),
+        }
+        formatted_data = _format_edenai_messages(messages=messages)
+        payload: Dict[str, Any] = {
+            "providers": self.provider,
+            "max_tokens": self.max_tokens,
+            "temperature": self.temperature,
+            "fallback_providers": self.fallback_providers,
+            **formatted_data,
+            **kwargs,
+        }
+
+        payload = {k: v for k, v in payload.items() if v is not None}
+
+        if self.model is not None:
+            payload["settings"] = {self.provider: self.model}
+
+        request = Requests(headers=headers)
+        response = request.post(url=url, data=payload, stream=True)
+        response.raise_for_status()
+
+        for chunk_response in response.iter_lines():
+            chunk = json.loads(chunk_response.decode())
+            token = chunk["text"]
+            cg_chunk = ChatGenerationChunk(message=AIMessageChunk(content=token))
+            if run_manager:
+                run_manager.on_llm_new_token(token, chunk=cg_chunk)
+            yield cg_chunk
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        url = f"{self.edenai_api_url}/text/chat/stream"
+        headers = {
+            "Authorization": f"Bearer {self._api_key}",
+            "User-Agent": self.get_user_agent(),
+        }
+        formatted_data = _format_edenai_messages(messages=messages)
+        payload: Dict[str, Any] = {
+            "providers": self.provider,
+            "max_tokens": self.max_tokens,
+            "temperature": self.temperature,
+            "fallback_providers": self.fallback_providers,
+            **formatted_data,
+            **kwargs,
+        }
+
+        payload = {k: v for k, v in payload.items() if v is not None}
+
+        if self.model is not None:
+            payload["settings"] = {self.provider: self.model}
+
+        async with ClientSession() as session:
+            async with session.post(url, json=payload, headers=headers) as response:
+                response.raise_for_status()
+                async for chunk_response in response.content:
+                    chunk = json.loads(chunk_response.decode())
+                    token = chunk["text"]
+                    cg_chunk = ChatGenerationChunk(
+                        message=AIMessageChunk(content=token)
+                    )
+                    if run_manager:
+                        await run_manager.on_llm_new_token(
+                            token=chunk["text"], chunk=cg_chunk
+                        )
+                    yield cg_chunk
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Call out to EdenAI's chat endpoint."""
+        if self.streaming:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        url = f"{self.edenai_api_url}/text/chat"
+        headers = {
+            "Authorization": f"Bearer {self._api_key}",
+            "User-Agent": self.get_user_agent(),
+        }
+        formatted_data = _format_edenai_messages(messages=messages)
+        payload: Dict[str, Any] = {
+            "providers": self.provider,
+            "max_tokens": self.max_tokens,
+            "temperature": self.temperature,
+            "fallback_providers": self.fallback_providers,
+            **formatted_data,
+            **kwargs,
+        }
+
+        payload = {k: v for k, v in payload.items() if v is not None}
+
+        if self.model is not None:
+            payload["settings"] = {self.provider: self.model}
+
+        request = Requests(headers=headers)
+        response = request.post(url=url, data=payload)
+
+        response.raise_for_status()
+        data = response.json()
+        provider_response = data[self.provider]
+
+        if self.fallback_providers:
+            fallback_response = data.get(self.fallback_providers)
+            if fallback_response:
+                provider_response = fallback_response
+
+        if provider_response.get("status") == "fail":
+            err_msg = provider_response.get("error", {}).get("message")
+            raise Exception(err_msg)
+
+        return ChatResult(
+            generations=[
+                ChatGeneration(
+                    message=AIMessage(content=provider_response["generated_text"])
+                )
+            ],
+            llm_output=data,
+        )
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._astream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+
+        url = f"{self.edenai_api_url}/text/chat"
+        headers = {
+            "Authorization": f"Bearer {self._api_key}",
+            "User-Agent": self.get_user_agent(),
+        }
+        formatted_data = _format_edenai_messages(messages=messages)
+        payload: Dict[str, Any] = {
+            "providers": self.provider,
+            "max_tokens": self.max_tokens,
+            "temperature": self.temperature,
+            "fallback_providers": self.fallback_providers,
+            **formatted_data,
+            **kwargs,
+        }
+
+        payload = {k: v for k, v in payload.items() if v is not None}
+
+        if self.model is not None:
+            payload["settings"] = {self.provider: self.model}
+
+        async with ClientSession() as session:
+            async with session.post(url, json=payload, headers=headers) as response:
+                response.raise_for_status()
+                data = await response.json()
+                provider_response = data[self.provider]
+
+                if self.fallback_providers:
+                    fallback_response = data.get(self.fallback_providers)
+                    if fallback_response:
+                        provider_response = fallback_response
+
+                if provider_response.get("status") == "fail":
+                    err_msg = provider_response.get("error", {}).get("message")
+                    raise Exception(err_msg)
+
+                return ChatResult(
+                    generations=[
+                        ChatGeneration(
+                            message=AIMessage(
+                                content=provider_response["generated_text"]
+                            )
+                        )
+                    ],
+                    llm_output=data,
+                )
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/ernie.py b/llm/Lib/site-packages/langchain_community/chat_models/ernie.py
new file mode 100644
index 0000000000000000000000000000000000000000..8766038e3b129adc42294a5785d0d65140cd2c62
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/ernie.py
@@ -0,0 +1,228 @@
+import logging
+import threading
+from typing import Any, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    ChatMessage,
+    HumanMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatResult
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+def _convert_message_to_dict(message: BaseMessage) -> dict:
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": message.role, "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+    else:
+        raise ValueError(f"Got unknown type {message}")
+    return message_dict
+
+
+@deprecated(
+    since="0.0.13",
+    alternative="langchain_community.chat_models.QianfanChatEndpoint",
+)
+class ErnieBotChat(BaseChatModel):
+    """`ERNIE-Bot` large language model.
+
+    ERNIE-Bot is a large language model developed by Baidu,
+    covering a huge amount of Chinese data.
+
+    To use, you should have the `ernie_client_id` and `ernie_client_secret` set,
+    or set the environment variable `ERNIE_CLIENT_ID` and `ERNIE_CLIENT_SECRET`.
+
+    Note:
+    access_token will be automatically generated based on client_id and client_secret,
+    and will be regenerated after expiration (30 days).
+
+    Default model is `ERNIE-Bot-turbo`,
+    currently supported models are `ERNIE-Bot-turbo`, `ERNIE-Bot`, `ERNIE-Bot-8K`,
+    `ERNIE-Bot-4`, `ERNIE-Bot-turbo-AI`.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ErnieBotChat
+            chat = ErnieBotChat(model_name='ERNIE-Bot')
+
+
+    Deprecated Note:
+    Please use `QianfanChatEndpoint` instead of this class.
+    `QianfanChatEndpoint` is a more suitable choice for production.
+
+    Always test your code after changing to `QianfanChatEndpoint`.
+
+    Example of `QianfanChatEndpoint`:
+        .. code-block:: python
+
+            from langchain_community.chat_models import QianfanChatEndpoint
+            qianfan_chat = QianfanChatEndpoint(model="ERNIE-Bot",
+                endpoint="your_endpoint", qianfan_ak="your_ak", qianfan_sk="your_sk")
+
+    """
+
+    ernie_api_base: Optional[str] = None
+    """Baidu application custom endpoints"""
+
+    ernie_client_id: Optional[str] = None
+    """Baidu application client id"""
+
+    ernie_client_secret: Optional[str] = None
+    """Baidu application client secret"""
+
+    access_token: Optional[str] = None
+    """access token is generated by client id and client secret, 
+    setting this value directly will cause an error"""
+
+    model_name: str = "ERNIE-Bot-turbo"
+    """model name of ernie, default is `ERNIE-Bot-turbo`.
+      Currently supported `ERNIE-Bot-turbo`, `ERNIE-Bot`"""
+
+    system: Optional[str] = None
+    """system is mainly used for model character design, 
+    for example, you are an AI assistant produced by xxx company.
+    The length of the system is limiting of 1024 characters."""
+
+    request_timeout: Optional[int] = 60
+    """request timeout for chat http requests"""
+
+    streaming: Optional[bool] = False
+    """streaming mode. not supported yet."""
+
+    top_p: Optional[float] = 0.8
+    temperature: Optional[float] = 0.95
+    penalty_score: Optional[float] = 1
+
+    _lock = threading.Lock()
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        values["ernie_api_base"] = get_from_dict_or_env(
+            values, "ernie_api_base", "ERNIE_API_BASE", "https://aip.baidubce.com"
+        )
+        values["ernie_client_id"] = get_from_dict_or_env(
+            values,
+            "ernie_client_id",
+            "ERNIE_CLIENT_ID",
+        )
+        values["ernie_client_secret"] = get_from_dict_or_env(
+            values,
+            "ernie_client_secret",
+            "ERNIE_CLIENT_SECRET",
+        )
+        return values
+
+    def _chat(self, payload: object) -> dict:
+        base_url = f"{self.ernie_api_base}/rpc/2.0/ai_custom/v1/wenxinworkshop/chat"
+        model_paths = {
+            "ERNIE-Bot-turbo": "eb-instant",
+            "ERNIE-Bot": "completions",
+            "ERNIE-Bot-8K": "ernie_bot_8k",
+            "ERNIE-Bot-4": "completions_pro",
+            "ERNIE-Bot-turbo-AI": "ai_apaas",
+            "BLOOMZ-7B": "bloomz_7b1",
+            "Llama-2-7b-chat": "llama_2_7b",
+            "Llama-2-13b-chat": "llama_2_13b",
+            "Llama-2-70b-chat": "llama_2_70b",
+        }
+        if self.model_name in model_paths:
+            url = f"{base_url}/{model_paths[self.model_name]}"
+        else:
+            raise ValueError(f"Got unknown model_name {self.model_name}")
+
+        resp = requests.post(
+            url,
+            timeout=self.request_timeout,
+            headers={
+                "Content-Type": "application/json",
+            },
+            params={"access_token": self.access_token},
+            json=payload,
+        )
+        return resp.json()
+
+    def _refresh_access_token_with_lock(self) -> None:
+        with self._lock:
+            logger.debug("Refreshing access token")
+            base_url: str = f"{self.ernie_api_base}/oauth/2.0/token"
+            resp = requests.post(
+                base_url,
+                timeout=10,
+                headers={
+                    "Content-Type": "application/json",
+                    "Accept": "application/json",
+                },
+                params={
+                    "grant_type": "client_credentials",
+                    "client_id": self.ernie_client_id,
+                    "client_secret": self.ernie_client_secret,
+                },
+            )
+            self.access_token = str(resp.json().get("access_token"))
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            raise ValueError("`streaming` option currently unsupported.")
+
+        if not self.access_token:
+            self._refresh_access_token_with_lock()
+        payload = {
+            "messages": [_convert_message_to_dict(m) for m in messages],
+            "top_p": self.top_p,
+            "temperature": self.temperature,
+            "penalty_score": self.penalty_score,
+            "system": self.system,
+            **kwargs,
+        }
+        logger.debug(f"Payload for ernie api is {payload}")
+        resp = self._chat(payload)
+        if resp.get("error_code"):
+            if resp.get("error_code") == 111:
+                logger.debug("access_token expired, refresh it")
+                self._refresh_access_token_with_lock()
+                resp = self._chat(payload)
+            else:
+                raise ValueError(f"Error from ErnieChat api response: {resp}")
+        return self._create_chat_result(resp)
+
+    def _create_chat_result(self, response: Mapping[str, Any]) -> ChatResult:
+        if "function_call" in response:
+            additional_kwargs = {
+                "function_call": dict(response.get("function_call", {}))
+            }
+        else:
+            additional_kwargs = {}
+        generations = [
+            ChatGeneration(
+                message=AIMessage(
+                    content=response.get("result", ""),
+                    additional_kwargs={**additional_kwargs},
+                )
+            )
+        ]
+        token_usage = response.get("usage", {})
+        llm_output = {"token_usage": token_usage, "model_name": self.model_name}
+        return ChatResult(generations=generations, llm_output=llm_output)
+
+    @property
+    def _llm_type(self) -> str:
+        return "ernie-bot-chat"
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/everlyai.py b/llm/Lib/site-packages/langchain_community/chat_models/everlyai.py
new file mode 100644
index 0000000000000000000000000000000000000000..dca315d18995d424cd909b705915daa503bd66a3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/everlyai.py
@@ -0,0 +1,159 @@
+"""EverlyAI Endpoints chat wrapper. Relies heavily on ChatOpenAI."""
+from __future__ import annotations
+
+import logging
+import sys
+from typing import TYPE_CHECKING, Dict, Optional, Set
+
+from langchain_core.messages import BaseMessage
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.adapters.openai import convert_message_to_dict
+from langchain_community.chat_models.openai import (
+    ChatOpenAI,
+    _import_tiktoken,
+)
+
+if TYPE_CHECKING:
+    import tiktoken
+
+logger = logging.getLogger(__name__)
+
+
+DEFAULT_API_BASE = "https://everlyai.xyz/hosted"
+DEFAULT_MODEL = "meta-llama/Llama-2-7b-chat-hf"
+
+
+class ChatEverlyAI(ChatOpenAI):
+    """`EverlyAI` Chat large language models.
+
+    To use, you should have the ``openai`` python package installed, and the
+    environment variable ``EVERLYAI_API_KEY`` set with your API key.
+    Alternatively, you can use the everlyai_api_key keyword argument.
+
+    Any parameters that are valid to be passed to the `openai.create` call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatEverlyAI
+            chat = ChatEverlyAI(model_name="meta-llama/Llama-2-7b-chat-hf")
+    """
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "everlyai-chat"
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"everlyai_api_key": "EVERLYAI_API_KEY"}
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    everlyai_api_key: Optional[str] = None
+    """EverlyAI Endpoints API keys."""
+    model_name: str = Field(default=DEFAULT_MODEL, alias="model")
+    """Model name to use."""
+    everlyai_api_base: str = DEFAULT_API_BASE
+    """Base URL path for API requests."""
+    available_models: Optional[Set[str]] = None
+    """Available models from EverlyAI API."""
+
+    @staticmethod
+    def get_available_models() -> Set[str]:
+        """Get available models from EverlyAI API."""
+        # EverlyAI doesn't yet support dynamically query for available models.
+        return set(
+            [
+                "meta-llama/Llama-2-7b-chat-hf",
+                "meta-llama/Llama-2-13b-chat-hf-quantized",
+            ]
+        )
+
+    @root_validator(pre=True)
+    def validate_environment_override(cls, values: dict) -> dict:
+        """Validate that api key and python package exists in environment."""
+        values["openai_api_key"] = get_from_dict_or_env(
+            values,
+            "everlyai_api_key",
+            "EVERLYAI_API_KEY",
+        )
+        values["openai_api_base"] = DEFAULT_API_BASE
+
+        try:
+            import openai
+
+        except ImportError as e:
+            raise ValueError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`.",
+            ) from e
+        try:
+            values["client"] = openai.ChatCompletion
+        except AttributeError as exc:
+            raise ValueError(
+                "`openai` has no `ChatCompletion` attribute, this is likely "
+                "due to an old version of the openai package. Try upgrading it "
+                "with `pip install --upgrade openai`.",
+            ) from exc
+
+        if "model_name" not in values.keys():
+            values["model_name"] = DEFAULT_MODEL
+
+        model_name = values["model_name"]
+
+        available_models = cls.get_available_models()
+
+        if model_name not in available_models:
+            raise ValueError(
+                f"Model name {model_name} not found in available models: "
+                f"{available_models}.",
+            )
+
+        values["available_models"] = available_models
+
+        return values
+
+    def _get_encoding_model(self) -> tuple[str, tiktoken.Encoding]:
+        tiktoken_ = _import_tiktoken()
+        if self.tiktoken_model_name is not None:
+            model = self.tiktoken_model_name
+        else:
+            model = self.model_name
+        # Returns the number of tokens used by a list of messages.
+        try:
+            encoding = tiktoken_.encoding_for_model("gpt-3.5-turbo-0301")
+        except KeyError:
+            logger.warning("Warning: model not found. Using cl100k_base encoding.")
+            model = "cl100k_base"
+            encoding = tiktoken_.get_encoding(model)
+        return model, encoding
+
+    def get_num_tokens_from_messages(self, messages: list[BaseMessage]) -> int:
+        """Calculate num tokens with tiktoken package.
+
+        Official documentation: https://github.com/openai/openai-cookbook/blob/
+        main/examples/How_to_format_inputs_to_ChatGPT_models.ipynb"""
+        if sys.version_info[1] <= 7:
+            return super().get_num_tokens_from_messages(messages)
+        model, encoding = self._get_encoding_model()
+        tokens_per_message = 3
+        tokens_per_name = 1
+        num_tokens = 0
+        messages_dict = [convert_message_to_dict(m) for m in messages]
+        for message in messages_dict:
+            num_tokens += tokens_per_message
+            for key, value in message.items():
+                # Cast str(value) in case the message value is not a string
+                # This occurs with function messages
+                num_tokens += len(encoding.encode(str(value)))
+                if key == "name":
+                    num_tokens += tokens_per_name
+        # every reply is primed with <im_start>assistant
+        num_tokens += 3
+        return num_tokens
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/fake.py b/llm/Lib/site-packages/langchain_community/chat_models/fake.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ce4b00117b552887f0caec125460e50d3e204c3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/fake.py
@@ -0,0 +1,104 @@
+"""Fake ChatModel for testing purposes."""
+import asyncio
+import time
+from typing import Any, AsyncIterator, Dict, Iterator, List, Optional, Union
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel, SimpleChatModel
+from langchain_core.messages import AIMessageChunk, BaseMessage
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+
+
+class FakeMessagesListChatModel(BaseChatModel):
+    """Fake ChatModel for testing purposes."""
+
+    responses: List[BaseMessage]
+    sleep: Optional[float] = None
+    i: int = 0
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        response = self.responses[self.i]
+        if self.i < len(self.responses) - 1:
+            self.i += 1
+        else:
+            self.i = 0
+        generation = ChatGeneration(message=response)
+        return ChatResult(generations=[generation])
+
+    @property
+    def _llm_type(self) -> str:
+        return "fake-messages-list-chat-model"
+
+
+class FakeListChatModel(SimpleChatModel):
+    """Fake ChatModel for testing purposes."""
+
+    responses: List
+    sleep: Optional[float] = None
+    i: int = 0
+
+    @property
+    def _llm_type(self) -> str:
+        return "fake-list-chat-model"
+
+    def _call(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """First try to lookup in queries, else return 'foo' or 'bar'."""
+        response = self.responses[self.i]
+        if self.i < len(self.responses) - 1:
+            self.i += 1
+        else:
+            self.i = 0
+        return response
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Union[List[str], None] = None,
+        run_manager: Union[CallbackManagerForLLMRun, None] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        response = self.responses[self.i]
+        if self.i < len(self.responses) - 1:
+            self.i += 1
+        else:
+            self.i = 0
+        for c in response:
+            if self.sleep is not None:
+                time.sleep(self.sleep)
+            yield ChatGenerationChunk(message=AIMessageChunk(content=c))
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Union[List[str], None] = None,
+        run_manager: Union[AsyncCallbackManagerForLLMRun, None] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        response = self.responses[self.i]
+        if self.i < len(self.responses) - 1:
+            self.i += 1
+        else:
+            self.i = 0
+        for c in response:
+            if self.sleep is not None:
+                await asyncio.sleep(self.sleep)
+            yield ChatGenerationChunk(message=AIMessageChunk(content=c))
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        return {"responses": self.responses}
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/fireworks.py b/llm/Lib/site-packages/langchain_community/chat_models/fireworks.py
new file mode 100644
index 0000000000000000000000000000000000000000..3de28798939e7aae2a1c9c7b87a000a866635fc1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/fireworks.py
@@ -0,0 +1,371 @@
+from typing import (
+    Any,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+    Type,
+    Union,
+)
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.language_models.llms import create_base_retry_decorator
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    FunctionMessage,
+    FunctionMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+    SystemMessageChunk,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str
+from langchain_core.utils.env import get_from_dict_or_env
+
+from langchain_community.adapters.openai import convert_message_to_dict
+
+
+def _convert_delta_to_message_chunk(
+    _dict: Any, default_class: Type[BaseMessageChunk]
+) -> BaseMessageChunk:
+    """Convert a delta response to a message chunk."""
+    role = _dict.role
+    content = _dict.content or ""
+    additional_kwargs: Dict = {}
+
+    if role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=content)
+    elif role == "assistant" or default_class == AIMessageChunk:
+        return AIMessageChunk(content=content, additional_kwargs=additional_kwargs)
+    elif role == "system" or default_class == SystemMessageChunk:
+        return SystemMessageChunk(content=content)
+    elif role == "function" or default_class == FunctionMessageChunk:
+        return FunctionMessageChunk(content=content, name=_dict.name)
+    elif role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=content, role=role)
+    else:
+        return default_class(content=content)
+
+
+def convert_dict_to_message(_dict: Any) -> BaseMessage:
+    """Convert a dict response to a message."""
+    role = _dict.role
+    content = _dict.content or ""
+    if role == "user":
+        return HumanMessage(content=content)
+    elif role == "assistant":
+        content = _dict.content
+        additional_kwargs: Dict = {}
+        return AIMessage(content=content, additional_kwargs=additional_kwargs)
+    elif role == "system":
+        return SystemMessage(content=content)
+    elif role == "function":
+        return FunctionMessage(content=content, name=_dict.name)
+    else:
+        return ChatMessage(content=content, role=role)
+
+
+@deprecated(
+    since="0.0.26",
+    removal="0.2",
+    alternative_import="langchain_fireworks.ChatFireworks",
+)
+class ChatFireworks(BaseChatModel):
+    """Fireworks Chat models."""
+
+    model: str = "accounts/fireworks/models/llama-v2-7b-chat"
+    model_kwargs: dict = Field(
+        default_factory=lambda: {
+            "temperature": 0.7,
+            "max_tokens": 512,
+            "top_p": 1,
+        }.copy()
+    )
+    fireworks_api_key: Optional[SecretStr] = None
+    max_retries: int = 20
+    use_retry: bool = True
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"fireworks_api_key": "FIREWORKS_API_KEY"}
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "chat_models", "fireworks"]
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key in environment."""
+        try:
+            import fireworks.client
+        except ImportError as e:
+            raise ImportError(
+                "Could not import fireworks-ai python package. "
+                "Please install it with `pip install fireworks-ai`."
+            ) from e
+        fireworks_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "fireworks_api_key", "FIREWORKS_API_KEY")
+        )
+        fireworks.client.api_key = fireworks_api_key.get_secret_value()
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "fireworks-chat"
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        message_dicts = self._create_message_dicts(messages)
+
+        params = {
+            "model": self.model,
+            "messages": message_dicts,
+            **self.model_kwargs,
+            **kwargs,
+        }
+        response = completion_with_retry(
+            self,
+            self.use_retry,
+            run_manager=run_manager,
+            stop=stop,
+            **params,
+        )
+        return self._create_chat_result(response)
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        message_dicts = self._create_message_dicts(messages)
+        params = {
+            "model": self.model,
+            "messages": message_dicts,
+            **self.model_kwargs,
+            **kwargs,
+        }
+        response = await acompletion_with_retry(
+            self, self.use_retry, run_manager=run_manager, stop=stop, **params
+        )
+        return self._create_chat_result(response)
+
+    def _combine_llm_outputs(self, llm_outputs: List[Optional[dict]]) -> dict:
+        if llm_outputs[0] is None:
+            return {}
+        return llm_outputs[0]
+
+    def _create_chat_result(self, response: Any) -> ChatResult:
+        generations = []
+        for res in response.choices:
+            message = convert_dict_to_message(res.message)
+            gen = ChatGeneration(
+                message=message,
+                generation_info=dict(finish_reason=res.finish_reason),
+            )
+            generations.append(gen)
+        llm_output = {"model": self.model}
+        return ChatResult(generations=generations, llm_output=llm_output)
+
+    def _create_message_dicts(
+        self, messages: List[BaseMessage]
+    ) -> List[Dict[str, Any]]:
+        message_dicts = [convert_message_to_dict(m) for m in messages]
+        return message_dicts
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        message_dicts = self._create_message_dicts(messages)
+        default_chunk_class = AIMessageChunk
+        params = {
+            "model": self.model,
+            "messages": message_dicts,
+            "stream": True,
+            **self.model_kwargs,
+            **kwargs,
+        }
+        for chunk in completion_with_retry(
+            self, self.use_retry, run_manager=run_manager, stop=stop, **params
+        ):
+            choice = chunk.choices[0]
+            chunk = _convert_delta_to_message_chunk(choice.delta, default_chunk_class)
+            finish_reason = choice.finish_reason
+            generation_info = (
+                dict(finish_reason=finish_reason) if finish_reason is not None else None
+            )
+            default_chunk_class = chunk.__class__
+            cg_chunk = ChatGenerationChunk(
+                message=chunk, generation_info=generation_info
+            )
+            if run_manager:
+                run_manager.on_llm_new_token(cg_chunk.text, chunk=cg_chunk)
+            yield cg_chunk
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        message_dicts = self._create_message_dicts(messages)
+        default_chunk_class = AIMessageChunk
+        params = {
+            "model": self.model,
+            "messages": message_dicts,
+            "stream": True,
+            **self.model_kwargs,
+            **kwargs,
+        }
+        async for chunk in await acompletion_with_retry_streaming(
+            self, self.use_retry, run_manager=run_manager, stop=stop, **params
+        ):
+            choice = chunk.choices[0]
+            chunk = _convert_delta_to_message_chunk(choice.delta, default_chunk_class)
+            finish_reason = choice.finish_reason
+            generation_info = (
+                dict(finish_reason=finish_reason) if finish_reason is not None else None
+            )
+            default_chunk_class = chunk.__class__
+            cg_chunk = ChatGenerationChunk(
+                message=chunk, generation_info=generation_info
+            )
+            if run_manager:
+                await run_manager.on_llm_new_token(token=chunk.text, chunk=cg_chunk)
+            yield cg_chunk
+
+
+def conditional_decorator(
+    condition: bool, decorator: Callable[[Any], Any]
+) -> Callable[[Any], Any]:
+    """Define conditional decorator.
+
+    Args:
+        condition: The condition.
+        decorator: The decorator.
+
+    Returns:
+        The decorated function.
+    """
+
+    def actual_decorator(func: Callable[[Any], Any]) -> Callable[[Any], Any]:
+        if condition:
+            return decorator(func)
+        return func
+
+    return actual_decorator
+
+
+def completion_with_retry(
+    llm: ChatFireworks,
+    use_retry: bool,
+    *,
+    run_manager: Optional[CallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the completion call."""
+    import fireworks.client
+
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @conditional_decorator(use_retry, retry_decorator)
+    def _completion_with_retry(**kwargs: Any) -> Any:
+        """Use tenacity to retry the completion call."""
+        return fireworks.client.ChatCompletion.create(
+            **kwargs,
+        )
+
+    return _completion_with_retry(**kwargs)
+
+
+async def acompletion_with_retry(
+    llm: ChatFireworks,
+    use_retry: bool,
+    *,
+    run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the async completion call."""
+    import fireworks.client
+
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @conditional_decorator(use_retry, retry_decorator)
+    async def _completion_with_retry(**kwargs: Any) -> Any:
+        return await fireworks.client.ChatCompletion.acreate(
+            **kwargs,
+        )
+
+    return await _completion_with_retry(**kwargs)
+
+
+async def acompletion_with_retry_streaming(
+    llm: ChatFireworks,
+    use_retry: bool,
+    *,
+    run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the completion call for streaming."""
+    import fireworks.client
+
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @conditional_decorator(use_retry, retry_decorator)
+    async def _completion_with_retry(**kwargs: Any) -> Any:
+        return fireworks.client.ChatCompletion.acreate(
+            **kwargs,
+        )
+
+    return await _completion_with_retry(**kwargs)
+
+
+def _create_retry_decorator(
+    llm: ChatFireworks,
+    run_manager: Optional[
+        Union[AsyncCallbackManagerForLLMRun, CallbackManagerForLLMRun]
+    ] = None,
+) -> Callable[[Any], Any]:
+    """Define retry mechanism."""
+    import fireworks.client
+
+    errors = [
+        fireworks.client.error.RateLimitError,
+        fireworks.client.error.InternalServerError,
+        fireworks.client.error.BadGatewayError,
+        fireworks.client.error.ServiceUnavailableError,
+    ]
+    return create_base_retry_decorator(
+        error_types=errors, max_retries=llm.max_retries, run_manager=run_manager
+    )
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/friendli.py b/llm/Lib/site-packages/langchain_community/chat_models/friendli.py
new file mode 100644
index 0000000000000000000000000000000000000000..593c51ea9e0665b7be424fab01ec9f9f49ec9309
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/friendli.py
@@ -0,0 +1,217 @@
+from __future__ import annotations
+
+from typing import Any, AsyncIterator, Dict, Iterator, List, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    ChatMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+
+from langchain_community.llms.friendli import BaseFriendli
+
+
+def get_role(message: BaseMessage) -> str:
+    """Get role of the message.
+
+    Args:
+        message (BaseMessage): The message object.
+
+    Raises:
+        ValueError: Raised when the message is of an unknown type.
+
+    Returns:
+        str: The role of the message.
+    """
+    if isinstance(message, ChatMessage) or isinstance(message, HumanMessage):
+        return "user"
+    if isinstance(message, AIMessage):
+        return "assistant"
+    if isinstance(message, SystemMessage):
+        return "system"
+    raise ValueError(f"Got unknown type {message}")
+
+
+def get_chat_request(messages: List[BaseMessage]) -> Dict[str, Any]:
+    """Get a request of the Friendli chat API.
+
+    Args:
+        messages (List[BaseMessage]): Messages comprising the conversation so far.
+
+    Returns:
+        Dict[str, Any]: The request for the Friendli chat API.
+    """
+    return {
+        "messages": [
+            {"role": get_role(message), "content": message.content}
+            for message in messages
+        ]
+    }
+
+
+class ChatFriendli(BaseChatModel, BaseFriendli):
+    """Friendli LLM for chat.
+
+    ``friendli-client`` package should be installed with `pip install friendli-client`.
+    You must set ``FRIENDLI_TOKEN`` environment variable or provide the value of your
+    personal access token for the ``friendli_token`` argument.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import FriendliChat
+
+            chat = Friendli(
+                model="llama-2-13b-chat", friendli_token="YOUR FRIENDLI TOKEN"
+            )
+            chat.invoke("What is generative AI?")
+    """
+
+    model: str = "llama-2-13b-chat"
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"friendli_token": "FRIENDLI_TOKEN"}
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Friendli completions API."""
+        return {
+            "frequency_penalty": self.frequency_penalty,
+            "presence_penalty": self.presence_penalty,
+            "max_tokens": self.max_tokens,
+            "stop": self.stop,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+        }
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {"model": self.model, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        return "friendli-chat"
+
+    def _get_invocation_params(
+        self, stop: Optional[List[str]] = None, **kwargs: Any
+    ) -> Dict[str, Any]:
+        """Get the parameters used to invoke the model."""
+        params = self._default_params
+        if self.stop is not None and stop is not None:
+            raise ValueError("`stop` found in both the input and default params.")
+        elif self.stop is not None:
+            params["stop"] = self.stop
+        else:
+            params["stop"] = stop
+        return {**params, **kwargs}
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        params = self._get_invocation_params(stop=stop, **kwargs)
+        stream = self.client.chat.completions.create(
+            **get_chat_request(messages), stream=True, model=self.model, **params
+        )
+        for chunk in stream:
+            delta = chunk.choices[0].delta.content
+            if delta:
+                yield ChatGenerationChunk(message=AIMessageChunk(content=delta))
+                if run_manager:
+                    run_manager.on_llm_new_token(delta)
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        params = self._get_invocation_params(stop=stop, **kwargs)
+        stream = await self.async_client.chat.completions.create(
+            **get_chat_request(messages), stream=True, model=self.model, **params
+        )
+        async for chunk in stream:
+            delta = chunk.choices[0].delta.content
+            if delta:
+                yield ChatGenerationChunk(message=AIMessageChunk(content=delta))
+                if run_manager:
+                    await run_manager.on_llm_new_token(delta)
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        params = self._get_invocation_params(stop=stop, **kwargs)
+        response = self.client.chat.completions.create(
+            messages=[
+                {
+                    "role": get_role(message),
+                    "content": message.content,
+                }
+                for message in messages
+            ],
+            stream=False,
+            model=self.model,
+            **params,
+        )
+
+        message = AIMessage(content=response.choices[0].message.content)
+        return ChatResult(generations=[ChatGeneration(message=message)])
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._astream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+
+        params = self._get_invocation_params(stop=stop, **kwargs)
+        response = await self.async_client.chat.completions.create(
+            messages=[
+                {
+                    "role": get_role(message),
+                    "content": message.content,
+                }
+                for message in messages
+            ],
+            stream=False,
+            model=self.model,
+            **params,
+        )
+
+        message = AIMessage(content=response.choices[0].message.content)
+        return ChatResult(generations=[ChatGeneration(message=message)])
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/gigachat.py b/llm/Lib/site-packages/langchain_community/chat_models/gigachat.py
new file mode 100644
index 0000000000000000000000000000000000000000..7345aa4ad9c93d75d30e082c42dc03c3928a5f66
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/gigachat.py
@@ -0,0 +1,272 @@
+from __future__ import annotations
+
+import logging
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Type,
+)
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    FunctionMessage,
+    FunctionMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+    SystemMessageChunk,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+
+from langchain_community.llms.gigachat import _BaseGigaChat
+
+if TYPE_CHECKING:
+    import gigachat.models as gm
+
+logger = logging.getLogger(__name__)
+
+
+def _convert_dict_to_message(message: gm.Messages) -> BaseMessage:
+    from gigachat.models import FunctionCall, MessagesRole
+
+    additional_kwargs: Dict = {}
+    if function_call := message.function_call:
+        if isinstance(function_call, FunctionCall):
+            additional_kwargs["function_call"] = dict(function_call)
+        elif isinstance(function_call, dict):
+            additional_kwargs["function_call"] = function_call
+
+    if message.role == MessagesRole.SYSTEM:
+        return SystemMessage(content=message.content)
+    elif message.role == MessagesRole.USER:
+        return HumanMessage(content=message.content)
+    elif message.role == MessagesRole.ASSISTANT:
+        return AIMessage(content=message.content, additional_kwargs=additional_kwargs)
+    else:
+        raise TypeError(f"Got unknown role {message.role} {message}")
+
+
+def _convert_message_to_dict(message: gm.BaseMessage) -> gm.Messages:
+    from gigachat.models import Messages, MessagesRole
+
+    if isinstance(message, SystemMessage):
+        return Messages(role=MessagesRole.SYSTEM, content=message.content)
+    elif isinstance(message, HumanMessage):
+        return Messages(role=MessagesRole.USER, content=message.content)
+    elif isinstance(message, AIMessage):
+        return Messages(
+            role=MessagesRole.ASSISTANT,
+            content=message.content,
+            function_call=message.additional_kwargs.get("function_call", None),
+        )
+    elif isinstance(message, ChatMessage):
+        return Messages(role=MessagesRole(message.role), content=message.content)
+    elif isinstance(message, FunctionMessage):
+        return Messages(role=MessagesRole.FUNCTION, content=message.content)
+    else:
+        raise TypeError(f"Got unknown type {message}")
+
+
+def _convert_delta_to_message_chunk(
+    _dict: Mapping[str, Any], default_class: Type[BaseMessageChunk]
+) -> BaseMessageChunk:
+    role = _dict.get("role")
+    content = _dict.get("content") or ""
+    additional_kwargs: Dict = {}
+    if _dict.get("function_call"):
+        function_call = dict(_dict["function_call"])
+        if "name" in function_call and function_call["name"] is None:
+            function_call["name"] = ""
+        additional_kwargs["function_call"] = function_call
+
+    if role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=content)
+    elif role == "assistant" or default_class == AIMessageChunk:
+        return AIMessageChunk(content=content, additional_kwargs=additional_kwargs)
+    elif role == "system" or default_class == SystemMessageChunk:
+        return SystemMessageChunk(content=content)
+    elif role == "function" or default_class == FunctionMessageChunk:
+        return FunctionMessageChunk(content=content, name=_dict["name"])
+    elif role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=content, role=role)
+    else:
+        return default_class(content=content)
+
+
+class GigaChat(_BaseGigaChat, BaseChatModel):
+    """`GigaChat` large language models API.
+
+    To use, you should pass login and password to access GigaChat API or use token.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import GigaChat
+            giga = GigaChat(credentials=..., scope=..., verify_ssl_certs=False)
+    """
+
+    def _build_payload(self, messages: List[BaseMessage], **kwargs: Any) -> gm.Chat:
+        from gigachat.models import Chat
+
+        payload = Chat(
+            messages=[_convert_message_to_dict(m) for m in messages],
+        )
+
+        payload.functions = kwargs.get("functions", None)
+
+        if self.profanity_check is not None:
+            payload.profanity_check = self.profanity_check
+        if self.temperature is not None:
+            payload.temperature = self.temperature
+        if self.top_p is not None:
+            payload.top_p = self.top_p
+        if self.max_tokens is not None:
+            payload.max_tokens = self.max_tokens
+        if self.repetition_penalty is not None:
+            payload.repetition_penalty = self.repetition_penalty
+        if self.update_interval is not None:
+            payload.update_interval = self.update_interval
+
+        if self.verbose:
+            logger.warning("Giga request: %s", payload.dict())
+
+        return payload
+
+    def _create_chat_result(self, response: Any) -> ChatResult:
+        generations = []
+        for res in response.choices:
+            message = _convert_dict_to_message(res.message)
+            finish_reason = res.finish_reason
+            gen = ChatGeneration(
+                message=message,
+                generation_info={"finish_reason": finish_reason},
+            )
+            generations.append(gen)
+            if finish_reason != "stop":
+                logger.warning(
+                    "Giga generation stopped with reason: %s",
+                    finish_reason,
+                )
+            if self.verbose:
+                logger.warning("Giga response: %s", message.content)
+        llm_output = {"token_usage": response.usage, "model_name": response.model}
+        return ChatResult(generations=generations, llm_output=llm_output)
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        payload = self._build_payload(messages, **kwargs)
+        response = self._client.chat(payload)
+
+        return self._create_chat_result(response)
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._astream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+
+        payload = self._build_payload(messages, **kwargs)
+        response = await self._client.achat(payload)
+
+        return self._create_chat_result(response)
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        payload = self._build_payload(messages, **kwargs)
+
+        for chunk in self._client.stream(payload):
+            if not isinstance(chunk, dict):
+                chunk = chunk.dict()
+            if len(chunk["choices"]) == 0:
+                continue
+
+            choice = chunk["choices"][0]
+            content = choice.get("delta", {}).get("content", {})
+            chunk = _convert_delta_to_message_chunk(choice["delta"], AIMessageChunk)
+
+            finish_reason = choice.get("finish_reason")
+
+            generation_info = (
+                dict(finish_reason=finish_reason) if finish_reason is not None else None
+            )
+
+            if run_manager:
+                run_manager.on_llm_new_token(content)
+
+            yield ChatGenerationChunk(message=chunk, generation_info=generation_info)
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        payload = self._build_payload(messages, **kwargs)
+
+        async for chunk in self._client.astream(payload):
+            if not isinstance(chunk, dict):
+                chunk = chunk.dict()
+            if len(chunk["choices"]) == 0:
+                continue
+
+            choice = chunk["choices"][0]
+            content = choice.get("delta", {}).get("content", {})
+            chunk = _convert_delta_to_message_chunk(choice["delta"], AIMessageChunk)
+
+            finish_reason = choice.get("finish_reason")
+
+            generation_info = (
+                dict(finish_reason=finish_reason) if finish_reason is not None else None
+            )
+
+            yield ChatGenerationChunk(message=chunk, generation_info=generation_info)
+            if run_manager:
+                await run_manager.on_llm_new_token(content)
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/google_palm.py b/llm/Lib/site-packages/langchain_community/chat_models/google_palm.py
new file mode 100644
index 0000000000000000000000000000000000000000..79010bde86c784260d921c5c37b44315c81ecc4f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/google_palm.py
@@ -0,0 +1,348 @@
+"""Wrapper around Google's PaLM Chat API."""
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, cast
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    ChatMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatResult,
+)
+from langchain_core.pydantic_v1 import BaseModel, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+from tenacity import (
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+if TYPE_CHECKING:
+    import google.generativeai as genai
+
+logger = logging.getLogger(__name__)
+
+
+class ChatGooglePalmError(Exception):
+    """Error with the `Google PaLM` API."""
+
+
+def _truncate_at_stop_tokens(
+    text: str,
+    stop: Optional[List[str]],
+) -> str:
+    """Truncates text at the earliest stop token found."""
+    if stop is None:
+        return text
+
+    for stop_token in stop:
+        stop_token_idx = text.find(stop_token)
+        if stop_token_idx != -1:
+            text = text[:stop_token_idx]
+    return text
+
+
+def _response_to_result(
+    response: genai.types.ChatResponse,
+    stop: Optional[List[str]],
+) -> ChatResult:
+    """Converts a PaLM API response into a LangChain ChatResult."""
+    if not response.candidates:
+        raise ChatGooglePalmError("ChatResponse must have at least one candidate.")
+
+    generations: List[ChatGeneration] = []
+    for candidate in response.candidates:
+        author = candidate.get("author")
+        if author is None:
+            raise ChatGooglePalmError(f"ChatResponse must have an author: {candidate}")
+
+        content = _truncate_at_stop_tokens(candidate.get("content", ""), stop)
+        if content is None:
+            raise ChatGooglePalmError(f"ChatResponse must have a content: {candidate}")
+
+        if author == "ai":
+            generations.append(
+                ChatGeneration(text=content, message=AIMessage(content=content))
+            )
+        elif author == "human":
+            generations.append(
+                ChatGeneration(
+                    text=content,
+                    message=HumanMessage(content=content),
+                )
+            )
+        else:
+            generations.append(
+                ChatGeneration(
+                    text=content,
+                    message=ChatMessage(role=author, content=content),
+                )
+            )
+
+    return ChatResult(generations=generations)
+
+
+def _messages_to_prompt_dict(
+    input_messages: List[BaseMessage],
+) -> genai.types.MessagePromptDict:
+    """Converts a list of LangChain messages into a PaLM API MessagePrompt structure."""
+    import google.generativeai as genai
+
+    context: str = ""
+    examples: List[genai.types.MessageDict] = []
+    messages: List[genai.types.MessageDict] = []
+
+    remaining = list(enumerate(input_messages))
+
+    while remaining:
+        index, input_message = remaining.pop(0)
+
+        if isinstance(input_message, SystemMessage):
+            if index != 0:
+                raise ChatGooglePalmError("System message must be first input message.")
+            context = cast(str, input_message.content)
+        elif isinstance(input_message, HumanMessage) and input_message.example:
+            if messages:
+                raise ChatGooglePalmError(
+                    "Message examples must come before other messages."
+                )
+            _, next_input_message = remaining.pop(0)
+            if isinstance(next_input_message, AIMessage) and next_input_message.example:
+                examples.extend(
+                    [
+                        genai.types.MessageDict(
+                            author="human", content=input_message.content
+                        ),
+                        genai.types.MessageDict(
+                            author="ai", content=next_input_message.content
+                        ),
+                    ]
+                )
+            else:
+                raise ChatGooglePalmError(
+                    "Human example message must be immediately followed by an "
+                    " AI example response."
+                )
+        elif isinstance(input_message, AIMessage) and input_message.example:
+            raise ChatGooglePalmError(
+                "AI example message must be immediately preceded by a Human "
+                "example message."
+            )
+        elif isinstance(input_message, AIMessage):
+            messages.append(
+                genai.types.MessageDict(author="ai", content=input_message.content)
+            )
+        elif isinstance(input_message, HumanMessage):
+            messages.append(
+                genai.types.MessageDict(author="human", content=input_message.content)
+            )
+        elif isinstance(input_message, ChatMessage):
+            messages.append(
+                genai.types.MessageDict(
+                    author=input_message.role, content=input_message.content
+                )
+            )
+        else:
+            raise ChatGooglePalmError(
+                "Messages without an explicit role not supported by PaLM API."
+            )
+
+    return genai.types.MessagePromptDict(
+        context=context,
+        examples=examples,
+        messages=messages,
+    )
+
+
+def _create_retry_decorator() -> Callable[[Any], Any]:
+    """Returns a tenacity retry decorator, preconfigured to handle PaLM exceptions"""
+    import google.api_core.exceptions
+
+    multiplier = 2
+    min_seconds = 1
+    max_seconds = 60
+    max_retries = 10
+
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(max_retries),
+        wait=wait_exponential(multiplier=multiplier, min=min_seconds, max=max_seconds),
+        retry=(
+            retry_if_exception_type(google.api_core.exceptions.ResourceExhausted)
+            | retry_if_exception_type(google.api_core.exceptions.ServiceUnavailable)
+            | retry_if_exception_type(google.api_core.exceptions.GoogleAPIError)
+        ),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def chat_with_retry(llm: ChatGooglePalm, **kwargs: Any) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = _create_retry_decorator()
+
+    @retry_decorator
+    def _chat_with_retry(**kwargs: Any) -> Any:
+        return llm.client.chat(**kwargs)
+
+    return _chat_with_retry(**kwargs)
+
+
+async def achat_with_retry(llm: ChatGooglePalm, **kwargs: Any) -> Any:
+    """Use tenacity to retry the async completion call."""
+    retry_decorator = _create_retry_decorator()
+
+    @retry_decorator
+    async def _achat_with_retry(**kwargs: Any) -> Any:
+        # Use OpenAI's async api https://github.com/openai/openai-python#async-api
+        return await llm.client.chat_async(**kwargs)
+
+    return await _achat_with_retry(**kwargs)
+
+
+class ChatGooglePalm(BaseChatModel, BaseModel):
+    """`Google PaLM` Chat models API.
+
+    To use you must have the google.generativeai Python package installed and
+    either:
+
+        1. The ``GOOGLE_API_KEY``` environment variable set with your API key, or
+        2. Pass your API key using the google_api_key kwarg to the ChatGoogle
+           constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatGooglePalm
+            chat = ChatGooglePalm()
+
+    """
+
+    client: Any  #: :meta private:
+    model_name: str = "models/chat-bison-001"
+    """Model name to use."""
+    google_api_key: Optional[SecretStr] = None
+    temperature: Optional[float] = None
+    """Run inference with this temperature. Must by in the closed
+       interval [0.0, 1.0]."""
+    top_p: Optional[float] = None
+    """Decode using nucleus sampling: consider the smallest set of tokens whose
+       probability sum is at least top_p. Must be in the closed interval [0.0, 1.0]."""
+    top_k: Optional[int] = None
+    """Decode using top-k sampling: consider the set of top_k most probable tokens.
+       Must be positive."""
+    n: int = 1
+    """Number of chat completions to generate for each prompt. Note that the API may
+       not return the full n completions if duplicates are generated."""
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"google_api_key": "GOOGLE_API_KEY"}
+
+    @classmethod
+    def is_lc_serializable(self) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "chat_models", "google_palm"]
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate api key, python package exists, temperature, top_p, and top_k."""
+        google_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "google_api_key", "GOOGLE_API_KEY")
+        )
+        try:
+            import google.generativeai as genai
+
+            genai.configure(api_key=google_api_key.get_secret_value())
+        except ImportError:
+            raise ChatGooglePalmError(
+                "Could not import google.generativeai python package. "
+                "Please install it with `pip install google-generativeai`"
+            )
+
+        values["client"] = genai
+
+        if values["temperature"] is not None and not 0 <= values["temperature"] <= 1:
+            raise ValueError("temperature must be in the range [0.0, 1.0]")
+
+        if values["top_p"] is not None and not 0 <= values["top_p"] <= 1:
+            raise ValueError("top_p must be in the range [0.0, 1.0]")
+
+        if values["top_k"] is not None and values["top_k"] <= 0:
+            raise ValueError("top_k must be positive")
+
+        return values
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        prompt = _messages_to_prompt_dict(messages)
+
+        response: genai.types.ChatResponse = chat_with_retry(
+            self,
+            model=self.model_name,
+            prompt=prompt,
+            temperature=self.temperature,
+            top_p=self.top_p,
+            top_k=self.top_k,
+            candidate_count=self.n,
+            **kwargs,
+        )
+
+        return _response_to_result(response, stop)
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        prompt = _messages_to_prompt_dict(messages)
+
+        response: genai.types.ChatResponse = await achat_with_retry(
+            self,
+            model=self.model_name,
+            prompt=prompt,
+            temperature=self.temperature,
+            top_p=self.top_p,
+            top_k=self.top_k,
+            candidate_count=self.n,
+        )
+
+        return _response_to_result(response, stop)
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model_name": self.model_name,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            "top_k": self.top_k,
+            "n": self.n,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        return "google-palm-chat"
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/gpt_router.py b/llm/Lib/site-packages/langchain_community/chat_models/gpt_router.py
new file mode 100644
index 0000000000000000000000000000000000000000..626b9a765598543f37a7341c4209c474b5fced59
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/gpt_router.py
@@ -0,0 +1,394 @@
+from __future__ import annotations
+
+import logging
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncGenerator,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Generator,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.language_models.llms import create_base_retry_decorator
+from langchain_core.messages import AIMessageChunk, BaseMessage, BaseMessageChunk
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import BaseModel, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.adapters.openai import (
+    convert_dict_to_message,
+    convert_message_to_dict,
+)
+from langchain_community.chat_models.openai import _convert_delta_to_message_chunk
+
+if TYPE_CHECKING:
+    from gpt_router.models import ChunkedGenerationResponse, GenerationResponse
+
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_API_BASE_URL = "https://gpt-router-preview.writesonic.com"
+
+
+class GPTRouterException(Exception):
+    """Error with the `GPTRouter APIs`"""
+
+
+class GPTRouterModel(BaseModel):
+    """GPTRouter model."""
+
+    name: str
+    provider_name: str
+
+
+def get_ordered_generation_requests(
+    models_priority_list: List[GPTRouterModel], **kwargs: Any
+) -> List:
+    """
+    Return the body for the model router input.
+    """
+
+    from gpt_router.models import GenerationParams, ModelGenerationRequest
+
+    return [
+        ModelGenerationRequest(
+            model_name=model.name,
+            provider_name=model.provider_name,
+            order=index + 1,
+            prompt_params=GenerationParams(**kwargs),
+        )
+        for index, model in enumerate(models_priority_list)
+    ]
+
+
+def _create_retry_decorator(
+    llm: GPTRouter,
+    run_manager: Optional[
+        Union[AsyncCallbackManagerForLLMRun, CallbackManagerForLLMRun]
+    ] = None,
+) -> Callable[[Any], Any]:
+    from gpt_router import exceptions
+
+    errors = [
+        exceptions.GPTRouterApiTimeoutError,
+        exceptions.GPTRouterInternalServerError,
+        exceptions.GPTRouterNotAvailableError,
+        exceptions.GPTRouterTooManyRequestsError,
+    ]
+    return create_base_retry_decorator(
+        error_types=errors, max_retries=llm.max_retries, run_manager=run_manager
+    )
+
+
+def completion_with_retry(
+    llm: GPTRouter,
+    models_priority_list: List[GPTRouterModel],
+    run_manager: Optional[CallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Union[GenerationResponse, Generator[ChunkedGenerationResponse, None, None]]:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @retry_decorator
+    def _completion_with_retry(**kwargs: Any) -> Any:
+        ordered_generation_requests = get_ordered_generation_requests(
+            models_priority_list, **kwargs
+        )
+        return llm.client.generate(
+            ordered_generation_requests=ordered_generation_requests,
+            is_stream=kwargs.get("stream", False),
+        )
+
+    return _completion_with_retry(**kwargs)
+
+
+async def acompletion_with_retry(
+    llm: GPTRouter,
+    models_priority_list: List[GPTRouterModel],
+    run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Union[GenerationResponse, AsyncGenerator[ChunkedGenerationResponse, None]]:
+    """Use tenacity to retry the async completion call."""
+
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @retry_decorator
+    async def _completion_with_retry(**kwargs: Any) -> Any:
+        ordered_generation_requests = get_ordered_generation_requests(
+            models_priority_list, **kwargs
+        )
+        return await llm.client.agenerate(
+            ordered_generation_requests=ordered_generation_requests,
+            is_stream=kwargs.get("stream", False),
+        )
+
+    return await _completion_with_retry(**kwargs)
+
+
+class GPTRouter(BaseChatModel):
+    """GPTRouter by Writesonic Inc.
+
+    For more information, see https://gpt-router.writesonic.com/docs
+    """
+
+    client: Any = Field(default=None, exclude=True)  #: :meta private:
+    models_priority_list: List[GPTRouterModel] = Field(min_items=1)
+    gpt_router_api_base: str = Field(default=None)
+    """WriteSonic GPTRouter custom endpoint"""
+    gpt_router_api_key: Optional[SecretStr] = None
+    """WriteSonic GPTRouter API Key"""
+    temperature: float = 0.7
+    """What sampling temperature to use."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not explicitly specified."""
+    max_retries: int = 4
+    """Maximum number of retries to make when generating."""
+    streaming: bool = False
+    """Whether to stream the results or not."""
+    n: int = 1
+    """Number of chat completions to generate for each prompt."""
+    max_tokens: int = 256
+
+    @root_validator(allow_reuse=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        values["gpt_router_api_base"] = get_from_dict_or_env(
+            values,
+            "gpt_router_api_base",
+            "GPT_ROUTER_API_BASE",
+            DEFAULT_API_BASE_URL,
+        )
+
+        values["gpt_router_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "gpt_router_api_key",
+                "GPT_ROUTER_API_KEY",
+            )
+        )
+
+        try:
+            from gpt_router.client import GPTRouterClient
+
+        except ImportError:
+            raise GPTRouterException(
+                "Could not import GPTRouter python package. "
+                "Please install it with `pip install GPTRouter`."
+            )
+
+        gpt_router_client = GPTRouterClient(
+            values["gpt_router_api_base"],
+            values["gpt_router_api_key"].get_secret_value(),
+        )
+        values["client"] = gpt_router_client
+
+        return values
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"gpt_router_api_key": "GPT_ROUTER_API_KEY"}
+
+    @property
+    def lc_serializable(self) -> bool:
+        return True
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "gpt-router-chat"
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"models_priority_list": self.models_priority_list},
+            **self._default_params,
+        }
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling GPTRouter API."""
+        return {
+            "max_tokens": self.max_tokens,
+            "stream": self.streaming,
+            "n": self.n,
+            "temperature": self.temperature,
+            **self.model_kwargs,
+        }
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": False}
+        response = completion_with_retry(
+            self,
+            messages=message_dicts,
+            models_priority_list=self.models_priority_list,
+            run_manager=run_manager,
+            **params,
+        )
+        return self._create_chat_result(response)
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._astream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": False}
+        response = await acompletion_with_retry(
+            self,
+            messages=message_dicts,
+            models_priority_list=self.models_priority_list,
+            run_manager=run_manager,
+            **params,
+        )
+        return self._create_chat_result(response)
+
+    def _create_chat_generation_chunk(
+        self, data: Mapping[str, Any], default_chunk_class: Type[BaseMessageChunk]
+    ) -> Tuple[ChatGenerationChunk, Type[BaseMessageChunk]]:
+        chunk = _convert_delta_to_message_chunk(
+            {"content": data.get("text", "")}, default_chunk_class
+        )
+        finish_reason = data.get("finish_reason")
+        generation_info = (
+            dict(finish_reason=finish_reason) if finish_reason is not None else None
+        )
+        default_chunk_class = chunk.__class__
+        gen_chunk = ChatGenerationChunk(message=chunk, generation_info=generation_info)
+        return gen_chunk, default_chunk_class
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+
+        default_chunk_class: Type[BaseMessageChunk] = AIMessageChunk
+        generator_response = completion_with_retry(
+            self,
+            messages=message_dicts,
+            models_priority_list=self.models_priority_list,
+            run_manager=run_manager,
+            **params,
+        )
+        for chunk in generator_response:
+            if chunk.event != "update":
+                continue
+
+            chunk, default_chunk_class = self._create_chat_generation_chunk(
+                chunk.data, default_chunk_class
+            )
+
+            if run_manager:
+                run_manager.on_llm_new_token(
+                    token=chunk.message.content, chunk=chunk.message
+                )
+
+            yield chunk
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+
+        default_chunk_class: Type[BaseMessageChunk] = AIMessageChunk
+        generator_response = acompletion_with_retry(
+            self,
+            messages=message_dicts,
+            models_priority_list=self.models_priority_list,
+            run_manager=run_manager,
+            **params,
+        )
+        async for chunk in await generator_response:
+            if chunk.event != "update":
+                continue
+
+            chunk, default_chunk_class = self._create_chat_generation_chunk(
+                chunk.data, default_chunk_class
+            )
+
+            if run_manager:
+                await run_manager.on_llm_new_token(
+                    token=chunk.message.content, chunk=chunk.message
+                )
+
+            yield chunk
+
+    def _create_message_dicts(
+        self, messages: List[BaseMessage], stop: Optional[List[str]]
+    ) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+        params = self._default_params
+        if stop is not None:
+            if "stop" in params:
+                raise ValueError("`stop` found in both the input and default params.")
+            params["stop"] = stop
+        message_dicts = [convert_message_to_dict(m) for m in messages]
+        return message_dicts, params
+
+    def _create_chat_result(self, response: GenerationResponse) -> ChatResult:
+        generations = []
+        for res in response.choices:
+            message = convert_dict_to_message(
+                {
+                    "role": "assistant",
+                    "content": res.text,
+                }
+            )
+            gen = ChatGeneration(
+                message=message,
+                generation_info=dict(finish_reason=res.finish_reason),
+            )
+            generations.append(gen)
+        llm_output = {"token_usage": response.meta, "model": response.model}
+        return ChatResult(generations=generations, llm_output=llm_output)
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/huggingface.py b/llm/Lib/site-packages/langchain_community/chat_models/huggingface.py
new file mode 100644
index 0000000000000000000000000000000000000000..2bf5b9094856458e08ce2088d44c36accea5818a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/huggingface.py
@@ -0,0 +1,227 @@
+"""Hugging Face Chat Wrapper."""
+from typing import Any, AsyncIterator, Iterator, List, Optional
+
+from langchain_core.callbacks.manager import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatGenerationChunk,
+    ChatResult,
+    LLMResult,
+)
+from langchain_core.pydantic_v1 import root_validator
+
+from langchain_community.llms.huggingface_endpoint import HuggingFaceEndpoint
+from langchain_community.llms.huggingface_hub import HuggingFaceHub
+from langchain_community.llms.huggingface_text_gen_inference import (
+    HuggingFaceTextGenInference,
+)
+
+DEFAULT_SYSTEM_PROMPT = """You are a helpful, respectful, and honest assistant."""
+
+
+class ChatHuggingFace(BaseChatModel):
+    """
+    Wrapper for using Hugging Face LLM's as ChatModels.
+
+    Works with `HuggingFaceTextGenInference`, `HuggingFaceEndpoint`,
+    and `HuggingFaceHub` LLMs.
+
+    Upon instantiating this class, the model_id is resolved from the url
+    provided to the LLM, and the appropriate tokenizer is loaded from
+    the HuggingFace Hub.
+
+    Adapted from: https://python.langchain.com/docs/integrations/chat/llama2_chat
+    """
+
+    llm: Any
+    """LLM, must be of type HuggingFaceTextGenInference, HuggingFaceEndpoint, or 
+        HuggingFaceHub."""
+    system_message: SystemMessage = SystemMessage(content=DEFAULT_SYSTEM_PROMPT)
+    tokenizer: Any = None
+    model_id: Optional[str] = None
+    streaming: bool = False
+
+    def __init__(self, **kwargs: Any):
+        super().__init__(**kwargs)
+
+        from transformers import AutoTokenizer
+
+        self._resolve_model_id()
+
+        self.tokenizer = (
+            AutoTokenizer.from_pretrained(self.model_id)
+            if self.tokenizer is None
+            else self.tokenizer
+        )
+
+    @root_validator()
+    def validate_llm(cls, values: dict) -> dict:
+        if not isinstance(
+            values["llm"],
+            (HuggingFaceTextGenInference, HuggingFaceEndpoint, HuggingFaceHub),
+        ):
+            raise TypeError(
+                "Expected llm to be one of HuggingFaceTextGenInference, "
+                f"HuggingFaceEndpoint, HuggingFaceHub, received {type(values['llm'])}"
+            )
+        return values
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        request = self._to_chat_prompt(messages)
+
+        for data in self.llm.stream(request, **kwargs):
+            delta = data
+            chunk = ChatGenerationChunk(message=AIMessageChunk(content=delta))
+            if run_manager:
+                run_manager.on_llm_new_token(delta, chunk=chunk)
+            yield chunk
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        request = self._to_chat_prompt(messages)
+        async for data in self.llm.astream(request, **kwargs):
+            delta = data
+            chunk = ChatGenerationChunk(message=AIMessageChunk(content=delta))
+            if run_manager:
+                await run_manager.on_llm_new_token(delta, chunk=chunk)
+            yield chunk
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        llm_input = self._to_chat_prompt(messages)
+        llm_result = self.llm._generate(
+            prompts=[llm_input], stop=stop, run_manager=run_manager, **kwargs
+        )
+        return self._to_chat_result(llm_result)
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._astream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+
+        llm_input = self._to_chat_prompt(messages)
+        llm_result = await self.llm._agenerate(
+            prompts=[llm_input], stop=stop, run_manager=run_manager, **kwargs
+        )
+        return self._to_chat_result(llm_result)
+
+    def _to_chat_prompt(
+        self,
+        messages: List[BaseMessage],
+    ) -> str:
+        """Convert a list of messages into a prompt format expected by wrapped LLM."""
+        if not messages:
+            raise ValueError("At least one HumanMessage must be provided!")
+
+        if not isinstance(messages[-1], HumanMessage):
+            raise ValueError("Last message must be a HumanMessage!")
+
+        messages_dicts = [self._to_chatml_format(m) for m in messages]
+
+        return self.tokenizer.apply_chat_template(
+            messages_dicts, tokenize=False, add_generation_prompt=True
+        )
+
+    def _to_chatml_format(self, message: BaseMessage) -> dict:
+        """Convert LangChain message to ChatML format."""
+
+        if isinstance(message, SystemMessage):
+            role = "system"
+        elif isinstance(message, AIMessage):
+            role = "assistant"
+        elif isinstance(message, HumanMessage):
+            role = "user"
+        else:
+            raise ValueError(f"Unknown message type: {type(message)}")
+
+        return {"role": role, "content": message.content}
+
+    @staticmethod
+    def _to_chat_result(llm_result: LLMResult) -> ChatResult:
+        chat_generations = []
+
+        for g in llm_result.generations[0]:
+            chat_generation = ChatGeneration(
+                message=AIMessage(content=g.text), generation_info=g.generation_info
+            )
+            chat_generations.append(chat_generation)
+
+        return ChatResult(
+            generations=chat_generations, llm_output=llm_result.llm_output
+        )
+
+    def _resolve_model_id(self) -> None:
+        """Resolve the model_id from the LLM's inference_server_url"""
+
+        from huggingface_hub import list_inference_endpoints
+
+        available_endpoints = list_inference_endpoints("*")
+        if isinstance(self.llm, HuggingFaceHub) or (
+            hasattr(self.llm, "repo_id") and self.llm.repo_id
+        ):
+            self.model_id = self.llm.repo_id
+            return
+        elif isinstance(self.llm, HuggingFaceTextGenInference):
+            endpoint_url: Optional[str] = self.llm.inference_server_url
+        else:
+            endpoint_url = self.llm.endpoint_url
+
+        for endpoint in available_endpoints:
+            if endpoint.url == endpoint_url:
+                self.model_id = endpoint.repository
+
+        if not self.model_id:
+            raise ValueError(
+                "Failed to resolve model_id:"
+                f"Could not find model id for inference server: {endpoint_url}"
+                "Make sure that your Hugging Face token has access to the endpoint."
+            )
+
+    @property
+    def _llm_type(self) -> str:
+        return "huggingface-chat-wrapper"
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/human.py b/llm/Lib/site-packages/langchain_community/chat_models/human.py
new file mode 100644
index 0000000000000000000000000000000000000000..030516a822f7cfdae598360752ddd5ea5cfb454a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/human.py
@@ -0,0 +1,111 @@
+"""ChatModel wrapper which returns user input as the response.."""
+
+from io import StringIO
+from typing import Any, Callable, Dict, List, Mapping, Optional
+
+import yaml
+from langchain_core.callbacks import (
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    BaseMessage,
+    HumanMessage,
+    _message_from_dict,
+    messages_to_dict,
+)
+from langchain_core.outputs import ChatGeneration, ChatResult
+from langchain_core.pydantic_v1 import Field
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+
+def _display_messages(messages: List[BaseMessage]) -> None:
+    dict_messages = messages_to_dict(messages)
+    for message in dict_messages:
+        yaml_string = yaml.dump(
+            message,
+            default_flow_style=False,
+            sort_keys=False,
+            allow_unicode=True,
+            width=10000,
+            line_break=None,
+        )
+        print("\n", "======= start of message =======", "\n\n")  # noqa: T201
+        print(yaml_string)  # noqa: T201
+        print("======= end of message =======", "\n\n")  # noqa: T201
+
+
+def _collect_yaml_input(
+    messages: List[BaseMessage], stop: Optional[List[str]] = None
+) -> BaseMessage:
+    """Collects and returns user input as a single string."""
+    lines = []
+    while True:
+        line = input()
+        if not line.strip():
+            break
+        if stop and any(seq in line for seq in stop):
+            break
+        lines.append(line)
+    yaml_string = "\n".join(lines)
+
+    # Try to parse the input string as YAML
+    try:
+        message = _message_from_dict(yaml.safe_load(StringIO(yaml_string)))
+        if message is None:
+            return HumanMessage(content="")
+        if stop:
+            if isinstance(message.content, str):
+                message.content = enforce_stop_tokens(message.content, stop)
+            else:
+                raise ValueError("Cannot use when output is not a string.")
+        return message
+    except yaml.YAMLError:
+        raise ValueError("Invalid YAML string entered.")
+    except ValueError:
+        raise ValueError("Invalid message entered.")
+
+
+class HumanInputChatModel(BaseChatModel):
+    """ChatModel which returns user input as the response."""
+
+    input_func: Callable = Field(default_factory=lambda: _collect_yaml_input)
+    message_func: Callable = Field(default_factory=lambda: _display_messages)
+    separator: str = "\n"
+    input_kwargs: Mapping[str, Any] = {}
+    message_kwargs: Mapping[str, Any] = {}
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        return {
+            "input_func": self.input_func.__name__,
+            "message_func": self.message_func.__name__,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Returns the type of LLM."""
+        return "human-input-chat-model"
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """
+        Displays the messages to the user and returns their input as a response.
+
+        Args:
+            messages (List[BaseMessage]): The messages to be displayed to the user.
+            stop (Optional[List[str]]): A list of stop strings.
+            run_manager (Optional[CallbackManagerForLLMRun]): Currently not used.
+
+        Returns:
+            ChatResult: The user's input as a response.
+        """
+        self.message_func(messages, **self.message_kwargs)
+        user_input = self.input_func(messages, stop=stop, **self.input_kwargs)
+        return ChatResult(generations=[ChatGeneration(message=user_input)])
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/hunyuan.py b/llm/Lib/site-packages/langchain_community/chat_models/hunyuan.py
new file mode 100644
index 0000000000000000000000000000000000000000..7eef887a5fbe96aa7936d051a7ea585f6a14e0cd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/hunyuan.py
@@ -0,0 +1,322 @@
+import base64
+import hashlib
+import hmac
+import json
+import logging
+import time
+from typing import Any, Dict, Iterator, List, Mapping, Optional, Type
+from urllib.parse import urlparse
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import (
+    convert_to_secret_str,
+    get_from_dict_or_env,
+    get_pydantic_field_names,
+)
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_API_BASE = "https://hunyuan.cloud.tencent.com"
+DEFAULT_PATH = "/hyllm/v1/chat/completions"
+
+
+def _convert_message_to_dict(message: BaseMessage) -> dict:
+    message_dict: Dict[str, Any]
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": message.role, "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+    else:
+        raise TypeError(f"Got unknown type {message}")
+
+    return message_dict
+
+
+def _convert_dict_to_message(_dict: Mapping[str, Any]) -> BaseMessage:
+    role = _dict["role"]
+    if role == "user":
+        return HumanMessage(content=_dict["content"])
+    elif role == "assistant":
+        return AIMessage(content=_dict.get("content", "") or "")
+    else:
+        return ChatMessage(content=_dict["content"], role=role)
+
+
+def _convert_delta_to_message_chunk(
+    _dict: Mapping[str, Any], default_class: Type[BaseMessageChunk]
+) -> BaseMessageChunk:
+    role = _dict.get("role")
+    content = _dict.get("content") or ""
+
+    if role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=content)
+    elif role == "assistant" or default_class == AIMessageChunk:
+        return AIMessageChunk(content=content)
+    elif role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=content, role=role)
+    else:
+        return default_class(content=content)
+
+
+# signature generation
+# https://cloud.tencent.com/document/product/1729/97732#532252ce-e960-48a7-8821-940a9ce2ccf3
+def _signature(secret_key: SecretStr, url: str, payload: Dict[str, Any]) -> str:
+    sorted_keys = sorted(payload.keys())
+
+    url_info = urlparse(url)
+
+    sign_str = url_info.netloc + url_info.path + "?"
+
+    for key in sorted_keys:
+        value = payload[key]
+
+        if isinstance(value, list) or isinstance(value, dict):
+            value = json.dumps(value, separators=(",", ":"))
+        elif isinstance(value, float):
+            value = "%g" % value
+
+        sign_str = sign_str + key + "=" + str(value) + "&"
+
+    sign_str = sign_str[:-1]
+
+    hmacstr = hmac.new(
+        key=secret_key.get_secret_value().encode("utf-8"),
+        msg=sign_str.encode("utf-8"),
+        digestmod=hashlib.sha1,
+    ).digest()
+
+    return base64.b64encode(hmacstr).decode("utf-8")
+
+
+def _create_chat_result(response: Mapping[str, Any]) -> ChatResult:
+    generations = []
+    for choice in response["choices"]:
+        message = _convert_dict_to_message(choice["messages"])
+        generations.append(ChatGeneration(message=message))
+
+    token_usage = response["usage"]
+    llm_output = {"token_usage": token_usage}
+    return ChatResult(generations=generations, llm_output=llm_output)
+
+
+class ChatHunyuan(BaseChatModel):
+    """Tencent Hunyuan chat models API by Tencent.
+
+    For more information, see https://cloud.tencent.com/document/product/1729
+    """
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {
+            "hunyuan_app_id": "HUNYUAN_APP_ID",
+            "hunyuan_secret_id": "HUNYUAN_SECRET_ID",
+            "hunyuan_secret_key": "HUNYUAN_SECRET_KEY",
+        }
+
+    @property
+    def lc_serializable(self) -> bool:
+        return True
+
+    hunyuan_api_base: str = Field(default=DEFAULT_API_BASE)
+    """Hunyuan custom endpoints"""
+    hunyuan_app_id: Optional[int] = None
+    """Hunyuan App ID"""
+    hunyuan_secret_id: Optional[str] = None
+    """Hunyuan Secret ID"""
+    hunyuan_secret_key: Optional[SecretStr] = None
+    """Hunyuan Secret Key"""
+    streaming: bool = False
+    """Whether to stream the results or not."""
+    request_timeout: int = 60
+    """Timeout for requests to Hunyuan API. Default is 60 seconds."""
+
+    query_id: Optional[str] = None
+    """Query id for troubleshooting"""
+    temperature: float = 1.0
+    """What sampling temperature to use."""
+    top_p: float = 1.0
+    """What probability mass to use."""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for API call not explicitly specified."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name in extra:
+                raise ValueError(f"Found {field_name} supplied twice.")
+            if field_name not in all_required_field_names:
+                logger.warning(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+
+        invalid_model_kwargs = all_required_field_names.intersection(extra.keys())
+        if invalid_model_kwargs:
+            raise ValueError(
+                f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+                f"Instead they were passed in as part of `model_kwargs` parameter."
+            )
+
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        values["hunyuan_api_base"] = get_from_dict_or_env(
+            values,
+            "hunyuan_api_base",
+            "HUNYUAN_API_BASE",
+            DEFAULT_API_BASE,
+        )
+        values["hunyuan_app_id"] = get_from_dict_or_env(
+            values,
+            "hunyuan_app_id",
+            "HUNYUAN_APP_ID",
+        )
+        values["hunyuan_secret_id"] = get_from_dict_or_env(
+            values,
+            "hunyuan_secret_id",
+            "HUNYUAN_SECRET_ID",
+        )
+        values["hunyuan_secret_key"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "hunyuan_secret_key",
+                "HUNYUAN_SECRET_KEY",
+            )
+        )
+
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Hunyuan API."""
+        normal_params = {
+            "app_id": self.hunyuan_app_id,
+            "secret_id": self.hunyuan_secret_id,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+        }
+
+        if self.query_id is not None:
+            normal_params["query_id"] = self.query_id
+
+        return {**normal_params, **self.model_kwargs}
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._stream(
+                messages=messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        res = self._chat(messages, **kwargs)
+
+        response = res.json()
+
+        if "error" in response:
+            raise ValueError(f"Error from Hunyuan api response: {response}")
+
+        return _create_chat_result(response)
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        res = self._chat(messages, **kwargs)
+
+        default_chunk_class = AIMessageChunk
+        for chunk in res.iter_lines():
+            response = json.loads(chunk)
+            if "error" in response:
+                raise ValueError(f"Error from Hunyuan api response: {response}")
+
+            for choice in response["choices"]:
+                chunk = _convert_delta_to_message_chunk(
+                    choice["delta"], default_chunk_class
+                )
+                default_chunk_class = chunk.__class__
+                cg_chunk = ChatGenerationChunk(message=chunk)
+                if run_manager:
+                    run_manager.on_llm_new_token(chunk.content, chunk=cg_chunk)
+                yield cg_chunk
+
+    def _chat(self, messages: List[BaseMessage], **kwargs: Any) -> requests.Response:
+        if self.hunyuan_secret_key is None:
+            raise ValueError("Hunyuan secret key is not set.")
+
+        parameters = {**self._default_params, **kwargs}
+
+        headers = parameters.pop("headers", {})
+        timestamp = parameters.pop("timestamp", int(time.time()))
+        expired = parameters.pop("expired", timestamp + 24 * 60 * 60)
+
+        payload = {
+            "timestamp": timestamp,
+            "expired": expired,
+            "messages": [_convert_message_to_dict(m) for m in messages],
+            **parameters,
+        }
+
+        if self.streaming:
+            payload["stream"] = 1
+
+        url = self.hunyuan_api_base + DEFAULT_PATH
+
+        res = requests.post(
+            url=url,
+            timeout=self.request_timeout,
+            headers={
+                "Content-Type": "application/json",
+                "Authorization": _signature(
+                    secret_key=self.hunyuan_secret_key, url=url, payload=payload
+                ),
+                **headers,
+            },
+            json=payload,
+            stream=self.streaming,
+        )
+        return res
+
+    @property
+    def _llm_type(self) -> str:
+        return "hunyuan-chat"
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/javelin_ai_gateway.py b/llm/Lib/site-packages/langchain_community/chat_models/javelin_ai_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..6c90103fae902ba6f7a1c2c4fe151b95575d65a1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/javelin_ai_gateway.py
@@ -0,0 +1,224 @@
+import logging
+from typing import Any, Dict, List, Mapping, Optional, cast
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    ChatMessage,
+    FunctionMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatResult,
+)
+from langchain_core.pydantic_v1 import BaseModel, Extra, SecretStr
+
+logger = logging.getLogger(__name__)
+
+
+# Ignoring type because below is valid pydantic code
+# Unexpected keyword argument "extra" for "__init_subclass__" of "object"  [call-arg]
+class ChatParams(BaseModel, extra=Extra.allow):
+    """Parameters for the `Javelin AI Gateway` LLM."""
+
+    temperature: float = 0.0
+    stop: Optional[List[str]] = None
+    max_tokens: Optional[int] = None
+
+
+class ChatJavelinAIGateway(BaseChatModel):
+    """`Javelin AI Gateway` chat models API.
+
+    To use, you should have the ``javelin_sdk`` python package installed.
+    For more information, see https://docs.getjavelin.io
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatJavelinAIGateway
+
+            chat = ChatJavelinAIGateway(
+                gateway_uri="<javelin-ai-gateway-uri>",
+                route="<javelin-ai-gateway-chat-route>",
+                params={
+                    "temperature": 0.1
+                }
+            )
+    """
+
+    route: str
+    """The route to use for the Javelin AI Gateway API."""
+
+    gateway_uri: Optional[str] = None
+    """The URI for the Javelin AI Gateway API."""
+
+    params: Optional[ChatParams] = None
+    """Parameters for the Javelin AI Gateway LLM."""
+
+    client: Any
+    """javelin client."""
+
+    javelin_api_key: Optional[SecretStr] = None
+    """The API key for the Javelin AI Gateway."""
+
+    def __init__(self, **kwargs: Any):
+        try:
+            from javelin_sdk import (
+                JavelinClient,
+                UnauthorizedError,
+            )
+        except ImportError:
+            raise ImportError(
+                "Could not import javelin_sdk python package. "
+                "Please install it with `pip install javelin_sdk`."
+            )
+
+        super().__init__(**kwargs)
+        if self.gateway_uri:
+            try:
+                self.client = JavelinClient(
+                    base_url=self.gateway_uri,
+                    api_key=cast(SecretStr, self.javelin_api_key).get_secret_value(),
+                )
+            except UnauthorizedError as e:
+                raise ValueError("Javelin: Incorrect API Key.") from e
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        params: Dict[str, Any] = {
+            "gateway_uri": self.gateway_uri,
+            "javelin_api_key": cast(SecretStr, self.javelin_api_key).get_secret_value(),
+            "route": self.route,
+            **(self.params.dict() if self.params else {}),
+        }
+        return params
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        message_dicts = [
+            ChatJavelinAIGateway._convert_message_to_dict(message)
+            for message in messages
+        ]
+        data: Dict[str, Any] = {
+            "messages": message_dicts,
+            **(self.params.dict() if self.params else {}),
+        }
+
+        resp = self.client.query_route(self.route, query_body=data)
+
+        return ChatJavelinAIGateway._create_chat_result(resp.dict())
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        message_dicts = [
+            ChatJavelinAIGateway._convert_message_to_dict(message)
+            for message in messages
+        ]
+        data: Dict[str, Any] = {
+            "messages": message_dicts,
+            **(self.params.dict() if self.params else {}),
+        }
+
+        resp = await self.client.aquery_route(self.route, query_body=data)
+
+        return ChatJavelinAIGateway._create_chat_result(resp.dict())
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        return self._default_params
+
+    def _get_invocation_params(
+        self, stop: Optional[List[str]] = None, **kwargs: Any
+    ) -> Dict[str, Any]:
+        """Get the parameters used to invoke the model FOR THE CALLBACKS."""
+        return {
+            **self._default_params,
+            **super()._get_invocation_params(stop=stop, **kwargs),
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "javelin-ai-gateway-chat"
+
+    @staticmethod
+    def _convert_dict_to_message(_dict: Mapping[str, Any]) -> BaseMessage:
+        role = _dict["role"]
+        content = _dict["content"]
+        if role == "user":
+            return HumanMessage(content=content)
+        elif role == "assistant":
+            return AIMessage(content=content)
+        elif role == "system":
+            return SystemMessage(content=content)
+        else:
+            return ChatMessage(content=content, role=role)
+
+    @staticmethod
+    def _raise_functions_not_supported() -> None:
+        raise ValueError(
+            "Function messages are not supported by the Javelin AI Gateway. Please"
+            " create a feature request at https://docs.getjavelin.io"
+        )
+
+    @staticmethod
+    def _convert_message_to_dict(message: BaseMessage) -> dict:
+        if isinstance(message, ChatMessage):
+            message_dict = {"role": message.role, "content": message.content}
+        elif isinstance(message, HumanMessage):
+            message_dict = {"role": "user", "content": message.content}
+        elif isinstance(message, AIMessage):
+            message_dict = {"role": "assistant", "content": message.content}
+        elif isinstance(message, SystemMessage):
+            message_dict = {"role": "system", "content": message.content}
+        elif isinstance(message, FunctionMessage):
+            raise ValueError(
+                "Function messages are not supported by the Javelin AI Gateway. Please"
+                " create a feature request at https://docs.getjavelin.io"
+            )
+        else:
+            raise ValueError(f"Got unknown message type: {message}")
+
+        if "function_call" in message.additional_kwargs:
+            ChatJavelinAIGateway._raise_functions_not_supported()
+        if message.additional_kwargs:
+            logger.warning(
+                "Additional message arguments are unsupported by Javelin AI Gateway "
+                " and will be ignored: %s",
+                message.additional_kwargs,
+            )
+        return message_dict
+
+    @staticmethod
+    def _create_chat_result(response: Mapping[str, Any]) -> ChatResult:
+        generations = []
+        for candidate in response["llm_response"]["choices"]:
+            message = ChatJavelinAIGateway._convert_dict_to_message(
+                candidate["message"]
+            )
+            message_metadata = candidate.get("metadata", {})
+            gen = ChatGeneration(
+                message=message,
+                generation_info=dict(message_metadata),
+            )
+            generations.append(gen)
+
+        response_metadata = response.get("metadata", {})
+        return ChatResult(generations=generations, llm_output=response_metadata)
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/jinachat.py b/llm/Lib/site-packages/langchain_community/chat_models/jinachat.py
new file mode 100644
index 0000000000000000000000000000000000000000..e6744c8ed6ca022d6060ccebb7854ac2c083b87d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/jinachat.py
@@ -0,0 +1,412 @@
+"""JinaChat wrapper."""
+from __future__ import annotations
+
+import logging
+from typing import (
+    Any,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    FunctionMessage,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+    SystemMessageChunk,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import (
+    convert_to_secret_str,
+    get_from_dict_or_env,
+    get_pydantic_field_names,
+)
+from tenacity import (
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def _create_retry_decorator(llm: JinaChat) -> Callable[[Any], Any]:
+    import openai
+
+    min_seconds = 1
+    max_seconds = 60
+    # Wait 2^x * 1 second between each retry starting with
+    # 4 seconds, then up to 10 seconds, then 10 seconds afterwards
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(llm.max_retries),
+        wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+        retry=(
+            retry_if_exception_type(openai.error.Timeout)
+            | retry_if_exception_type(openai.error.APIError)
+            | retry_if_exception_type(openai.error.APIConnectionError)
+            | retry_if_exception_type(openai.error.RateLimitError)
+            | retry_if_exception_type(openai.error.ServiceUnavailableError)
+        ),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+async def acompletion_with_retry(llm: JinaChat, **kwargs: Any) -> Any:
+    """Use tenacity to retry the async completion call."""
+    retry_decorator = _create_retry_decorator(llm)
+
+    @retry_decorator
+    async def _completion_with_retry(**kwargs: Any) -> Any:
+        # Use OpenAI's async api https://github.com/openai/openai-python#async-api
+        return await llm.client.acreate(**kwargs)
+
+    return await _completion_with_retry(**kwargs)
+
+
+def _convert_delta_to_message_chunk(
+    _dict: Mapping[str, Any], default_class: Type[BaseMessageChunk]
+) -> BaseMessageChunk:
+    role = _dict.get("role")
+    content = _dict.get("content") or ""
+
+    if role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=content)
+    elif role == "assistant" or default_class == AIMessageChunk:
+        return AIMessageChunk(content=content)
+    elif role == "system" or default_class == SystemMessageChunk:
+        return SystemMessageChunk(content=content)
+    elif role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=content, role=role)
+    else:
+        return default_class(content=content)
+
+
+def _convert_dict_to_message(_dict: Mapping[str, Any]) -> BaseMessage:
+    role = _dict["role"]
+    if role == "user":
+        return HumanMessage(content=_dict["content"])
+    elif role == "assistant":
+        content = _dict["content"] or ""
+        return AIMessage(content=content)
+    elif role == "system":
+        return SystemMessage(content=_dict["content"])
+    else:
+        return ChatMessage(content=_dict["content"], role=role)
+
+
+def _convert_message_to_dict(message: BaseMessage) -> dict:
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": message.role, "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+    elif isinstance(message, SystemMessage):
+        message_dict = {"role": "system", "content": message.content}
+    elif isinstance(message, FunctionMessage):
+        message_dict = {
+            "role": "function",
+            "name": message.name,
+            "content": message.content,
+        }
+    else:
+        raise ValueError(f"Got unknown type {message}")
+    if "name" in message.additional_kwargs:
+        message_dict["name"] = message.additional_kwargs["name"]
+    return message_dict
+
+
+class JinaChat(BaseChatModel):
+    """`Jina AI` Chat models API.
+
+    To use, you should have the ``openai`` python package installed, and the
+    environment variable ``JINACHAT_API_KEY`` set to your API key, which you
+    can generate at https://chat.jina.ai/api.
+
+    Any parameters that are valid to be passed to the openai.create call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import JinaChat
+            chat = JinaChat()
+    """
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"jinachat_api_key": "JINACHAT_API_KEY"}
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this model can be serialized by Langchain."""
+        return False
+
+    client: Any  #: :meta private:
+    temperature: float = 0.7
+    """What sampling temperature to use."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not explicitly specified."""
+    jinachat_api_key: Optional[SecretStr] = None
+    """Base URL path for API requests, 
+    leave blank if not using a proxy or service emulator."""
+    request_timeout: Optional[Union[float, Tuple[float, float]]] = None
+    """Timeout for requests to JinaChat completion API. Default is 600 seconds."""
+    max_retries: int = 6
+    """Maximum number of retries to make when generating."""
+    streaming: bool = False
+    """Whether to stream the results or not."""
+    max_tokens: Optional[int] = None
+    """Maximum number of tokens to generate."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name in extra:
+                raise ValueError(f"Found {field_name} supplied twice.")
+            if field_name not in all_required_field_names:
+                logger.warning(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+
+        invalid_model_kwargs = all_required_field_names.intersection(extra.keys())
+        if invalid_model_kwargs:
+            raise ValueError(
+                f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+                f"Instead they were passed in as part of `model_kwargs` parameter."
+            )
+
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["jinachat_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "jinachat_api_key", "JINACHAT_API_KEY")
+        )
+        try:
+            import openai
+
+        except ImportError:
+            raise ValueError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+        try:
+            values["client"] = openai.ChatCompletion
+        except AttributeError:
+            raise ValueError(
+                "`openai` has no `ChatCompletion` attribute, this is likely "
+                "due to an old version of the openai package. Try upgrading it "
+                "with `pip install --upgrade openai`."
+            )
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling JinaChat API."""
+        return {
+            "request_timeout": self.request_timeout,
+            "max_tokens": self.max_tokens,
+            "stream": self.streaming,
+            "temperature": self.temperature,
+            **self.model_kwargs,
+        }
+
+    def _create_retry_decorator(self) -> Callable[[Any], Any]:
+        import openai
+
+        min_seconds = 1
+        max_seconds = 60
+        # Wait 2^x * 1 second between each retry starting with
+        # 4 seconds, then up to 10 seconds, then 10 seconds afterwards
+        return retry(
+            reraise=True,
+            stop=stop_after_attempt(self.max_retries),
+            wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+            retry=(
+                retry_if_exception_type(openai.error.Timeout)
+                | retry_if_exception_type(openai.error.APIError)
+                | retry_if_exception_type(openai.error.APIConnectionError)
+                | retry_if_exception_type(openai.error.RateLimitError)
+                | retry_if_exception_type(openai.error.ServiceUnavailableError)
+            ),
+            before_sleep=before_sleep_log(logger, logging.WARNING),
+        )
+
+    def completion_with_retry(self, **kwargs: Any) -> Any:
+        """Use tenacity to retry the completion call."""
+        retry_decorator = self._create_retry_decorator()
+
+        @retry_decorator
+        def _completion_with_retry(**kwargs: Any) -> Any:
+            return self.client.create(**kwargs)
+
+        return _completion_with_retry(**kwargs)
+
+    def _combine_llm_outputs(self, llm_outputs: List[Optional[dict]]) -> dict:
+        overall_token_usage: dict = {}
+        for output in llm_outputs:
+            if output is None:
+                # Happens in streaming
+                continue
+            token_usage = output["token_usage"]
+            for k, v in token_usage.items():
+                if k in overall_token_usage:
+                    overall_token_usage[k] += v
+                else:
+                    overall_token_usage[k] = v
+        return {"token_usage": overall_token_usage}
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+
+        default_chunk_class = AIMessageChunk
+        for chunk in self.completion_with_retry(messages=message_dicts, **params):
+            delta = chunk["choices"][0]["delta"]
+            chunk = _convert_delta_to_message_chunk(delta, default_chunk_class)
+            default_chunk_class = chunk.__class__
+            cg_chunk = ChatGenerationChunk(message=chunk)
+            if run_manager:
+                run_manager.on_llm_new_token(chunk.content, chunk=cg_chunk)
+            yield cg_chunk
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._stream(
+                messages=messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs}
+        response = self.completion_with_retry(messages=message_dicts, **params)
+        return self._create_chat_result(response)
+
+    def _create_message_dicts(
+        self, messages: List[BaseMessage], stop: Optional[List[str]]
+    ) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+        params = dict(self._invocation_params)
+        if stop is not None:
+            if "stop" in params:
+                raise ValueError("`stop` found in both the input and default params.")
+            params["stop"] = stop
+        message_dicts = [_convert_message_to_dict(m) for m in messages]
+        return message_dicts, params
+
+    def _create_chat_result(self, response: Mapping[str, Any]) -> ChatResult:
+        generations = []
+        for res in response["choices"]:
+            message = _convert_dict_to_message(res["message"])
+            gen = ChatGeneration(message=message)
+            generations.append(gen)
+        llm_output = {"token_usage": response["usage"]}
+        return ChatResult(generations=generations, llm_output=llm_output)
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+
+        default_chunk_class = AIMessageChunk
+        async for chunk in await acompletion_with_retry(
+            self, messages=message_dicts, **params
+        ):
+            delta = chunk["choices"][0]["delta"]
+            chunk = _convert_delta_to_message_chunk(delta, default_chunk_class)
+            default_chunk_class = chunk.__class__
+            cg_chunk = ChatGenerationChunk(message=chunk)
+            if run_manager:
+                await run_manager.on_llm_new_token(chunk.content, chunk=cg_chunk)
+            yield cg_chunk
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._astream(
+                messages=messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs}
+        response = await acompletion_with_retry(self, messages=message_dicts, **params)
+        return self._create_chat_result(response)
+
+    @property
+    def _invocation_params(self) -> Mapping[str, Any]:
+        """Get the parameters used to invoke the model."""
+        jinachat_creds: Dict[str, Any] = {
+            "api_key": self.jinachat_api_key
+            and self.jinachat_api_key.get_secret_value(),
+            "api_base": "https://api.chat.jina.ai/v1",
+            "model": "jinachat",
+        }
+        return {**jinachat_creds, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "jinachat"
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/kinetica.py b/llm/Lib/site-packages/langchain_community/chat_models/kinetica.py
new file mode 100644
index 0000000000000000000000000000000000000000..9362e550608c56765733dd8f6be1ed34cbdf3d51
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/kinetica.py
@@ -0,0 +1,601 @@
+##
+# Copyright (c) 2024, Chad Juliano, Kinetica DB Inc.
+##
+"""Kinetica SQL generation LLM API."""
+
+import json
+import logging
+import os
+import re
+from importlib.metadata import version
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, cast
+
+if TYPE_CHECKING:
+    import gpudb
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.output_parsers.transform import BaseOutputParser
+from langchain_core.outputs import ChatGeneration, ChatResult, Generation
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+
+LOG = logging.getLogger(__name__)
+
+# Kinetica pydantic API datatypes
+
+
+class _KdtSuggestContext(BaseModel):
+    """pydantic API request type"""
+
+    table: Optional[str] = Field(default=None, title="Name of table")
+    description: Optional[str] = Field(default=None, title="Table description")
+    columns: List[str] = Field(default=None, title="Table columns list")
+    rules: Optional[List[str]] = Field(
+        default=None, title="Rules that apply to the table."
+    )
+    samples: Optional[Dict] = Field(
+        default=None, title="Samples that apply to the entire context."
+    )
+
+    def to_system_str(self) -> str:
+        lines = []
+        lines.append(f"CREATE TABLE {self.table} AS")
+        lines.append("(")
+
+        if not self.columns or len(self.columns) == 0:
+            ValueError("columns list can't be null.")
+
+        columns = []
+        for column in self.columns:
+            column = column.replace('"', "").strip()
+            columns.append(f"   {column}")
+        lines.append(",\n".join(columns))
+        lines.append(");")
+
+        if self.description:
+            lines.append(f"COMMENT ON TABLE {self.table} IS '{self.description}';")
+
+        if self.rules and len(self.rules) > 0:
+            lines.append(
+                f"-- When querying table {self.table} the following rules apply:"
+            )
+            for rule in self.rules:
+                lines.append(f"-- * {rule}")
+
+        result = "\n".join(lines)
+        return result
+
+
+class _KdtSuggestPayload(BaseModel):
+    """pydantic API request type"""
+
+    question: Optional[str]
+    context: List[_KdtSuggestContext]
+
+    def get_system_str(self) -> str:
+        lines = []
+        for table_context in self.context:
+            if table_context.table is None:
+                continue
+            context_str = table_context.to_system_str()
+            lines.append(context_str)
+        return "\n\n".join(lines)
+
+    def get_messages(self) -> List[Dict]:
+        messages = []
+        for context in self.context:
+            if context.samples is None:
+                continue
+            for question, answer in context.samples.items():
+                # unescape double quotes
+                answer = answer.replace("''", "'")
+
+                messages.append(dict(role="user", content=question or ""))
+                messages.append(dict(role="assistant", content=answer))
+        return messages
+
+    def to_completion(self) -> Dict:
+        messages = []
+        messages.append(dict(role="system", content=self.get_system_str()))
+        messages.extend(self.get_messages())
+        messages.append(dict(role="user", content=self.question or ""))
+        response = dict(messages=messages)
+        return response
+
+
+class _KdtoSuggestRequest(BaseModel):
+    """pydantic API request type"""
+
+    payload: _KdtSuggestPayload
+
+
+class _KdtMessage(BaseModel):
+    """pydantic API response type"""
+
+    role: str = Field(default=None, title="One of [user|assistant|system]")
+    content: str
+
+
+class _KdtChoice(BaseModel):
+    """pydantic API response type"""
+
+    index: int
+    message: _KdtMessage = Field(default=None, title="The generated SQL")
+    finish_reason: str
+
+
+class _KdtUsage(BaseModel):
+    """pydantic API response type"""
+
+    prompt_tokens: int
+    completion_tokens: int
+    total_tokens: int
+
+
+class _KdtSqlResponse(BaseModel):
+    """pydantic API response type"""
+
+    id: str
+    object: str
+    created: int
+    model: str
+    choices: List[_KdtChoice]
+    usage: _KdtUsage
+    prompt: str = Field(default=None, title="The input question")
+
+
+class _KdtCompletionResponse(BaseModel):
+    """pydantic API response type"""
+
+    status: str
+    data: _KdtSqlResponse
+
+
+class _KineticaLlmFileContextParser:
+    """Parser for Kinetica LLM context datafiles."""
+
+    # parse line into a dict containing role and content
+    PARSER = re.compile(r"^<\|(?P<role>\w+)\|>\W*(?P<content>.*)$", re.DOTALL)
+
+    @classmethod
+    def _removesuffix(cls, text: str, suffix: str) -> str:
+        if suffix and text.endswith(suffix):
+            return text[: -len(suffix)]
+        return text
+
+    @classmethod
+    def parse_dialogue_file(cls, input_file: os.PathLike) -> Dict:
+        path = Path(input_file)
+        # schema = path.name.removesuffix(".txt") python 3.9
+        schema = cls._removesuffix(path.name, ".txt")
+
+        lines = open(input_file).read()
+        return cls.parse_dialogue(lines, schema)
+
+    @classmethod
+    def parse_dialogue(cls, text: str, schema: str) -> Dict:
+        messages = []
+        system = None
+
+        lines = text.split("<|end|>")
+        user_message = None
+
+        for idx, line in enumerate(lines):
+            line = line.strip()
+
+            if len(line) == 0:
+                continue
+
+            match = cls.PARSER.match(line)
+            if match is None:
+                raise ValueError(f"Could not find starting token in: {line}")
+
+            groupdict = match.groupdict()
+            role = groupdict["role"]
+
+            if role == "system":
+                if system is not None:
+                    raise ValueError(f"Only one system token allowed in: {line}")
+                system = groupdict["content"]
+            elif role == "user":
+                if user_message is not None:
+                    raise ValueError(
+                        f"Found user token without assistant token: {line}"
+                    )
+                user_message = groupdict
+            elif role == "assistant":
+                if user_message is None:
+                    raise Exception(f"Found assistant token without user token: {line}")
+                messages.append(user_message)
+                messages.append(groupdict)
+                user_message = None
+            else:
+                raise ValueError(f"Unknown token: {role}")
+
+        return {"schema": schema, "system": system, "messages": messages}
+
+
+class KineticaUtil:
+    """Kinetica utility functions."""
+
+    @classmethod
+    def create_kdbc(
+        cls,
+        url: Optional[str] = None,
+        user: Optional[str] = None,
+        passwd: Optional[str] = None,
+    ) -> "gpudb.GPUdb":
+        """Create a connectica connection object and verify connectivity.
+
+        If None is passed for one or more of the parameters then an attempt will be made
+        to retrieve the value from the related environment variable.
+
+        Args:
+            url: The Kinetica URL or ``KINETICA_URL`` if None.
+            user: The Kinetica user or ``KINETICA_USER`` if None.
+            passwd: The Kinetica password or ``KINETICA_PASSWD`` if None.
+
+        Returns:
+            The Kinetica connection object.
+        """
+
+        try:
+            import gpudb
+        except ModuleNotFoundError:
+            raise ImportError(
+                "Could not import Kinetica python package. "
+                "Please install it with `pip install gpudb`."
+            )
+
+        url = cls._get_env("KINETICA_URL", url)
+        user = cls._get_env("KINETICA_USER", user)
+        passwd = cls._get_env("KINETICA_PASSWD", passwd)
+
+        options = gpudb.GPUdb.Options()
+        options.username = user
+        options.password = passwd
+        options.skip_ssl_cert_verification = True
+        options.disable_failover = True
+        options.logging_level = "INFO"
+        kdbc = gpudb.GPUdb(host=url, options=options)
+
+        LOG.info(
+            "Connected to Kinetica: {}. (api={}, server={})".format(
+                kdbc.get_url(), version("gpudb"), kdbc.server_version
+            )
+        )
+
+        return kdbc
+
+    @classmethod
+    def _get_env(cls, name: str, default: Optional[str]) -> str:
+        """Get an environment variable or use a default."""
+        if default is not None:
+            return default
+
+        result = os.getenv(name)
+        if result is not None:
+            return result
+
+        raise ValueError(
+            f"Parameter was not passed and not found in the environment: {name}"
+        )
+
+
+class ChatKinetica(BaseChatModel):
+    """Kinetica LLM Chat Model API.
+
+    Prerequisites for using this API:
+
+    * The ``gpudb`` and ``typeguard`` packages installed.
+    * A Kinetica DB instance.
+    * Kinetica host specified in ``KINETICA_URL``
+    * Kinetica login specified ``KINETICA_USER``, and ``KINETICA_PASSWD``.
+    * An LLM context that specifies the tables and samples to use for inferencing.
+
+    This API is intended to interact with the Kinetica SqlAssist LLM that supports
+    generation of SQL from natural language.
+
+    In the Kinetica LLM workflow you create an LLM context in the database that provides
+    information needed for infefencing that includes tables, annotations, rules, and
+    samples. Invoking ``load_messages_from_context()`` will retrieve the contxt
+    information from the database so that it can be used to create a chat prompt.
+
+    The chat prompt consists of a ``SystemMessage`` and pairs of
+    ``HumanMessage``/``AIMessage`` that contain the samples which are question/SQL
+    pairs. You can append pairs samples to this list but it is not intended to
+    facilitate a typical natural language conversation.
+
+    When you create a chain from the chat prompt and execute it, the Kinetica LLM will
+    generate SQL from the input. Optionally you can use ``KineticaSqlOutputParser`` to
+    execute the SQL and return the result as a dataframe.
+
+    The following example creates an LLM using the environment variables for the
+    Kinetica connection. This will fail if the API is unable to connect to the database.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models.kinetica import KineticaChatLLM
+            kinetica_llm = KineticaChatLLM()
+
+    If you prefer to pass connection information directly then you can create a
+    connection using ``KineticaUtil.create_kdbc()``.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models.kinetica import (
+                KineticaChatLLM, KineticaUtil)
+            kdbc = KineticaUtil._create_kdbc(url=url, user=user, passwd=passwd)
+            kinetica_llm = KineticaChatLLM(kdbc=kdbc)
+    """
+
+    kdbc: Any = Field(exclude=True)
+    """ Kinetica DB connection. """
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Pydantic object validator."""
+
+        kdbc = values.get("kdbc", None)
+        if kdbc is None:
+            kdbc = KineticaUtil.create_kdbc()
+            values["kdbc"] = kdbc
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        return "kinetica-sqlassist"
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        return dict(
+            kinetica_version=str(self.kdbc.server_version), api_version=version("gpudb")
+        )
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if stop is not None:
+            raise ValueError("stop kwargs are not permitted.")
+
+        dict_messages = [self._convert_message_to_dict(m) for m in messages]
+        sql_response = self._submit_completion(dict_messages)
+
+        response_message = sql_response.choices[0].message
+        # generated_dict = response_message.model_dump() # pydantic v2
+        generated_dict = response_message.dict()
+
+        generated_message = self._convert_message_from_dict(generated_dict)
+
+        llm_output = dict(
+            input_tokens=sql_response.usage.prompt_tokens,
+            output_tokens=sql_response.usage.completion_tokens,
+            model_name=sql_response.model,
+        )
+        return ChatResult(
+            generations=[ChatGeneration(message=generated_message)],
+            llm_output=llm_output,
+        )
+
+    def load_messages_from_context(self, context_name: str) -> List:
+        """Load a lanchain prompt from a Kinetica context.
+
+        A Kinetica Context is an object created with the Kinetica Workbench UI or with
+        SQL syntax. This function will convert the data in the context to a list of
+        messages that can be used as a prompt. The messages will contain a
+        ``SystemMessage`` followed by pairs of ``HumanMessage``/``AIMessage`` that
+        contain the samples.
+
+        Args:
+            context_name: The name of an LLM context in the database.
+
+        Returns:
+            A list of messages containing the information from the context.
+        """
+
+        # query kinetica for the prompt
+        sql = f"GENERATE PROMPT WITH OPTIONS (CONTEXT_NAMES = '{context_name}')"
+        result = self._execute_sql(sql)
+        prompt = result["Prompt"]
+        prompt_json = json.loads(prompt)
+
+        # convert the prompt to messages
+        # request = SuggestRequest.model_validate(prompt_json) # pydantic v2
+        request = _KdtoSuggestRequest.parse_obj(prompt_json)
+        payload = request.payload
+
+        dict_messages = []
+        dict_messages.append(dict(role="system", content=payload.get_system_str()))
+        dict_messages.extend(payload.get_messages())
+        messages = [self._convert_message_from_dict(m) for m in dict_messages]
+        return messages
+
+    def _submit_completion(self, messages: List[Dict]) -> _KdtSqlResponse:
+        """Submit a /chat/completions request to Kinetica."""
+
+        request = dict(messages=messages)
+        request_json = json.dumps(request)
+        response_raw = self.kdbc._GPUdb__submit_request_json(
+            "/chat/completions", request_json
+        )
+        response_json = json.loads(response_raw)
+
+        status = response_json["status"]
+        if status != "OK":
+            message = response_json["message"]
+            match_resp = re.compile(r"response:({.*})")
+            result = match_resp.search(message)
+            if result is not None:
+                response = result.group(1)
+                response_json = json.loads(response)
+                message = response_json["message"]
+            raise ValueError(message)
+
+        data = response_json["data"]
+        # response = CompletionResponse.model_validate(data) # pydantic v2
+        response = _KdtCompletionResponse.parse_obj(data)
+        if response.status != "OK":
+            raise ValueError("SQL Generation failed")
+        return response.data
+
+    def _execute_sql(self, sql: str) -> Dict:
+        """Execute an SQL query and return the result."""
+
+        response = self.kdbc.execute_sql_and_decode(
+            sql, limit=1, get_column_major=False
+        )
+
+        status_info = response["status_info"]
+        if status_info["status"] != "OK":
+            message = status_info["message"]
+            raise ValueError(message)
+
+        records = response["records"]
+        if len(records) != 1:
+            raise ValueError("No records returned.")
+
+        record = records[0]
+        response_dict = {}
+        for col, val in record.items():
+            response_dict[col] = val
+        return response_dict
+
+    @classmethod
+    def load_messages_from_datafile(cls, sa_datafile: Path) -> List[BaseMessage]:
+        """Load a lanchain prompt from a Kinetica context datafile."""
+        datafile_dict = _KineticaLlmFileContextParser.parse_dialogue_file(sa_datafile)
+        messages = cls._convert_dict_to_messages(datafile_dict)
+        return messages
+
+    @classmethod
+    def _convert_message_to_dict(cls, message: BaseMessage) -> Dict:
+        """Convert a single message to a BaseMessage."""
+
+        content = cast(str, message.content)
+        if isinstance(message, HumanMessage):
+            role = "user"
+        elif isinstance(message, AIMessage):
+            role = "assistant"
+        elif isinstance(message, SystemMessage):
+            role = "system"
+        else:
+            raise ValueError(f"Got unsupported message type: {message}")
+
+        result_message = dict(role=role, content=content)
+        return result_message
+
+    @classmethod
+    def _convert_message_from_dict(cls, message: Dict) -> BaseMessage:
+        """Convert a single message from a BaseMessage."""
+
+        role = message["role"]
+        content = message["content"]
+        if role == "user":
+            return HumanMessage(content=content)
+        elif role == "assistant":
+            return AIMessage(content=content)
+        elif role == "system":
+            return SystemMessage(content=content)
+        else:
+            raise ValueError(f"Got unsupported role: {role}")
+
+    @classmethod
+    def _convert_dict_to_messages(cls, sa_data: Dict) -> List[BaseMessage]:
+        """Convert a dict to a list of BaseMessages."""
+
+        schema = sa_data["schema"]
+        system = sa_data["system"]
+        messages = sa_data["messages"]
+        LOG.info(f"Importing prompt for schema: {schema}")
+
+        result_list: List[BaseMessage] = []
+        result_list.append(SystemMessage(content=system))
+        result_list.extend([cls._convert_message_from_dict(m) for m in messages])
+        return result_list
+
+
+class KineticaSqlResponse(BaseModel):
+    """Response containing SQL and the fetched data.
+
+    This object is returned by a chain with ``KineticaSqlOutputParser`` and it contains
+    the generated SQL and related Pandas Dataframe fetched from the database.
+    """
+
+    sql: str = Field(default=None)
+    """The generated SQL."""
+
+    # dataframe: "pd.DataFrame" = Field(default=None)
+    dataframe: Any = Field(default=None)
+    """The Pandas dataframe containing the fetched data."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+
+class KineticaSqlOutputParser(BaseOutputParser[KineticaSqlResponse]):
+    """Fetch and return data from the Kinetica LLM.
+
+    This object is used as the last element of a chain to execute generated SQL and it
+    will output a ``KineticaSqlResponse`` containing the SQL and a pandas dataframe with
+    the fetched data.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models.kinetica import (
+                KineticaChatLLM, KineticaSqlOutputParser)
+            kinetica_llm = KineticaChatLLM()
+
+            # create chain
+            ctx_messages = kinetica_llm.load_messages_from_context(self.context_name)
+            ctx_messages.append(("human", "{input}"))
+            prompt_template = ChatPromptTemplate.from_messages(ctx_messages)
+            chain = (
+                prompt_template
+                | kinetica_llm
+                | KineticaSqlOutputParser(kdbc=kinetica_llm.kdbc)
+            )
+            sql_response: KineticaSqlResponse = chain.invoke(
+                {"input": "What are the female users ordered by username?"}
+            )
+
+            assert isinstance(sql_response, KineticaSqlResponse)
+            LOG.info(f"SQL Response: {sql_response.sql}")
+            assert isinstance(sql_response.dataframe, pd.DataFrame)
+    """
+
+    kdbc: Any = Field(exclude=True)
+    """ Kinetica DB connection. """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def parse(self, text: str) -> KineticaSqlResponse:
+        df = self.kdbc.to_df(text)
+        return KineticaSqlResponse(sql=text, dataframe=df)
+
+    def parse_result(
+        self, result: List[Generation], *, partial: bool = False
+    ) -> KineticaSqlResponse:
+        return self.parse(result[0].text)
+
+    @property
+    def _type(self) -> str:
+        return "kinetica_sql_output_parser"
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/konko.py b/llm/Lib/site-packages/langchain_community/chat_models/konko.py
new file mode 100644
index 0000000000000000000000000000000000000000..0eab398af75d9b263cc686b3ef6666f1829b3a22
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/konko.py
@@ -0,0 +1,284 @@
+"""KonkoAI chat wrapper."""
+from __future__ import annotations
+
+import logging
+import os
+import warnings
+from typing import (
+    Any,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+    Set,
+    Tuple,
+    Union,
+    cast,
+)
+
+import requests
+from langchain_core.callbacks import (
+    CallbackManagerForLLMRun,
+)
+from langchain_core.messages import AIMessageChunk, BaseMessage
+from langchain_core.outputs import ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.adapters.openai import (
+    convert_message_to_dict,
+)
+from langchain_community.chat_models.openai import (
+    ChatOpenAI,
+    _convert_delta_to_message_chunk,
+    generate_from_stream,
+)
+from langchain_community.utils.openai import is_openai_v1
+
+DEFAULT_API_BASE = "https://api.konko.ai/v1"
+DEFAULT_MODEL = "meta-llama/Llama-2-13b-chat-hf"
+
+logger = logging.getLogger(__name__)
+
+
+class ChatKonko(ChatOpenAI):
+    """`ChatKonko` Chat large language models API.
+
+    To use, you should have the ``konko`` python package installed, and the
+    environment variable ``KONKO_API_KEY`` and ``OPENAI_API_KEY`` set with your API key.
+
+    Any parameters that are valid to be passed to the konko.create call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatKonko
+            llm = ChatKonko(model="meta-llama/Llama-2-13b-chat-hf")
+    """
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"konko_api_key": "KONKO_API_KEY", "openai_api_key": "OPENAI_API_KEY"}
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this model can be serialized by Langchain."""
+        return False
+
+    client: Any = None  #: :meta private:
+    model: str = Field(default=DEFAULT_MODEL, alias="model")
+    """Model name to use."""
+    temperature: float = 0.7
+    """What sampling temperature to use."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not explicitly specified."""
+    openai_api_key: Optional[str] = None
+    konko_api_key: Optional[str] = None
+    max_retries: int = 6
+    """Maximum number of retries to make when generating."""
+    streaming: bool = False
+    """Whether to stream the results or not."""
+    n: int = 1
+    """Number of chat completions to generate for each prompt."""
+    max_tokens: int = 20
+    """Maximum number of tokens to generate."""
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["konko_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "konko_api_key", "KONKO_API_KEY")
+        )
+        try:
+            import konko
+
+        except ImportError:
+            raise ValueError(
+                "Could not import konko python package. "
+                "Please install it with `pip install konko`."
+            )
+        try:
+            if is_openai_v1():
+                values["client"] = konko.chat.completions
+            else:
+                values["client"] = konko.ChatCompletion
+        except AttributeError:
+            raise ValueError(
+                "`konko` has no `ChatCompletion` attribute, this is likely "
+                "due to an old version of the konko package. Try upgrading it "
+                "with `pip install --upgrade konko`."
+            )
+
+        if not hasattr(konko, "_is_legacy_openai"):
+            warnings.warn(
+                "You are using an older version of the 'konko' package. "
+                "Please consider upgrading to access new features."
+            )
+
+        if values["n"] < 1:
+            raise ValueError("n must be at least 1.")
+        if values["n"] > 1 and values["streaming"]:
+            raise ValueError("n must be 1 when streaming.")
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Konko API."""
+        return {
+            "model": self.model,
+            "max_tokens": self.max_tokens,
+            "stream": self.streaming,
+            "n": self.n,
+            "temperature": self.temperature,
+            **self.model_kwargs,
+        }
+
+    @staticmethod
+    def get_available_models(
+        konko_api_key: Union[str, SecretStr, None] = None,
+        openai_api_key: Union[str, SecretStr, None] = None,
+        konko_api_base: str = DEFAULT_API_BASE,
+    ) -> Set[str]:
+        """Get available models from Konko API."""
+
+        # Try to retrieve the OpenAI API key if it's not passed as an argument
+        if not openai_api_key:
+            try:
+                openai_api_key = convert_to_secret_str(os.environ["OPENAI_API_KEY"])
+            except KeyError:
+                pass  # It's okay if it's not set, we just won't use it
+        elif isinstance(openai_api_key, str):
+            openai_api_key = convert_to_secret_str(openai_api_key)
+
+        # Try to retrieve the Konko API key if it's not passed as an argument
+        if not konko_api_key:
+            try:
+                konko_api_key = convert_to_secret_str(os.environ["KONKO_API_KEY"])
+            except KeyError:
+                raise ValueError(
+                    "Konko API key must be passed as keyword argument or "
+                    "set in environment variable KONKO_API_KEY."
+                )
+        elif isinstance(konko_api_key, str):
+            konko_api_key = convert_to_secret_str(konko_api_key)
+
+        models_url = f"{konko_api_base}/models"
+
+        headers = {
+            "Authorization": f"Bearer {konko_api_key.get_secret_value()}",
+        }
+
+        if openai_api_key:
+            headers["X-OpenAI-Api-Key"] = cast(
+                SecretStr, openai_api_key
+            ).get_secret_value()
+
+        models_response = requests.get(models_url, headers=headers)
+
+        if models_response.status_code != 200:
+            raise ValueError(
+                f"Error getting models from {models_url}: "
+                f"{models_response.status_code}"
+            )
+
+        return {model["id"] for model in models_response.json()["data"]}
+
+    def completion_with_retry(
+        self, run_manager: Optional[CallbackManagerForLLMRun] = None, **kwargs: Any
+    ) -> Any:
+        def _completion_with_retry(**kwargs: Any) -> Any:
+            return self.client.create(**kwargs)
+
+        return _completion_with_retry(**kwargs)
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+
+        default_chunk_class = AIMessageChunk
+        for chunk in self.completion_with_retry(
+            messages=message_dicts, run_manager=run_manager, **params
+        ):
+            if len(chunk["choices"]) == 0:
+                continue
+            choice = chunk["choices"][0]
+            chunk = _convert_delta_to_message_chunk(
+                choice["delta"], default_chunk_class
+            )
+            finish_reason = choice.get("finish_reason")
+            generation_info = (
+                dict(finish_reason=finish_reason) if finish_reason is not None else None
+            )
+            default_chunk_class = chunk.__class__
+            cg_chunk = ChatGenerationChunk(
+                message=chunk, generation_info=generation_info
+            )
+            if run_manager:
+                run_manager.on_llm_new_token(cg_chunk.text, chunk=cg_chunk)
+            yield cg_chunk
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs}
+        response = self.completion_with_retry(
+            messages=message_dicts, run_manager=run_manager, **params
+        )
+        return self._create_chat_result(response)
+
+    def _create_message_dicts(
+        self, messages: List[BaseMessage], stop: Optional[List[str]]
+    ) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+        params = self._client_params
+        if stop is not None:
+            if "stop" in params:
+                raise ValueError("`stop` found in both the input and default params.")
+            params["stop"] = stop
+        message_dicts = [convert_message_to_dict(m) for m in messages]
+        return message_dicts, params
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model_name": self.model}, **self._default_params}
+
+    @property
+    def _client_params(self) -> Dict[str, Any]:
+        """Get the parameters used for the konko client."""
+        return {**self._default_params}
+
+    def _get_invocation_params(
+        self, stop: Optional[List[str]] = None, **kwargs: Any
+    ) -> Dict[str, Any]:
+        """Get the parameters used to invoke the model."""
+        return {
+            "model": self.model,
+            **super()._get_invocation_params(stop=stop),
+            **self._default_params,
+            **kwargs,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "konko-chat"
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/litellm.py b/llm/Lib/site-packages/langchain_community/chat_models/litellm.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f98033780731d29f431ca91cdd82a8008af2d09
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/litellm.py
@@ -0,0 +1,425 @@
+"""Wrapper around LiteLLM's model I/O library."""
+from __future__ import annotations
+
+import logging
+from typing import (
+    Any,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.language_models.llms import create_base_retry_decorator
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    FunctionMessage,
+    FunctionMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+    SystemMessageChunk,
+)
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatGenerationChunk,
+    ChatResult,
+)
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+class ChatLiteLLMException(Exception):
+    """Error with the `LiteLLM I/O` library"""
+
+
+def _create_retry_decorator(
+    llm: ChatLiteLLM,
+    run_manager: Optional[
+        Union[AsyncCallbackManagerForLLMRun, CallbackManagerForLLMRun]
+    ] = None,
+) -> Callable[[Any], Any]:
+    """Returns a tenacity retry decorator, preconfigured to handle PaLM exceptions"""
+    import litellm
+
+    errors = [
+        litellm.Timeout,
+        litellm.APIError,
+        litellm.APIConnectionError,
+        litellm.RateLimitError,
+    ]
+    return create_base_retry_decorator(
+        error_types=errors, max_retries=llm.max_retries, run_manager=run_manager
+    )
+
+
+def _convert_dict_to_message(_dict: Mapping[str, Any]) -> BaseMessage:
+    role = _dict["role"]
+    if role == "user":
+        return HumanMessage(content=_dict["content"])
+    elif role == "assistant":
+        # Fix for azure
+        # Also OpenAI returns None for tool invocations
+        content = _dict.get("content", "") or ""
+        if _dict.get("function_call"):
+            additional_kwargs = {"function_call": dict(_dict["function_call"])}
+        else:
+            additional_kwargs = {}
+        return AIMessage(content=content, additional_kwargs=additional_kwargs)
+    elif role == "system":
+        return SystemMessage(content=_dict["content"])
+    elif role == "function":
+        return FunctionMessage(content=_dict["content"], name=_dict["name"])
+    else:
+        return ChatMessage(content=_dict["content"], role=role)
+
+
+async def acompletion_with_retry(
+    llm: ChatLiteLLM,
+    run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the async completion call."""
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @retry_decorator
+    async def _completion_with_retry(**kwargs: Any) -> Any:
+        # Use OpenAI's async api https://github.com/openai/openai-python#async-api
+        return await llm.client.acreate(**kwargs)
+
+    return await _completion_with_retry(**kwargs)
+
+
+def _convert_delta_to_message_chunk(
+    _dict: Mapping[str, Any], default_class: Type[BaseMessageChunk]
+) -> BaseMessageChunk:
+    role = _dict.get("role")
+    content = _dict.get("content") or ""
+    if _dict.get("function_call"):
+        additional_kwargs = {"function_call": dict(_dict["function_call"])}
+    else:
+        additional_kwargs = {}
+
+    if role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=content)
+    elif role == "assistant" or default_class == AIMessageChunk:
+        return AIMessageChunk(content=content, additional_kwargs=additional_kwargs)
+    elif role == "system" or default_class == SystemMessageChunk:
+        return SystemMessageChunk(content=content)
+    elif role == "function" or default_class == FunctionMessageChunk:
+        return FunctionMessageChunk(content=content, name=_dict["name"])
+    elif role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=content, role=role)
+    else:
+        return default_class(content=content)
+
+
+def _convert_message_to_dict(message: BaseMessage) -> dict:
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": message.role, "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+        if "function_call" in message.additional_kwargs:
+            message_dict["function_call"] = message.additional_kwargs["function_call"]
+    elif isinstance(message, SystemMessage):
+        message_dict = {"role": "system", "content": message.content}
+    elif isinstance(message, FunctionMessage):
+        message_dict = {
+            "role": "function",
+            "content": message.content,
+            "name": message.name,
+        }
+    else:
+        raise ValueError(f"Got unknown type {message}")
+    if "name" in message.additional_kwargs:
+        message_dict["name"] = message.additional_kwargs["name"]
+    return message_dict
+
+
+class ChatLiteLLM(BaseChatModel):
+    """Chat model that uses the LiteLLM API."""
+
+    client: Any  #: :meta private:
+    model: str = "gpt-3.5-turbo"
+    model_name: Optional[str] = None
+    """Model name to use."""
+    openai_api_key: Optional[str] = None
+    azure_api_key: Optional[str] = None
+    anthropic_api_key: Optional[str] = None
+    replicate_api_key: Optional[str] = None
+    cohere_api_key: Optional[str] = None
+    openrouter_api_key: Optional[str] = None
+    streaming: bool = False
+    api_base: Optional[str] = None
+    organization: Optional[str] = None
+    custom_llm_provider: Optional[str] = None
+    request_timeout: Optional[Union[float, Tuple[float, float]]] = None
+    temperature: Optional[float] = 1
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Run inference with this temperature. Must by in the closed
+       interval [0.0, 1.0]."""
+    top_p: Optional[float] = None
+    """Decode using nucleus sampling: consider the smallest set of tokens whose
+       probability sum is at least top_p. Must be in the closed interval [0.0, 1.0]."""
+    top_k: Optional[int] = None
+    """Decode using top-k sampling: consider the set of top_k most probable tokens.
+       Must be positive."""
+    n: int = 1
+    """Number of chat completions to generate for each prompt. Note that the API may
+       not return the full n completions if duplicates are generated."""
+    max_tokens: int = 256
+
+    max_retries: int = 6
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling OpenAI API."""
+        set_model_value = self.model
+        if self.model_name is not None:
+            set_model_value = self.model_name
+        return {
+            "model": set_model_value,
+            "force_timeout": self.request_timeout,
+            "max_tokens": self.max_tokens,
+            "stream": self.streaming,
+            "n": self.n,
+            "temperature": self.temperature,
+            "custom_llm_provider": self.custom_llm_provider,
+            **self.model_kwargs,
+        }
+
+    @property
+    def _client_params(self) -> Dict[str, Any]:
+        """Get the parameters used for the openai client."""
+        set_model_value = self.model
+        if self.model_name is not None:
+            set_model_value = self.model_name
+        self.client.api_base = self.api_base
+        self.client.organization = self.organization
+        creds: Dict[str, Any] = {
+            "model": set_model_value,
+            "force_timeout": self.request_timeout,
+            "api_base": self.api_base,
+        }
+        return {**self._default_params, **creds}
+
+    def completion_with_retry(
+        self, run_manager: Optional[CallbackManagerForLLMRun] = None, **kwargs: Any
+    ) -> Any:
+        """Use tenacity to retry the completion call."""
+        retry_decorator = _create_retry_decorator(self, run_manager=run_manager)
+
+        @retry_decorator
+        def _completion_with_retry(**kwargs: Any) -> Any:
+            return self.client.completion(**kwargs)
+
+        return _completion_with_retry(**kwargs)
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate api key, python package exists, temperature, top_p, and top_k."""
+        try:
+            import litellm
+        except ImportError:
+            raise ChatLiteLLMException(
+                "Could not import litellm python package. "
+                "Please install it with `pip install litellm`"
+            )
+
+        values["openai_api_key"] = get_from_dict_or_env(
+            values, "openai_api_key", "OPENAI_API_KEY", default=""
+        )
+        values["azure_api_key"] = get_from_dict_or_env(
+            values, "azure_api_key", "AZURE_API_KEY", default=""
+        )
+        values["anthropic_api_key"] = get_from_dict_or_env(
+            values, "anthropic_api_key", "ANTHROPIC_API_KEY", default=""
+        )
+        values["replicate_api_key"] = get_from_dict_or_env(
+            values, "replicate_api_key", "REPLICATE_API_KEY", default=""
+        )
+        values["openrouter_api_key"] = get_from_dict_or_env(
+            values, "openrouter_api_key", "OPENROUTER_API_KEY", default=""
+        )
+        values["cohere_api_key"] = get_from_dict_or_env(
+            values, "cohere_api_key", "COHERE_API_KEY", default=""
+        )
+        values["huggingface_api_key"] = get_from_dict_or_env(
+            values, "huggingface_api_key", "HUGGINGFACE_API_KEY", default=""
+        )
+        values["together_ai_api_key"] = get_from_dict_or_env(
+            values, "together_ai_api_key", "TOGETHERAI_API_KEY", default=""
+        )
+        values["client"] = litellm
+
+        if values["temperature"] is not None and not 0 <= values["temperature"] <= 1:
+            raise ValueError("temperature must be in the range [0.0, 1.0]")
+
+        if values["top_p"] is not None and not 0 <= values["top_p"] <= 1:
+            raise ValueError("top_p must be in the range [0.0, 1.0]")
+
+        if values["top_k"] is not None and values["top_k"] <= 0:
+            raise ValueError("top_k must be positive")
+
+        return values
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs}
+        response = self.completion_with_retry(
+            messages=message_dicts, run_manager=run_manager, **params
+        )
+        return self._create_chat_result(response)
+
+    def _create_chat_result(self, response: Mapping[str, Any]) -> ChatResult:
+        generations = []
+        for res in response["choices"]:
+            message = _convert_dict_to_message(res["message"])
+            gen = ChatGeneration(
+                message=message,
+                generation_info=dict(finish_reason=res.get("finish_reason")),
+            )
+            generations.append(gen)
+        token_usage = response.get("usage", {})
+        set_model_value = self.model
+        if self.model_name is not None:
+            set_model_value = self.model_name
+        llm_output = {"token_usage": token_usage, "model": set_model_value}
+        return ChatResult(generations=generations, llm_output=llm_output)
+
+    def _create_message_dicts(
+        self, messages: List[BaseMessage], stop: Optional[List[str]]
+    ) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+        params = self._client_params
+        if stop is not None:
+            if "stop" in params:
+                raise ValueError("`stop` found in both the input and default params.")
+            params["stop"] = stop
+        message_dicts = [_convert_message_to_dict(m) for m in messages]
+        return message_dicts, params
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+
+        default_chunk_class = AIMessageChunk
+        for chunk in self.completion_with_retry(
+            messages=message_dicts, run_manager=run_manager, **params
+        ):
+            if len(chunk["choices"]) == 0:
+                continue
+            delta = chunk["choices"][0]["delta"]
+            chunk = _convert_delta_to_message_chunk(delta, default_chunk_class)
+            default_chunk_class = chunk.__class__
+            cg_chunk = ChatGenerationChunk(message=chunk)
+            if run_manager:
+                run_manager.on_llm_new_token(chunk.content, chunk=cg_chunk)
+            yield cg_chunk
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+
+        default_chunk_class = AIMessageChunk
+        async for chunk in await acompletion_with_retry(
+            self, messages=message_dicts, run_manager=run_manager, **params
+        ):
+            if len(chunk["choices"]) == 0:
+                continue
+            delta = chunk["choices"][0]["delta"]
+            chunk = _convert_delta_to_message_chunk(delta, default_chunk_class)
+            default_chunk_class = chunk.__class__
+            cg_chunk = ChatGenerationChunk(message=chunk)
+            if run_manager:
+                await run_manager.on_llm_new_token(chunk.content, chunk=cg_chunk)
+            yield cg_chunk
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._astream(
+                messages=messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs}
+        response = await acompletion_with_retry(
+            self, messages=message_dicts, run_manager=run_manager, **params
+        )
+        return self._create_chat_result(response)
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        set_model_value = self.model
+        if self.model_name is not None:
+            set_model_value = self.model_name
+        return {
+            "model": set_model_value,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            "top_k": self.top_k,
+            "n": self.n,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        return "litellm-chat"
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/litellm_router.py b/llm/Lib/site-packages/langchain_community/chat_models/litellm_router.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd008a18be5210e2a5ecfdba084f206f8e4bccdb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/litellm_router.py
@@ -0,0 +1,225 @@
+"""LiteLLM Router as LangChain Model."""
+from typing import (
+    Any,
+    AsyncIterator,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+)
+
+from langchain_core.callbacks.manager import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessageChunk,
+    BaseMessage,
+)
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatGenerationChunk,
+    ChatResult,
+)
+
+from langchain_community.chat_models.litellm import (
+    ChatLiteLLM,
+    _convert_delta_to_message_chunk,
+    _convert_dict_to_message,
+)
+
+token_usage_key_name = "token_usage"
+model_extra_key_name = "model_extra"
+
+
+def get_llm_output(usage: Any, **params: Any) -> dict:
+    """Get llm output from usage and params."""
+    llm_output = {token_usage_key_name: usage}
+    # copy over metadata (metadata came from router completion call)
+    metadata = params["metadata"]
+    for key in metadata:
+        if key not in llm_output:
+            # if token usage in metadata, prefer metadata's copy of it
+            llm_output[key] = metadata[key]
+    return llm_output
+
+
+class ChatLiteLLMRouter(ChatLiteLLM):
+    """LiteLLM Router as LangChain Model."""
+
+    router: Any
+
+    def __init__(self, *, router: Any, **kwargs: Any) -> None:
+        """Construct Chat LiteLLM Router."""
+        super().__init__(**kwargs)
+        self.router = router
+
+    @property
+    def _llm_type(self) -> str:
+        return "LiteLLMRouter"
+
+    def _set_model_for_completion(self) -> None:
+        # use first model name (aka: model group),
+        # since we can only pass one to the router completion functions
+        self.model = self.router.model_list[0]["model_name"]
+
+    def _prepare_params_for_router(self, params: Any) -> None:
+        params["model"] = self.model
+
+        # allow the router to set api_base based on its model choice
+        api_base_key_name = "api_base"
+        if api_base_key_name in params and params[api_base_key_name] is None:
+            del params[api_base_key_name]
+
+        # add metadata so router can fill it below
+        params.setdefault("metadata", {})
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs}
+        self._set_model_for_completion()
+        self._prepare_params_for_router(params)
+
+        response = self.router.completion(
+            messages=message_dicts,
+            **params,
+        )
+        return self._create_chat_result(response, **params)
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        default_chunk_class = AIMessageChunk
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+        self._set_model_for_completion()
+        self._prepare_params_for_router(params)
+
+        for chunk in self.router.completion(messages=message_dicts, **params):
+            if len(chunk["choices"]) == 0:
+                continue
+            delta = chunk["choices"][0]["delta"]
+            chunk = _convert_delta_to_message_chunk(delta, default_chunk_class)
+            default_chunk_class = chunk.__class__
+            cg_chunk = ChatGenerationChunk(message=chunk)
+            if run_manager:
+                run_manager.on_llm_new_token(chunk.content, chunk=cg_chunk, **params)
+            yield cg_chunk
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        default_chunk_class = AIMessageChunk
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+        self._set_model_for_completion()
+        self._prepare_params_for_router(params)
+
+        async for chunk in await self.router.acompletion(
+            messages=message_dicts, **params
+        ):
+            if len(chunk["choices"]) == 0:
+                continue
+            delta = chunk["choices"][0]["delta"]
+            chunk = _convert_delta_to_message_chunk(delta, default_chunk_class)
+            default_chunk_class = chunk.__class__
+            cg_chunk = ChatGenerationChunk(message=chunk)
+            if run_manager:
+                await run_manager.on_llm_new_token(
+                    chunk.content, chunk=cg_chunk, **params
+                )
+            yield cg_chunk
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._astream(
+                messages=messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs}
+        self._set_model_for_completion()
+        self._prepare_params_for_router(params)
+
+        response = await self.router.acompletion(
+            messages=message_dicts,
+            **params,
+        )
+        return self._create_chat_result(response, **params)
+
+    # from
+    # https://github.com/langchain-ai/langchain/blob/master/libs/community/langchain_community/chat_models/openai.py
+    # but modified to handle LiteLLM Usage class
+    def _combine_llm_outputs(self, llm_outputs: List[Optional[dict]]) -> dict:
+        overall_token_usage: dict = {}
+        system_fingerprint = None
+        for output in llm_outputs:
+            if output is None:
+                # Happens in streaming
+                continue
+            token_usage = output["token_usage"]
+            if token_usage is not None:
+                # get dict from LiteLLM Usage class
+                for k, v in token_usage.dict().items():
+                    if k in overall_token_usage:
+                        overall_token_usage[k] += v
+                    else:
+                        overall_token_usage[k] = v
+            if system_fingerprint is None:
+                system_fingerprint = output.get("system_fingerprint")
+        combined = {"token_usage": overall_token_usage, "model_name": self.model_name}
+        if system_fingerprint:
+            combined["system_fingerprint"] = system_fingerprint
+        return combined
+
+    def _create_chat_result(
+        self, response: Mapping[str, Any], **params: Any
+    ) -> ChatResult:
+        from litellm.utils import Usage
+
+        generations = []
+        for res in response["choices"]:
+            message = _convert_dict_to_message(res["message"])
+            gen = ChatGeneration(
+                message=message,
+                generation_info=dict(finish_reason=res.get("finish_reason")),
+            )
+            generations.append(gen)
+        token_usage = response.get("usage", Usage(prompt_tokens=0, total_tokens=0))
+        llm_output = get_llm_output(token_usage, **params)
+        return ChatResult(generations=generations, llm_output=llm_output)
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/llama_edge.py b/llm/Lib/site-packages/langchain_community/chat_models/llama_edge.py
new file mode 100644
index 0000000000000000000000000000000000000000..064fe5f97b0fa07a8d584c3285e46628f871987b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/llama_edge.py
@@ -0,0 +1,241 @@
+import json
+import logging
+import re
+from typing import Any, Dict, Iterator, List, Mapping, Optional, Type
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.utils import get_pydantic_field_names
+
+logger = logging.getLogger(__name__)
+
+
+def _convert_dict_to_message(_dict: Mapping[str, Any]) -> BaseMessage:
+    role = _dict["role"]
+    if role == "user":
+        return HumanMessage(content=_dict["content"])
+    elif role == "assistant":
+        return AIMessage(content=_dict.get("content", "") or "")
+    else:
+        return ChatMessage(content=_dict["content"], role=role)
+
+
+def _convert_message_to_dict(message: BaseMessage) -> dict:
+    message_dict: Dict[str, Any]
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": message.role, "content": message.content}
+    elif isinstance(message, SystemMessage):
+        message_dict = {"role": "system", "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+    else:
+        raise TypeError(f"Got unknown type {message}")
+
+    return message_dict
+
+
+def _convert_delta_to_message_chunk(
+    _dict: Mapping[str, Any], default_class: Type[BaseMessageChunk]
+) -> BaseMessageChunk:
+    role = _dict.get("role")
+    content = _dict.get("content") or ""
+
+    if role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=content)
+    elif role == "assistant" or default_class == AIMessageChunk:
+        return AIMessageChunk(content=content)
+    elif role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=content, role=role)
+    else:
+        return default_class(content=content)
+
+
+class LlamaEdgeChatService(BaseChatModel):
+    """Chat with LLMs via `llama-api-server`
+
+    For the information about `llama-api-server`, visit https://github.com/second-state/LlamaEdge
+    """
+
+    request_timeout: int = 60
+    """request timeout for chat http requests"""
+    service_url: Optional[str] = None
+    """URL of WasmChat service"""
+    model: str = "NA"
+    """model name, default is `NA`."""
+    streaming: bool = False
+    """Whether to stream the results or not."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name in extra:
+                raise ValueError(f"Found {field_name} supplied twice.")
+            if field_name not in all_required_field_names:
+                logger.warning(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+
+        invalid_model_kwargs = all_required_field_names.intersection(extra.keys())
+        if invalid_model_kwargs:
+            raise ValueError(
+                f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+                f"Instead they were passed in as part of `model_kwargs` parameter."
+            )
+
+        values["model_kwargs"] = extra
+        return values
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._stream(
+                messages=messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        res = self._chat(messages, **kwargs)
+
+        if res.status_code != 200:
+            raise ValueError(f"Error code: {res.status_code}, reason: {res.reason}")
+
+        response = res.json()
+
+        return self._create_chat_result(response)
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        res = self._chat(messages, **kwargs)
+
+        default_chunk_class = AIMessageChunk
+        substring = '"object":"chat.completion.chunk"}'
+        for line in res.iter_lines():
+            chunks = []
+            if line:
+                json_string = line.decode("utf-8")
+
+                # Find all positions of the substring
+                positions = [m.start() for m in re.finditer(substring, json_string)]
+                positions = [-1 * len(substring)] + positions
+
+                for i in range(len(positions) - 1):
+                    chunk = json.loads(
+                        json_string[
+                            positions[i] + len(substring) : positions[i + 1]
+                            + len(substring)
+                        ]
+                    )
+                    chunks.append(chunk)
+
+            for chunk in chunks:
+                if not isinstance(chunk, dict):
+                    chunk = chunk.dict()
+                if len(chunk["choices"]) == 0:
+                    continue
+
+                choice = chunk["choices"][0]
+                chunk = _convert_delta_to_message_chunk(
+                    choice["delta"], default_chunk_class
+                )
+                if (
+                    choice.get("finish_reason") is not None
+                    and choice.get("finish_reason") == "stop"
+                ):
+                    break
+                finish_reason = choice.get("finish_reason")
+                generation_info = (
+                    dict(finish_reason=finish_reason)
+                    if finish_reason is not None
+                    else None
+                )
+                default_chunk_class = chunk.__class__
+                cg_chunk = ChatGenerationChunk(
+                    message=chunk, generation_info=generation_info
+                )
+                if run_manager:
+                    run_manager.on_llm_new_token(cg_chunk.text, chunk=cg_chunk)
+                yield cg_chunk
+
+    def _chat(self, messages: List[BaseMessage], **kwargs: Any) -> requests.Response:
+        if self.service_url is None:
+            res = requests.models.Response()
+            res.status_code = 503
+            res.reason = "The IP address or port of the chat service is incorrect."
+            return res
+
+        service_url = f"{self.service_url}/v1/chat/completions"
+
+        if self.streaming:
+            payload = {
+                "model": self.model,
+                "messages": [_convert_message_to_dict(m) for m in messages],
+                "stream": self.streaming,
+            }
+        else:
+            payload = {
+                "model": self.model,
+                "messages": [_convert_message_to_dict(m) for m in messages],
+            }
+
+        res = requests.post(
+            url=service_url,
+            timeout=self.request_timeout,
+            headers={
+                "accept": "application/json",
+                "Content-Type": "application/json",
+            },
+            data=json.dumps(payload),
+        )
+
+        return res
+
+    def _create_chat_result(self, response: Mapping[str, Any]) -> ChatResult:
+        message = _convert_dict_to_message(response["choices"][0].get("message"))
+        generations = [ChatGeneration(message=message)]
+
+        token_usage = response["usage"]
+        llm_output = {"token_usage": token_usage, "model": self.model}
+        return ChatResult(generations=generations, llm_output=llm_output)
+
+    @property
+    def _llm_type(self) -> str:
+        return "wasm-chat"
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/maritalk.py b/llm/Lib/site-packages/langchain_community/chat_models/maritalk.py
new file mode 100644
index 0000000000000000000000000000000000000000..064fd46fa17d593960f2b6956502d01d3ee27b2e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/maritalk.py
@@ -0,0 +1,180 @@
+from http import HTTPStatus
+from typing import Any, Dict, List, Optional, Union
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.chat_models import SimpleChatModel
+from langchain_core.messages import AIMessage, BaseMessage, HumanMessage, SystemMessage
+from langchain_core.pydantic_v1 import Field
+from requests import Response
+from requests.exceptions import HTTPError
+
+
+class MaritalkHTTPError(HTTPError):
+    def __init__(self, request_obj: Response) -> None:
+        self.request_obj = request_obj
+        try:
+            response_json = request_obj.json()
+            if "detail" in response_json:
+                api_message = response_json["detail"]
+            elif "message" in response_json:
+                api_message = response_json["message"]
+            else:
+                api_message = response_json
+        except Exception:
+            api_message = request_obj.text
+
+        self.message = api_message
+        self.status_code = request_obj.status_code
+
+    def __str__(self) -> str:
+        status_code_meaning = HTTPStatus(self.status_code).phrase
+        formatted_message = f"HTTP Error: {self.status_code} - {status_code_meaning}"
+        formatted_message += f"\nDetail: {self.message}"
+        return formatted_message
+
+
+class ChatMaritalk(SimpleChatModel):
+    """`MariTalk` Chat models API.
+
+    This class allows interacting with the MariTalk chatbot API.
+    To use it, you must provide an API key either through the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatMaritalk
+            chat = ChatMaritalk(api_key="your_api_key_here")
+    """
+
+    api_key: str
+    """Your MariTalk API key."""
+
+    model: str
+    """Chose one of the available models: 
+    - `sabia-2-medium`
+    - `sabia-2-small`
+    - `sabia-2-medium-2024-03-13`
+    - `sabia-2-small-2024-03-13`
+    - `maritalk-2024-01-08` (deprecated)"""
+
+    temperature: float = Field(default=0.7, gt=0.0, lt=1.0)
+    """Run inference with this temperature. 
+    Must be in the closed interval [0.0, 1.0]."""
+
+    max_tokens: int = Field(default=512, gt=0)
+    """The maximum number of tokens to generate in the reply."""
+
+    do_sample: bool = Field(default=True)
+    """Whether or not to use sampling; use `True` to enable."""
+
+    top_p: float = Field(default=0.95, gt=0.0, lt=1.0)
+    """Nucleus sampling parameter controlling the size of 
+    the probability mass considered for sampling."""
+
+    @property
+    def _llm_type(self) -> str:
+        """Identifies the LLM type as 'maritalk'."""
+        return "maritalk"
+
+    def parse_messages_for_model(
+        self, messages: List[BaseMessage]
+    ) -> List[Dict[str, Union[str, List[Union[str, Dict[Any, Any]]]]]]:
+        """
+        Parses messages from LangChain's format to the format expected by
+        the MariTalk API.
+
+        Parameters:
+            messages (List[BaseMessage]): A list of messages in LangChain
+            format to be parsed.
+
+        Returns:
+            A list of messages formatted for the MariTalk API.
+        """
+        parsed_messages = []
+
+        for message in messages:
+            if isinstance(message, HumanMessage):
+                role = "user"
+            elif isinstance(message, AIMessage):
+                role = "assistant"
+            elif isinstance(message, SystemMessage):
+                role = "system"
+
+            parsed_messages.append({"role": role, "content": message.content})
+        return parsed_messages
+
+    def _call(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """
+        Sends the parsed messages to the MariTalk API and returns the generated
+        response or an error message.
+
+        This method makes an HTTP POST request to the MariTalk API with the
+        provided messages and other parameters.
+        If the request is successful and the API returns a response,
+        this method returns a string containing the answer.
+        If the request is rate-limited or encounters another error,
+        it returns a string with the error message.
+
+        Parameters:
+            messages (List[BaseMessage]): Messages to send to the model.
+            stop (Optional[List[str]]): Tokens that will signal the model
+                to stop generating further tokens.
+
+        Returns:
+            str: If the API call is successful, returns the answer.
+                 If an error occurs (e.g., rate limiting), returns a string
+                 describing the error.
+        """
+        try:
+            url = "https://chat.maritaca.ai/api/chat/inference"
+            headers = {"authorization": f"Key {self.api_key}"}
+            stopping_tokens = stop if stop is not None else []
+
+            parsed_messages = self.parse_messages_for_model(messages)
+
+            data = {
+                "messages": parsed_messages,
+                "model": self.model,
+                "do_sample": self.do_sample,
+                "max_tokens": self.max_tokens,
+                "temperature": self.temperature,
+                "top_p": self.top_p,
+                "stopping_tokens": stopping_tokens,
+                **kwargs,
+            }
+
+            response = requests.post(url, json=data, headers=headers)
+
+            if response.ok:
+                return response.json().get("answer", "No answer found")
+            else:
+                raise MaritalkHTTPError(response)
+
+        except requests.exceptions.RequestException as e:
+            return f"An error occurred: {str(e)}"
+
+        # Fallback return statement, in case of unexpected code paths
+        return "An unexpected error occurred"
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """
+        Identifies the key parameters of the chat model for logging
+        or tracking purposes.
+
+        Returns:
+            A dictionary of the key configuration parameters.
+        """
+        return {
+            "model": self.model,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            "max_tokens": self.max_tokens,
+        }
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/meta.py b/llm/Lib/site-packages/langchain_community/chat_models/meta.py
new file mode 100644
index 0000000000000000000000000000000000000000..f7b560bb630fe82c122062af105590c19aa288ce
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/meta.py
@@ -0,0 +1,31 @@
+from typing import List
+
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    ChatMessage,
+    HumanMessage,
+    SystemMessage,
+)
+
+
+def _convert_one_message_to_text_llama(message: BaseMessage) -> str:
+    if isinstance(message, ChatMessage):
+        message_text = f"\n\n{message.role.capitalize()}: {message.content}"
+    elif isinstance(message, HumanMessage):
+        message_text = f"[INST] {message.content} [/INST]"
+    elif isinstance(message, AIMessage):
+        message_text = f"{message.content}"
+    elif isinstance(message, SystemMessage):
+        message_text = f"<<SYS>> {message.content} <</SYS>>"
+    else:
+        raise ValueError(f"Got unknown type {message}")
+    return message_text
+
+
+def convert_messages_to_prompt_llama(messages: List[BaseMessage]) -> str:
+    """Convert a list of messages to a prompt for llama."""
+
+    return "\n".join(
+        [_convert_one_message_to_text_llama(message) for message in messages]
+    )
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/minimax.py b/llm/Lib/site-packages/langchain_community/chat_models/minimax.py
new file mode 100644
index 0000000000000000000000000000000000000000..a315aa1f5392bb76d901e3f2e36dac6c65e35fe3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/minimax.py
@@ -0,0 +1,96 @@
+"""Wrapper around Minimax chat models."""
+import logging
+from typing import Any, Dict, List, Optional, cast
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    HumanMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatResult
+
+from langchain_community.llms.minimax import MinimaxCommon
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+def _parse_message(msg_type: str, text: str) -> Dict:
+    return {"sender_type": msg_type, "text": text}
+
+
+def _parse_chat_history(history: List[BaseMessage]) -> List:
+    """Parse a sequence of messages into history."""
+    chat_history = []
+    for message in history:
+        content = cast(str, message.content)
+        if isinstance(message, HumanMessage):
+            chat_history.append(_parse_message("USER", content))
+        if isinstance(message, AIMessage):
+            chat_history.append(_parse_message("BOT", content))
+    return chat_history
+
+
+class MiniMaxChat(MinimaxCommon, BaseChatModel):
+    """MiniMax large language models.
+
+    To use, you should have the environment variable ``MINIMAX_GROUP_ID`` and
+    ``MINIMAX_API_KEY`` set with your API token, or pass it as a named parameter to
+    the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import MiniMaxChat
+            llm = MiniMaxChat(model_name="abab5-chat")
+
+    """
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Generate next turn in the conversation.
+        Args:
+            messages: The history of the conversation as a list of messages. Code chat
+                does not support context.
+            stop: The list of stop words (optional).
+            run_manager: The CallbackManager for LLM run, it's not used at the moment.
+
+        Returns:
+            The ChatResult that contains outputs generated by the model.
+
+        Raises:
+            ValueError: if the last message in the list is not from human.
+        """
+        if not messages:
+            raise ValueError(
+                "You should provide at least one message to start the chat!"
+            )
+        history = _parse_chat_history(messages)
+        payload = self._default_params
+        payload["messages"] = history
+        text = self._client.post(payload)
+
+        # This is required since the stop are not enforced by the model parameters
+        text = text if stop is None else enforce_stop_tokens(text, stop)
+        return ChatResult(generations=[ChatGeneration(message=AIMessage(text))])
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        raise NotImplementedError(
+            """Minimax AI doesn't support async requests at the moment."""
+        )
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/mlflow.py b/llm/Lib/site-packages/langchain_community/chat_models/mlflow.py
new file mode 100644
index 0000000000000000000000000000000000000000..c09a3b13c74be1234d98e66912e2c60752c3599e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/mlflow.py
@@ -0,0 +1,288 @@
+import logging
+from typing import Any, Dict, Iterator, List, Mapping, Optional, cast
+from urllib.parse import urlparse
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models import BaseChatModel
+from langchain_core.language_models.base import LanguageModelInput
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    FunctionMessage,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+    SystemMessageChunk,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import (
+    Field,
+    PrivateAttr,
+)
+from langchain_core.runnables import RunnableConfig
+
+logger = logging.getLogger(__name__)
+
+
+class ChatMlflow(BaseChatModel):
+    """`MLflow` chat models API.
+
+    To use, you should have the `mlflow[genai]` python package installed.
+    For more information, see https://mlflow.org/docs/latest/llms/deployments.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatMlflow
+
+            chat = ChatMlflow(
+                target_uri="http://localhost:5000",
+                endpoint="chat",
+                temperature-0.1,
+            )
+    """
+
+    endpoint: str
+    """The endpoint to use."""
+    target_uri: str
+    """The target URI to use."""
+    temperature: float = 0.0
+    """The sampling temperature."""
+    n: int = 1
+    """The number of completion choices to generate."""
+    stop: Optional[List[str]] = None
+    """The stop sequence."""
+    max_tokens: Optional[int] = None
+    """The maximum number of tokens to generate."""
+    extra_params: dict = Field(default_factory=dict)
+    """Any extra parameters to pass to the endpoint."""
+    _client: Any = PrivateAttr()
+
+    def __init__(self, **kwargs: Any):
+        super().__init__(**kwargs)
+        self._validate_uri()
+        try:
+            from mlflow.deployments import get_deploy_client
+
+            self._client = get_deploy_client(self.target_uri)
+        except ImportError as e:
+            raise ImportError(
+                "Failed to create the client. "
+                f"Please run `pip install mlflow{self._mlflow_extras}` to install "
+                "required dependencies."
+            ) from e
+
+    @property
+    def _mlflow_extras(self) -> str:
+        return "[genai]"
+
+    def _validate_uri(self) -> None:
+        if self.target_uri == "databricks":
+            return
+        allowed = ["http", "https", "databricks"]
+        if urlparse(self.target_uri).scheme not in allowed:
+            raise ValueError(
+                f"Invalid target URI: {self.target_uri}. "
+                f"The scheme must be one of {allowed}."
+            )
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        params: Dict[str, Any] = {
+            "target_uri": self.target_uri,
+            "endpoint": self.endpoint,
+            "temperature": self.temperature,
+            "n": self.n,
+            "stop": self.stop,
+            "max_tokens": self.max_tokens,
+            "extra_params": self.extra_params,
+        }
+        return params
+
+    def _prepare_inputs(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        message_dicts = [
+            ChatMlflow._convert_message_to_dict(message) for message in messages
+        ]
+        data: Dict[str, Any] = {
+            "messages": message_dicts,
+            "temperature": self.temperature,
+            "n": self.n,
+            **self.extra_params,
+            **kwargs,
+        }
+        if stop := self.stop or stop:
+            data["stop"] = stop
+        if self.max_tokens is not None:
+            data["max_tokens"] = self.max_tokens
+
+        return data
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        data = self._prepare_inputs(
+            messages,
+            stop,
+            **kwargs,
+        )
+        resp = self._client.predict(endpoint=self.endpoint, inputs=data)
+        return ChatMlflow._create_chat_result(resp)
+
+    def stream(
+        self,
+        input: LanguageModelInput,
+        config: Optional[RunnableConfig] = None,
+        *,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Iterator[BaseMessageChunk]:
+        # We need to override `stream` to handle the case
+        # that `self._client` does not implement `predict_stream`
+        if not hasattr(self._client, "predict_stream"):
+            # MLflow deployment client does not implement streaming,
+            # so use default implementation
+            yield cast(
+                BaseMessageChunk, self.invoke(input, config=config, stop=stop, **kwargs)
+            )
+        else:
+            yield from super().stream(input, config, stop=stop, **kwargs)
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        data = self._prepare_inputs(
+            messages,
+            stop,
+            **kwargs,
+        )
+        # TODO: check if `_client.predict_stream` is available.
+        chunk_iter = self._client.predict_stream(endpoint=self.endpoint, inputs=data)
+        for chunk in chunk_iter:
+            choice = chunk["choices"][0]
+            chunk = ChatMlflow._convert_delta_to_message_chunk(choice["delta"])
+
+            generation_info = {}
+            if finish_reason := choice.get("finish_reason"):
+                generation_info["finish_reason"] = finish_reason
+            if logprobs := choice.get("logprobs"):
+                generation_info["logprobs"] = logprobs
+
+            chunk = ChatGenerationChunk(
+                message=chunk, generation_info=generation_info or None
+            )
+
+            if run_manager:
+                run_manager.on_llm_new_token(chunk.text, chunk=chunk, logprobs=logprobs)
+
+            yield chunk
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        return self._default_params
+
+    def _get_invocation_params(
+        self, stop: Optional[List[str]] = None, **kwargs: Any
+    ) -> Dict[str, Any]:
+        """Get the parameters used to invoke the model FOR THE CALLBACKS."""
+        return {
+            **self._default_params,
+            **super()._get_invocation_params(stop=stop, **kwargs),
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "mlflow-chat"
+
+    @staticmethod
+    def _convert_dict_to_message(_dict: Mapping[str, Any]) -> BaseMessage:
+        role = _dict["role"]
+        content = _dict["content"]
+        if role == "user":
+            return HumanMessage(content=content)
+        elif role == "assistant":
+            return AIMessage(content=content)
+        elif role == "system":
+            return SystemMessage(content=content)
+        else:
+            return ChatMessage(content=content, role=role)
+
+    @staticmethod
+    def _convert_delta_to_message_chunk(_dict: Mapping[str, Any]) -> BaseMessageChunk:
+        role = _dict["role"]
+        content = _dict["content"]
+        if role == "user":
+            return HumanMessageChunk(content=content)
+        elif role == "assistant":
+            return AIMessageChunk(content=content)
+        elif role == "system":
+            return SystemMessageChunk(content=content)
+        else:
+            return ChatMessageChunk(content=content, role=role)
+
+    @staticmethod
+    def _raise_functions_not_supported() -> None:
+        raise ValueError(
+            "Function messages are not supported by Databricks. Please"
+            " create a feature request at https://github.com/mlflow/mlflow/issues."
+        )
+
+    @staticmethod
+    def _convert_message_to_dict(message: BaseMessage) -> dict:
+        if isinstance(message, ChatMessage):
+            message_dict = {"role": message.role, "content": message.content}
+        elif isinstance(message, HumanMessage):
+            message_dict = {"role": "user", "content": message.content}
+        elif isinstance(message, AIMessage):
+            message_dict = {"role": "assistant", "content": message.content}
+        elif isinstance(message, SystemMessage):
+            message_dict = {"role": "system", "content": message.content}
+        elif isinstance(message, FunctionMessage):
+            raise ValueError(
+                "Function messages are not supported by Databricks. Please"
+                " create a feature request at https://github.com/mlflow/mlflow/issues."
+            )
+        else:
+            raise ValueError(f"Got unknown message type: {message}")
+
+        if "function_call" in message.additional_kwargs:
+            ChatMlflow._raise_functions_not_supported()
+        if message.additional_kwargs:
+            logger.warning(
+                "Additional message arguments are unsupported by Databricks"
+                " and will be ignored: %s",
+                message.additional_kwargs,
+            )
+        return message_dict
+
+    @staticmethod
+    def _create_chat_result(response: Mapping[str, Any]) -> ChatResult:
+        generations = []
+        for choice in response["choices"]:
+            message = ChatMlflow._convert_dict_to_message(choice["message"])
+            usage = choice.get("usage", {})
+            gen = ChatGeneration(
+                message=message,
+                generation_info=usage,
+            )
+            generations.append(gen)
+
+        usage = response.get("usage", {})
+        return ChatResult(generations=generations, llm_output=usage)
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/mlflow_ai_gateway.py b/llm/Lib/site-packages/langchain_community/chat_models/mlflow_ai_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..35321655a4f59494ef49793130d95c2a87d56898
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/mlflow_ai_gateway.py
@@ -0,0 +1,195 @@
+import logging
+import warnings
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core.callbacks import (
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    ChatMessage,
+    FunctionMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatResult,
+)
+from langchain_core.pydantic_v1 import BaseModel, Extra
+
+logger = logging.getLogger(__name__)
+
+
+# Ignoring type because below is valid pydantic code
+# Unexpected keyword argument "extra" for "__init_subclass__" of "object"  [call-arg]
+class ChatParams(BaseModel, extra=Extra.allow):
+    """Parameters for the `MLflow AI Gateway` LLM."""
+
+    temperature: float = 0.0
+    candidate_count: int = 1
+    """The number of candidates to return."""
+    stop: Optional[List[str]] = None
+    max_tokens: Optional[int] = None
+
+
+class ChatMLflowAIGateway(BaseChatModel):
+    """`MLflow AI Gateway` chat models API.
+
+    To use, you should have the ``mlflow[gateway]`` python package installed.
+    For more information, see https://mlflow.org/docs/latest/gateway/index.html.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatMLflowAIGateway
+
+            chat = ChatMLflowAIGateway(
+                gateway_uri="<your-mlflow-ai-gateway-uri>",
+                route="<your-mlflow-ai-gateway-chat-route>",
+                params={
+                    "temperature": 0.1
+                }
+            )
+    """
+
+    def __init__(self, **kwargs: Any):
+        warnings.warn(
+            "`ChatMLflowAIGateway` is deprecated. Use `ChatMlflow` or "
+            "`ChatDatabricks` instead.",
+            DeprecationWarning,
+        )
+        try:
+            import mlflow.gateway
+        except ImportError as e:
+            raise ImportError(
+                "Could not import `mlflow.gateway` module. "
+                "Please install it with `pip install mlflow[gateway]`."
+            ) from e
+
+        super().__init__(**kwargs)
+        if self.gateway_uri:
+            mlflow.gateway.set_gateway_uri(self.gateway_uri)
+
+    route: str
+    gateway_uri: Optional[str] = None
+    params: Optional[ChatParams] = None
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        params: Dict[str, Any] = {
+            "gateway_uri": self.gateway_uri,
+            "route": self.route,
+            **(self.params.dict() if self.params else {}),
+        }
+        return params
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        try:
+            import mlflow.gateway
+        except ImportError as e:
+            raise ImportError(
+                "Could not import `mlflow.gateway` module. "
+                "Please install it with `pip install mlflow[gateway]`."
+            ) from e
+
+        message_dicts = [
+            ChatMLflowAIGateway._convert_message_to_dict(message)
+            for message in messages
+        ]
+        data: Dict[str, Any] = {
+            "messages": message_dicts,
+            **(self.params.dict() if self.params else {}),
+        }
+
+        resp = mlflow.gateway.query(self.route, data=data)
+        return ChatMLflowAIGateway._create_chat_result(resp)
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        return self._default_params
+
+    def _get_invocation_params(
+        self, stop: Optional[List[str]] = None, **kwargs: Any
+    ) -> Dict[str, Any]:
+        """Get the parameters used to invoke the model FOR THE CALLBACKS."""
+        return {
+            **self._default_params,
+            **super()._get_invocation_params(stop=stop, **kwargs),
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "mlflow-ai-gateway-chat"
+
+    @staticmethod
+    def _convert_dict_to_message(_dict: Mapping[str, Any]) -> BaseMessage:
+        role = _dict["role"]
+        content = _dict["content"]
+        if role == "user":
+            return HumanMessage(content=content)
+        elif role == "assistant":
+            return AIMessage(content=content)
+        elif role == "system":
+            return SystemMessage(content=content)
+        else:
+            return ChatMessage(content=content, role=role)
+
+    @staticmethod
+    def _raise_functions_not_supported() -> None:
+        raise ValueError(
+            "Function messages are not supported by the MLflow AI Gateway. Please"
+            " create a feature request at https://github.com/mlflow/mlflow/issues."
+        )
+
+    @staticmethod
+    def _convert_message_to_dict(message: BaseMessage) -> dict:
+        if isinstance(message, ChatMessage):
+            message_dict = {"role": message.role, "content": message.content}
+        elif isinstance(message, HumanMessage):
+            message_dict = {"role": "user", "content": message.content}
+        elif isinstance(message, AIMessage):
+            message_dict = {"role": "assistant", "content": message.content}
+        elif isinstance(message, SystemMessage):
+            message_dict = {"role": "system", "content": message.content}
+        elif isinstance(message, FunctionMessage):
+            raise ValueError(
+                "Function messages are not supported by the MLflow AI Gateway. Please"
+                " create a feature request at https://github.com/mlflow/mlflow/issues."
+            )
+        else:
+            raise ValueError(f"Got unknown message type: {message}")
+
+        if "function_call" in message.additional_kwargs:
+            ChatMLflowAIGateway._raise_functions_not_supported()
+        if message.additional_kwargs:
+            logger.warning(
+                "Additional message arguments are unsupported by MLflow AI Gateway "
+                " and will be ignored: %s",
+                message.additional_kwargs,
+            )
+        return message_dict
+
+    @staticmethod
+    def _create_chat_result(response: Mapping[str, Any]) -> ChatResult:
+        generations = []
+        for candidate in response["candidates"]:
+            message = ChatMLflowAIGateway._convert_dict_to_message(candidate["message"])
+            message_metadata = candidate.get("metadata", {})
+            gen = ChatGeneration(
+                message=message,
+                generation_info=dict(message_metadata),
+            )
+            generations.append(gen)
+
+        response_metadata = response.get("metadata", {})
+        return ChatResult(generations=generations, llm_output=response_metadata)
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/mlx.py b/llm/Lib/site-packages/langchain_community/chat_models/mlx.py
new file mode 100644
index 0000000000000000000000000000000000000000..e6f2b70473d112501501029681a72a88069b31bc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/mlx.py
@@ -0,0 +1,196 @@
+"""MLX Chat Wrapper."""
+
+from typing import Any, Iterator, List, Optional
+
+from langchain_core.callbacks.manager import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatGenerationChunk,
+    ChatResult,
+    LLMResult,
+)
+
+from langchain_community.llms.mlx_pipeline import MLXPipeline
+
+DEFAULT_SYSTEM_PROMPT = """You are a helpful, respectful, and honest assistant."""
+
+
+class ChatMLX(BaseChatModel):
+    """
+    Wrapper for using MLX LLM's as ChatModels.
+
+    Works with `MLXPipeline` LLM.
+
+    To use, you should have the ``mlx-lm`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import chatMLX
+            from langchain_community.llms import MLXPipeline
+
+            llm = MLXPipeline.from_model_id(
+                model_id="mlx-community/quantized-gemma-2b-it",
+            )
+            chat = chatMLX(llm=llm)
+
+    """
+
+    llm: MLXPipeline
+    system_message: SystemMessage = SystemMessage(content=DEFAULT_SYSTEM_PROMPT)
+    tokenizer: Any = None
+
+    def __init__(self, **kwargs: Any):
+        super().__init__(**kwargs)
+        self.tokenizer = self.llm.tokenizer
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        llm_input = self._to_chat_prompt(messages)
+        llm_result = self.llm._generate(
+            prompts=[llm_input], stop=stop, run_manager=run_manager, **kwargs
+        )
+        return self._to_chat_result(llm_result)
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        llm_input = self._to_chat_prompt(messages)
+        llm_result = await self.llm._agenerate(
+            prompts=[llm_input], stop=stop, run_manager=run_manager, **kwargs
+        )
+        return self._to_chat_result(llm_result)
+
+    def _to_chat_prompt(
+        self,
+        messages: List[BaseMessage],
+        tokenize: bool = False,
+        return_tensors: Optional[str] = None,
+    ) -> str:
+        """Convert a list of messages into a prompt format expected by wrapped LLM."""
+        if not messages:
+            raise ValueError("At least one HumanMessage must be provided!")
+
+        if not isinstance(messages[-1], HumanMessage):
+            raise ValueError("Last message must be a HumanMessage!")
+
+        messages_dicts = [self._to_chatml_format(m) for m in messages]
+
+        return self.tokenizer.apply_chat_template(
+            messages_dicts,
+            tokenize=tokenize,
+            add_generation_prompt=True,
+            return_tensors=return_tensors,
+        )
+
+    def _to_chatml_format(self, message: BaseMessage) -> dict:
+        """Convert LangChain message to ChatML format."""
+
+        if isinstance(message, SystemMessage):
+            role = "system"
+        elif isinstance(message, AIMessage):
+            role = "assistant"
+        elif isinstance(message, HumanMessage):
+            role = "user"
+        else:
+            raise ValueError(f"Unknown message type: {type(message)}")
+
+        return {"role": role, "content": message.content}
+
+    @staticmethod
+    def _to_chat_result(llm_result: LLMResult) -> ChatResult:
+        chat_generations = []
+
+        for g in llm_result.generations[0]:
+            chat_generation = ChatGeneration(
+                message=AIMessage(content=g.text), generation_info=g.generation_info
+            )
+            chat_generations.append(chat_generation)
+
+        return ChatResult(
+            generations=chat_generations, llm_output=llm_result.llm_output
+        )
+
+    @property
+    def _llm_type(self) -> str:
+        return "mlx-chat-wrapper"
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        import mlx.core as mx
+        from mlx_lm.utils import generate_step
+
+        try:
+            import mlx.core as mx
+            from mlx_lm.utils import generate_step
+
+        except ImportError:
+            raise ValueError(
+                "Could not import mlx_lm python package. "
+                "Please install it with `pip install mlx_lm`."
+            )
+        model_kwargs = kwargs.get("model_kwargs", self.llm.pipeline_kwargs)
+        temp: float = model_kwargs.get("temp", 0.0)
+        max_new_tokens: int = model_kwargs.get("max_tokens", 100)
+        repetition_penalty: Optional[float] = model_kwargs.get(
+            "repetition_penalty", None
+        )
+        repetition_context_size: Optional[int] = model_kwargs.get(
+            "repetition_context_size", None
+        )
+
+        llm_input = self._to_chat_prompt(messages, tokenize=True, return_tensors="np")
+
+        prompt_tokens = mx.array(llm_input[0])
+
+        eos_token_id = self.tokenizer.eos_token_id
+
+        for (token, prob), n in zip(
+            generate_step(
+                prompt_tokens,
+                self.llm.model,
+                temp,
+                repetition_penalty,
+                repetition_context_size,
+            ),
+            range(max_new_tokens),
+        ):
+            # identify text to yield
+            text: Optional[str] = None
+            text = self.tokenizer.decode(token.item())
+
+            # yield text, if any
+            if text:
+                chunk = ChatGenerationChunk(message=AIMessageChunk(content=text))
+                yield chunk
+                if run_manager:
+                    run_manager.on_llm_new_token(text, chunk=chunk)
+
+            # break if stop sequence found
+            if token == eos_token_id or (stop is not None and text in stop):
+                break
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/moonshot.py b/llm/Lib/site-packages/langchain_community/chat_models/moonshot.py
new file mode 100644
index 0000000000000000000000000000000000000000..202a62d8ea1c7e05ea58e637a5ab7113ba722bc8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/moonshot.py
@@ -0,0 +1,58 @@
+"""Wrapper around Moonshot chat models."""
+from typing import Dict
+
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.chat_models import ChatOpenAI
+from langchain_community.llms.moonshot import MOONSHOT_SERVICE_URL_BASE, MoonshotCommon
+
+
+class MoonshotChat(MoonshotCommon, ChatOpenAI):  # type: ignore[misc]
+    """Moonshot large language models.
+
+    To use, you should have the ``openai`` python package installed, and the
+    environment variable ``MOONSHOT_API_KEY`` set with your API key.
+    (Moonshot's chat API is compatible with OpenAI's SDK.)
+
+    Referenced from https://platform.moonshot.cn/docs
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models.moonshot import MoonshotChat
+
+            moonshot = MoonshotChat(model="moonshot-v1-8k")
+    """
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the environment is set up correctly."""
+        values["moonshot_api_key"] = get_from_dict_or_env(
+            values, "moonshot_api_key", "MOONSHOT_API_KEY"
+        )
+
+        try:
+            import openai
+
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+
+        client_params = {
+            "api_key": values["moonshot_api_key"],
+            "base_url": values["base_url"]
+            if "base_url" in values
+            else MOONSHOT_SERVICE_URL_BASE,
+        }
+
+        if not values.get("client"):
+            values["client"] = openai.OpenAI(**client_params).chat.completions
+        if not values.get("async_client"):
+            values["async_client"] = openai.AsyncOpenAI(
+                **client_params
+            ).chat.completions
+
+        return values
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/octoai.py b/llm/Lib/site-packages/langchain_community/chat_models/octoai.py
new file mode 100644
index 0000000000000000000000000000000000000000..8834b867069b94ba9965005757e391c86d0969c3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/octoai.py
@@ -0,0 +1,93 @@
+"""OctoAI Endpoints chat wrapper. Relies heavily on ChatOpenAI."""
+from typing import Dict
+
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.chat_models.openai import ChatOpenAI
+from langchain_community.utils.openai import is_openai_v1
+
+DEFAULT_API_BASE = "https://text.octoai.run/v1/"
+DEFAULT_MODEL = "llama-2-13b-chat"
+
+
+class ChatOctoAI(ChatOpenAI):
+    """OctoAI Chat large language models.
+
+    See https://octo.ai/ for information about OctoAI.
+
+    To use, you should have the ``openai`` python package installed and the
+    environment variable ``OCTOAI_API_TOKEN`` set with your API token.
+    Alternatively, you can use the octoai_api_token keyword argument.
+
+    Any parameters that are valid to be passed to the `openai.create` call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatOctoAI
+            chat = ChatOctoAI(model_name="mixtral-8x7b-instruct")
+    """
+
+    octoai_api_base: str = Field(default=DEFAULT_API_BASE)
+    octoai_api_token: SecretStr = Field(default=None)
+    model_name: str = Field(default=DEFAULT_MODEL)
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "octoai-chat"
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"octoai_api_token": "OCTOAI_API_TOKEN"}
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["octoai_api_base"] = get_from_dict_or_env(
+            values,
+            "octoai_api_base",
+            "OCTOAI_API_BASE",
+            default=DEFAULT_API_BASE,
+        )
+        values["octoai_api_token"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "octoai_api_token", "OCTOAI_API_TOKEN")
+        )
+        values["model_name"] = get_from_dict_or_env(
+            values,
+            "model_name",
+            "MODEL_NAME",
+            default=DEFAULT_MODEL,
+        )
+
+        try:
+            import openai
+
+            if is_openai_v1():
+                client_params = {
+                    "api_key": values["octoai_api_token"].get_secret_value(),
+                    "base_url": values["octoai_api_base"],
+                }
+                if not values.get("client"):
+                    values["client"] = openai.OpenAI(**client_params).chat.completions
+                if not values.get("async_client"):
+                    values["async_client"] = openai.AsyncOpenAI(
+                        **client_params
+                    ).chat.completions
+            else:
+                values["openai_api_base"] = values["octoai_api_base"]
+                values["openai_api_key"] = values["octoai_api_token"].get_secret_value()
+                values["client"] = openai.ChatCompletion
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+
+        return values
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/ollama.py b/llm/Lib/site-packages/langchain_community/chat_models/ollama.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e5a98f8ae079508cd4f573beaa3b60b8a983725
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/ollama.py
@@ -0,0 +1,366 @@
+import json
+from typing import Any, AsyncIterator, Dict, Iterator, List, Optional, Union, cast
+
+from langchain_core._api import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    ChatMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+
+from langchain_community.llms.ollama import OllamaEndpointNotFoundError, _OllamaCommon
+
+
+@deprecated("0.0.3", alternative="_chat_stream_response_to_chat_generation_chunk")
+def _stream_response_to_chat_generation_chunk(
+    stream_response: str,
+) -> ChatGenerationChunk:
+    """Convert a stream response to a generation chunk."""
+    parsed_response = json.loads(stream_response)
+    generation_info = parsed_response if parsed_response.get("done") is True else None
+    return ChatGenerationChunk(
+        message=AIMessageChunk(content=parsed_response.get("response", "")),
+        generation_info=generation_info,
+    )
+
+
+def _chat_stream_response_to_chat_generation_chunk(
+    stream_response: str,
+) -> ChatGenerationChunk:
+    """Convert a stream response to a generation chunk."""
+    parsed_response = json.loads(stream_response)
+    generation_info = parsed_response if parsed_response.get("done") is True else None
+    return ChatGenerationChunk(
+        message=AIMessageChunk(
+            content=parsed_response.get("message", {}).get("content", "")
+        ),
+        generation_info=generation_info,
+    )
+
+
+class ChatOllama(BaseChatModel, _OllamaCommon):
+    """Ollama locally runs large language models.
+
+    To use, follow the instructions at https://ollama.ai/.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatOllama
+            ollama = ChatOllama(model="llama2")
+    """
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "ollama-chat"
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this model can be serialized by Langchain."""
+        return False
+
+    @deprecated("0.0.3", alternative="_convert_messages_to_ollama_messages")
+    def _format_message_as_text(self, message: BaseMessage) -> str:
+        if isinstance(message, ChatMessage):
+            message_text = f"\n\n{message.role.capitalize()}: {message.content}"
+        elif isinstance(message, HumanMessage):
+            if isinstance(message.content, List):
+                first_content = cast(List[Dict], message.content)[0]
+                content_type = first_content.get("type")
+                if content_type == "text":
+                    message_text = f"[INST] {first_content['text']} [/INST]"
+                elif content_type == "image_url":
+                    message_text = first_content["image_url"]["url"]
+            else:
+                message_text = f"[INST] {message.content} [/INST]"
+        elif isinstance(message, AIMessage):
+            message_text = f"{message.content}"
+        elif isinstance(message, SystemMessage):
+            message_text = f"<<SYS>> {message.content} <</SYS>>"
+        else:
+            raise ValueError(f"Got unknown type {message}")
+        return message_text
+
+    def _format_messages_as_text(self, messages: List[BaseMessage]) -> str:
+        return "\n".join(
+            [self._format_message_as_text(message) for message in messages]
+        )
+
+    def _convert_messages_to_ollama_messages(
+        self, messages: List[BaseMessage]
+    ) -> List[Dict[str, Union[str, List[str]]]]:
+        ollama_messages: List = []
+        for message in messages:
+            role = ""
+            if isinstance(message, HumanMessage):
+                role = "user"
+            elif isinstance(message, AIMessage):
+                role = "assistant"
+            elif isinstance(message, SystemMessage):
+                role = "system"
+            else:
+                raise ValueError("Received unsupported message type for Ollama.")
+
+            content = ""
+            images = []
+            if isinstance(message.content, str):
+                content = message.content
+            else:
+                for content_part in cast(List[Dict], message.content):
+                    if content_part.get("type") == "text":
+                        content += f"\n{content_part['text']}"
+                    elif content_part.get("type") == "image_url":
+                        if isinstance(content_part.get("image_url"), str):
+                            image_url_components = content_part["image_url"].split(",")
+                            # Support data:image/jpeg;base64,<image> format
+                            # and base64 strings
+                            if len(image_url_components) > 1:
+                                images.append(image_url_components[1])
+                            else:
+                                images.append(image_url_components[0])
+                        else:
+                            raise ValueError(
+                                "Only string image_url " "content parts are supported."
+                            )
+                    else:
+                        raise ValueError(
+                            "Unsupported message content type. "
+                            "Must either have type 'text' or type 'image_url' "
+                            "with a string 'image_url' field."
+                        )
+
+            ollama_messages.append(
+                {
+                    "role": role,
+                    "content": content,
+                    "images": images,
+                }
+            )
+
+        return ollama_messages
+
+    def _create_chat_stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Iterator[str]:
+        payload = {
+            "model": self.model,
+            "messages": self._convert_messages_to_ollama_messages(messages),
+        }
+        yield from self._create_stream(
+            payload=payload, stop=stop, api_url=f"{self.base_url}/api/chat", **kwargs
+        )
+
+    async def _acreate_chat_stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[str]:
+        payload = {
+            "model": self.model,
+            "messages": self._convert_messages_to_ollama_messages(messages),
+        }
+        async for stream_resp in self._acreate_stream(
+            payload=payload, stop=stop, api_url=f"{self.base_url}/api/chat", **kwargs
+        ):
+            yield stream_resp
+
+    def _chat_stream_with_aggregation(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        verbose: bool = False,
+        **kwargs: Any,
+    ) -> ChatGenerationChunk:
+        final_chunk: Optional[ChatGenerationChunk] = None
+        for stream_resp in self._create_chat_stream(messages, stop, **kwargs):
+            if stream_resp:
+                chunk = _chat_stream_response_to_chat_generation_chunk(stream_resp)
+                if final_chunk is None:
+                    final_chunk = chunk
+                else:
+                    final_chunk += chunk
+                if run_manager:
+                    run_manager.on_llm_new_token(
+                        chunk.text,
+                        chunk=chunk,
+                        verbose=verbose,
+                    )
+        if final_chunk is None:
+            raise ValueError("No data received from Ollama stream.")
+
+        return final_chunk
+
+    async def _achat_stream_with_aggregation(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        verbose: bool = False,
+        **kwargs: Any,
+    ) -> ChatGenerationChunk:
+        final_chunk: Optional[ChatGenerationChunk] = None
+        async for stream_resp in self._acreate_chat_stream(messages, stop, **kwargs):
+            if stream_resp:
+                chunk = _chat_stream_response_to_chat_generation_chunk(stream_resp)
+                if final_chunk is None:
+                    final_chunk = chunk
+                else:
+                    final_chunk += chunk
+                if run_manager:
+                    await run_manager.on_llm_new_token(
+                        chunk.text,
+                        chunk=chunk,
+                        verbose=verbose,
+                    )
+        if final_chunk is None:
+            raise ValueError("No data received from Ollama stream.")
+
+        return final_chunk
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Call out to Ollama's generate endpoint.
+
+        Args:
+            messages: The list of base messages to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            Chat generations from the model
+
+        Example:
+            .. code-block:: python
+
+                response = ollama([
+                    HumanMessage(content="Tell me about the history of AI")
+                ])
+        """
+
+        final_chunk = self._chat_stream_with_aggregation(
+            messages,
+            stop=stop,
+            run_manager=run_manager,
+            verbose=self.verbose,
+            **kwargs,
+        )
+        chat_generation = ChatGeneration(
+            message=AIMessage(content=final_chunk.text),
+            generation_info=final_chunk.generation_info,
+        )
+        return ChatResult(generations=[chat_generation])
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Call out to Ollama's generate endpoint.
+
+        Args:
+            messages: The list of base messages to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            Chat generations from the model
+
+        Example:
+            .. code-block:: python
+
+                response = ollama([
+                    HumanMessage(content="Tell me about the history of AI")
+                ])
+        """
+
+        final_chunk = await self._achat_stream_with_aggregation(
+            messages,
+            stop=stop,
+            run_manager=run_manager,
+            verbose=self.verbose,
+            **kwargs,
+        )
+        chat_generation = ChatGeneration(
+            message=AIMessage(content=final_chunk.text),
+            generation_info=final_chunk.generation_info,
+        )
+        return ChatResult(generations=[chat_generation])
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        try:
+            for stream_resp in self._create_chat_stream(messages, stop, **kwargs):
+                if stream_resp:
+                    chunk = _chat_stream_response_to_chat_generation_chunk(stream_resp)
+                    if run_manager:
+                        run_manager.on_llm_new_token(
+                            chunk.text,
+                            chunk=chunk,
+                            verbose=self.verbose,
+                        )
+                    yield chunk
+        except OllamaEndpointNotFoundError:
+            yield from self._legacy_stream(messages, stop, **kwargs)
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        async for stream_resp in self._acreate_chat_stream(messages, stop, **kwargs):
+            if stream_resp:
+                chunk = _chat_stream_response_to_chat_generation_chunk(stream_resp)
+                if run_manager:
+                    await run_manager.on_llm_new_token(
+                        chunk.text,
+                        chunk=chunk,
+                        verbose=self.verbose,
+                    )
+                yield chunk
+
+    @deprecated("0.0.3", alternative="_stream")
+    def _legacy_stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        prompt = self._format_messages_as_text(messages)
+        for stream_resp in self._create_generate_stream(prompt, stop, **kwargs):
+            if stream_resp:
+                chunk = _stream_response_to_chat_generation_chunk(stream_resp)
+                if run_manager:
+                    run_manager.on_llm_new_token(
+                        chunk.text,
+                        chunk=chunk,
+                        verbose=self.verbose,
+                    )
+                yield chunk
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/openai.py b/llm/Lib/site-packages/langchain_community/chat_models/openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..de1df40703b0a4715f316043f6243db9b3ce465d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/openai.py
@@ -0,0 +1,687 @@
+"""OpenAI chat wrapper."""
+from __future__ import annotations
+
+import logging
+import os
+import sys
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+)
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models import LanguageModelInput
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.language_models.llms import create_base_retry_decorator
+from langchain_core.messages import (
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessageChunk,
+    FunctionMessageChunk,
+    HumanMessageChunk,
+    SystemMessageChunk,
+    ToolMessageChunk,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+from langchain_core.runnables import Runnable
+from langchain_core.utils import (
+    get_from_dict_or_env,
+    get_pydantic_field_names,
+)
+
+from langchain_community.adapters.openai import (
+    convert_dict_to_message,
+    convert_message_to_dict,
+)
+from langchain_community.utils.openai import is_openai_v1
+
+if TYPE_CHECKING:
+    import tiktoken
+
+
+logger = logging.getLogger(__name__)
+
+
+def _import_tiktoken() -> Any:
+    try:
+        import tiktoken
+    except ImportError:
+        raise ValueError(
+            "Could not import tiktoken python package. "
+            "This is needed in order to calculate get_token_ids. "
+            "Please install it with `pip install tiktoken`."
+        )
+    return tiktoken
+
+
+def _create_retry_decorator(
+    llm: ChatOpenAI,
+    run_manager: Optional[
+        Union[AsyncCallbackManagerForLLMRun, CallbackManagerForLLMRun]
+    ] = None,
+) -> Callable[[Any], Any]:
+    import openai
+
+    errors = [
+        openai.error.Timeout,
+        openai.error.APIError,
+        openai.error.APIConnectionError,
+        openai.error.RateLimitError,
+        openai.error.ServiceUnavailableError,
+    ]
+    return create_base_retry_decorator(
+        error_types=errors, max_retries=llm.max_retries, run_manager=run_manager
+    )
+
+
+async def acompletion_with_retry(
+    llm: ChatOpenAI,
+    run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the async completion call."""
+    if is_openai_v1():
+        return await llm.async_client.create(**kwargs)
+
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @retry_decorator
+    async def _completion_with_retry(**kwargs: Any) -> Any:
+        # Use OpenAI's async api https://github.com/openai/openai-python#async-api
+        return await llm.client.acreate(**kwargs)
+
+    return await _completion_with_retry(**kwargs)
+
+
+def _convert_delta_to_message_chunk(
+    _dict: Mapping[str, Any], default_class: Type[BaseMessageChunk]
+) -> BaseMessageChunk:
+    role = _dict.get("role")
+    content = _dict.get("content") or ""
+    additional_kwargs: Dict = {}
+    if _dict.get("function_call"):
+        function_call = dict(_dict["function_call"])
+        if "name" in function_call and function_call["name"] is None:
+            function_call["name"] = ""
+        additional_kwargs["function_call"] = function_call
+    if _dict.get("tool_calls"):
+        additional_kwargs["tool_calls"] = _dict["tool_calls"]
+
+    if role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=content)
+    elif role == "assistant" or default_class == AIMessageChunk:
+        return AIMessageChunk(content=content, additional_kwargs=additional_kwargs)
+    elif role == "system" or default_class == SystemMessageChunk:
+        return SystemMessageChunk(content=content)
+    elif role == "function" or default_class == FunctionMessageChunk:
+        return FunctionMessageChunk(content=content, name=_dict["name"])
+    elif role == "tool" or default_class == ToolMessageChunk:
+        return ToolMessageChunk(content=content, tool_call_id=_dict["tool_call_id"])
+    elif role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=content, role=role)
+    else:
+        return default_class(content=content)
+
+
+@deprecated(
+    since="0.0.10", removal="0.2.0", alternative_import="langchain_openai.ChatOpenAI"
+)
+class ChatOpenAI(BaseChatModel):
+    """`OpenAI` Chat large language models API.
+
+    To use, you should have the ``openai`` python package installed, and the
+    environment variable ``OPENAI_API_KEY`` set with your API key.
+
+    Any parameters that are valid to be passed to the openai.create call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatOpenAI
+            openai = ChatOpenAI(model="gpt-3.5-turbo")
+    """
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"openai_api_key": "OPENAI_API_KEY"}
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "chat_models", "openai"]
+
+    @property
+    def lc_attributes(self) -> Dict[str, Any]:
+        attributes: Dict[str, Any] = {}
+
+        if self.openai_organization:
+            attributes["openai_organization"] = self.openai_organization
+
+        if self.openai_api_base:
+            attributes["openai_api_base"] = self.openai_api_base
+
+        if self.openai_proxy:
+            attributes["openai_proxy"] = self.openai_proxy
+
+        return attributes
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this model can be serialized by Langchain."""
+        return True
+
+    client: Any = Field(default=None, exclude=True)  #: :meta private:
+    async_client: Any = Field(default=None, exclude=True)  #: :meta private:
+    model_name: str = Field(default="gpt-3.5-turbo", alias="model")
+    """Model name to use."""
+    temperature: float = 0.7
+    """What sampling temperature to use."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not explicitly specified."""
+    # When updating this to use a SecretStr
+    # Check for classes that derive from this class (as some of them
+    # may assume openai_api_key is a str)
+    openai_api_key: Optional[str] = Field(default=None, alias="api_key")
+    """Automatically inferred from env var `OPENAI_API_KEY` if not provided."""
+    openai_api_base: Optional[str] = Field(default=None, alias="base_url")
+    """Base URL path for API requests, leave blank if not using a proxy or service 
+        emulator."""
+    openai_organization: Optional[str] = Field(default=None, alias="organization")
+    """Automatically inferred from env var `OPENAI_ORG_ID` if not provided."""
+    # to support explicit proxy for OpenAI
+    openai_proxy: Optional[str] = None
+    request_timeout: Union[float, Tuple[float, float], Any, None] = Field(
+        default=None, alias="timeout"
+    )
+    """Timeout for requests to OpenAI completion API. Can be float, httpx.Timeout or 
+        None."""
+    max_retries: int = 2
+    """Maximum number of retries to make when generating."""
+    streaming: bool = False
+    """Whether to stream the results or not."""
+    n: int = 1
+    """Number of chat completions to generate for each prompt."""
+    max_tokens: Optional[int] = None
+    """Maximum number of tokens to generate."""
+    tiktoken_model_name: Optional[str] = None
+    """The model name to pass to tiktoken when using this class. 
+    Tiktoken is used to count the number of tokens in documents to constrain 
+    them to be under a certain limit. By default, when set to None, this will 
+    be the same as the embedding model name. However, there are some cases 
+    where you may want to use this Embedding class with a model name not 
+    supported by tiktoken. This can include when using Azure embeddings or 
+    when using one of the many model providers that expose an OpenAI-like 
+    API but with different models. In those cases, in order to avoid erroring 
+    when tiktoken is called, you can specify a model name to use here."""
+    default_headers: Union[Mapping[str, str], None] = None
+    default_query: Union[Mapping[str, object], None] = None
+    # Configure a custom httpx client. See the
+    # [httpx documentation](https://www.python-httpx.org/api/#client) for more details.
+    http_client: Union[Any, None] = None
+    """Optional httpx.Client."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name in extra:
+                raise ValueError(f"Found {field_name} supplied twice.")
+            if field_name not in all_required_field_names:
+                logger.warning(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+
+        invalid_model_kwargs = all_required_field_names.intersection(extra.keys())
+        if invalid_model_kwargs:
+            raise ValueError(
+                f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+                f"Instead they were passed in as part of `model_kwargs` parameter."
+            )
+
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        if values["n"] < 1:
+            raise ValueError("n must be at least 1.")
+        if values["n"] > 1 and values["streaming"]:
+            raise ValueError("n must be 1 when streaming.")
+
+        values["openai_api_key"] = get_from_dict_or_env(
+            values, "openai_api_key", "OPENAI_API_KEY"
+        )
+        # Check OPENAI_ORGANIZATION for backwards compatibility.
+        values["openai_organization"] = (
+            values["openai_organization"]
+            or os.getenv("OPENAI_ORG_ID")
+            or os.getenv("OPENAI_ORGANIZATION")
+        )
+        values["openai_api_base"] = values["openai_api_base"] or os.getenv(
+            "OPENAI_API_BASE"
+        )
+        values["openai_proxy"] = get_from_dict_or_env(
+            values,
+            "openai_proxy",
+            "OPENAI_PROXY",
+            default="",
+        )
+        try:
+            import openai
+
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+
+        if is_openai_v1():
+            client_params = {
+                "api_key": values["openai_api_key"],
+                "organization": values["openai_organization"],
+                "base_url": values["openai_api_base"],
+                "timeout": values["request_timeout"],
+                "max_retries": values["max_retries"],
+                "default_headers": values["default_headers"],
+                "default_query": values["default_query"],
+                "http_client": values["http_client"],
+            }
+
+            if not values.get("client"):
+                values["client"] = openai.OpenAI(**client_params).chat.completions
+            if not values.get("async_client"):
+                values["async_client"] = openai.AsyncOpenAI(
+                    **client_params
+                ).chat.completions
+        elif not values.get("client"):
+            values["client"] = openai.ChatCompletion
+        else:
+            pass
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling OpenAI API."""
+        params = {
+            "model": self.model_name,
+            "stream": self.streaming,
+            "n": self.n,
+            "temperature": self.temperature,
+            **self.model_kwargs,
+        }
+        if self.max_tokens is not None:
+            params["max_tokens"] = self.max_tokens
+        if self.request_timeout is not None and not is_openai_v1():
+            params["request_timeout"] = self.request_timeout
+        return params
+
+    def completion_with_retry(
+        self, run_manager: Optional[CallbackManagerForLLMRun] = None, **kwargs: Any
+    ) -> Any:
+        """Use tenacity to retry the completion call."""
+        if is_openai_v1():
+            return self.client.create(**kwargs)
+
+        retry_decorator = _create_retry_decorator(self, run_manager=run_manager)
+
+        @retry_decorator
+        def _completion_with_retry(**kwargs: Any) -> Any:
+            return self.client.create(**kwargs)
+
+        return _completion_with_retry(**kwargs)
+
+    def _combine_llm_outputs(self, llm_outputs: List[Optional[dict]]) -> dict:
+        overall_token_usage: dict = {}
+        system_fingerprint = None
+        for output in llm_outputs:
+            if output is None:
+                # Happens in streaming
+                continue
+            token_usage = output["token_usage"]
+            if token_usage is not None:
+                for k, v in token_usage.items():
+                    if k in overall_token_usage:
+                        overall_token_usage[k] += v
+                    else:
+                        overall_token_usage[k] = v
+            if system_fingerprint is None:
+                system_fingerprint = output.get("system_fingerprint")
+        combined = {"token_usage": overall_token_usage, "model_name": self.model_name}
+        if system_fingerprint:
+            combined["system_fingerprint"] = system_fingerprint
+        return combined
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+
+        default_chunk_class = AIMessageChunk
+        for chunk in self.completion_with_retry(
+            messages=message_dicts, run_manager=run_manager, **params
+        ):
+            if not isinstance(chunk, dict):
+                chunk = chunk.dict()
+            if len(chunk["choices"]) == 0:
+                continue
+            choice = chunk["choices"][0]
+            chunk = _convert_delta_to_message_chunk(
+                choice["delta"], default_chunk_class
+            )
+            finish_reason = choice.get("finish_reason")
+            generation_info = (
+                dict(finish_reason=finish_reason) if finish_reason is not None else None
+            )
+            default_chunk_class = chunk.__class__
+            cg_chunk = ChatGenerationChunk(
+                message=chunk, generation_info=generation_info
+            )
+            if run_manager:
+                run_manager.on_llm_new_token(cg_chunk.text, chunk=cg_chunk)
+            yield cg_chunk
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {
+            **params,
+            **({"stream": stream} if stream is not None else {}),
+            **kwargs,
+        }
+        response = self.completion_with_retry(
+            messages=message_dicts, run_manager=run_manager, **params
+        )
+        return self._create_chat_result(response)
+
+    def _create_message_dicts(
+        self, messages: List[BaseMessage], stop: Optional[List[str]]
+    ) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+        params = self._client_params
+        if stop is not None:
+            if "stop" in params:
+                raise ValueError("`stop` found in both the input and default params.")
+            params["stop"] = stop
+        message_dicts = [convert_message_to_dict(m) for m in messages]
+        return message_dicts, params
+
+    def _create_chat_result(self, response: Union[dict, BaseModel]) -> ChatResult:
+        generations = []
+        if not isinstance(response, dict):
+            response = response.dict()
+        for res in response["choices"]:
+            message = convert_dict_to_message(res["message"])
+            generation_info = dict(finish_reason=res.get("finish_reason"))
+            if "logprobs" in res:
+                generation_info["logprobs"] = res["logprobs"]
+            gen = ChatGeneration(
+                message=message,
+                generation_info=generation_info,
+            )
+            generations.append(gen)
+        token_usage = response.get("usage", {})
+        llm_output = {
+            "token_usage": token_usage,
+            "model_name": self.model_name,
+            "system_fingerprint": response.get("system_fingerprint", ""),
+        }
+        return ChatResult(generations=generations, llm_output=llm_output)
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+
+        default_chunk_class = AIMessageChunk
+        async for chunk in await acompletion_with_retry(
+            self, messages=message_dicts, run_manager=run_manager, **params
+        ):
+            if not isinstance(chunk, dict):
+                chunk = chunk.dict()
+            if len(chunk["choices"]) == 0:
+                continue
+            choice = chunk["choices"][0]
+            chunk = _convert_delta_to_message_chunk(
+                choice["delta"], default_chunk_class
+            )
+            finish_reason = choice.get("finish_reason")
+            generation_info = (
+                dict(finish_reason=finish_reason) if finish_reason is not None else None
+            )
+            default_chunk_class = chunk.__class__
+            cg_chunk = ChatGenerationChunk(
+                message=chunk, generation_info=generation_info
+            )
+            if run_manager:
+                await run_manager.on_llm_new_token(token=cg_chunk.text, chunk=cg_chunk)
+            yield cg_chunk
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._astream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {
+            **params,
+            **({"stream": stream} if stream is not None else {}),
+            **kwargs,
+        }
+        response = await acompletion_with_retry(
+            self, messages=message_dicts, run_manager=run_manager, **params
+        )
+        return self._create_chat_result(response)
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model_name": self.model_name}, **self._default_params}
+
+    @property
+    def _client_params(self) -> Dict[str, Any]:
+        """Get the parameters used for the openai client."""
+        openai_creds: Dict[str, Any] = {
+            "model": self.model_name,
+        }
+        if not is_openai_v1():
+            openai_creds.update(
+                {
+                    "api_key": self.openai_api_key,
+                    "api_base": self.openai_api_base,
+                    "organization": self.openai_organization,
+                }
+            )
+        if self.openai_proxy:
+            import openai
+
+            openai.proxy = {"http": self.openai_proxy, "https": self.openai_proxy}
+        return {**self._default_params, **openai_creds}
+
+    def _get_invocation_params(
+        self, stop: Optional[List[str]] = None, **kwargs: Any
+    ) -> Dict[str, Any]:
+        """Get the parameters used to invoke the model."""
+        return {
+            "model": self.model_name,
+            **super()._get_invocation_params(stop=stop),
+            **self._default_params,
+            **kwargs,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "openai-chat"
+
+    def _get_encoding_model(self) -> Tuple[str, tiktoken.Encoding]:
+        tiktoken_ = _import_tiktoken()
+        if self.tiktoken_model_name is not None:
+            model = self.tiktoken_model_name
+        else:
+            model = self.model_name
+            if model == "gpt-3.5-turbo":
+                # gpt-3.5-turbo may change over time.
+                # Returning num tokens assuming gpt-3.5-turbo-0301.
+                model = "gpt-3.5-turbo-0301"
+            elif model == "gpt-4":
+                # gpt-4 may change over time.
+                # Returning num tokens assuming gpt-4-0314.
+                model = "gpt-4-0314"
+        # Returns the number of tokens used by a list of messages.
+        try:
+            encoding = tiktoken_.encoding_for_model(model)
+        except KeyError:
+            logger.warning("Warning: model not found. Using cl100k_base encoding.")
+            model = "cl100k_base"
+            encoding = tiktoken_.get_encoding(model)
+        return model, encoding
+
+    def get_token_ids(self, text: str) -> List[int]:
+        """Get the tokens present in the text with tiktoken package."""
+        # tiktoken NOT supported for Python 3.7 or below
+        if sys.version_info[1] <= 7:
+            return super().get_token_ids(text)
+        _, encoding_model = self._get_encoding_model()
+        return encoding_model.encode(text)
+
+    def get_num_tokens_from_messages(self, messages: List[BaseMessage]) -> int:
+        """Calculate num tokens for gpt-3.5-turbo and gpt-4 with tiktoken package.
+
+        Official documentation: https://github.com/openai/openai-cookbook/blob/
+        main/examples/How_to_format_inputs_to_ChatGPT_models.ipynb"""
+        if sys.version_info[1] <= 7:
+            return super().get_num_tokens_from_messages(messages)
+        model, encoding = self._get_encoding_model()
+        if model.startswith("gpt-3.5-turbo-0301"):
+            # every message follows <im_start>{role/name}\n{content}<im_end>\n
+            tokens_per_message = 4
+            # if there's a name, the role is omitted
+            tokens_per_name = -1
+        elif model.startswith("gpt-3.5-turbo") or model.startswith("gpt-4"):
+            tokens_per_message = 3
+            tokens_per_name = 1
+        else:
+            raise NotImplementedError(
+                f"get_num_tokens_from_messages() is not presently implemented "
+                f"for model {model}."
+                "See https://github.com/openai/openai-python/blob/main/chatml.md for "
+                "information on how messages are converted to tokens."
+            )
+        num_tokens = 0
+        messages_dict = [convert_message_to_dict(m) for m in messages]
+        for message in messages_dict:
+            num_tokens += tokens_per_message
+            for key, value in message.items():
+                # Cast str(value) in case the message value is not a string
+                # This occurs with function messages
+                num_tokens += len(encoding.encode(str(value)))
+                if key == "name":
+                    num_tokens += tokens_per_name
+        # every reply is primed with <im_start>assistant
+        num_tokens += 3
+        return num_tokens
+
+    def bind_functions(
+        self,
+        functions: Sequence[Union[Dict[str, Any], Type[BaseModel], Callable]],
+        function_call: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Runnable[LanguageModelInput, BaseMessage]:
+        """Bind functions (and other objects) to this chat model.
+
+        Args:
+            functions: A list of function definitions to bind to this chat model.
+                Can be  a dictionary, pydantic model, or callable. Pydantic
+                models and callables will be automatically converted to
+                their schema dictionary representation.
+            function_call: Which function to require the model to call.
+                Must be the name of the single provided function or
+                "auto" to automatically determine which function to call
+                (if any).
+            kwargs: Any additional parameters to pass to the
+                :class:`~langchain.runnable.Runnable` constructor.
+        """
+        from langchain.chains.openai_functions.base import convert_to_openai_function
+
+        formatted_functions = [convert_to_openai_function(fn) for fn in functions]
+        if function_call is not None:
+            if len(formatted_functions) != 1:
+                raise ValueError(
+                    "When specifying `function_call`, you must provide exactly one "
+                    "function."
+                )
+            if formatted_functions[0]["name"] != function_call:
+                raise ValueError(
+                    f"Function call {function_call} was specified, but the only "
+                    f"provided function was {formatted_functions[0]['name']}."
+                )
+            function_call_ = {"name": function_call}
+            kwargs = {**kwargs, "function_call": function_call_}
+        return super().bind(
+            functions=formatted_functions,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/pai_eas_endpoint.py b/llm/Lib/site-packages/langchain_community/chat_models/pai_eas_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..e438ad25ee0449968310527ea54320764b340573
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/pai_eas_endpoint.py
@@ -0,0 +1,303 @@
+import json
+import logging
+from typing import Any, AsyncIterator, Dict, List, Optional, cast
+
+import requests
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    ChatMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class PaiEasChatEndpoint(BaseChatModel):
+    """Alibaba Cloud PAI-EAS LLM Service chat model API.
+
+        To use, must have a deployed eas chat llm service on AliCloud. One can set the
+    environment variable ``eas_service_url`` and ``eas_service_token`` set with your eas
+    service url and service token.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import PaiEasChatEndpoint
+            eas_chat_endpoint = PaiEasChatEndpoint(
+                eas_service_url="your_service_url",
+                eas_service_token="your_service_token"
+            )
+    """
+
+    """PAI-EAS Service URL"""
+    eas_service_url: str
+
+    """PAI-EAS Service TOKEN"""
+    eas_service_token: str
+
+    """PAI-EAS Service Infer Params"""
+    max_new_tokens: Optional[int] = 512
+    temperature: Optional[float] = 0.8
+    top_p: Optional[float] = 0.1
+    top_k: Optional[int] = 10
+    do_sample: Optional[bool] = False
+    use_cache: Optional[bool] = True
+    stop_sequences: Optional[List[str]] = None
+
+    """Enable stream chat mode."""
+    streaming: bool = False
+
+    """Key/value arguments to pass to the model. Reserved for future use"""
+    model_kwargs: Optional[dict] = None
+
+    version: Optional[str] = "2.0"
+
+    timeout: Optional[int] = 5000
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["eas_service_url"] = get_from_dict_or_env(
+            values, "eas_service_url", "EAS_SERVICE_URL"
+        )
+        values["eas_service_token"] = get_from_dict_or_env(
+            values, "eas_service_token", "EAS_SERVICE_TOKEN"
+        )
+
+        return values
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            "eas_service_url": self.eas_service_url,
+            "eas_service_token": self.eas_service_token,
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "pai_eas_chat_endpoint"
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Cohere API."""
+        return {
+            "max_new_tokens": self.max_new_tokens,
+            "temperature": self.temperature,
+            "top_k": self.top_k,
+            "top_p": self.top_p,
+            "stop_sequences": [],
+            "do_sample": self.do_sample,
+            "use_cache": self.use_cache,
+        }
+
+    def _invocation_params(
+        self, stop_sequences: Optional[List[str]], **kwargs: Any
+    ) -> dict:
+        params = self._default_params
+        if self.model_kwargs:
+            params.update(self.model_kwargs)
+        if self.stop_sequences is not None and stop_sequences is not None:
+            raise ValueError("`stop` found in both the input and default params.")
+        elif self.stop_sequences is not None:
+            params["stop"] = self.stop_sequences
+        else:
+            params["stop"] = stop_sequences
+        return {**params, **kwargs}
+
+    def format_request_payload(
+        self, messages: List[BaseMessage], **model_kwargs: Any
+    ) -> dict:
+        prompt: Dict[str, Any] = {}
+        user_content: List[str] = []
+        assistant_content: List[str] = []
+
+        for message in messages:
+            """Converts message to a dict according to role"""
+            content = cast(str, message.content)
+            if isinstance(message, HumanMessage):
+                user_content = user_content + [content]
+            elif isinstance(message, AIMessage):
+                assistant_content = assistant_content + [content]
+            elif isinstance(message, SystemMessage):
+                prompt["system_prompt"] = content
+            elif isinstance(message, ChatMessage) and message.role in [
+                "user",
+                "assistant",
+                "system",
+            ]:
+                if message.role == "system":
+                    prompt["system_prompt"] = content
+                elif message.role == "user":
+                    user_content = user_content + [content]
+                elif message.role == "assistant":
+                    assistant_content = assistant_content + [content]
+            else:
+                supported = ",".join([role for role in ["user", "assistant", "system"]])
+                raise ValueError(
+                    f"""Received unsupported role. 
+                    Supported roles for the LLaMa Foundation Model: {supported}"""
+                )
+        prompt["prompt"] = user_content[len(user_content) - 1]
+        history = [
+            history_item
+            for _, history_item in enumerate(zip(user_content[:-1], assistant_content))
+        ]
+
+        prompt["history"] = history
+
+        return {**prompt, **model_kwargs}
+
+    def _format_response_payload(
+        self, output: bytes, stop_sequences: Optional[List[str]]
+    ) -> str:
+        """Formats response"""
+        try:
+            text = json.loads(output)["response"]
+            if stop_sequences:
+                text = enforce_stop_tokens(text, stop_sequences)
+            return text
+        except Exception as e:
+            if isinstance(e, json.decoder.JSONDecodeError):
+                return output.decode("utf-8")
+            raise e
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        output_str = self._call(messages, stop=stop, run_manager=run_manager, **kwargs)
+        message = AIMessage(content=output_str)
+        generation = ChatGeneration(message=message)
+        return ChatResult(generations=[generation])
+
+    def _call(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        params = self._invocation_params(stop, **kwargs)
+
+        request_payload = self.format_request_payload(messages, **params)
+        response_payload = self._call_eas(request_payload)
+        generated_text = self._format_response_payload(response_payload, params["stop"])
+
+        if run_manager:
+            run_manager.on_llm_new_token(generated_text)
+
+        return generated_text
+
+    def _call_eas(self, query_body: dict) -> Any:
+        """Generate text from the eas service."""
+        headers = {
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            "Authorization": f"{self.eas_service_token}",
+        }
+
+        # make request
+        response = requests.post(
+            self.eas_service_url, headers=headers, json=query_body, timeout=self.timeout
+        )
+
+        if response.status_code != 200:
+            raise Exception(
+                f"Request failed with status code {response.status_code}"
+                f" and message {response.text}"
+            )
+
+        return response.text
+
+    def _call_eas_stream(self, query_body: dict) -> Any:
+        """Generate text from the eas service."""
+        headers = {
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            "Authorization": f"{self.eas_service_token}",
+        }
+
+        # make request
+        response = requests.post(
+            self.eas_service_url, headers=headers, json=query_body, timeout=self.timeout
+        )
+
+        if response.status_code != 200:
+            raise Exception(
+                f"Request failed with status code {response.status_code}"
+                f" and message {response.text}"
+            )
+
+        return response
+
+    def _convert_chunk_to_message_message(
+        self,
+        chunk: str,
+    ) -> AIMessageChunk:
+        data = json.loads(chunk.encode("utf-8"))
+        return AIMessageChunk(content=data.get("response", ""))
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        params = self._invocation_params(stop, **kwargs)
+
+        request_payload = self.format_request_payload(messages, **params)
+        request_payload["use_stream_chat"] = True
+
+        response = self._call_eas_stream(request_payload)
+        for chunk in response.iter_lines(
+            chunk_size=8192, decode_unicode=False, delimiter=b"\0"
+        ):
+            if chunk:
+                content = self._convert_chunk_to_message_message(chunk)
+
+                # identify stop sequence in generated text, if any
+                stop_seq_found: Optional[str] = None
+                for stop_seq in params["stop"]:
+                    if stop_seq in content.content:
+                        stop_seq_found = stop_seq
+
+                # identify text to yield
+                text: Optional[str] = None
+                if stop_seq_found:
+                    content.content = content.content[
+                        : content.content.index(stop_seq_found)
+                    ]
+
+                # yield text, if any
+                if text:
+                    cg_chunk = ChatGenerationChunk(message=content)
+                    if run_manager:
+                        await run_manager.on_llm_new_token(
+                            cast(str, content.content), chunk=cg_chunk
+                        )
+                    yield cg_chunk
+
+                # break if stop sequence found
+                if stop_seq_found:
+                    break
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/perplexity.py b/llm/Lib/site-packages/langchain_community/chat_models/perplexity.py
new file mode 100644
index 0000000000000000000000000000000000000000..23d7c9e09a665af436c86cdf1422dde459354a5c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/perplexity.py
@@ -0,0 +1,271 @@
+"""Wrapper around Perplexity APIs."""
+from __future__ import annotations
+
+import logging
+from typing import (
+    Any,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    FunctionMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+    SystemMessageChunk,
+    ToolMessageChunk,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import get_from_dict_or_env, get_pydantic_field_names
+
+logger = logging.getLogger(__name__)
+
+
+class ChatPerplexity(BaseChatModel):
+    """`Perplexity AI` Chat models API.
+
+    To use, you should have the ``openai`` python package installed, and the
+    environment variable ``PPLX_API_KEY`` set to your API key.
+    Any parameters that are valid to be passed to the openai.create call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatPerplexity
+
+            chat = ChatPerplexity(model="pplx-70b-online", temperature=0.7)
+    """
+
+    client: Any  #: :meta private:
+    model: str = "pplx-70b-online"
+    """Model name."""
+    temperature: float = 0.7
+    """What sampling temperature to use."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not explicitly specified."""
+    pplx_api_key: Optional[str] = None
+    """Base URL path for API requests, 
+    leave blank if not using a proxy or service emulator."""
+    request_timeout: Optional[Union[float, Tuple[float, float]]] = None
+    """Timeout for requests to PerplexityChat completion API. Default is 600 seconds."""
+    max_retries: int = 6
+    """Maximum number of retries to make when generating."""
+    streaming: bool = False
+    """Whether to stream the results or not."""
+    max_tokens: Optional[int] = None
+    """Maximum number of tokens to generate."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"pplx_api_key": "PPLX_API_KEY"}
+
+    @root_validator(pre=True, allow_reuse=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name in extra:
+                raise ValueError(f"Found {field_name} supplied twice.")
+            if field_name not in all_required_field_names:
+                logger.warning(
+                    f"""WARNING! {field_name} is not a default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+
+        invalid_model_kwargs = all_required_field_names.intersection(extra.keys())
+        if invalid_model_kwargs:
+            raise ValueError(
+                f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+                f"Instead they were passed in as part of `model_kwargs` parameter."
+            )
+
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator(allow_reuse=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["pplx_api_key"] = get_from_dict_or_env(
+            values, "pplx_api_key", "PPLX_API_KEY"
+        )
+        try:
+            import openai  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+        try:
+            values["client"] = openai.OpenAI(
+                api_key=values["pplx_api_key"], base_url="https://api.perplexity.ai"
+            )
+        except AttributeError:
+            raise ValueError(
+                "`openai` has no `ChatCompletion` attribute, this is likely "
+                "due to an old version of the openai package. Try upgrading it "
+                "with `pip install --upgrade openai`."
+            )
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling PerplexityChat API."""
+        return {
+            "request_timeout": self.request_timeout,
+            "max_tokens": self.max_tokens,
+            "stream": self.streaming,
+            "temperature": self.temperature,
+            **self.model_kwargs,
+        }
+
+    def _convert_message_to_dict(self, message: BaseMessage) -> Dict[str, Any]:
+        if isinstance(message, ChatMessage):
+            message_dict = {"role": message.role, "content": message.content}
+        elif isinstance(message, SystemMessage):
+            message_dict = {"role": "system", "content": message.content}
+        elif isinstance(message, HumanMessage):
+            message_dict = {"role": "user", "content": message.content}
+        elif isinstance(message, AIMessage):
+            message_dict = {"role": "assistant", "content": message.content}
+        else:
+            raise TypeError(f"Got unknown type {message}")
+        return message_dict
+
+    def _create_message_dicts(
+        self, messages: List[BaseMessage], stop: Optional[List[str]]
+    ) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+        params = dict(self._invocation_params)
+        if stop is not None:
+            if "stop" in params:
+                raise ValueError("`stop` found in both the input and default params.")
+            params["stop"] = stop
+        message_dicts = [self._convert_message_to_dict(m) for m in messages]
+        return message_dicts, params
+
+    def _convert_delta_to_message_chunk(
+        self, _dict: Mapping[str, Any], default_class: Type[BaseMessageChunk]
+    ) -> BaseMessageChunk:
+        role = _dict.get("role")
+        content = _dict.get("content") or ""
+        additional_kwargs: Dict = {}
+        if _dict.get("function_call"):
+            function_call = dict(_dict["function_call"])
+            if "name" in function_call and function_call["name"] is None:
+                function_call["name"] = ""
+            additional_kwargs["function_call"] = function_call
+        if _dict.get("tool_calls"):
+            additional_kwargs["tool_calls"] = _dict["tool_calls"]
+
+        if role == "user" or default_class == HumanMessageChunk:
+            return HumanMessageChunk(content=content)
+        elif role == "assistant" or default_class == AIMessageChunk:
+            return AIMessageChunk(content=content, additional_kwargs=additional_kwargs)
+        elif role == "system" or default_class == SystemMessageChunk:
+            return SystemMessageChunk(content=content)
+        elif role == "function" or default_class == FunctionMessageChunk:
+            return FunctionMessageChunk(content=content, name=_dict["name"])
+        elif role == "tool" or default_class == ToolMessageChunk:
+            return ToolMessageChunk(content=content, tool_call_id=_dict["tool_call_id"])
+        elif role or default_class == ChatMessageChunk:
+            return ChatMessageChunk(content=content, role=role)
+        else:
+            return default_class(content=content)
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs}
+        default_chunk_class = AIMessageChunk
+
+        if stop:
+            params["stop_sequences"] = stop
+        stream_resp = self.client.chat.completions.create(
+            model=params["model"], messages=message_dicts, stream=True
+        )
+        for chunk in stream_resp:
+            if not isinstance(chunk, dict):
+                chunk = chunk.dict()
+            if len(chunk["choices"]) == 0:
+                continue
+            choice = chunk["choices"][0]
+            chunk = self._convert_delta_to_message_chunk(
+                choice["delta"], default_chunk_class
+            )
+            finish_reason = choice.get("finish_reason")
+            generation_info = (
+                dict(finish_reason=finish_reason) if finish_reason is not None else None
+            )
+            default_chunk_class = chunk.__class__
+            chunk = ChatGenerationChunk(message=chunk, generation_info=generation_info)
+            if run_manager:
+                run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+            yield chunk
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            if stream_iter:
+                return generate_from_stream(stream_iter)
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs}
+        response = self.client.chat.completions.create(
+            model=params["model"], messages=message_dicts
+        )
+        message = AIMessage(content=response.choices[0].message.content)
+        return ChatResult(generations=[ChatGeneration(message=message)])
+
+    @property
+    def _invocation_params(self) -> Mapping[str, Any]:
+        """Get the parameters used to invoke the model."""
+        pplx_creds: Dict[str, Any] = {
+            "api_key": self.pplx_api_key,
+            "api_base": "https://api.perplexity.ai",
+            "model": self.model,
+        }
+        return {**pplx_creds, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "perplexitychat"
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/premai.py b/llm/Lib/site-packages/langchain_community/chat_models/premai.py
new file mode 100644
index 0000000000000000000000000000000000000000..b509b8bf7db92a152d6f47e4fcfcb18474385791
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/premai.py
@@ -0,0 +1,417 @@
+"""Wrapper around Prem's Chat API."""
+
+from __future__ import annotations
+
+import logging
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+from langchain_core.callbacks import (
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.language_models.llms import create_base_retry_decorator
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+    SystemMessageChunk,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import BaseModel, Extra, SecretStr, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+if TYPE_CHECKING:
+    from premai.api.chat_completions.v1_chat_completions_create import (
+        ChatCompletionResponseStream,
+    )
+    from premai.models.chat_completion_response import ChatCompletionResponse
+
+logger = logging.getLogger(__name__)
+
+
+class ChatPremAPIError(Exception):
+    """Error with the `PremAI` API."""
+
+
+def _truncate_at_stop_tokens(
+    text: str,
+    stop: Optional[List[str]],
+) -> str:
+    """Truncates text at the earliest stop token found."""
+    if stop is None:
+        return text
+
+    for stop_token in stop:
+        stop_token_idx = text.find(stop_token)
+        if stop_token_idx != -1:
+            text = text[:stop_token_idx]
+    return text
+
+
+def _response_to_result(
+    response: ChatCompletionResponse,
+    stop: Optional[List[str]],
+) -> ChatResult:
+    """Converts a Prem API response into a LangChain result"""
+
+    if not response.choices:
+        raise ChatPremAPIError("ChatResponse must have at least one candidate")
+    generations: List[ChatGeneration] = []
+    for choice in response.choices:
+        role = choice.message.role
+        if role is None:
+            raise ChatPremAPIError(f"ChatResponse {choice} must have a role.")
+
+        # If content is None then it will be replaced by ""
+        content = _truncate_at_stop_tokens(text=choice.message.content or "", stop=stop)
+        if content is None:
+            raise ChatPremAPIError(f"ChatResponse must have a content: {content}")
+
+        if role == "assistant":
+            generations.append(
+                ChatGeneration(text=content, message=AIMessage(content=content))
+            )
+        elif role == "user":
+            generations.append(
+                ChatGeneration(text=content, message=HumanMessage(content=content))
+            )
+        else:
+            generations.append(
+                ChatGeneration(
+                    text=content, message=ChatMessage(role=role, content=content)
+                )
+            )
+    return ChatResult(generations=generations)
+
+
+def _convert_delta_response_to_message_chunk(
+    response: ChatCompletionResponseStream, default_class: Type[BaseMessageChunk]
+) -> Tuple[
+    Union[BaseMessageChunk, HumanMessageChunk, AIMessageChunk, SystemMessageChunk],
+    Optional[str],
+]:
+    """Converts delta response to message chunk"""
+    _delta = response.choices[0].delta  # type: ignore
+    role = _delta.get("role", "")  # type: ignore
+    content = _delta.get("content", "")  # type: ignore
+    additional_kwargs: Dict = {}
+
+    if role is None or role == "":
+        raise ChatPremAPIError("Role can not be None. Please check the response")
+
+    finish_reasons: Optional[str] = response.choices[0].finish_reason
+
+    if role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=content), finish_reasons
+    elif role == "assistant" or default_class == AIMessageChunk:
+        return (
+            AIMessageChunk(content=content, additional_kwargs=additional_kwargs),
+            finish_reasons,
+        )
+    elif role == "system" or default_class == SystemMessageChunk:
+        return SystemMessageChunk(content=content), finish_reasons
+    elif role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=content, role=role), finish_reasons
+    else:
+        return default_class(content=content), finish_reasons
+
+
+def _messages_to_prompt_dict(
+    input_messages: List[BaseMessage],
+) -> Tuple[Optional[str], List[Dict[str, str]]]:
+    """Converts a list of LangChain Messages into a simple dict
+    which is the message structure in Prem"""
+
+    system_prompt: Optional[str] = None
+    examples_and_messages: List[Dict[str, str]] = []
+
+    for input_msg in input_messages:
+        if isinstance(input_msg, SystemMessage):
+            system_prompt = str(input_msg.content)
+        elif isinstance(input_msg, HumanMessage):
+            examples_and_messages.append(
+                {"role": "user", "content": str(input_msg.content)}
+            )
+        elif isinstance(input_msg, AIMessage):
+            examples_and_messages.append(
+                {"role": "assistant", "content": str(input_msg.content)}
+            )
+        else:
+            raise ChatPremAPIError("No such role explicitly exists")
+    return system_prompt, examples_and_messages
+
+
+class ChatPremAI(BaseChatModel, BaseModel):
+    """PremAI Chat models.
+
+    To use, you will need to have an API key. You can find your existing API Key
+    or generate a new one here: https://app.premai.io/api_keys/
+    """
+
+    # TODO: Need to add the default parameters through prem-sdk here
+
+    project_id: int
+    """The project ID in which the experiments or deployments are carried out. 
+    You can find all your projects here: https://app.premai.io/projects/"""
+    premai_api_key: Optional[SecretStr] = None
+    """Prem AI API Key. Get it here: https://app.premai.io/api_keys/"""
+
+    model: Optional[str] = None
+    """Name of the model. This is an optional parameter. 
+    The default model is the one deployed from Prem's LaunchPad: https://app.premai.io/projects/8/launchpad
+    If model name is other than default model then it will override the calls 
+    from the model deployed from launchpad."""
+
+    session_id: Optional[str] = None
+    """The ID of the session to use. It helps to track the chat history."""
+
+    temperature: Optional[float] = None
+    """Model temperature. Value should be >= 0 and <= 1.0"""
+
+    top_p: Optional[float] = None
+    """top_p adjusts the number of choices for each predicted tokens based on
+        cumulative probabilities. Value should be ranging between 0.0 and 1.0. 
+    """
+
+    max_tokens: Optional[int] = None
+    """The maximum number of tokens to generate"""
+
+    max_retries: int = 1
+    """Max number of retries to call the API"""
+
+    system_prompt: Optional[str] = ""
+    """Acts like a default instruction that helps the LLM act or generate 
+    in a specific way.This is an Optional Parameter. By default the 
+    system prompt would be using Prem's Launchpad models system prompt. 
+    Changing the system prompt would override the default system prompt.
+    """
+
+    streaming: Optional[bool] = False
+    """Whether to stream the responses or not."""
+
+    tools: Optional[Dict[str, Any]] = None
+    """A list of tools the model may call. Currently, only functions are 
+    supported as a tool"""
+
+    frequency_penalty: Optional[float] = None
+    """Number between -2.0 and 2.0. Positive values penalize new tokens based"""
+
+    presence_penalty: Optional[float] = None
+    """Number between -2.0 and 2.0. Positive values penalize new tokens based 
+    on whether they appear in the text so far."""
+
+    logit_bias: Optional[dict] = None
+    """JSON object that maps tokens to an associated bias value from -100 to 100."""
+
+    stop: Optional[Union[str, List[str]]] = None
+    """Up to 4 sequences where the API will stop generating further tokens."""
+
+    seed: Optional[int] = None
+    """This feature is in Beta. If specified, our system will make a best effort 
+    to sample deterministically."""
+
+    client: Any
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environments(cls, values: Dict) -> Dict:
+        """Validate that the package is installed and that the API token is valid"""
+        try:
+            from premai import Prem
+        except ImportError as error:
+            raise ImportError(
+                "Could not import Prem Python package."
+                "Please install it with: `pip install premai`"
+            ) from error
+
+        try:
+            premai_api_key = get_from_dict_or_env(
+                values, "premai_api_key", "PREMAI_API_KEY"
+            )
+            values["client"] = Prem(api_key=premai_api_key)
+        except Exception as error:
+            raise ValueError("Your API Key is incorrect. Please try again.") from error
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        return "premai"
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        # FIXME: n and stop is not supported, so hardcoding to current default value
+        return {
+            "model": self.model,
+            "system_prompt": self.system_prompt,
+            "top_p": self.top_p,
+            "temperature": self.temperature,
+            "logit_bias": self.logit_bias,
+            "max_tokens": self.max_tokens,
+            "presence_penalty": self.presence_penalty,
+            "frequency_penalty": self.frequency_penalty,
+            "seed": self.seed,
+            "stop": None,
+        }
+
+    def _get_all_kwargs(self, **kwargs: Any) -> Dict[str, Any]:
+        all_kwargs = {**self._default_params, **kwargs}
+        for key in list(self._default_params.keys()):
+            if all_kwargs.get(key) is None or all_kwargs.get(key) == "":
+                all_kwargs.pop(key, None)
+        return all_kwargs
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        system_prompt, messages_to_pass = _messages_to_prompt_dict(messages)  # type: ignore
+
+        kwargs["stop"] = stop
+        if system_prompt is not None and system_prompt != "":
+            kwargs["system_prompt"] = system_prompt
+
+        all_kwargs = self._get_all_kwargs(**kwargs)
+        response = chat_with_retry(
+            self,
+            project_id=self.project_id,
+            messages=messages_to_pass,
+            stream=False,
+            run_manager=run_manager,
+            **all_kwargs,
+        )
+
+        return _response_to_result(response=response, stop=stop)
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        system_prompt, messages_to_pass = _messages_to_prompt_dict(messages)
+        kwargs["stop"] = stop
+
+        if "system_prompt" not in kwargs:
+            if system_prompt is not None and system_prompt != "":
+                kwargs["system_prompt"] = system_prompt
+
+        all_kwargs = self._get_all_kwargs(**kwargs)
+
+        default_chunk_class = AIMessageChunk
+
+        for streamed_response in chat_with_retry(
+            self,
+            project_id=self.project_id,
+            messages=messages_to_pass,
+            stream=True,
+            run_manager=run_manager,
+            **all_kwargs,
+        ):
+            try:
+                chunk, finish_reason = _convert_delta_response_to_message_chunk(
+                    response=streamed_response, default_class=default_chunk_class
+                )
+                generation_info = (
+                    dict(finish_reason=finish_reason)
+                    if finish_reason is not None
+                    else None
+                )
+                cg_chunk = ChatGenerationChunk(
+                    message=chunk, generation_info=generation_info
+                )
+                if run_manager:
+                    run_manager.on_llm_new_token(cg_chunk.text, chunk=cg_chunk)
+                yield cg_chunk
+            except Exception as _:
+                continue
+
+
+def create_prem_retry_decorator(
+    llm: ChatPremAI,
+    *,
+    max_retries: int = 1,
+    run_manager: Optional[Union[CallbackManagerForLLMRun]] = None,
+) -> Callable[[Any], Any]:
+    """Create a retry decorator for PremAI API errors."""
+    import premai.models
+
+    errors = [
+        premai.models.api_response_validation_error.APIResponseValidationError,
+        premai.models.conflict_error.ConflictError,
+        premai.models.model_not_found_error.ModelNotFoundError,
+        premai.models.permission_denied_error.PermissionDeniedError,
+        premai.models.provider_api_connection_error.ProviderAPIConnectionError,
+        premai.models.provider_api_status_error.ProviderAPIStatusError,
+        premai.models.provider_api_timeout_error.ProviderAPITimeoutError,
+        premai.models.provider_internal_server_error.ProviderInternalServerError,
+        premai.models.provider_not_found_error.ProviderNotFoundError,
+        premai.models.rate_limit_error.RateLimitError,
+        premai.models.unprocessable_entity_error.UnprocessableEntityError,
+        premai.models.validation_error.ValidationError,
+    ]
+
+    decorator = create_base_retry_decorator(
+        error_types=errors, max_retries=max_retries, run_manager=run_manager
+    )
+    return decorator
+
+
+def chat_with_retry(
+    llm: ChatPremAI,
+    project_id: int,
+    messages: List[dict],
+    stream: bool = False,
+    run_manager: Optional[CallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Using tenacity for retry in completion call"""
+    retry_decorator = create_prem_retry_decorator(
+        llm, max_retries=llm.max_retries, run_manager=run_manager
+    )
+
+    @retry_decorator
+    def _completion_with_retry(
+        project_id: int,
+        messages: List[dict],
+        stream: Optional[bool] = False,
+        **kwargs: Any,
+    ) -> Any:
+        response = llm.client.chat.completions.create(
+            project_id=project_id,
+            messages=messages,
+            stream=stream,
+            **kwargs,
+        )
+        return response
+
+    return _completion_with_retry(
+        project_id=project_id,
+        messages=messages,
+        stream=stream,
+        **kwargs,
+    )
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/promptlayer_openai.py b/llm/Lib/site-packages/langchain_community/chat_models/promptlayer_openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..aa930a474a464b1521cf408fcaecd2d9d0d571f3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/promptlayer_openai.py
@@ -0,0 +1,140 @@
+"""PromptLayer wrapper."""
+import datetime
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.messages import BaseMessage
+from langchain_core.outputs import ChatResult
+
+from langchain_community.chat_models import ChatOpenAI
+
+
+class PromptLayerChatOpenAI(ChatOpenAI):
+    """`PromptLayer` and `OpenAI` Chat large language models API.
+
+    To use, you should have the ``openai`` and ``promptlayer`` python
+    package installed, and the environment variable ``OPENAI_API_KEY``
+    and ``PROMPTLAYER_API_KEY`` set with your openAI API key and
+    promptlayer key respectively.
+
+    All parameters that can be passed to the OpenAI LLM can also
+    be passed here. The PromptLayerChatOpenAI adds to optional
+
+    parameters:
+        ``pl_tags``: List of strings to tag the request with.
+        ``return_pl_id``: If True, the PromptLayer request ID will be
+            returned in the ``generation_info`` field of the
+            ``Generation`` object.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import PromptLayerChatOpenAI
+            openai = PromptLayerChatOpenAI(model="gpt-3.5-turbo")
+    """
+
+    pl_tags: Optional[List[str]]
+    return_pl_id: Optional[bool] = False
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Call ChatOpenAI generate and then call PromptLayer API to log the request."""
+        from promptlayer.utils import get_api_key, promptlayer_api_request
+
+        request_start_time = datetime.datetime.now().timestamp()
+        generated_responses = super()._generate(
+            messages, stop, run_manager, stream=stream, **kwargs
+        )
+        request_end_time = datetime.datetime.now().timestamp()
+        message_dicts, params = super()._create_message_dicts(messages, stop)
+        for i, generation in enumerate(generated_responses.generations):
+            response_dict, params = super()._create_message_dicts(
+                [generation.message], stop
+            )
+            params = {**params, **kwargs}
+            pl_request_id = promptlayer_api_request(
+                "langchain.PromptLayerChatOpenAI",
+                "langchain",
+                message_dicts,
+                params,
+                self.pl_tags,
+                response_dict,
+                request_start_time,
+                request_end_time,
+                get_api_key(),
+                return_pl_id=self.return_pl_id,
+            )
+            if self.return_pl_id:
+                if generation.generation_info is None or not isinstance(
+                    generation.generation_info, dict
+                ):
+                    generation.generation_info = {}
+                generation.generation_info["pl_request_id"] = pl_request_id
+        return generated_responses
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Call ChatOpenAI agenerate and then call PromptLayer to log."""
+        from promptlayer.utils import get_api_key, promptlayer_api_request_async
+
+        request_start_time = datetime.datetime.now().timestamp()
+        generated_responses = await super()._agenerate(
+            messages, stop, run_manager, stream=stream, **kwargs
+        )
+        request_end_time = datetime.datetime.now().timestamp()
+        message_dicts, params = super()._create_message_dicts(messages, stop)
+        for i, generation in enumerate(generated_responses.generations):
+            response_dict, params = super()._create_message_dicts(
+                [generation.message], stop
+            )
+            params = {**params, **kwargs}
+            pl_request_id = await promptlayer_api_request_async(
+                "langchain.PromptLayerChatOpenAI.async",
+                "langchain",
+                message_dicts,
+                params,
+                self.pl_tags,
+                response_dict,
+                request_start_time,
+                request_end_time,
+                get_api_key(),
+                return_pl_id=self.return_pl_id,
+            )
+            if self.return_pl_id:
+                if generation.generation_info is None or not isinstance(
+                    generation.generation_info, dict
+                ):
+                    generation.generation_info = {}
+                generation.generation_info["pl_request_id"] = pl_request_id
+        return generated_responses
+
+    @property
+    def _llm_type(self) -> str:
+        return "promptlayer-openai-chat"
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        return {
+            **super()._identifying_params,
+            "pl_tags": self.pl_tags,
+            "return_pl_id": self.return_pl_id,
+        }
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/solar.py b/llm/Lib/site-packages/langchain_community/chat_models/solar.py
new file mode 100644
index 0000000000000000000000000000000000000000..e0299a7588cbecb48d873ba108d9d073414b9354
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/solar.py
@@ -0,0 +1,70 @@
+"""Wrapper around Solar chat models."""
+
+from typing import Dict
+
+from langchain_core._api import deprecated
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.chat_models import ChatOpenAI
+from langchain_community.llms.solar import SOLAR_SERVICE_URL_BASE, SolarCommon
+
+
+@deprecated(
+    since="0.0.34", removal="0.2.0", alternative_import="langchain_upstage.ChatUpstage"
+)
+class SolarChat(SolarCommon, ChatOpenAI):
+    """Wrapper around Solar large language models.
+    To use, you should have the ``openai`` python package installed, and the
+    environment variable ``SOLAR_API_KEY`` set with your API key.
+    (Solar's chat API is compatible with OpenAI's SDK.)
+    Referenced from https://console.upstage.ai/services/solar
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models.solar import SolarChat
+
+            solar = SolarChat(model="solar-1-mini-chat")
+    """
+
+    max_tokens: int = Field(default=1024)
+
+    # this is needed to match ChatOpenAI superclass
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+        arbitrary_types_allowed = True
+        extra = "ignore"
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the environment is set up correctly."""
+        values["solar_api_key"] = get_from_dict_or_env(
+            values, "solar_api_key", "SOLAR_API_KEY"
+        )
+
+        try:
+            import openai
+
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+
+        client_params = {
+            "api_key": values["solar_api_key"],
+            "base_url": (
+                values["base_url"] if "base_url" in values else SOLAR_SERVICE_URL_BASE
+            ),
+        }
+
+        if not values.get("client"):
+            values["client"] = openai.OpenAI(**client_params).chat.completions
+        if not values.get("async_client"):
+            values["async_client"] = openai.AsyncOpenAI(
+                **client_params
+            ).chat.completions
+
+        return values
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/sparkllm.py b/llm/Lib/site-packages/langchain_community/chat_models/sparkllm.py
new file mode 100644
index 0000000000000000000000000000000000000000..f173519746aed5333b5eb609ca8e83d78450766b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/sparkllm.py
@@ -0,0 +1,492 @@
+import base64
+import hashlib
+import hmac
+import json
+import logging
+import queue
+import threading
+from datetime import datetime
+from queue import Queue
+from time import mktime
+from typing import Any, Dict, Generator, Iterator, List, Mapping, Optional, Type
+from urllib.parse import urlencode, urlparse, urlunparse
+from wsgiref.handlers import format_date_time
+
+from langchain_core.callbacks import (
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+)
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatGenerationChunk,
+    ChatResult,
+)
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import (
+    get_from_dict_or_env,
+    get_pydantic_field_names,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def _convert_message_to_dict(message: BaseMessage) -> dict:
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+    elif isinstance(message, SystemMessage):
+        message_dict = {"role": "system", "content": message.content}
+    else:
+        raise ValueError(f"Got unknown type {message}")
+
+    return message_dict
+
+
+def _convert_dict_to_message(_dict: Mapping[str, Any]) -> BaseMessage:
+    msg_role = _dict["role"]
+    msg_content = _dict["content"]
+    if msg_role == "user":
+        return HumanMessage(content=msg_content)
+    elif msg_role == "assistant":
+        content = msg_content or ""
+        return AIMessage(content=content)
+    elif msg_role == "system":
+        return SystemMessage(content=msg_content)
+    else:
+        return ChatMessage(content=msg_content, role=msg_role)
+
+
+def _convert_delta_to_message_chunk(
+    _dict: Mapping[str, Any], default_class: Type[BaseMessageChunk]
+) -> BaseMessageChunk:
+    msg_role = _dict["role"]
+    msg_content = _dict.get("content", "")
+    if msg_role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=msg_content)
+    elif msg_role == "assistant" or default_class == AIMessageChunk:
+        return AIMessageChunk(content=msg_content)
+    elif msg_role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=msg_content, role=msg_role)
+    else:
+        return default_class(content=msg_content)
+
+
+class ChatSparkLLM(BaseChatModel):
+    """iFlyTek Spark large language model.
+
+    To use, you should pass `app_id`, `api_key`, `api_secret`
+    as a named parameter to the constructor OR set environment
+    variables ``IFLYTEK_SPARK_APP_ID``, ``IFLYTEK_SPARK_API_KEY`` and
+    ``IFLYTEK_SPARK_API_SECRET``
+
+    Example:
+        .. code-block:: python
+
+        client = ChatSparkLLM(
+            spark_app_id="<app_id>",
+            spark_api_key="<api_key>",
+            spark_api_secret="<api_secret>"
+        )
+
+    Extra infos:
+        1. Get app_id, api_key, api_secret from the iFlyTek Open Platform Console:
+            https://console.xfyun.cn/services/bm35
+        2. By default, iFlyTek Spark LLM V3.0 is invoked.
+            If you need to invoke other versions, please configure the corresponding
+            parameters(spark_api_url and spark_llm_domain) according to the document:
+            https://www.xfyun.cn/doc/spark/Web.html
+        3. It is necessary to ensure that the app_id used has a license for
+            the corresponding model version.
+        4. If you encounter problems during use, try getting help at:
+            https://console.xfyun.cn/workorder/commit
+    """
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this model can be serialized by Langchain."""
+        return False
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {
+            "spark_app_id": "IFLYTEK_SPARK_APP_ID",
+            "spark_api_key": "IFLYTEK_SPARK_API_KEY",
+            "spark_api_secret": "IFLYTEK_SPARK_API_SECRET",
+            "spark_api_url": "IFLYTEK_SPARK_API_URL",
+            "spark_llm_domain": "IFLYTEK_SPARK_LLM_DOMAIN",
+        }
+
+    client: Any = None  #: :meta private:
+    spark_app_id: Optional[str] = None
+    spark_api_key: Optional[str] = None
+    spark_api_secret: Optional[str] = None
+    spark_api_url: Optional[str] = None
+    spark_llm_domain: Optional[str] = None
+    spark_user_id: str = "lc_user"
+    streaming: bool = False
+    request_timeout: int = Field(30, alias="timeout")
+    temperature: float = 0.5
+    top_k: int = 4
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name in extra:
+                raise ValueError(f"Found {field_name} supplied twice.")
+            if field_name not in all_required_field_names:
+                logger.warning(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+
+        invalid_model_kwargs = all_required_field_names.intersection(extra.keys())
+        if invalid_model_kwargs:
+            raise ValueError(
+                f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+                f"Instead they were passed in as part of `model_kwargs` parameter."
+            )
+
+        values["model_kwargs"] = extra
+
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        values["spark_app_id"] = get_from_dict_or_env(
+            values,
+            "spark_app_id",
+            "IFLYTEK_SPARK_APP_ID",
+        )
+        values["spark_api_key"] = get_from_dict_or_env(
+            values,
+            "spark_api_key",
+            "IFLYTEK_SPARK_API_KEY",
+        )
+        values["spark_api_secret"] = get_from_dict_or_env(
+            values,
+            "spark_api_secret",
+            "IFLYTEK_SPARK_API_SECRET",
+        )
+        values["spark_api_url"] = get_from_dict_or_env(
+            values,
+            "spark_api_url",
+            "IFLYTEK_SPARK_API_URL",
+            "wss://spark-api.xf-yun.com/v3.1/chat",
+        )
+        values["spark_llm_domain"] = get_from_dict_or_env(
+            values,
+            "spark_llm_domain",
+            "IFLYTEK_SPARK_LLM_DOMAIN",
+            "generalv3",
+        )
+        # put extra params into model_kwargs
+        values["model_kwargs"]["temperature"] = values["temperature"] or cls.temperature
+        values["model_kwargs"]["top_k"] = values["top_k"] or cls.top_k
+
+        values["client"] = _SparkLLMClient(
+            app_id=values["spark_app_id"],
+            api_key=values["spark_api_key"],
+            api_secret=values["spark_api_secret"],
+            api_url=values["spark_api_url"],
+            spark_domain=values["spark_llm_domain"],
+            model_kwargs=values["model_kwargs"],
+        )
+        return values
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        default_chunk_class = AIMessageChunk
+
+        self.client.arun(
+            [_convert_message_to_dict(m) for m in messages],
+            self.spark_user_id,
+            self.model_kwargs,
+            self.streaming,
+        )
+        for content in self.client.subscribe(timeout=self.request_timeout):
+            if "data" not in content:
+                continue
+            delta = content["data"]
+            chunk = _convert_delta_to_message_chunk(delta, default_chunk_class)
+            cg_chunk = ChatGenerationChunk(message=chunk)
+            if run_manager:
+                run_manager.on_llm_new_token(str(chunk.content), chunk=cg_chunk)
+            yield cg_chunk
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._stream(
+                messages=messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        self.client.arun(
+            [_convert_message_to_dict(m) for m in messages],
+            self.spark_user_id,
+            self.model_kwargs,
+            False,
+        )
+        completion = {}
+        llm_output = {}
+        for content in self.client.subscribe(timeout=self.request_timeout):
+            if "usage" in content:
+                llm_output["token_usage"] = content["usage"]
+            if "data" not in content:
+                continue
+            completion = content["data"]
+        message = _convert_dict_to_message(completion)
+        generations = [ChatGeneration(message=message)]
+        return ChatResult(generations=generations, llm_output=llm_output)
+
+    @property
+    def _llm_type(self) -> str:
+        return "spark-llm-chat"
+
+
+class _SparkLLMClient:
+    """
+    Use websocket-client to call the SparkLLM interface provided by Xfyun,
+    which is the iFlyTek's open platform for AI capabilities
+    """
+
+    def __init__(
+        self,
+        app_id: str,
+        api_key: str,
+        api_secret: str,
+        api_url: Optional[str] = None,
+        spark_domain: Optional[str] = None,
+        model_kwargs: Optional[dict] = None,
+    ):
+        try:
+            import websocket
+
+            self.websocket_client = websocket
+        except ImportError:
+            raise ImportError(
+                "Could not import websocket client python package. "
+                "Please install it with `pip install websocket-client`."
+            )
+
+        self.api_url = (
+            "wss://spark-api.xf-yun.com/v3.1/chat" if not api_url else api_url
+        )
+        self.app_id = app_id
+        self.model_kwargs = model_kwargs
+        self.spark_domain = spark_domain or "generalv3"
+        self.queue: Queue[Dict] = Queue()
+        self.blocking_message = {"content": "", "role": "assistant"}
+        self.api_key = api_key
+        self.api_secret = api_secret
+
+    @staticmethod
+    def _create_url(api_url: str, api_key: str, api_secret: str) -> str:
+        """
+        Generate a request url with an api key and an api secret.
+        """
+        # generate timestamp by RFC1123
+        date = format_date_time(mktime(datetime.now().timetuple()))
+
+        # urlparse
+        parsed_url = urlparse(api_url)
+        host = parsed_url.netloc
+        path = parsed_url.path
+
+        signature_origin = f"host: {host}\ndate: {date}\nGET {path} HTTP/1.1"
+
+        # encrypt using hmac-sha256
+        signature_sha = hmac.new(
+            api_secret.encode("utf-8"),
+            signature_origin.encode("utf-8"),
+            digestmod=hashlib.sha256,
+        ).digest()
+
+        signature_sha_base64 = base64.b64encode(signature_sha).decode(encoding="utf-8")
+
+        authorization_origin = f'api_key="{api_key}", algorithm="hmac-sha256", \
+        headers="host date request-line", signature="{signature_sha_base64}"'
+        authorization = base64.b64encode(authorization_origin.encode("utf-8")).decode(
+            encoding="utf-8"
+        )
+
+        # generate url
+        params_dict = {"authorization": authorization, "date": date, "host": host}
+        encoded_params = urlencode(params_dict)
+        url = urlunparse(
+            (
+                parsed_url.scheme,
+                parsed_url.netloc,
+                parsed_url.path,
+                parsed_url.params,
+                encoded_params,
+                parsed_url.fragment,
+            )
+        )
+        return url
+
+    def run(
+        self,
+        messages: List[Dict],
+        user_id: str,
+        model_kwargs: Optional[dict] = None,
+        streaming: bool = False,
+    ) -> None:
+        self.websocket_client.enableTrace(False)
+        ws = self.websocket_client.WebSocketApp(
+            _SparkLLMClient._create_url(
+                self.api_url,
+                self.api_key,
+                self.api_secret,
+            ),
+            on_message=self.on_message,
+            on_error=self.on_error,
+            on_close=self.on_close,
+            on_open=self.on_open,
+        )
+        ws.messages = messages
+        ws.user_id = user_id
+        ws.model_kwargs = self.model_kwargs if model_kwargs is None else model_kwargs
+        ws.streaming = streaming
+        ws.run_forever()
+
+    def arun(
+        self,
+        messages: List[Dict],
+        user_id: str,
+        model_kwargs: Optional[dict] = None,
+        streaming: bool = False,
+    ) -> threading.Thread:
+        ws_thread = threading.Thread(
+            target=self.run,
+            args=(
+                messages,
+                user_id,
+                model_kwargs,
+                streaming,
+            ),
+        )
+        ws_thread.start()
+        return ws_thread
+
+    def on_error(self, ws: Any, error: Optional[Any]) -> None:
+        self.queue.put({"error": error})
+        ws.close()
+
+    def on_close(self, ws: Any, close_status_code: int, close_reason: str) -> None:
+        logger.debug(
+            {
+                "log": {
+                    "close_status_code": close_status_code,
+                    "close_reason": close_reason,
+                }
+            }
+        )
+        self.queue.put({"done": True})
+
+    def on_open(self, ws: Any) -> None:
+        self.blocking_message = {"content": "", "role": "assistant"}
+        data = json.dumps(
+            self.gen_params(
+                messages=ws.messages, user_id=ws.user_id, model_kwargs=ws.model_kwargs
+            )
+        )
+        ws.send(data)
+
+    def on_message(self, ws: Any, message: str) -> None:
+        data = json.loads(message)
+        code = data["header"]["code"]
+        if code != 0:
+            self.queue.put(
+                {"error": f"Code: {code}, Error: {data['header']['message']}"}
+            )
+            ws.close()
+        else:
+            choices = data["payload"]["choices"]
+            status = choices["status"]
+            content = choices["text"][0]["content"]
+            if ws.streaming:
+                self.queue.put({"data": choices["text"][0]})
+            else:
+                self.blocking_message["content"] += content
+            if status == 2:
+                if not ws.streaming:
+                    self.queue.put({"data": self.blocking_message})
+                usage_data = (
+                    data.get("payload", {}).get("usage", {}).get("text", {})
+                    if data
+                    else {}
+                )
+                self.queue.put({"usage": usage_data})
+                ws.close()
+
+    def gen_params(
+        self, messages: list, user_id: str, model_kwargs: Optional[dict] = None
+    ) -> dict:
+        data: Dict = {
+            "header": {"app_id": self.app_id, "uid": user_id},
+            "parameter": {"chat": {"domain": self.spark_domain}},
+            "payload": {"message": {"text": messages}},
+        }
+
+        if model_kwargs:
+            data["parameter"]["chat"].update(model_kwargs)
+        logger.debug(f"Spark Request Parameters: {data}")
+        return data
+
+    def subscribe(self, timeout: Optional[int] = 30) -> Generator[Dict, None, None]:
+        while True:
+            try:
+                content = self.queue.get(timeout=timeout)
+            except queue.Empty as _:
+                raise TimeoutError(
+                    f"SparkLLMClient wait LLM api response timeout {timeout} seconds"
+                )
+            if "error" in content:
+                raise ConnectionError(content["error"])
+            if "usage" in content:
+                yield content
+                continue
+            if "done" in content:
+                break
+            if "data" not in content:
+                break
+            yield content
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/tongyi.py b/llm/Lib/site-packages/langchain_community/chat_models/tongyi.py
new file mode 100644
index 0000000000000000000000000000000000000000..943cace9733e9785d3864f670566153e81dfce21
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/tongyi.py
@@ -0,0 +1,472 @@
+from __future__ import annotations
+
+import asyncio
+import functools
+import logging
+from typing import (
+    Any,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Union,
+    cast,
+)
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+    SystemMessageChunk,
+)
+from langchain_core.output_parsers.openai_tools import (
+    make_invalid_tool_call,
+    parse_tool_call,
+)
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatGenerationChunk,
+    ChatResult,
+)
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+from requests.exceptions import HTTPError
+from tenacity import (
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+from langchain_community.llms.tongyi import (
+    agenerate_with_last_element_mark,
+    check_response,
+    generate_with_last_element_mark,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def convert_dict_to_message(
+    _dict: Mapping[str, Any], is_chunk: bool = False
+) -> Union[BaseMessage, BaseMessageChunk]:
+    """Convert a dict to a message."""
+    role = _dict["role"]
+    content = _dict["content"]
+    if role == "user":
+        return (
+            HumanMessageChunk(content=content)
+            if is_chunk
+            else HumanMessage(content=content)
+        )
+    elif role == "assistant":
+        tool_calls = []
+        invalid_tool_calls = []
+        if "tool_calls" in _dict:
+            additional_kwargs = {"tool_calls": _dict["tool_calls"]}
+            for raw_tool_call in _dict["tool_calls"]:
+                try:
+                    tool_calls.append(parse_tool_call(raw_tool_call, return_id=True))
+                except Exception as e:
+                    invalid_tool_calls.append(
+                        make_invalid_tool_call(raw_tool_call, str(e))
+                    )
+        else:
+            additional_kwargs = {}
+        return (
+            AIMessageChunk(content=content)
+            if is_chunk
+            else AIMessage(
+                content=content,
+                additional_kwargs=additional_kwargs,
+                tool_calls=tool_calls,
+                invalid_tool_calls=invalid_tool_calls,
+            )
+        )
+    elif role == "system":
+        return (
+            SystemMessageChunk(content=content)
+            if is_chunk
+            else SystemMessage(content=content)
+        )
+    else:
+        return (
+            ChatMessageChunk(role=role, content=content)
+            if is_chunk
+            else ChatMessage(role=role, content=content)
+        )
+
+
+def convert_message_chunk_to_message(message_chunk: BaseMessageChunk) -> BaseMessage:
+    """Convert a message chunk to a message."""
+    if isinstance(message_chunk, HumanMessageChunk):
+        return HumanMessage(content=message_chunk.content)
+    elif isinstance(message_chunk, AIMessageChunk):
+        return AIMessage(content=message_chunk.content)
+    elif isinstance(message_chunk, SystemMessageChunk):
+        return SystemMessage(content=message_chunk.content)
+    elif isinstance(message_chunk, ChatMessageChunk):
+        return ChatMessage(role=message_chunk.role, content=message_chunk.content)
+    else:
+        raise TypeError(f"Got unknown type {message_chunk}")
+
+
+def convert_message_to_dict(message: BaseMessage) -> dict:
+    """Convert a message to a dict."""
+
+    message_dict: Dict[str, Any]
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": message.role, "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+    elif isinstance(message, SystemMessage):
+        message_dict = {"role": "system", "content": message.content}
+    else:
+        raise TypeError(f"Got unknown type {message}")
+    return message_dict
+
+
+def _create_retry_decorator(llm: ChatTongyi) -> Callable[[Any], Any]:
+    min_seconds = 1
+    max_seconds = 4
+    # Wait 2^x * 1 second between each retry starting with
+    # 4 seconds, then up to 10 seconds, then 10 seconds afterward
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(llm.max_retries),
+        wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+        retry=(retry_if_exception_type(HTTPError)),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+class ChatTongyi(BaseChatModel):
+    """Alibaba Tongyi Qwen chat models API.
+
+    To use, you should have the ``dashscope`` python package installed,
+    and set env ``DASHSCOPE_API_KEY`` with your API key, or pass
+    it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatTongyi
+            Tongyi_chat = ChatTongyi()
+    """
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"dashscope_api_key": "DASHSCOPE_API_KEY"}
+
+    client: Any  #: :meta private:
+    model_name: str = Field(default="qwen-turbo", alias="model")
+
+    """Model name to use."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+
+    top_p: float = 0.8
+    """Total probability mass of tokens to consider at each step."""
+
+    dashscope_api_key: Optional[SecretStr] = Field(None, alias="api_key")
+    """Dashscope api key provide by Alibaba Cloud."""
+
+    streaming: bool = False
+    """Whether to stream the results or not."""
+
+    max_retries: int = 10
+    """Maximum number of retries to make when generating."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "tongyi"
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["dashscope_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "dashscope_api_key", "DASHSCOPE_API_KEY")
+        )
+        try:
+            import dashscope
+        except ImportError:
+            raise ImportError(
+                "Could not import dashscope python package. "
+                "Please install it with `pip install dashscope --upgrade`."
+            )
+        try:
+            values["client"] = dashscope.Generation
+        except AttributeError:
+            raise ValueError(
+                "`dashscope` has no `Generation` attribute, this is likely "
+                "due to an old version of the dashscope package. Try upgrading it "
+                "with `pip install --upgrade dashscope`."
+            )
+
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Tongyi Qwen API."""
+        return {
+            "model": self.model_name,
+            "top_p": self.top_p,
+            "api_key": cast(SecretStr, self.dashscope_api_key).get_secret_value(),
+            "result_format": "message",
+            **self.model_kwargs,
+        }
+
+    def completion_with_retry(self, **kwargs: Any) -> Any:
+        """Use tenacity to retry the completion call."""
+        retry_decorator = _create_retry_decorator(self)
+
+        @retry_decorator
+        def _completion_with_retry(**_kwargs: Any) -> Any:
+            resp = self.client.call(**_kwargs)
+            return check_response(resp)
+
+        return _completion_with_retry(**kwargs)
+
+    def stream_completion_with_retry(self, **kwargs: Any) -> Any:
+        """Use tenacity to retry the completion call."""
+        retry_decorator = _create_retry_decorator(self)
+
+        @retry_decorator
+        def _stream_completion_with_retry(**_kwargs: Any) -> Any:
+            responses = self.client.call(**_kwargs)
+            for resp in responses:
+                yield check_response(resp)
+
+        return _stream_completion_with_retry(**kwargs)
+
+    async def astream_completion_with_retry(self, **kwargs: Any) -> Any:
+        """Because the dashscope SDK doesn't provide an async API,
+        we wrap `stream_generate_with_retry` with an async generator."""
+
+        class _AioTongyiGenerator:
+            def __init__(self, generator: Any):
+                self.generator = generator
+
+            def __aiter__(self) -> AsyncIterator[Any]:
+                return self
+
+            async def __anext__(self) -> Any:
+                value = await asyncio.get_running_loop().run_in_executor(
+                    None, self._safe_next
+                )
+                if value is not None:
+                    return value
+                else:
+                    raise StopAsyncIteration
+
+            def _safe_next(self) -> Any:
+                try:
+                    return next(self.generator)
+                except StopIteration:
+                    return None
+
+        async for chunk in _AioTongyiGenerator(
+            generator=self.stream_completion_with_retry(**kwargs)
+        ):
+            yield chunk
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        generations = []
+        if self.streaming:
+            generation: Optional[ChatGenerationChunk] = None
+            for chunk in self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            ):
+                if generation is None:
+                    generation = chunk
+                else:
+                    generation += chunk
+            assert generation is not None
+            generations.append(self._chunk_to_generation(generation))
+        else:
+            params: Dict[str, Any] = self._invocation_params(
+                messages=messages, stop=stop, **kwargs
+            )
+            resp = self.completion_with_retry(**params)
+            generations.append(
+                ChatGeneration(**self._chat_generation_from_qwen_resp(resp))
+            )
+        return ChatResult(
+            generations=generations,
+            llm_output={
+                "model_name": self.model_name,
+            },
+        )
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        generations = []
+        if self.streaming:
+            generation: Optional[ChatGenerationChunk] = None
+            async for chunk in self._astream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            ):
+                if generation is None:
+                    generation = chunk
+                else:
+                    generation += chunk
+            assert generation is not None
+            generations.append(self._chunk_to_generation(generation))
+        else:
+            params: Dict[str, Any] = self._invocation_params(
+                messages=messages, stop=stop, **kwargs
+            )
+            resp = await asyncio.get_running_loop().run_in_executor(
+                None,
+                functools.partial(self.completion_with_retry, **params),
+            )
+            generations.append(
+                ChatGeneration(**self._chat_generation_from_qwen_resp(resp))
+            )
+        return ChatResult(
+            generations=generations,
+            llm_output={
+                "model_name": self.model_name,
+            },
+        )
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        params: Dict[str, Any] = self._invocation_params(
+            messages=messages, stop=stop, stream=True, **kwargs
+        )
+        for stream_resp, is_last_chunk in generate_with_last_element_mark(
+            self.stream_completion_with_retry(**params)
+        ):
+            chunk = ChatGenerationChunk(
+                **self._chat_generation_from_qwen_resp(
+                    stream_resp, is_chunk=True, is_last_chunk=is_last_chunk
+                )
+            )
+            if run_manager:
+                run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+            yield chunk
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        params: Dict[str, Any] = self._invocation_params(
+            messages=messages, stop=stop, stream=True, **kwargs
+        )
+        async for stream_resp, is_last_chunk in agenerate_with_last_element_mark(
+            self.astream_completion_with_retry(**params)
+        ):
+            chunk = ChatGenerationChunk(
+                **self._chat_generation_from_qwen_resp(
+                    stream_resp, is_chunk=True, is_last_chunk=is_last_chunk
+                )
+            )
+            if run_manager:
+                await run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+            yield chunk
+
+    def _invocation_params(
+        self, messages: List[BaseMessage], stop: Any, **kwargs: Any
+    ) -> Dict[str, Any]:
+        params = {**self._default_params, **kwargs}
+        if stop is not None:
+            params["stop"] = stop
+        if params.get("stream"):
+            params["incremental_output"] = True
+
+        message_dicts = [convert_message_to_dict(m) for m in messages]
+
+        # According to the docs, the last message should be a `user` message
+        if message_dicts[-1]["role"] != "user":
+            raise ValueError("Last message should be user message.")
+        # And the `system` message should be the first message if present
+        system_message_indices = [
+            i for i, m in enumerate(message_dicts) if m["role"] == "system"
+        ]
+        if len(system_message_indices) == 1 and system_message_indices[0] != 0:
+            raise ValueError("System message can only be the first message.")
+        elif len(system_message_indices) > 1:
+            raise ValueError("There can be only one system message at most.")
+
+        params["messages"] = message_dicts
+
+        return params
+
+    def _combine_llm_outputs(self, llm_outputs: List[Optional[dict]]) -> dict:
+        if llm_outputs[0] is None:
+            return {}
+        return llm_outputs[0]
+
+    @staticmethod
+    def _chat_generation_from_qwen_resp(
+        resp: Any, is_chunk: bool = False, is_last_chunk: bool = True
+    ) -> Dict[str, Any]:
+        # According to the response from dashscope,
+        # each chunk's `generation_info` overwrites the previous one.
+        # Besides, The `merge_dicts` method,
+        # which is used to concatenate `generation_info` in `GenerationChunk`,
+        # does not support merging of int type values.
+        # Therefore, we adopt the `generation_info` of the last chunk
+        # and discard the `generation_info` of the intermediate chunks.
+        choice = resp["output"]["choices"][0]
+        message = convert_dict_to_message(choice["message"], is_chunk=is_chunk)
+        if is_last_chunk:
+            return dict(
+                message=message,
+                generation_info=dict(
+                    finish_reason=choice["finish_reason"],
+                    request_id=resp["request_id"],
+                    token_usage=dict(resp["usage"]),
+                ),
+            )
+        else:
+            return dict(message=message)
+
+    @staticmethod
+    def _chunk_to_generation(chunk: ChatGenerationChunk) -> ChatGeneration:
+        return ChatGeneration(
+            message=convert_message_chunk_to_message(chunk.message),
+            generation_info=chunk.generation_info,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/vertexai.py b/llm/Lib/site-packages/langchain_community/chat_models/vertexai.py
new file mode 100644
index 0000000000000000000000000000000000000000..ec9d887f17194376829919c305d49ed68d97f714
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/vertexai.py
@@ -0,0 +1,392 @@
+"""Wrapper around Google VertexAI chat-based models."""
+from __future__ import annotations
+
+import base64
+import logging
+import re
+from dataclasses import dataclass, field
+from typing import TYPE_CHECKING, Any, Dict, Iterator, List, Optional, Union, cast
+from urllib.parse import urlparse
+
+import requests
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import root_validator
+
+from langchain_community.llms.vertexai import (
+    _VertexAICommon,
+    is_codey_model,
+    is_gemini_model,
+)
+from langchain_community.utilities.vertexai import (
+    load_image_from_gcs,
+    raise_vertex_import_error,
+)
+
+if TYPE_CHECKING:
+    from vertexai.language_models import (
+        ChatMessage,
+        ChatSession,
+        CodeChatSession,
+        InputOutputTextPair,
+    )
+    from vertexai.preview.generative_models import Content
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class _ChatHistory:
+    """Represents a context and a history of messages."""
+
+    history: List["ChatMessage"] = field(default_factory=list)
+    context: Optional[str] = None
+
+
+def _parse_chat_history(history: List[BaseMessage]) -> _ChatHistory:
+    """Parse a sequence of messages into history.
+
+    Args:
+        history: The list of messages to re-create the history of the chat.
+    Returns:
+        A parsed chat history.
+    Raises:
+        ValueError: If a sequence of message has a SystemMessage not at the
+        first place.
+    """
+    from vertexai.language_models import ChatMessage
+
+    vertex_messages, context = [], None
+    for i, message in enumerate(history):
+        content = cast(str, message.content)
+        if i == 0 and isinstance(message, SystemMessage):
+            context = content
+        elif isinstance(message, AIMessage):
+            vertex_message = ChatMessage(content=message.content, author="bot")
+            vertex_messages.append(vertex_message)
+        elif isinstance(message, HumanMessage):
+            vertex_message = ChatMessage(content=message.content, author="user")
+            vertex_messages.append(vertex_message)
+        else:
+            raise ValueError(
+                f"Unexpected message with type {type(message)} at the position {i}."
+            )
+    chat_history = _ChatHistory(context=context, history=vertex_messages)
+    return chat_history
+
+
+def _is_url(s: str) -> bool:
+    try:
+        result = urlparse(s)
+        return all([result.scheme, result.netloc])
+    except Exception as e:
+        logger.debug(f"Unable to parse URL: {e}")
+        return False
+
+
+def _parse_chat_history_gemini(
+    history: List[BaseMessage], project: Optional[str]
+) -> List["Content"]:
+    from vertexai.preview.generative_models import Content, Image, Part
+
+    def _convert_to_prompt(part: Union[str, Dict]) -> Part:
+        if isinstance(part, str):
+            return Part.from_text(part)
+
+        if not isinstance(part, Dict):
+            raise ValueError(
+                f"Message's content is expected to be a dict, got {type(part)}!"
+            )
+        if part["type"] == "text":
+            return Part.from_text(part["text"])
+        elif part["type"] == "image_url":
+            path = part["image_url"]["url"]
+            if path.startswith("gs://"):
+                image = load_image_from_gcs(path=path, project=project)
+            elif path.startswith("data:image/"):
+                # extract base64 component from image uri
+                encoded: Any = re.search(r"data:image/\w{2,4};base64,(.*)", path)
+                if encoded:
+                    encoded = encoded.group(1)
+                else:
+                    raise ValueError(
+                        "Invalid image uri. It should be in the format "
+                        "data:image/<image_type>;base64,<base64_encoded_image>."
+                    )
+                image = Image.from_bytes(base64.b64decode(encoded))
+            elif _is_url(path):
+                response = requests.get(path)
+                response.raise_for_status()
+                image = Image.from_bytes(response.content)
+            else:
+                image = Image.load_from_file(path)
+        else:
+            raise ValueError("Only text and image_url types are supported!")
+        return Part.from_image(image)
+
+    vertex_messages = []
+    for i, message in enumerate(history):
+        if i == 0 and isinstance(message, SystemMessage):
+            raise ValueError("SystemMessages are not yet supported!")
+        elif isinstance(message, AIMessage):
+            role = "model"
+        elif isinstance(message, HumanMessage):
+            role = "user"
+        else:
+            raise ValueError(
+                f"Unexpected message with type {type(message)} at the position {i}."
+            )
+
+        raw_content = message.content
+        if isinstance(raw_content, str):
+            raw_content = [raw_content]
+        parts = [_convert_to_prompt(part) for part in raw_content]
+        vertex_message = Content(role=role, parts=parts)
+        vertex_messages.append(vertex_message)
+    return vertex_messages
+
+
+def _parse_examples(examples: List[BaseMessage]) -> List["InputOutputTextPair"]:
+    from vertexai.language_models import InputOutputTextPair
+
+    if len(examples) % 2 != 0:
+        raise ValueError(
+            f"Expect examples to have an even amount of messages, got {len(examples)}."
+        )
+    example_pairs = []
+    input_text = None
+    for i, example in enumerate(examples):
+        if i % 2 == 0:
+            if not isinstance(example, HumanMessage):
+                raise ValueError(
+                    f"Expected the first message in a part to be from human, got "
+                    f"{type(example)} for the {i}th message."
+                )
+            input_text = example.content
+        if i % 2 == 1:
+            if not isinstance(example, AIMessage):
+                raise ValueError(
+                    f"Expected the second message in a part to be from AI, got "
+                    f"{type(example)} for the {i}th message."
+                )
+            pair = InputOutputTextPair(
+                input_text=input_text, output_text=example.content
+            )
+            example_pairs.append(pair)
+    return example_pairs
+
+
+def _get_question(messages: List[BaseMessage]) -> HumanMessage:
+    """Get the human message at the end of a list of input messages to a chat model."""
+    if not messages:
+        raise ValueError("You should provide at least one message to start the chat!")
+    question = messages[-1]
+    if not isinstance(question, HumanMessage):
+        raise ValueError(
+            f"Last message in the list should be from human, got {question.type}."
+        )
+    return question
+
+
+@deprecated(
+    since="0.0.12",
+    removal="0.2.0",
+    alternative_import="langchain_google_vertexai.ChatVertexAI",
+)
+class ChatVertexAI(_VertexAICommon, BaseChatModel):
+    """`Vertex AI` Chat large language models API."""
+
+    model_name: str = "chat-bison"
+    "Underlying model name."
+    examples: Optional[List[BaseMessage]] = None
+
+    @classmethod
+    def is_lc_serializable(self) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "chat_models", "vertexai"]
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in environment."""
+        is_gemini = is_gemini_model(values["model_name"])
+        cls._try_init_vertexai(values)
+        try:
+            from vertexai.language_models import ChatModel, CodeChatModel
+
+            if is_gemini:
+                from vertexai.preview.generative_models import (
+                    GenerativeModel,
+                )
+        except ImportError:
+            raise_vertex_import_error()
+        if is_gemini:
+            values["client"] = GenerativeModel(model_name=values["model_name"])
+        else:
+            if is_codey_model(values["model_name"]):
+                model_cls = CodeChatModel
+            else:
+                model_cls = ChatModel
+            values["client"] = model_cls.from_pretrained(values["model_name"])
+        return values
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Generate next turn in the conversation.
+
+        Args:
+            messages: The history of the conversation as a list of messages. Code chat
+                does not support context.
+            stop: The list of stop words (optional).
+            run_manager: The CallbackManager for LLM run, it's not used at the moment.
+            stream: Whether to use the streaming endpoint.
+
+        Returns:
+            The ChatResult that contains outputs generated by the model.
+
+        Raises:
+            ValueError: if the last message in the list is not from human.
+        """
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        question = _get_question(messages)
+        params = self._prepare_params(stop=stop, stream=False, **kwargs)
+        msg_params = {}
+        if "candidate_count" in params:
+            msg_params["candidate_count"] = params.pop("candidate_count")
+
+        if self._is_gemini_model:
+            history_gemini = _parse_chat_history_gemini(messages, project=self.project)
+            message = history_gemini.pop()
+            chat = self.client.start_chat(history=history_gemini)
+            response = chat.send_message(message, generation_config=params)
+        else:
+            history = _parse_chat_history(messages[:-1])
+            examples = kwargs.get("examples") or self.examples
+            if examples:
+                params["examples"] = _parse_examples(examples)
+            chat = self._start_chat(history, **params)
+            response = chat.send_message(question.content, **msg_params)
+        generations = [
+            ChatGeneration(message=AIMessage(content=r.text))
+            for r in response.candidates
+        ]
+        return ChatResult(generations=generations)
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Asynchronously generate next turn in the conversation.
+
+        Args:
+            messages: The history of the conversation as a list of messages. Code chat
+                does not support context.
+            stop: The list of stop words (optional).
+            run_manager: The CallbackManager for LLM run, it's not used at the moment.
+
+        Returns:
+            The ChatResult that contains outputs generated by the model.
+
+        Raises:
+            ValueError: if the last message in the list is not from human.
+        """
+        if "stream" in kwargs:
+            kwargs.pop("stream")
+            logger.warning("ChatVertexAI does not currently support async streaming.")
+
+        params = self._prepare_params(stop=stop, **kwargs)
+        msg_params = {}
+        if "candidate_count" in params:
+            msg_params["candidate_count"] = params.pop("candidate_count")
+
+        if self._is_gemini_model:
+            history_gemini = _parse_chat_history_gemini(messages, project=self.project)
+            message = history_gemini.pop()
+            chat = self.client.start_chat(history=history_gemini)
+            response = await chat.send_message_async(message, generation_config=params)
+        else:
+            question = _get_question(messages)
+            history = _parse_chat_history(messages[:-1])
+            examples = kwargs.get("examples", None)
+            if examples:
+                params["examples"] = _parse_examples(examples)
+            chat = self._start_chat(history, **params)
+            response = await chat.send_message_async(question.content, **msg_params)
+
+        generations = [
+            ChatGeneration(message=AIMessage(content=r.text))
+            for r in response.candidates
+        ]
+        return ChatResult(generations=generations)
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        params = self._prepare_params(stop=stop, stream=True, **kwargs)
+        if self._is_gemini_model:
+            history_gemini = _parse_chat_history_gemini(messages, project=self.project)
+            message = history_gemini.pop()
+            chat = self.client.start_chat(history=history_gemini)
+            responses = chat.send_message(
+                message, stream=True, generation_config=params
+            )
+        else:
+            question = _get_question(messages)
+            history = _parse_chat_history(messages[:-1])
+            examples = kwargs.get("examples", None)
+            if examples:
+                params["examples"] = _parse_examples(examples)
+            chat = self._start_chat(history, **params)
+            responses = chat.send_message_streaming(question.content, **params)
+        for response in responses:
+            chunk = ChatGenerationChunk(message=AIMessageChunk(content=response.text))
+            if run_manager:
+                run_manager.on_llm_new_token(response.text, chunk=chunk)
+            yield chunk
+
+    def _start_chat(
+        self, history: _ChatHistory, **kwargs: Any
+    ) -> Union[ChatSession, CodeChatSession]:
+        if not self.is_codey_model:
+            return self.client.start_chat(
+                context=history.context, message_history=history.history, **kwargs
+            )
+        else:
+            return self.client.start_chat(message_history=history.history, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/volcengine_maas.py b/llm/Lib/site-packages/langchain_community/chat_models/volcengine_maas.py
new file mode 100644
index 0000000000000000000000000000000000000000..687a540bb30ea405e90615f32be6f433ded2cbb3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/volcengine_maas.py
@@ -0,0 +1,146 @@
+from __future__ import annotations
+
+from typing import Any, Dict, Iterator, List, Mapping, Optional, cast
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    FunctionMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+
+from langchain_community.llms.volcengine_maas import VolcEngineMaasBase
+
+
+def _convert_message_to_dict(message: BaseMessage) -> dict:
+    if isinstance(message, SystemMessage):
+        message_dict = {"role": "system", "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+    elif isinstance(message, FunctionMessage):
+        message_dict = {"role": "function", "content": message.content}
+    else:
+        raise ValueError(f"Got unknown type {message}")
+    return message_dict
+
+
+def convert_dict_to_message(_dict: Mapping[str, Any]) -> AIMessage:
+    """Convert a dict to a message."""
+
+    content = _dict.get("choice", {}).get("message", {}).get("content", "")
+    return AIMessage(content=content)
+
+
+class VolcEngineMaasChat(BaseChatModel, VolcEngineMaasBase):
+    """Volc Engine Maas hosts a plethora of models.
+
+    You can utilize these models through this class.
+
+    To use, you should have the ``volcengine`` python package installed.
+    and set access key and secret key by environment variable or direct pass those
+    to this class.
+    access key, secret key are required parameters which you could get help
+    https://www.volcengine.com/docs/6291/65568
+
+    In order to use them, it is necessary to install the 'volcengine' Python package.
+    The access key and secret key must be set either via environment variables or
+    passed directly to this class.
+    access key and secret key are mandatory parameters for which assistance can be
+    sought at https://www.volcengine.com/docs/6291/65568.
+
+    The two methods are as follows:
+    * Environment Variable
+    Set the environment variables 'VOLC_ACCESSKEY' and 'VOLC_SECRETKEY' with your
+    access key and secret key.
+
+    * Pass Directly to Class
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import VolcEngineMaasLLM
+            model = VolcEngineMaasChat(model="skylark-lite-public",
+                                          volc_engine_maas_ak="your_ak",
+                                          volc_engine_maas_sk="your_sk")
+    """
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "volc-engine-maas-chat"
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this model can be serialized by Langchain."""
+        return False
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        return {
+            **{"endpoint": self.endpoint, "model": self.model},
+            **super()._identifying_params,
+        }
+
+    def _convert_prompt_msg_params(
+        self,
+        messages: List[BaseMessage],
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        model_req = {
+            "model": {
+                "name": self.model,
+            }
+        }
+        if self.model_version is not None:
+            model_req["model"]["version"] = self.model_version
+        return {
+            **model_req,
+            "messages": [_convert_message_to_dict(message) for message in messages],
+            "parameters": {**self._default_params, **kwargs},
+        }
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        if stop is not None:
+            kwargs["stop"] = stop
+        params = self._convert_prompt_msg_params(messages, **kwargs)
+        for res in self.client.stream_chat(params):
+            if res:
+                msg = convert_dict_to_message(res)
+                chunk = ChatGenerationChunk(message=AIMessageChunk(content=msg.content))
+                if run_manager:
+                    run_manager.on_llm_new_token(cast(str, msg.content), chunk=chunk)
+                yield chunk
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        completion = ""
+        if self.streaming:
+            for chunk in self._stream(messages, stop, run_manager, **kwargs):
+                completion += chunk.text
+        else:
+            if stop is not None:
+                kwargs["stop"] = stop
+            params = self._convert_prompt_msg_params(messages, **kwargs)
+            res = self.client.chat(params)
+            msg = convert_dict_to_message(res)
+            completion = cast(str, msg.content)
+
+        message = AIMessage(content=completion)
+        return ChatResult(generations=[ChatGeneration(message=message)])
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/yandex.py b/llm/Lib/site-packages/langchain_community/chat_models/yandex.py
new file mode 100644
index 0000000000000000000000000000000000000000..424de6f8cf03289f8968d053cba496bb03070568
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/yandex.py
@@ -0,0 +1,282 @@
+"""Wrapper around YandexGPT chat models."""
+from __future__ import annotations
+
+import logging
+from typing import Any, Callable, Dict, List, Optional, cast
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.outputs import ChatGeneration, ChatResult
+from tenacity import (
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+from langchain_community.llms.utils import enforce_stop_tokens
+from langchain_community.llms.yandex import _BaseYandexGPT
+
+logger = logging.getLogger(__name__)
+
+
+def _parse_message(role: str, text: str) -> Dict:
+    return {"role": role, "text": text}
+
+
+def _parse_chat_history(history: List[BaseMessage]) -> List[Dict[str, str]]:
+    """Parse a sequence of messages into history.
+
+    Returns:
+        A list of parsed messages.
+    """
+    chat_history = []
+    for message in history:
+        content = cast(str, message.content)
+        if isinstance(message, HumanMessage):
+            chat_history.append(_parse_message("user", content))
+        if isinstance(message, AIMessage):
+            chat_history.append(_parse_message("assistant", content))
+        if isinstance(message, SystemMessage):
+            chat_history.append(_parse_message("system", content))
+    return chat_history
+
+
+class ChatYandexGPT(_BaseYandexGPT, BaseChatModel):
+    """YandexGPT large language models.
+
+    There are two authentication options for the service account
+    with the ``ai.languageModels.user`` role:
+        - You can specify the token in a constructor parameter `iam_token`
+        or in an environment variable `YC_IAM_TOKEN`.
+        - You can specify the key in a constructor parameter `api_key`
+        or in an environment variable `YC_API_KEY`.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatYandexGPT
+            chat_model = ChatYandexGPT(iam_token="t1.9eu...")
+
+    """
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Generate next turn in the conversation.
+        Args:
+            messages: The history of the conversation as a list of messages.
+            stop: The list of stop words (optional).
+            run_manager: The CallbackManager for LLM run, it's not used at the moment.
+
+        Returns:
+            The ChatResult that contains outputs generated by the model.
+
+        Raises:
+            ValueError: if the last message in the list is not from human.
+        """
+        text = completion_with_retry(self, messages=messages)
+        text = text if stop is None else enforce_stop_tokens(text, stop)
+        message = AIMessage(content=text)
+        return ChatResult(generations=[ChatGeneration(message=message)])
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Async method to generate next turn in the conversation.
+
+        Args:
+            messages: The history of the conversation as a list of messages.
+            stop: The list of stop words (optional).
+            run_manager: The CallbackManager for LLM run, it's not used at the moment.
+
+        Returns:
+            The ChatResult that contains outputs generated by the model.
+
+        Raises:
+            ValueError: if the last message in the list is not from human.
+        """
+        text = await acompletion_with_retry(self, messages=messages)
+        text = text if stop is None else enforce_stop_tokens(text, stop)
+        message = AIMessage(content=text)
+        return ChatResult(generations=[ChatGeneration(message=message)])
+
+
+def _make_request(
+    self: ChatYandexGPT,
+    messages: List[BaseMessage],
+) -> str:
+    try:
+        import grpc
+        from google.protobuf.wrappers_pb2 import DoubleValue, Int64Value
+
+        try:
+            from yandex.cloud.ai.foundation_models.v1.text_common_pb2 import (
+                CompletionOptions,
+                Message,
+            )
+            from yandex.cloud.ai.foundation_models.v1.text_generation.text_generation_service_pb2 import (  # noqa: E501
+                CompletionRequest,
+            )
+            from yandex.cloud.ai.foundation_models.v1.text_generation.text_generation_service_pb2_grpc import (  # noqa: E501
+                TextGenerationServiceStub,
+            )
+        except ModuleNotFoundError:
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_pb2 import (
+                CompletionOptions,
+                Message,
+            )
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_service_pb2 import (  # noqa: E501
+                CompletionRequest,
+            )
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_service_pb2_grpc import (  # noqa: E501
+                TextGenerationServiceStub,
+            )
+    except ImportError as e:
+        raise ImportError(
+            "Please install YandexCloud SDK  with `pip install yandexcloud` \
+            or upgrade it to recent version."
+        ) from e
+    if not messages:
+        raise ValueError("You should provide at least one message to start the chat!")
+    message_history = _parse_chat_history(messages)
+    channel_credentials = grpc.ssl_channel_credentials()
+    channel = grpc.secure_channel(self.url, channel_credentials)
+    request = CompletionRequest(
+        model_uri=self.model_uri,
+        completion_options=CompletionOptions(
+            temperature=DoubleValue(value=self.temperature),
+            max_tokens=Int64Value(value=self.max_tokens),
+        ),
+        messages=[Message(**message) for message in message_history],
+    )
+    stub = TextGenerationServiceStub(channel)
+    res = stub.Completion(request, metadata=self._grpc_metadata)
+    return list(res)[0].alternatives[0].message.text
+
+
+async def _amake_request(self: ChatYandexGPT, messages: List[BaseMessage]) -> str:
+    try:
+        import asyncio
+
+        import grpc
+        from google.protobuf.wrappers_pb2 import DoubleValue, Int64Value
+
+        try:
+            from yandex.cloud.ai.foundation_models.v1.text_common_pb2 import (
+                CompletionOptions,
+                Message,
+            )
+            from yandex.cloud.ai.foundation_models.v1.text_generation.text_generation_service_pb2 import (  # noqa: E501
+                CompletionRequest,
+                CompletionResponse,
+            )
+            from yandex.cloud.ai.foundation_models.v1.text_generation.text_generation_service_pb2_grpc import (  # noqa: E501
+                TextGenerationAsyncServiceStub,
+            )
+        except ModuleNotFoundError:
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_pb2 import (
+                CompletionOptions,
+                Message,
+            )
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_service_pb2 import (  # noqa: E501
+                CompletionRequest,
+                CompletionResponse,
+            )
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_service_pb2_grpc import (  # noqa: E501
+                TextGenerationAsyncServiceStub,
+            )
+        from yandex.cloud.operation.operation_service_pb2 import GetOperationRequest
+        from yandex.cloud.operation.operation_service_pb2_grpc import (
+            OperationServiceStub,
+        )
+    except ImportError as e:
+        raise ImportError(
+            "Please install YandexCloud SDK  with `pip install yandexcloud` \
+            or upgrade it to recent version."
+        ) from e
+    if not messages:
+        raise ValueError("You should provide at least one message to start the chat!")
+    message_history = _parse_chat_history(messages)
+    operation_api_url = "operation.api.cloud.yandex.net:443"
+    channel_credentials = grpc.ssl_channel_credentials()
+    async with grpc.aio.secure_channel(self.url, channel_credentials) as channel:
+        request = CompletionRequest(
+            model_uri=self.model_uri,
+            completion_options=CompletionOptions(
+                temperature=DoubleValue(value=self.temperature),
+                max_tokens=Int64Value(value=self.max_tokens),
+            ),
+            messages=[Message(**message) for message in message_history],
+        )
+        stub = TextGenerationAsyncServiceStub(channel)
+        operation = await stub.Completion(request, metadata=self._grpc_metadata)
+        async with grpc.aio.secure_channel(
+            operation_api_url, channel_credentials
+        ) as operation_channel:
+            operation_stub = OperationServiceStub(operation_channel)
+            while not operation.done:
+                await asyncio.sleep(1)
+                operation_request = GetOperationRequest(operation_id=operation.id)
+                operation = await operation_stub.Get(
+                    operation_request,
+                    metadata=self._grpc_metadata,
+                )
+
+        completion_response = CompletionResponse()
+        operation.response.Unpack(completion_response)
+        return completion_response.alternatives[0].message.text
+
+
+def _create_retry_decorator(llm: ChatYandexGPT) -> Callable[[Any], Any]:
+    from grpc import RpcError
+
+    min_seconds = llm.sleep_interval
+    max_seconds = 60
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(llm.max_retries),
+        wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+        retry=(retry_if_exception_type((RpcError))),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def completion_with_retry(llm: ChatYandexGPT, **kwargs: Any) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = _create_retry_decorator(llm)
+
+    @retry_decorator
+    def _completion_with_retry(**_kwargs: Any) -> Any:
+        return _make_request(llm, **_kwargs)
+
+    return _completion_with_retry(**kwargs)
+
+
+async def acompletion_with_retry(llm: ChatYandexGPT, **kwargs: Any) -> Any:
+    """Use tenacity to retry the async completion call."""
+    retry_decorator = _create_retry_decorator(llm)
+
+    @retry_decorator
+    async def _completion_with_retry(**_kwargs: Any) -> Any:
+        return await _amake_request(llm, **_kwargs)
+
+    return await _completion_with_retry(**kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/yuan2.py b/llm/Lib/site-packages/langchain_community/chat_models/yuan2.py
new file mode 100644
index 0000000000000000000000000000000000000000..379dc63092854a4803f142f3ec49eb52b2437a9c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/yuan2.py
@@ -0,0 +1,485 @@
+"""ChatYuan2 wrapper."""
+from __future__ import annotations
+
+import logging
+from typing import (
+    Any,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    FunctionMessage,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+    SystemMessageChunk,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+from langchain_core.utils import (
+    get_from_dict_or_env,
+    get_pydantic_field_names,
+)
+from tenacity import (
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class ChatYuan2(BaseChatModel):
+    """`Yuan2.0` Chat models API.
+
+    To use, you should have the ``openai-python`` package installed, if package
+    not installed, using ```pip install openai``` to install it. The
+    environment variable ``YUAN2_API_KEY`` set to your API key, if not set,
+    everyone can access apis.
+
+    Any parameters that are valid to be passed to the openai.create call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatYuan2
+
+            chat = ChatYuan2()
+    """
+
+    client: Any  #: :meta private:
+    async_client: Any = Field(default=None, exclude=True)  #: :meta private:
+
+    model_name: str = Field(default="yuan2", alias="model")
+    """Model name to use."""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not explicitly specified."""
+
+    yuan2_api_key: Optional[str] = Field(default="EMPTY", alias="api_key")
+    """Automatically inferred from env var `YUAN2_API_KEY` if not provided."""
+
+    yuan2_api_base: Optional[str] = Field(
+        default="http://127.0.0.1:8000/v1", alias="base_url"
+    )
+    """Base URL path for API requests, an OpenAI compatible API server."""
+
+    request_timeout: Optional[Union[float, Tuple[float, float]]] = None
+    """Timeout for requests to yuan2 completion API. Default is 600 seconds."""
+
+    max_retries: int = 6
+    """Maximum number of retries to make when generating."""
+
+    streaming: bool = False
+    """Whether to stream the results or not."""
+
+    max_tokens: Optional[int] = None
+    """Maximum number of tokens to generate."""
+
+    temperature: float = 1.0
+    """What sampling temperature to use."""
+
+    top_p: Optional[float] = 0.9
+    """The top-p value to use for sampling."""
+
+    stop: Optional[List[str]] = ["<eod>"]
+    """A list of strings to stop generation when encountered."""
+
+    repeat_last_n: Optional[int] = 64
+    "Last n tokens to penalize"
+
+    repeat_penalty: Optional[float] = 1.18
+    """The penalty to apply to repeated tokens."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"yuan2_api_key": "YUAN2_API_KEY"}
+
+    @property
+    def lc_attributes(self) -> Dict[str, Any]:
+        attributes: Dict[str, Any] = {}
+
+        if self.yuan2_api_base:
+            attributes["yuan2_api_base"] = self.yuan2_api_base
+
+        if self.yuan2_api_key:
+            attributes["yuan2_api_key"] = self.yuan2_api_key
+
+        return attributes
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name in extra:
+                raise ValueError(f"Found {field_name} supplied twice.")
+            if field_name not in all_required_field_names:
+                logger.warning(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+
+        invalid_model_kwargs = all_required_field_names.intersection(extra.keys())
+        if invalid_model_kwargs:
+            raise ValueError(
+                f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+                f"Instead they were passed in as part of `model_kwargs` parameter."
+            )
+
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["yuan2_api_key"] = get_from_dict_or_env(
+            values, "yuan2_api_key", "YUAN2_API_KEY"
+        )
+
+        try:
+            import openai
+
+        except ImportError:
+            raise ValueError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+        client_params = {
+            "api_key": values["yuan2_api_key"],
+            "base_url": values["yuan2_api_base"],
+            "timeout": values["request_timeout"],
+            "max_retries": values["max_retries"],
+        }
+
+        # generate client and async_client
+        if not values.get("client"):
+            values["client"] = openai.OpenAI(**client_params).chat.completions
+        if not values.get("async_client"):
+            values["async_client"] = openai.AsyncOpenAI(
+                **client_params
+            ).chat.completions
+
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling yuan2 API."""
+        params = {
+            "model": self.model_name,
+            "stream": self.streaming,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            **self.model_kwargs,
+        }
+        if self.max_tokens is not None:
+            params["max_tokens"] = self.max_tokens
+        if self.request_timeout is not None:
+            params["request_timeout"] = self.request_timeout
+        return params
+
+    def completion_with_retry(self, **kwargs: Any) -> Any:
+        """Use tenacity to retry the completion call."""
+        retry_decorator = _create_retry_decorator(self)
+
+        @retry_decorator
+        def _completion_with_retry(**kwargs: Any) -> Any:
+            return self.client.create(**kwargs)
+
+        return _completion_with_retry(**kwargs)
+
+    def _combine_llm_outputs(self, llm_outputs: List[Optional[dict]]) -> dict:
+        overall_token_usage: dict = {}
+        logger.debug(
+            f"type(llm_outputs): {type(llm_outputs)}; llm_outputs: {llm_outputs}"
+        )
+        for output in llm_outputs:
+            if output is None:
+                # Happens in streaming
+                continue
+            token_usage = output["token_usage"]
+            for k, v in token_usage.items():
+                if k in overall_token_usage:
+                    overall_token_usage[k] += v
+                else:
+                    overall_token_usage[k] = v
+        return {"token_usage": overall_token_usage, "model_name": self.model_name}
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+
+        default_chunk_class = AIMessageChunk
+        for chunk in self.completion_with_retry(messages=message_dicts, **params):
+            if not isinstance(chunk, dict):
+                chunk = chunk.model_dump()
+            if len(chunk["choices"]) == 0:
+                continue
+            choice = chunk["choices"][0]
+            chunk = _convert_delta_to_message_chunk(
+                choice["delta"], default_chunk_class
+            )
+            finish_reason = choice.get("finish_reason")
+            generation_info = (
+                dict(finish_reason=finish_reason) if finish_reason is not None else None
+            )
+            default_chunk_class = chunk.__class__
+            cg_chunk = ChatGenerationChunk(
+                message=chunk,
+                generation_info=generation_info,
+            )
+            if run_manager:
+                run_manager.on_llm_new_token(chunk.content, chunk=cg_chunk)
+            yield cg_chunk
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._stream(
+                messages=messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs}
+        response = self.completion_with_retry(messages=message_dicts, **params)
+        return self._create_chat_result(response)
+
+    def _create_message_dicts(
+        self, messages: List[BaseMessage], stop: Optional[List[str]]
+    ) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+        params = dict(self._invocation_params)
+        if stop is not None:
+            if "stop" in params:
+                raise ValueError("`stop` found in both the input and default params.")
+            params["stop"] = stop
+        message_dicts = [_convert_message_to_dict(m) for m in messages]
+        return message_dicts, params
+
+    def _create_chat_result(self, response: Union[dict, BaseModel]) -> ChatResult:
+        generations = []
+        logger.debug(f"type(response): {type(response)}; response: {response}")
+        if not isinstance(response, dict):
+            response = response.dict()
+        for res in response["choices"]:
+            message = _convert_dict_to_message(res["message"])
+            generation_info = dict(finish_reason=res["finish_reason"])
+            if "logprobs" in res:
+                generation_info["logprobs"] = res["logprobs"]
+            gen = ChatGeneration(
+                message=message,
+                generation_info=generation_info,
+            )
+            generations.append(gen)
+        llm_output = {
+            "token_usage": response.get("usage", {}),
+            "model_name": self.model_name,
+        }
+        return ChatResult(generations=generations, llm_output=llm_output)
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs, "stream": True}
+
+        default_chunk_class = AIMessageChunk
+        async for chunk in await acompletion_with_retry(
+            self, messages=message_dicts, **params
+        ):
+            if not isinstance(chunk, dict):
+                chunk = chunk.model_dump()
+            if len(chunk["choices"]) == 0:
+                continue
+            choice = chunk["choices"][0]
+            chunk = _convert_delta_to_message_chunk(
+                choice["delta"], default_chunk_class
+            )
+            finish_reason = choice.get("finish_reason")
+            generation_info = (
+                dict(finish_reason=finish_reason) if finish_reason is not None else None
+            )
+            default_chunk_class = chunk.__class__
+            cg_chunk = ChatGenerationChunk(
+                message=chunk,
+                generation_info=generation_info,
+            )
+            if run_manager:
+                await run_manager.on_llm_new_token(chunk.content, chunk=cg_chunk)
+            yield cg_chunk
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if self.streaming:
+            stream_iter = self._astream(
+                messages=messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        params = {**params, **kwargs}
+        response = await acompletion_with_retry(self, messages=message_dicts, **params)
+        return self._create_chat_result(response)
+
+    @property
+    def _invocation_params(self) -> Mapping[str, Any]:
+        """Get the parameters used to invoke the model."""
+        yuan2_creds: Dict[str, Any] = {
+            "model": self.model_name,
+        }
+        return {**yuan2_creds, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+        return "chat-yuan2"
+
+
+def _create_retry_decorator(llm: ChatYuan2) -> Callable[[Any], Any]:
+    import openai
+
+    min_seconds = 1
+    max_seconds = 60
+    # Wait 2^x * 1 second between each retry starting with
+    # 4 seconds, then up to 10 seconds, then 10 seconds afterwards
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(llm.max_retries),
+        wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+        retry=(
+            retry_if_exception_type(openai.APITimeoutError)
+            | retry_if_exception_type(openai.APIError)
+            | retry_if_exception_type(openai.APIConnectionError)
+            | retry_if_exception_type(openai.RateLimitError)
+            | retry_if_exception_type(openai.InternalServerError)
+        ),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+async def acompletion_with_retry(llm: ChatYuan2, **kwargs: Any) -> Any:
+    """Use tenacity to retry the async completion call."""
+    retry_decorator = _create_retry_decorator(llm)
+
+    @retry_decorator
+    async def _completion_with_retry(**kwargs: Any) -> Any:
+        # Use OpenAI's async api https://github.com/openai/openai-python#async-api
+        return await llm.async_client.create(**kwargs)
+
+    return await _completion_with_retry(**kwargs)
+
+
+def _convert_delta_to_message_chunk(
+    _dict: Mapping[str, Any], default_class: Type[BaseMessageChunk]
+) -> BaseMessageChunk:
+    role = _dict.get("role")
+    content = _dict.get("content") or ""
+
+    if role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=content)
+    elif role == "assistant" or default_class == AIMessageChunk:
+        return AIMessageChunk(content=content)
+    elif role == "system" or default_class == SystemMessageChunk:
+        return SystemMessageChunk(content=content)
+    elif role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=content, role=role)
+    else:
+        return default_class(content=content)
+
+
+def _convert_dict_to_message(_dict: Mapping[str, Any]) -> BaseMessage:
+    role = _dict.get("role")
+    if role == "user":
+        return HumanMessage(content=_dict.get("content", ""))
+    elif role == "assistant":
+        return AIMessage(content=_dict.get("content", ""))
+    elif role == "system":
+        return SystemMessage(content=_dict.get("content", ""))
+    else:
+        return ChatMessage(content=_dict.get("content", ""), role=role)
+
+
+def _convert_message_to_dict(message: BaseMessage) -> dict:
+    """Convert a LangChain message to a dictionary.
+
+    Args:
+        message: The LangChain message.
+
+    Returns:
+        The dictionary.
+    """
+    message_dict: Dict[str, Any]
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": message.role, "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+    elif isinstance(message, SystemMessage):
+        message_dict = {"role": "system", "content": message.content}
+    elif isinstance(message, FunctionMessage):
+        message_dict = {
+            "role": "function",
+            "name": message.name,
+            "content": message.content,
+        }
+    else:
+        raise ValueError(f"Got unknown type {message}")
+    if "name" in message.additional_kwargs:
+        message_dict["name"] = message.additional_kwargs["name"]
+    return message_dict
diff --git a/llm/Lib/site-packages/langchain_community/chat_models/zhipuai.py b/llm/Lib/site-packages/langchain_community/chat_models/zhipuai.py
new file mode 100644
index 0000000000000000000000000000000000000000..5d9dd0eb8870d8d9d074bda82e206928bd326161
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/chat_models/zhipuai.py
@@ -0,0 +1,473 @@
+"""ZhipuAI chat models wrapper."""
+
+from __future__ import annotations
+
+import json
+import logging
+import time
+from collections.abc import AsyncIterator, Iterator
+from contextlib import asynccontextmanager, contextmanager
+from typing import Any, Dict, List, Optional, Tuple, Type, Union
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import (
+    BaseChatModel,
+    agenerate_from_stream,
+    generate_from_stream,
+)
+from langchain_core.messages import (
+    AIMessage,
+    AIMessageChunk,
+    BaseMessage,
+    BaseMessageChunk,
+    ChatMessage,
+    ChatMessageChunk,
+    HumanMessage,
+    HumanMessageChunk,
+    SystemMessage,
+    SystemMessageChunk,
+)
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+API_TOKEN_TTL_SECONDS = 3 * 60
+ZHIPUAI_API_BASE = "https://open.bigmodel.cn/api/paas/v4/chat/completions"
+
+
+@contextmanager
+def connect_sse(client: Any, method: str, url: str, **kwargs: Any) -> Iterator:
+    from httpx_sse import EventSource
+
+    with client.stream(method, url, **kwargs) as response:
+        yield EventSource(response)
+
+
+@asynccontextmanager
+async def aconnect_sse(
+    client: Any, method: str, url: str, **kwargs: Any
+) -> AsyncIterator:
+    from httpx_sse import EventSource
+
+    async with client.stream(method, url, **kwargs) as response:
+        yield EventSource(response)
+
+
+def _get_jwt_token(api_key: str) -> str:
+    """Gets JWT token for ZhipuAI API, see 'https://open.bigmodel.cn/dev/api#nosdk'.
+
+    Args:
+        api_key: The API key for ZhipuAI API.
+
+    Returns:
+        The JWT token.
+    """
+    import jwt
+
+    try:
+        id, secret = api_key.split(".")
+    except ValueError as err:
+        raise ValueError(f"Invalid API key: {api_key}") from err
+
+    payload = {
+        "api_key": id,
+        "exp": int(round(time.time() * 1000)) + API_TOKEN_TTL_SECONDS * 1000,
+        "timestamp": int(round(time.time() * 1000)),
+    }
+
+    return jwt.encode(
+        payload,
+        secret,
+        algorithm="HS256",
+        headers={"alg": "HS256", "sign_type": "SIGN"},
+    )
+
+
+def _convert_dict_to_message(dct: Dict[str, Any]) -> BaseMessage:
+    role = dct.get("role")
+    content = dct.get("content", "")
+    if role == "system":
+        return SystemMessage(content=content)
+    if role == "user":
+        return HumanMessage(content=content)
+    if role == "assistant":
+        additional_kwargs = {}
+        tool_calls = dct.get("tool_calls", None)
+        if tool_calls is not None:
+            additional_kwargs["tool_calls"] = tool_calls
+        return AIMessage(content=content, additional_kwargs=additional_kwargs)
+    return ChatMessage(role=role, content=content)
+
+
+def _convert_message_to_dict(message: BaseMessage) -> Dict[str, Any]:
+    """Convert a LangChain message to a dictionary.
+
+    Args:
+        message: The LangChain message.
+
+    Returns:
+        The dictionary.
+    """
+    message_dict: Dict[str, Any]
+    if isinstance(message, ChatMessage):
+        message_dict = {"role": message.role, "content": message.content}
+    elif isinstance(message, SystemMessage):
+        message_dict = {"role": "system", "content": message.content}
+    elif isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+    else:
+        raise TypeError(f"Got unknown type '{message.__class__.__name__}'.")
+    return message_dict
+
+
+def _convert_delta_to_message_chunk(
+    dct: Dict[str, Any], default_class: Type[BaseMessageChunk]
+) -> BaseMessageChunk:
+    role = dct.get("role")
+    content = dct.get("content", "")
+    additional_kwargs = {}
+    tool_calls = dct.get("tool_call", None)
+    if tool_calls is not None:
+        additional_kwargs["tool_calls"] = tool_calls
+
+    if role == "system" or default_class == SystemMessageChunk:
+        return SystemMessageChunk(content=content)
+    if role == "user" or default_class == HumanMessageChunk:
+        return HumanMessageChunk(content=content)
+    if role == "assistant" or default_class == AIMessageChunk:
+        return AIMessageChunk(content=content, additional_kwargs=additional_kwargs)
+    if role or default_class == ChatMessageChunk:
+        return ChatMessageChunk(content=content, role=role)
+    return default_class(content=content)
+
+
+def _truncate_params(payload: Dict[str, Any]) -> None:
+    """Truncate temperature and top_p parameters between [0.01, 0.99].
+
+    ZhipuAI only support temperature / top_p between (0, 1) open interval,
+    so we truncate them to [0.01, 0.99].
+    """
+    temperature = payload.get("temperature")
+    top_p = payload.get("top_p")
+    if temperature is not None:
+        payload["temperature"] = max(0.01, min(0.99, temperature))
+    if top_p is not None:
+        payload["top_p"] = max(0.01, min(0.99, top_p))
+
+
+class ChatZhipuAI(BaseChatModel):
+    """
+    `ZhipuAI` large language chat models API.
+
+    To use, you should have the ``PyJWT`` python package installed.
+
+    Example:
+    .. code-block:: python
+
+    from langchain_community.chat_models import ChatZhipuAI
+
+    zhipuai_chat = ChatZhipuAI(
+        temperature=0.5,
+        api_key="your-api-key",
+        model="glm-4"
+    )
+
+    """
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"zhipuai_api_key": "ZHIPUAI_API_KEY"}
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "chat_models", "zhipuai"]
+
+    @property
+    def lc_attributes(self) -> Dict[str, Any]:
+        attributes: Dict[str, Any] = {}
+
+        if self.zhipuai_api_base:
+            attributes["zhipuai_api_base"] = self.zhipuai_api_base
+
+        return attributes
+
+    @property
+    def _llm_type(self) -> str:
+        """Return the type of chat model."""
+        return "zhipuai-chat"
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling OpenAI API."""
+        params = {
+            "model": self.model_name,
+            "stream": self.streaming,
+            "temperature": self.temperature,
+        }
+        if self.max_tokens is not None:
+            params["max_tokens"] = self.max_tokens
+        return params
+
+    # client:
+    zhipuai_api_key: Optional[str] = Field(default=None, alias="api_key")
+    """Automatically inferred from env var `ZHIPUAI_API_KEY` if not provided."""
+    zhipuai_api_base: Optional[str] = Field(default=None, alias="api_base")
+    """Base URL path for API requests, leave blank if not using a proxy or service
+        emulator.
+    """
+
+    model_name: Optional[str] = Field(default="glm-4", alias="model")
+    """
+    Model name to use, see 'https://open.bigmodel.cn/dev/api#language'.
+    Alternatively, you can use any fine-tuned model from the GLM series.
+    """
+
+    temperature: float = 0.95
+    """
+    What sampling temperature to use. The value ranges from 0.0 to 1.0 and cannot
+    be equal to 0.
+    The larger the value, the more random and creative the output; The smaller
+    the value, the more stable or certain the output will be.
+    You are advised to adjust top_p or temperature parameters based on application
+    scenarios, but do not adjust the two parameters at the same time.
+    """
+
+    top_p: float = 0.7
+    """
+    Another method of sampling temperature is called nuclear sampling. The value
+    ranges from 0.0 to 1.0 and cannot be equal to 0 or 1.
+    The model considers the results with top_p probability quality tokens.
+    For example, 0.1 means that the model decoder only considers tokens from the
+    top 10% probability of the candidate set.
+    You are advised to adjust top_p or temperature parameters based on application
+    scenarios, but do not adjust the two parameters at the same time.
+    """
+
+    streaming: bool = False
+    """Whether to stream the results or not."""
+    max_tokens: Optional[int] = None
+    """Maximum number of tokens to generate."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @root_validator()
+    def validate_environment(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        values["zhipuai_api_key"] = get_from_dict_or_env(
+            values, "zhipuai_api_key", "ZHIPUAI_API_KEY"
+        )
+        values["zhipuai_api_base"] = get_from_dict_or_env(
+            values, "zhipuai_api_base", "ZHIPUAI_API_BASE", default=ZHIPUAI_API_BASE
+        )
+
+        return values
+
+    def _create_message_dicts(
+        self, messages: List[BaseMessage], stop: Optional[List[str]]
+    ) -> Tuple[List[Dict[str, Any]], Dict[str, Any]]:
+        params = self._default_params
+        if stop is not None:
+            params["stop"] = stop
+        message_dicts = [_convert_message_to_dict(m) for m in messages]
+        return message_dicts, params
+
+    def _create_chat_result(self, response: Union[dict, BaseModel]) -> ChatResult:
+        generations = []
+        if not isinstance(response, dict):
+            response = response.dict()
+        for res in response["choices"]:
+            message = _convert_dict_to_message(res["message"])
+            generation_info = dict(finish_reason=res.get("finish_reason"))
+            generations.append(
+                ChatGeneration(message=message, generation_info=generation_info)
+            )
+        token_usage = response.get("usage", {})
+        llm_output = {
+            "token_usage": token_usage,
+            "model_name": self.model_name,
+        }
+        return ChatResult(generations=generations, llm_output=llm_output)
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Generate a chat response."""
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._stream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return generate_from_stream(stream_iter)
+
+        if self.zhipuai_api_key is None:
+            raise ValueError("Did not find zhipuai_api_key.")
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        payload = {
+            **params,
+            **kwargs,
+            "messages": message_dicts,
+            "stream": False,
+        }
+        _truncate_params(payload)
+        headers = {
+            "Authorization": _get_jwt_token(self.zhipuai_api_key),
+            "Accept": "application/json",
+        }
+        import httpx
+
+        with httpx.Client(headers=headers, timeout=60) as client:
+            response = client.post(self.zhipuai_api_base, json=payload)
+            response.raise_for_status()
+        return self._create_chat_result(response.json())
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        """Stream the chat response in chunks."""
+        if self.zhipuai_api_key is None:
+            raise ValueError("Did not find zhipuai_api_key.")
+        if self.zhipuai_api_base is None:
+            raise ValueError("Did not find zhipu_api_base.")
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        payload = {**params, **kwargs, "messages": message_dicts, "stream": True}
+        _truncate_params(payload)
+        headers = {
+            "Authorization": _get_jwt_token(self.zhipuai_api_key),
+            "Accept": "application/json",
+        }
+
+        default_chunk_class = AIMessageChunk
+        import httpx
+
+        with httpx.Client(headers=headers, timeout=60) as client:
+            with connect_sse(
+                client, "POST", self.zhipuai_api_base, json=payload
+            ) as event_source:
+                for sse in event_source.iter_sse():
+                    chunk = json.loads(sse.data)
+                    if len(chunk["choices"]) == 0:
+                        continue
+                    choice = chunk["choices"][0]
+                    chunk = _convert_delta_to_message_chunk(
+                        choice["delta"], default_chunk_class
+                    )
+                    finish_reason = choice.get("finish_reason", None)
+
+                    generation_info = (
+                        {"finish_reason": finish_reason}
+                        if finish_reason is not None
+                        else None
+                    )
+                    chunk = ChatGenerationChunk(
+                        message=chunk, generation_info=generation_info
+                    )
+                    yield chunk
+                    if run_manager:
+                        run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+                    if finish_reason is not None:
+                        break
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            stream_iter = self._astream(
+                messages, stop=stop, run_manager=run_manager, **kwargs
+            )
+            return await agenerate_from_stream(stream_iter)
+
+        if self.zhipuai_api_key is None:
+            raise ValueError("Did not find zhipuai_api_key.")
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        payload = {
+            **params,
+            **kwargs,
+            "messages": message_dicts,
+            "stream": False,
+        }
+        _truncate_params(payload)
+        headers = {
+            "Authorization": _get_jwt_token(self.zhipuai_api_key),
+            "Accept": "application/json",
+        }
+        import httpx
+
+        async with httpx.AsyncClient(headers=headers, timeout=60) as client:
+            response = await client.post(self.zhipuai_api_base, json=payload)
+            response.raise_for_status()
+        return self._create_chat_result(response.json())
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        if self.zhipuai_api_key is None:
+            raise ValueError("Did not find zhipuai_api_key.")
+        if self.zhipuai_api_base is None:
+            raise ValueError("Did not find zhipu_api_base.")
+        message_dicts, params = self._create_message_dicts(messages, stop)
+        payload = {**params, **kwargs, "messages": message_dicts, "stream": True}
+        _truncate_params(payload)
+        headers = {
+            "Authorization": _get_jwt_token(self.zhipuai_api_key),
+            "Accept": "application/json",
+        }
+
+        default_chunk_class = AIMessageChunk
+        import httpx
+
+        async with httpx.AsyncClient(headers=headers, timeout=60) as client:
+            async with aconnect_sse(
+                client, "POST", self.zhipuai_api_base, json=payload
+            ) as event_source:
+                async for sse in event_source.aiter_sse():
+                    chunk = json.loads(sse.data)
+                    if len(chunk["choices"]) == 0:
+                        continue
+                    choice = chunk["choices"][0]
+                    chunk = _convert_delta_to_message_chunk(
+                        choice["delta"], default_chunk_class
+                    )
+                    finish_reason = choice.get("finish_reason", None)
+
+                    generation_info = (
+                        {"finish_reason": finish_reason}
+                        if finish_reason is not None
+                        else None
+                    )
+                    chunk = ChatGenerationChunk(
+                        message=chunk, generation_info=generation_info
+                    )
+                    yield chunk
+                    if run_manager:
+                        await run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+                    if finish_reason is not None:
+                        break
diff --git a/llm/Lib/site-packages/langchain_community/cross_encoders/__init__.py b/llm/Lib/site-packages/langchain_community/cross_encoders/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f6b64a86e8a0407a0b7ea3f7053d16c5f49abc00
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/cross_encoders/__init__.py
@@ -0,0 +1,48 @@
+"""**Cross encoders** are wrappers around cross encoder models from different APIs and
+    services.
+
+**Cross encoder models** can be LLMs or not.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseCrossEncoder --> <name>CrossEncoder  # Examples: SagemakerEndpointCrossEncoder
+"""
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.cross_encoders.base import (
+        BaseCrossEncoder,  # noqa: F401
+    )
+    from langchain_community.cross_encoders.fake import (
+        FakeCrossEncoder,  # noqa: F401
+    )
+    from langchain_community.cross_encoders.huggingface import (
+        HuggingFaceCrossEncoder,  # noqa: F401
+    )
+    from langchain_community.cross_encoders.sagemaker_endpoint import (
+        SagemakerEndpointCrossEncoder,  # noqa: F401
+    )
+
+__all__ = [
+    "BaseCrossEncoder",
+    "FakeCrossEncoder",
+    "HuggingFaceCrossEncoder",
+    "SagemakerEndpointCrossEncoder",
+]
+
+_module_lookup = {
+    "BaseCrossEncoder": "langchain_community.cross_encoders.base",
+    "FakeCrossEncoder": "langchain_community.cross_encoders.fake",
+    "HuggingFaceCrossEncoder": "langchain_community.cross_encoders.huggingface",
+    "SagemakerEndpointCrossEncoder": "langchain_community.cross_encoders.sagemaker_endpoint",  # noqa: E501
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
diff --git a/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..079bb3af16ba288c89ade8b5a4255d1fc784427a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..755abdc0b2c3d65cceeecc93d2df2979aace8189
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/fake.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/fake.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..22960844fddb06aab874a997a7a7e95eafcd2c62
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/fake.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/huggingface.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/huggingface.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..53e2899ea9cfaefbe227756f811017b33a6ca837
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/huggingface.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/sagemaker_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/sagemaker_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ceaa70f510cd2a8fb37c59ad194cdba287d1e6e3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/cross_encoders/__pycache__/sagemaker_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/cross_encoders/base.py b/llm/Lib/site-packages/langchain_community/cross_encoders/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..98fa0568980fca2251a7752d3708e86c4ea2aa42
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/cross_encoders/base.py
@@ -0,0 +1,17 @@
+from abc import ABC, abstractmethod
+from typing import List, Tuple
+
+
+class BaseCrossEncoder(ABC):
+    """Interface for cross encoder models."""
+
+    @abstractmethod
+    def score(self, text_pairs: List[Tuple[str, str]]) -> List[float]:
+        """Score pairs' similarity.
+
+        Args:
+            text_pairs: List of pairs of texts.
+
+        Returns:
+            List of scores.
+        """
diff --git a/llm/Lib/site-packages/langchain_community/cross_encoders/fake.py b/llm/Lib/site-packages/langchain_community/cross_encoders/fake.py
new file mode 100644
index 0000000000000000000000000000000000000000..91e1f702d8c8ade796ae3b18da56ab638a3e504e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/cross_encoders/fake.py
@@ -0,0 +1,18 @@
+from difflib import SequenceMatcher
+from typing import List, Tuple
+
+from langchain_core.pydantic_v1 import BaseModel
+
+from langchain_community.cross_encoders.base import BaseCrossEncoder
+
+
+class FakeCrossEncoder(BaseCrossEncoder, BaseModel):
+    """Fake cross encoder model."""
+
+    def score(self, text_pairs: List[Tuple[str, str]]) -> List[float]:
+        scores = list(
+            map(
+                lambda pair: SequenceMatcher(None, pair[0], pair[1]).ratio(), text_pairs
+            )
+        )
+        return scores
diff --git a/llm/Lib/site-packages/langchain_community/cross_encoders/huggingface.py b/llm/Lib/site-packages/langchain_community/cross_encoders/huggingface.py
new file mode 100644
index 0000000000000000000000000000000000000000..6cfbceff7a6d4fed3cbc85bf18a625d6716b32a5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/cross_encoders/huggingface.py
@@ -0,0 +1,63 @@
+from typing import Any, Dict, List, Tuple
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field
+
+from langchain_community.cross_encoders.base import BaseCrossEncoder
+
+DEFAULT_MODEL_NAME = "BAAI/bge-reranker-base"
+
+
+class HuggingFaceCrossEncoder(BaseModel, BaseCrossEncoder):
+    """HuggingFace cross encoder models.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.cross_encoders import HuggingFaceCrossEncoder
+
+            model_name = "BAAI/bge-reranker-base"
+            model_kwargs = {'device': 'cpu'}
+            hf = HuggingFaceCrossEncoder(
+                model_name=model_name,
+                model_kwargs=model_kwargs
+            )
+    """
+
+    client: Any  #: :meta private:
+    model_name: str = DEFAULT_MODEL_NAME
+    """Model name to use."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Keyword arguments to pass to the model."""
+
+    def __init__(self, **kwargs: Any):
+        """Initialize the sentence_transformer."""
+        super().__init__(**kwargs)
+        try:
+            import sentence_transformers
+
+        except ImportError as exc:
+            raise ImportError(
+                "Could not import sentence_transformers python package. "
+                "Please install it with `pip install sentence-transformers`."
+            ) from exc
+
+        self.client = sentence_transformers.CrossEncoder(
+            self.model_name, **self.model_kwargs
+        )
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def score(self, text_pairs: List[Tuple[str, str]]) -> List[float]:
+        """Compute similarity scores using a HuggingFace transformer model.
+
+        Args:
+            text_pairs: The list of text text_pairs to score the similarity.
+
+        Returns:
+            List of scores, one for each pair.
+        """
+        scores = self.client.predict(text_pairs)
+        return scores
diff --git a/llm/Lib/site-packages/langchain_community/cross_encoders/sagemaker_endpoint.py b/llm/Lib/site-packages/langchain_community/cross_encoders/sagemaker_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..20d6b85c6a0b11dc5367cfe6ff07a20d98c3d378
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/cross_encoders/sagemaker_endpoint.py
@@ -0,0 +1,151 @@
+import json
+from typing import Any, Dict, List, Optional, Tuple
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+from langchain_community.cross_encoders.base import BaseCrossEncoder
+
+
+class CrossEncoderContentHandler:
+    """Content handler for CrossEncoder class."""
+
+    content_type = "application/json"
+    accepts = "application/json"
+
+    def transform_input(self, text_pairs: List[Tuple[str, str]]) -> bytes:
+        input_str = json.dumps({"text_pairs": text_pairs})
+        return input_str.encode("utf-8")
+
+    def transform_output(self, output: Any) -> List[float]:
+        response_json = json.loads(output.read().decode("utf-8"))
+        scores = response_json["scores"]
+        return scores
+
+
+class SagemakerEndpointCrossEncoder(BaseModel, BaseCrossEncoder):
+    """SageMaker Inference CrossEncoder endpoint.
+
+    To use, you must supply the endpoint name from your deployed
+    Sagemaker model & the region where it is deployed.
+
+    To authenticate, the AWS client uses the following methods to
+    automatically load credentials:
+    https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html
+
+    If a specific credential profile should be used, you must pass
+    the name of the profile from the ~/.aws/credentials file that is to be used.
+
+    Make sure the credentials / roles used have the required policies to
+    access the Sagemaker endpoint.
+    See: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html
+    """
+
+    """
+   Example:
+       .. code-block:: python
+
+
+           from langchain.embeddings import SagemakerEndpointCrossEncoder
+           endpoint_name = (
+               "my-endpoint-name"
+           )
+           region_name = (
+               "us-west-2"
+           )
+           credentials_profile_name = (
+               "default"
+           )
+           se = SagemakerEndpointCrossEncoder(
+               endpoint_name=endpoint_name,
+               region_name=region_name,
+               credentials_profile_name=credentials_profile_name
+           )
+   """
+    client: Any  #: :meta private:
+
+    endpoint_name: str = ""
+    """The name of the endpoint from the deployed Sagemaker model.
+   Must be unique within an AWS Region."""
+
+    region_name: str = ""
+    """The aws region where the Sagemaker model is deployed, eg. `us-west-2`."""
+
+    credentials_profile_name: Optional[str] = None
+    """The name of the profile in the ~/.aws/credentials or ~/.aws/config files, which
+   has either access keys or role information specified.
+   If not specified, the default credential profile or, if on an EC2 instance,
+   credentials from IMDS will be used.
+   See: https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html
+   """
+
+    content_handler: CrossEncoderContentHandler = CrossEncoderContentHandler()
+
+    model_kwargs: Optional[Dict] = None
+    """Keyword arguments to pass to the model."""
+
+    endpoint_kwargs: Optional[Dict] = None
+    """Optional attributes passed to the invoke_endpoint
+   function. See `boto3`_. docs for more info.
+   .. _boto3: <https://boto3.amazonaws.com/v1/documentation/api/latest/index.html>
+   """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that AWS credentials to and python package exists in environment."""
+        try:
+            import boto3
+
+            try:
+                if values["credentials_profile_name"] is not None:
+                    session = boto3.Session(
+                        profile_name=values["credentials_profile_name"]
+                    )
+                else:
+                    # use default credentials
+                    session = boto3.Session()
+
+                values["client"] = session.client(
+                    "sagemaker-runtime", region_name=values["region_name"]
+                )
+
+            except Exception as e:
+                raise ValueError(
+                    "Could not load credentials to authenticate with AWS client. "
+                    "Please check that credentials in the specified "
+                    "profile name are valid."
+                ) from e
+
+        except ImportError:
+            raise ImportError(
+                "Could not import boto3 python package. "
+                "Please install it with `pip install boto3`."
+            )
+        return values
+
+    def score(self, text_pairs: List[Tuple[str, str]]) -> List[float]:
+        """Call out to SageMaker Inference CrossEncoder endpoint."""
+        _endpoint_kwargs = self.endpoint_kwargs or {}
+
+        body = self.content_handler.transform_input(text_pairs)
+        content_type = self.content_handler.content_type
+        accepts = self.content_handler.accepts
+
+        # send request
+        try:
+            response = self.client.invoke_endpoint(
+                EndpointName=self.endpoint_name,
+                Body=body,
+                ContentType=content_type,
+                Accept=accepts,
+                **_endpoint_kwargs,
+            )
+        except Exception as e:
+            raise ValueError(f"Error raised by inference endpoint: {e}")
+
+        return self.content_handler.transform_output(response["Body"])
diff --git a/llm/Lib/site-packages/langchain_community/docstore/__init__.py b/llm/Lib/site-packages/langchain_community/docstore/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2da87b2aabd9528c691e92ddb6f08c0e2cccac22
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/docstore/__init__.py
@@ -0,0 +1,48 @@
+"""**Docstores** are classes to store and load Documents.
+
+The **Docstore** is a simplified version of the Document Loader.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    Docstore --> <name> # Examples: InMemoryDocstore, Wikipedia
+
+**Main helpers:**
+
+.. code-block::
+
+    Document, AddableMixin
+"""
+
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.docstore.arbitrary_fn import (
+        DocstoreFn,  # noqa: F401
+    )
+    from langchain_community.docstore.in_memory import (
+        InMemoryDocstore,  # noqa: F401
+    )
+    from langchain_community.docstore.wikipedia import (
+        Wikipedia,  # noqa: F401
+    )
+
+__all__ = ["DocstoreFn", "InMemoryDocstore", "Wikipedia"]
+
+_module_lookup = {
+    "DocstoreFn": "langchain_community.docstore.arbitrary_fn",
+    "InMemoryDocstore": "langchain_community.docstore.in_memory",
+    "Wikipedia": "langchain_community.docstore.wikipedia",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/docstore/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/docstore/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b14dc23c6ea5c3c8eb30944b7d5193f294aa7f21
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/docstore/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/docstore/__pycache__/arbitrary_fn.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/docstore/__pycache__/arbitrary_fn.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..703063ba22e0b1ee924966f6d30657976738b5d5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/docstore/__pycache__/arbitrary_fn.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/docstore/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/docstore/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..27ebef846e62e8be16f4fa61d5db53dea308b119
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/docstore/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/docstore/__pycache__/document.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/docstore/__pycache__/document.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cc71f267bc277c05f01eb0152d46c9b8005e80e6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/docstore/__pycache__/document.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/docstore/__pycache__/in_memory.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/docstore/__pycache__/in_memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..35d630003c0c5ef70acd91d2ae8c8ac78b3d67fd
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/docstore/__pycache__/in_memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/docstore/__pycache__/wikipedia.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/docstore/__pycache__/wikipedia.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7d670c8520a64db849b640c921c2ef98101d9ee7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/docstore/__pycache__/wikipedia.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/docstore/arbitrary_fn.py b/llm/Lib/site-packages/langchain_community/docstore/arbitrary_fn.py
new file mode 100644
index 0000000000000000000000000000000000000000..a2eba5ddafda3c2ef5209228e705af3ea164fc88
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/docstore/arbitrary_fn.py
@@ -0,0 +1,38 @@
+from typing import Callable, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.docstore.base import Docstore
+
+
+class DocstoreFn(Docstore):
+    """Docstore via arbitrary lookup function.
+
+    This is useful when:
+     * it's expensive to construct an InMemoryDocstore/dict
+     * you retrieve documents from remote sources
+     * you just want to reuse existing objects
+    """
+
+    def __init__(
+        self,
+        lookup_fn: Callable[[str], Union[Document, str]],
+    ):
+        self._lookup_fn = lookup_fn
+
+    def search(self, search: str) -> Document:
+        """Search for a document.
+
+        Args:
+            search: search string
+
+        Returns:
+            Document if found, else error message.
+        """
+        r = self._lookup_fn(search)
+        if isinstance(r, str):
+            # NOTE: assume the search string is the source ID
+            return Document(page_content=r, metadata={"source": search})
+        elif isinstance(r, Document):
+            return r
+        raise ValueError(f"Unexpected type of document {type(r)}")
diff --git a/llm/Lib/site-packages/langchain_community/docstore/base.py b/llm/Lib/site-packages/langchain_community/docstore/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..709c443f01f8e87e86f89bf996d85a0785cdb7d9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/docstore/base.py
@@ -0,0 +1,29 @@
+"""Interface to access to place that stores documents."""
+from abc import ABC, abstractmethod
+from typing import Dict, List, Union
+
+from langchain_core.documents import Document
+
+
+class Docstore(ABC):
+    """Interface to access to place that stores documents."""
+
+    @abstractmethod
+    def search(self, search: str) -> Union[str, Document]:
+        """Search for document.
+
+        If page exists, return the page summary, and a Document object.
+        If page does not exist, return similar entries.
+        """
+
+    def delete(self, ids: List) -> None:
+        """Deleting IDs from in memory dictionary."""
+        raise NotImplementedError
+
+
+class AddableMixin(ABC):
+    """Mixin class that supports adding texts."""
+
+    @abstractmethod
+    def add(self, texts: Dict[str, Document]) -> None:
+        """Add more documents."""
diff --git a/llm/Lib/site-packages/langchain_community/docstore/document.py b/llm/Lib/site-packages/langchain_community/docstore/document.py
new file mode 100644
index 0000000000000000000000000000000000000000..88aebd279509aa19084281e0a84e647ee39b1849
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/docstore/document.py
@@ -0,0 +1,3 @@
+from langchain_core.documents import Document
+
+__all__ = ["Document"]
diff --git a/llm/Lib/site-packages/langchain_community/docstore/in_memory.py b/llm/Lib/site-packages/langchain_community/docstore/in_memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..a52204d0b8fc732c384fc6410b2cff2cf99a2ff4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/docstore/in_memory.py
@@ -0,0 +1,50 @@
+"""Simple in memory docstore in the form of a dict."""
+from typing import Dict, List, Optional, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.docstore.base import AddableMixin, Docstore
+
+
+class InMemoryDocstore(Docstore, AddableMixin):
+    """Simple in memory docstore in the form of a dict."""
+
+    def __init__(self, _dict: Optional[Dict[str, Document]] = None):
+        """Initialize with dict."""
+        self._dict = _dict if _dict is not None else {}
+
+    def add(self, texts: Dict[str, Document]) -> None:
+        """Add texts to in memory dictionary.
+
+        Args:
+            texts: dictionary of id -> document.
+
+        Returns:
+            None
+        """
+        overlapping = set(texts).intersection(self._dict)
+        if overlapping:
+            raise ValueError(f"Tried to add ids that already exist: {overlapping}")
+        self._dict = {**self._dict, **texts}
+
+    def delete(self, ids: List) -> None:
+        """Deleting IDs from in memory dictionary."""
+        overlapping = set(ids).intersection(self._dict)
+        if not overlapping:
+            raise ValueError(f"Tried to delete ids that does not  exist: {ids}")
+        for _id in ids:
+            self._dict.pop(_id)
+
+    def search(self, search: str) -> Union[str, Document]:
+        """Search via direct lookup.
+
+        Args:
+            search: id of a document to search for.
+
+        Returns:
+            Document if found, else error message.
+        """
+        if search not in self._dict:
+            return f"ID {search} not found."
+        else:
+            return self._dict[search]
diff --git a/llm/Lib/site-packages/langchain_community/docstore/wikipedia.py b/llm/Lib/site-packages/langchain_community/docstore/wikipedia.py
new file mode 100644
index 0000000000000000000000000000000000000000..5f09b3e0c00afcb777f8c859efe9cfb8f1839d01
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/docstore/wikipedia.py
@@ -0,0 +1,47 @@
+"""Wrapper around wikipedia API."""
+
+
+from typing import Union
+
+from langchain_core.documents import Document
+
+from langchain_community.docstore.base import Docstore
+
+
+class Wikipedia(Docstore):
+    """Wikipedia API."""
+
+    def __init__(self) -> None:
+        """Check that wikipedia package is installed."""
+        try:
+            import wikipedia  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "Could not import wikipedia python package. "
+                "Please install it with `pip install wikipedia`."
+            )
+
+    def search(self, search: str) -> Union[str, Document]:
+        """Try to search for wiki page.
+
+        If page exists, return the page summary, and a PageWithLookups object.
+        If page does not exist, return similar entries.
+
+        Args:
+            search: search string.
+
+        Returns: a Document object or error message.
+        """
+        import wikipedia
+
+        try:
+            page_content = wikipedia.page(search).content
+            url = wikipedia.page(search).url
+            result: Union[str, Document] = Document(
+                page_content=page_content, metadata={"page": url}
+            )
+        except wikipedia.PageError:
+            result = f"Could not find [{search}]. Similar: {wikipedia.search(search)}"
+        except wikipedia.DisambiguationError:
+            result = f"Could not find [{search}]. Similar: {wikipedia.search(search)}"
+        return result
diff --git a/llm/Lib/site-packages/langchain_community/document_compressors/__init__.py b/llm/Lib/site-packages/langchain_community/document_compressors/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b7cb93e9429a8441fe7d2253f48d2c964ff5e8b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_compressors/__init__.py
@@ -0,0 +1,27 @@
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.document_compressors.llmlingua_filter import (
+        LLMLinguaCompressor,  # noqa: F401
+    )
+    from langchain_community.document_compressors.openvino_rerank import (
+        OpenVINOReranker,  # noqa: F401
+    )
+
+__all__ = ["LLMLinguaCompressor", "OpenVINOReranker"]
+
+_module_lookup = {
+    "LLMLinguaCompressor": "langchain_community.document_compressors.llmlingua_filter",
+    "OpenVINOReranker": "langchain_community.document_compressors.openvino_rerank",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/document_compressors/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_compressors/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..717aa9a5792ff3d9b879ac5065f23380d2865c6f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_compressors/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_compressors/__pycache__/llmlingua_filter.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_compressors/__pycache__/llmlingua_filter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c5b2035baf971c034dcbef57e0a6bf846157a388
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_compressors/__pycache__/llmlingua_filter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_compressors/__pycache__/openvino_rerank.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_compressors/__pycache__/openvino_rerank.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..296165c95754cb1f2b6e546d43dca7b9346e714d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_compressors/__pycache__/openvino_rerank.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_compressors/llmlingua_filter.py b/llm/Lib/site-packages/langchain_community/document_compressors/llmlingua_filter.py
new file mode 100644
index 0000000000000000000000000000000000000000..8a5dbf02ebdfa8594ceb13db23ed6703d6239770
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_compressors/llmlingua_filter.py
@@ -0,0 +1,185 @@
+# LLM Lingua Document Compressor
+
+import re
+from typing import Any, Dict, List, Optional, Sequence, Tuple
+
+from langchain_core.callbacks import Callbacks
+from langchain_core.documents import Document
+from langchain_core.documents.compressor import (
+    BaseDocumentCompressor,
+)
+from langchain_core.pydantic_v1 import root_validator
+
+DEFAULT_LLM_LINGUA_INSTRUCTION = (
+    "Given this documents, please answer the final question"
+)
+
+
+class LLMLinguaCompressor(BaseDocumentCompressor):
+    """
+    Compress using LLMLingua Project.
+
+    https://github.com/microsoft/LLMLingua
+    """
+
+    # Pattern to match ref tags at the beginning or end of the string,
+    # allowing for malformed tags
+    _pattern_beginning = re.compile(r"\A(?:<#)?(?:ref)?(\d+)(?:#>?)?")
+    _pattern_ending = re.compile(r"(?:<#)?(?:ref)?(\d+)(?:#>?)?\Z")
+
+    model_name: str = "NousResearch/Llama-2-7b-hf"
+    """The hugging face model to use"""
+    device_map: str = "cuda"
+    """The device to use for llm lingua"""
+    target_token: int = 300
+    """The target number of compressed tokens"""
+    rank_method: str = "longllmlingua"
+    """The ranking method to use"""
+    model_config: dict = {}
+    """Custom configuration for the model"""
+    open_api_config: dict = {}
+    """open_api configuration"""
+    instruction: str = DEFAULT_LLM_LINGUA_INSTRUCTION
+    """The instruction for the LLM"""
+    additional_compress_kwargs: dict = {
+        "condition_compare": True,
+        "condition_in_question": "after",
+        "context_budget": "+100",
+        "reorder_context": "sort",
+        "dynamic_context_compression_ratio": 0.4,
+    }
+    """Extra compression arguments"""
+    lingua: Any
+    """The instance of the llm linqua"""
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in environment."""
+        try:
+            from llmlingua import PromptCompressor
+        except ImportError:
+            raise ImportError(
+                "Could not import llmlingua python package. "
+                "Please install it with `pip install llmlingua`."
+            )
+        if not values.get("lingua"):
+            values["lingua"] = PromptCompressor(
+                model_name=values.get("model_name", {}),
+                device_map=values.get("device_map", {}),
+                model_config=values.get("model_config", {}),
+                open_api_config=values.get("open_api_config", {}),
+            )
+        return values
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = "forbid"
+        arbitrary_types_allowed = True
+
+    @staticmethod
+    def _format_context(docs: Sequence[Document]) -> List[str]:
+        """
+        Format the output of the retriever by including
+        special ref tags for tracking the metadata after compression
+        """
+        formatted_docs = []
+        for i, doc in enumerate(docs):
+            content = doc.page_content.replace("\n\n", "\n")
+            doc_string = f"\n\n<#ref{i}#> {content} <#ref{i}#>\n\n"
+            formatted_docs.append(doc_string)
+        return formatted_docs
+
+    def extract_ref_id_tuples_and_clean(
+        self, contents: List[str]
+    ) -> List[Tuple[str, int]]:
+        """
+        Extracts reference IDs from the contents and cleans up the ref tags.
+
+        This function processes a list of strings, searching for reference ID tags
+        at the beginning and end of each string. When a ref tag is found, it is
+        removed from the string, and its ID is recorded. If no ref ID is found,
+        a generic ID of "-1" is assigned.
+
+        The search for ref tags is performed only at the beginning and
+        end of the string, with the assumption that there will
+        be at most one ref ID per string. Malformed ref tags are
+        handled gracefully.
+
+        Args:
+            contents (List[str]): A list of contents to be processed.
+
+        Returns:
+            List[Tuple[str, int]]: The cleaned string and the associated ref ID.
+
+        Examples:
+            >>> strings_list = [
+                    '<#ref0#> Example content <#ref0#>',
+                    'Content with no ref ID.'
+                ]
+            >>> extract_ref_id_tuples_and_clean(strings_list)
+            [('Example content', 0), ('Content with no ref ID.', -1)]
+        """
+        ref_id_tuples = []
+        for content in contents:
+            clean_string = content.strip()
+            if not clean_string:
+                continue
+
+            # Search for ref tags at the beginning and the end of the string
+            ref_id = None
+            for pattern in [self._pattern_beginning, self._pattern_ending]:
+                match = pattern.search(clean_string)
+                if match:
+                    ref_id = match.group(1)
+                    clean_string = pattern.sub("", clean_string).strip()
+            # Convert ref ID to int or use -1 if not found
+            ref_id_to_use = int(ref_id) if ref_id and ref_id.isdigit() else -1
+            ref_id_tuples.append((clean_string, ref_id_to_use))
+
+        return ref_id_tuples
+
+    def compress_documents(
+        self,
+        documents: Sequence[Document],
+        query: str,
+        callbacks: Optional[Callbacks] = None,
+    ) -> Sequence[Document]:
+        """
+        Compress documents using BAAI/bge-reranker models.
+
+        Args:
+            documents: A sequence of documents to compress.
+            query: The query to use for compressing the documents.
+            callbacks: Callbacks to run during the compression process.
+
+        Returns:
+            A sequence of compressed documents.
+        """
+        if len(documents) == 0:  # to avoid empty api call
+            return []
+
+        compressed_prompt = self.lingua.compress_prompt(
+            context=self._format_context(documents),
+            instruction=self.instruction,
+            question=query,
+            target_token=self.target_token,
+            rank_method=self.rank_method,
+            concate_question=False,
+            add_instruction=True,
+            **self.additional_compress_kwargs,
+        )
+        compreseed_context = compressed_prompt["compressed_prompt"].split("\n\n")[1:]
+
+        extracted_metadata = self.extract_ref_id_tuples_and_clean(compreseed_context)
+
+        compressed_docs: List[Document] = []
+
+        for context, index in extracted_metadata:
+            if index == -1 or index >= len(documents):
+                doc = Document(page_content=context)
+            else:
+                doc = Document(page_content=context, metadata=documents[index].metadata)
+            compressed_docs.append(doc)
+
+        return compressed_docs
diff --git a/llm/Lib/site-packages/langchain_community/document_compressors/openvino_rerank.py b/llm/Lib/site-packages/langchain_community/document_compressors/openvino_rerank.py
new file mode 100644
index 0000000000000000000000000000000000000000..98c580e889f540f1f00ffdb5b9ef3bde54266ab5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_compressors/openvino_rerank.py
@@ -0,0 +1,166 @@
+from pathlib import Path
+from typing import Any, Dict, Optional, Sequence
+
+import numpy as np
+from langchain_core.callbacks import Callbacks
+from langchain_core.documents import Document
+from langchain_core.documents.compressor import BaseDocumentCompressor
+from langchain_core.pydantic_v1 import Field
+
+
+class RerankRequest:
+    """Request for reranking."""
+
+    def __init__(self, query: Any = None, passages: Any = None):
+        self.query = query
+        self.passages = passages if passages is not None else []
+
+
+class OpenVINOReranker(BaseDocumentCompressor):
+    """
+    OpenVINO rerank models.
+    """
+
+    ov_model: Any
+    """OpenVINO model object."""
+    tokenizer: Any
+    """Tokenizer for embedding model."""
+    model_name_or_path: str
+    """HuggingFace model id."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Keyword arguments passed to the model."""
+    top_n: int = 4
+    """return Top n texts."""
+
+    def __init__(self, **kwargs: Any):
+        super().__init__(**kwargs)
+
+        try:
+            from optimum.intel.openvino import OVModelForSequenceClassification
+        except ImportError as e:
+            raise ValueError(
+                "Could not import optimum-intel python package. "
+                "Please install it with: "
+                "pip install -U 'optimum[openvino,nncf]'"
+            ) from e
+
+        try:
+            from huggingface_hub import HfApi
+        except ImportError as e:
+            raise ValueError(
+                "Could not import huggingface_hub python package. "
+                "Please install it with: "
+                "`pip install -U huggingface_hub`."
+            ) from e
+
+        def require_model_export(
+            model_id: str, revision: Any = None, subfolder: Any = None
+        ) -> bool:
+            model_dir = Path(model_id)
+            if subfolder is not None:
+                model_dir = model_dir / subfolder
+            if model_dir.is_dir():
+                return (
+                    not (model_dir / "openvino_model.xml").exists()
+                    or not (model_dir / "openvino_model.bin").exists()
+                )
+            hf_api = HfApi()
+            try:
+                model_info = hf_api.model_info(model_id, revision=revision or "main")
+                normalized_subfolder = (
+                    None if subfolder is None else Path(subfolder).as_posix()
+                )
+                model_files = [
+                    file.rfilename
+                    for file in model_info.siblings
+                    if normalized_subfolder is None
+                    or file.rfilename.startswith(normalized_subfolder)
+                ]
+                ov_model_path = (
+                    "openvino_model.xml"
+                    if subfolder is None
+                    else f"{normalized_subfolder}/openvino_model.xml"
+                )
+                return (
+                    ov_model_path not in model_files
+                    or ov_model_path.replace(".xml", ".bin") not in model_files
+                )
+            except Exception:
+                return True
+
+        if require_model_export(self.model_name_or_path):
+            # use remote model
+            self.ov_model = OVModelForSequenceClassification.from_pretrained(
+                self.model_name_or_path, export=True, **self.model_kwargs
+            )
+        else:
+            # use local model
+            self.ov_model = OVModelForSequenceClassification.from_pretrained(
+                self.model_name_or_path, **self.model_kwargs
+            )
+
+        try:
+            from transformers import AutoTokenizer
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import transformers, please install with "
+                "`pip install -U transformers`."
+            ) from e
+
+        self.tokenizer = AutoTokenizer.from_pretrained(self.model_name_or_path)
+
+    def rerank(self, request: Any) -> Any:
+        query = request.query
+        passages = request.passages
+
+        query_passage_pairs = [[query, passage["text"]] for passage in passages]
+        input_tensors = self.tokenizer(
+            query_passage_pairs, padding=True, truncation=True, return_tensors="pt"
+        )
+
+        outputs = self.ov_model(**input_tensors, return_dict=True)
+        if outputs[0].shape[1] > 1:
+            scores = outputs[0][:, 1]
+        else:
+            scores = outputs[0].flatten()
+
+        scores = list(1 / (1 + np.exp(-scores)))
+
+        # Combine scores with passages, including metadata
+        for score, passage in zip(scores, passages):
+            passage["score"] = score
+
+        # Sort passages based on scores
+        passages.sort(key=lambda x: x["score"], reverse=True)
+
+        return passages
+
+    def compress_documents(
+        self,
+        documents: Sequence[Document],
+        query: str,
+        callbacks: Optional[Callbacks] = None,
+    ) -> Sequence[Document]:
+        passages = [
+            {"id": i, "text": doc.page_content} for i, doc in enumerate(documents)
+        ]
+
+        rerank_request = RerankRequest(query=query, passages=passages)
+        rerank_response = self.rerank(rerank_request)[: self.top_n]
+        final_results = []
+        for r in rerank_response:
+            doc = Document(
+                page_content=r["text"],
+                metadata={"id": r["id"], "relevance_score": r["score"]},
+            )
+            final_results.append(doc)
+        return final_results
+
+    def save_model(
+        self,
+        model_path: str,
+    ) -> bool:
+        self.ov_model.half()
+        self.ov_model.save_pretrained(model_path)
+        self.tokenizer.save_pretrained(model_path)
+        return True
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/acreom.py b/llm/Lib/site-packages/langchain_community/document_loaders/acreom.py
new file mode 100644
index 0000000000000000000000000000000000000000..89aff5d17318a26e77c279eb6e4a83a58d4d4798
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/acreom.py
@@ -0,0 +1,79 @@
+import re
+from pathlib import Path
+from typing import Iterator, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class AcreomLoader(BaseLoader):
+    """Load `acreom` vault from a directory."""
+
+    FRONT_MATTER_REGEX = re.compile(r"^---\n(.*?)\n---\n", re.MULTILINE | re.DOTALL)
+    """Regex to match front matter metadata in markdown files."""
+
+    def __init__(
+        self,
+        path: Union[str, Path],
+        encoding: str = "UTF-8",
+        collect_metadata: bool = True,
+    ):
+        """Initialize the loader."""
+        self.file_path = path
+        """Path to the directory containing the markdown files."""
+        self.encoding = encoding
+        """Encoding to use when reading the files."""
+        self.collect_metadata = collect_metadata
+        """Whether to collect metadata from the front matter."""
+
+    def _parse_front_matter(self, content: str) -> dict:
+        """Parse front matter metadata from the content and return it as a dict."""
+        if not self.collect_metadata:
+            return {}
+        match = self.FRONT_MATTER_REGEX.search(content)
+        front_matter = {}
+        if match:
+            lines = match.group(1).split("\n")
+            for line in lines:
+                if ":" in line:
+                    key, value = line.split(":", 1)
+                    front_matter[key.strip()] = value.strip()
+                else:
+                    # Skip lines without a colon
+                    continue
+        return front_matter
+
+    def _remove_front_matter(self, content: str) -> str:
+        """Remove front matter metadata from the given content."""
+        if not self.collect_metadata:
+            return content
+        return self.FRONT_MATTER_REGEX.sub("", content)
+
+    def _process_acreom_content(self, content: str) -> str:
+        # remove acreom specific elements from content that
+        # do not contribute to the context of current document
+        content = re.sub(r"\s*-\s\[\s\]\s.*|\s*\[\s\]\s.*", "", content)  # rm tasks
+        content = re.sub(r"#", "", content)  # rm hashtags
+        content = re.sub(r"\[\[.*?\]\]", "", content)  # rm doclinks
+        return content
+
+    def lazy_load(self) -> Iterator[Document]:
+        ps = list(Path(self.file_path).glob("**/*.md"))
+
+        for p in ps:
+            with open(p, encoding=self.encoding) as f:
+                text = f.read()
+
+            front_matter = self._parse_front_matter(text)
+            text = self._remove_front_matter(text)
+
+            text = self._process_acreom_content(text)
+
+            metadata = {
+                "source": str(p.name),
+                "path": str(p),
+                **front_matter,
+            }
+
+            yield Document(page_content=text, metadata=metadata)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/airbyte.py b/llm/Lib/site-packages/langchain_community/document_loaders/airbyte.py
new file mode 100644
index 0000000000000000000000000000000000000000..323c37fc35df36c74e4e35d8fa9986d05b6dc67e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/airbyte.py
@@ -0,0 +1,287 @@
+from typing import Any, Callable, Iterator, Mapping, Optional
+
+from langchain_core.documents import Document
+from langchain_core.utils.utils import guard_import
+
+from langchain_community.document_loaders.base import BaseLoader
+
+RecordHandler = Callable[[Any, Optional[str]], Document]
+
+
+class AirbyteCDKLoader(BaseLoader):
+    """Load with an `Airbyte` source connector implemented using the `CDK`."""
+
+    def __init__(
+        self,
+        config: Mapping[str, Any],
+        source_class: Any,
+        stream_name: str,
+        record_handler: Optional[RecordHandler] = None,
+        state: Optional[Any] = None,
+    ) -> None:
+        """Initializes the loader.
+
+        Args:
+            config: The config to pass to the source connector.
+            source_class: The source connector class.
+            stream_name: The name of the stream to load.
+            record_handler: A function that takes in a record and an optional id and
+                returns a Document. If None, the record will be used as the document.
+                Defaults to None.
+            state: The state to pass to the source connector. Defaults to None.
+        """
+        from airbyte_cdk.models.airbyte_protocol import AirbyteRecordMessage
+        from airbyte_cdk.sources.embedded.base_integration import (
+            BaseEmbeddedIntegration,
+        )
+        from airbyte_cdk.sources.embedded.runner import CDKRunner
+
+        class CDKIntegration(BaseEmbeddedIntegration):
+            """A wrapper around the CDK integration."""
+
+            def _handle_record(
+                self, record: AirbyteRecordMessage, id: Optional[str]
+            ) -> Document:
+                if record_handler:
+                    return record_handler(record, id)
+                return Document(page_content="", metadata=record.data)
+
+        self._integration = CDKIntegration(
+            config=config,
+            runner=CDKRunner(source=source_class(), name=source_class.__name__),
+        )
+        self._stream_name = stream_name
+        self._state = state
+
+    def lazy_load(self) -> Iterator[Document]:
+        return self._integration._load_data(
+            stream_name=self._stream_name, state=self._state
+        )
+
+    @property
+    def last_state(self) -> Any:
+        return self._integration.last_state
+
+
+class AirbyteHubspotLoader(AirbyteCDKLoader):
+    """Load from `Hubspot` using an `Airbyte` source connector."""
+
+    def __init__(
+        self,
+        config: Mapping[str, Any],
+        stream_name: str,
+        record_handler: Optional[RecordHandler] = None,
+        state: Optional[Any] = None,
+    ) -> None:
+        """Initializes the loader.
+
+        Args:
+            config: The config to pass to the source connector.
+            stream_name: The name of the stream to load.
+            record_handler: A function that takes in a record and an optional id and
+                returns a Document. If None, the record will be used as the document.
+                Defaults to None.
+            state: The state to pass to the source connector. Defaults to None.
+        """
+        source_class = guard_import(
+            "source_hubspot", pip_name="airbyte-source-hubspot"
+        ).SourceHubspot
+        super().__init__(
+            config=config,
+            source_class=source_class,
+            stream_name=stream_name,
+            record_handler=record_handler,
+            state=state,
+        )
+
+
+class AirbyteStripeLoader(AirbyteCDKLoader):
+    """Load from `Stripe` using an `Airbyte` source connector."""
+
+    def __init__(
+        self,
+        config: Mapping[str, Any],
+        stream_name: str,
+        record_handler: Optional[RecordHandler] = None,
+        state: Optional[Any] = None,
+    ) -> None:
+        """Initializes the loader.
+
+        Args:
+            config: The config to pass to the source connector.
+            stream_name: The name of the stream to load.
+            record_handler: A function that takes in a record and an optional id and
+                returns a Document. If None, the record will be used as the document.
+                Defaults to None.
+            state: The state to pass to the source connector. Defaults to None.
+        """
+        source_class = guard_import(
+            "source_stripe", pip_name="airbyte-source-stripe"
+        ).SourceStripe
+        super().__init__(
+            config=config,
+            source_class=source_class,
+            stream_name=stream_name,
+            record_handler=record_handler,
+            state=state,
+        )
+
+
+class AirbyteTypeformLoader(AirbyteCDKLoader):
+    """Load from `Typeform` using an `Airbyte` source connector."""
+
+    def __init__(
+        self,
+        config: Mapping[str, Any],
+        stream_name: str,
+        record_handler: Optional[RecordHandler] = None,
+        state: Optional[Any] = None,
+    ) -> None:
+        """Initializes the loader.
+
+        Args:
+            config: The config to pass to the source connector.
+            stream_name: The name of the stream to load.
+            record_handler: A function that takes in a record and an optional id and
+                returns a Document. If None, the record will be used as the document.
+                Defaults to None.
+            state: The state to pass to the source connector. Defaults to None.
+        """
+        source_class = guard_import(
+            "source_typeform", pip_name="airbyte-source-typeform"
+        ).SourceTypeform
+        super().__init__(
+            config=config,
+            source_class=source_class,
+            stream_name=stream_name,
+            record_handler=record_handler,
+            state=state,
+        )
+
+
+class AirbyteZendeskSupportLoader(AirbyteCDKLoader):
+    """Load from `Zendesk Support` using an `Airbyte` source connector."""
+
+    def __init__(
+        self,
+        config: Mapping[str, Any],
+        stream_name: str,
+        record_handler: Optional[RecordHandler] = None,
+        state: Optional[Any] = None,
+    ) -> None:
+        """Initializes the loader.
+
+        Args:
+            config: The config to pass to the source connector.
+            stream_name: The name of the stream to load.
+            record_handler: A function that takes in a record and an optional id and
+                returns a Document. If None, the record will be used as the document.
+                Defaults to None.
+            state: The state to pass to the source connector. Defaults to None.
+        """
+        source_class = guard_import(
+            "source_zendesk_support", pip_name="airbyte-source-zendesk-support"
+        ).SourceZendeskSupport
+        super().__init__(
+            config=config,
+            source_class=source_class,
+            stream_name=stream_name,
+            record_handler=record_handler,
+            state=state,
+        )
+
+
+class AirbyteShopifyLoader(AirbyteCDKLoader):
+    """Load from `Shopify` using an `Airbyte` source connector."""
+
+    def __init__(
+        self,
+        config: Mapping[str, Any],
+        stream_name: str,
+        record_handler: Optional[RecordHandler] = None,
+        state: Optional[Any] = None,
+    ) -> None:
+        """Initializes the loader.
+
+        Args:
+            config: The config to pass to the source connector.
+            stream_name: The name of the stream to load.
+            record_handler: A function that takes in a record and an optional id and
+                returns a Document. If None, the record will be used as the document.
+                Defaults to None.
+            state: The state to pass to the source connector. Defaults to None.
+        """
+        source_class = guard_import(
+            "source_shopify", pip_name="airbyte-source-shopify"
+        ).SourceShopify
+        super().__init__(
+            config=config,
+            source_class=source_class,
+            stream_name=stream_name,
+            record_handler=record_handler,
+            state=state,
+        )
+
+
+class AirbyteSalesforceLoader(AirbyteCDKLoader):
+    """Load from `Salesforce` using an `Airbyte` source connector."""
+
+    def __init__(
+        self,
+        config: Mapping[str, Any],
+        stream_name: str,
+        record_handler: Optional[RecordHandler] = None,
+        state: Optional[Any] = None,
+    ) -> None:
+        """Initializes the loader.
+
+        Args:
+            config: The config to pass to the source connector.
+            stream_name: The name of the stream to load.
+            record_handler: A function that takes in a record and an optional id and
+                returns a Document. If None, the record will be used as the document.
+                Defaults to None.
+            state: The state to pass to the source connector. Defaults to None.
+        """
+        source_class = guard_import(
+            "source_salesforce", pip_name="airbyte-source-salesforce"
+        ).SourceSalesforce
+        super().__init__(
+            config=config,
+            source_class=source_class,
+            stream_name=stream_name,
+            record_handler=record_handler,
+            state=state,
+        )
+
+
+class AirbyteGongLoader(AirbyteCDKLoader):
+    """Load from `Gong` using an `Airbyte` source connector."""
+
+    def __init__(
+        self,
+        config: Mapping[str, Any],
+        stream_name: str,
+        record_handler: Optional[RecordHandler] = None,
+        state: Optional[Any] = None,
+    ) -> None:
+        """Initializes the loader.
+
+        Args:
+            config: The config to pass to the source connector.
+            stream_name: The name of the stream to load.
+            record_handler: A function that takes in a record and an optional id and
+                returns a Document. If None, the record will be used as the document.
+                Defaults to None.
+            state: The state to pass to the source connector. Defaults to None.
+        """
+        source_class = guard_import(
+            "source_gong", pip_name="airbyte-source-gong"
+        ).SourceGong
+        super().__init__(
+            config=config,
+            source_class=source_class,
+            stream_name=stream_name,
+            record_handler=record_handler,
+            state=state,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/airbyte_json.py b/llm/Lib/site-packages/langchain_community/document_loaders/airbyte_json.py
new file mode 100644
index 0000000000000000000000000000000000000000..aeb4b43cab83398ccea96e3545405e05dcd1fe2a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/airbyte_json.py
@@ -0,0 +1,25 @@
+import json
+from pathlib import Path
+from typing import List, Union
+
+from langchain_core.documents import Document
+from langchain_core.utils import stringify_dict
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class AirbyteJSONLoader(BaseLoader):
+    """Load local `Airbyte` json files."""
+
+    def __init__(self, file_path: Union[str, Path]):
+        """Initialize with a file path. This should start with '/tmp/airbyte_local/'."""
+        self.file_path = file_path
+        """Path to the directory containing the json files."""
+
+    def load(self) -> List[Document]:
+        text = ""
+        for line in open(self.file_path, "r"):
+            data = json.loads(line)["_airbyte_data"]
+            text += stringify_dict(data)
+        metadata = {"source": str(self.file_path)}
+        return [Document(page_content=text, metadata=metadata)]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/airtable.py b/llm/Lib/site-packages/langchain_community/document_loaders/airtable.py
new file mode 100644
index 0000000000000000000000000000000000000000..c39ed1fe630cb69abf1fd6972816a10fc30926df
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/airtable.py
@@ -0,0 +1,36 @@
+from typing import Iterator
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class AirtableLoader(BaseLoader):
+    """Load the `Airtable` tables."""
+
+    def __init__(self, api_token: str, table_id: str, base_id: str):
+        """Initialize with API token and the IDs for table and base"""
+        self.api_token = api_token
+        """Airtable API token."""
+        self.table_id = table_id
+        """Airtable table ID."""
+        self.base_id = base_id
+        """Airtable base ID."""
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Lazy load Documents from table."""
+
+        from pyairtable import Table
+
+        table = Table(self.api_token, self.base_id, self.table_id)
+        records = table.all()
+        for record in records:
+            # Need to convert record from dict to str
+            yield Document(
+                page_content=str(record),
+                metadata={
+                    "source": self.base_id + "_" + self.table_id,
+                    "base_id": self.base_id,
+                    "table_id": self.table_id,
+                },
+            )
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/apify_dataset.py b/llm/Lib/site-packages/langchain_community/document_loaders/apify_dataset.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d7d7ce18638e1363f0bbd94fa092ee6fcb1807b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/apify_dataset.py
@@ -0,0 +1,77 @@
+from typing import Any, Callable, Dict, List
+
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class ApifyDatasetLoader(BaseLoader, BaseModel):
+    """Load datasets from `Apify` web scraping, crawling, and data extraction platform.
+
+    For details, see https://docs.apify.com/platform/integrations/langchain
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.document_loaders import ApifyDatasetLoader
+            from langchain_core.documents import Document
+
+            loader = ApifyDatasetLoader(
+                dataset_id="YOUR-DATASET-ID",
+                dataset_mapping_function=lambda dataset_item: Document(
+                    page_content=dataset_item["text"], metadata={"source": dataset_item["url"]}
+                ),
+            )
+            documents = loader.load()
+    """  # noqa: E501
+
+    apify_client: Any
+    """An instance of the ApifyClient class from the apify-client Python package."""
+    dataset_id: str
+    """The ID of the dataset on the Apify platform."""
+    dataset_mapping_function: Callable[[Dict], Document]
+    """A custom function that takes a single dictionary (an Apify dataset item)
+     and converts it to an instance of the Document class."""
+
+    def __init__(
+        self, dataset_id: str, dataset_mapping_function: Callable[[Dict], Document]
+    ):
+        """Initialize the loader with an Apify dataset ID and a mapping function.
+
+        Args:
+            dataset_id (str): The ID of the dataset on the Apify platform.
+            dataset_mapping_function (Callable): A function that takes a single
+                dictionary (an Apify dataset item) and converts it to an instance
+                of the Document class.
+        """
+        super().__init__(
+            dataset_id=dataset_id, dataset_mapping_function=dataset_mapping_function
+        )
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate environment.
+
+        Args:
+            values: The values to validate.
+        """
+
+        try:
+            from apify_client import ApifyClient
+
+            values["apify_client"] = ApifyClient()
+        except ImportError:
+            raise ImportError(
+                "Could not import apify-client Python package. "
+                "Please install it with `pip install apify-client`."
+            )
+
+        return values
+
+    def load(self) -> List[Document]:
+        """Load documents."""
+        dataset_items = (
+            self.apify_client.dataset(self.dataset_id).list_items(clean=True).items
+        )
+        return list(map(self.dataset_mapping_function, dataset_items))
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/arcgis_loader.py b/llm/Lib/site-packages/langchain_community/document_loaders/arcgis_loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..d927f35e126f10a87fd9ade1d4fc98419fea46e3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/arcgis_loader.py
@@ -0,0 +1,150 @@
+"""Document Loader for ArcGIS FeatureLayers."""
+
+from __future__ import annotations
+
+import json
+import re
+import warnings
+from datetime import datetime, timezone
+from typing import TYPE_CHECKING, Any, Iterator, List, Optional, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+if TYPE_CHECKING:
+    import arcgis
+
+_NOT_PROVIDED = "(Not Provided)"
+
+
+class ArcGISLoader(BaseLoader):
+    """Load records from an ArcGIS FeatureLayer."""
+
+    def __init__(
+        self,
+        layer: Union[str, arcgis.features.FeatureLayer],
+        gis: Optional[arcgis.gis.GIS] = None,
+        where: str = "1=1",
+        out_fields: Optional[Union[List[str], str]] = None,
+        return_geometry: bool = False,
+        result_record_count: Optional[int] = None,
+        lyr_desc: Optional[str] = None,
+        **kwargs: Any,
+    ):
+        try:
+            import arcgis
+        except ImportError as e:
+            raise ImportError(
+                "arcgis is required to use the ArcGIS Loader. "
+                "Install it with pip or conda."
+            ) from e
+
+        try:
+            from bs4 import BeautifulSoup
+
+            self.BEAUTIFULSOUP = BeautifulSoup
+        except ImportError:
+            warnings.warn("BeautifulSoup not found. HTML will not be parsed.")
+            self.BEAUTIFULSOUP = None
+
+        self.gis = gis or arcgis.gis.GIS()
+
+        if isinstance(layer, str):
+            self.url = layer
+            self.layer = arcgis.features.FeatureLayer(layer, gis=gis)
+        else:
+            self.url = layer.url
+            self.layer = layer
+
+        self.layer_properties = self._get_layer_properties(lyr_desc)
+
+        self.where = where
+
+        if isinstance(out_fields, str):
+            self.out_fields = out_fields
+        elif out_fields is None:
+            self.out_fields = "*"
+        else:
+            self.out_fields = ",".join(out_fields)
+
+        self.return_geometry = return_geometry
+
+        self.result_record_count = result_record_count
+        self.return_all_records = not isinstance(result_record_count, int)
+
+        query_params = dict(
+            where=self.where,
+            out_fields=self.out_fields,
+            return_geometry=self.return_geometry,
+            return_all_records=self.return_all_records,
+            result_record_count=self.result_record_count,
+        )
+        query_params.update(kwargs)
+        self.query_params = query_params
+
+    def _get_layer_properties(self, lyr_desc: Optional[str] = None) -> dict:
+        """Get the layer properties from the FeatureLayer."""
+        import arcgis
+
+        layer_number_pattern = re.compile(r"/\d+$")
+        props = self.layer.properties
+
+        if lyr_desc is None:
+            # retrieve description from the FeatureLayer if not provided
+            try:
+                if self.BEAUTIFULSOUP:
+                    lyr_desc = self.BEAUTIFULSOUP(props["description"]).text
+                else:
+                    lyr_desc = props["description"]
+                lyr_desc = lyr_desc or _NOT_PROVIDED
+            except KeyError:
+                lyr_desc = _NOT_PROVIDED
+        try:
+            item_id = props["serviceItemId"]
+            item = self.gis.content.get(item_id) or arcgis.features.FeatureLayer(
+                re.sub(layer_number_pattern, "", self.url),
+            )
+            try:
+                raw_desc = item.description
+            except AttributeError:
+                raw_desc = item.properties.description
+            if self.BEAUTIFULSOUP:
+                item_desc = self.BEAUTIFULSOUP(raw_desc).text
+            else:
+                item_desc = raw_desc
+            item_desc = item_desc or _NOT_PROVIDED
+        except KeyError:
+            item_desc = _NOT_PROVIDED
+        return {
+            "layer_description": lyr_desc,
+            "item_description": item_desc,
+            "layer_properties": props,
+        }
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Lazy load records from FeatureLayer."""
+        query_response = self.layer.query(**self.query_params)
+        features = (feature.as_dict for feature in query_response)
+        for feature in features:
+            attributes = feature["attributes"]
+            page_content = json.dumps(attributes)
+
+            metadata = {
+                "accessed": f"{datetime.now(timezone.utc).isoformat()}Z",
+                "name": self.layer_properties["layer_properties"]["name"],
+                "url": self.url,
+                "layer_description": self.layer_properties["layer_description"],
+                "item_description": self.layer_properties["item_description"],
+                "layer_properties": self.layer_properties["layer_properties"],
+            }
+
+            if self.return_geometry:
+                try:
+                    metadata["geometry"] = feature["geometry"]
+                except KeyError:
+                    warnings.warn(
+                        "Geometry could not be retrieved from the feature layer."
+                    )
+
+            yield Document(page_content=page_content, metadata=metadata)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/arxiv.py b/llm/Lib/site-packages/langchain_community/document_loaders/arxiv.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f26d155201bbda9f2be24a7520c8127d3834c04
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/arxiv.py
@@ -0,0 +1,30 @@
+from typing import Any, Iterator, List, Optional
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.utilities.arxiv import ArxivAPIWrapper
+
+
+class ArxivLoader(BaseLoader):
+    """Load a query result from `Arxiv`.
+
+    The loader converts the original PDF format into the text.
+
+    Args:
+        Supports all arguments of `ArxivAPIWrapper`.
+    """
+
+    def __init__(
+        self, query: str, doc_content_chars_max: Optional[int] = None, **kwargs: Any
+    ):
+        self.query = query
+        self.client = ArxivAPIWrapper(
+            doc_content_chars_max=doc_content_chars_max, **kwargs
+        )
+
+    def lazy_load(self) -> Iterator[Document]:
+        yield from self.client.lazy_load(self.query)
+
+    def get_summaries_as_docs(self) -> List[Document]:
+        return self.client.get_summaries_as_docs(self.query)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/assemblyai.py b/llm/Lib/site-packages/langchain_community/document_loaders/assemblyai.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7713d33bf485927b4a98d7ce460bb26184a7385
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/assemblyai.py
@@ -0,0 +1,217 @@
+from __future__ import annotations
+
+from enum import Enum
+from pathlib import Path
+from typing import TYPE_CHECKING, Iterator, Optional, Union
+
+import requests
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+if TYPE_CHECKING:
+    import assemblyai
+
+
+class TranscriptFormat(Enum):
+    """Transcript format to use for the document loader."""
+
+    TEXT = "text"
+    """One document with the transcription text"""
+    SENTENCES = "sentences"
+    """Multiple documents, splits the transcription by each sentence"""
+    PARAGRAPHS = "paragraphs"
+    """Multiple documents, splits the transcription by each paragraph"""
+    SUBTITLES_SRT = "subtitles_srt"
+    """One document with the transcript exported in SRT subtitles format"""
+    SUBTITLES_VTT = "subtitles_vtt"
+    """One document with the transcript exported in VTT subtitles format"""
+
+
+class AssemblyAIAudioTranscriptLoader(BaseLoader):
+    """Load AssemblyAI audio transcripts.
+
+    It uses the AssemblyAI API to transcribe audio files
+    and loads the transcribed text into one or more Documents,
+    depending on the specified format.
+
+    To use, you should have the ``assemblyai`` python package installed, and the
+    environment variable ``ASSEMBLYAI_API_KEY`` set with your API key.
+    Alternatively, the API key can also be passed as an argument.
+
+    Audio files can be specified via an URL or a local file path.
+    """
+
+    def __init__(
+        self,
+        file_path: Union[str, Path],
+        *,
+        transcript_format: TranscriptFormat = TranscriptFormat.TEXT,
+        config: Optional[assemblyai.TranscriptionConfig] = None,
+        api_key: Optional[str] = None,
+    ):
+        """
+        Initializes the AssemblyAI AudioTranscriptLoader.
+
+        Args:
+            file_path: An URL or a local file path.
+            transcript_format: Transcript format to use.
+                See class ``TranscriptFormat`` for more info.
+            config: Transcription options and features. If ``None`` is given,
+                the Transcriber's default configuration will be used.
+            api_key: AssemblyAI API key.
+        """
+        try:
+            import assemblyai
+        except ImportError:
+            raise ImportError(
+                "Could not import assemblyai python package. "
+                "Please install it with `pip install assemblyai`."
+            )
+        if api_key is not None:
+            assemblyai.settings.api_key = api_key
+
+        self.file_path = str(file_path)
+        self.transcript_format = transcript_format
+        self.transcriber = assemblyai.Transcriber(config=config)
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Transcribes the audio file and loads the transcript into documents.
+
+        It uses the AssemblyAI API to transcribe the audio file and blocks until
+        the transcription is finished.
+        """
+        transcript = self.transcriber.transcribe(self.file_path)
+        # This will raise a ValueError if no API key is set.
+
+        if transcript.error:
+            raise ValueError(f"Could not transcribe file: {transcript.error}")
+
+        if self.transcript_format == TranscriptFormat.TEXT:
+            yield Document(
+                page_content=transcript.text, metadata=transcript.json_response
+            )
+        elif self.transcript_format == TranscriptFormat.SENTENCES:
+            sentences = transcript.get_sentences()
+            for s in sentences:
+                yield Document(page_content=s.text, metadata=s.dict(exclude={"text"}))
+        elif self.transcript_format == TranscriptFormat.PARAGRAPHS:
+            paragraphs = transcript.get_paragraphs()
+            for p in paragraphs:
+                yield Document(page_content=p.text, metadata=p.dict(exclude={"text"}))
+        elif self.transcript_format == TranscriptFormat.SUBTITLES_SRT:
+            yield Document(page_content=transcript.export_subtitles_srt())
+        elif self.transcript_format == TranscriptFormat.SUBTITLES_VTT:
+            yield Document(page_content=transcript.export_subtitles_vtt())
+        else:
+            raise ValueError("Unknown transcript format.")
+
+
+class AssemblyAIAudioLoaderById(BaseLoader):
+    """
+    Load AssemblyAI audio transcripts.
+
+    It uses the AssemblyAI API to get an existing transcription
+    and loads the transcribed text into one or more Documents,
+    depending on the specified format.
+
+    """
+
+    def __init__(
+        self, transcript_id: str, api_key: str, transcript_format: TranscriptFormat
+    ):
+        """
+        Initializes the AssemblyAI AssemblyAIAudioLoaderById.
+
+        Args:
+            transcript_id: Id of an existing transcription.
+            transcript_format: Transcript format to use.
+                See class ``TranscriptFormat`` for more info.
+            api_key: AssemblyAI API key.
+        """
+
+        self.api_key = api_key
+        self.transcript_id = transcript_id
+        self.transcript_format = transcript_format
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Load data into Document objects."""
+        HEADERS = {"authorization": self.api_key}
+
+        if self.transcript_format == TranscriptFormat.TEXT:
+            try:
+                transcript_response = requests.get(
+                    f"https://api.assemblyai.com/v2/transcript/{self.transcript_id}",
+                    headers=HEADERS,
+                )
+                transcript_response.raise_for_status()
+            except Exception as e:
+                print(f"An error occurred: {e}")  # noqa: T201
+                raise
+
+            transcript = transcript_response.json()["text"]
+
+            yield Document(page_content=transcript, metadata=transcript_response.json())
+        elif self.transcript_format == TranscriptFormat.PARAGRAPHS:
+            try:
+                paragraphs_response = requests.get(
+                    f"https://api.assemblyai.com/v2/transcript/{self.transcript_id}/paragraphs",
+                    headers=HEADERS,
+                )
+                paragraphs_response.raise_for_status()
+            except Exception as e:
+                print(f"An error occurred: {e}")  # noqa: T201
+                raise
+
+            paragraphs = paragraphs_response.json()["paragraphs"]
+
+            for p in paragraphs:
+                yield Document(page_content=p["text"], metadata=p)
+
+        elif self.transcript_format == TranscriptFormat.SENTENCES:
+            try:
+                sentences_response = requests.get(
+                    f"https://api.assemblyai.com/v2/transcript/{self.transcript_id}/sentences",
+                    headers=HEADERS,
+                )
+                sentences_response.raise_for_status()
+            except Exception as e:
+                print(f"An error occurred: {e}")  # noqa: T201
+                raise
+
+            sentences = sentences_response.json()["sentences"]
+
+            for s in sentences:
+                yield Document(page_content=s["text"], metadata=s)
+
+        elif self.transcript_format == TranscriptFormat.SUBTITLES_SRT:
+            try:
+                srt_response = requests.get(
+                    f"https://api.assemblyai.com/v2/transcript/{self.transcript_id}/srt",
+                    headers=HEADERS,
+                )
+                srt_response.raise_for_status()
+            except Exception as e:
+                print(f"An error occurred: {e}")  # noqa: T201
+                raise
+
+            srt = srt_response.text
+
+            yield Document(page_content=srt)
+
+        elif self.transcript_format == TranscriptFormat.SUBTITLES_VTT:
+            try:
+                vtt_response = requests.get(
+                    f"https://api.assemblyai.com/v2/transcript/{self.transcript_id}/vtt",
+                    headers=HEADERS,
+                )
+                vtt_response.raise_for_status()
+            except Exception as e:
+                print(f"An error occurred: {e}")  # noqa: T201
+                raise
+
+            vtt = vtt_response.text
+
+            yield Document(page_content=vtt)
+        else:
+            raise ValueError("Unknown transcript format.")
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/astradb.py b/llm/Lib/site-packages/langchain_community/document_loaders/astradb.py
new file mode 100644
index 0000000000000000000000000000000000000000..2898f2eaec284a1256701ee553f93af4862b8ba6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/astradb.py
@@ -0,0 +1,124 @@
+from __future__ import annotations
+
+import json
+import logging
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+)
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.utilities.astradb import _AstraDBEnvironment
+
+if TYPE_CHECKING:
+    from astrapy.db import AstraDB, AsyncAstraDB
+
+logger = logging.getLogger(__name__)
+
+
+@deprecated(
+    since="0.0.29",
+    removal="0.2.0",
+    alternative_import="langchain_astradb.AstraDBLoader",
+)
+class AstraDBLoader(BaseLoader):
+    def __init__(
+        self,
+        collection_name: str,
+        *,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        astra_db_client: Optional[AstraDB] = None,
+        async_astra_db_client: Optional[AsyncAstraDB] = None,
+        namespace: Optional[str] = None,
+        filter_criteria: Optional[Dict[str, Any]] = None,
+        projection: Optional[Dict[str, Any]] = None,
+        find_options: Optional[Dict[str, Any]] = None,
+        nb_prefetched: int = 1000,
+        extraction_function: Callable[[Dict], str] = json.dumps,
+    ) -> None:
+        """Load DataStax Astra DB documents.
+
+        Args:
+            collection_name: name of the Astra DB collection to use.
+            token: API token for Astra DB usage.
+            api_endpoint: full URL to the API endpoint,
+                such as `https://<DB-ID>-us-east1.apps.astra.datastax.com`.
+            astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AstraDB' instance.
+            async_astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AsyncAstraDB' instance.
+            namespace: namespace (aka keyspace) where the
+                collection is. Defaults to the database's "default namespace".
+            filter_criteria: Criteria to filter documents.
+            projection: Specifies the fields to return.
+            find_options: Additional options for the query.
+            nb_prefetched: Max number of documents to pre-fetch. Defaults to 1000.
+            extraction_function: Function applied to collection documents to create
+                the `page_content` of the LangChain Document. Defaults to `json.dumps`.
+        """
+        astra_env = _AstraDBEnvironment(
+            token=token,
+            api_endpoint=api_endpoint,
+            astra_db_client=astra_db_client,
+            async_astra_db_client=async_astra_db_client,
+            namespace=namespace,
+        )
+        self.astra_env = astra_env
+        self.collection = astra_env.astra_db.collection(collection_name)
+        self.collection_name = collection_name
+        self.filter = filter_criteria
+        self.projection = projection
+        self.find_options = find_options or {}
+        self.nb_prefetched = nb_prefetched
+        self.extraction_function = extraction_function
+
+    def lazy_load(self) -> Iterator[Document]:
+        for doc in self.collection.paginated_find(
+            filter=self.filter,
+            options=self.find_options,
+            projection=self.projection,
+            sort=None,
+            prefetched=self.nb_prefetched,
+        ):
+            yield Document(
+                page_content=self.extraction_function(doc),
+                metadata={
+                    "namespace": self.collection.astra_db.namespace,
+                    "api_endpoint": self.collection.astra_db.base_url,
+                    "collection": self.collection_name,
+                },
+            )
+
+    async def aload(self) -> List[Document]:
+        """Load data into Document objects."""
+        return [doc async for doc in self.alazy_load()]
+
+    async def alazy_load(self) -> AsyncIterator[Document]:
+        async_collection = await self.astra_env.async_astra_db.collection(
+            self.collection_name
+        )
+        async for doc in async_collection.paginated_find(
+            filter=self.filter,
+            options=self.find_options,
+            projection=self.projection,
+            sort=None,
+            prefetched=self.nb_prefetched,
+        ):
+            yield Document(
+                page_content=self.extraction_function(doc),
+                metadata={
+                    "namespace": async_collection.astra_db.namespace,
+                    "api_endpoint": async_collection.astra_db.base_url,
+                    "collection": self.collection_name,
+                },
+            )
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/async_html.py b/llm/Lib/site-packages/langchain_community/document_loaders/async_html.py
new file mode 100644
index 0000000000000000000000000000000000000000..9d23a12abc0b07e7e8a5dffd5b872bb42182b0ca
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/async_html.py
@@ -0,0 +1,222 @@
+import asyncio
+import logging
+import warnings
+from concurrent.futures import ThreadPoolExecutor
+from typing import Any, Dict, Iterator, List, Optional, Union, cast
+
+import aiohttp
+import requests
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+default_header_template = {
+    "User-Agent": "",
+    "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*"
+    ";q=0.8",
+    "Accept-Language": "en-US,en;q=0.5",
+    "Referer": "https://www.google.com/",
+    "DNT": "1",
+    "Connection": "keep-alive",
+    "Upgrade-Insecure-Requests": "1",
+}
+
+
+def _build_metadata(soup: Any, url: str) -> dict:
+    """Build metadata from BeautifulSoup output."""
+    metadata = {"source": url}
+    if title := soup.find("title"):
+        metadata["title"] = title.get_text()
+    if description := soup.find("meta", attrs={"name": "description"}):
+        metadata["description"] = description.get("content", "No description found.")
+    if html := soup.find("html"):
+        metadata["language"] = html.get("lang", "No language found.")
+    return metadata
+
+
+class AsyncHtmlLoader(BaseLoader):
+    """Load `HTML` asynchronously."""
+
+    def __init__(
+        self,
+        web_path: Union[str, List[str]],
+        header_template: Optional[dict] = None,
+        verify_ssl: Optional[bool] = True,
+        proxies: Optional[dict] = None,
+        autoset_encoding: bool = True,
+        encoding: Optional[str] = None,
+        default_parser: str = "html.parser",
+        requests_per_second: int = 2,
+        requests_kwargs: Optional[Dict[str, Any]] = None,
+        raise_for_status: bool = False,
+        ignore_load_errors: bool = False,
+    ):
+        """Initialize with a webpage path."""
+
+        # TODO: Deprecate web_path in favor of web_paths, and remove this
+        # left like this because there are a number of loaders that expect single
+        # urls
+        if isinstance(web_path, str):
+            self.web_paths = [web_path]
+        elif isinstance(web_path, List):
+            self.web_paths = web_path
+
+        headers = header_template or default_header_template
+        if not headers.get("User-Agent"):
+            try:
+                from fake_useragent import UserAgent
+
+                headers["User-Agent"] = UserAgent().random
+            except ImportError:
+                logger.info(
+                    "fake_useragent not found, using default user agent."
+                    "To get a realistic header for requests, "
+                    "`pip install fake_useragent`."
+                )
+
+        self.session = requests.Session()
+        self.session.headers = dict(headers)
+        self.session.verify = verify_ssl
+
+        if proxies:
+            self.session.proxies.update(proxies)
+
+        self.requests_per_second = requests_per_second
+        self.default_parser = default_parser
+        self.requests_kwargs = requests_kwargs or {}
+        self.raise_for_status = raise_for_status
+        self.autoset_encoding = autoset_encoding
+        self.encoding = encoding
+        self.ignore_load_errors = ignore_load_errors
+
+    def _fetch_valid_connection_docs(self, url: str) -> Any:
+        if self.ignore_load_errors:
+            try:
+                return self.session.get(url, **self.requests_kwargs)
+            except Exception as e:
+                warnings.warn(str(e))
+                return None
+
+        return self.session.get(url, **self.requests_kwargs)
+
+    @staticmethod
+    def _check_parser(parser: str) -> None:
+        """Check that parser is valid for bs4."""
+        valid_parsers = ["html.parser", "lxml", "xml", "lxml-xml", "html5lib"]
+        if parser not in valid_parsers:
+            raise ValueError(
+                "`parser` must be one of " + ", ".join(valid_parsers) + "."
+            )
+
+    def _scrape(
+        self,
+        url: str,
+        parser: Union[str, None] = None,
+        bs_kwargs: Optional[dict] = None,
+    ) -> Any:
+        from bs4 import BeautifulSoup
+
+        if parser is None:
+            if url.endswith(".xml"):
+                parser = "xml"
+            else:
+                parser = self.default_parser
+
+        self._check_parser(parser)
+
+        html_doc = self._fetch_valid_connection_docs(url)
+        if not getattr(html_doc, "ok", False):
+            return None
+
+        if self.raise_for_status:
+            html_doc.raise_for_status()
+
+        if self.encoding is not None:
+            html_doc.encoding = self.encoding
+        elif self.autoset_encoding:
+            html_doc.encoding = html_doc.apparent_encoding
+        return BeautifulSoup(html_doc.text, parser, **(bs_kwargs or {}))
+
+    async def _fetch(
+        self, url: str, retries: int = 3, cooldown: int = 2, backoff: float = 1.5
+    ) -> str:
+        async with aiohttp.ClientSession() as session:
+            for i in range(retries):
+                try:
+                    async with session.get(
+                        url,
+                        headers=self.session.headers,
+                        ssl=None if self.session.verify else False,
+                    ) as response:
+                        try:
+                            text = await response.text()
+                        except UnicodeDecodeError:
+                            logger.error(f"Failed to decode content from {url}")
+                            text = ""
+                        return text
+                except aiohttp.ClientConnectionError as e:
+                    if i == retries - 1 and self.ignore_load_errors:
+                        logger.warning(f"Error fetching {url} after {retries} retries.")
+                        return ""
+                    elif i == retries - 1:
+                        raise
+                    else:
+                        logger.warning(
+                            f"Error fetching {url} with attempt "
+                            f"{i + 1}/{retries}: {e}. Retrying..."
+                        )
+                        await asyncio.sleep(cooldown * backoff**i)
+        raise ValueError("retry count exceeded")
+
+    async def _fetch_with_rate_limit(
+        self, url: str, semaphore: asyncio.Semaphore
+    ) -> str:
+        async with semaphore:
+            return await self._fetch(url)
+
+    async def fetch_all(self, urls: List[str]) -> Any:
+        """Fetch all urls concurrently with rate limiting."""
+        semaphore = asyncio.Semaphore(self.requests_per_second)
+        tasks = []
+        for url in urls:
+            task = asyncio.ensure_future(self._fetch_with_rate_limit(url, semaphore))
+            tasks.append(task)
+        try:
+            from tqdm.asyncio import tqdm_asyncio
+
+            return await tqdm_asyncio.gather(
+                *tasks, desc="Fetching pages", ascii=True, mininterval=1
+            )
+        except ImportError:
+            warnings.warn("For better logging of progress, `pip install tqdm`")
+            return await asyncio.gather(*tasks)
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Lazy load text from the url(s) in web_path."""
+        for doc in self.load():
+            yield doc
+
+    def load(self) -> List[Document]:
+        """Load text from the url(s) in web_path."""
+
+        try:
+            # Raises RuntimeError if there is no current event loop.
+            asyncio.get_running_loop()
+            # If there is a current event loop, we need to run the async code
+            # in a separate loop, in a separate thread.
+            with ThreadPoolExecutor(max_workers=1) as executor:
+                future = executor.submit(asyncio.run, self.fetch_all(self.web_paths))
+                results = future.result()
+        except RuntimeError:
+            results = asyncio.run(self.fetch_all(self.web_paths))
+        docs = []
+        for i, text in enumerate(cast(List[str], results)):
+            soup = self._scrape(self.web_paths[i])
+            if not soup:
+                continue
+            metadata = _build_metadata(soup, self.web_paths[i])
+            docs.append(Document(page_content=text, metadata=metadata))
+
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/athena.py b/llm/Lib/site-packages/langchain_community/document_loaders/athena.py
new file mode 100644
index 0000000000000000000000000000000000000000..2fcfc9b393a3fc53f22cb495a05eaa29fcbf4c96
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/athena.py
@@ -0,0 +1,159 @@
+from __future__ import annotations
+
+import io
+import json
+import time
+from typing import Any, Dict, Iterator, List, Optional, Tuple
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class AthenaLoader(BaseLoader):
+    """Load documents from `AWS Athena`.
+
+    Each document represents one row of the result.
+    - By default, all columns are written into the `page_content` of the document
+    and none into the `metadata` of the document.
+    - If `metadata_columns` are provided then these columns are written
+    into the `metadata` of the document while the rest of the columns
+    are written into the `page_content` of the document.
+
+    To authenticate, the AWS client uses this method to automatically load credentials:
+    https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html
+
+    If a specific credential profile should be used, you must pass
+    the name of the profile from the ~/.aws/credentials file that is to be used.
+
+    Make sure the credentials / roles used have the required policies to
+    access the Amazon Textract service.
+    """
+
+    def __init__(
+        self,
+        query: str,
+        database: str,
+        s3_output_uri: str,
+        profile_name: str,
+        metadata_columns: Optional[List[str]] = None,
+    ):
+        """Initialize Athena document loader.
+
+        Args:
+            query: The query to run in Athena.
+            database: Athena database
+            s3_output_uri: Athena output path
+            metadata_columns: Optional. Columns written to Document `metadata`.
+        """
+        self.query = query
+        self.database = database
+        self.s3_output_uri = s3_output_uri
+        self.metadata_columns = metadata_columns if metadata_columns is not None else []
+
+        try:
+            import boto3
+        except ImportError:
+            raise ModuleNotFoundError(
+                "Could not import boto3 python package. "
+                "Please install it with `pip install boto3`."
+            )
+
+        try:
+            session = (
+                boto3.Session(profile_name=profile_name)
+                if profile_name is not None
+                else boto3.Session()
+            )
+        except Exception as e:
+            raise ValueError(
+                "Could not load credentials to authenticate with AWS client. "
+                "Please check that credentials in the specified "
+                "profile name are valid."
+            ) from e
+
+        self.athena_client = session.client("athena")
+        self.s3_client = session.client("s3")
+
+    def _execute_query(self) -> List[Dict[str, Any]]:
+        response = self.athena_client.start_query_execution(
+            QueryString=self.query,
+            QueryExecutionContext={"Database": self.database},
+            ResultConfiguration={"OutputLocation": self.s3_output_uri},
+        )
+        query_execution_id = response["QueryExecutionId"]
+        while True:
+            response = self.athena_client.get_query_execution(
+                QueryExecutionId=query_execution_id
+            )
+            state = response["QueryExecution"]["Status"]["State"]
+            if state == "SUCCEEDED":
+                break
+            elif state == "FAILED":
+                resp_status = response["QueryExecution"]["Status"]
+                state_change_reason = resp_status["StateChangeReason"]
+                err = f"Query Failed: {state_change_reason}"
+                raise Exception(err)
+            elif state == "CANCELLED":
+                raise Exception("Query was cancelled by the user.")
+            time.sleep(1)
+
+        result_set = self._get_result_set(query_execution_id)
+        return json.loads(result_set.to_json(orient="records"))
+
+    def _remove_suffix(self, input_string: str, suffix: str) -> str:
+        if suffix and input_string.endswith(suffix):
+            return input_string[: -len(suffix)]
+        return input_string
+
+    def _remove_prefix(self, input_string: str, suffix: str) -> str:
+        if suffix and input_string.startswith(suffix):
+            return input_string[len(suffix) :]
+        return input_string
+
+    def _get_result_set(self, query_execution_id: str) -> Any:
+        try:
+            import pandas as pd
+        except ImportError:
+            raise ModuleNotFoundError(
+                "Could not import pandas python package. "
+                "Please install it with `pip install pandas`."
+            )
+
+        output_uri = self.s3_output_uri
+        tokens = self._remove_prefix(
+            self._remove_suffix(output_uri, "/"), "s3://"
+        ).split("/")
+        bucket = tokens[0]
+        key = "/".join(tokens[1:] + [query_execution_id]) + ".csv"
+
+        obj = self.s3_client.get_object(Bucket=bucket, Key=key)
+        df = pd.read_csv(io.BytesIO(obj["Body"].read()), encoding="utf8")
+        return df
+
+    def _get_columns(
+        self, query_result: List[Dict[str, Any]]
+    ) -> Tuple[List[str], List[str]]:
+        content_columns = []
+        metadata_columns = []
+        all_columns = list(query_result[0].keys())
+        for key in all_columns:
+            if key in self.metadata_columns:
+                metadata_columns.append(key)
+            else:
+                content_columns.append(key)
+
+        return content_columns, metadata_columns
+
+    def lazy_load(self) -> Iterator[Document]:
+        query_result = self._execute_query()
+        content_columns, metadata_columns = self._get_columns(query_result)
+        for row in query_result:
+            page_content = "\n".join(
+                f"{k}: {v}" for k, v in row.items() if k in content_columns
+            )
+            metadata = {
+                k: v for k, v in row.items() if k in metadata_columns and v is not None
+            }
+            doc = Document(page_content=page_content, metadata=metadata)
+            yield doc
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/azlyrics.py b/llm/Lib/site-packages/langchain_community/document_loaders/azlyrics.py
new file mode 100644
index 0000000000000000000000000000000000000000..b763c8fb4b38249010afcfae421d44805cd01ae9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/azlyrics.py
@@ -0,0 +1,18 @@
+from typing import List
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.web_base import WebBaseLoader
+
+
+class AZLyricsLoader(WebBaseLoader):
+    """Load `AZLyrics` webpages."""
+
+    def load(self) -> List[Document]:
+        """Load webpages into Documents."""
+        soup = self.scrape()
+        title = soup.title.text
+        lyrics = soup.find_all("div", {"class": ""})[2].text
+        text = title + lyrics
+        metadata = {"source": self.web_path}
+        return [Document(page_content=text, metadata=metadata)]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/azure_ai_data.py b/llm/Lib/site-packages/langchain_community/document_loaders/azure_ai_data.py
new file mode 100644
index 0000000000000000000000000000000000000000..05f404ddd1333f747175e250b22c943c6482d3d6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/azure_ai_data.py
@@ -0,0 +1,39 @@
+from typing import Iterator, Optional
+
+from langchain_community.docstore.document import Document
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.unstructured import UnstructuredFileIOLoader
+
+
+class AzureAIDataLoader(BaseLoader):
+    """Load from Azure AI Data."""
+
+    def __init__(self, url: str, glob: Optional[str] = None):
+        """Initialize with URL to a data asset or storage location
+        ."""
+        self.url = url
+        """URL to the data asset or storage location."""
+        self.glob_pattern = glob
+        """Optional glob pattern to select files. Defaults to None."""
+
+    def lazy_load(self) -> Iterator[Document]:
+        """A lazy loader for Documents."""
+        try:
+            from azureml.fsspec import AzureMachineLearningFileSystem
+        except ImportError as exc:
+            raise ImportError(
+                "Could not import azureml-fspec package."
+                "Please install it with `pip install azureml-fsspec`."
+            ) from exc
+
+        fs = AzureMachineLearningFileSystem(self.url)
+
+        if self.glob_pattern:
+            remote_paths_list = fs.glob(self.glob_pattern)
+        else:
+            remote_paths_list = fs.ls()
+
+        for remote_path in remote_paths_list:
+            with fs.open(remote_path) as f:
+                loader = UnstructuredFileIOLoader(file=f)
+                yield from loader.load()
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/azure_blob_storage_container.py b/llm/Lib/site-packages/langchain_community/document_loaders/azure_blob_storage_container.py
new file mode 100644
index 0000000000000000000000000000000000000000..25f53a3ade4604a3b5e5f78650dad23cd189ea44
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/azure_blob_storage_container.py
@@ -0,0 +1,45 @@
+from typing import List
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.azure_blob_storage_file import (
+    AzureBlobStorageFileLoader,
+)
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class AzureBlobStorageContainerLoader(BaseLoader):
+    """Load from `Azure Blob Storage` container."""
+
+    def __init__(self, conn_str: str, container: str, prefix: str = ""):
+        """Initialize with connection string, container and blob prefix."""
+        self.conn_str = conn_str
+        """Connection string for Azure Blob Storage."""
+        self.container = container
+        """Container name."""
+        self.prefix = prefix
+        """Prefix for blob names."""
+
+    def load(self) -> List[Document]:
+        """Load documents."""
+        try:
+            from azure.storage.blob import ContainerClient
+        except ImportError as exc:
+            raise ImportError(
+                "Could not import azure storage blob python package. "
+                "Please install it with `pip install azure-storage-blob`."
+            ) from exc
+
+        container = ContainerClient.from_connection_string(
+            conn_str=self.conn_str, container_name=self.container
+        )
+        docs = []
+        blob_list = container.list_blobs(name_starts_with=self.prefix)
+        for blob in blob_list:
+            loader = AzureBlobStorageFileLoader(
+                self.conn_str,
+                self.container,
+                blob.name,
+            )
+            docs.extend(loader.load())
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/azure_blob_storage_file.py b/llm/Lib/site-packages/langchain_community/document_loaders/azure_blob_storage_file.py
new file mode 100644
index 0000000000000000000000000000000000000000..9151f75a0069527e2abed623a92c82cf7f8ef883
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/azure_blob_storage_file.py
@@ -0,0 +1,44 @@
+import os
+import tempfile
+from typing import List
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.unstructured import UnstructuredFileLoader
+
+
+class AzureBlobStorageFileLoader(BaseLoader):
+    """Load from `Azure Blob Storage` files."""
+
+    def __init__(self, conn_str: str, container: str, blob_name: str):
+        """Initialize with connection string, container and blob name."""
+        self.conn_str = conn_str
+        """Connection string for Azure Blob Storage."""
+        self.container = container
+        """Container name."""
+        self.blob = blob_name
+        """Blob name."""
+
+    def load(self) -> List[Document]:
+        """Load documents."""
+        try:
+            from azure.storage.blob import BlobClient
+        except ImportError as exc:
+            raise ImportError(
+                "Could not import azure storage blob python package. "
+                "Please install it with `pip install azure-storage-blob`."
+            ) from exc
+
+        client = BlobClient.from_connection_string(
+            conn_str=self.conn_str, container_name=self.container, blob_name=self.blob
+        )
+
+        with tempfile.TemporaryDirectory() as temp_dir:
+            file_path = f"{temp_dir}/{self.container}/{self.blob}"
+            os.makedirs(os.path.dirname(file_path), exist_ok=True)
+            with open(f"{file_path}", "wb") as file:
+                blob_data = client.download_blob()
+                blob_data.readinto(file)
+            loader = UnstructuredFileLoader(file_path)
+            return loader.load()
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/baiducloud_bos_directory.py b/llm/Lib/site-packages/langchain_community/document_loaders/baiducloud_bos_directory.py
new file mode 100644
index 0000000000000000000000000000000000000000..c069c24f9b8e593fd04f538b97bd3b91c77f19d6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/baiducloud_bos_directory.py
@@ -0,0 +1,52 @@
+from typing import Any, Iterator
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class BaiduBOSDirectoryLoader(BaseLoader):
+    """Load from `Baidu BOS directory`."""
+
+    def __init__(self, conf: Any, bucket: str, prefix: str = ""):
+        """Initialize with BOS config, bucket and prefix.
+        :param conf(BosConfig): BOS config.
+        :param bucket(str): BOS bucket.
+        :param prefix(str): prefix.
+        """
+        self.conf = conf
+        self.bucket = bucket
+        self.prefix = prefix
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Load documents."""
+        try:
+            from baidubce.services.bos.bos_client import BosClient
+        except ImportError:
+            raise ImportError(
+                "Please install bce-python-sdk with `pip install bce-python-sdk`."
+            )
+        client = BosClient(self.conf)
+        contents = []
+        marker = ""
+        while True:
+            response = client.list_objects(
+                bucket_name=self.bucket,
+                prefix=self.prefix,
+                marker=marker,
+                max_keys=1000,
+            )
+            contents_len = len(response.contents)
+            contents.extend(response.contents)
+            if response.is_truncated or contents_len < int(str(response.max_keys)):
+                break
+            marker = response.next_marker
+        from langchain_community.document_loaders.baiducloud_bos_file import (
+            BaiduBOSFileLoader,
+        )
+
+        for content in contents:
+            if str(content.key).endswith("/"):
+                continue
+            loader = BaiduBOSFileLoader(self.conf, self.bucket, str(content.key))
+            yield loader.load()[0]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/baiducloud_bos_file.py b/llm/Lib/site-packages/langchain_community/document_loaders/baiducloud_bos_file.py
new file mode 100644
index 0000000000000000000000000000000000000000..dca4cd544f167462f10f7653f5a049113f186958
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/baiducloud_bos_file.py
@@ -0,0 +1,51 @@
+import logging
+import os
+import tempfile
+from typing import Any, Iterator
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.unstructured import UnstructuredFileLoader
+
+logger = logging.getLogger(__name__)
+
+
+class BaiduBOSFileLoader(BaseLoader):
+    """Load from `Baidu Cloud BOS` file."""
+
+    def __init__(self, conf: Any, bucket: str, key: str):
+        """Initialize with BOS config, bucket and key name.
+        :param conf(BceClientConfiguration): BOS config.
+        :param bucket(str): BOS bucket.
+        :param key(str): BOS file key.
+        """
+        self.conf = conf
+        self.bucket = bucket
+        self.key = key
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Load documents."""
+        try:
+            from baidubce.services.bos.bos_client import BosClient
+        except ImportError:
+            raise ImportError(
+                "Please using `pip install bce-python-sdk`"
+                + " before import bos related package."
+            )
+
+        # Initialize BOS Client
+        client = BosClient(self.conf)
+        with tempfile.TemporaryDirectory() as temp_dir:
+            file_path = f"{temp_dir}/{self.bucket}/{self.key}"
+            os.makedirs(os.path.dirname(file_path), exist_ok=True)
+            # Download the file to a destination
+            logger.debug(f"get object key {self.key} to file {file_path}")
+            client.get_object_to_file(self.bucket, self.key, file_path)
+            try:
+                loader = UnstructuredFileLoader(file_path)
+                documents = loader.load()
+                return iter(documents)
+            except Exception as ex:
+                logger.error(f"load document error = {ex}")
+                return iter([Document(page_content="")])
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/base.py b/llm/Lib/site-packages/langchain_community/document_loaders/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..a1c3d82524f15632d40738e9863fec332e5792ca
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/base.py
@@ -0,0 +1,6 @@
+from langchain_core.document_loaders import BaseBlobParser, BaseLoader
+
+__all__ = [
+    "BaseBlobParser",
+    "BaseLoader",
+]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/base_o365.py b/llm/Lib/site-packages/langchain_community/document_loaders/base_o365.py
new file mode 100644
index 0000000000000000000000000000000000000000..90dba6d29e67cf53a54eeccdfb94fbca98c9f6d5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/base_o365.py
@@ -0,0 +1,199 @@
+"""Base class for all loaders that uses O365 Package"""
+from __future__ import annotations
+
+import logging
+import os
+import tempfile
+from abc import abstractmethod
+from enum import Enum
+from pathlib import Path
+from typing import TYPE_CHECKING, Dict, Iterable, List, Sequence, Union
+
+from langchain_core.pydantic_v1 import (
+    BaseModel,
+    BaseSettings,
+    Field,
+    FilePath,
+    SecretStr,
+)
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.blob_loaders.file_system import (
+    FileSystemBlobLoader,
+)
+from langchain_community.document_loaders.blob_loaders.schema import Blob
+
+if TYPE_CHECKING:
+    from O365 import Account
+    from O365.drive import Drive, Folder
+
+logger = logging.getLogger(__name__)
+
+CHUNK_SIZE = 1024 * 1024 * 5
+
+
+class _O365Settings(BaseSettings):
+    client_id: str = Field(..., env="O365_CLIENT_ID")
+    client_secret: SecretStr = Field(..., env="O365_CLIENT_SECRET")
+
+    class Config:
+        env_prefix = ""
+        case_sentive = False
+        env_file = ".env"
+
+
+class _O365TokenStorage(BaseSettings):
+    token_path: FilePath = Path.home() / ".credentials" / "o365_token.txt"
+
+
+class _FileType(str, Enum):
+    DOC = "doc"
+    DOCX = "docx"
+    PDF = "pdf"
+
+
+def fetch_mime_types(file_types: Sequence[_FileType]) -> Dict[str, str]:
+    """Fetch the mime types for the specified file types."""
+    mime_types_mapping = {}
+    for file_type in file_types:
+        if file_type.value == "doc":
+            mime_types_mapping[file_type.value] = "application/msword"
+        elif file_type.value == "docx":
+            mime_types_mapping[
+                file_type.value
+            ] = "application/vnd.openxmlformats-officedocument.wordprocessingml.document"  # noqa: E501
+        elif file_type.value == "pdf":
+            mime_types_mapping[file_type.value] = "application/pdf"
+    return mime_types_mapping
+
+
+class O365BaseLoader(BaseLoader, BaseModel):
+    """Base class for all loaders that uses O365 Package"""
+
+    settings: _O365Settings = Field(default_factory=_O365Settings)
+    """Settings for the Office365 API client."""
+    auth_with_token: bool = False
+    """Whether to authenticate with a token or not. Defaults to False."""
+    chunk_size: Union[int, str] = CHUNK_SIZE
+    """Number of bytes to retrieve from each api call to the server. int or 'auto'."""
+    recursive: bool = False
+    """Should the loader recursively load subfolders?"""
+
+    @property
+    @abstractmethod
+    def _file_types(self) -> Sequence[_FileType]:
+        """Return supported file types."""
+
+    @property
+    def _fetch_mime_types(self) -> Dict[str, str]:
+        """Return a dict of supported file types to corresponding mime types."""
+        return fetch_mime_types(self._file_types)
+
+    @property
+    @abstractmethod
+    def _scopes(self) -> List[str]:
+        """Return required scopes."""
+
+    def _load_from_folder(self, folder: Folder) -> Iterable[Blob]:
+        """Lazily load all files from a specified folder of the configured MIME type.
+
+        Args:
+            folder: The Folder instance from which the files are to be loaded. This
+                Folder instance should represent a directory in a file system where the
+                files are stored.
+
+        Yields:
+            An iterator that yields Blob instances, which are binary representations of
+                the files loaded from the folder.
+        """
+        file_mime_types = self._fetch_mime_types
+        items = folder.get_items()
+        with tempfile.TemporaryDirectory() as temp_dir:
+            os.makedirs(os.path.dirname(temp_dir), exist_ok=True)
+            for file in items:
+                if file.is_file:
+                    if file.mime_type in list(file_mime_types.values()):
+                        file.download(to_path=temp_dir, chunk_size=self.chunk_size)
+            loader = FileSystemBlobLoader(path=temp_dir)
+            yield from loader.yield_blobs()
+        if self.recursive:
+            for subfolder in folder.get_child_folders():
+                yield from self._load_from_folder(subfolder)
+
+    def _load_from_object_ids(
+        self, drive: Drive, object_ids: List[str]
+    ) -> Iterable[Blob]:
+        """Lazily load files specified by their object_ids from a drive.
+
+        Load files into the system as binary large objects (Blobs) and return Iterable.
+
+        Args:
+            drive: The Drive instance from which the files are to be loaded. This Drive
+                instance should represent a cloud storage service or similar storage
+                system where the files are stored.
+            object_ids: A list of object_id strings. Each object_id represents a unique
+                identifier for a file in the drive.
+
+        Yields:
+            An iterator that yields Blob instances, which are binary representations of
+            the files loaded from the drive using the specified object_ids.
+        """
+        file_mime_types = self._fetch_mime_types
+        with tempfile.TemporaryDirectory() as temp_dir:
+            for object_id in object_ids:
+                file = drive.get_item(object_id)
+                if not file:
+                    logging.warning(
+                        "There isn't a file with"
+                        f"object_id {object_id} in drive {drive}."
+                    )
+                    continue
+                if file.is_file:
+                    if file.mime_type in list(file_mime_types.values()):
+                        file.download(to_path=temp_dir, chunk_size=self.chunk_size)
+            loader = FileSystemBlobLoader(path=temp_dir)
+            yield from loader.yield_blobs()
+
+    def _auth(self) -> Account:
+        """Authenticates the OneDrive API client
+
+        Returns:
+            The authenticated Account object.
+        """
+        try:
+            from O365 import Account, FileSystemTokenBackend
+        except ImportError:
+            raise ImportError(
+                "O365 package not found, please install it with `pip install o365`"
+            )
+        if self.auth_with_token:
+            token_storage = _O365TokenStorage()
+            token_path = token_storage.token_path
+            token_backend = FileSystemTokenBackend(
+                token_path=token_path.parent, token_filename=token_path.name
+            )
+            account = Account(
+                credentials=(
+                    self.settings.client_id,
+                    self.settings.client_secret.get_secret_value(),
+                ),
+                scopes=self._scopes,
+                token_backend=token_backend,
+                **{"raise_http_errors": False},
+            )
+        else:
+            token_backend = FileSystemTokenBackend(
+                token_path=Path.home() / ".credentials"
+            )
+            account = Account(
+                credentials=(
+                    self.settings.client_id,
+                    self.settings.client_secret.get_secret_value(),
+                ),
+                scopes=self._scopes,
+                token_backend=token_backend,
+                **{"raise_http_errors": False},
+            )
+            # make the auth
+            account.authenticate()
+        return account
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/bibtex.py b/llm/Lib/site-packages/langchain_community/document_loaders/bibtex.py
new file mode 100644
index 0000000000000000000000000000000000000000..49f9c6b2dbe260a8c3fa9617af63dd9999dc25cd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/bibtex.py
@@ -0,0 +1,98 @@
+import logging
+import re
+from pathlib import Path
+from typing import Any, Iterator, List, Mapping, Optional
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.utilities.bibtex import BibtexparserWrapper
+
+logger = logging.getLogger(__name__)
+
+
+class BibtexLoader(BaseLoader):
+    """Load a `bibtex` file.
+
+    Each document represents one entry from the bibtex file.
+
+    If a PDF file is present in the `file` bibtex field, the original PDF
+    is loaded into the document text. If no such file entry is present,
+    the `abstract` field is used instead.
+    """
+
+    def __init__(
+        self,
+        file_path: str,
+        *,
+        parser: Optional[BibtexparserWrapper] = None,
+        max_docs: Optional[int] = None,
+        max_content_chars: Optional[int] = 4_000,
+        load_extra_metadata: bool = False,
+        file_pattern: str = r"[^:]+\.pdf",
+    ):
+        """Initialize the BibtexLoader.
+
+        Args:
+            file_path: Path to the bibtex file.
+            parser: The parser to use. If None, a default parser is used.
+            max_docs: Max number of associated documents to load. Use -1 means
+                           no limit.
+            max_content_chars: Maximum number of characters to load from the PDF.
+            load_extra_metadata: Whether to load extra metadata from the PDF.
+            file_pattern: Regex pattern to match the file name in the bibtex.
+        """
+        self.file_path = file_path
+        self.parser = parser or BibtexparserWrapper()
+        self.max_docs = max_docs
+        self.max_content_chars = max_content_chars
+        self.load_extra_metadata = load_extra_metadata
+        self.file_regex = re.compile(file_pattern)
+
+    def _load_entry(self, entry: Mapping[str, Any]) -> Optional[Document]:
+        import fitz
+
+        parent_dir = Path(self.file_path).parent
+        # regex is useful for Zotero flavor bibtex files
+        file_names = self.file_regex.findall(entry.get("file", ""))
+        if not file_names:
+            return None
+        texts: List[str] = []
+        for file_name in file_names:
+            try:
+                with fitz.open(parent_dir / file_name) as f:
+                    texts.extend(page.get_text() for page in f)
+            except FileNotFoundError as e:
+                logger.debug(e)
+        content = "\n".join(texts) or entry.get("abstract", "")
+        if self.max_content_chars:
+            content = content[: self.max_content_chars]
+        metadata = self.parser.get_metadata(entry, load_extra=self.load_extra_metadata)
+        return Document(
+            page_content=content,
+            metadata=metadata,
+        )
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Load bibtex file using bibtexparser and get the article texts plus the
+        article metadata.
+        See https://bibtexparser.readthedocs.io/en/master/
+
+        Returns:
+            a list of documents with the document.page_content in text format
+        """
+        try:
+            import fitz  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "PyMuPDF package not found, please install it with "
+                "`pip install pymupdf`"
+            )
+
+        entries = self.parser.load_bibtex_entries(self.file_path)
+        if self.max_docs:
+            entries = entries[: self.max_docs]
+        for entry in entries:
+            doc = self._load_entry(entry)
+            if doc:
+                yield doc
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/bigquery.py b/llm/Lib/site-packages/langchain_community/document_loaders/bigquery.py
new file mode 100644
index 0000000000000000000000000000000000000000..0d809ce53f26c87caaa2c073a5580df76634c495
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/bigquery.py
@@ -0,0 +1,100 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.utilities.vertexai import get_client_info
+
+if TYPE_CHECKING:
+    from google.auth.credentials import Credentials
+
+
+@deprecated(
+    since="0.0.32",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.BigQueryLoader",
+)
+class BigQueryLoader(BaseLoader):
+    """Load from the Google Cloud Platform `BigQuery`.
+
+    Each document represents one row of the result. The `page_content_columns`
+    are written into the `page_content` of the document. The `metadata_columns`
+    are written into the `metadata` of the document. By default, all columns
+    are written into the `page_content` and none into the `metadata`.
+
+    """
+
+    def __init__(
+        self,
+        query: str,
+        project: Optional[str] = None,
+        page_content_columns: Optional[List[str]] = None,
+        metadata_columns: Optional[List[str]] = None,
+        credentials: Optional[Credentials] = None,
+    ):
+        """Initialize BigQuery document loader.
+
+        Args:
+            query: The query to run in BigQuery.
+            project: Optional. The project to run the query in.
+            page_content_columns: Optional. The columns to write into the `page_content`
+                of the document.
+            metadata_columns: Optional. The columns to write into the `metadata` of the
+                document.
+            credentials : google.auth.credentials.Credentials, optional
+              Credentials for accessing Google APIs. Use this parameter to override
+                default credentials, such as to use Compute Engine
+                (`google.auth.compute_engine.Credentials`) or Service Account
+                (`google.oauth2.service_account.Credentials`) credentials directly.
+        """
+        self.query = query
+        self.project = project
+        self.page_content_columns = page_content_columns
+        self.metadata_columns = metadata_columns
+        self.credentials = credentials
+
+    def load(self) -> List[Document]:
+        try:
+            from google.cloud import bigquery
+        except ImportError as ex:
+            raise ImportError(
+                "Could not import google-cloud-bigquery python package. "
+                "Please install it with `pip install google-cloud-bigquery`."
+            ) from ex
+
+        bq_client = bigquery.Client(
+            credentials=self.credentials,
+            project=self.project,
+            client_info=get_client_info(module="bigquery"),
+        )
+        if not bq_client.project:
+            error_desc = (
+                "GCP project for Big Query is not set! Either provide a "
+                "`project` argument during BigQueryLoader instantiation, "
+                "or set a default project with `gcloud config set project` "
+                "command."
+            )
+            raise ValueError(error_desc)
+        query_result = bq_client.query(self.query).result()
+        docs: List[Document] = []
+
+        page_content_columns = self.page_content_columns
+        metadata_columns = self.metadata_columns
+
+        if page_content_columns is None:
+            page_content_columns = [column.name for column in query_result.schema]
+        if metadata_columns is None:
+            metadata_columns = []
+
+        for row in query_result:
+            page_content = "\n".join(
+                f"{k}: {v}" for k, v in row.items() if k in page_content_columns
+            )
+            metadata = {k: v for k, v in row.items() if k in metadata_columns}
+            doc = Document(page_content=page_content, metadata=metadata)
+            docs.append(doc)
+
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/bilibili.py b/llm/Lib/site-packages/langchain_community/document_loaders/bilibili.py
new file mode 100644
index 0000000000000000000000000000000000000000..192311f59da7d21d1fffce70128d54fdffdb2008
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/bilibili.py
@@ -0,0 +1,126 @@
+import json
+import re
+import warnings
+from typing import List, Tuple
+
+import requests
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+# Pre-compile regular expressions for video ID extraction
+BV_PATTERN = re.compile(r"BV\w+")
+AV_PATTERN = re.compile(r"av[0-9]+")
+
+
+class BiliBiliLoader(BaseLoader):
+    """
+    Load fetching transcripts from BiliBili videos.
+    """
+
+    def __init__(
+        self,
+        video_urls: List[str],
+        sessdata: str = "",
+        bili_jct: str = "",
+        buvid3: str = "",
+    ):
+        """
+        Initialize the loader with BiliBili video URLs and authentication cookies.
+        if no authentication cookies are provided, the loader can't get transcripts
+        and will only fetch videos info.
+
+        Args:
+            video_urls (List[str]): List of BiliBili video URLs.
+            sessdata (str): SESSDATA cookie value for authentication.
+            bili_jct (str): BILI_JCT cookie value for authentication.
+            buvid3 (str): BUVI3 cookie value for authentication.
+        """
+        self.video_urls = video_urls
+        self.credential = None
+        try:
+            from bilibili_api import video
+        except ImportError:
+            raise ImportError(
+                "requests package not found, please install it with "
+                "`pip install bilibili-api-python`"
+            )
+        if sessdata and bili_jct and buvid3:
+            self.credential = video.Credential(
+                sessdata=sessdata, bili_jct=bili_jct, buvid3=buvid3
+            )
+
+    def load(self) -> List[Document]:
+        """
+        Load and return a list of documents containing video transcripts.
+
+        Returns:
+            List[Document]: List of Document objects transcripts and metadata.
+        """
+        results = []
+        for url in self.video_urls:
+            transcript, video_info = self._get_bilibili_subs_and_info(url)
+            doc = Document(page_content=transcript, metadata=video_info)
+            results.append(doc)
+
+        return results
+
+    def _get_bilibili_subs_and_info(self, url: str) -> Tuple[str, dict]:
+        """
+        Retrieve video information and transcript for a given BiliBili URL.
+        """
+        bvid = BV_PATTERN.search(url)
+        try:
+            from bilibili_api import sync, video
+        except ImportError:
+            raise ImportError(
+                "requests package not found, please install it with "
+                "`pip install bilibili-api-python`"
+            )
+        if bvid:
+            v = video.Video(bvid=bvid.group(), credential=self.credential)
+        else:
+            aid = AV_PATTERN.search(url)
+            if aid:
+                v = video.Video(aid=int(aid.group()[2:]), credential=self.credential)
+            else:
+                raise ValueError(f"Unable to find a valid video ID in URL: {url}")
+
+        video_info = sync(v.get_info())
+        video_info.update({"url": url})
+
+        # Return if no credential is provided
+        if not self.credential:
+            return "", video_info
+
+        # Fetching and processing subtitles
+        sub = sync(v.get_subtitle(video_info["cid"]))
+        sub_list = sub.get("subtitles", [])
+        if sub_list:
+            sub_url = sub_list[0].get("subtitle_url", "")
+            if not sub_url.startswith("http"):
+                sub_url = "https:" + sub_url
+
+            response = requests.get(sub_url)
+            if response.status_code == 200:
+                raw_sub_titles = json.loads(response.content).get("body", [])
+                raw_transcript = " ".join([c["content"] for c in raw_sub_titles])
+
+                raw_transcript_with_meta_info = (
+                    f"Video Title: {video_info['title']}, "
+                    f"description: {video_info['desc']}\n\n"
+                    f"Transcript: {raw_transcript}"
+                )
+                return raw_transcript_with_meta_info, video_info
+            else:
+                warnings.warn(
+                    f"Failed to fetch subtitles for {url}. "
+                    f"HTTP Status Code: {response.status_code}"
+                )
+        else:
+            warnings.warn(
+                f"No subtitles found for video: {url}. Returning empty transcript."
+            )
+
+        # Return empty transcript if no subtitles are found
+        return "", video_info
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/blackboard.py b/llm/Lib/site-packages/langchain_community/document_loaders/blackboard.py
new file mode 100644
index 0000000000000000000000000000000000000000..682eafb3cebc7db916023ff611a216ca39dc6f94
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/blackboard.py
@@ -0,0 +1,298 @@
+import contextlib
+import re
+from pathlib import Path
+from typing import Any, List, Optional, Tuple
+from urllib.parse import unquote
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.directory import DirectoryLoader
+from langchain_community.document_loaders.pdf import PyPDFLoader
+from langchain_community.document_loaders.web_base import WebBaseLoader
+
+
+class BlackboardLoader(WebBaseLoader):
+    """Load a `Blackboard` course.
+
+    This loader is not compatible with all Blackboard courses. It is only
+    compatible with courses that use the new Blackboard interface.
+    To use this loader, you must have the BbRouter cookie. You can get this
+    cookie by logging into the course and then copying the value of the
+    BbRouter cookie from the browser's developer tools.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.document_loaders import BlackboardLoader
+
+            loader = BlackboardLoader(
+                blackboard_course_url="https://blackboard.example.com/webapps/blackboard/execute/announcement?method=search&context=course_entry&course_id=_123456_1",
+                bbrouter="expires:12345...",
+            )
+            documents = loader.load()
+
+    """  # noqa: E501
+
+    def __init__(
+        self,
+        blackboard_course_url: str,
+        bbrouter: str,
+        load_all_recursively: bool = True,
+        basic_auth: Optional[Tuple[str, str]] = None,
+        cookies: Optional[dict] = None,
+        continue_on_failure: bool = False,
+    ):
+        """Initialize with blackboard course url.
+
+        The BbRouter cookie is required for most blackboard courses.
+
+        Args:
+            blackboard_course_url: Blackboard course url.
+            bbrouter: BbRouter cookie.
+            load_all_recursively: If True, load all documents recursively.
+            basic_auth: Basic auth credentials.
+            cookies: Cookies.
+            continue_on_failure: whether to continue loading the sitemap if an error
+                occurs loading a url, emitting a warning instead of raising an
+                exception. Setting this to True makes the loader more robust, but also
+                may result in missing data. Default: False
+
+        Raises:
+            ValueError: If blackboard course url is invalid.
+        """
+        super().__init__(
+            web_paths=(blackboard_course_url), continue_on_failure=continue_on_failure
+        )
+        # Get base url
+        try:
+            self.base_url = blackboard_course_url.split("/webapps/blackboard")[0]
+        except IndexError:
+            raise IndexError(
+                "Invalid blackboard course url. "
+                "Please provide a url that starts with "
+                "https://<blackboard_url>/webapps/blackboard"
+            )
+        if basic_auth is not None:
+            self.session.auth = basic_auth
+        # Combine cookies
+        if cookies is None:
+            cookies = {}
+        cookies.update({"BbRouter": bbrouter})
+        self.session.cookies.update(cookies)
+        self.load_all_recursively = load_all_recursively
+        self.check_bs4()
+
+    def check_bs4(self) -> None:
+        """Check if BeautifulSoup4 is installed.
+
+        Raises:
+            ImportError: If BeautifulSoup4 is not installed.
+        """
+        try:
+            import bs4  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "BeautifulSoup4 is required for BlackboardLoader. "
+                "Please install it with `pip install beautifulsoup4`."
+            )
+
+    def load(self) -> List[Document]:
+        """Load data into Document objects.
+
+        Returns:
+            List of Documents.
+        """
+        if self.load_all_recursively:
+            soup_info = self.scrape()
+            self.folder_path = self._get_folder_path(soup_info)
+            relative_paths = self._get_paths(soup_info)
+            documents = []
+            for path in relative_paths:
+                url = self.base_url + path
+                print(f"Fetching documents from {url}")  # noqa: T201
+                soup_info = self._scrape(url)
+                with contextlib.suppress(ValueError):
+                    documents.extend(self._get_documents(soup_info))
+            return documents
+        else:
+            print(f"Fetching documents from {self.web_path}")  # noqa: T201
+            soup_info = self.scrape()
+            self.folder_path = self._get_folder_path(soup_info)
+            return self._get_documents(soup_info)
+
+    def _get_folder_path(self, soup: Any) -> str:
+        """Get the folder path to save the Documents in.
+
+        Args:
+            soup: BeautifulSoup4 soup object.
+
+        Returns:
+            Folder path.
+        """
+        # Get the course name
+        course_name = soup.find("span", {"id": "crumb_1"})
+        if course_name is None:
+            raise ValueError("No course name found.")
+        course_name = course_name.text.strip()
+        # Prepare the folder path
+        course_name_clean = (
+            unquote(course_name)
+            .replace(" ", "_")
+            .replace("/", "_")
+            .replace(":", "_")
+            .replace(",", "_")
+            .replace("?", "_")
+            .replace("'", "_")
+            .replace("!", "_")
+            .replace('"', "_")
+        )
+        # Get the folder path
+        folder_path = Path(".") / course_name_clean
+        return str(folder_path)
+
+    def _get_documents(self, soup: Any) -> List[Document]:
+        """Fetch content from page and return Documents.
+
+        Args:
+            soup: BeautifulSoup4 soup object.
+
+        Returns:
+            List of documents.
+        """
+        attachments = self._get_attachments(soup)
+        self._download_attachments(attachments)
+        documents = self._load_documents()
+        return documents
+
+    def _get_attachments(self, soup: Any) -> List[str]:
+        """Get all attachments from a page.
+
+        Args:
+            soup: BeautifulSoup4 soup object.
+
+        Returns:
+            List of attachments.
+        """
+        from bs4 import BeautifulSoup, Tag
+
+        # Get content list
+        content_list: BeautifulSoup
+        content_list = soup.find("ul", {"class": "contentList"})
+        if content_list is None:
+            raise ValueError("No content list found.")
+        # Get all attachments
+        attachments = []
+        attachment: Tag
+        for attachment in content_list.find_all("ul", {"class": "attachments"}):
+            link: Tag
+            for link in attachment.find_all("a"):
+                href = link.get("href")
+                # Only add if href is not None and does not start with #
+                if href is not None and not href.startswith("#"):
+                    attachments.append(href)
+        return attachments
+
+    def _download_attachments(self, attachments: List[str]) -> None:
+        """Download all attachments.
+
+        Args:
+            attachments: List of attachments.
+        """
+        # Make sure the folder exists
+        Path(self.folder_path).mkdir(parents=True, exist_ok=True)
+        # Download all attachments
+        for attachment in attachments:
+            self.download(attachment)
+
+    def _load_documents(self) -> List[Document]:
+        """Load all documents in the folder.
+
+        Returns:
+            List of documents.
+        """
+        # Create the document loader
+        loader = DirectoryLoader(
+            path=self.folder_path,
+            glob="*.pdf",
+            loader_cls=PyPDFLoader,  # type: ignore
+        )
+        # Load the documents
+        documents = loader.load()
+        # Return all documents
+        return documents
+
+    def _get_paths(self, soup: Any) -> List[str]:
+        """Get all relative paths in the navbar."""
+        relative_paths = []
+        course_menu = soup.find("ul", {"class": "courseMenu"})
+        if course_menu is None:
+            raise ValueError("No course menu found.")
+        for link in course_menu.find_all("a"):
+            href = link.get("href")
+            if href is not None and href.startswith("/"):
+                relative_paths.append(href)
+        return relative_paths
+
+    def download(self, path: str) -> None:
+        """Download a file from an url.
+
+        Args:
+            path: Path to the file.
+        """
+        # Get the file content
+        response = self.session.get(self.base_url + path, allow_redirects=True)
+        # Get the filename
+        filename = self.parse_filename(response.url)
+        # Write the file to disk
+        with open(Path(self.folder_path) / filename, "wb") as f:
+            f.write(response.content)
+
+    def parse_filename(self, url: str) -> str:
+        """Parse the filename from an url.
+
+        Args:
+            url: Url to parse the filename from.
+
+        Returns:
+            The filename.
+        """
+        if (url_path := Path(url)) and url_path.suffix == ".pdf":
+            return url_path.name
+        else:
+            return self._parse_filename_from_url(url)
+
+    def _parse_filename_from_url(self, url: str) -> str:
+        """Parse the filename from an url.
+
+        Args:
+            url: Url to parse the filename from.
+
+        Returns:
+            The filename.
+
+        Raises:
+            ValueError: If the filename could not be parsed.
+        """
+        filename_matches = re.search(r"filename%2A%3DUTF-8%27%27(.+)", url)
+        if filename_matches:
+            filename = filename_matches.group(1)
+        else:
+            raise ValueError(f"Could not parse filename from {url}")
+        if ".pdf" not in filename:
+            raise ValueError(f"Incorrect file type: {filename}")
+        filename = filename.split(".pdf")[0] + ".pdf"
+        filename = unquote(filename)
+        filename = filename.replace("%20", " ")
+        return filename
+
+
+if __name__ == "__main__":
+    loader = BlackboardLoader(
+        "https://<YOUR BLACKBOARD URL"
+        " HERE>/webapps/blackboard/content/listContent.jsp?course_id=_<YOUR COURSE ID"
+        " HERE>_1&content_id=_<YOUR CONTENT ID HERE>_1&mode=reset",
+        "<YOUR BBROUTER COOKIE HERE>",
+        load_all_recursively=True,
+    )
+    documents = loader.load()
+    print(f"Loaded {len(documents)} pages of PDFs from {loader.web_path}")  # noqa: T201
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__init__.py b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..910714da54169ccd80e1b15dbaaf35efad1e00ae
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__init__.py
@@ -0,0 +1,19 @@
+import importlib
+from typing import Any
+
+_module_lookup = {
+    "Blob": "langchain_community.document_loaders.blob_loaders.schema",
+    "BlobLoader": "langchain_community.document_loaders.blob_loaders.schema",
+    "FileSystemBlobLoader": "langchain_community.document_loaders.blob_loaders.file_system",  # noqa: E501
+    "YoutubeAudioLoader": "langchain_community.document_loaders.blob_loaders.youtube_audio",  # noqa: E501
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..869b630c4fd2b47db0f527f09116f9d6367319fb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__pycache__/file_system.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__pycache__/file_system.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dfabb8ab29fc3fcf63d8bbef0b711411d6ff83bc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__pycache__/file_system.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__pycache__/schema.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__pycache__/schema.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..53a32abf350bdccada1203accdd1469152e543be
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__pycache__/schema.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__pycache__/youtube_audio.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__pycache__/youtube_audio.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fc0346875e4ebec29d36136c9c49658b18550107
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/__pycache__/youtube_audio.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/file_system.py b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/file_system.py
new file mode 100644
index 0000000000000000000000000000000000000000..ee756f32ed73e90c8f2700f8d451d53fdddabdb5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/file_system.py
@@ -0,0 +1,149 @@
+"""Use to load blobs from the local file system."""
+
+from pathlib import Path
+from typing import Callable, Iterable, Iterator, Optional, Sequence, TypeVar, Union
+
+from langchain_community.document_loaders.blob_loaders.schema import Blob, BlobLoader
+
+T = TypeVar("T")
+
+
+def _make_iterator(
+    length_func: Callable[[], int], show_progress: bool = False
+) -> Callable[[Iterable[T]], Iterator[T]]:
+    """Create a function that optionally wraps an iterable in tqdm."""
+    iterator: Callable[[Iterable[T]], Iterator[T]]
+    if show_progress:
+        try:
+            from tqdm.auto import tqdm
+        except ImportError:
+            raise ImportError(
+                "You must install tqdm to use show_progress=True."
+                "You can install tqdm with `pip install tqdm`."
+            )
+
+        # Make sure to provide `total` here so that tqdm can show
+        # a progress bar that takes into account the total number of files.
+        def _with_tqdm(iterable: Iterable[T]) -> Iterator[T]:
+            """Wrap an iterable in a tqdm progress bar."""
+            return tqdm(iterable, total=length_func())
+
+        iterator = _with_tqdm
+    else:
+        iterator = iter
+
+    return iterator
+
+
+# PUBLIC API
+
+
+class FileSystemBlobLoader(BlobLoader):
+    """Load blobs in the local file system.
+
+    Example:
+
+    .. code-block:: python
+
+        from langchain_community.document_loaders.blob_loaders import FileSystemBlobLoader
+        loader = FileSystemBlobLoader("/path/to/directory")
+        for blob in loader.yield_blobs():
+            print(blob)  # noqa: T201
+    """  # noqa: E501
+
+    def __init__(
+        self,
+        path: Union[str, Path],
+        *,
+        glob: str = "**/[!.]*",
+        exclude: Sequence[str] = (),
+        suffixes: Optional[Sequence[str]] = None,
+        show_progress: bool = False,
+    ) -> None:
+        """Initialize with a path to directory and how to glob over it.
+
+        Args:
+            path: Path to directory to load from or path to file to load.
+                  If a path to a file is provided, glob/exclude/suffixes are ignored.
+            glob: Glob pattern relative to the specified path
+                  by default set to pick up all non-hidden files
+            exclude: patterns to exclude from results, use glob syntax
+            suffixes: Provide to keep only files with these suffixes
+                      Useful when wanting to keep files with different suffixes
+                      Suffixes must include the dot, e.g. ".txt"
+            show_progress: If true, will show a progress bar as the files are loaded.
+                           This forces an iteration through all matching files
+                           to count them prior to loading them.
+
+        Examples:
+
+            .. code-block:: python
+                from langchain_community.document_loaders.blob_loaders import FileSystemBlobLoader
+
+                # Load a single file.
+                loader = FileSystemBlobLoader("/path/to/file.txt")
+
+                # Recursively load all text files in a directory.
+                loader = FileSystemBlobLoader("/path/to/directory", glob="**/*.txt")
+
+                # Recursively load all non-hidden files in a directory.
+                loader = FileSystemBlobLoader("/path/to/directory", glob="**/[!.]*")
+
+                # Load all files in a directory without recursion.
+                loader = FileSystemBlobLoader("/path/to/directory", glob="*")
+
+                # Recursively load all files in a directory, except for py or pyc files.
+                loader = FileSystemBlobLoader(
+                    "/path/to/directory",
+                    glob="**/*.txt",
+                    exclude=["**/*.py", "**/*.pyc"]
+                )
+        """  # noqa: E501
+        if isinstance(path, Path):
+            _path = path
+        elif isinstance(path, str):
+            _path = Path(path)
+        else:
+            raise TypeError(f"Expected str or Path, got {type(path)}")
+
+        self.path = _path.expanduser()  # Expand user to handle ~
+        self.glob = glob
+        self.suffixes = set(suffixes or [])
+        self.show_progress = show_progress
+        self.exclude = exclude
+
+    def yield_blobs(
+        self,
+    ) -> Iterable[Blob]:
+        """Yield blobs that match the requested pattern."""
+        iterator = _make_iterator(
+            length_func=self.count_matching_files, show_progress=self.show_progress
+        )
+
+        for path in iterator(self._yield_paths()):
+            yield Blob.from_path(path)
+
+    def _yield_paths(self) -> Iterable[Path]:
+        """Yield paths that match the requested pattern."""
+        if self.path.is_file():
+            yield self.path
+            return
+
+        paths = self.path.glob(self.glob)
+        for path in paths:
+            if self.exclude:
+                if any(path.match(glob) for glob in self.exclude):
+                    continue
+            if path.is_file():
+                if self.suffixes and path.suffix not in self.suffixes:
+                    continue
+                yield path
+
+    def count_matching_files(self) -> int:
+        """Count files that match the pattern without loading them."""
+        # Carry out a full iteration to count the files without
+        # materializing anything expensive in memory.
+        num = 0
+        for _ in self._yield_paths():
+            num += 1
+        return num
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/schema.py b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/schema.py
new file mode 100644
index 0000000000000000000000000000000000000000..208510eaeac507c0007b09aeee92f1d1d2ca4eaa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/schema.py
@@ -0,0 +1,7 @@
+from langchain_core.document_loaders.blob_loaders import Blob, BlobLoader, PathLike
+
+__all__ = [
+    "Blob",
+    "BlobLoader",
+    "PathLike",
+]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/youtube_audio.py b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/youtube_audio.py
new file mode 100644
index 0000000000000000000000000000000000000000..f7313d04a6687c8742374f4351a07478f306f426
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/blob_loaders/youtube_audio.py
@@ -0,0 +1,50 @@
+from typing import Iterable, List
+
+from langchain_community.document_loaders.blob_loaders import FileSystemBlobLoader
+from langchain_community.document_loaders.blob_loaders.schema import Blob, BlobLoader
+
+
+class YoutubeAudioLoader(BlobLoader):
+
+    """Load YouTube urls as audio file(s)."""
+
+    def __init__(self, urls: List[str], save_dir: str):
+        if not isinstance(urls, list):
+            raise TypeError("urls must be a list")
+
+        self.urls = urls
+        self.save_dir = save_dir
+
+    def yield_blobs(self) -> Iterable[Blob]:
+        """Yield audio blobs for each url."""
+
+        try:
+            import yt_dlp
+        except ImportError:
+            raise ImportError(
+                "yt_dlp package not found, please install it with "
+                "`pip install yt_dlp`"
+            )
+
+        # Use yt_dlp to download audio given a YouTube url
+        ydl_opts = {
+            "format": "m4a/bestaudio/best",
+            "noplaylist": True,
+            "outtmpl": self.save_dir + "/%(title)s.%(ext)s",
+            "postprocessors": [
+                {
+                    "key": "FFmpegExtractAudio",
+                    "preferredcodec": "m4a",
+                }
+            ],
+        }
+
+        for url in self.urls:
+            # Download file
+            with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+                ydl.download(url)
+
+        # Yield the written blobs
+        loader = FileSystemBlobLoader(self.save_dir, glob="*.m4a")
+        for blob in loader.yield_blobs():
+            yield blob
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/blockchain.py b/llm/Lib/site-packages/langchain_community/document_loaders/blockchain.py
new file mode 100644
index 0000000000000000000000000000000000000000..69a6a344fd3b1d084a12ddf5207cf23614e515a0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/blockchain.py
@@ -0,0 +1,168 @@
+import os
+import re
+import time
+from enum import Enum
+from typing import List, Optional
+
+import requests
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class BlockchainType(Enum):
+    """Enumerator of the supported blockchains."""
+
+    ETH_MAINNET = "eth-mainnet"
+    ETH_GOERLI = "eth-goerli"
+    POLYGON_MAINNET = "polygon-mainnet"
+    POLYGON_MUMBAI = "polygon-mumbai"
+
+
+class BlockchainDocumentLoader(BaseLoader):
+    """Load elements from a blockchain smart contract.
+
+    The supported blockchains are: Ethereum mainnet, Ethereum Goerli testnet,
+    Polygon mainnet, and Polygon Mumbai testnet.
+
+    If no BlockchainType is specified, the default is Ethereum mainnet.
+
+    The Loader uses the Alchemy API to interact with the blockchain.
+    ALCHEMY_API_KEY environment variable must be set to use this loader.
+
+    The API returns 100 NFTs per request and can be paginated using the
+    startToken parameter.
+
+    If get_all_tokens is set to True, the loader will get all tokens
+    on the contract.  Note that for contracts with a large number of tokens,
+    this may take a long time (e.g. 10k tokens is 100 requests).
+    Default value is false for this reason.
+
+    The max_execution_time (sec) can be set to limit the execution time
+    of the loader.
+
+    Future versions of this loader can:
+        - Support additional Alchemy APIs (e.g. getTransactions, etc.)
+        - Support additional blockain APIs (e.g. Infura, Opensea, etc.)
+    """
+
+    def __init__(
+        self,
+        contract_address: str,
+        blockchainType: BlockchainType = BlockchainType.ETH_MAINNET,
+        api_key: str = "docs-demo",
+        startToken: str = "",
+        get_all_tokens: bool = False,
+        max_execution_time: Optional[int] = None,
+    ):
+        """
+
+        Args:
+            contract_address: The address of the smart contract.
+            blockchainType: The blockchain type.
+            api_key: The Alchemy API key.
+            startToken: The start token for pagination.
+            get_all_tokens: Whether to get all tokens on the contract.
+            max_execution_time: The maximum execution time (sec).
+        """
+        self.contract_address = contract_address
+        self.blockchainType = blockchainType.value
+        self.api_key = os.environ.get("ALCHEMY_API_KEY") or api_key
+        self.startToken = startToken
+        self.get_all_tokens = get_all_tokens
+        self.max_execution_time = max_execution_time
+
+        if not self.api_key:
+            raise ValueError("Alchemy API key not provided.")
+
+        if not re.match(r"^0x[a-fA-F0-9]{40}$", self.contract_address):
+            raise ValueError(f"Invalid contract address {self.contract_address}")
+
+    def load(self) -> List[Document]:
+        result = []
+
+        current_start_token = self.startToken
+
+        start_time = time.time()
+
+        while True:
+            url = (
+                f"https://{self.blockchainType}.g.alchemy.com/nft/v2/"
+                f"{self.api_key}/getNFTsForCollection?withMetadata="
+                f"True&contractAddress={self.contract_address}"
+                f"&startToken={current_start_token}"
+            )
+
+            response = requests.get(url)
+
+            if response.status_code != 200:
+                raise ValueError(
+                    f"Request failed with status code {response.status_code}"
+                )
+
+            items = response.json()["nfts"]
+
+            if not items:
+                break
+
+            for item in items:
+                content = str(item)
+                tokenId = item["id"]["tokenId"]
+                metadata = {
+                    "source": self.contract_address,
+                    "blockchain": self.blockchainType,
+                    "tokenId": tokenId,
+                }
+                result.append(Document(page_content=content, metadata=metadata))
+
+            # exit after the first API call if get_all_tokens is False
+            if not self.get_all_tokens:
+                break
+
+            # get the start token for the next API call from the last item in array
+            current_start_token = self._get_next_tokenId(result[-1].metadata["tokenId"])
+
+            if (
+                self.max_execution_time is not None
+                and (time.time() - start_time) > self.max_execution_time
+            ):
+                raise RuntimeError("Execution time exceeded the allowed time limit.")
+
+        if not result:
+            raise ValueError(
+                f"No NFTs found for contract address {self.contract_address}"
+            )
+
+        return result
+
+    # add one to the tokenId, ensuring the correct tokenId format is used
+    def _get_next_tokenId(self, tokenId: str) -> str:
+        value_type = self._detect_value_type(tokenId)
+
+        if value_type == "hex_0x":
+            value_int = int(tokenId, 16)
+        elif value_type == "hex_0xbf":
+            value_int = int(tokenId[2:], 16)
+        else:
+            value_int = int(tokenId)
+
+        result = value_int + 1
+
+        if value_type == "hex_0x":
+            return "0x" + format(result, "0" + str(len(tokenId) - 2) + "x")
+        elif value_type == "hex_0xbf":
+            return "0xbf" + format(result, "0" + str(len(tokenId) - 4) + "x")
+        else:
+            return str(result)
+
+    # A smart contract can use different formats for the tokenId
+    @staticmethod
+    def _detect_value_type(tokenId: str) -> str:
+        if isinstance(tokenId, int):
+            return "int"
+        elif tokenId.startswith("0x"):
+            return "hex_0x"
+        elif tokenId.startswith("0xbf"):
+            return "hex_0xbf"
+        else:
+            return "hex_0xbf"
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/brave_search.py b/llm/Lib/site-packages/langchain_community/document_loaders/brave_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..7fa5ff13624c138dba89512343a7f07c2e6d7dd6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/brave_search.py
@@ -0,0 +1,33 @@
+from typing import Iterator, List, Optional
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.utilities.brave_search import BraveSearchWrapper
+
+
+class BraveSearchLoader(BaseLoader):
+    """Load with `Brave Search` engine."""
+
+    def __init__(self, query: str, api_key: str, search_kwargs: Optional[dict] = None):
+        """Initializes the BraveLoader.
+
+        Args:
+            query: The query to search for.
+            api_key: The API key to use.
+            search_kwargs: The search kwargs to use.
+        """
+        self.query = query
+        self.api_key = api_key
+        self.search_kwargs = search_kwargs or {}
+
+    def load(self) -> List[Document]:
+        brave_client = BraveSearchWrapper(
+            api_key=self.api_key,
+            search_kwargs=self.search_kwargs,
+        )
+        return brave_client.download_documents(self.query)
+
+    def lazy_load(self) -> Iterator[Document]:
+        for doc in self.load():
+            yield doc
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/browserless.py b/llm/Lib/site-packages/langchain_community/document_loaders/browserless.py
new file mode 100644
index 0000000000000000000000000000000000000000..3a315be44b41615bdf183af2113646923afdda4b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/browserless.py
@@ -0,0 +1,63 @@
+from typing import Iterator, List, Union
+
+import requests
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class BrowserlessLoader(BaseLoader):
+    """Load webpages with `Browserless` /content endpoint."""
+
+    def __init__(
+        self, api_token: str, urls: Union[str, List[str]], text_content: bool = True
+    ):
+        """Initialize with API token and the URLs to scrape"""
+        self.api_token = api_token
+        """Browserless API token."""
+        self.urls = urls
+        """List of URLs to scrape."""
+        self.text_content = text_content
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Lazy load Documents from URLs."""
+
+        for url in self.urls:
+            if self.text_content:
+                response = requests.post(
+                    "https://chrome.browserless.io/scrape",
+                    params={
+                        "token": self.api_token,
+                    },
+                    json={
+                        "url": url,
+                        "elements": [
+                            {
+                                "selector": "body",
+                            }
+                        ],
+                    },
+                )
+                yield Document(
+                    page_content=response.json()["data"][0]["results"][0]["text"],
+                    metadata={
+                        "source": url,
+                    },
+                )
+            else:
+                response = requests.post(
+                    "https://chrome.browserless.io/content",
+                    params={
+                        "token": self.api_token,
+                    },
+                    json={
+                        "url": url,
+                    },
+                )
+
+                yield Document(
+                    page_content=response.text,
+                    metadata={
+                        "source": url,
+                    },
+                )
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/cassandra.py b/llm/Lib/site-packages/langchain_community/document_loaders/cassandra.py
new file mode 100644
index 0000000000000000000000000000000000000000..083a32d0a94ba57e59695c8db495b755ed981a6a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/cassandra.py
@@ -0,0 +1,128 @@
+from __future__ import annotations
+
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Callable,
+    Iterator,
+    Optional,
+    Sequence,
+    Union,
+)
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.utilities.cassandra import wrapped_response_future
+
+_NOT_SET = object()
+
+if TYPE_CHECKING:
+    from cassandra.cluster import Session
+    from cassandra.pool import Host
+    from cassandra.query import Statement
+
+
+class CassandraLoader(BaseLoader):
+    def __init__(
+        self,
+        table: Optional[str] = None,
+        session: Optional[Session] = None,
+        keyspace: Optional[str] = None,
+        query: Union[str, Statement, None] = None,
+        page_content_mapper: Callable[[Any], str] = str,
+        metadata_mapper: Callable[[Any], dict] = lambda _: {},
+        *,
+        query_parameters: Union[dict, Sequence, None] = None,
+        query_timeout: Optional[float] = _NOT_SET,  # type: ignore[assignment]
+        query_trace: bool = False,
+        query_custom_payload: Optional[dict] = None,
+        query_execution_profile: Any = _NOT_SET,
+        query_paging_state: Any = None,
+        query_host: Optional[Host] = None,
+        query_execute_as: Optional[str] = None,
+    ) -> None:
+        """
+        Document Loader for Apache Cassandra.
+
+        Args:
+            table: The table to load the data from.
+                (do not use together with the query parameter)
+            session: The cassandra driver session.
+                If not provided, the cassio resolved session will be used.
+            keyspace: The keyspace of the table.
+                If not provided, the cassio resolved keyspace will be used.
+            query: The query used to load the data.
+                (do not use together with the table parameter)
+            page_content_mapper: a function to convert a row to string page content.
+                Defaults to the str representation of the row.
+            query_parameters: The query parameters used when calling session.execute .
+            query_timeout: The query timeout used when calling session.execute .
+            query_custom_payload: The query custom_payload used when calling
+                session.execute .
+            query_execution_profile: The query execution_profile used when calling
+                session.execute .
+            query_host: The query host used when calling session.execute .
+            query_execute_as: The query execute_as used when calling session.execute .
+        """
+        if query and table:
+            raise ValueError("Cannot specify both query and table.")
+
+        if not query and not table:
+            raise ValueError("Must specify query or table.")
+
+        if not session or (table and not keyspace):
+            try:
+                from cassio.config import check_resolve_keyspace, check_resolve_session
+            except (ImportError, ModuleNotFoundError):
+                raise ImportError(
+                    "Could not import a recent cassio package."
+                    "Please install it with `pip install --upgrade cassio`."
+                )
+
+        if table:
+            _keyspace = keyspace or check_resolve_keyspace(keyspace)
+            self.query = f"SELECT * FROM {_keyspace}.{table};"
+            self.metadata = {"table": table, "keyspace": _keyspace}
+        else:
+            self.query = query  # type: ignore[assignment]
+            self.metadata = {}
+
+        self.session = session or check_resolve_session(session)
+        self.page_content_mapper = page_content_mapper
+        self.metadata_mapper = metadata_mapper
+
+        self.query_kwargs = {
+            "parameters": query_parameters,
+            "trace": query_trace,
+            "custom_payload": query_custom_payload,
+            "paging_state": query_paging_state,
+            "host": query_host,
+            "execute_as": query_execute_as,
+        }
+        if query_timeout is not _NOT_SET:
+            self.query_kwargs["timeout"] = query_timeout
+
+        if query_execution_profile is not _NOT_SET:
+            self.query_kwargs["execution_profile"] = query_execution_profile
+
+    def lazy_load(self) -> Iterator[Document]:
+        for row in self.session.execute(self.query, **self.query_kwargs):
+            metadata = self.metadata.copy()
+            metadata.update(self.metadata_mapper(row))
+            yield Document(
+                page_content=self.page_content_mapper(row), metadata=metadata
+            )
+
+    async def alazy_load(self) -> AsyncIterator[Document]:
+        for row in await wrapped_response_future(
+            self.session.execute_async,
+            self.query,
+            **self.query_kwargs,
+        ):
+            metadata = self.metadata.copy()
+            metadata.update(self.metadata_mapper(row))
+            yield Document(
+                page_content=self.page_content_mapper(row), metadata=metadata
+            )
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/chatgpt.py b/llm/Lib/site-packages/langchain_community/document_loaders/chatgpt.py
new file mode 100644
index 0000000000000000000000000000000000000000..b6001be41915d313714d2581b47c1bc7528e72db
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/chatgpt.py
@@ -0,0 +1,65 @@
+import datetime
+import json
+from typing import List
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+def concatenate_rows(message: dict, title: str) -> str:
+    """
+    Combine message information in a readable format ready to be used.
+    Args:
+        message: Message to be concatenated
+        title: Title of the conversation
+
+    Returns:
+        Concatenated message
+    """
+    if not message:
+        return ""
+
+    sender = message["author"]["role"] if message["author"] else "unknown"
+    text = message["content"]["parts"][0]
+    date = datetime.datetime.fromtimestamp(message["create_time"]).strftime(
+        "%Y-%m-%d %H:%M:%S"
+    )
+    return f"{title} - {sender} on {date}: {text}\n\n"
+
+
+class ChatGPTLoader(BaseLoader):
+    """Load conversations from exported `ChatGPT` data."""
+
+    def __init__(self, log_file: str, num_logs: int = -1):
+        """Initialize a class object.
+
+        Args:
+            log_file: Path to the log file
+            num_logs: Number of logs to load. If 0, load all logs.
+        """
+        self.log_file = log_file
+        self.num_logs = num_logs
+
+    def load(self) -> List[Document]:
+        with open(self.log_file, encoding="utf8") as f:
+            data = json.load(f)[: self.num_logs] if self.num_logs else json.load(f)
+
+        documents = []
+        for d in data:
+            title = d["title"]
+            messages = d["mapping"]
+            text = "".join(
+                [
+                    concatenate_rows(messages[key]["message"], title)
+                    for idx, key in enumerate(messages)
+                    if not (
+                        idx == 0
+                        and messages[key]["message"]["author"]["role"] == "system"
+                    )
+                ]
+            )
+            metadata = {"source": str(self.log_file)}
+            documents.append(Document(page_content=text, metadata=metadata))
+
+        return documents
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/chm.py b/llm/Lib/site-packages/langchain_community/document_loaders/chm.py
new file mode 100644
index 0000000000000000000000000000000000000000..207d31bd4f8726c9c4e2d755164fed3747d94ec1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/chm.py
@@ -0,0 +1,104 @@
+from typing import TYPE_CHECKING, Dict, List, Union
+
+from langchain_community.document_loaders.unstructured import UnstructuredFileLoader
+
+if TYPE_CHECKING:
+    from chm import chm
+
+
+class UnstructuredCHMLoader(UnstructuredFileLoader):
+    """Load `CHM` files using `Unstructured`.
+
+    CHM means Microsoft Compiled HTML Help.
+
+    Examples
+    --------
+    from langchain_community.document_loaders import UnstructuredCHMLoader
+
+    loader = UnstructuredCHMLoader("example.chm")
+    docs = loader.load()
+
+    References
+    ----------
+    https://github.com/dottedmag/pychm
+    http://www.jedrea.com/chmlib/
+    """
+
+    def _get_elements(self) -> List:
+        from unstructured.partition.html import partition_html
+
+        with CHMParser(self.file_path) as f:  # type: ignore[arg-type]
+            return [
+                partition_html(text=item["content"], **self.unstructured_kwargs)
+                for item in f.load_all()
+            ]
+
+
+class CHMParser(object):
+    """Microsoft Compiled HTML Help (CHM) Parser."""
+
+    path: str
+    file: "chm.CHMFile"
+
+    def __init__(self, path: str):
+        from chm import chm
+
+        self.path = path
+        self.file = chm.CHMFile()
+        self.file.LoadCHM(path)
+
+    def __enter__(self):  # type: ignore[no-untyped-def]
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):  # type: ignore[no-untyped-def]
+        if self.file:
+            self.file.CloseCHM()
+
+    @property
+    def encoding(self) -> str:
+        return self.file.GetEncoding().decode("utf-8")
+
+    def index(self) -> List[Dict[str, str]]:
+        from urllib.parse import urlparse
+
+        from bs4 import BeautifulSoup
+
+        res = []
+        index = self.file.GetTopicsTree().decode(self.encoding)
+        soup = BeautifulSoup(index)
+        # <OBJECT ..>
+        for obj in soup.find_all("object"):
+            # <param name="Name" value="<...>">
+            # <param name="Local" value="<...>">
+            name = ""
+            local = ""
+            for param in obj.find_all("param"):
+                if param["name"] == "Name":
+                    name = param["value"]
+                if param["name"] == "Local":
+                    local = param["value"]
+            if not name or not local:
+                continue
+
+            local = urlparse(local).path
+            if not local.startswith("/"):
+                local = "/" + local
+            res.append({"name": name, "local": local})
+
+        return res
+
+    def load(self, path: Union[str, bytes]) -> str:
+        if isinstance(path, str):
+            path = path.encode("utf-8")
+        obj = self.file.ResolveObject(path)[1]
+        return self.file.RetrieveObject(obj)[1].decode(self.encoding)
+
+    def load_all(self) -> List[Dict[str, str]]:
+        res = []
+        index = self.index()
+        for item in index:
+            content = self.load(item["local"])
+            res.append(
+                {"name": item["name"], "local": item["local"], "content": content}
+            )
+        return res
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/chromium.py b/llm/Lib/site-packages/langchain_community/document_loaders/chromium.py
new file mode 100644
index 0000000000000000000000000000000000000000..8c71e89596547735953f359af7f7c15b967beb83
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/chromium.py
@@ -0,0 +1,84 @@
+import asyncio
+import logging
+from typing import Iterator, List
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+
+class AsyncChromiumLoader(BaseLoader):
+    """Scrape HTML pages from URLs using a
+    headless instance of the Chromium."""
+
+    def __init__(
+        self,
+        urls: List[str],
+        *,
+        headless: bool = True,
+    ):
+        """
+        Initialize the loader with a list of URL paths.
+
+        Args:
+            urls: A list of URLs to scrape content from.
+            headless: Whether to run browser in headless mode.
+
+        Raises:
+            ImportError: If the required 'playwright' package is not installed.
+        """
+        self.urls = urls
+        self.headless = headless
+
+        try:
+            import playwright  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "playwright is required for AsyncChromiumLoader. "
+                "Please install it with `pip install playwright`."
+            )
+
+    async def ascrape_playwright(self, url: str) -> str:
+        """
+        Asynchronously scrape the content of a given URL using Playwright's async API.
+
+        Args:
+            url (str): The URL to scrape.
+
+        Returns:
+            str: The scraped HTML content or an error message if an exception occurs.
+
+        """
+        from playwright.async_api import async_playwright
+
+        logger.info("Starting scraping...")
+        results = ""
+        async with async_playwright() as p:
+            browser = await p.chromium.launch(headless=self.headless)
+            try:
+                page = await browser.new_page()
+                await page.goto(url)
+                results = await page.content()  # Simply get the HTML content
+                logger.info("Content scraped")
+            except Exception as e:
+                results = f"Error: {e}"
+            await browser.close()
+        return results
+
+    def lazy_load(self) -> Iterator[Document]:
+        """
+        Lazily load text content from the provided URLs.
+
+        This method yields Documents one at a time as they're scraped,
+        instead of waiting to scrape all URLs before returning.
+
+        Yields:
+            Document: The scraped content encapsulated within a Document object.
+
+        """
+        for url in self.urls:
+            html_content = asyncio.run(self.ascrape_playwright(url))
+            metadata = {"source": url}
+            yield Document(page_content=html_content, metadata=metadata)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/college_confidential.py b/llm/Lib/site-packages/langchain_community/document_loaders/college_confidential.py
new file mode 100644
index 0000000000000000000000000000000000000000..5b9fb3a43c249c62160f73d4e6a71bf88a4191dc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/college_confidential.py
@@ -0,0 +1,16 @@
+from typing import List
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.web_base import WebBaseLoader
+
+
+class CollegeConfidentialLoader(WebBaseLoader):
+    """Load `College Confidential` webpages."""
+
+    def load(self) -> List[Document]:
+        """Load webpages as Documents."""
+        soup = self.scrape()
+        text = soup.select_one("main[class='skin-handler']").text
+        metadata = {"source": self.web_path}
+        return [Document(page_content=text, metadata=metadata)]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/concurrent.py b/llm/Lib/site-packages/langchain_community/document_loaders/concurrent.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b40924b8e2e3e4a881a5d4db104f001a1637bdb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/concurrent.py
@@ -0,0 +1,90 @@
+from __future__ import annotations
+
+import concurrent.futures
+from pathlib import Path
+from typing import Iterator, Literal, Optional, Sequence, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseBlobParser
+from langchain_community.document_loaders.blob_loaders import (
+    BlobLoader,
+    FileSystemBlobLoader,
+)
+from langchain_community.document_loaders.generic import GenericLoader
+from langchain_community.document_loaders.parsers.registry import get_parser
+
+_PathLike = Union[str, Path]
+
+DEFAULT = Literal["default"]
+
+
+class ConcurrentLoader(GenericLoader):
+    """Load and pars Documents concurrently."""
+
+    def __init__(
+        self,
+        blob_loader: BlobLoader,  # type: ignore[valid-type]
+        blob_parser: BaseBlobParser,
+        num_workers: int = 4,  # type: ignore[valid-type]
+    ) -> None:
+        super().__init__(blob_loader, blob_parser)
+        self.num_workers = num_workers
+
+    def lazy_load(
+        self,
+    ) -> Iterator[Document]:
+        """Load documents lazily with concurrent parsing."""
+        with concurrent.futures.ThreadPoolExecutor(
+            max_workers=self.num_workers
+        ) as executor:
+            futures = {
+                executor.submit(self.blob_parser.lazy_parse, blob)
+                for blob in self.blob_loader.yield_blobs()  # type: ignore[attr-defined]
+            }
+            for future in concurrent.futures.as_completed(futures):
+                yield from future.result()
+
+    @classmethod
+    def from_filesystem(
+        cls,
+        path: _PathLike,
+        *,
+        glob: str = "**/[!.]*",
+        exclude: Sequence[str] = (),
+        suffixes: Optional[Sequence[str]] = None,
+        show_progress: bool = False,
+        parser: Union[DEFAULT, BaseBlobParser] = "default",
+        num_workers: int = 4,
+        parser_kwargs: Optional[dict] = None,
+    ) -> ConcurrentLoader:
+        """Create a concurrent generic document loader using a filesystem blob loader.
+
+        Args:
+            path: The path to the directory to load documents from.
+            glob: The glob pattern to use to find documents.
+            suffixes: The suffixes to use to filter documents. If None, all files
+                      matching the glob will be loaded.
+            exclude: A list of patterns to exclude from the loader.
+            show_progress: Whether to show a progress bar or not (requires tqdm).
+                           Proxies to the file system loader.
+            parser: A blob parser which knows how to parse blobs into documents
+            num_workers: Max number of concurrent workers to use.
+            parser_kwargs: Keyword arguments to pass to the parser.
+        """
+        blob_loader = FileSystemBlobLoader(  # type: ignore[attr-defined, misc]
+            path,
+            glob=glob,
+            exclude=exclude,
+            suffixes=suffixes,
+            show_progress=show_progress,
+        )
+        if isinstance(parser, str):
+            if parser == "default" and cls.get_parser != GenericLoader.get_parser:
+                # There is an implementation of get_parser on the class, use it.
+                blob_parser = cls.get_parser(**(parser_kwargs or {}))
+            else:
+                blob_parser = get_parser(parser)
+        else:
+            blob_parser = parser
+        return cls(blob_loader, blob_parser, num_workers=num_workers)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/confluence.py b/llm/Lib/site-packages/langchain_community/document_loaders/confluence.py
new file mode 100644
index 0000000000000000000000000000000000000000..c27a252bb562429dd57a0aa2a71989bb92badf7d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/confluence.py
@@ -0,0 +1,779 @@
+import logging
+from enum import Enum
+from io import BytesIO
+from typing import Any, Callable, Dict, Iterator, List, Optional, Union
+
+import requests
+from langchain_core.documents import Document
+from tenacity import (
+    before_sleep_log,
+    retry,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+
+class ContentFormat(str, Enum):
+    """Enumerator of the content formats of Confluence page."""
+
+    EDITOR = "body.editor"
+    EXPORT_VIEW = "body.export_view"
+    ANONYMOUS_EXPORT_VIEW = "body.anonymous_export_view"
+    STORAGE = "body.storage"
+    VIEW = "body.view"
+
+    def get_content(self, page: dict) -> str:
+        return page["body"][self.name.lower()]["value"]
+
+
+class ConfluenceLoader(BaseLoader):
+    """Load `Confluence` pages.
+
+    Port of https://llamahub.ai/l/confluence
+    This currently supports username/api_key, Oauth2 login or personal access token
+    authentication.
+
+    Specify a list page_ids and/or space_key to load in the corresponding pages into
+    Document objects, if both are specified the union of both sets will be returned.
+
+    You can also specify a boolean `include_attachments` to include attachments, this
+    is set to False by default, if set to True all attachments will be downloaded and
+    ConfluenceReader will extract the text from the attachments and add it to the
+    Document object. Currently supported attachment types are: PDF, PNG, JPEG/JPG,
+    SVG, Word and Excel.
+
+    Confluence API supports difference format of page content. The storage format is the
+    raw XML representation for storage. The view format is the HTML representation for
+    viewing with macros are rendered as though it is viewed by users. You can pass
+    a enum `content_format` argument to specify the content format, this is
+    set to `ContentFormat.STORAGE` by default, the supported values are:
+    `ContentFormat.EDITOR`, `ContentFormat.EXPORT_VIEW`,
+    `ContentFormat.ANONYMOUS_EXPORT_VIEW`, `ContentFormat.STORAGE`,
+    and `ContentFormat.VIEW`.
+
+    Hint: space_key and page_id can both be found in the URL of a page in Confluence
+    - https://yoursite.atlassian.com/wiki/spaces/<space_key>/pages/<page_id>
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.document_loaders import ConfluenceLoader
+
+            loader = ConfluenceLoader(
+                url="https://yoursite.atlassian.com/wiki",
+                username="me",
+                api_key="12345",
+                space_key="SPACE",
+                limit=50,
+            )
+            documents = loader.load()
+
+            # Server on perm
+            loader = ConfluenceLoader(
+                url="https://confluence.yoursite.com/",
+                username="me",
+                api_key="your_password",
+                cloud=False,
+                space_key="SPACE",
+                limit=50,
+            )
+            documents = loader.load()
+
+    :param url: _description_
+    :type url: str
+    :param api_key: _description_, defaults to None
+    :type api_key: str, optional
+    :param username: _description_, defaults to None
+    :type username: str, optional
+    :param oauth2: _description_, defaults to {}
+    :type oauth2: dict, optional
+    :param token: _description_, defaults to None
+    :type token: str, optional
+    :param cloud: _description_, defaults to True
+    :type cloud: bool, optional
+    :param number_of_retries: How many times to retry, defaults to 3
+    :type number_of_retries: Optional[int], optional
+    :param min_retry_seconds: defaults to 2
+    :type min_retry_seconds: Optional[int], optional
+    :param max_retry_seconds:  defaults to 10
+    :type max_retry_seconds: Optional[int], optional
+    :param confluence_kwargs: additional kwargs to initialize confluence with
+    :type confluence_kwargs: dict, optional
+    :param space_key: Space key retrieved from a confluence URL, defaults to None
+    :type space_key: Optional[str], optional
+    :param page_ids: List of specific page IDs to load, defaults to None
+    :type page_ids: Optional[List[str]], optional
+    :param label: Get all pages with this label, defaults to None
+    :type label: Optional[str], optional
+    :param cql: CQL Expression, defaults to None
+    :type cql: Optional[str], optional
+    :param include_restricted_content: defaults to False
+    :type include_restricted_content: bool, optional
+    :param include_archived_content: Whether to include archived content,
+                                     defaults to False
+    :type include_archived_content: bool, optional
+    :param include_attachments: defaults to False
+    :type include_attachments: bool, optional
+    :param include_comments: defaults to False
+    :type include_comments: bool, optional
+    :param content_format: Specify content format, defaults to
+                            ContentFormat.STORAGE, the supported values are:
+                            `ContentFormat.EDITOR`, `ContentFormat.EXPORT_VIEW`,
+                            `ContentFormat.ANONYMOUS_EXPORT_VIEW`,
+                            `ContentFormat.STORAGE`, and `ContentFormat.VIEW`.
+    :type content_format: ContentFormat
+    :param limit: Maximum number of pages to retrieve per request, defaults to 50
+    :type limit: int, optional
+    :param max_pages: Maximum number of pages to retrieve in total, defaults 1000
+    :type max_pages: int, optional
+    :param ocr_languages: The languages to use for the Tesseract agent. To use a
+                          language, you'll first need to install the appropriate
+                          Tesseract language pack.
+    :type ocr_languages: str, optional
+    :param keep_markdown_format: Whether to keep the markdown format, defaults to
+        False
+    :type keep_markdown_format: bool
+    :param keep_newlines: Whether to keep the newlines format, defaults to
+        False
+    :type keep_newlines: bool
+    :raises ValueError: Errors while validating input
+    :raises ImportError: Required dependencies not installed.
+    """
+
+    def __init__(
+        self,
+        url: str,
+        api_key: Optional[str] = None,
+        username: Optional[str] = None,
+        session: Optional[requests.Session] = None,
+        oauth2: Optional[dict] = None,
+        token: Optional[str] = None,
+        cloud: Optional[bool] = True,
+        number_of_retries: Optional[int] = 3,
+        min_retry_seconds: Optional[int] = 2,
+        max_retry_seconds: Optional[int] = 10,
+        confluence_kwargs: Optional[dict] = None,
+        *,
+        space_key: Optional[str] = None,
+        page_ids: Optional[List[str]] = None,
+        label: Optional[str] = None,
+        cql: Optional[str] = None,
+        include_restricted_content: bool = False,
+        include_archived_content: bool = False,
+        include_attachments: bool = False,
+        include_comments: bool = False,
+        content_format: ContentFormat = ContentFormat.STORAGE,
+        limit: Optional[int] = 50,
+        max_pages: Optional[int] = 1000,
+        ocr_languages: Optional[str] = None,
+        keep_markdown_format: bool = False,
+        keep_newlines: bool = False,
+    ):
+        self.space_key = space_key
+        self.page_ids = page_ids
+        self.label = label
+        self.cql = cql
+        self.include_restricted_content = include_restricted_content
+        self.include_archived_content = include_archived_content
+        self.include_attachments = include_attachments
+        self.include_comments = include_comments
+        self.content_format = content_format
+        self.limit = limit
+        self.max_pages = max_pages
+        self.ocr_languages = ocr_languages
+        self.keep_markdown_format = keep_markdown_format
+        self.keep_newlines = keep_newlines
+
+        confluence_kwargs = confluence_kwargs or {}
+        errors = ConfluenceLoader.validate_init_args(
+            url=url,
+            api_key=api_key,
+            username=username,
+            session=session,
+            oauth2=oauth2,
+            token=token,
+        )
+        if errors:
+            raise ValueError(f"Error(s) while validating input: {errors}")
+        try:
+            from atlassian import Confluence  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "`atlassian` package not found, please run "
+                "`pip install atlassian-python-api`"
+            )
+
+        self.base_url = url
+        self.number_of_retries = number_of_retries
+        self.min_retry_seconds = min_retry_seconds
+        self.max_retry_seconds = max_retry_seconds
+
+        if session:
+            self.confluence = Confluence(url=url, session=session, **confluence_kwargs)
+        elif oauth2:
+            self.confluence = Confluence(
+                url=url, oauth2=oauth2, cloud=cloud, **confluence_kwargs
+            )
+        elif token:
+            self.confluence = Confluence(
+                url=url, token=token, cloud=cloud, **confluence_kwargs
+            )
+        else:
+            self.confluence = Confluence(
+                url=url,
+                username=username,
+                password=api_key,
+                cloud=cloud,
+                **confluence_kwargs,
+            )
+
+    @staticmethod
+    def validate_init_args(
+        url: Optional[str] = None,
+        api_key: Optional[str] = None,
+        username: Optional[str] = None,
+        session: Optional[requests.Session] = None,
+        oauth2: Optional[dict] = None,
+        token: Optional[str] = None,
+    ) -> Union[List, None]:
+        """Validates proper combinations of init arguments"""
+
+        errors = []
+        if url is None:
+            errors.append("Must provide `base_url`")
+
+        if (api_key and not username) or (username and not api_key):
+            errors.append(
+                "If one of `api_key` or `username` is provided, "
+                "the other must be as well."
+            )
+
+        non_null_creds = list(
+            x is not None for x in ((api_key or username), session, oauth2, token)
+        )
+        if sum(non_null_creds) > 1:
+            all_names = ("(api_key, username)", "session", "oath2", "token")
+            provided = tuple(n for x, n in zip(non_null_creds, all_names) if x)
+            errors.append(
+                f"Cannot provide a value for more than one of: {all_names}. Received "
+                f"values for: {provided}"
+            )
+        if oauth2 and set(oauth2.keys()) != {
+            "access_token",
+            "access_token_secret",
+            "consumer_key",
+            "key_cert",
+        }:
+            errors.append(
+                "You have either omitted require keys or added extra "
+                "keys to the oauth2 dictionary. key values should be "
+                "`['access_token', 'access_token_secret', 'consumer_key', 'key_cert']`"
+            )
+        return errors or None
+
+    def _resolve_param(self, param_name: str, kwargs: Any) -> Any:
+        return kwargs[param_name] if param_name in kwargs else getattr(self, param_name)
+
+    def _lazy_load(self, **kwargs: Any) -> Iterator[Document]:
+        if kwargs:
+            logger.warning(
+                f"Received runtime arguments {kwargs}. Passing runtime args to `load`"
+                f" is deprecated. Please pass arguments during initialization instead."
+            )
+        space_key = self._resolve_param("space_key", kwargs)
+        page_ids = self._resolve_param("page_ids", kwargs)
+        label = self._resolve_param("label", kwargs)
+        cql = self._resolve_param("cql", kwargs)
+        include_restricted_content = self._resolve_param(
+            "include_restricted_content", kwargs
+        )
+        include_archived_content = self._resolve_param(
+            "include_archived_content", kwargs
+        )
+        include_attachments = self._resolve_param("include_attachments", kwargs)
+        include_comments = self._resolve_param("include_comments", kwargs)
+        content_format = self._resolve_param("content_format", kwargs)
+        limit = self._resolve_param("limit", kwargs)
+        max_pages = self._resolve_param("max_pages", kwargs)
+        ocr_languages = self._resolve_param("ocr_languages", kwargs)
+        keep_markdown_format = self._resolve_param("keep_markdown_format", kwargs)
+        keep_newlines = self._resolve_param("keep_newlines", kwargs)
+
+        if not space_key and not page_ids and not label and not cql:
+            raise ValueError(
+                "Must specify at least one among `space_key`, `page_ids`, "
+                "`label`, `cql` parameters."
+            )
+
+        if space_key:
+            pages = self.paginate_request(
+                self.confluence.get_all_pages_from_space,
+                space=space_key,
+                limit=limit,
+                max_pages=max_pages,
+                status="any" if include_archived_content else "current",
+                expand=f"{content_format.value},version",
+            )
+            yield from self.process_pages(
+                pages,
+                include_restricted_content,
+                include_attachments,
+                include_comments,
+                content_format,
+                ocr_languages=ocr_languages,
+                keep_markdown_format=keep_markdown_format,
+                keep_newlines=keep_newlines,
+            )
+
+        if label:
+            pages = self.paginate_request(
+                self.confluence.get_all_pages_by_label,
+                label=label,
+                limit=limit,
+                max_pages=max_pages,
+            )
+            ids_by_label = [page["id"] for page in pages]
+            if page_ids:
+                page_ids = list(set(page_ids + ids_by_label))
+            else:
+                page_ids = list(set(ids_by_label))
+
+        if cql:
+            pages = self.paginate_request(
+                self._search_content_by_cql,
+                cql=cql,
+                limit=limit,
+                max_pages=max_pages,
+                include_archived_spaces=include_archived_content,
+                expand=f"{content_format.value},version",
+            )
+            yield from self.process_pages(
+                pages,
+                include_restricted_content,
+                include_attachments,
+                include_comments,
+                content_format,
+                ocr_languages,
+                keep_markdown_format,
+            )
+
+        if page_ids:
+            for page_id in page_ids:
+                get_page = retry(
+                    reraise=True,
+                    stop=stop_after_attempt(
+                        self.number_of_retries  # type: ignore[arg-type]
+                    ),
+                    wait=wait_exponential(
+                        multiplier=1,  # type: ignore[arg-type]
+                        min=self.min_retry_seconds,  # type: ignore[arg-type]
+                        max=self.max_retry_seconds,  # type: ignore[arg-type]
+                    ),
+                    before_sleep=before_sleep_log(logger, logging.WARNING),
+                )(self.confluence.get_page_by_id)
+                page = get_page(
+                    page_id=page_id, expand=f"{content_format.value},version"
+                )
+                if not include_restricted_content and not self.is_public_page(page):
+                    continue
+                yield self.process_page(
+                    page,
+                    include_attachments,
+                    include_comments,
+                    content_format,
+                    ocr_languages,
+                    keep_markdown_format,
+                )
+
+    def load(self, **kwargs: Any) -> List[Document]:
+        return list(self._lazy_load(**kwargs))
+
+    def lazy_load(self) -> Iterator[Document]:
+        yield from self._lazy_load()
+
+    def _search_content_by_cql(
+        self, cql: str, include_archived_spaces: Optional[bool] = None, **kwargs: Any
+    ) -> List[dict]:
+        url = "rest/api/content/search"
+
+        params: Dict[str, Any] = {"cql": cql}
+        params.update(kwargs)
+        if include_archived_spaces is not None:
+            params["includeArchivedSpaces"] = include_archived_spaces
+
+        response = self.confluence.get(url, params=params)
+        return response.get("results", [])
+
+    def paginate_request(self, retrieval_method: Callable, **kwargs: Any) -> List:
+        """Paginate the various methods to retrieve groups of pages.
+
+        Unfortunately, due to page size, sometimes the Confluence API
+        doesn't match the limit value. If `limit` is >100 confluence
+        seems to cap the response to 100. Also, due to the Atlassian Python
+        package, we don't get the "next" values from the "_links" key because
+        they only return the value from the result key. So here, the pagination
+        starts from 0 and goes until the max_pages, getting the `limit` number
+        of pages with each request. We have to manually check if there
+        are more docs based on the length of the returned list of pages, rather than
+        just checking for the presence of a `next` key in the response like this page
+        would have you do:
+        https://developer.atlassian.com/server/confluence/pagination-in-the-rest-api/
+
+        :param retrieval_method: Function used to retrieve docs
+        :type retrieval_method: callable
+        :return: List of documents
+        :rtype: List
+        """
+
+        max_pages = kwargs.pop("max_pages")
+        docs: List[dict] = []
+        while len(docs) < max_pages:
+            get_pages = retry(
+                reraise=True,
+                stop=stop_after_attempt(
+                    self.number_of_retries  # type: ignore[arg-type]
+                ),
+                wait=wait_exponential(
+                    multiplier=1,
+                    min=self.min_retry_seconds,  # type: ignore[arg-type]
+                    max=self.max_retry_seconds,  # type: ignore[arg-type]
+                ),
+                before_sleep=before_sleep_log(logger, logging.WARNING),
+            )(retrieval_method)
+            batch = get_pages(**kwargs, start=len(docs))
+            if not batch:
+                break
+            docs.extend(batch)
+        return docs[:max_pages]
+
+    def is_public_page(self, page: dict) -> bool:
+        """Check if a page is publicly accessible."""
+        restrictions = self.confluence.get_all_restrictions_for_content(page["id"])
+
+        return (
+            page["status"] == "current"
+            and not restrictions["read"]["restrictions"]["user"]["results"]
+            and not restrictions["read"]["restrictions"]["group"]["results"]
+        )
+
+    def process_pages(
+        self,
+        pages: List[dict],
+        include_restricted_content: bool,
+        include_attachments: bool,
+        include_comments: bool,
+        content_format: ContentFormat,
+        ocr_languages: Optional[str] = None,
+        keep_markdown_format: Optional[bool] = False,
+        keep_newlines: bool = False,
+    ) -> Iterator[Document]:
+        """Process a list of pages into a list of documents."""
+        for page in pages:
+            if not include_restricted_content and not self.is_public_page(page):
+                continue
+            yield self.process_page(
+                page,
+                include_attachments,
+                include_comments,
+                content_format,
+                ocr_languages=ocr_languages,
+                keep_markdown_format=keep_markdown_format,
+                keep_newlines=keep_newlines,
+            )
+
+    def process_page(
+        self,
+        page: dict,
+        include_attachments: bool,
+        include_comments: bool,
+        content_format: ContentFormat,
+        ocr_languages: Optional[str] = None,
+        keep_markdown_format: Optional[bool] = False,
+        keep_newlines: bool = False,
+    ) -> Document:
+        if keep_markdown_format:
+            try:
+                from markdownify import markdownify
+            except ImportError:
+                raise ImportError(
+                    "`markdownify` package not found, please run "
+                    "`pip install markdownify`"
+                )
+        if include_comments or not keep_markdown_format:
+            try:
+                from bs4 import BeautifulSoup
+            except ImportError:
+                raise ImportError(
+                    "`beautifulsoup4` package not found, please run "
+                    "`pip install beautifulsoup4`"
+                )
+        if include_attachments:
+            attachment_texts = self.process_attachment(page["id"], ocr_languages)
+        else:
+            attachment_texts = []
+
+        content = content_format.get_content(page)
+        if keep_markdown_format:
+            # Use markdownify to keep the page Markdown style
+            text = markdownify(content, heading_style="ATX") + "".join(attachment_texts)
+
+        else:
+            if keep_newlines:
+                text = BeautifulSoup(
+                    content.replace("</p>", "\n</p>").replace("<br />", "\n"), "lxml"
+                ).get_text(" ") + "".join(attachment_texts)
+            else:
+                text = BeautifulSoup(content, "lxml").get_text(
+                    " ", strip=True
+                ) + "".join(attachment_texts)
+
+        if include_comments:
+            comments = self.confluence.get_page_comments(
+                page["id"], expand="body.view.value", depth="all"
+            )["results"]
+            comment_texts = [
+                BeautifulSoup(comment["body"]["view"]["value"], "lxml").get_text(
+                    " ", strip=True
+                )
+                for comment in comments
+            ]
+            text = text + "".join(comment_texts)
+
+        metadata = {
+            "title": page["title"],
+            "id": page["id"],
+            "source": self.base_url.strip("/") + page["_links"]["webui"],
+        }
+
+        if "version" in page and "when" in page["version"]:
+            metadata["when"] = page["version"]["when"]
+
+        return Document(
+            page_content=text,
+            metadata=metadata,
+        )
+
+    def process_attachment(
+        self,
+        page_id: str,
+        ocr_languages: Optional[str] = None,
+    ) -> List[str]:
+        try:
+            from PIL import Image  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "`Pillow` package not found, " "please run `pip install Pillow`"
+            )
+
+        # depending on setup you may also need to set the correct path for
+        # poppler and tesseract
+        attachments = self.confluence.get_attachments_from_content(page_id)["results"]
+        texts = []
+        for attachment in attachments:
+            media_type = attachment["metadata"]["mediaType"]
+            absolute_url = self.base_url + attachment["_links"]["download"]
+            title = attachment["title"]
+            try:
+                if media_type == "application/pdf":
+                    text = title + self.process_pdf(absolute_url, ocr_languages)
+                elif (
+                    media_type == "image/png"
+                    or media_type == "image/jpg"
+                    or media_type == "image/jpeg"
+                ):
+                    text = title + self.process_image(absolute_url, ocr_languages)
+                elif (
+                    media_type == "application/vnd.openxmlformats-officedocument"
+                    ".wordprocessingml.document"
+                ):
+                    text = title + self.process_doc(absolute_url)
+                elif media_type == "application/vnd.ms-excel":
+                    text = title + self.process_xls(absolute_url)
+                elif media_type == "image/svg+xml":
+                    text = title + self.process_svg(absolute_url, ocr_languages)
+                else:
+                    continue
+                texts.append(text)
+            except requests.HTTPError as e:
+                if e.response.status_code == 404:
+                    print(f"Attachment not found at {absolute_url}")  # noqa: T201
+                    continue
+                else:
+                    raise
+
+        return texts
+
+    def process_pdf(
+        self,
+        link: str,
+        ocr_languages: Optional[str] = None,
+    ) -> str:
+        try:
+            import pytesseract  # noqa: F401
+            from pdf2image import convert_from_bytes  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "`pytesseract` or `pdf2image` package not found, "
+                "please run `pip install pytesseract pdf2image`"
+            )
+
+        response = self.confluence.request(path=link, absolute=True)
+        text = ""
+
+        if (
+            response.status_code != 200
+            or response.content == b""
+            or response.content is None
+        ):
+            return text
+        try:
+            images = convert_from_bytes(response.content)
+        except ValueError:
+            return text
+
+        for i, image in enumerate(images):
+            image_text = pytesseract.image_to_string(image, lang=ocr_languages)
+            text += f"Page {i + 1}:\n{image_text}\n\n"
+
+        return text
+
+    def process_image(
+        self,
+        link: str,
+        ocr_languages: Optional[str] = None,
+    ) -> str:
+        try:
+            import pytesseract  # noqa: F401
+            from PIL import Image  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "`pytesseract` or `Pillow` package not found, "
+                "please run `pip install pytesseract Pillow`"
+            )
+
+        response = self.confluence.request(path=link, absolute=True)
+        text = ""
+
+        if (
+            response.status_code != 200
+            or response.content == b""
+            or response.content is None
+        ):
+            return text
+        try:
+            image = Image.open(BytesIO(response.content))
+        except OSError:
+            return text
+
+        return pytesseract.image_to_string(image, lang=ocr_languages)
+
+    def process_doc(self, link: str) -> str:
+        try:
+            import docx2txt  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "`docx2txt` package not found, please run `pip install docx2txt`"
+            )
+
+        response = self.confluence.request(path=link, absolute=True)
+        text = ""
+
+        if (
+            response.status_code != 200
+            or response.content == b""
+            or response.content is None
+        ):
+            return text
+        file_data = BytesIO(response.content)
+
+        return docx2txt.process(file_data)
+
+    def process_xls(self, link: str) -> str:
+        import io
+        import os
+
+        try:
+            import xlrd  # noqa: F401
+
+        except ImportError:
+            raise ImportError("`xlrd` package not found, please run `pip install xlrd`")
+
+        try:
+            import pandas as pd
+
+        except ImportError:
+            raise ImportError(
+                "`pandas` package not found, please run `pip install pandas`"
+            )
+
+        response = self.confluence.request(path=link, absolute=True)
+        text = ""
+
+        if (
+            response.status_code != 200
+            or response.content == b""
+            or response.content is None
+        ):
+            return text
+
+        filename = os.path.basename(link)
+        # Getting the whole content of the url after filename,
+        # Example: ".csv?version=2&modificationDate=1631800010678&cacheVersion=1&api=v2"
+        file_extension = os.path.splitext(filename)[1]
+
+        if file_extension.startswith(
+            ".csv"
+        ):  # if the extension found in the url is ".csv"
+            content_string = response.content.decode("utf-8")
+            df = pd.read_csv(io.StringIO(content_string))
+            text += df.to_string(index=False, header=False) + "\n\n"
+        else:
+            workbook = xlrd.open_workbook(file_contents=response.content)
+            for sheet in workbook.sheets():
+                text += f"{sheet.name}:\n"
+                for row in range(sheet.nrows):
+                    for col in range(sheet.ncols):
+                        text += f"{sheet.cell_value(row, col)}\t"
+                    text += "\n"
+                text += "\n"
+
+        return text
+
+    def process_svg(
+        self,
+        link: str,
+        ocr_languages: Optional[str] = None,
+    ) -> str:
+        try:
+            import pytesseract  # noqa: F401
+            from PIL import Image  # noqa: F401
+            from reportlab.graphics import renderPM  # noqa: F401
+            from svglib.svglib import svg2rlg  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "`pytesseract`, `Pillow`, `reportlab` or `svglib` package not found, "
+                "please run `pip install pytesseract Pillow reportlab svglib`"
+            )
+
+        response = self.confluence.request(path=link, absolute=True)
+        text = ""
+
+        if (
+            response.status_code != 200
+            or response.content == b""
+            or response.content is None
+        ):
+            return text
+
+        drawing = svg2rlg(BytesIO(response.content))
+
+        img_data = BytesIO()
+        renderPM.drawToFile(drawing, img_data, fmt="PNG")
+        img_data.seek(0)
+        image = Image.open(img_data)
+
+        return pytesseract.image_to_string(image, lang=ocr_languages)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/conllu.py b/llm/Lib/site-packages/langchain_community/document_loaders/conllu.py
new file mode 100644
index 0000000000000000000000000000000000000000..fa43af653a6ce9e548d7af0a92b3e55ef82931fd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/conllu.py
@@ -0,0 +1,34 @@
+import csv
+from pathlib import Path
+from typing import List, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class CoNLLULoader(BaseLoader):
+    """Load `CoNLL-U` files."""
+
+    def __init__(self, file_path: Union[str, Path]):
+        """Initialize with a file path."""
+        self.file_path = file_path
+
+    def load(self) -> List[Document]:
+        """Load from a file path."""
+        with open(self.file_path, encoding="utf8") as f:
+            tsv = list(csv.reader(f, delimiter="\t"))
+
+            # If len(line) > 1, the line is not a comment
+            lines = [line for line in tsv if len(line) > 1]
+
+        text = ""
+        for i, line in enumerate(lines):
+            # Do not add a space after a punctuation mark or at the end of the sentence
+            if line[9] == "SpaceAfter=No" or i == len(lines) - 1:
+                text += line[1]
+            else:
+                text += line[1] + " "
+
+        metadata = {"source": str(self.file_path)}
+        return [Document(page_content=text, metadata=metadata)]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/couchbase.py b/llm/Lib/site-packages/langchain_community/document_loaders/couchbase.py
new file mode 100644
index 0000000000000000000000000000000000000000..5d89016202b7cc450569037752883908d338d90a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/couchbase.py
@@ -0,0 +1,96 @@
+import logging
+from typing import Iterator, List, Optional
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+
+class CouchbaseLoader(BaseLoader):
+    """Load documents from `Couchbase`.
+
+    Each document represents one row of the result. The `page_content_fields` are
+    written into the `page_content`of the document. The `metadata_fields` are written
+    into the `metadata` of the document. By default, all columns are written into
+    the `page_content` and none into the `metadata`.
+    """
+
+    def __init__(
+        self,
+        connection_string: str,
+        db_username: str,
+        db_password: str,
+        query: str,
+        *,
+        page_content_fields: Optional[List[str]] = None,
+        metadata_fields: Optional[List[str]] = None,
+    ) -> None:
+        """Initialize Couchbase document loader.
+
+        Args:
+            connection_string (str): The connection string to the Couchbase cluster.
+            db_username (str): The username to connect to the Couchbase cluster.
+            db_password (str): The password to connect to the Couchbase cluster.
+            query (str): The SQL++ query to execute.
+            page_content_fields (Optional[List[str]]): The columns to write into the
+                `page_content` field of the document. By default, all columns are
+                written.
+            metadata_fields (Optional[List[str]]): The columns to write into the
+                `metadata` field of the document. By default, no columns are written.
+        """
+        try:
+            from couchbase.auth import PasswordAuthenticator
+            from couchbase.cluster import Cluster
+            from couchbase.options import ClusterOptions
+        except ImportError as e:
+            raise ImportError(
+                "Could not import couchbase package."
+                "Please install couchbase SDK with `pip install couchbase`."
+            ) from e
+        if not connection_string:
+            raise ValueError("connection_string must be provided.")
+
+        if not db_username:
+            raise ValueError("db_username must be provided.")
+
+        if not db_password:
+            raise ValueError("db_password must be provided.")
+
+        auth = PasswordAuthenticator(
+            db_username,
+            db_password,
+        )
+
+        self.cluster: Cluster = Cluster(connection_string, ClusterOptions(auth))
+        self.query = query
+        self.page_content_fields = page_content_fields
+        self.metadata_fields = metadata_fields
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Load Couchbase data into Document objects lazily."""
+        from datetime import timedelta
+
+        # Ensure connection to Couchbase cluster
+        self.cluster.wait_until_ready(timedelta(seconds=5))
+
+        # Run SQL++ Query
+        result = self.cluster.query(self.query)
+        for row in result:
+            metadata_fields = self.metadata_fields
+            page_content_fields = self.page_content_fields
+
+            if not page_content_fields:
+                page_content_fields = list(row.keys())
+
+            if not metadata_fields:
+                metadata_fields = []
+
+            metadata = {field: row[field] for field in metadata_fields}
+
+            document = "\n".join(
+                f"{k}: {v}" for k, v in row.items() if k in page_content_fields
+            )
+
+            yield (Document(page_content=document, metadata=metadata))
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/csv_loader.py b/llm/Lib/site-packages/langchain_community/document_loaders/csv_loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..fca2f1f0f9b638d588494df75702eaf38baf0739
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/csv_loader.py
@@ -0,0 +1,149 @@
+import csv
+from io import TextIOWrapper
+from pathlib import Path
+from typing import Any, Dict, Iterator, List, Optional, Sequence, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.helpers import detect_file_encodings
+from langchain_community.document_loaders.unstructured import (
+    UnstructuredFileLoader,
+    validate_unstructured_version,
+)
+
+
+class CSVLoader(BaseLoader):
+    """Load a `CSV` file into a list of Documents.
+
+    Each document represents one row of the CSV file. Every row is converted into a
+    key/value pair and outputted to a new line in the document's page_content.
+
+    The source for each document loaded from csv is set to the value of the
+    `file_path` argument for all documents by default.
+    You can override this by setting the `source_column` argument to the
+    name of a column in the CSV file.
+    The source of each document will then be set to the value of the column
+    with the name specified in `source_column`.
+
+    Output Example:
+        .. code-block:: txt
+
+            column1: value1
+            column2: value2
+            column3: value3
+    """
+
+    def __init__(
+        self,
+        file_path: Union[str, Path],
+        source_column: Optional[str] = None,
+        metadata_columns: Sequence[str] = (),
+        csv_args: Optional[Dict] = None,
+        encoding: Optional[str] = None,
+        autodetect_encoding: bool = False,
+    ):
+        """
+
+        Args:
+            file_path: The path to the CSV file.
+            source_column: The name of the column in the CSV file to use as the source.
+              Optional. Defaults to None.
+            metadata_columns: A sequence of column names to use as metadata. Optional.
+            csv_args: A dictionary of arguments to pass to the csv.DictReader.
+              Optional. Defaults to None.
+            encoding: The encoding of the CSV file. Optional. Defaults to None.
+            autodetect_encoding: Whether to try to autodetect the file encoding.
+        """
+        self.file_path = file_path
+        self.source_column = source_column
+        self.metadata_columns = metadata_columns
+        self.encoding = encoding
+        self.csv_args = csv_args or {}
+        self.autodetect_encoding = autodetect_encoding
+
+    def lazy_load(self) -> Iterator[Document]:
+        try:
+            with open(self.file_path, newline="", encoding=self.encoding) as csvfile:
+                yield from self.__read_file(csvfile)
+        except UnicodeDecodeError as e:
+            if self.autodetect_encoding:
+                detected_encodings = detect_file_encodings(self.file_path)
+                for encoding in detected_encodings:
+                    try:
+                        with open(
+                            self.file_path, newline="", encoding=encoding.encoding
+                        ) as csvfile:
+                            yield from self.__read_file(csvfile)
+                            break
+                    except UnicodeDecodeError:
+                        continue
+            else:
+                raise RuntimeError(f"Error loading {self.file_path}") from e
+        except Exception as e:
+            raise RuntimeError(f"Error loading {self.file_path}") from e
+
+    def __read_file(self, csvfile: TextIOWrapper) -> Iterator[Document]:
+        csv_reader = csv.DictReader(csvfile, **self.csv_args)
+        for i, row in enumerate(csv_reader):
+            try:
+                source = (
+                    row[self.source_column]
+                    if self.source_column is not None
+                    else str(self.file_path)
+                )
+            except KeyError:
+                raise ValueError(
+                    f"Source column '{self.source_column}' not found in CSV file."
+                )
+            content = "\n".join(
+                f"{k.strip()}: {v.strip() if v is not None else v}"
+                for k, v in row.items()
+                if k not in self.metadata_columns
+            )
+            metadata = {"source": source, "row": i}
+            for col in self.metadata_columns:
+                try:
+                    metadata[col] = row[col]
+                except KeyError:
+                    raise ValueError(f"Metadata column '{col}' not found in CSV file.")
+            yield Document(page_content=content, metadata=metadata)
+
+
+class UnstructuredCSVLoader(UnstructuredFileLoader):
+    """Load `CSV` files using `Unstructured`.
+
+    Like other
+    Unstructured loaders, UnstructuredCSVLoader can be used in both
+    "single" and "elements" mode. If you use the loader in "elements"
+    mode, the CSV file will be a single Unstructured Table element.
+    If you use the loader in "elements" mode, an HTML representation
+    of the table will be available in the "text_as_html" key in the
+    document metadata.
+
+    Examples
+    --------
+    from langchain_community.document_loaders.csv_loader import UnstructuredCSVLoader
+
+    loader = UnstructuredCSVLoader("stanley-cups.csv", mode="elements")
+    docs = loader.load()
+    """
+
+    def __init__(
+        self, file_path: str, mode: str = "single", **unstructured_kwargs: Any
+    ):
+        """
+
+        Args:
+            file_path: The path to the CSV file.
+            mode: The mode to use when loading the CSV file.
+              Optional. Defaults to "single".
+            **unstructured_kwargs: Keyword arguments to pass to unstructured.
+        """
+        validate_unstructured_version(min_unstructured_version="0.6.8")
+        super().__init__(file_path=file_path, mode=mode, **unstructured_kwargs)
+
+    def _get_elements(self) -> List:
+        from unstructured.partition.csv import partition_csv
+
+        return partition_csv(filename=self.file_path, **self.unstructured_kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/cube_semantic.py b/llm/Lib/site-packages/langchain_community/document_loaders/cube_semantic.py
new file mode 100644
index 0000000000000000000000000000000000000000..81a35787edde6c42e8bd88eb41b48a14bac583bb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/cube_semantic.py
@@ -0,0 +1,174 @@
+import json
+import logging
+import time
+from typing import Iterator, List
+
+import requests
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+
+class CubeSemanticLoader(BaseLoader):
+    """Load `Cube semantic layer` metadata.
+
+    Args:
+        cube_api_url: REST API endpoint.
+            Use the REST API of your Cube's deployment.
+            Please find out more information here:
+            https://cube.dev/docs/http-api/rest#configuration-base-path
+        cube_api_token: Cube API token.
+            Authentication tokens are generated based on your Cube's API secret.
+            Please find out more information here:
+            https://cube.dev/docs/security#generating-json-web-tokens-jwt
+        load_dimension_values: Whether to load dimension values for every string
+            dimension or not.
+        dimension_values_limit: Maximum number of dimension values to load.
+        dimension_values_max_retries: Maximum number of retries to load dimension
+            values.
+        dimension_values_retry_delay: Delay between retries to load dimension values.
+    """
+
+    def __init__(
+        self,
+        cube_api_url: str,
+        cube_api_token: str,
+        load_dimension_values: bool = True,
+        dimension_values_limit: int = 10_000,
+        dimension_values_max_retries: int = 10,
+        dimension_values_retry_delay: int = 3,
+    ):
+        self.cube_api_url = cube_api_url
+        self.cube_api_token = cube_api_token
+        self.load_dimension_values = load_dimension_values
+        self.dimension_values_limit = dimension_values_limit
+        self.dimension_values_max_retries = dimension_values_max_retries
+        self.dimension_values_retry_delay = dimension_values_retry_delay
+
+    def _get_dimension_values(self, dimension_name: str) -> List[str]:
+        """Makes a call to Cube's REST API load endpoint to retrieve
+        values for dimensions.
+
+        These values can be used to achieve a more accurate filtering.
+        """
+        logger.info("Loading dimension values for: {dimension_name}...")
+
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": self.cube_api_token,
+        }
+
+        query = {
+            "query": {
+                "dimensions": [dimension_name],
+                "limit": self.dimension_values_limit,
+            }
+        }
+
+        retries = 0
+        while retries < self.dimension_values_max_retries:
+            response = requests.request(
+                "POST",
+                f"{self.cube_api_url}/load",
+                headers=headers,
+                data=json.dumps(query),
+            )
+
+            if response.status_code == 200:
+                response_data = response.json()
+                if (
+                    "error" in response_data
+                    and response_data["error"] == "Continue wait"
+                ):
+                    logger.info("Retrying...")
+                    retries += 1
+                    time.sleep(self.dimension_values_retry_delay)
+                    continue
+                else:
+                    dimension_values = [
+                        item[dimension_name] for item in response_data["data"]
+                    ]
+                    return dimension_values
+            else:
+                logger.error("Request failed with status code:", response.status_code)
+                break
+
+        if retries == self.dimension_values_max_retries:
+            logger.info("Maximum retries reached.")
+        return []
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Makes a call to Cube's REST API metadata endpoint.
+
+        Returns:
+            A list of documents with attributes:
+                - page_content=column_title + column_description
+                - metadata
+                    - table_name
+                    - column_name
+                    - column_data_type
+                    - column_member_type
+                    - column_title
+                    - column_description
+                    - column_values
+                    - cube_data_obj_type
+        """
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": self.cube_api_token,
+        }
+
+        logger.info(f"Loading metadata from {self.cube_api_url}...")
+        response = requests.get(f"{self.cube_api_url}/meta", headers=headers)
+        response.raise_for_status()
+        raw_meta_json = response.json()
+        cube_data_objects = raw_meta_json.get("cubes", [])
+
+        logger.info(f"Found {len(cube_data_objects)} cube data objects in metadata.")
+
+        if not cube_data_objects:
+            raise ValueError("No cubes found in metadata.")
+
+        for cube_data_obj in cube_data_objects:
+            cube_data_obj_name = cube_data_obj.get("name")
+            cube_data_obj_type = cube_data_obj.get("type")
+            cube_data_obj_is_public = cube_data_obj.get("public")
+            measures = cube_data_obj.get("measures", [])
+            dimensions = cube_data_obj.get("dimensions", [])
+
+            logger.info(f"Processing {cube_data_obj_name}...")
+
+            if not cube_data_obj_is_public:
+                logger.info(f"Skipping {cube_data_obj_name} because it is not public.")
+                continue
+
+            for item in measures + dimensions:
+                column_member_type = "measure" if item in measures else "dimension"
+                dimension_values = []
+                item_name = str(item.get("name"))
+                item_type = str(item.get("type"))
+
+                if (
+                    self.load_dimension_values
+                    and column_member_type == "dimension"
+                    and item_type == "string"
+                ):
+                    dimension_values = self._get_dimension_values(item_name)
+
+                metadata = dict(
+                    table_name=str(cube_data_obj_name),
+                    column_name=item_name,
+                    column_data_type=item_type,
+                    column_title=str(item.get("title")),
+                    column_description=str(item.get("description")),
+                    column_member_type=column_member_type,
+                    column_values=dimension_values,
+                    cube_data_obj_type=cube_data_obj_type,
+                )
+
+                page_content = f"{str(item.get('title'))}, "
+                page_content += f"{str(item.get('description'))}"
+
+                yield Document(page_content=page_content, metadata=metadata)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/datadog_logs.py b/llm/Lib/site-packages/langchain_community/document_loaders/datadog_logs.py
new file mode 100644
index 0000000000000000000000000000000000000000..38e774c6c3dcebbac483e3ca5703c532d0a85a53
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/datadog_logs.py
@@ -0,0 +1,137 @@
+from datetime import datetime, timedelta
+from typing import List, Optional
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class DatadogLogsLoader(BaseLoader):
+    """Load `Datadog` logs.
+
+    Logs are written into the `page_content` and into the `metadata`.
+    """
+
+    def __init__(
+        self,
+        query: str,
+        api_key: str,
+        app_key: str,
+        from_time: Optional[int] = None,
+        to_time: Optional[int] = None,
+        limit: int = 100,
+    ) -> None:
+        """Initialize Datadog document loader.
+
+        Requirements:
+            - Must have datadog_api_client installed. Install with `pip install datadog_api_client`.
+
+        Args:
+            query: The query to run in Datadog.
+            api_key: The Datadog API key.
+            app_key: The Datadog APP key.
+            from_time: Optional. The start of the time range to query.
+                Supports date math and regular timestamps (milliseconds) like '1688732708951'
+                Defaults to 20 minutes ago.
+            to_time: Optional. The end of the time range to query.
+                Supports date math and regular timestamps (milliseconds) like '1688732708951'
+                Defaults to now.
+            limit: The maximum number of logs to return.
+                Defaults to 100.
+        """  # noqa: E501
+        try:
+            from datadog_api_client import Configuration
+        except ImportError as ex:
+            raise ImportError(
+                "Could not import datadog_api_client python package. "
+                "Please install it with `pip install datadog_api_client`."
+            ) from ex
+
+        self.query = query
+        configuration = Configuration()
+        configuration.api_key["apiKeyAuth"] = api_key
+        configuration.api_key["appKeyAuth"] = app_key
+        self.configuration = configuration
+        self.from_time = from_time
+        self.to_time = to_time
+        self.limit = limit
+
+    def parse_log(self, log: dict) -> Document:
+        """
+        Create Document objects from Datadog log items.
+        """
+        attributes = log.get("attributes", {})
+        metadata = {
+            "id": log.get("id", ""),
+            "status": attributes.get("status"),
+            "service": attributes.get("service", ""),
+            "tags": attributes.get("tags", []),
+            "timestamp": attributes.get("timestamp", ""),
+        }
+
+        message = attributes.get("message", "")
+        inside_attributes = attributes.get("attributes", {})
+        content_dict = {**inside_attributes, "message": message}
+        content = ", ".join(f"{k}: {v}" for k, v in content_dict.items())
+        return Document(page_content=content, metadata=metadata)
+
+    def load(self) -> List[Document]:
+        """
+        Get logs from Datadog.
+
+        Returns:
+            A list of Document objects.
+                - page_content
+                - metadata
+                    - id
+                    - service
+                    - status
+                    - tags
+                    - timestamp
+        """
+        try:
+            from datadog_api_client import ApiClient
+            from datadog_api_client.v2.api.logs_api import LogsApi
+            from datadog_api_client.v2.model.logs_list_request import LogsListRequest
+            from datadog_api_client.v2.model.logs_list_request_page import (
+                LogsListRequestPage,
+            )
+            from datadog_api_client.v2.model.logs_query_filter import LogsQueryFilter
+            from datadog_api_client.v2.model.logs_sort import LogsSort
+        except ImportError as ex:
+            raise ImportError(
+                "Could not import datadog_api_client python package. "
+                "Please install it with `pip install datadog_api_client`."
+            ) from ex
+
+        now = datetime.now()
+        twenty_minutes_before = now - timedelta(minutes=20)
+        now_timestamp = int(now.timestamp() * 1000)
+        twenty_minutes_before_timestamp = int(twenty_minutes_before.timestamp() * 1000)
+        _from = (
+            self.from_time
+            if self.from_time is not None
+            else twenty_minutes_before_timestamp
+        )
+
+        body = LogsListRequest(
+            filter=LogsQueryFilter(
+                query=self.query,
+                _from=_from,
+                to=f"{self.to_time if self.to_time is not None else now_timestamp}",
+            ),
+            sort=LogsSort.TIMESTAMP_ASCENDING,
+            page=LogsListRequestPage(
+                limit=self.limit,
+            ),
+        )
+
+        with ApiClient(configuration=self.configuration) as api_client:
+            api_instance = LogsApi(api_client)
+            response = api_instance.list_logs(body=body).to_dict()
+
+        docs: List[Document] = []
+        for row in response["data"]:
+            docs.append(self.parse_log(row))
+
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/dataframe.py b/llm/Lib/site-packages/langchain_community/document_loaders/dataframe.py
new file mode 100644
index 0000000000000000000000000000000000000000..1b508533f8d93bd35654d28b6fd3ab360129bbcc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/dataframe.py
@@ -0,0 +1,64 @@
+from typing import Any, Iterator, Literal
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class BaseDataFrameLoader(BaseLoader):
+    def __init__(self, data_frame: Any, *, page_content_column: str = "text"):
+        """Initialize with dataframe object.
+
+        Args:
+            data_frame: DataFrame object.
+            page_content_column: Name of the column containing the page content.
+              Defaults to "text".
+        """
+        self.data_frame = data_frame
+        self.page_content_column = page_content_column
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Lazy load records from dataframe."""
+
+        for _, row in self.data_frame.iterrows():
+            text = row[self.page_content_column]
+            metadata = row.to_dict()
+            metadata.pop(self.page_content_column)
+            yield Document(page_content=text, metadata=metadata)
+
+
+class DataFrameLoader(BaseDataFrameLoader):
+    """Load `Pandas` DataFrame."""
+
+    def __init__(
+        self,
+        data_frame: Any,
+        page_content_column: str = "text",
+        engine: Literal["pandas", "modin"] = "pandas",
+    ):
+        """Initialize with dataframe object.
+
+        Args:
+            data_frame: Pandas DataFrame object.
+            page_content_column: Name of the column containing the page content.
+              Defaults to "text".
+        """
+        try:
+            if engine == "pandas":
+                import pandas as pd
+            elif engine == "modin":
+                import modin.pandas as pd
+            else:
+                raise ValueError(
+                    f"Unsupported engine {engine}. Must be one of 'pandas', or 'modin'."
+                )
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import pandas, please install with `pip install pandas`."
+            ) from e
+
+        if not isinstance(data_frame, pd.DataFrame):
+            raise ValueError(
+                f"Expected data_frame to be a pd.DataFrame, got {type(data_frame)}"
+            )
+        super().__init__(data_frame, page_content_column=page_content_column)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/diffbot.py b/llm/Lib/site-packages/langchain_community/document_loaders/diffbot.py
new file mode 100644
index 0000000000000000000000000000000000000000..5014ecf780cf1a4ebd19521d996fd88a9235c313
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/diffbot.py
@@ -0,0 +1,61 @@
+import logging
+from typing import Any, List
+
+import requests
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+
+class DiffbotLoader(BaseLoader):
+    """Load `Diffbot` json file."""
+
+    def __init__(
+        self, api_token: str, urls: List[str], continue_on_failure: bool = True
+    ):
+        """Initialize with API token, ids, and key.
+
+        Args:
+            api_token: Diffbot API token.
+            urls: List of URLs to load.
+            continue_on_failure: Whether to continue loading other URLs if one fails.
+               Defaults to True.
+        """
+        self.api_token = api_token
+        self.urls = urls
+        self.continue_on_failure = continue_on_failure
+
+    def _diffbot_api_url(self, diffbot_api: str) -> str:
+        return f"https://api.diffbot.com/v3/{diffbot_api}"
+
+    def _get_diffbot_data(self, url: str) -> Any:
+        """Get Diffbot file from Diffbot REST API."""
+        # TODO: Add support for other Diffbot APIs
+        diffbot_url = self._diffbot_api_url("article")
+        params = {
+            "token": self.api_token,
+            "url": url,
+        }
+        response = requests.get(diffbot_url, params=params, timeout=10)
+
+        # TODO: handle non-ok errors
+        return response.json() if response.ok else {}
+
+    def load(self) -> List[Document]:
+        """Extract text from Diffbot on all the URLs and return Documents"""
+        docs: List[Document] = list()
+
+        for url in self.urls:
+            try:
+                data = self._get_diffbot_data(url)
+                text = data["objects"][0]["text"] if "objects" in data else ""
+                metadata = {"source": url}
+                docs.append(Document(page_content=text, metadata=metadata))
+            except Exception as e:
+                if self.continue_on_failure:
+                    logger.error(f"Error fetching or processing {url}, exception: {e}")
+                else:
+                    raise e
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/directory.py b/llm/Lib/site-packages/langchain_community/document_loaders/directory.py
new file mode 100644
index 0000000000000000000000000000000000000000..b20eff887590f96658c5599e83e8235910a20424
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/directory.py
@@ -0,0 +1,223 @@
+import concurrent
+import logging
+import random
+from pathlib import Path
+from typing import Any, Callable, Iterator, List, Optional, Sequence, Type, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.csv_loader import CSVLoader
+from langchain_community.document_loaders.html_bs import BSHTMLLoader
+from langchain_community.document_loaders.text import TextLoader
+from langchain_community.document_loaders.unstructured import UnstructuredFileLoader
+
+FILE_LOADER_TYPE = Union[
+    Type[UnstructuredFileLoader], Type[TextLoader], Type[BSHTMLLoader], Type[CSVLoader]
+]
+logger = logging.getLogger(__name__)
+
+
+def _is_visible(p: Path) -> bool:
+    parts = p.parts
+    for _p in parts:
+        if _p.startswith("."):
+            return False
+    return True
+
+
+class DirectoryLoader(BaseLoader):
+    """Load from a directory."""
+
+    def __init__(
+        self,
+        path: str,
+        glob: str = "**/[!.]*",
+        silent_errors: bool = False,
+        load_hidden: bool = False,
+        loader_cls: FILE_LOADER_TYPE = UnstructuredFileLoader,
+        loader_kwargs: Union[dict, None] = None,
+        recursive: bool = False,
+        show_progress: bool = False,
+        use_multithreading: bool = False,
+        max_concurrency: int = 4,
+        *,
+        exclude: Union[Sequence[str], str] = (),
+        sample_size: int = 0,
+        randomize_sample: bool = False,
+        sample_seed: Union[int, None] = None,
+    ):
+        """Initialize with a path to directory and how to glob over it.
+
+        Args:
+            path: Path to directory.
+            glob: Glob pattern to use to find files. Defaults to "**/[!.]*"
+               (all files except hidden).
+            exclude: A pattern or list of patterns to exclude from results.
+                Use glob syntax.
+            silent_errors: Whether to silently ignore errors. Defaults to False.
+            load_hidden: Whether to load hidden files. Defaults to False.
+            loader_cls: Loader class to use for loading files.
+              Defaults to UnstructuredFileLoader.
+            loader_kwargs: Keyword arguments to pass to loader_cls. Defaults to None.
+            recursive: Whether to recursively search for files. Defaults to False.
+            show_progress: Whether to show a progress bar. Defaults to False.
+            use_multithreading: Whether to use multithreading. Defaults to False.
+            max_concurrency: The maximum number of threads to use. Defaults to 4.
+            sample_size: The maximum number of files you would like to load from the
+                directory.
+            randomize_sample: Shuffle the files to get a random sample.
+            sample_seed: set the seed of the random shuffle for reproducibility.
+
+        Examples:
+
+            .. code-block:: python
+                from langchain_community.document_loaders import DirectoryLoader
+
+                # Load all non-hidden files in a directory.
+                loader = DirectoryLoader("/path/to/directory")
+
+                # Load all text files in a directory without recursion.
+                loader = DirectoryLoader("/path/to/directory", glob="*.txt")
+
+                # Recursively load all text files in a directory.
+                loader = DirectoryLoader(
+                    "/path/to/directory", glob="*.txt", recursive=True
+                )
+
+                # Load all files in a directory, except for py files.
+                loader = DirectoryLoader("/path/to/directory", exclude="*.py")
+
+                # Load all files in a directory, except for py or pyc files.
+                loader = DirectoryLoader(
+                    "/path/to/directory", exclude=["*.py", "*.pyc"]
+                )
+        """
+        if loader_kwargs is None:
+            loader_kwargs = {}
+        if isinstance(exclude, str):
+            exclude = (exclude,)
+        self.path = path
+        self.glob = glob
+        self.exclude = exclude
+        self.load_hidden = load_hidden
+        self.loader_cls = loader_cls
+        self.loader_kwargs = loader_kwargs
+        self.silent_errors = silent_errors
+        self.recursive = recursive
+        self.show_progress = show_progress
+        self.use_multithreading = use_multithreading
+        self.max_concurrency = max_concurrency
+        self.sample_size = sample_size
+        self.randomize_sample = randomize_sample
+        self.sample_seed = sample_seed
+
+    def load(self) -> List[Document]:
+        """Load documents."""
+        return list(self.lazy_load())
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Load documents lazily."""
+        p = Path(self.path)
+        if not p.exists():
+            raise FileNotFoundError(f"Directory not found: '{self.path}'")
+        if not p.is_dir():
+            raise ValueError(f"Expected directory, got file: '{self.path}'")
+
+        paths = p.rglob(self.glob) if self.recursive else p.glob(self.glob)
+        items = [
+            path
+            for path in paths
+            if not (self.exclude and any(path.match(glob) for glob in self.exclude))
+            and path.is_file()
+        ]
+
+        if self.sample_size > 0:
+            if self.randomize_sample:
+                randomizer = random.Random(
+                    self.sample_seed if self.sample_seed else None
+                )
+                randomizer.shuffle(items)
+            items = items[: min(len(items), self.sample_size)]
+
+        pbar = None
+        if self.show_progress:
+            try:
+                from tqdm import tqdm
+
+                pbar = tqdm(total=len(items))
+            except ImportError as e:
+                logger.warning(
+                    "To log the progress of DirectoryLoader you need to install tqdm, "
+                    "`pip install tqdm`"
+                )
+                if self.silent_errors:
+                    logger.warning(e)
+                else:
+                    raise ImportError(
+                        "To log the progress of DirectoryLoader "
+                        "you need to install tqdm, "
+                        "`pip install tqdm`"
+                    )
+
+        if self.use_multithreading:
+            futures = []
+            with concurrent.futures.ThreadPoolExecutor(
+                max_workers=self.max_concurrency
+            ) as executor:
+                for i in items:
+                    futures.append(
+                        executor.submit(
+                            self._lazy_load_file_to_non_generator(self._lazy_load_file),
+                            i,
+                            p,
+                            pbar,
+                        )
+                    )
+                for future in concurrent.futures.as_completed(futures):
+                    for item in future.result():
+                        yield item
+        else:
+            for i in items:
+                yield from self._lazy_load_file(i, p, pbar)
+
+        if pbar:
+            pbar.close()
+
+    def _lazy_load_file_to_non_generator(self, func: Callable) -> Callable:
+        def non_generator(item: Path, path: Path, pbar: Optional[Any]) -> List:
+            return [x for x in func(item, path, pbar)]
+
+        return non_generator
+
+    def _lazy_load_file(
+        self, item: Path, path: Path, pbar: Optional[Any]
+    ) -> Iterator[Document]:
+        """Load a file.
+
+        Args:
+            item: File path.
+            path: Directory path.
+            pbar: Progress bar. Defaults to None.
+
+        """
+        if item.is_file():
+            if _is_visible(item.relative_to(path)) or self.load_hidden:
+                try:
+                    logger.debug(f"Processing file: {str(item)}")
+                    loader = self.loader_cls(str(item), **self.loader_kwargs)
+                    try:
+                        for subdoc in loader.lazy_load():
+                            yield subdoc
+                    except NotImplementedError:
+                        for subdoc in loader.load():
+                            yield subdoc
+                except Exception as e:
+                    if self.silent_errors:
+                        logger.warning(f"Error loading file {str(item)}: {e}")
+                    else:
+                        logger.error(f"Error loading file {str(item)}")
+                        raise e
+                finally:
+                    if pbar:
+                        pbar.update(1)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/discord.py b/llm/Lib/site-packages/langchain_community/document_loaders/discord.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c5308e6ae017ab2234b85a9544b8370ba947248
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/discord.py
@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+if TYPE_CHECKING:
+    import pandas as pd
+
+
+class DiscordChatLoader(BaseLoader):
+    """Load `Discord` chat logs."""
+
+    def __init__(self, chat_log: pd.DataFrame, user_id_col: str = "ID"):
+        """Initialize with a Pandas DataFrame containing chat logs.
+
+        Args:
+            chat_log: Pandas DataFrame containing chat logs.
+            user_id_col: Name of the column containing the user ID. Defaults to "ID".
+        """
+        if not isinstance(chat_log, pd.DataFrame):
+            raise ValueError(
+                f"Expected chat_log to be a pd.DataFrame, got {type(chat_log)}"
+            )
+        self.chat_log = chat_log
+        self.user_id_col = user_id_col
+
+    def load(self) -> List[Document]:
+        """Load all chat messages."""
+        result = []
+        for _, row in self.chat_log.iterrows():
+            user_id = row[self.user_id_col]
+            metadata = row.to_dict()
+            metadata.pop(self.user_id_col)
+            result.append(Document(page_content=user_id, metadata=metadata))
+        return result
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/doc_intelligence.py b/llm/Lib/site-packages/langchain_community/document_loaders/doc_intelligence.py
new file mode 100644
index 0000000000000000000000000000000000000000..f4965e1767cbd4607fcf7f5935270fcdae09f90d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/doc_intelligence.py
@@ -0,0 +1,98 @@
+from typing import Iterator, List, Optional
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.blob_loaders import Blob
+from langchain_community.document_loaders.parsers import (
+    AzureAIDocumentIntelligenceParser,
+)
+
+
+class AzureAIDocumentIntelligenceLoader(BaseLoader):
+    """Loads a PDF with Azure Document Intelligence"""
+
+    def __init__(
+        self,
+        api_endpoint: str,
+        api_key: str,
+        file_path: Optional[str] = None,
+        url_path: Optional[str] = None,
+        api_version: Optional[str] = None,
+        api_model: str = "prebuilt-layout",
+        mode: str = "markdown",
+        *,
+        analysis_features: Optional[List[str]] = None,
+    ) -> None:
+        """
+        Initialize the object for file processing with Azure Document Intelligence
+        (formerly Form Recognizer).
+
+        This constructor initializes a AzureAIDocumentIntelligenceParser object to be
+        used for parsing files using the Azure Document Intelligence API. The load
+        method generates Documents whose content representations are determined by the
+        mode parameter.
+
+        Parameters:
+        -----------
+        api_endpoint: str
+            The API endpoint to use for DocumentIntelligenceClient construction.
+        api_key: str
+            The API key to use for DocumentIntelligenceClient construction.
+        file_path : Optional[str]
+            The path to the file that needs to be loaded.
+            Either file_path or url_path must be specified.
+        url_path : Optional[str]
+            The URL to the file that needs to be loaded.
+            Either file_path or url_path must be specified.
+        api_version: Optional[str]
+            The API version for DocumentIntelligenceClient. Setting None to use
+            the default value from `azure-ai-documentintelligence` package.
+        api_model: str
+            Unique document model name. Default value is "prebuilt-layout".
+            Note that overriding this default value may result in unsupported
+            behavior.
+        mode: Optional[str]
+            The type of content representation of the generated Documents.
+            Use either "single", "page", or "markdown". Default value is "markdown".
+        analysis_features: Optional[List[str]]
+            List of optional analysis features, each feature should be passed
+            as a str that conforms to the enum `DocumentAnalysisFeature` in
+            `azure-ai-documentintelligence` package. Default value is None.
+
+        Examples:
+        ---------
+        >>> obj = AzureAIDocumentIntelligenceLoader(
+        ...     file_path="path/to/file",
+        ...     api_endpoint="https://endpoint.azure.com",
+        ...     api_key="APIKEY",
+        ...     api_version="2023-10-31-preview",
+        ...     api_model="prebuilt-layout",
+        ...     mode="markdown"
+        ... )
+        """
+
+        assert (
+            file_path is not None or url_path is not None
+        ), "file_path or url_path must be provided"
+        self.file_path = file_path
+        self.url_path = url_path
+
+        self.parser = AzureAIDocumentIntelligenceParser(  # type: ignore[misc]
+            api_endpoint=api_endpoint,
+            api_key=api_key,
+            api_version=api_version,
+            api_model=api_model,
+            mode=mode,
+            analysis_features=analysis_features,
+        )
+
+    def lazy_load(
+        self,
+    ) -> Iterator[Document]:
+        """Lazy load given path as pages."""
+        if self.file_path is not None:
+            blob = Blob.from_path(self.file_path)  # type: ignore[attr-defined]
+            yield from self.parser.parse(blob)
+        else:
+            yield from self.parser.parse_url(self.url_path)  # type: ignore[arg-type]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/docugami.py b/llm/Lib/site-packages/langchain_community/document_loaders/docugami.py
new file mode 100644
index 0000000000000000000000000000000000000000..e7256e9685d4a60bca0f926e64a48aa3ad0853ae
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/docugami.py
@@ -0,0 +1,368 @@
+import hashlib
+import io
+import logging
+import os
+from pathlib import Path
+from typing import Any, Dict, List, Mapping, Optional, Sequence, Union
+
+import requests
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+from langchain_community.document_loaders.base import BaseLoader
+
+TABLE_NAME = "{http://www.w3.org/1999/xhtml}table"
+
+XPATH_KEY = "xpath"
+ID_KEY = "id"
+DOCUMENT_SOURCE_KEY = "source"
+DOCUMENT_NAME_KEY = "name"
+STRUCTURE_KEY = "structure"
+TAG_KEY = "tag"
+PROJECTS_KEY = "projects"
+
+DEFAULT_API_ENDPOINT = "https://api.docugami.com/v1preview1"
+
+logger = logging.getLogger(__name__)
+
+
+@deprecated(
+    since="0.0.24",
+    removal="0.2.0",
+    alternative_import="docugami_langchain.DocugamiLoader",
+)
+class DocugamiLoader(BaseLoader, BaseModel):
+    """Load from `Docugami`.
+
+    To use, you should have the ``dgml-utils`` python package installed.
+    """
+
+    api: str = DEFAULT_API_ENDPOINT
+    """The Docugami API endpoint to use."""
+
+    access_token: Optional[str] = os.environ.get("DOCUGAMI_API_KEY")
+    """The Docugami API access token to use."""
+
+    max_text_length = 4096
+    """Max length of chunk text returned."""
+
+    min_text_length: int = 32
+    """Threshold under which chunks are appended to next to avoid over-chunking."""
+
+    max_metadata_length = 512
+    """Max length of metadata text returned."""
+
+    include_xml_tags: bool = False
+    """Set to true for XML tags in chunk output text."""
+
+    parent_hierarchy_levels: int = 0
+    """Set appropriately to get parent chunks using the chunk hierarchy."""
+
+    parent_id_key: str = "doc_id"
+    """Metadata key for parent doc ID."""
+
+    sub_chunk_tables: bool = False
+    """Set to True to return sub-chunks within tables."""
+
+    whitespace_normalize_text: bool = True
+    """Set to False if you want to full whitespace formatting in the original
+    XML doc, including indentation."""
+
+    docset_id: Optional[str]
+    """The Docugami API docset ID to use."""
+
+    document_ids: Optional[Sequence[str]]
+    """The Docugami API document IDs to use."""
+
+    file_paths: Optional[Sequence[Union[Path, str]]]
+    """The local file paths to use."""
+
+    include_project_metadata_in_doc_metadata: bool = True
+    """Set to True if you want to include the project metadata in the doc metadata."""
+
+    @root_validator
+    def validate_local_or_remote(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Validate that either local file paths are given, or remote API docset ID.
+
+        Args:
+            values: The values to validate.
+
+        Returns:
+            The validated values.
+        """
+        if values.get("file_paths") and values.get("docset_id"):
+            raise ValueError("Cannot specify both file_paths and remote API docset_id")
+
+        if not values.get("file_paths") and not values.get("docset_id"):
+            raise ValueError("Must specify either file_paths or remote API docset_id")
+
+        if values.get("docset_id") and not values.get("access_token"):
+            raise ValueError("Must specify access token if using remote API docset_id")
+
+        return values
+
+    def _parse_dgml(
+        self,
+        content: bytes,
+        document_name: Optional[str] = None,
+        additional_doc_metadata: Optional[Mapping] = None,
+    ) -> List[Document]:
+        """Parse a single DGML document into a list of Documents."""
+        try:
+            from lxml import etree
+        except ImportError:
+            raise ImportError(
+                "Could not import lxml python package. "
+                "Please install it with `pip install lxml`."
+            )
+
+        try:
+            from dgml_utils.models import Chunk
+            from dgml_utils.segmentation import get_chunks
+        except ImportError:
+            raise ImportError(
+                "Could not import from dgml-utils python package. "
+                "Please install it with `pip install dgml-utils`."
+            )
+
+        def _build_framework_chunk(dg_chunk: Chunk) -> Document:
+            # Stable IDs for chunks with the same text.
+            _hashed_id = hashlib.md5(dg_chunk.text.encode()).hexdigest()
+            metadata = {
+                XPATH_KEY: dg_chunk.xpath,
+                ID_KEY: _hashed_id,
+                DOCUMENT_NAME_KEY: document_name,
+                DOCUMENT_SOURCE_KEY: document_name,
+                STRUCTURE_KEY: dg_chunk.structure,
+                TAG_KEY: dg_chunk.tag,
+            }
+
+            text = dg_chunk.text
+            if additional_doc_metadata:
+                if self.include_project_metadata_in_doc_metadata:
+                    metadata.update(additional_doc_metadata)
+
+            return Document(
+                page_content=text[: self.max_text_length],
+                metadata=metadata,
+            )
+
+        # Parse the tree and return chunks
+        tree = etree.parse(io.BytesIO(content))
+        root = tree.getroot()
+
+        dg_chunks = get_chunks(
+            root,
+            min_text_length=self.min_text_length,
+            max_text_length=self.max_text_length,
+            whitespace_normalize_text=self.whitespace_normalize_text,
+            sub_chunk_tables=self.sub_chunk_tables,
+            include_xml_tags=self.include_xml_tags,
+            parent_hierarchy_levels=self.parent_hierarchy_levels,
+        )
+
+        framework_chunks: Dict[str, Document] = {}
+        for dg_chunk in dg_chunks:
+            framework_chunk = _build_framework_chunk(dg_chunk)
+            chunk_id = framework_chunk.metadata.get(ID_KEY)
+            if chunk_id:
+                framework_chunks[chunk_id] = framework_chunk
+                if dg_chunk.parent:
+                    framework_parent_chunk = _build_framework_chunk(dg_chunk.parent)
+                    parent_id = framework_parent_chunk.metadata.get(ID_KEY)
+                    if parent_id and framework_parent_chunk.page_content:
+                        framework_chunk.metadata[self.parent_id_key] = parent_id
+                        framework_chunks[parent_id] = framework_parent_chunk
+
+        return list(framework_chunks.values())
+
+    def _document_details_for_docset_id(self, docset_id: str) -> List[Dict]:
+        """Gets all document details for the given docset ID"""
+        url = f"{self.api}/docsets/{docset_id}/documents"
+        all_documents = []
+
+        while url:
+            response = requests.get(
+                url,
+                headers={"Authorization": f"Bearer {self.access_token}"},
+            )
+            if response.ok:
+                data = response.json()
+                all_documents.extend(data["documents"])
+                url = data.get("next", None)
+            else:
+                raise Exception(
+                    f"Failed to download {url} (status: {response.status_code})"
+                )
+
+        return all_documents
+
+    def _project_details_for_docset_id(self, docset_id: str) -> List[Dict]:
+        """Gets all project details for the given docset ID"""
+        url = f"{self.api}/projects?docset.id={docset_id}"
+        all_projects = []
+
+        while url:
+            response = requests.request(
+                "GET",
+                url,
+                headers={"Authorization": f"Bearer {self.access_token}"},
+                data={},
+            )
+            if response.ok:
+                data = response.json()
+                all_projects.extend(data["projects"])
+                url = data.get("next", None)
+            else:
+                raise Exception(
+                    f"Failed to download {url} (status: {response.status_code})"
+                )
+
+        return all_projects
+
+    def _metadata_for_project(self, project: Dict) -> Dict:
+        """Gets project metadata for all files"""
+        project_id = project.get(ID_KEY)
+
+        url = f"{self.api}/projects/{project_id}/artifacts/latest"
+        all_artifacts = []
+
+        per_file_metadata: Dict = {}
+        while url:
+            response = requests.request(
+                "GET",
+                url,
+                headers={"Authorization": f"Bearer {self.access_token}"},
+                data={},
+            )
+            if response.ok:
+                data = response.json()
+                all_artifacts.extend(data["artifacts"])
+                url = data.get("next", None)
+            elif response.status_code == 404:
+                # Not found is ok, just means no published projects
+                return per_file_metadata
+            else:
+                raise Exception(
+                    f"Failed to download {url} (status: {response.status_code})"
+                )
+
+        for artifact in all_artifacts:
+            artifact_name = artifact.get("name")
+            artifact_url = artifact.get("url")
+            artifact_doc = artifact.get("document")
+
+            if artifact_name == "report-values.xml" and artifact_url and artifact_doc:
+                doc_id = artifact_doc[ID_KEY]
+                metadata: Dict = {}
+
+                # The evaluated XML for each document is named after the project
+                response = requests.request(
+                    "GET",
+                    f"{artifact_url}/content",
+                    headers={"Authorization": f"Bearer {self.access_token}"},
+                    data={},
+                )
+
+                if response.ok:
+                    try:
+                        from lxml import etree
+                    except ImportError:
+                        raise ImportError(
+                            "Could not import lxml python package. "
+                            "Please install it with `pip install lxml`."
+                        )
+                    artifact_tree = etree.parse(io.BytesIO(response.content))
+                    artifact_root = artifact_tree.getroot()
+                    ns = artifact_root.nsmap
+                    entries = artifact_root.xpath("//pr:Entry", namespaces=ns)
+                    for entry in entries:
+                        heading = entry.xpath("./pr:Heading", namespaces=ns)[0].text
+                        value = " ".join(
+                            entry.xpath("./pr:Value", namespaces=ns)[0].itertext()
+                        ).strip()
+                        metadata[heading] = value[: self.max_metadata_length]
+                    per_file_metadata[doc_id] = metadata
+                else:
+                    raise Exception(
+                        f"Failed to download {artifact_url}/content "
+                        + "(status: {response.status_code})"
+                    )
+
+        return per_file_metadata
+
+    def _load_chunks_for_document(
+        self,
+        document_id: str,
+        docset_id: str,
+        document_name: Optional[str] = None,
+        additional_metadata: Optional[Mapping] = None,
+    ) -> List[Document]:
+        """Load chunks for a document."""
+        url = f"{self.api}/docsets/{docset_id}/documents/{document_id}/dgml"
+
+        response = requests.request(
+            "GET",
+            url,
+            headers={"Authorization": f"Bearer {self.access_token}"},
+            data={},
+        )
+
+        if response.ok:
+            return self._parse_dgml(
+                content=response.content,
+                document_name=document_name,
+                additional_doc_metadata=additional_metadata,
+            )
+        else:
+            raise Exception(
+                f"Failed to download {url} (status: {response.status_code})"
+            )
+
+    def load(self) -> List[Document]:
+        """Load documents."""
+        chunks: List[Document] = []
+
+        if self.access_token and self.docset_id:
+            # Remote mode
+            _document_details = self._document_details_for_docset_id(self.docset_id)
+            if self.document_ids:
+                _document_details = [
+                    d for d in _document_details if d[ID_KEY] in self.document_ids
+                ]
+
+            _project_details = self._project_details_for_docset_id(self.docset_id)
+            combined_project_metadata: Dict[str, Dict] = {}
+            if _project_details and self.include_project_metadata_in_doc_metadata:
+                # If there are any projects for this docset and the caller requested
+                # project metadata, load it.
+                for project in _project_details:
+                    metadata = self._metadata_for_project(project)
+                    for file_id in metadata:
+                        if file_id not in combined_project_metadata:
+                            combined_project_metadata[file_id] = metadata[file_id]
+                        else:
+                            combined_project_metadata[file_id].update(metadata[file_id])
+
+            for doc in _document_details:
+                doc_id = doc[ID_KEY]
+                doc_name = doc.get(DOCUMENT_NAME_KEY)
+                doc_metadata = combined_project_metadata.get(doc_id)
+                chunks += self._load_chunks_for_document(
+                    document_id=doc_id,
+                    docset_id=self.docset_id,
+                    document_name=doc_name,
+                    additional_metadata=doc_metadata,
+                )
+        elif self.file_paths:
+            # Local mode (for integration testing, or pre-downloaded XML)
+            for path in self.file_paths:
+                path = Path(path)
+                with open(path, "rb") as file:
+                    chunks += self._parse_dgml(
+                        content=file.read(),
+                        document_name=path.name,
+                    )
+
+        return chunks
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/docusaurus.py b/llm/Lib/site-packages/langchain_community/document_loaders/docusaurus.py
new file mode 100644
index 0000000000000000000000000000000000000000..81ca689b88bcb9a77bb20fbc246a34bd195499bd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/docusaurus.py
@@ -0,0 +1,50 @@
+"""Load Documents from Docusarus Documentation"""
+from typing import Any, List, Optional
+
+from langchain_community.document_loaders.sitemap import SitemapLoader
+
+
+class DocusaurusLoader(SitemapLoader):
+    """Load from Docusaurus Documentation.
+
+    It leverages the SitemapLoader to loop through the generated pages of a
+    Docusaurus Documentation website and extracts the content by looking for specific
+    HTML tags. By default, the parser searches for the main content of the Docusaurus
+    page, which is normally the <article>. You can also define your own
+    custom HTML tags by providing them as a list, for example: ["div", ".main", "a"].
+    """
+
+    def __init__(
+        self,
+        url: str,
+        custom_html_tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ):
+        """Initialize DocusaurusLoader
+
+        Args:
+            url: The base URL of the Docusaurus website.
+            custom_html_tags: Optional custom html tags to extract content from pages.
+            kwargs: Additional args to extend the underlying SitemapLoader, for example:
+                filter_urls, blocksize, meta_function, is_local, continue_on_failure
+        """
+        if not kwargs.get("is_local"):
+            url = f"{url}/sitemap.xml"
+
+        self.custom_html_tags = custom_html_tags or ["main article"]
+
+        super().__init__(
+            url,
+            parsing_function=kwargs.get("parsing_function") or self._parsing_function,
+            **kwargs,
+        )
+
+    def _parsing_function(self, content: Any) -> str:
+        """Parses specific elements from a Docusaurus page."""
+        relevant_elements = content.select(",".join(self.custom_html_tags))
+
+        for element in relevant_elements:
+            if element not in relevant_elements:
+                element.decompose()
+
+        return str(content.get_text())
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/dropbox.py b/llm/Lib/site-packages/langchain_community/document_loaders/dropbox.py
new file mode 100644
index 0000000000000000000000000000000000000000..fb76043c138e85b75e3e249f5c5d324a0d8aa3a9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/dropbox.py
@@ -0,0 +1,173 @@
+# Prerequisites:
+# 1. Create a Dropbox app.
+# 2. Give the app these scope permissions: `files.metadata.read`
+#    and `files.content.read`.
+# 3. Generate access token: https://www.dropbox.com/developers/apps/create.
+# 4. `pip install dropbox` (requires `pip install unstructured[pdf]` for PDF filetype).
+
+
+import os
+import tempfile
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class DropboxLoader(BaseLoader, BaseModel):
+    """Load files from `Dropbox`.
+
+    In addition to common files such as text and PDF files, it also supports
+    *Dropbox Paper* files.
+    """
+
+    dropbox_access_token: str
+    """Dropbox access token."""
+    dropbox_folder_path: Optional[str] = None
+    """The folder path to load from."""
+    dropbox_file_paths: Optional[List[str]] = None
+    """The file paths to load from."""
+    recursive: bool = False
+    """Flag to indicate whether to load files recursively from subfolders."""
+
+    @root_validator
+    def validate_inputs(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Validate that either folder_path or file_paths is set, but not both."""
+        if (
+            values.get("dropbox_folder_path") is not None
+            and values.get("dropbox_file_paths") is not None
+        ):
+            raise ValueError("Cannot specify both folder_path and file_paths")
+        if values.get("dropbox_folder_path") is None and not values.get(
+            "dropbox_file_paths"
+        ):
+            raise ValueError("Must specify either folder_path or file_paths")
+
+        return values
+
+    def _create_dropbox_client(self) -> Any:
+        """Create a Dropbox client."""
+        try:
+            from dropbox import Dropbox, exceptions
+        except ImportError:
+            raise ImportError("You must run " "`pip install dropbox")
+
+        try:
+            dbx = Dropbox(self.dropbox_access_token)
+            dbx.users_get_current_account()
+        except exceptions.AuthError as ex:
+            raise ValueError(
+                "Invalid Dropbox access token. Please verify your token and try again."
+            ) from ex
+        return dbx
+
+    def _load_documents_from_folder(self, folder_path: str) -> List[Document]:
+        """Load documents from a Dropbox folder."""
+        dbx = self._create_dropbox_client()
+
+        try:
+            from dropbox import exceptions
+            from dropbox.files import FileMetadata
+        except ImportError:
+            raise ImportError("You must run " "`pip install dropbox")
+
+        try:
+            results = dbx.files_list_folder(folder_path, recursive=self.recursive)
+        except exceptions.ApiError as ex:
+            raise ValueError(
+                f"Could not list files in the folder: {folder_path}. "
+                "Please verify the folder path and try again."
+            ) from ex
+
+        files = [entry for entry in results.entries if isinstance(entry, FileMetadata)]
+        documents = [
+            doc
+            for doc in (self._load_file_from_path(file.path_display) for file in files)
+            if doc is not None
+        ]
+        return documents
+
+    def _load_file_from_path(self, file_path: str) -> Optional[Document]:
+        """Load a file from a Dropbox path."""
+        dbx = self._create_dropbox_client()
+
+        try:
+            from dropbox import exceptions
+        except ImportError:
+            raise ImportError("You must run " "`pip install dropbox")
+
+        try:
+            file_metadata = dbx.files_get_metadata(file_path)
+
+            if file_metadata.is_downloadable:
+                _, response = dbx.files_download(file_path)
+
+            # Some types such as Paper, need to be exported.
+            elif file_metadata.export_info:
+                _, response = dbx.files_export(file_path, "markdown")
+
+        except exceptions.ApiError as ex:
+            raise ValueError(
+                f"Could not load file: {file_path}. Please verify the file path"
+                "and try again."
+            ) from ex
+
+        try:
+            text = response.content.decode("utf-8")
+        except UnicodeDecodeError:
+            file_extension = os.path.splitext(file_path)[1].lower()
+
+            if file_extension == ".pdf":
+                print(f"File {file_path} type detected as .pdf")  # noqa: T201
+                from langchain_community.document_loaders import UnstructuredPDFLoader
+
+                # Download it to a temporary file.
+                temp_dir = tempfile.TemporaryDirectory()
+                temp_pdf = Path(temp_dir.name) / "tmp.pdf"
+                with open(temp_pdf, mode="wb") as f:
+                    f.write(response.content)
+
+                try:
+                    loader = UnstructuredPDFLoader(str(temp_pdf))
+                    docs = loader.load()
+                    if docs:
+                        return docs[0]
+                except Exception as pdf_ex:
+                    print(f"Error while trying to parse PDF {file_path}: {pdf_ex}")  # noqa: T201
+                    return None
+            else:
+                print(  # noqa: T201
+                    f"File {file_path} could not be decoded as pdf or text. Skipping."
+                )
+
+            return None
+
+        metadata = {
+            "source": f"dropbox://{file_path}",
+            "title": os.path.basename(file_path),
+        }
+        return Document(page_content=text, metadata=metadata)
+
+    def _load_documents_from_paths(self) -> List[Document]:
+        """Load documents from a list of Dropbox file paths."""
+        if not self.dropbox_file_paths:
+            raise ValueError("file_paths must be set")
+
+        return [
+            doc
+            for doc in (
+                self._load_file_from_path(file_path)
+                for file_path in self.dropbox_file_paths
+            )
+            if doc is not None
+        ]
+
+    def load(self) -> List[Document]:
+        """Load documents."""
+        if self.dropbox_folder_path is not None:
+            return self._load_documents_from_folder(self.dropbox_folder_path)
+        else:
+            return self._load_documents_from_paths()
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/duckdb_loader.py b/llm/Lib/site-packages/langchain_community/document_loaders/duckdb_loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e2c3022d547a5bea200940b8d0114c6f48d3850
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/duckdb_loader.py
@@ -0,0 +1,89 @@
+from typing import Dict, List, Optional, cast
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class DuckDBLoader(BaseLoader):
+    """Load from `DuckDB`.
+
+    Each document represents one row of the result. The `page_content_columns`
+    are written into the `page_content` of the document. The `metadata_columns`
+    are written into the `metadata` of the document. By default, all columns
+    are written into the `page_content` and none into the `metadata`.
+    """
+
+    def __init__(
+        self,
+        query: str,
+        database: str = ":memory:",
+        read_only: bool = False,
+        config: Optional[Dict[str, str]] = None,
+        page_content_columns: Optional[List[str]] = None,
+        metadata_columns: Optional[List[str]] = None,
+    ):
+        """
+
+        Args:
+            query: The query to execute.
+            database: The database to connect to. Defaults to ":memory:".
+            read_only: Whether to open the database in read-only mode.
+              Defaults to False.
+            config: A dictionary of configuration options to pass to the database.
+              Optional.
+            page_content_columns: The columns to write into the `page_content`
+              of the document. Optional.
+            metadata_columns: The columns to write into the `metadata` of the document.
+              Optional.
+        """
+        self.query = query
+        self.database = database
+        self.read_only = read_only
+        self.config = config or {}
+        self.page_content_columns = page_content_columns
+        self.metadata_columns = metadata_columns
+
+    def load(self) -> List[Document]:
+        try:
+            import duckdb
+        except ImportError:
+            raise ImportError(
+                "Could not import duckdb python package. "
+                "Please install it with `pip install duckdb`."
+            )
+
+        docs = []
+        with duckdb.connect(
+            database=self.database, read_only=self.read_only, config=self.config
+        ) as con:
+            query_result = con.execute(self.query)
+            results = query_result.fetchall()
+            description = cast(list, query_result.description)
+            field_names = [c[0] for c in description]
+
+            if self.page_content_columns is None:
+                page_content_columns = field_names
+            else:
+                page_content_columns = self.page_content_columns
+
+            if self.metadata_columns is None:
+                metadata_columns = []
+            else:
+                metadata_columns = self.metadata_columns
+
+            for result in results:
+                page_content = "\n".join(
+                    f"{column}: {result[field_names.index(column)]}"
+                    for column in page_content_columns
+                )
+
+                metadata = {
+                    column: result[field_names.index(column)]
+                    for column in metadata_columns
+                }
+
+                doc = Document(page_content=page_content, metadata=metadata)
+                docs.append(doc)
+
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/email.py b/llm/Lib/site-packages/langchain_community/document_loaders/email.py
new file mode 100644
index 0000000000000000000000000000000000000000..832593839e32837a0e28cbb692891322cb1b61cd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/email.py
@@ -0,0 +1,118 @@
+import os
+from pathlib import Path
+from typing import Any, Iterator, List, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.unstructured import (
+    UnstructuredFileLoader,
+    satisfies_min_unstructured_version,
+)
+
+
+class UnstructuredEmailLoader(UnstructuredFileLoader):
+    """Load email files using `Unstructured`.
+
+    Works with both
+    .eml and .msg files. You can process attachments in addition to the
+    e-mail message itself by passing process_attachments=True into the
+    constructor for the loader. By default, attachments will be processed
+    with the unstructured partition function. If you already know the document
+    types of the attachments, you can specify another partitioning function
+    with the attachment partitioner kwarg.
+
+    Example
+    -------
+    from langchain_community.document_loaders import UnstructuredEmailLoader
+
+    loader = UnstructuredEmailLoader("example_data/fake-email.eml", mode="elements")
+    loader.load()
+
+    Example
+    -------
+    from langchain_community.document_loaders import UnstructuredEmailLoader
+
+    loader = UnstructuredEmailLoader(
+        "example_data/fake-email-attachment.eml",
+        mode="elements",
+        process_attachments=True,
+    )
+    loader.load()
+    """
+
+    def __init__(
+        self,
+        file_path: Union[str, Path],
+        mode: str = "single",
+        **unstructured_kwargs: Any,
+    ):
+        process_attachments = unstructured_kwargs.get("process_attachments")
+        attachment_partitioner = unstructured_kwargs.get("attachment_partitioner")
+
+        if process_attachments and attachment_partitioner is None:
+            from unstructured.partition.auto import partition
+
+            unstructured_kwargs["attachment_partitioner"] = partition
+
+        super().__init__(file_path=file_path, mode=mode, **unstructured_kwargs)
+
+    def _get_elements(self) -> List:
+        from unstructured.file_utils.filetype import FileType, detect_filetype
+
+        filetype = detect_filetype(self.file_path)
+
+        if filetype == FileType.EML:
+            from unstructured.partition.email import partition_email
+
+            return partition_email(filename=self.file_path, **self.unstructured_kwargs)
+        elif satisfies_min_unstructured_version("0.5.8") and filetype == FileType.MSG:
+            from unstructured.partition.msg import partition_msg
+
+            return partition_msg(filename=self.file_path, **self.unstructured_kwargs)
+        else:
+            raise ValueError(
+                f"Filetype {filetype} is not supported in UnstructuredEmailLoader."
+            )
+
+
+class OutlookMessageLoader(BaseLoader):
+    """
+    Loads Outlook Message files using extract_msg.
+
+    https://github.com/TeamMsgExtractor/msg-extractor
+    """
+
+    def __init__(self, file_path: Union[str, Path]):
+        """Initialize with a file path.
+
+        Args:
+            file_path: The path to the Outlook Message file.
+        """
+
+        self.file_path = str(file_path)
+
+        if not os.path.isfile(self.file_path):
+            raise ValueError(f"File path {self.file_path} is not a valid file")
+
+        try:
+            import extract_msg  # noqa:F401
+        except ImportError:
+            raise ImportError(
+                "extract_msg is not installed. Please install it with "
+                "`pip install extract_msg`"
+            )
+
+    def lazy_load(self) -> Iterator[Document]:
+        import extract_msg
+
+        msg = extract_msg.Message(self.file_path)
+        yield Document(
+            page_content=msg.body,
+            metadata={
+                "source": self.file_path,
+                "subject": msg.subject,
+                "sender": msg.sender,
+                "date": msg.date,
+            },
+        )
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/epub.py b/llm/Lib/site-packages/langchain_community/document_loaders/epub.py
new file mode 100644
index 0000000000000000000000000000000000000000..fbef21b9b5afa6cfd03e25f4cd55b069ceeb0677
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/epub.py
@@ -0,0 +1,42 @@
+from typing import List
+
+from langchain_community.document_loaders.unstructured import (
+    UnstructuredFileLoader,
+    satisfies_min_unstructured_version,
+)
+
+
+class UnstructuredEPubLoader(UnstructuredFileLoader):
+    """Load `EPub` files using `Unstructured`.
+
+    You can run the loader in one of two modes: "single" and "elements".
+    If you use "single" mode, the document will be returned as a single
+    langchain Document object. If you use "elements" mode, the unstructured
+    library will split the document into elements such as Title and NarrativeText.
+    You can pass in additional unstructured kwargs after mode to apply
+    different unstructured settings.
+
+    Examples
+    --------
+    from langchain_community.document_loaders import UnstructuredEPubLoader
+
+    loader = UnstructuredEPubLoader(
+        "example.epub", mode="elements", strategy="fast",
+    )
+    docs = loader.load()
+
+    References
+    ----------
+    https://unstructured-io.github.io/unstructured/bricks.html#partition-epub
+    """
+
+    def _get_elements(self) -> List:
+        min_unstructured_version = "0.5.4"
+        if not satisfies_min_unstructured_version(min_unstructured_version):
+            raise ValueError(
+                "Partitioning epub files is only supported in "
+                f"unstructured>={min_unstructured_version}."
+            )
+        from unstructured.partition.epub import partition_epub
+
+        return partition_epub(filename=self.file_path, **self.unstructured_kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/etherscan.py b/llm/Lib/site-packages/langchain_community/document_loaders/etherscan.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff78aa90a91af83f7ac77bf338d514a2aa7a8166
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/etherscan.py
@@ -0,0 +1,199 @@
+import os
+import re
+from typing import Iterator, List
+
+import requests
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class EtherscanLoader(BaseLoader):
+    """Load transactions from `Ethereum` mainnet.
+
+    The Loader use Etherscan API to interact with Ethereum mainnet.
+
+    ETHERSCAN_API_KEY environment variable must be set use this loader.
+    """
+
+    def __init__(
+        self,
+        account_address: str,
+        api_key: str = "docs-demo",
+        filter: str = "normal_transaction",
+        page: int = 1,
+        offset: int = 10,
+        start_block: int = 0,
+        end_block: int = 99999999,
+        sort: str = "desc",
+    ):
+        self.account_address = account_address
+        self.api_key = os.environ.get("ETHERSCAN_API_KEY") or api_key
+        self.filter = filter
+        self.page = page
+        self.offset = offset
+        self.start_block = start_block
+        self.end_block = end_block
+        self.sort = sort
+
+        if not self.api_key:
+            raise ValueError("Etherscan API key not provided")
+
+        if not re.match(r"^0x[a-fA-F0-9]{40}$", self.account_address):
+            raise ValueError(f"Invalid contract address {self.account_address}")
+        if filter not in [
+            "normal_transaction",
+            "internal_transaction",
+            "erc20_transaction",
+            "eth_balance",
+            "erc721_transaction",
+            "erc1155_transaction",
+        ]:
+            raise ValueError(f"Invalid filter {filter}")
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Lazy load Documents from table."""
+        result = []
+        if self.filter == "normal_transaction":
+            result = self.getNormTx()
+        elif self.filter == "internal_transaction":
+            result = self.getInternalTx()
+        elif self.filter == "erc20_transaction":
+            result = self.getERC20Tx()
+        elif self.filter == "eth_balance":
+            result = self.getEthBalance()
+        elif self.filter == "erc721_transaction":
+            result = self.getERC721Tx()
+        elif self.filter == "erc1155_transaction":
+            result = self.getERC1155Tx()
+        else:
+            raise ValueError(f"Invalid filter {filter}")
+        for doc in result:
+            yield doc
+
+    def getNormTx(self) -> List[Document]:
+        url = (
+            f"https://api.etherscan.io/api?module=account&action=txlist&address={self.account_address}"
+            f"&startblock={self.start_block}&endblock={self.end_block}&page={self.page}"
+            f"&offset={self.offset}&sort={self.sort}&apikey={self.api_key}"
+        )
+        try:
+            response = requests.get(url)
+            response.raise_for_status()
+        except requests.exceptions.RequestException as e:
+            print("Error occurred while making the request:", e)  # noqa: T201
+        items = response.json()["result"]
+        result = []
+        if len(items) == 0:
+            return [Document(page_content="")]
+        for item in items:
+            content = str(item)
+            metadata = {"from": item["from"], "tx_hash": item["hash"], "to": item["to"]}
+            result.append(Document(page_content=content, metadata=metadata))
+        print(len(result))  # noqa: T201
+        return result
+
+    def getEthBalance(self) -> List[Document]:
+        url = (
+            f"https://api.etherscan.io/api?module=account&action=balance"
+            f"&address={self.account_address}&tag=latest&apikey={self.api_key}"
+        )
+
+        try:
+            response = requests.get(url)
+            response.raise_for_status()
+        except requests.exceptions.RequestException as e:
+            print("Error occurred while making the request:", e)  # noqa: T201
+        return [Document(page_content=response.json()["result"])]
+
+    def getInternalTx(self) -> List[Document]:
+        url = (
+            f"https://api.etherscan.io/api?module=account&action=txlistinternal"
+            f"&address={self.account_address}&startblock={self.start_block}"
+            f"&endblock={self.end_block}&page={self.page}&offset={self.offset}"
+            f"&sort={self.sort}&apikey={self.api_key}"
+        )
+
+        try:
+            response = requests.get(url)
+            response.raise_for_status()
+        except requests.exceptions.RequestException as e:
+            print("Error occurred while making the request:", e)  # noqa: T201
+        items = response.json()["result"]
+        result = []
+        if len(items) == 0:
+            return [Document(page_content="")]
+        for item in items:
+            content = str(item)
+            metadata = {"from": item["from"], "tx_hash": item["hash"], "to": item["to"]}
+            result.append(Document(page_content=content, metadata=metadata))
+        return result
+
+    def getERC20Tx(self) -> List[Document]:
+        url = (
+            f"https://api.etherscan.io/api?module=account&action=tokentx"
+            f"&address={self.account_address}&startblock={self.start_block}"
+            f"&endblock={self.end_block}&page={self.page}&offset={self.offset}"
+            f"&sort={self.sort}&apikey={self.api_key}"
+        )
+
+        try:
+            response = requests.get(url)
+            response.raise_for_status()
+        except requests.exceptions.RequestException as e:
+            print("Error occurred while making the request:", e)  # noqa: T201
+        items = response.json()["result"]
+        result = []
+        if len(items) == 0:
+            return [Document(page_content="")]
+        for item in items:
+            content = str(item)
+            metadata = {"from": item["from"], "tx_hash": item["hash"], "to": item["to"]}
+            result.append(Document(page_content=content, metadata=metadata))
+        return result
+
+    def getERC721Tx(self) -> List[Document]:
+        url = (
+            f"https://api.etherscan.io/api?module=account&action=tokennfttx"
+            f"&address={self.account_address}&startblock={self.start_block}"
+            f"&endblock={self.end_block}&page={self.page}&offset={self.offset}"
+            f"&sort={self.sort}&apikey={self.api_key}"
+        )
+
+        try:
+            response = requests.get(url)
+            response.raise_for_status()
+        except requests.exceptions.RequestException as e:
+            print("Error occurred while making the request:", e)  # noqa: T201
+        items = response.json()["result"]
+        result = []
+        if len(items) == 0:
+            return [Document(page_content="")]
+        for item in items:
+            content = str(item)
+            metadata = {"from": item["from"], "tx_hash": item["hash"], "to": item["to"]}
+            result.append(Document(page_content=content, metadata=metadata))
+        return result
+
+    def getERC1155Tx(self) -> List[Document]:
+        url = (
+            f"https://api.etherscan.io/api?module=account&action=token1155tx"
+            f"&address={self.account_address}&startblock={self.start_block}"
+            f"&endblock={self.end_block}&page={self.page}&offset={self.offset}"
+            f"&sort={self.sort}&apikey={self.api_key}"
+        )
+
+        try:
+            response = requests.get(url)
+            response.raise_for_status()
+        except requests.exceptions.RequestException as e:
+            print("Error occurred while making the request:", e)  # noqa: T201
+        items = response.json()["result"]
+        result = []
+        if len(items) == 0:
+            return [Document(page_content="")]
+        for item in items:
+            content = str(item)
+            metadata = {"from": item["from"], "tx_hash": item["hash"], "to": item["to"]}
+            result.append(Document(page_content=content, metadata=metadata))
+        return result
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/evernote.py b/llm/Lib/site-packages/langchain_community/document_loaders/evernote.py
new file mode 100644
index 0000000000000000000000000000000000000000..07ade0ce5d8a5ca504b42a283c091f46c74fa8d7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/evernote.py
@@ -0,0 +1,151 @@
+"""Load documents from Evernote.
+
+https://gist.github.com/foxmask/7b29c43a161e001ff04afdb2f181e31c
+"""
+import hashlib
+import logging
+from base64 import b64decode
+from pathlib import Path
+from time import strptime
+from typing import Any, Dict, Iterator, List, Optional, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+
+class EverNoteLoader(BaseLoader):
+    """Load from `EverNote`.
+
+    Loads an EverNote notebook export file e.g. my_notebook.enex into Documents.
+    Instructions on producing this file can be found at
+    https://help.evernote.com/hc/en-us/articles/209005557-Export-notes-and-notebooks-as-ENEX-or-HTML
+
+    Currently only the plain text in the note is extracted and stored as the contents
+    of the Document, any non content metadata (e.g. 'author', 'created', 'updated' etc.
+    but not 'content-raw' or 'resource') tags on the note will be extracted and stored
+    as metadata on the Document.
+
+    Args:
+        file_path (str): The path to the notebook export with a .enex extension
+        load_single_document (bool): Whether or not to concatenate the content of all
+            notes into a single long Document.
+        If this is set to True (default) then the only metadata on the document will be
+            the 'source' which contains the file name of the export.
+    """  # noqa: E501
+
+    def __init__(self, file_path: Union[str, Path], load_single_document: bool = True):
+        """Initialize with file path."""
+        self.file_path = str(file_path)
+        self.load_single_document = load_single_document
+
+    def _lazy_load(self) -> Iterator[Document]:
+        for note in self._parse_note_xml(self.file_path):
+            if note.get("content") is not None:
+                yield Document(
+                    page_content=note["content"],
+                    metadata={
+                        **{
+                            key: value
+                            for key, value in note.items()
+                            if key not in ["content", "content-raw", "resource"]
+                        },
+                        **{"source": self.file_path},
+                    },
+                )
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Load documents from EverNote export file."""
+        if not self.load_single_document:
+            yield from self._lazy_load()
+        else:
+            yield Document(
+                page_content="".join(
+                    [document.page_content for document in self._lazy_load()]
+                ),
+                metadata={"source": self.file_path},
+            )
+
+    @staticmethod
+    def _parse_content(content: str) -> str:
+        try:
+            import html2text
+
+            return html2text.html2text(content).strip()
+        except ImportError as e:
+            raise ImportError(
+                "Could not import `html2text`. Although it is not a required package "
+                "to use Langchain, using the EverNote loader requires `html2text`. "
+                "Please install `html2text` via `pip install html2text` and try again."
+            ) from e
+
+    @staticmethod
+    def _parse_resource(resource: list) -> dict:
+        rsc_dict: Dict[str, Any] = {}
+        for elem in resource:
+            if elem.tag == "data":
+                # Sometimes elem.text is None
+                rsc_dict[elem.tag] = b64decode(elem.text) if elem.text else b""
+                rsc_dict["hash"] = hashlib.md5(rsc_dict[elem.tag]).hexdigest()
+            else:
+                rsc_dict[elem.tag] = elem.text
+
+        return rsc_dict
+
+    @staticmethod
+    def _parse_note(note: List, prefix: Optional[str] = None) -> dict:
+        note_dict: Dict[str, Any] = {}
+        resources = []
+
+        def add_prefix(element_tag: str) -> str:
+            if prefix is None:
+                return element_tag
+            return f"{prefix}.{element_tag}"
+
+        for elem in note:
+            if elem.tag == "content":
+                note_dict[elem.tag] = EverNoteLoader._parse_content(elem.text)
+                # A copy of original content
+                note_dict["content-raw"] = elem.text
+            elif elem.tag == "resource":
+                resources.append(EverNoteLoader._parse_resource(elem))
+            elif elem.tag == "created" or elem.tag == "updated":
+                note_dict[elem.tag] = strptime(elem.text, "%Y%m%dT%H%M%SZ")
+            elif elem.tag == "note-attributes":
+                additional_attributes = EverNoteLoader._parse_note(
+                    elem, elem.tag
+                )  # Recursively enter the note-attributes tag
+                note_dict.update(additional_attributes)
+            else:
+                note_dict[elem.tag] = elem.text
+
+        if len(resources) > 0:
+            note_dict["resource"] = resources
+
+        return {add_prefix(key): value for key, value in note_dict.items()}
+
+    @staticmethod
+    def _parse_note_xml(xml_file: str) -> Iterator[Dict[str, Any]]:
+        """Parse Evernote xml."""
+        # Without huge_tree set to True, parser may complain about huge text node
+        # Try to recover, because there may be "&nbsp;", which will cause
+        # "XMLSyntaxError: Entity 'nbsp' not defined"
+        try:
+            from lxml import etree
+        except ImportError as e:
+            logger.error(
+                "Could not import `lxml`. Although it is not a required package to use "
+                "Langchain, using the EverNote loader requires `lxml`. Please install "
+                "`lxml` via `pip install lxml` and try again."
+            )
+            raise e
+
+        context = etree.iterparse(
+            xml_file, encoding="utf-8", strip_cdata=False, huge_tree=True, recover=True
+        )
+
+        for action, elem in context:
+            if elem.tag == "note":
+                yield EverNoteLoader._parse_note(elem)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/excel.py b/llm/Lib/site-packages/langchain_community/document_loaders/excel.py
new file mode 100644
index 0000000000000000000000000000000000000000..3aa31cfe86ca192c84cca6ac110f4702dc1bd462
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/excel.py
@@ -0,0 +1,50 @@
+"""Loads Microsoft Excel files."""
+from pathlib import Path
+from typing import Any, List, Union
+
+from langchain_community.document_loaders.unstructured import (
+    UnstructuredFileLoader,
+    validate_unstructured_version,
+)
+
+
+class UnstructuredExcelLoader(UnstructuredFileLoader):
+    """Load Microsoft Excel files using `Unstructured`.
+
+    Like other
+    Unstructured loaders, UnstructuredExcelLoader can be used in both
+    "single" and "elements" mode. If you use the loader in "elements"
+    mode, each sheet in the Excel file will be an Unstructured Table
+    element. If you use the loader in "single" mode, an
+    HTML representation of the table will be available in the
+    "text_as_html" key in the document metadata.
+
+    Examples
+    --------
+    from langchain_community.document_loaders.excel import UnstructuredExcelLoader
+
+    loader = UnstructuredExcelLoader("stanley-cups.xlsx", mode="elements")
+    docs = loader.load()
+    """
+
+    def __init__(
+        self,
+        file_path: Union[str, Path],
+        mode: str = "single",
+        **unstructured_kwargs: Any,
+    ):
+        """
+
+        Args:
+            file_path: The path to the Microsoft Excel file.
+            mode: The mode to use when partitioning the file. See unstructured docs
+              for more info. Optional. Defaults to "single".
+            **unstructured_kwargs: Keyword arguments to pass to unstructured.
+        """
+        validate_unstructured_version(min_unstructured_version="0.6.7")
+        super().__init__(file_path=file_path, mode=mode, **unstructured_kwargs)
+
+    def _get_elements(self) -> List:
+        from unstructured.partition.xlsx import partition_xlsx
+
+        return partition_xlsx(filename=self.file_path, **self.unstructured_kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/facebook_chat.py b/llm/Lib/site-packages/langchain_community/document_loaders/facebook_chat.py
new file mode 100644
index 0000000000000000000000000000000000000000..443c9ce07f9857bf41ee44e69fd171f13fc7c05e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/facebook_chat.py
@@ -0,0 +1,45 @@
+import datetime
+import json
+from pathlib import Path
+from typing import Iterator, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+def concatenate_rows(row: dict) -> str:
+    """Combine message information in a readable format ready to be used.
+
+    Args:
+        row: dictionary containing message information.
+    """
+    sender = row["sender_name"]
+    text = row["content"]
+    date = datetime.datetime.fromtimestamp(row["timestamp_ms"] / 1000).strftime(
+        "%Y-%m-%d %H:%M:%S"
+    )
+    return f"{sender} on {date}: {text}\n\n"
+
+
+class FacebookChatLoader(BaseLoader):
+    """Load `Facebook Chat` messages directory dump."""
+
+    def __init__(self, path: Union[str, Path]):
+        """Initialize with a path."""
+        self.file_path = path
+
+    def lazy_load(self) -> Iterator[Document]:
+        p = Path(self.file_path)
+
+        with open(p, encoding="utf8") as f:
+            d = json.load(f)
+
+        text = "".join(
+            concatenate_rows(message)
+            for message in d["messages"]
+            if message.get("content") and isinstance(message["content"], str)
+        )
+        metadata = {"source": str(p)}
+
+        yield Document(page_content=text, metadata=metadata)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/fauna.py b/llm/Lib/site-packages/langchain_community/document_loaders/fauna.py
new file mode 100644
index 0000000000000000000000000000000000000000..bbfda737850eed3fd1868bb9cb1e60e42187e01a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/fauna.py
@@ -0,0 +1,62 @@
+from typing import Iterator, Optional, Sequence
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class FaunaLoader(BaseLoader):
+    """Load from `FaunaDB`.
+
+    Attributes:
+        query (str): The FQL query string to execute.
+        page_content_field (str): The field that contains the content of each page.
+        secret (str): The secret key for authenticating to FaunaDB.
+        metadata_fields (Optional[Sequence[str]]):
+            Optional list of field names to include in metadata.
+    """
+
+    def __init__(
+        self,
+        query: str,
+        page_content_field: str,
+        secret: str,
+        metadata_fields: Optional[Sequence[str]] = None,
+    ):
+        self.query = query
+        self.page_content_field = page_content_field
+        self.secret = secret
+        self.metadata_fields = metadata_fields
+
+    def lazy_load(self) -> Iterator[Document]:
+        try:
+            from fauna import Page, fql
+            from fauna.client import Client
+            from fauna.encoding import QuerySuccess
+        except ImportError:
+            raise ImportError(
+                "Could not import fauna python package. "
+                "Please install it with `pip install fauna`."
+            )
+        # Create Fauna Client
+        client = Client(secret=self.secret)
+        # Run FQL Query
+        response: QuerySuccess = client.query(fql(self.query))
+        page: Page = response.data
+        for result in page:
+            if result is not None:
+                document_dict = dict(result.items())
+                page_content = ""
+                for key, value in document_dict.items():
+                    if key == self.page_content_field:
+                        page_content = value
+                document: Document = Document(
+                    page_content=page_content,
+                    metadata={"id": result.id, "ts": result.ts},
+                )
+                yield document
+        if page.after is not None:
+            yield Document(
+                page_content="Next Page Exists",
+                metadata={"after": page.after},
+            )
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/figma.py b/llm/Lib/site-packages/langchain_community/document_loaders/figma.py
new file mode 100644
index 0000000000000000000000000000000000000000..d147aaf9f206c8449f3cc36efdba03dd8963a243
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/figma.py
@@ -0,0 +1,48 @@
+import json
+import urllib.request
+from typing import Any, List
+
+from langchain_core.documents import Document
+from langchain_core.utils import stringify_dict
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class FigmaFileLoader(BaseLoader):
+    """Load `Figma` file."""
+
+    def __init__(self, access_token: str, ids: str, key: str):
+        """Initialize with access token, ids, and key.
+
+        Args:
+            access_token: The access token for the Figma REST API.
+            ids: The ids of the Figma file.
+            key: The key for the Figma file
+        """
+        self.access_token = access_token
+        self.ids = ids
+        self.key = key
+
+    def _construct_figma_api_url(self) -> str:
+        api_url = "https://api.figma.com/v1/files/%s/nodes?ids=%s" % (
+            self.key,
+            self.ids,
+        )
+        return api_url
+
+    def _get_figma_file(self) -> Any:
+        """Get Figma file from Figma REST API."""
+        headers = {"X-Figma-Token": self.access_token}
+        request = urllib.request.Request(
+            self._construct_figma_api_url(), headers=headers
+        )
+        with urllib.request.urlopen(request) as response:
+            json_data = json.loads(response.read().decode())
+            return json_data
+
+    def load(self) -> List[Document]:
+        """Load file"""
+        data = self._get_figma_file()
+        text = stringify_dict(data)
+        metadata = {"source": self._construct_figma_api_url()}
+        return [Document(page_content=text, metadata=metadata)]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/firecrawl.py b/llm/Lib/site-packages/langchain_community/document_loaders/firecrawl.py
new file mode 100644
index 0000000000000000000000000000000000000000..8cc54f4f5938029b972b9ed140f9dd031ee464cc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/firecrawl.py
@@ -0,0 +1,66 @@
+from typing import Iterator, Literal, Optional
+
+from langchain_core.document_loaders import BaseLoader
+from langchain_core.documents import Document
+from langchain_core.utils import get_from_env
+
+
+class FireCrawlLoader(BaseLoader):
+    """Load web pages as Documents using FireCrawl.
+
+    Must have Python package `firecrawl` installed and a FireCrawl API key. See
+        https://www.firecrawl.dev/ for more.
+    """
+
+    def __init__(
+        self,
+        url: str,
+        *,
+        api_key: Optional[str] = None,
+        mode: Literal["crawl", "scrape"] = "crawl",
+        params: Optional[dict] = None,
+    ):
+        """Initialize with API key and url.
+
+        Args:
+            url: The url to be crawled.
+            api_key: The Firecrawl API key. If not specified will be read from env var
+                FIREWALL_API_KEY. Get an API key
+            mode: The mode to run the loader in. Default is "crawl".
+                 Options include "scrape" (single url) and
+                 "crawl" (all accessible sub pages).
+            params: The parameters to pass to the Firecrawl API.
+                Examples include crawlerOptions.
+                For more details, visit: https://github.com/mendableai/firecrawl-py
+        """
+
+        try:
+            from firecrawl import FirecrawlApp  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "`firecrawl` package not found, please run `pip install firecrawl-py`"
+            )
+        if mode not in ("crawl", "scrape"):
+            raise ValueError(
+                f"Unrecognized mode '{mode}'. Expected one of 'crawl', 'scrape'."
+            )
+        api_key = api_key or get_from_env("api_key", "FIREWALL_API_KEY")
+        self.firecrawl = FirecrawlApp(api_key=api_key)
+        self.url = url
+        self.mode = mode
+        self.params = params
+
+    def lazy_load(self) -> Iterator[Document]:
+        if self.mode == "scrape":
+            firecrawl_docs = [self.firecrawl.scrape_url(self.url, params=self.params)]
+        elif self.mode == "crawl":
+            firecrawl_docs = self.firecrawl.crawl_url(self.url, params=self.params)
+        else:
+            raise ValueError(
+                f"Unrecognized mode '{self.mode}'. Expected one of 'crawl', 'scrape'."
+            )
+        for doc in firecrawl_docs:
+            yield Document(
+                page_content=doc.get("markdown", ""),
+                metadata=doc.get("metadata", {}),
+            )
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/gcs_directory.py b/llm/Lib/site-packages/langchain_community/document_loaders/gcs_directory.py
new file mode 100644
index 0000000000000000000000000000000000000000..570afd0a1c675b50d933c294f6a98517b88cd2a9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/gcs_directory.py
@@ -0,0 +1,83 @@
+import logging
+from typing import Callable, List, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.gcs_file import GCSFileLoader
+from langchain_community.utilities.vertexai import get_client_info
+
+logger = logging.getLogger(__name__)
+
+
+@deprecated(
+    since="0.0.32",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.GCSDirectoryLoader",
+)
+class GCSDirectoryLoader(BaseLoader):
+    """Load from GCS directory."""
+
+    def __init__(
+        self,
+        project_name: str,
+        bucket: str,
+        prefix: str = "",
+        loader_func: Optional[Callable[[str], BaseLoader]] = None,
+        continue_on_failure: bool = False,
+    ):
+        """Initialize with bucket and key name.
+
+        Args:
+            project_name: The ID of the project for the GCS bucket.
+            bucket: The name of the GCS bucket.
+            prefix: The prefix of the GCS bucket.
+            loader_func: A loader function that instantiates a loader based on a
+                file_path argument. If nothing is provided, the  GCSFileLoader
+                would use its default loader.
+            continue_on_failure: To use try-except block for each file within the GCS
+                directory. If set to `True`, then failure to process a file will not
+                cause an error.
+        """
+        self.project_name = project_name
+        self.bucket = bucket
+        self.prefix = prefix
+        self._loader_func = loader_func
+        self.continue_on_failure = continue_on_failure
+
+    def load(self) -> List[Document]:
+        """Load documents."""
+        try:
+            from google.cloud import storage
+        except ImportError:
+            raise ImportError(
+                "Could not import google-cloud-storage python package. "
+                "Please install it with `pip install google-cloud-storage`."
+            )
+        client = storage.Client(
+            project=self.project_name,
+            client_info=get_client_info(module="google-cloud-storage"),
+        )
+        docs = []
+        for blob in client.list_blobs(self.bucket, prefix=self.prefix):
+            # we shall just skip directories since GCSFileLoader creates
+            # intermediate directories on the fly
+            if blob.name.endswith("/"):
+                continue
+            # Use the try-except block here
+            try:
+                loader = GCSFileLoader(
+                    self.project_name,
+                    self.bucket,
+                    blob.name,
+                    loader_func=self._loader_func,
+                )
+                docs.extend(loader.load())
+            except Exception as e:
+                if self.continue_on_failure:
+                    logger.warning(f"Problem processing blob {blob.name}, message: {e}")
+                    continue
+                else:
+                    raise e
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/gcs_file.py b/llm/Lib/site-packages/langchain_community/document_loaders/gcs_file.py
new file mode 100644
index 0000000000000000000000000000000000000000..26993f61258682057913f06a8bc93bac8d349817
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/gcs_file.py
@@ -0,0 +1,89 @@
+import os
+import tempfile
+from typing import Callable, List, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.unstructured import UnstructuredFileLoader
+from langchain_community.utilities.vertexai import get_client_info
+
+
+@deprecated(
+    since="0.0.32",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.GCSFileLoader",
+)
+class GCSFileLoader(BaseLoader):
+    """Load from GCS file."""
+
+    def __init__(
+        self,
+        project_name: str,
+        bucket: str,
+        blob: str,
+        loader_func: Optional[Callable[[str], BaseLoader]] = None,
+    ):
+        """Initialize with bucket and key name.
+
+        Args:
+            project_name: The name of the project to load
+            bucket: The name of the GCS bucket.
+            blob: The name of the GCS blob to load.
+            loader_func: A loader function that instantiates a loader based on a
+                file_path argument. If nothing is provided, the
+                UnstructuredFileLoader is used.
+
+        Examples:
+            To use an alternative PDF loader:
+            >> from from langchain_community.document_loaders import PyPDFLoader
+            >> loader = GCSFileLoader(..., loader_func=PyPDFLoader)
+
+            To use UnstructuredFileLoader with additional arguments:
+            >> loader = GCSFileLoader(...,
+            >>      loader_func=lambda x: UnstructuredFileLoader(x, mode="elements"))
+
+        """
+        self.bucket = bucket
+        self.blob = blob
+        self.project_name = project_name
+
+        def default_loader_func(file_path: str) -> BaseLoader:
+            return UnstructuredFileLoader(file_path)
+
+        self._loader_func = loader_func if loader_func else default_loader_func
+
+    def load(self) -> List[Document]:
+        """Load documents."""
+        try:
+            from google.cloud import storage
+        except ImportError:
+            raise ImportError(
+                "Could not import google-cloud-storage python package. "
+                "Please install it with `pip install google-cloud-storage`."
+            )
+
+        # initialize a client
+        storage_client = storage.Client(
+            self.project_name, client_info=get_client_info("google-cloud-storage")
+        )
+        # Create a bucket object for our bucket
+        bucket = storage_client.get_bucket(self.bucket)
+        # Create a blob object from the filepath
+        blob = bucket.blob(self.blob)
+        # retrieve custom metadata associated with the blob
+        metadata = bucket.get_blob(self.blob).metadata
+        with tempfile.TemporaryDirectory() as temp_dir:
+            file_path = f"{temp_dir}/{self.blob}"
+            os.makedirs(os.path.dirname(file_path), exist_ok=True)
+            # Download the file to a destination
+            blob.download_to_filename(file_path)
+            loader = self._loader_func(file_path)
+            docs = loader.load()
+            for doc in docs:
+                if "source" in doc.metadata:
+                    doc.metadata["source"] = f"gs://{self.bucket}/{self.blob}"
+                if metadata:
+                    doc.metadata.update(metadata)
+            return docs
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/generic.py b/llm/Lib/site-packages/langchain_community/document_loaders/generic.py
new file mode 100644
index 0000000000000000000000000000000000000000..49b0c9eb2eae332ca5445ca520ee51bd538de006
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/generic.py
@@ -0,0 +1,186 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Iterator,
+    List,
+    Literal,
+    Optional,
+    Sequence,
+    Union,
+)
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseBlobParser, BaseLoader
+from langchain_community.document_loaders.blob_loaders import (
+    BlobLoader,
+    FileSystemBlobLoader,
+)
+from langchain_community.document_loaders.parsers.registry import get_parser
+
+if TYPE_CHECKING:
+    from langchain_text_splitters import TextSplitter
+
+_PathLike = Union[str, Path]
+
+DEFAULT = Literal["default"]
+
+
+class GenericLoader(BaseLoader):
+    """Generic Document Loader.
+
+    A generic document loader that allows combining an arbitrary blob loader with
+    a blob parser.
+
+    Examples:
+
+        Parse a specific PDF file:
+
+        .. code-block:: python
+
+            from langchain_community.document_loaders import GenericLoader
+            from langchain_community.document_loaders.parsers.pdf import PyPDFParser
+
+            # Recursively load all text files in a directory.
+            loader = GenericLoader.from_filesystem(
+                "my_lovely_pdf.pdf",
+                parser=PyPDFParser()
+            )
+
+       .. code-block:: python
+
+            from langchain_community.document_loaders import GenericLoader
+            from langchain_community.document_loaders.blob_loaders import FileSystemBlobLoader
+
+
+            loader = GenericLoader.from_filesystem(
+                path="path/to/directory",
+                glob="**/[!.]*",
+                suffixes=[".pdf"],
+                show_progress=True,
+            )
+
+            docs = loader.lazy_load()
+            next(docs)
+
+    Example instantiations to change which files are loaded:
+
+    .. code-block:: python
+
+        # Recursively load all text files in a directory.
+        loader = GenericLoader.from_filesystem("/path/to/dir", glob="**/*.txt")
+
+        # Recursively load all non-hidden files in a directory.
+        loader = GenericLoader.from_filesystem("/path/to/dir", glob="**/[!.]*")
+
+        # Load all files in a directory without recursion.
+        loader = GenericLoader.from_filesystem("/path/to/dir", glob="*")
+
+    Example instantiations to change which parser is used:
+
+    .. code-block:: python
+
+        from langchain_community.document_loaders.parsers.pdf import PyPDFParser
+
+        # Recursively load all text files in a directory.
+        loader = GenericLoader.from_filesystem(
+            "/path/to/dir",
+            glob="**/*.pdf",
+            parser=PyPDFParser()
+        )
+
+    """  # noqa: E501
+
+    def __init__(
+        self,
+        blob_loader: BlobLoader,  # type: ignore[valid-type]
+        blob_parser: BaseBlobParser,
+    ) -> None:
+        """A generic document loader.
+
+        Args:
+            blob_loader: A blob loader which knows how to yield blobs
+            blob_parser: A blob parser which knows how to parse blobs into documents
+        """
+        self.blob_loader = blob_loader
+        self.blob_parser = blob_parser
+
+    def lazy_load(
+        self,
+    ) -> Iterator[Document]:
+        """Load documents lazily. Use this when working at a large scale."""
+        for blob in self.blob_loader.yield_blobs():  # type: ignore[attr-defined]
+            yield from self.blob_parser.lazy_parse(blob)
+
+    def load_and_split(
+        self, text_splitter: Optional[TextSplitter] = None
+    ) -> List[Document]:
+        """Load all documents and split them into sentences."""
+        raise NotImplementedError(
+            "Loading and splitting is not yet implemented for generic loaders. "
+            "When they will be implemented they will be added via the initializer. "
+            "This method should not be used going forward."
+        )
+
+    @classmethod
+    def from_filesystem(
+        cls,
+        path: _PathLike,
+        *,
+        glob: str = "**/[!.]*",
+        exclude: Sequence[str] = (),
+        suffixes: Optional[Sequence[str]] = None,
+        show_progress: bool = False,
+        parser: Union[DEFAULT, BaseBlobParser] = "default",
+        parser_kwargs: Optional[dict] = None,
+    ) -> GenericLoader:
+        """Create a generic document loader using a filesystem blob loader.
+
+        Args:
+            path: The path to the directory to load documents from OR the path to a
+                  single file to load. If this is a file, glob, exclude, suffixes
+                    will be ignored.
+            glob: The glob pattern to use to find documents.
+            suffixes: The suffixes to use to filter documents. If None, all files
+                      matching the glob will be loaded.
+            exclude: A list of patterns to exclude from the loader.
+            show_progress: Whether to show a progress bar or not (requires tqdm).
+                           Proxies to the file system loader.
+            parser: A blob parser which knows how to parse blobs into documents,
+                    will instantiate a default parser if not provided.
+                    The default can be overridden by either passing a parser or
+                    setting the class attribute `blob_parser` (the latter
+                    should be used with inheritance).
+            parser_kwargs: Keyword arguments to pass to the parser.
+
+        Returns:
+            A generic document loader.
+        """
+        blob_loader = FileSystemBlobLoader(  # type: ignore[attr-defined, misc]
+            path,
+            glob=glob,
+            exclude=exclude,
+            suffixes=suffixes,
+            show_progress=show_progress,
+        )
+        if isinstance(parser, str):
+            if parser == "default":
+                try:
+                    # If there is an implementation of get_parser on the class, use it.
+                    blob_parser = cls.get_parser(**(parser_kwargs or {}))
+                except NotImplementedError:
+                    # if not then use the global registry.
+                    blob_parser = get_parser(parser)
+            else:
+                blob_parser = get_parser(parser)
+        else:
+            blob_parser = parser
+        return cls(blob_loader, blob_parser)
+
+    @staticmethod
+    def get_parser(**kwargs: Any) -> BaseBlobParser:
+        """Override this method to associate a default parser with the class."""
+        raise NotImplementedError()
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/geodataframe.py b/llm/Lib/site-packages/langchain_community/document_loaders/geodataframe.py
new file mode 100644
index 0000000000000000000000000000000000000000..3f867fef233f0e1dd1ace9f47069158d30537139
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/geodataframe.py
@@ -0,0 +1,69 @@
+from typing import Any, Iterator
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class GeoDataFrameLoader(BaseLoader):
+    """Load `geopandas` Dataframe."""
+
+    def __init__(self, data_frame: Any, page_content_column: str = "geometry"):
+        """Initialize with geopandas Dataframe.
+
+        Args:
+            data_frame: geopandas DataFrame object.
+            page_content_column: Name of the column containing the page content.
+              Defaults to "geometry".
+        """
+
+        try:
+            import geopandas as gpd
+        except ImportError:
+            raise ImportError(
+                "geopandas package not found, please install it with "
+                "`pip install geopandas`"
+            )
+
+        if not isinstance(data_frame, gpd.GeoDataFrame):
+            raise ValueError(
+                f"Expected data_frame to be a gpd.GeoDataFrame, got {type(data_frame)}"
+            )
+
+        if page_content_column not in data_frame.columns:
+            raise ValueError(
+                f"Expected data_frame to have a column named {page_content_column}"
+            )
+
+        if not isinstance(data_frame[page_content_column], gpd.GeoSeries):
+            raise ValueError(
+                f"Expected data_frame[{page_content_column}] to be a GeoSeries"
+            )
+
+        self.data_frame = data_frame
+        self.page_content_column = page_content_column
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Lazy load records from dataframe."""
+
+        # assumes all geometries in GeoSeries are same CRS and Geom Type
+        crs_str = self.data_frame.crs.to_string() if self.data_frame.crs else None
+        geometry_type = self.data_frame.geometry.geom_type.iloc[0]
+
+        for _, row in self.data_frame.iterrows():
+            geom = row[self.page_content_column]
+
+            xmin, ymin, xmax, ymax = geom.bounds
+
+            metadata = row.to_dict()
+            metadata["crs"] = crs_str
+            metadata["geometry_type"] = geometry_type
+            metadata["xmin"] = xmin
+            metadata["ymin"] = ymin
+            metadata["xmax"] = xmax
+            metadata["ymax"] = ymax
+
+            metadata.pop(self.page_content_column)
+
+            # using WKT instead of str() to help GIS system interoperability
+            yield Document(page_content=geom.wkt, metadata=metadata)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/git.py b/llm/Lib/site-packages/langchain_community/document_loaders/git.py
new file mode 100644
index 0000000000000000000000000000000000000000..b37f575eacbb8fc64e48f75ae14dd6b10da8410e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/git.py
@@ -0,0 +1,105 @@
+import os
+from typing import Callable, Iterator, Optional
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class GitLoader(BaseLoader):
+    """Load `Git` repository files.
+
+    The Repository can be local on disk available at `repo_path`,
+    or remote at `clone_url` that will be cloned to `repo_path`.
+    Currently, supports only text files.
+
+    Each document represents one file in the repository. The `path` points to
+    the local Git repository, and the `branch` specifies the branch to load
+    files from. By default, it loads from the `main` branch.
+    """
+
+    def __init__(
+        self,
+        repo_path: str,
+        clone_url: Optional[str] = None,
+        branch: Optional[str] = "main",
+        file_filter: Optional[Callable[[str], bool]] = None,
+    ):
+        """
+
+        Args:
+            repo_path: The path to the Git repository.
+            clone_url: Optional. The URL to clone the repository from.
+            branch: Optional. The branch to load files from. Defaults to `main`.
+            file_filter: Optional. A function that takes a file path and returns
+              a boolean indicating whether to load the file. Defaults to None.
+        """
+        self.repo_path = repo_path
+        self.clone_url = clone_url
+        self.branch = branch
+        self.file_filter = file_filter
+
+    def lazy_load(self) -> Iterator[Document]:
+        try:
+            from git import Blob, Repo
+        except ImportError as ex:
+            raise ImportError(
+                "Could not import git python package. "
+                "Please install it with `pip install GitPython`."
+            ) from ex
+
+        if not os.path.exists(self.repo_path) and self.clone_url is None:
+            raise ValueError(f"Path {self.repo_path} does not exist")
+        elif self.clone_url:
+            # If the repo_path already contains a git repository, verify that it's the
+            # same repository as the one we're trying to clone.
+            if os.path.isdir(os.path.join(self.repo_path, ".git")):
+                repo = Repo(self.repo_path)
+                # If the existing repository is not the same as the one we're trying to
+                # clone, raise an error.
+                if repo.remotes.origin.url != self.clone_url:
+                    raise ValueError(
+                        "A different repository is already cloned at this path."
+                    )
+            else:
+                repo = Repo.clone_from(self.clone_url, self.repo_path)
+            repo.git.checkout(self.branch)
+        else:
+            repo = Repo(self.repo_path)
+            repo.git.checkout(self.branch)
+
+        for item in repo.tree().traverse():
+            if not isinstance(item, Blob):
+                continue
+
+            file_path = os.path.join(self.repo_path, item.path)
+
+            ignored_files = repo.ignored([file_path])
+            if len(ignored_files):
+                continue
+
+            # uses filter to skip files
+            if self.file_filter and not self.file_filter(file_path):
+                continue
+
+            rel_file_path = os.path.relpath(file_path, self.repo_path)
+            try:
+                with open(file_path, "rb") as f:
+                    content = f.read()
+                    file_type = os.path.splitext(item.name)[1]
+
+                    # loads only text files
+                    try:
+                        text_content = content.decode("utf-8")
+                    except UnicodeDecodeError:
+                        continue
+
+                    metadata = {
+                        "source": rel_file_path,
+                        "file_path": rel_file_path,
+                        "file_name": item.name,
+                        "file_type": file_type,
+                    }
+                    yield Document(page_content=text_content, metadata=metadata)
+            except Exception as e:
+                print(f"Error reading file {file_path}: {e}")  # noqa: T201
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/gitbook.py b/llm/Lib/site-packages/langchain_community/document_loaders/gitbook.py
new file mode 100644
index 0000000000000000000000000000000000000000..8fdf73708967b33daffb5022f7818b0966bf8b73
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/gitbook.py
@@ -0,0 +1,83 @@
+from typing import Any, Iterator, List, Optional
+from urllib.parse import urljoin, urlparse
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.web_base import WebBaseLoader
+
+
+class GitbookLoader(WebBaseLoader):
+    """Load `GitBook` data.
+
+    1. load from either a single page, or
+    2. load all (relative) paths in the navbar.
+    """
+
+    def __init__(
+        self,
+        web_page: str,
+        load_all_paths: bool = False,
+        base_url: Optional[str] = None,
+        content_selector: str = "main",
+        continue_on_failure: bool = False,
+    ):
+        """Initialize with web page and whether to load all paths.
+
+        Args:
+            web_page: The web page to load or the starting point from where
+                relative paths are discovered.
+            load_all_paths: If set to True, all relative paths in the navbar
+                are loaded instead of only `web_page`.
+            base_url: If `load_all_paths` is True, the relative paths are
+                appended to this base url. Defaults to `web_page`.
+            content_selector: The CSS selector for the content to load.
+                Defaults to "main".
+            continue_on_failure: whether to continue loading the sitemap if an error
+                occurs loading a url, emitting a warning instead of raising an
+                exception. Setting this to True makes the loader more robust, but also
+                may result in missing data. Default: False
+        """
+        self.base_url = base_url or web_page
+        if self.base_url.endswith("/"):
+            self.base_url = self.base_url[:-1]
+        if load_all_paths:
+            # set web_path to the sitemap if we want to crawl all paths
+            web_page = f"{self.base_url}/sitemap.xml"
+        super().__init__(web_paths=(web_page,), continue_on_failure=continue_on_failure)
+        self.load_all_paths = load_all_paths
+        self.content_selector = content_selector
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Fetch text from one single GitBook page."""
+        if self.load_all_paths:
+            soup_info = self.scrape()
+            relative_paths = self._get_paths(soup_info)
+            urls = [urljoin(self.base_url, path) for path in relative_paths]
+            soup_infos = self.scrape_all(urls)
+            for soup_info, url in zip(soup_infos, urls):
+                doc = self._get_document(soup_info, url)
+                if doc:
+                    yield doc
+
+        else:
+            soup_info = self.scrape()
+            doc = self._get_document(soup_info, self.web_path)
+            if doc:
+                yield doc
+
+    def _get_document(
+        self, soup: Any, custom_url: Optional[str] = None
+    ) -> Optional[Document]:
+        """Fetch content from page and return Document."""
+        page_content_raw = soup.find(self.content_selector)
+        if not page_content_raw:
+            return None
+        content = page_content_raw.get_text(separator="\n").strip()
+        title_if_exists = page_content_raw.find("h1")
+        title = title_if_exists.text if title_if_exists else ""
+        metadata = {"source": custom_url or self.web_path, "title": title}
+        return Document(page_content=content, metadata=metadata)
+
+    def _get_paths(self, soup: Any) -> List[str]:
+        """Fetch all relative paths in the navbar."""
+        return [urlparse(loc.text).path for loc in soup.find_all("loc")]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/github.py b/llm/Lib/site-packages/langchain_community/document_loaders/github.py
new file mode 100644
index 0000000000000000000000000000000000000000..e2d4e0fb9278b0d21c8eb3741192a22f4be0f35e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/github.py
@@ -0,0 +1,233 @@
+import base64
+from abc import ABC
+from datetime import datetime
+from typing import Callable, Dict, Iterator, List, Literal, Optional, Union
+
+import requests
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, root_validator, validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class BaseGitHubLoader(BaseLoader, BaseModel, ABC):
+    """Load `GitHub` repository Issues."""
+
+    repo: str
+    """Name of repository"""
+    access_token: str
+    """Personal access token - see https://github.com/settings/tokens?type=beta"""
+    github_api_url: str = "https://api.github.com"
+    """URL of GitHub API"""
+
+    @root_validator(pre=True, allow_reuse=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that access token exists in environment."""
+        values["access_token"] = get_from_dict_or_env(
+            values, "access_token", "GITHUB_PERSONAL_ACCESS_TOKEN"
+        )
+        return values
+
+    @property
+    def headers(self) -> Dict[str, str]:
+        return {
+            "Accept": "application/vnd.github+json",
+            "Authorization": f"Bearer {self.access_token}",
+        }
+
+
+class GitHubIssuesLoader(BaseGitHubLoader):
+    """Load issues of a GitHub repository."""
+
+    include_prs: bool = True
+    """If True include Pull Requests in results, otherwise ignore them."""
+    milestone: Union[int, Literal["*", "none"], None] = None
+    """If integer is passed, it should be a milestone's number field.
+        If the string '*' is passed, issues with any milestone are accepted.
+        If the string 'none' is passed, issues without milestones are returned.
+    """
+    state: Optional[Literal["open", "closed", "all"]] = None
+    """Filter on issue state. Can be one of: 'open', 'closed', 'all'."""
+    assignee: Optional[str] = None
+    """Filter on assigned user. Pass 'none' for no user and '*' for any user."""
+    creator: Optional[str] = None
+    """Filter on the user that created the issue."""
+    mentioned: Optional[str] = None
+    """Filter on a user that's mentioned in the issue."""
+    labels: Optional[List[str]] = None
+    """Label names to filter one. Example: bug,ui,@high."""
+    sort: Optional[Literal["created", "updated", "comments"]] = None
+    """What to sort results by. Can be one of: 'created', 'updated', 'comments'.
+        Default is 'created'."""
+    direction: Optional[Literal["asc", "desc"]] = None
+    """The direction to sort the results by. Can be one of: 'asc', 'desc'."""
+    since: Optional[str] = None
+    """Only show notifications updated after the given time.
+        This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ."""
+    page: Optional[int] = None
+    """The page number for paginated results. 
+        Defaults to 1 in the GitHub API."""
+    per_page: Optional[int] = None
+    """Number of items per page. 
+        Defaults to 30 in the GitHub API."""
+
+    @validator("since", allow_reuse=True)
+    def validate_since(cls, v: Optional[str]) -> Optional[str]:
+        if v:
+            try:
+                datetime.strptime(v, "%Y-%m-%dT%H:%M:%SZ")
+            except ValueError:
+                raise ValueError(
+                    "Invalid value for 'since'. Expected a date string in "
+                    f"YYYY-MM-DDTHH:MM:SSZ format. Received: {v}"
+                )
+        return v
+
+    def lazy_load(self) -> Iterator[Document]:
+        """
+        Get issues of a GitHub repository.
+
+        Returns:
+            A list of Documents with attributes:
+                - page_content
+                - metadata
+                    - url
+                    - title
+                    - creator
+                    - created_at
+                    - last_update_time
+                    - closed_time
+                    - number of comments
+                    - state
+                    - labels
+                    - assignee
+                    - assignees
+                    - milestone
+                    - locked
+                    - number
+                    - is_pull_request
+        """
+        url: Optional[str] = self.url
+        while url:
+            response = requests.get(url, headers=self.headers)
+            response.raise_for_status()
+            issues = response.json()
+            for issue in issues:
+                doc = self.parse_issue(issue)
+                if not self.include_prs and doc.metadata["is_pull_request"]:
+                    continue
+                yield doc
+            if (
+                response.links
+                and response.links.get("next")
+                and (not self.page and not self.per_page)
+            ):
+                url = response.links["next"]["url"]
+            else:
+                url = None
+
+    def parse_issue(self, issue: dict) -> Document:
+        """Create Document objects from a list of GitHub issues."""
+        metadata = {
+            "url": issue["html_url"],
+            "title": issue["title"],
+            "creator": issue["user"]["login"],
+            "created_at": issue["created_at"],
+            "comments": issue["comments"],
+            "state": issue["state"],
+            "labels": [label["name"] for label in issue["labels"]],
+            "assignee": issue["assignee"]["login"] if issue["assignee"] else None,
+            "milestone": issue["milestone"]["title"] if issue["milestone"] else None,
+            "locked": issue["locked"],
+            "number": issue["number"],
+            "is_pull_request": "pull_request" in issue,
+        }
+        content = issue["body"] if issue["body"] is not None else ""
+        return Document(page_content=content, metadata=metadata)
+
+    @property
+    def query_params(self) -> str:
+        """Create query parameters for GitHub API."""
+        labels = ",".join(self.labels) if self.labels else self.labels
+        query_params_dict = {
+            "milestone": self.milestone,
+            "state": self.state,
+            "assignee": self.assignee,
+            "creator": self.creator,
+            "mentioned": self.mentioned,
+            "labels": labels,
+            "sort": self.sort,
+            "direction": self.direction,
+            "since": self.since,
+            "page": self.page,
+            "per_page": self.per_page,
+        }
+        query_params_list = [
+            f"{k}={v}" for k, v in query_params_dict.items() if v is not None
+        ]
+        query_params = "&".join(query_params_list)
+        return query_params
+
+    @property
+    def url(self) -> str:
+        """Create URL for GitHub API."""
+        return f"{self.github_api_url}/repos/{self.repo}/issues?{self.query_params}"
+
+
+class GithubFileLoader(BaseGitHubLoader, ABC):
+    """Load GitHub File"""
+
+    file_extension: str = ".md"
+    branch: str = "main"
+
+    file_filter: Optional[Callable[[str], bool]]
+
+    def get_file_paths(self) -> List[Dict]:
+        base_url = (
+            f"{self.github_api_url}/repos/{self.repo}/git/trees/"
+            f"{self.branch}?recursive=1"
+        )
+        response = requests.get(base_url, headers=self.headers)
+        response.raise_for_status()
+        all_files = response.json()["tree"]
+        """ one element in all_files
+        {
+            'path': '.github', 
+            'mode': '040000', 
+            'type': 'tree', 
+            'sha': '5dc46e6b38b22707894ced126270b15e2f22f64e', 
+            'url': 'https://api.github.com/repos/langchain-ai/langchain/git/blobs/5dc46e6b38b22707894ced126270b15e2f22f64e'
+        }
+        """
+        return [
+            f
+            for f in all_files
+            if not (self.file_filter and not self.file_filter(f["path"]))
+        ]
+
+    def get_file_content_by_path(self, path: str) -> str:
+        base_url = f"{self.github_api_url}/repos/{self.repo}/contents/{path}"
+        response = requests.get(base_url, headers=self.headers)
+        response.raise_for_status()
+
+        if isinstance(response.json(), dict):
+            content_encoded = response.json()["content"]
+            return base64.b64decode(content_encoded).decode("utf-8")
+
+        return ""
+
+    def lazy_load(self) -> Iterator[Document]:
+        files = self.get_file_paths()
+        for file in files:
+            content = self.get_file_content_by_path(file["path"])
+            if content == "":
+                continue
+
+            metadata = {
+                "path": file["path"],
+                "sha": file["sha"],
+                "source": f"{self.github_api_url}/{self.repo}/{file['type']}/"
+                f"{self.branch}/{file['path']}",
+            }
+            yield Document(page_content=content, metadata=metadata)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/glue_catalog.py b/llm/Lib/site-packages/langchain_community/document_loaders/glue_catalog.py
new file mode 100644
index 0000000000000000000000000000000000000000..657dbe60ce6aa521978fb2432ad542a89d8d49be
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/glue_catalog.py
@@ -0,0 +1,126 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, Iterator, List, Optional
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+if TYPE_CHECKING:
+    from boto3.session import Session
+
+
+class GlueCatalogLoader(BaseLoader):
+    """Load table schemas from AWS Glue.
+
+    This loader fetches the schema of each table within a specified AWS Glue database.
+    The schema details include column names and their data types, similar to pandas
+    dtype representation.
+
+    AWS credentials are automatically loaded using boto3, following the standard AWS
+    method:
+    https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html
+
+    If a specific AWS profile is required, it can be specified and will be used to
+    establish the session.
+    """
+
+    def __init__(
+        self,
+        database: str,
+        *,
+        session: Optional[Session] = None,
+        profile_name: Optional[str] = None,
+        table_filter: Optional[List[str]] = None,
+    ):
+        """Initialize Glue database loader.
+
+        Args:
+            database: The name of the Glue database from which to load table schemas.
+            session: Optional. A boto3 Session object. If not provided, a new
+                session will be created.
+            profile_name: Optional. The name of the AWS profile to use for credentials.
+            table_filter: Optional. List of table names to fetch schemas for,
+                fetching all if None.
+        """
+        self.database = database
+        self.profile_name = profile_name
+        self.table_filter = table_filter
+        if session:
+            self.glue_client = session.client("glue")
+        else:
+            self.glue_client = self._initialize_glue_client()
+
+    def _initialize_glue_client(self) -> Any:
+        """Initialize the AWS Glue client.
+
+        Returns:
+            The initialized AWS Glue client.
+
+        Raises:
+            ValueError: If there is an issue with AWS session/client initialization.
+        """
+        try:
+            import boto3
+        except ImportError as e:
+            raise ImportError(
+                "boto3 is required to use the GlueCatalogLoader. "
+                "Please install it with `pip install boto3`."
+            ) from e
+
+        try:
+            session = (
+                boto3.Session(profile_name=self.profile_name)
+                if self.profile_name
+                else boto3.Session()
+            )
+            return session.client("glue")
+        except Exception as e:
+            raise ValueError("Issue with AWS session/client initialization.") from e
+
+    def _fetch_tables(self) -> List[str]:
+        """Retrieve all table names in the specified Glue database.
+
+        Returns:
+            A list of table names.
+        """
+        paginator = self.glue_client.get_paginator("get_tables")
+        table_names = []
+        for page in paginator.paginate(DatabaseName=self.database):
+            for table in page["TableList"]:
+                if self.table_filter is None or table["Name"] in self.table_filter:
+                    table_names.append(table["Name"])
+        return table_names
+
+    def _fetch_table_schema(self, table_name: str) -> Dict[str, str]:
+        """Fetch the schema of a specified table.
+
+        Args:
+            table_name: The name of the table for which to fetch the schema.
+
+        Returns:
+            A dictionary mapping column names to their data types.
+        """
+        response = self.glue_client.get_table(
+            DatabaseName=self.database, Name=table_name
+        )
+        columns = response["Table"]["StorageDescriptor"]["Columns"]
+        return {col["Name"]: col["Type"] for col in columns}
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Lazily load table schemas as Document objects.
+
+        Yields:
+            Document objects, each representing the schema of a table.
+        """
+        table_names = self._fetch_tables()
+        for table_name in table_names:
+            schema = self._fetch_table_schema(table_name)
+            page_content = (
+                f"Database: {self.database}\nTable: {table_name}\nSchema:\n"
+                + "\n".join(f"{col}: {dtype}" for col, dtype in schema.items())
+            )
+            doc = Document(
+                page_content=page_content, metadata={"table_name": table_name}
+            )
+            yield doc
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/google_speech_to_text.py b/llm/Lib/site-packages/langchain_community/document_loaders/google_speech_to_text.py
new file mode 100644
index 0000000000000000000000000000000000000000..c90e1e7a02b739981dc28fa7625193b0c9e83822
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/google_speech_to_text.py
@@ -0,0 +1,143 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.utilities.vertexai import get_client_info
+
+if TYPE_CHECKING:
+    from google.cloud.speech_v2 import RecognitionConfig
+    from google.protobuf.field_mask_pb2 import FieldMask
+
+
+@deprecated(
+    since="0.0.32",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.SpeechToTextLoader",
+)
+class GoogleSpeechToTextLoader(BaseLoader):
+    """
+    Loader for Google Cloud Speech-to-Text audio transcripts.
+
+    It uses the Google Cloud Speech-to-Text API to transcribe audio files
+    and loads the transcribed text into one or more Documents,
+    depending on the specified format.
+
+    To use, you should have the ``google-cloud-speech`` python package installed.
+
+    Audio files can be specified via a Google Cloud Storage uri or a local file path.
+
+    For a detailed explanation of Google Cloud Speech-to-Text, refer to the product
+    documentation.
+    https://cloud.google.com/speech-to-text
+    """
+
+    def __init__(
+        self,
+        project_id: str,
+        file_path: str,
+        location: str = "us-central1",
+        recognizer_id: str = "_",
+        config: Optional[RecognitionConfig] = None,
+        config_mask: Optional[FieldMask] = None,
+    ):
+        """
+        Initializes the GoogleSpeechToTextLoader.
+
+        Args:
+            project_id: Google Cloud Project ID.
+            file_path: A Google Cloud Storage URI or a local file path.
+            location: Speech-to-Text recognizer location.
+            recognizer_id: Speech-to-Text recognizer id.
+            config: Recognition options and features.
+                For more information:
+                https://cloud.google.com/python/docs/reference/speech/latest/google.cloud.speech_v2.types.RecognitionConfig
+            config_mask: The list of fields in config that override the values in the
+                ``default_recognition_config`` of the recognizer during this
+                recognition request.
+                For more information:
+                https://cloud.google.com/python/docs/reference/speech/latest/google.cloud.speech_v2.types.RecognizeRequest
+        """
+        try:
+            from google.api_core.client_options import ClientOptions
+            from google.cloud.speech_v2 import (
+                AutoDetectDecodingConfig,
+                RecognitionConfig,
+                RecognitionFeatures,
+                SpeechClient,
+            )
+        except ImportError as exc:
+            raise ImportError(
+                "Could not import google-cloud-speech python package. "
+                "Please install it with `pip install google-cloud-speech`."
+            ) from exc
+
+        self.project_id = project_id
+        self.file_path = file_path
+        self.location = location
+        self.recognizer_id = recognizer_id
+        # Config must be set in speech recognition request.
+        self.config = config or RecognitionConfig(
+            auto_decoding_config=AutoDetectDecodingConfig(),
+            language_codes=["en-US"],
+            model="chirp",
+            features=RecognitionFeatures(
+                # Automatic punctuation could be useful for language applications
+                enable_automatic_punctuation=True,
+            ),
+        )
+        self.config_mask = config_mask
+
+        self._client = SpeechClient(
+            client_info=get_client_info(module="speech-to-text"),
+            client_options=(
+                ClientOptions(api_endpoint=f"{location}-speech.googleapis.com")
+                if location != "global"
+                else None
+            ),
+        )
+        self._recognizer_path = self._client.recognizer_path(
+            project_id, location, recognizer_id
+        )
+
+    def load(self) -> List[Document]:
+        """Transcribes the audio file and loads the transcript into documents.
+
+        It uses the Google Cloud Speech-to-Text API to transcribe the audio file
+        and blocks until the transcription is finished.
+        """
+        try:
+            from google.cloud.speech_v2 import RecognizeRequest
+        except ImportError as exc:
+            raise ImportError(
+                "Could not import google-cloud-speech python package. "
+                "Please install it with `pip install google-cloud-speech`."
+            ) from exc
+
+        request = RecognizeRequest(
+            recognizer=self._recognizer_path,
+            config=self.config,
+            config_mask=self.config_mask,
+        )
+
+        if "gs://" in self.file_path:
+            request.uri = self.file_path
+        else:
+            with open(self.file_path, "rb") as f:
+                request.content = f.read()
+
+        response = self._client.recognize(request=request)
+
+        return [
+            Document(
+                page_content=result.alternatives[0].transcript,
+                metadata={
+                    "language_code": result.language_code,
+                    "result_end_offset": result.result_end_offset,
+                },
+            )
+            for result in response.results
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/googledrive.py b/llm/Lib/site-packages/langchain_community/document_loaders/googledrive.py
new file mode 100644
index 0000000000000000000000000000000000000000..581c4285b296ce1b17e097f842476f33ce34cf3d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/googledrive.py
@@ -0,0 +1,366 @@
+# Prerequisites:
+# 1. Create a Google Cloud project
+# 2. Enable the Google Drive API:
+#   https://console.cloud.google.com/flows/enableapi?apiid=drive.googleapis.com
+# 3. Authorize credentials for desktop app:
+#   https://developers.google.com/drive/api/quickstart/python#authorize_credentials_for_a_desktop_application # noqa: E501
+# 4. For service accounts visit
+#   https://cloud.google.com/iam/docs/service-accounts-create
+
+import os
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Sequence, Union
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, root_validator, validator
+
+from langchain_community.document_loaders.base import BaseLoader
+
+SCOPES = ["https://www.googleapis.com/auth/drive.readonly"]
+
+
+@deprecated(
+    since="0.0.32",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.GoogleDriveLoader",
+)
+class GoogleDriveLoader(BaseLoader, BaseModel):
+    """Load Google Docs from `Google Drive`."""
+
+    service_account_key: Path = Path.home() / ".credentials" / "keys.json"
+    """Path to the service account key file."""
+    credentials_path: Path = Path.home() / ".credentials" / "credentials.json"
+    """Path to the credentials file."""
+    token_path: Path = Path.home() / ".credentials" / "token.json"
+    """Path to the token file."""
+    folder_id: Optional[str] = None
+    """The folder id to load from."""
+    document_ids: Optional[List[str]] = None
+    """The document ids to load from."""
+    file_ids: Optional[List[str]] = None
+    """The file ids to load from."""
+    recursive: bool = False
+    """Whether to load recursively. Only applies when folder_id is given."""
+    file_types: Optional[Sequence[str]] = None
+    """The file types to load. Only applies when folder_id is given."""
+    load_trashed_files: bool = False
+    """Whether to load trashed files. Only applies when folder_id is given."""
+    # NOTE(MthwRobinson) - changing the file_loader_cls to type here currently
+    # results in pydantic validation errors
+    file_loader_cls: Any = None
+    """The file loader class to use."""
+    file_loader_kwargs: Dict["str", Any] = {}
+    """The file loader kwargs to use."""
+
+    @root_validator
+    def validate_inputs(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Validate that either folder_id or document_ids is set, but not both."""
+        if values.get("folder_id") and (
+            values.get("document_ids") or values.get("file_ids")
+        ):
+            raise ValueError(
+                "Cannot specify both folder_id and document_ids nor "
+                "folder_id and file_ids"
+            )
+        if (
+            not values.get("folder_id")
+            and not values.get("document_ids")
+            and not values.get("file_ids")
+        ):
+            raise ValueError("Must specify either folder_id, document_ids, or file_ids")
+
+        file_types = values.get("file_types")
+        if file_types:
+            if values.get("document_ids") or values.get("file_ids"):
+                raise ValueError(
+                    "file_types can only be given when folder_id is given,"
+                    " (not when document_ids or file_ids are given)."
+                )
+            type_mapping = {
+                "document": "application/vnd.google-apps.document",
+                "sheet": "application/vnd.google-apps.spreadsheet",
+                "pdf": "application/pdf",
+            }
+            allowed_types = list(type_mapping.keys()) + list(type_mapping.values())
+            short_names = ", ".join([f"'{x}'" for x in type_mapping.keys()])
+            full_names = ", ".join([f"'{x}'" for x in type_mapping.values()])
+            for file_type in file_types:
+                if file_type not in allowed_types:
+                    raise ValueError(
+                        f"Given file type {file_type} is not supported. "
+                        f"Supported values are: {short_names}; and "
+                        f"their full-form names: {full_names}"
+                    )
+
+            # replace short-form file types by full-form file types
+            def full_form(x: str) -> str:
+                return type_mapping[x] if x in type_mapping else x
+
+            values["file_types"] = [full_form(file_type) for file_type in file_types]
+        return values
+
+    @validator("credentials_path")
+    def validate_credentials_path(cls, v: Any, **kwargs: Any) -> Any:
+        """Validate that credentials_path exists."""
+        if not v.exists():
+            raise ValueError(f"credentials_path {v} does not exist")
+        return v
+
+    def _load_credentials(self) -> Any:
+        """Load credentials."""
+        # Adapted from https://developers.google.com/drive/api/v3/quickstart/python
+        try:
+            from google.auth import default
+            from google.auth.transport.requests import Request
+            from google.oauth2 import service_account
+            from google.oauth2.credentials import Credentials
+            from google_auth_oauthlib.flow import InstalledAppFlow
+        except ImportError:
+            raise ImportError(
+                "You must run "
+                "`pip install --upgrade "
+                "google-api-python-client google-auth-httplib2 "
+                "google-auth-oauthlib` "
+                "to use the Google Drive loader."
+            )
+
+        creds = None
+        if self.service_account_key.exists():
+            return service_account.Credentials.from_service_account_file(
+                str(self.service_account_key), scopes=SCOPES
+            )
+
+        if self.token_path.exists():
+            creds = Credentials.from_authorized_user_file(str(self.token_path), SCOPES)
+
+        if not creds or not creds.valid:
+            if creds and creds.expired and creds.refresh_token:
+                creds.refresh(Request())
+            elif "GOOGLE_APPLICATION_CREDENTIALS" not in os.environ:
+                creds, project = default()
+                creds = creds.with_scopes(SCOPES)
+                # no need to write to file
+                if creds:
+                    return creds
+            else:
+                flow = InstalledAppFlow.from_client_secrets_file(
+                    str(self.credentials_path), SCOPES
+                )
+                creds = flow.run_local_server(port=0)
+            with open(self.token_path, "w") as token:
+                token.write(creds.to_json())
+
+        return creds
+
+    def _load_sheet_from_id(self, id: str) -> List[Document]:
+        """Load a sheet and all tabs from an ID."""
+
+        from googleapiclient.discovery import build
+
+        creds = self._load_credentials()
+        sheets_service = build("sheets", "v4", credentials=creds)
+        spreadsheet = sheets_service.spreadsheets().get(spreadsheetId=id).execute()
+        sheets = spreadsheet.get("sheets", [])
+
+        documents = []
+        for sheet in sheets:
+            sheet_name = sheet["properties"]["title"]
+            result = (
+                sheets_service.spreadsheets()
+                .values()
+                .get(spreadsheetId=id, range=sheet_name)
+                .execute()
+            )
+            values = result.get("values", [])
+            if not values:
+                continue  # empty sheet
+
+            header = values[0]
+            for i, row in enumerate(values[1:], start=1):
+                metadata = {
+                    "source": (
+                        f"https://docs.google.com/spreadsheets/d/{id}/"
+                        f"edit?gid={sheet['properties']['sheetId']}"
+                    ),
+                    "title": f"{spreadsheet['properties']['title']} - {sheet_name}",
+                    "row": i,
+                }
+                content = []
+                for j, v in enumerate(row):
+                    title = header[j].strip() if len(header) > j else ""
+                    content.append(f"{title}: {v.strip()}")
+
+                page_content = "\n".join(content)
+                documents.append(Document(page_content=page_content, metadata=metadata))
+
+        return documents
+
+    def _load_document_from_id(self, id: str) -> Document:
+        """Load a document from an ID."""
+        from io import BytesIO
+
+        from googleapiclient.discovery import build
+        from googleapiclient.errors import HttpError
+        from googleapiclient.http import MediaIoBaseDownload
+
+        creds = self._load_credentials()
+        service = build("drive", "v3", credentials=creds)
+
+        file = (
+            service.files()
+            .get(fileId=id, supportsAllDrives=True, fields="modifiedTime,name")
+            .execute()
+        )
+        request = service.files().export_media(fileId=id, mimeType="text/plain")
+        fh = BytesIO()
+        downloader = MediaIoBaseDownload(fh, request)
+        done = False
+        try:
+            while done is False:
+                status, done = downloader.next_chunk()
+
+        except HttpError as e:
+            if e.resp.status == 404:
+                print("File not found: {}".format(id))  # noqa: T201
+            else:
+                print("An error occurred: {}".format(e))  # noqa: T201
+
+        text = fh.getvalue().decode("utf-8")
+        metadata = {
+            "source": f"https://docs.google.com/document/d/{id}/edit",
+            "title": f"{file.get('name')}",
+            "when": f"{file.get('modifiedTime')}",
+        }
+        return Document(page_content=text, metadata=metadata)
+
+    def _load_documents_from_folder(
+        self, folder_id: str, *, file_types: Optional[Sequence[str]] = None
+    ) -> List[Document]:
+        """Load documents from a folder."""
+        from googleapiclient.discovery import build
+
+        creds = self._load_credentials()
+        service = build("drive", "v3", credentials=creds)
+        files = self._fetch_files_recursive(service, folder_id)
+        # If file types filter is provided, we'll filter by the file type.
+        if file_types:
+            _files = [f for f in files if f["mimeType"] in file_types]  # type: ignore
+        else:
+            _files = files
+
+        returns = []
+        for file in _files:
+            if file["trashed"] and not self.load_trashed_files:
+                continue
+            elif file["mimeType"] == "application/vnd.google-apps.document":
+                returns.append(self._load_document_from_id(file["id"]))  # type: ignore
+            elif file["mimeType"] == "application/vnd.google-apps.spreadsheet":
+                returns.extend(self._load_sheet_from_id(file["id"]))  # type: ignore
+            elif (
+                file["mimeType"] == "application/pdf"
+                or self.file_loader_cls is not None
+            ):
+                returns.extend(self._load_file_from_id(file["id"]))  # type: ignore
+            else:
+                pass
+        return returns
+
+    def _fetch_files_recursive(
+        self, service: Any, folder_id: str
+    ) -> List[Dict[str, Union[str, List[str]]]]:
+        """Fetch all files and subfolders recursively."""
+        results = (
+            service.files()
+            .list(
+                q=f"'{folder_id}' in parents",
+                pageSize=1000,
+                includeItemsFromAllDrives=True,
+                supportsAllDrives=True,
+                fields="nextPageToken, files(id, name, mimeType, parents, trashed)",
+            )
+            .execute()
+        )
+        files = results.get("files", [])
+        returns = []
+        for file in files:
+            if file["mimeType"] == "application/vnd.google-apps.folder":
+                if self.recursive:
+                    returns.extend(self._fetch_files_recursive(service, file["id"]))
+            else:
+                returns.append(file)
+
+        return returns
+
+    def _load_documents_from_ids(self) -> List[Document]:
+        """Load documents from a list of IDs."""
+        if not self.document_ids:
+            raise ValueError("document_ids must be set")
+
+        return [self._load_document_from_id(doc_id) for doc_id in self.document_ids]
+
+    def _load_file_from_id(self, id: str) -> List[Document]:
+        """Load a file from an ID."""
+        from io import BytesIO
+
+        from googleapiclient.discovery import build
+        from googleapiclient.http import MediaIoBaseDownload
+
+        creds = self._load_credentials()
+        service = build("drive", "v3", credentials=creds)
+
+        file = service.files().get(fileId=id, supportsAllDrives=True).execute()
+        request = service.files().get_media(fileId=id)
+        fh = BytesIO()
+        downloader = MediaIoBaseDownload(fh, request)
+        done = False
+        while done is False:
+            status, done = downloader.next_chunk()
+
+        if self.file_loader_cls is not None:
+            fh.seek(0)
+            loader = self.file_loader_cls(file=fh, **self.file_loader_kwargs)
+            docs = loader.load()
+            for doc in docs:
+                doc.metadata["source"] = f"https://drive.google.com/file/d/{id}/view"
+                if "title" not in doc.metadata:
+                    doc.metadata["title"] = f"{file.get('name')}"
+            return docs
+
+        else:
+            from PyPDF2 import PdfReader
+
+            content = fh.getvalue()
+            pdf_reader = PdfReader(BytesIO(content))
+
+            return [
+                Document(
+                    page_content=page.extract_text(),
+                    metadata={
+                        "source": f"https://drive.google.com/file/d/{id}/view",
+                        "title": f"{file.get('name')}",
+                        "page": i,
+                    },
+                )
+                for i, page in enumerate(pdf_reader.pages)
+            ]
+
+    def _load_file_from_ids(self) -> List[Document]:
+        """Load files from a list of IDs."""
+        if not self.file_ids:
+            raise ValueError("file_ids must be set")
+        docs = []
+        for file_id in self.file_ids:
+            docs.extend(self._load_file_from_id(file_id))
+        return docs
+
+    def load(self) -> List[Document]:
+        """Load documents."""
+        if self.folder_id:
+            return self._load_documents_from_folder(
+                self.folder_id, file_types=self.file_types
+            )
+        elif self.document_ids:
+            return self._load_documents_from_ids()
+        else:
+            return self._load_file_from_ids()
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/gutenberg.py b/llm/Lib/site-packages/langchain_community/document_loaders/gutenberg.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe253ae88875fb78346335a68c4641d91dbfa474
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/gutenberg.py
@@ -0,0 +1,28 @@
+from typing import List
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class GutenbergLoader(BaseLoader):
+    """Load from `Gutenberg.org`."""
+
+    def __init__(self, file_path: str):
+        """Initialize with a file path."""
+        if not file_path.startswith("https://www.gutenberg.org"):
+            raise ValueError("file path must start with 'https://www.gutenberg.org'")
+
+        if not file_path.endswith(".txt"):
+            raise ValueError("file path must end with '.txt'")
+
+        self.file_path = file_path
+
+    def load(self) -> List[Document]:
+        """Load file."""
+        from urllib.request import urlopen
+
+        elements = urlopen(self.file_path)
+        text = "\n\n".join([str(el.decode("utf-8-sig")) for el in elements])
+        metadata = {"source": self.file_path}
+        return [Document(page_content=text, metadata=metadata)]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/helpers.py b/llm/Lib/site-packages/langchain_community/document_loaders/helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..e094db687280ed19f3315ddfd094b81458e3bcda
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/helpers.py
@@ -0,0 +1,51 @@
+"""Document loader helpers."""
+
+import concurrent.futures
+from pathlib import Path
+from typing import List, NamedTuple, Optional, Union, cast
+
+
+class FileEncoding(NamedTuple):
+    """File encoding as the NamedTuple."""
+
+    encoding: Optional[str]
+    """The encoding of the file."""
+    confidence: float
+    """The confidence of the encoding."""
+    language: Optional[str]
+    """The language of the file."""
+
+
+def detect_file_encodings(
+    file_path: Union[str, Path], timeout: int = 5
+) -> List[FileEncoding]:
+    """Try to detect the file encoding.
+
+    Returns a list of `FileEncoding` tuples with the detected encodings ordered
+    by confidence.
+
+    Args:
+        file_path: The path to the file to detect the encoding for.
+        timeout: The timeout in seconds for the encoding detection.
+    """
+    import chardet
+
+    file_path = str(file_path)
+
+    def read_and_detect(file_path: str) -> List[dict]:
+        with open(file_path, "rb") as f:
+            rawdata = f.read()
+        return cast(List[dict], chardet.detect_all(rawdata))
+
+    with concurrent.futures.ThreadPoolExecutor() as executor:
+        future = executor.submit(read_and_detect, file_path)
+        try:
+            encodings = future.result(timeout=timeout)
+        except concurrent.futures.TimeoutError:
+            raise TimeoutError(
+                f"Timeout reached while detecting encoding for {file_path}"
+            )
+
+    if all(encoding["encoding"] is None for encoding in encodings):
+        raise RuntimeError(f"Could not detect encoding for {file_path}")
+    return [FileEncoding(**enc) for enc in encodings if enc["encoding"] is not None]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/hn.py b/llm/Lib/site-packages/langchain_community/document_loaders/hn.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca36ca5f2b9573defb1060ddd14bd6f4360ad9e7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/hn.py
@@ -0,0 +1,62 @@
+from typing import Any, List
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.web_base import WebBaseLoader
+
+
+class HNLoader(WebBaseLoader):
+    """Load `Hacker News` data.
+
+    It loads data from either main page results or the comments page."""
+
+    def load(self) -> List[Document]:
+        """Get important HN webpage information.
+
+        HN webpage components are:
+            - title
+            - content
+            - source url,
+            - time of post
+            - author of the post
+            - number of comments
+            - rank of the post
+        """
+        soup_info = self.scrape()
+        if "item" in self.web_path:
+            return self.load_comments(soup_info)
+        else:
+            return self.load_results(soup_info)
+
+    def load_comments(self, soup_info: Any) -> List[Document]:
+        """Load comments from a HN post."""
+        comments = soup_info.select("tr[class='athing comtr']")
+        title = soup_info.select_one("tr[id='pagespace']").get("title")
+        return [
+            Document(
+                page_content=comment.text.strip(),
+                metadata={"source": self.web_path, "title": title},
+            )
+            for comment in comments
+        ]
+
+    def load_results(self, soup: Any) -> List[Document]:
+        """Load items from an HN page."""
+        items = soup.select("tr[class='athing']")
+        documents = []
+        for lineItem in items:
+            ranking = lineItem.select_one("span[class='rank']").text
+            link = lineItem.find("span", {"class": "titleline"}).find("a").get("href")
+            title = lineItem.find("span", {"class": "titleline"}).text.strip()
+            metadata = {
+                "source": self.web_path,
+                "title": title,
+                "link": link,
+                "ranking": ranking,
+            }
+            documents.append(
+                Document(
+                    page_content=title, link=link, ranking=ranking, metadata=metadata
+                )
+            )
+        return documents
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/html.py b/llm/Lib/site-packages/langchain_community/document_loaders/html.py
new file mode 100644
index 0000000000000000000000000000000000000000..77a2ef3d24df89cda9da28bc9727af8fa0e6ecef
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/html.py
@@ -0,0 +1,33 @@
+from typing import List
+
+from langchain_community.document_loaders.unstructured import UnstructuredFileLoader
+
+
+class UnstructuredHTMLLoader(UnstructuredFileLoader):
+    """Load `HTML` files using `Unstructured`.
+
+    You can run the loader in one of two modes: "single" and "elements".
+    If you use "single" mode, the document will be returned as a single
+    langchain Document object. If you use "elements" mode, the unstructured
+    library will split the document into elements such as Title and NarrativeText.
+    You can pass in additional unstructured kwargs after mode to apply
+    different unstructured settings.
+
+    Examples
+    --------
+    from langchain_community.document_loaders import UnstructuredHTMLLoader
+
+    loader = UnstructuredHTMLLoader(
+        "example.html", mode="elements", strategy="fast",
+    )
+    docs = loader.load()
+
+    References
+    ----------
+    https://unstructured-io.github.io/unstructured/bricks.html#partition-html
+    """
+
+    def _get_elements(self) -> List:
+        from unstructured.partition.html import partition_html
+
+        return partition_html(filename=self.file_path, **self.unstructured_kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/html_bs.py b/llm/Lib/site-packages/langchain_community/document_loaders/html_bs.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ab1820cc3b07cd8a81c0fb2fb6fb92697072176
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/html_bs.py
@@ -0,0 +1,64 @@
+import logging
+from pathlib import Path
+from typing import Dict, Iterator, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+
+class BSHTMLLoader(BaseLoader):
+    """Load `HTML` files and parse them with `beautiful soup`."""
+
+    def __init__(
+        self,
+        file_path: Union[str, Path],
+        open_encoding: Union[str, None] = None,
+        bs_kwargs: Union[dict, None] = None,
+        get_text_separator: str = "",
+    ) -> None:
+        """initialize with path, and optionally, file encoding to use, and any kwargs
+        to pass to the BeautifulSoup object.
+
+        Args:
+            file_path: The path to the file to load.
+            open_encoding: The encoding to use when opening the file.
+            bs_kwargs: Any kwargs to pass to the BeautifulSoup object.
+            get_text_separator: The separator to use when calling get_text on the soup.
+        """
+        try:
+            import bs4  # noqa:F401
+        except ImportError:
+            raise ImportError(
+                "beautifulsoup4 package not found, please install it with "
+                "`pip install beautifulsoup4`"
+            )
+
+        self.file_path = file_path
+        self.open_encoding = open_encoding
+        if bs_kwargs is None:
+            bs_kwargs = {"features": "lxml"}
+        self.bs_kwargs = bs_kwargs
+        self.get_text_separator = get_text_separator
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Load HTML document into document objects."""
+        from bs4 import BeautifulSoup
+
+        with open(self.file_path, "r", encoding=self.open_encoding) as f:
+            soup = BeautifulSoup(f, **self.bs_kwargs)
+
+        text = soup.get_text(self.get_text_separator)
+
+        if soup.title:
+            title = str(soup.title.string)
+        else:
+            title = ""
+
+        metadata: Dict[str, Union[str, None]] = {
+            "source": str(self.file_path),
+            "title": title,
+        }
+        yield Document(page_content=text, metadata=metadata)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/hugging_face_dataset.py b/llm/Lib/site-packages/langchain_community/document_loaders/hugging_face_dataset.py
new file mode 100644
index 0000000000000000000000000000000000000000..4aafc42b681296fad4198f8e34f4b60a59bc5228
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/hugging_face_dataset.py
@@ -0,0 +1,90 @@
+import json
+from typing import Iterator, Mapping, Optional, Sequence, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class HuggingFaceDatasetLoader(BaseLoader):
+    """Load from `Hugging Face Hub` datasets."""
+
+    def __init__(
+        self,
+        path: str,
+        page_content_column: str = "text",
+        name: Optional[str] = None,
+        data_dir: Optional[str] = None,
+        data_files: Optional[
+            Union[str, Sequence[str], Mapping[str, Union[str, Sequence[str]]]]
+        ] = None,
+        cache_dir: Optional[str] = None,
+        keep_in_memory: Optional[bool] = None,
+        save_infos: bool = False,
+        use_auth_token: Optional[Union[bool, str]] = None,
+        num_proc: Optional[int] = None,
+    ):
+        """Initialize the HuggingFaceDatasetLoader.
+
+        Args:
+            path: Path or name of the dataset.
+            page_content_column: Page content column name. Default is "text".
+            name: Name of the dataset configuration.
+            data_dir: Data directory of the dataset configuration.
+            data_files: Path(s) to source data file(s).
+            cache_dir: Directory to read/write data.
+            keep_in_memory: Whether to copy the dataset in-memory.
+            save_infos: Save the dataset information (checksums/size/splits/...).
+              Default is False.
+            use_auth_token: Bearer token for remote files on the Dataset Hub.
+            num_proc: Number of processes.
+        """
+
+        self.path = path
+        self.page_content_column = page_content_column
+        self.name = name
+        self.data_dir = data_dir
+        self.data_files = data_files
+        self.cache_dir = cache_dir
+        self.keep_in_memory = keep_in_memory
+        self.save_infos = save_infos
+        self.use_auth_token = use_auth_token
+        self.num_proc = num_proc
+
+    def lazy_load(
+        self,
+    ) -> Iterator[Document]:
+        """Load documents lazily."""
+        try:
+            from datasets import load_dataset
+        except ImportError:
+            raise ImportError(
+                "Could not import datasets python package. "
+                "Please install it with `pip install datasets`."
+            )
+
+        dataset = load_dataset(
+            path=self.path,
+            name=self.name,
+            data_dir=self.data_dir,
+            data_files=self.data_files,
+            cache_dir=self.cache_dir,
+            keep_in_memory=self.keep_in_memory,
+            save_infos=self.save_infos,
+            use_auth_token=self.use_auth_token,
+            num_proc=self.num_proc,
+        )
+
+        yield from (
+            Document(
+                page_content=self.parse_obj(row.pop(self.page_content_column)),
+                metadata=row,
+            )
+            for key in dataset.keys()
+            for row in dataset[key]
+        )
+
+    def parse_obj(self, page_content: Union[str, object]) -> str:
+        if isinstance(page_content, object):
+            return json.dumps(page_content)
+        return page_content
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/hugging_face_model.py b/llm/Lib/site-packages/langchain_community/document_loaders/hugging_face_model.py
new file mode 100644
index 0000000000000000000000000000000000000000..4486a49a2e947023deb2f2a929a605862f102767
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/hugging_face_model.py
@@ -0,0 +1,108 @@
+from typing import Iterator, List, Optional
+
+import requests
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class HuggingFaceModelLoader(BaseLoader):
+    """
+    Load model information from `Hugging Face Hub`, including README content.
+
+    This loader interfaces with the Hugging Face Models API to fetch and load
+    model metadata and README files.
+    The API allows you to search and filter models based on specific criteria
+    such as model tags, authors, and more.
+
+    API URL: https://huggingface.co/api/models
+    DOC URL: https://huggingface.co/docs/hub/en/api
+
+    Examples:
+
+        .. code-block:: python
+
+            from langchain_community.document_loaders import HuggingFaceModelLoader
+
+            # Initialize the loader with search criteria
+            loader = HuggingFaceModelLoader(search="bert", limit=10)
+
+            # Load models
+            documents = loader.load()
+
+            # Iterate through the fetched documents
+            for doc in documents:
+                print(doc.page_content)  # README content of the model
+                print(doc.metadata)      # Metadata of the model
+    """
+
+    BASE_URL = "https://huggingface.co/api/models"
+    README_BASE_URL = "https://huggingface.co/{model_id}/raw/main/README.md"
+
+    def __init__(
+        self,
+        *,
+        search: Optional[str] = None,
+        author: Optional[str] = None,
+        filter: Optional[str] = None,
+        sort: Optional[str] = None,
+        direction: Optional[str] = None,
+        limit: Optional[int] = 3,
+        full: Optional[bool] = None,
+        config: Optional[bool] = None,
+    ):
+        """Initialize the HuggingFaceModelLoader.
+
+        Args:
+            search: Filter based on substrings for repos and their usernames.
+            author: Filter models by an author or organization.
+            filter: Filter based on tags.
+            sort: Property to use when sorting.
+            direction: Direction in which to sort.
+            limit: Limit the number of models fetched.
+            full: Whether to fetch most model data.
+            config: Whether to also fetch the repo config.
+        """
+
+        self.params = {
+            "search": search,
+            "author": author,
+            "filter": filter,
+            "sort": sort,
+            "direction": direction,
+            "limit": limit,
+            "full": full,
+            "config": config,
+        }
+
+    def fetch_models(self) -> List[dict]:
+        """Fetch model information from Hugging Face Hub."""
+        response = requests.get(
+            self.BASE_URL,
+            params={k: v for k, v in self.params.items() if v is not None},
+        )
+        response.raise_for_status()
+        return response.json()
+
+    def fetch_readme_content(self, model_id: str) -> str:
+        """Fetch the README content for a given model."""
+        readme_url = self.README_BASE_URL.format(model_id=model_id)
+        try:
+            response = requests.get(readme_url)
+            response.raise_for_status()
+            return response.text
+        except requests.RequestException:
+            return "README not available for this model."
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Load model information lazily, including README content."""
+        models = self.fetch_models()
+
+        for model in models:
+            model_id = model.get("modelId", "")
+            readme_content = self.fetch_readme_content(model_id)
+
+            yield Document(
+                page_content=readme_content,
+                metadata=model,
+            )
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/ifixit.py b/llm/Lib/site-packages/langchain_community/document_loaders/ifixit.py
new file mode 100644
index 0000000000000000000000000000000000000000..335a4a1816e9b85b00f44e4582471a275e6a7a16
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/ifixit.py
@@ -0,0 +1,240 @@
+from typing import List, Optional
+
+import requests
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.web_base import WebBaseLoader
+
+IFIXIT_BASE_URL = "https://www.ifixit.com/api/2.0"
+
+
+class IFixitLoader(BaseLoader):
+    """Load `iFixit` repair guides, device wikis and answers.
+
+    iFixit is the largest, open repair community on the web. The site contains nearly
+    100k repair manuals, 200k Questions & Answers on 42k devices, and all the data is
+    licensed under CC-BY.
+
+    This loader will allow you to download the text of a repair guide, text of Q&A's
+    and wikis from devices on iFixit using their open APIs and web scraping.
+    """
+
+    def __init__(self, web_path: str):
+        """Initialize with a web path."""
+        if not web_path.startswith("https://www.ifixit.com"):
+            raise ValueError("web path must start with 'https://www.ifixit.com'")
+
+        path = web_path.replace("https://www.ifixit.com", "")
+
+        allowed_paths = ["/Device", "/Guide", "/Answers", "/Teardown"]
+
+        """ TODO: Add /Wiki """
+        if not any(path.startswith(allowed_path) for allowed_path in allowed_paths):
+            raise ValueError(
+                "web path must start with /Device, /Guide, /Teardown or /Answers"
+            )
+
+        pieces = [x for x in path.split("/") if x]
+
+        """Teardowns are just guides by a different name"""
+        self.page_type = pieces[0] if pieces[0] != "Teardown" else "Guide"
+
+        if self.page_type == "Guide" or self.page_type == "Answers":
+            self.id = pieces[2]
+        else:
+            self.id = pieces[1]
+
+        self.web_path = web_path
+
+    def load(self) -> List[Document]:
+        if self.page_type == "Device":
+            return self.load_device()
+        elif self.page_type == "Guide" or self.page_type == "Teardown":
+            return self.load_guide()
+        elif self.page_type == "Answers":
+            return self.load_questions_and_answers()
+        else:
+            raise ValueError("Unknown page type: " + self.page_type)
+
+    @staticmethod
+    def load_suggestions(query: str = "", doc_type: str = "all") -> List[Document]:
+        """Load suggestions.
+
+        Args:
+            query: A query string
+            doc_type: The type of document to search for. Can be one of "all",
+              "device", "guide", "teardown", "answer", "wiki".
+
+        Returns:
+
+        """
+        res = requests.get(
+            IFIXIT_BASE_URL + "/suggest/" + query + "?doctypes=" + doc_type
+        )
+
+        if res.status_code != 200:
+            raise ValueError(
+                'Could not load suggestions for "' + query + '"\n' + res.json()
+            )
+
+        data = res.json()
+
+        results = data["results"]
+        output = []
+
+        for result in results:
+            try:
+                loader = IFixitLoader(result["url"])
+                if loader.page_type == "Device":
+                    output += loader.load_device(include_guides=False)
+                else:
+                    output += loader.load()
+            except ValueError:
+                continue
+
+        return output
+
+    def load_questions_and_answers(
+        self, url_override: Optional[str] = None
+    ) -> List[Document]:
+        """Load a list of questions and answers.
+
+        Args:
+            url_override: A URL to override the default URL.
+
+        Returns: List[Document]
+
+        """
+        loader = WebBaseLoader(self.web_path if url_override is None else url_override)
+        soup = loader.scrape()
+
+        output = []
+
+        title = soup.find("h1", "post-title").text
+
+        output.append("# " + title)
+        output.append(soup.select_one(".post-content .post-text").text.strip())
+
+        answersHeader = soup.find("div", "post-answers-header")
+        if answersHeader:
+            output.append("\n## " + answersHeader.text.strip())
+
+        for answer in soup.select(".js-answers-list .post.post-answer"):
+            if answer.has_attr("itemprop") and "acceptedAnswer" in answer["itemprop"]:
+                output.append("\n### Accepted Answer")
+            elif "post-helpful" in answer["class"]:
+                output.append("\n### Most Helpful Answer")
+            else:
+                output.append("\n### Other Answer")
+
+            output += [
+                a.text.strip() for a in answer.select(".post-content .post-text")
+            ]
+            output.append("\n")
+
+        text = "\n".join(output).strip()
+
+        metadata = {"source": self.web_path, "title": title}
+
+        return [Document(page_content=text, metadata=metadata)]
+
+    def load_device(
+        self, url_override: Optional[str] = None, include_guides: bool = True
+    ) -> List[Document]:
+        """Loads a device
+
+        Args:
+            url_override: A URL to override the default URL.
+            include_guides: Whether to include guides linked to from the device.
+              Defaults to True.
+
+        Returns:
+
+        """
+        documents = []
+        if url_override is None:
+            url = IFIXIT_BASE_URL + "/wikis/CATEGORY/" + self.id
+        else:
+            url = url_override
+
+        res = requests.get(url)
+        data = res.json()
+        text = "\n".join(
+            [
+                data[key]
+                for key in ["title", "description", "contents_raw"]
+                if key in data
+            ]
+        ).strip()
+
+        metadata = {"source": self.web_path, "title": data["title"]}
+        documents.append(Document(page_content=text, metadata=metadata))
+
+        if include_guides:
+            """Load and return documents for each guide linked to from the device"""
+            guide_urls = [guide["url"] for guide in data["guides"]]
+            for guide_url in guide_urls:
+                documents.append(IFixitLoader(guide_url).load()[0])
+
+        return documents
+
+    def load_guide(self, url_override: Optional[str] = None) -> List[Document]:
+        """Load a guide
+
+        Args:
+            url_override: A URL to override the default URL.
+
+        Returns: List[Document]
+
+        """
+        if url_override is None:
+            url = IFIXIT_BASE_URL + "/guides/" + self.id
+        else:
+            url = url_override
+
+        res = requests.get(url)
+
+        if res.status_code != 200:
+            raise ValueError(
+                "Could not load guide: " + self.web_path + "\n" + res.json()
+            )
+
+        data = res.json()
+
+        doc_parts = ["# " + data["title"], data["introduction_raw"]]
+
+        doc_parts.append("\n\n###Tools Required:")
+        if len(data["tools"]) == 0:
+            doc_parts.append("\n - None")
+        else:
+            for tool in data["tools"]:
+                doc_parts.append("\n - " + tool["text"])
+
+        doc_parts.append("\n\n###Parts Required:")
+        if len(data["parts"]) == 0:
+            doc_parts.append("\n - None")
+        else:
+            for part in data["parts"]:
+                doc_parts.append("\n - " + part["text"])
+
+        for row in data["steps"]:
+            doc_parts.append(
+                "\n\n## "
+                + (
+                    row["title"]
+                    if row["title"] != ""
+                    else "Step {}".format(row["orderby"])
+                )
+            )
+
+            for line in row["lines"]:
+                doc_parts.append(line["text_raw"])
+
+        doc_parts.append(data["conclusion_raw"])
+
+        text = "\n".join(doc_parts)
+
+        metadata = {"source": self.web_path, "title": data["title"]}
+
+        return [Document(page_content=text, metadata=metadata)]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/image.py b/llm/Lib/site-packages/langchain_community/document_loaders/image.py
new file mode 100644
index 0000000000000000000000000000000000000000..c7b2e29b4c6f2242c3d8770c103bad40c61759fa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/image.py
@@ -0,0 +1,33 @@
+from typing import List
+
+from langchain_community.document_loaders.unstructured import UnstructuredFileLoader
+
+
+class UnstructuredImageLoader(UnstructuredFileLoader):
+    """Load `PNG` and `JPG` files using `Unstructured`.
+
+    You can run the loader in one of two modes: "single" and "elements".
+    If you use "single" mode, the document will be returned as a single
+    langchain Document object. If you use "elements" mode, the unstructured
+    library will split the document into elements such as Title and NarrativeText.
+    You can pass in additional unstructured kwargs after mode to apply
+    different unstructured settings.
+
+    Examples
+    --------
+    from langchain_community.document_loaders import UnstructuredImageLoader
+
+    loader = UnstructuredImageLoader(
+        "example.png", mode="elements", strategy="fast",
+    )
+    docs = loader.load()
+
+    References
+    ----------
+    https://unstructured-io.github.io/unstructured/bricks.html#partition-image
+    """
+
+    def _get_elements(self) -> List:
+        from unstructured.partition.image import partition_image
+
+        return partition_image(filename=self.file_path, **self.unstructured_kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/image_captions.py b/llm/Lib/site-packages/langchain_community/document_loaders/image_captions.py
new file mode 100644
index 0000000000000000000000000000000000000000..568fa0a25aacbe253fe57073455b7874251698c2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/image_captions.py
@@ -0,0 +1,102 @@
+from io import BytesIO
+from pathlib import Path
+from typing import Any, List, Tuple, Union
+
+import requests
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class ImageCaptionLoader(BaseLoader):
+    """Load image captions.
+
+    By default, the loader utilizes the pre-trained
+    Salesforce BLIP image captioning model.
+    https://huggingface.co/Salesforce/blip-image-captioning-base
+    """
+
+    def __init__(
+        self,
+        images: Union[str, Path, bytes, List[Union[str, bytes, Path]]],
+        blip_processor: str = "Salesforce/blip-image-captioning-base",
+        blip_model: str = "Salesforce/blip-image-captioning-base",
+    ):
+        """Initialize with a list of image data (bytes) or file paths
+
+        Args:
+            images: Either a single image or a list of images. Accepts
+                    image data (bytes) or file paths to images.
+            blip_processor: The name of the pre-trained BLIP processor.
+            blip_model: The name of the pre-trained BLIP model.
+        """
+        if isinstance(images, (str, Path, bytes)):
+            self.images = [images]
+        else:
+            self.images = images
+
+        self.blip_processor = blip_processor
+        self.blip_model = blip_model
+
+    def load(self) -> List[Document]:
+        """Load from a list of image data or file paths"""
+        try:
+            from transformers import BlipForConditionalGeneration, BlipProcessor
+        except ImportError:
+            raise ImportError(
+                "`transformers` package not found, please install with "
+                "`pip install transformers`."
+            )
+
+        processor = BlipProcessor.from_pretrained(self.blip_processor)
+        model = BlipForConditionalGeneration.from_pretrained(self.blip_model)
+
+        results = []
+        for image in self.images:
+            caption, metadata = self._get_captions_and_metadata(
+                model=model, processor=processor, image=image
+            )
+            doc = Document(page_content=caption, metadata=metadata)
+            results.append(doc)
+
+        return results
+
+    def _get_captions_and_metadata(
+        self, model: Any, processor: Any, image: Union[str, Path, bytes]
+    ) -> Tuple[str, dict]:
+        """Helper function for getting the captions and metadata of an image."""
+        try:
+            from PIL import Image
+        except ImportError:
+            raise ImportError(
+                "`PIL` package not found, please install with `pip install pillow`"
+            )
+
+        image_source = image  # Save the original source for later reference
+
+        try:
+            if isinstance(image, bytes):
+                image = Image.open(BytesIO(image)).convert("RGB")
+            elif isinstance(image, str) and (
+                image.startswith("http://") or image.startswith("https://")
+            ):
+                image = Image.open(requests.get(image, stream=True).raw).convert("RGB")
+            else:
+                image = Image.open(image).convert("RGB")
+        except Exception:
+            if isinstance(image_source, bytes):
+                msg = "Could not get image data from bytes"
+            else:
+                msg = f"Could not get image data for {image_source}"
+            raise ValueError(msg)
+
+        inputs = processor(image, "an image of", return_tensors="pt")
+        output = model.generate(**inputs)
+
+        caption: str = processor.decode(output[0])
+        if isinstance(image_source, bytes):
+            metadata: dict = {"image_source": "Image bytes provided"}
+        else:
+            metadata = {"image_path": str(image_source)}
+
+        return caption, metadata
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/imsdb.py b/llm/Lib/site-packages/langchain_community/document_loaders/imsdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..af2240206202a1a0a916a2b7c65aaa78d5335f89
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/imsdb.py
@@ -0,0 +1,16 @@
+from typing import List
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.web_base import WebBaseLoader
+
+
+class IMSDbLoader(WebBaseLoader):
+    """Load `IMSDb` webpages."""
+
+    def load(self) -> List[Document]:
+        """Load webpage."""
+        soup = self.scrape()
+        text = soup.select_one("td[class='scrtext']").text
+        metadata = {"source": self.web_path}
+        return [Document(page_content=text, metadata=metadata)]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/iugu.py b/llm/Lib/site-packages/langchain_community/document_loaders/iugu.py
new file mode 100644
index 0000000000000000000000000000000000000000..31e56bb0c7a3cc4cda1dbd7303b2ed601305d2e1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/iugu.py
@@ -0,0 +1,49 @@
+import json
+import urllib.request
+from typing import List, Optional
+
+from langchain_core.documents import Document
+from langchain_core.utils import get_from_env, stringify_dict
+
+from langchain_community.document_loaders.base import BaseLoader
+
+IUGU_ENDPOINTS = {
+    "invoices": "https://api.iugu.com/v1/invoices",
+    "customers": "https://api.iugu.com/v1/customers",
+    "charges": "https://api.iugu.com/v1/charges",
+    "subscriptions": "https://api.iugu.com/v1/subscriptions",
+    "plans": "https://api.iugu.com/v1/plans",
+}
+
+
+class IuguLoader(BaseLoader):
+    """Load from `IUGU`."""
+
+    def __init__(self, resource: str, api_token: Optional[str] = None) -> None:
+        """Initialize the IUGU resource.
+
+        Args:
+            resource: The name of the resource to fetch.
+            api_token: The IUGU API token to use.
+        """
+        self.resource = resource
+        api_token = api_token or get_from_env("api_token", "IUGU_API_TOKEN")
+        self.headers = {"Authorization": f"Bearer {api_token}"}
+
+    def _make_request(self, url: str) -> List[Document]:
+        request = urllib.request.Request(url, headers=self.headers)
+
+        with urllib.request.urlopen(request) as response:
+            json_data = json.loads(response.read().decode())
+            text = stringify_dict(json_data)
+            metadata = {"source": url}
+            return [Document(page_content=text, metadata=metadata)]
+
+    def _get_resource(self) -> List[Document]:
+        endpoint = IUGU_ENDPOINTS.get(self.resource)
+        if endpoint is None:
+            return []
+        return self._make_request(endpoint)
+
+    def load(self) -> List[Document]:
+        return self._get_resource()
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/joplin.py b/llm/Lib/site-packages/langchain_community/document_loaders/joplin.py
new file mode 100644
index 0000000000000000000000000000000000000000..407af7e6a35739a817039bbfd66095d29f461102
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/joplin.py
@@ -0,0 +1,93 @@
+import json
+import urllib
+from datetime import datetime
+from typing import Iterator, List, Optional
+
+from langchain_core.documents import Document
+from langchain_core.utils import get_from_env
+
+from langchain_community.document_loaders.base import BaseLoader
+
+LINK_NOTE_TEMPLATE = "joplin://x-callback-url/openNote?id={id}"
+
+
+class JoplinLoader(BaseLoader):
+    """Load notes from `Joplin`.
+
+    In order to use this loader, you need to have Joplin running with the
+    Web Clipper enabled (look for "Web Clipper" in the app settings).
+
+    To get the access token, you need to go to the Web Clipper options and
+    under "Advanced Options" you will find the access token.
+
+    You can find more information about the Web Clipper service here:
+    https://joplinapp.org/clipper/
+    """
+
+    def __init__(
+        self,
+        access_token: Optional[str] = None,
+        port: int = 41184,
+        host: str = "localhost",
+    ) -> None:
+        """
+
+        Args:
+            access_token: The access token to use.
+            port: The port where the Web Clipper service is running. Default is 41184.
+            host: The host where the Web Clipper service is running.
+                Default is localhost.
+        """
+        access_token = access_token or get_from_env(
+            "access_token", "JOPLIN_ACCESS_TOKEN"
+        )
+        base_url = f"http://{host}:{port}"
+        self._get_note_url = (
+            f"{base_url}/notes?token={access_token}"
+            f"&fields=id,parent_id,title,body,created_time,updated_time&page={{page}}"
+        )
+        self._get_folder_url = (
+            f"{base_url}/folders/{{id}}?token={access_token}&fields=title"
+        )
+        self._get_tag_url = (
+            f"{base_url}/notes/{{id}}/tags?token={access_token}&fields=title"
+        )
+
+    def _get_notes(self) -> Iterator[Document]:
+        has_more = True
+        page = 1
+        while has_more:
+            req_note = urllib.request.Request(self._get_note_url.format(page=page))
+            with urllib.request.urlopen(req_note) as response:
+                json_data = json.loads(response.read().decode())
+                for note in json_data["items"]:
+                    metadata = {
+                        "source": LINK_NOTE_TEMPLATE.format(id=note["id"]),
+                        "folder": self._get_folder(note["parent_id"]),
+                        "tags": self._get_tags(note["id"]),
+                        "title": note["title"],
+                        "created_time": self._convert_date(note["created_time"]),
+                        "updated_time": self._convert_date(note["updated_time"]),
+                    }
+                    yield Document(page_content=note["body"], metadata=metadata)
+
+                has_more = json_data["has_more"]
+                page += 1
+
+    def _get_folder(self, folder_id: str) -> str:
+        req_folder = urllib.request.Request(self._get_folder_url.format(id=folder_id))
+        with urllib.request.urlopen(req_folder) as response:
+            json_data = json.loads(response.read().decode())
+            return json_data["title"]
+
+    def _get_tags(self, note_id: str) -> List[str]:
+        req_tag = urllib.request.Request(self._get_tag_url.format(id=note_id))
+        with urllib.request.urlopen(req_tag) as response:
+            json_data = json.loads(response.read().decode())
+            return [tag["title"] for tag in json_data["items"]]
+
+    def _convert_date(self, date: int) -> str:
+        return datetime.fromtimestamp(date / 1000).strftime("%Y-%m-%d %H:%M:%S")
+
+    def lazy_load(self) -> Iterator[Document]:
+        yield from self._get_notes()
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/json_loader.py b/llm/Lib/site-packages/langchain_community/document_loaders/json_loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..5acd6c8e65712dc5f9228921c8c06b26fa7394f6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/json_loader.py
@@ -0,0 +1,182 @@
+import json
+from pathlib import Path
+from typing import Any, Callable, Dict, Iterator, Optional, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class JSONLoader(BaseLoader):
+    """Load a `JSON` file using a `jq` schema.
+
+    Example:
+        [{"text": ...}, {"text": ...}, {"text": ...}] -> schema = .[].text
+        {"key": [{"text": ...}, {"text": ...}, {"text": ...}]} -> schema = .key[].text
+        ["", "", ""] -> schema = .[]
+    """
+
+    def __init__(
+        self,
+        file_path: Union[str, Path],
+        jq_schema: str,
+        content_key: Optional[str] = None,
+        is_content_key_jq_parsable: Optional[bool] = False,
+        metadata_func: Optional[Callable[[Dict, Dict], Dict]] = None,
+        text_content: bool = True,
+        json_lines: bool = False,
+    ):
+        """Initialize the JSONLoader.
+
+        Args:
+            file_path (Union[str, Path]): The path to the JSON or JSON Lines file.
+            jq_schema (str): The jq schema to use to extract the data or text from
+                the JSON.
+            content_key (str): The key to use to extract the content from
+                the JSON if the jq_schema results to a list of objects (dict).
+                If is_content_key_jq_parsable is True, this has to be a jq compatible
+                schema. If is_content_key_jq_parsable is False, this should be a simple
+                string key.
+            is_content_key_jq_parsable (bool): A flag to determine if
+                content_key is parsable by jq or not. If True, content_key is
+                treated as a jq schema and compiled accordingly. If False or if
+                content_key is None, content_key is used as a simple string.
+                Default is False.
+            metadata_func (Callable[Dict, Dict]): A function that takes in the JSON
+                object extracted by the jq_schema and the default metadata and returns
+                a dict of the updated metadata.
+            text_content (bool): Boolean flag to indicate whether the content is in
+                string format, default to True.
+            json_lines (bool): Boolean flag to indicate whether the input is in
+                JSON Lines format.
+        """
+        try:
+            import jq  # noqa:F401
+
+            self.jq = jq
+        except ImportError:
+            raise ImportError(
+                "jq package not found, please install it with `pip install jq`"
+            )
+
+        self.file_path = Path(file_path).resolve()
+        self._jq_schema = jq.compile(jq_schema)
+        self._is_content_key_jq_parsable = is_content_key_jq_parsable
+        self._content_key = content_key
+        self._metadata_func = metadata_func
+        self._text_content = text_content
+        self._json_lines = json_lines
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Load and return documents from the JSON file."""
+        index = 0
+        if self._json_lines:
+            with self.file_path.open(encoding="utf-8") as f:
+                for line in f:
+                    line = line.strip()
+                    if line:
+                        for doc in self._parse(line, index):
+                            yield doc
+                            index += 1
+        else:
+            for doc in self._parse(self.file_path.read_text(encoding="utf-8"), index):
+                yield doc
+                index += 1
+
+    def _parse(self, content: str, index: int) -> Iterator[Document]:
+        """Convert given content to documents."""
+        data = self._jq_schema.input(json.loads(content))
+
+        # Perform some validation
+        # This is not a perfect validation, but it should catch most cases
+        # and prevent the user from getting a cryptic error later on.
+        if self._content_key is not None:
+            self._validate_content_key(data)
+        if self._metadata_func is not None:
+            self._validate_metadata_func(data)
+
+        for i, sample in enumerate(data, index + 1):
+            text = self._get_text(sample=sample)
+            metadata = self._get_metadata(
+                sample=sample, source=str(self.file_path), seq_num=i
+            )
+            yield Document(page_content=text, metadata=metadata)
+
+    def _get_text(self, sample: Any) -> str:
+        """Convert sample to string format"""
+        if self._content_key is not None:
+            if self._is_content_key_jq_parsable:
+                compiled_content_key = self.jq.compile(self._content_key)
+                content = compiled_content_key.input(sample).first()
+            else:
+                content = sample[self._content_key]
+        else:
+            content = sample
+
+        if self._text_content and not isinstance(content, str):
+            raise ValueError(
+                f"Expected page_content is string, got {type(content)} instead. \
+                    Set `text_content=False` if the desired input for \
+                    `page_content` is not a string"
+            )
+
+        # In case the text is None, set it to an empty string
+        elif isinstance(content, str):
+            return content
+        elif isinstance(content, dict):
+            return json.dumps(content) if content else ""
+        else:
+            return str(content) if content is not None else ""
+
+    def _get_metadata(
+        self, sample: Dict[str, Any], **additional_fields: Any
+    ) -> Dict[str, Any]:
+        """
+        Return a metadata dictionary base on the existence of metadata_func
+        :param sample: single data payload
+        :param additional_fields: key-word arguments to be added as metadata values
+        :return:
+        """
+        if self._metadata_func is not None:
+            return self._metadata_func(sample, additional_fields)
+        else:
+            return additional_fields
+
+    def _validate_content_key(self, data: Any) -> None:
+        """Check if a content key is valid"""
+
+        sample = data.first()
+        if not isinstance(sample, dict):
+            raise ValueError(
+                f"Expected the jq schema to result in a list of objects (dict), \
+                    so sample must be a dict but got `{type(sample)}`"
+            )
+
+        if (
+            not self._is_content_key_jq_parsable
+            and sample.get(self._content_key) is None
+        ):
+            raise ValueError(
+                f"Expected the jq schema to result in a list of objects (dict) \
+                    with the key `{self._content_key}`"
+            )
+        if (
+            self._is_content_key_jq_parsable
+            and self.jq.compile(self._content_key).input(sample).text() is None
+        ):
+            raise ValueError(
+                f"Expected the jq schema to result in a list of objects (dict) \
+                    with the key `{self._content_key}` which should be parsable by jq"
+            )
+
+    def _validate_metadata_func(self, data: Any) -> None:
+        """Check if the metadata_func output is valid"""
+
+        sample = data.first()
+        if self._metadata_func is not None:
+            sample_metadata = self._metadata_func(sample, {})
+            if not isinstance(sample_metadata, dict):
+                raise ValueError(
+                    f"Expected the metadata_func to return a dict but got \
+                        `{type(sample_metadata)}`"
+                )
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/lakefs.py b/llm/Lib/site-packages/langchain_community/document_loaders/lakefs.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca7d53c104a5ed170b3c674b17e7a784c3ee1f1f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/lakefs.py
@@ -0,0 +1,183 @@
+import os
+import tempfile
+import urllib.parse
+from typing import Any, List, Optional
+from urllib.parse import urljoin
+
+import requests
+from langchain_core.documents import Document
+from requests.auth import HTTPBasicAuth
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.unstructured import UnstructuredBaseLoader
+
+
+class LakeFSClient:
+    """Client for lakeFS."""
+
+    def __init__(
+        self,
+        lakefs_access_key: str,
+        lakefs_secret_key: str,
+        lakefs_endpoint: str,
+    ):
+        self.__endpoint = "/".join([lakefs_endpoint, "api", "v1/"])
+        self.__auth = HTTPBasicAuth(lakefs_access_key, lakefs_secret_key)
+        try:
+            health_check = requests.get(
+                urljoin(self.__endpoint, "healthcheck"), auth=self.__auth
+            )
+            health_check.raise_for_status()
+        except Exception:
+            raise ValueError(
+                "lakeFS server isn't accessible. Make sure lakeFS is running."
+            )
+
+    def ls_objects(
+        self, repo: str, ref: str, path: str, presign: Optional[bool]
+    ) -> List:
+        qp = {"prefix": path, "presign": presign}
+        eqp = urllib.parse.urlencode(qp)
+        objects_ls_endpoint = urljoin(
+            self.__endpoint, f"repositories/{repo}/refs/{ref}/objects/ls?{eqp}"
+        )
+        olsr = requests.get(objects_ls_endpoint, auth=self.__auth)
+        olsr.raise_for_status()
+        olsr_json = olsr.json()
+        return list(
+            map(
+                lambda res: (res["path"], res["physical_address"]), olsr_json["results"]
+            )
+        )
+
+    def is_presign_supported(self) -> bool:
+        config_endpoint = self.__endpoint + "config"
+        response = requests.get(config_endpoint, auth=self.__auth)
+        response.raise_for_status()
+        config = response.json()
+        return config["storage_config"]["pre_sign_support"]
+
+
+class LakeFSLoader(BaseLoader):
+    """Load from `lakeFS`."""
+
+    repo: str
+    ref: str
+    path: str
+
+    def __init__(
+        self,
+        lakefs_access_key: str,
+        lakefs_secret_key: str,
+        lakefs_endpoint: str,
+        repo: Optional[str] = None,
+        ref: Optional[str] = "main",
+        path: Optional[str] = "",
+    ):
+        """
+
+        :param lakefs_access_key: [required] lakeFS server's access key
+        :param lakefs_secret_key: [required] lakeFS server's secret key
+        :param lakefs_endpoint: [required] lakeFS server's endpoint address,
+               ex: https://example.my-lakefs.com
+        :param repo: [optional, default = ''] target repository
+        :param ref: [optional, default = 'main'] target ref (branch name,
+               tag, or commit ID)
+        :param path: [optional, default = ''] target path
+        """
+
+        self.__lakefs_client = LakeFSClient(
+            lakefs_access_key, lakefs_secret_key, lakefs_endpoint
+        )
+        self.repo = "" if repo is None or repo == "" else str(repo)
+        self.ref = "main" if ref is None or ref == "" else str(ref)
+        self.path = "" if path is None else str(path)
+
+    def set_path(self, path: str) -> None:
+        self.path = path
+
+    def set_ref(self, ref: str) -> None:
+        self.ref = ref
+
+    def set_repo(self, repo: str) -> None:
+        self.repo = repo
+
+    def load(self) -> List[Document]:
+        self.__validate_instance()
+        presigned = self.__lakefs_client.is_presign_supported()
+        docs: List[Document] = []
+        objs = self.__lakefs_client.ls_objects(
+            repo=self.repo, ref=self.ref, path=self.path, presign=presigned
+        )
+        for obj in objs:
+            lakefs_unstructured_loader = UnstructuredLakeFSLoader(
+                obj[1], self.repo, self.ref, obj[0], presigned
+            )
+            docs.extend(lakefs_unstructured_loader.load())
+        return docs
+
+    def __validate_instance(self) -> None:
+        if self.repo is None or self.repo == "":
+            raise ValueError(
+                "no repository was provided. use `set_repo` to specify a repository"
+            )
+        if self.ref is None or self.ref == "":
+            raise ValueError("no ref was provided. use `set_ref` to specify a ref")
+        if self.path is None:
+            raise ValueError("no path was provided. use `set_path` to specify a path")
+
+
+class UnstructuredLakeFSLoader(UnstructuredBaseLoader):
+    """Load from `lakeFS` as unstructured data."""
+
+    def __init__(
+        self,
+        url: str,
+        repo: str,
+        ref: str = "main",
+        path: str = "",
+        presign: bool = True,
+        **unstructured_kwargs: Any,
+    ):
+        """Initialize UnstructuredLakeFSLoader.
+
+        Args:
+
+        :param lakefs_access_key:
+        :param lakefs_secret_key:
+        :param lakefs_endpoint:
+        :param repo:
+        :param ref:
+        """
+
+        super().__init__(**unstructured_kwargs)
+        self.url = url
+        self.repo = repo
+        self.ref = ref
+        self.path = path
+        self.presign = presign
+
+    def _get_metadata(self) -> dict:
+        return {"repo": self.repo, "ref": self.ref, "path": self.path}
+
+    def _get_elements(self) -> List:
+        from unstructured.partition.auto import partition
+
+        local_prefix = "local://"
+
+        if self.presign:
+            with tempfile.TemporaryDirectory() as temp_dir:
+                file_path = f"{temp_dir}/{self.path.split('/')[-1]}"
+                os.makedirs(os.path.dirname(file_path), exist_ok=True)
+                response = requests.get(self.url)
+                response.raise_for_status()
+                with open(file_path, mode="wb") as file:
+                    file.write(response.content)
+                return partition(filename=file_path)
+        elif not self.url.startswith(local_prefix):
+            raise ValueError(
+                "Non pre-signed URLs are supported only with 'local' blockstore"
+            )
+        else:
+            local_path = self.url[len(local_prefix) :]
+            return partition(filename=local_path)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/larksuite.py b/llm/Lib/site-packages/langchain_community/document_loaders/larksuite.py
new file mode 100644
index 0000000000000000000000000000000000000000..1ab61a9845e981a026a5cbd6cd3585a9c49876e3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/larksuite.py
@@ -0,0 +1,48 @@
+import json
+import urllib.request
+from typing import Any, Iterator
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class LarkSuiteDocLoader(BaseLoader):
+    """Load from `LarkSuite` (`FeiShu`)."""
+
+    def __init__(self, domain: str, access_token: str, document_id: str):
+        """Initialize with domain, access_token (tenant / user), and document_id.
+
+        Args:
+            domain: The domain to load the LarkSuite.
+            access_token: The access_token to use.
+            document_id: The document_id to load.
+        """
+        self.domain = domain
+        self.access_token = access_token
+        self.document_id = document_id
+
+    def _get_larksuite_api_json_data(self, api_url: str) -> Any:
+        """Get LarkSuite (FeiShu) API response json data."""
+        headers = {"Authorization": f"Bearer {self.access_token}"}
+        request = urllib.request.Request(api_url, headers=headers)
+        with urllib.request.urlopen(request) as response:
+            json_data = json.loads(response.read().decode())
+            return json_data
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Lazy load LarkSuite (FeiShu) document."""
+        api_url_prefix = f"{self.domain}/open-apis/docx/v1/documents"
+        metadata_json = self._get_larksuite_api_json_data(
+            f"{api_url_prefix}/{self.document_id}"
+        )
+        raw_content_json = self._get_larksuite_api_json_data(
+            f"{api_url_prefix}/{self.document_id}/raw_content"
+        )
+        text = raw_content_json["data"]["content"]
+        metadata = {
+            "document_id": self.document_id,
+            "revision_id": metadata_json["data"]["document"]["revision_id"],
+            "title": metadata_json["data"]["document"]["title"],
+        }
+        yield Document(page_content=text, metadata=metadata)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/llmsherpa.py b/llm/Lib/site-packages/langchain_community/document_loaders/llmsherpa.py
new file mode 100644
index 0000000000000000000000000000000000000000..2c2e76758a0cc2b94c13f5546e872d0a7180d0e6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/llmsherpa.py
@@ -0,0 +1,142 @@
+from pathlib import Path
+from typing import Iterator, Union
+from urllib.parse import urlparse
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.pdf import BaseLoader
+
+DEFAULT_API = "https://readers.llmsherpa.com/api/document/developer/parseDocument?renderFormat=all"
+
+
+class LLMSherpaFileLoader(BaseLoader):
+    """Load Documents using `LLMSherpa`.
+
+    LLMSherpaFileLoader use LayoutPDFReader, which is part of the LLMSherpa library.
+    This tool is designed to parse PDFs while preserving their layout information,
+    which is often lost when using most PDF to text parsers.
+
+    Examples
+    --------
+    from langchain_community.document_loaders.llmsherpa import LLMSherpaFileLoader
+
+    loader = LLMSherpaFileLoader(
+        "example.pdf",
+        strategy="chunks",
+        llmsherpa_api_url="http://localhost:5010/api/parseDocument?renderFormat=all",
+    )
+    docs = loader.load()
+    """
+
+    def __init__(
+        self,
+        file_path: Union[str, Path],
+        new_indent_parser: bool = True,
+        apply_ocr: bool = True,
+        strategy: str = "chunks",
+        llmsherpa_api_url: str = DEFAULT_API,
+    ):
+        """Initialize with a file path."""
+        try:
+            import llmsherpa  # noqa:F401
+        except ImportError:
+            raise ImportError(
+                "llmsherpa package not found, please install it with "
+                "`pip install llmsherpa`"
+            )
+        _valid_strategies = ["sections", "chunks", "html", "text"]
+        if strategy not in _valid_strategies:
+            raise ValueError(
+                f"Got {strategy} for `strategy`, "
+                f"but should be one of `{_valid_strategies}`"
+            )
+        # validate llmsherpa url
+        if not self._is_valid_url(llmsherpa_api_url):
+            raise ValueError(f"Invalid URL: {llmsherpa_api_url}")
+        self.url = self._validate_llmsherpa_url(
+            url=llmsherpa_api_url,
+            new_indent_parser=new_indent_parser,
+            apply_ocr=apply_ocr,
+        )
+
+        self.strategy = strategy
+        self.file_path = str(file_path)
+
+    @staticmethod
+    def _is_valid_url(url: str) -> bool:
+        """Check if the url is valid."""
+        parsed = urlparse(url)
+        return bool(parsed.netloc) and bool(parsed.scheme)
+
+    @staticmethod
+    def _validate_llmsherpa_url(
+        url: str, new_indent_parser: bool = True, apply_ocr: bool = True
+    ) -> str:
+        """Check if the llmsherpa url is valid."""
+        parsed = urlparse(url)
+        valid_url = url
+        if ("/api/parseDocument" not in parsed.path) and (
+            "/api/document/developer/parseDocument" not in parsed.path
+        ):
+            raise ValueError(f"Invalid LLMSherpa URL: {url}")
+
+        if "renderFormat=all" not in parsed.query:
+            valid_url = valid_url + "?renderFormat=all"
+        if new_indent_parser and "useNewIndentParser=true" not in parsed.query:
+            valid_url = valid_url + "&useNewIndentParser=true"
+        if apply_ocr and "applyOcr=yes" not in parsed.query:
+            valid_url = valid_url + "&applyOcr=yes"
+
+        return valid_url
+
+    def lazy_load(
+        self,
+    ) -> Iterator[Document]:
+        """Load file."""
+        from llmsherpa.readers import LayoutPDFReader
+
+        docs_reader = LayoutPDFReader(self.url)
+        doc = docs_reader.read_pdf(self.file_path)
+
+        if self.strategy == "sections":
+            yield from [
+                Document(
+                    page_content=section.to_text(include_children=True, recurse=True),
+                    metadata={
+                        "source": self.file_path,
+                        "section_number": section_num,
+                        "section_title": section.title,
+                    },
+                )
+                for section_num, section in enumerate(doc.sections())
+            ]
+        if self.strategy == "chunks":
+            yield from [
+                Document(
+                    page_content=chunk.to_context_text(),
+                    metadata={
+                        "source": self.file_path,
+                        "chunk_number": chunk_num,
+                        "chunk_type": chunk.tag,
+                    },
+                )
+                for chunk_num, chunk in enumerate(doc.chunks())
+            ]
+        if self.strategy == "html":
+            yield from [
+                Document(
+                    page_content=doc.to_html(),
+                    metadata={
+                        "source": self.file_path,
+                    },
+                )
+            ]
+        if self.strategy == "text":
+            yield from [
+                Document(
+                    page_content=doc.to_text(),
+                    metadata={
+                        "source": self.file_path,
+                    },
+                )
+            ]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/markdown.py b/llm/Lib/site-packages/langchain_community/document_loaders/markdown.py
new file mode 100644
index 0000000000000000000000000000000000000000..a74e2c956017de5fab47372f982f4351d5589375
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/markdown.py
@@ -0,0 +1,45 @@
+from typing import List
+
+from langchain_community.document_loaders.unstructured import UnstructuredFileLoader
+
+
+class UnstructuredMarkdownLoader(UnstructuredFileLoader):
+    """Load `Markdown` files using `Unstructured`.
+
+    You can run the loader in one of two modes: "single" and "elements".
+    If you use "single" mode, the document will be returned as a single
+    langchain Document object. If you use "elements" mode, the unstructured
+    library will split the document into elements such as Title and NarrativeText.
+    You can pass in additional unstructured kwargs after mode to apply
+    different unstructured settings.
+
+    Examples
+    --------
+    from langchain_community.document_loaders import UnstructuredMarkdownLoader
+
+    loader = UnstructuredMarkdownLoader(
+        "example.md", mode="elements", strategy="fast",
+    )
+    docs = loader.load()
+
+    References
+    ----------
+    https://unstructured-io.github.io/unstructured/core/partition.html#partition-md
+    """
+
+    def _get_elements(self) -> List:
+        from unstructured.__version__ import __version__ as __unstructured_version__
+        from unstructured.partition.md import partition_md
+
+        # NOTE(MthwRobinson) - enables the loader to work when you're using pre-release
+        # versions of unstructured like 0.4.17-dev1
+        _unstructured_version = __unstructured_version__.split("-")[0]
+        unstructured_version = tuple([int(x) for x in _unstructured_version.split(".")])
+
+        if unstructured_version < (0, 4, 16):
+            raise ValueError(
+                f"You are on unstructured version {__unstructured_version__}. "
+                "Partitioning markdown files is only supported in unstructured>=0.4.16."
+            )
+
+        return partition_md(filename=self.file_path, **self.unstructured_kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/mastodon.py b/llm/Lib/site-packages/langchain_community/document_loaders/mastodon.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a757620acb367004c8b7ee1abb63246850b68db
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/mastodon.py
@@ -0,0 +1,96 @@
+from __future__ import annotations
+
+import os
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Optional,
+    Sequence,
+)
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+if TYPE_CHECKING:
+    import mastodon
+
+
+def _dependable_mastodon_import() -> mastodon:
+    try:
+        import mastodon
+    except ImportError:
+        raise ImportError(
+            "Mastodon.py package not found, "
+            "please install it with `pip install Mastodon.py`"
+        )
+    return mastodon
+
+
+class MastodonTootsLoader(BaseLoader):
+    """Load the `Mastodon` 'toots'."""
+
+    def __init__(
+        self,
+        mastodon_accounts: Sequence[str],
+        number_toots: Optional[int] = 100,
+        exclude_replies: bool = False,
+        access_token: Optional[str] = None,
+        api_base_url: str = "https://mastodon.social",
+    ):
+        """Instantiate Mastodon toots loader.
+
+        Args:
+            mastodon_accounts: The list of Mastodon accounts to query.
+            number_toots: How many toots to pull for each account. Defaults to 100.
+            exclude_replies: Whether to exclude reply toots from the load.
+                Defaults to False.
+            access_token: An access token if toots are loaded as a Mastodon app. Can
+                also be specified via the environment variables "MASTODON_ACCESS_TOKEN".
+            api_base_url: A Mastodon API base URL to talk to, if not using the default.
+                Defaults to "https://mastodon.social".
+        """
+        mastodon = _dependable_mastodon_import()
+        access_token = access_token or os.environ.get("MASTODON_ACCESS_TOKEN")
+        self.api = mastodon.Mastodon(
+            access_token=access_token, api_base_url=api_base_url
+        )
+        self.mastodon_accounts = mastodon_accounts
+        self.number_toots = number_toots
+        self.exclude_replies = exclude_replies
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Load toots into documents."""
+        for account in self.mastodon_accounts:
+            user = self.api.account_lookup(account)
+            toots = self.api.account_statuses(
+                user.id,
+                only_media=False,
+                pinned=False,
+                exclude_replies=self.exclude_replies,
+                exclude_reblogs=True,
+                limit=self.number_toots,
+            )
+            yield from self._format_toots(toots, user)
+
+    def _format_toots(
+        self, toots: List[Dict[str, Any]], user_info: dict
+    ) -> Iterable[Document]:
+        """Format toots into documents.
+
+        Adding user info, and selected toot fields into the metadata.
+        """
+        for toot in toots:
+            metadata = {
+                "created_at": toot["created_at"],
+                "user_info": user_info,
+                "is_reply": toot["in_reply_to_id"] is not None,
+            }
+            yield Document(
+                page_content=toot["content"],
+                metadata=metadata,
+            )
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/max_compute.py b/llm/Lib/site-packages/langchain_community/document_loaders/max_compute.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b507da89c94e3c25fce867c9a69ff256d1b9c4d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/max_compute.py
@@ -0,0 +1,80 @@
+from __future__ import annotations
+
+from typing import Any, Iterator, Optional, Sequence
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.utilities.max_compute import MaxComputeAPIWrapper
+
+
+class MaxComputeLoader(BaseLoader):
+    """Load from `Alibaba Cloud MaxCompute` table."""
+
+    def __init__(
+        self,
+        query: str,
+        api_wrapper: MaxComputeAPIWrapper,
+        *,
+        page_content_columns: Optional[Sequence[str]] = None,
+        metadata_columns: Optional[Sequence[str]] = None,
+    ):
+        """Initialize Alibaba Cloud MaxCompute document loader.
+
+        Args:
+            query: SQL query to execute.
+            api_wrapper: MaxCompute API wrapper.
+            page_content_columns: The columns to write into the `page_content` of the
+                Document. If unspecified, all columns will be written to `page_content`.
+            metadata_columns: The columns to write into the `metadata` of the Document.
+                If unspecified, all columns not added to `page_content` will be written.
+        """
+        self.query = query
+        self.api_wrapper = api_wrapper
+        self.page_content_columns = page_content_columns
+        self.metadata_columns = metadata_columns
+
+    @classmethod
+    def from_params(
+        cls,
+        query: str,
+        endpoint: str,
+        project: str,
+        *,
+        access_id: Optional[str] = None,
+        secret_access_key: Optional[str] = None,
+        **kwargs: Any,
+    ) -> MaxComputeLoader:
+        """Convenience constructor that builds the MaxCompute API wrapper from
+            given parameters.
+
+        Args:
+            query: SQL query to execute.
+            endpoint: MaxCompute endpoint.
+            project: A project is a basic organizational unit of MaxCompute, which is
+                similar to a database.
+            access_id: MaxCompute access ID. Should be passed in directly or set as the
+                environment variable `MAX_COMPUTE_ACCESS_ID`.
+            secret_access_key: MaxCompute secret access key. Should be passed in
+                directly or set as the environment variable
+                `MAX_COMPUTE_SECRET_ACCESS_KEY`.
+        """
+        api_wrapper = MaxComputeAPIWrapper.from_params(
+            endpoint, project, access_id=access_id, secret_access_key=secret_access_key
+        )
+        return cls(query, api_wrapper, **kwargs)
+
+    def lazy_load(self) -> Iterator[Document]:
+        for row in self.api_wrapper.query(self.query):
+            if self.page_content_columns:
+                page_content_data = {
+                    k: v for k, v in row.items() if k in self.page_content_columns
+                }
+            else:
+                page_content_data = row
+            page_content = "\n".join(f"{k}: {v}" for k, v in page_content_data.items())
+            if self.metadata_columns:
+                metadata = {k: v for k, v in row.items() if k in self.metadata_columns}
+            else:
+                metadata = {k: v for k, v in row.items() if k not in page_content_data}
+            yield Document(page_content=page_content, metadata=metadata)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/mediawikidump.py b/llm/Lib/site-packages/langchain_community/document_loaders/mediawikidump.py
new file mode 100644
index 0000000000000000000000000000000000000000..288312d6c9c61c1339097ceec757066beb78c906
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/mediawikidump.py
@@ -0,0 +1,109 @@
+import logging
+from pathlib import Path
+from typing import Iterator, Optional, Sequence, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+
+class MWDumpLoader(BaseLoader):
+    """Load `MediaWiki` dump from an `XML` file.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_text_splitters import RecursiveCharacterTextSplitter
+            from langchain_community.document_loaders import MWDumpLoader
+
+            loader = MWDumpLoader(
+                file_path="myWiki.xml",
+                encoding="utf8"
+            )
+            docs = loader.load()
+            text_splitter = RecursiveCharacterTextSplitter(
+                chunk_size=1000, chunk_overlap=0
+            )
+            texts = text_splitter.split_documents(docs)
+
+
+    :param file_path: XML local file path
+    :type file_path: str
+    :param encoding: Charset encoding, defaults to "utf8"
+    :type encoding: str, optional
+    :param namespaces: The namespace of pages you want to parse.
+        See https://www.mediawiki.org/wiki/Help:Namespaces#Localisation
+        for a list of all common namespaces
+    :type namespaces: List[int],optional
+    :param skip_redirects: TR=rue to skip pages that redirect to other pages,
+        False to keep them. False by default
+    :type skip_redirects: bool, optional
+    :param stop_on_error: False to skip over pages that cause parsing errors,
+        True to stop. True by default
+    :type stop_on_error: bool, optional
+    """
+
+    def __init__(
+        self,
+        file_path: Union[str, Path],
+        encoding: Optional[str] = "utf8",
+        namespaces: Optional[Sequence[int]] = None,
+        skip_redirects: Optional[bool] = False,
+        stop_on_error: Optional[bool] = True,
+    ):
+        self.file_path = file_path if isinstance(file_path, str) else str(file_path)
+        self.encoding = encoding
+        # Namespaces range from -2 to 15, inclusive.
+        self.namespaces = namespaces
+        self.skip_redirects = skip_redirects
+        self.stop_on_error = stop_on_error
+
+    def _load_dump_file(self):  # type: ignore[no-untyped-def]
+        try:
+            import mwxml
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import 'mwxml'. Please install with" " `pip install mwxml`."
+            ) from e
+
+        return mwxml.Dump.from_file(open(self.file_path, encoding=self.encoding))
+
+    def _load_single_page_from_dump(self, page) -> Document:  # type: ignore[no-untyped-def, return]
+        """Parse a single page."""
+        try:
+            import mwparserfromhell
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import 'mwparserfromhell'. Please install with"
+                " `pip install mwparserfromhell`."
+            ) from e
+        for revision in page:
+            code = mwparserfromhell.parse(revision.text)
+            text = code.strip_code(
+                normalize=True, collapse=True, keep_template_params=False
+            )
+            metadata = {"source": page.title}
+            return Document(page_content=text, metadata=metadata)
+
+    def lazy_load(
+        self,
+    ) -> Iterator[Document]:
+        """Lazy load from a file path."""
+
+        dump = self._load_dump_file()
+
+        for page in dump.pages:
+            if self.skip_redirects and page.redirect:
+                continue
+            if self.namespaces and page.namespace not in self.namespaces:
+                continue
+            try:
+                yield self._load_single_page_from_dump(page)
+            except Exception as e:
+                logger.error("Parsing error: {}".format(e))
+                if self.stop_on_error:
+                    raise e
+                else:
+                    continue
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/merge.py b/llm/Lib/site-packages/langchain_community/document_loaders/merge.py
new file mode 100644
index 0000000000000000000000000000000000000000..41f79e53f41043e006882cb924ce17f9db4f6f8d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/merge.py
@@ -0,0 +1,30 @@
+from typing import AsyncIterator, Iterator, List
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class MergedDataLoader(BaseLoader):
+    """Merge documents from a list of loaders"""
+
+    def __init__(self, loaders: List):
+        """Initialize with a list of loaders"""
+        self.loaders = loaders
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Lazy load docs from each individual loader."""
+        for loader in self.loaders:
+            # Check if lazy_load is implemented
+            try:
+                data = loader.lazy_load()
+            except NotImplementedError:
+                data = loader.load()
+            for document in data:
+                yield document
+
+    async def alazy_load(self) -> AsyncIterator[Document]:
+        """Lazy load docs from each individual loader."""
+        for loader in self.loaders:
+            async for document in loader.alazy_load():
+                yield document
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/mhtml.py b/llm/Lib/site-packages/langchain_community/document_loaders/mhtml.py
new file mode 100644
index 0000000000000000000000000000000000000000..95edc76d32508e29029a505c1c414578e4112110
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/mhtml.py
@@ -0,0 +1,77 @@
+import email
+import logging
+from pathlib import Path
+from typing import Dict, Iterator, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+
+class MHTMLLoader(BaseLoader):
+    """Parse `MHTML` files with `BeautifulSoup`."""
+
+    def __init__(
+        self,
+        file_path: Union[str, Path],
+        open_encoding: Union[str, None] = None,
+        bs_kwargs: Union[dict, None] = None,
+        get_text_separator: str = "",
+    ) -> None:
+        """initialize with path, and optionally, file encoding to use, and any kwargs
+        to pass to the BeautifulSoup object.
+
+        Args:
+            file_path: Path to file to load.
+            open_encoding: The encoding to use when opening the file.
+            bs_kwargs: Any kwargs to pass to the BeautifulSoup object.
+            get_text_separator: The separator to use when getting the text
+                from the soup.
+        """
+        try:
+            import bs4  # noqa:F401
+        except ImportError:
+            raise ImportError(
+                "beautifulsoup4 package not found, please install it with "
+                "`pip install beautifulsoup4`"
+            )
+
+        self.file_path = file_path
+        self.open_encoding = open_encoding
+        if bs_kwargs is None:
+            bs_kwargs = {"features": "lxml"}
+        self.bs_kwargs = bs_kwargs
+        self.get_text_separator = get_text_separator
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Load MHTML document into document objects."""
+
+        from bs4 import BeautifulSoup
+
+        with open(self.file_path, "r", encoding=self.open_encoding) as f:
+            message = email.message_from_string(f.read())
+            parts = message.get_payload()
+
+            if not isinstance(parts, list):
+                parts = [message]
+
+            for part in parts:
+                if part.get_content_type() == "text/html":
+                    html = part.get_payload(decode=True).decode()
+
+                    soup = BeautifulSoup(html, **self.bs_kwargs)
+                    text = soup.get_text(self.get_text_separator)
+
+                    if soup.title:
+                        title = str(soup.title.string)
+                    else:
+                        title = ""
+
+                    metadata: Dict[str, Union[str, None]] = {
+                        "source": str(self.file_path),
+                        "title": title,
+                    }
+                    yield Document(page_content=text, metadata=metadata)
+                    return
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/modern_treasury.py b/llm/Lib/site-packages/langchain_community/document_loaders/modern_treasury.py
new file mode 100644
index 0000000000000000000000000000000000000000..045a2e786edf133d751c46240059dba47d635fa0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/modern_treasury.py
@@ -0,0 +1,73 @@
+import json
+import urllib.request
+from base64 import b64encode
+from typing import List, Optional
+
+from langchain_core.documents import Document
+from langchain_core.utils import get_from_env, stringify_value
+
+from langchain_community.document_loaders.base import BaseLoader
+
+MODERN_TREASURY_ENDPOINTS = {
+    "payment_orders": "https://app.moderntreasury.com/api/payment_orders",
+    "expected_payments": "https://app.moderntreasury.com/api/expected_payments",
+    "returns": "https://app.moderntreasury.com/api/returns",
+    "incoming_payment_details": "https://app.moderntreasury.com/api/\
+incoming_payment_details",
+    "counterparties": "https://app.moderntreasury.com/api/counterparties",
+    "internal_accounts": "https://app.moderntreasury.com/api/internal_accounts",
+    "external_accounts": "https://app.moderntreasury.com/api/external_accounts",
+    "transactions": "https://app.moderntreasury.com/api/transactions",
+    "ledgers": "https://app.moderntreasury.com/api/ledgers",
+    "ledger_accounts": "https://app.moderntreasury.com/api/ledger_accounts",
+    "ledger_transactions": "https://app.moderntreasury.com/api/ledger_transactions",
+    "events": "https://app.moderntreasury.com/api/events",
+    "invoices": "https://app.moderntreasury.com/api/invoices",
+}
+
+
+class ModernTreasuryLoader(BaseLoader):
+    """Load from `Modern Treasury`."""
+
+    def __init__(
+        self,
+        resource: str,
+        organization_id: Optional[str] = None,
+        api_key: Optional[str] = None,
+    ) -> None:
+        """
+
+        Args:
+            resource: The Modern Treasury resource to load.
+            organization_id: The Modern Treasury organization ID. It can also be
+               specified via the environment variable
+               "MODERN_TREASURY_ORGANIZATION_ID".
+            api_key: The Modern Treasury API key. It can also be specified via
+               the environment variable "MODERN_TREASURY_API_KEY".
+        """
+        self.resource = resource
+        organization_id = organization_id or get_from_env(
+            "organization_id", "MODERN_TREASURY_ORGANIZATION_ID"
+        )
+        api_key = api_key or get_from_env("api_key", "MODERN_TREASURY_API_KEY")
+        credentials = f"{organization_id}:{api_key}".encode("utf-8")
+        basic_auth_token = b64encode(credentials).decode("utf-8")
+        self.headers = {"Authorization": f"Basic {basic_auth_token}"}
+
+    def _make_request(self, url: str) -> List[Document]:
+        request = urllib.request.Request(url, headers=self.headers)
+
+        with urllib.request.urlopen(request) as response:
+            json_data = json.loads(response.read().decode())
+            text = stringify_value(json_data)
+            metadata = {"source": url}
+            return [Document(page_content=text, metadata=metadata)]
+
+    def _get_resource(self) -> List[Document]:
+        endpoint = MODERN_TREASURY_ENDPOINTS.get(self.resource)
+        if endpoint is None:
+            return []
+        return self._make_request(endpoint)
+
+    def load(self) -> List[Document]:
+        return self._get_resource()
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/mongodb.py b/llm/Lib/site-packages/langchain_community/document_loaders/mongodb.py
new file mode 100644
index 0000000000000000000000000000000000000000..57b4f35217c80ce6162942111346d7fee178f545
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/mongodb.py
@@ -0,0 +1,94 @@
+import asyncio
+import logging
+from typing import Dict, List, Optional, Sequence
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+
+class MongodbLoader(BaseLoader):
+    """Load MongoDB documents."""
+
+    def __init__(
+        self,
+        connection_string: str,
+        db_name: str,
+        collection_name: str,
+        *,
+        filter_criteria: Optional[Dict] = None,
+        field_names: Optional[Sequence[str]] = None,
+    ) -> None:
+        try:
+            from motor.motor_asyncio import AsyncIOMotorClient
+        except ImportError as e:
+            raise ImportError(
+                "Cannot import from motor, please install with `pip install motor`."
+            ) from e
+        if not connection_string:
+            raise ValueError("connection_string must be provided.")
+
+        if not db_name:
+            raise ValueError("db_name must be provided.")
+
+        if not collection_name:
+            raise ValueError("collection_name must be provided.")
+
+        self.client = AsyncIOMotorClient(connection_string)
+        self.db_name = db_name
+        self.collection_name = collection_name
+        self.field_names = field_names
+        self.filter_criteria = filter_criteria or {}
+
+        self.db = self.client.get_database(db_name)
+        self.collection = self.db.get_collection(collection_name)
+
+    def load(self) -> List[Document]:
+        """Load data into Document objects.
+
+        Attention:
+
+        This implementation starts an asyncio event loop which
+        will only work if running in a sync env. In an async env, it should
+        fail since there is already an event loop running.
+
+        This code should be updated to kick off the event loop from a separate
+        thread if running within an async context.
+        """
+        return asyncio.run(self.aload())
+
+    async def aload(self) -> List[Document]:
+        """Load data into Document objects."""
+        result = []
+        total_docs = await self.collection.count_documents(self.filter_criteria)
+
+        # Construct the projection dictionary if field_names are specified
+        projection = (
+            {field: 1 for field in self.field_names} if self.field_names else None
+        )
+
+        async for doc in self.collection.find(self.filter_criteria, projection):
+            metadata = {
+                "database": self.db_name,
+                "collection": self.collection_name,
+            }
+
+            # Extract text content from filtered fields or use the entire document
+            if self.field_names is not None:
+                fields = {name: doc[name] for name in self.field_names}
+                texts = [str(value) for value in fields.values()]
+                text = " ".join(texts)
+            else:
+                text = str(doc)
+
+            result.append(Document(page_content=text, metadata=metadata))
+
+        if len(result) != total_docs:
+            logger.warning(
+                f"Only partial collection of documents returned. "
+                f"Loaded {len(result)} docs, expected {total_docs}."
+            )
+
+        return result
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/news.py b/llm/Lib/site-packages/langchain_community/document_loaders/news.py
new file mode 100644
index 0000000000000000000000000000000000000000..7f59601db62bc8c58bbadc249f74cead8a383782
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/news.py
@@ -0,0 +1,125 @@
+"""Loader that uses unstructured to load HTML files."""
+import logging
+from typing import Any, Iterator, List
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+
+class NewsURLLoader(BaseLoader):
+    """Load news articles from URLs using `Unstructured`.
+
+    Args:
+        urls: URLs to load. Each is loaded into its own document.
+        text_mode: If True, extract text from URL and use that for page content.
+            Otherwise, extract raw HTML.
+        nlp: If True, perform NLP on the extracted contents, like providing a summary
+            and extracting keywords.
+        continue_on_failure: If True, continue loading documents even if
+            loading fails for a particular URL.
+        show_progress_bar: If True, use tqdm to show a loading progress bar. Requires
+            tqdm to be installed, ``pip install tqdm``.
+        **newspaper_kwargs: Any additional named arguments to pass to
+            newspaper.Article().
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.document_loaders import NewsURLLoader
+
+            loader = NewsURLLoader(
+                urls=["<url-1>", "<url-2>"],
+            )
+            docs = loader.load()
+
+    Newspaper reference:
+        https://newspaper.readthedocs.io/en/latest/
+    """
+
+    def __init__(
+        self,
+        urls: List[str],
+        text_mode: bool = True,
+        nlp: bool = False,
+        continue_on_failure: bool = True,
+        show_progress_bar: bool = False,
+        **newspaper_kwargs: Any,
+    ) -> None:
+        """Initialize with file path."""
+        try:
+            import newspaper  # noqa:F401
+
+            self.__version = newspaper.__version__
+        except ImportError:
+            raise ImportError(
+                "newspaper package not found, please install it with "
+                "`pip install newspaper3k`"
+            )
+
+        self.urls = urls
+        self.text_mode = text_mode
+        self.nlp = nlp
+        self.continue_on_failure = continue_on_failure
+        self.newspaper_kwargs = newspaper_kwargs
+        self.show_progress_bar = show_progress_bar
+
+    def load(self) -> List[Document]:
+        iter = self.lazy_load()
+        if self.show_progress_bar:
+            try:
+                from tqdm import tqdm
+            except ImportError as e:
+                raise ImportError(
+                    "Package tqdm must be installed if show_progress_bar=True. "
+                    "Please install with 'pip install tqdm' or set "
+                    "show_progress_bar=False."
+                ) from e
+            iter = tqdm(iter)
+        return list(iter)
+
+    def lazy_load(self) -> Iterator[Document]:
+        try:
+            from newspaper import Article
+        except ImportError as e:
+            raise ImportError(
+                "Cannot import newspaper, please install with `pip install newspaper3k`"
+            ) from e
+
+        for url in self.urls:
+            try:
+                article = Article(url, **self.newspaper_kwargs)
+                article.download()
+                article.parse()
+
+                if self.nlp:
+                    article.nlp()
+
+            except Exception as e:
+                if self.continue_on_failure:
+                    logger.error(f"Error fetching or processing {url}, exception: {e}")
+                    continue
+                else:
+                    raise e
+
+            metadata = {
+                "title": getattr(article, "title", ""),
+                "link": getattr(article, "url", getattr(article, "canonical_link", "")),
+                "authors": getattr(article, "authors", []),
+                "language": getattr(article, "meta_lang", ""),
+                "description": getattr(article, "meta_description", ""),
+                "publish_date": getattr(article, "publish_date", ""),
+            }
+
+            if self.text_mode:
+                content = article.text
+            else:
+                content = article.html
+
+            if self.nlp:
+                metadata["keywords"] = getattr(article, "keywords", [])
+                metadata["summary"] = getattr(article, "summary", "")
+
+            yield Document(page_content=content, metadata=metadata)
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/notebook.py b/llm/Lib/site-packages/langchain_community/document_loaders/notebook.py
new file mode 100644
index 0000000000000000000000000000000000000000..f2cbe7be1f6f2667c46909fd7bb3c569d9f56f38
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/notebook.py
@@ -0,0 +1,136 @@
+"""Loads .ipynb notebook files."""
+import json
+from pathlib import Path
+from typing import Any, List, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+def concatenate_cells(
+    cell: dict, include_outputs: bool, max_output_length: int, traceback: bool
+) -> str:
+    """Combine cells information in a readable format ready to be used.
+
+    Args:
+        cell: A dictionary
+        include_outputs: Whether to include the outputs of the cell.
+        max_output_length: Maximum length of the output to be displayed.
+        traceback: Whether to return a traceback of the error.
+
+    Returns:
+        A string with the cell information.
+
+    """
+    cell_type = cell["cell_type"]
+    source = cell["source"]
+    if include_outputs:
+        try:
+            output = cell["outputs"]
+        except KeyError:
+            pass
+
+    if include_outputs and cell_type == "code" and output:
+        if "ename" in output[0].keys():
+            error_name = output[0]["ename"]
+            error_value = output[0]["evalue"]
+            if traceback:
+                traceback = output[0]["traceback"]
+                return (
+                    f"'{cell_type}' cell: '{source}'\n, gives error '{error_name}',"
+                    f" with description '{error_value}'\n"
+                    f"and traceback '{traceback}'\n\n"
+                )
+            else:
+                return (
+                    f"'{cell_type}' cell: '{source}'\n, gives error '{error_name}',"
+                    f"with description '{error_value}'\n\n"
+                )
+        elif output[0]["output_type"] == "stream":
+            output = output[0]["text"]
+            min_output = min(max_output_length, len(output))
+            return (
+                f"'{cell_type}' cell: '{source}'\n with "
+                f"output: '{output[:min_output]}'\n\n"
+            )
+    else:
+        return f"'{cell_type}' cell: '{source}'\n\n"
+
+    return ""
+
+
+def remove_newlines(x: Any) -> Any:
+    """Recursively remove newlines, no matter the data structure they are stored in."""
+
+    if isinstance(x, str):
+        return x.replace("\n", "")
+    elif isinstance(x, list):
+        return [remove_newlines(elem) for elem in x]
+    elif isinstance(x, dict):
+        return {k: remove_newlines(v) for (k, v) in x.items()}
+    else:
+        return x
+
+
+class NotebookLoader(BaseLoader):
+    """Load `Jupyter notebook` (.ipynb) files."""
+
+    def __init__(
+        self,
+        path: Union[str, Path],
+        include_outputs: bool = False,
+        max_output_length: int = 10,
+        remove_newline: bool = False,
+        traceback: bool = False,
+    ):
+        """Initialize with a path.
+
+        Args:
+            path: The path to load the notebook from.
+            include_outputs: Whether to include the outputs of the cell.
+                Defaults to False.
+            max_output_length: Maximum length of the output to be displayed.
+                Defaults to 10.
+            remove_newline: Whether to remove newlines from the notebook.
+                Defaults to False.
+            traceback: Whether to return a traceback of the error.
+                Defaults to False.
+        """
+        self.file_path = path
+        self.include_outputs = include_outputs
+        self.max_output_length = max_output_length
+        self.remove_newline = remove_newline
+        self.traceback = traceback
+
+    def load(
+        self,
+    ) -> List[Document]:
+        """Load documents."""
+        p = Path(self.file_path)
+
+        with open(p, encoding="utf8") as f:
+            d = json.load(f)
+
+        filtered_data = [
+            {k: v for (k, v) in cell.items() if k in ["cell_type", "source", "outputs"]}
+            for cell in d["cells"]
+        ]
+
+        if self.remove_newline:
+            filtered_data = list(map(remove_newlines, filtered_data))
+
+        text = "".join(
+            list(
+                map(
+                    lambda x: concatenate_cells(
+                        x, self.include_outputs, self.max_output_length, self.traceback
+                    ),
+                    filtered_data,
+                )
+            )
+        )
+
+        metadata = {"source": str(p)}
+
+        return [Document(page_content=text, metadata=metadata)]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/notion.py b/llm/Lib/site-packages/langchain_community/document_loaders/notion.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed01891c444f2b68beee86f33b9aa34c8677021c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/notion.py
@@ -0,0 +1,26 @@
+from pathlib import Path
+from typing import List, Union
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+
+class NotionDirectoryLoader(BaseLoader):
+    """Load `Notion directory` dump."""
+
+    def __init__(self, path: Union[str, Path], *, encoding: str = "utf-8") -> None:
+        """Initialize with a file path."""
+        self.file_path = path
+        self.encoding = encoding
+
+    def load(self) -> List[Document]:
+        """Load documents."""
+        paths = list(Path(self.file_path).glob("**/*.md"))
+        docs = []
+        for p in paths:
+            with open(p, encoding=self.encoding) as f:
+                text = f.read()
+            metadata = {"source": str(p)}
+            docs.append(Document(page_content=text, metadata=metadata))
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/notiondb.py b/llm/Lib/site-packages/langchain_community/document_loaders/notiondb.py
new file mode 100644
index 0000000000000000000000000000000000000000..76215727bd9d380e8859aa0891f1fafdae0e1143
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/notiondb.py
@@ -0,0 +1,221 @@
+from typing import Any, Dict, List, Optional
+
+import requests
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+NOTION_BASE_URL = "https://api.notion.com/v1"
+DATABASE_URL = NOTION_BASE_URL + "/databases/{database_id}/query"
+PAGE_URL = NOTION_BASE_URL + "/pages/{page_id}"
+BLOCK_URL = NOTION_BASE_URL + "/blocks/{block_id}/children"
+
+
+class NotionDBLoader(BaseLoader):
+    """Load from `Notion DB`.
+
+    Reads content from pages within a Notion Database.
+    Args:
+        integration_token (str): Notion integration token.
+        database_id (str): Notion database id.
+        request_timeout_sec (int): Timeout for Notion requests in seconds.
+            Defaults to 10.
+        filter_object (Dict[str, Any]): Filter object used to limit returned
+            entries based on specified criteria.
+            E.g.: {
+                "timestamp": "last_edited_time",
+                "last_edited_time": {
+                    "on_or_after": "2024-02-07"
+                }
+            } -> will only return entries that were last edited
+                on or after 2024-02-07
+            Notion docs: https://developers.notion.com/reference/post-database-query-filter
+            Defaults to None, which will return ALL entries.
+    """
+
+    def __init__(
+        self,
+        integration_token: str,
+        database_id: str,
+        request_timeout_sec: Optional[int] = 10,
+        *,
+        filter_object: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        """Initialize with parameters."""
+        if not integration_token:
+            raise ValueError("integration_token must be provided")
+        if not database_id:
+            raise ValueError("database_id must be provided")
+
+        self.token = integration_token
+        self.database_id = database_id
+        self.headers = {
+            "Authorization": "Bearer " + self.token,
+            "Content-Type": "application/json",
+            "Notion-Version": "2022-06-28",
+        }
+        self.request_timeout_sec = request_timeout_sec
+        self.filter_object = filter_object or {}
+
+    def load(self) -> List[Document]:
+        """Load documents from the Notion database.
+        Returns:
+            List[Document]: List of documents.
+        """
+        page_summaries = self._retrieve_page_summaries()
+
+        return list(self.load_page(page_summary) for page_summary in page_summaries)
+
+    def _retrieve_page_summaries(
+        self, query_dict: Dict[str, Any] = {"page_size": 100}
+    ) -> List[Dict[str, Any]]:
+        """
+        Get all the pages from a Notion database
+        OR filter based on specified criteria.
+        """
+        pages: List[Dict[str, Any]] = []
+
+        while True:
+            data = self._request(
+                DATABASE_URL.format(database_id=self.database_id),
+                method="POST",
+                query_dict=query_dict,
+                filter_object=self.filter_object,
+            )
+
+            pages.extend(data.get("results"))
+
+            if not data.get("has_more"):
+                break
+
+            query_dict["start_cursor"] = data.get("next_cursor")
+
+        return pages
+
+    def load_page(self, page_summary: Dict[str, Any]) -> Document:
+        """Read a page.
+
+        Args:
+            page_summary: Page summary from Notion API.
+        """
+        page_id = page_summary["id"]
+
+        # load properties as metadata
+        metadata: Dict[str, Any] = {}
+
+        for prop_name, prop_data in page_summary["properties"].items():
+            prop_type = prop_data["type"]
+
+            if prop_type == "rich_text":
+                value = (
+                    prop_data["rich_text"][0]["plain_text"]
+                    if prop_data["rich_text"]
+                    else None
+                )
+            elif prop_type == "title":
+                value = (
+                    prop_data["title"][0]["plain_text"] if prop_data["title"] else None
+                )
+            elif prop_type == "multi_select":
+                value = (
+                    [item["name"] for item in prop_data["multi_select"]]
+                    if prop_data["multi_select"]
+                    else []
+                )
+            elif prop_type == "url":
+                value = prop_data["url"]
+            elif prop_type == "unique_id":
+                value = (
+                    f'{prop_data["unique_id"]["prefix"]}-{prop_data["unique_id"]["number"]}'
+                    if prop_data["unique_id"]
+                    else None
+                )
+            elif prop_type == "status":
+                value = prop_data["status"]["name"] if prop_data["status"] else None
+            elif prop_type == "people":
+                value = (
+                    [item["name"] for item in prop_data["people"]]
+                    if prop_data["people"]
+                    else []
+                )
+            elif prop_type == "date":
+                value = prop_data["date"] if prop_data["date"] else None
+            elif prop_type == "last_edited_time":
+                value = (
+                    prop_data["last_edited_time"]
+                    if prop_data["last_edited_time"]
+                    else None
+                )
+            elif prop_type == "created_time":
+                value = prop_data["created_time"] if prop_data["created_time"] else None
+            elif prop_type == "checkbox":
+                value = prop_data["checkbox"]
+            elif prop_type == "email":
+                value = prop_data["email"]
+            elif prop_type == "number":
+                value = prop_data["number"]
+            elif prop_type == "select":
+                value = prop_data["select"]["name"] if prop_data["select"] else None
+            else:
+                value = None
+
+            metadata[prop_name.lower()] = value
+
+        metadata["id"] = page_id
+
+        return Document(page_content=self._load_blocks(page_id), metadata=metadata)
+
+    def _load_blocks(self, block_id: str, num_tabs: int = 0) -> str:
+        """Read a block and its children."""
+        result_lines_arr: List[str] = []
+        cur_block_id: str = block_id
+
+        while cur_block_id:
+            data = self._request(BLOCK_URL.format(block_id=cur_block_id))
+
+            for result in data["results"]:
+                result_obj = result[result["type"]]
+
+                if "rich_text" not in result_obj:
+                    continue
+
+                cur_result_text_arr: List[str] = []
+
+                for rich_text in result_obj["rich_text"]:
+                    if "text" in rich_text:
+                        cur_result_text_arr.append(
+                            "\t" * num_tabs + rich_text["text"]["content"]
+                        )
+
+                if result["has_children"]:
+                    children_text = self._load_blocks(
+                        result["id"], num_tabs=num_tabs + 1
+                    )
+                    cur_result_text_arr.append(children_text)
+
+                result_lines_arr.append("\n".join(cur_result_text_arr))
+
+            cur_block_id = data.get("next_cursor")
+
+        return "\n".join(result_lines_arr)
+
+    def _request(
+        self,
+        url: str,
+        method: str = "GET",
+        query_dict: Dict[str, Any] = {},
+        *,
+        filter_object: Optional[Dict[str, Any]] = None,
+    ) -> Any:
+        json_payload = query_dict.copy()
+        if filter_object:
+            json_payload["filter"] = filter_object
+        res = requests.request(
+            method,
+            url,
+            headers=self.headers,
+            json=json_payload,
+            timeout=self.request_timeout_sec,
+        )
+        res.raise_for_status()
+        return res.json()
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/nuclia.py b/llm/Lib/site-packages/langchain_community/document_loaders/nuclia.py
new file mode 100644
index 0000000000000000000000000000000000000000..0744b778b4e8f7e71976200f7d5cc8d5e92136c0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/nuclia.py
@@ -0,0 +1,33 @@
+import json
+import uuid
+from typing import List
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.tools.nuclia.tool import NucliaUnderstandingAPI
+
+
+class NucliaLoader(BaseLoader):
+    """Load from any file type using `Nuclia Understanding API`."""
+
+    def __init__(self, path: str, nuclia_tool: NucliaUnderstandingAPI):
+        self.nua = nuclia_tool
+        self.id = str(uuid.uuid4())
+        self.nua.run({"action": "push", "id": self.id, "path": path, "text": None})
+
+    def load(self) -> List[Document]:
+        """Load documents."""
+        data = self.nua.run(
+            {"action": "pull", "id": self.id, "path": None, "text": None}
+        )
+        if not data:
+            return []
+        obj = json.loads(data)
+        text = obj["extracted_text"][0]["body"]["text"]
+        print(text)  # noqa: T201
+        metadata = {
+            "file": obj["file_extracted_data"][0],
+            "metadata": obj["field_metadata"][0],
+        }
+        return [Document(page_content=text, metadata=metadata)]
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/obs_directory.py b/llm/Lib/site-packages/langchain_community/document_loaders/obs_directory.py
new file mode 100644
index 0000000000000000000000000000000000000000..24b67149788d4790a008e06c35082c8d9d643512
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/obs_directory.py
@@ -0,0 +1,83 @@
+# coding:utf-8
+from typing import List, Optional
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.obs_file import OBSFileLoader
+
+
+class OBSDirectoryLoader(BaseLoader):
+    """Load from `Huawei OBS directory`."""
+
+    def __init__(
+        self,
+        bucket: str,
+        endpoint: str,
+        config: Optional[dict] = None,
+        prefix: str = "",
+    ):
+        """Initialize the OBSDirectoryLoader with the specified settings.
+
+        Args:
+            bucket (str): The name of the OBS bucket to be used.
+            endpoint (str): The endpoint URL of your OBS bucket.
+            config (dict): The parameters for connecting to OBS, provided as a dictionary. The dictionary could have the following keys:
+                - "ak" (str, optional): Your OBS access key (required if `get_token_from_ecs` is False and bucket policy is not public read).
+                - "sk" (str, optional): Your OBS secret key (required if `get_token_from_ecs` is False and bucket policy is not public read).
+                - "token" (str, optional): Your security token (required if using temporary credentials).
+                - "get_token_from_ecs" (bool, optional): Whether to retrieve the security token from ECS. Defaults to False if not provided. If set to True, `ak`, `sk`, and `token` will be ignored.
+            prefix (str, optional): The prefix to be added to the OBS key. Defaults to "".
+
+        Note:
+            Before using this class, make sure you have registered with OBS and have the necessary credentials. The `ak`, `sk`, and `endpoint` values are mandatory unless `get_token_from_ecs` is True or the bucket policy is public read. `token` is required when using temporary credentials.
+        Example:
+            To create a new OBSDirectoryLoader:
+            ```
+            config = {
+                "ak": "your-access-key",
+                "sk": "your-secret-key"
+            }
+            ```
+            directory_loader = OBSDirectoryLoader("your-bucket-name", "your-end-endpoint", config, "your-prefix")
+        """  # noqa: E501
+        try:
+            from obs import ObsClient
+        except ImportError:
+            raise ImportError(
+                "Could not import esdk-obs-python python package. "
+                "Please install it with `pip install esdk-obs-python`."
+            )
+        if not config:
+            config = dict()
+        if config.get("get_token_from_ecs"):
+            self.client = ObsClient(server=endpoint, security_provider_policy="ECS")
+        else:
+            self.client = ObsClient(
+                access_key_id=config.get("ak"),
+                secret_access_key=config.get("sk"),
+                security_token=config.get("token"),
+                server=endpoint,
+            )
+
+        self.bucket = bucket
+        self.prefix = prefix
+
+    def load(self) -> List[Document]:
+        """Load documents."""
+        max_num = 1000
+        mark = None
+        docs = []
+        while True:
+            resp = self.client.listObjects(
+                self.bucket, prefix=self.prefix, marker=mark, max_keys=max_num
+            )
+            if resp.status < 300:
+                for content in resp.body.contents:
+                    loader = OBSFileLoader(self.bucket, content.key, client=self.client)
+                    docs.extend(loader.load())
+                if resp.body.is_truncated is True:
+                    mark = resp.body.next_marker
+                else:
+                    break
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/obs_file.py b/llm/Lib/site-packages/langchain_community/document_loaders/obs_file.py
new file mode 100644
index 0000000000000000000000000000000000000000..d6add62c33bc9d2a968dc45a4aa6f6e3f5f1890f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/obs_file.py
@@ -0,0 +1,105 @@
+# coding:utf-8
+
+import os
+import tempfile
+from typing import Any, List, Optional
+
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+from langchain_community.document_loaders.unstructured import UnstructuredFileLoader
+
+
+class OBSFileLoader(BaseLoader):
+    """Load from the `Huawei OBS file`."""
+
+    def __init__(
+        self,
+        bucket: str,
+        key: str,
+        client: Any = None,
+        endpoint: str = "",
+        config: Optional[dict] = None,
+    ) -> None:
+        """Initialize the OBSFileLoader with the specified settings.
+
+        Args:
+            bucket (str): The name of the OBS bucket to be used.
+            key (str): The name of the object in the OBS bucket.
+            client (ObsClient, optional): An instance of the ObsClient to connect to OBS.
+            endpoint (str, optional): The endpoint URL of your OBS bucket. This parameter is mandatory if `client` is not provided.
+            config (dict, optional): The parameters for connecting to OBS, provided as a dictionary. This parameter is ignored if `client` is provided. The dictionary could have the following keys:
+                - "ak" (str, optional): Your OBS access key (required if `get_token_from_ecs` is False and bucket policy is not public read).
+                - "sk" (str, optional): Your OBS secret key (required if `get_token_from_ecs` is False and bucket policy is not public read).
+                - "token" (str, optional): Your security token (required if using temporary credentials).
+                - "get_token_from_ecs" (bool, optional): Whether to retrieve the security token from ECS. Defaults to False if not provided. If set to True, `ak`, `sk`, and `token` will be ignored.
+
+        Raises:
+            ValueError: If the `esdk-obs-python` package is not installed.
+            TypeError: If the provided `client` is not an instance of ObsClient.
+            ValueError: If `client` is not provided, but `endpoint` is missing.
+
+        Note:
+            Before using this class, make sure you have registered with OBS and have the necessary credentials. The `ak`, `sk`, and `endpoint` values are mandatory unless `get_token_from_ecs` is True or the bucket policy is public read. `token` is required when using temporary credentials.
+
+        Example:
+            To create a new OBSFileLoader with a new client:
+            ```
+            config = {
+                "ak": "your-access-key",
+                "sk": "your-secret-key"
+            }
+            obs_loader = OBSFileLoader("your-bucket-name", "your-object-key", config=config)
+            ```
+
+            To create a new OBSFileLoader with an existing client:
+            ```
+            from obs import ObsClient
+
+            # Assuming you have an existing ObsClient object 'obs_client'
+            obs_loader = OBSFileLoader("your-bucket-name", "your-object-key", client=obs_client)
+            ```
+
+            To create a new OBSFileLoader without an existing client:
+            ```
+            obs_loader = OBSFileLoader("your-bucket-name", "your-object-key", endpoint="your-endpoint-url")
+            ```
+        """  # noqa: E501
+        try:
+            from obs import ObsClient
+        except ImportError:
+            raise ImportError(
+                "Could not import esdk-obs-python python package. "
+                "Please install it with `pip install esdk-obs-python`."
+            )
+        if not client:
+            if not endpoint:
+                raise ValueError("Either OBSClient or endpoint must be provided.")
+            if not config:
+                config = dict()
+            if config.get("get_token_from_ecs"):
+                client = ObsClient(server=endpoint, security_provider_policy="ECS")
+            else:
+                client = ObsClient(
+                    access_key_id=config.get("ak"),
+                    secret_access_key=config.get("sk"),
+                    security_token=config.get("token"),
+                    server=endpoint,
+                )
+        if not isinstance(client, ObsClient):
+            raise TypeError("Client must be ObsClient type")
+        self.client = client
+        self.bucket = bucket
+        self.key = key
+
+    def load(self) -> List[Document]:
+        """Load documents."""
+        with tempfile.TemporaryDirectory() as temp_dir:
+            file_path = f"{temp_dir}/{self.bucket}/{self.key}"
+            os.makedirs(os.path.dirname(file_path), exist_ok=True)
+            # Download the file to a destination
+            self.client.downloadFile(
+                bucketName=self.bucket, objectKey=self.key, downloadFile=file_path
+            )
+            loader = UnstructuredFileLoader(file_path)
+            return loader.load()
diff --git a/llm/Lib/site-packages/langchain_community/document_loaders/obsidian.py b/llm/Lib/site-packages/langchain_community/document_loaders/obsidian.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed5ce974cbd7888a87de07d9c3f6f2d79a5d7133
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_loaders/obsidian.py
@@ -0,0 +1,167 @@
+import functools
+import logging
+import re
+from pathlib import Path
+from typing import Any, Dict, Iterator, Union
+
+import yaml
+from langchain_core.documents import Document
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+
+class ObsidianLoader(BaseLoader):
+    """Load `Obsidian` files from directory."""
+
+    FRONT_MATTER_REGEX = re.compile(r"^---\n(.*?)\n---\n", re.DOTALL)
+    TEMPLATE_VARIABLE_REGEX = re.compile(r"{{(.*?)}}", re.DOTALL)
+    TAG_REGEX = re.compile(r"[^\S\/]#([a-zA-Z_]+[-_/\w]*)")
+    DATAVIEW_LINE_REGEX = re.compile(r"^\s*(\w+)::\s*(.*)$", re.MULTILINE)
+    DATAVIEW_INLINE_BRACKET_REGEX = re.compile(r"\[(\w+)::\s*(.*)\]", re.MULTILINE)
+    DATAVIEW_INLINE_PAREN_REGEX = re.compile(r"\((\w+)::\s*(.*)\)", re.MULTILINE)
+
+    def __init__(
+        self,
+        path: Union[str, Path],
+        encoding: str = "UTF-8",
+        collect_metadata: bool = True,
+    ):
+        """Initialize with a path.
+
+        Args:
+            path: Path to the directory containing the Obsidian files.
+            encoding: Charset encoding, defaults to "UTF-8"
+            collect_metadata: Whether to collect metadata from the front matter.
+                Defaults to True.
+        """
+        self.file_path = path
+        self.encoding = encoding
+        self.collect_metadata = collect_metadata
+
+    def _replace_template_var(
+        self, placeholders: Dict[str, str], match: re.Match
+    ) -> str:
+        """Replace a template variable with a placeholder."""
+        placeholder = f"__TEMPLATE_VAR_{len(placeholders)}__"
+        placeholders[placeholder] = match.group(1)
+        return placeholder
+
+    def _restore_template_vars(self, obj: Any, placeholders: Dict[str, str]) -> Any:
+        """Restore template variables replaced with placeholders to original values."""
+        if isinstance(obj, str):
+            for placeholder, value in placeholders.items():
+                obj = obj.replace(placeholder, f"{{{{{value}}}}}")
+        elif isinstance(obj, dict):
+            for key, value in obj.items():
+                obj[key] = self._restore_template_vars(value, placeholders)
+        elif isinstance(obj, list):
+            for i, item in enumerate(obj):
+                obj[i] = self._restore_template_vars(item, placeholders)
+        return obj
+
+    def _parse_front_matter(self, content: str) -> dict:
+        """Parse front matter metadata from the content and return it as a dict."""
+        if not self.collect_metadata:
+            return {}
+
+        match = self.FRONT_MATTER_REGEX.search(content)
+        if not match:
+            return {}
+
+        placeholders: Dict[str, str] = {}
+        replace_template_var = functools.partial(
+            self._replace_template_var, placeholders
+        )
+        front_matter_text = self.TEMPLATE_VARIABLE_REGEX.sub(
+            replace_template_var, match.group(1)
+        )
+
+        try:
+            front_matter = yaml.safe_load(front_matter_text)
+            front_matter = self._restore_template_vars(front_matter, placeholders)
+
+            # If tags are a string, split them into a list
+            if "tags" in front_matter and isinstance(front_matter["tags"], str):
+                front_matter["tags"] = front_matter["tags"].split(", ")
+
+            return front_matter
+        except yaml.parser.ParserError:
+            logger.warning("Encountered non-yaml frontmatter")
+            return {}
+
+    def _to_langchain_compatible_metadata(self, metadata: dict) -> dict:
+        """Convert a dictionary to a compatible with langchain."""
+        result = {}
+        for key, value in metadata.items():
+            if type(value) in {str, int, float}:
+                result[key] = value
+            else:
+                result[key] = str(value)
+        return result
+
+    def _parse_document_tags(self, content: str) -> set:
+        """Return a set of all tags in within the document."""
+        if not self.collect_metadata:
+            return set()
+
+        match = self.TAG_REGEX.findall(content)
+        if not match:
+            return set()
+
+        return {tag for tag in match}
+
+    def _parse_dataview_fields(self, content: str) -> dict:
+        """Parse obsidian dataview plugin fields from the content and return it
+        as a dict."""
+        if not self.collect_metadata:
+            return {}
+
+        return {
+            **{
+                match[0]: match[1]
+                for match in self.DATAVIEW_LINE_REGEX.findall(content)
+            },
+            **{
+                match[0]: match[1]
+                for match in self.DATAVIEW_INLINE_PAREN_REGEX.findall(content)
+            },
+            **{
+                match[0]: match[1]
+                for match in self.DATAVIEW_INLINE_BRACKET_REGEX.findall(content)
+            },
+        }
+
+    def _remove_front_matter(self, content: str) -> str:
+        """Remove front matter metadata from the given content."""
+        if not self.collect_metadata:
+            return content
+        return self.FRONT_MATTER_REGEX.sub("", content)
+
+    def lazy_load(self) -> Iterator[Document]:
+        paths = list(Path(self.file_path).glob("**/*.md"))
+        for path in paths:
+            with open(path, encoding=self.encoding) as f:
+                text = f.read()
+
+            front_matter = self._parse_front_matter(text)
+            tags = self._parse_document_tags(text)
+            dataview_fields = self._parse_dataview_fields(text)
+            text = self._remove_front_matter(text)
+            metadata = {
+                "source": str(path.name),
+                "path": str(path),
+                "created": path.stat().st_ctime,
+                "last_modified": path.stat().st_mtime,
+                "last_accessed": path.stat().st_atime,
+                **self._to_langchain_compatible_metadata(front_matter),
+                **dataview_fields,
+            }
+
+            if tags or front_matter.get("tags"):
+                metadata["tags"] = ",".join(
+                    tags | set(front_matter.get("tags", []) or [])
+                )
+
+            yield Document(page_content=text, metadata=metadata)
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/__init__.py b/llm/Lib/site-packages/langchain_community/document_transformers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6336d8260257e23a838c7d8bb6e0da9e757db07b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_transformers/__init__.py
@@ -0,0 +1,93 @@
+"""**Document Transformers** are classes to transform Documents.
+
+**Document Transformers** usually used to transform a lot of Documents in a single run.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseDocumentTransformer --> <name>  # Examples: DoctranQATransformer, DoctranTextTranslator
+
+**Main helpers:**
+
+.. code-block::
+
+    Document
+"""  # noqa: E501
+
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.document_transformers.beautiful_soup_transformer import (
+        BeautifulSoupTransformer,  # noqa: F401
+    )
+    from langchain_community.document_transformers.doctran_text_extract import (
+        DoctranPropertyExtractor,  # noqa: F401
+    )
+    from langchain_community.document_transformers.doctran_text_qa import (
+        DoctranQATransformer,  # noqa: F401
+    )
+    from langchain_community.document_transformers.doctran_text_translate import (
+        DoctranTextTranslator,  # noqa: F401
+    )
+    from langchain_community.document_transformers.embeddings_redundant_filter import (
+        EmbeddingsClusteringFilter,  # noqa: F401
+        EmbeddingsRedundantFilter,  # noqa: F401
+        get_stateful_documents,  # noqa: F401
+    )
+    from langchain_community.document_transformers.google_translate import (
+        GoogleTranslateTransformer,  # noqa: F401
+    )
+    from langchain_community.document_transformers.html2text import (
+        Html2TextTransformer,  # noqa: F401
+    )
+    from langchain_community.document_transformers.long_context_reorder import (
+        LongContextReorder,  # noqa: F401
+    )
+    from langchain_community.document_transformers.nuclia_text_transform import (
+        NucliaTextTransformer,  # noqa: F401
+    )
+    from langchain_community.document_transformers.openai_functions import (
+        OpenAIMetadataTagger,  # noqa: F401
+    )
+
+__all__ = [
+    "BeautifulSoupTransformer",
+    "DoctranPropertyExtractor",
+    "DoctranQATransformer",
+    "DoctranTextTranslator",
+    "EmbeddingsClusteringFilter",
+    "EmbeddingsRedundantFilter",
+    "GoogleTranslateTransformer",
+    "Html2TextTransformer",
+    "LongContextReorder",
+    "NucliaTextTransformer",
+    "OpenAIMetadataTagger",
+    "get_stateful_documents",
+]
+
+_module_lookup = {
+    "BeautifulSoupTransformer": "langchain_community.document_transformers.beautiful_soup_transformer",  # noqa: E501
+    "DoctranPropertyExtractor": "langchain_community.document_transformers.doctran_text_extract",  # noqa: E501
+    "DoctranQATransformer": "langchain_community.document_transformers.doctran_text_qa",
+    "DoctranTextTranslator": "langchain_community.document_transformers.doctran_text_translate",  # noqa: E501
+    "EmbeddingsClusteringFilter": "langchain_community.document_transformers.embeddings_redundant_filter",  # noqa: E501
+    "EmbeddingsRedundantFilter": "langchain_community.document_transformers.embeddings_redundant_filter",  # noqa: E501
+    "GoogleTranslateTransformer": "langchain_community.document_transformers.google_translate",  # noqa: E501
+    "Html2TextTransformer": "langchain_community.document_transformers.html2text",
+    "LongContextReorder": "langchain_community.document_transformers.long_context_reorder",  # noqa: E501
+    "NucliaTextTransformer": "langchain_community.document_transformers.nuclia_text_transform",  # noqa: E501
+    "OpenAIMetadataTagger": "langchain_community.document_transformers.openai_functions",  # noqa: E501
+    "get_stateful_documents": "langchain_community.document_transformers.embeddings_redundant_filter",  # noqa: E501
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e7a5cc0f8f424c7cf613f868978918e638acc8b9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/beautiful_soup_transformer.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/beautiful_soup_transformer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a4378afa020d3d1277596eedb486d6fc9534ce24
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/beautiful_soup_transformer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/doctran_text_extract.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/doctran_text_extract.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..26e8f24c59f0e4b982ca42ecc973819be2ae7e09
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/doctran_text_extract.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/doctran_text_qa.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/doctran_text_qa.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ad91f3bef7ae0e3becbeb9bd5aeaadddcff77149
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/doctran_text_qa.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/doctran_text_translate.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/doctran_text_translate.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a5b36e71aae3cd072c129b880b76777a681ca886
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/doctran_text_translate.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/embeddings_redundant_filter.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/embeddings_redundant_filter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9a9c23cf34cf6c6452c8e1ad94e3d52cd9895b4b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/embeddings_redundant_filter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/google_translate.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/google_translate.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fdb5059696f1b0ad376e0f6f9c9bb9facdbf9332
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/google_translate.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/html2text.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/html2text.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..767c1bf8b22747b030eec677930fac15116682f1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/html2text.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/long_context_reorder.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/long_context_reorder.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eec55550ae6e42195a870507856fc0fc8087380d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/long_context_reorder.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/nuclia_text_transform.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/nuclia_text_transform.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e3cf110fdc5995045f3e9ce545cd19f9c533408b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/nuclia_text_transform.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/openai_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/openai_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..71fa3bbdc6a6aa479f61af1b1bdd5cc7d975f8a0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/document_transformers/__pycache__/openai_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/beautiful_soup_transformer.py b/llm/Lib/site-packages/langchain_community/document_transformers/beautiful_soup_transformer.py
new file mode 100644
index 0000000000000000000000000000000000000000..b70af98789851c8616aa784ff3bc05718bb8e17f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_transformers/beautiful_soup_transformer.py
@@ -0,0 +1,170 @@
+from typing import Any, Iterator, List, Sequence, cast
+
+from langchain_core.documents import BaseDocumentTransformer, Document
+
+
+class BeautifulSoupTransformer(BaseDocumentTransformer):
+    """Transform HTML content by extracting specific tags and removing unwanted ones.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.document_transformers import BeautifulSoupTransformer
+
+            bs4_transformer = BeautifulSoupTransformer()
+            docs_transformed = bs4_transformer.transform_documents(docs)
+    """  # noqa: E501
+
+    def __init__(self) -> None:
+        """
+        Initialize the transformer.
+
+        This checks if the BeautifulSoup4 package is installed.
+        If not, it raises an ImportError.
+        """
+        try:
+            import bs4  # noqa:F401
+        except ImportError:
+            raise ImportError(
+                "BeautifulSoup4 is required for BeautifulSoupTransformer. "
+                "Please install it with `pip install beautifulsoup4`."
+            )
+
+    def transform_documents(
+        self,
+        documents: Sequence[Document],
+        unwanted_tags: List[str] = ["script", "style"],
+        tags_to_extract: List[str] = ["p", "li", "div", "a"],
+        remove_lines: bool = True,
+        *,
+        remove_comments: bool = False,
+        **kwargs: Any,
+    ) -> Sequence[Document]:
+        """
+        Transform a list of Document objects by cleaning their HTML content.
+
+        Args:
+            documents: A sequence of Document objects containing HTML content.
+            unwanted_tags: A list of tags to be removed from the HTML.
+            tags_to_extract: A list of tags whose content will be extracted.
+            remove_lines: If set to True, unnecessary lines will be removed.
+            remove_comments: If set to True, comments will be removed.
+
+        Returns:
+            A sequence of Document objects with transformed content.
+        """
+        for doc in documents:
+            cleaned_content = doc.page_content
+
+            cleaned_content = self.remove_unwanted_tags(cleaned_content, unwanted_tags)
+
+            cleaned_content = self.extract_tags(
+                cleaned_content, tags_to_extract, remove_comments=remove_comments
+            )
+
+            if remove_lines:
+                cleaned_content = self.remove_unnecessary_lines(cleaned_content)
+
+            doc.page_content = cleaned_content
+
+        return documents
+
+    @staticmethod
+    def remove_unwanted_tags(html_content: str, unwanted_tags: List[str]) -> str:
+        """
+        Remove unwanted tags from a given HTML content.
+
+        Args:
+            html_content: The original HTML content string.
+            unwanted_tags: A list of tags to be removed from the HTML.
+
+        Returns:
+            A cleaned HTML string with unwanted tags removed.
+        """
+        from bs4 import BeautifulSoup
+
+        soup = BeautifulSoup(html_content, "html.parser")
+        for tag in unwanted_tags:
+            for element in soup.find_all(tag):
+                element.decompose()
+        return str(soup)
+
+    @staticmethod
+    def extract_tags(
+        html_content: str, tags: List[str], *, remove_comments: bool = False
+    ) -> str:
+        """
+        Extract specific tags from a given HTML content.
+
+        Args:
+            html_content: The original HTML content string.
+            tags: A list of tags to be extracted from the HTML.
+
+        Returns:
+            A string combining the content of the extracted tags.
+        """
+        from bs4 import BeautifulSoup
+
+        soup = BeautifulSoup(html_content, "html.parser")
+        text_parts: List[str] = []
+        for element in soup.find_all():
+            if element.name in tags:
+                # Extract all navigable strings recursively from this element.
+                text_parts += get_navigable_strings(
+                    element, remove_comments=remove_comments
+                )
+
+                # To avoid duplicate text, remove all descendants from the soup.
+                element.decompose()
+
+        return " ".join(text_parts)
+
+    @staticmethod
+    def remove_unnecessary_lines(content: str) -> str:
+        """
+        Clean up the content by removing unnecessary lines.
+
+        Args:
+            content: A string, which may contain unnecessary lines or spaces.
+
+        Returns:
+            A cleaned string with unnecessary lines removed.
+        """
+        lines = content.split("\n")
+        stripped_lines = [line.strip() for line in lines]
+        non_empty_lines = [line for line in stripped_lines if line]
+        cleaned_content = " ".join(non_empty_lines)
+        return cleaned_content
+
+    async def atransform_documents(
+        self,
+        documents: Sequence[Document],
+        **kwargs: Any,
+    ) -> Sequence[Document]:
+        raise NotImplementedError
+
+
+def get_navigable_strings(
+    element: Any, *, remove_comments: bool = False
+) -> Iterator[str]:
+    """Get all navigable strings from a BeautifulSoup element.
+
+    Args:
+        element: A BeautifulSoup element.
+
+    Returns:
+        A generator of strings.
+    """
+
+    from bs4 import Comment, NavigableString, Tag
+
+    for child in cast(Tag, element).children:
+        if isinstance(child, Comment) and remove_comments:
+            continue
+        if isinstance(child, Tag):
+            yield from get_navigable_strings(child, remove_comments=remove_comments)
+        elif isinstance(child, NavigableString):
+            if (element.name == "a") and (href := element.get("href")):
+                yield f"{child.strip()} ({href})"
+            else:
+                yield child.strip()
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/doctran_text_extract.py b/llm/Lib/site-packages/langchain_community/document_transformers/doctran_text_extract.py
new file mode 100644
index 0000000000000000000000000000000000000000..e942eafdde85d47d2217128eb4a86ba527062db5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_transformers/doctran_text_extract.py
@@ -0,0 +1,114 @@
+from typing import Any, List, Optional, Sequence
+
+from langchain_core.documents import BaseDocumentTransformer, Document
+from langchain_core.utils import get_from_env
+
+
+class DoctranPropertyExtractor(BaseDocumentTransformer):
+    """Extract properties from text documents using doctran.
+
+    Arguments:
+        properties: A list of the properties to extract.
+        openai_api_key: OpenAI API key. Can also be specified via environment variable
+            ``OPENAI_API_KEY``.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.document_transformers import DoctranPropertyExtractor
+
+            properties = [
+                {
+                    "name": "category",
+                    "description": "What type of email this is.",
+                    "type": "string",
+                    "enum": ["update", "action_item", "customer_feedback", "announcement", "other"],
+                    "required": True,
+                },
+                {
+                    "name": "mentions",
+                    "description": "A list of all people mentioned in this email.",
+                    "type": "array",
+                    "items": {
+                        "name": "full_name",
+                        "description": "The full name of the person mentioned.",
+                        "type": "string",
+                    },
+                    "required": True,
+                },
+                {
+                    "name": "eli5",
+                    "description": "Explain this email to me like I'm 5 years old.",
+                    "type": "string",
+                    "required": True,
+                },
+            ]
+
+            # Pass in openai_api_key or set env var OPENAI_API_KEY
+            property_extractor = DoctranPropertyExtractor(properties)
+            transformed_document = await qa_transformer.atransform_documents(documents)
+    """  # noqa: E501
+
+    def __init__(
+        self,
+        properties: List[dict],
+        openai_api_key: Optional[str] = None,
+        openai_api_model: Optional[str] = None,
+    ) -> None:
+        self.properties = properties
+        self.openai_api_key = openai_api_key or get_from_env(
+            "openai_api_key", "OPENAI_API_KEY"
+        )
+        self.openai_api_model = openai_api_model or get_from_env(
+            "openai_api_model", "OPENAI_API_MODEL"
+        )
+
+    async def atransform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        """Extracts properties from text documents using doctran."""
+        try:
+            from doctran import Doctran, ExtractProperty
+
+            doctran = Doctran(
+                openai_api_key=self.openai_api_key, openai_model=self.openai_api_model
+            )
+        except ImportError:
+            raise ImportError(
+                "Install doctran to use this parser. (pip install doctran)"
+            )
+        properties = [ExtractProperty(**property) for property in self.properties]
+        for d in documents:
+            doctran_doc = (
+                doctran.parse(content=d.page_content)
+                .extract(properties=properties)
+                .execute()
+            )
+
+            d.metadata["extracted_properties"] = doctran_doc.extracted_properties
+        return documents
+
+    def transform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        """Extracts properties from text documents using doctran."""
+        try:
+            from doctran import Doctran, ExtractProperty
+
+            doctran = Doctran(
+                openai_api_key=self.openai_api_key, openai_model=self.openai_api_model
+            )
+        except ImportError:
+            raise ImportError(
+                "Install doctran to use this parser. (pip install doctran)"
+            )
+        properties = [ExtractProperty(**property) for property in self.properties]
+        for d in documents:
+            doctran_doc = (
+                doctran.parse(content=d.page_content)
+                .extract(properties=properties)
+                .execute()
+            )
+
+            d.metadata["extracted_properties"] = doctran_doc.extracted_properties
+        return documents
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/doctran_text_qa.py b/llm/Lib/site-packages/langchain_community/document_transformers/doctran_text_qa.py
new file mode 100644
index 0000000000000000000000000000000000000000..53f0c001671fc8a8dece9914a84e9c6a0b9717df
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_transformers/doctran_text_qa.py
@@ -0,0 +1,61 @@
+from typing import Any, Optional, Sequence
+
+from langchain_core.documents import BaseDocumentTransformer, Document
+from langchain_core.utils import get_from_env
+
+
+class DoctranQATransformer(BaseDocumentTransformer):
+    """Extract QA from text documents using doctran.
+
+    Arguments:
+        openai_api_key: OpenAI API key. Can also be specified via environment variable
+            ``OPENAI_API_KEY``.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.document_transformers import DoctranQATransformer
+
+            # Pass in openai_api_key or set env var OPENAI_API_KEY
+            qa_transformer = DoctranQATransformer()
+            transformed_document = await qa_transformer.atransform_documents(documents)
+    """
+
+    def __init__(
+        self,
+        openai_api_key: Optional[str] = None,
+        openai_api_model: Optional[str] = None,
+    ) -> None:
+        self.openai_api_key = openai_api_key or get_from_env(
+            "openai_api_key", "OPENAI_API_KEY"
+        )
+        self.openai_api_model = openai_api_model or get_from_env(
+            "openai_api_model", "OPENAI_API_MODEL"
+        )
+
+    async def atransform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        raise NotImplementedError
+
+    def transform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        """Extracts QA from text documents using doctran."""
+        try:
+            from doctran import Doctran
+
+            doctran = Doctran(
+                openai_api_key=self.openai_api_key, openai_model=self.openai_api_model
+            )
+        except ImportError:
+            raise ImportError(
+                "Install doctran to use this parser. (pip install doctran)"
+            )
+        for d in documents:
+            doctran_doc = doctran.parse(content=d.page_content).interrogate().execute()
+            questions_and_answers = doctran_doc.extracted_properties.get(
+                "questions_and_answers"
+            )
+            d.metadata["questions_and_answers"] = questions_and_answers
+        return documents
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/doctran_text_translate.py b/llm/Lib/site-packages/langchain_community/document_transformers/doctran_text_translate.py
new file mode 100644
index 0000000000000000000000000000000000000000..8a48ab18836a163c1211af877e6fc4d308346075
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_transformers/doctran_text_translate.py
@@ -0,0 +1,67 @@
+from typing import Any, Optional, Sequence
+
+from langchain_core.documents import BaseDocumentTransformer, Document
+from langchain_core.utils import get_from_env
+
+
+class DoctranTextTranslator(BaseDocumentTransformer):
+    """Translate text documents using doctran.
+
+    Arguments:
+        openai_api_key: OpenAI API key. Can also be specified via environment variable
+        ``OPENAI_API_KEY``.
+        language: The language to translate *to*.
+
+    Example:
+        .. code-block:: python
+
+        from langchain_community.document_transformers import DoctranTextTranslator
+
+        # Pass in openai_api_key or set env var OPENAI_API_KEY
+        qa_translator = DoctranTextTranslator(language="spanish")
+        translated_document = await qa_translator.atransform_documents(documents)
+    """
+
+    def __init__(
+        self,
+        openai_api_key: Optional[str] = None,
+        language: str = "english",
+        openai_api_model: Optional[str] = None,
+    ) -> None:
+        self.openai_api_key = openai_api_key or get_from_env(
+            "openai_api_key", "OPENAI_API_KEY"
+        )
+        self.openai_api_model = openai_api_model or get_from_env(
+            "openai_api_model", "OPENAI_API_MODEL"
+        )
+        self.language = language
+
+    async def atransform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        raise NotImplementedError
+
+    def transform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        """Translates text documents using doctran."""
+        try:
+            from doctran import Doctran
+
+            doctran = Doctran(
+                openai_api_key=self.openai_api_key, openai_model=self.openai_api_model
+            )
+        except ImportError:
+            raise ImportError(
+                "Install doctran to use this parser. (pip install doctran)"
+            )
+        doctran_docs = [
+            doctran.parse(content=doc.page_content, metadata=doc.metadata)
+            for doc in documents
+        ]
+        for i, doc in enumerate(doctran_docs):
+            doctran_docs[i] = doc.translate(language=self.language).execute()
+        return [
+            Document(page_content=doc.transformed_content, metadata=doc.metadata)
+            for doc in doctran_docs
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/embeddings_redundant_filter.py b/llm/Lib/site-packages/langchain_community/document_transformers/embeddings_redundant_filter.py
new file mode 100644
index 0000000000000000000000000000000000000000..8e6cc89dc044a8c84a14d6e4fe94e7bcd4915af0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_transformers/embeddings_redundant_filter.py
@@ -0,0 +1,212 @@
+"""Transform documents"""
+from typing import Any, Callable, List, Sequence
+
+import numpy as np
+from langchain_core.documents import BaseDocumentTransformer, Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.utils.math import cosine_similarity
+
+
+class _DocumentWithState(Document):
+    """Wrapper for a document that includes arbitrary state."""
+
+    state: dict = Field(default_factory=dict)
+    """State associated with the document."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    def to_document(self) -> Document:
+        """Convert the DocumentWithState to a Document."""
+        return Document(page_content=self.page_content, metadata=self.metadata)
+
+    @classmethod
+    def from_document(cls, doc: Document) -> "_DocumentWithState":
+        """Create a DocumentWithState from a Document."""
+        if isinstance(doc, cls):
+            return doc
+        return cls(page_content=doc.page_content, metadata=doc.metadata)
+
+
+def get_stateful_documents(
+    documents: Sequence[Document],
+) -> Sequence[_DocumentWithState]:
+    """Convert a list of documents to a list of documents with state.
+
+    Args:
+        documents: The documents to convert.
+
+    Returns:
+        A list of documents with state.
+    """
+    return [_DocumentWithState.from_document(doc) for doc in documents]
+
+
+def _filter_similar_embeddings(
+    embedded_documents: List[List[float]], similarity_fn: Callable, threshold: float
+) -> List[int]:
+    """Filter redundant documents based on the similarity of their embeddings."""
+    similarity = np.tril(similarity_fn(embedded_documents, embedded_documents), k=-1)
+    redundant = np.where(similarity > threshold)
+    redundant_stacked = np.column_stack(redundant)
+    redundant_sorted = np.argsort(similarity[redundant])[::-1]
+    included_idxs = set(range(len(embedded_documents)))
+    for first_idx, second_idx in redundant_stacked[redundant_sorted]:
+        if first_idx in included_idxs and second_idx in included_idxs:
+            # Default to dropping the second document of any highly similar pair.
+            included_idxs.remove(second_idx)
+    return list(sorted(included_idxs))
+
+
+def _get_embeddings_from_stateful_docs(
+    embeddings: Embeddings, documents: Sequence[_DocumentWithState]
+) -> List[List[float]]:
+    if len(documents) and "embedded_doc" in documents[0].state:
+        embedded_documents = [doc.state["embedded_doc"] for doc in documents]
+    else:
+        embedded_documents = embeddings.embed_documents(
+            [d.page_content for d in documents]
+        )
+        for doc, embedding in zip(documents, embedded_documents):
+            doc.state["embedded_doc"] = embedding
+    return embedded_documents
+
+
+def _filter_cluster_embeddings(
+    embedded_documents: List[List[float]],
+    num_clusters: int,
+    num_closest: int,
+    random_state: int,
+    remove_duplicates: bool,
+) -> List[int]:
+    """Filter documents based on proximity of their embeddings to clusters."""
+
+    try:
+        from sklearn.cluster import KMeans
+    except ImportError:
+        raise ImportError(
+            "sklearn package not found, please install it with "
+            "`pip install scikit-learn`"
+        )
+
+    kmeans = KMeans(n_clusters=num_clusters, random_state=random_state).fit(
+        embedded_documents
+    )
+    closest_indices = []
+
+    # Loop through the number of clusters you have
+    for i in range(num_clusters):
+        # Get the list of distances from that particular cluster center
+        distances = np.linalg.norm(
+            embedded_documents - kmeans.cluster_centers_[i], axis=1
+        )
+
+        # Find the indices of the two unique closest ones
+        # (using argsort to find the smallest 2 distances)
+        if remove_duplicates:
+            # Only add not duplicated vectors.
+            closest_indices_sorted = [
+                x
+                for x in np.argsort(distances)[:num_closest]
+                if x not in closest_indices
+            ]
+        else:
+            # Skip duplicates and add the next closest vector.
+            closest_indices_sorted = [
+                x for x in np.argsort(distances) if x not in closest_indices
+            ][:num_closest]
+
+        # Append that position closest indices list
+        closest_indices.extend(closest_indices_sorted)
+
+    return closest_indices
+
+
+class EmbeddingsRedundantFilter(BaseDocumentTransformer, BaseModel):
+    """Filter that drops redundant documents by comparing their embeddings."""
+
+    embeddings: Embeddings
+    """Embeddings to use for embedding document contents."""
+    similarity_fn: Callable = cosine_similarity
+    """Similarity function for comparing documents. Function expected to take as input
+    two matrices (List[List[float]]) and return a matrix of scores where higher values
+    indicate greater similarity."""
+    similarity_threshold: float = 0.95
+    """Threshold for determining when two documents are similar enough
+    to be considered redundant."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def transform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        """Filter down documents."""
+        stateful_documents = get_stateful_documents(documents)
+        embedded_documents = _get_embeddings_from_stateful_docs(
+            self.embeddings, stateful_documents
+        )
+        included_idxs = _filter_similar_embeddings(
+            embedded_documents, self.similarity_fn, self.similarity_threshold
+        )
+        return [stateful_documents[i] for i in sorted(included_idxs)]
+
+
+class EmbeddingsClusteringFilter(BaseDocumentTransformer, BaseModel):
+    """Perform K-means clustering on document vectors.
+    Returns an arbitrary number of documents closest to center."""
+
+    embeddings: Embeddings
+    """Embeddings to use for embedding document contents."""
+
+    num_clusters: int = 5
+    """Number of clusters. Groups of documents with similar meaning."""
+
+    num_closest: int = 1
+    """The number of closest vectors to return for each cluster center."""
+
+    random_state: int = 42
+    """Controls the random number generator used to initialize the cluster centroids.
+    If you set the random_state parameter to None, the KMeans algorithm will use a 
+    random number generator that is seeded with the current time. This means 
+    that the results of the KMeans algorithm will be different each time you 
+    run it."""
+
+    sorted: bool = False
+    """By default results are re-ordered "grouping" them by cluster, if sorted is true
+    result will be ordered by the original position from the retriever"""
+
+    remove_duplicates: bool = False
+    """ By default duplicated results are skipped and replaced by the next closest 
+    vector in the cluster. If remove_duplicates is true no replacement will be done:
+    This could dramatically reduce results when there is a lot of overlap between 
+    clusters.
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def transform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        """Filter down documents."""
+        stateful_documents = get_stateful_documents(documents)
+        embedded_documents = _get_embeddings_from_stateful_docs(
+            self.embeddings, stateful_documents
+        )
+        included_idxs = _filter_cluster_embeddings(
+            embedded_documents,
+            self.num_clusters,
+            self.num_closest,
+            self.random_state,
+            self.remove_duplicates,
+        )
+        results = sorted(included_idxs) if self.sorted else included_idxs
+        return [stateful_documents[i] for i in results]
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/google_translate.py b/llm/Lib/site-packages/langchain_community/document_transformers/google_translate.py
new file mode 100644
index 0000000000000000000000000000000000000000..d21cfd47de862c1fcbab270d6a41ccde0319c19f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_transformers/google_translate.py
@@ -0,0 +1,113 @@
+from typing import Any, Optional, Sequence
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import BaseDocumentTransformer, Document
+
+from langchain_community.utilities.vertexai import get_client_info
+
+
+@deprecated(
+    since="0.0.32",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.DocAIParser",
+)
+class GoogleTranslateTransformer(BaseDocumentTransformer):
+    """Translate text documents using Google Cloud Translation."""
+
+    def __init__(
+        self,
+        project_id: str,
+        *,
+        location: str = "global",
+        model_id: Optional[str] = None,
+        glossary_id: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+    ) -> None:
+        """
+        Arguments:
+            project_id: Google Cloud Project ID.
+            location: (Optional) Translate model location.
+            model_id: (Optional) Translate model ID to use.
+            glossary_id: (Optional) Translate glossary ID to use.
+            api_endpoint: (Optional) Regional endpoint to use.
+        """
+        try:
+            from google.api_core.client_options import ClientOptions
+            from google.cloud import translate
+        except ImportError as exc:
+            raise ImportError(
+                "Install Google Cloud Translate to use this parser."
+                "(pip install google-cloud-translate)"
+            ) from exc
+
+        self.project_id = project_id
+        self.location = location
+        self.model_id = model_id
+        self.glossary_id = glossary_id
+
+        self._client = translate.TranslationServiceClient(
+            client_info=get_client_info("translate"),
+            client_options=(
+                ClientOptions(api_endpoint=api_endpoint) if api_endpoint else None
+            ),
+        )
+        self._parent_path = self._client.common_location_path(project_id, location)
+        # For some reason, there's no `model_path()` method for the client.
+        self._model_path = (
+            f"{self._parent_path}/models/{model_id}" if model_id else None
+        )
+        self._glossary_path = (
+            self._client.glossary_path(project_id, location, glossary_id)
+            if glossary_id
+            else None
+        )
+
+    def transform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        """Translate text documents using Google Translate.
+
+        Arguments:
+            source_language_code: ISO 639 language code of the input document.
+            target_language_code: ISO 639 language code of the output document.
+                For supported languages, refer to:
+                https://cloud.google.com/translate/docs/languages
+            mime_type: (Optional) Media Type of input text.
+                Options: `text/plain`, `text/html`
+        """
+        try:
+            from google.cloud import translate
+        except ImportError as exc:
+            raise ImportError(
+                "Install Google Cloud Translate to use this parser."
+                "(pip install google-cloud-translate)"
+            ) from exc
+
+        response = self._client.translate_text(
+            request=translate.TranslateTextRequest(
+                contents=[doc.page_content for doc in documents],
+                parent=self._parent_path,
+                model=self._model_path,
+                glossary_config=translate.TranslateTextGlossaryConfig(
+                    glossary=self._glossary_path
+                ),
+                source_language_code=kwargs.get("source_language_code", None),
+                target_language_code=kwargs.get("target_language_code"),
+                mime_type=kwargs.get("mime_type", "text/plain"),
+            )
+        )
+
+        # If using a glossary, the translations will be in `glossary_translations`.
+        translations = response.glossary_translations or response.translations
+
+        return [
+            Document(
+                page_content=translation.translated_text,
+                metadata={
+                    **doc.metadata,
+                    "model": translation.model,
+                    "detected_language_code": translation.detected_language_code,
+                },
+            )
+            for doc, translation in zip(documents, translations)
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/html2text.py b/llm/Lib/site-packages/langchain_community/document_transformers/html2text.py
new file mode 100644
index 0000000000000000000000000000000000000000..cbf7cf366e4358e988926278a9b31e780c4cf3f2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_transformers/html2text.py
@@ -0,0 +1,56 @@
+from typing import Any, Sequence
+
+from langchain_core.documents import BaseDocumentTransformer, Document
+
+
+class Html2TextTransformer(BaseDocumentTransformer):
+    """Replace occurrences of a particular search pattern with a replacement string
+
+    Arguments:
+        ignore_links: Whether links should be ignored; defaults to True.
+        ignore_images: Whether images should be ignored; defaults to True.
+
+    Example:
+        .. code-block:: python
+            from langchain_community.document_transformers import Html2TextTransformer
+            html2text = Html2TextTransformer()
+            docs_transform = html2text.transform_documents(docs)
+    """
+
+    def __init__(self, ignore_links: bool = True, ignore_images: bool = True) -> None:
+        self.ignore_links = ignore_links
+        self.ignore_images = ignore_images
+
+    def transform_documents(
+        self,
+        documents: Sequence[Document],
+        **kwargs: Any,
+    ) -> Sequence[Document]:
+        try:
+            import html2text
+        except ImportError:
+            raise ImportError(
+                """html2text package not found, please 
+                install it with `pip install html2text`"""
+            )
+
+        # Create a html2text.HTML2Text object and override some properties
+        h = html2text.HTML2Text()
+        h.ignore_links = self.ignore_links
+        h.ignore_images = self.ignore_images
+
+        new_documents = []
+
+        for d in documents:
+            new_document = Document(
+                page_content=h.handle(d.page_content), metadata={**d.metadata}
+            )
+            new_documents.append(new_document)
+        return new_documents
+
+    async def atransform_documents(
+        self,
+        documents: Sequence[Document],
+        **kwargs: Any,
+    ) -> Sequence[Document]:
+        raise NotImplementedError
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/long_context_reorder.py b/llm/Lib/site-packages/langchain_community/document_transformers/long_context_reorder.py
new file mode 100644
index 0000000000000000000000000000000000000000..a047c2d143553e383a43a30a282bc41bea58bd2f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_transformers/long_context_reorder.py
@@ -0,0 +1,45 @@
+"""Reorder documents"""
+from typing import Any, List, Sequence
+
+from langchain_core.documents import BaseDocumentTransformer, Document
+from langchain_core.pydantic_v1 import BaseModel
+
+
+def _litm_reordering(documents: List[Document]) -> List[Document]:
+    """Lost in the middle reorder: the less relevant documents will be at the
+    middle of the list and more relevant elements at beginning / end.
+    See: https://arxiv.org/abs//2307.03172"""
+
+    documents.reverse()
+    reordered_result = []
+    for i, value in enumerate(documents):
+        if i % 2 == 1:
+            reordered_result.append(value)
+        else:
+            reordered_result.insert(0, value)
+    return reordered_result
+
+
+class LongContextReorder(BaseDocumentTransformer, BaseModel):
+    """Reorder long context.
+
+    Lost in the middle:
+    Performance degrades when models must access relevant information
+    in the middle of long contexts.
+    See: https://arxiv.org/abs//2307.03172"""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def transform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        """Reorders documents."""
+        return _litm_reordering(list(documents))
+
+    async def atransform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        raise NotImplementedError
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/nuclia_text_transform.py b/llm/Lib/site-packages/langchain_community/document_transformers/nuclia_text_transform.py
new file mode 100644
index 0000000000000000000000000000000000000000..47ef5709f6cd422b44fb75c03d37a1e9d87f5261
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_transformers/nuclia_text_transform.py
@@ -0,0 +1,49 @@
+import asyncio
+import json
+import uuid
+from typing import Any, Sequence
+
+from langchain_core.documents import BaseDocumentTransformer, Document
+
+from langchain_community.tools.nuclia.tool import NucliaUnderstandingAPI
+
+
+class NucliaTextTransformer(BaseDocumentTransformer):
+    """Nuclia Text Transformer.
+
+    The Nuclia Understanding API splits into paragraphs and sentences,
+    identifies entities, provides a summary of the text and generates
+    embeddings for all sentences.
+    """
+
+    def __init__(self, nua: NucliaUnderstandingAPI):
+        self.nua = nua
+
+    def transform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        raise NotImplementedError
+
+    async def atransform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        tasks = [
+            self.nua.arun(
+                {
+                    "action": "push",
+                    "id": str(uuid.uuid4()),
+                    "text": doc.page_content,
+                    "path": None,
+                }
+            )
+            for doc in documents
+        ]
+        results = await asyncio.gather(*tasks)
+        for doc, result in zip(documents, results):
+            obj = json.loads(result)
+            metadata = {
+                "file": obj["file_extracted_data"][0],
+                "metadata": obj["field_metadata"][0],
+            }
+            doc.metadata["nuclia"] = metadata
+        return documents
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/openai_functions.py b/llm/Lib/site-packages/langchain_community/document_transformers/openai_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..5c9dec22e6167e9b3ddb725aae60dabea064613b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_transformers/openai_functions.py
@@ -0,0 +1,141 @@
+"""Document transformers that use OpenAI Functions models"""
+from typing import Any, Dict, Optional, Sequence, Type, Union
+
+from langchain_core.documents import BaseDocumentTransformer, Document
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.prompts import ChatPromptTemplate
+from langchain_core.pydantic_v1 import BaseModel
+
+
+class OpenAIMetadataTagger(BaseDocumentTransformer, BaseModel):
+    """Extract metadata tags from document contents using OpenAI functions.
+
+    Example:
+        .. code-block:: python
+
+                from langchain_community.chat_models import ChatOpenAI
+                from langchain_community.document_transformers import OpenAIMetadataTagger
+                from langchain_core.documents import Document
+
+                schema = {
+                    "properties": {
+                        "movie_title": { "type": "string" },
+                        "critic": { "type": "string" },
+                        "tone": {
+                            "type": "string",
+                            "enum": ["positive", "negative"]
+                        },
+                        "rating": {
+                            "type": "integer",
+                            "description": "The number of stars the critic rated the movie"
+                        }
+                    },
+                    "required": ["movie_title", "critic", "tone"]
+                }
+
+                # Must be an OpenAI model that supports functions
+                llm = ChatOpenAI(temperature=0, model="gpt-3.5-turbo-0613")
+                tagging_chain = create_tagging_chain(schema, llm)
+                document_transformer = OpenAIMetadataTagger(tagging_chain=tagging_chain)
+                original_documents = [
+                    Document(page_content="Review of The Bee Movie\nBy Roger Ebert\n\nThis is the greatest movie ever made. 4 out of 5 stars."),
+                    Document(page_content="Review of The Godfather\nBy Anonymous\n\nThis movie was super boring. 1 out of 5 stars.", metadata={"reliable": False}),
+                ]
+
+                enhanced_documents = document_transformer.transform_documents(original_documents)
+    """  # noqa: E501
+
+    tagging_chain: Any
+    """The chain used to extract metadata from each document."""
+
+    def transform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        """Automatically extract and populate metadata
+        for each document according to the provided schema."""
+
+        new_documents = []
+
+        for document in documents:
+            extracted_metadata: Dict = self.tagging_chain.run(document.page_content)  # type: ignore[assignment]  # noqa: E501
+            new_document = Document(
+                page_content=document.page_content,
+                metadata={**extracted_metadata, **document.metadata},
+            )
+            new_documents.append(new_document)
+        return new_documents
+
+    async def atransform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        raise NotImplementedError
+
+
+def create_metadata_tagger(
+    metadata_schema: Union[Dict[str, Any], Type[BaseModel]],
+    llm: BaseLanguageModel,
+    prompt: Optional[ChatPromptTemplate] = None,
+    *,
+    tagging_chain_kwargs: Optional[Dict] = None,
+) -> OpenAIMetadataTagger:
+    """Create a DocumentTransformer that uses an OpenAI function chain to automatically
+        tag documents with metadata based on their content and an input schema.
+
+    Args:
+        metadata_schema: Either a dictionary or pydantic.BaseModel class. If a dictionary
+            is passed in, it's assumed to already be a valid JsonSchema.
+            For best results, pydantic.BaseModels should have docstrings describing what
+            the schema represents and descriptions for the parameters.
+        llm: Language model to use, assumed to support the OpenAI function-calling API.
+            Defaults to use "gpt-3.5-turbo-0613"
+        prompt: BasePromptTemplate to pass to the model.
+
+    Returns:
+        An LLMChain that will pass the given function to the model.
+
+    Example:
+        .. code-block:: python
+
+                from langchain_community.chat_models import ChatOpenAI
+                from langchain_community.document_transformers import create_metadata_tagger
+                from langchain_core.documents import Document
+
+                schema = {
+                    "properties": {
+                        "movie_title": { "type": "string" },
+                        "critic": { "type": "string" },
+                        "tone": {
+                            "type": "string",
+                            "enum": ["positive", "negative"]
+                        },
+                        "rating": {
+                            "type": "integer",
+                            "description": "The number of stars the critic rated the movie"
+                        }
+                    },
+                    "required": ["movie_title", "critic", "tone"]
+                }
+
+                # Must be an OpenAI model that supports functions
+                llm = ChatOpenAI(temperature=0, model="gpt-3.5-turbo-0613")
+
+                document_transformer = create_metadata_tagger(schema, llm)
+                original_documents = [
+                    Document(page_content="Review of The Bee Movie\nBy Roger Ebert\n\nThis is the greatest movie ever made. 4 out of 5 stars."),
+                    Document(page_content="Review of The Godfather\nBy Anonymous\n\nThis movie was super boring. 1 out of 5 stars.", metadata={"reliable": False}),
+                ]
+
+                enhanced_documents = document_transformer.transform_documents(original_documents)
+    """  # noqa: E501
+    from langchain.chains.openai_functions import create_tagging_chain
+
+    metadata_schema = (
+        metadata_schema
+        if isinstance(metadata_schema, dict)
+        else metadata_schema.schema()
+    )
+    _tagging_chain_kwargs = tagging_chain_kwargs or {}
+    tagging_chain = create_tagging_chain(
+        metadata_schema, llm, prompt=prompt, **_tagging_chain_kwargs
+    )
+    return OpenAIMetadataTagger(tagging_chain=tagging_chain)
diff --git a/llm/Lib/site-packages/langchain_community/document_transformers/xsl/html_chunks_with_headers.xslt b/llm/Lib/site-packages/langchain_community/document_transformers/xsl/html_chunks_with_headers.xslt
new file mode 100644
index 0000000000000000000000000000000000000000..285edfe892db95c6f27275aa9af0a0f94dd1271f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/document_transformers/xsl/html_chunks_with_headers.xslt
@@ -0,0 +1,199 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!-- HTML PRE CHUNK:
+This performs a best-effort preliminary "chunking" of text in an HTML file,
+matching each chunk with a "headers" metadata value based on header tags in proximity.
+
+recursively visits every element (template mode=list).
+for every element with tagname of interest (only):
+1. serializes a div (and metadata marking the element's xpath).
+2. calculates all text-content for the given element, including descendant elements which are *not* themselves tags of interest.
+3. if any such text-content was found, serializes a "headers" (span.headers) along with this text (span.chunk).
+
+to calculate the "headers" of an element:
+1. recursively gets the *nearest* prior-siblings for headings of *each* level
+2. recursively repeats that step#1 for each ancestor (regardless of tag)
+n.b. this recursion is only performed (beginning with) elements which are
+both (1) tags-of-interest and (2) have their own text-content.
+-->
+<xsl:stylesheet version="1.0"
+	xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+	xmlns="http://www.w3.org/1999/xhtml">
+	
+	<xsl:param name="tags">div|p|blockquote|ol|ul</xsl:param>
+	
+	<xsl:template match="/">
+		<html>
+			<head>
+				<style>
+					div {
+						border: solid;
+						margin-top: .5em;
+						padding-left: .5em;
+					}
+					
+					h1, h2, h3, h4, h5, h6 {
+						margin: 0;
+					}
+					
+					.xpath {
+						color: blue;
+					}
+					.chunk {
+						margin: .5em 1em;
+					}
+				</style>
+			</head>
+			<body>
+				<!-- create "filtered tree" with only tags of interest -->
+				<xsl:apply-templates select="*" />
+			</body>
+		</html>
+	</xsl:template>
+	
+	<xsl:template match="*">
+		<xsl:choose>
+			<!-- tags of interest get serialized into the filtered tree (and recurse down child elements) -->
+			<xsl:when test="contains(
+				concat('|', $tags, '|'),
+				concat('|', local-name(), '|'))">
+			
+				<xsl:variable name="xpath">
+					<xsl:apply-templates mode="xpath" select="." />
+				</xsl:variable>
+				<xsl:variable name="txt">
+					<!-- recurse down child text-nodes and elements -->
+					<xsl:apply-templates mode="text" />
+				</xsl:variable>
+				<xsl:variable name="txt-norm" select="normalize-space($txt)" />
+				
+				<div title="{$xpath}">
+					
+					<small class="xpath">
+						<xsl:value-of select="$xpath" />
+					</small>
+					
+					<xsl:if test="$txt-norm">
+						<xsl:variable name="headers">
+							<xsl:apply-templates mode="headingsWithAncestors" select="." />
+						</xsl:variable>
+						
+						<xsl:if test="normalize-space($headers)">
+							<span class="headers">
+								<xsl:copy-of select="$headers" />
+							</span>
+						</xsl:if>
+					
+						<p class="chunk">
+							<xsl:value-of select="$txt-norm" />
+						</p>
+					</xsl:if>
+					
+					<xsl:apply-templates select="*" />
+				</div>
+			</xsl:when>
+			
+			<!-- all other tags get "skipped" and recurse down child elements -->
+			<xsl:otherwise>
+				<xsl:apply-templates select="*" />
+			</xsl:otherwise>
+		</xsl:choose>
+	</xsl:template>
+	
+	
+	<!-- text mode:
+	prints text nodes;
+	for elements, recurses down child nodes (text and elements) *except* certain exceptions:
+		tags of interest (handled in their own list-mode match),
+		non-content text (e.g. script|style)
+	-->
+	
+	<!-- ignore non-content text -->
+	<xsl:template mode="text" match="
+		script|style" />
+	<!-- for all other elements *except tags of interest*, recurse on child-nodes (text and elements) -->
+	<xsl:template mode="text" match="*">
+		<xsl:choose>
+			<!-- ignore tags of interest -->
+			<xsl:when test="contains(
+				concat('|', $tags, '|'),
+				concat('|', local-name(), '|'))" />
+			
+			<xsl:otherwise>
+				<xsl:apply-templates mode="text" />
+			</xsl:otherwise>
+		</xsl:choose>
+	</xsl:template>
+	
+	
+	<!-- xpath mode:
+	return an xpath which matches this element uniquely
+	-->
+	<xsl:template mode="xpath" match="*">
+		<!-- recurse up parents -->
+		<xsl:apply-templates mode="xpath" select="parent::*" />
+		
+		<xsl:value-of select="name()" />
+		<xsl:text>[</xsl:text>
+		<xsl:value-of select="1+count(preceding-sibling::*)" />
+		<xsl:text>]/</xsl:text>
+	</xsl:template>
+	
+	
+	<!-- headingsWithAncestors mode:
+	recurses up parents (ALL ancestors)
+	-->
+	<xsl:template mode="headingsWithAncestors" match="*">
+		<!-- recurse -->
+		<xsl:apply-templates mode="headingsWithAncestors" select="parent::*" />
+		
+		<xsl:apply-templates mode="headingsWithPriorSiblings" select=".">
+			<xsl:with-param name="maxHead" select="6" />
+		</xsl:apply-templates>
+	</xsl:template>
+	
+	
+	<!-- headingsWithPriorSiblings mode:
+	recurses up preceding-siblings
+	-->
+	<xsl:template mode="headingsWithPriorSiblings" match="*">
+		<xsl:param name="maxHead" />
+		<xsl:variable name="headLevel" select="number(substring(local-name(), 2))" />
+		
+		<xsl:choose>
+			<xsl:when test="'h' = substring(local-name(), 1, 1) and $maxHead >= $headLevel">
+				
+				<!-- recurse up to prior sibling; max level one less than current -->
+				<xsl:apply-templates mode="headingsWithPriorSiblings" select="preceding-sibling::*[1]">
+					<xsl:with-param name="maxHead" select="$headLevel - 1" />
+				</xsl:apply-templates>
+				
+				<xsl:apply-templates mode="heading" select="." />
+				
+			</xsl:when>
+			
+			<!-- special case for 'header' tag, serialize child-headers -->
+			<xsl:when test="self::header">
+				<xsl:apply-templates mode="heading" select="h1|h2|h3|h4|h5|h6" />
+				<!--
+				we choose not to recurse further up prior-siblings in this case,
+				but n.b. the 'headingsWithAncestors' template above will still continue recursion.
+				-->
+			</xsl:when>
+			
+			<xsl:otherwise>
+				<!-- recurse up to prior sibling; no other work on this element -->
+				<xsl:apply-templates mode="headingsWithPriorSiblings" select="preceding-sibling::*[1]">
+					<xsl:with-param name="maxHead" select="$maxHead" />
+				</xsl:apply-templates>
+			</xsl:otherwise>
+			
+		</xsl:choose>
+	</xsl:template>
+	
+	<xsl:template mode="heading" match="h1|h2|h3|h4|h5|h6">
+		<xsl:copy>
+			<xsl:value-of select="normalize-space(.)" />
+		</xsl:copy>
+	</xsl:template>
+	
+</xsl:stylesheet>
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__init__.py b/llm/Lib/site-packages/langchain_community/embeddings/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bbbbf0f72c704d0f53065e0b43943f38706cff3a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/__init__.py
@@ -0,0 +1,397 @@
+"""**Embedding models**  are wrappers around embedding models
+from different APIs and services.
+
+**Embedding models** can be LLMs or not.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    Embeddings --> <name>Embeddings  # Examples: OpenAIEmbeddings, HuggingFaceEmbeddings
+"""
+
+import importlib
+import logging
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.embeddings.aleph_alpha import (
+        AlephAlphaAsymmetricSemanticEmbedding,  # noqa: F401
+        AlephAlphaSymmetricSemanticEmbedding,  # noqa: F401
+    )
+    from langchain_community.embeddings.anyscale import (
+        AnyscaleEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.awa import (
+        AwaEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.azure_openai import (
+        AzureOpenAIEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.baichuan import (
+        BaichuanTextEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.baidu_qianfan_endpoint import (
+        QianfanEmbeddingsEndpoint,  # noqa: F401
+    )
+    from langchain_community.embeddings.bedrock import (
+        BedrockEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.bookend import (
+        BookendEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.clarifai import (
+        ClarifaiEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.cohere import (
+        CohereEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.dashscope import (
+        DashScopeEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.databricks import (
+        DatabricksEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.deepinfra import (
+        DeepInfraEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.edenai import (
+        EdenAiEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.elasticsearch import (
+        ElasticsearchEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.embaas import (
+        EmbaasEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.ernie import (
+        ErnieEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.fake import (
+        DeterministicFakeEmbedding,  # noqa: F401
+        FakeEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.fastembed import (
+        FastEmbedEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.gigachat import (
+        GigaChatEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.google_palm import (
+        GooglePalmEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.gpt4all import (
+        GPT4AllEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.gradient_ai import (
+        GradientEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.huggingface import (
+        HuggingFaceBgeEmbeddings,  # noqa: F401
+        HuggingFaceEmbeddings,  # noqa: F401
+        HuggingFaceInferenceAPIEmbeddings,  # noqa: F401
+        HuggingFaceInstructEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.huggingface_hub import (
+        HuggingFaceHubEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.infinity import (
+        InfinityEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.infinity_local import (
+        InfinityEmbeddingsLocal,  # noqa: F401
+    )
+    from langchain_community.embeddings.itrex import (
+        QuantizedBgeEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.javelin_ai_gateway import (
+        JavelinAIGatewayEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.jina import (
+        JinaEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.johnsnowlabs import (
+        JohnSnowLabsEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.laser import (
+        LaserEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.llamacpp import (
+        LlamaCppEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.llamafile import (
+        LlamafileEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.llm_rails import (
+        LLMRailsEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.localai import (
+        LocalAIEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.minimax import (
+        MiniMaxEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.mlflow import (
+        MlflowCohereEmbeddings,  # noqa: F401
+        MlflowEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.mlflow_gateway import (
+        MlflowAIGatewayEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.modelscope_hub import (
+        ModelScopeEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.mosaicml import (
+        MosaicMLInstructorEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.nemo import (
+        NeMoEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.nlpcloud import (
+        NLPCloudEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.oci_generative_ai import (
+        OCIGenAIEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.octoai_embeddings import (
+        OctoAIEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.ollama import (
+        OllamaEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.openai import (
+        OpenAIEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.openvino import (
+        OpenVINOBgeEmbeddings,  # noqa: F401
+        OpenVINOEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.optimum_intel import (
+        QuantizedBiEncoderEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.premai import (
+        PremAIEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.sagemaker_endpoint import (
+        SagemakerEndpointEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.self_hosted import (
+        SelfHostedEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.self_hosted_hugging_face import (
+        SelfHostedHuggingFaceEmbeddings,  # noqa: F401
+        SelfHostedHuggingFaceInstructEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.sentence_transformer import (
+        SentenceTransformerEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.solar import (
+        SolarEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.spacy_embeddings import (
+        SpacyEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.sparkllm import (
+        SparkLLMTextEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.tensorflow_hub import (
+        TensorflowHubEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.vertexai import (
+        VertexAIEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.volcengine import (
+        VolcanoEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.voyageai import (
+        VoyageEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.xinference import (
+        XinferenceEmbeddings,  # noqa: F401
+    )
+    from langchain_community.embeddings.yandex import (
+        YandexGPTEmbeddings,  # noqa: F401
+    )
+
+__all__ = [
+    "AlephAlphaAsymmetricSemanticEmbedding",
+    "AlephAlphaSymmetricSemanticEmbedding",
+    "AnyscaleEmbeddings",
+    "AwaEmbeddings",
+    "AzureOpenAIEmbeddings",
+    "BaichuanTextEmbeddings",
+    "BedrockEmbeddings",
+    "BookendEmbeddings",
+    "ClarifaiEmbeddings",
+    "CohereEmbeddings",
+    "DashScopeEmbeddings",
+    "DatabricksEmbeddings",
+    "DeepInfraEmbeddings",
+    "DeterministicFakeEmbedding",
+    "EdenAiEmbeddings",
+    "ElasticsearchEmbeddings",
+    "EmbaasEmbeddings",
+    "ErnieEmbeddings",
+    "FakeEmbeddings",
+    "FastEmbedEmbeddings",
+    "GPT4AllEmbeddings",
+    "GigaChatEmbeddings",
+    "GooglePalmEmbeddings",
+    "GradientEmbeddings",
+    "HuggingFaceBgeEmbeddings",
+    "HuggingFaceEmbeddings",
+    "HuggingFaceHubEmbeddings",
+    "HuggingFaceInferenceAPIEmbeddings",
+    "HuggingFaceInstructEmbeddings",
+    "InfinityEmbeddings",
+    "InfinityEmbeddingsLocal",
+    "JavelinAIGatewayEmbeddings",
+    "JinaEmbeddings",
+    "JohnSnowLabsEmbeddings",
+    "LLMRailsEmbeddings",
+    "LaserEmbeddings",
+    "LlamaCppEmbeddings",
+    "LlamafileEmbeddings",
+    "LocalAIEmbeddings",
+    "MiniMaxEmbeddings",
+    "MlflowAIGatewayEmbeddings",
+    "MlflowCohereEmbeddings",
+    "MlflowEmbeddings",
+    "ModelScopeEmbeddings",
+    "MosaicMLInstructorEmbeddings",
+    "NLPCloudEmbeddings",
+    "NeMoEmbeddings",
+    "OCIGenAIEmbeddings",
+    "OctoAIEmbeddings",
+    "OllamaEmbeddings",
+    "OpenAIEmbeddings",
+    "OpenVINOBgeEmbeddings",
+    "OpenVINOEmbeddings",
+    "PremAIEmbeddings",
+    "QianfanEmbeddingsEndpoint",
+    "QuantizedBgeEmbeddings",
+    "QuantizedBiEncoderEmbeddings",
+    "SagemakerEndpointEmbeddings",
+    "SelfHostedEmbeddings",
+    "SelfHostedHuggingFaceEmbeddings",
+    "SelfHostedHuggingFaceInstructEmbeddings",
+    "SentenceTransformerEmbeddings",
+    "SolarEmbeddings",
+    "SpacyEmbeddings",
+    "SparkLLMTextEmbeddings",
+    "TensorflowHubEmbeddings",
+    "VertexAIEmbeddings",
+    "VolcanoEmbeddings",
+    "VoyageEmbeddings",
+    "XinferenceEmbeddings",
+    "YandexGPTEmbeddings",
+]
+
+_module_lookup = {
+    "AlephAlphaAsymmetricSemanticEmbedding": "langchain_community.embeddings.aleph_alpha",  # noqa: E501
+    "AlephAlphaSymmetricSemanticEmbedding": "langchain_community.embeddings.aleph_alpha",  # noqa: E501
+    "AnyscaleEmbeddings": "langchain_community.embeddings.anyscale",
+    "AwaEmbeddings": "langchain_community.embeddings.awa",
+    "AzureOpenAIEmbeddings": "langchain_community.embeddings.azure_openai",
+    "BaichuanTextEmbeddings": "langchain_community.embeddings.baichuan",
+    "BedrockEmbeddings": "langchain_community.embeddings.bedrock",
+    "BookendEmbeddings": "langchain_community.embeddings.bookend",
+    "ClarifaiEmbeddings": "langchain_community.embeddings.clarifai",
+    "CohereEmbeddings": "langchain_community.embeddings.cohere",
+    "DashScopeEmbeddings": "langchain_community.embeddings.dashscope",
+    "DatabricksEmbeddings": "langchain_community.embeddings.databricks",
+    "DeepInfraEmbeddings": "langchain_community.embeddings.deepinfra",
+    "DeterministicFakeEmbedding": "langchain_community.embeddings.fake",
+    "EdenAiEmbeddings": "langchain_community.embeddings.edenai",
+    "ElasticsearchEmbeddings": "langchain_community.embeddings.elasticsearch",
+    "EmbaasEmbeddings": "langchain_community.embeddings.embaas",
+    "ErnieEmbeddings": "langchain_community.embeddings.ernie",
+    "FakeEmbeddings": "langchain_community.embeddings.fake",
+    "FastEmbedEmbeddings": "langchain_community.embeddings.fastembed",
+    "GPT4AllEmbeddings": "langchain_community.embeddings.gpt4all",
+    "GooglePalmEmbeddings": "langchain_community.embeddings.google_palm",
+    "GradientEmbeddings": "langchain_community.embeddings.gradient_ai",
+    "GigaChatEmbeddings": "langchain_community.embeddings.gigachat",
+    "HuggingFaceBgeEmbeddings": "langchain_community.embeddings.huggingface",
+    "HuggingFaceEmbeddings": "langchain_community.embeddings.huggingface",
+    "HuggingFaceHubEmbeddings": "langchain_community.embeddings.huggingface_hub",
+    "HuggingFaceInferenceAPIEmbeddings": "langchain_community.embeddings.huggingface",
+    "HuggingFaceInstructEmbeddings": "langchain_community.embeddings.huggingface",
+    "InfinityEmbeddings": "langchain_community.embeddings.infinity",
+    "InfinityEmbeddingsLocal": "langchain_community.embeddings.infinity_local",
+    "JavelinAIGatewayEmbeddings": "langchain_community.embeddings.javelin_ai_gateway",
+    "JinaEmbeddings": "langchain_community.embeddings.jina",
+    "JohnSnowLabsEmbeddings": "langchain_community.embeddings.johnsnowlabs",
+    "LLMRailsEmbeddings": "langchain_community.embeddings.llm_rails",
+    "LaserEmbeddings": "langchain_community.embeddings.laser",
+    "LlamaCppEmbeddings": "langchain_community.embeddings.llamacpp",
+    "LlamafileEmbeddings": "langchain_community.embeddings.llamafile",
+    "LocalAIEmbeddings": "langchain_community.embeddings.localai",
+    "MiniMaxEmbeddings": "langchain_community.embeddings.minimax",
+    "MlflowAIGatewayEmbeddings": "langchain_community.embeddings.mlflow_gateway",
+    "MlflowCohereEmbeddings": "langchain_community.embeddings.mlflow",
+    "MlflowEmbeddings": "langchain_community.embeddings.mlflow",
+    "ModelScopeEmbeddings": "langchain_community.embeddings.modelscope_hub",
+    "MosaicMLInstructorEmbeddings": "langchain_community.embeddings.mosaicml",
+    "NLPCloudEmbeddings": "langchain_community.embeddings.nlpcloud",
+    "NeMoEmbeddings": "langchain_community.embeddings.nemo",
+    "OCIGenAIEmbeddings": "langchain_community.embeddings.oci_generative_ai",
+    "OctoAIEmbeddings": "langchain_community.embeddings.octoai_embeddings",
+    "OllamaEmbeddings": "langchain_community.embeddings.ollama",
+    "OpenAIEmbeddings": "langchain_community.embeddings.openai",
+    "OpenVINOEmbeddings": "langchain_community.embeddings.openvino",
+    "OpenVINOBgeEmbeddings": "langchain_community.embeddings.openvino",
+    "QianfanEmbeddingsEndpoint": "langchain_community.embeddings.baidu_qianfan_endpoint",  # noqa: E501
+    "QuantizedBgeEmbeddings": "langchain_community.embeddings.itrex",
+    "QuantizedBiEncoderEmbeddings": "langchain_community.embeddings.optimum_intel",
+    "SagemakerEndpointEmbeddings": "langchain_community.embeddings.sagemaker_endpoint",
+    "SelfHostedEmbeddings": "langchain_community.embeddings.self_hosted",
+    "SelfHostedHuggingFaceEmbeddings": "langchain_community.embeddings.self_hosted_hugging_face",  # noqa: E501
+    "SelfHostedHuggingFaceInstructEmbeddings": "langchain_community.embeddings.self_hosted_hugging_face",  # noqa: E501
+    "SentenceTransformerEmbeddings": "langchain_community.embeddings.sentence_transformer",  # noqa: E501
+    "SolarEmbeddings": "langchain_community.embeddings.solar",
+    "SpacyEmbeddings": "langchain_community.embeddings.spacy_embeddings",
+    "SparkLLMTextEmbeddings": "langchain_community.embeddings.sparkllm",
+    "TensorflowHubEmbeddings": "langchain_community.embeddings.tensorflow_hub",
+    "VertexAIEmbeddings": "langchain_community.embeddings.vertexai",
+    "VolcanoEmbeddings": "langchain_community.embeddings.volcengine",
+    "VoyageEmbeddings": "langchain_community.embeddings.voyageai",
+    "XinferenceEmbeddings": "langchain_community.embeddings.xinference",
+    "TitanTakeoffEmbed": "langchain_community.embeddings.titan_takeoff",
+    "PremAIEmbeddings": "langchain_community.embeddings.premai",
+    "YandexGPTEmbeddings": "langchain_community.embeddings.yandex",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
+
+logger = logging.getLogger(__name__)
+
+
+# TODO: this is in here to maintain backwards compatibility
+class HypotheticalDocumentEmbedder:
+    def __init__(self, *args: Any, **kwargs: Any):
+        logger.warning(
+            "Using a deprecated class. Please use "
+            "`from langchain.chains import HypotheticalDocumentEmbedder` instead"
+        )
+        from langchain.chains.hyde.base import HypotheticalDocumentEmbedder as H
+
+        return H(*args, **kwargs)  # type: ignore
+
+    @classmethod
+    def from_llm(cls, *args: Any, **kwargs: Any) -> Any:
+        logger.warning(
+            "Using a deprecated class. Please use "
+            "`from langchain.chains import HypotheticalDocumentEmbedder` instead"
+        )
+        from langchain.chains.hyde.base import HypotheticalDocumentEmbedder as H
+
+        return H.from_llm(*args, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5f456aa822e30969807d0594dd3f1693f39fe099
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/aleph_alpha.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/aleph_alpha.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c977954ee97dde050b637835c78ad005c5c4d9fe
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/aleph_alpha.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/anyscale.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/anyscale.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4a1b54637773bf7d1ac39e12c5b9ed48ab1ed90f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/anyscale.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/awa.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/awa.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..53d155b469b24dfef45fff0e61645ef154dd4965
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/awa.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/azure_openai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/azure_openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..13c46a58c1fbe2a1b7987c7ec63f121044d0026c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/azure_openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/baichuan.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/baichuan.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..25c6e372fa8160073c918756c87fa9c55738f61d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/baichuan.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..928ba1f5a00b35ad5ca3b51c7179b4b3de12b739
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/bedrock.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/bedrock.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..85bba44efa8ce2dc23869f108b6cc3a0a019910a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/bedrock.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/bookend.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/bookend.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7180e9e6ae0c93e07b0780f5bbbcc5637f34685e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/bookend.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/clarifai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/clarifai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..51cde29493ced10bb18474b90aa47d8edc82bdab
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/clarifai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/cloudflare_workersai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/cloudflare_workersai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4e3234ab91e8428ed123773724570115558ced86
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/cloudflare_workersai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/cohere.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/cohere.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e883ecad694a04a3cc7ba137ea9e7f571d62e3d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/cohere.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/dashscope.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/dashscope.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..196d551418e45765355722bc4d501a2c43c76915
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/dashscope.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/databricks.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/databricks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1403ad92f0e0ae3e457f7644f5b2f00dd56d3108
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/databricks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/deepinfra.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/deepinfra.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..87e43123e6e3c6b86b5553666180d3688199ca43
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/deepinfra.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/edenai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/edenai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..61b3b5e1af8147d094058195ea3d00b52108d8b9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/edenai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/elasticsearch.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/elasticsearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1806eb5bb3e568d80a578ecaef14b6fcb5a00ab2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/elasticsearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/embaas.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/embaas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..82818d53f4d8885204f259397c07b27d9fb30b76
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/embaas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/ernie.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/ernie.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..08d22f9f353d2f7cd1a517185b214a8c1d38dc2b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/ernie.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/fake.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/fake.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..05f2d7934bb9ad1cace53f2b5c9e9b8f78878e10
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/fake.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/fastembed.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/fastembed.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d0954edf92ef2543b5ec20932a3ef2af67e21e64
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/fastembed.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/gigachat.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/gigachat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..14615a5e958bf5d155e2102de0bf70023307241a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/gigachat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/google_palm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/google_palm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cf943152302bfb15fdcbf5550656be8810756a45
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/google_palm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/gpt4all.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/gpt4all.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..52f7ca1e2aad29f9153c2fb350aa69de8881d757
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/gpt4all.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/gradient_ai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/gradient_ai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aff7a6f935fa891fba6e15a6b5a7c659ab19bccb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/gradient_ai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/huggingface.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/huggingface.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1012083ef448aa7798cddee24921d1bc5eae761d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/huggingface.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/huggingface_hub.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/huggingface_hub.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d02f4c6e2732b0f060193757f6c6fc579a5bd9df
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/huggingface_hub.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/infinity.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/infinity.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..428e07ea9ee6e1bfd68498d74e581dab6c808aeb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/infinity.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/infinity_local.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/infinity_local.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..85b03a0320682f449cacd0b31379ac6c56fd09c1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/infinity_local.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/itrex.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/itrex.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f7d7c3b48c799fbb02a1e880e2e46d19b60f3a56
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/itrex.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/javelin_ai_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/javelin_ai_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e2b1e1063111b565770497f024ca262ecb378b7b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/javelin_ai_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/jina.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/jina.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..70c9fa9eae15672c0c3ac4a85132afbaeaa5dce0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/jina.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/johnsnowlabs.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/johnsnowlabs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..22404ef6b27cc90f944dae0ac764b2c02a96da26
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/johnsnowlabs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/laser.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/laser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c63958a146aae0f9b46b0732525d134aea1a5487
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/laser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/llamacpp.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/llamacpp.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c8c39307f0a086ab6bfa4130a39eab3591a6dcca
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/llamacpp.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/llamafile.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/llamafile.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6beeead0986258da4a7296f1f8c50737f6ba9180
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/llamafile.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/llm_rails.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/llm_rails.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e6829735fe695244db02239c0da4fdfa6af3255c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/llm_rails.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/localai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/localai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..11c17343a448ba3320e474dc529f4fb489173059
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/localai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/minimax.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/minimax.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..881425d5f1fad9b4df361025d4d58b5f23efcbb3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/minimax.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/mlflow.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/mlflow.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3fb117b148aa47f0d45046dc73bbf0a8a40c9963
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/mlflow.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/mlflow_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/mlflow_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2d5350cd9d957f5add8a279013bdc41f44d5d9f9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/mlflow_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/modelscope_hub.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/modelscope_hub.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..120067893135cb0a815139e952a2eb01dd92ebb8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/modelscope_hub.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/mosaicml.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/mosaicml.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a81991ee8853f21b6cb7bcfec9eb8003a7980ab1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/mosaicml.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/nemo.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/nemo.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c914270c45cb8f08eba81f6ab5a4e2b9c7cbdb2e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/nemo.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/nlpcloud.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/nlpcloud.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c083e6d2e7037ba8fa5bd1b9604c0f3b65ffbb38
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/nlpcloud.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/oci_generative_ai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/oci_generative_ai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..52c641ce82044f6431392a703bab93923a010dec
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/oci_generative_ai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/octoai_embeddings.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/octoai_embeddings.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..83fbe0532caabb2cae6685748424988eee1095f9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/octoai_embeddings.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/ollama.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/ollama.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ed6dc8b593af24a895d538a7f6c1294f7268f51e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/ollama.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/openai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7c8c198edeb664bc8f102d6db0b776d5369c5f2e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/openvino.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/openvino.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b96e8cbc561fca7be1119730fe7d18b70ff1ffc5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/openvino.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/optimum_intel.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/optimum_intel.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5a346da06028ad1b06d3fc472f4508902e2371df
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/optimum_intel.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/premai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/premai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..09aee78ee248d937ce843104bee003baaadfb814
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/premai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/sagemaker_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/sagemaker_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2a0a78ad36bdf363064cb69d26635dbc59237b3e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/sagemaker_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/self_hosted.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/self_hosted.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b86cb929752c5d0e3ee1c43699dad978ca55043e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/self_hosted.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/self_hosted_hugging_face.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/self_hosted_hugging_face.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..af05b593ac583979f585f8ec3b5213360924280b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/self_hosted_hugging_face.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/sentence_transformer.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/sentence_transformer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b33ea650514c607e75f69b02325486ab1f2a54b4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/sentence_transformer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/solar.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/solar.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7a19b6d5911f46fa6ff9c94553897dfab1de74ad
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/solar.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/spacy_embeddings.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/spacy_embeddings.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6130c26917bbf712e1e38990771a05403dd27c49
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/spacy_embeddings.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/sparkllm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/sparkllm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a47bad5a600f0616792b7b3cb24d0754cef76b2b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/sparkllm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/tensorflow_hub.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/tensorflow_hub.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8c12fface9c4eec28e809e8137af5466b8351461
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/tensorflow_hub.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/text2vec.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/text2vec.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2dcfebed61aac7217f5335161c25dbe92ae7e6fe
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/text2vec.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/titan_takeoff.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/titan_takeoff.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..816f2913bf1a1736d110efcfc0ac49891134ebf3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/titan_takeoff.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/vertexai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/vertexai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1a91ce3091d7a8ffef41c031d195a22ad2286a6d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/vertexai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/volcengine.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/volcengine.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4d804d0fcf03abb7fd774c0bed5ff3793a958668
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/volcengine.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/voyageai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/voyageai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3a67528e0033ad5878a5f3a17022103bca4c894f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/voyageai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/xinference.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/xinference.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ebcca167cd54a7755dc503ea8ca13bd2c3333e37
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/xinference.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/yandex.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/yandex.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e9a59dd030284830c3c56ec1b48352556d6f9887
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/embeddings/__pycache__/yandex.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/aleph_alpha.py b/llm/Lib/site-packages/langchain_community/embeddings/aleph_alpha.py
new file mode 100644
index 0000000000000000000000000000000000000000..24f6f9ebf2c10738205308fea70dc488f8b4cd83
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/aleph_alpha.py
@@ -0,0 +1,255 @@
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class AlephAlphaAsymmetricSemanticEmbedding(BaseModel, Embeddings):
+    """Aleph Alpha's asymmetric semantic embedding.
+
+    AA provides you with an endpoint to embed a document and a query.
+    The models were optimized to make the embeddings of documents and
+    the query for a document as similar as possible.
+    To learn more, check out: https://docs.aleph-alpha.com/docs/tasks/semantic_embed/
+
+    Example:
+        .. code-block:: python
+            from aleph_alpha import AlephAlphaAsymmetricSemanticEmbedding
+
+            embeddings = AlephAlphaAsymmetricSemanticEmbedding(
+                normalize=True, compress_to_size=128
+            )
+
+            document = "This is a content of the document"
+            query = "What is the content of the document?"
+
+            doc_result = embeddings.embed_documents([document])
+            query_result = embeddings.embed_query(query)
+
+    """
+
+    client: Any  #: :meta private:
+
+    # Embedding params
+    model: str = "luminous-base"
+    """Model name to use."""
+    compress_to_size: Optional[int] = None
+    """Should the returned embeddings come back as an original 5120-dim vector, 
+    or should it be compressed to 128-dim."""
+    normalize: Optional[bool] = None
+    """Should returned embeddings be normalized"""
+    contextual_control_threshold: Optional[int] = None
+    """Attention control parameters only apply to those tokens that have 
+    explicitly been set in the request."""
+    control_log_additive: bool = True
+    """Apply controls on prompt items by adding the log(control_factor) 
+    to attention scores."""
+
+    # Client params
+    aleph_alpha_api_key: Optional[str] = None
+    """API key for Aleph Alpha API."""
+    host: str = "https://api.aleph-alpha.com"
+    """The hostname of the API host. 
+    The default one is "https://api.aleph-alpha.com")"""
+    hosting: Optional[str] = None
+    """Determines in which datacenters the request may be processed.
+    You can either set the parameter to "aleph-alpha" or omit it (defaulting to None).
+    Not setting this value, or setting it to None, gives us maximal flexibility 
+    in processing your request in our
+    own datacenters and on servers hosted with other providers. 
+    Choose this option for maximal availability.
+    Setting it to "aleph-alpha" allows us to only process the request 
+    in our own datacenters.
+    Choose this option for maximal data privacy."""
+    request_timeout_seconds: int = 305
+    """Client timeout that will be set for HTTP requests in the 
+    `requests` library's API calls.
+    Server will close all requests after 300 seconds with an internal server error."""
+    total_retries: int = 8
+    """The number of retries made in case requests fail with certain retryable 
+    status codes. If the last
+    retry fails a corresponding exception is raised. Note, that between retries 
+    an exponential backoff
+    is applied, starting with 0.5 s after the first retry and doubling for each 
+    retry made. So with the
+    default setting of 8 retries a total wait time of 63.5 s is added between 
+    the retries."""
+    nice: bool = False
+    """Setting this to True, will signal to the API that you intend to be 
+    nice to other users
+    by de-prioritizing your request below concurrent ones."""
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        aleph_alpha_api_key = get_from_dict_or_env(
+            values, "aleph_alpha_api_key", "ALEPH_ALPHA_API_KEY"
+        )
+        try:
+            from aleph_alpha_client import Client
+
+            values["client"] = Client(
+                token=aleph_alpha_api_key,
+                host=values["host"],
+                hosting=values["hosting"],
+                request_timeout_seconds=values["request_timeout_seconds"],
+                total_retries=values["total_retries"],
+                nice=values["nice"],
+            )
+        except ImportError:
+            raise ValueError(
+                "Could not import aleph_alpha_client python package. "
+                "Please install it with `pip install aleph_alpha_client`."
+            )
+
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Call out to Aleph Alpha's asymmetric Document endpoint.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        try:
+            from aleph_alpha_client import (
+                Prompt,
+                SemanticEmbeddingRequest,
+                SemanticRepresentation,
+            )
+        except ImportError:
+            raise ValueError(
+                "Could not import aleph_alpha_client python package. "
+                "Please install it with `pip install aleph_alpha_client`."
+            )
+        document_embeddings = []
+
+        for text in texts:
+            document_params = {
+                "prompt": Prompt.from_text(text),
+                "representation": SemanticRepresentation.Document,
+                "compress_to_size": self.compress_to_size,
+                "normalize": self.normalize,
+                "contextual_control_threshold": self.contextual_control_threshold,
+                "control_log_additive": self.control_log_additive,
+            }
+
+            document_request = SemanticEmbeddingRequest(**document_params)
+            document_response = self.client.semantic_embed(
+                request=document_request, model=self.model
+            )
+
+            document_embeddings.append(document_response.embedding)
+
+        return document_embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to Aleph Alpha's asymmetric, query embedding endpoint
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        try:
+            from aleph_alpha_client import (
+                Prompt,
+                SemanticEmbeddingRequest,
+                SemanticRepresentation,
+            )
+        except ImportError:
+            raise ValueError(
+                "Could not import aleph_alpha_client python package. "
+                "Please install it with `pip install aleph_alpha_client`."
+            )
+        symmetric_params = {
+            "prompt": Prompt.from_text(text),
+            "representation": SemanticRepresentation.Query,
+            "compress_to_size": self.compress_to_size,
+            "normalize": self.normalize,
+            "contextual_control_threshold": self.contextual_control_threshold,
+            "control_log_additive": self.control_log_additive,
+        }
+
+        symmetric_request = SemanticEmbeddingRequest(**symmetric_params)
+        symmetric_response = self.client.semantic_embed(
+            request=symmetric_request, model=self.model
+        )
+
+        return symmetric_response.embedding
+
+
+class AlephAlphaSymmetricSemanticEmbedding(AlephAlphaAsymmetricSemanticEmbedding):
+    """Symmetric version of the Aleph Alpha's semantic embeddings.
+
+    The main difference is that here, both the documents and
+    queries are embedded with a SemanticRepresentation.Symmetric
+    Example:
+        .. code-block:: python
+
+            from aleph_alpha import AlephAlphaSymmetricSemanticEmbedding
+
+            embeddings = AlephAlphaAsymmetricSemanticEmbedding(
+                normalize=True, compress_to_size=128
+            )
+            text = "This is a test text"
+
+            doc_result = embeddings.embed_documents([text])
+            query_result = embeddings.embed_query(text)
+    """
+
+    def _embed(self, text: str) -> List[float]:
+        try:
+            from aleph_alpha_client import (
+                Prompt,
+                SemanticEmbeddingRequest,
+                SemanticRepresentation,
+            )
+        except ImportError:
+            raise ValueError(
+                "Could not import aleph_alpha_client python package. "
+                "Please install it with `pip install aleph_alpha_client`."
+            )
+        query_params = {
+            "prompt": Prompt.from_text(text),
+            "representation": SemanticRepresentation.Symmetric,
+            "compress_to_size": self.compress_to_size,
+            "normalize": self.normalize,
+            "contextual_control_threshold": self.contextual_control_threshold,
+            "control_log_additive": self.control_log_additive,
+        }
+
+        query_request = SemanticEmbeddingRequest(**query_params)
+        query_response = self.client.semantic_embed(
+            request=query_request, model=self.model
+        )
+
+        return query_response.embedding
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Call out to Aleph Alpha's Document endpoint.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        document_embeddings = []
+
+        for text in texts:
+            document_embeddings.append(self._embed(text))
+        return document_embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to Aleph Alpha's asymmetric, query embedding endpoint
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self._embed(text)
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/anyscale.py b/llm/Lib/site-packages/langchain_community/embeddings/anyscale.py
new file mode 100644
index 0000000000000000000000000000000000000000..9e8e38401863f967ed7fd2860d2826709b219240
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/anyscale.py
@@ -0,0 +1,75 @@
+"""Anyscale embeddings wrapper."""
+from __future__ import annotations
+
+from typing import Dict
+
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.embeddings.openai import OpenAIEmbeddings
+from langchain_community.utils.openai import is_openai_v1
+
+DEFAULT_API_BASE = "https://api.endpoints.anyscale.com/v1"
+DEFAULT_MODEL = "thenlper/gte-large"
+
+
+class AnyscaleEmbeddings(OpenAIEmbeddings):
+    """`Anyscale` Embeddings API."""
+
+    anyscale_api_key: SecretStr = Field(default=None)
+    """AnyScale Endpoints API keys."""
+    model: str = Field(default=DEFAULT_MODEL)
+    """Model name to use."""
+    anyscale_api_base: str = Field(default=DEFAULT_API_BASE)
+    """Base URL path for API requests."""
+    tiktoken_enabled: bool = False
+    """Set this to False for non-OpenAI implementations of the embeddings API"""
+    embedding_ctx_length: int = 500
+    """The maximum number of tokens to embed at once."""
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {
+            "anyscale_api_key": "ANYSCALE_API_KEY",
+        }
+
+    @root_validator()
+    def validate_environment(cls, values: dict) -> dict:
+        """Validate that api key and python package exists in environment."""
+        values["anyscale_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "anyscale_api_key",
+                "ANYSCALE_API_KEY",
+            )
+        )
+        values["anyscale_api_base"] = get_from_dict_or_env(
+            values,
+            "anyscale_api_base",
+            "ANYSCALE_API_BASE",
+            default=DEFAULT_API_BASE,
+        )
+        try:
+            import openai
+
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+        if is_openai_v1():
+            # For backwards compatibility.
+            client_params = {
+                "api_key": values["anyscale_api_key"].get_secret_value(),
+                "base_url": values["anyscale_api_base"],
+            }
+            values["client"] = openai.OpenAI(**client_params).embeddings
+        else:
+            values["openai_api_base"] = values["anyscale_api_base"]
+            values["openai_api_key"] = values["anyscale_api_key"].get_secret_value()
+            values["client"] = openai.Embedding
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        return "anyscale-embedding"
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/awa.py b/llm/Lib/site-packages/langchain_community/embeddings/awa.py
new file mode 100644
index 0000000000000000000000000000000000000000..9145d8006a7bd0ba00898cb81fcd1fffeca2c21e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/awa.py
@@ -0,0 +1,63 @@
+from typing import Any, Dict, List
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+
+class AwaEmbeddings(BaseModel, Embeddings):
+    """Embedding documents and queries with Awa DB.
+
+    Attributes:
+        client: The AwaEmbedding client.
+        model: The name of the model used for embedding.
+         Default is "all-mpnet-base-v2".
+    """
+
+    client: Any  #: :meta private:
+    model: str = "all-mpnet-base-v2"
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that awadb library is installed."""
+
+        try:
+            from awadb import AwaEmbedding
+        except ImportError as exc:
+            raise ImportError(
+                "Could not import awadb library. "
+                "Please install it with `pip install awadb`"
+            ) from exc
+        values["client"] = AwaEmbedding()
+        return values
+
+    def set_model(self, model_name: str) -> None:
+        """Set the model used for embedding.
+        The default model used is all-mpnet-base-v2
+
+        Args:
+            model_name: A string which represents the name of model.
+        """
+        self.model = model_name
+        self.client.model_name = model_name
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed a list of documents using AwaEmbedding.
+
+        Args:
+            texts: The list of texts need to be embedded
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        return self.client.EmbeddingBatch(texts)
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using AwaEmbedding.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self.client.Embedding(text)
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/azure_openai.py b/llm/Lib/site-packages/langchain_community/embeddings/azure_openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..db23dfc827150a9a624daf570377213638529eb2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/azure_openai.py
@@ -0,0 +1,163 @@
+"""Azure OpenAI embeddings wrapper."""
+
+from __future__ import annotations
+
+import os
+import warnings
+from typing import Callable, Dict, Optional, Union
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.embeddings.openai import OpenAIEmbeddings
+from langchain_community.utils.openai import is_openai_v1
+
+
+@deprecated(
+    since="0.0.9",
+    removal="0.2.0",
+    alternative_import="langchain_openai.AzureOpenAIEmbeddings",
+)
+class AzureOpenAIEmbeddings(OpenAIEmbeddings):
+    """`Azure OpenAI` Embeddings API."""
+
+    azure_endpoint: Union[str, None] = None
+    """Your Azure endpoint, including the resource.
+
+        Automatically inferred from env var `AZURE_OPENAI_ENDPOINT` if not provided.
+        
+        Example: `https://example-resource.azure.openai.com/`
+    """
+    deployment: Optional[str] = Field(default=None, alias="azure_deployment")
+    """A model deployment. 
+
+        If given sets the base client URL to include `/deployments/{azure_deployment}`.
+        Note: this means you won't be able to use non-deployment endpoints.
+    """
+    openai_api_key: Union[str, None] = Field(default=None, alias="api_key")
+    """Automatically inferred from env var `AZURE_OPENAI_API_KEY` if not provided."""
+    azure_ad_token: Union[str, None] = None
+    """Your Azure Active Directory token.
+
+        Automatically inferred from env var `AZURE_OPENAI_AD_TOKEN` if not provided.
+
+        For more: 
+        https://www.microsoft.com/en-us/security/business/identity-access/microsoft-entra-id.
+    """  # noqa: E501
+    azure_ad_token_provider: Union[Callable[[], str], None] = None
+    """A function that returns an Azure Active Directory token.
+
+        Will be invoked on every request.
+    """
+    openai_api_version: Optional[str] = Field(default=None, alias="api_version")
+    """Automatically inferred from env var `OPENAI_API_VERSION` if not provided."""
+    validate_base_url: bool = True
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        # Check OPENAI_KEY for backwards compatibility.
+        # TODO: Remove OPENAI_API_KEY support to avoid possible conflict when using
+        # other forms of azure credentials.
+        values["openai_api_key"] = (
+            values["openai_api_key"]
+            or os.getenv("AZURE_OPENAI_API_KEY")
+            or os.getenv("OPENAI_API_KEY")
+        )
+        values["openai_api_base"] = values["openai_api_base"] or os.getenv(
+            "OPENAI_API_BASE"
+        )
+        values["openai_api_version"] = values["openai_api_version"] or os.getenv(
+            "OPENAI_API_VERSION", default="2023-05-15"
+        )
+        values["openai_api_type"] = get_from_dict_or_env(
+            values, "openai_api_type", "OPENAI_API_TYPE", default="azure"
+        )
+        values["openai_organization"] = (
+            values["openai_organization"]
+            or os.getenv("OPENAI_ORG_ID")
+            or os.getenv("OPENAI_ORGANIZATION")
+        )
+        values["openai_proxy"] = get_from_dict_or_env(
+            values,
+            "openai_proxy",
+            "OPENAI_PROXY",
+            default="",
+        )
+        values["azure_endpoint"] = values["azure_endpoint"] or os.getenv(
+            "AZURE_OPENAI_ENDPOINT"
+        )
+        values["azure_ad_token"] = values["azure_ad_token"] or os.getenv(
+            "AZURE_OPENAI_AD_TOKEN"
+        )
+        # Azure OpenAI embedding models allow a maximum of 16 texts
+        # at a time in each batch
+        # See: https://learn.microsoft.com/en-us/azure/ai-services/openai/reference#embeddings
+        values["chunk_size"] = min(values["chunk_size"], 16)
+        try:
+            import openai
+
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+        if is_openai_v1():
+            # For backwards compatibility. Before openai v1, no distinction was made
+            # between azure_endpoint and base_url (openai_api_base).
+            openai_api_base = values["openai_api_base"]
+            if openai_api_base and values["validate_base_url"]:
+                if "/openai" not in openai_api_base:
+                    values["openai_api_base"] += "/openai"
+                    warnings.warn(
+                        "As of openai>=1.0.0, Azure endpoints should be specified via "
+                        f"the `azure_endpoint` param not `openai_api_base` "
+                        f"(or alias `base_url`). Updating `openai_api_base` from "
+                        f"{openai_api_base} to {values['openai_api_base']}."
+                    )
+                if values["deployment"]:
+                    warnings.warn(
+                        "As of openai>=1.0.0, if `deployment` (or alias "
+                        "`azure_deployment`) is specified then "
+                        "`openai_api_base` (or alias `base_url`) should not be. "
+                        "Instead use `deployment` (or alias `azure_deployment`) "
+                        "and `azure_endpoint`."
+                    )
+                    if values["deployment"] not in values["openai_api_base"]:
+                        warnings.warn(
+                            "As of openai>=1.0.0, if `openai_api_base` "
+                            "(or alias `base_url`) is specified it is expected to be "
+                            "of the form "
+                            "https://example-resource.azure.openai.com/openai/deployments/example-deployment. "  # noqa: E501
+                            f"Updating {openai_api_base} to "
+                            f"{values['openai_api_base']}."
+                        )
+                        values["openai_api_base"] += (
+                            "/deployments/" + values["deployment"]
+                        )
+                    values["deployment"] = None
+            client_params = {
+                "api_version": values["openai_api_version"],
+                "azure_endpoint": values["azure_endpoint"],
+                "azure_deployment": values["deployment"],
+                "api_key": values["openai_api_key"],
+                "azure_ad_token": values["azure_ad_token"],
+                "azure_ad_token_provider": values["azure_ad_token_provider"],
+                "organization": values["openai_organization"],
+                "base_url": values["openai_api_base"],
+                "timeout": values["request_timeout"],
+                "max_retries": values["max_retries"],
+                "default_headers": values["default_headers"],
+                "default_query": values["default_query"],
+                "http_client": values["http_client"],
+            }
+            values["client"] = openai.AzureOpenAI(**client_params).embeddings
+            values["async_client"] = openai.AsyncAzureOpenAI(**client_params).embeddings
+        else:
+            values["client"] = openai.Embedding
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        return "azure-openai-chat"
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/baichuan.py b/llm/Lib/site-packages/langchain_community/embeddings/baichuan.py
new file mode 100644
index 0000000000000000000000000000000000000000..430ef548cca711a22db1c2626204e9f976dd24f1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/baichuan.py
@@ -0,0 +1,113 @@
+from typing import Any, Dict, List, Optional
+
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+BAICHUAN_API_URL: str = "http://api.baichuan-ai.com/v1/embeddings"
+
+# BaichuanTextEmbeddings is an embedding model provided by Baichuan Inc. (https://www.baichuan-ai.com/home).
+# As of today (Jan 25th, 2024) BaichuanTextEmbeddings ranks #1 in C-MTEB
+# (Chinese Multi-Task Embedding Benchmark) leaderboard.
+# Leaderboard (Under Overall -> Chinese section): https://huggingface.co/spaces/mteb/leaderboard
+
+# Official Website: https://platform.baichuan-ai.com/docs/text-Embedding
+# An API-key is required to use this embedding model. You can get one by registering
+# at https://platform.baichuan-ai.com/docs/text-Embedding.
+# BaichuanTextEmbeddings support 512 token window and preduces vectors with
+# 1024 dimensions.
+
+
+# NOTE!! BaichuanTextEmbeddings only supports Chinese text embedding.
+# Multi-language support is coming soon.
+class BaichuanTextEmbeddings(BaseModel, Embeddings):
+    """Baichuan Text Embedding models."""
+
+    session: Any  #: :meta private:
+    model_name: str = "Baichuan-Text-Embedding"
+    baichuan_api_key: Optional[SecretStr] = None
+
+    @root_validator(allow_reuse=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that auth token exists in environment."""
+        try:
+            baichuan_api_key = convert_to_secret_str(
+                get_from_dict_or_env(values, "baichuan_api_key", "BAICHUAN_API_KEY")
+            )
+        except ValueError as original_exc:
+            try:
+                baichuan_api_key = convert_to_secret_str(
+                    get_from_dict_or_env(
+                        values, "baichuan_auth_token", "BAICHUAN_AUTH_TOKEN"
+                    )
+                )
+            except ValueError:
+                raise original_exc
+        session = requests.Session()
+        session.headers.update(
+            {
+                "Authorization": f"Bearer {baichuan_api_key.get_secret_value()}",
+                "Accept-Encoding": "identity",
+                "Content-type": "application/json",
+            }
+        )
+        values["session"] = session
+        return values
+
+    def _embed(self, texts: List[str]) -> Optional[List[List[float]]]:
+        """Internal method to call Baichuan Embedding API and return embeddings.
+
+        Args:
+            texts: A list of texts to embed.
+
+        Returns:
+            A list of list of floats representing the embeddings, or None if an
+            error occurs.
+        """
+        try:
+            response = self.session.post(
+                BAICHUAN_API_URL, json={"input": texts, "model": self.model_name}
+            )
+            # Check if the response status code indicates success
+            if response.status_code == 200:
+                resp = response.json()
+                embeddings = resp.get("data", [])
+                # Sort resulting embeddings by index
+                sorted_embeddings = sorted(embeddings, key=lambda e: e.get("index", 0))
+                # Return just the embeddings
+                return [result.get("embedding", []) for result in sorted_embeddings]
+            else:
+                # Log error or handle unsuccessful response appropriately
+                print(  # noqa: T201
+                    f"""Error: Received status code {response.status_code} from 
+                    embedding API"""
+                )
+                return None
+        except Exception as e:
+            # Log the exception or handle it as needed
+            print(f"Exception occurred while trying to get embeddings: {str(e)}")  # noqa: T201
+            return None
+
+    def embed_documents(self, texts: List[str]) -> Optional[List[List[float]]]:  # type: ignore[override]
+        """Public method to get embeddings for a list of documents.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            A list of embeddings, one for each text, or None if an error occurs.
+        """
+        return self._embed(texts)
+
+    def embed_query(self, text: str) -> Optional[List[float]]:  # type: ignore[override]
+        """Public method to get embedding for a single query text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text, or None if an error occurs.
+        """
+        result = self._embed([text])
+        return result[0] if result is not None else None
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/baidu_qianfan_endpoint.py b/llm/Lib/site-packages/langchain_community/embeddings/baidu_qianfan_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..41bbd96984d56be6f3d5c97dd090f6d2abab7133
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/baidu_qianfan_endpoint.py
@@ -0,0 +1,151 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+class QianfanEmbeddingsEndpoint(BaseModel, Embeddings):
+    """`Baidu Qianfan Embeddings` embedding models."""
+
+    qianfan_ak: Optional[str] = None
+    """Qianfan application apikey"""
+
+    qianfan_sk: Optional[str] = None
+    """Qianfan application secretkey"""
+
+    chunk_size: int = 16
+    """Chunk size when multiple texts are input"""
+
+    model: str = "Embedding-V1"
+    """Model name
+    you could get from https://cloud.baidu.com/doc/WENXINWORKSHOP/s/Nlks5zkzu
+    
+    for now, we support Embedding-V1 and 
+    - Embedding-V1 （默认模型）
+    - bge-large-en
+    - bge-large-zh
+    
+    preset models are mapping to an endpoint.
+    `model` will be ignored if `endpoint` is set
+    """
+
+    endpoint: str = ""
+    """Endpoint of the Qianfan Embedding, required if custom model used."""
+
+    client: Any
+    """Qianfan client"""
+
+    init_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """init kwargs for qianfan client init, such as `query_per_second` which is 
+        associated with qianfan resource object to limit QPS"""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """extra params for model invoke using with `do`."""
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """
+        Validate whether qianfan_ak and qianfan_sk in the environment variables or
+        configuration file are available or not.
+
+        init qianfan embedding client with `ak`, `sk`, `model`, `endpoint`
+
+        Args:
+
+            values: a dictionary containing configuration information, must include the
+            fields of qianfan_ak and qianfan_sk
+        Returns:
+
+            a dictionary containing configuration information. If qianfan_ak and
+            qianfan_sk are not provided in the environment variables or configuration
+            file,the original values will be returned; otherwise, values containing
+            qianfan_ak and qianfan_sk will be returned.
+        Raises:
+
+            ValueError: qianfan package not found, please install it with `pip install
+            qianfan`
+        """
+        values["qianfan_ak"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "qianfan_ak",
+                "QIANFAN_AK",
+                default="",
+            )
+        )
+        values["qianfan_sk"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "qianfan_sk",
+                "QIANFAN_SK",
+                default="",
+            )
+        )
+
+        try:
+            import qianfan
+
+            params = {
+                **values.get("init_kwargs", {}),
+                "model": values["model"],
+            }
+            if values["qianfan_ak"].get_secret_value() != "":
+                params["ak"] = values["qianfan_ak"].get_secret_value()
+            if values["qianfan_sk"].get_secret_value() != "":
+                params["sk"] = values["qianfan_sk"].get_secret_value()
+            if values["endpoint"] is not None and values["endpoint"] != "":
+                params["endpoint"] = values["endpoint"]
+            values["client"] = qianfan.Embedding(**params)
+        except ImportError:
+            raise ImportError(
+                "qianfan package not found, please install it with "
+                "`pip install qianfan`"
+            )
+        return values
+
+    def embed_query(self, text: str) -> List[float]:
+        resp = self.embed_documents([text])
+        return resp[0]
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """
+        Embeds a list of text documents using the AutoVOT algorithm.
+
+        Args:
+            texts (List[str]): A list of text documents to embed.
+
+        Returns:
+            List[List[float]]: A list of embeddings for each document in the input list.
+                            Each embedding is represented as a list of float values.
+        """
+        text_in_chunks = [
+            texts[i : i + self.chunk_size]
+            for i in range(0, len(texts), self.chunk_size)
+        ]
+        lst = []
+        for chunk in text_in_chunks:
+            resp = self.client.do(texts=chunk, **self.model_kwargs)
+            lst.extend([res["embedding"] for res in resp["data"]])
+        return lst
+
+    async def aembed_query(self, text: str) -> List[float]:
+        embeddings = await self.aembed_documents([text])
+        return embeddings[0]
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        text_in_chunks = [
+            texts[i : i + self.chunk_size]
+            for i in range(0, len(texts), self.chunk_size)
+        ]
+        lst = []
+        for chunk in text_in_chunks:
+            resp = await self.client.ado(texts=chunk, **self.model_kwargs)
+            for res in resp["data"]:
+                lst.extend([res["embedding"]])
+        return lst
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/bedrock.py b/llm/Lib/site-packages/langchain_community/embeddings/bedrock.py
new file mode 100644
index 0000000000000000000000000000000000000000..3cfa977fd91e8dd93d4c0d972baef75fde4f6de3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/bedrock.py
@@ -0,0 +1,218 @@
+import asyncio
+import json
+import os
+from typing import Any, Dict, List, Optional
+
+import numpy as np
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.runnables.config import run_in_executor
+
+
+class BedrockEmbeddings(BaseModel, Embeddings):
+    """Bedrock embedding models.
+
+    To authenticate, the AWS client uses the following methods to
+    automatically load credentials:
+    https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html
+
+    If a specific credential profile should be used, you must pass
+    the name of the profile from the ~/.aws/credentials file that is to be used.
+
+    Make sure the credentials / roles used have the required policies to
+    access the Bedrock service.
+    """
+
+    """
+    Example:
+        .. code-block:: python
+
+            from langchain_community.bedrock_embeddings import BedrockEmbeddings
+            
+            region_name ="us-east-1"
+            credentials_profile_name = "default"
+            model_id = "amazon.titan-embed-text-v1"
+
+            be = BedrockEmbeddings(
+                credentials_profile_name=credentials_profile_name,
+                region_name=region_name,
+                model_id=model_id
+            )
+    """
+
+    client: Any  #: :meta private:
+    """Bedrock client."""
+    region_name: Optional[str] = None
+    """The aws region e.g., `us-west-2`. Fallsback to AWS_DEFAULT_REGION env variable
+    or region specified in ~/.aws/config in case it is not provided here.
+    """
+
+    credentials_profile_name: Optional[str] = None
+    """The name of the profile in the ~/.aws/credentials or ~/.aws/config files, which
+    has either access keys or role information specified.
+    If not specified, the default credential profile or, if on an EC2 instance,
+    credentials from IMDS will be used.
+    See: https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html
+    """
+
+    model_id: str = "amazon.titan-embed-text-v1"
+    """Id of the model to call, e.g., amazon.titan-embed-text-v1, this is
+    equivalent to the modelId property in the list-foundation-models api"""
+
+    model_kwargs: Optional[Dict] = None
+    """Keyword arguments to pass to the model."""
+
+    endpoint_url: Optional[str] = None
+    """Needed if you don't want to default to us-east-1 endpoint"""
+
+    normalize: bool = False
+    """Whether the embeddings should be normalized to unit vectors"""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that AWS credentials to and python package exists in environment."""
+
+        if values["client"] is not None:
+            return values
+
+        try:
+            import boto3
+
+            if values["credentials_profile_name"] is not None:
+                session = boto3.Session(profile_name=values["credentials_profile_name"])
+            else:
+                # use default credentials
+                session = boto3.Session()
+
+            client_params = {}
+            if values["region_name"]:
+                client_params["region_name"] = values["region_name"]
+
+            if values["endpoint_url"]:
+                client_params["endpoint_url"] = values["endpoint_url"]
+
+            values["client"] = session.client("bedrock-runtime", **client_params)
+
+        except ImportError:
+            raise ModuleNotFoundError(
+                "Could not import boto3 python package. "
+                "Please install it with `pip install boto3`."
+            )
+        except Exception as e:
+            raise ValueError(
+                "Could not load credentials to authenticate with AWS client. "
+                "Please check that credentials in the specified "
+                f"profile name are valid. Bedrock error: {e}"
+            ) from e
+
+        return values
+
+    def _embedding_func(self, text: str) -> List[float]:
+        """Call out to Bedrock embedding endpoint."""
+        # replace newlines, which can negatively affect performance.
+        text = text.replace(os.linesep, " ")
+
+        # format input body for provider
+        provider = self.model_id.split(".")[0]
+        _model_kwargs = self.model_kwargs or {}
+        input_body = {**_model_kwargs}
+        if provider == "cohere":
+            if "input_type" not in input_body.keys():
+                input_body["input_type"] = "search_document"
+            input_body["texts"] = [text]
+        else:
+            # includes common provider == "amazon"
+            input_body["inputText"] = text
+        body = json.dumps(input_body)
+
+        try:
+            # invoke bedrock API
+            response = self.client.invoke_model(
+                body=body,
+                modelId=self.model_id,
+                accept="application/json",
+                contentType="application/json",
+            )
+
+            # format output based on provider
+            response_body = json.loads(response.get("body").read())
+            if provider == "cohere":
+                return response_body.get("embeddings")[0]
+            else:
+                # includes common provider == "amazon"
+                return response_body.get("embedding")
+        except Exception as e:
+            raise ValueError(f"Error raised by inference endpoint: {e}")
+
+    def _normalize_vector(self, embeddings: List[float]) -> List[float]:
+        """Normalize the embedding to a unit vector."""
+        emb = np.array(embeddings)
+        norm_emb = emb / np.linalg.norm(emb)
+        return norm_emb.tolist()
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Compute doc embeddings using a Bedrock model.
+
+        Args:
+            texts: The list of texts to embed
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        results = []
+        for text in texts:
+            response = self._embedding_func(text)
+
+            if self.normalize:
+                response = self._normalize_vector(response)
+
+            results.append(response)
+
+        return results
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using a Bedrock model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        embedding = self._embedding_func(text)
+
+        if self.normalize:
+            return self._normalize_vector(embedding)
+
+        return embedding
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """Asynchronous compute query embeddings using a Bedrock model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+
+        return await run_in_executor(None, self.embed_query, text)
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Asynchronous compute doc embeddings using a Bedrock model.
+
+        Args:
+            texts: The list of texts to embed
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+
+        result = await asyncio.gather(*[self.aembed_query(text) for text in texts])
+
+        return list(result)
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/bookend.py b/llm/Lib/site-packages/langchain_community/embeddings/bookend.py
new file mode 100644
index 0000000000000000000000000000000000000000..f8388712d7cf401f029e09635bd2582120b634ba
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/bookend.py
@@ -0,0 +1,90 @@
+"""Wrapper around Bookend AI embedding models."""
+
+import json
+from typing import Any, List
+
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+API_URL = "https://api.bookend.ai/"
+DEFAULT_TASK = "embeddings"
+PATH = "/models/predict"
+
+
+class BookendEmbeddings(BaseModel, Embeddings):
+    """Bookend AI sentence_transformers embedding models.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import BookendEmbeddings
+
+            bookend = BookendEmbeddings(
+                domain={domain}
+                api_token={api_token}
+                model_id={model_id}
+            )
+            bookend.embed_documents([
+                "Please put on these earmuffs because I can't you hear.",
+                "Baby wipes are made of chocolate stardust.",
+            ])
+            bookend.embed_query(
+                "She only paints with bold colors; she does not like pastels."
+            )
+    """
+
+    domain: str
+    """Request for a domain at https://bookend.ai/ to use this embeddings module."""
+    api_token: str
+    """Request for an API token at https://bookend.ai/ to use this embeddings module."""
+    model_id: str
+    """Embeddings model ID to use."""
+    auth_header: dict = Field(default_factory=dict)
+
+    def __init__(self, **kwargs: Any):
+        super().__init__(**kwargs)
+        self.auth_header = {"Authorization": "Basic {}".format(self.api_token)}
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed documents using a Bookend deployed embeddings model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        result = []
+        headers = self.auth_header
+        headers["Content-Type"] = "application/json; charset=utf-8"
+        params = {
+            "model_id": self.model_id,
+            "task": DEFAULT_TASK,
+        }
+
+        for text in texts:
+            data = json.dumps(
+                {"text": text, "question": None, "context": None, "instruction": None}
+            )
+            r = requests.request(
+                "POST",
+                API_URL + self.domain + PATH,
+                headers=headers,
+                params=params,
+                data=data,
+            )
+            result.append(r.json()[0]["data"])
+
+        return result
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using a Bookend deployed embeddings model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self.embed_documents([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/clarifai.py b/llm/Lib/site-packages/langchain_community/embeddings/clarifai.py
new file mode 100644
index 0000000000000000000000000000000000000000..e846df927a7e959ce6e2910f9729b23c6b8de0d3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/clarifai.py
@@ -0,0 +1,141 @@
+import logging
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+
+logger = logging.getLogger(__name__)
+
+
+class ClarifaiEmbeddings(BaseModel, Embeddings):
+    """Clarifai embedding models.
+
+    To use, you should have the ``clarifai`` python package installed, and the
+    environment variable ``CLARIFAI_PAT`` set with your personal access token or pass it
+    as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import ClarifaiEmbeddings
+            clarifai = ClarifaiEmbeddings(user_id=USER_ID,
+                                          app_id=APP_ID,
+                                          model_id=MODEL_ID)
+                             (or)
+            Example_URL = "https://clarifai.com/clarifai/main/models/BAAI-bge-base-en-v15"
+            clarifai = ClarifaiEmbeddings(model_url=EXAMPLE_URL)
+    """
+
+    model_url: Optional[str] = None
+    """Model url to use."""
+    model_id: Optional[str] = None
+    """Model id to use."""
+    model_version_id: Optional[str] = None
+    """Model version id to use."""
+    app_id: Optional[str] = None
+    """Clarifai application id to use."""
+    user_id: Optional[str] = None
+    """Clarifai user id to use."""
+    pat: Optional[str] = Field(default=None, exclude=True)
+    """Clarifai personal access token to use."""
+    token: Optional[str] = Field(default=None, exclude=True)
+    """Clarifai session token to use."""
+    model: Any = Field(default=None, exclude=True)  #: :meta private:
+    api_base: str = "https://api.clarifai.com"
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that we have all required info to access Clarifai
+        platform and python package exists in environment."""
+
+        try:
+            from clarifai.client.model import Model
+        except ImportError:
+            raise ImportError(
+                "Could not import clarifai python package. "
+                "Please install it with `pip install clarifai`."
+            )
+        user_id = values.get("user_id")
+        app_id = values.get("app_id")
+        model_id = values.get("model_id")
+        model_version_id = values.get("model_version_id")
+        model_url = values.get("model_url")
+        api_base = values.get("api_base")
+        pat = values.get("pat")
+        token = values.get("token")
+
+        values["model"] = Model(
+            url=model_url,
+            app_id=app_id,
+            user_id=user_id,
+            model_version=dict(id=model_version_id),
+            pat=pat,
+            token=token,
+            model_id=model_id,
+            base_url=api_base,
+        )
+
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Call out to Clarifai's embedding models.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        from clarifai.client.input import Inputs
+
+        input_obj = Inputs.from_auth_helper(self.model.auth_helper)
+        batch_size = 32
+        embeddings = []
+
+        try:
+            for i in range(0, len(texts), batch_size):
+                batch = texts[i : i + batch_size]
+                input_batch = [
+                    input_obj.get_text_input(input_id=str(id), raw_text=inp)
+                    for id, inp in enumerate(batch)
+                ]
+                predict_response = self.model.predict(input_batch)
+                embeddings.extend(
+                    [
+                        list(output.data.embeddings[0].vector)
+                        for output in predict_response.outputs
+                    ]
+                )
+
+        except Exception as e:
+            logger.error(f"Predict failed, exception: {e}")
+
+        return embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to Clarifai's embedding models.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+
+        try:
+            predict_response = self.model.predict_by_bytes(
+                bytes(text, "utf-8"), input_type="text"
+            )
+            embeddings = [
+                list(op.data.embeddings[0].vector) for op in predict_response.outputs
+            ]
+
+        except Exception as e:
+            logger.error(f"Predict failed, exception: {e}")
+
+        return embeddings[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/cloudflare_workersai.py b/llm/Lib/site-packages/langchain_community/embeddings/cloudflare_workersai.py
new file mode 100644
index 0000000000000000000000000000000000000000..81f6f83d4a52adb3b72cf10896a577ec1166b723
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/cloudflare_workersai.py
@@ -0,0 +1,94 @@
+from typing import Any, Dict, List
+
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra
+
+DEFAULT_MODEL_NAME = "@cf/baai/bge-base-en-v1.5"
+
+
+class CloudflareWorkersAIEmbeddings(BaseModel, Embeddings):
+    """Cloudflare Workers AI embedding model.
+
+    To use, you need to provide an API token and
+    account ID to access Cloudflare Workers AI.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import CloudflareWorkersAIEmbeddings
+
+            account_id = "my_account_id"
+            api_token = "my_secret_api_token"
+            model_name =  "@cf/baai/bge-small-en-v1.5"
+
+            cf = CloudflareWorkersAIEmbeddings(
+                account_id=account_id,
+                api_token=api_token,
+                model_name=model_name
+            )
+    """
+
+    api_base_url: str = "https://api.cloudflare.com/client/v4/accounts"
+    account_id: str
+    api_token: str
+    model_name: str = DEFAULT_MODEL_NAME
+    batch_size: int = 50
+    strip_new_lines: bool = True
+    headers: Dict[str, str] = {"Authorization": "Bearer "}
+
+    def __init__(self, **kwargs: Any):
+        """Initialize the Cloudflare Workers AI client."""
+        super().__init__(**kwargs)
+
+        self.headers = {"Authorization": f"Bearer {self.api_token}"}
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Compute doc embeddings using Cloudflare Workers AI.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        if self.strip_new_lines:
+            texts = [text.replace("\n", " ") for text in texts]
+
+        batches = [
+            texts[i : i + self.batch_size]
+            for i in range(0, len(texts), self.batch_size)
+        ]
+        embeddings = []
+
+        for batch in batches:
+            response = requests.post(
+                f"{self.api_base_url}/{self.account_id}/ai/run/{self.model_name}",
+                headers=self.headers,
+                json={"text": batch},
+            )
+            embeddings.extend(response.json()["result"]["data"])
+
+        return embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using Cloudflare Workers AI.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        text = text.replace("\n", " ") if self.strip_new_lines else text
+        response = requests.post(
+            f"{self.api_base_url}/{self.account_id}/ai/run/{self.model_name}",
+            headers=self.headers,
+            json={"text": [text]},
+        )
+        return response.json()["result"]["data"][0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/cohere.py b/llm/Lib/site-packages/langchain_community/embeddings/cohere.py
new file mode 100644
index 0000000000000000000000000000000000000000..e129de132dcad1197f0e42a5cbc52eef27da0589
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/cohere.py
@@ -0,0 +1,172 @@
+from typing import Any, Dict, List, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.llms.cohere import _create_retry_decorator
+
+
+@deprecated(
+    since="0.0.30",
+    removal="0.2.0",
+    alternative_import="langchain_cohere.CohereEmbeddings",
+)
+class CohereEmbeddings(BaseModel, Embeddings):
+    """Cohere embedding models.
+
+    To use, you should have the ``cohere`` python package installed, and the
+    environment variable ``COHERE_API_KEY`` set with your API key or pass it
+    as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import CohereEmbeddings
+            cohere = CohereEmbeddings(
+                model="embed-english-light-v3.0",
+                cohere_api_key="my-api-key"
+            )
+    """
+
+    client: Any  #: :meta private:
+    """Cohere client."""
+    async_client: Any  #: :meta private:
+    """Cohere async client."""
+    model: str = "embed-english-v2.0"
+    """Model name to use."""
+
+    truncate: Optional[str] = None
+    """Truncate embeddings that are too long from start or end ("NONE"|"START"|"END")"""
+
+    cohere_api_key: Optional[str] = None
+
+    max_retries: int = 3
+    """Maximum number of retries to make when generating."""
+    request_timeout: Optional[float] = None
+    """Timeout in seconds for the Cohere API request."""
+    user_agent: str = "langchain"
+    """Identifier for the application making the request."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        cohere_api_key = get_from_dict_or_env(
+            values, "cohere_api_key", "COHERE_API_KEY"
+        )
+        request_timeout = values.get("request_timeout")
+
+        try:
+            import cohere
+
+            client_name = values["user_agent"]
+            values["client"] = cohere.Client(
+                cohere_api_key,
+                timeout=request_timeout,
+                client_name=client_name,
+            )
+            values["async_client"] = cohere.AsyncClient(
+                cohere_api_key,
+                timeout=request_timeout,
+                client_name=client_name,
+            )
+        except ImportError:
+            raise ValueError(
+                "Could not import cohere python package. "
+                "Please install it with `pip install cohere`."
+            )
+        return values
+
+    def embed_with_retry(self, **kwargs: Any) -> Any:
+        """Use tenacity to retry the embed call."""
+        retry_decorator = _create_retry_decorator(self.max_retries)
+
+        @retry_decorator
+        def _embed_with_retry(**kwargs: Any) -> Any:
+            return self.client.embed(**kwargs)
+
+        return _embed_with_retry(**kwargs)
+
+    def aembed_with_retry(self, **kwargs: Any) -> Any:
+        """Use tenacity to retry the embed call."""
+        retry_decorator = _create_retry_decorator(self.max_retries)
+
+        @retry_decorator
+        async def _embed_with_retry(**kwargs: Any) -> Any:
+            return await self.async_client.embed(**kwargs)
+
+        return _embed_with_retry(**kwargs)
+
+    def embed(
+        self, texts: List[str], *, input_type: Optional[str] = None
+    ) -> List[List[float]]:
+        embeddings = self.embed_with_retry(
+            model=self.model,
+            texts=texts,
+            input_type=input_type,
+            truncate=self.truncate,
+        ).embeddings
+        return [list(map(float, e)) for e in embeddings]
+
+    async def aembed(
+        self, texts: List[str], *, input_type: Optional[str] = None
+    ) -> List[List[float]]:
+        embeddings = (
+            await self.aembed_with_retry(
+                model=self.model,
+                texts=texts,
+                input_type=input_type,
+                truncate=self.truncate,
+            )
+        ).embeddings
+        return [list(map(float, e)) for e in embeddings]
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed a list of document texts.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        return self.embed(texts, input_type="search_document")
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Async call out to Cohere's embedding endpoint.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        return await self.aembed(texts, input_type="search_document")
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to Cohere's embedding endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self.embed([text], input_type="search_query")[0]
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """Async call out to Cohere's embedding endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return (await self.aembed([text], input_type="search_query"))[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/dashscope.py b/llm/Lib/site-packages/langchain_community/embeddings/dashscope.py
new file mode 100644
index 0000000000000000000000000000000000000000..0042c05debc8061d8da67ef45b6f96ab5f978174
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/dashscope.py
@@ -0,0 +1,162 @@
+from __future__ import annotations
+
+import logging
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    List,
+    Optional,
+)
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+from requests.exceptions import HTTPError
+from tenacity import (
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def _create_retry_decorator(embeddings: DashScopeEmbeddings) -> Callable[[Any], Any]:
+    multiplier = 1
+    min_seconds = 1
+    max_seconds = 4
+    # Wait 2^x * 1 second between each retry starting with
+    # 1 seconds, then up to 4 seconds, then 4 seconds afterwards
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(embeddings.max_retries),
+        wait=wait_exponential(multiplier, min=min_seconds, max=max_seconds),
+        retry=(retry_if_exception_type(HTTPError)),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def embed_with_retry(embeddings: DashScopeEmbeddings, **kwargs: Any) -> Any:
+    """Use tenacity to retry the embedding call."""
+    retry_decorator = _create_retry_decorator(embeddings)
+
+    @retry_decorator
+    def _embed_with_retry(**kwargs: Any) -> Any:
+        result = []
+        i = 0
+        input_data = kwargs["input"]
+        while i < len(input_data):
+            kwargs["input"] = input_data[i : i + 25]
+            resp = embeddings.client.call(**kwargs)
+            if resp.status_code == 200:
+                result += resp.output["embeddings"]
+            elif resp.status_code in [400, 401]:
+                raise ValueError(
+                    f"status_code: {resp.status_code} \n "
+                    f"code: {resp.code} \n message: {resp.message}"
+                )
+            else:
+                raise HTTPError(
+                    f"HTTP error occurred: status_code: {resp.status_code} \n "
+                    f"code: {resp.code} \n message: {resp.message}",
+                    response=resp,
+                )
+            i += 25
+        return result
+
+    return _embed_with_retry(**kwargs)
+
+
+class DashScopeEmbeddings(BaseModel, Embeddings):
+    """DashScope embedding models.
+
+    To use, you should have the ``dashscope`` python package installed, and the
+    environment variable ``DASHSCOPE_API_KEY`` set with your API key or pass it
+    as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import DashScopeEmbeddings
+            embeddings = DashScopeEmbeddings(dashscope_api_key="my-api-key")
+
+    Example:
+        .. code-block:: python
+
+            import os
+            os.environ["DASHSCOPE_API_KEY"] = "your DashScope API KEY"
+
+            from langchain_community.embeddings.dashscope import DashScopeEmbeddings
+            embeddings = DashScopeEmbeddings(
+                model="text-embedding-v1",
+            )
+            text = "This is a test query."
+            query_result = embeddings.embed_query(text)
+
+    """
+
+    client: Any  #: :meta private:
+    """The DashScope client."""
+    model: str = "text-embedding-v1"
+    dashscope_api_key: Optional[str] = None
+    max_retries: int = 5
+    """Maximum number of retries to make when generating."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        import dashscope
+
+        """Validate that api key and python package exists in environment."""
+        values["dashscope_api_key"] = get_from_dict_or_env(
+            values, "dashscope_api_key", "DASHSCOPE_API_KEY"
+        )
+        dashscope.api_key = values["dashscope_api_key"]
+        try:
+            import dashscope
+
+            values["client"] = dashscope.TextEmbedding
+        except ImportError:
+            raise ImportError(
+                "Could not import dashscope python package. "
+                "Please install it with `pip install dashscope`."
+            )
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Call out to DashScope's embedding endpoint for embedding search docs.
+
+        Args:
+            texts: The list of texts to embed.
+            chunk_size: The chunk size of embeddings. If None, will use the chunk size
+                specified by the class.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        embeddings = embed_with_retry(
+            self, input=texts, text_type="document", model=self.model
+        )
+        embedding_list = [item["embedding"] for item in embeddings]
+        return embedding_list
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to DashScope's embedding endpoint for embedding query text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embedding for the text.
+        """
+        embedding = embed_with_retry(
+            self, input=text, text_type="query", model=self.model
+        )[0]["embedding"]
+        return embedding
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/databricks.py b/llm/Lib/site-packages/langchain_community/embeddings/databricks.py
new file mode 100644
index 0000000000000000000000000000000000000000..8ea3867fa42083fbaf999a63ab456e83db3498d3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/databricks.py
@@ -0,0 +1,45 @@
+from __future__ import annotations
+
+from typing import Iterator, List
+from urllib.parse import urlparse
+
+from langchain_community.embeddings.mlflow import MlflowEmbeddings
+
+
+def _chunk(texts: List[str], size: int) -> Iterator[List[str]]:
+    for i in range(0, len(texts), size):
+        yield texts[i : i + size]
+
+
+class DatabricksEmbeddings(MlflowEmbeddings):
+    """Databricks embeddings.
+
+    To use, you should have the ``mlflow`` python package installed.
+    For more information, see https://mlflow.org/docs/latest/llms/deployments.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import DatabricksEmbeddings
+
+            embeddings = DatabricksEmbeddings(
+                target_uri="databricks",
+                endpoint="embeddings",
+            )
+    """
+
+    target_uri: str = "databricks"
+    """The target URI to use. Defaults to ``databricks``."""
+
+    @property
+    def _mlflow_extras(self) -> str:
+        return ""
+
+    def _validate_uri(self) -> None:
+        if self.target_uri == "databricks":
+            return
+
+        if urlparse(self.target_uri).scheme != "databricks":
+            raise ValueError(
+                "Invalid target URI. The target URI must be a valid databricks URI."
+            )
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/deepinfra.py b/llm/Lib/site-packages/langchain_community/embeddings/deepinfra.py
new file mode 100644
index 0000000000000000000000000000000000000000..046e1e481f10f1572b713b3f98c685032f0a8ad3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/deepinfra.py
@@ -0,0 +1,128 @@
+from typing import Any, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+DEFAULT_MODEL_ID = "sentence-transformers/clip-ViT-B-32"
+
+
+class DeepInfraEmbeddings(BaseModel, Embeddings):
+    """Deep Infra's embedding inference service.
+
+    To use, you should have the
+    environment variable ``DEEPINFRA_API_TOKEN`` set with your API token, or pass
+    it as a named parameter to the constructor.
+    There are multiple embeddings models available,
+    see https://deepinfra.com/models?type=embeddings.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import DeepInfraEmbeddings
+            deepinfra_emb = DeepInfraEmbeddings(
+                model_id="sentence-transformers/clip-ViT-B-32",
+                deepinfra_api_token="my-api-key"
+            )
+            r1 = deepinfra_emb.embed_documents(
+                [
+                    "Alpha is the first letter of Greek alphabet",
+                    "Beta is the second letter of Greek alphabet",
+                ]
+            )
+            r2 = deepinfra_emb.embed_query(
+                "What is the second letter of Greek alphabet"
+            )
+
+    """
+
+    model_id: str = DEFAULT_MODEL_ID
+    """Embeddings model to use."""
+    normalize: bool = False
+    """whether to normalize the computed embeddings"""
+    embed_instruction: str = "passage: "
+    """Instruction used to embed documents."""
+    query_instruction: str = "query: "
+    """Instruction used to embed the query."""
+    model_kwargs: Optional[dict] = None
+    """Other model keyword args"""
+
+    deepinfra_api_token: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        deepinfra_api_token = get_from_dict_or_env(
+            values, "deepinfra_api_token", "DEEPINFRA_API_TOKEN"
+        )
+        values["deepinfra_api_token"] = deepinfra_api_token
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {"model_id": self.model_id}
+
+    def _embed(self, input: List[str]) -> List[List[float]]:
+        _model_kwargs = self.model_kwargs or {}
+        # HTTP headers for authorization
+        headers = {
+            "Authorization": f"bearer {self.deepinfra_api_token}",
+            "Content-Type": "application/json",
+        }
+        # send request
+        try:
+            res = requests.post(
+                f"https://api.deepinfra.com/v1/inference/{self.model_id}",
+                headers=headers,
+                json={"inputs": input, "normalize": self.normalize, **_model_kwargs},
+            )
+        except requests.exceptions.RequestException as e:
+            raise ValueError(f"Error raised by inference endpoint: {e}")
+
+        if res.status_code != 200:
+            raise ValueError(
+                "Error raised by inference API HTTP code: %s, %s"
+                % (res.status_code, res.text)
+            )
+        try:
+            t = res.json()
+            embeddings = t["embeddings"]
+        except requests.exceptions.JSONDecodeError as e:
+            raise ValueError(
+                f"Error raised by inference API: {e}.\nResponse: {res.text}"
+            )
+
+        return embeddings
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed documents using a Deep Infra deployed embedding model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        instruction_pairs = [f"{self.embed_instruction}{text}" for text in texts]
+        embeddings = self._embed(instruction_pairs)
+        return embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using a Deep Infra deployed embedding model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        instruction_pair = f"{self.query_instruction}{text}"
+        embedding = self._embed([instruction_pair])[0]
+        return embedding
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/edenai.py b/llm/Lib/site-packages/langchain_community/embeddings/edenai.py
new file mode 100644
index 0000000000000000000000000000000000000000..9446969d332c51b2c91de964994d299853ac4666
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/edenai.py
@@ -0,0 +1,116 @@
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import (
+    BaseModel,
+    Extra,
+    Field,
+    SecretStr,
+    root_validator,
+)
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.utilities.requests import Requests
+
+
+class EdenAiEmbeddings(BaseModel, Embeddings):
+    """EdenAI embedding.
+    environment variable ``EDENAI_API_KEY`` set with your API key, or pass
+    it as a named parameter.
+    """
+
+    edenai_api_key: Optional[SecretStr] = Field(None, description="EdenAI API Token")
+
+    provider: str = "openai"
+    """embedding provider to use (eg: openai,google etc.)"""
+
+    model: Optional[str] = None
+    """
+    model name for above provider (eg: 'gpt-3.5-turbo-instruct' for openai)
+    available models are shown on https://docs.edenai.co/ under 'available providers'
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        values["edenai_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "edenai_api_key", "EDENAI_API_KEY")
+        )
+        return values
+
+    @staticmethod
+    def get_user_agent() -> str:
+        from langchain_community import __version__
+
+        return f"langchain/{__version__}"
+
+    def _generate_embeddings(self, texts: List[str]) -> List[List[float]]:
+        """Compute embeddings using EdenAi api."""
+        url = "https://api.edenai.run/v2/text/embeddings"
+
+        headers = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "authorization": f"Bearer {self.edenai_api_key.get_secret_value()}",  # type: ignore[union-attr]
+            "User-Agent": self.get_user_agent(),
+        }
+
+        payload: Dict[str, Any] = {"texts": texts, "providers": self.provider}
+
+        if self.model is not None:
+            payload["settings"] = {self.provider: self.model}
+
+        request = Requests(headers=headers)
+        response = request.post(url=url, data=payload)
+        if response.status_code >= 500:
+            raise Exception(f"EdenAI Server: Error {response.status_code}")
+        elif response.status_code >= 400:
+            raise ValueError(f"EdenAI received an invalid payload: {response.text}")
+        elif response.status_code != 200:
+            raise Exception(
+                f"EdenAI returned an unexpected response with status "
+                f"{response.status_code}: {response.text}"
+            )
+
+        temp = response.json()
+
+        provider_response = temp[self.provider]
+        if provider_response.get("status") == "fail":
+            err_msg = provider_response.get("error", {}).get("message")
+            raise Exception(err_msg)
+
+        embeddings = []
+        for embed_item in temp[self.provider]["items"]:
+            embedding = embed_item["embedding"]
+
+            embeddings.append(embedding)
+
+        return embeddings
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed a list of documents using EdenAI.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+
+        return self._generate_embeddings(texts)
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using EdenAI.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self._generate_embeddings([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/elasticsearch.py b/llm/Lib/site-packages/langchain_community/embeddings/elasticsearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..80596b6fd92078f91b76791b08603a7928a2a4df
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/elasticsearch.py
@@ -0,0 +1,226 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List, Optional
+
+from langchain_core._api import deprecated
+from langchain_core.utils import get_from_env
+
+if TYPE_CHECKING:
+    from elasticsearch import Elasticsearch
+    from elasticsearch.client import MlClient
+
+from langchain_core.embeddings import Embeddings
+
+
+@deprecated(
+    "0.1.11", alternative="Use class in langchain-elasticsearch package", pending=True
+)
+class ElasticsearchEmbeddings(Embeddings):
+    """Elasticsearch embedding models.
+
+    This class provides an interface to generate embeddings using a model deployed
+    in an Elasticsearch cluster. It requires an Elasticsearch connection object
+    and the model_id of the model deployed in the cluster.
+
+    In Elasticsearch you need to have an embedding model loaded and deployed.
+    - https://www.elastic.co/guide/en/elasticsearch/reference/current/infer-trained-model.html
+    - https://www.elastic.co/guide/en/machine-learning/current/ml-nlp-deploy-models.html
+    """  # noqa: E501
+
+    def __init__(
+        self,
+        client: MlClient,
+        model_id: str,
+        *,
+        input_field: str = "text_field",
+    ):
+        """
+        Initialize the ElasticsearchEmbeddings instance.
+
+        Args:
+            client (MlClient): An Elasticsearch ML client object.
+            model_id (str): The model_id of the model deployed in the Elasticsearch
+                cluster.
+            input_field (str): The name of the key for the input text field in the
+                document. Defaults to 'text_field'.
+        """
+        self.client = client
+        self.model_id = model_id
+        self.input_field = input_field
+
+    @classmethod
+    def from_credentials(
+        cls,
+        model_id: str,
+        *,
+        es_cloud_id: Optional[str] = None,
+        es_user: Optional[str] = None,
+        es_password: Optional[str] = None,
+        input_field: str = "text_field",
+    ) -> ElasticsearchEmbeddings:
+        """Instantiate embeddings from Elasticsearch credentials.
+
+        Args:
+            model_id (str): The model_id of the model deployed in the Elasticsearch
+                cluster.
+            input_field (str): The name of the key for the input text field in the
+                document. Defaults to 'text_field'.
+            es_cloud_id: (str, optional): The Elasticsearch cloud ID to connect to.
+            es_user: (str, optional): Elasticsearch username.
+            es_password: (str, optional): Elasticsearch password.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.embeddings import ElasticsearchEmbeddings
+
+                # Define the model ID and input field name (if different from default)
+                model_id = "your_model_id"
+                # Optional, only if different from 'text_field'
+                input_field = "your_input_field"
+
+                # Credentials can be passed in two ways. Either set the env vars
+                # ES_CLOUD_ID, ES_USER, ES_PASSWORD and they will be automatically
+                # pulled in, or pass them in directly as kwargs.
+                embeddings = ElasticsearchEmbeddings.from_credentials(
+                    model_id,
+                    input_field=input_field,
+                    # es_cloud_id="foo",
+                    # es_user="bar",
+                    # es_password="baz",
+                )
+
+                documents = [
+                    "This is an example document.",
+                    "Another example document to generate embeddings for.",
+                ]
+                embeddings_generator.embed_documents(documents)
+        """
+        try:
+            from elasticsearch import Elasticsearch
+            from elasticsearch.client import MlClient
+        except ImportError:
+            raise ImportError(
+                "elasticsearch package not found, please install with 'pip install "
+                "elasticsearch'"
+            )
+
+        es_cloud_id = es_cloud_id or get_from_env("es_cloud_id", "ES_CLOUD_ID")
+        es_user = es_user or get_from_env("es_user", "ES_USER")
+        es_password = es_password or get_from_env("es_password", "ES_PASSWORD")
+
+        # Connect to Elasticsearch
+        es_connection = Elasticsearch(
+            cloud_id=es_cloud_id, basic_auth=(es_user, es_password)
+        )
+        client = MlClient(es_connection)
+        return cls(client, model_id, input_field=input_field)
+
+    @classmethod
+    def from_es_connection(
+        cls,
+        model_id: str,
+        es_connection: Elasticsearch,
+        input_field: str = "text_field",
+    ) -> ElasticsearchEmbeddings:
+        """
+        Instantiate embeddings from an existing Elasticsearch connection.
+
+        This method provides a way to create an instance of the ElasticsearchEmbeddings
+        class using an existing Elasticsearch connection. The connection object is used
+        to create an MlClient, which is then used to initialize the
+        ElasticsearchEmbeddings instance.
+
+        Args:
+        model_id (str): The model_id of the model deployed in the Elasticsearch cluster.
+        es_connection (elasticsearch.Elasticsearch): An existing Elasticsearch
+        connection object. input_field (str, optional): The name of the key for the
+        input text field in the document. Defaults to 'text_field'.
+
+        Returns:
+        ElasticsearchEmbeddings: An instance of the ElasticsearchEmbeddings class.
+
+        Example:
+            .. code-block:: python
+
+                from elasticsearch import Elasticsearch
+
+                from langchain_community.embeddings import ElasticsearchEmbeddings
+
+                # Define the model ID and input field name (if different from default)
+                model_id = "your_model_id"
+                # Optional, only if different from 'text_field'
+                input_field = "your_input_field"
+
+                # Create Elasticsearch connection
+                es_connection = Elasticsearch(
+                    hosts=["localhost:9200"], http_auth=("user", "password")
+                )
+
+                # Instantiate ElasticsearchEmbeddings using the existing connection
+                embeddings = ElasticsearchEmbeddings.from_es_connection(
+                    model_id,
+                    es_connection,
+                    input_field=input_field,
+                )
+
+                documents = [
+                    "This is an example document.",
+                    "Another example document to generate embeddings for.",
+                ]
+                embeddings_generator.embed_documents(documents)
+        """
+        # Importing MlClient from elasticsearch.client within the method to
+        # avoid unnecessary import if the method is not used
+        from elasticsearch.client import MlClient
+
+        # Create an MlClient from the given Elasticsearch connection
+        client = MlClient(es_connection)
+
+        # Return a new instance of the ElasticsearchEmbeddings class with
+        # the MlClient, model_id, and input_field
+        return cls(client, model_id, input_field=input_field)
+
+    def _embedding_func(self, texts: List[str]) -> List[List[float]]:
+        """
+        Generate embeddings for the given texts using the Elasticsearch model.
+
+        Args:
+            texts (List[str]): A list of text strings to generate embeddings for.
+
+        Returns:
+            List[List[float]]: A list of embeddings, one for each text in the input
+                list.
+        """
+        response = self.client.infer_trained_model(
+            model_id=self.model_id, docs=[{self.input_field: text} for text in texts]
+        )
+
+        embeddings = [doc["predicted_value"] for doc in response["inference_results"]]
+        return embeddings
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """
+        Generate embeddings for a list of documents.
+
+        Args:
+            texts (List[str]): A list of document text strings to generate embeddings
+                for.
+
+        Returns:
+            List[List[float]]: A list of embeddings, one for each document in the input
+                list.
+        """
+        return self._embedding_func(texts)
+
+    def embed_query(self, text: str) -> List[float]:
+        """
+        Generate an embedding for a single query text.
+
+        Args:
+            text (str): The query text to generate an embedding for.
+
+        Returns:
+            List[float]: The embedding for the input query text.
+        """
+        return self._embedding_func([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/embaas.py b/llm/Lib/site-packages/langchain_community/embeddings/embaas.py
new file mode 100644
index 0000000000000000000000000000000000000000..00f23116bf4c0d2dc24cb047ae70fd7f9cad1f7f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/embaas.py
@@ -0,0 +1,156 @@
+from typing import Any, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+from requests.adapters import HTTPAdapter, Retry
+from typing_extensions import NotRequired, TypedDict
+
+# Currently supported maximum batch size for embedding requests
+MAX_BATCH_SIZE = 256
+EMBAAS_API_URL = "https://api.embaas.io/v1/embeddings/"
+
+
+class EmbaasEmbeddingsPayload(TypedDict):
+    """Payload for the Embaas embeddings API."""
+
+    model: str
+    texts: List[str]
+    instruction: NotRequired[str]
+
+
+class EmbaasEmbeddings(BaseModel, Embeddings):
+    """Embaas's embedding service.
+
+    To use, you should have the
+    environment variable ``EMBAAS_API_KEY`` set with your API key, or pass
+    it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            # initialize with default model and instruction
+            from langchain_community.embeddings import EmbaasEmbeddings
+            emb = EmbaasEmbeddings()
+
+            # initialize with custom model and instruction
+            from langchain_community.embeddings import EmbaasEmbeddings
+            emb_model = "instructor-large"
+            emb_inst = "Represent the Wikipedia document for retrieval"
+            emb = EmbaasEmbeddings(
+                model=emb_model,
+                instruction=emb_inst
+            )
+    """
+
+    model: str = "e5-large-v2"
+    """The model used for embeddings."""
+    instruction: Optional[str] = None
+    """Instruction used for domain-specific embeddings."""
+    api_url: str = EMBAAS_API_URL
+    """The URL for the embaas embeddings API."""
+    embaas_api_key: Optional[SecretStr] = None
+    """max number of retries for requests"""
+    max_retries: Optional[int] = 3
+    """request timeout in seconds"""
+    timeout: Optional[int] = 30
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        embaas_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "embaas_api_key", "EMBAAS_API_KEY")
+        )
+        values["embaas_api_key"] = embaas_api_key
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying params."""
+        return {"model": self.model, "instruction": self.instruction}
+
+    def _generate_payload(self, texts: List[str]) -> EmbaasEmbeddingsPayload:
+        """Generates payload for the API request."""
+        payload = EmbaasEmbeddingsPayload(texts=texts, model=self.model)
+        if self.instruction:
+            payload["instruction"] = self.instruction
+        return payload
+
+    def _handle_request(self, payload: EmbaasEmbeddingsPayload) -> List[List[float]]:
+        """Sends a request to the Embaas API and handles the response."""
+        headers = {
+            "Authorization": f"Bearer {self.embaas_api_key.get_secret_value()}",  # type: ignore[union-attr]
+            "Content-Type": "application/json",
+        }
+
+        session = requests.Session()
+        retries = Retry(
+            total=self.max_retries,
+            backoff_factor=0.5,
+            allowed_methods=["POST"],
+            raise_on_status=True,
+        )
+
+        session.mount("http://", HTTPAdapter(max_retries=retries))
+        session.mount("https://", HTTPAdapter(max_retries=retries))
+        response = session.post(
+            self.api_url,
+            headers=headers,
+            json=payload,
+            timeout=self.timeout,
+        )
+
+        parsed_response = response.json()
+        embeddings = [item["embedding"] for item in parsed_response["data"]]
+
+        return embeddings
+
+    def _generate_embeddings(self, texts: List[str]) -> List[List[float]]:
+        """Generate embeddings using the Embaas API."""
+        payload = self._generate_payload(texts)
+        try:
+            return self._handle_request(payload)
+        except requests.exceptions.RequestException as e:
+            if e.response is None or not e.response.text:
+                raise ValueError(f"Error raised by embaas embeddings API: {e}")
+
+            parsed_response = e.response.json()
+            if "message" in parsed_response:
+                raise ValueError(
+                    "Validation Error raised by embaas embeddings API:"
+                    f"{parsed_response['message']}"
+                )
+            raise
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Get embeddings for a list of texts.
+
+        Args:
+            texts: The list of texts to get embeddings for.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        batches = [
+            texts[i : i + MAX_BATCH_SIZE] for i in range(0, len(texts), MAX_BATCH_SIZE)
+        ]
+        embeddings = [self._generate_embeddings(batch) for batch in batches]
+        # flatten the list of lists into a single list
+        return [embedding for batch in embeddings for embedding in batch]
+
+    def embed_query(self, text: str) -> List[float]:
+        """Get embeddings for a single text.
+
+        Args:
+            text: The text to get embeddings for.
+
+        Returns:
+            List of embeddings.
+        """
+        return self.embed_documents([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/ernie.py b/llm/Lib/site-packages/langchain_community/embeddings/ernie.py
new file mode 100644
index 0000000000000000000000000000000000000000..b6bff742bd1e4471bc19a9e808cb87b74417a813
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/ernie.py
@@ -0,0 +1,156 @@
+import asyncio
+import logging
+import threading
+from typing import Dict, List, Optional
+
+import requests
+from langchain_core._api.deprecation import deprecated
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.runnables.config import run_in_executor
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+@deprecated(
+    since="0.0.13",
+    alternative="langchain_community.embeddings.QianfanEmbeddingsEndpoint",
+)
+class ErnieEmbeddings(BaseModel, Embeddings):
+    """`Ernie Embeddings V1` embedding models."""
+
+    ernie_api_base: Optional[str] = None
+    ernie_client_id: Optional[str] = None
+    ernie_client_secret: Optional[str] = None
+    access_token: Optional[str] = None
+
+    chunk_size: int = 16
+
+    model_name = "ErnieBot-Embedding-V1"
+
+    _lock = threading.Lock()
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        values["ernie_api_base"] = get_from_dict_or_env(
+            values, "ernie_api_base", "ERNIE_API_BASE", "https://aip.baidubce.com"
+        )
+        values["ernie_client_id"] = get_from_dict_or_env(
+            values,
+            "ernie_client_id",
+            "ERNIE_CLIENT_ID",
+        )
+        values["ernie_client_secret"] = get_from_dict_or_env(
+            values,
+            "ernie_client_secret",
+            "ERNIE_CLIENT_SECRET",
+        )
+        return values
+
+    def _embedding(self, json: object) -> dict:
+        base_url = (
+            f"{self.ernie_api_base}/rpc/2.0/ai_custom/v1/wenxinworkshop/embeddings"
+        )
+        resp = requests.post(
+            f"{base_url}/embedding-v1",
+            headers={
+                "Content-Type": "application/json",
+            },
+            params={"access_token": self.access_token},
+            json=json,
+        )
+        return resp.json()
+
+    def _refresh_access_token_with_lock(self) -> None:
+        with self._lock:
+            logger.debug("Refreshing access token")
+            base_url: str = f"{self.ernie_api_base}/oauth/2.0/token"
+            resp = requests.post(
+                base_url,
+                headers={
+                    "Content-Type": "application/json",
+                    "Accept": "application/json",
+                },
+                params={
+                    "grant_type": "client_credentials",
+                    "client_id": self.ernie_client_id,
+                    "client_secret": self.ernie_client_secret,
+                },
+            )
+            self.access_token = str(resp.json().get("access_token"))
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed search docs.
+
+        Args:
+            texts: The list of texts to embed
+
+        Returns:
+            List[List[float]]: List of embeddings, one for each text.
+        """
+
+        if not self.access_token:
+            self._refresh_access_token_with_lock()
+        text_in_chunks = [
+            texts[i : i + self.chunk_size]
+            for i in range(0, len(texts), self.chunk_size)
+        ]
+        lst = []
+        for chunk in text_in_chunks:
+            resp = self._embedding({"input": [text for text in chunk]})
+            if resp.get("error_code"):
+                if resp.get("error_code") == 111:
+                    self._refresh_access_token_with_lock()
+                    resp = self._embedding({"input": [text for text in chunk]})
+                else:
+                    raise ValueError(f"Error from Ernie: {resp}")
+            lst.extend([i["embedding"] for i in resp["data"]])
+        return lst
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed query text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            List[float]: Embeddings for the text.
+        """
+
+        if not self.access_token:
+            self._refresh_access_token_with_lock()
+        resp = self._embedding({"input": [text]})
+        if resp.get("error_code"):
+            if resp.get("error_code") == 111:
+                self._refresh_access_token_with_lock()
+                resp = self._embedding({"input": [text]})
+            else:
+                raise ValueError(f"Error from Ernie: {resp}")
+        return resp["data"][0]["embedding"]
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """Asynchronous Embed query text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            List[float]: Embeddings for the text.
+        """
+
+        return await run_in_executor(None, self.embed_query, text)
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Asynchronous Embed search docs.
+
+        Args:
+            texts: The list of texts to embed
+
+        Returns:
+            List[List[float]]: List of embeddings, one for each text.
+        """
+
+        result = await asyncio.gather(*[self.aembed_query(text) for text in texts])
+
+        return list(result)
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/fake.py b/llm/Lib/site-packages/langchain_community/embeddings/fake.py
new file mode 100644
index 0000000000000000000000000000000000000000..fcc33496aa8635d2e823c2eccc32572c3dd117d1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/fake.py
@@ -0,0 +1,49 @@
+import hashlib
+from typing import List
+
+import numpy as np
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel
+
+
+class FakeEmbeddings(Embeddings, BaseModel):
+    """Fake embedding model."""
+
+    size: int
+    """The size of the embedding vector."""
+
+    def _get_embedding(self) -> List[float]:
+        return list(np.random.normal(size=self.size))
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        return [self._get_embedding() for _ in texts]
+
+    def embed_query(self, text: str) -> List[float]:
+        return self._get_embedding()
+
+
+class DeterministicFakeEmbedding(Embeddings, BaseModel):
+    """
+    Fake embedding model that always returns
+    the same embedding vector for the same text.
+    """
+
+    size: int
+    """The size of the embedding vector."""
+
+    def _get_embedding(self, seed: int) -> List[float]:
+        # set the seed for the random generator
+        np.random.seed(seed)
+        return list(np.random.normal(size=self.size))
+
+    def _get_seed(self, text: str) -> int:
+        """
+        Get a seed for the random generator, using the hash of the text.
+        """
+        return int(hashlib.sha256(text.encode("utf-8")).hexdigest(), 16) % 10**8
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        return [self._get_embedding(seed=self._get_seed(_)) for _ in texts]
+
+    def embed_query(self, text: str) -> List[float]:
+        return self._get_embedding(seed=self._get_seed(text))
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/fastembed.py b/llm/Lib/site-packages/langchain_community/embeddings/fastembed.py
new file mode 100644
index 0000000000000000000000000000000000000000..4f03ab70fe221effb513d4d40157f3dd54eb8c83
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/fastembed.py
@@ -0,0 +1,119 @@
+from typing import Any, Dict, List, Literal, Optional
+
+import numpy as np
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+
+class FastEmbedEmbeddings(BaseModel, Embeddings):
+    """Qdrant FastEmbedding models.
+    FastEmbed is a lightweight, fast, Python library built for embedding generation.
+    See more documentation at:
+    * https://github.com/qdrant/fastembed/
+    * https://qdrant.github.io/fastembed/
+
+    To use this class, you must install the `fastembed` Python package.
+
+    `pip install fastembed`
+    Example:
+        from langchain_community.embeddings import FastEmbedEmbeddings
+        fastembed = FastEmbedEmbeddings()
+    """
+
+    model_name: str = "BAAI/bge-small-en-v1.5"
+    """Name of the FastEmbedding model to use
+    Defaults to "BAAI/bge-small-en-v1.5"
+    Find the list of supported models at
+    https://qdrant.github.io/fastembed/examples/Supported_Models/
+    """
+
+    max_length: int = 512
+    """The maximum number of tokens. Defaults to 512.
+    Unknown behavior for values > 512.
+    """
+
+    cache_dir: Optional[str]
+    """The path to the cache directory.
+    Defaults to `local_cache` in the parent directory
+    """
+
+    threads: Optional[int]
+    """The number of threads single onnxruntime session can use.
+    Defaults to None
+    """
+
+    doc_embed_type: Literal["default", "passage"] = "default"
+    """Type of embedding to use for documents
+    The available options are: "default" and "passage"
+    """
+
+    _model: Any  # : :meta private:
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that FastEmbed has been installed."""
+        model_name = values.get("model_name")
+        max_length = values.get("max_length")
+        cache_dir = values.get("cache_dir")
+        threads = values.get("threads")
+
+        try:
+            # >= v0.2.0
+            from fastembed import TextEmbedding
+
+            values["_model"] = TextEmbedding(
+                model_name=model_name,
+                max_length=max_length,
+                cache_dir=cache_dir,
+                threads=threads,
+            )
+        except ImportError as ie:
+            try:
+                # < v0.2.0
+                from fastembed.embedding import FlagEmbedding
+
+                values["_model"] = FlagEmbedding(
+                    model_name=model_name,
+                    max_length=max_length,
+                    cache_dir=cache_dir,
+                    threads=threads,
+                )
+            except ImportError:
+                raise ImportError(
+                    "Could not import 'fastembed' Python package. "
+                    "Please install it with `pip install fastembed`."
+                ) from ie
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Generate embeddings for documents using FastEmbed.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        embeddings: List[np.ndarray]
+        if self.doc_embed_type == "passage":
+            embeddings = self._model.passage_embed(texts)
+        else:
+            embeddings = self._model.embed(texts)
+        return [e.tolist() for e in embeddings]
+
+    def embed_query(self, text: str) -> List[float]:
+        """Generate query embeddings using FastEmbed.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        query_embeddings: np.ndarray = next(self._model.query_embed(text))
+        return query_embeddings.tolist()
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/gigachat.py b/llm/Lib/site-packages/langchain_community/embeddings/gigachat.py
new file mode 100644
index 0000000000000000000000000000000000000000..8fb6f233fc6d0aa264ab51ff31ba502d1e27a615
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/gigachat.py
@@ -0,0 +1,187 @@
+from __future__ import annotations
+
+import logging
+from functools import cached_property
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+logger = logging.getLogger(__name__)
+
+MAX_BATCH_SIZE_CHARS = 1000000
+MAX_BATCH_SIZE_PARTS = 90
+
+
+class GigaChatEmbeddings(BaseModel, Embeddings):
+    """GigaChat Embeddings models.
+
+    Example:
+        .. code-block:: python
+            from langchain_community.embeddings.gigachat import GigaChatEmbeddings
+
+            embeddings = GigaChatEmbeddings(
+                credentials=..., scope=..., verify_ssl_certs=False
+            )
+    """
+
+    base_url: Optional[str] = None
+    """ Base API URL """
+    auth_url: Optional[str] = None
+    """ Auth URL """
+    credentials: Optional[str] = None
+    """ Auth Token """
+    scope: Optional[str] = None
+    """ Permission scope for access token """
+
+    access_token: Optional[str] = None
+    """ Access token for GigaChat """
+
+    model: Optional[str] = None
+    """Model name to use."""
+    user: Optional[str] = None
+    """ Username for authenticate """
+    password: Optional[str] = None
+    """ Password for authenticate """
+
+    timeout: Optional[float] = 600
+    """ Timeout for request. By default it works for long requests. """
+    verify_ssl_certs: Optional[bool] = None
+    """ Check certificates for all requests """
+
+    ca_bundle_file: Optional[str] = None
+    cert_file: Optional[str] = None
+    key_file: Optional[str] = None
+    key_file_password: Optional[str] = None
+    # Support for connection to GigaChat through SSL certificates
+
+    @cached_property
+    def _client(self) -> Any:
+        """Returns GigaChat API client"""
+        import gigachat
+
+        return gigachat.GigaChat(
+            base_url=self.base_url,
+            auth_url=self.auth_url,
+            credentials=self.credentials,
+            scope=self.scope,
+            access_token=self.access_token,
+            model=self.model,
+            user=self.user,
+            password=self.password,
+            timeout=self.timeout,
+            verify_ssl_certs=self.verify_ssl_certs,
+            ca_bundle_file=self.ca_bundle_file,
+            cert_file=self.cert_file,
+            key_file=self.key_file,
+            key_file_password=self.key_file_password,
+        )
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate authenticate data in environment and python package is installed."""
+        try:
+            import gigachat  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "Could not import gigachat python package. "
+                "Please install it with `pip install gigachat`."
+            )
+        fields = set(cls.__fields__.keys())
+        diff = set(values.keys()) - fields
+        if diff:
+            logger.warning(f"Extra fields {diff} in GigaChat class")
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed documents using a GigaChat embeddings models.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        result: List[List[float]] = []
+        size = 0
+        local_texts = []
+        embed_kwargs = {}
+        if self.model is not None:
+            embed_kwargs["model"] = self.model
+        for text in texts:
+            local_texts.append(text)
+            size += len(text)
+            if size > MAX_BATCH_SIZE_CHARS or len(local_texts) > MAX_BATCH_SIZE_PARTS:
+                for embedding in self._client.embeddings(
+                    texts=local_texts, **embed_kwargs
+                ).data:
+                    result.append(embedding.embedding)
+                size = 0
+                local_texts = []
+        # Call for last iteration
+        if local_texts:
+            for embedding in self._client.embeddings(
+                texts=local_texts, **embed_kwargs
+            ).data:
+                result.append(embedding.embedding)
+
+        return result
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed documents using a GigaChat embeddings models.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        result: List[List[float]] = []
+        size = 0
+        local_texts = []
+        embed_kwargs = {}
+        if self.model is not None:
+            embed_kwargs["model"] = self.model
+        for text in texts:
+            local_texts.append(text)
+            size += len(text)
+            if size > MAX_BATCH_SIZE_CHARS or len(local_texts) > MAX_BATCH_SIZE_PARTS:
+                embeddings = await self._client.aembeddings(
+                    texts=local_texts, **embed_kwargs
+                )
+                for embedding in embeddings.data:
+                    result.append(embedding.embedding)
+                size = 0
+                local_texts = []
+        # Call for last iteration
+        if local_texts:
+            embeddings = await self._client.aembeddings(
+                texts=local_texts, **embed_kwargs
+            )
+            for embedding in embeddings.data:
+                result.append(embedding.embedding)
+
+        return result
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using a GigaChat embeddings models.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self.embed_documents(texts=[text])[0]
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """Embed a query using a GigaChat embeddings models.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        docs = await self.aembed_documents(texts=[text])
+        return docs[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/google_palm.py b/llm/Lib/site-packages/langchain_community/embeddings/google_palm.py
new file mode 100644
index 0000000000000000000000000000000000000000..0ffb5cfb6fbcc3a10ce9d3ebc2a40dc36a92def0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/google_palm.py
@@ -0,0 +1,101 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Callable, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.utils import get_from_dict_or_env
+from tenacity import (
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def _create_retry_decorator() -> Callable[[Any], Any]:
+    """Returns a tenacity retry decorator, preconfigured to handle PaLM exceptions"""
+    import google.api_core.exceptions
+
+    multiplier = 2
+    min_seconds = 1
+    max_seconds = 60
+    max_retries = 10
+
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(max_retries),
+        wait=wait_exponential(multiplier=multiplier, min=min_seconds, max=max_seconds),
+        retry=(
+            retry_if_exception_type(google.api_core.exceptions.ResourceExhausted)
+            | retry_if_exception_type(google.api_core.exceptions.ServiceUnavailable)
+            | retry_if_exception_type(google.api_core.exceptions.GoogleAPIError)
+        ),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def embed_with_retry(
+    embeddings: GooglePalmEmbeddings, *args: Any, **kwargs: Any
+) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = _create_retry_decorator()
+
+    @retry_decorator
+    def _embed_with_retry(*args: Any, **kwargs: Any) -> Any:
+        return embeddings.client.generate_embeddings(*args, **kwargs)
+
+    return _embed_with_retry(*args, **kwargs)
+
+
+class GooglePalmEmbeddings(BaseModel, Embeddings):
+    """Google's PaLM Embeddings APIs."""
+
+    client: Any
+    google_api_key: Optional[str]
+    model_name: str = "models/embedding-gecko-001"
+    """Model name to use."""
+    show_progress_bar: bool = False
+    """Whether to show a tqdm progress bar. Must have `tqdm` installed."""
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate api key, python package exists."""
+        google_api_key = get_from_dict_or_env(
+            values, "google_api_key", "GOOGLE_API_KEY"
+        )
+        try:
+            import google.generativeai as genai
+
+            genai.configure(api_key=google_api_key)
+        except ImportError:
+            raise ImportError("Could not import google.generativeai python package.")
+
+        values["client"] = genai
+
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        if self.show_progress_bar:
+            try:
+                from tqdm import tqdm
+
+                iter_ = tqdm(texts, desc="GooglePalmEmbeddings")
+            except ImportError:
+                logger.warning(
+                    "Unable to show progress bar because tqdm could not be imported. "
+                    "Please install with `pip install tqdm`."
+                )
+                iter_ = texts
+        else:
+            iter_ = texts
+        return [self.embed_query(text) for text in iter_]
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed query text."""
+        embedding = embed_with_retry(self, self.model_name, text)
+        return embedding["embedding"]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/gpt4all.py b/llm/Lib/site-packages/langchain_community/embeddings/gpt4all.py
new file mode 100644
index 0000000000000000000000000000000000000000..f7983a5968bef73c79bfb1c6c1e3818dbedbb83a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/gpt4all.py
@@ -0,0 +1,60 @@
+from typing import Any, Dict, List
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+
+class GPT4AllEmbeddings(BaseModel, Embeddings):
+    """GPT4All embedding models.
+
+    To use, you should have the gpt4all python package installed
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import GPT4AllEmbeddings
+
+            embeddings = GPT4AllEmbeddings()
+    """
+
+    client: Any  #: :meta private:
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that GPT4All library is installed."""
+
+        try:
+            from gpt4all import Embed4All
+
+            values["client"] = Embed4All()
+        except ImportError:
+            raise ImportError(
+                "Could not import gpt4all library. "
+                "Please install the gpt4all library to "
+                "use this embedding model: pip install gpt4all"
+            )
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed a list of documents using GPT4All.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+
+        embeddings = [self.client.embed(text) for text in texts]
+        return [list(map(float, e)) for e in embeddings]
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using GPT4All.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self.embed_documents([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/gradient_ai.py b/llm/Lib/site-packages/langchain_community/embeddings/gradient_ai.py
new file mode 100644
index 0000000000000000000000000000000000000000..c0133d023863a7cf277ddf1db64ad594246b57c7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/gradient_ai.py
@@ -0,0 +1,166 @@
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+from packaging.version import parse
+
+__all__ = ["GradientEmbeddings"]
+
+
+class GradientEmbeddings(BaseModel, Embeddings):
+    """Gradient.ai Embedding models.
+
+    GradientLLM is a class to interact with Embedding Models on gradient.ai
+
+    To use, set the environment variable ``GRADIENT_ACCESS_TOKEN`` with your
+    API token and ``GRADIENT_WORKSPACE_ID`` for your gradient workspace,
+    or alternatively provide them as keywords to the constructor of this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import GradientEmbeddings
+            GradientEmbeddings(
+                model="bge-large",
+                gradient_workspace_id="12345614fc0_workspace",
+                gradient_access_token="gradientai-access_token",
+            )
+    """
+
+    model: str
+    "Underlying gradient.ai model id."
+
+    gradient_workspace_id: Optional[str] = None
+    "Underlying gradient.ai workspace_id."
+
+    gradient_access_token: Optional[str] = None
+    """gradient.ai API Token, which can be generated by going to
+        https://auth.gradient.ai/select-workspace
+        and selecting "Access tokens" under the profile drop-down.
+    """
+
+    gradient_api_url: str = "https://api.gradient.ai/api"
+    """Endpoint URL to use."""
+
+    query_prompt_for_retrieval: Optional[str] = None
+    """Query pre-prompt"""
+
+    client: Any = None  #: :meta private:
+    """Gradient client."""
+
+    # LLM call kwargs
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(allow_reuse=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+
+        values["gradient_access_token"] = get_from_dict_or_env(
+            values, "gradient_access_token", "GRADIENT_ACCESS_TOKEN"
+        )
+        values["gradient_workspace_id"] = get_from_dict_or_env(
+            values, "gradient_workspace_id", "GRADIENT_WORKSPACE_ID"
+        )
+
+        values["gradient_api_url"] = get_from_dict_or_env(
+            values, "gradient_api_url", "GRADIENT_API_URL"
+        )
+        try:
+            import gradientai
+        except ImportError:
+            raise ImportError(
+                'GradientEmbeddings requires `pip install -U "gradientai>=1.4.0"`.'
+            )
+
+        if parse(gradientai.__version__) < parse("1.4.0"):
+            raise ImportError(
+                'GradientEmbeddings requires `pip install -U "gradientai>=1.4.0"`.'
+            )
+
+        gradient = gradientai.Gradient(
+            access_token=values["gradient_access_token"],
+            workspace_id=values["gradient_workspace_id"],
+            host=values["gradient_api_url"],
+        )
+        values["client"] = gradient.get_embeddings_model(slug=values["model"])
+
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Call out to Gradient's embedding endpoint.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        inputs = [{"input": text} for text in texts]
+
+        result = self.client.embed(inputs=inputs).embeddings
+
+        return [e.embedding for e in result]
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Async call out to Gradient's embedding endpoint.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        inputs = [{"input": text} for text in texts]
+
+        result = (await self.client.aembed(inputs=inputs)).embeddings
+
+        return [e.embedding for e in result]
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to Gradient's embedding endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        query = (
+            f"{self.query_prompt_for_retrieval} {text}"
+            if self.query_prompt_for_retrieval
+            else text
+        )
+        return self.embed_documents([query])[0]
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """Async call out to Gradient's embedding endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        query = (
+            f"{self.query_prompt_for_retrieval} {text}"
+            if self.query_prompt_for_retrieval
+            else text
+        )
+        embeddings = await self.aembed_documents([query])
+        return embeddings[0]
+
+
+class TinyAsyncGradientEmbeddingClient:  #: :meta private:
+    """Deprecated, TinyAsyncGradientEmbeddingClient was removed.
+
+    This class is just for backwards compatibility with older versions
+    of langchain_community.
+    It might be entirely removed in the future.
+    """
+
+    def __init__(self, *args, **kwargs) -> None:  # type: ignore[no-untyped-def]
+        raise ValueError("Deprecated,TinyAsyncGradientEmbeddingClient was removed.")
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/huggingface.py b/llm/Lib/site-packages/langchain_community/embeddings/huggingface.py
new file mode 100644
index 0000000000000000000000000000000000000000..3c9cee38927b82d24a58529505c9106f7872bd47
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/huggingface.py
@@ -0,0 +1,373 @@
+from typing import Any, Dict, List, Optional
+
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, SecretStr
+
+DEFAULT_MODEL_NAME = "sentence-transformers/all-mpnet-base-v2"
+DEFAULT_INSTRUCT_MODEL = "hkunlp/instructor-large"
+DEFAULT_BGE_MODEL = "BAAI/bge-large-en"
+DEFAULT_EMBED_INSTRUCTION = "Represent the document for retrieval: "
+DEFAULT_QUERY_INSTRUCTION = (
+    "Represent the question for retrieving supporting documents: "
+)
+DEFAULT_QUERY_BGE_INSTRUCTION_EN = (
+    "Represent this question for searching relevant passages: "
+)
+DEFAULT_QUERY_BGE_INSTRUCTION_ZH = "为这个句子生成表示以用于检索相关文章："
+
+
+class HuggingFaceEmbeddings(BaseModel, Embeddings):
+    """HuggingFace sentence_transformers embedding models.
+
+    To use, you should have the ``sentence_transformers`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import HuggingFaceEmbeddings
+
+            model_name = "sentence-transformers/all-mpnet-base-v2"
+            model_kwargs = {'device': 'cpu'}
+            encode_kwargs = {'normalize_embeddings': False}
+            hf = HuggingFaceEmbeddings(
+                model_name=model_name,
+                model_kwargs=model_kwargs,
+                encode_kwargs=encode_kwargs
+            )
+    """
+
+    client: Any  #: :meta private:
+    model_name: str = DEFAULT_MODEL_NAME
+    """Model name to use."""
+    cache_folder: Optional[str] = None
+    """Path to store models. 
+    Can be also set by SENTENCE_TRANSFORMERS_HOME environment variable."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Keyword arguments to pass to the Sentence Transformer model, such as `device`,
+    `prompts`, `default_prompt_name`, `revision`, `trust_remote_code`, or `token`.
+    See also the Sentence Transformer documentation: https://sbert.net/docs/package_reference/SentenceTransformer.html#sentence_transformers.SentenceTransformer"""
+    encode_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Keyword arguments to pass when calling the `encode` method of the Sentence
+    Transformer model, such as `prompt_name`, `prompt`, `batch_size`, `precision`,
+    `normalize_embeddings`, and more.
+    See also the Sentence Transformer documentation: https://sbert.net/docs/package_reference/SentenceTransformer.html#sentence_transformers.SentenceTransformer.encode"""
+    multi_process: bool = False
+    """Run encode() on multiple GPUs."""
+    show_progress: bool = False
+    """Whether to show a progress bar."""
+
+    def __init__(self, **kwargs: Any):
+        """Initialize the sentence_transformer."""
+        super().__init__(**kwargs)
+        try:
+            import sentence_transformers
+
+        except ImportError as exc:
+            raise ImportError(
+                "Could not import sentence_transformers python package. "
+                "Please install it with `pip install sentence-transformers`."
+            ) from exc
+
+        self.client = sentence_transformers.SentenceTransformer(
+            self.model_name, cache_folder=self.cache_folder, **self.model_kwargs
+        )
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Compute doc embeddings using a HuggingFace transformer model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        import sentence_transformers
+
+        texts = list(map(lambda x: x.replace("\n", " "), texts))
+        if self.multi_process:
+            pool = self.client.start_multi_process_pool()
+            embeddings = self.client.encode_multi_process(texts, pool)
+            sentence_transformers.SentenceTransformer.stop_multi_process_pool(pool)
+        else:
+            embeddings = self.client.encode(
+                texts, show_progress_bar=self.show_progress, **self.encode_kwargs
+            )
+
+        return embeddings.tolist()
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using a HuggingFace transformer model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self.embed_documents([text])[0]
+
+
+class HuggingFaceInstructEmbeddings(BaseModel, Embeddings):
+    """Wrapper around sentence_transformers embedding models.
+
+    To use, you should have the ``sentence_transformers``
+    and ``InstructorEmbedding`` python packages installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import HuggingFaceInstructEmbeddings
+
+            model_name = "hkunlp/instructor-large"
+            model_kwargs = {'device': 'cpu'}
+            encode_kwargs = {'normalize_embeddings': True}
+            hf = HuggingFaceInstructEmbeddings(
+                model_name=model_name,
+                model_kwargs=model_kwargs,
+                encode_kwargs=encode_kwargs
+            )
+    """
+
+    client: Any  #: :meta private:
+    model_name: str = DEFAULT_INSTRUCT_MODEL
+    """Model name to use."""
+    cache_folder: Optional[str] = None
+    """Path to store models. 
+    Can be also set by SENTENCE_TRANSFORMERS_HOME environment variable."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Keyword arguments to pass to the model."""
+    encode_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Keyword arguments to pass when calling the `encode` method of the model."""
+    embed_instruction: str = DEFAULT_EMBED_INSTRUCTION
+    """Instruction to use for embedding documents."""
+    query_instruction: str = DEFAULT_QUERY_INSTRUCTION
+    """Instruction to use for embedding query."""
+
+    def __init__(self, **kwargs: Any):
+        """Initialize the sentence_transformer."""
+        super().__init__(**kwargs)
+        try:
+            from InstructorEmbedding import INSTRUCTOR
+
+            self.client = INSTRUCTOR(
+                self.model_name, cache_folder=self.cache_folder, **self.model_kwargs
+            )
+        except ImportError as e:
+            raise ImportError("Dependencies for InstructorEmbedding not found.") from e
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Compute doc embeddings using a HuggingFace instruct model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        instruction_pairs = [[self.embed_instruction, text] for text in texts]
+        embeddings = self.client.encode(instruction_pairs, **self.encode_kwargs)
+        return embeddings.tolist()
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using a HuggingFace instruct model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        instruction_pair = [self.query_instruction, text]
+        embedding = self.client.encode([instruction_pair], **self.encode_kwargs)[0]
+        return embedding.tolist()
+
+
+class HuggingFaceBgeEmbeddings(BaseModel, Embeddings):
+    """HuggingFace sentence_transformers embedding models.
+
+    To use, you should have the ``sentence_transformers`` python package installed.
+    To use Nomic, make sure the version of ``sentence_transformers`` >= 2.3.0.
+
+    Bge Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import HuggingFaceBgeEmbeddings
+
+            model_name = "BAAI/bge-large-en"
+            model_kwargs = {'device': 'cpu'}
+            encode_kwargs = {'normalize_embeddings': True}
+            hf = HuggingFaceBgeEmbeddings(
+                model_name=model_name,
+                model_kwargs=model_kwargs,
+                encode_kwargs=encode_kwargs
+            )
+     Nomic Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import HuggingFaceBgeEmbeddings
+
+            model_name = "nomic-ai/nomic-embed-text-v1"
+            model_kwargs = {
+                'device': 'cpu',
+                'trust_remote_code':True
+                }
+            encode_kwargs = {'normalize_embeddings': True}
+            hf = HuggingFaceBgeEmbeddings(
+                model_name=model_name,
+                model_kwargs=model_kwargs,
+                encode_kwargs=encode_kwargs,
+                query_instruction = "search_query:",
+                embed_instruction = "search_document:"
+            )
+    """
+
+    client: Any  #: :meta private:
+    model_name: str = DEFAULT_BGE_MODEL
+    """Model name to use."""
+    cache_folder: Optional[str] = None
+    """Path to store models.
+    Can be also set by SENTENCE_TRANSFORMERS_HOME environment variable."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Keyword arguments to pass to the model."""
+    encode_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Keyword arguments to pass when calling the `encode` method of the model."""
+    query_instruction: str = DEFAULT_QUERY_BGE_INSTRUCTION_EN
+    """Instruction to use for embedding query."""
+    embed_instruction: str = ""
+    """Instruction to use for embedding document."""
+
+    def __init__(self, **kwargs: Any):
+        """Initialize the sentence_transformer."""
+        super().__init__(**kwargs)
+        try:
+            import sentence_transformers
+
+        except ImportError as exc:
+            raise ImportError(
+                "Could not import sentence_transformers python package. "
+                "Please install it with `pip install sentence_transformers`."
+            ) from exc
+
+        self.client = sentence_transformers.SentenceTransformer(
+            self.model_name, cache_folder=self.cache_folder, **self.model_kwargs
+        )
+        if "-zh" in self.model_name:
+            self.query_instruction = DEFAULT_QUERY_BGE_INSTRUCTION_ZH
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Compute doc embeddings using a HuggingFace transformer model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        texts = [self.embed_instruction + t.replace("\n", " ") for t in texts]
+        embeddings = self.client.encode(texts, **self.encode_kwargs)
+        return embeddings.tolist()
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using a HuggingFace transformer model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        text = text.replace("\n", " ")
+        embedding = self.client.encode(
+            self.query_instruction + text, **self.encode_kwargs
+        )
+        return embedding.tolist()
+
+
+class HuggingFaceInferenceAPIEmbeddings(BaseModel, Embeddings):
+    """Embed texts using the HuggingFace API.
+
+    Requires a HuggingFace Inference API key and a model name.
+    """
+
+    api_key: SecretStr
+    """Your API key for the HuggingFace Inference API."""
+    model_name: str = "sentence-transformers/all-MiniLM-L6-v2"
+    """The name of the model to use for text embeddings."""
+    api_url: Optional[str] = None
+    """Custom inference endpoint url. None for using default public url."""
+
+    @property
+    def _api_url(self) -> str:
+        return self.api_url or self._default_api_url
+
+    @property
+    def _default_api_url(self) -> str:
+        return (
+            "https://api-inference.huggingface.co"
+            "/pipeline"
+            "/feature-extraction"
+            f"/{self.model_name}"
+        )
+
+    @property
+    def _headers(self) -> dict:
+        return {"Authorization": f"Bearer {self.api_key.get_secret_value()}"}
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Get the embeddings for a list of texts.
+
+        Args:
+            texts (Documents): A list of texts to get embeddings for.
+
+        Returns:
+            Embedded texts as List[List[float]], where each inner List[float]
+                corresponds to a single input text.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.embeddings import HuggingFaceInferenceAPIEmbeddings
+
+                hf_embeddings = HuggingFaceInferenceAPIEmbeddings(
+                    api_key="your_api_key",
+                    model_name="sentence-transformers/all-MiniLM-l6-v2"
+                )
+                texts = ["Hello, world!", "How are you?"]
+                hf_embeddings.embed_documents(texts)
+        """  # noqa: E501
+        response = requests.post(
+            self._api_url,
+            headers=self._headers,
+            json={
+                "inputs": texts,
+                "options": {"wait_for_model": True, "use_cache": True},
+            },
+        )
+        return response.json()
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using a HuggingFace transformer model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self.embed_documents([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/huggingface_hub.py b/llm/Lib/site-packages/langchain_community/embeddings/huggingface_hub.py
new file mode 100644
index 0000000000000000000000000000000000000000..70424ac0b21818604fb0195929241d52c531f1aa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/huggingface_hub.py
@@ -0,0 +1,148 @@
+import json
+import os
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+DEFAULT_MODEL = "sentence-transformers/all-mpnet-base-v2"
+VALID_TASKS = ("feature-extraction",)
+
+
+class HuggingFaceHubEmbeddings(BaseModel, Embeddings):
+    """HuggingFaceHub embedding models.
+
+    To use, you should have the ``huggingface_hub`` python package installed, and the
+    environment variable ``HUGGINGFACEHUB_API_TOKEN`` set with your API token, or pass
+    it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import HuggingFaceHubEmbeddings
+            model = "sentence-transformers/all-mpnet-base-v2"
+            hf = HuggingFaceHubEmbeddings(
+                model=model,
+                task="feature-extraction",
+                huggingfacehub_api_token="my-api-key",
+            )
+    """
+
+    client: Any  #: :meta private:
+    async_client: Any  #: :meta private:
+    model: Optional[str] = None
+    """Model name to use."""
+    repo_id: Optional[str] = None
+    """Huggingfacehub repository id, for backward compatibility."""
+    task: Optional[str] = "feature-extraction"
+    """Task to call the model with."""
+    model_kwargs: Optional[dict] = None
+    """Keyword arguments to pass to the model."""
+
+    huggingfacehub_api_token: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        huggingfacehub_api_token = values["huggingfacehub_api_token"] or os.getenv(
+            "HUGGINGFACEHUB_API_TOKEN"
+        )
+
+        try:
+            from huggingface_hub import AsyncInferenceClient, InferenceClient
+
+            if values["model"]:
+                values["repo_id"] = values["model"]
+            elif values["repo_id"]:
+                values["model"] = values["repo_id"]
+            else:
+                values["model"] = DEFAULT_MODEL
+                values["repo_id"] = DEFAULT_MODEL
+
+            client = InferenceClient(
+                model=values["model"],
+                token=huggingfacehub_api_token,
+            )
+
+            async_client = AsyncInferenceClient(
+                model=values["model"],
+                token=huggingfacehub_api_token,
+            )
+
+            if values["task"] not in VALID_TASKS:
+                raise ValueError(
+                    f"Got invalid task {values['task']}, "
+                    f"currently only {VALID_TASKS} are supported"
+                )
+            values["client"] = client
+            values["async_client"] = async_client
+
+        except ImportError:
+            raise ImportError(
+                "Could not import huggingface_hub python package. "
+                "Please install it with `pip install huggingface_hub`."
+            )
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Call out to HuggingFaceHub's embedding endpoint for embedding search docs.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        # replace newlines, which can negatively affect performance.
+        texts = [text.replace("\n", " ") for text in texts]
+        _model_kwargs = self.model_kwargs or {}
+        responses = self.client.post(
+            json={"inputs": texts, "parameters": _model_kwargs}, task=self.task
+        )
+        return json.loads(responses.decode())
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Async Call to HuggingFaceHub's embedding endpoint for embedding search docs.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        # replace newlines, which can negatively affect performance.
+        texts = [text.replace("\n", " ") for text in texts]
+        _model_kwargs = self.model_kwargs or {}
+        responses = await self.async_client.post(
+            json={"inputs": texts, "parameters": _model_kwargs}, task=self.task
+        )
+        return json.loads(responses.decode())
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to HuggingFaceHub's embedding endpoint for embedding query text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        response = self.embed_documents([text])[0]
+        return response
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """Async Call to HuggingFaceHub's embedding endpoint for embedding query text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        response = (await self.aembed_documents([text]))[0]
+        return response
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/infinity.py b/llm/Lib/site-packages/langchain_community/embeddings/infinity.py
new file mode 100644
index 0000000000000000000000000000000000000000..f0a01fc75e512d475f169f017bcf9b712ab6cc1a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/infinity.py
@@ -0,0 +1,322 @@
+"""written under MIT Licence, Michael Feil 2023."""
+
+import asyncio
+from concurrent.futures import ThreadPoolExecutor
+from typing import Any, Callable, Dict, List, Optional, Tuple
+
+import aiohttp
+import numpy as np
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+__all__ = ["InfinityEmbeddings"]
+
+
+class InfinityEmbeddings(BaseModel, Embeddings):
+    """Embedding models for self-hosted https://github.com/michaelfeil/infinity
+    This should also work for text-embeddings-inference and other
+    self-hosted openai-compatible servers.
+
+    Infinity is a class to interact with Embedding Models on https://github.com/michaelfeil/infinity
+
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import InfinityEmbeddings
+            InfinityEmbeddings(
+                model="BAAI/bge-small",
+                infinity_api_url="http://localhost:7997",
+            )
+    """
+
+    model: str
+    "Underlying Infinity model id."
+
+    infinity_api_url: str = "http://localhost:7997"
+    """Endpoint URL to use."""
+
+    client: Any = None  #: :meta private:
+    """Infinity client."""
+
+    # LLM call kwargs
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(allow_reuse=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+
+        values["infinity_api_url"] = get_from_dict_or_env(
+            values, "infinity_api_url", "INFINITY_API_URL"
+        )
+
+        values["client"] = TinyAsyncOpenAIInfinityEmbeddingClient(
+            host=values["infinity_api_url"],
+        )
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Call out to Infinity's embedding endpoint.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        embeddings = self.client.embed(
+            model=self.model,
+            texts=texts,
+        )
+        return embeddings
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Async call out to Infinity's embedding endpoint.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        embeddings = await self.client.aembed(
+            model=self.model,
+            texts=texts,
+        )
+        return embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to Infinity's embedding endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self.embed_documents([text])[0]
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """Async call out to Infinity's embedding endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        embeddings = await self.aembed_documents([text])
+        return embeddings[0]
+
+
+class TinyAsyncOpenAIInfinityEmbeddingClient:  #: :meta private:
+    """A helper tool to embed Infinity. Not part of Langchain's stable API,
+    direct use discouraged.
+
+    Example:
+        .. code-block:: python
+
+
+            mini_client = TinyAsyncInfinityEmbeddingClient(
+            )
+            embeds = mini_client.embed(
+                model="BAAI/bge-small",
+                text=["doc1", "doc2"]
+            )
+            # or
+            embeds = await mini_client.aembed(
+                model="BAAI/bge-small",
+                text=["doc1", "doc2"]
+            )
+
+    """
+
+    def __init__(
+        self,
+        host: str = "http://localhost:7797/v1",
+        aiosession: Optional[aiohttp.ClientSession] = None,
+    ) -> None:
+        self.host = host
+        self.aiosession = aiosession
+
+        if self.host is None or len(self.host) < 3:
+            raise ValueError(" param `host` must be set to a valid url")
+        self._batch_size = 128
+
+    @staticmethod
+    def _permute(
+        texts: List[str], sorter: Callable = len
+    ) -> Tuple[List[str], Callable]:
+        """Sort texts in ascending order, and
+        delivers a lambda expr, which can sort a same length list
+        https://github.com/UKPLab/sentence-transformers/blob/
+        c5f93f70eca933c78695c5bc686ceda59651ae3b/sentence_transformers/SentenceTransformer.py#L156
+
+        Args:
+            texts (List[str]): _description_
+            sorter (Callable, optional): _description_. Defaults to len.
+
+        Returns:
+            Tuple[List[str], Callable]: _description_
+
+        Example:
+            ```
+            texts = ["one","three","four"]
+            perm_texts, undo = self._permute(texts)
+            texts == undo(perm_texts)
+            ```
+        """
+
+        if len(texts) == 1:
+            # special case query
+            return texts, lambda t: t
+        length_sorted_idx = np.argsort([-sorter(sen) for sen in texts])
+        texts_sorted = [texts[idx] for idx in length_sorted_idx]
+
+        return texts_sorted, lambda unsorted_embeddings: [  # noqa E731
+            unsorted_embeddings[idx] for idx in np.argsort(length_sorted_idx)
+        ]
+
+    def _batch(self, texts: List[str]) -> List[List[str]]:
+        """
+        splits Lists of text parts into batches of size max `self._batch_size`
+        When encoding vector database,
+
+        Args:
+            texts (List[str]): List of sentences
+            self._batch_size (int, optional): max batch size of one request.
+
+        Returns:
+            List[List[str]]: Batches of List of sentences
+        """
+        if len(texts) == 1:
+            # special case query
+            return [texts]
+        batches = []
+        for start_index in range(0, len(texts), self._batch_size):
+            batches.append(texts[start_index : start_index + self._batch_size])
+        return batches
+
+    @staticmethod
+    def _unbatch(batch_of_texts: List[List[Any]]) -> List[Any]:
+        if len(batch_of_texts) == 1 and len(batch_of_texts[0]) == 1:
+            # special case query
+            return batch_of_texts[0]
+        texts = []
+        for sublist in batch_of_texts:
+            texts.extend(sublist)
+        return texts
+
+    def _kwargs_post_request(self, model: str, texts: List[str]) -> Dict[str, Any]:
+        """Build the kwargs for the Post request, used by sync
+
+        Args:
+            model (str): _description_
+            texts (List[str]): _description_
+
+        Returns:
+            Dict[str, Collection[str]]: _description_
+        """
+        return dict(
+            url=f"{self.host}/embeddings",
+            headers={
+                # "accept": "application/json",
+                "content-type": "application/json",
+            },
+            json=dict(
+                input=texts,
+                model=model,
+            ),
+        )
+
+    def _sync_request_embed(
+        self, model: str, batch_texts: List[str]
+    ) -> List[List[float]]:
+        response = requests.post(
+            **self._kwargs_post_request(model=model, texts=batch_texts)
+        )
+        if response.status_code != 200:
+            raise Exception(
+                f"Infinity returned an unexpected response with status "
+                f"{response.status_code}: {response.text}"
+            )
+        return [e["embedding"] for e in response.json()["data"]]
+
+    def embed(self, model: str, texts: List[str]) -> List[List[float]]:
+        """call the embedding of model
+
+        Args:
+            model (str): to embedding model
+            texts (List[str]): List of sentences to embed.
+
+        Returns:
+            List[List[float]]: List of vectors for each sentence
+        """
+        perm_texts, unpermute_func = self._permute(texts)
+        perm_texts_batched = self._batch(perm_texts)
+
+        # Request
+        map_args = (
+            self._sync_request_embed,
+            [model] * len(perm_texts_batched),
+            perm_texts_batched,
+        )
+        if len(perm_texts_batched) == 1:
+            embeddings_batch_perm = list(map(*map_args))
+        else:
+            with ThreadPoolExecutor(32) as p:
+                embeddings_batch_perm = list(p.map(*map_args))
+
+        embeddings_perm = self._unbatch(embeddings_batch_perm)
+        embeddings = unpermute_func(embeddings_perm)
+        return embeddings
+
+    async def _async_request(
+        self, session: aiohttp.ClientSession, kwargs: Dict[str, Any]
+    ) -> List[List[float]]:
+        async with session.post(**kwargs) as response:
+            if response.status != 200:
+                raise Exception(
+                    f"Infinity returned an unexpected response with status "
+                    f"{response.status}: {response.text}"
+                )
+            embedding = (await response.json())["embeddings"]
+            return [e["embedding"] for e in embedding]
+
+    async def aembed(self, model: str, texts: List[str]) -> List[List[float]]:
+        """call the embedding of model, async method
+
+        Args:
+            model (str): to embedding model
+            texts (List[str]): List of sentences to embed.
+
+        Returns:
+            List[List[float]]: List of vectors for each sentence
+        """
+        perm_texts, unpermute_func = self._permute(texts)
+        perm_texts_batched = self._batch(perm_texts)
+
+        # Request
+        if self.aiosession is None:
+            self.aiosession = aiohttp.ClientSession(
+                trust_env=True, connector=aiohttp.TCPConnector(limit=32)
+            )
+        async with self.aiosession as session:
+            embeddings_batch_perm = await asyncio.gather(
+                *[
+                    self._async_request(
+                        session=session,
+                        **self._kwargs_post_request(model=model, texts=t),
+                    )
+                    for t in perm_texts_batched
+                ]
+            )
+
+        embeddings_perm = self._unbatch(embeddings_batch_perm)
+        embeddings = unpermute_func(embeddings_perm)
+        return embeddings
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/infinity_local.py b/llm/Lib/site-packages/langchain_community/embeddings/infinity_local.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b94f716327883e4949a41906b69e9918dd5c519
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/infinity_local.py
@@ -0,0 +1,158 @@
+"""written under MIT Licence, Michael Feil 2023."""
+
+import asyncio
+from logging import getLogger
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+__all__ = ["InfinityEmbeddingsLocal"]
+
+logger = getLogger(__name__)
+
+
+class InfinityEmbeddingsLocal(BaseModel, Embeddings):
+    """Optimized Infinity embedding models.
+
+    https://github.com/michaelfeil/infinity
+    This class deploys a local Infinity instance to embed text.
+    The class requires async usage.
+
+    Infinity is a class to interact with Embedding Models on https://github.com/michaelfeil/infinity
+
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import InfinityEmbeddingsLocal
+            async with InfinityEmbeddingsLocal(
+                model="BAAI/bge-small-en-v1.5",
+                revision=None,
+                device="cpu",
+            ) as embedder:
+                embeddings = await engine.aembed_documents(["text1", "text2"])
+    """
+
+    model: str
+    "Underlying model id from huggingface, e.g. BAAI/bge-small-en-v1.5"
+
+    revision: Optional[str] = None
+    "Model version, the commit hash from huggingface"
+
+    batch_size: int = 32
+    "Internal batch size for inference, e.g. 32"
+
+    device: str = "auto"
+    "Device to use for inference, e.g. 'cpu' or 'cuda', or 'mps'"
+
+    backend: str = "torch"
+    "Backend for inference, e.g. 'torch' (recommended for ROCm/Nvidia)"
+    " or 'optimum' for onnx/tensorrt"
+
+    model_warmup: bool = True
+    "Warmup the model with the max batch size."
+
+    engine: Any = None  #: :meta private:
+    """Infinity's AsyncEmbeddingEngine."""
+
+    # LLM call kwargs
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(allow_reuse=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+
+        try:
+            from infinity_emb import AsyncEmbeddingEngine  # type: ignore
+        except ImportError:
+            raise ImportError(
+                "Please install the "
+                "`pip install 'infinity_emb[optimum,torch]>=0.0.24'` "
+                "package to use the InfinityEmbeddingsLocal."
+            )
+        logger.debug(f"Using InfinityEmbeddingsLocal with kwargs {values}")
+
+        values["engine"] = AsyncEmbeddingEngine(
+            model_name_or_path=values["model"],
+            device=values["device"],
+            revision=values["revision"],
+            model_warmup=values["model_warmup"],
+            batch_size=values["batch_size"],
+            engine=values["backend"],
+        )
+        return values
+
+    async def __aenter__(self) -> None:
+        """start the background worker.
+        recommended usage is with the async with statement.
+
+        async with InfinityEmbeddingsLocal(
+            model="BAAI/bge-small-en-v1.5",
+            revision=None,
+            device="cpu",
+        ) as embedder:
+            embeddings = await engine.aembed_documents(["text1", "text2"])
+        """
+        await self.engine.__aenter__()
+
+    async def __aexit__(self, *args: Any) -> None:
+        """stop the background worker,
+        required to free references to the pytorch model."""
+        await self.engine.__aexit__(*args)
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Async call out to Infinity's embedding endpoint.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        if not self.engine.running:
+            logger.warning(
+                "Starting Infinity engine on the fly. This is not recommended."
+                "Please start the engine before using it."
+            )
+            async with self:
+                # spawning threadpool for multithreaded encode, tokenization
+                embeddings, _ = await self.engine.embed(texts)
+            # stopping threadpool on exit
+            logger.warning("Stopped infinity engine after usage.")
+        else:
+            embeddings, _ = await self.engine.embed(texts)
+        return embeddings
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """Async call out to Infinity's embedding endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        embeddings = await self.aembed_documents([text])
+        return embeddings[0]
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """
+        This method is async only.
+        """
+        logger.warning(
+            "This method is async only. "
+            "Please use the async version `await aembed_documents`."
+        )
+        return asyncio.run(self.aembed_documents(texts))
+
+    def embed_query(self, text: str) -> List[float]:
+        """ """
+        logger.warning(
+            "This method is async only."
+            " Please use the async version `await aembed_query`."
+        )
+        return asyncio.run(self.aembed_query(text))
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/itrex.py b/llm/Lib/site-packages/langchain_community/embeddings/itrex.py
new file mode 100644
index 0000000000000000000000000000000000000000..d3528fb70b9c75905873b86fb1efae0c3fdc817a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/itrex.py
@@ -0,0 +1,214 @@
+import importlib.util
+import os
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra
+
+
+class QuantizedBgeEmbeddings(BaseModel, Embeddings):
+    """Leverage Itrex runtime to unlock the performance of compressed NLP models.
+
+    Please ensure that you have installed intel-extension-for-transformers.
+
+    Input:
+        model_name: str = Model name.
+        max_seq_len: int = The maximum sequence length for tokenization. (default 512)
+        pooling_strategy: str =
+            "mean" or "cls", pooling strategy for the final layer. (default "mean")
+        query_instruction: Optional[str] =
+            An instruction to add to the query before embedding. (default None)
+        document_instruction: Optional[str] =
+            An instruction to add to each document before embedding. (default None)
+        padding: Optional[bool] =
+            Whether to add padding during tokenization or not. (default True)
+        model_kwargs: Optional[Dict] =
+            Parameters to add to the model during initialization. (default {})
+        encode_kwargs: Optional[Dict] =
+            Parameters to add during the embedding forward pass. (default {})
+        onnx_file_name: Optional[str] =
+            File name of onnx optimized model which is exported by itrex.
+            (default "int8-model.onnx")
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import QuantizedBgeEmbeddings
+
+            model_name = "Intel/bge-small-en-v1.5-sts-int8-static-inc"
+            encode_kwargs = {'normalize_embeddings': True}
+            hf = QuantizedBgeEmbeddings(
+                model_name,
+                encode_kwargs=encode_kwargs,
+                query_instruction="Represent this sentence for searching relevant passages: "
+            )
+    """  # noqa: E501
+
+    def __init__(
+        self,
+        model_name: str,
+        *,
+        max_seq_len: int = 512,
+        pooling_strategy: str = "mean",  # "mean" or "cls"
+        query_instruction: Optional[str] = None,
+        document_instruction: Optional[str] = None,
+        padding: bool = True,
+        model_kwargs: Optional[Dict] = None,
+        encode_kwargs: Optional[Dict] = None,
+        onnx_file_name: Optional[str] = "int8-model.onnx",
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(**kwargs)
+
+        # check sentence_transformers python package
+        if importlib.util.find_spec("intel_extension_for_transformers") is None:
+            raise ImportError(
+                "Could not import intel_extension_for_transformers python package. "
+                "Please install it with "
+                "`pip install -U intel-extension-for-transformers`."
+            )
+
+        # check torch python package
+        if importlib.util.find_spec("torch") is None:
+            raise ImportError(
+                "Could not import torch python package. "
+                "Please install it with `pip install -U torch`."
+            )
+
+        # check onnx python package
+        if importlib.util.find_spec("onnx") is None:
+            raise ImportError(
+                "Could not import onnx python package. "
+                "Please install it with `pip install -U onnx`."
+            )
+
+        self.model_name_or_path = model_name
+        self.max_seq_len = max_seq_len
+        self.pooling = pooling_strategy
+        self.padding = padding
+        self.encode_kwargs = encode_kwargs or {}
+        self.model_kwargs = model_kwargs or {}
+
+        self.normalize = self.encode_kwargs.get("normalize_embeddings", False)
+        self.batch_size = self.encode_kwargs.get("batch_size", 32)
+
+        self.query_instruction = query_instruction
+        self.document_instruction = document_instruction
+        self.onnx_file_name = onnx_file_name
+
+        self.load_model()
+
+    def load_model(self) -> None:
+        from huggingface_hub import hf_hub_download
+        from intel_extension_for_transformers.transformers import AutoModel
+        from transformers import AutoConfig, AutoTokenizer
+
+        self.hidden_size = AutoConfig.from_pretrained(
+            self.model_name_or_path
+        ).hidden_size
+        self.transformer_tokenizer = AutoTokenizer.from_pretrained(
+            self.model_name_or_path,
+        )
+        onnx_model_path = os.path.join(self.model_name_or_path, self.onnx_file_name)  # type: ignore[arg-type]
+        if not os.path.exists(onnx_model_path):
+            onnx_model_path = hf_hub_download(
+                self.model_name_or_path, filename=self.onnx_file_name
+            )
+        self.transformer_model = AutoModel.from_pretrained(
+            onnx_model_path, use_embedding_runtime=True
+        )
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.allow
+
+    def _embed(self, inputs: Any) -> Any:
+        import torch
+
+        engine_input = [value for value in inputs.values()]
+        outputs = self.transformer_model.generate(engine_input)
+        if "last_hidden_state:0" in outputs:
+            last_hidden_state = outputs["last_hidden_state:0"]
+        else:
+            last_hidden_state = [out for out in outputs.values()][0]
+        last_hidden_state = torch.tensor(last_hidden_state).reshape(
+            inputs["input_ids"].shape[0], inputs["input_ids"].shape[1], self.hidden_size
+        )
+        if self.pooling == "mean":
+            emb = self._mean_pooling(last_hidden_state, inputs["attention_mask"])
+        elif self.pooling == "cls":
+            emb = self._cls_pooling(last_hidden_state)
+        else:
+            raise ValueError("pooling method no supported")
+
+        if self.normalize:
+            emb = torch.nn.functional.normalize(emb, p=2, dim=1)
+        return emb
+
+    @staticmethod
+    def _cls_pooling(last_hidden_state: Any) -> Any:
+        return last_hidden_state[:, 0]
+
+    @staticmethod
+    def _mean_pooling(last_hidden_state: Any, attention_mask: Any) -> Any:
+        try:
+            import torch
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import torch, please install with `pip install -U torch`."
+            ) from e
+        input_mask_expanded = (
+            attention_mask.unsqueeze(-1).expand(last_hidden_state.size()).float()
+        )
+        sum_embeddings = torch.sum(last_hidden_state * input_mask_expanded, 1)
+        sum_mask = torch.clamp(input_mask_expanded.sum(1), min=1e-9)
+        return sum_embeddings / sum_mask
+
+    def _embed_text(self, texts: List[str]) -> List[List[float]]:
+        inputs = self.transformer_tokenizer(
+            texts,
+            max_length=self.max_seq_len,
+            truncation=True,
+            padding=self.padding,
+            return_tensors="pt",
+        )
+        return self._embed(inputs).tolist()
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed a list of text documents using the Optimized Embedder model.
+
+        Input:
+            texts: List[str] = List of text documents to embed.
+        Output:
+            List[List[float]] = The embeddings of each text document.
+        """
+        try:
+            import pandas as pd
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import pandas, please install with `pip install -U pandas`."
+            ) from e
+        docs = [
+            self.document_instruction + d if self.document_instruction else d
+            for d in texts
+        ]
+
+        # group into batches
+        text_list_df = pd.DataFrame(docs, columns=["texts"]).reset_index()
+
+        # assign each example with its batch
+        text_list_df["batch_index"] = text_list_df["index"] // self.batch_size
+
+        # create groups
+        batches = list(text_list_df.groupby(["batch_index"])["texts"].apply(list))
+
+        vectors = []
+        for batch in batches:
+            vectors += self._embed_text(batch)
+        return vectors
+
+    def embed_query(self, text: str) -> List[float]:
+        if self.query_instruction:
+            text = self.query_instruction + text
+        return self._embed_text([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/javelin_ai_gateway.py b/llm/Lib/site-packages/langchain_community/embeddings/javelin_ai_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..61baac869da1f612cde6ac5144a607b823708816
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/javelin_ai_gateway.py
@@ -0,0 +1,109 @@
+from __future__ import annotations
+
+from typing import Any, Iterator, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel
+
+
+def _chunk(texts: List[str], size: int) -> Iterator[List[str]]:
+    for i in range(0, len(texts), size):
+        yield texts[i : i + size]
+
+
+class JavelinAIGatewayEmbeddings(Embeddings, BaseModel):
+    """Javelin AI Gateway embeddings.
+
+    To use, you should have the ``javelin_sdk`` python package installed.
+    For more information, see https://docs.getjavelin.io
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import JavelinAIGatewayEmbeddings
+
+            embeddings = JavelinAIGatewayEmbeddings(
+                gateway_uri="<javelin-ai-gateway-uri>",
+                route="<your-javelin-gateway-embeddings-route>"
+            )
+    """
+
+    client: Any
+    """javelin client."""
+
+    route: str
+    """The route to use for the Javelin AI Gateway API."""
+
+    gateway_uri: Optional[str] = None
+    """The URI for the Javelin AI Gateway API."""
+
+    javelin_api_key: Optional[str] = None
+    """The API key for the Javelin AI Gateway API."""
+
+    def __init__(self, **kwargs: Any):
+        try:
+            from javelin_sdk import (
+                JavelinClient,
+                UnauthorizedError,
+            )
+        except ImportError:
+            raise ImportError(
+                "Could not import javelin_sdk python package. "
+                "Please install it with `pip install javelin_sdk`."
+            )
+
+        super().__init__(**kwargs)
+        if self.gateway_uri:
+            try:
+                self.client = JavelinClient(
+                    base_url=self.gateway_uri, api_key=self.javelin_api_key
+                )
+            except UnauthorizedError as e:
+                raise ValueError("Javelin: Incorrect API Key.") from e
+
+    def _query(self, texts: List[str]) -> List[List[float]]:
+        embeddings = []
+        for txt in _chunk(texts, 20):
+            try:
+                resp = self.client.query_route(self.route, query_body={"input": txt})
+                resp_dict = resp.dict()
+
+                embeddings_chunk = resp_dict.get("llm_response", {}).get("data", [])
+                for item in embeddings_chunk:
+                    if "embedding" in item:
+                        embeddings.append(item["embedding"])
+            except ValueError as e:
+                print("Failed to query route: " + str(e))  # noqa: T201
+
+        return embeddings
+
+    async def _aquery(self, texts: List[str]) -> List[List[float]]:
+        embeddings = []
+        for txt in _chunk(texts, 20):
+            try:
+                resp = await self.client.aquery_route(
+                    self.route, query_body={"input": txt}
+                )
+                resp_dict = resp.dict()
+
+                embeddings_chunk = resp_dict.get("llm_response", {}).get("data", [])
+                for item in embeddings_chunk:
+                    if "embedding" in item:
+                        embeddings.append(item["embedding"])
+            except ValueError as e:
+                print("Failed to query route: " + str(e))  # noqa: T201
+
+        return embeddings
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        return self._query(texts)
+
+    def embed_query(self, text: str) -> List[float]:
+        return self._query([text])[0]
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        return await self._aquery(texts)
+
+    async def aembed_query(self, text: str) -> List[float]:
+        result = await self._aquery([text])
+        return result[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/jina.py b/llm/Lib/site-packages/langchain_community/embeddings/jina.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc66409e60ca02b7f6f29f05c0a9fcee7237700f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/jina.py
@@ -0,0 +1,75 @@
+from typing import Any, Dict, List, Optional
+
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+JINA_API_URL: str = "https://api.jina.ai/v1/embeddings"
+
+
+class JinaEmbeddings(BaseModel, Embeddings):
+    """Jina embedding models."""
+
+    session: Any  #: :meta private:
+    model_name: str = "jina-embeddings-v2-base-en"
+    jina_api_key: Optional[SecretStr] = None
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that auth token exists in environment."""
+        try:
+            jina_api_key = convert_to_secret_str(
+                get_from_dict_or_env(values, "jina_api_key", "JINA_API_KEY")
+            )
+        except ValueError as original_exc:
+            try:
+                jina_api_key = convert_to_secret_str(
+                    get_from_dict_or_env(values, "jina_auth_token", "JINA_AUTH_TOKEN")
+                )
+            except ValueError:
+                raise original_exc
+        session = requests.Session()
+        session.headers.update(
+            {
+                "Authorization": f"Bearer {jina_api_key.get_secret_value()}",
+                "Accept-Encoding": "identity",
+                "Content-type": "application/json",
+            }
+        )
+        values["session"] = session
+        return values
+
+    def _embed(self, texts: List[str]) -> List[List[float]]:
+        # Call Jina AI Embedding API
+        resp = self.session.post(  # type: ignore
+            JINA_API_URL, json={"input": texts, "model": self.model_name}
+        ).json()
+        if "data" not in resp:
+            raise RuntimeError(resp["detail"])
+
+        embeddings = resp["data"]
+
+        # Sort resulting embeddings by index
+        sorted_embeddings = sorted(embeddings, key=lambda e: e["index"])  # type: ignore
+
+        # Return just the embeddings
+        return [result["embedding"] for result in sorted_embeddings]
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Call out to Jina's embedding endpoint.
+        Args:
+            texts: The list of texts to embed.
+        Returns:
+            List of embeddings, one for each text.
+        """
+        return self._embed(texts)
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to Jina's embedding endpoint.
+        Args:
+            text: The text to embed.
+        Returns:
+            Embeddings for the text.
+        """
+        return self._embed([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/johnsnowlabs.py b/llm/Lib/site-packages/langchain_community/embeddings/johnsnowlabs.py
new file mode 100644
index 0000000000000000000000000000000000000000..f183efe87b5335931672367c5ec3641de35c3874
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/johnsnowlabs.py
@@ -0,0 +1,92 @@
+import os
+import sys
+from typing import Any, List
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra
+
+
+class JohnSnowLabsEmbeddings(BaseModel, Embeddings):
+    """JohnSnowLabs embedding models
+
+    To use, you should have the ``johnsnowlabs`` python package installed.
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings.johnsnowlabs import JohnSnowLabsEmbeddings
+
+            embedding = JohnSnowLabsEmbeddings(model='embed_sentence.bert')
+            output = embedding.embed_query("foo bar")
+    """  # noqa: E501
+
+    model: Any = "embed_sentence.bert"
+
+    def __init__(
+        self,
+        model: Any = "embed_sentence.bert",
+        hardware_target: str = "cpu",
+        **kwargs: Any,
+    ):
+        """Initialize the johnsnowlabs model."""
+        super().__init__(**kwargs)
+        # 1) Check imports
+        try:
+            from johnsnowlabs import nlp
+            from nlu.pipe.pipeline import NLUPipeline
+        except ImportError as exc:
+            raise ImportError(
+                "Could not import johnsnowlabs python package. "
+                "Please install it with `pip install johnsnowlabs`."
+            ) from exc
+
+        # 2) Start a Spark Session
+        try:
+            os.environ["PYSPARK_PYTHON"] = sys.executable
+            os.environ["PYSPARK_DRIVER_PYTHON"] = sys.executable
+            nlp.start(hardware_target=hardware_target)
+        except Exception as exc:
+            raise Exception("Failure starting Spark Session") from exc
+
+        # 3) Load the model
+        try:
+            if isinstance(model, str):
+                self.model = nlp.load(model)
+            elif isinstance(model, NLUPipeline):
+                self.model = model
+            else:
+                self.model = nlp.to_nlu_pipe(model)
+        except Exception as exc:
+            raise Exception("Failure loading model") from exc
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Compute doc embeddings using a JohnSnowLabs transformer model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+
+        df = self.model.predict(texts, output_level="document")
+        emb_col = None
+        for c in df.columns:
+            if "embedding" in c:
+                emb_col = c
+        return [vec.tolist() for vec in df[emb_col].tolist()]
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using a JohnSnowLabs transformer model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self.embed_documents([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/laser.py b/llm/Lib/site-packages/langchain_community/embeddings/laser.py
new file mode 100644
index 0000000000000000000000000000000000000000..675cd74f2117a6c04fe5201b7212d82e05199abc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/laser.py
@@ -0,0 +1,89 @@
+from typing import Any, Dict, List, Optional
+
+import numpy as np
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+LASER_MULTILINGUAL_MODEL: str = "laser2"
+
+
+class LaserEmbeddings(BaseModel, Embeddings):
+    """LASER Language-Agnostic SEntence Representations.
+    LASER is a Python library developed by the Meta AI Research team
+    and used for creating multilingual sentence embeddings for over 147 languages
+    as of 2/25/2024
+    See more documentation at:
+    * https://github.com/facebookresearch/LASER/
+    * https://github.com/facebookresearch/LASER/tree/main/laser_encoders
+    * https://arxiv.org/abs/2205.12654
+
+    To use this class, you must install the `laser_encoders` Python package.
+
+    `pip install laser_encoders`
+    Example:
+        from laser_encoders import LaserEncoderPipeline
+        encoder = LaserEncoderPipeline(lang="eng_Latn")
+        embeddings = encoder.encode_sentences(["Hello", "World"])
+    """
+
+    lang: Optional[str]
+    """The language or language code you'd like to use
+    If empty, this implementation will default
+    to using a multilingual earlier LASER encoder model (called laser2)
+    Find the list of supported languages at
+    https://github.com/facebookresearch/flores/blob/main/flores200/README.md#languages-in-flores-200
+    """
+
+    _encoder_pipeline: Any  # : :meta private:
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that laser_encoders has been installed."""
+        try:
+            from laser_encoders import LaserEncoderPipeline
+
+            lang = values.get("lang")
+            if lang:
+                encoder_pipeline = LaserEncoderPipeline(lang=lang)
+            else:
+                encoder_pipeline = LaserEncoderPipeline(laser=LASER_MULTILINGUAL_MODEL)
+            values["_encoder_pipeline"] = encoder_pipeline
+
+        except ImportError as e:
+            raise ImportError(
+                "Could not import 'laser_encoders' Python package. "
+                "Please install it with `pip install laser_encoders`."
+            ) from e
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Generate embeddings for documents using LASER.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        embeddings: np.ndarray
+        embeddings = self._encoder_pipeline.encode_sentences(texts)
+
+        return embeddings.tolist()
+
+    def embed_query(self, text: str) -> List[float]:
+        """Generate single query text embeddings using LASER.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        query_embeddings: np.ndarray
+        query_embeddings = self._encoder_pipeline.encode_sentences([text])
+        return query_embeddings.tolist()[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/llamacpp.py b/llm/Lib/site-packages/langchain_community/embeddings/llamacpp.py
new file mode 100644
index 0000000000000000000000000000000000000000..4cd89fc0eac30bf2a34a40f7912948d17637e819
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/llamacpp.py
@@ -0,0 +1,126 @@
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+
+
+class LlamaCppEmbeddings(BaseModel, Embeddings):
+    """llama.cpp embedding models.
+
+    To use, you should have the llama-cpp-python library installed, and provide the
+    path to the Llama model as a named parameter to the constructor.
+    Check out: https://github.com/abetlen/llama-cpp-python
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import LlamaCppEmbeddings
+            llama = LlamaCppEmbeddings(model_path="/path/to/model.bin")
+    """
+
+    client: Any  #: :meta private:
+    model_path: str
+
+    n_ctx: int = Field(512, alias="n_ctx")
+    """Token context window."""
+
+    n_parts: int = Field(-1, alias="n_parts")
+    """Number of parts to split the model into. 
+    If -1, the number of parts is automatically determined."""
+
+    seed: int = Field(-1, alias="seed")
+    """Seed. If -1, a random seed is used."""
+
+    f16_kv: bool = Field(False, alias="f16_kv")
+    """Use half-precision for key/value cache."""
+
+    logits_all: bool = Field(False, alias="logits_all")
+    """Return logits for all tokens, not just the last token."""
+
+    vocab_only: bool = Field(False, alias="vocab_only")
+    """Only load the vocabulary, no weights."""
+
+    use_mlock: bool = Field(False, alias="use_mlock")
+    """Force system to keep model in RAM."""
+
+    n_threads: Optional[int] = Field(None, alias="n_threads")
+    """Number of threads to use. If None, the number 
+    of threads is automatically determined."""
+
+    n_batch: Optional[int] = Field(512, alias="n_batch")
+    """Number of tokens to process in parallel.
+    Should be a number between 1 and n_ctx."""
+
+    n_gpu_layers: Optional[int] = Field(None, alias="n_gpu_layers")
+    """Number of layers to be loaded into gpu memory. Default None."""
+
+    verbose: bool = Field(True, alias="verbose")
+    """Print verbose output to stderr."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that llama-cpp-python library is installed."""
+        model_path = values["model_path"]
+        model_param_names = [
+            "n_ctx",
+            "n_parts",
+            "seed",
+            "f16_kv",
+            "logits_all",
+            "vocab_only",
+            "use_mlock",
+            "n_threads",
+            "n_batch",
+            "verbose",
+        ]
+        model_params = {k: values[k] for k in model_param_names}
+        # For backwards compatibility, only include if non-null.
+        if values["n_gpu_layers"] is not None:
+            model_params["n_gpu_layers"] = values["n_gpu_layers"]
+
+        try:
+            from llama_cpp import Llama
+
+            values["client"] = Llama(model_path, embedding=True, **model_params)
+        except ImportError:
+            raise ModuleNotFoundError(
+                "Could not import llama-cpp-python library. "
+                "Please install the llama-cpp-python library to "
+                "use this embedding model: pip install llama-cpp-python"
+            )
+        except Exception as e:
+            raise ValueError(
+                f"Could not load Llama model from path: {model_path}. "
+                f"Received error {e}"
+            )
+
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed a list of documents using the Llama model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        embeddings = [self.client.embed(text) for text in texts]
+        return [list(map(float, e)) for e in embeddings]
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using the Llama model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        embedding = self.client.embed(text)
+        return list(map(float, embedding))
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/llamafile.py b/llm/Lib/site-packages/langchain_community/embeddings/llamafile.py
new file mode 100644
index 0000000000000000000000000000000000000000..310f61a03e1d0368e880e5c5c3636272adf6d99c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/llamafile.py
@@ -0,0 +1,119 @@
+import logging
+from typing import List, Optional
+
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel
+
+logger = logging.getLogger(__name__)
+
+
+class LlamafileEmbeddings(BaseModel, Embeddings):
+    """Llamafile lets you distribute and run large language models with a
+    single file.
+
+    To get started, see: https://github.com/Mozilla-Ocho/llamafile
+
+    To use this class, you will need to first:
+
+    1. Download a llamafile.
+    2. Make the downloaded file executable: `chmod +x path/to/model.llamafile`
+    3. Start the llamafile in server mode with embeddings enabled:
+
+        `./path/to/model.llamafile --server --nobrowser --embedding`
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import LlamafileEmbeddings
+            embedder = LlamafileEmbeddings()
+            doc_embeddings = embedder.embed_documents(
+                [
+                    "Alpha is the first letter of the Greek alphabet",
+                    "Beta is the second letter of the Greek alphabet",
+                ]
+            )
+            query_embedding = embedder.embed_query(
+                "What is the second letter of the Greek alphabet"
+            )
+
+    """
+
+    base_url: str = "http://localhost:8080"
+    """Base url where the llamafile server is listening."""
+
+    request_timeout: Optional[int] = None
+    """Timeout for server requests"""
+
+    def _embed(self, text: str) -> List[float]:
+        try:
+            response = requests.post(
+                url=f"{self.base_url}/embedding",
+                headers={
+                    "Content-Type": "application/json",
+                },
+                json={
+                    "content": text,
+                },
+                timeout=self.request_timeout,
+            )
+        except requests.exceptions.ConnectionError:
+            raise requests.exceptions.ConnectionError(
+                f"Could not connect to Llamafile server. Please make sure "
+                f"that a server is running at {self.base_url}."
+            )
+
+        # Raise exception if we got a bad (non-200) response status code
+        response.raise_for_status()
+
+        contents = response.json()
+        if "embedding" not in contents:
+            raise KeyError(
+                "Unexpected output from /embedding endpoint, output dict "
+                "missing 'embedding' key."
+            )
+
+        embedding = contents["embedding"]
+
+        # Sanity check the embedding vector:
+        # Prior to llamafile v0.6.2, if the server was not started with the
+        # `--embedding` option, the embedding endpoint would always return a
+        # 0-vector. See issue:
+        # https://github.com/Mozilla-Ocho/llamafile/issues/243
+        # So here we raise an exception if the vector sums to exactly 0.
+        if sum(embedding) == 0.0:
+            raise ValueError(
+                "Embedding sums to 0, did you start the llamafile server with "
+                "the `--embedding` option enabled?"
+            )
+
+        return embedding
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed documents using a llamafile server running at `self.base_url`.
+        llamafile server should be started in a separate process before invoking
+        this method.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        doc_embeddings = []
+        for text in texts:
+            doc_embeddings.append(self._embed(text))
+        return doc_embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using a llamafile server running at `self.base_url`.
+        llamafile server should be started in a separate process before invoking
+        this method.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self._embed(text)
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/llm_rails.py b/llm/Lib/site-packages/langchain_community/embeddings/llm_rails.py
new file mode 100644
index 0000000000000000000000000000000000000000..c8afa11b491debd1cec5499fad6e46aa2d35cb8b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/llm_rails.py
@@ -0,0 +1,74 @@
+""" This file is for LLMRails Embedding """
+from typing import Dict, List, Optional
+
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+
+class LLMRailsEmbeddings(BaseModel, Embeddings):
+    """LLMRails embedding models.
+
+    To use, you should have the  environment
+    variable ``LLM_RAILS_API_KEY`` set with your API key or pass it
+    as a named parameter to the constructor.
+
+    Model can be one of ["embedding-english-v1","embedding-multi-v1"]
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import LLMRailsEmbeddings
+            cohere = LLMRailsEmbeddings(
+                model="embedding-english-v1", api_key="my-api-key"
+            )
+    """
+
+    model: str = "embedding-english-v1"
+    """Model name to use."""
+
+    api_key: Optional[SecretStr] = None
+    """LLMRails API key."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "api_key", "LLM_RAILS_API_KEY")
+        )
+        values["api_key"] = api_key
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Call out to Cohere's embedding endpoint.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        response = requests.post(
+            "https://api.llmrails.com/v1/embeddings",
+            headers={"X-API-KEY": self.api_key.get_secret_value()},  # type: ignore[union-attr]
+            json={"input": texts, "model": self.model},
+            timeout=60,
+        )
+        return [item["embedding"] for item in response.json()["data"]]
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to Cohere's embedding endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self.embed_documents([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/localai.py b/llm/Lib/site-packages/langchain_community/embeddings/localai.py
new file mode 100644
index 0000000000000000000000000000000000000000..b5a926e8fe2ca3ff5f89546b61e65b84b9e06dfc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/localai.py
@@ -0,0 +1,345 @@
+from __future__ import annotations
+
+import logging
+import warnings
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    Sequence,
+    Set,
+    Tuple,
+    Union,
+)
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env, get_pydantic_field_names
+from tenacity import (
+    AsyncRetrying,
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def _create_retry_decorator(embeddings: LocalAIEmbeddings) -> Callable[[Any], Any]:
+    import openai
+
+    min_seconds = 4
+    max_seconds = 10
+    # Wait 2^x * 1 second between each retry starting with
+    # 4 seconds, then up to 10 seconds, then 10 seconds afterwards
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(embeddings.max_retries),
+        wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+        retry=(
+            retry_if_exception_type(openai.error.Timeout)
+            | retry_if_exception_type(openai.error.APIError)
+            | retry_if_exception_type(openai.error.APIConnectionError)
+            | retry_if_exception_type(openai.error.RateLimitError)
+            | retry_if_exception_type(openai.error.ServiceUnavailableError)
+        ),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def _async_retry_decorator(embeddings: LocalAIEmbeddings) -> Any:
+    import openai
+
+    min_seconds = 4
+    max_seconds = 10
+    # Wait 2^x * 1 second between each retry starting with
+    # 4 seconds, then up to 10 seconds, then 10 seconds afterwards
+    async_retrying = AsyncRetrying(
+        reraise=True,
+        stop=stop_after_attempt(embeddings.max_retries),
+        wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+        retry=(
+            retry_if_exception_type(openai.error.Timeout)
+            | retry_if_exception_type(openai.error.APIError)
+            | retry_if_exception_type(openai.error.APIConnectionError)
+            | retry_if_exception_type(openai.error.RateLimitError)
+            | retry_if_exception_type(openai.error.ServiceUnavailableError)
+        ),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+    def wrap(func: Callable) -> Callable:
+        async def wrapped_f(*args: Any, **kwargs: Any) -> Callable:
+            async for _ in async_retrying:
+                return await func(*args, **kwargs)
+            raise AssertionError("this is unreachable")
+
+        return wrapped_f
+
+    return wrap
+
+
+# https://stackoverflow.com/questions/76469415/getting-embeddings-of-length-1-from-langchain-openaiembeddings
+def _check_response(response: dict) -> dict:
+    if any(len(d["embedding"]) == 1 for d in response["data"]):
+        import openai
+
+        raise openai.error.APIError("LocalAI API returned an empty embedding")
+    return response
+
+
+def embed_with_retry(embeddings: LocalAIEmbeddings, **kwargs: Any) -> Any:
+    """Use tenacity to retry the embedding call."""
+    retry_decorator = _create_retry_decorator(embeddings)
+
+    @retry_decorator
+    def _embed_with_retry(**kwargs: Any) -> Any:
+        response = embeddings.client.create(**kwargs)
+        return _check_response(response)
+
+    return _embed_with_retry(**kwargs)
+
+
+async def async_embed_with_retry(embeddings: LocalAIEmbeddings, **kwargs: Any) -> Any:
+    """Use tenacity to retry the embedding call."""
+
+    @_async_retry_decorator(embeddings)
+    async def _async_embed_with_retry(**kwargs: Any) -> Any:
+        response = await embeddings.client.acreate(**kwargs)
+        return _check_response(response)
+
+    return await _async_embed_with_retry(**kwargs)
+
+
+class LocalAIEmbeddings(BaseModel, Embeddings):
+    """LocalAI embedding models.
+
+    Since LocalAI and OpenAI have 1:1 compatibility between APIs, this class
+    uses the ``openai`` Python package's ``openai.Embedding`` as its client.
+    Thus, you should have the ``openai`` python package installed, and defeat
+    the environment variable ``OPENAI_API_KEY`` by setting to a random string.
+    You also need to specify ``OPENAI_API_BASE`` to point to your LocalAI
+    service endpoint.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import LocalAIEmbeddings
+            openai = LocalAIEmbeddings(
+                openai_api_key="random-string",
+                openai_api_base="http://localhost:8080"
+            )
+
+    """
+
+    client: Any  #: :meta private:
+    model: str = "text-embedding-ada-002"
+    deployment: str = model
+    openai_api_version: Optional[str] = None
+    openai_api_base: Optional[str] = None
+    # to support explicit proxy for LocalAI
+    openai_proxy: Optional[str] = None
+    embedding_ctx_length: int = 8191
+    """The maximum number of tokens to embed at once."""
+    openai_api_key: Optional[str] = None
+    openai_organization: Optional[str] = None
+    allowed_special: Union[Literal["all"], Set[str]] = set()
+    disallowed_special: Union[Literal["all"], Set[str], Sequence[str]] = "all"
+    chunk_size: int = 1000
+    """Maximum number of texts to embed in each batch"""
+    max_retries: int = 6
+    """Maximum number of retries to make when generating."""
+    request_timeout: Optional[Union[float, Tuple[float, float]]] = None
+    """Timeout in seconds for the LocalAI request."""
+    headers: Any = None
+    show_progress_bar: bool = False
+    """Whether to show a progress bar when embedding."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not explicitly specified."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name in extra:
+                raise ValueError(f"Found {field_name} supplied twice.")
+            if field_name not in all_required_field_names:
+                warnings.warn(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+
+        invalid_model_kwargs = all_required_field_names.intersection(extra.keys())
+        if invalid_model_kwargs:
+            raise ValueError(
+                f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+                f"Instead they were passed in as part of `model_kwargs` parameter."
+            )
+
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["openai_api_key"] = get_from_dict_or_env(
+            values, "openai_api_key", "OPENAI_API_KEY"
+        )
+        values["openai_api_base"] = get_from_dict_or_env(
+            values,
+            "openai_api_base",
+            "OPENAI_API_BASE",
+            default="",
+        )
+        values["openai_proxy"] = get_from_dict_or_env(
+            values,
+            "openai_proxy",
+            "OPENAI_PROXY",
+            default="",
+        )
+
+        default_api_version = ""
+        values["openai_api_version"] = get_from_dict_or_env(
+            values,
+            "openai_api_version",
+            "OPENAI_API_VERSION",
+            default=default_api_version,
+        )
+        values["openai_organization"] = get_from_dict_or_env(
+            values,
+            "openai_organization",
+            "OPENAI_ORGANIZATION",
+            default="",
+        )
+        try:
+            import openai
+
+            values["client"] = openai.Embedding
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+        return values
+
+    @property
+    def _invocation_params(self) -> Dict:
+        openai_args = {
+            "model": self.model,
+            "request_timeout": self.request_timeout,
+            "headers": self.headers,
+            "api_key": self.openai_api_key,
+            "organization": self.openai_organization,
+            "api_base": self.openai_api_base,
+            "api_version": self.openai_api_version,
+            **self.model_kwargs,
+        }
+        if self.openai_proxy:
+            import openai
+
+            openai.proxy = {
+                "http": self.openai_proxy,
+                "https": self.openai_proxy,
+            }  # type: ignore[assignment]  # noqa: E501
+        return openai_args
+
+    def _embedding_func(self, text: str, *, engine: str) -> List[float]:
+        """Call out to LocalAI's embedding endpoint."""
+        # handle large input text
+        if self.model.endswith("001"):
+            # See: https://github.com/openai/openai-python/issues/418#issuecomment-1525939500
+            # replace newlines, which can negatively affect performance.
+            text = text.replace("\n", " ")
+        return embed_with_retry(
+            self,
+            input=[text],
+            **self._invocation_params,
+        )["data"][0]["embedding"]
+
+    async def _aembedding_func(self, text: str, *, engine: str) -> List[float]:
+        """Call out to LocalAI's embedding endpoint."""
+        # handle large input text
+        if self.model.endswith("001"):
+            # See: https://github.com/openai/openai-python/issues/418#issuecomment-1525939500
+            # replace newlines, which can negatively affect performance.
+            text = text.replace("\n", " ")
+        return (
+            await async_embed_with_retry(
+                self,
+                input=[text],
+                **self._invocation_params,
+            )
+        )["data"][0]["embedding"]
+
+    def embed_documents(
+        self, texts: List[str], chunk_size: Optional[int] = 0
+    ) -> List[List[float]]:
+        """Call out to LocalAI's embedding endpoint for embedding search docs.
+
+        Args:
+            texts: The list of texts to embed.
+            chunk_size: The chunk size of embeddings. If None, will use the chunk size
+                specified by the class.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        # call _embedding_func for each text
+        return [self._embedding_func(text, engine=self.deployment) for text in texts]
+
+    async def aembed_documents(
+        self, texts: List[str], chunk_size: Optional[int] = 0
+    ) -> List[List[float]]:
+        """Call out to LocalAI's embedding endpoint async for embedding search docs.
+
+        Args:
+            texts: The list of texts to embed.
+            chunk_size: The chunk size of embeddings. If None, will use the chunk size
+                specified by the class.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        embeddings = []
+        for text in texts:
+            response = await self._aembedding_func(text, engine=self.deployment)
+            embeddings.append(response)
+        return embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to LocalAI's embedding endpoint for embedding query text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embedding for the text.
+        """
+        embedding = self._embedding_func(text, engine=self.deployment)
+        return embedding
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """Call out to LocalAI's embedding endpoint async for embedding query text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embedding for the text.
+        """
+        embedding = await self._aembedding_func(text, engine=self.deployment)
+        return embedding
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/minimax.py b/llm/Lib/site-packages/langchain_community/embeddings/minimax.py
new file mode 100644
index 0000000000000000000000000000000000000000..38e56c553b87d33d16393b3c60a5e642bbfd703b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/minimax.py
@@ -0,0 +1,161 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Callable, Dict, List, Optional
+
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+from tenacity import (
+    before_sleep_log,
+    retry,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def _create_retry_decorator() -> Callable[[Any], Any]:
+    """Returns a tenacity retry decorator."""
+
+    multiplier = 1
+    min_seconds = 1
+    max_seconds = 4
+    max_retries = 6
+
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(max_retries),
+        wait=wait_exponential(multiplier=multiplier, min=min_seconds, max=max_seconds),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def embed_with_retry(embeddings: MiniMaxEmbeddings, *args: Any, **kwargs: Any) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = _create_retry_decorator()
+
+    @retry_decorator
+    def _embed_with_retry(*args: Any, **kwargs: Any) -> Any:
+        return embeddings.embed(*args, **kwargs)
+
+    return _embed_with_retry(*args, **kwargs)
+
+
+class MiniMaxEmbeddings(BaseModel, Embeddings):
+    """MiniMax's embedding service.
+
+    To use, you should have the environment variable ``MINIMAX_GROUP_ID`` and
+    ``MINIMAX_API_KEY`` set with your API token, or pass it as a named parameter to
+    the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import MiniMaxEmbeddings
+            embeddings = MiniMaxEmbeddings()
+
+            query_text = "This is a test query."
+            query_result = embeddings.embed_query(query_text)
+
+            document_text = "This is a test document."
+            document_result = embeddings.embed_documents([document_text])
+
+    """
+
+    endpoint_url: str = "https://api.minimax.chat/v1/embeddings"
+    """Endpoint URL to use."""
+    model: str = "embo-01"
+    """Embeddings model name to use."""
+    embed_type_db: str = "db"
+    """For embed_documents"""
+    embed_type_query: str = "query"
+    """For embed_query"""
+
+    minimax_group_id: Optional[str] = None
+    """Group ID for MiniMax API."""
+    minimax_api_key: Optional[SecretStr] = None
+    """API Key for MiniMax API."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that group id and api key exists in environment."""
+        minimax_group_id = get_from_dict_or_env(
+            values, "minimax_group_id", "MINIMAX_GROUP_ID"
+        )
+        minimax_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "minimax_api_key", "MINIMAX_API_KEY")
+        )
+        values["minimax_group_id"] = minimax_group_id
+        values["minimax_api_key"] = minimax_api_key
+        return values
+
+    def embed(
+        self,
+        texts: List[str],
+        embed_type: str,
+    ) -> List[List[float]]:
+        payload = {
+            "model": self.model,
+            "type": embed_type,
+            "texts": texts,
+        }
+
+        # HTTP headers for authorization
+        headers = {
+            "Authorization": f"Bearer {self.minimax_api_key.get_secret_value()}",  # type: ignore[union-attr]
+            "Content-Type": "application/json",
+        }
+
+        params = {
+            "GroupId": self.minimax_group_id,
+        }
+
+        # send request
+        response = requests.post(
+            self.endpoint_url, params=params, headers=headers, json=payload
+        )
+        parsed_response = response.json()
+
+        # check for errors
+        if parsed_response["base_resp"]["status_code"] != 0:
+            raise ValueError(
+                f"MiniMax API returned an error: {parsed_response['base_resp']}"
+            )
+
+        embeddings = parsed_response["vectors"]
+
+        return embeddings
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed documents using a MiniMax embedding endpoint.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        embeddings = embed_with_retry(self, texts=texts, embed_type=self.embed_type_db)
+        return embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using a MiniMax embedding endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        embeddings = embed_with_retry(
+            self, texts=[text], embed_type=self.embed_type_query
+        )
+        return embeddings[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/mlflow.py b/llm/Lib/site-packages/langchain_community/embeddings/mlflow.py
new file mode 100644
index 0000000000000000000000000000000000000000..6261d76c16fd9a46615e8b87443465b854dc9fd8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/mlflow.py
@@ -0,0 +1,91 @@
+from __future__ import annotations
+
+from typing import Any, Dict, Iterator, List
+from urllib.parse import urlparse
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, PrivateAttr
+
+
+def _chunk(texts: List[str], size: int) -> Iterator[List[str]]:
+    for i in range(0, len(texts), size):
+        yield texts[i : i + size]
+
+
+class MlflowEmbeddings(Embeddings, BaseModel):
+    """Embedding LLMs in MLflow.
+
+    To use, you should have the `mlflow[genai]` python package installed.
+    For more information, see https://mlflow.org/docs/latest/llms/deployments.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import MlflowEmbeddings
+
+            embeddings = MlflowEmbeddings(
+                target_uri="http://localhost:5000",
+                endpoint="embeddings",
+            )
+    """
+
+    endpoint: str
+    """The endpoint to use."""
+    target_uri: str
+    """The target URI to use."""
+    _client: Any = PrivateAttr()
+    """The parameters to use for queries."""
+    query_params: Dict[str, str] = {}
+    """The parameters to use for documents."""
+    documents_params: Dict[str, str] = {}
+
+    def __init__(self, **kwargs: Any):
+        super().__init__(**kwargs)
+        self._validate_uri()
+        try:
+            from mlflow.deployments import get_deploy_client
+
+            self._client = get_deploy_client(self.target_uri)
+        except ImportError as e:
+            raise ImportError(
+                "Failed to create the client. "
+                f"Please run `pip install mlflow{self._mlflow_extras}` to install "
+                "required dependencies."
+            ) from e
+
+    @property
+    def _mlflow_extras(self) -> str:
+        return "[genai]"
+
+    def _validate_uri(self) -> None:
+        if self.target_uri == "databricks":
+            return
+        allowed = ["http", "https", "databricks"]
+        if urlparse(self.target_uri).scheme not in allowed:
+            raise ValueError(
+                f"Invalid target URI: {self.target_uri}. "
+                f"The scheme must be one of {allowed}."
+            )
+
+    def embed(self, texts: List[str], params: Dict[str, str]) -> List[List[float]]:
+        embeddings: List[List[float]] = []
+        for txt in _chunk(texts, 20):
+            resp = self._client.predict(
+                endpoint=self.endpoint,
+                inputs={"input": txt, **params},  # type: ignore[arg-type]
+            )
+            embeddings.extend(r["embedding"] for r in resp["data"])
+        return embeddings
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        return self.embed(texts, params=self.documents_params)
+
+    def embed_query(self, text: str) -> List[float]:
+        return self.embed([text], params=self.query_params)[0]
+
+
+class MlflowCohereEmbeddings(MlflowEmbeddings):
+    """Cohere embedding LLMs in MLflow."""
+
+    query_params: Dict[str, str] = {"input_type": "search_query"}
+    documents_params: Dict[str, str] = {"input_type": "search_document"}
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/mlflow_gateway.py b/llm/Lib/site-packages/langchain_community/embeddings/mlflow_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..6e2fad408a3111cc64912f04a35833e761ce76cb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/mlflow_gateway.py
@@ -0,0 +1,74 @@
+from __future__ import annotations
+
+import warnings
+from typing import Any, Iterator, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel
+
+
+def _chunk(texts: List[str], size: int) -> Iterator[List[str]]:
+    for i in range(0, len(texts), size):
+        yield texts[i : i + size]
+
+
+class MlflowAIGatewayEmbeddings(Embeddings, BaseModel):
+    """MLflow AI Gateway embeddings.
+
+    To use, you should have the ``mlflow[gateway]`` python package installed.
+    For more information, see https://mlflow.org/docs/latest/gateway/index.html.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import MlflowAIGatewayEmbeddings
+
+            embeddings = MlflowAIGatewayEmbeddings(
+                gateway_uri="<your-mlflow-ai-gateway-uri>",
+                route="<your-mlflow-ai-gateway-embeddings-route>"
+            )
+    """
+
+    route: str
+    """The route to use for the MLflow AI Gateway API."""
+    gateway_uri: Optional[str] = None
+    """The URI for the MLflow AI Gateway API."""
+
+    def __init__(self, **kwargs: Any):
+        warnings.warn(
+            "`MlflowAIGatewayEmbeddings` is deprecated. Use `MlflowEmbeddings` or "
+            "`DatabricksEmbeddings` instead.",
+            DeprecationWarning,
+        )
+        try:
+            import mlflow.gateway
+        except ImportError as e:
+            raise ImportError(
+                "Could not import `mlflow.gateway` module. "
+                "Please install it with `pip install mlflow[gateway]`."
+            ) from e
+
+        super().__init__(**kwargs)
+        if self.gateway_uri:
+            mlflow.gateway.set_gateway_uri(self.gateway_uri)
+
+    def _query(self, texts: List[str]) -> List[List[float]]:
+        try:
+            import mlflow.gateway
+        except ImportError as e:
+            raise ImportError(
+                "Could not import `mlflow.gateway` module. "
+                "Please install it with `pip install mlflow[gateway]`."
+            ) from e
+
+        embeddings = []
+        for txt in _chunk(texts, 20):
+            resp = mlflow.gateway.query(self.route, data={"text": txt})
+            embeddings.append(resp["embeddings"])
+        return embeddings
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        return self._query(texts)
+
+    def embed_query(self, text: str) -> List[float]:
+        return self._query([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/modelscope_hub.py b/llm/Lib/site-packages/langchain_community/embeddings/modelscope_hub.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc2866dedaf225508e12ec5782444e0561797dad
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/modelscope_hub.py
@@ -0,0 +1,73 @@
+from typing import Any, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra
+
+
+class ModelScopeEmbeddings(BaseModel, Embeddings):
+    """ModelScopeHub embedding models.
+
+    To use, you should have the ``modelscope`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import ModelScopeEmbeddings
+            model_id = "damo/nlp_corom_sentence-embedding_english-base"
+            embed = ModelScopeEmbeddings(model_id=model_id, model_revision="v1.0.0")
+    """
+
+    embed: Any
+    model_id: str = "damo/nlp_corom_sentence-embedding_english-base"
+    """Model name to use."""
+    model_revision: Optional[str] = None
+
+    def __init__(self, **kwargs: Any):
+        """Initialize the modelscope"""
+        super().__init__(**kwargs)
+        try:
+            from modelscope.pipelines import pipeline
+            from modelscope.utils.constant import Tasks
+        except ImportError as e:
+            raise ImportError(
+                "Could not import some python packages."
+                "Please install it with `pip install modelscope`."
+            ) from e
+        self.embed = pipeline(
+            Tasks.sentence_embedding,
+            model=self.model_id,
+            model_revision=self.model_revision,
+        )
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Compute doc embeddings using a modelscope embedding model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        texts = list(map(lambda x: x.replace("\n", " "), texts))
+        inputs = {"source_sentence": texts}
+        embeddings = self.embed(input=inputs)["text_embedding"]
+        return embeddings.tolist()
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using a modelscope embedding model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        text = text.replace("\n", " ")
+        inputs = {"source_sentence": [text]}
+        embedding = self.embed(input=inputs)["text_embedding"][0]
+        return embedding.tolist()
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/mosaicml.py b/llm/Lib/site-packages/langchain_community/embeddings/mosaicml.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd8d97bb7e89212d526bf68da2b22699772855b2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/mosaicml.py
@@ -0,0 +1,147 @@
+from typing import Any, Dict, List, Mapping, Optional, Tuple
+
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class MosaicMLInstructorEmbeddings(BaseModel, Embeddings):
+    """MosaicML embedding service.
+
+    To use, you should have the
+    environment variable ``MOSAICML_API_TOKEN`` set with your API token, or pass
+    it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import MosaicMLInstructorEmbeddings
+            endpoint_url = (
+                "https://models.hosted-on.mosaicml.hosting/instructor-large/v1/predict"
+            )
+            mosaic_llm = MosaicMLInstructorEmbeddings(
+                endpoint_url=endpoint_url,
+                mosaicml_api_token="my-api-key"
+            )
+    """
+
+    endpoint_url: str = (
+        "https://models.hosted-on.mosaicml.hosting/instructor-xl/v1/predict"
+    )
+    """Endpoint URL to use."""
+    embed_instruction: str = "Represent the document for retrieval: "
+    """Instruction used to embed documents."""
+    query_instruction: str = (
+        "Represent the question for retrieving supporting documents: "
+    )
+    """Instruction used to embed the query."""
+    retry_sleep: float = 1.0
+    """How long to try sleeping for if a rate limit is encountered"""
+
+    mosaicml_api_token: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        mosaicml_api_token = get_from_dict_or_env(
+            values, "mosaicml_api_token", "MOSAICML_API_TOKEN"
+        )
+        values["mosaicml_api_token"] = mosaicml_api_token
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {"endpoint_url": self.endpoint_url}
+
+    def _embed(
+        self, input: List[Tuple[str, str]], is_retry: bool = False
+    ) -> List[List[float]]:
+        payload = {"inputs": input}
+
+        # HTTP headers for authorization
+        headers = {
+            "Authorization": f"{self.mosaicml_api_token}",
+            "Content-Type": "application/json",
+        }
+
+        # send request
+        try:
+            response = requests.post(self.endpoint_url, headers=headers, json=payload)
+        except requests.exceptions.RequestException as e:
+            raise ValueError(f"Error raised by inference endpoint: {e}")
+
+        try:
+            if response.status_code == 429:
+                if not is_retry:
+                    import time
+
+                    time.sleep(self.retry_sleep)
+
+                    return self._embed(input, is_retry=True)
+
+                raise ValueError(
+                    f"Error raised by inference API: rate limit exceeded.\nResponse: "
+                    f"{response.text}"
+                )
+
+            parsed_response = response.json()
+
+            # The inference API has changed a couple of times, so we add some handling
+            # to be robust to multiple response formats.
+            if isinstance(parsed_response, dict):
+                output_keys = ["data", "output", "outputs"]
+                for key in output_keys:
+                    if key in parsed_response:
+                        output_item = parsed_response[key]
+                        break
+                else:
+                    raise ValueError(
+                        f"No key data or output in response: {parsed_response}"
+                    )
+
+                if isinstance(output_item, list) and isinstance(output_item[0], list):
+                    embeddings = output_item
+                else:
+                    embeddings = [output_item]
+            else:
+                raise ValueError(f"Unexpected response type: {parsed_response}")
+
+        except requests.exceptions.JSONDecodeError as e:
+            raise ValueError(
+                f"Error raised by inference API: {e}.\nResponse: {response.text}"
+            )
+
+        return embeddings
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed documents using a MosaicML deployed instructor embedding model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        instruction_pairs = [(self.embed_instruction, text) for text in texts]
+        embeddings = self._embed(instruction_pairs)
+        return embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using a MosaicML deployed instructor embedding model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        instruction_pair = (self.query_instruction, text)
+        embedding = self._embed([instruction_pair])[0]
+        return embedding
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/nemo.py b/llm/Lib/site-packages/langchain_community/embeddings/nemo.py
new file mode 100644
index 0000000000000000000000000000000000000000..f0c33c67969d5a1aa23afb97b17c5b43fe3469ee
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/nemo.py
@@ -0,0 +1,171 @@
+from __future__ import annotations
+
+import asyncio
+import json
+from typing import Any, Dict, List, Optional
+
+import aiohttp
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+
+def is_endpoint_live(url: str, headers: Optional[dict], payload: Any) -> bool:
+    """
+    Check if an endpoint is live by sending a GET request to the specified URL.
+
+    Args:
+        url (str): The URL of the endpoint to check.
+
+    Returns:
+        bool: True if the endpoint is live (status code 200), False otherwise.
+
+    Raises:
+        Exception: If the endpoint returns a non-successful status code or if there is
+            an error querying the endpoint.
+    """
+    try:
+        response = requests.request("POST", url, headers=headers, data=payload)
+
+        # Check if the status code is 200 (OK)
+        if response.status_code == 200:
+            return True
+        else:
+            # Raise an exception if the status code is not 200
+            raise Exception(
+                f"Endpoint returned a non-successful status code: "
+                f"{response.status_code}"
+            )
+    except requests.exceptions.RequestException as e:
+        # Handle any exceptions (e.g., connection errors)
+        raise Exception(f"Error querying the endpoint: {e}")
+
+
+class NeMoEmbeddings(BaseModel, Embeddings):
+    """NeMo embedding models."""
+
+    batch_size: int = 16
+    model: str = "NV-Embed-QA-003"
+    api_endpoint_url: str = "http://localhost:8088/v1/embeddings"
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the end point is alive using the values that are provided."""
+
+        url = values["api_endpoint_url"]
+        model = values["model"]
+
+        # Optional: A minimal test payload and headers required by the endpoint
+        headers = {"Content-Type": "application/json"}
+        payload = json.dumps(
+            {"input": "Hello World", "model": model, "input_type": "query"}
+        )
+
+        is_endpoint_live(url, headers, payload)
+
+        return values
+
+    async def _aembedding_func(
+        self, session: Any, text: str, input_type: str
+    ) -> List[float]:
+        """Async call out to embedding endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+
+        headers = {"Content-Type": "application/json"}
+
+        async with session.post(
+            self.api_endpoint_url,
+            json={"input": text, "model": self.model, "input_type": input_type},
+            headers=headers,
+        ) as response:
+            response.raise_for_status()
+            answer = await response.text()
+            answer = json.loads(answer)
+            return answer["data"][0]["embedding"]
+
+    def _embedding_func(self, text: str, input_type: str) -> List[float]:
+        """Call out to Cohere's embedding endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+
+        payload = json.dumps(
+            {"input": text, "model": self.model, "input_type": input_type}
+        )
+        headers = {"Content-Type": "application/json"}
+
+        response = requests.request(
+            "POST", self.api_endpoint_url, headers=headers, data=payload
+        )
+        response_json = json.loads(response.text)
+        embedding = response_json["data"][0]["embedding"]
+
+        return embedding
+
+    def embed_documents(self, documents: List[str]) -> List[List[float]]:
+        """Embed a list of document texts.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        return [self._embedding_func(text, input_type="passage") for text in documents]
+
+    def embed_query(self, text: str) -> List[float]:
+        return self._embedding_func(text, input_type="query")
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """Call out to NeMo's embedding endpoint async for embedding query text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embedding for the text.
+        """
+
+        async with aiohttp.ClientSession() as session:
+            embedding = await self._aembedding_func(session, text, "passage")
+            return embedding
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Call out to NeMo's embedding endpoint async for embedding search docs.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        embeddings = []
+
+        async with aiohttp.ClientSession() as session:
+            for batch in range(0, len(texts), self.batch_size):
+                text_batch = texts[batch : batch + self.batch_size]
+
+                for text in text_batch:
+                    # Create tasks for all texts in the batch
+                    tasks = [
+                        self._aembedding_func(session, text, "passage")
+                        for text in text_batch
+                    ]
+
+                    # Run all tasks concurrently
+                    batch_results = await asyncio.gather(*tasks)
+
+                    # Extend the embeddings list with results from this batch
+                    embeddings.extend(batch_results)
+
+        return embeddings
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/nlpcloud.py b/llm/Lib/site-packages/langchain_community/embeddings/nlpcloud.py
new file mode 100644
index 0000000000000000000000000000000000000000..748d63b90054c4c00690491e93921a82bd9e16f9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/nlpcloud.py
@@ -0,0 +1,73 @@
+from typing import Any, Dict, List
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class NLPCloudEmbeddings(BaseModel, Embeddings):
+    """NLP Cloud embedding models.
+
+    To use, you should have the nlpcloud python package installed
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import NLPCloudEmbeddings
+
+            embeddings = NLPCloudEmbeddings()
+    """
+
+    model_name: str  # Define model_name as a class attribute
+    gpu: bool  # Define gpu as a class attribute
+    client: Any  #: :meta private:
+
+    def __init__(
+        self,
+        model_name: str = "paraphrase-multilingual-mpnet-base-v2",
+        gpu: bool = False,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(model_name=model_name, gpu=gpu, **kwargs)
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        nlpcloud_api_key = get_from_dict_or_env(
+            values, "nlpcloud_api_key", "NLPCLOUD_API_KEY"
+        )
+        try:
+            import nlpcloud
+
+            values["client"] = nlpcloud.Client(
+                values["model_name"], nlpcloud_api_key, gpu=values["gpu"], lang="en"
+            )
+        except ImportError:
+            raise ImportError(
+                "Could not import nlpcloud python package. "
+                "Please install it with `pip install nlpcloud`."
+            )
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed a list of documents using NLP Cloud.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+
+        return self.client.embeddings(texts)["embeddings"]
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using NLP Cloud.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self.client.embeddings([text])["embeddings"][0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/oci_generative_ai.py b/llm/Lib/site-packages/langchain_community/embeddings/oci_generative_ai.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9495260b9177a9ef9dff3fc53923f5fad2ea7d4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/oci_generative_ai.py
@@ -0,0 +1,205 @@
+from enum import Enum
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+CUSTOM_ENDPOINT_PREFIX = "ocid1.generativeaiendpoint"
+
+
+class OCIAuthType(Enum):
+    """OCI authentication types as enumerator."""
+
+    API_KEY = 1
+    SECURITY_TOKEN = 2
+    INSTANCE_PRINCIPAL = 3
+    RESOURCE_PRINCIPAL = 4
+
+
+class OCIGenAIEmbeddings(BaseModel, Embeddings):
+    """OCI embedding models.
+
+    To authenticate, the OCI client uses the methods described in
+    https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_authentication_methods.htm
+
+    The authentifcation method is passed through auth_type and should be one of:
+    API_KEY (default), SECURITY_TOKEN, INSTANCE_PRINCIPLE, RESOURCE_PRINCIPLE
+
+    Make sure you have the required policies (profile/roles) to
+    access the OCI Generative AI service. If a specific config profile is used,
+    you must pass the name of the profile (~/.oci/config) through auth_profile.
+
+    To use, you must provide the compartment id
+    along with the endpoint url, and model id
+    as named parameters to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.embeddings import OCIGenAIEmbeddings
+
+            embeddings = OCIGenAIEmbeddings(
+                model_id="MY_EMBEDDING_MODEL",
+                service_endpoint="https://inference.generativeai.us-chicago-1.oci.oraclecloud.com",
+                compartment_id="MY_OCID"
+            )
+    """
+
+    client: Any  #: :meta private:
+
+    service_models: Any  #: :meta private:
+
+    auth_type: Optional[str] = "API_KEY"
+    """Authentication type, could be 
+
+    API_KEY, 
+    SECURITY_TOKEN, 
+    INSTANCE_PRINCIPLE, 
+    RESOURCE_PRINCIPLE
+    
+    If not specified, API_KEY will be used
+    """
+
+    auth_profile: Optional[str] = "DEFAULT"
+    """The name of the profile in ~/.oci/config
+    If not specified , DEFAULT will be used 
+    """
+
+    model_id: str = None  # type: ignore[assignment]
+    """Id of the model to call, e.g., cohere.embed-english-light-v2.0"""
+
+    model_kwargs: Optional[Dict] = None
+    """Keyword arguments to pass to the model"""
+
+    service_endpoint: str = None  # type: ignore[assignment]
+    """service endpoint url"""
+
+    compartment_id: str = None  # type: ignore[assignment]
+    """OCID of compartment"""
+
+    truncate: Optional[str] = "END"
+    """Truncate embeddings that are too long from start or end ("NONE"|"START"|"END")"""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:  # pylint: disable=no-self-argument
+        """Validate that OCI config and python package exists in environment."""
+
+        # Skip creating new client if passed in constructor
+        if values["client"] is not None:
+            return values
+
+        try:
+            import oci
+
+            client_kwargs = {
+                "config": {},
+                "signer": None,
+                "service_endpoint": values["service_endpoint"],
+                "retry_strategy": oci.retry.DEFAULT_RETRY_STRATEGY,
+                "timeout": (10, 240),  # default timeout config for OCI Gen AI service
+            }
+
+            if values["auth_type"] == OCIAuthType(1).name:
+                client_kwargs["config"] = oci.config.from_file(
+                    profile_name=values["auth_profile"]
+                )
+                client_kwargs.pop("signer", None)
+            elif values["auth_type"] == OCIAuthType(2).name:
+
+                def make_security_token_signer(oci_config):  # type: ignore[no-untyped-def]
+                    pk = oci.signer.load_private_key_from_file(
+                        oci_config.get("key_file"), None
+                    )
+                    with open(
+                        oci_config.get("security_token_file"), encoding="utf-8"
+                    ) as f:
+                        st_string = f.read()
+                    return oci.auth.signers.SecurityTokenSigner(st_string, pk)
+
+                client_kwargs["config"] = oci.config.from_file(
+                    profile_name=values["auth_profile"]
+                )
+                client_kwargs["signer"] = make_security_token_signer(
+                    oci_config=client_kwargs["config"]
+                )
+            elif values["auth_type"] == OCIAuthType(3).name:
+                client_kwargs[
+                    "signer"
+                ] = oci.auth.signers.InstancePrincipalsSecurityTokenSigner()
+            elif values["auth_type"] == OCIAuthType(4).name:
+                client_kwargs[
+                    "signer"
+                ] = oci.auth.signers.get_resource_principals_signer()
+            else:
+                raise ValueError("Please provide valid value to auth_type")
+
+            values["client"] = oci.generative_ai_inference.GenerativeAiInferenceClient(
+                **client_kwargs
+            )
+
+        except ImportError as ex:
+            raise ModuleNotFoundError(
+                "Could not import oci python package. "
+                "Please make sure you have the oci package installed."
+            ) from ex
+        except Exception as e:
+            raise ValueError(
+                "Could not authenticate with OCI client. "
+                "Please check if ~/.oci/config exists. "
+                "If INSTANCE_PRINCIPLE or RESOURCE_PRINCIPLE is used, "
+                "Please check the specified "
+                "auth_profile and auth_type are valid."
+            ) from e
+
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Call out to OCIGenAI's embedding endpoint.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        from oci.generative_ai_inference import models
+
+        if self.model_id.startswith(CUSTOM_ENDPOINT_PREFIX):
+            serving_mode = models.DedicatedServingMode(endpoint_id=self.model_id)
+        else:
+            serving_mode = models.OnDemandServingMode(model_id=self.model_id)
+
+        invocation_obj = models.EmbedTextDetails(
+            serving_mode=serving_mode,
+            compartment_id=self.compartment_id,
+            truncate=self.truncate,
+            inputs=texts,
+        )
+
+        response = self.client.embed_text(invocation_obj)
+
+        return response.data.embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to OCIGenAI's embedding endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self.embed_documents([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/octoai_embeddings.py b/llm/Lib/site-packages/langchain_community/embeddings/octoai_embeddings.py
new file mode 100644
index 0000000000000000000000000000000000000000..f006a437a4ee33e73be4c7f038d4899bd285930c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/octoai_embeddings.py
@@ -0,0 +1,100 @@
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+DEFAULT_EMBED_INSTRUCTION = "Represent this input: "
+DEFAULT_QUERY_INSTRUCTION = "Represent the question for retrieving similar documents: "
+
+
+class OctoAIEmbeddings(BaseModel, Embeddings):
+    """OctoAI Compute Service embedding models.
+
+    The environment variable ``OCTOAI_API_TOKEN`` should be set
+    with your API token, or it can be passed
+    as a named parameter to the constructor.
+    """
+
+    endpoint_url: Optional[str] = Field(None, description="Endpoint URL to use.")
+    model_kwargs: Optional[dict] = Field(
+        None, description="Keyword arguments to pass to the model."
+    )
+    octoai_api_token: Optional[str] = Field(None, description="OCTOAI API Token")
+    embed_instruction: str = Field(
+        DEFAULT_EMBED_INSTRUCTION,
+        description="Instruction to use for embedding documents.",
+    )
+    query_instruction: str = Field(
+        DEFAULT_QUERY_INSTRUCTION, description="Instruction to use for embedding query."
+    )
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(allow_reuse=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Ensure that the API key and python package exist in environment."""
+        values["octoai_api_token"] = get_from_dict_or_env(
+            values, "octoai_api_token", "OCTOAI_API_TOKEN"
+        )
+        values["endpoint_url"] = get_from_dict_or_env(
+            values, "endpoint_url", "https://text.octoai.run/v1/embeddings"
+        )
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Return the identifying parameters."""
+        return {
+            "endpoint_url": self.endpoint_url,
+            "model_kwargs": self.model_kwargs or {},
+        }
+
+    def _compute_embeddings(
+        self, texts: List[str], instruction: str
+    ) -> List[List[float]]:
+        """Compute embeddings using an OctoAI instruct model."""
+        from octoai import client
+
+        embedding = []
+        embeddings = []
+        octoai_client = client.Client(token=self.octoai_api_token)
+
+        for text in texts:
+            parameter_payload = {
+                "sentence": str([text]),
+                "input": str([text]),
+                "instruction": str([instruction]),
+                "model": "thenlper/gte-large",
+                "parameters": self.model_kwargs or {},
+            }
+
+            try:
+                resp_json = octoai_client.infer(self.endpoint_url, parameter_payload)
+                if "embeddings" in resp_json:
+                    embedding = resp_json["embeddings"]
+                elif "data" in resp_json:
+                    json_data = resp_json["data"]
+                    for item in json_data:
+                        if "embedding" in item:
+                            embedding = item["embedding"]
+
+            except Exception as e:
+                raise ValueError(f"Error raised by the inference endpoint: {e}") from e
+
+            embeddings.append(embedding)
+
+        return embeddings
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Compute document embeddings using an OctoAI instruct model."""
+        texts = list(map(lambda x: x.replace("\n", " "), texts))
+        return self._compute_embeddings(texts, self.embed_instruction)
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embedding using an OctoAI instruct model."""
+        text = text.replace("\n", " ")
+        return self._compute_embeddings([text], self.query_instruction)[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/ollama.py b/llm/Lib/site-packages/langchain_community/embeddings/ollama.py
new file mode 100644
index 0000000000000000000000000000000000000000..b1fd668b42a9e7aeb9ff0de3c80ce28d4dc093a5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/ollama.py
@@ -0,0 +1,225 @@
+import logging
+from typing import Any, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra
+
+logger = logging.getLogger(__name__)
+
+
+class OllamaEmbeddings(BaseModel, Embeddings):
+    """Ollama locally runs large language models.
+
+    To use, follow the instructions at https://ollama.ai/.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import OllamaEmbeddings
+            ollama_emb = OllamaEmbeddings(
+                model="llama:7b",
+            )
+            r1 = ollama_emb.embed_documents(
+                [
+                    "Alpha is the first letter of Greek alphabet",
+                    "Beta is the second letter of Greek alphabet",
+                ]
+            )
+            r2 = ollama_emb.embed_query(
+                "What is the second letter of Greek alphabet"
+            )
+
+    """
+
+    base_url: str = "http://localhost:11434"
+    """Base url the model is hosted under."""
+    model: str = "llama2"
+    """Model name to use."""
+
+    embed_instruction: str = "passage: "
+    """Instruction used to embed documents."""
+    query_instruction: str = "query: "
+    """Instruction used to embed the query."""
+
+    mirostat: Optional[int] = None
+    """Enable Mirostat sampling for controlling perplexity.
+    (default: 0, 0 = disabled, 1 = Mirostat, 2 = Mirostat 2.0)"""
+
+    mirostat_eta: Optional[float] = None
+    """Influences how quickly the algorithm responds to feedback
+    from the generated text. A lower learning rate will result in
+    slower adjustments, while a higher learning rate will make
+    the algorithm more responsive. (Default: 0.1)"""
+
+    mirostat_tau: Optional[float] = None
+    """Controls the balance between coherence and diversity
+    of the output. A lower value will result in more focused and
+    coherent text. (Default: 5.0)"""
+
+    num_ctx: Optional[int] = None
+    """Sets the size of the context window used to generate the
+    next token. (Default: 2048)	"""
+
+    num_gpu: Optional[int] = None
+    """The number of GPUs to use. On macOS it defaults to 1 to
+    enable metal support, 0 to disable."""
+
+    num_thread: Optional[int] = None
+    """Sets the number of threads to use during computation.
+    By default, Ollama will detect this for optimal performance.
+    It is recommended to set this value to the number of physical
+    CPU cores your system has (as opposed to the logical number of cores)."""
+
+    repeat_last_n: Optional[int] = None
+    """Sets how far back for the model to look back to prevent
+    repetition. (Default: 64, 0 = disabled, -1 = num_ctx)"""
+
+    repeat_penalty: Optional[float] = None
+    """Sets how strongly to penalize repetitions. A higher value (e.g., 1.5)
+    will penalize repetitions more strongly, while a lower value (e.g., 0.9)
+    will be more lenient. (Default: 1.1)"""
+
+    temperature: Optional[float] = None
+    """The temperature of the model. Increasing the temperature will
+    make the model answer more creatively. (Default: 0.8)"""
+
+    stop: Optional[List[str]] = None
+    """Sets the stop tokens to use."""
+
+    tfs_z: Optional[float] = None
+    """Tail free sampling is used to reduce the impact of less probable
+    tokens from the output. A higher value (e.g., 2.0) will reduce the
+    impact more, while a value of 1.0 disables this setting. (default: 1)"""
+
+    top_k: Optional[int] = None
+    """Reduces the probability of generating nonsense. A higher value (e.g. 100)
+    will give more diverse answers, while a lower value (e.g. 10)
+    will be more conservative. (Default: 40)"""
+
+    top_p: Optional[float] = None
+    """Works together with top-k. A higher value (e.g., 0.95) will lead
+    to more diverse text, while a lower value (e.g., 0.5) will
+    generate more focused and conservative text. (Default: 0.9)"""
+
+    show_progress: bool = False
+    """Whether to show a tqdm progress bar. Must have `tqdm` installed."""
+
+    headers: Optional[dict] = None
+    """Additional headers to pass to endpoint (e.g. Authorization, Referer).
+    This is useful when Ollama is hosted on cloud services that require
+    tokens for authentication.
+    """
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Ollama."""
+        return {
+            "model": self.model,
+            "options": {
+                "mirostat": self.mirostat,
+                "mirostat_eta": self.mirostat_eta,
+                "mirostat_tau": self.mirostat_tau,
+                "num_ctx": self.num_ctx,
+                "num_gpu": self.num_gpu,
+                "num_thread": self.num_thread,
+                "repeat_last_n": self.repeat_last_n,
+                "repeat_penalty": self.repeat_penalty,
+                "temperature": self.temperature,
+                "stop": self.stop,
+                "tfs_z": self.tfs_z,
+                "top_k": self.top_k,
+                "top_p": self.top_p,
+            },
+        }
+
+    model_kwargs: Optional[dict] = None
+    """Other model keyword args"""
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model": self.model}, **self._default_params}
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def _process_emb_response(self, input: str) -> List[float]:
+        """Process a response from the API.
+
+        Args:
+            response: The response from the API.
+
+        Returns:
+            The response as a dictionary.
+        """
+        headers = {
+            "Content-Type": "application/json",
+            **(self.headers or {}),
+        }
+
+        try:
+            res = requests.post(
+                f"{self.base_url}/api/embeddings",
+                headers=headers,
+                json={"model": self.model, "prompt": input, **self._default_params},
+            )
+        except requests.exceptions.RequestException as e:
+            raise ValueError(f"Error raised by inference endpoint: {e}")
+
+        if res.status_code != 200:
+            raise ValueError(
+                "Error raised by inference API HTTP code: %s, %s"
+                % (res.status_code, res.text)
+            )
+        try:
+            t = res.json()
+            return t["embedding"]
+        except requests.exceptions.JSONDecodeError as e:
+            raise ValueError(
+                f"Error raised by inference API: {e}.\nResponse: {res.text}"
+            )
+
+    def _embed(self, input: List[str]) -> List[List[float]]:
+        if self.show_progress:
+            try:
+                from tqdm import tqdm
+
+                iter_ = tqdm(input, desc="OllamaEmbeddings")
+            except ImportError:
+                logger.warning(
+                    "Unable to show progress bar because tqdm could not be imported. "
+                    "Please install with `pip install tqdm`."
+                )
+                iter_ = input
+        else:
+            iter_ = input
+        return [self._process_emb_response(prompt) for prompt in iter_]
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed documents using an Ollama deployed embedding model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        instruction_pairs = [f"{self.embed_instruction}{text}" for text in texts]
+        embeddings = self._embed(instruction_pairs)
+        return embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using a Ollama deployed embedding model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        instruction_pair = f"{self.query_instruction}{text}"
+        embedding = self._embed([instruction_pair])[0]
+        return embedding
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/openai.py b/llm/Lib/site-packages/langchain_community/embeddings/openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..5611f9d69891467d77babe650e6d9d7e914d69c4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/openai.py
@@ -0,0 +1,709 @@
+from __future__ import annotations
+
+import logging
+import os
+import warnings
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    List,
+    Literal,
+    Mapping,
+    Optional,
+    Sequence,
+    Set,
+    Tuple,
+    Union,
+    cast,
+)
+
+import numpy as np
+from langchain_core._api.deprecation import deprecated
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env, get_pydantic_field_names
+from tenacity import (
+    AsyncRetrying,
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+from langchain_community.utils.openai import is_openai_v1
+
+logger = logging.getLogger(__name__)
+
+
+def _create_retry_decorator(embeddings: OpenAIEmbeddings) -> Callable[[Any], Any]:
+    import openai
+
+    # Wait 2^x * 1 second between each retry starting with
+    # retry_min_seconds seconds, then up to retry_max_seconds seconds,
+    # then retry_max_seconds seconds afterwards
+    # retry_min_seconds and retry_max_seconds are optional arguments of
+    # OpenAIEmbeddings
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(embeddings.max_retries),
+        wait=wait_exponential(
+            multiplier=1,
+            min=embeddings.retry_min_seconds,
+            max=embeddings.retry_max_seconds,
+        ),
+        retry=(
+            retry_if_exception_type(openai.error.Timeout)
+            | retry_if_exception_type(openai.error.APIError)
+            | retry_if_exception_type(openai.error.APIConnectionError)
+            | retry_if_exception_type(openai.error.RateLimitError)
+            | retry_if_exception_type(openai.error.ServiceUnavailableError)
+        ),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def _async_retry_decorator(embeddings: OpenAIEmbeddings) -> Any:
+    import openai
+
+    # Wait 2^x * 1 second between each retry starting with
+    # retry_min_seconds seconds, then up to retry_max_seconds seconds,
+    # then retry_max_seconds seconds afterwards
+    # retry_min_seconds and retry_max_seconds are optional arguments of
+    # OpenAIEmbeddings
+    async_retrying = AsyncRetrying(
+        reraise=True,
+        stop=stop_after_attempt(embeddings.max_retries),
+        wait=wait_exponential(
+            multiplier=1,
+            min=embeddings.retry_min_seconds,
+            max=embeddings.retry_max_seconds,
+        ),
+        retry=(
+            retry_if_exception_type(openai.error.Timeout)
+            | retry_if_exception_type(openai.error.APIError)
+            | retry_if_exception_type(openai.error.APIConnectionError)
+            | retry_if_exception_type(openai.error.RateLimitError)
+            | retry_if_exception_type(openai.error.ServiceUnavailableError)
+        ),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+    def wrap(func: Callable) -> Callable:
+        async def wrapped_f(*args: Any, **kwargs: Any) -> Callable:
+            async for _ in async_retrying:
+                return await func(*args, **kwargs)
+            raise AssertionError("this is unreachable")
+
+        return wrapped_f
+
+    return wrap
+
+
+# https://stackoverflow.com/questions/76469415/getting-embeddings-of-length-1-from-langchain-openaiembeddings
+def _check_response(response: dict, skip_empty: bool = False) -> dict:
+    if any(len(d["embedding"]) == 1 for d in response["data"]) and not skip_empty:
+        import openai
+
+        raise openai.error.APIError("OpenAI API returned an empty embedding")
+    return response
+
+
+def embed_with_retry(embeddings: OpenAIEmbeddings, **kwargs: Any) -> Any:
+    """Use tenacity to retry the embedding call."""
+    if is_openai_v1():
+        return embeddings.client.create(**kwargs)
+    retry_decorator = _create_retry_decorator(embeddings)
+
+    @retry_decorator
+    def _embed_with_retry(**kwargs: Any) -> Any:
+        response = embeddings.client.create(**kwargs)
+        return _check_response(response, skip_empty=embeddings.skip_empty)
+
+    return _embed_with_retry(**kwargs)
+
+
+async def async_embed_with_retry(embeddings: OpenAIEmbeddings, **kwargs: Any) -> Any:
+    """Use tenacity to retry the embedding call."""
+
+    if is_openai_v1():
+        return await embeddings.async_client.create(**kwargs)
+
+    @_async_retry_decorator(embeddings)
+    async def _async_embed_with_retry(**kwargs: Any) -> Any:
+        response = await embeddings.client.acreate(**kwargs)
+        return _check_response(response, skip_empty=embeddings.skip_empty)
+
+    return await _async_embed_with_retry(**kwargs)
+
+
+@deprecated(
+    since="0.0.9",
+    removal="0.2.0",
+    alternative_import="langchain_openai.OpenAIEmbeddings",
+)
+class OpenAIEmbeddings(BaseModel, Embeddings):
+    """OpenAI embedding models.
+
+    To use, you should have the ``openai`` python package installed, and the
+    environment variable ``OPENAI_API_KEY`` set with your API key or pass it
+    as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import OpenAIEmbeddings
+            openai = OpenAIEmbeddings(openai_api_key="my-api-key")
+
+    In order to use the library with Microsoft Azure endpoints, you need to set
+    the OPENAI_API_TYPE, OPENAI_API_BASE, OPENAI_API_KEY and OPENAI_API_VERSION.
+    The OPENAI_API_TYPE must be set to 'azure' and the others correspond to
+    the properties of your endpoint.
+    In addition, the deployment name must be passed as the model parameter.
+
+    Example:
+        .. code-block:: python
+
+            import os
+
+            os.environ["OPENAI_API_TYPE"] = "azure"
+            os.environ["OPENAI_API_BASE"] = "https://<your-endpoint.openai.azure.com/"
+            os.environ["OPENAI_API_KEY"] = "your AzureOpenAI key"
+            os.environ["OPENAI_API_VERSION"] = "2023-05-15"
+            os.environ["OPENAI_PROXY"] = "http://your-corporate-proxy:8080"
+
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+            embeddings = OpenAIEmbeddings(
+                deployment="your-embeddings-deployment-name",
+                model="your-embeddings-model-name",
+                openai_api_base="https://your-endpoint.openai.azure.com/",
+                openai_api_type="azure",
+            )
+            text = "This is a test query."
+            query_result = embeddings.embed_query(text)
+
+    """
+
+    client: Any = Field(default=None, exclude=True)  #: :meta private:
+    async_client: Any = Field(default=None, exclude=True)  #: :meta private:
+    model: str = "text-embedding-ada-002"
+    # to support Azure OpenAI Service custom deployment names
+    deployment: Optional[str] = model
+    # TODO: Move to AzureOpenAIEmbeddings.
+    openai_api_version: Optional[str] = Field(default=None, alias="api_version")
+    """Automatically inferred from env var `OPENAI_API_VERSION` if not provided."""
+    # to support Azure OpenAI Service custom endpoints
+    openai_api_base: Optional[str] = Field(default=None, alias="base_url")
+    """Base URL path for API requests, leave blank if not using a proxy or service 
+        emulator."""
+    # to support Azure OpenAI Service custom endpoints
+    openai_api_type: Optional[str] = None
+    # to support explicit proxy for OpenAI
+    openai_proxy: Optional[str] = None
+    embedding_ctx_length: int = 8191
+    """The maximum number of tokens to embed at once."""
+    openai_api_key: Optional[str] = Field(default=None, alias="api_key")
+    """Automatically inferred from env var `OPENAI_API_KEY` if not provided."""
+    openai_organization: Optional[str] = Field(default=None, alias="organization")
+    """Automatically inferred from env var `OPENAI_ORG_ID` if not provided."""
+    allowed_special: Union[Literal["all"], Set[str]] = set()
+    disallowed_special: Union[Literal["all"], Set[str], Sequence[str]] = "all"
+    chunk_size: int = 1000
+    """Maximum number of texts to embed in each batch"""
+    max_retries: int = 2
+    """Maximum number of retries to make when generating."""
+    request_timeout: Optional[Union[float, Tuple[float, float], Any]] = Field(
+        default=None, alias="timeout"
+    )
+    """Timeout for requests to OpenAI completion API. Can be float, httpx.Timeout or 
+        None."""
+    headers: Any = None
+    tiktoken_enabled: bool = True
+    """Set this to False for non-OpenAI implementations of the embeddings API, e.g.
+    the `--extensions openai` extension for `text-generation-webui`"""
+    tiktoken_model_name: Optional[str] = None
+    """The model name to pass to tiktoken when using this class. 
+    Tiktoken is used to count the number of tokens in documents to constrain 
+    them to be under a certain limit. By default, when set to None, this will 
+    be the same as the embedding model name. However, there are some cases 
+    where you may want to use this Embedding class with a model name not 
+    supported by tiktoken. This can include when using Azure embeddings or 
+    when using one of the many model providers that expose an OpenAI-like 
+    API but with different models. In those cases, in order to avoid erroring 
+    when tiktoken is called, you can specify a model name to use here."""
+    show_progress_bar: bool = False
+    """Whether to show a progress bar when embedding."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not explicitly specified."""
+    skip_empty: bool = False
+    """Whether to skip empty strings when embedding or raise an error.
+    Defaults to not skipping."""
+    default_headers: Union[Mapping[str, str], None] = None
+    default_query: Union[Mapping[str, object], None] = None
+    # Configure a custom httpx client. See the
+    # [httpx documentation](https://www.python-httpx.org/api/#client) for more details.
+    retry_min_seconds: int = 4
+    """Min number of seconds to wait between retries"""
+    retry_max_seconds: int = 20
+    """Max number of seconds to wait between retries"""
+    http_client: Union[Any, None] = None
+    """Optional httpx.Client."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        allow_population_by_field_name = True
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name in extra:
+                raise ValueError(f"Found {field_name} supplied twice.")
+            if field_name not in all_required_field_names:
+                warnings.warn(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+
+        invalid_model_kwargs = all_required_field_names.intersection(extra.keys())
+        if invalid_model_kwargs:
+            raise ValueError(
+                f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+                f"Instead they were passed in as part of `model_kwargs` parameter."
+            )
+
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["openai_api_key"] = get_from_dict_or_env(
+            values, "openai_api_key", "OPENAI_API_KEY"
+        )
+        values["openai_api_base"] = values["openai_api_base"] or os.getenv(
+            "OPENAI_API_BASE"
+        )
+        values["openai_api_type"] = get_from_dict_or_env(
+            values,
+            "openai_api_type",
+            "OPENAI_API_TYPE",
+            default="",
+        )
+        values["openai_proxy"] = get_from_dict_or_env(
+            values,
+            "openai_proxy",
+            "OPENAI_PROXY",
+            default="",
+        )
+        if values["openai_api_type"] in ("azure", "azure_ad", "azuread"):
+            default_api_version = "2023-05-15"
+            # Azure OpenAI embedding models allow a maximum of 16 texts
+            # at a time in each batch
+            # See: https://learn.microsoft.com/en-us/azure/ai-services/openai/reference#embeddings
+            values["chunk_size"] = min(values["chunk_size"], 16)
+        else:
+            default_api_version = ""
+        values["openai_api_version"] = get_from_dict_or_env(
+            values,
+            "openai_api_version",
+            "OPENAI_API_VERSION",
+            default=default_api_version,
+        )
+        # Check OPENAI_ORGANIZATION for backwards compatibility.
+        values["openai_organization"] = (
+            values["openai_organization"]
+            or os.getenv("OPENAI_ORG_ID")
+            or os.getenv("OPENAI_ORGANIZATION")
+        )
+        try:
+            import openai
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+        else:
+            if is_openai_v1():
+                if values["openai_api_type"] in ("azure", "azure_ad", "azuread"):
+                    warnings.warn(
+                        "If you have openai>=1.0.0 installed and are using Azure, "
+                        "please use the `AzureOpenAIEmbeddings` class."
+                    )
+                client_params = {
+                    "api_key": values["openai_api_key"],
+                    "organization": values["openai_organization"],
+                    "base_url": values["openai_api_base"],
+                    "timeout": values["request_timeout"],
+                    "max_retries": values["max_retries"],
+                    "default_headers": values["default_headers"],
+                    "default_query": values["default_query"],
+                    "http_client": values["http_client"],
+                }
+                if not values.get("client"):
+                    values["client"] = openai.OpenAI(**client_params).embeddings
+                if not values.get("async_client"):
+                    values["async_client"] = openai.AsyncOpenAI(
+                        **client_params
+                    ).embeddings
+            elif not values.get("client"):
+                values["client"] = openai.Embedding
+            else:
+                pass
+        return values
+
+    @property
+    def _invocation_params(self) -> Dict[str, Any]:
+        if is_openai_v1():
+            openai_args: Dict = {"model": self.model, **self.model_kwargs}
+        else:
+            openai_args = {
+                "model": self.model,
+                "request_timeout": self.request_timeout,
+                "headers": self.headers,
+                "api_key": self.openai_api_key,
+                "organization": self.openai_organization,
+                "api_base": self.openai_api_base,
+                "api_type": self.openai_api_type,
+                "api_version": self.openai_api_version,
+                **self.model_kwargs,
+            }
+            if self.openai_api_type in ("azure", "azure_ad", "azuread"):
+                openai_args["engine"] = self.deployment
+            # TODO: Look into proxy with openai v1.
+            if self.openai_proxy:
+                try:
+                    import openai
+                except ImportError:
+                    raise ImportError(
+                        "Could not import openai python package. "
+                        "Please install it with `pip install openai`."
+                    )
+
+                openai.proxy = {
+                    "http": self.openai_proxy,
+                    "https": self.openai_proxy,
+                }  # type: ignore[assignment]  # noqa: E501
+        return openai_args
+
+    # please refer to
+    # https://github.com/openai/openai-cookbook/blob/main/examples/Embedding_long_inputs.ipynb
+    def _get_len_safe_embeddings(
+        self, texts: List[str], *, engine: str, chunk_size: Optional[int] = None
+    ) -> List[List[float]]:
+        """
+        Generate length-safe embeddings for a list of texts.
+
+        This method handles tokenization and embedding generation, respecting the
+        set embedding context length and chunk size. It supports both tiktoken
+        and HuggingFace tokenizer based on the tiktoken_enabled flag.
+
+        Args:
+            texts (List[str]): A list of texts to embed.
+            engine (str): The engine or model to use for embeddings.
+            chunk_size (Optional[int]): The size of chunks for processing embeddings.
+
+        Returns:
+            List[List[float]]: A list of embeddings for each input text.
+        """
+
+        tokens = []
+        indices = []
+        model_name = self.tiktoken_model_name or self.model
+        _chunk_size = chunk_size or self.chunk_size
+
+        # If tiktoken flag set to False
+        if not self.tiktoken_enabled:
+            try:
+                from transformers import AutoTokenizer
+            except ImportError:
+                raise ValueError(
+                    "Could not import transformers python package. "
+                    "This is needed in order to for OpenAIEmbeddings without "
+                    "`tiktoken`. Please install it with `pip install transformers`. "
+                )
+
+            tokenizer = AutoTokenizer.from_pretrained(
+                pretrained_model_name_or_path=model_name
+            )
+            for i, text in enumerate(texts):
+                # Tokenize the text using HuggingFace transformers
+                tokenized = tokenizer.encode(text, add_special_tokens=False)
+
+                # Split tokens into chunks respecting the embedding_ctx_length
+                for j in range(0, len(tokenized), self.embedding_ctx_length):
+                    token_chunk = tokenized[j : j + self.embedding_ctx_length]
+
+                    # Convert token IDs back to a string
+                    chunk_text = tokenizer.decode(token_chunk)
+                    tokens.append(chunk_text)
+                    indices.append(i)
+        else:
+            try:
+                import tiktoken
+            except ImportError:
+                raise ImportError(
+                    "Could not import tiktoken python package. "
+                    "This is needed in order to for OpenAIEmbeddings. "
+                    "Please install it with `pip install tiktoken`."
+                )
+
+            try:
+                encoding = tiktoken.encoding_for_model(model_name)
+            except KeyError:
+                logger.warning("Warning: model not found. Using cl100k_base encoding.")
+                model = "cl100k_base"
+                encoding = tiktoken.get_encoding(model)
+            for i, text in enumerate(texts):
+                if self.model.endswith("001"):
+                    # See: https://github.com/openai/openai-python/
+                    #      issues/418#issuecomment-1525939500
+                    # replace newlines, which can negatively affect performance.
+                    text = text.replace("\n", " ")
+
+                token = encoding.encode(
+                    text=text,
+                    allowed_special=self.allowed_special,
+                    disallowed_special=self.disallowed_special,
+                )
+
+                # Split tokens into chunks respecting the embedding_ctx_length
+                for j in range(0, len(token), self.embedding_ctx_length):
+                    tokens.append(token[j : j + self.embedding_ctx_length])
+                    indices.append(i)
+
+        if self.show_progress_bar:
+            try:
+                from tqdm.auto import tqdm
+
+                _iter = tqdm(range(0, len(tokens), _chunk_size))
+            except ImportError:
+                _iter = range(0, len(tokens), _chunk_size)
+        else:
+            _iter = range(0, len(tokens), _chunk_size)
+
+        batched_embeddings: List[List[float]] = []
+        for i in _iter:
+            response = embed_with_retry(
+                self,
+                input=tokens[i : i + _chunk_size],
+                **self._invocation_params,
+            )
+            if not isinstance(response, dict):
+                response = response.dict()
+            batched_embeddings.extend(r["embedding"] for r in response["data"])
+
+        results: List[List[List[float]]] = [[] for _ in range(len(texts))]
+        num_tokens_in_batch: List[List[int]] = [[] for _ in range(len(texts))]
+        for i in range(len(indices)):
+            if self.skip_empty and len(batched_embeddings[i]) == 1:
+                continue
+            results[indices[i]].append(batched_embeddings[i])
+            num_tokens_in_batch[indices[i]].append(len(tokens[i]))
+
+        embeddings: List[List[float]] = [[] for _ in range(len(texts))]
+        for i in range(len(texts)):
+            _result = results[i]
+            if len(_result) == 0:
+                average_embedded = embed_with_retry(
+                    self,
+                    input="",
+                    **self._invocation_params,
+                )
+                if not isinstance(average_embedded, dict):
+                    average_embedded = average_embedded.dict()
+                average = average_embedded["data"][0]["embedding"]
+            else:
+                average = np.average(_result, axis=0, weights=num_tokens_in_batch[i])
+            embeddings[i] = (average / np.linalg.norm(average)).tolist()
+
+        return embeddings
+
+    # please refer to
+    # https://github.com/openai/openai-cookbook/blob/main/examples/Embedding_long_inputs.ipynb
+    async def _aget_len_safe_embeddings(
+        self, texts: List[str], *, engine: str, chunk_size: Optional[int] = None
+    ) -> List[List[float]]:
+        """
+        Asynchronously generate length-safe embeddings for a list of texts.
+
+        This method handles tokenization and asynchronous embedding generation,
+        respecting the set embedding context length and chunk size. It supports both
+        `tiktoken` and HuggingFace `tokenizer` based on the tiktoken_enabled flag.
+
+        Args:
+            texts (List[str]): A list of texts to embed.
+            engine (str): The engine or model to use for embeddings.
+            chunk_size (Optional[int]): The size of chunks for processing embeddings.
+
+        Returns:
+            List[List[float]]: A list of embeddings for each input text.
+        """
+
+        tokens = []
+        indices = []
+        model_name = self.tiktoken_model_name or self.model
+        _chunk_size = chunk_size or self.chunk_size
+
+        # If tiktoken flag set to False
+        if not self.tiktoken_enabled:
+            try:
+                from transformers import AutoTokenizer
+            except ImportError:
+                raise ValueError(
+                    "Could not import transformers python package. "
+                    "This is needed in order to for OpenAIEmbeddings without "
+                    " `tiktoken`. Please install it with `pip install transformers`."
+                )
+
+            tokenizer = AutoTokenizer.from_pretrained(
+                pretrained_model_name_or_path=model_name
+            )
+            for i, text in enumerate(texts):
+                # Tokenize the text using HuggingFace transformers
+                tokenized = tokenizer.encode(text, add_special_tokens=False)
+
+                # Split tokens into chunks respecting the embedding_ctx_length
+                for j in range(0, len(tokenized), self.embedding_ctx_length):
+                    token_chunk = tokenized[j : j + self.embedding_ctx_length]
+
+                    # Convert token IDs back to a string
+                    chunk_text = tokenizer.decode(token_chunk)
+                    tokens.append(chunk_text)
+                    indices.append(i)
+        else:
+            try:
+                import tiktoken
+            except ImportError:
+                raise ImportError(
+                    "Could not import tiktoken python package. "
+                    "This is needed in order to for OpenAIEmbeddings. "
+                    "Please install it with `pip install tiktoken`."
+                )
+
+            try:
+                encoding = tiktoken.encoding_for_model(model_name)
+            except KeyError:
+                logger.warning("Warning: model not found. Using cl100k_base encoding.")
+                model = "cl100k_base"
+                encoding = tiktoken.get_encoding(model)
+            for i, text in enumerate(texts):
+                if self.model.endswith("001"):
+                    # See: https://github.com/openai/openai-python/
+                    #      issues/418#issuecomment-1525939500
+                    # replace newlines, which can negatively affect performance.
+                    text = text.replace("\n", " ")
+
+                token = encoding.encode(
+                    text=text,
+                    allowed_special=self.allowed_special,
+                    disallowed_special=self.disallowed_special,
+                )
+
+                # Split tokens into chunks respecting the embedding_ctx_length
+                for j in range(0, len(token), self.embedding_ctx_length):
+                    tokens.append(token[j : j + self.embedding_ctx_length])
+                    indices.append(i)
+
+        batched_embeddings: List[List[float]] = []
+        _chunk_size = chunk_size or self.chunk_size
+        for i in range(0, len(tokens), _chunk_size):
+            response = await async_embed_with_retry(
+                self,
+                input=tokens[i : i + _chunk_size],
+                **self._invocation_params,
+            )
+
+            if not isinstance(response, dict):
+                response = response.dict()
+            batched_embeddings.extend(r["embedding"] for r in response["data"])
+
+        results: List[List[List[float]]] = [[] for _ in range(len(texts))]
+        num_tokens_in_batch: List[List[int]] = [[] for _ in range(len(texts))]
+        for i in range(len(indices)):
+            results[indices[i]].append(batched_embeddings[i])
+            num_tokens_in_batch[indices[i]].append(len(tokens[i]))
+
+        embeddings: List[List[float]] = [[] for _ in range(len(texts))]
+        for i in range(len(texts)):
+            _result = results[i]
+            if len(_result) == 0:
+                average_embedded = await async_embed_with_retry(
+                    self,
+                    input="",
+                    **self._invocation_params,
+                )
+                if not isinstance(average_embedded, dict):
+                    average_embedded = average_embedded.dict()
+                average = average_embedded["data"][0]["embedding"]
+            else:
+                average = np.average(_result, axis=0, weights=num_tokens_in_batch[i])
+            embeddings[i] = (average / np.linalg.norm(average)).tolist()
+
+        return embeddings
+
+    def embed_documents(
+        self, texts: List[str], chunk_size: Optional[int] = 0
+    ) -> List[List[float]]:
+        """Call out to OpenAI's embedding endpoint for embedding search docs.
+
+        Args:
+            texts: The list of texts to embed.
+            chunk_size: The chunk size of embeddings. If None, will use the chunk size
+                specified by the class.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        # NOTE: to keep things simple, we assume the list may contain texts longer
+        #       than the maximum context and use length-safe embedding function.
+        engine = cast(str, self.deployment)
+        return self._get_len_safe_embeddings(texts, engine=engine)
+
+    async def aembed_documents(
+        self, texts: List[str], chunk_size: Optional[int] = 0
+    ) -> List[List[float]]:
+        """Call out to OpenAI's embedding endpoint async for embedding search docs.
+
+        Args:
+            texts: The list of texts to embed.
+            chunk_size: The chunk size of embeddings. If None, will use the chunk size
+                specified by the class.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        # NOTE: to keep things simple, we assume the list may contain texts longer
+        #       than the maximum context and use length-safe embedding function.
+        engine = cast(str, self.deployment)
+        return await self._aget_len_safe_embeddings(texts, engine=engine)
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to OpenAI's embedding endpoint for embedding query text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embedding for the text.
+        """
+        return self.embed_documents([text])[0]
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """Call out to OpenAI's embedding endpoint async for embedding query text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embedding for the text.
+        """
+        embeddings = await self.aembed_documents([text])
+        return embeddings[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/openvino.py b/llm/Lib/site-packages/langchain_community/embeddings/openvino.py
new file mode 100644
index 0000000000000000000000000000000000000000..83ea47c571b5eee03d09e4437cb93351d92a1891
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/openvino.py
@@ -0,0 +1,343 @@
+from pathlib import Path
+from typing import Any, Dict, List
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field
+
+DEFAULT_QUERY_INSTRUCTION = (
+    "Represent the question for retrieving supporting documents: "
+)
+DEFAULT_QUERY_BGE_INSTRUCTION_EN = (
+    "Represent this question for searching relevant passages: "
+)
+DEFAULT_QUERY_BGE_INSTRUCTION_ZH = "为这个句子生成表示以用于检索相关文章："
+
+
+class OpenVINOEmbeddings(BaseModel, Embeddings):
+    """OpenVINO embedding models.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import OpenVINOEmbeddings
+
+            model_name = "sentence-transformers/all-mpnet-base-v2"
+            model_kwargs = {'device': 'CPU'}
+            encode_kwargs = {'normalize_embeddings': True}
+            ov = OpenVINOEmbeddings(
+                model_name_or_path=model_name,
+                model_kwargs=model_kwargs,
+                encode_kwargs=encode_kwargs
+            )
+    """
+
+    ov_model: Any
+    """OpenVINO model object."""
+    tokenizer: Any
+    """Tokenizer for embedding model."""
+    model_name_or_path: str
+    """HuggingFace model id."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Keyword arguments to pass to the model."""
+    encode_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Keyword arguments to pass when calling the `encode` method of the model."""
+    show_progress: bool = False
+    """Whether to show a progress bar."""
+
+    def __init__(self, **kwargs: Any):
+        """Initialize the sentence_transformer."""
+        super().__init__(**kwargs)
+
+        try:
+            from optimum.intel.openvino import OVModelForFeatureExtraction
+        except ImportError as e:
+            raise ValueError(
+                "Could not import optimum-intel python package. "
+                "Please install it with: "
+                "pip install -U 'optimum[openvino,nncf]'"
+            ) from e
+
+        try:
+            from huggingface_hub import HfApi
+        except ImportError as e:
+            raise ValueError(
+                "Could not import huggingface_hub python package. "
+                "Please install it with: "
+                "`pip install -U huggingface_hub`."
+            ) from e
+
+        def require_model_export(
+            model_id: str, revision: Any = None, subfolder: Any = None
+        ) -> bool:
+            model_dir = Path(model_id)
+            if subfolder is not None:
+                model_dir = model_dir / subfolder
+            if model_dir.is_dir():
+                return (
+                    not (model_dir / "openvino_model.xml").exists()
+                    or not (model_dir / "openvino_model.bin").exists()
+                )
+            hf_api = HfApi()
+            try:
+                model_info = hf_api.model_info(model_id, revision=revision or "main")
+                normalized_subfolder = (
+                    None if subfolder is None else Path(subfolder).as_posix()
+                )
+                model_files = [
+                    file.rfilename
+                    for file in model_info.siblings
+                    if normalized_subfolder is None
+                    or file.rfilename.startswith(normalized_subfolder)
+                ]
+                ov_model_path = (
+                    "openvino_model.xml"
+                    if subfolder is None
+                    else f"{normalized_subfolder}/openvino_model.xml"
+                )
+                return (
+                    ov_model_path not in model_files
+                    or ov_model_path.replace(".xml", ".bin") not in model_files
+                )
+            except Exception:
+                return True
+
+        if require_model_export(self.model_name_or_path):
+            # use remote model
+            self.ov_model = OVModelForFeatureExtraction.from_pretrained(
+                self.model_name_or_path, export=True, **self.model_kwargs
+            )
+        else:
+            # use local model
+            self.ov_model = OVModelForFeatureExtraction.from_pretrained(
+                self.model_name_or_path, **self.model_kwargs
+            )
+
+        try:
+            from transformers import AutoTokenizer
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import transformers, please install with "
+                "`pip install -U transformers`."
+            ) from e
+        self.tokenizer = AutoTokenizer.from_pretrained(self.model_name_or_path)
+
+    def _text_length(self, text: Any) -> int:
+        """
+        Help function to get the length for the input text. Text can be either
+        a list of ints (which means a single text as input), or a tuple of list of ints
+        (representing several text inputs to the model).
+        """
+
+        if isinstance(text, dict):  # {key: value} case
+            return len(next(iter(text.values())))
+        elif not hasattr(text, "__len__"):  # Object has no len() method
+            return 1
+        # Empty string or list of ints
+        elif len(text) == 0 or isinstance(text[0], int):
+            return len(text)
+        else:
+            # Sum of length of individual strings
+            return sum([len(t) for t in text])
+
+    def encode(
+        self,
+        sentences: Any,
+        batch_size: int = 4,
+        show_progress_bar: bool = False,
+        convert_to_numpy: bool = True,
+        convert_to_tensor: bool = False,
+        mean_pooling: bool = False,
+        normalize_embeddings: bool = True,
+    ) -> Any:
+        """
+        Computes sentence embeddings.
+
+        :param sentences: the sentences to embed.
+        :param batch_size: the batch size used for the computation.
+        :param show_progress_bar: Whether to output a progress bar.
+        :param convert_to_numpy: Whether the output should be a list of numpy vectors.
+        :param convert_to_tensor: Whether the output should be one large tensor.
+        :param mean_pooling: Whether to pool returned vectors.
+        :param normalize_embeddings: Whether to normalize returned vectors.
+
+        :return: By default, a 2d numpy array with shape [num_inputs, output_dimension].
+        """
+        try:
+            import numpy as np
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import numpy, please install with " "`pip install -U numpy`."
+            ) from e
+        try:
+            from tqdm import trange
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import tqdm, please install with " "`pip install -U tqdm`."
+            ) from e
+        try:
+            import torch
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import torch, please install with " "`pip install -U torch`."
+            ) from e
+
+        def run_mean_pooling(model_output: Any, attention_mask: Any) -> Any:
+            token_embeddings = model_output[
+                0
+            ]  # First element of model_output contains all token embeddings
+            input_mask_expanded = (
+                attention_mask.unsqueeze(-1).expand(token_embeddings.size()).float()
+            )
+            return torch.sum(token_embeddings * input_mask_expanded, 1) / torch.clamp(
+                input_mask_expanded.sum(1), min=1e-9
+            )
+
+        if convert_to_tensor:
+            convert_to_numpy = False
+
+        input_was_string = False
+        if isinstance(sentences, str) or not hasattr(
+            sentences, "__len__"
+        ):  # Cast an individual sentence to a list with length 1
+            sentences = [sentences]
+            input_was_string = True
+
+        all_embeddings: Any = []
+        length_sorted_idx = np.argsort([-self._text_length(sen) for sen in sentences])
+        sentences_sorted = [sentences[idx] for idx in length_sorted_idx]
+
+        for start_index in trange(
+            0, len(sentences), batch_size, desc="Batches", disable=not show_progress_bar
+        ):
+            sentences_batch = sentences_sorted[start_index : start_index + batch_size]
+            features = self.tokenizer(
+                sentences_batch, padding=True, truncation=True, return_tensors="pt"
+            )
+
+            out_features = self.ov_model(**features)
+            if mean_pooling:
+                embeddings = run_mean_pooling(out_features, features["attention_mask"])
+            else:
+                embeddings = out_features[0][:, 0]
+            if normalize_embeddings:
+                embeddings = torch.nn.functional.normalize(embeddings, p=2, dim=1)
+
+            # fixes for #522 and #487 to avoid oom problems on gpu with large datasets
+            if convert_to_numpy:
+                embeddings = embeddings.cpu()
+
+            all_embeddings.extend(embeddings)
+
+        all_embeddings = [all_embeddings[idx] for idx in np.argsort(length_sorted_idx)]
+
+        if convert_to_tensor:
+            if len(all_embeddings):
+                all_embeddings = torch.stack(all_embeddings)
+            else:
+                all_embeddings = torch.Tensor()
+        elif convert_to_numpy:
+            all_embeddings = np.asarray([emb.numpy() for emb in all_embeddings])
+
+        if input_was_string:
+            all_embeddings = all_embeddings[0]
+
+        return all_embeddings
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Compute doc embeddings using a HuggingFace transformer model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+
+        texts = list(map(lambda x: x.replace("\n", " "), texts))
+        embeddings = self.encode(
+            texts, show_progress_bar=self.show_progress, **self.encode_kwargs
+        )
+
+        return embeddings.tolist()
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using a HuggingFace transformer model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self.embed_documents([text])[0]
+
+    def save_model(
+        self,
+        model_path: str,
+    ) -> bool:
+        self.ov_model.half()
+        self.ov_model.save_pretrained(model_path)
+        self.tokenizer.save_pretrained(model_path)
+        return True
+
+
+class OpenVINOBgeEmbeddings(OpenVINOEmbeddings):
+    """OpenVNO BGE embedding models.
+
+    Bge Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import OpenVINOBgeEmbeddings
+
+            model_name = "BAAI/bge-large-en"
+            model_kwargs = {'device': 'CPU'}
+            encode_kwargs = {'normalize_embeddings': True}
+            ov = OpenVINOBgeEmbeddings(
+                model_name_or_path=model_name,
+                model_kwargs=model_kwargs,
+                encode_kwargs=encode_kwargs
+            )
+    """
+
+    query_instruction: str = DEFAULT_QUERY_BGE_INSTRUCTION_EN
+    """Instruction to use for embedding query."""
+    embed_instruction: str = ""
+    """Instruction to use for embedding document."""
+
+    def __init__(self, **kwargs: Any):
+        """Initialize the sentence_transformer."""
+        super().__init__(**kwargs)
+
+        if "-zh" in self.model_name_or_path:
+            self.query_instruction = DEFAULT_QUERY_BGE_INSTRUCTION_ZH
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Compute doc embeddings using a HuggingFace transformer model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        texts = [self.embed_instruction + t.replace("\n", " ") for t in texts]
+        embeddings = self.encode(texts, **self.encode_kwargs)
+        return embeddings.tolist()
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using a HuggingFace transformer model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        text = text.replace("\n", " ")
+        embedding = self.encode(self.query_instruction + text, **self.encode_kwargs)
+        return embedding.tolist()
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/optimum_intel.py b/llm/Lib/site-packages/langchain_community/embeddings/optimum_intel.py
new file mode 100644
index 0000000000000000000000000000000000000000..56d4a6f20ac6fbfbf3f3591ae66828f1e21b86ce
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/optimum_intel.py
@@ -0,0 +1,208 @@
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra
+
+
+class QuantizedBiEncoderEmbeddings(BaseModel, Embeddings):
+    """Quantized bi-encoders embedding models.
+
+    Please ensure that you have installed optimum-intel and ipex.
+
+    Input:
+        model_name: str = Model name.
+        max_seq_len: int = The maximum sequence length for tokenization. (default 512)
+        pooling_strategy: str =
+            "mean" or "cls", pooling strategy for the final layer. (default "mean")
+        query_instruction: Optional[str] =
+            An instruction to add to the query before embedding. (default None)
+        document_instruction: Optional[str] =
+            An instruction to add to each document before embedding. (default None)
+        padding: Optional[bool] =
+            Whether to add padding during tokenization or not. (default True)
+        model_kwargs: Optional[Dict] =
+            Parameters to add to the model during initialization. (default {})
+        encode_kwargs: Optional[Dict] =
+            Parameters to add during the embedding forward pass. (default {})
+
+    Example:
+
+    from langchain_community.embeddings import QuantizedBiEncoderEmbeddings
+
+    model_name = "Intel/bge-small-en-v1.5-rag-int8-static"
+    encode_kwargs = {'normalize_embeddings': True}
+    hf = QuantizedBiEncoderEmbeddings(
+        model_name,
+        encode_kwargs=encode_kwargs,
+        query_instruction="Represent this sentence for searching relevant passages: "
+    )
+    """
+
+    def __init__(
+        self,
+        model_name: str,
+        max_seq_len: int = 512,
+        pooling_strategy: str = "mean",  # "mean" or "cls"
+        query_instruction: Optional[str] = None,
+        document_instruction: Optional[str] = None,
+        padding: bool = True,
+        model_kwargs: Optional[Dict] = None,
+        encode_kwargs: Optional[Dict] = None,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(**kwargs)
+        self.model_name_or_path = model_name
+        self.max_seq_len = max_seq_len
+        self.pooling = pooling_strategy
+        self.padding = padding
+        self.encode_kwargs = encode_kwargs or {}
+        self.model_kwargs = model_kwargs or {}
+
+        self.normalize = self.encode_kwargs.get("normalize_embeddings", False)
+        self.batch_size = self.encode_kwargs.get("batch_size", 32)
+
+        self.query_instruction = query_instruction
+        self.document_instruction = document_instruction
+
+        self.load_model()
+
+    def load_model(self) -> None:
+        try:
+            from transformers import AutoTokenizer
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import transformers, please install with "
+                "`pip install -U transformers`."
+            ) from e
+        try:
+            from optimum.intel import IPEXModel
+
+            self.transformer_model = IPEXModel.from_pretrained(
+                self.model_name_or_path, **self.model_kwargs
+            )
+        except Exception as e:
+            raise Exception(
+                f"""
+Failed to load model {self.model_name_or_path}, due to the following error:
+{e}
+Please ensure that you have installed optimum-intel and ipex correctly,using:
+
+pip install optimum[neural-compressor]
+pip install intel_extension_for_pytorch
+
+For more information, please visit:
+* Install optimum-intel as shown here: https://github.com/huggingface/optimum-intel.
+* Install IPEX as shown here: https://intel.github.io/intel-extension-for-pytorch/index.html#installation?platform=cpu&version=v2.2.0%2Bcpu.
+"""
+            )
+        self.transformer_tokenizer = AutoTokenizer.from_pretrained(
+            pretrained_model_name_or_path=self.model_name_or_path,
+        )
+        self.transformer_model.eval()
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.allow
+
+    def _embed(self, inputs: Any) -> Any:
+        try:
+            import torch
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import torch, please install with `pip install -U torch`."
+            ) from e
+        with torch.inference_mode():
+            outputs = self.transformer_model(**inputs)
+            if self.pooling == "mean":
+                emb = self._mean_pooling(outputs, inputs["attention_mask"])
+            elif self.pooling == "cls":
+                emb = self._cls_pooling(outputs)
+            else:
+                raise ValueError("pooling method no supported")
+
+            if self.normalize:
+                emb = torch.nn.functional.normalize(emb, p=2, dim=1)
+            return emb
+
+    @staticmethod
+    def _cls_pooling(outputs: Any) -> Any:
+        if isinstance(outputs, dict):
+            token_embeddings = outputs["last_hidden_state"]
+        else:
+            token_embeddings = outputs[0]
+        return token_embeddings[:, 0]
+
+    @staticmethod
+    def _mean_pooling(outputs: Any, attention_mask: Any) -> Any:
+        try:
+            import torch
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import torch, please install with `pip install -U torch`."
+            ) from e
+        if isinstance(outputs, dict):
+            token_embeddings = outputs["last_hidden_state"]
+        else:
+            # First element of model_output contains all token embeddings
+            token_embeddings = outputs[0]
+        input_mask_expanded = (
+            attention_mask.unsqueeze(-1).expand(token_embeddings.size()).float()
+        )
+        sum_embeddings = torch.sum(token_embeddings * input_mask_expanded, 1)
+        sum_mask = torch.clamp(input_mask_expanded.sum(1), min=1e-9)
+        return sum_embeddings / sum_mask
+
+    def _embed_text(self, texts: List[str]) -> List[List[float]]:
+        inputs = self.transformer_tokenizer(
+            texts,
+            max_length=self.max_seq_len,
+            truncation=True,
+            padding=self.padding,
+            return_tensors="pt",
+        )
+        return self._embed(inputs).tolist()
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed a list of text documents using the Optimized Embedder model.
+
+        Input:
+            texts: List[str] = List of text documents to embed.
+        Output:
+            List[List[float]] = The embeddings of each text document.
+        """
+        try:
+            import pandas as pd
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import pandas, please install with `pip install -U pandas`."
+            ) from e
+        try:
+            import tqdm
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import tqdm, please install with `pip install -U tqdm`."
+            ) from e
+        docs = [
+            self.document_instruction + d if self.document_instruction else d
+            for d in texts
+        ]
+
+        # group into batches
+        text_list_df = pd.DataFrame(docs, columns=["texts"]).reset_index()
+
+        # assign each example with its batch
+        text_list_df["batch_index"] = text_list_df["index"] // self.batch_size
+
+        # create groups
+        batches = list(text_list_df.groupby(["batch_index"])["texts"].apply(list))
+
+        vectors = []
+        for batch in tqdm(batches, desc="Batches"):
+            vectors += self._embed_text(batch)
+        return vectors
+
+    def embed_query(self, text: str) -> List[float]:
+        if self.query_instruction:
+            text = self.query_instruction + text
+        return self._embed_text([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/premai.py b/llm/Lib/site-packages/langchain_community/embeddings/premai.py
new file mode 100644
index 0000000000000000000000000000000000000000..e811b1bae49f4f561ed93bf077f1b38a2ef356e3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/premai.py
@@ -0,0 +1,121 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Callable, Dict, List, Optional, Union
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.language_models.llms import create_base_retry_decorator
+from langchain_core.pydantic_v1 import BaseModel, SecretStr, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+class PremAIEmbeddings(BaseModel, Embeddings):
+    """Prem's Embedding APIs"""
+
+    project_id: int
+    """The project ID in which the experiments or deployments are carried out. 
+    You can find all your projects here: https://app.premai.io/projects/"""
+
+    premai_api_key: Optional[SecretStr] = None
+    """Prem AI API Key. Get it here: https://app.premai.io/api_keys/"""
+
+    model: str
+    """The Embedding model to choose from"""
+
+    show_progress_bar: bool = False
+    """Whether to show a tqdm progress bar. Must have `tqdm` installed."""
+
+    max_retries: int = 1
+    """Max number of retries for tenacity"""
+
+    client: Any
+
+    @root_validator()
+    def validate_environments(cls, values: Dict) -> Dict:
+        """Validate that the package is installed and that the API token is valid"""
+        try:
+            from premai import Prem
+        except ImportError as error:
+            raise ImportError(
+                "Could not import Prem Python package."
+                "Please install it with: `pip install premai`"
+            ) from error
+
+        try:
+            premai_api_key = get_from_dict_or_env(
+                values, "premai_api_key", "PREMAI_API_KEY"
+            )
+            values["client"] = Prem(api_key=premai_api_key)
+        except Exception as error:
+            raise ValueError("Your API Key is incorrect. Please try again.") from error
+        return values
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed query text"""
+        embeddings = embed_with_retry(
+            self, model=self.model, project_id=self.project_id, input=text
+        )
+        return embeddings.data[0].embedding
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        embeddings = embed_with_retry(
+            self, model=self.model, project_id=self.project_id, input=texts
+        ).data
+
+        return [embedding.embedding for embedding in embeddings]
+
+
+def create_prem_retry_decorator(
+    embedder: PremAIEmbeddings,
+    *,
+    max_retries: int = 1,
+) -> Callable[[Any], Any]:
+    import premai.models
+
+    errors = [
+        premai.models.api_response_validation_error.APIResponseValidationError,
+        premai.models.conflict_error.ConflictError,
+        premai.models.model_not_found_error.ModelNotFoundError,
+        premai.models.permission_denied_error.PermissionDeniedError,
+        premai.models.provider_api_connection_error.ProviderAPIConnectionError,
+        premai.models.provider_api_status_error.ProviderAPIStatusError,
+        premai.models.provider_api_timeout_error.ProviderAPITimeoutError,
+        premai.models.provider_internal_server_error.ProviderInternalServerError,
+        premai.models.provider_not_found_error.ProviderNotFoundError,
+        premai.models.rate_limit_error.RateLimitError,
+        premai.models.unprocessable_entity_error.UnprocessableEntityError,
+        premai.models.validation_error.ValidationError,
+    ]
+
+    decorator = create_base_retry_decorator(
+        error_types=errors, max_retries=max_retries, run_manager=None
+    )
+    return decorator
+
+
+def embed_with_retry(
+    embedder: PremAIEmbeddings,
+    model: str,
+    project_id: int,
+    input: Union[str, List[str]],
+) -> Any:
+    """Using tenacity for retry in embedding calls"""
+    retry_decorator = create_prem_retry_decorator(
+        embedder, max_retries=embedder.max_retries
+    )
+
+    @retry_decorator
+    def _embed_with_retry(
+        embedder: PremAIEmbeddings,
+        project_id: int,
+        model: str,
+        input: Union[str, List[str]],
+    ) -> Any:
+        embedding_response = embedder.client.embeddings.create(
+            project_id=project_id, model=model, input=input
+        )
+        return embedding_response
+
+    return _embed_with_retry(embedder, project_id=project_id, model=model, input=input)
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/sagemaker_endpoint.py b/llm/Lib/site-packages/langchain_community/embeddings/sagemaker_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f01e1ecf4def1254753a615ffbd5ba0a24b7848
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/sagemaker_endpoint.py
@@ -0,0 +1,211 @@
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+from langchain_community.llms.sagemaker_endpoint import ContentHandlerBase
+
+
+class EmbeddingsContentHandler(ContentHandlerBase[List[str], List[List[float]]]):
+    """Content handler for LLM class."""
+
+
+class SagemakerEndpointEmbeddings(BaseModel, Embeddings):
+    """Custom Sagemaker Inference Endpoints.
+
+    To use, you must supply the endpoint name from your deployed
+    Sagemaker model & the region where it is deployed.
+
+    To authenticate, the AWS client uses the following methods to
+    automatically load credentials:
+    https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html
+
+    If a specific credential profile should be used, you must pass
+    the name of the profile from the ~/.aws/credentials file that is to be used.
+
+    Make sure the credentials / roles used have the required policies to
+    access the Sagemaker endpoint.
+    See: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html
+    """
+
+    """
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import SagemakerEndpointEmbeddings
+            endpoint_name = (
+                "my-endpoint-name"
+            )
+            region_name = (
+                "us-west-2"
+            )
+            credentials_profile_name = (
+                "default"
+            )
+            se = SagemakerEndpointEmbeddings(
+                endpoint_name=endpoint_name,
+                region_name=region_name,
+                credentials_profile_name=credentials_profile_name
+            )
+
+            #Use with boto3 client
+            client = boto3.client(
+                        "sagemaker-runtime",
+                        region_name=region_name
+                    )
+            se = SagemakerEndpointEmbeddings(
+                endpoint_name=endpoint_name,
+                client=client
+            )
+    """
+    client: Any = None
+
+    endpoint_name: str = ""
+    """The name of the endpoint from the deployed Sagemaker model.
+    Must be unique within an AWS Region."""
+
+    region_name: str = ""
+    """The aws region where the Sagemaker model is deployed, eg. `us-west-2`."""
+
+    credentials_profile_name: Optional[str] = None
+    """The name of the profile in the ~/.aws/credentials or ~/.aws/config files, which
+    has either access keys or role information specified.
+    If not specified, the default credential profile or, if on an EC2 instance,
+    credentials from IMDS will be used.
+    See: https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html
+    """
+
+    content_handler: EmbeddingsContentHandler
+    """The content handler class that provides an input and
+    output transform functions to handle formats between LLM
+    and the endpoint.
+    """
+
+    """
+     Example:
+        .. code-block:: python
+
+        from langchain_community.embeddings.sagemaker_endpoint import EmbeddingsContentHandler
+
+        class ContentHandler(EmbeddingsContentHandler):
+                content_type = "application/json"
+                accepts = "application/json"
+
+                def transform_input(self, prompts: List[str], model_kwargs: Dict) -> bytes:
+                    input_str = json.dumps({prompts: prompts, **model_kwargs})
+                    return input_str.encode('utf-8')
+
+                def transform_output(self, output: bytes) -> List[List[float]]:
+                    response_json = json.loads(output.read().decode("utf-8"))
+                    return response_json["vectors"]
+    """  # noqa: E501
+
+    model_kwargs: Optional[Dict] = None
+    """Keyword arguments to pass to the model."""
+
+    endpoint_kwargs: Optional[Dict] = None
+    """Optional attributes passed to the invoke_endpoint
+    function. See `boto3`_. docs for more info.
+    .. _boto3: <https://boto3.amazonaws.com/v1/documentation/api/latest/index.html>
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Dont do anything if client provided externally"""
+        if values.get("client") is not None:
+            return values
+
+        """Validate that AWS credentials to and python package exists in environment."""
+        try:
+            import boto3
+
+            try:
+                if values["credentials_profile_name"] is not None:
+                    session = boto3.Session(
+                        profile_name=values["credentials_profile_name"]
+                    )
+                else:
+                    # use default credentials
+                    session = boto3.Session()
+
+                values["client"] = session.client(
+                    "sagemaker-runtime", region_name=values["region_name"]
+                )
+
+            except Exception as e:
+                raise ValueError(
+                    "Could not load credentials to authenticate with AWS client. "
+                    "Please check that credentials in the specified "
+                    f"profile name are valid. {e}"
+                ) from e
+
+        except ImportError:
+            raise ImportError(
+                "Could not import boto3 python package. "
+                "Please install it with `pip install boto3`."
+            )
+        return values
+
+    def _embedding_func(self, texts: List[str]) -> List[List[float]]:
+        """Call out to SageMaker Inference embedding endpoint."""
+        # replace newlines, which can negatively affect performance.
+        texts = list(map(lambda x: x.replace("\n", " "), texts))
+        _model_kwargs = self.model_kwargs or {}
+        _endpoint_kwargs = self.endpoint_kwargs or {}
+
+        body = self.content_handler.transform_input(texts, _model_kwargs)
+        content_type = self.content_handler.content_type
+        accepts = self.content_handler.accepts
+
+        # send request
+        try:
+            response = self.client.invoke_endpoint(
+                EndpointName=self.endpoint_name,
+                Body=body,
+                ContentType=content_type,
+                Accept=accepts,
+                **_endpoint_kwargs,
+            )
+        except Exception as e:
+            raise ValueError(f"Error raised by inference endpoint: {e}")
+
+        return self.content_handler.transform_output(response["Body"])
+
+    def embed_documents(
+        self, texts: List[str], chunk_size: int = 64
+    ) -> List[List[float]]:
+        """Compute doc embeddings using a SageMaker Inference Endpoint.
+
+        Args:
+            texts: The list of texts to embed.
+            chunk_size: The chunk size defines how many input texts will
+                be grouped together as request. If None, will use the
+                chunk size specified by the class.
+
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        results = []
+        _chunk_size = len(texts) if chunk_size > len(texts) else chunk_size
+        for i in range(0, len(texts), _chunk_size):
+            response = self._embedding_func(texts[i : i + _chunk_size])
+            results.extend(response)
+        return results
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using a SageMaker inference endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return self._embedding_func([text])[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/self_hosted.py b/llm/Lib/site-packages/langchain_community/embeddings/self_hosted.py
new file mode 100644
index 0000000000000000000000000000000000000000..925b64d79436a1f1576e1e6289ea61e585a9dd1d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/self_hosted.py
@@ -0,0 +1,102 @@
+from typing import Any, Callable, List
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import Extra
+
+from langchain_community.llms.self_hosted import SelfHostedPipeline
+
+
+def _embed_documents(pipeline: Any, *args: Any, **kwargs: Any) -> List[List[float]]:
+    """Inference function to send to the remote hardware.
+
+    Accepts a sentence_transformer model_id and
+    returns a list of embeddings for each document in the batch.
+    """
+    return pipeline(*args, **kwargs)
+
+
+class SelfHostedEmbeddings(SelfHostedPipeline, Embeddings):
+    """Custom embedding models on self-hosted remote hardware.
+
+    Supported hardware includes auto-launched instances on AWS, GCP, Azure,
+    and Lambda, as well as servers specified
+    by IP address and SSH credentials (such as on-prem, or another
+    cloud like Paperspace, Coreweave, etc.).
+
+    To use, you should have the ``runhouse`` python package installed.
+
+    Example using a model load function:
+        .. code-block:: python
+
+            from langchain_community.embeddings import SelfHostedEmbeddings
+            from transformers import AutoModelForCausalLM, AutoTokenizer, pipeline
+            import runhouse as rh
+
+            gpu = rh.cluster(name="rh-a10x", instance_type="A100:1")
+            def get_pipeline():
+                model_id = "facebook/bart-large"
+                tokenizer = AutoTokenizer.from_pretrained(model_id)
+                model = AutoModelForCausalLM.from_pretrained(model_id)
+                return pipeline("feature-extraction", model=model, tokenizer=tokenizer)
+            embeddings = SelfHostedEmbeddings(
+                model_load_fn=get_pipeline,
+                hardware=gpu
+                model_reqs=["./", "torch", "transformers"],
+            )
+    Example passing in a pipeline path:
+        .. code-block:: python
+
+            from langchain_community.embeddings import SelfHostedHFEmbeddings
+            import runhouse as rh
+            from transformers import pipeline
+
+            gpu = rh.cluster(name="rh-a10x", instance_type="A100:1")
+            pipeline = pipeline(model="bert-base-uncased", task="feature-extraction")
+            rh.blob(pickle.dumps(pipeline),
+                path="models/pipeline.pkl").save().to(gpu, path="models")
+            embeddings = SelfHostedHFEmbeddings.from_pipeline(
+                pipeline="models/pipeline.pkl",
+                hardware=gpu,
+                model_reqs=["./", "torch", "transformers"],
+            )
+    """
+
+    inference_fn: Callable = _embed_documents
+    """Inference function to extract the embeddings on the remote hardware."""
+    inference_kwargs: Any = None
+    """Any kwargs to pass to the model's inference function."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Compute doc embeddings using a HuggingFace transformer model.
+
+        Args:
+            texts: The list of texts to embed.s
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        texts = list(map(lambda x: x.replace("\n", " "), texts))
+        embeddings = self.client(self.pipeline_ref, texts)
+        if not isinstance(embeddings, list):
+            return embeddings.tolist()
+        return embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using a HuggingFace transformer model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        text = text.replace("\n", " ")
+        embeddings = self.client(self.pipeline_ref, text)
+        if not isinstance(embeddings, list):
+            return embeddings.tolist()
+        return embeddings
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/self_hosted_hugging_face.py b/llm/Lib/site-packages/langchain_community/embeddings/self_hosted_hugging_face.py
new file mode 100644
index 0000000000000000000000000000000000000000..d45a802492045b2fa70b85e737173ed40e1f10a1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/self_hosted_hugging_face.py
@@ -0,0 +1,168 @@
+import importlib
+import logging
+from typing import Any, Callable, List, Optional
+
+from langchain_community.embeddings.self_hosted import SelfHostedEmbeddings
+
+DEFAULT_MODEL_NAME = "sentence-transformers/all-mpnet-base-v2"
+DEFAULT_INSTRUCT_MODEL = "hkunlp/instructor-large"
+DEFAULT_EMBED_INSTRUCTION = "Represent the document for retrieval: "
+DEFAULT_QUERY_INSTRUCTION = (
+    "Represent the question for retrieving supporting documents: "
+)
+
+logger = logging.getLogger(__name__)
+
+
+def _embed_documents(client: Any, *args: Any, **kwargs: Any) -> List[List[float]]:
+    """Inference function to send to the remote hardware.
+
+    Accepts a sentence_transformer model_id and
+    returns a list of embeddings for each document in the batch.
+    """
+    return client.encode(*args, **kwargs)
+
+
+def load_embedding_model(model_id: str, instruct: bool = False, device: int = 0) -> Any:
+    """Load the embedding model."""
+    if not instruct:
+        import sentence_transformers
+
+        client = sentence_transformers.SentenceTransformer(model_id)
+    else:
+        from InstructorEmbedding import INSTRUCTOR
+
+        client = INSTRUCTOR(model_id)
+
+    if importlib.util.find_spec("torch") is not None:
+        import torch
+
+        cuda_device_count = torch.cuda.device_count()
+        if device < -1 or (device >= cuda_device_count):
+            raise ValueError(
+                f"Got device=={device}, "
+                f"device is required to be within [-1, {cuda_device_count})"
+            )
+        if device < 0 and cuda_device_count > 0:
+            logger.warning(
+                "Device has %d GPUs available. "
+                "Provide device={deviceId} to `from_model_id` to use available"
+                "GPUs for execution. deviceId is -1 for CPU and "
+                "can be a positive integer associated with CUDA device id.",
+                cuda_device_count,
+            )
+
+        client = client.to(device)
+    return client
+
+
+class SelfHostedHuggingFaceEmbeddings(SelfHostedEmbeddings):
+    """HuggingFace embedding models on self-hosted remote hardware.
+
+    Supported hardware includes auto-launched instances on AWS, GCP, Azure,
+    and Lambda, as well as servers specified
+    by IP address and SSH credentials (such as on-prem, or another cloud
+    like Paperspace, Coreweave, etc.).
+
+    To use, you should have the ``runhouse`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import SelfHostedHuggingFaceEmbeddings
+            import runhouse as rh
+            model_id = "sentence-transformers/all-mpnet-base-v2"
+            gpu = rh.cluster(name="rh-a10x", instance_type="A100:1")
+            hf = SelfHostedHuggingFaceEmbeddings(model_id=model_id, hardware=gpu)
+    """
+
+    client: Any  #: :meta private:
+    model_id: str = DEFAULT_MODEL_NAME
+    """Model name to use."""
+    model_reqs: List[str] = ["./", "sentence_transformers", "torch"]
+    """Requirements to install on hardware to inference the model."""
+    hardware: Any
+    """Remote hardware to send the inference function to."""
+    model_load_fn: Callable = load_embedding_model
+    """Function to load the model remotely on the server."""
+    load_fn_kwargs: Optional[dict] = None
+    """Keyword arguments to pass to the model load function."""
+    inference_fn: Callable = _embed_documents
+    """Inference function to extract the embeddings."""
+
+    def __init__(self, **kwargs: Any):
+        """Initialize the remote inference function."""
+        load_fn_kwargs = kwargs.pop("load_fn_kwargs", {})
+        load_fn_kwargs["model_id"] = load_fn_kwargs.get("model_id", DEFAULT_MODEL_NAME)
+        load_fn_kwargs["instruct"] = load_fn_kwargs.get("instruct", False)
+        load_fn_kwargs["device"] = load_fn_kwargs.get("device", 0)
+        super().__init__(load_fn_kwargs=load_fn_kwargs, **kwargs)
+
+
+class SelfHostedHuggingFaceInstructEmbeddings(SelfHostedHuggingFaceEmbeddings):
+    """HuggingFace InstructEmbedding models on self-hosted remote hardware.
+
+    Supported hardware includes auto-launched instances on AWS, GCP, Azure,
+    and Lambda, as well as servers specified
+    by IP address and SSH credentials (such as on-prem, or another
+    cloud like Paperspace, Coreweave, etc.).
+
+    To use, you should have the ``runhouse`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import SelfHostedHuggingFaceInstructEmbeddings
+            import runhouse as rh
+            model_name = "hkunlp/instructor-large"
+            gpu = rh.cluster(name='rh-a10x', instance_type='A100:1')
+            hf = SelfHostedHuggingFaceInstructEmbeddings(
+                model_name=model_name, hardware=gpu)
+    """  # noqa: E501
+
+    model_id: str = DEFAULT_INSTRUCT_MODEL
+    """Model name to use."""
+    embed_instruction: str = DEFAULT_EMBED_INSTRUCTION
+    """Instruction to use for embedding documents."""
+    query_instruction: str = DEFAULT_QUERY_INSTRUCTION
+    """Instruction to use for embedding query."""
+    model_reqs: List[str] = ["./", "InstructorEmbedding", "torch"]
+    """Requirements to install on hardware to inference the model."""
+
+    def __init__(self, **kwargs: Any):
+        """Initialize the remote inference function."""
+        load_fn_kwargs = kwargs.pop("load_fn_kwargs", {})
+        load_fn_kwargs["model_id"] = load_fn_kwargs.get(
+            "model_id", DEFAULT_INSTRUCT_MODEL
+        )
+        load_fn_kwargs["instruct"] = load_fn_kwargs.get("instruct", True)
+        load_fn_kwargs["device"] = load_fn_kwargs.get("device", 0)
+        super().__init__(load_fn_kwargs=load_fn_kwargs, **kwargs)
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Compute doc embeddings using a HuggingFace instruct model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        instruction_pairs = []
+        for text in texts:
+            instruction_pairs.append([self.embed_instruction, text])
+        embeddings = self.client(self.pipeline_ref, instruction_pairs)
+        return embeddings.tolist()
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using a HuggingFace instruct model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        instruction_pair = [self.query_instruction, text]
+        embedding = self.client(self.pipeline_ref, [instruction_pair])[0]
+        return embedding.tolist()
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/sentence_transformer.py b/llm/Lib/site-packages/langchain_community/embeddings/sentence_transformer.py
new file mode 100644
index 0000000000000000000000000000000000000000..08da53bd44764017a71f8792e54ea16e2c7dd2e9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/sentence_transformer.py
@@ -0,0 +1,4 @@
+"""HuggingFace sentence_transformer embedding models."""
+from langchain_community.embeddings.huggingface import HuggingFaceEmbeddings
+
+SentenceTransformerEmbeddings = HuggingFaceEmbeddings
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/solar.py b/llm/Lib/site-packages/langchain_community/embeddings/solar.py
new file mode 100644
index 0000000000000000000000000000000000000000..3dfb86431175a5d45d096a3ca287210a1d9ad167
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/solar.py
@@ -0,0 +1,143 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Callable, Dict, List, Optional
+
+import requests
+from langchain_core._api import deprecated
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+from tenacity import (
+    before_sleep_log,
+    retry,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def _create_retry_decorator() -> Callable[[Any], Any]:
+    """Returns a tenacity retry decorator."""
+
+    multiplier = 1
+    min_seconds = 1
+    max_seconds = 4
+    max_retries = 6
+
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(max_retries),
+        wait=wait_exponential(multiplier=multiplier, min=min_seconds, max=max_seconds),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def embed_with_retry(embeddings: SolarEmbeddings, *args: Any, **kwargs: Any) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = _create_retry_decorator()
+
+    @retry_decorator
+    def _embed_with_retry(*args: Any, **kwargs: Any) -> Any:
+        return embeddings.embed(*args, **kwargs)
+
+    return _embed_with_retry(*args, **kwargs)
+
+
+@deprecated(
+    since="0.0.34", removal="0.2.0", alternative_import="langchain_upstage.ChatUpstage"
+)
+class SolarEmbeddings(BaseModel, Embeddings):
+    """Solar's embedding service.
+
+    To use, you should have the environment variable``SOLAR_API_KEY`` set
+    with your API token, or pass it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import SolarEmbeddings
+            embeddings = SolarEmbeddings()
+
+            query_text = "This is a test query."
+            query_result = embeddings.embed_query(query_text)
+
+            document_text = "This is a test document."
+            document_result = embeddings.embed_documents([document_text])
+
+    """
+
+    endpoint_url: str = "https://api.upstage.ai/v1/solar/embeddings"
+    """Endpoint URL to use."""
+    model: str = "solar-1-mini-embedding-query"
+    """Embeddings model name to use."""
+    solar_api_key: Optional[SecretStr] = None
+    """API Key for Solar API."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate api key exists in environment."""
+        solar_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "solar_api_key", "SOLAR_API_KEY")
+        )
+        values["solar_api_key"] = solar_api_key
+        return values
+
+    def embed(
+        self,
+        text: str,
+    ) -> List[List[float]]:
+        payload = {
+            "model": self.model,
+            "input": text,
+        }
+
+        # HTTP headers for authorization
+        headers = {
+            "Authorization": f"Bearer {self.solar_api_key.get_secret_value()}",  # type: ignore[union-attr]
+            "Content-Type": "application/json",
+        }
+
+        # send request
+        response = requests.post(self.endpoint_url, headers=headers, json=payload)
+        parsed_response = response.json()
+
+        # check for errors
+        if len(parsed_response["data"]) == 0:
+            raise ValueError(
+                f"Solar API returned an error: {parsed_response['base_resp']}"
+            )
+
+        embedding = parsed_response["data"][0]["embedding"]
+
+        return embedding
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed documents using a Solar embedding endpoint.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        embeddings = [embed_with_retry(self, text=text) for text in texts]
+        return embeddings
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using a Solar embedding endpoint.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        embedding = embed_with_retry(self, text=text)
+        return embedding
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/spacy_embeddings.py b/llm/Lib/site-packages/langchain_community/embeddings/spacy_embeddings.py
new file mode 100644
index 0000000000000000000000000000000000000000..954b2550fb41affd4e7f399c0205746589061f23
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/spacy_embeddings.py
@@ -0,0 +1,119 @@
+import importlib.util
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+
+class SpacyEmbeddings(BaseModel, Embeddings):
+    """Embeddings by spaCy models.
+
+    Attributes:
+        model_name (str): Name of a spaCy model.
+        nlp (Any): The spaCy model loaded into memory.
+
+    Methods:
+        embed_documents(texts: List[str]) -> List[List[float]]:
+            Generates embeddings for a list of documents.
+        embed_query(text: str) -> List[float]:
+            Generates an embedding for a single piece of text.
+    """
+
+    model_name: str = "en_core_web_sm"
+    nlp: Optional[Any] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid  # Forbid extra attributes during model initialization
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """
+        Validates that the spaCy package and the model are installed.
+
+        Args:
+            values (Dict): The values provided to the class constructor.
+
+        Returns:
+            The validated values.
+
+        Raises:
+            ValueError: If the spaCy package or the
+            model are not installed.
+        """
+        if values.get("model_name") is None:
+            values["model_name"] = "en_core_web_sm"
+
+        model_name = values.get("model_name")
+
+        # Check if the spaCy package is installed
+        if importlib.util.find_spec("spacy") is None:
+            raise ValueError(
+                "SpaCy package not found. "
+                "Please install it with `pip install spacy`."
+            )
+        try:
+            # Try to load the spaCy model
+            import spacy
+
+            values["nlp"] = spacy.load(model_name)
+        except OSError:
+            # If the model is not found, raise a ValueError
+            raise ValueError(
+                f"SpaCy model '{model_name}' not found. "
+                f"Please install it with"
+                f" `python -m spacy download {model_name}`"
+                "or provide a valid spaCy model name."
+            )
+        return values  # Return the validated values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """
+        Generates embeddings for a list of documents.
+
+        Args:
+            texts (List[str]): The documents to generate embeddings for.
+
+        Returns:
+            A list of embeddings, one for each document.
+        """
+        return [self.nlp(text).vector.tolist() for text in texts]  # type: ignore[misc]
+
+    def embed_query(self, text: str) -> List[float]:
+        """
+        Generates an embedding for a single piece of text.
+
+        Args:
+            text (str): The text to generate an embedding for.
+
+        Returns:
+            The embedding for the text.
+        """
+        return self.nlp(text).vector.tolist()  # type: ignore[misc]
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        """
+        Asynchronously generates embeddings for a list of documents.
+        This method is not implemented and raises a NotImplementedError.
+
+        Args:
+            texts (List[str]): The documents to generate embeddings for.
+
+        Raises:
+            NotImplementedError: This method is not implemented.
+        """
+        raise NotImplementedError("Asynchronous embedding generation is not supported.")
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """
+        Asynchronously generates an embedding for a single piece of text.
+        This method is not implemented and raises a NotImplementedError.
+
+        Args:
+            text (str): The text to generate an embedding for.
+
+        Raises:
+            NotImplementedError: This method is not implemented.
+        """
+        raise NotImplementedError("Asynchronous embedding generation is not supported.")
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/sparkllm.py b/llm/Lib/site-packages/langchain_community/embeddings/sparkllm.py
new file mode 100644
index 0000000000000000000000000000000000000000..7e80b11896eef07167233886d305178ca1be15d7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/sparkllm.py
@@ -0,0 +1,191 @@
+import base64
+import hashlib
+import hmac
+import json
+import logging
+from datetime import datetime
+from time import mktime
+from typing import Any, Dict, List, Optional
+from urllib.parse import urlencode
+from wsgiref.handlers import format_date_time
+
+import numpy as np
+import requests
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+from numpy import ndarray
+
+# Used for document and knowledge embedding
+EMBEDDING_P_API_URL: str = "https://cn-huabei-1.xf-yun.com/v1/private/sa8a05c27"
+# Used for user questions embedding
+EMBEDDING_Q_API_URL: str = "https://cn-huabei-1.xf-yun.com/v1/private/s50d55a16"
+
+# SparkLLMTextEmbeddings is an embedding model provided by iFLYTEK Co., Ltd.. (https://iflytek.com/en/).
+
+# Official Website: https://www.xfyun.cn/doc/spark/Embedding_new_api.html
+# Developers need to create an application in the console first, use the appid, APIKey,
+# and APISecret provided in the application for authentication,
+# and generate an authentication URL for handshake.
+# You can get one by registering at https://console.xfyun.cn/services/bm3.
+# SparkLLMTextEmbeddings support 2K token window and preduces vectors with
+# 2560 dimensions.
+
+logger = logging.getLogger(__name__)
+
+
+class Url:
+    def __init__(self, host: str, path: str, schema: str) -> None:
+        self.host = host
+        self.path = path
+        self.schema = schema
+        pass
+
+
+class SparkLLMTextEmbeddings(BaseModel, Embeddings):
+    """SparkLLM Text Embedding models."""
+
+    spark_app_id: SecretStr
+    spark_api_key: SecretStr
+    spark_api_secret: SecretStr
+
+    @root_validator(allow_reuse=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that auth token exists in environment."""
+        cls.spark_app_id = convert_to_secret_str(
+            get_from_dict_or_env(values, "spark_app_id", "SPARK_APP_ID")
+        )
+        cls.spark_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "spark_api_key", "SPARK_API_KEY")
+        )
+        cls.spark_api_secret = convert_to_secret_str(
+            get_from_dict_or_env(values, "spark_api_secret", "SPARK_API_SECRET")
+        )
+        return values
+
+    def _embed(self, texts: List[str], host: str) -> Optional[List[List[float]]]:
+        url = self._assemble_ws_auth_url(
+            request_url=host,
+            method="POST",
+            api_key=self.spark_api_key.get_secret_value(),
+            api_secret=self.spark_api_secret.get_secret_value(),
+        )
+        embed_result: list = []
+        for text in texts:
+            query_context = {"messages": [{"content": text, "role": "user"}]}
+            content = self._get_body(
+                self.spark_app_id.get_secret_value(), query_context
+            )
+            response = requests.post(
+                url, json=content, headers={"content-type": "application/json"}
+            ).text
+            res_arr = self._parser_message(response)
+            if res_arr is not None:
+                embed_result.append(res_arr.tolist())
+            else:
+                embed_result.append(None)
+        return embed_result
+
+    def embed_documents(self, texts: List[str]) -> Optional[List[List[float]]]:  # type: ignore[override]
+        """Public method to get embeddings for a list of documents.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            A list of embeddings, one for each text, or None if an error occurs.
+        """
+        return self._embed(texts, EMBEDDING_P_API_URL)
+
+    def embed_query(self, text: str) -> Optional[List[float]]:  # type: ignore[override]
+        """Public method to get embedding for a single query text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text, or None if an error occurs.
+        """
+        result = self._embed([text], EMBEDDING_Q_API_URL)
+        return result[0] if result is not None else None
+
+    @staticmethod
+    def _assemble_ws_auth_url(
+        request_url: str, method: str = "GET", api_key: str = "", api_secret: str = ""
+    ) -> str:
+        u = SparkLLMTextEmbeddings._parse_url(request_url)
+        host = u.host
+        path = u.path
+        now = datetime.now()
+        date = format_date_time(mktime(now.timetuple()))
+        signature_origin = "host: {}\ndate: {}\n{} {} HTTP/1.1".format(
+            host, date, method, path
+        )
+        signature_sha = hmac.new(
+            api_secret.encode("utf-8"),
+            signature_origin.encode("utf-8"),
+            digestmod=hashlib.sha256,
+        ).digest()
+        signature_sha_str = base64.b64encode(signature_sha).decode(encoding="utf-8")
+        authorization_origin = (
+            'api_key="%s", algorithm="%s", headers="%s", signature="%s"'
+            % (api_key, "hmac-sha256", "host date request-line", signature_sha_str)
+        )
+        authorization = base64.b64encode(authorization_origin.encode("utf-8")).decode(
+            encoding="utf-8"
+        )
+        values = {"host": host, "date": date, "authorization": authorization}
+
+        return request_url + "?" + urlencode(values)
+
+    @staticmethod
+    def _parse_url(request_url: str) -> Url:
+        stidx = request_url.index("://")
+        host = request_url[stidx + 3 :]
+        schema = request_url[: stidx + 3]
+        edidx = host.index("/")
+        if edidx <= 0:
+            raise AssembleHeaderException("invalid request url:" + request_url)
+        path = host[edidx:]
+        host = host[:edidx]
+        u = Url(host, path, schema)
+        return u
+
+    @staticmethod
+    def _get_body(appid: str, text: dict) -> Dict[str, Any]:
+        body = {
+            "header": {"app_id": appid, "uid": "39769795890", "status": 3},
+            "parameter": {"emb": {"feature": {"encoding": "utf8"}}},
+            "payload": {
+                "messages": {
+                    "text": base64.b64encode(json.dumps(text).encode("utf-8")).decode()
+                }
+            },
+        }
+        return body
+
+    @staticmethod
+    def _parser_message(
+        message: str,
+    ) -> Optional[ndarray]:
+        data = json.loads(message)
+        code = data["header"]["code"]
+        if code != 0:
+            logger.warning(f"Request error: {code}, {data}")
+            return None
+        else:
+            text_base = data["payload"]["feature"]["text"]
+            text_data = base64.b64decode(text_base)
+            dt = np.dtype(np.float32)
+            dt = dt.newbyteorder("<")
+            text = np.frombuffer(text_data, dtype=dt)
+            if len(text) > 2560:
+                array = text[:2560]
+            else:
+                array = text
+            return array
+
+
+class AssembleHeaderException(Exception):
+    def __init__(self, msg: str) -> None:
+        self.message = msg
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/tensorflow_hub.py b/llm/Lib/site-packages/langchain_community/embeddings/tensorflow_hub.py
new file mode 100644
index 0000000000000000000000000000000000000000..1cc01ca91ca1d5814feffe1367c59e5f1d3f263a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/tensorflow_hub.py
@@ -0,0 +1,75 @@
+from typing import Any, List
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra
+
+DEFAULT_MODEL_URL = "https://tfhub.dev/google/universal-sentence-encoder-multilingual/3"
+
+
+class TensorflowHubEmbeddings(BaseModel, Embeddings):
+    """TensorflowHub embedding models.
+
+    To use, you should have the ``tensorflow_text`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import TensorflowHubEmbeddings
+            url = "https://tfhub.dev/google/universal-sentence-encoder-multilingual/3"
+            tf = TensorflowHubEmbeddings(model_url=url)
+    """
+
+    embed: Any  #: :meta private:
+    model_url: str = DEFAULT_MODEL_URL
+    """Model name to use."""
+
+    def __init__(self, **kwargs: Any):
+        """Initialize the tensorflow_hub and tensorflow_text."""
+        super().__init__(**kwargs)
+        try:
+            import tensorflow_hub
+        except ImportError:
+            raise ImportError(
+                "Could not import tensorflow-hub python package. "
+                "Please install it with `pip install tensorflow-hub``."
+            )
+        try:
+            import tensorflow_text  # noqa
+        except ImportError:
+            raise ImportError(
+                "Could not import tensorflow_text python package. "
+                "Please install it with `pip install tensorflow_text``."
+            )
+
+        self.embed = tensorflow_hub.load(self.model_url)
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Compute doc embeddings using a TensorflowHub embedding model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        texts = list(map(lambda x: x.replace("\n", " "), texts))
+        embeddings = self.embed(texts).numpy()
+        return embeddings.tolist()
+
+    def embed_query(self, text: str) -> List[float]:
+        """Compute query embeddings using a TensorflowHub embedding model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        text = text.replace("\n", " ")
+        embedding = self.embed([text]).numpy()[0]
+        return embedding.tolist()
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/text2vec.py b/llm/Lib/site-packages/langchain_community/embeddings/text2vec.py
new file mode 100644
index 0000000000000000000000000000000000000000..537249aa93d3d41359b5a9ede192dfcddcd486a7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/text2vec.py
@@ -0,0 +1,79 @@
+"""Wrapper around text2vec embedding models."""
+
+from typing import Any, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel
+
+
+class Text2vecEmbeddings(Embeddings, BaseModel):
+    """text2vec embedding models.
+
+    Install text2vec first, run 'pip install -U text2vec'.
+    The gitbub repository for text2vec is : https://github.com/shibing624/text2vec
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings.text2vec import Text2vecEmbeddings
+
+            embedding = Text2vecEmbeddings()
+            embedding.embed_documents([
+                "This is a CoSENT(Cosine Sentence) model.",
+                "It maps sentences to a 768 dimensional dense vector space.",
+            ])
+            embedding.embed_query(
+                "It can be used for text matching or semantic search."
+            )
+    """
+
+    model_name_or_path: Optional[str] = None
+    encoder_type: Any = "MEAN"
+    max_seq_length: int = 256
+    device: Optional[str] = None
+    model: Any = None
+
+    def __init__(
+        self,
+        *,
+        model: Any = None,
+        model_name_or_path: Optional[str] = None,
+        **kwargs: Any,
+    ):
+        try:
+            from text2vec import SentenceModel
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import text2vec, please install with "
+                "`pip install -U text2vec`."
+            ) from e
+
+        model_kwargs = {}
+        if model_name_or_path is not None:
+            model_kwargs["model_name_or_path"] = model_name_or_path
+        model = model or SentenceModel(**model_kwargs, **kwargs)
+        super().__init__(model=model, model_name_or_path=model_name_or_path, **kwargs)
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed documents using the text2vec embeddings model.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+
+        return self.model.encode(texts)
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using the text2vec embeddings model.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+
+        return self.model.encode(text)
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/titan_takeoff.py b/llm/Lib/site-packages/langchain_community/embeddings/titan_takeoff.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc09e22936ddcd143a6cff44ec45ac56f092cc25
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/titan_takeoff.py
@@ -0,0 +1,207 @@
+from enum import Enum
+from typing import Any, List, Optional, Set, Union
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel
+
+
+class TakeoffEmbeddingException(Exception):
+    """Exceptions experienced with interfacing with Takeoff Embedding Wrapper"""
+
+
+class MissingConsumerGroup(TakeoffEmbeddingException):
+    """Exception raised when no consumer group is provided on initialization of
+    TitanTakeoffEmbed or in embed request"""
+
+
+class Device(str, Enum):
+    """The device to use for inference, cuda or cpu"""
+
+    cuda = "cuda"
+    cpu = "cpu"
+
+
+class ReaderConfig(BaseModel):
+    class Config:
+        protected_namespaces = ()
+
+    model_name: str
+    """The name of the model to use"""
+
+    device: Device = Device.cuda
+    """The device to use for inference, cuda or cpu"""
+
+    consumer_group: str = "primary"
+    """The consumer group to place the reader into"""
+
+
+class TitanTakeoffEmbed(Embeddings):
+    """Titan Takeoff Embed is a wrapper to interface with Takeoff Inference API
+    for embedding models
+
+    You can use this wrapper to send embedding requests and to deploy embedding
+    readers with Takeoff.
+
+    Examples:
+        This is an example how to deploy an embedding model and send requests.
+
+        .. code-block:: python
+            # Import the TitanTakeoffEmbed class from community package
+            import time
+            from langchain_community.embeddings import TitanTakeoffEmbed
+
+            # Specify the embedding reader you'd like to deploy
+            reader_1 = {
+                "model_name": "avsolatorio/GIST-large-Embedding-v0",
+                "device": "cpu",
+                "consumer_group": "embed"
+            }
+
+            # For every reader you pass into models arg Takeoff will spin up a reader
+            # according to the specs you provide. If you don't specify the arg no models
+            # are spun up and it assumes you have already done this separately.
+            embed = TitanTakeoffEmbed(models=[reader_1])
+
+            # Wait for the reader to be deployed, time needed depends on the model size
+            # and your internet speed
+            time.sleep(60)
+
+            # Returns the embedded query, ie a List[float], sent to `embed` consumer
+            # group where we just spun up the embedding reader
+            print(embed.embed_query(
+                "Where can I see football?", consumer_group="embed"
+            ))
+
+            # Returns a List of embeddings, ie a List[List[float]], sent to `embed`
+            # consumer group where we just spun up the embedding reader
+            print(embed.embed_document(
+                ["Document1", "Document2"],
+                consumer_group="embed"
+            ))
+    """
+
+    base_url: str = "http://localhost"
+    """The base URL of the Titan Takeoff (Pro) server. Default = "http://localhost"."""
+
+    port: int = 3000
+    """The port of the Titan Takeoff (Pro) server. Default = 3000."""
+
+    mgmt_port: int = 3001
+    """The management port of the Titan Takeoff (Pro) server. Default = 3001."""
+
+    client: Any = None
+    """Takeoff Client Python SDK used to interact with Takeoff API"""
+
+    embed_consumer_groups: Set[str] = set()
+    """The consumer groups in Takeoff which contain embedding models"""
+
+    def __init__(
+        self,
+        base_url: str = "http://localhost",
+        port: int = 3000,
+        mgmt_port: int = 3001,
+        models: List[ReaderConfig] = [],
+    ):
+        """Initialize the Titan Takeoff embedding wrapper.
+
+        Args:
+            base_url (str, optional): The base url where Takeoff Inference Server is
+            listening. Defaults to "http://localhost".
+            port (int, optional): What port is Takeoff Inference API listening on.
+            Defaults to 3000.
+            mgmt_port (int, optional): What port is Takeoff Management API listening on.
+            Defaults to 3001.
+            models (List[ReaderConfig], optional): Any readers you'd like to spin up on.
+            Defaults to [].
+
+        Raises:
+            ImportError: If you haven't installed takeoff-client, you will get an
+            ImportError. To remedy run `pip install 'takeoff-client==0.4.0'`
+        """
+        self.base_url = base_url
+        self.port = port
+        self.mgmt_port = mgmt_port
+        try:
+            from takeoff_client import TakeoffClient
+        except ImportError:
+            raise ImportError(
+                "takeoff-client is required for TitanTakeoff. "
+                "Please install it with `pip install 'takeoff-client==0.4.0'`."
+            )
+        self.client = TakeoffClient(
+            self.base_url, port=self.port, mgmt_port=self.mgmt_port
+        )
+        for model in models:
+            self.client.create_reader(model)
+            if isinstance(model, dict):
+                self.embed_consumer_groups.add(model.get("consumer_group"))
+            else:
+                self.embed_consumer_groups.add(model.consumer_group)
+        super(TitanTakeoffEmbed, self).__init__()
+
+    def _embed(
+        self, input: Union[List[str], str], consumer_group: Optional[str]
+    ) -> dict:
+        """Embed text.
+
+        Args:
+            input (List[str]): prompt/document or list of prompts/documents to embed
+            consumer_group (Optional[str]): what consumer group to send the embedding
+            request to. If not specified and there is only one
+            consumer group specified during initialization, it will be used. If there
+            are multiple consumer groups specified during initialization, you must
+            specify which one to use.
+
+        Raises:
+            MissingConsumerGroup: The consumer group can not be inferred from the
+            initialization and must be specified with request.
+
+        Returns:
+            Dict[str, Any]: Result of query, {"result": List[List[float]]} or
+            {"result": List[float]}
+        """
+        if not consumer_group:
+            if len(self.embed_consumer_groups) == 1:
+                consumer_group = list(self.embed_consumer_groups)[0]
+            elif len(self.embed_consumer_groups) > 1:
+                raise MissingConsumerGroup(
+                    "TakeoffEmbedding was initialized with multiple embedding reader"
+                    "groups, you must specify which one to use."
+                )
+            else:
+                raise MissingConsumerGroup(
+                    "You must specify what consumer group you want to send embedding"
+                    "response to as TitanTakeoffEmbed was not initialized with an "
+                    "embedding reader."
+                )
+        return self.client.embed(input, consumer_group)
+
+    def embed_documents(
+        self, texts: List[str], consumer_group: Optional[str] = None
+    ) -> List[List[float]]:
+        """Embed documents.
+
+        Args:
+            texts (List[str]): List of prompts/documents to embed
+            consumer_group (Optional[str], optional): Consumer group to send request
+            to containing embedding model. Defaults to None.
+
+        Returns:
+            List[List[float]]: List of embeddings
+        """
+        return self._embed(texts, consumer_group)["result"]
+
+    def embed_query(
+        self, text: str, consumer_group: Optional[str] = None
+    ) -> List[float]:
+        """Embed query.
+
+        Args:
+            text (str): Prompt/document to embed
+            consumer_group (Optional[str], optional): Consumer group to send request
+            to containing embedding model. Defaults to None.
+
+        Returns:
+            List[float]: Embedding
+        """
+        return self._embed(text, consumer_group)["result"]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/vertexai.py b/llm/Lib/site-packages/langchain_community/embeddings/vertexai.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b6677d664da3f5a5fdb9fa8aa3036bea485dc69
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/vertexai.py
@@ -0,0 +1,360 @@
+import logging
+import re
+import string
+import threading
+from concurrent.futures import ThreadPoolExecutor, wait
+from typing import Any, Dict, List, Literal, Optional, Tuple
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.embeddings import Embeddings
+from langchain_core.language_models.llms import create_base_retry_decorator
+from langchain_core.pydantic_v1 import root_validator
+
+from langchain_community.llms.vertexai import _VertexAICommon
+from langchain_community.utilities.vertexai import raise_vertex_import_error
+
+logger = logging.getLogger(__name__)
+
+_MAX_TOKENS_PER_BATCH = 20000
+_MAX_BATCH_SIZE = 250
+_MIN_BATCH_SIZE = 5
+
+
+@deprecated(
+    since="0.0.12",
+    removal="0.2.0",
+    alternative_import="langchain_google_vertexai.VertexAIEmbeddings",
+)
+class VertexAIEmbeddings(_VertexAICommon, Embeddings):
+    """Google Cloud VertexAI embedding models."""
+
+    # Instance context
+    instance: Dict[str, Any] = {}  #: :meta private:
+    show_progress_bar: bool = False
+    """Whether to show a tqdm progress bar. Must have `tqdm` installed."""
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validates that the python package exists in environment."""
+        cls._try_init_vertexai(values)
+        if values["model_name"] == "textembedding-gecko-default":
+            logger.warning(
+                "Model_name will become a required arg for VertexAIEmbeddings "
+                "starting from Feb-01-2024. Currently the default is set to "
+                "textembedding-gecko@001"
+            )
+            values["model_name"] = "textembedding-gecko@001"
+        try:
+            from vertexai.language_models import TextEmbeddingModel
+        except ImportError:
+            raise_vertex_import_error()
+        values["client"] = TextEmbeddingModel.from_pretrained(values["model_name"])
+        return values
+
+    def __init__(
+        self,
+        # the default value would be removed after Feb-01-2024
+        model_name: str = "textembedding-gecko-default",
+        project: Optional[str] = None,
+        location: str = "us-central1",
+        request_parallelism: int = 5,
+        max_retries: int = 6,
+        credentials: Optional[Any] = None,
+        **kwargs: Any,
+    ):
+        """Initialize the sentence_transformer."""
+        super().__init__(
+            project=project,
+            location=location,
+            credentials=credentials,
+            request_parallelism=request_parallelism,
+            max_retries=max_retries,
+            model_name=model_name,
+            **kwargs,
+        )
+        self.instance["max_batch_size"] = kwargs.get("max_batch_size", _MAX_BATCH_SIZE)
+        self.instance["batch_size"] = self.instance["max_batch_size"]
+        self.instance["min_batch_size"] = kwargs.get("min_batch_size", _MIN_BATCH_SIZE)
+        self.instance["min_good_batch_size"] = self.instance["min_batch_size"]
+        self.instance["lock"] = threading.Lock()
+        self.instance["batch_size_validated"] = False
+        self.instance["task_executor"] = ThreadPoolExecutor(
+            max_workers=request_parallelism
+        )
+        self.instance[
+            "embeddings_task_type_supported"
+        ] = not self.client._endpoint_name.endswith("/textembedding-gecko@001")
+
+    @staticmethod
+    def _split_by_punctuation(text: str) -> List[str]:
+        """Splits a string by punctuation and whitespace characters."""
+        split_by = string.punctuation + "\t\n "
+        pattern = f"([{split_by}])"
+        # Using re.split to split the text based on the pattern
+        return [segment for segment in re.split(pattern, text) if segment]
+
+    @staticmethod
+    def _prepare_batches(texts: List[str], batch_size: int) -> List[List[str]]:
+        """Splits texts in batches based on current maximum batch size
+        and maximum tokens per request.
+        """
+        text_index = 0
+        texts_len = len(texts)
+        batch_token_len = 0
+        batches: List[List[str]] = []
+        current_batch: List[str] = []
+        if texts_len == 0:
+            return []
+        while text_index < texts_len:
+            current_text = texts[text_index]
+            # Number of tokens per a text is conservatively estimated
+            # as 2 times number of words, punctuation and whitespace characters.
+            # Using `count_tokens` API will make batching too expensive.
+            # Utilizing a tokenizer, would add a dependency that would not
+            # necessarily be reused by the application using this class.
+            current_text_token_cnt = (
+                len(VertexAIEmbeddings._split_by_punctuation(current_text)) * 2
+            )
+            end_of_batch = False
+            if current_text_token_cnt > _MAX_TOKENS_PER_BATCH:
+                # Current text is too big even for a single batch.
+                # Such request will fail, but we still make a batch
+                # so that the app can get the error from the API.
+                if len(current_batch) > 0:
+                    # Adding current batch if not empty.
+                    batches.append(current_batch)
+                current_batch = [current_text]
+                text_index += 1
+                end_of_batch = True
+            elif (
+                batch_token_len + current_text_token_cnt > _MAX_TOKENS_PER_BATCH
+                or len(current_batch) == batch_size
+            ):
+                end_of_batch = True
+            else:
+                if text_index == texts_len - 1:
+                    # Last element - even though the batch may be not big,
+                    # we still need to make it.
+                    end_of_batch = True
+                batch_token_len += current_text_token_cnt
+                current_batch.append(current_text)
+                text_index += 1
+            if end_of_batch:
+                batches.append(current_batch)
+                current_batch = []
+                batch_token_len = 0
+        return batches
+
+    def _get_embeddings_with_retry(
+        self, texts: List[str], embeddings_type: Optional[str] = None
+    ) -> List[List[float]]:
+        """Makes a Vertex AI model request with retry logic."""
+        from google.api_core.exceptions import (
+            Aborted,
+            DeadlineExceeded,
+            ResourceExhausted,
+            ServiceUnavailable,
+        )
+
+        errors = [
+            ResourceExhausted,
+            ServiceUnavailable,
+            Aborted,
+            DeadlineExceeded,
+        ]
+        retry_decorator = create_base_retry_decorator(
+            error_types=errors, max_retries=self.max_retries
+        )
+
+        @retry_decorator
+        def _completion_with_retry(texts_to_process: List[str]) -> Any:
+            if embeddings_type and self.instance["embeddings_task_type_supported"]:
+                from vertexai.language_models import TextEmbeddingInput
+
+                requests = [
+                    TextEmbeddingInput(text=t, task_type=embeddings_type)
+                    for t in texts_to_process
+                ]
+            else:
+                requests = texts_to_process
+            embeddings = self.client.get_embeddings(requests)
+            return [embs.values for embs in embeddings]
+
+        return _completion_with_retry(texts)
+
+    def _prepare_and_validate_batches(
+        self, texts: List[str], embeddings_type: Optional[str] = None
+    ) -> Tuple[List[List[float]], List[List[str]]]:
+        """Prepares text batches with one-time validation of batch size.
+        Batch size varies between GCP regions and individual project quotas.
+        # Returns embeddings of the first text batch that went through,
+        # and text batches for the rest of the texts.
+        """
+        from google.api_core.exceptions import InvalidArgument
+
+        batches = VertexAIEmbeddings._prepare_batches(
+            texts, self.instance["batch_size"]
+        )
+        # If batch size if less or equal to one that went through before,
+        # then keep batches as they are.
+        if len(batches[0]) <= self.instance["min_good_batch_size"]:
+            return [], batches
+        with self.instance["lock"]:
+            # If largest possible batch size was validated
+            # while waiting for the lock, then check for rebuilding
+            # our batches, and return.
+            if self.instance["batch_size_validated"]:
+                if len(batches[0]) <= self.instance["batch_size"]:
+                    return [], batches
+                else:
+                    return [], VertexAIEmbeddings._prepare_batches(
+                        texts, self.instance["batch_size"]
+                    )
+            # Figure out largest possible batch size by trying to push
+            # batches and lowering their size in half after every failure.
+            first_batch = batches[0]
+            first_result = []
+            had_failure = False
+            while True:
+                try:
+                    first_result = self._get_embeddings_with_retry(
+                        first_batch, embeddings_type
+                    )
+                    break
+                except InvalidArgument:
+                    had_failure = True
+                    first_batch_len = len(first_batch)
+                    if first_batch_len == self.instance["min_batch_size"]:
+                        raise
+                    first_batch_len = max(
+                        self.instance["min_batch_size"], int(first_batch_len / 2)
+                    )
+                    first_batch = first_batch[:first_batch_len]
+            first_batch_len = len(first_batch)
+            self.instance["min_good_batch_size"] = max(
+                self.instance["min_good_batch_size"], first_batch_len
+            )
+            # If had a failure and recovered
+            # or went through with the max size, then it's a legit batch size.
+            if had_failure or first_batch_len == self.instance["max_batch_size"]:
+                self.instance["batch_size"] = first_batch_len
+                self.instance["batch_size_validated"] = True
+                # If batch size was updated,
+                # rebuild batches with the new batch size
+                # (texts that went through are excluded here).
+                if first_batch_len != self.instance["max_batch_size"]:
+                    batches = VertexAIEmbeddings._prepare_batches(
+                        texts[first_batch_len:], self.instance["batch_size"]
+                    )
+            else:
+                # Still figuring out max batch size.
+                batches = batches[1:]
+        # Returning embeddings of the first text batch that went through,
+        # and text batches for the rest of texts.
+        return first_result, batches
+
+    def embed(
+        self,
+        texts: List[str],
+        batch_size: int = 0,
+        embeddings_task_type: Optional[
+            Literal[
+                "RETRIEVAL_QUERY",
+                "RETRIEVAL_DOCUMENT",
+                "SEMANTIC_SIMILARITY",
+                "CLASSIFICATION",
+                "CLUSTERING",
+            ]
+        ] = None,
+    ) -> List[List[float]]:
+        """Embed a list of strings.
+
+        Args:
+            texts: List[str] The list of strings to embed.
+            batch_size: [int] The batch size of embeddings to send to the model.
+                If zero, then the largest batch size will be detected dynamically
+                at the first request, starting from 250, down to 5.
+            embeddings_task_type: [str] optional embeddings task type,
+                one of the following
+                    RETRIEVAL_QUERY	- Text is a query
+                                      in a search/retrieval setting.
+                    RETRIEVAL_DOCUMENT - Text is a document
+                                         in a search/retrieval setting.
+                    SEMANTIC_SIMILARITY - Embeddings will be used
+                                          for Semantic Textual Similarity (STS).
+                    CLASSIFICATION - Embeddings will be used for classification.
+                    CLUSTERING - Embeddings will be used for clustering.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        if len(texts) == 0:
+            return []
+        embeddings: List[List[float]] = []
+        first_batch_result: List[List[float]] = []
+        if batch_size > 0:
+            # Fixed batch size.
+            batches = VertexAIEmbeddings._prepare_batches(texts, batch_size)
+        else:
+            # Dynamic batch size, starting from 250 at the first call.
+            first_batch_result, batches = self._prepare_and_validate_batches(
+                texts, embeddings_task_type
+            )
+        # First batch result may have some embeddings already.
+        # In such case, batches have texts that were not processed yet.
+        embeddings.extend(first_batch_result)
+        tasks = []
+        if self.show_progress_bar:
+            try:
+                from tqdm import tqdm
+
+                iter_ = tqdm(batches, desc="VertexAIEmbeddings")
+            except ImportError:
+                logger.warning(
+                    "Unable to show progress bar because tqdm could not be imported. "
+                    "Please install with `pip install tqdm`."
+                )
+                iter_ = batches
+        else:
+            iter_ = batches
+        for batch in iter_:
+            tasks.append(
+                self.instance["task_executor"].submit(
+                    self._get_embeddings_with_retry,
+                    texts=batch,
+                    embeddings_type=embeddings_task_type,
+                )
+            )
+        if len(tasks) > 0:
+            wait(tasks)
+        for t in tasks:
+            embeddings.extend(t.result())
+        return embeddings
+
+    def embed_documents(
+        self, texts: List[str], batch_size: int = 0
+    ) -> List[List[float]]:
+        """Embed a list of documents.
+
+        Args:
+            texts: List[str] The list of texts to embed.
+            batch_size: [int] The batch size of embeddings to send to the model.
+                If zero, then the largest batch size will be detected dynamically
+                at the first request, starting from 250, down to 5.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        return self.embed(texts, batch_size, "RETRIEVAL_DOCUMENT")
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embedding for the text.
+        """
+        embeddings = self.embed([text], 1, "RETRIEVAL_QUERY")
+        return embeddings[0]
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/volcengine.py b/llm/Lib/site-packages/langchain_community/embeddings/volcengine.py
new file mode 100644
index 0000000000000000000000000000000000000000..98ac729b96807c78f1970c041126ccf78b73c590
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/volcengine.py
@@ -0,0 +1,128 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+class VolcanoEmbeddings(BaseModel, Embeddings):
+    """`Volcengine Embeddings` embedding models."""
+
+    volcano_ak: Optional[str] = None
+    """volcano access key
+    learn more from: https://www.volcengine.com/docs/6459/76491#ak-sk"""
+
+    volcano_sk: Optional[str] = None
+    """volcano secret key
+    learn more from: https://www.volcengine.com/docs/6459/76491#ak-sk"""
+
+    host: str = "maas-api.ml-platform-cn-beijing.volces.com"
+    """host
+    learn more from https://www.volcengine.com/docs/82379/1174746"""
+    region: str = "cn-beijing"
+    """region
+    learn more from https://www.volcengine.com/docs/82379/1174746"""
+
+    model: str = "bge-large-zh"
+    """Model name
+    you could get from https://www.volcengine.com/docs/82379/1174746
+    for now, we support bge_large_zh
+    """
+
+    version: str = "1.0"
+    """ model version """
+
+    chunk_size: int = 100
+    """Chunk size when multiple texts are input"""
+
+    client: Any
+    """volcano client"""
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """
+        Validate whether volcano_ak and volcano_sk in the environment variables or
+        configuration file are available or not.
+
+        init volcano embedding client with `ak`, `sk`, `host`, `region`
+
+        Args:
+
+            values: a dictionary containing configuration information, must include the
+            fields of volcano_ak and volcano_sk
+        Returns:
+
+            a dictionary containing configuration information. If volcano_ak and
+            volcano_sk are not provided in the environment variables or configuration
+            file,the original values will be returned; otherwise, values containing
+            volcano_ak and volcano_sk will be returned.
+        Raises:
+
+            ValueError: volcengine package not found, please install it with
+            `pip install volcengine`
+        """
+        values["volcano_ak"] = get_from_dict_or_env(
+            values,
+            "volcano_ak",
+            "VOLC_ACCESSKEY",
+        )
+        values["volcano_sk"] = get_from_dict_or_env(
+            values,
+            "volcano_sk",
+            "VOLC_SECRETKEY",
+        )
+
+        try:
+            from volcengine.maas import MaasService
+
+            client = MaasService(values["host"], values["region"])
+            client.set_ak(values["volcano_ak"])
+            client.set_sk(values["volcano_sk"])
+            values["client"] = client
+        except ImportError:
+            raise ImportError(
+                "volcengine package not found, please install it with "
+                "`pip install volcengine`"
+            )
+        return values
+
+    def embed_query(self, text: str) -> List[float]:
+        return self.embed_documents([text])[0]
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """
+        Embeds a list of text documents using the AutoVOT algorithm.
+
+        Args:
+            texts (List[str]): A list of text documents to embed.
+
+        Returns:
+            List[List[float]]: A list of embeddings for each document in the input list.
+                            Each embedding is represented as a list of float values.
+        """
+        text_in_chunks = [
+            texts[i : i + self.chunk_size]
+            for i in range(0, len(texts), self.chunk_size)
+        ]
+        lst = []
+        for chunk in text_in_chunks:
+            req = {
+                "model": {
+                    "name": self.model,
+                    "version": self.version,
+                },
+                "input": chunk,
+            }
+            try:
+                from volcengine.maas import MaasException
+
+                resp = self.client.embeddings(req)
+                lst.extend([res["embedding"] for res in resp["data"]])
+            except MaasException as e:
+                raise ValueError(f"embed by volcengine Error: {e}")
+        return lst
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/voyageai.py b/llm/Lib/site-packages/langchain_community/embeddings/voyageai.py
new file mode 100644
index 0000000000000000000000000000000000000000..81eb03345f0a33d043aaf480ef7bbdfd0c8f9dcd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/voyageai.py
@@ -0,0 +1,230 @@
+from __future__ import annotations
+
+import json
+import logging
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    List,
+    Optional,
+    Tuple,
+    Union,
+    cast,
+)
+
+import requests
+from langchain_core._api.deprecation import deprecated
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+from tenacity import (
+    before_sleep_log,
+    retry,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def _create_retry_decorator(embeddings: VoyageEmbeddings) -> Callable[[Any], Any]:
+    min_seconds = 4
+    max_seconds = 10
+    # Wait 2^x * 1 second between each retry starting with
+    # 4 seconds, then up to 10 seconds, then 10 seconds afterwards
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(embeddings.max_retries),
+        wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def _check_response(response: dict) -> dict:
+    if "data" not in response:
+        raise RuntimeError(f"Voyage API Error. Message: {json.dumps(response)}")
+    return response
+
+
+def embed_with_retry(embeddings: VoyageEmbeddings, **kwargs: Any) -> Any:
+    """Use tenacity to retry the embedding call."""
+    retry_decorator = _create_retry_decorator(embeddings)
+
+    @retry_decorator
+    def _embed_with_retry(**kwargs: Any) -> Any:
+        response = requests.post(**kwargs)
+        return _check_response(response.json())
+
+    return _embed_with_retry(**kwargs)
+
+
+@deprecated(
+    since="0.0.29",
+    removal="0.2",
+    alternative_import="langchain_voyageai.VoyageAIEmbeddings",
+)
+class VoyageEmbeddings(BaseModel, Embeddings):
+    """Voyage embedding models.
+
+    To use, you should have the environment variable ``VOYAGE_API_KEY`` set with
+    your API key or pass it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import VoyageEmbeddings
+
+            voyage = VoyageEmbeddings(voyage_api_key="your-api-key", model="voyage-2")
+            text = "This is a test query."
+            query_result = voyage.embed_query(text)
+    """
+
+    model: str
+    voyage_api_base: str = "https://api.voyageai.com/v1/embeddings"
+    voyage_api_key: Optional[SecretStr] = None
+    batch_size: int
+    """Maximum number of texts to embed in each API request."""
+    max_retries: int = 6
+    """Maximum number of retries to make when generating."""
+    request_timeout: Optional[Union[float, Tuple[float, float]]] = None
+    """Timeout in seconds for the API request."""
+    show_progress_bar: bool = False
+    """Whether to show a progress bar when embedding. Must have tqdm installed if set 
+        to True."""
+    truncation: bool = True
+    """Whether to truncate the input texts to fit within the context length.
+    
+        If True, over-length input texts will be truncated to fit within the context 
+        length, before vectorized by the embedding model. If False, an error will be 
+        raised if any given text exceeds the context length."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["voyage_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "voyage_api_key", "VOYAGE_API_KEY")
+        )
+
+        if "model" not in values:
+            values["model"] = "voyage-01"
+            logger.warning(
+                "model will become a required arg for VoyageAIEmbeddings, "
+                "we recommend to specify it when using this class. "
+                "Currently the default is set to voyage-01."
+            )
+
+        if "batch_size" not in values:
+            values["batch_size"] = (
+                72
+                if "model" in values and (values["model"] in ["voyage-2", "voyage-02"])
+                else 7
+            )
+
+        return values
+
+    def _invocation_params(
+        self, input: List[str], input_type: Optional[str] = None
+    ) -> Dict:
+        api_key = cast(SecretStr, self.voyage_api_key).get_secret_value()
+        params: Dict = {
+            "url": self.voyage_api_base,
+            "headers": {"Authorization": f"Bearer {api_key}"},
+            "json": {
+                "model": self.model,
+                "input": input,
+                "input_type": input_type,
+                "truncation": self.truncation,
+            },
+            "timeout": self.request_timeout,
+        }
+        return params
+
+    def _get_embeddings(
+        self,
+        texts: List[str],
+        batch_size: Optional[int] = None,
+        input_type: Optional[str] = None,
+    ) -> List[List[float]]:
+        embeddings: List[List[float]] = []
+
+        if batch_size is None:
+            batch_size = self.batch_size
+
+        if self.show_progress_bar:
+            try:
+                from tqdm.auto import tqdm
+            except ImportError as e:
+                raise ImportError(
+                    "Must have tqdm installed if `show_progress_bar` is set to True. "
+                    "Please install with `pip install tqdm`."
+                ) from e
+
+            _iter = tqdm(range(0, len(texts), batch_size))
+        else:
+            _iter = range(0, len(texts), batch_size)
+
+        if input_type and input_type not in ["query", "document"]:
+            raise ValueError(
+                f"input_type {input_type} is invalid. Options: None, 'query', "
+                "'document'."
+            )
+
+        for i in _iter:
+            response = embed_with_retry(
+                self,
+                **self._invocation_params(
+                    input=texts[i : i + batch_size], input_type=input_type
+                ),
+            )
+            embeddings.extend(r["embedding"] for r in response["data"])
+
+        return embeddings
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Call out to Voyage Embedding endpoint for embedding search docs.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+        return self._get_embeddings(
+            texts, batch_size=self.batch_size, input_type="document"
+        )
+
+    def embed_query(self, text: str) -> List[float]:
+        """Call out to Voyage Embedding endpoint for embedding query text.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embedding for the text.
+        """
+        return self._get_embeddings(
+            [text], batch_size=self.batch_size, input_type="query"
+        )[0]
+
+    def embed_general_texts(
+        self, texts: List[str], *, input_type: Optional[str] = None
+    ) -> List[List[float]]:
+        """Call out to Voyage Embedding endpoint for embedding general text.
+
+        Args:
+            texts: The list of texts to embed.
+            input_type: Type of the input text. Default to None, meaning the type is
+                unspecified. Other options: query, document.
+
+        Returns:
+            Embedding for the text.
+        """
+        return self._get_embeddings(
+            texts, batch_size=self.batch_size, input_type=input_type
+        )
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/xinference.py b/llm/Lib/site-packages/langchain_community/embeddings/xinference.py
new file mode 100644
index 0000000000000000000000000000000000000000..db9b56fcbf9bcde160cde93dffaba128e14c363a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/xinference.py
@@ -0,0 +1,124 @@
+"""Wrapper around Xinference embedding models."""
+from typing import Any, List, Optional
+
+from langchain_core.embeddings import Embeddings
+
+
+class XinferenceEmbeddings(Embeddings):
+
+    """Xinference embedding models.
+
+    To use, you should have the xinference library installed:
+
+    .. code-block:: bash
+
+        pip install xinference
+
+    Check out: https://github.com/xorbitsai/inference
+    To run, you need to start a Xinference supervisor on one server and Xinference workers on the other servers.
+
+    Example:
+        To start a local instance of Xinference, run
+
+        .. code-block:: bash
+
+           $ xinference
+
+        You can also deploy Xinference in a distributed cluster. Here are the steps:
+
+        Starting the supervisor:
+
+        .. code-block:: bash
+
+           $ xinference-supervisor
+
+        Starting the worker:
+
+        .. code-block:: bash
+
+           $ xinference-worker
+
+    Then, launch a model using command line interface (CLI).
+
+    Example:
+
+    .. code-block:: bash
+
+       $ xinference launch -n orca -s 3 -q q4_0
+
+    It will return a model UID. Then you can use Xinference Embedding with LangChain.
+
+    Example:
+
+    .. code-block:: python
+
+        from langchain_community.embeddings import XinferenceEmbeddings
+
+        xinference = XinferenceEmbeddings(
+            server_url="http://0.0.0.0:9997",
+            model_uid = {model_uid} # replace model_uid with the model UID return from launching the model
+        )
+
+    """  # noqa: E501
+
+    client: Any
+    server_url: Optional[str]
+    """URL of the xinference server"""
+    model_uid: Optional[str]
+    """UID of the launched model"""
+
+    def __init__(
+        self, server_url: Optional[str] = None, model_uid: Optional[str] = None
+    ):
+        try:
+            from xinference.client import RESTfulClient
+        except ImportError as e:
+            raise ImportError(
+                "Could not import RESTfulClient from xinference. Please install it"
+                " with `pip install xinference`."
+            ) from e
+
+        super().__init__()
+
+        if server_url is None:
+            raise ValueError("Please provide server URL")
+
+        if model_uid is None:
+            raise ValueError("Please provide the model UID")
+
+        self.server_url = server_url
+
+        self.model_uid = model_uid
+
+        self.client = RESTfulClient(server_url)
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed a list of documents using Xinference.
+        Args:
+            texts: The list of texts to embed.
+        Returns:
+            List of embeddings, one for each text.
+        """
+
+        model = self.client.get_model(self.model_uid)
+
+        embeddings = [
+            model.create_embedding(text)["data"][0]["embedding"] for text in texts
+        ]
+        return [list(map(float, e)) for e in embeddings]
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query of documents using Xinference.
+        Args:
+            text: The text to embed.
+        Returns:
+            Embeddings for the text.
+        """
+
+        model = self.client.get_model(self.model_uid)
+
+        embedding_res = model.create_embedding(text)
+
+        embedding = embedding_res["data"][0]["embedding"]
+
+        return list(map(float, embedding))
diff --git a/llm/Lib/site-packages/langchain_community/embeddings/yandex.py b/llm/Lib/site-packages/langchain_community/embeddings/yandex.py
new file mode 100644
index 0000000000000000000000000000000000000000..c129c8169e9ee42ba02f99522b6cdf6debe5c2b3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/embeddings/yandex.py
@@ -0,0 +1,203 @@
+"""Wrapper around YandexGPT embedding models."""
+from __future__ import annotations
+
+import logging
+import time
+from typing import Any, Callable, Dict, List
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+from tenacity import (
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class YandexGPTEmbeddings(BaseModel, Embeddings):
+    """YandexGPT Embeddings models.
+
+    To use, you should have the ``yandexcloud`` python package installed.
+
+    There are two authentication options for the service account
+    with the ``ai.languageModels.user`` role:
+        - You can specify the token in a constructor parameter `iam_token`
+        or in an environment variable `YC_IAM_TOKEN`.
+        - You can specify the key in a constructor parameter `api_key`
+        or in an environment variable `YC_API_KEY`.
+
+    To use the default model specify the folder ID in a parameter `folder_id`
+    or in an environment variable `YC_FOLDER_ID`.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings.yandex import YandexGPTEmbeddings
+            embeddings = YandexGPTEmbeddings(iam_token="t1.9eu...", folder_id=<folder-id>)
+    """  # noqa: E501
+
+    iam_token: SecretStr = ""  # type: ignore[assignment]
+    """Yandex Cloud IAM token for service account
+    with the `ai.languageModels.user` role"""
+    api_key: SecretStr = ""  # type: ignore[assignment]
+    """Yandex Cloud Api Key for service account
+    with the `ai.languageModels.user` role"""
+    model_uri: str = Field(default="", alias="query_model_uri")
+    """Query model uri to use."""
+    doc_model_uri: str = ""
+    """Doc model uri to use."""
+    folder_id: str = ""
+    """Yandex Cloud folder ID"""
+    doc_model_name: str = "text-search-doc"
+    """Doc model name to use."""
+    model_name: str = Field(default="text-search-query", alias="query_model_name")
+    """Query model name to use."""
+    model_version: str = "latest"
+    """Model version to use."""
+    url: str = "llm.api.cloud.yandex.net:443"
+    """The url of the API."""
+    max_retries: int = 6
+    """Maximum number of retries to make when generating."""
+    sleep_interval: float = 0.0
+    """Delay between API requests"""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that iam token exists in environment."""
+
+        iam_token = convert_to_secret_str(
+            get_from_dict_or_env(values, "iam_token", "YC_IAM_TOKEN", "")
+        )
+        values["iam_token"] = iam_token
+        api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "api_key", "YC_API_KEY", "")
+        )
+        values["api_key"] = api_key
+        folder_id = get_from_dict_or_env(values, "folder_id", "YC_FOLDER_ID", "")
+        values["folder_id"] = folder_id
+        if api_key.get_secret_value() == "" and iam_token.get_secret_value() == "":
+            raise ValueError("Either 'YC_API_KEY' or 'YC_IAM_TOKEN' must be provided.")
+        if values["iam_token"]:
+            values["_grpc_metadata"] = [
+                ("authorization", f"Bearer {values['iam_token'].get_secret_value()}")
+            ]
+            if values["folder_id"]:
+                values["_grpc_metadata"].append(("x-folder-id", values["folder_id"]))
+        else:
+            values["_grpc_metadata"] = (
+                ("authorization", f"Api-Key {values['api_key'].get_secret_value()}"),
+            )
+
+        if not values.get("doc_model_uri"):
+            if values["folder_id"] == "":
+                raise ValueError("'doc_model_uri' or 'folder_id' must be provided.")
+            values[
+                "doc_model_uri"
+            ] = f"emb://{values['folder_id']}/{values['doc_model_name']}/{values['model_version']}"  # noqa: E501
+        if not values.get("model_uri"):
+            if values["folder_id"] == "":
+                raise ValueError("'model_uri' or 'folder_id' must be provided.")
+            values[
+                "model_uri"
+            ] = f"emb://{values['folder_id']}/{values['model_name']}/{values['model_version']}"  # noqa: E501
+        return values
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed documents using a YandexGPT embeddings models.
+
+        Args:
+            texts: The list of texts to embed.
+
+        Returns:
+            List of embeddings, one for each text.
+        """
+
+        return _embed_with_retry(self, texts=texts)
+
+    def embed_query(self, text: str) -> List[float]:
+        """Embed a query using a YandexGPT embeddings models.
+
+        Args:
+            text: The text to embed.
+
+        Returns:
+            Embeddings for the text.
+        """
+        return _embed_with_retry(self, texts=[text], embed_query=True)[0]
+
+
+def _create_retry_decorator(llm: YandexGPTEmbeddings) -> Callable[[Any], Any]:
+    from grpc import RpcError
+
+    min_seconds = 1
+    max_seconds = 60
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(llm.max_retries),
+        wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+        retry=(retry_if_exception_type((RpcError))),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def _embed_with_retry(llm: YandexGPTEmbeddings, **kwargs: Any) -> Any:
+    """Use tenacity to retry the embedding call."""
+    retry_decorator = _create_retry_decorator(llm)
+
+    @retry_decorator
+    def _completion_with_retry(**_kwargs: Any) -> Any:
+        return _make_request(llm, **_kwargs)
+
+    return _completion_with_retry(**kwargs)
+
+
+def _make_request(self: YandexGPTEmbeddings, texts: List[str], **kwargs):  # type: ignore[no-untyped-def]
+    try:
+        import grpc
+
+        try:
+            from yandex.cloud.ai.foundation_models.v1.embedding.embedding_service_pb2 import (  # noqa: E501
+                TextEmbeddingRequest,
+            )
+            from yandex.cloud.ai.foundation_models.v1.embedding.embedding_service_pb2_grpc import (  # noqa: E501
+                EmbeddingsServiceStub,
+            )
+        except ModuleNotFoundError:
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_service_pb2 import (  # noqa: E501
+                TextEmbeddingRequest,
+            )
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_service_pb2_grpc import (  # noqa: E501
+                EmbeddingsServiceStub,
+            )
+    except ImportError as e:
+        raise ImportError(
+            "Please install YandexCloud SDK  with `pip install yandexcloud` \
+            or upgrade it to recent version."
+        ) from e
+    result = []
+    channel_credentials = grpc.ssl_channel_credentials()
+    channel = grpc.secure_channel(self.url, channel_credentials)
+    # Use the query model if embed_query is True
+    if kwargs.get("embed_query"):
+        model_uri = self.model_uri
+    else:
+        model_uri = self.doc_model_uri
+
+    for text in texts:
+        request = TextEmbeddingRequest(model_uri=model_uri, text=text)
+        stub = EmbeddingsServiceStub(channel)
+        res = stub.TextEmbedding(request, metadata=self._grpc_metadata)  # type: ignore[attr-defined]
+        result.append(list(res.embedding))
+        time.sleep(self.sleep_interval)
+
+    return result
diff --git a/llm/Lib/site-packages/langchain_community/example_selectors/__init__.py b/llm/Lib/site-packages/langchain_community/example_selectors/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3210172e09d7dfd64045210b4c5b368e7392cde6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/example_selectors/__init__.py
@@ -0,0 +1,17 @@
+"""**Example selector** implements logic for selecting examples to include them
+in prompts.
+This allows us to select examples that are most relevant to the input.
+
+There could be multiple strategies for selecting examples. For example, one could
+select examples based on the similarity of the input to the examples. Another
+strategy could be to select examples based on the diversity of the examples.
+"""
+from langchain_community.example_selectors.ngram_overlap import (
+    NGramOverlapExampleSelector,
+    ngram_overlap_score,
+)
+
+__all__ = [
+    "NGramOverlapExampleSelector",
+    "ngram_overlap_score",
+]
diff --git a/llm/Lib/site-packages/langchain_community/example_selectors/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/example_selectors/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..522ca9c0f48efe9858c7aacc1f686277d37c8acb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/example_selectors/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/example_selectors/__pycache__/ngram_overlap.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/example_selectors/__pycache__/ngram_overlap.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..070a3e8f0d9d9802b4368c0cf31751c4dcdaf9aa
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/example_selectors/__pycache__/ngram_overlap.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/example_selectors/ngram_overlap.py b/llm/Lib/site-packages/langchain_community/example_selectors/ngram_overlap.py
new file mode 100644
index 0000000000000000000000000000000000000000..c8d662f8e1fc283153e6151a3ec23e5eb734f3b7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/example_selectors/ngram_overlap.py
@@ -0,0 +1,114 @@
+"""Select and order examples based on ngram overlap score (sentence_bleu score).
+
+https://www.nltk.org/_modules/nltk/translate/bleu_score.html
+https://aclanthology.org/P02-1040.pdf
+"""
+from typing import Dict, List
+
+import numpy as np
+from langchain_core.example_selectors import BaseExampleSelector
+from langchain_core.prompts import PromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+
+def ngram_overlap_score(source: List[str], example: List[str]) -> float:
+    """Compute ngram overlap score of source and example as sentence_bleu score
+    from NLTK package.
+
+    Use sentence_bleu with method1 smoothing function and auto reweighting.
+    Return float value between 0.0 and 1.0 inclusive.
+    https://www.nltk.org/_modules/nltk/translate/bleu_score.html
+    https://aclanthology.org/P02-1040.pdf
+    """
+    from nltk.translate.bleu_score import (
+        SmoothingFunction,  # type: ignore
+        sentence_bleu,
+    )
+
+    hypotheses = source[0].split()
+    references = [s.split() for s in example]
+
+    return float(
+        sentence_bleu(
+            references,
+            hypotheses,
+            smoothing_function=SmoothingFunction().method1,
+            auto_reweigh=True,
+        )
+    )
+
+
+class NGramOverlapExampleSelector(BaseExampleSelector, BaseModel):
+    """Select and order examples based on ngram overlap score (sentence_bleu score
+    from NLTK package).
+
+    https://www.nltk.org/_modules/nltk/translate/bleu_score.html
+    https://aclanthology.org/P02-1040.pdf
+    """
+
+    examples: List[dict]
+    """A list of the examples that the prompt template expects."""
+
+    example_prompt: PromptTemplate
+    """Prompt template used to format the examples."""
+
+    threshold: float = -1.0
+    """Threshold at which algorithm stops. Set to -1.0 by default.
+
+    For negative threshold:
+    select_examples sorts examples by ngram_overlap_score, but excludes none.
+    For threshold greater than 1.0:
+    select_examples excludes all examples, and returns an empty list.
+    For threshold equal to 0.0:
+    select_examples sorts examples by ngram_overlap_score,
+    and excludes examples with no ngram overlap with input.
+    """
+
+    @root_validator(pre=True)
+    def check_dependencies(cls, values: Dict) -> Dict:
+        """Check that valid dependencies exist."""
+        try:
+            from nltk.translate.bleu_score import (  # noqa: F401
+                SmoothingFunction,
+                sentence_bleu,
+            )
+        except ImportError as e:
+            raise ImportError(
+                "Not all the correct dependencies for this ExampleSelect exist."
+                "Please install nltk with `pip install nltk`."
+            ) from e
+
+        return values
+
+    def add_example(self, example: Dict[str, str]) -> None:
+        """Add new example to list."""
+        self.examples.append(example)
+
+    def select_examples(self, input_variables: Dict[str, str]) -> List[dict]:
+        """Return list of examples sorted by ngram_overlap_score with input.
+
+        Descending order.
+        Excludes any examples with ngram_overlap_score less than or equal to threshold.
+        """
+        inputs = list(input_variables.values())
+        examples = []
+        k = len(self.examples)
+        score = [0.0] * k
+        first_prompt_template_key = self.example_prompt.input_variables[0]
+
+        for i in range(k):
+            score[i] = ngram_overlap_score(
+                inputs, [self.examples[i][first_prompt_template_key]]
+            )
+
+        while True:
+            arg_max = np.argmax(score)
+            if (score[arg_max] < self.threshold) or abs(
+                score[arg_max] - self.threshold
+            ) < 1e-9:
+                break
+
+            examples.append(self.examples[arg_max])
+            score[arg_max] = self.threshold - 1.0
+
+        return examples
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__init__.py b/llm/Lib/site-packages/langchain_community/graphs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c13d6ed9e8036a55cc20ba65618b0f9a6df1257a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/__init__.py
@@ -0,0 +1,94 @@
+"""**Graphs** provide a natural language interface to graph databases."""
+
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.graphs.arangodb_graph import (
+        ArangoGraph,  # noqa: F401
+    )
+    from langchain_community.graphs.falkordb_graph import (
+        FalkorDBGraph,  # noqa: F401
+    )
+    from langchain_community.graphs.gremlin_graph import (
+        GremlinGraph,  # noqa: F401
+    )
+    from langchain_community.graphs.hugegraph import (
+        HugeGraph,  # noqa: F401
+    )
+    from langchain_community.graphs.kuzu_graph import (
+        KuzuGraph,  # noqa: F401
+    )
+    from langchain_community.graphs.memgraph_graph import (
+        MemgraphGraph,  # noqa: F401
+    )
+    from langchain_community.graphs.nebula_graph import (
+        NebulaGraph,  # noqa: F401
+    )
+    from langchain_community.graphs.neo4j_graph import (
+        Neo4jGraph,  # noqa: F401
+    )
+    from langchain_community.graphs.neptune_graph import (
+        NeptuneGraph,  # noqa: F401
+    )
+    from langchain_community.graphs.neptune_rdf_graph import (
+        NeptuneRdfGraph,  # noqa: F401
+    )
+    from langchain_community.graphs.networkx_graph import (
+        NetworkxEntityGraph,  # noqa: F401
+    )
+    from langchain_community.graphs.ontotext_graphdb_graph import (
+        OntotextGraphDBGraph,  # noqa: F401
+    )
+    from langchain_community.graphs.rdf_graph import (
+        RdfGraph,  # noqa: F401
+    )
+    from langchain_community.graphs.tigergraph_graph import (
+        TigerGraph,  # noqa: F401
+    )
+
+__all__ = [
+    "ArangoGraph",
+    "FalkorDBGraph",
+    "GremlinGraph",
+    "HugeGraph",
+    "KuzuGraph",
+    "MemgraphGraph",
+    "NebulaGraph",
+    "Neo4jGraph",
+    "NeptuneGraph",
+    "NeptuneRdfGraph",
+    "NetworkxEntityGraph",
+    "OntotextGraphDBGraph",
+    "RdfGraph",
+    "TigerGraph",
+]
+
+_module_lookup = {
+    "ArangoGraph": "langchain_community.graphs.arangodb_graph",
+    "FalkorDBGraph": "langchain_community.graphs.falkordb_graph",
+    "GremlinGraph": "langchain_community.graphs.gremlin_graph",
+    "HugeGraph": "langchain_community.graphs.hugegraph",
+    "KuzuGraph": "langchain_community.graphs.kuzu_graph",
+    "MemgraphGraph": "langchain_community.graphs.memgraph_graph",
+    "NebulaGraph": "langchain_community.graphs.nebula_graph",
+    "Neo4jGraph": "langchain_community.graphs.neo4j_graph",
+    "BaseNeptuneGraph": "langchain_community.graphs.neptune_graph",
+    "NeptuneAnalyticsGraph": "langchain_community.graphs.neptune_graph",
+    "NeptuneGraph": "langchain_community.graphs.neptune_graph",
+    "NeptuneRdfGraph": "langchain_community.graphs.neptune_rdf_graph",
+    "NetworkxEntityGraph": "langchain_community.graphs.networkx_graph",
+    "OntotextGraphDBGraph": "langchain_community.graphs.ontotext_graphdb_graph",
+    "RdfGraph": "langchain_community.graphs.rdf_graph",
+    "TigerGraph": "langchain_community.graphs.tigergraph_graph",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c5b00d2a5c038b7ba29ade2cd9a0497733afe10d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/arangodb_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/arangodb_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..17fd6421282deda6c25e1be4f2ea953e3c54b8ce
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/arangodb_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/falkordb_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/falkordb_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6debffaae729b942a698d2def38c50d8492aaaf2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/falkordb_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/graph_document.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/graph_document.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ea6ae114ab7ab006de797fa7ec2b40dca7d4c940
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/graph_document.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/graph_store.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/graph_store.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bc72ffbff4a29c30e0362eb4900ab80bbe348d8c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/graph_store.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/gremlin_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/gremlin_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2dce2203b3b4d1a9a14d530c034e13264b160f78
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/gremlin_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/hugegraph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/hugegraph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6a5be389575d862bc6c8268bff6ad27c8e3178c3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/hugegraph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/kuzu_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/kuzu_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d0ad539fbec7bf71f2028f4ae0d64b54b1f3b084
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/kuzu_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/memgraph_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/memgraph_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f1d3158c87be955f7d428b74e7e6d4cfdb04737d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/memgraph_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/nebula_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/nebula_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5d6e492ece098028356f97d6bb9784b50d641a63
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/nebula_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/neo4j_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/neo4j_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a6eff9fcf3617bea240ac34546558d8cdfffef7f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/neo4j_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/neptune_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/neptune_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..efca69b835efbd3806d9c278d13a0ace5e47aba7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/neptune_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/neptune_rdf_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/neptune_rdf_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e8c3d96408e4176708ee2a366dfb505a742d0fc5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/neptune_rdf_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/networkx_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/networkx_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3766bbede8b850bdb9217b8eb17957546c48f5f6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/networkx_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/ontotext_graphdb_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/ontotext_graphdb_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1a038214cbd6cc286b9e80f3f9607dd0c5f670a5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/ontotext_graphdb_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/rdf_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/rdf_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..21c2a146dca71c5cfc340b4421472736460ea3bc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/rdf_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/__pycache__/tigergraph_graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/tigergraph_graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a73492edc870e620ddf66c6e129249ada9658ca5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/graphs/__pycache__/tigergraph_graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/graphs/arangodb_graph.py b/llm/Lib/site-packages/langchain_community/graphs/arangodb_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9e4530058e83cc2da1c4c68f7f7e601c4688c48
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/arangodb_graph.py
@@ -0,0 +1,182 @@
+import os
+from math import ceil
+from typing import Any, Dict, List, Optional
+
+
+class ArangoGraph:
+    """ArangoDB wrapper for graph operations.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(self, db: Any) -> None:
+        """Create a new ArangoDB graph wrapper instance."""
+        self.set_db(db)
+        self.set_schema()
+
+    @property
+    def db(self) -> Any:
+        return self.__db
+
+    @property
+    def schema(self) -> Dict[str, Any]:
+        return self.__schema
+
+    def set_db(self, db: Any) -> None:
+        from arango.database import Database
+
+        if not isinstance(db, Database):
+            msg = "**db** parameter must inherit from arango.database.Database"
+            raise TypeError(msg)
+
+        self.__db: Database = db
+        self.set_schema()
+
+    def set_schema(self, schema: Optional[Dict[str, Any]] = None) -> None:
+        """
+        Set the schema of the ArangoDB Database.
+        Auto-generates Schema if **schema** is None.
+        """
+        self.__schema = self.generate_schema() if schema is None else schema
+
+    def generate_schema(
+        self, sample_ratio: float = 0
+    ) -> Dict[str, List[Dict[str, Any]]]:
+        """
+        Generates the schema of the ArangoDB Database and returns it
+        User can specify a **sample_ratio** (0 to 1) to determine the
+        ratio of documents/edges used (in relation to the Collection size)
+        to render each Collection Schema.
+        """
+        if not 0 <= sample_ratio <= 1:
+            raise ValueError("**sample_ratio** value must be in between 0 to 1")
+
+        # Stores the Edge Relationships between each ArangoDB Document Collection
+        graph_schema: List[Dict[str, Any]] = [
+            {"graph_name": g["name"], "edge_definitions": g["edge_definitions"]}
+            for g in self.db.graphs()
+        ]
+
+        # Stores the schema of every ArangoDB Document/Edge collection
+        collection_schema: List[Dict[str, Any]] = []
+
+        for collection in self.db.collections():
+            if collection["system"]:
+                continue
+
+            # Extract collection name, type, and size
+            col_name: str = collection["name"]
+            col_type: str = collection["type"]
+            col_size: int = self.db.collection(col_name).count()
+
+            # Skip collection if empty
+            if col_size == 0:
+                continue
+
+            # Set number of ArangoDB documents/edges to retrieve
+            limit_amount = ceil(sample_ratio * col_size) or 1
+
+            aql = f"""
+                FOR doc in {col_name}
+                    LIMIT {limit_amount}
+                    RETURN doc
+            """
+
+            doc: Dict[str, Any]
+            properties: List[Dict[str, str]] = []
+            for doc in self.__db.aql.execute(aql):
+                for key, value in doc.items():
+                    properties.append({"name": key, "type": type(value).__name__})
+
+            collection_schema.append(
+                {
+                    "collection_name": col_name,
+                    "collection_type": col_type,
+                    f"{col_type}_properties": properties,
+                    f"example_{col_type}": doc,
+                }
+            )
+
+        return {"Graph Schema": graph_schema, "Collection Schema": collection_schema}
+
+    def query(
+        self, query: str, top_k: Optional[int] = None, **kwargs: Any
+    ) -> List[Dict[str, Any]]:
+        """Query the ArangoDB database."""
+        import itertools
+
+        cursor = self.__db.aql.execute(query, **kwargs)
+        return [doc for doc in itertools.islice(cursor, top_k)]
+
+    @classmethod
+    def from_db_credentials(
+        cls,
+        url: Optional[str] = None,
+        dbname: Optional[str] = None,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+    ) -> Any:
+        """Convenience constructor that builds Arango DB from credentials.
+
+        Args:
+            url: Arango DB url. Can be passed in as named arg or set as environment
+                var ``ARANGODB_URL``. Defaults to "http://localhost:8529".
+            dbname: Arango DB name. Can be passed in as named arg or set as
+                environment var ``ARANGODB_DBNAME``. Defaults to "_system".
+            username: Can be passed in as named arg or set as environment var
+                ``ARANGODB_USERNAME``. Defaults to "root".
+            password: Can be passed ni as named arg or set as environment var
+                ``ARANGODB_PASSWORD``. Defaults to "".
+
+        Returns:
+            An arango.database.StandardDatabase.
+        """
+        db = get_arangodb_client(
+            url=url, dbname=dbname, username=username, password=password
+        )
+        return cls(db)
+
+
+def get_arangodb_client(
+    url: Optional[str] = None,
+    dbname: Optional[str] = None,
+    username: Optional[str] = None,
+    password: Optional[str] = None,
+) -> Any:
+    """Get the Arango DB client from credentials.
+
+    Args:
+        url: Arango DB url. Can be passed in as named arg or set as environment
+            var ``ARANGODB_URL``. Defaults to "http://localhost:8529".
+        dbname: Arango DB name. Can be passed in as named arg or set as
+            environment var ``ARANGODB_DBNAME``. Defaults to "_system".
+        username: Can be passed in as named arg or set as environment var
+            ``ARANGODB_USERNAME``. Defaults to "root".
+        password: Can be passed ni as named arg or set as environment var
+            ``ARANGODB_PASSWORD``. Defaults to "".
+
+    Returns:
+        An arango.database.StandardDatabase.
+    """
+    try:
+        from arango import ArangoClient
+    except ImportError as e:
+        raise ImportError(
+            "Unable to import arango, please install with `pip install python-arango`."
+        ) from e
+
+    _url: str = url or os.environ.get("ARANGODB_URL", "http://localhost:8529")  # type: ignore[assignment]  # noqa: E501
+    _dbname: str = dbname or os.environ.get("ARANGODB_DBNAME", "_system")  # type: ignore[assignment]  # noqa: E501
+    _username: str = username or os.environ.get("ARANGODB_USERNAME", "root")  # type: ignore[assignment]  # noqa: E501
+    _password: str = password or os.environ.get("ARANGODB_PASSWORD", "")  # type: ignore[assignment]  # noqa: E501
+
+    return ArangoClient(_url).db(_dbname, _username, _password, verify=True)
diff --git a/llm/Lib/site-packages/langchain_community/graphs/falkordb_graph.py b/llm/Lib/site-packages/langchain_community/graphs/falkordb_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..99e3e4592b3e95579b9f1957041b94d70ec8ef20
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/falkordb_graph.py
@@ -0,0 +1,201 @@
+import warnings
+from typing import Any, Dict, List, Optional
+
+from langchain_core._api import deprecated
+
+from langchain_community.graphs.graph_document import GraphDocument
+from langchain_community.graphs.graph_store import GraphStore
+
+node_properties_query = """
+MATCH (n)
+WITH keys(n) as keys, labels(n) AS labels
+WITH CASE WHEN keys = [] THEN [NULL] ELSE keys END AS keys, labels
+UNWIND labels AS label
+UNWIND keys AS key
+WITH label, collect(DISTINCT key) AS keys
+RETURN {label:label, keys:keys} AS output
+"""
+
+rel_properties_query = """
+MATCH ()-[r]->()
+WITH keys(r) as keys, type(r) AS types
+WITH CASE WHEN keys = [] THEN [NULL] ELSE keys END AS keys, types 
+UNWIND types AS type
+UNWIND keys AS key WITH type,
+collect(DISTINCT key) AS keys 
+RETURN {types:type, keys:keys} AS output
+"""
+
+rel_query = """
+MATCH (n)-[r]->(m)
+UNWIND labels(n) as src_label
+UNWIND labels(m) as dst_label
+UNWIND type(r) as rel_type
+RETURN DISTINCT {start: src_label, type: rel_type, end: dst_label} AS output
+"""
+
+
+class FalkorDBGraph(GraphStore):
+    """FalkorDB wrapper for graph operations.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(
+        self,
+        database: str,
+        host: str = "localhost",
+        port: int = 6379,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        ssl: bool = False,
+    ) -> None:
+        """Create a new FalkorDB graph wrapper instance."""
+        try:
+            self.__init_falkordb_connection(
+                database, host, port, username, password, ssl
+            )
+
+        except ImportError:
+            try:
+                # Falls back to using the redis package just for backwards compatibility
+                self.__init_redis_connection(
+                    database, host, port, username, password, ssl
+                )
+            except ImportError:
+                raise ImportError(
+                    "Could not import falkordb python package. "
+                    "Please install it with `pip install falkordb`."
+                )
+
+        self.schema: str = ""
+        self.structured_schema: Dict[str, Any] = {}
+
+        try:
+            self.refresh_schema()
+        except Exception as e:
+            raise ValueError(f"Could not refresh schema. Error: {e}")
+
+    def __init_falkordb_connection(
+        self,
+        database: str,
+        host: str = "localhost",
+        port: int = 6379,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        ssl: bool = False,
+    ) -> None:
+        from falkordb import FalkorDB
+
+        try:
+            self._driver = FalkorDB(
+                host=host, port=port, username=username, password=password, ssl=ssl
+            )
+        except Exception as e:
+            raise ConnectionError(f"Failed to connect to FalkorDB: {e}")
+
+        self._graph = self._driver.select_graph(database)
+
+    @deprecated("0.0.31", alternative="__init_falkordb_connection")
+    def __init_redis_connection(
+        self,
+        database: str,
+        host: str = "localhost",
+        port: int = 6379,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        ssl: bool = False,
+    ) -> None:
+        import redis
+        from redis.commands.graph import Graph
+
+        # show deprecation warning
+        warnings.warn(
+            "Using the redis package is deprecated. "
+            "Please use the falkordb package instead, "
+            "install it with `pip install falkordb`.",
+            DeprecationWarning,
+        )
+
+        self._driver = redis.Redis(
+            host=host, port=port, username=username, password=password, ssl=ssl
+        )
+
+        self._graph = Graph(self._driver, database)
+
+    @property
+    def get_schema(self) -> str:
+        """Returns the schema of the FalkorDB database"""
+        return self.schema
+
+    @property
+    def get_structured_schema(self) -> Dict[str, Any]:
+        """Returns the structured schema of the Graph"""
+        return self.structured_schema
+
+    def refresh_schema(self) -> None:
+        """Refreshes the schema of the FalkorDB database"""
+        node_properties: List[Any] = self.query(node_properties_query)
+        rel_properties: List[Any] = self.query(rel_properties_query)
+        relationships: List[Any] = self.query(rel_query)
+
+        self.structured_schema = {
+            "node_props": {el[0]["label"]: el[0]["keys"] for el in node_properties},
+            "rel_props": {el[0]["types"]: el[0]["keys"] for el in rel_properties},
+            "relationships": [el[0] for el in relationships],
+        }
+
+        self.schema = (
+            f"Node properties: {node_properties}\n"
+            f"Relationships properties: {rel_properties}\n"
+            f"Relationships: {relationships}\n"
+        )
+
+    def query(self, query: str, params: dict = {}) -> List[Dict[str, Any]]:
+        """Query FalkorDB database."""
+
+        try:
+            data = self._graph.query(query, params)
+            return data.result_set
+        except Exception as e:
+            raise ValueError("Generated Cypher Statement is not valid\n" f"{e}")
+
+    def add_graph_documents(
+        self, graph_documents: List[GraphDocument], include_source: bool = False
+    ) -> None:
+        """
+        Take GraphDocument as input as uses it to construct a graph.
+        """
+        for document in graph_documents:
+            # Import nodes
+            for node in document.nodes:
+                self.query(
+                    (
+                        f"MERGE (n:{node.type} {{id:'{node.id}'}}) "
+                        "SET n += $properties "
+                        "RETURN distinct 'done' AS result"
+                    ),
+                    {"properties": node.properties},
+                )
+
+            # Import relationships
+            for rel in document.relationships:
+                self.query(
+                    (
+                        f"MATCH (a:{rel.source.type} {{id:'{rel.source.id}'}}), "
+                        f"(b:{rel.target.type} {{id:'{rel.target.id}'}}) "
+                        f"MERGE (a)-[r:{(rel.type.replace(' ', '_').upper())}]->(b) "
+                        "SET r += $properties "
+                        "RETURN distinct 'done' AS result"
+                    ),
+                    {"properties": rel.properties},
+                )
diff --git a/llm/Lib/site-packages/langchain_community/graphs/graph_document.py b/llm/Lib/site-packages/langchain_community/graphs/graph_document.py
new file mode 100644
index 0000000000000000000000000000000000000000..3e9a597cc565fb7d0cdbe3bb8d11c69fd84ae6f3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/graph_document.py
@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+from typing import List, Union
+
+from langchain_core.documents import Document
+from langchain_core.load.serializable import Serializable
+from langchain_core.pydantic_v1 import Field
+
+
+class Node(Serializable):
+    """Represents a node in a graph with associated properties.
+
+    Attributes:
+        id (Union[str, int]): A unique identifier for the node.
+        type (str): The type or label of the node, default is "Node".
+        properties (dict): Additional properties and metadata associated with the node.
+    """
+
+    id: Union[str, int]
+    type: str = "Node"
+    properties: dict = Field(default_factory=dict)
+
+
+class Relationship(Serializable):
+    """Represents a directed relationship between two nodes in a graph.
+
+    Attributes:
+        source (Node): The source node of the relationship.
+        target (Node): The target node of the relationship.
+        type (str): The type of the relationship.
+        properties (dict): Additional properties associated with the relationship.
+    """
+
+    source: Node
+    target: Node
+    type: str
+    properties: dict = Field(default_factory=dict)
+
+
+class GraphDocument(Serializable):
+    """Represents a graph document consisting of nodes and relationships.
+
+    Attributes:
+        nodes (List[Node]): A list of nodes in the graph.
+        relationships (List[Relationship]): A list of relationships in the graph.
+        source (Document): The document from which the graph information is derived.
+    """
+
+    nodes: List[Node]
+    relationships: List[Relationship]
+    source: Document
diff --git a/llm/Lib/site-packages/langchain_community/graphs/graph_store.py b/llm/Lib/site-packages/langchain_community/graphs/graph_store.py
new file mode 100644
index 0000000000000000000000000000000000000000..0618eae48ddbb06e370247f192a93d8026cae365
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/graph_store.py
@@ -0,0 +1,37 @@
+from abc import abstractmethod
+from typing import Any, Dict, List
+
+from langchain_community.graphs.graph_document import GraphDocument
+
+
+class GraphStore:
+    """An abstract class wrapper for graph operations."""
+
+    @property
+    @abstractmethod
+    def get_schema(self) -> str:
+        """Returns the schema of the Graph database"""
+        pass
+
+    @property
+    @abstractmethod
+    def get_structured_schema(self) -> Dict[str, Any]:
+        """Returns the schema of the Graph database"""
+        pass
+
+    @abstractmethod
+    def query(self, query: str, params: dict = {}) -> List[Dict[str, Any]]:
+        """Query the graph."""
+        pass
+
+    @abstractmethod
+    def refresh_schema(self) -> None:
+        """Refreshes the graph schema information."""
+        pass
+
+    @abstractmethod
+    def add_graph_documents(
+        self, graph_documents: List[GraphDocument], include_source: bool = False
+    ) -> None:
+        """Take GraphDocument as input as uses it to construct a graph."""
+        pass
diff --git a/llm/Lib/site-packages/langchain_community/graphs/gremlin_graph.py b/llm/Lib/site-packages/langchain_community/graphs/gremlin_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..2711c4f92a68f3b064262e90c23cb9cdd9297ad4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/gremlin_graph.py
@@ -0,0 +1,207 @@
+import hashlib
+import sys
+from typing import Any, Dict, List, Optional, Union
+
+from langchain_core.utils import get_from_env
+
+from langchain_community.graphs.graph_document import GraphDocument, Node, Relationship
+from langchain_community.graphs.graph_store import GraphStore
+
+
+class GremlinGraph(GraphStore):
+    """Gremlin wrapper for graph operations.
+    Parameters:
+    url (Optional[str]): The URL of the Gremlin database server or env GREMLIN_URI
+    username (Optional[str]): The collection-identifier like '/dbs/database/colls/graph'
+                               or env GREMLIN_USERNAME if none provided
+    password (Optional[str]): The connection-key for database authentication
+                              or env GREMLIN_PASSWORD if none provided
+    traversal_source (str): The traversal source to use for queries. Defaults to 'g'.
+    message_serializer (Optional[Any]): The message serializer to use for requests.
+                                        Defaults to serializer.GraphSONSerializersV2d0()
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+
+    *Implementation details*:
+        The Gremlin queries are designed to work with Azure CosmosDB limitations
+    """
+
+    @property
+    def get_structured_schema(self) -> Dict[str, Any]:
+        return self.structured_schema
+
+    def __init__(
+        self,
+        url: Optional[str] = None,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        traversal_source: str = "g",
+        message_serializer: Optional[Any] = None,
+    ) -> None:
+        """Create a new Gremlin graph wrapper instance."""
+        try:
+            import asyncio
+
+            from gremlin_python.driver import client, serializer
+
+            if sys.platform == "win32":
+                asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
+        except ImportError:
+            raise ValueError(
+                "Please install gremlin-python first: " "`pip3 install gremlinpython"
+            )
+
+        self.client = client.Client(
+            url=get_from_env("url", "GREMLIN_URI", url),
+            traversal_source=traversal_source,
+            username=get_from_env("username", "GREMLIN_USERNAME", username),
+            password=get_from_env("password", "GREMLIN_PASSWORD", password),
+            message_serializer=message_serializer
+            if message_serializer
+            else serializer.GraphSONSerializersV2d0(),
+        )
+        self.schema: str = ""
+
+    @property
+    def get_schema(self) -> str:
+        """Returns the schema of the Gremlin database"""
+        if len(self.schema) == 0:
+            self.refresh_schema()
+        return self.schema
+
+    def refresh_schema(self) -> None:
+        """
+        Refreshes the Gremlin graph schema information.
+        """
+        vertex_schema = self.client.submit("g.V().label().dedup()").all().result()
+        edge_schema = self.client.submit("g.E().label().dedup()").all().result()
+        vertex_properties = (
+            self.client.submit(
+                "g.V().group().by(label).by(properties().label().dedup().fold())"
+            )
+            .all()
+            .result()[0]
+        )
+
+        self.structured_schema = {
+            "vertex_labels": vertex_schema,
+            "edge_labels": edge_schema,
+            "vertice_props": vertex_properties,
+        }
+
+        self.schema = "\n".join(
+            [
+                "Vertex labels are the following:",
+                ",".join(vertex_schema),
+                "Edge labes are the following:",
+                ",".join(edge_schema),
+                f"Vertices have following properties:\n{vertex_properties}",
+            ]
+        )
+
+    def query(self, query: str, params: dict = {}) -> List[Dict[str, Any]]:
+        q = self.client.submit(query)
+        return q.all().result()
+
+    def add_graph_documents(
+        self, graph_documents: List[GraphDocument], include_source: bool = False
+    ) -> None:
+        """
+        Take GraphDocument as input as uses it to construct a graph.
+        """
+        node_cache: Dict[Union[str, int], Node] = {}
+        for document in graph_documents:
+            if include_source:
+                # Create document vertex
+                doc_props = {
+                    "page_content": document.source.page_content,
+                    "metadata": document.source.metadata,
+                }
+                doc_id = hashlib.md5(document.source.page_content.encode()).hexdigest()
+                doc_node = self.add_node(
+                    Node(id=doc_id, type="Document", properties=doc_props), node_cache
+                )
+
+            # Import nodes to vertices
+            for n in document.nodes:
+                node = self.add_node(n)
+                if include_source:
+                    # Add Edge to document for each node
+                    self.add_edge(
+                        Relationship(
+                            type="contains information about",
+                            source=doc_node,
+                            target=node,
+                            properties={},
+                        )
+                    )
+                    self.add_edge(
+                        Relationship(
+                            type="is extracted from",
+                            source=node,
+                            target=doc_node,
+                            properties={},
+                        )
+                    )
+
+            # Edges
+            for el in document.relationships:
+                # Find or create the source vertex
+                self.add_node(el.source, node_cache)
+                # Find or create the target vertex
+                self.add_node(el.target, node_cache)
+                # Find or create the edge
+                self.add_edge(el)
+
+    def build_vertex_query(self, node: Node) -> str:
+        base_query = (
+            f"g.V().has('id','{node.id}').fold()"
+            + f".coalesce(unfold(),addV('{node.type}')"
+            + f".property('id','{node.id}')"
+            + f".property('type','{node.type}')"
+        )
+        for key, value in node.properties.items():
+            base_query += f".property('{key}', '{value}')"
+
+        return base_query + ")"
+
+    def build_edge_query(self, relationship: Relationship) -> str:
+        source_query = f".has('id','{relationship.source.id}')"
+        target_query = f".has('id','{relationship.target.id}')"
+
+        base_query = f""""g.V(){source_query}.as('a')  
+            .V(){target_query}.as('b') 
+            .choose(
+                __.inE('{relationship.type}').where(outV().as('a')),
+                __.identity(),
+                __.addE('{relationship.type}').from('a').to('b')
+            )        
+            """.replace("\n", "").replace("\t", "")
+        for key, value in relationship.properties.items():
+            base_query += f".property('{key}', '{value}')"
+
+        return base_query
+
+    def add_node(self, node: Node, node_cache: dict = {}) -> Node:
+        # if properties does not have label, add type as label
+        if "label" not in node.properties:
+            node.properties["label"] = node.type
+        if node.id in node_cache:
+            return node_cache[node.id]
+        else:
+            query = self.build_vertex_query(node)
+            _ = self.client.submit(query).all().result()[0]
+            node_cache[node.id] = node
+            return node
+
+    def add_edge(self, relationship: Relationship) -> Any:
+        query = self.build_edge_query(relationship)
+        return self.client.submit(query).all().result()
diff --git a/llm/Lib/site-packages/langchain_community/graphs/hugegraph.py b/llm/Lib/site-packages/langchain_community/graphs/hugegraph.py
new file mode 100644
index 0000000000000000000000000000000000000000..a052efce4d0c47cc8a00ffbd5a73c3f2d2a06182
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/hugegraph.py
@@ -0,0 +1,74 @@
+from typing import Any, Dict, List
+
+
+class HugeGraph:
+    """HugeGraph wrapper for graph operations.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(
+        self,
+        username: str = "default",
+        password: str = "default",
+        address: str = "127.0.0.1",
+        port: int = 8081,
+        graph: str = "hugegraph",
+    ) -> None:
+        """Create a new HugeGraph wrapper instance."""
+        try:
+            from hugegraph.connection import PyHugeGraph
+        except ImportError:
+            raise ValueError(
+                "Please install HugeGraph Python client first: "
+                "`pip3 install hugegraph-python`"
+            )
+
+        self.username = username
+        self.password = password
+        self.address = address
+        self.port = port
+        self.graph = graph
+        self.client = PyHugeGraph(
+            address, port, user=username, pwd=password, graph=graph
+        )
+        self.schema = ""
+        # Set schema
+        try:
+            self.refresh_schema()
+        except Exception as e:
+            raise ValueError(f"Could not refresh schema. Error: {e}")
+
+    @property
+    def get_schema(self) -> str:
+        """Returns the schema of the HugeGraph database"""
+        return self.schema
+
+    def refresh_schema(self) -> None:
+        """
+        Refreshes the HugeGraph schema information.
+        """
+        schema = self.client.schema()
+        vertex_schema = schema.getVertexLabels()
+        edge_schema = schema.getEdgeLabels()
+        relationships = schema.getRelations()
+
+        self.schema = (
+            f"Node properties: {vertex_schema}\n"
+            f"Edge properties: {edge_schema}\n"
+            f"Relationships: {relationships}\n"
+        )
+
+    def query(self, query: str) -> List[Dict[str, Any]]:
+        g = self.client.gremlin()
+        res = g.exec(query)
+        return res["data"]
diff --git a/llm/Lib/site-packages/langchain_community/graphs/kuzu_graph.py b/llm/Lib/site-packages/langchain_community/graphs/kuzu_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f99f49fc9435514245bc4c26fe0a27df6c738a9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/kuzu_graph.py
@@ -0,0 +1,95 @@
+from typing import Any, Dict, List
+
+
+class KuzuGraph:
+    """Kùzu wrapper for graph operations.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(self, db: Any, database: str = "kuzu") -> None:
+        try:
+            import kuzu
+        except ImportError:
+            raise ImportError(
+                "Could not import Kùzu python package."
+                "Please install Kùzu with `pip install kuzu`."
+            )
+        self.db = db
+        self.conn = kuzu.Connection(self.db)
+        self.database = database
+        self.refresh_schema()
+
+    @property
+    def get_schema(self) -> str:
+        """Returns the schema of the Kùzu database"""
+        return self.schema
+
+    def query(self, query: str, params: dict = {}) -> List[Dict[str, Any]]:
+        """Query Kùzu database"""
+        result = self.conn.execute(query, params)
+        column_names = result.get_column_names()
+        return_list = []
+        while result.has_next():
+            row = result.get_next()
+            return_list.append(dict(zip(column_names, row)))
+        return return_list
+
+    def refresh_schema(self) -> None:
+        """Refreshes the Kùzu graph schema information"""
+        node_properties = []
+        node_table_names = self.conn._get_node_table_names()
+        for table_name in node_table_names:
+            current_table_schema = {"properties": [], "label": table_name}
+            properties = self.conn._get_node_property_names(table_name)
+            for property_name in properties:
+                property_type = properties[property_name]["type"]
+                list_type_flag = ""
+                if properties[property_name]["dimension"] > 0:
+                    if "shape" in properties[property_name]:
+                        for s in properties[property_name]["shape"]:
+                            list_type_flag += "[%s]" % s
+                    else:
+                        for i in range(properties[property_name]["dimension"]):
+                            list_type_flag += "[]"
+                property_type += list_type_flag
+                current_table_schema["properties"].append(
+                    (property_name, property_type)
+                )
+            node_properties.append(current_table_schema)
+
+        relationships = []
+        rel_tables = self.conn._get_rel_table_names()
+        for table in rel_tables:
+            relationships.append(
+                "(:%s)-[:%s]->(:%s)" % (table["src"], table["name"], table["dst"])
+            )
+
+        rel_properties = []
+        for table in rel_tables:
+            table_name = table["name"]
+            current_table_schema = {"properties": [], "label": table_name}
+            query_result = self.conn.execute(
+                f"CALL table_info('{table_name}') RETURN *;"
+            )
+            while query_result.has_next():
+                row = query_result.get_next()
+                prop_name = row[1]
+                prop_type = row[2]
+                current_table_schema["properties"].append((prop_name, prop_type))
+            rel_properties.append(current_table_schema)
+
+        self.schema = (
+            f"Node properties: {node_properties}\n"
+            f"Relationships properties: {rel_properties}\n"
+            f"Relationships: {relationships}\n"
+        )
diff --git a/llm/Lib/site-packages/langchain_community/graphs/memgraph_graph.py b/llm/Lib/site-packages/langchain_community/graphs/memgraph_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..34e9f7145bb2237f94d637f8f7d758779d555986
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/memgraph_graph.py
@@ -0,0 +1,71 @@
+from langchain_community.graphs.neo4j_graph import Neo4jGraph
+
+SCHEMA_QUERY = """
+CALL llm_util.schema("raw")
+YIELD *
+RETURN *
+"""
+
+
+class MemgraphGraph(Neo4jGraph):
+    """Memgraph wrapper for graph operations.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(
+        self, url: str, username: str, password: str, *, database: str = "memgraph"
+    ) -> None:
+        """Create a new Memgraph graph wrapper instance."""
+        super().__init__(url, username, password, database=database)
+
+    def refresh_schema(self) -> None:
+        """
+        Refreshes the Memgraph graph schema information.
+        """
+
+        db_structured_schema = self.query(SCHEMA_QUERY)[0].get("schema")
+        assert db_structured_schema is not None
+        self.structured_schema = db_structured_schema
+
+        # Format node properties
+        formatted_node_props = []
+
+        for node_name, properties in db_structured_schema["node_props"].items():
+            formatted_node_props.append(
+                f"Node name: '{node_name}', Node properties: {properties}"
+            )
+
+        # Format relationship properties
+        formatted_rel_props = []
+        for rel_name, properties in db_structured_schema["rel_props"].items():
+            formatted_rel_props.append(
+                f"Relationship name: '{rel_name}', "
+                f"Relationship properties: {properties}"
+            )
+
+        # Format relationships
+        formatted_rels = [
+            f"(:{rel['start']})-[:{rel['type']}]->(:{rel['end']})"
+            for rel in db_structured_schema["relationships"]
+        ]
+
+        self.schema = "\n".join(
+            [
+                "Node properties are the following:",
+                *formatted_node_props,
+                "Relationship properties are the following:",
+                *formatted_rel_props,
+                "The relationships are the following:",
+                *formatted_rels,
+            ]
+        )
diff --git a/llm/Lib/site-packages/langchain_community/graphs/nebula_graph.py b/llm/Lib/site-packages/langchain_community/graphs/nebula_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..a1b25e81c2871af6741ed2bb239a553093b77544
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/nebula_graph.py
@@ -0,0 +1,216 @@
+import logging
+from string import Template
+from typing import Any, Dict, Optional
+
+logger = logging.getLogger(__name__)
+
+rel_query = Template(
+    """
+MATCH ()-[e:`$edge_type`]->()
+  WITH e limit 1
+MATCH (m)-[:`$edge_type`]->(n) WHERE id(m) == src(e) AND id(n) == dst(e)
+RETURN "(:" + tags(m)[0] + ")-[:$edge_type]->(:" + tags(n)[0] + ")" AS rels
+"""
+)
+
+RETRY_TIMES = 3
+
+
+class NebulaGraph:
+    """NebulaGraph wrapper for graph operations.
+
+    NebulaGraph inherits methods from Neo4jGraph to bring ease to the user space.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(
+        self,
+        space: str,
+        username: str = "root",
+        password: str = "nebula",
+        address: str = "127.0.0.1",
+        port: int = 9669,
+        session_pool_size: int = 30,
+    ) -> None:
+        """Create a new NebulaGraph wrapper instance."""
+        try:
+            import nebula3  # noqa: F401
+            import pandas  # noqa: F401
+        except ImportError:
+            raise ValueError(
+                "Please install NebulaGraph Python client and pandas first: "
+                "`pip install nebula3-python pandas`"
+            )
+
+        self.username = username
+        self.password = password
+        self.address = address
+        self.port = port
+        self.space = space
+        self.session_pool_size = session_pool_size
+
+        self.session_pool = self._get_session_pool()
+        self.schema = ""
+        # Set schema
+        try:
+            self.refresh_schema()
+        except Exception as e:
+            raise ValueError(f"Could not refresh schema. Error: {e}")
+
+    def _get_session_pool(self) -> Any:
+        assert all(
+            [self.username, self.password, self.address, self.port, self.space]
+        ), (
+            "Please provide all of the following parameters: "
+            "username, password, address, port, space"
+        )
+
+        from nebula3.Config import SessionPoolConfig
+        from nebula3.Exception import AuthFailedException, InValidHostname
+        from nebula3.gclient.net.SessionPool import SessionPool
+
+        config = SessionPoolConfig()
+        config.max_size = self.session_pool_size
+
+        try:
+            session_pool = SessionPool(
+                self.username,
+                self.password,
+                self.space,
+                [(self.address, self.port)],
+            )
+        except InValidHostname:
+            raise ValueError(
+                "Could not connect to NebulaGraph database. "
+                "Please ensure that the address and port are correct"
+            )
+
+        try:
+            session_pool.init(config)
+        except AuthFailedException:
+            raise ValueError(
+                "Could not connect to NebulaGraph database. "
+                "Please ensure that the username and password are correct"
+            )
+        except RuntimeError as e:
+            raise ValueError(f"Error initializing session pool. Error: {e}")
+
+        return session_pool
+
+    def __del__(self) -> None:
+        try:
+            self.session_pool.close()
+        except Exception as e:
+            logger.warning(f"Could not close session pool. Error: {e}")
+
+    @property
+    def get_schema(self) -> str:
+        """Returns the schema of the NebulaGraph database"""
+        return self.schema
+
+    def execute(self, query: str, params: Optional[dict] = None, retry: int = 0) -> Any:
+        """Query NebulaGraph database."""
+        from nebula3.Exception import IOErrorException, NoValidSessionException
+        from nebula3.fbthrift.transport.TTransport import TTransportException
+
+        params = params or {}
+        try:
+            result = self.session_pool.execute_parameter(query, params)
+            if not result.is_succeeded():
+                logger.warning(
+                    f"Error executing query to NebulaGraph. "
+                    f"Error: {result.error_msg()}\n"
+                    f"Query: {query} \n"
+                )
+            return result
+
+        except NoValidSessionException:
+            logger.warning(
+                f"No valid session found in session pool. "
+                f"Please consider increasing the session pool size. "
+                f"Current size: {self.session_pool_size}"
+            )
+            raise ValueError(
+                f"No valid session found in session pool. "
+                f"Please consider increasing the session pool size. "
+                f"Current size: {self.session_pool_size}"
+            )
+
+        except RuntimeError as e:
+            if retry < RETRY_TIMES:
+                retry += 1
+                logger.warning(
+                    f"Error executing query to NebulaGraph. "
+                    f"Retrying ({retry}/{RETRY_TIMES})...\n"
+                    f"query: {query} \n"
+                    f"Error: {e}"
+                )
+                return self.execute(query, params, retry)
+            else:
+                raise ValueError(f"Error executing query to NebulaGraph. Error: {e}")
+
+        except (TTransportException, IOErrorException):
+            # connection issue, try to recreate session pool
+            if retry < RETRY_TIMES:
+                retry += 1
+                logger.warning(
+                    f"Connection issue with NebulaGraph. "
+                    f"Retrying ({retry}/{RETRY_TIMES})...\n to recreate session pool"
+                )
+                self.session_pool = self._get_session_pool()
+                return self.execute(query, params, retry)
+
+    def refresh_schema(self) -> None:
+        """
+        Refreshes the NebulaGraph schema information.
+        """
+        tags_schema, edge_types_schema, relationships = [], [], []
+        for tag in self.execute("SHOW TAGS").column_values("Name"):
+            tag_name = tag.cast()
+            tag_schema = {"tag": tag_name, "properties": []}
+            r = self.execute(f"DESCRIBE TAG `{tag_name}`")
+            props, types = r.column_values("Field"), r.column_values("Type")
+            for i in range(r.row_size()):
+                tag_schema["properties"].append((props[i].cast(), types[i].cast()))
+            tags_schema.append(tag_schema)
+        for edge_type in self.execute("SHOW EDGES").column_values("Name"):
+            edge_type_name = edge_type.cast()
+            edge_schema = {"edge": edge_type_name, "properties": []}
+            r = self.execute(f"DESCRIBE EDGE `{edge_type_name}`")
+            props, types = r.column_values("Field"), r.column_values("Type")
+            for i in range(r.row_size()):
+                edge_schema["properties"].append((props[i].cast(), types[i].cast()))
+            edge_types_schema.append(edge_schema)
+
+            # build relationships types
+            r = self.execute(
+                rel_query.substitute(edge_type=edge_type_name)
+            ).column_values("rels")
+            if len(r) > 0:
+                relationships.append(r[0].cast())
+
+        self.schema = (
+            f"Node properties: {tags_schema}\n"
+            f"Edge properties: {edge_types_schema}\n"
+            f"Relationships: {relationships}\n"
+        )
+
+    def query(self, query: str, retry: int = 0) -> Dict[str, Any]:
+        result = self.execute(query, retry=retry)
+        columns = result.keys()
+        d: Dict[str, list] = {}
+        for col_num in range(result.col_size()):
+            col_name = columns[col_num]
+            col_list = result.column_values(col_name)
+            d[col_name] = [x.cast() for x in col_list]
+        return d
diff --git a/llm/Lib/site-packages/langchain_community/graphs/neo4j_graph.py b/llm/Lib/site-packages/langchain_community/graphs/neo4j_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..72d704a411fc555c4ef677fc60e549e7eed60fbd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/neo4j_graph.py
@@ -0,0 +1,405 @@
+from hashlib import md5
+from typing import Any, Dict, List, Optional
+
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.graphs.graph_document import GraphDocument
+from langchain_community.graphs.graph_store import GraphStore
+
+BASE_ENTITY_LABEL = "__Entity__"
+EXCLUDED_LABELS = ["_Bloom_Perspective_", "_Bloom_Scene_"]
+EXCLUDED_RELS = ["_Bloom_HAS_SCENE_"]
+
+node_properties_query = """
+CALL apoc.meta.data()
+YIELD label, other, elementType, type, property
+WHERE NOT type = "RELATIONSHIP" AND elementType = "node" 
+  AND NOT label IN $EXCLUDED_LABELS
+WITH label AS nodeLabels, collect({property:property, type:type}) AS properties
+RETURN {labels: nodeLabels, properties: properties} AS output
+
+"""
+
+rel_properties_query = """
+CALL apoc.meta.data()
+YIELD label, other, elementType, type, property
+WHERE NOT type = "RELATIONSHIP" AND elementType = "relationship"
+      AND NOT label in $EXCLUDED_LABELS
+WITH label AS nodeLabels, collect({property:property, type:type}) AS properties
+RETURN {type: nodeLabels, properties: properties} AS output
+"""
+
+rel_query = """
+CALL apoc.meta.data()
+YIELD label, other, elementType, type, property
+WHERE type = "RELATIONSHIP" AND elementType = "node"
+UNWIND other AS other_node
+WITH * WHERE NOT label IN $EXCLUDED_LABELS
+    AND NOT other_node IN $EXCLUDED_LABELS
+RETURN {start: label, type: property, end: toString(other_node)} AS output
+"""
+
+include_docs_query = (
+    "MERGE (d:Document {id:$document.metadata.id}) "
+    "SET d.text = $document.page_content "
+    "SET d += $document.metadata "
+    "WITH d "
+)
+
+
+def value_sanitize(d: Any) -> Any:
+    """Sanitize the input dictionary or list.
+
+    Sanitizes the input by removing embedding-like values,
+    lists with more than 128 elements, that are mostly irrelevant for
+    generating answers in a LLM context. These properties, if left in
+    results, can occupy significant context space and detract from
+    the LLM's performance by introducing unnecessary noise and cost.
+    """
+    LIST_LIMIT = 128
+    if isinstance(d, dict):
+        new_dict = {}
+        for key, value in d.items():
+            if isinstance(value, dict):
+                sanitized_value = value_sanitize(value)
+                if (
+                    sanitized_value is not None
+                ):  # Check if the sanitized value is not None
+                    new_dict[key] = sanitized_value
+            elif isinstance(value, list):
+                if len(value) < LIST_LIMIT:
+                    sanitized_value = value_sanitize(value)
+                    if (
+                        sanitized_value is not None
+                    ):  # Check if the sanitized value is not None
+                        new_dict[key] = sanitized_value
+                # Do not include the key if the list is oversized
+            else:
+                new_dict[key] = value
+        return new_dict
+    elif isinstance(d, list):
+        if len(d) < LIST_LIMIT:
+            return [
+                value_sanitize(item) for item in d if value_sanitize(item) is not None
+            ]
+        else:
+            return None
+    else:
+        return d
+
+
+def _get_node_import_query(baseEntityLabel: bool, include_source: bool) -> str:
+    if baseEntityLabel:
+        return (
+            f"{include_docs_query if include_source else ''}"
+            "UNWIND $data AS row "
+            f"MERGE (source:`{BASE_ENTITY_LABEL}` {{id: row.id}}) "
+            "SET source += row.properties "
+            f"{'MERGE (d)-[:MENTIONS]->(source) ' if include_source else ''}"
+            "WITH source, row "
+            "CALL apoc.create.addLabels( source, [row.type] ) YIELD node "
+            "RETURN distinct 'done' AS result"
+        )
+    else:
+        return (
+            f"{include_docs_query if include_source else ''}"
+            "UNWIND $data AS row "
+            "CALL apoc.merge.node([row.type], {id: row.id}, "
+            "row.properties, {}) YIELD node "
+            f"{'MERGE (d)-[:MENTIONS]->(node) ' if include_source else ''}"
+            "RETURN distinct 'done' AS result"
+        )
+
+
+def _get_rel_import_query(baseEntityLabel: bool) -> str:
+    if baseEntityLabel:
+        return (
+            "UNWIND $data AS row "
+            f"MERGE (source:`{BASE_ENTITY_LABEL}` {{id: row.source}}) "
+            f"MERGE (target:`{BASE_ENTITY_LABEL}` {{id: row.target}}) "
+            "WITH source, target, row "
+            "CALL apoc.merge.relationship(source, row.type, "
+            "{}, row.properties, target) YIELD rel "
+            "RETURN distinct 'done'"
+        )
+    else:
+        return (
+            "UNWIND $data AS row "
+            "CALL apoc.merge.node([row.source_label], {id: row.source},"
+            "{}, {}) YIELD node as source "
+            "CALL apoc.merge.node([row.target_label], {id: row.target},"
+            "{}, {}) YIELD node as target "
+            "CALL apoc.merge.relationship(source, row.type, "
+            "{}, row.properties, target) YIELD rel "
+            "RETURN distinct 'done'"
+        )
+
+
+class Neo4jGraph(GraphStore):
+    """Neo4j database wrapper for various graph operations.
+
+    Parameters:
+    url (Optional[str]): The URL of the Neo4j database server.
+    username (Optional[str]): The username for database authentication.
+    password (Optional[str]): The password for database authentication.
+    database (str): The name of the database to connect to. Default is 'neo4j'.
+    timeout (Optional[float]): The timeout for transactions in seconds.
+            Useful for terminating long-running queries.
+            By default, there is no timeout set.
+    sanitize (bool): A flag to indicate whether to remove lists with
+            more than 128 elements from results. Useful for removing
+            embedding-like properties from database responses. Default is False.
+    refresh_schema (bool): A flag whether to refresh schema information
+            at initialization. Default is True.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(
+        self,
+        url: Optional[str] = None,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        database: Optional[str] = None,
+        timeout: Optional[float] = None,
+        sanitize: bool = False,
+        refresh_schema: bool = True,
+    ) -> None:
+        """Create a new Neo4j graph wrapper instance."""
+        try:
+            import neo4j
+        except ImportError:
+            raise ValueError(
+                "Could not import neo4j python package. "
+                "Please install it with `pip install neo4j`."
+            )
+
+        url = get_from_dict_or_env({"url": url}, "url", "NEO4J_URI")
+        username = get_from_dict_or_env(
+            {"username": username}, "username", "NEO4J_USERNAME"
+        )
+        password = get_from_dict_or_env(
+            {"password": password}, "password", "NEO4J_PASSWORD"
+        )
+        database = get_from_dict_or_env(
+            {"database": database}, "database", "NEO4J_DATABASE", "neo4j"
+        )
+
+        self._driver = neo4j.GraphDatabase.driver(url, auth=(username, password))
+        self._database = database
+        self.timeout = timeout
+        self.sanitize = sanitize
+        self.schema: str = ""
+        self.structured_schema: Dict[str, Any] = {}
+        # Verify connection
+        try:
+            self._driver.verify_connectivity()
+        except neo4j.exceptions.ServiceUnavailable:
+            raise ValueError(
+                "Could not connect to Neo4j database. "
+                "Please ensure that the url is correct"
+            )
+        except neo4j.exceptions.AuthError:
+            raise ValueError(
+                "Could not connect to Neo4j database. "
+                "Please ensure that the username and password are correct"
+            )
+        # Set schema
+        if refresh_schema:
+            try:
+                self.refresh_schema()
+            except neo4j.exceptions.ClientError as e:
+                if e.code == "Neo.ClientError.Procedure.ProcedureNotFound":
+                    raise ValueError(
+                        "Could not use APOC procedures. "
+                        "Please ensure the APOC plugin is installed in Neo4j and that "
+                        "'apoc.meta.data()' is allowed in Neo4j configuration "
+                    )
+                raise e
+
+    @property
+    def get_schema(self) -> str:
+        """Returns the schema of the Graph"""
+        return self.schema
+
+    @property
+    def get_structured_schema(self) -> Dict[str, Any]:
+        """Returns the structured schema of the Graph"""
+        return self.structured_schema
+
+    def query(self, query: str, params: dict = {}) -> List[Dict[str, Any]]:
+        """Query Neo4j database."""
+        from neo4j import Query
+        from neo4j.exceptions import CypherSyntaxError
+
+        with self._driver.session(database=self._database) as session:
+            try:
+                data = session.run(Query(text=query, timeout=self.timeout), params)
+                json_data = [r.data() for r in data]
+                if self.sanitize:
+                    json_data = [value_sanitize(el) for el in json_data]
+                return json_data
+            except CypherSyntaxError as e:
+                raise ValueError(f"Generated Cypher Statement is not valid\n{e}")
+
+    def refresh_schema(self) -> None:
+        """
+        Refreshes the Neo4j graph schema information.
+        """
+        from neo4j.exceptions import ClientError
+
+        node_properties = [
+            el["output"]
+            for el in self.query(
+                node_properties_query,
+                params={"EXCLUDED_LABELS": EXCLUDED_LABELS + [BASE_ENTITY_LABEL]},
+            )
+        ]
+        rel_properties = [
+            el["output"]
+            for el in self.query(
+                rel_properties_query, params={"EXCLUDED_LABELS": EXCLUDED_RELS}
+            )
+        ]
+        relationships = [
+            el["output"]
+            for el in self.query(
+                rel_query,
+                params={"EXCLUDED_LABELS": EXCLUDED_LABELS + [BASE_ENTITY_LABEL]},
+            )
+        ]
+
+        # Get constraints & indexes
+        try:
+            constraint = self.query("SHOW CONSTRAINTS")
+            index = self.query("SHOW INDEXES YIELD *")
+        except (
+            ClientError
+        ):  # Read-only user might not have access to schema information
+            constraint = []
+            index = []
+
+        self.structured_schema = {
+            "node_props": {el["labels"]: el["properties"] for el in node_properties},
+            "rel_props": {el["type"]: el["properties"] for el in rel_properties},
+            "relationships": relationships,
+            "metadata": {"constraint": constraint, "index": index},
+        }
+
+        # Format node properties
+        formatted_node_props = []
+        for el in node_properties:
+            props_str = ", ".join(
+                [f"{prop['property']}: {prop['type']}" for prop in el["properties"]]
+            )
+            formatted_node_props.append(f"{el['labels']} {{{props_str}}}")
+
+        # Format relationship properties
+        formatted_rel_props = []
+        for el in rel_properties:
+            props_str = ", ".join(
+                [f"{prop['property']}: {prop['type']}" for prop in el["properties"]]
+            )
+            formatted_rel_props.append(f"{el['type']} {{{props_str}}}")
+
+        # Format relationships
+        formatted_rels = [
+            f"(:{el['start']})-[:{el['type']}]->(:{el['end']})" for el in relationships
+        ]
+
+        self.schema = "\n".join(
+            [
+                "Node properties are the following:",
+                ",".join(formatted_node_props),
+                "Relationship properties are the following:",
+                ",".join(formatted_rel_props),
+                "The relationships are the following:",
+                ",".join(formatted_rels),
+            ]
+        )
+
+    def add_graph_documents(
+        self,
+        graph_documents: List[GraphDocument],
+        include_source: bool = False,
+        baseEntityLabel: bool = False,
+    ) -> None:
+        """
+        This method constructs nodes and relationships in the graph based on the
+        provided GraphDocument objects.
+
+        Parameters:
+        - graph_documents (List[GraphDocument]): A list of GraphDocument objects
+        that contain the nodes and relationships to be added to the graph. Each
+        GraphDocument should encapsulate the structure of part of the graph,
+        including nodes, relationships, and the source document information.
+        - include_source (bool, optional): If True, stores the source document
+        and links it to nodes in the graph using the MENTIONS relationship.
+        This is useful for tracing back the origin of data. Merges source
+        documents based on the `id` property from the source document metadata
+        if available; otherwise it calculates the MD5 hash of `page_content`
+        for merging process. Defaults to False.
+        - baseEntityLabel (bool, optional): If True, each newly created node
+        gets a secondary __Entity__ label, which is indexed and improves import
+        speed and performance. Defaults to False.
+        """
+        if baseEntityLabel:  # Check if constraint already exists
+            constraint_exists = any(
+                [
+                    el["labelsOrTypes"] == [BASE_ENTITY_LABEL]
+                    and el["properties"] == ["id"]
+                    for el in self.structured_schema.get("metadata", {}).get(
+                        "constraint"
+                    )
+                ]
+            )
+            if not constraint_exists:
+                # Create constraint
+                self.query(
+                    f"CREATE CONSTRAINT IF NOT EXISTS FOR (b:{BASE_ENTITY_LABEL}) "
+                    "REQUIRE b.id IS UNIQUE;"
+                )
+                self.refresh_schema()  # Refresh constraint information
+
+        node_import_query = _get_node_import_query(baseEntityLabel, include_source)
+        rel_import_query = _get_rel_import_query(baseEntityLabel)
+        for document in graph_documents:
+            if not document.source.metadata.get("id"):
+                document.source.metadata["id"] = md5(
+                    document.source.page_content.encode("utf-8")
+                ).hexdigest()
+
+            # Import nodes
+            self.query(
+                node_import_query,
+                {
+                    "data": [el.__dict__ for el in document.nodes],
+                    "document": document.source.__dict__,
+                },
+            )
+            # Import relationships
+            self.query(
+                rel_import_query,
+                {
+                    "data": [
+                        {
+                            "source": el.source.id,
+                            "source_label": el.source.type,
+                            "target": el.target.id,
+                            "target_label": el.target.type,
+                            "type": el.type.replace(" ", "_").upper(),
+                            "properties": el.properties,
+                        }
+                        for el in document.relationships
+                    ]
+                },
+            )
diff --git a/llm/Lib/site-packages/langchain_community/graphs/neptune_graph.py b/llm/Lib/site-packages/langchain_community/graphs/neptune_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..f7566ecffe2b79d7a0c2fed3e252c069f0b40be0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/neptune_graph.py
@@ -0,0 +1,413 @@
+import json
+from abc import ABC, abstractmethod
+from typing import Any, Dict, List, Optional, Tuple, Union
+
+
+class NeptuneQueryException(Exception):
+    """Exception for the Neptune queries."""
+
+    def __init__(self, exception: Union[str, Dict]):
+        if isinstance(exception, dict):
+            self.message = exception["message"] if "message" in exception else "unknown"
+            self.details = exception["details"] if "details" in exception else "unknown"
+        else:
+            self.message = exception
+            self.details = "unknown"
+
+    def get_message(self) -> str:
+        return self.message
+
+    def get_details(self) -> Any:
+        return self.details
+
+
+class BaseNeptuneGraph(ABC):
+    @property
+    def get_schema(self) -> str:
+        """Returns the schema of the Neptune database"""
+        return self.schema
+
+    @abstractmethod
+    def query(self, query: str, params: dict = {}) -> dict:
+        raise NotImplementedError()
+
+    @abstractmethod
+    def _get_summary(self) -> Dict:
+        raise NotImplementedError()
+
+    def _get_labels(self) -> Tuple[List[str], List[str]]:
+        """Get node and edge labels from the Neptune statistics summary"""
+        summary = self._get_summary()
+        n_labels = summary["nodeLabels"]
+        e_labels = summary["edgeLabels"]
+        return n_labels, e_labels
+
+    def _get_triples(self, e_labels: List[str]) -> List[str]:
+        triple_query = """
+        MATCH (a)-[e:`{e_label}`]->(b)
+        WITH a,e,b LIMIT 3000
+        RETURN DISTINCT labels(a) AS from, type(e) AS edge, labels(b) AS to
+        LIMIT 10
+        """
+
+        triple_template = "(:`{a}`)-[:`{e}`]->(:`{b}`)"
+        triple_schema = []
+        for label in e_labels:
+            q = triple_query.format(e_label=label)
+            data = self.query(q)
+            for d in data:
+                triple = triple_template.format(
+                    a=d["from"][0], e=d["edge"], b=d["to"][0]
+                )
+                triple_schema.append(triple)
+
+        return triple_schema
+
+    def _get_node_properties(self, n_labels: List[str], types: Dict) -> List:
+        node_properties_query = """
+        MATCH (a:`{n_label}`)
+        RETURN properties(a) AS props
+        LIMIT 100
+        """
+        node_properties = []
+        for label in n_labels:
+            q = node_properties_query.format(n_label=label)
+            data = {"label": label, "properties": self.query(q)}
+            s = set({})
+            for p in data["properties"]:
+                for k, v in p["props"].items():
+                    s.add((k, types[type(v).__name__]))
+
+            np = {
+                "properties": [{"property": k, "type": v} for k, v in s],
+                "labels": label,
+            }
+            node_properties.append(np)
+
+        return node_properties
+
+    def _get_edge_properties(self, e_labels: List[str], types: Dict[str, Any]) -> List:
+        edge_properties_query = """
+        MATCH ()-[e:`{e_label}`]->()
+        RETURN properties(e) AS props
+        LIMIT 100
+        """
+        edge_properties = []
+        for label in e_labels:
+            q = edge_properties_query.format(e_label=label)
+            data = {"label": label, "properties": self.query(q)}
+            s = set({})
+            for p in data["properties"]:
+                for k, v in p["props"].items():
+                    s.add((k, types[type(v).__name__]))
+
+            ep = {
+                "type": label,
+                "properties": [{"property": k, "type": v} for k, v in s],
+            }
+            edge_properties.append(ep)
+
+        return edge_properties
+
+    def _refresh_schema(self) -> None:
+        """
+        Refreshes the Neptune graph schema information.
+        """
+
+        types = {
+            "str": "STRING",
+            "float": "DOUBLE",
+            "int": "INTEGER",
+            "list": "LIST",
+            "dict": "MAP",
+            "bool": "BOOLEAN",
+        }
+        n_labels, e_labels = self._get_labels()
+        triple_schema = self._get_triples(e_labels)
+        node_properties = self._get_node_properties(n_labels, types)
+        edge_properties = self._get_edge_properties(e_labels, types)
+
+        self.schema = f"""
+        Node properties are the following:
+        {node_properties}
+        Relationship properties are the following:
+        {edge_properties}
+        The relationships are the following:
+        {triple_schema}
+        """
+
+
+class NeptuneAnalyticsGraph(BaseNeptuneGraph):
+    """Neptune Analytics wrapper for graph operations.
+
+    Args:
+        client: optional boto3 Neptune client
+        credentials_profile_name: optional AWS profile name
+        region_name: optional AWS region, e.g., us-west-2
+        graph_identifier: the graph identifier for a Neptune Analytics graph
+
+    Example:
+        .. code-block:: python
+
+        graph = NeptuneAnalyticsGraph(
+            graph_identifier='<my-graph-id>'
+        )
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(
+        self,
+        graph_identifier: str,
+        client: Any = None,
+        credentials_profile_name: Optional[str] = None,
+        region_name: Optional[str] = None,
+    ) -> None:
+        """Create a new Neptune Analytics graph wrapper instance."""
+
+        try:
+            if client is not None:
+                self.client = client
+            else:
+                import boto3
+
+                if credentials_profile_name is not None:
+                    session = boto3.Session(profile_name=credentials_profile_name)
+                else:
+                    # use default credentials
+                    session = boto3.Session()
+
+                self.graph_identifier = graph_identifier
+
+                if region_name:
+                    self.client = session.client(
+                        "neptune-graph", region_name=region_name
+                    )
+                else:
+                    self.client = session.client("neptune-graph")
+
+        except ImportError:
+            raise ModuleNotFoundError(
+                "Could not import boto3 python package. "
+                "Please install it with `pip install boto3`."
+            )
+        except Exception as e:
+            if type(e).__name__ == "UnknownServiceError":
+                raise ModuleNotFoundError(
+                    "NeptuneGraph requires a boto3 version 1.34.40 or greater."
+                    "Please install it with `pip install -U boto3`."
+                ) from e
+            else:
+                raise ValueError(
+                    "Could not load credentials to authenticate with AWS client. "
+                    "Please check that credentials in the specified "
+                    "profile name are valid."
+                ) from e
+
+        try:
+            self._refresh_schema()
+        except Exception as e:
+            raise NeptuneQueryException(
+                {
+                    "message": "Could not get schema for Neptune database",
+                    "detail": str(e),
+                }
+            )
+
+    def query(self, query: str, params: dict = {}) -> Dict[str, Any]:
+        """Query Neptune database."""
+        try:
+            resp = self.client.execute_query(
+                graphIdentifier=self.graph_identifier,
+                queryString=query,
+                parameters=params,
+                language="OPEN_CYPHER",
+            )
+            return json.loads(resp["payload"].read().decode("UTF-8"))["results"]
+        except Exception as e:
+            raise NeptuneQueryException(
+                {
+                    "message": "An error occurred while executing the query.",
+                    "details": str(e),
+                }
+            )
+
+    def _get_summary(self) -> Dict:
+        try:
+            response = self.client.get_graph_summary(
+                graphIdentifier=self.graph_identifier, mode="detailed"
+            )
+        except Exception as e:
+            raise NeptuneQueryException(
+                {
+                    "message": ("Summary API error occurred on Neptune Analytics"),
+                    "details": str(e),
+                }
+            )
+
+        try:
+            summary = response["graphSummary"]
+        except Exception:
+            raise NeptuneQueryException(
+                {
+                    "message": "Summary API did not return a valid response.",
+                    "details": response.content.decode(),
+                }
+            )
+        else:
+            return summary
+
+
+class NeptuneGraph(BaseNeptuneGraph):
+    """Neptune wrapper for graph operations.
+
+    Args:
+        host: endpoint for the database instance
+        port: port number for the database instance, default is 8182
+        use_https: whether to use secure connection, default is True
+        client: optional boto3 Neptune client
+        credentials_profile_name: optional AWS profile name
+        region_name: optional AWS region, e.g., us-west-2
+        service: optional service name, default is neptunedata
+        sign: optional, whether to sign the request payload, default is True
+
+    Example:
+        .. code-block:: python
+
+        graph = NeptuneGraph(
+            host='<my-cluster>',
+            port=8182
+        )
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(
+        self,
+        host: str,
+        port: int = 8182,
+        use_https: bool = True,
+        client: Any = None,
+        credentials_profile_name: Optional[str] = None,
+        region_name: Optional[str] = None,
+        sign: bool = True,
+    ) -> None:
+        """Create a new Neptune graph wrapper instance."""
+
+        try:
+            if client is not None:
+                self.client = client
+            else:
+                import boto3
+
+                if credentials_profile_name is not None:
+                    session = boto3.Session(profile_name=credentials_profile_name)
+                else:
+                    # use default credentials
+                    session = boto3.Session()
+
+                client_params = {}
+                if region_name:
+                    client_params["region_name"] = region_name
+
+                protocol = "https" if use_https else "http"
+
+                client_params["endpoint_url"] = f"{protocol}://{host}:{port}"
+
+                if sign:
+                    self.client = session.client("neptunedata", **client_params)
+                else:
+                    from botocore import UNSIGNED
+                    from botocore.config import Config
+
+                    self.client = session.client(
+                        "neptunedata",
+                        **client_params,
+                        config=Config(signature_version=UNSIGNED),
+                    )
+
+        except ImportError:
+            raise ModuleNotFoundError(
+                "Could not import boto3 python package. "
+                "Please install it with `pip install boto3`."
+            )
+        except Exception as e:
+            if type(e).__name__ == "UnknownServiceError":
+                raise ModuleNotFoundError(
+                    "NeptuneGraph requires a boto3 version 1.28.38 or greater."
+                    "Please install it with `pip install -U boto3`."
+                ) from e
+            else:
+                raise ValueError(
+                    "Could not load credentials to authenticate with AWS client. "
+                    "Please check that credentials in the specified "
+                    "profile name are valid."
+                ) from e
+
+        try:
+            self._refresh_schema()
+        except Exception as e:
+            raise NeptuneQueryException(
+                {
+                    "message": "Could not get schema for Neptune database",
+                    "detail": str(e),
+                }
+            )
+
+    def query(self, query: str, params: dict = {}) -> Dict[str, Any]:
+        """Query Neptune database."""
+        try:
+            return self.client.execute_open_cypher_query(openCypherQuery=query)[
+                "results"
+            ]
+        except Exception as e:
+            raise NeptuneQueryException(
+                {
+                    "message": "An error occurred while executing the query.",
+                    "details": str(e),
+                }
+            )
+
+    def _get_summary(self) -> Dict:
+        try:
+            response = self.client.get_propertygraph_summary()
+        except Exception as e:
+            raise NeptuneQueryException(
+                {
+                    "message": (
+                        "Summary API is not available for this instance of Neptune,"
+                        "ensure the engine version is >=1.2.1.0"
+                    ),
+                    "details": str(e),
+                }
+            )
+
+        try:
+            summary = response["payload"]["graphSummary"]
+        except Exception:
+            raise NeptuneQueryException(
+                {
+                    "message": "Summary API did not return a valid response.",
+                    "details": response.content.decode(),
+                }
+            )
+        else:
+            return summary
diff --git a/llm/Lib/site-packages/langchain_community/graphs/neptune_rdf_graph.py b/llm/Lib/site-packages/langchain_community/graphs/neptune_rdf_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..92a0093989b3eeb3f8976e858f5198c5d5fc14bd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/neptune_rdf_graph.py
@@ -0,0 +1,296 @@
+import json
+from types import SimpleNamespace
+from typing import Any, Dict, Optional, Sequence
+
+import requests
+
+# Query to find OWL datatype properties
+DTPROP_QUERY = """
+SELECT DISTINCT ?elem 
+WHERE { 
+ ?elem a owl:DatatypeProperty . 
+}
+"""
+
+# Query to find OWL object properties
+OPROP_QUERY = """
+SELECT DISTINCT ?elem 
+WHERE { 
+ ?elem a owl:ObjectProperty . 
+}
+"""
+
+ELEM_TYPES = {
+    "classes": None,
+    "rels": None,
+    "dtprops": DTPROP_QUERY,
+    "oprops": OPROP_QUERY,
+}
+
+
+class NeptuneRdfGraph:
+    """Neptune wrapper for RDF graph operations.
+
+    Args:
+        host: endpoint for the database instance
+        port: port number for the database instance, default is 8182
+        use_iam_auth: boolean indicating IAM auth is enabled in Neptune cluster
+        use_https: whether to use secure connection, default is True
+        client: optional boto3 Neptune client
+        credentials_profile_name: optional AWS profile name
+        region_name: optional AWS region, e.g., us-west-2
+        service: optional service name, default is neptunedata
+        sign: optional, whether to sign the request payload, default is True
+
+    Example:
+        .. code-block:: python
+
+        graph = NeptuneRdfGraph(
+            host='<SPARQL host'>,
+            port=<SPARQL port>
+        )
+        schema = graph.get_schema()
+
+        OR
+        graph = NeptuneRdfGraph(
+            host='<SPARQL host'>,
+            port=<SPARQL port>
+        )
+        schema_elem = graph.get_schema_elements()
+        #... change schema_elements ...
+        graph.load_schema(schema_elem)
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(
+        self,
+        host: str,
+        port: int = 8182,
+        use_https: bool = True,
+        use_iam_auth: bool = False,
+        client: Any = None,
+        credentials_profile_name: Optional[str] = None,
+        region_name: Optional[str] = None,
+        service: str = "neptunedata",
+        sign: bool = True,
+    ) -> None:
+        self.use_iam_auth = use_iam_auth
+        self.region_name = region_name
+        self.query_endpoint = f"https://{host}:{port}/sparql"
+
+        try:
+            if client is not None:
+                self.client = client
+            else:
+                import boto3
+
+                if credentials_profile_name is not None:
+                    self.session = boto3.Session(profile_name=credentials_profile_name)
+                else:
+                    # use default credentials
+                    self.session = boto3.Session()
+
+                client_params = {}
+                if region_name:
+                    client_params["region_name"] = region_name
+
+                protocol = "https" if use_https else "http"
+
+                client_params["endpoint_url"] = f"{protocol}://{host}:{port}"
+
+                if sign:
+                    self.client = self.session.client(service, **client_params)
+                else:
+                    from botocore import UNSIGNED
+                    from botocore.config import Config
+
+                    self.client = self.session.client(
+                        service,
+                        **client_params,
+                        config=Config(signature_version=UNSIGNED),
+                    )
+
+        except ImportError:
+            raise ModuleNotFoundError(
+                "Could not import boto3 python package. "
+                "Please install it with `pip install boto3`."
+            )
+        except Exception as e:
+            if type(e).__name__ == "UnknownServiceError":
+                raise ModuleNotFoundError(
+                    "NeptuneGraph requires a boto3 version 1.28.38 or greater."
+                    "Please install it with `pip install -U boto3`."
+                ) from e
+            else:
+                raise ValueError(
+                    "Could not load credentials to authenticate with AWS client. "
+                    "Please check that credentials in the specified "
+                    "profile name are valid."
+                ) from e
+
+        # Set schema
+        self.schema = ""
+        self.schema_elements: Dict[str, Any] = {}
+        self._refresh_schema()
+
+    @property
+    def get_schema(self) -> str:
+        """
+        Returns the schema of the graph database.
+        """
+        return self.schema
+
+    @property
+    def get_schema_elements(self) -> Dict[str, Any]:
+        return self.schema_elements
+
+    def get_summary(self) -> Dict[str, Any]:
+        """
+        Obtain Neptune statistical summary of classes and predicates in the graph.
+        """
+        return self.client.get_rdf_graph_summary(mode="detailed")
+
+    def query(
+        self,
+        query: str,
+    ) -> Dict[str, Any]:
+        """
+        Run Neptune query.
+        """
+        request_data = {"query": query}
+        data = request_data
+        request_hdr = None
+
+        if self.use_iam_auth:
+            credentials = self.session.get_credentials()
+            credentials = credentials.get_frozen_credentials()
+            access_key = credentials.access_key
+            secret_key = credentials.secret_key
+            service = "neptune-db"
+            session_token = credentials.token
+            params = None
+            creds = SimpleNamespace(
+                access_key=access_key,
+                secret_key=secret_key,
+                token=session_token,
+                region=self.region_name,
+            )
+            from botocore.awsrequest import AWSRequest
+
+            request = AWSRequest(
+                method="POST", url=self.query_endpoint, data=data, params=params
+            )
+            from botocore.auth import SigV4Auth
+
+            SigV4Auth(creds, service, self.region_name).add_auth(request)
+            request.headers["Content-Type"] = "application/x-www-form-urlencoded"
+            request_hdr = request.headers
+        else:
+            request_hdr = {}
+            request_hdr["Content-Type"] = "application/x-www-form-urlencoded"
+
+        queryres = requests.request(
+            method="POST", url=self.query_endpoint, headers=request_hdr, data=data
+        )
+        json_resp = json.loads(queryres.text)
+        return json_resp
+
+    def load_schema(self, schema_elements: Dict[str, Any]) -> None:
+        """
+        Generates and sets schema from schema_elements. Helpful in
+        cases where introspected schema needs pruning.
+        """
+
+        elem_str = {}
+        for elem in ELEM_TYPES:
+            res_list = []
+            for elem_rec in schema_elements[elem]:
+                uri = elem_rec["uri"]
+                local = elem_rec["local"]
+                res_str = f"<{uri}> ({local})"
+                res_list.append(res_str)
+            elem_str[elem] = ", ".join(res_list)
+
+        self.schema = (
+            "In the following, each IRI is followed by the local name and "
+            "optionally its description in parentheses. \n"
+            "The graph supports the following node types:\n"
+            f"{elem_str['classes']}\n"
+            "The graph supports the following relationships:\n"
+            f"{elem_str['rels']}\n"
+            "The graph supports the following OWL object properties:\n"
+            f"{elem_str['dtprops']}\n"
+            "The graph supports the following OWL data properties:\n"
+            f"{elem_str['oprops']}"
+        )
+
+    def _get_local_name(self, iri: str) -> Sequence[str]:
+        """
+        Split IRI into prefix and local
+        """
+        if "#" in iri:
+            tokens = iri.split("#")
+            return [f"{tokens[0]}#", tokens[-1]]
+        elif "/" in iri:
+            tokens = iri.split("/")
+            return [f"{'/'.join(tokens[0:len(tokens)-1])}/", tokens[-1]]
+        else:
+            raise ValueError(f"Unexpected IRI '{iri}', contains neither '#' nor '/'.")
+
+    def _refresh_schema(self) -> None:
+        """
+        Query Neptune to introspect schema.
+        """
+        self.schema_elements["distinct_prefixes"] = {}
+
+        # get summary and build list of classes and rels
+        summary = self.get_summary()
+        reslist = []
+        for c in summary["payload"]["graphSummary"]["classes"]:
+            uri = c
+            tokens = self._get_local_name(uri)
+            elem_record = {"uri": uri, "local": tokens[1]}
+            reslist.append(elem_record)
+            if tokens[0] not in self.schema_elements["distinct_prefixes"]:
+                self.schema_elements["distinct_prefixes"][tokens[0]] = "y"
+        self.schema_elements["classes"] = reslist
+
+        reslist = []
+        for r in summary["payload"]["graphSummary"]["predicates"]:
+            for p in r:
+                uri = p
+                tokens = self._get_local_name(uri)
+                elem_record = {"uri": uri, "local": tokens[1]}
+                reslist.append(elem_record)
+                if tokens[0] not in self.schema_elements["distinct_prefixes"]:
+                    self.schema_elements["distinct_prefixes"][tokens[0]] = "y"
+        self.schema_elements["rels"] = reslist
+
+        # get dtprops and oprops too
+        for elem in ELEM_TYPES:
+            q = ELEM_TYPES.get(elem)
+            if not q:
+                continue
+            items = self.query(q)
+            reslist = []
+            for r in items["results"]["bindings"]:
+                uri = r["elem"]["value"]
+                tokens = self._get_local_name(uri)
+                elem_record = {"uri": uri, "local": tokens[1]}
+                reslist.append(elem_record)
+                if tokens[0] not in self.schema_elements["distinct_prefixes"]:
+                    self.schema_elements["distinct_prefixes"][tokens[0]] = "y"
+
+            self.schema_elements[elem] = reslist
+
+        self.load_schema(self.schema_elements)
diff --git a/llm/Lib/site-packages/langchain_community/graphs/networkx_graph.py b/llm/Lib/site-packages/langchain_community/graphs/networkx_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..59c264798605eb91a31d30fff57c86da0f286799
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/networkx_graph.py
@@ -0,0 +1,217 @@
+"""Networkx wrapper for graph operations."""
+from __future__ import annotations
+
+from typing import Any, List, NamedTuple, Optional, Tuple
+
+KG_TRIPLE_DELIMITER = "<|>"
+
+
+class KnowledgeTriple(NamedTuple):
+    """Knowledge triple in the graph."""
+
+    subject: str
+    predicate: str
+    object_: str
+
+    @classmethod
+    def from_string(cls, triple_string: str) -> "KnowledgeTriple":
+        """Create a KnowledgeTriple from a string."""
+        subject, predicate, object_ = triple_string.strip().split(", ")
+        subject = subject[1:]
+        object_ = object_[:-1]
+        return cls(subject, predicate, object_)
+
+
+def parse_triples(knowledge_str: str) -> List[KnowledgeTriple]:
+    """Parse knowledge triples from the knowledge string."""
+    knowledge_str = knowledge_str.strip()
+    if not knowledge_str or knowledge_str == "NONE":
+        return []
+    triple_strs = knowledge_str.split(KG_TRIPLE_DELIMITER)
+    results = []
+    for triple_str in triple_strs:
+        try:
+            kg_triple = KnowledgeTriple.from_string(triple_str)
+        except ValueError:
+            continue
+        results.append(kg_triple)
+    return results
+
+
+def get_entities(entity_str: str) -> List[str]:
+    """Extract entities from entity string."""
+    if entity_str.strip() == "NONE":
+        return []
+    else:
+        return [w.strip() for w in entity_str.split(",")]
+
+
+class NetworkxEntityGraph:
+    """Networkx wrapper for entity graph operations.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(self, graph: Optional[Any] = None) -> None:
+        """Create a new graph."""
+        try:
+            import networkx as nx
+        except ImportError:
+            raise ImportError(
+                "Could not import networkx python package. "
+                "Please install it with `pip install networkx`."
+            )
+        if graph is not None:
+            if not isinstance(graph, nx.DiGraph):
+                raise ValueError("Passed in graph is not of correct shape")
+            self._graph = graph
+        else:
+            self._graph = nx.DiGraph()
+
+    @classmethod
+    def from_gml(cls, gml_path: str) -> NetworkxEntityGraph:
+        try:
+            import networkx as nx
+        except ImportError:
+            raise ImportError(
+                "Could not import networkx python package. "
+                "Please install it with `pip install networkx`."
+            )
+        graph = nx.read_gml(gml_path)
+        return cls(graph)
+
+    def add_triple(self, knowledge_triple: KnowledgeTriple) -> None:
+        """Add a triple to the graph."""
+        # Creates nodes if they don't exist
+        # Overwrites existing edges
+        if not self._graph.has_node(knowledge_triple.subject):
+            self._graph.add_node(knowledge_triple.subject)
+        if not self._graph.has_node(knowledge_triple.object_):
+            self._graph.add_node(knowledge_triple.object_)
+        self._graph.add_edge(
+            knowledge_triple.subject,
+            knowledge_triple.object_,
+            relation=knowledge_triple.predicate,
+        )
+
+    def delete_triple(self, knowledge_triple: KnowledgeTriple) -> None:
+        """Delete a triple from the graph."""
+        if self._graph.has_edge(knowledge_triple.subject, knowledge_triple.object_):
+            self._graph.remove_edge(knowledge_triple.subject, knowledge_triple.object_)
+
+    def get_triples(self) -> List[Tuple[str, str, str]]:
+        """Get all triples in the graph."""
+        return [(u, v, d["relation"]) for u, v, d in self._graph.edges(data=True)]
+
+    def get_entity_knowledge(self, entity: str, depth: int = 1) -> List[str]:
+        """Get information about an entity."""
+        import networkx as nx
+
+        # TODO: Have more information-specific retrieval methods
+        if not self._graph.has_node(entity):
+            return []
+
+        results = []
+        for src, sink in nx.dfs_edges(self._graph, entity, depth_limit=depth):
+            relation = self._graph[src][sink]["relation"]
+            results.append(f"{src} {relation} {sink}")
+        return results
+
+    def write_to_gml(self, path: str) -> None:
+        import networkx as nx
+
+        nx.write_gml(self._graph, path)
+
+    def clear(self) -> None:
+        """Clear the graph."""
+        self._graph.clear()
+
+    def clear_edges(self) -> None:
+        """Clear the graph edges."""
+        self._graph.clear_edges()
+
+    def add_node(self, node: str) -> None:
+        """Add node in the graph."""
+        self._graph.add_node(node)
+
+    def remove_node(self, node: str) -> None:
+        """Remove node from the graph."""
+        if self._graph.has_node(node):
+            self._graph.remove_node(node)
+
+    def has_node(self, node: str) -> bool:
+        """Return if graph has the given node."""
+        return self._graph.has_node(node)
+
+    def remove_edge(self, source_node: str, destination_node: str) -> None:
+        """Remove edge from the graph."""
+        self._graph.remove_edge(source_node, destination_node)
+
+    def has_edge(self, source_node: str, destination_node: str) -> bool:
+        """Return if graph has an edge between the given nodes."""
+        if self._graph.has_node(source_node) and self._graph.has_node(destination_node):
+            return self._graph.has_edge(source_node, destination_node)
+        else:
+            return False
+
+    def get_neighbors(self, node: str) -> List[str]:
+        """Return the neighbor nodes of the given node."""
+        return self._graph.neighbors(node)
+
+    def get_number_of_nodes(self) -> int:
+        """Get number of nodes in the graph."""
+        return self._graph.number_of_nodes()
+
+    def get_topological_sort(self) -> List[str]:
+        """Get a list of entity names in the graph sorted by causal dependence."""
+        import networkx as nx
+
+        return list(nx.topological_sort(self._graph))
+
+    def draw_graphviz(self, **kwargs: Any) -> None:
+        """
+        Provides better drawing
+
+        Usage in a jupyter notebook:
+
+            >>> from IPython.display import SVG
+            >>> self.draw_graphviz_svg(layout="dot", filename="web.svg")
+            >>> SVG('web.svg')
+        """
+        from networkx.drawing.nx_agraph import to_agraph
+
+        try:
+            import pygraphviz  # noqa: F401
+
+        except ImportError as e:
+            if e.name == "_graphviz":
+                """
+                >>> e.msg  # pygraphviz throws this error
+                ImportError: libcgraph.so.6: cannot open shared object file
+                """
+                raise ImportError(
+                    "Could not import graphviz debian package. "
+                    "Please install it with:"
+                    "`sudo apt-get update`"
+                    "`sudo apt-get install graphviz graphviz-dev`"
+                )
+            else:
+                raise ImportError(
+                    "Could not import pygraphviz python package. "
+                    "Please install it with:"
+                    "`pip install pygraphviz`."
+                )
+
+        graph = to_agraph(self._graph)  # --> pygraphviz.agraph.AGraph
+        # pygraphviz.github.io/documentation/stable/tutorial.html#layout-and-drawing
+        graph.layout(prog=kwargs.get("prog", "dot"))
+        graph.draw(kwargs.get("path", "graph.svg"))
diff --git a/llm/Lib/site-packages/langchain_community/graphs/ontotext_graphdb_graph.py b/llm/Lib/site-packages/langchain_community/graphs/ontotext_graphdb_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..8bc30492d6dfa0d0595a71f3a8bc5166b7f21f07
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/ontotext_graphdb_graph.py
@@ -0,0 +1,210 @@
+from __future__ import annotations
+
+import os
+from typing import (
+    TYPE_CHECKING,
+    List,
+    Optional,
+    Union,
+)
+
+if TYPE_CHECKING:
+    import rdflib
+
+
+class OntotextGraphDBGraph:
+    """Ontotext GraphDB https://graphdb.ontotext.com/ wrapper for graph operations.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(
+        self,
+        query_endpoint: str,
+        query_ontology: Optional[str] = None,
+        local_file: Optional[str] = None,
+        local_file_format: Optional[str] = None,
+    ) -> None:
+        """
+        Set up the GraphDB wrapper
+
+        :param query_endpoint: SPARQL endpoint for queries, read access
+
+        If GraphDB is secured,
+        set the environment variables 'GRAPHDB_USERNAME' and 'GRAPHDB_PASSWORD'.
+
+        :param query_ontology: a `CONSTRUCT` query that is executed
+        on the SPARQL endpoint and returns the KG schema statements
+        Example:
+        'CONSTRUCT {?s ?p ?o} FROM <https://example.com/ontology/> WHERE {?s ?p ?o}'
+        Currently, DESCRIBE queries like
+        'PREFIX onto: <https://example.com/ontology/>
+        PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
+        DESCRIBE ?term WHERE {
+            ?term rdfs:isDefinedBy onto:
+        }'
+        are not supported, because DESCRIBE returns
+        the Symmetric Concise Bounded Description (SCBD),
+        i.e. also the incoming class links.
+        In case of large graphs with a million of instances, this is not efficient.
+        Check https://github.com/eclipse-rdf4j/rdf4j/issues/4857
+
+        :param local_file: a local RDF ontology file.
+        Supported RDF formats:
+        Turtle, RDF/XML, JSON-LD, N-Triples, Notation-3, Trig, Trix, N-Quads.
+        If the rdf format can't be determined from the file extension,
+        pass explicitly the rdf format in `local_file_format` param.
+
+        :param local_file_format: Used if the rdf format can't be determined
+        from the local file extension.
+        One of "json-ld", "xml", "n3", "turtle", "nt", "trig", "nquads", "trix"
+
+        Either `query_ontology` or `local_file` should be passed.
+        """
+
+        if query_ontology and local_file:
+            raise ValueError("Both file and query provided. Only one is allowed.")
+
+        if not query_ontology and not local_file:
+            raise ValueError("Neither file nor query provided. One is required.")
+
+        try:
+            import rdflib
+            from rdflib.plugins.stores import sparqlstore
+        except ImportError:
+            raise ValueError(
+                "Could not import rdflib python package. "
+                "Please install it with `pip install rdflib`."
+            )
+
+        auth = self._get_auth()
+        store = sparqlstore.SPARQLStore(auth=auth)
+        store.open(query_endpoint)
+
+        self.graph = rdflib.Graph(store, identifier=None, bind_namespaces="none")
+        self._check_connectivity()
+
+        if local_file:
+            ontology_schema_graph = self._load_ontology_schema_from_file(
+                local_file,
+                local_file_format,  # type: ignore[arg-type]
+            )
+        else:
+            self._validate_user_query(query_ontology)  # type: ignore[arg-type]
+            ontology_schema_graph = self._load_ontology_schema_with_query(
+                query_ontology  # type: ignore[arg-type]
+            )
+        self.schema = ontology_schema_graph.serialize(format="turtle")
+
+    @staticmethod
+    def _get_auth() -> Union[tuple, None]:
+        """
+        Returns the basic authentication configuration
+        """
+        username = os.environ.get("GRAPHDB_USERNAME", None)
+        password = os.environ.get("GRAPHDB_PASSWORD", None)
+
+        if username:
+            if not password:
+                raise ValueError(
+                    "Environment variable 'GRAPHDB_USERNAME' is set, "
+                    "but 'GRAPHDB_PASSWORD' is not set."
+                )
+            else:
+                return username, password
+        return None
+
+    def _check_connectivity(self) -> None:
+        """
+        Executes a simple `ASK` query to check connectivity
+        """
+        try:
+            self.graph.query("ASK { ?s ?p ?o }")
+        except ValueError:
+            raise ValueError(
+                "Could not query the provided endpoint. "
+                "Please, check, if the value of the provided "
+                "query_endpoint points to the right repository. "
+                "If GraphDB is secured, please, "
+                "make sure that the environment variables "
+                "'GRAPHDB_USERNAME' and 'GRAPHDB_PASSWORD' are set."
+            )
+
+    @staticmethod
+    def _load_ontology_schema_from_file(local_file: str, local_file_format: str = None):  # type: ignore[no-untyped-def, assignment]
+        """
+        Parse the ontology schema statements from the provided file
+        """
+        import rdflib
+
+        if not os.path.exists(local_file):
+            raise FileNotFoundError(f"File {local_file} does not exist.")
+        if not os.access(local_file, os.R_OK):
+            raise PermissionError(f"Read permission for {local_file} is restricted")
+        graph = rdflib.ConjunctiveGraph()
+        try:
+            graph.parse(local_file, format=local_file_format)
+        except Exception as e:
+            raise ValueError(f"Invalid file format for {local_file} : ", e)
+        return graph
+
+    @staticmethod
+    def _validate_user_query(query_ontology: str) -> None:
+        """
+        Validate the query is a valid SPARQL CONSTRUCT query
+        """
+        from pyparsing import ParseException
+        from rdflib.plugins.sparql import prepareQuery
+
+        if not isinstance(query_ontology, str):
+            raise TypeError("Ontology query must be provided as string.")
+        try:
+            parsed_query = prepareQuery(query_ontology)
+        except ParseException as e:
+            raise ValueError("Ontology query is not a valid SPARQL query.", e)
+
+        if parsed_query.algebra.name != "ConstructQuery":
+            raise ValueError(
+                "Invalid query type. Only CONSTRUCT queries are supported."
+            )
+
+    def _load_ontology_schema_with_query(self, query: str):  # type: ignore[no-untyped-def]
+        """
+        Execute the query for collecting the ontology schema statements
+        """
+        from rdflib.exceptions import ParserError
+
+        try:
+            results = self.graph.query(query)
+        except ParserError as e:
+            raise ValueError(f"Generated SPARQL statement is invalid\n{e}")
+
+        return results.graph
+
+    @property
+    def get_schema(self) -> str:
+        """
+        Returns the schema of the graph database in turtle format
+        """
+        return self.schema
+
+    def query(
+        self,
+        query: str,
+    ) -> List[rdflib.query.ResultRow]:
+        """
+        Query the graph.
+        """
+        from rdflib.query import ResultRow
+
+        res = self.graph.query(query)
+        return [r for r in res if isinstance(r, ResultRow)]
diff --git a/llm/Lib/site-packages/langchain_community/graphs/rdf_graph.py b/llm/Lib/site-packages/langchain_community/graphs/rdf_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1061cc697d9f5e1d203bcef14dc5e168ae25b91
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/rdf_graph.py
@@ -0,0 +1,302 @@
+from __future__ import annotations
+
+from typing import (
+    TYPE_CHECKING,
+    Dict,
+    List,
+    Optional,
+)
+
+if TYPE_CHECKING:
+    import rdflib
+
+prefixes = {
+    "owl": """PREFIX owl: <http://www.w3.org/2002/07/owl#>\n""",
+    "rdf": """PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>\n""",
+    "rdfs": """PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>\n""",
+    "xsd": """PREFIX xsd: <http://www.w3.org/2001/XMLSchema#>\n""",
+}
+
+cls_query_rdf = prefixes["rdfs"] + (
+    """SELECT DISTINCT ?cls ?com\n"""
+    """WHERE { \n"""
+    """    ?instance a ?cls . \n"""
+    """    OPTIONAL { ?cls rdfs:comment ?com } \n"""
+    """}"""
+)
+
+cls_query_rdfs = prefixes["rdfs"] + (
+    """SELECT DISTINCT ?cls ?com\n"""
+    """WHERE { \n"""
+    """    ?instance a/rdfs:subClassOf* ?cls . \n"""
+    """    OPTIONAL { ?cls rdfs:comment ?com } \n"""
+    """}"""
+)
+
+cls_query_owl = prefixes["rdfs"] + (
+    """SELECT DISTINCT ?cls ?com\n"""
+    """WHERE { \n"""
+    """    ?instance a/rdfs:subClassOf* ?cls . \n"""
+    """    FILTER (isIRI(?cls)) . \n"""
+    """    OPTIONAL { ?cls rdfs:comment ?com } \n"""
+    """}"""
+)
+
+rel_query_rdf = prefixes["rdfs"] + (
+    """SELECT DISTINCT ?rel ?com\n"""
+    """WHERE { \n"""
+    """    ?subj ?rel ?obj . \n"""
+    """    OPTIONAL { ?rel rdfs:comment ?com } \n"""
+    """}"""
+)
+
+rel_query_rdfs = (
+    prefixes["rdf"]
+    + prefixes["rdfs"]
+    + (
+        """SELECT DISTINCT ?rel ?com\n"""
+        """WHERE { \n"""
+        """    ?rel a/rdfs:subPropertyOf* rdf:Property . \n"""
+        """    OPTIONAL { ?rel rdfs:comment ?com } \n"""
+        """}"""
+    )
+)
+
+op_query_owl = (
+    prefixes["rdfs"]
+    + prefixes["owl"]
+    + (
+        """SELECT DISTINCT ?op ?com\n"""
+        """WHERE { \n"""
+        """    ?op a/rdfs:subPropertyOf* owl:ObjectProperty . \n"""
+        """    OPTIONAL { ?op rdfs:comment ?com } \n"""
+        """}"""
+    )
+)
+
+dp_query_owl = (
+    prefixes["rdfs"]
+    + prefixes["owl"]
+    + (
+        """SELECT DISTINCT ?dp ?com\n"""
+        """WHERE { \n"""
+        """    ?dp a/rdfs:subPropertyOf* owl:DatatypeProperty . \n"""
+        """    OPTIONAL { ?dp rdfs:comment ?com } \n"""
+        """}"""
+    )
+)
+
+
+class RdfGraph:
+    """RDFlib wrapper for graph operations.
+
+    Modes:
+    * local: Local file - can be queried and changed
+    * online: Online file - can only be queried, changes can be stored locally
+    * store: Triple store - can be queried and changed if update_endpoint available
+    Together with a source file, the serialization should be specified.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(
+        self,
+        source_file: Optional[str] = None,
+        serialization: Optional[str] = "ttl",
+        query_endpoint: Optional[str] = None,
+        update_endpoint: Optional[str] = None,
+        standard: Optional[str] = "rdf",
+        local_copy: Optional[str] = None,
+        graph_kwargs: Optional[Dict] = None,
+    ) -> None:
+        """
+        Set up the RDFlib graph
+
+        :param source_file: either a path for a local file or a URL
+        :param serialization: serialization of the input
+        :param query_endpoint: SPARQL endpoint for queries, read access
+        :param update_endpoint: SPARQL endpoint for UPDATE queries, write access
+        :param standard: RDF, RDFS, or OWL
+        :param local_copy: new local copy for storing changes
+        :param graph_kwargs: Additional rdflib.Graph specific kwargs
+        that will be used to initialize it,
+        if query_endpoint is provided.
+        """
+        self.source_file = source_file
+        self.serialization = serialization
+        self.query_endpoint = query_endpoint
+        self.update_endpoint = update_endpoint
+        self.standard = standard
+        self.local_copy = local_copy
+
+        try:
+            import rdflib
+            from rdflib.plugins.stores import sparqlstore
+        except ImportError:
+            raise ValueError(
+                "Could not import rdflib python package. "
+                "Please install it with `pip install rdflib`."
+            )
+        if self.standard not in (supported_standards := ("rdf", "rdfs", "owl")):
+            raise ValueError(
+                f"Invalid standard. Supported standards are: {supported_standards}."
+            )
+
+        if (
+            not source_file
+            and not query_endpoint
+            or source_file
+            and (query_endpoint or update_endpoint)
+        ):
+            raise ValueError(
+                "Could not unambiguously initialize the graph wrapper. "
+                "Specify either a file (local or online) via the source_file "
+                "or a triple store via the endpoints."
+            )
+
+        if source_file:
+            if source_file.startswith("http"):
+                self.mode = "online"
+            else:
+                self.mode = "local"
+                if self.local_copy is None:
+                    self.local_copy = self.source_file
+            self.graph = rdflib.Graph()
+            self.graph.parse(source_file, format=self.serialization)
+
+        if query_endpoint:
+            self.mode = "store"
+            if not update_endpoint:
+                self._store = sparqlstore.SPARQLStore()
+                self._store.open(query_endpoint)
+            else:
+                self._store = sparqlstore.SPARQLUpdateStore()
+                self._store.open((query_endpoint, update_endpoint))
+            graph_kwargs = graph_kwargs or {}
+            self.graph = rdflib.Graph(self._store, **graph_kwargs)
+
+        # Verify that the graph was loaded
+        if not len(self.graph):
+            raise AssertionError("The graph is empty.")
+
+        # Set schema
+        self.schema = ""
+        self.load_schema()
+
+    @property
+    def get_schema(self) -> str:
+        """
+        Returns the schema of the graph database.
+        """
+        return self.schema
+
+    def query(
+        self,
+        query: str,
+    ) -> List[rdflib.query.ResultRow]:
+        """
+        Query the graph.
+        """
+        from rdflib.exceptions import ParserError
+        from rdflib.query import ResultRow
+
+        try:
+            res = self.graph.query(query)
+        except ParserError as e:
+            raise ValueError("Generated SPARQL statement is invalid\n" f"{e}")
+        return [r for r in res if isinstance(r, ResultRow)]
+
+    def update(
+        self,
+        query: str,
+    ) -> None:
+        """
+        Update the graph.
+        """
+        from rdflib.exceptions import ParserError
+
+        try:
+            self.graph.update(query)
+        except ParserError as e:
+            raise ValueError("Generated SPARQL statement is invalid\n" f"{e}")
+        if self.local_copy:
+            self.graph.serialize(
+                destination=self.local_copy, format=self.local_copy.split(".")[-1]
+            )
+        else:
+            raise ValueError("No target file specified for saving the updated file.")
+
+    @staticmethod
+    def _get_local_name(iri: str) -> str:
+        if "#" in iri:
+            local_name = iri.split("#")[-1]
+        elif "/" in iri:
+            local_name = iri.split("/")[-1]
+        else:
+            raise ValueError(f"Unexpected IRI '{iri}', contains neither '#' nor '/'.")
+        return local_name
+
+    def _res_to_str(self, res: rdflib.query.ResultRow, var: str) -> str:
+        return (
+            "<"
+            + str(res[var])
+            + "> ("
+            + self._get_local_name(res[var])
+            + ", "
+            + str(res["com"])
+            + ")"
+        )
+
+    def load_schema(self) -> None:
+        """
+        Load the graph schema information.
+        """
+
+        def _rdf_s_schema(
+            classes: List[rdflib.query.ResultRow],
+            relationships: List[rdflib.query.ResultRow],
+        ) -> str:
+            return (
+                f"In the following, each IRI is followed by the local name and "
+                f"optionally its description in parentheses. \n"
+                f"The RDF graph supports the following node types:\n"
+                f'{", ".join([self._res_to_str(r, "cls") for r in classes])}\n'
+                f"The RDF graph supports the following relationships:\n"
+                f'{", ".join([self._res_to_str(r, "rel") for r in relationships])}\n'
+            )
+
+        if self.standard == "rdf":
+            clss = self.query(cls_query_rdf)
+            rels = self.query(rel_query_rdf)
+            self.schema = _rdf_s_schema(clss, rels)
+        elif self.standard == "rdfs":
+            clss = self.query(cls_query_rdfs)
+            rels = self.query(rel_query_rdfs)
+            self.schema = _rdf_s_schema(clss, rels)
+        elif self.standard == "owl":
+            clss = self.query(cls_query_owl)
+            ops = self.query(op_query_owl)
+            dps = self.query(dp_query_owl)
+            self.schema = (
+                f"In the following, each IRI is followed by the local name and "
+                f"optionally its description in parentheses. \n"
+                f"The OWL graph supports the following node types:\n"
+                f'{", ".join([self._res_to_str(r, "cls") for r in clss])}\n'
+                f"The OWL graph supports the following object properties, "
+                f"i.e., relationships between objects:\n"
+                f'{", ".join([self._res_to_str(r, "op") for r in ops])}\n'
+                f"The OWL graph supports the following data properties, "
+                f"i.e., relationships between objects and literals:\n"
+                f'{", ".join([self._res_to_str(r, "dp") for r in dps])}\n'
+            )
+        else:
+            raise ValueError(f"Mode '{self.standard}' is currently not supported.")
diff --git a/llm/Lib/site-packages/langchain_community/graphs/tigergraph_graph.py b/llm/Lib/site-packages/langchain_community/graphs/tigergraph_graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..f32d43e6e5e2cdfa2fe1276b0edb7f29f999c806
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/graphs/tigergraph_graph.py
@@ -0,0 +1,94 @@
+from typing import Any, Dict, List, Optional
+
+from langchain_community.graphs.graph_store import GraphStore
+
+
+class TigerGraph(GraphStore):
+    """TigerGraph wrapper for graph operations.
+
+    *Security note*: Make sure that the database connection uses credentials
+        that are narrowly-scoped to only include necessary permissions.
+        Failure to do so may result in data corruption or loss, since the calling
+        code may attempt commands that would result in deletion, mutation
+        of data if appropriately prompted or reading sensitive data if such
+        data is present in the database.
+        The best way to guard against such negative outcomes is to (as appropriate)
+        limit the permissions granted to the credentials used with this tool.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    def __init__(self, conn: Any) -> None:
+        """Create a new TigerGraph graph wrapper instance."""
+        self.set_connection(conn)
+        self.set_schema()
+
+    @property
+    def conn(self) -> Any:
+        return self._conn
+
+    @property
+    def schema(self) -> Dict[str, Any]:
+        return self._schema
+
+    def get_schema(self) -> str:  # type: ignore[override]
+        if self._schema:
+            return str(self._schema)
+        else:
+            self.set_schema()
+            return str(self._schema)
+
+    def set_connection(self, conn: Any) -> None:
+        from pyTigerGraph import TigerGraphConnection
+
+        if not isinstance(conn, TigerGraphConnection):
+            msg = "**conn** parameter must inherit from TigerGraphConnection"
+            raise TypeError(msg)
+
+        if conn.ai.nlqs_host is None:
+            msg = """**conn** parameter does not have nlqs_host parameter defined.
+                     Define hostname of NLQS service."""
+            raise ConnectionError(msg)
+
+        self._conn: TigerGraphConnection = conn
+        self.set_schema()
+
+    def set_schema(self, schema: Optional[Dict[str, Any]] = None) -> None:
+        """
+        Set the schema of the TigerGraph Database.
+        Auto-generates Schema if **schema** is None.
+        """
+        self._schema = self.generate_schema() if schema is None else schema
+
+    def generate_schema(
+        self,
+    ) -> Dict[str, List[Dict[str, Any]]]:
+        """
+        Generates the schema of the TigerGraph Database and returns it
+        User can specify a **sample_ratio** (0 to 1) to determine the
+        ratio of documents/edges used (in relation to the Collection size)
+        to render each Collection Schema.
+        """
+        return self._conn.getSchema(force=True)
+
+    def refresh_schema(self):  # type: ignore[no-untyped-def]
+        self.generate_schema()
+
+    def query(self, query: str) -> Dict[str, Any]:  # type: ignore[override]
+        """Query the TigerGraph database."""
+        answer = self._conn.ai.query(query)
+        return answer
+
+    def register_query(
+        self,
+        function_header: str,
+        description: str,
+        docstring: str,
+        param_types: dict = {},
+    ) -> List[str]:
+        """
+        Wrapper function to register a custom GSQL query to the TigerGraph NLQS.
+        """
+        return self._conn.ai.registerCustomQuery(
+            function_header, description, docstring, param_types
+        )
diff --git a/llm/Lib/site-packages/langchain_community/indexes/__init__.py b/llm/Lib/site-packages/langchain_community/indexes/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2810a0989971cad480cb8fd68a3843c12abbe30c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/indexes/__init__.py
@@ -0,0 +1,13 @@
+"""**Index** is used to avoid writing duplicated content
+into the vectostore and to avoid over-writing content if it's unchanged.
+
+Indexes also :
+
+* Create knowledge graphs from data.
+
+* Support indexing workflows from LangChain data loaders to vectorstores.
+
+Importantly, Index keeps on working even if the content being written is derived
+via a set of transformations from some source content (e.g., indexing children
+documents that were derived from parent documents by chunking.)
+"""
diff --git a/llm/Lib/site-packages/langchain_community/indexes/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/indexes/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d487c13ae91ad30976eb1f3b1d8fa4a4054ed7bb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/indexes/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/indexes/__pycache__/_document_manager.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/indexes/__pycache__/_document_manager.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..61c4285a28acd13d386b960c62341ef9cd02c1f3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/indexes/__pycache__/_document_manager.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/indexes/__pycache__/_sql_record_manager.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/indexes/__pycache__/_sql_record_manager.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9a8e1e9977132d1cc8c08f76df07ae0d7814d97c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/indexes/__pycache__/_sql_record_manager.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/indexes/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/indexes/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..00db914c0e9fea01887223eaf096e8f1291e4c4c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/indexes/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/indexes/_document_manager.py b/llm/Lib/site-packages/langchain_community/indexes/_document_manager.py
new file mode 100644
index 0000000000000000000000000000000000000000..64fbe1b94616e73c7da70eda1172d566f561a589
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/indexes/_document_manager.py
@@ -0,0 +1,231 @@
+from typing import Any, Dict, List, Optional, Sequence
+
+from langchain_community.indexes.base import RecordManager
+
+IMPORT_PYMONGO_ERROR = (
+    "Could not import MongoClient. Please install it with `pip install pymongo`."
+)
+IMPORT_MOTOR_ASYNCIO_ERROR = (
+    "Could not import AsyncIOMotorClient. Please install it with `pip install motor`."
+)
+
+
+def _import_pymongo() -> Any:
+    """Import PyMongo if available, otherwise raise error."""
+    try:
+        from pymongo import MongoClient
+    except ImportError:
+        raise ImportError(IMPORT_PYMONGO_ERROR)
+    return MongoClient
+
+
+def _get_pymongo_client(mongodb_url: str, **kwargs: Any) -> Any:
+    """Get MongoClient for sync operations from the mongodb_url,
+    otherwise raise error."""
+    try:
+        pymongo = _import_pymongo()
+        client = pymongo(mongodb_url, **kwargs)
+    except ValueError as e:
+        raise ImportError(
+            f"MongoClient string provided is not in proper format. " f"Got error: {e} "
+        )
+    return client
+
+
+def _import_motor_asyncio() -> Any:
+    """Import Motor if available, otherwise raise error."""
+    try:
+        from motor.motor_asyncio import AsyncIOMotorClient
+    except ImportError:
+        raise ImportError(IMPORT_MOTOR_ASYNCIO_ERROR)
+    return AsyncIOMotorClient
+
+
+def _get_motor_client(mongodb_url: str, **kwargs: Any) -> Any:
+    """Get AsyncIOMotorClient for async operations from the mongodb_url,
+    otherwise raise error."""
+    try:
+        motor = _import_motor_asyncio()
+        client = motor(mongodb_url, **kwargs)
+    except ValueError as e:
+        raise ImportError(
+            f"AsyncIOMotorClient string provided is not in proper format. "
+            f"Got error: {e} "
+        )
+    return client
+
+
+class MongoDocumentManager(RecordManager):
+    """A MongoDB based implementation of the document manager."""
+
+    def __init__(
+        self,
+        namespace: str,
+        *,
+        mongodb_url: str,
+        db_name: str,
+        collection_name: str = "documentMetadata",
+    ) -> None:
+        """Initialize the MongoDocumentManager.
+
+        Args:
+            namespace: The namespace associated with this document manager.
+            db_name: The name of the database to use.
+            collection_name: The name of the collection to use.
+                Default is 'documentMetadata'.
+        """
+        super().__init__(namespace=namespace)
+        self.sync_client = _get_pymongo_client(mongodb_url)
+        self.sync_db = self.sync_client[db_name]
+        self.sync_collection = self.sync_db[collection_name]
+        self.async_client = _get_motor_client(mongodb_url)
+        self.async_db = self.async_client[db_name]
+        self.async_collection = self.async_db[collection_name]
+
+    def create_schema(self) -> None:
+        """Create the database schema for the document manager."""
+        pass
+
+    async def acreate_schema(self) -> None:
+        """Create the database schema for the document manager."""
+        pass
+
+    def update(
+        self,
+        keys: Sequence[str],
+        *,
+        group_ids: Optional[Sequence[Optional[str]]] = None,
+        time_at_least: Optional[float] = None,
+    ) -> None:
+        """Upsert documents into the MongoDB collection."""
+        if group_ids is None:
+            group_ids = [None] * len(keys)
+
+        if len(keys) != len(group_ids):
+            raise ValueError("Number of keys does not match number of group_ids")
+
+        for key, group_id in zip(keys, group_ids):
+            self.sync_collection.find_one_and_update(
+                {"namespace": self.namespace, "key": key},
+                {"$set": {"group_id": group_id, "updated_at": self.get_time()}},
+                upsert=True,
+            )
+
+    async def aupdate(
+        self,
+        keys: Sequence[str],
+        *,
+        group_ids: Optional[Sequence[Optional[str]]] = None,
+        time_at_least: Optional[float] = None,
+    ) -> None:
+        """Asynchronously upsert documents into the MongoDB collection."""
+        if group_ids is None:
+            group_ids = [None] * len(keys)
+
+        if len(keys) != len(group_ids):
+            raise ValueError("Number of keys does not match number of group_ids")
+
+        update_time = await self.aget_time()
+        if time_at_least and update_time < time_at_least:
+            raise ValueError("Server time is behind the expected time_at_least")
+
+        for key, group_id in zip(keys, group_ids):
+            await self.async_collection.find_one_and_update(
+                {"namespace": self.namespace, "key": key},
+                {"$set": {"group_id": group_id, "updated_at": update_time}},
+                upsert=True,
+            )
+
+    def get_time(self) -> float:
+        """Get the current server time as a timestamp."""
+        server_info = self.sync_db.command("hostInfo")
+        local_time = server_info["system"]["currentTime"]
+        timestamp = local_time.timestamp()
+        return timestamp
+
+    async def aget_time(self) -> float:
+        """Asynchronously get the current server time as a timestamp."""
+        host_info = await self.async_collection.database.command("hostInfo")
+        local_time = host_info["system"]["currentTime"]
+        return local_time.timestamp()
+
+    def exists(self, keys: Sequence[str]) -> List[bool]:
+        """Check if the given keys exist in the MongoDB collection."""
+        existing_keys = {
+            doc["key"]
+            for doc in self.sync_collection.find(
+                {"namespace": self.namespace, "key": {"$in": keys}}, {"key": 1}
+            )
+        }
+        return [key in existing_keys for key in keys]
+
+    async def aexists(self, keys: Sequence[str]) -> List[bool]:
+        """Asynchronously check if the given keys exist in the MongoDB collection."""
+        cursor = self.async_collection.find(
+            {"namespace": self.namespace, "key": {"$in": keys}}, {"key": 1}
+        )
+        existing_keys = {doc["key"] async for doc in cursor}
+        return [key in existing_keys for key in keys]
+
+    def list_keys(
+        self,
+        *,
+        before: Optional[float] = None,
+        after: Optional[float] = None,
+        group_ids: Optional[Sequence[str]] = None,
+        limit: Optional[int] = None,
+    ) -> List[str]:
+        """List documents in the MongoDB collection based on the provided date range."""
+        query: Dict[str, Any] = {"namespace": self.namespace}
+        if before:
+            query["updated_at"] = {"$lt": before}
+        if after:
+            query["updated_at"] = {"$gt": after}
+        if group_ids:
+            query["group_id"] = {"$in": group_ids}
+
+        cursor = (
+            self.sync_collection.find(query, {"key": 1}).limit(limit)
+            if limit
+            else self.sync_collection.find(query, {"key": 1})
+        )
+        return [doc["key"] for doc in cursor]
+
+    async def alist_keys(
+        self,
+        *,
+        before: Optional[float] = None,
+        after: Optional[float] = None,
+        group_ids: Optional[Sequence[str]] = None,
+        limit: Optional[int] = None,
+    ) -> List[str]:
+        """
+        Asynchronously list documents in the MongoDB collection
+        based on the provided date range.
+        """
+        query: Dict[str, Any] = {"namespace": self.namespace}
+        if before:
+            query["updated_at"] = {"$lt": before}
+        if after:
+            query["updated_at"] = {"$gt": after}
+        if group_ids:
+            query["group_id"] = {"$in": group_ids}
+
+        cursor = (
+            self.async_collection.find(query, {"key": 1}).limit(limit)
+            if limit
+            else self.async_collection.find(query, {"key": 1})
+        )
+        return [doc["key"] async for doc in cursor]
+
+    def delete_keys(self, keys: Sequence[str]) -> None:
+        """Delete documents from the MongoDB collection."""
+        self.sync_collection.delete_many(
+            {"namespace": self.namespace, "key": {"$in": keys}}
+        )
+
+    async def adelete_keys(self, keys: Sequence[str]) -> None:
+        """Asynchronously delete documents from the MongoDB collection."""
+        await self.async_collection.delete_many(
+            {"namespace": self.namespace, "key": {"$in": keys}}
+        )
diff --git a/llm/Lib/site-packages/langchain_community/indexes/_sql_record_manager.py b/llm/Lib/site-packages/langchain_community/indexes/_sql_record_manager.py
new file mode 100644
index 0000000000000000000000000000000000000000..544e828df2a826a1c8ee180a0f26bfc7963d0972
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/indexes/_sql_record_manager.py
@@ -0,0 +1,522 @@
+"""Implementation of a record management layer in SQLAlchemy.
+
+The management layer uses SQLAlchemy to track upserted records.
+
+Currently, this layer only works with SQLite; hopwever, should be adaptable
+to other SQL implementations with minimal effort.
+
+Currently, includes an implementation that uses SQLAlchemy which should
+allow it to work with a variety of SQL as a backend.
+
+* Each key is associated with an updated_at field.
+* This filed is updated whenever the key is updated.
+* Keys can be listed based on the updated at field.
+* Keys can be deleted.
+"""
+import contextlib
+import decimal
+import uuid
+from typing import Any, AsyncGenerator, Dict, Generator, List, Optional, Sequence, Union
+
+from sqlalchemy import (
+    URL,
+    Column,
+    Engine,
+    Float,
+    Index,
+    String,
+    UniqueConstraint,
+    and_,
+    create_engine,
+    delete,
+    select,
+    text,
+)
+from sqlalchemy.ext.asyncio import (
+    AsyncEngine,
+    AsyncSession,
+    async_sessionmaker,
+    create_async_engine,
+)
+from sqlalchemy.ext.declarative import declarative_base
+from sqlalchemy.orm import Session, sessionmaker
+
+from langchain_community.indexes.base import RecordManager
+
+Base = declarative_base()
+
+
+class UpsertionRecord(Base):  # type: ignore[valid-type,misc]
+    """Table used to keep track of when a key was last updated."""
+
+    # ATTENTION:
+    # Prior to modifying this table, please determine whether
+    # we should create migrations for this table to make sure
+    # users do not experience data loss.
+    __tablename__ = "upsertion_record"
+
+    uuid = Column(
+        String,
+        index=True,
+        default=lambda: str(uuid.uuid4()),
+        primary_key=True,
+        nullable=False,
+    )
+    key = Column(String, index=True)
+    # Using a non-normalized representation to handle `namespace` attribute.
+    # If the need arises, this attribute can be pulled into a separate Collection
+    # table at some time later.
+    namespace = Column(String, index=True, nullable=False)
+    group_id = Column(String, index=True, nullable=True)
+
+    # The timestamp associated with the last record upsertion.
+    updated_at = Column(Float, index=True)
+
+    __table_args__ = (
+        UniqueConstraint("key", "namespace", name="uix_key_namespace"),
+        Index("ix_key_namespace", "key", "namespace"),
+    )
+
+
+class SQLRecordManager(RecordManager):
+    """A SQL Alchemy based implementation of the record manager."""
+
+    def __init__(
+        self,
+        namespace: str,
+        *,
+        engine: Optional[Union[Engine, AsyncEngine]] = None,
+        db_url: Union[None, str, URL] = None,
+        engine_kwargs: Optional[Dict[str, Any]] = None,
+        async_mode: bool = False,
+    ) -> None:
+        """Initialize the SQLRecordManager.
+
+        This class serves as a manager persistence layer that uses an SQL
+        backend to track upserted records. You should specify either a db_url
+        to create an engine or provide an existing engine.
+
+        Args:
+            namespace: The namespace associated with this record manager.
+            engine: An already existing SQL Alchemy engine.
+                Default is None.
+            db_url: A database connection string used to create
+                an SQL Alchemy engine. Default is None.
+            engine_kwargs: Additional keyword arguments
+                to be passed when creating the engine. Default is an empty dictionary.
+            async_mode: Whether to create an async engine.
+                Driver should support async operations.
+                It only applies if db_url is provided.
+                Default is False.
+
+        Raises:
+            ValueError: If both db_url and engine are provided or neither.
+            AssertionError: If something unexpected happens during engine configuration.
+        """
+        super().__init__(namespace=namespace)
+        if db_url is None and engine is None:
+            raise ValueError("Must specify either db_url or engine")
+
+        if db_url is not None and engine is not None:
+            raise ValueError("Must specify either db_url or engine, not both")
+
+        _engine: Union[Engine, AsyncEngine]
+        if db_url:
+            if async_mode:
+                _engine = create_async_engine(db_url, **(engine_kwargs or {}))
+            else:
+                _engine = create_engine(db_url, **(engine_kwargs or {}))
+        elif engine:
+            _engine = engine
+
+        else:
+            raise AssertionError("Something went wrong with configuration of engine.")
+
+        _session_factory: Union[sessionmaker[Session], async_sessionmaker[AsyncSession]]
+        if isinstance(_engine, AsyncEngine):
+            _session_factory = async_sessionmaker(bind=_engine)
+        else:
+            _session_factory = sessionmaker(bind=_engine)
+
+        self.engine = _engine
+        self.dialect = _engine.dialect.name
+        self.session_factory = _session_factory
+
+    def create_schema(self) -> None:
+        """Create the database schema."""
+        if isinstance(self.engine, AsyncEngine):
+            raise AssertionError("This method is not supported for async engines.")
+
+        Base.metadata.create_all(self.engine)
+
+    async def acreate_schema(self) -> None:
+        """Create the database schema."""
+
+        if not isinstance(self.engine, AsyncEngine):
+            raise AssertionError("This method is not supported for sync engines.")
+
+        async with self.engine.begin() as session:
+            await session.run_sync(Base.metadata.create_all)
+
+    @contextlib.contextmanager
+    def _make_session(self) -> Generator[Session, None, None]:
+        """Create a session and close it after use."""
+
+        if isinstance(self.session_factory, async_sessionmaker):
+            raise AssertionError("This method is not supported for async engines.")
+
+        session = self.session_factory()
+        try:
+            yield session
+        finally:
+            session.close()
+
+    @contextlib.asynccontextmanager
+    async def _amake_session(self) -> AsyncGenerator[AsyncSession, None]:
+        """Create a session and close it after use."""
+
+        if not isinstance(self.session_factory, async_sessionmaker):
+            raise AssertionError("This method is not supported for sync engines.")
+
+        async with self.session_factory() as session:
+            yield session
+
+    def get_time(self) -> float:
+        """Get the current server time as a timestamp.
+
+        Please note it's critical that time is obtained from the server since
+        we want a monotonic clock.
+        """
+        with self._make_session() as session:
+            # * SQLite specific implementation, can be changed based on dialect.
+            # * For SQLite, unlike unixepoch it will work with older versions of SQLite.
+            # ----
+            # julianday('now'): Julian day number for the current date and time.
+            # The Julian day is a continuous count of days, starting from a
+            # reference date (Julian day number 0).
+            # 2440587.5 - constant represents the Julian day number for January 1, 1970
+            # 86400.0 - constant represents the number of seconds
+            # in a day (24 hours * 60 minutes * 60 seconds)
+            if self.dialect == "sqlite":
+                query = text("SELECT (julianday('now') - 2440587.5) * 86400.0;")
+            elif self.dialect == "postgresql":
+                query = text("SELECT EXTRACT (EPOCH FROM CURRENT_TIMESTAMP);")
+            else:
+                raise NotImplementedError(f"Not implemented for dialect {self.dialect}")
+
+            dt = session.execute(query).scalar()
+            if isinstance(dt, decimal.Decimal):
+                dt = float(dt)
+            if not isinstance(dt, float):
+                raise AssertionError(f"Unexpected type for datetime: {type(dt)}")
+            return dt
+
+    async def aget_time(self) -> float:
+        """Get the current server time as a timestamp.
+
+        Please note it's critical that time is obtained from the server since
+        we want a monotonic clock.
+        """
+        async with self._amake_session() as session:
+            # * SQLite specific implementation, can be changed based on dialect.
+            # * For SQLite, unlike unixepoch it will work with older versions of SQLite.
+            # ----
+            # julianday('now'): Julian day number for the current date and time.
+            # The Julian day is a continuous count of days, starting from a
+            # reference date (Julian day number 0).
+            # 2440587.5 - constant represents the Julian day number for January 1, 1970
+            # 86400.0 - constant represents the number of seconds
+            # in a day (24 hours * 60 minutes * 60 seconds)
+            if self.dialect == "sqlite":
+                query = text("SELECT (julianday('now') - 2440587.5) * 86400.0;")
+            elif self.dialect == "postgresql":
+                query = text("SELECT EXTRACT (EPOCH FROM CURRENT_TIMESTAMP);")
+            else:
+                raise NotImplementedError(f"Not implemented for dialect {self.dialect}")
+
+            dt = (await session.execute(query)).scalar_one_or_none()
+
+            if isinstance(dt, decimal.Decimal):
+                dt = float(dt)
+            if not isinstance(dt, float):
+                raise AssertionError(f"Unexpected type for datetime: {type(dt)}")
+            return dt
+
+    def update(
+        self,
+        keys: Sequence[str],
+        *,
+        group_ids: Optional[Sequence[Optional[str]]] = None,
+        time_at_least: Optional[float] = None,
+    ) -> None:
+        """Upsert records into the SQLite database."""
+        if group_ids is None:
+            group_ids = [None] * len(keys)
+
+        if len(keys) != len(group_ids):
+            raise ValueError(
+                f"Number of keys ({len(keys)}) does not match number of "
+                f"group_ids ({len(group_ids)})"
+            )
+
+        # Get the current time from the server.
+        # This makes an extra round trip to the server, should not be a big deal
+        # if the batch size is large enough.
+        # Getting the time here helps us compare it against the time_at_least
+        # and raise an error if there is a time sync issue.
+        # Here, we're just being extra careful to minimize the chance of
+        # data loss due to incorrectly deleting records.
+        update_time = self.get_time()
+
+        if time_at_least and update_time < time_at_least:
+            # Safeguard against time sync issues
+            raise AssertionError(f"Time sync issue: {update_time} < {time_at_least}")
+
+        records_to_upsert = [
+            {
+                "key": key,
+                "namespace": self.namespace,
+                "updated_at": update_time,
+                "group_id": group_id,
+            }
+            for key, group_id in zip(keys, group_ids)
+        ]
+
+        with self._make_session() as session:
+            if self.dialect == "sqlite":
+                from sqlalchemy.dialects.sqlite import insert as sqlite_insert
+
+                # Note: uses SQLite insert to make on_conflict_do_update work.
+                # This code needs to be generalized a bit to work with more dialects.
+                insert_stmt = sqlite_insert(UpsertionRecord).values(records_to_upsert)
+                stmt = insert_stmt.on_conflict_do_update(  # type: ignore[attr-defined]
+                    [UpsertionRecord.key, UpsertionRecord.namespace],
+                    set_=dict(
+                        # attr-defined type ignore
+                        updated_at=insert_stmt.excluded.updated_at,  # type: ignore
+                        group_id=insert_stmt.excluded.group_id,  # type: ignore
+                    ),
+                )
+            elif self.dialect == "postgresql":
+                from sqlalchemy.dialects.postgresql import insert as pg_insert
+
+                # Note: uses SQLite insert to make on_conflict_do_update work.
+                # This code needs to be generalized a bit to work with more dialects.
+                insert_stmt = pg_insert(UpsertionRecord).values(records_to_upsert)
+                stmt = insert_stmt.on_conflict_do_update(  # type: ignore[attr-defined]
+                    "uix_key_namespace",  # Name of constraint
+                    set_=dict(
+                        # attr-defined type ignore
+                        updated_at=insert_stmt.excluded.updated_at,  # type: ignore
+                        group_id=insert_stmt.excluded.group_id,  # type: ignore
+                    ),
+                )
+            else:
+                raise NotImplementedError(f"Unsupported dialect {self.dialect}")
+
+            session.execute(stmt)
+            session.commit()
+
+    async def aupdate(
+        self,
+        keys: Sequence[str],
+        *,
+        group_ids: Optional[Sequence[Optional[str]]] = None,
+        time_at_least: Optional[float] = None,
+    ) -> None:
+        """Upsert records into the SQLite database."""
+        if group_ids is None:
+            group_ids = [None] * len(keys)
+
+        if len(keys) != len(group_ids):
+            raise ValueError(
+                f"Number of keys ({len(keys)}) does not match number of "
+                f"group_ids ({len(group_ids)})"
+            )
+
+        # Get the current time from the server.
+        # This makes an extra round trip to the server, should not be a big deal
+        # if the batch size is large enough.
+        # Getting the time here helps us compare it against the time_at_least
+        # and raise an error if there is a time sync issue.
+        # Here, we're just being extra careful to minimize the chance of
+        # data loss due to incorrectly deleting records.
+        update_time = await self.aget_time()
+
+        if time_at_least and update_time < time_at_least:
+            # Safeguard against time sync issues
+            raise AssertionError(f"Time sync issue: {update_time} < {time_at_least}")
+
+        records_to_upsert = [
+            {
+                "key": key,
+                "namespace": self.namespace,
+                "updated_at": update_time,
+                "group_id": group_id,
+            }
+            for key, group_id in zip(keys, group_ids)
+        ]
+
+        async with self._amake_session() as session:
+            if self.dialect == "sqlite":
+                from sqlalchemy.dialects.sqlite import insert as sqlite_insert
+
+                # Note: uses SQLite insert to make on_conflict_do_update work.
+                # This code needs to be generalized a bit to work with more dialects.
+                insert_stmt = sqlite_insert(UpsertionRecord).values(records_to_upsert)
+                stmt = insert_stmt.on_conflict_do_update(  # type: ignore[attr-defined]
+                    [UpsertionRecord.key, UpsertionRecord.namespace],
+                    set_=dict(
+                        # attr-defined type ignore
+                        updated_at=insert_stmt.excluded.updated_at,  # type: ignore
+                        group_id=insert_stmt.excluded.group_id,  # type: ignore
+                    ),
+                )
+            elif self.dialect == "postgresql":
+                from sqlalchemy.dialects.postgresql import insert as pg_insert
+
+                # Note: uses SQLite insert to make on_conflict_do_update work.
+                # This code needs to be generalized a bit to work with more dialects.
+                insert_stmt = pg_insert(UpsertionRecord).values(records_to_upsert)
+                stmt = insert_stmt.on_conflict_do_update(  # type: ignore[attr-defined]
+                    "uix_key_namespace",  # Name of constraint
+                    set_=dict(
+                        # attr-defined type ignore
+                        updated_at=insert_stmt.excluded.updated_at,  # type: ignore
+                        group_id=insert_stmt.excluded.group_id,  # type: ignore
+                    ),
+                )
+            else:
+                raise NotImplementedError(f"Unsupported dialect {self.dialect}")
+
+            await session.execute(stmt)
+            await session.commit()
+
+    def exists(self, keys: Sequence[str]) -> List[bool]:
+        """Check if the given keys exist in the SQLite database."""
+        with self._make_session() as session:
+            records = (
+                # mypy does not recognize .all()
+                session.query(UpsertionRecord.key)  # type: ignore[attr-defined]
+                .filter(
+                    and_(
+                        UpsertionRecord.key.in_(keys),
+                        UpsertionRecord.namespace == self.namespace,
+                    )
+                )
+                .all()
+            )
+        found_keys = set(r.key for r in records)
+        return [k in found_keys for k in keys]
+
+    async def aexists(self, keys: Sequence[str]) -> List[bool]:
+        """Check if the given keys exist in the SQLite database."""
+        async with self._amake_session() as session:
+            records = (
+                (
+                    await session.execute(
+                        select(UpsertionRecord.key).where(
+                            and_(
+                                UpsertionRecord.key.in_(keys),
+                                UpsertionRecord.namespace == self.namespace,
+                            )
+                        )
+                    )
+                )
+                .scalars()
+                .all()
+            )
+        found_keys = set(records)
+        return [k in found_keys for k in keys]
+
+    def list_keys(
+        self,
+        *,
+        before: Optional[float] = None,
+        after: Optional[float] = None,
+        group_ids: Optional[Sequence[str]] = None,
+        limit: Optional[int] = None,
+    ) -> List[str]:
+        """List records in the SQLite database based on the provided date range."""
+        with self._make_session() as session:
+            query = session.query(UpsertionRecord).filter(
+                UpsertionRecord.namespace == self.namespace
+            )
+
+            # mypy does not recognize .all() or .filter()
+            if after:
+                query = query.filter(  # type: ignore[attr-defined]
+                    UpsertionRecord.updated_at > after
+                )
+            if before:
+                query = query.filter(  # type: ignore[attr-defined]
+                    UpsertionRecord.updated_at < before
+                )
+            if group_ids:
+                query = query.filter(  # type: ignore[attr-defined]
+                    UpsertionRecord.group_id.in_(group_ids)
+                )
+
+            if limit:
+                query = query.limit(limit)  # type: ignore[attr-defined]
+            records = query.all()  # type: ignore[attr-defined]
+        return [r.key for r in records]
+
+    async def alist_keys(
+        self,
+        *,
+        before: Optional[float] = None,
+        after: Optional[float] = None,
+        group_ids: Optional[Sequence[str]] = None,
+        limit: Optional[int] = None,
+    ) -> List[str]:
+        """List records in the SQLite database based on the provided date range."""
+        async with self._amake_session() as session:
+            query = select(UpsertionRecord.key).filter(
+                UpsertionRecord.namespace == self.namespace
+            )
+
+            # mypy does not recognize .all() or .filter()
+            if after:
+                query = query.filter(  # type: ignore[attr-defined]
+                    UpsertionRecord.updated_at > after
+                )
+            if before:
+                query = query.filter(  # type: ignore[attr-defined]
+                    UpsertionRecord.updated_at < before
+                )
+            if group_ids:
+                query = query.filter(  # type: ignore[attr-defined]
+                    UpsertionRecord.group_id.in_(group_ids)
+                )
+
+            if limit:
+                query = query.limit(limit)  # type: ignore[attr-defined]
+            records = (await session.execute(query)).scalars().all()
+        return list(records)
+
+    def delete_keys(self, keys: Sequence[str]) -> None:
+        """Delete records from the SQLite database."""
+        with self._make_session() as session:
+            # mypy does not recognize .delete()
+            session.query(UpsertionRecord).filter(
+                and_(
+                    UpsertionRecord.key.in_(keys),
+                    UpsertionRecord.namespace == self.namespace,
+                )
+            ).delete()  # type: ignore[attr-defined]
+            session.commit()
+
+    async def adelete_keys(self, keys: Sequence[str]) -> None:
+        """Delete records from the SQLite database."""
+        async with self._amake_session() as session:
+            await session.execute(
+                delete(UpsertionRecord).where(
+                    and_(
+                        UpsertionRecord.key.in_(keys),
+                        UpsertionRecord.namespace == self.namespace,
+                    )
+                )
+            )
+
+            await session.commit()
diff --git a/llm/Lib/site-packages/langchain_community/indexes/base.py b/llm/Lib/site-packages/langchain_community/indexes/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..97805d91e7d631ce7c9a7801d660919e9b466637
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/indexes/base.py
@@ -0,0 +1,172 @@
+from __future__ import annotations
+
+import uuid
+from abc import ABC, abstractmethod
+from typing import List, Optional, Sequence
+
+NAMESPACE_UUID = uuid.UUID(int=1984)
+
+
+class RecordManager(ABC):
+    """Abstract base class for a record manager."""
+
+    def __init__(
+        self,
+        namespace: str,
+    ) -> None:
+        """Initialize the record manager.
+
+        Args:
+            namespace (str): The namespace for the record manager.
+        """
+        self.namespace = namespace
+
+    @abstractmethod
+    def create_schema(self) -> None:
+        """Create the database schema for the record manager."""
+
+    @abstractmethod
+    async def acreate_schema(self) -> None:
+        """Create the database schema for the record manager."""
+
+    @abstractmethod
+    def get_time(self) -> float:
+        """Get the current server time as a high resolution timestamp!
+
+        It's important to get this from the server to ensure a monotonic clock,
+        otherwise there may be data loss when cleaning up old documents!
+
+        Returns:
+            The current server time as a float timestamp.
+        """
+
+    @abstractmethod
+    async def aget_time(self) -> float:
+        """Get the current server time as a high resolution timestamp!
+
+        It's important to get this from the server to ensure a monotonic clock,
+        otherwise there may be data loss when cleaning up old documents!
+
+        Returns:
+            The current server time as a float timestamp.
+        """
+
+    @abstractmethod
+    def update(
+        self,
+        keys: Sequence[str],
+        *,
+        group_ids: Optional[Sequence[Optional[str]]] = None,
+        time_at_least: Optional[float] = None,
+    ) -> None:
+        """Upsert records into the database.
+
+        Args:
+            keys: A list of record keys to upsert.
+            group_ids: A list of group IDs corresponding to the keys.
+            time_at_least: if provided, updates should only happen if the
+              updated_at field is at least this time.
+
+        Raises:
+            ValueError: If the length of keys doesn't match the length of group_ids.
+        """
+
+    @abstractmethod
+    async def aupdate(
+        self,
+        keys: Sequence[str],
+        *,
+        group_ids: Optional[Sequence[Optional[str]]] = None,
+        time_at_least: Optional[float] = None,
+    ) -> None:
+        """Upsert records into the database.
+
+        Args:
+            keys: A list of record keys to upsert.
+            group_ids: A list of group IDs corresponding to the keys.
+            time_at_least: if provided, updates should only happen if the
+              updated_at field is at least this time.
+
+        Raises:
+            ValueError: If the length of keys doesn't match the length of group_ids.
+        """
+
+    @abstractmethod
+    def exists(self, keys: Sequence[str]) -> List[bool]:
+        """Check if the provided keys exist in the database.
+
+        Args:
+            keys: A list of keys to check.
+
+        Returns:
+            A list of boolean values indicating the existence of each key.
+        """
+
+    @abstractmethod
+    async def aexists(self, keys: Sequence[str]) -> List[bool]:
+        """Check if the provided keys exist in the database.
+
+        Args:
+            keys: A list of keys to check.
+
+        Returns:
+            A list of boolean values indicating the existence of each key.
+        """
+
+    @abstractmethod
+    def list_keys(
+        self,
+        *,
+        before: Optional[float] = None,
+        after: Optional[float] = None,
+        group_ids: Optional[Sequence[str]] = None,
+        limit: Optional[int] = None,
+    ) -> List[str]:
+        """List records in the database based on the provided filters.
+
+        Args:
+            before: Filter to list records updated before this time.
+            after: Filter to list records updated after this time.
+            group_ids: Filter to list records with specific group IDs.
+            limit: optional limit on the number of records to return.
+
+        Returns:
+            A list of keys for the matching records.
+        """
+
+    @abstractmethod
+    async def alist_keys(
+        self,
+        *,
+        before: Optional[float] = None,
+        after: Optional[float] = None,
+        group_ids: Optional[Sequence[str]] = None,
+        limit: Optional[int] = None,
+    ) -> List[str]:
+        """List records in the database based on the provided filters.
+
+        Args:
+            before: Filter to list records updated before this time.
+            after: Filter to list records updated after this time.
+            group_ids: Filter to list records with specific group IDs.
+            limit: optional limit on the number of records to return.
+
+        Returns:
+            A list of keys for the matching records.
+        """
+
+    @abstractmethod
+    def delete_keys(self, keys: Sequence[str]) -> None:
+        """Delete specified records from the database.
+
+        Args:
+            keys: A list of keys to delete.
+        """
+
+    @abstractmethod
+    async def adelete_keys(self, keys: Sequence[str]) -> None:
+        """Delete specified records from the database.
+
+        Args:
+            keys: A list of keys to delete.
+        """
diff --git a/llm/Lib/site-packages/langchain_community/llms/__init__.py b/llm/Lib/site-packages/langchain_community/llms/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5b6adb5c49f17dae1357f2e31eab824cb7f9aeaa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/__init__.py
@@ -0,0 +1,1041 @@
+"""
+**LLM** classes provide
+access to the large language model (**LLM**) APIs and services.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseLanguageModel --> BaseLLM --> LLM --> <name>  # Examples: AI21, HuggingFaceHub, OpenAI
+
+**Main helpers:**
+
+.. code-block::
+
+    LLMResult, PromptValue,
+    CallbackManagerForLLMRun, AsyncCallbackManagerForLLMRun,
+    CallbackManager, AsyncCallbackManager,
+    AIMessage, BaseMessage
+"""  # noqa: E501
+
+from typing import Any, Callable, Dict, Type
+
+from langchain_core._api.deprecation import warn_deprecated
+from langchain_core.language_models.llms import BaseLLM
+
+
+def _import_ai21() -> Type[BaseLLM]:
+    from langchain_community.llms.ai21 import AI21
+
+    return AI21
+
+
+def _import_aleph_alpha() -> Type[BaseLLM]:
+    from langchain_community.llms.aleph_alpha import AlephAlpha
+
+    return AlephAlpha
+
+
+def _import_amazon_api_gateway() -> Type[BaseLLM]:
+    from langchain_community.llms.amazon_api_gateway import AmazonAPIGateway
+
+    return AmazonAPIGateway
+
+
+def _import_anthropic() -> Type[BaseLLM]:
+    from langchain_community.llms.anthropic import Anthropic
+
+    return Anthropic
+
+
+def _import_anyscale() -> Type[BaseLLM]:
+    from langchain_community.llms.anyscale import Anyscale
+
+    return Anyscale
+
+
+def _import_aphrodite() -> Type[BaseLLM]:
+    from langchain_community.llms.aphrodite import Aphrodite
+
+    return Aphrodite
+
+
+def _import_arcee() -> Type[BaseLLM]:
+    from langchain_community.llms.arcee import Arcee
+
+    return Arcee
+
+
+def _import_aviary() -> Type[BaseLLM]:
+    from langchain_community.llms.aviary import Aviary
+
+    return Aviary
+
+
+def _import_azureml_endpoint() -> Type[BaseLLM]:
+    from langchain_community.llms.azureml_endpoint import AzureMLOnlineEndpoint
+
+    return AzureMLOnlineEndpoint
+
+
+def _import_baichuan() -> Type[BaseLLM]:
+    from langchain_community.llms.baichuan import BaichuanLLM
+
+    return BaichuanLLM
+
+
+def _import_baidu_qianfan_endpoint() -> Type[BaseLLM]:
+    from langchain_community.llms.baidu_qianfan_endpoint import QianfanLLMEndpoint
+
+    return QianfanLLMEndpoint
+
+
+def _import_bananadev() -> Type[BaseLLM]:
+    from langchain_community.llms.bananadev import Banana
+
+    return Banana
+
+
+def _import_baseten() -> Type[BaseLLM]:
+    from langchain_community.llms.baseten import Baseten
+
+    return Baseten
+
+
+def _import_beam() -> Type[BaseLLM]:
+    from langchain_community.llms.beam import Beam
+
+    return Beam
+
+
+def _import_bedrock() -> Type[BaseLLM]:
+    from langchain_community.llms.bedrock import Bedrock
+
+    return Bedrock
+
+
+def _import_bigdlllm() -> Type[BaseLLM]:
+    from langchain_community.llms.bigdl_llm import BigdlLLM
+
+    return BigdlLLM
+
+
+def _import_bittensor() -> Type[BaseLLM]:
+    from langchain_community.llms.bittensor import NIBittensorLLM
+
+    return NIBittensorLLM
+
+
+def _import_cerebriumai() -> Type[BaseLLM]:
+    from langchain_community.llms.cerebriumai import CerebriumAI
+
+    return CerebriumAI
+
+
+def _import_chatglm() -> Type[BaseLLM]:
+    from langchain_community.llms.chatglm import ChatGLM
+
+    return ChatGLM
+
+
+def _import_clarifai() -> Type[BaseLLM]:
+    from langchain_community.llms.clarifai import Clarifai
+
+    return Clarifai
+
+
+def _import_cohere() -> Type[BaseLLM]:
+    from langchain_community.llms.cohere import Cohere
+
+    return Cohere
+
+
+def _import_ctransformers() -> Type[BaseLLM]:
+    from langchain_community.llms.ctransformers import CTransformers
+
+    return CTransformers
+
+
+def _import_ctranslate2() -> Type[BaseLLM]:
+    from langchain_community.llms.ctranslate2 import CTranslate2
+
+    return CTranslate2
+
+
+def _import_databricks() -> Type[BaseLLM]:
+    from langchain_community.llms.databricks import Databricks
+
+    return Databricks
+
+
+# deprecated / only for back compat - do not add to __all__
+def _import_databricks_chat() -> Any:
+    warn_deprecated(
+        since="0.0.22",
+        removal="0.2",
+        alternative_import="langchain_community.chat_models.ChatDatabricks",
+    )
+    from langchain_community.chat_models.databricks import ChatDatabricks
+
+    return ChatDatabricks
+
+
+def _import_deepinfra() -> Type[BaseLLM]:
+    from langchain_community.llms.deepinfra import DeepInfra
+
+    return DeepInfra
+
+
+def _import_deepsparse() -> Type[BaseLLM]:
+    from langchain_community.llms.deepsparse import DeepSparse
+
+    return DeepSparse
+
+
+def _import_edenai() -> Type[BaseLLM]:
+    from langchain_community.llms.edenai import EdenAI
+
+    return EdenAI
+
+
+def _import_fake() -> Type[BaseLLM]:
+    from langchain_community.llms.fake import FakeListLLM
+
+    return FakeListLLM
+
+
+def _import_fireworks() -> Type[BaseLLM]:
+    from langchain_community.llms.fireworks import Fireworks
+
+    return Fireworks
+
+
+def _import_forefrontai() -> Type[BaseLLM]:
+    from langchain_community.llms.forefrontai import ForefrontAI
+
+    return ForefrontAI
+
+
+def _import_friendli() -> Type[BaseLLM]:
+    from langchain_community.llms.friendli import Friendli
+
+    return Friendli
+
+
+def _import_gigachat() -> Type[BaseLLM]:
+    from langchain_community.llms.gigachat import GigaChat
+
+    return GigaChat
+
+
+def _import_google_palm() -> Type[BaseLLM]:
+    from langchain_community.llms.google_palm import GooglePalm
+
+    return GooglePalm
+
+
+def _import_gooseai() -> Type[BaseLLM]:
+    from langchain_community.llms.gooseai import GooseAI
+
+    return GooseAI
+
+
+def _import_gpt4all() -> Type[BaseLLM]:
+    from langchain_community.llms.gpt4all import GPT4All
+
+    return GPT4All
+
+
+def _import_gradient_ai() -> Type[BaseLLM]:
+    from langchain_community.llms.gradient_ai import GradientLLM
+
+    return GradientLLM
+
+
+def _import_huggingface_endpoint() -> Type[BaseLLM]:
+    from langchain_community.llms.huggingface_endpoint import HuggingFaceEndpoint
+
+    return HuggingFaceEndpoint
+
+
+def _import_huggingface_hub() -> Type[BaseLLM]:
+    from langchain_community.llms.huggingface_hub import HuggingFaceHub
+
+    return HuggingFaceHub
+
+
+def _import_huggingface_pipeline() -> Type[BaseLLM]:
+    from langchain_community.llms.huggingface_pipeline import HuggingFacePipeline
+
+    return HuggingFacePipeline
+
+
+def _import_huggingface_text_gen_inference() -> Type[BaseLLM]:
+    from langchain_community.llms.huggingface_text_gen_inference import (
+        HuggingFaceTextGenInference,
+    )
+
+    return HuggingFaceTextGenInference
+
+
+def _import_human() -> Type[BaseLLM]:
+    from langchain_community.llms.human import HumanInputLLM
+
+    return HumanInputLLM
+
+
+def _import_ipex_llm() -> Type[BaseLLM]:
+    from langchain_community.llms.ipex_llm import IpexLLM
+
+    return IpexLLM
+
+
+def _import_javelin_ai_gateway() -> Type[BaseLLM]:
+    from langchain_community.llms.javelin_ai_gateway import JavelinAIGateway
+
+    return JavelinAIGateway
+
+
+def _import_koboldai() -> Type[BaseLLM]:
+    from langchain_community.llms.koboldai import KoboldApiLLM
+
+    return KoboldApiLLM
+
+
+def _import_konko() -> Type[BaseLLM]:
+    from langchain_community.llms.konko import Konko
+
+    return Konko
+
+
+def _import_llamacpp() -> Type[BaseLLM]:
+    from langchain_community.llms.llamacpp import LlamaCpp
+
+    return LlamaCpp
+
+
+def _import_llamafile() -> Type[BaseLLM]:
+    from langchain_community.llms.llamafile import Llamafile
+
+    return Llamafile
+
+
+def _import_manifest() -> Type[BaseLLM]:
+    from langchain_community.llms.manifest import ManifestWrapper
+
+    return ManifestWrapper
+
+
+def _import_minimax() -> Type[BaseLLM]:
+    from langchain_community.llms.minimax import Minimax
+
+    return Minimax
+
+
+def _import_mlflow() -> Type[BaseLLM]:
+    from langchain_community.llms.mlflow import Mlflow
+
+    return Mlflow
+
+
+# deprecated / only for back compat - do not add to __all__
+def _import_mlflow_chat() -> Any:
+    warn_deprecated(
+        since="0.0.22",
+        removal="0.2",
+        alternative_import="langchain_community.chat_models.ChatMlflow",
+    )
+    from langchain_community.chat_models.mlflow import ChatMlflow
+
+    return ChatMlflow
+
+
+def _import_mlflow_ai_gateway() -> Type[BaseLLM]:
+    from langchain_community.llms.mlflow_ai_gateway import MlflowAIGateway
+
+    return MlflowAIGateway
+
+
+def _import_mlx_pipeline() -> Type[BaseLLM]:
+    from langchain_community.llms.mlx_pipeline import MLXPipeline
+
+    return MLXPipeline
+
+
+def _import_modal() -> Type[BaseLLM]:
+    from langchain_community.llms.modal import Modal
+
+    return Modal
+
+
+def _import_mosaicml() -> Type[BaseLLM]:
+    from langchain_community.llms.mosaicml import MosaicML
+
+    return MosaicML
+
+
+def _import_nlpcloud() -> Type[BaseLLM]:
+    from langchain_community.llms.nlpcloud import NLPCloud
+
+    return NLPCloud
+
+
+def _import_oci_md_tgi() -> Type[BaseLLM]:
+    from langchain_community.llms.oci_data_science_model_deployment_endpoint import (
+        OCIModelDeploymentTGI,
+    )
+
+    return OCIModelDeploymentTGI
+
+
+def _import_oci_md_vllm() -> Type[BaseLLM]:
+    from langchain_community.llms.oci_data_science_model_deployment_endpoint import (
+        OCIModelDeploymentVLLM,
+    )
+
+    return OCIModelDeploymentVLLM
+
+
+def _import_oci_gen_ai() -> Type[BaseLLM]:
+    from langchain_community.llms.oci_generative_ai import OCIGenAI
+
+    return OCIGenAI
+
+
+def _import_octoai_endpoint() -> Type[BaseLLM]:
+    from langchain_community.llms.octoai_endpoint import OctoAIEndpoint
+
+    return OctoAIEndpoint
+
+
+def _import_ollama() -> Type[BaseLLM]:
+    from langchain_community.llms.ollama import Ollama
+
+    return Ollama
+
+
+def _import_opaqueprompts() -> Type[BaseLLM]:
+    from langchain_community.llms.opaqueprompts import OpaquePrompts
+
+    return OpaquePrompts
+
+
+def _import_azure_openai() -> Type[BaseLLM]:
+    from langchain_community.llms.openai import AzureOpenAI
+
+    return AzureOpenAI
+
+
+def _import_openai() -> Type[BaseLLM]:
+    from langchain_community.llms.openai import OpenAI
+
+    return OpenAI
+
+
+def _import_openai_chat() -> Type[BaseLLM]:
+    from langchain_community.llms.openai import OpenAIChat
+
+    return OpenAIChat
+
+
+def _import_openllm() -> Type[BaseLLM]:
+    from langchain_community.llms.openllm import OpenLLM
+
+    return OpenLLM
+
+
+def _import_openlm() -> Type[BaseLLM]:
+    from langchain_community.llms.openlm import OpenLM
+
+    return OpenLM
+
+
+def _import_pai_eas_endpoint() -> Type[BaseLLM]:
+    from langchain_community.llms.pai_eas_endpoint import PaiEasEndpoint
+
+    return PaiEasEndpoint
+
+
+def _import_petals() -> Type[BaseLLM]:
+    from langchain_community.llms.petals import Petals
+
+    return Petals
+
+
+def _import_pipelineai() -> Type[BaseLLM]:
+    from langchain_community.llms.pipelineai import PipelineAI
+
+    return PipelineAI
+
+
+def _import_predibase() -> Type[BaseLLM]:
+    from langchain_community.llms.predibase import Predibase
+
+    return Predibase
+
+
+def _import_predictionguard() -> Type[BaseLLM]:
+    from langchain_community.llms.predictionguard import PredictionGuard
+
+    return PredictionGuard
+
+
+def _import_promptlayer() -> Type[BaseLLM]:
+    from langchain_community.llms.promptlayer_openai import PromptLayerOpenAI
+
+    return PromptLayerOpenAI
+
+
+def _import_promptlayer_chat() -> Type[BaseLLM]:
+    from langchain_community.llms.promptlayer_openai import PromptLayerOpenAIChat
+
+    return PromptLayerOpenAIChat
+
+
+def _import_replicate() -> Type[BaseLLM]:
+    from langchain_community.llms.replicate import Replicate
+
+    return Replicate
+
+
+def _import_rwkv() -> Type[BaseLLM]:
+    from langchain_community.llms.rwkv import RWKV
+
+    return RWKV
+
+
+def _import_sagemaker_endpoint() -> Type[BaseLLM]:
+    from langchain_community.llms.sagemaker_endpoint import SagemakerEndpoint
+
+    return SagemakerEndpoint
+
+
+def _import_self_hosted() -> Type[BaseLLM]:
+    from langchain_community.llms.self_hosted import SelfHostedPipeline
+
+    return SelfHostedPipeline
+
+
+def _import_self_hosted_hugging_face() -> Type[BaseLLM]:
+    from langchain_community.llms.self_hosted_hugging_face import (
+        SelfHostedHuggingFaceLLM,
+    )
+
+    return SelfHostedHuggingFaceLLM
+
+
+def _import_stochasticai() -> Type[BaseLLM]:
+    from langchain_community.llms.stochasticai import StochasticAI
+
+    return StochasticAI
+
+
+def _import_symblai_nebula() -> Type[BaseLLM]:
+    from langchain_community.llms.symblai_nebula import Nebula
+
+    return Nebula
+
+
+def _import_textgen() -> Type[BaseLLM]:
+    from langchain_community.llms.textgen import TextGen
+
+    return TextGen
+
+
+def _import_titan_takeoff() -> Type[BaseLLM]:
+    from langchain_community.llms.titan_takeoff import TitanTakeoff
+
+    return TitanTakeoff
+
+
+def _import_titan_takeoff_pro() -> Type[BaseLLM]:
+    from langchain_community.llms.titan_takeoff import TitanTakeoff
+
+    return TitanTakeoff
+
+
+def _import_together() -> Type[BaseLLM]:
+    from langchain_community.llms.together import Together
+
+    return Together
+
+
+def _import_tongyi() -> Type[BaseLLM]:
+    from langchain_community.llms.tongyi import Tongyi
+
+    return Tongyi
+
+
+def _import_vertex() -> Type[BaseLLM]:
+    from langchain_community.llms.vertexai import VertexAI
+
+    return VertexAI
+
+
+def _import_vertex_model_garden() -> Type[BaseLLM]:
+    from langchain_community.llms.vertexai import VertexAIModelGarden
+
+    return VertexAIModelGarden
+
+
+def _import_vllm() -> Type[BaseLLM]:
+    from langchain_community.llms.vllm import VLLM
+
+    return VLLM
+
+
+def _import_vllm_openai() -> Type[BaseLLM]:
+    from langchain_community.llms.vllm import VLLMOpenAI
+
+    return VLLMOpenAI
+
+
+def _import_watsonxllm() -> Type[BaseLLM]:
+    from langchain_community.llms.watsonxllm import WatsonxLLM
+
+    return WatsonxLLM
+
+
+def _import_weight_only_quantization() -> Any:
+    from langchain_community.llms.weight_only_quantization import (
+        WeightOnlyQuantPipeline,
+    )
+
+    return WeightOnlyQuantPipeline
+
+
+def _import_writer() -> Type[BaseLLM]:
+    from langchain_community.llms.writer import Writer
+
+    return Writer
+
+
+def _import_xinference() -> Type[BaseLLM]:
+    from langchain_community.llms.xinference import Xinference
+
+    return Xinference
+
+
+def _import_yandex_gpt() -> Type[BaseLLM]:
+    from langchain_community.llms.yandex import YandexGPT
+
+    return YandexGPT
+
+
+def _import_yuan2() -> Type[BaseLLM]:
+    from langchain_community.llms.yuan2 import Yuan2
+
+    return Yuan2
+
+
+def _import_volcengine_maas() -> Type[BaseLLM]:
+    from langchain_community.llms.volcengine_maas import VolcEngineMaasLLM
+
+    return VolcEngineMaasLLM
+
+
+def _import_sparkllm() -> Type[BaseLLM]:
+    from langchain_community.llms.sparkllm import SparkLLM
+
+    return SparkLLM
+
+
+def __getattr__(name: str) -> Any:
+    if name == "AI21":
+        return _import_ai21()
+    elif name == "AlephAlpha":
+        return _import_aleph_alpha()
+    elif name == "AmazonAPIGateway":
+        return _import_amazon_api_gateway()
+    elif name == "Anthropic":
+        return _import_anthropic()
+    elif name == "Anyscale":
+        return _import_anyscale()
+    elif name == "Aphrodite":
+        return _import_aphrodite()
+    elif name == "Arcee":
+        return _import_arcee()
+    elif name == "Aviary":
+        return _import_aviary()
+    elif name == "AzureMLOnlineEndpoint":
+        return _import_azureml_endpoint()
+    elif name == "BaichuanLLM" or name == "Baichuan":
+        return _import_baichuan()
+    elif name == "QianfanLLMEndpoint":
+        return _import_baidu_qianfan_endpoint()
+    elif name == "Banana":
+        return _import_bananadev()
+    elif name == "Baseten":
+        return _import_baseten()
+    elif name == "Beam":
+        return _import_beam()
+    elif name == "Bedrock":
+        return _import_bedrock()
+    elif name == "BigdlLLM":
+        return _import_bigdlllm()
+    elif name == "NIBittensorLLM":
+        return _import_bittensor()
+    elif name == "CerebriumAI":
+        return _import_cerebriumai()
+    elif name == "ChatGLM":
+        return _import_chatglm()
+    elif name == "Clarifai":
+        return _import_clarifai()
+    elif name == "Cohere":
+        return _import_cohere()
+    elif name == "CTransformers":
+        return _import_ctransformers()
+    elif name == "CTranslate2":
+        return _import_ctranslate2()
+    elif name == "Databricks":
+        return _import_databricks()
+    elif name == "DeepInfra":
+        return _import_deepinfra()
+    elif name == "DeepSparse":
+        return _import_deepsparse()
+    elif name == "EdenAI":
+        return _import_edenai()
+    elif name == "FakeListLLM":
+        return _import_fake()
+    elif name == "Fireworks":
+        return _import_fireworks()
+    elif name == "ForefrontAI":
+        return _import_forefrontai()
+    elif name == "Friendli":
+        return _import_friendli()
+    elif name == "GigaChat":
+        return _import_gigachat()
+    elif name == "GooglePalm":
+        return _import_google_palm()
+    elif name == "GooseAI":
+        return _import_gooseai()
+    elif name == "GPT4All":
+        return _import_gpt4all()
+    elif name == "GradientLLM":
+        return _import_gradient_ai()
+    elif name == "HuggingFaceEndpoint":
+        return _import_huggingface_endpoint()
+    elif name == "HuggingFaceHub":
+        return _import_huggingface_hub()
+    elif name == "HuggingFacePipeline":
+        return _import_huggingface_pipeline()
+    elif name == "HuggingFaceTextGenInference":
+        return _import_huggingface_text_gen_inference()
+    elif name == "HumanInputLLM":
+        return _import_human()
+    elif name == "IpexLLM":
+        return _import_ipex_llm()
+    elif name == "JavelinAIGateway":
+        return _import_javelin_ai_gateway()
+    elif name == "KoboldApiLLM":
+        return _import_koboldai()
+    elif name == "Konko":
+        return _import_konko()
+    elif name == "LlamaCpp":
+        return _import_llamacpp()
+    elif name == "Llamafile":
+        return _import_llamafile()
+    elif name == "ManifestWrapper":
+        return _import_manifest()
+    elif name == "Minimax":
+        return _import_minimax()
+    elif name == "Mlflow":
+        return _import_mlflow()
+    elif name == "MlflowAIGateway":
+        return _import_mlflow_ai_gateway()
+    elif name == "MLXPipeline":
+        return _import_mlx_pipeline()
+    elif name == "Modal":
+        return _import_modal()
+    elif name == "MosaicML":
+        return _import_mosaicml()
+    elif name == "NLPCloud":
+        return _import_nlpcloud()
+    elif name == "OCIModelDeploymentTGI":
+        return _import_oci_md_tgi()
+    elif name == "OCIModelDeploymentVLLM":
+        return _import_oci_md_vllm()
+    elif name == "OCIGenAI":
+        return _import_oci_gen_ai()
+    elif name == "OctoAIEndpoint":
+        return _import_octoai_endpoint()
+    elif name == "Ollama":
+        return _import_ollama()
+    elif name == "OpaquePrompts":
+        return _import_opaqueprompts()
+    elif name == "AzureOpenAI":
+        return _import_azure_openai()
+    elif name == "OpenAI":
+        return _import_openai()
+    elif name == "OpenAIChat":
+        return _import_openai_chat()
+    elif name == "OpenLLM":
+        return _import_openllm()
+    elif name == "OpenLM":
+        return _import_openlm()
+    elif name == "PaiEasEndpoint":
+        return _import_pai_eas_endpoint()
+    elif name == "Petals":
+        return _import_petals()
+    elif name == "PipelineAI":
+        return _import_pipelineai()
+    elif name == "Predibase":
+        return _import_predibase()
+    elif name == "PredictionGuard":
+        return _import_predictionguard()
+    elif name == "PromptLayerOpenAI":
+        return _import_promptlayer()
+    elif name == "PromptLayerOpenAIChat":
+        return _import_promptlayer_chat()
+    elif name == "Replicate":
+        return _import_replicate()
+    elif name == "RWKV":
+        return _import_rwkv()
+    elif name == "SagemakerEndpoint":
+        return _import_sagemaker_endpoint()
+    elif name == "SelfHostedPipeline":
+        return _import_self_hosted()
+    elif name == "SelfHostedHuggingFaceLLM":
+        return _import_self_hosted_hugging_face()
+    elif name == "StochasticAI":
+        return _import_stochasticai()
+    elif name == "Nebula":
+        return _import_symblai_nebula()
+    elif name == "TextGen":
+        return _import_textgen()
+    elif name == "TitanTakeoff":
+        return _import_titan_takeoff()
+    elif name == "TitanTakeoffPro":
+        return _import_titan_takeoff_pro()
+    elif name == "Together":
+        return _import_together()
+    elif name == "Tongyi":
+        return _import_tongyi()
+    elif name == "VertexAI":
+        return _import_vertex()
+    elif name == "VertexAIModelGarden":
+        return _import_vertex_model_garden()
+    elif name == "VLLM":
+        return _import_vllm()
+    elif name == "VLLMOpenAI":
+        return _import_vllm_openai()
+    elif name == "WatsonxLLM":
+        return _import_watsonxllm()
+    elif name == "WeightOnlyQuantPipeline":
+        return _import_weight_only_quantization()
+    elif name == "Writer":
+        return _import_writer()
+    elif name == "Xinference":
+        return _import_xinference()
+    elif name == "YandexGPT":
+        return _import_yandex_gpt()
+    elif name == "Yuan2":
+        return _import_yuan2()
+    elif name == "VolcEngineMaasLLM":
+        return _import_volcengine_maas()
+    elif name == "type_to_cls_dict":
+        # for backwards compatibility
+        type_to_cls_dict: Dict[str, Type[BaseLLM]] = {
+            k: v() for k, v in get_type_to_cls_dict().items()
+        }
+        return type_to_cls_dict
+    elif name == "SparkLLM":
+        return _import_sparkllm()
+    else:
+        raise AttributeError(f"Could not find: {name}")
+
+
+__all__ = [
+    "AI21",
+    "AlephAlpha",
+    "AmazonAPIGateway",
+    "Anthropic",
+    "Anyscale",
+    "Aphrodite",
+    "Arcee",
+    "Aviary",
+    "AzureMLOnlineEndpoint",
+    "AzureOpenAI",
+    "BaichuanLLM",
+    "Banana",
+    "Baseten",
+    "Beam",
+    "Bedrock",
+    "CTransformers",
+    "CTranslate2",
+    "CerebriumAI",
+    "ChatGLM",
+    "Clarifai",
+    "Cohere",
+    "Databricks",
+    "DeepInfra",
+    "DeepSparse",
+    "EdenAI",
+    "FakeListLLM",
+    "Fireworks",
+    "ForefrontAI",
+    "Friendli",
+    "GPT4All",
+    "GigaChat",
+    "GooglePalm",
+    "GooseAI",
+    "GradientLLM",
+    "HuggingFaceEndpoint",
+    "HuggingFaceHub",
+    "HuggingFacePipeline",
+    "HuggingFaceTextGenInference",
+    "HumanInputLLM",
+    "IpexLLM",
+    "JavelinAIGateway",
+    "KoboldApiLLM",
+    "Konko",
+    "LlamaCpp",
+    "Llamafile",
+    "ManifestWrapper",
+    "Minimax",
+    "Mlflow",
+    "MlflowAIGateway",
+    "MLXPipeline",
+    "Modal",
+    "MosaicML",
+    "NIBittensorLLM",
+    "NLPCloud",
+    "Nebula",
+    "OCIGenAI",
+    "OCIModelDeploymentTGI",
+    "OCIModelDeploymentVLLM",
+    "OctoAIEndpoint",
+    "Ollama",
+    "OpaquePrompts",
+    "OpenAI",
+    "OpenAIChat",
+    "OpenLLM",
+    "OpenLM",
+    "PaiEasEndpoint",
+    "Petals",
+    "PipelineAI",
+    "Predibase",
+    "PredictionGuard",
+    "PromptLayerOpenAI",
+    "PromptLayerOpenAIChat",
+    "QianfanLLMEndpoint",
+    "RWKV",
+    "Replicate",
+    "SagemakerEndpoint",
+    "SelfHostedHuggingFaceLLM",
+    "SelfHostedPipeline",
+    "SparkLLM",
+    "StochasticAI",
+    "TextGen",
+    "TitanTakeoff",
+    "TitanTakeoffPro",
+    "Together",
+    "Tongyi",
+    "VLLM",
+    "VLLMOpenAI",
+    "VertexAI",
+    "VertexAIModelGarden",
+    "VolcEngineMaasLLM",
+    "WatsonxLLM",
+    "WeightOnlyQuantPipeline",
+    "Writer",
+    "Xinference",
+    "YandexGPT",
+    "Yuan2",
+]
+
+
+def get_type_to_cls_dict() -> Dict[str, Callable[[], Type[BaseLLM]]]:
+    return {
+        "ai21": _import_ai21,
+        "aleph_alpha": _import_aleph_alpha,
+        "amazon_api_gateway": _import_amazon_api_gateway,
+        "amazon_bedrock": _import_bedrock,
+        "anthropic": _import_anthropic,
+        "anyscale": _import_anyscale,
+        "arcee": _import_arcee,
+        "aviary": _import_aviary,
+        "azure": _import_azure_openai,
+        "azureml_endpoint": _import_azureml_endpoint,
+        "baichuan": _import_baichuan,
+        "bananadev": _import_bananadev,
+        "baseten": _import_baseten,
+        "beam": _import_beam,
+        "cerebriumai": _import_cerebriumai,
+        "chat_glm": _import_chatglm,
+        "clarifai": _import_clarifai,
+        "cohere": _import_cohere,
+        "ctransformers": _import_ctransformers,
+        "ctranslate2": _import_ctranslate2,
+        "databricks": _import_databricks,
+        "databricks-chat": _import_databricks_chat,  # deprecated / only for back compat
+        "deepinfra": _import_deepinfra,
+        "deepsparse": _import_deepsparse,
+        "edenai": _import_edenai,
+        "fake-list": _import_fake,
+        "forefrontai": _import_forefrontai,
+        "friendli": _import_friendli,
+        "giga-chat-model": _import_gigachat,
+        "google_palm": _import_google_palm,
+        "gooseai": _import_gooseai,
+        "gradient": _import_gradient_ai,
+        "gpt4all": _import_gpt4all,
+        "huggingface_endpoint": _import_huggingface_endpoint,
+        "huggingface_hub": _import_huggingface_hub,
+        "huggingface_pipeline": _import_huggingface_pipeline,
+        "huggingface_textgen_inference": _import_huggingface_text_gen_inference,
+        "human-input": _import_human,
+        "koboldai": _import_koboldai,
+        "konko": _import_konko,
+        "llamacpp": _import_llamacpp,
+        "llamafile": _import_llamafile,
+        "textgen": _import_textgen,
+        "minimax": _import_minimax,
+        "mlflow": _import_mlflow,
+        "mlflow-chat": _import_mlflow_chat,  # deprecated / only for back compat
+        "mlflow-ai-gateway": _import_mlflow_ai_gateway,
+        "mlx_pipeline": _import_mlx_pipeline,
+        "modal": _import_modal,
+        "mosaic": _import_mosaicml,
+        "nebula": _import_symblai_nebula,
+        "nibittensor": _import_bittensor,
+        "nlpcloud": _import_nlpcloud,
+        "oci_model_deployment_tgi_endpoint": _import_oci_md_tgi,
+        "oci_model_deployment_vllm_endpoint": _import_oci_md_vllm,
+        "oci_generative_ai": _import_oci_gen_ai,
+        "octoai_endpoint": _import_octoai_endpoint,
+        "ollama": _import_ollama,
+        "openai": _import_openai,
+        "openlm": _import_openlm,
+        "pai_eas_endpoint": _import_pai_eas_endpoint,
+        "petals": _import_petals,
+        "pipelineai": _import_pipelineai,
+        "predibase": _import_predibase,
+        "opaqueprompts": _import_opaqueprompts,
+        "replicate": _import_replicate,
+        "rwkv": _import_rwkv,
+        "sagemaker_endpoint": _import_sagemaker_endpoint,
+        "self_hosted": _import_self_hosted,
+        "self_hosted_hugging_face": _import_self_hosted_hugging_face,
+        "stochasticai": _import_stochasticai,
+        "together": _import_together,
+        "tongyi": _import_tongyi,
+        "titan_takeoff": _import_titan_takeoff,
+        "titan_takeoff_pro": _import_titan_takeoff_pro,
+        "vertexai": _import_vertex,
+        "vertexai_model_garden": _import_vertex_model_garden,
+        "openllm": _import_openllm,
+        "openllm_client": _import_openllm,
+        "vllm": _import_vllm,
+        "vllm_openai": _import_vllm_openai,
+        "watsonxllm": _import_watsonxllm,
+        "weight_only_quantization": _import_weight_only_quantization,
+        "writer": _import_writer,
+        "xinference": _import_xinference,
+        "javelin-ai-gateway": _import_javelin_ai_gateway,
+        "qianfan_endpoint": _import_baidu_qianfan_endpoint,
+        "yandex_gpt": _import_yandex_gpt,
+        "yuan2": _import_yuan2,
+        "VolcEngineMaasLLM": _import_volcengine_maas,
+        "SparkLLM": _import_sparkllm,
+    }
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9d62fc6bf7d00ab4fc05bd465a5d7390f7f47f6b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/ai21.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/ai21.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5bdc858851d3ae5725d9c91524ebaa05a2e01f28
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/ai21.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/aleph_alpha.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/aleph_alpha.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..34d7083bc8d9a29950f900507f4069968e3f5c7e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/aleph_alpha.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/amazon_api_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/amazon_api_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1788417e0291e091b12301bfc486e4a1847cd815
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/amazon_api_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/anthropic.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/anthropic.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..82c28a8da9f95d34a73beaf5e3f43e297f90a3f4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/anthropic.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/anyscale.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/anyscale.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fc987fc766bcec817ef92e74385e5c7f700aaf1f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/anyscale.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/aphrodite.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/aphrodite.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ff17a892e207e4bbf3c65c8d402b12cd48530eeb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/aphrodite.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/arcee.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/arcee.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6eeb3cd8a59befcb89afc6be13964a130f803ed7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/arcee.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/aviary.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/aviary.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b45dd8805e9a2de99e68a2dc06331f6fe30ec273
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/aviary.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/azureml_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/azureml_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8a6ed6282c667e311e089d36af2b997d1b5deec1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/azureml_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/baichuan.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/baichuan.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..933d7a49f0ee02802e289a242d5c589e2cd05ad6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/baichuan.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b8f51d0953b84c509b895e118518684face34416
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/baidu_qianfan_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/bananadev.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/bananadev.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c0244aba80bf68dea98cfdfb676242da5ec44472
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/bananadev.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/baseten.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/baseten.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8f492151348cc1efa801f098a05e569c4d265aba
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/baseten.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/beam.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/beam.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a7623a6e6059e4f026b6070034b8ccb4f2d854fc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/beam.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/bedrock.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/bedrock.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..55baa303d4cf1f68792228792ea1ed59fb6e1b5f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/bedrock.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/bigdl_llm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/bigdl_llm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..98fa78068824d00c38f03bff14fb1b4581002d3d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/bigdl_llm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/bittensor.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/bittensor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2acc312ba4e9828742fa57d2aa70d610a2d3ae6b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/bittensor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/cerebriumai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/cerebriumai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fcf6ec7d237a4b9405649a5abe7e4d2d55182c08
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/cerebriumai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/chatglm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/chatglm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..41705683dfb02db940e882edfbb18b22dc4802da
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/chatglm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/chatglm3.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/chatglm3.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2902fb7567588e5b1ad133f5627991be8ce4a4ca
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/chatglm3.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/clarifai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/clarifai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3a8c0a4cee7a7b257665057e25f3c1889602613d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/clarifai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/cloudflare_workersai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/cloudflare_workersai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e6252a946b97ea14b389e2a5345fa065f6ef0260
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/cloudflare_workersai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/cohere.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/cohere.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9c2d77677969d1f38ddf19dc989ba0e2d3c11023
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/cohere.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/ctransformers.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/ctransformers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a1d446c2cf9e014ac0340dbe17f31151abe60d48
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/ctransformers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/ctranslate2.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/ctranslate2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4c80f9ae41a5e3266dea25672564f525293b3ca4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/ctranslate2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/databricks.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/databricks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6ed921e7dac35bb3080b7a6e656a37ba6d27e2f4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/databricks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/deepinfra.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/deepinfra.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ce6b039b7d2532d6d84f03e0694726a970fba85b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/deepinfra.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/deepsparse.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/deepsparse.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ab15c16018b7609fc05c0f0a7bd11d99106f0b64
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/deepsparse.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/edenai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/edenai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9ba712f9c7b7f4f3dddfd3b90231a28815911ea3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/edenai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/fake.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/fake.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b9de25b39f7cd588bfcd010a75edf014826567d0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/fake.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/fireworks.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/fireworks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4905e3f70233adaf660005e17e5c0491aee0c314
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/fireworks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/forefrontai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/forefrontai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..83d88aedaebd080690e1241ee14baa31f26fa825
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/forefrontai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/friendli.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/friendli.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7f9a8ad59956fb37797a8dde97c2a50764557311
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/friendli.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/gigachat.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/gigachat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..946e0e9d0ce4430a0db7dd1e9fda2ece70f68f7d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/gigachat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/google_palm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/google_palm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3edfd7bbe1bf0c600ffbe2384d93d18932676d3b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/google_palm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/gooseai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/gooseai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..323a4d2e4997a1f95938bacff7d11f3b5712dded
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/gooseai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/gpt4all.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/gpt4all.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e16b5d16c32efb597820a88ffc03f0a3f6aac074
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/gpt4all.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/gradient_ai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/gradient_ai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d93ce1fa5220d291489c6103d70cd1ab9f3a45d3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/gradient_ai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/huggingface_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/huggingface_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4acfce5e0d219fa637e94261faa5a41dd6ffc1f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/huggingface_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/huggingface_hub.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/huggingface_hub.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..144212a2377f6efff10d4ce182186fd2b1ba6cbd
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/huggingface_hub.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/huggingface_pipeline.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/huggingface_pipeline.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..99ecd73a60b61d996a23b641b5ae19ca30903e7c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/huggingface_pipeline.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/huggingface_text_gen_inference.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/huggingface_text_gen_inference.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..07230fafb7c0848958597df021cb0b7a2de2244d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/huggingface_text_gen_inference.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/human.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/human.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4936670f1d509a876f8a3671cd004d2d67c78063
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/human.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/ipex_llm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/ipex_llm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6043e930ad9d04af610ec276a865f796a990d371
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/ipex_llm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/javelin_ai_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/javelin_ai_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..36f5557bfd733ff2b20fb217fc4de7080c682c6e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/javelin_ai_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/koboldai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/koboldai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..791a143d574078c6ec536942b6caea110c9a6ee5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/koboldai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/konko.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/konko.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..19d29f71dcf2990e4ef3a084f3f40176a08fc8a6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/konko.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/layerup_security.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/layerup_security.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5795374fa94bd2ab13bd880a8d9cdfe58436f6d2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/layerup_security.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/llamacpp.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/llamacpp.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3b696e36a6778e9ebf4b4999428d69b9f65508f2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/llamacpp.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/llamafile.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/llamafile.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..013d89a251be3e2579c477d44c5d22c459088123
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/llamafile.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/loading.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/loading.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7d649bac239f0c462223f647661c2008795704f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/loading.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/manifest.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/manifest.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6ad35e5b8d69e1ec5aea277259e16eeccb736ad4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/manifest.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/minimax.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/minimax.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ce0a3c353457eb0bcdb128bedb8cd85f263b9f74
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/minimax.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/mlflow.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/mlflow.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c66b443860cfe2b7fd3b5bfbdc7575b4c69b4487
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/mlflow.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/mlflow_ai_gateway.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/mlflow_ai_gateway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..373d7e8ca63783a798aa96f11849929828badcb7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/mlflow_ai_gateway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/mlx_pipeline.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/mlx_pipeline.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..14946dc88da75082467afd924d98d61efa931261
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/mlx_pipeline.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/modal.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/modal.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ab23ddbd6a82dfb6c843aa168ad93330405dcc0b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/modal.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/moonshot.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/moonshot.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5dee71fed01fe976f2377f8fbbc4c6df472ad4b6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/moonshot.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/mosaicml.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/mosaicml.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9fa3684b99b57dc24c3e280a3dc0efd2b95374e2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/mosaicml.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/nlpcloud.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/nlpcloud.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6626c1ecfb5405bf056e00feb50aa3cbc03a592b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/nlpcloud.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/oci_data_science_model_deployment_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/oci_data_science_model_deployment_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a2f0a03aec965bacca2f5046cc7732ea3a1a74c0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/oci_data_science_model_deployment_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/oci_generative_ai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/oci_generative_ai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4e0be153aa2a21f4b0e0245421f61fcb546f532e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/oci_generative_ai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/octoai_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/octoai_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..306cacfdb418b313f031c1a8878a4ed3311f744c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/octoai_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/ollama.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/ollama.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b9c23006a578f15a20cca60316077d4cafd47976
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/ollama.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/opaqueprompts.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/opaqueprompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a5ef79207cfa91a78e2e097e33fb6ca2a3baa736
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/opaqueprompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/openai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..026f35de69626016772a14109b0959596e101730
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/openllm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/openllm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ad0c7423eceebc4f448a1314e51ddf92b692cada
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/openllm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/openlm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/openlm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e6eb34a86fb75d43ec8ff76ff3aa677af5ebddff
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/openlm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/pai_eas_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/pai_eas_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..57b660ebf18abc25ea6ff25c174b94162d5d219e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/pai_eas_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/petals.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/petals.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..87dd32760667ecffd2ee951a72a700d8d62559a4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/petals.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/pipelineai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/pipelineai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5bbe95fb52b1631aad1cd9aa537823b4d1a5fb60
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/pipelineai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/predibase.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/predibase.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e5f19f0b49a8e5530320b1e963e84c6ff7ea2f48
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/predibase.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/predictionguard.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/predictionguard.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d10574404ce90821c5b6f7ca274b130494a2d48e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/predictionguard.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/promptlayer_openai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/promptlayer_openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4efca15aa78caaf4a980f93d40e5c172f3e79d7f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/promptlayer_openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/replicate.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/replicate.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ff609669b9164ee6b76ec3fa3e24da1b50ffcfa0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/replicate.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/rwkv.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/rwkv.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..69c9481b49276c1e271e5b8aac3a5d744890ae12
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/rwkv.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/sagemaker_endpoint.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/sagemaker_endpoint.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3351a556203997bf7b3be799227c42cbb767b7c5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/sagemaker_endpoint.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/self_hosted.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/self_hosted.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fae2c583d60f71f93767e7ead3d941bd45ffc042
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/self_hosted.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/self_hosted_hugging_face.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/self_hosted_hugging_face.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e8b0bf9d02785e84fbfd1667f8995551dd853828
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/self_hosted_hugging_face.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/solar.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/solar.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d15514fdd27b828cc04d2ddb085363be27afbb2b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/solar.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/sparkllm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/sparkllm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2505234aae9e706952bdc05a56be530d58cb1965
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/sparkllm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/stochasticai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/stochasticai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..22a9e5f68d636e364519e95fce05af069eb80445
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/stochasticai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/symblai_nebula.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/symblai_nebula.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3cca294c94a3b2d489bbaa1b710bb454b85ede30
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/symblai_nebula.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/textgen.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/textgen.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..98893d3e48ccd8ee2e7b8f9593dadd7ac7fc5908
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/textgen.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/titan_takeoff.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/titan_takeoff.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0b8b06001b5f2d3f5a7dbf79f2c480033c364ed5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/titan_takeoff.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/together.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/together.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..570329dcb04c7961afe56974afcc7c5a096de99c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/together.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/tongyi.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/tongyi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..968f855bd8c9fc91daada18b42b403f09f44f7cd
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/tongyi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..34a3a851e5fe8f15d787a328f9e2e40fe4eebc25
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/vertexai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/vertexai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..91f5a0500a103a1fa23d2907cee08d8b75f20ede
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/vertexai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/vllm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/vllm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..867e8894b937bc68cc0fb2ad8622cbd1899d9331
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/vllm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/volcengine_maas.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/volcengine_maas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3d1e47c8f13c9fd5b40d28d1c5b3ee2b2c0e3ff3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/volcengine_maas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/watsonxllm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/watsonxllm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d1fc7d750bb852c0d9d027874ddb502bf43323ce
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/watsonxllm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/weight_only_quantization.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/weight_only_quantization.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cff2dfd1a369d9c57de071e74241230dfa82d954
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/weight_only_quantization.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/writer.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/writer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ee6aee5c8660882960410cac2b7617afc25b319c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/writer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/xinference.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/xinference.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..27ee93906b5fb5e3c91eb0dac3b75726064454e0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/xinference.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/yandex.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/yandex.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8000e9bae9c49b0e4b040a3c445b176701ed1825
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/yandex.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/__pycache__/yuan2.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/llms/__pycache__/yuan2.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..28172207e0732b939c518372dc77a9d4c9c2fbe2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/llms/__pycache__/yuan2.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/llms/ai21.py b/llm/Lib/site-packages/langchain_community/llms/ai21.py
new file mode 100644
index 0000000000000000000000000000000000000000..dd86ba516aec83c5468911fb367d49b6513d0baa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/ai21.py
@@ -0,0 +1,158 @@
+from typing import Any, Dict, List, Optional, cast
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import BaseModel, Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+
+class AI21PenaltyData(BaseModel):
+    """Parameters for AI21 penalty data."""
+
+    scale: int = 0
+    applyToWhitespaces: bool = True
+    applyToPunctuations: bool = True
+    applyToNumbers: bool = True
+    applyToStopwords: bool = True
+    applyToEmojis: bool = True
+
+
+class AI21(LLM):
+    """AI21 large language models.
+
+    To use, you should have the environment variable ``AI21_API_KEY``
+    set with your API key or pass it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import AI21
+            ai21 = AI21(ai21_api_key="my-api-key", model="j2-jumbo-instruct")
+    """
+
+    model: str = "j2-jumbo-instruct"
+    """Model name to use."""
+
+    temperature: float = 0.7
+    """What sampling temperature to use."""
+
+    maxTokens: int = 256
+    """The maximum number of tokens to generate in the completion."""
+
+    minTokens: int = 0
+    """The minimum number of tokens to generate in the completion."""
+
+    topP: float = 1.0
+    """Total probability mass of tokens to consider at each step."""
+
+    presencePenalty: AI21PenaltyData = AI21PenaltyData()
+    """Penalizes repeated tokens."""
+
+    countPenalty: AI21PenaltyData = AI21PenaltyData()
+    """Penalizes repeated tokens according to count."""
+
+    frequencyPenalty: AI21PenaltyData = AI21PenaltyData()
+    """Penalizes repeated tokens according to frequency."""
+
+    numResults: int = 1
+    """How many completions to generate for each prompt."""
+
+    logitBias: Optional[Dict[str, float]] = None
+    """Adjust the probability of specific tokens being generated."""
+
+    ai21_api_key: Optional[SecretStr] = None
+
+    stop: Optional[List[str]] = None
+
+    base_url: Optional[str] = None
+    """Base url to use, if None decides based on model name."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        ai21_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "ai21_api_key", "AI21_API_KEY")
+        )
+        values["ai21_api_key"] = ai21_api_key
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling AI21 API."""
+        return {
+            "temperature": self.temperature,
+            "maxTokens": self.maxTokens,
+            "minTokens": self.minTokens,
+            "topP": self.topP,
+            "presencePenalty": self.presencePenalty.dict(),
+            "countPenalty": self.countPenalty.dict(),
+            "frequencyPenalty": self.frequencyPenalty.dict(),
+            "numResults": self.numResults,
+            "logitBias": self.logitBias,
+        }
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model": self.model}, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "ai21"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to AI21's complete endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = ai21("Tell me a joke.")
+        """
+        if self.stop is not None and stop is not None:
+            raise ValueError("`stop` found in both the input and default params.")
+        elif self.stop is not None:
+            stop = self.stop
+        elif stop is None:
+            stop = []
+        if self.base_url is not None:
+            base_url = self.base_url
+        else:
+            if self.model in ("j1-grande-instruct",):
+                base_url = "https://api.ai21.com/studio/v1/experimental"
+            else:
+                base_url = "https://api.ai21.com/studio/v1"
+        params = {**self._default_params, **kwargs}
+        self.ai21_api_key = cast(SecretStr, self.ai21_api_key)
+        response = requests.post(
+            url=f"{base_url}/{self.model}/complete",
+            headers={"Authorization": f"Bearer {self.ai21_api_key.get_secret_value()}"},
+            json={"prompt": prompt, "stopSequences": stop, **params},
+        )
+        if response.status_code != 200:
+            optional_detail = response.json().get("error")
+            raise ValueError(
+                f"AI21 /complete call failed with status code {response.status_code}."
+                f" Details: {optional_detail}"
+            )
+        response_json = response.json()
+        return response_json["completions"][0]["data"]["text"]
diff --git a/llm/Lib/site-packages/langchain_community/llms/aleph_alpha.py b/llm/Lib/site-packages/langchain_community/llms/aleph_alpha.py
new file mode 100644
index 0000000000000000000000000000000000000000..be24b919a95b684f3c70b4d82d5a6b05ef7f8dc6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/aleph_alpha.py
@@ -0,0 +1,287 @@
+from typing import Any, Dict, List, Optional, Sequence
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+
+class AlephAlpha(LLM):
+    """Aleph Alpha large language models.
+
+    To use, you should have the ``aleph_alpha_client`` python package installed, and the
+    environment variable ``ALEPH_ALPHA_API_KEY`` set with your API key, or pass
+    it as a named parameter to the constructor.
+
+    Parameters are explained more in depth here:
+    https://github.com/Aleph-Alpha/aleph-alpha-client/blob/c14b7dd2b4325c7da0d6a119f6e76385800e097b/aleph_alpha_client/completion.py#L10
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import AlephAlpha
+            aleph_alpha = AlephAlpha(aleph_alpha_api_key="my-api-key")
+    """
+
+    client: Any  #: :meta private:
+    model: Optional[str] = "luminous-base"
+    """Model name to use."""
+
+    maximum_tokens: int = 64
+    """The maximum number of tokens to be generated."""
+
+    temperature: float = 0.0
+    """A non-negative float that tunes the degree of randomness in generation."""
+
+    top_k: int = 0
+    """Number of most likely tokens to consider at each step."""
+
+    top_p: float = 0.0
+    """Total probability mass of tokens to consider at each step."""
+
+    presence_penalty: float = 0.0
+    """Penalizes repeated tokens."""
+
+    frequency_penalty: float = 0.0
+    """Penalizes repeated tokens according to frequency."""
+
+    repetition_penalties_include_prompt: Optional[bool] = False
+    """Flag deciding whether presence penalty or frequency penalty are
+    updated from the prompt."""
+
+    use_multiplicative_presence_penalty: Optional[bool] = False
+    """Flag deciding whether presence penalty is applied
+    multiplicatively (True) or additively (False)."""
+
+    penalty_bias: Optional[str] = None
+    """Penalty bias for the completion."""
+
+    penalty_exceptions: Optional[List[str]] = None
+    """List of strings that may be generated without penalty,
+    regardless of other penalty settings"""
+
+    penalty_exceptions_include_stop_sequences: Optional[bool] = None
+    """Should stop_sequences be included in penalty_exceptions."""
+
+    best_of: Optional[int] = None
+    """returns the one with the "best of" results
+    (highest log probability per token)
+    """
+
+    n: int = 1
+    """How many completions to generate for each prompt."""
+
+    logit_bias: Optional[Dict[int, float]] = None
+    """The logit bias allows to influence the likelihood of generating tokens."""
+
+    log_probs: Optional[int] = None
+    """Number of top log probabilities to be returned for each generated token."""
+
+    tokens: Optional[bool] = False
+    """return tokens of completion."""
+
+    disable_optimizations: Optional[bool] = False
+
+    minimum_tokens: Optional[int] = 0
+    """Generate at least this number of tokens."""
+
+    echo: bool = False
+    """Echo the prompt in the completion."""
+
+    use_multiplicative_frequency_penalty: bool = False
+
+    sequence_penalty: float = 0.0
+
+    sequence_penalty_min_length: int = 2
+
+    use_multiplicative_sequence_penalty: bool = False
+
+    completion_bias_inclusion: Optional[Sequence[str]] = None
+
+    completion_bias_inclusion_first_token_only: bool = False
+
+    completion_bias_exclusion: Optional[Sequence[str]] = None
+
+    completion_bias_exclusion_first_token_only: bool = False
+    """Only consider the first token for the completion_bias_exclusion."""
+
+    contextual_control_threshold: Optional[float] = None
+    """If set to None, attention control parameters only apply to those tokens that have
+    explicitly been set in the request.
+    If set to a non-None value, control parameters are also applied to similar tokens.
+    """
+
+    control_log_additive: Optional[bool] = True
+    """True: apply control by adding the log(control_factor) to attention scores.
+    False: (attention_scores - - attention_scores.min(-1)) * control_factor
+    """
+
+    repetition_penalties_include_completion: bool = True
+    """Flag deciding whether presence penalty or frequency penalty
+    are updated from the completion."""
+
+    raw_completion: bool = False
+    """Force the raw completion of the model to be returned."""
+
+    stop_sequences: Optional[List[str]] = None
+    """Stop sequences to use."""
+
+    # Client params
+    aleph_alpha_api_key: Optional[str] = None
+    """API key for Aleph Alpha API."""
+    host: str = "https://api.aleph-alpha.com"
+    """The hostname of the API host. 
+    The default one is "https://api.aleph-alpha.com")"""
+    hosting: Optional[str] = None
+    """Determines in which datacenters the request may be processed.
+    You can either set the parameter to "aleph-alpha" or omit it (defaulting to None).
+    Not setting this value, or setting it to None, gives us maximal 
+    flexibility in processing your request in our
+    own datacenters and on servers hosted with other providers. 
+    Choose this option for maximal availability.
+    Setting it to "aleph-alpha" allows us to only process the 
+    request in our own datacenters.
+    Choose this option for maximal data privacy."""
+    request_timeout_seconds: int = 305
+    """Client timeout that will be set for HTTP requests in the 
+    `requests` library's API calls.
+    Server will close all requests after 300 seconds with an internal server error."""
+    total_retries: int = 8
+    """The number of retries made in case requests fail with certain retryable 
+    status codes. If the last
+    retry fails a corresponding exception is raised. Note, that between retries
+    an exponential backoff
+    is applied, starting with 0.5 s after the first retry and doubling for
+    each retry made. So with the
+    default setting of 8 retries a total wait time of 63.5 s is added 
+    between the retries."""
+    nice: bool = False
+    """Setting this to True, will signal to the API that you intend to be 
+    nice to other users
+    by de-prioritizing your request below concurrent ones."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["aleph_alpha_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "aleph_alpha_api_key", "ALEPH_ALPHA_API_KEY")
+        )
+        try:
+            from aleph_alpha_client import Client
+
+            values["client"] = Client(
+                token=values["aleph_alpha_api_key"].get_secret_value(),
+                host=values["host"],
+                hosting=values["hosting"],
+                request_timeout_seconds=values["request_timeout_seconds"],
+                total_retries=values["total_retries"],
+                nice=values["nice"],
+            )
+        except ImportError:
+            raise ImportError(
+                "Could not import aleph_alpha_client python package. "
+                "Please install it with `pip install aleph_alpha_client`."
+            )
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling the Aleph Alpha API."""
+        return {
+            "maximum_tokens": self.maximum_tokens,
+            "temperature": self.temperature,
+            "top_k": self.top_k,
+            "top_p": self.top_p,
+            "presence_penalty": self.presence_penalty,
+            "frequency_penalty": self.frequency_penalty,
+            "n": self.n,
+            "repetition_penalties_include_prompt": self.repetition_penalties_include_prompt,  # noqa: E501
+            "use_multiplicative_presence_penalty": self.use_multiplicative_presence_penalty,  # noqa: E501
+            "penalty_bias": self.penalty_bias,
+            "penalty_exceptions": self.penalty_exceptions,
+            "penalty_exceptions_include_stop_sequences": self.penalty_exceptions_include_stop_sequences,  # noqa: E501
+            "best_of": self.best_of,
+            "logit_bias": self.logit_bias,
+            "log_probs": self.log_probs,
+            "tokens": self.tokens,
+            "disable_optimizations": self.disable_optimizations,
+            "minimum_tokens": self.minimum_tokens,
+            "echo": self.echo,
+            "use_multiplicative_frequency_penalty": self.use_multiplicative_frequency_penalty,  # noqa: E501
+            "sequence_penalty": self.sequence_penalty,
+            "sequence_penalty_min_length": self.sequence_penalty_min_length,
+            "use_multiplicative_sequence_penalty": self.use_multiplicative_sequence_penalty,  # noqa: E501
+            "completion_bias_inclusion": self.completion_bias_inclusion,
+            "completion_bias_inclusion_first_token_only": self.completion_bias_inclusion_first_token_only,  # noqa: E501
+            "completion_bias_exclusion": self.completion_bias_exclusion,
+            "completion_bias_exclusion_first_token_only": self.completion_bias_exclusion_first_token_only,  # noqa: E501
+            "contextual_control_threshold": self.contextual_control_threshold,
+            "control_log_additive": self.control_log_additive,
+            "repetition_penalties_include_completion": self.repetition_penalties_include_completion,  # noqa: E501
+            "raw_completion": self.raw_completion,
+        }
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model": self.model}, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "aleph_alpha"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Aleph Alpha's completion endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = aleph_alpha("Tell me a joke.")
+        """
+        from aleph_alpha_client import CompletionRequest, Prompt
+
+        params = self._default_params
+        if self.stop_sequences is not None and stop is not None:
+            raise ValueError(
+                "stop sequences found in both the input and default params."
+            )
+        elif self.stop_sequences is not None:
+            params["stop_sequences"] = self.stop_sequences
+        else:
+            params["stop_sequences"] = stop
+        params = {**params, **kwargs}
+        request = CompletionRequest(prompt=Prompt.from_text(prompt), **params)
+        response = self.client.complete(model=self.model, request=request)
+        text = response.completions[0].completion
+        # If stop tokens are provided, Aleph Alpha's endpoint returns them.
+        # In order to make this consistent with other endpoints, we strip them.
+        if stop is not None or self.stop_sequences is not None:
+            text = enforce_stop_tokens(text, params["stop_sequences"])
+        return text
+
+
+if __name__ == "__main__":
+    aa = AlephAlpha()
+
+    print(aa("How are you?"))  # noqa: T201
diff --git a/llm/Lib/site-packages/langchain_community/llms/amazon_api_gateway.py b/llm/Lib/site-packages/langchain_community/llms/amazon_api_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..be2266a331cebb960160a4c236050fe704d758f1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/amazon_api_gateway.py
@@ -0,0 +1,104 @@
+from typing import Any, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+
+class ContentHandlerAmazonAPIGateway:
+    """Adapter to prepare the inputs from Langchain to a format
+    that LLM model expects.
+
+    It also provides helper function to extract
+    the generated text from the model response."""
+
+    @classmethod
+    def transform_input(
+        cls, prompt: str, model_kwargs: Dict[str, Any]
+    ) -> Dict[str, Any]:
+        return {"inputs": prompt, "parameters": model_kwargs}
+
+    @classmethod
+    def transform_output(cls, response: Any) -> str:
+        return response.json()[0]["generated_text"]
+
+
+class AmazonAPIGateway(LLM):
+    """Amazon API Gateway to access LLM models hosted on AWS."""
+
+    api_url: str
+    """API Gateway URL"""
+
+    headers: Optional[Dict] = None
+    """API Gateway HTTP Headers to send, e.g. for authentication"""
+
+    model_kwargs: Optional[Dict] = None
+    """Keyword arguments to pass to the model."""
+
+    content_handler: ContentHandlerAmazonAPIGateway = ContentHandlerAmazonAPIGateway()
+    """The content handler class that provides an input and
+    output transform functions to handle formats between LLM
+    and the endpoint.
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            **{"api_url": self.api_url, "headers": self.headers},
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "amazon_api_gateway"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Amazon API Gateway model.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = se("Tell me a joke.")
+        """
+        _model_kwargs = self.model_kwargs or {}
+        payload = self.content_handler.transform_input(prompt, _model_kwargs)
+
+        try:
+            response = requests.post(
+                self.api_url,
+                headers=self.headers,
+                json=payload,
+            )
+            text = self.content_handler.transform_output(response)
+
+        except Exception as error:
+            raise ValueError(f"Error raised by the service: {error}")
+
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/anthropic.py b/llm/Lib/site-packages/langchain_community/llms/anthropic.py
new file mode 100644
index 0000000000000000000000000000000000000000..13d8ff81e73f2ccac6f930a5abc443bde237c456
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/anthropic.py
@@ -0,0 +1,362 @@
+import re
+import warnings
+from typing import (
+    Any,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+)
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.prompt_values import PromptValue
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import (
+    check_package_version,
+    get_from_dict_or_env,
+    get_pydantic_field_names,
+)
+from langchain_core.utils.utils import build_extra_kwargs, convert_to_secret_str
+
+
+class _AnthropicCommon(BaseLanguageModel):
+    client: Any = None  #: :meta private:
+    async_client: Any = None  #: :meta private:
+    model: str = Field(default="claude-2", alias="model_name")
+    """Model name to use."""
+
+    max_tokens_to_sample: int = Field(default=256, alias="max_tokens")
+    """Denotes the number of tokens to predict per generation."""
+
+    temperature: Optional[float] = None
+    """A non-negative float that tunes the degree of randomness in generation."""
+
+    top_k: Optional[int] = None
+    """Number of most likely tokens to consider at each step."""
+
+    top_p: Optional[float] = None
+    """Total probability mass of tokens to consider at each step."""
+
+    streaming: bool = False
+    """Whether to stream the results."""
+
+    default_request_timeout: Optional[float] = None
+    """Timeout for requests to Anthropic Completion API. Default is 600 seconds."""
+
+    max_retries: int = 2
+    """Number of retries allowed for requests sent to the Anthropic Completion API."""
+
+    anthropic_api_url: Optional[str] = None
+
+    anthropic_api_key: Optional[SecretStr] = None
+
+    HUMAN_PROMPT: Optional[str] = None
+    AI_PROMPT: Optional[str] = None
+    count_tokens: Optional[Callable[[str], int]] = None
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict) -> Dict:
+        extra = values.get("model_kwargs", {})
+        all_required_field_names = get_pydantic_field_names(cls)
+        values["model_kwargs"] = build_extra_kwargs(
+            extra, values, all_required_field_names
+        )
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["anthropic_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "anthropic_api_key", "ANTHROPIC_API_KEY")
+        )
+        # Get custom api url from environment.
+        values["anthropic_api_url"] = get_from_dict_or_env(
+            values,
+            "anthropic_api_url",
+            "ANTHROPIC_API_URL",
+            default="https://api.anthropic.com",
+        )
+
+        try:
+            import anthropic
+
+            check_package_version("anthropic", gte_version="0.3")
+            values["client"] = anthropic.Anthropic(
+                base_url=values["anthropic_api_url"],
+                api_key=values["anthropic_api_key"].get_secret_value(),
+                timeout=values["default_request_timeout"],
+                max_retries=values["max_retries"],
+            )
+            values["async_client"] = anthropic.AsyncAnthropic(
+                base_url=values["anthropic_api_url"],
+                api_key=values["anthropic_api_key"].get_secret_value(),
+                timeout=values["default_request_timeout"],
+                max_retries=values["max_retries"],
+            )
+            values["HUMAN_PROMPT"] = anthropic.HUMAN_PROMPT
+            values["AI_PROMPT"] = anthropic.AI_PROMPT
+            values["count_tokens"] = values["client"].count_tokens
+
+        except ImportError:
+            raise ImportError(
+                "Could not import anthropic python package. "
+                "Please it install it with `pip install anthropic`."
+            )
+        return values
+
+    @property
+    def _default_params(self) -> Mapping[str, Any]:
+        """Get the default parameters for calling Anthropic API."""
+        d = {
+            "max_tokens_to_sample": self.max_tokens_to_sample,
+            "model": self.model,
+        }
+        if self.temperature is not None:
+            d["temperature"] = self.temperature
+        if self.top_k is not None:
+            d["top_k"] = self.top_k
+        if self.top_p is not None:
+            d["top_p"] = self.top_p
+        return {**d, **self.model_kwargs}
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {**{}, **self._default_params}
+
+    def _get_anthropic_stop(self, stop: Optional[List[str]] = None) -> List[str]:
+        if not self.HUMAN_PROMPT or not self.AI_PROMPT:
+            raise NameError("Please ensure the anthropic package is loaded")
+
+        if stop is None:
+            stop = []
+
+        # Never want model to invent new turns of Human / Assistant dialog.
+        stop.extend([self.HUMAN_PROMPT])
+
+        return stop
+
+
+@deprecated(
+    since="0.0.28",
+    removal="0.2",
+    alternative_import="langchain_anthropic.AnthropicLLM",
+)
+class Anthropic(LLM, _AnthropicCommon):
+    """Anthropic large language models.
+
+    To use, you should have the ``anthropic`` python package installed, and the
+    environment variable ``ANTHROPIC_API_KEY`` set with your API key, or pass
+    it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            import anthropic
+            from langchain_community.llms import Anthropic
+
+            model = Anthropic(model="<model_name>", anthropic_api_key="my-api-key")
+
+            # Simplest invocation, automatically wrapped with HUMAN_PROMPT
+            # and AI_PROMPT.
+            response = model("What are the biggest risks facing humanity?")
+
+            # Or if you want to use the chat mode, build a few-shot-prompt, or
+            # put words in the Assistant's mouth, use HUMAN_PROMPT and AI_PROMPT:
+            raw_prompt = "What are the biggest risks facing humanity?"
+            prompt = f"{anthropic.HUMAN_PROMPT} {prompt}{anthropic.AI_PROMPT}"
+            response = model(prompt)
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+        arbitrary_types_allowed = True
+
+    @root_validator()
+    def raise_warning(cls, values: Dict) -> Dict:
+        """Raise warning that this class is deprecated."""
+        warnings.warn(
+            "This Anthropic LLM is deprecated. "
+            "Please use `from langchain_community.chat_models import ChatAnthropic` "
+            "instead"
+        )
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "anthropic-llm"
+
+    def _wrap_prompt(self, prompt: str) -> str:
+        if not self.HUMAN_PROMPT or not self.AI_PROMPT:
+            raise NameError("Please ensure the anthropic package is loaded")
+
+        if prompt.startswith(self.HUMAN_PROMPT):
+            return prompt  # Already wrapped.
+
+        # Guard against common errors in specifying wrong number of newlines.
+        corrected_prompt, n_subs = re.subn(r"^\n*Human:", self.HUMAN_PROMPT, prompt)
+        if n_subs == 1:
+            return corrected_prompt
+
+        # As a last resort, wrap the prompt ourselves to emulate instruct-style.
+        return f"{self.HUMAN_PROMPT} {prompt}{self.AI_PROMPT} Sure, here you go:\n"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        r"""Call out to Anthropic's completion endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                prompt = "What are the biggest risks facing humanity?"
+                prompt = f"\n\nHuman: {prompt}\n\nAssistant:"
+                response = model(prompt)
+
+        """
+        if self.streaming:
+            completion = ""
+            for chunk in self._stream(
+                prompt=prompt, stop=stop, run_manager=run_manager, **kwargs
+            ):
+                completion += chunk.text
+            return completion
+
+        stop = self._get_anthropic_stop(stop)
+        params = {**self._default_params, **kwargs}
+        response = self.client.completions.create(
+            prompt=self._wrap_prompt(prompt),
+            stop_sequences=stop,
+            **params,
+        )
+        return response.completion
+
+    def convert_prompt(self, prompt: PromptValue) -> str:
+        return self._wrap_prompt(prompt.to_string())
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Anthropic's completion endpoint asynchronously."""
+        if self.streaming:
+            completion = ""
+            async for chunk in self._astream(
+                prompt=prompt, stop=stop, run_manager=run_manager, **kwargs
+            ):
+                completion += chunk.text
+            return completion
+
+        stop = self._get_anthropic_stop(stop)
+        params = {**self._default_params, **kwargs}
+
+        response = await self.async_client.completions.create(
+            prompt=self._wrap_prompt(prompt),
+            stop_sequences=stop,
+            **params,
+        )
+        return response.completion
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        r"""Call Anthropic completion_stream and return the resulting generator.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+        Returns:
+            A generator representing the stream of tokens from Anthropic.
+        Example:
+            .. code-block:: python
+
+                prompt = "Write a poem about a stream."
+                prompt = f"\n\nHuman: {prompt}\n\nAssistant:"
+                generator = anthropic.stream(prompt)
+                for token in generator:
+                    yield token
+        """
+        stop = self._get_anthropic_stop(stop)
+        params = {**self._default_params, **kwargs}
+
+        for token in self.client.completions.create(
+            prompt=self._wrap_prompt(prompt), stop_sequences=stop, stream=True, **params
+        ):
+            chunk = GenerationChunk(text=token.completion)
+            if run_manager:
+                run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+            yield chunk
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        r"""Call Anthropic completion_stream and return the resulting generator.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+        Returns:
+            A generator representing the stream of tokens from Anthropic.
+        Example:
+            .. code-block:: python
+                prompt = "Write a poem about a stream."
+                prompt = f"\n\nHuman: {prompt}\n\nAssistant:"
+                generator = anthropic.stream(prompt)
+                for token in generator:
+                    yield token
+        """
+        stop = self._get_anthropic_stop(stop)
+        params = {**self._default_params, **kwargs}
+
+        async for token in await self.async_client.completions.create(
+            prompt=self._wrap_prompt(prompt),
+            stop_sequences=stop,
+            stream=True,
+            **params,
+        ):
+            chunk = GenerationChunk(text=token.completion)
+            if run_manager:
+                await run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+            yield chunk
+
+    def get_num_tokens(self, text: str) -> int:
+        """Calculate number of tokens."""
+        if not self.count_tokens:
+            raise NameError("Please ensure the anthropic package is loaded")
+        return self.count_tokens(text)
diff --git a/llm/Lib/site-packages/langchain_community/llms/anyscale.py b/llm/Lib/site-packages/langchain_community/llms/anyscale.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d0dd45a4a293e4f48ab6f66acaa2f5daccfb05f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/anyscale.py
@@ -0,0 +1,318 @@
+"""Wrapper around Anyscale Endpoint"""
+from typing import (
+    Any,
+    Dict,
+    List,
+    Mapping,
+    Optional,
+    Set,
+)
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.outputs import Generation, GenerationChunk, LLMResult
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.llms.openai import (
+    BaseOpenAI,
+    acompletion_with_retry,
+    completion_with_retry,
+)
+from langchain_community.utils.openai import is_openai_v1
+
+DEFAULT_BASE_URL = "https://api.endpoints.anyscale.com/v1"
+DEFAULT_MODEL = "mistralai/Mixtral-8x7B-Instruct-v0.1"
+
+
+def update_token_usage(
+    keys: Set[str], response: Dict[str, Any], token_usage: Dict[str, Any]
+) -> None:
+    """Update token usage."""
+    _keys_to_use = keys.intersection(response["usage"])
+    for _key in _keys_to_use:
+        if _key not in token_usage:
+            token_usage[_key] = response["usage"][_key]
+        else:
+            token_usage[_key] += response["usage"][_key]
+
+
+def create_llm_result(
+    choices: Any, prompts: List[str], token_usage: Dict[str, int], model_name: str
+) -> LLMResult:
+    """Create the LLMResult from the choices and prompts."""
+    generations = []
+    for i, _ in enumerate(prompts):
+        choice = choices[i]
+        generations.append(
+            [
+                Generation(
+                    text=choice["message"]["content"],
+                    generation_info=dict(
+                        finish_reason=choice.get("finish_reason"),
+                        logprobs=choice.get("logprobs"),
+                    ),
+                )
+            ]
+        )
+    llm_output = {"token_usage": token_usage, "model_name": model_name}
+    return LLMResult(generations=generations, llm_output=llm_output)
+
+
+class Anyscale(BaseOpenAI):
+    """Anyscale large language models.
+
+    To use, you should have the environment variable ``ANYSCALE_API_KEY``set with your
+    Anyscale Endpoint, or pass it as a named parameter to the constructor.
+    To use with Anyscale Private Endpoint, please also set ``ANYSCALE_BASE_URL``.
+
+    Example:
+        .. code-block:: python
+            from langchain.llms import Anyscale
+            anyscalellm = Anyscale(anyscale_api_key="ANYSCALE_API_KEY")
+            # To leverage Ray for parallel processing
+            @ray.remote(num_cpus=1)
+            def send_query(llm, text):
+                resp = llm(text)
+                return resp
+            futures = [send_query.remote(anyscalellm, text) for text in texts]
+            results = ray.get(futures)
+    """
+
+    """Key word arguments to pass to the model."""
+    anyscale_api_base: str = Field(default=DEFAULT_BASE_URL)
+    anyscale_api_key: SecretStr = Field(default=None)
+    model_name: str = Field(default=DEFAULT_MODEL)
+
+    prefix_messages: List = Field(default_factory=list)
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["anyscale_api_base"] = get_from_dict_or_env(
+            values,
+            "anyscale_api_base",
+            "ANYSCALE_API_BASE",
+            default=DEFAULT_BASE_URL,
+        )
+        values["anyscale_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "anyscale_api_key", "ANYSCALE_API_KEY")
+        )
+        values["model_name"] = get_from_dict_or_env(
+            values,
+            "model_name",
+            "MODEL_NAME",
+            default=DEFAULT_MODEL,
+        )
+
+        try:
+            import openai
+
+            if is_openai_v1():
+                client_params = {
+                    "api_key": values["anyscale_api_key"].get_secret_value(),
+                    "base_url": values["anyscale_api_base"],
+                    # To do: future support
+                    # "organization": values["openai_organization"],
+                    # "timeout": values["request_timeout"],
+                    # "max_retries": values["max_retries"],
+                    # "default_headers": values["default_headers"],
+                    # "default_query": values["default_query"],
+                    # "http_client": values["http_client"],
+                }
+                if not values.get("client"):
+                    values["client"] = openai.OpenAI(**client_params).completions
+                if not values.get("async_client"):
+                    values["async_client"] = openai.AsyncOpenAI(
+                        **client_params
+                    ).completions
+            else:
+                values["openai_api_base"] = values["anyscale_api_base"]
+                values["openai_api_key"] = values["anyscale_api_key"].get_secret_value()
+                values["client"] = openai.Completion
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+        if values["streaming"] and values["n"] > 1:
+            raise ValueError("Cannot stream results when n > 1.")
+        if values["streaming"] and values["best_of"] > 1:
+            raise ValueError("Cannot stream results when best_of > 1.")
+
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"model_name": self.model_name},
+            **super()._identifying_params,
+        }
+
+    @property
+    def _invocation_params(self) -> Dict[str, Any]:
+        """Get the parameters used to invoke the model."""
+        openai_creds: Dict[str, Any] = {
+            "model": self.model_name,
+        }
+        if not is_openai_v1():
+            openai_creds.update(
+                {
+                    "api_key": self.anyscale_api_key.get_secret_value(),
+                    "api_base": self.anyscale_api_base,
+                }
+            )
+        return {**openai_creds, **super()._invocation_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "Anyscale LLM"
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Call out to OpenAI's endpoint with k unique prompts.
+
+        Args:
+            prompts: The prompts to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The full LLM output.
+
+        Example:
+            .. code-block:: python
+
+                response = openai.generate(["Tell me a joke."])
+        """
+        # TODO: write a unit test for this
+        params = self._invocation_params
+        params = {**params, **kwargs}
+        sub_prompts = self.get_sub_prompts(params, prompts, stop)
+        choices = []
+        token_usage: Dict[str, int] = {}
+        # Get the token usage from the response.
+        # Includes prompt, completion, and total tokens used.
+        _keys = {"completion_tokens", "prompt_tokens", "total_tokens"}
+        system_fingerprint: Optional[str] = None
+        for _prompts in sub_prompts:
+            if self.streaming:
+                if len(_prompts) > 1:
+                    raise ValueError("Cannot stream results with multiple prompts.")
+
+                generation: Optional[GenerationChunk] = None
+                for chunk in self._stream(_prompts[0], stop, run_manager, **kwargs):
+                    if generation is None:
+                        generation = chunk
+                    else:
+                        generation += chunk
+                assert generation is not None
+                choices.append(
+                    {
+                        "text": generation.text,
+                        "finish_reason": generation.generation_info.get("finish_reason")
+                        if generation.generation_info
+                        else None,
+                        "logprobs": generation.generation_info.get("logprobs")
+                        if generation.generation_info
+                        else None,
+                    }
+                )
+            else:
+                response = completion_with_retry(
+                    ## THis is the ONLY change from BaseOpenAI()._generate()
+                    self,
+                    prompt=_prompts[0],
+                    run_manager=run_manager,
+                    **params,
+                )
+                if not isinstance(response, dict):
+                    # V1 client returns the response in an PyDantic object instead of
+                    # dict. For the transition period, we deep convert it to dict.
+                    response = response.dict()
+
+                choices.extend(response["choices"])
+                update_token_usage(_keys, response, token_usage)
+                if not system_fingerprint:
+                    system_fingerprint = response.get("system_fingerprint")
+        return self.create_llm_result(
+            choices,
+            prompts,
+            params,
+            token_usage,
+            system_fingerprint=system_fingerprint,
+        )
+
+    async def _agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Call out to OpenAI's endpoint async with k unique prompts."""
+        params = self._invocation_params
+        params = {**params, **kwargs}
+        sub_prompts = self.get_sub_prompts(params, prompts, stop)
+        choices = []
+        token_usage: Dict[str, int] = {}
+        # Get the token usage from the response.
+        # Includes prompt, completion, and total tokens used.
+        _keys = {"completion_tokens", "prompt_tokens", "total_tokens"}
+        system_fingerprint: Optional[str] = None
+        for _prompts in sub_prompts:
+            if self.streaming:
+                if len(_prompts) > 1:
+                    raise ValueError("Cannot stream results with multiple prompts.")
+
+                generation: Optional[GenerationChunk] = None
+                async for chunk in self._astream(
+                    _prompts[0], stop, run_manager, **kwargs
+                ):
+                    if generation is None:
+                        generation = chunk
+                    else:
+                        generation += chunk
+                assert generation is not None
+                choices.append(
+                    {
+                        "text": generation.text,
+                        "finish_reason": generation.generation_info.get("finish_reason")
+                        if generation.generation_info
+                        else None,
+                        "logprobs": generation.generation_info.get("logprobs")
+                        if generation.generation_info
+                        else None,
+                    }
+                )
+            else:
+                response = await acompletion_with_retry(
+                    ## THis is the ONLY change from BaseOpenAI()._agenerate()
+                    self,
+                    prompt=_prompts[0],
+                    run_manager=run_manager,
+                    **params,
+                )
+                if not isinstance(response, dict):
+                    response = response.dict()
+                choices.extend(response["choices"])
+                update_token_usage(_keys, response, token_usage)
+        return self.create_llm_result(
+            choices,
+            prompts,
+            params,
+            token_usage,
+            system_fingerprint=system_fingerprint,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/llms/aphrodite.py b/llm/Lib/site-packages/langchain_community/llms/aphrodite.py
new file mode 100644
index 0000000000000000000000000000000000000000..11720a088f2302f23641c5187610421b139ad3f3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/aphrodite.py
@@ -0,0 +1,250 @@
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models import BaseLLM
+from langchain_core.outputs import Generation, LLMResult
+from langchain_core.pydantic_v1 import Field, root_validator
+
+
+class Aphrodite(BaseLLM):
+    """Aphrodite language model."""
+
+    model: str = ""
+    """The name or path of a HuggingFace Transformers model."""
+
+    tensor_parallel_size: Optional[int] = 1
+    """The number of GPUs to use for distributed execution with tensor parallelism."""
+
+    trust_remote_code: Optional[bool] = False
+    """Trust remote code (e.g., from HuggingFace) when downloading the model 
+    and tokenizer."""
+
+    n: int = 1
+    """Number of output sequences to return for the given prompt."""
+
+    best_of: Optional[int] = None
+    """Number of output sequences that are generated from the prompt.
+    From these `best_of` sequences, the top `n` sequences are returned.
+    `best_of` must be >= `n`. This is treated as the beam width when
+    `use_beam_search` is True. By default, `best_of` is set to `n`."""
+
+    presence_penalty: float = 0.0
+    """Float that penalizes new tokens based on whether they appear in the 
+    generated text so far. Values > 0 encourage the model to generate new
+    tokens, while values < 0 encourage the model to repeat tokens."""
+
+    frequency_penalty: float = 0.0
+    """Float that penalizes new tokens based on their frequency in the 
+    generated text so far. Applied additively to the logits."""
+
+    repetition_penalty: float = 1.0
+    """Float that penalizes new tokens based on their frequency in the
+    generated text so far. Applied multiplicatively to the logits."""
+
+    temperature: float = 1.0
+    """Float that controls the randomness of the sampling. Lower values
+    make the model more deterministic, while higher values make the model
+    more random. Zero is equivalent to greedy sampling."""
+
+    top_p: float = 1.0
+    """Float that controls the cumulative probability of the top tokens to consider.
+    Must be in (0, 1]. Set to 1.0 to consider all tokens."""
+
+    top_k: int = -1
+    """Integer that controls the number of top tokens to consider. Set to -1 to
+    consider all tokens (disabled)."""
+
+    top_a: float = 0.0
+    """Float that controls the cutoff for Top-A sampling. Exact cutoff is
+    top_a*max_prob**2. Must be in [0,inf], 0 to disable."""
+
+    min_p: float = 0.0
+    """Float that controls the cutoff for min-p sampling. Exact cutoff is
+    min_p*max_prob. Must be in [0,1], 0 to disable."""
+
+    tfs: float = 1.0
+    """Float that controls the cumulative approximate curvature of the
+    distribution to retain for Tail Free Sampling. Must be in (0, 1].
+    Set to 1.0 to disable."""
+
+    eta_cutoff: float = 0.0
+    """Float that controls the cutoff threshold for Eta sampling
+    (a form of entropy adaptive truncation sampling). Threshold is
+    calculated as `min(eta, sqrt(eta)*entropy(probs)). Specified
+    in units of 1e-4. Set to 0 to disable."""
+
+    epsilon_cutoff: float = 0.0
+    """Float that controls the cutoff threshold for Epsilon sampling
+    (simple probability threshold truncation). Specified in units of
+    1e-4. Set to 0 to disable."""
+
+    typical_p: float = 1.0
+    """Float that controls the cumulative probability of tokens closest
+    in surprise to the expected surprise to consider. Must be in (0, 1].
+    Set to 1 to disable."""
+
+    mirostat_mode: int = 0
+    """The mirostat mode to use. 0 for no mirostat, 2 for mirostat v2.
+    Mode 1 is not supported."""
+
+    mirostat_tau: float = 0.0
+    """The target 'surprisal' that mirostat works towards. Range [0, inf)."""
+
+    use_beam_search: bool = False
+    """Whether to use beam search instead of sampling."""
+
+    length_penalty: float = 1.0
+    """Float that penalizes sequences based on their length. Used only
+    when `use_beam_search` is True."""
+
+    early_stopping: bool = False
+    """Controls the stopping condition for beam search. It accepts the
+    following values: `True`, where the generation stops as soon as there
+    are `best_of` complete candidates; `False`, where a heuristic is applied
+    to the generation stops when it is very unlikely to find better candidates;
+    `never`, where the beam search procedure only stops where there cannot be
+    better candidates (canonical beam search algorithm)."""
+
+    stop: Optional[List[str]] = None
+    """List of strings that stop the generation when they are generated.
+    The returned output will not contain the stop tokens."""
+
+    stop_token_ids: Optional[List[int]] = None
+    """List of tokens that stop the generation when they are generated.
+    The returned output will contain the stop tokens unless the stop tokens
+    are special tokens."""
+
+    ignore_eos: bool = False
+    """Whether to ignore the EOS token and continue generating tokens after 
+    the EOS token is generated."""
+
+    max_tokens: int = 512
+    """Maximum number of tokens to generate per output sequence."""
+
+    logprobs: Optional[int] = None
+    """Number of log probabilities to return per output token."""
+
+    prompt_logprobs: Optional[int] = None
+    """Number of log probabilities to return per prompt token."""
+
+    custom_token_bans: Optional[List[int]] = None
+    """List of token IDs to ban from generating."""
+
+    skip_special_tokens: bool = True
+    """Whether to skip special tokens in the output. Defaults to True."""
+
+    spaces_between_special_tokens: bool = True
+    """Whether to add spaces between special tokens in the output.
+    Defaults to True."""
+
+    logit_bias: Optional[Dict[str, float]] = None
+    """List of LogitsProcessors to change the probability of token
+    prediction at runtime."""
+
+    dtype: str = "auto"
+    """The data type for the model weights and activations."""
+
+    download_dir: Optional[str] = None
+    """Directory to download and load the weights. (Default to the default 
+    cache dir of huggingface)"""
+
+    quantization: Optional[str] = None
+    """Quantization mode to use. Can be one of `awq` or `gptq`."""
+
+    aphrodite_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `aphrodite.LLM` call not explicitly
+    specified."""
+
+    client: Any  #: :meta private:
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that python package exists in environment."""
+
+        try:
+            from aphrodite import LLM as AphroditeModel
+        except ImportError:
+            raise ImportError(
+                "Could not import aphrodite-engine python package. "
+                "Please install it with `pip install aphrodite-engine`."
+            )
+
+        # aphrodite_kwargs = values["aphrodite_kwargs"]
+        # if values.get("quantization"):
+        #     aphrodite_kwargs["quantization"] = values["quantization"]
+
+        values["client"] = AphroditeModel(
+            model=values["model"],
+            tensor_parallel_size=values["tensor_parallel_size"],
+            trust_remote_code=values["trust_remote_code"],
+            dtype=values["dtype"],
+            download_dir=values["download_dir"],
+            **values["aphrodite_kwargs"],
+        )
+
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling aphrodite."""
+        return {
+            "n": self.n,
+            "best_of": self.best_of,
+            "max_tokens": self.max_tokens,
+            "top_k": self.top_k,
+            "top_p": self.top_p,
+            "top_a": self.top_a,
+            "min_p": self.min_p,
+            "temperature": self.temperature,
+            "presence_penalty": self.presence_penalty,
+            "frequency_penalty": self.frequency_penalty,
+            "repetition_penalty": self.repetition_penalty,
+            "tfs": self.tfs,
+            "eta_cutoff": self.eta_cutoff,
+            "epsilon_cutoff": self.epsilon_cutoff,
+            "typical_p": self.typical_p,
+            "mirostat_mode": self.mirostat_mode,
+            "mirostat_tau": self.mirostat_tau,
+            "length_penalty": self.length_penalty,
+            "early_stopping": self.early_stopping,
+            "use_beam_search": self.use_beam_search,
+            "stop": self.stop,
+            "ignore_eos": self.ignore_eos,
+            "logprobs": self.logprobs,
+            "prompt_logprobs": self.prompt_logprobs,
+            "custom_token_bans": self.custom_token_bans,
+            "skip_special_tokens": self.skip_special_tokens,
+            "spaces_between_special_tokens": self.spaces_between_special_tokens,
+            "logit_bias": self.logit_bias,
+        }
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Run the LLM on the given prompt and input."""
+
+        from aphrodite import SamplingParams
+
+        # build sampling parameters
+        params = {**self._default_params, **kwargs, "stop": stop}
+        if "logit_bias" in params:
+            del params["logit_bias"]
+        sampling_params = SamplingParams(**params)
+        # call the model
+        outputs = self.client.generate(prompts, sampling_params)
+
+        generations = []
+        for output in outputs:
+            text = output.outputs[0].text
+            generations.append([Generation(text=text)])
+
+        return LLMResult(generations=generations)
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "aphrodite"
diff --git a/llm/Lib/site-packages/langchain_community/llms/arcee.py b/llm/Lib/site-packages/langchain_community/llms/arcee.py
new file mode 100644
index 0000000000000000000000000000000000000000..cab21c60e681189df6da2ef32c6c565a60ee10da
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/arcee.py
@@ -0,0 +1,147 @@
+from typing import Any, Dict, List, Optional, Union, cast
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.utilities.arcee import ArceeWrapper, DALMFilter
+
+
+class Arcee(LLM):
+    """Arcee's Domain Adapted Language Models (DALMs).
+
+    To use, set the ``ARCEE_API_KEY`` environment variable with your Arcee API key,
+    or pass ``arcee_api_key`` as a named parameter.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Arcee
+
+            arcee = Arcee(
+                model="DALM-PubMed",
+                arcee_api_key="ARCEE-API-KEY"
+            )
+
+            response = arcee("AI-driven music therapy")
+    """
+
+    _client: Optional[ArceeWrapper] = None  #: :meta private:
+    """Arcee _client."""
+
+    arcee_api_key: Union[SecretStr, str, None] = None
+    """Arcee API Key"""
+
+    model: str
+    """Arcee DALM name"""
+
+    arcee_api_url: str = "https://api.arcee.ai"
+    """Arcee API URL"""
+
+    arcee_api_version: str = "v2"
+    """Arcee API Version"""
+
+    arcee_app_url: str = "https://app.arcee.ai"
+    """Arcee App URL"""
+
+    model_id: str = ""
+    """Arcee Model ID"""
+
+    model_kwargs: Optional[Dict[str, Any]] = None
+    """Keyword arguments to pass to the model."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        underscore_attrs_are_private = True
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "arcee"
+
+    def __init__(self, **data: Any) -> None:
+        """Initializes private fields."""
+
+        super().__init__(**data)
+        api_key = cast(SecretStr, self.arcee_api_key)
+        self._client = ArceeWrapper(
+            arcee_api_key=api_key,
+            arcee_api_url=self.arcee_api_url,
+            arcee_api_version=self.arcee_api_version,
+            model_kwargs=self.model_kwargs,
+            model_name=self.model,
+        )
+
+    @root_validator(pre=False)
+    def validate_environments(cls, values: Dict) -> Dict:
+        """Validate Arcee environment variables."""
+
+        # validate env vars
+        values["arcee_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "arcee_api_key",
+                "ARCEE_API_KEY",
+            )
+        )
+
+        values["arcee_api_url"] = get_from_dict_or_env(
+            values,
+            "arcee_api_url",
+            "ARCEE_API_URL",
+        )
+
+        values["arcee_app_url"] = get_from_dict_or_env(
+            values,
+            "arcee_app_url",
+            "ARCEE_APP_URL",
+        )
+
+        values["arcee_api_version"] = get_from_dict_or_env(
+            values,
+            "arcee_api_version",
+            "ARCEE_API_VERSION",
+        )
+
+        # validate model kwargs
+        if values.get("model_kwargs"):
+            kw = values["model_kwargs"]
+
+            # validate size
+            if kw.get("size") is not None:
+                if not kw.get("size") >= 0:
+                    raise ValueError("`size` must be positive")
+
+            # validate filters
+            if kw.get("filters") is not None:
+                if not isinstance(kw.get("filters"), List):
+                    raise ValueError("`filters` must be a list")
+                for f in kw.get("filters"):
+                    DALMFilter(**f)
+        return values
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Generate text from Arcee DALM.
+
+        Args:
+            prompt: Prompt to generate text from.
+            size: The max number of context results to retrieve.
+            Defaults to 3. (Can be less if filters are provided).
+            filters: Filters to apply to the context dataset.
+        """
+
+        try:
+            if not self._client:
+                raise ValueError("Client is not initialized.")
+            return self._client.generate(prompt=prompt, **kwargs)
+        except Exception as e:
+            raise Exception(f"Failed to generate text: {e}") from e
diff --git a/llm/Lib/site-packages/langchain_community/llms/aviary.py b/llm/Lib/site-packages/langchain_community/llms/aviary.py
new file mode 100644
index 0000000000000000000000000000000000000000..60c3794422d199f5bd140a3502ada2663003d1b5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/aviary.py
@@ -0,0 +1,197 @@
+import dataclasses
+import os
+from typing import Any, Dict, List, Mapping, Optional, Union, cast
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+TIMEOUT = 60
+
+
+@dataclasses.dataclass
+class AviaryBackend:
+    """Aviary backend.
+
+    Attributes:
+        backend_url: The URL for the Aviary backend.
+        bearer: The bearer token for the Aviary backend.
+    """
+
+    backend_url: str
+    bearer: str
+
+    def __post_init__(self) -> None:
+        self.header = {"Authorization": self.bearer}
+
+    @classmethod
+    def from_env(cls) -> "AviaryBackend":
+        aviary_url = os.getenv("AVIARY_URL")
+        assert aviary_url, "AVIARY_URL must be set"
+
+        aviary_token = os.getenv("AVIARY_TOKEN", "")
+
+        bearer = f"Bearer {aviary_token}" if aviary_token else ""
+        aviary_url += "/" if not aviary_url.endswith("/") else ""
+
+        return cls(aviary_url, bearer)
+
+
+def get_models() -> List[str]:
+    """List available models"""
+    backend = AviaryBackend.from_env()
+    request_url = backend.backend_url + "-/routes"
+    response = requests.get(request_url, headers=backend.header, timeout=TIMEOUT)
+    try:
+        result = response.json()
+    except requests.JSONDecodeError as e:
+        raise RuntimeError(
+            f"Error decoding JSON from {request_url}. Text response: {response.text}"
+        ) from e
+    result = sorted(
+        [k.lstrip("/").replace("--", "/") for k in result.keys() if "--" in k]
+    )
+    return result
+
+
+def get_completions(
+    model: str,
+    prompt: str,
+    use_prompt_format: bool = True,
+    version: str = "",
+) -> Dict[str, Union[str, float, int]]:
+    """Get completions from Aviary models."""
+
+    backend = AviaryBackend.from_env()
+    url = backend.backend_url + model.replace("/", "--") + "/" + version + "query"
+    response = requests.post(
+        url,
+        headers=backend.header,
+        json={"prompt": prompt, "use_prompt_format": use_prompt_format},
+        timeout=TIMEOUT,
+    )
+    try:
+        return response.json()
+    except requests.JSONDecodeError as e:
+        raise RuntimeError(
+            f"Error decoding JSON from {url}. Text response: {response.text}"
+        ) from e
+
+
+class Aviary(LLM):
+    """Aviary hosted models.
+
+    Aviary is a backend for hosted models. You can
+    find out more about aviary at
+    http://github.com/ray-project/aviary
+
+    To get a list of the models supported on an
+    aviary, follow the instructions on the website to
+    install the aviary CLI and then use:
+    `aviary models`
+
+    AVIARY_URL and AVIARY_TOKEN environment variables must be set.
+
+    Attributes:
+        model: The name of the model to use. Defaults to "amazon/LightGPT".
+        aviary_url: The URL for the Aviary backend. Defaults to None.
+        aviary_token: The bearer token for the Aviary backend. Defaults to None.
+        use_prompt_format: If True, the prompt template for the model will be ignored.
+            Defaults to True.
+        version: API version to use for Aviary. Defaults to None.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Aviary
+            os.environ["AVIARY_URL"] = "<URL>"
+            os.environ["AVIARY_TOKEN"] = "<TOKEN>"
+            light = Aviary(model='amazon/LightGPT')
+            output = light('How do you make fried rice?')
+    """
+
+    model: str = "amazon/LightGPT"
+    aviary_url: Optional[str] = None
+    aviary_token: Optional[str] = None
+    # If True the prompt template for the model will be ignored.
+    use_prompt_format: bool = True
+    # API version to use for Aviary
+    version: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        aviary_url = get_from_dict_or_env(values, "aviary_url", "AVIARY_URL")
+        aviary_token = get_from_dict_or_env(values, "aviary_token", "AVIARY_TOKEN")
+
+        # Set env viarables for aviary sdk
+        os.environ["AVIARY_URL"] = aviary_url
+        os.environ["AVIARY_TOKEN"] = aviary_token
+
+        try:
+            aviary_models = get_models()
+        except requests.exceptions.RequestException as e:
+            raise ValueError(e)
+
+        model = values.get("model")
+        if model and model not in aviary_models:
+            raise ValueError(f"{aviary_url} does not support model {values['model']}.")
+
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model_name": self.model,
+            "aviary_url": self.aviary_url,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return f"aviary-{self.model.replace('/', '-')}"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Aviary
+        Args:
+            prompt: The prompt to pass into the model.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = aviary("Tell me a joke.")
+        """
+        kwargs = {"use_prompt_format": self.use_prompt_format}
+        if self.version:
+            kwargs["version"] = self.version
+
+        output = get_completions(
+            model=self.model,
+            prompt=prompt,
+            **kwargs,
+        )
+
+        text = cast(str, output["generated_text"])
+        if stop:
+            text = enforce_stop_tokens(text, stop)
+
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/azureml_endpoint.py b/llm/Lib/site-packages/langchain_community/llms/azureml_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b9dcc43fe1986bd6b9270c145762327c19c641c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/azureml_endpoint.py
@@ -0,0 +1,551 @@
+import json
+import urllib.request
+import warnings
+from abc import abstractmethod
+from enum import Enum
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core.callbacks.manager import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import BaseLLM
+from langchain_core.outputs import Generation, LLMResult
+from langchain_core.pydantic_v1 import BaseModel, SecretStr, root_validator, validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+DEFAULT_TIMEOUT = 50
+
+
+class AzureMLEndpointClient(object):
+    """AzureML Managed Endpoint client."""
+
+    def __init__(
+        self,
+        endpoint_url: str,
+        endpoint_api_key: str,
+        deployment_name: str = "",
+        timeout: int = DEFAULT_TIMEOUT,
+    ) -> None:
+        """Initialize the class."""
+        if not endpoint_api_key or not endpoint_url:
+            raise ValueError(
+                """A key/token and REST endpoint should 
+                be provided to invoke the endpoint"""
+            )
+        self.endpoint_url = endpoint_url
+        self.endpoint_api_key = endpoint_api_key
+        self.deployment_name = deployment_name
+        self.timeout = timeout
+
+    def call(
+        self,
+        body: bytes,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> bytes:
+        """call."""
+
+        # The azureml-model-deployment header will force the request to go to a
+        # specific deployment. Remove this header to have the request observe the
+        # endpoint traffic rules.
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": ("Bearer " + self.endpoint_api_key),
+        }
+        if self.deployment_name != "":
+            headers["azureml-model-deployment"] = self.deployment_name
+
+        req = urllib.request.Request(self.endpoint_url, body, headers)
+        response = urllib.request.urlopen(
+            req, timeout=kwargs.get("timeout", self.timeout)
+        )
+        result = response.read()
+        return result
+
+
+class AzureMLEndpointApiType(str, Enum):
+    """Azure ML endpoints API types. Use `dedicated` for models deployed in hosted
+    infrastructure (also known as Online Endpoints in Azure Machine Learning),
+    or `serverless` for models deployed as a service with a
+    pay-as-you-go billing or PTU.
+    """
+
+    dedicated = "dedicated"
+    realtime = "realtime"  #: Deprecated
+    serverless = "serverless"
+
+
+class ContentFormatterBase:
+    """Transform request and response of AzureML endpoint to match with
+    required schema.
+    """
+
+    """
+    Example:
+        .. code-block:: python
+        
+            class ContentFormatter(ContentFormatterBase):
+                content_type = "application/json"
+                accepts = "application/json"
+                
+                def format_request_payload(
+                    self, 
+                    prompt: str, 
+                    model_kwargs: Dict,
+                    api_type: AzureMLEndpointApiType,
+                ) -> bytes:
+                    input_str = json.dumps(
+                        {
+                            "inputs": {"input_string": [prompt]}, 
+                            "parameters": model_kwargs,
+                        }
+                    )
+                    return str.encode(input_str)
+                    
+                def format_response_payload(
+                        self, output: str, api_type: AzureMLEndpointApiType
+                    ) -> str:
+                    response_json = json.loads(output)
+                    return response_json[0]["0"]
+    """
+    content_type: Optional[str] = "application/json"
+    """The MIME type of the input data passed to the endpoint"""
+
+    accepts: Optional[str] = "application/json"
+    """The MIME type of the response data returned from the endpoint"""
+
+    format_error_msg: str = (
+        "Error while formatting response payload for chat model of type "
+        " `{api_type}`. Are you using the right formatter for the deployed "
+        " model and endpoint type?"
+    )
+
+    @staticmethod
+    def escape_special_characters(prompt: str) -> str:
+        """Escapes any special characters in `prompt`"""
+        escape_map = {
+            "\\": "\\\\",
+            '"': '\\"',
+            "\b": "\\b",
+            "\f": "\\f",
+            "\n": "\\n",
+            "\r": "\\r",
+            "\t": "\\t",
+        }
+
+        # Replace each occurrence of the specified characters with escaped versions
+        for escape_sequence, escaped_sequence in escape_map.items():
+            prompt = prompt.replace(escape_sequence, escaped_sequence)
+
+        return prompt
+
+    @property
+    def supported_api_types(self) -> List[AzureMLEndpointApiType]:
+        """Supported APIs for the given formatter. Azure ML supports
+        deploying models using different hosting methods. Each method may have
+        a different API structure."""
+
+        return [AzureMLEndpointApiType.dedicated]
+
+    def format_request_payload(
+        self,
+        prompt: str,
+        model_kwargs: Dict,
+        api_type: AzureMLEndpointApiType = AzureMLEndpointApiType.dedicated,
+    ) -> Any:
+        """Formats the request body according to the input schema of
+        the model. Returns bytes or seekable file like object in the
+        format specified in the content_type request header.
+        """
+        raise NotImplementedError()
+
+    @abstractmethod
+    def format_response_payload(
+        self,
+        output: bytes,
+        api_type: AzureMLEndpointApiType = AzureMLEndpointApiType.dedicated,
+    ) -> Generation:
+        """Formats the response body according to the output
+        schema of the model. Returns the data type that is
+        received from the response.
+        """
+
+
+class GPT2ContentFormatter(ContentFormatterBase):
+    """Content handler for GPT2"""
+
+    @property
+    def supported_api_types(self) -> List[AzureMLEndpointApiType]:
+        return [AzureMLEndpointApiType.dedicated]
+
+    def format_request_payload(  # type: ignore[override]
+        self, prompt: str, model_kwargs: Dict, api_type: AzureMLEndpointApiType
+    ) -> bytes:
+        prompt = ContentFormatterBase.escape_special_characters(prompt)
+        request_payload = json.dumps(
+            {"inputs": {"input_string": [f'"{prompt}"']}, "parameters": model_kwargs}
+        )
+        return str.encode(request_payload)
+
+    def format_response_payload(  # type: ignore[override]
+        self, output: bytes, api_type: AzureMLEndpointApiType
+    ) -> Generation:
+        try:
+            choice = json.loads(output)[0]["0"]
+        except (KeyError, IndexError, TypeError) as e:
+            raise ValueError(self.format_error_msg.format(api_type=api_type)) from e  # type: ignore[union-attr]
+        return Generation(text=choice)
+
+
+class OSSContentFormatter(GPT2ContentFormatter):
+    """Deprecated: Kept for backwards compatibility
+
+    Content handler for LLMs from the OSS catalog."""
+
+    content_formatter: Any = None
+
+    def __init__(self) -> None:
+        super().__init__()
+        warnings.warn(
+            """`OSSContentFormatter` will be deprecated in the future. 
+                      Please use `GPT2ContentFormatter` instead.  
+                      """
+        )
+
+
+class HFContentFormatter(ContentFormatterBase):
+    """Content handler for LLMs from the HuggingFace catalog."""
+
+    @property
+    def supported_api_types(self) -> List[AzureMLEndpointApiType]:
+        return [AzureMLEndpointApiType.dedicated]
+
+    def format_request_payload(  # type: ignore[override]
+        self, prompt: str, model_kwargs: Dict, api_type: AzureMLEndpointApiType
+    ) -> bytes:
+        ContentFormatterBase.escape_special_characters(prompt)
+        request_payload = json.dumps(
+            {"inputs": [f'"{prompt}"'], "parameters": model_kwargs}
+        )
+        return str.encode(request_payload)
+
+    def format_response_payload(  # type: ignore[override]
+        self, output: bytes, api_type: AzureMLEndpointApiType
+    ) -> Generation:
+        try:
+            choice = json.loads(output)[0]["0"]["generated_text"]
+        except (KeyError, IndexError, TypeError) as e:
+            raise ValueError(self.format_error_msg.format(api_type=api_type)) from e  # type: ignore[union-attr]
+        return Generation(text=choice)
+
+
+class DollyContentFormatter(ContentFormatterBase):
+    """Content handler for the Dolly-v2-12b model"""
+
+    @property
+    def supported_api_types(self) -> List[AzureMLEndpointApiType]:
+        return [AzureMLEndpointApiType.dedicated]
+
+    def format_request_payload(  # type: ignore[override]
+        self, prompt: str, model_kwargs: Dict, api_type: AzureMLEndpointApiType
+    ) -> bytes:
+        prompt = ContentFormatterBase.escape_special_characters(prompt)
+        request_payload = json.dumps(
+            {
+                "input_data": {"input_string": [f'"{prompt}"']},
+                "parameters": model_kwargs,
+            }
+        )
+        return str.encode(request_payload)
+
+    def format_response_payload(  # type: ignore[override]
+        self, output: bytes, api_type: AzureMLEndpointApiType
+    ) -> Generation:
+        try:
+            choice = json.loads(output)[0]
+        except (KeyError, IndexError, TypeError) as e:
+            raise ValueError(self.format_error_msg.format(api_type=api_type)) from e  # type: ignore[union-attr]
+        return Generation(text=choice)
+
+
+class CustomOpenAIContentFormatter(ContentFormatterBase):
+    """Content formatter for models that use the OpenAI like API scheme."""
+
+    @property
+    def supported_api_types(self) -> List[AzureMLEndpointApiType]:
+        return [AzureMLEndpointApiType.dedicated, AzureMLEndpointApiType.serverless]
+
+    def format_request_payload(  # type: ignore[override]
+        self, prompt: str, model_kwargs: Dict, api_type: AzureMLEndpointApiType
+    ) -> bytes:
+        """Formats the request according to the chosen api"""
+        prompt = ContentFormatterBase.escape_special_characters(prompt)
+        if api_type in [
+            AzureMLEndpointApiType.dedicated,
+            AzureMLEndpointApiType.realtime,
+        ]:
+            request_payload = json.dumps(
+                {
+                    "input_data": {
+                        "input_string": [f'"{prompt}"'],
+                        "parameters": model_kwargs,
+                    }
+                }
+            )
+        elif api_type == AzureMLEndpointApiType.serverless:
+            request_payload = json.dumps({"prompt": prompt, **model_kwargs})
+        else:
+            raise ValueError(
+                f"`api_type` {api_type} is not supported by this formatter"
+            )
+        return str.encode(request_payload)
+
+    def format_response_payload(  # type: ignore[override]
+        self, output: bytes, api_type: AzureMLEndpointApiType
+    ) -> Generation:
+        """Formats response"""
+        if api_type in [
+            AzureMLEndpointApiType.dedicated,
+            AzureMLEndpointApiType.realtime,
+        ]:
+            try:
+                choice = json.loads(output)[0]["0"]
+            except (KeyError, IndexError, TypeError) as e:
+                raise ValueError(self.format_error_msg.format(api_type=api_type)) from e  # type: ignore[union-attr]
+            return Generation(text=choice)
+        if api_type == AzureMLEndpointApiType.serverless:
+            try:
+                choice = json.loads(output)["choices"][0]
+                if not isinstance(choice, dict):
+                    raise TypeError(
+                        "Endpoint response is not well formed for a chat "
+                        "model. Expected `dict` but `{type(choice)}` was "
+                        "received."
+                    )
+            except (KeyError, IndexError, TypeError) as e:
+                raise ValueError(self.format_error_msg.format(api_type=api_type)) from e  # type: ignore[union-attr]
+            return Generation(
+                text=choice["text"].strip(),
+                generation_info=dict(
+                    finish_reason=choice.get("finish_reason"),
+                    logprobs=choice.get("logprobs"),
+                ),
+            )
+        raise ValueError(f"`api_type` {api_type} is not supported by this formatter")
+
+
+class LlamaContentFormatter(CustomOpenAIContentFormatter):
+    """Deprecated: Kept for backwards compatibility
+
+    Content formatter for Llama."""
+
+    content_formatter: Any = None
+
+    def __init__(self) -> None:
+        super().__init__()
+        warnings.warn(
+            """`LlamaContentFormatter` will be deprecated in the future. 
+                Please use `CustomOpenAIContentFormatter` instead.  
+            """
+        )
+
+
+class AzureMLBaseEndpoint(BaseModel):
+    """Azure ML Online Endpoint models."""
+
+    endpoint_url: str = ""
+    """URL of pre-existing Endpoint. Should be passed to constructor or specified as 
+        env var `AZUREML_ENDPOINT_URL`."""
+
+    endpoint_api_type: AzureMLEndpointApiType = AzureMLEndpointApiType.dedicated
+    """Type of the endpoint being consumed. Possible values are `serverless` for 
+        pay-as-you-go and `dedicated` for dedicated endpoints. """
+
+    endpoint_api_key: SecretStr = convert_to_secret_str("")
+    """Authentication Key for Endpoint. Should be passed to constructor or specified as
+        env var `AZUREML_ENDPOINT_API_KEY`."""
+
+    deployment_name: str = ""
+    """Deployment Name for Endpoint. NOT REQUIRED to call endpoint. Should be passed 
+        to constructor or specified as env var `AZUREML_DEPLOYMENT_NAME`."""
+
+    timeout: int = DEFAULT_TIMEOUT
+    """Request timeout for calls to the endpoint"""
+
+    http_client: Any = None  #: :meta private:
+
+    max_retries: int = 1
+
+    content_formatter: Any = None
+    """The content formatter that provides an input and output
+    transform function to handle formats between the LLM and
+    the endpoint"""
+
+    model_kwargs: Optional[dict] = None
+    """Keyword arguments to pass to the model."""
+
+    @root_validator(pre=True)
+    def validate_environ(cls, values: Dict) -> Dict:
+        values["endpoint_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "endpoint_api_key", "AZUREML_ENDPOINT_API_KEY")
+        )
+        values["endpoint_url"] = get_from_dict_or_env(
+            values, "endpoint_url", "AZUREML_ENDPOINT_URL"
+        )
+        values["deployment_name"] = get_from_dict_or_env(
+            values, "deployment_name", "AZUREML_DEPLOYMENT_NAME", ""
+        )
+        values["endpoint_api_type"] = get_from_dict_or_env(
+            values,
+            "endpoint_api_type",
+            "AZUREML_ENDPOINT_API_TYPE",
+            AzureMLEndpointApiType.dedicated,
+        )
+        values["timeout"] = get_from_dict_or_env(
+            values,
+            "timeout",
+            "AZUREML_TIMEOUT",
+            str(DEFAULT_TIMEOUT),
+        )
+
+        return values
+
+    @validator("content_formatter")
+    def validate_content_formatter(
+        cls, field_value: Any, values: Dict
+    ) -> ContentFormatterBase:
+        """Validate that content formatter is supported by endpoint type."""
+        endpoint_api_type = values.get("endpoint_api_type")
+        if endpoint_api_type not in field_value.supported_api_types:
+            raise ValueError(
+                f"Content formatter f{type(field_value)} is not supported by this "
+                f"endpoint. Supported types are {field_value.supported_api_types} "
+                f"but endpoint is {endpoint_api_type}."
+            )
+        return field_value
+
+    @validator("endpoint_url")
+    def validate_endpoint_url(cls, field_value: Any) -> str:
+        """Validate that endpoint url is complete."""
+        if field_value.endswith("/"):
+            field_value = field_value[:-1]
+        if field_value.endswith("inference.ml.azure.com"):
+            raise ValueError(
+                "`endpoint_url` should contain the full invocation URL including "
+                "`/score` for `endpoint_api_type='dedicated'` or `/v1/completions` "
+                "or `/v1/chat/completions` for `endpoint_api_type='serverless'`"
+            )
+        return field_value
+
+    @validator("endpoint_api_type")
+    def validate_endpoint_api_type(
+        cls, field_value: Any, values: Dict
+    ) -> AzureMLEndpointApiType:
+        """Validate that endpoint api type is compatible with the URL format."""
+        endpoint_url = values.get("endpoint_url")
+        if (
+            (
+                field_value == AzureMLEndpointApiType.dedicated
+                or field_value == AzureMLEndpointApiType.realtime
+            )
+            and not endpoint_url.endswith("/score")  # type: ignore[union-attr]
+        ):
+            raise ValueError(
+                "Endpoints of type `dedicated` should follow the format "
+                "`https://<your-endpoint>.<your_region>.inference.ml.azure.com/score`."
+                " If your endpoint URL ends with `/v1/completions` or"
+                "`/v1/chat/completions`, use `endpoint_api_type='serverless'` instead."
+            )
+        if field_value == AzureMLEndpointApiType.serverless and not (
+            endpoint_url.endswith("/v1/completions")  # type: ignore[union-attr]
+            or endpoint_url.endswith("/v1/chat/completions")  # type: ignore[union-attr]
+        ):
+            raise ValueError(
+                "Endpoints of type `serverless` should follow the format "
+                "`https://<your-endpoint>.<your_region>.inference.ml.azure.com/v1/chat/completions`"
+                " or `https://<your-endpoint>.<your_region>.inference.ml.azure.com/v1/chat/completions`"
+            )
+
+        return field_value
+
+    @validator("http_client", always=True)
+    def validate_client(cls, field_value: Any, values: Dict) -> AzureMLEndpointClient:
+        """Validate that api key and python package exists in environment."""
+        endpoint_url = values.get("endpoint_url")
+        endpoint_key = values.get("endpoint_api_key")
+        deployment_name = values.get("deployment_name")
+        timeout = values.get("timeout", DEFAULT_TIMEOUT)
+
+        http_client = AzureMLEndpointClient(
+            endpoint_url,  # type: ignore
+            endpoint_key.get_secret_value(),  # type: ignore
+            deployment_name,  # type: ignore
+            timeout,  # type: ignore
+        )
+
+        return http_client
+
+
+class AzureMLOnlineEndpoint(BaseLLM, AzureMLBaseEndpoint):
+    """Azure ML Online Endpoint models.
+
+    Example:
+        .. code-block:: python
+            azure_llm = AzureMLOnlineEndpoint(
+                endpoint_url="https://<your-endpoint>.<your_region>.inference.ml.azure.com/score",
+                endpoint_api_type=AzureMLApiType.dedicated,
+                endpoint_api_key="my-api-key",
+                timeout=120,
+                content_formatter=content_formatter,
+            )
+    """  # noqa: E501
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            **{"deployment_name": self.deployment_name},
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "azureml_endpoint"
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Run the LLM on the given prompts.
+
+        Args:
+            prompts: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+        Returns:
+            The string generated by the model.
+        Example:
+            .. code-block:: python
+                response = azureml_model("Tell me a joke.")
+        """
+        _model_kwargs = self.model_kwargs or {}
+        _model_kwargs.update(kwargs)
+        if stop:
+            _model_kwargs["stop"] = stop
+        generations = []
+
+        for prompt in prompts:
+            request_payload = self.content_formatter.format_request_payload(
+                prompt, _model_kwargs, self.endpoint_api_type
+            )
+            response_payload = self.http_client.call(
+                body=request_payload, run_manager=run_manager
+            )
+            generated_text = self.content_formatter.format_response_payload(
+                response_payload, self.endpoint_api_type
+            )
+            generations.append([generated_text])
+
+        return LLMResult(generations=generations)
diff --git a/llm/Lib/site-packages/langchain_community/llms/baichuan.py b/llm/Lib/site-packages/langchain_community/llms/baichuan.py
new file mode 100644
index 0000000000000000000000000000000000000000..293c95d2c84a8fec92cd6b8832c119b0b71717ae
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/baichuan.py
@@ -0,0 +1,95 @@
+from __future__ import annotations
+
+import json
+import logging
+from typing import Any, Dict, List, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class BaichuanLLM(LLM):
+    # TODO: Adding streaming support.
+    """Wrapper around Baichuan large language models."""
+
+    model: str = "Baichuan2-Turbo-192k"
+    """
+    Other models are available at https://platform.baichuan-ai.com/docs/api.
+    """
+    temperature: float = 0.3
+    top_p: float = 0.95
+    timeout: int = 60
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+
+    baichuan_api_host: Optional[str] = None
+    baichuan_api_key: Optional[SecretStr] = None
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        values["baichuan_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "baichuan_api_key", "BAICHUAN_API_KEY")
+        )
+        values["baichuan_api_host"] = get_from_dict_or_env(
+            values,
+            "baichuan_api_host",
+            "BAICHUAN_API_HOST",
+            default="https://api.baichuan-ai.com/v1/chat/completions",
+        )
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        return {
+            "model": self.model,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            **self.model_kwargs,
+        }
+
+    def _post(self, request: Any) -> Any:
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": f"Bearer {self.baichuan_api_key.get_secret_value()}",  # type: ignore[union-attr]
+        }
+        try:
+            response = requests.post(
+                self.baichuan_api_host,  # type: ignore[arg-type]
+                headers=headers,
+                json=request,
+                timeout=self.timeout,
+            )
+
+            if response.status_code == 200:
+                parsed_json = json.loads(response.text)
+                return parsed_json["choices"][0]["message"]["content"]
+            else:
+                response.raise_for_status()
+        except Exception as e:
+            raise ValueError(f"An error has occurred: {e}")
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        request = self._default_params
+        request["messages"] = [{"role": "user", "content": prompt}]
+        request.update(kwargs)
+        text = self._post(request)
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+        return text
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of chat_model."""
+        return "baichuan-llm"
diff --git a/llm/Lib/site-packages/langchain_community/llms/baidu_qianfan_endpoint.py b/llm/Lib/site-packages/langchain_community/llms/baidu_qianfan_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a611d2656f7b5ec9e8e0b073349e30dd41617be
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/baidu_qianfan_endpoint.py
@@ -0,0 +1,237 @@
+from __future__ import annotations
+
+import logging
+from typing import (
+    Any,
+    AsyncIterator,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+)
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+class QianfanLLMEndpoint(LLM):
+    """Baidu Qianfan hosted open source or customized models.
+
+    To use, you should have the ``qianfan`` python package installed, and
+    the environment variable ``qianfan_ak`` and ``qianfan_sk`` set with
+    your API key and Secret Key.
+
+    ak, sk are required parameters which you could get from
+    https://cloud.baidu.com/product/wenxinworkshop
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import QianfanLLMEndpoint
+            qianfan_model = QianfanLLMEndpoint(model="ERNIE-Bot",
+                endpoint="your_endpoint", qianfan_ak="your_ak", qianfan_sk="your_sk")
+    """
+
+    init_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """init kwargs for qianfan client init, such as `query_per_second` which is 
+        associated with qianfan resource object to limit QPS"""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """extra params for model invoke using with `do`."""
+
+    client: Any
+
+    qianfan_ak: Optional[str] = None
+    qianfan_sk: Optional[str] = None
+
+    streaming: Optional[bool] = False
+    """Whether to stream the results or not."""
+
+    model: str = "ERNIE-Bot-turbo"
+    """Model name. 
+    you could get from https://cloud.baidu.com/doc/WENXINWORKSHOP/s/Nlks5zkzu
+    
+    preset models are mapping to an endpoint.
+    `model` will be ignored if `endpoint` is set
+    """
+
+    endpoint: Optional[str] = None
+    """Endpoint of the Qianfan LLM, required if custom model used."""
+
+    request_timeout: Optional[int] = 60
+    """request timeout for chat http requests"""
+
+    top_p: Optional[float] = 0.8
+    temperature: Optional[float] = 0.95
+    penalty_score: Optional[float] = 1
+    """Model params, only supported in ERNIE-Bot and ERNIE-Bot-turbo.
+    In the case of other model, passing these params will not affect the result.
+    """
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        values["qianfan_ak"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "qianfan_ak",
+                "QIANFAN_AK",
+                default="",
+            )
+        )
+        values["qianfan_sk"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "qianfan_sk",
+                "QIANFAN_SK",
+                default="",
+            )
+        )
+
+        params = {
+            **values.get("init_kwargs", {}),
+            "model": values["model"],
+        }
+        if values["qianfan_ak"].get_secret_value() != "":
+            params["ak"] = values["qianfan_ak"].get_secret_value()
+        if values["qianfan_sk"].get_secret_value() != "":
+            params["sk"] = values["qianfan_sk"].get_secret_value()
+        if values["endpoint"] is not None and values["endpoint"] != "":
+            params["endpoint"] = values["endpoint"]
+        try:
+            import qianfan
+
+            values["client"] = qianfan.Completion(**params)
+        except ImportError:
+            raise ImportError(
+                "qianfan package not found, please install it with "
+                "`pip install qianfan`"
+            )
+        return values
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        return {
+            **{"endpoint": self.endpoint, "model": self.model},
+            **super()._identifying_params,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "baidu-qianfan-endpoint"
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Qianfan API."""
+        normal_params = {
+            "model": self.model,
+            "endpoint": self.endpoint,
+            "stream": self.streaming,
+            "request_timeout": self.request_timeout,
+            "top_p": self.top_p,
+            "temperature": self.temperature,
+            "penalty_score": self.penalty_score,
+        }
+
+        return {**normal_params, **self.model_kwargs}
+
+    def _convert_prompt_msg_params(
+        self,
+        prompt: str,
+        **kwargs: Any,
+    ) -> dict:
+        if "streaming" in kwargs:
+            kwargs["stream"] = kwargs.pop("streaming")
+        return {
+            **{"prompt": prompt, "model": self.model},
+            **self._default_params,
+            **kwargs,
+        }
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to an qianfan models endpoint for each generation with a prompt.
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+                response = qianfan_model("Tell me a joke.")
+        """
+        if self.streaming:
+            completion = ""
+            for chunk in self._stream(prompt, stop, run_manager, **kwargs):
+                completion += chunk.text
+            return completion
+        params = self._convert_prompt_msg_params(prompt, **kwargs)
+        params["stop"] = stop
+        response_payload = self.client.do(**params)
+
+        return response_payload["result"]
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        if self.streaming:
+            completion = ""
+            async for chunk in self._astream(prompt, stop, run_manager, **kwargs):
+                completion += chunk.text
+            return completion
+
+        params = self._convert_prompt_msg_params(prompt, **kwargs)
+        params["stop"] = stop
+        response_payload = await self.client.ado(**params)
+
+        return response_payload["result"]
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        params = self._convert_prompt_msg_params(prompt, **{**kwargs, "stream": True})
+        params["stop"] = stop
+        for res in self.client.do(**params):
+            if res:
+                chunk = GenerationChunk(text=res["result"])
+                if run_manager:
+                    run_manager.on_llm_new_token(chunk.text)
+                yield chunk
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        params = self._convert_prompt_msg_params(prompt, **{**kwargs, "stream": True})
+        params["stop"] = stop
+        async for res in await self.client.ado(**params):
+            if res:
+                chunk = GenerationChunk(text=res["result"])
+                if run_manager:
+                    await run_manager.on_llm_new_token(chunk.text)
+                yield chunk
diff --git a/llm/Lib/site-packages/langchain_community/llms/bananadev.py b/llm/Lib/site-packages/langchain_community/llms/bananadev.py
new file mode 100644
index 0000000000000000000000000000000000000000..43ee44b83dfd66e0d3cfd73c6cf587d0504999e0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/bananadev.py
@@ -0,0 +1,136 @@
+import logging
+from typing import Any, Dict, List, Mapping, Optional, cast
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class Banana(LLM):
+    """Banana large language models.
+
+    To use, you should have the ``banana-dev`` python package installed,
+    and the environment variable ``BANANA_API_KEY`` set with your API key.
+    This is the team API key available in the Banana dashboard.
+
+    Any parameters that are valid to be passed to the call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Banana
+            banana = Banana(model_key="", model_url_slug="")
+    """
+
+    model_key: str = ""
+    """model key to use"""
+
+    model_url_slug: str = ""
+    """model endpoint to use"""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not
+    explicitly specified."""
+
+    banana_api_key: Optional[SecretStr] = None
+
+    class Config:
+        """Configuration for this pydantic config."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = {field.alias for field in cls.__fields__.values()}
+
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name not in all_required_field_names:
+                if field_name in extra:
+                    raise ValueError(f"Found {field_name} supplied twice.")
+                logger.warning(
+                    f"""{field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        banana_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "banana_api_key", "BANANA_API_KEY")
+        )
+        values["banana_api_key"] = banana_api_key
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"model_key": self.model_key},
+            **{"model_url_slug": self.model_url_slug},
+            **{"model_kwargs": self.model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "bananadev"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call to Banana endpoint."""
+        try:
+            from banana_dev import Client
+        except ImportError:
+            raise ImportError(
+                "Could not import banana-dev python package. "
+                "Please install it with `pip install banana-dev`."
+            )
+        params = self.model_kwargs or {}
+        params = {**params, **kwargs}
+        api_key = cast(SecretStr, self.banana_api_key)
+        model_key = self.model_key
+        model_url_slug = self.model_url_slug
+        model_inputs = {
+            # a json specific to your model.
+            "prompt": prompt,
+            **params,
+        }
+        model = Client(
+            # Found in main dashboard
+            api_key=api_key.get_secret_value(),
+            # Both found in model details page
+            model_key=model_key,
+            url=f"https://{model_url_slug}.run.banana.dev",
+        )
+        response, meta = model.call("/", model_inputs)
+        try:
+            text = response["outputs"]
+        except (KeyError, TypeError):
+            raise ValueError(
+                "Response should be of schema: {'outputs': 'text'}."
+                "\nTo fix this:"
+                "\n- fork the source repo of the Banana model"
+                "\n- modify app.py to return the above schema"
+                "\n- deploy that as a custom repo"
+            )
+        if stop is not None:
+            # I believe this is required since the stop tokens
+            # are not enforced by the model parameters
+            text = enforce_stop_tokens(text, stop)
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/baseten.py b/llm/Lib/site-packages/langchain_community/llms/baseten.py
new file mode 100644
index 0000000000000000000000000000000000000000..9859106f51143d8ef64cce48d6763479caeca990
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/baseten.py
@@ -0,0 +1,94 @@
+import logging
+import os
+from typing import Any, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Field
+
+logger = logging.getLogger(__name__)
+
+
+class Baseten(LLM):
+    """Baseten model
+
+    This module allows using LLMs hosted on Baseten.
+
+    The LLM deployed on Baseten must have the following properties:
+
+    * Must accept input as a dictionary with the key "prompt"
+    * May accept other input in the dictionary passed through with kwargs
+    * Must return a string with the model output
+
+    To use this module, you must:
+
+    * Export your Baseten API key as the environment variable `BASETEN_API_KEY`
+    * Get the model ID for your model from your Baseten dashboard
+    * Identify the model deployment ("production" for all model library models)
+
+    These code samples use
+    [Mistral 7B Instruct](https://app.baseten.co/explore/mistral_7b_instruct)
+    from Baseten's model library.
+
+    Examples:
+        .. code-block:: python
+
+            from langchain_community.llms import Baseten
+            # Production deployment
+            mistral = Baseten(model="MODEL_ID", deployment="production")
+            mistral("What is the Mistral wind?")
+
+        .. code-block:: python
+
+            from langchain_community.llms import Baseten
+            # Development deployment
+            mistral = Baseten(model="MODEL_ID", deployment="development")
+            mistral("What is the Mistral wind?")
+
+        .. code-block:: python
+
+            from langchain_community.llms import Baseten
+            # Other published deployment
+            mistral = Baseten(model="MODEL_ID", deployment="DEPLOYMENT_ID")
+            mistral("What is the Mistral wind?")
+    """
+
+    model: str
+    deployment: str
+    input: Dict[str, Any] = Field(default_factory=dict)
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"model_kwargs": self.model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of model."""
+        return "baseten"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        baseten_api_key = os.environ["BASETEN_API_KEY"]
+        model_id = self.model
+        if self.deployment == "production":
+            model_url = f"https://model-{model_id}.api.baseten.co/production/predict"
+        elif self.deployment == "development":
+            model_url = f"https://model-{model_id}.api.baseten.co/development/predict"
+        else:  # try specific deployment ID
+            model_url = f"https://model-{model_id}.api.baseten.co/deployment/{self.deployment}/predict"
+        response = requests.post(
+            model_url,
+            headers={"Authorization": f"Api-Key {baseten_api_key}"},
+            json={"prompt": prompt, **kwargs},
+        )
+        return response.json()
diff --git a/llm/Lib/site-packages/langchain_community/llms/beam.py b/llm/Lib/site-packages/langchain_community/llms/beam.py
new file mode 100644
index 0000000000000000000000000000000000000000..9476cf07d05f5b21b315b021094238cf9be4eb2b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/beam.py
@@ -0,0 +1,272 @@
+import base64
+import json
+import logging
+import subprocess
+import textwrap
+import time
+from typing import Any, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_NUM_TRIES = 10
+DEFAULT_SLEEP_TIME = 4
+
+
+class Beam(LLM):
+    """Beam API for gpt2 large language model.
+
+    To use, you should have the ``beam-sdk`` python package installed,
+    and the environment variable ``BEAM_CLIENT_ID`` set with your client id
+    and ``BEAM_CLIENT_SECRET`` set with your client secret. Information on how
+    to get this is available here: https://docs.beam.cloud/account/api-keys.
+
+    The wrapper can then be called as follows, where the name, cpu, memory, gpu,
+    python version, and python packages can be updated accordingly. Once deployed,
+    the instance can be called.
+
+    Example:
+        .. code-block:: python
+
+            llm = Beam(model_name="gpt2",
+                name="langchain-gpt2",
+                cpu=8,
+                memory="32Gi",
+                gpu="A10G",
+                python_version="python3.8",
+                python_packages=[
+                    "diffusers[torch]>=0.10",
+                    "transformers",
+                    "torch",
+                    "pillow",
+                    "accelerate",
+                    "safetensors",
+                    "xformers",],
+                max_length=50)
+            llm._deploy()
+            call_result = llm._call(input)
+
+    """
+
+    model_name: str = ""
+    name: str = ""
+    cpu: str = ""
+    memory: str = ""
+    gpu: str = ""
+    python_version: str = ""
+    python_packages: List[str] = []
+    max_length: str = ""
+    url: str = ""
+    """model endpoint to use"""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not
+    explicitly specified."""
+
+    beam_client_id: str = ""
+    beam_client_secret: str = ""
+    app_id: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic config."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = {field.alias for field in cls.__fields__.values()}
+
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name not in all_required_field_names:
+                if field_name in extra:
+                    raise ValueError(f"Found {field_name} supplied twice.")
+                logger.warning(
+                    f"""{field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        beam_client_id = get_from_dict_or_env(
+            values, "beam_client_id", "BEAM_CLIENT_ID"
+        )
+        beam_client_secret = get_from_dict_or_env(
+            values, "beam_client_secret", "BEAM_CLIENT_SECRET"
+        )
+        values["beam_client_id"] = beam_client_id
+        values["beam_client_secret"] = beam_client_secret
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model_name": self.model_name,
+            "name": self.name,
+            "cpu": self.cpu,
+            "memory": self.memory,
+            "gpu": self.gpu,
+            "python_version": self.python_version,
+            "python_packages": self.python_packages,
+            "max_length": self.max_length,
+            "model_kwargs": self.model_kwargs,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "beam"
+
+    def app_creation(self) -> None:
+        """Creates a Python file which will contain your Beam app definition."""
+        script = textwrap.dedent(
+            """\
+        import beam
+
+        # The environment your code will run on
+        app = beam.App(
+            name="{name}",
+            cpu={cpu},
+            memory="{memory}",
+            gpu="{gpu}",
+            python_version="{python_version}",
+            python_packages={python_packages},
+        )
+
+        app.Trigger.RestAPI(
+            inputs={{"prompt": beam.Types.String(), "max_length": beam.Types.String()}},
+            outputs={{"text": beam.Types.String()}},
+            handler="run.py:beam_langchain",
+        )
+
+        """
+        )
+
+        script_name = "app.py"
+        with open(script_name, "w") as file:
+            file.write(
+                script.format(
+                    name=self.name,
+                    cpu=self.cpu,
+                    memory=self.memory,
+                    gpu=self.gpu,
+                    python_version=self.python_version,
+                    python_packages=self.python_packages,
+                )
+            )
+
+    def run_creation(self) -> None:
+        """Creates a Python file which will be deployed on beam."""
+        script = textwrap.dedent(
+            """
+        import os
+        import transformers
+        from transformers import GPT2LMHeadModel, GPT2Tokenizer
+
+        model_name = "{model_name}"
+
+        def beam_langchain(**inputs):
+            prompt = inputs["prompt"]
+            length = inputs["max_length"]
+
+            tokenizer = GPT2Tokenizer.from_pretrained(model_name)
+            model = GPT2LMHeadModel.from_pretrained(model_name)
+            encodedPrompt = tokenizer.encode(prompt, return_tensors='pt')
+            outputs = model.generate(encodedPrompt, max_length=int(length),
+              do_sample=True, pad_token_id=tokenizer.eos_token_id)
+            output = tokenizer.decode(outputs[0], skip_special_tokens=True)
+
+            print(output)  # noqa: T201
+            return {{"text": output}}
+
+        """
+        )
+
+        script_name = "run.py"
+        with open(script_name, "w") as file:
+            file.write(script.format(model_name=self.model_name))
+
+    def _deploy(self) -> str:
+        """Call to Beam."""
+        try:
+            import beam  # type: ignore
+
+            if beam.__path__ == "":
+                raise ImportError
+        except ImportError:
+            raise ImportError(
+                "Could not import beam python package. "
+                "Please install it with `curl "
+                "https://raw.githubusercontent.com/slai-labs"
+                "/get-beam/main/get-beam.sh -sSfL | sh`."
+            )
+        self.app_creation()
+        self.run_creation()
+
+        process = subprocess.run(
+            "beam deploy app.py", shell=True, capture_output=True, text=True
+        )
+
+        if process.returncode == 0:
+            output = process.stdout
+            logger.info(output)
+            lines = output.split("\n")
+
+            for line in lines:
+                if line.startswith(" i  Send requests to: https://apps.beam.cloud/"):
+                    self.app_id = line.split("/")[-1]
+                    self.url = line.split(":")[1].strip()
+                    return self.app_id
+
+            raise ValueError(
+                f"""Failed to retrieve the appID from the deployment output.
+                Deployment output: {output}"""
+            )
+        else:
+            raise ValueError(f"Deployment failed. Error: {process.stderr}")
+
+    @property
+    def authorization(self) -> str:
+        if self.beam_client_id:
+            credential_str = self.beam_client_id + ":" + self.beam_client_secret
+        else:
+            credential_str = self.beam_client_secret
+        return base64.b64encode(credential_str.encode()).decode()
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[list] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call to Beam."""
+        url = "https://apps.beam.cloud/" + self.app_id if self.app_id else self.url
+        payload = {"prompt": prompt, "max_length": self.max_length}
+        payload.update(kwargs)
+        headers = {
+            "Accept": "*/*",
+            "Accept-Encoding": "gzip, deflate",
+            "Authorization": "Basic " + self.authorization,
+            "Connection": "keep-alive",
+            "Content-Type": "application/json",
+        }
+
+        for _ in range(DEFAULT_NUM_TRIES):
+            request = requests.post(url, headers=headers, data=json.dumps(payload))
+            if request.status_code == 200:
+                return request.json()["text"]
+            time.sleep(DEFAULT_SLEEP_TIME)
+        logger.warning("Unable to successfully call model.")
+        return ""
diff --git a/llm/Lib/site-packages/langchain_community/llms/bedrock.py b/llm/Lib/site-packages/langchain_community/llms/bedrock.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d03c7be95b0724883c8bac6af426bdb28c6a899
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/bedrock.py
@@ -0,0 +1,917 @@
+import asyncio
+import json
+import warnings
+from abc import ABC
+from typing import (
+    Any,
+    AsyncGenerator,
+    AsyncIterator,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+)
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+from langchain_community.utilities.anthropic import (
+    get_num_tokens_anthropic,
+    get_token_ids_anthropic,
+)
+
+AMAZON_BEDROCK_TRACE_KEY = "amazon-bedrock-trace"
+GUARDRAILS_BODY_KEY = "amazon-bedrock-guardrailAssessment"
+HUMAN_PROMPT = "\n\nHuman:"
+ASSISTANT_PROMPT = "\n\nAssistant:"
+ALTERNATION_ERROR = (
+    "Error: Prompt must alternate between '\n\nHuman:' and '\n\nAssistant:'."
+)
+
+
+def _add_newlines_before_ha(input_text: str) -> str:
+    new_text = input_text
+    for word in ["Human:", "Assistant:"]:
+        new_text = new_text.replace(word, "\n\n" + word)
+        for i in range(2):
+            new_text = new_text.replace("\n\n\n" + word, "\n\n" + word)
+    return new_text
+
+
+def _human_assistant_format(input_text: str) -> str:
+    if input_text.count("Human:") == 0 or (
+        input_text.find("Human:") > input_text.find("Assistant:")
+        and "Assistant:" in input_text
+    ):
+        input_text = HUMAN_PROMPT + " " + input_text  # SILENT CORRECTION
+    if input_text.count("Assistant:") == 0:
+        input_text = input_text + ASSISTANT_PROMPT  # SILENT CORRECTION
+    if input_text[: len("Human:")] == "Human:":
+        input_text = "\n\n" + input_text
+    input_text = _add_newlines_before_ha(input_text)
+    count = 0
+    # track alternation
+    for i in range(len(input_text)):
+        if input_text[i : i + len(HUMAN_PROMPT)] == HUMAN_PROMPT:
+            if count % 2 == 0:
+                count += 1
+            else:
+                warnings.warn(ALTERNATION_ERROR + f" Received {input_text}")
+        if input_text[i : i + len(ASSISTANT_PROMPT)] == ASSISTANT_PROMPT:
+            if count % 2 == 1:
+                count += 1
+            else:
+                warnings.warn(ALTERNATION_ERROR + f" Received {input_text}")
+
+    if count % 2 == 1:  # Only saw Human, no Assistant
+        input_text = input_text + ASSISTANT_PROMPT  # SILENT CORRECTION
+
+    return input_text
+
+
+def _stream_response_to_generation_chunk(
+    stream_response: Dict[str, Any],
+) -> GenerationChunk:
+    """Convert a stream response to a generation chunk."""
+    if not stream_response["delta"]:
+        return GenerationChunk(text="")
+    return GenerationChunk(
+        text=stream_response["delta"]["text"],
+        generation_info=dict(
+            finish_reason=stream_response.get("stop_reason", None),
+        ),
+    )
+
+
+class LLMInputOutputAdapter:
+    """Adapter class to prepare the inputs from Langchain to a format
+    that LLM model expects.
+
+    It also provides helper function to extract
+    the generated text from the model response."""
+
+    provider_to_output_key_map = {
+        "anthropic": "completion",
+        "amazon": "outputText",
+        "cohere": "text",
+        "meta": "generation",
+        "mistral": "outputs",
+    }
+
+    @classmethod
+    def prepare_input(
+        cls,
+        provider: str,
+        model_kwargs: Dict[str, Any],
+        prompt: Optional[str] = None,
+        system: Optional[str] = None,
+        messages: Optional[List[Dict]] = None,
+    ) -> Dict[str, Any]:
+        input_body = {**model_kwargs}
+        if provider == "anthropic":
+            if messages:
+                input_body["anthropic_version"] = "bedrock-2023-05-31"
+                input_body["messages"] = messages
+                if system:
+                    input_body["system"] = system
+                if "max_tokens" not in input_body:
+                    input_body["max_tokens"] = 1024
+            if prompt:
+                input_body["prompt"] = _human_assistant_format(prompt)
+                if "max_tokens_to_sample" not in input_body:
+                    input_body["max_tokens_to_sample"] = 1024
+        elif provider in ("ai21", "cohere", "meta", "mistral"):
+            input_body["prompt"] = prompt
+        elif provider == "amazon":
+            input_body = dict()
+            input_body["inputText"] = prompt
+            input_body["textGenerationConfig"] = {**model_kwargs}
+        else:
+            input_body["inputText"] = prompt
+
+        return input_body
+
+    @classmethod
+    def prepare_output(cls, provider: str, response: Any) -> dict:
+        text = ""
+        if provider == "anthropic":
+            response_body = json.loads(response.get("body").read().decode())
+            if "completion" in response_body:
+                text = response_body.get("completion")
+            elif "content" in response_body:
+                content = response_body.get("content")
+                text = content[0].get("text")
+        else:
+            response_body = json.loads(response.get("body").read())
+
+            if provider == "ai21":
+                text = response_body.get("completions")[0].get("data").get("text")
+            elif provider == "cohere":
+                text = response_body.get("generations")[0].get("text")
+            elif provider == "meta":
+                text = response_body.get("generation")
+            elif provider == "mistral":
+                text = response_body.get("outputs")[0].get("text")
+            else:
+                text = response_body.get("results")[0].get("outputText")
+
+        headers = response.get("ResponseMetadata", {}).get("HTTPHeaders", {})
+        prompt_tokens = int(headers.get("x-amzn-bedrock-input-token-count", 0))
+        completion_tokens = int(headers.get("x-amzn-bedrock-output-token-count", 0))
+        return {
+            "text": text,
+            "body": response_body,
+            "usage": {
+                "prompt_tokens": prompt_tokens,
+                "completion_tokens": completion_tokens,
+                "total_tokens": prompt_tokens + completion_tokens,
+            },
+        }
+
+    @classmethod
+    def prepare_output_stream(
+        cls,
+        provider: str,
+        response: Any,
+        stop: Optional[List[str]] = None,
+        messages_api: bool = False,
+    ) -> Iterator[GenerationChunk]:
+        stream = response.get("body")
+
+        if not stream:
+            return
+
+        if messages_api:
+            output_key = "message"
+        else:
+            output_key = cls.provider_to_output_key_map.get(provider, "")
+
+        if not output_key:
+            raise ValueError(
+                f"Unknown streaming response output key for provider: {provider}"
+            )
+
+        for event in stream:
+            chunk = event.get("chunk")
+            if not chunk:
+                continue
+
+            chunk_obj = json.loads(chunk.get("bytes").decode())
+
+            if provider == "cohere" and (
+                chunk_obj["is_finished"] or chunk_obj[output_key] == "<EOS_TOKEN>"
+            ):
+                return
+
+            elif (
+                provider == "mistral"
+                and chunk_obj.get(output_key, [{}])[0].get("stop_reason", "") == "stop"
+            ):
+                return
+
+            elif messages_api and (chunk_obj.get("type") == "content_block_stop"):
+                return
+
+            if messages_api and chunk_obj.get("type") in (
+                "message_start",
+                "content_block_start",
+                "content_block_delta",
+            ):
+                if chunk_obj.get("type") == "content_block_delta":
+                    chk = _stream_response_to_generation_chunk(chunk_obj)
+                    yield chk
+                else:
+                    continue
+            else:
+                # chunk obj format varies with provider
+                yield GenerationChunk(
+                    text=(
+                        chunk_obj[output_key]
+                        if provider != "mistral"
+                        else chunk_obj[output_key][0]["text"]
+                    ),
+                    generation_info={
+                        GUARDRAILS_BODY_KEY: (
+                            chunk_obj.get(GUARDRAILS_BODY_KEY)
+                            if GUARDRAILS_BODY_KEY in chunk_obj
+                            else None
+                        ),
+                    },
+                )
+
+    @classmethod
+    async def aprepare_output_stream(
+        cls, provider: str, response: Any, stop: Optional[List[str]] = None
+    ) -> AsyncIterator[GenerationChunk]:
+        stream = response.get("body")
+
+        if not stream:
+            return
+
+        output_key = cls.provider_to_output_key_map.get(provider, None)
+
+        if not output_key:
+            raise ValueError(
+                f"Unknown streaming response output key for provider: {provider}"
+            )
+
+        for event in stream:
+            chunk = event.get("chunk")
+            if not chunk:
+                continue
+
+            chunk_obj = json.loads(chunk.get("bytes").decode())
+
+            if provider == "cohere" and (
+                chunk_obj["is_finished"] or chunk_obj[output_key] == "<EOS_TOKEN>"
+            ):
+                return
+
+            if (
+                provider == "mistral"
+                and chunk_obj.get(output_key, [{}])[0].get("stop_reason", "") == "stop"
+            ):
+                return
+
+            yield GenerationChunk(
+                text=(
+                    chunk_obj[output_key]
+                    if provider != "mistral"
+                    else chunk_obj[output_key][0]["text"]
+                )
+            )
+
+
+class BedrockBase(BaseModel, ABC):
+    """Base class for Bedrock models."""
+
+    client: Any = Field(exclude=True)  #: :meta private:
+
+    region_name: Optional[str] = None
+    """The aws region e.g., `us-west-2`. Fallsback to AWS_DEFAULT_REGION env variable
+    or region specified in ~/.aws/config in case it is not provided here.
+    """
+
+    credentials_profile_name: Optional[str] = Field(default=None, exclude=True)
+    """The name of the profile in the ~/.aws/credentials or ~/.aws/config files, which
+    has either access keys or role information specified.
+    If not specified, the default credential profile or, if on an EC2 instance,
+    credentials from IMDS will be used.
+    See: https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html
+    """
+
+    config: Any = None
+    """An optional botocore.config.Config instance to pass to the client."""
+
+    provider: Optional[str] = None
+    """The model provider, e.g., amazon, cohere, ai21, etc. When not supplied, provider
+    is extracted from the first part of the model_id e.g. 'amazon' in 
+    'amazon.titan-text-express-v1'. This value should be provided for model ids that do
+    not have the provider in them, e.g., custom and provisioned models that have an ARN
+    associated with them."""
+
+    model_id: str
+    """Id of the model to call, e.g., amazon.titan-text-express-v1, this is
+    equivalent to the modelId property in the list-foundation-models api. For custom and
+    provisioned models, an ARN value is expected."""
+
+    model_kwargs: Optional[Dict] = None
+    """Keyword arguments to pass to the model."""
+
+    endpoint_url: Optional[str] = None
+    """Needed if you don't want to default to us-east-1 endpoint"""
+
+    streaming: bool = False
+    """Whether to stream the results."""
+
+    provider_stop_sequence_key_name_map: Mapping[str, str] = {
+        "anthropic": "stop_sequences",
+        "amazon": "stopSequences",
+        "ai21": "stop_sequences",
+        "cohere": "stop_sequences",
+        "mistral": "stop_sequences",
+    }
+
+    guardrails: Optional[Mapping[str, Any]] = {
+        "id": None,
+        "version": None,
+        "trace": False,
+    }
+    """
+    An optional dictionary to configure guardrails for Bedrock.
+
+    This field 'guardrails' consists of two keys: 'id' and 'version',
+    which should be strings, but are initialized to None. It's used to
+    determine if specific guardrails are enabled and properly set.
+
+    Type:
+        Optional[Mapping[str, str]]: A mapping with 'id' and 'version' keys.
+
+    Example:
+    llm = Bedrock(model_id="<model_id>", client=<bedrock_client>,
+                  model_kwargs={},
+                  guardrails={
+                        "id": "<guardrail_id>",
+                        "version": "<guardrail_version>"})
+
+    To enable tracing for guardrails, set the 'trace' key to True and pass a callback handler to the
+    'run_manager' parameter of the 'generate', '_call' methods.
+
+    Example:
+    llm = Bedrock(model_id="<model_id>", client=<bedrock_client>,
+                  model_kwargs={},
+                  guardrails={
+                        "id": "<guardrail_id>",
+                        "version": "<guardrail_version>",
+                        "trace": True},
+                callbacks=[BedrockAsyncCallbackHandler()])
+
+    [https://python.langchain.com/docs/modules/callbacks/] for more information on callback handlers.
+
+    class BedrockAsyncCallbackHandler(AsyncCallbackHandler):
+        async def on_llm_error(
+            self,
+            error: BaseException,
+            **kwargs: Any,
+        ) -> Any:
+            reason = kwargs.get("reason")
+            if reason == "GUARDRAIL_INTERVENED":
+                ...Logic to handle guardrail intervention...
+    """  # noqa: E501
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that AWS credentials to and python package exists in environment."""
+
+        # Skip creating new client if passed in constructor
+        if values["client"] is not None:
+            return values
+
+        try:
+            import boto3
+
+            if values["credentials_profile_name"] is not None:
+                session = boto3.Session(profile_name=values["credentials_profile_name"])
+            else:
+                # use default credentials
+                session = boto3.Session()
+
+            values["region_name"] = get_from_dict_or_env(
+                values,
+                "region_name",
+                "AWS_DEFAULT_REGION",
+                default=session.region_name,
+            )
+
+            client_params = {}
+            if values["region_name"]:
+                client_params["region_name"] = values["region_name"]
+            if values["endpoint_url"]:
+                client_params["endpoint_url"] = values["endpoint_url"]
+            if values["config"]:
+                client_params["config"] = values["config"]
+
+            values["client"] = session.client("bedrock-runtime", **client_params)
+
+        except ImportError:
+            raise ModuleNotFoundError(
+                "Could not import boto3 python package. "
+                "Please install it with `pip install boto3`."
+            )
+        except ValueError as e:
+            raise ValueError(f"Error raised by bedrock service: {e}")
+        except Exception as e:
+            raise ValueError(
+                "Could not load credentials to authenticate with AWS client. "
+                "Please check that credentials in the specified "
+                f"profile name are valid. Bedrock error: {e}"
+            ) from e
+
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    def _get_provider(self) -> str:
+        if self.provider:
+            return self.provider
+        if self.model_id.startswith("arn"):
+            raise ValueError(
+                "Model provider should be supplied when passing a model ARN as "
+                "model_id"
+            )
+
+        return self.model_id.split(".")[0]
+
+    @property
+    def _model_is_anthropic(self) -> bool:
+        return self._get_provider() == "anthropic"
+
+    @property
+    def _guardrails_enabled(self) -> bool:
+        """
+        Determines if guardrails are enabled and correctly configured.
+        Checks if 'guardrails' is a dictionary with non-empty 'id' and 'version' keys.
+        Checks if 'guardrails.trace' is true.
+
+        Returns:
+            bool: True if guardrails are correctly configured, False otherwise.
+        Raises:
+            TypeError: If 'guardrails' lacks 'id' or 'version' keys.
+        """
+        try:
+            return (
+                isinstance(self.guardrails, dict)
+                and bool(self.guardrails["id"])
+                and bool(self.guardrails["version"])
+            )
+
+        except KeyError as e:
+            raise TypeError(
+                "Guardrails must be a dictionary with 'id' and 'version' keys."
+            ) from e
+
+    def _get_guardrails_canonical(self) -> Dict[str, Any]:
+        """
+        The canonical way to pass in guardrails to the bedrock service
+        adheres to the following format:
+
+        "amazon-bedrock-guardrailDetails": {
+            "guardrailId": "string",
+            "guardrailVersion": "string"
+        }
+        """
+        return {
+            "amazon-bedrock-guardrailDetails": {
+                "guardrailId": self.guardrails.get("id"),  # type: ignore[union-attr]
+                "guardrailVersion": self.guardrails.get("version"),  # type: ignore[union-attr]
+            }
+        }
+
+    def _prepare_input_and_invoke(
+        self,
+        prompt: Optional[str] = None,
+        system: Optional[str] = None,
+        messages: Optional[List[Dict]] = None,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Tuple[str, Dict[str, Any]]:
+        _model_kwargs = self.model_kwargs or {}
+
+        provider = self._get_provider()
+        params = {**_model_kwargs, **kwargs}
+        if self._guardrails_enabled:
+            params.update(self._get_guardrails_canonical())
+        input_body = LLMInputOutputAdapter.prepare_input(
+            provider=provider,
+            model_kwargs=params,
+            prompt=prompt,
+            system=system,
+            messages=messages,
+        )
+        body = json.dumps(input_body)
+        accept = "application/json"
+        contentType = "application/json"
+
+        request_options = {
+            "body": body,
+            "modelId": self.model_id,
+            "accept": accept,
+            "contentType": contentType,
+        }
+
+        if self._guardrails_enabled:
+            request_options["guardrail"] = "ENABLED"
+            if self.guardrails.get("trace"):  # type: ignore[union-attr]
+                request_options["trace"] = "ENABLED"
+
+        try:
+            response = self.client.invoke_model(**request_options)
+
+            text, body, usage_info = LLMInputOutputAdapter.prepare_output(
+                provider, response
+            ).values()
+
+        except Exception as e:
+            raise ValueError(f"Error raised by bedrock service: {e}")
+
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+
+        # Verify and raise a callback error if any intervention occurs or a signal is
+        # sent from a Bedrock service,
+        # such as when guardrails are triggered.
+        services_trace = self._get_bedrock_services_signal(body)  # type: ignore[arg-type]
+
+        if services_trace.get("signal") and run_manager is not None:
+            run_manager.on_llm_error(
+                Exception(
+                    f"Error raised by bedrock service: {services_trace.get('reason')}"
+                ),
+                **services_trace,
+            )
+
+        return text, usage_info
+
+    def _get_bedrock_services_signal(self, body: dict) -> dict:
+        """
+        This function checks the response body for an interrupt flag or message that indicates
+        whether any of the Bedrock services have intervened in the processing flow. It is
+        primarily used to identify modifications or interruptions imposed by these services
+        during the request-response cycle with a Large Language Model (LLM).
+        """  # noqa: E501
+
+        if (
+            self._guardrails_enabled
+            and self.guardrails.get("trace")  # type: ignore[union-attr]
+            and self._is_guardrails_intervention(body)
+        ):
+            return {
+                "signal": True,
+                "reason": "GUARDRAIL_INTERVENED",
+                "trace": body.get(AMAZON_BEDROCK_TRACE_KEY),
+            }
+
+        return {
+            "signal": False,
+            "reason": None,
+            "trace": None,
+        }
+
+    def _is_guardrails_intervention(self, body: dict) -> bool:
+        return body.get(GUARDRAILS_BODY_KEY) == "GUARDRAIL_INTERVENED"
+
+    def _prepare_input_and_invoke_stream(
+        self,
+        prompt: Optional[str] = None,
+        system: Optional[str] = None,
+        messages: Optional[List[Dict]] = None,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        _model_kwargs = self.model_kwargs or {}
+        provider = self._get_provider()
+
+        if stop:
+            if provider not in self.provider_stop_sequence_key_name_map:
+                raise ValueError(
+                    f"Stop sequence key name for {provider} is not supported."
+                )
+
+            # stop sequence from _generate() overrides
+            # stop sequences in the class attribute
+            _model_kwargs[self.provider_stop_sequence_key_name_map.get(provider)] = stop
+
+        if provider == "cohere":
+            _model_kwargs["stream"] = True
+
+        params = {**_model_kwargs, **kwargs}
+
+        if self._guardrails_enabled:
+            params.update(self._get_guardrails_canonical())
+
+        input_body = LLMInputOutputAdapter.prepare_input(
+            provider=provider,
+            prompt=prompt,
+            system=system,
+            messages=messages,
+            model_kwargs=params,
+        )
+        body = json.dumps(input_body)
+
+        request_options = {
+            "body": body,
+            "modelId": self.model_id,
+            "accept": "application/json",
+            "contentType": "application/json",
+        }
+
+        if self._guardrails_enabled:
+            request_options["guardrail"] = "ENABLED"
+            if self.guardrails.get("trace"):  # type: ignore[union-attr]
+                request_options["trace"] = "ENABLED"
+
+        try:
+            response = self.client.invoke_model_with_response_stream(**request_options)
+
+        except Exception as e:
+            raise ValueError(f"Error raised by bedrock service: {e}")
+
+        for chunk in LLMInputOutputAdapter.prepare_output_stream(
+            provider, response, stop, True if messages else False
+        ):
+            yield chunk
+            # verify and raise callback error if any middleware intervened
+            self._get_bedrock_services_signal(chunk.generation_info)  # type: ignore[arg-type]
+
+            if run_manager is not None:
+                run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+
+    async def _aprepare_input_and_invoke_stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        _model_kwargs = self.model_kwargs or {}
+        provider = self._get_provider()
+
+        if stop:
+            if provider not in self.provider_stop_sequence_key_name_map:
+                raise ValueError(
+                    f"Stop sequence key name for {provider} is not supported."
+                )
+            _model_kwargs[self.provider_stop_sequence_key_name_map.get(provider)] = stop
+
+        if provider == "cohere":
+            _model_kwargs["stream"] = True
+
+        params = {**_model_kwargs, **kwargs}
+        input_body = LLMInputOutputAdapter.prepare_input(
+            provider=provider, prompt=prompt, model_kwargs=params
+        )
+        body = json.dumps(input_body)
+
+        response = await asyncio.get_running_loop().run_in_executor(
+            None,
+            lambda: self.client.invoke_model_with_response_stream(
+                body=body,
+                modelId=self.model_id,
+                accept="application/json",
+                contentType="application/json",
+            ),
+        )
+
+        async for chunk in LLMInputOutputAdapter.aprepare_output_stream(
+            provider, response, stop
+        ):
+            yield chunk
+            if run_manager is not None and asyncio.iscoroutinefunction(
+                run_manager.on_llm_new_token
+            ):
+                await run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+            elif run_manager is not None:
+                run_manager.on_llm_new_token(chunk.text, chunk=chunk)  # type: ignore[unused-coroutine]
+
+
+@deprecated(
+    since="0.0.34", removal="0.3", alternative_import="langchain_aws.BedrockLLM"
+)
+class Bedrock(LLM, BedrockBase):
+    """Bedrock models.
+
+    To authenticate, the AWS client uses the following methods to
+    automatically load credentials:
+    https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html
+
+    If a specific credential profile should be used, you must pass
+    the name of the profile from the ~/.aws/credentials file that is to be used.
+
+    Make sure the credentials / roles used have the required policies to
+    access the Bedrock service.
+    """
+
+    """
+    Example:
+        .. code-block:: python
+
+            from bedrock_langchain.bedrock_llm import BedrockLLM
+
+            llm = BedrockLLM(
+                credentials_profile_name="default",
+                model_id="amazon.titan-text-express-v1",
+                streaming=True
+            )
+
+    """
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        model_id = values["model_id"]
+        if model_id.startswith("anthropic.claude-3"):
+            raise ValueError(
+                "Claude v3 models are not supported by this LLM."
+                "Please use `from langchain_community.chat_models import BedrockChat` "
+                "instead."
+            )
+        return super().validate_environment(values)
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "amazon_bedrock"
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this model can be serialized by Langchain."""
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "llms", "bedrock"]
+
+    @property
+    def lc_attributes(self) -> Dict[str, Any]:
+        attributes: Dict[str, Any] = {}
+
+        if self.region_name:
+            attributes["region_name"] = self.region_name
+
+        return attributes
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        """Call out to Bedrock service with streaming.
+
+        Args:
+            prompt (str): The prompt to pass into the model
+            stop (Optional[List[str]], optional): Stop sequences. These will
+                override any stop sequences in the `model_kwargs` attribute.
+                Defaults to None.
+            run_manager (Optional[CallbackManagerForLLMRun], optional): Callback
+                run managers used to process the output. Defaults to None.
+
+        Returns:
+            Iterator[GenerationChunk]: Generator that yields the streamed responses.
+
+        Yields:
+            Iterator[GenerationChunk]: Responses from the model.
+        """
+        return self._prepare_input_and_invoke_stream(
+            prompt=prompt, stop=stop, run_manager=run_manager, **kwargs
+        )
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Bedrock service model.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = llm("Tell me a joke.")
+        """
+
+        if self.streaming:
+            completion = ""
+            for chunk in self._stream(
+                prompt=prompt, stop=stop, run_manager=run_manager, **kwargs
+            ):
+                completion += chunk.text
+            return completion
+
+        text, _ = self._prepare_input_and_invoke(
+            prompt=prompt, stop=stop, run_manager=run_manager, **kwargs
+        )
+        return text
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncGenerator[GenerationChunk, None]:
+        """Call out to Bedrock service with streaming.
+
+        Args:
+            prompt (str): The prompt to pass into the model
+            stop (Optional[List[str]], optional): Stop sequences. These will
+                override any stop sequences in the `model_kwargs` attribute.
+                Defaults to None.
+            run_manager (Optional[CallbackManagerForLLMRun], optional): Callback
+                run managers used to process the output. Defaults to None.
+
+        Yields:
+            AsyncGenerator[GenerationChunk, None]: Generator that asynchronously yields
+            the streamed responses.
+        """
+        async for chunk in self._aprepare_input_and_invoke_stream(
+            prompt=prompt, stop=stop, run_manager=run_manager, **kwargs
+        ):
+            yield chunk
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Bedrock service model.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = await llm._acall("Tell me a joke.")
+        """
+
+        if not self.streaming:
+            raise ValueError("Streaming must be set to True for async operations. ")
+
+        chunks = [
+            chunk.text
+            async for chunk in self._astream(
+                prompt=prompt, stop=stop, run_manager=run_manager, **kwargs
+            )
+        ]
+        return "".join(chunks)
+
+    def get_num_tokens(self, text: str) -> int:
+        if self._model_is_anthropic:
+            return get_num_tokens_anthropic(text)
+        else:
+            return super().get_num_tokens(text)
+
+    def get_token_ids(self, text: str) -> List[int]:
+        if self._model_is_anthropic:
+            return get_token_ids_anthropic(text)
+        else:
+            return super().get_token_ids(text)
diff --git a/llm/Lib/site-packages/langchain_community/llms/bigdl_llm.py b/llm/Lib/site-packages/langchain_community/llms/bigdl_llm.py
new file mode 100644
index 0000000000000000000000000000000000000000..f225587a733311933e42657568077d4206033c30
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/bigdl_llm.py
@@ -0,0 +1,145 @@
+import logging
+from typing import Any, Optional
+
+from langchain_core.language_models.llms import LLM
+
+from langchain_community.llms.ipex_llm import IpexLLM
+
+logger = logging.getLogger(__name__)
+
+
+class BigdlLLM(IpexLLM):
+    """Wrapper around the BigdlLLM model
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import BigdlLLM
+            llm = BigdlLLM.from_model_id(model_id="THUDM/chatglm-6b")
+    """
+
+    @classmethod
+    def from_model_id(
+        cls,
+        model_id: str,
+        model_kwargs: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> LLM:
+        """
+        Construct object from model_id
+
+        Args:
+            model_id: Path for the huggingface repo id to be downloaded or
+                      the huggingface checkpoint folder.
+            model_kwargs: Keyword arguments to pass to the model and tokenizer.
+            kwargs: Extra arguments to pass to the model and tokenizer.
+
+        Returns:
+            An object of BigdlLLM.
+        """
+        logger.warning("BigdlLLM was deprecated. Please use IpexLLM instead.")
+
+        try:
+            from bigdl.llm.transformers import (
+                AutoModel,
+                AutoModelForCausalLM,
+            )
+            from transformers import AutoTokenizer, LlamaTokenizer
+
+        except ImportError:
+            raise ValueError(
+                "Could not import bigdl-llm or transformers. "
+                "Please install it with `pip install --pre --upgrade bigdl-llm[all]`."
+            )
+
+        _model_kwargs = model_kwargs or {}
+
+        try:
+            tokenizer = AutoTokenizer.from_pretrained(model_id, **_model_kwargs)
+        except Exception:
+            tokenizer = LlamaTokenizer.from_pretrained(model_id, **_model_kwargs)
+
+        try:
+            model = AutoModelForCausalLM.from_pretrained(
+                model_id, load_in_4bit=True, **_model_kwargs
+            )
+        except Exception:
+            model = AutoModel.from_pretrained(
+                model_id, load_in_4bit=True, **_model_kwargs
+            )
+
+        if "trust_remote_code" in _model_kwargs:
+            _model_kwargs = {
+                k: v for k, v in _model_kwargs.items() if k != "trust_remote_code"
+            }
+
+        return cls(
+            model_id=model_id,
+            model=model,
+            tokenizer=tokenizer,
+            model_kwargs=_model_kwargs,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_model_id_low_bit(
+        cls,
+        model_id: str,
+        model_kwargs: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> LLM:
+        """
+        Construct low_bit object from model_id
+
+        Args:
+
+            model_id: Path for the bigdl-llm transformers low-bit model folder.
+            model_kwargs: Keyword arguments to pass to the model and tokenizer.
+            kwargs: Extra arguments to pass to the model and tokenizer.
+
+        Returns:
+            An object of BigdlLLM.
+        """
+
+        logger.warning("BigdlLLM was deprecated. Please use IpexLLM instead.")
+
+        try:
+            from bigdl.llm.transformers import (
+                AutoModel,
+                AutoModelForCausalLM,
+            )
+            from transformers import AutoTokenizer, LlamaTokenizer
+
+        except ImportError:
+            raise ValueError(
+                "Could not import bigdl-llm or transformers. "
+                "Please install it with `pip install --pre --upgrade bigdl-llm[all]`."
+            )
+
+        _model_kwargs = model_kwargs or {}
+        try:
+            tokenizer = AutoTokenizer.from_pretrained(model_id, **_model_kwargs)
+        except Exception:
+            tokenizer = LlamaTokenizer.from_pretrained(model_id, **_model_kwargs)
+
+        try:
+            model = AutoModelForCausalLM.load_low_bit(model_id, **_model_kwargs)
+        except Exception:
+            model = AutoModel.load_low_bit(model_id, **_model_kwargs)
+
+        if "trust_remote_code" in _model_kwargs:
+            _model_kwargs = {
+                k: v for k, v in _model_kwargs.items() if k != "trust_remote_code"
+            }
+
+        return cls(
+            model_id=model_id,
+            model=model,
+            tokenizer=tokenizer,
+            model_kwargs=_model_kwargs,
+            **kwargs,
+        )
+
+    @property
+    def _llm_type(self) -> str:
+        return "bigdl-llm"
diff --git a/llm/Lib/site-packages/langchain_community/llms/bittensor.py b/llm/Lib/site-packages/langchain_community/llms/bittensor.py
new file mode 100644
index 0000000000000000000000000000000000000000..3d28533f514b16913384d8cdc31a6dc947db2910
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/bittensor.py
@@ -0,0 +1,174 @@
+import http.client
+import json
+import ssl
+from typing import Any, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+
+
+class NIBittensorLLM(LLM):
+    """NIBittensor LLMs
+
+    NIBittensorLLM is created by Neural Internet (https://neuralinternet.ai/),
+    powered by Bittensor, a decentralized network full of different AI models.
+
+    To analyze API_KEYS and logs of your usage visit
+        https://api.neuralinternet.ai/api-keys
+        https://api.neuralinternet.ai/logs
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import NIBittensorLLM
+            llm = NIBittensorLLM()
+    """
+
+    system_prompt: Optional[str]
+    """Provide system prompt that you want to supply it to model before every prompt"""
+
+    top_responses: Optional[int] = 0
+    """Provide top_responses to get Top N miner responses on one request.May get delayed
+        Don't use in Production"""
+
+    @property
+    def _llm_type(self) -> str:
+        return "NIBittensorLLM"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """
+        Wrapper around the bittensor top miner models. Its built by Neural Internet.
+
+        Call the Neural Internet's BTVEP Server and return the output.
+
+        Parameters (optional):
+            system_prompt(str): A system prompt defining how your model should respond.
+            top_responses(int): Total top miner responses to retrieve from Bittensor
+                protocol.
+
+        Return:
+            The generated response(s).
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.llms import NIBittensorLLM
+                llm = NIBittensorLLM(system_prompt="Act like you are programmer with \
+                5+ years of experience.")
+        """
+
+        # Creating HTTPS connection with SSL
+        context = ssl.create_default_context()
+        context.check_hostname = True
+        conn = http.client.HTTPSConnection("test.neuralinternet.ai", context=context)
+
+        # Sanitizing User Input before passing to API.
+        if isinstance(self.top_responses, int):
+            top_n = min(100, self.top_responses)
+        else:
+            top_n = 0
+
+        default_prompt = "You are an assistant which is created by Neural Internet(NI) \
+            in decentralized network named as a Bittensor."
+        if self.system_prompt is None:
+            system_prompt = (
+                default_prompt
+                + " Your task is to provide accurate response based on user prompt"
+            )
+        else:
+            system_prompt = default_prompt + str(self.system_prompt)
+
+        # Retrieving API KEY to pass into header of each request
+        conn.request("GET", "/admin/api-keys/")
+        api_key_response = conn.getresponse()
+        api_keys_data = (
+            api_key_response.read().decode("utf-8").replace("\n", "").replace("\t", "")
+        )
+        api_keys_json = json.loads(api_keys_data)
+        api_key = api_keys_json[0]["api_key"]
+
+        # Creating Header and getting top benchmark miner uids
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": f"Bearer {api_key}",
+            "Endpoint-Version": "2023-05-19",
+        }
+        conn.request("GET", "/top_miner_uids", headers=headers)
+        miner_response = conn.getresponse()
+        miner_data = (
+            miner_response.read().decode("utf-8").replace("\n", "").replace("\t", "")
+        )
+        uids = json.loads(miner_data)
+
+        # Condition for benchmark miner response
+        if isinstance(uids, list) and uids and not top_n:
+            for uid in uids:
+                try:
+                    payload = json.dumps(
+                        {
+                            "uids": [uid],
+                            "messages": [
+                                {"role": "system", "content": system_prompt},
+                                {"role": "user", "content": prompt},
+                            ],
+                        }
+                    )
+
+                    conn.request("POST", "/chat", payload, headers)
+                    init_response = conn.getresponse()
+                    init_data = (
+                        init_response.read()
+                        .decode("utf-8")
+                        .replace("\n", "")
+                        .replace("\t", "")
+                    )
+                    init_json = json.loads(init_data)
+                    if "choices" not in init_json:
+                        continue
+                    reply = init_json["choices"][0]["message"]["content"]
+                    conn.close()
+                    return reply
+                except Exception:
+                    continue
+
+        # For top miner based on bittensor response
+        try:
+            payload = json.dumps(
+                {
+                    "top_n": top_n,
+                    "messages": [
+                        {"role": "system", "content": system_prompt},
+                        {"role": "user", "content": prompt},
+                    ],
+                }
+            )
+
+            conn.request("POST", "/chat", payload, headers)
+            response = conn.getresponse()
+            utf_string = (
+                response.read().decode("utf-8").replace("\n", "").replace("\t", "")
+            )
+            if top_n:
+                conn.close()
+                return utf_string
+            json_resp = json.loads(utf_string)
+            reply = json_resp["choices"][0]["message"]["content"]
+            conn.close()
+            return reply
+        except Exception as e:
+            conn.request("GET", f"/error_msg?e={e}&p={prompt}", headers=headers)
+            return "Sorry I am unable to provide response now, Please try again later."
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "system_prompt": self.system_prompt,
+            "top_responses": self.top_responses,
+        }
diff --git a/llm/Lib/site-packages/langchain_community/llms/cerebriumai.py b/llm/Lib/site-packages/langchain_community/llms/cerebriumai.py
new file mode 100644
index 0000000000000000000000000000000000000000..c9e219995ae1bae11bacb8455c11e41e6ed605c5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/cerebriumai.py
@@ -0,0 +1,113 @@
+import logging
+from typing import Any, Dict, List, Mapping, Optional, cast
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class CerebriumAI(LLM):
+    """CerebriumAI large language models.
+
+    To use, you should have the ``cerebrium`` python package installed.
+    You should also have the environment variable ``CEREBRIUMAI_API_KEY``
+    set with your API key or pass it as a named argument in the constructor.
+
+    Any parameters that are valid to be passed to the call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import CerebriumAI
+            cerebrium = CerebriumAI(endpoint_url="", cerebriumai_api_key="my-api-key")
+
+    """
+
+    endpoint_url: str = ""
+    """model endpoint to use"""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not
+    explicitly specified."""
+
+    cerebriumai_api_key: Optional[SecretStr] = None
+
+    class Config:
+        """Configuration for this pydantic config."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = {field.alias for field in cls.__fields__.values()}
+
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name not in all_required_field_names:
+                if field_name in extra:
+                    raise ValueError(f"Found {field_name} supplied twice.")
+                logger.warning(
+                    f"""{field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        cerebriumai_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "cerebriumai_api_key", "CEREBRIUMAI_API_KEY")
+        )
+        values["cerebriumai_api_key"] = cerebriumai_api_key
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"endpoint_url": self.endpoint_url},
+            **{"model_kwargs": self.model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "cerebriumai"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        headers: Dict = {
+            "Authorization": cast(
+                SecretStr, self.cerebriumai_api_key
+            ).get_secret_value(),
+            "Content-Type": "application/json",
+        }
+        params = self.model_kwargs or {}
+        payload = {"prompt": prompt, **params, **kwargs}
+        response = requests.post(self.endpoint_url, json=payload, headers=headers)
+        if response.status_code == 200:
+            data = response.json()
+            text = data["result"]
+            if stop is not None:
+                # I believe this is required since the stop tokens
+                # are not enforced by the model parameters
+                text = enforce_stop_tokens(text, stop)
+            return text
+        else:
+            response.raise_for_status()
+        return ""
diff --git a/llm/Lib/site-packages/langchain_community/llms/chatglm.py b/llm/Lib/site-packages/langchain_community/llms/chatglm.py
new file mode 100644
index 0000000000000000000000000000000000000000..bdd55946606304f6b753887b2c5cd9746a2564a1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/chatglm.py
@@ -0,0 +1,129 @@
+import logging
+from typing import Any, List, Mapping, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class ChatGLM(LLM):
+    """ChatGLM LLM service.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import ChatGLM
+            endpoint_url = (
+                "http://127.0.0.1:8000"
+            )
+            ChatGLM_llm = ChatGLM(
+                endpoint_url=endpoint_url
+            )
+    """
+
+    endpoint_url: str = "http://127.0.0.1:8000/"
+    """Endpoint URL to use."""
+    model_kwargs: Optional[dict] = None
+    """Keyword arguments to pass to the model."""
+    max_token: int = 20000
+    """Max token allowed to pass to the model."""
+    temperature: float = 0.1
+    """LLM model temperature from 0 to 10."""
+    history: List[List] = []
+    """History of the conversation"""
+    top_p: float = 0.7
+    """Top P for nucleus sampling from 0 to 1"""
+    with_history: bool = False
+    """Whether to use history or not"""
+
+    @property
+    def _llm_type(self) -> str:
+        return "chat_glm"
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            **{"endpoint_url": self.endpoint_url},
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to a ChatGLM LLM inference endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = chatglm_llm("Who are you?")
+        """
+
+        _model_kwargs = self.model_kwargs or {}
+
+        # HTTP headers for authorization
+        headers = {"Content-Type": "application/json"}
+
+        payload = {
+            "prompt": prompt,
+            "temperature": self.temperature,
+            "history": self.history,
+            "max_length": self.max_token,
+            "top_p": self.top_p,
+        }
+        payload.update(_model_kwargs)
+        payload.update(kwargs)
+
+        logger.debug(f"ChatGLM payload: {payload}")
+
+        # call api
+        try:
+            response = requests.post(self.endpoint_url, headers=headers, json=payload)
+        except requests.exceptions.RequestException as e:
+            raise ValueError(f"Error raised by inference endpoint: {e}")
+
+        logger.debug(f"ChatGLM response: {response}")
+
+        if response.status_code != 200:
+            raise ValueError(f"Failed with response: {response}")
+
+        try:
+            parsed_response = response.json()
+
+            # Check if response content does exists
+            if isinstance(parsed_response, dict):
+                content_keys = "response"
+                if content_keys in parsed_response:
+                    text = parsed_response[content_keys]
+                else:
+                    raise ValueError(f"No content in response : {parsed_response}")
+            else:
+                raise ValueError(f"Unexpected response type: {parsed_response}")
+
+        except requests.exceptions.JSONDecodeError as e:
+            raise ValueError(
+                f"Error raised during decoding response from inference endpoint: {e}."
+                f"\nResponse: {response.text}"
+            )
+
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+        if self.with_history:
+            self.history = parsed_response["history"]
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/chatglm3.py b/llm/Lib/site-packages/langchain_community/llms/chatglm3.py
new file mode 100644
index 0000000000000000000000000000000000000000..0582fc58f089d669805d5d38ee4c4c666e9dbf46
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/chatglm3.py
@@ -0,0 +1,151 @@
+import json
+import logging
+from typing import Any, List, Optional, Union
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    FunctionMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from langchain_core.pydantic_v1 import Field
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+HEADERS = {"Content-Type": "application/json"}
+DEFAULT_TIMEOUT = 30
+
+
+def _convert_message_to_dict(message: BaseMessage) -> dict:
+    if isinstance(message, HumanMessage):
+        message_dict = {"role": "user", "content": message.content}
+    elif isinstance(message, AIMessage):
+        message_dict = {"role": "assistant", "content": message.content}
+    elif isinstance(message, SystemMessage):
+        message_dict = {"role": "system", "content": message.content}
+    elif isinstance(message, FunctionMessage):
+        message_dict = {"role": "function", "content": message.content}
+    else:
+        raise ValueError(f"Got unknown type {message}")
+    return message_dict
+
+
+class ChatGLM3(LLM):
+    """ChatGLM3 LLM service."""
+
+    model_name: str = Field(default="chatglm3-6b", alias="model")
+    endpoint_url: str = "http://127.0.0.1:8000/v1/chat/completions"
+    """Endpoint URL to use."""
+    model_kwargs: Optional[dict] = None
+    """Keyword arguments to pass to the model."""
+    max_tokens: int = 20000
+    """Max token allowed to pass to the model."""
+    temperature: float = 0.1
+    """LLM model temperature from 0 to 10."""
+    top_p: float = 0.7
+    """Top P for nucleus sampling from 0 to 1"""
+    prefix_messages: List[BaseMessage] = Field(default_factory=list)
+    """Series of messages for Chat input."""
+    streaming: bool = False
+    """Whether to stream the results or not."""
+    http_client: Union[Any, None] = None
+    timeout: int = DEFAULT_TIMEOUT
+
+    @property
+    def _llm_type(self) -> str:
+        return "chat_glm_3"
+
+    @property
+    def _invocation_params(self) -> dict:
+        """Get the parameters used to invoke the model."""
+        params = {
+            "model": self.model_name,
+            "temperature": self.temperature,
+            "max_tokens": self.max_tokens,
+            "top_p": self.top_p,
+            "stream": self.streaming,
+        }
+        return {**params, **(self.model_kwargs or {})}
+
+    @property
+    def client(self) -> Any:
+        import httpx
+
+        return self.http_client or httpx.Client(timeout=self.timeout)
+
+    def _get_payload(self, prompt: str) -> dict:
+        params = self._invocation_params
+        messages = self.prefix_messages + [HumanMessage(content=prompt)]
+        params.update(
+            {
+                "messages": [_convert_message_to_dict(m) for m in messages],
+            }
+        )
+        return params
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to a ChatGLM3 LLM inference endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = chatglm_llm("Who are you?")
+        """
+        import httpx
+
+        payload = self._get_payload(prompt)
+        logger.debug(f"ChatGLM3 payload: {payload}")
+
+        try:
+            response = self.client.post(
+                self.endpoint_url, headers=HEADERS, json=payload
+            )
+        except httpx.NetworkError as e:
+            raise ValueError(f"Error raised by inference endpoint: {e}")
+
+        logger.debug(f"ChatGLM3 response: {response}")
+
+        if response.status_code != 200:
+            raise ValueError(f"Failed with response: {response}")
+
+        try:
+            parsed_response = response.json()
+
+            if isinstance(parsed_response, dict):
+                content_keys = "choices"
+                if content_keys in parsed_response:
+                    choices = parsed_response[content_keys]
+                    if len(choices):
+                        text = choices[0]["message"]["content"]
+                else:
+                    raise ValueError(f"No content in response : {parsed_response}")
+            else:
+                raise ValueError(f"Unexpected response type: {parsed_response}")
+
+        except json.JSONDecodeError as e:
+            raise ValueError(
+                f"Error raised during decoding response from inference endpoint: {e}."
+                f"\nResponse: {response.text}"
+            )
+
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/clarifai.py b/llm/Lib/site-packages/langchain_community/llms/clarifai.py
new file mode 100644
index 0000000000000000000000000000000000000000..78a9115d6b4f6644ab349128eba249f6f2a6c6b2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/clarifai.py
@@ -0,0 +1,197 @@
+import logging
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import Generation, LLMResult
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+EXAMPLE_URL = "https://clarifai.com/openai/chat-completion/models/GPT-4"
+
+
+class Clarifai(LLM):
+    """Clarifai large language models.
+
+    To use, you should have an account on the Clarifai platform,
+    the ``clarifai`` python package installed, and the
+    environment variable ``CLARIFAI_PAT`` set with your PAT key,
+    or pass it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Clarifai
+            clarifai_llm = Clarifai(user_id=USER_ID, app_id=APP_ID, model_id=MODEL_ID)
+                             (or)
+            clarifai_llm = Clarifai(model_url=EXAMPLE_URL)
+    """
+
+    model_url: Optional[str] = None
+    """Model url to use."""
+    model_id: Optional[str] = None
+    """Model id to use."""
+    model_version_id: Optional[str] = None
+    """Model version id to use."""
+    app_id: Optional[str] = None
+    """Clarifai application id to use."""
+    user_id: Optional[str] = None
+    """Clarifai user id to use."""
+    pat: Optional[str] = Field(default=None, exclude=True)  #: :meta private:
+    """Clarifai personal access token to use."""
+    token: Optional[str] = Field(default=None, exclude=True)  #: :meta private:
+    """Clarifai session token to use."""
+    model: Any = Field(default=None, exclude=True)  #: :meta private:
+    api_base: str = "https://api.clarifai.com"
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that we have all required info to access Clarifai
+        platform and python package exists in environment."""
+        try:
+            from clarifai.client.model import Model
+        except ImportError:
+            raise ImportError(
+                "Could not import clarifai python package. "
+                "Please install it with `pip install clarifai`."
+            )
+        user_id = values.get("user_id")
+        app_id = values.get("app_id")
+        model_id = values.get("model_id")
+        model_version_id = values.get("model_version_id")
+        model_url = values.get("model_url")
+        api_base = values.get("api_base")
+        pat = values.get("pat")
+        token = values.get("token")
+
+        values["model"] = Model(
+            url=model_url,
+            app_id=app_id,
+            user_id=user_id,
+            model_version=dict(id=model_version_id),
+            pat=pat,
+            token=token,
+            model_id=model_id,
+            base_url=api_base,
+        )
+
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Clarifai API."""
+        return {}
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{
+                "model_url": self.model_url,
+                "user_id": self.user_id,
+                "app_id": self.app_id,
+                "model_id": self.model_id,
+            }
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "clarifai"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        inference_params: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Clarfai's PostModelOutputs endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = clarifai_llm("Tell me a joke.")
+        """
+
+        try:
+            (inference_params := {}) if inference_params is None else inference_params
+            predict_response = self.model.predict_by_bytes(
+                bytes(prompt, "utf-8"),
+                input_type="text",
+                inference_params=inference_params,
+            )
+            text = predict_response.outputs[0].data.text.raw
+            if stop is not None:
+                text = enforce_stop_tokens(text, stop)
+
+        except Exception as e:
+            logger.error(f"Predict failed, exception: {e}")
+
+        return text
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        inference_params: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Run the LLM on the given prompt and input."""
+
+        # TODO: add caching here.
+        try:
+            from clarifai.client.input import Inputs
+        except ImportError:
+            raise ImportError(
+                "Could not import clarifai python package. "
+                "Please install it with `pip install clarifai`."
+            )
+
+        generations = []
+        batch_size = 32
+        input_obj = Inputs.from_auth_helper(self.model.auth_helper)
+        try:
+            for i in range(0, len(prompts), batch_size):
+                batch = prompts[i : i + batch_size]
+                input_batch = [
+                    input_obj.get_text_input(input_id=str(id), raw_text=inp)
+                    for id, inp in enumerate(batch)
+                ]
+                (
+                    inference_params := {}
+                ) if inference_params is None else inference_params
+                predict_response = self.model.predict(
+                    inputs=input_batch, inference_params=inference_params
+                )
+
+            for output in predict_response.outputs:
+                if stop is not None:
+                    text = enforce_stop_tokens(output.data.text.raw, stop)
+                else:
+                    text = output.data.text.raw
+
+                generations.append([Generation(text=text)])
+
+        except Exception as e:
+            logger.error(f"Predict failed, exception: {e}")
+
+        return LLMResult(generations=generations)
diff --git a/llm/Lib/site-packages/langchain_community/llms/cloudflare_workersai.py b/llm/Lib/site-packages/langchain_community/llms/cloudflare_workersai.py
new file mode 100644
index 0000000000000000000000000000000000000000..54b41418c42cd8d7095266f6c6a0a54e1c8596d4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/cloudflare_workersai.py
@@ -0,0 +1,126 @@
+import json
+import logging
+from typing import Any, Dict, Iterator, List, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+
+logger = logging.getLogger(__name__)
+
+
+class CloudflareWorkersAI(LLM):
+    """Cloudflare Workers AI service.
+
+    To use, you must provide an API token and
+    account ID to access Cloudflare Workers AI, and
+    pass it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms.cloudflare_workersai import CloudflareWorkersAI
+
+            my_account_id = "my_account_id"
+            my_api_token = "my_secret_api_token"
+            llm_model =  "@cf/meta/llama-2-7b-chat-int8"
+
+            cf_ai = CloudflareWorkersAI(
+                account_id=my_account_id,
+                api_token=my_api_token,
+                model=llm_model
+            )
+    """  # noqa: E501
+
+    account_id: str
+    api_token: str
+    model: str = "@cf/meta/llama-2-7b-chat-int8"
+    base_url: str = "https://api.cloudflare.com/client/v4/accounts"
+    streaming: bool = False
+    endpoint_url: str = ""
+
+    def __init__(self, **kwargs: Any) -> None:
+        """Initialize the Cloudflare Workers AI class."""
+        super().__init__(**kwargs)
+
+        self.endpoint_url = f"{self.base_url}/{self.account_id}/ai/run/{self.model}"
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of LLM."""
+        return "cloudflare"
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Default parameters"""
+        return {}
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Identifying parameters"""
+        return {
+            "account_id": self.account_id,
+            "api_token": self.api_token,
+            "model": self.model,
+            "base_url": self.base_url,
+        }
+
+    def _call_api(self, prompt: str, params: Dict[str, Any]) -> requests.Response:
+        """Call Cloudflare Workers API"""
+        headers = {"Authorization": f"Bearer {self.api_token}"}
+        data = {"prompt": prompt, "stream": self.streaming, **params}
+        response = requests.post(self.endpoint_url, headers=headers, json=data)
+        return response
+
+    def _process_response(self, response: requests.Response) -> str:
+        """Process API response"""
+        if response.ok:
+            data = response.json()
+            return data["result"]["response"]
+        else:
+            raise ValueError(f"Request failed with status {response.status_code}")
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        """Streaming prediction"""
+        original_steaming: bool = self.streaming
+        self.streaming = True
+        _response_prefix_count = len("data: ")
+        _response_stream_end = b"data: [DONE]"
+        for chunk in self._call_api(prompt, kwargs).iter_lines():
+            if chunk == _response_stream_end:
+                break
+            if len(chunk) > _response_prefix_count:
+                try:
+                    data = json.loads(chunk[_response_prefix_count:])
+                except Exception as e:
+                    logger.debug(chunk)
+                    raise e
+                if data is not None and "response" in data:
+                    yield GenerationChunk(text=data["response"])
+                if run_manager:
+                    run_manager.on_llm_new_token(data["response"])
+        logger.debug("stream end")
+        self.streaming = original_steaming
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Regular prediction"""
+        if self.streaming:
+            return "".join(
+                [c.text for c in self._stream(prompt, stop, run_manager, **kwargs)]
+            )
+        else:
+            response = self._call_api(prompt, kwargs)
+            return self._process_response(response)
diff --git a/llm/Lib/site-packages/langchain_community/llms/cohere.py b/llm/Lib/site-packages/langchain_community/llms/cohere.py
new file mode 100644
index 0000000000000000000000000000000000000000..17960b2dee86660f3e01e72249404eda41f4e9cf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/cohere.py
@@ -0,0 +1,268 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Callable, Dict, List, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.load.serializable import Serializable
+from langchain_core.pydantic_v1 import Extra, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+from tenacity import (
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+def _create_retry_decorator(max_retries: int) -> Callable[[Any], Any]:
+    import cohere
+
+    # support v4 and v5
+    retry_conditions = (
+        retry_if_exception_type(cohere.error.CohereError)
+        if hasattr(cohere, "error")
+        else retry_if_exception_type(Exception)
+    )
+
+    min_seconds = 4
+    max_seconds = 10
+    # Wait 2^x * 1 second between each retry starting with
+    # 4 seconds, then up to 10 seconds, then 10 seconds afterwards
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(max_retries),
+        wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+        retry=retry_conditions,
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def completion_with_retry(llm: Cohere, **kwargs: Any) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = _create_retry_decorator(llm.max_retries)
+
+    @retry_decorator
+    def _completion_with_retry(**kwargs: Any) -> Any:
+        return llm.client.generate(**kwargs)
+
+    return _completion_with_retry(**kwargs)
+
+
+def acompletion_with_retry(llm: Cohere, **kwargs: Any) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = _create_retry_decorator(llm.max_retries)
+
+    @retry_decorator
+    async def _completion_with_retry(**kwargs: Any) -> Any:
+        return await llm.async_client.generate(**kwargs)
+
+    return _completion_with_retry(**kwargs)
+
+
+@deprecated(
+    since="0.0.30", removal="0.2.0", alternative_import="langchain_cohere.BaseCohere"
+)
+class BaseCohere(Serializable):
+    """Base class for Cohere models."""
+
+    client: Any  #: :meta private:
+    async_client: Any  #: :meta private:
+    model: Optional[str] = Field(default=None)
+    """Model name to use."""
+
+    temperature: float = 0.75
+    """A non-negative float that tunes the degree of randomness in generation."""
+
+    cohere_api_key: Optional[SecretStr] = None
+    """Cohere API key. If not provided, will be read from the environment variable."""
+
+    stop: Optional[List[str]] = None
+
+    streaming: bool = Field(default=False)
+    """Whether to stream the results."""
+
+    user_agent: str = "langchain"
+    """Identifier for the application making the request."""
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        try:
+            import cohere
+        except ImportError:
+            raise ImportError(
+                "Could not import cohere python package. "
+                "Please install it with `pip install cohere`."
+            )
+        else:
+            values["cohere_api_key"] = convert_to_secret_str(
+                get_from_dict_or_env(values, "cohere_api_key", "COHERE_API_KEY")
+            )
+            client_name = values["user_agent"]
+            values["client"] = cohere.Client(
+                api_key=values["cohere_api_key"].get_secret_value(),
+                client_name=client_name,
+            )
+            values["async_client"] = cohere.AsyncClient(
+                api_key=values["cohere_api_key"].get_secret_value(),
+                client_name=client_name,
+            )
+        return values
+
+
+@deprecated(
+    since="0.1.14", removal="0.2.0", alternative_import="langchain_cohere.Cohere"
+)
+class Cohere(LLM, BaseCohere):
+    """Cohere large language models.
+
+    To use, you should have the ``cohere`` python package installed, and the
+    environment variable ``COHERE_API_KEY`` set with your API key, or pass
+    it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Cohere
+
+            cohere = Cohere(model="gptd-instruct-tft", cohere_api_key="my-api-key")
+    """
+
+    max_tokens: int = 256
+    """Denotes the number of tokens to predict per generation."""
+
+    k: int = 0
+    """Number of most likely tokens to consider at each step."""
+
+    p: int = 1
+    """Total probability mass of tokens to consider at each step."""
+
+    frequency_penalty: float = 0.0
+    """Penalizes repeated tokens according to frequency. Between 0 and 1."""
+
+    presence_penalty: float = 0.0
+    """Penalizes repeated tokens. Between 0 and 1."""
+
+    truncate: Optional[str] = None
+    """Specify how the client handles inputs longer than the maximum token
+    length: Truncate from START, END or NONE"""
+
+    max_retries: int = 10
+    """Maximum number of retries to make when generating."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Cohere API."""
+        return {
+            "max_tokens": self.max_tokens,
+            "temperature": self.temperature,
+            "k": self.k,
+            "p": self.p,
+            "frequency_penalty": self.frequency_penalty,
+            "presence_penalty": self.presence_penalty,
+            "truncate": self.truncate,
+        }
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"cohere_api_key": "COHERE_API_KEY"}
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model": self.model}, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "cohere"
+
+    def _invocation_params(self, stop: Optional[List[str]], **kwargs: Any) -> dict:
+        params = self._default_params
+        if self.stop is not None and stop is not None:
+            raise ValueError("`stop` found in both the input and default params.")
+        elif self.stop is not None:
+            params["stop_sequences"] = self.stop
+        else:
+            params["stop_sequences"] = stop
+        return {**params, **kwargs}
+
+    def _process_response(self, response: Any, stop: Optional[List[str]]) -> str:
+        text = response.generations[0].text
+        # If stop tokens are provided, Cohere's endpoint returns them.
+        # In order to make this consistent with other endpoints, we strip them.
+        if stop:
+            text = enforce_stop_tokens(text, stop)
+        return text
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Cohere's generate endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = cohere("Tell me a joke.")
+        """
+        params = self._invocation_params(stop, **kwargs)
+        response = completion_with_retry(
+            self, model=self.model, prompt=prompt, **params
+        )
+        _stop = params.get("stop_sequences")
+        return self._process_response(response, _stop)
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Async call out to Cohere's generate endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = await cohere("Tell me a joke.")
+        """
+        params = self._invocation_params(stop, **kwargs)
+        response = await acompletion_with_retry(
+            self, model=self.model, prompt=prompt, **params
+        )
+        _stop = params.get("stop_sequences")
+        return self._process_response(response, _stop)
diff --git a/llm/Lib/site-packages/langchain_community/llms/ctransformers.py b/llm/Lib/site-packages/langchain_community/llms/ctransformers.py
new file mode 100644
index 0000000000000000000000000000000000000000..b532b1585c5efcc91b62835df1c033fdb7fbe9d0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/ctransformers.py
@@ -0,0 +1,140 @@
+from functools import partial
+from typing import Any, Dict, List, Optional, Sequence
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import root_validator
+
+
+class CTransformers(LLM):
+    """C Transformers LLM models.
+
+    To use, you should have the ``ctransformers`` python package installed.
+    See https://github.com/marella/ctransformers
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import CTransformers
+
+            llm = CTransformers(model="/path/to/ggml-gpt-2.bin", model_type="gpt2")
+    """
+
+    client: Any  #: :meta private:
+
+    model: str
+    """The path to a model file or directory or the name of a Hugging Face Hub
+    model repo."""
+
+    model_type: Optional[str] = None
+    """The model type."""
+
+    model_file: Optional[str] = None
+    """The name of the model file in repo or directory."""
+
+    config: Optional[Dict[str, Any]] = None
+    """The config parameters.
+    See https://github.com/marella/ctransformers#config"""
+
+    lib: Optional[str] = None
+    """The path to a shared library or one of `avx2`, `avx`, `basic`."""
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model": self.model,
+            "model_type": self.model_type,
+            "model_file": self.model_file,
+            "config": self.config,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "ctransformers"
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that ``ctransformers`` package is installed."""
+        try:
+            from ctransformers import AutoModelForCausalLM
+        except ImportError:
+            raise ImportError(
+                "Could not import `ctransformers` package. "
+                "Please install it with `pip install ctransformers`"
+            )
+
+        config = values["config"] or {}
+        values["client"] = AutoModelForCausalLM.from_pretrained(
+            values["model"],
+            model_type=values["model_type"],
+            model_file=values["model_file"],
+            lib=values["lib"],
+            **config,
+        )
+        return values
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[Sequence[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Generate text from a prompt.
+
+        Args:
+            prompt: The prompt to generate text from.
+            stop: A list of sequences to stop generation when encountered.
+
+        Returns:
+            The generated text.
+
+        Example:
+            .. code-block:: python
+
+                response = llm("Tell me a joke.")
+        """
+        text = []
+        _run_manager = run_manager or CallbackManagerForLLMRun.get_noop_manager()
+        for chunk in self.client(prompt, stop=stop, stream=True):
+            text.append(chunk)
+            _run_manager.on_llm_new_token(chunk, verbose=self.verbose)
+        return "".join(text)
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Asynchronous Call out to CTransformers generate method.
+        Very helpful when streaming (like with websockets!)
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: A list of strings to stop generation when encountered.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+                response = llm("Once upon a time, ")
+        """
+        text_callback = None
+        if run_manager:
+            text_callback = partial(run_manager.on_llm_new_token, verbose=self.verbose)
+
+        text = ""
+        for token in self.client(prompt, stop=stop, stream=True):
+            if text_callback:
+                await text_callback(token)
+            text += token
+
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/ctranslate2.py b/llm/Lib/site-packages/langchain_community/llms/ctranslate2.py
new file mode 100644
index 0000000000000000000000000000000000000000..84e357aa8e51b4e0500e311b20825ae9975ed031
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/ctranslate2.py
@@ -0,0 +1,128 @@
+from typing import Any, Dict, List, Optional, Union
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import BaseLLM
+from langchain_core.outputs import Generation, LLMResult
+from langchain_core.pydantic_v1 import Field, root_validator
+
+
+class CTranslate2(BaseLLM):
+    """CTranslate2 language model."""
+
+    model_path: str = ""
+    """Path to the CTranslate2 model directory."""
+
+    tokenizer_name: str = ""
+    """Name of the original Hugging Face model needed to load the proper tokenizer."""
+
+    device: str = "cpu"
+    """Device to use (possible values are: cpu, cuda, auto)."""
+
+    device_index: Union[int, List[int]] = 0
+    """Device IDs where to place this generator on."""
+
+    compute_type: Union[str, Dict[str, str]] = "default"
+    """
+    Model computation type or a dictionary mapping a device name to the computation type
+    (possible values are: default, auto, int8, int8_float32, int8_float16,
+    int8_bfloat16, int16, float16, bfloat16, float32).
+    """
+
+    max_length: int = 512
+    """Maximum generation length."""
+
+    sampling_topk: int = 1
+    """Randomly sample predictions from the top K candidates."""
+
+    sampling_topp: float = 1
+    """Keep the most probable tokens whose cumulative probability exceeds this value."""
+
+    sampling_temperature: float = 1
+    """Sampling temperature to generate more random samples."""
+
+    client: Any  #: :meta private:
+
+    tokenizer: Any  #: :meta private:
+
+    ctranslate2_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """
+    Holds any model parameters valid for `ctranslate2.Generator` call not 
+    explicitly specified.
+    """
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that python package exists in environment."""
+
+        try:
+            import ctranslate2
+        except ImportError:
+            raise ImportError(
+                "Could not import ctranslate2 python package. "
+                "Please install it with `pip install ctranslate2`."
+            )
+
+        try:
+            import transformers
+        except ImportError:
+            raise ImportError(
+                "Could not import transformers python package. "
+                "Please install it with `pip install transformers`."
+            )
+
+        values["client"] = ctranslate2.Generator(
+            model_path=values["model_path"],
+            device=values["device"],
+            device_index=values["device_index"],
+            compute_type=values["compute_type"],
+            **values["ctranslate2_kwargs"],
+        )
+
+        values["tokenizer"] = transformers.AutoTokenizer.from_pretrained(
+            values["tokenizer_name"]
+        )
+
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters."""
+        return {
+            "max_length": self.max_length,
+            "sampling_topk": self.sampling_topk,
+            "sampling_topp": self.sampling_topp,
+            "sampling_temperature": self.sampling_temperature,
+        }
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        # build sampling parameters
+        params = {**self._default_params, **kwargs}
+
+        # call the model
+        encoded_prompts = self.tokenizer(prompts)["input_ids"]
+        tokenized_prompts = [
+            self.tokenizer.convert_ids_to_tokens(encoded_prompt)
+            for encoded_prompt in encoded_prompts
+        ]
+
+        results = self.client.generate_batch(tokenized_prompts, **params)
+
+        sequences = [result.sequences_ids[0] for result in results]
+        decoded_sequences = [self.tokenizer.decode(seq) for seq in sequences]
+
+        generations = []
+        for text in decoded_sequences:
+            generations.append([Generation(text=text)])
+
+        return LLMResult(generations=generations)
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "ctranslate2"
diff --git a/llm/Lib/site-packages/langchain_community/llms/databricks.py b/llm/Lib/site-packages/langchain_community/llms/databricks.py
new file mode 100644
index 0000000000000000000000000000000000000000..06da23183e1ee9d304291b258dc62c59a371066f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/databricks.py
@@ -0,0 +1,560 @@
+import os
+import re
+import warnings
+from abc import ABC, abstractmethod
+from typing import Any, Callable, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models import LLM
+from langchain_core.pydantic_v1 import (
+    BaseModel,
+    Extra,
+    Field,
+    PrivateAttr,
+    root_validator,
+    validator,
+)
+
+__all__ = ["Databricks"]
+
+
+class _DatabricksClientBase(BaseModel, ABC):
+    """A base JSON API client that talks to Databricks."""
+
+    api_url: str
+    api_token: str
+
+    def request(self, method: str, url: str, request: Any) -> Any:
+        headers = {"Authorization": f"Bearer {self.api_token}"}
+        response = requests.request(
+            method=method, url=url, headers=headers, json=request
+        )
+        # TODO: error handling and automatic retries
+        if not response.ok:
+            raise ValueError(f"HTTP {response.status_code} error: {response.text}")
+        return response.json()
+
+    def _get(self, url: str) -> Any:
+        return self.request("GET", url, None)
+
+    def _post(self, url: str, request: Any) -> Any:
+        return self.request("POST", url, request)
+
+    @abstractmethod
+    def post(
+        self, request: Any, transform_output_fn: Optional[Callable[..., str]] = None
+    ) -> Any:
+        ...
+
+    @property
+    def llm(self) -> bool:
+        return False
+
+
+def _transform_completions(response: Dict[str, Any]) -> str:
+    return response["choices"][0]["text"]
+
+
+def _transform_llama2_chat(response: Dict[str, Any]) -> str:
+    return response["candidates"][0]["text"]
+
+
+def _transform_chat(response: Dict[str, Any]) -> str:
+    return response["choices"][0]["message"]["content"]
+
+
+class _DatabricksServingEndpointClient(_DatabricksClientBase):
+    """An API client that talks to a Databricks serving endpoint."""
+
+    host: str
+    endpoint_name: str
+    databricks_uri: str
+    client: Any = None
+    external_or_foundation: bool = False
+    task: Optional[str] = None
+
+    def __init__(self, **data: Any):
+        super().__init__(**data)
+
+        try:
+            from mlflow.deployments import get_deploy_client
+
+            self.client = get_deploy_client(self.databricks_uri)
+        except ImportError as e:
+            raise ImportError(
+                "Failed to create the client. "
+                "Please install mlflow with `pip install mlflow`."
+            ) from e
+
+        endpoint = self.client.get_endpoint(self.endpoint_name)
+        self.external_or_foundation = endpoint.get("endpoint_type", "").lower() in (
+            "external_model",
+            "foundation_model_api",
+        )
+        if self.task is None:
+            self.task = endpoint.get("task")
+
+    @property
+    def llm(self) -> bool:
+        return self.task in ("llm/v1/chat", "llm/v1/completions", "llama2/chat")
+
+    @root_validator(pre=True)
+    def set_api_url(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        if "api_url" not in values:
+            host = values["host"]
+            endpoint_name = values["endpoint_name"]
+            api_url = f"https://{host}/serving-endpoints/{endpoint_name}/invocations"
+            values["api_url"] = api_url
+        return values
+
+    def post(
+        self, request: Any, transform_output_fn: Optional[Callable[..., str]] = None
+    ) -> Any:
+        if self.external_or_foundation:
+            resp = self.client.predict(endpoint=self.endpoint_name, inputs=request)
+            if transform_output_fn:
+                return transform_output_fn(resp)
+
+            if self.task == "llm/v1/chat":
+                return _transform_chat(resp)
+            elif self.task == "llm/v1/completions":
+                return _transform_completions(resp)
+
+            return resp
+        else:
+            # See https://docs.databricks.com/machine-learning/model-serving/score-model-serving-endpoints.html
+            wrapped_request = {"dataframe_records": [request]}
+            response = self.client.predict(
+                endpoint=self.endpoint_name, inputs=wrapped_request
+            )
+            preds = response["predictions"]
+            # For a single-record query, the result is not a list.
+            pred = preds[0] if isinstance(preds, list) else preds
+            if self.task == "llama2/chat":
+                return _transform_llama2_chat(pred)
+            return transform_output_fn(pred) if transform_output_fn else pred
+
+
+class _DatabricksClusterDriverProxyClient(_DatabricksClientBase):
+    """An API client that talks to a Databricks cluster driver proxy app."""
+
+    host: str
+    cluster_id: str
+    cluster_driver_port: str
+
+    @root_validator(pre=True)
+    def set_api_url(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        if "api_url" not in values:
+            host = values["host"]
+            cluster_id = values["cluster_id"]
+            port = values["cluster_driver_port"]
+            api_url = f"https://{host}/driver-proxy-api/o/0/{cluster_id}/{port}"
+            values["api_url"] = api_url
+        return values
+
+    def post(
+        self, request: Any, transform_output_fn: Optional[Callable[..., str]] = None
+    ) -> Any:
+        resp = self._post(self.api_url, request)
+        return transform_output_fn(resp) if transform_output_fn else resp
+
+
+def get_repl_context() -> Any:
+    """Get the notebook REPL context if running inside a Databricks notebook.
+    Returns None otherwise.
+    """
+    try:
+        from dbruntime.databricks_repl_context import get_context
+
+        return get_context()
+    except ImportError:
+        raise ImportError(
+            "Cannot access dbruntime, not running inside a Databricks notebook."
+        )
+
+
+def get_default_host() -> str:
+    """Get the default Databricks workspace hostname.
+    Raises an error if the hostname cannot be automatically determined.
+    """
+    host = os.getenv("DATABRICKS_HOST")
+    if not host:
+        try:
+            host = get_repl_context().browserHostName
+            if not host:
+                raise ValueError("context doesn't contain browserHostName.")
+        except Exception as e:
+            raise ValueError(
+                "host was not set and cannot be automatically inferred. Set "
+                f"environment variable 'DATABRICKS_HOST'. Received error: {e}"
+            )
+    # TODO: support Databricks CLI profile
+    host = host.lstrip("https://").lstrip("http://").rstrip("/")
+    return host
+
+
+def get_default_api_token() -> str:
+    """Get the default Databricks personal access token.
+    Raises an error if the token cannot be automatically determined.
+    """
+    if api_token := os.getenv("DATABRICKS_TOKEN"):
+        return api_token
+    try:
+        api_token = get_repl_context().apiToken
+        if not api_token:
+            raise ValueError("context doesn't contain apiToken.")
+    except Exception as e:
+        raise ValueError(
+            "api_token was not set and cannot be automatically inferred. Set "
+            f"environment variable 'DATABRICKS_TOKEN'. Received error: {e}"
+        )
+    # TODO: support Databricks CLI profile
+    return api_token
+
+
+def _is_hex_string(data: str) -> bool:
+    """Checks if a data is a valid hexadecimal string using a regular expression."""
+    if not isinstance(data, str):
+        return False
+    pattern = r"^[0-9a-fA-F]+$"
+    return bool(re.match(pattern, data))
+
+
+def _load_pickled_fn_from_hex_string(
+    data: str, allow_dangerous_deserialization: Optional[bool]
+) -> Callable:
+    """Loads a pickled function from a hexadecimal string."""
+    if not allow_dangerous_deserialization:
+        raise ValueError(
+            "This code relies on the pickle module. "
+            "You will need to set allow_dangerous_deserialization=True "
+            "if you want to opt-in to allow deserialization of data using pickle."
+            "Data can be compromised by a malicious actor if "
+            "not handled properly to include "
+            "a malicious payload that when deserialized with "
+            "pickle can execute arbitrary code on your machine."
+        )
+
+    try:
+        import cloudpickle
+    except Exception as e:
+        raise ValueError(f"Please install cloudpickle>=2.0.0. Error: {e}")
+
+    try:
+        return cloudpickle.loads(bytes.fromhex(data))
+    except Exception as e:
+        raise ValueError(
+            f"Failed to load the pickled function from a hexadecimal string. Error: {e}"
+        )
+
+
+def _pickle_fn_to_hex_string(fn: Callable) -> str:
+    """Pickles a function and returns the hexadecimal string."""
+    try:
+        import cloudpickle
+    except Exception as e:
+        raise ValueError(f"Please install cloudpickle>=2.0.0. Error: {e}")
+
+    try:
+        return cloudpickle.dumps(fn).hex()
+    except Exception as e:
+        raise ValueError(f"Failed to pickle the function: {e}")
+
+
+class Databricks(LLM):
+    """Databricks serving endpoint or a cluster driver proxy app for LLM.
+
+    It supports two endpoint types:
+
+    * **Serving endpoint** (recommended for both production and development).
+      We assume that an LLM was deployed to a serving endpoint.
+      To wrap it as an LLM you must have "Can Query" permission to the endpoint.
+      Set ``endpoint_name`` accordingly and do not set ``cluster_id`` and
+      ``cluster_driver_port``.
+
+      If the underlying model is a model registered by MLflow, the expected model
+      signature is:
+
+      * inputs::
+
+          [{"name": "prompt", "type": "string"},
+           {"name": "stop", "type": "list[string]"}]
+
+      * outputs: ``[{"type": "string"}]``
+
+      If the underlying model is an external or foundation model, the response from the
+      endpoint is automatically transformed to the expected format unless
+      ``transform_output_fn`` is provided.
+
+    * **Cluster driver proxy app** (recommended for interactive development).
+      One can load an LLM on a Databricks interactive cluster and start a local HTTP
+      server on the driver node to serve the model at ``/`` using HTTP POST method
+      with JSON input/output.
+      Please use a port number between ``[3000, 8000]`` and let the server listen to
+      the driver IP address or simply ``0.0.0.0`` instead of localhost only.
+      To wrap it as an LLM you must have "Can Attach To" permission to the cluster.
+      Set ``cluster_id`` and ``cluster_driver_port`` and do not set ``endpoint_name``.
+      The expected server schema (using JSON schema) is:
+
+      * inputs::
+
+          {"type": "object",
+           "properties": {
+              "prompt": {"type": "string"},
+              "stop": {"type": "array", "items": {"type": "string"}}},
+           "required": ["prompt"]}`
+
+      * outputs: ``{"type": "string"}``
+
+    If the endpoint model signature is different or you want to set extra params,
+    you can use `transform_input_fn` and `transform_output_fn` to apply necessary
+    transformations before and after the query.
+    """
+
+    host: str = Field(default_factory=get_default_host)
+    """Databricks workspace hostname.
+    If not provided, the default value is determined by
+
+    * the ``DATABRICKS_HOST`` environment variable if present, or
+    * the hostname of the current Databricks workspace if running inside
+      a Databricks notebook attached to an interactive cluster in "single user"
+      or "no isolation shared" mode.
+    """
+
+    api_token: str = Field(default_factory=get_default_api_token)
+    """Databricks personal access token.
+    If not provided, the default value is determined by
+
+    * the ``DATABRICKS_TOKEN`` environment variable if present, or
+    * an automatically generated temporary token if running inside a Databricks
+      notebook attached to an interactive cluster in "single user" or
+      "no isolation shared" mode.
+    """
+
+    endpoint_name: Optional[str] = None
+    """Name of the model serving endpoint.
+    You must specify the endpoint name to connect to a model serving endpoint.
+    You must not set both ``endpoint_name`` and ``cluster_id``.
+    """
+
+    cluster_id: Optional[str] = None
+    """ID of the cluster if connecting to a cluster driver proxy app.
+    If neither ``endpoint_name`` nor ``cluster_id`` is not provided and the code runs
+    inside a Databricks notebook attached to an interactive cluster in "single user"
+    or "no isolation shared" mode, the current cluster ID is used as default.
+    You must not set both ``endpoint_name`` and ``cluster_id``.
+    """
+
+    cluster_driver_port: Optional[str] = None
+    """The port number used by the HTTP server running on the cluster driver node.
+    The server should listen on the driver IP address or simply ``0.0.0.0`` to connect.
+    We recommend the server using a port number between ``[3000, 8000]``.
+    """
+
+    model_kwargs: Optional[Dict[str, Any]] = None
+    """
+    Deprecated. Please use ``extra_params`` instead. Extra parameters to pass to
+    the endpoint.
+    """
+
+    transform_input_fn: Optional[Callable] = None
+    """A function that transforms ``{prompt, stop, **kwargs}`` into a JSON-compatible
+    request object that the endpoint accepts.
+    For example, you can apply a prompt template to the input prompt.
+    """
+
+    transform_output_fn: Optional[Callable[..., str]] = None
+    """A function that transforms the output from the endpoint to the generated text.
+    """
+
+    databricks_uri: str = "databricks"
+    """The databricks URI. Only used when using a serving endpoint."""
+
+    temperature: float = 0.0
+    """The sampling temperature."""
+    n: int = 1
+    """The number of completion choices to generate."""
+    stop: Optional[List[str]] = None
+    """The stop sequence."""
+    max_tokens: Optional[int] = None
+    """The maximum number of tokens to generate."""
+    extra_params: Dict[str, Any] = Field(default_factory=dict)
+    """Any extra parameters to pass to the endpoint."""
+    task: Optional[str] = None
+    """The task of the endpoint. Only used when using a serving endpoint.
+    If not provided, the task is automatically inferred from the endpoint.
+    """
+
+    allow_dangerous_deserialization: bool = False
+    """Whether to allow dangerous deserialization of the data which 
+    involves loading data using pickle.
+    
+    If the data has been modified by a malicious actor, it can deliver a
+    malicious payload that results in execution of arbitrary code on the target
+    machine.
+    """
+
+    _client: _DatabricksClientBase = PrivateAttr()
+
+    class Config:
+        extra = Extra.forbid
+        underscore_attrs_are_private = True
+
+    @property
+    def _llm_params(self) -> Dict[str, Any]:
+        params: Dict[str, Any] = {
+            "temperature": self.temperature,
+            "n": self.n,
+        }
+        if self.stop:
+            params["stop"] = self.stop
+        if self.max_tokens is not None:
+            params["max_tokens"] = self.max_tokens
+        return params
+
+    @validator("cluster_id", always=True)
+    def set_cluster_id(cls, v: Any, values: Dict[str, Any]) -> Optional[str]:
+        if v and values["endpoint_name"]:
+            raise ValueError("Cannot set both endpoint_name and cluster_id.")
+        elif values["endpoint_name"]:
+            return None
+        elif v:
+            return v
+        else:
+            try:
+                if v := get_repl_context().clusterId:
+                    return v
+                raise ValueError("Context doesn't contain clusterId.")
+            except Exception as e:
+                raise ValueError(
+                    "Neither endpoint_name nor cluster_id was set. "
+                    "And the cluster_id cannot be automatically determined. Received"
+                    f" error: {e}"
+                )
+
+    @validator("cluster_driver_port", always=True)
+    def set_cluster_driver_port(cls, v: Any, values: Dict[str, Any]) -> Optional[str]:
+        if v and values["endpoint_name"]:
+            raise ValueError("Cannot set both endpoint_name and cluster_driver_port.")
+        elif values["endpoint_name"]:
+            return None
+        elif v is None:
+            raise ValueError(
+                "Must set cluster_driver_port to connect to a cluster driver."
+            )
+        elif int(v) <= 0:
+            raise ValueError(f"Invalid cluster_driver_port: {v}")
+        else:
+            return v
+
+    @validator("model_kwargs", always=True)
+    def set_model_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]:
+        if v:
+            assert "prompt" not in v, "model_kwargs must not contain key 'prompt'"
+            assert "stop" not in v, "model_kwargs must not contain key 'stop'"
+        return v
+
+    def __init__(self, **data: Any):
+        if "transform_input_fn" in data and _is_hex_string(data["transform_input_fn"]):
+            data["transform_input_fn"] = _load_pickled_fn_from_hex_string(
+                data=data["transform_input_fn"],
+                allow_dangerous_deserialization=data.get(
+                    "allow_dangerous_deserialization"
+                ),
+            )
+        if "transform_output_fn" in data and _is_hex_string(
+            data["transform_output_fn"]
+        ):
+            data["transform_output_fn"] = _load_pickled_fn_from_hex_string(
+                data=data["transform_output_fn"],
+                allow_dangerous_deserialization=data.get(
+                    "allow_dangerous_deserialization"
+                ),
+            )
+
+        super().__init__(**data)
+        if self.model_kwargs is not None and self.extra_params is not None:
+            raise ValueError("Cannot set both extra_params and extra_params.")
+        elif self.model_kwargs is not None:
+            warnings.warn(
+                "model_kwargs is deprecated. Please use extra_params instead.",
+                DeprecationWarning,
+            )
+        if self.endpoint_name:
+            self._client = _DatabricksServingEndpointClient(
+                host=self.host,
+                api_token=self.api_token,
+                endpoint_name=self.endpoint_name,
+                databricks_uri=self.databricks_uri,
+                task=self.task,
+            )
+        elif self.cluster_id and self.cluster_driver_port:
+            self._client = _DatabricksClusterDriverProxyClient(
+                host=self.host,
+                api_token=self.api_token,
+                cluster_id=self.cluster_id,
+                cluster_driver_port=self.cluster_driver_port,
+            )
+        else:
+            raise ValueError(
+                "Must specify either endpoint_name or cluster_id/cluster_driver_port."
+            )
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Return default params."""
+        return {
+            "host": self.host,
+            # "api_token": self.api_token,  # Never save the token
+            "endpoint_name": self.endpoint_name,
+            "cluster_id": self.cluster_id,
+            "cluster_driver_port": self.cluster_driver_port,
+            "databricks_uri": self.databricks_uri,
+            "model_kwargs": self.model_kwargs,
+            "temperature": self.temperature,
+            "n": self.n,
+            "stop": self.stop,
+            "max_tokens": self.max_tokens,
+            "extra_params": self.extra_params,
+            "task": self.task,
+            "transform_input_fn": None
+            if self.transform_input_fn is None
+            else _pickle_fn_to_hex_string(self.transform_input_fn),
+            "transform_output_fn": None
+            if self.transform_output_fn is None
+            else _pickle_fn_to_hex_string(self.transform_output_fn),
+        }
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        return self._default_params
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "databricks"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Queries the LLM endpoint with the given prompt and stop sequence."""
+
+        # TODO: support callbacks
+
+        request: Dict[str, Any] = {"prompt": prompt}
+        if self._client.llm:
+            request.update(self._llm_params)
+        request.update(self.model_kwargs or self.extra_params)
+        request.update(kwargs)
+        if stop:
+            request["stop"] = stop
+
+        if self.transform_input_fn:
+            request = self.transform_input_fn(**request)
+
+        return self._client.post(request, transform_output_fn=self.transform_output_fn)
diff --git a/llm/Lib/site-packages/langchain_community/llms/deepinfra.py b/llm/Lib/site-packages/langchain_community/llms/deepinfra.py
new file mode 100644
index 0000000000000000000000000000000000000000..65911921a2f7e44385b278359e43d72265e986bd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/deepinfra.py
@@ -0,0 +1,219 @@
+import json
+from typing import Any, AsyncIterator, Dict, Iterator, List, Mapping, Optional
+
+import aiohttp
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.utilities.requests import Requests
+
+DEFAULT_MODEL_ID = "google/flan-t5-xl"
+
+
+class DeepInfra(LLM):
+    """DeepInfra models.
+
+    To use, you should have the environment variable ``DEEPINFRA_API_TOKEN``
+    set with your API token, or pass it as a named parameter to the
+    constructor.
+
+    Only supports `text-generation` and `text2text-generation` for now.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import DeepInfra
+            di = DeepInfra(model_id="google/flan-t5-xl",
+                                deepinfra_api_token="my-api-key")
+    """
+
+    model_id: str = DEFAULT_MODEL_ID
+    model_kwargs: Optional[Dict] = None
+
+    deepinfra_api_token: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        deepinfra_api_token = get_from_dict_or_env(
+            values, "deepinfra_api_token", "DEEPINFRA_API_TOKEN"
+        )
+        values["deepinfra_api_token"] = deepinfra_api_token
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"model_id": self.model_id},
+            **{"model_kwargs": self.model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "deepinfra"
+
+    def _url(self) -> str:
+        return f"https://api.deepinfra.com/v1/inference/{self.model_id}"
+
+    def _headers(self) -> Dict:
+        return {
+            "Authorization": f"bearer {self.deepinfra_api_token}",
+            "Content-Type": "application/json",
+        }
+
+    def _body(self, prompt: str, kwargs: Any) -> Dict:
+        model_kwargs = self.model_kwargs or {}
+        model_kwargs = {**model_kwargs, **kwargs}
+
+        return {
+            "input": prompt,
+            **model_kwargs,
+        }
+
+    def _handle_status(self, code: int, text: Any) -> None:
+        if code >= 500:
+            raise Exception(f"DeepInfra Server: Error {code}")
+        elif code >= 400:
+            raise ValueError(f"DeepInfra received an invalid payload: {text}")
+        elif code != 200:
+            raise Exception(
+                f"DeepInfra returned an unexpected response with status "
+                f"{code}: {text}"
+            )
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to DeepInfra's inference API endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = di("Tell me a joke.")
+        """
+
+        request = Requests(headers=self._headers())
+        response = request.post(url=self._url(), data=self._body(prompt, kwargs))
+
+        self._handle_status(response.status_code, response.text)
+        data = response.json()
+
+        return data["results"][0]["generated_text"]
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        request = Requests(headers=self._headers())
+        async with request.apost(
+            url=self._url(), data=self._body(prompt, kwargs)
+        ) as response:
+            self._handle_status(response.status, response.text)
+            data = await response.json()
+            return data["results"][0]["generated_text"]
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        request = Requests(headers=self._headers())
+        response = request.post(
+            url=self._url(), data=self._body(prompt, {**kwargs, "stream": True})
+        )
+
+        self._handle_status(response.status_code, response.text)
+        for line in _parse_stream(response.iter_lines()):
+            chunk = _handle_sse_line(line)
+            if chunk:
+                if run_manager:
+                    run_manager.on_llm_new_token(chunk.text)
+                yield chunk
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        request = Requests(headers=self._headers())
+        async with request.apost(
+            url=self._url(), data=self._body(prompt, {**kwargs, "stream": True})
+        ) as response:
+            self._handle_status(response.status, response.text)
+            async for line in _parse_stream_async(response.content):
+                chunk = _handle_sse_line(line)
+                if chunk:
+                    if run_manager:
+                        await run_manager.on_llm_new_token(chunk.text)
+                    yield chunk
+
+
+def _parse_stream(rbody: Iterator[bytes]) -> Iterator[str]:
+    for line in rbody:
+        _line = _parse_stream_helper(line)
+        if _line is not None:
+            yield _line
+
+
+async def _parse_stream_async(rbody: aiohttp.StreamReader) -> AsyncIterator[str]:
+    async for line in rbody:
+        _line = _parse_stream_helper(line)
+        if _line is not None:
+            yield _line
+
+
+def _parse_stream_helper(line: bytes) -> Optional[str]:
+    if line and line.startswith(b"data:"):
+        if line.startswith(b"data: "):
+            # SSE event may be valid when it contain whitespace
+            line = line[len(b"data: ") :]
+        else:
+            line = line[len(b"data:") :]
+        if line.strip() == b"[DONE]":
+            # return here will cause GeneratorExit exception in urllib3
+            # and it will close http connection with TCP Reset
+            return None
+        else:
+            return line.decode("utf-8")
+    return None
+
+
+def _handle_sse_line(line: str) -> Optional[GenerationChunk]:
+    try:
+        obj = json.loads(line)
+        return GenerationChunk(
+            text=obj.get("token", {}).get("text"),
+        )
+    except Exception:
+        return None
diff --git a/llm/Lib/site-packages/langchain_community/llms/deepsparse.py b/llm/Lib/site-packages/langchain_community/llms/deepsparse.py
new file mode 100644
index 0000000000000000000000000000000000000000..c82f022e2756a022189aebc80a84754e78d36408
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/deepsparse.py
@@ -0,0 +1,228 @@
+# flake8: noqa
+from typing import Any, AsyncIterator, Dict, Iterator, List, Optional, Union
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_community.llms.utils import enforce_stop_tokens
+from langchain_core.outputs import GenerationChunk
+
+
+class DeepSparse(LLM):
+    """Neural Magic DeepSparse LLM interface.
+    To use, you should have the ``deepsparse`` or ``deepsparse-nightly``
+    python package installed. See https://github.com/neuralmagic/deepsparse
+    This interface let's you deploy optimized LLMs straight from the
+    [SparseZoo](https://sparsezoo.neuralmagic.com/?useCase=text_generation)
+    Example:
+        .. code-block:: python
+            from langchain_community.llms import DeepSparse
+            llm = DeepSparse(model="zoo:nlg/text_generation/codegen_mono-350m/pytorch/huggingface/bigpython_bigquery_thepile/base_quant-none")
+    """  # noqa: E501
+
+    pipeline: Any  #: :meta private:
+
+    model: str
+    """The path to a model file or directory or the name of a SparseZoo model stub."""
+
+    model_config: Optional[Dict[str, Any]] = None
+    """Keyword arguments passed to the pipeline construction.
+    Common parameters are sequence_length, prompt_sequence_length"""
+
+    generation_config: Union[None, str, Dict] = None
+    """GenerationConfig dictionary consisting of parameters used to control
+    sequences generated for each prompt. Common parameters are:
+    max_length, max_new_tokens, num_return_sequences, output_scores,
+    top_p, top_k, repetition_penalty."""
+
+    streaming: bool = False
+    """Whether to stream the results, token by token."""
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model": self.model,
+            "model_config": self.model_config,
+            "generation_config": self.generation_config,
+            "streaming": self.streaming,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "deepsparse"
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that ``deepsparse`` package is installed."""
+        try:
+            from deepsparse import Pipeline
+        except ImportError:
+            raise ImportError(
+                "Could not import `deepsparse` package. "
+                "Please install it with `pip install deepsparse[llm]`"
+            )
+
+        model_config = values["model_config"] or {}
+
+        values["pipeline"] = Pipeline.create(
+            task="text_generation",
+            model_path=values["model"],
+            **model_config,
+        )
+        return values
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Generate text from a prompt.
+        Args:
+            prompt: The prompt to generate text from.
+            stop: A list of strings to stop generation when encountered.
+        Returns:
+            The generated text.
+        Example:
+            .. code-block:: python
+                from langchain_community.llms import DeepSparse
+                llm = DeepSparse(model="zoo:nlg/text_generation/codegen_mono-350m/pytorch/huggingface/bigpython_bigquery_thepile/base_quant-none")
+                llm("Tell me a joke.")
+        """
+        if self.streaming:
+            combined_output = ""
+            for chunk in self._stream(
+                prompt=prompt, stop=stop, run_manager=run_manager, **kwargs
+            ):
+                combined_output += chunk.text
+            text = combined_output
+        else:
+            text = (
+                self.pipeline(sequences=prompt, **self.generation_config)
+                .generations[0]
+                .text
+            )
+
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+
+        return text
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Generate text from a prompt.
+        Args:
+            prompt: The prompt to generate text from.
+            stop: A list of strings to stop generation when encountered.
+        Returns:
+            The generated text.
+        Example:
+            .. code-block:: python
+                from langchain_community.llms import DeepSparse
+                llm = DeepSparse(model="zoo:nlg/text_generation/codegen_mono-350m/pytorch/huggingface/bigpython_bigquery_thepile/base_quant-none")
+                llm("Tell me a joke.")
+        """
+        if self.streaming:
+            combined_output = ""
+            async for chunk in self._astream(
+                prompt=prompt, stop=stop, run_manager=run_manager, **kwargs
+            ):
+                combined_output += chunk.text
+            text = combined_output
+        else:
+            text = (
+                self.pipeline(sequences=prompt, **self.generation_config)
+                .generations[0]
+                .text
+            )
+
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+
+        return text
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        """Yields results objects as they are generated in real time.
+        It also calls the callback manager's on_llm_new_token event with
+        similar parameters to the OpenAI LLM class method of the same name.
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+        Returns:
+            A generator representing the stream of tokens being generated.
+        Yields:
+            A dictionary like object containing a string token.
+        Example:
+            .. code-block:: python
+                from langchain_community.llms import DeepSparse
+                llm = DeepSparse(
+                    model="zoo:nlg/text_generation/codegen_mono-350m/pytorch/huggingface/bigpython_bigquery_thepile/base_quant-none",
+                    streaming=True
+                )
+                for chunk in llm.stream("Tell me a joke",
+                        stop=["'","\n"]):
+                    print(chunk, end='', flush=True)  # noqa: T201
+        """
+        inference = self.pipeline(
+            sequences=prompt, streaming=True, **self.generation_config
+        )
+        for token in inference:
+            chunk = GenerationChunk(text=token.generations[0].text)
+            yield chunk
+
+            if run_manager:
+                run_manager.on_llm_new_token(token=chunk.text)
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        """Yields results objects as they are generated in real time.
+        It also calls the callback manager's on_llm_new_token event with
+        similar parameters to the OpenAI LLM class method of the same name.
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+        Returns:
+            A generator representing the stream of tokens being generated.
+        Yields:
+            A dictionary like object containing a string token.
+        Example:
+            .. code-block:: python
+                from langchain_community.llms import DeepSparse
+                llm = DeepSparse(
+                    model="zoo:nlg/text_generation/codegen_mono-350m/pytorch/huggingface/bigpython_bigquery_thepile/base_quant-none",
+                    streaming=True
+                )
+                for chunk in llm.stream("Tell me a joke",
+                        stop=["'","\n"]):
+                    print(chunk, end='', flush=True)  # noqa: T201
+        """
+        inference = self.pipeline(
+            sequences=prompt, streaming=True, **self.generation_config
+        )
+        for token in inference:
+            chunk = GenerationChunk(text=token.generations[0].text)
+            yield chunk
+
+            if run_manager:
+                await run_manager.on_llm_new_token(token=chunk.text)
diff --git a/llm/Lib/site-packages/langchain_community/llms/edenai.py b/llm/Lib/site-packages/langchain_community/llms/edenai.py
new file mode 100644
index 0000000000000000000000000000000000000000..e397aa7a2aa7fb1c7a921ba24505b453c9529332
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/edenai.py
@@ -0,0 +1,265 @@
+"""Wrapper around EdenAI's Generation API."""
+import logging
+from typing import Any, Dict, List, Literal, Optional
+
+from aiohttp import ClientSession
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+from langchain_community.utilities.requests import Requests
+
+logger = logging.getLogger(__name__)
+
+
+class EdenAI(LLM):
+    """EdenAI models.
+
+    To use, you should have
+    the environment variable ``EDENAI_API_KEY`` set with your API token.
+    You can find your token here: https://app.edenai.run/admin/account/settings
+
+    `feature` and `subfeature` are required, but any other model parameters can also be
+    passed in with the format params={model_param: value, ...}
+
+    for api reference check edenai documentation: http://docs.edenai.co.
+    """
+
+    base_url: str = "https://api.edenai.run/v2"
+
+    edenai_api_key: Optional[str] = None
+
+    feature: Literal["text", "image"] = "text"
+    """Which generative feature to use, use text by default"""
+
+    subfeature: Literal["generation"] = "generation"
+    """Subfeature of above feature, use generation by default"""
+
+    provider: str
+    """Generative provider to use (eg: openai,stabilityai,cohere,google etc.)"""
+
+    model: Optional[str] = None
+    """
+    model name for above provider (eg: 'gpt-3.5-turbo-instruct' for openai)
+    available models are shown on https://docs.edenai.co/ under 'available providers'
+    """
+
+    # Optional parameters to add depending of chosen feature
+    # see api reference for more infos
+    temperature: Optional[float] = Field(default=None, ge=0, le=1)  # for text
+    max_tokens: Optional[int] = Field(default=None, ge=0)  # for text
+    resolution: Optional[Literal["256x256", "512x512", "1024x1024"]] = None  # for image
+
+    params: Dict[str, Any] = Field(default_factory=dict)
+    """
+    DEPRECATED: use temperature, max_tokens, resolution directly
+    optional parameters to pass to api
+    """
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """extra parameters"""
+
+    stop_sequences: Optional[List[str]] = None
+    """Stop sequences to use."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        values["edenai_api_key"] = get_from_dict_or_env(
+            values, "edenai_api_key", "EDENAI_API_KEY"
+        )
+        return values
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = {field.alias for field in cls.__fields__.values()}
+
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name not in all_required_field_names:
+                if field_name in extra:
+                    raise ValueError(f"Found {field_name} supplied twice.")
+                logger.warning(
+                    f"""{field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+        values["model_kwargs"] = extra
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of model."""
+        return "edenai"
+
+    def _format_output(self, output: dict) -> str:
+        if self.feature == "text":
+            return output[self.provider]["generated_text"]
+        else:
+            return output[self.provider]["items"][0]["image"]
+
+    @staticmethod
+    def get_user_agent() -> str:
+        from langchain_community import __version__
+
+        return f"langchain/{__version__}"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to EdenAI's text generation endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+
+        Returns:
+            json formatted str response.
+        """
+        stops = None
+        if self.stop_sequences is not None and stop is not None:
+            raise ValueError(
+                "stop sequences found in both the input and default params."
+            )
+        elif self.stop_sequences is not None:
+            stops = self.stop_sequences
+        else:
+            stops = stop
+
+        url = f"{self.base_url}/{self.feature}/{self.subfeature}"
+        headers = {
+            "Authorization": f"Bearer {self.edenai_api_key}",
+            "User-Agent": self.get_user_agent(),
+        }
+        payload: Dict[str, Any] = {
+            "providers": self.provider,
+            "text": prompt,
+            "max_tokens": self.max_tokens,
+            "temperature": self.temperature,
+            "resolution": self.resolution,
+            **self.params,
+            **kwargs,
+            "num_images": 1,  # always limit to 1 (ignored for text)
+        }
+
+        # filter None values to not pass them to the http payload
+        payload = {k: v for k, v in payload.items() if v is not None}
+
+        if self.model is not None:
+            payload["settings"] = {self.provider: self.model}
+
+        request = Requests(headers=headers)
+        response = request.post(url=url, data=payload)
+
+        if response.status_code >= 500:
+            raise Exception(f"EdenAI Server: Error {response.status_code}")
+        elif response.status_code >= 400:
+            raise ValueError(f"EdenAI received an invalid payload: {response.text}")
+        elif response.status_code != 200:
+            raise Exception(
+                f"EdenAI returned an unexpected response with status "
+                f"{response.status_code}: {response.text}"
+            )
+
+        data = response.json()
+        provider_response = data[self.provider]
+        if provider_response.get("status") == "fail":
+            err_msg = provider_response.get("error", {}).get("message")
+            raise Exception(err_msg)
+
+        output = self._format_output(data)
+
+        if stops is not None:
+            output = enforce_stop_tokens(output, stops)
+
+        return output
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call EdenAi model to get predictions based on the prompt.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: A list of stop words (optional).
+            run_manager: A callback manager for async interaction with LLMs.
+
+        Returns:
+            The string generated by the model.
+        """
+
+        stops = None
+        if self.stop_sequences is not None and stop is not None:
+            raise ValueError(
+                "stop sequences found in both the input and default params."
+            )
+        elif self.stop_sequences is not None:
+            stops = self.stop_sequences
+        else:
+            stops = stop
+
+        url = f"{self.base_url}/{self.feature}/{self.subfeature}"
+        headers = {
+            "Authorization": f"Bearer {self.edenai_api_key}",
+            "User-Agent": self.get_user_agent(),
+        }
+        payload: Dict[str, Any] = {
+            "providers": self.provider,
+            "text": prompt,
+            "max_tokens": self.max_tokens,
+            "temperature": self.temperature,
+            "resolution": self.resolution,
+            **self.params,
+            **kwargs,
+            "num_images": 1,  # always limit to 1 (ignored for text)
+        }
+
+        # filter `None` values to not pass them to the http payload as null
+        payload = {k: v for k, v in payload.items() if v is not None}
+
+        if self.model is not None:
+            payload["settings"] = {self.provider: self.model}
+
+        async with ClientSession() as session:
+            async with session.post(url, json=payload, headers=headers) as response:
+                if response.status >= 500:
+                    raise Exception(f"EdenAI Server: Error {response.status}")
+                elif response.status >= 400:
+                    raise ValueError(
+                        f"EdenAI received an invalid payload: {response.text}"
+                    )
+                elif response.status != 200:
+                    raise Exception(
+                        f"EdenAI returned an unexpected response with status "
+                        f"{response.status}: {response.text}"
+                    )
+
+                response_json = await response.json()
+                provider_response = response_json[self.provider]
+                if provider_response.get("status") == "fail":
+                    err_msg = provider_response.get("error", {}).get("message")
+                    raise Exception(err_msg)
+
+                output = self._format_output(response_json)
+                if stops is not None:
+                    output = enforce_stop_tokens(output, stops)
+
+                return output
diff --git a/llm/Lib/site-packages/langchain_community/llms/fake.py b/llm/Lib/site-packages/langchain_community/llms/fake.py
new file mode 100644
index 0000000000000000000000000000000000000000..929fd19eb242a7421116e4195dd316790e0180c6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/fake.py
@@ -0,0 +1,90 @@
+import asyncio
+import time
+from typing import Any, AsyncIterator, Iterator, List, Mapping, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models import LanguageModelInput
+from langchain_core.language_models.llms import LLM
+from langchain_core.runnables import RunnableConfig
+
+
+class FakeListLLM(LLM):
+    """Fake LLM for testing purposes."""
+
+    responses: List[str]
+    sleep: Optional[float] = None
+    i: int = 0
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "fake-list"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Return next response"""
+        response = self.responses[self.i]
+        if self.i < len(self.responses) - 1:
+            self.i += 1
+        else:
+            self.i = 0
+        return response
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Return next response"""
+        response = self.responses[self.i]
+        if self.i < len(self.responses) - 1:
+            self.i += 1
+        else:
+            self.i = 0
+        return response
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        return {"responses": self.responses}
+
+
+class FakeStreamingListLLM(FakeListLLM):
+    """Fake streaming list LLM for testing purposes."""
+
+    def stream(
+        self,
+        input: LanguageModelInput,
+        config: Optional[RunnableConfig] = None,
+        *,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Iterator[str]:
+        result = self.invoke(input, config)
+        for c in result:
+            if self.sleep is not None:
+                time.sleep(self.sleep)
+            yield c
+
+    async def astream(
+        self,
+        input: LanguageModelInput,
+        config: Optional[RunnableConfig] = None,
+        *,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[str]:
+        result = await self.ainvoke(input, config)
+        for c in result:
+            if self.sleep is not None:
+                await asyncio.sleep(self.sleep)
+            yield c
diff --git a/llm/Lib/site-packages/langchain_community/llms/fireworks.py b/llm/Lib/site-packages/langchain_community/llms/fireworks.py
new file mode 100644
index 0000000000000000000000000000000000000000..1bf40264d59b3d4fe2ac4a75ed60f865976104b5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/fireworks.py
@@ -0,0 +1,387 @@
+import asyncio
+from concurrent.futures import ThreadPoolExecutor
+from typing import Any, AsyncIterator, Callable, Dict, Iterator, List, Optional, Union
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import BaseLLM, create_base_retry_decorator
+from langchain_core.outputs import Generation, GenerationChunk, LLMResult
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str
+from langchain_core.utils.env import get_from_dict_or_env
+
+
+def _stream_response_to_generation_chunk(
+    stream_response: Any,
+) -> GenerationChunk:
+    """Convert a stream response to a generation chunk."""
+    return GenerationChunk(
+        text=stream_response.choices[0].text,
+        generation_info=dict(
+            finish_reason=stream_response.choices[0].finish_reason,
+            logprobs=stream_response.choices[0].logprobs,
+        ),
+    )
+
+
+@deprecated(
+    since="0.0.26",
+    removal="0.2",
+    alternative_import="langchain_fireworks.Fireworks",
+)
+class Fireworks(BaseLLM):
+    """Fireworks models."""
+
+    model: str = "accounts/fireworks/models/llama-v2-7b-chat"
+    model_kwargs: dict = Field(
+        default_factory=lambda: {
+            "temperature": 0.7,
+            "max_tokens": 512,
+            "top_p": 1,
+        }.copy()
+    )
+    fireworks_api_key: Optional[SecretStr] = None
+    max_retries: int = 20
+    batch_size: int = 20
+    use_retry: bool = True
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"fireworks_api_key": "FIREWORKS_API_KEY"}
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "llms", "fireworks"]
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key in environment."""
+        try:
+            import fireworks.client
+        except ImportError as e:
+            raise ImportError(
+                "Could not import fireworks-ai python package. "
+                "Please install it with `pip install fireworks-ai`."
+            ) from e
+        fireworks_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "fireworks_api_key", "FIREWORKS_API_KEY")
+        )
+        fireworks.client.api_key = fireworks_api_key.get_secret_value()
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "fireworks"
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Call out to Fireworks endpoint with k unique prompts.
+        Args:
+            prompts: The prompts to pass into the model.
+            stop: Optional list of stop words to use when generating.
+        Returns:
+            The full LLM output.
+        """
+        params = {
+            "model": self.model,
+            **self.model_kwargs,
+        }
+        sub_prompts = self.get_batch_prompts(prompts)
+        choices = []
+        for _prompts in sub_prompts:
+            response = completion_with_retry_batching(
+                self,
+                self.use_retry,
+                prompt=_prompts,
+                run_manager=run_manager,
+                stop=stop,
+                **params,
+            )
+            choices.extend(response)
+
+        return self.create_llm_result(choices, prompts)
+
+    async def _agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Call out to Fireworks endpoint async with k unique prompts."""
+        params = {
+            "model": self.model,
+            **self.model_kwargs,
+        }
+        sub_prompts = self.get_batch_prompts(prompts)
+        choices = []
+        for _prompts in sub_prompts:
+            response = await acompletion_with_retry_batching(
+                self,
+                self.use_retry,
+                prompt=_prompts,
+                run_manager=run_manager,
+                stop=stop,
+                **params,
+            )
+            choices.extend(response)
+
+        return self.create_llm_result(choices, prompts)
+
+    def get_batch_prompts(
+        self,
+        prompts: List[str],
+    ) -> List[List[str]]:
+        """Get the sub prompts for llm call."""
+        sub_prompts = [
+            prompts[i : i + self.batch_size]
+            for i in range(0, len(prompts), self.batch_size)
+        ]
+        return sub_prompts
+
+    def create_llm_result(self, choices: Any, prompts: List[str]) -> LLMResult:
+        """Create the LLMResult from the choices and prompts."""
+        generations = []
+        for i, _ in enumerate(prompts):
+            sub_choices = choices[i : (i + 1)]
+            generations.append(
+                [
+                    Generation(
+                        text=choice.__dict__["choices"][0].text,
+                    )
+                    for choice in sub_choices
+                ]
+            )
+        llm_output = {"model": self.model}
+        return LLMResult(generations=generations, llm_output=llm_output)
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        params = {
+            "model": self.model,
+            "prompt": prompt,
+            "stream": True,
+            **self.model_kwargs,
+        }
+        for stream_resp in completion_with_retry(
+            self, self.use_retry, run_manager=run_manager, stop=stop, **params
+        ):
+            chunk = _stream_response_to_generation_chunk(stream_resp)
+            if run_manager:
+                run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+            yield chunk
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        params = {
+            "model": self.model,
+            "prompt": prompt,
+            "stream": True,
+            **self.model_kwargs,
+        }
+        async for stream_resp in await acompletion_with_retry_streaming(
+            self, self.use_retry, run_manager=run_manager, stop=stop, **params
+        ):
+            chunk = _stream_response_to_generation_chunk(stream_resp)
+            if run_manager:
+                await run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+            yield chunk
+
+
+def conditional_decorator(
+    condition: bool, decorator: Callable[[Any], Any]
+) -> Callable[[Any], Any]:
+    """Conditionally apply a decorator.
+
+    Args:
+        condition: A boolean indicating whether to apply the decorator.
+        decorator: A decorator function.
+
+    Returns:
+        A decorator function.
+    """
+
+    def actual_decorator(func: Callable[[Any], Any]) -> Callable[[Any], Any]:
+        if condition:
+            return decorator(func)
+        return func
+
+    return actual_decorator
+
+
+def completion_with_retry(
+    llm: Fireworks,
+    use_retry: bool,
+    *,
+    run_manager: Optional[CallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the completion call."""
+    import fireworks.client
+
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @conditional_decorator(use_retry, retry_decorator)
+    def _completion_with_retry(**kwargs: Any) -> Any:
+        return fireworks.client.Completion.create(
+            **kwargs,
+        )
+
+    return _completion_with_retry(**kwargs)
+
+
+async def acompletion_with_retry(
+    llm: Fireworks,
+    use_retry: bool,
+    *,
+    run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the completion call."""
+    import fireworks.client
+
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @conditional_decorator(use_retry, retry_decorator)
+    async def _completion_with_retry(**kwargs: Any) -> Any:
+        return await fireworks.client.Completion.acreate(
+            **kwargs,
+        )
+
+    return await _completion_with_retry(**kwargs)
+
+
+def completion_with_retry_batching(
+    llm: Fireworks,
+    use_retry: bool,
+    *,
+    run_manager: Optional[CallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the completion call."""
+    import fireworks.client
+
+    prompt = kwargs["prompt"]
+    del kwargs["prompt"]
+
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @conditional_decorator(use_retry, retry_decorator)
+    def _completion_with_retry(prompt: str) -> Any:
+        return fireworks.client.Completion.create(**kwargs, prompt=prompt)
+
+    def batch_sync_run() -> List:
+        with ThreadPoolExecutor() as executor:
+            results = list(executor.map(_completion_with_retry, prompt))
+        return results
+
+    return batch_sync_run()
+
+
+async def acompletion_with_retry_batching(
+    llm: Fireworks,
+    use_retry: bool,
+    *,
+    run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the completion call."""
+    import fireworks.client
+
+    prompt = kwargs["prompt"]
+    del kwargs["prompt"]
+
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @conditional_decorator(use_retry, retry_decorator)
+    async def _completion_with_retry(prompt: str) -> Any:
+        return await fireworks.client.Completion.acreate(**kwargs, prompt=prompt)
+
+    def run_coroutine_in_new_loop(
+        coroutine_func: Any, *args: Dict, **kwargs: Dict
+    ) -> Any:
+        new_loop = asyncio.new_event_loop()
+        try:
+            asyncio.set_event_loop(new_loop)
+            return new_loop.run_until_complete(coroutine_func(*args, **kwargs))
+        finally:
+            new_loop.close()
+
+    async def batch_sync_run() -> List:
+        with ThreadPoolExecutor() as executor:
+            results = list(
+                executor.map(
+                    run_coroutine_in_new_loop,
+                    [_completion_with_retry] * len(prompt),
+                    prompt,
+                )
+            )
+        return results
+
+    return await batch_sync_run()
+
+
+async def acompletion_with_retry_streaming(
+    llm: Fireworks,
+    use_retry: bool,
+    *,
+    run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the completion call for streaming."""
+    import fireworks.client
+
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @conditional_decorator(use_retry, retry_decorator)
+    async def _completion_with_retry(**kwargs: Any) -> Any:
+        return fireworks.client.Completion.acreate(
+            **kwargs,
+        )
+
+    return await _completion_with_retry(**kwargs)
+
+
+def _create_retry_decorator(
+    llm: Fireworks,
+    *,
+    run_manager: Optional[
+        Union[AsyncCallbackManagerForLLMRun, CallbackManagerForLLMRun]
+    ] = None,
+) -> Callable[[Any], Any]:
+    """Define retry mechanism."""
+    import fireworks.client
+
+    errors = [
+        fireworks.client.error.RateLimitError,
+        fireworks.client.error.InternalServerError,
+        fireworks.client.error.BadGatewayError,
+        fireworks.client.error.ServiceUnavailableError,
+    ]
+    return create_base_retry_decorator(
+        error_types=errors, max_retries=llm.max_retries, run_manager=run_manager
+    )
diff --git a/llm/Lib/site-packages/langchain_community/llms/forefrontai.py b/llm/Lib/site-packages/langchain_community/llms/forefrontai.py
new file mode 100644
index 0000000000000000000000000000000000000000..b4220ad9a924f8ddf966f5f0e521ed420069b306
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/forefrontai.py
@@ -0,0 +1,119 @@
+from typing import Any, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+
+class ForefrontAI(LLM):
+    """ForefrontAI large language models.
+
+    To use, you should have the environment variable ``FOREFRONTAI_API_KEY``
+    set with your API key.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import ForefrontAI
+            forefrontai = ForefrontAI(endpoint_url="")
+    """
+
+    endpoint_url: str = ""
+    """Model name to use."""
+
+    temperature: float = 0.7
+    """What sampling temperature to use."""
+
+    length: int = 256
+    """The maximum number of tokens to generate in the completion."""
+
+    top_p: float = 1.0
+    """Total probability mass of tokens to consider at each step."""
+
+    top_k: int = 40
+    """The number of highest probability vocabulary tokens to
+    keep for top-k-filtering."""
+
+    repetition_penalty: int = 1
+    """Penalizes repeated tokens according to frequency."""
+
+    forefrontai_api_key: SecretStr
+
+    base_url: Optional[str] = None
+    """Base url to use, if None decides based on model name."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        values["forefrontai_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "forefrontai_api_key", "FOREFRONTAI_API_KEY")
+        )
+        return values
+
+    @property
+    def _default_params(self) -> Mapping[str, Any]:
+        """Get the default parameters for calling ForefrontAI API."""
+        return {
+            "temperature": self.temperature,
+            "length": self.length,
+            "top_p": self.top_p,
+            "top_k": self.top_k,
+            "repetition_penalty": self.repetition_penalty,
+        }
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"endpoint_url": self.endpoint_url}, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "forefrontai"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to ForefrontAI's complete endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = ForefrontAI("Tell me a joke.")
+        """
+        auth_value = f"Bearer {self.forefrontai_api_key.get_secret_value()}"
+        response = requests.post(
+            url=self.endpoint_url,
+            headers={
+                "Authorization": auth_value,
+                "Content-Type": "application/json",
+            },
+            json={"text": prompt, **self._default_params, **kwargs},
+        )
+        response_json = response.json()
+        text = response_json["result"][0]["completion"]
+        if stop is not None:
+            # I believe this is required since the stop tokens
+            # are not enforced by the model parameters
+            text = enforce_stop_tokens(text, stop)
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/friendli.py b/llm/Lib/site-packages/langchain_community/llms/friendli.py
new file mode 100644
index 0000000000000000000000000000000000000000..88e23e4ac8a5f1bf09e449ea5bab256c0798b0de
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/friendli.py
@@ -0,0 +1,350 @@
+from __future__ import annotations
+
+import os
+from typing import Any, AsyncIterator, Dict, Iterator, List, Optional
+
+from langchain_core.callbacks.manager import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.load.serializable import Serializable
+from langchain_core.outputs import GenerationChunk, LLMResult
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils.env import get_from_dict_or_env
+from langchain_core.utils.utils import convert_to_secret_str
+
+
+def _stream_response_to_generation_chunk(stream_response: Any) -> GenerationChunk:
+    """Convert a stream response to a generation chunk."""
+    if stream_response.event == "token_sampled":
+        return GenerationChunk(
+            text=stream_response.text,
+            generation_info={"token": str(stream_response.token)},
+        )
+    return GenerationChunk(text="")
+
+
+class BaseFriendli(Serializable):
+    """Base class of Friendli."""
+
+    # Friendli client.
+    client: Any = Field(default=None, exclude=True)
+    # Friendli Async client.
+    async_client: Any = Field(default=None, exclude=True)
+    # Model name to use.
+    model: str = "mixtral-8x7b-instruct-v0-1"
+    # Friendli personal access token to run as.
+    friendli_token: Optional[SecretStr] = None
+    # Friendli team ID to run as.
+    friendli_team: Optional[str] = None
+    # Whether to enable streaming mode.
+    streaming: bool = False
+    # Number between -2.0 and 2.0. Positive values penalizes tokens that have been
+    # sampled, taking into account their frequency in the preceding text. This
+    # penalization diminishes the model's tendency to reproduce identical lines
+    # verbatim.
+    frequency_penalty: Optional[float] = None
+    # Number between -2.0 and 2.0. Positive values penalizes tokens that have been
+    # sampled at least once in the existing text.
+    presence_penalty: Optional[float] = None
+    # The maximum number of tokens to generate. The length of your input tokens plus
+    # `max_tokens` should not exceed the model's maximum length (e.g., 2048 for OpenAI
+    # GPT-3)
+    max_tokens: Optional[int] = None
+    # When one of the stop phrases appears in the generation result, the API will stop
+    # generation. The phrase is included in the generated result. If you are using
+    # beam search, all of the active beams should contain the stop phrase to terminate
+    # generation. Before checking whether a stop phrase is included in the result, the
+    # phrase is converted into tokens.
+    stop: Optional[List[str]] = None
+    # Sampling temperature. Smaller temperature makes the generation result closer to
+    # greedy, argmax (i.e., `top_k = 1`) sampling. If it is `None`, then 1.0 is used.
+    temperature: Optional[float] = None
+    # Tokens comprising the top `top_p` probability mass are kept for sampling. Numbers
+    # between 0.0 (exclusive) and 1.0 (inclusive) are allowed. If it is `None`, then 1.0
+    # is used by default.
+    top_p: Optional[float] = None
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate if personal access token is provided in environment."""
+        try:
+            import friendli
+        except ImportError as e:
+            raise ImportError(
+                "Could not import friendli-client python package. "
+                "Please install it with `pip install friendli-client`."
+            ) from e
+
+        friendli_token = convert_to_secret_str(
+            get_from_dict_or_env(values, "friendli_token", "FRIENDLI_TOKEN")
+        )
+        values["friendli_token"] = friendli_token
+        friendli_token_str = friendli_token.get_secret_value()
+        friendli_team = values["friendli_team"] or os.getenv("FRIENDLI_TEAM")
+        values["friendli_team"] = friendli_team
+        values["client"] = values["client"] or friendli.Friendli(
+            token=friendli_token_str, team_id=friendli_team
+        )
+        values["async_client"] = values["async_client"] or friendli.AsyncFriendli(
+            token=friendli_token_str, team_id=friendli_team
+        )
+        return values
+
+
+class Friendli(LLM, BaseFriendli):
+    """Friendli LLM.
+
+    ``friendli-client`` package should be installed with `pip install friendli-client`.
+    You must set ``FRIENDLI_TOKEN`` environment variable or provide the value of your
+    personal access token for the ``friendli_token`` argument.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Friendli
+
+            friendli = Friendli(
+                model="mixtral-8x7b-instruct-v0-1", friendli_token="YOUR FRIENDLI TOKEN"
+            )
+    """
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"friendli_token": "FRIENDLI_TOKEN"}
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Friendli completions API."""
+        return {
+            "frequency_penalty": self.frequency_penalty,
+            "presence_penalty": self.presence_penalty,
+            "max_tokens": self.max_tokens,
+            "stop": self.stop,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+        }
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {"model": self.model, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "friendli"
+
+    def _get_invocation_params(
+        self, stop: Optional[List[str]] = None, **kwargs: Any
+    ) -> Dict[str, Any]:
+        """Get the parameters used to invoke the model."""
+        params = self._default_params
+        if self.stop is not None and stop is not None:
+            raise ValueError("`stop` found in both the input and default params.")
+        elif self.stop is not None:
+            params["stop"] = self.stop
+        else:
+            params["stop"] = stop
+        return {**params, **kwargs}
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out Friendli's completions API.
+
+        Args:
+            prompt (str): The text prompt to generate completion for.
+            stop (Optional[List[str]], optional): When one of the stop phrases appears
+                in the generation result, the API will stop generation. The stop phrases
+                are excluded from the result. If beam search is enabled, all of the
+                active beams should contain the stop phrase to terminate generation.
+                Before checking whether a stop phrase is included in the result, the
+                phrase is converted into tokens. We recommend using stop_tokens because
+                it is clearer. For example, after tokenization, phrases "clear" and
+                " clear" can result in different token sequences due to the prepended
+                space character. Defaults to None.
+
+        Returns:
+            str: The generated text output.
+
+        Example:
+            .. code-block:: python
+
+                response = frienldi("Give me a recipe for the Old Fashioned cocktail.")
+        """
+        params = self._get_invocation_params(stop=stop, **kwargs)
+        completion = self.client.completions.create(
+            model=self.model, prompt=prompt, stream=False, **params
+        )
+        return completion.choices[0].text
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out Friendli's completions API Asynchronously.
+
+        Args:
+            prompt (str): The text prompt to generate completion for.
+            stop (Optional[List[str]], optional): When one of the stop phrases appears
+                in the generation result, the API will stop generation. The stop phrases
+                are excluded from the result. If beam search is enabled, all of the
+                active beams should contain the stop phrase to terminate generation.
+                Before checking whether a stop phrase is included in the result, the
+                phrase is converted into tokens. We recommend using stop_tokens because
+                it is clearer. For example, after tokenization, phrases "clear" and
+                " clear" can result in different token sequences due to the prepended
+                space character. Defaults to None.
+
+        Returns:
+            str: The generated text output.
+
+        Example:
+            .. code-block:: python
+
+                response = await frienldi("Tell me a joke.")
+        """
+        params = self._get_invocation_params(stop=stop, **kwargs)
+        completion = await self.async_client.completions.create(
+            model=self.model, prompt=prompt, stream=False, **params
+        )
+        return completion.choices[0].text
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        params = self._get_invocation_params(stop=stop, **kwargs)
+        stream = self.client.completions.create(
+            model=self.model, prompt=prompt, stream=True, **params
+        )
+        for line in stream:
+            chunk = _stream_response_to_generation_chunk(line)
+            yield chunk
+            if run_manager:
+                run_manager.on_llm_new_token(line.text, chunk=chunk)
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        params = self._get_invocation_params(stop=stop, **kwargs)
+        stream = await self.async_client.completions.create(
+            model=self.model, prompt=prompt, stream=True, **params
+        )
+        async for line in stream:
+            chunk = _stream_response_to_generation_chunk(line)
+            yield chunk
+            if run_manager:
+                await run_manager.on_llm_new_token(line.text, chunk=chunk)
+
+    def _generate(
+        self,
+        prompts: list[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Call out Friendli's completions API with k unique prompts.
+
+        Args:
+            prompt (str): The text prompt to generate completion for.
+            stop (Optional[List[str]], optional): When one of the stop phrases appears
+                in the generation result, the API will stop generation. The stop phrases
+                are excluded from the result. If beam search is enabled, all of the
+                active beams should contain the stop phrase to terminate generation.
+                Before checking whether a stop phrase is included in the result, the
+                phrase is converted into tokens. We recommend using stop_tokens because
+                it is clearer. For example, after tokenization, phrases "clear" and
+                " clear" can result in different token sequences due to the prepended
+                space character. Defaults to None.
+
+        Returns:
+            str: The generated text output.
+
+        Example:
+            .. code-block:: python
+
+                response = frienldi.generate(["Tell me a joke."])
+        """
+        llm_output = {"model": self.model}
+        if self.streaming:
+            if len(prompts) > 1:
+                raise ValueError("Cannot stream results with multiple prompts.")
+
+            generation: Optional[GenerationChunk] = None
+            for chunk in self._stream(prompts[0], stop, run_manager, **kwargs):
+                if generation is None:
+                    generation = chunk
+                else:
+                    generation += chunk
+            assert generation is not None
+            return LLMResult(generations=[[generation]], llm_output=llm_output)
+
+        llm_result = super()._generate(prompts, stop, run_manager, **kwargs)
+        llm_result.llm_output = llm_output
+        return llm_result
+
+    async def _agenerate(
+        self,
+        prompts: list[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Call out Friendli's completions API asynchronously with k unique prompts.
+
+        Args:
+            prompt (str): The text prompt to generate completion for.
+            stop (Optional[List[str]], optional): When one of the stop phrases appears
+                in the generation result, the API will stop generation. The stop phrases
+                are excluded from the result. If beam search is enabled, all of the
+                active beams should contain the stop phrase to terminate generation.
+                Before checking whether a stop phrase is included in the result, the
+                phrase is converted into tokens. We recommend using stop_tokens because
+                it is clearer. For example, after tokenization, phrases "clear" and
+                " clear" can result in different token sequences due to the prepended
+                space character. Defaults to None.
+
+        Returns:
+            str: The generated text output.
+
+        Example:
+            .. code-block:: python
+
+                response = await frienldi.agenerate(
+                    ["Give me a recipe for the Old Fashioned cocktail."]
+                )
+        """
+        llm_output = {"model": self.model}
+        if self.streaming:
+            if len(prompts) > 1:
+                raise ValueError("Cannot stream results with multiple prompts.")
+
+            generation = None
+            async for chunk in self._astream(prompts[0], stop, run_manager, **kwargs):
+                if generation is None:
+                    generation = chunk
+                else:
+                    generation += chunk
+            assert generation is not None
+            return LLMResult(generations=[[generation]], llm_output=llm_output)
+
+        llm_result = await super()._agenerate(prompts, stop, run_manager, **kwargs)
+        llm_result.llm_output = llm_output
+        return llm_result
diff --git a/llm/Lib/site-packages/langchain_community/llms/gigachat.py b/llm/Lib/site-packages/langchain_community/llms/gigachat.py
new file mode 100644
index 0000000000000000000000000000000000000000..67b604b2d207a3221a9b4c8eb74905eb430b9e06
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/gigachat.py
@@ -0,0 +1,333 @@
+from __future__ import annotations
+
+import logging
+from functools import cached_property
+from typing import TYPE_CHECKING, Any, AsyncIterator, Dict, Iterator, List, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import BaseLLM
+from langchain_core.load.serializable import Serializable
+from langchain_core.outputs import Generation, GenerationChunk, LLMResult
+from langchain_core.pydantic_v1 import root_validator
+
+if TYPE_CHECKING:
+    import gigachat
+    import gigachat.models as gm
+
+logger = logging.getLogger(__name__)
+
+
+class _BaseGigaChat(Serializable):
+    base_url: Optional[str] = None
+    """ Base API URL """
+    auth_url: Optional[str] = None
+    """ Auth URL """
+    credentials: Optional[str] = None
+    """ Auth Token """
+    scope: Optional[str] = None
+    """ Permission scope for access token """
+
+    access_token: Optional[str] = None
+    """ Access token for GigaChat """
+
+    model: Optional[str] = None
+    """Model name to use."""
+    user: Optional[str] = None
+    """ Username for authenticate """
+    password: Optional[str] = None
+    """ Password for authenticate """
+
+    timeout: Optional[float] = None
+    """ Timeout for request """
+    verify_ssl_certs: Optional[bool] = None
+    """ Check certificates for all requests """
+
+    ca_bundle_file: Optional[str] = None
+    cert_file: Optional[str] = None
+    key_file: Optional[str] = None
+    key_file_password: Optional[str] = None
+    # Support for connection to GigaChat through SSL certificates
+
+    profanity: bool = True
+    """ DEPRECATED: Check for profanity """
+    profanity_check: Optional[bool] = None
+    """ Check for profanity """
+    streaming: bool = False
+    """ Whether to stream the results or not. """
+    temperature: Optional[float] = None
+    """ What sampling temperature to use. """
+    max_tokens: Optional[int] = None
+    """ Maximum number of tokens to generate """
+    use_api_for_tokens: bool = False
+    """ Use GigaChat API for tokens count """
+    verbose: bool = False
+    """ Verbose logging """
+    top_p: Optional[float] = None
+    """ top_p value to use for nucleus sampling. Must be between 0.0 and 1.0 """
+    repetition_penalty: Optional[float] = None
+    """ The penalty applied to repeated tokens """
+    update_interval: Optional[float] = None
+    """ Minimum interval in seconds that elapses between sending tokens """
+
+    @property
+    def _llm_type(self) -> str:
+        return "giga-chat-model"
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {
+            "credentials": "GIGACHAT_CREDENTIALS",
+            "access_token": "GIGACHAT_ACCESS_TOKEN",
+            "password": "GIGACHAT_PASSWORD",
+            "key_file_password": "GIGACHAT_KEY_FILE_PASSWORD",
+        }
+
+    @property
+    def lc_serializable(self) -> bool:
+        return True
+
+    @cached_property
+    def _client(self) -> gigachat.GigaChat:
+        """Returns GigaChat API client"""
+        import gigachat
+
+        return gigachat.GigaChat(
+            base_url=self.base_url,
+            auth_url=self.auth_url,
+            credentials=self.credentials,
+            scope=self.scope,
+            access_token=self.access_token,
+            model=self.model,
+            profanity_check=self.profanity_check,
+            user=self.user,
+            password=self.password,
+            timeout=self.timeout,
+            verify_ssl_certs=self.verify_ssl_certs,
+            ca_bundle_file=self.ca_bundle_file,
+            cert_file=self.cert_file,
+            key_file=self.key_file,
+            key_file_password=self.key_file_password,
+            verbose=self.verbose,
+        )
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate authenticate data in environment and python package is installed."""
+        try:
+            import gigachat  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "Could not import gigachat python package. "
+                "Please install it with `pip install gigachat`."
+            )
+        fields = set(cls.__fields__.keys())
+        diff = set(values.keys()) - fields
+        if diff:
+            logger.warning(f"Extra fields {diff} in GigaChat class")
+        if "profanity" in fields and values.get("profanity") is False:
+            logger.warning(
+                "'profanity' field is deprecated. Use 'profanity_check' instead."
+            )
+            if values.get("profanity_check") is None:
+                values["profanity_check"] = values.get("profanity")
+        return values
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "temperature": self.temperature,
+            "model": self.model,
+            "profanity": self.profanity_check,
+            "streaming": self.streaming,
+            "max_tokens": self.max_tokens,
+            "top_p": self.top_p,
+            "repetition_penalty": self.repetition_penalty,
+        }
+
+    def tokens_count(
+        self, input_: List[str], model: Optional[str] = None
+    ) -> List[gm.TokensCount]:
+        """Get tokens of string list"""
+        return self._client.tokens_count(input_, model)
+
+    async def atokens_count(
+        self, input_: List[str], model: Optional[str] = None
+    ) -> List[gm.TokensCount]:
+        """Get tokens of strings list (async)"""
+        return await self._client.atokens_count(input_, model)
+
+    def get_models(self) -> gm.Models:
+        """Get available models of Gigachat"""
+        return self._client.get_models()
+
+    async def aget_models(self) -> gm.Models:
+        """Get available models of Gigachat (async)"""
+        return await self._client.aget_models()
+
+    def get_model(self, model: str) -> gm.Model:
+        """Get info about model"""
+        return self._client.get_model(model)
+
+    async def aget_model(self, model: str) -> gm.Model:
+        """Get info about model (async)"""
+        return await self._client.aget_model(model)
+
+    def get_num_tokens(self, text: str) -> int:
+        """Count approximate number of tokens"""
+        if self.use_api_for_tokens:
+            return self.tokens_count([text])[0].tokens  # type: ignore
+        else:
+            return round(len(text) / 4.6)
+
+
+class GigaChat(_BaseGigaChat, BaseLLM):
+    """`GigaChat` large language models API.
+
+    To use, you should pass login and password to access GigaChat API or use token.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import GigaChat
+            giga = GigaChat(credentials=..., scope=..., verify_ssl_certs=False)
+    """
+
+    payload_role: str = "user"
+
+    def _build_payload(self, messages: List[str]) -> Dict[str, Any]:
+        payload: Dict[str, Any] = {
+            "messages": [{"role": self.payload_role, "content": m} for m in messages],
+        }
+        if self.model:
+            payload["model"] = self.model
+        if self.profanity_check is not None:
+            payload["profanity_check"] = self.profanity_check
+        if self.temperature is not None:
+            payload["temperature"] = self.temperature
+        if self.top_p is not None:
+            payload["top_p"] = self.top_p
+        if self.max_tokens is not None:
+            payload["max_tokens"] = self.max_tokens
+        if self.repetition_penalty is not None:
+            payload["repetition_penalty"] = self.repetition_penalty
+        if self.update_interval is not None:
+            payload["update_interval"] = self.update_interval
+
+        if self.verbose:
+            logger.info("Giga request: %s", payload)
+
+        return payload
+
+    def _create_llm_result(self, response: Any) -> LLMResult:
+        generations = []
+        for res in response.choices:
+            finish_reason = res.finish_reason
+            gen = Generation(
+                text=res.message.content,
+                generation_info={"finish_reason": finish_reason},
+            )
+            generations.append([gen])
+            if finish_reason != "stop":
+                logger.warning(
+                    "Giga generation stopped with reason: %s",
+                    finish_reason,
+                )
+            if self.verbose:
+                logger.info("Giga response: %s", res.message.content)
+
+        token_usage = response.usage
+        llm_output = {"token_usage": token_usage, "model_name": response.model}
+        return LLMResult(generations=generations, llm_output=llm_output)
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            generation: Optional[GenerationChunk] = None
+            stream_iter = self._stream(
+                prompts[0], stop=stop, run_manager=run_manager, **kwargs
+            )
+            for chunk in stream_iter:
+                if generation is None:
+                    generation = chunk
+                else:
+                    generation += chunk
+            assert generation is not None
+            return LLMResult(generations=[[generation]])
+
+        payload = self._build_payload(prompts)
+        response = self._client.chat(payload)
+
+        return self._create_llm_result(response)
+
+    async def _agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            generation: Optional[GenerationChunk] = None
+            stream_iter = self._astream(
+                prompts[0], stop=stop, run_manager=run_manager, **kwargs
+            )
+            async for chunk in stream_iter:
+                if generation is None:
+                    generation = chunk
+                else:
+                    generation += chunk
+            assert generation is not None
+            return LLMResult(generations=[[generation]])
+
+        payload = self._build_payload(prompts)
+        response = await self._client.achat(payload)
+
+        return self._create_llm_result(response)
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        payload = self._build_payload([prompt])
+
+        for chunk in self._client.stream(payload):
+            if chunk.choices:
+                content = chunk.choices[0].delta.content
+                yield GenerationChunk(text=content)
+                if run_manager:
+                    run_manager.on_llm_new_token(content)
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        payload = self._build_payload([prompt])
+
+        async for chunk in self._client.astream(payload):
+            if chunk.choices:
+                content = chunk.choices[0].delta.content
+                yield GenerationChunk(text=content)
+                if run_manager:
+                    await run_manager.on_llm_new_token(content)
+
+    class Config:
+        extra = "allow"
diff --git a/llm/Lib/site-packages/langchain_community/llms/google_palm.py b/llm/Lib/site-packages/langchain_community/llms/google_palm.py
new file mode 100644
index 0000000000000000000000000000000000000000..b0e7e22c0947ba4a3bc3ca4d40a8af1e07ed9ba3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/google_palm.py
@@ -0,0 +1,245 @@
+from __future__ import annotations
+
+from typing import Any, Dict, Iterator, List, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models import LanguageModelInput
+from langchain_core.outputs import Generation, GenerationChunk, LLMResult
+from langchain_core.pydantic_v1 import BaseModel, SecretStr, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.llms import BaseLLM
+from langchain_community.utilities.vertexai import create_retry_decorator
+
+
+def completion_with_retry(
+    llm: GooglePalm,
+    prompt: LanguageModelInput,
+    is_gemini: bool = False,
+    stream: bool = False,
+    run_manager: Optional[CallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = create_retry_decorator(
+        llm, max_retries=llm.max_retries, run_manager=run_manager
+    )
+
+    @retry_decorator
+    def _completion_with_retry(
+        prompt: LanguageModelInput, is_gemini: bool, stream: bool, **kwargs: Any
+    ) -> Any:
+        generation_config = kwargs.get("generation_config", {})
+        if is_gemini:
+            return llm.client.generate_content(
+                contents=prompt, stream=stream, generation_config=generation_config
+            )
+        return llm.client.generate_text(prompt=prompt, **kwargs)
+
+    return _completion_with_retry(
+        prompt=prompt, is_gemini=is_gemini, stream=stream, **kwargs
+    )
+
+
+def _is_gemini_model(model_name: str) -> bool:
+    return "gemini" in model_name
+
+
+def _strip_erroneous_leading_spaces(text: str) -> str:
+    """Strip erroneous leading spaces from text.
+
+    The PaLM API will sometimes erroneously return a single leading space in all
+    lines > 1. This function strips that space.
+    """
+    has_leading_space = all(not line or line[0] == " " for line in text.split("\n")[1:])
+    if has_leading_space:
+        return text.replace("\n ", "\n")
+    else:
+        return text
+
+
+@deprecated("0.0.12", alternative_import="langchain_google_genai.GoogleGenerativeAI")
+class GooglePalm(BaseLLM, BaseModel):
+    """
+    DEPRECATED: Use `langchain_google_genai.GoogleGenerativeAI` instead.
+
+    Google PaLM models.
+    """
+
+    client: Any  #: :meta private:
+    google_api_key: Optional[SecretStr]
+    model_name: str = "models/text-bison-001"
+    """Model name to use."""
+    temperature: float = 0.7
+    """Run inference with this temperature. Must by in the closed interval
+       [0.0, 1.0]."""
+    top_p: Optional[float] = None
+    """Decode using nucleus sampling: consider the smallest set of tokens whose
+       probability sum is at least top_p. Must be in the closed interval [0.0, 1.0]."""
+    top_k: Optional[int] = None
+    """Decode using top-k sampling: consider the set of top_k most probable tokens.
+       Must be positive."""
+    max_output_tokens: Optional[int] = None
+    """Maximum number of tokens to include in a candidate. Must be greater than zero.
+       If unset, will default to 64."""
+    n: int = 1
+    """Number of chat completions to generate for each prompt. Note that the API may
+       not return the full n completions if duplicates are generated."""
+    max_retries: int = 6
+    """The maximum number of retries to make when generating."""
+
+    @property
+    def is_gemini(self) -> bool:
+        """Returns whether a model is belongs to a Gemini family or not."""
+        return _is_gemini_model(self.model_name)
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"google_api_key": "GOOGLE_API_KEY"}
+
+    @classmethod
+    def is_lc_serializable(self) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "llms", "google_palm"]
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate api key, python package exists."""
+        google_api_key = get_from_dict_or_env(
+            values, "google_api_key", "GOOGLE_API_KEY"
+        )
+        model_name = values["model_name"]
+        try:
+            import google.generativeai as genai
+
+            if isinstance(google_api_key, SecretStr):
+                google_api_key = google_api_key.get_secret_value()
+
+            genai.configure(api_key=google_api_key)
+
+            if _is_gemini_model(model_name):
+                values["client"] = genai.GenerativeModel(model_name=model_name)
+            else:
+                values["client"] = genai
+        except ImportError:
+            raise ImportError(
+                "Could not import google-generativeai python package. "
+                "Please install it with `pip install google-generativeai`."
+            )
+
+        if values["temperature"] is not None and not 0 <= values["temperature"] <= 1:
+            raise ValueError("temperature must be in the range [0.0, 1.0]")
+
+        if values["top_p"] is not None and not 0 <= values["top_p"] <= 1:
+            raise ValueError("top_p must be in the range [0.0, 1.0]")
+
+        if values["top_k"] is not None and values["top_k"] <= 0:
+            raise ValueError("top_k must be positive")
+
+        if values["max_output_tokens"] is not None and values["max_output_tokens"] <= 0:
+            raise ValueError("max_output_tokens must be greater than zero")
+
+        return values
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        generations: List[List[Generation]] = []
+        generation_config = {
+            "stop_sequences": stop,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            "top_k": self.top_k,
+            "max_output_tokens": self.max_output_tokens,
+            "candidate_count": self.n,
+        }
+        for prompt in prompts:
+            if self.is_gemini:
+                res = completion_with_retry(
+                    self,
+                    prompt=prompt,
+                    stream=False,
+                    is_gemini=True,
+                    run_manager=run_manager,
+                    generation_config=generation_config,
+                )
+                candidates = [
+                    "".join([p.text for p in c.content.parts]) for c in res.candidates
+                ]
+                generations.append([Generation(text=c) for c in candidates])
+            else:
+                res = completion_with_retry(
+                    self,
+                    model=self.model_name,
+                    prompt=prompt,
+                    stream=False,
+                    is_gemini=False,
+                    run_manager=run_manager,
+                    **generation_config,
+                )
+                prompt_generations = []
+                for candidate in res.candidates:
+                    raw_text = candidate["output"]
+                    stripped_text = _strip_erroneous_leading_spaces(raw_text)
+                    prompt_generations.append(Generation(text=stripped_text))
+                generations.append(prompt_generations)
+
+        return LLMResult(generations=generations)
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        generation_config = kwargs.get("generation_config", {})
+        if stop:
+            generation_config["stop_sequences"] = stop
+        for stream_resp in completion_with_retry(
+            self,
+            prompt,
+            stream=True,
+            is_gemini=True,
+            run_manager=run_manager,
+            generation_config=generation_config,
+            **kwargs,
+        ):
+            chunk = GenerationChunk(text=stream_resp.text)
+            yield chunk
+            if run_manager:
+                run_manager.on_llm_new_token(
+                    stream_resp.text,
+                    chunk=chunk,
+                    verbose=self.verbose,
+                )
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "google_palm"
+
+    def get_num_tokens(self, text: str) -> int:
+        """Get the number of tokens present in the text.
+
+        Useful for checking if an input will fit in a model's context window.
+
+        Args:
+            text: The string input to tokenize.
+
+        Returns:
+            The integer number of tokens in the text.
+        """
+        if self.is_gemini:
+            raise ValueError("Counting tokens is not yet supported!")
+        result = self.client.count_text_tokens(model=self.model_name, prompt=text)
+        return result["token_count"]
diff --git a/llm/Lib/site-packages/langchain_community/llms/gooseai.py b/llm/Lib/site-packages/langchain_community/llms/gooseai.py
new file mode 100644
index 0000000000000000000000000000000000000000..27ff257ab6397854f3e2abfebb550d8dc760d352
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/gooseai.py
@@ -0,0 +1,152 @@
+import logging
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+class GooseAI(LLM):
+    """GooseAI large language models.
+
+    To use, you should have the ``openai`` python package installed, and the
+    environment variable ``GOOSEAI_API_KEY`` set with your API key.
+
+    Any parameters that are valid to be passed to the openai.create call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import GooseAI
+            gooseai = GooseAI(model_name="gpt-neo-20b")
+
+    """
+
+    client: Any
+
+    model_name: str = "gpt-neo-20b"
+    """Model name to use"""
+
+    temperature: float = 0.7
+    """What sampling temperature to use"""
+
+    max_tokens: int = 256
+    """The maximum number of tokens to generate in the completion.
+    -1 returns as many tokens as possible given the prompt and
+    the models maximal context size."""
+
+    top_p: float = 1
+    """Total probability mass of tokens to consider at each step."""
+
+    min_tokens: int = 1
+    """The minimum number of tokens to generate in the completion."""
+
+    frequency_penalty: float = 0
+    """Penalizes repeated tokens according to frequency."""
+
+    presence_penalty: float = 0
+    """Penalizes repeated tokens."""
+
+    n: int = 1
+    """How many completions to generate for each prompt."""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not explicitly specified."""
+
+    logit_bias: Optional[Dict[str, float]] = Field(default_factory=dict)
+    """Adjust the probability of specific tokens being generated."""
+
+    gooseai_api_key: Optional[SecretStr] = None
+
+    class Config:
+        """Configuration for this pydantic config."""
+
+        extra = Extra.ignore
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = {field.alias for field in cls.__fields__.values()}
+
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name not in all_required_field_names:
+                if field_name in extra:
+                    raise ValueError(f"Found {field_name} supplied twice.")
+                logger.warning(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        gooseai_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "gooseai_api_key", "GOOSEAI_API_KEY")
+        )
+        values["gooseai_api_key"] = gooseai_api_key
+        try:
+            import openai
+
+            openai.api_key = gooseai_api_key.get_secret_value()
+            openai.api_base = "https://api.goose.ai/v1"
+            values["client"] = openai.Completion
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling GooseAI API."""
+        normal_params = {
+            "temperature": self.temperature,
+            "max_tokens": self.max_tokens,
+            "top_p": self.top_p,
+            "min_tokens": self.min_tokens,
+            "frequency_penalty": self.frequency_penalty,
+            "presence_penalty": self.presence_penalty,
+            "n": self.n,
+            "logit_bias": self.logit_bias,
+        }
+        return {**normal_params, **self.model_kwargs}
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model_name": self.model_name}, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "gooseai"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call the GooseAI API."""
+        params = self._default_params
+        if stop is not None:
+            if "stop" in params:
+                raise ValueError("`stop` found in both the input and default params.")
+            params["stop"] = stop
+
+        params = {**params, **kwargs}
+
+        response = self.client.create(engine=self.model_name, prompt=prompt, **params)
+        text = response.choices[0].text
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/gpt4all.py b/llm/Lib/site-packages/langchain_community/llms/gpt4all.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b347ceb5c38bf0983578bfad7ad18eb30ddfcba
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/gpt4all.py
@@ -0,0 +1,213 @@
+from functools import partial
+from typing import Any, Dict, List, Mapping, Optional, Set
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+
+class GPT4All(LLM):
+    """GPT4All language models.
+
+    To use, you should have the ``gpt4all`` python package installed, the
+    pre-trained model file, and the model's config information.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import GPT4All
+            model = GPT4All(model="./models/gpt4all-model.bin", n_threads=8)
+
+            # Simplest invocation
+            response = model("Once upon a time, ")
+    """
+
+    model: str
+    """Path to the pre-trained GPT4All model file."""
+
+    backend: Optional[str] = Field(None, alias="backend")
+
+    max_tokens: int = Field(200, alias="max_tokens")
+    """Token context window."""
+
+    n_parts: int = Field(-1, alias="n_parts")
+    """Number of parts to split the model into. 
+    If -1, the number of parts is automatically determined."""
+
+    seed: int = Field(0, alias="seed")
+    """Seed. If -1, a random seed is used."""
+
+    f16_kv: bool = Field(False, alias="f16_kv")
+    """Use half-precision for key/value cache."""
+
+    logits_all: bool = Field(False, alias="logits_all")
+    """Return logits for all tokens, not just the last token."""
+
+    vocab_only: bool = Field(False, alias="vocab_only")
+    """Only load the vocabulary, no weights."""
+
+    use_mlock: bool = Field(False, alias="use_mlock")
+    """Force system to keep model in RAM."""
+
+    embedding: bool = Field(False, alias="embedding")
+    """Use embedding mode only."""
+
+    n_threads: Optional[int] = Field(4, alias="n_threads")
+    """Number of threads to use."""
+
+    n_predict: Optional[int] = 256
+    """The maximum number of tokens to generate."""
+
+    temp: Optional[float] = 0.7
+    """The temperature to use for sampling."""
+
+    top_p: Optional[float] = 0.1
+    """The top-p value to use for sampling."""
+
+    top_k: Optional[int] = 40
+    """The top-k value to use for sampling."""
+
+    echo: Optional[bool] = False
+    """Whether to echo the prompt."""
+
+    stop: Optional[List[str]] = []
+    """A list of strings to stop generation when encountered."""
+
+    repeat_last_n: Optional[int] = 64
+    "Last n tokens to penalize"
+
+    repeat_penalty: Optional[float] = 1.18
+    """The penalty to apply to repeated tokens."""
+
+    n_batch: int = Field(8, alias="n_batch")
+    """Batch size for prompt processing."""
+
+    streaming: bool = False
+    """Whether to stream the results or not."""
+
+    allow_download: bool = False
+    """If model does not exist in ~/.cache/gpt4all/, download it."""
+
+    device: Optional[str] = Field("cpu", alias="device")
+    """Device name: cpu, gpu, nvidia, intel, amd or DeviceName."""
+
+    client: Any = None  #: :meta private:
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @staticmethod
+    def _model_param_names() -> Set[str]:
+        return {
+            "max_tokens",
+            "n_predict",
+            "top_k",
+            "top_p",
+            "temp",
+            "n_batch",
+            "repeat_penalty",
+            "repeat_last_n",
+            "streaming",
+        }
+
+    def _default_params(self) -> Dict[str, Any]:
+        return {
+            "max_tokens": self.max_tokens,
+            "n_predict": self.n_predict,
+            "top_k": self.top_k,
+            "top_p": self.top_p,
+            "temp": self.temp,
+            "n_batch": self.n_batch,
+            "repeat_penalty": self.repeat_penalty,
+            "repeat_last_n": self.repeat_last_n,
+            "streaming": self.streaming,
+        }
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in the environment."""
+        try:
+            from gpt4all import GPT4All as GPT4AllModel
+        except ImportError:
+            raise ImportError(
+                "Could not import gpt4all python package. "
+                "Please install it with `pip install gpt4all`."
+            )
+
+        full_path = values["model"]
+        model_path, delimiter, model_name = full_path.rpartition("/")
+        model_path += delimiter
+
+        values["client"] = GPT4AllModel(
+            model_name,
+            model_path=model_path or None,
+            model_type=values["backend"],
+            allow_download=values["allow_download"],
+            device=values["device"],
+        )
+        if values["n_threads"] is not None:
+            # set n_threads
+            values["client"].model.set_thread_count(values["n_threads"])
+
+        try:
+            values["backend"] = values["client"].model_type
+        except AttributeError:
+            # The below is for compatibility with GPT4All Python bindings <= 0.2.3.
+            values["backend"] = values["client"].model.model_type
+
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model": self.model,
+            **self._default_params(),
+            **{
+                k: v for k, v in self.__dict__.items() if k in self._model_param_names()
+            },
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return the type of llm."""
+        return "gpt4all"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        r"""Call out to GPT4All's generate method.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: A list of strings to stop generation when encountered.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                prompt = "Once upon a time, "
+                response = model(prompt, n_predict=55)
+        """
+        text_callback = None
+        if run_manager:
+            text_callback = partial(run_manager.on_llm_new_token, verbose=self.verbose)
+        text = ""
+        params = {**self._default_params(), **kwargs}
+        for token in self.client.generate(prompt, **params):
+            if text_callback:
+                text_callback(token)
+            text += token
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/gradient_ai.py b/llm/Lib/site-packages/langchain_community/llms/gradient_ai.py
new file mode 100644
index 0000000000000000000000000000000000000000..23ffc1a193fa39d0f4a03690c22ce0585f898ef1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/gradient_ai.py
@@ -0,0 +1,402 @@
+import asyncio
+import logging
+from concurrent.futures import ThreadPoolExecutor
+from typing import Any, Dict, List, Mapping, Optional, Sequence, TypedDict
+
+import aiohttp
+import requests
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import BaseLLM
+from langchain_core.outputs import Generation, LLMResult
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+
+class TrainResult(TypedDict):
+    """Train result."""
+
+    loss: float
+
+
+class GradientLLM(BaseLLM):
+    """Gradient.ai LLM Endpoints.
+
+    GradientLLM is a class to interact with LLMs on gradient.ai
+
+    To use, set the environment variable ``GRADIENT_ACCESS_TOKEN`` with your
+    API token and ``GRADIENT_WORKSPACE_ID`` for your gradient workspace,
+    or alternatively provide them as keywords to the constructor of this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import GradientLLM
+            GradientLLM(
+                model="99148c6d-c2a0-4fbe-a4a7-e7c05bdb8a09_base_ml_model",
+                model_kwargs={
+                    "max_generated_token_count": 128,
+                    "temperature": 0.75,
+                    "top_p": 0.95,
+                    "top_k": 20,
+                    "stop": [],
+                },
+                gradient_workspace_id="12345614fc0_workspace",
+                gradient_access_token="gradientai-access_token",
+            )
+
+    """
+
+    model_id: str = Field(alias="model", min_length=2)
+    "Underlying gradient.ai model id (base or fine-tuned)."
+
+    gradient_workspace_id: Optional[str] = None
+    "Underlying gradient.ai workspace_id."
+
+    gradient_access_token: Optional[str] = None
+    """gradient.ai API Token, which can be generated by going to
+        https://auth.gradient.ai/select-workspace
+        and selecting "Access tokens" under the profile drop-down.
+    """
+
+    model_kwargs: Optional[dict] = None
+    """Keyword arguments to pass to the model."""
+
+    gradient_api_url: str = "https://api.gradient.ai/api"
+    """Endpoint URL to use."""
+
+    aiosession: Optional[aiohttp.ClientSession] = None  #: :meta private:
+    """ClientSession, private, subject to change in upcoming releases."""
+
+    # LLM call kwargs
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+        extra = Extra.forbid
+
+    @root_validator(allow_reuse=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+
+        values["gradient_access_token"] = get_from_dict_or_env(
+            values, "gradient_access_token", "GRADIENT_ACCESS_TOKEN"
+        )
+        values["gradient_workspace_id"] = get_from_dict_or_env(
+            values, "gradient_workspace_id", "GRADIENT_WORKSPACE_ID"
+        )
+
+        if (
+            values["gradient_access_token"] is None
+            or len(values["gradient_access_token"]) < 10
+        ):
+            raise ValueError("env variable `GRADIENT_ACCESS_TOKEN` must be set")
+
+        if (
+            values["gradient_workspace_id"] is None
+            or len(values["gradient_access_token"]) < 3
+        ):
+            raise ValueError("env variable `GRADIENT_WORKSPACE_ID` must be set")
+
+        if values["model_kwargs"]:
+            kw = values["model_kwargs"]
+            if not 0 <= kw.get("temperature", 0.5) <= 1:
+                raise ValueError("`temperature` must be in the range [0.0, 1.0]")
+
+            if not 0 <= kw.get("top_p", 0.5) <= 1:
+                raise ValueError("`top_p` must be in the range [0.0, 1.0]")
+
+            if 0 >= kw.get("top_k", 0.5):
+                raise ValueError("`top_k` must be positive")
+
+            if 0 >= kw.get("max_generated_token_count", 1):
+                raise ValueError("`max_generated_token_count` must be positive")
+
+        values["gradient_api_url"] = get_from_dict_or_env(
+            values, "gradient_api_url", "GRADIENT_API_URL"
+        )
+
+        try:
+            import gradientai  # noqa
+        except ImportError:
+            logging.warning(
+                "DeprecationWarning: `GradientLLM` will use "
+                "`pip install gradientai` in future releases of langchain."
+            )
+        except Exception:
+            pass
+
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            **{"gradient_api_url": self.gradient_api_url},
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "gradient"
+
+    def _kwargs_post_fine_tune_request(
+        self, inputs: Sequence[str], kwargs: Mapping[str, Any]
+    ) -> Mapping[str, Any]:
+        """Build the kwargs for the Post request, used by sync
+
+        Args:
+            prompt (str): prompt used in query
+            kwargs (dict): model kwargs in payload
+
+        Returns:
+            Dict[str, Union[str,dict]]: _description_
+        """
+        _model_kwargs = self.model_kwargs or {}
+        _params = {**_model_kwargs, **kwargs}
+
+        multipliers = _params.get("multipliers", None)
+
+        return dict(
+            url=f"{self.gradient_api_url}/models/{self.model_id}/fine-tune",
+            headers={
+                "authorization": f"Bearer {self.gradient_access_token}",
+                "x-gradient-workspace-id": f"{self.gradient_workspace_id}",
+                "accept": "application/json",
+                "content-type": "application/json",
+            },
+            json=dict(
+                samples=tuple(
+                    {
+                        "inputs": input,
+                    }
+                    for input in inputs
+                )
+                if multipliers is None
+                else tuple(
+                    {
+                        "inputs": input,
+                        "fineTuningParameters": {
+                            "multiplier": multiplier,
+                        },
+                    }
+                    for input, multiplier in zip(inputs, multipliers)
+                ),
+            ),
+        )
+
+    def _kwargs_post_request(
+        self, prompt: str, kwargs: Mapping[str, Any]
+    ) -> Mapping[str, Any]:
+        """Build the kwargs for the Post request, used by sync
+
+        Args:
+            prompt (str): prompt used in query
+            kwargs (dict): model kwargs in payload
+
+        Returns:
+            Dict[str, Union[str,dict]]: _description_
+        """
+        _model_kwargs = self.model_kwargs or {}
+        _params = {**_model_kwargs, **kwargs}
+
+        return dict(
+            url=f"{self.gradient_api_url}/models/{self.model_id}/complete",
+            headers={
+                "authorization": f"Bearer {self.gradient_access_token}",
+                "x-gradient-workspace-id": f"{self.gradient_workspace_id}",
+                "accept": "application/json",
+                "content-type": "application/json",
+            },
+            json=dict(
+                query=prompt,
+                maxGeneratedTokenCount=_params.get("max_generated_token_count", None),
+                temperature=_params.get("temperature", None),
+                topK=_params.get("top_k", None),
+                topP=_params.get("top_p", None),
+            ),
+        )
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call to Gradients API `model/{id}/complete`.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+        """
+        try:
+            response = requests.post(**self._kwargs_post_request(prompt, kwargs))
+            if response.status_code != 200:
+                raise Exception(
+                    f"Gradient returned an unexpected response with status "
+                    f"{response.status_code}: {response.text}"
+                )
+        except requests.exceptions.RequestException as e:
+            raise Exception(f"RequestException while calling Gradient Endpoint: {e}")
+
+        text = response.json()["generatedOutput"]
+
+        if stop is not None:
+            # Apply stop tokens when making calls to Gradient
+            text = enforce_stop_tokens(text, stop)
+
+        return text
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Async Call to Gradients API `model/{id}/complete`.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+        """
+        if not self.aiosession:
+            async with aiohttp.ClientSession() as session:
+                async with session.post(
+                    **self._kwargs_post_request(prompt=prompt, kwargs=kwargs)
+                ) as response:
+                    if response.status != 200:
+                        raise Exception(
+                            f"Gradient returned an unexpected response with status "
+                            f"{response.status}: {response.text}"
+                        )
+                    text = (await response.json())["generatedOutput"]
+        else:
+            async with self.aiosession.post(
+                **self._kwargs_post_request(prompt=prompt, kwargs=kwargs)
+            ) as response:
+                if response.status != 200:
+                    raise Exception(
+                        f"Gradient returned an unexpected response with status "
+                        f"{response.status}: {response.text}"
+                    )
+                text = (await response.json())["generatedOutput"]
+
+        if stop is not None:
+            # Apply stop tokens when making calls to Gradient
+            text = enforce_stop_tokens(text, stop)
+
+        return text
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Run the LLM on the given prompt and input."""
+
+        # same thing with threading
+        def _inner_generate(prompt: str) -> List[Generation]:
+            return [
+                Generation(
+                    text=self._call(
+                        prompt=prompt, stop=stop, run_manager=run_manager, **kwargs
+                    )
+                )
+            ]
+
+        if len(prompts) <= 1:
+            generations = list(map(_inner_generate, prompts))
+        else:
+            with ThreadPoolExecutor(min(8, len(prompts))) as p:
+                generations = list(p.map(_inner_generate, prompts))
+
+        return LLMResult(generations=generations)
+
+    async def _agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Run the LLM on the given prompt and input."""
+        generations = []
+        for generation in asyncio.gather(
+            [self._acall(prompt, stop=stop, run_manager=run_manager, **kwargs)]
+            for prompt in prompts
+        ):
+            generations.append([Generation(text=generation)])
+        return LLMResult(generations=generations)
+
+    def train_unsupervised(
+        self,
+        inputs: Sequence[str],
+        **kwargs: Any,
+    ) -> TrainResult:
+        try:
+            response = requests.post(
+                **self._kwargs_post_fine_tune_request(inputs, kwargs)
+            )
+            if response.status_code != 200:
+                raise Exception(
+                    f"Gradient returned an unexpected response with status "
+                    f"{response.status_code}: {response.text}"
+                )
+        except requests.exceptions.RequestException as e:
+            raise Exception(f"RequestException while calling Gradient Endpoint: {e}")
+
+        response_json = response.json()
+        loss = response_json["sumLoss"] / response_json["numberOfTrainableTokens"]
+        return TrainResult(loss=loss)
+
+    async def atrain_unsupervised(
+        self,
+        inputs: Sequence[str],
+        **kwargs: Any,
+    ) -> TrainResult:
+        if not self.aiosession:
+            async with aiohttp.ClientSession() as session:
+                async with session.post(
+                    **self._kwargs_post_fine_tune_request(inputs, kwargs)
+                ) as response:
+                    if response.status != 200:
+                        raise Exception(
+                            f"Gradient returned an unexpected response with status "
+                            f"{response.status}: {response.text}"
+                        )
+                    response_json = await response.json()
+                    loss = (
+                        response_json["sumLoss"]
+                        / response_json["numberOfTrainableTokens"]
+                    )
+        else:
+            async with self.aiosession.post(
+                **self._kwargs_post_fine_tune_request(inputs, kwargs)
+            ) as response:
+                if response.status != 200:
+                    raise Exception(
+                        f"Gradient returned an unexpected response with status "
+                        f"{response.status}: {response.text}"
+                    )
+                response_json = await response.json()
+                loss = (
+                    response_json["sumLoss"] / response_json["numberOfTrainableTokens"]
+                )
+
+        return TrainResult(loss=loss)
diff --git a/llm/Lib/site-packages/langchain_community/llms/grammars/json.gbnf b/llm/Lib/site-packages/langchain_community/llms/grammars/json.gbnf
new file mode 100644
index 0000000000000000000000000000000000000000..61bd2b2e65bf9c2632dc7713a8bed5420bebef28
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/grammars/json.gbnf
@@ -0,0 +1,29 @@
+# Grammar for subset of JSON - doesn't support full string or number syntax
+
+root  ::= object
+value ::= object | array | string | number | boolean | "null"
+
+object ::=
+  "{" ws (
+            string ":" ws value
+    ("," ws string ":" ws value)*
+  )? "}"
+
+array  ::=
+  "[" ws (
+            value
+    ("," ws value)*
+  )? "]"
+
+string  ::=
+  "\"" (
+    [^"\\] |
+    "\\" (["\\/bfnrt] | "u" [0-9a-fA-F] [0-9a-fA-F] [0-9a-fA-F] [0-9a-fA-F]) # escapes
+  )* "\"" ws
+
+# Only plain integers currently
+number  ::= "-"? [0-9]+ ws
+boolean ::= ("true" | "false") ws
+
+# Optional space: by convention, applied in this grammar after literal chars when allowed
+ws ::= ([ \t\n] ws)?
\ No newline at end of file
diff --git a/llm/Lib/site-packages/langchain_community/llms/grammars/list.gbnf b/llm/Lib/site-packages/langchain_community/llms/grammars/list.gbnf
new file mode 100644
index 0000000000000000000000000000000000000000..30ea6e0c8499de5837b52dc55e9be9cbba158f5e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/grammars/list.gbnf
@@ -0,0 +1,14 @@
+root ::= "[" items "]" EOF
+
+items ::= item ("," ws* item)*
+
+item ::= string
+
+string  ::=
+  "\"" word (ws+ word)* "\"" ws*
+
+word ::= [a-zA-Z]+
+
+ws ::= " "
+
+EOF ::= "\n"
\ No newline at end of file
diff --git a/llm/Lib/site-packages/langchain_community/llms/huggingface_endpoint.py b/llm/Lib/site-packages/langchain_community/llms/huggingface_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..290b2da9633684bcfc0b193a08cc590cf2a009b3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/huggingface_endpoint.py
@@ -0,0 +1,372 @@
+import json
+import logging
+from typing import Any, AsyncIterator, Dict, Iterator, List, Mapping, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env, get_pydantic_field_names
+
+logger = logging.getLogger(__name__)
+
+VALID_TASKS = (
+    "text2text-generation",
+    "text-generation",
+    "summarization",
+    "conversational",
+)
+
+
+class HuggingFaceEndpoint(LLM):
+    """
+    HuggingFace Endpoint.
+
+    To use this class, you should have installed the ``huggingface_hub`` package, and
+    the environment variable ``HUGGINGFACEHUB_API_TOKEN`` set with your API token,
+    or given as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            # Basic Example (no streaming)
+            llm = HuggingFaceEndpoint(
+                endpoint_url="http://localhost:8010/",
+                max_new_tokens=512,
+                top_k=10,
+                top_p=0.95,
+                typical_p=0.95,
+                temperature=0.01,
+                repetition_penalty=1.03,
+                huggingfacehub_api_token="my-api-key"
+            )
+            print(llm("What is Deep Learning?"))
+
+            # Streaming response example
+            from langchain_core.callbacks.streaming_stdout import StreamingStdOutCallbackHandler
+
+            callbacks = [StreamingStdOutCallbackHandler()]
+            llm = HuggingFaceEndpoint(
+                endpoint_url="http://localhost:8010/",
+                max_new_tokens=512,
+                top_k=10,
+                top_p=0.95,
+                typical_p=0.95,
+                temperature=0.01,
+                repetition_penalty=1.03,
+                callbacks=callbacks,
+                streaming=True,
+                huggingfacehub_api_token="my-api-key"
+            )
+            print(llm("What is Deep Learning?"))
+
+    """  # noqa: E501
+
+    endpoint_url: Optional[str] = None
+    """Endpoint URL to use."""
+    repo_id: Optional[str] = None
+    """Repo to use."""
+    huggingfacehub_api_token: Optional[str] = None
+    max_new_tokens: int = 512
+    """Maximum number of generated tokens"""
+    top_k: Optional[int] = None
+    """The number of highest probability vocabulary tokens to keep for
+    top-k-filtering."""
+    top_p: Optional[float] = 0.95
+    """If set to < 1, only the smallest set of most probable tokens with probabilities
+    that add up to `top_p` or higher are kept for generation."""
+    typical_p: Optional[float] = 0.95
+    """Typical Decoding mass. See [Typical Decoding for Natural Language
+    Generation](https://arxiv.org/abs/2202.00666) for more information."""
+    temperature: Optional[float] = 0.8
+    """The value used to module the logits distribution."""
+    repetition_penalty: Optional[float] = None
+    """The parameter for repetition penalty. 1.0 means no penalty.
+    See [this paper](https://arxiv.org/pdf/1909.05858.pdf) for more details."""
+    return_full_text: bool = False
+    """Whether to prepend the prompt to the generated text"""
+    truncate: Optional[int] = None
+    """Truncate inputs tokens to the given size"""
+    stop_sequences: List[str] = Field(default_factory=list)
+    """Stop generating tokens if a member of `stop_sequences` is generated"""
+    seed: Optional[int] = None
+    """Random sampling seed"""
+    inference_server_url: str = ""
+    """text-generation-inference instance base url"""
+    timeout: int = 120
+    """Timeout in seconds"""
+    streaming: bool = False
+    """Whether to generate a stream of tokens asynchronously"""
+    do_sample: bool = False
+    """Activate logits sampling"""
+    watermark: bool = False
+    """Watermarking with [A Watermark for Large Language Models]
+    (https://arxiv.org/abs/2301.10226)"""
+    server_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any text-generation-inference server parameters not explicitly specified"""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `call` not explicitly specified"""
+    model: str
+    client: Any
+    async_client: Any
+    task: Optional[str] = None
+    """Task to call the model with.
+    Should be a task that returns `generated_text` or `summary_text`."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name in extra:
+                raise ValueError(f"Found {field_name} supplied twice.")
+            if field_name not in all_required_field_names:
+                logger.warning(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please make sure that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+
+        invalid_model_kwargs = all_required_field_names.intersection(extra.keys())
+        if invalid_model_kwargs:
+            raise ValueError(
+                f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+                f"Instead they were passed in as part of `model_kwargs` parameter."
+            )
+
+        values["model_kwargs"] = extra
+        if "endpoint_url" not in values and "repo_id" not in values:
+            raise ValueError(
+                "Please specify an `endpoint_url` or `repo_id` for the model."
+            )
+        if "endpoint_url" in values and "repo_id" in values:
+            raise ValueError(
+                "Please specify either an `endpoint_url` OR a `repo_id`, not both."
+            )
+        values["model"] = values.get("endpoint_url") or values.get("repo_id")
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that package is installed and that the API token is valid."""
+        try:
+            from huggingface_hub import login
+
+        except ImportError:
+            raise ImportError(
+                "Could not import huggingface_hub python package. "
+                "Please install it with `pip install huggingface_hub`."
+            )
+        try:
+            huggingfacehub_api_token = get_from_dict_or_env(
+                values, "huggingfacehub_api_token", "HUGGINGFACEHUB_API_TOKEN"
+            )
+            login(token=huggingfacehub_api_token)
+        except Exception as e:
+            raise ValueError(
+                "Could not authenticate with huggingface_hub. "
+                "Please check your API token."
+            ) from e
+
+        from huggingface_hub import AsyncInferenceClient, InferenceClient
+
+        values["client"] = InferenceClient(
+            model=values["model"],
+            timeout=values["timeout"],
+            token=huggingfacehub_api_token,
+            **values["server_kwargs"],
+        )
+        values["async_client"] = AsyncInferenceClient(
+            model=values["model"],
+            timeout=values["timeout"],
+            token=huggingfacehub_api_token,
+            **values["server_kwargs"],
+        )
+
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling text generation inference API."""
+        return {
+            "max_new_tokens": self.max_new_tokens,
+            "top_k": self.top_k,
+            "top_p": self.top_p,
+            "typical_p": self.typical_p,
+            "temperature": self.temperature,
+            "repetition_penalty": self.repetition_penalty,
+            "return_full_text": self.return_full_text,
+            "truncate": self.truncate,
+            "stop_sequences": self.stop_sequences,
+            "seed": self.seed,
+            "do_sample": self.do_sample,
+            "watermark": self.watermark,
+            **self.model_kwargs,
+        }
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            **{"endpoint_url": self.endpoint_url, "task": self.task},
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "huggingface_endpoint"
+
+    def _invocation_params(
+        self, runtime_stop: Optional[List[str]], **kwargs: Any
+    ) -> Dict[str, Any]:
+        params = {**self._default_params, **kwargs}
+        params["stop_sequences"] = params["stop_sequences"] + (runtime_stop or [])
+        return params
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to HuggingFace Hub's inference endpoint."""
+        invocation_params = self._invocation_params(stop, **kwargs)
+        if self.streaming:
+            completion = ""
+            for chunk in self._stream(prompt, stop, run_manager, **invocation_params):
+                completion += chunk.text
+            return completion
+        else:
+            invocation_params["stop"] = invocation_params[
+                "stop_sequences"
+            ]  # porting 'stop_sequences' into the 'stop' argument
+            response = self.client.post(
+                json={"inputs": prompt, "parameters": invocation_params},
+                stream=False,
+                task=self.task,
+            )
+            response_text = json.loads(response.decode())[0]["generated_text"]
+
+            # Maybe the generation has stopped at one of the stop sequences:
+            # then we remove this stop sequence from the end of the generated text
+            for stop_seq in invocation_params["stop_sequences"]:
+                if response_text[-len(stop_seq) :] == stop_seq:
+                    response_text = response_text[: -len(stop_seq)]
+            return response_text
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        invocation_params = self._invocation_params(stop, **kwargs)
+        if self.streaming:
+            completion = ""
+            async for chunk in self._astream(
+                prompt, stop, run_manager, **invocation_params
+            ):
+                completion += chunk.text
+            return completion
+        else:
+            invocation_params["stop"] = invocation_params["stop_sequences"]
+            response = await self.async_client.post(
+                json={"inputs": prompt, "parameters": invocation_params},
+                stream=False,
+                task=self.task,
+            )
+            response_text = json.loads(response.decode())[0]["generated_text"]
+
+            # Maybe the generation has stopped at one of the stop sequences:
+            # then remove this stop sequence from the end of the generated text
+            for stop_seq in invocation_params["stop_sequences"]:
+                if response_text[-len(stop_seq) :] == stop_seq:
+                    response_text = response_text[: -len(stop_seq)]
+            return response_text
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        invocation_params = self._invocation_params(stop, **kwargs)
+
+        for response in self.client.text_generation(
+            prompt, **invocation_params, stream=True
+        ):
+            # identify stop sequence in generated text, if any
+            stop_seq_found: Optional[str] = None
+            for stop_seq in invocation_params["stop_sequences"]:
+                if stop_seq in response:
+                    stop_seq_found = stop_seq
+
+            # identify text to yield
+            text: Optional[str] = None
+            if stop_seq_found:
+                text = response[: response.index(stop_seq_found)]
+            else:
+                text = response
+
+            # yield text, if any
+            if text:
+                chunk = GenerationChunk(text=text)
+
+                if run_manager:
+                    run_manager.on_llm_new_token(chunk.text)
+                yield chunk
+
+            # break if stop sequence found
+            if stop_seq_found:
+                break
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        invocation_params = self._invocation_params(stop, **kwargs)
+        async for response in await self.async_client.text_generation(
+            prompt, **invocation_params, stream=True
+        ):
+            # identify stop sequence in generated text, if any
+            stop_seq_found: Optional[str] = None
+            for stop_seq in invocation_params["stop_sequences"]:
+                if stop_seq in response:
+                    stop_seq_found = stop_seq
+
+            # identify text to yield
+            text: Optional[str] = None
+            if stop_seq_found:
+                text = response[: response.index(stop_seq_found)]
+            else:
+                text = response
+
+            # yield text, if any
+            if text:
+                chunk = GenerationChunk(text=text)
+
+                if run_manager:
+                    await run_manager.on_llm_new_token(chunk.text)
+                yield chunk
+
+            # break if stop sequence found
+            if stop_seq_found:
+                break
diff --git a/llm/Lib/site-packages/langchain_community/llms/huggingface_hub.py b/llm/Lib/site-packages/langchain_community/llms/huggingface_hub.py
new file mode 100644
index 0000000000000000000000000000000000000000..2a5deaf766d61ab0c7bc2af7d6233222a6f943a8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/huggingface_hub.py
@@ -0,0 +1,152 @@
+import json
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+# key: task
+# value: key in the output dictionary
+VALID_TASKS_DICT = {
+    "translation": "translation_text",
+    "summarization": "summary_text",
+    "conversational": "generated_text",
+    "text-generation": "generated_text",
+    "text2text-generation": "generated_text",
+}
+
+
+@deprecated("0.0.21", removal="0.2.0", alternative="HuggingFaceEndpoint")
+class HuggingFaceHub(LLM):
+    """HuggingFaceHub  models.
+    ! This class is deprecated, you should use HuggingFaceEndpoint instead.
+
+    To use, you should have the ``huggingface_hub`` python package installed, and the
+    environment variable ``HUGGINGFACEHUB_API_TOKEN`` set with your API token, or pass
+    it as a named parameter to the constructor.
+
+    Supports `text-generation`, `text2text-generation`, `conversational`, `translation`,
+     and `summarization`.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import HuggingFaceHub
+            hf = HuggingFaceHub(repo_id="gpt2", huggingfacehub_api_token="my-api-key")
+    """
+
+    client: Any  #: :meta private:
+    repo_id: Optional[str] = None
+    """Model name to use. 
+    If not provided, the default model for the chosen task will be used."""
+    task: Optional[str] = None
+    """Task to call the model with.
+    Should be a task that returns `generated_text`, `summary_text`, 
+    or `translation_text`."""
+    model_kwargs: Optional[dict] = None
+    """Keyword arguments to pass to the model."""
+
+    huggingfacehub_api_token: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        huggingfacehub_api_token = get_from_dict_or_env(
+            values, "huggingfacehub_api_token", "HUGGINGFACEHUB_API_TOKEN"
+        )
+        try:
+            from huggingface_hub import HfApi, InferenceClient
+
+            repo_id = values["repo_id"]
+            client = InferenceClient(
+                model=repo_id,
+                token=huggingfacehub_api_token,
+            )
+            if not values["task"]:
+                if not repo_id:
+                    raise ValueError(
+                        "Must specify either `repo_id` or `task`, or both."
+                    )
+                # Use the recommended task for the chosen model
+                model_info = HfApi(token=huggingfacehub_api_token).model_info(
+                    repo_id=repo_id
+                )
+                values["task"] = model_info.pipeline_tag
+            if values["task"] not in VALID_TASKS_DICT:
+                raise ValueError(
+                    f"Got invalid task {values['task']}, "
+                    f"currently only {VALID_TASKS_DICT.keys()} are supported"
+                )
+            values["client"] = client
+        except ImportError:
+            raise ValueError(
+                "Could not import huggingface_hub python package. "
+                "Please install it with `pip install huggingface_hub`."
+            )
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            **{"repo_id": self.repo_id, "task": self.task},
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "huggingface_hub"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to HuggingFace Hub's inference endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = hf("Tell me a joke.")
+        """
+        _model_kwargs = self.model_kwargs or {}
+        parameters = {**_model_kwargs, **kwargs}
+
+        response = self.client.post(
+            json={"inputs": prompt, "parameters": parameters}, task=self.task
+        )
+        response = json.loads(response.decode())
+        if "error" in response:
+            raise ValueError(f"Error raised by inference API: {response['error']}")
+
+        response_key = VALID_TASKS_DICT[self.task]  # type: ignore
+        if isinstance(response, list):
+            text = response[0][response_key]
+        else:
+            text = response[response_key]
+
+        if stop is not None:
+            # This is a bit hacky, but I can't figure out a better way to enforce
+            # stop tokens when making calls to huggingface_hub.
+            text = enforce_stop_tokens(text, stop)
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/huggingface_pipeline.py b/llm/Lib/site-packages/langchain_community/llms/huggingface_pipeline.py
new file mode 100644
index 0000000000000000000000000000000000000000..6957d8d6ec2db70ef1c913f8d8bb6f044b9ade96
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/huggingface_pipeline.py
@@ -0,0 +1,297 @@
+from __future__ import annotations
+
+import importlib.util
+import logging
+from typing import Any, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import BaseLLM
+from langchain_core.outputs import Generation, LLMResult
+from langchain_core.pydantic_v1 import Extra
+
+DEFAULT_MODEL_ID = "gpt2"
+DEFAULT_TASK = "text-generation"
+VALID_TASKS = (
+    "text2text-generation",
+    "text-generation",
+    "summarization",
+    "translation",
+)
+DEFAULT_BATCH_SIZE = 4
+
+logger = logging.getLogger(__name__)
+
+
+class HuggingFacePipeline(BaseLLM):
+    """HuggingFace Pipeline API.
+
+    To use, you should have the ``transformers`` python package installed.
+
+    Only supports `text-generation`, `text2text-generation`, `summarization` and
+    `translation`  for now.
+
+    Example using from_model_id:
+        .. code-block:: python
+
+            from langchain_community.llms import HuggingFacePipeline
+            hf = HuggingFacePipeline.from_model_id(
+                model_id="gpt2",
+                task="text-generation",
+                pipeline_kwargs={"max_new_tokens": 10},
+            )
+    Example passing pipeline in directly:
+        .. code-block:: python
+
+            from langchain_community.llms import HuggingFacePipeline
+            from transformers import AutoModelForCausalLM, AutoTokenizer, pipeline
+
+            model_id = "gpt2"
+            tokenizer = AutoTokenizer.from_pretrained(model_id)
+            model = AutoModelForCausalLM.from_pretrained(model_id)
+            pipe = pipeline(
+                "text-generation", model=model, tokenizer=tokenizer, max_new_tokens=10
+            )
+            hf = HuggingFacePipeline(pipeline=pipe)
+    """
+
+    pipeline: Any  #: :meta private:
+    model_id: str = DEFAULT_MODEL_ID
+    """Model name to use."""
+    model_kwargs: Optional[dict] = None
+    """Keyword arguments passed to the model."""
+    pipeline_kwargs: Optional[dict] = None
+    """Keyword arguments passed to the pipeline."""
+    batch_size: int = DEFAULT_BATCH_SIZE
+    """Batch size to use when passing multiple documents to generate."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @classmethod
+    def from_model_id(
+        cls,
+        model_id: str,
+        task: str,
+        backend: str = "default",
+        device: Optional[int] = -1,
+        device_map: Optional[str] = None,
+        model_kwargs: Optional[dict] = None,
+        pipeline_kwargs: Optional[dict] = None,
+        batch_size: int = DEFAULT_BATCH_SIZE,
+        **kwargs: Any,
+    ) -> HuggingFacePipeline:
+        """Construct the pipeline object from model_id and task."""
+        try:
+            from transformers import (
+                AutoModelForCausalLM,
+                AutoModelForSeq2SeqLM,
+                AutoTokenizer,
+            )
+            from transformers import pipeline as hf_pipeline
+
+        except ImportError:
+            raise ValueError(
+                "Could not import transformers python package. "
+                "Please install it with `pip install transformers`."
+            )
+
+        _model_kwargs = model_kwargs or {}
+        tokenizer = AutoTokenizer.from_pretrained(model_id, **_model_kwargs)
+
+        try:
+            if task == "text-generation":
+                if backend == "openvino":
+                    try:
+                        from optimum.intel.openvino import OVModelForCausalLM
+
+                    except ImportError:
+                        raise ValueError(
+                            "Could not import optimum-intel python package. "
+                            "Please install it with: "
+                            "pip install 'optimum[openvino,nncf]' "
+                        )
+                    try:
+                        # use local model
+                        model = OVModelForCausalLM.from_pretrained(
+                            model_id, **_model_kwargs
+                        )
+
+                    except Exception:
+                        # use remote model
+                        model = OVModelForCausalLM.from_pretrained(
+                            model_id, export=True, **_model_kwargs
+                        )
+                else:
+                    model = AutoModelForCausalLM.from_pretrained(
+                        model_id, **_model_kwargs
+                    )
+            elif task in ("text2text-generation", "summarization", "translation"):
+                if backend == "openvino":
+                    try:
+                        from optimum.intel.openvino import OVModelForSeq2SeqLM
+
+                    except ImportError:
+                        raise ValueError(
+                            "Could not import optimum-intel python package. "
+                            "Please install it with: "
+                            "pip install 'optimum[openvino,nncf]' "
+                        )
+                    try:
+                        # use local model
+                        model = OVModelForSeq2SeqLM.from_pretrained(
+                            model_id, **_model_kwargs
+                        )
+
+                    except Exception:
+                        # use remote model
+                        model = OVModelForSeq2SeqLM.from_pretrained(
+                            model_id, export=True, **_model_kwargs
+                        )
+                else:
+                    model = AutoModelForSeq2SeqLM.from_pretrained(
+                        model_id, **_model_kwargs
+                    )
+            else:
+                raise ValueError(
+                    f"Got invalid task {task}, "
+                    f"currently only {VALID_TASKS} are supported"
+                )
+        except ImportError as e:
+            raise ValueError(
+                f"Could not load the {task} model due to missing dependencies."
+            ) from e
+
+        if tokenizer.pad_token is None:
+            tokenizer.pad_token_id = model.config.eos_token_id
+
+        if (
+            (
+                getattr(model, "is_loaded_in_4bit", False)
+                or getattr(model, "is_loaded_in_8bit", False)
+            )
+            and device is not None
+            and backend == "default"
+        ):
+            logger.warning(
+                f"Setting the `device` argument to None from {device} to avoid "
+                "the error caused by attempting to move the model that was already "
+                "loaded on the GPU using the Accelerate module to the same or "
+                "another device."
+            )
+            device = None
+
+        if (
+            device is not None
+            and importlib.util.find_spec("torch") is not None
+            and backend == "default"
+        ):
+            import torch
+
+            cuda_device_count = torch.cuda.device_count()
+            if device < -1 or (device >= cuda_device_count):
+                raise ValueError(
+                    f"Got device=={device}, "
+                    f"device is required to be within [-1, {cuda_device_count})"
+                )
+            if device_map is not None and device < 0:
+                device = None
+            if device is not None and device < 0 and cuda_device_count > 0:
+                logger.warning(
+                    "Device has %d GPUs available. "
+                    "Provide device={deviceId} to `from_model_id` to use available"
+                    "GPUs for execution. deviceId is -1 (default) for CPU and "
+                    "can be a positive integer associated with CUDA device id.",
+                    cuda_device_count,
+                )
+        if device is not None and device_map is not None and backend == "openvino":
+            logger.warning("Please set device for OpenVINO through: " "'model_kwargs'")
+        if "trust_remote_code" in _model_kwargs:
+            _model_kwargs = {
+                k: v for k, v in _model_kwargs.items() if k != "trust_remote_code"
+            }
+        _pipeline_kwargs = pipeline_kwargs or {}
+        pipeline = hf_pipeline(
+            task=task,
+            model=model,
+            tokenizer=tokenizer,
+            device=device,
+            device_map=device_map,
+            batch_size=batch_size,
+            model_kwargs=_model_kwargs,
+            **_pipeline_kwargs,
+        )
+        if pipeline.task not in VALID_TASKS:
+            raise ValueError(
+                f"Got invalid task {pipeline.task}, "
+                f"currently only {VALID_TASKS} are supported"
+            )
+        return cls(
+            pipeline=pipeline,
+            model_id=model_id,
+            model_kwargs=_model_kwargs,
+            pipeline_kwargs=_pipeline_kwargs,
+            batch_size=batch_size,
+            **kwargs,
+        )
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model_id": self.model_id,
+            "model_kwargs": self.model_kwargs,
+            "pipeline_kwargs": self.pipeline_kwargs,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        return "huggingface_pipeline"
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        # List to hold all results
+        text_generations: List[str] = []
+        pipeline_kwargs = kwargs.get("pipeline_kwargs", {})
+
+        for i in range(0, len(prompts), self.batch_size):
+            batch_prompts = prompts[i : i + self.batch_size]
+
+            # Process batch of prompts
+            responses = self.pipeline(
+                batch_prompts,
+                **pipeline_kwargs,
+            )
+
+            # Process each response in the batch
+            for j, response in enumerate(responses):
+                if isinstance(response, list):
+                    # if model returns multiple generations, pick the top one
+                    response = response[0]
+
+                if self.pipeline.task == "text-generation":
+                    text = response["generated_text"]
+                elif self.pipeline.task == "text2text-generation":
+                    text = response["generated_text"]
+                elif self.pipeline.task == "summarization":
+                    text = response["summary_text"]
+                elif self.pipeline.task in "translation":
+                    text = response["translation_text"]
+                else:
+                    raise ValueError(
+                        f"Got invalid task {self.pipeline.task}, "
+                        f"currently only {VALID_TASKS} are supported"
+                    )
+
+                # Append the processed text to results
+                text_generations.append(text)
+
+        return LLMResult(
+            generations=[[Generation(text=text)] for text in text_generations]
+        )
diff --git a/llm/Lib/site-packages/langchain_community/llms/huggingface_text_gen_inference.py b/llm/Lib/site-packages/langchain_community/llms/huggingface_text_gen_inference.py
new file mode 100644
index 0000000000000000000000000000000000000000..e053d172789d871165faf9039dcb79bfa79ee263
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/huggingface_text_gen_inference.py
@@ -0,0 +1,306 @@
+import logging
+from typing import Any, AsyncIterator, Dict, Iterator, List, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+from langchain_core.utils import get_pydantic_field_names
+
+logger = logging.getLogger(__name__)
+
+
+@deprecated("0.0.21", removal="0.2.0", alternative="HuggingFaceEndpoint")
+class HuggingFaceTextGenInference(LLM):
+    """
+    HuggingFace text generation API.
+    ! This class is deprecated, you should use HuggingFaceEndpoint instead !
+
+    To use, you should have the `text-generation` python package installed and
+    a text-generation server running.
+
+    Example:
+        .. code-block:: python
+
+            # Basic Example (no streaming)
+            llm = HuggingFaceTextGenInference(
+                inference_server_url="http://localhost:8010/",
+                max_new_tokens=512,
+                top_k=10,
+                top_p=0.95,
+                typical_p=0.95,
+                temperature=0.01,
+                repetition_penalty=1.03,
+            )
+            print(llm("What is Deep Learning?"))  # noqa: T201
+
+            # Streaming response example
+            from langchain_community.callbacks import streaming_stdout
+
+            callbacks = [streaming_stdout.StreamingStdOutCallbackHandler()]
+            llm = HuggingFaceTextGenInference(
+                inference_server_url="http://localhost:8010/",
+                max_new_tokens=512,
+                top_k=10,
+                top_p=0.95,
+                typical_p=0.95,
+                temperature=0.01,
+                repetition_penalty=1.03,
+                callbacks=callbacks,
+                streaming=True
+            )
+            print(llm("What is Deep Learning?"))  # noqa: T201
+
+    """
+
+    max_new_tokens: int = 512
+    """Maximum number of generated tokens"""
+    top_k: Optional[int] = None
+    """The number of highest probability vocabulary tokens to keep for
+    top-k-filtering."""
+    top_p: Optional[float] = 0.95
+    """If set to < 1, only the smallest set of most probable tokens with probabilities
+    that add up to `top_p` or higher are kept for generation."""
+    typical_p: Optional[float] = 0.95
+    """Typical Decoding mass. See [Typical Decoding for Natural Language
+    Generation](https://arxiv.org/abs/2202.00666) for more information."""
+    temperature: Optional[float] = 0.8
+    """The value used to module the logits distribution."""
+    repetition_penalty: Optional[float] = None
+    """The parameter for repetition penalty. 1.0 means no penalty.
+    See [this paper](https://arxiv.org/pdf/1909.05858.pdf) for more details."""
+    return_full_text: bool = False
+    """Whether to prepend the prompt to the generated text"""
+    truncate: Optional[int] = None
+    """Truncate inputs tokens to the given size"""
+    stop_sequences: List[str] = Field(default_factory=list)
+    """Stop generating tokens if a member of `stop_sequences` is generated"""
+    seed: Optional[int] = None
+    """Random sampling seed"""
+    inference_server_url: str = ""
+    """text-generation-inference instance base url"""
+    timeout: int = 120
+    """Timeout in seconds"""
+    streaming: bool = False
+    """Whether to generate a stream of tokens asynchronously"""
+    do_sample: bool = False
+    """Activate logits sampling"""
+    watermark: bool = False
+    """Watermarking with [A Watermark for Large Language Models]
+    (https://arxiv.org/abs/2301.10226)"""
+    server_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any text-generation-inference server parameters not explicitly specified"""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `call` not explicitly specified"""
+    client: Any
+    async_client: Any
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name in extra:
+                raise ValueError(f"Found {field_name} supplied twice.")
+            if field_name not in all_required_field_names:
+                logger.warning(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+
+        invalid_model_kwargs = all_required_field_names.intersection(extra.keys())
+        if invalid_model_kwargs:
+            raise ValueError(
+                f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+                f"Instead they were passed in as part of `model_kwargs` parameter."
+            )
+
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that python package exists in environment."""
+
+        try:
+            import text_generation
+
+            values["client"] = text_generation.Client(
+                values["inference_server_url"],
+                timeout=values["timeout"],
+                **values["server_kwargs"],
+            )
+            values["async_client"] = text_generation.AsyncClient(
+                values["inference_server_url"],
+                timeout=values["timeout"],
+                **values["server_kwargs"],
+            )
+        except ImportError:
+            raise ImportError(
+                "Could not import text_generation python package. "
+                "Please install it with `pip install text_generation`."
+            )
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "huggingface_textgen_inference"
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling text generation inference API."""
+        return {
+            "max_new_tokens": self.max_new_tokens,
+            "top_k": self.top_k,
+            "top_p": self.top_p,
+            "typical_p": self.typical_p,
+            "temperature": self.temperature,
+            "repetition_penalty": self.repetition_penalty,
+            "return_full_text": self.return_full_text,
+            "truncate": self.truncate,
+            "stop_sequences": self.stop_sequences,
+            "seed": self.seed,
+            "do_sample": self.do_sample,
+            "watermark": self.watermark,
+            **self.model_kwargs,
+        }
+
+    def _invocation_params(
+        self, runtime_stop: Optional[List[str]], **kwargs: Any
+    ) -> Dict[str, Any]:
+        params = {**self._default_params, **kwargs}
+        params["stop_sequences"] = params["stop_sequences"] + (runtime_stop or [])
+        return params
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        if self.streaming:
+            completion = ""
+            for chunk in self._stream(prompt, stop, run_manager, **kwargs):
+                completion += chunk.text
+            return completion
+
+        invocation_params = self._invocation_params(stop, **kwargs)
+        res = self.client.generate(prompt, **invocation_params)
+        # remove stop sequences from the end of the generated text
+        for stop_seq in invocation_params["stop_sequences"]:
+            if stop_seq in res.generated_text:
+                res.generated_text = res.generated_text[
+                    : res.generated_text.index(stop_seq)
+                ]
+        return res.generated_text
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        if self.streaming:
+            completion = ""
+            async for chunk in self._astream(prompt, stop, run_manager, **kwargs):
+                completion += chunk.text
+            return completion
+
+        invocation_params = self._invocation_params(stop, **kwargs)
+        res = await self.async_client.generate(prompt, **invocation_params)
+        # remove stop sequences from the end of the generated text
+        for stop_seq in invocation_params["stop_sequences"]:
+            if stop_seq in res.generated_text:
+                res.generated_text = res.generated_text[
+                    : res.generated_text.index(stop_seq)
+                ]
+        return res.generated_text
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        invocation_params = self._invocation_params(stop, **kwargs)
+
+        for res in self.client.generate_stream(prompt, **invocation_params):
+            # identify stop sequence in generated text, if any
+            stop_seq_found: Optional[str] = None
+            for stop_seq in invocation_params["stop_sequences"]:
+                if stop_seq in res.token.text:
+                    stop_seq_found = stop_seq
+
+            # identify text to yield
+            text: Optional[str] = None
+            if res.token.special:
+                text = None
+            elif stop_seq_found:
+                text = res.token.text[: res.token.text.index(stop_seq_found)]
+            else:
+                text = res.token.text
+
+            # yield text, if any
+            if text:
+                chunk = GenerationChunk(text=text)
+
+                if run_manager:
+                    run_manager.on_llm_new_token(chunk.text)
+                yield chunk
+
+            # break if stop sequence found
+            if stop_seq_found:
+                break
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        invocation_params = self._invocation_params(stop, **kwargs)
+
+        async for res in self.async_client.generate_stream(prompt, **invocation_params):
+            # identify stop sequence in generated text, if any
+            stop_seq_found: Optional[str] = None
+            for stop_seq in invocation_params["stop_sequences"]:
+                if stop_seq in res.token.text:
+                    stop_seq_found = stop_seq
+
+            # identify text to yield
+            text: Optional[str] = None
+            if res.token.special:
+                text = None
+            elif stop_seq_found:
+                text = res.token.text[: res.token.text.index(stop_seq_found)]
+            else:
+                text = res.token.text
+
+            # yield text, if any
+            if text:
+                chunk = GenerationChunk(text=text)
+
+                if run_manager:
+                    await run_manager.on_llm_new_token(chunk.text)
+                yield chunk
+
+            # break if stop sequence found
+            if stop_seq_found:
+                break
diff --git a/llm/Lib/site-packages/langchain_community/llms/human.py b/llm/Lib/site-packages/langchain_community/llms/human.py
new file mode 100644
index 0000000000000000000000000000000000000000..39473c0ee1e0e42f80b750523cface7aee56a13c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/human.py
@@ -0,0 +1,83 @@
+from typing import Any, Callable, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Field
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+
+def _display_prompt(prompt: str) -> None:
+    """Displays the given prompt to the user."""
+    print(f"\n{prompt}")  # noqa: T201
+
+
+def _collect_user_input(
+    separator: Optional[str] = None, stop: Optional[List[str]] = None
+) -> str:
+    """Collects and returns user input as a single string."""
+    separator = separator or "\n"
+    lines = []
+
+    while True:
+        line = input()
+        if not line:
+            break
+        lines.append(line)
+
+        if stop and any(seq in line for seq in stop):
+            break
+    # Combine all lines into a single string
+    multi_line_input = separator.join(lines)
+    return multi_line_input
+
+
+class HumanInputLLM(LLM):
+    """User input as the response."""
+
+    input_func: Callable = Field(default_factory=lambda: _collect_user_input)
+    prompt_func: Callable[[str], None] = Field(default_factory=lambda: _display_prompt)
+    separator: str = "\n"
+    input_kwargs: Mapping[str, Any] = {}
+    prompt_kwargs: Mapping[str, Any] = {}
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """
+        Returns an empty dictionary as there are no identifying parameters.
+        """
+        return {}
+
+    @property
+    def _llm_type(self) -> str:
+        """Returns the type of LLM."""
+        return "human-input"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """
+        Displays the prompt to the user and returns their input as a response.
+
+        Args:
+            prompt (str): The prompt to be displayed to the user.
+            stop (Optional[List[str]]): A list of stop strings.
+            run_manager (Optional[CallbackManagerForLLMRun]): Currently not used.
+
+        Returns:
+            str: The user's input as a response.
+        """
+        self.prompt_func(prompt, **self.prompt_kwargs)
+        user_input = self.input_func(
+            separator=self.separator, stop=stop, **self.input_kwargs
+        )
+
+        if stop is not None:
+            # I believe this is required since the stop tokens
+            # are not enforced by the human themselves
+            user_input = enforce_stop_tokens(user_input, stop)
+        return user_input
diff --git a/llm/Lib/site-packages/langchain_community/llms/ipex_llm.py b/llm/Lib/site-packages/langchain_community/llms/ipex_llm.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed037701806917037fe53589e150ef881830a1d0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/ipex_llm.py
@@ -0,0 +1,223 @@
+import logging
+from typing import Any, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra
+
+DEFAULT_MODEL_ID = "gpt2"
+
+
+logger = logging.getLogger(__name__)
+
+
+class IpexLLM(LLM):
+    """IpexLLM model.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import IpexLLM
+            llm = IpexLLM.from_model_id(model_id="THUDM/chatglm-6b")
+    """
+
+    model_id: str = DEFAULT_MODEL_ID
+    """Model name or model path to use."""
+    model_kwargs: Optional[dict] = None
+    """Keyword arguments passed to the model."""
+    model: Any  #: :meta private:
+    """IpexLLM model."""
+    tokenizer: Any  #: :meta private:
+    """Huggingface tokenizer model."""
+    streaming: bool = True
+    """Whether to stream the results, token by token."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @classmethod
+    def from_model_id(
+        cls,
+        model_id: str,
+        model_kwargs: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> LLM:
+        """
+        Construct object from model_id
+
+        Args:
+            model_id: Path for the huggingface repo id to be downloaded or
+                      the huggingface checkpoint folder.
+            model_kwargs: Keyword arguments to pass to the model and tokenizer.
+            kwargs: Extra arguments to pass to the model and tokenizer.
+
+        Returns:
+            An object of IpexLLM.
+        """
+        try:
+            from ipex_llm.transformers import (
+                AutoModel,
+                AutoModelForCausalLM,
+            )
+            from transformers import AutoTokenizer, LlamaTokenizer
+
+        except ImportError:
+            raise ValueError(
+                "Could not import ipex-llm or transformers. "
+                "Please install it with `pip install --pre --upgrade ipex-llm[all]`."
+            )
+
+        _model_kwargs = model_kwargs or {}
+
+        try:
+            tokenizer = AutoTokenizer.from_pretrained(model_id, **_model_kwargs)
+        except Exception:
+            tokenizer = LlamaTokenizer.from_pretrained(model_id, **_model_kwargs)
+
+        try:
+            model = AutoModelForCausalLM.from_pretrained(
+                model_id, load_in_4bit=True, **_model_kwargs
+            )
+        except Exception:
+            model = AutoModel.from_pretrained(
+                model_id, load_in_4bit=True, **_model_kwargs
+            )
+
+        if "trust_remote_code" in _model_kwargs:
+            _model_kwargs = {
+                k: v for k, v in _model_kwargs.items() if k != "trust_remote_code"
+            }
+
+        return cls(
+            model_id=model_id,
+            model=model,
+            tokenizer=tokenizer,
+            model_kwargs=_model_kwargs,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_model_id_low_bit(
+        cls,
+        model_id: str,
+        model_kwargs: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> LLM:
+        """
+        Construct low_bit object from model_id
+
+        Args:
+
+            model_id: Path for the ipex-llm transformers low-bit model folder.
+            model_kwargs: Keyword arguments to pass to the model and tokenizer.
+            kwargs: Extra arguments to pass to the model and tokenizer.
+
+        Returns:
+            An object of IpexLLM.
+        """
+        try:
+            from ipex_llm.transformers import (
+                AutoModel,
+                AutoModelForCausalLM,
+            )
+            from transformers import AutoTokenizer, LlamaTokenizer
+
+        except ImportError:
+            raise ValueError(
+                "Could not import ipex-llm or transformers. "
+                "Please install it with `pip install --pre --upgrade ipex-llm[all]`."
+            )
+
+        _model_kwargs = model_kwargs or {}
+        try:
+            tokenizer = AutoTokenizer.from_pretrained(model_id, **_model_kwargs)
+        except Exception:
+            tokenizer = LlamaTokenizer.from_pretrained(model_id, **_model_kwargs)
+
+        try:
+            model = AutoModelForCausalLM.load_low_bit(model_id, **_model_kwargs)
+        except Exception:
+            model = AutoModel.load_low_bit(model_id, **_model_kwargs)
+
+        if "trust_remote_code" in _model_kwargs:
+            _model_kwargs = {
+                k: v for k, v in _model_kwargs.items() if k != "trust_remote_code"
+            }
+
+        return cls(
+            model_id=model_id,
+            model=model,
+            tokenizer=tokenizer,
+            model_kwargs=_model_kwargs,
+            **kwargs,
+        )
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model_id": self.model_id,
+            "model_kwargs": self.model_kwargs,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        return "ipex-llm"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        if self.streaming:
+            from transformers import TextStreamer
+
+            input_ids = self.tokenizer.encode(prompt, return_tensors="pt")
+            streamer = TextStreamer(
+                self.tokenizer, skip_prompt=True, skip_special_tokens=True
+            )
+            if stop is not None:
+                from transformers.generation.stopping_criteria import (
+                    StoppingCriteriaList,
+                )
+                from transformers.tools.agents import StopSequenceCriteria
+
+                # stop generation when stop words are encountered
+                # TODO: stop generation when the following one is stop word
+                stopping_criteria = StoppingCriteriaList(
+                    [StopSequenceCriteria(stop, self.tokenizer)]
+                )
+            else:
+                stopping_criteria = None
+            output = self.model.generate(
+                input_ids,
+                streamer=streamer,
+                stopping_criteria=stopping_criteria,
+                **kwargs,
+            )
+            text = self.tokenizer.decode(output[0], skip_special_tokens=True)
+            return text
+        else:
+            input_ids = self.tokenizer.encode(prompt, return_tensors="pt")
+            if stop is not None:
+                from transformers.generation.stopping_criteria import (
+                    StoppingCriteriaList,
+                )
+                from transformers.tools.agents import StopSequenceCriteria
+
+                stopping_criteria = StoppingCriteriaList(
+                    [StopSequenceCriteria(stop, self.tokenizer)]
+                )
+            else:
+                stopping_criteria = None
+            output = self.model.generate(
+                input_ids, stopping_criteria=stopping_criteria, **kwargs
+            )
+            text = self.tokenizer.decode(output[0], skip_special_tokens=True)[
+                len(prompt) :
+            ]
+            return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/javelin_ai_gateway.py b/llm/Lib/site-packages/langchain_community/llms/javelin_ai_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..d53e4a9bf723cc500b92ec302a729fcedec2ad91
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/javelin_ai_gateway.py
@@ -0,0 +1,151 @@
+from __future__ import annotations
+
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import BaseModel, Extra
+
+
+# Ignoring type because below is valid pydantic code
+# Unexpected keyword argument "extra" for "__init_subclass__" of "object"
+class Params(BaseModel, extra=Extra.allow):  # type: ignore[call-arg]
+    """Parameters for the Javelin AI Gateway LLM."""
+
+    temperature: float = 0.0
+    stop: Optional[List[str]] = None
+    max_tokens: Optional[int] = None
+
+
+class JavelinAIGateway(LLM):
+    """Javelin AI Gateway LLMs.
+
+    To use, you should have the ``javelin_sdk`` python package installed.
+    For more information, see https://docs.getjavelin.io
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import JavelinAIGateway
+
+            completions = JavelinAIGateway(
+                gateway_uri="<your-javelin-ai-gateway-uri>",
+                route="<your-javelin-ai-gateway-completions-route>",
+                params={
+                    "temperature": 0.1
+                }
+            )
+    """
+
+    route: str
+    """The route to use for the Javelin AI Gateway API."""
+
+    client: Optional[Any] = None
+    """The Javelin AI Gateway client."""
+
+    gateway_uri: Optional[str] = None
+    """The URI of the Javelin AI Gateway API."""
+
+    params: Optional[Params] = None
+    """Parameters for the Javelin AI Gateway API."""
+
+    javelin_api_key: Optional[str] = None
+    """The API key for the Javelin AI Gateway API."""
+
+    def __init__(self, **kwargs: Any):
+        try:
+            from javelin_sdk import (
+                JavelinClient,
+                UnauthorizedError,
+            )
+        except ImportError:
+            raise ImportError(
+                "Could not import javelin_sdk python package. "
+                "Please install it with `pip install javelin_sdk`."
+            )
+        super().__init__(**kwargs)
+        if self.gateway_uri:
+            try:
+                self.client = JavelinClient(
+                    base_url=self.gateway_uri, api_key=self.javelin_api_key
+                )
+            except UnauthorizedError as e:
+                raise ValueError("Javelin: Incorrect API Key.") from e
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Javelin AI Gateway API."""
+        params: Dict[str, Any] = {
+            "gateway_uri": self.gateway_uri,
+            "route": self.route,
+            "javelin_api_key": self.javelin_api_key,
+            **(self.params.dict() if self.params else {}),
+        }
+        return params
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return self._default_params
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call the Javelin AI Gateway API."""
+        data: Dict[str, Any] = {
+            "prompt": prompt,
+            **(self.params.dict() if self.params else {}),
+        }
+        if s := (stop or (self.params.stop if self.params else None)):
+            data["stop"] = s
+
+        if self.client is not None:
+            resp = self.client.query_route(self.route, query_body=data)
+        else:
+            raise ValueError("Javelin client is not initialized.")
+
+        resp_dict = resp.dict()
+
+        try:
+            return resp_dict["llm_response"]["choices"][0]["text"]
+        except KeyError:
+            return ""
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call async the Javelin AI Gateway API."""
+        data: Dict[str, Any] = {
+            "prompt": prompt,
+            **(self.params.dict() if self.params else {}),
+        }
+        if s := (stop or (self.params.stop if self.params else None)):
+            data["stop"] = s
+
+        if self.client is not None:
+            resp = await self.client.aquery_route(self.route, query_body=data)
+        else:
+            raise ValueError("Javelin client is not initialized.")
+
+        resp_dict = resp.dict()
+
+        try:
+            return resp_dict["llm_response"]["choices"][0]["text"]
+        except KeyError:
+            return ""
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "javelin-ai-gateway"
diff --git a/llm/Lib/site-packages/langchain_community/llms/koboldai.py b/llm/Lib/site-packages/langchain_community/llms/koboldai.py
new file mode 100644
index 0000000000000000000000000000000000000000..ad1217553860556b3e9939d546de9f10393d57f7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/koboldai.py
@@ -0,0 +1,197 @@
+import logging
+from typing import Any, Dict, List, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+
+logger = logging.getLogger(__name__)
+
+
+def clean_url(url: str) -> str:
+    """Remove trailing slash and /api from url if present."""
+    if url.endswith("/api"):
+        return url[:-4]
+    elif url.endswith("/"):
+        return url[:-1]
+    else:
+        return url
+
+
+class KoboldApiLLM(LLM):
+    """Kobold API language model.
+
+    It includes several fields that can be used to control the text generation process.
+
+    To use this class, instantiate it with the required parameters and call it with a
+    prompt to generate text. For example:
+
+        kobold = KoboldApiLLM(endpoint="http://localhost:5000")
+        result = kobold("Write a story about a dragon.")
+
+    This will send a POST request to the Kobold API with the provided prompt and
+    generate text.
+    """
+
+    endpoint: str
+    """The API endpoint to use for generating text."""
+
+    use_story: Optional[bool] = False
+    """ Whether or not to use the story from the KoboldAI GUI when generating text. """
+
+    use_authors_note: Optional[bool] = False
+    """Whether to use the author's note from the KoboldAI GUI when generating text.
+    
+    This has no effect unless use_story is also enabled.
+    """
+
+    use_world_info: Optional[bool] = False
+    """Whether to use the world info from the KoboldAI GUI when generating text."""
+
+    use_memory: Optional[bool] = False
+    """Whether to use the memory from the KoboldAI GUI when generating text."""
+
+    max_context_length: Optional[int] = 1600
+    """Maximum number of tokens to send to the model.
+    
+    minimum: 1
+    """
+
+    max_length: Optional[int] = 80
+    """Number of tokens to generate.
+    
+    maximum: 512
+    minimum: 1
+    """
+
+    rep_pen: Optional[float] = 1.12
+    """Base repetition penalty value.
+    
+    minimum: 1
+    """
+
+    rep_pen_range: Optional[int] = 1024
+    """Repetition penalty range.
+    
+    minimum: 0
+    """
+
+    rep_pen_slope: Optional[float] = 0.9
+    """Repetition penalty slope.
+    
+    minimum: 0
+    """
+
+    temperature: Optional[float] = 0.6
+    """Temperature value.
+    
+    exclusiveMinimum: 0
+    """
+
+    tfs: Optional[float] = 0.9
+    """Tail free sampling value.
+    
+    maximum: 1
+    minimum: 0
+    """
+
+    top_a: Optional[float] = 0.9
+    """Top-a sampling value.
+    
+    minimum: 0
+    """
+
+    top_p: Optional[float] = 0.95
+    """Top-p sampling value.
+    
+    maximum: 1
+    minimum: 0
+    """
+
+    top_k: Optional[int] = 0
+    """Top-k sampling value.
+    
+    minimum: 0
+    """
+
+    typical: Optional[float] = 0.5
+    """Typical sampling value.
+    
+    maximum: 1
+    minimum: 0
+    """
+
+    @property
+    def _llm_type(self) -> str:
+        return "koboldai"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call the API and return the output.
+
+        Args:
+            prompt: The prompt to use for generation.
+            stop: A list of strings to stop generation when encountered.
+
+        Returns:
+            The generated text.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.llms import KoboldApiLLM
+
+                llm = KoboldApiLLM(endpoint="http://localhost:5000")
+                llm("Write a story about dragons.")
+        """
+        data: Dict[str, Any] = {
+            "prompt": prompt,
+            "use_story": self.use_story,
+            "use_authors_note": self.use_authors_note,
+            "use_world_info": self.use_world_info,
+            "use_memory": self.use_memory,
+            "max_context_length": self.max_context_length,
+            "max_length": self.max_length,
+            "rep_pen": self.rep_pen,
+            "rep_pen_range": self.rep_pen_range,
+            "rep_pen_slope": self.rep_pen_slope,
+            "temperature": self.temperature,
+            "tfs": self.tfs,
+            "top_a": self.top_a,
+            "top_p": self.top_p,
+            "top_k": self.top_k,
+            "typical": self.typical,
+        }
+
+        if stop is not None:
+            data["stop_sequence"] = stop
+
+        response = requests.post(
+            f"{clean_url(self.endpoint)}/api/v1/generate", json=data
+        )
+
+        response.raise_for_status()
+        json_response = response.json()
+
+        if (
+            "results" in json_response
+            and len(json_response["results"]) > 0
+            and "text" in json_response["results"][0]
+        ):
+            text = json_response["results"][0]["text"].strip()
+
+            if stop is not None:
+                for sequence in stop:
+                    if text.endswith(sequence):
+                        text = text[: -len(sequence)].rstrip()
+
+            return text
+        else:
+            raise ValueError(
+                f"Unexpected response format from Kobold API:  {json_response}"
+            )
diff --git a/llm/Lib/site-packages/langchain_community/llms/konko.py b/llm/Lib/site-packages/langchain_community/llms/konko.py
new file mode 100644
index 0000000000000000000000000000000000000000..97ac3fdc8a48d72846bb5c53d6093e2f34b559f4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/konko.py
@@ -0,0 +1,200 @@
+"""Wrapper around Konko AI's Completion API."""
+import logging
+import warnings
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, SecretStr, root_validator
+
+from langchain_community.utils.openai import is_openai_v1
+
+logger = logging.getLogger(__name__)
+
+
+class Konko(LLM):
+    """Konko AI models.
+
+    To use, you'll need an API key. This can be passed in as init param
+    ``konko_api_key`` or set as environment variable ``KONKO_API_KEY``.
+
+    Konko AI API reference: https://docs.konko.ai/reference/
+    """
+
+    base_url: str = "https://api.konko.ai/v1/completions"
+    """Base inference API URL."""
+    konko_api_key: SecretStr
+    """Konko AI API key."""
+    model: str
+    """Model name. Available models listed here: 
+       https://docs.konko.ai/reference/get_models
+    """
+    temperature: Optional[float] = None
+    """Model temperature."""
+    top_p: Optional[float] = None
+    """Used to dynamically adjust the number of choices for each predicted token based 
+        on the cumulative probabilities. A value of 1 will always yield the same 
+        output. A temperature less than 1 favors more correctness and is appropriate 
+        for question answering or summarization. A value greater than 1 introduces more 
+        randomness in the output.
+    """
+    top_k: Optional[int] = None
+    """Used to limit the number of choices for the next predicted word or token. It 
+        specifies the maximum number of tokens to consider at each step, based on their 
+        probability of occurrence. This technique helps to speed up the generation 
+        process and can improve the quality of the generated text by focusing on the 
+        most likely options.
+    """
+    max_tokens: Optional[int] = None
+    """The maximum number of tokens to generate."""
+    repetition_penalty: Optional[float] = None
+    """A number that controls the diversity of generated text by reducing the 
+        likelihood of repeated sequences. Higher values decrease repetition.
+    """
+    logprobs: Optional[int] = None
+    """An integer that specifies how many top token log probabilities are included in 
+        the response for each token generation step.
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Validate that python package exists in environment."""
+        try:
+            import konko
+
+        except ImportError:
+            raise ValueError(
+                "Could not import konko python package. "
+                "Please install it with `pip install konko`."
+            )
+        if not hasattr(konko, "_is_legacy_openai"):
+            warnings.warn(
+                "You are using an older version of the 'konko' package. "
+                "Please consider upgrading to access new features"
+                "including the completion endpoint."
+            )
+        return values
+
+    def construct_payload(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        stop_to_use = stop[0] if stop and len(stop) == 1 else stop
+        payload: Dict[str, Any] = {
+            **self.default_params,
+            "prompt": prompt,
+            "stop": stop_to_use,
+            **kwargs,
+        }
+        return {k: v for k, v in payload.items() if v is not None}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of model."""
+        return "konko"
+
+    @staticmethod
+    def get_user_agent() -> str:
+        from langchain_community import __version__
+
+        return f"langchain/{__version__}"
+
+    @property
+    def default_params(self) -> Dict[str, Any]:
+        return {
+            "model": self.model,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            "top_k": self.top_k,
+            "max_tokens": self.max_tokens,
+            "repetition_penalty": self.repetition_penalty,
+        }
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Konko's text generation endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+
+        Returns:
+            The string generated by the model..
+        """
+        import konko
+
+        payload = self.construct_payload(prompt, stop, **kwargs)
+
+        try:
+            if is_openai_v1():
+                response = konko.completions.create(**payload)
+            else:
+                response = konko.Completion.create(**payload)
+
+        except AttributeError:
+            raise ValueError(
+                "`konko` has no `Completion` attribute, this is likely "
+                "due to an old version of the konko package. Try upgrading it "
+                "with `pip install --upgrade konko`."
+            )
+
+        if is_openai_v1():
+            output = response.choices[0].text
+        else:
+            output = response["choices"][0]["text"]
+
+        return output
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Asynchronously call out to Konko's text generation endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+
+        Returns:
+            The string generated by the model.
+        """
+        import konko
+
+        payload = self.construct_payload(prompt, stop, **kwargs)
+
+        try:
+            if is_openai_v1():
+                client = konko.AsyncKonko()
+                response = await client.completions.create(**payload)
+            else:
+                response = await konko.Completion.acreate(**payload)
+
+        except AttributeError:
+            raise ValueError(
+                "`konko` has no `Completion` attribute, this is likely "
+                "due to an old version of the konko package. Try upgrading it "
+                "with `pip install --upgrade konko`."
+            )
+
+        if is_openai_v1():
+            output = response.choices[0].text
+        else:
+            output = response["choices"][0]["text"]
+
+        return output
diff --git a/llm/Lib/site-packages/langchain_community/llms/layerup_security.py b/llm/Lib/site-packages/langchain_community/llms/layerup_security.py
new file mode 100644
index 0000000000000000000000000000000000000000..2a383cd2eeb1f7023ccee1c6d55f263b9b33ace2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/layerup_security.py
@@ -0,0 +1,106 @@
+import logging
+from typing import Any, Callable, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import root_validator
+
+logger = logging.getLogger(__name__)
+
+
+def default_guardrail_violation_handler(violation: dict) -> str:
+    """Default guardrail violation handler.
+
+    Args:
+        violation (dict): The violation dictionary.
+
+    Returns:
+        str: The canned response.
+    """
+    if violation.get("canned_response"):
+        return violation["canned_response"]
+    guardrail_name = (
+        f"Guardrail {violation.get('offending_guardrail')}"
+        if violation.get("offending_guardrail")
+        else "A guardrail"
+    )
+    raise ValueError(
+        f"{guardrail_name} was violated without a proper guardrail violation handler."
+    )
+
+
+class LayerupSecurity(LLM):
+    """Layerup Security LLM service."""
+
+    llm: LLM
+    layerup_api_key: str
+    layerup_api_base_url: str = "https://api.uselayerup.com/v1"
+    prompt_guardrails: Optional[List[str]] = []
+    response_guardrails: Optional[List[str]] = []
+    mask: bool = False
+    metadata: Optional[Dict[str, Any]] = {}
+    handle_prompt_guardrail_violation: Callable[
+        [dict], str
+    ] = default_guardrail_violation_handler
+    handle_response_guardrail_violation: Callable[
+        [dict], str
+    ] = default_guardrail_violation_handler
+    client: Any  #: :meta private:
+
+    @root_validator(pre=True)
+    def validate_layerup_sdk(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        try:
+            from layerup_security import LayerupSecurity as LayerupSecuritySDK
+
+            values["client"] = LayerupSecuritySDK(
+                api_key=values["layerup_api_key"],
+                base_url=values["layerup_api_base_url"],
+            )
+        except ImportError:
+            raise ImportError(
+                "Could not import LayerupSecurity SDK. "
+                "Please install it with `pip install LayerupSecurity`."
+            )
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        return "layerup_security"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        messages = [{"role": "user", "content": prompt}]
+        unmask_response = None
+
+        if self.mask:
+            messages, unmask_response = self.client.mask_prompt(messages, self.metadata)
+
+        if self.prompt_guardrails:
+            security_response = self.client.execute_guardrails(
+                self.prompt_guardrails, messages, self.metadata
+            )
+            if not security_response["all_safe"]:
+                return self.handle_prompt_guardrail_violation(security_response)
+
+        result = self.llm._call(
+            messages[0]["content"], run_manager=run_manager, **kwargs
+        )
+
+        if self.mask and unmask_response:
+            result = unmask_response(result)
+
+        messages.append({"role": "assistant", "content": result})
+
+        if self.response_guardrails:
+            security_response = self.client.execute_guardrails(
+                self.response_guardrails, messages, self.metadata
+            )
+            if not security_response["all_safe"]:
+                return self.handle_response_guardrail_violation(security_response)
+
+        return result
diff --git a/llm/Lib/site-packages/langchain_community/llms/llamacpp.py b/llm/Lib/site-packages/langchain_community/llms/llamacpp.py
new file mode 100644
index 0000000000000000000000000000000000000000..b06e6d8cf763cc48523d2aa80e6b233e18e7defc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/llamacpp.py
@@ -0,0 +1,355 @@
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+from typing import Any, Dict, Iterator, List, Optional, Union
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import get_pydantic_field_names
+from langchain_core.utils.utils import build_extra_kwargs
+
+logger = logging.getLogger(__name__)
+
+
+class LlamaCpp(LLM):
+    """llama.cpp model.
+
+    To use, you should have the llama-cpp-python library installed, and provide the
+    path to the Llama model as a named parameter to the constructor.
+    Check out: https://github.com/abetlen/llama-cpp-python
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import LlamaCpp
+            llm = LlamaCpp(model_path="/path/to/llama/model")
+    """
+
+    client: Any  #: :meta private:
+    model_path: str
+    """The path to the Llama model file."""
+
+    lora_base: Optional[str] = None
+    """The path to the Llama LoRA base model."""
+
+    lora_path: Optional[str] = None
+    """The path to the Llama LoRA. If None, no LoRa is loaded."""
+
+    n_ctx: int = Field(512, alias="n_ctx")
+    """Token context window."""
+
+    n_parts: int = Field(-1, alias="n_parts")
+    """Number of parts to split the model into.
+    If -1, the number of parts is automatically determined."""
+
+    seed: int = Field(-1, alias="seed")
+    """Seed. If -1, a random seed is used."""
+
+    f16_kv: bool = Field(True, alias="f16_kv")
+    """Use half-precision for key/value cache."""
+
+    logits_all: bool = Field(False, alias="logits_all")
+    """Return logits for all tokens, not just the last token."""
+
+    vocab_only: bool = Field(False, alias="vocab_only")
+    """Only load the vocabulary, no weights."""
+
+    use_mlock: bool = Field(False, alias="use_mlock")
+    """Force system to keep model in RAM."""
+
+    n_threads: Optional[int] = Field(None, alias="n_threads")
+    """Number of threads to use.
+    If None, the number of threads is automatically determined."""
+
+    n_batch: Optional[int] = Field(8, alias="n_batch")
+    """Number of tokens to process in parallel.
+    Should be a number between 1 and n_ctx."""
+
+    n_gpu_layers: Optional[int] = Field(None, alias="n_gpu_layers")
+    """Number of layers to be loaded into gpu memory. Default None."""
+
+    suffix: Optional[str] = Field(None)
+    """A suffix to append to the generated text. If None, no suffix is appended."""
+
+    max_tokens: Optional[int] = 256
+    """The maximum number of tokens to generate."""
+
+    temperature: Optional[float] = 0.8
+    """The temperature to use for sampling."""
+
+    top_p: Optional[float] = 0.95
+    """The top-p value to use for sampling."""
+
+    logprobs: Optional[int] = Field(None)
+    """The number of logprobs to return. If None, no logprobs are returned."""
+
+    echo: Optional[bool] = False
+    """Whether to echo the prompt."""
+
+    stop: Optional[List[str]] = []
+    """A list of strings to stop generation when encountered."""
+
+    repeat_penalty: Optional[float] = 1.1
+    """The penalty to apply to repeated tokens."""
+
+    top_k: Optional[int] = 40
+    """The top-k value to use for sampling."""
+
+    last_n_tokens_size: Optional[int] = 64
+    """The number of tokens to look back when applying the repeat_penalty."""
+
+    use_mmap: Optional[bool] = True
+    """Whether to keep the model loaded in RAM"""
+
+    rope_freq_scale: float = 1.0
+    """Scale factor for rope sampling."""
+
+    rope_freq_base: float = 10000.0
+    """Base frequency for rope sampling."""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Any additional parameters to pass to llama_cpp.Llama."""
+
+    streaming: bool = True
+    """Whether to stream the results, token by token."""
+
+    grammar_path: Optional[Union[str, Path]] = None
+    """
+    grammar_path: Path to the .gbnf file that defines formal grammars
+    for constraining model outputs. For instance, the grammar can be used
+    to force the model to generate valid JSON or to speak exclusively in emojis. At most
+    one of grammar_path and grammar should be passed in.
+    """
+    grammar: Optional[Union[str, Any]] = None
+    """
+    grammar: formal grammar for constraining model outputs. For instance, the grammar 
+    can be used to force the model to generate valid JSON or to speak exclusively in 
+    emojis. At most one of grammar_path and grammar should be passed in.
+    """
+
+    verbose: bool = True
+    """Print verbose output to stderr."""
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that llama-cpp-python library is installed."""
+        try:
+            from llama_cpp import Llama, LlamaGrammar
+        except ImportError:
+            raise ImportError(
+                "Could not import llama-cpp-python library. "
+                "Please install the llama-cpp-python library to "
+                "use this embedding model: pip install llama-cpp-python"
+            )
+
+        model_path = values["model_path"]
+        model_param_names = [
+            "rope_freq_scale",
+            "rope_freq_base",
+            "lora_path",
+            "lora_base",
+            "n_ctx",
+            "n_parts",
+            "seed",
+            "f16_kv",
+            "logits_all",
+            "vocab_only",
+            "use_mlock",
+            "n_threads",
+            "n_batch",
+            "use_mmap",
+            "last_n_tokens_size",
+            "verbose",
+        ]
+        model_params = {k: values[k] for k in model_param_names}
+        # For backwards compatibility, only include if non-null.
+        if values["n_gpu_layers"] is not None:
+            model_params["n_gpu_layers"] = values["n_gpu_layers"]
+
+        model_params.update(values["model_kwargs"])
+
+        try:
+            values["client"] = Llama(model_path, **model_params)
+        except Exception as e:
+            raise ValueError(
+                f"Could not load Llama model from path: {model_path}. "
+                f"Received error {e}"
+            )
+
+        if values["grammar"] and values["grammar_path"]:
+            grammar = values["grammar"]
+            grammar_path = values["grammar_path"]
+            raise ValueError(
+                "Can only pass in one of grammar and grammar_path. Received "
+                f"{grammar=} and {grammar_path=}."
+            )
+        elif isinstance(values["grammar"], str):
+            values["grammar"] = LlamaGrammar.from_string(values["grammar"])
+        elif values["grammar_path"]:
+            values["grammar"] = LlamaGrammar.from_file(values["grammar_path"])
+        else:
+            pass
+        return values
+
+    @root_validator(pre=True)
+    def build_model_kwargs(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        values["model_kwargs"] = build_extra_kwargs(
+            extra, values, all_required_field_names
+        )
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling llama_cpp."""
+        params = {
+            "suffix": self.suffix,
+            "max_tokens": self.max_tokens,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            "logprobs": self.logprobs,
+            "echo": self.echo,
+            "stop_sequences": self.stop,  # key here is convention among LLM classes
+            "repeat_penalty": self.repeat_penalty,
+            "top_k": self.top_k,
+        }
+        if self.grammar:
+            params["grammar"] = self.grammar
+        return params
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model_path": self.model_path}, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "llamacpp"
+
+    def _get_parameters(self, stop: Optional[List[str]] = None) -> Dict[str, Any]:
+        """
+        Performs sanity check, preparing parameters in format needed by llama_cpp.
+
+        Args:
+            stop (Optional[List[str]]): List of stop sequences for llama_cpp.
+
+        Returns:
+            Dictionary containing the combined parameters.
+        """
+
+        # Raise error if stop sequences are in both input and default params
+        if self.stop and stop is not None:
+            raise ValueError("`stop` found in both the input and default params.")
+
+        params = self._default_params
+
+        # llama_cpp expects the "stop" key not this, so we remove it:
+        params.pop("stop_sequences")
+
+        # then sets it as configured, or default to an empty list:
+        params["stop"] = self.stop or stop or []
+
+        return params
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call the Llama model and return the output.
+
+        Args:
+            prompt: The prompt to use for generation.
+            stop: A list of strings to stop generation when encountered.
+
+        Returns:
+            The generated text.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.llms import LlamaCpp
+                llm = LlamaCpp(model_path="/path/to/local/llama/model.bin")
+                llm("This is a prompt.")
+        """
+        if self.streaming:
+            # If streaming is enabled, we use the stream
+            # method that yields as they are generated
+            # and return the combined strings from the first choices's text:
+            combined_text_output = ""
+            for chunk in self._stream(
+                prompt=prompt,
+                stop=stop,
+                run_manager=run_manager,
+                **kwargs,
+            ):
+                combined_text_output += chunk.text
+            return combined_text_output
+        else:
+            params = self._get_parameters(stop)
+            params = {**params, **kwargs}
+            result = self.client(prompt=prompt, **params)
+            return result["choices"][0]["text"]
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        """Yields results objects as they are generated in real time.
+
+        It also calls the callback manager's on_llm_new_token event with
+        similar parameters to the OpenAI LLM class method of the same name.
+
+        Args:
+            prompt: The prompts to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            A generator representing the stream of tokens being generated.
+
+        Yields:
+            A dictionary like objects containing a string token and metadata.
+            See llama-cpp-python docs and below for more.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.llms import LlamaCpp
+                llm = LlamaCpp(
+                    model_path="/path/to/local/model.bin",
+                    temperature = 0.5
+                )
+                for chunk in llm.stream("Ask 'Hi, how are you?' like a pirate:'",
+                        stop=["'","\n"]):
+                    result = chunk["choices"][0]
+                    print(result["text"], end='', flush=True)  # noqa: T201
+
+        """
+        params = {**self._get_parameters(stop), **kwargs}
+        result = self.client(prompt=prompt, stream=True, **params)
+        for part in result:
+            logprobs = part["choices"][0].get("logprobs", None)
+            chunk = GenerationChunk(
+                text=part["choices"][0]["text"],
+                generation_info={"logprobs": logprobs},
+            )
+            if run_manager:
+                run_manager.on_llm_new_token(
+                    token=chunk.text, verbose=self.verbose, log_probs=logprobs
+                )
+            yield chunk
+
+    def get_num_tokens(self, text: str) -> int:
+        tokenized_text = self.client.tokenize(text.encode("utf-8"))
+        return len(tokenized_text)
diff --git a/llm/Lib/site-packages/langchain_community/llms/llamafile.py b/llm/Lib/site-packages/langchain_community/llms/llamafile.py
new file mode 100644
index 0000000000000000000000000000000000000000..1aff521ee3300fe0c089538f1c11e079599fdf4d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/llamafile.py
@@ -0,0 +1,319 @@
+from __future__ import annotations
+
+import json
+from io import StringIO
+from typing import Any, Dict, Iterator, List, Optional
+
+import requests
+from langchain_core.callbacks.manager import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import Extra
+from langchain_core.utils import get_pydantic_field_names
+
+
+class Llamafile(LLM):
+    """Llamafile lets you distribute and run large language models with a
+    single file.
+
+    To get started, see: https://github.com/Mozilla-Ocho/llamafile
+
+    To use this class, you will need to first:
+
+    1. Download a llamafile.
+    2. Make the downloaded file executable: `chmod +x path/to/model.llamafile`
+    3. Start the llamafile in server mode:
+
+        `./path/to/model.llamafile --server --nobrowser`
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Llamafile
+            llm = Llamafile()
+            llm.invoke("Tell me a joke.")
+    """
+
+    base_url: str = "http://localhost:8080"
+    """Base url where the llamafile server is listening."""
+
+    request_timeout: Optional[int] = None
+    """Timeout for server requests"""
+
+    streaming: bool = False
+    """Allows receiving each predicted token in real-time instead of
+    waiting for the completion to finish. To enable this, set to true."""
+
+    # Generation options
+
+    seed: int = -1
+    """Random Number Generator (RNG) seed. A random seed is used if this is 
+    less than zero. Default: -1"""
+
+    temperature: float = 0.8
+    """Temperature. Default: 0.8"""
+
+    top_k: int = 40
+    """Limit the next token selection to the K most probable tokens. 
+    Default: 40."""
+
+    top_p: float = 0.95
+    """Limit the next token selection to a subset of tokens with a cumulative 
+    probability above a threshold P. Default: 0.95."""
+
+    min_p: float = 0.05
+    """The minimum probability for a token to be considered, relative to 
+    the probability of the most likely token. Default: 0.05."""
+
+    n_predict: int = -1
+    """Set the maximum number of tokens to predict when generating text. 
+    Note: May exceed the set limit slightly if the last token is a partial 
+    multibyte character. When 0, no tokens will be generated but the prompt 
+    is evaluated into the cache. Default: -1 = infinity."""
+
+    n_keep: int = 0
+    """Specify the number of tokens from the prompt to retain when the 
+    context size is exceeded and tokens need to be discarded. By default, 
+    this value is set to 0 (meaning no tokens are kept). Use -1 to retain all 
+    tokens from the prompt."""
+
+    tfs_z: float = 1.0
+    """Enable tail free sampling with parameter z. Default: 1.0 = disabled."""
+
+    typical_p: float = 1.0
+    """Enable locally typical sampling with parameter p. 
+    Default: 1.0 = disabled."""
+
+    repeat_penalty: float = 1.1
+    """Control the repetition of token sequences in the generated text. 
+    Default: 1.1"""
+
+    repeat_last_n: int = 64
+    """Last n tokens to consider for penalizing repetition. Default: 64, 
+    0 = disabled, -1 = ctx-size."""
+
+    penalize_nl: bool = True
+    """Penalize newline tokens when applying the repeat penalty. 
+    Default: true."""
+
+    presence_penalty: float = 0.0
+    """Repeat alpha presence penalty. Default: 0.0 = disabled."""
+
+    frequency_penalty: float = 0.0
+    """Repeat alpha frequency penalty. Default: 0.0 = disabled"""
+
+    mirostat: int = 0
+    """Enable Mirostat sampling, controlling perplexity during text 
+    generation. 0 = disabled, 1 = Mirostat, 2 = Mirostat 2.0. 
+    Default: disabled."""
+
+    mirostat_tau: float = 5.0
+    """Set the Mirostat target entropy, parameter tau. Default: 5.0."""
+
+    mirostat_eta: float = 0.1
+    """Set the Mirostat learning rate, parameter eta. Default: 0.1."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @property
+    def _llm_type(self) -> str:
+        return "llamafile"
+
+    @property
+    def _param_fieldnames(self) -> List[str]:
+        # Return the list of fieldnames that will be passed as configurable
+        # generation options to the llamafile server. Exclude 'builtin' fields
+        # from the BaseLLM class like 'metadata' as well as fields that should
+        # not be passed in requests (base_url, request_timeout).
+        ignore_keys = [
+            "base_url",
+            "cache",
+            "callback_manager",
+            "callbacks",
+            "metadata",
+            "name",
+            "request_timeout",
+            "streaming",
+            "tags",
+            "verbose",
+        ]
+        attrs = [
+            k for k in get_pydantic_field_names(self.__class__) if k not in ignore_keys
+        ]
+        return attrs
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        params = {}
+        for fieldname in self._param_fieldnames:
+            params[fieldname] = getattr(self, fieldname)
+        return params
+
+    def _get_parameters(
+        self, stop: Optional[List[str]] = None, **kwargs: Any
+    ) -> Dict[str, Any]:
+        params = self._default_params
+
+        # Only update keys that are already present in the default config.
+        # This way, we don't accidentally post unknown/unhandled key/values
+        # in the request to the llamafile server
+        for k, v in kwargs.items():
+            if k in params:
+                params[k] = v
+
+        if stop is not None and len(stop) > 0:
+            params["stop"] = stop
+
+        if self.streaming:
+            params["stream"] = True
+
+        return params
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Request prompt completion from the llamafile server and return the
+        output.
+
+        Args:
+            prompt: The prompt to use for generation.
+            stop: A list of strings to stop generation when encountered.
+            run_manager:
+            **kwargs: Any additional options to pass as part of the
+            generation request.
+
+        Returns:
+            The string generated by the model.
+
+        """
+
+        if self.streaming:
+            with StringIO() as buff:
+                for chunk in self._stream(
+                    prompt, stop=stop, run_manager=run_manager, **kwargs
+                ):
+                    buff.write(chunk.text)
+
+                text = buff.getvalue()
+
+            return text
+
+        else:
+            params = self._get_parameters(stop=stop, **kwargs)
+            payload = {"prompt": prompt, **params}
+
+            try:
+                response = requests.post(
+                    url=f"{self.base_url}/completion",
+                    headers={
+                        "Content-Type": "application/json",
+                    },
+                    json=payload,
+                    stream=False,
+                    timeout=self.request_timeout,
+                )
+            except requests.exceptions.ConnectionError:
+                raise requests.exceptions.ConnectionError(
+                    f"Could not connect to Llamafile server. Please make sure "
+                    f"that a server is running at {self.base_url}."
+                )
+
+            response.raise_for_status()
+            response.encoding = "utf-8"
+
+            text = response.json()["content"]
+
+            return text
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        """Yields results objects as they are generated in real time.
+
+        It also calls the callback manager's on_llm_new_token event with
+        similar parameters to the OpenAI LLM class method of the same name.
+
+        Args:
+            prompt: The prompts to pass into the model.
+            stop: Optional list of stop words to use when generating.
+            run_manager:
+            **kwargs: Any additional options to pass as part of the
+            generation request.
+
+        Returns:
+            A generator representing the stream of tokens being generated.
+
+        Yields:
+            Dictionary-like objects each containing a token
+
+        Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Llamafile
+            llm = Llamafile(
+                temperature = 0.0
+            )
+            for chunk in llm.stream("Ask 'Hi, how are you?' like a pirate:'",
+                    stop=["'","\n"]):
+                result = chunk["choices"][0]
+                print(result["text"], end='', flush=True)
+
+        """
+        params = self._get_parameters(stop=stop, **kwargs)
+        if "stream" not in params:
+            params["stream"] = True
+
+        payload = {"prompt": prompt, **params}
+
+        try:
+            response = requests.post(
+                url=f"{self.base_url}/completion",
+                headers={
+                    "Content-Type": "application/json",
+                },
+                json=payload,
+                stream=True,
+                timeout=self.request_timeout,
+            )
+        except requests.exceptions.ConnectionError:
+            raise requests.exceptions.ConnectionError(
+                f"Could not connect to Llamafile server. Please make sure "
+                f"that a server is running at {self.base_url}."
+            )
+
+        response.encoding = "utf8"
+
+        for raw_chunk in response.iter_lines(decode_unicode=True):
+            content = self._get_chunk_content(raw_chunk)
+            chunk = GenerationChunk(text=content)
+
+            if run_manager:
+                run_manager.on_llm_new_token(token=chunk.text)
+            yield chunk
+
+    def _get_chunk_content(self, chunk: str) -> str:
+        """When streaming is turned on, llamafile server returns lines like:
+
+        'data: {"content":" They","multimodal":true,"slot_id":0,"stop":false}'
+
+        Here, we convert this to a dict and return the value of the 'content'
+        field
+        """
+
+        if chunk.startswith("data:"):
+            cleaned = chunk.lstrip("data: ")
+            data = json.loads(cleaned)
+            return data["content"]
+        else:
+            return chunk
diff --git a/llm/Lib/site-packages/langchain_community/llms/loading.py b/llm/Lib/site-packages/langchain_community/llms/loading.py
new file mode 100644
index 0000000000000000000000000000000000000000..05025b8e7a005696f475c13d1ef876ef8152d80b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/loading.py
@@ -0,0 +1,53 @@
+"""Base interface for loading large language model APIs."""
+import json
+from pathlib import Path
+from typing import Any, Union
+
+import yaml
+from langchain_core.language_models.llms import BaseLLM
+
+from langchain_community.llms import get_type_to_cls_dict
+
+_ALLOW_DANGEROUS_DESERIALIZATION_ARG = "allow_dangerous_deserialization"
+
+
+def load_llm_from_config(config: dict, **kwargs: Any) -> BaseLLM:
+    """Load LLM from Config Dict."""
+    if "_type" not in config:
+        raise ValueError("Must specify an LLM Type in config")
+    config_type = config.pop("_type")
+
+    type_to_cls_dict = get_type_to_cls_dict()
+
+    if config_type not in type_to_cls_dict:
+        raise ValueError(f"Loading {config_type} LLM not supported")
+
+    llm_cls = type_to_cls_dict[config_type]()
+
+    load_kwargs = {}
+    if _ALLOW_DANGEROUS_DESERIALIZATION_ARG in llm_cls.__fields__:
+        load_kwargs[_ALLOW_DANGEROUS_DESERIALIZATION_ARG] = kwargs.get(
+            _ALLOW_DANGEROUS_DESERIALIZATION_ARG, False
+        )
+
+    return llm_cls(**config, **load_kwargs)
+
+
+def load_llm(file: Union[str, Path], **kwargs: Any) -> BaseLLM:
+    """Load LLM from a file."""
+    # Convert file to Path object.
+    if isinstance(file, str):
+        file_path = Path(file)
+    else:
+        file_path = file
+    # Load from either json or yaml.
+    if file_path.suffix == ".json":
+        with open(file_path) as f:
+            config = json.load(f)
+    elif file_path.suffix.endswith((".yaml", ".yml")):
+        with open(file_path, "r") as f:
+            config = yaml.safe_load(f)
+    else:
+        raise ValueError("File type must be json or yaml")
+    # Load the LLM from the config now.
+    return load_llm_from_config(config, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/llms/manifest.py b/llm/Lib/site-packages/langchain_community/llms/manifest.py
new file mode 100644
index 0000000000000000000000000000000000000000..2852ab1d7c745a193a9d23c99b6f6c1a47563045
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/manifest.py
@@ -0,0 +1,63 @@
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, root_validator
+
+
+class ManifestWrapper(LLM):
+    """HazyResearch's Manifest library."""
+
+    client: Any  #: :meta private:
+    llm_kwargs: Optional[Dict] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that python package exists in environment."""
+        try:
+            from manifest import Manifest
+
+            if not isinstance(values["client"], Manifest):
+                raise ValueError
+        except ImportError:
+            raise ImportError(
+                "Could not import manifest python package. "
+                "Please install it with `pip install manifest-ml`."
+            )
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        kwargs = self.llm_kwargs or {}
+        return {
+            **self.client.client_pool.get_current_client().get_model_params(),
+            **kwargs,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "manifest"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to LLM through Manifest."""
+        if stop is not None and len(stop) != 1:
+            raise NotImplementedError(
+                f"Manifest currently only supports a single stop token, got {stop}"
+            )
+        params = self.llm_kwargs or {}
+        params = {**params, **kwargs}
+        if stop is not None:
+            params["stop_token"] = stop
+        return self.client.run(prompt, **params)
diff --git a/llm/Lib/site-packages/langchain_community/llms/minimax.py b/llm/Lib/site-packages/langchain_community/llms/minimax.py
new file mode 100644
index 0000000000000000000000000000000000000000..a2375b7445f261937cc83cc0e94858ff55ea62c2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/minimax.py
@@ -0,0 +1,156 @@
+"""Wrapper around Minimax APIs."""
+from __future__ import annotations
+
+import logging
+from typing import (
+    Any,
+    Dict,
+    List,
+    Optional,
+)
+
+import requests
+from langchain_core.callbacks import (
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import BaseModel, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class _MinimaxEndpointClient(BaseModel):
+    """An API client that talks to a Minimax llm endpoint."""
+
+    host: str
+    group_id: str
+    api_key: SecretStr
+    api_url: str
+
+    @root_validator(pre=True, allow_reuse=True)
+    def set_api_url(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        if "api_url" not in values:
+            host = values["host"]
+            group_id = values["group_id"]
+            api_url = f"{host}/v1/text/chatcompletion?GroupId={group_id}"
+            values["api_url"] = api_url
+        return values
+
+    def post(self, request: Any) -> Any:
+        headers = {"Authorization": f"Bearer {self.api_key.get_secret_value()}"}
+        response = requests.post(self.api_url, headers=headers, json=request)
+        # TODO: error handling and automatic retries
+        if not response.ok:
+            raise ValueError(f"HTTP {response.status_code} error: {response.text}")
+        if response.json()["base_resp"]["status_code"] > 0:
+            raise ValueError(
+                f"API {response.json()['base_resp']['status_code']}"
+                f" error: {response.json()['base_resp']['status_msg']}"
+            )
+        return response.json()["reply"]
+
+
+class MinimaxCommon(BaseModel):
+    """Common parameters for Minimax large language models."""
+
+    _client: _MinimaxEndpointClient
+    model: str = "abab5.5-chat"
+    """Model name to use."""
+    max_tokens: int = 256
+    """Denotes the number of tokens to predict per generation."""
+    temperature: float = 0.7
+    """A non-negative float that tunes the degree of randomness in generation."""
+    top_p: float = 0.95
+    """Total probability mass of tokens to consider at each step."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not explicitly specified."""
+    minimax_api_host: Optional[str] = None
+    minimax_group_id: Optional[str] = None
+    minimax_api_key: Optional[SecretStr] = None
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["minimax_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "minimax_api_key", "MINIMAX_API_KEY")
+        )
+        values["minimax_group_id"] = get_from_dict_or_env(
+            values, "minimax_group_id", "MINIMAX_GROUP_ID"
+        )
+        # Get custom api url from environment.
+        values["minimax_api_host"] = get_from_dict_or_env(
+            values,
+            "minimax_api_host",
+            "MINIMAX_API_HOST",
+            default="https://api.minimax.chat",
+        )
+        values["_client"] = _MinimaxEndpointClient(
+            host=values["minimax_api_host"],
+            api_key=values["minimax_api_key"],
+            group_id=values["minimax_group_id"],
+        )
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling OpenAI API."""
+        return {
+            "model": self.model,
+            "tokens_to_generate": self.max_tokens,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            **self.model_kwargs,
+        }
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model": self.model}, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "minimax"
+
+
+class Minimax(MinimaxCommon, LLM):
+    """Wrapper around Minimax large language models.
+    To use, you should have the environment variable
+    ``MINIMAX_API_KEY`` and ``MINIMAX_GROUP_ID`` set with your API key,
+    or pass them as a named parameter to the constructor.
+    Example:
+     . code-block:: python
+         from langchain_community.llms.minimax import Minimax
+         minimax = Minimax(model="<model_name>", minimax_api_key="my-api-key",
+          minimax_group_id="my-group-id")
+    """
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        r"""Call out to Minimax's completion endpoint to chat
+        Args:
+            prompt: The prompt to pass into the model.
+        Returns:
+            The string generated by the model.
+        Example:
+            .. code-block:: python
+                response = minimax("Tell me a joke.")
+        """
+        request = self._default_params
+        request["messages"] = [{"sender_type": "USER", "text": prompt}]
+        request.update(kwargs)
+        text = self._client.post(request)
+        if stop is not None:
+            # This is required since the stop tokens
+            # are not enforced by the model parameters
+            text = enforce_stop_tokens(text, stop)
+
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/mlflow.py b/llm/Lib/site-packages/langchain_community/llms/mlflow.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b27ed57d8721f8fdade4f824b6c8fe9807fca58
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/mlflow.py
@@ -0,0 +1,111 @@
+from __future__ import annotations
+
+from typing import Any, Dict, List, Mapping, Optional
+from urllib.parse import urlparse
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models import LLM
+from langchain_core.pydantic_v1 import Field, PrivateAttr
+
+
+class Mlflow(LLM):
+    """MLflow LLM service.
+
+    To use, you should have the `mlflow[genai]` python package installed.
+    For more information, see https://mlflow.org/docs/latest/llms/deployments.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Mlflow
+
+            completions = Mlflow(
+                target_uri="http://localhost:5000",
+                endpoint="test",
+                temperature=0.1,
+            )
+    """
+
+    endpoint: str
+    """The endpoint to use."""
+    target_uri: str
+    """The target URI to use."""
+    temperature: float = 0.0
+    """The sampling temperature."""
+    n: int = 1
+    """The number of completion choices to generate."""
+    stop: Optional[List[str]] = None
+    """The stop sequence."""
+    max_tokens: Optional[int] = None
+    """The maximum number of tokens to generate."""
+    extra_params: Dict[str, Any] = Field(default_factory=dict)
+    """Any extra parameters to pass to the endpoint."""
+
+    """Extra parameters such as `temperature`."""
+    _client: Any = PrivateAttr()
+
+    def __init__(self, **kwargs: Any):
+        super().__init__(**kwargs)
+        self._validate_uri()
+        try:
+            from mlflow.deployments import get_deploy_client
+
+            self._client = get_deploy_client(self.target_uri)
+        except ImportError as e:
+            raise ImportError(
+                "Failed to create the client. "
+                "Please run `pip install mlflow[genai]` to install "
+                "required dependencies."
+            ) from e
+
+    def _validate_uri(self) -> None:
+        if self.target_uri == "databricks":
+            return
+        allowed = ["http", "https", "databricks"]
+        if urlparse(self.target_uri).scheme not in allowed:
+            raise ValueError(
+                f"Invalid target URI: {self.target_uri}. "
+                f"The scheme must be one of {allowed}."
+            )
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        return {
+            "target_uri": self.target_uri,
+            "endpoint": self.endpoint,
+            "temperature": self.temperature,
+            "n": self.n,
+            "stop": self.stop,
+            "max_tokens": self.max_tokens,
+            "extra_params": self.extra_params,
+        }
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        return self._default_params
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        data: Dict[str, Any] = {
+            "prompt": prompt,
+            "temperature": self.temperature,
+            "n": self.n,
+            **self.extra_params,
+            **kwargs,
+        }
+        if stop := self.stop or stop:
+            data["stop"] = stop
+        if self.max_tokens is not None:
+            data["max_tokens"] = self.max_tokens
+
+        resp = self._client.predict(endpoint=self.endpoint, inputs=data)
+        return resp["choices"][0]["text"]
+
+    @property
+    def _llm_type(self) -> str:
+        return "mlflow"
diff --git a/llm/Lib/site-packages/langchain_community/llms/mlflow_ai_gateway.py b/llm/Lib/site-packages/langchain_community/llms/mlflow_ai_gateway.py
new file mode 100644
index 0000000000000000000000000000000000000000..1909b8901a63f18f3ec72e6ac6697708a66cdf12
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/mlflow_ai_gateway.py
@@ -0,0 +1,103 @@
+from __future__ import annotations
+
+import warnings
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import BaseModel, Extra
+
+
+# Ignoring type because below is valid pydantic code
+# Unexpected keyword argument "extra" for "__init_subclass__" of "object"
+class Params(BaseModel, extra=Extra.allow):  # type: ignore[call-arg]
+    """Parameters for the MLflow AI Gateway LLM."""
+
+    temperature: float = 0.0
+    candidate_count: int = 1
+    """The number of candidates to return."""
+    stop: Optional[List[str]] = None
+    max_tokens: Optional[int] = None
+
+
+class MlflowAIGateway(LLM):
+    """MLflow AI Gateway LLMs.
+
+    To use, you should have the ``mlflow[gateway]`` python package installed.
+    For more information, see https://mlflow.org/docs/latest/gateway/index.html.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import MlflowAIGateway
+
+            completions = MlflowAIGateway(
+                gateway_uri="<your-mlflow-ai-gateway-uri>",
+                route="<your-mlflow-ai-gateway-completions-route>",
+                params={
+                    "temperature": 0.1
+                }
+            )
+    """
+
+    route: str
+    gateway_uri: Optional[str] = None
+    params: Optional[Params] = None
+
+    def __init__(self, **kwargs: Any):
+        warnings.warn(
+            "`MlflowAIGateway` is deprecated. Use `Mlflow` or `Databricks` instead.",
+            DeprecationWarning,
+        )
+        try:
+            import mlflow.gateway
+        except ImportError as e:
+            raise ImportError(
+                "Could not import `mlflow.gateway` module. "
+                "Please install it with `pip install mlflow[gateway]`."
+            ) from e
+
+        super().__init__(**kwargs)
+        if self.gateway_uri:
+            mlflow.gateway.set_gateway_uri(self.gateway_uri)
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        params: Dict[str, Any] = {
+            "gateway_uri": self.gateway_uri,
+            "route": self.route,
+            **(self.params.dict() if self.params else {}),
+        }
+        return params
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        return self._default_params
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        try:
+            import mlflow.gateway
+        except ImportError as e:
+            raise ImportError(
+                "Could not import `mlflow.gateway` module. "
+                "Please install it with `pip install mlflow[gateway]`."
+            ) from e
+
+        data: Dict[str, Any] = {
+            "prompt": prompt,
+            **(self.params.dict() if self.params else {}),
+        }
+        if s := (stop or (self.params.stop if self.params else None)):
+            data["stop"] = s
+        resp = mlflow.gateway.query(self.route, data=data)
+        return resp["candidates"][0]["text"]
+
+    @property
+    def _llm_type(self) -> str:
+        return "mlflow-ai-gateway"
diff --git a/llm/Lib/site-packages/langchain_community/llms/mlx_pipeline.py b/llm/Lib/site-packages/langchain_community/llms/mlx_pipeline.py
new file mode 100644
index 0000000000000000000000000000000000000000..8445fc955a936f1c3378dfc607575d30195c465c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/mlx_pipeline.py
@@ -0,0 +1,199 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Iterator, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import Extra
+
+DEFAULT_MODEL_ID = "mlx-community/quantized-gemma-2b"
+
+logger = logging.getLogger(__name__)
+
+
+class MLXPipeline(LLM):
+    """MLX Pipeline API.
+
+    To use, you should have the ``mlx-lm`` python package installed.
+
+    Example using from_model_id:
+        .. code-block:: python
+
+            from langchain_community.llms import MLXPipeline
+            pipe = MLXPipeline.from_model_id(
+                model_id="mlx-community/quantized-gemma-2b",
+                pipeline_kwargs={"max_tokens": 10},
+            )
+    Example passing model and tokenizer in directly:
+        .. code-block:: python
+
+            from langchain_community.llms import MLXPipeline
+            from mlx_lm import load
+            model_id="mlx-community/quantized-gemma-2b"
+            model, tokenizer = load(model_id)
+            pipe = MLXPipeline(model=model, tokenizer=tokenizer)
+    """
+
+    model_id: str = DEFAULT_MODEL_ID
+    """Model name to use."""
+    model: Any  #: :meta private:
+    """Model."""
+    tokenizer: Any  #: :meta private:
+    """Tokenizer."""
+    tokenizer_config: Optional[dict] = None
+    """
+        Configuration parameters specifically for the tokenizer.
+        Defaults to an empty dictionary.
+    """
+    adapter_file: Optional[str] = None
+    """
+        Path to the adapter file. If provided, applies LoRA layers to the model.
+        Defaults to None.
+    """
+    lazy: bool = False
+    """
+        If False eval the model parameters to make sure they are
+        loaded in memory before returning, otherwise they will be loaded
+        when needed. Default: ``False``
+    """
+    pipeline_kwargs: Optional[dict] = None
+    """Keyword arguments passed to the pipeline."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @classmethod
+    def from_model_id(
+        cls,
+        model_id: str,
+        tokenizer_config: Optional[dict] = None,
+        adapter_file: Optional[str] = None,
+        lazy: bool = False,
+        pipeline_kwargs: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> MLXPipeline:
+        """Construct the pipeline object from model_id and task."""
+        try:
+            from mlx_lm import load
+
+        except ImportError:
+            raise ValueError(
+                "Could not import mlx_lm python package. "
+                "Please install it with `pip install mlx_lm`."
+            )
+
+        tokenizer_config = tokenizer_config or {}
+        if adapter_file:
+            model, tokenizer = load(model_id, tokenizer_config, adapter_file, lazy)
+        else:
+            model, tokenizer = load(model_id, tokenizer_config, lazy=lazy)
+
+        _pipeline_kwargs = pipeline_kwargs or {}
+        return cls(
+            model_id=model_id,
+            model=model,
+            tokenizer=tokenizer,
+            tokenizer_config=tokenizer_config,
+            adapter_file=adapter_file,
+            lazy=lazy,
+            pipeline_kwargs=_pipeline_kwargs,
+            **kwargs,
+        )
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model_id": self.model_id,
+            "tokenizer_config": self.tokenizer_config,
+            "adapter_file": self.adapter_file,
+            "lazy": self.lazy,
+            "pipeline_kwargs": self.pipeline_kwargs,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        return "mlx_pipeline"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        try:
+            from mlx_lm import generate
+
+        except ImportError:
+            raise ValueError(
+                "Could not import mlx_lm python package. "
+                "Please install it with `pip install mlx_lm`."
+            )
+
+        pipeline_kwargs = kwargs.get("pipeline_kwargs", {})
+
+        return generate(self.model, self.tokenizer, prompt=prompt, **pipeline_kwargs)
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        try:
+            import mlx.core as mx
+            from mlx_lm.utils import generate_step
+
+        except ImportError:
+            raise ValueError(
+                "Could not import mlx_lm python package. "
+                "Please install it with `pip install mlx_lm`."
+            )
+
+        pipeline_kwargs = kwargs.get("pipeline_kwargs", self.pipeline_kwargs)
+
+        temp: float = pipeline_kwargs.get("temp", 0.0)
+        max_new_tokens: int = pipeline_kwargs.get("max_tokens", 100)
+        repetition_penalty: Optional[float] = pipeline_kwargs.get(
+            "repetition_penalty", None
+        )
+        repetition_context_size: Optional[int] = pipeline_kwargs.get(
+            "repetition_context_size", None
+        )
+
+        prompt = self.tokenizer.encode(prompt, return_tensors="np")
+
+        prompt_tokens = mx.array(prompt[0])
+
+        eos_token_id = self.tokenizer.eos_token_id
+
+        for (token, prob), n in zip(
+            generate_step(
+                prompt_tokens,
+                self.model,
+                temp,
+                repetition_penalty,
+                repetition_context_size,
+            ),
+            range(max_new_tokens),
+        ):
+            # identify text to yield
+            text: Optional[str] = None
+            text = self.tokenizer.decode(token.item())
+
+            # yield text, if any
+            if text:
+                chunk = GenerationChunk(text=text)
+                yield chunk
+                if run_manager:
+                    run_manager.on_llm_new_token(chunk.text)
+
+            # break if stop sequence found
+            if token == eos_token_id or (stop is not None and text in stop):
+                break
diff --git a/llm/Lib/site-packages/langchain_community/llms/modal.py b/llm/Lib/site-packages/langchain_community/llms/modal.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ccac3c0d8ef1e067ca57cba23635d94f167905d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/modal.py
@@ -0,0 +1,100 @@
+import logging
+from typing import Any, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class Modal(LLM):
+    """Modal large language models.
+
+    To use, you should have the ``modal-client`` python package installed.
+
+    Any parameters that are valid to be passed to the call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Modal
+            modal = Modal(endpoint_url="")
+
+    """
+
+    endpoint_url: str = ""
+    """model endpoint to use"""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not
+    explicitly specified."""
+
+    class Config:
+        """Configuration for this pydantic config."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = {field.alias for field in cls.__fields__.values()}
+
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name not in all_required_field_names:
+                if field_name in extra:
+                    raise ValueError(f"Found {field_name} supplied twice.")
+                logger.warning(
+                    f"""{field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+        values["model_kwargs"] = extra
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"endpoint_url": self.endpoint_url},
+            **{"model_kwargs": self.model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "modal"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call to Modal endpoint."""
+        params = self.model_kwargs or {}
+        params = {**params, **kwargs}
+        response = requests.post(
+            url=self.endpoint_url,
+            headers={
+                "Content-Type": "application/json",
+            },
+            json={"prompt": prompt, **params},
+        )
+        try:
+            if prompt in response.json()["prompt"]:
+                response_json = response.json()
+        except KeyError:
+            raise KeyError("LangChain requires 'prompt' key in response.")
+        text = response_json["prompt"]
+        if stop is not None:
+            # I believe this is required since the stop tokens
+            # are not enforced by the model parameters
+            text = enforce_stop_tokens(text, stop)
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/moonshot.py b/llm/Lib/site-packages/langchain_community/llms/moonshot.py
new file mode 100644
index 0000000000000000000000000000000000000000..d72659f12664da7fdbd409cc9ecdd0aeea508c0f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/moonshot.py
@@ -0,0 +1,138 @@
+from typing import Any, Dict, List, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models import LLM
+from langchain_core.pydantic_v1 import BaseModel, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+MOONSHOT_SERVICE_URL_BASE = "https://api.moonshot.cn/v1"
+
+
+class _MoonshotClient(BaseModel):
+    """An API client that talks to the Moonshot server."""
+
+    api_key: SecretStr
+    """The API key to use for authentication."""
+    base_url: str = MOONSHOT_SERVICE_URL_BASE
+
+    def completion(self, request: Any) -> Any:
+        headers = {"Authorization": f"Bearer {self.api_key.get_secret_value()}"}
+        response = requests.post(
+            f"{self.base_url}/chat/completions",
+            headers=headers,
+            json=request,
+        )
+        if not response.ok:
+            raise ValueError(f"HTTP {response.status_code} error: {response.text}")
+        return response.json()["choices"][0]["message"]["content"]
+
+
+class MoonshotCommon(BaseModel):
+    """Common parameters for Moonshot LLMs."""
+
+    _client: _MoonshotClient
+    base_url: str = MOONSHOT_SERVICE_URL_BASE
+    moonshot_api_key: Optional[SecretStr] = Field(default=None, alias="api_key")
+    """Moonshot API key. Get it here: https://platform.moonshot.cn/console/api-keys"""
+    model_name: str = Field(default="moonshot-v1-8k", alias="model")
+    """Model name. Available models listed here: https://platform.moonshot.cn/pricing"""
+    max_tokens = 1024
+    """Maximum number of tokens to generate."""
+    temperature = 0.3
+    """Temperature parameter (higher values make the model more creative)."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @property
+    def lc_secrets(self) -> dict:
+        """A map of constructor argument names to secret ids.
+
+        For example,
+            {"moonshot_api_key": "MOONSHOT_API_KEY"}
+        """
+        return {"moonshot_api_key": "MOONSHOT_API_KEY"}
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling OpenAI API."""
+        return {
+            "model": self.model_name,
+            "max_tokens": self.max_tokens,
+            "temperature": self.temperature,
+        }
+
+    @property
+    def _invocation_params(self) -> Dict[str, Any]:
+        return {**{"model": self.model_name}, **self._default_params}
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra parameters.
+        Override the superclass method, prevent the model parameter from being
+        overridden.
+        """
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["moonshot_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "moonshot_api_key", "MOONSHOT_API_KEY")
+        )
+
+        values["_client"] = _MoonshotClient(
+            api_key=values["moonshot_api_key"],
+            base_url=values["base_url"]
+            if "base_url" in values
+            else MOONSHOT_SERVICE_URL_BASE,
+        )
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "moonshot"
+
+
+class Moonshot(MoonshotCommon, LLM):
+    """Moonshot large language models.
+
+    To use, you should have the environment variable ``MOONSHOT_API_KEY`` set with your
+    API key. Referenced from https://platform.moonshot.cn/docs
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms.moonshot import Moonshot
+
+            moonshot = Moonshot(model="moonshot-v1-8k")
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        request = self._invocation_params
+        request["messages"] = [{"role": "user", "content": prompt}]
+        request.update(kwargs)
+        text = self._client.completion(request)
+        if stop is not None:
+            # This is required since the stop tokens
+            # are not enforced by the model parameters
+            text = enforce_stop_tokens(text, stop)
+
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/mosaicml.py b/llm/Lib/site-packages/langchain_community/llms/mosaicml.py
new file mode 100644
index 0000000000000000000000000000000000000000..b73e0d5e2140e94db579589015bcf600ef81fb5e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/mosaicml.py
@@ -0,0 +1,188 @@
+from typing import Any, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+INSTRUCTION_KEY = "### Instruction:"
+RESPONSE_KEY = "### Response:"
+INTRO_BLURB = (
+    "Below is an instruction that describes a task. "
+    "Write a response that appropriately completes the request."
+)
+PROMPT_FOR_GENERATION_FORMAT = """{intro}
+{instruction_key}
+{instruction}
+{response_key}
+""".format(
+    intro=INTRO_BLURB,
+    instruction_key=INSTRUCTION_KEY,
+    instruction="{instruction}",
+    response_key=RESPONSE_KEY,
+)
+
+
+class MosaicML(LLM):
+    """MosaicML LLM service.
+
+    To use, you should have the
+    environment variable ``MOSAICML_API_TOKEN`` set with your API token, or pass
+    it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import MosaicML
+            endpoint_url = (
+                "https://models.hosted-on.mosaicml.hosting/mpt-7b-instruct/v1/predict"
+            )
+            mosaic_llm = MosaicML(
+                endpoint_url=endpoint_url,
+                mosaicml_api_token="my-api-key"
+            )
+    """
+
+    endpoint_url: str = (
+        "https://models.hosted-on.mosaicml.hosting/mpt-7b-instruct/v1/predict"
+    )
+    """Endpoint URL to use."""
+    inject_instruction_format: bool = False
+    """Whether to inject the instruction format into the prompt."""
+    model_kwargs: Optional[dict] = None
+    """Keyword arguments to pass to the model."""
+    retry_sleep: float = 1.0
+    """How long to try sleeping for if a rate limit is encountered"""
+
+    mosaicml_api_token: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        mosaicml_api_token = get_from_dict_or_env(
+            values, "mosaicml_api_token", "MOSAICML_API_TOKEN"
+        )
+        values["mosaicml_api_token"] = mosaicml_api_token
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            **{"endpoint_url": self.endpoint_url},
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "mosaic"
+
+    def _transform_prompt(self, prompt: str) -> str:
+        """Transform prompt."""
+        if self.inject_instruction_format:
+            prompt = PROMPT_FOR_GENERATION_FORMAT.format(
+                instruction=prompt,
+            )
+        return prompt
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        is_retry: bool = False,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to a MosaicML LLM inference endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = mosaic_llm("Tell me a joke.")
+        """
+        _model_kwargs = self.model_kwargs or {}
+
+        prompt = self._transform_prompt(prompt)
+
+        payload = {"inputs": [prompt]}
+        payload.update(_model_kwargs)
+        payload.update(kwargs)
+
+        # HTTP headers for authorization
+        headers = {
+            "Authorization": f"{self.mosaicml_api_token}",
+            "Content-Type": "application/json",
+        }
+
+        # send request
+        try:
+            response = requests.post(self.endpoint_url, headers=headers, json=payload)
+        except requests.exceptions.RequestException as e:
+            raise ValueError(f"Error raised by inference endpoint: {e}")
+
+        try:
+            if response.status_code == 429:
+                if not is_retry:
+                    import time
+
+                    time.sleep(self.retry_sleep)
+
+                    return self._call(prompt, stop, run_manager, is_retry=True)
+
+                raise ValueError(
+                    f"Error raised by inference API: rate limit exceeded.\nResponse: "
+                    f"{response.text}"
+                )
+
+            parsed_response = response.json()
+
+            # The inference API has changed a couple of times, so we add some handling
+            # to be robust to multiple response formats.
+            if isinstance(parsed_response, dict):
+                output_keys = ["data", "output", "outputs"]
+                for key in output_keys:
+                    if key in parsed_response:
+                        output_item = parsed_response[key]
+                        break
+                else:
+                    raise ValueError(
+                        f"No valid key ({', '.join(output_keys)}) in response:"
+                        f" {parsed_response}"
+                    )
+                if isinstance(output_item, list):
+                    text = output_item[0]
+                else:
+                    text = output_item
+            else:
+                raise ValueError(f"Unexpected response type: {parsed_response}")
+
+            # Older versions of the API include the input in the output response
+            if text.startswith(prompt):
+                text = text[len(prompt) :]
+
+        except requests.exceptions.JSONDecodeError as e:
+            raise ValueError(
+                f"Error raised by inference API: {e}.\nResponse: {response.text}"
+            )
+
+        # TODO: replace when MosaicML supports custom stop tokens natively
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/nlpcloud.py b/llm/Lib/site-packages/langchain_community/llms/nlpcloud.py
new file mode 100644
index 0000000000000000000000000000000000000000..a73087918ce78d678cb2be00c0ec5efb8aa2b3c7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/nlpcloud.py
@@ -0,0 +1,145 @@
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+
+class NLPCloud(LLM):
+    """NLPCloud large language models.
+
+    To use, you should have the ``nlpcloud`` python package installed, and the
+    environment variable ``NLPCLOUD_API_KEY`` set with your API key.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import NLPCloud
+            nlpcloud = NLPCloud(model="finetuned-gpt-neox-20b")
+    """
+
+    client: Any  #: :meta private:
+    model_name: str = "finetuned-gpt-neox-20b"
+    """Model name to use."""
+    gpu: bool = True
+    """Whether to use a GPU or not"""
+    lang: str = "en"
+    """Language to use (multilingual addon)"""
+    temperature: float = 0.7
+    """What sampling temperature to use."""
+    max_length: int = 256
+    """The maximum number of tokens to generate in the completion."""
+    length_no_input: bool = True
+    """Whether min_length and max_length should include the length of the input."""
+    remove_input: bool = True
+    """Remove input text from API response"""
+    remove_end_sequence: bool = True
+    """Whether or not to remove the end sequence token."""
+    bad_words: List[str] = []
+    """List of tokens not allowed to be generated."""
+    top_p: float = 1.0
+    """Total probability mass of tokens to consider at each step."""
+    top_k: int = 50
+    """The number of highest probability tokens to keep for top-k filtering."""
+    repetition_penalty: float = 1.0
+    """Penalizes repeated tokens. 1.0 means no penalty."""
+    num_beams: int = 1
+    """Number of beams for beam search."""
+    num_return_sequences: int = 1
+    """How many completions to generate for each prompt."""
+
+    nlpcloud_api_key: Optional[SecretStr] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["nlpcloud_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "nlpcloud_api_key", "NLPCLOUD_API_KEY")
+        )
+        try:
+            import nlpcloud
+
+            values["client"] = nlpcloud.Client(
+                values["model_name"],
+                values["nlpcloud_api_key"].get_secret_value(),
+                gpu=values["gpu"],
+                lang=values["lang"],
+            )
+        except ImportError:
+            raise ImportError(
+                "Could not import nlpcloud python package. "
+                "Please install it with `pip install nlpcloud`."
+            )
+        return values
+
+    @property
+    def _default_params(self) -> Mapping[str, Any]:
+        """Get the default parameters for calling NLPCloud API."""
+        return {
+            "temperature": self.temperature,
+            "max_length": self.max_length,
+            "length_no_input": self.length_no_input,
+            "remove_input": self.remove_input,
+            "remove_end_sequence": self.remove_end_sequence,
+            "bad_words": self.bad_words,
+            "top_p": self.top_p,
+            "top_k": self.top_k,
+            "repetition_penalty": self.repetition_penalty,
+            "num_beams": self.num_beams,
+            "num_return_sequences": self.num_return_sequences,
+        }
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"model_name": self.model_name},
+            **{"gpu": self.gpu},
+            **{"lang": self.lang},
+            **self._default_params,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "nlpcloud"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to NLPCloud's create endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Not supported by this interface (pass in init method)
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = nlpcloud("Tell me a joke.")
+        """
+        if stop and len(stop) > 1:
+            raise ValueError(
+                "NLPCloud only supports a single stop sequence per generation."
+                "Pass in a list of length 1."
+            )
+        elif stop and len(stop) == 1:
+            end_sequence = stop[0]
+        else:
+            end_sequence = None
+        params = {**self._default_params, **kwargs}
+        response = self.client.generation(prompt, end_sequence=end_sequence, **params)
+        return response["generated_text"]
diff --git a/llm/Lib/site-packages/langchain_community/llms/oci_data_science_model_deployment_endpoint.py b/llm/Lib/site-packages/langchain_community/llms/oci_data_science_model_deployment_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..9092f0677996aafe4c5b21df97952f371bea78ac
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/oci_data_science_model_deployment_endpoint.py
@@ -0,0 +1,362 @@
+import logging
+from typing import Any, Dict, List, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_TIME_OUT = 300
+DEFAULT_CONTENT_TYPE_JSON = "application/json"
+
+
+class OCIModelDeploymentLLM(LLM):
+    """Base class for LLM deployed on OCI Data Science Model Deployment."""
+
+    auth: dict = Field(default_factory=dict, exclude=True)
+    """ADS auth dictionary for OCI authentication:
+    https://accelerated-data-science.readthedocs.io/en/latest/user_guide/cli/authentication.html.
+    This can be generated by calling `ads.common.auth.api_keys()`
+    or `ads.common.auth.resource_principal()`. If this is not
+    provided then the `ads.common.default_signer()` will be used."""
+
+    max_tokens: int = 256
+    """Denotes the number of tokens to predict per generation."""
+
+    temperature: float = 0.2
+    """A non-negative float that tunes the degree of randomness in generation."""
+
+    k: int = 0
+    """Number of most likely tokens to consider at each step."""
+
+    p: float = 0.75
+    """Total probability mass of tokens to consider at each step."""
+
+    endpoint: str = ""
+    """The uri of the endpoint from the deployed Model Deployment model."""
+
+    best_of: int = 1
+    """Generates best_of completions server-side and returns the "best"
+    (the one with the highest log probability per token).
+    """
+
+    stop: Optional[List[str]] = None
+    """Stop words to use when generating. Model output is cut off
+    at the first occurrence of any of these substrings."""
+
+    @root_validator()
+    def validate_environment(  # pylint: disable=no-self-argument
+        cls, values: Dict
+    ) -> Dict:
+        """Validate that python package exists in environment."""
+        try:
+            import ads
+
+        except ImportError as ex:
+            raise ImportError(
+                "Could not import ads python package. "
+                "Please install it with `pip install oracle_ads`."
+            ) from ex
+        if not values.get("auth", None):
+            values["auth"] = ads.common.auth.default_signer()
+        values["endpoint"] = get_from_dict_or_env(
+            values,
+            "endpoint",
+            "OCI_LLM_ENDPOINT",
+        )
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Default parameters for the model."""
+        raise NotImplementedError
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"endpoint": self.endpoint},
+            **self._default_params,
+        }
+
+    def _construct_json_body(self, prompt: str, params: dict) -> dict:
+        """Constructs the request body as a dictionary (JSON)."""
+        raise NotImplementedError
+
+    def _invocation_params(self, stop: Optional[List[str]], **kwargs: Any) -> dict:
+        """Combines the invocation parameters with default parameters."""
+        params = self._default_params
+        if self.stop is not None and stop is not None:
+            raise ValueError("`stop` found in both the input and default params.")
+        elif self.stop is not None:
+            params["stop"] = self.stop
+        elif stop is not None:
+            params["stop"] = stop
+        else:
+            # Don't set "stop" in param as None. It should be a list.
+            params["stop"] = []
+
+        return {**params, **kwargs}
+
+    def _process_response(self, response_json: dict) -> str:
+        raise NotImplementedError
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to OCI Data Science Model Deployment endpoint.
+
+        Args:
+            prompt (str):
+                The prompt to pass into the model.
+            stop (List[str], Optional):
+                List of stop words to use when generating.
+            kwargs:
+                requests_kwargs:
+                    Additional ``**kwargs`` to pass to requests.post
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = oci_md("Tell me a joke.")
+
+        """
+        requests_kwargs = kwargs.pop("requests_kwargs", {})
+        params = self._invocation_params(stop, **kwargs)
+        body = self._construct_json_body(prompt, params)
+        logger.info(f"LLM API Request:\n{prompt}")
+        response = self._send_request(
+            data=body, endpoint=self.endpoint, **requests_kwargs
+        )
+        completion = self._process_response(response)
+        logger.info(f"LLM API Completion:\n{completion}")
+        return completion
+
+    def _send_request(
+        self,
+        data: Any,
+        endpoint: str,
+        header: Optional[dict] = {},
+        **kwargs: Any,
+    ) -> Dict:
+        """Sends request to the oci data science model deployment endpoint.
+
+        Args:
+            data (Json serializable):
+                data need to be sent to the endpoint.
+            endpoint (str):
+                The model HTTP endpoint.
+            header (dict, optional):
+                A dictionary of HTTP headers to send to the specified url.
+                Defaults to {}.
+            kwargs:
+                Additional ``**kwargs`` to pass to requests.post.
+        Raises:
+            Exception:
+                Raise when invoking fails.
+
+        Returns:
+            A JSON representation of a requests.Response object.
+        """
+        if not header:
+            header = {}
+        header["Content-Type"] = (
+            header.pop("content_type", DEFAULT_CONTENT_TYPE_JSON)
+            or DEFAULT_CONTENT_TYPE_JSON
+        )
+        request_kwargs = {"json": data}
+        request_kwargs["headers"] = header
+        timeout = kwargs.pop("timeout", DEFAULT_TIME_OUT)
+
+        attempts = 0
+        while attempts < 2:
+            request_kwargs["auth"] = self.auth.get("signer")
+            response = requests.post(
+                endpoint, timeout=timeout, **request_kwargs, **kwargs
+            )
+            if response.status_code == 401:
+                self._refresh_signer()
+                attempts += 1
+                continue
+            break
+
+        try:
+            response.raise_for_status()
+            response_json = response.json()
+
+        except Exception:
+            logger.error(
+                "DEBUG INFO: request_kwargs=%s, status_code=%s, content=%s",
+                request_kwargs,
+                response.status_code,
+                response.content,
+            )
+            raise
+
+        return response_json
+
+    def _refresh_signer(self) -> None:
+        if self.auth.get("signer", None) and hasattr(
+            self.auth["signer"], "refresh_security_token"
+        ):
+            self.auth["signer"].refresh_security_token()
+
+
+class OCIModelDeploymentTGI(OCIModelDeploymentLLM):
+    """OCI Data Science Model Deployment TGI Endpoint.
+
+    To use, you must provide the model HTTP endpoint from your deployed
+    model, e.g. https://<MD_OCID>/predict.
+
+    To authenticate, `oracle-ads` has been used to automatically load
+    credentials: https://accelerated-data-science.readthedocs.io/en/latest/user_guide/cli/authentication.html
+
+    Make sure to have the required policies to access the OCI Data
+    Science Model Deployment endpoint. See:
+    https://docs.oracle.com/en-us/iaas/data-science/using/model-dep-policies-auth.htm#model_dep_policies_auth__predict-endpoint
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import ModelDeploymentTGI
+
+            oci_md = ModelDeploymentTGI(endpoint="https://<MD_OCID>/predict")
+
+    """
+
+    do_sample: bool = True
+    """If set to True, this parameter enables decoding strategies such as
+    multi-nominal sampling, beam-search multi-nominal sampling, Top-K
+    sampling and Top-p sampling.
+    """
+
+    watermark = True
+    """Watermarking with `A Watermark for Large Language Models <https://arxiv.org/abs/2301.10226>`_.
+    Defaults to True."""
+
+    return_full_text = False
+    """Whether to prepend the prompt to the generated text. Defaults to False."""
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "oci_model_deployment_tgi_endpoint"
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for invoking OCI model deployment TGI endpoint."""
+        return {
+            "best_of": self.best_of,
+            "max_new_tokens": self.max_tokens,
+            "temperature": self.temperature,
+            "top_k": self.k
+            if self.k > 0
+            else None,  # `top_k` must be strictly positive'
+            "top_p": self.p,
+            "do_sample": self.do_sample,
+            "return_full_text": self.return_full_text,
+            "watermark": self.watermark,
+        }
+
+    def _construct_json_body(self, prompt: str, params: dict) -> dict:
+        return {
+            "inputs": prompt,
+            "parameters": params,
+        }
+
+    def _process_response(self, response_json: dict) -> str:
+        return str(response_json.get("generated_text", response_json)) + "\n"
+
+
+class OCIModelDeploymentVLLM(OCIModelDeploymentLLM):
+    """VLLM deployed on OCI Data Science Model Deployment
+
+    To use, you must provide the model HTTP endpoint from your deployed
+    model, e.g. https://<MD_OCID>/predict.
+
+    To authenticate, `oracle-ads` has been used to automatically load
+    credentials: https://accelerated-data-science.readthedocs.io/en/latest/user_guide/cli/authentication.html
+
+    Make sure to have the required policies to access the OCI Data
+    Science Model Deployment endpoint. See:
+    https://docs.oracle.com/en-us/iaas/data-science/using/model-dep-policies-auth.htm#model_dep_policies_auth__predict-endpoint
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import OCIModelDeploymentVLLM
+
+            oci_md = OCIModelDeploymentVLLM(
+                endpoint="https://<MD_OCID>/predict",
+                model="mymodel"
+            )
+
+    """
+
+    model: str
+    """The name of the model."""
+
+    n: int = 1
+    """Number of output sequences to return for the given prompt."""
+
+    k: int = -1
+    """Number of most likely tokens to consider at each step."""
+
+    frequency_penalty: float = 0.0
+    """Penalizes repeated tokens according to frequency. Between 0 and 1."""
+
+    presence_penalty: float = 0.0
+    """Penalizes repeated tokens. Between 0 and 1."""
+
+    use_beam_search: bool = False
+    """Whether to use beam search instead of sampling."""
+
+    ignore_eos: bool = False
+    """Whether to ignore the EOS token and continue generating tokens after
+    the EOS token is generated."""
+
+    logprobs: Optional[int] = None
+    """Number of log probabilities to return per output token."""
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "oci_model_deployment_vllm_endpoint"
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling vllm."""
+        return {
+            "best_of": self.best_of,
+            "frequency_penalty": self.frequency_penalty,
+            "ignore_eos": self.ignore_eos,
+            "logprobs": self.logprobs,
+            "max_tokens": self.max_tokens,
+            "model": self.model,
+            "n": self.n,
+            "presence_penalty": self.presence_penalty,
+            "stop": self.stop,
+            "temperature": self.temperature,
+            "top_k": self.k,
+            "top_p": self.p,
+            "use_beam_search": self.use_beam_search,
+        }
+
+    def _construct_json_body(self, prompt: str, params: dict) -> dict:
+        return {
+            "prompt": prompt,
+            **params,
+        }
+
+    def _process_response(self, response_json: dict) -> str:
+        return response_json["choices"][0]["text"]
diff --git a/llm/Lib/site-packages/langchain_community/llms/oci_generative_ai.py b/llm/Lib/site-packages/langchain_community/llms/oci_generative_ai.py
new file mode 100644
index 0000000000000000000000000000000000000000..3369763c876569c2d370f465f5f75db5eb8ae14a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/oci_generative_ai.py
@@ -0,0 +1,278 @@
+from __future__ import annotations
+
+from abc import ABC
+from enum import Enum
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+CUSTOM_ENDPOINT_PREFIX = "ocid1.generativeaiendpoint"
+VALID_PROVIDERS = ("cohere", "meta")
+
+
+class OCIAuthType(Enum):
+    """OCI authentication types as enumerator."""
+
+    API_KEY = 1
+    SECURITY_TOKEN = 2
+    INSTANCE_PRINCIPAL = 3
+    RESOURCE_PRINCIPAL = 4
+
+
+class OCIGenAIBase(BaseModel, ABC):
+    """Base class for OCI GenAI models"""
+
+    client: Any  #: :meta private:
+
+    auth_type: Optional[str] = "API_KEY"
+    """Authentication type, could be 
+    
+    API_KEY, 
+    SECURITY_TOKEN, 
+    INSTANCE_PRINCIPLE, 
+    RESOURCE_PRINCIPLE
+
+    If not specified, API_KEY will be used
+    """
+
+    auth_profile: Optional[str] = "DEFAULT"
+    """The name of the profile in ~/.oci/config
+    If not specified , DEFAULT will be used 
+    """
+
+    model_id: str = None  # type: ignore[assignment]
+    """Id of the model to call, e.g., cohere.command"""
+
+    provider: str = None  # type: ignore[assignment]
+    """Provider name of the model. Default to None, 
+    will try to be derived from the model_id
+    otherwise, requires user input
+    """
+
+    model_kwargs: Optional[Dict] = None
+    """Keyword arguments to pass to the model"""
+
+    service_endpoint: str = None  # type: ignore[assignment]
+    """service endpoint url"""
+
+    compartment_id: str = None  # type: ignore[assignment]
+    """OCID of compartment"""
+
+    is_stream: bool = False
+    """Whether to stream back partial progress"""
+
+    llm_stop_sequence_mapping: Mapping[str, str] = {
+        "cohere": "stop_sequences",
+        "meta": "stop",
+    }
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that OCI config and python package exists in environment."""
+
+        # Skip creating new client if passed in constructor
+        if values["client"] is not None:
+            return values
+
+        try:
+            import oci
+
+            client_kwargs = {
+                "config": {},
+                "signer": None,
+                "service_endpoint": values["service_endpoint"],
+                "retry_strategy": oci.retry.DEFAULT_RETRY_STRATEGY,
+                "timeout": (10, 240),  # default timeout config for OCI Gen AI service
+            }
+
+            if values["auth_type"] == OCIAuthType(1).name:
+                client_kwargs["config"] = oci.config.from_file(
+                    profile_name=values["auth_profile"]
+                )
+                client_kwargs.pop("signer", None)
+            elif values["auth_type"] == OCIAuthType(2).name:
+
+                def make_security_token_signer(oci_config):  # type: ignore[no-untyped-def]
+                    pk = oci.signer.load_private_key_from_file(
+                        oci_config.get("key_file"), None
+                    )
+                    with open(
+                        oci_config.get("security_token_file"), encoding="utf-8"
+                    ) as f:
+                        st_string = f.read()
+                    return oci.auth.signers.SecurityTokenSigner(st_string, pk)
+
+                client_kwargs["config"] = oci.config.from_file(
+                    profile_name=values["auth_profile"]
+                )
+                client_kwargs["signer"] = make_security_token_signer(
+                    oci_config=client_kwargs["config"]
+                )
+            elif values["auth_type"] == OCIAuthType(3).name:
+                client_kwargs[
+                    "signer"
+                ] = oci.auth.signers.InstancePrincipalsSecurityTokenSigner()
+            elif values["auth_type"] == OCIAuthType(4).name:
+                client_kwargs[
+                    "signer"
+                ] = oci.auth.signers.get_resource_principals_signer()
+            else:
+                raise ValueError("Please provide valid value to auth_type")
+
+            values["client"] = oci.generative_ai_inference.GenerativeAiInferenceClient(
+                **client_kwargs
+            )
+
+        except ImportError as ex:
+            raise ModuleNotFoundError(
+                "Could not import oci python package. "
+                "Please make sure you have the oci package installed."
+            ) from ex
+        except Exception as e:
+            raise ValueError(
+                "Could not authenticate with OCI client. "
+                "Please check if ~/.oci/config exists. "
+                "If INSTANCE_PRINCIPLE or RESOURCE_PRINCIPLE is used, "
+                "Please check the specified "
+                "auth_profile and auth_type are valid."
+            ) from e
+
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    def _get_provider(self) -> str:
+        if self.provider is not None:
+            provider = self.provider
+        else:
+            provider = self.model_id.split(".")[0].lower()
+
+        if provider not in VALID_PROVIDERS:
+            raise ValueError(
+                f"Invalid provider derived from model_id: {self.model_id} "
+                "Please explicitly pass in the supported provider "
+                "when using custom endpoint"
+            )
+        return provider
+
+
+class OCIGenAI(LLM, OCIGenAIBase):
+    """OCI large language models.
+
+    To authenticate, the OCI client uses the methods described in
+    https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_authentication_methods.htm
+
+    The authentifcation method is passed through auth_type and should be one of:
+    API_KEY (default), SECURITY_TOKEN, INSTANCE_PRINCIPLE, RESOURCE_PRINCIPLE
+
+    Make sure you have the required policies (profile/roles) to
+    access the OCI Generative AI service.
+    If a specific config profile is used, you must pass
+    the name of the profile (from ~/.oci/config) through auth_profile.
+
+    To use, you must provide the compartment id
+    along with the endpoint url, and model id
+    as named parameters to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import OCIGenAI
+
+            llm = OCIGenAI(
+                    model_id="MY_MODEL_ID",
+                    service_endpoint="https://inference.generativeai.us-chicago-1.oci.oraclecloud.com",
+                    compartment_id="MY_OCID"
+                )
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "oci"
+
+    def _prepare_invocation_object(
+        self, prompt: str, stop: Optional[List[str]], kwargs: Dict[str, Any]
+    ) -> Dict[str, Any]:
+        from oci.generative_ai_inference import models
+
+        oci_llm_request_mapping = {
+            "cohere": models.CohereLlmInferenceRequest,
+            "meta": models.LlamaLlmInferenceRequest,
+        }
+        provider = self._get_provider()
+        _model_kwargs = self.model_kwargs or {}
+        if stop is not None:
+            _model_kwargs[self.llm_stop_sequence_mapping[provider]] = stop
+
+        if self.model_id.startswith(CUSTOM_ENDPOINT_PREFIX):
+            serving_mode = models.DedicatedServingMode(endpoint_id=self.model_id)
+        else:
+            serving_mode = models.OnDemandServingMode(model_id=self.model_id)
+
+        inference_params = {**_model_kwargs, **kwargs}
+        inference_params["prompt"] = prompt
+        inference_params["is_stream"] = self.is_stream
+
+        invocation_obj = models.GenerateTextDetails(
+            compartment_id=self.compartment_id,
+            serving_mode=serving_mode,
+            inference_request=oci_llm_request_mapping[provider](**inference_params),
+        )
+
+        return invocation_obj
+
+    def _process_response(self, response: Any, stop: Optional[List[str]]) -> str:
+        provider = self._get_provider()
+        if provider == "cohere":
+            text = response.data.inference_response.generated_texts[0].text
+        elif provider == "meta":
+            text = response.data.inference_response.choices[0].text
+        else:
+            raise ValueError(f"Invalid provider: {provider}")
+
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+
+        return text
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to OCIGenAI generate endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+               response = llm.invoke("Tell me a joke.")
+        """
+
+        invocation_obj = self._prepare_invocation_object(prompt, stop, kwargs)
+        response = self.client.generate_text(invocation_obj)
+        return self._process_response(response, stop)
diff --git a/llm/Lib/site-packages/langchain_community/llms/octoai_endpoint.py b/llm/Lib/site-packages/langchain_community/llms/octoai_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..a2bc1484011e940b064c35ca35e9dc1975713c09
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/octoai_endpoint.py
@@ -0,0 +1,117 @@
+from typing import Any, Dict
+
+from langchain_core.pydantic_v1 import Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.llms.openai import BaseOpenAI
+from langchain_community.utils.openai import is_openai_v1
+
+DEFAULT_BASE_URL = "https://text.octoai.run/v1/"
+DEFAULT_MODEL = "codellama-7b-instruct"
+
+
+class OctoAIEndpoint(BaseOpenAI):
+    """OctoAI LLM Endpoints - OpenAI compatible.
+
+    OctoAIEndpoint is a class to interact with OctoAI Compute Service large
+    language model endpoints.
+
+    To use, you should have the environment variable ``OCTOAI_API_TOKEN`` set
+    with your API token, or pass it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms.octoai_endpoint  import OctoAIEndpoint
+
+            llm = OctoAIEndpoint(
+                model="llama-2-13b-chat-fp16",
+                max_tokens=200,
+                presence_penalty=0,
+                temperature=0.1,
+                top_p=0.9,
+            )
+
+    """
+
+    """Key word arguments to pass to the model."""
+    octoai_api_base: str = Field(default=DEFAULT_BASE_URL)
+    octoai_api_token: SecretStr = Field(default=None)
+    model_name: str = Field(default=DEFAULT_MODEL)
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @property
+    def _invocation_params(self) -> Dict[str, Any]:
+        """Get the parameters used to invoke the model."""
+
+        params: Dict[str, Any] = {
+            "model": self.model_name,
+            **self._default_params,
+        }
+        if not is_openai_v1():
+            params.update(
+                {
+                    "api_key": self.octoai_api_token.get_secret_value(),
+                    "api_base": self.octoai_api_base,
+                }
+            )
+
+        return {**params, **super()._invocation_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "octoai_endpoint"
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["octoai_api_base"] = get_from_dict_or_env(
+            values,
+            "octoai_api_base",
+            "OCTOAI_API_BASE",
+            default=DEFAULT_BASE_URL,
+        )
+        values["octoai_api_token"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "octoai_api_token", "OCTOAI_API_TOKEN")
+        )
+        values["model_name"] = get_from_dict_or_env(
+            values,
+            "model_name",
+            "MODEL_NAME",
+            default=DEFAULT_MODEL,
+        )
+
+        try:
+            import openai
+
+            if is_openai_v1():
+                client_params = {
+                    "api_key": values["octoai_api_token"].get_secret_value(),
+                    "base_url": values["octoai_api_base"],
+                }
+                if not values.get("client"):
+                    values["client"] = openai.OpenAI(**client_params).completions
+                if not values.get("async_client"):
+                    values["async_client"] = openai.AsyncOpenAI(
+                        **client_params
+                    ).completions
+            else:
+                values["openai_api_base"] = values["octoai_api_base"]
+                values["openai_api_key"] = values["octoai_api_token"].get_secret_value()
+                values["client"] = openai.Completion
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+
+        if "endpoint_url" in values["model_kwargs"]:
+            raise ValueError(
+                "`endpoint_url` was deprecated, please use `octoai_api_base`."
+            )
+
+        return values
diff --git a/llm/Lib/site-packages/langchain_community/llms/ollama.py b/llm/Lib/site-packages/langchain_community/llms/ollama.py
new file mode 100644
index 0000000000000000000000000000000000000000..f08fab82185348ec0a6d0d2f6dcfed4460ba82cd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/ollama.py
@@ -0,0 +1,496 @@
+import json
+from typing import Any, AsyncIterator, Dict, Iterator, List, Mapping, Optional, Union
+
+import aiohttp
+import requests
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.language_models.llms import BaseLLM
+from langchain_core.outputs import GenerationChunk, LLMResult
+from langchain_core.pydantic_v1 import Extra
+
+
+def _stream_response_to_generation_chunk(
+    stream_response: str,
+) -> GenerationChunk:
+    """Convert a stream response to a generation chunk."""
+    parsed_response = json.loads(stream_response)
+    generation_info = parsed_response if parsed_response.get("done") is True else None
+    return GenerationChunk(
+        text=parsed_response.get("response", ""), generation_info=generation_info
+    )
+
+
+class OllamaEndpointNotFoundError(Exception):
+    """Raised when the Ollama endpoint is not found."""
+
+
+class _OllamaCommon(BaseLanguageModel):
+    base_url: str = "http://localhost:11434"
+    """Base url the model is hosted under."""
+
+    model: str = "llama2"
+    """Model name to use."""
+
+    mirostat: Optional[int] = None
+    """Enable Mirostat sampling for controlling perplexity.
+    (default: 0, 0 = disabled, 1 = Mirostat, 2 = Mirostat 2.0)"""
+
+    mirostat_eta: Optional[float] = None
+    """Influences how quickly the algorithm responds to feedback
+    from the generated text. A lower learning rate will result in
+    slower adjustments, while a higher learning rate will make
+    the algorithm more responsive. (Default: 0.1)"""
+
+    mirostat_tau: Optional[float] = None
+    """Controls the balance between coherence and diversity
+    of the output. A lower value will result in more focused and
+    coherent text. (Default: 5.0)"""
+
+    num_ctx: Optional[int] = None
+    """Sets the size of the context window used to generate the
+    next token. (Default: 2048)	"""
+
+    num_gpu: Optional[int] = None
+    """The number of GPUs to use. On macOS it defaults to 1 to
+    enable metal support, 0 to disable."""
+
+    num_thread: Optional[int] = None
+    """Sets the number of threads to use during computation.
+    By default, Ollama will detect this for optimal performance.
+    It is recommended to set this value to the number of physical
+    CPU cores your system has (as opposed to the logical number of cores)."""
+
+    num_predict: Optional[int] = None
+    """Maximum number of tokens to predict when generating text.
+    (Default: 128, -1 = infinite generation, -2 = fill context)"""
+
+    repeat_last_n: Optional[int] = None
+    """Sets how far back for the model to look back to prevent
+    repetition. (Default: 64, 0 = disabled, -1 = num_ctx)"""
+
+    repeat_penalty: Optional[float] = None
+    """Sets how strongly to penalize repetitions. A higher value (e.g., 1.5)
+    will penalize repetitions more strongly, while a lower value (e.g., 0.9)
+    will be more lenient. (Default: 1.1)"""
+
+    temperature: Optional[float] = None
+    """The temperature of the model. Increasing the temperature will
+    make the model answer more creatively. (Default: 0.8)"""
+
+    stop: Optional[List[str]] = None
+    """Sets the stop tokens to use."""
+
+    tfs_z: Optional[float] = None
+    """Tail free sampling is used to reduce the impact of less probable
+    tokens from the output. A higher value (e.g., 2.0) will reduce the
+    impact more, while a value of 1.0 disables this setting. (default: 1)"""
+
+    top_k: Optional[int] = None
+    """Reduces the probability of generating nonsense. A higher value (e.g. 100)
+    will give more diverse answers, while a lower value (e.g. 10)
+    will be more conservative. (Default: 40)"""
+
+    top_p: Optional[float] = None
+    """Works together with top-k. A higher value (e.g., 0.95) will lead
+    to more diverse text, while a lower value (e.g., 0.5) will
+    generate more focused and conservative text. (Default: 0.9)"""
+
+    system: Optional[str] = None
+    """system prompt (overrides what is defined in the Modelfile)"""
+
+    template: Optional[str] = None
+    """full prompt or prompt template (overrides what is defined in the Modelfile)"""
+
+    format: Optional[str] = None
+    """Specify the format of the output (e.g., json)"""
+
+    timeout: Optional[int] = None
+    """Timeout for the request stream"""
+
+    keep_alive: Optional[Union[int, str]] = None
+    """How long the model will stay loaded into memory.
+
+    The parameter (Default: 5 minutes) can be set to:
+    1. a duration string in Golang (such as "10m" or "24h");
+    2. a number in seconds (such as 3600);
+    3. any negative number which will keep the model loaded \
+        in memory (e.g. -1 or "-1m");
+    4. 0 which will unload the model immediately after generating a response;
+
+    See the [Ollama documents](https://github.com/ollama/ollama/blob/main/docs/faq.md#how-do-i-keep-a-model-loaded-in-memory-or-make-it-unload-immediately)"""
+
+    headers: Optional[dict] = None
+    """Additional headers to pass to endpoint (e.g. Authorization, Referer).
+    This is useful when Ollama is hosted on cloud services that require
+    tokens for authentication.
+    """
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Ollama."""
+        return {
+            "model": self.model,
+            "format": self.format,
+            "options": {
+                "mirostat": self.mirostat,
+                "mirostat_eta": self.mirostat_eta,
+                "mirostat_tau": self.mirostat_tau,
+                "num_ctx": self.num_ctx,
+                "num_gpu": self.num_gpu,
+                "num_thread": self.num_thread,
+                "num_predict": self.num_predict,
+                "repeat_last_n": self.repeat_last_n,
+                "repeat_penalty": self.repeat_penalty,
+                "temperature": self.temperature,
+                "stop": self.stop,
+                "tfs_z": self.tfs_z,
+                "top_k": self.top_k,
+                "top_p": self.top_p,
+            },
+            "system": self.system,
+            "template": self.template,
+            "keep_alive": self.keep_alive,
+        }
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model": self.model, "format": self.format}, **self._default_params}
+
+    def _create_generate_stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        images: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Iterator[str]:
+        payload = {"prompt": prompt, "images": images}
+        yield from self._create_stream(
+            payload=payload,
+            stop=stop,
+            api_url=f"{self.base_url}/api/generate",
+            **kwargs,
+        )
+
+    async def _acreate_generate_stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        images: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[str]:
+        payload = {"prompt": prompt, "images": images}
+        async for item in self._acreate_stream(
+            payload=payload,
+            stop=stop,
+            api_url=f"{self.base_url}/api/generate",
+            **kwargs,
+        ):
+            yield item
+
+    def _create_stream(
+        self,
+        api_url: str,
+        payload: Any,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Iterator[str]:
+        if self.stop is not None and stop is not None:
+            raise ValueError("`stop` found in both the input and default params.")
+        elif self.stop is not None:
+            stop = self.stop
+
+        params = self._default_params
+
+        for key in self._default_params:
+            if key in kwargs:
+                params[key] = kwargs[key]
+
+        if "options" in kwargs:
+            params["options"] = kwargs["options"]
+        else:
+            params["options"] = {
+                **params["options"],
+                "stop": stop,
+                **{k: v for k, v in kwargs.items() if k not in self._default_params},
+            }
+
+        if payload.get("messages"):
+            request_payload = {"messages": payload.get("messages", []), **params}
+        else:
+            request_payload = {
+                "prompt": payload.get("prompt"),
+                "images": payload.get("images", []),
+                **params,
+            }
+
+        response = requests.post(
+            url=api_url,
+            headers={
+                "Content-Type": "application/json",
+                **(self.headers if isinstance(self.headers, dict) else {}),
+            },
+            json=request_payload,
+            stream=True,
+            timeout=self.timeout,
+        )
+        response.encoding = "utf-8"
+        if response.status_code != 200:
+            if response.status_code == 404:
+                raise OllamaEndpointNotFoundError(
+                    "Ollama call failed with status code 404. "
+                    "Maybe your model is not found "
+                    f"and you should pull the model with `ollama pull {self.model}`."
+                )
+            else:
+                optional_detail = response.text
+                raise ValueError(
+                    f"Ollama call failed with status code {response.status_code}."
+                    f" Details: {optional_detail}"
+                )
+        return response.iter_lines(decode_unicode=True)
+
+    async def _acreate_stream(
+        self,
+        api_url: str,
+        payload: Any,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[str]:
+        if self.stop is not None and stop is not None:
+            raise ValueError("`stop` found in both the input and default params.")
+        elif self.stop is not None:
+            stop = self.stop
+
+        params = self._default_params
+
+        for key in self._default_params:
+            if key in kwargs:
+                params[key] = kwargs[key]
+
+        if "options" in kwargs:
+            params["options"] = kwargs["options"]
+        else:
+            params["options"] = {
+                **params["options"],
+                "stop": stop,
+                **{k: v for k, v in kwargs.items() if k not in self._default_params},
+            }
+
+        if payload.get("messages"):
+            request_payload = {"messages": payload.get("messages", []), **params}
+        else:
+            request_payload = {
+                "prompt": payload.get("prompt"),
+                "images": payload.get("images", []),
+                **params,
+            }
+
+        async with aiohttp.ClientSession() as session:
+            async with session.post(
+                url=api_url,
+                headers={
+                    "Content-Type": "application/json",
+                    **(self.headers if isinstance(self.headers, dict) else {}),
+                },
+                json=request_payload,
+                timeout=self.timeout,
+            ) as response:
+                if response.status != 200:
+                    if response.status == 404:
+                        raise OllamaEndpointNotFoundError(
+                            "Ollama call failed with status code 404."
+                        )
+                    else:
+                        optional_detail = response.text
+                        raise ValueError(
+                            f"Ollama call failed with status code {response.status}."
+                            f" Details: {optional_detail}"
+                        )
+                async for line in response.content:
+                    yield line.decode("utf-8")
+
+    def _stream_with_aggregation(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        verbose: bool = False,
+        **kwargs: Any,
+    ) -> GenerationChunk:
+        final_chunk: Optional[GenerationChunk] = None
+        for stream_resp in self._create_generate_stream(prompt, stop, **kwargs):
+            if stream_resp:
+                chunk = _stream_response_to_generation_chunk(stream_resp)
+                if final_chunk is None:
+                    final_chunk = chunk
+                else:
+                    final_chunk += chunk
+                if run_manager:
+                    run_manager.on_llm_new_token(
+                        chunk.text,
+                        verbose=verbose,
+                    )
+        if final_chunk is None:
+            raise ValueError("No data received from Ollama stream.")
+
+        return final_chunk
+
+    async def _astream_with_aggregation(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        verbose: bool = False,
+        **kwargs: Any,
+    ) -> GenerationChunk:
+        final_chunk: Optional[GenerationChunk] = None
+        async for stream_resp in self._acreate_generate_stream(prompt, stop, **kwargs):
+            if stream_resp:
+                chunk = _stream_response_to_generation_chunk(stream_resp)
+                if final_chunk is None:
+                    final_chunk = chunk
+                else:
+                    final_chunk += chunk
+                if run_manager:
+                    await run_manager.on_llm_new_token(
+                        chunk.text,
+                        verbose=verbose,
+                    )
+        if final_chunk is None:
+            raise ValueError("No data received from Ollama stream.")
+
+        return final_chunk
+
+
+class Ollama(BaseLLM, _OllamaCommon):
+    """Ollama locally runs large language models.
+
+    To use, follow the instructions at https://ollama.ai/.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Ollama
+            ollama = Ollama(model="llama2")
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "ollama-llm"
+
+    def _generate(  # type: ignore[override]
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        images: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Call out to Ollama's generate endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = ollama("Tell me a joke.")
+        """
+        # TODO: add caching here.
+        generations = []
+        for prompt in prompts:
+            final_chunk = super()._stream_with_aggregation(
+                prompt,
+                stop=stop,
+                images=images,
+                run_manager=run_manager,
+                verbose=self.verbose,
+                **kwargs,
+            )
+            generations.append([final_chunk])
+        return LLMResult(generations=generations)
+
+    async def _agenerate(  # type: ignore[override]
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        images: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Call out to Ollama's generate endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = ollama("Tell me a joke.")
+        """
+        # TODO: add caching here.
+        generations = []
+        for prompt in prompts:
+            final_chunk = await super()._astream_with_aggregation(
+                prompt,
+                stop=stop,
+                images=images,
+                run_manager=run_manager,  # type: ignore[arg-type]
+                verbose=self.verbose,
+                **kwargs,
+            )
+            generations.append([final_chunk])
+        return LLMResult(generations=generations)
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        for stream_resp in self._create_generate_stream(prompt, stop, **kwargs):
+            if stream_resp:
+                chunk = _stream_response_to_generation_chunk(stream_resp)
+                if run_manager:
+                    run_manager.on_llm_new_token(
+                        chunk.text,
+                        verbose=self.verbose,
+                    )
+                yield chunk
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        async for stream_resp in self._acreate_generate_stream(prompt, stop, **kwargs):
+            if stream_resp:
+                chunk = _stream_response_to_generation_chunk(stream_resp)
+                if run_manager:
+                    await run_manager.on_llm_new_token(
+                        chunk.text,
+                        verbose=self.verbose,
+                    )
+                yield chunk
diff --git a/llm/Lib/site-packages/langchain_community/llms/opaqueprompts.py b/llm/Lib/site-packages/langchain_community/llms/opaqueprompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..0fbc801aaeb1231397fc41c9bb5a68aedd542961
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/opaqueprompts.py
@@ -0,0 +1,118 @@
+import logging
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.language_models.llms import LLM
+from langchain_core.messages import AIMessage
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+class OpaquePrompts(LLM):
+    """LLM that uses OpaquePrompts to sanitize prompts.
+
+    Wraps another LLM and sanitizes prompts before passing it to the LLM, then
+        de-sanitizes the response.
+
+    To use, you should have the ``opaqueprompts`` python package installed,
+    and the environment variable ``OPAQUEPROMPTS_API_KEY`` set with
+    your API key, or pass it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import OpaquePrompts
+            from langchain_community.chat_models import ChatOpenAI
+
+            op_llm = OpaquePrompts(base_llm=ChatOpenAI())
+    """
+
+    base_llm: BaseLanguageModel
+    """The base LLM to use."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validates that the OpaquePrompts API key and the Python package exist."""
+        try:
+            import opaqueprompts as op
+        except ImportError:
+            raise ImportError(
+                "Could not import the `opaqueprompts` Python package, "
+                "please install it with `pip install opaqueprompts`."
+            )
+        if op.__package__ is None:
+            raise ValueError(
+                "Could not properly import `opaqueprompts`, "
+                "opaqueprompts.__package__ is None."
+            )
+
+        api_key = get_from_dict_or_env(
+            values, "opaqueprompts_api_key", "OPAQUEPROMPTS_API_KEY", default=""
+        )
+        if not api_key:
+            raise ValueError(
+                "Could not find OPAQUEPROMPTS_API_KEY in the environment. "
+                "Please set it to your OpaquePrompts API key."
+                "You can get it by creating an account on the OpaquePrompts website: "
+                "https://opaqueprompts.opaque.co/ ."
+            )
+        return values
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call base LLM with sanitization before and de-sanitization after.
+
+        Args:
+            prompt: The prompt to pass into the model.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = op_llm("Tell me a joke.")
+        """
+        import opaqueprompts as op
+
+        _run_manager = run_manager or CallbackManagerForLLMRun.get_noop_manager()
+
+        # sanitize the prompt by replacing the sensitive information with a placeholder
+        sanitize_response: op.SanitizeResponse = op.sanitize([prompt])
+        sanitized_prompt_value_str = sanitize_response.sanitized_texts[0]
+
+        # TODO: Add in callbacks once child runs for LLMs are supported by LangSmith.
+        # call the LLM with the sanitized prompt and get the response
+        llm_response = self.base_llm.bind(stop=stop).invoke(
+            sanitized_prompt_value_str,
+        )
+        if isinstance(llm_response, AIMessage):
+            llm_response = llm_response.content
+
+        # desanitize the response by restoring the original sensitive information
+        desanitize_response: op.DesanitizeResponse = op.desanitize(
+            llm_response,
+            secure_context=sanitize_response.secure_context,
+        )
+        return desanitize_response.desanitized_text
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of LLM.
+
+        This is an override of the base class method.
+        """
+        return "opaqueprompts"
diff --git a/llm/Lib/site-packages/langchain_community/llms/openai.py b/llm/Lib/site-packages/langchain_community/llms/openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..56ca15dda74b0ed54af363878fce35a40bcdff5c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/openai.py
@@ -0,0 +1,1239 @@
+from __future__ import annotations
+
+import logging
+import os
+import sys
+import warnings
+from typing import (
+    AbstractSet,
+    Any,
+    AsyncIterator,
+    Callable,
+    Collection,
+    Dict,
+    Iterator,
+    List,
+    Literal,
+    Mapping,
+    Optional,
+    Set,
+    Tuple,
+    Union,
+)
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import BaseLLM, create_base_retry_decorator
+from langchain_core.outputs import Generation, GenerationChunk, LLMResult
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import get_from_dict_or_env, get_pydantic_field_names
+from langchain_core.utils.utils import build_extra_kwargs
+
+from langchain_community.utils.openai import is_openai_v1
+
+logger = logging.getLogger(__name__)
+
+
+def update_token_usage(
+    keys: Set[str], response: Dict[str, Any], token_usage: Dict[str, Any]
+) -> None:
+    """Update token usage."""
+    _keys_to_use = keys.intersection(response["usage"])
+    for _key in _keys_to_use:
+        if _key not in token_usage:
+            token_usage[_key] = response["usage"][_key]
+        else:
+            token_usage[_key] += response["usage"][_key]
+
+
+def _stream_response_to_generation_chunk(
+    stream_response: Dict[str, Any],
+) -> GenerationChunk:
+    """Convert a stream response to a generation chunk."""
+    if not stream_response["choices"]:
+        return GenerationChunk(text="")
+    return GenerationChunk(
+        text=stream_response["choices"][0]["text"],
+        generation_info=dict(
+            finish_reason=stream_response["choices"][0].get("finish_reason", None),
+            logprobs=stream_response["choices"][0].get("logprobs", None),
+        ),
+    )
+
+
+def _update_response(response: Dict[str, Any], stream_response: Dict[str, Any]) -> None:
+    """Update response from the stream response."""
+    response["choices"][0]["text"] += stream_response["choices"][0]["text"]
+    response["choices"][0]["finish_reason"] = stream_response["choices"][0].get(
+        "finish_reason", None
+    )
+    response["choices"][0]["logprobs"] = stream_response["choices"][0]["logprobs"]
+
+
+def _streaming_response_template() -> Dict[str, Any]:
+    return {
+        "choices": [
+            {
+                "text": "",
+                "finish_reason": None,
+                "logprobs": None,
+            }
+        ]
+    }
+
+
+def _create_retry_decorator(
+    llm: Union[BaseOpenAI, OpenAIChat],
+    run_manager: Optional[
+        Union[AsyncCallbackManagerForLLMRun, CallbackManagerForLLMRun]
+    ] = None,
+) -> Callable[[Any], Any]:
+    import openai
+
+    errors = [
+        openai.error.Timeout,
+        openai.error.APIError,
+        openai.error.APIConnectionError,
+        openai.error.RateLimitError,
+        openai.error.ServiceUnavailableError,
+    ]
+    return create_base_retry_decorator(
+        error_types=errors, max_retries=llm.max_retries, run_manager=run_manager
+    )
+
+
+def completion_with_retry(
+    llm: Union[BaseOpenAI, OpenAIChat],
+    run_manager: Optional[CallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the completion call."""
+    if is_openai_v1():
+        return llm.client.create(**kwargs)
+
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @retry_decorator
+    def _completion_with_retry(**kwargs: Any) -> Any:
+        return llm.client.create(**kwargs)
+
+    return _completion_with_retry(**kwargs)
+
+
+async def acompletion_with_retry(
+    llm: Union[BaseOpenAI, OpenAIChat],
+    run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the async completion call."""
+    if is_openai_v1():
+        return await llm.async_client.create(**kwargs)
+
+    retry_decorator = _create_retry_decorator(llm, run_manager=run_manager)
+
+    @retry_decorator
+    async def _completion_with_retry(**kwargs: Any) -> Any:
+        # Use OpenAI's async api https://github.com/openai/openai-python#async-api
+        return await llm.client.acreate(**kwargs)
+
+    return await _completion_with_retry(**kwargs)
+
+
+class BaseOpenAI(BaseLLM):
+    """Base OpenAI large language model class."""
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"openai_api_key": "OPENAI_API_KEY"}
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "llms", "openai"]
+
+    @property
+    def lc_attributes(self) -> Dict[str, Any]:
+        attributes: Dict[str, Any] = {}
+        if self.openai_api_base:
+            attributes["openai_api_base"] = self.openai_api_base
+
+        if self.openai_organization:
+            attributes["openai_organization"] = self.openai_organization
+
+        if self.openai_proxy:
+            attributes["openai_proxy"] = self.openai_proxy
+
+        return attributes
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    client: Any = Field(default=None, exclude=True)  #: :meta private:
+    async_client: Any = Field(default=None, exclude=True)  #: :meta private:
+    model_name: str = Field(default="gpt-3.5-turbo-instruct", alias="model")
+    """Model name to use."""
+    temperature: float = 0.7
+    """What sampling temperature to use."""
+    max_tokens: int = 256
+    """The maximum number of tokens to generate in the completion.
+    -1 returns as many tokens as possible given the prompt and
+    the models maximal context size."""
+    top_p: float = 1
+    """Total probability mass of tokens to consider at each step."""
+    frequency_penalty: float = 0
+    """Penalizes repeated tokens according to frequency."""
+    presence_penalty: float = 0
+    """Penalizes repeated tokens."""
+    n: int = 1
+    """How many completions to generate for each prompt."""
+    best_of: int = 1
+    """Generates best_of completions server-side and returns the "best"."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not explicitly specified."""
+    # When updating this to use a SecretStr
+    # Check for classes that derive from this class (as some of them
+    # may assume openai_api_key is a str)
+    openai_api_key: Optional[str] = Field(default=None, alias="api_key")
+    """Automatically inferred from env var `OPENAI_API_KEY` if not provided."""
+    openai_api_base: Optional[str] = Field(default=None, alias="base_url")
+    """Base URL path for API requests, leave blank if not using a proxy or service 
+        emulator."""
+    openai_organization: Optional[str] = Field(default=None, alias="organization")
+    """Automatically inferred from env var `OPENAI_ORG_ID` if not provided."""
+    # to support explicit proxy for OpenAI
+    openai_proxy: Optional[str] = None
+    batch_size: int = 20
+    """Batch size to use when passing multiple documents to generate."""
+    request_timeout: Union[float, Tuple[float, float], Any, None] = Field(
+        default=None, alias="timeout"
+    )
+    """Timeout for requests to OpenAI completion API. Can be float, httpx.Timeout or 
+        None."""
+    logit_bias: Optional[Dict[str, float]] = Field(default_factory=dict)
+    """Adjust the probability of specific tokens being generated."""
+    max_retries: int = 2
+    """Maximum number of retries to make when generating."""
+    streaming: bool = False
+    """Whether to stream the results or not."""
+    allowed_special: Union[Literal["all"], AbstractSet[str]] = set()
+    """Set of special tokens that are allowed。"""
+    disallowed_special: Union[Literal["all"], Collection[str]] = "all"
+    """Set of special tokens that are not allowed。"""
+    tiktoken_model_name: Optional[str] = None
+    """The model name to pass to tiktoken when using this class. 
+    Tiktoken is used to count the number of tokens in documents to constrain 
+    them to be under a certain limit. By default, when set to None, this will 
+    be the same as the embedding model name. However, there are some cases 
+    where you may want to use this Embedding class with a model name not 
+    supported by tiktoken. This can include when using Azure embeddings or 
+    when using one of the many model providers that expose an OpenAI-like 
+    API but with different models. In those cases, in order to avoid erroring 
+    when tiktoken is called, you can specify a model name to use here."""
+    default_headers: Union[Mapping[str, str], None] = None
+    default_query: Union[Mapping[str, object], None] = None
+    # Configure a custom httpx client. See the
+    # [httpx documentation](https://www.python-httpx.org/api/#client) for more details.
+    http_client: Union[Any, None] = None
+    """Optional httpx.Client."""
+
+    def __new__(cls, **data: Any) -> Union[OpenAIChat, BaseOpenAI]:  # type: ignore
+        """Initialize the OpenAI object."""
+        model_name = data.get("model_name", "")
+        if (
+            model_name.startswith("gpt-3.5-turbo") or model_name.startswith("gpt-4")
+        ) and "-instruct" not in model_name:
+            warnings.warn(
+                "You are trying to use a chat model. This way of initializing it is "
+                "no longer supported. Instead, please use: "
+                "`from langchain_community.chat_models import ChatOpenAI`"
+            )
+            return OpenAIChat(**data)
+        return super().__new__(cls)
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        allow_population_by_field_name = True
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        values["model_kwargs"] = build_extra_kwargs(
+            extra, values, all_required_field_names
+        )
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        if values["n"] < 1:
+            raise ValueError("n must be at least 1.")
+        if values["streaming"] and values["n"] > 1:
+            raise ValueError("Cannot stream results when n > 1.")
+        if values["streaming"] and values["best_of"] > 1:
+            raise ValueError("Cannot stream results when best_of > 1.")
+
+        values["openai_api_key"] = get_from_dict_or_env(
+            values, "openai_api_key", "OPENAI_API_KEY"
+        )
+        values["openai_api_base"] = values["openai_api_base"] or os.getenv(
+            "OPENAI_API_BASE"
+        )
+        values["openai_proxy"] = get_from_dict_or_env(
+            values,
+            "openai_proxy",
+            "OPENAI_PROXY",
+            default="",
+        )
+        values["openai_organization"] = (
+            values["openai_organization"]
+            or os.getenv("OPENAI_ORG_ID")
+            or os.getenv("OPENAI_ORGANIZATION")
+        )
+        try:
+            import openai
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+
+        if is_openai_v1():
+            client_params = {
+                "api_key": values["openai_api_key"],
+                "organization": values["openai_organization"],
+                "base_url": values["openai_api_base"],
+                "timeout": values["request_timeout"],
+                "max_retries": values["max_retries"],
+                "default_headers": values["default_headers"],
+                "default_query": values["default_query"],
+                "http_client": values["http_client"],
+            }
+            if not values.get("client"):
+                values["client"] = openai.OpenAI(**client_params).completions
+            if not values.get("async_client"):
+                values["async_client"] = openai.AsyncOpenAI(**client_params).completions
+        elif not values.get("client"):
+            values["client"] = openai.Completion
+        else:
+            pass
+
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling OpenAI API."""
+        normal_params: Dict[str, Any] = {
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            "frequency_penalty": self.frequency_penalty,
+            "presence_penalty": self.presence_penalty,
+            "n": self.n,
+            "logit_bias": self.logit_bias,
+        }
+
+        if self.max_tokens is not None:
+            normal_params["max_tokens"] = self.max_tokens
+        if self.request_timeout is not None and not is_openai_v1():
+            normal_params["request_timeout"] = self.request_timeout
+
+        # Azure gpt-35-turbo doesn't support best_of
+        # don't specify best_of if it is 1
+        if self.best_of > 1:
+            normal_params["best_of"] = self.best_of
+
+        return {**normal_params, **self.model_kwargs}
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        params = {**self._invocation_params, **kwargs, "stream": True}
+        self.get_sub_prompts(params, [prompt], stop)  # this mutates params
+        for stream_resp in completion_with_retry(
+            self, prompt=prompt, run_manager=run_manager, **params
+        ):
+            if not isinstance(stream_resp, dict):
+                stream_resp = stream_resp.dict()
+            chunk = _stream_response_to_generation_chunk(stream_resp)
+            if run_manager:
+                run_manager.on_llm_new_token(
+                    chunk.text,
+                    chunk=chunk,
+                    verbose=self.verbose,
+                    logprobs=chunk.generation_info["logprobs"]
+                    if chunk.generation_info
+                    else None,
+                )
+            yield chunk
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        params = {**self._invocation_params, **kwargs, "stream": True}
+        self.get_sub_prompts(params, [prompt], stop)  # this mutates params
+        async for stream_resp in await acompletion_with_retry(
+            self, prompt=prompt, run_manager=run_manager, **params
+        ):
+            if not isinstance(stream_resp, dict):
+                stream_resp = stream_resp.dict()
+            chunk = _stream_response_to_generation_chunk(stream_resp)
+            if run_manager:
+                await run_manager.on_llm_new_token(
+                    chunk.text,
+                    chunk=chunk,
+                    verbose=self.verbose,
+                    logprobs=chunk.generation_info["logprobs"]
+                    if chunk.generation_info
+                    else None,
+                )
+            yield chunk
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Call out to OpenAI's endpoint with k unique prompts.
+
+        Args:
+            prompts: The prompts to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The full LLM output.
+
+        Example:
+            .. code-block:: python
+
+                response = openai.generate(["Tell me a joke."])
+        """
+        # TODO: write a unit test for this
+        params = self._invocation_params
+        params = {**params, **kwargs}
+        sub_prompts = self.get_sub_prompts(params, prompts, stop)
+        choices = []
+        token_usage: Dict[str, int] = {}
+        # Get the token usage from the response.
+        # Includes prompt, completion, and total tokens used.
+        _keys = {"completion_tokens", "prompt_tokens", "total_tokens"}
+        system_fingerprint: Optional[str] = None
+        for _prompts in sub_prompts:
+            if self.streaming:
+                if len(_prompts) > 1:
+                    raise ValueError("Cannot stream results with multiple prompts.")
+
+                generation: Optional[GenerationChunk] = None
+                for chunk in self._stream(_prompts[0], stop, run_manager, **kwargs):
+                    if generation is None:
+                        generation = chunk
+                    else:
+                        generation += chunk
+                assert generation is not None
+                choices.append(
+                    {
+                        "text": generation.text,
+                        "finish_reason": generation.generation_info.get("finish_reason")
+                        if generation.generation_info
+                        else None,
+                        "logprobs": generation.generation_info.get("logprobs")
+                        if generation.generation_info
+                        else None,
+                    }
+                )
+            else:
+                response = completion_with_retry(
+                    self, prompt=_prompts, run_manager=run_manager, **params
+                )
+                if not isinstance(response, dict):
+                    # V1 client returns the response in an PyDantic object instead of
+                    # dict. For the transition period, we deep convert it to dict.
+                    response = response.dict()
+
+                choices.extend(response["choices"])
+                update_token_usage(_keys, response, token_usage)
+                if not system_fingerprint:
+                    system_fingerprint = response.get("system_fingerprint")
+        return self.create_llm_result(
+            choices,
+            prompts,
+            params,
+            token_usage,
+            system_fingerprint=system_fingerprint,
+        )
+
+    async def _agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Call out to OpenAI's endpoint async with k unique prompts."""
+        params = self._invocation_params
+        params = {**params, **kwargs}
+        sub_prompts = self.get_sub_prompts(params, prompts, stop)
+        choices = []
+        token_usage: Dict[str, int] = {}
+        # Get the token usage from the response.
+        # Includes prompt, completion, and total tokens used.
+        _keys = {"completion_tokens", "prompt_tokens", "total_tokens"}
+        system_fingerprint: Optional[str] = None
+        for _prompts in sub_prompts:
+            if self.streaming:
+                if len(_prompts) > 1:
+                    raise ValueError("Cannot stream results with multiple prompts.")
+
+                generation: Optional[GenerationChunk] = None
+                async for chunk in self._astream(
+                    _prompts[0], stop, run_manager, **kwargs
+                ):
+                    if generation is None:
+                        generation = chunk
+                    else:
+                        generation += chunk
+                assert generation is not None
+                choices.append(
+                    {
+                        "text": generation.text,
+                        "finish_reason": generation.generation_info.get("finish_reason")
+                        if generation.generation_info
+                        else None,
+                        "logprobs": generation.generation_info.get("logprobs")
+                        if generation.generation_info
+                        else None,
+                    }
+                )
+            else:
+                response = await acompletion_with_retry(
+                    self, prompt=_prompts, run_manager=run_manager, **params
+                )
+                if not isinstance(response, dict):
+                    response = response.dict()
+                choices.extend(response["choices"])
+                update_token_usage(_keys, response, token_usage)
+        return self.create_llm_result(
+            choices,
+            prompts,
+            params,
+            token_usage,
+            system_fingerprint=system_fingerprint,
+        )
+
+    def get_sub_prompts(
+        self,
+        params: Dict[str, Any],
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+    ) -> List[List[str]]:
+        """Get the sub prompts for llm call."""
+        if stop is not None:
+            if "stop" in params:
+                raise ValueError("`stop` found in both the input and default params.")
+            params["stop"] = stop
+        if params["max_tokens"] == -1:
+            if len(prompts) != 1:
+                raise ValueError(
+                    "max_tokens set to -1 not supported for multiple inputs."
+                )
+            params["max_tokens"] = self.max_tokens_for_prompt(prompts[0])
+        sub_prompts = [
+            prompts[i : i + self.batch_size]
+            for i in range(0, len(prompts), self.batch_size)
+        ]
+        return sub_prompts
+
+    def create_llm_result(
+        self,
+        choices: Any,
+        prompts: List[str],
+        params: Dict[str, Any],
+        token_usage: Dict[str, int],
+        *,
+        system_fingerprint: Optional[str] = None,
+    ) -> LLMResult:
+        """Create the LLMResult from the choices and prompts."""
+        generations = []
+        n = params.get("n", self.n)
+        for i, _ in enumerate(prompts):
+            sub_choices = choices[i * n : (i + 1) * n]
+            generations.append(
+                [
+                    Generation(
+                        text=choice["text"],
+                        generation_info=dict(
+                            finish_reason=choice.get("finish_reason"),
+                            logprobs=choice.get("logprobs"),
+                        ),
+                    )
+                    for choice in sub_choices
+                ]
+            )
+        llm_output = {"token_usage": token_usage, "model_name": self.model_name}
+        if system_fingerprint:
+            llm_output["system_fingerprint"] = system_fingerprint
+        return LLMResult(generations=generations, llm_output=llm_output)
+
+    @property
+    def _invocation_params(self) -> Dict[str, Any]:
+        """Get the parameters used to invoke the model."""
+        openai_creds: Dict[str, Any] = {}
+        if not is_openai_v1():
+            openai_creds.update(
+                {
+                    "api_key": self.openai_api_key,
+                    "api_base": self.openai_api_base,
+                    "organization": self.openai_organization,
+                }
+            )
+        if self.openai_proxy:
+            import openai
+
+            openai.proxy = {"http": self.openai_proxy, "https": self.openai_proxy}  # type: ignore[assignment]  # noqa: E501
+        return {**openai_creds, **self._default_params}
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model_name": self.model_name}, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "openai"
+
+    def get_token_ids(self, text: str) -> List[int]:
+        """Get the token IDs using the tiktoken package."""
+        # tiktoken NOT supported for Python < 3.8
+        if sys.version_info[1] < 8:
+            return super().get_num_tokens(text)
+        try:
+            import tiktoken
+        except ImportError:
+            raise ImportError(
+                "Could not import tiktoken python package. "
+                "This is needed in order to calculate get_num_tokens. "
+                "Please install it with `pip install tiktoken`."
+            )
+
+        model_name = self.tiktoken_model_name or self.model_name
+        try:
+            enc = tiktoken.encoding_for_model(model_name)
+        except KeyError:
+            logger.warning("Warning: model not found. Using cl100k_base encoding.")
+            model = "cl100k_base"
+            enc = tiktoken.get_encoding(model)
+
+        return enc.encode(
+            text,
+            allowed_special=self.allowed_special,
+            disallowed_special=self.disallowed_special,
+        )
+
+    @staticmethod
+    def modelname_to_contextsize(modelname: str) -> int:
+        """Calculate the maximum number of tokens possible to generate for a model.
+
+        Args:
+            modelname: The modelname we want to know the context size for.
+
+        Returns:
+            The maximum context size
+
+        Example:
+            .. code-block:: python
+
+                max_tokens = openai.modelname_to_contextsize("gpt-3.5-turbo-instruct")
+        """
+        model_token_mapping = {
+            "gpt-4": 8192,
+            "gpt-4-0314": 8192,
+            "gpt-4-0613": 8192,
+            "gpt-4-32k": 32768,
+            "gpt-4-32k-0314": 32768,
+            "gpt-4-32k-0613": 32768,
+            "gpt-3.5-turbo": 4096,
+            "gpt-3.5-turbo-0301": 4096,
+            "gpt-3.5-turbo-0613": 4096,
+            "gpt-3.5-turbo-16k": 16385,
+            "gpt-3.5-turbo-16k-0613": 16385,
+            "gpt-3.5-turbo-instruct": 4096,
+            "text-ada-001": 2049,
+            "ada": 2049,
+            "text-babbage-001": 2040,
+            "babbage": 2049,
+            "text-curie-001": 2049,
+            "curie": 2049,
+            "davinci": 2049,
+            "text-davinci-003": 4097,
+            "text-davinci-002": 4097,
+            "code-davinci-002": 8001,
+            "code-davinci-001": 8001,
+            "code-cushman-002": 2048,
+            "code-cushman-001": 2048,
+        }
+
+        # handling finetuned models
+        if "ft-" in modelname:
+            modelname = modelname.split(":")[0]
+
+        context_size = model_token_mapping.get(modelname, None)
+
+        if context_size is None:
+            raise ValueError(
+                f"Unknown model: {modelname}. Please provide a valid OpenAI model name."
+                "Known models are: " + ", ".join(model_token_mapping.keys())
+            )
+
+        return context_size
+
+    @property
+    def max_context_size(self) -> int:
+        """Get max context size for this model."""
+        return self.modelname_to_contextsize(self.model_name)
+
+    def max_tokens_for_prompt(self, prompt: str) -> int:
+        """Calculate the maximum number of tokens possible to generate for a prompt.
+
+        Args:
+            prompt: The prompt to pass into the model.
+
+        Returns:
+            The maximum number of tokens to generate for a prompt.
+
+        Example:
+            .. code-block:: python
+
+                max_tokens = openai.max_token_for_prompt("Tell me a joke.")
+        """
+        num_tokens = self.get_num_tokens(prompt)
+        return self.max_context_size - num_tokens
+
+
+@deprecated(
+    since="0.0.10", removal="0.2.0", alternative_import="langchain_openai.OpenAI"
+)
+class OpenAI(BaseOpenAI):
+    """OpenAI large language models.
+
+    To use, you should have the ``openai`` python package installed, and the
+    environment variable ``OPENAI_API_KEY`` set with your API key.
+
+    Any parameters that are valid to be passed to the openai.create call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import OpenAI
+            openai = OpenAI(model_name="gpt-3.5-turbo-instruct")
+    """
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "llms", "openai"]
+
+    @property
+    def _invocation_params(self) -> Dict[str, Any]:
+        return {**{"model": self.model_name}, **super()._invocation_params}
+
+
+@deprecated(
+    since="0.0.10", removal="0.2.0", alternative_import="langchain_openai.AzureOpenAI"
+)
+class AzureOpenAI(BaseOpenAI):
+    """Azure-specific OpenAI large language models.
+
+    To use, you should have the ``openai`` python package installed, and the
+    environment variable ``OPENAI_API_KEY`` set with your API key.
+
+    Any parameters that are valid to be passed to the openai.create call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import AzureOpenAI
+
+            openai = AzureOpenAI(model_name="gpt-3.5-turbo-instruct")
+    """
+
+    azure_endpoint: Union[str, None] = None
+    """Your Azure endpoint, including the resource.
+
+        Automatically inferred from env var `AZURE_OPENAI_ENDPOINT` if not provided.
+
+        Example: `https://example-resource.azure.openai.com/`
+    """
+    deployment_name: Union[str, None] = Field(default=None, alias="azure_deployment")
+    """A model deployment. 
+
+        If given sets the base client URL to include `/deployments/{azure_deployment}`.
+        Note: this means you won't be able to use non-deployment endpoints.
+    """
+    openai_api_version: str = Field(default="", alias="api_version")
+    """Automatically inferred from env var `OPENAI_API_VERSION` if not provided."""
+    openai_api_key: Union[str, None] = Field(default=None, alias="api_key")
+    """Automatically inferred from env var `AZURE_OPENAI_API_KEY` if not provided."""
+    azure_ad_token: Union[str, None] = None
+    """Your Azure Active Directory token.
+
+        Automatically inferred from env var `AZURE_OPENAI_AD_TOKEN` if not provided.
+
+        For more: 
+        https://www.microsoft.com/en-us/security/business/identity-access/microsoft-entra-id.
+    """  # noqa: E501
+    azure_ad_token_provider: Union[Callable[[], str], None] = None
+    """A function that returns an Azure Active Directory token.
+
+        Will be invoked on every request.
+    """
+    openai_api_type: str = ""
+    """Legacy, for openai<1.0.0 support."""
+    validate_base_url: bool = True
+    """For backwards compatibility. If legacy val openai_api_base is passed in, try to 
+        infer if it is a base_url or azure_endpoint and update accordingly.
+    """
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "llms", "openai"]
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        if values["n"] < 1:
+            raise ValueError("n must be at least 1.")
+        if values["streaming"] and values["n"] > 1:
+            raise ValueError("Cannot stream results when n > 1.")
+        if values["streaming"] and values["best_of"] > 1:
+            raise ValueError("Cannot stream results when best_of > 1.")
+
+        # Check OPENAI_KEY for backwards compatibility.
+        # TODO: Remove OPENAI_API_KEY support to avoid possible conflict when using
+        # other forms of azure credentials.
+        values["openai_api_key"] = (
+            values["openai_api_key"]
+            or os.getenv("AZURE_OPENAI_API_KEY")
+            or os.getenv("OPENAI_API_KEY")
+        )
+
+        values["azure_endpoint"] = values["azure_endpoint"] or os.getenv(
+            "AZURE_OPENAI_ENDPOINT"
+        )
+        values["azure_ad_token"] = values["azure_ad_token"] or os.getenv(
+            "AZURE_OPENAI_AD_TOKEN"
+        )
+        values["openai_api_base"] = values["openai_api_base"] or os.getenv(
+            "OPENAI_API_BASE"
+        )
+        values["openai_proxy"] = get_from_dict_or_env(
+            values,
+            "openai_proxy",
+            "OPENAI_PROXY",
+            default="",
+        )
+        values["openai_organization"] = (
+            values["openai_organization"]
+            or os.getenv("OPENAI_ORG_ID")
+            or os.getenv("OPENAI_ORGANIZATION")
+        )
+        values["openai_api_version"] = values["openai_api_version"] or os.getenv(
+            "OPENAI_API_VERSION"
+        )
+        values["openai_api_type"] = get_from_dict_or_env(
+            values, "openai_api_type", "OPENAI_API_TYPE", default="azure"
+        )
+        try:
+            import openai
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+        if is_openai_v1():
+            # For backwards compatibility. Before openai v1, no distinction was made
+            # between azure_endpoint and base_url (openai_api_base).
+            openai_api_base = values["openai_api_base"]
+            if openai_api_base and values["validate_base_url"]:
+                if "/openai" not in openai_api_base:
+                    values["openai_api_base"] = (
+                        values["openai_api_base"].rstrip("/") + "/openai"
+                    )
+                    warnings.warn(
+                        "As of openai>=1.0.0, Azure endpoints should be specified via "
+                        f"the `azure_endpoint` param not `openai_api_base` "
+                        f"(or alias `base_url`). Updating `openai_api_base` from "
+                        f"{openai_api_base} to {values['openai_api_base']}."
+                    )
+                if values["deployment_name"]:
+                    warnings.warn(
+                        "As of openai>=1.0.0, if `deployment_name` (or alias "
+                        "`azure_deployment`) is specified then "
+                        "`openai_api_base` (or alias `base_url`) should not be. "
+                        "Instead use `deployment_name` (or alias `azure_deployment`) "
+                        "and `azure_endpoint`."
+                    )
+                    if values["deployment_name"] not in values["openai_api_base"]:
+                        warnings.warn(
+                            "As of openai>=1.0.0, if `openai_api_base` "
+                            "(or alias `base_url`) is specified it is expected to be "
+                            "of the form "
+                            "https://example-resource.azure.openai.com/openai/deployments/example-deployment. "  # noqa: E501
+                            f"Updating {openai_api_base} to "
+                            f"{values['openai_api_base']}."
+                        )
+                        values["openai_api_base"] += (
+                            "/deployments/" + values["deployment_name"]
+                        )
+                    values["deployment_name"] = None
+            client_params = {
+                "api_version": values["openai_api_version"],
+                "azure_endpoint": values["azure_endpoint"],
+                "azure_deployment": values["deployment_name"],
+                "api_key": values["openai_api_key"],
+                "azure_ad_token": values["azure_ad_token"],
+                "azure_ad_token_provider": values["azure_ad_token_provider"],
+                "organization": values["openai_organization"],
+                "base_url": values["openai_api_base"],
+                "timeout": values["request_timeout"],
+                "max_retries": values["max_retries"],
+                "default_headers": values["default_headers"],
+                "default_query": values["default_query"],
+                "http_client": values["http_client"],
+            }
+            values["client"] = openai.AzureOpenAI(**client_params).completions
+            values["async_client"] = openai.AsyncAzureOpenAI(
+                **client_params
+            ).completions
+
+        else:
+            values["client"] = openai.Completion
+
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        return {
+            **{"deployment_name": self.deployment_name},
+            **super()._identifying_params,
+        }
+
+    @property
+    def _invocation_params(self) -> Dict[str, Any]:
+        if is_openai_v1():
+            openai_params = {"model": self.deployment_name}
+        else:
+            openai_params = {
+                "engine": self.deployment_name,
+                "api_type": self.openai_api_type,
+                "api_version": self.openai_api_version,
+            }
+        return {**openai_params, **super()._invocation_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "azure"
+
+    @property
+    def lc_attributes(self) -> Dict[str, Any]:
+        return {
+            "openai_api_type": self.openai_api_type,
+            "openai_api_version": self.openai_api_version,
+        }
+
+
+@deprecated(
+    since="0.0.1",
+    removal="0.2.0",
+    alternative_import="langchain_openai.ChatOpenAI",
+)
+class OpenAIChat(BaseLLM):
+    """OpenAI Chat large language models.
+
+    To use, you should have the ``openai`` python package installed, and the
+    environment variable ``OPENAI_API_KEY`` set with your API key.
+
+    Any parameters that are valid to be passed to the openai.create call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import OpenAIChat
+            openaichat = OpenAIChat(model_name="gpt-3.5-turbo")
+    """
+
+    client: Any = Field(default=None, exclude=True)  #: :meta private:
+    async_client: Any = Field(default=None, exclude=True)  #: :meta private:
+    model_name: str = "gpt-3.5-turbo"
+    """Model name to use."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not explicitly specified."""
+    # When updating this to use a SecretStr
+    # Check for classes that derive from this class (as some of them
+    # may assume openai_api_key is a str)
+    openai_api_key: Optional[str] = Field(default=None, alias="api_key")
+    """Automatically inferred from env var `OPENAI_API_KEY` if not provided."""
+    openai_api_base: Optional[str] = Field(default=None, alias="base_url")
+    """Base URL path for API requests, leave blank if not using a proxy or service 
+        emulator."""
+    # to support explicit proxy for OpenAI
+    openai_proxy: Optional[str] = None
+    max_retries: int = 6
+    """Maximum number of retries to make when generating."""
+    prefix_messages: List = Field(default_factory=list)
+    """Series of messages for Chat input."""
+    streaming: bool = False
+    """Whether to stream the results or not."""
+    allowed_special: Union[Literal["all"], AbstractSet[str]] = set()
+    """Set of special tokens that are allowed。"""
+    disallowed_special: Union[Literal["all"], Collection[str]] = "all"
+    """Set of special tokens that are not allowed。"""
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = {field.alias for field in cls.__fields__.values()}
+
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name not in all_required_field_names:
+                if field_name in extra:
+                    raise ValueError(f"Found {field_name} supplied twice.")
+                extra[field_name] = values.pop(field_name)
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        openai_api_key = get_from_dict_or_env(
+            values, "openai_api_key", "OPENAI_API_KEY"
+        )
+        openai_api_base = get_from_dict_or_env(
+            values,
+            "openai_api_base",
+            "OPENAI_API_BASE",
+            default="",
+        )
+        openai_proxy = get_from_dict_or_env(
+            values,
+            "openai_proxy",
+            "OPENAI_PROXY",
+            default="",
+        )
+        openai_organization = get_from_dict_or_env(
+            values, "openai_organization", "OPENAI_ORGANIZATION", default=""
+        )
+        try:
+            import openai
+
+            openai.api_key = openai_api_key
+            if openai_api_base:
+                openai.api_base = openai_api_base
+            if openai_organization:
+                openai.organization = openai_organization
+            if openai_proxy:
+                openai.proxy = {"http": openai_proxy, "https": openai_proxy}  # type: ignore[assignment]  # noqa: E501
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+        try:
+            values["client"] = openai.ChatCompletion
+        except AttributeError:
+            raise ValueError(
+                "`openai` has no `ChatCompletion` attribute, this is likely "
+                "due to an old version of the openai package. Try upgrading it "
+                "with `pip install --upgrade openai`."
+            )
+        warnings.warn(
+            "You are trying to use a chat model. This way of initializing it is "
+            "no longer supported. Instead, please use: "
+            "`from langchain_community.chat_models import ChatOpenAI`"
+        )
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling OpenAI API."""
+        return self.model_kwargs
+
+    def _get_chat_params(
+        self, prompts: List[str], stop: Optional[List[str]] = None
+    ) -> Tuple:
+        if len(prompts) > 1:
+            raise ValueError(
+                f"OpenAIChat currently only supports single prompt, got {prompts}"
+            )
+        messages = self.prefix_messages + [{"role": "user", "content": prompts[0]}]
+        params: Dict[str, Any] = {**{"model": self.model_name}, **self._default_params}
+        if stop is not None:
+            if "stop" in params:
+                raise ValueError("`stop` found in both the input and default params.")
+            params["stop"] = stop
+        if params.get("max_tokens") == -1:
+            # for ChatGPT api, omitting max_tokens is equivalent to having no limit
+            del params["max_tokens"]
+        return messages, params
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        messages, params = self._get_chat_params([prompt], stop)
+        params = {**params, **kwargs, "stream": True}
+        for stream_resp in completion_with_retry(
+            self, messages=messages, run_manager=run_manager, **params
+        ):
+            if not isinstance(stream_resp, dict):
+                stream_resp = stream_resp.dict()
+            token = stream_resp["choices"][0]["delta"].get("content", "")
+            chunk = GenerationChunk(text=token)
+            if run_manager:
+                run_manager.on_llm_new_token(token, chunk=chunk)
+            yield chunk
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        messages, params = self._get_chat_params([prompt], stop)
+        params = {**params, **kwargs, "stream": True}
+        async for stream_resp in await acompletion_with_retry(
+            self, messages=messages, run_manager=run_manager, **params
+        ):
+            if not isinstance(stream_resp, dict):
+                stream_resp = stream_resp.dict()
+            token = stream_resp["choices"][0]["delta"].get("content", "")
+            chunk = GenerationChunk(text=token)
+            if run_manager:
+                await run_manager.on_llm_new_token(token, chunk=chunk)
+            yield chunk
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        if self.streaming:
+            generation: Optional[GenerationChunk] = None
+            for chunk in self._stream(prompts[0], stop, run_manager, **kwargs):
+                if generation is None:
+                    generation = chunk
+                else:
+                    generation += chunk
+            assert generation is not None
+            return LLMResult(generations=[[generation]])
+
+        messages, params = self._get_chat_params(prompts, stop)
+        params = {**params, **kwargs}
+        full_response = completion_with_retry(
+            self, messages=messages, run_manager=run_manager, **params
+        )
+        if not isinstance(full_response, dict):
+            full_response = full_response.dict()
+        llm_output = {
+            "token_usage": full_response["usage"],
+            "model_name": self.model_name,
+        }
+        return LLMResult(
+            generations=[
+                [Generation(text=full_response["choices"][0]["message"]["content"])]
+            ],
+            llm_output=llm_output,
+        )
+
+    async def _agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        if self.streaming:
+            generation: Optional[GenerationChunk] = None
+            async for chunk in self._astream(prompts[0], stop, run_manager, **kwargs):
+                if generation is None:
+                    generation = chunk
+                else:
+                    generation += chunk
+            assert generation is not None
+            return LLMResult(generations=[[generation]])
+
+        messages, params = self._get_chat_params(prompts, stop)
+        params = {**params, **kwargs}
+        full_response = await acompletion_with_retry(
+            self, messages=messages, run_manager=run_manager, **params
+        )
+        if not isinstance(full_response, dict):
+            full_response = full_response.dict()
+        llm_output = {
+            "token_usage": full_response["usage"],
+            "model_name": self.model_name,
+        }
+        return LLMResult(
+            generations=[
+                [Generation(text=full_response["choices"][0]["message"]["content"])]
+            ],
+            llm_output=llm_output,
+        )
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model_name": self.model_name}, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "openai-chat"
+
+    def get_token_ids(self, text: str) -> List[int]:
+        """Get the token IDs using the tiktoken package."""
+        # tiktoken NOT supported for Python < 3.8
+        if sys.version_info[1] < 8:
+            return super().get_token_ids(text)
+        try:
+            import tiktoken
+        except ImportError:
+            raise ImportError(
+                "Could not import tiktoken python package. "
+                "This is needed in order to calculate get_num_tokens. "
+                "Please install it with `pip install tiktoken`."
+            )
+
+        enc = tiktoken.encoding_for_model(self.model_name)
+        return enc.encode(
+            text,
+            allowed_special=self.allowed_special,
+            disallowed_special=self.disallowed_special,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/llms/openllm.py b/llm/Lib/site-packages/langchain_community/llms/openllm.py
new file mode 100644
index 0000000000000000000000000000000000000000..5d43e7ea265d3a006153acae53dd33495c9cd861
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/openllm.py
@@ -0,0 +1,339 @@
+from __future__ import annotations
+
+import copy
+import json
+import logging
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    TypedDict,
+    Union,
+    overload,
+)
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import PrivateAttr
+
+if TYPE_CHECKING:
+    import openllm
+
+
+ServerType = Literal["http", "grpc"]
+
+
+class IdentifyingParams(TypedDict):
+    """Parameters for identifying a model as a typed dict."""
+
+    model_name: str
+    model_id: Optional[str]
+    server_url: Optional[str]
+    server_type: Optional[ServerType]
+    embedded: bool
+    llm_kwargs: Dict[str, Any]
+
+
+logger = logging.getLogger(__name__)
+
+
+class OpenLLM(LLM):
+    """OpenLLM, supporting both in-process model
+    instance and remote OpenLLM servers.
+
+    To use, you should have the openllm library installed:
+
+    .. code-block:: bash
+
+        pip install openllm
+
+    Learn more at: https://github.com/bentoml/openllm
+
+    Example running an LLM model locally managed by OpenLLM:
+        .. code-block:: python
+
+            from langchain_community.llms import OpenLLM
+            llm = OpenLLM(
+                model_name='flan-t5',
+                model_id='google/flan-t5-large',
+            )
+            llm("What is the difference between a duck and a goose?")
+
+    For all available supported models, you can run 'openllm models'.
+
+    If you have a OpenLLM server running, you can also use it remotely:
+        .. code-block:: python
+
+            from langchain_community.llms import OpenLLM
+            llm = OpenLLM(server_url='http://localhost:3000')
+            llm.invoke("What is the difference between a duck and a goose?")
+    """
+
+    model_name: Optional[str] = None
+    """Model name to use. See 'openllm models' for all available models."""
+    model_id: Optional[str] = None
+    """Model Id to use. If not provided, will use the default model for the model name.
+    See 'openllm models' for all available model variants."""
+    server_url: Optional[str] = None
+    """Optional server URL that currently runs a LLMServer with 'openllm start'."""
+    timeout: int = 30
+    """"Time out for the openllm client"""
+    server_type: ServerType = "http"
+    """Optional server type. Either 'http' or 'grpc'."""
+    embedded: bool = True
+    """Initialize this LLM instance in current process by default. Should
+    only set to False when using in conjunction with BentoML Service."""
+    llm_kwargs: Dict[str, Any]
+    """Keyword arguments to be passed to openllm.LLM"""
+
+    _runner: Optional[openllm.LLMRunner] = PrivateAttr(default=None)
+    _client: Union[
+        openllm.client.HTTPClient, openllm.client.GrpcClient, None
+    ] = PrivateAttr(default=None)
+
+    class Config:
+        extra = "forbid"
+
+    @overload
+    def __init__(
+        self,
+        model_name: Optional[str] = ...,
+        *,
+        model_id: Optional[str] = ...,
+        embedded: Literal[True, False] = ...,
+        **llm_kwargs: Any,
+    ) -> None:
+        ...
+
+    @overload
+    def __init__(
+        self,
+        *,
+        server_url: str = ...,
+        server_type: Literal["grpc", "http"] = ...,
+        **llm_kwargs: Any,
+    ) -> None:
+        ...
+
+    def __init__(
+        self,
+        model_name: Optional[str] = None,
+        *,
+        model_id: Optional[str] = None,
+        server_url: Optional[str] = None,
+        timeout: int = 30,
+        server_type: Literal["grpc", "http"] = "http",
+        embedded: bool = True,
+        **llm_kwargs: Any,
+    ):
+        try:
+            import openllm
+        except ImportError as e:
+            raise ImportError(
+                "Could not import openllm. Make sure to install it with "
+                "'pip install openllm.'"
+            ) from e
+
+        llm_kwargs = llm_kwargs or {}
+
+        if server_url is not None:
+            logger.debug("'server_url' is provided, returning a openllm.Client")
+            assert (
+                model_id is None and model_name is None
+            ), "'server_url' and {'model_id', 'model_name'} are mutually exclusive"
+            client_cls = (
+                openllm.client.HTTPClient
+                if server_type == "http"
+                else openllm.client.GrpcClient
+            )
+            client = client_cls(server_url, timeout)
+
+            super().__init__(
+                **{
+                    "server_url": server_url,
+                    "timeout": timeout,
+                    "server_type": server_type,
+                    "llm_kwargs": llm_kwargs,
+                }
+            )
+            self._runner = None  # type: ignore
+            self._client = client
+        else:
+            assert model_name is not None, "Must provide 'model_name' or 'server_url'"
+            # since the LLM are relatively huge, we don't actually want to convert the
+            # Runner with embedded when running the server. Instead, we will only set
+            # the init_local here so that LangChain users can still use the LLM
+            # in-process. Wrt to BentoML users, setting embedded=False is the expected
+            # behaviour to invoke the runners remotely.
+            # We need to also enable ensure_available to download and setup the model.
+            runner = openllm.Runner(
+                model_name=model_name,
+                model_id=model_id,
+                init_local=embedded,
+                ensure_available=True,
+                **llm_kwargs,
+            )
+            super().__init__(
+                **{
+                    "model_name": model_name,
+                    "model_id": model_id,
+                    "embedded": embedded,
+                    "llm_kwargs": llm_kwargs,
+                }
+            )
+            self._client = None  # type: ignore
+            self._runner = runner
+
+    @property
+    def runner(self) -> openllm.LLMRunner:
+        """
+        Get the underlying openllm.LLMRunner instance for integration with BentoML.
+
+        Example:
+        .. code-block:: python
+
+            llm = OpenLLM(
+                model_name='flan-t5',
+                model_id='google/flan-t5-large',
+                embedded=False,
+            )
+            tools = load_tools(["serpapi", "llm-math"], llm=llm)
+            agent = initialize_agent(
+                tools, llm, agent=AgentType.ZERO_SHOT_REACT_DESCRIPTION
+            )
+            svc = bentoml.Service("langchain-openllm", runners=[llm.runner])
+
+            @svc.api(input=Text(), output=Text())
+            def chat(input_text: str):
+                return agent.run(input_text)
+        """
+        if self._runner is None:
+            raise ValueError("OpenLLM must be initialized locally with 'model_name'")
+        return self._runner
+
+    @property
+    def _identifying_params(self) -> IdentifyingParams:
+        """Get the identifying parameters."""
+        if self._client is not None:
+            self.llm_kwargs.update(self._client._config)
+            model_name = self._client._metadata.model_dump()["model_name"]
+            model_id = self._client._metadata.model_dump()["model_id"]
+        else:
+            if self._runner is None:
+                raise ValueError("Runner must be initialized.")
+            model_name = self.model_name
+            model_id = self.model_id
+            try:
+                self.llm_kwargs.update(
+                    json.loads(self._runner.identifying_params["configuration"])
+                )
+            except (TypeError, json.JSONDecodeError):
+                pass
+        return IdentifyingParams(
+            server_url=self.server_url,
+            server_type=self.server_type,
+            embedded=self.embedded,
+            llm_kwargs=self.llm_kwargs,
+            model_name=model_name,
+            model_id=model_id,
+        )
+
+    @property
+    def _llm_type(self) -> str:
+        return "openllm_client" if self._client else "openllm"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        try:
+            import openllm
+        except ImportError as e:
+            raise ImportError(
+                "Could not import openllm. Make sure to install it with "
+                "'pip install openllm'."
+            ) from e
+
+        copied = copy.deepcopy(self.llm_kwargs)
+        copied.update(kwargs)
+        config = openllm.AutoConfig.for_model(
+            self._identifying_params["model_name"], **copied
+        )
+        if self._client:
+            res = (
+                self._client.generate(prompt, **config.model_dump(flatten=True))
+                .outputs[0]
+                .text
+            )
+        else:
+            assert self._runner is not None
+            res = self._runner(prompt, **config.model_dump(flatten=True))
+        if isinstance(res, dict) and "text" in res:
+            return res["text"]
+        elif isinstance(res, str):
+            return res
+        else:
+            raise ValueError(
+                "Expected result to be a dict with key 'text' or a string. "
+                f"Received {res}"
+            )
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        try:
+            import openllm
+        except ImportError as e:
+            raise ImportError(
+                "Could not import openllm. Make sure to install it with "
+                "'pip install openllm'."
+            ) from e
+
+        copied = copy.deepcopy(self.llm_kwargs)
+        copied.update(kwargs)
+        config = openllm.AutoConfig.for_model(
+            self._identifying_params["model_name"], **copied
+        )
+        if self._client:
+            async_client = openllm.client.AsyncHTTPClient(self.server_url, self.timeout)
+            res = (
+                (await async_client.generate(prompt, **config.model_dump(flatten=True)))
+                .outputs[0]
+                .text
+            )
+        else:
+            assert self._runner is not None
+            (
+                prompt,
+                generate_kwargs,
+                postprocess_kwargs,
+            ) = self._runner.llm.sanitize_parameters(prompt, **kwargs)
+            generated_result = await self._runner.generate.async_run(
+                prompt, **generate_kwargs
+            )
+            res = self._runner.llm.postprocess_generate(
+                prompt, generated_result, **postprocess_kwargs
+            )
+
+        if isinstance(res, dict) and "text" in res:
+            return res["text"]
+        elif isinstance(res, str):
+            return res
+        else:
+            raise ValueError(
+                "Expected result to be a dict with key 'text' or a string. "
+                f"Received {res}"
+            )
diff --git a/llm/Lib/site-packages/langchain_community/llms/openlm.py b/llm/Lib/site-packages/langchain_community/llms/openlm.py
new file mode 100644
index 0000000000000000000000000000000000000000..47b303012bf014948a08b2f4d9246f4625cef458
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/openlm.py
@@ -0,0 +1,32 @@
+from typing import Any, Dict
+
+from langchain_core.pydantic_v1 import root_validator
+
+from langchain_community.llms.openai import BaseOpenAI
+
+
+class OpenLM(BaseOpenAI):
+    """OpenLM models."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @property
+    def _invocation_params(self) -> Dict[str, Any]:
+        return {**{"model": self.model_name}, **super()._invocation_params}
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        try:
+            import openlm
+
+            values["client"] = openlm.Completion
+        except ImportError:
+            raise ImportError(
+                "Could not import openlm python package. "
+                "Please install it with `pip install openlm`."
+            )
+        if values["streaming"]:
+            raise ValueError("Streaming not supported with openlm")
+        return values
diff --git a/llm/Lib/site-packages/langchain_community/llms/pai_eas_endpoint.py b/llm/Lib/site-packages/langchain_community/llms/pai_eas_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..c84083b17eaac9bf6dd42a9e5df8fac50401bed1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/pai_eas_endpoint.py
@@ -0,0 +1,240 @@
+import json
+import logging
+from typing import Any, Dict, Iterator, List, Mapping, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class PaiEasEndpoint(LLM):
+    """Langchain LLM class to help to access eass llm service.
+
+        To use this endpoint, must have a deployed eas chat llm service on PAI AliCloud.
+    One can set the environment variable ``eas_service_url`` and ``eas_service_token``.
+    The environment variables can set with your eas service url and service token.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms.pai_eas_endpoint import PaiEasEndpoint
+            eas_chat_endpoint = PaiEasChatEndpoint(
+                eas_service_url="your_service_url",
+                eas_service_token="your_service_token"
+            )
+    """
+
+    """PAI-EAS Service URL"""
+    eas_service_url: str
+
+    """PAI-EAS Service TOKEN"""
+    eas_service_token: str
+
+    """PAI-EAS Service Infer Params"""
+    max_new_tokens: Optional[int] = 512
+    temperature: Optional[float] = 0.95
+    top_p: Optional[float] = 0.1
+    top_k: Optional[int] = 0
+    stop_sequences: Optional[List[str]] = None
+
+    """Enable stream chat mode."""
+    streaming: bool = False
+
+    """Key/value arguments to pass to the model. Reserved for future use"""
+    model_kwargs: Optional[dict] = None
+
+    version: Optional[str] = "2.0"
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["eas_service_url"] = get_from_dict_or_env(
+            values, "eas_service_url", "EAS_SERVICE_URL"
+        )
+        values["eas_service_token"] = get_from_dict_or_env(
+            values, "eas_service_token", "EAS_SERVICE_TOKEN"
+        )
+
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "pai_eas_endpoint"
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Cohere API."""
+        return {
+            "max_new_tokens": self.max_new_tokens,
+            "temperature": self.temperature,
+            "top_k": self.top_k,
+            "top_p": self.top_p,
+            "stop_sequences": [],
+        }
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            "eas_service_url": self.eas_service_url,
+            "eas_service_token": self.eas_service_token,
+            **_model_kwargs,
+        }
+
+    def _invocation_params(
+        self, stop_sequences: Optional[List[str]], **kwargs: Any
+    ) -> dict:
+        params = self._default_params
+        if self.stop_sequences is not None and stop_sequences is not None:
+            raise ValueError("`stop` found in both the input and default params.")
+        elif self.stop_sequences is not None:
+            params["stop"] = self.stop_sequences
+        else:
+            params["stop"] = stop_sequences
+        if self.model_kwargs:
+            params.update(self.model_kwargs)
+        return {**params, **kwargs}
+
+    @staticmethod
+    def _process_response(
+        response: Any, stop: Optional[List[str]], version: Optional[str]
+    ) -> str:
+        if version == "1.0":
+            text = response
+        else:
+            text = response["response"]
+
+        if stop:
+            text = enforce_stop_tokens(text, stop)
+        return "".join(text)
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        params = self._invocation_params(stop, **kwargs)
+        prompt = prompt.strip()
+        response = None
+        try:
+            if self.streaming:
+                completion = ""
+                for chunk in self._stream(prompt, stop, run_manager, **params):
+                    completion += chunk.text
+                return completion
+            else:
+                response = self._call_eas(prompt, params)
+                _stop = params.get("stop")
+                return self._process_response(response, _stop, self.version)
+        except Exception as error:
+            raise ValueError(f"Error raised by the service: {error}")
+
+    def _call_eas(self, prompt: str = "", params: Dict = {}) -> Any:
+        """Generate text from the eas service."""
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": f"{self.eas_service_token}",
+        }
+        if self.version == "1.0":
+            body = {
+                "input_ids": f"{prompt}",
+            }
+        else:
+            body = {
+                "prompt": f"{prompt}",
+            }
+
+        # add params to body
+        for key, value in params.items():
+            body[key] = value
+
+        # make request
+        response = requests.post(self.eas_service_url, headers=headers, json=body)
+
+        if response.status_code != 200:
+            raise Exception(
+                f"Request failed with status code {response.status_code}"
+                f" and message {response.text}"
+            )
+
+        try:
+            return json.loads(response.text)
+        except Exception as e:
+            if isinstance(e, json.decoder.JSONDecodeError):
+                return response.text
+            raise e
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        invocation_params = self._invocation_params(stop, **kwargs)
+
+        headers = {
+            "User-Agent": "Test Client",
+            "Authorization": f"{self.eas_service_token}",
+        }
+
+        if self.version == "1.0":
+            pload = {"input_ids": prompt, **invocation_params}
+            response = requests.post(
+                self.eas_service_url, headers=headers, json=pload, stream=True
+            )
+
+            res = GenerationChunk(text=response.text)
+
+            if run_manager:
+                run_manager.on_llm_new_token(res.text)
+
+            # yield text, if any
+            yield res
+        else:
+            pload = {"prompt": prompt, "use_stream_chat": "True", **invocation_params}
+
+            response = requests.post(
+                self.eas_service_url, headers=headers, json=pload, stream=True
+            )
+
+            for chunk in response.iter_lines(
+                chunk_size=8192, decode_unicode=False, delimiter=b"\0"
+            ):
+                if chunk:
+                    data = json.loads(chunk.decode("utf-8"))
+                    output = data["response"]
+                    # identify stop sequence in generated text, if any
+                    stop_seq_found: Optional[str] = None
+                    for stop_seq in invocation_params["stop"]:
+                        if stop_seq in output:
+                            stop_seq_found = stop_seq
+
+                    # identify text to yield
+                    text: Optional[str] = None
+                    if stop_seq_found:
+                        text = output[: output.index(stop_seq_found)]
+                    else:
+                        text = output
+
+                    # yield text, if any
+                    if text:
+                        res = GenerationChunk(text=text)
+                        if run_manager:
+                            run_manager.on_llm_new_token(res.text)
+                        yield res
+
+                    # break if stop sequence found
+                    if stop_seq_found:
+                        break
diff --git a/llm/Lib/site-packages/langchain_community/llms/petals.py b/llm/Lib/site-packages/langchain_community/llms/petals.py
new file mode 100644
index 0000000000000000000000000000000000000000..9112d18a1dfbbec44a5fad45fd5316a9faf6766f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/petals.py
@@ -0,0 +1,153 @@
+import logging
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class Petals(LLM):
+    """Petals Bloom models.
+
+    To use, you should have the ``petals`` python package installed, and the
+    environment variable ``HUGGINGFACE_API_KEY`` set with your API key.
+
+    Any parameters that are valid to be passed to the call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import petals
+            petals = Petals()
+
+    """
+
+    client: Any
+    """The client to use for the API calls."""
+
+    tokenizer: Any
+    """The tokenizer to use for the API calls."""
+
+    model_name: str = "bigscience/bloom-petals"
+    """The model to use."""
+
+    temperature: float = 0.7
+    """What sampling temperature to use"""
+
+    max_new_tokens: int = 256
+    """The maximum number of new tokens to generate in the completion."""
+
+    top_p: float = 0.9
+    """The cumulative probability for top-p sampling."""
+
+    top_k: Optional[int] = None
+    """The number of highest probability vocabulary tokens
+    to keep for top-k-filtering."""
+
+    do_sample: bool = True
+    """Whether or not to use sampling; use greedy decoding otherwise."""
+
+    max_length: Optional[int] = None
+    """The maximum length of the sequence to be generated."""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call
+    not explicitly specified."""
+
+    huggingface_api_key: Optional[SecretStr] = None
+
+    class Config:
+        """Configuration for this pydantic config."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = {field.alias for field in cls.__fields__.values()}
+
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name not in all_required_field_names:
+                if field_name in extra:
+                    raise ValueError(f"Found {field_name} supplied twice.")
+                logger.warning(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        huggingface_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "huggingface_api_key", "HUGGINGFACE_API_KEY")
+        )
+        try:
+            from petals import AutoDistributedModelForCausalLM
+            from transformers import AutoTokenizer
+
+            model_name = values["model_name"]
+            values["tokenizer"] = AutoTokenizer.from_pretrained(model_name)
+            values["client"] = AutoDistributedModelForCausalLM.from_pretrained(
+                model_name
+            )
+            values["huggingface_api_key"] = huggingface_api_key.get_secret_value()
+
+        except ImportError:
+            raise ImportError(
+                "Could not import transformers or petals python package."
+                "Please install with `pip install -U transformers petals`."
+            )
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Petals API."""
+        normal_params = {
+            "temperature": self.temperature,
+            "max_new_tokens": self.max_new_tokens,
+            "top_p": self.top_p,
+            "top_k": self.top_k,
+            "do_sample": self.do_sample,
+            "max_length": self.max_length,
+        }
+        return {**normal_params, **self.model_kwargs}
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model_name": self.model_name}, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "petals"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call the Petals API."""
+        params = self._default_params
+        params = {**params, **kwargs}
+        inputs = self.tokenizer(prompt, return_tensors="pt")["input_ids"]
+        outputs = self.client.generate(inputs, **params)
+        text = self.tokenizer.decode(outputs[0])
+        if stop is not None:
+            # I believe this is required since the stop tokens
+            # are not enforced by the model parameters
+            text = enforce_stop_tokens(text, stop)
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/pipelineai.py b/llm/Lib/site-packages/langchain_community/llms/pipelineai.py
new file mode 100644
index 0000000000000000000000000000000000000000..170722d920a532da1576de643741ef3804103c3c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/pipelineai.py
@@ -0,0 +1,121 @@
+import logging
+from typing import Any, Dict, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import (
+    BaseModel,
+    Extra,
+    Field,
+    SecretStr,
+    root_validator,
+)
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class PipelineAI(LLM, BaseModel):
+    """PipelineAI large language models.
+
+    To use, you should have the ``pipeline-ai`` python package installed,
+    and the environment variable ``PIPELINE_API_KEY`` set with your API key.
+
+    Any parameters that are valid to be passed to the call can be passed
+    in, even if not explicitly saved on this class.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import PipelineAI
+            pipeline = PipelineAI(pipeline_key="")
+    """
+
+    pipeline_key: str = ""
+    """The id or tag of the target pipeline"""
+
+    pipeline_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any pipeline parameters valid for `create` call not
+    explicitly specified."""
+
+    pipeline_api_key: Optional[SecretStr] = None
+
+    class Config:
+        """Configuration for this pydantic config."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = {field.alias for field in cls.__fields__.values()}
+
+        extra = values.get("pipeline_kwargs", {})
+        for field_name in list(values):
+            if field_name not in all_required_field_names:
+                if field_name in extra:
+                    raise ValueError(f"Found {field_name} supplied twice.")
+                logger.warning(
+                    f"""{field_name} was transferred to pipeline_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+        values["pipeline_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        pipeline_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "pipeline_api_key", "PIPELINE_API_KEY")
+        )
+        values["pipeline_api_key"] = pipeline_api_key
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"pipeline_key": self.pipeline_key},
+            **{"pipeline_kwargs": self.pipeline_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "pipeline_ai"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call to Pipeline Cloud endpoint."""
+        try:
+            from pipeline import PipelineCloud
+        except ImportError:
+            raise ImportError(
+                "Could not import pipeline-ai python package. "
+                "Please install it with `pip install pipeline-ai`."
+            )
+        client = PipelineCloud(token=self.pipeline_api_key.get_secret_value())  # type: ignore[union-attr]
+        params = self.pipeline_kwargs or {}
+        params = {**params, **kwargs}
+
+        run = client.run_pipeline(self.pipeline_key, [prompt, params])
+        try:
+            text = run.result_preview[0][0]
+        except AttributeError:
+            raise AttributeError(
+                f"A pipeline run should have a `result_preview` attribute."
+                f"Run was: {run}"
+            )
+        if stop is not None:
+            # I believe this is required since the stop tokens
+            # are not enforced by the pipeline parameters
+            text = enforce_stop_tokens(text, stop)
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/predibase.py b/llm/Lib/site-packages/langchain_community/llms/predibase.py
new file mode 100644
index 0000000000000000000000000000000000000000..e3f5da7fd9e34d3065a6ce96460ad0f4282b0093
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/predibase.py
@@ -0,0 +1,114 @@
+from typing import Any, Dict, List, Mapping, Optional, Union
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Field, SecretStr
+
+
+class Predibase(LLM):
+    """Use your Predibase models with Langchain.
+
+    To use, you should have the ``predibase`` python package installed,
+    and have your Predibase API key.
+
+    The `model` parameter is the Predibase "serverless" base_model ID
+    (see https://docs.predibase.com/user-guide/inference/models for the catalog).
+
+    An optional `adapter_id` parameter is the Predibase ID or HuggingFace ID of a
+    fine-tuned LLM adapter, whose base model is the `model` parameter; the
+    fine-tuned adapter must be compatible with its base model;
+    otherwise, an error is raised.  If a Predibase ID references the
+    fine-tuned adapter, then the `adapter_version` in the adapter repository can
+    be optionally specified; omitting it defaults to the most recent version.
+    """
+
+    model: str
+    predibase_api_key: SecretStr
+    adapter_id: Optional[str] = None
+    adapter_version: Optional[int] = None
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    default_options_for_generation: dict = Field(
+        {
+            "max_new_tokens": 256,
+            "temperature": 0.1,
+        },
+        const=True,
+    )
+
+    @property
+    def _llm_type(self) -> str:
+        return "predibase"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        try:
+            from predibase import PredibaseClient
+            from predibase.pql import get_session
+            from predibase.pql.api import (
+                ServerResponseError,
+                Session,
+            )
+            from predibase.resource.llm.interface import (
+                HuggingFaceLLM,
+                LLMDeployment,
+            )
+            from predibase.resource.llm.response import GeneratedResponse
+            from predibase.resource.model import Model
+
+            session: Session = get_session(
+                token=self.predibase_api_key.get_secret_value(),
+                gateway="https://api.app.predibase.com/v1",
+                serving_endpoint="serving.app.predibase.com",
+            )
+            pc: PredibaseClient = PredibaseClient(session=session)
+        except ImportError as e:
+            raise ImportError(
+                "Could not import Predibase Python package. "
+                "Please install it with `pip install predibase`."
+            ) from e
+        except ValueError as e:
+            raise ValueError("Your API key is not correct. Please try again") from e
+        options: Dict[str, Union[str, float]] = (
+            self.model_kwargs or self.default_options_for_generation
+        )
+        base_llm_deployment: LLMDeployment = pc.LLM(
+            uri=f"pb://deployments/{self.model}"
+        )
+        result: GeneratedResponse
+        if self.adapter_id:
+            """
+            Attempt to retrieve the fine-tuned adapter from a Predibase repository.
+            If absent, then load the fine-tuned adapter from a HuggingFace repository.
+            """
+            adapter_model: Union[Model, HuggingFaceLLM]
+            try:
+                adapter_model = pc.get_model(
+                    name=self.adapter_id,
+                    version=self.adapter_version,
+                    model_id=None,
+                )
+            except ServerResponseError:
+                # Predibase does not recognize the adapter ID (query HuggingFace).
+                adapter_model = pc.LLM(uri=f"hf://{self.adapter_id}")
+            result = base_llm_deployment.with_adapter(model=adapter_model).generate(
+                prompt=prompt,
+                options=options,
+            )
+        else:
+            result = base_llm_deployment.generate(
+                prompt=prompt,
+                options=options,
+            )
+        return result.response
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"model_kwargs": self.model_kwargs},
+        }
diff --git a/llm/Lib/site-packages/langchain_community/llms/predictionguard.py b/llm/Lib/site-packages/langchain_community/llms/predictionguard.py
new file mode 100644
index 0000000000000000000000000000000000000000..51291500ca78593af8be9bc9ebd1b0388b22ed10
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/predictionguard.py
@@ -0,0 +1,130 @@
+import logging
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class PredictionGuard(LLM):
+    """Prediction Guard large language models.
+
+    To use, you should have the ``predictionguard`` python package installed, and the
+    environment variable ``PREDICTIONGUARD_TOKEN`` set with your access token, or pass
+    it as a named parameter to the constructor. To use Prediction Guard's API along
+    with OpenAI models, set the environment variable ``OPENAI_API_KEY`` with your
+    OpenAI API key as well.
+
+    Example:
+        .. code-block:: python
+
+            pgllm = PredictionGuard(model="MPT-7B-Instruct",
+                                    token="my-access-token",
+                                    output={
+                                        "type": "boolean"
+                                    })
+    """
+
+    client: Any  #: :meta private:
+    model: Optional[str] = "MPT-7B-Instruct"
+    """Model name to use."""
+
+    output: Optional[Dict[str, Any]] = None
+    """The output type or structure for controlling the LLM output."""
+
+    max_tokens: int = 256
+    """Denotes the number of tokens to predict per generation."""
+
+    temperature: float = 0.75
+    """A non-negative float that tunes the degree of randomness in generation."""
+
+    token: Optional[str] = None
+    """Your Prediction Guard access token."""
+
+    stop: Optional[List[str]] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the access token and python package exists in environment."""
+        token = get_from_dict_or_env(values, "token", "PREDICTIONGUARD_TOKEN")
+        try:
+            import predictionguard as pg
+
+            values["client"] = pg.Client(token=token)
+        except ImportError:
+            raise ImportError(
+                "Could not import predictionguard python package. "
+                "Please install it with `pip install predictionguard`."
+            )
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling the Prediction Guard API."""
+        return {
+            "max_tokens": self.max_tokens,
+            "temperature": self.temperature,
+        }
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model": self.model}, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "predictionguard"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Prediction Guard's model API.
+        Args:
+            prompt: The prompt to pass into the model.
+        Returns:
+            The string generated by the model.
+        Example:
+            .. code-block:: python
+                response = pgllm("Tell me a joke.")
+        """
+        import predictionguard as pg
+
+        params = self._default_params
+        if self.stop is not None and stop is not None:
+            raise ValueError("`stop` found in both the input and default params.")
+        elif self.stop is not None:
+            params["stop_sequences"] = self.stop
+        else:
+            params["stop_sequences"] = stop
+
+        response = pg.Completion.create(
+            model=self.model,
+            prompt=prompt,
+            output=self.output,
+            temperature=params["temperature"],
+            max_tokens=params["max_tokens"],
+            **kwargs,
+        )
+        text = response["choices"][0]["text"]
+
+        # If stop tokens are provided, Prediction Guard's endpoint returns them.
+        # In order to make this consistent with other endpoints, we strip them.
+        if stop is not None or self.stop is not None:
+            text = enforce_stop_tokens(text, params["stop_sequences"])
+
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/promptlayer_openai.py b/llm/Lib/site-packages/langchain_community/llms/promptlayer_openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..15456a7399600e359fd9a3fda9bdd6f9948de5b0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/promptlayer_openai.py
@@ -0,0 +1,232 @@
+import datetime
+from typing import Any, List, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.outputs import LLMResult
+
+from langchain_community.llms.openai import OpenAI, OpenAIChat
+
+
+class PromptLayerOpenAI(OpenAI):
+    """PromptLayer OpenAI large language models.
+
+    To use, you should have the ``openai`` and ``promptlayer`` python
+    package installed, and the environment variable ``OPENAI_API_KEY``
+    and ``PROMPTLAYER_API_KEY`` set with your openAI API key and
+    promptlayer key respectively.
+
+    All parameters that can be passed to the OpenAI LLM can also
+    be passed here. The PromptLayerOpenAI LLM adds two optional
+
+    parameters:
+        ``pl_tags``: List of strings to tag the request with.
+        ``return_pl_id``: If True, the PromptLayer request ID will be
+            returned in the ``generation_info`` field of the
+            ``Generation`` object.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import PromptLayerOpenAI
+            openai = PromptLayerOpenAI(model_name="gpt-3.5-turbo-instruct")
+    """
+
+    pl_tags: Optional[List[str]]
+    return_pl_id: Optional[bool] = False
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Call OpenAI generate and then call PromptLayer API to log the request."""
+        from promptlayer.utils import get_api_key, promptlayer_api_request
+
+        request_start_time = datetime.datetime.now().timestamp()
+        generated_responses = super()._generate(prompts, stop, run_manager)
+        request_end_time = datetime.datetime.now().timestamp()
+        for i in range(len(prompts)):
+            prompt = prompts[i]
+            generation = generated_responses.generations[i][0]
+            resp = {
+                "text": generation.text,
+                "llm_output": generated_responses.llm_output,
+            }
+            params = {**self._identifying_params, **kwargs}
+            pl_request_id = promptlayer_api_request(
+                "langchain.PromptLayerOpenAI",
+                "langchain",
+                [prompt],
+                params,
+                self.pl_tags,
+                resp,
+                request_start_time,
+                request_end_time,
+                get_api_key(),
+                return_pl_id=self.return_pl_id,
+            )
+            if self.return_pl_id:
+                if generation.generation_info is None or not isinstance(
+                    generation.generation_info, dict
+                ):
+                    generation.generation_info = {}
+                generation.generation_info["pl_request_id"] = pl_request_id
+        return generated_responses
+
+    async def _agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        from promptlayer.utils import get_api_key, promptlayer_api_request_async
+
+        request_start_time = datetime.datetime.now().timestamp()
+        generated_responses = await super()._agenerate(prompts, stop, run_manager)
+        request_end_time = datetime.datetime.now().timestamp()
+        for i in range(len(prompts)):
+            prompt = prompts[i]
+            generation = generated_responses.generations[i][0]
+            resp = {
+                "text": generation.text,
+                "llm_output": generated_responses.llm_output,
+            }
+            params = {**self._identifying_params, **kwargs}
+            pl_request_id = await promptlayer_api_request_async(
+                "langchain.PromptLayerOpenAI.async",
+                "langchain",
+                [prompt],
+                params,
+                self.pl_tags,
+                resp,
+                request_start_time,
+                request_end_time,
+                get_api_key(),
+                return_pl_id=self.return_pl_id,
+            )
+            if self.return_pl_id:
+                if generation.generation_info is None or not isinstance(
+                    generation.generation_info, dict
+                ):
+                    generation.generation_info = {}
+                generation.generation_info["pl_request_id"] = pl_request_id
+        return generated_responses
+
+
+class PromptLayerOpenAIChat(OpenAIChat):
+    """PromptLayer OpenAI large language models.
+
+    To use, you should have the ``openai`` and ``promptlayer`` python
+    package installed, and the environment variable ``OPENAI_API_KEY``
+    and ``PROMPTLAYER_API_KEY`` set with your openAI API key and
+    promptlayer key respectively.
+
+    All parameters that can be passed to the OpenAIChat LLM can also
+    be passed here. The PromptLayerOpenAIChat adds two optional
+
+    parameters:
+        ``pl_tags``: List of strings to tag the request with.
+        ``return_pl_id``: If True, the PromptLayer request ID will be
+            returned in the ``generation_info`` field of the
+            ``Generation`` object.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import PromptLayerOpenAIChat
+            openaichat = PromptLayerOpenAIChat(model_name="gpt-3.5-turbo")
+    """
+
+    pl_tags: Optional[List[str]]
+    return_pl_id: Optional[bool] = False
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Call OpenAI generate and then call PromptLayer API to log the request."""
+        from promptlayer.utils import get_api_key, promptlayer_api_request
+
+        request_start_time = datetime.datetime.now().timestamp()
+        generated_responses = super()._generate(prompts, stop, run_manager)
+        request_end_time = datetime.datetime.now().timestamp()
+        for i in range(len(prompts)):
+            prompt = prompts[i]
+            generation = generated_responses.generations[i][0]
+            resp = {
+                "text": generation.text,
+                "llm_output": generated_responses.llm_output,
+            }
+            params = {**self._identifying_params, **kwargs}
+            pl_request_id = promptlayer_api_request(
+                "langchain.PromptLayerOpenAIChat",
+                "langchain",
+                [prompt],
+                params,
+                self.pl_tags,
+                resp,
+                request_start_time,
+                request_end_time,
+                get_api_key(),
+                return_pl_id=self.return_pl_id,
+            )
+            if self.return_pl_id:
+                if generation.generation_info is None or not isinstance(
+                    generation.generation_info, dict
+                ):
+                    generation.generation_info = {}
+                generation.generation_info["pl_request_id"] = pl_request_id
+        return generated_responses
+
+    async def _agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        from promptlayer.utils import get_api_key, promptlayer_api_request_async
+
+        request_start_time = datetime.datetime.now().timestamp()
+        generated_responses = await super()._agenerate(prompts, stop, run_manager)
+        request_end_time = datetime.datetime.now().timestamp()
+        for i in range(len(prompts)):
+            prompt = prompts[i]
+            generation = generated_responses.generations[i][0]
+            resp = {
+                "text": generation.text,
+                "llm_output": generated_responses.llm_output,
+            }
+            params = {**self._identifying_params, **kwargs}
+            pl_request_id = await promptlayer_api_request_async(
+                "langchain.PromptLayerOpenAIChat.async",
+                "langchain",
+                [prompt],
+                params,
+                self.pl_tags,
+                resp,
+                request_start_time,
+                request_end_time,
+                get_api_key(),
+                return_pl_id=self.return_pl_id,
+            )
+            if self.return_pl_id:
+                if generation.generation_info is None or not isinstance(
+                    generation.generation_info, dict
+                ):
+                    generation.generation_info = {}
+                generation.generation_info["pl_request_id"] = pl_request_id
+        return generated_responses
diff --git a/llm/Lib/site-packages/langchain_community/llms/replicate.py b/llm/Lib/site-packages/langchain_community/llms/replicate.py
new file mode 100644
index 0000000000000000000000000000000000000000..0a1d9cffccdabd705756a772e690df33687cd611
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/replicate.py
@@ -0,0 +1,231 @@
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Any, Dict, Iterator, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import Extra, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+if TYPE_CHECKING:
+    from replicate.prediction import Prediction
+
+logger = logging.getLogger(__name__)
+
+
+class Replicate(LLM):
+    """Replicate models.
+
+    To use, you should have the ``replicate`` python package installed,
+    and the environment variable ``REPLICATE_API_TOKEN`` set with your API token.
+    You can find your token here: https://replicate.com/account
+
+    The model param is required, but any other model parameters can also
+    be passed in with the format model_kwargs={model_param: value, ...}
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Replicate
+
+            replicate = Replicate(
+                model=(
+                    "stability-ai/stable-diffusion: "
+                    "27b93a2413e7f36cd83da926f3656280b2931564ff050bf9575f1fdf9bcd7478",
+                ),
+                model_kwargs={"image_dimensions": "512x512"}
+            )
+    """
+
+    model: str
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict, alias="input")
+    replicate_api_token: Optional[str] = None
+    prompt_key: Optional[str] = None
+    version_obj: Any = Field(default=None, exclude=True)
+    """Optionally pass in the model version object during initialization to avoid
+        having to make an extra API call to retrieve it during streaming. NOTE: not
+        serializable, is excluded from serialization.
+    """
+
+    streaming: bool = False
+    """Whether to stream the results."""
+
+    stop: List[str] = Field(default_factory=list)
+    """Stop sequences to early-terminate generation."""
+
+    class Config:
+        """Configuration for this pydantic config."""
+
+        allow_population_by_field_name = True
+        extra = Extra.forbid
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"replicate_api_token": "REPLICATE_API_TOKEN"}
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "llms", "replicate"]
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = {field.alias for field in cls.__fields__.values()}
+
+        input = values.pop("input", {})
+        if input:
+            logger.warning(
+                "Init param `input` is deprecated, please use `model_kwargs` instead."
+            )
+        extra = {**values.pop("model_kwargs", {}), **input}
+        for field_name in list(values):
+            if field_name not in all_required_field_names:
+                if field_name in extra:
+                    raise ValueError(f"Found {field_name} supplied twice.")
+                logger.warning(
+                    f"""{field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        replicate_api_token = get_from_dict_or_env(
+            values, "replicate_api_token", "REPLICATE_API_TOKEN"
+        )
+        values["replicate_api_token"] = replicate_api_token
+        return values
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model": self.model,
+            "model_kwargs": self.model_kwargs,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of model."""
+        return "replicate"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call to replicate endpoint."""
+        if self.streaming:
+            completion: Optional[str] = None
+            for chunk in self._stream(
+                prompt, stop=stop, run_manager=run_manager, **kwargs
+            ):
+                if completion is None:
+                    completion = chunk.text
+                else:
+                    completion += chunk.text
+        else:
+            prediction = self._create_prediction(prompt, **kwargs)
+            prediction.wait()
+            if prediction.status == "failed":
+                raise RuntimeError(prediction.error)
+            if isinstance(prediction.output, str):
+                completion = prediction.output
+            else:
+                completion = "".join(prediction.output)
+        assert completion is not None
+        stop_conditions = stop or self.stop
+        for s in stop_conditions:
+            if s in completion:
+                completion = completion[: completion.find(s)]
+        return completion
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        prediction = self._create_prediction(prompt, **kwargs)
+        stop_conditions = stop or self.stop
+        stop_condition_reached = False
+        current_completion: str = ""
+        for output in prediction.output_iterator():
+            current_completion += output
+            # test for stop conditions, if specified
+            for s in stop_conditions:
+                if s in current_completion:
+                    prediction.cancel()
+                    stop_condition_reached = True
+                    # Potentially some tokens that should still be yielded before ending
+                    # stream.
+                    stop_index = max(output.find(s), 0)
+                    output = output[:stop_index]
+                    if not output:
+                        break
+            if output:
+                if run_manager:
+                    run_manager.on_llm_new_token(
+                        output,
+                        verbose=self.verbose,
+                    )
+                yield GenerationChunk(text=output)
+            if stop_condition_reached:
+                break
+
+    def _create_prediction(self, prompt: str, **kwargs: Any) -> Prediction:
+        try:
+            import replicate as replicate_python
+        except ImportError:
+            raise ImportError(
+                "Could not import replicate python package. "
+                "Please install it with `pip install replicate`."
+            )
+
+        # get the model and version
+        if self.version_obj is None:
+            if ":" in self.model:
+                model_str, version_str = self.model.split(":")
+                model = replicate_python.models.get(model_str)
+                self.version_obj = model.versions.get(version_str)
+            else:
+                model = replicate_python.models.get(self.model)
+                self.version_obj = model.latest_version
+
+        if self.prompt_key is None:
+            # sort through the openapi schema to get the name of the first input
+            input_properties = sorted(
+                self.version_obj.openapi_schema["components"]["schemas"]["Input"][
+                    "properties"
+                ].items(),
+                key=lambda item: item[1].get("x-order", 0),
+            )
+
+            self.prompt_key = input_properties[0][0]
+
+        input_: Dict = {
+            self.prompt_key: prompt,
+            **self.model_kwargs,
+            **kwargs,
+        }
+
+        # if it's an official model
+        if ":" not in self.model:
+            return replicate_python.models.predictions.create(self.model, input=input_)
+        else:
+            return replicate_python.predictions.create(
+                version=self.version_obj, input=input_
+            )
diff --git a/llm/Lib/site-packages/langchain_community/llms/rwkv.py b/llm/Lib/site-packages/langchain_community/llms/rwkv.py
new file mode 100644
index 0000000000000000000000000000000000000000..470c20053729ca740bb278d8706799a0477ac715
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/rwkv.py
@@ -0,0 +1,234 @@
+"""RWKV models.
+
+Based on https://github.com/saharNooby/rwkv.cpp/blob/master/rwkv/chat_with_bot.py
+         https://github.com/BlinkDL/ChatRWKV/blob/main/v2/chat.py
+"""
+from typing import Any, Dict, List, Mapping, Optional, Set
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+
+class RWKV(LLM, BaseModel):
+    """RWKV language models.
+
+    To use, you should have the ``rwkv`` python package installed, the
+    pre-trained model file, and the model's config information.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import RWKV
+            model = RWKV(model="./models/rwkv-3b-fp16.bin", strategy="cpu fp32")
+
+            # Simplest invocation
+            response = model("Once upon a time, ")
+    """
+
+    model: str
+    """Path to the pre-trained RWKV model file."""
+
+    tokens_path: str
+    """Path to the RWKV tokens file."""
+
+    strategy: str = "cpu fp32"
+    """Token context window."""
+
+    rwkv_verbose: bool = True
+    """Print debug information."""
+
+    temperature: float = 1.0
+    """The temperature to use for sampling."""
+
+    top_p: float = 0.5
+    """The top-p value to use for sampling."""
+
+    penalty_alpha_frequency: float = 0.4
+    """Positive values penalize new tokens based on their existing frequency
+    in the text so far, decreasing the model's likelihood to repeat the same
+    line verbatim.."""
+
+    penalty_alpha_presence: float = 0.4
+    """Positive values penalize new tokens based on whether they appear
+    in the text so far, increasing the model's likelihood to talk about
+    new topics.."""
+
+    CHUNK_LEN: int = 256
+    """Batch size for prompt processing."""
+
+    max_tokens_per_generation: int = 256
+    """Maximum number of tokens to generate."""
+
+    client: Any = None  #: :meta private:
+
+    tokenizer: Any = None  #: :meta private:
+
+    pipeline: Any = None  #: :meta private:
+
+    model_tokens: Any = None  #: :meta private:
+
+    model_state: Any = None  #: :meta private:
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "verbose": self.verbose,
+            "top_p": self.top_p,
+            "temperature": self.temperature,
+            "penalty_alpha_frequency": self.penalty_alpha_frequency,
+            "penalty_alpha_presence": self.penalty_alpha_presence,
+            "CHUNK_LEN": self.CHUNK_LEN,
+            "max_tokens_per_generation": self.max_tokens_per_generation,
+        }
+
+    @staticmethod
+    def _rwkv_param_names() -> Set[str]:
+        """Get the identifying parameters."""
+        return {
+            "verbose",
+        }
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in the environment."""
+        try:
+            import tokenizers
+        except ImportError:
+            raise ImportError(
+                "Could not import tokenizers python package. "
+                "Please install it with `pip install tokenizers`."
+            )
+        try:
+            from rwkv.model import RWKV as RWKVMODEL
+            from rwkv.utils import PIPELINE
+
+            values["tokenizer"] = tokenizers.Tokenizer.from_file(values["tokens_path"])
+
+            rwkv_keys = cls._rwkv_param_names()
+            model_kwargs = {k: v for k, v in values.items() if k in rwkv_keys}
+            model_kwargs["verbose"] = values["rwkv_verbose"]
+            values["client"] = RWKVMODEL(
+                values["model"], strategy=values["strategy"], **model_kwargs
+            )
+            values["pipeline"] = PIPELINE(values["client"], values["tokens_path"])
+
+        except ImportError:
+            raise ImportError(
+                "Could not import rwkv python package. "
+                "Please install it with `pip install rwkv`."
+            )
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model": self.model,
+            **self._default_params,
+            **{k: v for k, v in self.__dict__.items() if k in RWKV._rwkv_param_names()},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return the type of llm."""
+        return "rwkv"
+
+    def run_rnn(self, _tokens: List[str], newline_adj: int = 0) -> Any:
+        AVOID_REPEAT_TOKENS = []
+        AVOID_REPEAT = "，：？！"
+        for i in AVOID_REPEAT:
+            dd = self.pipeline.encode(i)
+            assert len(dd) == 1
+            AVOID_REPEAT_TOKENS += dd
+
+        tokens = [int(x) for x in _tokens]
+        self.model_tokens += tokens
+
+        out: Any = None
+
+        while len(tokens) > 0:
+            out, self.model_state = self.client.forward(
+                tokens[: self.CHUNK_LEN], self.model_state
+            )
+            tokens = tokens[self.CHUNK_LEN :]
+        END_OF_LINE = 187
+        out[END_OF_LINE] += newline_adj  # adjust \n probability
+
+        if self.model_tokens[-1] in AVOID_REPEAT_TOKENS:
+            out[self.model_tokens[-1]] = -999999999
+        return out
+
+    def rwkv_generate(self, prompt: str) -> str:
+        self.model_state = None
+        self.model_tokens = []
+        logits = self.run_rnn(self.tokenizer.encode(prompt).ids)
+        begin = len(self.model_tokens)
+        out_last = begin
+
+        occurrence: Dict = {}
+
+        decoded = ""
+        for i in range(self.max_tokens_per_generation):
+            for n in occurrence:
+                logits[n] -= (
+                    self.penalty_alpha_presence
+                    + occurrence[n] * self.penalty_alpha_frequency
+                )
+            token = self.pipeline.sample_logits(
+                logits, temperature=self.temperature, top_p=self.top_p
+            )
+
+            END_OF_TEXT = 0
+            if token == END_OF_TEXT:
+                break
+            if token not in occurrence:
+                occurrence[token] = 1
+            else:
+                occurrence[token] += 1
+
+            logits = self.run_rnn([token])
+            xxx = self.tokenizer.decode(self.model_tokens[out_last:])
+            if "\ufffd" not in xxx:  # avoid utf-8 display issues
+                decoded += xxx
+                out_last = begin + i + 1
+                if i >= self.max_tokens_per_generation - 100:
+                    break
+
+        return decoded
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        r"""RWKV generation
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: A list of strings to stop generation when encountered.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                prompt = "Once upon a time, "
+                response = model(prompt, n_predict=55)
+        """
+        text = self.rwkv_generate(prompt)
+
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/sagemaker_endpoint.py b/llm/Lib/site-packages/langchain_community/llms/sagemaker_endpoint.py
new file mode 100644
index 0000000000000000000000000000000000000000..7027a3ffa569a098a47e784e9a777c055c023731
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/sagemaker_endpoint.py
@@ -0,0 +1,370 @@
+"""Sagemaker InvokeEndpoint API."""
+import io
+import json
+from abc import abstractmethod
+from typing import Any, Dict, Generic, Iterator, List, Mapping, Optional, TypeVar, Union
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, root_validator
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+INPUT_TYPE = TypeVar("INPUT_TYPE", bound=Union[str, List[str]])
+OUTPUT_TYPE = TypeVar("OUTPUT_TYPE", bound=Union[str, List[List[float]], Iterator])
+
+
+class LineIterator:
+    """Parse the byte stream input.
+
+    The output of the model will be in the following format:
+
+    b'{"outputs": [" a"]}\n'
+    b'{"outputs": [" challenging"]}\n'
+    b'{"outputs": [" problem"]}\n'
+    ...
+
+    While usually each PayloadPart event from the event stream will
+    contain a byte array with a full json, this is not guaranteed
+    and some of the json objects may be split acrossPayloadPart events.
+
+    For example:
+
+    {'PayloadPart': {'Bytes': b'{"outputs": '}}
+    {'PayloadPart': {'Bytes': b'[" problem"]}\n'}}
+
+
+    This class accounts for this by concatenating bytes written via the 'write' function
+    and then exposing a method which will return lines (ending with a '\n' character)
+    within the buffer via the 'scan_lines' function.
+    It maintains the position of the last read position to ensure
+    that previous bytes are not exposed again.
+
+    For more details see:
+    https://aws.amazon.com/blogs/machine-learning/elevating-the-generative-ai-experience-introducing-streaming-support-in-amazon-sagemaker-hosting/
+    """
+
+    def __init__(self, stream: Any) -> None:
+        self.byte_iterator = iter(stream)
+        self.buffer = io.BytesIO()
+        self.read_pos = 0
+
+    def __iter__(self) -> "LineIterator":
+        return self
+
+    def __next__(self) -> Any:
+        while True:
+            self.buffer.seek(self.read_pos)
+            line = self.buffer.readline()
+            if line and line[-1] == ord("\n"):
+                self.read_pos += len(line)
+                return line[:-1]
+            try:
+                chunk = next(self.byte_iterator)
+            except StopIteration:
+                if self.read_pos < self.buffer.getbuffer().nbytes:
+                    continue
+                raise
+            if "PayloadPart" not in chunk:
+                # Unknown Event Type
+                continue
+            self.buffer.seek(0, io.SEEK_END)
+            self.buffer.write(chunk["PayloadPart"]["Bytes"])
+
+
+class ContentHandlerBase(Generic[INPUT_TYPE, OUTPUT_TYPE]):
+    """Handler class to transform input from LLM to a
+    format that SageMaker endpoint expects.
+
+    Similarly, the class handles transforming output from the
+    SageMaker endpoint to a format that LLM class expects.
+    """
+
+    """
+    Example:
+        .. code-block:: python
+
+            class ContentHandler(ContentHandlerBase):
+                content_type = "application/json"
+                accepts = "application/json"
+
+                def transform_input(self, prompt: str, model_kwargs: Dict) -> bytes:
+                    input_str = json.dumps({prompt: prompt, **model_kwargs})
+                    return input_str.encode('utf-8')
+                
+                def transform_output(self, output: bytes) -> str:
+                    response_json = json.loads(output.read().decode("utf-8"))
+                    return response_json[0]["generated_text"]
+    """
+
+    content_type: Optional[str] = "text/plain"
+    """The MIME type of the input data passed to endpoint"""
+
+    accepts: Optional[str] = "text/plain"
+    """The MIME type of the response data returned from endpoint"""
+
+    @abstractmethod
+    def transform_input(self, prompt: INPUT_TYPE, model_kwargs: Dict) -> bytes:
+        """Transforms the input to a format that model can accept
+        as the request Body. Should return bytes or seekable file
+        like object in the format specified in the content_type
+        request header.
+        """
+
+    @abstractmethod
+    def transform_output(self, output: bytes) -> OUTPUT_TYPE:
+        """Transforms the output from the model to string that
+        the LLM class expects.
+        """
+
+
+class LLMContentHandler(ContentHandlerBase[str, str]):
+    """Content handler for LLM class."""
+
+
+class SagemakerEndpoint(LLM):
+    """Sagemaker Inference Endpoint models.
+
+    To use, you must supply the endpoint name from your deployed
+    Sagemaker model & the region where it is deployed.
+
+    To authenticate, the AWS client uses the following methods to
+    automatically load credentials:
+    https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html
+
+    If a specific credential profile should be used, you must pass
+    the name of the profile from the ~/.aws/credentials file that is to be used.
+
+    Make sure the credentials / roles used have the required policies to
+    access the Sagemaker endpoint.
+    See: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html
+    """
+
+    """
+    Args:        
+
+        region_name: The aws region e.g., `us-west-2`.
+            Fallsback to AWS_DEFAULT_REGION env variable
+            or region specified in ~/.aws/config.
+
+        credentials_profile_name: The name of the profile in the ~/.aws/credentials
+            or ~/.aws/config files, which has either access keys or role information
+            specified. If not specified, the default credential profile or, if on an
+            EC2 instance, credentials from IMDS will be used.
+
+        client: boto3 client for Sagemaker Endpoint
+
+        content_handler: Implementation for model specific LLMContentHandler 
+
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import SagemakerEndpoint
+            endpoint_name = (
+                "my-endpoint-name"
+            )
+            region_name = (
+                "us-west-2"
+            )
+            credentials_profile_name = (
+                "default"
+            )
+            se = SagemakerEndpoint(
+                endpoint_name=endpoint_name,
+                region_name=region_name,
+                credentials_profile_name=credentials_profile_name
+            )
+
+        #Use with boto3 client
+            client = boto3.client(
+                        "sagemaker-runtime",
+                        region_name=region_name
+                    )
+
+            se = SagemakerEndpoint(
+                endpoint_name=endpoint_name,
+                client=client
+            )
+
+    """
+    client: Any = None
+    """Boto3 client for sagemaker runtime"""
+
+    endpoint_name: str = ""
+    """The name of the endpoint from the deployed Sagemaker model.
+    Must be unique within an AWS Region."""
+
+    region_name: str = ""
+    """The aws region where the Sagemaker model is deployed, eg. `us-west-2`."""
+
+    credentials_profile_name: Optional[str] = None
+    """The name of the profile in the ~/.aws/credentials or ~/.aws/config files, which
+    has either access keys or role information specified.
+    If not specified, the default credential profile or, if on an EC2 instance,
+    credentials from IMDS will be used.
+    See: https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html
+    """
+
+    content_handler: LLMContentHandler
+    """The content handler class that provides an input and
+    output transform functions to handle formats between LLM
+    and the endpoint.
+    """
+
+    streaming: bool = False
+    """Whether to stream the results."""
+
+    """
+     Example:
+        .. code-block:: python
+
+        from langchain_community.llms.sagemaker_endpoint import LLMContentHandler
+
+        class ContentHandler(LLMContentHandler):
+                content_type = "application/json"
+                accepts = "application/json"
+
+                def transform_input(self, prompt: str, model_kwargs: Dict) -> bytes:
+                    input_str = json.dumps({prompt: prompt, **model_kwargs})
+                    return input_str.encode('utf-8')
+                
+                def transform_output(self, output: bytes) -> str:
+                    response_json = json.loads(output.read().decode("utf-8"))
+                    return response_json[0]["generated_text"]
+    """
+
+    model_kwargs: Optional[Dict] = None
+    """Keyword arguments to pass to the model."""
+
+    endpoint_kwargs: Optional[Dict] = None
+    """Optional attributes passed to the invoke_endpoint
+    function. See `boto3`_. docs for more info.
+    .. _boto3: <https://boto3.amazonaws.com/v1/documentation/api/latest/index.html>
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Dont do anything if client provided externally"""
+        if values.get("client") is not None:
+            return values
+
+        """Validate that AWS credentials to and python package exists in environment."""
+        try:
+            import boto3
+
+            try:
+                if values["credentials_profile_name"] is not None:
+                    session = boto3.Session(
+                        profile_name=values["credentials_profile_name"]
+                    )
+                else:
+                    # use default credentials
+                    session = boto3.Session()
+
+                values["client"] = session.client(
+                    "sagemaker-runtime", region_name=values["region_name"]
+                )
+
+            except Exception as e:
+                raise ValueError(
+                    "Could not load credentials to authenticate with AWS client. "
+                    "Please check that credentials in the specified "
+                    "profile name are valid."
+                ) from e
+
+        except ImportError:
+            raise ImportError(
+                "Could not import boto3 python package. "
+                "Please install it with `pip install boto3`."
+            )
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            **{"endpoint_name": self.endpoint_name},
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "sagemaker_endpoint"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Sagemaker inference endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = se("Tell me a joke.")
+        """
+        _model_kwargs = self.model_kwargs or {}
+        _model_kwargs = {**_model_kwargs, **kwargs}
+        _endpoint_kwargs = self.endpoint_kwargs or {}
+
+        body = self.content_handler.transform_input(prompt, _model_kwargs)
+        content_type = self.content_handler.content_type
+        accepts = self.content_handler.accepts
+
+        if self.streaming and run_manager:
+            try:
+                resp = self.client.invoke_endpoint_with_response_stream(
+                    EndpointName=self.endpoint_name,
+                    Body=body,
+                    ContentType=self.content_handler.content_type,
+                    **_endpoint_kwargs,
+                )
+                iterator = LineIterator(resp["Body"])
+                current_completion: str = ""
+                for line in iterator:
+                    resp = json.loads(line)
+                    resp_output = resp.get("outputs")[0]
+                    if stop is not None:
+                        # Uses same approach as below
+                        resp_output = enforce_stop_tokens(resp_output, stop)
+                    current_completion += resp_output
+                    run_manager.on_llm_new_token(resp_output)
+                return current_completion
+            except Exception as e:
+                raise ValueError(f"Error raised by streaming inference endpoint: {e}")
+        else:
+            try:
+                response = self.client.invoke_endpoint(
+                    EndpointName=self.endpoint_name,
+                    Body=body,
+                    ContentType=content_type,
+                    Accept=accepts,
+                    **_endpoint_kwargs,
+                )
+            except Exception as e:
+                raise ValueError(f"Error raised by inference endpoint: {e}")
+
+            text = self.content_handler.transform_output(response["Body"])
+            if stop is not None:
+                # This is a bit hacky, but I can't figure out a better way to enforce
+                # stop tokens when making calls to the sagemaker endpoint.
+                text = enforce_stop_tokens(text, stop)
+
+            return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/self_hosted.py b/llm/Lib/site-packages/langchain_community/llms/self_hosted.py
new file mode 100644
index 0000000000000000000000000000000000000000..e94f2d405417c853645f63aa1a2c74ca69b1c23d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/self_hosted.py
@@ -0,0 +1,235 @@
+import importlib.util
+import logging
+import pickle
+from typing import Any, Callable, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+def _generate_text(
+    pipeline: Any,
+    prompt: str,
+    *args: Any,
+    stop: Optional[List[str]] = None,
+    **kwargs: Any,
+) -> str:
+    """Inference function to send to the remote hardware.
+
+    Accepts a pipeline callable (or, more likely,
+    a key pointing to the model on the cluster's object store)
+    and returns text predictions for each document
+    in the batch.
+    """
+    text = pipeline(prompt, *args, **kwargs)
+    if stop is not None:
+        text = enforce_stop_tokens(text, stop)
+    return text
+
+
+def _send_pipeline_to_device(pipeline: Any, device: int) -> Any:
+    """Send a pipeline to a device on the cluster."""
+    if isinstance(pipeline, str):
+        with open(pipeline, "rb") as f:
+            pipeline = pickle.load(f)
+
+    if importlib.util.find_spec("torch") is not None:
+        import torch
+
+        cuda_device_count = torch.cuda.device_count()
+        if device < -1 or (device >= cuda_device_count):
+            raise ValueError(
+                f"Got device=={device}, "
+                f"device is required to be within [-1, {cuda_device_count})"
+            )
+        if device < 0 and cuda_device_count > 0:
+            logger.warning(
+                "Device has %d GPUs available. "
+                "Provide device={deviceId} to `from_model_id` to use available"
+                "GPUs for execution. deviceId is -1 for CPU and "
+                "can be a positive integer associated with CUDA device id.",
+                cuda_device_count,
+            )
+
+        pipeline.device = torch.device(device)
+        pipeline.model = pipeline.model.to(pipeline.device)
+    return pipeline
+
+
+class SelfHostedPipeline(LLM):
+    """Model inference on self-hosted remote hardware.
+
+    Supported hardware includes auto-launched instances on AWS, GCP, Azure,
+    and Lambda, as well as servers specified
+    by IP address and SSH credentials (such as on-prem, or another
+    cloud like Paperspace, Coreweave, etc.).
+
+    To use, you should have the ``runhouse`` python package installed.
+
+    Example for custom pipeline and inference functions:
+        .. code-block:: python
+
+            from langchain_community.llms import SelfHostedPipeline
+            from transformers import AutoModelForCausalLM, AutoTokenizer, pipeline
+            import runhouse as rh
+
+            def load_pipeline():
+                tokenizer = AutoTokenizer.from_pretrained("gpt2")
+                model = AutoModelForCausalLM.from_pretrained("gpt2")
+                return pipeline(
+                    "text-generation", model=model, tokenizer=tokenizer,
+                    max_new_tokens=10
+                )
+            def inference_fn(pipeline, prompt, stop = None):
+                return pipeline(prompt)[0]["generated_text"]
+
+            gpu = rh.cluster(name="rh-a10x", instance_type="A100:1")
+            llm = SelfHostedPipeline(
+                model_load_fn=load_pipeline,
+                hardware=gpu,
+                model_reqs=model_reqs, inference_fn=inference_fn
+            )
+    Example for <2GB model (can be serialized and sent directly to the server):
+        .. code-block:: python
+
+            from langchain_community.llms import SelfHostedPipeline
+            import runhouse as rh
+            gpu = rh.cluster(name="rh-a10x", instance_type="A100:1")
+            my_model = ...
+            llm = SelfHostedPipeline.from_pipeline(
+                pipeline=my_model,
+                hardware=gpu,
+                model_reqs=["./", "torch", "transformers"],
+            )
+    Example passing model path for larger models:
+        .. code-block:: python
+
+            from langchain_community.llms import SelfHostedPipeline
+            import runhouse as rh
+            import pickle
+            from transformers import pipeline
+
+            generator = pipeline(model="gpt2")
+            rh.blob(pickle.dumps(generator), path="models/pipeline.pkl"
+                ).save().to(gpu, path="models")
+            llm = SelfHostedPipeline.from_pipeline(
+                pipeline="models/pipeline.pkl",
+                hardware=gpu,
+                model_reqs=["./", "torch", "transformers"],
+            )
+    """
+
+    pipeline_ref: Any  #: :meta private:
+    client: Any  #: :meta private:
+    inference_fn: Callable = _generate_text  #: :meta private:
+    """Inference function to send to the remote hardware."""
+    hardware: Any
+    """Remote hardware to send the inference function to."""
+    model_load_fn: Callable
+    """Function to load the model remotely on the server."""
+    load_fn_kwargs: Optional[dict] = None
+    """Keyword arguments to pass to the model load function."""
+    model_reqs: List[str] = ["./", "torch"]
+    """Requirements to install on hardware to inference the model."""
+
+    allow_dangerous_deserialization: bool = False
+    """Allow deserialization using pickle which can be dangerous if 
+    loading compromised data.
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def __init__(self, **kwargs: Any):
+        """Init the pipeline with an auxiliary function.
+
+        The load function must be in global scope to be imported
+        and run on the server, i.e. in a module and not a REPL or closure.
+        Then, initialize the remote inference function.
+        """
+        if not kwargs.get("allow_dangerous_deserialization"):
+            raise ValueError(
+                "SelfHostedPipeline relies on the pickle module. "
+                "You will need to set allow_dangerous_deserialization=True "
+                "if you want to opt-in to allow deserialization of data using pickle."
+                "Data can be compromised by a malicious actor if "
+                "not handled properly to include "
+                "a malicious payload that when deserialized with "
+                "pickle can execute arbitrary code. "
+            )
+        super().__init__(**kwargs)
+        try:
+            import runhouse as rh
+
+        except ImportError:
+            raise ImportError(
+                "Could not import runhouse python package. "
+                "Please install it with `pip install runhouse`."
+            )
+
+        remote_load_fn = rh.function(fn=self.model_load_fn).to(
+            self.hardware, reqs=self.model_reqs
+        )
+        _load_fn_kwargs = self.load_fn_kwargs or {}
+        self.pipeline_ref = remote_load_fn.remote(**_load_fn_kwargs)
+
+        self.client = rh.function(fn=self.inference_fn).to(
+            self.hardware, reqs=self.model_reqs
+        )
+
+    @classmethod
+    def from_pipeline(
+        cls,
+        pipeline: Any,
+        hardware: Any,
+        model_reqs: Optional[List[str]] = None,
+        device: int = 0,
+        **kwargs: Any,
+    ) -> LLM:
+        """Init the SelfHostedPipeline from a pipeline object or string."""
+        if not isinstance(pipeline, str):
+            logger.warning(
+                "Serializing pipeline to send to remote hardware. "
+                "Note, it can be quite slow"
+                "to serialize and send large models with each execution. "
+                "Consider sending the pipeline"
+                "to the cluster and passing the path to the pipeline instead."
+            )
+
+        load_fn_kwargs = {"pipeline": pipeline, "device": device}
+        return cls(
+            load_fn_kwargs=load_fn_kwargs,
+            model_load_fn=_send_pipeline_to_device,
+            hardware=hardware,
+            model_reqs=["transformers", "torch"] + (model_reqs or []),
+            **kwargs,
+        )
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"hardware": self.hardware},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        return "self_hosted_llm"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        return self.client(
+            pipeline=self.pipeline_ref, prompt=prompt, stop=stop, **kwargs
+        )
diff --git a/llm/Lib/site-packages/langchain_community/llms/self_hosted_hugging_face.py b/llm/Lib/site-packages/langchain_community/llms/self_hosted_hugging_face.py
new file mode 100644
index 0000000000000000000000000000000000000000..465d74c67708243a8c6f9a838827c0c7381a8c0a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/self_hosted_hugging_face.py
@@ -0,0 +1,213 @@
+import importlib.util
+import logging
+from typing import Any, Callable, List, Mapping, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.pydantic_v1 import Extra
+
+from langchain_community.llms.self_hosted import SelfHostedPipeline
+from langchain_community.llms.utils import enforce_stop_tokens
+
+DEFAULT_MODEL_ID = "gpt2"
+DEFAULT_TASK = "text-generation"
+VALID_TASKS = ("text2text-generation", "text-generation", "summarization")
+
+logger = logging.getLogger(__name__)
+
+
+def _generate_text(
+    pipeline: Any,
+    prompt: str,
+    *args: Any,
+    stop: Optional[List[str]] = None,
+    **kwargs: Any,
+) -> str:
+    """Inference function to send to the remote hardware.
+
+    Accepts a Hugging Face pipeline (or more likely,
+    a key pointing to such a pipeline on the cluster's object store)
+    and returns generated text.
+    """
+    response = pipeline(prompt, *args, **kwargs)
+    if pipeline.task == "text-generation":
+        # Text generation return includes the starter text.
+        text = response[0]["generated_text"][len(prompt) :]
+    elif pipeline.task == "text2text-generation":
+        text = response[0]["generated_text"]
+    elif pipeline.task == "summarization":
+        text = response[0]["summary_text"]
+    else:
+        raise ValueError(
+            f"Got invalid task {pipeline.task}, "
+            f"currently only {VALID_TASKS} are supported"
+        )
+    if stop is not None:
+        text = enforce_stop_tokens(text, stop)
+    return text
+
+
+def _load_transformer(
+    model_id: str = DEFAULT_MODEL_ID,
+    task: str = DEFAULT_TASK,
+    device: int = 0,
+    model_kwargs: Optional[dict] = None,
+) -> Any:
+    """Inference function to send to the remote hardware.
+
+    Accepts a huggingface model_id and returns a pipeline for the task.
+    """
+    from transformers import AutoModelForCausalLM, AutoModelForSeq2SeqLM, AutoTokenizer
+    from transformers import pipeline as hf_pipeline
+
+    _model_kwargs = model_kwargs or {}
+    tokenizer = AutoTokenizer.from_pretrained(model_id, **_model_kwargs)
+
+    try:
+        if task == "text-generation":
+            model = AutoModelForCausalLM.from_pretrained(model_id, **_model_kwargs)
+        elif task in ("text2text-generation", "summarization"):
+            model = AutoModelForSeq2SeqLM.from_pretrained(model_id, **_model_kwargs)
+        else:
+            raise ValueError(
+                f"Got invalid task {task}, "
+                f"currently only {VALID_TASKS} are supported"
+            )
+    except ImportError as e:
+        raise ValueError(
+            f"Could not load the {task} model due to missing dependencies."
+        ) from e
+
+    if importlib.util.find_spec("torch") is not None:
+        import torch
+
+        cuda_device_count = torch.cuda.device_count()
+        if device < -1 or (device >= cuda_device_count):
+            raise ValueError(
+                f"Got device=={device}, "
+                f"device is required to be within [-1, {cuda_device_count})"
+            )
+        if device < 0 and cuda_device_count > 0:
+            logger.warning(
+                "Device has %d GPUs available. "
+                "Provide device={deviceId} to `from_model_id` to use available"
+                "GPUs for execution. deviceId is -1 for CPU and "
+                "can be a positive integer associated with CUDA device id.",
+                cuda_device_count,
+            )
+
+    pipeline = hf_pipeline(
+        task=task,
+        model=model,
+        tokenizer=tokenizer,
+        device=device,
+        model_kwargs=_model_kwargs,
+    )
+    if pipeline.task not in VALID_TASKS:
+        raise ValueError(
+            f"Got invalid task {pipeline.task}, "
+            f"currently only {VALID_TASKS} are supported"
+        )
+    return pipeline
+
+
+class SelfHostedHuggingFaceLLM(SelfHostedPipeline):
+    """HuggingFace Pipeline API to run on self-hosted remote hardware.
+
+    Supported hardware includes auto-launched instances on AWS, GCP, Azure,
+    and Lambda, as well as servers specified
+    by IP address and SSH credentials (such as on-prem, or another cloud
+    like Paperspace, Coreweave, etc.).
+
+    To use, you should have the ``runhouse`` python package installed.
+
+    Only supports `text-generation`, `text2text-generation` and `summarization` for now.
+
+    Example using from_model_id:
+        .. code-block:: python
+
+            from langchain_community.llms import SelfHostedHuggingFaceLLM
+            import runhouse as rh
+            gpu = rh.cluster(name="rh-a10x", instance_type="A100:1")
+            hf = SelfHostedHuggingFaceLLM(
+                model_id="google/flan-t5-large", task="text2text-generation",
+                hardware=gpu
+            )
+    Example passing fn that generates a pipeline (bc the pipeline is not serializable):
+        .. code-block:: python
+
+            from langchain_community.llms import SelfHostedHuggingFaceLLM
+            from transformers import AutoModelForCausalLM, AutoTokenizer, pipeline
+            import runhouse as rh
+
+            def get_pipeline():
+                model_id = "gpt2"
+                tokenizer = AutoTokenizer.from_pretrained(model_id)
+                model = AutoModelForCausalLM.from_pretrained(model_id)
+                pipe = pipeline(
+                    "text-generation", model=model, tokenizer=tokenizer
+                )
+                return pipe
+            hf = SelfHostedHuggingFaceLLM(
+                model_load_fn=get_pipeline, model_id="gpt2", hardware=gpu)
+    """
+
+    model_id: str = DEFAULT_MODEL_ID
+    """Hugging Face model_id to load the model."""
+    task: str = DEFAULT_TASK
+    """Hugging Face task ("text-generation", "text2text-generation" or
+    "summarization")."""
+    device: int = 0
+    """Device to use for inference. -1 for CPU, 0 for GPU, 1 for second GPU, etc."""
+    model_kwargs: Optional[dict] = None
+    """Keyword arguments to pass to the model."""
+    hardware: Any
+    """Remote hardware to send the inference function to."""
+    model_reqs: List[str] = ["./", "transformers", "torch"]
+    """Requirements to install on hardware to inference the model."""
+    model_load_fn: Callable = _load_transformer
+    """Function to load the model remotely on the server."""
+    inference_fn: Callable = _generate_text  #: :meta private:
+    """Inference function to send to the remote hardware."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def __init__(self, **kwargs: Any):
+        """Construct the pipeline remotely using an auxiliary function.
+
+        The load function needs to be importable to be imported
+        and run on the server, i.e. in a module and not a REPL or closure.
+        Then, initialize the remote inference function.
+        """
+        load_fn_kwargs = {
+            "model_id": kwargs.get("model_id", DEFAULT_MODEL_ID),
+            "task": kwargs.get("task", DEFAULT_TASK),
+            "device": kwargs.get("device", 0),
+            "model_kwargs": kwargs.get("model_kwargs", None),
+        }
+        super().__init__(load_fn_kwargs=load_fn_kwargs, **kwargs)
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"model_id": self.model_id},
+            **{"model_kwargs": self.model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        return "selfhosted_huggingface_pipeline"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        return self.client(
+            pipeline=self.pipeline_ref, prompt=prompt, stop=stop, **kwargs
+        )
diff --git a/llm/Lib/site-packages/langchain_community/llms/solar.py b/llm/Lib/site-packages/langchain_community/llms/solar.py
new file mode 100644
index 0000000000000000000000000000000000000000..e8e7b7e11d6694c9d05927df0889a98fbe1ae50b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/solar.py
@@ -0,0 +1,122 @@
+from typing import Any, Dict, List, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models import LLM
+from langchain_core.pydantic_v1 import BaseModel, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+SOLAR_SERVICE_URL_BASE = "https://api.upstage.ai/v1/solar"
+SOLAR_SERVICE = "https://api.upstage.ai"
+
+
+class _SolarClient(BaseModel):
+    """An API client that talks to the Solar server."""
+
+    api_key: SecretStr
+    """The API key to use for authentication."""
+    base_url: str = SOLAR_SERVICE_URL_BASE
+
+    def completion(self, request: Any) -> Any:
+        headers = {"Authorization": f"Bearer {self.api_key.get_secret_value()}"}
+        response = requests.post(
+            f"{self.base_url}/chat/completions",
+            headers=headers,
+            json=request,
+        )
+        if not response.ok:
+            raise ValueError(f"HTTP {response.status_code} error: {response.text}")
+        return response.json()["choices"][0]["message"]["content"]
+
+
+class SolarCommon(BaseModel):
+    """Common configuration for Solar LLMs."""
+
+    _client: _SolarClient
+    base_url: str = SOLAR_SERVICE_URL_BASE
+    solar_api_key: Optional[SecretStr] = Field(default=None, alias="api_key")
+    """Solar API key. Get it here: https://console.upstage.ai/services/solar"""
+    model_name: str = Field(default="solar-1-mini-chat", alias="model")
+    """Model name. Available models listed here: https://console.upstage.ai/services/solar"""
+    max_tokens: int = Field(default=1024)
+    temperature = 0.3
+
+    class Config:
+        allow_population_by_field_name = True
+        arbitrary_types_allowed = True
+        extra = "ignore"
+
+    @property
+    def lc_secrets(self) -> dict:
+        return {"solar_api_key": "SOLAR_API_KEY"}
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        return {
+            "model": self.model_name,
+            "max_tokens": self.max_tokens,
+            "temperature": self.temperature,
+        }
+
+    @property
+    def _invocation_params(self) -> Dict[str, Any]:
+        return {**{"model": self.model_name}, **self._default_params}
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        api_key = get_from_dict_or_env(values, "solar_api_key", "SOLAR_API_KEY")
+        if api_key is None or len(api_key) == 0:
+            raise ValueError("SOLAR_API_KEY must be configured")
+
+        values["solar_api_key"] = convert_to_secret_str(api_key)
+
+        if "base_url" not in values:
+            values["base_url"] = SOLAR_SERVICE_URL_BASE
+
+        if "base_url" in values and not values["base_url"].startswith(SOLAR_SERVICE):
+            raise ValueError("base_url must match with: " + SOLAR_SERVICE)
+
+        values["_client"] = _SolarClient(
+            api_key=values["solar_api_key"], base_url=values["base_url"]
+        )
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        return "solar"
+
+
+class Solar(SolarCommon, LLM):
+    """Solar large language models.
+
+    To use, you should have the environment variable
+    ``SOLAR_API_KEY`` set with your API key.
+    Referenced from https://console.upstage.ai/services/solar
+    """
+
+    class Config:
+        allow_population_by_field_name = True
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        request = self._invocation_params
+        request["messages"] = [{"role": "user", "content": prompt}]
+        request.update(kwargs)
+        text = self._client.completion(request)
+        if stop is not None:
+            # This is required since the stop tokens
+            # are not enforced by the model parameters
+            text = enforce_stop_tokens(text, stop)
+
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/sparkllm.py b/llm/Lib/site-packages/langchain_community/llms/sparkllm.py
new file mode 100644
index 0000000000000000000000000000000000000000..467952f35cba01456a4e8aa1ca8119bf3c591040
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/sparkllm.py
@@ -0,0 +1,384 @@
+from __future__ import annotations
+
+import base64
+import hashlib
+import hmac
+import json
+import logging
+import queue
+import threading
+from datetime import datetime
+from queue import Queue
+from time import mktime
+from typing import Any, Dict, Generator, Iterator, List, Optional
+from urllib.parse import urlencode, urlparse, urlunparse
+from wsgiref.handlers import format_date_time
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+class SparkLLM(LLM):
+    """iFlyTek Spark large language model.
+
+    To use, you should pass `app_id`, `api_key`, `api_secret`
+    as a named parameter to the constructor OR set environment
+    variables ``IFLYTEK_SPARK_APP_ID``, ``IFLYTEK_SPARK_API_KEY`` and
+    ``IFLYTEK_SPARK_API_SECRET``
+
+    Example:
+        .. code-block:: python
+
+        client = SparkLLM(
+            spark_app_id="<app_id>",
+            spark_api_key="<api_key>",
+            spark_api_secret="<api_secret>"
+        )
+    """
+
+    client: Any = None  #: :meta private:
+    spark_app_id: Optional[str] = None
+    spark_api_key: Optional[str] = None
+    spark_api_secret: Optional[str] = None
+    spark_api_url: Optional[str] = None
+    spark_llm_domain: Optional[str] = None
+    spark_user_id: str = "lc_user"
+    streaming: bool = False
+    request_timeout: int = 30
+    temperature: float = 0.5
+    top_k: int = 4
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        values["spark_app_id"] = get_from_dict_or_env(
+            values,
+            "spark_app_id",
+            "IFLYTEK_SPARK_APP_ID",
+        )
+        values["spark_api_key"] = get_from_dict_or_env(
+            values,
+            "spark_api_key",
+            "IFLYTEK_SPARK_API_KEY",
+        )
+        values["spark_api_secret"] = get_from_dict_or_env(
+            values,
+            "spark_api_secret",
+            "IFLYTEK_SPARK_API_SECRET",
+        )
+        values["spark_api_url"] = get_from_dict_or_env(
+            values,
+            "spark_api_url",
+            "IFLYTEK_SPARK_API_URL",
+            "wss://spark-api.xf-yun.com/v3.1/chat",
+        )
+        values["spark_llm_domain"] = get_from_dict_or_env(
+            values,
+            "spark_llm_domain",
+            "IFLYTEK_SPARK_LLM_DOMAIN",
+            "generalv3",
+        )
+        # put extra params into model_kwargs
+        values["model_kwargs"]["temperature"] = values["temperature"] or cls.temperature
+        values["model_kwargs"]["top_k"] = values["top_k"] or cls.top_k
+
+        values["client"] = _SparkLLMClient(
+            app_id=values["spark_app_id"],
+            api_key=values["spark_api_key"],
+            api_secret=values["spark_api_secret"],
+            api_url=values["spark_api_url"],
+            spark_domain=values["spark_llm_domain"],
+            model_kwargs=values["model_kwargs"],
+        )
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "spark-llm-chat"
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling SparkLLM API."""
+        normal_params = {
+            "spark_llm_domain": self.spark_llm_domain,
+            "stream": self.streaming,
+            "request_timeout": self.request_timeout,
+            "top_k": self.top_k,
+            "temperature": self.temperature,
+        }
+
+        return {**normal_params, **self.model_kwargs}
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to an sparkllm for each generation with a prompt.
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+        Returns:
+            The string generated by the llm.
+
+        Example:
+            .. code-block:: python
+                response = client("Tell me a joke.")
+        """
+        if self.streaming:
+            completion = ""
+            for chunk in self._stream(prompt, stop, run_manager, **kwargs):
+                completion += chunk.text
+            return completion
+        completion = ""
+        self.client.arun(
+            [{"role": "user", "content": prompt}],
+            self.spark_user_id,
+            self.model_kwargs,
+            self.streaming,
+        )
+        for content in self.client.subscribe(timeout=self.request_timeout):
+            if "data" not in content:
+                continue
+            completion = content["data"]["content"]
+
+        return completion
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        self.client.run(
+            [{"role": "user", "content": prompt}],
+            self.spark_user_id,
+            self.model_kwargs,
+            self.streaming,
+        )
+        for content in self.client.subscribe(timeout=self.request_timeout):
+            if "data" not in content:
+                continue
+            delta = content["data"]
+            if run_manager:
+                run_manager.on_llm_new_token(delta)
+            yield GenerationChunk(text=delta["content"])
+
+
+class _SparkLLMClient:
+    """
+    Use websocket-client to call the SparkLLM interface provided by Xfyun,
+    which is the iFlyTek's open platform for AI capabilities
+    """
+
+    def __init__(
+        self,
+        app_id: str,
+        api_key: str,
+        api_secret: str,
+        api_url: Optional[str] = None,
+        spark_domain: Optional[str] = None,
+        model_kwargs: Optional[dict] = None,
+    ):
+        try:
+            import websocket
+
+            self.websocket_client = websocket
+        except ImportError:
+            raise ImportError(
+                "Could not import websocket client python package. "
+                "Please install it with `pip install websocket-client`."
+            )
+
+        self.api_url = (
+            "wss://spark-api.xf-yun.com/v3.1/chat" if not api_url else api_url
+        )
+        self.app_id = app_id
+        self.model_kwargs = model_kwargs
+        self.spark_domain = spark_domain or "generalv3"
+        self.queue: Queue[Dict] = Queue()
+        self.blocking_message = {"content": "", "role": "assistant"}
+        self.api_key = api_key
+        self.api_secret = api_secret
+
+    @staticmethod
+    def _create_url(api_url: str, api_key: str, api_secret: str) -> str:
+        """
+        Generate a request url with an api key and an api secret.
+        """
+        # generate timestamp by RFC1123
+        date = format_date_time(mktime(datetime.now().timetuple()))
+
+        # urlparse
+        parsed_url = urlparse(api_url)
+        host = parsed_url.netloc
+        path = parsed_url.path
+
+        signature_origin = f"host: {host}\ndate: {date}\nGET {path} HTTP/1.1"
+
+        # encrypt using hmac-sha256
+        signature_sha = hmac.new(
+            api_secret.encode("utf-8"),
+            signature_origin.encode("utf-8"),
+            digestmod=hashlib.sha256,
+        ).digest()
+
+        signature_sha_base64 = base64.b64encode(signature_sha).decode(encoding="utf-8")
+
+        authorization_origin = f'api_key="{api_key}", algorithm="hmac-sha256", \
+        headers="host date request-line", signature="{signature_sha_base64}"'
+        authorization = base64.b64encode(authorization_origin.encode("utf-8")).decode(
+            encoding="utf-8"
+        )
+
+        # generate url
+        params_dict = {"authorization": authorization, "date": date, "host": host}
+        encoded_params = urlencode(params_dict)
+        url = urlunparse(
+            (
+                parsed_url.scheme,
+                parsed_url.netloc,
+                parsed_url.path,
+                parsed_url.params,
+                encoded_params,
+                parsed_url.fragment,
+            )
+        )
+        return url
+
+    def run(
+        self,
+        messages: List[Dict],
+        user_id: str,
+        model_kwargs: Optional[dict] = None,
+        streaming: bool = False,
+    ) -> None:
+        self.websocket_client.enableTrace(False)
+        ws = self.websocket_client.WebSocketApp(
+            _SparkLLMClient._create_url(
+                self.api_url,
+                self.api_key,
+                self.api_secret,
+            ),
+            on_message=self.on_message,
+            on_error=self.on_error,
+            on_close=self.on_close,
+            on_open=self.on_open,
+        )
+        ws.messages = messages
+        ws.user_id = user_id
+        ws.model_kwargs = self.model_kwargs if model_kwargs is None else model_kwargs
+        ws.streaming = streaming
+        ws.run_forever()
+
+    def arun(
+        self,
+        messages: List[Dict],
+        user_id: str,
+        model_kwargs: Optional[dict] = None,
+        streaming: bool = False,
+    ) -> threading.Thread:
+        ws_thread = threading.Thread(
+            target=self.run,
+            args=(
+                messages,
+                user_id,
+                model_kwargs,
+                streaming,
+            ),
+        )
+        ws_thread.start()
+        return ws_thread
+
+    def on_error(self, ws: Any, error: Optional[Any]) -> None:
+        self.queue.put({"error": error})
+        ws.close()
+
+    def on_close(self, ws: Any, close_status_code: int, close_reason: str) -> None:
+        logger.debug(
+            {
+                "log": {
+                    "close_status_code": close_status_code,
+                    "close_reason": close_reason,
+                }
+            }
+        )
+        self.queue.put({"done": True})
+
+    def on_open(self, ws: Any) -> None:
+        self.blocking_message = {"content": "", "role": "assistant"}
+        data = json.dumps(
+            self.gen_params(
+                messages=ws.messages, user_id=ws.user_id, model_kwargs=ws.model_kwargs
+            )
+        )
+        ws.send(data)
+
+    def on_message(self, ws: Any, message: str) -> None:
+        data = json.loads(message)
+        code = data["header"]["code"]
+        if code != 0:
+            self.queue.put(
+                {"error": f"Code: {code}, Error: {data['header']['message']}"}
+            )
+            ws.close()
+        else:
+            choices = data["payload"]["choices"]
+            status = choices["status"]
+            content = choices["text"][0]["content"]
+            if ws.streaming:
+                self.queue.put({"data": choices["text"][0]})
+            else:
+                self.blocking_message["content"] += content
+            if status == 2:
+                if not ws.streaming:
+                    self.queue.put({"data": self.blocking_message})
+                usage_data = (
+                    data.get("payload", {}).get("usage", {}).get("text", {})
+                    if data
+                    else {}
+                )
+                self.queue.put({"usage": usage_data})
+                ws.close()
+
+    def gen_params(
+        self, messages: list, user_id: str, model_kwargs: Optional[dict] = None
+    ) -> dict:
+        data: Dict = {
+            "header": {"app_id": self.app_id, "uid": user_id},
+            "parameter": {"chat": {"domain": self.spark_domain}},
+            "payload": {"message": {"text": messages}},
+        }
+
+        if model_kwargs:
+            data["parameter"]["chat"].update(model_kwargs)
+        logger.debug(f"Spark Request Parameters: {data}")
+        return data
+
+    def subscribe(self, timeout: Optional[int] = 30) -> Generator[Dict, None, None]:
+        while True:
+            try:
+                content = self.queue.get(timeout=timeout)
+            except queue.Empty as _:
+                raise TimeoutError(
+                    f"SparkLLMClient wait LLM api response timeout {timeout} seconds"
+                )
+            if "error" in content:
+                raise ConnectionError(content["error"])
+            if "usage" in content:
+                yield content
+                continue
+            if "done" in content:
+                break
+            if "data" not in content:
+                break
+            yield content
diff --git a/llm/Lib/site-packages/langchain_community/llms/stochasticai.py b/llm/Lib/site-packages/langchain_community/llms/stochasticai.py
new file mode 100644
index 0000000000000000000000000000000000000000..4cfc6d5ee9482daf43de3f0e3022dc4d1d85bf9b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/stochasticai.py
@@ -0,0 +1,137 @@
+import logging
+import time
+from typing import Any, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class StochasticAI(LLM):
+    """StochasticAI large language models.
+
+    To use, you should have the environment variable ``STOCHASTICAI_API_KEY``
+    set with your API key.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import StochasticAI
+            stochasticai = StochasticAI(api_url="")
+    """
+
+    api_url: str = ""
+    """Model name to use."""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `create` call not
+    explicitly specified."""
+
+    stochasticai_api_key: Optional[SecretStr] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = {field.alias for field in cls.__fields__.values()}
+
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name not in all_required_field_names:
+                if field_name in extra:
+                    raise ValueError(f"Found {field_name} supplied twice.")
+                logger.warning(
+                    f"""{field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        stochasticai_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "stochasticai_api_key", "STOCHASTICAI_API_KEY")
+        )
+        values["stochasticai_api_key"] = stochasticai_api_key
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"endpoint_url": self.api_url},
+            **{"model_kwargs": self.model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "stochasticai"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to StochasticAI's complete endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = StochasticAI("Tell me a joke.")
+        """
+        params = self.model_kwargs or {}
+        params = {**params, **kwargs}
+        response_post = requests.post(
+            url=self.api_url,
+            json={"prompt": prompt, "params": params},
+            headers={
+                "apiKey": f"{self.stochasticai_api_key.get_secret_value()}",  # type: ignore[union-attr]
+                "Accept": "application/json",
+                "Content-Type": "application/json",
+            },
+        )
+        response_post.raise_for_status()
+        response_post_json = response_post.json()
+        completed = False
+        while not completed:
+            response_get = requests.get(
+                url=response_post_json["data"]["responseUrl"],
+                headers={
+                    "apiKey": f"{self.stochasticai_api_key.get_secret_value()}",  # type: ignore[union-attr]
+                    "Accept": "application/json",
+                    "Content-Type": "application/json",
+                },
+            )
+            response_get.raise_for_status()
+            response_get_json = response_get.json()["data"]
+            text = response_get_json.get("completion")
+            completed = text is not None
+            time.sleep(0.5)
+        text = text[0]
+        if stop is not None:
+            # I believe this is required since the stop tokens
+            # are not enforced by the model parameters
+            text = enforce_stop_tokens(text, stop)
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/symblai_nebula.py b/llm/Lib/site-packages/langchain_community/llms/symblai_nebula.py
new file mode 100644
index 0000000000000000000000000000000000000000..afe6598f238897f6f64450b17c48484fcb671179
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/symblai_nebula.py
@@ -0,0 +1,232 @@
+import json
+import logging
+from typing import Any, Callable, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+from requests import ConnectTimeout, ReadTimeout, RequestException
+from tenacity import (
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+DEFAULT_NEBULA_SERVICE_URL = "https://api-nebula.symbl.ai"
+DEFAULT_NEBULA_SERVICE_PATH = "/v1/model/generate"
+
+logger = logging.getLogger(__name__)
+
+
+class Nebula(LLM):
+    """Nebula Service models.
+
+    To use, you should have the environment variable ``NEBULA_SERVICE_URL``,
+    ``NEBULA_SERVICE_PATH`` and ``NEBULA_API_KEY`` set with your Nebula
+    Service, or pass it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Nebula
+
+            nebula = Nebula(
+                nebula_service_url="NEBULA_SERVICE_URL",
+                nebula_service_path="NEBULA_SERVICE_PATH",
+                nebula_api_key="NEBULA_API_KEY",
+            )
+    """  # noqa: E501
+
+    """Key/value arguments to pass to the model. Reserved for future use"""
+    model_kwargs: Optional[dict] = None
+
+    """Optional"""
+
+    nebula_service_url: Optional[str] = None
+    nebula_service_path: Optional[str] = None
+    nebula_api_key: Optional[SecretStr] = None
+    model: Optional[str] = None
+    max_new_tokens: Optional[int] = 128
+    temperature: Optional[float] = 0.6
+    top_p: Optional[float] = 0.95
+    repetition_penalty: Optional[float] = 1.0
+    top_k: Optional[int] = 1
+    stop_sequences: Optional[List[str]] = None
+    max_retries: Optional[int] = 10
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        nebula_service_url = get_from_dict_or_env(
+            values,
+            "nebula_service_url",
+            "NEBULA_SERVICE_URL",
+            DEFAULT_NEBULA_SERVICE_URL,
+        )
+        nebula_service_path = get_from_dict_or_env(
+            values,
+            "nebula_service_path",
+            "NEBULA_SERVICE_PATH",
+            DEFAULT_NEBULA_SERVICE_PATH,
+        )
+        nebula_api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "nebula_api_key", "NEBULA_API_KEY", None)
+        )
+
+        if nebula_service_url.endswith("/"):
+            nebula_service_url = nebula_service_url[:-1]
+        if not nebula_service_path.startswith("/"):
+            nebula_service_path = "/" + nebula_service_path
+
+        values["nebula_service_url"] = nebula_service_url
+        values["nebula_service_path"] = nebula_service_path
+        values["nebula_api_key"] = nebula_api_key
+
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Cohere API."""
+        return {
+            "max_new_tokens": self.max_new_tokens,
+            "temperature": self.temperature,
+            "top_k": self.top_k,
+            "top_p": self.top_p,
+            "repetition_penalty": self.repetition_penalty,
+        }
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        _model_kwargs = self.model_kwargs or {}
+        return {
+            "nebula_service_url": self.nebula_service_url,
+            "nebula_service_path": self.nebula_service_path,
+            **{"model_kwargs": _model_kwargs},
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "nebula"
+
+    def _invocation_params(
+        self, stop_sequences: Optional[List[str]], **kwargs: Any
+    ) -> dict:
+        params = self._default_params
+        if self.stop_sequences is not None and stop_sequences is not None:
+            raise ValueError("`stop` found in both the input and default params.")
+        elif self.stop_sequences is not None:
+            params["stop_sequences"] = self.stop_sequences
+        else:
+            params["stop_sequences"] = stop_sequences
+        return {**params, **kwargs}
+
+    @staticmethod
+    def _process_response(response: Any, stop: Optional[List[str]]) -> str:
+        text = response["output"]["text"]
+        if stop:
+            text = enforce_stop_tokens(text, stop)
+        return text
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Nebula Service endpoint.
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+        Returns:
+            The string generated by the model.
+        Example:
+            .. code-block:: python
+                response = nebula("Tell me a joke.")
+        """
+        params = self._invocation_params(stop, **kwargs)
+        prompt = prompt.strip()
+
+        response = completion_with_retry(
+            self,
+            prompt=prompt,
+            params=params,
+            url=f"{self.nebula_service_url}{self.nebula_service_path}",
+        )
+        _stop = params.get("stop_sequences")
+        return self._process_response(response, _stop)
+
+
+def make_request(
+    self: Nebula,
+    prompt: str,
+    url: str = f"{DEFAULT_NEBULA_SERVICE_URL}{DEFAULT_NEBULA_SERVICE_PATH}",
+    params: Optional[Dict] = None,
+) -> Any:
+    """Generate text from the model."""
+    params = params or {}
+    api_key = None
+    if self.nebula_api_key is not None:
+        api_key = self.nebula_api_key.get_secret_value()
+    headers = {
+        "Content-Type": "application/json",
+        "ApiKey": f"{api_key}",
+    }
+
+    body = {"prompt": prompt}
+
+    # add params to body
+    for key, value in params.items():
+        body[key] = value
+
+    # make request
+    response = requests.post(url, headers=headers, json=body)
+
+    if response.status_code != 200:
+        raise Exception(
+            f"Request failed with status code {response.status_code}"
+            f" and message {response.text}"
+        )
+
+    return json.loads(response.text)
+
+
+def _create_retry_decorator(llm: Nebula) -> Callable[[Any], Any]:
+    min_seconds = 4
+    max_seconds = 10
+    # Wait 2^x * 1 second between each retry starting with
+    # 4 seconds, then up to 10 seconds, then 10 seconds afterward
+    max_retries = llm.max_retries if llm.max_retries is not None else 3
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(max_retries),
+        wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+        retry=(
+            retry_if_exception_type((RequestException, ConnectTimeout, ReadTimeout))
+        ),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def completion_with_retry(llm: Nebula, **kwargs: Any) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = _create_retry_decorator(llm)
+
+    @retry_decorator
+    def _completion_with_retry(**_kwargs: Any) -> Any:
+        return make_request(llm, **_kwargs)
+
+    return _completion_with_retry(**kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/llms/textgen.py b/llm/Lib/site-packages/langchain_community/llms/textgen.py
new file mode 100644
index 0000000000000000000000000000000000000000..9d1ce108338e39bb85f73c4f5ab479123d451206
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/textgen.py
@@ -0,0 +1,417 @@
+import json
+import logging
+from typing import Any, AsyncIterator, Dict, Iterator, List, Optional
+
+import requests
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import Field
+
+logger = logging.getLogger(__name__)
+
+
+class TextGen(LLM):
+    """Text generation models from WebUI.
+
+    To use, you should have the text-generation-webui installed, a model loaded,
+    and --api added as a command-line option.
+
+    Suggested installation, use one-click installer for your OS:
+    https://github.com/oobabooga/text-generation-webui#one-click-installers
+
+    Parameters below taken from text-generation-webui api example:
+    https://github.com/oobabooga/text-generation-webui/blob/main/api-examples/api-example.py
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import TextGen
+            llm = TextGen(model_url="http://localhost:8500")
+    """
+
+    model_url: str
+    """The full URL to the textgen webui including http[s]://host:port """
+
+    preset: Optional[str] = None
+    """The preset to use in the textgen webui """
+
+    max_new_tokens: Optional[int] = 250
+    """The maximum number of tokens to generate."""
+
+    do_sample: bool = Field(True, alias="do_sample")
+    """Do sample"""
+
+    temperature: Optional[float] = 1.3
+    """Primary factor to control randomness of outputs. 0 = deterministic
+    (only the most likely token is used). Higher value = more randomness."""
+
+    top_p: Optional[float] = 0.1
+    """If not set to 1, select tokens with probabilities adding up to less than this
+    number. Higher value = higher range of possible random results."""
+
+    typical_p: Optional[float] = 1
+    """If not set to 1, select only tokens that are at least this much more likely to
+    appear than random tokens, given the prior text."""
+
+    epsilon_cutoff: Optional[float] = 0  # In units of 1e-4
+    """Epsilon cutoff"""
+
+    eta_cutoff: Optional[float] = 0  # In units of 1e-4
+    """ETA cutoff"""
+
+    repetition_penalty: Optional[float] = 1.18
+    """Exponential penalty factor for repeating prior tokens. 1 means no penalty,
+    higher value = less repetition, lower value = more repetition."""
+
+    top_k: Optional[float] = 40
+    """Similar to top_p, but select instead only the top_k most likely tokens.
+    Higher value = higher range of possible random results."""
+
+    min_length: Optional[int] = 0
+    """Minimum generation length in tokens."""
+
+    no_repeat_ngram_size: Optional[int] = 0
+    """If not set to 0, specifies the length of token sets that are completely blocked
+    from repeating at all. Higher values = blocks larger phrases,
+    lower values = blocks words or letters from repeating.
+    Only 0 or high values are a good idea in most cases."""
+
+    num_beams: Optional[int] = 1
+    """Number of beams"""
+
+    penalty_alpha: Optional[float] = 0
+    """Penalty Alpha"""
+
+    length_penalty: Optional[float] = 1
+    """Length Penalty"""
+
+    early_stopping: bool = Field(False, alias="early_stopping")
+    """Early stopping"""
+
+    seed: int = Field(-1, alias="seed")
+    """Seed (-1 for random)"""
+
+    add_bos_token: bool = Field(True, alias="add_bos_token")
+    """Add the bos_token to the beginning of prompts.
+    Disabling this can make the replies more creative."""
+
+    truncation_length: Optional[int] = 2048
+    """Truncate the prompt up to this length. The leftmost tokens are removed if
+    the prompt exceeds this length. Most models require this to be at most 2048."""
+
+    ban_eos_token: bool = Field(False, alias="ban_eos_token")
+    """Ban the eos_token. Forces the model to never end the generation prematurely."""
+
+    skip_special_tokens: bool = Field(True, alias="skip_special_tokens")
+    """Skip special tokens. Some specific models need this unset."""
+
+    stopping_strings: Optional[List[str]] = []
+    """A list of strings to stop generation when encountered."""
+
+    streaming: bool = False
+    """Whether to stream the results, token by token."""
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling textgen."""
+        return {
+            "max_new_tokens": self.max_new_tokens,
+            "do_sample": self.do_sample,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            "typical_p": self.typical_p,
+            "epsilon_cutoff": self.epsilon_cutoff,
+            "eta_cutoff": self.eta_cutoff,
+            "repetition_penalty": self.repetition_penalty,
+            "top_k": self.top_k,
+            "min_length": self.min_length,
+            "no_repeat_ngram_size": self.no_repeat_ngram_size,
+            "num_beams": self.num_beams,
+            "penalty_alpha": self.penalty_alpha,
+            "length_penalty": self.length_penalty,
+            "early_stopping": self.early_stopping,
+            "seed": self.seed,
+            "add_bos_token": self.add_bos_token,
+            "truncation_length": self.truncation_length,
+            "ban_eos_token": self.ban_eos_token,
+            "skip_special_tokens": self.skip_special_tokens,
+            "stopping_strings": self.stopping_strings,
+        }
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {**{"model_url": self.model_url}, **self._default_params}
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "textgen"
+
+    def _get_parameters(self, stop: Optional[List[str]] = None) -> Dict[str, Any]:
+        """
+        Performs sanity check, preparing parameters in format needed by textgen.
+
+        Args:
+            stop (Optional[List[str]]): List of stop sequences for textgen.
+
+        Returns:
+            Dictionary containing the combined parameters.
+        """
+
+        # Raise error if stop sequences are in both input and default params
+        # if self.stop and stop is not None:
+        if self.stopping_strings and stop is not None:
+            raise ValueError("`stop` found in both the input and default params.")
+
+        if self.preset is None:
+            params = self._default_params
+        else:
+            params = {"preset": self.preset}
+
+        # then sets it as configured, or default to an empty list:
+        params["stopping_strings"] = self.stopping_strings or stop or []
+
+        return params
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call the textgen web API and return the output.
+
+        Args:
+            prompt: The prompt to use for generation.
+            stop: A list of strings to stop generation when encountered.
+
+        Returns:
+            The generated text.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.llms import TextGen
+                llm = TextGen(model_url="http://localhost:5000")
+                llm("Write a story about llamas.")
+        """
+        if self.streaming:
+            combined_text_output = ""
+            for chunk in self._stream(
+                prompt=prompt, stop=stop, run_manager=run_manager, **kwargs
+            ):
+                combined_text_output += chunk.text
+            result = combined_text_output
+
+        else:
+            url = f"{self.model_url}/api/v1/generate"
+            params = self._get_parameters(stop)
+            request = params.copy()
+            request["prompt"] = prompt
+            response = requests.post(url, json=request)
+
+            if response.status_code == 200:
+                result = response.json()["results"][0]["text"]
+            else:
+                print(f"ERROR: response: {response}")  # noqa: T201
+                result = ""
+
+        return result
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call the textgen web API and return the output.
+
+        Args:
+            prompt: The prompt to use for generation.
+            stop: A list of strings to stop generation when encountered.
+
+        Returns:
+            The generated text.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.llms import TextGen
+                llm = TextGen(model_url="http://localhost:5000")
+                llm("Write a story about llamas.")
+        """
+        if self.streaming:
+            combined_text_output = ""
+            async for chunk in self._astream(
+                prompt=prompt, stop=stop, run_manager=run_manager, **kwargs
+            ):
+                combined_text_output += chunk.text
+            result = combined_text_output
+
+        else:
+            url = f"{self.model_url}/api/v1/generate"
+            params = self._get_parameters(stop)
+            request = params.copy()
+            request["prompt"] = prompt
+            response = requests.post(url, json=request)
+
+            if response.status_code == 200:
+                result = response.json()["results"][0]["text"]
+            else:
+                print(f"ERROR: response: {response}")  # noqa: T201
+                result = ""
+
+        return result
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        """Yields results objects as they are generated in real time.
+
+        It also calls the callback manager's on_llm_new_token event with
+        similar parameters to the OpenAI LLM class method of the same name.
+
+        Args:
+            prompt: The prompts to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            A generator representing the stream of tokens being generated.
+
+        Yields:
+            A dictionary like objects containing a string token and metadata.
+            See text-generation-webui docs and below for more.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.llms import TextGen
+                llm = TextGen(
+                    model_url = "ws://localhost:5005"
+                    streaming=True
+                )
+                for chunk in llm.stream("Ask 'Hi, how are you?' like a pirate:'",
+                        stop=["'","\n"]):
+                    print(chunk, end='', flush=True)  # noqa: T201
+
+        """
+        try:
+            import websocket
+        except ImportError:
+            raise ImportError(
+                "The `websocket-client` package is required for streaming."
+            )
+
+        params = {**self._get_parameters(stop), **kwargs}
+
+        url = f"{self.model_url}/api/v1/stream"
+
+        request = params.copy()
+        request["prompt"] = prompt
+
+        websocket_client = websocket.WebSocket()
+
+        websocket_client.connect(url)
+
+        websocket_client.send(json.dumps(request))
+
+        while True:
+            result = websocket_client.recv()
+            result = json.loads(result)
+
+            if result["event"] == "text_stream":
+                chunk = GenerationChunk(
+                    text=result["text"],
+                    generation_info=None,
+                )
+                yield chunk
+            elif result["event"] == "stream_end":
+                websocket_client.close()
+                return
+
+            if run_manager:
+                run_manager.on_llm_new_token(token=chunk.text)
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        """Yields results objects as they are generated in real time.
+
+        It also calls the callback manager's on_llm_new_token event with
+        similar parameters to the OpenAI LLM class method of the same name.
+
+        Args:
+            prompt: The prompts to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            A generator representing the stream of tokens being generated.
+
+        Yields:
+            A dictionary like objects containing a string token and metadata.
+            See text-generation-webui docs and below for more.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.llms import TextGen
+                llm = TextGen(
+                    model_url = "ws://localhost:5005"
+                    streaming=True
+                )
+                for chunk in llm.stream("Ask 'Hi, how are you?' like a pirate:'",
+                        stop=["'","\n"]):
+                    print(chunk, end='', flush=True)  # noqa: T201
+
+        """
+        try:
+            import websocket
+        except ImportError:
+            raise ImportError(
+                "The `websocket-client` package is required for streaming."
+            )
+
+        params = {**self._get_parameters(stop), **kwargs}
+
+        url = f"{self.model_url}/api/v1/stream"
+
+        request = params.copy()
+        request["prompt"] = prompt
+
+        websocket_client = websocket.WebSocket()
+
+        websocket_client.connect(url)
+
+        websocket_client.send(json.dumps(request))
+
+        while True:
+            result = websocket_client.recv()
+            result = json.loads(result)
+
+            if result["event"] == "text_stream":
+                chunk = GenerationChunk(
+                    text=result["text"],
+                    generation_info=None,
+                )
+                yield chunk
+            elif result["event"] == "stream_end":
+                websocket_client.close()
+                return
+
+            if run_manager:
+                await run_manager.on_llm_new_token(token=chunk.text)
diff --git a/llm/Lib/site-packages/langchain_community/llms/titan_takeoff.py b/llm/Lib/site-packages/langchain_community/llms/titan_takeoff.py
new file mode 100644
index 0000000000000000000000000000000000000000..e5b38e77dd1777f5ff1e03ac724b52b68219b2dd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/titan_takeoff.py
@@ -0,0 +1,261 @@
+from enum import Enum
+from typing import Any, Iterator, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import BaseModel
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+
+class Device(str, Enum):
+    """The device to use for inference, cuda or cpu"""
+
+    cuda = "cuda"
+    cpu = "cpu"
+
+
+class ReaderConfig(BaseModel):
+    class Config:
+        protected_namespaces = ()
+
+    model_name: str
+    """The name of the model to use"""
+
+    device: Device = Device.cuda
+    """The device to use for inference, cuda or cpu"""
+
+    consumer_group: str = "primary"
+    """The consumer group to place the reader into"""
+
+    tensor_parallel: Optional[int] = None
+    """The number of gpus you would like your model to be split across"""
+
+    max_seq_length: int = 512
+    """The maximum sequence length to use for inference, defaults to 512"""
+
+    max_batch_size: int = 4
+    """The max batch size for continuous batching of requests"""
+
+
+class TitanTakeoff(LLM):
+    """Titan Takeoff API LLMs.
+
+    Titan Takeoff is a wrapper to interface with Takeoff Inference API for
+    generative text to text language models.
+
+    You can use this wrapper to send requests to a generative language model
+    and to deploy readers with Takeoff.
+
+    Examples:
+        This is an example how to deploy a generative language model and send
+        requests.
+
+        .. code-block:: python
+            # Import the TitanTakeoff class from community package
+            import time
+            from langchain_community.llms import TitanTakeoff
+
+            # Specify the embedding reader you'd like to deploy
+            reader_1 = {
+                "model_name": "TheBloke/Llama-2-7b-Chat-AWQ",
+                "device": "cuda",
+                "tensor_parallel": 1,
+                "consumer_group": "llama"
+            }
+
+            # For every reader you pass into models arg Takeoff will spin
+            # up a reader according to the specs you provide. If you don't
+            # specify the arg no models are spun up and it assumes you have
+            # already done this separately.
+            llm = TitanTakeoff(models=[reader_1])
+
+            # Wait for the reader to be deployed, time needed depends on the
+            # model size and your internet speed
+            time.sleep(60)
+
+            # Returns the query, ie a List[float], sent to `llama` consumer group
+            # where we just spun up the Llama 7B model
+            print(embed.invoke(
+                "Where can I see football?", consumer_group="llama"
+            ))
+
+            # You can also send generation parameters to the model, any of the
+            # following can be passed in as kwargs:
+            # https://docs.titanml.co/docs/next/apis/Takeoff%20inference_REST_API/generate#request
+            # for instance:
+            print(embed.invoke(
+                "Where can I see football?", consumer_group="llama", max_new_tokens=100
+            ))
+    """
+
+    base_url: str = "http://localhost"
+    """The base URL of the Titan Takeoff (Pro) server. Default = "http://localhost"."""
+
+    port: int = 3000
+    """The port of the Titan Takeoff (Pro) server. Default = 3000."""
+
+    mgmt_port: int = 3001
+    """The management port of the Titan Takeoff (Pro) server. Default = 3001."""
+
+    streaming: bool = False
+    """Whether to stream the output. Default = False."""
+
+    client: Any = None
+    """Takeoff Client Python SDK used to interact with Takeoff API"""
+
+    def __init__(
+        self,
+        base_url: str = "http://localhost",
+        port: int = 3000,
+        mgmt_port: int = 3001,
+        streaming: bool = False,
+        models: List[ReaderConfig] = [],
+    ):
+        """Initialize the Titan Takeoff language wrapper.
+
+        Args:
+            base_url (str, optional): The base URL where the Takeoff
+                Inference Server is listening. Defaults to `http://localhost`.
+            port (int, optional): What port is Takeoff Inference API
+                listening on. Defaults to 3000.
+            mgmt_port (int, optional): What port is Takeoff Management API
+                listening on. Defaults to 3001.
+            streaming (bool, optional): Whether you want to by default use the
+                generate_stream endpoint over generate to stream responses.
+                Defaults to False. In reality, this is not significantly different
+                as the streamed response is buffered and returned similar to the
+                non-streamed response, but the run manager is applied per token
+                generated.
+            models (List[ReaderConfig], optional): Any readers you'd like to
+                spin up on. Defaults to [].
+
+        Raises:
+            ImportError: If you haven't installed takeoff-client, you will
+            get an ImportError. To remedy run `pip install 'takeoff-client==0.4.0'`
+        """
+        super().__init__(
+            base_url=base_url, port=port, mgmt_port=mgmt_port, streaming=streaming
+        )
+        try:
+            from takeoff_client import TakeoffClient
+        except ImportError:
+            raise ImportError(
+                "takeoff-client is required for TitanTakeoff. "
+                "Please install it with `pip install 'takeoff-client>=0.4.0'`."
+            )
+        self.client = TakeoffClient(
+            self.base_url, port=self.port, mgmt_port=self.mgmt_port
+        )
+        for model in models:
+            self.client.create_reader(model)
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "titan_takeoff"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Titan Takeoff (Pro) generate endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+            run_manager: Optional callback manager to use when streaming.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                model = TitanTakeoff()
+
+                prompt = "What is the capital of the United Kingdom?"
+
+                # Use of model(prompt), ie `__call__` was deprecated in LangChain 0.1.7,
+                # use model.invoke(prompt) instead.
+                response = model.invoke(prompt)
+
+        """
+        if self.streaming:
+            text_output = ""
+            for chunk in self._stream(
+                prompt=prompt,
+                stop=stop,
+                run_manager=run_manager,
+            ):
+                text_output += chunk.text
+            return text_output
+
+        response = self.client.generate(prompt, **kwargs)
+        text = response["text"]
+
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+        return text
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        """Call out to Titan Takeoff (Pro) stream endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+            run_manager: Optional callback manager to use when streaming.
+
+        Yields:
+            A dictionary like object containing a string token.
+
+        Example:
+            .. code-block:: python
+
+                model = TitanTakeoff()
+
+                prompt = "What is the capital of the United Kingdom?"
+                response = model.stream(prompt)
+
+                # OR
+
+                model = TitanTakeoff(streaming=True)
+
+                response = model.invoke(prompt)
+
+        """
+        response = self.client.generate_stream(prompt, **kwargs)
+        buffer = ""
+        for text in response:
+            buffer += text.data
+            if "data:" in buffer:
+                # Remove the first instance of "data:" from the buffer.
+                if buffer.startswith("data:"):
+                    buffer = ""
+                if len(buffer.split("data:", 1)) == 2:
+                    content, _ = buffer.split("data:", 1)
+                    buffer = content.rstrip("\n")
+                # Trim the buffer to only have content after the "data:" part.
+                if buffer:  # Ensure that there's content to process.
+                    chunk = GenerationChunk(text=buffer)
+                    buffer = ""  # Reset buffer for the next set of data.
+                    yield chunk
+                    if run_manager:
+                        run_manager.on_llm_new_token(token=chunk.text)
+
+        # Yield any remaining content in the buffer.
+        if buffer:
+            chunk = GenerationChunk(text=buffer.replace("</s>", ""))
+            yield chunk
+            if run_manager:
+                run_manager.on_llm_new_token(token=chunk.text)
diff --git a/llm/Lib/site-packages/langchain_community/llms/together.py b/llm/Lib/site-packages/langchain_community/llms/together.py
new file mode 100644
index 0000000000000000000000000000000000000000..1454bb4b6d66f5360148ea33e7296f7b075df987
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/together.py
@@ -0,0 +1,210 @@
+"""Wrapper around Together AI's Completion API."""
+import logging
+from typing import Any, Dict, List, Optional
+
+from aiohttp import ClientSession
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.utilities.requests import Requests
+
+logger = logging.getLogger(__name__)
+
+
+@deprecated(
+    since="0.0.12", removal="0.2", alternative_import="langchain_together.Together"
+)
+class Together(LLM):
+    """LLM models from `Together`.
+
+    To use, you'll need an API key which you can find here:
+    https://api.together.xyz/settings/api-keys. This can be passed in as init param
+    ``together_api_key`` or set as environment variable ``TOGETHER_API_KEY``.
+
+    Together AI API reference: https://docs.together.ai/reference/inference
+    """
+
+    base_url: str = "https://api.together.xyz/inference"
+    """Base inference API URL."""
+    together_api_key: SecretStr
+    """Together AI API key. Get it here: https://api.together.xyz/settings/api-keys"""
+    model: str
+    """Model name. Available models listed here: 
+        https://docs.together.ai/docs/inference-models
+    """
+    temperature: Optional[float] = None
+    """Model temperature."""
+    top_p: Optional[float] = None
+    """Used to dynamically adjust the number of choices for each predicted token based 
+        on the cumulative probabilities. A value of 1 will always yield the same 
+        output. A temperature less than 1 favors more correctness and is appropriate 
+        for question answering or summarization. A value greater than 1 introduces more 
+        randomness in the output.
+    """
+    top_k: Optional[int] = None
+    """Used to limit the number of choices for the next predicted word or token. It 
+        specifies the maximum number of tokens to consider at each step, based on their 
+        probability of occurrence. This technique helps to speed up the generation 
+        process and can improve the quality of the generated text by focusing on the 
+        most likely options.
+    """
+    max_tokens: Optional[int] = None
+    """The maximum number of tokens to generate."""
+    repetition_penalty: Optional[float] = None
+    """A number that controls the diversity of generated text by reducing the 
+        likelihood of repeated sequences. Higher values decrease repetition.
+    """
+    logprobs: Optional[int] = None
+    """An integer that specifies how many top token log probabilities are included in 
+        the response for each token generation step.
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        values["together_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "together_api_key", "TOGETHER_API_KEY")
+        )
+        return values
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of model."""
+        return "together"
+
+    def _format_output(self, output: dict) -> str:
+        return output["output"]["choices"][0]["text"]
+
+    @staticmethod
+    def get_user_agent() -> str:
+        from langchain_community import __version__
+
+        return f"langchain/{__version__}"
+
+    @property
+    def default_params(self) -> Dict[str, Any]:
+        return {
+            "model": self.model,
+            "temperature": self.temperature,
+            "top_p": self.top_p,
+            "top_k": self.top_k,
+            "max_tokens": self.max_tokens,
+            "repetition_penalty": self.repetition_penalty,
+        }
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Together's text generation endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+
+        Returns:
+            The string generated by the model..
+        """
+
+        headers = {
+            "Authorization": f"Bearer {self.together_api_key.get_secret_value()}",
+            "Content-Type": "application/json",
+        }
+        stop_to_use = stop[0] if stop and len(stop) == 1 else stop
+        payload: Dict[str, Any] = {
+            **self.default_params,
+            "prompt": prompt,
+            "stop": stop_to_use,
+            **kwargs,
+        }
+
+        # filter None values to not pass them to the http payload
+        payload = {k: v for k, v in payload.items() if v is not None}
+        request = Requests(headers=headers)
+        response = request.post(url=self.base_url, data=payload)
+
+        if response.status_code >= 500:
+            raise Exception(f"Together Server: Error {response.status_code}")
+        elif response.status_code >= 400:
+            raise ValueError(f"Together received an invalid payload: {response.text}")
+        elif response.status_code != 200:
+            raise Exception(
+                f"Together returned an unexpected response with status "
+                f"{response.status_code}: {response.text}"
+            )
+
+        data = response.json()
+        if data.get("status") != "finished":
+            err_msg = data.get("error", "Undefined Error")
+            raise Exception(err_msg)
+
+        output = self._format_output(data)
+
+        return output
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call Together model to get predictions based on the prompt.
+
+        Args:
+            prompt: The prompt to pass into the model.
+
+        Returns:
+            The string generated by the model.
+        """
+        headers = {
+            "Authorization": f"Bearer {self.together_api_key.get_secret_value()}",
+            "Content-Type": "application/json",
+        }
+        stop_to_use = stop[0] if stop and len(stop) == 1 else stop
+        payload: Dict[str, Any] = {
+            **self.default_params,
+            "prompt": prompt,
+            "stop": stop_to_use,
+            **kwargs,
+        }
+
+        # filter None values to not pass them to the http payload
+        payload = {k: v for k, v in payload.items() if v is not None}
+        async with ClientSession() as session:
+            async with session.post(
+                self.base_url, json=payload, headers=headers
+            ) as response:
+                if response.status >= 500:
+                    raise Exception(f"Together Server: Error {response.status}")
+                elif response.status >= 400:
+                    raise ValueError(
+                        f"Together received an invalid payload: {response.text}"
+                    )
+                elif response.status != 200:
+                    raise Exception(
+                        f"Together returned an unexpected response with status "
+                        f"{response.status}: {response.text}"
+                    )
+
+                response_json = await response.json()
+
+                if response_json.get("status") != "finished":
+                    err_msg = response_json.get("error", "Undefined Error")
+                    raise Exception(err_msg)
+
+                output = self._format_output(response_json)
+                return output
diff --git a/llm/Lib/site-packages/langchain_community/llms/tongyi.py b/llm/Lib/site-packages/langchain_community/llms/tongyi.py
new file mode 100644
index 0000000000000000000000000000000000000000..6254609ece7f362f543d9159931cae7f2f654b71
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/tongyi.py
@@ -0,0 +1,398 @@
+from __future__ import annotations
+
+import asyncio
+import functools
+import logging
+from typing import (
+    Any,
+    AsyncIterable,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    TypeVar,
+)
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import BaseLLM
+from langchain_core.outputs import Generation, GenerationChunk, LLMResult
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+from requests.exceptions import HTTPError
+from tenacity import (
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+logger = logging.getLogger(__name__)
+T = TypeVar("T")
+
+
+def _create_retry_decorator(llm: Tongyi) -> Callable[[Any], Any]:
+    min_seconds = 1
+    max_seconds = 4
+    # Wait 2^x * 1 second between each retry starting with
+    # 4 seconds, then up to 10 seconds, then 10 seconds afterward
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(llm.max_retries),
+        wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+        retry=(retry_if_exception_type(HTTPError)),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def check_response(resp: Any) -> Any:
+    """Check the response from the completion call."""
+    if resp.status_code == 200:
+        return resp
+    elif resp.status_code in [400, 401]:
+        raise ValueError(
+            f"status_code: {resp.status_code} \n "
+            f"code: {resp.code} \n message: {resp.message}"
+        )
+    else:
+        raise HTTPError(
+            f"HTTP error occurred: status_code: {resp.status_code} \n "
+            f"code: {resp.code} \n message: {resp.message}",
+            response=resp,
+        )
+
+
+def generate_with_retry(llm: Tongyi, **kwargs: Any) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = _create_retry_decorator(llm)
+
+    @retry_decorator
+    def _generate_with_retry(**_kwargs: Any) -> Any:
+        resp = llm.client.call(**_kwargs)
+        return check_response(resp)
+
+    return _generate_with_retry(**kwargs)
+
+
+def stream_generate_with_retry(llm: Tongyi, **kwargs: Any) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = _create_retry_decorator(llm)
+
+    @retry_decorator
+    def _stream_generate_with_retry(**_kwargs: Any) -> Any:
+        responses = llm.client.call(**_kwargs)
+        for resp in responses:
+            yield check_response(resp)
+
+    return _stream_generate_with_retry(**kwargs)
+
+
+async def astream_generate_with_retry(llm: Tongyi, **kwargs: Any) -> Any:
+    """Async version of `stream_generate_with_retry`.
+
+    Because the dashscope SDK doesn't provide an async API,
+    we wrap `stream_generate_with_retry` with an async generator."""
+
+    class _AioTongyiGenerator:
+        def __init__(self, _llm: Tongyi, **_kwargs: Any):
+            self.generator = stream_generate_with_retry(_llm, **_kwargs)
+
+        def __aiter__(self) -> AsyncIterator[Any]:
+            return self
+
+        async def __anext__(self) -> Any:
+            value = await asyncio.get_running_loop().run_in_executor(
+                None, self._safe_next
+            )
+            if value is not None:
+                return value
+            else:
+                raise StopAsyncIteration
+
+        def _safe_next(self) -> Any:
+            try:
+                return next(self.generator)
+            except StopIteration:
+                return None
+
+    async for chunk in _AioTongyiGenerator(llm, **kwargs):
+        yield chunk
+
+
+def generate_with_last_element_mark(iterable: Iterable[T]) -> Iterator[Tuple[T, bool]]:
+    """Generate elements from an iterable,
+    and a boolean indicating if it is the last element."""
+    iterator = iter(iterable)
+    try:
+        item = next(iterator)
+    except StopIteration:
+        return
+    for next_item in iterator:
+        yield item, False
+        item = next_item
+    yield item, True
+
+
+async def agenerate_with_last_element_mark(
+    iterable: AsyncIterable[T],
+) -> AsyncIterator[Tuple[T, bool]]:
+    """Generate elements from an async iterable,
+    and a boolean indicating if it is the last element."""
+    iterator = iterable.__aiter__()
+    try:
+        item = await iterator.__anext__()
+    except StopAsyncIteration:
+        return
+    async for next_item in iterator:
+        yield item, False
+        item = next_item
+    yield item, True
+
+
+class Tongyi(BaseLLM):
+    """Tongyi Qwen large language models.
+
+    To use, you should have the ``dashscope`` python package installed, and the
+    environment variable ``DASHSCOPE_API_KEY`` set with your API key, or pass
+    it as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Tongyi
+            tongyi = tongyi()
+    """
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {"dashscope_api_key": "DASHSCOPE_API_KEY"}
+
+    client: Any  #: :meta private:
+    model_name: str = "qwen-plus"
+
+    """Model name to use."""
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+
+    top_p: float = 0.8
+    """Total probability mass of tokens to consider at each step."""
+
+    dashscope_api_key: Optional[str] = None
+    """Dashscope api key provide by Alibaba Cloud."""
+
+    streaming: bool = False
+    """Whether to stream the results or not."""
+
+    max_retries: int = 10
+    """Maximum number of retries to make when generating."""
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "tongyi"
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["dashscope_api_key"] = get_from_dict_or_env(
+            values, "dashscope_api_key", "DASHSCOPE_API_KEY"
+        )
+        try:
+            import dashscope
+        except ImportError:
+            raise ImportError(
+                "Could not import dashscope python package. "
+                "Please install it with `pip install dashscope`."
+            )
+        try:
+            values["client"] = dashscope.Generation
+        except AttributeError:
+            raise ValueError(
+                "`dashscope` has no `Generation` attribute, this is likely "
+                "due to an old version of the dashscope package. Try upgrading it "
+                "with `pip install --upgrade dashscope`."
+            )
+
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling Tongyi Qwen API."""
+        normal_params = {
+            "model": self.model_name,
+            "top_p": self.top_p,
+            "api_key": self.dashscope_api_key,
+        }
+
+        return {**normal_params, **self.model_kwargs}
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        return {"model_name": self.model_name, **super()._identifying_params}
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        generations = []
+        if self.streaming:
+            if len(prompts) > 1:
+                raise ValueError("Cannot stream results with multiple prompts.")
+            generation: Optional[GenerationChunk] = None
+            for chunk in self._stream(prompts[0], stop, run_manager, **kwargs):
+                if generation is None:
+                    generation = chunk
+                else:
+                    generation += chunk
+            assert generation is not None
+            generations.append([self._chunk_to_generation(generation)])
+        else:
+            params: Dict[str, Any] = self._invocation_params(stop=stop, **kwargs)
+            for prompt in prompts:
+                completion = generate_with_retry(self, prompt=prompt, **params)
+                generations.append(
+                    [Generation(**self._generation_from_qwen_resp(completion))]
+                )
+        return LLMResult(
+            generations=generations,
+            llm_output={
+                "model_name": self.model_name,
+            },
+        )
+
+    async def _agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        generations = []
+        if self.streaming:
+            if len(prompts) > 1:
+                raise ValueError("Cannot stream results with multiple prompts.")
+            generation: Optional[GenerationChunk] = None
+            async for chunk in self._astream(prompts[0], stop, run_manager, **kwargs):
+                if generation is None:
+                    generation = chunk
+                else:
+                    generation += chunk
+            assert generation is not None
+            generations.append([self._chunk_to_generation(generation)])
+        else:
+            params: Dict[str, Any] = self._invocation_params(stop=stop, **kwargs)
+            for prompt in prompts:
+                completion = await asyncio.get_running_loop().run_in_executor(
+                    None,
+                    functools.partial(
+                        generate_with_retry, **{"llm": self, "prompt": prompt, **params}
+                    ),
+                )
+                generations.append(
+                    [Generation(**self._generation_from_qwen_resp(completion))]
+                )
+        return LLMResult(
+            generations=generations,
+            llm_output={
+                "model_name": self.model_name,
+            },
+        )
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        params: Dict[str, Any] = self._invocation_params(
+            stop=stop, stream=True, **kwargs
+        )
+        for stream_resp, is_last_chunk in generate_with_last_element_mark(
+            stream_generate_with_retry(self, prompt=prompt, **params)
+        ):
+            chunk = GenerationChunk(
+                **self._generation_from_qwen_resp(stream_resp, is_last_chunk)
+            )
+            if run_manager:
+                run_manager.on_llm_new_token(
+                    chunk.text,
+                    chunk=chunk,
+                    verbose=self.verbose,
+                )
+            yield chunk
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        params: Dict[str, Any] = self._invocation_params(
+            stop=stop, stream=True, **kwargs
+        )
+        async for stream_resp, is_last_chunk in agenerate_with_last_element_mark(
+            astream_generate_with_retry(self, prompt=prompt, **params)
+        ):
+            chunk = GenerationChunk(
+                **self._generation_from_qwen_resp(stream_resp, is_last_chunk)
+            )
+            if run_manager:
+                await run_manager.on_llm_new_token(
+                    chunk.text,
+                    chunk=chunk,
+                    verbose=self.verbose,
+                )
+            yield chunk
+
+    def _invocation_params(self, stop: Any, **kwargs: Any) -> Dict[str, Any]:
+        params = {
+            **self._default_params,
+            **kwargs,
+        }
+        if stop is not None:
+            params["stop"] = stop
+        if params.get("stream"):
+            params["incremental_output"] = True
+        return params
+
+    @staticmethod
+    def _generation_from_qwen_resp(
+        resp: Any, is_last_chunk: bool = True
+    ) -> Dict[str, Any]:
+        # According to the response from dashscope,
+        # each chunk's `generation_info` overwrites the previous one.
+        # Besides, The `merge_dicts` method,
+        # which is used to concatenate `generation_info` in `GenerationChunk`,
+        # does not support merging of int type values.
+        # Therefore, we adopt the `generation_info` of the last chunk
+        # and discard the `generation_info` of the intermediate chunks.
+        if is_last_chunk:
+            return dict(
+                text=resp["output"]["text"],
+                generation_info=dict(
+                    finish_reason=resp["output"]["finish_reason"],
+                    request_id=resp["request_id"],
+                    token_usage=dict(resp["usage"]),
+                ),
+            )
+        else:
+            return dict(text=resp["output"]["text"])
+
+    @staticmethod
+    def _chunk_to_generation(chunk: GenerationChunk) -> Generation:
+        return Generation(
+            text=chunk.text,
+            generation_info=chunk.generation_info,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/llms/utils.py b/llm/Lib/site-packages/langchain_community/llms/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..b69c759eeaef72d05c77c31674713ae08fff3eb3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/utils.py
@@ -0,0 +1,8 @@
+"""Common utility functions for LLM APIs."""
+import re
+from typing import List
+
+
+def enforce_stop_tokens(text: str, stop: List[str]) -> str:
+    """Cut off the text as soon as any stop words occur."""
+    return re.split("|".join(stop), text, maxsplit=1)[0]
diff --git a/llm/Lib/site-packages/langchain_community/llms/vertexai.py b/llm/Lib/site-packages/langchain_community/llms/vertexai.py
new file mode 100644
index 0000000000000000000000000000000000000000..b8ba8c54f28bc5a87a4d8aaa308a647d3119f149
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/vertexai.py
@@ -0,0 +1,536 @@
+from __future__ import annotations
+
+from concurrent.futures import Executor, ThreadPoolExecutor
+from typing import TYPE_CHECKING, Any, ClassVar, Dict, Iterator, List, Optional, Union
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks.manager import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import BaseLLM
+from langchain_core.outputs import Generation, GenerationChunk, LLMResult
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+
+from langchain_community.utilities.vertexai import (
+    create_retry_decorator,
+    get_client_info,
+    init_vertexai,
+    raise_vertex_import_error,
+)
+
+if TYPE_CHECKING:
+    from google.cloud.aiplatform.gapic import (
+        PredictionServiceAsyncClient,
+        PredictionServiceClient,
+    )
+    from google.cloud.aiplatform.models import Prediction
+    from google.protobuf.struct_pb2 import Value
+    from vertexai.language_models._language_models import (
+        TextGenerationResponse,
+        _LanguageModel,
+    )
+    from vertexai.preview.generative_models import Image
+
+# This is for backwards compatibility
+# We can remove after `langchain` stops importing it
+_response_to_generation = None
+completion_with_retry = None
+stream_completion_with_retry = None
+
+
+def is_codey_model(model_name: str) -> bool:
+    """Return True if the model name is a Codey model."""
+    return "code" in model_name
+
+
+def is_gemini_model(model_name: str) -> bool:
+    """Return True if the model name is a Gemini model."""
+    return model_name is not None and "gemini" in model_name
+
+
+def completion_with_retry(  # type: ignore[no-redef]
+    llm: VertexAI,
+    prompt: List[Union[str, "Image"]],
+    stream: bool = False,
+    is_gemini: bool = False,
+    run_manager: Optional[CallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = create_retry_decorator(llm, run_manager=run_manager)
+
+    @retry_decorator
+    def _completion_with_retry(
+        prompt: List[Union[str, "Image"]], is_gemini: bool = False, **kwargs: Any
+    ) -> Any:
+        if is_gemini:
+            return llm.client.generate_content(
+                prompt, stream=stream, generation_config=kwargs
+            )
+        else:
+            if stream:
+                return llm.client.predict_streaming(prompt[0], **kwargs)
+            return llm.client.predict(prompt[0], **kwargs)
+
+    return _completion_with_retry(prompt, is_gemini, **kwargs)
+
+
+async def acompletion_with_retry(
+    llm: VertexAI,
+    prompt: str,
+    is_gemini: bool = False,
+    run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+    **kwargs: Any,
+) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = create_retry_decorator(llm, run_manager=run_manager)
+
+    @retry_decorator
+    async def _acompletion_with_retry(
+        prompt: str, is_gemini: bool = False, **kwargs: Any
+    ) -> Any:
+        if is_gemini:
+            return await llm.client.generate_content_async(
+                prompt, generation_config=kwargs
+            )
+        return await llm.client.predict_async(prompt, **kwargs)
+
+    return await _acompletion_with_retry(prompt, is_gemini, **kwargs)
+
+
+class _VertexAIBase(BaseModel):
+    project: Optional[str] = None
+    "The default GCP project to use when making Vertex API calls."
+    location: str = "us-central1"
+    "The default location to use when making API calls."
+    request_parallelism: int = 5
+    "The amount of parallelism allowed for requests issued to VertexAI models. "
+    "Default is 5."
+    max_retries: int = 6
+    """The maximum number of retries to make when generating."""
+    task_executor: ClassVar[Optional[Executor]] = Field(default=None, exclude=True)
+    stop: Optional[List[str]] = None
+    "Optional list of stop words to use when generating."
+    model_name: Optional[str] = None
+    "Underlying model name."
+
+    @classmethod
+    def _get_task_executor(cls, request_parallelism: int = 5) -> Executor:
+        if cls.task_executor is None:
+            cls.task_executor = ThreadPoolExecutor(max_workers=request_parallelism)
+        return cls.task_executor
+
+
+class _VertexAICommon(_VertexAIBase):
+    client: "_LanguageModel" = None  #: :meta private:
+    client_preview: "_LanguageModel" = None  #: :meta private:
+    model_name: str
+    "Underlying model name."
+    temperature: float = 0.0
+    "Sampling temperature, it controls the degree of randomness in token selection."
+    max_output_tokens: int = 128
+    "Token limit determines the maximum amount of text output from one prompt."
+    top_p: float = 0.95
+    "Tokens are selected from most probable to least until the sum of their "
+    "probabilities equals the top-p value. Top-p is ignored for Codey models."
+    top_k: int = 40
+    "How the model selects tokens for output, the next token is selected from "
+    "among the top-k most probable tokens. Top-k is ignored for Codey models."
+    credentials: Any = Field(default=None, exclude=True)
+    "The default custom credentials (google.auth.credentials.Credentials) to use "
+    "when making API calls. If not provided, credentials will be ascertained from "
+    "the environment."
+    n: int = 1
+    """How many completions to generate for each prompt."""
+    streaming: bool = False
+    """Whether to stream the results or not."""
+
+    @property
+    def _llm_type(self) -> str:
+        return "vertexai"
+
+    @property
+    def is_codey_model(self) -> bool:
+        return is_codey_model(self.model_name)
+
+    @property
+    def _is_gemini_model(self) -> bool:
+        return is_gemini_model(self.model_name)
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Gets the identifying parameters."""
+        return {**{"model_name": self.model_name}, **self._default_params}
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        params = {
+            "temperature": self.temperature,
+            "max_output_tokens": self.max_output_tokens,
+            "candidate_count": self.n,
+        }
+        if not self.is_codey_model:
+            params.update(
+                {
+                    "top_k": self.top_k,
+                    "top_p": self.top_p,
+                }
+            )
+        return params
+
+    @classmethod
+    def _try_init_vertexai(cls, values: Dict) -> None:
+        allowed_params = ["project", "location", "credentials"]
+        params = {k: v for k, v in values.items() if k in allowed_params}
+        init_vertexai(**params)
+        return None
+
+    def _prepare_params(
+        self,
+        stop: Optional[List[str]] = None,
+        stream: bool = False,
+        **kwargs: Any,
+    ) -> dict:
+        stop_sequences = stop or self.stop
+        params_mapping = {"n": "candidate_count"}
+        params = {params_mapping.get(k, k): v for k, v in kwargs.items()}
+        params = {**self._default_params, "stop_sequences": stop_sequences, **params}
+        if stream or self.streaming:
+            params.pop("candidate_count")
+        return params
+
+
+@deprecated(
+    since="0.0.12",
+    removal="0.2.0",
+    alternative_import="langchain_google_vertexai.VertexAI",
+)
+class VertexAI(_VertexAICommon, BaseLLM):
+    """Google Vertex AI large language models."""
+
+    model_name: str = "text-bison"
+    "The name of the Vertex AI large language model."
+    tuned_model_name: Optional[str] = None
+    "The name of a tuned model. If provided, model_name is ignored."
+
+    @classmethod
+    def is_lc_serializable(self) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "llms", "vertexai"]
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in environment."""
+        tuned_model_name = values.get("tuned_model_name")
+        model_name = values["model_name"]
+        is_gemini = is_gemini_model(values["model_name"])
+        cls._try_init_vertexai(values)
+        try:
+            from vertexai.language_models import (
+                CodeGenerationModel,
+                TextGenerationModel,
+            )
+            from vertexai.preview.language_models import (
+                CodeGenerationModel as PreviewCodeGenerationModel,
+            )
+            from vertexai.preview.language_models import (
+                TextGenerationModel as PreviewTextGenerationModel,
+            )
+
+            if is_gemini:
+                from vertexai.preview.generative_models import (
+                    GenerativeModel,
+                )
+
+            if is_codey_model(model_name):
+                model_cls = CodeGenerationModel
+                preview_model_cls = PreviewCodeGenerationModel
+            elif is_gemini:
+                model_cls = GenerativeModel
+                preview_model_cls = GenerativeModel
+            else:
+                model_cls = TextGenerationModel
+                preview_model_cls = PreviewTextGenerationModel
+
+            if tuned_model_name:
+                values["client"] = model_cls.get_tuned_model(tuned_model_name)
+                values["client_preview"] = preview_model_cls.get_tuned_model(
+                    tuned_model_name
+                )
+            else:
+                if is_gemini:
+                    values["client"] = model_cls(model_name=model_name)
+                    values["client_preview"] = preview_model_cls(model_name=model_name)
+                else:
+                    values["client"] = model_cls.from_pretrained(model_name)
+                    values["client_preview"] = preview_model_cls.from_pretrained(
+                        model_name
+                    )
+
+        except ImportError:
+            raise_vertex_import_error()
+
+        if values["streaming"] and values["n"] > 1:
+            raise ValueError("Only one candidate can be generated with streaming!")
+        return values
+
+    def get_num_tokens(self, text: str) -> int:
+        """Get the number of tokens present in the text.
+
+        Useful for checking if an input will fit in a model's context window.
+
+        Args:
+            text: The string input to tokenize.
+
+        Returns:
+            The integer number of tokens in the text.
+        """
+        try:
+            result = self.client_preview.count_tokens([text])
+        except AttributeError:
+            raise_vertex_import_error()
+
+        return result.total_tokens
+
+    def _response_to_generation(
+        self, response: TextGenerationResponse
+    ) -> GenerationChunk:
+        """Converts a stream response to a generation chunk."""
+        try:
+            generation_info = {
+                "is_blocked": response.is_blocked,
+                "safety_attributes": response.safety_attributes,
+            }
+        except Exception:
+            generation_info = None
+        return GenerationChunk(text=response.text, generation_info=generation_info)
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        should_stream = stream if stream is not None else self.streaming
+        params = self._prepare_params(stop=stop, stream=should_stream, **kwargs)
+        generations: List[List[Generation]] = []
+        for prompt in prompts:
+            if should_stream:
+                generation = GenerationChunk(text="")
+                for chunk in self._stream(
+                    prompt, stop=stop, run_manager=run_manager, **kwargs
+                ):
+                    generation += chunk
+                generations.append([generation])
+            else:
+                res = completion_with_retry(  # type: ignore[misc]
+                    self,
+                    [prompt],
+                    stream=should_stream,
+                    is_gemini=self._is_gemini_model,
+                    run_manager=run_manager,
+                    **params,
+                )
+                generations.append(
+                    [self._response_to_generation(r) for r in res.candidates]
+                )
+        return LLMResult(generations=generations)
+
+    async def _agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        params = self._prepare_params(stop=stop, **kwargs)
+        generations = []
+        for prompt in prompts:
+            res = await acompletion_with_retry(
+                self,
+                prompt,
+                is_gemini=self._is_gemini_model,
+                run_manager=run_manager,
+                **params,
+            )
+            generations.append(
+                [self._response_to_generation(r) for r in res.candidates]
+            )
+        return LLMResult(generations=generations)
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        params = self._prepare_params(stop=stop, stream=True, **kwargs)
+        for stream_resp in completion_with_retry(  # type: ignore[misc]
+            self,
+            [prompt],
+            stream=True,
+            is_gemini=self._is_gemini_model,
+            run_manager=run_manager,
+            **params,
+        ):
+            chunk = self._response_to_generation(stream_resp)
+            if run_manager:
+                run_manager.on_llm_new_token(
+                    chunk.text,
+                    chunk=chunk,
+                    verbose=self.verbose,
+                )
+            yield chunk
+
+
+@deprecated(
+    since="0.0.12",
+    removal="0.2.0",
+    alternative_import="langchain_google_vertexai.VertexAIModelGarden",
+)
+class VertexAIModelGarden(_VertexAIBase, BaseLLM):
+    """Vertex AI Model Garden large language models."""
+
+    client: "PredictionServiceClient" = None  #: :meta private:
+    async_client: "PredictionServiceAsyncClient" = None  #: :meta private:
+    endpoint_id: str
+    "A name of an endpoint where the model has been deployed."
+    allowed_model_args: Optional[List[str]] = None
+    "Allowed optional args to be passed to the model."
+    prompt_arg: str = "prompt"
+    result_arg: Optional[str] = "generated_text"
+    "Set result_arg to None if output of the model is expected to be a string."
+    "Otherwise, if it's a dict, provided an argument that contains the result."
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in environment."""
+        try:
+            from google.api_core.client_options import ClientOptions
+            from google.cloud.aiplatform.gapic import (
+                PredictionServiceAsyncClient,
+                PredictionServiceClient,
+            )
+        except ImportError:
+            raise_vertex_import_error()
+
+        if not values["project"]:
+            raise ValueError(
+                "A GCP project should be provided to run inference on Model Garden!"
+            )
+
+        client_options = ClientOptions(
+            api_endpoint=f"{values['location']}-aiplatform.googleapis.com"
+        )
+        client_info = get_client_info(module="vertex-ai-model-garden")
+        values["client"] = PredictionServiceClient(
+            client_options=client_options, client_info=client_info
+        )
+        values["async_client"] = PredictionServiceAsyncClient(
+            client_options=client_options, client_info=client_info
+        )
+        return values
+
+    @property
+    def endpoint_path(self) -> str:
+        return self.client.endpoint_path(
+            project=self.project,
+            location=self.location,
+            endpoint=self.endpoint_id,
+        )
+
+    @property
+    def _llm_type(self) -> str:
+        return "vertexai_model_garden"
+
+    def _prepare_request(self, prompts: List[str], **kwargs: Any) -> List["Value"]:
+        try:
+            from google.protobuf import json_format
+            from google.protobuf.struct_pb2 import Value
+        except ImportError:
+            raise ImportError(
+                "protobuf package not found, please install it with"
+                " `pip install protobuf`"
+            )
+        instances = []
+        for prompt in prompts:
+            if self.allowed_model_args:
+                instance = {
+                    k: v for k, v in kwargs.items() if k in self.allowed_model_args
+                }
+            else:
+                instance = {}
+            instance[self.prompt_arg] = prompt
+            instances.append(instance)
+
+        predict_instances = [
+            json_format.ParseDict(instance_dict, Value()) for instance_dict in instances
+        ]
+        return predict_instances
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Run the LLM on the given prompt and input."""
+        instances = self._prepare_request(prompts, **kwargs)
+        response = self.client.predict(endpoint=self.endpoint_path, instances=instances)
+        return self._parse_response(response)
+
+    def _parse_response(self, predictions: "Prediction") -> LLMResult:
+        generations: List[List[Generation]] = []
+        for result in predictions.predictions:
+            generations.append(
+                [
+                    Generation(text=self._parse_prediction(prediction))
+                    for prediction in result
+                ]
+            )
+        return LLMResult(generations=generations)
+
+    def _parse_prediction(self, prediction: Any) -> str:
+        if isinstance(prediction, str):
+            return prediction
+
+        if self.result_arg:
+            try:
+                return prediction[self.result_arg]
+            except KeyError:
+                if isinstance(prediction, str):
+                    error_desc = (
+                        "Provided non-None `result_arg` (result_arg="
+                        f"{self.result_arg}). But got prediction of type "
+                        f"{type(prediction)} instead of dict. Most probably, you"
+                        "need to set `result_arg=None` during VertexAIModelGarden "
+                        "initialization."
+                    )
+                    raise ValueError(error_desc)
+                else:
+                    raise ValueError(f"{self.result_arg} key not found in prediction!")
+
+        return prediction
+
+    async def _agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Run the LLM on the given prompt and input."""
+        instances = self._prepare_request(prompts, **kwargs)
+        response = await self.async_client.predict(
+            endpoint=self.endpoint_path, instances=instances
+        )
+        return self._parse_response(response)
diff --git a/llm/Lib/site-packages/langchain_community/llms/vllm.py b/llm/Lib/site-packages/langchain_community/llms/vllm.py
new file mode 100644
index 0000000000000000000000000000000000000000..5710cf487235029f81c08c3ad95a80124e579558
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/vllm.py
@@ -0,0 +1,176 @@
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import BaseLLM
+from langchain_core.outputs import Generation, LLMResult
+from langchain_core.pydantic_v1 import Field, root_validator
+
+from langchain_community.llms.openai import BaseOpenAI
+from langchain_community.utils.openai import is_openai_v1
+
+
+class VLLM(BaseLLM):
+    """VLLM language model."""
+
+    model: str = ""
+    """The name or path of a HuggingFace Transformers model."""
+
+    tensor_parallel_size: Optional[int] = 1
+    """The number of GPUs to use for distributed execution with tensor parallelism."""
+
+    trust_remote_code: Optional[bool] = False
+    """Trust remote code (e.g., from HuggingFace) when downloading the model 
+    and tokenizer."""
+
+    n: int = 1
+    """Number of output sequences to return for the given prompt."""
+
+    best_of: Optional[int] = None
+    """Number of output sequences that are generated from the prompt."""
+
+    presence_penalty: float = 0.0
+    """Float that penalizes new tokens based on whether they appear in the 
+    generated text so far"""
+
+    frequency_penalty: float = 0.0
+    """Float that penalizes new tokens based on their frequency in the 
+    generated text so far"""
+
+    temperature: float = 1.0
+    """Float that controls the randomness of the sampling."""
+
+    top_p: float = 1.0
+    """Float that controls the cumulative probability of the top tokens to consider."""
+
+    top_k: int = -1
+    """Integer that controls the number of top tokens to consider."""
+
+    use_beam_search: bool = False
+    """Whether to use beam search instead of sampling."""
+
+    stop: Optional[List[str]] = None
+    """List of strings that stop the generation when they are generated."""
+
+    ignore_eos: bool = False
+    """Whether to ignore the EOS token and continue generating tokens after 
+    the EOS token is generated."""
+
+    max_new_tokens: int = 512
+    """Maximum number of tokens to generate per output sequence."""
+
+    logprobs: Optional[int] = None
+    """Number of log probabilities to return per output token."""
+
+    dtype: str = "auto"
+    """The data type for the model weights and activations."""
+
+    download_dir: Optional[str] = None
+    """Directory to download and load the weights. (Default to the default 
+    cache dir of huggingface)"""
+
+    vllm_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """Holds any model parameters valid for `vllm.LLM` call not explicitly specified."""
+
+    client: Any  #: :meta private:
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that python package exists in environment."""
+
+        try:
+            from vllm import LLM as VLLModel
+        except ImportError:
+            raise ImportError(
+                "Could not import vllm python package. "
+                "Please install it with `pip install vllm`."
+            )
+
+        values["client"] = VLLModel(
+            model=values["model"],
+            tensor_parallel_size=values["tensor_parallel_size"],
+            trust_remote_code=values["trust_remote_code"],
+            dtype=values["dtype"],
+            download_dir=values["download_dir"],
+            **values["vllm_kwargs"],
+        )
+
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling vllm."""
+        return {
+            "n": self.n,
+            "best_of": self.best_of,
+            "max_tokens": self.max_new_tokens,
+            "top_k": self.top_k,
+            "top_p": self.top_p,
+            "temperature": self.temperature,
+            "presence_penalty": self.presence_penalty,
+            "frequency_penalty": self.frequency_penalty,
+            "stop": self.stop,
+            "ignore_eos": self.ignore_eos,
+            "use_beam_search": self.use_beam_search,
+            "logprobs": self.logprobs,
+        }
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Run the LLM on the given prompt and input."""
+
+        from vllm import SamplingParams
+
+        # build sampling parameters
+        params = {**self._default_params, **kwargs, "stop": stop}
+        sampling_params = SamplingParams(**params)
+        # call the model
+        outputs = self.client.generate(prompts, sampling_params)
+
+        generations = []
+        for output in outputs:
+            text = output.outputs[0].text
+            generations.append([Generation(text=text)])
+
+        return LLMResult(generations=generations)
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "vllm"
+
+
+class VLLMOpenAI(BaseOpenAI):
+    """vLLM OpenAI-compatible API client"""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @property
+    def _invocation_params(self) -> Dict[str, Any]:
+        """Get the parameters used to invoke the model."""
+
+        params: Dict[str, Any] = {
+            "model": self.model_name,
+            **self._default_params,
+            "logit_bias": None,
+        }
+        if not is_openai_v1():
+            params.update(
+                {
+                    "api_key": self.openai_api_key,
+                    "api_base": self.openai_api_base,
+                }
+            )
+
+        return params
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "vllm-openai"
diff --git a/llm/Lib/site-packages/langchain_community/llms/volcengine_maas.py b/llm/Lib/site-packages/langchain_community/llms/volcengine_maas.py
new file mode 100644
index 0000000000000000000000000000000000000000..aa6a37cc2c406f2f30123563c4baee128dff9113
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/volcengine_maas.py
@@ -0,0 +1,180 @@
+from __future__ import annotations
+
+from typing import Any, Dict, Iterator, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.outputs import GenerationChunk
+from langchain_core.pydantic_v1 import BaseModel, Field, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+
+class VolcEngineMaasBase(BaseModel):
+    """Base class for VolcEngineMaas models."""
+
+    client: Any
+
+    volc_engine_maas_ak: Optional[SecretStr] = None
+    """access key for volc engine"""
+    volc_engine_maas_sk: Optional[SecretStr] = None
+    """secret key for volc engine"""
+
+    endpoint: Optional[str] = "maas-api.ml-platform-cn-beijing.volces.com"
+    """Endpoint of the VolcEngineMaas LLM."""
+
+    region: Optional[str] = "Region"
+    """Region of the VolcEngineMaas LLM."""
+
+    model: str = "skylark-lite-public"
+    """Model name. you could check this model details here 
+    https://www.volcengine.com/docs/82379/1133187
+    and you could choose other models by change this field"""
+    model_version: Optional[str] = None
+    """Model version. Only used in moonshot large language model. 
+    you could check details here https://www.volcengine.com/docs/82379/1158281"""
+
+    top_p: Optional[float] = 0.8
+    """Total probability mass of tokens to consider at each step."""
+
+    temperature: Optional[float] = 0.95
+    """A non-negative float that tunes the degree of randomness in generation."""
+
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    """model special arguments, you could check detail on model page"""
+
+    streaming: bool = False
+    """Whether to stream the results."""
+
+    connect_timeout: Optional[int] = 60
+    """Timeout for connect to volc engine maas endpoint. Default is 60 seconds."""
+
+    read_timeout: Optional[int] = 60
+    """Timeout for read response from volc engine maas endpoint. 
+    Default is 60 seconds."""
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        volc_engine_maas_ak = convert_to_secret_str(
+            get_from_dict_or_env(values, "volc_engine_maas_ak", "VOLC_ACCESSKEY")
+        )
+        volc_engine_maas_sk = convert_to_secret_str(
+            get_from_dict_or_env(values, "volc_engine_maas_sk", "VOLC_SECRETKEY")
+        )
+        endpoint = values["endpoint"]
+        if values["endpoint"] is not None and values["endpoint"] != "":
+            endpoint = values["endpoint"]
+        try:
+            from volcengine.maas import MaasService
+
+            maas = MaasService(
+                endpoint,
+                values["region"],
+                connection_timeout=values["connect_timeout"],
+                socket_timeout=values["read_timeout"],
+            )
+            maas.set_ak(volc_engine_maas_ak.get_secret_value())
+            maas.set_sk(volc_engine_maas_sk.get_secret_value())
+
+            values["volc_engine_maas_ak"] = volc_engine_maas_ak
+            values["volc_engine_maas_sk"] = volc_engine_maas_sk
+            values["client"] = maas
+        except ImportError:
+            raise ImportError(
+                "volcengine package not found, please install it with "
+                "`pip install volcengine`"
+            )
+        return values
+
+    @property
+    def _default_params(self) -> Dict[str, Any]:
+        """Get the default parameters for calling VolcEngineMaas API."""
+        normal_params = {
+            "top_p": self.top_p,
+            "temperature": self.temperature,
+        }
+
+        return {**normal_params, **self.model_kwargs}
+
+
+class VolcEngineMaasLLM(LLM, VolcEngineMaasBase):
+    """volc engine maas hosts a plethora of models.
+    You can utilize these models through this class.
+
+    To use, you should have the ``volcengine`` python package installed.
+    and set access key and secret key by environment variable or direct pass those to
+    this class.
+    access key, secret key are required parameters which you could get help
+    https://www.volcengine.com/docs/6291/65568
+
+    In order to use them, it is necessary to install the 'volcengine' Python package.
+    The access key and secret key must be set either via environment variables or
+    passed directly to this class.
+    access key and secret key are mandatory parameters for which assistance can be
+    sought at https://www.volcengine.com/docs/6291/65568.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import VolcEngineMaasLLM
+            model = VolcEngineMaasLLM(model="skylark-lite-public",
+                                          volc_engine_maas_ak="your_ak",
+                                          volc_engine_maas_sk="your_sk")
+    """
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "volc-engine-maas-llm"
+
+    def _convert_prompt_msg_params(
+        self,
+        prompt: str,
+        **kwargs: Any,
+    ) -> dict:
+        model_req = {
+            "model": {
+                "name": self.model,
+            }
+        }
+        if self.model_version is not None:
+            model_req["model"]["version"] = self.model_version
+
+        return {
+            **model_req,
+            "messages": [{"role": "user", "content": prompt}],
+            "parameters": {**self._default_params, **kwargs},
+        }
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        if self.streaming:
+            completion = ""
+            for chunk in self._stream(prompt, stop, run_manager, **kwargs):
+                completion += chunk.text
+            return completion
+        params = self._convert_prompt_msg_params(prompt, **kwargs)
+        response = self.client.chat(params)
+
+        return response.get("choice", {}).get("message", {}).get("content", "")
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        params = self._convert_prompt_msg_params(prompt, **kwargs)
+        for res in self.client.stream_chat(params):
+            if res:
+                chunk = GenerationChunk(
+                    text=res.get("choice", {}).get("message", {}).get("content", "")
+                )
+                if run_manager:
+                    run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+                yield chunk
diff --git a/llm/Lib/site-packages/langchain_community/llms/watsonxllm.py b/llm/Lib/site-packages/langchain_community/llms/watsonxllm.py
new file mode 100644
index 0000000000000000000000000000000000000000..191574e094b06598594a4cd33c41f33ea96e98d2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/watsonxllm.py
@@ -0,0 +1,404 @@
+import logging
+import os
+from typing import Any, Dict, Iterator, List, Mapping, Optional, Union
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import BaseLLM
+from langchain_core.outputs import Generation, GenerationChunk, LLMResult
+from langchain_core.pydantic_v1 import Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+@deprecated(
+    since="0.0.18", removal="0.2", alternative_import="langchain_ibm.WatsonxLLM"
+)
+class WatsonxLLM(BaseLLM):
+    """
+    IBM watsonx.ai large language models.
+
+    To use, you should have ``ibm_watsonx_ai`` python package installed,
+    and the environment variable ``WATSONX_APIKEY`` set with your API key, or pass
+    it as a named parameter to the constructor.
+
+
+    Example:
+        .. code-block:: python
+
+            from ibm_watsonx_ai.metanames import GenTextParamsMetaNames
+            parameters = {
+                GenTextParamsMetaNames.DECODING_METHOD: "sample",
+                GenTextParamsMetaNames.MAX_NEW_TOKENS: 100,
+                GenTextParamsMetaNames.MIN_NEW_TOKENS: 1,
+                GenTextParamsMetaNames.TEMPERATURE: 0.5,
+                GenTextParamsMetaNames.TOP_K: 50,
+                GenTextParamsMetaNames.TOP_P: 1,
+            }
+
+            from langchain_community.llms import WatsonxLLM
+            watsonx_llm = WatsonxLLM(
+                model_id="google/flan-ul2",
+                url="https://us-south.ml.cloud.ibm.com",
+                apikey="*****",
+                project_id="*****",
+                params=parameters,
+            )
+    """
+
+    model_id: str = ""
+    """Type of model to use."""
+
+    deployment_id: str = ""
+    """Type of deployed model to use."""
+
+    project_id: str = ""
+    """ID of the Watson Studio project."""
+
+    space_id: str = ""
+    """ID of the Watson Studio space."""
+
+    url: Optional[SecretStr] = None
+    """Url to Watson Machine Learning instance"""
+
+    apikey: Optional[SecretStr] = None
+    """Apikey to Watson Machine Learning instance"""
+
+    token: Optional[SecretStr] = None
+    """Token to Watson Machine Learning instance"""
+
+    password: Optional[SecretStr] = None
+    """Password to Watson Machine Learning instance"""
+
+    username: Optional[SecretStr] = None
+    """Username to Watson Machine Learning instance"""
+
+    instance_id: Optional[SecretStr] = None
+    """Instance_id of Watson Machine Learning instance"""
+
+    version: Optional[SecretStr] = None
+    """Version of Watson Machine Learning instance"""
+
+    params: Optional[dict] = None
+    """Model parameters to use during generate requests."""
+
+    verify: Union[str, bool] = ""
+    """User can pass as verify one of following:
+        the path to a CA_BUNDLE file
+        the path of directory with certificates of trusted CAs
+        True - default path to truststore will be taken
+        False - no verification will be made"""
+
+    streaming: bool = False
+    """ Whether to stream the results or not. """
+
+    watsonx_model: Any
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return False
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        return {
+            "url": "WATSONX_URL",
+            "apikey": "WATSONX_APIKEY",
+            "token": "WATSONX_TOKEN",
+            "password": "WATSONX_PASSWORD",
+            "username": "WATSONX_USERNAME",
+            "instance_id": "WATSONX_INSTANCE_ID",
+        }
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that credentials and python package exists in environment."""
+        values["url"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "url", "WATSONX_URL")
+        )
+        if "cloud.ibm.com" in values.get("url", "").get_secret_value():
+            values["apikey"] = convert_to_secret_str(
+                get_from_dict_or_env(values, "apikey", "WATSONX_APIKEY")
+            )
+        else:
+            if (
+                not values["token"]
+                and "WATSONX_TOKEN" not in os.environ
+                and not values["password"]
+                and "WATSONX_PASSWORD" not in os.environ
+                and not values["apikey"]
+                and "WATSONX_APIKEY" not in os.environ
+            ):
+                raise ValueError(
+                    "Did not find 'token', 'password' or 'apikey',"
+                    " please add an environment variable"
+                    " `WATSONX_TOKEN`, 'WATSONX_PASSWORD' or 'WATSONX_APIKEY' "
+                    "which contains it,"
+                    " or pass 'token', 'password' or 'apikey'"
+                    " as a named parameter."
+                )
+            elif values["token"] or "WATSONX_TOKEN" in os.environ:
+                values["token"] = convert_to_secret_str(
+                    get_from_dict_or_env(values, "token", "WATSONX_TOKEN")
+                )
+            elif values["password"] or "WATSONX_PASSWORD" in os.environ:
+                values["password"] = convert_to_secret_str(
+                    get_from_dict_or_env(values, "password", "WATSONX_PASSWORD")
+                )
+                values["username"] = convert_to_secret_str(
+                    get_from_dict_or_env(values, "username", "WATSONX_USERNAME")
+                )
+            elif values["apikey"] or "WATSONX_APIKEY" in os.environ:
+                values["apikey"] = convert_to_secret_str(
+                    get_from_dict_or_env(values, "apikey", "WATSONX_APIKEY")
+                )
+                values["username"] = convert_to_secret_str(
+                    get_from_dict_or_env(values, "username", "WATSONX_USERNAME")
+                )
+            if not values["instance_id"] or "WATSONX_INSTANCE_ID" not in os.environ:
+                values["instance_id"] = convert_to_secret_str(
+                    get_from_dict_or_env(values, "instance_id", "WATSONX_INSTANCE_ID")
+                )
+
+        try:
+            from ibm_watsonx_ai.foundation_models import ModelInference
+
+            credentials = {
+                "url": values["url"].get_secret_value() if values["url"] else None,
+                "apikey": (
+                    values["apikey"].get_secret_value() if values["apikey"] else None
+                ),
+                "token": (
+                    values["token"].get_secret_value() if values["token"] else None
+                ),
+                "password": (
+                    values["password"].get_secret_value()
+                    if values["password"]
+                    else None
+                ),
+                "username": (
+                    values["username"].get_secret_value()
+                    if values["username"]
+                    else None
+                ),
+                "instance_id": (
+                    values["instance_id"].get_secret_value()
+                    if values["instance_id"]
+                    else None
+                ),
+                "version": (
+                    values["version"].get_secret_value() if values["version"] else None
+                ),
+            }
+            credentials_without_none_value = {
+                key: value for key, value in credentials.items() if value is not None
+            }
+
+            watsonx_model = ModelInference(
+                model_id=values["model_id"],
+                deployment_id=values["deployment_id"],
+                credentials=credentials_without_none_value,
+                params=values["params"],
+                project_id=values["project_id"],
+                space_id=values["space_id"],
+                verify=values["verify"],
+            )
+            values["watsonx_model"] = watsonx_model
+
+        except ImportError:
+            raise ImportError(
+                "Could not import ibm_watsonx_ai python package. "
+                "Please install it with `pip install ibm_watsonx_ai`."
+            )
+        return values
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model_id": self.model_id,
+            "deployment_id": self.deployment_id,
+            "params": self.params,
+            "project_id": self.project_id,
+            "space_id": self.space_id,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "IBM watsonx.ai"
+
+    @staticmethod
+    def _extract_token_usage(
+        response: Optional[List[Dict[str, Any]]] = None,
+    ) -> Dict[str, Any]:
+        if response is None:
+            return {"generated_token_count": 0, "input_token_count": 0}
+
+        input_token_count = 0
+        generated_token_count = 0
+
+        def get_count_value(key: str, result: Dict[str, Any]) -> int:
+            return result.get(key, 0) or 0
+
+        for res in response:
+            results = res.get("results")
+            if results:
+                input_token_count += get_count_value("input_token_count", results[0])
+                generated_token_count += get_count_value(
+                    "generated_token_count", results[0]
+                )
+
+        return {
+            "generated_token_count": generated_token_count,
+            "input_token_count": input_token_count,
+        }
+
+    def _get_chat_params(self, stop: Optional[List[str]] = None) -> Dict[str, Any]:
+        params: Dict[str, Any] = {**self.params} if self.params else {}
+        if stop is not None:
+            params["stop_sequences"] = stop
+        return params
+
+    def _create_llm_result(self, response: List[dict]) -> LLMResult:
+        """Create the LLMResult from the choices and prompts."""
+        generations = []
+        for res in response:
+            results = res.get("results")
+            if results:
+                finish_reason = results[0].get("stop_reason")
+                gen = Generation(
+                    text=results[0].get("generated_text"),
+                    generation_info={"finish_reason": finish_reason},
+                )
+                generations.append([gen])
+        final_token_usage = self._extract_token_usage(response)
+        llm_output = {
+            "token_usage": final_token_usage,
+            "model_id": self.model_id,
+            "deployment_id": self.deployment_id,
+        }
+        return LLMResult(generations=generations, llm_output=llm_output)
+
+    def _stream_response_to_generation_chunk(
+        self,
+        stream_response: Dict[str, Any],
+    ) -> GenerationChunk:
+        """Convert a stream response to a generation chunk."""
+        if not stream_response["results"]:
+            return GenerationChunk(text="")
+        return GenerationChunk(
+            text=stream_response["results"][0]["generated_text"],
+            generation_info=dict(
+                finish_reason=stream_response["results"][0].get("stop_reason", None),
+                llm_output={
+                    "model_id": self.model_id,
+                    "deployment_id": self.deployment_id,
+                },
+            ),
+        )
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call the IBM watsonx.ai inference endpoint.
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+            run_manager: Optional callback manager.
+        Returns:
+            The string generated by the model.
+        Example:
+            .. code-block:: python
+
+                response = watsonx_llm("What is a molecule")
+        """
+        result = self._generate(
+            prompts=[prompt], stop=stop, run_manager=run_manager, **kwargs
+        )
+        return result.generations[0][0].text
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        stream: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Call the IBM watsonx.ai inference endpoint which then generate the response.
+        Args:
+            prompts: List of strings (prompts) to pass into the model.
+            stop: Optional list of stop words to use when generating.
+            run_manager: Optional callback manager.
+        Returns:
+            The full LLMResult output.
+        Example:
+            .. code-block:: python
+
+                response = watsonx_llm.generate(["What is a molecule"])
+        """
+        params = self._get_chat_params(stop=stop)
+        should_stream = stream if stream is not None else self.streaming
+        if should_stream:
+            if len(prompts) > 1:
+                raise ValueError(
+                    f"WatsonxLLM currently only supports single prompt, got {prompts}"
+                )
+            generation = GenerationChunk(text="")
+            stream_iter = self._stream(
+                prompts[0], stop=stop, run_manager=run_manager, **kwargs
+            )
+            for chunk in stream_iter:
+                if generation is None:
+                    generation = chunk
+                else:
+                    generation += chunk
+            assert generation is not None
+            if isinstance(generation.generation_info, dict):
+                llm_output = generation.generation_info.pop("llm_output")
+                return LLMResult(generations=[[generation]], llm_output=llm_output)
+            return LLMResult(generations=[[generation]])
+        else:
+            response = self.watsonx_model.generate(prompt=prompts, params=params)
+            return self._create_llm_result(response)
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        """Call the IBM watsonx.ai inference endpoint which then streams the response.
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+            run_manager: Optional callback manager.
+        Returns:
+            The iterator which yields generation chunks.
+        Example:
+            .. code-block:: python
+
+                response = watsonx_llm.stream("What is a molecule")
+                for chunk in response:
+                    print(chunk, end='')  # noqa: T201
+        """
+        params = self._get_chat_params(stop=stop)
+        for stream_resp in self.watsonx_model.generate_text_stream(
+            prompt=prompt, raw_response=True, params=params
+        ):
+            chunk = self._stream_response_to_generation_chunk(stream_resp)
+
+            if run_manager:
+                run_manager.on_llm_new_token(chunk.text, chunk=chunk)
+            yield chunk
diff --git a/llm/Lib/site-packages/langchain_community/llms/weight_only_quantization.py b/llm/Lib/site-packages/langchain_community/llms/weight_only_quantization.py
new file mode 100644
index 0000000000000000000000000000000000000000..5480fbe036691c69e2dc9e70b460082bd79c1057
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/weight_only_quantization.py
@@ -0,0 +1,244 @@
+import importlib
+from typing import Any, List, Mapping, Optional
+
+from langchain_core.callbacks.manager import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+DEFAULT_MODEL_ID = "google/flan-t5-large"
+DEFAULT_TASK = "text2text-generation"
+VALID_TASKS = ("text2text-generation", "text-generation", "summarization")
+
+
+class WeightOnlyQuantPipeline(LLM):
+    """Weight only quantized model.
+
+    To use, you should have the `intel-extension-for-transformers` packabge and
+        `transformers` package installed.
+    intel-extension-for-transformers:
+        https://github.com/intel/intel-extension-for-transformers
+
+    Example using from_model_id:
+        .. code-block:: python
+
+            from langchain_community.llms import WeightOnlyQuantPipeline
+            from intel_extension_for_transformers.transformers import (
+                WeightOnlyQuantConfig
+            )
+            config = WeightOnlyQuantConfig
+            hf = WeightOnlyQuantPipeline.from_model_id(
+                model_id="google/flan-t5-large",
+                task="text2text-generation"
+                pipeline_kwargs={"max_new_tokens": 10},
+                quantization_config=config,
+            )
+    Example passing pipeline in directly:
+        .. code-block:: python
+
+            from langchain_community.llms import WeightOnlyQuantPipeline
+            from intel_extension_for_transformers.transformers import (
+                AutoModelForSeq2SeqLM
+            )
+            from intel_extension_for_transformers.transformers import (
+                WeightOnlyQuantConfig
+            )
+            from transformers import AutoTokenizer, pipeline
+
+            model_id = "google/flan-t5-large"
+            tokenizer = AutoTokenizer.from_pretrained(model_id)
+            config = WeightOnlyQuantConfig
+            model = AutoModelForSeq2SeqLM.from_pretrained(
+                model_id,
+                quantization_config=config,
+            )
+            pipe = pipeline(
+                "text-generation",
+                model=model,
+                tokenizer=tokenizer,
+                max_new_tokens=10,
+            )
+            hf = WeightOnlyQuantPipeline(pipeline=pipe)
+    """
+
+    pipeline: Any  #: :meta private:
+    model_id: str = DEFAULT_MODEL_ID
+    """Model name or local path to use."""
+
+    model_kwargs: Optional[dict] = None
+    """Key word arguments passed to the model."""
+
+    pipeline_kwargs: Optional[dict] = None
+    """Key word arguments passed to the pipeline."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.allow
+
+    @classmethod
+    def from_model_id(
+        cls,
+        model_id: str,
+        task: str,
+        device: Optional[int] = -1,
+        device_map: Optional[str] = None,
+        model_kwargs: Optional[dict] = None,
+        pipeline_kwargs: Optional[dict] = None,
+        load_in_4bit: Optional[bool] = False,
+        load_in_8bit: Optional[bool] = False,
+        quantization_config: Optional[Any] = None,
+        **kwargs: Any,
+    ) -> LLM:
+        """Construct the pipeline object from model_id and task."""
+        if device_map is not None and (isinstance(device, int) and device > -1):
+            raise ValueError("`Device` and `device_map` cannot be set simultaneously!")
+        if importlib.util.find_spec("torch") is None:
+            raise ValueError(
+                "Weight only quantization pipeline only support PyTorch now!"
+            )
+
+        try:
+            from intel_extension_for_transformers.transformers import (
+                AutoModelForCausalLM,
+                AutoModelForSeq2SeqLM,
+            )
+            from intel_extension_for_transformers.utils.utils import is_ipex_available
+            from transformers import AutoTokenizer
+            from transformers import pipeline as hf_pipeline
+        except ImportError:
+            raise ValueError(
+                "Could not import transformers python package. "
+                "Please install it with `pip install transformers` "
+                "and `pip install intel-extension-for-transformers`."
+            )
+        if isinstance(device, int) and device >= 0:
+            if not is_ipex_available():
+                raise ValueError("Don't find out Intel GPU on this machine!")
+            device_map = "xpu:" + str(device)
+        elif isinstance(device, int) and device < 0:
+            device = None
+
+        if device is None:
+            if device_map is None:
+                device_map = "cpu"
+
+        _model_kwargs = model_kwargs or {}
+        tokenizer = AutoTokenizer.from_pretrained(model_id, **_model_kwargs)
+
+        try:
+            if task == "text-generation":
+                model = AutoModelForCausalLM.from_pretrained(
+                    model_id,
+                    load_in_4bit=load_in_4bit,
+                    load_in_8bit=load_in_8bit,
+                    quantization_config=quantization_config,
+                    use_llm_runtime=False,
+                    device_map=device_map,
+                    **_model_kwargs,
+                )
+            elif task in ("text2text-generation", "summarization"):
+                model = AutoModelForSeq2SeqLM.from_pretrained(
+                    model_id,
+                    load_in_4bit=load_in_4bit,
+                    load_in_8bit=load_in_8bit,
+                    quantization_config=quantization_config,
+                    use_llm_runtime=False,
+                    device_map=device_map,
+                    **_model_kwargs,
+                )
+            else:
+                raise ValueError(
+                    f"Got invalid task {task}, "
+                    f"currently only {VALID_TASKS} are supported"
+                )
+        except ImportError as e:
+            raise ValueError(
+                f"Could not load the {task} model due to missing dependencies."
+            ) from e
+
+        if "trust_remote_code" in _model_kwargs:
+            _model_kwargs = {
+                k: v for k, v in _model_kwargs.items() if k != "trust_remote_code"
+            }
+        _pipeline_kwargs = pipeline_kwargs or {}
+        pipeline = hf_pipeline(
+            task=task,
+            model=model,
+            tokenizer=tokenizer,
+            device=device,
+            model_kwargs=_model_kwargs,
+            **_pipeline_kwargs,
+        )
+        if pipeline.task not in VALID_TASKS:
+            raise ValueError(
+                f"Got invalid task {pipeline.task}, "
+                f"currently only {VALID_TASKS} are supported"
+            )
+        return cls(
+            pipeline=pipeline,
+            model_id=model_id,
+            model_kwargs=_model_kwargs,
+            pipeline_kwargs=_pipeline_kwargs,
+            **kwargs,
+        )
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model_id": self.model_id,
+            "model_kwargs": self.model_kwargs,
+            "pipeline_kwargs": self.pipeline_kwargs,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "weight_only_quantization"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call the HuggingFace model and return the output.
+
+        Args:
+            prompt: The prompt to use for generation.
+            stop: A list of strings to stop generation when encountered.
+
+        Returns:
+            The generated text.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.llms import WeightOnlyQuantPipeline
+                llm = WeightOnlyQuantPipeline.from_model_id(
+                    model_id="google/flan-t5-large",
+                    task="text2text-generation",
+                )
+                llm("This is a prompt.")
+        """
+        response = self.pipeline(prompt)
+        if self.pipeline.task == "text-generation":
+            # Text generation return includes the starter text.
+            text = response[0]["generated_text"][len(prompt) :]
+        elif self.pipeline.task == "text2text-generation":
+            text = response[0]["generated_text"]
+        elif self.pipeline.task == "summarization":
+            text = response[0]["summary_text"]
+        else:
+            raise ValueError(
+                f"Got invalid task {self.pipeline.task}, "
+                f"currently only {VALID_TASKS} are supported"
+            )
+        if stop:
+            # This is a bit hacky, but I can't figure out a better way to enforce
+            # stop tokens when making calls to huggingface_hub.
+            text = enforce_stop_tokens(text, stop)
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/writer.py b/llm/Lib/site-packages/langchain_community/llms/writer.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b7bc6a06c4d77ca022676824a8dd60258f7fcb6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/writer.py
@@ -0,0 +1,159 @@
+from typing import Any, Dict, List, Mapping, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+
+class Writer(LLM):
+    """Writer large language models.
+
+    To use, you should have the environment variable ``WRITER_API_KEY`` and
+    ``WRITER_ORG_ID`` set with your API key and organization ID respectively.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import Writer
+            writer = Writer(model_id="palmyra-base")
+    """
+
+    writer_org_id: Optional[str] = None
+    """Writer organization ID."""
+
+    model_id: str = "palmyra-instruct"
+    """Model name to use."""
+
+    min_tokens: Optional[int] = None
+    """Minimum number of tokens to generate."""
+
+    max_tokens: Optional[int] = None
+    """Maximum number of tokens to generate."""
+
+    temperature: Optional[float] = None
+    """What sampling temperature to use."""
+
+    top_p: Optional[float] = None
+    """Total probability mass of tokens to consider at each step."""
+
+    stop: Optional[List[str]] = None
+    """Sequences when completion generation will stop."""
+
+    presence_penalty: Optional[float] = None
+    """Penalizes repeated tokens regardless of frequency."""
+
+    repetition_penalty: Optional[float] = None
+    """Penalizes repeated tokens according to frequency."""
+
+    best_of: Optional[int] = None
+    """Generates this many completions server-side and returns the "best"."""
+
+    logprobs: bool = False
+    """Whether to return log probabilities."""
+
+    n: Optional[int] = None
+    """How many completions to generate."""
+
+    writer_api_key: Optional[str] = None
+    """Writer API key."""
+
+    base_url: Optional[str] = None
+    """Base url to use, if None decides based on model name."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and organization id exist in environment."""
+
+        writer_api_key = get_from_dict_or_env(
+            values, "writer_api_key", "WRITER_API_KEY"
+        )
+        values["writer_api_key"] = writer_api_key
+
+        writer_org_id = get_from_dict_or_env(values, "writer_org_id", "WRITER_ORG_ID")
+        values["writer_org_id"] = writer_org_id
+
+        return values
+
+    @property
+    def _default_params(self) -> Mapping[str, Any]:
+        """Get the default parameters for calling Writer API."""
+        return {
+            "minTokens": self.min_tokens,
+            "maxTokens": self.max_tokens,
+            "temperature": self.temperature,
+            "topP": self.top_p,
+            "stop": self.stop,
+            "presencePenalty": self.presence_penalty,
+            "repetitionPenalty": self.repetition_penalty,
+            "bestOf": self.best_of,
+            "logprobs": self.logprobs,
+            "n": self.n,
+        }
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"model_id": self.model_id, "writer_org_id": self.writer_org_id},
+            **self._default_params,
+        }
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "writer"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to Writer's completions endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = Writer("Tell me a joke.")
+        """
+        if self.base_url is not None:
+            base_url = self.base_url
+        else:
+            base_url = (
+                "https://enterprise-api.writer.com/llm"
+                f"/organization/{self.writer_org_id}"
+                f"/model/{self.model_id}/completions"
+            )
+        params = {**self._default_params, **kwargs}
+        response = requests.post(
+            url=base_url,
+            headers={
+                "Authorization": f"{self.writer_api_key}",
+                "Content-Type": "application/json",
+                "Accept": "application/json",
+            },
+            json={"prompt": prompt, **params},
+        )
+        text = response.text
+        if stop is not None:
+            # I believe this is required since the stop tokens
+            # are not enforced by the model parameters
+            text = enforce_stop_tokens(text, stop)
+        return text
diff --git a/llm/Lib/site-packages/langchain_community/llms/xinference.py b/llm/Lib/site-packages/langchain_community/llms/xinference.py
new file mode 100644
index 0000000000000000000000000000000000000000..cc18bf31a948e67e9edadb2781f1bc766f9629cf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/xinference.py
@@ -0,0 +1,207 @@
+from typing import TYPE_CHECKING, Any, Dict, Generator, List, Mapping, Optional, Union
+
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+
+if TYPE_CHECKING:
+    from xinference.client import RESTfulChatModelHandle, RESTfulGenerateModelHandle
+    from xinference.model.llm.core import LlamaCppGenerateConfig
+
+
+class Xinference(LLM):
+    """`Xinference` large-scale model inference service.
+
+    To use, you should have the xinference library installed:
+
+    .. code-block:: bash
+
+       pip install "xinference[all]"
+
+    Check out: https://github.com/xorbitsai/inference
+    To run, you need to start a Xinference supervisor on one server and Xinference workers on the other servers
+
+    Example:
+        To start a local instance of Xinference, run
+
+        .. code-block:: bash
+
+           $ xinference
+
+        You can also deploy Xinference in a distributed cluster. Here are the steps:
+
+        Starting the supervisor:
+
+        .. code-block:: bash
+
+           $ xinference-supervisor
+
+        Starting the worker:
+
+        .. code-block:: bash
+
+           $ xinference-worker
+
+    Then, launch a model using command line interface (CLI).
+
+    Example:
+
+    .. code-block:: bash
+
+       $ xinference launch -n orca -s 3 -q q4_0
+
+    It will return a model UID. Then, you can use Xinference with LangChain.
+
+    Example:
+
+    .. code-block:: python
+
+        from langchain_community.llms import Xinference
+
+        llm = Xinference(
+            server_url="http://0.0.0.0:9997",
+            model_uid = {model_uid} # replace model_uid with the model UID return from launching the model
+        )
+
+        llm(
+            prompt="Q: where can we visit in the capital of France? A:",
+            generate_config={"max_tokens": 1024, "stream": True},
+        )
+
+    To view all the supported builtin models, run:
+
+    .. code-block:: bash
+
+        $ xinference list --all
+
+    """  # noqa: E501
+
+    client: Any
+    server_url: Optional[str]
+    """URL of the xinference server"""
+    model_uid: Optional[str]
+    """UID of the launched model"""
+    model_kwargs: Dict[str, Any]
+    """Keyword arguments to be passed to xinference.LLM"""
+
+    def __init__(
+        self,
+        server_url: Optional[str] = None,
+        model_uid: Optional[str] = None,
+        **model_kwargs: Any,
+    ):
+        try:
+            from xinference.client import RESTfulClient
+        except ImportError as e:
+            raise ImportError(
+                "Could not import RESTfulClient from xinference. Please install it"
+                " with `pip install xinference`."
+            ) from e
+
+        model_kwargs = model_kwargs or {}
+
+        super().__init__(
+            **{
+                "server_url": server_url,
+                "model_uid": model_uid,
+                "model_kwargs": model_kwargs,
+            }
+        )
+
+        if self.server_url is None:
+            raise ValueError("Please provide server URL")
+
+        if self.model_uid is None:
+            raise ValueError("Please provide the model UID")
+
+        self.client = RESTfulClient(server_url)
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "xinference"
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            **{"server_url": self.server_url},
+            **{"model_uid": self.model_uid},
+            **{"model_kwargs": self.model_kwargs},
+        }
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call the xinference model and return the output.
+
+        Args:
+            prompt: The prompt to use for generation.
+            stop: Optional list of stop words to use when generating.
+            generate_config: Optional dictionary for the configuration used for
+                generation.
+
+        Returns:
+            The generated string by the model.
+        """
+        model = self.client.get_model(self.model_uid)
+
+        generate_config: "LlamaCppGenerateConfig" = kwargs.get("generate_config", {})
+
+        generate_config = {**self.model_kwargs, **generate_config}
+
+        if stop:
+            generate_config["stop"] = stop
+
+        if generate_config and generate_config.get("stream"):
+            combined_text_output = ""
+            for token in self._stream_generate(
+                model=model,
+                prompt=prompt,
+                run_manager=run_manager,
+                generate_config=generate_config,
+            ):
+                combined_text_output += token
+            return combined_text_output
+
+        else:
+            completion = model.generate(prompt=prompt, generate_config=generate_config)
+            return completion["choices"][0]["text"]
+
+    def _stream_generate(
+        self,
+        model: Union["RESTfulGenerateModelHandle", "RESTfulChatModelHandle"],
+        prompt: str,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        generate_config: Optional["LlamaCppGenerateConfig"] = None,
+    ) -> Generator[str, None, None]:
+        """
+        Args:
+            prompt: The prompt to use for generation.
+            model: The model used for generation.
+            stop: Optional list of stop words to use when generating.
+            generate_config: Optional dictionary for the configuration used for
+                generation.
+
+        Yields:
+            A string token.
+        """
+        streaming_response = model.generate(
+            prompt=prompt, generate_config=generate_config
+        )
+        for chunk in streaming_response:
+            if isinstance(chunk, dict):
+                choices = chunk.get("choices", [])
+                if choices:
+                    choice = choices[0]
+                    if isinstance(choice, dict):
+                        token = choice.get("text", "")
+                        log_probs = choice.get("logprobs")
+                        if run_manager:
+                            run_manager.on_llm_new_token(
+                                token=token, verbose=self.verbose, log_probs=log_probs
+                            )
+                        yield token
diff --git a/llm/Lib/site-packages/langchain_community/llms/yandex.py b/llm/Lib/site-packages/langchain_community/llms/yandex.py
new file mode 100644
index 0000000000000000000000000000000000000000..da529a204ca352f6af9ebcbb361bfbd6b95a1a50
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/yandex.py
@@ -0,0 +1,335 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Callable, Dict, List, Optional, Sequence
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import LLM
+from langchain_core.load.serializable import Serializable
+from langchain_core.pydantic_v1 import SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+from tenacity import (
+    before_sleep_log,
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class _BaseYandexGPT(Serializable):
+    iam_token: SecretStr = ""  # type: ignore[assignment]
+    """Yandex Cloud IAM token for service or user account
+    with the `ai.languageModels.user` role"""
+    api_key: SecretStr = ""  # type: ignore[assignment]
+    """Yandex Cloud Api Key for service account
+    with the `ai.languageModels.user` role"""
+    folder_id: str = ""
+    """Yandex Cloud folder ID"""
+    model_uri: str = ""
+    """Model uri to use."""
+    model_name: str = "yandexgpt-lite"
+    """Model name to use."""
+    model_version: str = "latest"
+    """Model version to use."""
+    temperature: float = 0.6
+    """What sampling temperature to use.
+    Should be a double number between 0 (inclusive) and 1 (inclusive)."""
+    max_tokens: int = 7400
+    """Sets the maximum limit on the total number of tokens
+    used for both the input prompt and the generated response.
+    Must be greater than zero and not exceed 7400 tokens."""
+    stop: Optional[List[str]] = None
+    """Sequences when completion generation will stop."""
+    url: str = "llm.api.cloud.yandex.net:443"
+    """The url of the API."""
+    max_retries: int = 6
+    """Maximum number of retries to make when generating."""
+    sleep_interval: float = 1.0
+    """Delay between API requests"""
+    _grpc_metadata: Sequence
+
+    @property
+    def _llm_type(self) -> str:
+        return "yandex_gpt"
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model_uri": self.model_uri,
+            "temperature": self.temperature,
+            "max_tokens": self.max_tokens,
+            "stop": self.stop,
+            "max_retries": self.max_retries,
+        }
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that iam token exists in environment."""
+
+        iam_token = convert_to_secret_str(
+            get_from_dict_or_env(values, "iam_token", "YC_IAM_TOKEN", "")
+        )
+        values["iam_token"] = iam_token
+        api_key = convert_to_secret_str(
+            get_from_dict_or_env(values, "api_key", "YC_API_KEY", "")
+        )
+        values["api_key"] = api_key
+        folder_id = get_from_dict_or_env(values, "folder_id", "YC_FOLDER_ID", "")
+        values["folder_id"] = folder_id
+        if api_key.get_secret_value() == "" and iam_token.get_secret_value() == "":
+            raise ValueError("Either 'YC_API_KEY' or 'YC_IAM_TOKEN' must be provided.")
+
+        if values["iam_token"]:
+            values["_grpc_metadata"] = [
+                ("authorization", f"Bearer {values['iam_token'].get_secret_value()}")
+            ]
+            if values["folder_id"]:
+                values["_grpc_metadata"].append(("x-folder-id", values["folder_id"]))
+        else:
+            values["_grpc_metadata"] = (
+                ("authorization", f"Api-Key {values['api_key'].get_secret_value()}"),
+            )
+        if values["model_uri"] == "" and values["folder_id"] == "":
+            raise ValueError("Either 'model_uri' or 'folder_id' must be provided.")
+        if not values["model_uri"]:
+            values[
+                "model_uri"
+            ] = f"gpt://{values['folder_id']}/{values['model_name']}/{values['model_version']}"
+        return values
+
+
+class YandexGPT(_BaseYandexGPT, LLM):
+    """Yandex large language models.
+
+    To use, you should have the ``yandexcloud`` python package installed.
+
+    There are two authentication options for the service account
+    with the ``ai.languageModels.user`` role:
+        - You can specify the token in a constructor parameter `iam_token`
+        or in an environment variable `YC_IAM_TOKEN`.
+        - You can specify the key in a constructor parameter `api_key`
+        or in an environment variable `YC_API_KEY`.
+
+    To use the default model specify the folder ID in a parameter `folder_id`
+    or in an environment variable `YC_FOLDER_ID`.
+
+    Or specify the model URI in a constructor parameter `model_uri`
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.llms import YandexGPT
+            yandex_gpt = YandexGPT(iam_token="t1.9eu...", folder_id="b1g...")
+    """
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call the Yandex GPT model and return the output.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = YandexGPT("Tell me a joke.")
+        """
+        text = completion_with_retry(self, prompt=prompt)
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+        return text
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Async call the Yandex GPT model and return the output.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+        """
+        text = await acompletion_with_retry(self, prompt=prompt)
+        if stop is not None:
+            text = enforce_stop_tokens(text, stop)
+        return text
+
+
+def _make_request(
+    self: YandexGPT,
+    prompt: str,
+) -> str:
+    try:
+        import grpc
+        from google.protobuf.wrappers_pb2 import DoubleValue, Int64Value
+
+        try:
+            from yandex.cloud.ai.foundation_models.v1.text_common_pb2 import (
+                CompletionOptions,
+                Message,
+            )
+            from yandex.cloud.ai.foundation_models.v1.text_generation.text_generation_service_pb2 import (  # noqa: E501
+                CompletionRequest,
+            )
+            from yandex.cloud.ai.foundation_models.v1.text_generation.text_generation_service_pb2_grpc import (  # noqa: E501
+                TextGenerationServiceStub,
+            )
+        except ModuleNotFoundError:
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_pb2 import (
+                CompletionOptions,
+                Message,
+            )
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_service_pb2 import (  # noqa: E501
+                CompletionRequest,
+            )
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_service_pb2_grpc import (  # noqa: E501
+                TextGenerationServiceStub,
+            )
+    except ImportError as e:
+        raise ImportError(
+            "Please install YandexCloud SDK  with `pip install yandexcloud` \
+            or upgrade it to recent version."
+        ) from e
+    channel_credentials = grpc.ssl_channel_credentials()
+    channel = grpc.secure_channel(self.url, channel_credentials)
+    request = CompletionRequest(
+        model_uri=self.model_uri,
+        completion_options=CompletionOptions(
+            temperature=DoubleValue(value=self.temperature),
+            max_tokens=Int64Value(value=self.max_tokens),
+        ),
+        messages=[Message(role="user", text=prompt)],
+    )
+    stub = TextGenerationServiceStub(channel)
+    res = stub.Completion(request, metadata=self._grpc_metadata)  # type: ignore[attr-defined]
+    return list(res)[0].alternatives[0].message.text
+
+
+async def _amake_request(self: YandexGPT, prompt: str) -> str:
+    try:
+        import asyncio
+
+        import grpc
+        from google.protobuf.wrappers_pb2 import DoubleValue, Int64Value
+
+        try:
+            from yandex.cloud.ai.foundation_models.v1.text_common_pb2 import (
+                CompletionOptions,
+                Message,
+            )
+            from yandex.cloud.ai.foundation_models.v1.text_generation.text_generation_service_pb2 import (  # noqa: E501
+                CompletionRequest,
+                CompletionResponse,
+            )
+            from yandex.cloud.ai.foundation_models.v1.text_generation.text_generation_service_pb2_grpc import (  # noqa: E501
+                TextGenerationAsyncServiceStub,
+            )
+        except ModuleNotFoundError:
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_pb2 import (
+                CompletionOptions,
+                Message,
+            )
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_service_pb2 import (  # noqa: E501
+                CompletionRequest,
+                CompletionResponse,
+            )
+            from yandex.cloud.ai.foundation_models.v1.foundation_models_service_pb2_grpc import (  # noqa: E501
+                TextGenerationAsyncServiceStub,
+            )
+        from yandex.cloud.operation.operation_service_pb2 import GetOperationRequest
+        from yandex.cloud.operation.operation_service_pb2_grpc import (
+            OperationServiceStub,
+        )
+    except ImportError as e:
+        raise ImportError(
+            "Please install YandexCloud SDK  with `pip install yandexcloud` \
+            or upgrade it to recent version."
+        ) from e
+    operation_api_url = "operation.api.cloud.yandex.net:443"
+    channel_credentials = grpc.ssl_channel_credentials()
+    async with grpc.aio.secure_channel(self.url, channel_credentials) as channel:
+        request = CompletionRequest(
+            model_uri=self.model_uri,
+            completion_options=CompletionOptions(
+                temperature=DoubleValue(value=self.temperature),
+                max_tokens=Int64Value(value=self.max_tokens),
+            ),
+            messages=[Message(role="user", text=prompt)],
+        )
+        stub = TextGenerationAsyncServiceStub(channel)
+        operation = await stub.Completion(request, metadata=self._grpc_metadata)  # type: ignore[attr-defined]
+        async with grpc.aio.secure_channel(
+            operation_api_url, channel_credentials
+        ) as operation_channel:
+            operation_stub = OperationServiceStub(operation_channel)
+            while not operation.done:
+                await asyncio.sleep(1)
+                operation_request = GetOperationRequest(operation_id=operation.id)
+                operation = await operation_stub.Get(
+                    operation_request,
+                    metadata=self._grpc_metadata,  # type: ignore[attr-defined]
+                )
+
+        completion_response = CompletionResponse()
+        operation.response.Unpack(completion_response)
+        return completion_response.alternatives[0].message.text
+
+
+def _create_retry_decorator(llm: YandexGPT) -> Callable[[Any], Any]:
+    from grpc import RpcError
+
+    min_seconds = llm.sleep_interval
+    max_seconds = 60
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(llm.max_retries),
+        wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+        retry=(retry_if_exception_type((RpcError))),
+        before_sleep=before_sleep_log(logger, logging.WARNING),
+    )
+
+
+def completion_with_retry(llm: YandexGPT, **kwargs: Any) -> Any:
+    """Use tenacity to retry the completion call."""
+    retry_decorator = _create_retry_decorator(llm)
+
+    @retry_decorator
+    def _completion_with_retry(**_kwargs: Any) -> Any:
+        return _make_request(llm, **_kwargs)
+
+    return _completion_with_retry(**kwargs)
+
+
+async def acompletion_with_retry(llm: YandexGPT, **kwargs: Any) -> Any:
+    """Use tenacity to retry the async completion call."""
+    retry_decorator = _create_retry_decorator(llm)
+
+    @retry_decorator
+    async def _completion_with_retry(**_kwargs: Any) -> Any:
+        return await _amake_request(llm, **_kwargs)
+
+    return await _completion_with_retry(**kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/llms/yuan2.py b/llm/Lib/site-packages/langchain_community/llms/yuan2.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c345f929924a4dc7d7856eec9f7dd7ee2ff1bc4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/llms/yuan2.py
@@ -0,0 +1,205 @@
+import json
+import logging
+from typing import Any, Dict, List, Mapping, Optional, Set
+
+import requests
+from langchain_core.callbacks import CallbackManagerForLLMRun
+from langchain_core.language_models.llms import LLM
+from langchain_core.pydantic_v1 import Field
+
+from langchain_community.llms.utils import enforce_stop_tokens
+
+logger = logging.getLogger(__name__)
+
+
+class Yuan2(LLM):
+    """Yuan2.0 language models.
+
+    Example:
+        .. code-block:: python
+
+            yuan_llm = Yuan2(
+                infer_api="http://127.0.0.1:8000/yuan",
+                max_tokens=1024,
+                temp=1.0,
+                top_p=0.9,
+                top_k=40,
+            )
+            print(yuan_llm)
+            print(yuan_llm("你是谁？"))
+    """
+
+    infer_api: str = "http://127.0.0.1:8000/yuan"
+    """Yuan2.0 inference api"""
+
+    max_tokens: int = Field(1024, alias="max_token")
+    """Token context window."""
+
+    temp: Optional[float] = 0.7
+    """The temperature to use for sampling."""
+
+    top_p: Optional[float] = 0.9
+    """The top-p value to use for sampling."""
+
+    top_k: Optional[int] = 0
+    """The top-k value to use for sampling."""
+
+    do_sample: bool = False
+    """The do_sample is a Boolean value that determines whether 
+    to use the sampling method during text generation.
+    """
+
+    echo: Optional[bool] = False
+    """Whether to echo the prompt."""
+
+    stop: Optional[List[str]] = []
+    """A list of strings to stop generation when encountered."""
+
+    repeat_last_n: Optional[int] = 64
+    "Last n tokens to penalize"
+
+    repeat_penalty: Optional[float] = 1.18
+    """The penalty to apply to repeated tokens."""
+
+    streaming: bool = False
+    """Whether to stream the results or not."""
+
+    history: List[str] = []
+    """History of the conversation"""
+
+    use_history: bool = False
+    """Whether to use history or not"""
+
+    def __init__(self, **kwargs: Any) -> None:
+        """Initialize the Yuan2 class."""
+        super().__init__(**kwargs)
+
+        if (self.top_p or 0) > 0 and (self.top_k or 0) > 0:
+            logger.warning(
+                "top_p and top_k cannot be set simultaneously. "
+                "set top_k to 0 instead..."
+            )
+            self.top_k = 0
+
+    @property
+    def _llm_type(self) -> str:
+        return "Yuan2.0"
+
+    @staticmethod
+    def _model_param_names() -> Set[str]:
+        return {
+            "max_tokens",
+            "temp",
+            "top_k",
+            "top_p",
+            "do_sample",
+        }
+
+    def _default_params(self) -> Dict[str, Any]:
+        return {
+            "do_sample": self.do_sample,
+            "infer_api": self.infer_api,
+            "max_tokens": self.max_tokens,
+            "repeat_penalty": self.repeat_penalty,
+            "temp": self.temp,
+            "top_k": self.top_k,
+            "top_p": self.top_p,
+            "use_history": self.use_history,
+        }
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return {
+            "model": self._llm_type,
+            **self._default_params(),
+            **{
+                k: v for k, v in self.__dict__.items() if k in self._model_param_names()
+            },
+        }
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Call out to a Yuan2.0 LLM inference endpoint.
+
+        Args:
+            prompt: The prompt to pass into the model.
+            stop: Optional list of stop words to use when generating.
+
+        Returns:
+            The string generated by the model.
+
+        Example:
+            .. code-block:: python
+
+                response = yuan_llm("你能做什么?")
+        """
+
+        if self.use_history:
+            self.history.append(prompt)
+            input = "<n>".join(self.history)
+        else:
+            input = prompt
+
+        headers = {"Content-Type": "application/json"}
+
+        data = json.dumps(
+            {
+                "ques_list": [{"id": "000", "ques": input}],
+                "tokens_to_generate": self.max_tokens,
+                "temperature": self.temp,
+                "top_p": self.top_p,
+                "top_k": self.top_k,
+                "do_sample": self.do_sample,
+            }
+        )
+
+        logger.debug("Yuan2.0 prompt:", input)
+
+        # call api
+        try:
+            response = requests.put(self.infer_api, headers=headers, data=data)
+        except requests.exceptions.RequestException as e:
+            raise ValueError(f"Error raised by inference api: {e}")
+
+        logger.debug(f"Yuan2.0 response: {response}")
+
+        if response.status_code != 200:
+            raise ValueError(f"Failed with response: {response}")
+        try:
+            resp = response.json()
+
+            if resp["errCode"] != "0":
+                raise ValueError(
+                    f"Failed with error code [{resp['errCode']}], "
+                    f"error message: [{resp['exceptionMsg']}]"
+                )
+
+            if "resData" in resp:
+                if len(resp["resData"]["output"]) >= 0:
+                    generate_text = resp["resData"]["output"][0]["ans"]
+                else:
+                    raise ValueError("No output found in response.")
+            else:
+                raise ValueError("No resData found in response.")
+
+        except requests.exceptions.JSONDecodeError as e:
+            raise ValueError(
+                f"Error raised during decoding response from inference api: {e}."
+                f"\nResponse: {response.text}"
+            )
+
+        if stop is not None:
+            generate_text = enforce_stop_tokens(generate_text, stop)
+
+        # support multi-turn chat
+        if self.use_history:
+            self.history.append(generate_text)
+
+        logger.debug(f"history: {self.history}")
+        return generate_text
diff --git a/llm/Lib/site-packages/langchain_community/output_parsers/__init__.py b/llm/Lib/site-packages/langchain_community/output_parsers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..62740af544177ed54584b9c8fe349e97f914e753
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/output_parsers/__init__.py
@@ -0,0 +1,14 @@
+"""**OutputParser** classes parse the output of an LLM call.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseLLMOutputParser --> BaseOutputParser --> <name>OutputParser  # GuardrailsOutputParser
+
+**Main helpers:**
+
+.. code-block::
+
+    Serializable, Generation, PromptValue
+"""  # noqa: E501
diff --git a/llm/Lib/site-packages/langchain_community/output_parsers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/output_parsers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f5f0fe1adb05343e8a2bff9a5fcce5ba8104bbf3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/output_parsers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/output_parsers/__pycache__/ernie_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/output_parsers/__pycache__/ernie_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fcb849d964e265ca9a98bf93d9ae5e88f79af29d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/output_parsers/__pycache__/ernie_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/output_parsers/__pycache__/rail_parser.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/output_parsers/__pycache__/rail_parser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ac2e888b31fadf00192d633d777a3edae254f281
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/output_parsers/__pycache__/rail_parser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/output_parsers/ernie_functions.py b/llm/Lib/site-packages/langchain_community/output_parsers/ernie_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..223284649f3b4001930a90042fdfd8269d9a238e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/output_parsers/ernie_functions.py
@@ -0,0 +1,179 @@
+import copy
+import json
+from typing import Any, Dict, List, Optional, Type, Union
+
+import jsonpatch
+from langchain_core.exceptions import OutputParserException
+from langchain_core.output_parsers import (
+    BaseCumulativeTransformOutputParser,
+    BaseGenerationOutputParser,
+)
+from langchain_core.output_parsers.json import parse_partial_json
+from langchain_core.outputs.chat_generation import (
+    ChatGeneration,
+    Generation,
+)
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+
+class OutputFunctionsParser(BaseGenerationOutputParser[Any]):
+    """Parse an output that is one of sets of values."""
+
+    args_only: bool = True
+    """Whether to only return the arguments to the function call."""
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        generation = result[0]
+        if not isinstance(generation, ChatGeneration):
+            raise OutputParserException(
+                "This output parser can only be used with a chat generation."
+            )
+        message = generation.message
+        try:
+            func_call = copy.deepcopy(message.additional_kwargs["function_call"])
+        except KeyError as exc:
+            raise OutputParserException(f"Could not parse function call: {exc}")
+
+        if self.args_only:
+            return func_call["arguments"]
+        return func_call
+
+
+class JsonOutputFunctionsParser(BaseCumulativeTransformOutputParser[Any]):
+    """Parse an output as the Json object."""
+
+    strict: bool = False
+    """Whether to allow non-JSON-compliant strings.
+    
+    See: https://docs.python.org/3/library/json.html#encoders-and-decoders
+    
+    Useful when the parsed output may include unicode characters or new lines.
+    """
+
+    args_only: bool = True
+    """Whether to only return the arguments to the function call."""
+
+    @property
+    def _type(self) -> str:
+        return "json_functions"
+
+    def _diff(self, prev: Optional[Any], next: Any) -> Any:
+        return jsonpatch.make_patch(prev, next).patch
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        if len(result) != 1:
+            raise OutputParserException(
+                f"Expected exactly one result, but got {len(result)}"
+            )
+        generation = result[0]
+        if not isinstance(generation, ChatGeneration):
+            raise OutputParserException(
+                "This output parser can only be used with a chat generation."
+            )
+        message = generation.message
+        if "function_call" not in message.additional_kwargs:
+            return None
+        try:
+            function_call = message.additional_kwargs["function_call"]
+        except KeyError as exc:
+            if partial:
+                return None
+            else:
+                raise OutputParserException(f"Could not parse function call: {exc}")
+        try:
+            if partial:
+                if self.args_only:
+                    return parse_partial_json(
+                        function_call["arguments"], strict=self.strict
+                    )
+                else:
+                    return {
+                        **function_call,
+                        "arguments": parse_partial_json(
+                            function_call["arguments"], strict=self.strict
+                        ),
+                    }
+            else:
+                if self.args_only:
+                    try:
+                        return json.loads(
+                            function_call["arguments"], strict=self.strict
+                        )
+                    except (json.JSONDecodeError, TypeError) as exc:
+                        raise OutputParserException(
+                            f"Could not parse function call data: {exc}"
+                        )
+                else:
+                    try:
+                        return {
+                            **function_call,
+                            "arguments": json.loads(
+                                function_call["arguments"], strict=self.strict
+                            ),
+                        }
+                    except (json.JSONDecodeError, TypeError) as exc:
+                        raise OutputParserException(
+                            f"Could not parse function call data: {exc}"
+                        )
+        except KeyError:
+            return None
+
+    # This method would be called by the default implementation of `parse_result`
+    # but we're overriding that method so it's not needed.
+    def parse(self, text: str) -> Any:
+        raise NotImplementedError()
+
+
+class JsonKeyOutputFunctionsParser(JsonOutputFunctionsParser):
+    """Parse an output as the element of the Json object."""
+
+    key_name: str
+    """The name of the key to return."""
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        res = super().parse_result(result, partial=partial)
+        if partial and res is None:
+            return None
+        return res.get(self.key_name) if partial else res[self.key_name]
+
+
+class PydanticOutputFunctionsParser(OutputFunctionsParser):
+    """Parse an output as a pydantic object."""
+
+    pydantic_schema: Union[Type[BaseModel], Dict[str, Type[BaseModel]]]
+    """The pydantic schema to parse the output with."""
+
+    @root_validator(pre=True)
+    def validate_schema(cls, values: Dict) -> Dict:
+        schema = values["pydantic_schema"]
+        if "args_only" not in values:
+            values["args_only"] = isinstance(schema, type) and issubclass(
+                schema, BaseModel
+            )
+        elif values["args_only"] and isinstance(schema, Dict):
+            raise ValueError(
+                "If multiple pydantic schemas are provided then args_only should be"
+                " False."
+            )
+        return values
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        _result = super().parse_result(result)
+        if self.args_only:
+            pydantic_args = self.pydantic_schema.parse_raw(_result)  # type: ignore
+        else:
+            fn_name = _result["name"]
+            _args = _result["arguments"]
+            pydantic_args = self.pydantic_schema[fn_name].parse_raw(_args)  # type: ignore  # noqa: E501
+        return pydantic_args
+
+
+class PydanticAttrOutputFunctionsParser(PydanticOutputFunctionsParser):
+    """Parse an output as an attribute of a pydantic object."""
+
+    attr_name: str
+    """The name of the attribute to return."""
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        result = super().parse_result(result)
+        return getattr(result, self.attr_name)
diff --git a/llm/Lib/site-packages/langchain_community/output_parsers/rail_parser.py b/llm/Lib/site-packages/langchain_community/output_parsers/rail_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..f0cabc13eb553c477c606b77f8d7c24b63932145
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/output_parsers/rail_parser.py
@@ -0,0 +1,109 @@
+from __future__ import annotations
+
+from typing import Any, Callable, Dict, Optional
+
+from langchain_core.output_parsers import BaseOutputParser
+
+
+class GuardrailsOutputParser(BaseOutputParser):
+    """Parse the output of an LLM call using Guardrails."""
+
+    guard: Any
+    """The Guardrails object."""
+    api: Optional[Callable]
+    """The LLM API passed to Guardrails during parsing. An example is `openai.completions.create`."""  # noqa: E501
+    args: Any
+    """Positional arguments to pass to the above LLM API callable."""
+    kwargs: Any
+    """Keyword arguments to pass to the above LLM API callable."""
+
+    @property
+    def _type(self) -> str:
+        return "guardrails"
+
+    @classmethod
+    def from_rail(
+        cls,
+        rail_file: str,
+        num_reasks: int = 1,
+        api: Optional[Callable] = None,
+        *args: Any,
+        **kwargs: Any,
+    ) -> GuardrailsOutputParser:
+        """Create a GuardrailsOutputParser from a rail file.
+
+        Args:
+            rail_file: a rail file.
+            num_reasks: number of times to re-ask the question.
+            api: the API to use for the Guardrails object.
+            *args: The arguments to pass to the API
+            **kwargs: The keyword arguments to pass to the API.
+
+        Returns:
+            GuardrailsOutputParser
+        """
+        try:
+            from guardrails import Guard
+        except ImportError:
+            raise ImportError(
+                "guardrails-ai package not installed. "
+                "Install it by running `pip install guardrails-ai`."
+            )
+        return cls(
+            guard=Guard.from_rail(rail_file, num_reasks=num_reasks),
+            api=api,
+            args=args,
+            kwargs=kwargs,
+        )
+
+    @classmethod
+    def from_rail_string(
+        cls,
+        rail_str: str,
+        num_reasks: int = 1,
+        api: Optional[Callable] = None,
+        *args: Any,
+        **kwargs: Any,
+    ) -> GuardrailsOutputParser:
+        try:
+            from guardrails import Guard
+        except ImportError:
+            raise ImportError(
+                "guardrails-ai package not installed. "
+                "Install it by running `pip install guardrails-ai`."
+            )
+        return cls(
+            guard=Guard.from_rail_string(rail_str, num_reasks=num_reasks),
+            api=api,
+            args=args,
+            kwargs=kwargs,
+        )
+
+    @classmethod
+    def from_pydantic(
+        cls,
+        output_class: Any,
+        num_reasks: int = 1,
+        api: Optional[Callable] = None,
+        *args: Any,
+        **kwargs: Any,
+    ) -> GuardrailsOutputParser:
+        try:
+            from guardrails import Guard
+        except ImportError:
+            raise ImportError(
+                "guardrails-ai package not installed. "
+                "Install it by running `pip install guardrails-ai`."
+            )
+        return cls(
+            guard=Guard.from_pydantic(output_class, "", num_reasks=num_reasks),
+            api=api,
+            args=args,
+            kwargs=kwargs,
+        )
+
+    def get_format_instructions(self) -> str:
+        return self.guard.raw_prompt.format_instructions
+
+    def parse(self, text: str) -> Dict:
+        return self.guard.parse(text, llm_api=self.api, *self.args, **self.kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/py.typed b/llm/Lib/site-packages/langchain_community/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__init__.py b/llm/Lib/site-packages/langchain_community/retrievers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..32f5fc13b70f61f7ee33ccb3b1a72a1873fa49b6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/__init__.py
@@ -0,0 +1,226 @@
+"""**Retriever** class returns Documents given a text **query**.
+
+It is more general than a vector store. A retriever does not need to be able to
+store documents, only to return (or retrieve) it. Vector stores can be used as
+the backbone of a retriever, but there are other types of retrievers as well.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseRetriever --> <name>Retriever  # Examples: ArxivRetriever, MergerRetriever
+
+**Main helpers:**
+
+.. code-block::
+
+    Document, Serializable, Callbacks,
+    CallbackManagerForRetrieverRun, AsyncCallbackManagerForRetrieverRun
+"""
+
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.retrievers.arcee import (
+        ArceeRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.arxiv import (
+        ArxivRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.azure_cognitive_search import (
+        AzureCognitiveSearchRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.bedrock import (
+        AmazonKnowledgeBasesRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.bm25 import (
+        BM25Retriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.breebs import (
+        BreebsRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.chaindesk import (
+        ChaindeskRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.chatgpt_plugin_retriever import (
+        ChatGPTPluginRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.cohere_rag_retriever import (
+        CohereRagRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.docarray import (
+        DocArrayRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.dria_index import (
+        DriaRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.elastic_search_bm25 import (
+        ElasticSearchBM25Retriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.embedchain import (
+        EmbedchainRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.google_cloud_documentai_warehouse import (
+        GoogleDocumentAIWarehouseRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.google_vertex_ai_search import (
+        GoogleCloudEnterpriseSearchRetriever,  # noqa: F401
+        GoogleVertexAIMultiTurnSearchRetriever,  # noqa: F401
+        GoogleVertexAISearchRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.kay import (
+        KayAiRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.kendra import (
+        AmazonKendraRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.knn import (
+        KNNRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.llama_index import (
+        LlamaIndexGraphRetriever,  # noqa: F401
+        LlamaIndexRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.metal import (
+        MetalRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.milvus import (
+        MilvusRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.outline import (
+        OutlineRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.pinecone_hybrid_search import (
+        PineconeHybridSearchRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.pubmed import (
+        PubMedRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.qdrant_sparse_vector_retriever import (
+        QdrantSparseVectorRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.remote_retriever import (
+        RemoteLangChainRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.svm import (
+        SVMRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.tavily_search_api import (
+        TavilySearchAPIRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.tfidf import (
+        TFIDFRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.vespa_retriever import (
+        VespaRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.weaviate_hybrid_search import (
+        WeaviateHybridSearchRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.wikipedia import (
+        WikipediaRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.you import (
+        YouRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.zep import (
+        ZepRetriever,  # noqa: F401
+    )
+    from langchain_community.retrievers.zilliz import (
+        ZillizRetriever,  # noqa: F401
+    )
+
+__all__ = [
+    "AmazonKendraRetriever",
+    "AmazonKnowledgeBasesRetriever",
+    "ArceeRetriever",
+    "ArxivRetriever",
+    "AzureCognitiveSearchRetriever",
+    "BM25Retriever",
+    "BreebsRetriever",
+    "ChaindeskRetriever",
+    "ChatGPTPluginRetriever",
+    "CohereRagRetriever",
+    "DocArrayRetriever",
+    "DriaRetriever",
+    "ElasticSearchBM25Retriever",
+    "EmbedchainRetriever",
+    "GoogleCloudEnterpriseSearchRetriever",
+    "GoogleDocumentAIWarehouseRetriever",
+    "GoogleVertexAIMultiTurnSearchRetriever",
+    "GoogleVertexAISearchRetriever",
+    "KNNRetriever",
+    "KayAiRetriever",
+    "LlamaIndexGraphRetriever",
+    "LlamaIndexRetriever",
+    "MetalRetriever",
+    "MilvusRetriever",
+    "OutlineRetriever",
+    "PineconeHybridSearchRetriever",
+    "PubMedRetriever",
+    "QdrantSparseVectorRetriever",
+    "RemoteLangChainRetriever",
+    "SVMRetriever",
+    "TFIDFRetriever",
+    "TavilySearchAPIRetriever",
+    "VespaRetriever",
+    "WeaviateHybridSearchRetriever",
+    "WikipediaRetriever",
+    "YouRetriever",
+    "ZepRetriever",
+    "ZillizRetriever",
+]
+
+_module_lookup = {
+    "AmazonKendraRetriever": "langchain_community.retrievers.kendra",
+    "AmazonKnowledgeBasesRetriever": "langchain_community.retrievers.bedrock",
+    "ArceeRetriever": "langchain_community.retrievers.arcee",
+    "ArxivRetriever": "langchain_community.retrievers.arxiv",
+    "AzureAISearchRetriever": "langchain_community.retrievers.azure_ai_search",  # noqa: E501
+    "AzureCognitiveSearchRetriever": "langchain_community.retrievers.azure_ai_search",  # noqa: E501
+    "BM25Retriever": "langchain_community.retrievers.bm25",
+    "BreebsRetriever": "langchain_community.retrievers.breebs",
+    "ChaindeskRetriever": "langchain_community.retrievers.chaindesk",
+    "ChatGPTPluginRetriever": "langchain_community.retrievers.chatgpt_plugin_retriever",
+    "CohereRagRetriever": "langchain_community.retrievers.cohere_rag_retriever",
+    "DocArrayRetriever": "langchain_community.retrievers.docarray",
+    "DriaRetriever": "langchain_community.retrievers.dria_index",
+    "ElasticSearchBM25Retriever": "langchain_community.retrievers.elastic_search_bm25",
+    "EmbedchainRetriever": "langchain_community.retrievers.embedchain",
+    "GoogleCloudEnterpriseSearchRetriever": "langchain_community.retrievers.google_vertex_ai_search",  # noqa: E501
+    "GoogleDocumentAIWarehouseRetriever": "langchain_community.retrievers.google_cloud_documentai_warehouse",  # noqa: E501
+    "GoogleVertexAIMultiTurnSearchRetriever": "langchain_community.retrievers.google_vertex_ai_search",  # noqa: E501
+    "GoogleVertexAISearchRetriever": "langchain_community.retrievers.google_vertex_ai_search",  # noqa: E501
+    "KNNRetriever": "langchain_community.retrievers.knn",
+    "KayAiRetriever": "langchain_community.retrievers.kay",
+    "LlamaIndexGraphRetriever": "langchain_community.retrievers.llama_index",
+    "LlamaIndexRetriever": "langchain_community.retrievers.llama_index",
+    "MetalRetriever": "langchain_community.retrievers.metal",
+    "MilvusRetriever": "langchain_community.retrievers.milvus",
+    "OutlineRetriever": "langchain_community.retrievers.outline",
+    "PineconeHybridSearchRetriever": "langchain_community.retrievers.pinecone_hybrid_search",  # noqa: E501
+    "PubMedRetriever": "langchain_community.retrievers.pubmed",
+    "QdrantSparseVectorRetriever": "langchain_community.retrievers.qdrant_sparse_vector_retriever",  # noqa: E501
+    "RemoteLangChainRetriever": "langchain_community.retrievers.remote_retriever",
+    "SVMRetriever": "langchain_community.retrievers.svm",
+    "TFIDFRetriever": "langchain_community.retrievers.tfidf",
+    "TavilySearchAPIRetriever": "langchain_community.retrievers.tavily_search_api",
+    "VespaRetriever": "langchain_community.retrievers.vespa_retriever",
+    "WeaviateHybridSearchRetriever": "langchain_community.retrievers.weaviate_hybrid_search",  # noqa: E501
+    "WikipediaRetriever": "langchain_community.retrievers.wikipedia",
+    "YouRetriever": "langchain_community.retrievers.you",
+    "ZepRetriever": "langchain_community.retrievers.zep",
+    "ZillizRetriever": "langchain_community.retrievers.zilliz",
+    "NeuralDBRetriever": "langchain_community.retrievers.thirdai_neuraldb",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dddcdfbd87b83bd1980e14f12165514e43cfb218
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/arcee.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/arcee.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..12c53af00814d8c5f209da36fedafb1982fe050b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/arcee.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/arxiv.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/arxiv.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5f35f5013790b86272bf8a7a1fa448ef4334c77b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/arxiv.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/azure_ai_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/azure_ai_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3b632ff9c5ea6b566c0696bb0eea0a8efb7ddaa2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/azure_ai_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/bedrock.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/bedrock.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f6fb887dc0482bebb5b0b814b13b90e618ba6965
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/bedrock.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/bm25.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/bm25.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..29ff9ef11caf6bf31d8fb06a9c4cbd542aef9e5d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/bm25.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/breebs.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/breebs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..34c0f8d2714e881ab171fba20d0cd7af06c54b51
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/breebs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/chaindesk.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/chaindesk.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d11bf78d7bee8e26d6708cc875fe5a4e4fd5bc11
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/chaindesk.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/chatgpt_plugin_retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/chatgpt_plugin_retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..edf5b1a8eb383ab733425275adfabe5874cbbd99
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/chatgpt_plugin_retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/cohere_rag_retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/cohere_rag_retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..677d18a5ef6caec2dea9a6dea451be58ae696863
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/cohere_rag_retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/databerry.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/databerry.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bd11ac090690c8fb78093ccb32bec5fea98495fc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/databerry.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/docarray.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/docarray.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e83a980fa373b99d911c2a562f67a7a6a0edebd
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/docarray.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/dria_index.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/dria_index.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0b787c1b899aa389fbf9134c71f28fbf37365643
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/dria_index.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/elastic_search_bm25.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/elastic_search_bm25.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2a17ba6e5e7dde738a5229a444aae81daf29d232
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/elastic_search_bm25.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/embedchain.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/embedchain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0009c8de26fab9c15bc17bd9c121bfa44566fa89
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/embedchain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/google_cloud_documentai_warehouse.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/google_cloud_documentai_warehouse.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e057f22de9f55b8c201a8e548fc082a64177ee63
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/google_cloud_documentai_warehouse.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/google_vertex_ai_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/google_vertex_ai_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..50fb179ed74e1ca9ff71e0162c5efcb4514ff5f7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/google_vertex_ai_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/kay.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/kay.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..61f4204b78f6bc149d12e2355447f238b0872694
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/kay.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/kendra.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/kendra.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..04e6520d42b4a391805824009662a3f8cbd97523
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/kendra.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/knn.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/knn.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..19cb090e5de5343f6014ac257902a3766443c58a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/knn.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/llama_index.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/llama_index.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aeec23fd1f9cae6bca22feda8aac9574c0a4e15f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/llama_index.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/metal.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/metal.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1dfa2ceefcd9b21cbff331ffff972495e0bca794
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/metal.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/milvus.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/milvus.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..886cf0c1894dfa11d362d7ac8b82d7e17b0444a3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/milvus.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/outline.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/outline.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8183c113745984d29b8e9d193624135f0366d24c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/outline.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/pinecone_hybrid_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/pinecone_hybrid_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cb335209b90b35728971deb444c1ab6c28b35d17
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/pinecone_hybrid_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/pubmed.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/pubmed.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5d8624cc2826f6748832d87d40f9193dfb97d987
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/pubmed.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/pupmed.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/pupmed.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..719baab835f344ffd6d60c99af1ff4a66d7deea4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/pupmed.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/qdrant_sparse_vector_retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/qdrant_sparse_vector_retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bc608e788e2afa809a673ab59abb3985e9d9ba61
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/qdrant_sparse_vector_retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/remote_retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/remote_retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f3c8c3c7dc3bc968db204517873ebed7c486b086
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/remote_retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/svm.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/svm.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..56872f88d59a4dae3c751ee561911483073a134f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/svm.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/tavily_search_api.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/tavily_search_api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..75b8b6d2039b30e1ca012fe6dc6179118b1471f3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/tavily_search_api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/tfidf.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/tfidf.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3f7153df04c915001ad880f4af2e7ebbe80cf7a5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/tfidf.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/thirdai_neuraldb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/thirdai_neuraldb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..436f6831cfe80492cce4009ce3211652e5480c4c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/thirdai_neuraldb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/vespa_retriever.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/vespa_retriever.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..298c62da821cf66709e555fd308be876e9647e08
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/vespa_retriever.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/weaviate_hybrid_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/weaviate_hybrid_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f3ae78531ed94a5675eced6db8104f01bf1f7908
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/weaviate_hybrid_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/wikipedia.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/wikipedia.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b145ba4ea6a59be64347f79b6f897b2dc1918191
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/wikipedia.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/you.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/you.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..67b61f6f29eccd09b3ca330451ca024eaffedcb4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/you.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/zep.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/zep.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..50b67a2b79b1680011619fd9bce7510f2ccfa84d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/zep.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/zilliz.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/zilliz.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2fb22c2506bd378afc284afd5cc94a59e75eda6d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/retrievers/__pycache__/zilliz.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/arcee.py b/llm/Lib/site-packages/langchain_community/retrievers/arcee.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7e645c934321bc3b998cbacd55187465cb3f947
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/arcee.py
@@ -0,0 +1,139 @@
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Extra, SecretStr, root_validator
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+from langchain_community.utilities.arcee import ArceeWrapper, DALMFilter
+
+
+class ArceeRetriever(BaseRetriever):
+    """Arcee Domain Adapted Language Models (DALMs) retriever.
+
+    To use, set the ``ARCEE_API_KEY`` environment variable with your Arcee API key,
+    or pass ``arcee_api_key`` as a named parameter.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.retrievers import ArceeRetriever
+
+            retriever = ArceeRetriever(
+                model="DALM-PubMed",
+                arcee_api_key="ARCEE-API-KEY"
+            )
+
+            documents = retriever.get_relevant_documents("AI-driven music therapy")
+    """
+
+    _client: Optional[ArceeWrapper] = None  #: :meta private:
+    """Arcee client."""
+
+    arcee_api_key: SecretStr
+    """Arcee API Key"""
+
+    model: str
+    """Arcee DALM name"""
+
+    arcee_api_url: str = "https://api.arcee.ai"
+    """Arcee API URL"""
+
+    arcee_api_version: str = "v2"
+    """Arcee API Version"""
+
+    arcee_app_url: str = "https://app.arcee.ai"
+    """Arcee App URL"""
+
+    model_kwargs: Optional[Dict[str, Any]] = None
+    """Keyword arguments to pass to the model."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        underscore_attrs_are_private = True
+
+    def __init__(self, **data: Any) -> None:
+        """Initializes private fields."""
+
+        super().__init__(**data)
+
+        self._client = ArceeWrapper(
+            arcee_api_key=self.arcee_api_key.get_secret_value(),
+            arcee_api_url=self.arcee_api_url,
+            arcee_api_version=self.arcee_api_version,
+            model_kwargs=self.model_kwargs,
+            model_name=self.model,
+        )
+
+        self._client.validate_model_training_status()
+
+    @root_validator()
+    def validate_environments(cls, values: Dict) -> Dict:
+        """Validate Arcee environment variables."""
+
+        # validate env vars
+        values["arcee_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "arcee_api_key",
+                "ARCEE_API_KEY",
+            )
+        )
+
+        values["arcee_api_url"] = get_from_dict_or_env(
+            values,
+            "arcee_api_url",
+            "ARCEE_API_URL",
+        )
+
+        values["arcee_app_url"] = get_from_dict_or_env(
+            values,
+            "arcee_app_url",
+            "ARCEE_APP_URL",
+        )
+
+        values["arcee_api_version"] = get_from_dict_or_env(
+            values,
+            "arcee_api_version",
+            "ARCEE_API_VERSION",
+        )
+
+        # validate model kwargs
+        if values["model_kwargs"]:
+            kw = values["model_kwargs"]
+
+            # validate size
+            if kw.get("size") is not None:
+                if not kw.get("size") >= 0:
+                    raise ValueError("`size` must not be negative.")
+
+            # validate filters
+            if kw.get("filters") is not None:
+                if not isinstance(kw.get("filters"), List):
+                    raise ValueError("`filters` must be a list.")
+                for f in kw.get("filters"):
+                    DALMFilter(**f)
+
+        return values
+
+    def _get_relevant_documents(
+        self, query: str, run_manager: CallbackManagerForRetrieverRun, **kwargs: Any
+    ) -> List[Document]:
+        """Retrieve {size} contexts with your retriever for a given query
+
+        Args:
+            query: Query to submit to the model
+            size: The max number of context results to retrieve.
+            Defaults to 3. (Can be less if filters are provided).
+            filters: Filters to apply to the context dataset.
+        """
+
+        try:
+            if not self._client:
+                raise ValueError("Client is not initialized.")
+            return self._client.retrieve(query=query, **kwargs)
+        except Exception as e:
+            raise ValueError(f"Error while retrieving documents: {e}") from e
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/arxiv.py b/llm/Lib/site-packages/langchain_community/retrievers/arxiv.py
new file mode 100644
index 0000000000000000000000000000000000000000..633d22b1a240b6f3572feb9d5bc6d66719c6397d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/arxiv.py
@@ -0,0 +1,25 @@
+from typing import List
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+from langchain_community.utilities.arxiv import ArxivAPIWrapper
+
+
+class ArxivRetriever(BaseRetriever, ArxivAPIWrapper):
+    """`Arxiv` retriever.
+
+    It wraps load() to get_relevant_documents().
+    It uses all ArxivAPIWrapper arguments without any change.
+    """
+
+    get_full_documents: bool = False
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        if self.get_full_documents:
+            return self.load(query=query)
+        else:
+            return self.get_summaries_as_docs(query)
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/azure_ai_search.py b/llm/Lib/site-packages/langchain_community/retrievers/azure_ai_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e4c0594bb07e7e63e4994162276ebeb609d8f85
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/azure_ai_search.py
@@ -0,0 +1,132 @@
+from __future__ import annotations
+
+import json
+from typing import Dict, List, Optional
+
+import aiohttp
+import requests
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.utils import get_from_dict_or_env, get_from_env
+
+DEFAULT_URL_SUFFIX = "search.windows.net"
+"""Default URL Suffix for endpoint connection - commercial cloud"""
+
+
+class AzureAISearchRetriever(BaseRetriever):
+    """`Azure AI Search` service retriever."""
+
+    service_name: str = ""
+    """Name of Azure AI Search service"""
+    index_name: str = ""
+    """Name of Index inside Azure AI Search service"""
+    api_key: str = ""
+    """API Key. Both Admin and Query keys work, but for reading data it's
+    recommended to use a Query key."""
+    api_version: str = "2023-11-01"
+    """API version"""
+    aiosession: Optional[aiohttp.ClientSession] = None
+    """ClientSession, in case we want to reuse connection for better performance."""
+    content_key: str = "content"
+    """Key in a retrieved result to set as the Document page_content."""
+    top_k: Optional[int] = None
+    """Number of results to retrieve. Set to None to retrieve all results."""
+
+    class Config:
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that service name, index name and api key exists in environment."""
+        values["service_name"] = get_from_dict_or_env(
+            values, "service_name", "AZURE_AI_SEARCH_SERVICE_NAME"
+        )
+        values["index_name"] = get_from_dict_or_env(
+            values, "index_name", "AZURE_AI_SEARCH_INDEX_NAME"
+        )
+        values["api_key"] = get_from_dict_or_env(
+            values, "api_key", "AZURE_AI_SEARCH_API_KEY"
+        )
+        return values
+
+    def _build_search_url(self, query: str) -> str:
+        url_suffix = get_from_env("", "AZURE_AI_SEARCH_URL_SUFFIX", DEFAULT_URL_SUFFIX)
+        if url_suffix in self.service_name and "https://" in self.service_name:
+            base_url = f"{self.service_name}/"
+        elif url_suffix in self.service_name and "https://" not in self.service_name:
+            base_url = f"https://{self.service_name}/"
+        elif url_suffix not in self.service_name and "https://" in self.service_name:
+            base_url = f"{self.service_name}.{url_suffix}/"
+        elif (
+            url_suffix not in self.service_name and "https://" not in self.service_name
+        ):
+            base_url = f"https://{self.service_name}.{url_suffix}/"
+        else:
+            # pass to Azure to throw a specific error
+            base_url = self.service_name
+        endpoint_path = f"indexes/{self.index_name}/docs?api-version={self.api_version}"
+        top_param = f"&$top={self.top_k}" if self.top_k else ""
+        return base_url + endpoint_path + f"&search={query}" + top_param
+
+    @property
+    def _headers(self) -> Dict[str, str]:
+        return {
+            "Content-Type": "application/json",
+            "api-key": self.api_key,
+        }
+
+    def _search(self, query: str) -> List[dict]:
+        search_url = self._build_search_url(query)
+        response = requests.get(search_url, headers=self._headers)
+        if response.status_code != 200:
+            raise Exception(f"Error in search request: {response}")
+
+        return json.loads(response.text)["value"]
+
+    async def _asearch(self, query: str) -> List[dict]:
+        search_url = self._build_search_url(query)
+        if not self.aiosession:
+            async with aiohttp.ClientSession() as session:
+                async with session.get(search_url, headers=self._headers) as response:
+                    response_json = await response.json()
+        else:
+            async with self.aiosession.get(
+                search_url, headers=self._headers
+            ) as response:
+                response_json = await response.json()
+
+        return response_json["value"]
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        search_results = self._search(query)
+
+        return [
+            Document(page_content=result.pop(self.content_key), metadata=result)
+            for result in search_results
+        ]
+
+    async def _aget_relevant_documents(
+        self, query: str, *, run_manager: AsyncCallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        search_results = await self._asearch(query)
+
+        return [
+            Document(page_content=result.pop(self.content_key), metadata=result)
+            for result in search_results
+        ]
+
+
+# For backwards compatibility
+class AzureCognitiveSearchRetriever(AzureAISearchRetriever):
+    """`Azure Cognitive Search` service retriever.
+    This version of the retriever will soon be
+    depreciated. Please switch to AzureAISearchRetriever
+    """
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/bedrock.py b/llm/Lib/site-packages/langchain_community/retrievers/bedrock.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c3d1d660da061d834c2f133be375aed698900a4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/bedrock.py
@@ -0,0 +1,128 @@
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.retrievers import BaseRetriever
+
+
+class VectorSearchConfig(BaseModel, extra="allow"):  # type: ignore[call-arg]
+    """Configuration for vector search."""
+
+    numberOfResults: int = 4
+
+
+class RetrievalConfig(BaseModel, extra="allow"):  # type: ignore[call-arg]
+    """Configuration for retrieval."""
+
+    vectorSearchConfiguration: VectorSearchConfig
+
+
+class AmazonKnowledgeBasesRetriever(BaseRetriever):
+    """`Amazon Bedrock Knowledge Bases` retrieval.
+
+    See https://aws.amazon.com/bedrock/knowledge-bases for more info.
+
+    Args:
+        knowledge_base_id: Knowledge Base ID.
+        region_name: The aws region e.g., `us-west-2`.
+            Fallback to AWS_DEFAULT_REGION env variable or region specified in
+            ~/.aws/config.
+        credentials_profile_name: The name of the profile in the ~/.aws/credentials
+            or ~/.aws/config files, which has either access keys or role information
+            specified. If not specified, the default credential profile or, if on an
+            EC2 instance, credentials from IMDS will be used.
+        client: boto3 client for bedrock agent runtime.
+        retrieval_config: Configuration for retrieval.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.retrievers import AmazonKnowledgeBasesRetriever
+
+            retriever = AmazonKnowledgeBasesRetriever(
+                knowledge_base_id="<knowledge-base-id>",
+                retrieval_config={
+                    "vectorSearchConfiguration": {
+                        "numberOfResults": 4
+                    }
+                },
+            )
+    """
+
+    knowledge_base_id: str
+    region_name: Optional[str] = None
+    credentials_profile_name: Optional[str] = None
+    endpoint_url: Optional[str] = None
+    client: Any
+    retrieval_config: RetrievalConfig
+
+    @root_validator(pre=True)
+    def create_client(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        if values.get("client") is not None:
+            return values
+
+        try:
+            import boto3
+            from botocore.client import Config
+            from botocore.exceptions import UnknownServiceError
+
+            if values.get("credentials_profile_name"):
+                session = boto3.Session(profile_name=values["credentials_profile_name"])
+            else:
+                # use default credentials
+                session = boto3.Session()
+
+            client_params = {
+                "config": Config(
+                    connect_timeout=120, read_timeout=120, retries={"max_attempts": 0}
+                )
+            }
+            if values.get("region_name"):
+                client_params["region_name"] = values["region_name"]
+
+            if values.get("endpoint_url"):
+                client_params["endpoint_url"] = values["endpoint_url"]
+
+            values["client"] = session.client("bedrock-agent-runtime", **client_params)
+
+            return values
+        except ImportError:
+            raise ModuleNotFoundError(
+                "Could not import boto3 python package. "
+                "Please install it with `pip install boto3`."
+            )
+        except UnknownServiceError as e:
+            raise ModuleNotFoundError(
+                "Ensure that you have installed the latest boto3 package "
+                "that contains the API for `bedrock-runtime-agent`."
+            ) from e
+        except Exception as e:
+            raise ValueError(
+                "Could not load credentials to authenticate with AWS client. "
+                "Please check that credentials in the specified "
+                "profile name are valid."
+            ) from e
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        response = self.client.retrieve(
+            retrievalQuery={"text": query.strip()},
+            knowledgeBaseId=self.knowledge_base_id,
+            retrievalConfiguration=self.retrieval_config.dict(),
+        )
+        results = response["retrievalResults"]
+        documents = []
+        for result in results:
+            documents.append(
+                Document(
+                    page_content=result["content"]["text"],
+                    metadata={
+                        "location": result["location"],
+                        "score": result["score"] if "score" in result else 0,
+                    },
+                )
+            )
+
+        return documents
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/bm25.py b/llm/Lib/site-packages/langchain_community/retrievers/bm25.py
new file mode 100644
index 0000000000000000000000000000000000000000..0ebaa2c0cd2858e81b317c1588a1f4d5762747ed
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/bm25.py
@@ -0,0 +1,104 @@
+from __future__ import annotations
+
+from typing import Any, Callable, Dict, Iterable, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Field
+from langchain_core.retrievers import BaseRetriever
+
+
+def default_preprocessing_func(text: str) -> List[str]:
+    return text.split()
+
+
+class BM25Retriever(BaseRetriever):
+    """`BM25` retriever without Elasticsearch."""
+
+    vectorizer: Any
+    """ BM25 vectorizer."""
+    docs: List[Document] = Field(repr=False)
+    """ List of documents."""
+    k: int = 4
+    """ Number of documents to return."""
+    preprocess_func: Callable[[str], List[str]] = default_preprocessing_func
+    """ Preprocessing function to use on the text before BM25 vectorization."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: Iterable[str],
+        metadatas: Optional[Iterable[dict]] = None,
+        bm25_params: Optional[Dict[str, Any]] = None,
+        preprocess_func: Callable[[str], List[str]] = default_preprocessing_func,
+        **kwargs: Any,
+    ) -> BM25Retriever:
+        """
+        Create a BM25Retriever from a list of texts.
+        Args:
+            texts: A list of texts to vectorize.
+            metadatas: A list of metadata dicts to associate with each text.
+            bm25_params: Parameters to pass to the BM25 vectorizer.
+            preprocess_func: A function to preprocess each text before vectorization.
+            **kwargs: Any other arguments to pass to the retriever.
+
+        Returns:
+            A BM25Retriever instance.
+        """
+        try:
+            from rank_bm25 import BM25Okapi
+        except ImportError:
+            raise ImportError(
+                "Could not import rank_bm25, please install with `pip install "
+                "rank_bm25`."
+            )
+
+        texts_processed = [preprocess_func(t) for t in texts]
+        bm25_params = bm25_params or {}
+        vectorizer = BM25Okapi(texts_processed, **bm25_params)
+        metadatas = metadatas or ({} for _ in texts)
+        docs = [Document(page_content=t, metadata=m) for t, m in zip(texts, metadatas)]
+        return cls(
+            vectorizer=vectorizer, docs=docs, preprocess_func=preprocess_func, **kwargs
+        )
+
+    @classmethod
+    def from_documents(
+        cls,
+        documents: Iterable[Document],
+        *,
+        bm25_params: Optional[Dict[str, Any]] = None,
+        preprocess_func: Callable[[str], List[str]] = default_preprocessing_func,
+        **kwargs: Any,
+    ) -> BM25Retriever:
+        """
+        Create a BM25Retriever from a list of Documents.
+        Args:
+            documents: A list of Documents to vectorize.
+            bm25_params: Parameters to pass to the BM25 vectorizer.
+            preprocess_func: A function to preprocess each text before vectorization.
+            **kwargs: Any other arguments to pass to the retriever.
+
+        Returns:
+            A BM25Retriever instance.
+        """
+        texts, metadatas = zip(*((d.page_content, d.metadata) for d in documents))
+        return cls.from_texts(
+            texts=texts,
+            bm25_params=bm25_params,
+            metadatas=metadatas,
+            preprocess_func=preprocess_func,
+            **kwargs,
+        )
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        processed_query = self.preprocess_func(query)
+        return_docs = self.vectorizer.get_top_n(processed_query, self.docs, n=self.k)
+        return return_docs
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/breebs.py b/llm/Lib/site-packages/langchain_community/retrievers/breebs.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed42fc8fd43c732c09eff9dd394f43829ab60cb8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/breebs.py
@@ -0,0 +1,49 @@
+from typing import List
+
+import requests
+from langchain_core.callbacks.manager import CallbackManagerForRetrieverRun
+from langchain_core.documents.base import Document
+from langchain_core.retrievers import BaseRetriever
+
+
+class BreebsRetriever(BaseRetriever):
+    """A retriever class for `Breebs`.
+
+    See https://www.breebs.com/ for more info.
+    Args:
+        breeb_key: The key to trigger the breeb
+        (specialized knowledge pill on a specific topic).
+
+    To retrieve the list of all available Breebs : you can call https://breebs.promptbreeders.com/web/listbreebs
+    """
+
+    breeb_key: str
+    url = "https://breebs.promptbreeders.com/knowledge"
+
+    def __init__(self, breeb_key: str):
+        super().__init__(breeb_key=breeb_key)
+        self.breeb_key = breeb_key
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Retrieve context for given query.
+        Note that for time being there is no score."""
+        r = requests.post(
+            self.url,
+            json={
+                "breeb_key": self.breeb_key,
+                "query": query,
+            },
+        )
+        if r.status_code != 200:
+            return []
+        else:
+            chunks = r.json()
+            return [
+                Document(
+                    page_content=chunk["content"],
+                    metadata={"source": chunk["source_url"], "score": 1},
+                )
+                for chunk in chunks
+            ]
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/chaindesk.py b/llm/Lib/site-packages/langchain_community/retrievers/chaindesk.py
new file mode 100644
index 0000000000000000000000000000000000000000..4c8aa2c582be51e285d31b491b5c94957f7fd0c5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/chaindesk.py
@@ -0,0 +1,92 @@
+from typing import Any, List, Optional
+
+import aiohttp
+import requests
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+
+class ChaindeskRetriever(BaseRetriever):
+    """`Chaindesk API` retriever."""
+
+    datastore_url: str
+    top_k: Optional[int]
+    api_key: Optional[str]
+
+    def __init__(
+        self,
+        datastore_url: str,
+        top_k: Optional[int] = None,
+        api_key: Optional[str] = None,
+    ):
+        self.datastore_url = datastore_url
+        self.api_key = api_key
+        self.top_k = top_k
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+        **kwargs: Any,
+    ) -> List[Document]:
+        response = requests.post(
+            self.datastore_url,
+            json={
+                "query": query,
+                **({"topK": self.top_k} if self.top_k is not None else {}),
+            },
+            headers={
+                "Content-Type": "application/json",
+                **(
+                    {"Authorization": f"Bearer {self.api_key}"}
+                    if self.api_key is not None
+                    else {}
+                ),
+            },
+        )
+        data = response.json()
+        return [
+            Document(
+                page_content=r["text"],
+                metadata={"source": r["source"], "score": r["score"]},
+            )
+            for r in data["results"]
+        ]
+
+    async def _aget_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: AsyncCallbackManagerForRetrieverRun,
+        **kwargs: Any,
+    ) -> List[Document]:
+        async with aiohttp.ClientSession() as session:
+            async with session.request(
+                "POST",
+                self.datastore_url,
+                json={
+                    "query": query,
+                    **({"topK": self.top_k} if self.top_k is not None else {}),
+                },
+                headers={
+                    "Content-Type": "application/json",
+                    **(
+                        {"Authorization": f"Bearer {self.api_key}"}
+                        if self.api_key is not None
+                        else {}
+                    ),
+                },
+            ) as response:
+                data = await response.json()
+        return [
+            Document(
+                page_content=r["text"],
+                metadata={"source": r["source"], "score": r["score"]},
+            )
+            for r in data["results"]
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/chatgpt_plugin_retriever.py b/llm/Lib/site-packages/langchain_community/retrievers/chatgpt_plugin_retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..13591336fc489089883bdb1bd794d38f8fd06354
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/chatgpt_plugin_retriever.py
@@ -0,0 +1,90 @@
+from __future__ import annotations
+
+from typing import List, Optional
+
+import aiohttp
+import requests
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+
+class ChatGPTPluginRetriever(BaseRetriever):
+    """`ChatGPT plugin` retriever."""
+
+    url: str
+    """URL of the ChatGPT plugin."""
+    bearer_token: str
+    """Bearer token for the ChatGPT plugin."""
+    top_k: int = 3
+    """Number of documents to return."""
+    filter: Optional[dict] = None
+    """Filter to apply to the results."""
+    aiosession: Optional[aiohttp.ClientSession] = None
+    """Aiohttp session to use for requests."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+        """Allow arbitrary types."""
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        url, json, headers = self._create_request(query)
+        response = requests.post(url, json=json, headers=headers)
+        results = response.json()["results"][0]["results"]
+        docs = []
+        for d in results:
+            content = d.pop("text")
+            metadata = d.pop("metadata", d)
+            if metadata.get("source_id"):
+                metadata["source"] = metadata.pop("source_id")
+            docs.append(Document(page_content=content, metadata=metadata))
+        return docs
+
+    async def _aget_relevant_documents(
+        self, query: str, *, run_manager: AsyncCallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        url, json, headers = self._create_request(query)
+
+        if not self.aiosession:
+            async with aiohttp.ClientSession() as session:
+                async with session.post(url, headers=headers, json=json) as response:
+                    res = await response.json()
+        else:
+            async with self.aiosession.post(
+                url, headers=headers, json=json
+            ) as response:
+                res = await response.json()
+
+        results = res["results"][0]["results"]
+        docs = []
+        for d in results:
+            content = d.pop("text")
+            metadata = d.pop("metadata", d)
+            if metadata.get("source_id"):
+                metadata["source"] = metadata.pop("source_id")
+            docs.append(Document(page_content=content, metadata=metadata))
+        return docs
+
+    def _create_request(self, query: str) -> tuple[str, dict, dict]:
+        url = f"{self.url}/query"
+        json = {
+            "queries": [
+                {
+                    "query": query,
+                    "filter": self.filter,
+                    "top_k": self.top_k,
+                }
+            ]
+        }
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": f"Bearer {self.bearer_token}",
+        }
+        return url, json, headers
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/cohere_rag_retriever.py b/llm/Lib/site-packages/langchain_community/retrievers/cohere_rag_retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..f0e29a7fc3a956526e8f2eb9427f066fc34f02e9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/cohere_rag_retriever.py
@@ -0,0 +1,98 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, List
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import HumanMessage
+from langchain_core.pydantic_v1 import Field
+from langchain_core.retrievers import BaseRetriever
+
+if TYPE_CHECKING:
+    from langchain_core.messages import BaseMessage
+
+
+def _get_docs(response: Any) -> List[Document]:
+    docs = (
+        []
+        if "documents" not in response.generation_info
+        else [
+            Document(page_content=doc["snippet"], metadata=doc)
+            for doc in response.generation_info["documents"]
+        ]
+    )
+    docs.append(
+        Document(
+            page_content=response.message.content,
+            metadata={
+                "type": "model_response",
+                "citations": response.generation_info["citations"],
+                "search_results": response.generation_info["search_results"],
+                "search_queries": response.generation_info["search_queries"],
+                "token_count": response.generation_info["token_count"],
+            },
+        )
+    )
+    return docs
+
+
+@deprecated(
+    since="0.0.30",
+    removal="0.2.0",
+    alternative_import="langchain_cohere.CohereRagRetriever",
+)
+class CohereRagRetriever(BaseRetriever):
+    """Cohere Chat API with RAG."""
+
+    connectors: List[Dict] = Field(default_factory=lambda: [{"id": "web-search"}])
+    """
+    When specified, the model's reply will be enriched with information found by
+    querying each of the connectors (RAG). These will be returned as langchain
+    documents.
+
+    Currently only accepts {"id": "web-search"}.
+    """
+
+    llm: BaseChatModel
+    """Cohere ChatModel to use."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+        """Allow arbitrary types."""
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun, **kwargs: Any
+    ) -> List[Document]:
+        messages: List[List[BaseMessage]] = [[HumanMessage(content=query)]]
+        res = self.llm.generate(
+            messages,
+            connectors=self.connectors,
+            callbacks=run_manager.get_child(),
+            **kwargs,
+        ).generations[0][0]
+        return _get_docs(res)
+
+    async def _aget_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: AsyncCallbackManagerForRetrieverRun,
+        **kwargs: Any,
+    ) -> List[Document]:
+        messages: List[List[BaseMessage]] = [[HumanMessage(content=query)]]
+        res = (
+            await self.llm.agenerate(
+                messages,
+                connectors=self.connectors,
+                callbacks=run_manager.get_child(),
+                **kwargs,
+            )
+        ).generations[0][0]
+        return _get_docs(res)
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/databerry.py b/llm/Lib/site-packages/langchain_community/retrievers/databerry.py
new file mode 100644
index 0000000000000000000000000000000000000000..c1ea627700427004d0765b38e0cfb23dcc3664a9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/databerry.py
@@ -0,0 +1,74 @@
+from typing import List, Optional
+
+import aiohttp
+import requests
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+
+class DataberryRetriever(BaseRetriever):
+    """`Databerry API` retriever."""
+
+    datastore_url: str
+    top_k: Optional[int]
+    api_key: Optional[str]
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        response = requests.post(
+            self.datastore_url,
+            json={
+                "query": query,
+                **({"topK": self.top_k} if self.top_k is not None else {}),
+            },
+            headers={
+                "Content-Type": "application/json",
+                **(
+                    {"Authorization": f"Bearer {self.api_key}"}
+                    if self.api_key is not None
+                    else {}
+                ),
+            },
+        )
+        data = response.json()
+        return [
+            Document(
+                page_content=r["text"],
+                metadata={"source": r["source"], "score": r["score"]},
+            )
+            for r in data["results"]
+        ]
+
+    async def _aget_relevant_documents(
+        self, query: str, *, run_manager: AsyncCallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        async with aiohttp.ClientSession() as session:
+            async with session.request(
+                "POST",
+                self.datastore_url,
+                json={
+                    "query": query,
+                    **({"topK": self.top_k} if self.top_k is not None else {}),
+                },
+                headers={
+                    "Content-Type": "application/json",
+                    **(
+                        {"Authorization": f"Bearer {self.api_key}"}
+                        if self.api_key is not None
+                        else {}
+                    ),
+                },
+            ) as response:
+                data = await response.json()
+        return [
+            Document(
+                page_content=r["text"],
+                metadata={"source": r["source"], "score": r["score"]},
+            )
+            for r in data["results"]
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/docarray.py b/llm/Lib/site-packages/langchain_community/retrievers/docarray.py
new file mode 100644
index 0000000000000000000000000000000000000000..bb3db872073463415f4b642e5d264f4b1c8ff43b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/docarray.py
@@ -0,0 +1,207 @@
+from enum import Enum
+from typing import Any, Dict, List, Optional, Union
+
+import numpy as np
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.retrievers import BaseRetriever
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+
+class SearchType(str, Enum):
+    """Enumerator of the types of search to perform."""
+
+    similarity = "similarity"
+    mmr = "mmr"
+
+
+class DocArrayRetriever(BaseRetriever):
+    """`DocArray Document Indices` retriever.
+
+    Currently, it supports 5 backends:
+    InMemoryExactNNIndex, HnswDocumentIndex, QdrantDocumentIndex,
+    ElasticDocIndex, and WeaviateDocumentIndex.
+
+    Args:
+        index: One of the above-mentioned index instances
+        embeddings: Embedding model to represent text as vectors
+        search_field: Field to consider for searching in the documents.
+            Should be an embedding/vector/tensor.
+        content_field: Field that represents the main content in your document schema.
+            Will be used as a `page_content`. Everything else will go into `metadata`.
+        search_type: Type of search to perform (similarity / mmr)
+        filters: Filters applied for document retrieval.
+        top_k: Number of documents to return
+    """
+
+    index: Any
+    embeddings: Embeddings
+    search_field: str
+    content_field: str
+    search_type: SearchType = SearchType.similarity
+    top_k: int = 1
+    filters: Optional[Any] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+    ) -> List[Document]:
+        """Get documents relevant for a query.
+
+        Args:
+            query: string to find relevant documents for
+
+        Returns:
+            List of relevant documents
+        """
+        query_emb = np.array(self.embeddings.embed_query(query))
+
+        if self.search_type == SearchType.similarity:
+            results = self._similarity_search(query_emb)
+        elif self.search_type == SearchType.mmr:
+            results = self._mmr_search(query_emb)
+        else:
+            raise ValueError(
+                f"Search type {self.search_type} does not exist. "
+                f"Choose either 'similarity' or 'mmr'."
+            )
+
+        return results
+
+    def _search(
+        self, query_emb: np.ndarray, top_k: int
+    ) -> List[Union[Dict[str, Any], Any]]:
+        """
+        Perform a search using the query embedding and return top_k documents.
+
+        Args:
+            query_emb: Query represented as an embedding
+            top_k: Number of documents to return
+
+        Returns:
+            A list of top_k documents matching the query
+        """
+
+        from docarray.index import ElasticDocIndex, WeaviateDocumentIndex
+
+        filter_args = {}
+        search_field = self.search_field
+        if isinstance(self.index, WeaviateDocumentIndex):
+            filter_args["where_filter"] = self.filters
+            search_field = ""
+        elif isinstance(self.index, ElasticDocIndex):
+            filter_args["query"] = self.filters
+        else:
+            filter_args["filter_query"] = self.filters
+
+        if self.filters:
+            query = (
+                self.index.build_query()  # get empty query object
+                .find(
+                    query=query_emb, search_field=search_field
+                )  # add vector similarity search
+                .filter(**filter_args)  # add filter search
+                .build(limit=top_k)  # build the query
+            )
+            # execute the combined query and return the results
+            docs = self.index.execute_query(query)
+            if hasattr(docs, "documents"):
+                docs = docs.documents
+            docs = docs[:top_k]
+        else:
+            docs = self.index.find(
+                query=query_emb, search_field=search_field, limit=top_k
+            ).documents
+        return docs
+
+    def _similarity_search(self, query_emb: np.ndarray) -> List[Document]:
+        """
+        Perform a similarity search.
+
+        Args:
+            query_emb: Query represented as an embedding
+
+        Returns:
+            A list of documents most similar to the query
+        """
+        docs = self._search(query_emb=query_emb, top_k=self.top_k)
+        results = [self._docarray_to_langchain_doc(doc) for doc in docs]
+        return results
+
+    def _mmr_search(self, query_emb: np.ndarray) -> List[Document]:
+        """
+        Perform a maximal marginal relevance (mmr) search.
+
+        Args:
+            query_emb: Query represented as an embedding
+
+        Returns:
+            A list of diverse documents related to the query
+        """
+        docs = self._search(query_emb=query_emb, top_k=20)
+
+        mmr_selected = maximal_marginal_relevance(
+            query_emb,
+            [
+                doc[self.search_field]
+                if isinstance(doc, dict)
+                else getattr(doc, self.search_field)
+                for doc in docs
+            ],
+            k=self.top_k,
+        )
+        results = [self._docarray_to_langchain_doc(docs[idx]) for idx in mmr_selected]
+        return results
+
+    def _docarray_to_langchain_doc(self, doc: Union[Dict[str, Any], Any]) -> Document:
+        """
+        Convert a DocArray document (which also might be a dict)
+        to a langchain document format.
+
+        DocArray document can contain arbitrary fields, so the mapping is done
+        in the following way:
+
+        page_content <-> content_field
+        metadata <-> all other fields excluding
+            tensors and embeddings (so float, int, string)
+
+        Args:
+            doc: DocArray document
+
+        Returns:
+            Document in langchain format
+
+        Raises:
+            ValueError: If the document doesn't contain the content field
+        """
+
+        fields = doc.keys() if isinstance(doc, dict) else doc.__fields__
+
+        if self.content_field not in fields:
+            raise ValueError(
+                f"Document does not contain the content field - {self.content_field}."
+            )
+        lc_doc = Document(
+            page_content=doc[self.content_field]
+            if isinstance(doc, dict)
+            else getattr(doc, self.content_field)
+        )
+
+        for name in fields:
+            value = doc[name] if isinstance(doc, dict) else getattr(doc, name)
+            if (
+                isinstance(value, (str, int, float, bool))
+                and name != self.content_field
+            ):
+                lc_doc.metadata[name] = value
+
+        return lc_doc
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/dria_index.py b/llm/Lib/site-packages/langchain_community/retrievers/dria_index.py
new file mode 100644
index 0000000000000000000000000000000000000000..5da93a804e8dc053b0d450e9f81d7d47908b0462
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/dria_index.py
@@ -0,0 +1,87 @@
+"""Wrapper around Dria Retriever."""
+
+from typing import Any, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+from langchain_community.utilities import DriaAPIWrapper
+
+
+class DriaRetriever(BaseRetriever):
+    """`Dria` retriever using the DriaAPIWrapper."""
+
+    api_wrapper: DriaAPIWrapper
+
+    def __init__(self, api_key: str, contract_id: Optional[str] = None, **kwargs: Any):
+        """
+        Initialize the DriaRetriever with a DriaAPIWrapper instance.
+
+        Args:
+            api_key: The API key for Dria.
+            contract_id: The contract ID of the knowledge base to interact with.
+        """
+        api_wrapper = DriaAPIWrapper(api_key=api_key, contract_id=contract_id)
+        super().__init__(api_wrapper=api_wrapper, **kwargs)
+
+    def create_knowledge_base(
+        self,
+        name: str,
+        description: str,
+        category: str = "Unspecified",
+        embedding: str = "jina",
+    ) -> str:
+        """Create a new knowledge base in Dria.
+
+        Args:
+            name: The name of the knowledge base.
+            description: The description of the knowledge base.
+            category: The category of the knowledge base.
+            embedding: The embedding model to use for the knowledge base.
+
+
+        Returns:
+            The ID of the created knowledge base.
+        """
+        response = self.api_wrapper.create_knowledge_base(
+            name, description, category, embedding
+        )
+        return response
+
+    def add_texts(
+        self,
+        texts: List,
+    ) -> None:
+        """Add texts to the Dria knowledge base.
+
+        Args:
+            texts: An iterable of texts and metadatas to add to the knowledge base.
+
+        Returns:
+            List of IDs representing the added texts.
+        """
+        data = [{"text": text["text"], "metadata": text["metadata"]} for text in texts]
+        self.api_wrapper.insert_data(data)
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Retrieve relevant documents from Dria based on a query.
+
+        Args:
+            query: The query string to search for in the knowledge base.
+            run_manager: Callback manager for the retriever run.
+
+        Returns:
+            A list of Documents containing the search results.
+        """
+        results = self.api_wrapper.search(query)
+        docs = [
+            Document(
+                page_content=result["metadata"],
+                metadata={"id": result["id"], "score": result["score"]},
+            )
+            for result in results
+        ]
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/elastic_search_bm25.py b/llm/Lib/site-packages/langchain_community/retrievers/elastic_search_bm25.py
new file mode 100644
index 0000000000000000000000000000000000000000..a4f1f539d2879b1811ec001e14c837a5aff74597
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/elastic_search_bm25.py
@@ -0,0 +1,137 @@
+"""Wrapper around Elasticsearch vector database."""
+
+from __future__ import annotations
+
+import uuid
+from typing import Any, Iterable, List
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+
+class ElasticSearchBM25Retriever(BaseRetriever):
+    """`Elasticsearch` retriever that uses `BM25`.
+
+    To connect to an Elasticsearch instance that requires login credentials,
+    including Elastic Cloud, use the Elasticsearch URL format
+    https://username:password@es_host:9243. For example, to connect to Elastic
+    Cloud, create the Elasticsearch URL with the required authentication details and
+    pass it to the ElasticVectorSearch constructor as the named parameter
+    elasticsearch_url.
+
+    You can obtain your Elastic Cloud URL and login credentials by logging in to the
+    Elastic Cloud console at https://cloud.elastic.co, selecting your deployment, and
+    navigating to the "Deployments" page.
+
+    To obtain your Elastic Cloud password for the default "elastic" user:
+
+    1. Log in to the Elastic Cloud console at https://cloud.elastic.co
+    2. Go to "Security" > "Users"
+    3. Locate the "elastic" user and click "Edit"
+    4. Click "Reset password"
+    5. Follow the prompts to reset the password
+
+    The format for Elastic Cloud URLs is
+    https://username:password@cluster_id.region_id.gcp.cloud.es.io:9243.
+    """
+
+    client: Any
+    """Elasticsearch client."""
+    index_name: str
+    """Name of the index to use in Elasticsearch."""
+
+    @classmethod
+    def create(
+        cls, elasticsearch_url: str, index_name: str, k1: float = 2.0, b: float = 0.75
+    ) -> ElasticSearchBM25Retriever:
+        """
+        Create a ElasticSearchBM25Retriever from a list of texts.
+
+        Args:
+            elasticsearch_url: URL of the Elasticsearch instance to connect to.
+            index_name: Name of the index to use in Elasticsearch.
+            k1: BM25 parameter k1.
+            b: BM25 parameter b.
+
+        Returns:
+
+        """
+        from elasticsearch import Elasticsearch
+
+        # Create an Elasticsearch client instance
+        es = Elasticsearch(elasticsearch_url)
+
+        # Define the index settings and mappings
+        settings = {
+            "analysis": {"analyzer": {"default": {"type": "standard"}}},
+            "similarity": {
+                "custom_bm25": {
+                    "type": "BM25",
+                    "k1": k1,
+                    "b": b,
+                }
+            },
+        }
+        mappings = {
+            "properties": {
+                "content": {
+                    "type": "text",
+                    "similarity": "custom_bm25",  # Use the custom BM25 similarity
+                }
+            }
+        }
+
+        # Create the index with the specified settings and mappings
+        es.indices.create(index=index_name, mappings=mappings, settings=settings)
+        return cls(client=es, index_name=index_name)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        refresh_indices: bool = True,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the retriever.
+
+        Args:
+            texts: Iterable of strings to add to the retriever.
+            refresh_indices: bool to refresh ElasticSearch indices
+
+        Returns:
+            List of ids from adding the texts into the retriever.
+        """
+        try:
+            from elasticsearch.helpers import bulk
+        except ImportError:
+            raise ValueError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+        requests = []
+        ids = []
+        for i, text in enumerate(texts):
+            _id = str(uuid.uuid4())
+            request = {
+                "_op_type": "index",
+                "_index": self.index_name,
+                "content": text,
+                "_id": _id,
+            }
+            ids.append(_id)
+            requests.append(request)
+        bulk(self.client, requests)
+
+        if refresh_indices:
+            self.client.indices.refresh(index=self.index_name)
+        return ids
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        query_dict = {"query": {"match": {"content": query}}}
+        res = self.client.search(index=self.index_name, body=query_dict)
+
+        docs = []
+        for r in res["hits"]["hits"]:
+            docs.append(Document(page_content=r["_source"]["content"]))
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/embedchain.py b/llm/Lib/site-packages/langchain_community/retrievers/embedchain.py
new file mode 100644
index 0000000000000000000000000000000000000000..9c64f628e1ed6717dea82d710929505b1ab3b465
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/embedchain.py
@@ -0,0 +1,74 @@
+"""Wrapper around Embedchain Retriever."""
+
+from __future__ import annotations
+
+from typing import Any, Iterable, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+
+class EmbedchainRetriever(BaseRetriever):
+    """`Embedchain` retriever."""
+
+    client: Any
+    """Embedchain Pipeline."""
+
+    @classmethod
+    def create(cls, yaml_path: Optional[str] = None) -> EmbedchainRetriever:
+        """
+        Create a EmbedchainRetriever from a YAML configuration file.
+
+        Args:
+            yaml_path: Path to the YAML configuration file. If not provided,
+                       a default configuration is used.
+
+        Returns:
+            An instance of EmbedchainRetriever.
+
+        """
+        from embedchain import Pipeline
+
+        # Create an Embedchain Pipeline instance
+        if yaml_path:
+            client = Pipeline.from_config(yaml_path=yaml_path)
+        else:
+            client = Pipeline()
+        return cls(client=client)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the retriever.
+
+        Args:
+            texts: Iterable of strings/URLs to add to the retriever.
+
+        Returns:
+            List of ids from adding the texts into the retriever.
+        """
+        ids = []
+        for text in texts:
+            _id = self.client.add(text)
+            ids.append(_id)
+        return ids
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        res = self.client.search(query)
+
+        docs = []
+        for r in res:
+            docs.append(
+                Document(
+                    page_content=r["context"],
+                    metadata={
+                        "source": r["metadata"]["url"],
+                        "document_id": r["metadata"]["doc_id"],
+                    },
+                )
+            )
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/google_cloud_documentai_warehouse.py b/llm/Lib/site-packages/langchain_community/retrievers/google_cloud_documentai_warehouse.py
new file mode 100644
index 0000000000000000000000000000000000000000..0068da96c0e0dc575dcb6d5a2c50e9f164306887
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/google_cloud_documentai_warehouse.py
@@ -0,0 +1,127 @@
+"""Retriever wrapper for Google Cloud Document AI Warehouse."""
+
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.utilities.vertexai import get_client_info
+
+if TYPE_CHECKING:
+    from google.cloud.contentwarehouse_v1 import (
+        DocumentServiceClient,
+        RequestMetadata,
+        SearchDocumentsRequest,
+    )
+    from google.cloud.contentwarehouse_v1.services.document_service.pagers import (
+        SearchDocumentsPager,
+    )
+
+
+@deprecated(
+    since="0.0.32",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.DocumentAIWarehouseRetriever",
+)
+class GoogleDocumentAIWarehouseRetriever(BaseRetriever):
+    """A retriever based on Document AI Warehouse.
+
+    Documents should be created and documents should be uploaded
+        in a separate flow, and this retriever uses only Document AI
+        schema_id provided to search for revelant documents.
+
+    More info: https://cloud.google.com/document-ai-warehouse.
+    """
+
+    location: str = "us"
+    """Google Cloud location where Document AI Warehouse is placed."""
+    project_number: str
+    """Google Cloud project number, should contain digits only."""
+    schema_id: Optional[str] = None
+    """Document AI Warehouse schema to query against.
+    If nothing is provided, all documents in the project will be searched."""
+    qa_size_limit: int = 5
+    """The limit on the number of documents returned."""
+    client: "DocumentServiceClient" = None  #: :meta private:
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validates the environment."""
+        try:  # noqa: F401
+            from google.cloud.contentwarehouse_v1 import DocumentServiceClient
+        except ImportError as exc:
+            raise ImportError(
+                "google.cloud.contentwarehouse is not installed."
+                "Please install it with pip install google-cloud-contentwarehouse"
+            ) from exc
+
+        values["project_number"] = get_from_dict_or_env(
+            values, "project_number", "PROJECT_NUMBER"
+        )
+        values["client"] = DocumentServiceClient(
+            client_info=get_client_info(module="document-ai-warehouse")
+        )
+        return values
+
+    def _prepare_request_metadata(self, user_ldap: str) -> "RequestMetadata":
+        from google.cloud.contentwarehouse_v1 import RequestMetadata, UserInfo
+
+        user_info = UserInfo(id=f"user:{user_ldap}")
+        return RequestMetadata(user_info=user_info)
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun, **kwargs: Any
+    ) -> List[Document]:
+        request = self._prepare_search_request(query, **kwargs)
+        response = self.client.search_documents(request=request)
+        return self._parse_search_response(response=response)
+
+    def _prepare_search_request(
+        self, query: str, **kwargs: Any
+    ) -> "SearchDocumentsRequest":
+        from google.cloud.contentwarehouse_v1 import (
+            DocumentQuery,
+            SearchDocumentsRequest,
+        )
+
+        try:
+            user_ldap = kwargs["user_ldap"]
+        except KeyError:
+            raise ValueError("Argument user_ldap should be provided!")
+
+        request_metadata = self._prepare_request_metadata(user_ldap=user_ldap)
+        schemas = []
+        if self.schema_id:
+            schemas.append(
+                self.client.document_schema_path(
+                    project=self.project_number,
+                    location=self.location,
+                    document_schema=self.schema_id,
+                )
+            )
+        return SearchDocumentsRequest(
+            parent=self.client.common_location_path(self.project_number, self.location),
+            request_metadata=request_metadata,
+            document_query=DocumentQuery(
+                query=query, is_nl_query=True, document_schema_names=schemas
+            ),
+            qa_size_limit=self.qa_size_limit,
+        )
+
+    def _parse_search_response(
+        self, response: "SearchDocumentsPager"
+    ) -> List[Document]:
+        documents = []
+        for doc in response.matching_documents:
+            metadata = {
+                "title": doc.document.title,
+                "source": doc.document.raw_document_path,
+            }
+            documents.append(
+                Document(page_content=doc.search_text_snippet, metadata=metadata)
+            )
+        return documents
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/google_vertex_ai_search.py b/llm/Lib/site-packages/langchain_community/retrievers/google_vertex_ai_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..fc7b396dfd007012118d356bd2fac2f859b2b3b3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/google_vertex_ai_search.py
@@ -0,0 +1,495 @@
+"""Retriever wrapper for Google Vertex AI Search."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Sequence, Tuple
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.utilities.vertexai import get_client_info
+
+if TYPE_CHECKING:
+    from google.api_core.client_options import ClientOptions
+    from google.cloud.discoveryengine_v1beta import (
+        ConversationalSearchServiceClient,
+        SearchRequest,
+        SearchResult,
+        SearchServiceClient,
+    )
+
+
+class _BaseGoogleVertexAISearchRetriever(BaseModel):
+    project_id: str
+    """Google Cloud Project ID."""
+    data_store_id: Optional[str] = None
+    """Vertex AI Search data store ID."""
+    search_engine_id: Optional[str] = None
+    """Vertex AI Search app ID."""
+    location_id: str = "global"
+    """Vertex AI Search data store location."""
+    serving_config_id: str = "default_config"
+    """Vertex AI Search serving config ID."""
+    credentials: Any = None
+    """The default custom credentials (google.auth.credentials.Credentials) to use
+    when making API calls. If not provided, credentials will be ascertained from
+    the environment."""
+    engine_data_type: int = Field(default=0, ge=0, le=3)
+    """ Defines the Vertex AI Search app data type
+    0 - Unstructured data 
+    1 - Structured data
+    2 - Website data
+    3 - Blended search
+    """
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validates the environment."""
+        try:
+            from google.cloud import discoveryengine_v1beta  # noqa: F401
+        except ImportError as exc:
+            raise ImportError(
+                "google.cloud.discoveryengine is not installed."
+                "Please install it with pip install "
+                "google-cloud-discoveryengine>=0.11.10"
+            ) from exc
+        try:
+            from google.api_core.exceptions import InvalidArgument  # noqa: F401
+        except ImportError as exc:
+            raise ImportError(
+                "google.api_core.exceptions is not installed. "
+                "Please install it with pip install google-api-core"
+            ) from exc
+
+        values["project_id"] = get_from_dict_or_env(values, "project_id", "PROJECT_ID")
+
+        try:
+            values["data_store_id"] = get_from_dict_or_env(
+                values, "data_store_id", "DATA_STORE_ID"
+            )
+            values["search_engine_id"] = get_from_dict_or_env(
+                values, "search_engine_id", "SEARCH_ENGINE_ID"
+            )
+        except Exception:
+            pass
+
+        return values
+
+    @property
+    def client_options(self) -> "ClientOptions":
+        from google.api_core.client_options import ClientOptions
+
+        return ClientOptions(
+            api_endpoint=(
+                f"{self.location_id}-discoveryengine.googleapis.com"
+                if self.location_id != "global"
+                else None
+            )
+        )
+
+    def _convert_structured_search_response(
+        self, results: Sequence[SearchResult]
+    ) -> List[Document]:
+        """Converts a sequence of search results to a list of LangChain documents."""
+        import json
+
+        from google.protobuf.json_format import MessageToDict
+
+        documents: List[Document] = []
+
+        for result in results:
+            document_dict = MessageToDict(
+                result.document._pb, preserving_proto_field_name=True
+            )
+
+            documents.append(
+                Document(
+                    page_content=json.dumps(document_dict.get("struct_data", {})),
+                    metadata={"id": document_dict["id"], "name": document_dict["name"]},
+                )
+            )
+
+        return documents
+
+    def _convert_unstructured_search_response(
+        self, results: Sequence[SearchResult], chunk_type: str
+    ) -> List[Document]:
+        """Converts a sequence of search results to a list of LangChain documents."""
+        from google.protobuf.json_format import MessageToDict
+
+        documents: List[Document] = []
+
+        for result in results:
+            document_dict = MessageToDict(
+                result.document._pb, preserving_proto_field_name=True
+            )
+            derived_struct_data = document_dict.get("derived_struct_data")
+            if not derived_struct_data:
+                continue
+
+            doc_metadata = document_dict.get("struct_data", {})
+            doc_metadata["id"] = document_dict["id"]
+
+            if chunk_type not in derived_struct_data:
+                continue
+
+            for chunk in derived_struct_data[chunk_type]:
+                chunk_metadata = doc_metadata.copy()
+                chunk_metadata["source"] = derived_struct_data.get("link", "")
+
+                if chunk_type == "extractive_answers":
+                    chunk_metadata["source"] += f":{chunk.get('pageNumber', '')}"
+
+                documents.append(
+                    Document(
+                        page_content=chunk.get("content", ""), metadata=chunk_metadata
+                    )
+                )
+
+        return documents
+
+    def _convert_website_search_response(
+        self, results: Sequence[SearchResult], chunk_type: str
+    ) -> List[Document]:
+        """Converts a sequence of search results to a list of LangChain documents."""
+        from google.protobuf.json_format import MessageToDict
+
+        documents: List[Document] = []
+
+        for result in results:
+            document_dict = MessageToDict(
+                result.document._pb, preserving_proto_field_name=True
+            )
+            derived_struct_data = document_dict.get("derived_struct_data")
+            if not derived_struct_data:
+                continue
+
+            doc_metadata = document_dict.get("struct_data", {})
+            doc_metadata["id"] = document_dict["id"]
+            doc_metadata["source"] = derived_struct_data.get("link", "")
+
+            if chunk_type not in derived_struct_data:
+                continue
+
+            text_field = "snippet" if chunk_type == "snippets" else "content"
+
+            for chunk in derived_struct_data[chunk_type]:
+                documents.append(
+                    Document(
+                        page_content=chunk.get(text_field, ""), metadata=doc_metadata
+                    )
+                )
+
+        if not documents:
+            print(f"No {chunk_type} could be found.")  # noqa: T201
+            if chunk_type == "extractive_answers":
+                print(  # noqa: T201
+                    "Make sure that your data store is using Advanced Website "
+                    "Indexing.\n"
+                    "https://cloud.google.com/generative-ai-app-builder/docs/about-advanced-features#advanced-website-indexing"  # noqa: E501
+                )
+
+        return documents
+
+
+@deprecated(
+    since="0.0.33",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.VertexAISearchRetriever",
+)
+class GoogleVertexAISearchRetriever(BaseRetriever, _BaseGoogleVertexAISearchRetriever):
+    """`Google Vertex AI Search` retriever.
+
+    For a detailed explanation of the Vertex AI Search concepts
+    and configuration parameters, refer to the product documentation.
+    https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction
+    """
+
+    filter: Optional[str] = None
+    """Filter expression."""
+    get_extractive_answers: bool = False
+    """If True return Extractive Answers, otherwise return Extractive Segments or Snippets."""  # noqa: E501
+    max_documents: int = Field(default=5, ge=1, le=100)
+    """The maximum number of documents to return."""
+    max_extractive_answer_count: int = Field(default=1, ge=1, le=5)
+    """The maximum number of extractive answers returned in each search result.
+    At most 5 answers will be returned for each SearchResult.
+    """
+    max_extractive_segment_count: int = Field(default=1, ge=1, le=1)
+    """The maximum number of extractive segments returned in each search result.
+    Currently one segment will be returned for each SearchResult.
+    """
+    query_expansion_condition: int = Field(default=1, ge=0, le=2)
+    """Specification to determine under which conditions query expansion should occur.
+    0 - Unspecified query expansion condition. In this case, server behavior defaults 
+        to disabled
+    1 - Disabled query expansion. Only the exact search query is used, even if 
+        SearchResponse.total_size is zero.
+    2 - Automatic query expansion built by the Search API.
+    """
+    spell_correction_mode: int = Field(default=2, ge=0, le=2)
+    """Specification to determine under which conditions query expansion should occur.
+    0 - Unspecified spell correction mode. In this case, server behavior defaults 
+        to auto.
+    1 - Suggestion only. Search API will try to find a spell suggestion if there is any
+        and put in the `SearchResponse.corrected_query`.
+        The spell suggestion will not be used as the search query.
+    2 - Automatic spell correction built by the Search API.
+        Search will be based on the corrected query if found.
+    """
+
+    _client: SearchServiceClient
+    _serving_config: str
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.ignore
+        arbitrary_types_allowed = True
+        underscore_attrs_are_private = True
+
+    def __init__(self, **kwargs: Any) -> None:
+        """Initializes private fields."""
+        try:
+            from google.cloud.discoveryengine_v1beta import SearchServiceClient
+        except ImportError as exc:
+            raise ImportError(
+                "google.cloud.discoveryengine is not installed."
+                "Please install it with pip install google-cloud-discoveryengine"
+            ) from exc
+
+        super().__init__(**kwargs)
+
+        #  For more information, refer to:
+        # https://cloud.google.com/generative-ai-app-builder/docs/locations#specify_a_multi-region_for_your_data_store
+        self._client = SearchServiceClient(
+            credentials=self.credentials,
+            client_options=self.client_options,
+            client_info=get_client_info(module="vertex-ai-search"),
+        )
+
+        if self.engine_data_type == 3 and not self.search_engine_id:
+            raise ValueError(
+                "search_engine_id must be specified for blended search apps."
+            )
+
+        if self.search_engine_id:
+            self._serving_config = f"projects/{self.project_id}/locations/{self.location_id}/collections/default_collection/engines/{self.search_engine_id}/servingConfigs/default_config"  # noqa: E501
+        elif self.data_store_id:
+            self._serving_config = self._client.serving_config_path(
+                project=self.project_id,
+                location=self.location_id,
+                data_store=self.data_store_id,
+                serving_config=self.serving_config_id,
+            )
+        else:
+            raise ValueError(
+                "Either data_store_id or search_engine_id must be specified."
+            )
+
+    def _create_search_request(self, query: str) -> SearchRequest:
+        """Prepares a SearchRequest object."""
+        from google.cloud.discoveryengine_v1beta import SearchRequest
+
+        query_expansion_spec = SearchRequest.QueryExpansionSpec(
+            condition=self.query_expansion_condition,
+        )
+
+        spell_correction_spec = SearchRequest.SpellCorrectionSpec(
+            mode=self.spell_correction_mode
+        )
+
+        if self.engine_data_type == 0:
+            if self.get_extractive_answers:
+                extractive_content_spec = (
+                    SearchRequest.ContentSearchSpec.ExtractiveContentSpec(
+                        max_extractive_answer_count=self.max_extractive_answer_count,
+                    )
+                )
+            else:
+                extractive_content_spec = (
+                    SearchRequest.ContentSearchSpec.ExtractiveContentSpec(
+                        max_extractive_segment_count=self.max_extractive_segment_count,
+                    )
+                )
+            content_search_spec = SearchRequest.ContentSearchSpec(
+                extractive_content_spec=extractive_content_spec
+            )
+        elif self.engine_data_type == 1:
+            content_search_spec = None
+        elif self.engine_data_type in (2, 3):
+            content_search_spec = SearchRequest.ContentSearchSpec(
+                extractive_content_spec=SearchRequest.ContentSearchSpec.ExtractiveContentSpec(
+                    max_extractive_answer_count=self.max_extractive_answer_count,
+                ),
+                snippet_spec=SearchRequest.ContentSearchSpec.SnippetSpec(
+                    return_snippet=True
+                ),
+            )
+        else:
+            raise NotImplementedError(
+                "Only data store type 0 (Unstructured), 1 (Structured),"
+                "2 (Website), or 3 (Blended) are supported currently."
+                + f" Got {self.engine_data_type}"
+            )
+
+        return SearchRequest(
+            query=query,
+            filter=self.filter,
+            serving_config=self._serving_config,
+            page_size=self.max_documents,
+            content_search_spec=content_search_spec,
+            query_expansion_spec=query_expansion_spec,
+            spell_correction_spec=spell_correction_spec,
+        )
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Get documents relevant for a query."""
+        return self.get_relevant_documents_with_response(query)[0]
+
+    def get_relevant_documents_with_response(
+        self, query: str
+    ) -> Tuple[List[Document], Any]:
+        from google.api_core.exceptions import InvalidArgument
+
+        search_request = self._create_search_request(query)
+
+        try:
+            response = self._client.search(search_request)
+        except InvalidArgument as exc:
+            raise type(exc)(
+                exc.message
+                + " This might be due to engine_data_type not set correctly."
+            )
+
+        if self.engine_data_type == 0:
+            chunk_type = (
+                "extractive_answers"
+                if self.get_extractive_answers
+                else "extractive_segments"
+            )
+            documents = self._convert_unstructured_search_response(
+                response.results, chunk_type
+            )
+        elif self.engine_data_type == 1:
+            documents = self._convert_structured_search_response(response.results)
+        elif self.engine_data_type in (2, 3):
+            chunk_type = (
+                "extractive_answers" if self.get_extractive_answers else "snippets"
+            )
+            documents = self._convert_website_search_response(
+                response.results, chunk_type
+            )
+        else:
+            raise NotImplementedError(
+                "Only data store type 0 (Unstructured), 1 (Structured),"
+                "2 (Website), or 3 (Blended) are supported currently."
+                + f" Got {self.engine_data_type}"
+            )
+
+        return documents, response
+
+
+@deprecated(
+    since="0.0.33",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.VertexAIMultiTurnSearchRetriever",
+)
+class GoogleVertexAIMultiTurnSearchRetriever(
+    BaseRetriever, _BaseGoogleVertexAISearchRetriever
+):
+    """`Google Vertex AI Search` retriever for multi-turn conversations."""
+
+    conversation_id: str = "-"
+    """Vertex AI Search Conversation ID."""
+
+    _client: ConversationalSearchServiceClient
+    _serving_config: str
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.ignore
+        arbitrary_types_allowed = True
+        underscore_attrs_are_private = True
+
+    def __init__(self, **kwargs: Any):
+        super().__init__(**kwargs)
+        from google.cloud.discoveryengine_v1beta import (
+            ConversationalSearchServiceClient,
+        )
+
+        self._client = ConversationalSearchServiceClient(
+            credentials=self.credentials,
+            client_options=self.client_options,
+            client_info=get_client_info(module="vertex-ai-search"),
+        )
+
+        if not self.data_store_id:
+            raise ValueError("data_store_id is required for MultiTurnSearchRetriever.")
+
+        self._serving_config = self._client.serving_config_path(
+            project=self.project_id,
+            location=self.location_id,
+            data_store=self.data_store_id,
+            serving_config=self.serving_config_id,
+        )
+
+        if self.engine_data_type == 1 or self.engine_data_type == 3:
+            raise NotImplementedError(
+                "Data store type 1 (Structured) and 3 (Blended)"
+                "is not currently supported for multi-turn search."
+                + f" Got {self.engine_data_type}"
+            )
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Get documents relevant for a query."""
+        from google.cloud.discoveryengine_v1beta import (
+            ConverseConversationRequest,
+            TextInput,
+        )
+
+        request = ConverseConversationRequest(
+            name=self._client.conversation_path(
+                self.project_id,
+                self.location_id,
+                self.data_store_id,
+                self.conversation_id,
+            ),
+            serving_config=self._serving_config,
+            query=TextInput(input=query),
+        )
+        response = self._client.converse_conversation(request)
+
+        if self.engine_data_type == 2:
+            return self._convert_website_search_response(
+                response.search_results, "extractive_answers"
+            )
+
+        return self._convert_unstructured_search_response(
+            response.search_results, "extractive_answers"
+        )
+
+
+class GoogleCloudEnterpriseSearchRetriever(GoogleVertexAISearchRetriever):
+    """`Google Vertex Search API` retriever alias for backwards compatibility.
+    DEPRECATED: Use `GoogleVertexAISearchRetriever` instead.
+    """
+
+    def __init__(self, **data: Any):
+        import warnings
+
+        warnings.warn(
+            "GoogleCloudEnterpriseSearchRetriever is deprecated, use GoogleVertexAISearchRetriever",  # noqa: E501
+            DeprecationWarning,
+        )
+
+        super().__init__(**data)
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/kay.py b/llm/Lib/site-packages/langchain_community/retrievers/kay.py
new file mode 100644
index 0000000000000000000000000000000000000000..ef594157b1b4a669616144c6d5cc5c74d3a6e648
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/kay.py
@@ -0,0 +1,60 @@
+from __future__ import annotations
+
+from typing import Any, List
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+
+class KayAiRetriever(BaseRetriever):
+    """
+    Retriever for Kay.ai datasets.
+
+    To work properly, expects you to have KAY_API_KEY env variable set.
+    You can get one for free at https://kay.ai/.
+    """
+
+    client: Any
+    num_contexts: int
+
+    @classmethod
+    def create(
+        cls,
+        dataset_id: str,
+        data_types: List[str],
+        num_contexts: int = 6,
+    ) -> KayAiRetriever:
+        """
+        Create a KayRetriever given a Kay dataset id and a list of datasources.
+
+        Args:
+            dataset_id: A dataset id category in Kay, like "company"
+            data_types: A list of datasources present within a dataset. For
+                "company" the corresponding datasources could be
+                ["10-K", "10-Q", "8-K", "PressRelease"].
+            num_contexts: The number of documents to retrieve on each query.
+                Defaults to 6.
+        """
+        try:
+            from kay.rag.retrievers import KayRetriever
+        except ImportError:
+            raise ImportError(
+                "Could not import kay python package. Please install it with "
+                "`pip install kay`.",
+            )
+
+        client = KayRetriever(dataset_id, data_types)
+        return cls(client=client, num_contexts=num_contexts)
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        ctxs = self.client.query(query=query, num_context=self.num_contexts)
+        docs = []
+        for ctx in ctxs:
+            page_content = ctx.pop("chunk_embed_text", None)
+            if page_content is None:
+                continue
+            docs.append(Document(page_content=page_content, metadata={**ctx}))
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/kendra.py b/llm/Lib/site-packages/langchain_community/retrievers/kendra.py
new file mode 100644
index 0000000000000000000000000000000000000000..b4480cae62c7ced34a8d7a32fbb4a786db1c2a52
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/kendra.py
@@ -0,0 +1,479 @@
+import re
+from abc import ABC, abstractmethod
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    Sequence,
+    Union,
+)
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import (
+    BaseModel,
+    Extra,
+    Field,
+    root_validator,
+    validator,
+)
+from langchain_core.retrievers import BaseRetriever
+from typing_extensions import Annotated
+
+
+def clean_excerpt(excerpt: str) -> str:
+    """Clean an excerpt from Kendra.
+
+    Args:
+        excerpt: The excerpt to clean.
+
+    Returns:
+        The cleaned excerpt.
+
+    """
+    if not excerpt:
+        return excerpt
+    res = re.sub(r"\s+", " ", excerpt).replace("...", "")
+    return res
+
+
+def combined_text(item: "ResultItem") -> str:
+    """Combine a ResultItem title and excerpt into a single string.
+
+    Args:
+        item: the ResultItem of a Kendra search.
+
+    Returns:
+        A combined text of the title and excerpt of the given item.
+
+    """
+    text = ""
+    title = item.get_title()
+    if title:
+        text += f"Document Title: {title}\n"
+    excerpt = clean_excerpt(item.get_excerpt())
+    if excerpt:
+        text += f"Document Excerpt: \n{excerpt}\n"
+    return text
+
+
+DocumentAttributeValueType = Union[str, int, List[str], None]
+"""Possible types of a DocumentAttributeValue.
+
+Dates are also represented as str.
+"""
+
+
+# Unexpected keyword argument "extra" for "__init_subclass__" of "object"
+class Highlight(BaseModel, extra=Extra.allow):  # type: ignore[call-arg]
+    """Information that highlights the keywords in the excerpt."""
+
+    BeginOffset: int
+    """The zero-based location in the excerpt where the highlight starts."""
+    EndOffset: int
+    """The zero-based location in the excerpt where the highlight ends."""
+    TopAnswer: Optional[bool]
+    """Indicates whether the result is the best one."""
+    Type: Optional[str]
+    """The highlight type: STANDARD or THESAURUS_SYNONYM."""
+
+
+# Unexpected keyword argument "extra" for "__init_subclass__" of "object"
+class TextWithHighLights(BaseModel, extra=Extra.allow):  # type: ignore[call-arg]
+    """Text with highlights."""
+
+    Text: str
+    """The text."""
+    Highlights: Optional[Any]
+    """The highlights."""
+
+
+# Unexpected keyword argument "extra" for "__init_subclass__" of "object"
+class AdditionalResultAttributeValue(  # type: ignore[call-arg]
+    BaseModel, extra=Extra.allow
+):
+    """Value of an additional result attribute."""
+
+    TextWithHighlightsValue: TextWithHighLights
+    """The text with highlights value."""
+
+
+# Unexpected keyword argument "extra" for "__init_subclass__" of "object"
+class AdditionalResultAttribute(BaseModel, extra=Extra.allow):  # type: ignore[call-arg]
+    """Additional result attribute."""
+
+    Key: str
+    """The key of the attribute."""
+    ValueType: Literal["TEXT_WITH_HIGHLIGHTS_VALUE"]
+    """The type of the value."""
+    Value: AdditionalResultAttributeValue
+    """The value of the attribute."""
+
+    def get_value_text(self) -> str:
+        return self.Value.TextWithHighlightsValue.Text
+
+
+# Unexpected keyword argument "extra" for "__init_subclass__" of "object"
+class DocumentAttributeValue(BaseModel, extra=Extra.allow):  # type: ignore[call-arg]
+    """Value of a document attribute."""
+
+    DateValue: Optional[str]
+    """The date expressed as an ISO 8601 string."""
+    LongValue: Optional[int]
+    """The long value."""
+    StringListValue: Optional[List[str]]
+    """The string list value."""
+    StringValue: Optional[str]
+    """The string value."""
+
+    @property
+    def value(self) -> DocumentAttributeValueType:
+        """The only defined document attribute value or None.
+        According to Amazon Kendra, you can only provide one
+        value for a document attribute.
+        """
+        if self.DateValue:
+            return self.DateValue
+        if self.LongValue:
+            return self.LongValue
+        if self.StringListValue:
+            return self.StringListValue
+        if self.StringValue:
+            return self.StringValue
+
+        return None
+
+
+# Unexpected keyword argument "extra" for "__init_subclass__" of "object"
+class DocumentAttribute(BaseModel, extra=Extra.allow):  # type: ignore[call-arg]
+    """Document attribute."""
+
+    Key: str
+    """The key of the attribute."""
+    Value: DocumentAttributeValue
+    """The value of the attribute."""
+
+
+# Unexpected keyword argument "extra" for "__init_subclass__" of "object"
+class ResultItem(BaseModel, ABC, extra=Extra.allow):  # type: ignore[call-arg]
+    """Base class of a result item."""
+
+    Id: Optional[str]
+    """The ID of the relevant result item."""
+    DocumentId: Optional[str]
+    """The document ID."""
+    DocumentURI: Optional[str]
+    """The document URI."""
+    DocumentAttributes: Optional[List[DocumentAttribute]] = []
+    """The document attributes."""
+    ScoreAttributes: Optional[dict]
+    """The kendra score confidence"""
+
+    @abstractmethod
+    def get_title(self) -> str:
+        """Document title."""
+
+    @abstractmethod
+    def get_excerpt(self) -> str:
+        """Document excerpt or passage original content as retrieved by Kendra."""
+
+    def get_additional_metadata(self) -> dict:
+        """Document additional metadata dict.
+        This returns any extra metadata except these:
+            * result_id
+            * document_id
+            * source
+            * title
+            * excerpt
+            * document_attributes
+        """
+        return {}
+
+    def get_document_attributes_dict(self) -> Dict[str, DocumentAttributeValueType]:
+        """Document attributes dict."""
+        return {attr.Key: attr.Value.value for attr in (self.DocumentAttributes or [])}
+
+    def get_score_attribute(self) -> str:
+        """Document Score Confidence"""
+        if self.ScoreAttributes is not None:
+            return self.ScoreAttributes["ScoreConfidence"]
+        else:
+            return "NOT_AVAILABLE"
+
+    def to_doc(
+        self, page_content_formatter: Callable[["ResultItem"], str] = combined_text
+    ) -> Document:
+        """Converts this item to a Document."""
+        page_content = page_content_formatter(self)
+        metadata = self.get_additional_metadata()
+        metadata.update(
+            {
+                "result_id": self.Id,
+                "document_id": self.DocumentId,
+                "source": self.DocumentURI,
+                "title": self.get_title(),
+                "excerpt": self.get_excerpt(),
+                "document_attributes": self.get_document_attributes_dict(),
+                "score": self.get_score_attribute(),
+            }
+        )
+        return Document(page_content=page_content, metadata=metadata)
+
+
+class QueryResultItem(ResultItem):
+    """Query API result item."""
+
+    DocumentTitle: TextWithHighLights
+    """The document title."""
+    FeedbackToken: Optional[str]
+    """Identifies a particular result from a particular query."""
+    Format: Optional[str]
+    """
+    If the Type is ANSWER, then format is either:
+        * TABLE: a table excerpt is returned in TableExcerpt;
+        * TEXT: a text excerpt is returned in DocumentExcerpt.
+    """
+    Type: Optional[str]
+    """Type of result: DOCUMENT or QUESTION_ANSWER or ANSWER"""
+    AdditionalAttributes: Optional[List[AdditionalResultAttribute]] = []
+    """One or more additional attributes associated with the result."""
+    DocumentExcerpt: Optional[TextWithHighLights]
+    """Excerpt of the document text."""
+
+    def get_title(self) -> str:
+        return self.DocumentTitle.Text
+
+    def get_attribute_value(self) -> str:
+        if not self.AdditionalAttributes:
+            return ""
+        if not self.AdditionalAttributes[0]:
+            return ""
+        else:
+            return self.AdditionalAttributes[0].get_value_text()
+
+    def get_excerpt(self) -> str:
+        if (
+            self.AdditionalAttributes
+            and self.AdditionalAttributes[0].Key == "AnswerText"
+        ):
+            excerpt = self.get_attribute_value()
+        elif self.DocumentExcerpt:
+            excerpt = self.DocumentExcerpt.Text
+        else:
+            excerpt = ""
+
+        return excerpt
+
+    def get_additional_metadata(self) -> dict:
+        additional_metadata = {"type": self.Type}
+        return additional_metadata
+
+
+class RetrieveResultItem(ResultItem):
+    """Retrieve API result item."""
+
+    DocumentTitle: Optional[str]
+    """The document title."""
+    Content: Optional[str]
+    """The content of the item."""
+
+    def get_title(self) -> str:
+        return self.DocumentTitle or ""
+
+    def get_excerpt(self) -> str:
+        return self.Content or ""
+
+
+# Unexpected keyword argument "extra" for "__init_subclass__" of "object"
+class QueryResult(BaseModel, extra=Extra.allow):  # type: ignore[call-arg]
+    """`Amazon Kendra Query API` search result.
+
+    It is composed of:
+        * Relevant suggested answers: either a text excerpt or table excerpt.
+        * Matching FAQs or questions-answer from your FAQ file.
+        * Documents including an excerpt of each document with its title.
+    """
+
+    ResultItems: List[QueryResultItem]
+    """The result items."""
+
+
+# Unexpected keyword argument "extra" for "__init_subclass__" of "object"
+class RetrieveResult(BaseModel, extra=Extra.allow):  # type: ignore[call-arg]
+    """`Amazon Kendra Retrieve API` search result.
+
+    It is composed of:
+        * relevant passages or text excerpts given an input query.
+    """
+
+    QueryId: str
+    """The ID of the query."""
+    ResultItems: List[RetrieveResultItem]
+    """The result items."""
+
+
+KENDRA_CONFIDENCE_MAPPING = {
+    "NOT_AVAILABLE": 0.0,
+    "LOW": 0.25,
+    "MEDIUM": 0.50,
+    "HIGH": 0.75,
+    "VERY_HIGH": 1.0,
+}
+
+
+class AmazonKendraRetriever(BaseRetriever):
+    """`Amazon Kendra Index` retriever.
+
+    Args:
+        index_id: Kendra index id
+
+        region_name: The aws region e.g., `us-west-2`.
+            Fallsback to AWS_DEFAULT_REGION env variable
+            or region specified in ~/.aws/config.
+
+        credentials_profile_name: The name of the profile in the ~/.aws/credentials
+            or ~/.aws/config files, which has either access keys or role information
+            specified. If not specified, the default credential profile or, if on an
+            EC2 instance, credentials from IMDS will be used.
+
+        top_k: No of results to return
+
+        attribute_filter: Additional filtering of results based on metadata
+            See: https://docs.aws.amazon.com/kendra/latest/APIReference
+
+        page_content_formatter: generates the Document page_content
+            allowing access to all result item attributes. By default, it uses
+            the item's title and excerpt.
+
+        client: boto3 client for Kendra
+
+        user_context: Provides information about the user context
+            See: https://docs.aws.amazon.com/kendra/latest/APIReference
+
+    Example:
+        .. code-block:: python
+
+            retriever = AmazonKendraRetriever(
+                index_id="c0806df7-e76b-4bce-9b5c-d5582f6b1a03"
+            )
+
+    """
+
+    index_id: str
+    region_name: Optional[str] = None
+    credentials_profile_name: Optional[str] = None
+    top_k: int = 3
+    attribute_filter: Optional[Dict] = None
+    page_content_formatter: Callable[[ResultItem], str] = combined_text
+    client: Any
+    user_context: Optional[Dict] = None
+    min_score_confidence: Annotated[Optional[float], Field(ge=0.0, le=1.0)]
+
+    @validator("top_k")
+    def validate_top_k(cls, value: int) -> int:
+        if value < 0:
+            raise ValueError(f"top_k ({value}) cannot be negative.")
+        return value
+
+    @root_validator(pre=True)
+    def create_client(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        if values.get("client") is not None:
+            return values
+
+        try:
+            import boto3
+
+            if values.get("credentials_profile_name"):
+                session = boto3.Session(profile_name=values["credentials_profile_name"])
+            else:
+                # use default credentials
+                session = boto3.Session()
+
+            client_params = {}
+            if values.get("region_name"):
+                client_params["region_name"] = values["region_name"]
+
+            values["client"] = session.client("kendra", **client_params)
+
+            return values
+        except ImportError:
+            raise ModuleNotFoundError(
+                "Could not import boto3 python package. "
+                "Please install it with `pip install boto3`."
+            )
+        except Exception as e:
+            raise ValueError(
+                "Could not load credentials to authenticate with AWS client. "
+                "Please check that credentials in the specified "
+                "profile name are valid."
+            ) from e
+
+    def _kendra_query(self, query: str) -> Sequence[ResultItem]:
+        kendra_kwargs = {
+            "IndexId": self.index_id,
+            # truncate the query to ensure that
+            # there is no validation exception from Kendra.
+            "QueryText": query.strip()[0:999],
+            "PageSize": self.top_k,
+        }
+        if self.attribute_filter is not None:
+            kendra_kwargs["AttributeFilter"] = self.attribute_filter
+        if self.user_context is not None:
+            kendra_kwargs["UserContext"] = self.user_context
+
+        response = self.client.retrieve(**kendra_kwargs)
+        r_result = RetrieveResult.parse_obj(response)
+        if r_result.ResultItems:
+            return r_result.ResultItems
+
+        # Retrieve API returned 0 results, fall back to Query API
+        response = self.client.query(**kendra_kwargs)
+        q_result = QueryResult.parse_obj(response)
+        return q_result.ResultItems
+
+    def _get_top_k_docs(self, result_items: Sequence[ResultItem]) -> List[Document]:
+        top_docs = [
+            item.to_doc(self.page_content_formatter)
+            for item in result_items[: self.top_k]
+        ]
+        return top_docs
+
+    def _filter_by_score_confidence(self, docs: List[Document]) -> List[Document]:
+        """
+        Filter out the records that have a score confidence
+        greater than the required threshold.
+        """
+        if not self.min_score_confidence:
+            return docs
+        filtered_docs = [
+            item
+            for item in docs
+            if (
+                item.metadata.get("score") is not None
+                and isinstance(item.metadata["score"], str)
+                and KENDRA_CONFIDENCE_MAPPING.get(item.metadata["score"], 0.0)
+                >= self.min_score_confidence
+            )
+        ]
+        return filtered_docs
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+    ) -> List[Document]:
+        """Run search on Kendra index and get top k documents
+
+        Example:
+        .. code-block:: python
+
+            docs = retriever.get_relevant_documents('This is my query')
+
+        """
+        result_items = self._kendra_query(query)
+        top_k_docs = self._get_top_k_docs(result_items)
+        return self._filter_by_score_confidence(top_k_docs)
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/knn.py b/llm/Lib/site-packages/langchain_community/retrievers/knn.py
new file mode 100644
index 0000000000000000000000000000000000000000..434837f1e3080d0a3eb7ae859ee7fa7df6fbdbe9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/knn.py
@@ -0,0 +1,108 @@
+"""KNN Retriever.
+Largely based on
+https://github.com/karpathy/randomfun/blob/master/knn_vs_svm.ipynb"""
+
+from __future__ import annotations
+
+import concurrent.futures
+from typing import Any, Iterable, List, Optional
+
+import numpy as np
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.retrievers import BaseRetriever
+
+
+def create_index(contexts: List[str], embeddings: Embeddings) -> np.ndarray:
+    """
+    Create an index of embeddings for a list of contexts.
+
+    Args:
+        contexts: List of contexts to embed.
+        embeddings: Embeddings model to use.
+
+    Returns:
+        Index of embeddings.
+    """
+    with concurrent.futures.ThreadPoolExecutor() as executor:
+        return np.array(list(executor.map(embeddings.embed_query, contexts)))
+
+
+class KNNRetriever(BaseRetriever):
+    """`KNN` retriever."""
+
+    embeddings: Embeddings
+    """Embeddings model to use."""
+    index: Any
+    """Index of embeddings."""
+    texts: List[str]
+    """List of texts to index."""
+    metadatas: Optional[List[dict]] = None
+    """List of metadatas corresponding with each text."""
+    k: int = 4
+    """Number of results to return."""
+    relevancy_threshold: Optional[float] = None
+    """Threshold for relevancy."""
+
+    class Config:
+
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embeddings: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> KNNRetriever:
+        index = create_index(texts, embeddings)
+        return cls(
+            embeddings=embeddings,
+            index=index,
+            texts=texts,
+            metadatas=metadatas,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_documents(
+        cls,
+        documents: Iterable[Document],
+        embeddings: Embeddings,
+        **kwargs: Any,
+    ) -> KNNRetriever:
+        texts, metadatas = zip(*((d.page_content, d.metadata) for d in documents))
+        return cls.from_texts(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, **kwargs
+        )
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        query_embeds = np.array(self.embeddings.embed_query(query))
+        # calc L2 norm
+        index_embeds = self.index / np.sqrt((self.index**2).sum(1, keepdims=True))
+        query_embeds = query_embeds / np.sqrt((query_embeds**2).sum())
+
+        similarities = index_embeds.dot(query_embeds)
+        sorted_ix = np.argsort(-similarities)
+
+        denominator = np.max(similarities) - np.min(similarities) + 1e-6
+        normalized_similarities = (similarities - np.min(similarities)) / denominator
+
+        top_k_results = [
+            Document(
+                page_content=self.texts[row],
+                metadata=self.metadatas[row] if self.metadatas else {},
+            )
+            for row in sorted_ix[0 : self.k]
+            if (
+                self.relevancy_threshold is None
+                or normalized_similarities[row] >= self.relevancy_threshold
+            )
+        ]
+        return top_k_results
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/llama_index.py b/llm/Lib/site-packages/langchain_community/retrievers/llama_index.py
new file mode 100644
index 0000000000000000000000000000000000000000..9106c058d75489d158e243ce081f96d32f5bb2b6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/llama_index.py
@@ -0,0 +1,86 @@
+from typing import Any, Dict, List, cast
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Field
+from langchain_core.retrievers import BaseRetriever
+
+
+class LlamaIndexRetriever(BaseRetriever):
+    """`LlamaIndex` retriever.
+
+    It is used for the question-answering with sources over
+    an LlamaIndex data structure."""
+
+    index: Any
+    """LlamaIndex index to query."""
+    query_kwargs: Dict = Field(default_factory=dict)
+    """Keyword arguments to pass to the query method."""
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Get documents relevant for a query."""
+        try:
+            from llama_index.core.base.response.schema import Response
+            from llama_index.core.indices.base import BaseGPTIndex
+        except ImportError:
+            raise ImportError(
+                "You need to install `pip install llama-index` to use this retriever."
+            )
+        index = cast(BaseGPTIndex, self.index)
+
+        response = index.query(query, **self.query_kwargs)
+        response = cast(Response, response)
+        # parse source nodes
+        docs = []
+        for source_node in response.source_nodes:
+            metadata = source_node.metadata or {}
+            docs.append(
+                Document(page_content=source_node.get_content(), metadata=metadata)
+            )
+        return docs
+
+
+class LlamaIndexGraphRetriever(BaseRetriever):
+    """`LlamaIndex` graph data structure retriever.
+
+    It is used for question-answering with sources over an LlamaIndex
+    graph data structure."""
+
+    graph: Any
+    """LlamaIndex graph to query."""
+    query_configs: List[Dict] = Field(default_factory=list)
+    """List of query configs to pass to the query method."""
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Get documents relevant for a query."""
+        try:
+            from llama_index.core.base.response.schema import Response
+            from llama_index.core.composability.base import (
+                QUERY_CONFIG_TYPE,
+                ComposableGraph,
+            )
+        except ImportError:
+            raise ImportError(
+                "You need to install `pip install llama-index` to use this retriever."
+            )
+        graph = cast(ComposableGraph, self.graph)
+
+        # for now, inject response_mode="no_text" into query configs
+        for query_config in self.query_configs:
+            query_config["response_mode"] = "no_text"
+        query_configs = cast(List[QUERY_CONFIG_TYPE], self.query_configs)
+        response = graph.query(query, query_configs=query_configs)
+        response = cast(Response, response)
+
+        # parse source nodes
+        docs = []
+        for source_node in response.source_nodes:
+            metadata = source_node.metadata or {}
+            docs.append(
+                Document(page_content=source_node.get_content(), metadata=metadata)
+            )
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/metal.py b/llm/Lib/site-packages/langchain_community/retrievers/metal.py
new file mode 100644
index 0000000000000000000000000000000000000000..6eefd8312e3dcf726a96b5b6935f6f7721105191
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/metal.py
@@ -0,0 +1,42 @@
+from typing import Any, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.retrievers import BaseRetriever
+
+
+class MetalRetriever(BaseRetriever):
+    """`Metal API` retriever."""
+
+    client: Any
+    """The Metal client to use."""
+    params: Optional[dict] = None
+    """The parameters to pass to the Metal client."""
+
+    @root_validator(pre=True)
+    def validate_client(cls, values: dict) -> dict:
+        """Validate that the client is of the correct type."""
+        from metal_sdk.metal import Metal
+
+        if "client" in values:
+            client = values["client"]
+            if not isinstance(client, Metal):
+                raise ValueError(
+                    "Got unexpected client, should be of type metal_sdk.metal.Metal. "
+                    f"Instead, got {type(client)}"
+                )
+
+        values["params"] = values.get("params", {})
+
+        return values
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        results = self.client.search({"text": query}, **self.params)
+        final_results = []
+        for r in results["data"]:
+            metadata = {k: v for k, v in r.items() if k != "text"}
+            final_results.append(Document(page_content=r["text"], metadata=metadata))
+        return final_results
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/milvus.py b/llm/Lib/site-packages/langchain_community/retrievers/milvus.py
new file mode 100644
index 0000000000000000000000000000000000000000..fc81c465c083970d6da9d627502658a68dc0c459
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/milvus.py
@@ -0,0 +1,82 @@
+"""Milvus Retriever"""
+import warnings
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.retrievers import BaseRetriever
+
+from langchain_community.vectorstores.milvus import Milvus
+
+# TODO: Update to MilvusClient + Hybrid Search when available
+
+
+class MilvusRetriever(BaseRetriever):
+    """`Milvus API` retriever."""
+
+    embedding_function: Embeddings
+    collection_name: str = "LangChainCollection"
+    collection_properties: Optional[Dict[str, Any]] = None
+    connection_args: Optional[Dict[str, Any]] = None
+    consistency_level: str = "Session"
+    search_params: Optional[dict] = None
+
+    store: Milvus
+    retriever: BaseRetriever
+
+    @root_validator(pre=True)
+    def create_retriever(cls, values: Dict) -> Dict:
+        """Create the Milvus store and retriever."""
+        values["store"] = Milvus(
+            values["embedding_function"],
+            values["collection_name"],
+            values["collection_properties"],
+            values["connection_args"],
+            values["consistency_level"],
+        )
+        values["retriever"] = values["store"].as_retriever(
+            search_kwargs={"param": values["search_params"]}
+        )
+        return values
+
+    def add_texts(
+        self, texts: List[str], metadatas: Optional[List[dict]] = None
+    ) -> None:
+        """Add text to the Milvus store
+
+        Args:
+            texts (List[str]): The text
+            metadatas (List[dict]): Metadata dicts, must line up with existing store
+        """
+        self.store.add_texts(texts, metadatas)
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+        **kwargs: Any,
+    ) -> List[Document]:
+        return self.retriever.get_relevant_documents(
+            query, run_manager=run_manager.get_child(), **kwargs
+        )
+
+
+def MilvusRetreiver(*args: Any, **kwargs: Any) -> MilvusRetriever:
+    """Deprecated MilvusRetreiver. Please use MilvusRetriever ('i' before 'e') instead.
+
+    Args:
+        *args:
+        **kwargs:
+
+    Returns:
+        MilvusRetriever
+    """
+    warnings.warn(
+        "MilvusRetreiver will be deprecated in the future. "
+        "Please use MilvusRetriever ('i' before 'e') instead.",
+        DeprecationWarning,
+    )
+    return MilvusRetriever(*args, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/outline.py b/llm/Lib/site-packages/langchain_community/retrievers/outline.py
new file mode 100644
index 0000000000000000000000000000000000000000..03b1118125df8abc2799266733066392531f5045
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/outline.py
@@ -0,0 +1,20 @@
+from typing import List
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+from langchain_community.utilities.outline import OutlineAPIWrapper
+
+
+class OutlineRetriever(BaseRetriever, OutlineAPIWrapper):
+    """Retriever for Outline API.
+
+    It wraps run() to get_relevant_documents().
+    It uses all OutlineAPIWrapper arguments without any change.
+    """
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        return self.run(query=query)
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/pinecone_hybrid_search.py b/llm/Lib/site-packages/langchain_community/retrievers/pinecone_hybrid_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..333d30a0893ecc72ddcc7a76e87d424fda3fa0e0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/pinecone_hybrid_search.py
@@ -0,0 +1,180 @@
+"""Taken from: https://docs.pinecone.io/docs/hybrid-search"""
+
+import hashlib
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.retrievers import BaseRetriever
+
+
+def hash_text(text: str) -> str:
+    """Hash a text using SHA256.
+
+    Args:
+        text: Text to hash.
+
+    Returns:
+        Hashed text.
+    """
+    return str(hashlib.sha256(text.encode("utf-8")).hexdigest())
+
+
+def create_index(
+    contexts: List[str],
+    index: Any,
+    embeddings: Embeddings,
+    sparse_encoder: Any,
+    ids: Optional[List[str]] = None,
+    metadatas: Optional[List[dict]] = None,
+    namespace: Optional[str] = None,
+) -> None:
+    """Create an index from a list of contexts.
+
+    It modifies the index argument in-place!
+
+    Args:
+        contexts: List of contexts to embed.
+        index: Index to use.
+        embeddings: Embeddings model to use.
+        sparse_encoder: Sparse encoder to use.
+        ids: List of ids to use for the documents.
+        metadatas: List of metadata to use for the documents.
+    """
+    batch_size = 32
+    _iterator = range(0, len(contexts), batch_size)
+    try:
+        from tqdm.auto import tqdm
+
+        _iterator = tqdm(_iterator)
+    except ImportError:
+        pass
+
+    if ids is None:
+        # create unique ids using hash of the text
+        ids = [hash_text(context) for context in contexts]
+
+    for i in _iterator:
+        # find end of batch
+        i_end = min(i + batch_size, len(contexts))
+        # extract batch
+        context_batch = contexts[i:i_end]
+        batch_ids = ids[i:i_end]
+        metadata_batch = (
+            metadatas[i:i_end] if metadatas else [{} for _ in context_batch]
+        )
+        # add context passages as metadata
+        meta = [
+            {"context": context, **metadata}
+            for context, metadata in zip(context_batch, metadata_batch)
+        ]
+
+        # create dense vectors
+        dense_embeds = embeddings.embed_documents(context_batch)
+        # create sparse vectors
+        sparse_embeds = sparse_encoder.encode_documents(context_batch)
+        for s in sparse_embeds:
+            s["values"] = [float(s1) for s1 in s["values"]]
+
+        vectors = []
+        # loop through the data and create dictionaries for upserts
+        for doc_id, sparse, dense, metadata in zip(
+            batch_ids, sparse_embeds, dense_embeds, meta
+        ):
+            vectors.append(
+                {
+                    "id": doc_id,
+                    "sparse_values": sparse,
+                    "values": dense,
+                    "metadata": metadata,
+                }
+            )
+
+        # upload the documents to the new hybrid index
+        index.upsert(vectors, namespace=namespace)
+
+
+class PineconeHybridSearchRetriever(BaseRetriever):
+    """`Pinecone Hybrid Search` retriever."""
+
+    embeddings: Embeddings
+    """Embeddings model to use."""
+    """description"""
+    sparse_encoder: Any
+    """Sparse encoder to use."""
+    index: Any
+    """Pinecone index to use."""
+    top_k: int = 4
+    """Number of documents to return."""
+    alpha: float = 0.5
+    """Alpha value for hybrid search."""
+    namespace: Optional[str] = None
+    """Namespace value for index partition."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    def add_texts(
+        self,
+        texts: List[str],
+        ids: Optional[List[str]] = None,
+        metadatas: Optional[List[dict]] = None,
+        namespace: Optional[str] = None,
+    ) -> None:
+        create_index(
+            texts,
+            self.index,
+            self.embeddings,
+            self.sparse_encoder,
+            ids=ids,
+            metadatas=metadatas,
+            namespace=namespace,
+        )
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        try:
+            from pinecone_text.hybrid import hybrid_convex_scale  # noqa:F401
+            from pinecone_text.sparse.base_sparse_encoder import (
+                BaseSparseEncoder,  # noqa:F401
+            )
+        except ImportError:
+            raise ImportError(
+                "Could not import pinecone_text python package. "
+                "Please install it with `pip install pinecone_text`."
+            )
+        return values
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        from pinecone_text.hybrid import hybrid_convex_scale
+
+        sparse_vec = self.sparse_encoder.encode_queries(query)
+        # convert the question into a dense vector
+        dense_vec = self.embeddings.embed_query(query)
+        # scale alpha with hybrid_scale
+        dense_vec, sparse_vec = hybrid_convex_scale(dense_vec, sparse_vec, self.alpha)
+        sparse_vec["values"] = [float(s1) for s1 in sparse_vec["values"]]
+        # query pinecone with the query parameters
+        result = self.index.query(
+            vector=dense_vec,
+            sparse_vector=sparse_vec,
+            top_k=self.top_k,
+            include_metadata=True,
+            namespace=self.namespace,
+        )
+        final_result = []
+        for res in result["matches"]:
+            context = res["metadata"].pop("context")
+            final_result.append(
+                Document(page_content=context, metadata=res["metadata"])
+            )
+        # return search results as json
+        return final_result
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/pubmed.py b/llm/Lib/site-packages/langchain_community/retrievers/pubmed.py
new file mode 100644
index 0000000000000000000000000000000000000000..d68e85b80b0a30875dc0cdbc1de11904b0005f42
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/pubmed.py
@@ -0,0 +1,20 @@
+from typing import List
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+from langchain_community.utilities.pubmed import PubMedAPIWrapper
+
+
+class PubMedRetriever(BaseRetriever, PubMedAPIWrapper):
+    """`PubMed API` retriever.
+
+    It wraps load() to get_relevant_documents().
+    It uses all PubMedAPIWrapper arguments without any change.
+    """
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        return self.load_docs(query=query)
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/pupmed.py b/llm/Lib/site-packages/langchain_community/retrievers/pupmed.py
new file mode 100644
index 0000000000000000000000000000000000000000..b4318034b275313b148fd2a1f259bc9d4bdb09cc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/pupmed.py
@@ -0,0 +1,5 @@
+from langchain_community.retrievers.pubmed import PubMedRetriever
+
+__all__ = [
+    "PubMedRetriever",
+]
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/qdrant_sparse_vector_retriever.py b/llm/Lib/site-packages/langchain_community/retrievers/qdrant_sparse_vector_retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..daf8917173db82d39c551444697bff04f86bbb7a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/qdrant_sparse_vector_retriever.py
@@ -0,0 +1,209 @@
+import uuid
+from itertools import islice
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Generator,
+    Iterable,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    cast,
+)
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.retrievers import BaseRetriever
+
+from langchain_community.vectorstores.qdrant import Qdrant, QdrantException
+
+
+class QdrantSparseVectorRetriever(BaseRetriever):
+    """Qdrant sparse vector retriever."""
+
+    client: Any
+    """'qdrant_client' instance to use."""
+    collection_name: str
+    """Qdrant collection name."""
+    sparse_vector_name: str
+    """Name of the sparse vector to use."""
+    sparse_encoder: Callable[[str], Tuple[List[int], List[float]]]
+    """Sparse encoder function to use."""
+    k: int = 4
+    """Number of documents to return per query. Defaults to 4."""
+    filter: Optional[Any] = None
+    """Qdrant qdrant_client.models.Filter to use for queries. Defaults to None."""
+    content_payload_key: str = "content"
+    """Payload field containing the document content. Defaults to 'content'"""
+    metadata_payload_key: str = "metadata"
+    """Payload field containing the document metadata. Defaults to 'metadata'."""
+    search_options: Dict[str, Any] = {}
+    """Additional search options to pass to qdrant_client.QdrantClient.search()."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that 'qdrant_client' python package exists in environment."""
+        try:
+            from grpc import RpcError
+            from qdrant_client import QdrantClient, models
+            from qdrant_client.http.exceptions import UnexpectedResponse
+        except ImportError:
+            raise ImportError(
+                "Could not import qdrant-client python package. "
+                "Please install it with `pip install qdrant-client`."
+            )
+
+        client = values["client"]
+        if not isinstance(client, QdrantClient):
+            raise ValueError(
+                f"client should be an instance of qdrant_client.QdrantClient, "
+                f"got {type(client)}"
+            )
+
+        filter = values["filter"]
+        if filter is not None and not isinstance(filter, models.Filter):
+            raise ValueError(
+                f"filter should be an instance of qdrant_client.models.Filter, "
+                f"got {type(filter)}"
+            )
+
+        client = cast(QdrantClient, client)
+
+        collection_name = values["collection_name"]
+        sparse_vector_name = values["sparse_vector_name"]
+
+        try:
+            collection_info = client.get_collection(collection_name)
+            sparse_vectors_config = collection_info.config.params.sparse_vectors
+
+            if sparse_vector_name not in sparse_vectors_config:
+                raise QdrantException(
+                    f"Existing Qdrant collection {collection_name} does not "
+                    f"contain sparse vector named {sparse_vector_name}."
+                    f"Did you mean one of {', '.join(sparse_vectors_config.keys())}?"
+                )
+        except (UnexpectedResponse, RpcError, ValueError):
+            raise QdrantException(
+                f"Qdrant collection {collection_name} does not exist."
+            )
+        return values
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        from qdrant_client import QdrantClient, models
+
+        client = cast(QdrantClient, self.client)
+        query_indices, query_values = self.sparse_encoder(query)
+        results = client.search(
+            self.collection_name,
+            query_filter=self.filter,
+            query_vector=models.NamedSparseVector(
+                name=self.sparse_vector_name,
+                vector=models.SparseVector(
+                    indices=query_indices,
+                    values=query_values,
+                ),
+            ),
+            limit=self.k,
+            with_vectors=False,
+            **self.search_options,
+        )
+        return [
+            Qdrant._document_from_scored_point(
+                point,
+                self.collection_name,
+                self.content_payload_key,
+                self.metadata_payload_key,
+            )
+            for point in results
+        ]
+
+    def add_documents(self, documents: List[Document], **kwargs: Any) -> List[str]:
+        """Run more documents through the embeddings and add to the vectorstore.
+
+        Args:
+            documents (List[Document]: Documents to add to the vectorstore.
+
+        Returns:
+            List[str]: List of IDs of the added texts.
+        """
+        texts = [doc.page_content for doc in documents]
+        metadatas = [doc.metadata for doc in documents]
+        return self.add_texts(texts, metadatas, **kwargs)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[Sequence[str]] = None,
+        batch_size: int = 64,
+        **kwargs: Any,
+    ) -> List[str]:
+        from qdrant_client import QdrantClient
+
+        added_ids = []
+        client = cast(QdrantClient, self.client)
+        for batch_ids, points in self._generate_rest_batches(
+            texts, metadatas, ids, batch_size
+        ):
+            client.upsert(self.collection_name, points=points, **kwargs)
+            added_ids.extend(batch_ids)
+
+        return added_ids
+
+    def _generate_rest_batches(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[Sequence[str]] = None,
+        batch_size: int = 64,
+    ) -> Generator[Tuple[List[str], List[Any]], None, None]:
+        from qdrant_client import models as rest
+
+        texts_iterator = iter(texts)
+        metadatas_iterator = iter(metadatas or [])
+        ids_iterator = iter(ids or [uuid.uuid4().hex for _ in iter(texts)])
+        while batch_texts := list(islice(texts_iterator, batch_size)):
+            # Take the corresponding metadata and id for each text in a batch
+            batch_metadatas = list(islice(metadatas_iterator, batch_size)) or None
+            batch_ids = list(islice(ids_iterator, batch_size))
+
+            # Generate the sparse embeddings for all the texts in a batch
+            batch_embeddings: List[Tuple[List[int], List[float]]] = [
+                self.sparse_encoder(text) for text in batch_texts
+            ]
+
+            points = [
+                rest.PointStruct(
+                    id=point_id,
+                    vector={
+                        self.sparse_vector_name: rest.SparseVector(
+                            indices=sparse_vector[0],
+                            values=sparse_vector[1],
+                        )
+                    },
+                    payload=payload,
+                )
+                for point_id, sparse_vector, payload in zip(
+                    batch_ids,
+                    batch_embeddings,
+                    Qdrant._build_payloads(
+                        batch_texts,
+                        batch_metadatas,
+                        self.content_payload_key,
+                        self.metadata_payload_key,
+                    ),
+                )
+            ]
+
+            yield batch_ids, points
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/remote_retriever.py b/llm/Lib/site-packages/langchain_community/retrievers/remote_retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..f384385557b7da5de079956a53c4163ce4ba3068
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/remote_retriever.py
@@ -0,0 +1,56 @@
+from typing import List, Optional
+
+import aiohttp
+import requests
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+
+class RemoteLangChainRetriever(BaseRetriever):
+    """`LangChain API` retriever."""
+
+    url: str
+    """URL of the remote LangChain API."""
+    headers: Optional[dict] = None
+    """Headers to use for the request."""
+    input_key: str = "message"
+    """Key to use for the input in the request."""
+    response_key: str = "response"
+    """Key to use for the response in the request."""
+    page_content_key: str = "page_content"
+    """Key to use for the page content in the response."""
+    metadata_key: str = "metadata"
+    """Key to use for the metadata in the response."""
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        response = requests.post(
+            self.url, json={self.input_key: query}, headers=self.headers
+        )
+        result = response.json()
+        return [
+            Document(
+                page_content=r[self.page_content_key], metadata=r[self.metadata_key]
+            )
+            for r in result[self.response_key]
+        ]
+
+    async def _aget_relevant_documents(
+        self, query: str, *, run_manager: AsyncCallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        async with aiohttp.ClientSession() as session:
+            async with session.request(
+                "POST", self.url, headers=self.headers, json={self.input_key: query}
+            ) as response:
+                result = await response.json()
+        return [
+            Document(
+                page_content=r[self.page_content_key], metadata=r[self.metadata_key]
+            )
+            for r in result[self.response_key]
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/svm.py b/llm/Lib/site-packages/langchain_community/retrievers/svm.py
new file mode 100644
index 0000000000000000000000000000000000000000..96753ecac1997f8da1b81592b302d9b9286ce62d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/svm.py
@@ -0,0 +1,128 @@
+from __future__ import annotations
+
+import concurrent.futures
+from typing import Any, Iterable, List, Optional
+
+import numpy as np
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.retrievers import BaseRetriever
+
+
+def create_index(contexts: List[str], embeddings: Embeddings) -> np.ndarray:
+    """
+    Create an index of embeddings for a list of contexts.
+
+    Args:
+        contexts: List of contexts to embed.
+        embeddings: Embeddings model to use.
+
+    Returns:
+        Index of embeddings.
+    """
+    with concurrent.futures.ThreadPoolExecutor() as executor:
+        return np.array(list(executor.map(embeddings.embed_query, contexts)))
+
+
+class SVMRetriever(BaseRetriever):
+    """`SVM` retriever.
+
+    Largely based on
+    https://github.com/karpathy/randomfun/blob/master/knn_vs_svm.ipynb
+    """
+
+    embeddings: Embeddings
+    """Embeddings model to use."""
+    index: Any
+    """Index of embeddings."""
+    texts: List[str]
+    """List of texts to index."""
+    metadatas: Optional[List[dict]] = None
+    """List of metadatas corresponding with each text."""
+    k: int = 4
+    """Number of results to return."""
+    relevancy_threshold: Optional[float] = None
+    """Threshold for relevancy."""
+
+    class Config:
+
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embeddings: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> SVMRetriever:
+        index = create_index(texts, embeddings)
+        return cls(
+            embeddings=embeddings,
+            index=index,
+            texts=texts,
+            metadatas=metadatas,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_documents(
+        cls,
+        documents: Iterable[Document],
+        embeddings: Embeddings,
+        **kwargs: Any,
+    ) -> SVMRetriever:
+        texts, metadatas = zip(*((d.page_content, d.metadata) for d in documents))
+        return cls.from_texts(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, **kwargs
+        )
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        try:
+            from sklearn import svm
+        except ImportError:
+            raise ImportError(
+                "Could not import scikit-learn, please install with `pip install "
+                "scikit-learn`."
+            )
+
+        query_embeds = np.array(self.embeddings.embed_query(query))
+        x = np.concatenate([query_embeds[None, ...], self.index])
+        y = np.zeros(x.shape[0])
+        y[0] = 1
+
+        clf = svm.LinearSVC(
+            class_weight="balanced", verbose=False, max_iter=10000, tol=1e-6, C=0.1
+        )
+        clf.fit(x, y)
+
+        similarities = clf.decision_function(x)
+        sorted_ix = np.argsort(-similarities)
+
+        # svm.LinearSVC in scikit-learn is non-deterministic.
+        # if a text is the same as a query, there is no guarantee
+        # the query will be in the first index.
+        # this performs a simple swap, this works because anything
+        # left of the 0 should be equivalent.
+        zero_index = np.where(sorted_ix == 0)[0][0]
+        if zero_index != 0:
+            sorted_ix[0], sorted_ix[zero_index] = sorted_ix[zero_index], sorted_ix[0]
+
+        denominator = np.max(similarities) - np.min(similarities) + 1e-6
+        normalized_similarities = (similarities - np.min(similarities)) / denominator
+
+        top_k_results = []
+        for row in sorted_ix[1 : self.k + 1]:
+            if (
+                self.relevancy_threshold is None
+                or normalized_similarities[row] >= self.relevancy_threshold
+            ):
+                metadata = self.metadatas[row - 1] if self.metadatas else {}
+                doc = Document(page_content=self.texts[row - 1], metadata=metadata)
+                top_k_results.append(doc)
+        return top_k_results
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/tavily_search_api.py b/llm/Lib/site-packages/langchain_community/retrievers/tavily_search_api.py
new file mode 100644
index 0000000000000000000000000000000000000000..317b5774ed0f888ec7af04ea82fe105182c07b6c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/tavily_search_api.py
@@ -0,0 +1,84 @@
+import os
+from enum import Enum
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+
+class SearchDepth(Enum):
+    """Search depth as enumerator."""
+
+    BASIC = "basic"
+    ADVANCED = "advanced"
+
+
+class TavilySearchAPIRetriever(BaseRetriever):
+    """Tavily Search API retriever."""
+
+    k: int = 10
+    include_generated_answer: bool = False
+    include_raw_content: bool = False
+    include_images: bool = False
+    search_depth: SearchDepth = SearchDepth.BASIC
+    include_domains: Optional[List[str]] = None
+    exclude_domains: Optional[List[str]] = None
+    kwargs: Optional[Dict[str, Any]] = {}
+    api_key: Optional[str] = None
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        try:
+            from tavily import Client
+        except ImportError:
+            raise ImportError(
+                "Tavily python package not found. "
+                "Please install it with `pip install tavily-python`."
+            )
+
+        tavily = Client(api_key=self.api_key or os.environ["TAVILY_API_KEY"])
+        max_results = self.k if not self.include_generated_answer else self.k - 1
+        response = tavily.search(
+            query=query,
+            max_results=max_results,
+            search_depth=self.search_depth.value,
+            include_answer=self.include_generated_answer,
+            include_domains=self.include_domains,
+            exclude_domains=self.exclude_domains,
+            include_raw_content=self.include_raw_content,
+            include_images=self.include_images,
+            **self.kwargs,
+        )
+        docs = [
+            Document(
+                page_content=result.get("content", "")
+                if not self.include_raw_content
+                else result.get("raw_content", ""),
+                metadata={
+                    "title": result.get("title", ""),
+                    "source": result.get("url", ""),
+                    **{
+                        k: v
+                        for k, v in result.items()
+                        if k not in ("content", "title", "url", "raw_content")
+                    },
+                    "images": response.get("images"),
+                },
+            )
+            for result in response.get("results")
+        ]
+        if self.include_generated_answer:
+            docs = [
+                Document(
+                    page_content=response.get("answer", ""),
+                    metadata={
+                        "title": "Suggested Answer",
+                        "source": "https://tavily.com/",
+                    },
+                ),
+                *docs,
+            ]
+
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/tfidf.py b/llm/Lib/site-packages/langchain_community/retrievers/tfidf.py
new file mode 100644
index 0000000000000000000000000000000000000000..f6a3b57307a6dbb39a3d755e2a4cb583006ea1c7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/tfidf.py
@@ -0,0 +1,157 @@
+from __future__ import annotations
+
+import pickle
+from pathlib import Path
+from typing import Any, Dict, Iterable, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+
+class TFIDFRetriever(BaseRetriever):
+    """`TF-IDF` retriever.
+
+    Largely based on
+    https://github.com/asvskartheek/Text-Retrieval/blob/master/TF-IDF%20Search%20Engine%20(SKLEARN).ipynb
+    """
+
+    vectorizer: Any
+    """TF-IDF vectorizer."""
+    docs: List[Document]
+    """Documents."""
+    tfidf_array: Any
+    """TF-IDF array."""
+    k: int = 4
+    """Number of documents to return."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: Iterable[str],
+        metadatas: Optional[Iterable[dict]] = None,
+        tfidf_params: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> TFIDFRetriever:
+        try:
+            from sklearn.feature_extraction.text import TfidfVectorizer
+        except ImportError:
+            raise ImportError(
+                "Could not import scikit-learn, please install with `pip install "
+                "scikit-learn`."
+            )
+
+        tfidf_params = tfidf_params or {}
+        vectorizer = TfidfVectorizer(**tfidf_params)
+        tfidf_array = vectorizer.fit_transform(texts)
+        metadatas = metadatas or ({} for _ in texts)
+        docs = [Document(page_content=t, metadata=m) for t, m in zip(texts, metadatas)]
+        return cls(vectorizer=vectorizer, docs=docs, tfidf_array=tfidf_array, **kwargs)
+
+    @classmethod
+    def from_documents(
+        cls,
+        documents: Iterable[Document],
+        *,
+        tfidf_params: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> TFIDFRetriever:
+        texts, metadatas = zip(*((d.page_content, d.metadata) for d in documents))
+        return cls.from_texts(
+            texts=texts, tfidf_params=tfidf_params, metadatas=metadatas, **kwargs
+        )
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        from sklearn.metrics.pairwise import cosine_similarity
+
+        query_vec = self.vectorizer.transform(
+            [query]
+        )  # Ip -- (n_docs,x), Op -- (n_docs,n_Feats)
+        results = cosine_similarity(self.tfidf_array, query_vec).reshape(
+            (-1,)
+        )  # Op -- (n_docs,1) -- Cosine Sim with each doc
+        return_docs = [self.docs[i] for i in results.argsort()[-self.k :][::-1]]
+        return return_docs
+
+    def save_local(
+        self,
+        folder_path: str,
+        file_name: str = "tfidf_vectorizer",
+    ) -> None:
+        try:
+            import joblib
+        except ImportError:
+            raise ImportError(
+                "Could not import joblib, please install with `pip install joblib`."
+            )
+
+        path = Path(folder_path)
+        path.mkdir(exist_ok=True, parents=True)
+
+        # Save vectorizer with joblib dump.
+        joblib.dump(self.vectorizer, path / f"{file_name}.joblib")
+
+        # Save docs and tfidf array as pickle.
+        with open(path / f"{file_name}.pkl", "wb") as f:
+            pickle.dump((self.docs, self.tfidf_array), f)
+
+    @classmethod
+    def load_local(
+        cls,
+        folder_path: str,
+        *,
+        allow_dangerous_deserialization: bool = False,
+        file_name: str = "tfidf_vectorizer",
+    ) -> TFIDFRetriever:
+        """Load the retriever from local storage.
+
+        Args:
+            folder_path: Folder path to load from.
+            allow_dangerous_deserialization: Whether to allow dangerous deserialization.
+                Defaults to False.
+                The deserialization relies on .joblib and .pkl files, which can be
+                modified to deliver a malicious payload that results in execution of
+                arbitrary code on your machine. You will need to set this to `True` to
+                use deserialization. If you do this, make sure you trust the source of
+                the file.
+            file_name: File name to load from. Defaults to "tfidf_vectorizer".
+
+        Returns:
+            TFIDFRetriever: Loaded retriever.
+        """
+        try:
+            import joblib
+        except ImportError:
+            raise ImportError(
+                "Could not import joblib, please install with `pip install joblib`."
+            )
+
+        if not allow_dangerous_deserialization:
+            raise ValueError(
+                "The de-serialization of this retriever is based on .joblib and "
+                ".pkl files."
+                "Such files can be modified to deliver a malicious payload that "
+                "results in execution of arbitrary code on your machine."
+                "You will need to set `allow_dangerous_deserialization` to `True` to "
+                "load this retriever. If you do this, make sure you trust the source "
+                "of the file, and you are responsible for validating the the file "
+                "came from a trusted source."
+            )
+
+        path = Path(folder_path)
+
+        # Load vectorizer with joblib load.
+        vectorizer = joblib.load(path / f"{file_name}.joblib")
+
+        # Load docs and tfidf array as pickle.
+        with open(path / f"{file_name}.pkl", "rb") as f:
+            docs, tfidf_array = pickle.load(f)
+
+        return cls(vectorizer=vectorizer, docs=docs, tfidf_array=tfidf_array)
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/thirdai_neuraldb.py b/llm/Lib/site-packages/langchain_community/retrievers/thirdai_neuraldb.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b436b3e5a925243d4e7a1eace3207534ff05f3c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/thirdai_neuraldb.py
@@ -0,0 +1,260 @@
+from __future__ import annotations
+
+import importlib
+import os
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Tuple, Union
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import Extra, SecretStr, root_validator
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+
+class NeuralDBRetriever(BaseRetriever):
+    """Document retriever that uses ThirdAI's NeuralDB."""
+
+    thirdai_key: SecretStr
+    """ThirdAI API Key"""
+
+    db: Any = None  #: :meta private:
+    """NeuralDB instance"""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        underscore_attrs_are_private = True
+
+    @staticmethod
+    def _verify_thirdai_library(thirdai_key: Optional[str] = None) -> None:
+        try:
+            from thirdai import licensing
+
+            importlib.util.find_spec("thirdai.neural_db")
+
+            licensing.activate(thirdai_key or os.getenv("THIRDAI_KEY"))
+        except ImportError:
+            raise ModuleNotFoundError(
+                "Could not import thirdai python package and neuraldb dependencies. "
+                "Please install it with `pip install thirdai[neural_db]`."
+            )
+
+    @classmethod
+    def from_scratch(
+        cls,
+        thirdai_key: Optional[str] = None,
+        **model_kwargs: dict,
+    ) -> NeuralDBRetriever:
+        """
+        Create a NeuralDBRetriever from scratch.
+
+        To use, set the ``THIRDAI_KEY`` environment variable with your ThirdAI
+        API key, or pass ``thirdai_key`` as a named parameter.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.retrievers import NeuralDBRetriever
+
+                retriever = NeuralDBRetriever.from_scratch(
+                    thirdai_key="your-thirdai-key",
+                )
+
+                retriever.insert([
+                    "/path/to/doc.pdf",
+                    "/path/to/doc.docx",
+                    "/path/to/doc.csv",
+                ])
+
+                documents = retriever.get_relevant_documents("AI-driven music therapy")
+        """
+        NeuralDBRetriever._verify_thirdai_library(thirdai_key)
+        from thirdai import neural_db as ndb
+
+        return cls(thirdai_key=thirdai_key, db=ndb.NeuralDB(**model_kwargs))
+
+    @classmethod
+    def from_checkpoint(
+        cls,
+        checkpoint: Union[str, Path],
+        thirdai_key: Optional[str] = None,
+    ) -> NeuralDBRetriever:
+        """
+        Create a NeuralDBRetriever with a base model from a saved checkpoint
+
+        To use, set the ``THIRDAI_KEY`` environment variable with your ThirdAI
+        API key, or pass ``thirdai_key`` as a named parameter.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.retrievers import NeuralDBRetriever
+
+                retriever = NeuralDBRetriever.from_checkpoint(
+                    checkpoint="/path/to/checkpoint.ndb",
+                    thirdai_key="your-thirdai-key",
+                )
+
+                retriever.insert([
+                    "/path/to/doc.pdf",
+                    "/path/to/doc.docx",
+                    "/path/to/doc.csv",
+                ])
+
+                documents = retriever.get_relevant_documents("AI-driven music therapy")
+        """
+        NeuralDBRetriever._verify_thirdai_library(thirdai_key)
+        from thirdai import neural_db as ndb
+
+        return cls(thirdai_key=thirdai_key, db=ndb.NeuralDB.from_checkpoint(checkpoint))
+
+    @root_validator()
+    def validate_environments(cls, values: Dict) -> Dict:
+        """Validate ThirdAI environment variables."""
+        values["thirdai_key"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "thirdai_key",
+                "THIRDAI_KEY",
+            )
+        )
+        return values
+
+    def insert(
+        self,
+        sources: List[Any],
+        train: bool = True,
+        fast_mode: bool = True,
+        **kwargs: dict,
+    ) -> None:
+        """Inserts files / document sources into the retriever.
+
+        Args:
+            train: When True this means that the underlying model in the
+            NeuralDB will undergo unsupervised pretraining on the inserted files.
+            Defaults to True.
+            fast_mode: Much faster insertion with a slight drop in performance.
+            Defaults to True.
+        """
+        sources = self._preprocess_sources(sources)
+        self.db.insert(
+            sources=sources,
+            train=train,
+            fast_approximation=fast_mode,
+            **kwargs,
+        )
+
+    def _preprocess_sources(self, sources: list) -> list:
+        """Checks if the provided sources are string paths. If they are, convert
+        to NeuralDB document objects.
+
+        Args:
+            sources: list of either string paths to PDF, DOCX or CSV files, or
+            NeuralDB document objects.
+        """
+        from thirdai import neural_db as ndb
+
+        if not sources:
+            return sources
+        preprocessed_sources = []
+        for doc in sources:
+            if not isinstance(doc, str):
+                preprocessed_sources.append(doc)
+            else:
+                if doc.lower().endswith(".pdf"):
+                    preprocessed_sources.append(ndb.PDF(doc))
+                elif doc.lower().endswith(".docx"):
+                    preprocessed_sources.append(ndb.DOCX(doc))
+                elif doc.lower().endswith(".csv"):
+                    preprocessed_sources.append(ndb.CSV(doc))
+                else:
+                    raise RuntimeError(
+                        f"Could not automatically load {doc}. Only files "
+                        "with .pdf, .docx, or .csv extensions can be loaded "
+                        "automatically. For other formats, please use the "
+                        "appropriate document object from the ThirdAI library."
+                    )
+        return preprocessed_sources
+
+    def upvote(self, query: str, document_id: int) -> None:
+        """The retriever upweights the score of a document for a specific query.
+        This is useful for fine-tuning the retriever to user behavior.
+
+        Args:
+            query: text to associate with `document_id`
+            document_id: id of the document to associate query with.
+        """
+        self.db.text_to_result(query, document_id)
+
+    def upvote_batch(self, query_id_pairs: List[Tuple[str, int]]) -> None:
+        """Given a batch of (query, document id) pairs, the retriever upweights
+        the scores of the document for the corresponding queries.
+        This is useful for fine-tuning the retriever to user behavior.
+
+        Args:
+            query_id_pairs: list of (query, document id) pairs. For each pair in
+            this list, the model will upweight the document id for the query.
+        """
+        self.db.text_to_result_batch(query_id_pairs)
+
+    def associate(self, source: str, target: str) -> None:
+        """The retriever associates a source phrase with a target phrase.
+        When the retriever sees the source phrase, it will also consider results
+        that are relevant to the target phrase.
+
+        Args:
+            source: text to associate to `target`.
+            target: text to associate `source` to.
+        """
+        self.db.associate(source, target)
+
+    def associate_batch(self, text_pairs: List[Tuple[str, str]]) -> None:
+        """Given a batch of (source, target) pairs, the retriever associates
+        each source phrase with the corresponding target phrase.
+
+        Args:
+            text_pairs: list of (source, target) text pairs. For each pair in
+            this list, the source will be associated with the target.
+        """
+        self.db.associate_batch(text_pairs)
+
+    def _get_relevant_documents(
+        self, query: str, run_manager: CallbackManagerForRetrieverRun, **kwargs: Any
+    ) -> List[Document]:
+        """Retrieve {top_k} contexts with your retriever for a given query
+
+        Args:
+            query: Query to submit to the model
+            top_k: The max number of context results to retrieve. Defaults to 10.
+        """
+        try:
+            if "top_k" not in kwargs:
+                kwargs["top_k"] = 10
+            references = self.db.search(query=query, **kwargs)
+            return [
+                Document(
+                    page_content=ref.text,
+                    metadata={
+                        "id": ref.id,
+                        "upvote_ids": ref.upvote_ids,
+                        "source": ref.source,
+                        "metadata": ref.metadata,
+                        "score": ref.score,
+                        "context": ref.context(1),
+                    },
+                )
+                for ref in references
+            ]
+        except Exception as e:
+            raise ValueError(f"Error while retrieving documents: {e}") from e
+
+    def save(self, path: str) -> None:
+        """Saves a NeuralDB instance to disk. Can be loaded into memory by
+        calling NeuralDB.from_checkpoint(path)
+
+        Args:
+            path: path on disk to save the NeuralDB instance to.
+        """
+        self.db.save(path)
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/vespa_retriever.py b/llm/Lib/site-packages/langchain_community/retrievers/vespa_retriever.py
new file mode 100644
index 0000000000000000000000000000000000000000..6f5eb66aa0e45948eeb06cac798103b85df7416a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/vespa_retriever.py
@@ -0,0 +1,126 @@
+from __future__ import annotations
+
+import json
+from typing import Any, Dict, List, Literal, Optional, Sequence, Union
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+
+class VespaRetriever(BaseRetriever):
+    """`Vespa` retriever."""
+
+    app: Any
+    """Vespa application to query."""
+    body: Dict
+    """Body of the query."""
+    content_field: str
+    """Name of the content field."""
+    metadata_fields: Sequence[str]
+    """Names of the metadata fields."""
+
+    def _query(self, body: Dict) -> List[Document]:
+        response = self.app.query(body)
+
+        if not str(response.status_code).startswith("2"):
+            raise RuntimeError(
+                "Could not retrieve data from Vespa. Error code: {}".format(
+                    response.status_code
+                )
+            )
+
+        root = response.json["root"]
+        if "errors" in root:
+            raise RuntimeError(json.dumps(root["errors"]))
+
+        docs = []
+        for child in response.hits:
+            page_content = child["fields"].pop(self.content_field, "")
+            if self.metadata_fields == "*":
+                metadata = child["fields"]
+            else:
+                metadata = {mf: child["fields"].get(mf) for mf in self.metadata_fields}
+            metadata["id"] = child["id"]
+            docs.append(Document(page_content=page_content, metadata=metadata))
+        return docs
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        body = self.body.copy()
+        body["query"] = query
+        return self._query(body)
+
+    def get_relevant_documents_with_filter(
+        self, query: str, *, _filter: Optional[str] = None
+    ) -> List[Document]:
+        body = self.body.copy()
+        _filter = f" and {_filter}" if _filter else ""
+        body["yql"] = body["yql"] + _filter
+        body["query"] = query
+        return self._query(body)
+
+    @classmethod
+    def from_params(
+        cls,
+        url: str,
+        content_field: str,
+        *,
+        k: Optional[int] = None,
+        metadata_fields: Union[Sequence[str], Literal["*"]] = (),
+        sources: Union[Sequence[str], Literal["*"], None] = None,
+        _filter: Optional[str] = None,
+        yql: Optional[str] = None,
+        **kwargs: Any,
+    ) -> VespaRetriever:
+        """Instantiate retriever from params.
+
+        Args:
+            url (str): Vespa app URL.
+            content_field (str): Field in results to return as Document page_content.
+            k (Optional[int]): Number of Documents to return. Defaults to None.
+            metadata_fields(Sequence[str] or "*"): Fields in results to include in
+                document metadata. Defaults to empty tuple ().
+            sources (Sequence[str] or "*" or None): Sources to retrieve
+                from. Defaults to None.
+            _filter (Optional[str]): Document filter condition expressed in YQL.
+                Defaults to None.
+            yql (Optional[str]): Full YQL query to be used. Should not be specified
+                if _filter or sources are specified. Defaults to None.
+            kwargs (Any): Keyword arguments added to query body.
+
+        Returns:
+            VespaRetriever: Instantiated VespaRetriever.
+        """
+        try:
+            from vespa.application import Vespa
+        except ImportError:
+            raise ImportError(
+                "pyvespa is not installed, please install with `pip install pyvespa`"
+            )
+        app = Vespa(url)
+        body = kwargs.copy()
+        if yql and (sources or _filter):
+            raise ValueError(
+                "yql should only be specified if both sources and _filter are not "
+                "specified."
+            )
+        else:
+            if metadata_fields == "*":
+                _fields = "*"
+                body["summary"] = "short"
+            else:
+                _fields = ", ".join([content_field] + list(metadata_fields or []))
+            _sources = ", ".join(sources) if isinstance(sources, Sequence) else "*"
+            _filter = f" and {_filter}" if _filter else ""
+            yql = f"select {_fields} from sources {_sources} where userQuery(){_filter}"
+        body["yql"] = yql
+        if k:
+            body["hits"] = k
+        return cls(
+            app=app,
+            body=body,
+            content_field=content_field,
+            metadata_fields=metadata_fields,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/weaviate_hybrid_search.py b/llm/Lib/site-packages/langchain_community/retrievers/weaviate_hybrid_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..b216e27b65aeb3279a3bc5021af0e5aacab2df22
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/weaviate_hybrid_search.py
@@ -0,0 +1,162 @@
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional, cast
+from uuid import uuid4
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.retrievers import BaseRetriever
+
+
+class WeaviateHybridSearchRetriever(BaseRetriever):
+    """`Weaviate hybrid search` retriever.
+
+    See the documentation:
+      https://weaviate.io/blog/hybrid-search-explained
+    """
+
+    client: Any
+    """keyword arguments to pass to the Weaviate client."""
+    index_name: str
+    """The name of the index to use."""
+    text_key: str
+    """The name of the text key to use."""
+    alpha: float = 0.5
+    """The weight of the text key in the hybrid search."""
+    k: int = 4
+    """The number of results to return."""
+    attributes: List[str]
+    """The attributes to return in the results."""
+    create_schema_if_missing: bool = True
+    """Whether to create the schema if it doesn't exist."""
+
+    @root_validator(pre=True)
+    def validate_client(
+        cls,
+        values: Dict[str, Any],
+    ) -> Dict[str, Any]:
+        try:
+            import weaviate
+        except ImportError:
+            raise ImportError(
+                "Could not import weaviate python package. "
+                "Please install it with `pip install weaviate-client`."
+            )
+        if not isinstance(values["client"], weaviate.Client):
+            client = values["client"]
+            raise ValueError(
+                f"client should be an instance of weaviate.Client, got {type(client)}"
+            )
+        if values.get("attributes") is None:
+            values["attributes"] = []
+
+        cast(List, values["attributes"]).append(values["text_key"])
+
+        if values.get("create_schema_if_missing", True):
+            class_obj = {
+                "class": values["index_name"],
+                "properties": [{"name": values["text_key"], "dataType": ["text"]}],
+                "vectorizer": "text2vec-openai",
+            }
+
+            if not values["client"].schema.exists(values["index_name"]):
+                values["client"].schema.create_class(class_obj)
+
+        return values
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    # added text_key
+    def add_documents(self, docs: List[Document], **kwargs: Any) -> List[str]:
+        """Upload documents to Weaviate."""
+        from weaviate.util import get_valid_uuid
+
+        with self.client.batch as batch:
+            ids = []
+            for i, doc in enumerate(docs):
+                metadata = doc.metadata or {}
+                data_properties = {self.text_key: doc.page_content, **metadata}
+
+                # If the UUID of one of the objects already exists
+                # then the existing objectwill be replaced by the new object.
+                if "uuids" in kwargs:
+                    _id = kwargs["uuids"][i]
+                else:
+                    _id = get_valid_uuid(uuid4())
+
+                batch.add_data_object(data_properties, self.index_name, _id)
+                ids.append(_id)
+        return ids
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+        where_filter: Optional[Dict[str, object]] = None,
+        score: bool = False,
+        hybrid_search_kwargs: Optional[Dict[str, object]] = None,
+    ) -> List[Document]:
+        """Look up similar documents in Weaviate.
+
+        query: The query to search for relevant documents
+         of using weviate hybrid search.
+
+        where_filter: A filter to apply to the query.
+            https://weaviate.io/developers/weaviate/guides/querying/#filtering
+
+        score: Whether to include the score, and score explanation
+            in the returned Documents meta_data.
+
+        hybrid_search_kwargs: Used to pass additional arguments
+         to the .with_hybrid() method.
+            The primary uses cases for this are:
+            1)  Search specific properties only -
+                specify which properties to be used during hybrid search portion.
+                Note: this is not the same as the (self.attributes) to be returned.
+                Example - hybrid_search_kwargs={"properties": ["question", "answer"]}
+            https://weaviate.io/developers/weaviate/search/hybrid#selected-properties-only
+
+            2) Weight boosted searched properties -
+                Boost the weight of certain properties during the hybrid search portion.
+                Example - hybrid_search_kwargs={"properties": ["question^2", "answer"]}
+            https://weaviate.io/developers/weaviate/search/hybrid#weight-boost-searched-properties
+
+            3) Search with a custom vector - Define a different vector
+                to be used during the hybrid search portion.
+                Example - hybrid_search_kwargs={"vector": [0.1, 0.2, 0.3, ...]}
+            https://weaviate.io/developers/weaviate/search/hybrid#with-a-custom-vector
+
+            4) Use Fusion ranking method
+                Example - from weaviate.gql.get import HybridFusion
+                hybrid_search_kwargs={"fusion": fusion_type=HybridFusion.RELATIVE_SCORE}
+            https://weaviate.io/developers/weaviate/search/hybrid#fusion-ranking-method
+        """
+        query_obj = self.client.query.get(self.index_name, self.attributes)
+        if where_filter:
+            query_obj = query_obj.with_where(where_filter)
+
+        if score:
+            query_obj = query_obj.with_additional(["score", "explainScore"])
+
+        if hybrid_search_kwargs is None:
+            hybrid_search_kwargs = {}
+
+        result = (
+            query_obj.with_hybrid(query, alpha=self.alpha, **hybrid_search_kwargs)
+            .with_limit(self.k)
+            .do()
+        )
+        if "errors" in result:
+            raise ValueError(f"Error during query: {result['errors']}")
+
+        docs = []
+
+        for res in result["data"]["Get"][self.index_name]:
+            text = res.pop(self.text_key)
+            docs.append(Document(page_content=text, metadata=res))
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/wikipedia.py b/llm/Lib/site-packages/langchain_community/retrievers/wikipedia.py
new file mode 100644
index 0000000000000000000000000000000000000000..cd7e38180cea3b47c6bc83933ee6f3a43c32bdde
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/wikipedia.py
@@ -0,0 +1,20 @@
+from typing import List
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+from langchain_community.utilities.wikipedia import WikipediaAPIWrapper
+
+
+class WikipediaRetriever(BaseRetriever, WikipediaAPIWrapper):
+    """`Wikipedia API` retriever.
+
+    It wraps load() to get_relevant_documents().
+    It uses all WikipediaAPIWrapper arguments without any change.
+    """
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        return self.load(query=query)
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/you.py b/llm/Lib/site-packages/langchain_community/retrievers/you.py
new file mode 100644
index 0000000000000000000000000000000000000000..8ce080545afbd47c3ff385c92a357147042e4f2b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/you.py
@@ -0,0 +1,39 @@
+from typing import Any, List
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.retrievers import BaseRetriever
+
+from langchain_community.utilities import YouSearchAPIWrapper
+
+
+class YouRetriever(BaseRetriever, YouSearchAPIWrapper):
+    """You.com Search API retriever.
+
+    It wraps results() to get_relevant_documents
+    It uses all YouSearchAPIWrapper arguments without any change.
+    """
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+        **kwargs: Any,
+    ) -> List[Document]:
+        return self.results(query, run_manager=run_manager.get_child(), **kwargs)
+
+    async def _aget_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: AsyncCallbackManagerForRetrieverRun,
+        **kwargs: Any,
+    ) -> List[Document]:
+        results = await self.results_async(
+            query, run_manager=run_manager.get_child(), **kwargs
+        )
+        return results
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/zep.py b/llm/Lib/site-packages/langchain_community/retrievers/zep.py
new file mode 100644
index 0000000000000000000000000000000000000000..2060788e4cd341a196e42e7d32e93c66047956f9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/zep.py
@@ -0,0 +1,182 @@
+from __future__ import annotations
+
+from enum import Enum
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.retrievers import BaseRetriever
+
+if TYPE_CHECKING:
+    from zep_python.memory import MemorySearchResult
+
+
+class SearchScope(str, Enum):
+    """Which documents to search. Messages or Summaries?"""
+
+    messages = "messages"
+    """Search chat history messages."""
+    summary = "summary"
+    """Search chat history summaries."""
+
+
+class SearchType(str, Enum):
+    """Enumerator of the types of search to perform."""
+
+    similarity = "similarity"
+    """Similarity search."""
+    mmr = "mmr"
+    """Maximal Marginal Relevance reranking of similarity search."""
+
+
+class ZepRetriever(BaseRetriever):
+    """`Zep` MemoryStore Retriever.
+
+    Search your user's long-term chat history with Zep.
+
+    Zep offers both simple semantic search and Maximal Marginal Relevance (MMR)
+    reranking of search results.
+
+    Note: You will need to provide the user's `session_id` to use this retriever.
+
+    Args:
+        url: URL of your Zep server (required)
+        api_key: Your Zep API key (optional)
+        session_id: Identifies your user or a user's session (required)
+        top_k: Number of documents to return (default: 3, optional)
+        search_type: Type of search to perform (similarity / mmr) (default: similarity,
+                                                                    optional)
+        mmr_lambda: Lambda value for MMR search. Defaults to 0.5 (optional)
+
+    Zep - Fast, scalable building blocks for LLM Apps
+    =========
+    Zep is an open source platform for productionizing LLM apps. Go from a prototype
+    built in LangChain or LlamaIndex, or a custom app, to production in minutes without
+    rewriting code.
+
+    For server installation instructions, see:
+    https://docs.getzep.com/deployment/quickstart/
+    """
+
+    zep_client: Optional[Any] = None
+    """Zep client."""
+    url: str
+    """URL of your Zep server."""
+    api_key: Optional[str] = None
+    """Your Zep API key."""
+    session_id: str
+    """Zep session ID."""
+    top_k: Optional[int]
+    """Number of items to return."""
+    search_scope: SearchScope = SearchScope.messages
+    """Which documents to search. Messages or Summaries?"""
+    search_type: SearchType = SearchType.similarity
+    """Type of search to perform (similarity / mmr)"""
+    mmr_lambda: Optional[float] = None
+    """Lambda value for MMR search."""
+
+    @root_validator(pre=True)
+    def create_client(cls, values: dict) -> dict:
+        try:
+            from zep_python import ZepClient
+        except ImportError:
+            raise ImportError(
+                "Could not import zep-python package. "
+                "Please install it with `pip install zep-python`."
+            )
+        values["zep_client"] = values.get(
+            "zep_client",
+            ZepClient(base_url=values["url"], api_key=values.get("api_key")),
+        )
+        return values
+
+    def _messages_search_result_to_doc(
+        self, results: List[MemorySearchResult]
+    ) -> List[Document]:
+        return [
+            Document(
+                page_content=r.message.pop("content"),
+                metadata={"score": r.dist, **r.message},
+            )
+            for r in results
+            if r.message
+        ]
+
+    def _summary_search_result_to_doc(
+        self, results: List[MemorySearchResult]
+    ) -> List[Document]:
+        return [
+            Document(
+                page_content=r.summary.content,
+                metadata={
+                    "score": r.dist,
+                    "uuid": r.summary.uuid,
+                    "created_at": r.summary.created_at,
+                    "token_count": r.summary.token_count,
+                },
+            )
+            for r in results
+            if r.summary
+        ]
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+        metadata: Optional[Dict[str, Any]] = None,
+    ) -> List[Document]:
+        from zep_python.memory import MemorySearchPayload
+
+        if not self.zep_client:
+            raise RuntimeError("Zep client not initialized.")
+
+        payload = MemorySearchPayload(
+            text=query,
+            metadata=metadata,
+            search_scope=self.search_scope,
+            search_type=self.search_type,
+            mmr_lambda=self.mmr_lambda,
+        )
+
+        results: List[MemorySearchResult] = self.zep_client.memory.search_memory(
+            self.session_id, payload, limit=self.top_k
+        )
+
+        if self.search_scope == SearchScope.summary:
+            return self._summary_search_result_to_doc(results)
+
+        return self._messages_search_result_to_doc(results)
+
+    async def _aget_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: AsyncCallbackManagerForRetrieverRun,
+        metadata: Optional[Dict[str, Any]] = None,
+    ) -> List[Document]:
+        from zep_python.memory import MemorySearchPayload
+
+        if not self.zep_client:
+            raise RuntimeError("Zep client not initialized.")
+
+        payload = MemorySearchPayload(
+            text=query,
+            metadata=metadata,
+            search_scope=self.search_scope,
+            search_type=self.search_type,
+            mmr_lambda=self.mmr_lambda,
+        )
+
+        results: List[MemorySearchResult] = await self.zep_client.memory.asearch_memory(
+            self.session_id, payload, limit=self.top_k
+        )
+
+        if self.search_scope == SearchScope.summary:
+            return self._summary_search_result_to_doc(results)
+
+        return self._messages_search_result_to_doc(results)
diff --git a/llm/Lib/site-packages/langchain_community/retrievers/zilliz.py b/llm/Lib/site-packages/langchain_community/retrievers/zilliz.py
new file mode 100644
index 0000000000000000000000000000000000000000..43cd2c4e8cde9e3fcaddbb9135634a9af13e5f1e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/retrievers/zilliz.py
@@ -0,0 +1,86 @@
+import warnings
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForRetrieverRun
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.retrievers import BaseRetriever
+
+from langchain_community.vectorstores.zilliz import Zilliz
+
+# TODO: Update to ZillizClient + Hybrid Search when available
+
+
+class ZillizRetriever(BaseRetriever):
+    """`Zilliz API` retriever."""
+
+    embedding_function: Embeddings
+    """The underlying embedding function from which documents will be retrieved."""
+    collection_name: str = "LangChainCollection"
+    """The name of the collection in Zilliz."""
+    connection_args: Optional[Dict[str, Any]] = None
+    """The connection arguments for the Zilliz client."""
+    consistency_level: str = "Session"
+    """The consistency level for the Zilliz client."""
+    search_params: Optional[dict] = None
+    """The search parameters for the Zilliz client."""
+    store: Zilliz
+    """The underlying Zilliz store."""
+    retriever: BaseRetriever
+    """The underlying retriever."""
+
+    @root_validator(pre=True)
+    def create_client(cls, values: dict) -> dict:
+        values["store"] = Zilliz(
+            values["embedding_function"],
+            values["collection_name"],
+            values["connection_args"],
+            values["consistency_level"],
+        )
+        values["retriever"] = values["store"].as_retriever(
+            search_kwargs={"param": values["search_params"]}
+        )
+        return values
+
+    def add_texts(
+        self, texts: List[str], metadatas: Optional[List[dict]] = None
+    ) -> None:
+        """Add text to the Zilliz store
+
+        Args:
+            texts (List[str]): The text
+            metadatas (List[dict]): Metadata dicts, must line up with existing store
+        """
+        self.store.add_texts(texts, metadatas)
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: CallbackManagerForRetrieverRun,
+        **kwargs: Any,
+    ) -> List[Document]:
+        return self.retriever.get_relevant_documents(
+            query, run_manager=run_manager.get_child(), **kwargs
+        )
+
+
+def ZillizRetreiver(*args: Any, **kwargs: Any) -> ZillizRetriever:
+    """Deprecated ZillizRetreiver.
+
+    Please use ZillizRetriever ('i' before 'e') instead.
+
+    Args:
+        *args:
+        **kwargs:
+
+    Returns:
+        ZillizRetriever
+    """
+    warnings.warn(
+        "ZillizRetreiver will be deprecated in the future. "
+        "Please use ZillizRetriever ('i' before 'e') instead.",
+        DeprecationWarning,
+    )
+    return ZillizRetriever(*args, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/storage/__init__.py b/llm/Lib/site-packages/langchain_community/storage/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..97acca4dab4fcf493c81b63965cf766820d8a579
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/storage/__init__.py
@@ -0,0 +1,62 @@
+"""**Storage** is an implementation of key-value store.
+
+Storage module provides implementations of various key-value stores that conform
+to a simple key-value interface.
+
+The primary goal of these storages is to support caching.
+
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseStore --> <name>Store  # Examples: MongoDBStore, RedisStore
+
+"""  # noqa: E501
+
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.storage.astradb import (
+        AstraDBByteStore,  # noqa: F401
+        AstraDBStore,  # noqa: F401
+    )
+    from langchain_community.storage.mongodb import (
+        MongoDBStore,  # noqa: F401
+    )
+    from langchain_community.storage.redis import (
+        RedisStore,  # noqa: F401
+    )
+    from langchain_community.storage.upstash_redis import (
+        UpstashRedisByteStore,  # noqa: F401
+        UpstashRedisStore,  # noqa: F401
+    )
+
+__all__ = [
+    "AstraDBByteStore",
+    "AstraDBStore",
+    "MongoDBStore",
+    "RedisStore",
+    "UpstashRedisByteStore",
+    "UpstashRedisStore",
+]
+
+_module_lookup = {
+    "AstraDBByteStore": "langchain_community.storage.astradb",
+    "AstraDBStore": "langchain_community.storage.astradb",
+    "MongoDBStore": "langchain_community.storage.mongodb",
+    "RedisStore": "langchain_community.storage.redis",
+    "UpstashRedisByteStore": "langchain_community.storage.upstash_redis",
+    "UpstashRedisStore": "langchain_community.storage.upstash_redis",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/storage/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/storage/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..89f54ab8c44810eb23c35a883f4015430cb6ca39
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/storage/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/storage/__pycache__/astradb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/storage/__pycache__/astradb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9cda05a86935c64540a4f43697668c54578a46e8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/storage/__pycache__/astradb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/storage/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/storage/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a3ff7e74825cd14d398dbca7dc2bb494d141e7d2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/storage/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/storage/__pycache__/mongodb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/storage/__pycache__/mongodb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bb0023b1c4f63ef2bc7ab1b052568ceba083e05e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/storage/__pycache__/mongodb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/storage/__pycache__/redis.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/storage/__pycache__/redis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f29da6f22129ff271539d41796df53593cd6c02a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/storage/__pycache__/redis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/storage/__pycache__/upstash_redis.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/storage/__pycache__/upstash_redis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..21be569ef8a3a5a7d284aa2176ff152ab7dd1e07
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/storage/__pycache__/upstash_redis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/storage/astradb.py b/llm/Lib/site-packages/langchain_community/storage/astradb.py
new file mode 100644
index 0000000000000000000000000000000000000000..86be2ab9b8350f27e9c9008e95194d8a4f2c2d2e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/storage/astradb.py
@@ -0,0 +1,235 @@
+from __future__ import annotations
+
+import base64
+from abc import ABC, abstractmethod
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Generic,
+    Iterator,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    TypeVar,
+)
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.stores import BaseStore, ByteStore
+
+from langchain_community.utilities.astradb import (
+    SetupMode,
+    _AstraDBCollectionEnvironment,
+)
+
+if TYPE_CHECKING:
+    from astrapy.db import AstraDB, AsyncAstraDB
+
+V = TypeVar("V")
+
+
+class AstraDBBaseStore(Generic[V], BaseStore[str, V], ABC):
+    """Base class for the DataStax AstraDB data store."""
+
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        self.astra_env = _AstraDBCollectionEnvironment(*args, **kwargs)
+        self.collection = self.astra_env.collection
+        self.async_collection = self.astra_env.async_collection
+
+    @abstractmethod
+    def decode_value(self, value: Any) -> Optional[V]:
+        """Decodes value from Astra DB"""
+
+    @abstractmethod
+    def encode_value(self, value: Optional[V]) -> Any:
+        """Encodes value for Astra DB"""
+
+    def mget(self, keys: Sequence[str]) -> List[Optional[V]]:
+        self.astra_env.ensure_db_setup()
+        docs_dict = {}
+        for doc in self.collection.paginated_find(filter={"_id": {"$in": list(keys)}}):
+            docs_dict[doc["_id"]] = doc.get("value")
+        return [self.decode_value(docs_dict.get(key)) for key in keys]
+
+    async def amget(self, keys: Sequence[str]) -> List[Optional[V]]:
+        await self.astra_env.aensure_db_setup()
+        docs_dict = {}
+        async for doc in self.async_collection.paginated_find(
+            filter={"_id": {"$in": list(keys)}}
+        ):
+            docs_dict[doc["_id"]] = doc.get("value")
+        return [self.decode_value(docs_dict.get(key)) for key in keys]
+
+    def mset(self, key_value_pairs: Sequence[Tuple[str, V]]) -> None:
+        self.astra_env.ensure_db_setup()
+        for k, v in key_value_pairs:
+            self.collection.upsert({"_id": k, "value": self.encode_value(v)})
+
+    async def amset(self, key_value_pairs: Sequence[Tuple[str, V]]) -> None:
+        await self.astra_env.aensure_db_setup()
+        for k, v in key_value_pairs:
+            await self.async_collection.upsert(
+                {"_id": k, "value": self.encode_value(v)}
+            )
+
+    def mdelete(self, keys: Sequence[str]) -> None:
+        self.astra_env.ensure_db_setup()
+        self.collection.delete_many(filter={"_id": {"$in": list(keys)}})
+
+    async def amdelete(self, keys: Sequence[str]) -> None:
+        await self.astra_env.aensure_db_setup()
+        await self.async_collection.delete_many(filter={"_id": {"$in": list(keys)}})
+
+    def yield_keys(self, *, prefix: Optional[str] = None) -> Iterator[str]:
+        self.astra_env.ensure_db_setup()
+        docs = self.collection.paginated_find()
+        for doc in docs:
+            key = doc["_id"]
+            if not prefix or key.startswith(prefix):
+                yield key
+
+    async def ayield_keys(self, *, prefix: Optional[str] = None) -> AsyncIterator[str]:
+        await self.astra_env.aensure_db_setup()
+        async for doc in self.async_collection.paginated_find():
+            key = doc["_id"]
+            if not prefix or key.startswith(prefix):
+                yield key
+
+
+@deprecated(
+    since="0.0.22",
+    removal="0.2.0",
+    alternative_import="langchain_astradb.AstraDBStore",
+)
+class AstraDBStore(AstraDBBaseStore[Any]):
+    def __init__(
+        self,
+        collection_name: str,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        astra_db_client: Optional[AstraDB] = None,
+        namespace: Optional[str] = None,
+        *,
+        async_astra_db_client: Optional[AsyncAstraDB] = None,
+        pre_delete_collection: bool = False,
+        setup_mode: SetupMode = SetupMode.SYNC,
+    ) -> None:
+        """BaseStore implementation using DataStax AstraDB as the underlying store.
+
+        The value type can be any type serializable by json.dumps.
+        Can be used to store embeddings with the CacheBackedEmbeddings.
+
+        Documents in the AstraDB collection will have the format
+
+        .. code-block:: json
+
+            {
+              "_id": "<key>",
+              "value": <value>
+            }
+
+        Args:
+            collection_name: name of the Astra DB collection to create/use.
+            token: API token for Astra DB usage.
+            api_endpoint: full URL to the API endpoint,
+                such as `https://<DB-ID>-us-east1.apps.astra.datastax.com`.
+            astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AstraDB' instance.
+            async_astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AsyncAstraDB' instance.
+            namespace: namespace (aka keyspace) where the
+                collection is created. Defaults to the database's "default namespace".
+            setup_mode: mode used to create the Astra DB collection (SYNC, ASYNC or
+                OFF).
+            pre_delete_collection: whether to delete the collection
+                before creating it. If False and the collection already exists,
+                the collection will be used as is.
+        """
+        # Constructor doc is not inherited so we have to override it.
+        super().__init__(
+            collection_name=collection_name,
+            token=token,
+            api_endpoint=api_endpoint,
+            astra_db_client=astra_db_client,
+            async_astra_db_client=async_astra_db_client,
+            namespace=namespace,
+            setup_mode=setup_mode,
+            pre_delete_collection=pre_delete_collection,
+        )
+
+    def decode_value(self, value: Any) -> Any:
+        return value
+
+    def encode_value(self, value: Any) -> Any:
+        return value
+
+
+@deprecated(
+    since="0.0.22",
+    removal="0.2.0",
+    alternative_import="langchain_astradb.AstraDBByteStore",
+)
+class AstraDBByteStore(AstraDBBaseStore[bytes], ByteStore):
+    def __init__(
+        self,
+        collection_name: str,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        astra_db_client: Optional[AstraDB] = None,
+        namespace: Optional[str] = None,
+        *,
+        async_astra_db_client: Optional[AsyncAstraDB] = None,
+        pre_delete_collection: bool = False,
+        setup_mode: SetupMode = SetupMode.SYNC,
+    ) -> None:
+        """ByteStore implementation using DataStax AstraDB as the underlying store.
+
+        The bytes values are converted to base64 encoded strings
+        Documents in the AstraDB collection will have the format
+
+        .. code-block:: json
+
+            {
+              "_id": "<key>",
+              "value": "<byte64 string value>"
+            }
+
+        Args:
+            collection_name: name of the Astra DB collection to create/use.
+            token: API token for Astra DB usage.
+            api_endpoint: full URL to the API endpoint,
+                such as `https://<DB-ID>-us-east1.apps.astra.datastax.com`.
+            astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AstraDB' instance.
+            async_astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AsyncAstraDB' instance.
+            namespace: namespace (aka keyspace) where the
+                collection is created. Defaults to the database's "default namespace".
+            setup_mode: mode used to create the Astra DB collection (SYNC, ASYNC or
+                OFF).
+            pre_delete_collection: whether to delete the collection
+                before creating it. If False and the collection already exists,
+                the collection will be used as is.
+        """
+        # Constructor doc is not inherited so we have to override it.
+        super().__init__(
+            collection_name=collection_name,
+            token=token,
+            api_endpoint=api_endpoint,
+            astra_db_client=astra_db_client,
+            async_astra_db_client=async_astra_db_client,
+            namespace=namespace,
+            setup_mode=setup_mode,
+            pre_delete_collection=pre_delete_collection,
+        )
+
+    def decode_value(self, value: Any) -> Optional[bytes]:
+        if value is None:
+            return None
+        return base64.b64decode(value)
+
+    def encode_value(self, value: Optional[bytes]) -> Any:
+        if value is None:
+            return None
+        return base64.b64encode(value).decode("ascii")
diff --git a/llm/Lib/site-packages/langchain_community/storage/exceptions.py b/llm/Lib/site-packages/langchain_community/storage/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7231de65c45c9ffcc9231dfb5a420e20d31d2a9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/storage/exceptions.py
@@ -0,0 +1,5 @@
+from langchain_core.exceptions import LangChainException
+
+
+class InvalidKeyException(LangChainException):
+    """Raised when a key is invalid; e.g., uses incorrect characters."""
diff --git a/llm/Lib/site-packages/langchain_community/storage/mongodb.py b/llm/Lib/site-packages/langchain_community/storage/mongodb.py
new file mode 100644
index 0000000000000000000000000000000000000000..97447f832175ee956edf503e8fe565eeafab400d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/storage/mongodb.py
@@ -0,0 +1,126 @@
+from typing import Iterator, List, Optional, Sequence, Tuple
+
+from langchain_core.documents import Document
+from langchain_core.stores import BaseStore
+
+
+class MongoDBStore(BaseStore[str, Document]):
+    """BaseStore implementation using MongoDB as the underlying store.
+
+    Examples:
+        Create a MongoDBStore instance and perform operations on it:
+
+        .. code-block:: python
+
+            # Instantiate the MongoDBStore with a MongoDB connection
+            from langchain.storage import MongoDBStore
+
+            mongo_conn_str = "mongodb://localhost:27017/"
+            mongodb_store = MongoDBStore(mongo_conn_str, db_name="test-db",
+                                         collection_name="test-collection")
+
+            # Set values for keys
+            doc1 = Document(...)
+            doc2 = Document(...)
+            mongodb_store.mset([("key1", doc1), ("key2", doc2)])
+
+            # Get values for keys
+            values = mongodb_store.mget(["key1", "key2"])
+            # [doc1, doc2]
+
+            # Iterate over keys
+            for key in mongodb_store.yield_keys():
+                print(key)
+
+            # Delete keys
+            mongodb_store.mdelete(["key1", "key2"])
+    """
+
+    def __init__(
+        self,
+        connection_string: str,
+        db_name: str,
+        collection_name: str,
+        *,
+        client_kwargs: Optional[dict] = None,
+    ) -> None:
+        """Initialize the MongoDBStore with a MongoDB connection string.
+
+        Args:
+            connection_string (str): MongoDB connection string
+            db_name (str): name to use
+            collection_name (str): collection name to use
+            client_kwargs (dict): Keyword arguments to pass to the Mongo client
+        """
+        try:
+            from pymongo import MongoClient
+        except ImportError as e:
+            raise ImportError(
+                "The MongoDBStore requires the pymongo library to be "
+                "installed. "
+                "pip install pymongo"
+            ) from e
+
+        if not connection_string:
+            raise ValueError("connection_string must be provided.")
+        if not db_name:
+            raise ValueError("db_name must be provided.")
+        if not collection_name:
+            raise ValueError("collection_name must be provided.")
+
+        self.client = MongoClient(connection_string, **(client_kwargs or {}))
+        self.collection = self.client[db_name][collection_name]
+
+    def mget(self, keys: Sequence[str]) -> List[Optional[Document]]:
+        """Get the list of documents associated with the given keys.
+
+        Args:
+            keys (list[str]): A list of keys representing Document IDs..
+
+        Returns:
+            list[Document]: A list of Documents corresponding to the provided
+                keys, where each Document is either retrieved successfully or
+                represented as None if not found.
+        """
+        result = self.collection.find({"_id": {"$in": keys}})
+        result_dict = {doc["_id"]: Document(**doc["value"]) for doc in result}
+        return [result_dict.get(key) for key in keys]
+
+    def mset(self, key_value_pairs: Sequence[Tuple[str, Document]]) -> None:
+        """Set the given key-value pairs.
+
+        Args:
+            key_value_pairs (list[tuple[str, Document]]): A list of id-document
+                pairs.
+        Returns:
+            None
+        """
+        from pymongo import UpdateOne
+
+        updates = [{"_id": k, "value": v.__dict__} for k, v in key_value_pairs]
+        self.collection.bulk_write(
+            [UpdateOne({"_id": u["_id"]}, {"$set": u}, upsert=True) for u in updates]
+        )
+
+    def mdelete(self, keys: Sequence[str]) -> None:
+        """Delete the given ids.
+
+        Args:
+            keys (list[str]): A list of keys representing Document IDs..
+        """
+        self.collection.delete_many({"_id": {"$in": keys}})
+
+    def yield_keys(self, prefix: Optional[str] = None) -> Iterator[str]:
+        """Yield keys in the store.
+
+        Args:
+            prefix (str): prefix of keys to retrieve.
+        """
+        if prefix is None:
+            for doc in self.collection.find(projection=["_id"]):
+                yield doc["_id"]
+        else:
+            for doc in self.collection.find(
+                {"_id": {"$regex": f"^{prefix}"}}, projection=["_id"]
+            ):
+                yield doc["_id"]
diff --git a/llm/Lib/site-packages/langchain_community/storage/redis.py b/llm/Lib/site-packages/langchain_community/storage/redis.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e1b4fa56c6b1b641e0bef3a3e4c620edea06698
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/storage/redis.py
@@ -0,0 +1,141 @@
+from typing import Any, Iterator, List, Optional, Sequence, Tuple, cast
+
+from langchain_core.stores import ByteStore
+
+from langchain_community.utilities.redis import get_client
+
+
+class RedisStore(ByteStore):
+    """BaseStore implementation using Redis as the underlying store.
+
+    Examples:
+        Create a RedisStore instance and perform operations on it:
+
+        .. code-block:: python
+
+            # Instantiate the RedisStore with a Redis connection
+            from langchain_community.storage import RedisStore
+            from langchain_community.utilities.redis import get_client
+
+            client = get_client('redis://localhost:6379')
+            redis_store = RedisStore(client)
+
+            # Set values for keys
+            redis_store.mset([("key1", b"value1"), ("key2", b"value2")])
+
+            # Get values for keys
+            values = redis_store.mget(["key1", "key2"])
+            # [b"value1", b"value2"]
+
+            # Delete keys
+            redis_store.mdelete(["key1"])
+
+            # Iterate over keys
+            for key in redis_store.yield_keys():
+                print(key)  # noqa: T201
+    """
+
+    def __init__(
+        self,
+        *,
+        client: Any = None,
+        redis_url: Optional[str] = None,
+        client_kwargs: Optional[dict] = None,
+        ttl: Optional[int] = None,
+        namespace: Optional[str] = None,
+    ) -> None:
+        """Initialize the RedisStore with a Redis connection.
+
+        Must provide either a Redis client or a redis_url with optional client_kwargs.
+
+        Args:
+            client: A Redis connection instance
+            redis_url: redis url
+            client_kwargs: Keyword arguments to pass to the Redis client
+            ttl: time to expire keys in seconds if provided,
+                 if None keys will never expire
+            namespace: if provided, all keys will be prefixed with this namespace
+        """
+        try:
+            from redis import Redis
+        except ImportError as e:
+            raise ImportError(
+                "The RedisStore requires the redis library to be installed. "
+                "pip install redis"
+            ) from e
+
+        if client and redis_url or client and client_kwargs:
+            raise ValueError(
+                "Either a Redis client or a redis_url with optional client_kwargs "
+                "must be provided, but not both."
+            )
+
+        if client:
+            if not isinstance(client, Redis):
+                raise TypeError(
+                    f"Expected Redis client, got {type(client).__name__} instead."
+                )
+            _client = client
+        else:
+            if not redis_url:
+                raise ValueError(
+                    "Either a Redis client or a redis_url must be provided."
+                )
+            _client = get_client(redis_url, **(client_kwargs or {}))
+
+        self.client = _client
+
+        if not isinstance(ttl, int) and ttl is not None:
+            raise TypeError(f"Expected int or None, got {type(ttl)} instead.")
+
+        self.ttl = ttl
+        self.namespace = namespace
+
+    def _get_prefixed_key(self, key: str) -> str:
+        """Get the key with the namespace prefix.
+
+        Args:
+            key (str): The original key.
+
+        Returns:
+            str: The key with the namespace prefix.
+        """
+        delimiter = "/"
+        if self.namespace:
+            return f"{self.namespace}{delimiter}{key}"
+        return key
+
+    def mget(self, keys: Sequence[str]) -> List[Optional[bytes]]:
+        """Get the values associated with the given keys."""
+        return cast(
+            List[Optional[bytes]],
+            self.client.mget([self._get_prefixed_key(key) for key in keys]),
+        )
+
+    def mset(self, key_value_pairs: Sequence[Tuple[str, bytes]]) -> None:
+        """Set the given key-value pairs."""
+        pipe = self.client.pipeline()
+
+        for key, value in key_value_pairs:
+            pipe.set(self._get_prefixed_key(key), value, ex=self.ttl)
+        pipe.execute()
+
+    def mdelete(self, keys: Sequence[str]) -> None:
+        """Delete the given keys."""
+        _keys = [self._get_prefixed_key(key) for key in keys]
+        self.client.delete(*_keys)
+
+    def yield_keys(self, *, prefix: Optional[str] = None) -> Iterator[str]:
+        """Yield keys in the store."""
+        if prefix:
+            pattern = self._get_prefixed_key(prefix)
+        else:
+            pattern = self._get_prefixed_key("*")
+        scan_iter = cast(Iterator[bytes], self.client.scan_iter(match=pattern))
+        for key in scan_iter:
+            decoded_key = key.decode("utf-8")
+            if self.namespace:
+                relative_key = decoded_key[len(self.namespace) + 1 :]
+                yield relative_key
+            else:
+                yield decoded_key
diff --git a/llm/Lib/site-packages/langchain_community/storage/upstash_redis.py b/llm/Lib/site-packages/langchain_community/storage/upstash_redis.py
new file mode 100644
index 0000000000000000000000000000000000000000..ebe69c4dfb7fa0f0507597ca7f4d300e84b37fd9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/storage/upstash_redis.py
@@ -0,0 +1,174 @@
+from typing import Any, Iterator, List, Optional, Sequence, Tuple, cast
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.stores import BaseStore, ByteStore
+
+
+class _UpstashRedisStore(BaseStore[str, str]):
+    """BaseStore implementation using Upstash Redis as the underlying store."""
+
+    def __init__(
+        self,
+        *,
+        client: Any = None,
+        url: Optional[str] = None,
+        token: Optional[str] = None,
+        ttl: Optional[int] = None,
+        namespace: Optional[str] = None,
+    ) -> None:
+        """Initialize the UpstashRedisStore with HTTP API.
+
+        Must provide either an Upstash Redis client or a url.
+
+        Args:
+            client: An Upstash Redis instance
+            url: UPSTASH_REDIS_REST_URL
+            token: UPSTASH_REDIS_REST_TOKEN
+            ttl: time to expire keys in seconds if provided,
+                 if None keys will never expire
+            namespace: if provided, all keys will be prefixed with this namespace
+        """
+        try:
+            from upstash_redis import Redis
+        except ImportError as e:
+            raise ImportError(
+                "UpstashRedisStore requires the upstash_redis library to be installed. "
+                "pip install upstash_redis"
+            ) from e
+
+        if client and url:
+            raise ValueError(
+                "Either an Upstash Redis client or a url must be provided, not both."
+            )
+
+        if client:
+            if not isinstance(client, Redis):
+                raise TypeError(
+                    f"Expected Upstash Redis client, got {type(client).__name__}."
+                )
+            _client = client
+        else:
+            if not url or not token:
+                raise ValueError(
+                    "Either an Upstash Redis client or url and token must be provided."
+                )
+            _client = Redis(url=url, token=token)
+
+        self.client = _client
+
+        if not isinstance(ttl, int) and ttl is not None:
+            raise TypeError(f"Expected int or None, got {type(ttl)} instead.")
+
+        self.ttl = ttl
+        self.namespace = namespace
+
+    def _get_prefixed_key(self, key: str) -> str:
+        """Get the key with the namespace prefix.
+
+        Args:
+            key (str): The original key.
+
+        Returns:
+            str: The key with the namespace prefix.
+        """
+        delimiter = "/"
+        if self.namespace:
+            return f"{self.namespace}{delimiter}{key}"
+        return key
+
+    def mget(self, keys: Sequence[str]) -> List[Optional[str]]:
+        """Get the values associated with the given keys."""
+
+        keys = [self._get_prefixed_key(key) for key in keys]
+        return cast(
+            List[Optional[str]],
+            self.client.mget(*keys),
+        )
+
+    def mset(self, key_value_pairs: Sequence[Tuple[str, str]]) -> None:
+        """Set the given key-value pairs."""
+        for key, value in key_value_pairs:
+            self.client.set(self._get_prefixed_key(key), value, ex=self.ttl)
+
+    def mdelete(self, keys: Sequence[str]) -> None:
+        """Delete the given keys."""
+        _keys = [self._get_prefixed_key(key) for key in keys]
+        self.client.delete(*_keys)
+
+    def yield_keys(self, *, prefix: Optional[str] = None) -> Iterator[str]:
+        """Yield keys in the store."""
+        if prefix:
+            pattern = self._get_prefixed_key(prefix)
+        else:
+            pattern = self._get_prefixed_key("*")
+
+        cursor, keys = self.client.scan(0, match=pattern)
+        for key in keys:
+            if self.namespace:
+                relative_key = key[len(self.namespace) + 1 :]
+                yield relative_key
+            else:
+                yield key
+
+        while cursor != 0:
+            cursor, keys = self.client.scan(cursor, match=pattern)
+            for key in keys:
+                if self.namespace:
+                    relative_key = key[len(self.namespace) + 1 :]
+                    yield relative_key
+                else:
+                    yield key
+
+
+@deprecated("0.0.1", alternative="UpstashRedisByteStore")
+class UpstashRedisStore(_UpstashRedisStore):
+    """
+    BaseStore implementation using Upstash Redis
+    as the underlying store to store strings.
+
+    Deprecated in favor of the more generic UpstashRedisByteStore.
+    """
+
+
+class UpstashRedisByteStore(ByteStore):
+    """
+    BaseStore implementation using Upstash Redis
+    as the underlying store to store raw bytes.
+    """
+
+    def __init__(
+        self,
+        *,
+        client: Any = None,
+        url: Optional[str] = None,
+        token: Optional[str] = None,
+        ttl: Optional[int] = None,
+        namespace: Optional[str] = None,
+    ) -> None:
+        self.underlying_store = _UpstashRedisStore(
+            client=client, url=url, token=token, ttl=ttl, namespace=namespace
+        )
+
+    def mget(self, keys: Sequence[str]) -> List[Optional[bytes]]:
+        """Get the values associated with the given keys."""
+        return [
+            value.encode("utf-8") if value is not None else None
+            for value in self.underlying_store.mget(keys)
+        ]
+
+    def mset(self, key_value_pairs: Sequence[Tuple[str, bytes]]) -> None:
+        """Set the given key-value pairs."""
+        self.underlying_store.mset(
+            [
+                (k, v.decode("utf-8")) if v is not None else None
+                for k, v in key_value_pairs
+            ]
+        )
+
+    def mdelete(self, keys: Sequence[str]) -> None:
+        """Delete the given keys."""
+        self.underlying_store.mdelete(keys)
+
+    def yield_keys(self, *, prefix: Optional[str] = None) -> Iterator[str]:
+        """Yield keys in the store."""
+        yield from self.underlying_store.yield_keys(prefix=prefix)
diff --git a/llm/Lib/site-packages/langchain_community/tools/__init__.py b/llm/Lib/site-packages/langchain_community/tools/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..48db105fcd978bc7a0b4c396640c4e3f2d7a6cea
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/__init__.py
@@ -0,0 +1,600 @@
+"""**Tools** are classes that an Agent uses to interact with the world.
+
+Each tool has a **description**. Agent uses the description to choose the right
+tool for the job.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    ToolMetaclass --> BaseTool --> <name>Tool  # Examples: AIPluginTool, BaseGraphQLTool
+                                   <name>      # Examples: BraveSearch, HumanInputRun
+
+**Main helpers:**
+
+.. code-block::
+
+    CallbackManagerForToolRun, AsyncCallbackManagerForToolRun
+"""
+
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_core.tools import (
+        BaseTool,  # noqa: F401
+        StructuredTool,  # noqa: F401
+        Tool,  # noqa: F401
+        tool,  # noqa: F401
+    )
+
+    from langchain_community.tools.ainetwork.app import (
+        AINAppOps,  # noqa: F401
+    )
+    from langchain_community.tools.ainetwork.owner import (
+        AINOwnerOps,  # noqa: F401
+    )
+    from langchain_community.tools.ainetwork.rule import (
+        AINRuleOps,  # noqa: F401
+    )
+    from langchain_community.tools.ainetwork.transfer import (
+        AINTransfer,  # noqa: F401
+    )
+    from langchain_community.tools.ainetwork.value import (
+        AINValueOps,  # noqa: F401
+    )
+    from langchain_community.tools.arxiv.tool import (
+        ArxivQueryRun,  # noqa: F401
+    )
+    from langchain_community.tools.azure_ai_services import (
+        AzureAiServicesDocumentIntelligenceTool,  # noqa: F401
+        AzureAiServicesImageAnalysisTool,  # noqa: F401
+        AzureAiServicesSpeechToTextTool,  # noqa: F401
+        AzureAiServicesTextAnalyticsForHealthTool,  # noqa: F401
+        AzureAiServicesTextToSpeechTool,  # noqa: F401
+    )
+    from langchain_community.tools.azure_cognitive_services import (
+        AzureCogsFormRecognizerTool,  # noqa: F401
+        AzureCogsImageAnalysisTool,  # noqa: F401
+        AzureCogsSpeech2TextTool,  # noqa: F401
+        AzureCogsText2SpeechTool,  # noqa: F401
+        AzureCogsTextAnalyticsHealthTool,  # noqa: F401
+    )
+    from langchain_community.tools.bearly.tool import (
+        BearlyInterpreterTool,  # noqa: F401
+    )
+    from langchain_community.tools.bing_search.tool import (
+        BingSearchResults,  # noqa: F401
+        BingSearchRun,  # noqa: F401
+    )
+    from langchain_community.tools.brave_search.tool import (
+        BraveSearch,  # noqa: F401
+    )
+    from langchain_community.tools.cogniswitch.tool import (
+        CogniswitchKnowledgeRequest,  # noqa: F401
+        CogniswitchKnowledgeSourceFile,  # noqa: F401
+        CogniswitchKnowledgeSourceURL,  # noqa: F401
+        CogniswitchKnowledgeStatus,  # noqa: F401
+    )
+    from langchain_community.tools.connery import (
+        ConneryAction,  # noqa: F401
+    )
+    from langchain_community.tools.convert_to_openai import (
+        format_tool_to_openai_function,  # noqa: F401
+    )
+    from langchain_community.tools.ddg_search.tool import (
+        DuckDuckGoSearchResults,  # noqa: F401
+        DuckDuckGoSearchRun,  # noqa: F401
+    )
+    from langchain_community.tools.e2b_data_analysis.tool import (
+        E2BDataAnalysisTool,  # noqa: F401
+    )
+    from langchain_community.tools.edenai import (
+        EdenAiExplicitImageTool,  # noqa: F401
+        EdenAiObjectDetectionTool,  # noqa: F401
+        EdenAiParsingIDTool,  # noqa: F401
+        EdenAiParsingInvoiceTool,  # noqa: F401
+        EdenAiSpeechToTextTool,  # noqa: F401
+        EdenAiTextModerationTool,  # noqa: F401
+        EdenAiTextToSpeechTool,  # noqa: F401
+        EdenaiTool,  # noqa: F401
+    )
+    from langchain_community.tools.eleven_labs.text2speech import (
+        ElevenLabsText2SpeechTool,  # noqa: F401
+    )
+    from langchain_community.tools.file_management import (
+        CopyFileTool,  # noqa: F401
+        DeleteFileTool,  # noqa: F401
+        FileSearchTool,  # noqa: F401
+        ListDirectoryTool,  # noqa: F401
+        MoveFileTool,  # noqa: F401
+        ReadFileTool,  # noqa: F401
+        WriteFileTool,  # noqa: F401
+    )
+    from langchain_community.tools.gmail import (
+        GmailCreateDraft,  # noqa: F401
+        GmailGetMessage,  # noqa: F401
+        GmailGetThread,  # noqa: F401
+        GmailSearch,  # noqa: F401
+        GmailSendMessage,  # noqa: F401
+    )
+    from langchain_community.tools.google_cloud.texttospeech import (
+        GoogleCloudTextToSpeechTool,  # noqa: F401
+    )
+    from langchain_community.tools.google_places.tool import (
+        GooglePlacesTool,  # noqa: F401
+    )
+    from langchain_community.tools.google_search.tool import (
+        GoogleSearchResults,  # noqa: F401
+        GoogleSearchRun,  # noqa: F401
+    )
+    from langchain_community.tools.google_serper.tool import (
+        GoogleSerperResults,  # noqa: F401
+        GoogleSerperRun,  # noqa: F401
+    )
+    from langchain_community.tools.graphql.tool import (
+        BaseGraphQLTool,  # noqa: F401
+    )
+    from langchain_community.tools.human.tool import (
+        HumanInputRun,  # noqa: F401
+    )
+    from langchain_community.tools.ifttt import (
+        IFTTTWebhook,  # noqa: F401
+    )
+    from langchain_community.tools.interaction.tool import (
+        StdInInquireTool,  # noqa: F401
+    )
+    from langchain_community.tools.jira.tool import (
+        JiraAction,  # noqa: F401
+    )
+    from langchain_community.tools.json.tool import (
+        JsonGetValueTool,  # noqa: F401
+        JsonListKeysTool,  # noqa: F401
+    )
+    from langchain_community.tools.merriam_webster.tool import (
+        MerriamWebsterQueryRun,  # noqa: F401
+    )
+    from langchain_community.tools.metaphor_search import (
+        MetaphorSearchResults,  # noqa: F401
+    )
+    from langchain_community.tools.nasa.tool import (
+        NasaAction,  # noqa: F401
+    )
+    from langchain_community.tools.office365.create_draft_message import (
+        O365CreateDraftMessage,  # noqa: F401
+    )
+    from langchain_community.tools.office365.events_search import (
+        O365SearchEvents,  # noqa: F401
+    )
+    from langchain_community.tools.office365.messages_search import (
+        O365SearchEmails,  # noqa: F401
+    )
+    from langchain_community.tools.office365.send_event import (
+        O365SendEvent,  # noqa: F401
+    )
+    from langchain_community.tools.office365.send_message import (
+        O365SendMessage,  # noqa: F401
+    )
+    from langchain_community.tools.office365.utils import (
+        authenticate,  # noqa: F401
+    )
+    from langchain_community.tools.openapi.utils.api_models import (
+        APIOperation,  # noqa: F401
+    )
+    from langchain_community.tools.openapi.utils.openapi_utils import (
+        OpenAPISpec,  # noqa: F401
+    )
+    from langchain_community.tools.openweathermap.tool import (
+        OpenWeatherMapQueryRun,  # noqa: F401
+    )
+    from langchain_community.tools.playwright import (
+        ClickTool,  # noqa: F401
+        CurrentWebPageTool,  # noqa: F401
+        ExtractHyperlinksTool,  # noqa: F401
+        ExtractTextTool,  # noqa: F401
+        GetElementsTool,  # noqa: F401
+        NavigateBackTool,  # noqa: F401
+        NavigateTool,  # noqa: F401
+    )
+    from langchain_community.tools.plugin import (
+        AIPluginTool,  # noqa: F401
+    )
+    from langchain_community.tools.polygon.aggregates import (
+        PolygonAggregates,  # noqa: F401
+    )
+    from langchain_community.tools.polygon.financials import (
+        PolygonFinancials,  # noqa: F401
+    )
+    from langchain_community.tools.polygon.last_quote import (
+        PolygonLastQuote,  # noqa: F401
+    )
+    from langchain_community.tools.polygon.ticker_news import (
+        PolygonTickerNews,  # noqa: F401
+    )
+    from langchain_community.tools.powerbi.tool import (
+        InfoPowerBITool,  # noqa: F401
+        ListPowerBITool,  # noqa: F401
+        QueryPowerBITool,  # noqa: F401
+    )
+    from langchain_community.tools.pubmed.tool import (
+        PubmedQueryRun,  # noqa: F401
+    )
+    from langchain_community.tools.reddit_search.tool import (
+        RedditSearchRun,  # noqa: F401
+        RedditSearchSchema,  # noqa: F401
+    )
+    from langchain_community.tools.requests.tool import (
+        BaseRequestsTool,  # noqa: F401
+        RequestsDeleteTool,  # noqa: F401
+        RequestsGetTool,  # noqa: F401
+        RequestsPatchTool,  # noqa: F401
+        RequestsPostTool,  # noqa: F401
+        RequestsPutTool,  # noqa: F401
+    )
+    from langchain_community.tools.scenexplain.tool import (
+        SceneXplainTool,  # noqa: F401
+    )
+    from langchain_community.tools.searchapi.tool import (
+        SearchAPIResults,  # noqa: F401
+        SearchAPIRun,  # noqa: F401
+    )
+    from langchain_community.tools.searx_search.tool import (
+        SearxSearchResults,  # noqa: F401
+        SearxSearchRun,  # noqa: F401
+    )
+    from langchain_community.tools.shell.tool import (
+        ShellTool,  # noqa: F401
+    )
+    from langchain_community.tools.slack.get_channel import (
+        SlackGetChannel,  # noqa: F401
+    )
+    from langchain_community.tools.slack.get_message import (
+        SlackGetMessage,  # noqa: F401
+    )
+    from langchain_community.tools.slack.schedule_message import (
+        SlackScheduleMessage,  # noqa: F401
+    )
+    from langchain_community.tools.slack.send_message import (
+        SlackSendMessage,  # noqa: F401
+    )
+    from langchain_community.tools.sleep.tool import (
+        SleepTool,  # noqa: F401
+    )
+    from langchain_community.tools.spark_sql.tool import (
+        BaseSparkSQLTool,  # noqa: F401
+        InfoSparkSQLTool,  # noqa: F401
+        ListSparkSQLTool,  # noqa: F401
+        QueryCheckerTool,  # noqa: F401
+        QuerySparkSQLTool,  # noqa: F401
+    )
+    from langchain_community.tools.sql_database.tool import (
+        BaseSQLDatabaseTool,  # noqa: F401
+        InfoSQLDatabaseTool,  # noqa: F401
+        ListSQLDatabaseTool,  # noqa: F401
+        QuerySQLCheckerTool,  # noqa: F401
+        QuerySQLDataBaseTool,  # noqa: F401
+    )
+    from langchain_community.tools.stackexchange.tool import (
+        StackExchangeTool,  # noqa: F401
+    )
+    from langchain_community.tools.steam.tool import (
+        SteamWebAPIQueryRun,  # noqa: F401
+    )
+    from langchain_community.tools.steamship_image_generation import (
+        SteamshipImageGenerationTool,  # noqa: F401
+    )
+    from langchain_community.tools.vectorstore.tool import (
+        VectorStoreQATool,  # noqa: F401
+        VectorStoreQAWithSourcesTool,  # noqa: F401
+    )
+    from langchain_community.tools.wikipedia.tool import (
+        WikipediaQueryRun,  # noqa: F401
+    )
+    from langchain_community.tools.wolfram_alpha.tool import (
+        WolframAlphaQueryRun,  # noqa: F401
+    )
+    from langchain_community.tools.yahoo_finance_news import (
+        YahooFinanceNewsTool,  # noqa: F401
+    )
+    from langchain_community.tools.you.tool import (
+        YouSearchTool,  # noqa: F401
+    )
+    from langchain_community.tools.youtube.search import (
+        YouTubeSearchTool,  # noqa: F401
+    )
+    from langchain_community.tools.zapier.tool import (
+        ZapierNLAListActions,  # noqa: F401
+        ZapierNLARunAction,  # noqa: F401
+    )
+
+__all__ = [
+    "AINAppOps",
+    "AINOwnerOps",
+    "AINRuleOps",
+    "AINTransfer",
+    "AINValueOps",
+    "AIPluginTool",
+    "APIOperation",
+    "ArxivQueryRun",
+    "AzureAiServicesDocumentIntelligenceTool",
+    "AzureAiServicesImageAnalysisTool",
+    "AzureAiServicesSpeechToTextTool",
+    "AzureAiServicesTextAnalyticsForHealthTool",
+    "AzureAiServicesTextToSpeechTool",
+    "AzureCogsFormRecognizerTool",
+    "AzureCogsImageAnalysisTool",
+    "AzureCogsSpeech2TextTool",
+    "AzureCogsText2SpeechTool",
+    "AzureCogsTextAnalyticsHealthTool",
+    "BaseGraphQLTool",
+    "BaseRequestsTool",
+    "BaseSQLDatabaseTool",
+    "BaseSparkSQLTool",
+    "BaseTool",
+    "BearlyInterpreterTool",
+    "BingSearchResults",
+    "BingSearchRun",
+    "BraveSearch",
+    "ClickTool",
+    "CogniswitchKnowledgeRequest",
+    "CogniswitchKnowledgeSourceFile",
+    "CogniswitchKnowledgeSourceURL",
+    "CogniswitchKnowledgeStatus",
+    "ConneryAction",
+    "CopyFileTool",
+    "CurrentWebPageTool",
+    "DeleteFileTool",
+    "DuckDuckGoSearchResults",
+    "DuckDuckGoSearchRun",
+    "E2BDataAnalysisTool",
+    "EdenAiExplicitImageTool",
+    "EdenAiObjectDetectionTool",
+    "EdenAiParsingIDTool",
+    "EdenAiParsingInvoiceTool",
+    "EdenAiSpeechToTextTool",
+    "EdenAiTextModerationTool",
+    "EdenAiTextToSpeechTool",
+    "EdenaiTool",
+    "ElevenLabsText2SpeechTool",
+    "ExtractHyperlinksTool",
+    "ExtractTextTool",
+    "FileSearchTool",
+    "GetElementsTool",
+    "GmailCreateDraft",
+    "GmailGetMessage",
+    "GmailGetThread",
+    "GmailSearch",
+    "GmailSendMessage",
+    "GoogleCloudTextToSpeechTool",
+    "GooglePlacesTool",
+    "GoogleSearchResults",
+    "GoogleSearchRun",
+    "GoogleSerperResults",
+    "GoogleSerperRun",
+    "HumanInputRun",
+    "IFTTTWebhook",
+    "InfoPowerBITool",
+    "InfoSQLDatabaseTool",
+    "InfoSparkSQLTool",
+    "JiraAction",
+    "JsonGetValueTool",
+    "JsonListKeysTool",
+    "ListDirectoryTool",
+    "ListPowerBITool",
+    "ListSQLDatabaseTool",
+    "ListSparkSQLTool",
+    "MerriamWebsterQueryRun",
+    "MetaphorSearchResults",
+    "MoveFileTool",
+    "NasaAction",
+    "NavigateBackTool",
+    "NavigateTool",
+    "O365CreateDraftMessage",
+    "O365SearchEmails",
+    "O365SearchEvents",
+    "O365SendEvent",
+    "O365SendMessage",
+    "OpenAPISpec",
+    "OpenWeatherMapQueryRun",
+    "PolygonAggregates",
+    "PolygonFinancials",
+    "PolygonLastQuote",
+    "PolygonTickerNews",
+    "PubmedQueryRun",
+    "QueryCheckerTool",
+    "QueryPowerBITool",
+    "QuerySQLCheckerTool",
+    "QuerySQLDataBaseTool",
+    "QuerySparkSQLTool",
+    "ReadFileTool",
+    "RedditSearchRun",
+    "RedditSearchSchema",
+    "RequestsDeleteTool",
+    "RequestsGetTool",
+    "RequestsPatchTool",
+    "RequestsPostTool",
+    "RequestsPutTool",
+    "SceneXplainTool",
+    "SearchAPIResults",
+    "SearchAPIRun",
+    "SearxSearchResults",
+    "SearxSearchRun",
+    "ShellTool",
+    "SlackGetChannel",
+    "SlackGetMessage",
+    "SlackScheduleMessage",
+    "SlackSendMessage",
+    "SleepTool",
+    "StackExchangeTool",
+    "StdInInquireTool",
+    "SteamWebAPIQueryRun",
+    "SteamshipImageGenerationTool",
+    "StructuredTool",
+    "Tool",
+    "VectorStoreQATool",
+    "VectorStoreQAWithSourcesTool",
+    "WikipediaQueryRun",
+    "WolframAlphaQueryRun",
+    "WriteFileTool",
+    "YahooFinanceNewsTool",
+    "YouSearchTool",
+    "YouTubeSearchTool",
+    "ZapierNLAListActions",
+    "ZapierNLARunAction",
+    "authenticate",
+    "format_tool_to_openai_function",
+    "tool",
+]
+
+# Used for internal purposes
+_DEPRECATED_TOOLS = {"PythonAstREPLTool", "PythonREPLTool"}
+
+_module_lookup = {
+    "AINAppOps": "langchain_community.tools.ainetwork.app",
+    "AINOwnerOps": "langchain_community.tools.ainetwork.owner",
+    "AINRuleOps": "langchain_community.tools.ainetwork.rule",
+    "AINTransfer": "langchain_community.tools.ainetwork.transfer",
+    "AINValueOps": "langchain_community.tools.ainetwork.value",
+    "AIPluginTool": "langchain_community.tools.plugin",
+    "APIOperation": "langchain_community.tools.openapi.utils.api_models",
+    "ArxivQueryRun": "langchain_community.tools.arxiv.tool",
+    "AzureAiServicesDocumentIntelligenceTool": "langchain_community.tools.azure_ai_services",  # noqa: E501
+    "AzureAiServicesImageAnalysisTool": "langchain_community.tools.azure_ai_services",
+    "AzureAiServicesSpeechToTextTool": "langchain_community.tools.azure_ai_services",
+    "AzureAiServicesTextToSpeechTool": "langchain_community.tools.azure_ai_services",
+    "AzureAiServicesTextAnalyticsForHealthTool": "langchain_community.tools.azure_ai_services",  # noqa: E501
+    "AzureCogsFormRecognizerTool": "langchain_community.tools.azure_cognitive_services",
+    "AzureCogsImageAnalysisTool": "langchain_community.tools.azure_cognitive_services",
+    "AzureCogsSpeech2TextTool": "langchain_community.tools.azure_cognitive_services",
+    "AzureCogsText2SpeechTool": "langchain_community.tools.azure_cognitive_services",
+    "AzureCogsTextAnalyticsHealthTool": "langchain_community.tools.azure_cognitive_services",  # noqa: E501
+    "BaseGraphQLTool": "langchain_community.tools.graphql.tool",
+    "BaseRequestsTool": "langchain_community.tools.requests.tool",
+    "BaseSQLDatabaseTool": "langchain_community.tools.sql_database.tool",
+    "BaseSparkSQLTool": "langchain_community.tools.spark_sql.tool",
+    "BaseTool": "langchain_core.tools",
+    "BearlyInterpreterTool": "langchain_community.tools.bearly.tool",
+    "BingSearchResults": "langchain_community.tools.bing_search.tool",
+    "BingSearchRun": "langchain_community.tools.bing_search.tool",
+    "BraveSearch": "langchain_community.tools.brave_search.tool",
+    "ClickTool": "langchain_community.tools.playwright",
+    "CogniswitchKnowledgeRequest": "langchain_community.tools.cogniswitch.tool",
+    "CogniswitchKnowledgeSourceFile": "langchain_community.tools.cogniswitch.tool",
+    "CogniswitchKnowledgeSourceURL": "langchain_community.tools.cogniswitch.tool",
+    "CogniswitchKnowledgeStatus": "langchain_community.tools.cogniswitch.tool",
+    "ConneryAction": "langchain_community.tools.connery",
+    "CopyFileTool": "langchain_community.tools.file_management",
+    "CurrentWebPageTool": "langchain_community.tools.playwright",
+    "DataheraldTextToSQL": "langchain_community.tools.dataherald.tool",
+    "DeleteFileTool": "langchain_community.tools.file_management",
+    "DuckDuckGoSearchResults": "langchain_community.tools.ddg_search.tool",
+    "DuckDuckGoSearchRun": "langchain_community.tools.ddg_search.tool",
+    "E2BDataAnalysisTool": "langchain_community.tools.e2b_data_analysis.tool",
+    "EdenAiExplicitImageTool": "langchain_community.tools.edenai",
+    "EdenAiObjectDetectionTool": "langchain_community.tools.edenai",
+    "EdenAiParsingIDTool": "langchain_community.tools.edenai",
+    "EdenAiParsingInvoiceTool": "langchain_community.tools.edenai",
+    "EdenAiSpeechToTextTool": "langchain_community.tools.edenai",
+    "EdenAiTextModerationTool": "langchain_community.tools.edenai",
+    "EdenAiTextToSpeechTool": "langchain_community.tools.edenai",
+    "EdenaiTool": "langchain_community.tools.edenai",
+    "ElevenLabsText2SpeechTool": "langchain_community.tools.eleven_labs.text2speech",
+    "ExtractHyperlinksTool": "langchain_community.tools.playwright",
+    "ExtractTextTool": "langchain_community.tools.playwright",
+    "FileSearchTool": "langchain_community.tools.file_management",
+    "GetElementsTool": "langchain_community.tools.playwright",
+    "GmailCreateDraft": "langchain_community.tools.gmail",
+    "GmailGetMessage": "langchain_community.tools.gmail",
+    "GmailGetThread": "langchain_community.tools.gmail",
+    "GmailSearch": "langchain_community.tools.gmail",
+    "GmailSendMessage": "langchain_community.tools.gmail",
+    "GoogleCloudTextToSpeechTool": "langchain_community.tools.google_cloud.texttospeech",  # noqa: E501
+    "GooglePlacesTool": "langchain_community.tools.google_places.tool",
+    "GoogleSearchResults": "langchain_community.tools.google_search.tool",
+    "GoogleSearchRun": "langchain_community.tools.google_search.tool",
+    "GoogleSerperResults": "langchain_community.tools.google_serper.tool",
+    "GoogleSerperRun": "langchain_community.tools.google_serper.tool",
+    "HumanInputRun": "langchain_community.tools.human.tool",
+    "IFTTTWebhook": "langchain_community.tools.ifttt",
+    "InfoPowerBITool": "langchain_community.tools.powerbi.tool",
+    "InfoSQLDatabaseTool": "langchain_community.tools.sql_database.tool",
+    "InfoSparkSQLTool": "langchain_community.tools.spark_sql.tool",
+    "JiraAction": "langchain_community.tools.jira.tool",
+    "JsonGetValueTool": "langchain_community.tools.json.tool",
+    "JsonListKeysTool": "langchain_community.tools.json.tool",
+    "ListDirectoryTool": "langchain_community.tools.file_management",
+    "ListPowerBITool": "langchain_community.tools.powerbi.tool",
+    "ListSQLDatabaseTool": "langchain_community.tools.sql_database.tool",
+    "ListSparkSQLTool": "langchain_community.tools.spark_sql.tool",
+    "MerriamWebsterQueryRun": "langchain_community.tools.merriam_webster.tool",
+    "MetaphorSearchResults": "langchain_community.tools.metaphor_search",
+    "MoveFileTool": "langchain_community.tools.file_management",
+    "NasaAction": "langchain_community.tools.nasa.tool",
+    "NavigateBackTool": "langchain_community.tools.playwright",
+    "NavigateTool": "langchain_community.tools.playwright",
+    "O365CreateDraftMessage": "langchain_community.tools.office365.create_draft_message",  # noqa: E501
+    "O365SearchEmails": "langchain_community.tools.office365.messages_search",
+    "O365SearchEvents": "langchain_community.tools.office365.events_search",
+    "O365SendEvent": "langchain_community.tools.office365.send_event",
+    "O365SendMessage": "langchain_community.tools.office365.send_message",
+    "OpenAPISpec": "langchain_community.tools.openapi.utils.openapi_utils",
+    "OpenWeatherMapQueryRun": "langchain_community.tools.openweathermap.tool",
+    "PolygonAggregates": "langchain_community.tools.polygon.aggregates",
+    "PolygonFinancials": "langchain_community.tools.polygon.financials",
+    "PolygonLastQuote": "langchain_community.tools.polygon.last_quote",
+    "PolygonTickerNews": "langchain_community.tools.polygon.ticker_news",
+    "PubmedQueryRun": "langchain_community.tools.pubmed.tool",
+    "QueryCheckerTool": "langchain_community.tools.spark_sql.tool",
+    "QueryPowerBITool": "langchain_community.tools.powerbi.tool",
+    "QuerySQLCheckerTool": "langchain_community.tools.sql_database.tool",
+    "QuerySQLDataBaseTool": "langchain_community.tools.sql_database.tool",
+    "QuerySparkSQLTool": "langchain_community.tools.spark_sql.tool",
+    "ReadFileTool": "langchain_community.tools.file_management",
+    "RedditSearchRun": "langchain_community.tools.reddit_search.tool",
+    "RedditSearchSchema": "langchain_community.tools.reddit_search.tool",
+    "RequestsDeleteTool": "langchain_community.tools.requests.tool",
+    "RequestsGetTool": "langchain_community.tools.requests.tool",
+    "RequestsPatchTool": "langchain_community.tools.requests.tool",
+    "RequestsPostTool": "langchain_community.tools.requests.tool",
+    "RequestsPutTool": "langchain_community.tools.requests.tool",
+    "SceneXplainTool": "langchain_community.tools.scenexplain.tool",
+    "SearchAPIResults": "langchain_community.tools.searchapi.tool",
+    "SearchAPIRun": "langchain_community.tools.searchapi.tool",
+    "SearxSearchResults": "langchain_community.tools.searx_search.tool",
+    "SearxSearchRun": "langchain_community.tools.searx_search.tool",
+    "ShellTool": "langchain_community.tools.shell.tool",
+    "SlackGetChannel": "langchain_community.tools.slack.get_channel",
+    "SlackGetMessage": "langchain_community.tools.slack.get_message",
+    "SlackScheduleMessage": "langchain_community.tools.slack.schedule_message",
+    "SlackSendMessage": "langchain_community.tools.slack.send_message",
+    "SleepTool": "langchain_community.tools.sleep.tool",
+    "StackExchangeTool": "langchain_community.tools.stackexchange.tool",
+    "StdInInquireTool": "langchain_community.tools.interaction.tool",
+    "SteamWebAPIQueryRun": "langchain_community.tools.steam.tool",
+    "SteamshipImageGenerationTool": "langchain_community.tools.steamship_image_generation",  # noqa: E501
+    "StructuredTool": "langchain_core.tools",
+    "Tool": "langchain_core.tools",
+    "VectorStoreQATool": "langchain_community.tools.vectorstore.tool",
+    "VectorStoreQAWithSourcesTool": "langchain_community.tools.vectorstore.tool",
+    "WikipediaQueryRun": "langchain_community.tools.wikipedia.tool",
+    "WolframAlphaQueryRun": "langchain_community.tools.wolfram_alpha.tool",
+    "WriteFileTool": "langchain_community.tools.file_management",
+    "YahooFinanceNewsTool": "langchain_community.tools.yahoo_finance_news",
+    "YouSearchTool": "langchain_community.tools.you.tool",
+    "YouTubeSearchTool": "langchain_community.tools.youtube.search",
+    "ZapierNLAListActions": "langchain_community.tools.zapier.tool",
+    "ZapierNLARunAction": "langchain_community.tools.zapier.tool",
+    "authenticate": "langchain_community.tools.office365.utils",
+    "format_tool_to_openai_function": "langchain_community.tools.convert_to_openai",
+    "tool": "langchain_core.tools",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/tools/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a423441737e6ff7ee1f89d16cdf7d614d0aaa127
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/__pycache__/convert_to_openai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/__pycache__/convert_to_openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..28aefca0ff25f845af0ad8563d5dfe523585420e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/__pycache__/convert_to_openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/__pycache__/ifttt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/__pycache__/ifttt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4a8e0eecbf10962dc7ee848ea4771cff5fff39b4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/__pycache__/ifttt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/__pycache__/plugin.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/__pycache__/plugin.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..89550fa474e256405d9e11cfe3e65265879b91e0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/__pycache__/plugin.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/__pycache__/render.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/__pycache__/render.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5ba167f12ac96bd04f5c62a0137a8ed070b33dd3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/__pycache__/render.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/__pycache__/yahoo_finance_news.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/__pycache__/yahoo_finance_news.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b3c6472808773fe67afdd7d90fa9ee15b0d0d903
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/__pycache__/yahoo_finance_news.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/app.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/app.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cc1166ec5715c853b2d856b3d6c9856db2e1aebd
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/app.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0634f535628844125c8154cde0c20db25f85047e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/owner.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/owner.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d0ba9848c86b382f7c1cfcc1c92d279052ea36c7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/owner.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/rule.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/rule.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7eb0302167b60d8b1b5ab009fd0ea27c22d014c7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/rule.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/transfer.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/transfer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2611aee2c2e625b9c5fbfb7ee792b0fbd0385229
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/transfer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b4d568d07bf5a233ee96a49d63d6f626cad6655
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/value.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/value.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5ad922555550ede9187874335cb4dc4a28f24ac4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/ainetwork/__pycache__/value.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/app.py b/llm/Lib/site-packages/langchain_community/tools/ainetwork/app.py
new file mode 100644
index 0000000000000000000000000000000000000000..faef6120f9f9b199e544f4dc604eb5bed0e92c3d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/ainetwork/app.py
@@ -0,0 +1,102 @@
+import builtins
+import json
+from enum import Enum
+from typing import List, Optional, Type, Union
+
+from langchain_core.callbacks import AsyncCallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.ainetwork.base import AINBaseTool
+
+
+class AppOperationType(str, Enum):
+    """Type of app operation as enumerator."""
+
+    SET_ADMIN = "SET_ADMIN"
+    GET_CONFIG = "GET_CONFIG"
+
+
+class AppSchema(BaseModel):
+    """Schema for app operations."""
+
+    type: AppOperationType = Field(...)
+    appName: str = Field(..., description="Name of the application on the blockchain")
+    address: Optional[Union[str, List[str]]] = Field(
+        None,
+        description=(
+            "A single address or a list of addresses. Default: current session's "
+            "address"
+        ),
+    )
+
+
+class AINAppOps(AINBaseTool):
+    """Tool for app operations."""
+
+    name: str = "AINappOps"
+    description: str = """
+Create an app in the AINetwork Blockchain database by creating the /apps/<appName> path.
+An address set as `admin` can grant `owner` rights to other addresses (refer to `AINownerOps` for more details).
+Also, `admin` is initialized to have all `owner` permissions and `rule` allowed for that path.
+
+## appName Rule
+- [a-z_0-9]+
+
+## address Rules
+- 0x[0-9a-fA-F]{40}
+- Defaults to the current session's address
+- Multiple addresses can be specified if needed
+
+## SET_ADMIN Example 1
+- type: SET_ADMIN
+- appName: ain_project
+
+### Result:
+1. Path /apps/ain_project created.
+2. Current session's address registered as admin.
+
+## SET_ADMIN Example 2
+- type: SET_ADMIN
+- appName: test_project
+- address: [<address1>, <address2>]
+
+### Result:
+1. Path /apps/test_project created.
+2. <address1> and <address2> registered as admin.
+
+"""  # noqa: E501
+    args_schema: Type[BaseModel] = AppSchema
+
+    async def _arun(
+        self,
+        type: AppOperationType,
+        appName: str,
+        address: Optional[Union[str, List[str]]] = None,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        from ain.types import ValueOnlyTransactionInput
+        from ain.utils import getTimestamp
+
+        try:
+            if type is AppOperationType.SET_ADMIN:
+                if address is None:
+                    address = self.interface.wallet.defaultAccount.address
+                if isinstance(address, str):
+                    address = [address]
+
+                res = await self.interface.db.ref(
+                    f"/manage_app/{appName}/create/{getTimestamp()}"
+                ).setValue(
+                    transactionInput=ValueOnlyTransactionInput(
+                        value={"admin": {address: True for address in address}}
+                    )
+                )
+            elif type is AppOperationType.GET_CONFIG:
+                res = await self.interface.db.ref(
+                    f"/manage_app/{appName}/config"
+                ).getValue()
+            else:
+                raise ValueError(f"Unsupported 'type': {type}.")
+            return json.dumps(res, ensure_ascii=False)
+        except Exception as e:
+            return f"{builtins.type(e).__name__}: {str(e)}"
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/base.py b/llm/Lib/site-packages/langchain_community/tools/ainetwork/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f94127576983e9f39ca833ec570427787395741
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/ainetwork/base.py
@@ -0,0 +1,73 @@
+from __future__ import annotations
+
+import asyncio
+import threading
+from enum import Enum
+from typing import TYPE_CHECKING, Any, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.ainetwork.utils import authenticate
+
+if TYPE_CHECKING:
+    from ain.ain import Ain
+
+
+class OperationType(str, Enum):
+    """Type of operation as enumerator."""
+
+    SET = "SET"
+    GET = "GET"
+
+
+class AINBaseTool(BaseTool):
+    """Base class for the AINetwork tools."""
+
+    interface: Ain = Field(default_factory=authenticate)
+    """The interface object for the AINetwork Blockchain."""
+
+    def _run(
+        self,
+        *args: Any,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        try:
+            loop = asyncio.get_event_loop()
+        except RuntimeError:
+            loop = asyncio.new_event_loop()
+            asyncio.set_event_loop(loop)
+        if loop.is_closed():
+            loop = asyncio.new_event_loop()
+            asyncio.set_event_loop(loop)
+
+        if loop.is_running():
+            result_container = []
+
+            def thread_target() -> None:
+                nonlocal result_container
+                new_loop = asyncio.new_event_loop()
+                asyncio.set_event_loop(new_loop)
+                try:
+                    result_container.append(
+                        new_loop.run_until_complete(self._arun(*args, **kwargs))
+                    )
+                except Exception as e:
+                    result_container.append(e)
+                finally:
+                    new_loop.close()
+
+            thread = threading.Thread(target=thread_target)
+            thread.start()
+            thread.join()
+            result = result_container[0]
+            if isinstance(result, Exception):
+                raise result
+            return result
+
+        else:
+            result = loop.run_until_complete(self._arun(*args, **kwargs))
+            loop.close()
+            return result
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/owner.py b/llm/Lib/site-packages/langchain_community/tools/ainetwork/owner.py
new file mode 100644
index 0000000000000000000000000000000000000000..a89134f2a0597ef93a834d9968b5a682b6907c46
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/ainetwork/owner.py
@@ -0,0 +1,115 @@
+import builtins
+import json
+from typing import List, Optional, Type, Union
+
+from langchain_core.callbacks import AsyncCallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.ainetwork.base import AINBaseTool, OperationType
+
+
+class RuleSchema(BaseModel):
+    """Schema for owner operations."""
+
+    type: OperationType = Field(...)
+    path: str = Field(..., description="Blockchain reference path")
+    address: Optional[Union[str, List[str]]] = Field(
+        None, description="A single address or a list of addresses"
+    )
+    write_owner: Optional[bool] = Field(
+        False, description="Authority to edit the `owner` property of the path"
+    )
+    write_rule: Optional[bool] = Field(
+        False, description="Authority to edit `write rule` for the path"
+    )
+    write_function: Optional[bool] = Field(
+        False, description="Authority to `set function` for the path"
+    )
+    branch_owner: Optional[bool] = Field(
+        False, description="Authority to initialize `owner` of sub-paths"
+    )
+
+
+class AINOwnerOps(AINBaseTool):
+    """Tool for owner operations."""
+
+    name: str = "AINownerOps"
+    description: str = """
+Rules for `owner` in AINetwork Blockchain database.
+An address set as `owner` can modify permissions according to its granted authorities
+
+## Path Rule
+- (/[a-zA-Z_0-9]+)+
+- Permission checks ascend from the most specific (child) path to broader (parent) paths until an `owner` is located.
+
+## Address Rules
+- 0x[0-9a-fA-F]{40}: 40-digit hexadecimal address
+- *: All addresses permitted
+- Defaults to the current session's address
+
+## SET
+- `SET` alters permissions for specific addresses, while other addresses remain unaffected.
+- When removing an address of `owner`, set all authorities for that address to false.
+- message `write_owner permission evaluated false` if fail
+
+### Example
+- type: SET
+- path: /apps/langchain
+- address: [<address 1>, <address 2>]
+- write_owner: True
+- write_rule: True
+- write_function: True
+- branch_owner: True
+
+## GET
+- Provides all addresses with `owner` permissions and their authorities in the path.
+
+### Example
+- type: GET
+- path: /apps/langchain
+"""  # noqa: E501
+    args_schema: Type[BaseModel] = RuleSchema
+
+    async def _arun(
+        self,
+        type: OperationType,
+        path: str,
+        address: Optional[Union[str, List[str]]] = None,
+        write_owner: Optional[bool] = None,
+        write_rule: Optional[bool] = None,
+        write_function: Optional[bool] = None,
+        branch_owner: Optional[bool] = None,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        from ain.types import ValueOnlyTransactionInput
+
+        try:
+            if type is OperationType.SET:
+                if address is None:
+                    address = self.interface.wallet.defaultAccount.address
+                if isinstance(address, str):
+                    address = [address]
+                res = await self.interface.db.ref(path).setOwner(
+                    transactionInput=ValueOnlyTransactionInput(
+                        value={
+                            ".owner": {
+                                "owners": {
+                                    address: {
+                                        "write_owner": write_owner or False,
+                                        "write_rule": write_rule or False,
+                                        "write_function": write_function or False,
+                                        "branch_owner": branch_owner or False,
+                                    }
+                                    for address in address
+                                }
+                            }
+                        }
+                    )
+                )
+            elif type is OperationType.GET:
+                res = await self.interface.db.ref(path).getOwner()
+            else:
+                raise ValueError(f"Unsupported 'type': {type}.")
+            return json.dumps(res, ensure_ascii=False)
+        except Exception as e:
+            return f"{builtins.type(e).__name__}: {str(e)}"
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/rule.py b/llm/Lib/site-packages/langchain_community/tools/ainetwork/rule.py
new file mode 100644
index 0000000000000000000000000000000000000000..309010f5ba3ba8c7d437fda7275e1e7d149a5d26
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/ainetwork/rule.py
@@ -0,0 +1,82 @@
+import builtins
+import json
+from typing import Optional, Type
+
+from langchain_core.callbacks import AsyncCallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.ainetwork.base import AINBaseTool, OperationType
+
+
+class RuleSchema(BaseModel):
+    """Schema for owner operations."""
+
+    type: OperationType = Field(...)
+    path: str = Field(..., description="Path on the blockchain where the rule applies")
+    eval: Optional[str] = Field(None, description="eval string to determine permission")
+
+
+class AINRuleOps(AINBaseTool):
+    """Tool for owner operations."""
+
+    name: str = "AINruleOps"
+    description: str = """
+Covers the write `rule` for the AINetwork Blockchain database. The SET type specifies write permissions using the `eval` variable as a JavaScript eval string.
+In order to AINvalueOps with SET at the path, the execution result of the `eval` string must be true.
+
+## Path Rules
+1. Allowed characters for directory: `[a-zA-Z_0-9]`
+2. Use `$<key>` for template variables as directory.
+
+## Eval String Special Variables
+- auth.addr: Address of the writer for the path
+- newData: New data for the path
+- data: Current data for the path
+- currentTime: Time in seconds
+- lastBlockNumber: Latest processed block number
+
+## Eval String Functions
+- getValue(<path>)
+- getRule(<path>)
+- getOwner(<path>)
+- getFunction(<path>)
+- evalRule(<path>, <value to set>, auth, currentTime)
+- evalOwner(<path>, 'write_owner', auth)
+
+## SET Example
+- type: SET
+- path: /apps/langchain_project_1/$from/$to/$img
+- eval: auth.addr===$from&&!getValue('/apps/image_db/'+$img)
+
+## GET Example
+- type: GET
+- path: /apps/langchain_project_1
+"""  # noqa: E501
+    args_schema: Type[BaseModel] = RuleSchema
+
+    async def _arun(
+        self,
+        type: OperationType,
+        path: str,
+        eval: Optional[str] = None,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        from ain.types import ValueOnlyTransactionInput
+
+        try:
+            if type is OperationType.SET:
+                if eval is None:
+                    raise ValueError("'eval' is required for SET operation.")
+
+                res = await self.interface.db.ref(path).setRule(
+                    transactionInput=ValueOnlyTransactionInput(
+                        value={".rule": {"write": eval}}
+                    )
+                )
+            elif type is OperationType.GET:
+                res = await self.interface.db.ref(path).getRule()
+            else:
+                raise ValueError(f"Unsupported 'type': {type}.")
+            return json.dumps(res, ensure_ascii=False)
+        except Exception as e:
+            return f"{builtins.type(e).__name__}: {str(e)}"
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/transfer.py b/llm/Lib/site-packages/langchain_community/tools/ainetwork/transfer.py
new file mode 100644
index 0000000000000000000000000000000000000000..deab34ad9c2b51e8aada8983385fb0fbe29c2f78
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/ainetwork/transfer.py
@@ -0,0 +1,34 @@
+import json
+from typing import Optional, Type
+
+from langchain_core.callbacks import AsyncCallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.ainetwork.base import AINBaseTool
+
+
+class TransferSchema(BaseModel):
+    """Schema for transfer operations."""
+
+    address: str = Field(..., description="Address to transfer AIN to")
+    amount: int = Field(..., description="Amount of AIN to transfer")
+
+
+class AINTransfer(AINBaseTool):
+    """Tool for transfer operations."""
+
+    name: str = "AINtransfer"
+    description: str = "Transfers AIN to a specified address"
+    args_schema: Type[TransferSchema] = TransferSchema
+
+    async def _arun(
+        self,
+        address: str,
+        amount: int,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        try:
+            res = await self.interface.wallet.transfer(address, amount, nonce=-1)
+            return json.dumps(res, ensure_ascii=False)
+        except Exception as e:
+            return f"{type(e).__name__}: {str(e)}"
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/utils.py b/llm/Lib/site-packages/langchain_community/tools/ainetwork/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..0f8179a6075258d7fb795d7195f99caa9d9fd382
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/ainetwork/utils.py
@@ -0,0 +1,62 @@
+"""AINetwork Blockchain tool utils."""
+from __future__ import annotations
+
+import os
+from typing import TYPE_CHECKING, Literal, Optional
+
+if TYPE_CHECKING:
+    from ain.ain import Ain
+
+
+def authenticate(network: Optional[Literal["mainnet", "testnet"]] = "testnet") -> Ain:
+    """Authenticate using the AIN Blockchain"""
+
+    try:
+        from ain.ain import Ain
+    except ImportError as e:
+        raise ImportError(
+            "Cannot import ain-py related modules. Please install the package with "
+            "`pip install ain-py`."
+        ) from e
+
+    if network == "mainnet":
+        provider_url = "https://mainnet-api.ainetwork.ai/"
+        chain_id = 1
+        if "AIN_BLOCKCHAIN_ACCOUNT_PRIVATE_KEY" in os.environ:
+            private_key = os.environ["AIN_BLOCKCHAIN_ACCOUNT_PRIVATE_KEY"]
+        else:
+            raise EnvironmentError(
+                "Error: The AIN_BLOCKCHAIN_ACCOUNT_PRIVATE_KEY environmental variable "
+                "has not been set."
+            )
+    elif network == "testnet":
+        provider_url = "https://testnet-api.ainetwork.ai/"
+        chain_id = 0
+        if "AIN_BLOCKCHAIN_ACCOUNT_PRIVATE_KEY" in os.environ:
+            private_key = os.environ["AIN_BLOCKCHAIN_ACCOUNT_PRIVATE_KEY"]
+        else:
+            raise EnvironmentError(
+                "Error: The AIN_BLOCKCHAIN_ACCOUNT_PRIVATE_KEY environmental variable "
+                "has not been set."
+            )
+    elif network is None:
+        if (
+            "AIN_BLOCKCHAIN_PROVIDER_URL" in os.environ
+            and "AIN_BLOCKCHAIN_CHAIN_ID" in os.environ
+            and "AIN_BLOCKCHAIN_ACCOUNT_PRIVATE_KEY" in os.environ
+        ):
+            provider_url = os.environ["AIN_BLOCKCHAIN_PROVIDER_URL"]
+            chain_id = int(os.environ["AIN_BLOCKCHAIN_CHAIN_ID"])
+            private_key = os.environ["AIN_BLOCKCHAIN_ACCOUNT_PRIVATE_KEY"]
+        else:
+            raise EnvironmentError(
+                "Error: The AIN_BLOCKCHAIN_PROVIDER_URL and "
+                "AIN_BLOCKCHAIN_ACCOUNT_PRIVATE_KEY and AIN_BLOCKCHAIN_CHAIN_ID "
+                "environmental variable has not been set."
+            )
+    else:
+        raise ValueError(f"Unsupported 'network': {network}")
+
+    ain = Ain(provider_url, chain_id)
+    ain.wallet.addAndSetDefaultAccount(private_key)
+    return ain
diff --git a/llm/Lib/site-packages/langchain_community/tools/ainetwork/value.py b/llm/Lib/site-packages/langchain_community/tools/ainetwork/value.py
new file mode 100644
index 0000000000000000000000000000000000000000..300e36c573c9271e2d3e4d0a31eefa26f63ca5ce
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/ainetwork/value.py
@@ -0,0 +1,85 @@
+import builtins
+import json
+from typing import Optional, Type, Union
+
+from langchain_core.callbacks import AsyncCallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.ainetwork.base import AINBaseTool, OperationType
+
+
+class ValueSchema(BaseModel):
+    """Schema for value operations."""
+
+    type: OperationType = Field(...)
+    path: str = Field(..., description="Blockchain reference path")
+    value: Optional[Union[int, str, float, dict]] = Field(
+        None, description="Value to be set at the path"
+    )
+
+
+class AINValueOps(AINBaseTool):
+    """Tool for value operations."""
+
+    name: str = "AINvalueOps"
+    description: str = """
+Covers the read and write value for the AINetwork Blockchain database.
+
+## SET
+- Set a value at a given path
+
+### Example
+- type: SET
+- path: /apps/langchain_test_1/object
+- value: {1: 2, "34": 56}
+
+## GET
+- Retrieve a value at a given path
+
+### Example
+- type: GET
+- path: /apps/langchain_test_1/DB
+
+## Special paths
+- `/accounts/<address>/balance`: Account balance
+- `/accounts/<address>/nonce`: Account nonce
+- `/apps`: Applications
+- `/consensus`: Consensus
+- `/checkin`: Check-in
+- `/deposit/<service id>/<address>/<deposit id>`: Deposit
+- `/deposit_accounts/<service id>/<address>/<account id>`: Deposit accounts
+- `/escrow`: Escrow
+- `/payments`: Payment
+- `/sharding`: Sharding
+- `/token/name`: Token name
+- `/token/symbol`: Token symbol
+- `/token/total_supply`: Token total supply
+- `/transfer/<address from>/<address to>/<key>/value`: Transfer
+- `/withdraw/<service id>/<address>/<withdraw id>`: Withdraw
+"""
+    args_schema: Type[BaseModel] = ValueSchema
+
+    async def _arun(
+        self,
+        type: OperationType,
+        path: str,
+        value: Optional[Union[int, str, float, dict]] = None,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        from ain.types import ValueOnlyTransactionInput
+
+        try:
+            if type is OperationType.SET:
+                if value is None:
+                    raise ValueError("'value' is required for SET operation.")
+
+                res = await self.interface.db.ref(path).setValue(
+                    transactionInput=ValueOnlyTransactionInput(value=value)
+                )
+            elif type is OperationType.GET:
+                res = await self.interface.db.ref(path).getValue()
+            else:
+                raise ValueError(f"Unsupported 'type': {type}.")
+            return json.dumps(res, ensure_ascii=False)
+        except Exception as e:
+            return f"{builtins.type(e).__name__}: {str(e)}"
diff --git a/llm/Lib/site-packages/langchain_community/tools/amadeus/__init__.py b/llm/Lib/site-packages/langchain_community/tools/amadeus/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..570958f809806997dc70747887a969ef57152b87
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/amadeus/__init__.py
@@ -0,0 +1,9 @@
+"""Amadeus tools."""
+
+from langchain_community.tools.amadeus.closest_airport import AmadeusClosestAirport
+from langchain_community.tools.amadeus.flight_search import AmadeusFlightSearch
+
+__all__ = [
+    "AmadeusClosestAirport",
+    "AmadeusFlightSearch",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0ce66af34bc9f6338789fb583311f2bf86f0d435
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b7dec4d04b2ee67cb776832aa01e1506e3c133de
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/closest_airport.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/closest_airport.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cab61d345a9bcc9ed9e9610cfde1af008993b21d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/closest_airport.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/flight_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/flight_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0a697f4df5a3851be710c82f2bec16f1dcdc8f99
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/flight_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..88f68008ee46769b2544a4a587ceccbc745573e1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/amadeus/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/amadeus/base.py b/llm/Lib/site-packages/langchain_community/tools/amadeus/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..3bc53bc3f0b675e04641020338848b5c9876c75f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/amadeus/base.py
@@ -0,0 +1,18 @@
+"""Base class for Amadeus tools."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.amadeus.utils import authenticate
+
+if TYPE_CHECKING:
+    from amadeus import Client
+
+
+class AmadeusBaseTool(BaseTool):
+    """Base Tool for Amadeus."""
+
+    client: Client = Field(default_factory=authenticate)
diff --git a/llm/Lib/site-packages/langchain_community/tools/amadeus/closest_airport.py b/llm/Lib/site-packages/langchain_community/tools/amadeus/closest_airport.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a3f4c4da2cb284811a95dc941fb0a71b6fb44a0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/amadeus/closest_airport.py
@@ -0,0 +1,61 @@
+from typing import Any, Dict, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+
+from langchain_community.chat_models import ChatOpenAI
+from langchain_community.tools.amadeus.base import AmadeusBaseTool
+
+
+class ClosestAirportSchema(BaseModel):
+    """Schema for the AmadeusClosestAirport tool."""
+
+    location: str = Field(
+        description=(
+            " The location for which you would like to find the nearest airport "
+            " along with optional details such as country, state, region, or "
+            " province, allowing for easy processing and identification of "
+            " the closest airport. Examples of the format are the following:\n"
+            " Cali, Colombia\n "
+            " Lincoln, Nebraska, United States\n"
+            " New York, United States\n"
+            " Sydney, New South Wales, Australia\n"
+            " Rome, Lazio, Italy\n"
+            " Toronto, Ontario, Canada\n"
+        )
+    )
+
+
+class AmadeusClosestAirport(AmadeusBaseTool):
+    """Tool for finding the closest airport to a particular location."""
+
+    name: str = "closest_airport"
+    description: str = (
+        "Use this tool to find the closest airport to a particular location."
+    )
+    args_schema: Type[ClosestAirportSchema] = ClosestAirportSchema
+
+    llm: Optional[BaseLanguageModel] = Field(default=None)
+    """Tool's llm used for calculating the closest airport. Defaults to `ChatOpenAI`."""
+
+    @root_validator(pre=True)
+    def set_llm(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        if not values.get("llm"):
+            # For backward-compatibility
+            values["llm"] = ChatOpenAI(temperature=0)
+        return values
+
+    def _run(
+        self,
+        location: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        content = (
+            f" What is the nearest airport to {location}? Please respond with the "
+            " airport's International Air Transport Association (IATA) Location "
+            ' Identifier in the following JSON format. JSON: "iataCode": "IATA '
+            ' Location Identifier" '
+        )
+
+        return self.llm.invoke(content)  # type: ignore[union-attr]
diff --git a/llm/Lib/site-packages/langchain_community/tools/amadeus/flight_search.py b/llm/Lib/site-packages/langchain_community/tools/amadeus/flight_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..708a53054dc0d52512d8e9182ed56637d0bbe9f3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/amadeus/flight_search.py
@@ -0,0 +1,153 @@
+import logging
+from datetime import datetime as dt
+from typing import Dict, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.amadeus.base import AmadeusBaseTool
+
+logger = logging.getLogger(__name__)
+
+
+class FlightSearchSchema(BaseModel):
+    """Schema for the AmadeusFlightSearch tool."""
+
+    originLocationCode: str = Field(
+        description=(
+            " The three letter International Air Transport "
+            " Association (IATA) Location Identifier for the "
+            " search's origin airport. "
+        )
+    )
+    destinationLocationCode: str = Field(
+        description=(
+            " The three letter International Air Transport "
+            " Association (IATA) Location Identifier for the "
+            " search's destination airport. "
+        )
+    )
+    departureDateTimeEarliest: str = Field(
+        description=(
+            " The earliest departure datetime from the origin airport "
+            " for the flight search in the following format: "
+            ' "YYYY-MM-DDTHH:MM:SS", where "T" separates the date and time '
+            ' components. For example: "2023-06-09T10:30:00" represents '
+            " June 9th, 2023, at 10:30 AM. "
+        )
+    )
+    departureDateTimeLatest: str = Field(
+        description=(
+            " The latest departure datetime from the origin airport "
+            " for the flight search in the following format: "
+            ' "YYYY-MM-DDTHH:MM:SS", where "T" separates the date and time '
+            ' components. For example: "2023-06-09T10:30:00" represents '
+            " June 9th, 2023, at 10:30 AM. "
+        )
+    )
+    page_number: int = Field(
+        default=1,
+        description="The specific page number of flight results to retrieve",
+    )
+
+
+class AmadeusFlightSearch(AmadeusBaseTool):
+    """Tool for searching for a single flight between two airports."""
+
+    name: str = "single_flight_search"
+    description: str = (
+        " Use this tool to search for a single flight between the origin and "
+        " destination airports at a departure between an earliest and "
+        " latest datetime. "
+    )
+    args_schema: Type[FlightSearchSchema] = FlightSearchSchema
+
+    def _run(
+        self,
+        originLocationCode: str,
+        destinationLocationCode: str,
+        departureDateTimeEarliest: str,
+        departureDateTimeLatest: str,
+        page_number: int = 1,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> list:
+        try:
+            from amadeus import ResponseError
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import amadeus, please install with `pip install amadeus`."
+            ) from e
+
+        RESULTS_PER_PAGE = 10
+
+        # Authenticate and retrieve a client
+        client = self.client
+
+        # Check that earliest and latest dates are in the same day
+        earliestDeparture = dt.strptime(departureDateTimeEarliest, "%Y-%m-%dT%H:%M:%S")
+        latestDeparture = dt.strptime(departureDateTimeLatest, "%Y-%m-%dT%H:%M:%S")
+
+        if earliestDeparture.date() != latestDeparture.date():
+            logger.error(
+                " Error: Earliest and latest departure dates need to be the "
+                " same date. If you're trying to search for round-trip "
+                " flights, call this function for the outbound flight first, "
+                " and then call again for the return flight. "
+            )
+            return [None]
+
+        # Collect all results from the Amadeus Flight Offers Search API
+        response = None
+        try:
+            response = client.shopping.flight_offers_search.get(
+                originLocationCode=originLocationCode,
+                destinationLocationCode=destinationLocationCode,
+                departureDate=latestDeparture.strftime("%Y-%m-%d"),
+                adults=1,
+            )
+        except ResponseError as error:
+            print(error)  # noqa: T201
+
+        # Generate output dictionary
+        output = []
+        if response is not None:
+            for offer in response.data:
+                itinerary: Dict = {}
+                itinerary["price"] = {}
+                itinerary["price"]["total"] = offer["price"]["total"]
+                currency = offer["price"]["currency"]
+                currency = response.result["dictionaries"]["currencies"][currency]
+                itinerary["price"]["currency"] = {}
+                itinerary["price"]["currency"] = currency
+
+                segments = []
+                for segment in offer["itineraries"][0]["segments"]:
+                    flight = {}
+                    flight["departure"] = segment["departure"]
+                    flight["arrival"] = segment["arrival"]
+                    flight["flightNumber"] = segment["number"]
+                    carrier = segment["carrierCode"]
+                    carrier = response.result["dictionaries"]["carriers"][carrier]
+                    flight["carrier"] = carrier
+
+                    segments.append(flight)
+
+                itinerary["segments"] = []
+                itinerary["segments"] = segments
+
+                output.append(itinerary)
+
+        # Filter out flights after latest departure time
+        for index, offer in enumerate(output):
+            offerDeparture = dt.strptime(
+                offer["segments"][0]["departure"]["at"], "%Y-%m-%dT%H:%M:%S"
+            )
+
+            if offerDeparture > latestDeparture:
+                output.pop(index)
+
+        # Return the paginated results
+        startIndex = (page_number - 1) * RESULTS_PER_PAGE
+        endIndex = startIndex + RESULTS_PER_PAGE
+
+        return output[startIndex:endIndex]
diff --git a/llm/Lib/site-packages/langchain_community/tools/amadeus/utils.py b/llm/Lib/site-packages/langchain_community/tools/amadeus/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..7c04ec0528c65f5eec47bf6ad74073a3fa101f84
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/amadeus/utils.py
@@ -0,0 +1,42 @@
+"""O365 tool utils."""
+from __future__ import annotations
+
+import logging
+import os
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from amadeus import Client
+
+logger = logging.getLogger(__name__)
+
+
+def authenticate() -> Client:
+    """Authenticate using the Amadeus API"""
+    try:
+        from amadeus import Client
+    except ImportError as e:
+        raise ImportError(
+            "Cannot import amadeus. Please install the package with "
+            "`pip install amadeus`."
+        ) from e
+
+    if "AMADEUS_CLIENT_ID" in os.environ and "AMADEUS_CLIENT_SECRET" in os.environ:
+        client_id = os.environ["AMADEUS_CLIENT_ID"]
+        client_secret = os.environ["AMADEUS_CLIENT_SECRET"]
+    else:
+        logger.error(
+            "Error: The AMADEUS_CLIENT_ID and AMADEUS_CLIENT_SECRET environmental "
+            "variables have not been set. Visit the following link on how to "
+            "acquire these authorization tokens: "
+            "https://developers.amadeus.com/register"
+        )
+        return None
+
+    hostname = "test"  # Default hostname
+    if "AMADEUS_HOSTNAME" in os.environ:
+        hostname = os.environ["AMADEUS_HOSTNAME"]
+
+    client = Client(client_id=client_id, client_secret=client_secret, hostname=hostname)
+
+    return client
diff --git a/llm/Lib/site-packages/langchain_community/tools/arxiv/__init__.py b/llm/Lib/site-packages/langchain_community/tools/arxiv/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2607cb19bb7e5a74afba8128a82061f127000906
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/arxiv/__init__.py
@@ -0,0 +1 @@
+"""Arxiv API toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/arxiv/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/arxiv/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f72b155fa504d81a2ba39c3fef003d36ae870101
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/arxiv/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/arxiv/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/arxiv/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cb003ff6cdec81e85750d8bd3c5bc16bc7814c9e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/arxiv/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/arxiv/tool.py b/llm/Lib/site-packages/langchain_community/tools/arxiv/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..423b3f5cfc86ad92ce014947848237b3d004bc0c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/arxiv/tool.py
@@ -0,0 +1,39 @@
+"""Tool for the Arxiv API."""
+
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.arxiv import ArxivAPIWrapper
+
+
+class ArxivInput(BaseModel):
+    """Input for the Arxiv tool."""
+
+    query: str = Field(description="search query to look up")
+
+
+class ArxivQueryRun(BaseTool):
+    """Tool that searches the Arxiv API."""
+
+    name: str = "arxiv"
+    description: str = (
+        "A wrapper around Arxiv.org "
+        "Useful for when you need to answer questions about Physics, Mathematics, "
+        "Computer Science, Quantitative Biology, Quantitative Finance, Statistics, "
+        "Electrical Engineering, and Economics "
+        "from scientific articles on arxiv.org. "
+        "Input should be a search query."
+    )
+    api_wrapper: ArxivAPIWrapper = Field(default_factory=ArxivAPIWrapper)
+    args_schema: Type[BaseModel] = ArxivInput
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Arxiv tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/audio/__init__.py b/llm/Lib/site-packages/langchain_community/tools/audio/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9024dc6feaff387f5cb347c7325c4390c99fbf85
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/audio/__init__.py
@@ -0,0 +1,7 @@
+from langchain_community.tools.audio.huggingface_text_to_speech_inference import (
+    HuggingFaceTextToSpeechModelInference,
+)
+
+__all__ = [
+    "HuggingFaceTextToSpeechModelInference",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/audio/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/audio/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fa044a45f1c30b1d620a3f49c5d1d4f67793ee2e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/audio/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/audio/__pycache__/huggingface_text_to_speech_inference.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/audio/__pycache__/huggingface_text_to_speech_inference.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..84a78f0f4cce8021daf6eb42cd07c92289839303
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/audio/__pycache__/huggingface_text_to_speech_inference.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/audio/huggingface_text_to_speech_inference.py b/llm/Lib/site-packages/langchain_community/tools/audio/huggingface_text_to_speech_inference.py
new file mode 100644
index 0000000000000000000000000000000000000000..c728f8ad226c70bf545e82b7ef580defad73547d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/audio/huggingface_text_to_speech_inference.py
@@ -0,0 +1,118 @@
+import logging
+import os
+import uuid
+from datetime import datetime
+from typing import Callable, Literal, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import SecretStr
+from langchain_core.tools import BaseTool
+
+logger = logging.getLogger(__name__)
+
+
+class HuggingFaceTextToSpeechModelInference(BaseTool):
+    """HuggingFace Text-to-Speech Model Inference.
+
+    Requirements:
+        - Environment variable ``HUGGINGFACE_API_KEY`` must be set,
+          or passed as a named parameter to the constructor.
+    """
+
+    name: str = "openai_text_to_speech"
+    """Name of the tool."""
+    description: str = "A wrapper around OpenAI Text-to-Speech API. "
+    """Description of the tool."""
+
+    model: str
+    """Model name."""
+    file_extension: str
+    """File extension of the output audio file."""
+    destination_dir: str
+    """Directory to save the output audio file."""
+    file_namer: Callable[[], str]
+    """Function to generate unique file names."""
+
+    api_url: str
+    huggingface_api_key: SecretStr
+
+    _HUGGINGFACE_API_KEY_ENV_NAME = "HUGGINGFACE_API_KEY"
+    _HUGGINGFACE_API_URL_ROOT = "https://api-inference.huggingface.co/models"
+
+    def __init__(
+        self,
+        model: str,
+        file_extension: str,
+        *,
+        destination_dir: str = "./tts",
+        file_naming_func: Literal["uuid", "timestamp"] = "uuid",
+        huggingface_api_key: Optional[SecretStr] = None,
+    ) -> None:
+        if not huggingface_api_key:
+            huggingface_api_key = SecretStr(
+                os.getenv(self._HUGGINGFACE_API_KEY_ENV_NAME, "")
+            )
+
+        if (
+            not huggingface_api_key
+            or not huggingface_api_key.get_secret_value()
+            or huggingface_api_key.get_secret_value() == ""
+        ):
+            raise ValueError(
+                f"'{self._HUGGINGFACE_API_KEY_ENV_NAME}' must be or set or passed"
+            )
+
+        if file_naming_func == "uuid":
+            file_namer = lambda: str(uuid.uuid4())  # noqa: E731
+        elif file_naming_func == "timestamp":
+            file_namer = lambda: str(int(datetime.now().timestamp()))  # noqa: E731
+        else:
+            raise ValueError(
+                f"Invalid value for 'file_naming_func': {file_naming_func}"
+            )
+
+        super().__init__(
+            model=model,
+            file_extension=file_extension,
+            api_url=f"{self._HUGGINGFACE_API_URL_ROOT}/{model}",
+            destination_dir=destination_dir,
+            file_namer=file_namer,
+            huggingface_api_key=huggingface_api_key,
+        )
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        response = requests.post(
+            self.api_url,
+            headers={
+                "Authorization": f"Bearer {self.huggingface_api_key.get_secret_value()}"
+            },
+            json={"inputs": query},
+        )
+        audio_bytes = response.content
+
+        try:
+            os.makedirs(self.destination_dir, exist_ok=True)
+        except Exception as e:
+            logger.error(f"Error creating directory '{self.destination_dir}': {e}")
+            raise
+
+        output_file = os.path.join(
+            self.destination_dir,
+            f"{str(self.file_namer())}.{self.file_extension}",
+        )
+
+        try:
+            with open(output_file, mode="xb") as f:
+                f.write(audio_bytes)
+        except FileExistsError:
+            raise ValueError("Output name must be unique")
+        except Exception as e:
+            logger.error(f"Error occurred while creating file: {e}")
+            raise
+
+        return output_file
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__init__.py b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..637285ac63c1f3539de18fb4e79df82b9657a2bc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__init__.py
@@ -0,0 +1,25 @@
+"""Azure AI Services Tools."""
+
+from langchain_community.tools.azure_ai_services.document_intelligence import (
+    AzureAiServicesDocumentIntelligenceTool,
+)
+from langchain_community.tools.azure_ai_services.image_analysis import (
+    AzureAiServicesImageAnalysisTool,
+)
+from langchain_community.tools.azure_ai_services.speech_to_text import (
+    AzureAiServicesSpeechToTextTool,
+)
+from langchain_community.tools.azure_ai_services.text_analytics_for_health import (
+    AzureAiServicesTextAnalyticsForHealthTool,
+)
+from langchain_community.tools.azure_ai_services.text_to_speech import (
+    AzureAiServicesTextToSpeechTool,
+)
+
+__all__ = [
+    "AzureAiServicesDocumentIntelligenceTool",
+    "AzureAiServicesImageAnalysisTool",
+    "AzureAiServicesSpeechToTextTool",
+    "AzureAiServicesTextToSpeechTool",
+    "AzureAiServicesTextAnalyticsForHealthTool",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d62b798c9df65f688420ee631160b0cd8729084b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/document_intelligence.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/document_intelligence.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..739e817f64b5132e97518627259853b1428a764d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/document_intelligence.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/image_analysis.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/image_analysis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..caa337c9415b029da628b8525c75eac47c2b2c17
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/image_analysis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/speech_to_text.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/speech_to_text.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c5c36de87a45a271e6cb81f02f6111bb62910bdf
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/speech_to_text.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/text_analytics_for_health.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/text_analytics_for_health.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5153849c22a2f6c83187f041d305cee61a246098
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/text_analytics_for_health.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/text_to_speech.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/text_to_speech.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..339160cbf59ab8dec5dc5a511ef9b7aa35ddbf0d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/text_to_speech.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cefd8d287111a3ccf9a1d52dd04993495181e070
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/document_intelligence.py b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/document_intelligence.py
new file mode 100644
index 0000000000000000000000000000000000000000..a5e9e9e481ad95d1e198a17196127fd14a7f5106
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/document_intelligence.py
@@ -0,0 +1,145 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.tools.azure_ai_services.utils import (
+    detect_file_src_type,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class AzureAiServicesDocumentIntelligenceTool(BaseTool):
+    """Tool that queries the Azure AI Services Document Intelligence API.
+
+    In order to set this up, follow instructions at:
+    https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/quickstarts/get-started-sdks-rest-api?view=doc-intel-4.0.0&pivots=programming-language-python
+    """
+
+    azure_ai_services_key: str = ""  #: :meta private:
+    azure_ai_services_endpoint: str = ""  #: :meta private:
+    doc_analysis_client: Any  #: :meta private:
+
+    name: str = "azure_ai_services_document_intelligence"
+    description: str = (
+        "A wrapper around Azure AI Services Document Intelligence. "
+        "Useful for when you need to "
+        "extract text, tables, and key-value pairs from documents. "
+        "Input should be a url to a document."
+    )
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        azure_ai_services_key = get_from_dict_or_env(
+            values, "azure_ai_services_key", "AZURE_AI_SERVICES_KEY"
+        )
+
+        azure_ai_services_endpoint = get_from_dict_or_env(
+            values, "azure_ai_services_endpoint", "AZURE_AI_SERVICES_ENDPOINT"
+        )
+
+        try:
+            from azure.ai.formrecognizer import DocumentAnalysisClient
+            from azure.core.credentials import AzureKeyCredential
+
+            values["doc_analysis_client"] = DocumentAnalysisClient(
+                endpoint=azure_ai_services_endpoint,
+                credential=AzureKeyCredential(azure_ai_services_key),
+            )
+
+        except ImportError:
+            raise ImportError(
+                "azure-ai-formrecognizer is not installed. "
+                "Run `pip install azure-ai-formrecognizer` to install."
+            )
+
+        return values
+
+    def _parse_tables(self, tables: List[Any]) -> List[Any]:
+        result = []
+        for table in tables:
+            rc, cc = table.row_count, table.column_count
+            _table = [["" for _ in range(cc)] for _ in range(rc)]
+            for cell in table.cells:
+                _table[cell.row_index][cell.column_index] = cell.content
+            result.append(_table)
+        return result
+
+    def _parse_kv_pairs(self, kv_pairs: List[Any]) -> List[Any]:
+        result = []
+        for kv_pair in kv_pairs:
+            key = kv_pair.key.content if kv_pair.key else ""
+            value = kv_pair.value.content if kv_pair.value else ""
+            result.append((key, value))
+        return result
+
+    def _document_analysis(self, document_path: str) -> Dict:
+        document_src_type = detect_file_src_type(document_path)
+        if document_src_type == "local":
+            with open(document_path, "rb") as document:
+                poller = self.doc_analysis_client.begin_analyze_document(
+                    "prebuilt-document", document
+                )
+        elif document_src_type == "remote":
+            poller = self.doc_analysis_client.begin_analyze_document_from_url(
+                "prebuilt-document", document_path
+            )
+        else:
+            raise ValueError(f"Invalid document path: {document_path}")
+
+        result = poller.result()
+        res_dict = {}
+
+        if result.content is not None:
+            res_dict["content"] = result.content
+
+        if result.tables is not None:
+            res_dict["tables"] = self._parse_tables(result.tables)
+
+        if result.key_value_pairs is not None:
+            res_dict["key_value_pairs"] = self._parse_kv_pairs(result.key_value_pairs)
+
+        return res_dict
+
+    def _format_document_analysis_result(self, document_analysis_result: Dict) -> str:
+        formatted_result = []
+        if "content" in document_analysis_result:
+            formatted_result.append(
+                f"Content: {document_analysis_result['content']}".replace("\n", " ")
+            )
+
+        if "tables" in document_analysis_result:
+            for i, table in enumerate(document_analysis_result["tables"]):
+                formatted_result.append(f"Table {i}: {table}".replace("\n", " "))
+
+        if "key_value_pairs" in document_analysis_result:
+            for kv_pair in document_analysis_result["key_value_pairs"]:
+                formatted_result.append(
+                    f"{kv_pair[0]}: {kv_pair[1]}".replace("\n", " ")
+                )
+
+        return "\n".join(formatted_result)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        try:
+            document_analysis_result = self._document_analysis(query)
+            if not document_analysis_result:
+                return "No good document analysis result was found"
+
+            return self._format_document_analysis_result(document_analysis_result)
+        except Exception as e:
+            raise RuntimeError(
+                f"Error while running AzureAiServicesDocumentIntelligenceTool: {e}"
+            )
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/image_analysis.py b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/image_analysis.py
new file mode 100644
index 0000000000000000000000000000000000000000..ade4ef2bdbad6801098e80713c11e0055f2a542d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/image_analysis.py
@@ -0,0 +1,153 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.tools.azure_ai_services.utils import (
+    detect_file_src_type,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class AzureAiServicesImageAnalysisTool(BaseTool):
+    """Tool that queries the Azure AI Services Image Analysis API.
+
+    In order to set this up, follow instructions at:
+    https://learn.microsoft.com/en-us/azure/ai-services/computer-vision/quickstarts-sdk/image-analysis-client-library-40
+    """
+
+    azure_ai_services_key: str = ""  #: :meta private:
+    azure_ai_services_endpoint: str = ""  #: :meta private:
+    image_analysis_client: Any  #: :meta private:
+    visual_features: Any  #: :meta private:
+
+    name: str = "azure_ai_services_image_analysis"
+    description: str = (
+        "A wrapper around Azure AI Services Image Analysis. "
+        "Useful for when you need to analyze images. "
+        "Input should be a url to an image."
+    )
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        azure_ai_services_key = get_from_dict_or_env(
+            values, "azure_ai_services_key", "AZURE_AI_SERVICES_KEY"
+        )
+
+        azure_ai_services_endpoint = get_from_dict_or_env(
+            values, "azure_ai_services_endpoint", "AZURE_AI_SERVICES_ENDPOINT"
+        )
+
+        """Validate that azure-ai-vision-imageanalysis is installed."""
+        try:
+            from azure.ai.vision.imageanalysis import ImageAnalysisClient
+            from azure.ai.vision.imageanalysis.models import VisualFeatures
+            from azure.core.credentials import AzureKeyCredential
+        except ImportError:
+            raise ImportError(
+                "azure-ai-vision-imageanalysis is not installed. "
+                "Run `pip install azure-ai-vision-imageanalysis` to install. "
+            )
+
+        """Validate Azure AI Vision Image Analysis client can be initialized."""
+        try:
+            values["image_analysis_client"] = ImageAnalysisClient(
+                endpoint=azure_ai_services_endpoint,
+                credential=AzureKeyCredential(azure_ai_services_key),
+            )
+        except Exception as e:
+            raise RuntimeError(
+                f"Initialization of Azure AI Vision Image Analysis client failed: {e}"
+            )
+
+        values["visual_features"] = [
+            VisualFeatures.TAGS,
+            VisualFeatures.OBJECTS,
+            VisualFeatures.CAPTION,
+            VisualFeatures.READ,
+        ]
+
+        return values
+
+    def _image_analysis(self, image_path: str) -> Dict:
+        try:
+            from azure.ai.vision.imageanalysis import ImageAnalysisClient
+        except ImportError:
+            pass
+
+        self.image_analysis_client: ImageAnalysisClient
+
+        image_src_type = detect_file_src_type(image_path)
+        if image_src_type == "local":
+            with open(image_path, "rb") as image_file:
+                image_data = image_file.read()
+            result = self.image_analysis_client.analyze(
+                image_data=image_data,
+                visual_features=self.visual_features,
+            )
+        elif image_src_type == "remote":
+            result = self.image_analysis_client.analyze_from_url(
+                image_url=image_path,
+                visual_features=self.visual_features,
+            )
+        else:
+            raise ValueError(f"Invalid image path: {image_path}")
+
+        res_dict = {}
+        if result:
+            if result.caption is not None:
+                res_dict["caption"] = result.caption.text
+
+            if result.objects is not None:
+                res_dict["objects"] = [obj.tags[0].name for obj in result.objects.list]
+
+            if result.tags is not None:
+                res_dict["tags"] = [tag.name for tag in result.tags.list]
+
+            if result.read is not None and len(result.read.blocks) > 0:
+                res_dict["text"] = [line.text for line in result.read.blocks[0].lines]
+
+        return res_dict
+
+    def _format_image_analysis_result(self, image_analysis_result: Dict) -> str:
+        formatted_result = []
+        if "caption" in image_analysis_result:
+            formatted_result.append("Caption: " + image_analysis_result["caption"])
+
+        if (
+            "objects" in image_analysis_result
+            and len(image_analysis_result["objects"]) > 0
+        ):
+            formatted_result.append(
+                "Objects: " + ", ".join(image_analysis_result["objects"])
+            )
+
+        if "tags" in image_analysis_result and len(image_analysis_result["tags"]) > 0:
+            formatted_result.append("Tags: " + ", ".join(image_analysis_result["tags"]))
+
+        if "text" in image_analysis_result and len(image_analysis_result["text"]) > 0:
+            formatted_result.append("Text: " + ", ".join(image_analysis_result["text"]))
+
+        return "\n".join(formatted_result)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        try:
+            image_analysis_result = self._image_analysis(query)
+            if not image_analysis_result:
+                return "No good image analysis result was found"
+
+            return self._format_image_analysis_result(image_analysis_result)
+        except Exception as e:
+            raise RuntimeError(f"Error while running AzureAiImageAnalysisTool: {e}")
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/speech_to_text.py b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/speech_to_text.py
new file mode 100644
index 0000000000000000000000000000000000000000..28d490d7ab843de853bd6c880def8636b35f20d2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/speech_to_text.py
@@ -0,0 +1,122 @@
+from __future__ import annotations
+
+import logging
+import time
+from typing import Any, Dict, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.tools.azure_ai_services.utils import (
+    detect_file_src_type,
+    download_audio_from_url,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class AzureAiServicesSpeechToTextTool(BaseTool):
+    """Tool that queries the Azure AI Services Speech to Text API.
+
+    In order to set this up, follow instructions at:
+    https://learn.microsoft.com/en-us/azure/ai-services/speech-service/get-started-speech-to-text?pivots=programming-language-python
+    """
+
+    azure_ai_services_key: str = ""  #: :meta private:
+    azure_ai_services_region: str = ""  #: :meta private:
+    speech_language: str = "en-US"  #: :meta private:
+    speech_config: Any  #: :meta private:
+
+    name: str = "azure_ai_services_speech_to_text"
+    description: str = (
+        "A wrapper around Azure AI Services Speech to Text. "
+        "Useful for when you need to transcribe audio to text. "
+        "Input should be a url to an audio file."
+    )
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        azure_ai_services_key = get_from_dict_or_env(
+            values, "azure_ai_services_key", "AZURE_AI_SERVICES_KEY"
+        )
+
+        azure_ai_services_region = get_from_dict_or_env(
+            values, "azure_ai_services_region", "AZURE_AI_SERVICES_REGION"
+        )
+
+        try:
+            import azure.cognitiveservices.speech as speechsdk
+
+            values["speech_config"] = speechsdk.SpeechConfig(
+                subscription=azure_ai_services_key, region=azure_ai_services_region
+            )
+        except ImportError:
+            raise ImportError(
+                "azure-cognitiveservices-speech is not installed. "
+                "Run `pip install azure-cognitiveservices-speech` to install."
+            )
+
+        return values
+
+    def _continuous_recognize(self, speech_recognizer: Any) -> str:
+        done = False
+        text = ""
+
+        def stop_cb(evt: Any) -> None:
+            """callback that stop continuous recognition"""
+            speech_recognizer.stop_continuous_recognition_async()
+            nonlocal done
+            done = True
+
+        def retrieve_cb(evt: Any) -> None:
+            """callback that retrieves the intermediate recognition results"""
+            nonlocal text
+            text += evt.result.text
+
+        # retrieve text on recognized events
+        speech_recognizer.recognized.connect(retrieve_cb)
+        # stop continuous recognition on either session stopped or canceled events
+        speech_recognizer.session_stopped.connect(stop_cb)
+        speech_recognizer.canceled.connect(stop_cb)
+
+        # Start continuous speech recognition
+        speech_recognizer.start_continuous_recognition_async()
+        while not done:
+            time.sleep(0.5)
+        return text
+
+    def _speech_to_text(self, audio_path: str, speech_language: str) -> str:
+        try:
+            import azure.cognitiveservices.speech as speechsdk
+        except ImportError:
+            pass
+
+        audio_src_type = detect_file_src_type(audio_path)
+        if audio_src_type == "local":
+            audio_config = speechsdk.AudioConfig(filename=audio_path)
+        elif audio_src_type == "remote":
+            tmp_audio_path = download_audio_from_url(audio_path)
+            audio_config = speechsdk.AudioConfig(filename=tmp_audio_path)
+        else:
+            raise ValueError(f"Invalid audio path: {audio_path}")
+
+        self.speech_config.speech_recognition_language = speech_language
+        speech_recognizer = speechsdk.SpeechRecognizer(self.speech_config, audio_config)
+        return self._continuous_recognize(speech_recognizer)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        try:
+            text = self._speech_to_text(query, self.speech_language)
+            return text
+        except Exception as e:
+            raise RuntimeError(
+                f"Error while running AzureAiServicesSpeechToTextTool: {e}"
+            )
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/text_analytics_for_health.py b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/text_analytics_for_health.py
new file mode 100644
index 0000000000000000000000000000000000000000..869c93657166de6cb2b3bba992481181be5063a1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/text_analytics_for_health.py
@@ -0,0 +1,104 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+class AzureAiServicesTextAnalyticsForHealthTool(BaseTool):
+    """Tool that queries the Azure AI Services Text Analytics for Health API.
+
+    In order to set this up, follow instructions at:
+    https://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/quickstart?pivots=programming-language-python
+    """
+
+    azure_ai_services_key: str = ""  #: :meta private:
+    azure_ai_services_endpoint: str = ""  #: :meta private:
+    text_analytics_client: Any  #: :meta private:
+
+    name: str = "azure_ai_services_text_analytics_for_health"
+    description: str = (
+        "A wrapper around Azure AI Services Text Analytics for Health. "
+        "Useful for when you need to identify entities in healthcare data. "
+        "Input should be text."
+    )
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        azure_ai_services_key = get_from_dict_or_env(
+            values, "azure_ai_services_key", "AZURE_AI_SERVICES_KEY"
+        )
+
+        azure_ai_services_endpoint = get_from_dict_or_env(
+            values, "azure_ai_services_endpoint", "AZURE_AI_SERVICES_ENDPOINT"
+        )
+
+        try:
+            import azure.ai.textanalytics as sdk
+            from azure.core.credentials import AzureKeyCredential
+
+            values["text_analytics_client"] = sdk.TextAnalyticsClient(
+                endpoint=azure_ai_services_endpoint,
+                credential=AzureKeyCredential(azure_ai_services_key),
+            )
+
+        except ImportError:
+            raise ImportError(
+                "azure-ai-textanalytics is not installed. "
+                "Run `pip install azure-ai-textanalytics` to install."
+            )
+
+        return values
+
+    def _text_analysis(self, text: str) -> Dict:
+        poller = self.text_analytics_client.begin_analyze_healthcare_entities(
+            [{"id": "1", "language": "en", "text": text}]
+        )
+
+        result = poller.result()
+
+        res_dict = {}
+
+        docs = [doc for doc in result if not doc.is_error]
+
+        if docs is not None:
+            res_dict["entities"] = [
+                f"{x.text} is a healthcare entity of type {x.category}"
+                for y in docs
+                for x in y.entities
+            ]
+
+        return res_dict
+
+    def _format_text_analysis_result(self, text_analysis_result: Dict) -> str:
+        formatted_result = []
+        if "entities" in text_analysis_result:
+            formatted_result.append(
+                f"""The text contains the following healthcare entities: {
+                        ', '.join(text_analysis_result['entities'])
+                }""".replace("\n", " ")
+            )
+
+        return "\n".join(formatted_result)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        try:
+            text_analysis_result = self._text_analysis(query)
+
+            return self._format_text_analysis_result(text_analysis_result)
+        except Exception as e:
+            raise RuntimeError(
+                f"Error while running AzureAiServicesTextAnalyticsForHealthTool: {e}"
+            )
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/text_to_speech.py b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/text_to_speech.py
new file mode 100644
index 0000000000000000000000000000000000000000..67fde6bad85345539102458209238f00856d2f2e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/text_to_speech.py
@@ -0,0 +1,105 @@
+from __future__ import annotations
+
+import logging
+import tempfile
+from typing import Any, Dict, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+class AzureAiServicesTextToSpeechTool(BaseTool):
+    """Tool that queries the Azure AI Services Text to Speech API.
+
+    In order to set this up, follow instructions at:
+    https://learn.microsoft.com/en-us/azure/ai-services/speech-service/get-started-text-to-speech?pivots=programming-language-python
+    """
+
+    name: str = "azure_ai_services_text_to_speech"
+    description: str = (
+        "A wrapper around Azure AI Services Text to Speech API. "
+        "Useful for when you need to convert text to speech. "
+    )
+    return_direct: bool = True
+
+    azure_ai_services_key: str = ""  #: :meta private:
+    azure_ai_services_region: str = ""  #: :meta private:
+    speech_language: str = "en-US"  #: :meta private:
+    speech_config: Any  #: :meta private:
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        azure_ai_services_key = get_from_dict_or_env(
+            values, "azure_ai_services_key", "AZURE_AI_SERVICES_KEY"
+        )
+
+        azure_ai_services_region = get_from_dict_or_env(
+            values, "azure_ai_services_region", "AZURE_AI_SERVICES_REGION"
+        )
+
+        try:
+            import azure.cognitiveservices.speech as speechsdk
+
+            values["speech_config"] = speechsdk.SpeechConfig(
+                subscription=azure_ai_services_key, region=azure_ai_services_region
+            )
+        except ImportError:
+            raise ImportError(
+                "azure-cognitiveservices-speech is not installed. "
+                "Run `pip install azure-cognitiveservices-speech` to install."
+            )
+
+        return values
+
+    def _text_to_speech(self, text: str, speech_language: str) -> str:
+        try:
+            import azure.cognitiveservices.speech as speechsdk
+        except ImportError:
+            pass
+
+        self.speech_config.speech_synthesis_language = speech_language
+        speech_synthesizer = speechsdk.SpeechSynthesizer(
+            speech_config=self.speech_config, audio_config=None
+        )
+        result = speech_synthesizer.speak_text(text)
+
+        if result.reason == speechsdk.ResultReason.SynthesizingAudioCompleted:
+            stream = speechsdk.AudioDataStream(result)
+            with tempfile.NamedTemporaryFile(
+                mode="wb", suffix=".wav", delete=False
+            ) as f:
+                stream.save_to_wav_file(f.name)
+
+            return f.name
+
+        elif result.reason == speechsdk.ResultReason.Canceled:
+            cancellation_details = result.cancellation_details
+            logger.debug(f"Speech synthesis canceled: {cancellation_details.reason}")
+            if cancellation_details.reason == speechsdk.CancellationReason.Error:
+                raise RuntimeError(
+                    f"Speech synthesis error: {cancellation_details.error_details}"
+                )
+
+            return "Speech synthesis canceled."
+
+        else:
+            return f"Speech synthesis failed: {result.reason}"
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        try:
+            speech_file = self._text_to_speech(query, self.speech_language)
+            return speech_file
+        except Exception as e:
+            raise RuntimeError(
+                f"Error while running AzureAiServicesTextToSpeechTool: {e}"
+            )
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/utils.py b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..9de8f923b72272e48a947653e844b5ecce225070
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_ai_services/utils.py
@@ -0,0 +1,29 @@
+import os
+import tempfile
+from urllib.parse import urlparse
+
+import requests
+
+
+def detect_file_src_type(file_path: str) -> str:
+    """Detect if the file is local or remote."""
+    if os.path.isfile(file_path):
+        return "local"
+
+    parsed_url = urlparse(file_path)
+    if parsed_url.scheme and parsed_url.netloc:
+        return "remote"
+
+    return "invalid"
+
+
+def download_audio_from_url(audio_url: str) -> str:
+    """Download audio from url to local."""
+    ext = audio_url.split(".")[-1]
+    response = requests.get(audio_url, stream=True)
+    response.raise_for_status()
+    with tempfile.NamedTemporaryFile(mode="wb", suffix=f".{ext}", delete=False) as f:
+        for chunk in response.iter_content(chunk_size=8192):
+            f.write(chunk)
+
+    return f.name
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__init__.py b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1121e4e89d1f42c321a4e418dc42103b35e356d7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__init__.py
@@ -0,0 +1,25 @@
+"""Azure Cognitive Services Tools."""
+
+from langchain_community.tools.azure_cognitive_services.form_recognizer import (
+    AzureCogsFormRecognizerTool,
+)
+from langchain_community.tools.azure_cognitive_services.image_analysis import (
+    AzureCogsImageAnalysisTool,
+)
+from langchain_community.tools.azure_cognitive_services.speech2text import (
+    AzureCogsSpeech2TextTool,
+)
+from langchain_community.tools.azure_cognitive_services.text2speech import (
+    AzureCogsText2SpeechTool,
+)
+from langchain_community.tools.azure_cognitive_services.text_analytics_health import (
+    AzureCogsTextAnalyticsHealthTool,
+)
+
+__all__ = [
+    "AzureCogsImageAnalysisTool",
+    "AzureCogsFormRecognizerTool",
+    "AzureCogsSpeech2TextTool",
+    "AzureCogsText2SpeechTool",
+    "AzureCogsTextAnalyticsHealthTool",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5918d527e3a745e85ef78865ca025e3065f33e35
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/form_recognizer.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/form_recognizer.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9354188cab9c35ce7e101b5c9df2320411cf75d8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/form_recognizer.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/image_analysis.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/image_analysis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7edcff2c43ef361eedac06ed40a27b8a7898db49
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/image_analysis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/speech2text.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/speech2text.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4ce19453d2ee8476f25827b3ed83606f47b2fb9f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/speech2text.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/text2speech.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/text2speech.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a063a368cb01414e791a4ad6094acd5a0d7dbe13
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/text2speech.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/text_analytics_health.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/text_analytics_health.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dc63ccc3c043a74f0932ef0362ed0a7668c4d842
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/text_analytics_health.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..132e15988302dea9778bc6a3ed0abc119f94e998
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/form_recognizer.py b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/form_recognizer.py
new file mode 100644
index 0000000000000000000000000000000000000000..42d11b4ac4ed76772158e4e71ef2301ed1c0c642
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/form_recognizer.py
@@ -0,0 +1,143 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, List, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.tools.azure_cognitive_services.utils import (
+    detect_file_src_type,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class AzureCogsFormRecognizerTool(BaseTool):
+    """Tool that queries the Azure Cognitive Services Form Recognizer API.
+
+    In order to set this up, follow instructions at:
+    https://learn.microsoft.com/en-us/azure/applied-ai-services/form-recognizer/quickstarts/get-started-sdks-rest-api?view=form-recog-3.0.0&pivots=programming-language-python
+    """
+
+    azure_cogs_key: str = ""  #: :meta private:
+    azure_cogs_endpoint: str = ""  #: :meta private:
+    doc_analysis_client: Any  #: :meta private:
+
+    name: str = "azure_cognitive_services_form_recognizer"
+    description: str = (
+        "A wrapper around Azure Cognitive Services Form Recognizer. "
+        "Useful for when you need to "
+        "extract text, tables, and key-value pairs from documents. "
+        "Input should be a url to a document."
+    )
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        azure_cogs_key = get_from_dict_or_env(
+            values, "azure_cogs_key", "AZURE_COGS_KEY"
+        )
+
+        azure_cogs_endpoint = get_from_dict_or_env(
+            values, "azure_cogs_endpoint", "AZURE_COGS_ENDPOINT"
+        )
+
+        try:
+            from azure.ai.formrecognizer import DocumentAnalysisClient
+            from azure.core.credentials import AzureKeyCredential
+
+            values["doc_analysis_client"] = DocumentAnalysisClient(
+                endpoint=azure_cogs_endpoint,
+                credential=AzureKeyCredential(azure_cogs_key),
+            )
+
+        except ImportError:
+            raise ImportError(
+                "azure-ai-formrecognizer is not installed. "
+                "Run `pip install azure-ai-formrecognizer` to install."
+            )
+
+        return values
+
+    def _parse_tables(self, tables: List[Any]) -> List[Any]:
+        result = []
+        for table in tables:
+            rc, cc = table.row_count, table.column_count
+            _table = [["" for _ in range(cc)] for _ in range(rc)]
+            for cell in table.cells:
+                _table[cell.row_index][cell.column_index] = cell.content
+            result.append(_table)
+        return result
+
+    def _parse_kv_pairs(self, kv_pairs: List[Any]) -> List[Any]:
+        result = []
+        for kv_pair in kv_pairs:
+            key = kv_pair.key.content if kv_pair.key else ""
+            value = kv_pair.value.content if kv_pair.value else ""
+            result.append((key, value))
+        return result
+
+    def _document_analysis(self, document_path: str) -> Dict:
+        document_src_type = detect_file_src_type(document_path)
+        if document_src_type == "local":
+            with open(document_path, "rb") as document:
+                poller = self.doc_analysis_client.begin_analyze_document(
+                    "prebuilt-document", document
+                )
+        elif document_src_type == "remote":
+            poller = self.doc_analysis_client.begin_analyze_document_from_url(
+                "prebuilt-document", document_path
+            )
+        else:
+            raise ValueError(f"Invalid document path: {document_path}")
+
+        result = poller.result()
+        res_dict = {}
+
+        if result.content is not None:
+            res_dict["content"] = result.content
+
+        if result.tables is not None:
+            res_dict["tables"] = self._parse_tables(result.tables)
+
+        if result.key_value_pairs is not None:
+            res_dict["key_value_pairs"] = self._parse_kv_pairs(result.key_value_pairs)
+
+        return res_dict
+
+    def _format_document_analysis_result(self, document_analysis_result: Dict) -> str:
+        formatted_result = []
+        if "content" in document_analysis_result:
+            formatted_result.append(
+                f"Content: {document_analysis_result['content']}".replace("\n", " ")
+            )
+
+        if "tables" in document_analysis_result:
+            for i, table in enumerate(document_analysis_result["tables"]):
+                formatted_result.append(f"Table {i}: {table}".replace("\n", " "))
+
+        if "key_value_pairs" in document_analysis_result:
+            for kv_pair in document_analysis_result["key_value_pairs"]:
+                formatted_result.append(
+                    f"{kv_pair[0]}: {kv_pair[1]}".replace("\n", " ")
+                )
+
+        return "\n".join(formatted_result)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        try:
+            document_analysis_result = self._document_analysis(query)
+            if not document_analysis_result:
+                return "No good document analysis result was found"
+
+            return self._format_document_analysis_result(document_analysis_result)
+        except Exception as e:
+            raise RuntimeError(f"Error while running AzureCogsFormRecognizerTool: {e}")
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/image_analysis.py b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/image_analysis.py
new file mode 100644
index 0000000000000000000000000000000000000000..801aa57bd2d7baee7de45ea7f98a3cda9c7e0716
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/image_analysis.py
@@ -0,0 +1,147 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.tools.azure_cognitive_services.utils import (
+    detect_file_src_type,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class AzureCogsImageAnalysisTool(BaseTool):
+    """Tool that queries the Azure Cognitive Services Image Analysis API.
+
+    In order to set this up, follow instructions at:
+    https://learn.microsoft.com/en-us/azure/cognitive-services/computer-vision/quickstarts-sdk/image-analysis-client-library-40
+    """
+
+    azure_cogs_key: str = ""  #: :meta private:
+    azure_cogs_endpoint: str = ""  #: :meta private:
+    vision_service: Any  #: :meta private:
+    analysis_options: Any  #: :meta private:
+
+    name: str = "azure_cognitive_services_image_analysis"
+    description: str = (
+        "A wrapper around Azure Cognitive Services Image Analysis. "
+        "Useful for when you need to analyze images. "
+        "Input should be a url to an image."
+    )
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        azure_cogs_key = get_from_dict_or_env(
+            values, "azure_cogs_key", "AZURE_COGS_KEY"
+        )
+
+        azure_cogs_endpoint = get_from_dict_or_env(
+            values, "azure_cogs_endpoint", "AZURE_COGS_ENDPOINT"
+        )
+
+        try:
+            import azure.ai.vision as sdk
+
+            values["vision_service"] = sdk.VisionServiceOptions(
+                endpoint=azure_cogs_endpoint, key=azure_cogs_key
+            )
+
+            values["analysis_options"] = sdk.ImageAnalysisOptions()
+            values["analysis_options"].features = (
+                sdk.ImageAnalysisFeature.CAPTION
+                | sdk.ImageAnalysisFeature.OBJECTS
+                | sdk.ImageAnalysisFeature.TAGS
+                | sdk.ImageAnalysisFeature.TEXT
+            )
+        except ImportError:
+            raise ImportError(
+                "azure-ai-vision is not installed. "
+                "Run `pip install azure-ai-vision` to install."
+            )
+
+        return values
+
+    def _image_analysis(self, image_path: str) -> Dict:
+        try:
+            import azure.ai.vision as sdk
+        except ImportError:
+            pass
+
+        image_src_type = detect_file_src_type(image_path)
+        if image_src_type == "local":
+            vision_source = sdk.VisionSource(filename=image_path)
+        elif image_src_type == "remote":
+            vision_source = sdk.VisionSource(url=image_path)
+        else:
+            raise ValueError(f"Invalid image path: {image_path}")
+
+        image_analyzer = sdk.ImageAnalyzer(
+            self.vision_service, vision_source, self.analysis_options
+        )
+        result = image_analyzer.analyze()
+
+        res_dict = {}
+        if result.reason == sdk.ImageAnalysisResultReason.ANALYZED:
+            if result.caption is not None:
+                res_dict["caption"] = result.caption.content
+
+            if result.objects is not None:
+                res_dict["objects"] = [obj.name for obj in result.objects]
+
+            if result.tags is not None:
+                res_dict["tags"] = [tag.name for tag in result.tags]
+
+            if result.text is not None:
+                res_dict["text"] = [line.content for line in result.text.lines]
+
+        else:
+            error_details = sdk.ImageAnalysisErrorDetails.from_result(result)
+            raise RuntimeError(
+                f"Image analysis failed.\n"
+                f"Reason: {error_details.reason}\n"
+                f"Details: {error_details.message}"
+            )
+
+        return res_dict
+
+    def _format_image_analysis_result(self, image_analysis_result: Dict) -> str:
+        formatted_result = []
+        if "caption" in image_analysis_result:
+            formatted_result.append("Caption: " + image_analysis_result["caption"])
+
+        if (
+            "objects" in image_analysis_result
+            and len(image_analysis_result["objects"]) > 0
+        ):
+            formatted_result.append(
+                "Objects: " + ", ".join(image_analysis_result["objects"])
+            )
+
+        if "tags" in image_analysis_result and len(image_analysis_result["tags"]) > 0:
+            formatted_result.append("Tags: " + ", ".join(image_analysis_result["tags"]))
+
+        if "text" in image_analysis_result and len(image_analysis_result["text"]) > 0:
+            formatted_result.append("Text: " + ", ".join(image_analysis_result["text"]))
+
+        return "\n".join(formatted_result)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        try:
+            image_analysis_result = self._image_analysis(query)
+            if not image_analysis_result:
+                return "No good image analysis result was found"
+
+            return self._format_image_analysis_result(image_analysis_result)
+        except Exception as e:
+            raise RuntimeError(f"Error while running AzureCogsImageAnalysisTool: {e}")
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/speech2text.py b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/speech2text.py
new file mode 100644
index 0000000000000000000000000000000000000000..b1aa90cb7013d2c231b269a78209c5d5494745f6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/speech2text.py
@@ -0,0 +1,120 @@
+from __future__ import annotations
+
+import logging
+import time
+from typing import Any, Dict, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.tools.azure_cognitive_services.utils import (
+    detect_file_src_type,
+    download_audio_from_url,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class AzureCogsSpeech2TextTool(BaseTool):
+    """Tool that queries the Azure Cognitive Services Speech2Text API.
+
+    In order to set this up, follow instructions at:
+    https://learn.microsoft.com/en-us/azure/cognitive-services/speech-service/get-started-speech-to-text?pivots=programming-language-python
+    """
+
+    azure_cogs_key: str = ""  #: :meta private:
+    azure_cogs_region: str = ""  #: :meta private:
+    speech_language: str = "en-US"  #: :meta private:
+    speech_config: Any  #: :meta private:
+
+    name: str = "azure_cognitive_services_speech2text"
+    description: str = (
+        "A wrapper around Azure Cognitive Services Speech2Text. "
+        "Useful for when you need to transcribe audio to text. "
+        "Input should be a url to an audio file."
+    )
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        azure_cogs_key = get_from_dict_or_env(
+            values, "azure_cogs_key", "AZURE_COGS_KEY"
+        )
+
+        azure_cogs_region = get_from_dict_or_env(
+            values, "azure_cogs_region", "AZURE_COGS_REGION"
+        )
+
+        try:
+            import azure.cognitiveservices.speech as speechsdk
+
+            values["speech_config"] = speechsdk.SpeechConfig(
+                subscription=azure_cogs_key, region=azure_cogs_region
+            )
+        except ImportError:
+            raise ImportError(
+                "azure-cognitiveservices-speech is not installed. "
+                "Run `pip install azure-cognitiveservices-speech` to install."
+            )
+
+        return values
+
+    def _continuous_recognize(self, speech_recognizer: Any) -> str:
+        done = False
+        text = ""
+
+        def stop_cb(evt: Any) -> None:
+            """callback that stop continuous recognition"""
+            speech_recognizer.stop_continuous_recognition_async()
+            nonlocal done
+            done = True
+
+        def retrieve_cb(evt: Any) -> None:
+            """callback that retrieves the intermediate recognition results"""
+            nonlocal text
+            text += evt.result.text
+
+        # retrieve text on recognized events
+        speech_recognizer.recognized.connect(retrieve_cb)
+        # stop continuous recognition on either session stopped or canceled events
+        speech_recognizer.session_stopped.connect(stop_cb)
+        speech_recognizer.canceled.connect(stop_cb)
+
+        # Start continuous speech recognition
+        speech_recognizer.start_continuous_recognition_async()
+        while not done:
+            time.sleep(0.5)
+        return text
+
+    def _speech2text(self, audio_path: str, speech_language: str) -> str:
+        try:
+            import azure.cognitiveservices.speech as speechsdk
+        except ImportError:
+            pass
+
+        audio_src_type = detect_file_src_type(audio_path)
+        if audio_src_type == "local":
+            audio_config = speechsdk.AudioConfig(filename=audio_path)
+        elif audio_src_type == "remote":
+            tmp_audio_path = download_audio_from_url(audio_path)
+            audio_config = speechsdk.AudioConfig(filename=tmp_audio_path)
+        else:
+            raise ValueError(f"Invalid audio path: {audio_path}")
+
+        self.speech_config.speech_recognition_language = speech_language
+        speech_recognizer = speechsdk.SpeechRecognizer(self.speech_config, audio_config)
+        return self._continuous_recognize(speech_recognizer)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        try:
+            text = self._speech2text(query, self.speech_language)
+            return text
+        except Exception as e:
+            raise RuntimeError(f"Error while running AzureCogsSpeech2TextTool: {e}")
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/text2speech.py b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/text2speech.py
new file mode 100644
index 0000000000000000000000000000000000000000..f65049f13a96661b55274ca696716c5474fa91a7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/text2speech.py
@@ -0,0 +1,102 @@
+from __future__ import annotations
+
+import logging
+import tempfile
+from typing import Any, Dict, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+class AzureCogsText2SpeechTool(BaseTool):
+    """Tool that queries the Azure Cognitive Services Text2Speech API.
+
+    In order to set this up, follow instructions at:
+    https://learn.microsoft.com/en-us/azure/cognitive-services/speech-service/get-started-text-to-speech?pivots=programming-language-python
+    """
+
+    azure_cogs_key: str = ""  #: :meta private:
+    azure_cogs_region: str = ""  #: :meta private:
+    speech_language: str = "en-US"  #: :meta private:
+    speech_config: Any  #: :meta private:
+
+    name: str = "azure_cognitive_services_text2speech"
+    description: str = (
+        "A wrapper around Azure Cognitive Services Text2Speech. "
+        "Useful for when you need to convert text to speech. "
+    )
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        azure_cogs_key = get_from_dict_or_env(
+            values, "azure_cogs_key", "AZURE_COGS_KEY"
+        )
+
+        azure_cogs_region = get_from_dict_or_env(
+            values, "azure_cogs_region", "AZURE_COGS_REGION"
+        )
+
+        try:
+            import azure.cognitiveservices.speech as speechsdk
+
+            values["speech_config"] = speechsdk.SpeechConfig(
+                subscription=azure_cogs_key, region=azure_cogs_region
+            )
+        except ImportError:
+            raise ImportError(
+                "azure-cognitiveservices-speech is not installed. "
+                "Run `pip install azure-cognitiveservices-speech` to install."
+            )
+
+        return values
+
+    def _text2speech(self, text: str, speech_language: str) -> str:
+        try:
+            import azure.cognitiveservices.speech as speechsdk
+        except ImportError:
+            pass
+
+        self.speech_config.speech_synthesis_language = speech_language
+        speech_synthesizer = speechsdk.SpeechSynthesizer(
+            speech_config=self.speech_config, audio_config=None
+        )
+        result = speech_synthesizer.speak_text(text)
+
+        if result.reason == speechsdk.ResultReason.SynthesizingAudioCompleted:
+            stream = speechsdk.AudioDataStream(result)
+            with tempfile.NamedTemporaryFile(
+                mode="wb", suffix=".wav", delete=False
+            ) as f:
+                stream.save_to_wav_file(f.name)
+
+            return f.name
+
+        elif result.reason == speechsdk.ResultReason.Canceled:
+            cancellation_details = result.cancellation_details
+            logger.debug(f"Speech synthesis canceled: {cancellation_details.reason}")
+            if cancellation_details.reason == speechsdk.CancellationReason.Error:
+                raise RuntimeError(
+                    f"Speech synthesis error: {cancellation_details.error_details}"
+                )
+
+            return "Speech synthesis canceled."
+
+        else:
+            return f"Speech synthesis failed: {result.reason}"
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        try:
+            speech_file = self._text2speech(query, self.speech_language)
+            return speech_file
+        except Exception as e:
+            raise RuntimeError(f"Error while running AzureCogsText2SpeechTool: {e}")
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/text_analytics_health.py b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/text_analytics_health.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce5332436c7ea71e54ffadc3c04769974239610e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/text_analytics_health.py
@@ -0,0 +1,104 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+class AzureCogsTextAnalyticsHealthTool(BaseTool):
+    """Tool that queries the Azure Cognitive Services Text Analytics for Health API.
+
+    In order to set this up, follow instructions at:
+    https://learn.microsoft.com/en-us/azure/ai-services/language-service/text-analytics-for-health/quickstart?tabs=windows&pivots=programming-language-python
+    """
+
+    azure_cogs_key: str = ""  #: :meta private:
+    azure_cogs_endpoint: str = ""  #: :meta private:
+    text_analytics_client: Any  #: :meta private:
+
+    name: str = "azure_cognitive_services_text_analyics_health"
+    description: str = (
+        "A wrapper around Azure Cognitive Services Text Analytics for Health. "
+        "Useful for when you need to identify entities in healthcare data. "
+        "Input should be text."
+    )
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        azure_cogs_key = get_from_dict_or_env(
+            values, "azure_cogs_key", "AZURE_COGS_KEY"
+        )
+
+        azure_cogs_endpoint = get_from_dict_or_env(
+            values, "azure_cogs_endpoint", "AZURE_COGS_ENDPOINT"
+        )
+
+        try:
+            import azure.ai.textanalytics as sdk
+            from azure.core.credentials import AzureKeyCredential
+
+            values["text_analytics_client"] = sdk.TextAnalyticsClient(
+                endpoint=azure_cogs_endpoint,
+                credential=AzureKeyCredential(azure_cogs_key),
+            )
+
+        except ImportError:
+            raise ImportError(
+                "azure-ai-textanalytics is not installed. "
+                "Run `pip install azure-ai-textanalytics` to install."
+            )
+
+        return values
+
+    def _text_analysis(self, text: str) -> Dict:
+        poller = self.text_analytics_client.begin_analyze_healthcare_entities(
+            [{"id": "1", "language": "en", "text": text}]
+        )
+
+        result = poller.result()
+
+        res_dict = {}
+
+        docs = [doc for doc in result if not doc.is_error]
+
+        if docs is not None:
+            res_dict["entities"] = [
+                f"{x.text} is a healthcare entity of type {x.category}"
+                for y in docs
+                for x in y.entities
+            ]
+
+        return res_dict
+
+    def _format_text_analysis_result(self, text_analysis_result: Dict) -> str:
+        formatted_result = []
+        if "entities" in text_analysis_result:
+            formatted_result.append(
+                f"""The text contains the following healthcare entities: {
+                        ', '.join(text_analysis_result['entities'])
+                }""".replace("\n", " ")
+            )
+
+        return "\n".join(formatted_result)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        try:
+            text_analysis_result = self._text_analysis(query)
+
+            return self._format_text_analysis_result(text_analysis_result)
+        except Exception as e:
+            raise RuntimeError(
+                f"Error while running AzureCogsTextAnalyticsHealthTool: {e}"
+            )
diff --git a/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/utils.py b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..9de8f923b72272e48a947653e844b5ecce225070
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/azure_cognitive_services/utils.py
@@ -0,0 +1,29 @@
+import os
+import tempfile
+from urllib.parse import urlparse
+
+import requests
+
+
+def detect_file_src_type(file_path: str) -> str:
+    """Detect if the file is local or remote."""
+    if os.path.isfile(file_path):
+        return "local"
+
+    parsed_url = urlparse(file_path)
+    if parsed_url.scheme and parsed_url.netloc:
+        return "remote"
+
+    return "invalid"
+
+
+def download_audio_from_url(audio_url: str) -> str:
+    """Download audio from url to local."""
+    ext = audio_url.split(".")[-1]
+    response = requests.get(audio_url, stream=True)
+    response.raise_for_status()
+    with tempfile.NamedTemporaryFile(mode="wb", suffix=f".{ext}", delete=False) as f:
+        for chunk in response.iter_content(chunk_size=8192):
+            f.write(chunk)
+
+    return f.name
diff --git a/llm/Lib/site-packages/langchain_community/tools/bearly/__init__.py b/llm/Lib/site-packages/langchain_community/tools/bearly/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_community/tools/bearly/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/bearly/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9c3c1bdd9272f8b74ccffa1c8298596649f1e3f3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/bearly/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/bearly/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/bearly/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5941a256b2dfba654320e3bc5c700bc0752b8f6a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/bearly/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/bearly/tool.py b/llm/Lib/site-packages/langchain_community/tools/bearly/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..286e024f64acfd293b6e19b88241fc5578331ca1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/bearly/tool.py
@@ -0,0 +1,166 @@
+import base64
+import itertools
+import json
+import re
+from pathlib import Path
+from typing import Dict, List, Type
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools import Tool
+
+
+def strip_markdown_code(md_string: str) -> str:
+    """Strip markdown code from a string."""
+    stripped_string = re.sub(r"^`{1,3}.*?\n", "", md_string, flags=re.DOTALL)
+    stripped_string = re.sub(r"`{1,3}$", "", stripped_string)
+    return stripped_string
+
+
+def head_file(path: str, n: int) -> List[str]:
+    """Get the first n lines of a file."""
+    try:
+        with open(path, "r") as f:
+            return [str(line) for line in itertools.islice(f, n)]
+    except Exception:
+        return []
+
+
+def file_to_base64(path: str) -> str:
+    """Convert a file to base64."""
+    with open(path, "rb") as f:
+        return base64.b64encode(f.read()).decode()
+
+
+class BearlyInterpreterToolArguments(BaseModel):
+    """Arguments for the BearlyInterpreterTool."""
+
+    python_code: str = Field(
+        ...,
+        example="print('Hello World')",
+        description=(
+            "The pure python script to be evaluated. "
+            "The contents will be in main.py. "
+            "It should not be in markdown format."
+        ),
+    )
+
+
+base_description = """Evaluates python code in a sandbox environment. \
+The environment resets on every execution. \
+You must send the whole script every time and print your outputs. \
+Script should be pure python code that can be evaluated. \
+It should be in python format NOT markdown. \
+The code should NOT be wrapped in backticks. \
+All python packages including requests, matplotlib, scipy, numpy, pandas, \
+etc are available. \
+If you have any files outputted write them to "output/" relative to the execution \
+path. Output can only be read from the directory, stdout, and stdin. \
+Do not use things like plot.show() as it will \
+not work instead write them out `output/` and a link to the file will be returned. \
+print() any output and results so you can capture the output."""  # noqa: T201
+
+
+class FileInfo(BaseModel):
+    """Information about a file to be uploaded."""
+
+    source_path: str
+    description: str
+    target_path: str
+
+
+class BearlyInterpreterTool:
+    """Tool for evaluating python code in a sandbox environment."""
+
+    api_key: str
+    endpoint = "https://exec.bearly.ai/v1/interpreter"
+    name = "bearly_interpreter"
+    args_schema: Type[BaseModel] = BearlyInterpreterToolArguments
+    files: Dict[str, FileInfo] = {}
+
+    def __init__(self, api_key: str):
+        self.api_key = api_key
+
+    @property
+    def file_description(self) -> str:
+        if len(self.files) == 0:
+            return ""
+        lines = ["The following files available in the evaluation environment:"]
+        for target_path, file_info in self.files.items():
+            peek_content = head_file(file_info.source_path, 4)
+            lines.append(
+                f"- path: `{target_path}` \n first four lines: {peek_content}"
+                f" \n description: `{file_info.description}`"
+            )
+        return "\n".join(lines)
+
+    @property
+    def description(self) -> str:
+        return (base_description + "\n\n" + self.file_description).strip()
+
+    def make_input_files(self) -> List[dict]:
+        files = []
+        for target_path, file_info in self.files.items():
+            files.append(
+                {
+                    "pathname": target_path,
+                    "contentsBasesixtyfour": file_to_base64(file_info.source_path),
+                }
+            )
+        return files
+
+    def _run(self, python_code: str) -> dict:
+        script = strip_markdown_code(python_code)
+        resp = requests.post(
+            "https://exec.bearly.ai/v1/interpreter",
+            data=json.dumps(
+                {
+                    "fileContents": script,
+                    "inputFiles": self.make_input_files(),
+                    "outputDir": "output/",
+                    "outputAsLinks": True,
+                }
+            ),
+            headers={"Authorization": self.api_key},
+        ).json()
+        return {
+            "stdout": (
+                base64.b64decode(resp["stdoutBasesixtyfour"]).decode()
+                if resp["stdoutBasesixtyfour"]
+                else ""
+            ),
+            "stderr": (
+                base64.b64decode(resp["stderrBasesixtyfour"]).decode()
+                if resp["stderrBasesixtyfour"]
+                else ""
+            ),
+            "fileLinks": resp["fileLinks"],
+            "exitCode": resp["exitCode"],
+        }
+
+    async def _arun(self, query: str) -> str:
+        """Use the tool asynchronously."""
+        raise NotImplementedError("custom_search does not support async")
+
+    def add_file(self, source_path: str, target_path: str, description: str) -> None:
+        if target_path in self.files:
+            raise ValueError("target_path already exists")
+        if not Path(source_path).exists():
+            raise ValueError("source_path does not exist")
+        self.files[target_path] = FileInfo(
+            target_path=target_path, source_path=source_path, description=description
+        )
+
+    def clear_files(self) -> None:
+        self.files = {}
+
+    # TODO: this is because we can't have a dynamic description
+    #  because of the base pydantic class
+    def as_tool(self) -> Tool:
+        return Tool.from_function(
+            func=self._run,
+            name=self.name,
+            description=self.description,
+            args_schema=self.args_schema,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/tools/bing_search/__init__.py b/llm/Lib/site-packages/langchain_community/tools/bing_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b5e133a05a034a3d1361603f617f5c567eb8699e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/bing_search/__init__.py
@@ -0,0 +1,5 @@
+"""Bing Search API toolkit."""
+
+from langchain_community.tools.bing_search.tool import BingSearchResults, BingSearchRun
+
+__all__ = ["BingSearchRun", "BingSearchResults"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/bing_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/bing_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9240a46c823949782a9083a421d5c000dfc1f0e5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/bing_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/bing_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/bing_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..324fa31caedae35984d769427525ebac8e59ebbb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/bing_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/bing_search/tool.py b/llm/Lib/site-packages/langchain_community/tools/bing_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..658b5011ca561e75cf9e2549b072321d7633e78e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/bing_search/tool.py
@@ -0,0 +1,49 @@
+"""Tool for the Bing search API."""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.bing_search import BingSearchAPIWrapper
+
+
+class BingSearchRun(BaseTool):
+    """Tool that queries the Bing search API."""
+
+    name: str = "bing_search"
+    description: str = (
+        "A wrapper around Bing Search. "
+        "Useful for when you need to answer questions about current events. "
+        "Input should be a search query."
+    )
+    api_wrapper: BingSearchAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.api_wrapper.run(query)
+
+
+class BingSearchResults(BaseTool):
+    """Tool that queries the Bing Search API and gets back json."""
+
+    name: str = "bing_search_results_json"
+    description: str = (
+        "A wrapper around Bing Search. "
+        "Useful for when you need to answer questions about current events. "
+        "Input should be a search query. Output is a JSON array of the query results"
+    )
+    num_results: int = 4
+    api_wrapper: BingSearchAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return str(self.api_wrapper.results(query, self.num_results))
diff --git a/llm/Lib/site-packages/langchain_community/tools/brave_search/__init__.py b/llm/Lib/site-packages/langchain_community/tools/brave_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_community/tools/brave_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/brave_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8bb35ba6c4682a143e91342d6b0a0ed90c5a167e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/brave_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/brave_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/brave_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9c6c2c9ab044f8afc19b77e00ac9cd6e2d46bffd
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/brave_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/brave_search/tool.py b/llm/Lib/site-packages/langchain_community/tools/brave_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..4ca8d68501e19e4d6c9e1659a76cdf6acb51c1e6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/brave_search/tool.py
@@ -0,0 +1,45 @@
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.brave_search import BraveSearchWrapper
+
+
+class BraveSearch(BaseTool):
+    """Tool that queries the BraveSearch."""
+
+    name: str = "brave_search"
+    description: str = (
+        "a search engine. "
+        "useful for when you need to answer questions about current events."
+        " input should be a search query."
+    )
+    search_wrapper: BraveSearchWrapper
+
+    @classmethod
+    def from_api_key(
+        cls, api_key: str, search_kwargs: Optional[dict] = None, **kwargs: Any
+    ) -> BraveSearch:
+        """Create a tool from an api key.
+
+        Args:
+            api_key: The api key to use.
+            search_kwargs: Any additional kwargs to pass to the search wrapper.
+            **kwargs: Any additional kwargs to pass to the tool.
+
+        Returns:
+            A tool.
+        """
+        wrapper = BraveSearchWrapper(api_key=api_key, search_kwargs=search_kwargs or {})
+        return cls(search_wrapper=wrapper, **kwargs)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.search_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/clickup/__init__.py b/llm/Lib/site-packages/langchain_community/tools/clickup/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_community/tools/clickup/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/clickup/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8443f343c1a6b6446ae45aebde4df5c7ddf6933f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/clickup/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/clickup/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/clickup/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c8413bd8631291770596b5023ca371dd3b2f31c2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/clickup/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/clickup/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/clickup/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b5aa89171c33878157947a4a702aaf3f1565eb58
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/clickup/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/clickup/prompt.py b/llm/Lib/site-packages/langchain_community/tools/clickup/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..5f1f51dbf776c8df744d0d752f520eda4dd6e5b0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/clickup/prompt.py
@@ -0,0 +1,131 @@
+# flake8: noqa
+CLICKUP_TASK_CREATE_PROMPT = """
+    This tool is a wrapper around clickup's create_task API, useful when you need to create a CLICKUP task. 
+    The input to this tool is a dictionary specifying the fields of the CLICKUP task, and will be passed into clickup's CLICKUP `create_task` function.
+    Only add fields described by the user.
+    Use the following mapping in order to map the user's priority to the clickup priority: {{
+            Urgent = 1,
+            High = 2,
+            Normal = 3,
+            Low = 4,
+        }}. If the user passes in "urgent" replace the priority value as 1.
+ 
+    Here are a few task descriptions and corresponding input examples:
+    Task: create a task called "Daily report"
+    Example Input: {{"name": "Daily report"}}
+    Task: Make an open task called "ClickUp toolkit refactor" with description "Refactor the clickup toolkit to use dataclasses for parsing", with status "open"
+    Example Input: {{"name": "ClickUp toolkit refactor", "description": "Refactor the clickup toolkit to use dataclasses for parsing", "status": "Open"}}
+    Task: create a task with priority 3 called "New Task Name" with description "New Task Description", with status "open"
+    Example Input: {{"name": "New Task Name", "description": "New Task Description", "status": "Open", "priority": 3}}
+    Task: Add a task called "Bob's task" and assign it to Bob (user id: 81928627)
+    Example Input: {{"name": "Bob's task", "description": "Task for Bob", "assignees": [81928627]}}
+    """
+
+CLICKUP_LIST_CREATE_PROMPT = """
+    This tool is a wrapper around clickup's create_list API, useful when you need to create a CLICKUP list.
+    The input to this tool is a dictionary specifying the fields of a clickup list, and will be passed to clickup's create_list function.
+    Only add fields described by the user.
+    Use the following mapping in order to map the user's priority to the clickup priority: {{
+        Urgent = 1,
+        High = 2,
+        Normal = 3,
+        Low = 4,
+    }}. If the user passes in "urgent" replace the priority value as 1.
+
+    Here are a few list descriptions and corresponding input examples:
+    Description: make a list with name "General List"
+    Example Input: {{"name": "General List"}} 
+    Description: add a new list ("TODOs") with low priority
+    Example Input: {{"name": "General List", "priority": 4}}
+    Description: create a list with name "List name", content "List content", priority 2, and status "red"
+    Example Input: {{"name": "List name", "content": "List content", "priority": 2, "status": "red"}} 
+"""
+
+CLICKUP_FOLDER_CREATE_PROMPT = """
+    This tool is a wrapper around clickup's create_folder API, useful when you need to create a CLICKUP folder.
+    The input to this tool is a dictionary specifying the fields of a clickup folder, and will be passed to clickup's create_folder function.
+    For example, to create a folder with name "Folder name" you would pass in the following dictionary:
+    {{
+        "name": "Folder name",
+    }} 
+"""
+
+CLICKUP_GET_TASK_PROMPT = """
+    This tool is a wrapper around clickup's API,
+    Do NOT use to get a task specific attribute. Use get task attribute instead. 
+    useful when you need to get a specific task for the user. Given the task id you want to create a request similar to the following dictionary:
+    payload = {{"task_id": "86a0t44tq"}}
+    """
+
+CLICKUP_GET_TASK_ATTRIBUTE_PROMPT = """
+    This tool is a wrapper around clickup's API, 
+    useful when you need to get a specific attribute from a task. Given the task id and desired attribute create a request similar to the following dictionary:
+    payload = {{"task_id": "<task_id_to_update>", "attribute_name": "<attribute_name_to_update>"}}
+
+    Here are some example queries their corresponding payloads:
+    Get the name of task 23jn23kjn -> {{"task_id": "23jn23kjn", "attribute_name": "name"}}
+    What is the priority of task 86a0t44tq? -> {{"task_id": "86a0t44tq", "attribute_name": "priority"}}
+    Output the description of task sdc9ds9jc -> {{"task_id": "sdc9ds9jc", "attribute_name": "description"}}
+    Who is assigned to task bgjfnbfg0 -> {{"task_id": "bgjfnbfg0", "attribute_name": "assignee"}}
+    Which is the status of task kjnsdcjc? -> {{"task_id": "kjnsdcjc", "attribute_name": "description"}}
+    How long is the time estimate of task sjncsd999? -> {{"task_id": "sjncsd999", "attribute_name": "time_estimate"}}
+    Is task jnsd98sd archived?-> {{"task_id": "jnsd98sd", "attribute_name": "archive"}}
+    """
+
+CLICKUP_GET_ALL_TEAMS_PROMPT = """
+    This tool is a wrapper around clickup's API, useful when you need to get all teams that the user is a part of.
+    To get a list of all the teams there is no necessary request parameters. 
+    """
+
+CLICKUP_GET_LIST_PROMPT = """
+    This tool is a wrapper around clickup's API, 
+    useful when you need to get a specific list for the user. Given the list id you want to create a request similar to the following dictionary:
+    payload = {{"list_id": "901300608424"}}
+    """
+
+CLICKUP_GET_FOLDERS_PROMPT = """
+    This tool is a wrapper around clickup's API, 
+    useful when you need to get a specific folder for the user. Given the user's workspace id you want to create a request similar to the following dictionary:
+    payload = {{"folder_id": "90130119692"}}
+    """
+
+CLICKUP_GET_SPACES_PROMPT = """
+    This tool is a wrapper around clickup's API, 
+    useful when you need to get all the spaces available to a user. Given the user's workspace id you want to create a request similar to the following dictionary:
+    payload = {{"team_id": "90130119692"}}
+    """
+
+CLICKUP_GET_SPACES_PROMPT = """
+    This tool is a wrapper around clickup's API, 
+    useful when you need to get all the spaces available to a user. Given the user's workspace id you want to create a request similar to the following dictionary:
+    payload = {{"team_id": "90130119692"}}
+    """
+
+CLICKUP_UPDATE_TASK_PROMPT = """
+    This tool is a wrapper around clickup's API, 
+    useful when you need to update a specific attribute of a task. Given the task id, desired attribute to change and the new value you want to create a request similar to the following dictionary:
+    payload = {{"task_id": "<task_id_to_update>", "attribute_name": "<attribute_name_to_update>", "value": "<value_to_update_to>"}}
+
+    Here are some example queries their corresponding payloads:
+    Change the name of task 23jn23kjn to new task name -> {{"task_id": "23jn23kjn", "attribute_name": "name", "value": "new task name"}}
+    Update the priority of task 86a0t44tq to 1 -> {{"task_id": "86a0t44tq", "attribute_name": "priority", "value": 1}}
+    Re-write the description of task sdc9ds9jc to 'a new task description' -> {{"task_id": "sdc9ds9jc", "attribute_name": "description", "value": "a new task description"}}
+    Forward the status of task kjnsdcjc to done -> {{"task_id": "kjnsdcjc", "attribute_name": "description", "status": "done"}}
+    Increase the time estimate of task sjncsd999 to 3h -> {{"task_id": "sjncsd999", "attribute_name": "time_estimate", "value": 8000}}
+    Archive task jnsd98sd -> {{"task_id": "jnsd98sd", "attribute_name": "archive", "value": true}}
+    *IMPORTANT*: Pay attention to the exact syntax above and the correct use of quotes. 
+    For changing priority and time estimates, we expect integers (int).
+    For name, description and status we expect strings (str).
+    For archive, we expect a boolean (bool).
+    """
+
+CLICKUP_UPDATE_TASK_ASSIGNEE_PROMPT = """
+    This tool is a wrapper around clickup's API, 
+    useful when you need to update the assignees of a task. Given the task id, the operation add or remove (rem), and the list of user ids. You want to create a request similar to the following dictionary:
+    payload = {{"task_id": "<task_id_to_update>", "operation": "<operation, (add or rem)>", "users": [<user_id_1>, <user_id_2>]}}
+
+    Here are some example queries their corresponding payloads:
+    Add 81928627 and 3987234 as assignees to task 21hw21jn -> {{"task_id": "21hw21jn", "operation": "add", "users": [81928627, 3987234]}}
+    Remove 67823487 as assignee from task jin34ji4 -> {{"task_id": "jin34ji4", "operation": "rem", "users": [67823487]}}
+    *IMPORTANT*: Users id should always be ints. 
+    """
diff --git a/llm/Lib/site-packages/langchain_community/tools/clickup/tool.py b/llm/Lib/site-packages/langchain_community/tools/clickup/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..93988dd7d59f094ae46226f10dcbb151fe1da3f1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/clickup/tool.py
@@ -0,0 +1,42 @@
+"""
+This tool allows agents to interact with the clickup library
+and operate on a Clickup instance.
+To use this tool, you must first set as environment variables:
+    client_secret
+    client_id
+    code
+
+Below is a sample script that uses the Clickup tool:
+
+```python
+from langchain_community.agent_toolkits.clickup.toolkit import ClickupToolkit
+from langchain_community.utilities.clickup import ClickupAPIWrapper
+
+clickup = ClickupAPIWrapper()
+toolkit = ClickupToolkit.from_clickup_api_wrapper(clickup)
+```
+"""
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.clickup import ClickupAPIWrapper
+
+
+class ClickupAction(BaseTool):
+    """Tool that queries the  Clickup API."""
+
+    api_wrapper: ClickupAPIWrapper = Field(default_factory=ClickupAPIWrapper)
+    mode: str
+    name: str = ""
+    description: str = ""
+
+    def _run(
+        self,
+        instructions: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the  Clickup API to run an operation."""
+        return self.api_wrapper.run(self.mode, instructions)
diff --git a/llm/Lib/site-packages/langchain_community/tools/cogniswitch/__init__.py b/llm/Lib/site-packages/langchain_community/tools/cogniswitch/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3a89a8d7d3a9adbfc3edf3b7731d5a47f82fcd19
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/cogniswitch/__init__.py
@@ -0,0 +1 @@
+"Cogniswitch Tools"
diff --git a/llm/Lib/site-packages/langchain_community/tools/cogniswitch/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/cogniswitch/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f1fbeb1f9536e3ff0d5b6085d5ec40f96c105a70
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/cogniswitch/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/cogniswitch/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/cogniswitch/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..615556a8e9022855ae799c8168a9bbff03d5ceb0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/cogniswitch/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/cogniswitch/tool.py b/llm/Lib/site-packages/langchain_community/tools/cogniswitch/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..514b3b97b1648c496e7f03c48bb18ec7c6745bfc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/cogniswitch/tool.py
@@ -0,0 +1,399 @@
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+
+class CogniswitchKnowledgeRequest(BaseTool):
+    """Tool that uses the Cogniswitch service to answer questions.
+
+    name: str = "cogniswitch_knowledge_request"
+    description: str = (
+        "A wrapper around cogniswitch service to answer the question
+        from the knowledge base."
+        "Input should be a search query."
+    )
+    """
+
+    name: str = "cogniswitch_knowledge_request"
+    description: str = """A wrapper around cogniswitch service to 
+    answer the question from the knowledge base."""
+    cs_token: str
+    OAI_token: str
+    apiKey: str
+    api_url = "https://api.cogniswitch.ai:8243/cs-api/0.0.1/cs/knowledgeRequest"
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> Dict[str, Any]:
+        """
+        Use the tool to answer a query.
+
+        Args:
+            query (str): Natural language query,
+              that you would like to ask to your knowledge graph.
+            run_manager (Optional[CallbackManagerForChainRun]):
+            Manager for chain run callbacks.
+
+        Returns:
+            Dict[str, Any]: Output dictionary containing
+            the 'response' from the service.
+        """
+        response = self.answer_cs(self.cs_token, self.OAI_token, query, self.apiKey)
+        return response
+
+    def answer_cs(self, cs_token: str, OAI_token: str, query: str, apiKey: str) -> dict:
+        """
+        Send a query to the Cogniswitch service and retrieve the response.
+
+        Args:
+            cs_token (str): Cogniswitch token.
+            OAI_token (str): OpenAI token.
+            apiKey (str): OAuth token.
+            query (str): Query to be answered.
+
+        Returns:
+            dict: Response JSON from the Cogniswitch service.
+        """
+        if not cs_token:
+            raise ValueError("Missing cs_token")
+        if not OAI_token:
+            raise ValueError("Missing OpenAI token")
+        if not apiKey:
+            raise ValueError("Missing cogniswitch OAuth token")
+        if not query:
+            raise ValueError("Missing input query")
+
+        headers = {
+            "apiKey": apiKey,
+            "platformToken": cs_token,
+            "openAIToken": OAI_token,
+        }
+
+        data = {"query": query}
+        response = requests.post(self.api_url, headers=headers, verify=False, data=data)
+        return response.json()
+
+
+class CogniswitchKnowledgeStatus(BaseTool):
+    """Tool that uses the Cogniswitch services to get the
+     status of the document or url uploaded.
+
+    name: str = "cogniswitch_knowledge_status"
+    description: str = (
+        "A wrapper around cogniswitch services to know the status of
+         the document uploaded from a url or a file. "
+        "Input should be a file name or the url link"
+    )
+    """
+
+    name: str = "cogniswitch_knowledge_status"
+    description: str = """A wrapper around cogniswitch services to know 
+    the status of the document uploaded from a url or a file."""
+    cs_token: str
+    OAI_token: str
+    apiKey: str
+    knowledge_status_url = (
+        "https://api.cogniswitch.ai:8243/cs-api/0.0.1/cs/knowledgeSource/status"
+    )
+
+    def _run(
+        self,
+        document_name: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> Dict[str, Any]:
+        """
+        Use the tool to know the status of the document uploaded.
+
+        Args:
+            document_name (str): name of the document or
+            the url uploaded
+            run_manager (Optional[CallbackManagerForChainRun]):
+            Manager for chain run callbacks.
+
+        Returns:
+            Dict[str, Any]: Output dictionary containing
+            the 'response' from the service.
+        """
+        response = self.knowledge_status(document_name)
+        return response
+
+    def knowledge_status(self, document_name: str) -> dict:
+        """
+        Use this function to know the status of the document or the URL uploaded
+        Args:
+            document_name (str): The document name or the url that is uploaded.
+
+        Returns:
+            dict: Response JSON from the Cogniswitch service.
+        """
+
+        params = {"docName": document_name, "platformToken": self.cs_token}
+        headers = {
+            "apiKey": self.apiKey,
+            "openAIToken": self.OAI_token,
+            "platformToken": self.cs_token,
+        }
+        response = requests.get(
+            self.knowledge_status_url,
+            headers=headers,
+            params=params,
+            verify=False,
+        )
+        if response.status_code == 200:
+            source_info = response.json()
+            source_data = dict(source_info[-1])
+            status = source_data.get("status")
+            if status == 0:
+                source_data["status"] = "SUCCESS"
+            elif status == 1:
+                source_data["status"] = "PROCESSING"
+            elif status == 2:
+                source_data["status"] = "UPLOADED"
+            elif status == 3:
+                source_data["status"] = "FAILURE"
+            elif status == 4:
+                source_data["status"] = "UPLOAD_FAILURE"
+            elif status == 5:
+                source_data["status"] = "REJECTED"
+
+            if "filePath" in source_data.keys():
+                source_data.pop("filePath")
+            if "savedFileName" in source_data.keys():
+                source_data.pop("savedFileName")
+            if "integrationConfigId" in source_data.keys():
+                source_data.pop("integrationConfigId")
+            if "metaData" in source_data.keys():
+                source_data.pop("metaData")
+            if "docEntryId" in source_data.keys():
+                source_data.pop("docEntryId")
+            return source_data
+        else:
+            # error_message = response.json()["message"]
+            return {
+                "message": response.status_code,
+            }
+
+
+class CogniswitchKnowledgeSourceFile(BaseTool):
+    """Tool that uses the Cogniswitch services to store data from file.
+
+    name: str = "cogniswitch_knowledge_source_file"
+    description: str = (
+        "This calls the CogniSwitch services to analyze & store data from a file.
+        If the input looks like a file path, assign that string value to file key.
+        Assign document name & description only if provided in input."
+    )
+    """
+
+    name: str = "cogniswitch_knowledge_source_file"
+    description: str = """
+        This calls the CogniSwitch services to analyze & store data from a file. 
+        If the input looks like a file path, assign that string value to file key. 
+        Assign document name & description only if provided in input.
+        """
+    cs_token: str
+    OAI_token: str
+    apiKey: str
+    knowledgesource_file = (
+        "https://api.cogniswitch.ai:8243/cs-api/0.0.1/cs/knowledgeSource/file"
+    )
+
+    def _run(
+        self,
+        file: Optional[str] = None,
+        document_name: Optional[str] = None,
+        document_description: Optional[str] = None,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> Dict[str, Any]:
+        """
+        Execute the tool to store the data given from a file.
+        This calls the CogniSwitch services to analyze & store data from a file.
+        If the input looks like a file path, assign that string value to file key.
+        Assign document name & description only if provided in input.
+
+        Args:
+            file Optional[str]: The file path of your knowledge
+            document_name Optional[str]: Name of your knowledge document
+            document_description Optional[str]: Description of your knowledge document
+            run_manager (Optional[CallbackManagerForChainRun]):
+            Manager for chain run callbacks.
+
+        Returns:
+            Dict[str, Any]: Output dictionary containing
+            the 'response' from the service.
+        """
+        if not file:
+            return {
+                "message": "No input provided",
+            }
+        else:
+            response = self.store_data(
+                file=file,
+                document_name=document_name,
+                document_description=document_description,
+            )
+            return response
+
+    def store_data(
+        self,
+        file: Optional[str],
+        document_name: Optional[str],
+        document_description: Optional[str],
+    ) -> dict:
+        """
+        Store data using the Cogniswitch service.
+        This calls the CogniSwitch services to analyze & store data from a file.
+        If the input looks like a file path, assign that string value to file key.
+        Assign document name & description only if provided in input.
+
+        Args:
+            file (Optional[str]): file path of your file.
+            the current files supported by the files are
+            .txt, .pdf, .docx, .doc, .html
+            document_name (Optional[str]): Name of the document you are uploading.
+            document_description (Optional[str]): Description of the document.
+
+        Returns:
+            dict: Response JSON from the Cogniswitch service.
+        """
+        headers = {
+            "apiKey": self.apiKey,
+            "openAIToken": self.OAI_token,
+            "platformToken": self.cs_token,
+        }
+        data: Dict[str, Any]
+        if not document_name:
+            document_name = ""
+        if not document_description:
+            document_description = ""
+
+        if file is not None:
+            files = {"file": open(file, "rb")}
+
+        data = {
+            "documentName": document_name,
+            "documentDescription": document_description,
+        }
+        response = requests.post(
+            self.knowledgesource_file,
+            headers=headers,
+            verify=False,
+            data=data,
+            files=files,
+        )
+        if response.status_code == 200:
+            return response.json()
+        else:
+            return {"message": "Bad Request"}
+
+
+class CogniswitchKnowledgeSourceURL(BaseTool):
+    """Tool that uses the Cogniswitch services to store data from a URL.
+
+    name: str = "cogniswitch_knowledge_source_url"
+    description: str = (
+        "This calls the CogniSwitch services to analyze & store data from a url.
+        the URL is provided in input, assign that value to the url key.
+        Assign document name & description only if provided in input"
+    )
+    """
+
+    name: str = "cogniswitch_knowledge_source_url"
+    description: str = """
+    This calls the CogniSwitch services to analyze & store data from a url. 
+        the URL is provided in input, assign that value to the url key. 
+        Assign document name & description only if provided in input"""
+    cs_token: str
+    OAI_token: str
+    apiKey: str
+    knowledgesource_url = (
+        "https://api.cogniswitch.ai:8243/cs-api/0.0.1/cs/knowledgeSource/url"
+    )
+
+    def _run(
+        self,
+        url: Optional[str] = None,
+        document_name: Optional[str] = None,
+        document_description: Optional[str] = None,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> Dict[str, Any]:
+        """
+        Execute the tool to store the data given from a url.
+        This calls the CogniSwitch services to analyze & store data from a url.
+        the URL is provided in input, assign that value to the url key.
+        Assign document name & description only if provided in input.
+
+        Args:
+            url Optional[str]: The website/url link of your knowledge
+            document_name Optional[str]: Name of your knowledge document
+            document_description Optional[str]: Description of your knowledge document
+            run_manager (Optional[CallbackManagerForChainRun]):
+            Manager for chain run callbacks.
+
+        Returns:
+            Dict[str, Any]: Output dictionary containing
+            the 'response' from the service.
+        """
+        if not url:
+            return {
+                "message": "No input provided",
+            }
+        response = self.store_data(
+            url=url,
+            document_name=document_name,
+            document_description=document_description,
+        )
+        return response
+
+    def store_data(
+        self,
+        url: Optional[str],
+        document_name: Optional[str],
+        document_description: Optional[str],
+    ) -> dict:
+        """
+        Store data using the Cogniswitch service.
+        This calls the CogniSwitch services to analyze & store data from a url.
+        the URL is provided in input, assign that value to the url key.
+        Assign document name & description only if provided in input.
+
+        Args:
+            url (Optional[str]): URL link.
+            document_name (Optional[str]): Name of the document you are uploading.
+            document_description (Optional[str]): Description of the document.
+
+        Returns:
+            dict: Response JSON from the Cogniswitch service.
+        """
+        headers = {
+            "apiKey": self.apiKey,
+            "openAIToken": self.OAI_token,
+            "platformToken": self.cs_token,
+        }
+        data: Dict[str, Any]
+        if not document_name:
+            document_name = ""
+        if not document_description:
+            document_description = ""
+        if not url:
+            return {
+                "message": "No input provided",
+            }
+        else:
+            data = {"url": url}
+            response = requests.post(
+                self.knowledgesource_url,
+                headers=headers,
+                verify=False,
+                data=data,
+            )
+        if response.status_code == 200:
+            return response.json()
+        else:
+            return {"message": "Bad Request"}
diff --git a/llm/Lib/site-packages/langchain_community/tools/connery/__init__.py b/llm/Lib/site-packages/langchain_community/tools/connery/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1fcf2760ba18148b6681f326261b80f780696759
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/connery/__init__.py
@@ -0,0 +1,8 @@
+"""
+This module contains the ConneryAction Tool and ConneryService.
+"""
+
+from .service import ConneryService
+from .tool import ConneryAction
+
+__all__ = ["ConneryAction", "ConneryService"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/connery/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/connery/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..098a013f9f3d79441dcfae3f1c8a0b26fb765e41
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/connery/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/connery/__pycache__/models.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/connery/__pycache__/models.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..96d9cf095e592e3499e793cbc2d60cd80690619f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/connery/__pycache__/models.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/connery/__pycache__/service.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/connery/__pycache__/service.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8696434abe11753181c2e5d4f81f76c6766d2fd7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/connery/__pycache__/service.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/connery/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/connery/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ee41b63b414405f846486c8040ef860694243ee7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/connery/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/connery/models.py b/llm/Lib/site-packages/langchain_community/tools/connery/models.py
new file mode 100644
index 0000000000000000000000000000000000000000..a8292e62b9e4271a4f03081685511ba4ea1b75fe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/connery/models.py
@@ -0,0 +1,32 @@
+from typing import List, Optional
+
+from langchain_core.pydantic_v1 import BaseModel
+
+
+class Validation(BaseModel):
+    """Connery Action parameter validation model."""
+
+    required: Optional[bool] = None
+
+
+class Parameter(BaseModel):
+    """Connery Action parameter model."""
+
+    key: str
+    title: str
+    description: Optional[str] = None
+    type: str
+    validation: Optional[Validation] = None
+
+
+class Action(BaseModel):
+    """Connery Action model."""
+
+    id: str
+    key: str
+    title: str
+    description: Optional[str] = None
+    type: str
+    inputParameters: List[Parameter]
+    outputParameters: List[Parameter]
+    pluginId: str
diff --git a/llm/Lib/site-packages/langchain_community/tools/connery/service.py b/llm/Lib/site-packages/langchain_community/tools/connery/service.py
new file mode 100644
index 0000000000000000000000000000000000000000..b8606a9317ab71eb6ae0d3438c49b465cc219821
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/connery/service.py
@@ -0,0 +1,165 @@
+import json
+from typing import Dict, List, Optional
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.utils.env import get_from_dict_or_env
+
+from langchain_community.tools.connery.models import Action
+from langchain_community.tools.connery.tool import ConneryAction
+
+
+class ConneryService(BaseModel):
+    """Service for interacting with the Connery Runner API.
+
+    It gets the list of available actions from the Connery Runner,
+    wraps them in ConneryAction Tools and returns them to the user.
+    It also provides a method for running the actions.
+    """
+
+    runner_url: Optional[str] = None
+    api_key: Optional[str] = None
+
+    @root_validator()
+    def validate_attributes(cls, values: Dict) -> Dict:
+        """
+        Validate the attributes of the ConneryService class.
+        Parameters:
+            values (dict): The arguments to validate.
+        Returns:
+            dict: The validated arguments.
+        """
+
+        runner_url = get_from_dict_or_env(values, "runner_url", "CONNERY_RUNNER_URL")
+        api_key = get_from_dict_or_env(values, "api_key", "CONNERY_RUNNER_API_KEY")
+
+        if not runner_url:
+            raise ValueError("CONNERY_RUNNER_URL environment variable must be set.")
+        if not api_key:
+            raise ValueError("CONNERY_RUNNER_API_KEY environment variable must be set.")
+
+        values["runner_url"] = runner_url
+        values["api_key"] = api_key
+
+        return values
+
+    def list_actions(self) -> List[ConneryAction]:
+        """
+        Returns the list of actions available in the Connery Runner.
+        Returns:
+            List[ConneryAction]: The list of actions available in the Connery Runner.
+        """
+
+        return [
+            ConneryAction.create_instance(action, self)
+            for action in self._list_actions()
+        ]
+
+    def get_action(self, action_id: str) -> ConneryAction:
+        """
+        Returns the specified action available in the Connery Runner.
+        Parameters:
+            action_id (str): The ID of the action to return.
+        Returns:
+            ConneryAction: The action with the specified ID.
+        """
+
+        return ConneryAction.create_instance(self._get_action(action_id), self)
+
+    def run_action(self, action_id: str, input: Dict[str, str] = {}) -> Dict[str, str]:
+        """
+        Runs the specified Connery Action with the provided input.
+        Parameters:
+            action_id (str): The ID of the action to run.
+            input (Dict[str, str]): The input object expected by the action.
+        Returns:
+            Dict[str, str]: The output of the action.
+        """
+
+        return self._run_action(action_id, input)
+
+    def _list_actions(self) -> List[Action]:
+        """
+        Returns the list of actions available in the Connery Runner.
+        Returns:
+            List[Action]: The list of actions available in the Connery Runner.
+        """
+
+        response = requests.get(
+            f"{self.runner_url}/v1/actions", headers=self._get_headers()
+        )
+
+        if not response.ok:
+            raise ValueError(
+                (
+                    "Failed to list actions."
+                    f"Status code: {response.status_code}."
+                    f"Error message: {response.json()['error']['message']}"
+                )
+            )
+
+        return [Action(**action) for action in response.json()["data"]]
+
+    def _get_action(self, action_id: str) -> Action:
+        """
+        Returns the specified action available in the Connery Runner.
+        Parameters:
+            action_id (str): The ID of the action to return.
+        Returns:
+            Action: The action with the specified ID.
+        """
+
+        actions = self._list_actions()
+        action = next((action for action in actions if action.id == action_id), None)
+        if not action:
+            raise ValueError(
+                (
+                    f"The action with ID {action_id} was not found in the list"
+                    "of available actions in the Connery Runner."
+                )
+            )
+        return action
+
+    def _run_action(self, action_id: str, input: Dict[str, str] = {}) -> Dict[str, str]:
+        """
+        Runs the specified Connery Action with the provided input.
+        Parameters:
+            action_id (str): The ID of the action to run.
+            prompt (str): This is a plain English prompt
+            with all the information needed to run the action.
+            input (Dict[str, str]): The input object expected by the action.
+            If provided together with the prompt,
+            the input takes precedence over the input specified in the prompt.
+        Returns:
+            Dict[str, str]: The output of the action.
+        """
+
+        response = requests.post(
+            f"{self.runner_url}/v1/actions/{action_id}/run",
+            headers=self._get_headers(),
+            data=json.dumps({"input": input}),
+        )
+
+        if not response.ok:
+            raise ValueError(
+                (
+                    "Failed to run action."
+                    f"Status code: {response.status_code}."
+                    f"Error message: {response.json()['error']['message']}"
+                )
+            )
+
+        if not response.json()["data"]["output"]:
+            return {}
+        else:
+            return response.json()["data"]["output"]
+
+    def _get_headers(self) -> Dict[str, str]:
+        """
+        Returns a standard set of HTTP headers
+        to be used in API calls to the Connery runner.
+        Returns:
+            Dict[str, str]: The standard set of HTTP headers.
+        """
+
+        return {"Content-Type": "application/json", "x-api-key": self.api_key or ""}
diff --git a/llm/Lib/site-packages/langchain_community/tools/connery/tool.py b/llm/Lib/site-packages/langchain_community/tools/connery/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..51138714e26ffdb9e28ccf1d5f615eb4adb4ca4b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/connery/tool.py
@@ -0,0 +1,161 @@
+import asyncio
+from functools import partial
+from typing import Any, Dict, List, Optional, Type
+
+from langchain_core.callbacks.manager import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field, create_model, root_validator
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.connery.models import Action, Parameter
+
+
+class ConneryAction(BaseTool):
+    """Connery Action tool."""
+
+    name: str
+    description: str
+    args_schema: Type[BaseModel]
+
+    action: Action
+    connery_service: Any
+
+    def _run(
+        self,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+        **kwargs: Dict[str, str],
+    ) -> Dict[str, str]:
+        """
+        Runs the Connery Action with the provided input.
+        Parameters:
+            kwargs (Dict[str, str]): The input dictionary expected by the action.
+        Returns:
+            Dict[str, str]: The output of the action.
+        """
+
+        return self.connery_service.run_action(self.action.id, kwargs)
+
+    async def _arun(
+        self,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+        **kwargs: Dict[str, str],
+    ) -> Dict[str, str]:
+        """
+        Runs the Connery Action asynchronously with the provided input.
+        Parameters:
+            kwargs (Dict[str, str]): The input dictionary expected by the action.
+        Returns:
+            Dict[str, str]: The output of the action.
+        """
+
+        func = partial(self._run, **kwargs)
+        return await asyncio.get_event_loop().run_in_executor(None, func)
+
+    def get_schema_json(self) -> str:
+        """
+        Returns the JSON representation of the Connery Action Tool schema.
+        This is useful for debugging.
+        Returns:
+            str: The JSON representation of the Connery Action Tool schema.
+        """
+
+        return self.args_schema.schema_json(indent=2)
+
+    @root_validator()
+    def validate_attributes(cls, values: dict) -> dict:
+        """
+        Validate the attributes of the ConneryAction class.
+        Parameters:
+            values (dict): The arguments to validate.
+        Returns:
+            dict: The validated arguments.
+        """
+
+        # Import ConneryService here and check if it is an instance
+        # of ConneryService to avoid circular imports
+        from .service import ConneryService
+
+        if not isinstance(values.get("connery_service"), ConneryService):
+            raise ValueError(
+                "The attribute 'connery_service' must be an instance of ConneryService."
+            )
+
+        if not values.get("name"):
+            raise ValueError("The attribute 'name' must be set.")
+        if not values.get("description"):
+            raise ValueError("The attribute 'description' must be set.")
+        if not values.get("args_schema"):
+            raise ValueError("The attribute 'args_schema' must be set.")
+        if not values.get("action"):
+            raise ValueError("The attribute 'action' must be set.")
+        if not values.get("connery_service"):
+            raise ValueError("The attribute 'connery_service' must be set.")
+
+        return values
+
+    @classmethod
+    def create_instance(cls, action: Action, connery_service: Any) -> "ConneryAction":
+        """
+        Creates a Connery Action Tool from a Connery Action.
+        Parameters:
+            action (Action): The Connery Action to wrap in a Connery Action Tool.
+            connery_service (ConneryService): The Connery Service
+            to run the Connery Action. We use Any here to avoid circular imports.
+        Returns:
+            ConneryAction: The Connery Action Tool.
+        """
+
+        # Import ConneryService here and check if it is an instance
+        # of ConneryService to avoid circular imports
+        from .service import ConneryService
+
+        if not isinstance(connery_service, ConneryService):
+            raise ValueError(
+                "The connery_service must be an instance of ConneryService."
+            )
+
+        input_schema = cls._create_input_schema(action.inputParameters)
+        description = action.title + (
+            ": " + action.description if action.description else ""
+        )
+
+        instance = cls(
+            name=action.id,
+            description=description,
+            args_schema=input_schema,
+            action=action,
+            connery_service=connery_service,
+        )
+
+        return instance
+
+    @classmethod
+    def _create_input_schema(cls, inputParameters: List[Parameter]) -> Type[BaseModel]:
+        """
+        Creates an input schema for a Connery Action Tool
+        based on the input parameters of the Connery Action.
+        Parameters:
+            inputParameters: List of input parameters of the Connery Action.
+        Returns:
+            Type[BaseModel]: The input schema for the Connery Action Tool.
+        """
+
+        dynamic_input_fields: Dict[str, Any] = {}
+
+        for param in inputParameters:
+            default = ... if param.validation and param.validation.required else None
+            title = param.title
+            description = param.title + (
+                ": " + param.description if param.description else ""
+            )
+            type = param.type
+
+            dynamic_input_fields[param.key] = (
+                str,
+                Field(default, title=title, description=description, type=type),
+            )
+
+        InputModel = create_model("InputSchema", **dynamic_input_fields)
+        return InputModel
diff --git a/llm/Lib/site-packages/langchain_community/tools/convert_to_openai.py b/llm/Lib/site-packages/langchain_community/tools/convert_to_openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..423f927127a7d23b529c8cead59ea37a04045fa7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/convert_to_openai.py
@@ -0,0 +1,6 @@
+from langchain_core.utils.function_calling import (
+    format_tool_to_openai_function,
+    format_tool_to_openai_tool,
+)
+
+__all__ = ["format_tool_to_openai_function", "format_tool_to_openai_tool"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/dataforseo_api_search/__init__.py b/llm/Lib/site-packages/langchain_community/tools/dataforseo_api_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e2cd9efe9e90515eb1f0e1a2c3f4ecf0a65fdff
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/dataforseo_api_search/__init__.py
@@ -0,0 +1,9 @@
+from langchain_community.tools.dataforseo_api_search.tool import (
+    DataForSeoAPISearchResults,
+    DataForSeoAPISearchRun,
+)
+
+"""DataForSeo API Toolkit."""
+"""Tool for the DataForSeo SERP API."""
+
+__all__ = ["DataForSeoAPISearchRun", "DataForSeoAPISearchResults"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/dataforseo_api_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/dataforseo_api_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..13dc4cd7263ccd264a992d36de70bbec6ae8008d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/dataforseo_api_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/dataforseo_api_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/dataforseo_api_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4b4db3e1270a6e3ef5bdb9ce5490be6a6fb2dac3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/dataforseo_api_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/dataforseo_api_search/tool.py b/llm/Lib/site-packages/langchain_community/tools/dataforseo_api_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d601df59adcff8c5e565f1d3959c71511ac91f4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/dataforseo_api_search/tool.py
@@ -0,0 +1,71 @@
+"""Tool for the DataForSeo SERP API."""
+
+from typing import Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.dataforseo_api_search import DataForSeoAPIWrapper
+
+
+class DataForSeoAPISearchRun(BaseTool):
+    """Tool that queries the DataForSeo Google search API."""
+
+    name: str = "dataforseo_api_search"
+    description: str = (
+        "A robust Google Search API provided by DataForSeo."
+        "This tool is handy when you need information about trending topics "
+        "or current events."
+    )
+    api_wrapper: DataForSeoAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return str(self.api_wrapper.run(query))
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+        return (await self.api_wrapper.arun(query)).__str__()
+
+
+class DataForSeoAPISearchResults(BaseTool):
+    """Tool that queries the DataForSeo Google Search API
+    and get back json."""
+
+    name: str = "dataforseo_results_json"
+    description: str = (
+        "A comprehensive Google Search API provided by DataForSeo."
+        "This tool is useful for obtaining real-time data on current events "
+        "or popular searches."
+        "The input should be a search query and the output is a JSON object "
+        "of the query results."
+    )
+    api_wrapper: DataForSeoAPIWrapper = Field(default_factory=DataForSeoAPIWrapper)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return str(self.api_wrapper.results(query))
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+        return (await self.api_wrapper.aresults(query)).__str__()
diff --git a/llm/Lib/site-packages/langchain_community/tools/dataherald/__init__.py b/llm/Lib/site-packages/langchain_community/tools/dataherald/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..319d19b8e7f0969157ef37f63e2a59a096898e72
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/dataherald/__init__.py
@@ -0,0 +1,8 @@
+"""Dataherald API toolkit."""
+
+
+from langchain_community.tools.dataherald.tool import DataheraldTextToSQL
+
+__all__ = [
+    "DataheraldTextToSQL",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/dataherald/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/dataherald/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e4a2c753d628666c4e870dc304c2d2c6f6bfd621
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/dataherald/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/dataherald/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/dataherald/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..245a0706ff06d052c8bf2bea9296b61fdfc1c93f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/dataherald/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/dataherald/tool.py b/llm/Lib/site-packages/langchain_community/tools/dataherald/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..90c4cef7102d8812fbbc85d994f8c1a956224663
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/dataherald/tool.py
@@ -0,0 +1,36 @@
+"""Tool for the Dataherald Hosted API"""
+
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.dataherald import DataheraldAPIWrapper
+
+
+class DataheraldTextToSQLInput(BaseModel):
+    prompt: str = Field(
+        description="Natural language query to be translated to a SQL query."
+    )
+
+
+class DataheraldTextToSQL(BaseTool):
+    """Tool that queries using the Dataherald SDK."""
+
+    name: str = "dataherald"
+    description: str = (
+        "A wrapper around Dataherald. "
+        "Text to SQL. "
+        "Input should be a prompt and an existing db_connection_id"
+    )
+    api_wrapper: DataheraldAPIWrapper
+    args_schema: Type[BaseModel] = DataheraldTextToSQLInput
+
+    def _run(
+        self,
+        prompt: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Dataherald tool."""
+        return self.api_wrapper.run(prompt)
diff --git a/llm/Lib/site-packages/langchain_community/tools/ddg_search/__init__.py b/llm/Lib/site-packages/langchain_community/tools/ddg_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5b7de286b8916b86ec154ab9e799f168f363d62e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/ddg_search/__init__.py
@@ -0,0 +1,5 @@
+"""DuckDuckGo Search API toolkit."""
+
+from langchain_community.tools.ddg_search.tool import DuckDuckGoSearchRun
+
+__all__ = ["DuckDuckGoSearchRun"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/ddg_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/ddg_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8b6866abde2aff15c91e0e4c3e11df0661a5dfb3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/ddg_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/ddg_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/ddg_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..784b96f870cb471896e4bc343b803a252ce8770b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/ddg_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/ddg_search/tool.py b/llm/Lib/site-packages/langchain_community/tools/ddg_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9f1b8adb2a418b19269e364501e47e01975ff8b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/ddg_search/tool.py
@@ -0,0 +1,85 @@
+"""Tool for the DuckDuckGo search API."""
+
+import warnings
+from typing import Any, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.duckduckgo_search import DuckDuckGoSearchAPIWrapper
+
+
+class DDGInput(BaseModel):
+    """Input for the DuckDuckGo search tool."""
+
+    query: str = Field(description="search query to look up")
+
+
+class DuckDuckGoSearchRun(BaseTool):
+    """Tool that queries the DuckDuckGo search API."""
+
+    name: str = "duckduckgo_search"
+    description: str = (
+        "A wrapper around DuckDuckGo Search. "
+        "Useful for when you need to answer questions about current events. "
+        "Input should be a search query."
+    )
+    api_wrapper: DuckDuckGoSearchAPIWrapper = Field(
+        default_factory=DuckDuckGoSearchAPIWrapper
+    )
+    args_schema: Type[BaseModel] = DDGInput
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.api_wrapper.run(query)
+
+
+class DuckDuckGoSearchResults(BaseTool):
+    """Tool that queries the DuckDuckGo search API and gets back json."""
+
+    name: str = "duckduckgo_results_json"
+    description: str = (
+        "A wrapper around Duck Duck Go Search. "
+        "Useful for when you need to answer questions about current events. "
+        "Input should be a search query. Output is a JSON array of the query results"
+    )
+    max_results: int = Field(alias="num_results", default=4)
+    api_wrapper: DuckDuckGoSearchAPIWrapper = Field(
+        default_factory=DuckDuckGoSearchAPIWrapper
+    )
+    backend: str = "text"
+    args_schema: Type[BaseModel] = DDGInput
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        res = self.api_wrapper.results(query, self.max_results, source=self.backend)
+        res_strs = [", ".join([f"{k}: {v}" for k, v in d.items()]) for d in res]
+        return ", ".join([f"[{rs}]" for rs in res_strs])
+
+
+def DuckDuckGoSearchTool(*args: Any, **kwargs: Any) -> DuckDuckGoSearchRun:
+    """
+    Deprecated. Use DuckDuckGoSearchRun instead.
+
+    Args:
+        *args:
+        **kwargs:
+
+    Returns:
+        DuckDuckGoSearchRun
+    """
+    warnings.warn(
+        "DuckDuckGoSearchTool will be deprecated in the future. "
+        "Please use DuckDuckGoSearchRun instead.",
+        DeprecationWarning,
+    )
+    return DuckDuckGoSearchRun(*args, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/__init__.py b/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fa415365a6db5b7f2bbd234946ed81536b416d74
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..72b0594162d831bab800401d1686017118287514
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/__pycache__/unparse.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/__pycache__/unparse.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..79db11e8c412bb4aa4b09ddb66789c7439fbb668
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/__pycache__/unparse.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/tool.py b/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..242b305e1bc51d64853689218e9bf8e4285e6935
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/tool.py
@@ -0,0 +1,243 @@
+from __future__ import annotations
+
+import ast
+import json
+import os
+from io import StringIO
+from sys import version_info
+from typing import IO, TYPE_CHECKING, Any, Callable, List, Optional, Type, Union
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManager,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field, PrivateAttr
+
+from langchain_community.tools import BaseTool, Tool
+from langchain_community.tools.e2b_data_analysis.unparse import Unparser
+
+if TYPE_CHECKING:
+    from e2b import EnvVars
+    from e2b.templates.data_analysis import Artifact
+
+base_description = """Evaluates python code in a sandbox environment. \
+The environment is long running and exists across multiple executions. \
+You must send the whole script every time and print your outputs. \
+Script should be pure python code that can be evaluated. \
+It should be in python format NOT markdown. \
+The code should NOT be wrapped in backticks. \
+All python packages including requests, matplotlib, scipy, numpy, pandas, \
+etc are available. Create and display chart using `plt.show()`."""
+
+
+def _unparse(tree: ast.AST) -> str:
+    """Unparse the AST."""
+    if version_info.minor < 9:
+        s = StringIO()
+        Unparser(tree, file=s)
+        source_code = s.getvalue()
+        s.close()
+    else:
+        source_code = ast.unparse(tree)  # type: ignore[attr-defined]
+    return source_code
+
+
+def add_last_line_print(code: str) -> str:
+    """Add print statement to the last line if it's missing.
+
+    Sometimes, the LLM-generated code doesn't have `print(variable_name)`, instead the
+        LLM tries to print the variable only by writing `variable_name` (as you would in
+        REPL, for example).
+
+    This methods checks the AST of the generated Python code and adds the print
+        statement to the last line if it's missing.
+    """
+    tree = ast.parse(code)
+    node = tree.body[-1]
+    if isinstance(node, ast.Expr) and isinstance(node.value, ast.Call):
+        if isinstance(node.value.func, ast.Name) and node.value.func.id == "print":
+            return _unparse(tree)
+
+    if isinstance(node, ast.Expr):
+        tree.body[-1] = ast.Expr(
+            value=ast.Call(
+                func=ast.Name(id="print", ctx=ast.Load()),
+                args=[node.value],
+                keywords=[],
+            )
+        )
+
+    return _unparse(tree)
+
+
+class UploadedFile(BaseModel):
+    """Description of the uploaded path with its remote path."""
+
+    name: str
+    remote_path: str
+    description: str
+
+
+class E2BDataAnalysisToolArguments(BaseModel):
+    """Arguments for the E2BDataAnalysisTool."""
+
+    python_code: str = Field(
+        ...,
+        example="print('Hello World')",
+        description=(
+            "The python script to be evaluated. "
+            "The contents will be in main.py. "
+            "It should not be in markdown format."
+        ),
+    )
+
+
+class E2BDataAnalysisTool(BaseTool):
+    """Tool for running python code in a sandboxed environment for data analysis."""
+
+    name = "e2b_data_analysis"
+    args_schema: Type[BaseModel] = E2BDataAnalysisToolArguments
+    session: Any
+    description: str
+    _uploaded_files: List[UploadedFile] = PrivateAttr(default_factory=list)
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        cwd: Optional[str] = None,
+        env_vars: Optional[EnvVars] = None,
+        on_stdout: Optional[Callable[[str], Any]] = None,
+        on_stderr: Optional[Callable[[str], Any]] = None,
+        on_artifact: Optional[Callable[[Artifact], Any]] = None,
+        on_exit: Optional[Callable[[int], Any]] = None,
+        **kwargs: Any,
+    ):
+        try:
+            from e2b import DataAnalysis
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import e2b, please install with `pip install e2b`."
+            ) from e
+
+        # If no API key is provided, E2B will try to read it from the environment
+        # variable E2B_API_KEY
+        super().__init__(description=base_description, **kwargs)
+        self.session = DataAnalysis(
+            api_key=api_key,
+            cwd=cwd,
+            env_vars=env_vars,
+            on_stdout=on_stdout,
+            on_stderr=on_stderr,
+            on_exit=on_exit,
+            on_artifact=on_artifact,
+        )
+
+    def close(self) -> None:
+        """Close the cloud sandbox."""
+        self._uploaded_files = []
+        self.session.close()
+
+    @property
+    def uploaded_files_description(self) -> str:
+        if len(self._uploaded_files) == 0:
+            return ""
+        lines = ["The following files available in the sandbox:"]
+
+        for f in self._uploaded_files:
+            if f.description == "":
+                lines.append(f"- path: `{f.remote_path}`")
+            else:
+                lines.append(
+                    f"- path: `{f.remote_path}` \n description: `{f.description}`"
+                )
+        return "\n".join(lines)
+
+    def _run(
+        self,
+        python_code: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+        callbacks: Optional[CallbackManager] = None,
+    ) -> str:
+        python_code = add_last_line_print(python_code)
+
+        if callbacks is not None:
+            on_artifact = getattr(callbacks.metadata, "on_artifact", None)
+        else:
+            on_artifact = None
+
+        stdout, stderr, artifacts = self.session.run_python(
+            python_code, on_artifact=on_artifact
+        )
+
+        out = {
+            "stdout": stdout,
+            "stderr": stderr,
+            "artifacts": list(map(lambda artifact: artifact.name, artifacts)),
+        }
+        return json.dumps(out)
+
+    async def _arun(
+        self,
+        python_code: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        raise NotImplementedError("e2b_data_analysis does not support async")
+
+    def run_command(
+        self,
+        cmd: str,
+    ) -> dict:
+        """Run shell command in the sandbox."""
+        proc = self.session.process.start(cmd)
+        output = proc.wait()
+        return {
+            "stdout": output.stdout,
+            "stderr": output.stderr,
+            "exit_code": output.exit_code,
+        }
+
+    def install_python_packages(self, package_names: Union[str, List[str]]) -> None:
+        """Install python packages in the sandbox."""
+        self.session.install_python_packages(package_names)
+
+    def install_system_packages(self, package_names: Union[str, List[str]]) -> None:
+        """Install system packages (via apt) in the sandbox."""
+        self.session.install_system_packages(package_names)
+
+    def download_file(self, remote_path: str) -> bytes:
+        """Download file from the sandbox."""
+        return self.session.download_file(remote_path)
+
+    def upload_file(self, file: IO, description: str) -> UploadedFile:
+        """Upload file to the sandbox.
+
+        The file is uploaded to the '/home/user/<filename>' path."""
+        remote_path = self.session.upload_file(file)
+
+        f = UploadedFile(
+            name=os.path.basename(file.name),
+            remote_path=remote_path,
+            description=description,
+        )
+        self._uploaded_files.append(f)
+        self.description = self.description + "\n" + self.uploaded_files_description
+        return f
+
+    def remove_uploaded_file(self, uploaded_file: UploadedFile) -> None:
+        """Remove uploaded file from the sandbox."""
+        self.session.filesystem.remove(uploaded_file.remote_path)
+        self._uploaded_files = [
+            f
+            for f in self._uploaded_files
+            if f.remote_path != uploaded_file.remote_path
+        ]
+        self.description = self.description + "\n" + self.uploaded_files_description
+
+    def as_tool(self) -> Tool:
+        return Tool.from_function(
+            func=self._run,
+            name=self.name,
+            description=self.description,
+            args_schema=self.args_schema,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/unparse.py b/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/unparse.py
new file mode 100644
index 0000000000000000000000000000000000000000..0090596e3732034d5453bd1471384ae1342f8d34
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/e2b_data_analysis/unparse.py
@@ -0,0 +1,744 @@
+# mypy: disable-error-code=no-untyped-def
+# Because Python >3.9 doesn't support ast.unparse,
+# we copied the unparse functionality from here:
+# https://github.com/python/cpython/blob/3.8/Tools/parser/unparse.py
+"Usage: unparse.py <path to source file>"
+import ast
+import io
+import sys
+import tokenize
+
+# Large float and imaginary literals get turned into infinities in the AST.
+# We unparse those infinities to INFSTR.
+INFSTR = "1e" + repr(sys.float_info.max_10_exp + 1)
+
+
+def interleave(inter, f, seq):
+    """Call f on each item in seq, calling inter() in between."""
+    seq = iter(seq)
+    try:
+        f(next(seq))
+    except StopIteration:
+        pass
+    else:
+        for x in seq:
+            inter()
+            f(x)
+
+
+class Unparser:
+    """Methods in this class recursively traverse an AST and
+    output source code for the abstract syntax; original formatting
+    is disregarded."""
+
+    def __init__(self, tree, file=sys.stdout):
+        """Unparser(tree, file=sys.stdout) -> None.
+        Print the source for tree to file."""
+        self.f = file
+        self._indent = 0
+        self.dispatch(tree)
+        self.f.flush()
+
+    def fill(self, text=""):
+        "Indent a piece of text, according to the current indentation level"
+        self.f.write("\n" + "    " * self._indent + text)
+
+    def write(self, text):
+        "Append a piece of text to the current line."
+        self.f.write(text)
+
+    def enter(self):
+        "Print ':', and increase the indentation."
+        self.write(":")
+        self._indent += 1
+
+    def leave(self):
+        "Decrease the indentation level."
+        self._indent -= 1
+
+    def dispatch(self, tree):
+        "Dispatcher function, dispatching tree type T to method _T."
+        if isinstance(tree, list):
+            for t in tree:
+                self.dispatch(t)
+            return
+        meth = getattr(self, "_" + tree.__class__.__name__)
+        meth(tree)
+
+    ############### Unparsing methods ######################
+    # There should be one method per concrete grammar type #
+    # Constructors should be grouped by sum type. Ideally, #
+    # this would follow the order in the grammar, but      #
+    # currently doesn't.                                   #
+    ########################################################
+
+    def _Module(self, tree):
+        for stmt in tree.body:
+            self.dispatch(stmt)
+
+    # stmt
+    def _Expr(self, tree):
+        self.fill()
+        self.dispatch(tree.value)
+
+    def _NamedExpr(self, tree):
+        self.write("(")
+        self.dispatch(tree.target)
+        self.write(" := ")
+        self.dispatch(tree.value)
+        self.write(")")
+
+    def _Import(self, t):
+        self.fill("import ")
+        interleave(lambda: self.write(", "), self.dispatch, t.names)
+
+    def _ImportFrom(self, t):
+        self.fill("from ")
+        self.write("." * t.level)
+        if t.module:
+            self.write(t.module)
+        self.write(" import ")
+        interleave(lambda: self.write(", "), self.dispatch, t.names)
+
+    def _Assign(self, t):
+        self.fill()
+        for target in t.targets:
+            self.dispatch(target)
+            self.write(" = ")
+        self.dispatch(t.value)
+
+    def _AugAssign(self, t):
+        self.fill()
+        self.dispatch(t.target)
+        self.write(" " + self.binop[t.op.__class__.__name__] + "= ")
+        self.dispatch(t.value)
+
+    def _AnnAssign(self, t):
+        self.fill()
+        if not t.simple and isinstance(t.target, ast.Name):
+            self.write("(")
+        self.dispatch(t.target)
+        if not t.simple and isinstance(t.target, ast.Name):
+            self.write(")")
+        self.write(": ")
+        self.dispatch(t.annotation)
+        if t.value:
+            self.write(" = ")
+            self.dispatch(t.value)
+
+    def _Return(self, t):
+        self.fill("return")
+        if t.value:
+            self.write(" ")
+            self.dispatch(t.value)
+
+    def _Pass(self, t):
+        self.fill("pass")
+
+    def _Break(self, t):
+        self.fill("break")
+
+    def _Continue(self, t):
+        self.fill("continue")
+
+    def _Delete(self, t):
+        self.fill("del ")
+        interleave(lambda: self.write(", "), self.dispatch, t.targets)
+
+    def _Assert(self, t):
+        self.fill("assert ")
+        self.dispatch(t.test)
+        if t.msg:
+            self.write(", ")
+            self.dispatch(t.msg)
+
+    def _Global(self, t):
+        self.fill("global ")
+        interleave(lambda: self.write(", "), self.write, t.names)
+
+    def _Nonlocal(self, t):
+        self.fill("nonlocal ")
+        interleave(lambda: self.write(", "), self.write, t.names)
+
+    def _Await(self, t):
+        self.write("(")
+        self.write("await")
+        if t.value:
+            self.write(" ")
+            self.dispatch(t.value)
+        self.write(")")
+
+    def _Yield(self, t):
+        self.write("(")
+        self.write("yield")
+        if t.value:
+            self.write(" ")
+            self.dispatch(t.value)
+        self.write(")")
+
+    def _YieldFrom(self, t):
+        self.write("(")
+        self.write("yield from")
+        if t.value:
+            self.write(" ")
+            self.dispatch(t.value)
+        self.write(")")
+
+    def _Raise(self, t):
+        self.fill("raise")
+        if not t.exc:
+            assert not t.cause
+            return
+        self.write(" ")
+        self.dispatch(t.exc)
+        if t.cause:
+            self.write(" from ")
+            self.dispatch(t.cause)
+
+    def _Try(self, t):
+        self.fill("try")
+        self.enter()
+        self.dispatch(t.body)
+        self.leave()
+        for ex in t.handlers:
+            self.dispatch(ex)
+        if t.orelse:
+            self.fill("else")
+            self.enter()
+            self.dispatch(t.orelse)
+            self.leave()
+        if t.finalbody:
+            self.fill("finally")
+            self.enter()
+            self.dispatch(t.finalbody)
+            self.leave()
+
+    def _ExceptHandler(self, t):
+        self.fill("except")
+        if t.type:
+            self.write(" ")
+            self.dispatch(t.type)
+        if t.name:
+            self.write(" as ")
+            self.write(t.name)
+        self.enter()
+        self.dispatch(t.body)
+        self.leave()
+
+    def _ClassDef(self, t):
+        self.write("\n")
+        for deco in t.decorator_list:
+            self.fill("@")
+            self.dispatch(deco)
+        self.fill("class " + t.name)
+        self.write("(")
+        comma = False
+        for e in t.bases:
+            if comma:
+                self.write(", ")
+            else:
+                comma = True
+            self.dispatch(e)
+        for e in t.keywords:
+            if comma:
+                self.write(", ")
+            else:
+                comma = True
+            self.dispatch(e)
+        self.write(")")
+
+        self.enter()
+        self.dispatch(t.body)
+        self.leave()
+
+    def _FunctionDef(self, t):
+        self.__FunctionDef_helper(t, "def")
+
+    def _AsyncFunctionDef(self, t):
+        self.__FunctionDef_helper(t, "async def")
+
+    def __FunctionDef_helper(self, t, fill_suffix):
+        self.write("\n")
+        for deco in t.decorator_list:
+            self.fill("@")
+            self.dispatch(deco)
+        def_str = fill_suffix + " " + t.name + "("
+        self.fill(def_str)
+        self.dispatch(t.args)
+        self.write(")")
+        if t.returns:
+            self.write(" -> ")
+            self.dispatch(t.returns)
+        self.enter()
+        self.dispatch(t.body)
+        self.leave()
+
+    def _For(self, t):
+        self.__For_helper("for ", t)
+
+    def _AsyncFor(self, t):
+        self.__For_helper("async for ", t)
+
+    def __For_helper(self, fill, t):
+        self.fill(fill)
+        self.dispatch(t.target)
+        self.write(" in ")
+        self.dispatch(t.iter)
+        self.enter()
+        self.dispatch(t.body)
+        self.leave()
+        if t.orelse:
+            self.fill("else")
+            self.enter()
+            self.dispatch(t.orelse)
+            self.leave()
+
+    def _If(self, t):
+        self.fill("if ")
+        self.dispatch(t.test)
+        self.enter()
+        self.dispatch(t.body)
+        self.leave()
+        # collapse nested ifs into equivalent elifs.
+        while t.orelse and len(t.orelse) == 1 and isinstance(t.orelse[0], ast.If):
+            t = t.orelse[0]
+            self.fill("elif ")
+            self.dispatch(t.test)
+            self.enter()
+            self.dispatch(t.body)
+            self.leave()
+        # final else
+        if t.orelse:
+            self.fill("else")
+            self.enter()
+            self.dispatch(t.orelse)
+            self.leave()
+
+    def _While(self, t):
+        self.fill("while ")
+        self.dispatch(t.test)
+        self.enter()
+        self.dispatch(t.body)
+        self.leave()
+        if t.orelse:
+            self.fill("else")
+            self.enter()
+            self.dispatch(t.orelse)
+            self.leave()
+
+    def _With(self, t):
+        self.fill("with ")
+        interleave(lambda: self.write(", "), self.dispatch, t.items)
+        self.enter()
+        self.dispatch(t.body)
+        self.leave()
+
+    def _AsyncWith(self, t):
+        self.fill("async with ")
+        interleave(lambda: self.write(", "), self.dispatch, t.items)
+        self.enter()
+        self.dispatch(t.body)
+        self.leave()
+
+    # expr
+    def _JoinedStr(self, t):
+        self.write("f")
+        string = io.StringIO()
+        self._fstring_JoinedStr(t, string.write)
+        self.write(repr(string.getvalue()))
+
+    def _FormattedValue(self, t):
+        self.write("f")
+        string = io.StringIO()
+        self._fstring_FormattedValue(t, string.write)
+        self.write(repr(string.getvalue()))
+
+    def _fstring_JoinedStr(self, t, write):
+        for value in t.values:
+            meth = getattr(self, "_fstring_" + type(value).__name__)
+            meth(value, write)
+
+    def _fstring_Constant(self, t, write):
+        assert isinstance(t.value, str)
+        value = t.value.replace("{", "{{").replace("}", "}}")
+        write(value)
+
+    def _fstring_FormattedValue(self, t, write):
+        write("{")
+        expr = io.StringIO()
+        Unparser(t.value, expr)
+        expr = expr.getvalue().rstrip("\n")
+        if expr.startswith("{"):
+            write(" ")  # Separate pair of opening brackets as "{ {"
+        write(expr)
+        if t.conversion != -1:
+            conversion = chr(t.conversion)
+            assert conversion in "sra"
+            write(f"!{conversion}")
+        if t.format_spec:
+            write(":")
+            meth = getattr(self, "_fstring_" + type(t.format_spec).__name__)
+            meth(t.format_spec, write)
+        write("}")
+
+    def _Name(self, t):
+        self.write(t.id)
+
+    def _write_constant(self, value):
+        if isinstance(value, (float, complex)):
+            # Substitute overflowing decimal literal for AST infinities.
+            self.write(repr(value).replace("inf", INFSTR))
+        else:
+            self.write(repr(value))
+
+    def _Constant(self, t):
+        value = t.value
+        if isinstance(value, tuple):
+            self.write("(")
+            if len(value) == 1:
+                self._write_constant(value[0])
+                self.write(",")
+            else:
+                interleave(lambda: self.write(", "), self._write_constant, value)
+            self.write(")")
+        elif value is ...:
+            self.write("...")
+        else:
+            if t.kind == "u":
+                self.write("u")
+            self._write_constant(t.value)
+
+    def _List(self, t):
+        self.write("[")
+        interleave(lambda: self.write(", "), self.dispatch, t.elts)
+        self.write("]")
+
+    def _ListComp(self, t):
+        self.write("[")
+        self.dispatch(t.elt)
+        for gen in t.generators:
+            self.dispatch(gen)
+        self.write("]")
+
+    def _GeneratorExp(self, t):
+        self.write("(")
+        self.dispatch(t.elt)
+        for gen in t.generators:
+            self.dispatch(gen)
+        self.write(")")
+
+    def _SetComp(self, t):
+        self.write("{")
+        self.dispatch(t.elt)
+        for gen in t.generators:
+            self.dispatch(gen)
+        self.write("}")
+
+    def _DictComp(self, t):
+        self.write("{")
+        self.dispatch(t.key)
+        self.write(": ")
+        self.dispatch(t.value)
+        for gen in t.generators:
+            self.dispatch(gen)
+        self.write("}")
+
+    def _comprehension(self, t):
+        if t.is_async:
+            self.write(" async for ")
+        else:
+            self.write(" for ")
+        self.dispatch(t.target)
+        self.write(" in ")
+        self.dispatch(t.iter)
+        for if_clause in t.ifs:
+            self.write(" if ")
+            self.dispatch(if_clause)
+
+    def _IfExp(self, t):
+        self.write("(")
+        self.dispatch(t.body)
+        self.write(" if ")
+        self.dispatch(t.test)
+        self.write(" else ")
+        self.dispatch(t.orelse)
+        self.write(")")
+
+    def _Set(self, t):
+        assert t.elts  # should be at least one element
+        self.write("{")
+        interleave(lambda: self.write(", "), self.dispatch, t.elts)
+        self.write("}")
+
+    def _Dict(self, t):
+        self.write("{")
+
+        def write_key_value_pair(k, v):
+            self.dispatch(k)
+            self.write(": ")
+            self.dispatch(v)
+
+        def write_item(item):
+            k, v = item
+            if k is None:
+                # for dictionary unpacking operator in dicts {**{'y': 2}}
+                # see PEP 448 for details
+                self.write("**")
+                self.dispatch(v)
+            else:
+                write_key_value_pair(k, v)
+
+        interleave(lambda: self.write(", "), write_item, zip(t.keys, t.values))
+        self.write("}")
+
+    def _Tuple(self, t):
+        self.write("(")
+        if len(t.elts) == 1:
+            elt = t.elts[0]
+            self.dispatch(elt)
+            self.write(",")
+        else:
+            interleave(lambda: self.write(", "), self.dispatch, t.elts)
+        self.write(")")
+
+    unop = {"Invert": "~", "Not": "not", "UAdd": "+", "USub": "-"}
+
+    def _UnaryOp(self, t):
+        self.write("(")
+        self.write(self.unop[t.op.__class__.__name__])
+        self.write(" ")
+        self.dispatch(t.operand)
+        self.write(")")
+
+    binop = {
+        "Add": "+",
+        "Sub": "-",
+        "Mult": "*",
+        "MatMult": "@",
+        "Div": "/",
+        "Mod": "%",
+        "LShift": "<<",
+        "RShift": ">>",
+        "BitOr": "|",
+        "BitXor": "^",
+        "BitAnd": "&",
+        "FloorDiv": "//",
+        "Pow": "**",
+    }
+
+    def _BinOp(self, t):
+        self.write("(")
+        self.dispatch(t.left)
+        self.write(" " + self.binop[t.op.__class__.__name__] + " ")
+        self.dispatch(t.right)
+        self.write(")")
+
+    cmpops = {
+        "Eq": "==",
+        "NotEq": "!=",
+        "Lt": "<",
+        "LtE": "<=",
+        "Gt": ">",
+        "GtE": ">=",
+        "Is": "is",
+        "IsNot": "is not",
+        "In": "in",
+        "NotIn": "not in",
+    }
+
+    def _Compare(self, t):
+        self.write("(")
+        self.dispatch(t.left)
+        for o, e in zip(t.ops, t.comparators):
+            self.write(" " + self.cmpops[o.__class__.__name__] + " ")
+            self.dispatch(e)
+        self.write(")")
+
+    boolops = {ast.And: "and", ast.Or: "or"}
+
+    def _BoolOp(self, t):
+        self.write("(")
+        s = " %s " % self.boolops[t.op.__class__]
+        interleave(lambda: self.write(s), self.dispatch, t.values)
+        self.write(")")
+
+    def _Attribute(self, t):
+        self.dispatch(t.value)
+        # Special case: 3.__abs__() is a syntax error, so if t.value
+        # is an integer literal then we need to either parenthesize
+        # it or add an extra space to get 3 .__abs__().
+        if isinstance(t.value, ast.Constant) and isinstance(t.value.value, int):
+            self.write(" ")
+        self.write(".")
+        self.write(t.attr)
+
+    def _Call(self, t):
+        self.dispatch(t.func)
+        self.write("(")
+        comma = False
+        for e in t.args:
+            if comma:
+                self.write(", ")
+            else:
+                comma = True
+            self.dispatch(e)
+        for e in t.keywords:
+            if comma:
+                self.write(", ")
+            else:
+                comma = True
+            self.dispatch(e)
+        self.write(")")
+
+    def _Subscript(self, t):
+        self.dispatch(t.value)
+        self.write("[")
+        if (
+            isinstance(t.slice, ast.Index)
+            and isinstance(t.slice.value, ast.Tuple)
+            and t.slice.value.elts
+        ):
+            if len(t.slice.value.elts) == 1:
+                elt = t.slice.value.elts[0]
+                self.dispatch(elt)
+                self.write(",")
+            else:
+                interleave(lambda: self.write(", "), self.dispatch, t.slice.value.elts)
+        else:
+            self.dispatch(t.slice)
+        self.write("]")
+
+    def _Starred(self, t):
+        self.write("*")
+        self.dispatch(t.value)
+
+    # slice
+    def _Ellipsis(self, t):
+        self.write("...")
+
+    def _Index(self, t):
+        self.dispatch(t.value)
+
+    def _Slice(self, t):
+        if t.lower:
+            self.dispatch(t.lower)
+        self.write(":")
+        if t.upper:
+            self.dispatch(t.upper)
+        if t.step:
+            self.write(":")
+            self.dispatch(t.step)
+
+    def _ExtSlice(self, t):
+        if len(t.dims) == 1:
+            elt = t.dims[0]
+            self.dispatch(elt)
+            self.write(",")
+        else:
+            interleave(lambda: self.write(", "), self.dispatch, t.dims)
+
+    # argument
+    def _arg(self, t):
+        self.write(t.arg)
+        if t.annotation:
+            self.write(": ")
+            self.dispatch(t.annotation)
+
+    # others
+    def _arguments(self, t):
+        first = True
+        # normal arguments
+        all_args = t.posonlyargs + t.args
+        defaults = [None] * (len(all_args) - len(t.defaults)) + t.defaults
+        for index, elements in enumerate(zip(all_args, defaults), 1):
+            a, d = elements
+            if first:
+                first = False
+            else:
+                self.write(", ")
+            self.dispatch(a)
+            if d:
+                self.write("=")
+                self.dispatch(d)
+            if index == len(t.posonlyargs):
+                self.write(", /")
+
+        # varargs, or bare '*' if no varargs but keyword-only arguments present
+        if t.vararg or t.kwonlyargs:
+            if first:
+                first = False
+            else:
+                self.write(", ")
+            self.write("*")
+            if t.vararg:
+                self.write(t.vararg.arg)
+                if t.vararg.annotation:
+                    self.write(": ")
+                    self.dispatch(t.vararg.annotation)
+
+        # keyword-only arguments
+        if t.kwonlyargs:
+            for a, d in zip(t.kwonlyargs, t.kw_defaults):
+                if first:
+                    first = False
+                else:
+                    self.write(", ")
+                self.dispatch(a)
+                if d:
+                    self.write("=")
+                    self.dispatch(d)
+
+        # kwargs
+        if t.kwarg:
+            if first:
+                first = False
+            else:
+                self.write(", ")
+            self.write("**" + t.kwarg.arg)
+            if t.kwarg.annotation:
+                self.write(": ")
+                self.dispatch(t.kwarg.annotation)
+
+    def _keyword(self, t):
+        if t.arg is None:
+            self.write("**")
+        else:
+            self.write(t.arg)
+            self.write("=")
+        self.dispatch(t.value)
+
+    def _Lambda(self, t):
+        self.write("(")
+        self.write("lambda ")
+        self.dispatch(t.args)
+        self.write(": ")
+        self.dispatch(t.body)
+        self.write(")")
+
+    def _alias(self, t):
+        self.write(t.name)
+        if t.asname:
+            self.write(" as " + t.asname)
+
+    def _withitem(self, t):
+        self.dispatch(t.context_expr)
+        if t.optional_vars:
+            self.write(" as ")
+            self.dispatch(t.optional_vars)
+
+
+def roundtrip(filename, output=sys.stdout):
+    """Parse a file and pretty-print it to output.
+
+    The output is formatted as valid Python source code.
+
+    Args:
+        filename: The name of the file to parse.
+        output: The output stream to write to.
+    """
+    with open(filename, "rb") as pyfile:
+        encoding = tokenize.detect_encoding(pyfile.readline)[0]
+    with open(filename, "r", encoding=encoding) as pyfile:
+        source = pyfile.read()
+    tree = compile(source, filename, "exec", ast.PyCF_ONLY_AST)
+    Unparser(tree, output)
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/__init__.py b/llm/Lib/site-packages/langchain_community/tools/edenai/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e6084d5157484e1561bc30d08c1bb8a355d8d4b0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/edenai/__init__.py
@@ -0,0 +1,34 @@
+"""Edenai Tools."""
+from langchain_community.tools.edenai.audio_speech_to_text import (
+    EdenAiSpeechToTextTool,
+)
+from langchain_community.tools.edenai.audio_text_to_speech import (
+    EdenAiTextToSpeechTool,
+)
+from langchain_community.tools.edenai.edenai_base_tool import EdenaiTool
+from langchain_community.tools.edenai.image_explicitcontent import (
+    EdenAiExplicitImageTool,
+)
+from langchain_community.tools.edenai.image_objectdetection import (
+    EdenAiObjectDetectionTool,
+)
+from langchain_community.tools.edenai.ocr_identityparser import (
+    EdenAiParsingIDTool,
+)
+from langchain_community.tools.edenai.ocr_invoiceparser import (
+    EdenAiParsingInvoiceTool,
+)
+from langchain_community.tools.edenai.text_moderation import (
+    EdenAiTextModerationTool,
+)
+
+__all__ = [
+    "EdenAiExplicitImageTool",
+    "EdenAiObjectDetectionTool",
+    "EdenAiParsingIDTool",
+    "EdenAiParsingInvoiceTool",
+    "EdenAiTextToSpeechTool",
+    "EdenAiSpeechToTextTool",
+    "EdenAiTextModerationTool",
+    "EdenaiTool",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..25701e4a87f6c2042627f820585dc6eab062f98c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/audio_speech_to_text.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/audio_speech_to_text.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7ce35f825971f472ae67b3ecbd2da991df7f213a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/audio_speech_to_text.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/audio_text_to_speech.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/audio_text_to_speech.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e76cb457eda41c5eaff0c8b9dcbd868c861fb07a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/audio_text_to_speech.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/edenai_base_tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/edenai_base_tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..36ce9bb68ea6d4c1cfe758d109d86706b5d2f318
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/edenai_base_tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/image_explicitcontent.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/image_explicitcontent.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a9cc18aee35edbd0100a590945216c73e2f9994e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/image_explicitcontent.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/image_objectdetection.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/image_objectdetection.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f7031dce41046e6746e981b36fd51bfe31079eda
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/image_objectdetection.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/ocr_identityparser.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/ocr_identityparser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b2e786b06b3e19b6b94a7e285dd458565281cdd9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/ocr_identityparser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/ocr_invoiceparser.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/ocr_invoiceparser.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c4ad931ccce76abf56214edb9d610b181d42d25a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/ocr_invoiceparser.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/text_moderation.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/text_moderation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3fc312f5e5fe46ad5b4f55f4d5470a8fb975ff24
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/edenai/__pycache__/text_moderation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/audio_speech_to_text.py b/llm/Lib/site-packages/langchain_community/tools/edenai/audio_speech_to_text.py
new file mode 100644
index 0000000000000000000000000000000000000000..00f158ed53b0f22d9fb2cb55f43d326d962d62cf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/edenai/audio_speech_to_text.py
@@ -0,0 +1,103 @@
+from __future__ import annotations
+
+import json
+import logging
+import time
+from typing import List, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import validator
+
+from langchain_community.tools.edenai.edenai_base_tool import EdenaiTool
+
+logger = logging.getLogger(__name__)
+
+
+class EdenAiSpeechToTextTool(EdenaiTool):
+    """Tool that queries the Eden AI Speech To Text API.
+
+    for api reference check edenai documentation:
+    https://app.edenai.run/bricks/speech/asynchronous-speech-to-text.
+
+    To use, you should have
+    the environment variable ``EDENAI_API_KEY`` set with your API token.
+    You can find your token here: https://app.edenai.run/admin/account/settings
+
+    """
+
+    edenai_api_key: Optional[str] = None
+
+    name = "edenai_speech_to_text"
+    description = (
+        "A wrapper around edenai Services speech to text "
+        "Useful for when you have to convert audio to text."
+        "Input should be a url to an audio file."
+    )
+    is_async = True
+
+    language: Optional[str] = "en"
+    speakers: Optional[int]
+    profanity_filter: bool = False
+    custom_vocabulary: Optional[List[str]]
+
+    feature: str = "audio"
+    subfeature: str = "speech_to_text_async"
+    base_url = "https://api.edenai.run/v2/audio/speech_to_text_async/"
+
+    @validator("providers")
+    def check_only_one_provider_selected(cls, v: List[str]) -> List[str]:
+        """
+        This tool has no feature to combine providers results.
+        Therefore we only allow one provider
+        """
+        if len(v) > 1:
+            raise ValueError(
+                "Please select only one provider. "
+                "The feature to combine providers results is not available "
+                "for this tool."
+            )
+        return v
+
+    def _wait_processing(self, url: str) -> requests.Response:
+        for _ in range(10):
+            time.sleep(1)
+            audio_analysis_result = self._get_edenai(url)
+            temp = audio_analysis_result.json()
+            if temp["status"] == "finished":
+                if temp["results"][self.providers[0]]["error"] is not None:
+                    raise Exception(
+                        f"""EdenAI returned an unexpected response 
+                        {temp['results'][self.providers[0]]['error']}"""
+                    )
+                else:
+                    return audio_analysis_result
+
+        raise Exception("Edenai speech to text job id processing Timed out")
+
+    def _parse_response(self, response: dict) -> str:
+        return response["public_id"]
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        all_params = {
+            "file_url": query,
+            "language": self.language,
+            "speakers": self.speakers,
+            "profanity_filter": self.profanity_filter,
+            "custom_vocabulary": self.custom_vocabulary,
+        }
+
+        # filter so we don't send val to api when val is `None
+        query_params = {k: v for k, v in all_params.items() if v is not None}
+
+        job_id = self._call_eden_ai(query_params)
+        url = self.base_url + job_id
+        audio_analysis_result = self._wait_processing(url)
+        result = audio_analysis_result.text
+        formatted_text = json.loads(result)
+        return formatted_text["results"][self.providers[0]]["text"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/audio_text_to_speech.py b/llm/Lib/site-packages/langchain_community/tools/edenai/audio_text_to_speech.py
new file mode 100644
index 0000000000000000000000000000000000000000..575b9a70b523f61a154b9a31ae5c002c513c93f4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/edenai/audio_text_to_speech.py
@@ -0,0 +1,116 @@
+from __future__ import annotations
+
+import logging
+from typing import Dict, List, Literal, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import Field, root_validator, validator
+
+from langchain_community.tools.edenai.edenai_base_tool import EdenaiTool
+
+logger = logging.getLogger(__name__)
+
+
+class EdenAiTextToSpeechTool(EdenaiTool):
+    """Tool that queries the Eden AI Text to speech API.
+    for api reference check edenai documentation:
+    https://docs.edenai.co/reference/audio_text_to_speech_create.
+
+    To use, you should have
+    the environment variable ``EDENAI_API_KEY`` set with your API token.
+    You can find your token here: https://app.edenai.run/admin/account/settings
+
+    """
+
+    name = "edenai_text_to_speech"
+    description = (
+        "A wrapper around edenai Services text to speech."
+        "Useful for when you need to convert text to speech."
+        """the output is a string representing the URL of the audio file,
+        or the path to the downloaded wav file """
+    )
+
+    language: Optional[str] = "en"
+    """
+    language of the text passed to the model.
+    """
+
+    # optional params see api documentation for more info
+    return_type: Literal["url", "wav"] = "url"
+    rate: Optional[int]
+    pitch: Optional[int]
+    volume: Optional[int]
+    audio_format: Optional[str]
+    sampling_rate: Optional[int]
+    voice_models: Dict[str, str] = Field(default_factory=dict)
+
+    voice: Literal["MALE", "FEMALE"]
+    """voice option : 'MALE' or 'FEMALE' """
+
+    feature: str = "audio"
+    subfeature: str = "text_to_speech"
+
+    @validator("providers")
+    def check_only_one_provider_selected(cls, v: List[str]) -> List[str]:
+        """
+        This tool has no feature to combine providers results.
+        Therefore we only allow one provider
+        """
+        if len(v) > 1:
+            raise ValueError(
+                "Please select only one provider. "
+                "The feature to combine providers results is not available "
+                "for this tool."
+            )
+        return v
+
+    @root_validator
+    def check_voice_models_key_is_provider_name(cls, values: dict) -> dict:
+        for key in values.get("voice_models", {}).keys():
+            if key not in values.get("providers", []):
+                raise ValueError(
+                    "voice_model should be formatted like this "
+                    "{<provider_name>: <its_voice_model>}"
+                )
+        return values
+
+    def _download_wav(self, url: str, save_path: str) -> None:
+        response = requests.get(url)
+        if response.status_code == 200:
+            with open(save_path, "wb") as f:
+                f.write(response.content)
+        else:
+            raise ValueError("Error while downloading wav file")
+
+    def _parse_response(self, response: list) -> str:
+        result = response[0]
+        if self.return_type == "url":
+            return result["audio_resource_url"]
+        else:
+            self._download_wav(result["audio_resource_url"], "audio.wav")
+            return "audio.wav"
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        all_params = {
+            "text": query,
+            "language": self.language,
+            "option": self.voice,
+            "return_type": self.return_type,
+            "rate": self.rate,
+            "pitch": self.pitch,
+            "volume": self.volume,
+            "audio_format": self.audio_format,
+            "sampling_rate": self.sampling_rate,
+            "settings": self.voice_models,
+        }
+
+        # filter so we don't send val to api when val is `None
+        query_params = {k: v for k, v in all_params.items() if v is not None}
+
+        return self._call_eden_ai(query_params)
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/edenai_base_tool.py b/llm/Lib/site-packages/langchain_community/tools/edenai/edenai_base_tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..e38f6936cc179129ad8e5717fe686fbc1095b0d5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/edenai/edenai_base_tool.py
@@ -0,0 +1,159 @@
+from __future__ import annotations
+
+import logging
+from abc import abstractmethod
+from typing import Any, Dict, List, Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+
+class EdenaiTool(BaseTool):
+
+    """
+    the base tool for all the EdenAI Tools .
+    you should have
+    the environment variable ``EDENAI_API_KEY`` set with your API token.
+    You can find your token here: https://app.edenai.run/admin/account/settings
+    """
+
+    feature: str
+    subfeature: str
+    edenai_api_key: Optional[str] = None
+    is_async: bool = False
+
+    providers: List[str]
+    """provider to use for the API call."""
+
+    @root_validator(allow_reuse=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        values["edenai_api_key"] = get_from_dict_or_env(
+            values, "edenai_api_key", "EDENAI_API_KEY"
+        )
+        return values
+
+    @staticmethod
+    def get_user_agent() -> str:
+        from langchain_community import __version__
+
+        return f"langchain/{__version__}"
+
+    def _call_eden_ai(self, query_params: Dict[str, Any]) -> str:
+        """
+        Make an API call to the EdenAI service with the specified query parameters.
+
+        Args:
+            query_params (dict): The parameters to include in the API call.
+
+        Returns:
+            requests.Response: The response from the EdenAI API call.
+
+        """
+
+        # faire l'API call
+
+        headers = {
+            "Authorization": f"Bearer {self.edenai_api_key}",
+            "User-Agent": self.get_user_agent(),
+        }
+
+        url = f"https://api.edenai.run/v2/{self.feature}/{self.subfeature}"
+
+        payload = {
+            "providers": str(self.providers),
+            "response_as_dict": False,
+            "attributes_as_list": True,
+            "show_original_response": False,
+        }
+
+        payload.update(query_params)
+
+        response = requests.post(url, json=payload, headers=headers)
+
+        self._raise_on_error(response)
+
+        try:
+            return self._parse_response(response.json())
+        except Exception as e:
+            raise RuntimeError(f"An error occurred while running tool: {e}")
+
+    def _raise_on_error(self, response: requests.Response) -> None:
+        if response.status_code >= 500:
+            raise Exception(f"EdenAI Server: Error {response.status_code}")
+        elif response.status_code >= 400:
+            raise ValueError(f"EdenAI received an invalid payload: {response.text}")
+        elif response.status_code != 200:
+            raise Exception(
+                f"EdenAI returned an unexpected response with status "
+                f"{response.status_code}: {response.text}"
+            )
+
+        # case where edenai call succeeded but provider returned an error
+        # (eg: rate limit, server error, etc.)
+        if self.is_async is False:
+            # async call are different and only return a job_id,
+            # not the provider response directly
+            provider_response = response.json()[0]
+            if provider_response.get("status") == "fail":
+                err_msg = provider_response["error"]["message"]
+                raise ValueError(err_msg)
+
+    @abstractmethod
+    def _run(
+        self, query: str, run_manager: Optional[CallbackManagerForToolRun] = None
+    ) -> str:
+        pass
+
+    @abstractmethod
+    def _parse_response(self, response: Any) -> str:
+        """Take a dict response and condense it's data in a human readable string"""
+        pass
+
+    def _get_edenai(self, url: str) -> requests.Response:
+        headers = {
+            "accept": "application/json",
+            "authorization": f"Bearer {self.edenai_api_key}",
+            "User-Agent": self.get_user_agent(),
+        }
+
+        response = requests.get(url, headers=headers)
+
+        self._raise_on_error(response)
+
+        return response
+
+    def _parse_json_multilevel(
+        self, extracted_data: dict, formatted_list: list, level: int = 0
+    ) -> None:
+        for section, subsections in extracted_data.items():
+            indentation = "  " * level
+            if isinstance(subsections, str):
+                subsections = subsections.replace("\n", ",")
+                formatted_list.append(f"{indentation}{section} : {subsections}")
+
+            elif isinstance(subsections, list):
+                formatted_list.append(f"{indentation}{section} : ")
+                self._list_handling(subsections, formatted_list, level + 1)
+
+            elif isinstance(subsections, dict):
+                formatted_list.append(f"{indentation}{section} : ")
+                self._parse_json_multilevel(subsections, formatted_list, level + 1)
+
+    def _list_handling(
+        self, subsection_list: list, formatted_list: list, level: int
+    ) -> None:
+        for list_item in subsection_list:
+            if isinstance(list_item, dict):
+                self._parse_json_multilevel(list_item, formatted_list, level)
+
+            elif isinstance(list_item, list):
+                self._list_handling(list_item, formatted_list, level + 1)
+
+            else:
+                formatted_list.append(f"{'  ' * level}{list_item}")
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/image_explicitcontent.py b/llm/Lib/site-packages/langchain_community/tools/edenai/image_explicitcontent.py
new file mode 100644
index 0000000000000000000000000000000000000000..fbeb4c1ec19c8e45374a84b108066bade7d9a15c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/edenai/image_explicitcontent.py
@@ -0,0 +1,68 @@
+from __future__ import annotations
+
+import logging
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+
+from langchain_community.tools.edenai.edenai_base_tool import EdenaiTool
+
+logger = logging.getLogger(__name__)
+
+
+class EdenAiExplicitImageTool(EdenaiTool):
+
+    """Tool that queries the Eden AI Explicit image detection.
+
+    for api reference check edenai documentation:
+    https://docs.edenai.co/reference/image_explicit_content_create.
+
+    To use, you should have
+    the environment variable ``EDENAI_API_KEY`` set with your API token.
+    You can find your token here: https://app.edenai.run/admin/account/settings
+
+    """
+
+    name = "edenai_image_explicit_content_detection"
+
+    description = (
+        "A wrapper around edenai Services Explicit image detection. "
+        """Useful for when you have to extract Explicit Content from images.
+        it detects adult only content in images, 
+        that is generally inappropriate for people under
+        the age of 18 and includes nudity, sexual activity,
+        pornography, violence, gore content, etc."""
+        "Input should be the string url of the image ."
+    )
+
+    combine_available = True
+    feature = "image"
+    subfeature = "explicit_content"
+
+    def _parse_json(self, json_data: dict) -> str:
+        result_str = f"nsfw_likelihood: {json_data['nsfw_likelihood']}\n"
+        for idx, found_obj in enumerate(json_data["items"]):
+            label = found_obj["label"].lower()
+            likelihood = found_obj["likelihood"]
+            result_str += f"{idx}: {label} likelihood {likelihood},\n"
+
+        return result_str[:-2]
+
+    def _parse_response(self, json_data: list) -> str:
+        if len(json_data) == 1:
+            result = self._parse_json(json_data[0])
+        else:
+            for entry in json_data:
+                if entry.get("provider") == "eden-ai":
+                    result = self._parse_json(entry)
+
+        return result
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        query_params = {"file_url": query, "attributes_as_list": False}
+        return self._call_eden_ai(query_params)
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/image_objectdetection.py b/llm/Lib/site-packages/langchain_community/tools/edenai/image_objectdetection.py
new file mode 100644
index 0000000000000000000000000000000000000000..e40d464d5c7f1334eb9197a72fe26418084f7d47
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/edenai/image_objectdetection.py
@@ -0,0 +1,76 @@
+from __future__ import annotations
+
+import logging
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+
+from langchain_community.tools.edenai.edenai_base_tool import EdenaiTool
+
+logger = logging.getLogger(__name__)
+
+
+class EdenAiObjectDetectionTool(EdenaiTool):
+    """Tool that queries the Eden AI Object detection API.
+
+    for api reference check edenai documentation:
+    https://docs.edenai.co/reference/image_object_detection_create.
+
+    To use, you should have
+    the environment variable ``EDENAI_API_KEY`` set with your API token.
+    You can find your token here: https://app.edenai.run/admin/account/settings
+
+    """
+
+    name = "edenai_object_detection"
+
+    description = (
+        "A wrapper around edenai Services Object Detection . "
+        """Useful for when you have to do an  to identify and locate
+        (with bounding boxes) objects in an image """
+        "Input should be the string url of the image to identify."
+    )
+
+    show_positions: bool = False
+
+    feature = "image"
+    subfeature = "object_detection"
+
+    def _parse_json(self, json_data: dict) -> str:
+        result = []
+        label_info = []
+
+        for found_obj in json_data["items"]:
+            label_str = f"{found_obj['label']} - Confidence {found_obj['confidence']}"
+            x_min = found_obj.get("x_min")
+            x_max = found_obj.get("x_max")
+            y_min = found_obj.get("y_min")
+            y_max = found_obj.get("y_max")
+            if self.show_positions and all(
+                [x_min, x_max, y_min, y_max]
+            ):  # some providers don't return positions
+                label_str += f""",at the position x_min: {x_min}, x_max: {x_max}, 
+                y_min: {y_min}, y_max: {y_max}"""
+            label_info.append(label_str)
+
+        result.append("\n".join(label_info))
+        return "\n\n".join(result)
+
+    def _parse_response(self, response: list) -> str:
+        if len(response) == 1:
+            result = self._parse_json(response[0])
+        else:
+            for entry in response:
+                if entry.get("provider") == "eden-ai":
+                    result = self._parse_json(entry)
+
+        return result
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        query_params = {"file_url": query, "attributes_as_list": False}
+        return self._call_eden_ai(query_params)
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/ocr_identityparser.py b/llm/Lib/site-packages/langchain_community/tools/edenai/ocr_identityparser.py
new file mode 100644
index 0000000000000000000000000000000000000000..6af27c92fd61b3863addf9bc011c3983fbc94955
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/edenai/ocr_identityparser.py
@@ -0,0 +1,69 @@
+from __future__ import annotations
+
+import logging
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+
+from langchain_community.tools.edenai.edenai_base_tool import EdenaiTool
+
+logger = logging.getLogger(__name__)
+
+
+class EdenAiParsingIDTool(EdenaiTool):
+    """Tool that queries the Eden AI  Identity parsing API.
+
+    for api reference check edenai documentation:
+    https://docs.edenai.co/reference/ocr_identity_parser_create.
+
+    To use, you should have
+    the environment variable ``EDENAI_API_KEY`` set with your API token.
+    You can find your token here: https://app.edenai.run/admin/account/settings
+
+    """
+
+    name = "edenai_identity_parsing"
+
+    description = (
+        "A wrapper around edenai Services Identity parsing. "
+        "Useful for when you have to extract information from an ID Document "
+        "Input should be the string url of the document to parse."
+    )
+
+    feature = "ocr"
+    subfeature = "identity_parser"
+
+    language: Optional[str] = None
+    """
+    language of the text passed to the model.
+    """
+
+    def _parse_response(self, response: list) -> str:
+        formatted_list: list = []
+
+        if len(response) == 1:
+            self._parse_json_multilevel(
+                response[0]["extracted_data"][0], formatted_list
+            )
+        else:
+            for entry in response:
+                if entry.get("provider") == "eden-ai":
+                    self._parse_json_multilevel(
+                        entry["extracted_data"][0], formatted_list
+                    )
+
+        return "\n".join(formatted_list)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        query_params = {
+            "file_url": query,
+            "language": self.language,
+            "attributes_as_list": False,
+        }
+
+        return self._call_eden_ai(query_params)
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/ocr_invoiceparser.py b/llm/Lib/site-packages/langchain_community/tools/edenai/ocr_invoiceparser.py
new file mode 100644
index 0000000000000000000000000000000000000000..6b2e7d8befe3f08874adeaad71576d34142c2f4a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/edenai/ocr_invoiceparser.py
@@ -0,0 +1,73 @@
+from __future__ import annotations
+
+import logging
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+
+from langchain_community.tools.edenai.edenai_base_tool import EdenaiTool
+
+logger = logging.getLogger(__name__)
+
+
+class EdenAiParsingInvoiceTool(EdenaiTool):
+    """Tool that queries the Eden AI Invoice parsing API.
+
+    for api reference check edenai documentation:
+    https://docs.edenai.co/reference/ocr_invoice_parser_create.
+
+    To use, you should have
+    the environment variable ``EDENAI_API_KEY`` set with your API token.
+    You can find your token here: https://app.edenai.run/admin/account/settings
+
+    """
+
+    name = "edenai_invoice_parsing"
+
+    description = (
+        "A wrapper around edenai Services invoice parsing. "
+        """Useful for when you have to extract information from 
+        an image it enables to take invoices 
+        in a variety of formats and returns the data in contains
+        (items, prices, addresses, vendor name, etc.)
+        in a structured format to automate the invoice processing """
+        "Input should be the string url of the document to parse."
+    )
+
+    language: Optional[str] = None
+    """
+    language of the image passed to the model.
+    """
+
+    feature = "ocr"
+    subfeature = "invoice_parser"
+
+    def _parse_response(self, response: list) -> str:
+        formatted_list: list = []
+
+        if len(response) == 1:
+            self._parse_json_multilevel(
+                response[0]["extracted_data"][0], formatted_list
+            )
+        else:
+            for entry in response:
+                if entry.get("provider") == "eden-ai":
+                    self._parse_json_multilevel(
+                        entry["extracted_data"][0], formatted_list
+                    )
+
+        return "\n".join(formatted_list)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        query_params = {
+            "file_url": query,
+            "language": self.language,
+            "attributes_as_list": False,
+        }
+
+        return self._call_eden_ai(query_params)
diff --git a/llm/Lib/site-packages/langchain_community/tools/edenai/text_moderation.py b/llm/Lib/site-packages/langchain_community/tools/edenai/text_moderation.py
new file mode 100644
index 0000000000000000000000000000000000000000..44d1308117f0f77353fe0c27d11b0c3781d95bde
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/edenai/text_moderation.py
@@ -0,0 +1,73 @@
+from __future__ import annotations
+
+import logging
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+
+from langchain_community.tools.edenai.edenai_base_tool import EdenaiTool
+
+logger = logging.getLogger(__name__)
+
+
+class EdenAiTextModerationTool(EdenaiTool):
+    """Tool that queries the Eden AI Explicit text detection.
+
+    for api reference check edenai documentation:
+    https://docs.edenai.co/reference/image_explicit_content_create.
+
+    To use, you should have
+    the environment variable ``EDENAI_API_KEY`` set with your API token.
+    You can find your token here: https://app.edenai.run/admin/account/settings
+
+    """
+
+    name = "edenai_explicit_content_detection_text"
+
+    description = (
+        "A wrapper around edenai Services explicit content detection for text. "
+        """Useful for when you have to scan text for offensive, 
+        sexually explicit or suggestive content,
+        it checks also if there is any content of self-harm,
+        violence, racist or hate speech."""
+        """the structure of the output is : 
+        'the type of the explicit content : the likelihood of it being explicit'
+        the likelihood is a number 
+        between 1 and 5, 1 being the lowest and 5 the highest.
+        something is explicit if the likelihood is equal or higher than 3.
+        for example : 
+        nsfw_likelihood: 1
+        this is not explicit.
+        for example : 
+        nsfw_likelihood: 3
+        this is explicit.
+        """
+        "Input should be a string."
+    )
+
+    language: str
+
+    feature: str = "text"
+    subfeature: str = "moderation"
+
+    def _parse_response(self, response: list) -> str:
+        formatted_result = []
+        for result in response:
+            if "nsfw_likelihood" in result.keys():
+                formatted_result.append(
+                    "nsfw_likelihood: " + str(result["nsfw_likelihood"])
+                )
+
+            for label, likelihood in zip(result["label"], result["likelihood"]):
+                formatted_result.append(f'"{label}": {str(likelihood)}')
+
+        return "\n".join(formatted_result)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        query_params = {"text": query, "language": self.language}
+        return self._call_eden_ai(query_params)
diff --git a/llm/Lib/site-packages/langchain_community/tools/eleven_labs/__init__.py b/llm/Lib/site-packages/langchain_community/tools/eleven_labs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3cb16a41603b3a999cf1a64511cf1e08679b86fe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/eleven_labs/__init__.py
@@ -0,0 +1,5 @@
+"""Eleven Labs Services Tools."""
+
+from langchain_community.tools.eleven_labs.text2speech import ElevenLabsText2SpeechTool
+
+__all__ = ["ElevenLabsText2SpeechTool"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/eleven_labs/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/eleven_labs/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..df1ec73a1805abbcf07b8b260dbb9575a6e12ada
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/eleven_labs/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/eleven_labs/__pycache__/models.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/eleven_labs/__pycache__/models.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eb685ef9737bd011c8be82f2ea47a2c9048481bb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/eleven_labs/__pycache__/models.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/eleven_labs/__pycache__/text2speech.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/eleven_labs/__pycache__/text2speech.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..415a5e1a713b6c699f0da89f04019c725a43acd8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/eleven_labs/__pycache__/text2speech.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/eleven_labs/models.py b/llm/Lib/site-packages/langchain_community/tools/eleven_labs/models.py
new file mode 100644
index 0000000000000000000000000000000000000000..c977b2972f7d882f0cdd42113468250109162f8e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/eleven_labs/models.py
@@ -0,0 +1,8 @@
+from enum import Enum
+
+
+class ElevenLabsModel(str, Enum):
+    """Models available for Eleven Labs Text2Speech."""
+
+    MULTI_LINGUAL = "eleven_multilingual_v1"
+    MONO_LINGUAL = "eleven_monolingual_v1"
diff --git a/llm/Lib/site-packages/langchain_community/tools/eleven_labs/text2speech.py b/llm/Lib/site-packages/langchain_community/tools/eleven_labs/text2speech.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1a68ba7a5c6feecf6a46ab0957817ad92c76b93
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/eleven_labs/text2speech.py
@@ -0,0 +1,80 @@
+import tempfile
+from enum import Enum
+from typing import Any, Dict, Optional, Union
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+from langchain_core.utils import get_from_dict_or_env
+
+
+def _import_elevenlabs() -> Any:
+    try:
+        import elevenlabs
+    except ImportError as e:
+        raise ImportError(
+            "Cannot import elevenlabs, please install `pip install elevenlabs`."
+        ) from e
+    return elevenlabs
+
+
+class ElevenLabsModel(str, Enum):
+    """Models available for Eleven Labs Text2Speech."""
+
+    MULTI_LINGUAL = "eleven_multilingual_v1"
+    MONO_LINGUAL = "eleven_monolingual_v1"
+
+
+class ElevenLabsText2SpeechTool(BaseTool):
+    """Tool that queries the Eleven Labs Text2Speech API.
+
+    In order to set this up, follow instructions at:
+    https://docs.elevenlabs.io/welcome/introduction
+    """
+
+    model: Union[ElevenLabsModel, str] = ElevenLabsModel.MULTI_LINGUAL
+
+    name: str = "eleven_labs_text2speech"
+    description: str = (
+        "A wrapper around Eleven Labs Text2Speech. "
+        "Useful for when you need to convert text to speech. "
+        "It supports multiple languages, including English, German, Polish, "
+        "Spanish, Italian, French, Portuguese, and Hindi. "
+    )
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        _ = get_from_dict_or_env(values, "eleven_api_key", "ELEVEN_API_KEY")
+
+        return values
+
+    def _run(
+        self, query: str, run_manager: Optional[CallbackManagerForToolRun] = None
+    ) -> str:
+        """Use the tool."""
+        elevenlabs = _import_elevenlabs()
+        try:
+            speech = elevenlabs.generate(text=query, model=self.model)
+            with tempfile.NamedTemporaryFile(
+                mode="bx", suffix=".wav", delete=False
+            ) as f:
+                f.write(speech)
+            return f.name
+        except Exception as e:
+            raise RuntimeError(f"Error while running ElevenLabsText2SpeechTool: {e}")
+
+    def play(self, speech_file: str) -> None:
+        """Play the text as speech."""
+        elevenlabs = _import_elevenlabs()
+        with open(speech_file, mode="rb") as f:
+            speech = f.read()
+
+        elevenlabs.play(speech)
+
+    def stream_speech(self, query: str) -> None:
+        """Stream the text as speech as it is generated.
+        Play the text in your speakers."""
+        elevenlabs = _import_elevenlabs()
+        speech_stream = elevenlabs.generate(text=query, model=self.model, stream=True)
+        elevenlabs.stream(speech_stream)
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/__init__.py b/llm/Lib/site-packages/langchain_community/tools/file_management/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..395f5d5ea6058dfd8b11fd3cd2d197f024f4f593
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/file_management/__init__.py
@@ -0,0 +1,19 @@
+"""File Management Tools."""
+
+from langchain_community.tools.file_management.copy import CopyFileTool
+from langchain_community.tools.file_management.delete import DeleteFileTool
+from langchain_community.tools.file_management.file_search import FileSearchTool
+from langchain_community.tools.file_management.list_dir import ListDirectoryTool
+from langchain_community.tools.file_management.move import MoveFileTool
+from langchain_community.tools.file_management.read import ReadFileTool
+from langchain_community.tools.file_management.write import WriteFileTool
+
+__all__ = [
+    "CopyFileTool",
+    "DeleteFileTool",
+    "FileSearchTool",
+    "MoveFileTool",
+    "ReadFileTool",
+    "WriteFileTool",
+    "ListDirectoryTool",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..38c9e6d53cc6a199688cbf7467055b2caa744e67
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/copy.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/copy.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..00a28059510f2d5e603302767ddbdda7afd35cdd
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/copy.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/delete.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/delete.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..90d4690881971ede927423778c973b08f730d9fd
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/delete.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/file_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/file_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d64270011ab2b0c4a3ae28f275fc9fa4bdf9d454
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/file_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/list_dir.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/list_dir.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1a8bdee9736a77c7f0373123ed587864641786e6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/list_dir.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/move.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/move.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..336e6cef6d2ea16e2b9118e2d71246d1821f6f3a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/move.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/read.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/read.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5d78f75b5013df4e242238a27ddfde81ebbfff42
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/read.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d352ffa50fb07d9f1fa4ef092f085ed37448c7bb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/write.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/write.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d29415d0dab95eaa3e01dfc596442dd2b87afe5d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/file_management/__pycache__/write.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/copy.py b/llm/Lib/site-packages/langchain_community/tools/file_management/copy.py
new file mode 100644
index 0000000000000000000000000000000000000000..f91081003d14c78e598d29e3e778daa2ee66f41a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/file_management/copy.py
@@ -0,0 +1,53 @@
+import shutil
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.file_management.utils import (
+    INVALID_PATH_TEMPLATE,
+    BaseFileToolMixin,
+    FileValidationError,
+)
+
+
+class FileCopyInput(BaseModel):
+    """Input for CopyFileTool."""
+
+    source_path: str = Field(..., description="Path of the file to copy")
+    destination_path: str = Field(..., description="Path to save the copied file")
+
+
+class CopyFileTool(BaseFileToolMixin, BaseTool):
+    """Tool that copies a file."""
+
+    name: str = "copy_file"
+    args_schema: Type[BaseModel] = FileCopyInput
+    description: str = "Create a copy of a file in a specified location"
+
+    def _run(
+        self,
+        source_path: str,
+        destination_path: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        try:
+            source_path_ = self.get_relative_path(source_path)
+        except FileValidationError:
+            return INVALID_PATH_TEMPLATE.format(
+                arg_name="source_path", value=source_path
+            )
+        try:
+            destination_path_ = self.get_relative_path(destination_path)
+        except FileValidationError:
+            return INVALID_PATH_TEMPLATE.format(
+                arg_name="destination_path", value=destination_path
+            )
+        try:
+            shutil.copy2(source_path_, destination_path_, follow_symlinks=False)
+            return f"File copied successfully from {source_path} to {destination_path}."
+        except Exception as e:
+            return "Error: " + str(e)
+
+    # TODO: Add aiofiles method
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/delete.py b/llm/Lib/site-packages/langchain_community/tools/file_management/delete.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2694762aede3742742e506b1d87fc2107ad3044
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/file_management/delete.py
@@ -0,0 +1,45 @@
+import os
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.file_management.utils import (
+    INVALID_PATH_TEMPLATE,
+    BaseFileToolMixin,
+    FileValidationError,
+)
+
+
+class FileDeleteInput(BaseModel):
+    """Input for DeleteFileTool."""
+
+    file_path: str = Field(..., description="Path of the file to delete")
+
+
+class DeleteFileTool(BaseFileToolMixin, BaseTool):
+    """Tool that deletes a file."""
+
+    name: str = "file_delete"
+    args_schema: Type[BaseModel] = FileDeleteInput
+    description: str = "Delete a file"
+
+    def _run(
+        self,
+        file_path: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        try:
+            file_path_ = self.get_relative_path(file_path)
+        except FileValidationError:
+            return INVALID_PATH_TEMPLATE.format(arg_name="file_path", value=file_path)
+        if not file_path_.exists():
+            return f"Error: no such file or directory: {file_path}"
+        try:
+            os.remove(file_path_)
+            return f"File deleted successfully: {file_path}."
+        except Exception as e:
+            return "Error: " + str(e)
+
+    # TODO: Add aiofiles method
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/file_search.py b/llm/Lib/site-packages/langchain_community/tools/file_management/file_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..c77abd0bef95d8fae190cec614bbe977975fe388
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/file_management/file_search.py
@@ -0,0 +1,62 @@
+import fnmatch
+import os
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.file_management.utils import (
+    INVALID_PATH_TEMPLATE,
+    BaseFileToolMixin,
+    FileValidationError,
+)
+
+
+class FileSearchInput(BaseModel):
+    """Input for FileSearchTool."""
+
+    dir_path: str = Field(
+        default=".",
+        description="Subdirectory to search in.",
+    )
+    pattern: str = Field(
+        ...,
+        description="Unix shell regex, where * matches everything.",
+    )
+
+
+class FileSearchTool(BaseFileToolMixin, BaseTool):
+    """Tool that searches for files in a subdirectory that match a regex pattern."""
+
+    name: str = "file_search"
+    args_schema: Type[BaseModel] = FileSearchInput
+    description: str = (
+        "Recursively search for files in a subdirectory that match the regex pattern"
+    )
+
+    def _run(
+        self,
+        pattern: str,
+        dir_path: str = ".",
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        try:
+            dir_path_ = self.get_relative_path(dir_path)
+        except FileValidationError:
+            return INVALID_PATH_TEMPLATE.format(arg_name="dir_path", value=dir_path)
+        matches = []
+        try:
+            for root, _, filenames in os.walk(dir_path_):
+                for filename in fnmatch.filter(filenames, pattern):
+                    absolute_path = os.path.join(root, filename)
+                    relative_path = os.path.relpath(absolute_path, dir_path_)
+                    matches.append(relative_path)
+            if matches:
+                return "\n".join(matches)
+            else:
+                return f"No files found for pattern {pattern} in directory {dir_path}"
+        except Exception as e:
+            return "Error: " + str(e)
+
+    # TODO: Add aiofiles method
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/list_dir.py b/llm/Lib/site-packages/langchain_community/tools/file_management/list_dir.py
new file mode 100644
index 0000000000000000000000000000000000000000..d8b700134ae9f1a2e329889ccbd1c451f857322c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/file_management/list_dir.py
@@ -0,0 +1,46 @@
+import os
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.file_management.utils import (
+    INVALID_PATH_TEMPLATE,
+    BaseFileToolMixin,
+    FileValidationError,
+)
+
+
+class DirectoryListingInput(BaseModel):
+    """Input for ListDirectoryTool."""
+
+    dir_path: str = Field(default=".", description="Subdirectory to list.")
+
+
+class ListDirectoryTool(BaseFileToolMixin, BaseTool):
+    """Tool that lists files and directories in a specified folder."""
+
+    name: str = "list_directory"
+    args_schema: Type[BaseModel] = DirectoryListingInput
+    description: str = "List files and directories in a specified folder"
+
+    def _run(
+        self,
+        dir_path: str = ".",
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        try:
+            dir_path_ = self.get_relative_path(dir_path)
+        except FileValidationError:
+            return INVALID_PATH_TEMPLATE.format(arg_name="dir_path", value=dir_path)
+        try:
+            entries = os.listdir(dir_path_)
+            if entries:
+                return "\n".join(entries)
+            else:
+                return f"No files found in directory {dir_path}"
+        except Exception as e:
+            return "Error: " + str(e)
+
+    # TODO: Add aiofiles method
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/move.py b/llm/Lib/site-packages/langchain_community/tools/file_management/move.py
new file mode 100644
index 0000000000000000000000000000000000000000..fc3bb778d8ef8132bbecf956ec0aea6d65333f1e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/file_management/move.py
@@ -0,0 +1,56 @@
+import shutil
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.file_management.utils import (
+    INVALID_PATH_TEMPLATE,
+    BaseFileToolMixin,
+    FileValidationError,
+)
+
+
+class FileMoveInput(BaseModel):
+    """Input for MoveFileTool."""
+
+    source_path: str = Field(..., description="Path of the file to move")
+    destination_path: str = Field(..., description="New path for the moved file")
+
+
+class MoveFileTool(BaseFileToolMixin, BaseTool):
+    """Tool that moves a file."""
+
+    name: str = "move_file"
+    args_schema: Type[BaseModel] = FileMoveInput
+    description: str = "Move or rename a file from one location to another"
+
+    def _run(
+        self,
+        source_path: str,
+        destination_path: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        try:
+            source_path_ = self.get_relative_path(source_path)
+        except FileValidationError:
+            return INVALID_PATH_TEMPLATE.format(
+                arg_name="source_path", value=source_path
+            )
+        try:
+            destination_path_ = self.get_relative_path(destination_path)
+        except FileValidationError:
+            return INVALID_PATH_TEMPLATE.format(
+                arg_name="destination_path_", value=destination_path_
+            )
+        if not source_path_.exists():
+            return f"Error: no such file or directory {source_path}"
+        try:
+            # shutil.move expects str args in 3.8
+            shutil.move(str(source_path_), destination_path_)
+            return f"File moved successfully from {source_path} to {destination_path}."
+        except Exception as e:
+            return "Error: " + str(e)
+
+    # TODO: Add aiofiles method
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/read.py b/llm/Lib/site-packages/langchain_community/tools/file_management/read.py
new file mode 100644
index 0000000000000000000000000000000000000000..42cc1515e7e70d60d6cd8ede1923b796bcaba8c2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/file_management/read.py
@@ -0,0 +1,45 @@
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.file_management.utils import (
+    INVALID_PATH_TEMPLATE,
+    BaseFileToolMixin,
+    FileValidationError,
+)
+
+
+class ReadFileInput(BaseModel):
+    """Input for ReadFileTool."""
+
+    file_path: str = Field(..., description="name of file")
+
+
+class ReadFileTool(BaseFileToolMixin, BaseTool):
+    """Tool that reads a file."""
+
+    name: str = "read_file"
+    args_schema: Type[BaseModel] = ReadFileInput
+    description: str = "Read file from disk"
+
+    def _run(
+        self,
+        file_path: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        try:
+            read_path = self.get_relative_path(file_path)
+        except FileValidationError:
+            return INVALID_PATH_TEMPLATE.format(arg_name="file_path", value=file_path)
+        if not read_path.exists():
+            return f"Error: no such file or directory: {file_path}"
+        try:
+            with read_path.open("r", encoding="utf-8") as f:
+                content = f.read()
+            return content
+        except Exception as e:
+            return "Error: " + str(e)
+
+    # TODO: Add aiofiles method
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/utils.py b/llm/Lib/site-packages/langchain_community/tools/file_management/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..b2a3632ecaa880ce9e7f5de54f18749be366c17d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/file_management/utils.py
@@ -0,0 +1,54 @@
+import sys
+from pathlib import Path
+from typing import Optional
+
+from langchain_core.pydantic_v1 import BaseModel
+
+
+def is_relative_to(path: Path, root: Path) -> bool:
+    """Check if path is relative to root."""
+    if sys.version_info >= (3, 9):
+        # No need for a try/except block in Python 3.8+.
+        return path.is_relative_to(root)
+    try:
+        path.relative_to(root)
+        return True
+    except ValueError:
+        return False
+
+
+INVALID_PATH_TEMPLATE = (
+    "Error: Access denied to {arg_name}: {value}."
+    " Permission granted exclusively to the current working directory"
+)
+
+
+class FileValidationError(ValueError):
+    """Error for paths outside the root directory."""
+
+
+class BaseFileToolMixin(BaseModel):
+    """Mixin for file system tools."""
+
+    root_dir: Optional[str] = None
+    """The final path will be chosen relative to root_dir if specified."""
+
+    def get_relative_path(self, file_path: str) -> Path:
+        """Get the relative path, returning an error if unsupported."""
+        if self.root_dir is None:
+            return Path(file_path)
+        return get_validated_relative_path(Path(self.root_dir), file_path)
+
+
+def get_validated_relative_path(root: Path, user_path: str) -> Path:
+    """Resolve a relative path, raising an error if not within the root directory."""
+    # Note, this still permits symlinks from outside that point within the root.
+    # Further validation would be needed if those are to be disallowed.
+    root = root.resolve()
+    full_path = (root / user_path).resolve()
+
+    if not is_relative_to(full_path, root):
+        raise FileValidationError(
+            f"Path {user_path} is outside of the allowed directory {root}"
+        )
+    return full_path
diff --git a/llm/Lib/site-packages/langchain_community/tools/file_management/write.py b/llm/Lib/site-packages/langchain_community/tools/file_management/write.py
new file mode 100644
index 0000000000000000000000000000000000000000..b42b70256b7fe0900deb17fbf45e3c9a7e13dbd8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/file_management/write.py
@@ -0,0 +1,51 @@
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.file_management.utils import (
+    INVALID_PATH_TEMPLATE,
+    BaseFileToolMixin,
+    FileValidationError,
+)
+
+
+class WriteFileInput(BaseModel):
+    """Input for WriteFileTool."""
+
+    file_path: str = Field(..., description="name of file")
+    text: str = Field(..., description="text to write to file")
+    append: bool = Field(
+        default=False, description="Whether to append to an existing file."
+    )
+
+
+class WriteFileTool(BaseFileToolMixin, BaseTool):
+    """Tool that writes a file to disk."""
+
+    name: str = "write_file"
+    args_schema: Type[BaseModel] = WriteFileInput
+    description: str = "Write file to disk"
+
+    def _run(
+        self,
+        file_path: str,
+        text: str,
+        append: bool = False,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        try:
+            write_path = self.get_relative_path(file_path)
+        except FileValidationError:
+            return INVALID_PATH_TEMPLATE.format(arg_name="file_path", value=file_path)
+        try:
+            write_path.parent.mkdir(exist_ok=True, parents=False)
+            mode = "a" if append else "w"
+            with write_path.open(mode, encoding="utf-8") as f:
+                f.write(text)
+            return f"File written successfully to {file_path}."
+        except Exception as e:
+            return "Error: " + str(e)
+
+    # TODO: Add aiofiles method
diff --git a/llm/Lib/site-packages/langchain_community/tools/github/__init__.py b/llm/Lib/site-packages/langchain_community/tools/github/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e737ac26ba0b50abe7a31f623d04ac5757f3905e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/github/__init__.py
@@ -0,0 +1 @@
+""" GitHub Tool """
diff --git a/llm/Lib/site-packages/langchain_community/tools/github/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/github/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a7c860be61be7bfa9e27968d6673375062008f57
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/github/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/github/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/github/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..56fb287422fb5b3502c928e880b35c82143aef60
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/github/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/github/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/github/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..deeca209803344361a3458e83c88849f3495a35b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/github/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/github/prompt.py b/llm/Lib/site-packages/langchain_community/tools/github/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..3d66713e02b7e866988599e339df6a09d7f2abbe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/github/prompt.py
@@ -0,0 +1,100 @@
+# flake8: noqa
+GET_ISSUES_PROMPT = """
+This tool will fetch a list of the repository's issues. It will return the title, and issue number of 5 issues. It takes no input."""
+
+GET_ISSUE_PROMPT = """
+This tool will fetch the title, body, and comment thread of a specific issue. **VERY IMPORTANT**: You must specify the issue number as an integer."""
+
+COMMENT_ON_ISSUE_PROMPT = """
+This tool is useful when you need to comment on a GitHub issue. Simply pass in the issue number and the comment you would like to make. Please use this sparingly as we don't want to clutter the comment threads. **VERY IMPORTANT**: Your input to this tool MUST strictly follow these rules:
+
+- First you must specify the issue number as an integer
+- Then you must place two newlines
+- Then you must specify your comment"""
+
+CREATE_PULL_REQUEST_PROMPT = """
+This tool is useful when you need to create a new pull request in a GitHub repository. **VERY IMPORTANT**: Your input to this tool MUST strictly follow these rules:
+
+- First you must specify the title of the pull request
+- Then you must place two newlines
+- Then you must write the body or description of the pull request
+
+When appropriate, always reference relevant issues in the body by using the syntax `closes #<issue_number` like `closes #3, closes #6`.
+For example, if you would like to create a pull request called "README updates" with contents "added contributors' names, closes #3", you would pass in the following string:
+
+README updates
+
+added contributors' names, closes #3"""
+
+CREATE_FILE_PROMPT = """
+This tool is a wrapper for the GitHub API, useful when you need to create a file in a GitHub repository. **VERY IMPORTANT**: Your input to this tool MUST strictly follow these rules:
+
+- First you must specify which file to create by passing a full file path (**IMPORTANT**: the path must not start with a slash)
+- Then you must specify the contents of the file
+
+For example, if you would like to create a file called /test/test.txt with contents "test contents", you would pass in the following string:
+
+test/test.txt
+
+test contents"""
+
+READ_FILE_PROMPT = """
+This tool is a wrapper for the GitHub API, useful when you need to read the contents of a file. Simply pass in the full file path of the file you would like to read. **IMPORTANT**: the path must not start with a slash"""
+
+UPDATE_FILE_PROMPT = """
+This tool is a wrapper for the GitHub API, useful when you need to update the contents of a file in a GitHub repository. **VERY IMPORTANT**: Your input to this tool MUST strictly follow these rules:
+
+- First you must specify which file to modify by passing a full file path (**IMPORTANT**: the path must not start with a slash)
+- Then you must specify the old contents which you would like to replace wrapped in OLD <<<< and >>>> OLD
+- Then you must specify the new contents which you would like to replace the old contents with wrapped in NEW <<<< and >>>> NEW
+
+For example, if you would like to replace the contents of the file /test/test.txt from "old contents" to "new contents", you would pass in the following string:
+
+test/test.txt
+
+This is text that will not be changed
+OLD <<<<
+old contents
+>>>> OLD
+NEW <<<<
+new contents
+>>>> NEW"""
+
+DELETE_FILE_PROMPT = """
+This tool is a wrapper for the GitHub API, useful when you need to delete a file in a GitHub repository. Simply pass in the full file path of the file you would like to delete. **IMPORTANT**: the path must not start with a slash"""
+
+GET_PR_PROMPT = """
+This tool will fetch the title, body, comment thread and commit history of a specific Pull Request (by PR number). **VERY IMPORTANT**: You must specify the PR number as an integer."""
+
+LIST_PRS_PROMPT = """
+This tool will fetch a list of the repository's Pull Requests (PRs). It will return the title, and PR number of 5 PRs. It takes no input."""
+
+LIST_PULL_REQUEST_FILES = """
+This tool will fetch the full text of all files in a pull request (PR) given the PR number as an input. This is useful for understanding the code changes in a PR or contributing to it. **VERY IMPORTANT**: You must specify the PR number as an integer input parameter."""
+
+OVERVIEW_EXISTING_FILES_IN_MAIN = """
+This tool will provide an overview of all existing files in the main branch of the repository. It will list the file names, their respective paths, and a brief summary of their contents. This can be useful for understanding the structure and content of the repository, especially when navigating through large codebases. No input parameters are required."""
+
+OVERVIEW_EXISTING_FILES_BOT_BRANCH = """
+This tool will provide an overview of all files in your current working branch where you should implement changes. This is great for getting a high level overview of the structure of your code. No input parameters are required."""
+
+SEARCH_ISSUES_AND_PRS_PROMPT = """
+This tool will search for issues and pull requests in the repository. **VERY IMPORTANT**: You must specify the search query as a string input parameter."""
+
+SEARCH_CODE_PROMPT = """
+This tool will search for code in the repository. **VERY IMPORTANT**: You must specify the search query as a string input parameter."""
+
+CREATE_REVIEW_REQUEST_PROMPT = """
+This tool will create a review request on the open pull request that matches the current active branch. **VERY IMPORTANT**: You must specify the username of the person who is being requested as a string input parameter."""
+
+LIST_BRANCHES_IN_REPO_PROMPT = """
+This tool will fetch a list of all branches in the repository. It will return the name of each branch. No input parameters are required."""
+
+SET_ACTIVE_BRANCH_PROMPT = """
+This tool will set the active branch in the repository, similar to `git checkout <branch_name>` and `git switch -c <branch_name>`. **VERY IMPORTANT**: You must specify the name of the branch as a string input parameter."""
+
+CREATE_BRANCH_PROMPT = """
+This tool will create a new branch in the repository. **VERY IMPORTANT**: You must specify the name of the new branch as a string input parameter."""
+
+GET_FILES_FROM_DIRECTORY_PROMPT = """
+This tool will fetch a list of all files in a specified directory. **VERY IMPORTANT**: You must specify the path of the directory as a string input parameter."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/github/tool.py b/llm/Lib/site-packages/langchain_community/tools/github/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..89253183632702173261bf782d0d2eb7e5aa90d8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/github/tool.py
@@ -0,0 +1,37 @@
+"""
+This tool allows agents to interact with the pygithub library
+and operate on a GitHub repository.
+
+To use this tool, you must first set as environment variables:
+    GITHUB_API_TOKEN
+    GITHUB_REPOSITORY -> format: {owner}/{repo}
+
+"""
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.github import GitHubAPIWrapper
+
+
+class GitHubAction(BaseTool):
+    """Tool for interacting with the GitHub API."""
+
+    api_wrapper: GitHubAPIWrapper = Field(default_factory=GitHubAPIWrapper)
+    mode: str
+    name: str = ""
+    description: str = ""
+    args_schema: Optional[Type[BaseModel]] = None
+
+    def _run(
+        self,
+        instructions: Optional[str] = "",
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the GitHub API to run an operation."""
+        if not instructions or instructions == "{}":
+            # Catch other forms of empty input that GPT-4 likes to send.
+            instructions = ""
+        return self.api_wrapper.run(self.mode, instructions)
diff --git a/llm/Lib/site-packages/langchain_community/tools/gitlab/__init__.py b/llm/Lib/site-packages/langchain_community/tools/gitlab/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b6d6367663ab6c5a299129767fa52896f8bdc0f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/gitlab/__init__.py
@@ -0,0 +1 @@
+""" GitLab Tool """
diff --git a/llm/Lib/site-packages/langchain_community/tools/gitlab/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/gitlab/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1b0ef87f248d8976a5a0ac98a506ff60aa37dc77
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/gitlab/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/gitlab/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/gitlab/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..73f4fc967a142c5ce2b9c1b3ebb500315395dd6a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/gitlab/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/gitlab/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/gitlab/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fb679fc399fcc75875c86d69829a38c4c3b0d827
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/gitlab/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/gitlab/prompt.py b/llm/Lib/site-packages/langchain_community/tools/gitlab/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..3f303155cd42717adc0941db52138398f92a62a8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/gitlab/prompt.py
@@ -0,0 +1,70 @@
+# flake8: noqa
+GET_ISSUES_PROMPT = """
+This tool will fetch a list of the repository's issues. It will return the title, and issue number of 5 issues. It takes no input.
+"""
+
+GET_ISSUE_PROMPT = """
+This tool will fetch the title, body, and comment thread of a specific issue. **VERY IMPORTANT**: You must specify the issue number as an integer.
+"""
+
+COMMENT_ON_ISSUE_PROMPT = """
+This tool is useful when you need to comment on a GitLab issue. Simply pass in the issue number and the comment you would like to make. Please use this sparingly as we don't want to clutter the comment threads. **VERY IMPORTANT**: Your input to this tool MUST strictly follow these rules:
+
+- First you must specify the issue number as an integer
+- Then you must place two newlines
+- Then you must specify your comment
+"""
+CREATE_PULL_REQUEST_PROMPT = """
+This tool is useful when you need to create a new pull request in a GitLab repository. **VERY IMPORTANT**: Your input to this tool MUST strictly follow these rules:
+
+- First you must specify the title of the pull request
+- Then you must place two newlines
+- Then you must write the body or description of the pull request
+
+To reference an issue in the body, put its issue number directly after a #.
+For example, if you would like to create a pull request called "README updates" with contents "added contributors' names, closes issue #3", you would pass in the following string:
+
+README updates
+
+added contributors' names, closes issue #3
+"""
+CREATE_FILE_PROMPT = """
+This tool is a wrapper for the GitLab API, useful when you need to create a file in a GitLab repository. **VERY IMPORTANT**: Your input to this tool MUST strictly follow these rules:
+
+- First you must specify which file to create by passing a full file path (**IMPORTANT**: the path must not start with a slash)
+- Then you must specify the contents of the file
+
+For example, if you would like to create a file called /test/test.txt with contents "test contents", you would pass in the following string:
+
+test/test.txt
+
+test contents
+"""
+
+READ_FILE_PROMPT = """
+This tool is a wrapper for the GitLab API, useful when you need to read the contents of a file in a GitLab repository. Simply pass in the full file path of the file you would like to read. **IMPORTANT**: the path must not start with a slash
+"""
+
+UPDATE_FILE_PROMPT = """
+This tool is a wrapper for the GitLab API, useful when you need to update the contents of a file in a GitLab repository. **VERY IMPORTANT**: Your input to this tool MUST strictly follow these rules:
+
+- First you must specify which file to modify by passing a full file path (**IMPORTANT**: the path must not start with a slash)
+- Then you must specify the old contents which you would like to replace wrapped in OLD <<<< and >>>> OLD
+- Then you must specify the new contents which you would like to replace the old contents with wrapped in NEW <<<< and >>>> NEW
+
+For example, if you would like to replace the contents of the file /test/test.txt from "old contents" to "new contents", you would pass in the following string:
+
+test/test.txt
+
+This is text that will not be changed
+OLD <<<<
+old contents
+>>>> OLD
+NEW <<<<
+new contents
+>>>> NEW
+"""
+
+DELETE_FILE_PROMPT = """
+This tool is a wrapper for the GitLab API, useful when you need to delete a file in a GitLab repository. Simply pass in the full file path of the file you would like to delete. **IMPORTANT**: the path must not start with a slash
+"""
diff --git a/llm/Lib/site-packages/langchain_community/tools/gitlab/tool.py b/llm/Lib/site-packages/langchain_community/tools/gitlab/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..92ea8b98bf95c86da2bae25f6f6671b7b6eae4f2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/gitlab/tool.py
@@ -0,0 +1,33 @@
+"""
+This tool allows agents to interact with the python-gitlab library
+and operate on a GitLab repository.
+
+To use this tool, you must first set as environment variables:
+    GITLAB_PRIVATE_ACCESS_TOKEN
+    GITLAB_REPOSITORY -> format: {owner}/{repo}
+
+"""
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.gitlab import GitLabAPIWrapper
+
+
+class GitLabAction(BaseTool):
+    """Tool for interacting with the GitLab API."""
+
+    api_wrapper: GitLabAPIWrapper = Field(default_factory=GitLabAPIWrapper)
+    mode: str
+    name: str = ""
+    description: str = ""
+
+    def _run(
+        self,
+        instructions: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the GitLab API to run an operation."""
+        return self.api_wrapper.run(self.mode, instructions)
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/__init__.py b/llm/Lib/site-packages/langchain_community/tools/gmail/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ef66e21dc73be6cfc2adfbdfe61dde628a01bbd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/gmail/__init__.py
@@ -0,0 +1,17 @@
+"""Gmail tools."""
+
+from langchain_community.tools.gmail.create_draft import GmailCreateDraft
+from langchain_community.tools.gmail.get_message import GmailGetMessage
+from langchain_community.tools.gmail.get_thread import GmailGetThread
+from langchain_community.tools.gmail.search import GmailSearch
+from langchain_community.tools.gmail.send_message import GmailSendMessage
+from langchain_community.tools.gmail.utils import get_gmail_credentials
+
+__all__ = [
+    "GmailCreateDraft",
+    "GmailSendMessage",
+    "GmailSearch",
+    "GmailGetMessage",
+    "GmailGetThread",
+    "get_gmail_credentials",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..97eb74bb98300fba05292d471e387113718a8ffe
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a044b3f3834bda2cad7f7f68183c8d3977839d1b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/create_draft.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/create_draft.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..89ca4bd1f7cbd35a498dfa15b15e03b0e225fec3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/create_draft.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/get_message.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/get_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..be9a578491d9b9401eb3aa207ca7a68dfe57120d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/get_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/get_thread.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/get_thread.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fa487452959d07a59605cbcf7e047c8365c0e241
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/get_thread.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..da77c5a35b9eedd1deb44b55098c8094495369ba
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/send_message.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/send_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..71d002aa0ade054dfbab28a72bfbada5ea5662c1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/send_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..15e0d77995e97db3f08a1167b0db44e460d8f9f6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/gmail/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/base.py b/llm/Lib/site-packages/langchain_community/tools/gmail/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..b96e16117fbbd40cc28334a49fe89c8e0227e7e2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/gmail/base.py
@@ -0,0 +1,37 @@
+"""Base class for Gmail tools."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.gmail.utils import build_resource_service
+
+if TYPE_CHECKING:
+    # This is for linting and IDE typehints
+    from googleapiclient.discovery import Resource
+else:
+    try:
+        # We do this so pydantic can resolve the types when instantiating
+        from googleapiclient.discovery import Resource
+    except ImportError:
+        pass
+
+
+class GmailBaseTool(BaseTool):
+    """Base class for Gmail tools."""
+
+    api_resource: Resource = Field(default_factory=build_resource_service)
+
+    @classmethod
+    def from_api_resource(cls, api_resource: Resource) -> "GmailBaseTool":
+        """Create a tool from an api resource.
+
+        Args:
+            api_resource: The api resource to use.
+
+        Returns:
+            A tool.
+        """
+        return cls(service=api_resource)
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/create_draft.py b/llm/Lib/site-packages/langchain_community/tools/gmail/create_draft.py
new file mode 100644
index 0000000000000000000000000000000000000000..b8e6ac93c6178d831f80184b7c0e80e19b5dd654
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/gmail/create_draft.py
@@ -0,0 +1,87 @@
+import base64
+from email.message import EmailMessage
+from typing import List, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.gmail.base import GmailBaseTool
+
+
+class CreateDraftSchema(BaseModel):
+    """Input for CreateDraftTool."""
+
+    message: str = Field(
+        ...,
+        description="The message to include in the draft.",
+    )
+    to: List[str] = Field(
+        ...,
+        description="The list of recipients.",
+    )
+    subject: str = Field(
+        ...,
+        description="The subject of the message.",
+    )
+    cc: Optional[List[str]] = Field(
+        None,
+        description="The list of CC recipients.",
+    )
+    bcc: Optional[List[str]] = Field(
+        None,
+        description="The list of BCC recipients.",
+    )
+
+
+class GmailCreateDraft(GmailBaseTool):
+    """Tool that creates a draft email for Gmail."""
+
+    name: str = "create_gmail_draft"
+    description: str = (
+        "Use this tool to create a draft email with the provided message fields."
+    )
+    args_schema: Type[CreateDraftSchema] = CreateDraftSchema
+
+    def _prepare_draft_message(
+        self,
+        message: str,
+        to: List[str],
+        subject: str,
+        cc: Optional[List[str]] = None,
+        bcc: Optional[List[str]] = None,
+    ) -> dict:
+        draft_message = EmailMessage()
+        draft_message.set_content(message)
+
+        draft_message["To"] = ", ".join(to)
+        draft_message["Subject"] = subject
+        if cc is not None:
+            draft_message["Cc"] = ", ".join(cc)
+
+        if bcc is not None:
+            draft_message["Bcc"] = ", ".join(bcc)
+
+        encoded_message = base64.urlsafe_b64encode(draft_message.as_bytes()).decode()
+        return {"message": {"raw": encoded_message}}
+
+    def _run(
+        self,
+        message: str,
+        to: List[str],
+        subject: str,
+        cc: Optional[List[str]] = None,
+        bcc: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        try:
+            create_message = self._prepare_draft_message(message, to, subject, cc, bcc)
+            draft = (
+                self.api_resource.users()
+                .drafts()
+                .create(userId="me", body=create_message)
+                .execute()
+            )
+            output = f'Draft created. Draft Id: {draft["id"]}'
+            return output
+        except Exception as e:
+            raise Exception(f"An error occurred: {e}")
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/get_message.py b/llm/Lib/site-packages/langchain_community/tools/gmail/get_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..79b963453e8fb189894f5ea7c9ce52f33d85d94d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/gmail/get_message.py
@@ -0,0 +1,70 @@
+import base64
+import email
+from typing import Dict, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.gmail.base import GmailBaseTool
+from langchain_community.tools.gmail.utils import clean_email_body
+
+
+class SearchArgsSchema(BaseModel):
+    """Input for GetMessageTool."""
+
+    message_id: str = Field(
+        ...,
+        description="The unique ID of the email message, retrieved from a search.",
+    )
+
+
+class GmailGetMessage(GmailBaseTool):
+    """Tool that gets a message by ID from Gmail."""
+
+    name: str = "get_gmail_message"
+    description: str = (
+        "Use this tool to fetch an email by message ID."
+        " Returns the thread ID, snippet, body, subject, and sender."
+    )
+    args_schema: Type[SearchArgsSchema] = SearchArgsSchema
+
+    def _run(
+        self,
+        message_id: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> Dict:
+        """Run the tool."""
+        query = (
+            self.api_resource.users()
+            .messages()
+            .get(userId="me", format="raw", id=message_id)
+        )
+        message_data = query.execute()
+        raw_message = base64.urlsafe_b64decode(message_data["raw"])
+
+        email_msg = email.message_from_bytes(raw_message)
+
+        subject = email_msg["Subject"]
+        sender = email_msg["From"]
+
+        message_body = ""
+        if email_msg.is_multipart():
+            for part in email_msg.walk():
+                ctype = part.get_content_type()
+                cdispo = str(part.get("Content-Disposition"))
+                if ctype == "text/plain" and "attachment" not in cdispo:
+                    message_body = part.get_payload(decode=True).decode("utf-8")
+                    break
+        else:
+            message_body = email_msg.get_payload(decode=True).decode("utf-8")
+
+        body = clean_email_body(message_body)
+
+        return {
+            "id": message_id,
+            "threadId": message_data["threadId"],
+            "snippet": message_data["snippet"],
+            "body": body,
+            "subject": subject,
+            "sender": sender,
+        }
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/get_thread.py b/llm/Lib/site-packages/langchain_community/tools/gmail/get_thread.py
new file mode 100644
index 0000000000000000000000000000000000000000..c42c90924b6dc0803dcafc31e691ea6538118c49
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/gmail/get_thread.py
@@ -0,0 +1,48 @@
+from typing import Dict, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.gmail.base import GmailBaseTool
+
+
+class GetThreadSchema(BaseModel):
+    """Input for GetMessageTool."""
+
+    # From https://support.google.com/mail/answer/7190?hl=en
+    thread_id: str = Field(
+        ...,
+        description="The thread ID.",
+    )
+
+
+class GmailGetThread(GmailBaseTool):
+    """Tool that gets a thread by ID from Gmail."""
+
+    name: str = "get_gmail_thread"
+    description: str = (
+        "Use this tool to search for email messages."
+        " The input must be a valid Gmail query."
+        " The output is a JSON list of messages."
+    )
+    args_schema: Type[GetThreadSchema] = GetThreadSchema
+
+    def _run(
+        self,
+        thread_id: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> Dict:
+        """Run the tool."""
+        query = self.api_resource.users().threads().get(userId="me", id=thread_id)
+        thread_data = query.execute()
+        if not isinstance(thread_data, dict):
+            raise ValueError("The output of the query must be a list.")
+        messages = thread_data["messages"]
+        thread_data["messages"] = []
+        keys_to_keep = ["id", "snippet", "snippet"]
+        # TODO: Parse body.
+        for message in messages:
+            thread_data["messages"].append(
+                {k: message[k] for k in keys_to_keep if k in message}
+            )
+        return thread_data
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/search.py b/llm/Lib/site-packages/langchain_community/tools/gmail/search.py
new file mode 100644
index 0000000000000000000000000000000000000000..8c49db5e86641b309eb84e4a4d6e9c92108caf60
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/gmail/search.py
@@ -0,0 +1,145 @@
+import base64
+import email
+from enum import Enum
+from typing import Any, Dict, List, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.gmail.base import GmailBaseTool
+from langchain_community.tools.gmail.utils import clean_email_body
+
+
+class Resource(str, Enum):
+    """Enumerator of Resources to search."""
+
+    THREADS = "threads"
+    MESSAGES = "messages"
+
+
+class SearchArgsSchema(BaseModel):
+    """Input for SearchGmailTool."""
+
+    # From https://support.google.com/mail/answer/7190?hl=en
+    query: str = Field(
+        ...,
+        description="The Gmail query. Example filters include from:sender,"
+        " to:recipient, subject:subject, -filtered_term,"
+        " in:folder, is:important|read|starred, after:year/mo/date, "
+        "before:year/mo/date, label:label_name"
+        ' "exact phrase".'
+        " Search newer/older than using d (day), m (month), and y (year): "
+        "newer_than:2d, older_than:1y."
+        " Attachments with extension example: filename:pdf. Multiple term"
+        " matching example: from:amy OR from:david.",
+    )
+    resource: Resource = Field(
+        default=Resource.MESSAGES,
+        description="Whether to search for threads or messages.",
+    )
+    max_results: int = Field(
+        default=10,
+        description="The maximum number of results to return.",
+    )
+
+
+class GmailSearch(GmailBaseTool):
+    """Tool that searches for messages or threads in Gmail."""
+
+    name: str = "search_gmail"
+    description: str = (
+        "Use this tool to search for email messages or threads."
+        " The input must be a valid Gmail query."
+        " The output is a JSON list of the requested resource."
+    )
+    args_schema: Type[SearchArgsSchema] = SearchArgsSchema
+
+    def _parse_threads(self, threads: List[Dict[str, Any]]) -> List[Dict[str, Any]]:
+        # Add the thread message snippets to the thread results
+        results = []
+        for thread in threads:
+            thread_id = thread["id"]
+            thread_data = (
+                self.api_resource.users()
+                .threads()
+                .get(userId="me", id=thread_id)
+                .execute()
+            )
+            messages = thread_data["messages"]
+            thread["messages"] = []
+            for message in messages:
+                snippet = message["snippet"]
+                thread["messages"].append({"snippet": snippet, "id": message["id"]})
+            results.append(thread)
+
+        return results
+
+    def _parse_messages(self, messages: List[Dict[str, Any]]) -> List[Dict[str, Any]]:
+        results = []
+        for message in messages:
+            message_id = message["id"]
+            message_data = (
+                self.api_resource.users()
+                .messages()
+                .get(userId="me", format="raw", id=message_id)
+                .execute()
+            )
+
+            raw_message = base64.urlsafe_b64decode(message_data["raw"])
+
+            email_msg = email.message_from_bytes(raw_message)
+
+            subject = email_msg["Subject"]
+            sender = email_msg["From"]
+
+            message_body = ""
+            if email_msg.is_multipart():
+                for part in email_msg.walk():
+                    ctype = part.get_content_type()
+                    cdispo = str(part.get("Content-Disposition"))
+                    if ctype == "text/plain" and "attachment" not in cdispo:
+                        try:
+                            message_body = part.get_payload(decode=True).decode("utf-8")
+                        except UnicodeDecodeError:
+                            message_body = part.get_payload(decode=True).decode(
+                                "latin-1"
+                            )
+                        break
+            else:
+                message_body = email_msg.get_payload(decode=True).decode("utf-8")
+
+            body = clean_email_body(message_body)
+
+            results.append(
+                {
+                    "id": message["id"],
+                    "threadId": message_data["threadId"],
+                    "snippet": message_data["snippet"],
+                    "body": body,
+                    "subject": subject,
+                    "sender": sender,
+                }
+            )
+        return results
+
+    def _run(
+        self,
+        query: str,
+        resource: Resource = Resource.MESSAGES,
+        max_results: int = 10,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> List[Dict[str, Any]]:
+        """Run the tool."""
+        results = (
+            self.api_resource.users()
+            .messages()
+            .list(userId="me", q=query, maxResults=max_results)
+            .execute()
+            .get(resource.value, [])
+        )
+        if resource == Resource.THREADS:
+            return self._parse_threads(results)
+        elif resource == Resource.MESSAGES:
+            return self._parse_messages(results)
+        else:
+            raise NotImplementedError(f"Resource of type {resource} not implemented.")
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/send_message.py b/llm/Lib/site-packages/langchain_community/tools/gmail/send_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..8aecc211095ffeecd54a4db02bf53eef3cf343b9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/gmail/send_message.py
@@ -0,0 +1,90 @@
+"""Send Gmail messages."""
+import base64
+from email.mime.multipart import MIMEMultipart
+from email.mime.text import MIMEText
+from typing import Any, Dict, List, Optional, Type, Union
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.gmail.base import GmailBaseTool
+
+
+class SendMessageSchema(BaseModel):
+    """Input for SendMessageTool."""
+
+    message: str = Field(
+        ...,
+        description="The message to send.",
+    )
+    to: Union[str, List[str]] = Field(
+        ...,
+        description="The list of recipients.",
+    )
+    subject: str = Field(
+        ...,
+        description="The subject of the message.",
+    )
+    cc: Optional[Union[str, List[str]]] = Field(
+        None,
+        description="The list of CC recipients.",
+    )
+    bcc: Optional[Union[str, List[str]]] = Field(
+        None,
+        description="The list of BCC recipients.",
+    )
+
+
+class GmailSendMessage(GmailBaseTool):
+    """Tool that sends a message to Gmail."""
+
+    name: str = "send_gmail_message"
+    description: str = (
+        "Use this tool to send email messages." " The input is the message, recipients"
+    )
+    args_schema: Type[SendMessageSchema] = SendMessageSchema
+
+    def _prepare_message(
+        self,
+        message: str,
+        to: Union[str, List[str]],
+        subject: str,
+        cc: Optional[Union[str, List[str]]] = None,
+        bcc: Optional[Union[str, List[str]]] = None,
+    ) -> Dict[str, Any]:
+        """Create a message for an email."""
+        mime_message = MIMEMultipart()
+        mime_message.attach(MIMEText(message, "html"))
+
+        mime_message["To"] = ", ".join(to if isinstance(to, list) else [to])
+        mime_message["Subject"] = subject
+        if cc is not None:
+            mime_message["Cc"] = ", ".join(cc if isinstance(cc, list) else [cc])
+
+        if bcc is not None:
+            mime_message["Bcc"] = ", ".join(bcc if isinstance(bcc, list) else [bcc])
+
+        encoded_message = base64.urlsafe_b64encode(mime_message.as_bytes()).decode()
+        return {"raw": encoded_message}
+
+    def _run(
+        self,
+        message: str,
+        to: Union[str, List[str]],
+        subject: str,
+        cc: Optional[Union[str, List[str]]] = None,
+        bcc: Optional[Union[str, List[str]]] = None,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Run the tool."""
+        try:
+            create_message = self._prepare_message(message, to, subject, cc=cc, bcc=bcc)
+            send_message = (
+                self.api_resource.users()
+                .messages()
+                .send(userId="me", body=create_message)
+            )
+            sent_message = send_message.execute()
+            return f'Message sent. Message Id: {sent_message["id"]}'
+        except Exception as error:
+            raise Exception(f"An error occurred: {error}")
diff --git a/llm/Lib/site-packages/langchain_community/tools/gmail/utils.py b/llm/Lib/site-packages/langchain_community/tools/gmail/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..ee562174c2f3ffe6e62dfef5f886b4a54ec25ba2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/gmail/utils.py
@@ -0,0 +1,132 @@
+"""Gmail tool utils."""
+from __future__ import annotations
+
+import logging
+import os
+from typing import TYPE_CHECKING, List, Optional, Tuple
+
+if TYPE_CHECKING:
+    from google.auth.transport.requests import Request
+    from google.oauth2.credentials import Credentials
+    from google_auth_oauthlib.flow import InstalledAppFlow
+    from googleapiclient.discovery import Resource
+    from googleapiclient.discovery import build as build_resource
+
+logger = logging.getLogger(__name__)
+
+
+def import_google() -> Tuple[Request, Credentials]:
+    """Import google libraries.
+
+    Returns:
+        Tuple[Request, Credentials]: Request and Credentials classes.
+    """
+    # google-auth-httplib2
+    try:
+        from google.auth.transport.requests import Request  # noqa: F401
+        from google.oauth2.credentials import Credentials  # noqa: F401
+    except ImportError:
+        raise ImportError(
+            "You need to install google-auth-httplib2 to use this toolkit. "
+            "Try running pip install --upgrade google-auth-httplib2"
+        )
+    return Request, Credentials
+
+
+def import_installed_app_flow() -> InstalledAppFlow:
+    """Import InstalledAppFlow class.
+
+    Returns:
+        InstalledAppFlow: InstalledAppFlow class.
+    """
+    try:
+        from google_auth_oauthlib.flow import InstalledAppFlow
+    except ImportError:
+        raise ImportError(
+            "You need to install google-auth-oauthlib to use this toolkit. "
+            "Try running pip install --upgrade google-auth-oauthlib"
+        )
+    return InstalledAppFlow
+
+
+def import_googleapiclient_resource_builder() -> build_resource:
+    """Import googleapiclient.discovery.build function.
+
+    Returns:
+        build_resource: googleapiclient.discovery.build function.
+    """
+    try:
+        from googleapiclient.discovery import build
+    except ImportError:
+        raise ImportError(
+            "You need to install googleapiclient to use this toolkit. "
+            "Try running pip install --upgrade google-api-python-client"
+        )
+    return build
+
+
+DEFAULT_SCOPES = ["https://mail.google.com/"]
+DEFAULT_CREDS_TOKEN_FILE = "token.json"
+DEFAULT_CLIENT_SECRETS_FILE = "credentials.json"
+
+
+def get_gmail_credentials(
+    token_file: Optional[str] = None,
+    client_secrets_file: Optional[str] = None,
+    scopes: Optional[List[str]] = None,
+) -> Credentials:
+    """Get credentials."""
+    # From https://developers.google.com/gmail/api/quickstart/python
+    Request, Credentials = import_google()
+    InstalledAppFlow = import_installed_app_flow()
+    creds = None
+    scopes = scopes or DEFAULT_SCOPES
+    token_file = token_file or DEFAULT_CREDS_TOKEN_FILE
+    client_secrets_file = client_secrets_file or DEFAULT_CLIENT_SECRETS_FILE
+    # The file token.json stores the user's access and refresh tokens, and is
+    # created automatically when the authorization flow completes for the first
+    # time.
+    if os.path.exists(token_file):
+        creds = Credentials.from_authorized_user_file(token_file, scopes)
+    # If there are no (valid) credentials available, let the user log in.
+    if not creds or not creds.valid:
+        if creds and creds.expired and creds.refresh_token:
+            creds.refresh(Request())
+        else:
+            # https://developers.google.com/gmail/api/quickstart/python#authorize_credentials_for_a_desktop_application # noqa
+            flow = InstalledAppFlow.from_client_secrets_file(
+                client_secrets_file, scopes
+            )
+            creds = flow.run_local_server(port=0)
+        # Save the credentials for the next run
+        with open(token_file, "w") as token:
+            token.write(creds.to_json())
+    return creds
+
+
+def build_resource_service(
+    credentials: Optional[Credentials] = None,
+    service_name: str = "gmail",
+    service_version: str = "v1",
+) -> Resource:
+    """Build a Gmail service."""
+    credentials = credentials or get_gmail_credentials()
+    builder = import_googleapiclient_resource_builder()
+    return builder(service_name, service_version, credentials=credentials)
+
+
+def clean_email_body(body: str) -> str:
+    """Clean email body."""
+    try:
+        from bs4 import BeautifulSoup
+
+        try:
+            soup = BeautifulSoup(str(body), "html.parser")
+            body = soup.get_text()
+            return str(body)
+        except Exception as e:
+            logger.error(e)
+            return str(body)
+    except ImportError:
+        logger.warning("BeautifulSoup not installed. Skipping cleaning.")
+        return str(body)
diff --git a/llm/Lib/site-packages/langchain_community/tools/golden_query/__init__.py b/llm/Lib/site-packages/langchain_community/tools/golden_query/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f2f2bc5339b521336a22a6c368c29f1487857aa5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/golden_query/__init__.py
@@ -0,0 +1,8 @@
+"""Golden API toolkit."""
+
+
+from langchain_community.tools.golden_query.tool import GoldenQueryRun
+
+__all__ = [
+    "GoldenQueryRun",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/golden_query/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/golden_query/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..84e714d8263d19afb9535f14e7da88a708db78da
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/golden_query/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/golden_query/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/golden_query/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..250eb93590f885b80adb6bd8b924ad3964c931f1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/golden_query/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/golden_query/tool.py b/llm/Lib/site-packages/langchain_community/tools/golden_query/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..7cc5c72234cc35e8a15adbe7232b12c0b3cdd159
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/golden_query/tool.py
@@ -0,0 +1,34 @@
+"""Tool for the Golden API."""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.golden_query import GoldenQueryAPIWrapper
+
+
+class GoldenQueryRun(BaseTool):
+    """Tool that adds the capability to query using the Golden API and get back JSON."""
+
+    name: str = "golden_query"
+    description: str = (
+        "A wrapper around Golden Query API."
+        " Useful for getting entities that match"
+        " a natural language query from Golden's Knowledge Base."
+        "\nExample queries:"
+        "\n- companies in nanotech"
+        "\n- list of cloud providers starting in 2019"
+        "\nInput should be the natural language query."
+        "\nOutput is a paginated list of results or an error object"
+        " in JSON format."
+    )
+    api_wrapper: GoldenQueryAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Golden tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_cloud/__init__.py b/llm/Lib/site-packages/langchain_community/tools/google_cloud/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ec7deb895156f9feb426e3e379412301a30bd563
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_cloud/__init__.py
@@ -0,0 +1,7 @@
+"""Google Cloud Tools."""
+
+from langchain_community.tools.google_cloud.texttospeech import (
+    GoogleCloudTextToSpeechTool,
+)
+
+__all__ = ["GoogleCloudTextToSpeechTool"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_cloud/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_cloud/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b6efcac52c3a5e271d68c68ca876f720124ad2d8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_cloud/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_cloud/__pycache__/texttospeech.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_cloud/__pycache__/texttospeech.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8ddc304ace6b16677c7a68abb319b23bb7841680
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_cloud/__pycache__/texttospeech.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_cloud/texttospeech.py b/llm/Lib/site-packages/langchain_community/tools/google_cloud/texttospeech.py
new file mode 100644
index 0000000000000000000000000000000000000000..cccc3f5cc4a4e23550e8124ebc093042c6af859d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_cloud/texttospeech.py
@@ -0,0 +1,97 @@
+from __future__ import annotations
+
+import tempfile
+from typing import TYPE_CHECKING, Any, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.vertexai import get_client_info
+
+if TYPE_CHECKING:
+    from google.cloud import texttospeech
+
+
+def _import_google_cloud_texttospeech() -> Any:
+    try:
+        from google.cloud import texttospeech
+    except ImportError as e:
+        raise ImportError(
+            "Cannot import google.cloud.texttospeech, please install "
+            "`pip install google-cloud-texttospeech`."
+        ) from e
+    return texttospeech
+
+
+def _encoding_file_extension_map(encoding: texttospeech.AudioEncoding) -> Optional[str]:
+    texttospeech = _import_google_cloud_texttospeech()
+
+    ENCODING_FILE_EXTENSION_MAP = {
+        texttospeech.AudioEncoding.LINEAR16: ".wav",
+        texttospeech.AudioEncoding.MP3: ".mp3",
+        texttospeech.AudioEncoding.OGG_OPUS: ".ogg",
+        texttospeech.AudioEncoding.MULAW: ".wav",
+        texttospeech.AudioEncoding.ALAW: ".wav",
+    }
+    return ENCODING_FILE_EXTENSION_MAP.get(encoding)
+
+
+@deprecated(
+    since="0.0.33",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.TextToSpeechTool",
+)
+class GoogleCloudTextToSpeechTool(BaseTool):
+    """Tool that queries the Google Cloud Text to Speech API.
+
+    In order to set this up, follow instructions at:
+    https://cloud.google.com/text-to-speech/docs/before-you-begin
+    """
+
+    name: str = "google_cloud_texttospeech"
+    description: str = (
+        "A wrapper around Google Cloud Text-to-Speech. "
+        "Useful for when you need to synthesize audio from text. "
+        "It supports multiple languages, including English, German, Polish, "
+        "Spanish, Italian, French, Portuguese, and Hindi. "
+    )
+
+    _client: Any
+
+    def __init__(self, **kwargs: Any) -> None:
+        """Initializes private fields."""
+        texttospeech = _import_google_cloud_texttospeech()
+
+        super().__init__(**kwargs)
+
+        self._client = texttospeech.TextToSpeechClient(
+            client_info=get_client_info(module="text-to-speech")
+        )
+
+    def _run(
+        self,
+        input_text: str,
+        language_code: str = "en-US",
+        ssml_gender: Optional[texttospeech.SsmlVoiceGender] = None,
+        audio_encoding: Optional[texttospeech.AudioEncoding] = None,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        texttospeech = _import_google_cloud_texttospeech()
+        ssml_gender = ssml_gender or texttospeech.SsmlVoiceGender.NEUTRAL
+        audio_encoding = audio_encoding or texttospeech.AudioEncoding.MP3
+
+        response = self._client.synthesize_speech(
+            input=texttospeech.SynthesisInput(text=input_text),
+            voice=texttospeech.VoiceSelectionParams(
+                language_code=language_code, ssml_gender=ssml_gender
+            ),
+            audio_config=texttospeech.AudioConfig(audio_encoding=audio_encoding),
+        )
+
+        suffix = _encoding_file_extension_map(audio_encoding)
+
+        with tempfile.NamedTemporaryFile(mode="bx", suffix=suffix, delete=False) as f:
+            f.write(response.audio_content)
+        return f.name
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_finance/__init__.py b/llm/Lib/site-packages/langchain_community/tools/google_finance/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc06ae46d56efb0a711f24f4d0537aeea41057c7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_finance/__init__.py
@@ -0,0 +1,5 @@
+"""Google Finance API Toolkit."""
+
+from langchain_community.tools.google_finance.tool import GoogleFinanceQueryRun
+
+__all__ = ["GoogleFinanceQueryRun"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_finance/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_finance/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2489bd830f4ef13c5ee6b46f1879a2479f2ea811
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_finance/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_finance/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_finance/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..300b762350f2e8e9ceb8aa596d48cb8a87332697
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_finance/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_finance/tool.py b/llm/Lib/site-packages/langchain_community/tools/google_finance/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..82eb82de318b6a739fcd6a7b6b5d23df6528dc92
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_finance/tool.py
@@ -0,0 +1,29 @@
+"""Tool for the Google Finance"""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.google_finance import GoogleFinanceAPIWrapper
+
+
+class GoogleFinanceQueryRun(BaseTool):
+    """Tool that queries the Google Finance API."""
+
+    name: str = "google_finance"
+    description: str = (
+        "A wrapper around Google Finance Search. "
+        "Useful for when you need to get information about"
+        "google search Finance from Google Finance"
+        "Input should be a search query."
+    )
+    api_wrapper: GoogleFinanceAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_jobs/__init__.py b/llm/Lib/site-packages/langchain_community/tools/google_jobs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f23e0eecffb4021032f5829f28886b54b2d2b97b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_jobs/__init__.py
@@ -0,0 +1,5 @@
+"""Google Jobs API Toolkit."""
+
+from langchain_community.tools.google_jobs.tool import GoogleJobsQueryRun
+
+__all__ = ["GoogleJobsQueryRun"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_jobs/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_jobs/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8d04b167c0c082a014f4c15e183768512985e441
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_jobs/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_jobs/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_jobs/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e3e79154a83c04a824423c5b808fd2b563b40cf2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_jobs/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_jobs/tool.py b/llm/Lib/site-packages/langchain_community/tools/google_jobs/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a83b3043d9f3a43f850fa3e7b708261aeb54657
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_jobs/tool.py
@@ -0,0 +1,29 @@
+"""Tool for the Google Trends"""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.google_jobs import GoogleJobsAPIWrapper
+
+
+class GoogleJobsQueryRun(BaseTool):
+    """Tool that queries the Google Jobs API."""
+
+    name: str = "google_jobs"
+    description: str = (
+        "A wrapper around Google Jobs Search. "
+        "Useful for when you need to get information about"
+        "google search Jobs from Google Jobs"
+        "Input should be a search query."
+    )
+    api_wrapper: GoogleJobsAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_lens/__init__.py b/llm/Lib/site-packages/langchain_community/tools/google_lens/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..15a0c179379ccdfb37b69957a6ea60ea50716c27
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_lens/__init__.py
@@ -0,0 +1,5 @@
+"""Google Lens API Toolkit."""
+
+from langchain_community.tools.google_lens.tool import GoogleLensQueryRun
+
+__all__ = ["GoogleLensQueryRun"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_lens/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_lens/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f4a103278b53b947e9848f2c2a501731ea4e545e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_lens/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_lens/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_lens/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0fd235f974ea19986d3dcde1bcc698c4edf1c2fa
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_lens/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_lens/tool.py b/llm/Lib/site-packages/langchain_community/tools/google_lens/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..38a4b847e211451c08796b90cc0575ca38370fb5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_lens/tool.py
@@ -0,0 +1,29 @@
+"""Tool for the Google Lens"""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.google_lens import GoogleLensAPIWrapper
+
+
+class GoogleLensQueryRun(BaseTool):
+    """Tool that queries the Google Lens API."""
+
+    name: str = "google_lens"
+    description: str = (
+        "A wrapper around Google Lens Search. "
+        "Useful for when you need to get information related"
+        "to an image from Google Lens"
+        "Input should be a url to an image."
+    )
+    api_wrapper: GoogleLensAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_places/__init__.py b/llm/Lib/site-packages/langchain_community/tools/google_places/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d3b948ea58fdbe59ae6dfa8959ca113fa543d8d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_places/__init__.py
@@ -0,0 +1,5 @@
+"""Google Places API Toolkit."""
+
+from langchain_community.tools.google_places.tool import GooglePlacesTool
+
+__all__ = ["GooglePlacesTool"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_places/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_places/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..48a845c3d04abb13ba3d6fb34660ffddb4ce78bf
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_places/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_places/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_places/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c9b72a00ec0e7b94dda2a5d34c9641ec997b6c0a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_places/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_places/tool.py b/llm/Lib/site-packages/langchain_community/tools/google_places/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..9e09744ab00cd5352f35a2bbf8d8db5cb1f6ab43
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_places/tool.py
@@ -0,0 +1,43 @@
+"""Tool for the Google search API."""
+
+from typing import Optional, Type
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.google_places_api import GooglePlacesAPIWrapper
+
+
+class GooglePlacesSchema(BaseModel):
+    """Input for GooglePlacesTool."""
+
+    query: str = Field(..., description="Query for google maps")
+
+
+@deprecated(
+    since="0.0.33",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.GooglePlacesTool",
+)
+class GooglePlacesTool(BaseTool):
+    """Tool that queries the Google places API."""
+
+    name: str = "google_places"
+    description: str = (
+        "A wrapper around Google Places. "
+        "Useful for when you need to validate or "
+        "discover addressed from ambiguous text. "
+        "Input should be a search query."
+    )
+    api_wrapper: GooglePlacesAPIWrapper = Field(default_factory=GooglePlacesAPIWrapper)
+    args_schema: Type[BaseModel] = GooglePlacesSchema
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_scholar/__init__.py b/llm/Lib/site-packages/langchain_community/tools/google_scholar/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b83e5dfc1ef8887d2578fe1c61475ee7158ceb04
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_scholar/__init__.py
@@ -0,0 +1,5 @@
+"""Google Scholar API Toolkit."""
+
+from langchain_community.tools.google_scholar.tool import GoogleScholarQueryRun
+
+__all__ = ["GoogleScholarQueryRun"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_scholar/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_scholar/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1d012426950e0c95c21f7569e0ccbf31f4de5896
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_scholar/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_scholar/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_scholar/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f77d4fdd798e7361efe4eef43e4d4eda72caa907
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_scholar/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_scholar/tool.py b/llm/Lib/site-packages/langchain_community/tools/google_scholar/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..49f8769696ff0e3298b7e0d60973b23f99123f5c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_scholar/tool.py
@@ -0,0 +1,29 @@
+"""Tool for the Google Scholar"""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.google_scholar import GoogleScholarAPIWrapper
+
+
+class GoogleScholarQueryRun(BaseTool):
+    """Tool that queries the Google search API."""
+
+    name: str = "google_scholar"
+    description: str = (
+        "A wrapper around Google Scholar Search. "
+        "Useful for when you need to get information about"
+        "research papers from Google Scholar"
+        "Input should be a search query."
+    )
+    api_wrapper: GoogleScholarAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_search/__init__.py b/llm/Lib/site-packages/langchain_community/tools/google_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..08eccf0a3183903ad6342e5f575204ba1c91683f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_search/__init__.py
@@ -0,0 +1,8 @@
+"""Google Search API Toolkit."""
+
+from langchain_community.tools.google_search.tool import (
+    GoogleSearchResults,
+    GoogleSearchRun,
+)
+
+__all__ = ["GoogleSearchRun", "GoogleSearchResults"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e7fd8ecde85f626bead058ff50e7de467d94448f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7346c30782c686f504cd9f56ad812f35a2261b65
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_search/tool.py b/llm/Lib/site-packages/langchain_community/tools/google_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..5be24c0b0c689d282b79941e86cda228d9579740
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_search/tool.py
@@ -0,0 +1,60 @@
+"""Tool for the Google search API."""
+
+from typing import Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.google_search import GoogleSearchAPIWrapper
+
+
+@deprecated(
+    since="0.0.33",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.GoogleSearchRun",
+)
+class GoogleSearchRun(BaseTool):
+    """Tool that queries the Google search API."""
+
+    name: str = "google_search"
+    description: str = (
+        "A wrapper around Google Search. "
+        "Useful for when you need to answer questions about current events. "
+        "Input should be a search query."
+    )
+    api_wrapper: GoogleSearchAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.api_wrapper.run(query)
+
+
+@deprecated(
+    since="0.0.33",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.GoogleSearchResults",
+)
+class GoogleSearchResults(BaseTool):
+    """Tool that queries the Google Search API and gets back json."""
+
+    name: str = "google_search_results_json"
+    description: str = (
+        "A wrapper around Google Search. "
+        "Useful for when you need to answer questions about current events. "
+        "Input should be a search query. Output is a JSON array of the query results"
+    )
+    num_results: int = 4
+    api_wrapper: GoogleSearchAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return str(self.api_wrapper.results(query, self.num_results))
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_serper/__init__.py b/llm/Lib/site-packages/langchain_community/tools/google_serper/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..413481a645b3d95373fb60632ac5d2c8a720f52c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_serper/__init__.py
@@ -0,0 +1,9 @@
+from langchain_community.tools.google_serper.tool import (
+    GoogleSerperResults,
+    GoogleSerperRun,
+)
+
+"""Google Serper API Toolkit."""
+"""Tool for the Serer.dev Google Search API."""
+
+__all__ = ["GoogleSerperRun", "GoogleSerperResults"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_serper/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_serper/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ee37f75310c15f404af444f36ebc0ec31d1e06b4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_serper/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_serper/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_serper/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d27df8315c4d47639fe342dec790648d74b74e53
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_serper/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_serper/tool.py b/llm/Lib/site-packages/langchain_community/tools/google_serper/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..b94771a894f382cebd723405545c36e025b7ca39
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_serper/tool.py
@@ -0,0 +1,70 @@
+"""Tool for the Serper.dev Google Search API."""
+
+from typing import Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.google_serper import GoogleSerperAPIWrapper
+
+
+class GoogleSerperRun(BaseTool):
+    """Tool that queries the Serper.dev Google search API."""
+
+    name: str = "google_serper"
+    description: str = (
+        "A low-cost Google Search API."
+        "Useful for when you need to answer questions about current events."
+        "Input should be a search query."
+    )
+    api_wrapper: GoogleSerperAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return str(self.api_wrapper.run(query))
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+        return (await self.api_wrapper.arun(query)).__str__()
+
+
+class GoogleSerperResults(BaseTool):
+    """Tool that queries the Serper.dev Google Search API
+    and get back json."""
+
+    name: str = "google_serper_results_json"
+    description: str = (
+        "A low-cost Google Search API."
+        "Useful for when you need to answer questions about current events."
+        "Input should be a search query. Output is a JSON object of the query results"
+    )
+    api_wrapper: GoogleSerperAPIWrapper = Field(default_factory=GoogleSerperAPIWrapper)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return str(self.api_wrapper.results(query))
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+
+        return (await self.api_wrapper.aresults(query)).__str__()
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_trends/__init__.py b/llm/Lib/site-packages/langchain_community/tools/google_trends/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca3d58fc5959b32063c4ebde51b306970046512f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_trends/__init__.py
@@ -0,0 +1,5 @@
+"""Google Trends API Toolkit."""
+
+from langchain_community.tools.google_trends.tool import GoogleTrendsQueryRun
+
+__all__ = ["GoogleTrendsQueryRun"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_trends/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_trends/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aaf7f7740bde647dcd69217691b6332e5bbfb91c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_trends/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_trends/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/google_trends/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6cc8bb2aa66f2ff474bae1bda2407586634412de
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/google_trends/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/google_trends/tool.py b/llm/Lib/site-packages/langchain_community/tools/google_trends/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b2b5dd8bfbd184201477b733c716a3abe9f305e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/google_trends/tool.py
@@ -0,0 +1,29 @@
+"""Tool for the Google Trends"""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.google_trends import GoogleTrendsAPIWrapper
+
+
+class GoogleTrendsQueryRun(BaseTool):
+    """Tool that queries the Google trends API."""
+
+    name: str = "google_trends"
+    description: str = (
+        "A wrapper around Google Trends Search. "
+        "Useful for when you need to get information about"
+        "google search trends from Google Trends"
+        "Input should be a search query."
+    )
+    api_wrapper: GoogleTrendsAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/graphql/__init__.py b/llm/Lib/site-packages/langchain_community/tools/graphql/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7e9a84c3772f4749d290bf07d8c7d49ddc57cdcd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/graphql/__init__.py
@@ -0,0 +1 @@
+"""Tools for interacting with a GraphQL API"""
diff --git a/llm/Lib/site-packages/langchain_community/tools/graphql/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/graphql/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3309cfbf4e5d7450c5923de369c14c0f39398130
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/graphql/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/graphql/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/graphql/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c0e65da27a4f06f504234a1b790aaa13ea1f886a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/graphql/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/graphql/tool.py b/llm/Lib/site-packages/langchain_community/tools/graphql/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..a794334cbdbdc8a5cfac9f7f0ece24d9893d18d4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/graphql/tool.py
@@ -0,0 +1,36 @@
+import json
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.graphql import GraphQLAPIWrapper
+
+
+class BaseGraphQLTool(BaseTool):
+    """Base tool for querying a GraphQL API."""
+
+    graphql_wrapper: GraphQLAPIWrapper
+
+    name: str = "query_graphql"
+    description: str = """\
+    Input to this tool is a detailed and correct GraphQL query, output is a result from the API.
+    If the query is not correct, an error message will be returned.
+    If an error is returned with 'Bad request' in it, rewrite the query and try again.
+    If an error is returned with 'Unauthorized' in it, do not try again, but tell the user to change their authentication.
+
+    Example Input: query {{ allUsers {{ id, name, email }} }}\
+    """  # noqa: E501
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def _run(
+        self,
+        tool_input: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        result = self.graphql_wrapper.run(tool_input)
+        return json.dumps(result, indent=2)
diff --git a/llm/Lib/site-packages/langchain_community/tools/human/__init__.py b/llm/Lib/site-packages/langchain_community/tools/human/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..084487d0f9b3435dd8436b0d0551d678c9781965
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/human/__init__.py
@@ -0,0 +1,5 @@
+"""Tool for asking for human input."""
+
+from langchain_community.tools.human.tool import HumanInputRun
+
+__all__ = ["HumanInputRun"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/human/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/human/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..776e2e5cf0e962b0901c7086e5c6b8484613a075
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/human/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/human/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/human/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..660da0cfcaec43e3665773019dcbc8329364209a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/human/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/human/tool.py b/llm/Lib/site-packages/langchain_community/tools/human/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..e4987e44fa6c3483e58ed0cb045a42dc7b37179d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/human/tool.py
@@ -0,0 +1,34 @@
+"""Tool for asking human input."""
+
+from typing import Callable, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+
+def _print_func(text: str) -> None:
+    print("\n")  # noqa: T201
+    print(text)  # noqa: T201
+
+
+class HumanInputRun(BaseTool):
+    """Tool that asks user for input."""
+
+    name: str = "human"
+    description: str = (
+        "You can ask a human for guidance when you think you "
+        "got stuck or you are not sure what to do next. "
+        "The input should be a question for the human."
+    )
+    prompt_func: Callable[[str], None] = Field(default_factory=lambda: _print_func)
+    input_func: Callable = Field(default_factory=lambda: input)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Human input tool."""
+        self.prompt_func(query)
+        return self.input_func()
diff --git a/llm/Lib/site-packages/langchain_community/tools/ifttt.py b/llm/Lib/site-packages/langchain_community/tools/ifttt.py
new file mode 100644
index 0000000000000000000000000000000000000000..5df673061dceaf805deadf8958df217ef9836be4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/ifttt.py
@@ -0,0 +1,60 @@
+"""From https://github.com/SidU/teams-langchain-js/wiki/Connecting-IFTTT-Services.
+
+# Creating a webhook
+- Go to https://ifttt.com/create
+
+# Configuring the "If This"
+- Click on the "If This" button in the IFTTT interface.
+- Search for "Webhooks" in the search bar.
+- Choose the first option for "Receive a web request with a JSON payload."
+- Choose an Event Name that is specific to the service you plan to connect to.
+This will make it easier for you to manage the webhook URL.
+For example, if you're connecting to Spotify, you could use "Spotify" as your
+Event Name.
+- Click the "Create Trigger" button to save your settings and create your webhook.
+
+# Configuring the "Then That"
+- Tap on the "Then That" button in the IFTTT interface.
+- Search for the service you want to connect, such as Spotify.
+- Choose an action from the service, such as "Add track to a playlist".
+- Configure the action by specifying the necessary details, such as the playlist name,
+e.g., "Songs from AI".
+- Reference the JSON Payload received by the Webhook in your action. For the Spotify
+scenario, choose "{{JsonPayload}}" as your search query.
+- Tap the "Create Action" button to save your action settings.
+- Once you have finished configuring your action, click the "Finish" button to
+complete the setup.
+- Congratulations! You have successfully connected the Webhook to the desired
+service, and you're ready to start receiving data and triggering actions 🎉
+
+# Finishing up
+- To get your webhook URL go to https://ifttt.com/maker_webhooks/settings
+- Copy the IFTTT key value from there. The URL is of the form
+https://maker.ifttt.com/use/YOUR_IFTTT_KEY. Grab the YOUR_IFTTT_KEY value.
+"""
+from typing import Optional
+
+import requests
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+
+class IFTTTWebhook(BaseTool):
+    """IFTTT Webhook.
+
+    Args:
+        name: name of the tool
+        description: description of the tool
+        url: url to hit with the json event.
+    """
+
+    url: str
+
+    def _run(
+        self,
+        tool_input: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        body = {"this": tool_input}
+        response = requests.post(self.url, data=body)
+        return response.text
diff --git a/llm/Lib/site-packages/langchain_community/tools/interaction/__init__.py b/llm/Lib/site-packages/langchain_community/tools/interaction/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..be3393362d8bc39d0f5d56dffd757fb51ae6ace2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/interaction/__init__.py
@@ -0,0 +1 @@
+"""Tools for interacting with the user."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/interaction/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/interaction/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..14d8e7614cc1d5a53e4131b469e750475cc22c39
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/interaction/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/interaction/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/interaction/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..45d88deabf355018e96ee1ea420c1d8abdf92ee3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/interaction/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/interaction/tool.py b/llm/Lib/site-packages/langchain_community/tools/interaction/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..5ec6ceef5018697f43bc53f41a429157c91862d1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/interaction/tool.py
@@ -0,0 +1,17 @@
+"""Tools for interacting with the user."""
+
+
+import warnings
+from typing import Any
+
+from langchain_community.tools.human.tool import HumanInputRun
+
+
+def StdInInquireTool(*args: Any, **kwargs: Any) -> HumanInputRun:
+    """Tool for asking the user for input."""
+    warnings.warn(
+        "StdInInquireTool will be deprecated in the future. "
+        "Please use HumanInputRun instead.",
+        DeprecationWarning,
+    )
+    return HumanInputRun(*args, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/tools/jira/__init__.py b/llm/Lib/site-packages/langchain_community/tools/jira/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..06cd8cbcd9e403192fd52f143b06799028289ac9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/jira/__init__.py
@@ -0,0 +1 @@
+"""Jira Tool."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/jira/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/jira/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6e34dee9e14ea39d592327f849c2d0bb16415a34
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/jira/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/jira/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/jira/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..084fefdf61ece38ebb00c962161a9a94cc1690ba
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/jira/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/jira/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/jira/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b80ea240cc2498c4a87a4a2210daf3da7e20ac64
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/jira/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/jira/prompt.py b/llm/Lib/site-packages/langchain_community/tools/jira/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..08f06023040f66d47dec0502cb029a0e6ffcf16e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/jira/prompt.py
@@ -0,0 +1,42 @@
+# flake8: noqa
+JIRA_ISSUE_CREATE_PROMPT = """
+    This tool is a wrapper around atlassian-python-api's Jira issue_create API, useful when you need to create a Jira issue. 
+    The input to this tool is a dictionary specifying the fields of the Jira issue, and will be passed into atlassian-python-api's Jira `issue_create` function.
+    For example, to create a low priority task called "test issue" with description "test description", you would pass in the following dictionary: 
+    {{"summary": "test issue", "description": "test description", "issuetype": {{"name": "Task"}}, "priority": {{"name": "Low"}}}}
+    """
+
+JIRA_GET_ALL_PROJECTS_PROMPT = """
+    This tool is a wrapper around atlassian-python-api's Jira project API, 
+    useful when you need to fetch all the projects the user has access to, find out how many projects there are, or as an intermediary step that involv searching by projects. 
+    there is no input to this tool.
+    """
+
+JIRA_JQL_PROMPT = """
+    This tool is a wrapper around atlassian-python-api's Jira jql API, useful when you need to search for Jira issues.
+    The input to this tool is a JQL query string, and will be passed into atlassian-python-api's Jira `jql` function,
+    For example, to find all the issues in project "Test" assigned to the me, you would pass in the following string:
+    project = Test AND assignee = currentUser()
+    or to find issues with summaries that contain the word "test", you would pass in the following string:
+    summary ~ 'test'
+    """
+
+JIRA_CATCH_ALL_PROMPT = """
+    This tool is a wrapper around atlassian-python-api's Jira API.
+    There are other dedicated tools for fetching all projects, and creating and searching for issues, 
+    use this tool if you need to perform any other actions allowed by the atlassian-python-api Jira API.
+    The input to this tool is a dictionary specifying a function from atlassian-python-api's Jira API, 
+    as well as a list of arguments and dictionary of keyword arguments to pass into the function.
+    For example, to get all the users in a group, while increasing the max number of results to 100, you would
+    pass in the following dictionary: {{"function": "get_all_users_from_group", "args": ["group"], "kwargs": {{"limit":100}} }}
+    or to find out how many projects are in the Jira instance, you would pass in the following string:
+    {{"function": "projects"}}
+    For more information on the Jira API, refer to https://atlassian-python-api.readthedocs.io/jira.html
+    """
+
+JIRA_CONFLUENCE_PAGE_CREATE_PROMPT = """This tool is a wrapper around atlassian-python-api's Confluence 
+atlassian-python-api API, useful when you need to create a Confluence page. The input to this tool is a dictionary 
+specifying the fields of the Confluence page, and will be passed into atlassian-python-api's Confluence `create_page` 
+function. For example, to create a page in the DEMO space titled "This is the title" with body "This is the body. You can use 
+<strong>HTML tags</strong>!", you would pass in the following dictionary: {{"space": "DEMO", "title":"This is the 
+title","body":"This is the body. You can use <strong>HTML tags</strong>!"}} """
diff --git a/llm/Lib/site-packages/langchain_community/tools/jira/tool.py b/llm/Lib/site-packages/langchain_community/tools/jira/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc57b13dc205b8fd36141b2313b3b07cb66c0172
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/jira/tool.py
@@ -0,0 +1,44 @@
+"""
+This tool allows agents to interact with the atlassian-python-api library
+and operate on a Jira instance. For more information on the
+atlassian-python-api library, see https://atlassian-python-api.readthedocs.io/jira.html
+
+To use this tool, you must first set as environment variables:
+    JIRA_API_TOKEN
+    JIRA_USERNAME
+    JIRA_INSTANCE_URL
+
+Below is a sample script that uses the Jira tool:
+
+```python
+from langchain_community.agent_toolkits.jira.toolkit import JiraToolkit
+from langchain_community.utilities.jira import JiraAPIWrapper
+
+jira = JiraAPIWrapper()
+toolkit = JiraToolkit.from_jira_api_wrapper(jira)
+```
+"""
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.jira import JiraAPIWrapper
+
+
+class JiraAction(BaseTool):
+    """Tool that queries the Atlassian Jira API."""
+
+    api_wrapper: JiraAPIWrapper = Field(default_factory=JiraAPIWrapper)
+    mode: str
+    name: str = ""
+    description: str = ""
+
+    def _run(
+        self,
+        instructions: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Atlassian Jira API to run an operation."""
+        return self.api_wrapper.run(self.mode, instructions)
diff --git a/llm/Lib/site-packages/langchain_community/tools/json/__init__.py b/llm/Lib/site-packages/langchain_community/tools/json/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d13302f008a09fa9747da055d4baeec957651ef4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/json/__init__.py
@@ -0,0 +1 @@
+"""Tools for interacting with a JSON file."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/json/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/json/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e8e3ae78be9f0af747b6559b9c691995cd9fa49
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/json/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/json/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/json/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..725973a60601c385b76febc90d271439104e3581
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/json/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/json/tool.py b/llm/Lib/site-packages/langchain_community/tools/json/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..af392c96cef8a25413ab680bbd912613c5890f4a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/json/tool.py
@@ -0,0 +1,133 @@
+# flake8: noqa
+"""Tools for working with JSON specs."""
+from __future__ import annotations
+
+import json
+import re
+from pathlib import Path
+from typing import Dict, List, Optional, Union
+
+from langchain_core.pydantic_v1 import BaseModel
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.tools import BaseTool
+
+
+def _parse_input(text: str) -> List[Union[str, int]]:
+    """Parse input of the form data["key1"][0]["key2"] into a list of keys."""
+    _res = re.findall(r"\[.*?]", text)
+    # strip the brackets and quotes, convert to int if possible
+    res = [i[1:-1].replace('"', "").replace("'", "") for i in _res]
+    res = [int(i) if i.isdigit() else i for i in res]
+    return res
+
+
+class JsonSpec(BaseModel):
+    """Base class for JSON spec."""
+
+    dict_: Dict
+    max_value_length: int = 200
+
+    @classmethod
+    def from_file(cls, path: Path) -> JsonSpec:
+        """Create a JsonSpec from a file."""
+        if not path.exists():
+            raise FileNotFoundError(f"File not found: {path}")
+        dict_ = json.loads(path.read_text())
+        return cls(dict_=dict_)
+
+    def keys(self, text: str) -> str:
+        """Return the keys of the dict at the given path.
+
+        Args:
+            text: Python representation of the path to the dict (e.g. data["key1"][0]["key2"]).
+        """
+        try:
+            items = _parse_input(text)
+            val = self.dict_
+            for i in items:
+                if i:
+                    val = val[i]
+            if not isinstance(val, dict):
+                raise ValueError(
+                    f"Value at path `{text}` is not a dict, get the value directly."
+                )
+            return str(list(val.keys()))
+        except Exception as e:
+            return repr(e)
+
+    def value(self, text: str) -> str:
+        """Return the value of the dict at the given path.
+
+        Args:
+            text: Python representation of the path to the dict (e.g. data["key1"][0]["key2"]).
+        """
+        try:
+            items = _parse_input(text)
+            val = self.dict_
+            for i in items:
+                val = val[i]
+
+            if isinstance(val, dict) and len(str(val)) > self.max_value_length:
+                return "Value is a large dictionary, should explore its keys directly"
+            str_val = str(val)
+            if len(str_val) > self.max_value_length:
+                str_val = str_val[: self.max_value_length] + "..."
+            return str_val
+        except Exception as e:
+            return repr(e)
+
+
+class JsonListKeysTool(BaseTool):
+    """Tool for listing keys in a JSON spec."""
+
+    name: str = "json_spec_list_keys"
+    description: str = """
+    Can be used to list all keys at a given path. 
+    Before calling this you should be SURE that the path to this exists.
+    The input is a text representation of the path to the dict in Python syntax (e.g. data["key1"][0]["key2"]).
+    """
+    spec: JsonSpec
+
+    def _run(
+        self,
+        tool_input: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        return self.spec.keys(tool_input)
+
+    async def _arun(
+        self,
+        tool_input: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        return self._run(tool_input)
+
+
+class JsonGetValueTool(BaseTool):
+    """Tool for getting a value in a JSON spec."""
+
+    name: str = "json_spec_get_value"
+    description: str = """
+    Can be used to see value in string format at a given path.
+    Before calling this you should be SURE that the path to this exists.
+    The input is a text representation of the path to the dict in Python syntax (e.g. data["key1"][0]["key2"]).
+    """
+    spec: JsonSpec
+
+    def _run(
+        self,
+        tool_input: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        return self.spec.value(tool_input)
+
+    async def _arun(
+        self,
+        tool_input: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        return self._run(tool_input)
diff --git a/llm/Lib/site-packages/langchain_community/tools/memorize/__init__.py b/llm/Lib/site-packages/langchain_community/tools/memorize/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..76a84406aced35decd158983b9423aa94958d371
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/memorize/__init__.py
@@ -0,0 +1,5 @@
+"""Unsupervised learning based memorization."""
+
+from langchain_community.tools.memorize.tool import Memorize
+
+__all__ = ["Memorize"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/memorize/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/memorize/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2952f36d6f24b1874a50507e9fc333c8ebeec49f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/memorize/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/memorize/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/memorize/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b3b6c937cc13512649cbe7e3805b0dec94bf58da
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/memorize/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/memorize/tool.py b/llm/Lib/site-packages/langchain_community/tools/memorize/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..0b6650c5525eaabea12f058d950c85a7c5b7da30
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/memorize/tool.py
@@ -0,0 +1,62 @@
+from abc import abstractmethod
+from typing import Any, Optional, Protocol, Sequence, runtime_checkable
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.llms.gradient_ai import TrainResult
+
+
+@runtime_checkable
+class TrainableLLM(Protocol):
+    """Protocol for trainable language models."""
+
+    @abstractmethod
+    def train_unsupervised(
+        self,
+        inputs: Sequence[str],
+        **kwargs: Any,
+    ) -> TrainResult:
+        ...
+
+    @abstractmethod
+    async def atrain_unsupervised(
+        self,
+        inputs: Sequence[str],
+        **kwargs: Any,
+    ) -> TrainResult:
+        ...
+
+
+class Memorize(BaseTool):
+    """Tool that trains a language model."""
+
+    name: str = "memorize"
+    description: str = (
+        "Useful whenever you observed novel information "
+        "from previous conversation history, "
+        "i.e., another tool's action outputs or human comments. "
+        "The action input should include observed information in detail, "
+        "then the tool will fine-tune yourself to remember it."
+    )
+    llm: TrainableLLM = Field()
+
+    def _run(
+        self,
+        information_to_learn: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        train_result = self.llm.train_unsupervised((information_to_learn,))
+        return f"Train complete. Loss: {train_result['loss']}"
+
+    async def _arun(
+        self,
+        information_to_learn: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        train_result = await self.llm.atrain_unsupervised((information_to_learn,))
+        return f"Train complete. Loss: {train_result['loss']}"
diff --git a/llm/Lib/site-packages/langchain_community/tools/merriam_webster/__init__.py b/llm/Lib/site-packages/langchain_community/tools/merriam_webster/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..73390d549807ce23c7477c265bcfb73ab5e21ef6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/merriam_webster/__init__.py
@@ -0,0 +1 @@
+"""Merriam-Webster API toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/merriam_webster/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/merriam_webster/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5dd2370e68be4582b8b0112ffb29e777553e56f2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/merriam_webster/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/merriam_webster/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/merriam_webster/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..088e06d736b350a7b0725fe7cc3a87537604e707
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/merriam_webster/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/merriam_webster/tool.py b/llm/Lib/site-packages/langchain_community/tools/merriam_webster/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..9cf4e9f21ca69ffdbf71f058bc4df7ea35d13675
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/merriam_webster/tool.py
@@ -0,0 +1,28 @@
+"""Tool for the Merriam-Webster API."""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.merriam_webster import MerriamWebsterAPIWrapper
+
+
+class MerriamWebsterQueryRun(BaseTool):
+    """Tool that searches the Merriam-Webster API."""
+
+    name: str = "merriam_webster"
+    description: str = (
+        "A wrapper around Merriam-Webster. "
+        "Useful for when you need to get the definition of a word."
+        "Input should be the word you want the definition of."
+    )
+    api_wrapper: MerriamWebsterAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Merriam-Webster tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/metaphor_search/__init__.py b/llm/Lib/site-packages/langchain_community/tools/metaphor_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..246f25a1291bc640645dc6284950eceaed971f42
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/metaphor_search/__init__.py
@@ -0,0 +1,5 @@
+"""Metaphor Search API toolkit."""
+
+from langchain_community.tools.metaphor_search.tool import MetaphorSearchResults
+
+__all__ = ["MetaphorSearchResults"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/metaphor_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/metaphor_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5dbb164e055d54b4a09c5027d89fe85146c78847
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/metaphor_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/metaphor_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/metaphor_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..923c7ddecd561363b4b25e92fc46f6550923d7e7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/metaphor_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/metaphor_search/tool.py b/llm/Lib/site-packages/langchain_community/tools/metaphor_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..667c711ee4027e37745da0c19c6977d890b2ce5a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/metaphor_search/tool.py
@@ -0,0 +1,87 @@
+"""Tool for the Metaphor search API."""
+
+from typing import Dict, List, Optional, Union
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.metaphor_search import MetaphorSearchAPIWrapper
+
+
+@deprecated(
+    since="0.0.15",
+    removal="0.2.0",
+    alternative="langchain_exa.ExaSearchResults",
+)
+class MetaphorSearchResults(BaseTool):
+    """Tool that queries the Metaphor Search API and gets back json."""
+
+    name: str = "metaphor_search_results_json"
+    description: str = (
+        "A wrapper around Metaphor Search. "
+        "Input should be a Metaphor-optimized query. "
+        "Output is a JSON array of the query results"
+    )
+    api_wrapper: MetaphorSearchAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        num_results: int,
+        include_domains: Optional[List[str]] = None,
+        exclude_domains: Optional[List[str]] = None,
+        start_crawl_date: Optional[str] = None,
+        end_crawl_date: Optional[str] = None,
+        start_published_date: Optional[str] = None,
+        end_published_date: Optional[str] = None,
+        use_autoprompt: Optional[bool] = None,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> Union[List[Dict], str]:
+        """Use the tool."""
+        try:
+            return self.api_wrapper.results(
+                query,
+                num_results,
+                include_domains,
+                exclude_domains,
+                start_crawl_date,
+                end_crawl_date,
+                start_published_date,
+                end_published_date,
+                use_autoprompt,
+            )
+        except Exception as e:
+            return repr(e)
+
+    async def _arun(
+        self,
+        query: str,
+        num_results: int,
+        include_domains: Optional[List[str]] = None,
+        exclude_domains: Optional[List[str]] = None,
+        start_crawl_date: Optional[str] = None,
+        end_crawl_date: Optional[str] = None,
+        start_published_date: Optional[str] = None,
+        end_published_date: Optional[str] = None,
+        use_autoprompt: Optional[bool] = None,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> Union[List[Dict], str]:
+        """Use the tool asynchronously."""
+        try:
+            return await self.api_wrapper.results_async(
+                query,
+                num_results,
+                include_domains,
+                exclude_domains,
+                start_crawl_date,
+                end_crawl_date,
+                start_published_date,
+                end_published_date,
+                use_autoprompt,
+            )
+        except Exception as e:
+            return repr(e)
diff --git a/llm/Lib/site-packages/langchain_community/tools/multion/__init__.py b/llm/Lib/site-packages/langchain_community/tools/multion/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..693ddcffc90381e276b68daa98a1275d42bb35ed
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/multion/__init__.py
@@ -0,0 +1,6 @@
+"""MutliOn Client API tools."""
+from langchain_community.tools.multion.close_session import MultionCloseSession
+from langchain_community.tools.multion.create_session import MultionCreateSession
+from langchain_community.tools.multion.update_session import MultionUpdateSession
+
+__all__ = ["MultionCreateSession", "MultionUpdateSession", "MultionCloseSession"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/multion/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/multion/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..45d7fb956e424b14844c67184371b4922de579bb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/multion/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/multion/__pycache__/close_session.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/multion/__pycache__/close_session.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4222d0ce495743d87efd389b7b7dbbe77cc4ac3f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/multion/__pycache__/close_session.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/multion/__pycache__/create_session.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/multion/__pycache__/create_session.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1b5391df0d99d6d21bc9af4b301be8006b94bf53
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/multion/__pycache__/create_session.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/multion/__pycache__/update_session.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/multion/__pycache__/update_session.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f84df8c8fa78feff3e377328b614a505db883cd7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/multion/__pycache__/update_session.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/multion/close_session.py b/llm/Lib/site-packages/langchain_community/tools/multion/close_session.py
new file mode 100644
index 0000000000000000000000000000000000000000..023c07539e0f12da3297c7424da182f1f7cfbb98
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/multion/close_session.py
@@ -0,0 +1,57 @@
+from typing import TYPE_CHECKING, Optional, Type
+
+from langchain_core.callbacks import (
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+if TYPE_CHECKING:
+    # This is for linting and IDE typehints
+    import multion
+else:
+    try:
+        # We do this so pydantic can resolve the types when instantiating
+        import multion
+    except ImportError:
+        pass
+
+
+class CloseSessionSchema(BaseModel):
+    """Input for UpdateSessionTool."""
+
+    sessionId: str = Field(
+        ...,
+        description="""The sessionId, received from one of the createSessions 
+        or updateSessions run before""",
+    )
+
+
+class MultionCloseSession(BaseTool):
+    """Tool that closes an existing Multion Browser Window with provided fields.
+
+    Attributes:
+        name: The name of the tool. Default: "close_multion_session"
+        description: The description of the tool.
+        args_schema: The schema for the tool's arguments. Default: UpdateSessionSchema
+    """
+
+    name: str = "close_multion_session"
+    description: str = """Use this tool to close \
+an existing corresponding Multion Browser Window with provided fields. \
+Note: SessionId must be received from previous Browser window creation."""
+    args_schema: Type[CloseSessionSchema] = CloseSessionSchema
+    sessionId: str = ""
+
+    def _run(
+        self,
+        sessionId: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> None:
+        try:
+            try:
+                multion.close_session(sessionId)
+            except Exception as e:
+                print(f"{e}, retrying...")  # noqa: T201
+        except Exception as e:
+            raise Exception(f"An error occurred: {e}")
diff --git a/llm/Lib/site-packages/langchain_community/tools/multion/create_session.py b/llm/Lib/site-packages/langchain_community/tools/multion/create_session.py
new file mode 100644
index 0000000000000000000000000000000000000000..de6983cb4bc2dd8c56631fbe5a92bfefa1191194
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/multion/create_session.py
@@ -0,0 +1,67 @@
+from typing import TYPE_CHECKING, Optional, Type
+
+from langchain_core.callbacks import (
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+if TYPE_CHECKING:
+    # This is for linting and IDE typehints
+    import multion
+else:
+    try:
+        # We do this so pydantic can resolve the types when instantiating
+        import multion
+    except ImportError:
+        pass
+
+
+class CreateSessionSchema(BaseModel):
+    """Input for CreateSessionTool."""
+
+    query: str = Field(
+        ...,
+        description="The query to run in multion agent.",
+    )
+    url: str = Field(
+        "https://www.google.com/",
+        description="""The Url to run the agent at. Note: accepts only secure \
+            links having https://""",
+    )
+
+
+class MultionCreateSession(BaseTool):
+    """Tool that creates a new Multion Browser Window with provided fields.
+
+    Attributes:
+        name: The name of the tool. Default: "create_multion_session"
+        description: The description of the tool.
+        args_schema: The schema for the tool's arguments.
+    """
+
+    name: str = "create_multion_session"
+    description: str = """
+        Create a new web browsing session based on a user's command or request. \
+        The command should include the full info required for the session. \
+        Also include an url (defaults to google.com if no better option) \
+        to start the session. \
+        Use this tool to create a new Browser Window with provided fields. \
+        Always the first step to run any activities that can be done using browser.
+        """
+    args_schema: Type[CreateSessionSchema] = CreateSessionSchema
+
+    def _run(
+        self,
+        query: str,
+        url: Optional[str] = "https://www.google.com/",
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> dict:
+        try:
+            response = multion.new_session({"input": query, "url": url})
+            return {
+                "sessionId": response["session_id"],
+                "Response": response["message"],
+            }
+        except Exception as e:
+            raise Exception(f"An error occurred: {e}")
diff --git a/llm/Lib/site-packages/langchain_community/tools/multion/update_session.py b/llm/Lib/site-packages/langchain_community/tools/multion/update_session.py
new file mode 100644
index 0000000000000000000000000000000000000000..10fe4c9fa6384cd4ec280bf0ad16bd6c90195a31
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/multion/update_session.py
@@ -0,0 +1,74 @@
+from typing import TYPE_CHECKING, Optional, Type
+
+from langchain_core.callbacks import (
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+if TYPE_CHECKING:
+    # This is for linting and IDE typehints
+    import multion
+else:
+    try:
+        # We do this so pydantic can resolve the types when instantiating
+        import multion
+    except ImportError:
+        pass
+
+
+class UpdateSessionSchema(BaseModel):
+    """Input for UpdateSessionTool."""
+
+    sessionId: str = Field(
+        ...,
+        description="""The sessionID, 
+        received from one of the createSessions run before""",
+    )
+    query: str = Field(
+        ...,
+        description="The query to run in multion agent.",
+    )
+    url: str = Field(
+        "https://www.google.com/",
+        description="""The Url to run the agent at. \
+        Note: accepts only secure links having https://""",
+    )
+
+
+class MultionUpdateSession(BaseTool):
+    """Tool that updates an existing Multion Browser Window with provided fields.
+
+    Attributes:
+        name: The name of the tool. Default: "update_multion_session"
+        description: The description of the tool.
+        args_schema: The schema for the tool's arguments. Default: UpdateSessionSchema
+    """
+
+    name: str = "update_multion_session"
+    description: str = """Use this tool to update \
+an existing corresponding Multion Browser Window with provided fields. \
+Note: sessionId must be received from previous Browser window creation."""
+    args_schema: Type[UpdateSessionSchema] = UpdateSessionSchema
+    sessionId: str = ""
+
+    def _run(
+        self,
+        sessionId: str,
+        query: str,
+        url: Optional[str] = "https://www.google.com/",
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> dict:
+        try:
+            try:
+                response = multion.update_session(
+                    sessionId, {"input": query, "url": url}
+                )
+                content = {"sessionId": sessionId, "Response": response["message"]}
+                self.sessionId = sessionId
+                return content
+            except Exception as e:
+                print(f"{e}, retrying...")  # noqa: T201
+                return {"error": f"{e}", "Response": "retrying..."}
+        except Exception as e:
+            raise Exception(f"An error occurred: {e}")
diff --git a/llm/Lib/site-packages/langchain_community/tools/nasa/__init__.py b/llm/Lib/site-packages/langchain_community/tools/nasa/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_community/tools/nasa/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/nasa/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..56f8cadfb950efc4e27ec13f6b84cfaa3382611c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/nasa/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/nasa/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/nasa/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dd7f78b1e6b989262573f973bffa84c7e93de008
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/nasa/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/nasa/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/nasa/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..167cef96432bf68fdd69e16082132721b19c2b05
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/nasa/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/nasa/prompt.py b/llm/Lib/site-packages/langchain_community/tools/nasa/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..4c7a3846a7e839c3e573f7ceeaec2439189cdf82
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/nasa/prompt.py
@@ -0,0 +1,82 @@
+# flake8: noqa
+NASA_SEARCH_PROMPT = """
+    This tool is a wrapper around NASA's search API, useful when you need to search through NASA's Image and Video Library. 
+    The input to this tool is a query specified by the user, and will be passed into NASA's `search` function.
+    
+    At least one parameter must be provided.
+
+    There are optional parameters that can be passed by the user based on their query
+    specifications. Each item in this list contains pound sign (#) separated values, the first value is the parameter name, 
+    the second value is the datatype and the third value is the description: {{
+
+        - q#string#Free text search terms to compare to all indexed metadata.
+        - center#string#NASA center which published the media.
+        - description#string#Terms to search for in “Description” fields.
+        - description_508#string#Terms to search for in “508 Description” fields.
+        - keywords #string#Terms to search for in “Keywords” fields. Separate multiple values with commas.
+        - location #string#Terms to search for in “Location” fields.
+        - media_type#string#Media types to restrict the search to. Available types: [“image”,“video”, “audio”]. Separate multiple values with commas.
+        - nasa_id #string#The media asset’s NASA ID.
+        - page#integer#Page number, starting at 1, of results to get.-
+        - page_size#integer#Number of results per page. Default: 100.
+        - photographer#string#The primary photographer’s name.
+        - secondary_creator#string#A secondary photographer/videographer’s name.
+        - title #string#Terms to search for in “Title” fields.
+        - year_start#string#The start year for results. Format: YYYY.
+        - year_end #string#The end year for results. Format: YYYY.
+
+    }}
+    
+    Below are several task descriptions along with their respective input examples.
+    Task: get the 2nd page of image and video content starting from the year 2002 to 2010
+    Example Input: {{"year_start":  "2002", "year_end":  "2010", "page": 2}}
+    
+    Task: get the image and video content of saturn photographed by John Appleseed
+    Example Input: {{"q": "saturn", "photographer": "John Appleseed"}}
+    
+    Task: search for Meteor Showers with description "Search Description" with media type image
+    Example Input: {{"q": "Meteor Shower", "description": "Search Description", "media_type": "image"}}
+    
+    Task: get the image and video content from year 2008 to 2010 from Kennedy Center
+    Example Input: {{"year_start":  "2002", "year_end":  "2010", "location": "Kennedy Center}}
+    """
+
+
+NASA_MANIFEST_PROMPT = """
+    This tool is a wrapper around NASA's media asset manifest API, useful when you need to retrieve a media 
+    asset's manifest. The input to this tool should include a string representing a NASA ID for a media asset that the user is trying to get the media asset manifest data for. The NASA ID will be passed as a string into NASA's `get_media_metadata_manifest` function.
+
+    The following list are some examples of NASA IDs for a media asset that you can use to better extract the NASA ID from the input string to the tool.
+    - GSFC_20171102_Archive_e000579
+    - Launch-Sound_Delta-PAM-Random-Commentary
+    - iss066m260341519_Expedition_66_Education_Inflight_with_Random_Lake_School_District_220203
+    - 6973610
+    - GRC-2020-CM-0167.4
+    - Expedition_55_Inflight_Japan_VIP_Event_May_31_2018_659970
+    - NASA 60th_SEAL_SLIVER_150DPI
+"""
+
+NASA_METADATA_PROMPT = """
+    This tool is a wrapper around NASA's media asset metadata location API, useful when you need to retrieve the media asset's metadata. The input to this tool should include a string representing a NASA ID for a media asset that the user is trying to get the media asset metadata location for. The NASA ID will be passed as a string into NASA's `get_media_metadata_manifest` function.
+
+    The following list are some examples of NASA IDs for a media asset that you can use to better extract the NASA ID from the input string to the tool.
+    - GSFC_20171102_Archive_e000579
+    - Launch-Sound_Delta-PAM-Random-Commentary
+    - iss066m260341519_Expedition_66_Education_Inflight_with_Random_Lake_School_District_220203
+    - 6973610
+    - GRC-2020-CM-0167.4
+    - Expedition_55_Inflight_Japan_VIP_Event_May_31_2018_659970
+    - NASA 60th_SEAL_SLIVER_150DPI
+"""
+
+NASA_CAPTIONS_PROMPT = """
+    This tool is a wrapper around NASA's video assests caption location API, useful when you need 
+    to retrieve the location of the captions of a specific video. The input to this tool should include a string representing a NASA ID for a video media asset that the user is trying to get the get the location of the captions for. The NASA ID will be passed as a string into NASA's `get_media_metadata_manifest` function.
+
+    The following list are some examples of NASA IDs for a video asset that you can use to better extract the NASA ID from the input string to the tool.
+    - 2017-08-09 - Video File RS-25 Engine Test
+    - 20180415-TESS_Social_Briefing
+    - 201_TakingWildOutOfWildfire
+    - 2022-H1_V_EuropaClipper-4
+    - 2022_0429_Recientemente
+"""
diff --git a/llm/Lib/site-packages/langchain_community/tools/nasa/tool.py b/llm/Lib/site-packages/langchain_community/tools/nasa/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..f5644661536e0395272d1f25c0f13ddb6a16e99a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/nasa/tool.py
@@ -0,0 +1,29 @@
+"""
+This tool allows agents to interact with the NASA API, specifically 
+the the NASA Image & Video Library and Exoplanet
+"""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.nasa import NasaAPIWrapper
+
+
+class NasaAction(BaseTool):
+    """Tool that queries the Atlassian Jira API."""
+
+    api_wrapper: NasaAPIWrapper = Field(default_factory=NasaAPIWrapper)
+    mode: str
+    name: str = ""
+    description: str = ""
+
+    def _run(
+        self,
+        instructions: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the NASA API to run an operation."""
+        return self.api_wrapper.run(self.mode, instructions)
diff --git a/llm/Lib/site-packages/langchain_community/tools/nuclia/__init__.py b/llm/Lib/site-packages/langchain_community/tools/nuclia/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ea2f3dc651c107ee422203df2d6e2c8ff9a8e5d1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/nuclia/__init__.py
@@ -0,0 +1,3 @@
+from langchain_community.tools.nuclia.tool import NucliaUnderstandingAPI
+
+__all__ = ["NucliaUnderstandingAPI"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/nuclia/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/nuclia/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1045a909ad412a12b935447795648db648816b49
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/nuclia/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/nuclia/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/nuclia/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5af74addf3af8da6d5e720f40cfaa5e95d1d44d6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/nuclia/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/nuclia/tool.py b/llm/Lib/site-packages/langchain_community/tools/nuclia/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f8bae73ff36eeea5bbcea0de77541f9c650a636
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/nuclia/tool.py
@@ -0,0 +1,237 @@
+"""Tool for the Nuclia Understanding API.
+
+Installation:
+
+```bash
+    pip install --upgrade protobuf
+    pip install nucliadb-protos
+```
+"""
+
+import asyncio
+import base64
+import logging
+import mimetypes
+import os
+from typing import Any, Dict, Optional, Type, Union
+
+import requests
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+logger = logging.getLogger(__name__)
+
+
+class NUASchema(BaseModel):
+    """Input for Nuclia Understanding API.
+
+    Attributes:
+        action: Action to perform. Either `push` or `pull`.
+        id: ID of the file to push or pull.
+        path: Path to the file to push (needed only for `push` action).
+        text: Text content to process (needed only for `push` action).
+    """
+
+    action: str = Field(
+        ...,
+        description="Action to perform. Either `push` or `pull`.",
+    )
+    id: str = Field(
+        ...,
+        description="ID of the file to push or pull.",
+    )
+    path: Optional[str] = Field(
+        ...,
+        description="Path to the file to push (needed only for `push` action).",
+    )
+    text: Optional[str] = Field(
+        ...,
+        description="Text content to process (needed only for `push` action).",
+    )
+
+
+class NucliaUnderstandingAPI(BaseTool):
+    """Tool to process files with the Nuclia Understanding API."""
+
+    name: str = "nuclia_understanding_api"
+    description: str = (
+        "A wrapper around Nuclia Understanding API endpoints. "
+        "Useful for when you need to extract text from any kind of files. "
+    )
+    args_schema: Type[BaseModel] = NUASchema
+    _results: Dict[str, Any] = {}
+    _config: Dict[str, Any] = {}
+
+    def __init__(self, enable_ml: bool = False) -> None:
+        zone = os.environ.get("NUCLIA_ZONE", "europe-1")
+        self._config["BACKEND"] = f"https://{zone}.nuclia.cloud/api/v1"
+        key = os.environ.get("NUCLIA_NUA_KEY")
+        if not key:
+            raise ValueError("NUCLIA_NUA_KEY environment variable not set")
+        else:
+            self._config["NUA_KEY"] = key
+        self._config["enable_ml"] = enable_ml
+        super().__init__()
+
+    def _run(
+        self,
+        action: str,
+        id: str,
+        path: Optional[str],
+        text: Optional[str],
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        if action == "push":
+            self._check_params(path, text)
+            if path:
+                return self._pushFile(id, path)
+            if text:
+                return self._pushText(id, text)
+        elif action == "pull":
+            return self._pull(id)
+        return ""
+
+    async def _arun(
+        self,
+        action: str,
+        id: str,
+        path: Optional[str] = None,
+        text: Optional[str] = None,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+        self._check_params(path, text)
+        if path:
+            self._pushFile(id, path)
+        if text:
+            self._pushText(id, text)
+        data = None
+        while True:
+            data = self._pull(id)
+            if data:
+                break
+            await asyncio.sleep(15)
+        return data
+
+    def _pushText(self, id: str, text: str) -> str:
+        field = {
+            "textfield": {"text": {"body": text, "format": 0}},
+            "processing_options": {"ml_text": self._config["enable_ml"]},
+        }
+        return self._pushField(id, field)
+
+    def _pushFile(self, id: str, content_path: str) -> str:
+        with open(content_path, "rb") as source_file:
+            response = requests.post(
+                self._config["BACKEND"] + "/processing/upload",
+                headers={
+                    "content-type": mimetypes.guess_type(content_path)[0]
+                    or "application/octet-stream",
+                    "x-stf-nuakey": "Bearer " + self._config["NUA_KEY"],
+                },
+                data=source_file.read(),
+            )
+            if response.status_code != 200:
+                logger.info(
+                    f"Error uploading {content_path}: "
+                    f"{response.status_code} {response.text}"
+                )
+                return ""
+            else:
+                field = {
+                    "filefield": {"file": f"{response.text}"},
+                    "processing_options": {"ml_text": self._config["enable_ml"]},
+                }
+                return self._pushField(id, field)
+
+    def _pushField(self, id: str, field: Any) -> str:
+        logger.info(f"Pushing {id} in queue")
+        response = requests.post(
+            self._config["BACKEND"] + "/processing/push",
+            headers={
+                "content-type": "application/json",
+                "x-stf-nuakey": "Bearer " + self._config["NUA_KEY"],
+            },
+            json=field,
+        )
+        if response.status_code != 200:
+            logger.info(
+                f"Error pushing field {id}:" f"{response.status_code} {response.text}"
+            )
+            raise ValueError("Error pushing field")
+        else:
+            uuid = response.json()["uuid"]
+            logger.info(f"Field {id} pushed in queue, uuid: {uuid}")
+            self._results[id] = {"uuid": uuid, "status": "pending"}
+            return uuid
+
+    def _pull(self, id: str) -> str:
+        self._pull_queue()
+        result = self._results.get(id, None)
+        if not result:
+            logger.info(f"{id} not in queue")
+            return ""
+        elif result["status"] == "pending":
+            logger.info(f'Waiting for {result["uuid"]} to be processed')
+            return ""
+        else:
+            return result["data"]
+
+    def _pull_queue(self) -> None:
+        try:
+            from nucliadb_protos.writer_pb2 import BrokerMessage
+        except ImportError as e:
+            raise ImportError(
+                "nucliadb-protos is not installed. "
+                "Run `pip install nucliadb-protos` to install."
+            ) from e
+        try:
+            from google.protobuf.json_format import MessageToJson
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import google.protobuf, please install with "
+                "`pip install protobuf`."
+            ) from e
+
+        res = requests.get(
+            self._config["BACKEND"] + "/processing/pull",
+            headers={
+                "x-stf-nuakey": "Bearer " + self._config["NUA_KEY"],
+            },
+        ).json()
+        if res["status"] == "empty":
+            logger.info("Queue empty")
+        elif res["status"] == "ok":
+            payload = res["payload"]
+            pb = BrokerMessage()
+            pb.ParseFromString(base64.b64decode(payload))
+            uuid = pb.uuid
+            logger.info(f"Pulled {uuid} from queue")
+            matching_id = self._find_matching_id(uuid)
+            if not matching_id:
+                logger.info(f"No matching id for {uuid}")
+            else:
+                self._results[matching_id]["status"] = "done"
+                data = MessageToJson(
+                    pb,
+                    preserving_proto_field_name=True,
+                    including_default_value_fields=True,
+                )
+                self._results[matching_id]["data"] = data
+
+    def _find_matching_id(self, uuid: str) -> Union[str, None]:
+        for id, result in self._results.items():
+            if result["uuid"] == uuid:
+                return id
+        return None
+
+    def _check_params(self, path: Optional[str], text: Optional[str]) -> None:
+        if not path and not text:
+            raise ValueError("File path or text is required")
+        if path and text:
+            raise ValueError("Cannot process both file and text on a single run")
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/__init__.py b/llm/Lib/site-packages/langchain_community/tools/office365/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..10ff2206f71878cee674a813236c09d0fe0889fa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/office365/__init__.py
@@ -0,0 +1,19 @@
+"""O365 tools."""
+
+from langchain_community.tools.office365.create_draft_message import (
+    O365CreateDraftMessage,
+)
+from langchain_community.tools.office365.events_search import O365SearchEvents
+from langchain_community.tools.office365.messages_search import O365SearchEmails
+from langchain_community.tools.office365.send_event import O365SendEvent
+from langchain_community.tools.office365.send_message import O365SendMessage
+from langchain_community.tools.office365.utils import authenticate
+
+__all__ = [
+    "O365SearchEmails",
+    "O365SearchEvents",
+    "O365CreateDraftMessage",
+    "O365SendMessage",
+    "O365SendEvent",
+    "authenticate",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f9cd3ba99f399ab2ad33e9d3dd41aee6acf5975a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6f77a9acdc9fcd2c9cc79d5221d6118f895d4d92
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/create_draft_message.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/create_draft_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..667b649b96f82101ba7a3cabf061e10b7b3cd1c7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/create_draft_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/events_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/events_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5c821521aca4795a6c9375890473b565ea24a948
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/events_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/messages_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/messages_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..448d15e51612fa0f4f230a665dec3123a2c45b85
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/messages_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/send_event.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/send_event.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..294bd770c4108bd54c51f18920f0bcec80cb0079
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/send_event.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/send_message.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/send_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..174e3b222c2eaa9334922b3f21299cd9be7a7d9f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/send_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1f5462d546262abef86e8a967e6f6ead53182e0f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/office365/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/base.py b/llm/Lib/site-packages/langchain_community/tools/office365/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..230e2aa125c4ba59fad7b9f2d7e81efbdbe34f5a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/office365/base.py
@@ -0,0 +1,19 @@
+"""Base class for Office 365 tools."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.office365.utils import authenticate
+
+if TYPE_CHECKING:
+    from O365 import Account
+
+
+class O365BaseTool(BaseTool):
+    """Base class for the Office 365 tools."""
+
+    account: Account = Field(default_factory=authenticate)
+    """The account object for the Office 365 account."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/create_draft_message.py b/llm/Lib/site-packages/langchain_community/tools/office365/create_draft_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..88c94578a83f621bfcd859092cacfeabf80bd4e8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/office365/create_draft_message.py
@@ -0,0 +1,68 @@
+from typing import List, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.office365.base import O365BaseTool
+
+
+class CreateDraftMessageSchema(BaseModel):
+    """Input for SendMessageTool."""
+
+    body: str = Field(
+        ...,
+        description="The message body to include in the draft.",
+    )
+    to: List[str] = Field(
+        ...,
+        description="The list of recipients.",
+    )
+    subject: str = Field(
+        ...,
+        description="The subject of the message.",
+    )
+    cc: Optional[List[str]] = Field(
+        None,
+        description="The list of CC recipients.",
+    )
+    bcc: Optional[List[str]] = Field(
+        None,
+        description="The list of BCC recipients.",
+    )
+
+
+class O365CreateDraftMessage(O365BaseTool):
+    """Tool for creating a draft email in Office 365."""
+
+    name: str = "create_email_draft"
+    description: str = (
+        "Use this tool to create a draft email with the provided message fields."
+    )
+    args_schema: Type[CreateDraftMessageSchema] = CreateDraftMessageSchema
+
+    def _run(
+        self,
+        body: str,
+        to: List[str],
+        subject: str,
+        cc: Optional[List[str]] = None,
+        bcc: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        # Get mailbox object
+        mailbox = self.account.mailbox()
+        message = mailbox.new_message()
+
+        # Assign message values
+        message.body = body
+        message.subject = subject
+        message.to.add(to)
+        if cc is not None:
+            message.cc.add(cc)
+        if bcc is not None:
+            message.bcc.add(bcc)
+
+        message.save_draft()
+
+        output = "Draft created: " + str(message)
+        return output
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/events_search.py b/llm/Lib/site-packages/langchain_community/tools/office365/events_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..f74927e507bc38b8a5feb66caebae513e99b7017
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/office365/events_search.py
@@ -0,0 +1,128 @@
+"""Util that Searches calendar events in Office 365.
+
+Free, but setup is required. See link below.
+https://learn.microsoft.com/en-us/graph/auth/
+"""
+
+from datetime import datetime as dt
+from typing import Any, Dict, List, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field
+
+from langchain_community.tools.office365.base import O365BaseTool
+from langchain_community.tools.office365.utils import UTC_FORMAT, clean_body
+
+
+class SearchEventsInput(BaseModel):
+    """Input for SearchEmails Tool.
+
+    From https://learn.microsoft.com/en-us/graph/search-query-parameter"""
+
+    start_datetime: str = Field(
+        description=(
+            " The start datetime for the search query in the following format: "
+            ' YYYY-MM-DDTHH:MM:SS±hh:mm, where "T" separates the date and time '
+            " components, and the time zone offset is specified as ±hh:mm. "
+            ' For example: "2023-06-09T10:30:00+03:00" represents June 9th, '
+            " 2023, at 10:30 AM in a time zone with a positive offset of 3 "
+            " hours from Coordinated Universal Time (UTC)."
+        )
+    )
+    end_datetime: str = Field(
+        description=(
+            " The end datetime for the search query in the following format: "
+            ' YYYY-MM-DDTHH:MM:SS±hh:mm, where "T" separates the date and time '
+            " components, and the time zone offset is specified as ±hh:mm. "
+            ' For example: "2023-06-09T10:30:00+03:00" represents June 9th, '
+            " 2023, at 10:30 AM in a time zone with a positive offset of 3 "
+            " hours from Coordinated Universal Time (UTC)."
+        )
+    )
+    max_results: int = Field(
+        default=10,
+        description="The maximum number of results to return.",
+    )
+    truncate: bool = Field(
+        default=True,
+        description=(
+            "Whether the event's body is truncated to meet token number limits. Set to "
+            "False for searches that will retrieve small events, otherwise, set to "
+            "True."
+        ),
+    )
+
+
+class O365SearchEvents(O365BaseTool):
+    """Search calendar events in Office 365.
+
+    Free, but setup is required
+    """
+
+    name: str = "events_search"
+    args_schema: Type[BaseModel] = SearchEventsInput
+    description: str = (
+        " Use this tool to search for the user's calendar events."
+        " The input must be the start and end datetimes for the search query."
+        " The output is a JSON list of all the events in the user's calendar"
+        " between the start and end times. You can assume that the user can "
+        " not schedule any meeting over existing meetings, and that the user "
+        "is busy during meetings. Any times without events are free for the user. "
+    )
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def _run(
+        self,
+        start_datetime: str,
+        end_datetime: str,
+        max_results: int = 10,
+        truncate: bool = True,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+        truncate_limit: int = 150,
+    ) -> List[Dict[str, Any]]:
+        # Get calendar object
+        schedule = self.account.schedule()
+        calendar = schedule.get_default_calendar()
+
+        # Process the date range parameters
+        start_datetime_query = dt.strptime(start_datetime, UTC_FORMAT)
+        end_datetime_query = dt.strptime(end_datetime, UTC_FORMAT)
+
+        # Run the query
+        q = calendar.new_query("start").greater_equal(start_datetime_query)
+        q.chain("and").on_attribute("end").less_equal(end_datetime_query)
+        events = calendar.get_events(query=q, include_recurring=True, limit=max_results)
+
+        # Generate output dict
+        output_events = []
+        for event in events:
+            output_event = {}
+            output_event["organizer"] = event.organizer
+
+            output_event["subject"] = event.subject
+
+            if truncate:
+                output_event["body"] = clean_body(event.body)[:truncate_limit]
+            else:
+                output_event["body"] = clean_body(event.body)
+
+            # Get the time zone from the search parameters
+            time_zone = start_datetime_query.tzinfo
+            # Assign the datetimes in the search time zone
+            output_event["start_datetime"] = event.start.astimezone(time_zone).strftime(
+                UTC_FORMAT
+            )
+            output_event["end_datetime"] = event.end.astimezone(time_zone).strftime(
+                UTC_FORMAT
+            )
+            output_event["modified_date"] = event.modified.astimezone(
+                time_zone
+            ).strftime(UTC_FORMAT)
+
+            output_events.append(output_event)
+
+        return output_events
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/messages_search.py b/llm/Lib/site-packages/langchain_community/tools/office365/messages_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b12b2a15ab51473c5a02eb9b95c3fbca5cd1d1f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/office365/messages_search.py
@@ -0,0 +1,123 @@
+"""Util that Searches email messages in Office 365.
+
+Free, but setup is required. See link below.
+https://learn.microsoft.com/en-us/graph/auth/
+"""
+
+from typing import Any, Dict, List, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field
+
+from langchain_community.tools.office365.base import O365BaseTool
+from langchain_community.tools.office365.utils import UTC_FORMAT, clean_body
+
+
+class SearchEmailsInput(BaseModel):
+    """Input for SearchEmails Tool."""
+
+    """From https://learn.microsoft.com/en-us/graph/search-query-parameter"""
+
+    folder: str = Field(
+        default=None,
+        description=(
+            " If the user wants to search in only one folder, the name of the folder. "
+            'Default folders are "inbox", "drafts", "sent items", "deleted ttems", but '
+            "users can search custom folders as well."
+        ),
+    )
+    query: str = Field(
+        description=(
+            "The Microsoift Graph v1.0 $search query. Example filters include "
+            "from:sender, from:sender, to:recipient, subject:subject, "
+            "recipients:list_of_recipients, body:excitement, importance:high, "
+            "received>2022-12-01, received<2021-12-01, sent>2022-12-01, "
+            "sent<2021-12-01, hasAttachments:true  attachment:api-catalog.md, "
+            "cc:samanthab@contoso.com, bcc:samanthab@contoso.com, body:excitement date "
+            "range example: received:2023-06-08..2023-06-09  matching example: "
+            "from:amy OR from:david."
+        )
+    )
+    max_results: int = Field(
+        default=10,
+        description="The maximum number of results to return.",
+    )
+    truncate: bool = Field(
+        default=True,
+        description=(
+            "Whether the email body is truncated to meet token number limits. Set to "
+            "False for searches that will retrieve small messages, otherwise, set to "
+            "True"
+        ),
+    )
+
+
+class O365SearchEmails(O365BaseTool):
+    """Search email messages in Office 365.
+
+    Free, but setup is required.
+    """
+
+    name: str = "messages_search"
+    args_schema: Type[BaseModel] = SearchEmailsInput
+    description: str = (
+        "Use this tool to search for email messages."
+        " The input must be a valid Microsoft Graph v1.0 $search query."
+        " The output is a JSON list of the requested resource."
+    )
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def _run(
+        self,
+        query: str,
+        folder: str = "",
+        max_results: int = 10,
+        truncate: bool = True,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+        truncate_limit: int = 150,
+    ) -> List[Dict[str, Any]]:
+        # Get mailbox object
+        mailbox = self.account.mailbox()
+
+        # Pull the folder if the user wants to search in a folder
+        if folder != "":
+            mailbox = mailbox.get_folder(folder_name=folder)
+
+        # Retrieve messages based on query
+        query = mailbox.q().search(query)
+        messages = mailbox.get_messages(limit=max_results, query=query)
+
+        # Generate output dict
+        output_messages = []
+        for message in messages:
+            output_message = {}
+            output_message["from"] = message.sender
+
+            if truncate:
+                output_message["body"] = message.body_preview[:truncate_limit]
+            else:
+                output_message["body"] = clean_body(message.body)
+
+            output_message["subject"] = message.subject
+
+            output_message["date"] = message.modified.strftime(UTC_FORMAT)
+
+            output_message["to"] = []
+            for recipient in message.to._recipients:
+                output_message["to"].append(str(recipient))
+
+            output_message["cc"] = []
+            for recipient in message.cc._recipients:
+                output_message["cc"].append(str(recipient))
+
+            output_message["bcc"] = []
+            for recipient in message.bcc._recipients:
+                output_message["bcc"].append(str(recipient))
+
+            output_messages.append(output_message)
+
+        return output_messages
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/send_event.py b/llm/Lib/site-packages/langchain_community/tools/office365/send_event.py
new file mode 100644
index 0000000000000000000000000000000000000000..e8b9d023af7a52c227d7f8928c5c9fd92bd0d3cd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/office365/send_event.py
@@ -0,0 +1,85 @@
+"""Util that sends calendar events in Office 365.
+
+Free, but setup is required. See link below.
+https://learn.microsoft.com/en-us/graph/auth/
+"""
+
+from datetime import datetime as dt
+from typing import List, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.office365.base import O365BaseTool
+from langchain_community.tools.office365.utils import UTC_FORMAT
+
+
+class SendEventSchema(BaseModel):
+    """Input for CreateEvent Tool."""
+
+    body: str = Field(
+        ...,
+        description="The message body to include in the event.",
+    )
+    attendees: List[str] = Field(
+        ...,
+        description="The list of attendees for the event.",
+    )
+    subject: str = Field(
+        ...,
+        description="The subject of the event.",
+    )
+    start_datetime: str = Field(
+        description=" The start datetime for the event in the following format: "
+        ' YYYY-MM-DDTHH:MM:SS±hh:mm, where "T" separates the date and time '
+        " components, and the time zone offset is specified as ±hh:mm. "
+        ' For example: "2023-06-09T10:30:00+03:00" represents June 9th, '
+        " 2023, at 10:30 AM in a time zone with a positive offset of 3 "
+        " hours from Coordinated Universal Time (UTC).",
+    )
+    end_datetime: str = Field(
+        description=" The end datetime for the event in the following format: "
+        ' YYYY-MM-DDTHH:MM:SS±hh:mm, where "T" separates the date and time '
+        " components, and the time zone offset is specified as ±hh:mm. "
+        ' For example: "2023-06-09T10:30:00+03:00" represents June 9th, '
+        " 2023, at 10:30 AM in a time zone with a positive offset of 3 "
+        " hours from Coordinated Universal Time (UTC).",
+    )
+
+
+class O365SendEvent(O365BaseTool):
+    """Tool for sending calendar events in Office 365."""
+
+    name: str = "send_event"
+    description: str = (
+        "Use this tool to create and send an event with the provided event fields."
+    )
+    args_schema: Type[SendEventSchema] = SendEventSchema
+
+    def _run(
+        self,
+        body: str,
+        attendees: List[str],
+        subject: str,
+        start_datetime: str,
+        end_datetime: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        # Get calendar object
+        schedule = self.account.schedule()
+        calendar = schedule.get_default_calendar()
+
+        event = calendar.new_event()
+
+        event.body = body
+        event.subject = subject
+        event.start = dt.strptime(start_datetime, UTC_FORMAT)
+        event.end = dt.strptime(end_datetime, UTC_FORMAT)
+        for attendee in attendees:
+            event.attendees.add(attendee)
+
+        # TO-DO: Look into PytzUsageWarning
+        event.save()
+
+        output = "Event sent: " + str(event)
+        return output
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/send_message.py b/llm/Lib/site-packages/langchain_community/tools/office365/send_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..828e9e4fa614d1af97be2e2e7bad0f78dd7a7b2e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/office365/send_message.py
@@ -0,0 +1,68 @@
+from typing import List, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.office365.base import O365BaseTool
+
+
+class SendMessageSchema(BaseModel):
+    """Input for SendMessageTool."""
+
+    body: str = Field(
+        ...,
+        description="The message body to be sent.",
+    )
+    to: List[str] = Field(
+        ...,
+        description="The list of recipients.",
+    )
+    subject: str = Field(
+        ...,
+        description="The subject of the message.",
+    )
+    cc: Optional[List[str]] = Field(
+        None,
+        description="The list of CC recipients.",
+    )
+    bcc: Optional[List[str]] = Field(
+        None,
+        description="The list of BCC recipients.",
+    )
+
+
+class O365SendMessage(O365BaseTool):
+    """Send an email in Office 365."""
+
+    name: str = "send_email"
+    description: str = (
+        "Use this tool to send an email with the provided message fields."
+    )
+    args_schema: Type[SendMessageSchema] = SendMessageSchema
+
+    def _run(
+        self,
+        body: str,
+        to: List[str],
+        subject: str,
+        cc: Optional[List[str]] = None,
+        bcc: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        # Get mailbox object
+        mailbox = self.account.mailbox()
+        message = mailbox.new_message()
+
+        # Assign message values
+        message.body = body
+        message.subject = subject
+        message.to.add(to)
+        if cc is not None:
+            message.cc.add(cc)
+        if bcc is not None:
+            message.bcc.add(bcc)
+
+        message.send()
+
+        output = "Message sent: " + str(message)
+        return output
diff --git a/llm/Lib/site-packages/langchain_community/tools/office365/utils.py b/llm/Lib/site-packages/langchain_community/tools/office365/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..168fe1ccb45448b1010238ef6fd54cccfaa137f9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/office365/utils.py
@@ -0,0 +1,79 @@
+"""O365 tool utils."""
+
+from __future__ import annotations
+
+import logging
+import os
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from O365 import Account
+
+logger = logging.getLogger(__name__)
+
+
+def clean_body(body: str) -> str:
+    """Clean body of a message or event."""
+    try:
+        from bs4 import BeautifulSoup
+
+        try:
+            # Remove HTML
+            soup = BeautifulSoup(str(body), "html.parser")
+            body = soup.get_text()
+
+            # Remove return characters
+            body = "".join(body.splitlines())
+
+            # Remove extra spaces
+            body = " ".join(body.split())
+
+            return str(body)
+        except Exception:
+            return str(body)
+    except ImportError:
+        return str(body)
+
+
+def authenticate() -> Account:
+    """Authenticate using the Microsoft Graph API"""
+    try:
+        from O365 import Account
+    except ImportError as e:
+        raise ImportError(
+            "Cannot import 0365. Please install the package with `pip install O365`."
+        ) from e
+
+    if "CLIENT_ID" in os.environ and "CLIENT_SECRET" in os.environ:
+        client_id = os.environ["CLIENT_ID"]
+        client_secret = os.environ["CLIENT_SECRET"]
+        credentials = (client_id, client_secret)
+    else:
+        logger.error(
+            "Error: The CLIENT_ID and CLIENT_SECRET environmental variables have not "
+            "been set. Visit the following link on how to acquire these authorization "
+            "tokens: https://learn.microsoft.com/en-us/graph/auth/"
+        )
+        return None
+
+    account = Account(credentials)
+
+    if account.is_authenticated is False:
+        if not account.authenticate(
+            scopes=[
+                "https://graph.microsoft.com/Mail.ReadWrite",
+                "https://graph.microsoft.com/Mail.Send",
+                "https://graph.microsoft.com/Calendars.ReadWrite",
+                "https://graph.microsoft.com/MailboxSettings.ReadWrite",
+            ]
+        ):
+            print("Error: Could not authenticate")  # noqa: T201
+            return None
+        else:
+            return account
+    else:
+        return account
+
+
+UTC_FORMAT = "%Y-%m-%dT%H:%M:%S%z"
+"""UTC format for datetime objects."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/openai_dalle_image_generation/__init__.py b/llm/Lib/site-packages/langchain_community/tools/openai_dalle_image_generation/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..dbdf41b11b253884f35794528c46c69111c7a5e5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/openai_dalle_image_generation/__init__.py
@@ -0,0 +1,7 @@
+"""Tool to generate an image using DALLE OpenAI V1 SDK."""
+
+from langchain_community.tools.openai_dalle_image_generation.tool import (
+    OpenAIDALLEImageGenerationTool,
+)
+
+__all__ = ["OpenAIDALLEImageGenerationTool"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/openai_dalle_image_generation/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/openai_dalle_image_generation/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1f3bd8bd8a1a18779fa3b2a72e32313f0439ff4e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/openai_dalle_image_generation/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/openai_dalle_image_generation/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/openai_dalle_image_generation/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4dfce46ca1093c6f5085979b359facdfac06e4c6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/openai_dalle_image_generation/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/openai_dalle_image_generation/tool.py b/llm/Lib/site-packages/langchain_community/tools/openai_dalle_image_generation/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..36374e887f74b8805c1bbee1b0c12191dd93102b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/openai_dalle_image_generation/tool.py
@@ -0,0 +1,29 @@
+"""Tool for the OpenAI DALLE V1 Image Generation SDK."""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.dalle_image_generator import DallEAPIWrapper
+
+
+class OpenAIDALLEImageGenerationTool(BaseTool):
+    """Tool that generates an image using OpenAI DALLE."""
+
+    name: str = "openai_dalle"
+    description: str = (
+        "A wrapper around OpenAI DALLE Image Generation. "
+        "Useful for when you need to generate an image of"
+        "people, places, paintings, animals, or other subjects. "
+        "Input should be a text prompt to generate an image."
+    )
+    api_wrapper: DallEAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the OpenAI DALLE Image Generation tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/openapi/__init__.py b/llm/Lib/site-packages/langchain_community/tools/openapi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_community/tools/openapi/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/openapi/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a680b5b49cb9cee40088159cffb917d57be4b86d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/openapi/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/openapi/utils/__init__.py b/llm/Lib/site-packages/langchain_community/tools/openapi/utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_community/tools/openapi/utils/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/openapi/utils/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6f89f39ebc8830de23c811d12bede0393cc8fd70
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/openapi/utils/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/openapi/utils/__pycache__/api_models.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/openapi/utils/__pycache__/api_models.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..16e332fcd2aebc6543a3d18088016ac5e92abb34
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/openapi/utils/__pycache__/api_models.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/openapi/utils/__pycache__/openapi_utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/openapi/utils/__pycache__/openapi_utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..66b6097e3e5ecf52c8ccd1ce53648b0a86db9155
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/openapi/utils/__pycache__/openapi_utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/openapi/utils/api_models.py b/llm/Lib/site-packages/langchain_community/tools/openapi/utils/api_models.py
new file mode 100644
index 0000000000000000000000000000000000000000..38ae4afca1724b2fe965cfd1756d47042203367b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/openapi/utils/api_models.py
@@ -0,0 +1,631 @@
+"""Pydantic models for parsing an OpenAPI spec."""
+from __future__ import annotations
+
+import logging
+from enum import Enum
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+)
+
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.openapi.utils.openapi_utils import HTTPVerb, OpenAPISpec
+
+logger = logging.getLogger(__name__)
+PRIMITIVE_TYPES = {
+    "integer": int,
+    "number": float,
+    "string": str,
+    "boolean": bool,
+    "array": List,
+    "object": Dict,
+    "null": None,
+}
+
+
+# See https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#parameterIn
+# for more info.
+class APIPropertyLocation(Enum):
+    """The location of the property."""
+
+    QUERY = "query"
+    PATH = "path"
+    HEADER = "header"
+    COOKIE = "cookie"  # Not yet supported
+
+    @classmethod
+    def from_str(cls, location: str) -> "APIPropertyLocation":
+        """Parse an APIPropertyLocation."""
+        try:
+            return cls(location)
+        except ValueError:
+            raise ValueError(
+                f"Invalid APIPropertyLocation. Valid values are {cls.__members__}"
+            )
+
+
+_SUPPORTED_MEDIA_TYPES = ("application/json",)
+
+SUPPORTED_LOCATIONS = {
+    APIPropertyLocation.QUERY,
+    APIPropertyLocation.PATH,
+}
+INVALID_LOCATION_TEMPL = (
+    'Unsupported APIPropertyLocation "{location}"'
+    " for parameter {name}. "
+    + f"Valid values are {[loc.value for loc in SUPPORTED_LOCATIONS]}"
+)
+
+SCHEMA_TYPE = Union[str, Type, tuple, None, Enum]
+
+
+class APIPropertyBase(BaseModel):
+    """Base model for an API property."""
+
+    # The name of the parameter is required and is case-sensitive.
+    # If "in" is "path", the "name" field must correspond to a template expression
+    # within the path field in the Paths Object.
+    # If "in" is "header" and the "name" field is "Accept", "Content-Type",
+    # or "Authorization", the parameter definition is ignored.
+    # For all other cases, the "name" corresponds to the parameter
+    # name used by the "in" property.
+    name: str = Field(alias="name")
+    """The name of the property."""
+
+    required: bool = Field(alias="required")
+    """Whether the property is required."""
+
+    type: SCHEMA_TYPE = Field(alias="type")
+    """The type of the property.
+    
+    Either a primitive type, a component/parameter type,
+    or an array or 'object' (dict) of the above."""
+
+    default: Optional[Any] = Field(alias="default", default=None)
+    """The default value of the property."""
+
+    description: Optional[str] = Field(alias="description", default=None)
+    """The description of the property."""
+
+
+if TYPE_CHECKING:
+    from openapi_pydantic import (
+        MediaType,
+        Parameter,
+        RequestBody,
+        Schema,
+    )
+
+
+class APIProperty(APIPropertyBase):
+    """A model for a property in the query, path, header, or cookie params."""
+
+    location: APIPropertyLocation = Field(alias="location")
+    """The path/how it's being passed to the endpoint."""
+
+    @staticmethod
+    def _cast_schema_list_type(
+        schema: Schema,
+    ) -> Optional[Union[str, Tuple[str, ...]]]:
+        type_ = schema.type
+        if not isinstance(type_, list):
+            return type_
+        else:
+            return tuple(type_)
+
+    @staticmethod
+    def _get_schema_type_for_enum(parameter: Parameter, schema: Schema) -> Enum:
+        """Get the schema type when the parameter is an enum."""
+        param_name = f"{parameter.name}Enum"
+        return Enum(param_name, {str(v): v for v in schema.enum})
+
+    @staticmethod
+    def _get_schema_type_for_array(
+        schema: Schema,
+    ) -> Optional[Union[str, Tuple[str, ...]]]:
+        from openapi_pydantic import (
+            Reference,
+            Schema,
+        )
+
+        items = schema.items
+        if isinstance(items, Schema):
+            schema_type = APIProperty._cast_schema_list_type(items)
+        elif isinstance(items, Reference):
+            ref_name = items.ref.split("/")[-1]
+            schema_type = ref_name  # TODO: Add ref definitions to make his valid
+        else:
+            raise ValueError(f"Unsupported array items: {items}")
+
+        if isinstance(schema_type, str):
+            # TODO: recurse
+            schema_type = (schema_type,)
+
+        return schema_type
+
+    @staticmethod
+    def _get_schema_type(parameter: Parameter, schema: Optional[Schema]) -> SCHEMA_TYPE:
+        if schema is None:
+            return None
+        schema_type: SCHEMA_TYPE = APIProperty._cast_schema_list_type(schema)
+        if schema_type == "array":
+            schema_type = APIProperty._get_schema_type_for_array(schema)
+        elif schema_type == "object":
+            # TODO: Resolve array and object types to components.
+            raise NotImplementedError("Objects not yet supported")
+        elif schema_type in PRIMITIVE_TYPES:
+            if schema.enum:
+                schema_type = APIProperty._get_schema_type_for_enum(parameter, schema)
+            else:
+                # Directly use the primitive type
+                pass
+        else:
+            raise NotImplementedError(f"Unsupported type: {schema_type}")
+
+        return schema_type
+
+    @staticmethod
+    def _validate_location(location: APIPropertyLocation, name: str) -> None:
+        if location not in SUPPORTED_LOCATIONS:
+            raise NotImplementedError(
+                INVALID_LOCATION_TEMPL.format(location=location, name=name)
+            )
+
+    @staticmethod
+    def _validate_content(content: Optional[Dict[str, MediaType]]) -> None:
+        if content:
+            raise ValueError(
+                "API Properties with media content not supported. "
+                "Media content only supported within APIRequestBodyProperty's"
+            )
+
+    @staticmethod
+    def _get_schema(parameter: Parameter, spec: OpenAPISpec) -> Optional[Schema]:
+        from openapi_pydantic import (
+            Reference,
+            Schema,
+        )
+
+        schema = parameter.param_schema
+        if isinstance(schema, Reference):
+            schema = spec.get_referenced_schema(schema)
+        elif schema is None:
+            return None
+        elif not isinstance(schema, Schema):
+            raise ValueError(f"Error dereferencing schema: {schema}")
+
+        return schema
+
+    @staticmethod
+    def is_supported_location(location: str) -> bool:
+        """Return whether the provided location is supported."""
+        try:
+            return APIPropertyLocation.from_str(location) in SUPPORTED_LOCATIONS
+        except ValueError:
+            return False
+
+    @classmethod
+    def from_parameter(cls, parameter: Parameter, spec: OpenAPISpec) -> "APIProperty":
+        """Instantiate from an OpenAPI Parameter."""
+        location = APIPropertyLocation.from_str(parameter.param_in)
+        cls._validate_location(
+            location,
+            parameter.name,
+        )
+        cls._validate_content(parameter.content)
+        schema = cls._get_schema(parameter, spec)
+        schema_type = cls._get_schema_type(parameter, schema)
+        default_val = schema.default if schema is not None else None
+        return cls(
+            name=parameter.name,
+            location=location,
+            default=default_val,
+            description=parameter.description,
+            required=parameter.required,
+            type=schema_type,
+        )
+
+
+class APIRequestBodyProperty(APIPropertyBase):
+    """A model for a request body property."""
+
+    properties: List["APIRequestBodyProperty"] = Field(alias="properties")
+    """The sub-properties of the property."""
+
+    # This is useful for handling nested property cycles.
+    # We can define separate types in that case.
+    references_used: List[str] = Field(alias="references_used")
+    """The references used by the property."""
+
+    @classmethod
+    def _process_object_schema(
+        cls, schema: Schema, spec: OpenAPISpec, references_used: List[str]
+    ) -> Tuple[Union[str, List[str], None], List["APIRequestBodyProperty"]]:
+        from openapi_pydantic import (
+            Reference,
+        )
+
+        properties = []
+        required_props = schema.required or []
+        if schema.properties is None:
+            raise ValueError(
+                f"No properties found when processing object schema: {schema}"
+            )
+        for prop_name, prop_schema in schema.properties.items():
+            if isinstance(prop_schema, Reference):
+                ref_name = prop_schema.ref.split("/")[-1]
+                if ref_name not in references_used:
+                    references_used.append(ref_name)
+                    prop_schema = spec.get_referenced_schema(prop_schema)
+                else:
+                    continue
+
+            properties.append(
+                cls.from_schema(
+                    schema=prop_schema,
+                    name=prop_name,
+                    required=prop_name in required_props,
+                    spec=spec,
+                    references_used=references_used,
+                )
+            )
+        return schema.type, properties
+
+    @classmethod
+    def _process_array_schema(
+        cls,
+        schema: Schema,
+        name: str,
+        spec: OpenAPISpec,
+        references_used: List[str],
+    ) -> str:
+        from openapi_pydantic import Reference, Schema
+
+        items = schema.items
+        if items is not None:
+            if isinstance(items, Reference):
+                ref_name = items.ref.split("/")[-1]
+                if ref_name not in references_used:
+                    references_used.append(ref_name)
+                    items = spec.get_referenced_schema(items)
+                else:
+                    pass
+                return f"Array<{ref_name}>"
+            else:
+                pass
+
+            if isinstance(items, Schema):
+                array_type = cls.from_schema(
+                    schema=items,
+                    name=f"{name}Item",
+                    required=True,  # TODO: Add required
+                    spec=spec,
+                    references_used=references_used,
+                )
+                return f"Array<{array_type.type}>"
+
+        return "array"
+
+    @classmethod
+    def from_schema(
+        cls,
+        schema: Schema,
+        name: str,
+        required: bool,
+        spec: OpenAPISpec,
+        references_used: Optional[List[str]] = None,
+    ) -> "APIRequestBodyProperty":
+        """Recursively populate from an OpenAPI Schema."""
+        if references_used is None:
+            references_used = []
+
+        schema_type = schema.type
+        properties: List[APIRequestBodyProperty] = []
+        if schema_type == "object" and schema.properties:
+            schema_type, properties = cls._process_object_schema(
+                schema, spec, references_used
+            )
+        elif schema_type == "array":
+            schema_type = cls._process_array_schema(schema, name, spec, references_used)
+        elif schema_type in PRIMITIVE_TYPES:
+            # Use the primitive type directly
+            pass
+        elif schema_type is None:
+            # No typing specified/parsed. WIll map to 'any'
+            pass
+        else:
+            raise ValueError(f"Unsupported type: {schema_type}")
+
+        return cls(
+            name=name,
+            required=required,
+            type=schema_type,
+            default=schema.default,
+            description=schema.description,
+            properties=properties,
+            references_used=references_used,
+        )
+
+
+# class APIRequestBodyProperty(APIPropertyBase):
+class APIRequestBody(BaseModel):
+    """A model for a request body."""
+
+    description: Optional[str] = Field(alias="description")
+    """The description of the request body."""
+
+    properties: List[APIRequestBodyProperty] = Field(alias="properties")
+
+    # E.g., application/json - we only support JSON at the moment.
+    media_type: str = Field(alias="media_type")
+    """The media type of the request body."""
+
+    @classmethod
+    def _process_supported_media_type(
+        cls,
+        media_type_obj: MediaType,
+        spec: OpenAPISpec,
+    ) -> List[APIRequestBodyProperty]:
+        """Process the media type of the request body."""
+        from openapi_pydantic import Reference
+
+        references_used = []
+        schema = media_type_obj.media_type_schema
+        if isinstance(schema, Reference):
+            references_used.append(schema.ref.split("/")[-1])
+            schema = spec.get_referenced_schema(schema)
+        if schema is None:
+            raise ValueError(
+                f"Could not resolve schema for media type: {media_type_obj}"
+            )
+        api_request_body_properties = []
+        required_properties = schema.required or []
+        if schema.type == "object" and schema.properties:
+            for prop_name, prop_schema in schema.properties.items():
+                if isinstance(prop_schema, Reference):
+                    prop_schema = spec.get_referenced_schema(prop_schema)
+
+                api_request_body_properties.append(
+                    APIRequestBodyProperty.from_schema(
+                        schema=prop_schema,
+                        name=prop_name,
+                        required=prop_name in required_properties,
+                        spec=spec,
+                    )
+                )
+        else:
+            api_request_body_properties.append(
+                APIRequestBodyProperty(
+                    name="body",
+                    required=True,
+                    type=schema.type,
+                    default=schema.default,
+                    description=schema.description,
+                    properties=[],
+                    references_used=references_used,
+                )
+            )
+
+        return api_request_body_properties
+
+    @classmethod
+    def from_request_body(
+        cls, request_body: RequestBody, spec: OpenAPISpec
+    ) -> "APIRequestBody":
+        """Instantiate from an OpenAPI RequestBody."""
+        properties = []
+        for media_type, media_type_obj in request_body.content.items():
+            if media_type not in _SUPPORTED_MEDIA_TYPES:
+                continue
+            api_request_body_properties = cls._process_supported_media_type(
+                media_type_obj,
+                spec,
+            )
+            properties.extend(api_request_body_properties)
+
+        return cls(
+            description=request_body.description,
+            properties=properties,
+            media_type=media_type,
+        )
+
+
+# class APIRequestBodyProperty(APIPropertyBase):
+#     class APIRequestBody(BaseModel):
+class APIOperation(BaseModel):
+    """A model for a single API operation."""
+
+    operation_id: str = Field(alias="operation_id")
+    """The unique identifier of the operation."""
+
+    description: Optional[str] = Field(alias="description")
+    """The description of the operation."""
+
+    base_url: str = Field(alias="base_url")
+    """The base URL of the operation."""
+
+    path: str = Field(alias="path")
+    """The path of the operation."""
+
+    method: HTTPVerb = Field(alias="method")
+    """The HTTP method of the operation."""
+
+    properties: Sequence[APIProperty] = Field(alias="properties")
+
+    # TODO: Add parse in used components to be able to specify what type of
+    # referenced object it is.
+    # """The properties of the operation."""
+    # components: Dict[str, BaseModel] = Field(alias="components")
+
+    request_body: Optional[APIRequestBody] = Field(alias="request_body")
+    """The request body of the operation."""
+
+    @staticmethod
+    def _get_properties_from_parameters(
+        parameters: List[Parameter], spec: OpenAPISpec
+    ) -> List[APIProperty]:
+        """Get the properties of the operation."""
+        properties = []
+        for param in parameters:
+            if APIProperty.is_supported_location(param.param_in):
+                properties.append(APIProperty.from_parameter(param, spec))
+            elif param.required:
+                raise ValueError(
+                    INVALID_LOCATION_TEMPL.format(
+                        location=param.param_in, name=param.name
+                    )
+                )
+            else:
+                logger.warning(
+                    INVALID_LOCATION_TEMPL.format(
+                        location=param.param_in, name=param.name
+                    )
+                    + " Ignoring optional parameter"
+                )
+                pass
+        return properties
+
+    @classmethod
+    def from_openapi_url(
+        cls,
+        spec_url: str,
+        path: str,
+        method: str,
+    ) -> "APIOperation":
+        """Create an APIOperation from an OpenAPI URL."""
+        spec = OpenAPISpec.from_url(spec_url)
+        return cls.from_openapi_spec(spec, path, method)
+
+    @classmethod
+    def from_openapi_spec(
+        cls,
+        spec: OpenAPISpec,
+        path: str,
+        method: str,
+    ) -> "APIOperation":
+        """Create an APIOperation from an OpenAPI spec."""
+        operation = spec.get_operation(path, method)
+        parameters = spec.get_parameters_for_operation(operation)
+        properties = cls._get_properties_from_parameters(parameters, spec)
+        operation_id = OpenAPISpec.get_cleaned_operation_id(operation, path, method)
+        request_body = spec.get_request_body_for_operation(operation)
+        api_request_body = (
+            APIRequestBody.from_request_body(request_body, spec)
+            if request_body is not None
+            else None
+        )
+        description = operation.description or operation.summary
+        if not description and spec.paths is not None:
+            description = spec.paths[path].description or spec.paths[path].summary
+        return cls(
+            operation_id=operation_id,
+            description=description or "",
+            base_url=spec.base_url,
+            path=path,
+            method=method,
+            properties=properties,
+            request_body=api_request_body,
+        )
+
+    @staticmethod
+    def ts_type_from_python(type_: SCHEMA_TYPE) -> str:
+        if type_ is None:
+            # TODO: Handle Nones better. These often result when
+            # parsing specs that are < v3
+            return "any"
+        elif isinstance(type_, str):
+            return {
+                "str": "string",
+                "integer": "number",
+                "float": "number",
+                "date-time": "string",
+            }.get(type_, type_)
+        elif isinstance(type_, tuple):
+            return f"Array<{APIOperation.ts_type_from_python(type_[0])}>"
+        elif isinstance(type_, type) and issubclass(type_, Enum):
+            return " | ".join([f"'{e.value}'" for e in type_])
+        else:
+            return str(type_)
+
+    def _format_nested_properties(
+        self, properties: List[APIRequestBodyProperty], indent: int = 2
+    ) -> str:
+        """Format nested properties."""
+        formatted_props = []
+
+        for prop in properties:
+            prop_name = prop.name
+            prop_type = self.ts_type_from_python(prop.type)
+            prop_required = "" if prop.required else "?"
+            prop_desc = f"/* {prop.description} */" if prop.description else ""
+
+            if prop.properties:
+                nested_props = self._format_nested_properties(
+                    prop.properties, indent + 2
+                )
+                prop_type = f"{{\n{nested_props}\n{' ' * indent}}}"
+
+            formatted_props.append(
+                f"{prop_desc}\n{' ' * indent}{prop_name}"
+                f"{prop_required}: {prop_type},"
+            )
+
+        return "\n".join(formatted_props)
+
+    def to_typescript(self) -> str:
+        """Get typescript string representation of the operation."""
+        operation_name = self.operation_id
+        params = []
+
+        if self.request_body:
+            formatted_request_body_props = self._format_nested_properties(
+                self.request_body.properties
+            )
+            params.append(formatted_request_body_props)
+
+        for prop in self.properties:
+            prop_name = prop.name
+            prop_type = self.ts_type_from_python(prop.type)
+            prop_required = "" if prop.required else "?"
+            prop_desc = f"/* {prop.description} */" if prop.description else ""
+            params.append(f"{prop_desc}\n\t\t{prop_name}{prop_required}: {prop_type},")
+
+        formatted_params = "\n".join(params).strip()
+        description_str = f"/* {self.description} */" if self.description else ""
+        typescript_definition = f"""
+{description_str}
+type {operation_name} = (_: {{
+{formatted_params}
+}}) => any;
+"""
+        return typescript_definition.strip()
+
+    @property
+    def query_params(self) -> List[str]:
+        return [
+            property.name
+            for property in self.properties
+            if property.location == APIPropertyLocation.QUERY
+        ]
+
+    @property
+    def path_params(self) -> List[str]:
+        return [
+            property.name
+            for property in self.properties
+            if property.location == APIPropertyLocation.PATH
+        ]
+
+    @property
+    def body_params(self) -> List[str]:
+        if self.request_body is None:
+            return []
+        return [prop.name for prop in self.request_body.properties]
diff --git a/llm/Lib/site-packages/langchain_community/tools/openapi/utils/openapi_utils.py b/llm/Lib/site-packages/langchain_community/tools/openapi/utils/openapi_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..e958d19d8384375ba89da03e7c7b5fc9543c3b6a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/openapi/utils/openapi_utils.py
@@ -0,0 +1,4 @@
+"""Utility functions for parsing an OpenAPI spec. Kept for backwards compat."""
+from langchain_community.utilities.openapi import HTTPVerb, OpenAPISpec
+
+__all__ = ["HTTPVerb", "OpenAPISpec"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/openweathermap/__init__.py b/llm/Lib/site-packages/langchain_community/tools/openweathermap/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b2ff9b36515b11be8bf431285599c452a19574fc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/openweathermap/__init__.py
@@ -0,0 +1,8 @@
+"""OpenWeatherMap API toolkit."""
+
+
+from langchain_community.tools.openweathermap.tool import OpenWeatherMapQueryRun
+
+__all__ = [
+    "OpenWeatherMapQueryRun",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/openweathermap/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/openweathermap/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6d021106ad595540ceb8bbd6bf47a2ac7e9ca08d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/openweathermap/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/openweathermap/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/openweathermap/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5f2f2e6b02ab5d11d87a5290c147c76452b52b39
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/openweathermap/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/openweathermap/tool.py b/llm/Lib/site-packages/langchain_community/tools/openweathermap/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..0cd5b940010b9e461ef4baa9b091dec2666b7f22
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/openweathermap/tool.py
@@ -0,0 +1,30 @@
+"""Tool for the OpenWeatherMap API."""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.openweathermap import OpenWeatherMapAPIWrapper
+
+
+class OpenWeatherMapQueryRun(BaseTool):
+    """Tool that queries the OpenWeatherMap API."""
+
+    api_wrapper: OpenWeatherMapAPIWrapper = Field(
+        default_factory=OpenWeatherMapAPIWrapper
+    )
+
+    name: str = "open_weather_map"
+    description: str = (
+        "A wrapper around OpenWeatherMap API. "
+        "Useful for fetching current weather information for a specified location. "
+        "Input should be a location string (e.g. London,GB)."
+    )
+
+    def _run(
+        self, location: str, run_manager: Optional[CallbackManagerForToolRun] = None
+    ) -> str:
+        """Use the OpenWeatherMap tool."""
+        return self.api_wrapper.run(location)
diff --git a/llm/Lib/site-packages/langchain_community/tools/passio_nutrition_ai/__init__.py b/llm/Lib/site-packages/langchain_community/tools/passio_nutrition_ai/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f75469d3f107dd50c6a43ee1146edb7947dec2ca
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/passio_nutrition_ai/__init__.py
@@ -0,0 +1,5 @@
+"""Passio Nutrition AI API toolkit."""
+
+from langchain_community.tools.passio_nutrition_ai.tool import NutritionAI
+
+__all__ = ["NutritionAI"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/passio_nutrition_ai/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/passio_nutrition_ai/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..57571e342a29b2ca796f0b689dddc5840642aa84
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/passio_nutrition_ai/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/passio_nutrition_ai/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/passio_nutrition_ai/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..61777f347e43b03a119fba3cc0718038f31ec27e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/passio_nutrition_ai/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/passio_nutrition_ai/tool.py b/llm/Lib/site-packages/langchain_community/tools/passio_nutrition_ai/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..275760d4cbca01058be919a808f038a18c89e9b2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/passio_nutrition_ai/tool.py
@@ -0,0 +1,38 @@
+"""Tool for the Passio Nutrition AI API."""
+
+from typing import Dict, Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.passio_nutrition_ai import NutritionAIAPI
+
+
+class NutritionAIInputs(BaseModel):
+    """Inputs to the Passio Nutrition AI tool."""
+
+    query: str = Field(
+        description="A query to look up using Passio Nutrition AI, usually a few words."
+    )
+
+
+class NutritionAI(BaseTool):
+    """Tool that queries the Passio Nutrition AI API."""
+
+    name: str = "nutritionai_advanced_search"
+    description: str = (
+        "A wrapper around the Passio Nutrition AI. "
+        "Useful to retrieve nutrition facts. "
+        "Input should be a search query string."
+    )
+    api_wrapper: NutritionAIAPI
+    args_schema: Type[BaseModel] = NutritionAIInputs
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> Optional[Dict]:
+        """Use the tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/__init__.py b/llm/Lib/site-packages/langchain_community/tools/playwright/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f69ff8025d3a534f7e1310a1949d309dcc170e64
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/playwright/__init__.py
@@ -0,0 +1,21 @@
+"""Browser tools and toolkit."""
+
+from langchain_community.tools.playwright.click import ClickTool
+from langchain_community.tools.playwright.current_page import CurrentWebPageTool
+from langchain_community.tools.playwright.extract_hyperlinks import (
+    ExtractHyperlinksTool,
+)
+from langchain_community.tools.playwright.extract_text import ExtractTextTool
+from langchain_community.tools.playwright.get_elements import GetElementsTool
+from langchain_community.tools.playwright.navigate import NavigateTool
+from langchain_community.tools.playwright.navigate_back import NavigateBackTool
+
+__all__ = [
+    "NavigateTool",
+    "NavigateBackTool",
+    "ExtractTextTool",
+    "ExtractHyperlinksTool",
+    "GetElementsTool",
+    "ClickTool",
+    "CurrentWebPageTool",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..965069ec9160ea5bd1a9661f546217f171449f6e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ac4ae171bd682f719bebc63c57b543633daded59
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/click.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/click.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b5d5cf380057c5ef2a9a0353b545690eb27b0a64
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/click.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/current_page.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/current_page.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4c520f3ec17f513f25da6c9a0d173e31ad9c4f01
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/current_page.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/extract_hyperlinks.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/extract_hyperlinks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..881d65bb9991563f318de20cc11d2b695beb197d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/extract_hyperlinks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/extract_text.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/extract_text.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d3c405ced0adac5a7ab7c5c329fa8b3d358271eb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/extract_text.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/get_elements.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/get_elements.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e806d3e27e5ebc005aa6837331ff98e2c9921b86
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/get_elements.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/navigate.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/navigate.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f2cab1d657e915765cb11e894f9bbcc90395b563
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/navigate.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/navigate_back.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/navigate_back.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8a6ecf0a2e4a44269eec6e144d85745f0cbb2e91
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/navigate_back.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dfad404a63e722a53716a8ccbc6fd5d386c4724e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/playwright/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/base.py b/llm/Lib/site-packages/langchain_community/tools/playwright/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..d906bfea51d6be1d0d6a83432d25dc01b6fbe9b9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/playwright/base.py
@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Optional, Tuple, Type
+
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.tools import BaseTool
+
+if TYPE_CHECKING:
+    from playwright.async_api import Browser as AsyncBrowser
+    from playwright.sync_api import Browser as SyncBrowser
+else:
+    try:
+        # We do this so pydantic can resolve the types when instantiating
+        from playwright.async_api import Browser as AsyncBrowser
+        from playwright.sync_api import Browser as SyncBrowser
+    except ImportError:
+        pass
+
+
+def lazy_import_playwright_browsers() -> Tuple[Type[AsyncBrowser], Type[SyncBrowser]]:
+    """
+    Lazy import playwright browsers.
+
+    Returns:
+        Tuple[Type[AsyncBrowser], Type[SyncBrowser]]:
+            AsyncBrowser and SyncBrowser classes.
+    """
+    try:
+        from playwright.async_api import Browser as AsyncBrowser  # noqa: F401
+        from playwright.sync_api import Browser as SyncBrowser  # noqa: F401
+    except ImportError:
+        raise ImportError(
+            "The 'playwright' package is required to use the playwright tools."
+            " Please install it with 'pip install playwright'."
+        )
+    return AsyncBrowser, SyncBrowser
+
+
+class BaseBrowserTool(BaseTool):
+    """Base class for browser tools."""
+
+    sync_browser: Optional["SyncBrowser"] = None
+    async_browser: Optional["AsyncBrowser"] = None
+
+    @root_validator
+    def validate_browser_provided(cls, values: dict) -> dict:
+        """Check that the arguments are valid."""
+        lazy_import_playwright_browsers()
+        if values.get("async_browser") is None and values.get("sync_browser") is None:
+            raise ValueError("Either async_browser or sync_browser must be specified.")
+        return values
+
+    @classmethod
+    def from_browser(
+        cls,
+        sync_browser: Optional[SyncBrowser] = None,
+        async_browser: Optional[AsyncBrowser] = None,
+    ) -> BaseBrowserTool:
+        """Instantiate the tool."""
+        lazy_import_playwright_browsers()
+        return cls(sync_browser=sync_browser, async_browser=async_browser)
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/click.py b/llm/Lib/site-packages/langchain_community/tools/playwright/click.py
new file mode 100644
index 0000000000000000000000000000000000000000..5cf5cdda148ee48dc2279b40c1a2f1de50bf2ef0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/playwright/click.py
@@ -0,0 +1,87 @@
+from __future__ import annotations
+
+from typing import Optional, Type
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.playwright.base import BaseBrowserTool
+from langchain_community.tools.playwright.utils import (
+    aget_current_page,
+    get_current_page,
+)
+
+
+class ClickToolInput(BaseModel):
+    """Input for ClickTool."""
+
+    selector: str = Field(..., description="CSS selector for the element to click")
+
+
+class ClickTool(BaseBrowserTool):
+    """Tool for clicking on an element with the given CSS selector."""
+
+    name: str = "click_element"
+    description: str = "Click on an element with the given CSS selector"
+    args_schema: Type[BaseModel] = ClickToolInput
+
+    visible_only: bool = True
+    """Whether to consider only visible elements."""
+    playwright_strict: bool = False
+    """Whether to employ Playwright's strict mode when clicking on elements."""
+    playwright_timeout: float = 1_000
+    """Timeout (in ms) for Playwright to wait for element to be ready."""
+
+    def _selector_effective(self, selector: str) -> str:
+        if not self.visible_only:
+            return selector
+        return f"{selector} >> visible=1"
+
+    def _run(
+        self,
+        selector: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        if self.sync_browser is None:
+            raise ValueError(f"Synchronous browser not provided to {self.name}")
+        page = get_current_page(self.sync_browser)
+        # Navigate to the desired webpage before using this tool
+        selector_effective = self._selector_effective(selector=selector)
+        from playwright.sync_api import TimeoutError as PlaywrightTimeoutError
+
+        try:
+            page.click(
+                selector_effective,
+                strict=self.playwright_strict,
+                timeout=self.playwright_timeout,
+            )
+        except PlaywrightTimeoutError:
+            return f"Unable to click on element '{selector}'"
+        return f"Clicked element '{selector}'"
+
+    async def _arun(
+        self,
+        selector: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        if self.async_browser is None:
+            raise ValueError(f"Asynchronous browser not provided to {self.name}")
+        page = await aget_current_page(self.async_browser)
+        # Navigate to the desired webpage before using this tool
+        selector_effective = self._selector_effective(selector=selector)
+        from playwright.async_api import TimeoutError as PlaywrightTimeoutError
+
+        try:
+            await page.click(
+                selector_effective,
+                strict=self.playwright_strict,
+                timeout=self.playwright_timeout,
+            )
+        except PlaywrightTimeoutError:
+            return f"Unable to click on element '{selector}'"
+        return f"Clicked element '{selector}'"
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/current_page.py b/llm/Lib/site-packages/langchain_community/tools/playwright/current_page.py
new file mode 100644
index 0000000000000000000000000000000000000000..9ea5e0e1f9dd9ac9fc8b8590677efebb1f0407d0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/playwright/current_page.py
@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from typing import Optional, Type
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel
+
+from langchain_community.tools.playwright.base import BaseBrowserTool
+from langchain_community.tools.playwright.utils import (
+    aget_current_page,
+    get_current_page,
+)
+
+
+class CurrentWebPageTool(BaseBrowserTool):
+    """Tool for getting the URL of the current webpage."""
+
+    name: str = "current_webpage"
+    description: str = "Returns the URL of the current page"
+    args_schema: Type[BaseModel] = BaseModel
+
+    def _run(
+        self,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        if self.sync_browser is None:
+            raise ValueError(f"Synchronous browser not provided to {self.name}")
+        page = get_current_page(self.sync_browser)
+        return str(page.url)
+
+    async def _arun(
+        self,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        if self.async_browser is None:
+            raise ValueError(f"Asynchronous browser not provided to {self.name}")
+        page = await aget_current_page(self.async_browser)
+        return str(page.url)
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/extract_hyperlinks.py b/llm/Lib/site-packages/langchain_community/tools/playwright/extract_hyperlinks.py
new file mode 100644
index 0000000000000000000000000000000000000000..9c6f64911cc87935e4220b468f324964b0c3de9b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/playwright/extract_hyperlinks.py
@@ -0,0 +1,91 @@
+from __future__ import annotations
+
+import json
+from typing import TYPE_CHECKING, Any, Optional, Type
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+
+from langchain_community.tools.playwright.base import BaseBrowserTool
+from langchain_community.tools.playwright.utils import (
+    aget_current_page,
+    get_current_page,
+)
+
+if TYPE_CHECKING:
+    pass
+
+
+class ExtractHyperlinksToolInput(BaseModel):
+    """Input for ExtractHyperlinksTool."""
+
+    absolute_urls: bool = Field(
+        default=False,
+        description="Return absolute URLs instead of relative URLs",
+    )
+
+
+class ExtractHyperlinksTool(BaseBrowserTool):
+    """Extract all hyperlinks on the page."""
+
+    name: str = "extract_hyperlinks"
+    description: str = "Extract all hyperlinks on the current webpage"
+    args_schema: Type[BaseModel] = ExtractHyperlinksToolInput
+
+    @root_validator
+    def check_bs_import(cls, values: dict) -> dict:
+        """Check that the arguments are valid."""
+        try:
+            from bs4 import BeautifulSoup  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "The 'beautifulsoup4' package is required to use this tool."
+                " Please install it with 'pip install beautifulsoup4'."
+            )
+        return values
+
+    @staticmethod
+    def scrape_page(page: Any, html_content: str, absolute_urls: bool) -> str:
+        from urllib.parse import urljoin
+
+        from bs4 import BeautifulSoup
+
+        # Parse the HTML content with BeautifulSoup
+        soup = BeautifulSoup(html_content, "lxml")
+
+        # Find all the anchor elements and extract their href attributes
+        anchors = soup.find_all("a")
+        if absolute_urls:
+            base_url = page.url
+            links = [urljoin(base_url, anchor.get("href", "")) for anchor in anchors]
+        else:
+            links = [anchor.get("href", "") for anchor in anchors]
+        # Return the list of links as a JSON string
+        return json.dumps(links)
+
+    def _run(
+        self,
+        absolute_urls: bool = False,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        if self.sync_browser is None:
+            raise ValueError(f"Synchronous browser not provided to {self.name}")
+        page = get_current_page(self.sync_browser)
+        html_content = page.content()
+        return self.scrape_page(page, html_content, absolute_urls)
+
+    async def _arun(
+        self,
+        absolute_urls: bool = False,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+        if self.async_browser is None:
+            raise ValueError(f"Asynchronous browser not provided to {self.name}")
+        page = await aget_current_page(self.async_browser)
+        html_content = await page.content()
+        return self.scrape_page(page, html_content, absolute_urls)
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/extract_text.py b/llm/Lib/site-packages/langchain_community/tools/playwright/extract_text.py
new file mode 100644
index 0000000000000000000000000000000000000000..4f01ea925d0b4e94dbbfe93bf8b76b5984d56ea2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/playwright/extract_text.py
@@ -0,0 +1,68 @@
+from __future__ import annotations
+
+from typing import Optional, Type
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+from langchain_community.tools.playwright.base import BaseBrowserTool
+from langchain_community.tools.playwright.utils import (
+    aget_current_page,
+    get_current_page,
+)
+
+
+class ExtractTextTool(BaseBrowserTool):
+    """Tool for extracting all the text on the current webpage."""
+
+    name: str = "extract_text"
+    description: str = "Extract all the text on the current webpage"
+    args_schema: Type[BaseModel] = BaseModel
+
+    @root_validator
+    def check_acheck_bs_importrgs(cls, values: dict) -> dict:
+        """Check that the arguments are valid."""
+        try:
+            from bs4 import BeautifulSoup  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "The 'beautifulsoup4' package is required to use this tool."
+                " Please install it with 'pip install beautifulsoup4'."
+            )
+        return values
+
+    def _run(self, run_manager: Optional[CallbackManagerForToolRun] = None) -> str:
+        """Use the tool."""
+        # Use Beautiful Soup since it's faster than looping through the elements
+        from bs4 import BeautifulSoup
+
+        if self.sync_browser is None:
+            raise ValueError(f"Synchronous browser not provided to {self.name}")
+
+        page = get_current_page(self.sync_browser)
+        html_content = page.content()
+
+        # Parse the HTML content with BeautifulSoup
+        soup = BeautifulSoup(html_content, "lxml")
+
+        return " ".join(text for text in soup.stripped_strings)
+
+    async def _arun(
+        self, run_manager: Optional[AsyncCallbackManagerForToolRun] = None
+    ) -> str:
+        """Use the tool."""
+        if self.async_browser is None:
+            raise ValueError(f"Asynchronous browser not provided to {self.name}")
+        # Use Beautiful Soup since it's faster than looping through the elements
+        from bs4 import BeautifulSoup
+
+        page = await aget_current_page(self.async_browser)
+        html_content = await page.content()
+
+        # Parse the HTML content with BeautifulSoup
+        soup = BeautifulSoup(html_content, "lxml")
+
+        return " ".join(text for text in soup.stripped_strings)
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/get_elements.py b/llm/Lib/site-packages/langchain_community/tools/playwright/get_elements.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b88529fc75888338ff95de9dbdda64008d3d249
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/playwright/get_elements.py
@@ -0,0 +1,111 @@
+from __future__ import annotations
+
+import json
+from typing import TYPE_CHECKING, List, Optional, Sequence, Type
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.playwright.base import BaseBrowserTool
+from langchain_community.tools.playwright.utils import (
+    aget_current_page,
+    get_current_page,
+)
+
+if TYPE_CHECKING:
+    from playwright.async_api import Page as AsyncPage
+    from playwright.sync_api import Page as SyncPage
+
+
+class GetElementsToolInput(BaseModel):
+    """Input for GetElementsTool."""
+
+    selector: str = Field(
+        ...,
+        description="CSS selector, such as '*', 'div', 'p', 'a', #id, .classname",
+    )
+    attributes: List[str] = Field(
+        default_factory=lambda: ["innerText"],
+        description="Set of attributes to retrieve for each element",
+    )
+
+
+async def _aget_elements(
+    page: AsyncPage, selector: str, attributes: Sequence[str]
+) -> List[dict]:
+    """Get elements matching the given CSS selector."""
+    elements = await page.query_selector_all(selector)
+    results = []
+    for element in elements:
+        result = {}
+        for attribute in attributes:
+            if attribute == "innerText":
+                val: Optional[str] = await element.inner_text()
+            else:
+                val = await element.get_attribute(attribute)
+            if val is not None and val.strip() != "":
+                result[attribute] = val
+        if result:
+            results.append(result)
+    return results
+
+
+def _get_elements(
+    page: SyncPage, selector: str, attributes: Sequence[str]
+) -> List[dict]:
+    """Get elements matching the given CSS selector."""
+    elements = page.query_selector_all(selector)
+    results = []
+    for element in elements:
+        result = {}
+        for attribute in attributes:
+            if attribute == "innerText":
+                val: Optional[str] = element.inner_text()
+            else:
+                val = element.get_attribute(attribute)
+            if val is not None and val.strip() != "":
+                result[attribute] = val
+        if result:
+            results.append(result)
+    return results
+
+
+class GetElementsTool(BaseBrowserTool):
+    """Tool for getting elements in the current web page matching a CSS selector."""
+
+    name: str = "get_elements"
+    description: str = (
+        "Retrieve elements in the current web page matching the given CSS selector"
+    )
+    args_schema: Type[BaseModel] = GetElementsToolInput
+
+    def _run(
+        self,
+        selector: str,
+        attributes: Sequence[str] = ["innerText"],
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        if self.sync_browser is None:
+            raise ValueError(f"Synchronous browser not provided to {self.name}")
+        page = get_current_page(self.sync_browser)
+        # Navigate to the desired webpage before using this tool
+        results = _get_elements(page, selector, attributes)
+        return json.dumps(results, ensure_ascii=False)
+
+    async def _arun(
+        self,
+        selector: str,
+        attributes: Sequence[str] = ["innerText"],
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        if self.async_browser is None:
+            raise ValueError(f"Asynchronous browser not provided to {self.name}")
+        page = await aget_current_page(self.async_browser)
+        # Navigate to the desired webpage before using this tool
+        results = await _aget_elements(page, selector, attributes)
+        return json.dumps(results, ensure_ascii=False)
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/navigate.py b/llm/Lib/site-packages/langchain_community/tools/playwright/navigate.py
new file mode 100644
index 0000000000000000000000000000000000000000..82f6349ff064a72a07885ca0cd31a930b4827c9b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/playwright/navigate.py
@@ -0,0 +1,81 @@
+from __future__ import annotations
+
+from typing import Optional, Type
+from urllib.parse import urlparse
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field, validator
+
+from langchain_community.tools.playwright.base import BaseBrowserTool
+from langchain_community.tools.playwright.utils import (
+    aget_current_page,
+    get_current_page,
+)
+
+
+class NavigateToolInput(BaseModel):
+    """Input for NavigateToolInput."""
+
+    url: str = Field(..., description="url to navigate to")
+
+    @validator("url")
+    def validate_url_scheme(cls, url: str) -> str:
+        """Check that the URL scheme is valid."""
+        parsed_url = urlparse(url)
+        if parsed_url.scheme not in ("http", "https"):
+            raise ValueError("URL scheme must be 'http' or 'https'")
+        return url
+
+
+class NavigateTool(BaseBrowserTool):
+    """Tool for navigating a browser to a URL.
+
+    **Security Note**: This tool provides code to control web-browser navigation.
+
+        This tool can navigate to any URL, including internal network URLs, and
+        URLs exposed on the server itself.
+
+        However, if exposing this tool to end-users, consider limiting network
+        access to the server that hosts the agent.
+
+        By default, the URL scheme has been limited to 'http' and 'https' to
+        prevent navigation to local file system URLs (or other schemes).
+
+        If access to the local file system is required, consider creating a custom
+        tool or providing a custom args_schema that allows the desired URL schemes.
+
+        See https://python.langchain.com/docs/security for more information.
+    """
+
+    name: str = "navigate_browser"
+    description: str = "Navigate a browser to the specified URL"
+    args_schema: Type[BaseModel] = NavigateToolInput
+
+    def _run(
+        self,
+        url: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        if self.sync_browser is None:
+            raise ValueError(f"Synchronous browser not provided to {self.name}")
+        page = get_current_page(self.sync_browser)
+        response = page.goto(url)
+        status = response.status if response else "unknown"
+        return f"Navigating to {url} returned status code {status}"
+
+    async def _arun(
+        self,
+        url: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        if self.async_browser is None:
+            raise ValueError(f"Asynchronous browser not provided to {self.name}")
+        page = await aget_current_page(self.async_browser)
+        response = await page.goto(url)
+        status = response.status if response else "unknown"
+        return f"Navigating to {url} returned status code {status}"
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/navigate_back.py b/llm/Lib/site-packages/langchain_community/tools/playwright/navigate_back.py
new file mode 100644
index 0000000000000000000000000000000000000000..5988fa7fe894aa122d18d8c93b1959f24e286667
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/playwright/navigate_back.py
@@ -0,0 +1,56 @@
+from __future__ import annotations
+
+from typing import Optional, Type
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel
+
+from langchain_community.tools.playwright.base import BaseBrowserTool
+from langchain_community.tools.playwright.utils import (
+    aget_current_page,
+    get_current_page,
+)
+
+
+class NavigateBackTool(BaseBrowserTool):
+    """Navigate back to the previous page in the browser history."""
+
+    name: str = "previous_webpage"
+    description: str = "Navigate back to the previous page in the browser history"
+    args_schema: Type[BaseModel] = BaseModel
+
+    def _run(self, run_manager: Optional[CallbackManagerForToolRun] = None) -> str:
+        """Use the tool."""
+        if self.sync_browser is None:
+            raise ValueError(f"Synchronous browser not provided to {self.name}")
+        page = get_current_page(self.sync_browser)
+        response = page.go_back()
+
+        if response:
+            return (
+                f"Navigated back to the previous page with URL '{response.url}'."
+                f" Status code {response.status}"
+            )
+        else:
+            return "Unable to navigate back; no previous page in the history"
+
+    async def _arun(
+        self,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        if self.async_browser is None:
+            raise ValueError(f"Asynchronous browser not provided to {self.name}")
+        page = await aget_current_page(self.async_browser)
+        response = await page.go_back()
+
+        if response:
+            return (
+                f"Navigated back to the previous page with URL '{response.url}'."
+                f" Status code {response.status}"
+            )
+        else:
+            return "Unable to navigate back; no previous page in the history"
diff --git a/llm/Lib/site-packages/langchain_community/tools/playwright/utils.py b/llm/Lib/site-packages/langchain_community/tools/playwright/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..692288fdde3187da0364cad8442a758bdb0f292f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/playwright/utils.py
@@ -0,0 +1,104 @@
+"""Utilities for the Playwright browser tools."""
+from __future__ import annotations
+
+import asyncio
+from typing import TYPE_CHECKING, Any, Coroutine, List, Optional, TypeVar
+
+if TYPE_CHECKING:
+    from playwright.async_api import Browser as AsyncBrowser
+    from playwright.async_api import Page as AsyncPage
+    from playwright.sync_api import Browser as SyncBrowser
+    from playwright.sync_api import Page as SyncPage
+
+
+async def aget_current_page(browser: AsyncBrowser) -> AsyncPage:
+    """
+    Asynchronously get the current page of the browser.
+
+    Args:
+        browser: The browser (AsyncBrowser) to get the current page from.
+
+    Returns:
+        AsyncPage: The current page.
+    """
+    if not browser.contexts:
+        context = await browser.new_context()
+        return await context.new_page()
+    context = browser.contexts[0]  # Assuming you're using the default browser context
+    if not context.pages:
+        return await context.new_page()
+    # Assuming the last page in the list is the active one
+    return context.pages[-1]
+
+
+def get_current_page(browser: SyncBrowser) -> SyncPage:
+    """
+    Get the current page of the browser.
+    Args:
+        browser: The browser to get the current page from.
+
+    Returns:
+        SyncPage: The current page.
+    """
+    if not browser.contexts:
+        context = browser.new_context()
+        return context.new_page()
+    context = browser.contexts[0]  # Assuming you're using the default browser context
+    if not context.pages:
+        return context.new_page()
+    # Assuming the last page in the list is the active one
+    return context.pages[-1]
+
+
+def create_async_playwright_browser(
+    headless: bool = True, args: Optional[List[str]] = None
+) -> AsyncBrowser:
+    """
+    Create an async playwright browser.
+
+    Args:
+        headless: Whether to run the browser in headless mode. Defaults to True.
+        args: arguments to pass to browser.chromium.launch
+
+    Returns:
+        AsyncBrowser: The playwright browser.
+    """
+    from playwright.async_api import async_playwright
+
+    browser = run_async(async_playwright().start())
+    return run_async(browser.chromium.launch(headless=headless, args=args))
+
+
+def create_sync_playwright_browser(
+    headless: bool = True, args: Optional[List[str]] = None
+) -> SyncBrowser:
+    """
+    Create a playwright browser.
+
+    Args:
+        headless: Whether to run the browser in headless mode. Defaults to True.
+        args: arguments to pass to browser.chromium.launch
+
+    Returns:
+        SyncBrowser: The playwright browser.
+    """
+    from playwright.sync_api import sync_playwright
+
+    browser = sync_playwright().start()
+    return browser.chromium.launch(headless=headless, args=args)
+
+
+T = TypeVar("T")
+
+
+def run_async(coro: Coroutine[Any, Any, T]) -> T:
+    """Run an async coroutine.
+
+    Args:
+        coro: The coroutine to run. Coroutine[Any, Any, T]
+
+    Returns:
+        T: The result of the coroutine.
+    """
+    event_loop = asyncio.get_event_loop()
+    return event_loop.run_until_complete(coro)
diff --git a/llm/Lib/site-packages/langchain_community/tools/plugin.py b/llm/Lib/site-packages/langchain_community/tools/plugin.py
new file mode 100644
index 0000000000000000000000000000000000000000..0966ed5bedee2909cb59abffde420e2ed7ada7b2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/plugin.py
@@ -0,0 +1,110 @@
+from __future__ import annotations
+
+import json
+from typing import Optional, Type
+
+import requests
+import yaml
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.tools import BaseTool
+
+
+class ApiConfig(BaseModel):
+    """API Configuration."""
+
+    type: str
+    url: str
+    has_user_authentication: Optional[bool] = False
+
+
+class AIPlugin(BaseModel):
+    """AI Plugin Definition."""
+
+    schema_version: str
+    name_for_model: str
+    name_for_human: str
+    description_for_model: str
+    description_for_human: str
+    auth: Optional[dict] = None
+    api: ApiConfig
+    logo_url: Optional[str]
+    contact_email: Optional[str]
+    legal_info_url: Optional[str]
+
+    @classmethod
+    def from_url(cls, url: str) -> AIPlugin:
+        """Instantiate AIPlugin from a URL."""
+        response = requests.get(url).json()
+        return cls(**response)
+
+
+def marshal_spec(txt: str) -> dict:
+    """Convert the yaml or json serialized spec to a dict.
+
+    Args:
+        txt: The yaml or json serialized spec.
+
+    Returns:
+        dict: The spec as a dict.
+    """
+    try:
+        return json.loads(txt)
+    except json.JSONDecodeError:
+        return yaml.safe_load(txt)
+
+
+class AIPluginToolSchema(BaseModel):
+    """Schema for AIPluginTool."""
+
+    tool_input: Optional[str] = ""
+
+
+class AIPluginTool(BaseTool):
+    """Tool for getting the OpenAPI spec for an AI Plugin."""
+
+    plugin: AIPlugin
+    api_spec: str
+    args_schema: Type[AIPluginToolSchema] = AIPluginToolSchema
+
+    @classmethod
+    def from_plugin_url(cls, url: str) -> AIPluginTool:
+        plugin = AIPlugin.from_url(url)
+        description = (
+            f"Call this tool to get the OpenAPI spec (and usage guide) "
+            f"for interacting with the {plugin.name_for_human} API. "
+            f"You should only call this ONCE! What is the "
+            f"{plugin.name_for_human} API useful for? "
+        ) + plugin.description_for_human
+        open_api_spec_str = requests.get(plugin.api.url).text
+        open_api_spec = marshal_spec(open_api_spec_str)
+        api_spec = (
+            f"Usage Guide: {plugin.description_for_model}\n\n"
+            f"OpenAPI Spec: {open_api_spec}"
+        )
+
+        return cls(
+            name=plugin.name_for_model,
+            description=description,
+            plugin=plugin,
+            api_spec=api_spec,
+        )
+
+    def _run(
+        self,
+        tool_input: Optional[str] = "",
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.api_spec
+
+    async def _arun(
+        self,
+        tool_input: Optional[str] = None,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+        return self.api_spec
diff --git a/llm/Lib/site-packages/langchain_community/tools/polygon/__init__.py b/llm/Lib/site-packages/langchain_community/tools/polygon/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..87a9c1c13571c1ae2e5549bd130e28e9dc038b65
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/polygon/__init__.py
@@ -0,0 +1,13 @@
+"""Polygon IO tools."""
+
+from langchain_community.tools.polygon.aggregates import PolygonAggregates
+from langchain_community.tools.polygon.financials import PolygonFinancials
+from langchain_community.tools.polygon.last_quote import PolygonLastQuote
+from langchain_community.tools.polygon.ticker_news import PolygonTickerNews
+
+__all__ = [
+    "PolygonAggregates",
+    "PolygonFinancials",
+    "PolygonLastQuote",
+    "PolygonTickerNews",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6a11da9ccda8c12ae6f0caf8d72ef42ec5773b5c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/aggregates.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/aggregates.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..103aac1a03ad70cb6e5839c8bf434b15b1529b8a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/aggregates.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/financials.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/financials.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..251317318c70ae23ea6007a8d5208d9c36e01f90
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/financials.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/last_quote.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/last_quote.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..864f97959c5bc6fee0e682110c48014103c7e8de
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/last_quote.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/ticker_news.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/ticker_news.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..826904765d5a73667dfb53bc7b64e159531070aa
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/polygon/__pycache__/ticker_news.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/polygon/aggregates.py b/llm/Lib/site-packages/langchain_community/tools/polygon/aggregates.py
new file mode 100644
index 0000000000000000000000000000000000000000..e4c07761727f9a634b3558fd14aa0d8d05bd4818
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/polygon/aggregates.py
@@ -0,0 +1,77 @@
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.polygon import PolygonAPIWrapper
+
+
+class PolygonAggregatesSchema(BaseModel):
+    """Input for PolygonAggregates."""
+
+    ticker: str = Field(
+        description="The ticker symbol to fetch aggregates for.",
+    )
+    timespan: str = Field(
+        description="The size of the time window. "
+        "Possible values are: "
+        "second, minute, hour, day, week, month, quarter, year. "
+        "Default is 'day'",
+    )
+    timespan_multiplier: int = Field(
+        description="The number of timespans to aggregate. "
+        "For example, if timespan is 'day' and "
+        "timespan_multiplier is 1, the result will be daily bars. "
+        "If timespan is 'day' and timespan_multiplier is 5, "
+        "the result will be weekly bars.  "
+        "Default is 1.",
+    )
+    from_date: str = Field(
+        description="The start of the aggregate time window. "
+        "Either a date with the format YYYY-MM-DD or "
+        "a millisecond timestamp.",
+    )
+    to_date: str = Field(
+        description="The end of the aggregate time window. "
+        "Either a date with the format YYYY-MM-DD or "
+        "a millisecond timestamp.",
+    )
+
+
+class PolygonAggregates(BaseTool):
+    """
+    Tool that gets aggregate bars (stock prices) over a
+    given date range for a given ticker from Polygon.
+    """
+
+    mode: str = "get_aggregates"
+    name: str = "polygon_aggregates"
+    description: str = (
+        "A wrapper around Polygon's Aggregates API. "
+        "This tool is useful for fetching aggregate bars (stock prices) for a ticker. "
+        "Input should be the ticker, date range, timespan, and timespan multiplier"
+        " that you want to get the aggregate bars for."
+    )
+    args_schema: Type[PolygonAggregatesSchema] = PolygonAggregatesSchema
+
+    api_wrapper: PolygonAPIWrapper
+
+    def _run(
+        self,
+        ticker: str,
+        timespan: str,
+        timespan_multiplier: int,
+        from_date: str,
+        to_date: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Polygon API tool."""
+        return self.api_wrapper.run(
+            mode=self.mode,
+            ticker=ticker,
+            timespan=timespan,
+            timespan_multiplier=timespan_multiplier,
+            from_date=from_date,
+            to_date=to_date,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/tools/polygon/financials.py b/llm/Lib/site-packages/langchain_community/tools/polygon/financials.py
new file mode 100644
index 0000000000000000000000000000000000000000..aae19cad06ab7e36b76bc1693d1ad2ec443843eb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/polygon/financials.py
@@ -0,0 +1,38 @@
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.polygon import PolygonAPIWrapper
+
+
+class Inputs(BaseModel):
+    """Inputs for Polygon's Financials API"""
+
+    query: str
+
+
+class PolygonFinancials(BaseTool):
+    """Tool that gets the financials of a ticker from Polygon"""
+
+    mode: str = "get_financials"
+    name: str = "polygon_financials"
+    description: str = (
+        "A wrapper around Polygon's Stock Financials API. "
+        "This tool is useful for fetching fundamental financials from "
+        "balance sheets, income statements, and cash flow statements "
+        "for a stock ticker. The input should be the ticker that you want "
+        "to get the latest fundamental financial data for."
+    )
+    args_schema: Type[BaseModel] = Inputs
+
+    api_wrapper: PolygonAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Polygon API tool."""
+        return self.api_wrapper.run(self.mode, ticker=query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/polygon/last_quote.py b/llm/Lib/site-packages/langchain_community/tools/polygon/last_quote.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce6ebe750ea573787209fdb4e87c481cc676fe1c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/polygon/last_quote.py
@@ -0,0 +1,36 @@
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.polygon import PolygonAPIWrapper
+
+
+class Inputs(BaseModel):
+    """Inputs for Polygon's Last Quote API"""
+
+    query: str
+
+
+class PolygonLastQuote(BaseTool):
+    """Tool that gets the last quote of a ticker from Polygon"""
+
+    mode: str = "get_last_quote"
+    name: str = "polygon_last_quote"
+    description: str = (
+        "A wrapper around Polygon's Last Quote API. "
+        "This tool is useful for fetching the latest price of a stock. "
+        "Input should be the ticker that you want to query the last price quote for."
+    )
+    args_schema: Type[BaseModel] = Inputs
+
+    api_wrapper: PolygonAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Polygon API tool."""
+        return self.api_wrapper.run(self.mode, ticker=query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/polygon/ticker_news.py b/llm/Lib/site-packages/langchain_community/tools/polygon/ticker_news.py
new file mode 100644
index 0000000000000000000000000000000000000000..9d858ebc8f4984808b85e29bac044a30d2982408
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/polygon/ticker_news.py
@@ -0,0 +1,36 @@
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.polygon import PolygonAPIWrapper
+
+
+class Inputs(BaseModel):
+    """Inputs for Polygon's Ticker News API"""
+
+    query: str
+
+
+class PolygonTickerNews(BaseTool):
+    """Tool that gets the latest news for a given ticker from Polygon"""
+
+    mode: str = "get_ticker_news"
+    name: str = "polygon_ticker_news"
+    description: str = (
+        "A wrapper around Polygon's Ticker News API. "
+        "This tool is useful for fetching the latest news for a stock. "
+        "Input should be the ticker that you want to get the latest news for."
+    )
+    args_schema: Type[BaseModel] = Inputs
+
+    api_wrapper: PolygonAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Polygon API tool."""
+        return self.api_wrapper.run(self.mode, ticker=query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/powerbi/__init__.py b/llm/Lib/site-packages/langchain_community/tools/powerbi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ecc25a12f5797be27d45a53eea09834d9f2ba24
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/powerbi/__init__.py
@@ -0,0 +1 @@
+"""Tools for interacting with a PowerBI dataset."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/powerbi/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/powerbi/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b259e2201b7b9ee23b1b6aa00fdbf2a76666d86
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/powerbi/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/powerbi/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/powerbi/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..02b4c7da6924e67ac58d6c442ad8ebad583b43df
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/powerbi/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/powerbi/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/powerbi/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..913642b9b1db87347c76f2682d4cac19c94aea34
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/powerbi/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/powerbi/prompt.py b/llm/Lib/site-packages/langchain_community/tools/powerbi/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..caf32756acaadd4aa7240a80091b0573b2d7b6fd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/powerbi/prompt.py
@@ -0,0 +1,70 @@
+# flake8: noqa
+QUESTION_TO_QUERY_BASE = """
+Answer the question below with a DAX query that can be sent to Power BI. DAX queries have a simple syntax comprised of just one required keyword, EVALUATE, and several optional keywords: ORDER BY, START AT, DEFINE, MEASURE, VAR, TABLE, and COLUMN. Each keyword defines a statement used for the duration of the query. Any time < or > are used in the text below it means that those values need to be replaced by table, columns or other things. If the question is not something you can answer with a DAX query, reply with "I cannot answer this" and the question will be escalated to a human.
+
+Some DAX functions return a table instead of a scalar, and must be wrapped in a function that evaluates the table and returns a scalar; unless the table is a single column, single row table, then it is treated as a scalar value. Most DAX functions require one or more arguments, which can include tables, columns, expressions, and values. However, some functions, such as PI, do not require any arguments, but always require parentheses to indicate the null argument. For example, you must always type PI(), not PI. You can also nest functions within other functions. 
+
+Some commonly used functions are:
+EVALUATE <table> - At the most basic level, a DAX query is an EVALUATE statement containing a table expression. At least one EVALUATE statement is required, however, a query can contain any number of EVALUATE statements.
+EVALUATE <table> ORDER BY <expression> ASC or DESC - The optional ORDER BY keyword defines one or more expressions used to sort query results. Any expression that can be evaluated for each row of the result is valid.
+EVALUATE <table> ORDER BY <expression> ASC or DESC START AT <value> or <parameter> - The optional START AT keyword is used inside an ORDER BY clause. It defines the value at which the query results begin.
+DEFINE MEASURE | VAR; EVALUATE <table> - The optional DEFINE keyword introduces one or more calculated entity definitions that exist only for the duration of the query. Definitions precede the EVALUATE statement and are valid for all EVALUATE statements in the query. Definitions can be variables, measures, tables1, and columns1. Definitions can reference other definitions that appear before or after the current definition. At least one definition is required if the DEFINE keyword is included in a query.
+MEASURE <table name>[<measure name>] = <scalar expression> - Introduces a measure definition in a DEFINE statement of a DAX query.
+VAR <name> = <expression> - Stores the result of an expression as a named variable, which can then be passed as an argument to other measure expressions. Once resultant values have been calculated for a variable expression, those values do not change, even if the variable is referenced in another expression.
+
+FILTER(<table>,<filter>) - Returns a table that represents a subset of another table or expression, where <filter> is a Boolean expression that is to be evaluated for each row of the table. For example, [Amount] > 0 or [Region] = "France"
+ROW(<name>, <expression>) - Returns a table with a single row containing values that result from the expressions given to each column.
+TOPN(<n>, <table>, <OrderBy_Expression>, <Order>) - Returns a table with the top n rows from the specified table, sorted by the specified expression, in the order specified by 0 for descending, 1 for ascending, the default is 0. Multiple OrderBy_Expressions and Order pairs can be given, separated by a comma.
+DISTINCT(<column>) - Returns a one-column table that contains the distinct values from the specified column. In other words, duplicate values are removed and only unique values are returned. This function cannot be used to Return values into a cell or column on a worksheet; rather, you nest the DISTINCT function within a formula, to get a list of distinct values that can be passed to another function and then counted, summed, or used for other operations.
+DISTINCT(<table>) - Returns a table by removing duplicate rows from another table or expression.
+
+Aggregation functions, names with a A in it, handle booleans and empty strings in appropriate ways, while the same function without A only uses the numeric values in a column. Functions names with an X in it can include a expression as an argument, this will be evaluated for each row in the table and the result will be used in the regular function calculation, these are the functions:
+COUNT(<column>), COUNTA(<column>), COUNTX(<table>,<expression>), COUNTAX(<table>,<expression>), COUNTROWS([<table>]), COUNTBLANK(<column>), DISTINCTCOUNT(<column>), DISTINCTCOUNTNOBLANK (<column>) - these are all variations of count functions.
+AVERAGE(<column>), AVERAGEA(<column>), AVERAGEX(<table>,<expression>) - these are all variations of average functions.
+MAX(<column>), MAXA(<column>), MAXX(<table>,<expression>) - these are all variations of max functions.
+MIN(<column>), MINA(<column>), MINX(<table>,<expression>) - these are all variations of min functions.
+PRODUCT(<column>), PRODUCTX(<table>,<expression>) - these are all variations of product functions.
+SUM(<column>), SUMX(<table>,<expression>) - these are all variations of sum functions.
+
+Date and time functions:
+DATE(year, month, day) - Returns a date value that represents the specified year, month, and day.
+DATEDIFF(date1, date2, <interval>) - Returns the difference between two date values, in the specified interval, that can be SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER, YEAR.
+DATEVALUE(<date_text>) - Returns a date value that represents the specified date.
+YEAR(<date>), QUARTER(<date>), MONTH(<date>), DAY(<date>), HOUR(<date>), MINUTE(<date>), SECOND(<date>) - Returns the part of the date for the specified date.
+
+Finally, make sure to escape double quotes with a single backslash, and make sure that only table names have single quotes around them, while names of measures or the values of columns that you want to compare against are in escaped double quotes. Newlines are not necessary and can be skipped. The queries are serialized as json and so will have to fit be compliant with json syntax. Sometimes you will get a question, a DAX query and a error, in that case you need to rewrite the DAX query to get the correct answer.
+
+The following tables exist: {tables}
+
+and the schema's for some are given here:
+{schemas}
+
+Examples:
+{examples}
+"""
+
+USER_INPUT = """
+Question: {tool_input}
+DAX: 
+"""
+
+SINGLE_QUESTION_TO_QUERY = f"{QUESTION_TO_QUERY_BASE}{USER_INPUT}"
+
+DEFAULT_FEWSHOT_EXAMPLES = """
+Question: How many rows are in the table <table>?
+DAX: EVALUATE ROW(\"Number of rows\", COUNTROWS(<table>))
+----
+Question: How many rows are in the table <table> where <column> is not empty?
+DAX: EVALUATE ROW(\"Number of rows\", COUNTROWS(FILTER(<table>, <table>[<column>] <> \"\")))
+----
+Question: What was the average of <column> in <table>?
+DAX: EVALUATE ROW(\"Average\", AVERAGE(<table>[<column>]))
+----
+"""
+
+RETRY_RESPONSE = (
+    "{tool_input} DAX: {query} Error: {error}. Please supply a new DAX query."
+)
+BAD_REQUEST_RESPONSE = "Error on this question, the error was {error}, you can try to rephrase the question."
+SCHEMA_ERROR_RESPONSE = "Bad request, are you sure the table name is correct?"
+UNAUTHORIZED_RESPONSE = "Unauthorized. Try changing your authentication, do not retry."
diff --git a/llm/Lib/site-packages/langchain_community/tools/powerbi/tool.py b/llm/Lib/site-packages/langchain_community/tools/powerbi/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..9f54ec453d4b6c5264fe9f7d72ac01748bf40db9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/powerbi/tool.py
@@ -0,0 +1,276 @@
+"""Tools for interacting with a Power BI dataset."""
+import logging
+from time import perf_counter
+from typing import Any, Dict, Optional, Tuple
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import Field, validator
+from langchain_core.tools import BaseTool
+
+from langchain_community.chat_models.openai import _import_tiktoken
+from langchain_community.tools.powerbi.prompt import (
+    BAD_REQUEST_RESPONSE,
+    DEFAULT_FEWSHOT_EXAMPLES,
+    RETRY_RESPONSE,
+)
+from langchain_community.utilities.powerbi import PowerBIDataset, json_to_md
+
+logger = logging.getLogger(__name__)
+
+
+class QueryPowerBITool(BaseTool):
+    """Tool for querying a Power BI Dataset."""
+
+    name: str = "query_powerbi"
+    description: str = """
+    Input to this tool is a detailed question about the dataset, output is a result from the dataset. It will try to answer the question using the dataset, and if it cannot, it will ask for clarification.
+
+    Example Input: "How many rows are in table1?"
+    """  # noqa: E501
+    llm_chain: Any
+    powerbi: PowerBIDataset = Field(exclude=True)
+    examples: Optional[str] = DEFAULT_FEWSHOT_EXAMPLES
+    session_cache: Dict[str, Any] = Field(default_factory=dict, exclude=True)
+    max_iterations: int = 5
+    output_token_limit: int = 4000
+    tiktoken_model_name: Optional[str] = None  # "cl100k_base"
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @validator("llm_chain")
+    def validate_llm_chain_input_variables(  # pylint: disable=E0213
+        cls, llm_chain: Any
+    ) -> Any:
+        """Make sure the LLM chain has the correct input variables."""
+        for var in llm_chain.prompt.input_variables:
+            if var not in ["tool_input", "tables", "schemas", "examples"]:
+                raise ValueError(
+                    "LLM chain for QueryPowerBITool must have input variables ['tool_input', 'tables', 'schemas', 'examples'], found %s",  # noqa: C0301 E501 # pylint: disable=C0301
+                    llm_chain.prompt.input_variables,
+                )
+        return llm_chain
+
+    def _check_cache(self, tool_input: str) -> Optional[str]:
+        """Check if the input is present in the cache.
+
+        If the value is a bad request, overwrite with the escalated version,
+        if not present return None."""
+        if tool_input not in self.session_cache:
+            return None
+        return self.session_cache[tool_input]
+
+    def _run(
+        self,
+        tool_input: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Execute the query, return the results or an error message."""
+        if cache := self._check_cache(tool_input):
+            logger.debug("Found cached result for %s: %s", tool_input, cache)
+            return cache
+
+        try:
+            logger.info("Running PBI Query Tool with input: %s", tool_input)
+            query = self.llm_chain.predict(
+                tool_input=tool_input,
+                tables=self.powerbi.get_table_names(),
+                schemas=self.powerbi.get_schemas(),
+                examples=self.examples,
+                callbacks=run_manager.get_child() if run_manager else None,
+            )
+        except Exception as exc:  # pylint: disable=broad-except
+            self.session_cache[tool_input] = f"Error on call to LLM: {exc}"
+            return self.session_cache[tool_input]
+        if query == "I cannot answer this":
+            self.session_cache[tool_input] = query
+            return self.session_cache[tool_input]
+        logger.info("PBI Query:\n%s", query)
+        start_time = perf_counter()
+        pbi_result = self.powerbi.run(command=query)
+        end_time = perf_counter()
+        logger.debug("PBI Result: %s", pbi_result)
+        logger.debug(f"PBI Query duration: {end_time - start_time:0.6f}")
+        result, error = self._parse_output(pbi_result)
+        if error is not None and "TokenExpired" in error:
+            self.session_cache[
+                tool_input
+            ] = "Authentication token expired or invalid, please try reauthenticate."
+            return self.session_cache[tool_input]
+
+        iterations = kwargs.get("iterations", 0)
+        if error and iterations < self.max_iterations:
+            return self._run(
+                tool_input=RETRY_RESPONSE.format(
+                    tool_input=tool_input, query=query, error=error
+                ),
+                run_manager=run_manager,
+                iterations=iterations + 1,
+            )
+
+        self.session_cache[tool_input] = (
+            result if result else BAD_REQUEST_RESPONSE.format(error=error)
+        )
+        return self.session_cache[tool_input]
+
+    async def _arun(
+        self,
+        tool_input: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Execute the query, return the results or an error message."""
+        if cache := self._check_cache(tool_input):
+            logger.debug("Found cached result for %s: %s", tool_input, cache)
+            return f"{cache}, from cache, you have already asked this question."
+        try:
+            logger.info("Running PBI Query Tool with input: %s", tool_input)
+            query = await self.llm_chain.apredict(
+                tool_input=tool_input,
+                tables=self.powerbi.get_table_names(),
+                schemas=self.powerbi.get_schemas(),
+                examples=self.examples,
+                callbacks=run_manager.get_child() if run_manager else None,
+            )
+        except Exception as exc:  # pylint: disable=broad-except
+            self.session_cache[tool_input] = f"Error on call to LLM: {exc}"
+            return self.session_cache[tool_input]
+
+        if query == "I cannot answer this":
+            self.session_cache[tool_input] = query
+            return self.session_cache[tool_input]
+        logger.info("PBI Query: %s", query)
+        start_time = perf_counter()
+        pbi_result = await self.powerbi.arun(command=query)
+        end_time = perf_counter()
+        logger.debug("PBI Result: %s", pbi_result)
+        logger.debug(f"PBI Query duration: {end_time - start_time:0.6f}")
+        result, error = self._parse_output(pbi_result)
+        if error is not None and ("TokenExpired" in error or "TokenError" in error):
+            self.session_cache[
+                tool_input
+            ] = "Authentication token expired or invalid, please try to reauthenticate or check the scope of the credential."  # noqa: E501
+            return self.session_cache[tool_input]
+
+        iterations = kwargs.get("iterations", 0)
+        if error and iterations < self.max_iterations:
+            return await self._arun(
+                tool_input=RETRY_RESPONSE.format(
+                    tool_input=tool_input, query=query, error=error
+                ),
+                run_manager=run_manager,
+                iterations=iterations + 1,
+            )
+
+        self.session_cache[tool_input] = (
+            result if result else BAD_REQUEST_RESPONSE.format(error=error)
+        )
+        return self.session_cache[tool_input]
+
+    def _parse_output(
+        self, pbi_result: Dict[str, Any]
+    ) -> Tuple[Optional[str], Optional[Any]]:
+        """Parse the output of the query to a markdown table."""
+        if "results" in pbi_result:
+            rows = pbi_result["results"][0]["tables"][0]["rows"]
+            if len(rows) == 0:
+                logger.info("0 records in result, query was valid.")
+                return (
+                    None,
+                    "0 rows returned, this might be correct, but please validate if all filter values were correct?",  # noqa: E501
+                )
+            result = json_to_md(rows)
+            too_long, length = self._result_too_large(result)
+            if too_long:
+                return (
+                    f"Result too large, please try to be more specific or use the `TOPN` function. The result is {length} tokens long, the limit is {self.output_token_limit} tokens.",  # noqa: E501
+                    None,
+                )
+            return result, None
+
+        if "error" in pbi_result:
+            if (
+                "pbi.error" in pbi_result["error"]
+                and "details" in pbi_result["error"]["pbi.error"]
+            ):
+                return None, pbi_result["error"]["pbi.error"]["details"][0]["detail"]
+            return None, pbi_result["error"]
+        return None, pbi_result
+
+    def _result_too_large(self, result: str) -> Tuple[bool, int]:
+        """Tokenize the output of the query."""
+        if self.tiktoken_model_name:
+            tiktoken_ = _import_tiktoken()
+            encoding = tiktoken_.encoding_for_model(self.tiktoken_model_name)
+            length = len(encoding.encode(result))
+            logger.info("Result length: %s", length)
+            return length > self.output_token_limit, length
+        return False, 0
+
+
+class InfoPowerBITool(BaseTool):
+    """Tool for getting metadata about a PowerBI Dataset."""
+
+    name: str = "schema_powerbi"
+    description: str = """
+    Input to this tool is a comma-separated list of tables, output is the schema and sample rows for those tables.
+    Be sure that the tables actually exist by calling list_tables_powerbi first!
+
+    Example Input: "table1, table2, table3"
+    """  # noqa: E501
+    powerbi: PowerBIDataset = Field(exclude=True)
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def _run(
+        self,
+        tool_input: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Get the schema for tables in a comma-separated list."""
+        return self.powerbi.get_table_info(tool_input.split(", "))
+
+    async def _arun(
+        self,
+        tool_input: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        return await self.powerbi.aget_table_info(tool_input.split(", "))
+
+
+class ListPowerBITool(BaseTool):
+    """Tool for getting tables names."""
+
+    name: str = "list_tables_powerbi"
+    description: str = "Input is an empty string, output is a comma separated list of tables in the database."  # noqa: E501 # pylint: disable=C0301
+    powerbi: PowerBIDataset = Field(exclude=True)
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def _run(
+        self,
+        tool_input: Optional[str] = None,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Get the names of the tables."""
+        return ", ".join(self.powerbi.get_table_names())
+
+    async def _arun(
+        self,
+        tool_input: Optional[str] = None,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Get the names of the tables."""
+        return ", ".join(self.powerbi.get_table_names())
diff --git a/llm/Lib/site-packages/langchain_community/tools/pubmed/__init__.py b/llm/Lib/site-packages/langchain_community/tools/pubmed/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..687e908ee133084b2b15c0a4d4b287085d5d424b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/pubmed/__init__.py
@@ -0,0 +1 @@
+"""PubMed API toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/pubmed/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/pubmed/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dfea4672015cf46f9d6519d2713d20b785b3d4c9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/pubmed/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/pubmed/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/pubmed/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e6cc41cef5e65f5a29240d81374e53b1a3d72c89
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/pubmed/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/pubmed/tool.py b/llm/Lib/site-packages/langchain_community/tools/pubmed/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..44242379dd05a15b136d10fbca94f69293642b3c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/pubmed/tool.py
@@ -0,0 +1,29 @@
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.pubmed import PubMedAPIWrapper
+
+
+class PubmedQueryRun(BaseTool):
+    """Tool that searches the PubMed API."""
+
+    name: str = "pub_med"
+    description: str = (
+        "A wrapper around PubMed. "
+        "Useful for when you need to answer questions about medicine, health, "
+        "and biomedical topics "
+        "from biomedical literature, MEDLINE, life science journals, and online books. "
+        "Input should be a search query."
+    )
+    api_wrapper: PubMedAPIWrapper = Field(default_factory=PubMedAPIWrapper)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the PubMed tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/reddit_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/reddit_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4543aa7f7c0d735acc735a5130f5a3298dad0eff
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/reddit_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/reddit_search/tool.py b/llm/Lib/site-packages/langchain_community/tools/reddit_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..7c0da2a01e7a1752de0aa9b359f5640bc087336a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/reddit_search/tool.py
@@ -0,0 +1,64 @@
+"""Tool for the Reddit search API."""
+
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.reddit_search import RedditSearchAPIWrapper
+
+
+class RedditSearchSchema(BaseModel):
+    """Input for Reddit search."""
+
+    query: str = Field(
+        description="should be query string that post title should \
+        contain, or '*' if anything is allowed."
+    )
+    sort: str = Field(
+        description='should be sort method, which is one of: "relevance" \
+        , "hot", "top", "new", or "comments".'
+    )
+    time_filter: str = Field(
+        description='should be time period to filter by, which is \
+        one of "all", "day", "hour", "month", "week", or "year"'
+    )
+    subreddit: str = Field(
+        description='should be name of subreddit, like "all" for \
+        r/all'
+    )
+    limit: str = Field(
+        description="a positive integer indicating the maximum number \
+        of results to return"
+    )
+
+
+class RedditSearchRun(BaseTool):
+    """Tool that queries for posts on a subreddit."""
+
+    name: str = "reddit_search"
+    description: str = (
+        "A tool that searches for posts on Reddit."
+        "Useful when you need to know post information on a subreddit."
+    )
+    api_wrapper: RedditSearchAPIWrapper = Field(default_factory=RedditSearchAPIWrapper)
+    args_schema: Type[BaseModel] = RedditSearchSchema
+
+    def _run(
+        self,
+        query: str,
+        sort: str,
+        time_filter: str,
+        subreddit: str,
+        limit: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.api_wrapper.run(
+            query=query,
+            sort=sort,
+            time_filter=time_filter,
+            subreddit=subreddit,
+            limit=int(limit),
+        )
diff --git a/llm/Lib/site-packages/langchain_community/tools/render.py b/llm/Lib/site-packages/langchain_community/tools/render.py
new file mode 100644
index 0000000000000000000000000000000000000000..423f927127a7d23b529c8cead59ea37a04045fa7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/render.py
@@ -0,0 +1,6 @@
+from langchain_core.utils.function_calling import (
+    format_tool_to_openai_function,
+    format_tool_to_openai_tool,
+)
+
+__all__ = ["format_tool_to_openai_function", "format_tool_to_openai_tool"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/requests/__init__.py b/llm/Lib/site-packages/langchain_community/tools/requests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ec421f18dbdaa5b6f060ae11a6b92c21b9177377
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/requests/__init__.py
@@ -0,0 +1 @@
+"""Tools for making requests to an API endpoint."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/requests/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/requests/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a1f23d3f4f990ecfe4fe8b4d4be4914a28997d2f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/requests/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/requests/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/requests/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e1c3939da331471cd6f0e82259a786e83609b2db
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/requests/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/requests/tool.py b/llm/Lib/site-packages/langchain_community/tools/requests/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..4cfda1a80c371fefe1422aa76231da4bfb9ce2e1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/requests/tool.py
@@ -0,0 +1,208 @@
+# flake8: noqa
+"""Tools for making requests to an API endpoint."""
+import json
+from typing import Any, Dict, Optional, Union
+
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+
+from langchain_community.utilities.requests import GenericRequestsWrapper
+from langchain_core.tools import BaseTool
+
+
+def _parse_input(text: str) -> Dict[str, Any]:
+    """Parse the json string into a dict."""
+    return json.loads(text)
+
+
+def _clean_url(url: str) -> str:
+    """Strips quotes from the url."""
+    return url.strip("\"'")
+
+
+class BaseRequestsTool(BaseModel):
+    """Base class for requests tools."""
+
+    requests_wrapper: GenericRequestsWrapper
+
+    allow_dangerous_requests: bool = False
+
+    def __init__(self, **kwargs: Any):
+        """Initialize the tool."""
+        if not kwargs.get("allow_dangerous_requests", False):
+            raise ValueError(
+                "You must set allow_dangerous_requests to True to use this tool. "
+                "Requests can be dangerous and can lead to security vulnerabilities. "
+                "For example, users can ask a server to make a request to an internal "
+                "server. It's recommended to use requests through a proxy server "
+                "and avoid accepting inputs from untrusted sources without proper "
+                "sandboxing."
+                "Please see: https://python.langchain.com/docs/security for "
+                "further security information."
+            )
+        super().__init__(**kwargs)
+
+
+class RequestsGetTool(BaseRequestsTool, BaseTool):
+    """Tool for making a GET request to an API endpoint."""
+
+    name: str = "requests_get"
+    description: str = """A portal to the internet. Use this when you need to get specific
+    content from a website. Input should be a  url (i.e. https://www.google.com).
+    The output will be the text response of the GET request.
+    """
+
+    def _run(
+        self, url: str, run_manager: Optional[CallbackManagerForToolRun] = None
+    ) -> Union[str, Dict[str, Any]]:
+        """Run the tool."""
+        return self.requests_wrapper.get(_clean_url(url))
+
+    async def _arun(
+        self,
+        url: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> Union[str, Dict[str, Any]]:
+        """Run the tool asynchronously."""
+        return await self.requests_wrapper.aget(_clean_url(url))
+
+
+class RequestsPostTool(BaseRequestsTool, BaseTool):
+    """Tool for making a POST request to an API endpoint."""
+
+    name: str = "requests_post"
+    description: str = """Use this when you want to POST to a website.
+    Input should be a json string with two keys: "url" and "data".
+    The value of "url" should be a string, and the value of "data" should be a dictionary of 
+    key-value pairs you want to POST to the url.
+    Be careful to always use double quotes for strings in the json string
+    The output will be the text response of the POST request.
+    """
+
+    def _run(
+        self, text: str, run_manager: Optional[CallbackManagerForToolRun] = None
+    ) -> Union[str, Dict[str, Any]]:
+        """Run the tool."""
+        try:
+            data = _parse_input(text)
+            return self.requests_wrapper.post(_clean_url(data["url"]), data["data"])
+        except Exception as e:
+            return repr(e)
+
+    async def _arun(
+        self,
+        text: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> Union[str, Dict[str, Any]]:
+        """Run the tool asynchronously."""
+        try:
+            data = _parse_input(text)
+            return await self.requests_wrapper.apost(
+                _clean_url(data["url"]), data["data"]
+            )
+        except Exception as e:
+            return repr(e)
+
+
+class RequestsPatchTool(BaseRequestsTool, BaseTool):
+    """Tool for making a PATCH request to an API endpoint."""
+
+    name: str = "requests_patch"
+    description: str = """Use this when you want to PATCH to a website.
+    Input should be a json string with two keys: "url" and "data".
+    The value of "url" should be a string, and the value of "data" should be a dictionary of 
+    key-value pairs you want to PATCH to the url.
+    Be careful to always use double quotes for strings in the json string
+    The output will be the text response of the PATCH request.
+    """
+
+    def _run(
+        self, text: str, run_manager: Optional[CallbackManagerForToolRun] = None
+    ) -> Union[str, Dict[str, Any]]:
+        """Run the tool."""
+        try:
+            data = _parse_input(text)
+            return self.requests_wrapper.patch(_clean_url(data["url"]), data["data"])
+        except Exception as e:
+            return repr(e)
+
+    async def _arun(
+        self,
+        text: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> Union[str, Dict[str, Any]]:
+        """Run the tool asynchronously."""
+        try:
+            data = _parse_input(text)
+            return await self.requests_wrapper.apatch(
+                _clean_url(data["url"]), data["data"]
+            )
+        except Exception as e:
+            return repr(e)
+
+
+class RequestsPutTool(BaseRequestsTool, BaseTool):
+    """Tool for making a PUT request to an API endpoint."""
+
+    name: str = "requests_put"
+    description: str = """Use this when you want to PUT to a website.
+    Input should be a json string with two keys: "url" and "data".
+    The value of "url" should be a string, and the value of "data" should be a dictionary of 
+    key-value pairs you want to PUT to the url.
+    Be careful to always use double quotes for strings in the json string.
+    The output will be the text response of the PUT request.
+    """
+
+    def _run(
+        self, text: str, run_manager: Optional[CallbackManagerForToolRun] = None
+    ) -> Union[str, Dict[str, Any]]:
+        """Run the tool."""
+        try:
+            data = _parse_input(text)
+            return self.requests_wrapper.put(_clean_url(data["url"]), data["data"])
+        except Exception as e:
+            return repr(e)
+
+    async def _arun(
+        self,
+        text: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> Union[str, Dict[str, Any]]:
+        """Run the tool asynchronously."""
+        try:
+            data = _parse_input(text)
+            return await self.requests_wrapper.aput(
+                _clean_url(data["url"]), data["data"]
+            )
+        except Exception as e:
+            return repr(e)
+
+
+class RequestsDeleteTool(BaseRequestsTool, BaseTool):
+    """Tool for making a DELETE request to an API endpoint."""
+
+    name: str = "requests_delete"
+    description: str = """A portal to the internet.
+    Use this when you need to make a DELETE request to a URL.
+    Input should be a specific url, and the output will be the text
+    response of the DELETE request.
+    """
+
+    def _run(
+        self,
+        url: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> Union[str, Dict[str, Any]]:
+        """Run the tool."""
+        return self.requests_wrapper.delete(_clean_url(url))
+
+    async def _arun(
+        self,
+        url: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> Union[str, Dict[str, Any]]:
+        """Run the tool asynchronously."""
+        return await self.requests_wrapper.adelete(_clean_url(url))
diff --git a/llm/Lib/site-packages/langchain_community/tools/scenexplain/__init__.py b/llm/Lib/site-packages/langchain_community/tools/scenexplain/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2e6553b73567d8f9fcee2ef79e2db807ca74613c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/scenexplain/__init__.py
@@ -0,0 +1 @@
+"""SceneXplain API toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/scenexplain/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/scenexplain/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bc0e3c61a28e3aeb68074b2d4c32a804f8bfdb0a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/scenexplain/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/scenexplain/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/scenexplain/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1f52555d99bef2952cc5b90847017f63ddce46de
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/scenexplain/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/scenexplain/tool.py b/llm/Lib/site-packages/langchain_community/tools/scenexplain/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..5806cd7bb25ead8b00aa738f232b09df02650898
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/scenexplain/tool.py
@@ -0,0 +1,32 @@
+"""Tool for the SceneXplain API."""
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.scenexplain import SceneXplainAPIWrapper
+
+
+class SceneXplainInput(BaseModel):
+    """Input for SceneXplain."""
+
+    query: str = Field(..., description="The link to the image to explain")
+
+
+class SceneXplainTool(BaseTool):
+    """Tool that explains images."""
+
+    name: str = "image_explainer"
+    description: str = (
+        "An Image Captioning Tool: Use this tool to generate a detailed caption "
+        "for an image. The input can be an image file of any format, and "
+        "the output will be a text description that covers every detail of the image."
+    )
+    api_wrapper: SceneXplainAPIWrapper = Field(default_factory=SceneXplainAPIWrapper)
+
+    def _run(
+        self, query: str, run_manager: Optional[CallbackManagerForToolRun] = None
+    ) -> str:
+        """Use the tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/searchapi/__init__.py b/llm/Lib/site-packages/langchain_community/tools/searchapi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7a89dfceffa48790385a5f8c23af83a485a50eea
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/searchapi/__init__.py
@@ -0,0 +1,6 @@
+from langchain_community.tools.searchapi.tool import SearchAPIResults, SearchAPIRun
+
+"""SearchApi.io API Toolkit."""
+"""Tool for the SearchApi.io Google SERP API."""
+
+__all__ = ["SearchAPIResults", "SearchAPIRun"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/searchapi/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/searchapi/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a9335f6d48d0bf4e6e5f41435bcca012f051cf92
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/searchapi/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/searchapi/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/searchapi/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..93dbb9e64e4c4d2442521a13270872373f1890ed
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/searchapi/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/searchapi/tool.py b/llm/Lib/site-packages/langchain_community/tools/searchapi/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e7f5e8917cffd56e2fe27b426297b4de181872a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/searchapi/tool.py
@@ -0,0 +1,69 @@
+"""Tool for the SearchApi.io search API."""
+
+from typing import Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.searchapi import SearchApiAPIWrapper
+
+
+class SearchAPIRun(BaseTool):
+    """Tool that queries the SearchApi.io search API."""
+
+    name: str = "searchapi"
+    description: str = (
+        "Google search API provided by SearchApi.io."
+        "This tool is handy when you need to answer questions about current events."
+        "Input should be a search query."
+    )
+    api_wrapper: SearchApiAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.api_wrapper.run(query)
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+        return await self.api_wrapper.arun(query)
+
+
+class SearchAPIResults(BaseTool):
+    """Tool that queries the SearchApi.io search API and returns JSON."""
+
+    name: str = "searchapi_results_json"
+    description: str = (
+        "Google search API provided by SearchApi.io."
+        "This tool is handy when you need to answer questions about current events."
+        "The input should be a search query and the output is a JSON object "
+        "with the query results."
+    )
+    api_wrapper: SearchApiAPIWrapper = Field(default_factory=SearchApiAPIWrapper)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return str(self.api_wrapper.results(query))
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+        return (await self.api_wrapper.aresults(query)).__str__()
diff --git a/llm/Lib/site-packages/langchain_community/tools/searx_search/__init__.py b/llm/Lib/site-packages/langchain_community/tools/searx_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_community/tools/searx_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/searx_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..99729fedb34e7e01469502723402f8112363eefb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/searx_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/searx_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/searx_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a0ce3bdcb75408fa2bd9ddaf1773e11d66efb1e3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/searx_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/searx_search/tool.py b/llm/Lib/site-packages/langchain_community/tools/searx_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9f4e1b25a39405e96b85c05b8a7367d16253962
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/searx_search/tool.py
@@ -0,0 +1,77 @@
+"""Tool for the SearxNG search API."""
+from typing import Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import Extra, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.searx_search import SearxSearchWrapper
+
+
+class SearxSearchRun(BaseTool):
+    """Tool that queries a Searx instance."""
+
+    name: str = "searx_search"
+    description: str = (
+        "A meta search engine."
+        "Useful for when you need to answer questions about current events."
+        "Input should be a search query."
+    )
+    wrapper: SearxSearchWrapper
+    kwargs: dict = Field(default_factory=dict)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return self.wrapper.run(query, **self.kwargs)
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+        return await self.wrapper.arun(query, **self.kwargs)
+
+
+class SearxSearchResults(BaseTool):
+    """Tool that queries a Searx instance and gets back json."""
+
+    name: str = "searx_search_results"
+    description: str = (
+        "A meta search engine."
+        "Useful for when you need to answer questions about current events."
+        "Input should be a search query. Output is a JSON array of the query results"
+    )
+    wrapper: SearxSearchWrapper
+    num_results: int = 4
+    kwargs: dict = Field(default_factory=dict)
+
+    class Config:
+        """Pydantic config."""
+
+        extra = Extra.allow
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        return str(self.wrapper.results(query, self.num_results, **self.kwargs))
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+        return (
+            await self.wrapper.aresults(query, self.num_results, **self.kwargs)
+        ).__str__()
diff --git a/llm/Lib/site-packages/langchain_community/tools/semanticscholar/__init__.py b/llm/Lib/site-packages/langchain_community/tools/semanticscholar/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc51fdbe45490f42b1d7d92bb0f033a2e1a682b6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/semanticscholar/__init__.py
@@ -0,0 +1 @@
+"""Semantic Scholar API toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/semanticscholar/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/semanticscholar/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b51f0c06697fc953a747cc16224e583b3b7087d7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/semanticscholar/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/semanticscholar/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/semanticscholar/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c429f439a6468509746c8cdfb8c80764658f63eb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/semanticscholar/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/semanticscholar/tool.py b/llm/Lib/site-packages/langchain_community/tools/semanticscholar/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..2faee2f77f8295ccbad8d2ee21d5c8d1eb4336d9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/semanticscholar/tool.py
@@ -0,0 +1,39 @@
+"""Tool for the SemanticScholar API."""
+
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.semanticscholar import SemanticScholarAPIWrapper
+
+
+class SemantscholarInput(BaseModel):
+    """Input for the SemanticScholar tool."""
+
+    query: str = Field(description="search query to look up")
+
+
+class SemanticScholarQueryRun(BaseTool):
+    """Tool that searches the semanticscholar API."""
+
+    name: str = "semanticscholar"
+    description: str = (
+        "A wrapper around semantischolar.org "
+        "Useful for when you need to answer to questions"
+        "from research papers."
+        "Input should be a search query."
+    )
+    api_wrapper: SemanticScholarAPIWrapper = Field(
+        default_factory=SemanticScholarAPIWrapper
+    )
+    args_schema: Type[BaseModel] = SemantscholarInput
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Semantic Scholar tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/shell/__init__.py b/llm/Lib/site-packages/langchain_community/tools/shell/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..37e11d4b597190d9ce6d8a65b9ec35c33e64e368
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/shell/__init__.py
@@ -0,0 +1,5 @@
+"""Shell tool."""
+
+from langchain_community.tools.shell.tool import ShellTool
+
+__all__ = ["ShellTool"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/shell/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/shell/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4ceff34b7aa481334ebc7a82dccbb6b398f69e9a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/shell/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/shell/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/shell/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..25b82ce1f7a0fd458537078307006d1612d26d3a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/shell/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/shell/tool.py b/llm/Lib/site-packages/langchain_community/tools/shell/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..cb3e941ec632ebb08ce27584cfac44fbadbe5b8a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/shell/tool.py
@@ -0,0 +1,102 @@
+import logging
+import platform
+import warnings
+from typing import Any, List, Optional, Type, Union
+
+from langchain_core.callbacks import (
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+from langchain_core.tools import BaseTool
+
+logger = logging.getLogger(__name__)
+
+
+class ShellInput(BaseModel):
+    """Commands for the Bash Shell tool."""
+
+    commands: Union[str, List[str]] = Field(
+        ...,
+        description="List of shell commands to run. Deserialized using json.loads",
+    )
+    """List of shell commands to run."""
+
+    @root_validator
+    def _validate_commands(cls, values: dict) -> dict:
+        """Validate commands."""
+        # TODO: Add real validators
+        commands = values.get("commands")
+        if not isinstance(commands, list):
+            values["commands"] = [commands]
+        # Warn that the bash tool is not safe
+        warnings.warn(
+            "The shell tool has no safeguards by default. Use at your own risk."
+        )
+        return values
+
+
+def _get_default_bash_process() -> Any:
+    """Get default bash process."""
+    try:
+        from langchain_experimental.llm_bash.bash import BashProcess
+    except ImportError:
+        raise ImportError(
+            "BashProcess has been moved to langchain experimental."
+            "To use this tool, install langchain-experimental "
+            "with `pip install langchain-experimental`."
+        )
+    return BashProcess(return_err_output=True)
+
+
+def _get_platform() -> str:
+    """Get platform."""
+    system = platform.system()
+    if system == "Darwin":
+        return "MacOS"
+    return system
+
+
+class ShellTool(BaseTool):
+    """Tool to run shell commands."""
+
+    process: Any = Field(default_factory=_get_default_bash_process)
+    """Bash process to run commands."""
+
+    name: str = "terminal"
+    """Name of tool."""
+
+    description: str = f"Run shell commands on this {_get_platform()} machine."
+    """Description of tool."""
+
+    args_schema: Type[BaseModel] = ShellInput
+    """Schema for input arguments."""
+
+    ask_human_input: bool = False
+    """
+    If True, prompts the user for confirmation (y/n) before executing 
+    a command generated by the language model in the bash shell.
+    """
+
+    def _run(
+        self,
+        commands: Union[str, List[str]],
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Run commands and return final output."""
+
+        print(f"Executing command:\n {commands}")  # noqa: T201
+
+        try:
+            if self.ask_human_input:
+                user_input = input("Proceed with command execution? (y/n): ").lower()
+                if user_input == "y":
+                    return self.process.run(commands)
+                else:
+                    logger.info("Invalid input. User aborted command execution.")
+                    return None  # type: ignore[return-value]
+            else:
+                return self.process.run(commands)
+
+        except Exception as e:
+            logger.error(f"Error during command execution: {e}")
+            return None  # type: ignore[return-value]
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/__init__.py b/llm/Lib/site-packages/langchain_community/tools/slack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b77e61619c193b43b32b26f9ff10b4ad008e588f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/slack/__init__.py
@@ -0,0 +1,15 @@
+"""Slack tools."""
+
+from langchain_community.tools.slack.get_channel import SlackGetChannel
+from langchain_community.tools.slack.get_message import SlackGetMessage
+from langchain_community.tools.slack.schedule_message import SlackScheduleMessage
+from langchain_community.tools.slack.send_message import SlackSendMessage
+from langchain_community.tools.slack.utils import login
+
+__all__ = [
+    "SlackGetChannel",
+    "SlackGetMessage",
+    "SlackScheduleMessage",
+    "SlackSendMessage",
+    "login",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..441cb12a80e7857331b19a3eb24f8b36d8403108
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0cc8e551886e88896da137359bba7685441a0bbd
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/get_channel.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/get_channel.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ef354141e4ca665cd06064750dc0daa90083bd44
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/get_channel.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/get_message.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/get_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ae072a2bbdbb47eeb928da44523c920943180316
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/get_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/schedule_message.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/schedule_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..95439d79cca71cbffe80aceb706f10f7977bb6ee
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/schedule_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/send_message.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/send_message.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..959b57d848a3bf86214007bf0c00a1aa47c14660
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/send_message.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..42c1a71d4eb01fd08506d6a66471b99eb0f71e32
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/slack/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/base.py b/llm/Lib/site-packages/langchain_community/tools/slack/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d16450ed8e80b1ea15066c57b24909c4083cb0d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/slack/base.py
@@ -0,0 +1,19 @@
+"""Base class for Slack tools."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from langchain_core.pydantic_v1 import Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.slack.utils import login
+
+if TYPE_CHECKING:
+    from slack_sdk import WebClient
+
+
+class SlackBaseTool(BaseTool):
+    """Base class for Slack tools."""
+
+    client: WebClient = Field(default_factory=login)
+    """The WebClient object."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/get_channel.py b/llm/Lib/site-packages/langchain_community/tools/slack/get_channel.py
new file mode 100644
index 0000000000000000000000000000000000000000..4cee16a9350b3756883e35c04db1c8453da642c5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/slack/get_channel.py
@@ -0,0 +1,37 @@
+import json
+import logging
+from typing import Any, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+
+from langchain_community.tools.slack.base import SlackBaseTool
+
+
+class SlackGetChannel(SlackBaseTool):
+    """Tool that gets Slack channel information."""
+
+    name: str = "get_channelid_name_dict"
+    description: str = (
+        "Use this tool to get channelid-name dict. There is no input to this tool"
+    )
+
+    def _run(
+        self, *args: Any, run_manager: Optional[CallbackManagerForToolRun] = None
+    ) -> str:
+        try:
+            logging.getLogger(__name__)
+
+            result = self.client.conversations_list()
+            channels = result["channels"]
+            filtered_result = [
+                {key: channel[key] for key in ("id", "name", "created", "num_members")}
+                for channel in channels
+                if "id" in channel
+                and "name" in channel
+                and "created" in channel
+                and "num_members" in channel
+            ]
+            return json.dumps(filtered_result, ensure_ascii=False)
+
+        except Exception as e:
+            return "Error creating conversation: {}".format(e)
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/get_message.py b/llm/Lib/site-packages/langchain_community/tools/slack/get_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..06ec9a9f5703125e8e7290010b552d9cc219d3a4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/slack/get_message.py
@@ -0,0 +1,44 @@
+import json
+import logging
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.slack.base import SlackBaseTool
+
+
+class SlackGetMessageSchema(BaseModel):
+    """Input schema for SlackGetMessages."""
+
+    channel_id: str = Field(
+        ...,
+        description="The channel id, private group, or IM channel to send message to.",
+    )
+
+
+class SlackGetMessage(SlackBaseTool):
+    """Tool that gets Slack messages."""
+
+    name: str = "get_messages"
+    description: str = "Use this tool to get messages from a channel."
+
+    args_schema: Type[SlackGetMessageSchema] = SlackGetMessageSchema
+
+    def _run(
+        self,
+        channel_id: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        logging.getLogger(__name__)
+        try:
+            result = self.client.conversations_history(channel=channel_id)
+            messages = result["messages"]
+            filtered_messages = [
+                {key: message[key] for key in ("user", "text", "ts")}
+                for message in messages
+                if "user" in message and "text" in message and "ts" in message
+            ]
+            return json.dumps(filtered_messages, ensure_ascii=False)
+        except Exception as e:
+            return "Error creating conversation: {}".format(e)
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/schedule_message.py b/llm/Lib/site-packages/langchain_community/tools/slack/schedule_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..90edc9bcb9d71656ce533414e789e485c8cf5391
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/slack/schedule_message.py
@@ -0,0 +1,60 @@
+import logging
+from datetime import datetime as dt
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.slack.base import SlackBaseTool
+from langchain_community.tools.slack.utils import UTC_FORMAT
+
+logger = logging.getLogger(__name__)
+
+
+class ScheduleMessageSchema(BaseModel):
+    """Input for ScheduleMessageTool."""
+
+    message: str = Field(
+        ...,
+        description="The message to be sent.",
+    )
+    channel: str = Field(
+        ...,
+        description="The channel, private group, or IM channel to send message to.",
+    )
+    timestamp: str = Field(
+        ...,
+        description="The datetime for when the message should be sent in the "
+        ' following format: YYYY-MM-DDTHH:MM:SS±hh:mm, where "T" separates the date '
+        " and time components, and the time zone offset is specified as ±hh:mm. "
+        ' For example: "2023-06-09T10:30:00+03:00" represents June 9th, '
+        " 2023, at 10:30 AM in a time zone with a positive offset of 3 "
+        " hours from Coordinated Universal Time (UTC).",
+    )
+
+
+class SlackScheduleMessage(SlackBaseTool):
+    """Tool for scheduling a message in Slack."""
+
+    name: str = "schedule_message"
+    description: str = (
+        "Use this tool to schedule a message to be sent on a specific date and time."
+    )
+    args_schema: Type[ScheduleMessageSchema] = ScheduleMessageSchema
+
+    def _run(
+        self,
+        message: str,
+        channel: str,
+        timestamp: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        try:
+            unix_timestamp = dt.timestamp(dt.strptime(timestamp, UTC_FORMAT))
+            result = self.client.chat_scheduleMessage(
+                channel=channel, text=message, post_at=unix_timestamp
+            )
+            output = "Message scheduled: " + str(result)
+            return output
+        except Exception as e:
+            return "Error scheduling message: {}".format(e)
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/send_message.py b/llm/Lib/site-packages/langchain_community/tools/slack/send_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..c5e8a875ad0fe1afd4e9c37daeb9700407c44e1b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/slack/send_message.py
@@ -0,0 +1,42 @@
+from typing import Optional, Type
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+from langchain_community.tools.slack.base import SlackBaseTool
+
+
+class SendMessageSchema(BaseModel):
+    """Input for SendMessageTool."""
+
+    message: str = Field(
+        ...,
+        description="The message to be sent.",
+    )
+    channel: str = Field(
+        ...,
+        description="The channel, private group, or IM channel to send message to.",
+    )
+
+
+class SlackSendMessage(SlackBaseTool):
+    """Tool for sending a message in Slack."""
+
+    name: str = "send_message"
+    description: str = (
+        "Use this tool to send a message with the provided message fields."
+    )
+    args_schema: Type[SendMessageSchema] = SendMessageSchema
+
+    def _run(
+        self,
+        message: str,
+        channel: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        try:
+            result = self.client.chat_postMessage(channel=channel, text=message)
+            output = "Message sent: " + str(result)
+            return output
+        except Exception as e:
+            return "Error creating conversation: {}".format(e)
diff --git a/llm/Lib/site-packages/langchain_community/tools/slack/utils.py b/llm/Lib/site-packages/langchain_community/tools/slack/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d614f6e9b3c93ad6a0d00eb1f31871a8704639c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/slack/utils.py
@@ -0,0 +1,42 @@
+"""Slack tool utils."""
+from __future__ import annotations
+
+import logging
+import os
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from slack_sdk import WebClient
+
+logger = logging.getLogger(__name__)
+
+
+def login() -> WebClient:
+    """Authenticate using the Slack API."""
+    try:
+        from slack_sdk import WebClient
+    except ImportError as e:
+        raise ImportError(
+            "Cannot import slack_sdk. Please install the package with \
+            `pip install slack_sdk`."
+        ) from e
+
+    if "SLACK_BOT_TOKEN" in os.environ:
+        token = os.environ["SLACK_BOT_TOKEN"]
+        client = WebClient(token=token)
+        logger.info("slack login success")
+        return client
+    elif "SLACK_USER_TOKEN" in os.environ:
+        token = os.environ["SLACK_USER_TOKEN"]
+        client = WebClient(token=token)
+        logger.info("slack login success")
+        return client
+    else:
+        logger.error(
+            "Error: The SLACK_BOT_TOKEN or SLACK_USER_TOKEN \
+            environment variable have not been set."
+        )
+
+
+UTC_FORMAT = "%Y-%m-%dT%H:%M:%S%z"
+"""UTC format for datetime objects."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/sleep/__init__.py b/llm/Lib/site-packages/langchain_community/tools/sleep/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d6319e2640da606c3219863bb2d4d0829534364
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/sleep/__init__.py
@@ -0,0 +1 @@
+"""Sleep tool."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/sleep/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/sleep/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2a3f8590f9a3d27c149f400c294072a35da39e9b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/sleep/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/sleep/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/sleep/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ddad833f951bf96fe9ea6d79decfd5ef909e2574
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/sleep/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/sleep/tool.py b/llm/Lib/site-packages/langchain_community/tools/sleep/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..d56a114ace48deeb14af83cea0e2314da5d7851a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/sleep/tool.py
@@ -0,0 +1,43 @@
+"""Tool for agent to sleep."""
+from asyncio import sleep as asleep
+from time import sleep
+from typing import Optional, Type
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+
+class SleepInput(BaseModel):
+    """Input for CopyFileTool."""
+
+    sleep_time: int = Field(..., description="Time to sleep in seconds")
+
+
+class SleepTool(BaseTool):
+    """Tool that adds the capability to sleep."""
+
+    name: str = "sleep"
+    args_schema: Type[BaseModel] = SleepInput
+    description: str = "Make agent sleep for a specified number of seconds."
+
+    def _run(
+        self,
+        sleep_time: int,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Sleep tool."""
+        sleep(sleep_time)
+        return f"Agent slept for {sleep_time} seconds."
+
+    async def _arun(
+        self,
+        sleep_time: int,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the sleep tool asynchronously."""
+        await asleep(sleep_time)
+        return f"Agent slept for {sleep_time} seconds."
diff --git a/llm/Lib/site-packages/langchain_community/tools/spark_sql/__init__.py b/llm/Lib/site-packages/langchain_community/tools/spark_sql/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..01039b772c689f99dbf690c40988d9701b4fd02f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/spark_sql/__init__.py
@@ -0,0 +1 @@
+"""Tools for interacting with Spark SQL."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/spark_sql/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/spark_sql/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eea746f08325ad472ce739d0b879785dd9830512
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/spark_sql/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/spark_sql/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/spark_sql/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..27697e89de00727d5110f23a0534928b1f2e07c2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/spark_sql/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/spark_sql/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/spark_sql/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..78d42eaf73d98da3077db65e67cf5dc611a6a00b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/spark_sql/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/spark_sql/prompt.py b/llm/Lib/site-packages/langchain_community/tools/spark_sql/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..98a523b88cf31b7c1986d7e20490ee9635dc7e0d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/spark_sql/prompt.py
@@ -0,0 +1,14 @@
+# flake8: noqa
+QUERY_CHECKER = """
+{query}
+Double check the Spark SQL query above for common mistakes, including:
+- Using NOT IN with NULL values
+- Using UNION when UNION ALL should have been used
+- Using BETWEEN for exclusive ranges
+- Data type mismatch in predicates
+- Properly quoting identifiers
+- Using the correct number of arguments for functions
+- Casting to the correct data type
+- Using the proper columns for joins
+
+If there are any of the above mistakes, rewrite the query. If there are no mistakes, just reproduce the original query."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/spark_sql/tool.py b/llm/Lib/site-packages/langchain_community/tools/spark_sql/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..9110d543fdf34a3ab7be4993e8aecf8ed90f2ea9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/spark_sql/tool.py
@@ -0,0 +1,131 @@
+# flake8: noqa
+"""Tools for interacting with Spark SQL."""
+from typing import Any, Dict, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.prompts import PromptTemplate
+from langchain_community.utilities.spark_sql import SparkSQL
+from langchain_core.tools import BaseTool
+from langchain_community.tools.spark_sql.prompt import QUERY_CHECKER
+
+
+class BaseSparkSQLTool(BaseModel):
+    """Base tool for interacting with Spark SQL."""
+
+    db: SparkSQL = Field(exclude=True)
+
+    class Config(BaseTool.Config):
+        pass
+
+
+class QuerySparkSQLTool(BaseSparkSQLTool, BaseTool):
+    """Tool for querying a Spark SQL."""
+
+    name: str = "query_sql_db"
+    description: str = """
+    Input to this tool is a detailed and correct SQL query, output is a result from the Spark SQL.
+    If the query is not correct, an error message will be returned.
+    If an error is returned, rewrite the query, check the query, and try again.
+    """
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Execute the query, return the results or an error message."""
+        return self.db.run_no_throw(query)
+
+
+class InfoSparkSQLTool(BaseSparkSQLTool, BaseTool):
+    """Tool for getting metadata about a Spark SQL."""
+
+    name: str = "schema_sql_db"
+    description: str = """
+    Input to this tool is a comma-separated list of tables, output is the schema and sample rows for those tables.
+    Be sure that the tables actually exist by calling list_tables_sql_db first!
+
+    Example Input: "table1, table2, table3"
+    """
+
+    def _run(
+        self,
+        table_names: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Get the schema for tables in a comma-separated list."""
+        return self.db.get_table_info_no_throw(table_names.split(", "))
+
+
+class ListSparkSQLTool(BaseSparkSQLTool, BaseTool):
+    """Tool for getting tables names."""
+
+    name: str = "list_tables_sql_db"
+    description: str = "Input is an empty string, output is a comma separated list of tables in the Spark SQL."
+
+    def _run(
+        self,
+        tool_input: str = "",
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Get the schema for a specific table."""
+        return ", ".join(self.db.get_usable_table_names())
+
+
+class QueryCheckerTool(BaseSparkSQLTool, BaseTool):
+    """Use an LLM to check if a query is correct.
+    Adapted from https://www.patterns.app/blog/2023/01/18/crunchbot-sql-analyst-gpt/"""
+
+    template: str = QUERY_CHECKER
+    llm: BaseLanguageModel
+    llm_chain: Any = Field(init=False)
+    name: str = "query_checker_sql_db"
+    description: str = """
+    Use this tool to double check if your query is correct before executing it.
+    Always use this tool before executing a query with query_sql_db!
+    """
+
+    @root_validator(pre=True)
+    def initialize_llm_chain(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        if "llm_chain" not in values:
+            from langchain.chains.llm import LLMChain
+
+            values["llm_chain"] = LLMChain(
+                llm=values.get("llm"),
+                prompt=PromptTemplate(
+                    template=QUERY_CHECKER, input_variables=["query"]
+                ),
+            )
+
+        if values["llm_chain"].prompt.input_variables != ["query"]:
+            raise ValueError(
+                "LLM chain for QueryCheckerTool need to use ['query'] as input_variables "
+                "for the embedded prompt"
+            )
+
+        return values
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the LLM to check the query."""
+        return self.llm_chain.predict(
+            query=query, callbacks=run_manager.get_child() if run_manager else None
+        )
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        return await self.llm_chain.apredict(
+            query=query, callbacks=run_manager.get_child() if run_manager else None
+        )
diff --git a/llm/Lib/site-packages/langchain_community/tools/sql_database/__init__.py b/llm/Lib/site-packages/langchain_community/tools/sql_database/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..90fb3be1322f1bfab6e86d94f15fa4fac4639208
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/sql_database/__init__.py
@@ -0,0 +1 @@
+"""Tools for interacting with a SQL database."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/sql_database/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/sql_database/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..89234e7735ca395e7555bda502f7be71881e08cc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/sql_database/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/sql_database/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/sql_database/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3747b17ec0126b84e04230f01ffe2440b999117c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/sql_database/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/sql_database/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/sql_database/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4c565c97c901a28ee029f3602901c60bb26fcb8d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/sql_database/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/sql_database/prompt.py b/llm/Lib/site-packages/langchain_community/tools/sql_database/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..34ab0fd3b166440a0af36b240daa4c32eb55caa0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/sql_database/prompt.py
@@ -0,0 +1,18 @@
+# flake8: noqa
+QUERY_CHECKER = """
+{query}
+Double check the {dialect} query above for common mistakes, including:
+- Using NOT IN with NULL values
+- Using UNION when UNION ALL should have been used
+- Using BETWEEN for exclusive ranges
+- Data type mismatch in predicates
+- Properly quoting identifiers
+- Using the correct number of arguments for functions
+- Casting to the correct data type
+- Using the proper columns for joins
+
+If there are any of the above mistakes, rewrite the query. If there are no mistakes, just reproduce the original query.
+
+Output the final SQL query only.
+
+SQL Query: """
diff --git a/llm/Lib/site-packages/langchain_community/tools/sql_database/tool.py b/llm/Lib/site-packages/langchain_community/tools/sql_database/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..fa055a5a1450334559d3eb38e0732c34ccafc8c3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/sql_database/tool.py
@@ -0,0 +1,159 @@
+# flake8: noqa
+"""Tools for interacting with a SQL database."""
+from typing import Any, Dict, Optional, Sequence, Type, Union
+
+from sqlalchemy.engine import Result
+
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.prompts import PromptTemplate
+from langchain_community.utilities.sql_database import SQLDatabase
+from langchain_core.tools import BaseTool
+from langchain_community.tools.sql_database.prompt import QUERY_CHECKER
+
+
+class BaseSQLDatabaseTool(BaseModel):
+    """Base tool for interacting with a SQL database."""
+
+    db: SQLDatabase = Field(exclude=True)
+
+    class Config(BaseTool.Config):
+        pass
+
+
+class _QuerySQLDataBaseToolInput(BaseModel):
+    query: str = Field(..., description="A detailed and correct SQL query.")
+
+
+class QuerySQLDataBaseTool(BaseSQLDatabaseTool, BaseTool):
+    """Tool for querying a SQL database."""
+
+    name: str = "sql_db_query"
+    description: str = """
+    Execute a SQL query against the database and get back the result..
+    If the query is not correct, an error message will be returned.
+    If an error is returned, rewrite the query, check the query, and try again.
+    """
+    args_schema: Type[BaseModel] = _QuerySQLDataBaseToolInput
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> Union[str, Sequence[Dict[str, Any]], Result]:
+        """Execute the query, return the results or an error message."""
+        return self.db.run_no_throw(query)
+
+
+class _InfoSQLDatabaseToolInput(BaseModel):
+    table_names: str = Field(
+        ...,
+        description=(
+            "A comma-separated list of the table names for which to return the schema. "
+            "Example input: 'table1, table2, table3'"
+        ),
+    )
+
+
+class InfoSQLDatabaseTool(BaseSQLDatabaseTool, BaseTool):
+    """Tool for getting metadata about a SQL database."""
+
+    name: str = "sql_db_schema"
+    description: str = "Get the schema and sample rows for the specified SQL tables."
+    args_schema: Type[BaseModel] = _InfoSQLDatabaseToolInput
+
+    def _run(
+        self,
+        table_names: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Get the schema for tables in a comma-separated list."""
+        return self.db.get_table_info_no_throw(
+            [t.strip() for t in table_names.split(",")]
+        )
+
+
+class _ListSQLDataBaseToolInput(BaseModel):
+    tool_input: str = Field("", description="An empty string")
+
+
+class ListSQLDatabaseTool(BaseSQLDatabaseTool, BaseTool):
+    """Tool for getting tables names."""
+
+    name: str = "sql_db_list_tables"
+    description: str = "Input is an empty string, output is a comma-separated list of tables in the database."
+    args_schema: Type[BaseModel] = _ListSQLDataBaseToolInput
+
+    def _run(
+        self,
+        tool_input: str = "",
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Get a comma-separated list of table names."""
+        return ", ".join(self.db.get_usable_table_names())
+
+
+class _QuerySQLCheckerToolInput(BaseModel):
+    query: str = Field(..., description="A detailed and SQL query to be checked.")
+
+
+class QuerySQLCheckerTool(BaseSQLDatabaseTool, BaseTool):
+    """Use an LLM to check if a query is correct.
+    Adapted from https://www.patterns.app/blog/2023/01/18/crunchbot-sql-analyst-gpt/"""
+
+    template: str = QUERY_CHECKER
+    llm: BaseLanguageModel
+    llm_chain: Any = Field(init=False)
+    name: str = "sql_db_query_checker"
+    description: str = """
+    Use this tool to double check if your query is correct before executing it.
+    Always use this tool before executing a query with sql_db_query!
+    """
+    args_schema: Type[BaseModel] = _QuerySQLCheckerToolInput
+
+    @root_validator(pre=True)
+    def initialize_llm_chain(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        if "llm_chain" not in values:
+            from langchain.chains.llm import LLMChain
+
+            values["llm_chain"] = LLMChain(
+                llm=values.get("llm"),
+                prompt=PromptTemplate(
+                    template=QUERY_CHECKER, input_variables=["dialect", "query"]
+                ),
+            )
+
+        if values["llm_chain"].prompt.input_variables != ["dialect", "query"]:
+            raise ValueError(
+                "LLM chain for QueryCheckerTool must have input variables ['query', 'dialect']"
+            )
+
+        return values
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the LLM to check the query."""
+        return self.llm_chain.predict(
+            query=query,
+            dialect=self.db.dialect,
+            callbacks=run_manager.get_child() if run_manager else None,
+        )
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        return await self.llm_chain.apredict(
+            query=query,
+            dialect=self.db.dialect,
+            callbacks=run_manager.get_child() if run_manager else None,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/tools/stackexchange/__init__.py b/llm/Lib/site-packages/langchain_community/tools/stackexchange/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1fa9a483d105cc96872fe6b464185fa286d9c3bb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/stackexchange/__init__.py
@@ -0,0 +1 @@
+"""StackExchange API toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/stackexchange/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/stackexchange/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..366a2a891a8cc59cf00f9d795fd753a3db0284b5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/stackexchange/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/stackexchange/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/stackexchange/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b1a5ced5ed2abfa6d163f8a35d61f26cccf98815
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/stackexchange/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/stackexchange/tool.py b/llm/Lib/site-packages/langchain_community/tools/stackexchange/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..2060eada6e7e005586f7e8d1e07b78c0765b4b85
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/stackexchange/tool.py
@@ -0,0 +1,29 @@
+"""Tool for the Wikipedia API."""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.stackexchange import StackExchangeAPIWrapper
+
+
+class StackExchangeTool(BaseTool):
+    """Tool that uses StackExchange"""
+
+    name: str = "stack_exchange"
+    description: str = (
+        "A wrapper around StackExchange. "
+        "Useful for when you need to answer specific programming questions"
+        "code excerpts, code examples and solutions"
+        "Input should be a fully formed question."
+    )
+    api_wrapper: StackExchangeAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Stack Exchange tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/steam/__init__.py b/llm/Lib/site-packages/langchain_community/tools/steam/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9367fd95b3089f829ed69ae3f7a5ab848fa8e0d2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/steam/__init__.py
@@ -0,0 +1 @@
+"""Steam API toolkit"""
diff --git a/llm/Lib/site-packages/langchain_community/tools/steam/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/steam/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d056cead3100ad3091fc509ac070833522213d9c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/steam/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/steam/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/steam/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0d94d0b1736cc4ac295a1bc8a0a69efab9afba98
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/steam/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/steam/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/steam/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7cfac042b0f8ff95a2bc38e9be85ce01c382453f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/steam/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/steam/prompt.py b/llm/Lib/site-packages/langchain_community/tools/steam/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..6f82e2ff4f2f1efa0cbd86ece69b1c2f062ca553
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/steam/prompt.py
@@ -0,0 +1,26 @@
+STEAM_GET_GAMES_DETAILS = """
+    This tool is a wrapper around python-steam-api's steam.apps.search_games API and 
+    steam.apps.get_app_details API, useful when you need to search for a game.
+    The input to this tool is a string specifying the name of the game you want to 
+    search for. For example, to search for a game called "Counter-Strike: Global 
+    Offensive", you would input "Counter-Strike: Global Offensive" as the game name.
+    This input will be passed into steam.apps.search_games to find the game id, link 
+    and price, and then the game id will be passed into steam.apps.get_app_details to 
+    get the detailed description and supported languages of the game. Finally the 
+    results are combined and returned as a string.
+"""
+
+STEAM_GET_RECOMMENDED_GAMES = """
+    This tool is a wrapper around python-steam-api's steam.users.get_owned_games API 
+    and steamspypi's steamspypi.download API, useful when you need to get a list of 
+    recommended games. The input to this tool is a string specifying the steam id of 
+    the user you want to get recommended games for. For example, to get recommended 
+    games for a user with steam id 76561197960435530, you would input 
+    "76561197960435530" as the steam id.  This steamid is then utilized to form a 
+    data_request sent to steamspypi's steamspypi.download to retrieve genres of user's 
+    owned games. Then, calculates the frequency of each genre, identifying the most 
+    popular one, and stored it in a dictionary. Subsequently, use steamspypi.download
+    to returns all games in this genre and return 5 most-played games that is not owned
+    by the user.
+
+"""
diff --git a/llm/Lib/site-packages/langchain_community/tools/steam/tool.py b/llm/Lib/site-packages/langchain_community/tools/steam/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..3e71dddc0b4eadac9b02b28815417fb0789597c7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/steam/tool.py
@@ -0,0 +1,30 @@
+"""Tool for Steam Web API"""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.steam import SteamWebAPIWrapper
+
+
+class SteamWebAPIQueryRun(BaseTool):
+    """Tool that searches the Steam Web API."""
+
+    mode: str
+    name: str = "steam"
+    description: str = (
+        "A wrapper around Steam Web API."
+        "Steam Tool is useful for fetching User profiles and stats, Game data and more!"
+        "Input should be the User or Game you want to query."
+    )
+
+    api_wrapper: SteamWebAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Steam-WebAPI tool."""
+        return self.api_wrapper.run(self.mode, query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/__init__.py b/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e21672c72dc2541e2ae071133633d0651e7f0af2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/__init__.py
@@ -0,0 +1,7 @@
+"""Tool to generate an image."""
+
+from langchain_community.tools.steamship_image_generation.tool import (
+    SteamshipImageGenerationTool,
+)
+
+__all__ = ["SteamshipImageGenerationTool"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..501f3eebc3b60432e3d7066b97202f1f255e7511
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..78e38c098f21ee137fe86cc878df1fc1fed682b0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e0dc610b30231d408b47fef59899492332e1c20b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/tool.py b/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..a33233c83122389226419448b3d46cfe9adfc8f8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/tool.py
@@ -0,0 +1,113 @@
+"""This tool allows agents to generate images using Steamship.
+
+Steamship offers access to different third party image generation APIs
+using a single API key.
+
+Today the following models are supported:
+- Dall-E
+- Stable Diffusion
+
+To use this tool, you must first set as environment variables:
+    STEAMSHIP_API_KEY
+```
+"""
+from __future__ import annotations
+
+from enum import Enum
+from typing import TYPE_CHECKING, Dict, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+from langchain_community.tools import BaseTool
+from langchain_community.tools.steamship_image_generation.utils import make_image_public
+
+if TYPE_CHECKING:
+    from steamship import Steamship
+
+
+class ModelName(str, Enum):
+    """Supported Image Models for generation."""
+
+    DALL_E = "dall-e"
+    STABLE_DIFFUSION = "stable-diffusion"
+
+
+SUPPORTED_IMAGE_SIZES = {
+    ModelName.DALL_E: ("256x256", "512x512", "1024x1024"),
+    ModelName.STABLE_DIFFUSION: ("512x512", "768x768"),
+}
+
+
+class SteamshipImageGenerationTool(BaseTool):
+
+    """Tool used to generate images from a text-prompt."""
+
+    model_name: ModelName
+    size: Optional[str] = "512x512"
+    steamship: Steamship
+    return_urls: Optional[bool] = False
+
+    name: str = "generate_image"
+    description: str = (
+        "Useful for when you need to generate an image."
+        "Input: A detailed text-2-image prompt describing an image"
+        "Output: the UUID of a generated image"
+    )
+
+    @root_validator(pre=True)
+    def validate_size(cls, values: Dict) -> Dict:
+        if "size" in values:
+            size = values["size"]
+            model_name = values["model_name"]
+            if size not in SUPPORTED_IMAGE_SIZES[model_name]:
+                raise RuntimeError(f"size {size} is not supported by {model_name}")
+
+        return values
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        steamship_api_key = get_from_dict_or_env(
+            values, "steamship_api_key", "STEAMSHIP_API_KEY"
+        )
+
+        try:
+            from steamship import Steamship
+        except ImportError:
+            raise ImportError(
+                "steamship is not installed. "
+                "Please install it with `pip install steamship`"
+            )
+
+        steamship = Steamship(
+            api_key=steamship_api_key,
+        )
+        values["steamship"] = steamship
+        if "steamship_api_key" in values:
+            del values["steamship_api_key"]
+
+        return values
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+
+        image_generator = self.steamship.use_plugin(
+            plugin_handle=self.model_name.value, config={"n": 1, "size": self.size}
+        )
+
+        task = image_generator.generate(text=query, append_output_to_file=True)
+        task.wait()
+        blocks = task.output.blocks
+        if len(blocks) > 0:
+            if self.return_urls:
+                return make_image_public(self.steamship, blocks[0])
+            else:
+                return blocks[0].id
+
+        raise RuntimeError(f"[{self.name}] Tool unable to generate image!")
diff --git a/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/utils.py b/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..e89014e58c2eef1e9b40800cd3c48cdc82734088
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/steamship_image_generation/utils.py
@@ -0,0 +1,47 @@
+"""Steamship Utils."""
+from __future__ import annotations
+
+import uuid
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from steamship import Block, Steamship
+
+
+def make_image_public(client: Steamship, block: Block) -> str:
+    """Upload a block to a signed URL and return the public URL."""
+    try:
+        from steamship.data.workspace import SignedUrl
+        from steamship.utils.signed_urls import upload_to_signed_url
+    except ImportError:
+        raise ImportError(
+            "The make_image_public function requires the steamship"
+            " package to be installed. Please install steamship"
+            " with `pip install --upgrade steamship`"
+        )
+
+    filepath = str(uuid.uuid4())
+    signed_url = (
+        client.get_workspace()
+        .create_signed_url(
+            SignedUrl.Request(
+                bucket=SignedUrl.Bucket.PLUGIN_DATA,
+                filepath=filepath,
+                operation=SignedUrl.Operation.WRITE,
+            )
+        )
+        .signed_url
+    )
+    read_signed_url = (
+        client.get_workspace()
+        .create_signed_url(
+            SignedUrl.Request(
+                bucket=SignedUrl.Bucket.PLUGIN_DATA,
+                filepath=filepath,
+                operation=SignedUrl.Operation.READ,
+            )
+        )
+        .signed_url
+    )
+    upload_to_signed_url(signed_url, block.raw())
+    return read_signed_url
diff --git a/llm/Lib/site-packages/langchain_community/tools/tavily_search/__init__.py b/llm/Lib/site-packages/langchain_community/tools/tavily_search/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7c8ad700997e6fbd93282e6d33cc145966a6c45e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/tavily_search/__init__.py
@@ -0,0 +1,8 @@
+"""Tavily Search API toolkit."""
+
+from langchain_community.tools.tavily_search.tool import (
+    TavilyAnswer,
+    TavilySearchResults,
+)
+
+__all__ = ["TavilySearchResults", "TavilyAnswer"]
diff --git a/llm/Lib/site-packages/langchain_community/tools/tavily_search/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/tavily_search/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a3a8c2350257d2da5a928d1d8527bf7bf23e44c9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/tavily_search/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/tavily_search/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/tavily_search/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..428fcaa3dae5c34b71d35eaa38fc219dd3032562
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/tavily_search/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/tavily_search/tool.py b/llm/Lib/site-packages/langchain_community/tools/tavily_search/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..4eb1ff4b45607e69ed56f412fc9b9dabf4b6be78
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/tavily_search/tool.py
@@ -0,0 +1,107 @@
+"""Tool for the Tavily search API."""
+
+from typing import Dict, List, Optional, Type, Union
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.tavily_search import TavilySearchAPIWrapper
+
+
+class TavilyInput(BaseModel):
+    """Input for the Tavily tool."""
+
+    query: str = Field(description="search query to look up")
+
+
+class TavilySearchResults(BaseTool):
+    """Tool that queries the Tavily Search API and gets back json."""
+
+    name: str = "tavily_search_results_json"
+    description: str = (
+        "A search engine optimized for comprehensive, accurate, and trusted results. "
+        "Useful for when you need to answer questions about current events. "
+        "Input should be a search query."
+    )
+    api_wrapper: TavilySearchAPIWrapper = Field(default_factory=TavilySearchAPIWrapper)
+    max_results: int = 5
+    args_schema: Type[BaseModel] = TavilyInput
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> Union[List[Dict], str]:
+        """Use the tool."""
+        try:
+            return self.api_wrapper.results(
+                query,
+                self.max_results,
+            )
+        except Exception as e:
+            return repr(e)
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> Union[List[Dict], str]:
+        """Use the tool asynchronously."""
+        try:
+            return await self.api_wrapper.results_async(
+                query,
+                self.max_results,
+            )
+        except Exception as e:
+            return repr(e)
+
+
+class TavilyAnswer(BaseTool):
+    """Tool that queries the Tavily Search API and gets back an answer."""
+
+    name: str = "tavily_answer"
+    description: str = (
+        "A search engine optimized for comprehensive, accurate, and trusted results. "
+        "Useful for when you need to answer questions about current events. "
+        "Input should be a search query. "
+        "This returns only the answer - not the original source data."
+    )
+    api_wrapper: TavilySearchAPIWrapper = Field(default_factory=TavilySearchAPIWrapper)
+    args_schema: Type[BaseModel] = TavilyInput
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> Union[List[Dict], str]:
+        """Use the tool."""
+        try:
+            return self.api_wrapper.raw_results(
+                query,
+                max_results=5,
+                include_answer=True,
+                search_depth="basic",
+            )["answer"]
+        except Exception as e:
+            return repr(e)
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> Union[List[Dict], str]:
+        """Use the tool asynchronously."""
+        try:
+            result = await self.api_wrapper.raw_results_async(
+                query,
+                max_results=5,
+                include_answer=True,
+                search_depth="basic",
+            )
+            return result["answer"]
+        except Exception as e:
+            return repr(e)
diff --git a/llm/Lib/site-packages/langchain_community/tools/vectorstore/__init__.py b/llm/Lib/site-packages/langchain_community/tools/vectorstore/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2bb638101959c35f933e0cf8601a448205a5d43a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/vectorstore/__init__.py
@@ -0,0 +1 @@
+"""Simple tool wrapper around VectorDBQA chain."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/vectorstore/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/vectorstore/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e310f4d723692c1fc7951f74d21e27db1754e0b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/vectorstore/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/vectorstore/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/vectorstore/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..706c1f3d8dff9e887b663bfb87efe49ca22ac1d9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/vectorstore/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/vectorstore/tool.py b/llm/Lib/site-packages/langchain_community/tools/vectorstore/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..7f9b965f08cc8e52d51abba98d2669e62739722c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/vectorstore/tool.py
@@ -0,0 +1,138 @@
+"""Tools for interacting with vectorstores."""
+
+import json
+from typing import Any, Dict, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.language_models import BaseLanguageModel
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.llms.openai import OpenAI
+
+
+class BaseVectorStoreTool(BaseModel):
+    """Base class for tools that use a VectorStore."""
+
+    vectorstore: VectorStore = Field(exclude=True)
+    llm: BaseLanguageModel = Field(default_factory=lambda: OpenAI(temperature=0))
+
+    class Config(BaseTool.Config):
+        pass
+
+
+def _create_description_from_template(values: Dict[str, Any]) -> Dict[str, Any]:
+    values["description"] = values["template"].format(name=values["name"])
+    return values
+
+
+class VectorStoreQATool(BaseVectorStoreTool, BaseTool):
+    """Tool for the VectorDBQA chain. To be initialized with name and chain."""
+
+    @staticmethod
+    def get_description(name: str, description: str) -> str:
+        template: str = (
+            "Useful for when you need to answer questions about {name}. "
+            "Whenever you need information about {description} "
+            "you should ALWAYS use this. "
+            "Input should be a fully formed question."
+        )
+        return template.format(name=name, description=description)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        from langchain.chains.retrieval_qa.base import RetrievalQA
+
+        chain = RetrievalQA.from_chain_type(
+            self.llm, retriever=self.vectorstore.as_retriever()
+        )
+        return chain.invoke(
+            {chain.input_key: query},
+            config={"callbacks": run_manager.get_child() if run_manager else None},
+        )[chain.output_key]
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+        from langchain.chains.retrieval_qa.base import RetrievalQA
+
+        chain = RetrievalQA.from_chain_type(
+            self.llm, retriever=self.vectorstore.as_retriever()
+        )
+        return (
+            await chain.ainvoke(
+                {chain.input_key: query},
+                config={"callbacks": run_manager.get_child() if run_manager else None},
+            )
+        )[chain.output_key]
+
+
+class VectorStoreQAWithSourcesTool(BaseVectorStoreTool, BaseTool):
+    """Tool for the VectorDBQAWithSources chain."""
+
+    @staticmethod
+    def get_description(name: str, description: str) -> str:
+        template: str = (
+            "Useful for when you need to answer questions about {name} and the sources "
+            "used to construct the answer. "
+            "Whenever you need information about {description} "
+            "you should ALWAYS use this. "
+            " Input should be a fully formed question. "
+            "Output is a json serialized dictionary with keys `answer` and `sources`. "
+            "Only use this tool if the user explicitly asks for sources."
+        )
+        return template.format(name=name, description=description)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+
+        from langchain.chains.qa_with_sources.retrieval import (
+            RetrievalQAWithSourcesChain,
+        )
+
+        chain = RetrievalQAWithSourcesChain.from_chain_type(
+            self.llm, retriever=self.vectorstore.as_retriever()
+        )
+        return json.dumps(
+            chain.invoke(
+                {chain.question_key: query},
+                return_only_outputs=True,
+                config={"callbacks": run_manager.get_child() if run_manager else None},
+            )
+        )
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool asynchronously."""
+        from langchain.chains.qa_with_sources.retrieval import (
+            RetrievalQAWithSourcesChain,
+        )
+
+        chain = RetrievalQAWithSourcesChain.from_chain_type(
+            self.llm, retriever=self.vectorstore.as_retriever()
+        )
+        return json.dumps(
+            await chain.ainvoke(
+                {chain.question_key: query},
+                return_only_outputs=True,
+                config={"callbacks": run_manager.get_child() if run_manager else None},
+            )
+        )
diff --git a/llm/Lib/site-packages/langchain_community/tools/wikidata/__init__.py b/llm/Lib/site-packages/langchain_community/tools/wikidata/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a3b32ff4d9a458fb7b50beb202cefe2c1716ec88
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/wikidata/__init__.py
@@ -0,0 +1 @@
+"""Wikidata API toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/wikidata/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/wikidata/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3bcea028dea718bedce6416aa06fb99c4c2215f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/wikidata/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/wikidata/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/wikidata/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8e45753d2a82d1d35ed89a895e579202954a033c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/wikidata/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/wikidata/tool.py b/llm/Lib/site-packages/langchain_community/tools/wikidata/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..c34096cf0199f1237ebc572169cdcb3fec9a749f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/wikidata/tool.py
@@ -0,0 +1,30 @@
+"""Tool for the Wikidata API."""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.wikidata import WikidataAPIWrapper
+
+
+class WikidataQueryRun(BaseTool):
+    """Tool that searches the Wikidata API."""
+
+    name: str = "Wikidata"
+    description: str = (
+        "A wrapper around Wikidata. "
+        "Useful for when you need to answer general questions about "
+        "people, places, companies, facts, historical events, or other subjects. "
+        "Input should be the exact name of the item you want information about "
+        "or a Wikidata QID."
+    )
+    api_wrapper: WikidataAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Wikidata tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/wikipedia/__init__.py b/llm/Lib/site-packages/langchain_community/tools/wikipedia/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0b3edd083874aea350e44514d24c8f692307daef
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/wikipedia/__init__.py
@@ -0,0 +1 @@
+"""Wikipedia API toolkit."""
diff --git a/llm/Lib/site-packages/langchain_community/tools/wikipedia/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/wikipedia/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7a006b382a9745b1df51ffcf8adfeb442ebe8431
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/wikipedia/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/wikipedia/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/wikipedia/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fc5e8e34de974b4e6ec827c7f00fa22fe269d77c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/wikipedia/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/wikipedia/tool.py b/llm/Lib/site-packages/langchain_community/tools/wikipedia/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..a74d437538d42c591c218fb7bd69a574644c7f84
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/wikipedia/tool.py
@@ -0,0 +1,29 @@
+"""Tool for the Wikipedia API."""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.wikipedia import WikipediaAPIWrapper
+
+
+class WikipediaQueryRun(BaseTool):
+    """Tool that searches the Wikipedia API."""
+
+    name: str = "wikipedia"
+    description: str = (
+        "A wrapper around Wikipedia. "
+        "Useful for when you need to answer general questions about "
+        "people, places, companies, facts, historical events, or other subjects. "
+        "Input should be a search query."
+    )
+    api_wrapper: WikipediaAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Wikipedia tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/wolfram_alpha/__init__.py b/llm/Lib/site-packages/langchain_community/tools/wolfram_alpha/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f5ec860d0acf617c822cdcaca41306d1870258d2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/wolfram_alpha/__init__.py
@@ -0,0 +1,8 @@
+"""Wolfram Alpha API toolkit."""
+
+
+from langchain_community.tools.wolfram_alpha.tool import WolframAlphaQueryRun
+
+__all__ = [
+    "WolframAlphaQueryRun",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/wolfram_alpha/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/wolfram_alpha/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7c8f63749c3eb30b9afae7fef2b8c456c6a63637
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/wolfram_alpha/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/wolfram_alpha/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/wolfram_alpha/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b4fe270930cacbc140f98e1e6b1c6bde79b9cf86
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/wolfram_alpha/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/wolfram_alpha/tool.py b/llm/Lib/site-packages/langchain_community/tools/wolfram_alpha/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..e4364e669a0666c35920869b3c376b69eb8a014c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/wolfram_alpha/tool.py
@@ -0,0 +1,29 @@
+"""Tool for the Wolfram Alpha API."""
+
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.wolfram_alpha import WolframAlphaAPIWrapper
+
+
+class WolframAlphaQueryRun(BaseTool):
+    """Tool that queries using the Wolfram Alpha SDK."""
+
+    name: str = "wolfram_alpha"
+    description: str = (
+        "A wrapper around Wolfram Alpha. "
+        "Useful for when you need to answer questions about Math, "
+        "Science, Technology, Culture, Society and Everyday Life. "
+        "Input should be a search query."
+    )
+    api_wrapper: WolframAlphaAPIWrapper
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the WolframAlpha tool."""
+        return self.api_wrapper.run(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/yahoo_finance_news.py b/llm/Lib/site-packages/langchain_community/tools/yahoo_finance_news.py
new file mode 100644
index 0000000000000000000000000000000000000000..c470fa01d2bcda4465e20bc0e784685ab9b5dcc8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/yahoo_finance_news.py
@@ -0,0 +1,67 @@
+from typing import Iterable, Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+from langchain_core.documents import Document
+from langchain_core.tools import BaseTool
+from requests.exceptions import HTTPError, ReadTimeout
+from urllib3.exceptions import ConnectionError
+
+from langchain_community.document_loaders.web_base import WebBaseLoader
+
+
+class YahooFinanceNewsTool(BaseTool):
+    """Tool that searches financial news on Yahoo Finance."""
+
+    name: str = "yahoo_finance_news"
+    description: str = (
+        "Useful for when you need to find financial news "
+        "about a public company. "
+        "Input should be a company ticker. "
+        "For example, AAPL for Apple, MSFT for Microsoft."
+    )
+    top_k: int = 10
+    """The number of results to return."""
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Yahoo Finance News tool."""
+        try:
+            import yfinance
+        except ImportError:
+            raise ImportError(
+                "Could not import yfinance python package. "
+                "Please install it with `pip install yfinance`."
+            )
+        company = yfinance.Ticker(query)
+        try:
+            if company.isin is None:
+                return f"Company ticker {query} not found."
+        except (HTTPError, ReadTimeout, ConnectionError):
+            return f"Company ticker {query} not found."
+
+        links = []
+        try:
+            links = [n["link"] for n in company.news if n["type"] == "STORY"]
+        except (HTTPError, ReadTimeout, ConnectionError):
+            if not links:
+                return f"No news found for company that searched with {query} ticker."
+        if not links:
+            return f"No news found for company that searched with {query} ticker."
+        loader = WebBaseLoader(web_paths=links)
+        docs = loader.load()
+        result = self._format_results(docs, query)
+        if not result:
+            return f"No news found for company that searched with {query} ticker."
+        return result
+
+    @staticmethod
+    def _format_results(docs: Iterable[Document], query: str) -> str:
+        doc_strings = [
+            "\n".join([doc.metadata["title"], doc.metadata["description"]])
+            for doc in docs
+            if query in doc.metadata["description"] or query in doc.metadata["title"]
+        ]
+        return "\n\n".join(doc_strings)
diff --git a/llm/Lib/site-packages/langchain_community/tools/you/__init__.py b/llm/Lib/site-packages/langchain_community/tools/you/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..fcecca418a78cc2013926dd820d16dde338f921e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/you/__init__.py
@@ -0,0 +1,8 @@
+"""You.com API toolkit."""
+
+
+from langchain_community.tools.you.tool import YouSearchTool
+
+__all__ = [
+    "YouSearchTool",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/you/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/you/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..62e3921efedb020ac9b8769303ffbd0e273dca6c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/you/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/you/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/you/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e78b621200635bd4f76f7628a3ae371d965f0ef8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/you/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/you/tool.py b/llm/Lib/site-packages/langchain_community/tools/you/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..75b06bd0139b4f7af5051e4f5fb17a69831ea2b3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/you/tool.py
@@ -0,0 +1,45 @@
+from typing import List, Optional, Type
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.tools import BaseTool
+
+from langchain_community.utilities.you import YouSearchAPIWrapper
+
+
+class YouInput(BaseModel):
+    """Input schema for the you.com tool."""
+
+    query: str = Field(description="should be a search query")
+
+
+class YouSearchTool(BaseTool):
+    """Tool that searches the you.com API."""
+
+    name = "you_search"
+    description = (
+        "The YOU APIs make LLMs and search experiences more factual and"
+        "up to date with realtime web data."
+    )
+    args_schema: Type[BaseModel] = YouInput
+    api_wrapper: YouSearchAPIWrapper = Field(default_factory=YouSearchAPIWrapper)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> List[Document]:
+        """Use the you.com tool."""
+        return self.api_wrapper.results(query)
+
+    async def _arun(
+        self,
+        query: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> List[Document]:
+        """Use the you.com tool asynchronously."""
+        return await self.api_wrapper.results_async(query)
diff --git a/llm/Lib/site-packages/langchain_community/tools/youtube/__init__.py b/llm/Lib/site-packages/langchain_community/tools/youtube/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_community/tools/youtube/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/youtube/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8a7f91ed3950ab543c5ee8356ce7e109eccacc63
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/youtube/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/youtube/__pycache__/search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/youtube/__pycache__/search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2259120dbc758fdba4d251f2dab64750c4387b8c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/youtube/__pycache__/search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/youtube/search.py b/llm/Lib/site-packages/langchain_community/tools/youtube/search.py
new file mode 100644
index 0000000000000000000000000000000000000000..580815c3922e383cfd7a0e60495ed044d84a12e8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/youtube/search.py
@@ -0,0 +1,53 @@
+"""
+Adapted from https://github.com/venuv/langchain_yt_tools
+
+CustomYTSearchTool searches YouTube videos related to a person
+and returns a specified number of video URLs.
+Input to this tool should be a comma separated list,
+ - the first part contains a person name
+ - and the second(optional) a number that is the
+    maximum number of video results to return
+ """
+import json
+from typing import Optional
+
+from langchain_core.callbacks import CallbackManagerForToolRun
+
+from langchain_community.tools import BaseTool
+
+
+class YouTubeSearchTool(BaseTool):
+    """Tool that queries YouTube."""
+
+    name: str = "youtube_search"
+    description: str = (
+        "search for youtube videos associated with a person. "
+        "the input to this tool should be a comma separated list, "
+        "the first part contains a person name and the second a "
+        "number that is the maximum number of video results "
+        "to return aka num_results. the second part is optional"
+    )
+
+    def _search(self, person: str, num_results: int) -> str:
+        from youtube_search import YoutubeSearch
+
+        results = YoutubeSearch(person, num_results).to_json()
+        data = json.loads(results)
+        url_suffix_list = [
+            "https://www.youtube.com" + video["url_suffix"] for video in data["videos"]
+        ]
+        return str(url_suffix_list)
+
+    def _run(
+        self,
+        query: str,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the tool."""
+        values = query.split(",")
+        person = values[0]
+        if len(values) > 1:
+            num_results = int(values[1])
+        else:
+            num_results = 2
+        return self._search(person, num_results)
diff --git a/llm/Lib/site-packages/langchain_community/tools/zapier/__init__.py b/llm/Lib/site-packages/langchain_community/tools/zapier/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7f2c588844cc80518c019d71e45a8090085d093
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/zapier/__init__.py
@@ -0,0 +1,11 @@
+"""Zapier Tool."""
+
+from langchain_community.tools.zapier.tool import (
+    ZapierNLAListActions,
+    ZapierNLARunAction,
+)
+
+__all__ = [
+    "ZapierNLARunAction",
+    "ZapierNLAListActions",
+]
diff --git a/llm/Lib/site-packages/langchain_community/tools/zapier/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/zapier/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c3d0698c9ed2cd23bda7e41bfc2196d7d6d002eb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/zapier/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/zapier/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/zapier/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6294622a87a123c1ae1d5727e09ac895e1836224
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/zapier/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/zapier/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/tools/zapier/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f40fc8ba10bbba6fd36a3122ef8459ae6d697650
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/tools/zapier/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/tools/zapier/prompt.py b/llm/Lib/site-packages/langchain_community/tools/zapier/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..063e3952ef2aaf1122b63c17e39b06c8c4dc3f06
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/zapier/prompt.py
@@ -0,0 +1,15 @@
+# flake8: noqa
+BASE_ZAPIER_TOOL_PROMPT = (
+    "A wrapper around Zapier NLA actions. "
+    "The input to this tool is a natural language instruction, "
+    'for example "get the latest email from my bank" or '
+    '"send a slack message to the #general channel". '
+    "Each tool will have params associated with it that are specified as a list. You MUST take into account the params when creating the instruction. "
+    "For example, if the params are ['Message_Text', 'Channel'], your instruction should be something like 'send a slack message to the #general channel with the text hello world'. "
+    "Another example: if the params are ['Calendar', 'Search_Term'], your instruction should be something like 'find the meeting in my personal calendar at 3pm'. "
+    "Do not make up params, they will be explicitly specified in the tool description. "
+    "If you do not have enough information to fill in the params, just say 'not enough information provided in the instruction, missing <param>'. "
+    "If you get a none or null response, STOP EXECUTION, do not try to another tool!"
+    "This tool specifically used for: {zapier_description}, "
+    "and has params: {params}"
+)
diff --git a/llm/Lib/site-packages/langchain_community/tools/zapier/tool.py b/llm/Lib/site-packages/langchain_community/tools/zapier/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..22a25b13a971123c4b70903e61f08696e24b39d2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/tools/zapier/tool.py
@@ -0,0 +1,212 @@
+"""[DEPRECATED]
+
+## Zapier Natural Language Actions API
+\
+Full docs here: https://nla.zapier.com/start/
+
+**Zapier Natural Language Actions** gives you access to the 5k+ apps, 20k+ actions
+on Zapier's platform through a natural language API interface.
+
+NLA supports apps like Gmail, Salesforce, Trello, Slack, Asana, HubSpot, Google Sheets,
+Microsoft Teams, and thousands more apps: https://zapier.com/apps
+
+Zapier NLA handles ALL the underlying API auth and translation from
+natural language --> underlying API call --> return simplified output for LLMs
+The key idea is you, or your users, expose a set of actions via an oauth-like setup
+window, which you can then query and execute via a REST API.
+
+NLA offers both API Key and OAuth for signing NLA API requests.
+
+1. Server-side (API Key): for quickly getting started, testing, and production scenarios
+    where LangChain will only use actions exposed in the developer's Zapier account
+    (and will use the developer's connected accounts on Zapier.com)
+
+2. User-facing (Oauth): for production scenarios where you are deploying an end-user
+    facing application and LangChain needs access to end-user's exposed actions and
+    connected accounts on Zapier.com
+
+This quick start will focus on the server-side use case for brevity.
+Review [full docs](https://nla.zapier.com/start/) for user-facing oauth developer
+support.
+
+Typically, you'd use SequentialChain, here's a basic example:
+
+    1. Use NLA to find an email in Gmail
+    2. Use LLMChain to generate a draft reply to (1)
+    3. Use NLA to send the draft reply (2) to someone in Slack via direct message
+
+In code, below:
+
+```python
+
+import os
+
+# get from https://platform.openai.com/
+os.environ["OPENAI_API_KEY"] = os.environ.get("OPENAI_API_KEY", "")
+
+# get from https://nla.zapier.com/docs/authentication/
+os.environ["ZAPIER_NLA_API_KEY"] = os.environ.get("ZAPIER_NLA_API_KEY", "")
+
+from langchain_community.agent_toolkits import ZapierToolkit
+from langchain_community.utilities.zapier import ZapierNLAWrapper
+
+## step 0. expose gmail 'find email' and slack 'send channel message' actions
+
+# first go here, log in, expose (enable) the two actions:
+#    https://nla.zapier.com/demo/start
+#    -- for this example, can leave all fields "Have AI guess"
+# in an oauth scenario, you'd get your own <provider> id (instead of 'demo')
+# which you route your users through first
+
+zapier = ZapierNLAWrapper()
+## To leverage OAuth you may pass the value `nla_oauth_access_token` to
+## the ZapierNLAWrapper. If you do this there is no need to initialize
+## the ZAPIER_NLA_API_KEY env variable
+# zapier = ZapierNLAWrapper(zapier_nla_oauth_access_token="TOKEN_HERE")
+toolkit = ZapierToolkit.from_zapier_nla_wrapper(zapier)
+```
+
+"""
+from typing import Any, Dict, Optional
+
+from langchain_core._api import warn_deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForToolRun,
+    CallbackManagerForToolRun,
+)
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.tools import BaseTool
+
+from langchain_community.tools.zapier.prompt import BASE_ZAPIER_TOOL_PROMPT
+from langchain_community.utilities.zapier import ZapierNLAWrapper
+
+
+class ZapierNLARunAction(BaseTool):
+    """Tool to run a specific action from the user's exposed actions.
+
+    Params:
+        action_id: a specific action ID (from list actions) of the action to execute
+            (the set api_key must be associated with the action owner)
+        instructions: a natural language instruction string for using the action
+            (eg. "get the latest email from Mike Knoop" for "Gmail: find email" action)
+        params: a dict, optional. Any params provided will *override* AI guesses
+            from `instructions` (see "understanding the AI guessing flow" here:
+            https://nla.zapier.com/docs/using-the-api#ai-guessing)
+
+    """
+
+    api_wrapper: ZapierNLAWrapper = Field(default_factory=ZapierNLAWrapper)
+    action_id: str
+    params: Optional[dict] = None
+    base_prompt: str = BASE_ZAPIER_TOOL_PROMPT
+    zapier_description: str
+    params_schema: Dict[str, str] = Field(default_factory=dict)
+    name: str = ""
+    description: str = ""
+
+    @root_validator
+    def set_name_description(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        zapier_description = values["zapier_description"]
+        params_schema = values["params_schema"]
+        if "instructions" in params_schema:
+            del params_schema["instructions"]
+
+        # Ensure base prompt (if overridden) contains necessary input fields
+        necessary_fields = {"{zapier_description}", "{params}"}
+        if not all(field in values["base_prompt"] for field in necessary_fields):
+            raise ValueError(
+                "Your custom base Zapier prompt must contain input fields for "
+                "{zapier_description} and {params}."
+            )
+
+        values["name"] = zapier_description
+        values["description"] = values["base_prompt"].format(
+            zapier_description=zapier_description,
+            params=str(list(params_schema.keys())),
+        )
+        return values
+
+    def _run(
+        self, instructions: str, run_manager: Optional[CallbackManagerForToolRun] = None
+    ) -> str:
+        """Use the Zapier NLA tool to return a list of all exposed user actions."""
+        warn_deprecated(
+            since="0.0.319",
+            message=(
+                "This tool will be deprecated on 2023-11-17. See "
+                "https://nla.zapier.com/sunset/ for details"
+            ),
+        )
+        return self.api_wrapper.run_as_str(self.action_id, instructions, self.params)
+
+    async def _arun(
+        self,
+        instructions: str,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Zapier NLA tool to return a list of all exposed user actions."""
+        warn_deprecated(
+            since="0.0.319",
+            message=(
+                "This tool will be deprecated on 2023-11-17. See "
+                "https://nla.zapier.com/sunset/ for details"
+            ),
+        )
+        return await self.api_wrapper.arun_as_str(
+            self.action_id,
+            instructions,
+            self.params,
+        )
+
+
+ZapierNLARunAction.__doc__ = (
+    ZapierNLAWrapper.run.__doc__ + ZapierNLARunAction.__doc__  # type: ignore
+)
+
+
+# other useful actions
+
+
+class ZapierNLAListActions(BaseTool):
+    """Tool to list all exposed actions for the user."""
+
+    name: str = "ZapierNLA_list_actions"
+    description: str = BASE_ZAPIER_TOOL_PROMPT + (
+        "This tool returns a list of the user's exposed actions."
+    )
+    api_wrapper: ZapierNLAWrapper = Field(default_factory=ZapierNLAWrapper)
+
+    def _run(
+        self,
+        _: str = "",
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Zapier NLA tool to return a list of all exposed user actions."""
+        warn_deprecated(
+            since="0.0.319",
+            message=(
+                "This tool will be deprecated on 2023-11-17. See "
+                "https://nla.zapier.com/sunset/ for details"
+            ),
+        )
+        return self.api_wrapper.list_as_str()
+
+    async def _arun(
+        self,
+        _: str = "",
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+    ) -> str:
+        """Use the Zapier NLA tool to return a list of all exposed user actions."""
+        warn_deprecated(
+            since="0.0.319",
+            message=(
+                "This tool will be deprecated on 2023-11-17. See "
+                "https://nla.zapier.com/sunset/ for details"
+            ),
+        )
+        return await self.api_wrapper.alist_as_str()
+
+
+ZapierNLAListActions.__doc__ = (
+    ZapierNLAWrapper.list.__doc__ + ZapierNLAListActions.__doc__  # type: ignore
+)
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__init__.py b/llm/Lib/site-packages/langchain_community/utilities/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..148447c8446ce17b18cf51fc0f04f15c4e598b70
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/__init__.py
@@ -0,0 +1,292 @@
+"""**Utilities** are the integrations with third-part systems and packages.
+
+Other LangChain classes use **Utilities** to interact with third-part systems
+and packages.
+"""
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_community.utilities.alpha_vantage import (
+        AlphaVantageAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.apify import (
+        ApifyWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.arcee import (
+        ArceeWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.arxiv import (
+        ArxivAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.awslambda import (
+        LambdaWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.bibtex import (
+        BibtexparserWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.bing_search import (
+        BingSearchAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.brave_search import (
+        BraveSearchWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.dria_index import (
+        DriaAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.duckduckgo_search import (
+        DuckDuckGoSearchAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.golden_query import (
+        GoldenQueryAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.google_finance import (
+        GoogleFinanceAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.google_jobs import (
+        GoogleJobsAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.google_lens import (
+        GoogleLensAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.google_places_api import (
+        GooglePlacesAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.google_scholar import (
+        GoogleScholarAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.google_search import (
+        GoogleSearchAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.google_serper import (
+        GoogleSerperAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.google_trends import (
+        GoogleTrendsAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.graphql import (
+        GraphQLAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.infobip import (
+        InfobipAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.jira import (
+        JiraAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.max_compute import (
+        MaxComputeAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.merriam_webster import (
+        MerriamWebsterAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.metaphor_search import (
+        MetaphorSearchAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.nasa import (
+        NasaAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.nvidia_riva import (
+        AudioStream,  # noqa: F401
+        NVIDIARivaASR,  # noqa: F401
+        NVIDIARivaStream,  # noqa: F401
+        NVIDIARivaTTS,  # noqa: F401
+        RivaASR,  # noqa: F401
+        RivaTTS,  # noqa: F401
+    )
+    from langchain_community.utilities.openweathermap import (
+        OpenWeatherMapAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.outline import (
+        OutlineAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.passio_nutrition_ai import (
+        NutritionAIAPI,  # noqa: F401
+    )
+    from langchain_community.utilities.portkey import (
+        Portkey,  # noqa: F401
+    )
+    from langchain_community.utilities.powerbi import (
+        PowerBIDataset,  # noqa: F401
+    )
+    from langchain_community.utilities.pubmed import (
+        PubMedAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.python import (
+        PythonREPL,  # noqa: F401
+    )
+    from langchain_community.utilities.requests import (
+        Requests,  # noqa: F401
+        RequestsWrapper,  # noqa: F401
+        TextRequestsWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.scenexplain import (
+        SceneXplainAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.searchapi import (
+        SearchApiAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.searx_search import (
+        SearxSearchWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.serpapi import (
+        SerpAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.spark_sql import (
+        SparkSQL,  # noqa: F401
+    )
+    from langchain_community.utilities.sql_database import (
+        SQLDatabase,  # noqa: F401
+    )
+    from langchain_community.utilities.stackexchange import (
+        StackExchangeAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.steam import (
+        SteamWebAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.tensorflow_datasets import (
+        TensorflowDatasets,  # noqa: F401
+    )
+    from langchain_community.utilities.twilio import (
+        TwilioAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.wikipedia import (
+        WikipediaAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.wolfram_alpha import (
+        WolframAlphaAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.you import (
+        YouSearchAPIWrapper,  # noqa: F401
+    )
+    from langchain_community.utilities.zapier import (
+        ZapierNLAWrapper,  # noqa: F401
+    )
+
+__all__ = [
+    "AlphaVantageAPIWrapper",
+    "ApifyWrapper",
+    "ArceeWrapper",
+    "ArxivAPIWrapper",
+    "AudioStream",
+    "BibtexparserWrapper",
+    "BingSearchAPIWrapper",
+    "BraveSearchWrapper",
+    "DriaAPIWrapper",
+    "DuckDuckGoSearchAPIWrapper",
+    "GoldenQueryAPIWrapper",
+    "GoogleFinanceAPIWrapper",
+    "GoogleJobsAPIWrapper",
+    "GoogleLensAPIWrapper",
+    "GooglePlacesAPIWrapper",
+    "GoogleScholarAPIWrapper",
+    "GoogleSearchAPIWrapper",
+    "GoogleSerperAPIWrapper",
+    "GoogleTrendsAPIWrapper",
+    "GraphQLAPIWrapper",
+    "InfobipAPIWrapper",
+    "JiraAPIWrapper",
+    "LambdaWrapper",
+    "MaxComputeAPIWrapper",
+    "MerriamWebsterAPIWrapper",
+    "MetaphorSearchAPIWrapper",
+    "NVIDIARivaASR",
+    "NVIDIARivaStream",
+    "NVIDIARivaTTS",
+    "NasaAPIWrapper",
+    "NutritionAIAPI",
+    "OpenWeatherMapAPIWrapper",
+    "OutlineAPIWrapper",
+    "Portkey",
+    "PowerBIDataset",
+    "PubMedAPIWrapper",
+    "PythonREPL",
+    "Requests",
+    "RequestsWrapper",
+    "RivaASR",
+    "RivaTTS",
+    "SQLDatabase",
+    "SceneXplainAPIWrapper",
+    "SearchApiAPIWrapper",
+    "SearxSearchWrapper",
+    "SerpAPIWrapper",
+    "SparkSQL",
+    "StackExchangeAPIWrapper",
+    "SteamWebAPIWrapper",
+    "TensorflowDatasets",
+    "TextRequestsWrapper",
+    "TwilioAPIWrapper",
+    "WikipediaAPIWrapper",
+    "WolframAlphaAPIWrapper",
+    "YouSearchAPIWrapper",
+    "ZapierNLAWrapper",
+]
+
+_module_lookup = {
+    "AlphaVantageAPIWrapper": "langchain_community.utilities.alpha_vantage",
+    "ApifyWrapper": "langchain_community.utilities.apify",
+    "ArceeWrapper": "langchain_community.utilities.arcee",
+    "ArxivAPIWrapper": "langchain_community.utilities.arxiv",
+    "AudioStream": "langchain_community.utilities.nvidia_riva",
+    "BibtexparserWrapper": "langchain_community.utilities.bibtex",
+    "BingSearchAPIWrapper": "langchain_community.utilities.bing_search",
+    "BraveSearchWrapper": "langchain_community.utilities.brave_search",
+    "DataheraldAPIWrapper": "langchain_community.utilities.dataherald",
+    "DriaAPIWrapper": "langchain_community.utilities.dria_index",
+    "DuckDuckGoSearchAPIWrapper": "langchain_community.utilities.duckduckgo_search",
+    "GoldenQueryAPIWrapper": "langchain_community.utilities.golden_query",
+    "GoogleFinanceAPIWrapper": "langchain_community.utilities.google_finance",
+    "GoogleJobsAPIWrapper": "langchain_community.utilities.google_jobs",
+    "GoogleLensAPIWrapper": "langchain_community.utilities.google_lens",
+    "GooglePlacesAPIWrapper": "langchain_community.utilities.google_places_api",
+    "GoogleScholarAPIWrapper": "langchain_community.utilities.google_scholar",
+    "GoogleSearchAPIWrapper": "langchain_community.utilities.google_search",
+    "GoogleSerperAPIWrapper": "langchain_community.utilities.google_serper",
+    "GoogleTrendsAPIWrapper": "langchain_community.utilities.google_trends",
+    "GraphQLAPIWrapper": "langchain_community.utilities.graphql",
+    "InfobipAPIWrapper": "langchain_community.utilities.infobip",
+    "JiraAPIWrapper": "langchain_community.utilities.jira",
+    "LambdaWrapper": "langchain_community.utilities.awslambda",
+    "MaxComputeAPIWrapper": "langchain_community.utilities.max_compute",
+    "MerriamWebsterAPIWrapper": "langchain_community.utilities.merriam_webster",
+    "MetaphorSearchAPIWrapper": "langchain_community.utilities.metaphor_search",
+    "NVIDIARivaASR": "langchain_community.utilities.nvidia_riva",
+    "NVIDIARivaStream": "langchain_community.utilities.nvidia_riva",
+    "NVIDIARivaTTS": "langchain_community.utilities.nvidia_riva",
+    "NasaAPIWrapper": "langchain_community.utilities.nasa",
+    "NutritionAIAPI": "langchain_community.utilities.passio_nutrition_ai",
+    "OpenWeatherMapAPIWrapper": "langchain_community.utilities.openweathermap",
+    "OutlineAPIWrapper": "langchain_community.utilities.outline",
+    "Portkey": "langchain_community.utilities.portkey",
+    "PowerBIDataset": "langchain_community.utilities.powerbi",
+    "PubMedAPIWrapper": "langchain_community.utilities.pubmed",
+    "PythonREPL": "langchain_community.utilities.python",
+    "Requests": "langchain_community.utilities.requests",
+    "RequestsWrapper": "langchain_community.utilities.requests",
+    "RivaASR": "langchain_community.utilities.nvidia_riva",
+    "RivaTTS": "langchain_community.utilities.nvidia_riva",
+    "SQLDatabase": "langchain_community.utilities.sql_database",
+    "SceneXplainAPIWrapper": "langchain_community.utilities.scenexplain",
+    "SearchApiAPIWrapper": "langchain_community.utilities.searchapi",
+    "SearxSearchWrapper": "langchain_community.utilities.searx_search",
+    "SerpAPIWrapper": "langchain_community.utilities.serpapi",
+    "SparkSQL": "langchain_community.utilities.spark_sql",
+    "StackExchangeAPIWrapper": "langchain_community.utilities.stackexchange",
+    "SteamWebAPIWrapper": "langchain_community.utilities.steam",
+    "TensorflowDatasets": "langchain_community.utilities.tensorflow_datasets",
+    "TextRequestsWrapper": "langchain_community.utilities.requests",
+    "TwilioAPIWrapper": "langchain_community.utilities.twilio",
+    "WikipediaAPIWrapper": "langchain_community.utilities.wikipedia",
+    "WolframAlphaAPIWrapper": "langchain_community.utilities.wolfram_alpha",
+    "YouSearchAPIWrapper": "langchain_community.utilities.you",
+    "ZapierNLAWrapper": "langchain_community.utilities.zapier",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5ec557bd251d5309801290d3f93a0b5110fd8162
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/alpha_vantage.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/alpha_vantage.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9795f715e4e76dab234c35761b0873e96a5706a5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/alpha_vantage.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/anthropic.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/anthropic.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9d0c1a0c18110378178994d4e22e40646c16ceec
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/anthropic.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/apify.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/apify.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..00faada90776c51e2273d6b9538cb18613795d9d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/apify.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/arcee.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/arcee.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9c99ab29896b3ed5a7be9b0d5877f8f6ed12fb0b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/arcee.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/arxiv.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/arxiv.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..20f14e318ca7e133716880e440576590b2e44334
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/arxiv.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/astradb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/astradb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7af234f4f18337f1b5c5adf6e773019949cc7807
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/astradb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/awslambda.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/awslambda.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2369ab4be3374013d6160e123b86315984dd0c54
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/awslambda.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/bibtex.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/bibtex.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..af251b1f140bb8cde5a55eb7a061876960de3208
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/bibtex.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/bing_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/bing_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..65a6cdf4a9676b8407560888371adeb7c3021b5b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/bing_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/brave_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/brave_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..16741a790803cdde34eff63f4f5d1742774eafc2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/brave_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/cassandra.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/cassandra.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..97f0840939d3b63528d6775a85fa4ea9869a6d2d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/cassandra.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/clickup.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/clickup.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ee57fdad01bf9830dbc17085fb510de5a75a3045
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/clickup.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/dalle_image_generator.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/dalle_image_generator.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6ba9ad63c13daf046d50054e7f108179189c9f51
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/dalle_image_generator.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/dataforseo_api_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/dataforseo_api_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..824785163cdf269908395c556734fb0eed415e71
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/dataforseo_api_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/dataherald.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/dataherald.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0c6b572690c123e14f0fa9f822bce781b1041db6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/dataherald.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/dria_index.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/dria_index.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ef7482e6953647417e5e20abe3b93a05d9761739
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/dria_index.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/duckduckgo_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/duckduckgo_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..66a738d8096ccf907b5e7020055d0ee0a614afaf
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/duckduckgo_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/github.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/github.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4a49b97485041434041c802a76334bf746a1ec88
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/github.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/gitlab.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/gitlab.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..757cad600e38dea5d5c83fe3c9704bf9100714af
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/gitlab.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/golden_query.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/golden_query.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..04d06218d11a84b4f3f8e026dc6df83ebb02468d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/golden_query.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_finance.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_finance.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f4c6cd3715710ab931450a3842b0ad2134c9a630
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_finance.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_jobs.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_jobs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b05bc490e070c81c3f4afdefc676ec44e9f5c2c7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_jobs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_lens.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_lens.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a2973645d7ce3322c7c1b92f9065311a44cbca54
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_lens.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_places_api.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_places_api.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..02425b84dcb90c7dcd81a863073b316f3bc1eddd
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_places_api.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_scholar.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_scholar.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..81c2d31f20e2dc13759c9d22bd4b962d33ea959e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_scholar.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f4e3d2b524338f23f19d5d77db2e93398c33d712
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_serper.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_serper.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..381f31235fc6575f68006eb84f9febfe4f97133d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_serper.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_trends.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_trends.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0e2d455a9032a7642ec546abdb8167945a4147b9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/google_trends.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/graphql.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/graphql.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e5ba555029042e510a787f6dbd595e1e6e7516ef
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/graphql.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/infobip.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/infobip.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2a81e6a98444481c3515eb82e4bdd0e67c9ee8e3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/infobip.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/jira.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/jira.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e081b5f706e268b5c18af9b18da66ff61d68eebb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/jira.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/max_compute.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/max_compute.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..712143c1ba23e412846c1e26d027f0eb24202e53
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/max_compute.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/merriam_webster.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/merriam_webster.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..642005b58aac3c138cfbeea59239b4115e13b129
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/merriam_webster.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/metaphor_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/metaphor_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..da47e7805ab73d2d5d6a7ad5c03beb766f74956b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/metaphor_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/nasa.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/nasa.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c81153c36f58a7d7a025cee0e4e67198f5e07f52
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/nasa.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/nvidia_riva.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/nvidia_riva.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f5024eaeb847d9e8bc07763dbd358e60a3350011
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/nvidia_riva.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/opaqueprompts.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/opaqueprompts.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0b09bb8a192c4793f09f92ad6bb6c9980a41866c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/opaqueprompts.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/openapi.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/openapi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f941a29a2d6d309fbd83942b476083aae51c34c3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/openapi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/openweathermap.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/openweathermap.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7ab5de50869f6ac2ad336ff864ff87c2136c47b7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/openweathermap.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/outline.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/outline.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dc5ba929fca46c918e94908899255ca9be6ee991
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/outline.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/passio_nutrition_ai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/passio_nutrition_ai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..76c3fdfc26bf36b0c230b10ee5970670c2870eb0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/passio_nutrition_ai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/pebblo.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/pebblo.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2a099e29a530b57dfa751d8f08902f5d690ac16d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/pebblo.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/polygon.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/polygon.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dbc24f79974c33b4205327a381578556a292ea36
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/polygon.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/portkey.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/portkey.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..68399f2a6bc24c72bf7b770247e0e15bacfb7103
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/portkey.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/powerbi.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/powerbi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3e836d9e75368999726942e3802dcb8728f6dcce
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/powerbi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/pubmed.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/pubmed.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f7154f21603d64e88593206aaaaee364edb9e418
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/pubmed.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/python.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/python.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eafdb38c91173ef8860950d6b1add43bfda58614
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/python.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/reddit_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/reddit_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cec2ebff426a69da79b55ba5db37420c0c6b0b70
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/reddit_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/redis.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/redis.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b13121fff72fd2ef59b663bac6efe02b1300d5fe
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/redis.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/requests.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/requests.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..01306b30c8ce8f73e807049f1c805b13935e8501
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/requests.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/scenexplain.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/scenexplain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9f3602575843d19fc7cc59c3b72e17498e442b75
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/scenexplain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/searchapi.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/searchapi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e8a7d9e1d25c568e16fa9785f98e224e503e825d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/searchapi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/searx_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/searx_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b1695ca126f691040f0aa905967c5eae5296cb64
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/searx_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/semanticscholar.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/semanticscholar.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c2e1c33d7384cff4f2430c7d01904606e004805e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/semanticscholar.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/serpapi.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/serpapi.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ca0339045a9a16f8c61aad3f5027aa4acc995b06
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/serpapi.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/spark_sql.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/spark_sql.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..45500dd48958a112cae359d205c3a1e925c443d7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/spark_sql.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/sql_database.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/sql_database.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..adeab8cfefeaa503e34e68e7d7a62c51c1eee914
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/sql_database.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/stackexchange.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/stackexchange.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ee3495eff2f129fc18962a473c541a7331eddd8c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/stackexchange.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/steam.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/steam.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..70e7d067f050bc1b565fb0d864dc4f1e5c530515
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/steam.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/tavily_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/tavily_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..741e3c398e1571f8b29b89fc0790934143dda8d4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/tavily_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/tensorflow_datasets.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/tensorflow_datasets.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..393c817365825e949db29483d2d825d8680be9f6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/tensorflow_datasets.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/twilio.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/twilio.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..713ec5596ae02fe72b94b2e1c0d851db0a26893b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/twilio.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/vertexai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/vertexai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bab3f054147fb981751e7dafa12850ade92dc808
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/vertexai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/wikidata.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/wikidata.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d29c2d499cc25d46ee652a84f5eac681ce51f9e6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/wikidata.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/wikipedia.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/wikipedia.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..259b78a85c24a29a5f1b3fd46e2a1382000dd17b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/wikipedia.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/wolfram_alpha.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/wolfram_alpha.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..92ed303e88ca144063369cd9d57364830d03a220
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/wolfram_alpha.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/you.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/you.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3f9da9857dd1f163584b9ac24ab9d659e7fcdde4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/you.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/__pycache__/zapier.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/zapier.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c09d9d66c3fc498d665a5ae87c6b52cd0f284439
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utilities/__pycache__/zapier.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utilities/alpha_vantage.py b/llm/Lib/site-packages/langchain_community/utilities/alpha_vantage.py
new file mode 100644
index 0000000000000000000000000000000000000000..926eec137d5f8be089c4e4a6fd8b4964576de9e0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/alpha_vantage.py
@@ -0,0 +1,175 @@
+"""Util that calls AlphaVantage for Currency Exchange Rate."""
+from typing import Any, Dict, List, Optional
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class AlphaVantageAPIWrapper(BaseModel):
+    """Wrapper for AlphaVantage API for Currency Exchange Rate.
+
+    Docs for using:
+
+    1. Go to AlphaVantage and sign up for an API key
+    2. Save your API KEY into ALPHAVANTAGE_API_KEY env variable
+    """
+
+    alphavantage_api_key: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        values["alphavantage_api_key"] = get_from_dict_or_env(
+            values, "alphavantage_api_key", "ALPHAVANTAGE_API_KEY"
+        )
+        return values
+
+    def search_symbols(self, keywords: str) -> Dict[str, Any]:
+        """Make a request to the AlphaVantage API to search for symbols."""
+        response = requests.get(
+            "https://www.alphavantage.co/query/",
+            params={
+                "function": "SYMBOL_SEARCH",
+                "keywords": keywords,
+                "apikey": self.alphavantage_api_key,
+            },
+        )
+        response.raise_for_status()
+        data = response.json()
+
+        if "Error Message" in data:
+            raise ValueError(f"API Error: {data['Error Message']}")
+
+        return data
+
+    def _get_market_news_sentiment(self, symbol: str) -> Dict[str, Any]:
+        """Make a request to the AlphaVantage API to get market news sentiment for a
+        given symbol."""
+        response = requests.get(
+            "https://www.alphavantage.co/query/",
+            params={
+                "function": "NEWS_SENTIMENT",
+                "symbol": symbol,
+                "apikey": self.alphavantage_api_key,
+            },
+        )
+        response.raise_for_status()
+        data = response.json()
+
+        if "Error Message" in data:
+            raise ValueError(f"API Error: {data['Error Message']}")
+
+        return data
+
+    def _get_time_series_daily(self, symbol: str) -> Dict[str, Any]:
+        """Make a request to the AlphaVantage API to get the daily time series."""
+        response = requests.get(
+            "https://www.alphavantage.co/query/",
+            params={
+                "function": "TIME_SERIES_DAILY",
+                "symbol": symbol,
+                "apikey": self.alphavantage_api_key,
+            },
+        )
+        response.raise_for_status()
+        data = response.json()
+
+        if "Error Message" in data:
+            raise ValueError(f"API Error: {data['Error Message']}")
+
+        return data
+
+    def _get_quote_endpoint(self, symbol: str) -> Dict[str, Any]:
+        """Make a request to the AlphaVantage API to get the
+        latest price and volume information."""
+        response = requests.get(
+            "https://www.alphavantage.co/query/",
+            params={
+                "function": "GLOBAL_QUOTE",
+                "symbol": symbol,
+                "apikey": self.alphavantage_api_key,
+            },
+        )
+        response.raise_for_status()
+        data = response.json()
+
+        if "Error Message" in data:
+            raise ValueError(f"API Error: {data['Error Message']}")
+
+        return data
+
+    def _get_time_series_weekly(self, symbol: str) -> Dict[str, Any]:
+        """Make a request to the AlphaVantage API
+        to get the Weekly Time Series."""
+        response = requests.get(
+            "https://www.alphavantage.co/query/",
+            params={
+                "function": "TIME_SERIES_WEEKLY",
+                "symbol": symbol,
+                "apikey": self.alphavantage_api_key,
+            },
+        )
+        response.raise_for_status()
+        data = response.json()
+
+        if "Error Message" in data:
+            raise ValueError(f"API Error: {data['Error Message']}")
+
+        return data
+
+    def _get_top_gainers_losers(self) -> Dict[str, Any]:
+        """Make a request to the AlphaVantage API to get the top gainers, losers,
+        and most actively traded tickers in the US market."""
+        response = requests.get(
+            "https://www.alphavantage.co/query/",
+            params={
+                "function": "TOP_GAINERS_LOSERS",
+                "apikey": self.alphavantage_api_key,
+            },
+        )
+        response.raise_for_status()
+        data = response.json()
+
+        if "Error Message" in data:
+            raise ValueError(f"API Error: {data['Error Message']}")
+
+        return data
+
+    def _get_exchange_rate(
+        self, from_currency: str, to_currency: str
+    ) -> Dict[str, Any]:
+        """Make a request to the AlphaVantage API to get the exchange rate."""
+        response = requests.get(
+            "https://www.alphavantage.co/query/",
+            params={
+                "function": "CURRENCY_EXCHANGE_RATE",
+                "from_currency": from_currency,
+                "to_currency": to_currency,
+                "apikey": self.alphavantage_api_key,
+            },
+        )
+        response.raise_for_status()
+        data = response.json()
+
+        if "Error Message" in data:
+            raise ValueError(f"API Error: {data['Error Message']}")
+
+        return data
+
+    @property
+    def standard_currencies(self) -> List[str]:
+        return ["USD", "EUR", "GBP", "JPY", "CHF", "CAD", "AUD", "NZD"]
+
+    def run(self, from_currency: str, to_currency: str) -> str:
+        """Get the current exchange rate for a specified currency pair."""
+        if to_currency not in self.standard_currencies:
+            from_currency, to_currency = to_currency, from_currency
+
+        data = self._get_exchange_rate(from_currency, to_currency)
+        return data["Realtime Currency Exchange Rate"]
diff --git a/llm/Lib/site-packages/langchain_community/utilities/anthropic.py b/llm/Lib/site-packages/langchain_community/utilities/anthropic.py
new file mode 100644
index 0000000000000000000000000000000000000000..31bb4015b1d4f7346552b30082bc3e88336b3b6f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/anthropic.py
@@ -0,0 +1,27 @@
+from typing import Any, List
+
+
+def _get_anthropic_client() -> Any:
+    try:
+        import anthropic
+    except ImportError:
+        raise ImportError(
+            "Could not import anthropic python package. "
+            "This is needed in order to accurately tokenize the text "
+            "for anthropic models. Please install it with `pip install anthropic`."
+        )
+    return anthropic.Anthropic()
+
+
+def get_num_tokens_anthropic(text: str) -> int:
+    """Get the number of tokens in a string of text."""
+    client = _get_anthropic_client()
+    return client.count_tokens(text=text)
+
+
+def get_token_ids_anthropic(text: str) -> List[int]:
+    """Get the token ids for a string of text."""
+    client = _get_anthropic_client()
+    tokenizer = client.get_tokenizer()
+    encoded_text = tokenizer.encode(text)
+    return encoded_text.ids
diff --git a/llm/Lib/site-packages/langchain_community/utilities/apify.py b/llm/Lib/site-packages/langchain_community/utilities/apify.py
new file mode 100644
index 0000000000000000000000000000000000000000..6f37f84f21e1d36919bd40692ab72340660bb62d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/apify.py
@@ -0,0 +1,204 @@
+from typing import TYPE_CHECKING, Any, Callable, Dict, Optional
+
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+if TYPE_CHECKING:
+    from langchain_community.document_loaders import ApifyDatasetLoader
+
+
+class ApifyWrapper(BaseModel):
+    """Wrapper around Apify.
+    To use, you should have the ``apify-client`` python package installed,
+    and the environment variable ``APIFY_API_TOKEN`` set with your API key, or pass
+    `apify_api_token` as a named parameter to the constructor.
+    """
+
+    apify_client: Any
+    apify_client_async: Any
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate environment.
+        Validate that an Apify API token is set and the apify-client
+        Python package exists in the current environment.
+        """
+        apify_api_token = get_from_dict_or_env(
+            values, "apify_api_token", "APIFY_API_TOKEN"
+        )
+
+        try:
+            from apify_client import ApifyClient, ApifyClientAsync
+
+            values["apify_client"] = ApifyClient(apify_api_token)
+            values["apify_client_async"] = ApifyClientAsync(apify_api_token)
+        except ImportError:
+            raise ImportError(
+                "Could not import apify-client Python package. "
+                "Please install it with `pip install apify-client`."
+            )
+
+        return values
+
+    def call_actor(
+        self,
+        actor_id: str,
+        run_input: Dict,
+        dataset_mapping_function: Callable[[Dict], Document],
+        *,
+        build: Optional[str] = None,
+        memory_mbytes: Optional[int] = None,
+        timeout_secs: Optional[int] = None,
+    ) -> "ApifyDatasetLoader":
+        """Run an Actor on the Apify platform and wait for results to be ready.
+        Args:
+            actor_id (str): The ID or name of the Actor on the Apify platform.
+            run_input (Dict): The input object of the Actor that you're trying to run.
+            dataset_mapping_function (Callable): A function that takes a single
+                dictionary (an Apify dataset item) and converts it to an
+                instance of the Document class.
+            build (str, optional): Optionally specifies the actor build to run.
+                It can be either a build tag or build number.
+            memory_mbytes (int, optional): Optional memory limit for the run,
+                in megabytes.
+            timeout_secs (int, optional): Optional timeout for the run, in seconds.
+        Returns:
+            ApifyDatasetLoader: A loader that will fetch the records from the
+                Actor run's default dataset.
+        """
+        from langchain_community.document_loaders import ApifyDatasetLoader
+
+        actor_call = self.apify_client.actor(actor_id).call(
+            run_input=run_input,
+            build=build,
+            memory_mbytes=memory_mbytes,
+            timeout_secs=timeout_secs,
+        )
+
+        return ApifyDatasetLoader(
+            dataset_id=actor_call["defaultDatasetId"],
+            dataset_mapping_function=dataset_mapping_function,
+        )
+
+    async def acall_actor(
+        self,
+        actor_id: str,
+        run_input: Dict,
+        dataset_mapping_function: Callable[[Dict], Document],
+        *,
+        build: Optional[str] = None,
+        memory_mbytes: Optional[int] = None,
+        timeout_secs: Optional[int] = None,
+    ) -> "ApifyDatasetLoader":
+        """Run an Actor on the Apify platform and wait for results to be ready.
+        Args:
+            actor_id (str): The ID or name of the Actor on the Apify platform.
+            run_input (Dict): The input object of the Actor that you're trying to run.
+            dataset_mapping_function (Callable): A function that takes a single
+                dictionary (an Apify dataset item) and converts it to
+                an instance of the Document class.
+            build (str, optional): Optionally specifies the actor build to run.
+                It can be either a build tag or build number.
+            memory_mbytes (int, optional): Optional memory limit for the run,
+                in megabytes.
+            timeout_secs (int, optional): Optional timeout for the run, in seconds.
+        Returns:
+            ApifyDatasetLoader: A loader that will fetch the records from the
+                Actor run's default dataset.
+        """
+        from langchain_community.document_loaders import ApifyDatasetLoader
+
+        actor_call = await self.apify_client_async.actor(actor_id).call(
+            run_input=run_input,
+            build=build,
+            memory_mbytes=memory_mbytes,
+            timeout_secs=timeout_secs,
+        )
+
+        return ApifyDatasetLoader(
+            dataset_id=actor_call["defaultDatasetId"],
+            dataset_mapping_function=dataset_mapping_function,
+        )
+
+    def call_actor_task(
+        self,
+        task_id: str,
+        task_input: Dict,
+        dataset_mapping_function: Callable[[Dict], Document],
+        *,
+        build: Optional[str] = None,
+        memory_mbytes: Optional[int] = None,
+        timeout_secs: Optional[int] = None,
+    ) -> "ApifyDatasetLoader":
+        """Run a saved Actor task on Apify and wait for results to be ready.
+        Args:
+            task_id (str): The ID or name of the task on the Apify platform.
+            task_input (Dict): The input object of the task that you're trying to run.
+                Overrides the task's saved input.
+            dataset_mapping_function (Callable): A function that takes a single
+                dictionary (an Apify dataset item) and converts it to an
+                instance of the Document class.
+            build (str, optional): Optionally specifies the actor build to run.
+                It can be either a build tag or build number.
+            memory_mbytes (int, optional): Optional memory limit for the run,
+                in megabytes.
+            timeout_secs (int, optional): Optional timeout for the run, in seconds.
+        Returns:
+            ApifyDatasetLoader: A loader that will fetch the records from the
+                task run's default dataset.
+        """
+        from langchain_community.document_loaders import ApifyDatasetLoader
+
+        task_call = self.apify_client.task(task_id).call(
+            task_input=task_input,
+            build=build,
+            memory_mbytes=memory_mbytes,
+            timeout_secs=timeout_secs,
+        )
+
+        return ApifyDatasetLoader(
+            dataset_id=task_call["defaultDatasetId"],
+            dataset_mapping_function=dataset_mapping_function,
+        )
+
+    async def acall_actor_task(
+        self,
+        task_id: str,
+        task_input: Dict,
+        dataset_mapping_function: Callable[[Dict], Document],
+        *,
+        build: Optional[str] = None,
+        memory_mbytes: Optional[int] = None,
+        timeout_secs: Optional[int] = None,
+    ) -> "ApifyDatasetLoader":
+        """Run a saved Actor task on Apify and wait for results to be ready.
+        Args:
+            task_id (str): The ID or name of the task on the Apify platform.
+            task_input (Dict): The input object of the task that you're trying to run.
+                Overrides the task's saved input.
+            dataset_mapping_function (Callable): A function that takes a single
+                dictionary (an Apify dataset item) and converts it to an
+                instance of the Document class.
+            build (str, optional): Optionally specifies the actor build to run.
+                It can be either a build tag or build number.
+            memory_mbytes (int, optional): Optional memory limit for the run,
+                in megabytes.
+            timeout_secs (int, optional): Optional timeout for the run, in seconds.
+        Returns:
+            ApifyDatasetLoader: A loader that will fetch the records from the
+                task run's default dataset.
+        """
+        from langchain_community.document_loaders import ApifyDatasetLoader
+
+        task_call = await self.apify_client_async.task(task_id).call(
+            task_input=task_input,
+            build=build,
+            memory_mbytes=memory_mbytes,
+            timeout_secs=timeout_secs,
+        )
+
+        return ApifyDatasetLoader(
+            dataset_id=task_call["defaultDatasetId"],
+            dataset_mapping_function=dataset_mapping_function,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/utilities/arcee.py b/llm/Lib/site-packages/langchain_community/utilities/arcee.py
new file mode 100644
index 0000000000000000000000000000000000000000..7217034858310f580ad429326191a1c320e7fd83
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/arcee.py
@@ -0,0 +1,255 @@
+# This module contains utility classes and functions for interacting with Arcee API.
+# For more information and updates, refer to the Arcee utils page:
+# [https://github.com/arcee-ai/arcee-python/blob/main/arcee/dalm.py]
+
+from enum import Enum
+from typing import Any, Dict, List, Literal, Mapping, Optional, Union
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, SecretStr, root_validator
+from langchain_core.retrievers import Document
+
+
+class ArceeRoute(str, Enum):
+    """Routes available for the Arcee API as enumerator."""
+
+    generate = "models/generate"
+    retrieve = "models/retrieve"
+    model_training_status = "models/status/{id_or_name}"
+
+
+class DALMFilterType(str, Enum):
+    """Filter types available for a DALM retrieval as enumerator."""
+
+    fuzzy_search = "fuzzy_search"
+    strict_search = "strict_search"
+
+
+class DALMFilter(BaseModel):
+    """Filters available for a DALM retrieval and generation.
+
+    Arguments:
+        field_name: The field to filter on. Can be 'document' or 'name' to filter
+            on your document's raw text or title. Any other field will be presumed
+            to be a metadata field you included when uploading your context data
+        filter_type: Currently 'fuzzy_search' and 'strict_search' are supported.
+            'fuzzy_search' means a fuzzy search on the provided field is performed.
+            The exact strict doesn't need to exist in the document
+            for this to find a match.
+            Very useful for scanning a document for some keyword terms.
+            'strict_search' means that the exact string must appear
+            in the provided field.
+            This is NOT an exact eq filter. ie a document with content
+            "the happy dog crossed the street" will match on a strict_search of
+            "dog" but won't match on "the dog".
+            Python equivalent of `return search_string in full_string`.
+        value: The actual value to search for in the context data/metadata
+    """
+
+    field_name: str
+    filter_type: DALMFilterType
+    value: str
+    _is_metadata: bool = False
+
+    @root_validator()
+    def set_meta(cls, values: Dict) -> Dict:
+        """document and name are reserved arcee keys. Anything else is metadata"""
+        values["_is_meta"] = values.get("field_name") not in ["document", "name"]
+        return values
+
+
+class ArceeDocumentSource(BaseModel):
+    """Source of an Arcee document."""
+
+    document: str
+    name: str
+    id: str
+
+
+class ArceeDocument(BaseModel):
+    """Arcee document."""
+
+    index: str
+    id: str
+    score: float
+    source: ArceeDocumentSource
+
+
+class ArceeDocumentAdapter:
+    """Adapter for Arcee documents"""
+
+    @classmethod
+    def adapt(cls, arcee_document: ArceeDocument) -> Document:
+        """Adapts an `ArceeDocument` to a langchain's `Document` object."""
+        return Document(
+            page_content=arcee_document.source.document,
+            metadata={
+                # arcee document; source metadata
+                "name": arcee_document.source.name,
+                "source_id": arcee_document.source.id,
+                # arcee document metadata
+                "index": arcee_document.index,
+                "id": arcee_document.id,
+                "score": arcee_document.score,
+            },
+        )
+
+
+class ArceeWrapper:
+    """Wrapper for Arcee API.
+
+    For more details, see: https://www.arcee.ai/
+    """
+
+    def __init__(
+        self,
+        arcee_api_key: Union[str, SecretStr],
+        arcee_api_url: str,
+        arcee_api_version: str,
+        model_kwargs: Optional[Dict[str, Any]],
+        model_name: str,
+    ):
+        """Initialize ArceeWrapper.
+
+        Arguments:
+            arcee_api_key: API key for Arcee API.
+            arcee_api_url: URL for Arcee API.
+            arcee_api_version: Version of Arcee API.
+            model_kwargs: Keyword arguments for Arcee API.
+            model_name: Name of an Arcee model.
+        """
+        if isinstance(arcee_api_key, str):
+            arcee_api_key_ = SecretStr(arcee_api_key)
+        else:
+            arcee_api_key_ = arcee_api_key
+        self.arcee_api_key: SecretStr = arcee_api_key_
+        self.model_kwargs = model_kwargs
+        self.arcee_api_url = arcee_api_url
+        self.arcee_api_version = arcee_api_version
+
+        try:
+            route = ArceeRoute.model_training_status.value.format(id_or_name=model_name)
+            response = self._make_request("get", route)
+            self.model_id = response.get("model_id")
+            self.model_training_status = response.get("status")
+        except Exception as e:
+            raise ValueError(
+                f"Error while validating model training status for '{model_name}': {e}"
+            ) from e
+
+    def validate_model_training_status(self) -> None:
+        if self.model_training_status != "training_complete":
+            raise Exception(
+                f"Model {self.model_id} is not ready. "
+                "Please wait for training to complete."
+            )
+
+    def _make_request(
+        self,
+        method: Literal["post", "get"],
+        route: Union[ArceeRoute, str],
+        body: Optional[Mapping[str, Any]] = None,
+        params: Optional[dict] = None,
+        headers: Optional[dict] = None,
+    ) -> dict:
+        """Make a request to the Arcee API
+        Args:
+            method: The HTTP method to use
+            route: The route to call
+            body: The body of the request
+            params: The query params of the request
+            headers: The headers of the request
+        """
+        headers = self._make_request_headers(headers=headers)
+        url = self._make_request_url(route=route)
+
+        req_type = getattr(requests, method)
+
+        response = req_type(url, json=body, params=params, headers=headers)
+        if response.status_code not in (200, 201):
+            raise Exception(f"Failed to make request. Response: {response.text}")
+        return response.json()
+
+    def _make_request_headers(self, headers: Optional[Dict] = None) -> Dict:
+        headers = headers or {}
+        if not isinstance(self.arcee_api_key, SecretStr):
+            raise TypeError(
+                f"arcee_api_key must be a SecretStr. Got {type(self.arcee_api_key)}"
+            )
+        api_key = self.arcee_api_key.get_secret_value()
+        internal_headers = {
+            "X-Token": api_key,
+            "Content-Type": "application/json",
+        }
+        headers.update(internal_headers)
+        return headers
+
+    def _make_request_url(self, route: Union[ArceeRoute, str]) -> str:
+        return f"{self.arcee_api_url}/{self.arcee_api_version}/{route}"
+
+    def _make_request_body_for_models(
+        self, prompt: str, **kwargs: Mapping[str, Any]
+    ) -> Mapping[str, Any]:
+        """Make the request body for generate/retrieve models endpoint"""
+        _model_kwargs = self.model_kwargs or {}
+        _params = {**_model_kwargs, **kwargs}
+
+        filters = [DALMFilter(**f) for f in _params.get("filters", [])]
+        return dict(
+            model_id=self.model_id,
+            query=prompt,
+            size=_params.get("size", 3),
+            filters=filters,
+            id=self.model_id,
+        )
+
+    def generate(
+        self,
+        prompt: str,
+        **kwargs: Any,
+    ) -> str:
+        """Generate text from Arcee DALM.
+
+        Args:
+            prompt: Prompt to generate text from.
+            size: The max number of context results to retrieve. Defaults to 3.
+              (Can be less if filters are provided).
+            filters: Filters to apply to the context dataset.
+        """
+
+        response = self._make_request(
+            method="post",
+            route=ArceeRoute.generate.value,
+            body=self._make_request_body_for_models(
+                prompt=prompt,
+                **kwargs,
+            ),
+        )
+        return response["text"]
+
+    def retrieve(
+        self,
+        query: str,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Retrieve {size} contexts with your retriever for a given query
+
+        Args:
+            query: Query to submit to the model
+            size: The max number of context results to retrieve. Defaults to 3.
+              (Can be less if filters are provided).
+            filters: Filters to apply to the context dataset.
+        """
+
+        response = self._make_request(
+            method="post",
+            route=ArceeRoute.retrieve.value,
+            body=self._make_request_body_for_models(
+                prompt=query,
+                **kwargs,
+            ),
+        )
+        return [
+            ArceeDocumentAdapter.adapt(ArceeDocument(**doc))
+            for doc in response["results"]
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/utilities/arxiv.py b/llm/Lib/site-packages/langchain_community/utilities/arxiv.py
new file mode 100644
index 0000000000000000000000000000000000000000..383df6396e1b11bb4208b95fe60a3564659aea8b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/arxiv.py
@@ -0,0 +1,251 @@
+"""Util that calls Arxiv."""
+import logging
+import os
+import re
+from typing import Any, Dict, Iterator, List, Optional
+
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+logger = logging.getLogger(__name__)
+
+
+class ArxivAPIWrapper(BaseModel):
+    """Wrapper around ArxivAPI.
+
+    To use, you should have the ``arxiv`` python package installed.
+    https://lukasschwab.me/arxiv.py/index.html
+    This wrapper will use the Arxiv API to conduct searches and
+    fetch document summaries. By default, it will return the document summaries
+    of the top-k results.
+    If the query is in the form of arxiv identifier
+    (see https://info.arxiv.org/help/find/index.html), it will return the paper
+    corresponding to the arxiv identifier.
+    It limits the Document content by doc_content_chars_max.
+    Set doc_content_chars_max=None if you don't want to limit the content size.
+
+    Attributes:
+        top_k_results: number of the top-scored document used for the arxiv tool
+        ARXIV_MAX_QUERY_LENGTH: the cut limit on the query used for the arxiv tool.
+        load_max_docs: a limit to the number of loaded documents
+        load_all_available_meta:
+            if True: the `metadata` of the loaded Documents contains all available
+            meta info (see https://lukasschwab.me/arxiv.py/index.html#Result),
+            if False: the `metadata` contains only the published date, title,
+            authors and summary.
+        doc_content_chars_max: an optional cut limit for the length of a document's
+            content
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.utilities.arxiv import ArxivAPIWrapper
+            arxiv = ArxivAPIWrapper(
+                top_k_results = 3,
+                ARXIV_MAX_QUERY_LENGTH = 300,
+                load_max_docs = 3,
+                load_all_available_meta = False,
+                doc_content_chars_max = 40000
+            )
+            arxiv.run("tree of thought llm)
+    """
+
+    arxiv_search: Any  #: :meta private:
+    arxiv_exceptions: Any  # :meta private:
+    top_k_results: int = 3
+    ARXIV_MAX_QUERY_LENGTH: int = 300
+    load_max_docs: int = 100
+    load_all_available_meta: bool = False
+    doc_content_chars_max: Optional[int] = 4000
+
+    def is_arxiv_identifier(self, query: str) -> bool:
+        """Check if a query is an arxiv identifier."""
+        arxiv_identifier_pattern = r"\d{2}(0[1-9]|1[0-2])\.\d{4,5}(v\d+|)|\d{7}.*"
+        for query_item in query[: self.ARXIV_MAX_QUERY_LENGTH].split():
+            match_result = re.match(arxiv_identifier_pattern, query_item)
+            if not match_result:
+                return False
+            assert match_result is not None
+            if not match_result.group(0) == query_item:
+                return False
+        return True
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in environment."""
+        try:
+            import arxiv
+
+            values["arxiv_search"] = arxiv.Search
+            values["arxiv_exceptions"] = (
+                arxiv.ArxivError,
+                arxiv.UnexpectedEmptyPageError,
+                arxiv.HTTPError,
+            )
+            values["arxiv_result"] = arxiv.Result
+        except ImportError:
+            raise ImportError(
+                "Could not import arxiv python package. "
+                "Please install it with `pip install arxiv`."
+            )
+        return values
+
+    def get_summaries_as_docs(self, query: str) -> List[Document]:
+        """
+        Performs an arxiv search and returns list of
+        documents, with summaries as the content.
+
+        If an error occurs or no documents found, error text
+        is returned instead. Wrapper for
+        https://lukasschwab.me/arxiv.py/index.html#Search
+
+        Args:
+            query: a plaintext search query
+        """  # noqa: E501
+        try:
+            if self.is_arxiv_identifier(query):
+                results = self.arxiv_search(
+                    id_list=query.split(),
+                    max_results=self.top_k_results,
+                ).results()
+            else:
+                results = self.arxiv_search(  # type: ignore
+                    query[: self.ARXIV_MAX_QUERY_LENGTH], max_results=self.top_k_results
+                ).results()
+        except self.arxiv_exceptions as ex:
+            return [Document(page_content=f"Arxiv exception: {ex}")]
+        docs = [
+            Document(
+                page_content=result.summary,
+                metadata={
+                    "Entry ID": result.entry_id,
+                    "Published": result.updated.date(),
+                    "Title": result.title,
+                    "Authors": ", ".join(a.name for a in result.authors),
+                },
+            )
+            for result in results
+        ]
+        return docs
+
+    def run(self, query: str) -> str:
+        """
+        Performs an arxiv search and A single string
+        with the publish date, title, authors, and summary
+        for each article separated by two newlines.
+
+        If an error occurs or no documents found, error text
+        is returned instead. Wrapper for
+        https://lukasschwab.me/arxiv.py/index.html#Search
+
+        Args:
+            query: a plaintext search query
+        """  # noqa: E501
+        try:
+            if self.is_arxiv_identifier(query):
+                results = self.arxiv_search(
+                    id_list=query.split(),
+                    max_results=self.top_k_results,
+                ).results()
+            else:
+                results = self.arxiv_search(  # type: ignore
+                    query[: self.ARXIV_MAX_QUERY_LENGTH], max_results=self.top_k_results
+                ).results()
+        except self.arxiv_exceptions as ex:
+            return f"Arxiv exception: {ex}"
+        docs = [
+            f"Published: {result.updated.date()}\n"
+            f"Title: {result.title}\n"
+            f"Authors: {', '.join(a.name for a in result.authors)}\n"
+            f"Summary: {result.summary}"
+            for result in results
+        ]
+        if docs:
+            return "\n\n".join(docs)[: self.doc_content_chars_max]
+        else:
+            return "No good Arxiv Result was found"
+
+    def load(self, query: str) -> List[Document]:
+        """
+        Run Arxiv search and get the article texts plus the article meta information.
+        See https://lukasschwab.me/arxiv.py/index.html#Search
+
+        Returns: a list of documents with the document.page_content in text format
+
+        Performs an arxiv search, downloads the top k results as PDFs, loads
+        them as Documents, and returns them in a List.
+
+        Args:
+            query: a plaintext search query
+        """
+        return list(self.lazy_load(query))
+
+    def lazy_load(self, query: str) -> Iterator[Document]:
+        """
+        Run Arxiv search and get the article texts plus the article meta information.
+        See https://lukasschwab.me/arxiv.py/index.html#Search
+
+        Returns: documents with the document.page_content in text format
+
+        Performs an arxiv search, downloads the top k results as PDFs, loads
+        them as Documents, and returns them.
+
+        Args:
+            query: a plaintext search query
+        """
+        try:
+            import fitz
+        except ImportError:
+            raise ImportError(
+                "PyMuPDF package not found, please install it with "
+                "`pip install pymupdf`"
+            )
+
+        try:
+            # Remove the ":" and "-" from the query, as they can cause search problems
+            query = query.replace(":", "").replace("-", "")
+            if self.is_arxiv_identifier(query):
+                results = self.arxiv_search(
+                    id_list=query[: self.ARXIV_MAX_QUERY_LENGTH].split(),
+                    max_results=self.load_max_docs,
+                ).results()
+            else:
+                results = self.arxiv_search(  # type: ignore
+                    query[: self.ARXIV_MAX_QUERY_LENGTH], max_results=self.load_max_docs
+                ).results()
+        except self.arxiv_exceptions as ex:
+            logger.debug("Error on arxiv: %s", ex)
+            return
+
+        for result in results:
+            try:
+                doc_file_name: str = result.download_pdf()
+                with fitz.open(doc_file_name) as doc_file:
+                    text: str = "".join(page.get_text() for page in doc_file)
+            except (FileNotFoundError, fitz.fitz.FileDataError) as f_ex:
+                logger.debug(f_ex)
+                continue
+            if self.load_all_available_meta:
+                extra_metadata = {
+                    "entry_id": result.entry_id,
+                    "published_first_time": str(result.published.date()),
+                    "comment": result.comment,
+                    "journal_ref": result.journal_ref,
+                    "doi": result.doi,
+                    "primary_category": result.primary_category,
+                    "categories": result.categories,
+                    "links": [link.href for link in result.links],
+                }
+            else:
+                extra_metadata = {}
+            metadata = {
+                "Published": str(result.updated.date()),
+                "Title": result.title,
+                "Authors": ", ".join(a.name for a in result.authors),
+                "Summary": result.summary,
+                **extra_metadata,
+            }
+            yield Document(
+                page_content=text[: self.doc_content_chars_max], metadata=metadata
+            )
+            os.remove(doc_file_name)
diff --git a/llm/Lib/site-packages/langchain_community/utilities/astradb.py b/llm/Lib/site-packages/langchain_community/utilities/astradb.py
new file mode 100644
index 0000000000000000000000000000000000000000..1df76730498b3d444851cb5270167b1a6690e346
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/astradb.py
@@ -0,0 +1,171 @@
+from __future__ import annotations
+
+import asyncio
+import inspect
+from asyncio import InvalidStateError, Task
+from enum import Enum
+from typing import TYPE_CHECKING, Awaitable, Optional, Union
+
+if TYPE_CHECKING:
+    from astrapy.db import (
+        AstraDB,
+        AsyncAstraDB,
+    )
+
+
+class SetupMode(Enum):
+    """Setup mode for AstraDBEnvironment as enumerator."""
+
+    SYNC = 1
+    ASYNC = 2
+    OFF = 3
+
+
+class _AstraDBEnvironment:
+    def __init__(
+        self,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        astra_db_client: Optional[AstraDB] = None,
+        async_astra_db_client: Optional[AsyncAstraDB] = None,
+        namespace: Optional[str] = None,
+    ) -> None:
+        self.token = token
+        self.api_endpoint = api_endpoint
+        astra_db = astra_db_client
+        async_astra_db = async_astra_db_client
+        self.namespace = namespace
+
+        try:
+            from astrapy.db import (
+                AstraDB,
+                AsyncAstraDB,
+            )
+        except (ImportError, ModuleNotFoundError):
+            raise ImportError(
+                "Could not import a recent astrapy python package. "
+                "Please install it with `pip install --upgrade astrapy`."
+            )
+
+        # Conflicting-arg checks:
+        if astra_db_client is not None or async_astra_db_client is not None:
+            if token is not None or api_endpoint is not None:
+                raise ValueError(
+                    "You cannot pass 'astra_db_client' or 'async_astra_db_client' to "
+                    "AstraDBEnvironment if passing 'token' and 'api_endpoint'."
+                )
+
+        if token and api_endpoint:
+            astra_db = AstraDB(
+                token=token,
+                api_endpoint=api_endpoint,
+                namespace=self.namespace,
+            )
+            async_astra_db = AsyncAstraDB(
+                token=token,
+                api_endpoint=api_endpoint,
+                namespace=self.namespace,
+            )
+
+        if astra_db:
+            self.astra_db = astra_db
+            if async_astra_db:
+                self.async_astra_db = async_astra_db
+            else:
+                self.async_astra_db = AsyncAstraDB(
+                    token=self.astra_db.token,
+                    api_endpoint=self.astra_db.base_url,
+                    api_path=self.astra_db.api_path,
+                    api_version=self.astra_db.api_version,
+                    namespace=self.astra_db.namespace,
+                )
+        elif async_astra_db:
+            self.async_astra_db = async_astra_db
+            self.astra_db = AstraDB(
+                token=self.async_astra_db.token,
+                api_endpoint=self.async_astra_db.base_url,
+                api_path=self.async_astra_db.api_path,
+                api_version=self.async_astra_db.api_version,
+                namespace=self.async_astra_db.namespace,
+            )
+        else:
+            raise ValueError(
+                "Must provide 'astra_db_client' or 'async_astra_db_client' or "
+                "'token' and 'api_endpoint'"
+            )
+
+
+class _AstraDBCollectionEnvironment(_AstraDBEnvironment):
+    def __init__(
+        self,
+        collection_name: str,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        astra_db_client: Optional[AstraDB] = None,
+        async_astra_db_client: Optional[AsyncAstraDB] = None,
+        namespace: Optional[str] = None,
+        setup_mode: SetupMode = SetupMode.SYNC,
+        pre_delete_collection: bool = False,
+        embedding_dimension: Union[int, Awaitable[int], None] = None,
+        metric: Optional[str] = None,
+    ) -> None:
+        from astrapy.db import AstraDBCollection, AsyncAstraDBCollection
+
+        super().__init__(
+            token, api_endpoint, astra_db_client, async_astra_db_client, namespace
+        )
+        self.collection_name = collection_name
+        self.collection = AstraDBCollection(
+            collection_name=collection_name,
+            astra_db=self.astra_db,
+        )
+
+        self.async_collection = AsyncAstraDBCollection(
+            collection_name=collection_name,
+            astra_db=self.async_astra_db,
+        )
+
+        self.async_setup_db_task: Optional[Task] = None
+        if setup_mode == SetupMode.ASYNC:
+            async_astra_db = self.async_astra_db
+
+            async def _setup_db() -> None:
+                if pre_delete_collection:
+                    await async_astra_db.delete_collection(collection_name)
+                if inspect.isawaitable(embedding_dimension):
+                    dimension = await embedding_dimension
+                else:
+                    dimension = embedding_dimension
+                await async_astra_db.create_collection(
+                    collection_name, dimension=dimension, metric=metric
+                )
+
+            self.async_setup_db_task = asyncio.create_task(_setup_db())
+        elif setup_mode == SetupMode.SYNC:
+            if pre_delete_collection:
+                self.astra_db.delete_collection(collection_name)
+            if inspect.isawaitable(embedding_dimension):
+                raise ValueError(
+                    "Cannot use an awaitable embedding_dimension with async_setup "
+                    "set to False"
+                )
+            self.astra_db.create_collection(
+                collection_name,
+                dimension=embedding_dimension,  # type: ignore[arg-type]
+                metric=metric,
+            )
+
+    def ensure_db_setup(self) -> None:
+        if self.async_setup_db_task:
+            try:
+                self.async_setup_db_task.result()
+            except InvalidStateError:
+                raise ValueError(
+                    "Asynchronous setup of the DB not finished. "
+                    "NB: AstraDB components sync methods shouldn't be called from the "
+                    "event loop. Consider using their async equivalents."
+                )
+
+    async def aensure_db_setup(self) -> None:
+        if self.async_setup_db_task:
+            await self.async_setup_db_task
diff --git a/llm/Lib/site-packages/langchain_community/utilities/awslambda.py b/llm/Lib/site-packages/langchain_community/utilities/awslambda.py
new file mode 100644
index 0000000000000000000000000000000000000000..1b497dd5dd2973f9d847d7f052aa7fd3c9198df1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/awslambda.py
@@ -0,0 +1,82 @@
+"""Util that calls Lambda."""
+import json
+from typing import Any, Dict, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+
+class LambdaWrapper(BaseModel):
+    """Wrapper for AWS Lambda SDK.
+    To use, you should have the ``boto3`` package installed
+    and a lambda functions built from the AWS Console or
+    CLI. Set up your AWS credentials with ``aws configure``
+
+    Example:
+        .. code-block:: bash
+
+            pip install boto3
+
+            aws configure
+
+    """
+
+    lambda_client: Any  #: :meta private:
+    """The configured boto3 client"""
+    function_name: Optional[str] = None
+    """The name of your lambda function"""
+    awslambda_tool_name: Optional[str] = None
+    """If passing to an agent as a tool, the tool name"""
+    awslambda_tool_description: Optional[str] = None
+    """If passing to an agent as a tool, the description"""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that python package exists in environment."""
+
+        try:
+            import boto3
+
+        except ImportError:
+            raise ImportError(
+                "boto3 is not installed. Please install it with `pip install boto3`"
+            )
+
+        values["lambda_client"] = boto3.client("lambda")
+        values["function_name"] = values["function_name"]
+
+        return values
+
+    def run(self, query: str) -> str:
+        """
+        Invokes the lambda function and returns the
+        result.
+
+        Args:
+            query: an input to passed to the lambda
+                function as the ``body`` of a JSON
+                object.
+        """  # noqa: E501
+        res = self.lambda_client.invoke(
+            FunctionName=self.function_name,
+            InvocationType="RequestResponse",
+            Payload=json.dumps({"body": query}),
+        )
+
+        try:
+            payload_stream = res["Payload"]
+            payload_string = payload_stream.read().decode("utf-8")
+            answer = json.loads(payload_string)["body"]
+
+        except StopIteration:
+            return "Failed to parse response from Lambda"
+
+        if answer is None or answer == "":
+            # We don't want to return the assumption alone if answer is empty
+            return "Request failed."
+        else:
+            return f"Result: {answer}"
diff --git a/llm/Lib/site-packages/langchain_community/utilities/bibtex.py b/llm/Lib/site-packages/langchain_community/utilities/bibtex.py
new file mode 100644
index 0000000000000000000000000000000000000000..45d83aefea3cf0d0712726ac586060cfa53e4314
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/bibtex.py
@@ -0,0 +1,87 @@
+"""Util that calls bibtexparser."""
+import logging
+from typing import Any, Dict, List, Mapping
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+logger = logging.getLogger(__name__)
+
+OPTIONAL_FIELDS = [
+    "annotate",
+    "booktitle",
+    "editor",
+    "howpublished",
+    "journal",
+    "keywords",
+    "note",
+    "organization",
+    "publisher",
+    "school",
+    "series",
+    "type",
+    "doi",
+    "issn",
+    "isbn",
+]
+
+
+class BibtexparserWrapper(BaseModel):
+    """Wrapper around bibtexparser.
+
+    To use, you should have the ``bibtexparser`` python package installed.
+    https://bibtexparser.readthedocs.io/en/master/
+
+    This wrapper will use bibtexparser to load a collection of references from
+    a bibtex file and fetch document summaries.
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in environment."""
+        try:
+            import bibtexparser  # noqa
+        except ImportError:
+            raise ImportError(
+                "Could not import bibtexparser python package. "
+                "Please install it with `pip install bibtexparser`."
+            )
+
+        return values
+
+    def load_bibtex_entries(self, path: str) -> List[Dict[str, Any]]:
+        """Load bibtex entries from the bibtex file at the given path."""
+        import bibtexparser
+
+        with open(path) as file:
+            entries = bibtexparser.load(file).entries
+        return entries
+
+    def get_metadata(
+        self, entry: Mapping[str, Any], load_extra: bool = False
+    ) -> Dict[str, Any]:
+        """Get metadata for the given entry."""
+        publication = entry.get("journal") or entry.get("booktitle")
+        if "url" in entry:
+            url = entry["url"]
+        elif "doi" in entry:
+            url = f'https://doi.org/{entry["doi"]}'
+        else:
+            url = None
+        meta = {
+            "id": entry.get("ID"),
+            "published_year": entry.get("year"),
+            "title": entry.get("title"),
+            "publication": publication,
+            "authors": entry.get("author"),
+            "abstract": entry.get("abstract"),
+            "url": url,
+        }
+        if load_extra:
+            for field in OPTIONAL_FIELDS:
+                meta[field] = entry.get(field)
+        return {k: v for k, v in meta.items() if v is not None}
diff --git a/llm/Lib/site-packages/langchain_community/utilities/bing_search.py b/llm/Lib/site-packages/langchain_community/utilities/bing_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c55a6b56e2354e29ce643172880f9ee4c825666
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/bing_search.py
@@ -0,0 +1,106 @@
+"""Util that calls Bing Search.
+
+In order to set this up, follow instructions at:
+https://levelup.gitconnected.com/api-tutorial-how-to-use-bing-web-search-api-in-python-4165d5592a7e
+"""
+from typing import Dict, List
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class BingSearchAPIWrapper(BaseModel):
+    """Wrapper for Bing Search API.
+
+    In order to set this up, follow instructions at:
+    https://levelup.gitconnected.com/api-tutorial-how-to-use-bing-web-search-api-in-python-4165d5592a7e
+    """
+
+    bing_subscription_key: str
+    bing_search_url: str
+    k: int = 10
+    search_kwargs: dict = Field(default_factory=dict)
+    """Additional keyword arguments to pass to the search request."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def _bing_search_results(self, search_term: str, count: int) -> List[dict]:
+        headers = {"Ocp-Apim-Subscription-Key": self.bing_subscription_key}
+        params = {
+            "q": search_term,
+            "count": count,
+            "textDecorations": True,
+            "textFormat": "HTML",
+            **self.search_kwargs,
+        }
+        response = requests.get(
+            self.bing_search_url,
+            headers=headers,
+            params=params,  # type: ignore
+        )
+        response.raise_for_status()
+        search_results = response.json()
+        if "webPages" in search_results:
+            return search_results["webPages"]["value"]
+        return []
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        bing_subscription_key = get_from_dict_or_env(
+            values, "bing_subscription_key", "BING_SUBSCRIPTION_KEY"
+        )
+        values["bing_subscription_key"] = bing_subscription_key
+
+        bing_search_url = get_from_dict_or_env(
+            values,
+            "bing_search_url",
+            "BING_SEARCH_URL",
+            # default="https://api.bing.microsoft.com/v7.0/search",
+        )
+
+        values["bing_search_url"] = bing_search_url
+
+        return values
+
+    def run(self, query: str) -> str:
+        """Run query through BingSearch and parse result."""
+        snippets = []
+        results = self._bing_search_results(query, count=self.k)
+        if len(results) == 0:
+            return "No good Bing Search Result was found"
+        for result in results:
+            snippets.append(result["snippet"])
+
+        return " ".join(snippets)
+
+    def results(self, query: str, num_results: int) -> List[Dict]:
+        """Run query through BingSearch and return metadata.
+
+        Args:
+            query: The query to search for.
+            num_results: The number of results to return.
+
+        Returns:
+            A list of dictionaries with the following keys:
+                snippet - The description of the result.
+                title - The title of the result.
+                link - The link to the result.
+        """
+        metadata_results = []
+        results = self._bing_search_results(query, count=num_results)
+        if len(results) == 0:
+            return [{"Result": "No good Bing Search Result was found"}]
+        for result in results:
+            metadata_result = {
+                "snippet": result["snippet"],
+                "title": result["name"],
+                "link": result["url"],
+            }
+            metadata_results.append(metadata_result)
+
+        return metadata_results
diff --git a/llm/Lib/site-packages/langchain_community/utilities/brave_search.py b/llm/Lib/site-packages/langchain_community/utilities/brave_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd282fc3465a52a15a0822aebdc46036678c9063
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/brave_search.py
@@ -0,0 +1,72 @@
+import json
+from typing import List
+
+import requests
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+
+class BraveSearchWrapper(BaseModel):
+    """Wrapper around the Brave search engine."""
+
+    api_key: str
+    """The API key to use for the Brave search engine."""
+    search_kwargs: dict = Field(default_factory=dict)
+    """Additional keyword arguments to pass to the search request."""
+    base_url: str = "https://api.search.brave.com/res/v1/web/search"
+    """The base URL for the Brave search engine."""
+
+    def run(self, query: str) -> str:
+        """Query the Brave search engine and return the results as a JSON string.
+
+        Args:
+            query: The query to search for.
+
+        Returns: The results as a JSON string.
+
+        """
+        web_search_results = self._search_request(query=query)
+        final_results = [
+            {
+                "title": item.get("title"),
+                "link": item.get("url"),
+                "snippet": item.get("description"),
+            }
+            for item in web_search_results
+        ]
+        return json.dumps(final_results)
+
+    def download_documents(self, query: str) -> List[Document]:
+        """Query the Brave search engine and return the results as a list of Documents.
+
+        Args:
+            query: The query to search for.
+
+        Returns: The results as a list of Documents.
+
+        """
+        results = self._search_request(query)
+        return [
+            Document(
+                page_content=item.get("description"),  # type: ignore[arg-type]
+                metadata={"title": item.get("title"), "link": item.get("url")},
+            )
+            for item in results
+        ]
+
+    def _search_request(self, query: str) -> List[dict]:
+        headers = {
+            "X-Subscription-Token": self.api_key,
+            "Accept": "application/json",
+        }
+        req = requests.PreparedRequest()
+        params = {**self.search_kwargs, **{"q": query}}
+        req.prepare_url(self.base_url, params)
+        if req.url is None:
+            raise ValueError("prepared url is None, this should not happen")
+
+        response = requests.get(req.url, headers=headers)
+        if not response.ok:
+            raise Exception(f"HTTP error {response.status_code}")
+
+        return response.json().get("web", {}).get("results", [])
diff --git a/llm/Lib/site-packages/langchain_community/utilities/cassandra.py b/llm/Lib/site-packages/langchain_community/utilities/cassandra.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ef65b71f491280dc9d2e5809ad81ade4a6d45e6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/cassandra.py
@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+import asyncio
+from typing import TYPE_CHECKING, Any, Callable
+
+if TYPE_CHECKING:
+    from cassandra.cluster import ResponseFuture
+
+
+async def wrapped_response_future(
+    func: Callable[..., ResponseFuture], *args: Any, **kwargs: Any
+) -> Any:
+    loop = asyncio.get_event_loop()
+    asyncio_future = loop.create_future()
+    response_future = func(*args, **kwargs)
+
+    def success_handler(_: Any) -> None:
+        loop.call_soon_threadsafe(asyncio_future.set_result, response_future.result())
+
+    def error_handler(exc: BaseException) -> None:
+        loop.call_soon_threadsafe(asyncio_future.set_exception, exc)
+
+    response_future.add_callbacks(success_handler, error_handler)
+    return await asyncio_future
diff --git a/llm/Lib/site-packages/langchain_community/utilities/clickup.py b/llm/Lib/site-packages/langchain_community/utilities/clickup.py
new file mode 100644
index 0000000000000000000000000000000000000000..e13deef894aa35e8f827502e273e593c5d7986f7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/clickup.py
@@ -0,0 +1,623 @@
+"""Util that calls clickup."""
+
+import json
+import warnings
+from dataclasses import asdict, dataclass, fields
+from typing import Any, Dict, List, Mapping, Optional, Tuple, Type, Union
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+DEFAULT_URL = "https://api.clickup.com/api/v2"
+
+
+@dataclass
+class Component:
+    """Base class for all components."""
+
+    @classmethod
+    def from_data(cls, data: Dict[str, Any]) -> "Component":
+        raise NotImplementedError()
+
+
+@dataclass
+class Task(Component):
+    """Class for a task."""
+
+    id: int
+    name: str
+    text_content: str
+    description: str
+    status: str
+    creator_id: int
+    creator_username: str
+    creator_email: str
+    assignees: List[Dict[str, Any]]
+    watchers: List[Dict[str, Any]]
+    priority: Optional[str]
+    due_date: Optional[str]
+    start_date: Optional[str]
+    points: int
+    team_id: int
+    project_id: int
+
+    @classmethod
+    def from_data(cls, data: Dict[str, Any]) -> "Task":
+        priority = None if data["priority"] is None else data["priority"]["priority"]
+        return cls(
+            id=data["id"],
+            name=data["name"],
+            text_content=data["text_content"],
+            description=data["description"],
+            status=data["status"]["status"],
+            creator_id=data["creator"]["id"],
+            creator_username=data["creator"]["username"],
+            creator_email=data["creator"]["email"],
+            assignees=data["assignees"],
+            watchers=data["watchers"],
+            priority=priority,
+            due_date=data["due_date"],
+            start_date=data["start_date"],
+            points=data["points"],
+            team_id=data["team_id"],
+            project_id=data["project"]["id"],
+        )
+
+
+@dataclass
+class CUList(Component):
+    """Component class for a list."""
+
+    folder_id: float
+    name: str
+    content: Optional[str] = None
+    due_date: Optional[int] = None
+    due_date_time: Optional[bool] = None
+    priority: Optional[int] = None
+    assignee: Optional[int] = None
+    status: Optional[str] = None
+
+    @classmethod
+    def from_data(cls, data: dict) -> "CUList":
+        return cls(
+            folder_id=data["folder_id"],
+            name=data["name"],
+            content=data.get("content"),
+            due_date=data.get("due_date"),
+            due_date_time=data.get("due_date_time"),
+            priority=data.get("priority"),
+            assignee=data.get("assignee"),
+            status=data.get("status"),
+        )
+
+
+@dataclass
+class Member(Component):
+    """Component class for a member."""
+
+    id: int
+    username: str
+    email: str
+    initials: str
+
+    @classmethod
+    def from_data(cls, data: Dict) -> "Member":
+        return cls(
+            id=data["user"]["id"],
+            username=data["user"]["username"],
+            email=data["user"]["email"],
+            initials=data["user"]["initials"],
+        )
+
+
+@dataclass
+class Team(Component):
+    """Component class for a team."""
+
+    id: int
+    name: str
+    members: List[Member]
+
+    @classmethod
+    def from_data(cls, data: Dict) -> "Team":
+        members = [Member.from_data(member_data) for member_data in data["members"]]
+        return cls(id=data["id"], name=data["name"], members=members)
+
+
+@dataclass
+class Space(Component):
+    """Component class for a space."""
+
+    id: int
+    name: str
+    private: bool
+    enabled_features: Dict[str, Any]
+
+    @classmethod
+    def from_data(cls, data: Dict[str, Any]) -> "Space":
+        space_data = data["spaces"][0]
+        enabled_features = {
+            feature: value
+            for feature, value in space_data["features"].items()
+            if value["enabled"]
+        }
+        return cls(
+            id=space_data["id"],
+            name=space_data["name"],
+            private=space_data["private"],
+            enabled_features=enabled_features,
+        )
+
+
+def parse_dict_through_component(
+    data: dict, component: Type[Component], fault_tolerant: bool = False
+) -> Dict:
+    """Parse a dictionary by creating
+    a component and then turning it back into a dictionary.
+
+    This helps with two things
+    1. Extract and format data from a dictionary according to schema
+    2. Provide a central place to do this in a fault-tolerant way
+
+    """
+    try:
+        return asdict(component.from_data(data))
+    except Exception as e:
+        if fault_tolerant:
+            warning_str = f"""Error encountered while trying to parse
+{str(data)}: {str(e)}\n Falling back to returning input data."""
+            warnings.warn(warning_str)
+            return data
+        else:
+            raise e
+
+
+def extract_dict_elements_from_component_fields(
+    data: dict, component: Type[Component]
+) -> dict:
+    """Extract elements from a dictionary.
+
+    Args:
+        data: The dictionary to extract elements from.
+        component: The component to extract elements from.
+
+    Returns:
+        A dictionary containing the elements from the input dictionary that are also
+        in the component.
+    """
+    output = {}
+    for attribute in fields(component):
+        if attribute.name in data:
+            output[attribute.name] = data[attribute.name]
+    return output
+
+
+def load_query(
+    query: str, fault_tolerant: bool = False
+) -> Tuple[Optional[Dict], Optional[str]]:
+    """Attempts to parse a JSON string and return the parsed object.
+
+    If parsing fails, returns an error message.
+
+    :param query: The JSON string to parse.
+    :return: A tuple containing the parsed object or None and an error message or None.
+    """
+    try:
+        return json.loads(query), None
+    except json.JSONDecodeError as e:
+        if fault_tolerant:
+            return (
+                None,
+                f"""Input must be a valid JSON. Got the following error: {str(e)}. 
+"Please reformat and try again.""",
+            )
+        else:
+            raise e
+
+
+def fetch_first_id(data: dict, key: str) -> Optional[int]:
+    """Fetch the first id from a dictionary."""
+    if key in data and len(data[key]) > 0:
+        if len(data[key]) > 1:
+            warnings.warn(f"Found multiple {key}: {data[key]}. Defaulting to first.")
+        return data[key][0]["id"]
+    return None
+
+
+def fetch_data(url: str, access_token: str, query: Optional[dict] = None) -> dict:
+    """Fetch data from a URL."""
+    headers = {"Authorization": access_token}
+    response = requests.get(url, headers=headers, params=query)
+    response.raise_for_status()
+    return response.json()
+
+
+def fetch_team_id(access_token: str) -> Optional[int]:
+    """Fetch the team id."""
+    url = f"{DEFAULT_URL}/team"
+    data = fetch_data(url, access_token)
+    return fetch_first_id(data, "teams")
+
+
+def fetch_space_id(team_id: int, access_token: str) -> Optional[int]:
+    """Fetch the space id."""
+    url = f"{DEFAULT_URL}/team/{team_id}/space"
+    data = fetch_data(url, access_token, query={"archived": "false"})
+    return fetch_first_id(data, "spaces")
+
+
+def fetch_folder_id(space_id: int, access_token: str) -> Optional[int]:
+    """Fetch the folder id."""
+    url = f"{DEFAULT_URL}/space/{space_id}/folder"
+    data = fetch_data(url, access_token, query={"archived": "false"})
+    return fetch_first_id(data, "folders")
+
+
+def fetch_list_id(space_id: int, folder_id: int, access_token: str) -> Optional[int]:
+    """Fetch the list id."""
+    if folder_id:
+        url = f"{DEFAULT_URL}/folder/{folder_id}/list"
+    else:
+        url = f"{DEFAULT_URL}/space/{space_id}/list"
+
+    data = fetch_data(url, access_token, query={"archived": "false"})
+
+    # The structure to fetch list id differs based if its folderless
+    if folder_id and "id" in data:
+        return data["id"]
+    else:
+        return fetch_first_id(data, "lists")
+
+
+class ClickupAPIWrapper(BaseModel):
+    """Wrapper for Clickup API."""
+
+    access_token: Optional[str] = None
+    team_id: Optional[str] = None
+    space_id: Optional[str] = None
+    folder_id: Optional[str] = None
+    list_id: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @classmethod
+    def get_access_code_url(
+        cls, oauth_client_id: str, redirect_uri: str = "https://google.com"
+    ) -> str:
+        """Get the URL to get an access code."""
+        url = f"https://app.clickup.com/api?client_id={oauth_client_id}"
+        return f"{url}&redirect_uri={redirect_uri}"
+
+    @classmethod
+    def get_access_token(
+        cls, oauth_client_id: str, oauth_client_secret: str, code: str
+    ) -> Optional[str]:
+        """Get the access token."""
+        url = f"{DEFAULT_URL}/oauth/token"
+
+        params = {
+            "client_id": oauth_client_id,
+            "client_secret": oauth_client_secret,
+            "code": code,
+        }
+
+        response = requests.post(url, params=params)
+        data = response.json()
+
+        if "access_token" not in data:
+            print(f"Error: {data}")  # noqa: T201
+            if "ECODE" in data and data["ECODE"] == "OAUTH_014":
+                url = ClickupAPIWrapper.get_access_code_url(oauth_client_id)
+                print(  # noqa: T201
+                    "You already used this code once. Generate a new one.",
+                    f"Our best guess for the url to get a new code is:\n{url}",
+                )
+            return None
+
+        return data["access_token"]
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["access_token"] = get_from_dict_or_env(
+            values, "access_token", "CLICKUP_ACCESS_TOKEN"
+        )
+        values["team_id"] = fetch_team_id(values["access_token"])
+        values["space_id"] = fetch_space_id(values["team_id"], values["access_token"])
+        values["folder_id"] = fetch_folder_id(
+            values["space_id"], values["access_token"]
+        )
+        values["list_id"] = fetch_list_id(
+            values["space_id"], values["folder_id"], values["access_token"]
+        )
+
+        return values
+
+    def attempt_parse_teams(self, input_dict: dict) -> Dict[str, List[dict]]:
+        """Parse appropriate content from the list of teams."""
+        parsed_teams: Dict[str, List[dict]] = {"teams": []}
+        for team in input_dict["teams"]:
+            try:
+                team = parse_dict_through_component(team, Team, fault_tolerant=False)
+                parsed_teams["teams"].append(team)
+            except Exception as e:
+                warnings.warn(f"Error parsing a team {e}")
+
+        return parsed_teams
+
+    def get_headers(
+        self,
+    ) -> Mapping[str, Union[str, bytes]]:
+        """Get the headers for the request."""
+        if not isinstance(self.access_token, str):
+            raise TypeError(f"Access Token: {self.access_token}, must be str.")
+
+        headers = {
+            "Authorization": str(self.access_token),
+            "Content-Type": "application/json",
+        }
+        return headers
+
+    def get_default_params(self) -> Dict:
+        return {"archived": "false"}
+
+    def get_authorized_teams(self) -> Dict[Any, Any]:
+        """Get all teams for the user."""
+        url = f"{DEFAULT_URL}/team"
+
+        response = requests.get(url, headers=self.get_headers())
+
+        data = response.json()
+        parsed_teams = self.attempt_parse_teams(data)
+
+        return parsed_teams
+
+    def get_folders(self) -> Dict:
+        """
+        Get all the folders for the team.
+        """
+        url = f"{DEFAULT_URL}/team/" + str(self.team_id) + "/space"
+        params = self.get_default_params()
+        response = requests.get(url, headers=self.get_headers(), params=params)
+        return {"response": response}
+
+    def get_task(self, query: str, fault_tolerant: bool = True) -> Dict:
+        """
+        Retrieve a specific task.
+        """
+
+        params, error = load_query(query, fault_tolerant=True)
+        if params is None:
+            return {"Error": error}
+
+        url = f"{DEFAULT_URL}/task/{params['task_id']}"
+        params = {
+            "custom_task_ids": "true",
+            "team_id": self.team_id,
+            "include_subtasks": "true",
+        }
+        response = requests.get(url, headers=self.get_headers(), params=params)
+        data = response.json()
+        parsed_task = parse_dict_through_component(
+            data, Task, fault_tolerant=fault_tolerant
+        )
+
+        return parsed_task
+
+    def get_lists(self) -> Dict:
+        """
+        Get all available lists.
+        """
+
+        url = f"{DEFAULT_URL}/folder/{self.folder_id}/list"
+        params = self.get_default_params()
+        response = requests.get(url, headers=self.get_headers(), params=params)
+        return {"response": response}
+
+    def query_tasks(self, query: str) -> Dict:
+        """
+        Query tasks that match certain fields
+        """
+        params, error = load_query(query, fault_tolerant=True)
+        if params is None:
+            return {"Error": error}
+
+        url = f"{DEFAULT_URL}/list/{params['list_id']}/task"
+
+        params = self.get_default_params()
+        response = requests.get(url, headers=self.get_headers(), params=params)
+
+        return {"response": response}
+
+    def get_spaces(self) -> Dict:
+        """
+        Get all spaces for the team.
+        """
+        url = f"{DEFAULT_URL}/team/{self.team_id}/space"
+        response = requests.get(
+            url, headers=self.get_headers(), params=self.get_default_params()
+        )
+        data = response.json()
+        parsed_spaces = parse_dict_through_component(data, Space, fault_tolerant=True)
+        return parsed_spaces
+
+    def get_task_attribute(self, query: str) -> Dict:
+        """
+        Update an attribute of a specified task.
+        """
+
+        task = self.get_task(query, fault_tolerant=True)
+        params, error = load_query(query, fault_tolerant=True)
+        if not isinstance(params, dict):
+            return {"Error": error}
+
+        if params["attribute_name"] not in task:
+            return {
+                "Error": f"""attribute_name = {params['attribute_name']} was not 
+found in task keys {task.keys()}. Please call again with one of the key names."""
+            }
+
+        return {params["attribute_name"]: task[params["attribute_name"]]}
+
+    def update_task(self, query: str) -> Dict:
+        """
+        Update an attribute of a specified task.
+        """
+        query_dict, error = load_query(query, fault_tolerant=True)
+        if query_dict is None:
+            return {"Error": error}
+
+        url = f"{DEFAULT_URL}/task/{query_dict['task_id']}"
+        params = {
+            "custom_task_ids": "true",
+            "team_id": self.team_id,
+            "include_subtasks": "true",
+        }
+        headers = self.get_headers()
+        payload = {query_dict["attribute_name"]: query_dict["value"]}
+
+        response = requests.put(url, headers=headers, params=params, json=payload)
+
+        return {"response": response}
+
+    def update_task_assignees(self, query: str) -> Dict:
+        """
+        Add or remove assignees of a specified task.
+        """
+        query_dict, error = load_query(query, fault_tolerant=True)
+        if query_dict is None:
+            return {"Error": error}
+
+        for user in query_dict["users"]:
+            if not isinstance(user, int):
+                return {
+                    "Error": f"""All users must be integers, not strings!
+"Got user {user} if type {type(user)}"""
+                }
+
+        url = f"{DEFAULT_URL}/task/{query_dict['task_id']}"
+
+        headers = self.get_headers()
+
+        if query_dict["operation"] == "add":
+            assigne_payload = {"add": query_dict["users"], "rem": []}
+        elif query_dict["operation"] == "rem":
+            assigne_payload = {"add": [], "rem": query_dict["users"]}
+        else:
+            raise ValueError(
+                f"Invalid operation ({query_dict['operation']}). ",
+                "Valid options ['add', 'rem'].",
+            )
+
+        params = {
+            "custom_task_ids": "true",
+            "team_id": self.team_id,
+            "include_subtasks": "true",
+        }
+
+        payload = {"assignees": assigne_payload}
+        response = requests.put(url, headers=headers, params=params, json=payload)
+        return {"response": response}
+
+    def create_task(self, query: str) -> Dict:
+        """
+        Creates a new task.
+        """
+        query_dict, error = load_query(query, fault_tolerant=True)
+        if query_dict is None:
+            return {"Error": error}
+
+        list_id = self.list_id
+        url = f"{DEFAULT_URL}/list/{list_id}/task"
+        params = {"custom_task_ids": "true", "team_id": self.team_id}
+
+        payload = extract_dict_elements_from_component_fields(query_dict, Task)
+        headers = self.get_headers()
+
+        response = requests.post(url, json=payload, headers=headers, params=params)
+        data: Dict = response.json()
+        return parse_dict_through_component(data, Task, fault_tolerant=True)
+
+    def create_list(self, query: str) -> Dict:
+        """
+        Creates a new list.
+        """
+        query_dict, error = load_query(query, fault_tolerant=True)
+        if query_dict is None:
+            return {"Error": error}
+
+        # Default to using folder as location if it exists.
+        # If not, fall back to using the space.
+        location = self.folder_id if self.folder_id else self.space_id
+        url = f"{DEFAULT_URL}/folder/{location}/list"
+
+        payload = extract_dict_elements_from_component_fields(query_dict, Task)
+        headers = self.get_headers()
+
+        response = requests.post(url, json=payload, headers=headers)
+        data = response.json()
+        parsed_list = parse_dict_through_component(data, CUList, fault_tolerant=True)
+        # set list id to new list
+        if "id" in parsed_list:
+            self.list_id = parsed_list["id"]
+        return parsed_list
+
+    def create_folder(self, query: str) -> Dict:
+        """
+        Creates a new folder.
+        """
+
+        query_dict, error = load_query(query, fault_tolerant=True)
+        if query_dict is None:
+            return {"Error": error}
+
+        space_id = self.space_id
+        url = f"{DEFAULT_URL}/space/{space_id}/folder"
+        payload = {
+            "name": query_dict["name"],
+        }
+
+        headers = self.get_headers()
+
+        response = requests.post(url, json=payload, headers=headers)
+        data = response.json()
+
+        if "id" in data:
+            self.list_id = data["id"]
+        return data
+
+    def run(self, mode: str, query: str) -> str:
+        """Run the API."""
+        if mode == "get_task":
+            output = self.get_task(query)
+        elif mode == "get_task_attribute":
+            output = self.get_task_attribute(query)
+        elif mode == "get_teams":
+            output = self.get_authorized_teams()
+        elif mode == "create_task":
+            output = self.create_task(query)
+        elif mode == "create_list":
+            output = self.create_list(query)
+        elif mode == "create_folder":
+            output = self.create_folder(query)
+        elif mode == "get_lists":
+            output = self.get_lists()
+        elif mode == "get_folders":
+            output = self.get_folders()
+        elif mode == "get_spaces":
+            output = self.get_spaces()
+        elif mode == "update_task":
+            output = self.update_task(query)
+        elif mode == "update_task_assignees":
+            output = self.update_task_assignees(query)
+        else:
+            output = {"ModeError": f"Got unexpected mode {mode}."}
+
+        try:
+            return json.dumps(output)
+        except Exception:
+            return str(output)
diff --git a/llm/Lib/site-packages/langchain_community/utilities/dalle_image_generator.py b/llm/Lib/site-packages/langchain_community/utilities/dalle_image_generator.py
new file mode 100644
index 0000000000000000000000000000000000000000..6dddb710be85bc9c52fa3eba473cc070c44637e7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/dalle_image_generator.py
@@ -0,0 +1,164 @@
+"""Utility that calls OpenAI's Dall-E Image Generator."""
+import logging
+import os
+from typing import Any, Dict, Mapping, Optional, Tuple, Union
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+from langchain_core.utils import (
+    get_from_dict_or_env,
+    get_pydantic_field_names,
+)
+
+from langchain_community.utils.openai import is_openai_v1
+
+logger = logging.getLogger(__name__)
+
+
+class DallEAPIWrapper(BaseModel):
+    """Wrapper for OpenAI's DALL-E Image Generator.
+
+    https://platform.openai.com/docs/guides/images/generations?context=node
+
+    Usage instructions:
+
+    1. `pip install openai`
+    2. save your OPENAI_API_KEY in an environment variable
+    """
+
+    client: Any  #: :meta private:
+    async_client: Any = Field(default=None, exclude=True)  #: :meta private:
+    model_name: str = Field(default="dall-e-2", alias="model")
+    model_kwargs: Dict[str, Any] = Field(default_factory=dict)
+    openai_api_key: Optional[str] = Field(default=None, alias="api_key")
+    """Automatically inferred from env var `OPENAI_API_KEY` if not provided."""
+    openai_api_base: Optional[str] = Field(default=None, alias="base_url")
+    """Base URL path for API requests, leave blank if not using a proxy or service 
+        emulator."""
+    openai_organization: Optional[str] = Field(default=None, alias="organization")
+    """Automatically inferred from env var `OPENAI_ORG_ID` if not provided."""
+    # to support explicit proxy for OpenAI
+    openai_proxy: Optional[str] = None
+    request_timeout: Union[float, Tuple[float, float], Any, None] = Field(
+        default=None, alias="timeout"
+    )
+    n: int = 1
+    """Number of images to generate"""
+    size: str = "1024x1024"
+    """Size of image to generate"""
+    separator: str = "\n"
+    """Separator to use when multiple URLs are returned."""
+    quality: Optional[str] = "standard"
+    """Quality of the image that will be generated"""
+    max_retries: int = 2
+    """Maximum number of retries to make when generating."""
+    default_headers: Union[Mapping[str, str], None] = None
+    default_query: Union[Mapping[str, object], None] = None
+    # Configure a custom httpx client. See the
+    # [httpx documentation](https://www.python-httpx.org/api/#client) for more details.
+    http_client: Union[Any, None] = None
+    """Optional httpx.Client."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def build_extra(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Build extra kwargs from additional params that were passed in."""
+        all_required_field_names = get_pydantic_field_names(cls)
+        extra = values.get("model_kwargs", {})
+        for field_name in list(values):
+            if field_name in extra:
+                raise ValueError(f"Found {field_name} supplied twice.")
+            if field_name not in all_required_field_names:
+                logger.warning(
+                    f"""WARNING! {field_name} is not default parameter.
+                    {field_name} was transferred to model_kwargs.
+                    Please confirm that {field_name} is what you intended."""
+                )
+                extra[field_name] = values.pop(field_name)
+
+        invalid_model_kwargs = all_required_field_names.intersection(extra.keys())
+        if invalid_model_kwargs:
+            raise ValueError(
+                f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+                f"Instead they were passed in as part of `model_kwargs` parameter."
+            )
+
+        values["model_kwargs"] = extra
+        return values
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["openai_api_key"] = get_from_dict_or_env(
+            values, "openai_api_key", "OPENAI_API_KEY"
+        )
+        # Check OPENAI_ORGANIZATION for backwards compatibility.
+        values["openai_organization"] = (
+            values["openai_organization"]
+            or os.getenv("OPENAI_ORG_ID")
+            or os.getenv("OPENAI_ORGANIZATION")
+            or None
+        )
+        values["openai_api_base"] = values["openai_api_base"] or os.getenv(
+            "OPENAI_API_BASE"
+        )
+        values["openai_proxy"] = get_from_dict_or_env(
+            values,
+            "openai_proxy",
+            "OPENAI_PROXY",
+            default="",
+        )
+
+        try:
+            import openai
+
+        except ImportError:
+            raise ImportError(
+                "Could not import openai python package. "
+                "Please install it with `pip install openai`."
+            )
+
+        if is_openai_v1():
+            client_params = {
+                "api_key": values["openai_api_key"],
+                "organization": values["openai_organization"],
+                "base_url": values["openai_api_base"],
+                "timeout": values["request_timeout"],
+                "max_retries": values["max_retries"],
+                "default_headers": values["default_headers"],
+                "default_query": values["default_query"],
+                "http_client": values["http_client"],
+            }
+
+            if not values.get("client"):
+                values["client"] = openai.OpenAI(**client_params).images
+            if not values.get("async_client"):
+                values["async_client"] = openai.AsyncOpenAI(**client_params).images
+        elif not values.get("client"):
+            values["client"] = openai.Image
+        else:
+            pass
+        return values
+
+    def run(self, query: str) -> str:
+        """Run query through OpenAI and parse result."""
+
+        if is_openai_v1():
+            response = self.client.generate(
+                prompt=query,
+                n=self.n,
+                size=self.size,
+                model=self.model_name,
+                quality=self.quality,
+            )
+            image_urls = self.separator.join([item.url for item in response.data])
+        else:
+            response = self.client.create(
+                prompt=query, n=self.n, size=self.size, model=self.model_name
+            )
+            image_urls = self.separator.join([item["url"] for item in response["data"]])
+
+        return image_urls if image_urls else "No image was generated"
diff --git a/llm/Lib/site-packages/langchain_community/utilities/dataforseo_api_search.py b/llm/Lib/site-packages/langchain_community/utilities/dataforseo_api_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..16c90fc4ff6eaab22c7a056103a1b14ab3d69dec
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/dataforseo_api_search.py
@@ -0,0 +1,195 @@
+import base64
+from typing import Dict, Optional
+from urllib.parse import quote
+
+import aiohttp
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class DataForSeoAPIWrapper(BaseModel):
+    """Wrapper around the DataForSeo API."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    default_params: dict = Field(
+        default={
+            "location_name": "United States",
+            "language_code": "en",
+            "depth": 10,
+            "se_name": "google",
+            "se_type": "organic",
+        }
+    )
+    """Default parameters to use for the DataForSEO SERP API."""
+    params: dict = Field(default={})
+    """Additional parameters to pass to the DataForSEO SERP API."""
+    api_login: Optional[str] = None
+    """The API login to use for the DataForSEO SERP API."""
+    api_password: Optional[str] = None
+    """The API password to use for the DataForSEO SERP API."""
+    json_result_types: Optional[list] = None
+    """The JSON result types."""
+    json_result_fields: Optional[list] = None
+    """The JSON result fields."""
+    top_count: Optional[int] = None
+    """The number of top results to return."""
+    aiosession: Optional[aiohttp.ClientSession] = None
+    """The aiohttp session to use for the DataForSEO SERP API."""
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that login and password exists in environment."""
+        login = get_from_dict_or_env(values, "api_login", "DATAFORSEO_LOGIN")
+        password = get_from_dict_or_env(values, "api_password", "DATAFORSEO_PASSWORD")
+        values["api_login"] = login
+        values["api_password"] = password
+        return values
+
+    async def arun(self, url: str) -> str:
+        """Run request to DataForSEO SERP API and parse result async."""
+        return self._process_response(await self._aresponse_json(url))
+
+    def run(self, url: str) -> str:
+        """Run request to DataForSEO SERP API and parse result async."""
+        return self._process_response(self._response_json(url))
+
+    def results(self, url: str) -> list:
+        res = self._response_json(url)
+        return self._filter_results(res)
+
+    async def aresults(self, url: str) -> list:
+        res = await self._aresponse_json(url)
+        return self._filter_results(res)
+
+    def _prepare_request(self, keyword: str) -> dict:
+        """Prepare the request details for the DataForSEO SERP API."""
+        if self.api_login is None or self.api_password is None:
+            raise ValueError("api_login or api_password is not provided")
+        cred = base64.b64encode(
+            f"{self.api_login}:{self.api_password}".encode("utf-8")
+        ).decode("utf-8")
+        headers = {"Authorization": f"Basic {cred}", "Content-Type": "application/json"}
+        obj = {"keyword": quote(keyword)}
+        obj = {**obj, **self.default_params, **self.params}
+        data = [obj]
+        _url = (
+            f"https://api.dataforseo.com/v3/serp/{obj['se_name']}"
+            f"/{obj['se_type']}/live/advanced"
+        )
+        return {
+            "url": _url,
+            "headers": headers,
+            "data": data,
+        }
+
+    def _check_response(self, response: dict) -> dict:
+        """Check the response from the DataForSEO SERP API for errors."""
+        if response.get("status_code") != 20000:
+            raise ValueError(
+                f"Got error from DataForSEO SERP API: {response.get('status_message')}"
+            )
+        return response
+
+    def _response_json(self, url: str) -> dict:
+        """Use requests to run request to DataForSEO SERP API and return results."""
+        request_details = self._prepare_request(url)
+        response = requests.post(
+            request_details["url"],
+            headers=request_details["headers"],
+            json=request_details["data"],
+        )
+        response.raise_for_status()
+        return self._check_response(response.json())
+
+    async def _aresponse_json(self, url: str) -> dict:
+        """Use aiohttp to request DataForSEO SERP API and return results async."""
+        request_details = self._prepare_request(url)
+        if not self.aiosession:
+            async with aiohttp.ClientSession() as session:
+                async with session.post(
+                    request_details["url"],
+                    headers=request_details["headers"],
+                    json=request_details["data"],
+                ) as response:
+                    res = await response.json()
+        else:
+            async with self.aiosession.post(
+                request_details["url"],
+                headers=request_details["headers"],
+                json=request_details["data"],
+            ) as response:
+                res = await response.json()
+        return self._check_response(res)
+
+    def _filter_results(self, res: dict) -> list:
+        output = []
+        types = self.json_result_types if self.json_result_types is not None else []
+        for task in res.get("tasks", []):
+            for result in task.get("result", []):
+                for item in result.get("items", []):
+                    if len(types) == 0 or item.get("type", "") in types:
+                        self._cleanup_unnecessary_items(item)
+                        if len(item) != 0:
+                            output.append(item)
+                    if self.top_count is not None and len(output) >= self.top_count:
+                        break
+        return output
+
+    def _cleanup_unnecessary_items(self, d: dict) -> dict:
+        fields = self.json_result_fields if self.json_result_fields is not None else []
+        if len(fields) > 0:
+            for k, v in list(d.items()):
+                if isinstance(v, dict):
+                    self._cleanup_unnecessary_items(v)
+                    if len(v) == 0:
+                        del d[k]
+                elif k not in fields:
+                    del d[k]
+
+        if "xpath" in d:
+            del d["xpath"]
+        if "position" in d:
+            del d["position"]
+        if "rectangle" in d:
+            del d["rectangle"]
+        for k, v in list(d.items()):
+            if isinstance(v, dict):
+                self._cleanup_unnecessary_items(v)
+        return d
+
+    def _process_response(self, res: dict) -> str:
+        """Process response from DataForSEO SERP API."""
+        toret = "No good search result found"
+        for task in res.get("tasks", []):
+            for result in task.get("result", []):
+                item_types = result.get("item_types")
+                items = result.get("items", [])
+                if "answer_box" in item_types:
+                    toret = next(
+                        item for item in items if item.get("type") == "answer_box"
+                    ).get("text")
+                elif "knowledge_graph" in item_types:
+                    toret = next(
+                        item for item in items if item.get("type") == "knowledge_graph"
+                    ).get("description")
+                elif "featured_snippet" in item_types:
+                    toret = next(
+                        item for item in items if item.get("type") == "featured_snippet"
+                    ).get("description")
+                elif "shopping" in item_types:
+                    toret = next(
+                        item for item in items if item.get("type") == "shopping"
+                    ).get("price")
+                elif "organic" in item_types:
+                    toret = next(
+                        item for item in items if item.get("type") == "organic"
+                    ).get("description")
+                if toret:
+                    break
+        return toret
diff --git a/llm/Lib/site-packages/langchain_community/utilities/dataherald.py b/llm/Lib/site-packages/langchain_community/utilities/dataherald.py
new file mode 100644
index 0000000000000000000000000000000000000000..a085e23bb15dfd506003b1662b54a8e9c61c096a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/dataherald.py
@@ -0,0 +1,67 @@
+"""Util that calls Dataherald."""
+from typing import Any, Dict, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class DataheraldAPIWrapper(BaseModel):
+    """Wrapper for Dataherald.
+
+    Docs for using:
+
+    1. Go to dataherald and sign up
+    2. Create an API key
+    3. Save your API key into DATAHERALD_API_KEY env variable
+    4. pip install dataherald
+
+    """
+
+    dataherald_client: Any  #: :meta private:
+    db_connection_id: str
+    dataherald_api_key: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        dataherald_api_key = get_from_dict_or_env(
+            values, "dataherald_api_key", "DATAHERALD_API_KEY"
+        )
+        values["dataherald_api_key"] = dataherald_api_key
+
+        try:
+            import dataherald
+
+        except ImportError:
+            raise ImportError(
+                "dataherald is not installed. "
+                "Please install it with `pip install dataherald`"
+            )
+
+        client = dataherald.Dataherald(api_key=dataherald_api_key)
+        values["dataherald_client"] = client
+
+        return values
+
+    def run(self, prompt: str) -> str:
+        """Generate a sql query through Dataherald and parse result."""
+        from dataherald.types.sql_generation_create_params import Prompt
+
+        prompt_obj = Prompt(text=prompt, db_connection_id=self.db_connection_id)
+        res = self.dataherald_client.sql_generations.create(prompt=prompt_obj)
+
+        try:
+            answer = res.sql
+            if not answer:
+                # We don't want to return the assumption alone if answer is empty
+                return "No answer"
+            else:
+                return f"Answer: {answer}"
+
+        except StopIteration:
+            return "Dataherald wasn't able to answer it"
diff --git a/llm/Lib/site-packages/langchain_community/utilities/dria_index.py b/llm/Lib/site-packages/langchain_community/utilities/dria_index.py
new file mode 100644
index 0000000000000000000000000000000000000000..5174751dfc646991893672eb97f425192d6fb234
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/dria_index.py
@@ -0,0 +1,95 @@
+import logging
+from typing import Any, Dict, List, Optional, Union
+
+logger = logging.getLogger(__name__)
+
+
+class DriaAPIWrapper:
+    """Wrapper around Dria API.
+
+    This wrapper facilitates interactions with Dria's vector search
+    and retrieval services, including creating knowledge bases, inserting data,
+    and fetching search results.
+
+    Attributes:
+        api_key: Your API key for accessing Dria.
+        contract_id: The contract ID of the knowledge base to interact with.
+        top_n: Number of top results to fetch for a search.
+    """
+
+    def __init__(
+        self, api_key: str, contract_id: Optional[str] = None, top_n: int = 10
+    ):
+        try:
+            from dria import Dria, Models
+        except ImportError:
+            logger.error(
+                """Dria is not installed. Please install Dria to use this wrapper.
+                
+                You can install Dria using the following command:
+                pip install dria
+                """
+            )
+            return
+
+        self.api_key = api_key
+        self.models = Models
+        self.contract_id = contract_id
+        self.top_n = top_n
+        self.dria_client = Dria(api_key=self.api_key)
+        if self.contract_id:
+            self.dria_client.set_contract(self.contract_id)
+
+    def create_knowledge_base(
+        self,
+        name: str,
+        description: str,
+        category: str,
+        embedding: str,
+    ) -> str:
+        """Create a new knowledge base."""
+        contract_id = self.dria_client.create(
+            name=name, embedding=embedding, category=category, description=description
+        )
+        logger.info(f"Knowledge base created with ID: {contract_id}")
+        self.contract_id = contract_id
+        return contract_id
+
+    def insert_data(self, data: List[Dict[str, Any]]) -> str:
+        """Insert data into the knowledge base."""
+        response = self.dria_client.insert_text(data)
+        logger.info(f"Data inserted: {response}")
+        return response
+
+    def search(self, query: str) -> List[Dict[str, Any]]:
+        """Perform a text-based search."""
+        results = self.dria_client.search(query, top_n=self.top_n)
+        logger.info(f"Search results: {results}")
+        return results
+
+    def query_with_vector(self, vector: List[float]) -> List[Dict[str, Any]]:
+        """Perform a vector-based query."""
+        vector_query_results = self.dria_client.query(vector, top_n=self.top_n)
+        logger.info(f"Vector query results: {vector_query_results}")
+        return vector_query_results
+
+    def run(self, query: Union[str, List[float]]) -> Optional[List[Dict[str, Any]]]:
+        """Method to handle both text-based searches and vector-based queries.
+
+        Args:
+            query: A string for text-based search or a list of floats for
+            vector-based query.
+
+        Returns:
+            The search or query results from Dria.
+        """
+        if isinstance(query, str):
+            return self.search(query)
+        elif isinstance(query, list) and all(isinstance(item, float) for item in query):
+            return self.query_with_vector(query)
+        else:
+            logger.error(
+                """Invalid query type. Please provide a string for text search or a 
+                list of floats for vector query."""
+            )
+            return None
diff --git a/llm/Lib/site-packages/langchain_community/utilities/duckduckgo_search.py b/llm/Lib/site-packages/langchain_community/utilities/duckduckgo_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..d258726896ab3845b55d3bfb5d48d09ec7ebbd63
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/duckduckgo_search.py
@@ -0,0 +1,130 @@
+"""Util that calls DuckDuckGo Search.
+
+No setup required. Free.
+https://pypi.org/project/duckduckgo-search/
+"""
+from typing import Dict, List, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+
+class DuckDuckGoSearchAPIWrapper(BaseModel):
+    """Wrapper for DuckDuckGo Search API.
+
+    Free and does not require any setup.
+    """
+
+    region: Optional[str] = "wt-wt"
+    safesearch: str = "moderate"
+    time: Optional[str] = "y"
+    max_results: int = 5
+    backend: str = "api"  # which backend to use in DDGS.text() (api, html, lite)
+    source: str = "text"  # which function to use in DDGS (DDGS.text() or DDGS.news())
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that python package exists in environment."""
+        try:
+            from duckduckgo_search import DDGS  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "Could not import duckduckgo-search python package. "
+                "Please install it with `pip install -U duckduckgo-search`."
+            )
+        return values
+
+    def _ddgs_text(
+        self, query: str, max_results: Optional[int] = None
+    ) -> List[Dict[str, str]]:
+        """Run query through DuckDuckGo text search and return results."""
+        from duckduckgo_search import DDGS
+
+        with DDGS() as ddgs:
+            ddgs_gen = ddgs.text(
+                query,
+                region=self.region,
+                safesearch=self.safesearch,
+                timelimit=self.time,
+                max_results=max_results or self.max_results,
+                backend=self.backend,
+            )
+            if ddgs_gen:
+                return [r for r in ddgs_gen]
+        return []
+
+    def _ddgs_news(
+        self, query: str, max_results: Optional[int] = None
+    ) -> List[Dict[str, str]]:
+        """Run query through DuckDuckGo news search and return results."""
+        from duckduckgo_search import DDGS
+
+        with DDGS() as ddgs:
+            ddgs_gen = ddgs.news(
+                query,
+                region=self.region,
+                safesearch=self.safesearch,
+                timelimit=self.time,
+                max_results=max_results or self.max_results,
+            )
+            if ddgs_gen:
+                return [r for r in ddgs_gen]
+        return []
+
+    def run(self, query: str) -> str:
+        """Run query through DuckDuckGo and return concatenated results."""
+        if self.source == "text":
+            results = self._ddgs_text(query)
+        elif self.source == "news":
+            results = self._ddgs_news(query)
+        else:
+            results = []
+
+        if not results:
+            return "No good DuckDuckGo Search Result was found"
+        return " ".join(r["body"] for r in results)
+
+    def results(
+        self, query: str, max_results: int, source: Optional[str] = None
+    ) -> List[Dict[str, str]]:
+        """Run query through DuckDuckGo and return metadata.
+
+        Args:
+            query: The query to search for.
+            max_results: The number of results to return.
+            source: The source to look from.
+
+        Returns:
+            A list of dictionaries with the following keys:
+                snippet - The description of the result.
+                title - The title of the result.
+                link - The link to the result.
+        """
+        source = source or self.source
+        if source == "text":
+            results = [
+                {"snippet": r["body"], "title": r["title"], "link": r["href"]}
+                for r in self._ddgs_text(query, max_results=max_results)
+            ]
+        elif source == "news":
+            results = [
+                {
+                    "snippet": r["body"],
+                    "title": r["title"],
+                    "link": r["url"],
+                    "date": r["date"],
+                    "source": r["source"],
+                }
+                for r in self._ddgs_news(query, max_results=max_results)
+            ]
+        else:
+            results = []
+
+        if results is None:
+            results = [{"Result": "No good DuckDuckGo Search Result was found"}]
+
+        return results
diff --git a/llm/Lib/site-packages/langchain_community/utilities/github.py b/llm/Lib/site-packages/langchain_community/utilities/github.py
new file mode 100644
index 0000000000000000000000000000000000000000..410fdb494b7c38cfc58722258f55cb5f92046a57
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/github.py
@@ -0,0 +1,854 @@
+"""Util that calls GitHub."""
+
+from __future__ import annotations
+
+import json
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+if TYPE_CHECKING:
+    from github.Issue import Issue
+    from github.PullRequest import PullRequest
+
+
+def _import_tiktoken() -> Any:
+    """Import tiktoken."""
+    try:
+        import tiktoken
+    except ImportError:
+        raise ImportError(
+            "tiktoken is not installed. "
+            "Please install it with `pip install tiktoken`"
+        )
+    return tiktoken
+
+
+class GitHubAPIWrapper(BaseModel):
+    """Wrapper for GitHub API."""
+
+    github: Any  #: :meta private:
+    github_repo_instance: Any  #: :meta private:
+    github_repository: Optional[str] = None
+    github_app_id: Optional[str] = None
+    github_app_private_key: Optional[str] = None
+    active_branch: Optional[str] = None
+    github_base_branch: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        github_repository = get_from_dict_or_env(
+            values, "github_repository", "GITHUB_REPOSITORY"
+        )
+
+        github_app_id = get_from_dict_or_env(values, "github_app_id", "GITHUB_APP_ID")
+
+        github_app_private_key = get_from_dict_or_env(
+            values, "github_app_private_key", "GITHUB_APP_PRIVATE_KEY"
+        )
+
+        try:
+            from github import Auth, GithubIntegration
+
+        except ImportError:
+            raise ImportError(
+                "PyGithub is not installed. "
+                "Please install it with `pip install PyGithub`"
+            )
+
+        try:
+            # interpret the key as a file path
+            # fallback to interpreting as the key itself
+            with open(github_app_private_key, "r") as f:
+                private_key = f.read()
+        except Exception:
+            private_key = github_app_private_key
+
+        auth = Auth.AppAuth(
+            github_app_id,
+            private_key,
+        )
+        gi = GithubIntegration(auth=auth)
+        installation = gi.get_installations()
+        if not installation:
+            raise ValueError(
+                f"Please make sure to install the created github app with id "
+                f"{github_app_id} on the repo: {github_repository}"
+                "More instructions can be found at "
+                "https://docs.github.com/en/apps/using-"
+                "github-apps/installing-your-own-github-app"
+            )
+        try:
+            installation = installation[0]
+        except ValueError as e:
+            raise ValueError(
+                "Please make sure to give correct github parameters "
+                f"Error message: {e}"
+            )
+        # create a GitHub instance:
+        g = installation.get_github_for_installation()
+        repo = g.get_repo(github_repository)
+
+        github_base_branch = get_from_dict_or_env(
+            values,
+            "github_base_branch",
+            "GITHUB_BASE_BRANCH",
+            default=repo.default_branch,
+        )
+
+        active_branch = get_from_dict_or_env(
+            values,
+            "active_branch",
+            "ACTIVE_BRANCH",
+            default=repo.default_branch,
+        )
+
+        values["github"] = g
+        values["github_repo_instance"] = repo
+        values["github_repository"] = github_repository
+        values["github_app_id"] = github_app_id
+        values["github_app_private_key"] = github_app_private_key
+        values["active_branch"] = active_branch
+        values["github_base_branch"] = github_base_branch
+
+        return values
+
+    def parse_issues(self, issues: List[Issue]) -> List[dict]:
+        """
+        Extracts title and number from each Issue and puts them in a dictionary
+        Parameters:
+            issues(List[Issue]): A list of Github Issue objects
+        Returns:
+            List[dict]: A dictionary of issue titles and numbers
+        """
+        parsed = []
+        for issue in issues:
+            title = issue.title
+            number = issue.number
+            opened_by = issue.user.login if issue.user else None
+            issue_dict = {"title": title, "number": number}
+            if opened_by is not None:
+                issue_dict["opened_by"] = opened_by
+            parsed.append(issue_dict)
+        return parsed
+
+    def parse_pull_requests(self, pull_requests: List[PullRequest]) -> List[dict]:
+        """
+        Extracts title and number from each Issue and puts them in a dictionary
+        Parameters:
+            issues(List[Issue]): A list of Github Issue objects
+        Returns:
+            List[dict]: A dictionary of issue titles and numbers
+        """
+        parsed = []
+        for pr in pull_requests:
+            parsed.append(
+                {
+                    "title": pr.title,
+                    "number": pr.number,
+                    "commits": str(pr.commits),
+                    "comments": str(pr.comments),
+                }
+            )
+        return parsed
+
+    def get_issues(self) -> str:
+        """
+        Fetches all open issues from the repo excluding pull requests
+
+        Returns:
+            str: A plaintext report containing the number of issues
+            and each issue's title and number.
+        """
+        issues = self.github_repo_instance.get_issues(state="open")
+        # Filter out pull requests (part of GH issues object)
+        issues = [issue for issue in issues if not issue.pull_request]
+        if issues:
+            parsed_issues = self.parse_issues(issues)
+            parsed_issues_str = (
+                "Found " + str(len(parsed_issues)) + " issues:\n" + str(parsed_issues)
+            )
+            return parsed_issues_str
+        else:
+            return "No open issues available"
+
+    def list_open_pull_requests(self) -> str:
+        """
+        Fetches all open PRs from the repo
+
+        Returns:
+            str: A plaintext report containing the number of PRs
+            and each PR's title and number.
+        """
+        # issues = self.github_repo_instance.get_issues(state="open")
+        pull_requests = self.github_repo_instance.get_pulls(state="open")
+        if pull_requests.totalCount > 0:
+            parsed_prs = self.parse_pull_requests(pull_requests)
+            parsed_prs_str = (
+                "Found " + str(len(parsed_prs)) + " pull requests:\n" + str(parsed_prs)
+            )
+            return parsed_prs_str
+        else:
+            return "No open pull requests available"
+
+    def list_files_in_main_branch(self) -> str:
+        """
+        Fetches all files in the main branch of the repo.
+
+        Returns:
+            str: A plaintext report containing the paths and names of the files.
+        """
+        files: List[str] = []
+        try:
+            contents = self.github_repo_instance.get_contents(
+                "", ref=self.github_base_branch
+            )
+            for content in contents:
+                if content.type == "dir":
+                    files.extend(self.get_files_from_directory(content.path))
+                else:
+                    files.append(content.path)
+
+            if files:
+                files_str = "\n".join(files)
+                return f"Found {len(files)} files in the main branch:\n{files_str}"
+            else:
+                return "No files found in the main branch"
+        except Exception as e:
+            return str(e)
+
+    def set_active_branch(self, branch_name: str) -> str:
+        """Equivalent to `git checkout branch_name` for this Agent.
+        Clones formatting from Github.
+
+        Returns an Error (as a string) if branch doesn't exist.
+        """
+        curr_branches = [
+            branch.name for branch in self.github_repo_instance.get_branches()
+        ]
+        if branch_name in curr_branches:
+            self.active_branch = branch_name
+            return f"Switched to branch `{branch_name}`"
+        else:
+            return (
+                f"Error {branch_name} does not exist,"
+                f"in repo with current branches: {str(curr_branches)}"
+            )
+
+    def list_branches_in_repo(self) -> str:
+        """
+        Fetches a list of all branches in the repository.
+
+        Returns:
+            str: A plaintext report containing the names of the branches.
+        """
+        try:
+            branches = [
+                branch.name for branch in self.github_repo_instance.get_branches()
+            ]
+            if branches:
+                branches_str = "\n".join(branches)
+                return (
+                    f"Found {len(branches)} branches in the repository:"
+                    f"\n{branches_str}"
+                )
+            else:
+                return "No branches found in the repository"
+        except Exception as e:
+            return str(e)
+
+    def create_branch(self, proposed_branch_name: str) -> str:
+        """
+        Create a new branch, and set it as the active bot branch.
+        Equivalent to `git switch -c proposed_branch_name`
+        If the proposed branch already exists, we append _v1 then _v2...
+        until a unique name is found.
+
+        Returns:
+            str: A plaintext success message.
+        """
+        from github import GithubException
+
+        i = 0
+        new_branch_name = proposed_branch_name
+        base_branch = self.github_repo_instance.get_branch(
+            self.github_repo_instance.default_branch
+        )
+        for i in range(1000):
+            try:
+                self.github_repo_instance.create_git_ref(
+                    ref=f"refs/heads/{new_branch_name}", sha=base_branch.commit.sha
+                )
+                self.active_branch = new_branch_name
+                return (
+                    f"Branch '{new_branch_name}' "
+                    "created successfully, and set as current active branch."
+                )
+            except GithubException as e:
+                if e.status == 422 and "Reference already exists" in e.data["message"]:
+                    i += 1
+                    new_branch_name = f"{proposed_branch_name}_v{i}"
+                else:
+                    # Handle any other exceptions
+                    print(f"Failed to create branch. Error: {e}")  # noqa: T201
+                    raise Exception(
+                        "Unable to create branch name from proposed_branch_name: "
+                        f"{proposed_branch_name}"
+                    )
+        return (
+            "Unable to create branch. "
+            "At least 1000 branches exist with named derived from "
+            f"proposed_branch_name: `{proposed_branch_name}`"
+        )
+
+    def list_files_in_bot_branch(self) -> str:
+        """
+        Fetches all files in the active branch of the repo,
+        the branch the bot uses to make changes.
+
+        Returns:
+            str: A plaintext list containing the the filepaths in the branch.
+        """
+        files: List[str] = []
+        try:
+            contents = self.github_repo_instance.get_contents(
+                "", ref=self.active_branch
+            )
+            for content in contents:
+                if content.type == "dir":
+                    files.extend(self.get_files_from_directory(content.path))
+                else:
+                    files.append(content.path)
+
+            if files:
+                files_str = "\n".join(files)
+                return (
+                    f"Found {len(files)} files in branch `{self.active_branch}`:\n"
+                    f"{files_str}"
+                )
+            else:
+                return f"No files found in branch: `{self.active_branch}`"
+        except Exception as e:
+            return f"Error: {e}"
+
+    def get_files_from_directory(self, directory_path: str) -> str:
+        """
+        Recursively fetches files from a directory in the repo.
+
+        Parameters:
+            directory_path (str): Path to the directory
+
+        Returns:
+            str: List of file paths, or an error message.
+        """
+        from github import GithubException
+
+        files: List[str] = []
+        try:
+            contents = self.github_repo_instance.get_contents(
+                directory_path, ref=self.active_branch
+            )
+        except GithubException as e:
+            return f"Error: status code {e.status}, {e.message}"
+
+        for content in contents:
+            if content.type == "dir":
+                files.extend(self.get_files_from_directory(content.path))
+            else:
+                files.append(content.path)
+        return str(files)
+
+    def get_issue(self, issue_number: int) -> Dict[str, Any]:
+        """
+        Fetches a specific issue and its first 10 comments
+        Parameters:
+            issue_number(int): The number for the github issue
+        Returns:
+            dict: A dictionary containing the issue's title,
+            body, comments as a string, and the username of the user
+            who opened the issue
+        """
+        issue = self.github_repo_instance.get_issue(number=issue_number)
+        page = 0
+        comments: List[dict] = []
+        while len(comments) <= 10:
+            comments_page = issue.get_comments().get_page(page)
+            if len(comments_page) == 0:
+                break
+            for comment in comments_page:
+                comments.append({"body": comment.body, "user": comment.user.login})
+            page += 1
+
+        opened_by = None
+        if issue.user and issue.user.login:
+            opened_by = issue.user.login
+
+        return {
+            "number": issue_number,
+            "title": issue.title,
+            "body": issue.body,
+            "comments": str(comments),
+            "opened_by": str(opened_by),
+        }
+
+    def list_pull_request_files(self, pr_number: int) -> List[Dict[str, Any]]:
+        """Fetches the full text of all files in a PR. Truncates after first 3k tokens.
+        # TODO: Enhancement to summarize files with ctags if they're getting long.
+
+        Args:
+            pr_number(int): The number of the pull request on Github
+
+        Returns:
+            dict: A dictionary containing the issue's title,
+            body, and comments as a string
+        """
+        tiktoken = _import_tiktoken()
+        MAX_TOKENS_FOR_FILES = 3_000
+        pr_files = []
+        pr = self.github_repo_instance.get_pull(number=int(pr_number))
+        total_tokens = 0
+        page = 0
+        while True:  # or while (total_tokens + tiktoken()) < MAX_TOKENS_FOR_FILES:
+            files_page = pr.get_files().get_page(page)
+            if len(files_page) == 0:
+                break
+            for file in files_page:
+                try:
+                    file_metadata_response = requests.get(file.contents_url)
+                    if file_metadata_response.status_code == 200:
+                        download_url = json.loads(file_metadata_response.text)[
+                            "download_url"
+                        ]
+                    else:
+                        print(f"Failed to download file: {file.contents_url}, skipping")  # noqa: T201
+                        continue
+
+                    file_content_response = requests.get(download_url)
+                    if file_content_response.status_code == 200:
+                        # Save the content as a UTF-8 string
+                        file_content = file_content_response.text
+                    else:
+                        print(  # noqa: T201
+                            "Failed downloading file content "
+                            f"(Error {file_content_response.status_code}). Skipping"
+                        )
+                        continue
+
+                    file_tokens = len(
+                        tiktoken.get_encoding("cl100k_base").encode(
+                            file_content + file.filename + "file_name file_contents"
+                        )
+                    )
+                    if (total_tokens + file_tokens) < MAX_TOKENS_FOR_FILES:
+                        pr_files.append(
+                            {
+                                "filename": file.filename,
+                                "contents": file_content,
+                                "additions": file.additions,
+                                "deletions": file.deletions,
+                            }
+                        )
+                        total_tokens += file_tokens
+                except Exception as e:
+                    print(f"Error when reading files from a PR on github. {e}")  # noqa: T201
+            page += 1
+        return pr_files
+
+    def get_pull_request(self, pr_number: int) -> Dict[str, Any]:
+        """
+        Fetches a specific pull request and its first 10 comments,
+        limited by max_tokens.
+
+        Parameters:
+            pr_number(int): The number for the Github pull
+            max_tokens(int): The maximum number of tokens in the response
+        Returns:
+            dict: A dictionary containing the pull's title, body,
+            and comments as a string
+        """
+        max_tokens = 2_000
+        pull = self.github_repo_instance.get_pull(number=pr_number)
+        total_tokens = 0
+
+        def get_tokens(text: str) -> int:
+            tiktoken = _import_tiktoken()
+            return len(tiktoken.get_encoding("cl100k_base").encode(text))
+
+        def add_to_dict(data_dict: Dict[str, Any], key: str, value: str) -> None:
+            nonlocal total_tokens  # Declare total_tokens as nonlocal
+            tokens = get_tokens(value)
+            if total_tokens + tokens <= max_tokens:
+                data_dict[key] = value
+                total_tokens += tokens  # Now this will modify the outer variable
+
+        response_dict: Dict[str, str] = {}
+        add_to_dict(response_dict, "title", pull.title)
+        add_to_dict(response_dict, "number", str(pr_number))
+        add_to_dict(response_dict, "body", pull.body)
+
+        comments: List[str] = []
+        page = 0
+        while len(comments) <= 10:
+            comments_page = pull.get_issue_comments().get_page(page)
+            if len(comments_page) == 0:
+                break
+            for comment in comments_page:
+                comment_str = str({"body": comment.body, "user": comment.user.login})
+                if total_tokens + get_tokens(comment_str) > max_tokens:
+                    break
+                comments.append(comment_str)
+                total_tokens += get_tokens(comment_str)
+            page += 1
+        add_to_dict(response_dict, "comments", str(comments))
+
+        commits: List[str] = []
+        page = 0
+        while len(commits) <= 10:
+            commits_page = pull.get_commits().get_page(page)
+            if len(commits_page) == 0:
+                break
+            for commit in commits_page:
+                commit_str = str({"message": commit.commit.message})
+                if total_tokens + get_tokens(commit_str) > max_tokens:
+                    break
+                commits.append(commit_str)
+                total_tokens += get_tokens(commit_str)
+            page += 1
+        add_to_dict(response_dict, "commits", str(commits))
+        return response_dict
+
+    def create_pull_request(self, pr_query: str) -> str:
+        """
+        Makes a pull request from the bot's branch to the base branch
+        Parameters:
+            pr_query(str): a string which contains the PR title
+            and the PR body. The title is the first line
+            in the string, and the body are the rest of the string.
+            For example, "Updated README\nmade changes to add info"
+        Returns:
+            str: A success or failure message
+        """
+        if self.github_base_branch == self.active_branch:
+            return """Cannot make a pull request because 
+            commits are already in the main or master branch."""
+        else:
+            try:
+                title = pr_query.split("\n")[0]
+                body = pr_query[len(title) + 2 :]
+                pr = self.github_repo_instance.create_pull(
+                    title=title,
+                    body=body,
+                    head=self.active_branch,
+                    base=self.github_base_branch,
+                )
+                return f"Successfully created PR number {pr.number}"
+            except Exception as e:
+                return "Unable to make pull request due to error:\n" + str(e)
+
+    def comment_on_issue(self, comment_query: str) -> str:
+        """
+        Adds a comment to a github issue
+        Parameters:
+            comment_query(str): a string which contains the issue number,
+            two newlines, and the comment.
+            for example: "1\n\nWorking on it now"
+            adds the comment "working on it now" to issue 1
+        Returns:
+            str: A success or failure message
+        """
+        issue_number = int(comment_query.split("\n\n")[0])
+        comment = comment_query[len(str(issue_number)) + 2 :]
+        try:
+            issue = self.github_repo_instance.get_issue(number=issue_number)
+            issue.create_comment(comment)
+            return "Commented on issue " + str(issue_number)
+        except Exception as e:
+            return "Unable to make comment due to error:\n" + str(e)
+
+    def create_file(self, file_query: str) -> str:
+        """
+        Creates a new file on the Github repo
+        Parameters:
+            file_query(str): a string which contains the file path
+            and the file contents. The file path is the first line
+            in the string, and the contents are the rest of the string.
+            For example, "hello_world.md\n# Hello World!"
+        Returns:
+            str: A success or failure message
+        """
+        if self.active_branch == self.github_base_branch:
+            return (
+                "You're attempting to commit to the directly to the"
+                f"{self.github_base_branch} branch, which is protected. "
+                "Please create a new branch and try again."
+            )
+
+        file_path = file_query.split("\n")[0]
+        file_contents = file_query[len(file_path) + 2 :]
+
+        try:
+            try:
+                file = self.github_repo_instance.get_contents(
+                    file_path, ref=self.active_branch
+                )
+                if file:
+                    return (
+                        f"File already exists at `{file_path}` "
+                        f"on branch `{self.active_branch}`. You must use "
+                        "`update_file` to modify it."
+                    )
+            except Exception:
+                # expected behavior, file shouldn't exist yet
+                pass
+
+            self.github_repo_instance.create_file(
+                path=file_path,
+                message="Create " + file_path,
+                content=file_contents,
+                branch=self.active_branch,
+            )
+            return "Created file " + file_path
+        except Exception as e:
+            return "Unable to make file due to error:\n" + str(e)
+
+    def read_file(self, file_path: str) -> str:
+        """
+        Read a file from this agent's branch, defined by self.active_branch,
+        which supports PR branches.
+        Parameters:
+            file_path(str): the file path
+        Returns:
+            str: The file decoded as a string, or an error message if not found
+        """
+        try:
+            file = self.github_repo_instance.get_contents(
+                file_path, ref=self.active_branch
+            )
+            return file.decoded_content.decode("utf-8")
+        except Exception as e:
+            return (
+                f"File not found `{file_path}` on branch"
+                f"`{self.active_branch}`. Error: {str(e)}"
+            )
+
+    def update_file(self, file_query: str) -> str:
+        """
+        Updates a file with new content.
+        Parameters:
+            file_query(str): Contains the file path and the file contents.
+                The old file contents is wrapped in OLD <<<< and >>>> OLD
+                The new file contents is wrapped in NEW <<<< and >>>> NEW
+                For example:
+                /test/hello.txt
+                OLD <<<<
+                Hello Earth!
+                >>>> OLD
+                NEW <<<<
+                Hello Mars!
+                >>>> NEW
+        Returns:
+            A success or failure message
+        """
+        if self.active_branch == self.github_base_branch:
+            return (
+                "You're attempting to commit to the directly"
+                f"to the {self.github_base_branch} branch, which is protected. "
+                "Please create a new branch and try again."
+            )
+        try:
+            file_path: str = file_query.split("\n")[0]
+            old_file_contents = (
+                file_query.split("OLD <<<<")[1].split(">>>> OLD")[0].strip()
+            )
+            new_file_contents = (
+                file_query.split("NEW <<<<")[1].split(">>>> NEW")[0].strip()
+            )
+
+            file_content = self.read_file(file_path)
+            updated_file_content = file_content.replace(
+                old_file_contents, new_file_contents
+            )
+
+            if file_content == updated_file_content:
+                return (
+                    "File content was not updated because old content was not found."
+                    "It may be helpful to use the read_file action to get "
+                    "the current file contents."
+                )
+
+            self.github_repo_instance.update_file(
+                path=file_path,
+                message="Update " + str(file_path),
+                content=updated_file_content,
+                branch=self.active_branch,
+                sha=self.github_repo_instance.get_contents(
+                    file_path, ref=self.active_branch
+                ).sha,
+            )
+            return "Updated file " + str(file_path)
+        except Exception as e:
+            return "Unable to update file due to error:\n" + str(e)
+
+    def delete_file(self, file_path: str) -> str:
+        """
+        Deletes a file from the repo
+        Parameters:
+            file_path(str): Where the file is
+        Returns:
+            str: Success or failure message
+        """
+        if self.active_branch == self.github_base_branch:
+            return (
+                "You're attempting to commit to the directly"
+                f"to the {self.github_base_branch} branch, which is protected. "
+                "Please create a new branch and try again."
+            )
+        try:
+            self.github_repo_instance.delete_file(
+                path=file_path,
+                message="Delete " + file_path,
+                branch=self.active_branch,
+                sha=self.github_repo_instance.get_contents(
+                    file_path, ref=self.active_branch
+                ).sha,
+            )
+            return "Deleted file " + file_path
+        except Exception as e:
+            return "Unable to delete file due to error:\n" + str(e)
+
+    def search_issues_and_prs(self, query: str) -> str:
+        """
+        Searches issues and pull requests in the repository.
+
+        Parameters:
+            query(str): The search query
+
+        Returns:
+            str: A string containing the first 5 issues and pull requests
+        """
+        search_result = self.github.search_issues(query, repo=self.github_repository)
+        max_items = min(5, search_result.totalCount)
+        results = [f"Top {max_items} results:"]
+        for issue in search_result[:max_items]:
+            results.append(
+                f"Title: {issue.title}, Number: {issue.number}, State: {issue.state}"
+            )
+        return "\n".join(results)
+
+    def search_code(self, query: str) -> str:
+        """
+        Searches code in the repository.
+        # Todo: limit total tokens returned...
+
+        Parameters:
+            query(str): The search query
+
+        Returns:
+            str: A string containing, at most, the top 5 search results
+        """
+        search_result = self.github.search_code(
+            query=query, repo=self.github_repository
+        )
+        if search_result.totalCount == 0:
+            return "0 results found."
+        max_results = min(5, search_result.totalCount)
+        results = [f"Showing top {max_results} of {search_result.totalCount} results:"]
+        count = 0
+        for code in search_result:
+            if count >= max_results:
+                break
+            # Get the file content using the PyGithub get_contents method
+            file_content = self.github_repo_instance.get_contents(
+                code.path, ref=self.active_branch
+            ).decoded_content.decode()
+            results.append(
+                f"Filepath: `{code.path}`\nFile contents: "
+                f"{file_content}\n<END OF FILE>"
+            )
+            count += 1
+        return "\n".join(results)
+
+    def create_review_request(self, reviewer_username: str) -> str:
+        """
+        Creates a review request on *THE* open pull request
+        that matches the current active_branch.
+
+        Parameters:
+            reviewer_username(str): The username of the person who is being requested
+
+        Returns:
+            str: A message confirming the creation of the review request
+        """
+        pull_requests = self.github_repo_instance.get_pulls(
+            state="open", sort="created"
+        )
+        # find PR against active_branch
+        pr = next(
+            (pr for pr in pull_requests if pr.head.ref == self.active_branch), None
+        )
+        if pr is None:
+            return (
+                "No open pull request found for the "
+                f"current branch `{self.active_branch}`"
+            )
+
+        try:
+            pr.create_review_request(reviewers=[reviewer_username])
+            return (
+                f"Review request created for user {reviewer_username} "
+                f"on PR #{pr.number}"
+            )
+        except Exception as e:
+            return f"Failed to create a review request with error {e}"
+
+    def run(self, mode: str, query: str) -> str:
+        if mode == "get_issue":
+            return json.dumps(self.get_issue(int(query)))
+        elif mode == "get_pull_request":
+            return json.dumps(self.get_pull_request(int(query)))
+        elif mode == "list_pull_request_files":
+            return json.dumps(self.list_pull_request_files(int(query)))
+        elif mode == "get_issues":
+            return self.get_issues()
+        elif mode == "comment_on_issue":
+            return self.comment_on_issue(query)
+        elif mode == "create_file":
+            return self.create_file(query)
+        elif mode == "create_pull_request":
+            return self.create_pull_request(query)
+        elif mode == "read_file":
+            return self.read_file(query)
+        elif mode == "update_file":
+            return self.update_file(query)
+        elif mode == "delete_file":
+            return self.delete_file(query)
+        elif mode == "list_open_pull_requests":
+            return self.list_open_pull_requests()
+        elif mode == "list_files_in_main_branch":
+            return self.list_files_in_main_branch()
+        elif mode == "list_files_in_bot_branch":
+            return self.list_files_in_bot_branch()
+        elif mode == "list_branches_in_repo":
+            return self.list_branches_in_repo()
+        elif mode == "set_active_branch":
+            return self.set_active_branch(query)
+        elif mode == "create_branch":
+            return self.create_branch(query)
+        elif mode == "get_files_from_directory":
+            return self.get_files_from_directory(query)
+        elif mode == "search_issues_and_prs":
+            return self.search_issues_and_prs(query)
+        elif mode == "search_code":
+            return self.search_code(query)
+        elif mode == "create_review_request":
+            return self.create_review_request(query)
+        else:
+            raise ValueError("Invalid mode" + mode)
diff --git a/llm/Lib/site-packages/langchain_community/utilities/gitlab.py b/llm/Lib/site-packages/langchain_community/utilities/gitlab.py
new file mode 100644
index 0000000000000000000000000000000000000000..d17c1b8e72a7a6615b2d558b5693e03fd865774d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/gitlab.py
@@ -0,0 +1,327 @@
+"""Util that calls gitlab."""
+from __future__ import annotations
+
+import json
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+if TYPE_CHECKING:
+    from gitlab.v4.objects import Issue
+
+
+class GitLabAPIWrapper(BaseModel):
+    """Wrapper for GitLab API."""
+
+    gitlab: Any  #: :meta private:
+    gitlab_repo_instance: Any  #: :meta private:
+    gitlab_repository: Optional[str] = None
+    """The name of the GitLab repository, in the form {username}/{repo-name}."""
+    gitlab_personal_access_token: Optional[str] = None
+    """Personal access token for the GitLab service, used for authentication."""
+    gitlab_branch: Optional[str] = None
+    """The specific branch in the GitLab repository where the bot will make 
+        its commits. Defaults to 'main'.
+    """
+    gitlab_base_branch: Optional[str] = None
+    """The base branch in the GitLab repository, used for comparisons. 
+        Usually 'main' or 'master'. Defaults to 'main'.
+    """
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+
+        gitlab_url = get_from_dict_or_env(
+            values, "gitlab_url", "GITLAB_URL", default="https://gitlab.com"
+        )
+        gitlab_repository = get_from_dict_or_env(
+            values, "gitlab_repository", "GITLAB_REPOSITORY"
+        )
+
+        gitlab_personal_access_token = get_from_dict_or_env(
+            values, "gitlab_personal_access_token", "GITLAB_PERSONAL_ACCESS_TOKEN"
+        )
+
+        gitlab_branch = get_from_dict_or_env(
+            values, "gitlab_branch", "GITLAB_BRANCH", default="main"
+        )
+        gitlab_base_branch = get_from_dict_or_env(
+            values, "gitlab_base_branch", "GITLAB_BASE_BRANCH", default="main"
+        )
+
+        try:
+            import gitlab
+
+        except ImportError:
+            raise ImportError(
+                "python-gitlab is not installed. "
+                "Please install it with `pip install python-gitlab`"
+            )
+
+        g = gitlab.Gitlab(
+            url=gitlab_url,
+            private_token=gitlab_personal_access_token,
+            keep_base_url=True,
+        )
+
+        g.auth()
+
+        values["gitlab"] = g
+        values["gitlab_repo_instance"] = g.projects.get(gitlab_repository)
+        values["gitlab_repository"] = gitlab_repository
+        values["gitlab_personal_access_token"] = gitlab_personal_access_token
+        values["gitlab_branch"] = gitlab_branch
+        values["gitlab_base_branch"] = gitlab_base_branch
+
+        return values
+
+    def parse_issues(self, issues: List[Issue]) -> List[dict]:
+        """
+        Extracts title and number from each Issue and puts them in a dictionary
+        Parameters:
+            issues(List[Issue]): A list of gitlab Issue objects
+        Returns:
+            List[dict]: A dictionary of issue titles and numbers
+        """
+        parsed = []
+        for issue in issues:
+            title = issue.title
+            number = issue.iid
+            parsed.append({"title": title, "number": number})
+        return parsed
+
+    def get_issues(self) -> str:
+        """
+        Fetches all open issues from the repo
+
+        Returns:
+            str: A plaintext report containing the number of issues
+            and each issue's title and number.
+        """
+        issues = self.gitlab_repo_instance.issues.list(state="opened")
+        if len(issues) > 0:
+            parsed_issues = self.parse_issues(issues)
+            parsed_issues_str = (
+                "Found " + str(len(parsed_issues)) + " issues:\n" + str(parsed_issues)
+            )
+            return parsed_issues_str
+        else:
+            return "No open issues available"
+
+    def get_issue(self, issue_number: int) -> Dict[str, Any]:
+        """
+        Fetches a specific issue and its first 10 comments
+        Parameters:
+            issue_number(int): The number for the gitlab issue
+        Returns:
+            dict: A dictionary containing the issue's title,
+            body, and comments as a string
+        """
+        issue = self.gitlab_repo_instance.issues.get(issue_number)
+        page = 0
+        comments: List[dict] = []
+        while len(comments) <= 10:
+            comments_page = issue.notes.list(page=page)
+            if len(comments_page) == 0:
+                break
+            for comment in comments_page:
+                comment = issue.notes.get(comment.id)
+                comments.append(
+                    {"body": comment.body, "user": comment.author["username"]}
+                )
+            page += 1
+
+        return {
+            "title": issue.title,
+            "body": issue.description,
+            "comments": str(comments),
+        }
+
+    def create_pull_request(self, pr_query: str) -> str:
+        """
+        Makes a pull request from the bot's branch to the base branch
+        Parameters:
+            pr_query(str): a string which contains the PR title
+            and the PR body. The title is the first line
+            in the string, and the body are the rest of the string.
+            For example, "Updated README\nmade changes to add info"
+        Returns:
+            str: A success or failure message
+        """
+        if self.gitlab_base_branch == self.gitlab_branch:
+            return """Cannot make a pull request because 
+            commits are already in the master branch"""
+        else:
+            try:
+                title = pr_query.split("\n")[0]
+                body = pr_query[len(title) + 2 :]
+                pr = self.gitlab_repo_instance.mergerequests.create(
+                    {
+                        "source_branch": self.gitlab_branch,
+                        "target_branch": self.gitlab_base_branch,
+                        "title": title,
+                        "description": body,
+                        "labels": ["created-by-agent"],
+                    }
+                )
+                return f"Successfully created PR number {pr.iid}"
+            except Exception as e:
+                return "Unable to make pull request due to error:\n" + str(e)
+
+    def comment_on_issue(self, comment_query: str) -> str:
+        """
+        Adds a comment to a gitlab issue
+        Parameters:
+            comment_query(str): a string which contains the issue number,
+            two newlines, and the comment.
+            for example: "1\n\nWorking on it now"
+            adds the comment "working on it now" to issue 1
+        Returns:
+            str: A success or failure message
+        """
+        issue_number = int(comment_query.split("\n\n")[0])
+        comment = comment_query[len(str(issue_number)) + 2 :]
+        try:
+            issue = self.gitlab_repo_instance.issues.get(issue_number)
+            issue.notes.create({"body": comment})
+            return "Commented on issue " + str(issue_number)
+        except Exception as e:
+            return "Unable to make comment due to error:\n" + str(e)
+
+    def create_file(self, file_query: str) -> str:
+        """
+        Creates a new file on the gitlab repo
+        Parameters:
+            file_query(str): a string which contains the file path
+            and the file contents. The file path is the first line
+            in the string, and the contents are the rest of the string.
+            For example, "hello_world.md\n# Hello World!"
+        Returns:
+            str: A success or failure message
+        """
+        file_path = file_query.split("\n")[0]
+        file_contents = file_query[len(file_path) + 2 :]
+        try:
+            self.gitlab_repo_instance.files.get(file_path, self.gitlab_branch)
+            return f"File already exists at {file_path}. Use update_file instead"
+        except Exception:
+            data = {
+                "branch": self.gitlab_branch,
+                "commit_message": "Create " + file_path,
+                "file_path": file_path,
+                "content": file_contents,
+            }
+
+            self.gitlab_repo_instance.files.create(data)
+
+            return "Created file " + file_path
+
+    def read_file(self, file_path: str) -> str:
+        """
+        Reads a file from the gitlab repo
+        Parameters:
+            file_path(str): the file path
+        Returns:
+            str: The file decoded as a string
+        """
+        file = self.gitlab_repo_instance.files.get(file_path, self.gitlab_branch)
+        return file.decode().decode("utf-8")
+
+    def update_file(self, file_query: str) -> str:
+        """
+        Updates a file with new content.
+        Parameters:
+            file_query(str): Contains the file path and the file contents.
+                The old file contents is wrapped in OLD <<<< and >>>> OLD
+                The new file contents is wrapped in NEW <<<< and >>>> NEW
+                For example:
+                test/hello.txt
+                OLD <<<<
+                Hello Earth!
+                >>>> OLD
+                NEW <<<<
+                Hello Mars!
+                >>>> NEW
+        Returns:
+            A success or failure message
+        """
+        try:
+            file_path = file_query.split("\n")[0]
+            old_file_contents = (
+                file_query.split("OLD <<<<")[1].split(">>>> OLD")[0].strip()
+            )
+            new_file_contents = (
+                file_query.split("NEW <<<<")[1].split(">>>> NEW")[0].strip()
+            )
+
+            file_content = self.read_file(file_path)
+            updated_file_content = file_content.replace(
+                old_file_contents, new_file_contents
+            )
+
+            if file_content == updated_file_content:
+                return (
+                    "File content was not updated because old content was not found."
+                    "It may be helpful to use the read_file action to get "
+                    "the current file contents."
+                )
+
+            commit = {
+                "branch": self.gitlab_branch,
+                "commit_message": "Create " + file_path,
+                "actions": [
+                    {
+                        "action": "update",
+                        "file_path": file_path,
+                        "content": updated_file_content,
+                    }
+                ],
+            }
+
+            self.gitlab_repo_instance.commits.create(commit)
+            return "Updated file " + file_path
+        except Exception as e:
+            return "Unable to update file due to error:\n" + str(e)
+
+    def delete_file(self, file_path: str) -> str:
+        """
+        Deletes a file from the repo
+        Parameters:
+            file_path(str): Where the file is
+        Returns:
+            str: Success or failure message
+        """
+        try:
+            self.gitlab_repo_instance.files.delete(
+                file_path, self.gitlab_branch, "Delete " + file_path
+            )
+            return "Deleted file " + file_path
+        except Exception as e:
+            return "Unable to delete file due to error:\n" + str(e)
+
+    def run(self, mode: str, query: str) -> str:
+        if mode == "get_issues":
+            return self.get_issues()
+        elif mode == "get_issue":
+            return json.dumps(self.get_issue(int(query)))
+        elif mode == "comment_on_issue":
+            return self.comment_on_issue(query)
+        elif mode == "create_file":
+            return self.create_file(query)
+        elif mode == "create_pull_request":
+            return self.create_pull_request(query)
+        elif mode == "read_file":
+            return self.read_file(query)
+        elif mode == "update_file":
+            return self.update_file(query)
+        elif mode == "delete_file":
+            return self.delete_file(query)
+        else:
+            raise ValueError("Invalid mode" + mode)
diff --git a/llm/Lib/site-packages/langchain_community/utilities/golden_query.py b/llm/Lib/site-packages/langchain_community/utilities/golden_query.py
new file mode 100644
index 0000000000000000000000000000000000000000..baeb3ddf96a22d963950333fca0e744a8b09a79c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/golden_query.py
@@ -0,0 +1,66 @@
+"""Util that calls Golden."""
+import json
+from typing import Dict, Optional
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+GOLDEN_BASE_URL = "https://golden.com"
+GOLDEN_TIMEOUT = 5000
+
+
+class GoldenQueryAPIWrapper(BaseModel):
+    """Wrapper for Golden.
+
+    Docs for using:
+
+    1. Go to https://golden.com and sign up for an account
+    2. Get your API Key from https://golden.com/settings/api
+    3. Save your API Key into GOLDEN_API_KEY env variable
+
+    """
+
+    golden_api_key: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        golden_api_key = get_from_dict_or_env(
+            values, "golden_api_key", "GOLDEN_API_KEY"
+        )
+        values["golden_api_key"] = golden_api_key
+
+        return values
+
+    def run(self, query: str) -> str:
+        """Run query through Golden Query API and return the JSON raw result."""
+
+        headers = {"apikey": self.golden_api_key or ""}
+
+        response = requests.post(
+            f"{GOLDEN_BASE_URL}/api/v2/public/queries/",
+            json={"prompt": query},
+            headers=headers,
+            timeout=GOLDEN_TIMEOUT,
+        )
+        if response.status_code != 201:
+            return response.text
+
+        content = json.loads(response.content)
+        query_id = content["id"]
+
+        response = requests.get(
+            (
+                f"{GOLDEN_BASE_URL}/api/v2/public/queries/{query_id}/results/"
+                "?pageSize=10"
+            ),
+            headers=headers,
+            timeout=GOLDEN_TIMEOUT,
+        )
+        return response.text
diff --git a/llm/Lib/site-packages/langchain_community/utilities/google_finance.py b/llm/Lib/site-packages/langchain_community/utilities/google_finance.py
new file mode 100644
index 0000000000000000000000000000000000000000..95e5b0c2e15528b288384ecdc39c48185c83f861
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/google_finance.py
@@ -0,0 +1,98 @@
+"""Util that calls Google Finance Search."""
+from typing import Any, Dict, Optional, cast
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+
+class GoogleFinanceAPIWrapper(BaseModel):
+    """Wrapper for SerpApi's Google Finance API
+
+    You can create SerpApi.com key by signing up at: https://serpapi.com/users/sign_up.
+    The wrapper uses the SerpApi.com python package:
+    https://serpapi.com/integrations/python
+    To use, you should have the environment variable ``SERPAPI_API_KEY``
+    set with your API key, or pass `serp_api_key` as a named parameter
+    to the constructor.
+    Example:
+        .. code-block:: python
+        from langchain_community.utilities import GoogleFinanceAPIWrapper
+        google_Finance = GoogleFinanceAPIWrapper()
+        google_Finance.run('langchain')
+    """
+
+    serp_search_engine: Any
+    serp_api_key: Optional[SecretStr] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["serp_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "serp_api_key", "SERPAPI_API_KEY")
+        )
+
+        try:
+            from serpapi import SerpApiClient
+
+        except ImportError:
+            raise ImportError(
+                "google-search-results is not installed. "
+                "Please install it with `pip install google-search-results"
+                ">=2.4.2`"
+            )
+        serp_search_engine = SerpApiClient
+        values["serp_search_engine"] = serp_search_engine
+
+        return values
+
+    def run(self, query: str) -> str:
+        """Run query through Google Finance with Serpapi"""
+        serpapi_api_key = cast(SecretStr, self.serp_api_key)
+        params = {
+            "engine": "google_finance",
+            "api_key": serpapi_api_key.get_secret_value(),
+            "q": query,
+        }
+
+        total_results = {}
+        client = self.serp_search_engine(params)
+        total_results = client.get_dict()
+
+        if not total_results:
+            return "Nothing was found from the query: " + query
+
+        markets = total_results.get("markets", {})
+        res = "\nQuery: " + query + "\n"
+
+        if "futures_chain" in total_results:
+            futures_chain = total_results.get("futures_chain", [])[0]
+            stock = futures_chain["stock"]
+            price = futures_chain["price"]
+            temp = futures_chain["price_movement"]
+            percentage = temp["percentage"]
+            movement = temp["movement"]
+            res += (
+                f"stock: {stock}\n"
+                + f"price: {price}\n"
+                + f"percentage: {percentage}\n"
+                + f"movement: {movement}\n"
+            )
+
+        else:
+            res += "No summary information\n"
+
+        for key in markets:
+            if (key == "us") or (key == "asia") or (key == "europe"):
+                res += key
+                res += ": price = "
+                res += str(markets[key][0]["price"])
+                res += ", movement = "
+                res += markets[key][0]["price_movement"]["movement"]
+                res += "\n"
+
+        return res
diff --git a/llm/Lib/site-packages/langchain_community/utilities/google_jobs.py b/llm/Lib/site-packages/langchain_community/utilities/google_jobs.py
new file mode 100644
index 0000000000000000000000000000000000000000..d532cbffd022bb344d8f4414c2fd8dfdecdd8b4e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/google_jobs.py
@@ -0,0 +1,81 @@
+"""Util that calls Google Scholar Search."""
+from typing import Any, Dict, Optional, cast
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+
+class GoogleJobsAPIWrapper(BaseModel):
+    """Wrapper for SerpApi's Google Scholar API
+
+    You can create SerpApi.com key by signing up at: https://serpapi.com/users/sign_up.
+    The wrapper uses the SerpApi.com python package:
+    https://serpapi.com/integrations/python
+    To use, you should have the environment variable ``SERPAPI_API_KEY``
+    set with your API key, or pass `serp_api_key` as a named parameter
+    to the constructor.
+     Example:
+        .. code-block:: python
+        from langchain_community.utilities import GoogleJobsAPIWrapper
+        google_Jobs = GoogleJobsAPIWrapper()
+        google_Jobs.run('langchain')
+    """
+
+    serp_search_engine: Any
+    serp_api_key: Optional[SecretStr] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["serp_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "serp_api_key", "SERPAPI_API_KEY")
+        )
+
+        try:
+            from serpapi import SerpApiClient
+
+        except ImportError:
+            raise ImportError(
+                "google-search-results is not installed. "
+                "Please install it with `pip install google-search-results"
+                ">=2.4.2`"
+            )
+        serp_search_engine = SerpApiClient
+        values["serp_search_engine"] = serp_search_engine
+
+        return values
+
+    def run(self, query: str) -> str:
+        """Run query through Google Trends with Serpapi"""
+
+        # set up query
+        serpapi_api_key = cast(SecretStr, self.serp_api_key)
+        params = {
+            "engine": "google_jobs",
+            "api_key": serpapi_api_key.get_secret_value(),
+            "q": query,
+        }
+
+        total_results = []
+        client = self.serp_search_engine(params)
+        total_results = client.get_dict()["jobs_results"]
+
+        # extract 1 job info:
+        res_str = ""
+        for i in range(1):
+            job = total_results[i]
+            res_str += (
+                "\n_______________________________________________"
+                + f"\nJob Title: {job['title']}\n"
+                + f"Company Name: {job['company_name']}\n"
+                + f"Location: {job['location']}\n"
+                + f"Description: {job['description']}"
+                + "\n_______________________________________________\n"
+            )
+
+        return res_str + "\n"
diff --git a/llm/Lib/site-packages/langchain_community/utilities/google_lens.py b/llm/Lib/site-packages/langchain_community/utilities/google_lens.py
new file mode 100644
index 0000000000000000000000000000000000000000..028c4092a5b8cea4853f5d9f3002f49cabb5d108
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/google_lens.py
@@ -0,0 +1,85 @@
+"""Util that calls Google Lens Search."""
+
+from typing import Any, Dict, Optional, cast
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+
+class GoogleLensAPIWrapper(BaseModel):
+    """Wrapper for SerpApi's Google Lens API
+
+    You can create SerpApi.com key by signing up at: https://serpapi.com/users/sign_up.
+
+    The wrapper uses the SerpApi.com python package:
+    https://serpapi.com/integrations/python
+
+    To use, you should have the environment variable ``SERPAPI_API_KEY``
+    set with your API key, or pass `serp_api_key` as a named parameter
+    to the constructor.
+
+     Example:
+        .. code-block:: python
+
+        from langchain_community.utilities import GoogleLensAPIWrapper
+        google_lens = GoogleLensAPIWrapper()
+        google_lens.run('langchain')
+    """
+
+    serp_search_engine: Any
+    serp_api_key: Optional[SecretStr] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["serp_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "serp_api_key", "SERPAPI_API_KEY")
+        )
+
+        return values
+
+    def run(self, query: str) -> str:
+        """Run query through Google Trends with Serpapi"""
+        serpapi_api_key = cast(SecretStr, self.serp_api_key)
+
+        params = {
+            "engine": "google_lens",
+            "api_key": serpapi_api_key.get_secret_value(),
+            "url": query,
+        }
+        queryURL = f"https://serpapi.com/search?engine={params['engine']}&api_key={params['api_key']}&url={params['url']}"
+        response = requests.get(queryURL)
+
+        if response.status_code != 200:
+            return "Google Lens search failed"
+
+        responseValue = response.json()
+
+        if responseValue["search_metadata"]["status"] != "Success":
+            return "Google Lens search failed"
+
+        xs = ""
+        if len(responseValue["knowledge_graph"]) > 0:
+            subject = responseValue["knowledge_graph"][0]
+            xs += f"Subject:{subject['title']}({subject['subtitle']})\n"
+            xs += f"Link to subject:{subject['link']}\n\n"
+        xs += "Related Images:\n\n"
+        for image in responseValue["visual_matches"]:
+            xs += f"Title: {image['title']}\n"
+            xs += f"Source({image['source']}): {image['link']}\n"
+            xs += f"Image: {image['thumbnail']}\n\n"
+        xs += (
+            "Reverse Image Search"
+            + f"Link: {responseValue['reverse_image_search']['link']}\n"
+        )
+        print(xs)  # noqa: T201
+
+        docs = [xs]
+
+        return "\n\n".join(docs)
diff --git a/llm/Lib/site-packages/langchain_community/utilities/google_places_api.py b/llm/Lib/site-packages/langchain_community/utilities/google_places_api.py
new file mode 100644
index 0000000000000000000000000000000000000000..330486497d403782ba36099abe63f6639f04fd3b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/google_places_api.py
@@ -0,0 +1,119 @@
+"""Chain that calls Google Places API."""
+
+import logging
+from typing import Any, Dict, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+@deprecated(
+    since="0.0.33",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.GooglePlacesAPIWrapper",
+)
+class GooglePlacesAPIWrapper(BaseModel):
+    """Wrapper around Google Places API.
+
+    To use, you should have the ``googlemaps`` python package installed,
+     **an API key for the google maps platform**,
+     and the environment variable ''GPLACES_API_KEY''
+     set with your API key , or pass 'gplaces_api_key'
+     as a named parameter to the constructor.
+
+    By default, this will return the all the results on the input query.
+     You can use the top_k_results argument to limit the number of results.
+
+    Example:
+        .. code-block:: python
+
+
+            from langchain_community.utilities import GooglePlacesAPIWrapper
+            gplaceapi = GooglePlacesAPIWrapper()
+    """
+
+    gplaces_api_key: Optional[str] = None
+    google_map_client: Any  #: :meta private:
+    top_k_results: Optional[int] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key is in your environment variable."""
+        gplaces_api_key = get_from_dict_or_env(
+            values, "gplaces_api_key", "GPLACES_API_KEY"
+        )
+        values["gplaces_api_key"] = gplaces_api_key
+        try:
+            import googlemaps
+
+            values["google_map_client"] = googlemaps.Client(gplaces_api_key)
+        except ImportError:
+            raise ImportError(
+                "Could not import googlemaps python package. "
+                "Please install it with `pip install googlemaps`."
+            )
+        return values
+
+    def run(self, query: str) -> str:
+        """Run Places search and get k number of places that exists that match."""
+        search_results = self.google_map_client.places(query)["results"]
+        num_to_return = len(search_results)
+
+        places = []
+
+        if num_to_return == 0:
+            return "Google Places did not find any places that match the description"
+
+        num_to_return = (
+            num_to_return
+            if self.top_k_results is None
+            else min(num_to_return, self.top_k_results)
+        )
+
+        for i in range(num_to_return):
+            result = search_results[i]
+            details = self.fetch_place_details(result["place_id"])
+
+            if details is not None:
+                places.append(details)
+
+        return "\n".join([f"{i+1}. {item}" for i, item in enumerate(places)])
+
+    def fetch_place_details(self, place_id: str) -> Optional[str]:
+        try:
+            place_details = self.google_map_client.place(place_id)
+            place_details["place_id"] = place_id
+            formatted_details = self.format_place_details(place_details)
+            return formatted_details
+        except Exception as e:
+            logging.error(f"An Error occurred while fetching place details: {e}")
+            return None
+
+    def format_place_details(self, place_details: Dict[str, Any]) -> Optional[str]:
+        try:
+            name = place_details.get("result", {}).get("name", "Unknown")
+            address = place_details.get("result", {}).get(
+                "formatted_address", "Unknown"
+            )
+            phone_number = place_details.get("result", {}).get(
+                "formatted_phone_number", "Unknown"
+            )
+            website = place_details.get("result", {}).get("website", "Unknown")
+            place_id = place_details.get("result", {}).get("place_id", "Unknown")
+
+            formatted_details = (
+                f"{name}\nAddress: {address}\n"
+                f"Google place ID: {place_id}\n"
+                f"Phone: {phone_number}\nWebsite: {website}\n\n"
+            )
+            return formatted_details
+        except Exception as e:
+            logging.error(f"An error occurred while formatting place details: {e}")
+            return None
diff --git a/llm/Lib/site-packages/langchain_community/utilities/google_scholar.py b/llm/Lib/site-packages/langchain_community/utilities/google_scholar.py
new file mode 100644
index 0000000000000000000000000000000000000000..49b2677d7f7636f95b947fd6a27b3357df776eaa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/google_scholar.py
@@ -0,0 +1,129 @@
+"""Util that calls Google Scholar Search."""
+from typing import Dict, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class GoogleScholarAPIWrapper(BaseModel):
+    """Wrapper for Google Scholar API
+
+    You can create serpapi key by signing up at: https://serpapi.com/users/sign_up.
+
+    The wrapper uses the serpapi python package:
+    https://serpapi.com/integrations/python#search-google-scholar
+
+    To use, you should have the environment variable ``SERP_API_KEY``
+    set with your API key, or pass `serp_api_key` as a named parameter
+    to the constructor.
+
+    Attributes:
+        top_k_results: number of results to return from google-scholar query search.
+            By default it returns top 10 results.
+        hl: attribute defines the language to use for the Google Scholar search.
+            It's a two-letter language code.
+            (e.g., en for English, es for Spanish, or fr for French). Head to the
+            Google languages page for a full list of supported Google languages:
+            https://serpapi.com/google-languages
+
+        lr: attribute defines one or multiple languages to limit the search to.
+            It uses lang_{two-letter language code} to specify languages
+            and | as a delimiter. (e.g., lang_fr|lang_de will only search French
+            and German pages). Head to the Google lr languages for a full
+            list of supported languages: https://serpapi.com/google-lr-languages
+
+     Example:
+        .. code-block:: python
+
+        from langchain_community.utilities import GoogleScholarAPIWrapper
+        google_scholar = GoogleScholarAPIWrapper()
+        google_scholar.run('langchain')
+    """
+
+    top_k_results: int = 10
+    hl: str = "en"
+    lr: str = "lang_en"
+    serp_api_key: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        serp_api_key = get_from_dict_or_env(values, "serp_api_key", "SERP_API_KEY")
+        values["SERP_API_KEY"] = serp_api_key
+
+        try:
+            from serpapi import GoogleScholarSearch
+
+        except ImportError:
+            raise ImportError(
+                "google-search-results is not installed. "
+                "Please install it with `pip install google-search-results"
+                ">=2.4.2`"
+            )
+        GoogleScholarSearch.SERP_API_KEY = serp_api_key
+        values["google_scholar_engine"] = GoogleScholarSearch
+
+        return values
+
+    def run(self, query: str) -> str:
+        """Run query through GoogleSearchScholar and parse result"""
+        total_results = []
+        page = 0
+        while page < max((self.top_k_results - 20), 1):
+            # We are getting 20 results from every page
+            # which is the max in order to reduce the number of API CALLS.
+            # 0 is the first page of results, 20 is the 2nd page of results,
+            # 40 is the 3rd page of results, etc.
+            results = (
+                self.google_scholar_engine(  # type: ignore
+                    {
+                        "q": query,
+                        "start": page,
+                        "hl": self.hl,
+                        "num": min(
+                            self.top_k_results, 20
+                        ),  # if top_k_result is less than 20.
+                        "lr": self.lr,
+                    }
+                )
+                .get_dict()
+                .get("organic_results", [])
+            )
+            total_results.extend(results)
+            if not results:  # No need to search for more pages if current page
+                # has returned no results
+                break
+            page += 20
+        if (
+            self.top_k_results % 20 != 0 and page > 20 and total_results
+        ):  # From the last page we would only need top_k_results%20 results
+            # if k is not divisible by 20.
+            results = (
+                self.google_scholar_engine(  # type: ignore
+                    {
+                        "q": query,
+                        "start": page,
+                        "num": self.top_k_results % 20,
+                        "hl": self.hl,
+                        "lr": self.lr,
+                    }
+                )
+                .get_dict()
+                .get("organic_results", [])
+            )
+            total_results.extend(results)
+        if not total_results:
+            return "No good Google Scholar Result was found"
+        docs = [
+            f"Title: {result.get('title','')}\n"
+            f"Authors: {','.join([author.get('name') for author in result.get('publication_info',{}).get('authors',[])])}\n"  # noqa: E501
+            f"Summary: {result.get('publication_info',{}).get('summary','')}\n"
+            f"Total-Citations: {result.get('inline_links',{}).get('cited_by',{}).get('total','')}"  # noqa: E501
+            for result in total_results
+        ]
+        return "\n\n".join(docs)
diff --git a/llm/Lib/site-packages/langchain_community/utilities/google_search.py b/llm/Lib/site-packages/langchain_community/utilities/google_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..7a6747060d25cb25a06038a4d69fdebf4717e8b9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/google_search.py
@@ -0,0 +1,144 @@
+"""Util that calls Google Search."""
+
+from typing import Any, Dict, List, Optional
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+@deprecated(
+    since="0.0.33",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.GoogleSearchAPIWrapper",
+)
+class GoogleSearchAPIWrapper(BaseModel):
+    """Wrapper for Google Search API.
+
+    Adapted from: Instructions adapted from https://stackoverflow.com/questions/
+    37083058/
+    programmatically-searching-google-in-python-using-custom-search
+
+    TODO: DOCS for using it
+    1. Install google-api-python-client
+    - If you don't already have a Google account, sign up.
+    - If you have never created a Google APIs Console project,
+    read the Managing Projects page and create a project in the Google API Console.
+    - Install the library using pip install google-api-python-client
+
+    2. Enable the Custom Search API
+    - Navigate to the APIs & Services→Dashboard panel in Cloud Console.
+    - Click Enable APIs and Services.
+    - Search for Custom Search API and click on it.
+    - Click Enable.
+    URL for it: https://console.cloud.google.com/apis/library/customsearch.googleapis
+    .com
+
+    3. To create an API key:
+    - Navigate to the APIs & Services → Credentials panel in Cloud Console.
+    - Select Create credentials, then select API key from the drop-down menu.
+    - The API key created dialog box displays your newly created key.
+    - You now have an API_KEY
+
+    Alternatively, you can just generate an API key here:
+    https://developers.google.com/custom-search/docs/paid_element#api_key
+
+    4. Setup Custom Search Engine so you can search the entire web
+    - Create a custom search engine here: https://programmablesearchengine.google.com/.
+    - In `What to search` to search, pick the `Search the entire Web` option.
+    After search engine is created, you can click on it and find `Search engine ID`
+      on the Overview page.
+
+    """
+
+    search_engine: Any  #: :meta private:
+    google_api_key: Optional[str] = None
+    google_cse_id: Optional[str] = None
+    k: int = 10
+    siterestrict: bool = False
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def _google_search_results(self, search_term: str, **kwargs: Any) -> List[dict]:
+        cse = self.search_engine.cse()
+        if self.siterestrict:
+            cse = cse.siterestrict()
+        res = cse.list(q=search_term, cx=self.google_cse_id, **kwargs).execute()
+        return res.get("items", [])
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        google_api_key = get_from_dict_or_env(
+            values, "google_api_key", "GOOGLE_API_KEY"
+        )
+        values["google_api_key"] = google_api_key
+
+        google_cse_id = get_from_dict_or_env(values, "google_cse_id", "GOOGLE_CSE_ID")
+        values["google_cse_id"] = google_cse_id
+
+        try:
+            from googleapiclient.discovery import build
+
+        except ImportError:
+            raise ImportError(
+                "google-api-python-client is not installed. "
+                "Please install it with `pip install google-api-python-client"
+                ">=2.100.0`"
+            )
+
+        service = build("customsearch", "v1", developerKey=google_api_key)
+        values["search_engine"] = service
+
+        return values
+
+    def run(self, query: str) -> str:
+        """Run query through GoogleSearch and parse result."""
+        snippets = []
+        results = self._google_search_results(query, num=self.k)
+        if len(results) == 0:
+            return "No good Google Search Result was found"
+        for result in results:
+            if "snippet" in result:
+                snippets.append(result["snippet"])
+
+        return " ".join(snippets)
+
+    def results(
+        self,
+        query: str,
+        num_results: int,
+        search_params: Optional[Dict[str, str]] = None,
+    ) -> List[Dict]:
+        """Run query through GoogleSearch and return metadata.
+
+        Args:
+            query: The query to search for.
+            num_results: The number of results to return.
+            search_params: Parameters to be passed on search
+
+        Returns:
+            A list of dictionaries with the following keys:
+                snippet - The description of the result.
+                title - The title of the result.
+                link - The link to the result.
+        """
+        metadata_results = []
+        results = self._google_search_results(
+            query, num=num_results, **(search_params or {})
+        )
+        if len(results) == 0:
+            return [{"Result": "No good Google Search Result was found"}]
+        for result in results:
+            metadata_result = {
+                "title": result["title"],
+                "link": result["link"],
+            }
+            if "snippet" in result:
+                metadata_result["snippet"] = result["snippet"]
+            metadata_results.append(metadata_result)
+
+        return metadata_results
diff --git a/llm/Lib/site-packages/langchain_community/utilities/google_serper.py b/llm/Lib/site-packages/langchain_community/utilities/google_serper.py
new file mode 100644
index 0000000000000000000000000000000000000000..6701b56e5846b79caf62d25fc04985f32614213f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/google_serper.py
@@ -0,0 +1,192 @@
+"""Util that calls Google Search using the Serper.dev API."""
+from typing import Any, Dict, List, Optional
+
+import aiohttp
+import requests
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.utils import get_from_dict_or_env
+from typing_extensions import Literal
+
+
+class GoogleSerperAPIWrapper(BaseModel):
+    """Wrapper around the Serper.dev Google Search API.
+
+    You can create a free API key at https://serper.dev.
+
+    To use, you should have the environment variable ``SERPER_API_KEY``
+    set with your API key, or pass `serper_api_key` as a named parameter
+    to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.utilities import GoogleSerperAPIWrapper
+            google_serper = GoogleSerperAPIWrapper()
+    """
+
+    k: int = 10
+    gl: str = "us"
+    hl: str = "en"
+    # "places" and "images" is available from Serper but not implemented in the
+    # parser of run(). They can be used in results()
+    type: Literal["news", "search", "places", "images"] = "search"
+    result_key_for_type = {
+        "news": "news",
+        "places": "places",
+        "images": "images",
+        "search": "organic",
+    }
+
+    tbs: Optional[str] = None
+    serper_api_key: Optional[str] = None
+    aiosession: Optional[aiohttp.ClientSession] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        serper_api_key = get_from_dict_or_env(
+            values, "serper_api_key", "SERPER_API_KEY"
+        )
+        values["serper_api_key"] = serper_api_key
+
+        return values
+
+    def results(self, query: str, **kwargs: Any) -> Dict:
+        """Run query through GoogleSearch."""
+        return self._google_serper_api_results(
+            query,
+            gl=self.gl,
+            hl=self.hl,
+            num=self.k,
+            tbs=self.tbs,
+            search_type=self.type,
+            **kwargs,
+        )
+
+    def run(self, query: str, **kwargs: Any) -> str:
+        """Run query through GoogleSearch and parse result."""
+        results = self._google_serper_api_results(
+            query,
+            gl=self.gl,
+            hl=self.hl,
+            num=self.k,
+            tbs=self.tbs,
+            search_type=self.type,
+            **kwargs,
+        )
+
+        return self._parse_results(results)
+
+    async def aresults(self, query: str, **kwargs: Any) -> Dict:
+        """Run query through GoogleSearch."""
+        results = await self._async_google_serper_search_results(
+            query,
+            gl=self.gl,
+            hl=self.hl,
+            num=self.k,
+            search_type=self.type,
+            tbs=self.tbs,
+            **kwargs,
+        )
+        return results
+
+    async def arun(self, query: str, **kwargs: Any) -> str:
+        """Run query through GoogleSearch and parse result async."""
+        results = await self._async_google_serper_search_results(
+            query,
+            gl=self.gl,
+            hl=self.hl,
+            num=self.k,
+            search_type=self.type,
+            tbs=self.tbs,
+            **kwargs,
+        )
+
+        return self._parse_results(results)
+
+    def _parse_snippets(self, results: dict) -> List[str]:
+        snippets = []
+
+        if results.get("answerBox"):
+            answer_box = results.get("answerBox", {})
+            if answer_box.get("answer"):
+                return [answer_box.get("answer")]
+            elif answer_box.get("snippet"):
+                return [answer_box.get("snippet").replace("\n", " ")]
+            elif answer_box.get("snippetHighlighted"):
+                return answer_box.get("snippetHighlighted")
+
+        if results.get("knowledgeGraph"):
+            kg = results.get("knowledgeGraph", {})
+            title = kg.get("title")
+            entity_type = kg.get("type")
+            if entity_type:
+                snippets.append(f"{title}: {entity_type}.")
+            description = kg.get("description")
+            if description:
+                snippets.append(description)
+            for attribute, value in kg.get("attributes", {}).items():
+                snippets.append(f"{title} {attribute}: {value}.")
+
+        for result in results[self.result_key_for_type[self.type]][: self.k]:
+            if "snippet" in result:
+                snippets.append(result["snippet"])
+            for attribute, value in result.get("attributes", {}).items():
+                snippets.append(f"{attribute}: {value}.")
+
+        if len(snippets) == 0:
+            return ["No good Google Search Result was found"]
+        return snippets
+
+    def _parse_results(self, results: dict) -> str:
+        return " ".join(self._parse_snippets(results))
+
+    def _google_serper_api_results(
+        self, search_term: str, search_type: str = "search", **kwargs: Any
+    ) -> dict:
+        headers = {
+            "X-API-KEY": self.serper_api_key or "",
+            "Content-Type": "application/json",
+        }
+        params = {
+            "q": search_term,
+            **{key: value for key, value in kwargs.items() if value is not None},
+        }
+        response = requests.post(
+            f"https://google.serper.dev/{search_type}", headers=headers, params=params
+        )
+        response.raise_for_status()
+        search_results = response.json()
+        return search_results
+
+    async def _async_google_serper_search_results(
+        self, search_term: str, search_type: str = "search", **kwargs: Any
+    ) -> dict:
+        headers = {
+            "X-API-KEY": self.serper_api_key or "",
+            "Content-Type": "application/json",
+        }
+        url = f"https://google.serper.dev/{search_type}"
+        params = {
+            "q": search_term,
+            **{key: value for key, value in kwargs.items() if value is not None},
+        }
+
+        if not self.aiosession:
+            async with aiohttp.ClientSession() as session:
+                async with session.post(
+                    url, params=params, headers=headers, raise_for_status=False
+                ) as response:
+                    search_results = await response.json()
+        else:
+            async with self.aiosession.post(
+                url, params=params, headers=headers, raise_for_status=True
+            ) as response:
+                search_results = await response.json()
+
+        return search_results
diff --git a/llm/Lib/site-packages/langchain_community/utilities/google_trends.py b/llm/Lib/site-packages/langchain_community/utilities/google_trends.py
new file mode 100644
index 0000000000000000000000000000000000000000..59df34485606fc863da5df15369c88625c443898
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/google_trends.py
@@ -0,0 +1,121 @@
+"""Util that calls Google Scholar Search."""
+from typing import Any, Dict, Optional, cast
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, SecretStr, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+
+
+class GoogleTrendsAPIWrapper(BaseModel):
+    """Wrapper for SerpApi's Google Scholar API
+
+    You can create SerpApi.com key by signing up at: https://serpapi.com/users/sign_up.
+
+    The wrapper uses the SerpApi.com python package:
+    https://serpapi.com/integrations/python
+
+    To use, you should have the environment variable ``SERPAPI_API_KEY``
+    set with your API key, or pass `serp_api_key` as a named parameter
+    to the constructor.
+
+     Example:
+        .. code-block:: python
+
+        from langchain_community.utilities import GoogleTrendsAPIWrapper
+        google_trends = GoogleTrendsAPIWrapper()
+        google_trends.run('langchain')
+    """
+
+    serp_search_engine: Any
+    serp_api_key: Optional[SecretStr] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        values["serp_api_key"] = convert_to_secret_str(
+            get_from_dict_or_env(values, "serp_api_key", "SERPAPI_API_KEY")
+        )
+
+        try:
+            from serpapi import SerpApiClient
+
+        except ImportError:
+            raise ImportError(
+                "google-search-results is not installed. "
+                "Please install it with `pip install google-search-results"
+                ">=2.4.2`"
+            )
+        serp_search_engine = SerpApiClient
+        values["serp_search_engine"] = serp_search_engine
+
+        return values
+
+    def run(self, query: str) -> str:
+        """Run query through Google Trends with Serpapi"""
+        serpapi_api_key = cast(SecretStr, self.serp_api_key)
+        params = {
+            "engine": "google_trends",
+            "api_key": serpapi_api_key.get_secret_value(),
+            "q": query,
+        }
+
+        total_results = []
+        client = self.serp_search_engine(params)
+        client_dict = client.get_dict()
+        total_results = (
+            client_dict["interest_over_time"]["timeline_data"]
+            if "interest_over_time" in client_dict
+            else None
+        )
+
+        if not total_results:
+            return "No good Trend Result was found"
+
+        start_date = total_results[0]["date"].split()
+        end_date = total_results[-1]["date"].split()
+        values = [
+            results.get("values")[0].get("extracted_value") for results in total_results
+        ]
+        min_value = min(values)
+        max_value = max(values)
+        avg_value = sum(values) / len(values)
+        percentage_change = (
+            (values[-1] - values[0])
+            / (values[0] if values[0] != 0 else 1)
+            * (100 if values[0] != 0 else 1)
+        )
+
+        params = {
+            "engine": "google_trends",
+            "api_key": serpapi_api_key.get_secret_value(),
+            "data_type": "RELATED_QUERIES",
+            "q": query,
+        }
+
+        total_results2 = {}
+        client = self.serp_search_engine(params)
+        total_results2 = client.get_dict().get("related_queries", {})
+        rising = []
+        top = []
+
+        rising = [results.get("query") for results in total_results2.get("rising", [])]
+        top = [results.get("query") for results in total_results2.get("top", [])]
+
+        doc = [
+            f"Query: {query}\n"
+            f"Date From: {start_date[0]} {start_date[1]}, {start_date[-1]}\n"
+            f"Date To: {end_date[0]} {end_date[3]} {end_date[-1]}\n"
+            f"Min Value: {min_value}\n"
+            f"Max Value: {max_value}\n"
+            f"Average Value: {avg_value}\n"
+            f"Percent Change: {str(percentage_change) + '%'}\n"
+            f"Trend values: {', '.join([str(x) for x in values])}\n"
+            f"Rising Related Queries: {', '.join(rising)}\n"
+            f"Top Related Queries: {', '.join(top)}"
+        ]
+
+        return "\n\n".join(doc)
diff --git a/llm/Lib/site-packages/langchain_community/utilities/graphql.py b/llm/Lib/site-packages/langchain_community/utilities/graphql.py
new file mode 100644
index 0000000000000000000000000000000000000000..0478aef78e85af9f93736246b5929f8df71aeaea
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/graphql.py
@@ -0,0 +1,58 @@
+import json
+from typing import Any, Callable, Dict, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+
+class GraphQLAPIWrapper(BaseModel):
+    """Wrapper around GraphQL API.
+
+    To use, you should have the ``gql`` python package installed.
+    This wrapper will use the GraphQL API to conduct queries.
+    """
+
+    custom_headers: Optional[Dict[str, str]] = None
+    fetch_schema_from_transport: Optional[bool] = None
+    graphql_endpoint: str
+    gql_client: Any  #: :meta private:
+    gql_function: Callable[[str], Any]  #: :meta private:
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in the environment."""
+        try:
+            from gql import Client, gql
+            from gql.transport.requests import RequestsHTTPTransport
+        except ImportError as e:
+            raise ImportError(
+                "Could not import gql python package. "
+                f"Try installing it with `pip install gql`. Received error: {e}"
+            )
+        headers = values.get("custom_headers")
+        transport = RequestsHTTPTransport(
+            url=values["graphql_endpoint"],
+            headers=headers,
+        )
+        fetch_schema_from_transport = values.get("fetch_schema_from_transport", True)
+        client = Client(
+            transport=transport, fetch_schema_from_transport=fetch_schema_from_transport
+        )
+        values["gql_client"] = client
+        values["gql_function"] = gql
+        return values
+
+    def run(self, query: str) -> str:
+        """Run a GraphQL query and get the results."""
+        result = self._execute_query(query)
+        return json.dumps(result, indent=2)
+
+    def _execute_query(self, query: str) -> Dict[str, Any]:
+        """Execute a GraphQL query and return the results."""
+        document_node = self.gql_function(query)
+        result = self.gql_client.execute(document_node)
+        return result
diff --git a/llm/Lib/site-packages/langchain_community/utilities/infobip.py b/llm/Lib/site-packages/langchain_community/utilities/infobip.py
new file mode 100644
index 0000000000000000000000000000000000000000..83775e0fc94116bdcc1bd37d80c72aa709713641
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/infobip.py
@@ -0,0 +1,185 @@
+"""Util that sends messages via Infobip."""
+from typing import Dict, List, Optional
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+from requests.adapters import HTTPAdapter
+from urllib3.util import Retry
+
+
+class InfobipAPIWrapper(BaseModel):
+    """Wrapper for Infobip API for messaging."""
+
+    infobip_api_key: Optional[str] = None
+    infobip_base_url: Optional[str] = "https://api.infobip.com"
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        values["infobip_api_key"] = get_from_dict_or_env(
+            values, "infobip_api_key", "INFOBIP_API_KEY"
+        )
+        values["infobip_base_url"] = get_from_dict_or_env(
+            values, "infobip_base_url", "INFOBIP_BASE_URL"
+        )
+        return values
+
+    def _get_requests_session(self) -> requests.Session:
+        """Get a requests session with the correct headers."""
+        retry_strategy: Retry = Retry(
+            total=4,  # Maximum number of retries
+            backoff_factor=2,  # Exponential backoff factor
+            status_forcelist=[429, 500, 502, 503, 504],  # HTTP status codes to retry on
+        )
+        adapter: HTTPAdapter = HTTPAdapter(max_retries=retry_strategy)
+
+        session = requests.Session()
+        session.mount("https://", adapter)
+        session.headers.update(
+            {
+                "Authorization": f"App {self.infobip_api_key}",
+                "User-Agent": "infobip-langchain-community",
+            }
+        )
+        return session
+
+    def _send_sms(
+        self, sender: str, destination_phone_numbers: List[str], text: str
+    ) -> str:
+        """Send an SMS message."""
+        json: Dict = {
+            "messages": [
+                {
+                    "destinations": [
+                        {"to": destination} for destination in destination_phone_numbers
+                    ],
+                    "from": sender,
+                    "text": text,
+                }
+            ]
+        }
+
+        session: requests.Session = self._get_requests_session()
+        session.headers.update(
+            {
+                "Content-Type": "application/json",
+            }
+        )
+
+        response: requests.Response = session.post(
+            f"{self.infobip_base_url}/sms/2/text/advanced",
+            json=json,
+        )
+
+        response_json: Dict = response.json()
+        try:
+            if response.status_code != 200:
+                return response_json["requestError"]["serviceException"]["text"]
+        except KeyError:
+            return "Failed to send message"
+
+        try:
+            return response_json["messages"][0]["messageId"]
+        except KeyError:
+            return (
+                "Could not get message ID from response, message was sent successfully"
+            )
+
+    def _send_email(
+        self, from_email: str, to_email: str, subject: str, body: str
+    ) -> str:
+        """Send an email message."""
+
+        try:
+            from requests_toolbelt import MultipartEncoder
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import requests_toolbelt, please install it with "
+                "`pip install -U requests-toolbelt`."
+            ) from e
+        form_data: Dict = {
+            "from": from_email,
+            "to": to_email,
+            "subject": subject,
+            "text": body,
+        }
+
+        data = MultipartEncoder(fields=form_data)
+
+        session: requests.Session = self._get_requests_session()
+        session.headers.update(
+            {
+                "Content-Type": data.content_type,
+            }
+        )
+
+        response: requests.Response = session.post(
+            f"{self.infobip_base_url}/email/3/send",
+            data=data,
+        )
+
+        response_json: Dict = response.json()
+
+        try:
+            if response.status_code != 200:
+                return response_json["requestError"]["serviceException"]["text"]
+        except KeyError:
+            return "Failed to send message"
+
+        try:
+            return response_json["messages"][0]["messageId"]
+        except KeyError:
+            return (
+                "Could not get message ID from response, message was sent successfully"
+            )
+
+    def run(
+        self,
+        body: str = "",
+        to: str = "",
+        sender: str = "",
+        subject: str = "",
+        channel: str = "sms",
+    ) -> str:
+        if channel == "sms":
+            if sender == "":
+                raise ValueError("Sender must be specified for SMS messages")
+
+            if to == "":
+                raise ValueError("Destination must be specified for SMS messages")
+
+            if body == "":
+                raise ValueError("Body must be specified for SMS messages")
+
+            return self._send_sms(
+                sender=sender,
+                destination_phone_numbers=[to],
+                text=body,
+            )
+        elif channel == "email":
+            if sender == "":
+                raise ValueError("Sender must be specified for email messages")
+
+            if to == "":
+                raise ValueError("Destination must be specified for email messages")
+
+            if subject == "":
+                raise ValueError("Subject must be specified for email messages")
+
+            if body == "":
+                raise ValueError("Body must be specified for email messages")
+
+            return self._send_email(
+                from_email=sender,
+                to_email=to,
+                subject=subject,
+                body=body,
+            )
+        else:
+            raise ValueError(f"Channel {channel} is not supported")
diff --git a/llm/Lib/site-packages/langchain_community/utilities/jira.py b/llm/Lib/site-packages/langchain_community/utilities/jira.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d6522d7fd9d96c1fca4b8ba57bc5b71ba5b956a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/jira.py
@@ -0,0 +1,174 @@
+"""Util that calls Jira."""
+from typing import Any, Dict, List, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+# TODO: think about error handling, more specific api specs, and jql/project limits
+class JiraAPIWrapper(BaseModel):
+    """Wrapper for Jira API."""
+
+    jira: Any  #: :meta private:
+    confluence: Any
+    jira_username: Optional[str] = None
+    jira_api_token: Optional[str] = None
+    jira_instance_url: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        jira_username = get_from_dict_or_env(values, "jira_username", "JIRA_USERNAME")
+        values["jira_username"] = jira_username
+
+        jira_api_token = get_from_dict_or_env(
+            values, "jira_api_token", "JIRA_API_TOKEN"
+        )
+        values["jira_api_token"] = jira_api_token
+
+        jira_instance_url = get_from_dict_or_env(
+            values, "jira_instance_url", "JIRA_INSTANCE_URL"
+        )
+        values["jira_instance_url"] = jira_instance_url
+
+        try:
+            from atlassian import Confluence, Jira
+        except ImportError:
+            raise ImportError(
+                "atlassian-python-api is not installed. "
+                "Please install it with `pip install atlassian-python-api`"
+            )
+
+        jira = Jira(
+            url=jira_instance_url,
+            username=jira_username,
+            password=jira_api_token,
+            cloud=True,
+        )
+
+        confluence = Confluence(
+            url=jira_instance_url,
+            username=jira_username,
+            password=jira_api_token,
+            cloud=True,
+        )
+
+        values["jira"] = jira
+        values["confluence"] = confluence
+
+        return values
+
+    def parse_issues(self, issues: Dict) -> List[dict]:
+        parsed = []
+        for issue in issues["issues"]:
+            key = issue["key"]
+            summary = issue["fields"]["summary"]
+            created = issue["fields"]["created"][0:10]
+            priority = issue["fields"]["priority"]["name"]
+            status = issue["fields"]["status"]["name"]
+            try:
+                assignee = issue["fields"]["assignee"]["displayName"]
+            except Exception:
+                assignee = "None"
+            rel_issues = {}
+            for related_issue in issue["fields"]["issuelinks"]:
+                if "inwardIssue" in related_issue.keys():
+                    rel_type = related_issue["type"]["inward"]
+                    rel_key = related_issue["inwardIssue"]["key"]
+                    rel_summary = related_issue["inwardIssue"]["fields"]["summary"]
+                if "outwardIssue" in related_issue.keys():
+                    rel_type = related_issue["type"]["outward"]
+                    rel_key = related_issue["outwardIssue"]["key"]
+                    rel_summary = related_issue["outwardIssue"]["fields"]["summary"]
+                rel_issues = {"type": rel_type, "key": rel_key, "summary": rel_summary}
+            parsed.append(
+                {
+                    "key": key,
+                    "summary": summary,
+                    "created": created,
+                    "assignee": assignee,
+                    "priority": priority,
+                    "status": status,
+                    "related_issues": rel_issues,
+                }
+            )
+        return parsed
+
+    def parse_projects(self, projects: List[dict]) -> List[dict]:
+        parsed = []
+        for project in projects:
+            id = project["id"]
+            key = project["key"]
+            name = project["name"]
+            type = project["projectTypeKey"]
+            style = project["style"]
+            parsed.append(
+                {"id": id, "key": key, "name": name, "type": type, "style": style}
+            )
+        return parsed
+
+    def search(self, query: str) -> str:
+        issues = self.jira.jql(query)
+        parsed_issues = self.parse_issues(issues)
+        parsed_issues_str = (
+            "Found " + str(len(parsed_issues)) + " issues:\n" + str(parsed_issues)
+        )
+        return parsed_issues_str
+
+    def project(self) -> str:
+        projects = self.jira.projects()
+        parsed_projects = self.parse_projects(projects)
+        parsed_projects_str = (
+            "Found " + str(len(parsed_projects)) + " projects:\n" + str(parsed_projects)
+        )
+        return parsed_projects_str
+
+    def issue_create(self, query: str) -> str:
+        try:
+            import json
+        except ImportError:
+            raise ImportError(
+                "json is not installed. Please install it with `pip install json`"
+            )
+        params = json.loads(query)
+        return self.jira.issue_create(fields=dict(params))
+
+    def page_create(self, query: str) -> str:
+        try:
+            import json
+        except ImportError:
+            raise ImportError(
+                "json is not installed. Please install it with `pip install json`"
+            )
+        params = json.loads(query)
+        return self.confluence.create_page(**dict(params))
+
+    def other(self, query: str) -> str:
+        try:
+            import json
+        except ImportError:
+            raise ImportError(
+                "json is not installed. Please install it with `pip install json`"
+            )
+        params = json.loads(query)
+        jira_function = getattr(self.jira, params["function"])
+        return jira_function(*params.get("args", []), **params.get("kwargs", {}))
+
+    def run(self, mode: str, query: str) -> str:
+        if mode == "jql":
+            return self.search(query)
+        elif mode == "get_projects":
+            return self.project()
+        elif mode == "create_issue":
+            return self.issue_create(query)
+        elif mode == "other":
+            return self.other(query)
+        elif mode == "create_page":
+            return self.page_create(query)
+        else:
+            raise ValueError(f"Got unexpected mode {mode}")
diff --git a/llm/Lib/site-packages/langchain_community/utilities/max_compute.py b/llm/Lib/site-packages/langchain_community/utilities/max_compute.py
new file mode 100644
index 0000000000000000000000000000000000000000..3f6441803e021ebde2fd213ad0fc63120163f616
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/max_compute.py
@@ -0,0 +1,76 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Iterator, List, Optional
+
+from langchain_core.utils import get_from_env
+
+if TYPE_CHECKING:
+    from odps import ODPS
+
+
+class MaxComputeAPIWrapper:
+    """Interface for querying Alibaba Cloud MaxCompute tables."""
+
+    def __init__(self, client: ODPS):
+        """Initialize MaxCompute document loader.
+
+        Args:
+            client: odps.ODPS MaxCompute client object.
+        """
+        self.client = client
+
+    @classmethod
+    def from_params(
+        cls,
+        endpoint: str,
+        project: str,
+        *,
+        access_id: Optional[str] = None,
+        secret_access_key: Optional[str] = None,
+    ) -> MaxComputeAPIWrapper:
+        """Convenience constructor that builds the odsp.ODPS MaxCompute client from
+            given parameters.
+
+        Args:
+            endpoint: MaxCompute endpoint.
+            project: A project is a basic organizational unit of MaxCompute, which is
+                similar to a database.
+            access_id: MaxCompute access ID. Should be passed in directly or set as the
+                environment variable `MAX_COMPUTE_ACCESS_ID`.
+            secret_access_key: MaxCompute secret access key. Should be passed in
+                directly or set as the environment variable
+                `MAX_COMPUTE_SECRET_ACCESS_KEY`.
+        """
+        try:
+            from odps import ODPS
+        except ImportError as ex:
+            raise ImportError(
+                "Could not import pyodps python package. "
+                "Please install it with `pip install pyodps` or refer to "
+                "https://pyodps.readthedocs.io/."
+            ) from ex
+        access_id = access_id or get_from_env("access_id", "MAX_COMPUTE_ACCESS_ID")
+        secret_access_key = secret_access_key or get_from_env(
+            "secret_access_key", "MAX_COMPUTE_SECRET_ACCESS_KEY"
+        )
+        client = ODPS(
+            access_id=access_id,
+            secret_access_key=secret_access_key,
+            project=project,
+            endpoint=endpoint,
+        )
+        if not client.exist_project(project):
+            raise ValueError(f'The project "{project}" does not exist.')
+
+        return cls(client)
+
+    def lazy_query(self, query: str) -> Iterator[dict]:
+        # Execute SQL query.
+        with self.client.execute_sql(query).open_reader() as reader:
+            if reader.count == 0:
+                raise ValueError("Table contains no data.")
+            for record in reader:
+                yield {k: v for k, v in record}
+
+    def query(self, query: str) -> List[dict]:
+        return list(self.lazy_query(query))
diff --git a/llm/Lib/site-packages/langchain_community/utilities/merriam_webster.py b/llm/Lib/site-packages/langchain_community/utilities/merriam_webster.py
new file mode 100644
index 0000000000000000000000000000000000000000..4904d01faa2db13daeaa3cf1f59ea3c01a3ff2a7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/merriam_webster.py
@@ -0,0 +1,107 @@
+"""Util that calls Merriam-Webster."""
+import json
+from typing import Dict, Iterator, List, Optional
+from urllib.parse import quote
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+MERRIAM_WEBSTER_API_URL = (
+    "https://www.dictionaryapi.com/api/v3/references/collegiate/json"
+)
+MERRIAM_WEBSTER_TIMEOUT = 5000
+
+
+class MerriamWebsterAPIWrapper(BaseModel):
+    """Wrapper for Merriam-Webster.
+
+    Docs for using:
+
+    1. Go to https://www.dictionaryapi.com/register/index and register an
+       developer account with a key for the Collegiate Dictionary
+    2. Get your API Key from https://www.dictionaryapi.com/account/my-keys
+    3. Save your API Key into MERRIAM_WEBSTER_API_KEY env variable
+
+    """
+
+    merriam_webster_api_key: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        merriam_webster_api_key = get_from_dict_or_env(
+            values, "merriam_webster_api_key", "MERRIAM_WEBSTER_API_KEY"
+        )
+        values["merriam_webster_api_key"] = merriam_webster_api_key
+
+        return values
+
+    def run(self, query: str) -> str:
+        """Run query through Merriam-Webster API and return a formatted result."""
+        quoted_query = quote(query)
+
+        request_url = (
+            f"{MERRIAM_WEBSTER_API_URL}/{quoted_query}"
+            f"?key={self.merriam_webster_api_key}"
+        )
+
+        response = requests.get(request_url, timeout=MERRIAM_WEBSTER_TIMEOUT)
+
+        if response.status_code != 200:
+            return response.text
+
+        return self._format_response(query, response)
+
+    def _format_response(self, query: str, response: requests.Response) -> str:
+        content = json.loads(response.content)
+
+        if not content:
+            return f"No Merriam-Webster definition was found for query '{query}'."
+
+        if isinstance(content[0], str):
+            result = f"No Merriam-Webster definition was found for query '{query}'.\n"
+            if len(content) > 1:
+                alternatives = [f"{i + 1}. {content[i]}" for i in range(len(content))]
+                result += "You can try one of the following alternative queries:\n\n"
+                result += "\n".join(alternatives)
+            else:
+                result += f"Did you mean '{content[0]}'?"
+        else:
+            result = self._format_definitions(query, content)
+
+        return result
+
+    def _format_definitions(self, query: str, definitions: List[Dict]) -> str:
+        formatted_definitions: List[str] = []
+        for definition in definitions:
+            formatted_definitions.extend(self._format_definition(definition))
+
+        if len(formatted_definitions) == 1:
+            return f"Definition of '{query}':\n" f"{formatted_definitions[0]}"
+
+        result = f"Definitions of '{query}':\n\n"
+        for i, formatted_definition in enumerate(formatted_definitions, 1):
+            result += f"{i}. {formatted_definition}\n"
+
+        return result
+
+    def _format_definition(self, definition: Dict) -> Iterator[str]:
+        if "hwi" in definition:
+            headword = definition["hwi"]["hw"].replace("*", "-")
+        else:
+            headword = definition["meta"]["id"].split(":")[0]
+
+        if "fl" in definition:
+            functional_label = definition["fl"]
+
+        if "shortdef" in definition:
+            for short_def in definition["shortdef"]:
+                yield f"{headword}, {functional_label}: {short_def}"
+        else:
+            yield f"{headword}, {functional_label}"
diff --git a/llm/Lib/site-packages/langchain_community/utilities/metaphor_search.py b/llm/Lib/site-packages/langchain_community/utilities/metaphor_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..270ce8a5e4361cd29720676ce6584beecf01b169
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/metaphor_search.py
@@ -0,0 +1,171 @@
+"""Util that calls Metaphor Search API.
+
+In order to set this up, follow instructions at:
+"""
+import json
+from typing import Dict, List, Optional
+
+import aiohttp
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+METAPHOR_API_URL = "https://api.metaphor.systems"
+
+
+class MetaphorSearchAPIWrapper(BaseModel):
+    """Wrapper for Metaphor Search API."""
+
+    metaphor_api_key: str
+    k: int = 10
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def _metaphor_search_results(
+        self,
+        query: str,
+        num_results: int,
+        include_domains: Optional[List[str]] = None,
+        exclude_domains: Optional[List[str]] = None,
+        start_crawl_date: Optional[str] = None,
+        end_crawl_date: Optional[str] = None,
+        start_published_date: Optional[str] = None,
+        end_published_date: Optional[str] = None,
+        use_autoprompt: Optional[bool] = None,
+    ) -> List[dict]:
+        headers = {"X-Api-Key": self.metaphor_api_key}
+        params = {
+            "numResults": num_results,
+            "query": query,
+            "includeDomains": include_domains,
+            "excludeDomains": exclude_domains,
+            "startCrawlDate": start_crawl_date,
+            "endCrawlDate": end_crawl_date,
+            "startPublishedDate": start_published_date,
+            "endPublishedDate": end_published_date,
+            "useAutoprompt": use_autoprompt,
+        }
+        response = requests.post(
+            # type: ignore
+            f"{METAPHOR_API_URL}/search",
+            headers=headers,
+            json=params,
+        )
+
+        response.raise_for_status()
+        search_results = response.json()
+        return search_results["results"]
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        metaphor_api_key = get_from_dict_or_env(
+            values, "metaphor_api_key", "METAPHOR_API_KEY"
+        )
+        values["metaphor_api_key"] = metaphor_api_key
+
+        return values
+
+    def results(
+        self,
+        query: str,
+        num_results: int,
+        include_domains: Optional[List[str]] = None,
+        exclude_domains: Optional[List[str]] = None,
+        start_crawl_date: Optional[str] = None,
+        end_crawl_date: Optional[str] = None,
+        start_published_date: Optional[str] = None,
+        end_published_date: Optional[str] = None,
+        use_autoprompt: Optional[bool] = None,
+    ) -> List[Dict]:
+        """Run query through Metaphor Search and return metadata.
+
+        Args:
+            query: The query to search for.
+            num_results: The number of results to return.
+            include_domains: A list of domains to include in the search. Only one of include_domains and exclude_domains should be defined.
+            exclude_domains: A list of domains to exclude from the search. Only one of include_domains and exclude_domains should be defined.
+            start_crawl_date: If specified, only pages we crawled after start_crawl_date will be returned.
+            end_crawl_date: If specified, only pages we crawled before end_crawl_date will be returned.
+            start_published_date: If specified, only pages published after start_published_date will be returned.
+            end_published_date: If specified, only pages published before end_published_date will be returned.
+            use_autoprompt: If true, we turn your query into a more Metaphor-friendly query. Adds latency.
+
+        Returns:
+            A list of dictionaries with the following keys:
+                title - The title of the page
+                url - The url
+                author - Author of the content, if applicable. Otherwise, None.
+                published_date - Estimated date published
+                    in YYYY-MM-DD format. Otherwise, None.
+        """  # noqa: E501
+        raw_search_results = self._metaphor_search_results(
+            query,
+            num_results=num_results,
+            include_domains=include_domains,
+            exclude_domains=exclude_domains,
+            start_crawl_date=start_crawl_date,
+            end_crawl_date=end_crawl_date,
+            start_published_date=start_published_date,
+            end_published_date=end_published_date,
+            use_autoprompt=use_autoprompt,
+        )
+        return self._clean_results(raw_search_results)
+
+    async def results_async(
+        self,
+        query: str,
+        num_results: int,
+        include_domains: Optional[List[str]] = None,
+        exclude_domains: Optional[List[str]] = None,
+        start_crawl_date: Optional[str] = None,
+        end_crawl_date: Optional[str] = None,
+        start_published_date: Optional[str] = None,
+        end_published_date: Optional[str] = None,
+        use_autoprompt: Optional[bool] = None,
+    ) -> List[Dict]:
+        """Get results from the Metaphor Search API asynchronously."""
+
+        # Function to perform the API call
+        async def fetch() -> str:
+            headers = {"X-Api-Key": self.metaphor_api_key}
+            params = {
+                "numResults": num_results,
+                "query": query,
+                "includeDomains": include_domains,
+                "excludeDomains": exclude_domains,
+                "startCrawlDate": start_crawl_date,
+                "endCrawlDate": end_crawl_date,
+                "startPublishedDate": start_published_date,
+                "endPublishedDate": end_published_date,
+                "useAutoprompt": use_autoprompt,
+            }
+            async with aiohttp.ClientSession() as session:
+                async with session.post(
+                    f"{METAPHOR_API_URL}/search", json=params, headers=headers
+                ) as res:
+                    if res.status == 200:
+                        data = await res.text()
+                        return data
+                    else:
+                        raise Exception(f"Error {res.status}: {res.reason}")
+
+        results_json_str = await fetch()
+        results_json = json.loads(results_json_str)
+        return self._clean_results(results_json["results"])
+
+    def _clean_results(self, raw_search_results: List[Dict]) -> List[Dict]:
+        cleaned_results = []
+        for result in raw_search_results:
+            cleaned_results.append(
+                {
+                    "title": result.get("title", "Unknown Title"),
+                    "url": result.get("url", "Unknown URL"),
+                    "author": result.get("author", "Unknown Author"),
+                    "published_date": result.get("publishedDate", "Unknown Date"),
+                }
+            )
+        return cleaned_results
diff --git a/llm/Lib/site-packages/langchain_community/utilities/nasa.py b/llm/Lib/site-packages/langchain_community/utilities/nasa.py
new file mode 100644
index 0000000000000000000000000000000000000000..16aa067ddfbdd04d56feac8de56efe51f2b54ed4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/nasa.py
@@ -0,0 +1,53 @@
+"""Util that calls several NASA APIs."""
+import json
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel
+
+IMAGE_AND_VIDEO_LIBRARY_URL = "https://images-api.nasa.gov"
+
+
+class NasaAPIWrapper(BaseModel):
+    """Wrapper for NASA API."""
+
+    def get_media(self, query: str) -> str:
+        params = json.loads(query)
+        if params.get("q"):
+            queryText = params["q"]
+            params.pop("q")
+        else:
+            queryText = ""
+        response = requests.get(
+            IMAGE_AND_VIDEO_LIBRARY_URL + "/search?q=" + queryText, params=params
+        )
+        data = response.json()
+        return data
+
+    def get_media_metadata_manifest(self, query: str) -> str:
+        response = requests.get(IMAGE_AND_VIDEO_LIBRARY_URL + "/asset/" + query)
+        return response.json()
+
+    def get_media_metadata_location(self, query: str) -> str:
+        response = requests.get(IMAGE_AND_VIDEO_LIBRARY_URL + "/metadata/" + query)
+        return response.json()
+
+    def get_video_captions_location(self, query: str) -> str:
+        response = requests.get(IMAGE_AND_VIDEO_LIBRARY_URL + "/captions/" + query)
+        return response.json()
+
+    def run(self, mode: str, query: str) -> str:
+        if mode == "search_media":
+            output = self.get_media(query)
+        elif mode == "get_media_metadata_manifest":
+            output = self.get_media_metadata_manifest(query)
+        elif mode == "get_media_metadata_location":
+            output = self.get_media_metadata_location(query)
+        elif mode == "get_video_captions_location":
+            output = self.get_video_captions_location(query)
+        else:
+            output = f"ModeError: Got unexpected mode {mode}."
+
+        try:
+            return json.dumps(output)
+        except Exception:
+            return str(output)
diff --git a/llm/Lib/site-packages/langchain_community/utilities/nvidia_riva.py b/llm/Lib/site-packages/langchain_community/utilities/nvidia_riva.py
new file mode 100644
index 0000000000000000000000000000000000000000..c3c887b14f0791719d603b46b63b7cc13f46c753
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/nvidia_riva.py
@@ -0,0 +1,673 @@
+"""A common module for NVIDIA Riva Runnables."""
+
+import asyncio
+import logging
+import pathlib
+import queue
+import tempfile
+import threading
+import wave
+from enum import Enum
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncGenerator,
+    AsyncIterator,
+    Dict,
+    Generator,
+    Iterator,
+    List,
+    Optional,
+    Tuple,
+    Union,
+    cast,
+)
+
+from langchain_core.messages import AnyMessage, BaseMessage
+from langchain_core.prompt_values import PromptValue
+from langchain_core.pydantic_v1 import (
+    AnyHttpUrl,
+    BaseModel,
+    Field,
+    parse_obj_as,
+    root_validator,
+    validator,
+)
+from langchain_core.runnables import RunnableConfig, RunnableSerializable
+
+if TYPE_CHECKING:
+    import riva.client
+    import riva.client.proto.riva_asr_pb2 as rasr
+
+_LOGGER = logging.getLogger(__name__)
+_QUEUE_GET_TIMEOUT = 0.5
+_MAX_TEXT_LENGTH = 400
+_SENTENCE_TERMINATORS = ("\n", ".", "!", "?", "¡", "¿")
+
+
+# COMMON utilities used by all Riva Runnables
+def _import_riva_client() -> "riva.client":
+    """Import the riva client and raise an error on failure."""
+    try:
+        # pylint: disable-next=import-outside-toplevel # this client library is optional
+        import riva.client
+    except ImportError as err:
+        raise ImportError(
+            "Could not import the NVIDIA Riva client library. "
+            "Please install it with `pip install nvidia-riva-client`."
+        ) from err
+    return riva.client
+
+
+class SentinelT:  # pylint: disable=too-few-public-methods
+    """An empty Sentinel type."""
+
+
+HANGUP = SentinelT()
+_TRANSFORM_END = SentinelT()
+
+
+class RivaAudioEncoding(str, Enum):
+    """An enum of the possible choices for Riva audio encoding.
+
+    The list of types exposed by the Riva GRPC Protobuf files can be found
+    with the following commands:
+    ```python
+    import riva.client
+    print(riva.client.AudioEncoding.keys())  # noqa: T201
+    ```
+    """
+
+    ALAW = "ALAW"
+    ENCODING_UNSPECIFIED = "ENCODING_UNSPECIFIED"
+    FLAC = "FLAC"
+    LINEAR_PCM = "LINEAR_PCM"
+    MULAW = "MULAW"
+    OGGOPUS = "OGGOPUS"
+
+    @classmethod
+    def from_wave_format_code(cls, format_code: int) -> "RivaAudioEncoding":
+        """Return the audio encoding specified by the format code in the wave file.
+
+        ref: https://mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html
+        """
+        try:
+            return {1: cls.LINEAR_PCM, 6: cls.ALAW, 7: cls.MULAW}[format_code]
+        except KeyError as err:
+            raise NotImplementedError(
+                "The following wave file format code is "
+                f"not supported by Riva: {format_code}"
+            ) from err
+
+    @property
+    def riva_pb2(self) -> "riva.client.AudioEncoding":
+        """Returns the Riva API object for the encoding."""
+        riva_client = _import_riva_client()
+        return getattr(riva_client.AudioEncoding, self)
+
+
+class RivaAuthMixin(BaseModel):
+    """Configuration for the authentication to a Riva service connection."""
+
+    url: Union[AnyHttpUrl, str] = Field(
+        AnyHttpUrl("http://localhost:50051", scheme="http"),
+        description="The full URL where the Riva service can be found.",
+        examples=["http://localhost:50051", "https://user@pass:riva.example.com"],
+    )
+    ssl_cert: Optional[str] = Field(
+        None,
+        description="A full path to the file where Riva's public ssl key can be read.",
+    )
+
+    @property
+    def auth(self) -> "riva.client.Auth":
+        """Return a riva client auth object."""
+        riva_client = _import_riva_client()
+        url = cast(AnyHttpUrl, self.url)
+        use_ssl = url.scheme == "https"  # pylint: disable=no-member # false positive
+        url_no_scheme = str(self.url).split("/")[2]
+        return riva_client.Auth(
+            ssl_cert=self.ssl_cert, use_ssl=use_ssl, uri=url_no_scheme
+        )
+
+    @validator("url", pre=True, allow_reuse=True)
+    @classmethod
+    def _validate_url(cls, val: Any) -> AnyHttpUrl:
+        """Do some initial conversations for the URL before checking."""
+        if isinstance(val, str):
+            return cast(AnyHttpUrl, parse_obj_as(AnyHttpUrl, val))
+        return cast(AnyHttpUrl, val)
+
+
+class RivaCommonConfigMixin(BaseModel):
+    """A collection of common Riva settings."""
+
+    encoding: RivaAudioEncoding = Field(
+        default=RivaAudioEncoding.LINEAR_PCM,
+        description="The encoding on the audio stream.",
+    )
+    sample_rate_hertz: int = Field(
+        default=8000, description="The sample rate frequency of audio stream."
+    )
+    language_code: str = Field(
+        default="en-US",
+        description=(
+            "The [BCP-47 language code]"
+            "(https://www.rfc-editor.org/rfc/bcp/bcp47.txt) for "
+            "the target language."
+        ),
+    )
+
+
+class _Event:
+    """A combined event that is threadsafe and async safe."""
+
+    _event: threading.Event
+    _aevent: asyncio.Event
+
+    def __init__(self) -> None:
+        """Initialize the event."""
+        self._event = threading.Event()
+        self._aevent = asyncio.Event()
+
+    def set(self) -> None:
+        """Set the event."""
+        self._event.set()
+        self._aevent.set()
+
+    def clear(self) -> None:
+        """Set the event."""
+        self._event.clear()
+        self._aevent.clear()
+
+    def is_set(self) -> bool:
+        """Indicate if the event is set."""
+        return self._event.is_set()
+
+    def wait(self) -> None:
+        """Wait for the event to be set."""
+        self._event.wait()
+
+    async def async_wait(self) -> None:
+        """Async wait for the event to be set."""
+        await self._aevent.wait()
+
+
+def _mk_wave_file(
+    output_directory: Optional[str], sample_rate: float
+) -> Tuple[Optional[str], Optional[wave.Wave_write]]:
+    """Create a new wave file and return the wave write object and filename."""
+    if output_directory:
+        with tempfile.NamedTemporaryFile(
+            mode="bx", suffix=".wav", delete=False, dir=output_directory
+        ) as f:
+            wav_file_name = f.name
+        wav_file = wave.open(wav_file_name, "wb")
+        wav_file.setnchannels(1)
+        wav_file.setsampwidth(2)
+        wav_file.setframerate(sample_rate)
+        return (wav_file_name, wav_file)
+    return (None, None)
+
+
+def _coerce_string(val: "TTSInputType") -> str:
+    """Attempt to coerce the input value to a string.
+
+    This is particularly useful for converting LangChain message to strings.
+    """
+    if isinstance(val, PromptValue):
+        return val.to_string()
+    if isinstance(val, BaseMessage):
+        return str(val.content)
+    return str(val)
+
+
+def _process_chunks(inputs: Iterator["TTSInputType"]) -> Generator[str, None, None]:
+    """Filter the input chunks are return strings ready for TTS."""
+    buffer = ""
+    for chunk in inputs:
+        chunk = _coerce_string(chunk)
+
+        # return the buffer if an end of sentence character is detected
+        for terminator in _SENTENCE_TERMINATORS:
+            while terminator in chunk:
+                last_sentence, chunk = chunk.split(terminator, 1)
+                yield buffer + last_sentence + terminator
+                buffer = ""
+
+        buffer += chunk
+
+        # return the buffer if is too long
+        if len(buffer) > _MAX_TEXT_LENGTH:
+            for idx in range(0, len(buffer), _MAX_TEXT_LENGTH):
+                yield buffer[idx : idx + 5]
+            buffer = ""
+
+    # return remaining buffer
+    if buffer:
+        yield buffer
+
+
+# Riva AudioStream Type
+StreamInputType = Union[bytes, SentinelT]
+StreamOutputType = str
+
+
+class AudioStream:
+    """A message containing streaming audio."""
+
+    _put_lock: threading.Lock
+    _queue: queue.Queue
+    output: queue.Queue
+    hangup: _Event
+    user_talking: _Event
+    user_quiet: _Event
+    _worker: Optional[threading.Thread]
+
+    def __init__(self, maxsize: int = 0) -> None:
+        """Initialize the queue."""
+        self._put_lock = threading.Lock()
+        self._queue = queue.Queue(maxsize=maxsize)
+        self.output = queue.Queue()
+        self.hangup = _Event()
+        self.user_quiet = _Event()
+        self.user_talking = _Event()
+        self._worker = None
+
+    def __iter__(self) -> Generator[bytes, None, None]:
+        """Return an error."""
+        while True:
+            # get next item
+            try:
+                next_val = self._queue.get(True, _QUEUE_GET_TIMEOUT)
+            except queue.Empty:
+                continue
+
+            # hangup when requested
+            if next_val == HANGUP:
+                break
+
+            # yield next item
+            yield next_val
+            self._queue.task_done()
+
+    async def __aiter__(self) -> AsyncIterator[StreamInputType]:
+        """Iterate through all items in the queue until HANGUP."""
+        while True:
+            # get next item
+            try:
+                next_val = await asyncio.get_event_loop().run_in_executor(
+                    None, self._queue.get, True, _QUEUE_GET_TIMEOUT
+                )
+            except queue.Empty:
+                continue
+
+            # hangup when requested
+            if next_val == HANGUP:
+                break
+
+            # yield next item
+            yield next_val
+            self._queue.task_done()
+
+    @property
+    def hungup(self) -> bool:
+        """Indicate if the audio stream has hungup."""
+        return self.hangup.is_set()
+
+    @property
+    def empty(self) -> bool:
+        """Indicate in the input stream buffer is empty."""
+        return self._queue.empty()
+
+    @property
+    def complete(self) -> bool:
+        """Indicate if the audio stream has hungup and been processed."""
+        input_done = self.hungup and self.empty
+        output_done = (
+            self._worker is not None
+            and not self._worker.is_alive()
+            and self.output.empty()
+        )
+        return input_done and output_done
+
+    @property
+    def running(self) -> bool:
+        """Indicate if the ASR stream is running."""
+        if self._worker:
+            return self._worker.is_alive()
+        return False
+
+    def put(self, item: StreamInputType, timeout: Optional[int] = None) -> None:
+        """Put a new item into the queue."""
+        with self._put_lock:
+            if self.hungup:
+                raise RuntimeError(
+                    "The audio stream has already been hungup. Cannot put more data."
+                )
+            if item is HANGUP:
+                self.hangup.set()
+            self._queue.put(item, timeout=timeout)
+
+    async def aput(self, item: StreamInputType, timeout: Optional[int] = None) -> None:
+        """Async put a new item into the queue."""
+        loop = asyncio.get_event_loop()
+        await asyncio.wait_for(loop.run_in_executor(None, self.put, item), timeout)
+
+    def close(self, timeout: Optional[int] = None) -> None:
+        """Send the hangup signal."""
+        self.put(HANGUP, timeout)
+
+    async def aclose(self, timeout: Optional[int] = None) -> None:
+        """Async send the hangup signal."""
+        await self.aput(HANGUP, timeout)
+
+    def register(self, responses: Iterator["rasr.StreamingRecognizeResponse"]) -> None:
+        """Drain the responses from the provided iterator and put them into a queue."""
+        if self.running:
+            raise RuntimeError("An ASR instance has already been registered.")
+
+        has_started = threading.Barrier(2, timeout=5)
+
+        def worker() -> None:
+            """Consume the ASR Generator."""
+            has_started.wait()
+            for response in responses:
+                if not response.results:
+                    continue
+
+                for result in response.results:
+                    if not result.alternatives:
+                        continue
+
+                    if result.is_final:
+                        self.user_talking.clear()
+                        self.user_quiet.set()
+                        transcript = cast(str, result.alternatives[0].transcript)
+                        self.output.put(transcript)
+
+                    elif not self.user_talking.is_set():
+                        self.user_talking.set()
+                        self.user_quiet.clear()
+
+        self._worker = threading.Thread(target=worker)
+        self._worker.daemon = True
+        self._worker.start()
+        has_started.wait()
+
+
+# RivaASR Runnable
+ASRInputType = AudioStream
+ASROutputType = str
+
+
+class RivaASR(
+    RivaAuthMixin,
+    RivaCommonConfigMixin,
+    RunnableSerializable[ASRInputType, ASROutputType],
+):
+    """A runnable that performs Automatic Speech Recognition (ASR) using NVIDIA Riva."""
+
+    name: str = "nvidia_riva_asr"
+    description: str = (
+        "A Runnable for converting audio bytes to a string."
+        "This is useful for feeding an audio stream into a chain and"
+        "preprocessing that audio to create an LLM prompt."
+    )
+
+    # riva options
+    audio_channel_count: int = Field(
+        1, description="The number of audio channels in the input audio stream."
+    )
+    profanity_filter: bool = Field(
+        True,
+        description=(
+            "Controls whether or not Riva should attempt to filter "
+            "profanity out of the transcribed text."
+        ),
+    )
+    enable_automatic_punctuation: bool = Field(
+        True,
+        description=(
+            "Controls whether Riva should attempt to correct "
+            "senetence puncuation in the transcribed text."
+        ),
+    )
+
+    @root_validator(pre=True)
+    @classmethod
+    def _validate_environment(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Validate the Python environment and input arguments."""
+        _ = _import_riva_client()
+        return values
+
+    @property
+    def config(self) -> "riva.client.StreamingRecognitionConfig":
+        """Create and return the riva config object."""
+        riva_client = _import_riva_client()
+        return riva_client.StreamingRecognitionConfig(
+            interim_results=True,
+            config=riva_client.RecognitionConfig(
+                encoding=self.encoding,
+                sample_rate_hertz=self.sample_rate_hertz,
+                audio_channel_count=self.audio_channel_count,
+                max_alternatives=1,
+                profanity_filter=self.profanity_filter,
+                enable_automatic_punctuation=self.enable_automatic_punctuation,
+                language_code=self.language_code,
+            ),
+        )
+
+    def _get_service(self) -> "riva.client.ASRService":
+        """Connect to the riva service and return the a client object."""
+        riva_client = _import_riva_client()
+        try:
+            return riva_client.ASRService(self.auth)
+        except Exception as err:
+            raise ValueError(
+                "Error raised while connecting to the Riva ASR server."
+            ) from err
+
+    def invoke(
+        self,
+        input: ASRInputType,
+        _: Optional[RunnableConfig] = None,
+    ) -> ASROutputType:
+        """Transcribe the audio bytes into a string with Riva."""
+        # create an output text generator with Riva
+        if not input.running:
+            service = self._get_service()
+            responses = service.streaming_response_generator(
+                audio_chunks=input,
+                streaming_config=self.config,
+            )
+            input.register(responses)
+
+        # return the first valid result
+        full_response: List[str] = []
+        while not input.complete:
+            with input.output.not_empty:
+                ready = input.output.not_empty.wait(0.1)
+
+            if ready:
+                while not input.output.empty():
+                    try:
+                        full_response += [input.output.get_nowait()]
+                    except queue.Empty:
+                        continue
+                    input.output.task_done()
+                _LOGGER.debug("Riva ASR returning: %s", repr(full_response))
+                return " ".join(full_response).strip()
+
+        return ""
+
+
+# RivaTTS Runnable
+# pylint: disable-next=invalid-name
+TTSInputType = Union[str, AnyMessage, PromptValue]
+TTSOutputType = bytes
+
+
+class RivaTTS(
+    RivaAuthMixin,
+    RivaCommonConfigMixin,
+    RunnableSerializable[TTSInputType, TTSOutputType],
+):
+    """A runnable that performs Text-to-Speech (TTS) with NVIDIA Riva."""
+
+    name: str = "nvidia_riva_tts"
+    description: str = (
+        "A tool for converting text to speech."
+        "This is useful for converting LLM output into audio bytes."
+    )
+
+    # riva options
+    voice_name: str = Field(
+        "English-US.Female-1",
+        description=(
+            "The voice model in Riva to use for speech. "
+            "Pre-trained models are documented in "
+            "[the Riva documentation]"
+            "(https://docs.nvidia.com/deeplearning/riva/user-guide/docs/tts/tts-overview.html)."
+        ),
+    )
+    output_directory: Optional[str] = Field(
+        None,
+        description=(
+            "The directory where all audio files should be saved. "
+            "A null value indicates that wave files should not be saved. "
+            "This is useful for debugging purposes."
+        ),
+    )
+
+    @root_validator(pre=True)
+    @classmethod
+    def _validate_environment(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Validate the Python environment and input arguments."""
+        _ = _import_riva_client()
+        return values
+
+    @validator("output_directory")
+    @classmethod
+    def _output_directory_validator(cls, v: str) -> str:
+        if v:
+            dirpath = pathlib.Path(v)
+            dirpath.mkdir(parents=True, exist_ok=True)
+            return str(dirpath.absolute())
+        return v
+
+    def _get_service(self) -> "riva.client.SpeechSynthesisService":
+        """Connect to the riva service and return the a client object."""
+        riva_client = _import_riva_client()
+        try:
+            return riva_client.SpeechSynthesisService(self.auth)
+        except Exception as err:
+            raise ValueError(
+                "Error raised while connecting to the Riva TTS server."
+            ) from err
+
+    def invoke(
+        self, input: TTSInputType, _: Union[RunnableConfig, None] = None
+    ) -> TTSOutputType:
+        """Perform TTS by taking a string and outputting the entire audio file."""
+        return b"".join(self.transform(iter([input])))
+
+    def transform(
+        self,
+        input: Iterator[TTSInputType],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[TTSOutputType]:
+        """Perform TTS by taking a stream of characters and streaming output bytes."""
+        service = self._get_service()
+
+        # create an output wave file
+        wav_file_name, wav_file = _mk_wave_file(
+            self.output_directory, self.sample_rate_hertz
+        )
+
+        # split the input text and perform tts
+        for chunk in _process_chunks(input):
+            _LOGGER.debug("Riva TTS chunk: %s", chunk)
+
+            # start riva tts streaming
+            responses = service.synthesize_online(
+                text=chunk,
+                voice_name=self.voice_name,
+                language_code=self.language_code,
+                encoding=self.encoding.riva_pb2,
+                sample_rate_hz=self.sample_rate_hertz,
+            )
+
+            # stream audio bytes out
+            for resp in responses:
+                audio = cast(bytes, resp.audio)
+                if wav_file:
+                    wav_file.writeframesraw(audio)
+                yield audio
+
+        # close the wave file when we are done
+        if wav_file:
+            wav_file.close()
+            _LOGGER.debug("Riva TTS wrote file: %s", wav_file_name)
+
+    async def atransform(
+        self,
+        input: AsyncIterator[TTSInputType],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncGenerator[TTSOutputType, None]:
+        """Intercept async transforms and route them to the synchronous transform."""
+        loop = asyncio.get_running_loop()
+        input_queue: queue.Queue = queue.Queue()
+        out_queue: asyncio.Queue = asyncio.Queue()
+
+        async def _producer() -> None:
+            """Produce input into the input queue."""
+            async for val in input:
+                input_queue.put_nowait(val)
+            input_queue.put_nowait(_TRANSFORM_END)
+
+        def _input_iterator() -> Iterator[TTSInputType]:
+            """Iterate over the input_queue."""
+            while True:
+                try:
+                    val = input_queue.get(timeout=0.5)
+                except queue.Empty:
+                    continue
+                if val == _TRANSFORM_END:
+                    break
+                yield val
+
+        def _consumer() -> None:
+            """Consume the input with transform."""
+            for val in self.transform(_input_iterator()):
+                out_queue.put_nowait(val)
+            out_queue.put_nowait(_TRANSFORM_END)
+
+        async def _consumer_coro() -> None:
+            """Coroutine that wraps the consumer."""
+            await loop.run_in_executor(None, _consumer)
+
+        producer = loop.create_task(_producer())
+        consumer = loop.create_task(_consumer_coro())
+
+        while True:
+            try:
+                val = await asyncio.wait_for(out_queue.get(), 0.5)
+            except asyncio.exceptions.TimeoutError:
+                continue
+            out_queue.task_done()
+
+            if val is _TRANSFORM_END:
+                break
+            yield val
+
+        await producer
+        await consumer
+
+
+# Backwards compatibility:
+NVIDIARivaASR = RivaASR
+NVIDIARivaTTS = RivaTTS
+NVIDIARivaStream = AudioStream
diff --git a/llm/Lib/site-packages/langchain_community/utilities/opaqueprompts.py b/llm/Lib/site-packages/langchain_community/utilities/opaqueprompts.py
new file mode 100644
index 0000000000000000000000000000000000000000..9473fd9e10209254688b5f90de26440acda5ad70
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/opaqueprompts.py
@@ -0,0 +1,102 @@
+from typing import Dict, Union
+
+
+def sanitize(
+    input: Union[str, Dict[str, str]],
+) -> Dict[str, Union[str, Dict[str, str]]]:
+    """
+    Sanitize input string or dict of strings by replacing sensitive data with
+    placeholders.
+
+    It returns the sanitized input string or dict of strings and the secure
+    context as a dict following the format:
+    {
+        "sanitized_input": <sanitized input string or dict of strings>,
+        "secure_context": <secure context>
+    }
+
+    The secure context is a bytes object that is needed to de-sanitize the response
+    from the LLM.
+
+    Args:
+        input: Input string or dict of strings.
+
+    Returns:
+        Sanitized input string or dict of strings and the secure context
+        as a dict following the format:
+        {
+            "sanitized_input": <sanitized input string or dict of strings>,
+            "secure_context": <secure context>
+        }
+
+        The `secure_context` needs to be passed to the `desanitize` function.
+
+    Raises:
+        ValueError: If the input is not a string or dict of strings.
+        ImportError: If the `opaqueprompts` Python package is not installed.
+    """
+    try:
+        import opaqueprompts as op
+    except ImportError:
+        raise ImportError(
+            "Could not import the `opaqueprompts` Python package, "
+            "please install it with `pip install opaqueprompts`."
+        )
+
+    if isinstance(input, str):
+        # the input could be a string, so we sanitize the string
+        sanitize_response: op.SanitizeResponse = op.sanitize([input])
+        return {
+            "sanitized_input": sanitize_response.sanitized_texts[0],
+            "secure_context": sanitize_response.secure_context,
+        }
+
+    if isinstance(input, dict):
+        # the input could be a dict[string, string], so we sanitize the values
+        values = list()
+
+        # get the values from the dict
+        for key in input:
+            values.append(input[key])
+
+        # sanitize the values
+        sanitize_values_response: op.SanitizeResponse = op.sanitize(values)
+
+        # reconstruct the dict with the sanitized values
+        sanitized_input_values = sanitize_values_response.sanitized_texts
+        idx = 0
+        sanitized_input = dict()
+        for key in input:
+            sanitized_input[key] = sanitized_input_values[idx]
+            idx += 1
+
+        return {
+            "sanitized_input": sanitized_input,
+            "secure_context": sanitize_values_response.secure_context,
+        }
+
+    raise ValueError(f"Unexpected input type {type(input)}")
+
+
+def desanitize(sanitized_text: str, secure_context: bytes) -> str:
+    """
+    Restore the original sensitive data from the sanitized text.
+
+    Args:
+        sanitized_text: Sanitized text.
+        secure_context: Secure context returned by the `sanitize` function.
+
+    Returns:
+        De-sanitized text.
+    """
+    try:
+        import opaqueprompts as op
+    except ImportError:
+        raise ImportError(
+            "Could not import the `opaqueprompts` Python package, "
+            "please install it with `pip install opaqueprompts`."
+        )
+    desanitize_response: op.DesanitizeResponse = op.desanitize(
+        sanitized_text, secure_context
+    )
+    return desanitize_response.desanitized_text
diff --git a/llm/Lib/site-packages/langchain_community/utilities/openapi.py b/llm/Lib/site-packages/langchain_community/utilities/openapi.py
new file mode 100644
index 0000000000000000000000000000000000000000..71263c369d5583f57c3ff74c9fc20c814a50e356
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/openapi.py
@@ -0,0 +1,314 @@
+"""Utility functions for parsing an OpenAPI spec."""
+from __future__ import annotations
+
+import copy
+import json
+import logging
+import re
+from enum import Enum
+from pathlib import Path
+from typing import TYPE_CHECKING, Dict, List, Optional, Union
+
+import requests
+import yaml
+from langchain_core.pydantic_v1 import ValidationError
+
+logger = logging.getLogger(__name__)
+
+
+class HTTPVerb(str, Enum):
+    """Enumerator of the HTTP verbs."""
+
+    GET = "get"
+    PUT = "put"
+    POST = "post"
+    DELETE = "delete"
+    OPTIONS = "options"
+    HEAD = "head"
+    PATCH = "patch"
+    TRACE = "trace"
+
+    @classmethod
+    def from_str(cls, verb: str) -> HTTPVerb:
+        """Parse an HTTP verb."""
+        try:
+            return cls(verb)
+        except ValueError:
+            raise ValueError(f"Invalid HTTP verb. Valid values are {cls.__members__}")
+
+
+if TYPE_CHECKING:
+    from openapi_pydantic import (
+        Components,
+        Operation,
+        Parameter,
+        PathItem,
+        Paths,
+        Reference,
+        RequestBody,
+        Schema,
+    )
+
+try:
+    from openapi_pydantic import OpenAPI
+except ImportError:
+    OpenAPI = object  # type: ignore
+
+
+class OpenAPISpec(OpenAPI):
+    """OpenAPI Model that removes mis-formatted parts of the spec."""
+
+    openapi: str = "3.1.0"  # overriding overly restrictive type from parent class
+
+    @property
+    def _paths_strict(self) -> Paths:
+        if not self.paths:
+            raise ValueError("No paths found in spec")
+        return self.paths
+
+    def _get_path_strict(self, path: str) -> PathItem:
+        path_item = self._paths_strict.get(path)
+        if not path_item:
+            raise ValueError(f"No path found for {path}")
+        return path_item
+
+    @property
+    def _components_strict(self) -> Components:
+        """Get components or err."""
+        if self.components is None:
+            raise ValueError("No components found in spec. ")
+        return self.components
+
+    @property
+    def _parameters_strict(self) -> Dict[str, Union[Parameter, Reference]]:
+        """Get parameters or err."""
+        parameters = self._components_strict.parameters
+        if parameters is None:
+            raise ValueError("No parameters found in spec. ")
+        return parameters
+
+    @property
+    def _schemas_strict(self) -> Dict[str, Schema]:
+        """Get the dictionary of schemas or err."""
+        schemas = self._components_strict.schemas
+        if schemas is None:
+            raise ValueError("No schemas found in spec. ")
+        return schemas
+
+    @property
+    def _request_bodies_strict(self) -> Dict[str, Union[RequestBody, Reference]]:
+        """Get the request body or err."""
+        request_bodies = self._components_strict.requestBodies
+        if request_bodies is None:
+            raise ValueError("No request body found in spec. ")
+        return request_bodies
+
+    def _get_referenced_parameter(self, ref: Reference) -> Union[Parameter, Reference]:
+        """Get a parameter (or nested reference) or err."""
+        ref_name = ref.ref.split("/")[-1]
+        parameters = self._parameters_strict
+        if ref_name not in parameters:
+            raise ValueError(f"No parameter found for {ref_name}")
+        return parameters[ref_name]
+
+    def _get_root_referenced_parameter(self, ref: Reference) -> Parameter:
+        """Get the root reference or err."""
+        from openapi_pydantic import Reference
+
+        parameter = self._get_referenced_parameter(ref)
+        while isinstance(parameter, Reference):
+            parameter = self._get_referenced_parameter(parameter)
+        return parameter
+
+    def get_referenced_schema(self, ref: Reference) -> Schema:
+        """Get a schema (or nested reference) or err."""
+        ref_name = ref.ref.split("/")[-1]
+        schemas = self._schemas_strict
+        if ref_name not in schemas:
+            raise ValueError(f"No schema found for {ref_name}")
+        return schemas[ref_name]
+
+    def get_schema(self, schema: Union[Reference, Schema]) -> Schema:
+        from openapi_pydantic import Reference
+
+        if isinstance(schema, Reference):
+            return self.get_referenced_schema(schema)
+        return schema
+
+    def _get_root_referenced_schema(self, ref: Reference) -> Schema:
+        """Get the root reference or err."""
+        from openapi_pydantic import Reference
+
+        schema = self.get_referenced_schema(ref)
+        while isinstance(schema, Reference):
+            schema = self.get_referenced_schema(schema)
+        return schema
+
+    def _get_referenced_request_body(
+        self, ref: Reference
+    ) -> Optional[Union[Reference, RequestBody]]:
+        """Get a request body (or nested reference) or err."""
+        ref_name = ref.ref.split("/")[-1]
+        request_bodies = self._request_bodies_strict
+        if ref_name not in request_bodies:
+            raise ValueError(f"No request body found for {ref_name}")
+        return request_bodies[ref_name]
+
+    def _get_root_referenced_request_body(
+        self, ref: Reference
+    ) -> Optional[RequestBody]:
+        """Get the root request Body or err."""
+        from openapi_pydantic import Reference
+
+        request_body = self._get_referenced_request_body(ref)
+        while isinstance(request_body, Reference):
+            request_body = self._get_referenced_request_body(request_body)
+        return request_body
+
+    @staticmethod
+    def _alert_unsupported_spec(obj: dict) -> None:
+        """Alert if the spec is not supported."""
+        warning_message = (
+            " This may result in degraded performance."
+            + " Convert your OpenAPI spec to 3.1.* spec"
+            + " for better support."
+        )
+        swagger_version = obj.get("swagger")
+        openapi_version = obj.get("openapi")
+        if isinstance(openapi_version, str):
+            if openapi_version != "3.1.0":
+                logger.warning(
+                    f"Attempting to load an OpenAPI {openapi_version}"
+                    f" spec. {warning_message}"
+                )
+            else:
+                pass
+        elif isinstance(swagger_version, str):
+            logger.warning(
+                f"Attempting to load a Swagger {swagger_version}"
+                f" spec. {warning_message}"
+            )
+        else:
+            raise ValueError(
+                "Attempting to load an unsupported spec:"
+                f"\n\n{obj}\n{warning_message}"
+            )
+
+    @classmethod
+    def parse_obj(cls, obj: dict) -> OpenAPISpec:
+        try:
+            cls._alert_unsupported_spec(obj)
+            return super().parse_obj(obj)
+        except ValidationError as e:
+            # We are handling possibly misconfigured specs and
+            # want to do a best-effort job to get a reasonable interface out of it.
+            new_obj = copy.deepcopy(obj)
+            for error in e.errors():
+                keys = error["loc"]
+                item = new_obj
+                for key in keys[:-1]:
+                    item = item[key]
+                item.pop(keys[-1], None)
+            return cls.parse_obj(new_obj)
+
+    @classmethod
+    def from_spec_dict(cls, spec_dict: dict) -> OpenAPISpec:
+        """Get an OpenAPI spec from a dict."""
+        return cls.parse_obj(spec_dict)
+
+    @classmethod
+    def from_text(cls, text: str) -> OpenAPISpec:
+        """Get an OpenAPI spec from a text."""
+        try:
+            spec_dict = json.loads(text)
+        except json.JSONDecodeError:
+            spec_dict = yaml.safe_load(text)
+        return cls.from_spec_dict(spec_dict)
+
+    @classmethod
+    def from_file(cls, path: Union[str, Path]) -> OpenAPISpec:
+        """Get an OpenAPI spec from a file path."""
+        path_ = path if isinstance(path, Path) else Path(path)
+        if not path_.exists():
+            raise FileNotFoundError(f"{path} does not exist")
+        with path_.open("r") as f:
+            return cls.from_text(f.read())
+
+    @classmethod
+    def from_url(cls, url: str) -> OpenAPISpec:
+        """Get an OpenAPI spec from a URL."""
+        response = requests.get(url)
+        return cls.from_text(response.text)
+
+    @property
+    def base_url(self) -> str:
+        """Get the base url."""
+        return self.servers[0].url
+
+    def get_methods_for_path(self, path: str) -> List[str]:
+        """Return a list of valid methods for the specified path."""
+        from openapi_pydantic import Operation
+
+        path_item = self._get_path_strict(path)
+        results = []
+        for method in HTTPVerb:
+            operation = getattr(path_item, method.value, None)
+            if isinstance(operation, Operation):
+                results.append(method.value)
+        return results
+
+    def get_parameters_for_path(self, path: str) -> List[Parameter]:
+        from openapi_pydantic import Reference
+
+        path_item = self._get_path_strict(path)
+        parameters = []
+        if not path_item.parameters:
+            return []
+        for parameter in path_item.parameters:
+            if isinstance(parameter, Reference):
+                parameter = self._get_root_referenced_parameter(parameter)
+            parameters.append(parameter)
+        return parameters
+
+    def get_operation(self, path: str, method: str) -> Operation:
+        """Get the operation object for a given path and HTTP method."""
+        from openapi_pydantic import Operation
+
+        path_item = self._get_path_strict(path)
+        operation_obj = getattr(path_item, method, None)
+        if not isinstance(operation_obj, Operation):
+            raise ValueError(f"No {method} method found for {path}")
+        return operation_obj
+
+    def get_parameters_for_operation(self, operation: Operation) -> List[Parameter]:
+        """Get the components for a given operation."""
+        from openapi_pydantic import Reference
+
+        parameters = []
+        if operation.parameters:
+            for parameter in operation.parameters:
+                if isinstance(parameter, Reference):
+                    parameter = self._get_root_referenced_parameter(parameter)
+                parameters.append(parameter)
+        return parameters
+
+    def get_request_body_for_operation(
+        self, operation: Operation
+    ) -> Optional[RequestBody]:
+        """Get the request body for a given operation."""
+        from openapi_pydantic import Reference
+
+        request_body = operation.requestBody
+        if isinstance(request_body, Reference):
+            request_body = self._get_root_referenced_request_body(request_body)
+        return request_body
+
+    @staticmethod
+    def get_cleaned_operation_id(operation: Operation, path: str, method: str) -> str:
+        """Get a cleaned operation id from an operation id."""
+        operation_id = operation.operationId
+        if operation_id is None:
+            # Replace all punctuation of any kind with underscore
+            path = re.sub(r"[^a-zA-Z0-9]", "_", path.lstrip("/"))
+            operation_id = f"{path}_{method}"
+        return operation_id.replace("-", "_").replace(".", "_").replace("/", "_")
diff --git a/llm/Lib/site-packages/langchain_community/utilities/openweathermap.py b/llm/Lib/site-packages/langchain_community/utilities/openweathermap.py
new file mode 100644
index 0000000000000000000000000000000000000000..f79149a1be45cba067804391f01b783f21a5fc40
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/openweathermap.py
@@ -0,0 +1,76 @@
+"""Util that calls OpenWeatherMap using PyOWM."""
+from typing import Any, Dict, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class OpenWeatherMapAPIWrapper(BaseModel):
+    """Wrapper for OpenWeatherMap API using PyOWM.
+
+    Docs for using:
+
+    1. Go to OpenWeatherMap and sign up for an API key
+    2. Save your API KEY into OPENWEATHERMAP_API_KEY env variable
+    3. pip install pyowm
+    """
+
+    owm: Any
+    openweathermap_api_key: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        openweathermap_api_key = get_from_dict_or_env(
+            values, "openweathermap_api_key", "OPENWEATHERMAP_API_KEY"
+        )
+
+        try:
+            import pyowm
+
+        except ImportError:
+            raise ImportError(
+                "pyowm is not installed. Please install it with `pip install pyowm`"
+            )
+
+        owm = pyowm.OWM(openweathermap_api_key)
+        values["owm"] = owm
+
+        return values
+
+    def _format_weather_info(self, location: str, w: Any) -> str:
+        detailed_status = w.detailed_status
+        wind = w.wind()
+        humidity = w.humidity
+        temperature = w.temperature("celsius")
+        rain = w.rain
+        heat_index = w.heat_index
+        clouds = w.clouds
+
+        return (
+            f"In {location}, the current weather is as follows:\n"
+            f"Detailed status: {detailed_status}\n"
+            f"Wind speed: {wind['speed']} m/s, direction: {wind['deg']}°\n"
+            f"Humidity: {humidity}%\n"
+            f"Temperature: \n"
+            f"  - Current: {temperature['temp']}°C\n"
+            f"  - High: {temperature['temp_max']}°C\n"
+            f"  - Low: {temperature['temp_min']}°C\n"
+            f"  - Feels like: {temperature['feels_like']}°C\n"
+            f"Rain: {rain}\n"
+            f"Heat index: {heat_index}\n"
+            f"Cloud cover: {clouds}%"
+        )
+
+    def run(self, location: str) -> str:
+        """Get the current weather information for a specified location."""
+        mgr = self.owm.weather_manager()
+        observation = mgr.weather_at_place(location)
+        w = observation.weather
+
+        return self._format_weather_info(location, w)
diff --git a/llm/Lib/site-packages/langchain_community/utilities/outline.py b/llm/Lib/site-packages/langchain_community/utilities/outline.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9a4e3cad4d0a0a578584b30bbc35a3b05e697ff
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/outline.py
@@ -0,0 +1,95 @@
+"""Util that calls Outline."""
+import logging
+from typing import Any, Dict, List, Optional
+
+import requests
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+logger = logging.getLogger(__name__)
+
+OUTLINE_MAX_QUERY_LENGTH = 300
+
+
+class OutlineAPIWrapper(BaseModel):
+    """Wrapper around OutlineAPI.
+
+    This wrapper will use the Outline API to query the documents of your instance.
+    By default it will return the document content of the top-k results.
+    It limits the document content by doc_content_chars_max.
+    """
+
+    top_k_results: int = 3
+    load_all_available_meta: bool = False
+    doc_content_chars_max: int = 4000
+    outline_instance_url: Optional[str] = None
+    outline_api_key: Optional[str] = None
+    outline_search_endpoint: str = "/api/documents.search"
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that instance url and api key exists in environment."""
+        outline_instance_url = get_from_dict_or_env(
+            values, "outline_instance_url", "OUTLINE_INSTANCE_URL"
+        )
+        values["outline_instance_url"] = outline_instance_url
+
+        outline_api_key = get_from_dict_or_env(
+            values, "outline_api_key", "OUTLINE_API_KEY"
+        )
+        values["outline_api_key"] = outline_api_key
+
+        return values
+
+    def _result_to_document(self, outline_res: Any) -> Document:
+        main_meta = {
+            "title": outline_res["document"]["title"],
+            "source": self.outline_instance_url + outline_res["document"]["url"],
+        }
+        add_meta = (
+            {
+                "id": outline_res["document"]["id"],
+                "ranking": outline_res["ranking"],
+                "collection_id": outline_res["document"]["collectionId"],
+                "parent_document_id": outline_res["document"]["parentDocumentId"],
+                "revision": outline_res["document"]["revision"],
+                "created_by": outline_res["document"]["createdBy"]["name"],
+            }
+            if self.load_all_available_meta
+            else {}
+        )
+        doc = Document(
+            page_content=outline_res["document"]["text"][: self.doc_content_chars_max],
+            metadata={
+                **main_meta,
+                **add_meta,
+            },
+        )
+        return doc
+
+    def _outline_api_query(self, query: str) -> List:
+        raw_result = requests.post(
+            f"{self.outline_instance_url}{self.outline_search_endpoint}",
+            data={"query": query, "limit": self.top_k_results},
+            headers={"Authorization": f"Bearer {self.outline_api_key}"},
+        )
+
+        if not raw_result.ok:
+            raise ValueError("Outline API returned an error: ", raw_result.text)
+
+        return raw_result.json()["data"]
+
+    def run(self, query: str) -> List[Document]:
+        """
+        Run Outline search and get the document content plus the meta information.
+
+        Returns: a list of documents.
+
+        """
+        results = self._outline_api_query(query[:OUTLINE_MAX_QUERY_LENGTH])
+        docs = []
+        for result in results[: self.top_k_results]:
+            if doc := self._result_to_document(result):
+                docs.append(doc)
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/utilities/passio_nutrition_ai.py b/llm/Lib/site-packages/langchain_community/utilities/passio_nutrition_ai.py
new file mode 100644
index 0000000000000000000000000000000000000000..5be284d3016408eecc19c143670eb4048dc59531
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/passio_nutrition_ai.py
@@ -0,0 +1,170 @@
+"""Util that invokes the Passio Nutrition AI API.
+"""
+from datetime import datetime, timedelta
+from typing import Any, Callable, Dict, Optional, final
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class NoDiskStorage:
+    @final
+    def __getstate__(self) -> None:
+        raise AttributeError("Do not store on disk.")
+
+    @final
+    def __setstate__(self, state: Any) -> None:
+        raise AttributeError("Do not store on disk.")
+
+
+try:
+    from tenacity import (
+        retry,
+        retry_if_result,
+        stop_after_attempt,
+        wait_exponential,
+        wait_random,
+    )
+except ImportError:
+    # No retries if tenacity is not installed.
+    def retry_fallback(
+        f: Callable[..., Any], *args: Any, **kwargs: Any
+    ) -> Callable[..., Any]:
+        return f
+
+    def stop_after_attempt_fallback(n: int) -> None:
+        return None
+
+    def wait_random_fallback(a: float, b: float) -> None:
+        return None
+
+    def wait_exponential_fallback(
+        multiplier: float = 1, min: float = 0, max: float = float("inf")
+    ) -> None:
+        return None
+
+
+def is_http_retryable(rsp: requests.Response) -> bool:
+    return bool(rsp) and rsp.status_code in [408, 425, 429, 500, 502, 503, 504]
+
+
+class ManagedPassioLifeAuth(NoDiskStorage):
+    """Manages the token for the NutritionAI API."""
+
+    _access_token_expiry: Optional[datetime]
+
+    def __init__(self, subscription_key: str):
+        self.subscription_key = subscription_key
+        self._last_token = None
+        self._access_token_expiry = None
+        self._access_token = None
+        self._customer_id = None
+
+    @property
+    def headers(self) -> dict:
+        if not self.is_valid_now():
+            self.refresh_access_token()
+        return {
+            "Authorization": f"Bearer {self._access_token}",
+            "Passio-ID": self._customer_id,
+        }
+
+    def is_valid_now(self) -> bool:
+        return (
+            self._access_token is not None
+            and self._customer_id is not None
+            and self._access_token_expiry is not None
+            and self._access_token_expiry > datetime.now()
+        )
+
+    @retry(
+        retry=retry_if_result(is_http_retryable),
+        stop=stop_after_attempt(4),
+        wait=wait_random(0, 0.3) + wait_exponential(multiplier=1, min=0.1, max=2),
+    )
+    def _http_get(self, subscription_key: str) -> requests.Response:
+        return requests.get(
+            f"https://api.passiolife.com/v2/token-cache/napi/oauth/token/{subscription_key}"
+        )
+
+    def refresh_access_token(self) -> None:
+        """Refresh the access token for the NutritionAI API."""
+        rsp = self._http_get(self.subscription_key)
+        if not rsp:
+            raise ValueError("Could not get access token")
+        self._last_token = token = rsp.json()
+        self._customer_id = token["customer_id"]
+        self._access_token = token["access_token"]
+        self._access_token_expiry = (
+            datetime.now()
+            + timedelta(seconds=token["expires_in"])
+            - timedelta(seconds=5)
+        )
+        # 5 seconds: approximate time for a token refresh to be processed.
+
+
+DEFAULT_NUTRITIONAI_API_URL = (
+    "https://api.passiolife.com/v2/products/napi/food/search/advanced"
+)
+
+
+class NutritionAIAPI(BaseModel):
+    """Wrapper for the Passio Nutrition AI API."""
+
+    nutritionai_subscription_key: str
+    nutritionai_api_url: str = Field(default=DEFAULT_NUTRITIONAI_API_URL)
+    more_kwargs: dict = Field(default_factory=dict)
+    auth_: ManagedPassioLifeAuth
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @retry(
+        retry=retry_if_result(is_http_retryable),
+        stop=stop_after_attempt(4),
+        wait=wait_random(0, 0.3) + wait_exponential(multiplier=1, min=0.1, max=2),
+    )
+    def _http_get(self, params: dict) -> requests.Response:
+        return requests.get(
+            self.nutritionai_api_url,
+            headers=self.auth_.headers,
+            params=params,  # type: ignore
+        )
+
+    def _api_call_results(self, search_term: str) -> dict:
+        """Call the NutritionAI API and return the results."""
+        rsp = self._http_get({"term": search_term, **self.more_kwargs})
+        if not rsp:
+            raise ValueError("Could not get NutritionAI API results")
+        rsp.raise_for_status()
+        return rsp.json()
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        nutritionai_subscription_key = get_from_dict_or_env(
+            values, "nutritionai_subscription_key", "NUTRITIONAI_SUBSCRIPTION_KEY"
+        )
+        values["nutritionai_subscription_key"] = nutritionai_subscription_key
+
+        nutritionai_api_url = get_from_dict_or_env(
+            values,
+            "nutritionai_api_url",
+            "NUTRITIONAI_API_URL",
+            DEFAULT_NUTRITIONAI_API_URL,
+        )
+        values["nutritionai_api_url"] = nutritionai_api_url
+
+        values["auth_"] = ManagedPassioLifeAuth(nutritionai_subscription_key)
+        return values
+
+    def run(self, query: str) -> Optional[Dict]:
+        """Run query through NutrtitionAI API and parse result."""
+        results = self._api_call_results(query)
+        if results and len(results) < 1:
+            return None
+        return results
diff --git a/llm/Lib/site-packages/langchain_community/utilities/pebblo.py b/llm/Lib/site-packages/langchain_community/utilities/pebblo.py
new file mode 100644
index 0000000000000000000000000000000000000000..da65a5835dde884fbbfc87e736cde34ec8d5c278
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/pebblo.py
@@ -0,0 +1,281 @@
+from __future__ import annotations
+
+import logging
+import os
+import pathlib
+import platform
+from typing import Optional, Tuple
+
+from langchain_core.env import get_runtime_environment
+from langchain_core.pydantic_v1 import BaseModel
+
+from langchain_community.document_loaders.base import BaseLoader
+
+logger = logging.getLogger(__name__)
+
+PLUGIN_VERSION = "0.1.1"
+CLASSIFIER_URL = os.getenv("PEBBLO_CLASSIFIER_URL", "http://localhost:8000")
+PEBBLO_CLOUD_URL = os.getenv("PEBBLO_CLOUD_URL", "https://api.daxa.ai")
+
+LOADER_DOC_URL = "/v1/loader/doc"
+APP_DISCOVER_URL = "/v1/app/discover"
+
+# Supported loaders for Pebblo safe data loading
+file_loader = [
+    "JSONLoader",
+    "S3FileLoader",
+    "UnstructuredMarkdownLoader",
+    "UnstructuredPDFLoader",
+    "UnstructuredFileLoader",
+    "UnstructuredJsonLoader",
+    "PyPDFLoader",
+    "GCSFileLoader",
+    "AmazonTextractPDFLoader",
+    "CSVLoader",
+    "UnstructuredExcelLoader",
+    "UnstructuredEmailLoader",
+]
+dir_loader = [
+    "DirectoryLoader",
+    "S3DirLoader",
+    "SlackDirectoryLoader",
+    "PyPDFDirectoryLoader",
+    "NotionDirectoryLoader",
+]
+
+in_memory = ["DataFrameLoader"]
+remote_db = [
+    "NotionDBLoader",
+    "GoogleDriveLoader",
+]
+
+LOADER_TYPE_MAPPING = {
+    "file": file_loader,
+    "dir": dir_loader,
+    "in-memory": in_memory,
+    "remote_db": remote_db,
+}
+
+SUPPORTED_LOADERS = (*file_loader, *dir_loader, *in_memory)
+
+logger = logging.getLogger(__name__)
+
+
+class Runtime(BaseModel):
+    """Pebblo Runtime.
+
+    Args:
+        type (Optional[str]): Runtime type. Defaults to ""
+        host (str): Hostname of runtime.
+        path (str): Current working directory path.
+        ip (Optional[str]): Ip of current runtime. Defaults to ""
+        platform (str): Platform details of current runtime.
+        os (str): OS name.
+        os_version (str): OS version.
+        language (str): Runtime kernel.
+        language_version (str): version of current runtime kernel.
+        runtime (Optional[str]) More runtime details. Defaults to ""
+    """
+
+    type: str = "local"
+    host: str
+    path: str
+    ip: Optional[str] = ""
+    platform: str
+    os: str
+    os_version: str
+    language: str
+    language_version: str
+    runtime: str = "local"
+
+
+class Framework(BaseModel):
+    """Pebblo Framework instance.
+
+    Args:
+        name (str): Name of the Framework.
+        version (str): Version of the Framework.
+    """
+
+    name: str
+    version: str
+
+
+class App(BaseModel):
+    """Pebblo AI application.
+
+    Args:
+        name (str): Name of the app.
+        owner (str): Owner of the app.
+        description (Optional[str]): Description of the app.
+        load_id (str): Unique load_id of the app instance.
+        runtime (Runtime): Runtime details of app.
+        framework (Framework): Framework details of the app
+        plugin_version (str): Plugin version used for the app.
+    """
+
+    name: str
+    owner: str
+    description: Optional[str]
+    load_id: str
+    runtime: Runtime
+    framework: Framework
+    plugin_version: str
+
+
+class Doc(BaseModel):
+    """Pebblo document.
+
+    Args:
+        name (str): Name of app originating this document.
+        owner (str): Owner of app.
+        docs (list): List of documents with its metadata.
+        plugin_version (str): Pebblo plugin Version
+        load_id (str): Unique load_id of the app instance.
+        loader_details (dict): Loader details with its metadata.
+        loading_end (bool): Boolean, specifying end of loading of source.
+        source_owner (str): Owner of the source of the loader.
+    """
+
+    name: str
+    owner: str
+    docs: list
+    plugin_version: str
+    load_id: str
+    loader_details: dict
+    loading_end: bool
+    source_owner: str
+
+
+def get_full_path(path: str) -> str:
+    """Return an absolute local path for a local file/directory,
+    for a network related path, return as is.
+
+    Args:
+        path (str): Relative path to be resolved.
+
+    Returns:
+        str: Resolved absolute path.
+    """
+    if (
+        not path
+        or ("://" in path)
+        or ("/" == path[0])
+        or (path in ["unknown", "-", "in-memory"])
+    ):
+        return path
+    full_path = pathlib.Path(path).resolve()
+    return str(full_path)
+
+
+def get_loader_type(loader: str) -> str:
+    """Return loader type among, file, dir or in-memory.
+
+    Args:
+        loader (str): Name of the loader, whose type is to be resolved.
+
+    Returns:
+        str: One of the loader type among, file/dir/in-memory.
+    """
+    for loader_type, loaders in LOADER_TYPE_MAPPING.items():
+        if loader in loaders:
+            return loader_type
+    return "unsupported"
+
+
+def get_loader_full_path(loader: BaseLoader) -> str:
+    """Return an absolute source path of source of loader based on the
+    keys present in Document object from loader.
+
+    Args:
+        loader (BaseLoader): Langchain document loader, derived from Baseloader.
+    """
+    from langchain_community.document_loaders import (
+        DataFrameLoader,
+        GCSFileLoader,
+        NotionDBLoader,
+        S3FileLoader,
+    )
+
+    location = "-"
+    if not isinstance(loader, BaseLoader):
+        logger.error(
+            "loader is not derived from BaseLoader, source location will be unknown!"
+        )
+        return location
+    loader_dict = loader.__dict__
+    try:
+        if "bucket" in loader_dict:
+            if isinstance(loader, GCSFileLoader):
+                location = f"gc://{loader.bucket}/{loader.blob}"
+            elif isinstance(loader, S3FileLoader):
+                location = f"s3://{loader.bucket}/{loader.key}"
+        elif "source" in loader_dict:
+            location = loader_dict["source"]
+            if location and "channel" in loader_dict:
+                channel = loader_dict["channel"]
+                if channel:
+                    location = f"{location}/{channel}"
+        elif "path" in loader_dict:
+            location = loader_dict["path"]
+        elif "file_path" in loader_dict:
+            location = loader_dict["file_path"]
+        elif "web_paths" in loader_dict:
+            web_paths = loader_dict["web_paths"]
+            if web_paths and isinstance(web_paths, list) and len(web_paths) > 0:
+                location = web_paths[0]
+        # For in-memory types:
+        elif isinstance(loader, DataFrameLoader):
+            location = "in-memory"
+        elif isinstance(loader, NotionDBLoader):
+            location = f"notiondb://{loader.database_id}"
+    except Exception:
+        pass
+    return get_full_path(str(location))
+
+
+def get_runtime() -> Tuple[Framework, Runtime]:
+    """Fetch the current Framework and Runtime details.
+
+    Returns:
+        Tuple[Framework, Runtime]: Framework and Runtime for the current app instance.
+    """
+    runtime_env = get_runtime_environment()
+    framework = Framework(
+        name="langchain", version=runtime_env.get("library_version", None)
+    )
+    uname = platform.uname()
+    runtime = Runtime(
+        host=uname.node,
+        path=os.environ["PWD"],
+        platform=runtime_env.get("platform", "unknown"),
+        os=uname.system,
+        os_version=uname.version,
+        ip=get_ip(),
+        language=runtime_env.get("runtime", "unknown"),
+        language_version=runtime_env.get("runtime_version", "unknown"),
+    )
+
+    if "Darwin" in runtime.os:
+        runtime.type = "desktop"
+        runtime.runtime = "Mac OSX"
+
+    logger.debug(f"framework {framework}")
+    logger.debug(f"runtime {runtime}")
+    return framework, runtime
+
+
+def get_ip() -> str:
+    """Fetch local runtime ip address.
+
+    Returns:
+        str: IP address
+    """
+    import socket  # lazy imports
+
+    host = socket.gethostname()
+    try:
+        public_ip = socket.gethostbyname(host)
+    except Exception:
+        public_ip = socket.gethostbyname("localhost")
+    return public_ip
diff --git a/llm/Lib/site-packages/langchain_community/utilities/polygon.py b/llm/Lib/site-packages/langchain_community/utilities/polygon.py
new file mode 100644
index 0000000000000000000000000000000000000000..e98d772e364928fa5672cc011e4fe8d6ebdeec8c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/polygon.py
@@ -0,0 +1,132 @@
+"""
+Util that calls several of Polygon's stock market REST APIs.
+Docs: https://polygon.io/docs/stocks/getting-started
+"""
+import json
+from typing import Any, Dict, Optional
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+POLYGON_BASE_URL = "https://api.polygon.io/"
+
+
+class PolygonAPIWrapper(BaseModel):
+    """Wrapper for Polygon API."""
+
+    polygon_api_key: Optional[str] = None
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key in environment."""
+        polygon_api_key = get_from_dict_or_env(
+            values, "polygon_api_key", "POLYGON_API_KEY"
+        )
+        values["polygon_api_key"] = polygon_api_key
+
+        return values
+
+    def get_financials(self, ticker: str) -> Optional[dict]:
+        """
+        Get fundamental financial data, which is found in balance sheets,
+        income statements, and cash flow statements for a given ticker.
+
+        /vX/reference/financials
+        """
+        url = (
+            f"{POLYGON_BASE_URL}vX/reference/financials?"
+            f"ticker={ticker}&"
+            f"apiKey={self.polygon_api_key}"
+        )
+        response = requests.get(url)
+        data = response.json()
+
+        status = data.get("status", None)
+        if status != "OK":
+            raise ValueError(f"API Error: {data}")
+
+        return data.get("results", None)
+
+    def get_last_quote(self, ticker: str) -> Optional[dict]:
+        """
+        Get the most recent National Best Bid and Offer (Quote) for a ticker.
+
+        /v2/last/nbbo/{ticker}
+        """
+        url = f"{POLYGON_BASE_URL}v2/last/nbbo/{ticker}?apiKey={self.polygon_api_key}"
+        response = requests.get(url)
+        data = response.json()
+
+        status = data.get("status", None)
+        if status != "OK":
+            raise ValueError(f"API Error: {data}")
+
+        return data.get("results", None)
+
+    def get_ticker_news(self, ticker: str) -> Optional[dict]:
+        """
+        Get the most recent news articles relating to a stock ticker symbol,
+        including a summary of the article and a link to the original source.
+
+        /v2/reference/news
+        """
+        url = (
+            f"{POLYGON_BASE_URL}v2/reference/news?"
+            f"ticker={ticker}&"
+            f"apiKey={self.polygon_api_key}"
+        )
+        response = requests.get(url)
+        data = response.json()
+
+        status = data.get("status", None)
+        if status != "OK":
+            raise ValueError(f"API Error: {data}")
+
+        return data.get("results", None)
+
+    def get_aggregates(self, ticker: str, **kwargs: Any) -> Optional[dict]:
+        """
+        Get aggregate bars for a stock over a given date range
+        in custom time window sizes.
+
+        /v2/aggs/ticker/{ticker}/range/{multiplier}/{timespan}/{from_date}/{to_date}
+        """
+        timespan = kwargs.get("timespan", "day")
+        multiplier = kwargs.get("timespan_multiplier", 1)
+        from_date = kwargs.get("from_date", None)
+        to_date = kwargs.get("to_date", None)
+        adjusted = kwargs.get("adjusted", True)
+        sort = kwargs.get("sort", "asc")
+
+        url = (
+            f"{POLYGON_BASE_URL}v2/aggs"
+            f"/ticker/{ticker}"
+            f"/range/{multiplier}"
+            f"/{timespan}"
+            f"/{from_date}"
+            f"/{to_date}"
+            f"?apiKey={self.polygon_api_key}"
+            f"&adjusted={adjusted}"
+            f"&sort={sort}"
+        )
+        response = requests.get(url)
+        data = response.json()
+
+        status = data.get("status", None)
+        if status != "OK":
+            raise ValueError(f"API Error: {data}")
+
+        return data.get("results", None)
+
+    def run(self, mode: str, ticker: str, **kwargs: Any) -> str:
+        if mode == "get_financials":
+            return json.dumps(self.get_financials(ticker))
+        elif mode == "get_last_quote":
+            return json.dumps(self.get_last_quote(ticker))
+        elif mode == "get_ticker_news":
+            return json.dumps(self.get_ticker_news(ticker))
+        elif mode == "get_aggregates":
+            return json.dumps(self.get_aggregates(ticker, **kwargs))
+        else:
+            raise ValueError(f"Invalid mode {mode} for Polygon API.")
diff --git a/llm/Lib/site-packages/langchain_community/utilities/portkey.py b/llm/Lib/site-packages/langchain_community/utilities/portkey.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf9044c4f15ce8624eb535e65b317d395f0d274a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/portkey.py
@@ -0,0 +1,75 @@
+import json
+import os
+from typing import Dict, Optional
+
+
+class Portkey:
+    """Portkey configuration.
+
+    Attributes:
+        base: The base URL for the Portkey API.
+          Default: "https://api.portkey.ai/v1/proxy"
+    """
+
+    base = "https://api.portkey.ai/v1/proxy"
+
+    @staticmethod
+    def Config(
+        api_key: str,
+        trace_id: Optional[str] = None,
+        environment: Optional[str] = None,
+        user: Optional[str] = None,
+        organisation: Optional[str] = None,
+        prompt: Optional[str] = None,
+        retry_count: Optional[int] = None,
+        cache: Optional[str] = None,
+        cache_force_refresh: Optional[str] = None,
+        cache_age: Optional[int] = None,
+    ) -> Dict[str, str]:
+        assert retry_count is None or retry_count in range(
+            1, 6
+        ), "retry_count must be an integer and in range [1, 2, 3, 4, 5]"
+        assert cache is None or cache in [
+            "simple",
+            "semantic",
+        ], "cache must be 'simple' or 'semantic'"
+        assert cache_force_refresh is None or (
+            isinstance(cache_force_refresh, str)
+            and cache_force_refresh in ["True", "False"]
+        ), "cache_force_refresh must be 'True' or 'False'"
+        assert cache_age is None or isinstance(
+            cache_age, int
+        ), "cache_age must be an integer"
+
+        os.environ["OPENAI_API_BASE"] = Portkey.base
+
+        headers = {
+            "x-portkey-api-key": api_key,
+            "x-portkey-mode": "proxy openai",
+        }
+
+        if trace_id:
+            headers["x-portkey-trace-id"] = trace_id
+        if retry_count:
+            headers["x-portkey-retry-count"] = str(retry_count)
+        if cache:
+            headers["x-portkey-cache"] = cache
+        if cache_force_refresh:
+            headers["x-portkey-cache-force-refresh"] = cache_force_refresh
+        if cache_age:
+            headers["Cache-Control"] = f"max-age:{str(cache_age)}"
+
+        metadata = {}
+        if environment:
+            metadata["_environment"] = environment
+        if user:
+            metadata["_user"] = user
+        if organisation:
+            metadata["_organisation"] = organisation
+        if prompt:
+            metadata["_prompt"] = prompt
+
+        if metadata:
+            headers.update({"x-portkey-metadata": json.dumps(metadata)})
+
+        return headers
diff --git a/llm/Lib/site-packages/langchain_community/utilities/powerbi.py b/llm/Lib/site-packages/langchain_community/utilities/powerbi.py
new file mode 100644
index 0000000000000000000000000000000000000000..88219936260e4fa1b822bafee527acc9e31acd39
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/powerbi.py
@@ -0,0 +1,276 @@
+"""Wrapper around a Power BI endpoint."""
+from __future__ import annotations
+
+import asyncio
+import logging
+import os
+from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Optional, Union
+
+import aiohttp
+import requests
+from aiohttp import ServerTimeoutError
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator, validator
+from requests.exceptions import Timeout
+
+logger = logging.getLogger(__name__)
+
+BASE_URL = os.getenv("POWERBI_BASE_URL", "https://api.powerbi.com/v1.0/myorg")
+
+if TYPE_CHECKING:
+    from azure.core.credentials import TokenCredential
+
+
+class PowerBIDataset(BaseModel):
+    """Create PowerBI engine from dataset ID and credential or token.
+
+    Use either the credential or a supplied token to authenticate.
+    If both are supplied the credential is used to generate a token.
+    The impersonated_user_name is the UPN of a user to be impersonated.
+    If the model is not RLS enabled, this will be ignored.
+    """
+
+    dataset_id: str
+    table_names: List[str]
+    group_id: Optional[str] = None
+    credential: Optional[TokenCredential] = None
+    token: Optional[str] = None
+    impersonated_user_name: Optional[str] = None
+    sample_rows_in_table_info: int = Field(default=1, gt=0, le=10)
+    schemas: Dict[str, str] = Field(default_factory=dict)
+    aiosession: Optional[aiohttp.ClientSession] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @validator("table_names", allow_reuse=True)
+    def fix_table_names(cls, table_names: List[str]) -> List[str]:
+        """Fix the table names."""
+        return [fix_table_name(table) for table in table_names]
+
+    @root_validator(pre=True, allow_reuse=True)
+    def token_or_credential_present(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Validate that at least one of token and credentials is present."""
+        if "token" in values or "credential" in values:
+            return values
+        raise ValueError("Please provide either a credential or a token.")
+
+    @property
+    def request_url(self) -> str:
+        """Get the request url."""
+        if self.group_id:
+            return f"{BASE_URL}/groups/{self.group_id}/datasets/{self.dataset_id}/executeQueries"  # noqa: E501 # pylint: disable=C0301
+        return f"{BASE_URL}/datasets/{self.dataset_id}/executeQueries"  # noqa: E501 # pylint: disable=C0301
+
+    @property
+    def headers(self) -> Dict[str, str]:
+        """Get the token."""
+        if self.token:
+            return {
+                "Content-Type": "application/json",
+                "Authorization": "Bearer " + self.token,
+            }
+        from azure.core.exceptions import (
+            ClientAuthenticationError,  # pylint: disable=import-outside-toplevel
+        )
+
+        if self.credential:
+            try:
+                token = self.credential.get_token(
+                    "https://analysis.windows.net/powerbi/api/.default"
+                ).token
+                return {
+                    "Content-Type": "application/json",
+                    "Authorization": "Bearer " + token,
+                }
+            except Exception as exc:  # pylint: disable=broad-exception-caught
+                raise ClientAuthenticationError(
+                    "Could not get a token from the supplied credentials."
+                ) from exc
+        raise ClientAuthenticationError("No credential or token supplied.")
+
+    def get_table_names(self) -> Iterable[str]:
+        """Get names of tables available."""
+        return self.table_names
+
+    def get_schemas(self) -> str:
+        """Get the available schema's."""
+        if self.schemas:
+            return ", ".join([f"{key}: {value}" for key, value in self.schemas.items()])
+        return "No known schema's yet. Use the schema_powerbi tool first."
+
+    @property
+    def table_info(self) -> str:
+        """Information about all tables in the database."""
+        return self.get_table_info()
+
+    def _get_tables_to_query(
+        self, table_names: Optional[Union[List[str], str]] = None
+    ) -> Optional[List[str]]:
+        """Get the tables names that need to be queried, after checking they exist."""
+        if table_names is not None:
+            if (
+                isinstance(table_names, list)
+                and len(table_names) > 0
+                and table_names[0] != ""
+            ):
+                fixed_tables = [fix_table_name(table) for table in table_names]
+                non_existing_tables = [
+                    table for table in fixed_tables if table not in self.table_names
+                ]
+                if non_existing_tables:
+                    logger.warning(
+                        "Table(s) %s not found in dataset.",
+                        ", ".join(non_existing_tables),
+                    )
+                tables = [
+                    table for table in fixed_tables if table not in non_existing_tables
+                ]
+                return tables if tables else None
+            if isinstance(table_names, str) and table_names != "":
+                if table_names not in self.table_names:
+                    logger.warning("Table %s not found in dataset.", table_names)
+                    return None
+                return [fix_table_name(table_names)]
+        return self.table_names
+
+    def _get_tables_todo(self, tables_todo: List[str]) -> List[str]:
+        """Get the tables that still need to be queried."""
+        return [table for table in tables_todo if table not in self.schemas]
+
+    def _get_schema_for_tables(self, table_names: List[str]) -> str:
+        """Create a string of the table schemas for the supplied tables."""
+        schemas = [
+            schema for table, schema in self.schemas.items() if table in table_names
+        ]
+        return ", ".join(schemas)
+
+    def get_table_info(
+        self, table_names: Optional[Union[List[str], str]] = None
+    ) -> str:
+        """Get information about specified tables."""
+        tables_requested = self._get_tables_to_query(table_names)
+        if tables_requested is None:
+            return "No (valid) tables requested."
+        tables_todo = self._get_tables_todo(tables_requested)
+        for table in tables_todo:
+            self._get_schema(table)
+        return self._get_schema_for_tables(tables_requested)
+
+    async def aget_table_info(
+        self, table_names: Optional[Union[List[str], str]] = None
+    ) -> str:
+        """Get information about specified tables."""
+        tables_requested = self._get_tables_to_query(table_names)
+        if tables_requested is None:
+            return "No (valid) tables requested."
+        tables_todo = self._get_tables_todo(tables_requested)
+        await asyncio.gather(*[self._aget_schema(table) for table in tables_todo])
+        return self._get_schema_for_tables(tables_requested)
+
+    def _get_schema(self, table: str) -> None:
+        """Get the schema for a table."""
+        try:
+            result = self.run(
+                f"EVALUATE TOPN({self.sample_rows_in_table_info}, {table})"
+            )
+            self.schemas[table] = json_to_md(result["results"][0]["tables"][0]["rows"])
+        except Timeout:
+            logger.warning("Timeout while getting table info for %s", table)
+            self.schemas[table] = "unknown"
+        except Exception as exc:  # pylint: disable=broad-exception-caught
+            logger.warning("Error while getting table info for %s: %s", table, exc)
+            self.schemas[table] = "unknown"
+
+    async def _aget_schema(self, table: str) -> None:
+        """Get the schema for a table."""
+        try:
+            result = await self.arun(
+                f"EVALUATE TOPN({self.sample_rows_in_table_info}, {table})"
+            )
+            self.schemas[table] = json_to_md(result["results"][0]["tables"][0]["rows"])
+        except ServerTimeoutError:
+            logger.warning("Timeout while getting table info for %s", table)
+            self.schemas[table] = "unknown"
+        except Exception as exc:  # pylint: disable=broad-exception-caught
+            logger.warning("Error while getting table info for %s: %s", table, exc)
+            self.schemas[table] = "unknown"
+
+    def _create_json_content(self, command: str) -> dict[str, Any]:
+        """Create the json content for the request."""
+        return {
+            "queries": [{"query": rf"{command}"}],
+            "impersonatedUserName": self.impersonated_user_name,
+            "serializerSettings": {"includeNulls": True},
+        }
+
+    def run(self, command: str) -> Any:
+        """Execute a DAX command and return a json representing the results."""
+        logger.debug("Running command: %s", command)
+        response = requests.post(
+            self.request_url,
+            json=self._create_json_content(command),
+            headers=self.headers,
+            timeout=10,
+        )
+        if response.status_code == 403:
+            return (
+                "TokenError: Could not login to PowerBI, please check your credentials."
+            )
+        return response.json()
+
+    async def arun(self, command: str) -> Any:
+        """Execute a DAX command and return the result asynchronously."""
+        logger.debug("Running command: %s", command)
+        if self.aiosession:
+            async with self.aiosession.post(
+                self.request_url,
+                headers=self.headers,
+                json=self._create_json_content(command),
+                timeout=10,
+            ) as response:
+                if response.status == 403:
+                    return "TokenError: Could not login to PowerBI, please check your credentials."  # noqa: E501
+                response_json = await response.json(content_type=response.content_type)
+                return response_json
+        async with aiohttp.ClientSession() as session:
+            async with session.post(
+                self.request_url,
+                headers=self.headers,
+                json=self._create_json_content(command),
+                timeout=10,
+            ) as response:
+                if response.status == 403:
+                    return "TokenError: Could not login to PowerBI, please check your credentials."  # noqa: E501
+                response_json = await response.json(content_type=response.content_type)
+                return response_json
+
+
+def json_to_md(
+    json_contents: List[Dict[str, Union[str, int, float]]],
+    table_name: Optional[str] = None,
+) -> str:
+    """Converts a JSON object to a markdown table."""
+    if len(json_contents) == 0:
+        return ""
+    output_md = ""
+    headers = json_contents[0].keys()
+    for header in headers:
+        header.replace("[", ".").replace("]", "")
+        if table_name:
+            header.replace(f"{table_name}.", "")
+        output_md += f"| {header} "
+    output_md += "|\n"
+    for row in json_contents:
+        for value in row.values():
+            output_md += f"| {value} "
+        output_md += "|\n"
+    return output_md
+
+
+def fix_table_name(table: str) -> str:
+    """Add single quotes around table names that contain spaces."""
+    if " " in table and not table.startswith("'") and not table.endswith("'"):
+        return f"'{table}'"
+    return table
diff --git a/llm/Lib/site-packages/langchain_community/utilities/pubmed.py b/llm/Lib/site-packages/langchain_community/utilities/pubmed.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b67f2597353d334cb98de9f8f34b296a3b55873
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/pubmed.py
@@ -0,0 +1,200 @@
+import json
+import logging
+import time
+import urllib.error
+import urllib.parse
+import urllib.request
+from typing import Any, Dict, Iterator, List
+
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+logger = logging.getLogger(__name__)
+
+
+class PubMedAPIWrapper(BaseModel):
+    """
+    Wrapper around PubMed API.
+
+    This wrapper will use the PubMed API to conduct searches and fetch
+    document summaries. By default, it will return the document summaries
+    of the top-k results of an input search.
+
+    Parameters:
+        top_k_results: number of the top-scored document used for the PubMed tool
+        MAX_QUERY_LENGTH: maximum length of the query.
+          Default is 300 characters.
+        doc_content_chars_max: maximum length of the document content.
+          Content will be truncated if it exceeds this length.
+          Default is 2000 characters.
+        max_retry: maximum number of retries for a request. Default is 5.
+        sleep_time: time to wait between retries.
+          Default is 0.2 seconds.
+        email: email address to be used for the PubMed API.
+    """
+
+    parse: Any  #: :meta private:
+
+    base_url_esearch: str = (
+        "https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgi?"
+    )
+    base_url_efetch: str = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils/efetch.fcgi?"
+    max_retry: int = 5
+    sleep_time: float = 0.2
+
+    # Default values for the parameters
+    top_k_results: int = 3
+    MAX_QUERY_LENGTH: int = 300
+    doc_content_chars_max: int = 2000
+    email: str = "your_email@example.com"
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in environment."""
+        try:
+            import xmltodict
+
+            values["parse"] = xmltodict.parse
+        except ImportError:
+            raise ImportError(
+                "Could not import xmltodict python package. "
+                "Please install it with `pip install xmltodict`."
+            )
+        return values
+
+    def run(self, query: str) -> str:
+        """
+        Run PubMed search and get the article meta information.
+        See https://www.ncbi.nlm.nih.gov/books/NBK25499/#chapter4.ESearch
+        It uses only the most informative fields of article meta information.
+        """
+
+        try:
+            # Retrieve the top-k results for the query
+            docs = [
+                f"Published: {result['Published']}\n"
+                f"Title: {result['Title']}\n"
+                f"Copyright Information: {result['Copyright Information']}\n"
+                f"Summary::\n{result['Summary']}"
+                for result in self.load(query[: self.MAX_QUERY_LENGTH])
+            ]
+
+            # Join the results and limit the character count
+            return (
+                "\n\n".join(docs)[: self.doc_content_chars_max]
+                if docs
+                else "No good PubMed Result was found"
+            )
+        except Exception as ex:
+            return f"PubMed exception: {ex}"
+
+    def lazy_load(self, query: str) -> Iterator[dict]:
+        """
+        Search PubMed for documents matching the query.
+        Return an iterator of dictionaries containing the document metadata.
+        """
+
+        url = (
+            self.base_url_esearch
+            + "db=pubmed&term="
+            + str({urllib.parse.quote(query)})
+            + f"&retmode=json&retmax={self.top_k_results}&usehistory=y"
+        )
+        result = urllib.request.urlopen(url)
+        text = result.read().decode("utf-8")
+        json_text = json.loads(text)
+
+        webenv = json_text["esearchresult"]["webenv"]
+        for uid in json_text["esearchresult"]["idlist"]:
+            yield self.retrieve_article(uid, webenv)
+
+    def load(self, query: str) -> List[dict]:
+        """
+        Search PubMed for documents matching the query.
+        Return a list of dictionaries containing the document metadata.
+        """
+        return list(self.lazy_load(query))
+
+    def _dict2document(self, doc: dict) -> Document:
+        summary = doc.pop("Summary")
+        return Document(page_content=summary, metadata=doc)
+
+    def lazy_load_docs(self, query: str) -> Iterator[Document]:
+        for d in self.lazy_load(query=query):
+            yield self._dict2document(d)
+
+    def load_docs(self, query: str) -> List[Document]:
+        return list(self.lazy_load_docs(query=query))
+
+    def retrieve_article(self, uid: str, webenv: str) -> dict:
+        url = (
+            self.base_url_efetch
+            + "db=pubmed&retmode=xml&id="
+            + uid
+            + "&webenv="
+            + webenv
+        )
+
+        retry = 0
+        while True:
+            try:
+                result = urllib.request.urlopen(url)
+                break
+            except urllib.error.HTTPError as e:
+                if e.code == 429 and retry < self.max_retry:
+                    # Too Many Requests errors
+                    # wait for an exponentially increasing amount of time
+                    print(  # noqa: T201
+                        f"Too Many Requests, "
+                        f"waiting for {self.sleep_time:.2f} seconds..."
+                    )
+                    time.sleep(self.sleep_time)
+                    self.sleep_time *= 2
+                    retry += 1
+                else:
+                    raise e
+
+        xml_text = result.read().decode("utf-8")
+        text_dict = self.parse(xml_text)
+        return self._parse_article(uid, text_dict)
+
+    def _parse_article(self, uid: str, text_dict: dict) -> dict:
+        try:
+            ar = text_dict["PubmedArticleSet"]["PubmedArticle"]["MedlineCitation"][
+                "Article"
+            ]
+        except KeyError:
+            ar = text_dict["PubmedArticleSet"]["PubmedBookArticle"]["BookDocument"]
+        abstract_text = ar.get("Abstract", {}).get("AbstractText", [])
+        summaries = [
+            f"{txt['@Label']}: {txt['#text']}"
+            for txt in abstract_text
+            if "#text" in txt and "@Label" in txt
+        ]
+        summary = (
+            "\n".join(summaries)
+            if summaries
+            else (
+                abstract_text
+                if isinstance(abstract_text, str)
+                else (
+                    "\n".join(str(value) for value in abstract_text.values())
+                    if isinstance(abstract_text, dict)
+                    else "No abstract available"
+                )
+            )
+        )
+        a_d = ar.get("ArticleDate", {})
+        pub_date = "-".join(
+            [a_d.get("Year", ""), a_d.get("Month", ""), a_d.get("Day", "")]
+        )
+
+        return {
+            "uid": uid,
+            "Title": ar.get("ArticleTitle", ""),
+            "Published": pub_date,
+            "Copyright Information": ar.get("Abstract", {}).get(
+                "CopyrightInformation", ""
+            ),
+            "Summary": summary,
+        }
diff --git a/llm/Lib/site-packages/langchain_community/utilities/python.py b/llm/Lib/site-packages/langchain_community/utilities/python.py
new file mode 100644
index 0000000000000000000000000000000000000000..70c3119e5f6a12aab56e8f34c47ca8896b1b148f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/python.py
@@ -0,0 +1,71 @@
+import functools
+import logging
+import multiprocessing
+import sys
+from io import StringIO
+from typing import Dict, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, Field
+
+logger = logging.getLogger(__name__)
+
+
+@functools.lru_cache(maxsize=None)
+def warn_once() -> None:
+    """Warn once about the dangers of PythonREPL."""
+    logger.warning("Python REPL can execute arbitrary code. Use with caution.")
+
+
+class PythonREPL(BaseModel):
+    """Simulates a standalone Python REPL."""
+
+    globals: Optional[Dict] = Field(default_factory=dict, alias="_globals")
+    locals: Optional[Dict] = Field(default_factory=dict, alias="_locals")
+
+    @classmethod
+    def worker(
+        cls,
+        command: str,
+        globals: Optional[Dict],
+        locals: Optional[Dict],
+        queue: multiprocessing.Queue,
+    ) -> None:
+        old_stdout = sys.stdout
+        sys.stdout = mystdout = StringIO()
+        try:
+            exec(command, globals, locals)
+            sys.stdout = old_stdout
+            queue.put(mystdout.getvalue())
+        except Exception as e:
+            sys.stdout = old_stdout
+            queue.put(repr(e))
+
+    def run(self, command: str, timeout: Optional[int] = None) -> str:
+        """Run command with own globals/locals and returns anything printed.
+        Timeout after the specified number of seconds."""
+
+        # Warn against dangers of PythonREPL
+        warn_once()
+
+        queue: multiprocessing.Queue = multiprocessing.Queue()
+
+        # Only use multiprocessing if we are enforcing a timeout
+        if timeout is not None:
+            # create a Process
+            p = multiprocessing.Process(
+                target=self.worker, args=(command, self.globals, self.locals, queue)
+            )
+
+            # start it
+            p.start()
+
+            # wait for the process to finish or kill it after timeout seconds
+            p.join(timeout)
+
+            if p.is_alive():
+                p.terminate()
+                return "Execution timed out"
+        else:
+            self.worker(command, self.globals, self.locals, queue)
+        # get the result from the worker function
+        return queue.get()
diff --git a/llm/Lib/site-packages/langchain_community/utilities/reddit_search.py b/llm/Lib/site-packages/langchain_community/utilities/reddit_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..e17971b1b2c67b7575ed3bcd62aff7a94bd48966
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/reddit_search.py
@@ -0,0 +1,121 @@
+"""Wrapper for the Reddit API"""
+
+from typing import Any, Dict, List, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class RedditSearchAPIWrapper(BaseModel):
+    """Wrapper for Reddit API
+
+    To use, set the environment variables ``REDDIT_CLIENT_ID``,
+    ``REDDIT_CLIENT_SECRET``, ``REDDIT_USER_AGENT`` to set the client ID,
+    client secret, and user agent, respectively, as given by Reddit's API.
+    Alternatively, all three can be supplied as named parameters in the
+    constructor: ``reddit_client_id``, ``reddit_client_secret``, and
+    ``reddit_user_agent``, respectively.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.utilities import RedditSearchAPIWrapper
+            reddit_search = RedditSearchAPIWrapper()
+    """
+
+    reddit_client: Any
+
+    # Values required to access Reddit API via praw
+    reddit_client_id: Optional[str]
+    reddit_client_secret: Optional[str]
+    reddit_user_agent: Optional[str]
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the API ID, secret and user agent exists in environment
+        and check that praw module is present.
+        """
+        reddit_client_id = get_from_dict_or_env(
+            values, "reddit_client_id", "REDDIT_CLIENT_ID"
+        )
+        values["reddit_client_id"] = reddit_client_id
+
+        reddit_client_secret = get_from_dict_or_env(
+            values, "reddit_client_secret", "REDDIT_CLIENT_SECRET"
+        )
+        values["reddit_client_secret"] = reddit_client_secret
+
+        reddit_user_agent = get_from_dict_or_env(
+            values, "reddit_user_agent", "REDDIT_USER_AGENT"
+        )
+        values["reddit_user_agent"] = reddit_user_agent
+
+        try:
+            import praw
+        except ImportError:
+            raise ImportError(
+                "praw package not found, please install it with pip install praw"
+            )
+
+        reddit_client = praw.Reddit(
+            client_id=reddit_client_id,
+            client_secret=reddit_client_secret,
+            user_agent=reddit_user_agent,
+        )
+        values["reddit_client"] = reddit_client
+
+        return values
+
+    def run(
+        self, query: str, sort: str, time_filter: str, subreddit: str, limit: int
+    ) -> str:
+        """Search Reddit and return posts as a single string."""
+        results: List[Dict] = self.results(
+            query=query,
+            sort=sort,
+            time_filter=time_filter,
+            subreddit=subreddit,
+            limit=limit,
+        )
+        if len(results) > 0:
+            output: List[str] = [f"Searching r/{subreddit} found {len(results)} posts:"]
+            for r in results:
+                category = "N/A" if r["post_category"] is None else r["post_category"]
+                p = f"Post Title: '{r['post_title']}'\n\
+                    User: {r['post_author']}\n\
+                    Subreddit: {r['post_subreddit']}:\n\
+                    Text body: {r['post_text']}\n\
+                    Post URL: {r['post_url']}\n\
+                    Post Category: {category}.\n\
+                    Score: {r['post_score']}\n"
+                output.append(p)
+            return "\n".join(output)
+        else:
+            return f"Searching r/{subreddit} did not find any posts:"
+
+    def results(
+        self, query: str, sort: str, time_filter: str, subreddit: str, limit: int
+    ) -> List[Dict]:
+        """Use praw to search Reddit and return a list of dictionaries,
+        one for each post.
+        """
+        subredditObject = self.reddit_client.subreddit(subreddit)
+        search_results = subredditObject.search(
+            query=query, sort=sort, time_filter=time_filter, limit=limit
+        )
+        search_results = [r for r in search_results]
+        results_object = []
+        for submission in search_results:
+            results_object.append(
+                {
+                    "post_subreddit": submission.subreddit_name_prefixed,
+                    "post_category": submission.category,
+                    "post_title": submission.title,
+                    "post_text": submission.selftext,
+                    "post_score": submission.score,
+                    "post_id": submission.id,
+                    "post_url": submission.url,
+                    "post_author": submission.author,
+                }
+            )
+        return results_object
diff --git a/llm/Lib/site-packages/langchain_community/utilities/redis.py b/llm/Lib/site-packages/langchain_community/utilities/redis.py
new file mode 100644
index 0000000000000000000000000000000000000000..5b613667b6471254f9395bb5458e32e85af0b53f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/redis.py
@@ -0,0 +1,217 @@
+from __future__ import annotations
+
+import logging
+import re
+from typing import TYPE_CHECKING, Any, List, Optional, Pattern
+from urllib.parse import urlparse
+
+import numpy as np
+
+logger = logging.getLogger(__name__)
+
+if TYPE_CHECKING:
+    from redis.client import Redis as RedisType
+
+
+def _array_to_buffer(array: List[float], dtype: Any = np.float32) -> bytes:
+    return np.array(array).astype(dtype).tobytes()
+
+
+def _buffer_to_array(buffer: bytes, dtype: Any = np.float32) -> List[float]:
+    return np.frombuffer(buffer, dtype=dtype).tolist()
+
+
+class TokenEscaper:
+    """
+    Escape punctuation within an input string.
+    """
+
+    # Characters that RediSearch requires us to escape during queries.
+    # Source: https://redis.io/docs/stack/search/reference/escaping/#the-rules-of-text-field-tokenization
+    DEFAULT_ESCAPED_CHARS = r"[,.<>{}\[\]\\\"\':;!@#$%^&*()\-+=~\/ ]"
+
+    def __init__(self, escape_chars_re: Optional[Pattern] = None):
+        if escape_chars_re:
+            self.escaped_chars_re = escape_chars_re
+        else:
+            self.escaped_chars_re = re.compile(self.DEFAULT_ESCAPED_CHARS)
+
+    def escape(self, value: str) -> str:
+        if not isinstance(value, str):
+            raise TypeError(
+                "Value must be a string object for token escaping."
+                f"Got type {type(value)}"
+            )
+
+        def escape_symbol(match: re.Match) -> str:
+            value = match.group(0)
+            return f"\\{value}"
+
+        return self.escaped_chars_re.sub(escape_symbol, value)
+
+
+def check_redis_module_exist(client: RedisType, required_modules: List[dict]) -> None:
+    """Check if the correct Redis modules are installed."""
+    installed_modules = client.module_list()
+    installed_modules = {
+        module[b"name"].decode("utf-8"): module for module in installed_modules
+    }
+    for module in required_modules:
+        if module["name"] in installed_modules and int(
+            installed_modules[module["name"]][b"ver"]
+        ) >= int(module["ver"]):
+            return
+    # otherwise raise error
+    error_message = (
+        "Redis cannot be used as a vector database without RediSearch >=2.4"
+        "Please head to https://redis.io/docs/stack/search/quick_start/"
+        "to know more about installing the RediSearch module within Redis Stack."
+    )
+    logger.error(error_message)
+    raise ValueError(error_message)
+
+
+def get_client(redis_url: str, **kwargs: Any) -> RedisType:
+    """Get a redis client from the connection url given. This helper accepts
+    urls for Redis server (TCP with/without TLS or UnixSocket) as well as
+    Redis Sentinel connections.
+
+    Redis Cluster is not supported.
+
+    Before creating a connection the existence of the database driver is checked
+    an and ValueError raised otherwise
+
+    To use, you should have the ``redis`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.utilities.redis import get_client
+            redis_client = get_client(
+                redis_url="redis://username:password@localhost:6379"
+                index_name="my-index",
+                embedding_function=embeddings.embed_query,
+            )
+
+    To use a redis replication setup with multiple redis server and redis sentinels
+    set "redis_url" to "redis+sentinel://" scheme. With this url format a path is
+    needed holding the name of the redis service within the sentinels to get the
+    correct redis server connection. The default service name is "mymaster". The
+    optional second part of the path is the redis db number to connect to.
+
+    An optional username or password is used for booth connections to the rediserver
+    and the sentinel, different passwords for server and sentinel are not supported.
+    And as another constraint only one sentinel instance can be given:
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.utilities.redis import get_client
+            redis_client = get_client(
+                redis_url="redis+sentinel://username:password@sentinelhost:26379/mymaster/0"
+                index_name="my-index",
+                embedding_function=embeddings.embed_query,
+            )
+    """
+
+    # Initialize with necessary components.
+    try:
+        import redis
+    except ImportError:
+        raise ImportError(
+            "Could not import redis python package. "
+            "Please install it with `pip install redis>=4.1.0`."
+        )
+
+    # check if normal redis:// or redis+sentinel:// url
+    if redis_url.startswith("redis+sentinel"):
+        redis_client = _redis_sentinel_client(redis_url, **kwargs)
+    elif redis_url.startswith("rediss+sentinel"):  # sentinel with TLS support enables
+        kwargs["ssl"] = True
+        if "ssl_cert_reqs" not in kwargs:
+            kwargs["ssl_cert_reqs"] = "none"
+        redis_client = _redis_sentinel_client(redis_url, **kwargs)
+    else:
+        # connect to redis server from url, reconnect with cluster client if needed
+        redis_client = redis.from_url(redis_url, **kwargs)
+        if _check_for_cluster(redis_client):
+            redis_client.close()
+            redis_client = _redis_cluster_client(redis_url, **kwargs)
+    return redis_client
+
+
+def _redis_sentinel_client(redis_url: str, **kwargs: Any) -> RedisType:
+    """helper method to parse an (un-official) redis+sentinel url
+    and create a Sentinel connection to fetch the final redis client
+    connection to a replica-master for read-write operations.
+
+    If username and/or password for authentication is given the
+    same credentials are used for the Redis Sentinel as well as Redis Server.
+    With this implementation using a redis url only it is not possible
+    to use different data for authentication on booth systems.
+    """
+    import redis
+
+    parsed_url = urlparse(redis_url)
+    # sentinel needs list with (host, port) tuple, use default port if none available
+    sentinel_list = [(parsed_url.hostname or "localhost", parsed_url.port or 26379)]
+    if parsed_url.path:
+        # "/mymaster/0" first part is service name, optional second part is db number
+        path_parts = parsed_url.path.split("/")
+        service_name = path_parts[1] or "mymaster"
+        if len(path_parts) > 2:
+            kwargs["db"] = path_parts[2]
+    else:
+        service_name = "mymaster"
+
+    sentinel_args = {}
+    if parsed_url.password:
+        sentinel_args["password"] = parsed_url.password
+        kwargs["password"] = parsed_url.password
+    if parsed_url.username:
+        sentinel_args["username"] = parsed_url.username
+        kwargs["username"] = parsed_url.username
+
+    # check for all SSL related properties and copy them into sentinel_kwargs too,
+    # add client_name also
+    for arg in kwargs:
+        if arg.startswith("ssl") or arg == "client_name":
+            sentinel_args[arg] = kwargs[arg]
+
+    # sentinel user/pass is part of sentinel_kwargs, user/pass for redis server
+    # connection as direct parameter in kwargs
+    sentinel_client = redis.sentinel.Sentinel(
+        sentinel_list, sentinel_kwargs=sentinel_args, **kwargs
+    )
+
+    # redis server might have password but not sentinel - fetch this error and try
+    # again without pass, everything else cannot be handled here -> user needed
+    try:
+        sentinel_client.execute_command("ping")
+    except redis.exceptions.AuthenticationError as ae:
+        if "no password is set" in ae.args[0]:
+            logger.warning(
+                "Redis sentinel connection configured with password but Sentinel \
+answered NO PASSWORD NEEDED - Please check Sentinel configuration"
+            )
+            sentinel_client = redis.sentinel.Sentinel(sentinel_list, **kwargs)
+        else:
+            raise ae
+
+    return sentinel_client.master_for(service_name)
+
+
+def _check_for_cluster(redis_client: RedisType) -> bool:
+    import redis
+
+    try:
+        cluster_info = redis_client.info("cluster")
+        return cluster_info["cluster_enabled"] == 1
+    except redis.exceptions.RedisError:
+        return False
+
+
+def _redis_cluster_client(redis_url: str, **kwargs: Any) -> RedisType:
+    from redis.cluster import RedisCluster
+
+    return RedisCluster.from_url(redis_url, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/utilities/requests.py b/llm/Lib/site-packages/langchain_community/utilities/requests.py
new file mode 100644
index 0000000000000000000000000000000000000000..f265549bd698e6db35e85aa95e671398b7c65de2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/requests.py
@@ -0,0 +1,225 @@
+"""Lightweight wrapper around requests library, with async support."""
+from contextlib import asynccontextmanager
+from typing import Any, AsyncGenerator, Dict, Literal, Optional, Union
+
+import aiohttp
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra
+from requests import Response
+
+
+class Requests(BaseModel):
+    """Wrapper around requests to handle auth and async.
+
+    The main purpose of this wrapper is to handle authentication (by saving
+    headers) and enable easy async methods on the same base object.
+    """
+
+    headers: Optional[Dict[str, str]] = None
+    aiosession: Optional[aiohttp.ClientSession] = None
+    auth: Optional[Any] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    def get(self, url: str, **kwargs: Any) -> requests.Response:
+        """GET the URL and return the text."""
+        return requests.get(url, headers=self.headers, auth=self.auth, **kwargs)
+
+    def post(self, url: str, data: Dict[str, Any], **kwargs: Any) -> requests.Response:
+        """POST to the URL and return the text."""
+        return requests.post(
+            url, json=data, headers=self.headers, auth=self.auth, **kwargs
+        )
+
+    def patch(self, url: str, data: Dict[str, Any], **kwargs: Any) -> requests.Response:
+        """PATCH the URL and return the text."""
+        return requests.patch(
+            url, json=data, headers=self.headers, auth=self.auth, **kwargs
+        )
+
+    def put(self, url: str, data: Dict[str, Any], **kwargs: Any) -> requests.Response:
+        """PUT the URL and return the text."""
+        return requests.put(
+            url, json=data, headers=self.headers, auth=self.auth, **kwargs
+        )
+
+    def delete(self, url: str, **kwargs: Any) -> requests.Response:
+        """DELETE the URL and return the text."""
+        return requests.delete(url, headers=self.headers, auth=self.auth, **kwargs)
+
+    @asynccontextmanager
+    async def _arequest(
+        self, method: str, url: str, **kwargs: Any
+    ) -> AsyncGenerator[aiohttp.ClientResponse, None]:
+        """Make an async request."""
+        if not self.aiosession:
+            async with aiohttp.ClientSession() as session:
+                async with session.request(
+                    method, url, headers=self.headers, auth=self.auth, **kwargs
+                ) as response:
+                    yield response
+        else:
+            async with self.aiosession.request(
+                method, url, headers=self.headers, auth=self.auth, **kwargs
+            ) as response:
+                yield response
+
+    @asynccontextmanager
+    async def aget(
+        self, url: str, **kwargs: Any
+    ) -> AsyncGenerator[aiohttp.ClientResponse, None]:
+        """GET the URL and return the text asynchronously."""
+        async with self._arequest("GET", url, **kwargs) as response:
+            yield response
+
+    @asynccontextmanager
+    async def apost(
+        self, url: str, data: Dict[str, Any], **kwargs: Any
+    ) -> AsyncGenerator[aiohttp.ClientResponse, None]:
+        """POST to the URL and return the text asynchronously."""
+        async with self._arequest("POST", url, json=data, **kwargs) as response:
+            yield response
+
+    @asynccontextmanager
+    async def apatch(
+        self, url: str, data: Dict[str, Any], **kwargs: Any
+    ) -> AsyncGenerator[aiohttp.ClientResponse, None]:
+        """PATCH the URL and return the text asynchronously."""
+        async with self._arequest("PATCH", url, json=data, **kwargs) as response:
+            yield response
+
+    @asynccontextmanager
+    async def aput(
+        self, url: str, data: Dict[str, Any], **kwargs: Any
+    ) -> AsyncGenerator[aiohttp.ClientResponse, None]:
+        """PUT the URL and return the text asynchronously."""
+        async with self._arequest("PUT", url, json=data, **kwargs) as response:
+            yield response
+
+    @asynccontextmanager
+    async def adelete(
+        self, url: str, **kwargs: Any
+    ) -> AsyncGenerator[aiohttp.ClientResponse, None]:
+        """DELETE the URL and return the text asynchronously."""
+        async with self._arequest("DELETE", url, **kwargs) as response:
+            yield response
+
+
+class GenericRequestsWrapper(BaseModel):
+    """Lightweight wrapper around requests library."""
+
+    headers: Optional[Dict[str, str]] = None
+    aiosession: Optional[aiohttp.ClientSession] = None
+    auth: Optional[Any] = None
+    response_content_type: Literal["text", "json"] = "text"
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @property
+    def requests(self) -> Requests:
+        return Requests(
+            headers=self.headers, aiosession=self.aiosession, auth=self.auth
+        )
+
+    def _get_resp_content(self, response: Response) -> Union[str, Dict[str, Any]]:
+        if self.response_content_type == "text":
+            return response.text
+        elif self.response_content_type == "json":
+            return response.json()
+        else:
+            raise ValueError(f"Invalid return type: {self.response_content_type}")
+
+    async def _aget_resp_content(
+        self, response: aiohttp.ClientResponse
+    ) -> Union[str, Dict[str, Any]]:
+        if self.response_content_type == "text":
+            return await response.text()
+        elif self.response_content_type == "json":
+            return await response.json()
+        else:
+            raise ValueError(f"Invalid return type: {self.response_content_type}")
+
+    def get(self, url: str, **kwargs: Any) -> Union[str, Dict[str, Any]]:
+        """GET the URL and return the text."""
+        return self._get_resp_content(self.requests.get(url, **kwargs))
+
+    def post(
+        self, url: str, data: Dict[str, Any], **kwargs: Any
+    ) -> Union[str, Dict[str, Any]]:
+        """POST to the URL and return the text."""
+        return self._get_resp_content(self.requests.post(url, data, **kwargs))
+
+    def patch(
+        self, url: str, data: Dict[str, Any], **kwargs: Any
+    ) -> Union[str, Dict[str, Any]]:
+        """PATCH the URL and return the text."""
+        return self._get_resp_content(self.requests.patch(url, data, **kwargs))
+
+    def put(
+        self, url: str, data: Dict[str, Any], **kwargs: Any
+    ) -> Union[str, Dict[str, Any]]:
+        """PUT the URL and return the text."""
+        return self._get_resp_content(self.requests.put(url, data, **kwargs))
+
+    def delete(self, url: str, **kwargs: Any) -> Union[str, Dict[str, Any]]:
+        """DELETE the URL and return the text."""
+        return self._get_resp_content(self.requests.delete(url, **kwargs))
+
+    async def aget(self, url: str, **kwargs: Any) -> Union[str, Dict[str, Any]]:
+        """GET the URL and return the text asynchronously."""
+        async with self.requests.aget(url, **kwargs) as response:
+            return await self._aget_resp_content(response)
+
+    async def apost(
+        self, url: str, data: Dict[str, Any], **kwargs: Any
+    ) -> Union[str, Dict[str, Any]]:
+        """POST to the URL and return the text asynchronously."""
+        async with self.requests.apost(url, data, **kwargs) as response:
+            return await self._aget_resp_content(response)
+
+    async def apatch(
+        self, url: str, data: Dict[str, Any], **kwargs: Any
+    ) -> Union[str, Dict[str, Any]]:
+        """PATCH the URL and return the text asynchronously."""
+        async with self.requests.apatch(url, data, **kwargs) as response:
+            return await self._aget_resp_content(response)
+
+    async def aput(
+        self, url: str, data: Dict[str, Any], **kwargs: Any
+    ) -> Union[str, Dict[str, Any]]:
+        """PUT the URL and return the text asynchronously."""
+        async with self.requests.aput(url, data, **kwargs) as response:
+            return await self._aget_resp_content(response)
+
+    async def adelete(self, url: str, **kwargs: Any) -> Union[str, Dict[str, Any]]:
+        """DELETE the URL and return the text asynchronously."""
+        async with self.requests.adelete(url, **kwargs) as response:
+            return await self._aget_resp_content(response)
+
+
+class JsonRequestsWrapper(GenericRequestsWrapper):
+    """Lightweight wrapper around requests library, with async support.
+
+    The main purpose of this wrapper is to always return a json output."""
+
+    response_content_type: Literal["text", "json"] = "json"
+
+
+class TextRequestsWrapper(GenericRequestsWrapper):
+    """Lightweight wrapper around requests library, with async support.
+
+    The main purpose of this wrapper is to always return a text output."""
+
+    response_content_type: Literal["text", "json"] = "text"
+
+
+# For backwards compatibility
+RequestsWrapper = TextRequestsWrapper
diff --git a/llm/Lib/site-packages/langchain_community/utilities/scenexplain.py b/llm/Lib/site-packages/langchain_community/utilities/scenexplain.py
new file mode 100644
index 0000000000000000000000000000000000000000..f8ffcb41e13b8bc282e58c6c333c33452fe2a93a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/scenexplain.py
@@ -0,0 +1,65 @@
+"""Util that calls SceneXplain.
+
+In order to set this up, you need API key for the SceneXplain API.
+You can obtain a key by following the steps below.
+- Sign up for a free account at https://scenex.jina.ai/.
+- Navigate to the API Access page (https://scenex.jina.ai/api) and create a new API key.
+"""
+from typing import Dict
+
+import requests
+from langchain_core.pydantic_v1 import BaseModel, BaseSettings, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class SceneXplainAPIWrapper(BaseSettings, BaseModel):
+    """Wrapper for SceneXplain API.
+
+    In order to set this up, you need API key for the SceneXplain API.
+    You can obtain a key by following the steps below.
+    - Sign up for a free account at https://scenex.jina.ai/.
+    - Navigate to the API Access page (https://scenex.jina.ai/api)
+      and create a new API key.
+    """
+
+    scenex_api_key: str = Field(..., env="SCENEX_API_KEY")
+    scenex_api_url: str = "https://api.scenex.jina.ai/v1/describe"
+
+    def _describe_image(self, image: str) -> str:
+        headers = {
+            "x-api-key": f"token {self.scenex_api_key}",
+            "content-type": "application/json",
+        }
+        payload = {
+            "data": [
+                {
+                    "image": image,
+                    "algorithm": "Ember",
+                    "languages": ["en"],
+                }
+            ]
+        }
+        response = requests.post(self.scenex_api_url, headers=headers, json=payload)
+        response.raise_for_status()
+        result = response.json().get("result", [])
+        img = result[0] if result else {}
+
+        return img.get("text", "")
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        scenex_api_key = get_from_dict_or_env(
+            values, "scenex_api_key", "SCENEX_API_KEY"
+        )
+        values["scenex_api_key"] = scenex_api_key
+
+        return values
+
+    def run(self, image: str) -> str:
+        """Run SceneXplain image explainer."""
+        description = self._describe_image(image)
+        if not description:
+            return "No description found."
+
+        return description
diff --git a/llm/Lib/site-packages/langchain_community/utilities/searchapi.py b/llm/Lib/site-packages/langchain_community/utilities/searchapi.py
new file mode 100644
index 0000000000000000000000000000000000000000..3934b59d0ed820e3b054f38b18dfae8d317fe50d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/searchapi.py
@@ -0,0 +1,138 @@
+from typing import Any, Dict, Optional
+
+import aiohttp
+import requests
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class SearchApiAPIWrapper(BaseModel):
+    """
+    Wrapper around SearchApi API.
+
+    To use, you should have the environment variable ``SEARCHAPI_API_KEY``
+    set with your API key, or pass `searchapi_api_key`
+    as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.utilities import SearchApiAPIWrapper
+            searchapi = SearchApiAPIWrapper()
+    """
+
+    # Use "google" engine by default.
+    # Full list of supported ones can be found in https://www.searchapi.io docs
+    engine: str = "google"
+    searchapi_api_key: Optional[str] = None
+    aiosession: Optional[aiohttp.ClientSession] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that API key exists in environment."""
+        searchapi_api_key = get_from_dict_or_env(
+            values, "searchapi_api_key", "SEARCHAPI_API_KEY"
+        )
+        values["searchapi_api_key"] = searchapi_api_key
+        return values
+
+    def run(self, query: str, **kwargs: Any) -> str:
+        results = self.results(query, **kwargs)
+        return self._result_as_string(results)
+
+    async def arun(self, query: str, **kwargs: Any) -> str:
+        results = await self.aresults(query, **kwargs)
+        return self._result_as_string(results)
+
+    def results(self, query: str, **kwargs: Any) -> dict:
+        results = self._search_api_results(query, **kwargs)
+        return results
+
+    async def aresults(self, query: str, **kwargs: Any) -> dict:
+        results = await self._async_search_api_results(query, **kwargs)
+        return results
+
+    def _prepare_request(self, query: str, **kwargs: Any) -> dict:
+        return {
+            "url": "https://www.searchapi.io/api/v1/search",
+            "headers": {
+                "Authorization": f"Bearer {self.searchapi_api_key}",
+            },
+            "params": {
+                "engine": self.engine,
+                "q": query,
+                **{key: value for key, value in kwargs.items() if value is not None},
+            },
+        }
+
+    def _search_api_results(self, query: str, **kwargs: Any) -> dict:
+        request_details = self._prepare_request(query, **kwargs)
+        response = requests.get(
+            url=request_details["url"],
+            params=request_details["params"],
+            headers=request_details["headers"],
+        )
+        response.raise_for_status()
+        return response.json()
+
+    async def _async_search_api_results(self, query: str, **kwargs: Any) -> dict:
+        """Use aiohttp to send request to SearchApi API and return results async."""
+        request_details = self._prepare_request(query, **kwargs)
+        if not self.aiosession:
+            async with aiohttp.ClientSession() as session:
+                async with session.get(
+                    url=request_details["url"],
+                    headers=request_details["headers"],
+                    params=request_details["params"],
+                    raise_for_status=True,
+                ) as response:
+                    results = await response.json()
+        else:
+            async with self.aiosession.get(
+                url=request_details["url"],
+                headers=request_details["headers"],
+                params=request_details["params"],
+                raise_for_status=True,
+            ) as response:
+                results = await response.json()
+        return results
+
+    @staticmethod
+    def _result_as_string(result: dict) -> str:
+        toret = "No good search result found"
+        if "answer_box" in result.keys() and "answer" in result["answer_box"].keys():
+            toret = result["answer_box"]["answer"]
+        elif "answer_box" in result.keys() and "snippet" in result["answer_box"].keys():
+            toret = result["answer_box"]["snippet"]
+        elif "knowledge_graph" in result.keys():
+            toret = result["knowledge_graph"]["description"]
+        elif "organic_results" in result.keys():
+            snippets = [
+                r["snippet"] for r in result["organic_results"] if "snippet" in r.keys()
+            ]
+            toret = "\n".join(snippets)
+        elif "jobs" in result.keys():
+            jobs = [
+                r["description"] for r in result["jobs"] if "description" in r.keys()
+            ]
+            toret = "\n".join(jobs)
+        elif "videos" in result.keys():
+            videos = [
+                f"""Title: "{r["title"]}" Link: {r["link"]}"""
+                for r in result["videos"]
+                if "title" in r.keys()
+            ]
+            toret = "\n".join(videos)
+        elif "images" in result.keys():
+            images = [
+                f"""Title: "{r["title"]}" Link: {r["original"]["link"]}"""
+                for r in result["images"]
+                if "original" in r.keys()
+            ]
+            toret = "\n".join(images)
+        return toret
diff --git a/llm/Lib/site-packages/langchain_community/utilities/searx_search.py b/llm/Lib/site-packages/langchain_community/utilities/searx_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..0ddbf738c0864d3e16248c5a4700cccc4a77e412
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/searx_search.py
@@ -0,0 +1,505 @@
+"""Utility for using SearxNG meta search API.
+
+SearxNG is a privacy-friendly free metasearch engine that aggregates results from
+`multiple search engines
+<https://docs.searxng.org/admin/engines/configured_engines.html>`_ and databases and
+supports the `OpenSearch
+<https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md>`_
+specification.
+
+More details on the installation instructions `here. <../../integrations/searx.html>`_
+
+For the search API refer to https://docs.searxng.org/dev/search_api.html
+
+Quick Start
+-----------
+
+
+In order to use this utility you need to provide the searx host. This can be done
+by passing the named parameter :attr:`searx_host <SearxSearchWrapper.searx_host>`
+or exporting the environment variable SEARX_HOST.
+Note: this is the only required parameter.
+
+Then create a searx search instance like this:
+
+    .. code-block:: python
+
+        from langchain_community.utilities import SearxSearchWrapper
+
+        # when the host starts with `http` SSL is disabled and the connection
+        # is assumed to be on a private network
+        searx_host='http://self.hosted'
+
+        search = SearxSearchWrapper(searx_host=searx_host)
+
+
+You can now use the ``search`` instance to query the searx API.
+
+Searching
+---------
+
+Use the :meth:`run() <SearxSearchWrapper.run>` and
+:meth:`results() <SearxSearchWrapper.results>` methods to query the searx API.
+Other methods are available for convenience.
+
+:class:`SearxResults` is a convenience wrapper around the raw json result.
+
+Example usage of the ``run`` method to make a search:
+
+    .. code-block:: python
+
+        s.run(query="what is the best search engine?")
+
+Engine Parameters
+-----------------
+
+You can pass any `accepted searx search API
+<https://docs.searxng.org/dev/search_api.html>`_ parameters to the
+:py:class:`SearxSearchWrapper` instance.
+
+In the following example we are using the
+:attr:`engines <SearxSearchWrapper.engines>` and the ``language`` parameters:
+
+    .. code-block:: python
+
+        # assuming the searx host is set as above or exported as an env variable
+        s = SearxSearchWrapper(engines=['google', 'bing'],
+                            language='es')
+
+Search Tips
+-----------
+
+Searx offers a special
+`search syntax <https://docs.searxng.org/user/index.html#search-syntax>`_
+that can also be used instead of passing engine parameters.
+
+For example the following query:
+
+    .. code-block:: python
+
+        s = SearxSearchWrapper("langchain library", engines=['github'])
+
+        # can also be written as:
+        s = SearxSearchWrapper("langchain library !github")
+        # or even:
+        s = SearxSearchWrapper("langchain library !gh")
+
+
+In some situations you might want to pass an extra string to the search query.
+For example when the `run()` method is called by an agent. The search suffix can
+also be used as a way to pass extra parameters to searx or the underlying search
+engines.
+
+    .. code-block:: python
+
+        # select the github engine and pass the search suffix
+        s = SearchWrapper("langchain library", query_suffix="!gh")
+
+
+        s = SearchWrapper("langchain library")
+        # select github the conventional google search syntax
+        s.run("large language models", query_suffix="site:github.com")
+
+
+*NOTE*: A search suffix can be defined on both the instance and the method level.
+The resulting query will be the concatenation of the two with the former taking
+precedence.
+
+
+See `SearxNG Configured Engines
+<https://docs.searxng.org/admin/engines/configured_engines.html>`_ and
+`SearxNG Search Syntax <https://docs.searxng.org/user/index.html#id1>`_
+for more details.
+
+Notes
+-----
+This wrapper is based on the SearxNG fork https://github.com/searxng/searxng which is
+better maintained than the original Searx project and offers more features.
+
+Public searxNG instances often use a rate limiter for API usage, so you might want to
+use a self hosted instance and disable the rate limiter.
+
+If you are self-hosting an instance you can customize the rate limiter for your
+own network as described
+`here <https://docs.searxng.org/src/searx.botdetection.html#limiter-src>`_.
+
+
+For a list of public SearxNG instances see https://searx.space/
+"""
+
+import json
+from typing import Any, Dict, List, Optional
+
+import aiohttp
+import requests
+from langchain_core.pydantic_v1 import (
+    BaseModel,
+    Extra,
+    Field,
+    PrivateAttr,
+    root_validator,
+    validator,
+)
+from langchain_core.utils import get_from_dict_or_env
+
+
+def _get_default_params() -> dict:
+    return {"language": "en", "format": "json"}
+
+
+class SearxResults(dict):
+    """Dict like wrapper around search api results."""
+
+    _data: str = ""
+
+    def __init__(self, data: str):
+        """Take a raw result from Searx and make it into a dict like object."""
+        json_data = json.loads(data)
+        super().__init__(json_data)
+        self.__dict__ = self
+
+    def __str__(self) -> str:
+        """Text representation of searx result."""
+        return self._data
+
+    @property
+    def results(self) -> Any:
+        """Silence mypy for accessing this field.
+
+        :meta private:
+        """
+        return self.get("results")
+
+    @property
+    def answers(self) -> Any:
+        """Helper accessor on the json result."""
+        return self.get("answers")
+
+
+class SearxSearchWrapper(BaseModel):
+    """Wrapper for Searx API.
+
+    To use you need to provide the searx host by passing the named parameter
+    ``searx_host`` or exporting the environment variable ``SEARX_HOST``.
+
+    In some situations you might want to disable SSL verification, for example
+    if you are running searx locally. You can do this by passing the named parameter
+    ``unsecure``. You can also pass the host url scheme as ``http`` to disable SSL.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.utilities import SearxSearchWrapper
+            searx = SearxSearchWrapper(searx_host="http://localhost:8888")
+
+    Example with SSL disabled:
+        .. code-block:: python
+
+            from langchain_community.utilities import SearxSearchWrapper
+            # note the unsecure parameter is not needed if you pass the url scheme as
+            # http
+            searx = SearxSearchWrapper(searx_host="http://localhost:8888",
+                                                    unsecure=True)
+
+
+    """
+
+    _result: SearxResults = PrivateAttr()
+    searx_host: str = ""
+    unsecure: bool = False
+    params: dict = Field(default_factory=_get_default_params)
+    headers: Optional[dict] = None
+    engines: Optional[List[str]] = []
+    categories: Optional[List[str]] = []
+    query_suffix: Optional[str] = ""
+    k: int = 10
+    aiosession: Optional[Any] = None
+
+    @validator("unsecure")
+    def disable_ssl_warnings(cls, v: bool) -> bool:
+        """Disable SSL warnings."""
+        if v:
+            # requests.urllib3.disable_warnings()
+            try:
+                import urllib3
+
+                urllib3.disable_warnings()
+            except ImportError as e:
+                print(e)  # noqa: T201
+
+        return v
+
+    @root_validator()
+    def validate_params(cls, values: Dict) -> Dict:
+        """Validate that custom searx params are merged with default ones."""
+        user_params = values["params"]
+        default = _get_default_params()
+        values["params"] = {**default, **user_params}
+
+        engines = values.get("engines")
+        if engines:
+            values["params"]["engines"] = ",".join(engines)
+
+        categories = values.get("categories")
+        if categories:
+            values["params"]["categories"] = ",".join(categories)
+
+        searx_host = get_from_dict_or_env(values, "searx_host", "SEARX_HOST")
+        if not searx_host.startswith("http"):
+            print(  # noqa: T201
+                f"Warning: missing the url scheme on host \
+                ! assuming secure https://{searx_host} "
+            )
+            searx_host = "https://" + searx_host
+        elif searx_host.startswith("http://"):
+            values["unsecure"] = True
+            cls.disable_ssl_warnings(True)
+        values["searx_host"] = searx_host
+
+        return values
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def _searx_api_query(self, params: dict) -> SearxResults:
+        """Actual request to searx API."""
+        raw_result = requests.get(
+            self.searx_host,
+            headers=self.headers,
+            params=params,
+            verify=not self.unsecure,
+        )
+        # test if http result is ok
+        if not raw_result.ok:
+            raise ValueError("Searx API returned an error: ", raw_result.text)
+        res = SearxResults(raw_result.text)
+        self._result = res
+        return res
+
+    async def _asearx_api_query(self, params: dict) -> SearxResults:
+        if not self.aiosession:
+            async with aiohttp.ClientSession() as session:
+                async with session.get(
+                    self.searx_host,
+                    headers=self.headers,
+                    params=params,
+                    ssl=(lambda: False if self.unsecure else None)(),
+                ) as response:
+                    if not response.ok:
+                        raise ValueError("Searx API returned an error: ", response.text)
+                    result = SearxResults(await response.text())
+                    self._result = result
+        else:
+            async with self.aiosession.get(
+                self.searx_host,
+                headers=self.headers,
+                params=params,
+                verify=not self.unsecure,
+            ) as response:
+                if not response.ok:
+                    raise ValueError("Searx API returned an error: ", response.text)
+                result = SearxResults(await response.text())
+                self._result = result
+
+        return result
+
+    def run(
+        self,
+        query: str,
+        engines: Optional[List[str]] = None,
+        categories: Optional[List[str]] = None,
+        query_suffix: Optional[str] = "",
+        **kwargs: Any,
+    ) -> str:
+        """Run query through Searx API and parse results.
+
+        You can pass any other params to the searx query API.
+
+        Args:
+            query: The query to search for.
+            query_suffix: Extra suffix appended to the query.
+            engines: List of engines to use for the query.
+            categories: List of categories to use for the query.
+            **kwargs: extra parameters to pass to the searx API.
+
+        Returns:
+            str: The result of the query.
+
+        Raises:
+            ValueError: If an error occurred with the query.
+
+
+        Example:
+            This will make a query to the qwant engine:
+
+            .. code-block:: python
+
+                from langchain_community.utilities import SearxSearchWrapper
+                searx = SearxSearchWrapper(searx_host="http://my.searx.host")
+                searx.run("what is the weather in France ?", engine="qwant")
+
+                # the same result can be achieved using the `!` syntax of searx
+                # to select the engine using `query_suffix`
+                searx.run("what is the weather in France ?", query_suffix="!qwant")
+        """
+        _params = {
+            "q": query,
+        }
+        params = {**self.params, **_params, **kwargs}
+
+        if self.query_suffix and len(self.query_suffix) > 0:
+            params["q"] += " " + self.query_suffix
+
+        if isinstance(query_suffix, str) and len(query_suffix) > 0:
+            params["q"] += " " + query_suffix
+
+        if isinstance(engines, list) and len(engines) > 0:
+            params["engines"] = ",".join(engines)
+
+        if isinstance(categories, list) and len(categories) > 0:
+            params["categories"] = ",".join(categories)
+
+        res = self._searx_api_query(params)
+
+        if len(res.answers) > 0:
+            toret = res.answers[0]
+
+        # only return the content of the results list
+        elif len(res.results) > 0:
+            toret = "\n\n".join([r.get("content", "") for r in res.results[: self.k]])
+        else:
+            toret = "No good search result found"
+
+        return toret
+
+    async def arun(
+        self,
+        query: str,
+        engines: Optional[List[str]] = None,
+        query_suffix: Optional[str] = "",
+        **kwargs: Any,
+    ) -> str:
+        """Asynchronously version of `run`."""
+        _params = {
+            "q": query,
+        }
+        params = {**self.params, **_params, **kwargs}
+
+        if self.query_suffix and len(self.query_suffix) > 0:
+            params["q"] += " " + self.query_suffix
+
+        if isinstance(query_suffix, str) and len(query_suffix) > 0:
+            params["q"] += " " + query_suffix
+
+        if isinstance(engines, list) and len(engines) > 0:
+            params["engines"] = ",".join(engines)
+
+        res = await self._asearx_api_query(params)
+
+        if len(res.answers) > 0:
+            toret = res.answers[0]
+
+        # only return the content of the results list
+        elif len(res.results) > 0:
+            toret = "\n\n".join([r.get("content", "") for r in res.results[: self.k]])
+        else:
+            toret = "No good search result found"
+
+        return toret
+
+    def results(
+        self,
+        query: str,
+        num_results: int,
+        engines: Optional[List[str]] = None,
+        categories: Optional[List[str]] = None,
+        query_suffix: Optional[str] = "",
+        **kwargs: Any,
+    ) -> List[Dict]:
+        """Run query through Searx API and returns the results with metadata.
+
+        Args:
+            query: The query to search for.
+            query_suffix: Extra suffix appended to the query.
+            num_results: Limit the number of results to return.
+            engines: List of engines to use for the query.
+            categories: List of categories to use for the query.
+            **kwargs: extra parameters to pass to the searx API.
+
+        Returns:
+            Dict with the following keys:
+            {
+                snippet:  The description of the result.
+                title:  The title of the result.
+                link: The link to the result.
+                engines: The engines used for the result.
+                category: Searx category of the result.
+            }
+
+        """
+        _params = {
+            "q": query,
+        }
+        params = {**self.params, **_params, **kwargs}
+        if self.query_suffix and len(self.query_suffix) > 0:
+            params["q"] += " " + self.query_suffix
+        if isinstance(query_suffix, str) and len(query_suffix) > 0:
+            params["q"] += " " + query_suffix
+        if isinstance(engines, list) and len(engines) > 0:
+            params["engines"] = ",".join(engines)
+        if isinstance(categories, list) and len(categories) > 0:
+            params["categories"] = ",".join(categories)
+        results = self._searx_api_query(params).results[:num_results]
+        if len(results) == 0:
+            return [{"Result": "No good Search Result was found"}]
+
+        return [
+            {
+                "snippet": result.get("content", ""),
+                "title": result["title"],
+                "link": result["url"],
+                "engines": result["engines"],
+                "category": result["category"],
+            }
+            for result in results
+        ]
+
+    async def aresults(
+        self,
+        query: str,
+        num_results: int,
+        engines: Optional[List[str]] = None,
+        query_suffix: Optional[str] = "",
+        **kwargs: Any,
+    ) -> List[Dict]:
+        """Asynchronously query with json results.
+
+        Uses aiohttp. See `results` for more info.
+        """
+        _params = {
+            "q": query,
+        }
+        params = {**self.params, **_params, **kwargs}
+
+        if self.query_suffix and len(self.query_suffix) > 0:
+            params["q"] += " " + self.query_suffix
+        if isinstance(query_suffix, str) and len(query_suffix) > 0:
+            params["q"] += " " + query_suffix
+        if isinstance(engines, list) and len(engines) > 0:
+            params["engines"] = ",".join(engines)
+        results = (await self._asearx_api_query(params)).results[:num_results]
+        if len(results) == 0:
+            return [{"Result": "No good Search Result was found"}]
+
+        return [
+            {
+                "snippet": result.get("content", ""),
+                "title": result["title"],
+                "link": result["url"],
+                "engines": result["engines"],
+                "category": result["category"],
+            }
+            for result in results
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/utilities/semanticscholar.py b/llm/Lib/site-packages/langchain_community/utilities/semanticscholar.py
new file mode 100644
index 0000000000000000000000000000000000000000..7e9f03876e3d397a5f5e1e079b06a1a0b3c7d25a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/semanticscholar.py
@@ -0,0 +1,88 @@
+"""Utils for interacting with the Semantic Scholar API."""
+import logging
+from typing import Any, Dict, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+logger = logging.getLogger(__name__)
+
+
+class SemanticScholarAPIWrapper(BaseModel):
+    """Wrapper around semanticscholar.org API.
+    https://github.com/danielnsilva/semanticscholar
+
+    You should have this library installed.
+
+    `pip install semanticscholar`
+
+    Semantic Scholar API can conduct searches and fetch document metadata
+    like title, abstract, authors, etc.
+
+    Attributes:
+    top_k_results: number of the top-scored document used for the Semantic Scholar tool
+    load_max_docs: a limit to the number of loaded documents
+
+    Example:
+    .. code-block:: python
+
+    from langchain_community.utilities.semanticscholar import SemanticScholarAPIWrapper
+    ss = SemanticScholarAPIWrapper(
+        top_k_results = 3,
+        load_max_docs = 3
+    )
+    ss.run("biases in large language models")
+    """
+
+    semanticscholar_search: Any  #: :meta private:
+    top_k_results: int = 5
+    S2_MAX_QUERY_LENGTH: int = 300
+    load_max_docs: int = 100
+    doc_content_chars_max: Optional[int] = 4000
+    returned_fields = [
+        "title",
+        "abstract",
+        "venue",
+        "year",
+        "paperId",
+        "citationCount",
+        "openAccessPdf",
+        "authors",
+        "externalIds",
+    ]
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in environment."""
+        try:
+            from semanticscholar import SemanticScholar
+
+            sch = SemanticScholar()
+            values["semanticscholar_search"] = sch.search_paper
+        except ImportError:
+            raise ImportError(
+                "Could not import Semanticscholar python package. "
+                "Please install it with `pip install semanticscholar`."
+            )
+        return values
+
+    def run(self, query: str) -> str:
+        """Run the Semantic Scholar API."""
+        results = self.semanticscholar_search(
+            query, limit=self.load_max_docs, fields=self.returned_fields
+        )
+        documents = []
+        for item in results[: self.top_k_results]:
+            authors = ", ".join(
+                author["name"] for author in getattr(item, "authors", [])
+            )
+            documents.append(
+                f"Published year: {getattr(item, 'year', None)}\n"
+                f"Title: {getattr(item, 'title', None)}\n"
+                f"Authors: {authors}\n"
+                f"Astract: {getattr(item, 'abstract', None)}\n"
+            )
+
+        if documents:
+            return "\n\n".join(documents)[: self.doc_content_chars_max]
+        else:
+            return "No results found."
diff --git a/llm/Lib/site-packages/langchain_community/utilities/serpapi.py b/llm/Lib/site-packages/langchain_community/utilities/serpapi.py
new file mode 100644
index 0000000000000000000000000000000000000000..2404df9bcfaec9dace5e640fd55aa857a4adf595
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/serpapi.py
@@ -0,0 +1,225 @@
+"""Chain that calls SerpAPI.
+
+Heavily borrowed from https://github.com/ofirpress/self-ask
+"""
+import os
+import sys
+from typing import Any, Dict, Optional, Tuple
+
+import aiohttp
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class HiddenPrints:
+    """Context manager to hide prints."""
+
+    def __enter__(self) -> None:
+        """Open file to pipe stdout to."""
+        self._original_stdout = sys.stdout
+        sys.stdout = open(os.devnull, "w")
+
+    def __exit__(self, *_: Any) -> None:
+        """Close file that stdout was piped to."""
+        sys.stdout.close()
+        sys.stdout = self._original_stdout
+
+
+class SerpAPIWrapper(BaseModel):
+    """Wrapper around SerpAPI.
+
+    To use, you should have the ``google-search-results`` python package installed,
+    and the environment variable ``SERPAPI_API_KEY`` set with your API key, or pass
+    `serpapi_api_key` as a named parameter to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.utilities import SerpAPIWrapper
+            serpapi = SerpAPIWrapper()
+    """
+
+    search_engine: Any  #: :meta private:
+    params: dict = Field(
+        default={
+            "engine": "google",
+            "google_domain": "google.com",
+            "gl": "us",
+            "hl": "en",
+        }
+    )
+    serpapi_api_key: Optional[str] = None
+    aiosession: Optional[aiohttp.ClientSession] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        serpapi_api_key = get_from_dict_or_env(
+            values, "serpapi_api_key", "SERPAPI_API_KEY"
+        )
+        values["serpapi_api_key"] = serpapi_api_key
+        try:
+            from serpapi import GoogleSearch
+
+            values["search_engine"] = GoogleSearch
+        except ImportError:
+            raise ValueError(
+                "Could not import serpapi python package. "
+                "Please install it with `pip install google-search-results`."
+            )
+        return values
+
+    async def arun(self, query: str, **kwargs: Any) -> str:
+        """Run query through SerpAPI and parse result async."""
+        return self._process_response(await self.aresults(query))
+
+    def run(self, query: str, **kwargs: Any) -> str:
+        """Run query through SerpAPI and parse result."""
+        return self._process_response(self.results(query))
+
+    def results(self, query: str) -> dict:
+        """Run query through SerpAPI and return the raw result."""
+        params = self.get_params(query)
+        with HiddenPrints():
+            search = self.search_engine(params)
+            res = search.get_dict()
+        return res
+
+    async def aresults(self, query: str) -> dict:
+        """Use aiohttp to run query through SerpAPI and return the results async."""
+
+        def construct_url_and_params() -> Tuple[str, Dict[str, str]]:
+            params = self.get_params(query)
+            params["source"] = "python"
+            if self.serpapi_api_key:
+                params["serp_api_key"] = self.serpapi_api_key
+            params["output"] = "json"
+            url = "https://serpapi.com/search"
+            return url, params
+
+        url, params = construct_url_and_params()
+        if not self.aiosession:
+            async with aiohttp.ClientSession() as session:
+                async with session.get(url, params=params) as response:
+                    res = await response.json()
+        else:
+            async with self.aiosession.get(url, params=params) as response:
+                res = await response.json()
+
+        return res
+
+    def get_params(self, query: str) -> Dict[str, str]:
+        """Get parameters for SerpAPI."""
+        _params = {
+            "api_key": self.serpapi_api_key,
+            "q": query,
+        }
+        params = {**self.params, **_params}
+        return params
+
+    @staticmethod
+    def _process_response(res: dict) -> str:
+        """Process response from SerpAPI."""
+        if "error" in res.keys():
+            raise ValueError(f"Got error from SerpAPI: {res['error']}")
+        if "answer_box_list" in res.keys():
+            res["answer_box"] = res["answer_box_list"]
+        if "answer_box" in res.keys():
+            answer_box = res["answer_box"]
+            if isinstance(answer_box, list):
+                answer_box = answer_box[0]
+            if "result" in answer_box.keys():
+                return answer_box["result"]
+            elif "answer" in answer_box.keys():
+                return answer_box["answer"]
+            elif "snippet" in answer_box.keys():
+                return answer_box["snippet"]
+            elif "snippet_highlighted_words" in answer_box.keys():
+                return answer_box["snippet_highlighted_words"]
+            else:
+                answer = {}
+                for key, value in answer_box.items():
+                    if not isinstance(value, (list, dict)) and not (
+                        isinstance(value, str) and value.startswith("http")
+                    ):
+                        answer[key] = value
+                return str(answer)
+        elif "events_results" in res.keys():
+            return res["events_results"][:10]
+        elif "sports_results" in res.keys():
+            return res["sports_results"]
+        elif "top_stories" in res.keys():
+            return res["top_stories"]
+        elif "news_results" in res.keys():
+            return res["news_results"]
+        elif "jobs_results" in res.keys() and "jobs" in res["jobs_results"].keys():
+            return res["jobs_results"]["jobs"]
+        elif (
+            "shopping_results" in res.keys()
+            and "title" in res["shopping_results"][0].keys()
+        ):
+            return res["shopping_results"][:3]
+        elif "questions_and_answers" in res.keys():
+            return res["questions_and_answers"]
+        elif (
+            "popular_destinations" in res.keys()
+            and "destinations" in res["popular_destinations"].keys()
+        ):
+            return res["popular_destinations"]["destinations"]
+        elif "top_sights" in res.keys() and "sights" in res["top_sights"].keys():
+            return res["top_sights"]["sights"]
+        elif (
+            "images_results" in res.keys()
+            and "thumbnail" in res["images_results"][0].keys()
+        ):
+            return str([item["thumbnail"] for item in res["images_results"][:10]])
+
+        snippets = []
+        if "knowledge_graph" in res.keys():
+            knowledge_graph = res["knowledge_graph"]
+            title = knowledge_graph["title"] if "title" in knowledge_graph else ""
+            if "description" in knowledge_graph.keys():
+                snippets.append(knowledge_graph["description"])
+            for key, value in knowledge_graph.items():
+                if (
+                    isinstance(key, str)
+                    and isinstance(value, str)
+                    and key not in ["title", "description"]
+                    and not key.endswith("_stick")
+                    and not key.endswith("_link")
+                    and not value.startswith("http")
+                ):
+                    snippets.append(f"{title} {key}: {value}.")
+
+        for organic_result in res.get("organic_results", []):
+            if "snippet" in organic_result.keys():
+                snippets.append(organic_result["snippet"])
+            elif "snippet_highlighted_words" in organic_result.keys():
+                snippets.append(organic_result["snippet_highlighted_words"])
+            elif "rich_snippet" in organic_result.keys():
+                snippets.append(organic_result["rich_snippet"])
+            elif "rich_snippet_table" in organic_result.keys():
+                snippets.append(organic_result["rich_snippet_table"])
+            elif "link" in organic_result.keys():
+                snippets.append(organic_result["link"])
+
+        if "buying_guide" in res.keys():
+            snippets.append(res["buying_guide"])
+        if "local_results" in res and isinstance(res["local_results"], list):
+            snippets += res["local_results"]
+        if (
+            "local_results" in res.keys()
+            and isinstance(res["local_results"], dict)
+            and "places" in res["local_results"].keys()
+        ):
+            snippets.append(res["local_results"]["places"])
+        if len(snippets) > 0:
+            return str(snippets)
+        else:
+            return "No good search result found"
diff --git a/llm/Lib/site-packages/langchain_community/utilities/spark_sql.py b/llm/Lib/site-packages/langchain_community/utilities/spark_sql.py
new file mode 100644
index 0000000000000000000000000000000000000000..20c1e8e5b2f2da929b82bffd80b9fe92939ea02d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/spark_sql.py
@@ -0,0 +1,186 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Iterable, List, Optional
+
+if TYPE_CHECKING:
+    from pyspark.sql import DataFrame, Row, SparkSession
+
+
+class SparkSQL:
+    """SparkSQL is a utility class for interacting with Spark SQL."""
+
+    def __init__(
+        self,
+        spark_session: Optional[SparkSession] = None,
+        catalog: Optional[str] = None,
+        schema: Optional[str] = None,
+        ignore_tables: Optional[List[str]] = None,
+        include_tables: Optional[List[str]] = None,
+        sample_rows_in_table_info: int = 3,
+    ):
+        """Initialize a SparkSQL object.
+
+        Args:
+            spark_session: A SparkSession object.
+              If not provided, one will be created.
+            catalog: The catalog to use.
+              If not provided, the default catalog will be used.
+            schema: The schema to use.
+              If not provided, the default schema will be used.
+            ignore_tables: A list of tables to ignore.
+              If not provided, all tables will be used.
+            include_tables: A list of tables to include.
+              If not provided, all tables will be used.
+            sample_rows_in_table_info: The number of rows to include in the table info.
+              Defaults to 3.
+        """
+        try:
+            from pyspark.sql import SparkSession
+        except ImportError:
+            raise ImportError(
+                "pyspark is not installed. Please install it with `pip install pyspark`"
+            )
+
+        self._spark = (
+            spark_session if spark_session else SparkSession.builder.getOrCreate()
+        )
+        if catalog is not None:
+            self._spark.catalog.setCurrentCatalog(catalog)
+        if schema is not None:
+            self._spark.catalog.setCurrentDatabase(schema)
+
+        self._all_tables = set(self._get_all_table_names())
+        self._include_tables = set(include_tables) if include_tables else set()
+        if self._include_tables:
+            missing_tables = self._include_tables - self._all_tables
+            if missing_tables:
+                raise ValueError(
+                    f"include_tables {missing_tables} not found in database"
+                )
+        self._ignore_tables = set(ignore_tables) if ignore_tables else set()
+        if self._ignore_tables:
+            missing_tables = self._ignore_tables - self._all_tables
+            if missing_tables:
+                raise ValueError(
+                    f"ignore_tables {missing_tables} not found in database"
+                )
+        usable_tables = self.get_usable_table_names()
+        self._usable_tables = set(usable_tables) if usable_tables else self._all_tables
+
+        if not isinstance(sample_rows_in_table_info, int):
+            raise TypeError("sample_rows_in_table_info must be an integer")
+
+        self._sample_rows_in_table_info = sample_rows_in_table_info
+
+    @classmethod
+    def from_uri(
+        cls, database_uri: str, engine_args: Optional[dict] = None, **kwargs: Any
+    ) -> SparkSQL:
+        """Creating a remote Spark Session via Spark connect.
+        For example: SparkSQL.from_uri("sc://localhost:15002")
+        """
+        try:
+            from pyspark.sql import SparkSession
+        except ImportError:
+            raise ValueError(
+                "pyspark is not installed. Please install it with `pip install pyspark`"
+            )
+
+        spark = SparkSession.builder.remote(database_uri).getOrCreate()
+        return cls(spark, **kwargs)
+
+    def get_usable_table_names(self) -> Iterable[str]:
+        """Get names of tables available."""
+        if self._include_tables:
+            return self._include_tables
+        # sorting the result can help LLM understanding it.
+        return sorted(self._all_tables - self._ignore_tables)
+
+    def _get_all_table_names(self) -> Iterable[str]:
+        rows = self._spark.sql("SHOW TABLES").select("tableName").collect()
+        return list(map(lambda row: row.tableName, rows))
+
+    def _get_create_table_stmt(self, table: str) -> str:
+        statement = (
+            self._spark.sql(f"SHOW CREATE TABLE {table}").collect()[0].createtab_stmt
+        )
+        # Ignore the data source provider and options to reduce the number of tokens.
+        using_clause_index = statement.find("USING")
+        return statement[:using_clause_index] + ";"
+
+    def get_table_info(self, table_names: Optional[List[str]] = None) -> str:
+        all_table_names = self.get_usable_table_names()
+        if table_names is not None:
+            missing_tables = set(table_names).difference(all_table_names)
+            if missing_tables:
+                raise ValueError(f"table_names {missing_tables} not found in database")
+            all_table_names = table_names
+        tables = []
+        for table_name in all_table_names:
+            table_info = self._get_create_table_stmt(table_name)
+            if self._sample_rows_in_table_info:
+                table_info += "\n\n/*"
+                table_info += f"\n{self._get_sample_spark_rows(table_name)}\n"
+                table_info += "*/"
+            tables.append(table_info)
+        final_str = "\n\n".join(tables)
+        return final_str
+
+    def _get_sample_spark_rows(self, table: str) -> str:
+        query = f"SELECT * FROM {table} LIMIT {self._sample_rows_in_table_info}"
+        df = self._spark.sql(query)
+        columns_str = "\t".join(list(map(lambda f: f.name, df.schema.fields)))
+        try:
+            sample_rows = self._get_dataframe_results(df)
+            # save the sample rows in string format
+            sample_rows_str = "\n".join(["\t".join(row) for row in sample_rows])
+        except Exception:
+            sample_rows_str = ""
+
+        return (
+            f"{self._sample_rows_in_table_info} rows from {table} table:\n"
+            f"{columns_str}\n"
+            f"{sample_rows_str}"
+        )
+
+    def _convert_row_as_tuple(self, row: Row) -> tuple:
+        return tuple(map(str, row.asDict().values()))
+
+    def _get_dataframe_results(self, df: DataFrame) -> list:
+        return list(map(self._convert_row_as_tuple, df.collect()))
+
+    def run(self, command: str, fetch: str = "all") -> str:
+        df = self._spark.sql(command)
+        if fetch == "one":
+            df = df.limit(1)
+        return str(self._get_dataframe_results(df))
+
+    def get_table_info_no_throw(self, table_names: Optional[List[str]] = None) -> str:
+        """Get information about specified tables.
+
+        Follows best practices as specified in: Rajkumar et al, 2022
+        (https://arxiv.org/abs/2204.00498)
+
+        If `sample_rows_in_table_info`, the specified number of sample rows will be
+        appended to each table description. This can increase performance as
+        demonstrated in the paper.
+        """
+        try:
+            return self.get_table_info(table_names)
+        except ValueError as e:
+            """Format the error message"""
+            return f"Error: {e}"
+
+    def run_no_throw(self, command: str, fetch: str = "all") -> str:
+        """Execute a SQL command and return a string representing the results.
+
+        If the statement returns rows, a string of the results is returned.
+        If the statement returns no rows, an empty string is returned.
+
+        If the statement throws an error, the error message is returned.
+        """
+        try:
+            return self.run(command, fetch)
+        except Exception as e:
+            """Format the error message"""
+            return f"Error: {e}"
diff --git a/llm/Lib/site-packages/langchain_community/utilities/sql_database.py b/llm/Lib/site-packages/langchain_community/utilities/sql_database.py
new file mode 100644
index 0000000000000000000000000000000000000000..a168e7b7fb7bbde658a000fcea36309c7fe6d292
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/sql_database.py
@@ -0,0 +1,569 @@
+"""SQLAlchemy wrapper around a database."""
+from __future__ import annotations
+
+from typing import Any, Dict, Iterable, List, Literal, Optional, Sequence, Union
+
+import sqlalchemy
+from langchain_core._api import deprecated
+from langchain_core.utils import get_from_env
+from sqlalchemy import (
+    MetaData,
+    Table,
+    create_engine,
+    inspect,
+    select,
+    text,
+)
+from sqlalchemy.engine import Engine, Result
+from sqlalchemy.exc import ProgrammingError, SQLAlchemyError
+from sqlalchemy.schema import CreateTable
+from sqlalchemy.sql.expression import Executable
+from sqlalchemy.types import NullType
+
+
+def _format_index(index: sqlalchemy.engine.interfaces.ReflectedIndex) -> str:
+    return (
+        f'Name: {index["name"]}, Unique: {index["unique"]},'
+        f' Columns: {str(index["column_names"])}'
+    )
+
+
+def truncate_word(content: Any, *, length: int, suffix: str = "...") -> str:
+    """
+    Truncate a string to a certain number of words, based on the max string
+    length.
+    """
+
+    if not isinstance(content, str) or length <= 0:
+        return content
+
+    if len(content) <= length:
+        return content
+
+    return content[: length - len(suffix)].rsplit(" ", 1)[0] + suffix
+
+
+class SQLDatabase:
+    """SQLAlchemy wrapper around a database."""
+
+    def __init__(
+        self,
+        engine: Engine,
+        schema: Optional[str] = None,
+        metadata: Optional[MetaData] = None,
+        ignore_tables: Optional[List[str]] = None,
+        include_tables: Optional[List[str]] = None,
+        sample_rows_in_table_info: int = 3,
+        indexes_in_table_info: bool = False,
+        custom_table_info: Optional[dict] = None,
+        view_support: bool = False,
+        max_string_length: int = 300,
+        lazy_table_reflection: bool = False,
+    ):
+        """Create engine from database URI."""
+        self._engine = engine
+        self._schema = schema
+        if include_tables and ignore_tables:
+            raise ValueError("Cannot specify both include_tables and ignore_tables")
+
+        self._inspector = inspect(self._engine)
+
+        # including view support by adding the views as well as tables to the all
+        # tables list if view_support is True
+        self._all_tables = set(
+            self._inspector.get_table_names(schema=schema)
+            + (self._inspector.get_view_names(schema=schema) if view_support else [])
+        )
+
+        self._include_tables = set(include_tables) if include_tables else set()
+        if self._include_tables:
+            missing_tables = self._include_tables - self._all_tables
+            if missing_tables:
+                raise ValueError(
+                    f"include_tables {missing_tables} not found in database"
+                )
+        self._ignore_tables = set(ignore_tables) if ignore_tables else set()
+        if self._ignore_tables:
+            missing_tables = self._ignore_tables - self._all_tables
+            if missing_tables:
+                raise ValueError(
+                    f"ignore_tables {missing_tables} not found in database"
+                )
+        usable_tables = self.get_usable_table_names()
+        self._usable_tables = set(usable_tables) if usable_tables else self._all_tables
+
+        if not isinstance(sample_rows_in_table_info, int):
+            raise TypeError("sample_rows_in_table_info must be an integer")
+
+        self._sample_rows_in_table_info = sample_rows_in_table_info
+        self._indexes_in_table_info = indexes_in_table_info
+
+        self._custom_table_info = custom_table_info
+        if self._custom_table_info:
+            if not isinstance(self._custom_table_info, dict):
+                raise TypeError(
+                    "table_info must be a dictionary with table names as keys and the "
+                    "desired table info as values"
+                )
+            # only keep the tables that are also present in the database
+            intersection = set(self._custom_table_info).intersection(self._all_tables)
+            self._custom_table_info = dict(
+                (table, self._custom_table_info[table])
+                for table in self._custom_table_info
+                if table in intersection
+            )
+
+        self._max_string_length = max_string_length
+        self._view_support = view_support
+
+        self._metadata = metadata or MetaData()
+        if not lazy_table_reflection:
+            # including view support if view_support = true
+            self._metadata.reflect(
+                views=view_support,
+                bind=self._engine,
+                only=list(self._usable_tables),
+                schema=self._schema,
+            )
+
+    @classmethod
+    def from_uri(
+        cls, database_uri: str, engine_args: Optional[dict] = None, **kwargs: Any
+    ) -> SQLDatabase:
+        """Construct a SQLAlchemy engine from URI."""
+        _engine_args = engine_args or {}
+        return cls(create_engine(database_uri, **_engine_args), **kwargs)
+
+    @classmethod
+    def from_databricks(
+        cls,
+        catalog: str,
+        schema: str,
+        host: Optional[str] = None,
+        api_token: Optional[str] = None,
+        warehouse_id: Optional[str] = None,
+        cluster_id: Optional[str] = None,
+        engine_args: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> SQLDatabase:
+        """
+        Class method to create an SQLDatabase instance from a Databricks connection.
+        This method requires the 'databricks-sql-connector' package. If not installed,
+        it can be added using `pip install databricks-sql-connector`.
+
+        Args:
+            catalog (str): The catalog name in the Databricks database.
+            schema (str): The schema name in the catalog.
+            host (Optional[str]): The Databricks workspace hostname, excluding
+                'https://' part. If not provided, it attempts to fetch from the
+                environment variable 'DATABRICKS_HOST'. If still unavailable and if
+                running in a Databricks notebook, it defaults to the current workspace
+                hostname. Defaults to None.
+            api_token (Optional[str]): The Databricks personal access token for
+                accessing the Databricks SQL warehouse or the cluster. If not provided,
+                it attempts to fetch from 'DATABRICKS_TOKEN'. If still unavailable
+                and running in a Databricks notebook, a temporary token for the current
+                user is generated. Defaults to None.
+            warehouse_id (Optional[str]): The warehouse ID in the Databricks SQL. If
+                provided, the method configures the connection to use this warehouse.
+                Cannot be used with 'cluster_id'. Defaults to None.
+            cluster_id (Optional[str]): The cluster ID in the Databricks Runtime. If
+                provided, the method configures the connection to use this cluster.
+                Cannot be used with 'warehouse_id'. If running in a Databricks notebook
+                and both 'warehouse_id' and 'cluster_id' are None, it uses the ID of the
+                cluster the notebook is attached to. Defaults to None.
+            engine_args (Optional[dict]): The arguments to be used when connecting
+                Databricks. Defaults to None.
+            **kwargs (Any): Additional keyword arguments for the `from_uri` method.
+
+        Returns:
+            SQLDatabase: An instance of SQLDatabase configured with the provided
+                Databricks connection details.
+
+        Raises:
+            ValueError: If 'databricks-sql-connector' is not found, or if both
+                'warehouse_id' and 'cluster_id' are provided, or if neither
+                'warehouse_id' nor 'cluster_id' are provided and it's not executing
+                inside a Databricks notebook.
+        """
+        try:
+            from databricks import sql  # noqa: F401
+        except ImportError:
+            raise ValueError(
+                "databricks-sql-connector package not found, please install with"
+                " `pip install databricks-sql-connector`"
+            )
+        context = None
+        try:
+            from dbruntime.databricks_repl_context import get_context
+
+            context = get_context()
+        except ImportError:
+            pass
+
+        default_host = context.browserHostName if context else None
+        if host is None:
+            host = get_from_env("host", "DATABRICKS_HOST", default_host)
+
+        default_api_token = context.apiToken if context else None
+        if api_token is None:
+            api_token = get_from_env("api_token", "DATABRICKS_TOKEN", default_api_token)
+
+        if warehouse_id is None and cluster_id is None:
+            if context:
+                cluster_id = context.clusterId
+            else:
+                raise ValueError(
+                    "Need to provide either 'warehouse_id' or 'cluster_id'."
+                )
+
+        if warehouse_id and cluster_id:
+            raise ValueError("Can't have both 'warehouse_id' or 'cluster_id'.")
+
+        if warehouse_id:
+            http_path = f"/sql/1.0/warehouses/{warehouse_id}"
+        else:
+            http_path = f"/sql/protocolv1/o/0/{cluster_id}"
+
+        uri = (
+            f"databricks://token:{api_token}@{host}?"
+            f"http_path={http_path}&catalog={catalog}&schema={schema}"
+        )
+        return cls.from_uri(database_uri=uri, engine_args=engine_args, **kwargs)
+
+    @classmethod
+    def from_cnosdb(
+        cls,
+        url: str = "127.0.0.1:8902",
+        user: str = "root",
+        password: str = "",
+        tenant: str = "cnosdb",
+        database: str = "public",
+    ) -> SQLDatabase:
+        """
+        Class method to create an SQLDatabase instance from a CnosDB connection.
+        This method requires the 'cnos-connector' package. If not installed, it
+        can be added using `pip install cnos-connector`.
+
+        Args:
+            url (str): The HTTP connection host name and port number of the CnosDB
+                service, excluding "http://" or "https://", with a default value
+                of "127.0.0.1:8902".
+            user (str): The username used to connect to the CnosDB service, with a
+                default value of "root".
+            password (str): The password of the user connecting to the CnosDB service,
+                with a default value of "".
+            tenant (str): The name of the tenant used to connect to the CnosDB service,
+                with a default value of "cnosdb".
+            database (str): The name of the database in the CnosDB tenant.
+
+        Returns:
+            SQLDatabase: An instance of SQLDatabase configured with the provided
+            CnosDB connection details.
+        """
+        try:
+            from cnosdb_connector import make_cnosdb_langchain_uri
+
+            uri = make_cnosdb_langchain_uri(url, user, password, tenant, database)
+            return cls.from_uri(database_uri=uri)
+        except ImportError:
+            raise ValueError(
+                "cnos-connector package not found, please install with"
+                " `pip install cnos-connector`"
+            )
+
+    @property
+    def dialect(self) -> str:
+        """Return string representation of dialect to use."""
+        return self._engine.dialect.name
+
+    def get_usable_table_names(self) -> Iterable[str]:
+        """Get names of tables available."""
+        if self._include_tables:
+            return sorted(self._include_tables)
+        return sorted(self._all_tables - self._ignore_tables)
+
+    @deprecated("0.0.1", alternative="get_usable_table_name", removal="0.2.0")
+    def get_table_names(self) -> Iterable[str]:
+        """Get names of tables available."""
+        return self.get_usable_table_names()
+
+    @property
+    def table_info(self) -> str:
+        """Information about all tables in the database."""
+        return self.get_table_info()
+
+    def get_table_info(self, table_names: Optional[List[str]] = None) -> str:
+        """Get information about specified tables.
+
+        Follows best practices as specified in: Rajkumar et al, 2022
+        (https://arxiv.org/abs/2204.00498)
+
+        If `sample_rows_in_table_info`, the specified number of sample rows will be
+        appended to each table description. This can increase performance as
+        demonstrated in the paper.
+        """
+        all_table_names = self.get_usable_table_names()
+        if table_names is not None:
+            missing_tables = set(table_names).difference(all_table_names)
+            if missing_tables:
+                raise ValueError(f"table_names {missing_tables} not found in database")
+            all_table_names = table_names
+
+        metadata_table_names = [tbl.name for tbl in self._metadata.sorted_tables]
+        to_reflect = set(all_table_names) - set(metadata_table_names)
+        if to_reflect:
+            self._metadata.reflect(
+                views=self._view_support,
+                bind=self._engine,
+                only=list(to_reflect),
+                schema=self._schema,
+            )
+
+        meta_tables = [
+            tbl
+            for tbl in self._metadata.sorted_tables
+            if tbl.name in set(all_table_names)
+            and not (self.dialect == "sqlite" and tbl.name.startswith("sqlite_"))
+        ]
+
+        tables = []
+        for table in meta_tables:
+            if self._custom_table_info and table.name in self._custom_table_info:
+                tables.append(self._custom_table_info[table.name])
+                continue
+
+            # Ignore JSON datatyped columns
+            for k, v in table.columns.items():
+                if type(v.type) is NullType:
+                    table._columns.remove(v)
+
+            # add create table command
+            create_table = str(CreateTable(table).compile(self._engine))
+            table_info = f"{create_table.rstrip()}"
+            has_extra_info = (
+                self._indexes_in_table_info or self._sample_rows_in_table_info
+            )
+            if has_extra_info:
+                table_info += "\n\n/*"
+            if self._indexes_in_table_info:
+                table_info += f"\n{self._get_table_indexes(table)}\n"
+            if self._sample_rows_in_table_info:
+                table_info += f"\n{self._get_sample_rows(table)}\n"
+            if has_extra_info:
+                table_info += "*/"
+            tables.append(table_info)
+        tables.sort()
+        final_str = "\n\n".join(tables)
+        return final_str
+
+    def _get_table_indexes(self, table: Table) -> str:
+        indexes = self._inspector.get_indexes(table.name)
+        indexes_formatted = "\n".join(map(_format_index, indexes))
+        return f"Table Indexes:\n{indexes_formatted}"
+
+    def _get_sample_rows(self, table: Table) -> str:
+        # build the select command
+        command = select(table).limit(self._sample_rows_in_table_info)
+
+        # save the columns in string format
+        columns_str = "\t".join([col.name for col in table.columns])
+
+        try:
+            # get the sample rows
+            with self._engine.connect() as connection:
+                sample_rows_result = connection.execute(command)  # type: ignore
+                # shorten values in the sample rows
+                sample_rows = list(
+                    map(lambda ls: [str(i)[:100] for i in ls], sample_rows_result)
+                )
+
+            # save the sample rows in string format
+            sample_rows_str = "\n".join(["\t".join(row) for row in sample_rows])
+
+        # in some dialects when there are no rows in the table a
+        # 'ProgrammingError' is returned
+        except ProgrammingError:
+            sample_rows_str = ""
+
+        return (
+            f"{self._sample_rows_in_table_info} rows from {table.name} table:\n"
+            f"{columns_str}\n"
+            f"{sample_rows_str}"
+        )
+
+    def _execute(
+        self,
+        command: Union[str, Executable],
+        fetch: Literal["all", "one", "cursor"] = "all",
+        *,
+        parameters: Optional[Dict[str, Any]] = None,
+        execution_options: Optional[Dict[str, Any]] = None,
+    ) -> Union[Sequence[Dict[str, Any]], Result]:
+        """
+        Executes SQL command through underlying engine.
+
+        If the statement returns no rows, an empty list is returned.
+        """
+        parameters = parameters or {}
+        execution_options = execution_options or {}
+        with self._engine.begin() as connection:  # type: Connection  # type: ignore[name-defined]
+            if self._schema is not None:
+                if self.dialect == "snowflake":
+                    connection.exec_driver_sql(
+                        "ALTER SESSION SET search_path = %s",
+                        (self._schema,),
+                        execution_options=execution_options,
+                    )
+                elif self.dialect == "bigquery":
+                    connection.exec_driver_sql(
+                        "SET @@dataset_id=?",
+                        (self._schema,),
+                        execution_options=execution_options,
+                    )
+                elif self.dialect == "mssql":
+                    pass
+                elif self.dialect == "trino":
+                    connection.exec_driver_sql(
+                        "USE ?",
+                        (self._schema,),
+                        execution_options=execution_options,
+                    )
+                elif self.dialect == "duckdb":
+                    # Unclear which parameterized argument syntax duckdb supports.
+                    # The docs for the duckdb client say they support multiple,
+                    # but `duckdb_engine` seemed to struggle with all of them:
+                    # https://github.com/Mause/duckdb_engine/issues/796
+                    connection.exec_driver_sql(
+                        f"SET search_path TO {self._schema}",
+                        execution_options=execution_options,
+                    )
+                elif self.dialect == "oracle":
+                    connection.exec_driver_sql(
+                        f"ALTER SESSION SET CURRENT_SCHEMA = {self._schema}",
+                        execution_options=execution_options,
+                    )
+                elif self.dialect == "sqlany":
+                    # If anybody using Sybase SQL anywhere database then it should not
+                    # go to else condition. It should be same as mssql.
+                    pass
+                elif self.dialect == "postgresql":  # postgresql
+                    connection.exec_driver_sql(
+                        "SET search_path TO %s",
+                        (self._schema,),
+                        execution_options=execution_options,
+                    )
+
+            if isinstance(command, str):
+                command = text(command)
+            elif isinstance(command, Executable):
+                pass
+            else:
+                raise TypeError(f"Query expression has unknown type: {type(command)}")
+            cursor = connection.execute(
+                command,
+                parameters,
+                execution_options=execution_options,
+            )
+
+            if cursor.returns_rows:
+                if fetch == "all":
+                    result = [x._asdict() for x in cursor.fetchall()]
+                elif fetch == "one":
+                    first_result = cursor.fetchone()
+                    result = [] if first_result is None else [first_result._asdict()]
+                elif fetch == "cursor":
+                    return cursor
+                else:
+                    raise ValueError(
+                        "Fetch parameter must be either 'one', 'all', or 'cursor'"
+                    )
+                return result
+        return []
+
+    def run(
+        self,
+        command: Union[str, Executable],
+        fetch: Literal["all", "one", "cursor"] = "all",
+        include_columns: bool = False,
+        *,
+        parameters: Optional[Dict[str, Any]] = None,
+        execution_options: Optional[Dict[str, Any]] = None,
+    ) -> Union[str, Sequence[Dict[str, Any]], Result[Any]]:
+        """Execute a SQL command and return a string representing the results.
+
+        If the statement returns rows, a string of the results is returned.
+        If the statement returns no rows, an empty string is returned.
+        """
+        result = self._execute(
+            command, fetch, parameters=parameters, execution_options=execution_options
+        )
+
+        if fetch == "cursor":
+            return result
+
+        res = [
+            {
+                column: truncate_word(value, length=self._max_string_length)
+                for column, value in r.items()
+            }
+            for r in result
+        ]
+
+        if not include_columns:
+            res = [tuple(row.values()) for row in res]  # type: ignore[misc]
+
+        if not res:
+            return ""
+        else:
+            return str(res)
+
+    def get_table_info_no_throw(self, table_names: Optional[List[str]] = None) -> str:
+        """Get information about specified tables.
+
+        Follows best practices as specified in: Rajkumar et al, 2022
+        (https://arxiv.org/abs/2204.00498)
+
+        If `sample_rows_in_table_info`, the specified number of sample rows will be
+        appended to each table description. This can increase performance as
+        demonstrated in the paper.
+        """
+        try:
+            return self.get_table_info(table_names)
+        except ValueError as e:
+            """Format the error message"""
+            return f"Error: {e}"
+
+    def run_no_throw(
+        self,
+        command: str,
+        fetch: Literal["all", "one"] = "all",
+        include_columns: bool = False,
+        *,
+        parameters: Optional[Dict[str, Any]] = None,
+        execution_options: Optional[Dict[str, Any]] = None,
+    ) -> Union[str, Sequence[Dict[str, Any]], Result[Any]]:
+        """Execute a SQL command and return a string representing the results.
+
+        If the statement returns rows, a string of the results is returned.
+        If the statement returns no rows, an empty string is returned.
+
+        If the statement throws an error, the error message is returned.
+        """
+        try:
+            return self.run(
+                command,
+                fetch,
+                parameters=parameters,
+                execution_options=execution_options,
+                include_columns=include_columns,
+            )
+        except SQLAlchemyError as e:
+            """Format the error message"""
+            return f"Error: {e}"
+
+    def get_context(self) -> Dict[str, Any]:
+        """Return db context that you may want in agent prompt."""
+        table_names = list(self.get_usable_table_names())
+        table_info = self.get_table_info_no_throw()
+        return {"table_info": table_info, "table_names": ", ".join(table_names)}
diff --git a/llm/Lib/site-packages/langchain_community/utilities/stackexchange.py b/llm/Lib/site-packages/langchain_community/utilities/stackexchange.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ad72b425410d2f4ece436b3ad812b35bd1ca401
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/stackexchange.py
@@ -0,0 +1,68 @@
+import html
+from typing import Any, Dict, Literal
+
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+
+
+class StackExchangeAPIWrapper(BaseModel):
+    """Wrapper for Stack Exchange API."""
+
+    client: Any  #: :meta private:
+    max_results: int = 3
+    """Max number of results to include in output."""
+    query_type: Literal["all", "title", "body"] = "all"
+    """Which part of StackOverflows items to match against. One of 'all', 'title', 
+        'body'. Defaults to 'all'.
+    """
+    fetch_params: Dict[str, Any] = Field(default_factory=dict)
+    """Additional params to pass to StackApi.fetch."""
+    result_separator: str = "\n\n"
+    """Separator between question,answer pairs."""
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the required Python package exists."""
+        try:
+            from stackapi import StackAPI
+
+            values["client"] = StackAPI("stackoverflow")
+        except ImportError:
+            raise ImportError(
+                "The 'stackapi' Python package is not installed. "
+                "Please install it with `pip install stackapi`."
+            )
+        return values
+
+    def run(self, query: str) -> str:
+        """Run query through StackExchange API and parse results."""
+
+        query_key = "q" if self.query_type == "all" else self.query_type
+        output = self.client.fetch(
+            "search/excerpts", **{query_key: query}, **self.fetch_params
+        )
+        if len(output["items"]) < 1:
+            return f"No relevant results found for '{query}' on Stack Overflow."
+        questions = [
+            item for item in output["items"] if item["item_type"] == "question"
+        ][: self.max_results]
+        answers = [item for item in output["items"] if item["item_type"] == "answer"]
+        results = []
+        for question in questions:
+            res_text = f"Question: {question['title']}\n{question['excerpt']}"
+            relevant_answers = [
+                answer
+                for answer in answers
+                if answer["question_id"] == question["question_id"]
+            ]
+            accepted_answers = [
+                answer for answer in relevant_answers if answer["is_accepted"]
+            ]
+            if relevant_answers:
+                top_answer = (
+                    accepted_answers[0] if accepted_answers else relevant_answers[0]
+                )
+                excerpt = html.unescape(top_answer["excerpt"])
+                res_text += f"\nAnswer: {excerpt}"
+            results.append(res_text)
+
+        return self.result_separator.join(results)
diff --git a/llm/Lib/site-packages/langchain_community/utilities/steam.py b/llm/Lib/site-packages/langchain_community/utilities/steam.py
new file mode 100644
index 0000000000000000000000000000000000000000..778c3c6870e48b2dba8086beb70253e82b0cb674
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/steam.py
@@ -0,0 +1,164 @@
+"""Util that calls Steam-WebAPI."""
+
+from typing import Any, List
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+
+
+class SteamWebAPIWrapper(BaseModel):
+    """Wrapper for Steam API."""
+
+    steam: Any  # for python-steam-api
+
+    from langchain_community.tools.steam.prompt import (
+        STEAM_GET_GAMES_DETAILS,
+        STEAM_GET_RECOMMENDED_GAMES,
+    )
+
+    # operations: a list of dictionaries, each representing a specific operation that
+    # can be performed with the API
+    operations: List[dict] = [
+        {
+            "mode": "get_game_details",
+            "name": "Get Game Details",
+            "description": STEAM_GET_GAMES_DETAILS,
+        },
+        {
+            "mode": "get_recommended_games",
+            "name": "Get Recommended Games",
+            "description": STEAM_GET_RECOMMENDED_GAMES,
+        },
+    ]
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def get_operations(self) -> List[dict]:
+        """Return a list of operations."""
+        return self.operations
+
+    @root_validator
+    def validate_environment(cls, values: dict) -> dict:
+        """Validate api key and python package has been configured."""
+
+        # check if the python package is installed
+        try:
+            from steam import Steam
+        except ImportError:
+            raise ImportError("python-steam-api library is not installed. ")
+
+        try:
+            from decouple import config
+        except ImportError:
+            raise ImportError("decouple library is not installed. ")
+
+        # initialize the steam attribute for python-steam-api usage
+        KEY = config("STEAM_KEY")
+        steam = Steam(KEY)
+        values["steam"] = steam
+        return values
+
+    def parse_to_str(self, details: dict) -> str:  # For later parsing
+        """Parse the details result."""
+        result = ""
+        for key, value in details.items():
+            result += "The " + str(key) + " is: " + str(value) + "\n"
+        return result
+
+    def get_id_link_price(self, games: dict) -> dict:
+        """The response may contain more than one game, so we need to choose the right
+        one and return the id."""
+
+        game_info = {}
+        for app in games["apps"]:
+            game_info["id"] = app["id"]
+            game_info["link"] = app["link"]
+            game_info["price"] = app["price"]
+            break
+        return game_info
+
+    def remove_html_tags(self, html_string: str) -> str:
+        from bs4 import BeautifulSoup
+
+        soup = BeautifulSoup(html_string, "html.parser")
+        return soup.get_text()
+
+    def details_of_games(self, name: str) -> str:
+        games = self.steam.apps.search_games(name)
+        info_partOne_dict = self.get_id_link_price(games)
+        info_partOne = self.parse_to_str(info_partOne_dict)
+        id = str(info_partOne_dict.get("id"))
+        info_dict = self.steam.apps.get_app_details(id)
+        data = info_dict.get(id).get("data")
+        detailed_description = data.get("detailed_description")
+
+        # detailed_description contains <li> <br> some other html tags, so we need to
+        # remove them
+        detailed_description = self.remove_html_tags(detailed_description)
+        supported_languages = info_dict.get(id).get("data").get("supported_languages")
+        info_partTwo = (
+            "The summary of the game is: "
+            + detailed_description
+            + "\n"
+            + "The supported languages of the game are: "
+            + supported_languages
+            + "\n"
+        )
+        info = info_partOne + info_partTwo
+        return info
+
+    def get_steam_id(self, name: str) -> str:
+        user = self.steam.users.search_user(name)
+        steam_id = user["player"]["steamid"]
+        return steam_id
+
+    def get_users_games(self, steam_id: str) -> List[str]:
+        return self.steam.users.get_owned_games(steam_id, False, False)
+
+    def recommended_games(self, steam_id: str) -> str:
+        try:
+            import steamspypi
+        except ImportError:
+            raise ImportError("steamspypi library is not installed.")
+        users_games = self.get_users_games(steam_id)
+        result = {}  # type: ignore
+        most_popular_genre = ""
+        most_popular_genre_count = 0
+        for game in users_games["games"]:  # type: ignore
+            appid = game["appid"]
+            data_request = {"request": "appdetails", "appid": appid}
+            genreStore = steamspypi.download(data_request)
+            genreList = genreStore.get("genre", "").split(", ")
+
+            for genre in genreList:
+                if genre in result:
+                    result[genre] += 1
+                else:
+                    result[genre] = 1
+                if result[genre] > most_popular_genre_count:
+                    most_popular_genre_count = result[genre]
+                    most_popular_genre = genre
+
+        data_request = dict()
+        data_request["request"] = "genre"
+        data_request["genre"] = most_popular_genre
+        data = steamspypi.download(data_request)
+        sorted_data = sorted(
+            data.values(), key=lambda x: x.get("average_forever", 0), reverse=True
+        )
+        owned_games = [game["appid"] for game in users_games["games"]]  # type: ignore
+        remaining_games = [
+            game for game in sorted_data if game["appid"] not in owned_games
+        ]
+        top_5_popular_not_owned = [game["name"] for game in remaining_games[:5]]
+        return str(top_5_popular_not_owned)
+
+    def run(self, mode: str, game: str) -> str:
+        if mode == "get_games_details":
+            return self.details_of_games(game)
+        elif mode == "get_recommended_games":
+            return self.recommended_games(game)
+        else:
+            raise ValueError(f"Invalid mode {mode} for Steam API.")
diff --git a/llm/Lib/site-packages/langchain_community/utilities/tavily_search.py b/llm/Lib/site-packages/langchain_community/utilities/tavily_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..97dc45363f2eee9fc4c6bb886717dd40cb972837
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/tavily_search.py
@@ -0,0 +1,183 @@
+"""Util that calls Tavily Search API.
+
+In order to set this up, follow instructions at:
+"""
+import json
+from typing import Dict, List, Optional
+
+import aiohttp
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra, SecretStr, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+TAVILY_API_URL = "https://api.tavily.com"
+
+
+class TavilySearchAPIWrapper(BaseModel):
+    """Wrapper for Tavily Search API."""
+
+    tavily_api_key: SecretStr
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and endpoint exists in environment."""
+        tavily_api_key = get_from_dict_or_env(
+            values, "tavily_api_key", "TAVILY_API_KEY"
+        )
+        values["tavily_api_key"] = tavily_api_key
+
+        return values
+
+    def raw_results(
+        self,
+        query: str,
+        max_results: Optional[int] = 5,
+        search_depth: Optional[str] = "advanced",
+        include_domains: Optional[List[str]] = [],
+        exclude_domains: Optional[List[str]] = [],
+        include_answer: Optional[bool] = False,
+        include_raw_content: Optional[bool] = False,
+        include_images: Optional[bool] = False,
+    ) -> Dict:
+        params = {
+            "api_key": self.tavily_api_key.get_secret_value(),
+            "query": query,
+            "max_results": max_results,
+            "search_depth": search_depth,
+            "include_domains": include_domains,
+            "exclude_domains": exclude_domains,
+            "include_answer": include_answer,
+            "include_raw_content": include_raw_content,
+            "include_images": include_images,
+        }
+        response = requests.post(
+            # type: ignore
+            f"{TAVILY_API_URL}/search",
+            json=params,
+        )
+        response.raise_for_status()
+        return response.json()
+
+    def results(
+        self,
+        query: str,
+        max_results: Optional[int] = 5,
+        search_depth: Optional[str] = "advanced",
+        include_domains: Optional[List[str]] = [],
+        exclude_domains: Optional[List[str]] = [],
+        include_answer: Optional[bool] = False,
+        include_raw_content: Optional[bool] = False,
+        include_images: Optional[bool] = False,
+    ) -> List[Dict]:
+        """Run query through Tavily Search and return metadata.
+
+        Args:
+            query: The query to search for.
+            max_results: The maximum number of results to return.
+            search_depth: The depth of the search. Can be "basic" or "advanced".
+            include_domains: A list of domains to include in the search.
+            exclude_domains: A list of domains to exclude from the search.
+            include_answer: Whether to include the answer in the results.
+            include_raw_content: Whether to include the raw content in the results.
+            include_images: Whether to include images in the results.
+        Returns:
+            query: The query that was searched for.
+            follow_up_questions: A list of follow up questions.
+            response_time: The response time of the query.
+            answer: The answer to the query.
+            images: A list of images.
+            results: A list of dictionaries containing the results:
+                title: The title of the result.
+                url: The url of the result.
+                content: The content of the result.
+                score: The score of the result.
+                raw_content: The raw content of the result.
+        """  # noqa: E501
+        raw_search_results = self.raw_results(
+            query,
+            max_results=max_results,
+            search_depth=search_depth,
+            include_domains=include_domains,
+            exclude_domains=exclude_domains,
+            include_answer=include_answer,
+            include_raw_content=include_raw_content,
+            include_images=include_images,
+        )
+        return self.clean_results(raw_search_results["results"])
+
+    async def raw_results_async(
+        self,
+        query: str,
+        max_results: Optional[int] = 5,
+        search_depth: Optional[str] = "advanced",
+        include_domains: Optional[List[str]] = [],
+        exclude_domains: Optional[List[str]] = [],
+        include_answer: Optional[bool] = False,
+        include_raw_content: Optional[bool] = False,
+        include_images: Optional[bool] = False,
+    ) -> Dict:
+        """Get results from the Tavily Search API asynchronously."""
+
+        # Function to perform the API call
+        async def fetch() -> str:
+            params = {
+                "api_key": self.tavily_api_key.get_secret_value(),
+                "query": query,
+                "max_results": max_results,
+                "search_depth": search_depth,
+                "include_domains": include_domains,
+                "exclude_domains": exclude_domains,
+                "include_answer": include_answer,
+                "include_raw_content": include_raw_content,
+                "include_images": include_images,
+            }
+            async with aiohttp.ClientSession() as session:
+                async with session.post(f"{TAVILY_API_URL}/search", json=params) as res:
+                    if res.status == 200:
+                        data = await res.text()
+                        return data
+                    else:
+                        raise Exception(f"Error {res.status}: {res.reason}")
+
+        results_json_str = await fetch()
+        return json.loads(results_json_str)
+
+    async def results_async(
+        self,
+        query: str,
+        max_results: Optional[int] = 5,
+        search_depth: Optional[str] = "advanced",
+        include_domains: Optional[List[str]] = [],
+        exclude_domains: Optional[List[str]] = [],
+        include_answer: Optional[bool] = False,
+        include_raw_content: Optional[bool] = False,
+        include_images: Optional[bool] = False,
+    ) -> List[Dict]:
+        results_json = await self.raw_results_async(
+            query=query,
+            max_results=max_results,
+            search_depth=search_depth,
+            include_domains=include_domains,
+            exclude_domains=exclude_domains,
+            include_answer=include_answer,
+            include_raw_content=include_raw_content,
+            include_images=include_images,
+        )
+        return self.clean_results(results_json["results"])
+
+    def clean_results(self, results: List[Dict]) -> List[Dict]:
+        """Clean results from Tavily Search API."""
+        clean_results = []
+        for result in results:
+            clean_results.append(
+                {
+                    "url": result["url"],
+                    "content": result["content"],
+                }
+            )
+        return clean_results
diff --git a/llm/Lib/site-packages/langchain_community/utilities/tensorflow_datasets.py b/llm/Lib/site-packages/langchain_community/utilities/tensorflow_datasets.py
new file mode 100644
index 0000000000000000000000000000000000000000..8f96c9c0c296310d039d5656571e5263c32b8e3f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/tensorflow_datasets.py
@@ -0,0 +1,110 @@
+import logging
+from typing import Any, Callable, Dict, Iterator, List, Optional
+
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+logger = logging.getLogger(__name__)
+
+
+class TensorflowDatasets(BaseModel):
+    """Access to the TensorFlow Datasets.
+
+    The Current implementation can work only with datasets that fit in a memory.
+
+    `TensorFlow Datasets` is a collection of datasets ready to use, with TensorFlow
+    or other Python ML frameworks, such as Jax. All datasets are exposed
+    as `tf.data.Datasets`.
+    To get started see the Guide: https://www.tensorflow.org/datasets/overview and
+    the list of datasets: https://www.tensorflow.org/datasets/catalog/
+                                               overview#all_datasets
+
+    You have to provide the sample_to_document_function: a function that
+       a sample from the dataset-specific format to the Document.
+
+    Attributes:
+        dataset_name: the name of the dataset to load
+        split_name: the name of the split to load. Defaults to "train".
+        load_max_docs: a limit to the number of loaded documents. Defaults to 100.
+        sample_to_document_function: a function that converts a dataset sample
+          to a Document
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.utilities import TensorflowDatasets
+
+            def mlqaen_example_to_document(example: dict) -> Document:
+                return Document(
+                    page_content=decode_to_str(example["context"]),
+                    metadata={
+                        "id": decode_to_str(example["id"]),
+                        "title": decode_to_str(example["title"]),
+                        "question": decode_to_str(example["question"]),
+                        "answer": decode_to_str(example["answers"]["text"][0]),
+                    },
+                )
+
+            tsds_client = TensorflowDatasets(
+                    dataset_name="mlqa/en",
+                    split_name="train",
+                    load_max_docs=MAX_DOCS,
+                    sample_to_document_function=mlqaen_example_to_document,
+                )
+
+    """
+
+    dataset_name: str = ""
+    split_name: str = "train"
+    load_max_docs: int = 100
+    sample_to_document_function: Optional[Callable[[Dict], Document]] = None
+    dataset: Any  #: :meta private:
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in environment."""
+        try:
+            import tensorflow  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "Could not import tensorflow python package. "
+                "Please install it with `pip install tensorflow`."
+            )
+        try:
+            import tensorflow_datasets
+        except ImportError:
+            raise ImportError(
+                "Could not import tensorflow_datasets python package. "
+                "Please install it with `pip install tensorflow-datasets`."
+            )
+        if values["sample_to_document_function"] is None:
+            raise ValueError(
+                "sample_to_document_function is None. "
+                "Please provide a function that converts a dataset sample to"
+                "  a Document."
+            )
+        values["dataset"] = tensorflow_datasets.load(
+            values["dataset_name"], split=values["split_name"]
+        )
+
+        return values
+
+    def lazy_load(self) -> Iterator[Document]:
+        """Download a selected dataset lazily.
+
+        Returns: an iterator of Documents.
+
+        """
+        return (
+            self.sample_to_document_function(s)
+            for s in self.dataset.take(self.load_max_docs)
+            if self.sample_to_document_function is not None
+        )
+
+    def load(self) -> List[Document]:
+        """Download a selected dataset.
+
+        Returns: a list of Documents.
+
+        """
+        return list(self.lazy_load())
diff --git a/llm/Lib/site-packages/langchain_community/utilities/twilio.py b/llm/Lib/site-packages/langchain_community/utilities/twilio.py
new file mode 100644
index 0000000000000000000000000000000000000000..a3ff0b236964e773d1774a322a9ce854b5a61f47
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/twilio.py
@@ -0,0 +1,82 @@
+"""Util that calls Twilio."""
+from typing import Any, Dict, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class TwilioAPIWrapper(BaseModel):
+    """Messaging Client using Twilio.
+
+    To use, you should have the ``twilio`` python package installed,
+    and the environment variables ``TWILIO_ACCOUNT_SID``, ``TWILIO_AUTH_TOKEN``, and
+    ``TWILIO_FROM_NUMBER``, or pass `account_sid`, `auth_token`, and `from_number` as
+    named parameters to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.utilities.twilio import TwilioAPIWrapper
+            twilio = TwilioAPIWrapper(
+                account_sid="ACxxx",
+                auth_token="xxx",
+                from_number="+10123456789"
+            )
+            twilio.run('test', '+12484345508')
+    """
+
+    client: Any  #: :meta private:
+    account_sid: Optional[str] = None
+    """Twilio account string identifier."""
+    auth_token: Optional[str] = None
+    """Twilio auth token."""
+    from_number: Optional[str] = None
+    """A Twilio phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) 
+        format, an 
+        [alphanumeric sender ID](https://www.twilio.com/docs/sms/send-messages#use-an-alphanumeric-sender-id), 
+        or a [Channel Endpoint address](https://www.twilio.com/docs/sms/channels#channel-addresses) 
+        that is enabled for the type of message you want to send. Phone numbers or 
+        [short codes](https://www.twilio.com/docs/sms/api/short-code) purchased from 
+        Twilio also work here. You cannot, for example, spoof messages from a private 
+        cell phone number. If you are using `messaging_service_sid`, this parameter 
+        must be empty.
+    """  # noqa: E501
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = False
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        try:
+            from twilio.rest import Client
+        except ImportError:
+            raise ImportError(
+                "Could not import twilio python package. "
+                "Please install it with `pip install twilio`."
+            )
+        account_sid = get_from_dict_or_env(values, "account_sid", "TWILIO_ACCOUNT_SID")
+        auth_token = get_from_dict_or_env(values, "auth_token", "TWILIO_AUTH_TOKEN")
+        values["from_number"] = get_from_dict_or_env(
+            values, "from_number", "TWILIO_FROM_NUMBER"
+        )
+        values["client"] = Client(account_sid, auth_token)
+        return values
+
+    def run(self, body: str, to: str) -> str:
+        """Run body through Twilio and respond with message sid.
+
+        Args:
+            body: The text of the message you want to send. Can be up to 1,600
+                characters in length.
+            to: The destination phone number in
+                [E.164](https://www.twilio.com/docs/glossary/what-e164) format for
+                SMS/MMS or
+                [Channel user address](https://www.twilio.com/docs/sms/channels#channel-addresses)
+                for other 3rd-party channels.
+        """  # noqa: E501
+        message = self.client.messages.create(to, from_=self.from_number, body=body)
+        return message.sid
diff --git a/llm/Lib/site-packages/langchain_community/utilities/vertexai.py b/llm/Lib/site-packages/langchain_community/utilities/vertexai.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a8023b36ca6250683ee478a63346440d12a28f0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/vertexai.py
@@ -0,0 +1,124 @@
+"""Utilities to init Vertex AI."""
+from importlib import metadata
+from typing import TYPE_CHECKING, Any, Callable, Optional, Union
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.llms import BaseLLM, create_base_retry_decorator
+
+if TYPE_CHECKING:
+    from google.api_core.gapic_v1.client_info import ClientInfo
+    from google.auth.credentials import Credentials
+    from vertexai.preview.generative_models import Image
+
+
+def create_retry_decorator(
+    llm: BaseLLM,
+    *,
+    max_retries: int = 1,
+    run_manager: Optional[
+        Union[AsyncCallbackManagerForLLMRun, CallbackManagerForLLMRun]
+    ] = None,
+) -> Callable[[Any], Any]:
+    """Create a retry decorator for Vertex / Palm LLMs."""
+    import google.api_core
+
+    errors = [
+        google.api_core.exceptions.ResourceExhausted,
+        google.api_core.exceptions.ServiceUnavailable,
+        google.api_core.exceptions.Aborted,
+        google.api_core.exceptions.DeadlineExceeded,
+        google.api_core.exceptions.GoogleAPIError,
+    ]
+    decorator = create_base_retry_decorator(
+        error_types=errors, max_retries=max_retries, run_manager=run_manager
+    )
+    return decorator
+
+
+def raise_vertex_import_error(minimum_expected_version: str = "1.38.0") -> None:
+    """Raise ImportError related to Vertex SDK being not available.
+
+    Args:
+        minimum_expected_version: The lowest expected version of the SDK.
+    Raises:
+        ImportError: an ImportError that mentions a required version of the SDK.
+    """
+    raise ImportError(
+        "Please, install or upgrade the google-cloud-aiplatform library: "
+        f"pip install google-cloud-aiplatform>={minimum_expected_version}"
+    )
+
+
+def init_vertexai(
+    project: Optional[str] = None,
+    location: Optional[str] = None,
+    credentials: Optional["Credentials"] = None,
+) -> None:
+    """Init Vertex AI.
+
+    Args:
+        project: The default GCP project to use when making Vertex API calls.
+        location: The default location to use when making API calls.
+        credentials: The default custom
+            credentials to use when making API calls. If not provided credentials
+            will be ascertained from the environment.
+
+    Raises:
+        ImportError: If importing vertexai SDK did not succeed.
+    """
+    try:
+        import vertexai
+    except ImportError:
+        raise_vertex_import_error()
+
+    vertexai.init(
+        project=project,
+        location=location,
+        credentials=credentials,
+    )
+
+
+def get_client_info(module: Optional[str] = None) -> "ClientInfo":
+    r"""Return a custom user agent header.
+
+    Args:
+        module (Optional[str]):
+            Optional. The module for a custom user agent header.
+    Returns:
+        google.api_core.gapic_v1.client_info.ClientInfo
+    """
+    try:
+        from google.api_core.gapic_v1.client_info import ClientInfo
+    except ImportError as exc:
+        raise ImportError(
+            "Could not import ClientInfo. Please, install it with "
+            "pip install google-api-core"
+        ) from exc
+
+    langchain_version = metadata.version("langchain")
+    client_library_version = (
+        f"{langchain_version}-{module}" if module else langchain_version
+    )
+    return ClientInfo(
+        client_library_version=client_library_version,
+        user_agent=f"langchain/{client_library_version}",
+    )
+
+
+def load_image_from_gcs(path: str, project: Optional[str] = None) -> "Image":
+    """Load an image from Google Cloud Storage."""
+    try:
+        from google.cloud import storage
+    except ImportError:
+        raise ImportError("Could not import google-cloud-storage python package.")
+    from vertexai.preview.generative_models import Image
+
+    gcs_client = storage.Client(project=project)
+    pieces = path.split("/")
+    blobs = list(gcs_client.list_blobs(pieces[2], prefix="/".join(pieces[3:])))
+    if len(blobs) > 1:
+        raise ValueError(f"Found more than one candidate for {path}!")
+    return Image.from_bytes(blobs[0].download_as_bytes())
diff --git a/llm/Lib/site-packages/langchain_community/utilities/wikidata.py b/llm/Lib/site-packages/langchain_community/utilities/wikidata.py
new file mode 100644
index 0000000000000000000000000000000000000000..c31009d78d62fd2b7f9b73f4631053f904cc9f1a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/wikidata.py
@@ -0,0 +1,181 @@
+"""Util that calls Wikidata."""
+
+import logging
+from typing import Any, Dict, List, Optional
+
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+logger = logging.getLogger(__name__)
+
+WIKIDATA_MAX_QUERY_LENGTH = 300
+# Common properties you probably want to see filtered from https://www.wikidata.org/wiki/Wikidata:Database_reports/List_of_properties/all
+DEFAULT_PROPERTIES = [
+    "P31",
+    "P279",
+    "P27",
+    "P361",
+    "P527",
+    "P495",
+    "P17",
+    "P585",
+    "P131",
+    "P106",
+    "P21",
+    "P569",
+    "P570",
+    "P577",
+    "P50",
+    "P571",
+    "P641",
+    "P625",
+    "P19",
+    "P69",
+    "P108",
+    "P136",
+    "P39",
+    "P161",
+    "P20",
+    "P101",
+    "P179",
+    "P175",
+    "P7937",
+    "P57",
+    "P607",
+    "P509",
+    "P800",
+    "P449",
+    "P580",
+    "P582",
+    "P276",
+    "P69",
+    "P112",
+    "P740",
+    "P159",
+    "P452",
+    "P102",
+    "P1142",
+    "P1387",
+    "P1576",
+    "P140",
+    "P178",
+    "P287",
+    "P25",
+    "P22",
+    "P40",
+    "P185",
+    "P802",
+    "P1416",
+]
+DEFAULT_LANG_CODE = "en"
+WIKIDATA_USER_AGENT = "langchain-wikidata"
+WIKIDATA_API_URL = "https://www.wikidata.org/w/api.php"
+WIKIDATA_REST_API_URL = "https://www.wikidata.org/w/rest.php/wikibase/v0/"
+
+
+class WikidataAPIWrapper(BaseModel):
+    """Wrapper around the Wikidata API.
+
+    To use, you should have the ``wikibase-rest-api-client`` and
+    ``mediawikiapi `` python packages installed.
+    This wrapper will use the Wikibase APIs to conduct searches and
+    fetch item content. By default, it will return the item content
+    of the top-k results.
+    It limits the Document content by doc_content_chars_max.
+    """
+
+    wikidata_mw: Any  #: :meta private:
+    wikidata_rest: Any  # : :meta private:
+    top_k_results: int = 2
+    load_all_available_meta: bool = False
+    doc_content_chars_max: int = 4000
+    wikidata_props: List[str] = DEFAULT_PROPERTIES
+    lang: str = DEFAULT_LANG_CODE
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in environment."""
+        try:
+            from mediawikiapi import MediaWikiAPI
+            from mediawikiapi.config import Config
+
+            values["wikidata_mw"] = MediaWikiAPI(
+                Config(user_agent=WIKIDATA_USER_AGENT, mediawiki_url=WIKIDATA_API_URL)
+            )
+        except ImportError:
+            raise ImportError(
+                "Could not import mediawikiapi python package. "
+                "Please install it with `pip install mediawikiapi`."
+            )
+
+        try:
+            from wikibase_rest_api_client import Client
+
+            client = Client(
+                timeout=60,
+                base_url=WIKIDATA_REST_API_URL,
+                headers={"User-Agent": WIKIDATA_USER_AGENT},
+                follow_redirects=True,
+            )
+            values["wikidata_rest"] = client
+        except ImportError:
+            raise ImportError(
+                "Could not import wikibase_rest_api_client python package. "
+                "Please install it with `pip install wikibase-rest-api-client`."
+            )
+        return values
+
+    def _item_to_document(self, qid: str) -> Optional[Document]:
+        from wikibase_rest_api_client.utilities.fluent import FluentWikibaseClient
+
+        fluent_client: FluentWikibaseClient = FluentWikibaseClient(
+            self.wikidata_rest, supported_props=self.wikidata_props, lang=self.lang
+        )
+        resp = fluent_client.get_item(qid)
+
+        if not resp:
+            logger.warning(f"Could not find item {qid} in Wikidata")
+            return None
+
+        doc_lines = []
+        if resp.label:
+            doc_lines.append(f"Label: {resp.label}")
+        if resp.description:
+            doc_lines.append(f"Description: {resp.description}")
+        if resp.aliases:
+            doc_lines.append(f"Aliases: {', '.join(resp.aliases)}")
+        for prop, values in resp.statements.items():
+            if values:
+                doc_lines.append(f"{prop.label}: {', '.join(values)}")
+
+        return Document(
+            page_content=("\n".join(doc_lines))[: self.doc_content_chars_max],
+            meta={"title": qid, "source": f"https://www.wikidata.org/wiki/{qid}"},
+        )
+
+    def load(self, query: str) -> List[Document]:
+        """
+        Run Wikidata search and get the item documents plus the meta information.
+        """
+
+        clipped_query = query[:WIKIDATA_MAX_QUERY_LENGTH]
+        items = self.wikidata_mw.search(clipped_query, results=self.top_k_results)
+        docs = []
+        for item in items[: self.top_k_results]:
+            if doc := self._item_to_document(item):
+                docs.append(doc)
+        return docs
+
+    def run(self, query: str) -> str:
+        """Run Wikidata search and get item summaries."""
+
+        clipped_query = query[:WIKIDATA_MAX_QUERY_LENGTH]
+        items = self.wikidata_mw.search(clipped_query, results=self.top_k_results)
+
+        docs = []
+        for item in items[: self.top_k_results]:
+            if doc := self._item_to_document(item):
+                docs.append(f"Result {item}:\n{doc.page_content}")
+        if not docs:
+            return "No good Wikidata Search Result was found"
+        return "\n\n".join(docs)[: self.doc_content_chars_max]
diff --git a/llm/Lib/site-packages/langchain_community/utilities/wikipedia.py b/llm/Lib/site-packages/langchain_community/utilities/wikipedia.py
new file mode 100644
index 0000000000000000000000000000000000000000..3755368efcee310d44610e90e473c7b23a07abbe
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/wikipedia.py
@@ -0,0 +1,124 @@
+"""Util that calls Wikipedia."""
+import logging
+from typing import Any, Dict, Iterator, List, Optional
+
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+logger = logging.getLogger(__name__)
+
+WIKIPEDIA_MAX_QUERY_LENGTH = 300
+
+
+class WikipediaAPIWrapper(BaseModel):
+    """Wrapper around WikipediaAPI.
+
+    To use, you should have the ``wikipedia`` python package installed.
+    This wrapper will use the Wikipedia API to conduct searches and
+    fetch page summaries. By default, it will return the page summaries
+    of the top-k results.
+    It limits the Document content by doc_content_chars_max.
+    """
+
+    wiki_client: Any  #: :meta private:
+    top_k_results: int = 3
+    lang: str = "en"
+    load_all_available_meta: bool = False
+    doc_content_chars_max: int = 4000
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that the python package exists in environment."""
+        try:
+            import wikipedia
+
+            wikipedia.set_lang(values["lang"])
+            values["wiki_client"] = wikipedia
+        except ImportError:
+            raise ImportError(
+                "Could not import wikipedia python package. "
+                "Please install it with `pip install wikipedia`."
+            )
+        return values
+
+    def run(self, query: str) -> str:
+        """Run Wikipedia search and get page summaries."""
+        page_titles = self.wiki_client.search(
+            query[:WIKIPEDIA_MAX_QUERY_LENGTH], results=self.top_k_results
+        )
+        summaries = []
+        for page_title in page_titles[: self.top_k_results]:
+            if wiki_page := self._fetch_page(page_title):
+                if summary := self._formatted_page_summary(page_title, wiki_page):
+                    summaries.append(summary)
+        if not summaries:
+            return "No good Wikipedia Search Result was found"
+        return "\n\n".join(summaries)[: self.doc_content_chars_max]
+
+    @staticmethod
+    def _formatted_page_summary(page_title: str, wiki_page: Any) -> Optional[str]:
+        return f"Page: {page_title}\nSummary: {wiki_page.summary}"
+
+    def _page_to_document(self, page_title: str, wiki_page: Any) -> Document:
+        main_meta = {
+            "title": page_title,
+            "summary": wiki_page.summary,
+            "source": wiki_page.url,
+        }
+        add_meta = (
+            {
+                "categories": wiki_page.categories,
+                "page_url": wiki_page.url,
+                "image_urls": wiki_page.images,
+                "related_titles": wiki_page.links,
+                "parent_id": wiki_page.parent_id,
+                "references": wiki_page.references,
+                "revision_id": wiki_page.revision_id,
+                "sections": wiki_page.sections,
+            }
+            if self.load_all_available_meta
+            else {}
+        )
+        doc = Document(
+            page_content=wiki_page.content[: self.doc_content_chars_max],
+            metadata={
+                **main_meta,
+                **add_meta,
+            },
+        )
+        return doc
+
+    def _fetch_page(self, page: str) -> Optional[str]:
+        try:
+            return self.wiki_client.page(title=page, auto_suggest=False)
+        except (
+            self.wiki_client.exceptions.PageError,
+            self.wiki_client.exceptions.DisambiguationError,
+        ):
+            return None
+
+    def load(self, query: str) -> List[Document]:
+        """
+        Run Wikipedia search and get the article text plus the meta information.
+        See
+
+        Returns: a list of documents.
+
+        """
+        return list(self.lazy_load(query))
+
+    def lazy_load(self, query: str) -> Iterator[Document]:
+        """
+        Run Wikipedia search and get the article text plus the meta information.
+        See
+
+        Returns: a list of documents.
+
+        """
+        page_titles = self.wiki_client.search(
+            query[:WIKIPEDIA_MAX_QUERY_LENGTH], results=self.top_k_results
+        )
+        for page_title in page_titles[: self.top_k_results]:
+            if wiki_page := self._fetch_page(page_title):
+                if doc := self._page_to_document(page_title, wiki_page):
+                    yield doc
diff --git a/llm/Lib/site-packages/langchain_community/utilities/wolfram_alpha.py b/llm/Lib/site-packages/langchain_community/utilities/wolfram_alpha.py
new file mode 100644
index 0000000000000000000000000000000000000000..079453a0cb3adfd1d21c8afd9f73cf049a36a8b0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/wolfram_alpha.py
@@ -0,0 +1,63 @@
+"""Util that calls WolframAlpha."""
+from typing import Any, Dict, Optional
+
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+
+class WolframAlphaAPIWrapper(BaseModel):
+    """Wrapper for Wolfram Alpha.
+
+    Docs for using:
+
+    1. Go to wolfram alpha and sign up for a developer account
+    2. Create an app and get your APP ID
+    3. Save your APP ID into WOLFRAM_ALPHA_APPID env variable
+    4. pip install wolframalpha
+
+    """
+
+    wolfram_client: Any  #: :meta private:
+    wolfram_alpha_appid: Optional[str] = None
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    @root_validator()
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key and python package exists in environment."""
+        wolfram_alpha_appid = get_from_dict_or_env(
+            values, "wolfram_alpha_appid", "WOLFRAM_ALPHA_APPID"
+        )
+        values["wolfram_alpha_appid"] = wolfram_alpha_appid
+
+        try:
+            import wolframalpha
+
+        except ImportError:
+            raise ImportError(
+                "wolframalpha is not installed. "
+                "Please install it with `pip install wolframalpha`"
+            )
+        client = wolframalpha.Client(wolfram_alpha_appid)
+        values["wolfram_client"] = client
+
+        return values
+
+    def run(self, query: str) -> str:
+        """Run query through WolframAlpha and parse result."""
+        res = self.wolfram_client.query(query)
+
+        try:
+            assumption = next(res.pods).text
+            answer = next(res.results).text
+        except StopIteration:
+            return "Wolfram Alpha wasn't able to answer it"
+
+        if answer is None or answer == "":
+            # We don't want to return the assumption alone if answer is empty
+            return "No good Wolfram Alpha Result was found"
+        else:
+            return f"Assumption: {assumption} \nAnswer: {answer}"
diff --git a/llm/Lib/site-packages/langchain_community/utilities/you.py b/llm/Lib/site-packages/langchain_community/utilities/you.py
new file mode 100644
index 0000000000000000000000000000000000000000..b74841c868b176762f3324db2a1b11f8659a1914
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/you.py
@@ -0,0 +1,233 @@
+"""Util that calls you.com Search API.
+
+In order to set this up, follow instructions at:
+"""
+from typing import Any, Dict, List, Literal, Optional
+
+import aiohttp
+import requests
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+from langchain_core.utils import get_from_dict_or_env
+
+YOU_API_URL = "https://api.ydc-index.io"
+
+
+class YouHitMetadata(BaseModel):
+    """Metadata on a single hit from you.com"""
+
+    title: str = Field(description="The title of the result")
+    url: str = Field(description="The url of the result")
+    thumbnail_url: str = Field(description="Thumbnail associated with the result")
+    description: str = Field(description="Details about the result")
+
+
+class YouHit(YouHitMetadata):
+    """A single hit from you.com, which may contain multiple snippets"""
+
+    snippets: List[str] = Field(description="One or snippets of text")
+
+
+class YouAPIOutput(BaseModel):
+    """Output from you.com API."""
+
+    hits: List[YouHit] = Field(
+        description="A list of dictionaries containing the results"
+    )
+
+
+class YouDocument(BaseModel):
+    """Output of parsing one snippet."""
+
+    page_content: str = Field(description="One snippet of text")
+    metadata: YouHitMetadata
+
+
+class YouSearchAPIWrapper(BaseModel):
+    """Wrapper for you.com Search API.
+
+    To connect to the You.com api requires an API key which
+    you can get at https://api.you.com.
+    You can check out the docs at https://documentation.you.com.
+
+    You need to set the environment variable `YDC_API_KEY` for retriever to operate.
+
+    Attributes
+    ----------
+    ydc_api_key: str, optional
+        you.com api key, if YDC_API_KEY is not set in the environment
+    num_web_results: int, optional
+        The max number of web results to return, must be under 20
+    safesearch: str, optional
+        Safesearch settings, one of off, moderate, strict, defaults to moderate
+    country: str, optional
+        Country code, ex: 'US' for united states, see api docs for list
+    k: int, optional
+        max number of Documents to return using `results()`
+    n_hits: int, optional, deprecated
+        Alias for num_web_results
+    n_snippets_per_hit: int, optional
+        limit the number of snippets returned per hit
+    endpoint_type: str, optional
+        you.com endpoints: search, news, rag;
+        `web` and `snippet` alias `search`
+        `rag` returns `{'message': 'Forbidden'}`
+        @todo `news` endpoint
+    """
+
+    ydc_api_key: Optional[str] = None
+    num_web_results: Optional[int] = None
+    safesearch: Optional[str] = None
+    country: Optional[str] = None
+    k: Optional[int] = None
+    n_snippets_per_hit: Optional[int] = None
+    # @todo deprecate `snippet`, not part of API
+    endpoint_type: Literal["search", "news", "rag", "snippet"] = "search"
+    # should deprecate n_hits
+    n_hits: Optional[int] = None
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+        ydc_api_key = get_from_dict_or_env(values, "ydc_api_key", "YDC_API_KEY")
+        values["ydc_api_key"] = ydc_api_key
+
+        return values
+
+    def _parse_results(self, raw_search_results: Dict) -> List[Document]:
+        """
+        Extracts snippets from each hit and puts them in a Document
+        Parameters:
+            raw_search_results: A dict containing list of hits
+        Returns:
+            List[YouDocument]: A dictionary of parsed results
+        """
+
+        # return news results
+        if self.endpoint_type == "news":
+            return [
+                Document(page_content=result["description"], metadata=result)
+                for result in raw_search_results["news"]["results"]
+            ]
+
+        docs = []
+        for hit in raw_search_results["hits"]:
+            n_snippets_per_hit = self.n_snippets_per_hit or len(hit.get("snippets"))
+            for snippet in hit.get("snippets")[:n_snippets_per_hit]:
+                docs.append(
+                    Document(
+                        page_content=snippet,
+                        metadata={
+                            "url": hit.get("url"),
+                            "thumbnail_url": hit.get("thumbnail_url"),
+                            "title": hit.get("title"),
+                            "description": hit.get("description"),
+                        },
+                    )
+                )
+                if self.k is not None and len(docs) >= self.k:
+                    return docs
+        return docs
+
+    def raw_results(
+        self,
+        query: str,
+        **kwargs: Any,
+    ) -> Dict:
+        """Run query through you.com Search and return hits.
+
+        Args:
+            query: The query to search for.
+            num_web_results: The maximum number of results to return.
+            safesearch: Safesearch settings,
+              one of off, moderate, strict, defaults to moderate
+            country: Country code
+        Returns: YouAPIOutput
+        """
+        headers = {"X-API-Key": self.ydc_api_key or ""}
+        params = {
+            "query": query,
+            "num_web_results": self.num_web_results,
+            "safesearch": self.safesearch,
+            "country": self.country,
+            **kwargs,
+        }
+
+        params = {k: v for k, v in params.items() if v is not None}
+        # news endpoint expects `q` instead of `query`
+        if self.endpoint_type == "news":
+            params["q"] = params["query"]
+            del params["query"]
+
+        # @todo deprecate `snippet`, not part of API
+        if self.endpoint_type == "snippet":
+            self.endpoint_type = "search"
+        response = requests.get(
+            # type: ignore
+            f"{YOU_API_URL}/{self.endpoint_type}",
+            params=params,
+            headers=headers,
+        )
+        response.raise_for_status()
+        return response.json()
+
+    def results(
+        self,
+        query: str,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run query through you.com Search and parses results into Documents."""
+
+        raw_search_results = self.raw_results(
+            query,
+            **{key: value for key, value in kwargs.items() if value is not None},
+        )
+        return self._parse_results(raw_search_results)
+
+    async def raw_results_async(
+        self,
+        query: str,
+        **kwargs: Any,
+    ) -> Dict:
+        """Get results from the you.com Search API asynchronously."""
+
+        headers = {"X-API-Key": self.ydc_api_key or ""}
+        params = {
+            "query": query,
+            "num_web_results": self.num_web_results,
+            "safesearch": self.safesearch,
+            "country": self.country,
+            **kwargs,
+        }
+        params = {k: v for k, v in params.items() if v is not None}
+        # news endpoint expects `q` instead of `query`
+        if self.endpoint_type == "news":
+            params["q"] = params["query"]
+            del params["query"]
+
+        # @todo deprecate `snippet`, not part of API
+        if self.endpoint_type == "snippet":
+            self.endpoint_type = "search"
+
+        async with aiohttp.ClientSession() as session:
+            async with session.get(
+                url=f"{YOU_API_URL}/{self.endpoint_type}",
+                params=params,
+                headers=headers,
+            ) as res:
+                if res.status == 200:
+                    results = await res.json()
+                    return results
+                else:
+                    raise Exception(f"Error {res.status}: {res.reason}")
+
+    async def results_async(
+        self,
+        query: str,
+        **kwargs: Any,
+    ) -> List[Document]:
+        raw_search_results_async = await self.raw_results_async(
+            query,
+            **{key: value for key, value in kwargs.items() if value is not None},
+        )
+        return self._parse_results(raw_search_results_async)
diff --git a/llm/Lib/site-packages/langchain_community/utilities/zapier.py b/llm/Lib/site-packages/langchain_community/utilities/zapier.py
new file mode 100644
index 0000000000000000000000000000000000000000..adf0a68f46b1a137d7e4ebeef1bb5490528a07c4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utilities/zapier.py
@@ -0,0 +1,297 @@
+"""Util that can interact with Zapier NLA.
+
+Full docs here: https://nla.zapier.com/start/
+
+Note: this wrapper currently only implemented the `api_key` auth method for testing
+and server-side production use cases (using the developer's connected accounts on
+Zapier.com)
+
+For use-cases where LangChain + Zapier NLA is powering a user-facing application, and
+LangChain needs access to the end-user's connected accounts on Zapier.com, you'll need
+to use oauth. Review the full docs above and reach out to nla@zapier.com for
+developer support.
+"""
+import json
+from typing import Any, Dict, List, Optional
+
+import aiohttp
+import requests
+from langchain_core.pydantic_v1 import BaseModel, Extra, root_validator
+from langchain_core.utils import get_from_dict_or_env
+from requests import Request, Session
+
+
+class ZapierNLAWrapper(BaseModel):
+    """Wrapper for Zapier NLA.
+
+    Full docs here: https://nla.zapier.com/start/
+
+    This wrapper supports both API Key and OAuth Credential auth methods. API Key
+    is the fastest way to get started using this wrapper.
+
+    Call this wrapper with either `zapier_nla_api_key` or
+    `zapier_nla_oauth_access_token` arguments, or set the `ZAPIER_NLA_API_KEY`
+    environment variable. If both arguments are set, the Access Token will take
+    precedence.
+
+    For use-cases where LangChain + Zapier NLA is powering a user-facing application,
+    and LangChain needs access to the end-user's connected accounts on Zapier.com,
+    you'll need to use OAuth. Review the full docs above to learn how to create
+    your own provider and generate credentials.
+    """
+
+    zapier_nla_api_key: str
+    zapier_nla_oauth_access_token: str
+    zapier_nla_api_base: str = "https://nla.zapier.com/api/v1/"
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+
+    def _format_headers(self) -> Dict[str, str]:
+        """Format headers for requests."""
+        headers = {
+            "Accept": "application/json",
+            "Content-Type": "application/json",
+        }
+
+        if self.zapier_nla_oauth_access_token:
+            headers.update(
+                {"Authorization": f"Bearer {self.zapier_nla_oauth_access_token}"}
+            )
+        else:
+            headers.update({"X-API-Key": self.zapier_nla_api_key})
+
+        return headers
+
+    def _get_session(self) -> Session:
+        session = requests.Session()
+        session.headers.update(self._format_headers())
+        return session
+
+    async def _arequest(self, method: str, url: str, **kwargs: Any) -> Dict[str, Any]:
+        """Make an async request."""
+        async with aiohttp.ClientSession(headers=self._format_headers()) as session:
+            async with session.request(method, url, **kwargs) as response:
+                response.raise_for_status()
+                return await response.json()
+
+    def _create_action_payload(  # type: ignore[no-untyped-def]
+        self, instructions: str, params: Optional[Dict] = None, preview_only=False
+    ) -> Dict:
+        """Create a payload for an action."""
+        data = params if params else {}
+        data.update(
+            {
+                "instructions": instructions,
+            }
+        )
+        if preview_only:
+            data.update({"preview_only": True})
+        return data
+
+    def _create_action_url(self, action_id: str) -> str:
+        """Create a url for an action."""
+        return self.zapier_nla_api_base + f"exposed/{action_id}/execute/"
+
+    def _create_action_request(  # type: ignore[no-untyped-def]
+        self,
+        action_id: str,
+        instructions: str,
+        params: Optional[Dict] = None,
+        preview_only=False,
+    ) -> Request:
+        data = self._create_action_payload(instructions, params, preview_only)
+        return Request(
+            "POST",
+            self._create_action_url(action_id),
+            json=data,
+        )
+
+    @root_validator(pre=True)
+    def validate_environment(cls, values: Dict) -> Dict:
+        """Validate that api key exists in environment."""
+
+        zapier_nla_api_key_default = None
+
+        # If there is a oauth_access_key passed in the values
+        # we don't need a nla_api_key it can be blank
+        if "zapier_nla_oauth_access_token" in values:
+            zapier_nla_api_key_default = ""
+        else:
+            values["zapier_nla_oauth_access_token"] = ""
+
+        # we require at least one API Key
+        zapier_nla_api_key = get_from_dict_or_env(
+            values,
+            "zapier_nla_api_key",
+            "ZAPIER_NLA_API_KEY",
+            zapier_nla_api_key_default,
+        )
+
+        values["zapier_nla_api_key"] = zapier_nla_api_key
+
+        return values
+
+    async def alist(self) -> List[Dict]:
+        """Returns a list of all exposed (enabled) actions associated with
+        current user (associated with the set api_key). Change your exposed
+        actions here: https://nla.zapier.com/demo/start/
+
+        The return list can be empty if no actions exposed. Else will contain
+        a list of action objects:
+
+        [{
+            "id": str,
+            "description": str,
+            "params": Dict[str, str]
+        }]
+
+        `params` will always contain an `instructions` key, the only required
+        param. All others optional and if provided will override any AI guesses
+        (see "understanding the AI guessing flow" here:
+        https://nla.zapier.com/api/v1/docs)
+        """
+        response = await self._arequest("GET", self.zapier_nla_api_base + "exposed/")
+        return response["results"]
+
+    def list(self) -> List[Dict]:
+        """Returns a list of all exposed (enabled) actions associated with
+        current user (associated with the set api_key). Change your exposed
+        actions here: https://nla.zapier.com/demo/start/
+
+        The return list can be empty if no actions exposed. Else will contain
+        a list of action objects:
+
+        [{
+            "id": str,
+            "description": str,
+            "params": Dict[str, str]
+        }]
+
+        `params` will always contain an `instructions` key, the only required
+        param. All others optional and if provided will override any AI guesses
+        (see "understanding the AI guessing flow" here:
+        https://nla.zapier.com/docs/using-the-api#ai-guessing)
+        """
+        session = self._get_session()
+        try:
+            response = session.get(self.zapier_nla_api_base + "exposed/")
+            response.raise_for_status()
+        except requests.HTTPError as http_err:
+            if response.status_code == 401:
+                if self.zapier_nla_oauth_access_token:
+                    raise requests.HTTPError(
+                        f"An unauthorized response occurred. Check that your "
+                        f"access token is correct and doesn't need to be "
+                        f"refreshed. Err: {http_err}",
+                        response=response,
+                    )
+                raise requests.HTTPError(
+                    f"An unauthorized response occurred. Check that your api "
+                    f"key is correct. Err: {http_err}",
+                    response=response,
+                )
+            raise http_err
+        return response.json()["results"]
+
+    def run(
+        self, action_id: str, instructions: str, params: Optional[Dict] = None
+    ) -> Dict:
+        """Executes an action that is identified by action_id, must be exposed
+        (enabled) by the current user (associated with the set api_key). Change
+        your exposed actions here: https://nla.zapier.com/demo/start/
+
+        The return JSON is guaranteed to be less than ~500 words (350
+        tokens) making it safe to inject into the prompt of another LLM
+        call.
+        """
+        session = self._get_session()
+        request = self._create_action_request(action_id, instructions, params)
+        response = session.send(session.prepare_request(request))
+        response.raise_for_status()
+        return response.json()["result"]
+
+    async def arun(
+        self, action_id: str, instructions: str, params: Optional[Dict] = None
+    ) -> Dict:
+        """Executes an action that is identified by action_id, must be exposed
+        (enabled) by the current user (associated with the set api_key). Change
+        your exposed actions here: https://nla.zapier.com/demo/start/
+
+        The return JSON is guaranteed to be less than ~500 words (350
+        tokens) making it safe to inject into the prompt of another LLM
+        call.
+        """
+        response = await self._arequest(
+            "POST",
+            self._create_action_url(action_id),
+            json=self._create_action_payload(instructions, params),
+        )
+        return response["result"]
+
+    def preview(
+        self, action_id: str, instructions: str, params: Optional[Dict] = None
+    ) -> Dict:
+        """Same as run, but instead of actually executing the action, will
+        instead return a preview of params that have been guessed by the AI in
+        case you need to explicitly review before executing."""
+        session = self._get_session()
+        params = params if params else {}
+        params.update({"preview_only": True})
+        request = self._create_action_request(action_id, instructions, params, True)
+        response = session.send(session.prepare_request(request))
+        response.raise_for_status()
+        return response.json()["input_params"]
+
+    async def apreview(
+        self, action_id: str, instructions: str, params: Optional[Dict] = None
+    ) -> Dict:
+        """Same as run, but instead of actually executing the action, will
+        instead return a preview of params that have been guessed by the AI in
+        case you need to explicitly review before executing."""
+        response = await self._arequest(
+            "POST",
+            self._create_action_url(action_id),
+            json=self._create_action_payload(instructions, params, preview_only=True),
+        )
+        return response["result"]
+
+    def run_as_str(self, *args, **kwargs) -> str:  # type: ignore[no-untyped-def]
+        """Same as run, but returns a stringified version of the JSON for
+        insertting back into an LLM."""
+        data = self.run(*args, **kwargs)
+        return json.dumps(data)
+
+    async def arun_as_str(self, *args, **kwargs) -> str:  # type: ignore[no-untyped-def]
+        """Same as run, but returns a stringified version of the JSON for
+        insertting back into an LLM."""
+        data = await self.arun(*args, **kwargs)
+        return json.dumps(data)
+
+    def preview_as_str(self, *args, **kwargs) -> str:  # type: ignore[no-untyped-def]
+        """Same as preview, but returns a stringified version of the JSON for
+        insertting back into an LLM."""
+        data = self.preview(*args, **kwargs)
+        return json.dumps(data)
+
+    async def apreview_as_str(  # type: ignore[no-untyped-def]
+        self, *args, **kwargs
+    ) -> str:
+        """Same as preview, but returns a stringified version of the JSON for
+        insertting back into an LLM."""
+        data = await self.apreview(*args, **kwargs)
+        return json.dumps(data)
+
+    def list_as_str(self) -> str:  # type: ignore[no-untyped-def]
+        """Same as list, but returns a stringified version of the JSON for
+        insertting back into an LLM."""
+        actions = self.list()
+        return json.dumps(actions)
+
+    async def alist_as_str(self) -> str:  # type: ignore[no-untyped-def]
+        """Same as list, but returns a stringified version of the JSON for
+        insertting back into an LLM."""
+        actions = await self.alist()
+        return json.dumps(actions)
diff --git a/llm/Lib/site-packages/langchain_community/utils/__init__.py b/llm/Lib/site-packages/langchain_community/utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..de1316ff4e5d6d66f97cb51111e0e699516f1464
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utils/__init__.py
@@ -0,0 +1,3 @@
+"""
+**Utility functions** for LangChain.
+"""
diff --git a/llm/Lib/site-packages/langchain_community/utils/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utils/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..06075856f17f89bd468a0c749a125d013cef5a3c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utils/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utils/__pycache__/ernie_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utils/__pycache__/ernie_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e4467a51876799f06b59d7b0a174e97085735f4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utils/__pycache__/ernie_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utils/__pycache__/google.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utils/__pycache__/google.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0753a93fa876d538364f088143a59a9e13f72b94
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utils/__pycache__/google.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utils/__pycache__/math.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utils/__pycache__/math.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9bc222195c67ea0387ddf5e0cb3b9a90b0ab7222
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utils/__pycache__/math.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utils/__pycache__/openai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utils/__pycache__/openai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7dd5a1ecd29e2d85ba543121c46ed3b51b0144c5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utils/__pycache__/openai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utils/__pycache__/openai_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/utils/__pycache__/openai_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..df9f339ac7bc4ca25189381e727dcdd31d22d06e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/utils/__pycache__/openai_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/utils/ernie_functions.py b/llm/Lib/site-packages/langchain_community/utils/ernie_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..4166de1bfd383e64bafadb0572d68cdbdd083935
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utils/ernie_functions.py
@@ -0,0 +1,51 @@
+from typing import Literal, Optional, Type, TypedDict
+
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.utils.json_schema import dereference_refs
+
+
+class FunctionDescription(TypedDict):
+    """Representation of a callable function to the Ernie API."""
+
+    name: str
+    """The name of the function."""
+    description: str
+    """A description of the function."""
+    parameters: dict
+    """The parameters of the function."""
+
+
+class ToolDescription(TypedDict):
+    """Representation of a callable function to the Ernie API."""
+
+    type: Literal["function"]
+    function: FunctionDescription
+
+
+def convert_pydantic_to_ernie_function(
+    model: Type[BaseModel],
+    *,
+    name: Optional[str] = None,
+    description: Optional[str] = None,
+) -> FunctionDescription:
+    """Convert a Pydantic model to a function description for the Ernie API."""
+    schema = dereference_refs(model.schema())
+    schema.pop("definitions", None)
+    return {
+        "name": name or schema["title"],
+        "description": description or schema["description"],
+        "parameters": schema,
+    }
+
+
+def convert_pydantic_to_ernie_tool(
+    model: Type[BaseModel],
+    *,
+    name: Optional[str] = None,
+    description: Optional[str] = None,
+) -> ToolDescription:
+    """Convert a Pydantic model to a function description for the Ernie API."""
+    function = convert_pydantic_to_ernie_function(
+        model, name=name, description=description
+    )
+    return {"type": "function", "function": function}
diff --git a/llm/Lib/site-packages/langchain_community/utils/google.py b/llm/Lib/site-packages/langchain_community/utils/google.py
new file mode 100644
index 0000000000000000000000000000000000000000..18028c650015ebedd8e747e4dc83eefea7af77a4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utils/google.py
@@ -0,0 +1,25 @@
+"""Utilities to use Google provided components."""
+
+from importlib import metadata
+from typing import Any, Optional
+
+
+def get_client_info(module: Optional[str] = None) -> Any:
+    r"""Return a custom user agent header.
+
+    Args:
+        module (Optional[str]):
+            Optional. The module for a custom user agent header.
+    Returns:
+        google.api_core.gapic_v1.client_info.ClientInfo
+    """
+    from google.api_core.gapic_v1.client_info import ClientInfo
+
+    langchain_version = metadata.version("langchain")
+    client_library_version = (
+        f"{langchain_version}-{module}" if module else langchain_version
+    )
+    return ClientInfo(
+        client_library_version=client_library_version,
+        user_agent=f"langchain/{client_library_version}",
+    )
diff --git a/llm/Lib/site-packages/langchain_community/utils/math.py b/llm/Lib/site-packages/langchain_community/utils/math.py
new file mode 100644
index 0000000000000000000000000000000000000000..4edce061b5eb5a216249579992e197c32e069f6c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utils/math.py
@@ -0,0 +1,75 @@
+"""Math utils."""
+import logging
+from typing import List, Optional, Tuple, Union
+
+import numpy as np
+
+logger = logging.getLogger(__name__)
+
+Matrix = Union[List[List[float]], List[np.ndarray], np.ndarray]
+
+
+def cosine_similarity(X: Matrix, Y: Matrix) -> np.ndarray:
+    """Row-wise cosine similarity between two equal-width matrices."""
+    if len(X) == 0 or len(Y) == 0:
+        return np.array([])
+
+    X = np.array(X)
+    Y = np.array(Y)
+    if X.shape[1] != Y.shape[1]:
+        raise ValueError(
+            f"Number of columns in X and Y must be the same. X has shape {X.shape} "
+            f"and Y has shape {Y.shape}."
+        )
+    try:
+        import simsimd as simd
+
+        X = np.array(X, dtype=np.float32)
+        Y = np.array(Y, dtype=np.float32)
+        Z = 1 - simd.cdist(X, Y, metric="cosine")
+        if isinstance(Z, float):
+            return np.array([Z])
+        return np.array(Z)
+    except ImportError:
+        logger.debug(
+            "Unable to import simsimd, defaulting to NumPy implementation. If you want "
+            "to use simsimd please install with `pip install simsimd`."
+        )
+        X_norm = np.linalg.norm(X, axis=1)
+        Y_norm = np.linalg.norm(Y, axis=1)
+        # Ignore divide by zero errors run time warnings as those are handled below.
+        with np.errstate(divide="ignore", invalid="ignore"):
+            similarity = np.dot(X, Y.T) / np.outer(X_norm, Y_norm)
+        similarity[np.isnan(similarity) | np.isinf(similarity)] = 0.0
+        return similarity
+
+
+def cosine_similarity_top_k(
+    X: Matrix,
+    Y: Matrix,
+    top_k: Optional[int] = 5,
+    score_threshold: Optional[float] = None,
+) -> Tuple[List[Tuple[int, int]], List[float]]:
+    """Row-wise cosine similarity with optional top-k and score threshold filtering.
+
+    Args:
+        X: Matrix.
+        Y: Matrix, same width as X.
+        top_k: Max number of results to return.
+        score_threshold: Minimum cosine similarity of results.
+
+    Returns:
+        Tuple of two lists. First contains two-tuples of indices (X_idx, Y_idx),
+            second contains corresponding cosine similarities.
+    """
+    if len(X) == 0 or len(Y) == 0:
+        return [], []
+    score_array = cosine_similarity(X, Y)
+    score_threshold = score_threshold or -1.0
+    score_array[score_array < score_threshold] = 0
+    top_k = min(top_k or len(score_array), np.count_nonzero(score_array))
+    top_k_idxs = np.argpartition(score_array, -top_k, axis=None)[-top_k:]
+    top_k_idxs = top_k_idxs[np.argsort(score_array.ravel()[top_k_idxs])][::-1]
+    ret_idxs = np.unravel_index(top_k_idxs, score_array.shape)
+    scores = score_array.ravel()[top_k_idxs].tolist()
+    return list(zip(*ret_idxs)), scores  # type: ignore
diff --git a/llm/Lib/site-packages/langchain_community/utils/openai.py b/llm/Lib/site-packages/langchain_community/utils/openai.py
new file mode 100644
index 0000000000000000000000000000000000000000..8846d5fbc4c18669a2c681156f99b9985fb6203d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utils/openai.py
@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from importlib.metadata import version
+
+from packaging.version import parse
+
+
+def is_openai_v1() -> bool:
+    """Return whether OpenAI API is v1 or more."""
+    _version = parse(version("openai"))
+    return _version.major >= 1
diff --git a/llm/Lib/site-packages/langchain_community/utils/openai_functions.py b/llm/Lib/site-packages/langchain_community/utils/openai_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..41dab3c76b3f5d06b7642bab925d14979c412648
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/utils/openai_functions.py
@@ -0,0 +1,15 @@
+# these stubs are just for backwards compatibility
+
+from langchain_core.utils.function_calling import (
+    FunctionDescription,
+    ToolDescription,
+    convert_pydantic_to_openai_function,
+    convert_pydantic_to_openai_tool,
+)
+
+__all__ = [
+    "FunctionDescription",
+    "ToolDescription",
+    "convert_pydantic_to_openai_function",
+    "convert_pydantic_to_openai_tool",
+]
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__init__.py b/llm/Lib/site-packages/langchain_community/vectorstores/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe0c1b460014cc35cd6976ef2da3a7539edc1bee
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/__init__.py
@@ -0,0 +1,478 @@
+"""**Vector store** stores embedded data and performs vector search.
+
+One of the most common ways to store and search over unstructured data is to
+embed it and store the resulting embedding vectors, and then query the store
+and retrieve the data that are 'most similar' to the embedded query.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    VectorStore --> <name>  # Examples: Annoy, FAISS, Milvus
+
+    BaseRetriever --> VectorStoreRetriever --> <name>Retriever  # Example: VespaRetriever
+
+**Main helpers:**
+
+.. code-block::
+
+    Embeddings, Document
+"""  # noqa: E501
+
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from langchain_core.vectorstores import (
+        VectorStore,  # noqa: F401
+    )
+
+    from langchain_community.vectorstores.alibabacloud_opensearch import (
+        AlibabaCloudOpenSearch,  # noqa: F401
+        AlibabaCloudOpenSearchSettings,  # noqa: F401
+    )
+    from langchain_community.vectorstores.analyticdb import (
+        AnalyticDB,  # noqa: F401
+    )
+    from langchain_community.vectorstores.annoy import (
+        Annoy,  # noqa: F401
+    )
+    from langchain_community.vectorstores.apache_doris import (
+        ApacheDoris,  # noqa: F401
+    )
+    from langchain_community.vectorstores.astradb import (
+        AstraDB,  # noqa: F401
+    )
+    from langchain_community.vectorstores.atlas import (
+        AtlasDB,  # noqa: F401
+    )
+    from langchain_community.vectorstores.awadb import (
+        AwaDB,  # noqa: F401
+    )
+    from langchain_community.vectorstores.azure_cosmos_db import (
+        AzureCosmosDBVectorSearch,  # noqa: F401
+    )
+    from langchain_community.vectorstores.azuresearch import (
+        AzureSearch,  # noqa: F401
+    )
+    from langchain_community.vectorstores.bageldb import (
+        Bagel,  # noqa: F401
+    )
+    from langchain_community.vectorstores.baiducloud_vector_search import (
+        BESVectorStore,  # noqa: F401
+    )
+    from langchain_community.vectorstores.baiduvectordb import (
+        BaiduVectorDB,  # noqa: F401
+    )
+    from langchain_community.vectorstores.bigquery_vector_search import (
+        BigQueryVectorSearch,  # noqa: F401
+    )
+    from langchain_community.vectorstores.cassandra import (
+        Cassandra,  # noqa: F401
+    )
+    from langchain_community.vectorstores.chroma import (
+        Chroma,  # noqa: F401
+    )
+    from langchain_community.vectorstores.clarifai import (
+        Clarifai,  # noqa: F401
+    )
+    from langchain_community.vectorstores.clickhouse import (
+        Clickhouse,  # noqa: F401
+        ClickhouseSettings,  # noqa: F401
+    )
+    from langchain_community.vectorstores.couchbase import (
+        CouchbaseVectorStore,  # noqa: F401
+    )
+    from langchain_community.vectorstores.dashvector import (
+        DashVector,  # noqa: F401
+    )
+    from langchain_community.vectorstores.databricks_vector_search import (
+        DatabricksVectorSearch,  # noqa: F401
+    )
+    from langchain_community.vectorstores.deeplake import (
+        DeepLake,  # noqa: F401
+    )
+    from langchain_community.vectorstores.dingo import (
+        Dingo,  # noqa: F401
+    )
+    from langchain_community.vectorstores.docarray import (
+        DocArrayHnswSearch,  # noqa: F401
+        DocArrayInMemorySearch,  # noqa: F401
+    )
+    from langchain_community.vectorstores.documentdb import (
+        DocumentDBVectorSearch,  # noqa: F401
+    )
+    from langchain_community.vectorstores.duckdb import (
+        DuckDB,  # noqa: F401
+    )
+    from langchain_community.vectorstores.ecloud_vector_search import (
+        EcloudESVectorStore,  # noqa: F401
+    )
+    from langchain_community.vectorstores.elastic_vector_search import (
+        ElasticKnnSearch,  # noqa: F401
+        ElasticVectorSearch,  # noqa: F401
+    )
+    from langchain_community.vectorstores.elasticsearch import (
+        ElasticsearchStore,  # noqa: F401
+    )
+    from langchain_community.vectorstores.epsilla import (
+        Epsilla,  # noqa: F401
+    )
+    from langchain_community.vectorstores.faiss import (
+        FAISS,  # noqa: F401
+    )
+    from langchain_community.vectorstores.hanavector import (
+        HanaDB,  # noqa: F401
+    )
+    from langchain_community.vectorstores.hologres import (
+        Hologres,  # noqa: F401
+    )
+    from langchain_community.vectorstores.infinispanvs import (
+        InfinispanVS,  # noqa: F401
+    )
+    from langchain_community.vectorstores.inmemory import (
+        InMemoryVectorStore,  # noqa: F401
+    )
+    from langchain_community.vectorstores.kdbai import (
+        KDBAI,  # noqa: F401
+    )
+    from langchain_community.vectorstores.kinetica import (
+        DistanceStrategy,  # noqa: F401
+        Kinetica,  # noqa: F401
+        KineticaSettings,  # noqa: F401
+    )
+    from langchain_community.vectorstores.lancedb import (
+        LanceDB,  # noqa: F401
+    )
+    from langchain_community.vectorstores.lantern import (
+        Lantern,  # noqa: F401
+    )
+    from langchain_community.vectorstores.llm_rails import (
+        LLMRails,  # noqa: F401
+    )
+    from langchain_community.vectorstores.marqo import (
+        Marqo,  # noqa: F401
+    )
+    from langchain_community.vectorstores.matching_engine import (
+        MatchingEngine,  # noqa: F401
+    )
+    from langchain_community.vectorstores.meilisearch import (
+        Meilisearch,  # noqa: F401
+    )
+    from langchain_community.vectorstores.milvus import (
+        Milvus,  # noqa: F401
+    )
+    from langchain_community.vectorstores.momento_vector_index import (
+        MomentoVectorIndex,  # noqa: F401
+    )
+    from langchain_community.vectorstores.mongodb_atlas import (
+        MongoDBAtlasVectorSearch,  # noqa: F401
+    )
+    from langchain_community.vectorstores.myscale import (
+        MyScale,  # noqa: F401
+        MyScaleSettings,  # noqa: F401
+    )
+    from langchain_community.vectorstores.neo4j_vector import (
+        Neo4jVector,  # noqa: F401
+    )
+    from langchain_community.vectorstores.opensearch_vector_search import (
+        OpenSearchVectorSearch,  # noqa: F401
+    )
+    from langchain_community.vectorstores.pathway import (
+        PathwayVectorClient,  # noqa: F401
+    )
+    from langchain_community.vectorstores.pgembedding import (
+        PGEmbedding,  # noqa: F401
+    )
+    from langchain_community.vectorstores.pgvector import (
+        PGVector,  # noqa: F401
+    )
+    from langchain_community.vectorstores.pinecone import (
+        Pinecone,  # noqa: F401
+    )
+    from langchain_community.vectorstores.qdrant import (
+        Qdrant,  # noqa: F401
+    )
+    from langchain_community.vectorstores.redis import (
+        Redis,  # noqa: F401
+    )
+    from langchain_community.vectorstores.rocksetdb import (
+        Rockset,  # noqa: F401
+    )
+    from langchain_community.vectorstores.scann import (
+        ScaNN,  # noqa: F401
+    )
+    from langchain_community.vectorstores.semadb import (
+        SemaDB,  # noqa: F401
+    )
+    from langchain_community.vectorstores.singlestoredb import (
+        SingleStoreDB,  # noqa: F401
+    )
+    from langchain_community.vectorstores.sklearn import (
+        SKLearnVectorStore,  # noqa: F401
+    )
+    from langchain_community.vectorstores.sqlitevss import (
+        SQLiteVSS,  # noqa: F401
+    )
+    from langchain_community.vectorstores.starrocks import (
+        StarRocks,  # noqa: F401
+    )
+    from langchain_community.vectorstores.supabase import (
+        SupabaseVectorStore,  # noqa: F401
+    )
+    from langchain_community.vectorstores.surrealdb import (
+        SurrealDBStore,  # noqa: F401
+    )
+    from langchain_community.vectorstores.tair import (
+        Tair,  # noqa: F401
+    )
+    from langchain_community.vectorstores.tencentvectordb import (
+        TencentVectorDB,  # noqa: F401
+    )
+    from langchain_community.vectorstores.thirdai_neuraldb import (
+        NeuralDBVectorStore,  # noqa: F401
+    )
+    from langchain_community.vectorstores.tidb_vector import (
+        TiDBVectorStore,  # noqa: F401
+    )
+    from langchain_community.vectorstores.tigris import (
+        Tigris,  # noqa: F401
+    )
+    from langchain_community.vectorstores.tiledb import (
+        TileDB,  # noqa: F401
+    )
+    from langchain_community.vectorstores.timescalevector import (
+        TimescaleVector,  # noqa: F401
+    )
+    from langchain_community.vectorstores.typesense import (
+        Typesense,  # noqa: F401
+    )
+    from langchain_community.vectorstores.usearch import (
+        USearch,  # noqa: F401
+    )
+    from langchain_community.vectorstores.vald import (
+        Vald,  # noqa: F401
+    )
+    from langchain_community.vectorstores.vdms import (
+        VDMS,  # noqa: F401
+    )
+    from langchain_community.vectorstores.vearch import (
+        Vearch,  # noqa: F401
+    )
+    from langchain_community.vectorstores.vectara import (
+        Vectara,  # noqa: F401
+    )
+    from langchain_community.vectorstores.vespa import (
+        VespaStore,  # noqa: F401
+    )
+    from langchain_community.vectorstores.vlite import (
+        VLite,  # noqa: F401
+    )
+    from langchain_community.vectorstores.weaviate import (
+        Weaviate,  # noqa: F401
+    )
+    from langchain_community.vectorstores.yellowbrick import (
+        Yellowbrick,  # noqa: F401
+    )
+    from langchain_community.vectorstores.zep import (
+        ZepVectorStore,  # noqa: F401
+    )
+    from langchain_community.vectorstores.zilliz import (
+        Zilliz,  # noqa: F401
+    )
+
+__all__ = [
+    "AlibabaCloudOpenSearch",
+    "AlibabaCloudOpenSearchSettings",
+    "AnalyticDB",
+    "Annoy",
+    "ApacheDoris",
+    "AstraDB",
+    "AtlasDB",
+    "AwaDB",
+    "AzureCosmosDBVectorSearch",
+    "AzureSearch",
+    "BESVectorStore",
+    "Bagel",
+    "BaiduVectorDB",
+    "BigQueryVectorSearch",
+    "Cassandra",
+    "Chroma",
+    "Clarifai",
+    "Clickhouse",
+    "ClickhouseSettings",
+    "CouchbaseVectorStore",
+    "DashVector",
+    "DatabricksVectorSearch",
+    "DeepLake",
+    "Dingo",
+    "DistanceStrategy",
+    "DocArrayHnswSearch",
+    "DocArrayInMemorySearch",
+    "DocumentDBVectorSearch",
+    "DuckDB",
+    "EcloudESVectorStore",
+    "ElasticKnnSearch",
+    "ElasticVectorSearch",
+    "ElasticsearchStore",
+    "Epsilla",
+    "FAISS",
+    "HanaDB",
+    "Hologres",
+    "InMemoryVectorStore",
+    "InfinispanVS",
+    "KDBAI",
+    "Kinetica",
+    "KineticaSettings",
+    "LLMRails",
+    "LanceDB",
+    "Lantern",
+    "Marqo",
+    "MatchingEngine",
+    "Meilisearch",
+    "Milvus",
+    "MomentoVectorIndex",
+    "MongoDBAtlasVectorSearch",
+    "MyScale",
+    "MyScaleSettings",
+    "Neo4jVector",
+    "NeuralDBVectorStore",
+    "OpenSearchVectorSearch",
+    "PGEmbedding",
+    "PGVector",
+    "PathwayVectorClient",
+    "Pinecone",
+    "Qdrant",
+    "Redis",
+    "Rockset",
+    "SKLearnVectorStore",
+    "SQLiteVSS",
+    "ScaNN",
+    "SemaDB",
+    "SingleStoreDB",
+    "StarRocks",
+    "SupabaseVectorStore",
+    "SurrealDBStore",
+    "Tair",
+    "TencentVectorDB",
+    "TiDBVectorStore",
+    "Tigris",
+    "TileDB",
+    "TimescaleVector",
+    "Typesense",
+    "USearch",
+    "VDMS",
+    "Vald",
+    "Vearch",
+    "Vectara",
+    "VectorStore",
+    "VespaStore",
+    "VLite",
+    "Weaviate",
+    "Yellowbrick",
+    "ZepVectorStore",
+    "Zilliz",
+]
+
+_module_lookup = {
+    "AlibabaCloudOpenSearch": "langchain_community.vectorstores.alibabacloud_opensearch",  # noqa: E501
+    "AlibabaCloudOpenSearchSettings": "langchain_community.vectorstores.alibabacloud_opensearch",  # noqa: E501
+    "AnalyticDB": "langchain_community.vectorstores.analyticdb",
+    "Annoy": "langchain_community.vectorstores.annoy",
+    "ApacheDoris": "langchain_community.vectorstores.apache_doris",
+    "AstraDB": "langchain_community.vectorstores.astradb",
+    "AtlasDB": "langchain_community.vectorstores.atlas",
+    "AwaDB": "langchain_community.vectorstores.awadb",
+    "AzureCosmosDBVectorSearch": "langchain_community.vectorstores.azure_cosmos_db",
+    "AzureSearch": "langchain_community.vectorstores.azuresearch",
+    "BaiduVectorDB": "langchain_community.vectorstores.baiduvectordb",
+    "BESVectorStore": "langchain_community.vectorstores.baiducloud_vector_search",
+    "Bagel": "langchain_community.vectorstores.bageldb",
+    "BigQueryVectorSearch": "langchain_community.vectorstores.bigquery_vector_search",
+    "Cassandra": "langchain_community.vectorstores.cassandra",
+    "Chroma": "langchain_community.vectorstores.chroma",
+    "Clarifai": "langchain_community.vectorstores.clarifai",
+    "Clickhouse": "langchain_community.vectorstores.clickhouse",
+    "ClickhouseSettings": "langchain_community.vectorstores.clickhouse",
+    "CouchbaseVectorStore": "langchain_community.vectorstores.couchbase",
+    "DashVector": "langchain_community.vectorstores.dashvector",
+    "DatabricksVectorSearch": "langchain_community.vectorstores.databricks_vector_search",  # noqa: E501
+    "DeepLake": "langchain_community.vectorstores.deeplake",
+    "Dingo": "langchain_community.vectorstores.dingo",
+    "DistanceStrategy": "langchain_community.vectorstores.kinetica",
+    "DocArrayHnswSearch": "langchain_community.vectorstores.docarray",
+    "DocArrayInMemorySearch": "langchain_community.vectorstores.docarray",
+    "DocumentDBVectorSearch": "langchain_community.vectorstores.documentdb",
+    "DuckDB": "langchain_community.vectorstores.duckdb",
+    "EcloudESVectorStore": "langchain_community.vectorstores.ecloud_vector_search",
+    "ElasticKnnSearch": "langchain_community.vectorstores.elastic_vector_search",
+    "ElasticVectorSearch": "langchain_community.vectorstores.elastic_vector_search",
+    "ElasticsearchStore": "langchain_community.vectorstores.elasticsearch",
+    "Epsilla": "langchain_community.vectorstores.epsilla",
+    "FAISS": "langchain_community.vectorstores.faiss",
+    "HanaDB": "langchain_community.vectorstores.hanavector",
+    "Hologres": "langchain_community.vectorstores.hologres",
+    "InfinispanVS": "langchain_community.vectorstores.infinispanvs",
+    "InMemoryVectorStore": "langchain_community.vectorstores.inmemory",
+    "KDBAI": "langchain_community.vectorstores.kdbai",
+    "Kinetica": "langchain_community.vectorstores.kinetica",
+    "KineticaSettings": "langchain_community.vectorstores.kinetica",
+    "LLMRails": "langchain_community.vectorstores.llm_rails",
+    "LanceDB": "langchain_community.vectorstores.lancedb",
+    "Lantern": "langchain_community.vectorstores.lantern",
+    "Marqo": "langchain_community.vectorstores.marqo",
+    "MatchingEngine": "langchain_community.vectorstores.matching_engine",
+    "Meilisearch": "langchain_community.vectorstores.meilisearch",
+    "Milvus": "langchain_community.vectorstores.milvus",
+    "MomentoVectorIndex": "langchain_community.vectorstores.momento_vector_index",
+    "MongoDBAtlasVectorSearch": "langchain_community.vectorstores.mongodb_atlas",
+    "MyScale": "langchain_community.vectorstores.myscale",
+    "MyScaleSettings": "langchain_community.vectorstores.myscale",
+    "Neo4jVector": "langchain_community.vectorstores.neo4j_vector",
+    "NeuralDBVectorStore": "langchain_community.vectorstores.thirdai_neuraldb",
+    "OpenSearchVectorSearch": "langchain_community.vectorstores.opensearch_vector_search",  # noqa: E501
+    "PathwayVectorClient": "langchain_community.vectorstores.pathway",
+    "PGEmbedding": "langchain_community.vectorstores.pgembedding",
+    "PGVector": "langchain_community.vectorstores.pgvector",
+    "Pinecone": "langchain_community.vectorstores.pinecone",
+    "Qdrant": "langchain_community.vectorstores.qdrant",
+    "Redis": "langchain_community.vectorstores.redis",
+    "Rockset": "langchain_community.vectorstores.rocksetdb",
+    "SKLearnVectorStore": "langchain_community.vectorstores.sklearn",
+    "SQLiteVSS": "langchain_community.vectorstores.sqlitevss",
+    "ScaNN": "langchain_community.vectorstores.scann",
+    "SemaDB": "langchain_community.vectorstores.semadb",
+    "SingleStoreDB": "langchain_community.vectorstores.singlestoredb",
+    "StarRocks": "langchain_community.vectorstores.starrocks",
+    "SupabaseVectorStore": "langchain_community.vectorstores.supabase",
+    "SurrealDBStore": "langchain_community.vectorstores.surrealdb",
+    "Tair": "langchain_community.vectorstores.tair",
+    "TencentVectorDB": "langchain_community.vectorstores.tencentvectordb",
+    "TiDBVectorStore": "langchain_community.vectorstores.tidb_vector",
+    "Tigris": "langchain_community.vectorstores.tigris",
+    "TileDB": "langchain_community.vectorstores.tiledb",
+    "TimescaleVector": "langchain_community.vectorstores.timescalevector",
+    "Typesense": "langchain_community.vectorstores.typesense",
+    "USearch": "langchain_community.vectorstores.usearch",
+    "Vald": "langchain_community.vectorstores.vald",
+    "VDMS": "langchain_community.vectorstores.vdms",
+    "Vearch": "langchain_community.vectorstores.vearch",
+    "Vectara": "langchain_community.vectorstores.vectara",
+    "VectorStore": "langchain_core.vectorstores",
+    "VespaStore": "langchain_community.vectorstores.vespa",
+    "VLite": "langchain_community.vectorstores.vlite",
+    "Weaviate": "langchain_community.vectorstores.weaviate",
+    "Yellowbrick": "langchain_community.vectorstores.yellowbrick",
+    "ZepVectorStore": "langchain_community.vectorstores.zep",
+    "Zilliz": "langchain_community.vectorstores.zilliz",
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name in _module_lookup:
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+__all__ = list(_module_lookup.keys())
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3b786d69b7141672b53fb6c498585a867736b05d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/alibabacloud_opensearch.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/alibabacloud_opensearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..013b7c6d8f36b3c6fb2167f350a9cb6f35f4fa80
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/alibabacloud_opensearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/analyticdb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/analyticdb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0bf8e7052c49f030bc018f659e03bc0796b96046
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/analyticdb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/annoy.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/annoy.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b1f718c4c54197eea59796b6ee70416017d556a5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/annoy.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/apache_doris.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/apache_doris.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..df086257b0a4fc8391a671c18a117e3107ac6511
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/apache_doris.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/astradb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/astradb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5417a23cd4587d049c6c0b7ba07b9f4df1603e9a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/astradb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/atlas.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/atlas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a4a0a9308e48957b9280aafb6a24bcf4545dca58
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/atlas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/awadb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/awadb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..37e53651a0d7a36bf9b0b0329649772f536e69ef
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/awadb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/azure_cosmos_db.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/azure_cosmos_db.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..daded21d3e3838199d5a8869746bd79e80a81cff
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/azure_cosmos_db.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/azuresearch.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/azuresearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8cf146bd12cd3f15a960cf97f4b75d2abe31b79e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/azuresearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/bageldb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/bageldb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..74d4e56fdcecb24aed6b1810ae284383b3fc3e28
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/bageldb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/baiducloud_vector_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/baiducloud_vector_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..45e4b80fb055fecf26cbb5bd00fbe8d8f074f6fe
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/baiducloud_vector_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/baiduvectordb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/baiduvectordb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9520c089536c0696f6f69cc2da08835a3bfc777c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/baiduvectordb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/bigquery_vector_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/bigquery_vector_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dbeba291907c2225c6a16f77e5808c1bcc8c1818
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/bigquery_vector_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/cassandra.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/cassandra.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2ce779f1a6dd6b98bd8fd3a2748217ad3ebfb70a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/cassandra.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/chroma.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/chroma.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..16635a21ebc25290b6a214ae2e41b1a1de97f165
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/chroma.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/clarifai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/clarifai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a508259c5d0ef9959ffaa76d8c14d6c1d884f6c0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/clarifai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/clickhouse.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/clickhouse.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..914c73bce670afe0b06f1cc9d8830cbb187fd181
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/clickhouse.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/couchbase.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/couchbase.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..63f08c540633a40404c19141f6e9e91d1073c79d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/couchbase.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/dashvector.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/dashvector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f038372a3f49fd3bd634fe67979041a43fff5abc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/dashvector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/databricks_vector_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/databricks_vector_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5f2290f9e4abf603a93d4f3ff3455cb5b4db3dff
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/databricks_vector_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/deeplake.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/deeplake.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a6bb038d938c278cf992c0c39c3752e77215f4d0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/deeplake.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/dingo.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/dingo.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4c86f958461a342b7e0b8d9782325cbf3dbb07fa
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/dingo.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/documentdb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/documentdb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c8a28fec870a4fd1b87e72d043c3bb32af495f3a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/documentdb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/duckdb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/duckdb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f468f579957b9440703665b6e4c766892fa5100d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/duckdb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/ecloud_vector_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/ecloud_vector_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eaccde2c0921b848bf282a7068daf1cc9d13bd73
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/ecloud_vector_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/elastic_vector_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/elastic_vector_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..db53bb116f7f750df366d73a9b95595e57fb3c95
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/elastic_vector_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/elasticsearch.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/elasticsearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5fb4cc671545c8dab366887763cf90d5ea442eb2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/elasticsearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/epsilla.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/epsilla.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..34e69283eb17077d3f46687de0d495129c4465f4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/epsilla.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/faiss.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/faiss.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b8f47dfde1b419f1cb2b76284cf94974eff27613
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/faiss.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/hanavector.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/hanavector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9bd183cd8381cae1679b4cd2f479e1a1960d59d3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/hanavector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/hippo.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/hippo.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2e2a88323fcb283649bc1483c59651d5da891779
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/hippo.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/hologres.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/hologres.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b450b5c2c98d8ef9297d05309a132b90c5bf5ad6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/hologres.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/infinispanvs.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/infinispanvs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..304299330d4dffd4bf91d101847e648a66c8558f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/infinispanvs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/inmemory.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/inmemory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2244e75c42d4599d32701d84283db2435d7341c9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/inmemory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/jaguar.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/jaguar.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..83dbb8608add924a87273f961508574ec98dfb04
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/jaguar.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/kdbai.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/kdbai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..04dde5b50e08cb46030675ea717fe991e284e183
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/kdbai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/kinetica.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/kinetica.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b7f7c2c40df9f92da0b6088e478db8c0663b6edf
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/kinetica.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/lancedb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/lancedb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..40b6d2ce3541cfc57c555d9c8a0e8b8da61c28e7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/lancedb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/lantern.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/lantern.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..27ca2aa15b2bf50102c4bfd247674a98e21c5c29
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/lantern.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/llm_rails.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/llm_rails.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..07e299bd4a17d1816f6c6bff4d6616b0d0079f40
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/llm_rails.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/marqo.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/marqo.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..01020958ea88327293b32fbdef46cfadcb14c9be
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/marqo.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/matching_engine.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/matching_engine.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..81d19a258e101e8ea3789c33337f1bc8a2246b05
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/matching_engine.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/meilisearch.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/meilisearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9423f59ad3dae98c2561906ef6f2d64dd858cf3b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/meilisearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/milvus.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/milvus.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..25ac802d4050eb7f3df502dfc3269e5b2f36b3d4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/milvus.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/momento_vector_index.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/momento_vector_index.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0204cc394a21923a05ae82bb0f2964e3872df46a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/momento_vector_index.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/mongodb_atlas.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/mongodb_atlas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ae36ecd9ef88b3e3cac94d7f6132b4d72e02de81
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/mongodb_atlas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/myscale.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/myscale.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e26901ae89728527eab3c3799e0793ea3e85e5e6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/myscale.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/neo4j_vector.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/neo4j_vector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ac70152c3a2ddf3ecb268fd0078e23b607141939
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/neo4j_vector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/nucliadb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/nucliadb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..58b3af91c44b9f754fd4269b1197d6cf909236e5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/nucliadb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/opensearch_vector_search.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/opensearch_vector_search.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..7e350dbd99d19633c3276e1e6ea50674868bb8ed
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/opensearch_vector_search.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pathway.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pathway.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cdc9fb086f20419545ca82dbed44f29ead520cc8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pathway.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pgembedding.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pgembedding.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..28851b59832769bd3fcbec8ec5784e7782e926cb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pgembedding.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pgvecto_rs.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pgvecto_rs.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..abe2455366156bbb1a24e88ba907f45ddc3f73be
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pgvecto_rs.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pgvector.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pgvector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9cd97a57175556f2dd4f7590da28396face2d3f6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pgvector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pinecone.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pinecone.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b43a369204ae8205e2b6c5bf8aa03c32902b747c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/pinecone.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/qdrant.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/qdrant.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e94506ba47ad42a036a06758471d923a2c74a7b4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/qdrant.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/rocksetdb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/rocksetdb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..302984a7709fee509374f1cb1484fdc96c630515
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/rocksetdb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/scann.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/scann.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1a753dd1c800c8cd4dc581978e457b4149110e9e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/scann.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/semadb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/semadb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6c3a69d7fae620416c5c33ab575978e4690dd57e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/semadb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/singlestoredb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/singlestoredb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..395bf3d424cf73499b574f328efd3d95f6d8cb99
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/singlestoredb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/sklearn.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/sklearn.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..03054ac50fc590fb69c2eaac5bbf7c24b0883916
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/sklearn.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/sqlitevss.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/sqlitevss.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..05443b9348d2909354b1018aa8f8b180e52db16f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/sqlitevss.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/starrocks.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/starrocks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9231f5986cf00896fc0c36a2265f801cf1b96330
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/starrocks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/supabase.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/supabase.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..388956cae7d177f11c653eb4082d5229a3528b33
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/supabase.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/surrealdb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/surrealdb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0df909d56ae76c81d8d4fa3fe0d1bb982b4ee832
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/surrealdb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tair.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tair.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ee644acebfd9d7a7ed7c25f1cb475ee77967f22c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tair.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tencentvectordb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tencentvectordb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..60d4bb0ae9d57bed592b60c12d5c7154a63be14c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tencentvectordb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/thirdai_neuraldb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/thirdai_neuraldb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5317e4509826914e1066d284a5b3429a337916e5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/thirdai_neuraldb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tidb_vector.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tidb_vector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6539c4db1a4c98d51539840add1ee42ab58263e3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tidb_vector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tigris.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tigris.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bc7b183fc6700bffe3762e71353e0ae4b7df5df1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tigris.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tiledb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tiledb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fa32caf65c198ee4c2726904ca045bd01436af21
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/tiledb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/timescalevector.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/timescalevector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..25ebc63ac58e13d11621f8ad1ef9a6cfd1df715b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/timescalevector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/typesense.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/typesense.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d5d4befe7c4c5eefa8ae9cb0a01fa3cac4b33733
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/typesense.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/usearch.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/usearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..76797ea8e5df8040a02278dc34dcc435c0a18356
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/usearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..06ff643bd9772b29753baf97f4126ee7d88a9802
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vald.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vald.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aa8cbd179a63020f06423d8233c1d2f81d8d4871
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vald.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vdms.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vdms.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6a0e4dfe8bb189d2b5b3bc2482cb33ad2358e83f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vdms.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vearch.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vearch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..79ad521ec4a719f33de66a2be16f0e78baa247ff
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vearch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vectara.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vectara.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c11e4aa8406bec27e4a43bbe79969e68d1cb53ef
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vectara.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vespa.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vespa.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4173c98fd990c8987d8ed3fea33aa09ed99d043c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vespa.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vikingdb.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vikingdb.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..336928004b8200291e20438d15acd488f255e0c8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vikingdb.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vlite.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vlite.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a2f954a3a03cde1bfc98f67ca2d547f0bda7fc28
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/vlite.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/weaviate.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/weaviate.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..18bc0b9c02d96c5be5170a31b32d98d59a80a78b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/weaviate.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/xata.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/xata.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9c25800dfd602392bebc6ca604d6e426b617c107
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/xata.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/yellowbrick.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/yellowbrick.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9e6bf9258a736759bd1f8794f69480eaacb87ca4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/yellowbrick.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/zep.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/zep.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cf6c6c2ae2dafe4df7f67f8ce743351a3473506d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/zep.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/zilliz.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/zilliz.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4133505f6b0714cec5da7b48da0784cf9dbb3ca3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/__pycache__/zilliz.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/alibabacloud_opensearch.py b/llm/Lib/site-packages/langchain_community/vectorstores/alibabacloud_opensearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..12d02ae19d36233e73037ab148053ce16cfc6751
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/alibabacloud_opensearch.py
@@ -0,0 +1,532 @@
+import json
+import logging
+import numbers
+from hashlib import sha1
+from typing import Any, Dict, Iterable, List, Optional, Tuple
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+logger = logging.getLogger()
+
+
+class AlibabaCloudOpenSearchSettings:
+    """Alibaba Cloud Opensearch` client configuration.
+
+    Attribute:
+        endpoint (str) : The endpoint of opensearch instance, You can find it
+         from the console of Alibaba Cloud OpenSearch.
+        instance_id (str) : The identify of opensearch instance, You can find
+         it from the console of Alibaba Cloud OpenSearch.
+        username (str) : The username specified when purchasing the instance.
+        password (str) : The password specified when purchasing the instance，
+          After the instance is created, you can modify it on the console.
+        tablename (str): The table name specified during instance configuration.
+        field_name_mapping (Dict) : Using field name mapping between opensearch
+          vector store and opensearch instance configuration table field names:
+        {
+            'id': 'The id field name map of index document.',
+            'document': 'The text field name map of index document.',
+            'embedding': 'In the embedding field of the opensearch instance,
+              the values must be in float type and separated by separator,
+              default is comma.',
+            'metadata_field_x': 'Metadata field mapping includes the mapped
+             field name and operator in the mapping value, separated by a comma
+             between the mapped field name and the operator.',
+        }
+        protocol (str): Communication Protocol between SDK and Server, default is http.
+        namespace (str) : The instance data will be partitioned based on the "namespace"
+         field,If the namespace is enabled, you need to specify the namespace field
+         name during initialization, Otherwise, the queries cannot be executed
+         correctly.
+        embedding_field_separator(str): Delimiter specified for writing vector
+         field data, default is comma.
+        output_fields: Specify the field list returned when invoking OpenSearch,
+         by default it is the value list of the field mapping field.
+    """
+
+    def __init__(
+        self,
+        endpoint: str,
+        instance_id: str,
+        username: str,
+        password: str,
+        table_name: str,
+        field_name_mapping: Dict[str, str],
+        protocol: str = "http",
+        namespace: str = "",
+        embedding_field_separator: str = ",",
+        output_fields: Optional[List[str]] = None,
+    ) -> None:
+        self.endpoint = endpoint
+        self.instance_id = instance_id
+        self.protocol = protocol
+        self.username = username
+        self.password = password
+        self.namespace = namespace
+        self.table_name = table_name
+        self.opt_table_name = "_".join([self.instance_id, self.table_name])
+        self.field_name_mapping = field_name_mapping
+        self.embedding_field_separator = embedding_field_separator
+        if output_fields is None:
+            self.output_fields = [
+                field.split(",")[0] for field in self.field_name_mapping.values()
+            ]
+        self.inverse_field_name_mapping: Dict[str, str] = {}
+        for key, value in self.field_name_mapping.items():
+            self.inverse_field_name_mapping[value.split(",")[0]] = key
+
+    def __getitem__(self, item: str) -> Any:
+        return getattr(self, item)
+
+
+def create_metadata(fields: Dict[str, Any]) -> Dict[str, Any]:
+    """Create metadata from fields.
+
+    Args:
+        fields: The fields of the document. The fields must be a dict.
+
+    Returns:
+        metadata: The metadata of the document. The metadata must be a dict.
+    """
+    metadata: Dict[str, Any] = {}
+    for key, value in fields.items():
+        if key == "id" or key == "document" or key == "embedding":
+            continue
+        metadata[key] = value
+    return metadata
+
+
+class AlibabaCloudOpenSearch(VectorStore):
+    """`Alibaba Cloud OpenSearch` vector store."""
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        config: AlibabaCloudOpenSearchSettings,
+        **kwargs: Any,
+    ) -> None:
+        try:
+            from alibabacloud_ha3engine_vector import client, models
+            from alibabacloud_tea_util import models as util_models
+        except ImportError:
+            raise ImportError(
+                "Could not import alibaba cloud opensearch python package. "
+                "Please install it with `pip install alibabacloud-ha3engine-vector`."
+            )
+
+        self.config = config
+        self.embedding = embedding
+
+        self.runtime = util_models.RuntimeOptions(
+            connect_timeout=5000,
+            read_timeout=10000,
+            autoretry=False,
+            ignore_ssl=False,
+            max_idle_conns=50,
+        )
+        self.ha3_engine_client = client.Client(
+            models.Config(
+                endpoint=config.endpoint,
+                instance_id=config.instance_id,
+                protocol=config.protocol,
+                access_user_name=config.username,
+                access_pass_word=config.password,
+            )
+        )
+
+        self.options_headers: Dict[str, str] = {}
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Insert documents into the instance..
+        Args:
+            texts: The text segments to be inserted into the vector storage,
+             should not be empty.
+            metadatas: Metadata information.
+        Returns:
+            id_list: List of document IDs.
+        """
+
+        def _upsert(push_doc_list: List[Dict]) -> List[str]:
+            if push_doc_list is None or len(push_doc_list) == 0:
+                return []
+            try:
+                push_request = models.PushDocumentsRequest(
+                    self.options_headers, push_doc_list
+                )
+                push_response = self.ha3_engine_client.push_documents(
+                    self.config.opt_table_name, field_name_map["id"], push_request
+                )
+                json_response = json.loads(push_response.body)
+                if json_response["status"] == "OK":
+                    return [
+                        push_doc["fields"][field_name_map["id"]]
+                        for push_doc in push_doc_list
+                    ]
+                return []
+            except Exception as e:
+                logger.error(
+                    f"add doc to endpoint:{self.config.endpoint} "
+                    f"instance_id:{self.config.instance_id} failed.",
+                    e,
+                )
+                raise e
+
+        from alibabacloud_ha3engine_vector import models
+
+        id_list = [sha1(t.encode("utf-8")).hexdigest() for t in texts]
+        embeddings = self.embedding.embed_documents(list(texts))
+        metadatas = metadatas or [{} for _ in texts]
+        field_name_map = self.config.field_name_mapping
+        add_doc_list = []
+        text_list = list(texts)
+        for idx, doc_id in enumerate(id_list):
+            embedding = embeddings[idx] if idx < len(embeddings) else None
+            metadata = metadatas[idx] if idx < len(metadatas) else None
+            text = text_list[idx] if idx < len(text_list) else None
+            add_doc: Dict[str, Any] = dict()
+            add_doc_fields: Dict[str, Any] = dict()
+            add_doc_fields.__setitem__(field_name_map["id"], doc_id)
+            add_doc_fields.__setitem__(field_name_map["document"], text)
+            if embedding is not None:
+                add_doc_fields.__setitem__(
+                    field_name_map["embedding"],
+                    self.config.embedding_field_separator.join(
+                        str(unit) for unit in embedding
+                    ),
+                )
+            if metadata is not None:
+                for md_key, md_value in metadata.items():
+                    add_doc_fields.__setitem__(
+                        field_name_map[md_key].split(",")[0], md_value
+                    )
+            add_doc.__setitem__("fields", add_doc_fields)
+            add_doc.__setitem__("cmd", "add")
+            add_doc_list.append(add_doc)
+        return _upsert(add_doc_list)
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        search_filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform similarity retrieval based on text.
+        Args:
+            query: Vectorize text for retrieval.，should not be empty.
+            k: top n.
+            search_filter: Additional filtering conditions.
+        Returns:
+            document_list: List of documents.
+        """
+        embedding = self.embedding.embed_query(query)
+        return self.create_results(
+            self.inner_embedding_query(
+                embedding=embedding, search_filter=search_filter, k=k
+            )
+        )
+
+    def similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        search_filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Perform similarity retrieval based on text with scores.
+        Args:
+            query: Vectorize text for retrieval.，should not be empty.
+            k: top n.
+            search_filter: Additional filtering conditions.
+        Returns:
+            document_list: List of documents.
+        """
+        embedding: List[float] = self.embedding.embed_query(query)
+        return self.create_results_with_score(
+            self.inner_embedding_query(
+                embedding=embedding, search_filter=search_filter, k=k
+            )
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        search_filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform retrieval directly using vectors.
+        Args:
+            embedding: vectors.
+            k: top n.
+            search_filter: Additional filtering conditions.
+        Returns:
+            document_list: List of documents.
+        """
+        return self.create_results(
+            self.inner_embedding_query(
+                embedding=embedding, search_filter=search_filter, k=k
+            )
+        )
+
+    def inner_embedding_query(
+        self,
+        embedding: List[float],
+        search_filter: Optional[Dict[str, Any]] = None,
+        k: int = 4,
+    ) -> Dict[str, Any]:
+        def generate_filter_query() -> str:
+            if search_filter is None:
+                return ""
+            filter_clause = " AND ".join(
+                [
+                    create_filter(md_key, md_value)
+                    for md_key, md_value in search_filter.items()
+                ]
+            )
+            return filter_clause
+
+        def create_filter(md_key: str, md_value: Any) -> str:
+            md_filter_expr = self.config.field_name_mapping[md_key]
+            if md_filter_expr is None:
+                return ""
+            expr = md_filter_expr.split(",")
+            if len(expr) != 2:
+                logger.error(
+                    f"filter {md_filter_expr} express is not correct, "
+                    f"must contain mapping field and operator."
+                )
+                return ""
+            md_filter_key = expr[0].strip()
+            md_filter_operator = expr[1].strip()
+            if isinstance(md_value, numbers.Number):
+                return f"{md_filter_key} {md_filter_operator} {md_value}"
+            return f'{md_filter_key}{md_filter_operator}"{md_value}"'
+
+        def search_data() -> Dict[str, Any]:
+            request = QueryRequest(
+                table_name=self.config.table_name,
+                namespace=self.config.namespace,
+                vector=embedding,
+                include_vector=True,
+                output_fields=self.config.output_fields,
+                filter=generate_filter_query(),
+                top_k=k,
+            )
+
+            query_result = self.ha3_engine_client.query(request)
+            return json.loads(query_result.body)
+
+        from alibabacloud_ha3engine_vector.models import QueryRequest
+
+        try:
+            json_response = search_data()
+            if (
+                "errorCode" in json_response
+                and "errorMsg" in json_response
+                and len(json_response["errorMsg"]) > 0
+            ):
+                logger.error(
+                    f"query {self.config.endpoint} {self.config.instance_id} "
+                    f"failed:{json_response['errorMsg']}."
+                )
+            else:
+                return json_response
+        except Exception as e:
+            logger.error(
+                f"query instance endpoint:{self.config.endpoint} "
+                f"instance_id:{self.config.instance_id} failed.",
+                e,
+            )
+        return {}
+
+    def create_results(self, json_result: Dict[str, Any]) -> List[Document]:
+        """Assemble documents."""
+        items = json_result["result"]
+        query_result_list: List[Document] = []
+        for item in items:
+            if (
+                "fields" not in item
+                or self.config.field_name_mapping["document"] not in item["fields"]
+            ):
+                query_result_list.append(Document())  # type: ignore[call-arg]
+            else:
+                fields = item["fields"]
+                query_result_list.append(
+                    Document(
+                        page_content=fields[self.config.field_name_mapping["document"]],
+                        metadata=self.create_inverse_metadata(fields),
+                    )
+                )
+        return query_result_list
+
+    def create_inverse_metadata(self, fields: Dict[str, Any]) -> Dict[str, Any]:
+        """Create metadata from fields.
+
+        Args:
+            fields: The fields of the document. The fields must be a dict.
+
+        Returns:
+            metadata: The metadata of the document. The metadata must be a dict.
+        """
+        metadata: Dict[str, Any] = {}
+        for key, value in fields.items():
+            if key == "id" or key == "document" or key == "embedding":
+                continue
+            metadata[self.config.inverse_field_name_mapping[key]] = value
+        return metadata
+
+    def create_results_with_score(
+        self, json_result: Dict[str, Any]
+    ) -> List[Tuple[Document, float]]:
+        """Parsing the returned results with scores.
+        Args:
+            json_result: Results from OpenSearch query.
+        Returns:
+            query_result_list: Results with scores.
+        """
+        items = json_result["result"]
+        query_result_list: List[Tuple[Document, float]] = []
+        for item in items:
+            fields = item["fields"]
+            query_result_list.append(
+                (
+                    Document(
+                        page_content=fields[self.config.field_name_mapping["document"]],
+                        metadata=self.create_inverse_metadata(fields),
+                    ),
+                    float(item["score"]),
+                )
+            )
+        return query_result_list
+
+    def delete_documents_with_texts(self, texts: List[str]) -> bool:
+        """Delete documents based on their page content.
+
+        Args:
+            texts: List of document page content.
+        Returns:
+           Whether the deletion was successful or not.
+        """
+        id_list = [sha1(t.encode("utf-8")).hexdigest() for t in texts]
+        return self.delete_documents_with_document_id(id_list)
+
+    def delete_documents_with_document_id(self, id_list: List[str]) -> bool:
+        """Delete documents based on their IDs.
+
+        Args:
+            id_list: List of document IDs.
+        Returns:
+            Whether the deletion was successful or not.
+        """
+        if id_list is None or len(id_list) == 0:
+            return True
+
+        from alibabacloud_ha3engine_vector import models
+
+        delete_doc_list = []
+        for doc_id in id_list:
+            delete_doc_list.append(
+                {
+                    "fields": {self.config.field_name_mapping["id"]: doc_id},
+                    "cmd": "delete",
+                }
+            )
+
+        delete_request = models.PushDocumentsRequest(
+            self.options_headers, delete_doc_list
+        )
+        try:
+            delete_response = self.ha3_engine_client.push_documents(
+                self.config.opt_table_name,
+                self.config.field_name_mapping["id"],
+                delete_request,
+            )
+            json_response = json.loads(delete_response.body)
+            return json_response["status"] == "OK"
+        except Exception as e:
+            logger.error(
+                f"delete doc from :{self.config.endpoint} "
+                f"instance_id:{self.config.instance_id} failed.",
+                e,
+            )
+            raise e
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        config: Optional[AlibabaCloudOpenSearchSettings] = None,
+        **kwargs: Any,
+    ) -> "AlibabaCloudOpenSearch":
+        """Create alibaba cloud opensearch vector store instance.
+
+        Args:
+            texts: The text segments to be inserted into the vector storage,
+             should not be empty.
+            embedding: Embedding function, Embedding function.
+            config: Alibaba OpenSearch instance configuration.
+            metadatas: Metadata information.
+        Returns:
+            AlibabaCloudOpenSearch: Alibaba cloud opensearch vector store instance.
+        """
+        if texts is None or len(texts) == 0:
+            raise Exception("the inserted text segments, should not be empty.")
+
+        if embedding is None:
+            raise Exception("the embeddings should not be empty.")
+
+        if config is None:
+            raise Exception("config should not be none.")
+
+        ctx = cls(embedding, config, **kwargs)
+        ctx.add_texts(texts=texts, metadatas=metadatas)
+        return ctx
+
+    @classmethod
+    def from_documents(
+        cls,
+        documents: List[Document],
+        embedding: Embeddings,
+        config: Optional[AlibabaCloudOpenSearchSettings] = None,
+        **kwargs: Any,
+    ) -> "AlibabaCloudOpenSearch":
+        """Create alibaba cloud opensearch vector store instance.
+
+        Args:
+            documents: Documents to be inserted into the vector storage,
+             should not be empty.
+            embedding: Embedding function, Embedding function.
+            config: Alibaba OpenSearch instance configuration.
+            ids: Specify the ID for the inserted document. If left empty, the ID will be
+             automatically generated based on the text content.
+        Returns:
+            AlibabaCloudOpenSearch: Alibaba cloud opensearch vector store instance.
+        """
+        if documents is None or len(documents) == 0:
+            raise Exception("the inserted documents, should not be empty.")
+
+        if embedding is None:
+            raise Exception("the embeddings should not be empty.")
+
+        if config is None:
+            raise Exception("config can't be none")
+
+        texts = [d.page_content for d in documents]
+        metadatas = [d.metadata for d in documents]
+        return cls.from_texts(
+            texts=texts,
+            embedding=embedding,
+            metadatas=metadatas,
+            config=config,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/analyticdb.py b/llm/Lib/site-packages/langchain_community/vectorstores/analyticdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..f1eda6f2c3554eefc02b91cef083c2a432cda673
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/analyticdb.py
@@ -0,0 +1,452 @@
+from __future__ import annotations
+
+import logging
+import uuid
+from typing import Any, Callable, Dict, Iterable, List, Optional, Sequence, Tuple, Type
+
+from sqlalchemy import REAL, Column, String, Table, create_engine, insert, text
+from sqlalchemy.dialects.postgresql import ARRAY, JSON, TEXT
+
+try:
+    from sqlalchemy.orm import declarative_base
+except ImportError:
+    from sqlalchemy.ext.declarative import declarative_base
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_dict_or_env
+from langchain_core.vectorstores import VectorStore
+
+_LANGCHAIN_DEFAULT_EMBEDDING_DIM = 1536
+_LANGCHAIN_DEFAULT_COLLECTION_NAME = "langchain_document"
+
+Base = declarative_base()  # type: Any
+
+
+class AnalyticDB(VectorStore):
+    """`AnalyticDB` (distributed PostgreSQL) vector store.
+
+    AnalyticDB is a distributed full postgresql syntax cloud-native database.
+    - `connection_string` is a postgres connection string.
+    - `embedding_function` any embedding function implementing
+        `langchain.embeddings.base.Embeddings` interface.
+    - `collection_name` is the name of the collection to use. (default: langchain)
+        - NOTE: This is not the name of the table, but the name of the collection.
+            The tables will be created when initializing the store (if not exists)
+            So, make sure the user has the right permissions to create tables.
+    - `pre_delete_collection` if True, will delete the collection if it exists.
+        (default: False)
+        - Useful for testing.
+
+    """
+
+    def __init__(
+        self,
+        connection_string: str,
+        embedding_function: Embeddings,
+        embedding_dimension: int = _LANGCHAIN_DEFAULT_EMBEDDING_DIM,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        pre_delete_collection: bool = False,
+        logger: Optional[logging.Logger] = None,
+        engine_args: Optional[dict] = None,
+    ) -> None:
+        self.connection_string = connection_string
+        self.embedding_function = embedding_function
+        self.embedding_dimension = embedding_dimension
+        self.collection_name = collection_name
+        self.pre_delete_collection = pre_delete_collection
+        self.logger = logger or logging.getLogger(__name__)
+        self.__post_init__(engine_args)
+
+    def __post_init__(
+        self,
+        engine_args: Optional[dict] = None,
+    ) -> None:
+        """
+        Initialize the store.
+        """
+
+        _engine_args = engine_args or {}
+
+        if (
+            "pool_recycle" not in _engine_args
+        ):  # Check if pool_recycle is not in _engine_args
+            _engine_args[
+                "pool_recycle"
+            ] = 3600  # Set pool_recycle to 3600s if not present
+
+        self.engine = create_engine(self.connection_string, **_engine_args)
+        self.create_collection()
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding_function
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        return self._euclidean_relevance_score_fn
+
+    def create_table_if_not_exists(self) -> None:
+        # Define the dynamic table
+        Table(
+            self.collection_name,
+            Base.metadata,
+            Column("id", TEXT, primary_key=True, default=uuid.uuid4),
+            Column("embedding", ARRAY(REAL)),
+            Column("document", String, nullable=True),
+            Column("metadata", JSON, nullable=True),
+            extend_existing=True,
+        )
+        with self.engine.connect() as conn:
+            with conn.begin():
+                # Create the table
+                Base.metadata.create_all(conn)
+
+                # Check if the index exists
+                index_name = f"{self.collection_name}_embedding_idx"
+                index_query = text(
+                    f"""
+                    SELECT 1
+                    FROM pg_indexes
+                    WHERE indexname = '{index_name}';
+                """
+                )
+                result = conn.execute(index_query).scalar()
+
+                # Create the index if it doesn't exist
+                if not result:
+                    index_statement = text(
+                        f"""
+                        CREATE INDEX {index_name}
+                        ON {self.collection_name} USING ann(embedding)
+                        WITH (
+                            "dim" = {self.embedding_dimension},
+                            "hnsw_m" = 100
+                        );
+                    """
+                    )
+                    conn.execute(index_statement)
+
+    def create_collection(self) -> None:
+        if self.pre_delete_collection:
+            self.delete_collection()
+        self.create_table_if_not_exists()
+
+    def delete_collection(self) -> None:
+        self.logger.debug("Trying to delete collection")
+        drop_statement = text(f"DROP TABLE IF EXISTS {self.collection_name};")
+        with self.engine.connect() as conn:
+            with conn.begin():
+                conn.execute(drop_statement)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        batch_size: int = 500,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        embeddings = self.embedding_function.embed_documents(list(texts))
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        # Define the table schema
+        chunks_table = Table(
+            self.collection_name,
+            Base.metadata,
+            Column("id", TEXT, primary_key=True),
+            Column("embedding", ARRAY(REAL)),
+            Column("document", String, nullable=True),
+            Column("metadata", JSON, nullable=True),
+            extend_existing=True,
+        )
+
+        chunks_table_data = []
+        with self.engine.connect() as conn:
+            with conn.begin():
+                for document, metadata, chunk_id, embedding in zip(
+                    texts, metadatas, ids, embeddings
+                ):
+                    chunks_table_data.append(
+                        {
+                            "id": chunk_id,
+                            "embedding": embedding,
+                            "document": document,
+                            "metadata": metadata,
+                        }
+                    )
+
+                    # Execute the batch insert when the batch size is reached
+                    if len(chunks_table_data) == batch_size:
+                        conn.execute(insert(chunks_table).values(chunks_table_data))
+                        # Clear the chunks_table_data list for the next batch
+                        chunks_table_data.clear()
+
+                # Insert any remaining records that didn't make up a full batch
+                if chunks_table_data:
+                    conn.execute(insert(chunks_table).values(chunks_table_data))
+
+        return ids
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search with AnalyticDB with distance.
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        embedding = self.embedding_function.embed_query(text=query)
+        return self.similarity_search_by_vector(
+            embedding=embedding,
+            k=k,
+            filter=filter,
+        )
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        embedding = self.embedding_function.embed_query(query)
+        docs = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return docs
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[dict] = None,
+    ) -> List[Tuple[Document, float]]:
+        # Add the filter if provided
+        try:
+            from sqlalchemy.engine import Row
+        except ImportError:
+            raise ImportError(
+                "Could not import Row from sqlalchemy.engine. "
+                "Please 'pip install sqlalchemy>=1.4'."
+            )
+
+        filter_condition = ""
+        if filter is not None:
+            conditions = [
+                f"metadata->>{key!r} = {value!r}" for key, value in filter.items()
+            ]
+            filter_condition = f"WHERE {' AND '.join(conditions)}"
+
+        # Define the base query
+        sql_query = f"""
+            SELECT *, l2_distance(embedding, :embedding) as distance
+            FROM {self.collection_name}
+            {filter_condition}
+            ORDER BY embedding <-> :embedding
+            LIMIT :k
+        """
+
+        # Set up the query parameters
+        params = {"embedding": embedding, "k": k}
+
+        # Execute the query and fetch the results
+        with self.engine.connect() as conn:
+            results: Sequence[Row] = conn.execute(text(sql_query), params).fetchall()
+
+        documents_with_scores = [
+            (
+                Document(
+                    page_content=result.document,
+                    metadata=result.metadata,
+                ),
+                result.distance if self.embedding_function is not None else None,
+            )
+            for result in results
+        ]
+        return documents_with_scores
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        """Delete by vector IDs.
+
+        Args:
+            ids: List of ids to delete.
+        """
+        if ids is None:
+            raise ValueError("No ids provided to delete.")
+
+        # Define the table schema
+        chunks_table = Table(
+            self.collection_name,
+            Base.metadata,
+            Column("id", TEXT, primary_key=True),
+            Column("embedding", ARRAY(REAL)),
+            Column("document", String, nullable=True),
+            Column("metadata", JSON, nullable=True),
+            extend_existing=True,
+        )
+
+        try:
+            with self.engine.connect() as conn:
+                with conn.begin():
+                    delete_condition = chunks_table.c.id.in_(ids)
+                    conn.execute(chunks_table.delete().where(delete_condition))
+                    return True
+        except Exception as e:
+            print("Delete operation failed:", str(e))  # noqa: T201
+            return False
+
+    @classmethod
+    def from_texts(
+        cls: Type[AnalyticDB],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        embedding_dimension: int = _LANGCHAIN_DEFAULT_EMBEDDING_DIM,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        engine_args: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> AnalyticDB:
+        """
+        Return VectorStore initialized from texts and embeddings.
+        Postgres Connection string is required
+        Either pass it as a parameter
+        or set the PG_CONNECTION_STRING environment variable.
+        """
+
+        connection_string = cls.get_connection_string(kwargs)
+
+        store = cls(
+            connection_string=connection_string,
+            collection_name=collection_name,
+            embedding_function=embedding,
+            embedding_dimension=embedding_dimension,
+            pre_delete_collection=pre_delete_collection,
+            engine_args=engine_args,
+        )
+
+        store.add_texts(texts=texts, metadatas=metadatas, ids=ids, **kwargs)
+        return store
+
+    @classmethod
+    def get_connection_string(cls, kwargs: Dict[str, Any]) -> str:
+        connection_string: str = get_from_dict_or_env(
+            data=kwargs,
+            key="connection_string",
+            env_key="PG_CONNECTION_STRING",
+        )
+
+        if not connection_string:
+            raise ValueError(
+                "Postgres connection string is required"
+                "Either pass it as a parameter"
+                "or set the PG_CONNECTION_STRING environment variable."
+            )
+
+        return connection_string
+
+    @classmethod
+    def from_documents(
+        cls: Type[AnalyticDB],
+        documents: List[Document],
+        embedding: Embeddings,
+        embedding_dimension: int = _LANGCHAIN_DEFAULT_EMBEDDING_DIM,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        engine_args: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> AnalyticDB:
+        """
+        Return VectorStore initialized from documents and embeddings.
+        Postgres Connection string is required
+        Either pass it as a parameter
+        or set the PG_CONNECTION_STRING environment variable.
+        """
+
+        texts = [d.page_content for d in documents]
+        metadatas = [d.metadata for d in documents]
+        connection_string = cls.get_connection_string(kwargs)
+
+        kwargs["connection_string"] = connection_string
+
+        return cls.from_texts(
+            texts=texts,
+            pre_delete_collection=pre_delete_collection,
+            embedding=embedding,
+            embedding_dimension=embedding_dimension,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            engine_args=engine_args,
+            **kwargs,
+        )
+
+    @classmethod
+    def connection_string_from_db_params(
+        cls,
+        driver: str,
+        host: str,
+        port: int,
+        database: str,
+        user: str,
+        password: str,
+    ) -> str:
+        """Return connection string from database parameters."""
+        return f"postgresql+{driver}://{user}:{password}@{host}:{port}/{database}"
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/annoy.py b/llm/Lib/site-packages/langchain_community/vectorstores/annoy.py
new file mode 100644
index 0000000000000000000000000000000000000000..d35def219e26f78878a14280500b98e467429697
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/annoy.py
@@ -0,0 +1,475 @@
+from __future__ import annotations
+
+import os
+import pickle
+import uuid
+from configparser import ConfigParser
+from pathlib import Path
+from typing import Any, Callable, Dict, Iterable, List, Optional, Tuple
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.docstore.base import Docstore
+from langchain_community.docstore.in_memory import InMemoryDocstore
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+INDEX_METRICS = frozenset(["angular", "euclidean", "manhattan", "hamming", "dot"])
+DEFAULT_METRIC = "angular"
+
+
+def dependable_annoy_import() -> Any:
+    """Import annoy if available, otherwise raise error."""
+    try:
+        import annoy
+    except ImportError:
+        raise ImportError(
+            "Could not import annoy python package. "
+            "Please install it with `pip install --user annoy` "
+        )
+    return annoy
+
+
+class Annoy(VectorStore):
+    """`Annoy` vector store.
+
+    To use, you should have the ``annoy`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import Annoy
+            db = Annoy(embedding_function, index, docstore, index_to_docstore_id)
+
+    """
+
+    def __init__(
+        self,
+        embedding_function: Callable,
+        index: Any,
+        metric: str,
+        docstore: Docstore,
+        index_to_docstore_id: Dict[int, str],
+    ):
+        """Initialize with necessary components."""
+        self.embedding_function = embedding_function
+        self.index = index
+        self.metric = metric
+        self.docstore = docstore
+        self.index_to_docstore_id = index_to_docstore_id
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        # TODO: Accept embedding object directly
+        return None
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        raise NotImplementedError(
+            "Annoy does not allow to add new data once the index is build."
+        )
+
+    def process_index_results(
+        self, idxs: List[int], dists: List[float]
+    ) -> List[Tuple[Document, float]]:
+        """Turns annoy results into a list of documents and scores.
+
+        Args:
+            idxs: List of indices of the documents in the index.
+            dists: List of distances of the documents in the index.
+        Returns:
+            List of Documents and scores.
+        """
+        docs = []
+        for idx, dist in zip(idxs, dists):
+            _id = self.index_to_docstore_id[idx]
+            doc = self.docstore.search(_id)
+            if not isinstance(doc, Document):
+                raise ValueError(f"Could not find document for id {_id}, got {doc}")
+            docs.append((doc, dist))
+        return docs
+
+    def similarity_search_with_score_by_vector(
+        self, embedding: List[float], k: int = 4, search_k: int = -1
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            search_k: inspect up to search_k nodes which defaults
+                to n_trees * n if not provided
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        idxs, dists = self.index.get_nns_by_vector(
+            embedding, k, search_k=search_k, include_distances=True
+        )
+        return self.process_index_results(idxs, dists)
+
+    def similarity_search_with_score_by_index(
+        self, docstore_index: int, k: int = 4, search_k: int = -1
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            search_k: inspect up to search_k nodes which defaults
+                to n_trees * n if not provided
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        idxs, dists = self.index.get_nns_by_item(
+            docstore_index, k, search_k=search_k, include_distances=True
+        )
+        return self.process_index_results(idxs, dists)
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, search_k: int = -1
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            search_k: inspect up to search_k nodes which defaults
+                to n_trees * n if not provided
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        embedding = self.embedding_function(query)
+        docs = self.similarity_search_with_score_by_vector(embedding, k, search_k)
+        return docs
+
+    def similarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, search_k: int = -1, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            search_k: inspect up to search_k nodes which defaults
+                to n_trees * n if not provided
+
+        Returns:
+            List of Documents most similar to the embedding.
+        """
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding, k, search_k
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search_by_index(
+        self, docstore_index: int, k: int = 4, search_k: int = -1, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to docstore_index.
+
+        Args:
+            docstore_index: Index of document in docstore
+            k: Number of Documents to return. Defaults to 4.
+            search_k: inspect up to search_k nodes which defaults
+                to n_trees * n if not provided
+
+        Returns:
+            List of Documents most similar to the embedding.
+        """
+        docs_and_scores = self.similarity_search_with_score_by_index(
+            docstore_index, k, search_k
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search(
+        self, query: str, k: int = 4, search_k: int = -1, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            search_k: inspect up to search_k nodes which defaults
+                to n_trees * n if not provided
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        docs_and_scores = self.similarity_search_with_score(query, k, search_k)
+        return [doc for doc, _ in docs_and_scores]
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            k: Number of Documents to return. Defaults to 4.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        idxs = self.index.get_nns_by_vector(
+            embedding, fetch_k, search_k=-1, include_distances=False
+        )
+        embeddings = [self.index.get_item_vector(i) for i in idxs]
+        mmr_selected = maximal_marginal_relevance(
+            np.array([embedding], dtype=np.float32),
+            embeddings,
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+        # ignore the -1's if not enough docs are returned/indexed
+        selected_indices = [idxs[i] for i in mmr_selected if i != -1]
+
+        docs = []
+        for i in selected_indices:
+            _id = self.index_to_docstore_id[i]
+            doc = self.docstore.search(_id)
+            if not isinstance(doc, Document):
+                raise ValueError(f"Could not find document for id {_id}, got {doc}")
+            docs.append(doc)
+        return docs
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        embedding = self.embedding_function(query)
+        docs = self.max_marginal_relevance_search_by_vector(
+            embedding, k, fetch_k, lambda_mult=lambda_mult
+        )
+        return docs
+
+    @classmethod
+    def __from(
+        cls,
+        texts: List[str],
+        embeddings: List[List[float]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        metric: str = DEFAULT_METRIC,
+        trees: int = 100,
+        n_jobs: int = -1,
+        **kwargs: Any,
+    ) -> Annoy:
+        if metric not in INDEX_METRICS:
+            raise ValueError(
+                (
+                    f"Unsupported distance metric: {metric}. "
+                    f"Expected one of {list(INDEX_METRICS)}"
+                )
+            )
+        annoy = dependable_annoy_import()
+        if not embeddings:
+            raise ValueError("embeddings must be provided to build AnnoyIndex")
+        f = len(embeddings[0])
+        index = annoy.AnnoyIndex(f, metric=metric)
+        for i, emb in enumerate(embeddings):
+            index.add_item(i, emb)
+        index.build(trees, n_jobs=n_jobs)
+
+        documents = []
+        for i, text in enumerate(texts):
+            metadata = metadatas[i] if metadatas else {}
+            documents.append(Document(page_content=text, metadata=metadata))
+        index_to_id = {i: str(uuid.uuid4()) for i in range(len(documents))}
+        docstore = InMemoryDocstore(
+            {index_to_id[i]: doc for i, doc in enumerate(documents)}
+        )
+        return cls(embedding.embed_query, index, metric, docstore, index_to_id)
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        metric: str = DEFAULT_METRIC,
+        trees: int = 100,
+        n_jobs: int = -1,
+        **kwargs: Any,
+    ) -> Annoy:
+        """Construct Annoy wrapper from raw documents.
+
+        Args:
+            texts: List of documents to index.
+            embedding: Embedding function to use.
+            metadatas: List of metadata dictionaries to associate with documents.
+            metric: Metric to use for indexing. Defaults to "angular".
+            trees: Number of trees to use for indexing. Defaults to 100.
+            n_jobs: Number of jobs to use for indexing. Defaults to -1.
+
+        This is a user friendly interface that:
+            1. Embeds documents.
+            2. Creates an in memory docstore
+            3. Initializes the Annoy database
+
+        This is intended to be a quick way to get started.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import Annoy
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                index = Annoy.from_texts(texts, embeddings)
+        """
+        embeddings = embedding.embed_documents(texts)
+        return cls.__from(
+            texts, embeddings, embedding, metadatas, metric, trees, n_jobs, **kwargs
+        )
+
+    @classmethod
+    def from_embeddings(
+        cls,
+        text_embeddings: List[Tuple[str, List[float]]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        metric: str = DEFAULT_METRIC,
+        trees: int = 100,
+        n_jobs: int = -1,
+        **kwargs: Any,
+    ) -> Annoy:
+        """Construct Annoy wrapper from embeddings.
+
+        Args:
+            text_embeddings: List of tuples of (text, embedding)
+            embedding: Embedding function to use.
+            metadatas: List of metadata dictionaries to associate with documents.
+            metric: Metric to use for indexing. Defaults to "angular".
+            trees: Number of trees to use for indexing. Defaults to 100.
+            n_jobs: Number of jobs to use for indexing. Defaults to -1
+
+        This is a user friendly interface that:
+            1. Creates an in memory docstore with provided embeddings
+            2. Initializes the Annoy database
+
+        This is intended to be a quick way to get started.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import Annoy
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                text_embeddings = embeddings.embed_documents(texts)
+                text_embedding_pairs = list(zip(texts, text_embeddings))
+                db = Annoy.from_embeddings(text_embedding_pairs, embeddings)
+        """
+        texts = [t[0] for t in text_embeddings]
+        embeddings = [t[1] for t in text_embeddings]
+
+        return cls.__from(
+            texts, embeddings, embedding, metadatas, metric, trees, n_jobs, **kwargs
+        )
+
+    def save_local(self, folder_path: str, prefault: bool = False) -> None:
+        """Save Annoy index, docstore, and index_to_docstore_id to disk.
+
+        Args:
+            folder_path: folder path to save index, docstore,
+                and index_to_docstore_id to.
+            prefault: Whether to pre-load the index into memory.
+        """
+        path = Path(folder_path)
+        os.makedirs(path, exist_ok=True)
+        # save index, index config, docstore and index_to_docstore_id
+        config_object = ConfigParser()
+        config_object["ANNOY"] = {
+            "f": self.index.f,
+            "metric": self.metric,
+        }
+        self.index.save(str(path / "index.annoy"), prefault=prefault)
+        with open(path / "index.pkl", "wb") as file:
+            pickle.dump((self.docstore, self.index_to_docstore_id, config_object), file)
+
+    @classmethod
+    def load_local(
+        cls,
+        folder_path: str,
+        embeddings: Embeddings,
+        *,
+        allow_dangerous_deserialization: bool = False,
+    ) -> Annoy:
+        """Load Annoy index, docstore, and index_to_docstore_id to disk.
+
+        Args:
+            folder_path: folder path to load index, docstore,
+                and index_to_docstore_id from.
+            embeddings: Embeddings to use when generating queries.
+            allow_dangerous_deserialization: whether to allow deserialization
+                of the data which involves loading a pickle file.
+                Pickle files can be modified by malicious actors to deliver a
+                malicious payload that results in execution of
+                arbitrary code on your machine.
+        """
+        if not allow_dangerous_deserialization:
+            raise ValueError(
+                "The de-serialization relies loading a pickle file. "
+                "Pickle files can be modified to deliver a malicious payload that "
+                "results in execution of arbitrary code on your machine."
+                "You will need to set `allow_dangerous_deserialization` to `True` to "
+                "enable deserialization. If you do this, make sure that you "
+                "trust the source of the data. For example, if you are loading a "
+                "file that you created, and no that no one else has modified the file, "
+                "then this is safe to do. Do not set this to `True` if you are loading "
+                "a file from an untrusted source (e.g., some random site on the "
+                "internet.)."
+            )
+        path = Path(folder_path)
+        # load index separately since it is not picklable
+        annoy = dependable_annoy_import()
+        # load docstore and index_to_docstore_id
+        with open(path / "index.pkl", "rb") as file:
+            docstore, index_to_docstore_id, config_object = pickle.load(file)
+
+        f = int(config_object["ANNOY"]["f"])
+        metric = config_object["ANNOY"]["metric"]
+
+        index = annoy.AnnoyIndex(f, metric=metric)
+        index.load(str(path / "index.annoy"))
+
+        return cls(
+            embeddings.embed_query, index, metric, docstore, index_to_docstore_id
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/apache_doris.py b/llm/Lib/site-packages/langchain_community/vectorstores/apache_doris.py
new file mode 100644
index 0000000000000000000000000000000000000000..79c85581a1ce56d63b452fd213761a961b6cfe65
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/apache_doris.py
@@ -0,0 +1,480 @@
+from __future__ import annotations
+
+import json
+import logging
+from hashlib import sha1
+from threading import Thread
+from typing import Any, Dict, Iterable, List, Optional, Tuple
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseSettings
+from langchain_core.vectorstores import VectorStore
+
+logger = logging.getLogger()
+DEBUG = False
+
+
+class ApacheDorisSettings(BaseSettings):
+    """Apache Doris client configuration.
+
+    Attributes:
+        apache_doris_host (str) : An URL to connect to frontend.
+                             Defaults to 'localhost'.
+        apache_doris_port (int) : URL port to connect with HTTP. Defaults to 9030.
+        username (str) : Username to login. Defaults to 'root'.
+        password (str) : Password to login. Defaults to None.
+        database (str) : Database name to find the table. Defaults to 'default'.
+        table (str) : Table name to operate on.
+                      Defaults to 'langchain'.
+
+        column_map (Dict) : Column type map to project column name onto langchain
+                            semantics. Must have keys: `text`, `id`, `vector`,
+                            must be same size to number of columns. For example:
+                            .. code-block:: python
+
+                                {
+                                    'id': 'text_id',
+                                    'embedding': 'text_embedding',
+                                    'document': 'text_plain',
+                                    'metadata': 'metadata_dictionary_in_json',
+                                }
+
+                            Defaults to identity map.
+    """
+
+    host: str = "localhost"
+    port: int = 9030
+    username: str = "root"
+    password: str = ""
+
+    column_map: Dict[str, str] = {
+        "id": "id",
+        "document": "document",
+        "embedding": "embedding",
+        "metadata": "metadata",
+    }
+
+    database: str = "default"
+    table: str = "langchain"
+
+    def __getitem__(self, item: str) -> Any:
+        return getattr(self, item)
+
+    class Config:
+        env_file = ".env"
+        env_prefix = "apache_doris_"
+        env_file_encoding = "utf-8"
+
+
+class ApacheDoris(VectorStore):
+    """`Apache Doris` vector store.
+
+    You need a `pymysql` python package, and a valid account
+    to connect to Apache Doris.
+
+    For more information, please visit
+        [Apache Doris official site](https://doris.apache.org/)
+        [Apache Doris github](https://github.com/apache/doris)
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        *,
+        config: Optional[ApacheDorisSettings] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Constructor for Apache Doris.
+
+        Args:
+            embedding (Embeddings): Text embedding model.
+            config (ApacheDorisSettings): Apache Doris client configuration information.
+        """
+        try:
+            import pymysql  # type: ignore[import]
+        except ImportError:
+            raise ImportError(
+                "Could not import pymysql python package. "
+                "Please install it with `pip install pymysql`."
+            )
+        try:
+            from tqdm import tqdm
+
+            self.pgbar = tqdm
+        except ImportError:
+            # Just in case if tqdm is not installed
+            self.pgbar = lambda x, **kwargs: x
+        super().__init__()
+        if config is not None:
+            self.config = config
+        else:
+            self.config = ApacheDorisSettings()
+        assert self.config
+        assert self.config.host and self.config.port
+        assert self.config.column_map and self.config.database and self.config.table
+        for k in ["id", "embedding", "document", "metadata"]:
+            assert k in self.config.column_map
+
+        # initialize the schema
+        dim = len(embedding.embed_query("test"))
+
+        self.schema = f"""\
+CREATE TABLE IF NOT EXISTS {self.config.database}.{self.config.table}(    
+    {self.config.column_map['id']} varchar(50),
+    {self.config.column_map['document']} string,
+    {self.config.column_map['embedding']} array<float>,
+    {self.config.column_map['metadata']} string
+) ENGINE = OLAP UNIQUE KEY(id) DISTRIBUTED BY HASH(id) \
+  PROPERTIES ("replication_allocation" = "tag.location.default: 1")\
+"""
+        self.dim = dim
+        self.BS = "\\"
+        self.must_escape = ("\\", "'")
+        self._embedding = embedding
+        self.dist_order = "DESC"
+        _debug_output(self.config)
+
+        # Create a connection to Apache Doris
+        self.connection = pymysql.connect(
+            host=self.config.host,
+            port=self.config.port,
+            user=self.config.username,
+            password=self.config.password,
+            database=self.config.database,
+            **kwargs,
+        )
+
+        _debug_output(self.schema)
+        _get_named_result(self.connection, self.schema)
+
+    def escape_str(self, value: str) -> str:
+        return "".join(f"{self.BS}{c}" if c in self.must_escape else c for c in value)
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self._embedding
+
+    def _build_insert_sql(self, transac: Iterable, column_names: Iterable[str]) -> str:
+        ks = ",".join(column_names)
+        embed_tuple_index = tuple(column_names).index(
+            self.config.column_map["embedding"]
+        )
+        _data = []
+        for n in transac:
+            n = ",".join(
+                [
+                    (
+                        f"'{self.escape_str(str(_n))}'"
+                        if idx != embed_tuple_index
+                        else f"{str(_n)}"
+                    )
+                    for (idx, _n) in enumerate(n)
+                ]
+            )
+            _data.append(f"({n})")
+        i_str = f"""
+                INSERT INTO
+                    {self.config.database}.{self.config.table}({ks})
+                VALUES
+                {','.join(_data)}
+                """
+        return i_str
+
+    def _insert(self, transac: Iterable, column_names: Iterable[str]) -> None:
+        _insert_query = self._build_insert_sql(transac, column_names)
+        _debug_output(_insert_query)
+        _get_named_result(self.connection, _insert_query)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        batch_size: int = 32,
+        ids: Optional[Iterable[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Insert more texts through the embeddings and add to the VectorStore.
+
+        Args:
+            texts: Iterable of strings to add to the VectorStore.
+            ids: Optional list of ids to associate with the texts.
+            batch_size: Batch size of insertion
+            metadata: Optional column data to be inserted
+
+        Returns:
+            List of ids from adding the texts into the VectorStore.
+
+        """
+        # Embed and create the documents
+        ids = ids or [sha1(t.encode("utf-8")).hexdigest() for t in texts]
+        colmap_ = self.config.column_map
+        transac = []
+        column_names = {
+            colmap_["id"]: ids,
+            colmap_["document"]: texts,
+            colmap_["embedding"]: self._embedding.embed_documents(list(texts)),
+        }
+        metadatas = metadatas or [{} for _ in texts]
+        column_names[colmap_["metadata"]] = map(json.dumps, metadatas)
+        assert len(set(colmap_) - set(column_names)) >= 0
+        keys, values = zip(*column_names.items())
+        try:
+            t = None
+            for v in self.pgbar(
+                zip(*values), desc="Inserting data...", total=len(metadatas)
+            ):
+                assert (
+                    len(v[keys.index(self.config.column_map["embedding"])]) == self.dim
+                )
+                transac.append(v)
+                if len(transac) == batch_size:
+                    if t:
+                        t.join()
+                    t = Thread(target=self._insert, args=[transac, keys])
+                    t.start()
+                    transac = []
+            if len(transac) > 0:
+                if t:
+                    t.join()
+                self._insert(transac, keys)
+            return [i for i in ids]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        config: Optional[ApacheDorisSettings] = None,
+        text_ids: Optional[Iterable[str]] = None,
+        batch_size: int = 32,
+        **kwargs: Any,
+    ) -> ApacheDoris:
+        """Create Apache Doris wrapper with existing texts
+
+        Args:
+            embedding_function (Embeddings): Function to extract text embedding
+            texts (Iterable[str]): List or tuple of strings to be added
+            config (ApacheDorisSettings, Optional): Apache Doris configuration
+            text_ids (Optional[Iterable], optional): IDs for the texts.
+                                                     Defaults to None.
+            batch_size (int, optional): BatchSize when transmitting data to Apache
+                                        Doris. Defaults to 32.
+            metadata (List[dict], optional): metadata to texts. Defaults to None.
+        Returns:
+            Apache Doris Index
+        """
+        ctx = cls(embedding, config=config, **kwargs)
+        ctx.add_texts(texts, ids=text_ids, batch_size=batch_size, metadatas=metadatas)
+        return ctx
+
+    def __repr__(self) -> str:
+        """Text representation for Apache Doris Vector Store, prints frontends, username
+            and schemas. Easy to use with `str(ApacheDoris())`
+
+        Returns:
+            repr: string to show connection info and data schema
+        """
+        _repr = f"\033[92m\033[1m{self.config.database}.{self.config.table} @ "
+        _repr += f"{self.config.host}:{self.config.port}\033[0m\n\n"
+        _repr += f"\033[1musername: {self.config.username}\033[0m\n\nTable Schema:\n"
+        width = 25
+        fields = 3
+        _repr += "-" * (width * fields + 1) + "\n"
+        columns = ["name", "type", "key"]
+        _repr += f"|\033[94m{columns[0]:24s}\033[0m|\033[96m{columns[1]:24s}"
+        _repr += f"\033[0m|\033[96m{columns[2]:24s}\033[0m|\n"
+        _repr += "-" * (width * fields + 1) + "\n"
+        q_str = f"DESC {self.config.database}.{self.config.table}"
+        _debug_output(q_str)
+        rs = _get_named_result(self.connection, q_str)
+        for r in rs:
+            _repr += f"|\033[94m{r['Field']:24s}\033[0m|\033[96m{r['Type']:24s}"
+            _repr += f"\033[0m|\033[96m{r['Key']:24s}\033[0m|\n"
+        _repr += "-" * (width * fields + 1) + "\n"
+        return _repr
+
+    def _build_query_sql(
+        self, q_emb: List[float], topk: int, where_str: Optional[str] = None
+    ) -> str:
+        q_emb_str = ",".join(map(str, q_emb))
+        if where_str:
+            where_str = f"WHERE {where_str}"
+        else:
+            where_str = ""
+
+        q_str = f"""
+            SELECT {self.config.column_map['document']}, 
+                {self.config.column_map['metadata']}, 
+                cosine_distance(array<float>[{q_emb_str}],
+                  {self.config.column_map['embedding']}) as dist
+            FROM {self.config.database}.{self.config.table}
+            {where_str}
+            ORDER BY dist {self.dist_order}
+            LIMIT {topk}
+            """
+
+        _debug_output(q_str)
+        return q_str
+
+    def similarity_search(
+        self, query: str, k: int = 4, where_str: Optional[str] = None, **kwargs: Any
+    ) -> List[Document]:
+        """Perform a similarity search with Apache Doris
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of Documents
+        """
+        return self.similarity_search_by_vector(
+            self._embedding.embed_query(query), k, where_str, **kwargs
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        where_str: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a similarity search with Apache Doris by vectors
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of (Document, similarity)
+        """
+        q_str = self._build_query_sql(embedding, k, where_str)
+        try:
+            return [
+                Document(
+                    page_content=r[self.config.column_map["document"]],
+                    metadata=json.loads(r[self.config.column_map["metadata"]]),
+                )
+                for r in _get_named_result(self.connection, q_str)
+            ]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    def similarity_search_with_relevance_scores(
+        self, query: str, k: int = 4, where_str: Optional[str] = None, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Perform a similarity search with Apache Doris
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of documents
+        """
+        q_str = self._build_query_sql(self._embedding.embed_query(query), k, where_str)
+        try:
+            return [
+                (
+                    Document(
+                        page_content=r[self.config.column_map["document"]],
+                        metadata=json.loads(r[self.config.column_map["metadata"]]),
+                    ),
+                    r["dist"],
+                )
+                for r in _get_named_result(self.connection, q_str)
+            ]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    def drop(self) -> None:
+        """
+        Helper function: Drop data
+        """
+        _get_named_result(
+            self.connection,
+            f"DROP TABLE IF EXISTS {self.config.database}.{self.config.table}",
+        )
+
+    @property
+    def metadata_column(self) -> str:
+        return self.config.column_map["metadata"]
+
+
+def _has_mul_sub_str(s: str, *args: Any) -> bool:
+    """Check if a string has multiple substrings.
+
+    Args:
+        s: The string to check
+        *args: The substrings to check for in the string
+
+    Returns:
+        bool: True if all substrings are present in the string, False otherwise
+    """
+    for a in args:
+        if a not in s:
+            return False
+    return True
+
+
+def _debug_output(s: Any) -> None:
+    """Print a debug message if DEBUG is True.
+
+    Args:
+        s: The message to print
+    """
+    if DEBUG:
+        print(s)  # noqa: T201
+
+
+def _get_named_result(connection: Any, query: str) -> List[dict[str, Any]]:
+    """Get a named result from a query.
+
+    Args:
+        connection: The connection to the database
+        query: The query to execute
+
+    Returns:
+        List[dict[str, Any]]: The result of the query
+    """
+    cursor = connection.cursor()
+    cursor.execute(query)
+    columns = cursor.description
+    result = []
+    for value in cursor.fetchall():
+        r = {}
+        for idx, datum in enumerate(value):
+            k = columns[idx][0]
+            r[k] = datum
+        result.append(r)
+    _debug_output(result)
+    cursor.close()
+    return result
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/astradb.py b/llm/Lib/site-packages/langchain_community/vectorstores/astradb.py
new file mode 100644
index 0000000000000000000000000000000000000000..1bc45f7490be4c67f19e14d5c38c5c6aad1135aa
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/astradb.py
@@ -0,0 +1,1285 @@
+from __future__ import annotations
+
+import uuid
+import warnings
+from concurrent.futures import ThreadPoolExecutor
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Awaitable,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+
+import numpy as np
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.runnables.utils import gather_with_concurrency
+from langchain_core.utils.iter import batch_iterate
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.utilities.astradb import (
+    SetupMode,
+    _AstraDBCollectionEnvironment,
+)
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+if TYPE_CHECKING:
+    from astrapy.db import AstraDB as LibAstraDB
+    from astrapy.db import AsyncAstraDB
+
+ADBVST = TypeVar("ADBVST", bound="AstraDB")
+T = TypeVar("T")
+U = TypeVar("U")
+DocDict = Dict[str, Any]  # dicts expressing entries to insert
+
+# Batch/concurrency default values (if parameters not provided):
+# Size of batches for bulk insertions:
+#   (20 is the max batch size for the HTTP API at the time of writing)
+DEFAULT_BATCH_SIZE = 20
+# Number of threads to insert batches concurrently:
+DEFAULT_BULK_INSERT_BATCH_CONCURRENCY = 16
+# Number of threads in a batch to insert pre-existing entries:
+DEFAULT_BULK_INSERT_OVERWRITE_CONCURRENCY = 10
+# Number of threads (for deleting multiple rows concurrently):
+DEFAULT_BULK_DELETE_CONCURRENCY = 20
+
+
+def _unique_list(lst: List[T], key: Callable[[T], U]) -> List[T]:
+    visited_keys: Set[U] = set()
+    new_lst = []
+    for item in lst:
+        item_key = key(item)
+        if item_key not in visited_keys:
+            visited_keys.add(item_key)
+            new_lst.append(item)
+    return new_lst
+
+
+@deprecated(
+    since="0.0.21",
+    removal="0.2.0",
+    alternative_import="langchain_astradb.AstraDBVectorStore",
+)
+class AstraDB(VectorStore):
+    @staticmethod
+    def _filter_to_metadata(filter_dict: Optional[Dict[str, Any]]) -> Dict[str, Any]:
+        if filter_dict is None:
+            return {}
+        else:
+            metadata_filter = {}
+            for k, v in filter_dict.items():
+                if k and k[0] == "$":
+                    if isinstance(v, list):
+                        metadata_filter[k] = [AstraDB._filter_to_metadata(f) for f in v]
+                    else:
+                        metadata_filter[k] = AstraDB._filter_to_metadata(v)  # type: ignore[assignment]
+                else:
+                    metadata_filter[f"metadata.{k}"] = v
+
+            return metadata_filter
+
+    def __init__(
+        self,
+        *,
+        embedding: Embeddings,
+        collection_name: str,
+        token: Optional[str] = None,
+        api_endpoint: Optional[str] = None,
+        astra_db_client: Optional[LibAstraDB] = None,
+        async_astra_db_client: Optional[AsyncAstraDB] = None,
+        namespace: Optional[str] = None,
+        metric: Optional[str] = None,
+        batch_size: Optional[int] = None,
+        bulk_insert_batch_concurrency: Optional[int] = None,
+        bulk_insert_overwrite_concurrency: Optional[int] = None,
+        bulk_delete_concurrency: Optional[int] = None,
+        setup_mode: SetupMode = SetupMode.SYNC,
+        pre_delete_collection: bool = False,
+    ) -> None:
+        """Wrapper around DataStax Astra DB for vector-store workloads.
+
+        For quickstart and details, visit
+        https://docs.datastax.com/en/astra/astra-db-vector/
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import AstraDB
+                from langchain_openai.embeddings import OpenAIEmbeddings
+
+                embeddings = OpenAIEmbeddings()
+                vectorstore = AstraDB(
+                    embedding=embeddings,
+                    collection_name="my_store",
+                    token="AstraCS:...",
+                    api_endpoint="https://<DB-ID>-<REGION>.apps.astra.datastax.com"
+                )
+
+                vectorstore.add_texts(["Giraffes", "All good here"])
+                results = vectorstore.similarity_search("Everything's ok", k=1)
+
+        Args:
+            embedding: embedding function to use.
+            collection_name: name of the Astra DB collection to create/use.
+            token: API token for Astra DB usage.
+            api_endpoint: full URL to the API endpoint, such as
+                `https://<DB-ID>-us-east1.apps.astra.datastax.com`.
+            astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AstraDB' instance.
+            async_astra_db_client: *alternative to token+api_endpoint*,
+                you can pass an already-created 'astrapy.db.AsyncAstraDB' instance.
+            namespace: namespace (aka keyspace) where the collection is created.
+                Defaults to the database's "default namespace".
+            metric: similarity function to use out of those available in Astra DB.
+                If left out, it will use Astra DB API's defaults (i.e. "cosine" - but,
+                for performance reasons, "dot_product" is suggested if embeddings are
+                normalized to one).
+            batch_size: Size of batches for bulk insertions.
+            bulk_insert_batch_concurrency: Number of threads or coroutines to insert
+                batches concurrently.
+            bulk_insert_overwrite_concurrency: Number of threads  or coroutines in a
+                batch to insert pre-existing entries.
+            bulk_delete_concurrency: Number of threads (for deleting multiple rows
+                concurrently).
+            pre_delete_collection: whether to delete the collection before creating it.
+                If False and the collection already exists, the collection will be used
+                as is.
+
+        Note:
+            For concurrency in synchronous :meth:`~add_texts`:, as a rule of thumb, on a
+            typical client machine it is suggested to keep the quantity
+            bulk_insert_batch_concurrency * bulk_insert_overwrite_concurrency
+            much below 1000 to avoid exhausting the client multithreading/networking
+            resources. The hardcoded defaults are somewhat conservative to meet
+            most machines' specs, but a sensible choice to test may be:
+
+            - bulk_insert_batch_concurrency = 80
+            - bulk_insert_overwrite_concurrency = 10
+
+            A bit of experimentation is required to nail the best results here,
+            depending on both the machine/network specs and the expected workload
+            (specifically, how often a write is an update of an existing id).
+            Remember you can pass concurrency settings to individual calls to
+            :meth:`~add_texts` and :meth:`~add_documents` as well.
+        """
+        self.embedding = embedding
+        self.collection_name = collection_name
+        self.token = token
+        self.api_endpoint = api_endpoint
+        self.namespace = namespace
+        # Concurrency settings
+        self.batch_size: int = batch_size or DEFAULT_BATCH_SIZE
+        self.bulk_insert_batch_concurrency: int = (
+            bulk_insert_batch_concurrency or DEFAULT_BULK_INSERT_BATCH_CONCURRENCY
+        )
+        self.bulk_insert_overwrite_concurrency: int = (
+            bulk_insert_overwrite_concurrency
+            or DEFAULT_BULK_INSERT_OVERWRITE_CONCURRENCY
+        )
+        self.bulk_delete_concurrency: int = (
+            bulk_delete_concurrency or DEFAULT_BULK_DELETE_CONCURRENCY
+        )
+        # "vector-related" settings
+        self.metric = metric
+        embedding_dimension: Union[int, Awaitable[int], None] = None
+        if setup_mode == SetupMode.ASYNC:
+            embedding_dimension = self._aget_embedding_dimension()
+        elif setup_mode == SetupMode.SYNC:
+            embedding_dimension = self._get_embedding_dimension()
+
+        self.astra_env = _AstraDBCollectionEnvironment(
+            collection_name=collection_name,
+            token=token,
+            api_endpoint=api_endpoint,
+            astra_db_client=astra_db_client,
+            async_astra_db_client=async_astra_db_client,
+            namespace=namespace,
+            setup_mode=setup_mode,
+            pre_delete_collection=pre_delete_collection,
+            embedding_dimension=embedding_dimension,
+            metric=metric,
+        )
+        self.astra_db = self.astra_env.astra_db
+        self.async_astra_db = self.astra_env.async_astra_db
+        self.collection = self.astra_env.collection
+        self.async_collection = self.astra_env.async_collection
+
+    def _get_embedding_dimension(self) -> int:
+        return len(self.embedding.embed_query(text="This is a sample sentence."))
+
+    async def _aget_embedding_dimension(self) -> int:
+        return len(await self.embedding.aembed_query(text="This is a sample sentence."))
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding
+
+    @staticmethod
+    def _dont_flip_the_cos_score(similarity0to1: float) -> float:
+        """Keep similarity from client unchanged ad it's in [0:1] already."""
+        return similarity0to1
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The underlying API calls already returns a "score proper",
+        i.e. one in [0, 1] where higher means more *similar*,
+        so here the final score transformation is not reversing the interval:
+        """
+        return self._dont_flip_the_cos_score
+
+    def clear(self) -> None:
+        """Empty the collection of all its stored entries."""
+        self.astra_env.ensure_db_setup()
+        self.collection.delete_many({})
+
+    async def aclear(self) -> None:
+        """Empty the collection of all its stored entries."""
+        await self.astra_env.aensure_db_setup()
+        await self.async_collection.delete_many({})  # type: ignore[union-attr]
+
+    def delete_by_document_id(self, document_id: str) -> bool:
+        """
+        Remove a single document from the store, given its document ID.
+
+        Args:
+            document_id: The document ID
+
+        Returns
+            True if a document has indeed been deleted, False if ID not found.
+        """
+        self.astra_env.ensure_db_setup()
+        deletion_response = self.collection.delete_one(document_id)  # type: ignore[union-attr]
+        return ((deletion_response or {}).get("status") or {}).get(
+            "deletedCount", 0
+        ) == 1
+
+    async def adelete_by_document_id(self, document_id: str) -> bool:
+        """
+        Remove a single document from the store, given its document ID.
+
+        Args:
+            document_id: The document ID
+
+        Returns
+            True if a document has indeed been deleted, False if ID not found.
+        """
+        await self.astra_env.aensure_db_setup()
+        deletion_response = await self.async_collection.delete_one(document_id)
+        return ((deletion_response or {}).get("status") or {}).get(
+            "deletedCount", 0
+        ) == 1
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        concurrency: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Optional[bool]:
+        """Delete by vector ids.
+
+        Args:
+            ids: List of ids to delete.
+            concurrency: max number of threads issuing single-doc delete requests.
+                Defaults to instance-level setting.
+
+        Returns:
+            True if deletion is successful, False otherwise.
+        """
+
+        if kwargs:
+            warnings.warn(
+                "Method 'delete' of AstraDB vector store invoked with "
+                f"unsupported arguments ({', '.join(sorted(kwargs.keys()))}), "
+                "which will be ignored."
+            )
+
+        if ids is None:
+            raise ValueError("No ids provided to delete.")
+
+        _max_workers = concurrency or self.bulk_delete_concurrency
+        with ThreadPoolExecutor(max_workers=_max_workers) as tpe:
+            _ = list(
+                tpe.map(
+                    self.delete_by_document_id,
+                    ids,
+                )
+            )
+        return True
+
+    async def adelete(
+        self,
+        ids: Optional[List[str]] = None,
+        concurrency: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Optional[bool]:
+        """Delete by vector ids.
+
+        Args:
+            ids: List of ids to delete.
+            concurrency: max concurrency of single-doc delete requests.
+                Defaults to instance-level setting.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            True if deletion is successful, False otherwise.
+        """
+        if kwargs:
+            warnings.warn(
+                "Method 'adelete' of AstraDB vector store invoked with "
+                f"unsupported arguments ({', '.join(sorted(kwargs.keys()))}), "
+                "which will be ignored."
+            )
+
+        if ids is None:
+            raise ValueError("No ids provided to delete.")
+
+        return all(
+            await gather_with_concurrency(
+                concurrency, *[self.adelete_by_document_id(doc_id) for doc_id in ids]
+            )
+        )
+
+    def delete_collection(self) -> None:
+        """
+        Completely delete the collection from the database (as opposed
+        to :meth:`~clear`, which empties it only).
+        Stored data is lost and unrecoverable, resources are freed.
+        Use with caution.
+        """
+        self.astra_env.ensure_db_setup()
+        self.astra_db.delete_collection(
+            collection_name=self.collection_name,
+        )
+
+    async def adelete_collection(self) -> None:
+        """
+        Completely delete the collection from the database (as opposed
+        to :meth:`~aclear`, which empties it only).
+        Stored data is lost and unrecoverable, resources are freed.
+        Use with caution.
+        """
+        await self.astra_env.aensure_db_setup()
+        await self.async_astra_db.delete_collection(
+            collection_name=self.collection_name,
+        )
+
+    @staticmethod
+    def _get_documents_to_insert(
+        texts: Iterable[str],
+        embedding_vectors: List[List[float]],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+    ) -> List[DocDict]:
+        if ids is None:
+            ids = [uuid.uuid4().hex for _ in texts]
+        if metadatas is None:
+            metadatas = [{} for _ in texts]
+        #
+        documents_to_insert = [
+            {
+                "content": b_txt,
+                "_id": b_id,
+                "$vector": b_emb,
+                "metadata": b_md,
+            }
+            for b_txt, b_emb, b_id, b_md in zip(
+                texts,
+                embedding_vectors,
+                ids,
+                metadatas,
+            )
+        ]
+        # make unique by id, keeping the last
+        uniqued_documents_to_insert = _unique_list(
+            documents_to_insert[::-1],
+            lambda document: document["_id"],
+        )[::-1]
+        return uniqued_documents_to_insert
+
+    @staticmethod
+    def _get_missing_from_batch(
+        document_batch: List[DocDict], insert_result: Dict[str, Any]
+    ) -> Tuple[List[str], List[DocDict]]:
+        if "status" not in insert_result:
+            raise ValueError(
+                f"API Exception while running bulk insertion: {str(insert_result)}"
+            )
+        batch_inserted = insert_result["status"]["insertedIds"]
+        # estimation of the preexisting documents that failed
+        missed_inserted_ids = {document["_id"] for document in document_batch} - set(
+            batch_inserted
+        )
+        errors = insert_result.get("errors", [])
+        # careful for other sources of error other than "doc already exists"
+        num_errors = len(errors)
+        unexpected_errors = any(
+            error.get("errorCode") != "DOCUMENT_ALREADY_EXISTS" for error in errors
+        )
+        if num_errors != len(missed_inserted_ids) or unexpected_errors:
+            raise ValueError(
+                f"API Exception while running bulk insertion: {str(errors)}"
+            )
+        # deal with the missing insertions as upserts
+        missing_from_batch = [
+            document
+            for document in document_batch
+            if document["_id"] in missed_inserted_ids
+        ]
+        return batch_inserted, missing_from_batch
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        *,
+        batch_size: Optional[int] = None,
+        batch_concurrency: Optional[int] = None,
+        overwrite_concurrency: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run texts through the embeddings and add them to the vectorstore.
+
+        If passing explicit ids, those entries whose id is in the store already
+        will be replaced.
+
+        Args:
+            texts: Texts to add to the vectorstore.
+            metadatas: Optional list of metadatas.
+            ids: Optional list of ids.
+            batch_size: Number of documents in each API call.
+                Check the underlying Astra DB HTTP API specs for the max value
+                (20 at the time of writing this). If not provided, defaults
+                to the instance-level setting.
+            batch_concurrency: number of threads to process
+                insertion batches concurrently. Defaults to instance-level
+                setting if not provided.
+            overwrite_concurrency:  number of threads to process
+                pre-existing documents in each batch (which require individual
+                API calls). Defaults to instance-level setting if not provided.
+
+        Note:
+            There are constraints on the allowed field names
+            in the metadata dictionaries, coming from the underlying Astra DB API.
+            For instance, the `$` (dollar sign) cannot be used in the dict keys.
+            See this document for details:
+            https://docs.datastax.com/en/astra/astra-db-vector/api-reference/data-api.html
+
+        Returns:
+            The list of ids of the added texts.
+        """
+
+        if kwargs:
+            warnings.warn(
+                "Method 'add_texts' of AstraDB vector store invoked with "
+                f"unsupported arguments ({', '.join(sorted(kwargs.keys()))}), "
+                "which will be ignored."
+            )
+        self.astra_env.ensure_db_setup()
+
+        embedding_vectors = self.embedding.embed_documents(list(texts))
+        documents_to_insert = self._get_documents_to_insert(
+            texts, embedding_vectors, metadatas, ids
+        )
+
+        def _handle_batch(document_batch: List[DocDict]) -> List[str]:
+            im_result = self.collection.insert_many(
+                documents=document_batch,
+                options={"ordered": False},
+                partial_failures_allowed=True,
+            )
+            batch_inserted, missing_from_batch = self._get_missing_from_batch(
+                document_batch, im_result
+            )
+
+            def _handle_missing_document(missing_document: DocDict) -> str:
+                replacement_result = self.collection.find_one_and_replace(
+                    filter={"_id": missing_document["_id"]},
+                    replacement=missing_document,
+                )
+                return replacement_result["data"]["document"]["_id"]
+
+            _u_max_workers = (
+                overwrite_concurrency or self.bulk_insert_overwrite_concurrency
+            )
+            with ThreadPoolExecutor(max_workers=_u_max_workers) as tpe2:
+                batch_replaced = list(
+                    tpe2.map(
+                        _handle_missing_document,
+                        missing_from_batch,
+                    )
+                )
+            return batch_inserted + batch_replaced
+
+        _b_max_workers = batch_concurrency or self.bulk_insert_batch_concurrency
+        with ThreadPoolExecutor(max_workers=_b_max_workers) as tpe:
+            all_ids_nested = tpe.map(
+                _handle_batch,
+                batch_iterate(
+                    batch_size or self.batch_size,
+                    documents_to_insert,
+                ),
+            )
+        return [iid for id_list in all_ids_nested for iid in id_list]
+
+    async def aadd_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        *,
+        batch_size: Optional[int] = None,
+        batch_concurrency: Optional[int] = None,
+        overwrite_concurrency: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run texts through the embeddings and add them to the vectorstore.
+
+        If passing explicit ids, those entries whose id is in the store already
+        will be replaced.
+
+        Args:
+            texts: Texts to add to the vectorstore.
+            metadatas: Optional list of metadatas.
+            ids: Optional list of ids.
+            batch_size: Number of documents in each API call.
+                Check the underlying Astra DB HTTP API specs for the max value
+                (20 at the time of writing this). If not provided, defaults
+                to the instance-level setting.
+            batch_concurrency: number of threads to process
+                insertion batches concurrently. Defaults to instance-level
+                setting if not provided.
+            overwrite_concurrency:  number of threads to process
+                pre-existing documents in each batch (which require individual
+                API calls). Defaults to instance-level setting if not provided.
+
+        Note:
+            There are constraints on the allowed field names
+            in the metadata dictionaries, coming from the underlying Astra DB API.
+            For instance, the `$` (dollar sign) cannot be used in the dict keys.
+            See this document for details:
+            https://docs.datastax.com/en/astra/astra-db-vector/api-reference/data-api.html
+
+        Returns:
+            The list of ids of the added texts.
+        """
+        if kwargs:
+            warnings.warn(
+                "Method 'aadd_texts' of AstraDB vector store invoked with "
+                f"unsupported arguments ({', '.join(sorted(kwargs.keys()))}), "
+                "which will be ignored."
+            )
+        await self.astra_env.aensure_db_setup()
+
+        embedding_vectors = await self.embedding.aembed_documents(list(texts))
+        documents_to_insert = self._get_documents_to_insert(
+            texts, embedding_vectors, metadatas, ids
+        )
+
+        async def _handle_batch(document_batch: List[DocDict]) -> List[str]:
+            im_result = await self.async_collection.insert_many(
+                documents=document_batch,
+                options={"ordered": False},
+                partial_failures_allowed=True,
+            )
+            batch_inserted, missing_from_batch = self._get_missing_from_batch(
+                document_batch, im_result
+            )
+
+            async def _handle_missing_document(missing_document: DocDict) -> str:
+                replacement_result = await self.async_collection.find_one_and_replace(
+                    filter={"_id": missing_document["_id"]},
+                    replacement=missing_document,
+                )
+                return replacement_result["data"]["document"]["_id"]
+
+            _u_max_workers = (
+                overwrite_concurrency or self.bulk_insert_overwrite_concurrency
+            )
+            batch_replaced = await gather_with_concurrency(
+                _u_max_workers,
+                *[_handle_missing_document(doc) for doc in missing_from_batch],
+            )
+            return batch_inserted + batch_replaced
+
+        _b_max_workers = batch_concurrency or self.bulk_insert_batch_concurrency
+        all_ids_nested = await gather_with_concurrency(
+            _b_max_workers,
+            *[
+                _handle_batch(batch)
+                for batch in batch_iterate(
+                    batch_size or self.batch_size,
+                    documents_to_insert,
+                )
+            ],
+        )
+
+        return [iid for id_list in all_ids_nested for iid in id_list]
+
+    def similarity_search_with_score_id_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+    ) -> List[Tuple[Document, float, str]]:
+        """Return docs most similar to embedding vector with score and id.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of (Document, score, id), the most similar to the query vector.
+        """
+        self.astra_env.ensure_db_setup()
+        metadata_parameter = self._filter_to_metadata(filter)
+        #
+        hits = list(
+            self.collection.paginated_find(
+                filter=metadata_parameter,
+                sort={"$vector": embedding},
+                options={"limit": k, "includeSimilarity": True},
+                projection={
+                    "_id": 1,
+                    "content": 1,
+                    "metadata": 1,
+                },
+            )
+        )
+        #
+        return [
+            (
+                Document(
+                    page_content=hit["content"],
+                    metadata=hit["metadata"],
+                ),
+                hit["$similarity"],
+                hit["_id"],
+            )
+            for hit in hits
+        ]
+
+    async def asimilarity_search_with_score_id_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+    ) -> List[Tuple[Document, float, str]]:
+        """Return docs most similar to embedding vector with score and id.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of (Document, score, id), the most similar to the query vector.
+        """
+        await self.astra_env.aensure_db_setup()
+        metadata_parameter = self._filter_to_metadata(filter)
+        #
+        return [
+            (
+                Document(
+                    page_content=hit["content"],
+                    metadata=hit["metadata"],
+                ),
+                hit["$similarity"],
+                hit["_id"],
+            )
+            async for hit in self.async_collection.paginated_find(
+                filter=metadata_parameter,
+                sort={"$vector": embedding},
+                options={"limit": k, "includeSimilarity": True},
+                projection={
+                    "_id": 1,
+                    "content": 1,
+                    "metadata": 1,
+                },
+            )
+        ]
+
+    def similarity_search_with_score_id(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+    ) -> List[Tuple[Document, float, str]]:
+        """Return docs most similar to the query with score and id.
+
+        Args:
+            query: Query to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of (Document, score, id), the most similar to the query.
+        """
+        embedding_vector = self.embedding.embed_query(query)
+        return self.similarity_search_with_score_id_by_vector(
+            embedding=embedding_vector,
+            k=k,
+            filter=filter,
+        )
+
+    async def asimilarity_search_with_score_id(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+    ) -> List[Tuple[Document, float, str]]:
+        """Return docs most similar to the query with score and id.
+
+        Args:
+            query: Query to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of (Document, score, id), the most similar to the query.
+        """
+        embedding_vector = await self.embedding.aembed_query(query)
+        return await self.asimilarity_search_with_score_id_by_vector(
+            embedding=embedding_vector,
+            k=k,
+            filter=filter,
+        )
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to embedding vector with score.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of (Document, score), the most similar to the query vector.
+        """
+        return [
+            (doc, score)
+            for (doc, score, doc_id) in self.similarity_search_with_score_id_by_vector(
+                embedding=embedding,
+                k=k,
+                filter=filter,
+            )
+        ]
+
+    async def asimilarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to embedding vector with score.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of (Document, score), the most similar to the query vector.
+        """
+        return [
+            (doc, score)
+            for (
+                doc,
+                score,
+                doc_id,
+            ) in await self.asimilarity_search_with_score_id_by_vector(
+                embedding=embedding,
+                k=k,
+                filter=filter,
+            )
+        ]
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Query to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of Documents most similar to the query.
+        """
+        embedding_vector = self.embedding.embed_query(query)
+        return self.similarity_search_by_vector(
+            embedding_vector,
+            k,
+            filter=filter,
+        )
+
+    async def asimilarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Query to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of Documents most similar to the query.
+        """
+        embedding_vector = await self.embedding.aembed_query(query)
+        return await self.asimilarity_search_by_vector(
+            embedding_vector,
+            k,
+            filter=filter,
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of Documents most similar to the query vector.
+        """
+        return [
+            doc
+            for doc, _ in self.similarity_search_with_score_by_vector(
+                embedding,
+                k,
+                filter=filter,
+            )
+        ]
+
+    async def asimilarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of Documents most similar to the query vector.
+        """
+        return [
+            doc
+            for doc, _ in await self.asimilarity_search_with_score_by_vector(
+                embedding,
+                k,
+                filter=filter,
+            )
+        ]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query with score.
+
+        Args:
+            query: Query to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of (Document, score), the most similar to the query vector.
+        """
+        embedding_vector = self.embedding.embed_query(query)
+        return self.similarity_search_with_score_by_vector(
+            embedding_vector,
+            k,
+            filter=filter,
+        )
+
+    async def asimilarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query with score.
+
+        Args:
+            query: Query to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of (Document, score), the most similar to the query vector.
+        """
+        embedding_vector = await self.embedding.aembed_query(query)
+        return await self.asimilarity_search_with_score_by_vector(
+            embedding_vector,
+            k,
+            filter=filter,
+        )
+
+    @staticmethod
+    def _get_mmr_hits(
+        embedding: List[float], k: int, lambda_mult: float, prefetch_hits: List[DocDict]
+    ) -> List[Document]:
+        mmr_chosen_indices = maximal_marginal_relevance(
+            np.array(embedding, dtype=np.float32),
+            [prefetch_hit["$vector"] for prefetch_hit in prefetch_hits],
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+        mmr_hits = [
+            prefetch_hit
+            for prefetch_index, prefetch_hit in enumerate(prefetch_hits)
+            if prefetch_index in mmr_chosen_indices
+        ]
+        return [
+            Document(
+                page_content=hit["content"],
+                metadata=hit["metadata"],
+            )
+            for hit in mmr_hits
+        ]
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of Documents selected by maximal marginal relevance.
+        """
+        self.astra_env.ensure_db_setup()
+        metadata_parameter = self._filter_to_metadata(filter)
+
+        prefetch_hits = list(
+            self.collection.paginated_find(
+                filter=metadata_parameter,
+                sort={"$vector": embedding},
+                options={"limit": fetch_k, "includeSimilarity": True},
+                projection={
+                    "_id": 1,
+                    "content": 1,
+                    "metadata": 1,
+                    "$vector": 1,
+                },
+            )
+        )
+
+        return self._get_mmr_hits(embedding, k, lambda_mult, prefetch_hits)
+
+    async def amax_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of Documents selected by maximal marginal relevance.
+        """
+        await self.astra_env.aensure_db_setup()
+        metadata_parameter = self._filter_to_metadata(filter)
+
+        prefetch_hits = [
+            hit
+            async for hit in self.async_collection.paginated_find(
+                filter=metadata_parameter,
+                sort={"$vector": embedding},
+                options={"limit": fetch_k, "includeSimilarity": True},
+                projection={
+                    "_id": 1,
+                    "content": 1,
+                    "metadata": 1,
+                    "$vector": 1,
+                },
+            )
+        ]
+
+        return self._get_mmr_hits(embedding, k, lambda_mult, prefetch_hits)
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Query to look up documents similar to.
+            k: Number of Documents to return.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of Documents selected by maximal marginal relevance.
+        """
+        embedding_vector = self.embedding.embed_query(query)
+        return self.max_marginal_relevance_search_by_vector(
+            embedding_vector,
+            k,
+            fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+        )
+
+    async def amax_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Query to look up documents similar to.
+            k: Number of Documents to return.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+            filter: Filter on the metadata to apply.
+
+        Returns:
+            The list of Documents selected by maximal marginal relevance.
+        """
+        embedding_vector = await self.embedding.aembed_query(query)
+        return await self.amax_marginal_relevance_search_by_vector(
+            embedding_vector,
+            k,
+            fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+        )
+
+    @classmethod
+    def _from_kwargs(
+        cls: Type[ADBVST],
+        embedding: Embeddings,
+        **kwargs: Any,
+    ) -> ADBVST:
+        known_kwargs = {
+            "collection_name",
+            "token",
+            "api_endpoint",
+            "astra_db_client",
+            "async_astra_db_client",
+            "namespace",
+            "metric",
+            "batch_size",
+            "bulk_insert_batch_concurrency",
+            "bulk_insert_overwrite_concurrency",
+            "bulk_delete_concurrency",
+            "batch_concurrency",
+            "overwrite_concurrency",
+        }
+        if kwargs:
+            unknown_kwargs = set(kwargs.keys()) - known_kwargs
+            if unknown_kwargs:
+                warnings.warn(
+                    "Method 'from_texts' of AstraDB vector store invoked with "
+                    f"unsupported arguments ({', '.join(sorted(unknown_kwargs))}), "
+                    "which will be ignored."
+                )
+
+        collection_name: str = kwargs["collection_name"]
+        token = kwargs.get("token")
+        api_endpoint = kwargs.get("api_endpoint")
+        astra_db_client = kwargs.get("astra_db_client")
+        async_astra_db_client = kwargs.get("async_astra_db_client")
+        namespace = kwargs.get("namespace")
+        metric = kwargs.get("metric")
+
+        return cls(
+            embedding=embedding,
+            collection_name=collection_name,
+            token=token,
+            api_endpoint=api_endpoint,
+            astra_db_client=astra_db_client,
+            async_astra_db_client=async_astra_db_client,
+            namespace=namespace,
+            metric=metric,
+            batch_size=kwargs.get("batch_size"),
+            bulk_insert_batch_concurrency=kwargs.get("bulk_insert_batch_concurrency"),
+            bulk_insert_overwrite_concurrency=kwargs.get(
+                "bulk_insert_overwrite_concurrency"
+            ),
+            bulk_delete_concurrency=kwargs.get("bulk_delete_concurrency"),
+        )
+
+    @classmethod
+    def from_texts(
+        cls: Type[ADBVST],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> ADBVST:
+        """Create an Astra DB vectorstore from raw texts.
+
+        Args:
+            texts: the texts to insert.
+            embedding: the embedding function to use in the store.
+            metadatas: metadata dicts for the texts.
+            ids: ids to associate to the texts.
+            **kwargs: you can pass any argument that you would
+                to :meth:`~add_texts` and/or to the 'AstraDB' constructor
+                (see these methods for details). These arguments will be
+                routed to the respective methods as they are.
+
+        Returns:
+            an `AstraDb` vectorstore.
+        """
+        astra_db_store = AstraDB._from_kwargs(embedding, **kwargs)
+        astra_db_store.add_texts(
+            texts=texts,
+            metadatas=metadatas,
+            ids=ids,
+            batch_size=kwargs.get("batch_size"),
+            batch_concurrency=kwargs.get("batch_concurrency"),
+            overwrite_concurrency=kwargs.get("overwrite_concurrency"),
+        )
+        return astra_db_store  # type: ignore[return-value]
+
+    @classmethod
+    async def afrom_texts(
+        cls: Type[ADBVST],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> ADBVST:
+        """Create an Astra DB vectorstore from raw texts.
+
+        Args:
+            texts: the texts to insert.
+            embedding: the embedding function to use in the store.
+            metadatas: metadata dicts for the texts.
+            ids: ids to associate to the texts.
+            **kwargs: you can pass any argument that you would
+                to :meth:`~add_texts` and/or to the 'AstraDB' constructor
+                (see these methods for details). These arguments will be
+                routed to the respective methods as they are.
+
+        Returns:
+            an `AstraDb` vectorstore.
+        """
+        astra_db_store = AstraDB._from_kwargs(embedding, **kwargs)
+        await astra_db_store.aadd_texts(
+            texts=texts,
+            metadatas=metadatas,
+            ids=ids,
+            batch_size=kwargs.get("batch_size"),
+            batch_concurrency=kwargs.get("batch_concurrency"),
+            overwrite_concurrency=kwargs.get("overwrite_concurrency"),
+        )
+        return astra_db_store  # type: ignore[return-value]
+
+    @classmethod
+    def from_documents(
+        cls: Type[ADBVST],
+        documents: List[Document],
+        embedding: Embeddings,
+        **kwargs: Any,
+    ) -> ADBVST:
+        """Create an Astra DB vectorstore from a document list.
+
+        Utility method that defers to 'from_texts' (see that one).
+
+        Args: see 'from_texts', except here you have to supply 'documents'
+            in place of 'texts' and 'metadatas'.
+
+        Returns:
+            an `AstraDB` vectorstore.
+        """
+        return super().from_documents(documents, embedding, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/atlas.py b/llm/Lib/site-packages/langchain_community/vectorstores/atlas.py
new file mode 100644
index 0000000000000000000000000000000000000000..b5e6b3e7899bb7b10f1495d8bd603ee68f04d158
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/atlas.py
@@ -0,0 +1,326 @@
+from __future__ import annotations
+
+import logging
+import uuid
+from typing import Any, Iterable, List, Optional, Type
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+logger = logging.getLogger(__name__)
+
+
+class AtlasDB(VectorStore):
+    """`Atlas` vector store.
+
+     Atlas is the `Nomic's` neural database and `rhizomatic` instrument.
+
+    To use, you should have the ``nomic`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+                from langchain_community.vectorstores import AtlasDB
+                from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+                embeddings = OpenAIEmbeddings()
+                vectorstore = AtlasDB("my_project", embeddings.embed_query)
+    """
+
+    _ATLAS_DEFAULT_ID_FIELD = "atlas_id"
+
+    def __init__(
+        self,
+        name: str,
+        embedding_function: Optional[Embeddings] = None,
+        api_key: Optional[str] = None,
+        description: str = "A description for your project",
+        is_public: bool = True,
+        reset_project_if_exists: bool = False,
+    ) -> None:
+        """
+        Initialize the Atlas Client
+
+        Args:
+            name (str): The name of your project. If the project already exists,
+                it will be loaded.
+            embedding_function (Optional[Embeddings]): An optional function used for
+                embedding your data. If None, data will be embedded with
+                Nomic's embed model.
+            api_key (str): Your nomic API key
+            description (str): A description for your project.
+            is_public (bool): Whether your project is publicly accessible.
+                True by default.
+            reset_project_if_exists (bool): Whether to reset this project if it
+                already exists. Default False.
+                Generally useful during development and testing.
+        """
+        try:
+            import nomic
+            from nomic import AtlasProject
+        except ImportError:
+            raise ImportError(
+                "Could not import nomic python package. "
+                "Please install it with `pip install nomic`."
+            )
+
+        if api_key is None:
+            raise ValueError("No API key provided. Sign up at atlas.nomic.ai!")
+        nomic.login(api_key)
+
+        self._embedding_function = embedding_function
+        modality = "text"
+        if self._embedding_function is not None:
+            modality = "embedding"
+
+        # Check if the project exists, create it if not
+        self.project = AtlasProject(
+            name=name,
+            description=description,
+            modality=modality,
+            is_public=is_public,
+            reset_project_if_exists=reset_project_if_exists,
+            unique_id_field=AtlasDB._ATLAS_DEFAULT_ID_FIELD,
+        )
+        self.project._latest_project_state()
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self._embedding_function
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        refresh: bool = True,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts (Iterable[str]): Texts to add to the vectorstore.
+            metadatas (Optional[List[dict]], optional): Optional list of metadatas.
+            ids (Optional[List[str]]): An optional list of ids.
+            refresh(bool): Whether or not to refresh indices with the updated data.
+                Default True.
+        Returns:
+            List[str]: List of IDs of the added texts.
+        """
+
+        if (
+            metadatas is not None
+            and len(metadatas) > 0
+            and "text" in metadatas[0].keys()
+        ):
+            raise ValueError("Cannot accept key text in metadata!")
+
+        texts = list(texts)
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        # Embedding upload case
+        if self._embedding_function is not None:
+            _embeddings = self._embedding_function.embed_documents(texts)
+            embeddings = np.stack(_embeddings)
+            if metadatas is None:
+                data = [
+                    {AtlasDB._ATLAS_DEFAULT_ID_FIELD: ids[i], "text": texts[i]}
+                    for i, _ in enumerate(texts)
+                ]
+            else:
+                for i in range(len(metadatas)):
+                    metadatas[i][AtlasDB._ATLAS_DEFAULT_ID_FIELD] = ids[i]
+                    metadatas[i]["text"] = texts[i]
+                data = metadatas
+
+            self.project._validate_map_data_inputs(
+                [], id_field=AtlasDB._ATLAS_DEFAULT_ID_FIELD, data=data
+            )
+            with self.project.wait_for_project_lock():
+                self.project.add_embeddings(embeddings=embeddings, data=data)
+        # Text upload case
+        else:
+            if metadatas is None:
+                data = [
+                    {"text": text, AtlasDB._ATLAS_DEFAULT_ID_FIELD: ids[i]}
+                    for i, text in enumerate(texts)
+                ]
+            else:
+                for i, text in enumerate(texts):
+                    metadatas[i]["text"] = texts
+                    metadatas[i][AtlasDB._ATLAS_DEFAULT_ID_FIELD] = ids[i]
+                data = metadatas
+
+            self.project._validate_map_data_inputs(
+                [], id_field=AtlasDB._ATLAS_DEFAULT_ID_FIELD, data=data
+            )
+
+            with self.project.wait_for_project_lock():
+                self.project.add_text(data)
+
+        if refresh:
+            if len(self.project.indices) > 0:
+                with self.project.wait_for_project_lock():
+                    self.project.rebuild_maps()
+
+        return ids
+
+    def create_index(self, **kwargs: Any) -> Any:
+        """Creates an index in your project.
+
+        See
+        https://docs.nomic.ai/atlas_api.html#nomic.project.AtlasProject.create_index
+        for full detail.
+        """
+        with self.project.wait_for_project_lock():
+            return self.project.create_index(**kwargs)
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search with AtlasDB
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 4.
+
+        Returns:
+            List[Document]: List of documents most similar to the query text.
+        """
+        if self._embedding_function is None:
+            raise NotImplementedError(
+                "AtlasDB requires an embedding_function for text similarity search!"
+            )
+
+        _embedding = self._embedding_function.embed_documents([query])[0]
+        embedding = np.array(_embedding).reshape(1, -1)
+        with self.project.wait_for_project_lock():
+            neighbors, _ = self.project.projections[0].vector_search(
+                queries=embedding, k=k
+            )
+            data = self.project.get_data(ids=neighbors[0])
+
+        docs = [
+            Document(page_content=data[i]["text"], metadata=data[i])
+            for i, neighbor in enumerate(neighbors)
+        ]
+        return docs
+
+    @classmethod
+    def from_texts(
+        cls: Type[AtlasDB],
+        texts: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        name: Optional[str] = None,
+        api_key: Optional[str] = None,
+        description: str = "A description for your project",
+        is_public: bool = True,
+        reset_project_if_exists: bool = False,
+        index_kwargs: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> AtlasDB:
+        """Create an AtlasDB vectorstore from a raw documents.
+
+        Args:
+            texts (List[str]): The list of texts to ingest.
+            name (str): Name of the project to create.
+            api_key (str): Your nomic API key,
+            embedding (Optional[Embeddings]): Embedding function. Defaults to None.
+            metadatas (Optional[List[dict]]): List of metadatas. Defaults to None.
+            ids (Optional[List[str]]): Optional list of document IDs. If None,
+                ids will be auto created
+            description (str): A description for your project.
+            is_public (bool): Whether your project is publicly accessible.
+                True by default.
+            reset_project_if_exists (bool): Whether to reset this project if it
+                already exists. Default False.
+                Generally useful during development and testing.
+            index_kwargs (Optional[dict]): Dict of kwargs for index creation.
+                See https://docs.nomic.ai/atlas_api.html
+
+        Returns:
+            AtlasDB: Nomic's neural database and finest rhizomatic instrument
+        """
+        if name is None or api_key is None:
+            raise ValueError("`name` and `api_key` cannot be None.")
+
+        # Inject relevant kwargs
+        all_index_kwargs = {"name": name + "_index", "indexed_field": "text"}
+        if index_kwargs is not None:
+            for k, v in index_kwargs.items():
+                all_index_kwargs[k] = v
+
+        # Build project
+        atlasDB = cls(
+            name,
+            embedding_function=embedding,
+            api_key=api_key,
+            description="A description for your project",
+            is_public=is_public,
+            reset_project_if_exists=reset_project_if_exists,
+        )
+        with atlasDB.project.wait_for_project_lock():
+            atlasDB.add_texts(texts=texts, metadatas=metadatas, ids=ids)
+            atlasDB.create_index(**all_index_kwargs)
+        return atlasDB
+
+    @classmethod
+    def from_documents(
+        cls: Type[AtlasDB],
+        documents: List[Document],
+        embedding: Optional[Embeddings] = None,
+        ids: Optional[List[str]] = None,
+        name: Optional[str] = None,
+        api_key: Optional[str] = None,
+        persist_directory: Optional[str] = None,
+        description: str = "A description for your project",
+        is_public: bool = True,
+        reset_project_if_exists: bool = False,
+        index_kwargs: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> AtlasDB:
+        """Create an AtlasDB vectorstore from a list of documents.
+
+        Args:
+            name (str): Name of the collection to create.
+            api_key (str): Your nomic API key,
+            documents (List[Document]): List of documents to add to the vectorstore.
+            embedding (Optional[Embeddings]): Embedding function. Defaults to None.
+            ids (Optional[List[str]]): Optional list of document IDs. If None,
+                ids will be auto created
+            description (str): A description for your project.
+            is_public (bool): Whether your project is publicly accessible.
+                True by default.
+            reset_project_if_exists (bool): Whether to reset this project if
+                it already exists. Default False.
+                Generally useful during development and testing.
+            index_kwargs (Optional[dict]): Dict of kwargs for index creation.
+                See https://docs.nomic.ai/atlas_api.html
+
+        Returns:
+            AtlasDB: Nomic's neural database and finest rhizomatic instrument
+        """
+        if name is None or api_key is None:
+            raise ValueError("`name` and `api_key` cannot be None.")
+        texts = [doc.page_content for doc in documents]
+        metadatas = [doc.metadata for doc in documents]
+        return cls.from_texts(
+            name=name,
+            api_key=api_key,
+            texts=texts,
+            embedding=embedding,
+            metadatas=metadatas,
+            ids=ids,
+            description=description,
+            is_public=is_public,
+            reset_project_if_exists=reset_project_if_exists,
+            index_kwargs=index_kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/awadb.py b/llm/Lib/site-packages/langchain_community/vectorstores/awadb.py
new file mode 100644
index 0000000000000000000000000000000000000000..96555558eddece1614324fb0d3beeea2bab6876d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/awadb.py
@@ -0,0 +1,627 @@
+from __future__ import annotations
+
+import logging
+import uuid
+from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Optional, Set, Tuple, Type
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+if TYPE_CHECKING:
+    import awadb
+
+logger = logging.getLogger()
+DEFAULT_TOPN = 4
+
+
+class AwaDB(VectorStore):
+    """`AwaDB` vector store."""
+
+    _DEFAULT_TABLE_NAME = "langchain_awadb"
+
+    def __init__(
+        self,
+        table_name: str = _DEFAULT_TABLE_NAME,
+        embedding: Optional[Embeddings] = None,
+        log_and_data_dir: Optional[str] = None,
+        client: Optional[awadb.Client] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Initialize with AwaDB client.
+           If table_name is not specified,
+           a random table name of `_DEFAULT_TABLE_NAME + last segment of uuid`
+           would be created automatically.
+
+        Args:
+            table_name: Name of the table created, default _DEFAULT_TABLE_NAME.
+            embedding: Optional Embeddings initially set.
+            log_and_data_dir: Optional the root directory of log and data.
+            client: Optional AwaDB client.
+            kwargs: Any possible extend parameters in the future.
+
+        Returns:
+            None.
+        """
+        try:
+            import awadb
+        except ImportError:
+            raise ImportError(
+                "Could not import awadb python package. "
+                "Please install it with `pip install awadb`."
+            )
+
+        if client is not None:
+            self.awadb_client = client
+        else:
+            if log_and_data_dir is not None:
+                self.awadb_client = awadb.Client(log_and_data_dir)
+            else:
+                self.awadb_client = awadb.Client()
+
+        if table_name == self._DEFAULT_TABLE_NAME:
+            table_name += "_"
+            table_name += str(uuid.uuid4()).split("-")[-1]
+
+        self.awadb_client.Create(table_name)
+        self.table2embeddings: dict[str, Embeddings] = {}
+        if embedding is not None:
+            self.table2embeddings[table_name] = embedding
+        self.using_table_name = table_name
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        if self.using_table_name in self.table2embeddings:
+            return self.table2embeddings[self.using_table_name]
+        return None
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        is_duplicate_texts: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            is_duplicate_texts: Optional whether to duplicate texts. Defaults to True.
+            kwargs: any possible extend parameters in the future.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        if self.awadb_client is None:
+            raise ValueError("AwaDB client is None!!!")
+
+        embeddings = None
+        if self.using_table_name in self.table2embeddings:
+            embeddings = self.table2embeddings[self.using_table_name].embed_documents(
+                list(texts)
+            )
+
+        return self.awadb_client.AddTexts(
+            "embedding_text",
+            "text_embedding",
+            texts,
+            embeddings,
+            metadatas,
+            is_duplicate_texts,
+        )
+
+    def load_local(
+        self,
+        table_name: str,
+        **kwargs: Any,
+    ) -> bool:
+        """Load the local specified table.
+
+        Args:
+            table_name: Table name
+            kwargs: Any possible extend parameters in the future.
+
+        Returns:
+            Success or failure of loading the local specified table
+        """
+
+        if self.awadb_client is None:
+            raise ValueError("AwaDB client is None!!!")
+
+        return self.awadb_client.Load(table_name)
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = DEFAULT_TOPN,
+        text_in_page_content: Optional[str] = None,
+        meta_filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text query.
+            k: The maximum number of documents to return.
+            text_in_page_content: Filter by the text in page_content of Document.
+            meta_filter (Optional[dict]): Filter by metadata. Defaults to None.
+            E.g. `{"color" : "red", "price": 4.20}`. Optional.
+            E.g. `{"max_price" : 15.66, "min_price": 4.20}`
+            `price` is the metadata field, means range filter(4.20<'price'<15.66).
+            E.g. `{"maxe_price" : 15.66, "mine_price": 4.20}`
+            `price` is the metadata field, means range filter(4.20<='price'<=15.66).
+            kwargs: Any possible extend parameters in the future.
+
+        Returns:
+            Returns the k most similar documents to the specified text query.
+        """
+
+        if self.awadb_client is None:
+            raise ValueError("AwaDB client is None!!!")
+
+        embedding = None
+        if self.using_table_name in self.table2embeddings:
+            embedding = self.table2embeddings[self.using_table_name].embed_query(query)
+        else:
+            from awadb import AwaEmbedding
+
+            embedding = AwaEmbedding().Embedding(query)
+
+        not_include_fields: Set[str] = {"text_embedding", "_id", "score"}
+        return self.similarity_search_by_vector(
+            embedding,
+            k,
+            text_in_page_content=text_in_page_content,
+            meta_filter=meta_filter,
+            not_include_fields_in_metadata=not_include_fields,
+        )
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = DEFAULT_TOPN,
+        text_in_page_content: Optional[str] = None,
+        meta_filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """The most k similar documents and scores of the specified query.
+
+        Args:
+            query: Text query.
+            k: The k most similar documents to the text query.
+            text_in_page_content: Filter by the text in page_content of Document.
+            meta_filter: Filter by metadata. Defaults to None.
+            kwargs: Any possible extend parameters in the future.
+
+        Returns:
+            The k most similar documents to the specified text query.
+            0 is dissimilar, 1 is the most similar.
+        """
+
+        if self.awadb_client is None:
+            raise ValueError("AwaDB client is None!!!")
+
+        embedding = None
+        if self.using_table_name in self.table2embeddings:
+            embedding = self.table2embeddings[self.using_table_name].embed_query(query)
+        else:
+            from awadb import AwaEmbedding
+
+            embedding = AwaEmbedding().Embedding(query)
+
+        results: List[Tuple[Document, float]] = []
+
+        not_include_fields: Set[str] = {"text_embedding", "_id"}
+        retrieval_docs = self.similarity_search_by_vector(
+            embedding,
+            k,
+            text_in_page_content=text_in_page_content,
+            meta_filter=meta_filter,
+            not_include_fields_in_metadata=not_include_fields,
+        )
+
+        for doc in retrieval_docs:
+            score = doc.metadata["score"]
+            del doc.metadata["score"]
+            doc_tuple = (doc, score)
+            results.append(doc_tuple)
+
+        return results
+
+    def _similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        return self.similarity_search_with_score(query, k, **kwargs)
+
+    def similarity_search_by_vector(
+        self,
+        embedding: Optional[List[float]] = None,
+        k: int = DEFAULT_TOPN,
+        text_in_page_content: Optional[str] = None,
+        meta_filter: Optional[dict] = None,
+        not_include_fields_in_metadata: Optional[Set[str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            text_in_page_content: Filter by the text in page_content of Document.
+            meta_filter: Filter by metadata. Defaults to None.
+            not_incude_fields_in_metadata: Not include meta fields of each document.
+
+        Returns:
+            List of Documents which are the most similar to the query vector.
+        """
+
+        if self.awadb_client is None:
+            raise ValueError("AwaDB client is None!!!")
+
+        results: List[Document] = []
+
+        if embedding is None:
+            return results
+
+        show_results = self.awadb_client.Search(
+            embedding,
+            k,
+            text_in_page_content=text_in_page_content,
+            meta_filter=meta_filter,
+            not_include_fields=not_include_fields_in_metadata,
+        )
+
+        if show_results.__len__() == 0:
+            return results
+
+        for item_detail in show_results[0]["ResultItems"]:
+            content = ""
+            meta_data = {}
+            for item_key in item_detail:
+                if item_key == "embedding_text":
+                    content = item_detail[item_key]
+                    continue
+                elif not_include_fields_in_metadata is not None:
+                    if item_key in not_include_fields_in_metadata:
+                        continue
+                meta_data[item_key] = item_detail[item_key]
+            results.append(Document(page_content=content, metadata=meta_data))
+        return results
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        text_in_page_content: Optional[str] = None,
+        meta_filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            text_in_page_content: Filter by the text in page_content of Document.
+            meta_filter (Optional[dict]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        if self.awadb_client is None:
+            raise ValueError("AwaDB client is None!!!")
+
+        embedding: List[float] = []
+        if self.using_table_name in self.table2embeddings:
+            embedding = self.table2embeddings[self.using_table_name].embed_query(query)
+        else:
+            from awadb import AwaEmbedding
+
+            embedding = AwaEmbedding().Embedding(query)
+
+        if embedding.__len__() == 0:
+            return []
+
+        results = self.max_marginal_relevance_search_by_vector(
+            embedding,
+            k,
+            fetch_k,
+            lambda_mult=lambda_mult,
+            text_in_page_content=text_in_page_content,
+            meta_filter=meta_filter,
+        )
+        return results
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        text_in_page_content: Optional[str] = None,
+        meta_filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            text_in_page_content: Filter by the text in page_content of Document.
+            meta_filter (Optional[dict]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+
+        if self.awadb_client is None:
+            raise ValueError("AwaDB client is None!!!")
+
+        results: List[Document] = []
+
+        if embedding is None:
+            return results
+
+        not_include_fields: set = {"_id", "score"}
+        retrieved_docs = self.similarity_search_by_vector(
+            embedding,
+            fetch_k,
+            text_in_page_content=text_in_page_content,
+            meta_filter=meta_filter,
+            not_include_fields_in_metadata=not_include_fields,
+        )
+
+        top_embeddings = []
+
+        for doc in retrieved_docs:
+            top_embeddings.append(doc.metadata["text_embedding"])
+
+        selected_docs = maximal_marginal_relevance(
+            np.array(embedding, dtype=np.float32), embedding_list=top_embeddings
+        )
+
+        for s_id in selected_docs:
+            if "text_embedding" in retrieved_docs[s_id].metadata:
+                del retrieved_docs[s_id].metadata["text_embedding"]
+                results.append(retrieved_docs[s_id])
+        return results
+
+    def get(
+        self,
+        ids: Optional[List[str]] = None,
+        text_in_page_content: Optional[str] = None,
+        meta_filter: Optional[dict] = None,
+        not_include_fields: Optional[Set[str]] = None,
+        limit: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Dict[str, Document]:
+        """Return docs according ids.
+
+        Args:
+            ids: The ids of the embedding vectors.
+            text_in_page_content: Filter by the text in page_content of Document.
+            meta_filter: Filter by any metadata of the document.
+            not_include_fields: Not pack the specified fields of each document.
+            limit: The number of documents to return. Defaults to 5. Optional.
+
+        Returns:
+            Documents which satisfy the input conditions.
+        """
+
+        if self.awadb_client is None:
+            raise ValueError("AwaDB client is None!!!")
+
+        docs_detail = self.awadb_client.Get(
+            ids=ids,
+            text_in_page_content=text_in_page_content,
+            meta_filter=meta_filter,
+            not_include_fields=not_include_fields,
+            limit=limit,
+        )
+
+        results: Dict[str, Document] = {}
+        for doc_detail in docs_detail:
+            content = ""
+            meta_info = {}
+            for field in doc_detail:
+                if field == "embedding_text":
+                    content = doc_detail[field]
+                    continue
+                elif field == "text_embedding" or field == "_id":
+                    continue
+
+                meta_info[field] = doc_detail[field]
+
+            doc = Document(page_content=content, metadata=meta_info)
+            results[doc_detail["_id"]] = doc
+        return results
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Optional[bool]:
+        """Delete the documents which have the specified ids.
+
+        Args:
+            ids: The ids of the embedding vectors.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful.
+            False otherwise, None if not implemented.
+        """
+        if self.awadb_client is None:
+            raise ValueError("AwaDB client is None!!!")
+        ret: Optional[bool] = None
+        if ids is None or ids.__len__() == 0:
+            return ret
+        ret = self.awadb_client.Delete(ids)
+        return ret
+
+    def update(
+        self,
+        ids: List[str],
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Update the documents which have the specified ids.
+
+        Args:
+            ids: The id list of the updating embedding vector.
+            texts: The texts of the updating documents.
+            metadatas: The metadatas of the updating documents.
+        Returns:
+            the ids of the updated documents.
+        """
+
+        if self.awadb_client is None:
+            raise ValueError("AwaDB client is None!!!")
+
+        return self.awadb_client.UpdateTexts(
+            ids=ids, text_field_name="embedding_text", texts=texts, metadatas=metadatas
+        )
+
+    def create_table(
+        self,
+        table_name: str,
+        **kwargs: Any,
+    ) -> bool:
+        """Create a new table."""
+
+        if self.awadb_client is None:
+            return False
+
+        ret = self.awadb_client.Create(table_name)
+
+        if ret:
+            self.using_table_name = table_name
+        return ret
+
+    def use(
+        self,
+        table_name: str,
+        **kwargs: Any,
+    ) -> bool:
+        """Use the specified table. Don't know the tables, please invoke list_tables."""
+
+        if self.awadb_client is None:
+            return False
+
+        ret = self.awadb_client.Use(table_name)
+        if ret:
+            self.using_table_name = table_name
+
+        return ret
+
+    def list_tables(
+        self,
+        **kwargs: Any,
+    ) -> List[str]:
+        """List all the tables created by the client."""
+
+        if self.awadb_client is None:
+            return []
+
+        return self.awadb_client.ListAllTables()
+
+    def get_current_table(
+        self,
+        **kwargs: Any,
+    ) -> str:
+        """Get the current table."""
+
+        return self.using_table_name
+
+    @classmethod
+    def from_texts(
+        cls: Type[AwaDB],
+        texts: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[dict]] = None,
+        table_name: str = _DEFAULT_TABLE_NAME,
+        log_and_data_dir: Optional[str] = None,
+        client: Optional[awadb.Client] = None,
+        **kwargs: Any,
+    ) -> AwaDB:
+        """Create an AwaDB vectorstore from a raw documents.
+
+        Args:
+            texts (List[str]): List of texts to add to the table.
+            embedding (Optional[Embeddings]): Embedding function. Defaults to None.
+            metadatas (Optional[List[dict]]): List of metadatas. Defaults to None.
+            table_name (str): Name of the table to create.
+            log_and_data_dir (Optional[str]): Directory of logging and persistence.
+            client (Optional[awadb.Client]): AwaDB client
+
+        Returns:
+            AwaDB: AwaDB vectorstore.
+        """
+        awadb_client = cls(
+            table_name=table_name,
+            embedding=embedding,
+            log_and_data_dir=log_and_data_dir,
+            client=client,
+        )
+        awadb_client.add_texts(texts=texts, metadatas=metadatas)
+        return awadb_client
+
+    @classmethod
+    def from_documents(
+        cls: Type[AwaDB],
+        documents: List[Document],
+        embedding: Optional[Embeddings] = None,
+        table_name: str = _DEFAULT_TABLE_NAME,
+        log_and_data_dir: Optional[str] = None,
+        client: Optional[awadb.Client] = None,
+        **kwargs: Any,
+    ) -> AwaDB:
+        """Create an AwaDB vectorstore from a list of documents.
+
+        If a log_and_data_dir specified, the table will be persisted there.
+
+        Args:
+            documents (List[Document]): List of documents to add to the vectorstore.
+            embedding (Optional[Embeddings]): Embedding function. Defaults to None.
+            table_name (str): Name of the table to create.
+            log_and_data_dir (Optional[str]): Directory to persist the table.
+            client (Optional[awadb.Client]): AwaDB client.
+            Any: Any possible parameters in the future
+
+        Returns:
+            AwaDB: AwaDB vectorstore.
+        """
+        texts = [doc.page_content for doc in documents]
+        metadatas = [doc.metadata for doc in documents]
+        return cls.from_texts(
+            texts=texts,
+            embedding=embedding,
+            metadatas=metadatas,
+            table_name=table_name,
+            log_and_data_dir=log_and_data_dir,
+            client=client,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/azure_cosmos_db.py b/llm/Lib/site-packages/langchain_community/vectorstores/azure_cosmos_db.py
new file mode 100644
index 0000000000000000000000000000000000000000..c984246fbe5444923418225ea9ef662a5e48b1f1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/azure_cosmos_db.py
@@ -0,0 +1,585 @@
+from __future__ import annotations
+
+import logging
+from enum import Enum
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    Generator,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    TypeVar,
+    Union,
+)
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+if TYPE_CHECKING:
+    from langchain_core.embeddings import Embeddings
+    from pymongo.collection import Collection
+
+
+# Before Python 3.11 native StrEnum is not available
+class CosmosDBSimilarityType(str, Enum):
+    """Cosmos DB Similarity Type as enumerator."""
+
+    COS = "COS"
+    """CosineSimilarity"""
+    IP = "IP"
+    """inner - product"""
+    L2 = "L2"
+    """Euclidean distance"""
+
+
+class CosmosDBVectorSearchType(str, Enum):
+    """Cosmos DB Vector Search Type as enumerator."""
+
+    VECTOR_IVF = "vector-ivf"
+    """IVF vector index"""
+    VECTOR_HNSW = "vector-hnsw"
+    """HNSW vector index"""
+
+
+CosmosDBDocumentType = TypeVar("CosmosDBDocumentType", bound=Dict[str, Any])
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_INSERT_BATCH_SIZE = 128
+
+
+class AzureCosmosDBVectorSearch(VectorStore):
+    """`Azure Cosmos DB for MongoDB vCore` vector store.
+
+    To use, you should have both:
+    - the ``pymongo`` python package installed
+    - a connection string associated with a MongoDB VCore Cluster
+
+    Example:
+        . code-block:: python
+
+            from langchain_community.vectorstores import AzureCosmosDBVectorSearch
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+            from pymongo import MongoClient
+
+            mongo_client = MongoClient("<YOUR-CONNECTION-STRING>")
+            collection = mongo_client["<db_name>"]["<collection_name>"]
+            embeddings = OpenAIEmbeddings()
+            vectorstore = AzureCosmosDBVectorSearch(collection, embeddings)
+    """
+
+    def __init__(
+        self,
+        collection: Collection[CosmosDBDocumentType],
+        embedding: Embeddings,
+        *,
+        index_name: str = "vectorSearchIndex",
+        text_key: str = "textContent",
+        embedding_key: str = "vectorContent",
+    ):
+        """Constructor for AzureCosmosDBVectorSearch
+
+        Args:
+            collection: MongoDB collection to add the texts to.
+            embedding: Text embedding model to use.
+            index_name: Name of the Atlas Search index.
+            text_key: MongoDB field that will contain the text
+                for each document.
+            embedding_key: MongoDB field that will contain the embedding
+                for each document.
+        """
+        self._collection = collection
+        self._embedding = embedding
+        self._index_name = index_name
+        self._text_key = text_key
+        self._embedding_key = embedding_key
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self._embedding
+
+    def get_index_name(self) -> str:
+        """Returns the index name
+
+        Returns:
+            Returns the index name
+
+        """
+        return self._index_name
+
+    @classmethod
+    def from_connection_string(
+        cls,
+        connection_string: str,
+        namespace: str,
+        embedding: Embeddings,
+        application_name: str = "LANGCHAIN_PYTHON",
+        **kwargs: Any,
+    ) -> AzureCosmosDBVectorSearch:
+        """Creates an Instance of AzureCosmosDBVectorSearch from a Connection String
+
+        Args:
+            connection_string: The MongoDB vCore instance connection string
+            namespace: The namespace (database.collection)
+            embedding: The embedding utility
+            **kwargs: Dynamic keyword arguments
+
+        Returns:
+            an instance of the vector store
+
+        """
+        try:
+            from pymongo import MongoClient
+        except ImportError:
+            raise ImportError(
+                "Could not import pymongo, please install it with "
+                "`pip install pymongo`."
+            )
+        appname = application_name
+        client: MongoClient = MongoClient(connection_string, appname=appname)
+        db_name, collection_name = namespace.split(".")
+        collection = client[db_name][collection_name]
+        return cls(collection, embedding, **kwargs)
+
+    def index_exists(self) -> bool:
+        """Verifies if the specified index name during instance
+            construction exists on the collection
+
+        Returns:
+          Returns True on success and False if no such index exists
+            on the collection
+        """
+        cursor = self._collection.list_indexes()
+        index_name = self._index_name
+
+        for res in cursor:
+            current_index_name = res.pop("name")
+            if current_index_name == index_name:
+                return True
+
+        return False
+
+    def delete_index(self) -> None:
+        """Deletes the index specified during instance construction if it exists"""
+        if self.index_exists():
+            self._collection.drop_index(self._index_name)
+            # Raises OperationFailure on an error (e.g. trying to drop
+            # an index that does not exist)
+
+    def create_index(
+        self,
+        num_lists: int = 100,
+        dimensions: int = 1536,
+        similarity: CosmosDBSimilarityType = CosmosDBSimilarityType.COS,
+        kind: str = "vector-ivf",
+        m: int = 16,
+        ef_construction: int = 64,
+    ) -> dict[str, Any]:
+        """Creates an index using the index name specified at
+            instance construction
+
+        Setting the numLists parameter correctly is important for achieving
+            good accuracy and performance.
+            Since the vector store uses IVF as the indexing strategy,
+            you should create the index only after you
+            have loaded a large enough sample documents to ensure that the
+            centroids for the respective buckets are
+            faily distributed.
+
+        We recommend that numLists is set to documentCount/1000 for up
+            to 1 million documents
+            and to sqrt(documentCount) for more than 1 million documents.
+            As the number of items in your database grows, you should
+            tune numLists to be larger
+            in order to achieve good latency performance for vector search.
+
+            If you're experimenting with a new scenario or creating a
+            small demo, you can start with numLists
+            set to 1 to perform a brute-force search across all vectors.
+            This should provide you with the most
+            accurate results from the vector search, however be aware that
+            the search speed and latency will be slow.
+            After your initial setup, you should go ahead and tune
+            the numLists parameter using the above guidance.
+
+        Args:
+            kind: Type of vector index to create.
+                Possible options are:
+                    - vector-ivf
+                    - vector-hnsw: available as a preview feature only,
+                                   to enable visit https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/preview-features
+            num_lists: This integer is the number of clusters that the
+                inverted file (IVF) index uses to group the vector data.
+                We recommend that numLists is set to documentCount/1000
+                for up to 1 million documents and to sqrt(documentCount)
+                for more than 1 million documents.
+                Using a numLists value of 1 is akin to performing
+                brute-force search, which has limited performance
+            dimensions: Number of dimensions for vector similarity.
+                The maximum number of supported dimensions is 2000
+            similarity: Similarity metric to use with the IVF index.
+
+                Possible options are:
+                    - CosmosDBSimilarityType.COS (cosine distance),
+                    - CosmosDBSimilarityType.L2 (Euclidean distance), and
+                    - CosmosDBSimilarityType.IP (inner product).
+            m: The max number of connections per layer (16 by default, minimum
+               value is 2, maximum value is 100). Higher m is suitable for datasets
+               with high dimensionality and/or high accuracy requirements.
+            ef_construction: the size of the dynamic candidate list for constructing
+                            the graph (64 by default, minimum value is 4, maximum
+                            value is 1000). Higher ef_construction will result in
+                            better index quality and higher accuracy, but it will
+                            also increase the time required to build the index.
+                            ef_construction has to be at least 2 * m
+        Returns:
+            An object describing the created index
+
+        """
+        # check the kind of vector search to be performed
+        # prepare the command accordingly
+        create_index_commands = {}
+        if kind == CosmosDBVectorSearchType.VECTOR_IVF:
+            create_index_commands = self._get_vector_index_ivf(
+                kind, num_lists, similarity, dimensions
+            )
+        elif kind == CosmosDBVectorSearchType.VECTOR_HNSW:
+            create_index_commands = self._get_vector_index_hnsw(
+                kind, m, ef_construction, similarity, dimensions
+            )
+
+        # retrieve the database object
+        current_database = self._collection.database
+
+        # invoke the command from the database object
+        create_index_responses: dict[str, Any] = current_database.command(
+            create_index_commands
+        )
+
+        return create_index_responses
+
+    def _get_vector_index_ivf(
+        self, kind: str, num_lists: int, similarity: str, dimensions: int
+    ) -> Dict[str, Any]:
+        command = {
+            "createIndexes": self._collection.name,
+            "indexes": [
+                {
+                    "name": self._index_name,
+                    "key": {self._embedding_key: "cosmosSearch"},
+                    "cosmosSearchOptions": {
+                        "kind": kind,
+                        "numLists": num_lists,
+                        "similarity": similarity,
+                        "dimensions": dimensions,
+                    },
+                }
+            ],
+        }
+        return command
+
+    def _get_vector_index_hnsw(
+        self, kind: str, m: int, ef_construction: int, similarity: str, dimensions: int
+    ) -> Dict[str, Any]:
+        command = {
+            "createIndexes": self._collection.name,
+            "indexes": [
+                {
+                    "name": self._index_name,
+                    "key": {self._embedding_key: "cosmosSearch"},
+                    "cosmosSearchOptions": {
+                        "kind": kind,
+                        "m": m,
+                        "efConstruction": ef_construction,
+                        "similarity": similarity,
+                        "dimensions": dimensions,
+                    },
+                }
+            ],
+        }
+        return command
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict[str, Any]]] = None,
+        **kwargs: Any,
+    ) -> List:
+        batch_size = kwargs.get("batch_size", DEFAULT_INSERT_BATCH_SIZE)
+        _metadatas: Union[List, Generator] = metadatas or ({} for _ in texts)
+        texts_batch = []
+        metadatas_batch = []
+        result_ids = []
+        for i, (text, metadata) in enumerate(zip(texts, _metadatas)):
+            texts_batch.append(text)
+            metadatas_batch.append(metadata)
+            if (i + 1) % batch_size == 0:
+                result_ids.extend(self._insert_texts(texts_batch, metadatas_batch))
+                texts_batch = []
+                metadatas_batch = []
+        if texts_batch:
+            result_ids.extend(self._insert_texts(texts_batch, metadatas_batch))
+        return result_ids
+
+    def _insert_texts(self, texts: List[str], metadatas: List[Dict[str, Any]]) -> List:
+        """Used to Load Documents into the collection
+
+        Args:
+            texts: The list of documents strings to load
+            metadatas: The list of metadata objects associated with each document
+
+        Returns:
+
+        """
+        # If the text is empty, then exit early
+        if not texts:
+            return []
+
+        # Embed and create the documents
+        embeddings = self._embedding.embed_documents(texts)
+        to_insert = [
+            {self._text_key: t, self._embedding_key: embedding, **m}
+            for t, m, embedding in zip(texts, metadatas, embeddings)
+        ]
+        # insert the documents in Cosmos DB
+        insert_result = self._collection.insert_many(to_insert)  # type: ignore
+        return insert_result.inserted_ids
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection: Optional[Collection[CosmosDBDocumentType]] = None,
+        **kwargs: Any,
+    ) -> AzureCosmosDBVectorSearch:
+        if collection is None:
+            raise ValueError("Must provide 'collection' named parameter.")
+        vectorstore = cls(collection, embedding, **kwargs)
+        vectorstore.add_texts(texts, metadatas=metadatas)
+        return vectorstore
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        if ids is None:
+            raise ValueError("No document ids provided to delete.")
+
+        for document_id in ids:
+            self.delete_document_by_id(document_id)
+        return True
+
+    def delete_document_by_id(self, document_id: Optional[str] = None) -> None:
+        """Removes a Specific Document by Id
+
+        Args:
+            document_id: The document identifier
+        """
+        try:
+            from bson.objectid import ObjectId
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import bson, please install with `pip install bson`."
+            ) from e
+        if document_id is None:
+            raise ValueError("No document id provided to delete.")
+
+        self._collection.delete_one({"_id": ObjectId(document_id)})
+
+    def _similarity_search_with_score(
+        self,
+        embeddings: List[float],
+        k: int = 4,
+        kind: CosmosDBVectorSearchType = CosmosDBVectorSearchType.VECTOR_IVF,
+        ef_search: int = 40,
+        score_threshold: float = 0.0,
+    ) -> List[Tuple[Document, float]]:
+        """Returns a list of documents with their scores
+
+        Args:
+            embeddings: The query vector
+            k: the number of documents to return
+            kind: Type of vector index to create.
+                Possible options are:
+                    - vector-ivf
+                    - vector-hnsw: available as a preview feature only,
+                                   to enable visit https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/preview-features
+            ef_search: The size of the dynamic candidate list for search
+                       (40 by default). A higher value provides better
+                       recall at the cost of speed.
+            score_threshold: (Optional[float], optional): Maximum vector distance
+                between selected documents and the query vector. Defaults to None.
+                Only vector-ivf search supports this for now.
+
+        Returns:
+            A list of documents closest to the query vector
+        """
+        pipeline: List[dict[str, Any]] = []
+        if kind == CosmosDBVectorSearchType.VECTOR_IVF:
+            pipeline = self._get_pipeline_vector_ivf(embeddings, k)
+        elif kind == CosmosDBVectorSearchType.VECTOR_HNSW:
+            pipeline = self._get_pipeline_vector_hnsw(embeddings, k, ef_search)
+
+        cursor = self._collection.aggregate(pipeline)
+
+        docs = []
+        for res in cursor:
+            score = res.pop("similarityScore")
+            if score < score_threshold:
+                continue
+            document_object_field = (
+                res.pop("document")
+                if kind == CosmosDBVectorSearchType.VECTOR_IVF
+                else res
+            )
+            text = document_object_field.pop(self._text_key)
+            docs.append(
+                (Document(page_content=text, metadata=document_object_field), score)
+            )
+        return docs
+
+    def _get_pipeline_vector_ivf(
+        self, embeddings: List[float], k: int = 4
+    ) -> List[dict[str, Any]]:
+        pipeline: List[dict[str, Any]] = [
+            {
+                "$search": {
+                    "cosmosSearch": {
+                        "vector": embeddings,
+                        "path": self._embedding_key,
+                        "k": k,
+                    },
+                    "returnStoredSource": True,
+                }
+            },
+            {
+                "$project": {
+                    "similarityScore": {"$meta": "searchScore"},
+                    "document": "$$ROOT",
+                }
+            },
+        ]
+        return pipeline
+
+    def _get_pipeline_vector_hnsw(
+        self, embeddings: List[float], k: int = 4, ef_search: int = 40
+    ) -> List[dict[str, Any]]:
+        pipeline: List[dict[str, Any]] = [
+            {
+                "$search": {
+                    "cosmosSearch": {
+                        "vector": embeddings,
+                        "path": self._embedding_key,
+                        "k": k,
+                        "efSearch": ef_search,
+                    },
+                }
+            },
+            {
+                "$project": {
+                    "similarityScore": {"$meta": "searchScore"},
+                    "document": "$$ROOT",
+                }
+            },
+        ]
+        return pipeline
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        kind: CosmosDBVectorSearchType = CosmosDBVectorSearchType.VECTOR_IVF,
+        ef_search: int = 40,
+        score_threshold: float = 0.0,
+    ) -> List[Tuple[Document, float]]:
+        embeddings = self._embedding.embed_query(query)
+        docs = self._similarity_search_with_score(
+            embeddings=embeddings,
+            k=k,
+            kind=kind,
+            ef_search=ef_search,
+            score_threshold=score_threshold,
+        )
+        return docs
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        kind: CosmosDBVectorSearchType = CosmosDBVectorSearchType.VECTOR_IVF,
+        ef_search: int = 40,
+        score_threshold: float = 0.0,
+        **kwargs: Any,
+    ) -> List[Document]:
+        docs_and_scores = self.similarity_search_with_score(
+            query,
+            k=k,
+            kind=kind,
+            ef_search=ef_search,
+            score_threshold=score_threshold,
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        kind: CosmosDBVectorSearchType = CosmosDBVectorSearchType.VECTOR_IVF,
+        ef_search: int = 40,
+        score_threshold: float = 0.0,
+        **kwargs: Any,
+    ) -> List[Document]:
+        # Retrieves the docs with similarity scores
+        # sorted by similarity scores in DESC order
+        docs = self._similarity_search_with_score(
+            embedding,
+            k=fetch_k,
+            kind=kind,
+            ef_search=ef_search,
+            score_threshold=score_threshold,
+        )
+
+        # Re-ranks the docs using MMR
+        mmr_doc_indexes = maximal_marginal_relevance(
+            np.array(embedding),
+            [doc.metadata[self._embedding_key] for doc, _ in docs],
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+        mmr_docs = [docs[i][0] for i in mmr_doc_indexes]
+        return mmr_docs
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        kind: CosmosDBVectorSearchType = CosmosDBVectorSearchType.VECTOR_IVF,
+        ef_search: int = 40,
+        score_threshold: float = 0.0,
+        **kwargs: Any,
+    ) -> List[Document]:
+        # compute the embeddings vector from the query string
+        embeddings = self._embedding.embed_query(query)
+
+        docs = self.max_marginal_relevance_search_by_vector(
+            embeddings,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            kind=kind,
+            ef_search=ef_search,
+            score_threshold=score_threshold,
+        )
+        return docs
+
+    def get_collection(self) -> Collection[CosmosDBDocumentType]:
+        return self._collection
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/azuresearch.py b/llm/Lib/site-packages/langchain_community/vectorstores/azuresearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..b07628d5a7fc704d8686b8e4739a59b4e4047cd4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/azuresearch.py
@@ -0,0 +1,737 @@
+from __future__ import annotations
+
+import base64
+import json
+import logging
+import uuid
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+import numpy as np
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.utils import get_from_env
+from langchain_core.vectorstores import VectorStore
+
+logger = logging.getLogger()
+
+if TYPE_CHECKING:
+    from azure.search.documents import SearchClient
+    from azure.search.documents.indexes.models import (
+        CorsOptions,
+        ScoringProfile,
+        SearchField,
+        SemanticConfiguration,
+        VectorSearch,
+    )
+
+# Allow overriding field names for Azure Search
+FIELDS_ID = get_from_env(
+    key="AZURESEARCH_FIELDS_ID", env_key="AZURESEARCH_FIELDS_ID", default="id"
+)
+FIELDS_CONTENT = get_from_env(
+    key="AZURESEARCH_FIELDS_CONTENT",
+    env_key="AZURESEARCH_FIELDS_CONTENT",
+    default="content",
+)
+FIELDS_CONTENT_VECTOR = get_from_env(
+    key="AZURESEARCH_FIELDS_CONTENT_VECTOR",
+    env_key="AZURESEARCH_FIELDS_CONTENT_VECTOR",
+    default="content_vector",
+)
+FIELDS_METADATA = get_from_env(
+    key="AZURESEARCH_FIELDS_TAG", env_key="AZURESEARCH_FIELDS_TAG", default="metadata"
+)
+
+MAX_UPLOAD_BATCH_SIZE = 1000
+
+
+def _get_search_client(
+    endpoint: str,
+    key: str,
+    index_name: str,
+    semantic_configuration_name: Optional[str] = None,
+    fields: Optional[List[SearchField]] = None,
+    vector_search: Optional[VectorSearch] = None,
+    semantic_configurations: Optional[
+        Union[SemanticConfiguration, List[SemanticConfiguration]]
+    ] = None,
+    scoring_profiles: Optional[List[ScoringProfile]] = None,
+    default_scoring_profile: Optional[str] = None,
+    default_fields: Optional[List[SearchField]] = None,
+    user_agent: Optional[str] = "langchain",
+    cors_options: Optional[CorsOptions] = None,
+) -> SearchClient:
+    from azure.core.credentials import AzureKeyCredential
+    from azure.core.exceptions import ResourceNotFoundError
+    from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
+    from azure.search.documents import SearchClient
+    from azure.search.documents.indexes import SearchIndexClient
+    from azure.search.documents.indexes.models import (
+        ExhaustiveKnnAlgorithmConfiguration,
+        ExhaustiveKnnParameters,
+        HnswAlgorithmConfiguration,
+        HnswParameters,
+        SearchIndex,
+        SemanticConfiguration,
+        SemanticField,
+        SemanticPrioritizedFields,
+        SemanticSearch,
+        VectorSearch,
+        VectorSearchAlgorithmKind,
+        VectorSearchAlgorithmMetric,
+        VectorSearchProfile,
+    )
+
+    default_fields = default_fields or []
+    if key is None:
+        credential = DefaultAzureCredential()
+    elif key.upper() == "INTERACTIVE":
+        credential = InteractiveBrowserCredential()
+        credential.get_token("https://search.azure.com/.default")
+    else:
+        credential = AzureKeyCredential(key)
+    index_client: SearchIndexClient = SearchIndexClient(
+        endpoint=endpoint, credential=credential, user_agent=user_agent
+    )
+    try:
+        index_client.get_index(name=index_name)
+    except ResourceNotFoundError:
+        # Fields configuration
+        if fields is not None:
+            # Check mandatory fields
+            fields_types = {f.name: f.type for f in fields}
+            mandatory_fields = {df.name: df.type for df in default_fields}
+            # Check for missing keys
+            missing_fields = {
+                key: mandatory_fields[key]
+                for key, value in set(mandatory_fields.items())
+                - set(fields_types.items())
+            }
+            if len(missing_fields) > 0:
+                # Helper for formatting field information for each missing field.
+                def fmt_err(x: str) -> str:
+                    return (
+                        f"{x} current type: '{fields_types.get(x, 'MISSING')}'. "
+                        f"It has to be '{mandatory_fields.get(x)}' or you can point "
+                        f"to a different '{mandatory_fields.get(x)}' field name by "
+                        f"using the env variable 'AZURESEARCH_FIELDS_{x.upper()}'"
+                    )
+
+                error = "\n".join([fmt_err(x) for x in missing_fields])
+                raise ValueError(
+                    f"You need to specify at least the following fields "
+                    f"{missing_fields} or provide alternative field names in the env "
+                    f"variables.\n\n{error}"
+                )
+        else:
+            fields = default_fields
+        # Vector search configuration
+        if vector_search is None:
+            vector_search = VectorSearch(
+                algorithms=[
+                    HnswAlgorithmConfiguration(
+                        name="default",
+                        kind=VectorSearchAlgorithmKind.HNSW,
+                        parameters=HnswParameters(
+                            m=4,
+                            ef_construction=400,
+                            ef_search=500,
+                            metric=VectorSearchAlgorithmMetric.COSINE,
+                        ),
+                    ),
+                    ExhaustiveKnnAlgorithmConfiguration(
+                        name="default_exhaustive_knn",
+                        kind=VectorSearchAlgorithmKind.EXHAUSTIVE_KNN,
+                        parameters=ExhaustiveKnnParameters(
+                            metric=VectorSearchAlgorithmMetric.COSINE
+                        ),
+                    ),
+                ],
+                profiles=[
+                    VectorSearchProfile(
+                        name="myHnswProfile",
+                        algorithm_configuration_name="default",
+                    ),
+                    VectorSearchProfile(
+                        name="myExhaustiveKnnProfile",
+                        algorithm_configuration_name="default_exhaustive_knn",
+                    ),
+                ],
+            )
+
+        # Create the semantic settings with the configuration
+        if semantic_configurations:
+            if not isinstance(semantic_configurations, list):
+                semantic_configurations = [semantic_configurations]
+            semantic_search = SemanticSearch(
+                configurations=semantic_configurations,
+                default_configuration_name=semantic_configuration_name,
+            )
+        elif semantic_configuration_name:
+            # use default semantic configuration
+            semantic_configuration = SemanticConfiguration(
+                name=semantic_configuration_name,
+                prioritized_fields=SemanticPrioritizedFields(
+                    content_fields=[SemanticField(field_name=FIELDS_CONTENT)],
+                ),
+            )
+            semantic_search = SemanticSearch(configurations=[semantic_configuration])
+        else:
+            # don't use semantic search
+            semantic_search = None
+
+        # Create the search index with the semantic settings and vector search
+        index = SearchIndex(
+            name=index_name,
+            fields=fields,
+            vector_search=vector_search,
+            semantic_search=semantic_search,
+            scoring_profiles=scoring_profiles,
+            default_scoring_profile=default_scoring_profile,
+            cors_options=cors_options,
+        )
+        index_client.create_index(index)
+    # Create the search client
+    return SearchClient(
+        endpoint=endpoint,
+        index_name=index_name,
+        credential=credential,
+        user_agent=user_agent,
+    )
+
+
+class AzureSearch(VectorStore):
+    """`Azure Cognitive Search` vector store."""
+
+    def __init__(
+        self,
+        azure_search_endpoint: str,
+        azure_search_key: str,
+        index_name: str,
+        embedding_function: Union[Callable, Embeddings],
+        search_type: str = "hybrid",
+        semantic_configuration_name: Optional[str] = None,
+        fields: Optional[List[SearchField]] = None,
+        vector_search: Optional[VectorSearch] = None,
+        semantic_configurations: Optional[
+            Union[SemanticConfiguration, List[SemanticConfiguration]]
+        ] = None,
+        scoring_profiles: Optional[List[ScoringProfile]] = None,
+        default_scoring_profile: Optional[str] = None,
+        cors_options: Optional[CorsOptions] = None,
+        **kwargs: Any,
+    ):
+        from azure.search.documents.indexes.models import (
+            SearchableField,
+            SearchField,
+            SearchFieldDataType,
+            SimpleField,
+        )
+
+        """Initialize with necessary components."""
+        # Initialize base class
+        self.embedding_function = embedding_function
+
+        if isinstance(self.embedding_function, Embeddings):
+            self.embed_query = self.embedding_function.embed_query
+        else:
+            self.embed_query = self.embedding_function
+
+        default_fields = [
+            SimpleField(
+                name=FIELDS_ID,
+                type=SearchFieldDataType.String,
+                key=True,
+                filterable=True,
+            ),
+            SearchableField(
+                name=FIELDS_CONTENT,
+                type=SearchFieldDataType.String,
+            ),
+            SearchField(
+                name=FIELDS_CONTENT_VECTOR,
+                type=SearchFieldDataType.Collection(SearchFieldDataType.Single),
+                searchable=True,
+                vector_search_dimensions=len(self.embed_query("Text")),
+                vector_search_profile_name="myHnswProfile",
+            ),
+            SearchableField(
+                name=FIELDS_METADATA,
+                type=SearchFieldDataType.String,
+            ),
+        ]
+        user_agent = "langchain"
+        if "user_agent" in kwargs and kwargs["user_agent"]:
+            user_agent += " " + kwargs["user_agent"]
+        self.client = _get_search_client(
+            azure_search_endpoint,
+            azure_search_key,
+            index_name,
+            semantic_configuration_name=semantic_configuration_name,
+            fields=fields,
+            vector_search=vector_search,
+            semantic_configurations=semantic_configurations,
+            scoring_profiles=scoring_profiles,
+            default_scoring_profile=default_scoring_profile,
+            default_fields=default_fields,
+            user_agent=user_agent,
+            cors_options=cors_options,
+        )
+        self.search_type = search_type
+        self.semantic_configuration_name = semantic_configuration_name
+        self.fields = fields if fields else default_fields
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        # TODO: Support embedding object directly
+        return None
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add texts data to an existing index."""
+        keys = kwargs.get("keys")
+        ids = []
+
+        # batching support if embedding function is an Embeddings object
+        if isinstance(self.embedding_function, Embeddings):
+            try:
+                embeddings = self.embedding_function.embed_documents(texts)  # type: ignore[arg-type]
+            except NotImplementedError:
+                embeddings = [self.embedding_function.embed_query(x) for x in texts]
+        else:
+            embeddings = [self.embedding_function(x) for x in texts]
+
+        if len(embeddings) == 0:
+            logger.debug("Nothing to insert, skipping.")
+            return []
+
+        # Write data to index
+        data = []
+        for i, text in enumerate(texts):
+            # Use provided key otherwise use default key
+            key = keys[i] if keys else str(uuid.uuid4())
+            # Encoding key for Azure Search valid characters
+            key = base64.urlsafe_b64encode(bytes(key, "utf-8")).decode("ascii")
+            metadata = metadatas[i] if metadatas else {}
+            # Add data to index
+            # Additional metadata to fields mapping
+            doc = {
+                "@search.action": "upload",
+                FIELDS_ID: key,
+                FIELDS_CONTENT: text,
+                FIELDS_CONTENT_VECTOR: np.array(
+                    embeddings[i], dtype=np.float32
+                ).tolist(),
+                FIELDS_METADATA: json.dumps(metadata),
+            }
+            if metadata:
+                additional_fields = {
+                    k: v
+                    for k, v in metadata.items()
+                    if k in [x.name for x in self.fields]
+                }
+                doc.update(additional_fields)
+            data.append(doc)
+            ids.append(key)
+            # Upload data in batches
+            if len(data) == MAX_UPLOAD_BATCH_SIZE:
+                response = self.client.upload_documents(documents=data)
+                # Check if all documents were successfully uploaded
+                if not all([r.succeeded for r in response]):
+                    raise Exception(response)
+                # Reset data
+                data = []
+
+        # Considering case where data is an exact multiple of batch-size entries
+        if len(data) == 0:
+            return ids
+
+        # Upload data to index
+        response = self.client.upload_documents(documents=data)
+        # Check if all documents were successfully uploaded
+        if all([r.succeeded for r in response]):
+            return ids
+        else:
+            raise Exception(response)
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        search_type = kwargs.get("search_type", self.search_type)
+        if search_type == "similarity":
+            docs = self.vector_search(query, k=k, **kwargs)
+        elif search_type == "hybrid":
+            docs = self.hybrid_search(query, k=k, **kwargs)
+        elif search_type == "semantic_hybrid":
+            docs = self.semantic_hybrid_search(query, k=k, **kwargs)
+        else:
+            raise ValueError(f"search_type of {search_type} not allowed.")
+        return docs
+
+    def similarity_search_with_relevance_scores(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        score_threshold = kwargs.pop("score_threshold", None)
+        result = self.vector_search_with_score(query, k=k, **kwargs)
+        return (
+            result
+            if score_threshold is None
+            else [r for r in result if r[1] >= score_threshold]
+        )
+
+    def vector_search(self, query: str, k: int = 4, **kwargs: Any) -> List[Document]:
+        """
+        Returns the most similar indexed documents to the query text.
+
+        Args:
+            query (str): The query text for which to find similar documents.
+            k (int): The number of documents to return. Default is 4.
+
+        Returns:
+            List[Document]: A list of documents that are most similar to the query text.
+        """
+        docs_and_scores = self.vector_search_with_score(
+            query, k=k, filters=kwargs.get("filters", None)
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def vector_search_with_score(
+        self, query: str, k: int = 4, filters: Optional[str] = None
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+
+        from azure.search.documents.models import VectorizedQuery
+
+        results = self.client.search(
+            search_text="",
+            vector_queries=[
+                VectorizedQuery(
+                    vector=np.array(self.embed_query(query), dtype=np.float32).tolist(),
+                    k_nearest_neighbors=k,
+                    fields=FIELDS_CONTENT_VECTOR,
+                )
+            ],
+            filter=filters,
+            top=k,
+        )
+        # Convert results to Document objects
+        docs = [
+            (
+                Document(
+                    page_content=result.pop(FIELDS_CONTENT),
+                    metadata=json.loads(result[FIELDS_METADATA])
+                    if FIELDS_METADATA in result
+                    else {
+                        k: v for k, v in result.items() if k != FIELDS_CONTENT_VECTOR
+                    },
+                ),
+                float(result["@search.score"]),
+            )
+            for result in results
+        ]
+        return docs
+
+    def hybrid_search(self, query: str, k: int = 4, **kwargs: Any) -> List[Document]:
+        """
+        Returns the most similar indexed documents to the query text.
+
+        Args:
+            query (str): The query text for which to find similar documents.
+            k (int): The number of documents to return. Default is 4.
+
+        Returns:
+            List[Document]: A list of documents that are most similar to the query text.
+        """
+        docs_and_scores = self.hybrid_search_with_score(
+            query, k=k, filters=kwargs.get("filters", None)
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def hybrid_search_with_score(
+        self, query: str, k: int = 4, filters: Optional[str] = None
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query with an hybrid query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        from azure.search.documents.models import VectorizedQuery
+
+        results = self.client.search(
+            search_text=query,
+            vector_queries=[
+                VectorizedQuery(
+                    vector=np.array(self.embed_query(query), dtype=np.float32).tolist(),
+                    k_nearest_neighbors=k,
+                    fields=FIELDS_CONTENT_VECTOR,
+                )
+            ],
+            filter=filters,
+            top=k,
+        )
+        # Convert results to Document objects
+        docs = [
+            (
+                Document(
+                    page_content=result.pop(FIELDS_CONTENT),
+                    metadata=json.loads(result[FIELDS_METADATA])
+                    if FIELDS_METADATA in result
+                    else {
+                        k: v for k, v in result.items() if k != FIELDS_CONTENT_VECTOR
+                    },
+                ),
+                float(result["@search.score"]),
+            )
+            for result in results
+        ]
+        return docs
+
+    def semantic_hybrid_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """
+        Returns the most similar indexed documents to the query text.
+
+        Args:
+            query (str): The query text for which to find similar documents.
+            k (int): The number of documents to return. Default is 4.
+
+        Returns:
+            List[Document]: A list of documents that are most similar to the query text.
+        """
+        docs_and_scores = self.semantic_hybrid_search_with_score_and_rerank(
+            query, k=k, filters=kwargs.get("filters", None)
+        )
+        return [doc for doc, _, _ in docs_and_scores]
+
+    def semantic_hybrid_search_with_score(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """
+        Returns the most similar indexed documents to the query text.
+
+        Args:
+            query (str): The query text for which to find similar documents.
+            k (int): The number of documents to return. Default is 4.
+
+        Returns:
+            List[Document]: A list of documents that are most similar to the query text.
+        """
+        docs_and_scores = self.semantic_hybrid_search_with_score_and_rerank(
+            query, k=k, filters=kwargs.get("filters", None)
+        )
+        return [(doc, score) for doc, score, _ in docs_and_scores]
+
+    def semantic_hybrid_search_with_score_and_rerank(
+        self, query: str, k: int = 4, filters: Optional[str] = None
+    ) -> List[Tuple[Document, float, float]]:
+        """Return docs most similar to query with an hybrid query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        from azure.search.documents.models import VectorizedQuery
+
+        results = self.client.search(
+            search_text=query,
+            vector_queries=[
+                VectorizedQuery(
+                    vector=np.array(self.embed_query(query), dtype=np.float32).tolist(),
+                    k_nearest_neighbors=k,
+                    fields=FIELDS_CONTENT_VECTOR,
+                )
+            ],
+            filter=filters,
+            query_type="semantic",
+            semantic_configuration_name=self.semantic_configuration_name,
+            query_caption="extractive",
+            query_answer="extractive",
+            top=k,
+        )
+        # Get Semantic Answers
+        semantic_answers = results.get_answers() or []
+        semantic_answers_dict: Dict = {}
+        for semantic_answer in semantic_answers:
+            semantic_answers_dict[semantic_answer.key] = {
+                "text": semantic_answer.text,
+                "highlights": semantic_answer.highlights,
+            }
+        # Convert results to Document objects
+        docs = [
+            (
+                Document(
+                    page_content=result.pop(FIELDS_CONTENT),
+                    metadata={
+                        **(
+                            json.loads(result[FIELDS_METADATA])
+                            if FIELDS_METADATA in result
+                            else {
+                                k: v
+                                for k, v in result.items()
+                                if k != FIELDS_CONTENT_VECTOR
+                            }
+                        ),
+                        **{
+                            "captions": {
+                                "text": result.get("@search.captions", [{}])[0].text,
+                                "highlights": result.get("@search.captions", [{}])[
+                                    0
+                                ].highlights,
+                            }
+                            if result.get("@search.captions")
+                            else {},
+                            "answers": semantic_answers_dict.get(
+                                result.get(FIELDS_ID, ""),
+                                "",
+                            ),
+                        },
+                    },
+                ),
+                float(result["@search.score"]),
+                float(result["@search.reranker_score"]),
+            )
+            for result in results
+        ]
+        return docs
+
+    @classmethod
+    def from_texts(
+        cls: Type[AzureSearch],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        azure_search_endpoint: str = "",
+        azure_search_key: str = "",
+        index_name: str = "langchain-index",
+        fields: Optional[List[SearchField]] = None,
+        **kwargs: Any,
+    ) -> AzureSearch:
+        # Creating a new Azure Search instance
+        azure_search = cls(
+            azure_search_endpoint,
+            azure_search_key,
+            index_name,
+            embedding,
+            fields=fields,
+        )
+        azure_search.add_texts(texts, metadatas, **kwargs)
+        return azure_search
+
+    def as_retriever(self, **kwargs: Any) -> AzureSearchVectorStoreRetriever:  # type: ignore
+        """Return AzureSearchVectorStoreRetriever initialized from this VectorStore.
+
+        Args:
+            search_type (Optional[str]): Defines the type of search that
+                the Retriever should perform.
+                Can be "similarity" (default), "hybrid", or
+                    "semantic_hybrid".
+            search_kwargs (Optional[Dict]): Keyword arguments to pass to the
+                search function. Can include things like:
+                    k: Amount of documents to return (Default: 4)
+                    score_threshold: Minimum relevance threshold
+                        for similarity_score_threshold
+                    fetch_k: Amount of documents to pass to MMR algorithm (Default: 20)
+                    lambda_mult: Diversity of results returned by MMR;
+                        1 for minimum diversity and 0 for maximum. (Default: 0.5)
+                    filter: Filter by document metadata
+
+        Returns:
+            AzureSearchVectorStoreRetriever: Retriever class for VectorStore.
+        """
+        tags = kwargs.pop("tags", None) or []
+        tags.extend(self._get_retriever_tags())
+        return AzureSearchVectorStoreRetriever(vectorstore=self, **kwargs, tags=tags)
+
+
+class AzureSearchVectorStoreRetriever(BaseRetriever):
+    """Retriever that uses `Azure Cognitive Search`."""
+
+    vectorstore: AzureSearch
+    """Azure Search instance used to find similar documents."""
+    search_type: str = "hybrid"
+    """Type of search to perform. Options are "similarity", "hybrid",
+    "semantic_hybrid"."""
+    k: int = 4
+    """Number of documents to return."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @root_validator()
+    def validate_search_type(cls, values: Dict) -> Dict:
+        """Validate search type."""
+        if "search_type" in values:
+            search_type = values["search_type"]
+            if search_type not in (
+                allowed_search_types := ("similarity", "hybrid", "semantic_hybrid")
+            ):
+                raise ValueError(
+                    f"search_type of {search_type} not allowed. Valid values are: "
+                    f"{allowed_search_types}"
+                )
+        return values
+
+    def _get_relevant_documents(
+        self,
+        query: str,
+        run_manager: CallbackManagerForRetrieverRun,
+        **kwargs: Any,
+    ) -> List[Document]:
+        if self.search_type == "similarity":
+            docs = self.vectorstore.vector_search(query, k=self.k, **kwargs)
+        elif self.search_type == "hybrid":
+            docs = self.vectorstore.hybrid_search(query, k=self.k, **kwargs)
+        elif self.search_type == "semantic_hybrid":
+            docs = self.vectorstore.semantic_hybrid_search(query, k=self.k, **kwargs)
+        else:
+            raise ValueError(f"search_type of {self.search_type} not allowed.")
+        return docs
+
+    async def _aget_relevant_documents(
+        self,
+        query: str,
+        *,
+        run_manager: AsyncCallbackManagerForRetrieverRun,
+    ) -> List[Document]:
+        raise NotImplementedError(
+            "AzureSearchVectorStoreRetriever does not support async"
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/bageldb.py b/llm/Lib/site-packages/langchain_community/vectorstores/bageldb.py
new file mode 100644
index 0000000000000000000000000000000000000000..d6c98fbea7d33c28aa50fdc7f5ec1d71c3f9e812
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/bageldb.py
@@ -0,0 +1,437 @@
+from __future__ import annotations
+
+import uuid
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+)
+
+if TYPE_CHECKING:
+    import bagel
+    import bagel.config
+    from bagel.api.types import ID, OneOrMany, Where, WhereDocument
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import xor_args
+from langchain_core.vectorstores import VectorStore
+
+DEFAULT_K = 5
+
+
+def _results_to_docs(results: Any) -> List[Document]:
+    return [doc for doc, _ in _results_to_docs_and_scores(results)]
+
+
+def _results_to_docs_and_scores(results: Any) -> List[Tuple[Document, float]]:
+    return [
+        (Document(page_content=result[0], metadata=result[1] or {}), result[2])
+        for result in zip(
+            results["documents"][0],
+            results["metadatas"][0],
+            results["distances"][0],
+        )
+    ]
+
+
+class Bagel(VectorStore):
+    """``BagelDB.ai`` vector store.
+
+    To use, you should have the ``betabageldb`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+                from langchain_community.vectorstores import Bagel
+                vectorstore = Bagel(cluster_name="langchain_store")
+    """
+
+    _LANGCHAIN_DEFAULT_CLUSTER_NAME = "langchain"
+
+    def __init__(
+        self,
+        cluster_name: str = _LANGCHAIN_DEFAULT_CLUSTER_NAME,
+        client_settings: Optional[bagel.config.Settings] = None,
+        embedding_function: Optional[Embeddings] = None,
+        cluster_metadata: Optional[Dict] = None,
+        client: Optional[bagel.Client] = None,
+        relevance_score_fn: Optional[Callable[[float], float]] = None,
+    ) -> None:
+        """Initialize with bagel client"""
+        try:
+            import bagel
+            import bagel.config
+        except ImportError:
+            raise ImportError("Please install bagel `pip install betabageldb`.")
+        if client is not None:
+            self._client_settings = client_settings
+            self._client = client
+        else:
+            if client_settings:
+                _client_settings = client_settings
+            else:
+                _client_settings = bagel.config.Settings(
+                    bagel_api_impl="rest",
+                    bagel_server_host="api.bageldb.ai",
+                )
+            self._client_settings = _client_settings
+            self._client = bagel.Client(_client_settings)
+
+        self._cluster = self._client.get_or_create_cluster(
+            name=cluster_name,
+            metadata=cluster_metadata,
+        )
+        self.override_relevance_score_fn = relevance_score_fn
+        self._embedding_function = embedding_function
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self._embedding_function
+
+    @xor_args(("query_texts", "query_embeddings"))
+    def __query_cluster(
+        self,
+        query_texts: Optional[List[str]] = None,
+        query_embeddings: Optional[List[List[float]]] = None,
+        n_results: int = 4,
+        where: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Query the BagelDB cluster based on the provided parameters."""
+        try:
+            import bagel  # noqa: F401
+        except ImportError:
+            raise ImportError("Please install bagel `pip install betabageldb`.")
+
+        if self._embedding_function and query_embeddings is None and query_texts:
+            texts = list(query_texts)
+            query_embeddings = self._embedding_function.embed_documents(texts)
+            query_texts = None
+
+        return self._cluster.find(
+            query_texts=query_texts,
+            query_embeddings=query_embeddings,
+            n_results=n_results,
+            where=where,
+            **kwargs,
+        )
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        embeddings: Optional[List[List[float]]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """
+        Add texts along with their corresponding embeddings and optional
+        metadata to the BagelDB cluster.
+
+        Args:
+            texts (Iterable[str]): Texts to be added.
+            embeddings (Optional[List[float]]): List of embeddingvectors
+            metadatas (Optional[List[dict]]): Optional list of metadatas.
+            ids (Optional[List[str]]): List of unique ID for the texts.
+
+        Returns:
+            List[str]: List of unique ID representing the added texts.
+        """
+        # creating unique ids if None
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        texts = list(texts)
+        if self._embedding_function and embeddings is None and texts:
+            embeddings = self._embedding_function.embed_documents(texts)
+        if metadatas:
+            length_diff = len(texts) - len(metadatas)
+            if length_diff:
+                metadatas = metadatas + [{}] * length_diff
+            empty_ids = []
+            non_empty_ids = []
+            for idx, metadata in enumerate(metadatas):
+                if metadata:
+                    non_empty_ids.append(idx)
+                else:
+                    empty_ids.append(idx)
+            if non_empty_ids:
+                metadatas = [metadatas[idx] for idx in non_empty_ids]
+                texts_with_metadatas = [texts[idx] for idx in non_empty_ids]
+                embeddings_with_metadatas = (
+                    [embeddings[idx] for idx in non_empty_ids] if embeddings else None
+                )
+                ids_with_metadata = [ids[idx] for idx in non_empty_ids]
+                self._cluster.upsert(
+                    embeddings=embeddings_with_metadatas,
+                    metadatas=metadatas,
+                    documents=texts_with_metadatas,
+                    ids=ids_with_metadata,
+                )
+            if empty_ids:
+                texts_without_metadatas = [texts[j] for j in empty_ids]
+                embeddings_without_metadatas = (
+                    [embeddings[j] for j in empty_ids] if embeddings else None
+                )
+                ids_without_metadatas = [ids[j] for j in empty_ids]
+                self._cluster.upsert(
+                    embeddings=embeddings_without_metadatas,
+                    documents=texts_without_metadatas,
+                    ids=ids_without_metadatas,
+                )
+        else:
+            metadatas = [{}] * len(texts)
+            self._cluster.upsert(
+                embeddings=embeddings,
+                documents=texts,
+                metadatas=metadatas,
+                ids=ids,
+            )
+        return ids
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = DEFAULT_K,
+        where: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """
+        Run a similarity search with BagelDB.
+
+        Args:
+            query (str): The query text to search for similar documents/texts.
+            k (int): The number of results to return.
+            where (Optional[Dict[str, str]]): Metadata filters to narrow down.
+
+        Returns:
+            List[Document]: List of documents objects representing
+            the documents most similar to the query text.
+        """
+        docs_and_scores = self.similarity_search_with_score(query, k, where=where)
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = DEFAULT_K,
+        where: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """
+        Run a similarity search with BagelDB and return documents with their
+        corresponding similarity scores.
+
+        Args:
+            query (str): The query text to search for similar documents.
+            k (int): The number of results to return.
+            where (Optional[Dict[str, str]]): Filter using metadata.
+
+        Returns:
+            List[Tuple[Document, float]]: List of tuples, each containing a
+            Document object representing a similar document and its
+            corresponding similarity score.
+
+        """
+        results = self.__query_cluster(query_texts=[query], n_results=k, where=where)
+        return _results_to_docs_and_scores(results)
+
+    @classmethod
+    def from_texts(
+        cls: Type[Bagel],
+        texts: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        cluster_name: str = _LANGCHAIN_DEFAULT_CLUSTER_NAME,
+        client_settings: Optional[bagel.config.Settings] = None,
+        cluster_metadata: Optional[Dict] = None,
+        client: Optional[bagel.Client] = None,
+        text_embeddings: Optional[List[List[float]]] = None,
+        **kwargs: Any,
+    ) -> Bagel:
+        """
+        Create and initialize a Bagel instance from list of texts.
+
+        Args:
+            texts (List[str]): List of text content to be added.
+            cluster_name (str): The name of the BagelDB cluster.
+            client_settings (Optional[bagel.config.Settings]): Client settings.
+            cluster_metadata (Optional[Dict]): Metadata of the cluster.
+            embeddings (Optional[Embeddings]): List of embedding.
+            metadatas (Optional[List[dict]]): List of metadata.
+            ids (Optional[List[str]]): List of unique ID. Defaults to None.
+            client (Optional[bagel.Client]): Bagel client instance.
+
+        Returns:
+            Bagel: Bagel vectorstore.
+        """
+        bagel_cluster = cls(
+            cluster_name=cluster_name,
+            embedding_function=embedding,
+            client_settings=client_settings,
+            client=client,
+            cluster_metadata=cluster_metadata,
+            **kwargs,
+        )
+        _ = bagel_cluster.add_texts(
+            texts=texts, embeddings=text_embeddings, metadatas=metadatas, ids=ids
+        )
+        return bagel_cluster
+
+    def delete_cluster(self) -> None:
+        """Delete the cluster."""
+        self._client.delete_cluster(self._cluster.name)
+
+    def similarity_search_by_vector_with_relevance_scores(
+        self,
+        query_embeddings: List[float],
+        k: int = DEFAULT_K,
+        where: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """
+        Return docs most similar to embedding vector and similarity score.
+        """
+        results = self.__query_cluster(
+            query_embeddings=query_embeddings, n_results=k, where=where
+        )
+        return _results_to_docs_and_scores(results)
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_K,
+        where: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector."""
+        results = self.__query_cluster(
+            query_embeddings=embedding, n_results=k, where=where
+        )
+        return _results_to_docs(results)
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        Select and return the appropriate relevance score function based
+        on the distance metric used in the BagelDB cluster.
+        """
+        if self.override_relevance_score_fn:
+            return self.override_relevance_score_fn
+
+        distance = "l2"
+        distance_key = "hnsw:space"
+        metadata = self._cluster.metadata
+
+        if metadata and distance_key in metadata:
+            distance = metadata[distance_key]
+
+        if distance == "cosine":
+            return self._cosine_relevance_score_fn
+        elif distance == "l2":
+            return self._euclidean_relevance_score_fn
+        elif distance == "ip":
+            return self._max_inner_product_relevance_score_fn
+        else:
+            raise ValueError(
+                "No supported normalization function for distance"
+                f" metric of type: {distance}. Consider providing"
+                " relevance_score_fn to Bagel constructor."
+            )
+
+    @classmethod
+    def from_documents(
+        cls: Type[Bagel],
+        documents: List[Document],
+        embedding: Optional[Embeddings] = None,
+        ids: Optional[List[str]] = None,
+        cluster_name: str = _LANGCHAIN_DEFAULT_CLUSTER_NAME,
+        client_settings: Optional[bagel.config.Settings] = None,
+        client: Optional[bagel.Client] = None,
+        cluster_metadata: Optional[Dict] = None,
+        **kwargs: Any,
+    ) -> Bagel:
+        """
+        Create a Bagel vectorstore from a list of documents.
+
+        Args:
+            documents (List[Document]): List of Document objects to add to the
+                                        Bagel vectorstore.
+            embedding (Optional[List[float]]): List of embedding.
+            ids (Optional[List[str]]): List of IDs. Defaults to None.
+            cluster_name (str): The name of the BagelDB cluster.
+            client_settings (Optional[bagel.config.Settings]): Client settings.
+            client (Optional[bagel.Client]): Bagel client instance.
+            cluster_metadata (Optional[Dict]): Metadata associated with the
+                                               Bagel cluster. Defaults to None.
+
+        Returns:
+            Bagel: Bagel vectorstore.
+        """
+        texts = [doc.page_content for doc in documents]
+        metadatas = [doc.metadata for doc in documents]
+        return cls.from_texts(
+            texts=texts,
+            embedding=embedding,
+            metadatas=metadatas,
+            ids=ids,
+            cluster_name=cluster_name,
+            client_settings=client_settings,
+            client=client,
+            cluster_metadata=cluster_metadata,
+            **kwargs,
+        )
+
+    def update_document(self, document_id: str, document: Document) -> None:
+        """Update a document in the cluster.
+
+        Args:
+            document_id (str): ID of the document to update.
+            document (Document): Document to update.
+        """
+        text = document.page_content
+        metadata = document.metadata
+        self._cluster.update(
+            ids=[document_id],
+            documents=[text],
+            metadatas=[metadata],
+        )
+
+    def get(
+        self,
+        ids: Optional[OneOrMany[ID]] = None,
+        where: Optional[Where] = None,
+        limit: Optional[int] = None,
+        offset: Optional[int] = None,
+        where_document: Optional[WhereDocument] = None,
+        include: Optional[List[str]] = None,
+    ) -> Dict[str, Any]:
+        """Gets the collection."""
+        kwargs = {
+            "ids": ids,
+            "where": where,
+            "limit": limit,
+            "offset": offset,
+            "where_document": where_document,
+        }
+
+        if include is not None:
+            kwargs["include"] = include
+
+        return self._cluster.get(**kwargs)
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> None:
+        """
+        Delete by IDs.
+
+        Args:
+            ids: List of ids to delete.
+        """
+        self._cluster.delete(ids=ids)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/baiducloud_vector_search.py b/llm/Lib/site-packages/langchain_community/vectorstores/baiducloud_vector_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..71c9694e09037b4c935c8e580497a0845c7cffb6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/baiducloud_vector_search.py
@@ -0,0 +1,491 @@
+import logging
+import uuid
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Union,
+)
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    from elasticsearch import Elasticsearch
+
+logger = logging.getLogger(__name__)
+
+
+class BESVectorStore(VectorStore):
+    """`Baidu Elasticsearch` vector store.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import BESVectorStore
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+            embeddings = OpenAIEmbeddings()
+            vectorstore = BESVectorStore(
+                embedding=OpenAIEmbeddings(),
+                index_name="langchain-demo",
+                bes_url="http://localhost:9200"
+            )
+
+    Args:
+        index_name: Name of the Elasticsearch index to create.
+        bes_url: URL of the Baidu Elasticsearch instance to connect to.
+        user: Username to use when connecting to Elasticsearch.
+        password: Password to use when connecting to Elasticsearch.
+
+        More information can be obtained from:
+        https://cloud.baidu.com/doc/BES/s/8llyn0hh4
+
+    """
+
+    def __init__(
+        self,
+        index_name: str,
+        bes_url: str,
+        user: Optional[str] = None,
+        password: Optional[str] = None,
+        embedding: Optional[Embeddings] = None,
+        **kwargs: Optional[dict],
+    ) -> None:
+        self.embedding = embedding
+        self.index_name = index_name
+        self.query_field = kwargs.get("query_field", "text")
+        self.vector_query_field = kwargs.get("vector_query_field", "vector")
+        self.space_type = kwargs.get("space_type", "cosine")
+        self.index_type = kwargs.get("index_type", "linear")
+        self.index_params = kwargs.get("index_params") or {}
+
+        if bes_url is not None:
+            self.client = BESVectorStore.bes_client(
+                bes_url=bes_url, username=user, password=password
+            )
+        else:
+            raise ValueError("""Please specified a bes connection url.""")
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self.embedding
+
+    @staticmethod
+    def bes_client(
+        *,
+        bes_url: Optional[str] = None,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+    ) -> "Elasticsearch":
+        try:
+            import elasticsearch
+        except ImportError:
+            raise ImportError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+
+        connection_params: Dict[str, Any] = {}
+
+        connection_params["hosts"] = [bes_url]
+        if username and password:
+            connection_params["basic_auth"] = (username, password)
+
+        es_client = elasticsearch.Elasticsearch(**connection_params)
+        try:
+            es_client.info()
+        except Exception as e:
+            logger.error(f"Error connecting to Elasticsearch: {e}")
+            raise e
+        return es_client
+
+    def _create_index_if_not_exists(self, dims_length: Optional[int] = None) -> None:
+        """Create the index if it doesn't already exist.
+
+        Args:
+            dims_length: Length of the embedding vectors.
+        """
+
+        if self.client.indices.exists(index=self.index_name):
+            logger.info(f"Index {self.index_name} already exists. Skipping creation.")
+
+        else:
+            if dims_length is None:
+                raise ValueError(
+                    "Cannot create index without specifying dims_length "
+                    + "when the index doesn't already exist. "
+                )
+
+            indexMapping = self._index_mapping(dims_length=dims_length)
+
+            logger.debug(
+                f"Creating index {self.index_name} with mappings {indexMapping}"
+            )
+
+            self.client.indices.create(
+                index=self.index_name,
+                body={
+                    "settings": {"index": {"knn": True}},
+                    "mappings": {"properties": indexMapping},
+                },
+            )
+
+    def _index_mapping(self, dims_length: Union[int, None]) -> Dict:
+        """
+        Executes when the index is created.
+
+        Args:
+            dims_length: Numeric length of the embedding vectors,
+                        or None if not using vector-based query.
+            index_params: The extra pamameters for creating index.
+
+        Returns:
+            Dict: The Elasticsearch settings and mappings for the strategy.
+        """
+        if "linear" == self.index_type:
+            return {
+                self.vector_query_field: {
+                    "type": "bpack_vector",
+                    "dims": dims_length,
+                    "build_index": self.index_params.get("build_index", False),
+                }
+            }
+
+        elif "hnsw" == self.index_type:
+            return {
+                self.vector_query_field: {
+                    "type": "bpack_vector",
+                    "dims": dims_length,
+                    "index_type": "hnsw",
+                    "space_type": self.space_type,
+                    "parameters": {
+                        "ef_construction": self.index_params.get(
+                            "hnsw_ef_construction", 200
+                        ),
+                        "m": self.index_params.get("hnsw_m", 4),
+                    },
+                }
+            }
+        else:
+            return {
+                self.vector_query_field: {
+                    "type": "bpack_vector",
+                    "model_id": self.index_params.get("model_id", ""),
+                }
+            }
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Optional[bool]:
+        """Delete documents from the index.
+
+        Args:
+            ids: List of ids of documents to delete
+        """
+        try:
+            from elasticsearch.helpers import BulkIndexError, bulk
+        except ImportError:
+            raise ImportError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+
+        body = []
+
+        if ids is None:
+            raise ValueError("ids must be provided.")
+
+        for _id in ids:
+            body.append({"_op_type": "delete", "_index": self.index_name, "_id": _id})
+
+        if len(body) > 0:
+            try:
+                bulk(
+                    self.client,
+                    body,
+                    refresh=kwargs.get("refresh_indices", True),
+                    ignore_status=404,
+                )
+                logger.debug(f"Deleted {len(body)} texts from index")
+                return True
+            except BulkIndexError as e:
+                logger.error(f"Error deleting texts: {e}")
+                raise e
+        else:
+            logger.info("No documents to delete")
+            return False
+
+    def _query_body(
+        self,
+        query_vector: Union[List[float], None],
+        filter: Optional[dict] = None,
+        search_params: Dict = {},
+    ) -> Dict:
+        query_vector_body = {"vector": query_vector, "k": search_params.get("k", 2)}
+
+        if filter is not None and len(filter) != 0:
+            query_vector_body["filter"] = filter
+
+        if "linear" == self.index_type:
+            query_vector_body["linear"] = True
+        else:
+            query_vector_body["ef"] = search_params.get("ef", 10)
+
+        return {
+            "size": search_params.get("size", 4),
+            "query": {"knn": {self.vector_query_field: query_vector_body}},
+        }
+
+    def _search(
+        self,
+        query: Optional[str] = None,
+        query_vector: Union[List[float], None] = None,
+        filter: Optional[dict] = None,
+        custom_query: Optional[Callable[[Dict, Union[str, None]], Dict]] = None,
+        search_params: Dict = {},
+    ) -> List[Tuple[Document, float]]:
+        """Return searched documents result from BES
+
+        Args:
+            query: Text to look up documents similar to.
+            query_vector: Embedding to look up documents similar to.
+            filter: Array of Baidu ElasticSearch filter clauses to apply to the query.
+            custom_query: Function to modify the query body before it is sent to BES.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+
+        if self.embedding and query is not None:
+            query_vector = self.embedding.embed_query(query)
+
+        query_body = self._query_body(
+            query_vector=query_vector, filter=filter, search_params=search_params
+        )
+
+        if custom_query is not None:
+            query_body = custom_query(query_body, query)
+            logger.debug(f"Calling custom_query, Query body now: {query_body}")
+
+        logger.debug(f"Query body: {query_body}")
+
+        # Perform the kNN search on the BES index and return the results.
+        response = self.client.search(index=self.index_name, body=query_body)
+        logger.debug(f"response={response}")
+
+        hits = [hit for hit in response["hits"]["hits"]]
+        docs_and_scores = [
+            (
+                Document(
+                    page_content=hit["_source"][self.query_field],
+                    metadata=hit["_source"]["metadata"],
+                ),
+                hit["_score"],
+            )
+            for hit in hits
+        ]
+
+        return docs_and_scores
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return documents most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Array of Elasticsearch filter clauses to apply to the query.
+
+        Returns:
+            List of Documents most similar to the query,
+            in descending order of similarity.
+        """
+
+        results = self.similarity_search_with_score(
+            query=query, k=k, filter=filter, **kwargs
+        )
+        return [doc for doc, _ in results]
+
+    def similarity_search_with_score(
+        self, query: str, k: int, filter: Optional[dict] = None, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Return documents most similar to query, along with scores.
+
+        Args:
+            query: Text to look up documents similar to.
+            size: Number of Documents to return. Defaults to 4.
+            filter: Array of Elasticsearch filter clauses to apply to the query.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        search_params = kwargs.get("search_params") or {}
+
+        if len(search_params) == 0 or search_params.get("size") is None:
+            search_params["size"] = k
+
+        return self._search(query=query, filter=filter, **kwargs)
+
+    @classmethod
+    def from_documents(
+        cls,
+        documents: List[Document],
+        embedding: Optional[Embeddings] = None,
+        **kwargs: Any,
+    ) -> "BESVectorStore":
+        """Construct BESVectorStore wrapper from documents.
+
+        Args:
+            documents: List of documents to add to the Elasticsearch index.
+            embedding: Embedding function to use to embed the texts.
+                      Do not provide if using a strategy
+                      that doesn't require inference.
+            kwargs: create index key words arguments
+        """
+
+        vectorStore = BESVectorStore._bes_vector_store(embedding=embedding, **kwargs)
+        # Encode the provided texts and add them to the newly created index.
+        vectorStore.add_documents(documents)
+
+        return vectorStore
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[Dict[str, Any]]] = None,
+        **kwargs: Any,
+    ) -> "BESVectorStore":
+        """Construct BESVectorStore wrapper from raw documents.
+
+        Args:
+            texts: List of texts to add to the Elasticsearch index.
+            embedding: Embedding function to use to embed the texts.
+            metadatas: Optional list of metadatas associated with the texts.
+            index_name: Name of the Elasticsearch index to create.
+            kwargs: create index key words arguments
+        """
+
+        vectorStore = BESVectorStore._bes_vector_store(embedding=embedding, **kwargs)
+
+        # Encode the provided texts and add them to the newly created index.
+        vectorStore.add_texts(texts, metadatas=metadatas, **kwargs)
+
+        return vectorStore
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        try:
+            from elasticsearch.helpers import BulkIndexError, bulk
+        except ImportError:
+            raise ImportError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+
+        embeddings = []
+        create_index_if_not_exists = kwargs.get("create_index_if_not_exists", True)
+        ids = kwargs.get("ids", [str(uuid.uuid4()) for _ in texts])
+        refresh_indices = kwargs.get("refresh_indices", True)
+        requests = []
+
+        if self.embedding is not None:
+            embeddings = self.embedding.embed_documents(list(texts))
+            dims_length = len(embeddings[0])
+
+            if create_index_if_not_exists:
+                self._create_index_if_not_exists(dims_length=dims_length)
+
+            for i, (text, vector) in enumerate(zip(texts, embeddings)):
+                metadata = metadatas[i] if metadatas else {}
+
+                requests.append(
+                    {
+                        "_op_type": "index",
+                        "_index": self.index_name,
+                        self.query_field: text,
+                        self.vector_query_field: vector,
+                        "metadata": metadata,
+                        "_id": ids[i],
+                    }
+                )
+
+        else:
+            if create_index_if_not_exists:
+                self._create_index_if_not_exists()
+
+            for i, text in enumerate(texts):
+                metadata = metadatas[i] if metadatas else {}
+
+                requests.append(
+                    {
+                        "_op_type": "index",
+                        "_index": self.index_name,
+                        self.query_field: text,
+                        "metadata": metadata,
+                        "_id": ids[i],
+                    }
+                )
+
+        if len(requests) > 0:
+            try:
+                success, failed = bulk(
+                    self.client, requests, stats_only=True, refresh=refresh_indices
+                )
+                logger.debug(
+                    f"Added {success} and failed to add {failed} texts to index"
+                )
+
+                logger.debug(f"added texts {ids} to index")
+                return ids
+            except BulkIndexError as e:
+                logger.error(f"Error adding texts: {e}")
+                firstError = e.errors[0].get("index", {}).get("error", {})
+                logger.error(f"First error reason: {firstError.get('reason')}")
+                raise e
+
+        else:
+            logger.debug("No texts to add to index")
+            return []
+
+    @staticmethod
+    def _bes_vector_store(
+        embedding: Optional[Embeddings] = None, **kwargs: Any
+    ) -> "BESVectorStore":
+        index_name = kwargs.get("index_name")
+
+        if index_name is None:
+            raise ValueError("Please provide an index_name.")
+
+        bes_url = kwargs.get("bes_url")
+        if bes_url is None:
+            raise ValueError("Please provided a valid bes connection url")
+
+        return BESVectorStore(embedding=embedding, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/baiduvectordb.py b/llm/Lib/site-packages/langchain_community/vectorstores/baiduvectordb.py
new file mode 100644
index 0000000000000000000000000000000000000000..f378df7b5eb042dfc8c8e06aa2112be3ac3b96c1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/baiduvectordb.py
@@ -0,0 +1,437 @@
+"""Wrapper around the Baidu vector database."""
+from __future__ import annotations
+
+import json
+import logging
+import time
+from typing import Any, Dict, Iterable, List, Optional, Tuple
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import guard_import
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+logger = logging.getLogger(__name__)
+
+
+class ConnectionParams:
+    """Baidu VectorDB Connection params.
+
+    See the following documentation for details:
+    https://cloud.baidu.com/doc/VDB/s/6lrsob0wy
+
+    Attribute:
+        endpoint (str) : The access address of the vector database server
+            that the client needs to connect to.
+        api_key (str): API key for client to access the vector database server,
+            which is used for authentication.
+        account (str) : Account for client to access the vector database server.
+        connection_timeout_in_mills (int) : Request Timeout.
+    """
+
+    def __init__(
+        self,
+        endpoint: str,
+        api_key: str,
+        account: str = "root",
+        connection_timeout_in_mills: int = 50 * 1000,
+    ):
+        self.endpoint = endpoint
+        self.api_key = api_key
+        self.account = account
+        self.connection_timeout_in_mills = connection_timeout_in_mills
+
+
+class TableParams:
+    """Baidu VectorDB table params.
+
+    See the following documentation for details:
+    https://cloud.baidu.com/doc/VDB/s/mlrsob0p6
+    """
+
+    def __init__(
+        self,
+        dimension: int,
+        replication: int = 3,
+        partition: int = 1,
+        index_type: str = "HNSW",
+        metric_type: str = "L2",
+        params: Optional[Dict] = None,
+    ):
+        self.dimension = dimension
+        self.replication = replication
+        self.partition = partition
+        self.index_type = index_type
+        self.metric_type = metric_type
+        self.params = params
+
+
+class BaiduVectorDB(VectorStore):
+    """Baidu VectorDB as a vector store.
+
+    In order to use this you need to have a database instance.
+    See the following documentation for details:
+    https://cloud.baidu.com/doc/VDB/index.html
+    """
+
+    field_id: str = "id"
+    field_vector: str = "vector"
+    field_text: str = "text"
+    field_metadata: str = "metadata"
+
+    index_vector: str = "vector_idx"
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        connection_params: ConnectionParams,
+        table_params: TableParams = TableParams(128),
+        database_name: str = "LangChainDatabase",
+        table_name: str = "LangChainTable",
+        drop_old: Optional[bool] = False,
+    ):
+        pymochow = guard_import("pymochow")
+        configuration = guard_import("pymochow.configuration")
+        auth = guard_import("pymochow.auth.bce_credentials")
+        self.mochowtable = guard_import("pymochow.model.table")
+        self.mochowenum = guard_import("pymochow.model.enum")
+        self.embedding_func = embedding
+        self.table_params = table_params
+        config = configuration.Configuration(
+            credentials=auth.BceCredentials(
+                connection_params.account, connection_params.api_key
+            ),
+            endpoint=connection_params.endpoint,
+            connection_timeout_in_mills=connection_params.connection_timeout_in_mills,
+        )
+        self.vdb_client = pymochow.MochowClient(config)
+        db_list = self.vdb_client.list_databases()
+        db_exist: bool = False
+        for db in db_list:
+            if database_name == db.database_name:
+                db_exist = True
+                break
+        if db_exist:
+            self.database = self.vdb_client.database(database_name)
+        else:
+            self.database = self.vdb_client.create_database(database_name)
+        try:
+            self.table = self.database.describe_table(table_name)
+            if drop_old:
+                self.database.drop_table(table_name)
+                self._create_table(table_name)
+        except pymochow.exception.ServerError:
+            self._create_table(table_name)
+
+    def _create_table(self, table_name: str) -> None:
+        schema = guard_import("pymochow.model.schema")
+        index_type = None
+        for k, v in self.mochowenum.IndexType.__members__.items():
+            if k == self.table_params.index_type:
+                index_type = v
+        if index_type is None:
+            raise ValueError("unsupported index_type")
+        metric_type = None
+        for k, v in self.mochowenum.MetricType.__members__.items():
+            if k == self.table_params.metric_type:
+                metric_type = v
+        if metric_type is None:
+            raise ValueError("unsupported metric_type")
+        if self.table_params.params is None:
+            params = schema.HNSWParams(m=16, efconstruction=200)
+        else:
+            params = schema.HNSWParams(
+                m=self.table_params.params.get("M", 16),
+                efconstruction=self.table_params.params.get("efConstruction", 200),
+            )
+        fields = []
+        fields.append(
+            schema.Field(
+                self.field_id,
+                self.mochowenum.FieldType.STRING,
+                primary_key=True,
+                partition_key=True,
+                auto_increment=False,
+                not_null=True,
+            )
+        )
+        fields.append(
+            schema.Field(
+                self.field_vector,
+                self.mochowenum.FieldType.FLOAT_VECTOR,
+                dimension=self.table_params.dimension,
+                not_null=True,
+            )
+        )
+        fields.append(schema.Field(self.field_text, self.mochowenum.FieldType.STRING))
+        fields.append(
+            schema.Field(self.field_metadata, self.mochowenum.FieldType.STRING)
+        )
+        indexes = []
+        indexes.append(
+            schema.VectorIndex(
+                index_name=self.index_vector,
+                index_type=index_type,
+                field=self.field_vector,
+                metric_type=metric_type,
+                params=params,
+            )
+        )
+
+        self.table = self.database.create_table(
+            table_name=table_name,
+            replication=self.table_params.replication,
+            partition=self.mochowtable.Partition(
+                partition_num=self.table_params.partition
+            ),
+            schema=schema.Schema(fields=fields, indexes=indexes),
+        )
+
+        while True:
+            time.sleep(1)
+            table = self.database.describe_table(table_name)
+            if table.state == self.mochowenum.TableState.NORMAL:
+                break
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding_func
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        connection_params: Optional[ConnectionParams] = None,
+        table_params: Optional[TableParams] = None,
+        database_name: str = "LangChainDatabase",
+        table_name: str = "LangChainTable",
+        drop_old: Optional[bool] = False,
+        **kwargs: Any,
+    ) -> BaiduVectorDB:
+        """Create a table, indexes it with HNSW, and insert data."""
+        if len(texts) == 0:
+            raise ValueError("texts is empty")
+        if connection_params is None:
+            raise ValueError("connection_params is empty")
+        try:
+            embeddings = embedding.embed_documents(texts[0:1])
+        except NotImplementedError:
+            embeddings = [embedding.embed_query(texts[0])]
+        dimension = len(embeddings[0])
+        if table_params is None:
+            table_params = TableParams(dimension=dimension)
+        else:
+            table_params.dimension = dimension
+        vector_db = cls(
+            embedding=embedding,
+            connection_params=connection_params,
+            table_params=table_params,
+            database_name=database_name,
+            table_name=table_name,
+            drop_old=drop_old,
+        )
+        vector_db.add_texts(texts=texts, metadatas=metadatas)
+        return vector_db
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        batch_size: int = 1000,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Insert text data into Baidu VectorDB."""
+        texts = list(texts)
+        try:
+            embeddings = self.embedding_func.embed_documents(texts)
+        except NotImplementedError:
+            embeddings = [self.embedding_func.embed_query(x) for x in texts]
+        if len(embeddings) == 0:
+            logger.debug("Nothing to insert, skipping.")
+            return []
+        pks: list[str] = []
+        total_count = len(embeddings)
+        for start in range(0, total_count, batch_size):
+            # Grab end index
+            rows = []
+            end = min(start + batch_size, total_count)
+            for id in range(start, end, 1):
+                metadata = "{}"
+                if metadatas is not None:
+                    metadata = json.dumps(metadatas[id])
+                row = self.mochowtable.Row(
+                    id="{}-{}-{}".format(time.time_ns(), hash(texts[id]), id),
+                    vector=[float(num) for num in embeddings[id]],
+                    text=texts[id],
+                    metadata=metadata,
+                )
+                rows.append(row)
+                pks.append(str(id))
+            self.table.upsert(rows=rows)
+        # need rebuild vindex after upsert
+        self.table.rebuild_index(self.index_vector)
+        while True:
+            time.sleep(2)
+            index = self.table.describe_index(self.index_vector)
+            if index.state == self.mochowenum.IndexState.NORMAL:
+                break
+        return pks
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a similarity search against the query string."""
+        res = self.similarity_search_with_score(
+            query=query, k=k, param=param, expr=expr, **kwargs
+        )
+        return [doc for doc, _ in res]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Perform a search on a query string and return results with score."""
+        # Embed the query text.
+        embedding = self.embedding_func.embed_query(query)
+        res = self._similarity_search_with_score(
+            embedding=embedding, k=k, param=param, expr=expr, **kwargs
+        )
+        return res
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a similarity search against the query string."""
+        res = self._similarity_search_with_score(
+            embedding=embedding, k=k, param=param, expr=expr, **kwargs
+        )
+        return [doc for doc, _ in res]
+
+    def _similarity_search_with_score(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Perform a search on a query string and return results with score."""
+        ef = 10 if param is None else param.get("ef", 10)
+
+        anns = self.mochowtable.AnnSearch(
+            vector_field=self.field_vector,
+            vector_floats=[float(num) for num in embedding],
+            params=self.mochowtable.HNSWSearchParams(ef=ef, limit=k),
+            filter=expr,
+        )
+        res = self.table.search(anns=anns)
+
+        rows = [[item] for item in res.rows]
+        # Organize results.
+        ret: List[Tuple[Document, float]] = []
+        if rows is None or len(rows) == 0:
+            return ret
+        for row in rows:
+            for result in row:
+                row_data = result.get("row", {})
+                meta = row_data.get(self.field_metadata)
+                if meta is not None:
+                    meta = json.loads(meta)
+                doc = Document(
+                    page_content=row_data.get(self.field_text), metadata=meta
+                )
+                pair = (doc, result.get("score", 0.0))
+                ret.append(pair)
+        return ret
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a search and return results that are reordered by MMR."""
+        embedding = self.embedding_func.embed_query(query)
+        return self._max_marginal_relevance_search(
+            embedding=embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            param=param,
+            expr=expr,
+            **kwargs,
+        )
+
+    def _max_marginal_relevance_search(
+        self,
+        embedding: list[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a search and return results that are reordered by MMR."""
+        ef = 10 if param is None else param.get("ef", 10)
+        anns = self.mochowtable.AnnSearch(
+            vector_field=self.field_vector,
+            vector_floats=[float(num) for num in embedding],
+            params=self.mochowtable.HNSWSearchParams(ef=ef, limit=k),
+            filter=expr,
+        )
+        res = self.table.search(anns=anns, retrieve_vector=True)
+
+        # Organize results.
+        documents: List[Document] = []
+        ordered_result_embeddings = []
+        rows = [[item] for item in res.rows]
+        if rows is None or len(rows) == 0:
+            return documents
+        for row in rows:
+            for result in row:
+                row_data = result.get("row", {})
+                meta = row_data.get(self.field_metadata)
+                if meta is not None:
+                    meta = json.loads(meta)
+                doc = Document(
+                    page_content=row_data.get(self.field_text), metadata=meta
+                )
+                documents.append(doc)
+                ordered_result_embeddings.append(row_data.get(self.field_vector))
+        # Get the new order of results.
+        new_ordering = maximal_marginal_relevance(
+            np.array(embedding), ordered_result_embeddings, k=k, lambda_mult=lambda_mult
+        )
+        # Reorder the values and return.
+        ret = []
+        for x in new_ordering:
+            # Function can return -1 index
+            if x == -1:
+                break
+            else:
+                ret.append(documents[x])
+        return ret
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/bigquery_vector_search.py b/llm/Lib/site-packages/langchain_community/vectorstores/bigquery_vector_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..2da8cc8dd2235fc63b3fbafc6c908934919bc75e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/bigquery_vector_search.py
@@ -0,0 +1,870 @@
+"""Vector Store in Google Cloud BigQuery."""
+
+from __future__ import annotations
+
+import asyncio
+import json
+import logging
+import sys
+import uuid
+from datetime import datetime
+from functools import partial
+from threading import Lock, Thread
+from typing import Any, Callable, Dict, List, Optional, Tuple, Type
+
+import numpy as np
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.utils.google import get_client_info
+from langchain_community.vectorstores.utils import (
+    DistanceStrategy,
+    maximal_marginal_relevance,
+)
+
+DEFAULT_DISTANCE_STRATEGY = DistanceStrategy.EUCLIDEAN_DISTANCE
+DEFAULT_DOC_ID_COLUMN_NAME = "doc_id"  # document id
+DEFAULT_TEXT_EMBEDDING_COLUMN_NAME = "text_embedding"  # embeddings vectors
+DEFAULT_METADATA_COLUMN_NAME = "metadata"  # document metadata
+DEFAULT_CONTENT_COLUMN_NAME = "content"  # text content, do not rename
+DEFAULT_TOP_K = 4  # default number of documents returned from similarity search
+
+_MIN_INDEX_ROWS = 5000  # minimal number of rows for creating an index
+_INDEX_CHECK_PERIOD_SECONDS = 60  # Do not check for index more often that this.
+_vector_table_lock = Lock()  # process-wide BigQueryVectorSearch table lock
+
+
+@deprecated(
+    since="0.0.33",
+    removal="0.2.0",
+    alternative_import="langchain_google_community.BigQueryVectorSearch",
+)
+class BigQueryVectorSearch(VectorStore):
+    """Google Cloud BigQuery vector store.
+
+    To use, you need the following packages installed:
+        google-cloud-bigquery
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        project_id: str,
+        dataset_name: str,
+        table_name: str,
+        location: str = "US",
+        content_field: str = DEFAULT_CONTENT_COLUMN_NAME,
+        metadata_field: str = DEFAULT_METADATA_COLUMN_NAME,
+        text_embedding_field: str = DEFAULT_TEXT_EMBEDDING_COLUMN_NAME,
+        doc_id_field: str = DEFAULT_DOC_ID_COLUMN_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        credentials: Optional[Any] = None,
+    ):
+        """Constructor for BigQueryVectorSearch.
+
+        Args:
+            embedding (Embeddings): Text Embedding model to use.
+            project_id (str): GCP project.
+            dataset_name (str): BigQuery dataset to store documents and embeddings.
+            table_name (str): BigQuery table name.
+            location (str, optional): BigQuery region. Defaults to
+                                      `US`(multi-region).
+            content_field (str): Specifies the column to store the content.
+                                 Defaults to `content`.
+            metadata_field (str): Specifies the column to store the metadata.
+                                  Defaults to `metadata`.
+            text_embedding_field (str): Specifies the column to store
+                                        the embeddings vector.
+                                        Defaults to `text_embedding`.
+            doc_id_field (str): Specifies the column to store the document id.
+                                Defaults to `doc_id`.
+            distance_strategy (DistanceStrategy, optional):
+                Determines the strategy employed for calculating
+                the distance between vectors in the embedding space.
+                Defaults to EUCLIDEAN_DISTANCE.
+                Available options are:
+                - COSINE: Measures the similarity between two vectors of an inner
+                    product space.
+                - EUCLIDEAN_DISTANCE: Computes the Euclidean distance between
+                    two vectors. This metric considers the geometric distance in
+                    the vector space, and might be more suitable for embeddings
+                    that rely on spatial relationships. This is the default behavior
+            credentials (Credentials, optional): Custom Google Cloud credentials
+                to use. Defaults to None.
+        """
+        try:
+            from google.cloud import bigquery
+
+            client_info = get_client_info(module="bigquery-vector-search")
+            self.bq_client = bigquery.Client(
+                project=project_id,
+                location=location,
+                credentials=credentials,
+                client_info=client_info,
+            )
+        except ModuleNotFoundError:
+            raise ImportError(
+                "Please, install or upgrade the google-cloud-bigquery library: "
+                "pip install google-cloud-bigquery"
+            )
+        self._logger = logging.getLogger(__name__)
+        self._creating_index = False
+        self._have_index = False
+        self.embedding_model = embedding
+        self.project_id = project_id
+        self.dataset_name = dataset_name
+        self.table_name = table_name
+        self.location = location
+        self.content_field = content_field
+        self.metadata_field = metadata_field
+        self.text_embedding_field = text_embedding_field
+        self.doc_id_field = doc_id_field
+        self.distance_strategy = distance_strategy
+        self._full_table_id = (
+            f"{self.project_id}." f"{self.dataset_name}." f"{self.table_name}"
+        )
+        self._logger.debug("Using table `%s`", self.full_table_id)
+        with _vector_table_lock:
+            self.vectors_table = self._initialize_table()
+        self._last_index_check = datetime.min
+        self._initialize_vector_index()
+
+    def _initialize_table(self) -> Any:
+        """Validates or creates the BigQuery table."""
+        from google.cloud import bigquery
+
+        table_ref = bigquery.TableReference.from_string(self._full_table_id)
+        table = self.bq_client.create_table(table_ref, exists_ok=True)
+        changed_schema = False
+        schema = table.schema.copy()
+        columns = {c.name: c for c in schema}
+        if self.doc_id_field not in columns:
+            changed_schema = True
+            schema.append(
+                bigquery.SchemaField(name=self.doc_id_field, field_type="STRING")
+            )
+        elif (
+            columns[self.doc_id_field].field_type != "STRING"
+            or columns[self.doc_id_field].mode == "REPEATED"
+        ):
+            raise ValueError(f"Column {self.doc_id_field} must be of " "STRING type")
+        if self.metadata_field not in columns:
+            changed_schema = True
+            schema.append(
+                bigquery.SchemaField(name=self.metadata_field, field_type="JSON")
+            )
+        elif (
+            columns[self.metadata_field].field_type not in ["JSON", "STRING"]
+            or columns[self.metadata_field].mode == "REPEATED"
+        ):
+            raise ValueError(
+                f"Column {self.metadata_field} must be of STRING or JSON type"
+            )
+        if self.content_field not in columns:
+            changed_schema = True
+            schema.append(
+                bigquery.SchemaField(name=self.content_field, field_type="STRING")
+            )
+        elif (
+            columns[self.content_field].field_type != "STRING"
+            or columns[self.content_field].mode == "REPEATED"
+        ):
+            raise ValueError(f"Column {self.content_field} must be of " "STRING type")
+        if self.text_embedding_field not in columns:
+            changed_schema = True
+            schema.append(
+                bigquery.SchemaField(
+                    name=self.text_embedding_field,
+                    field_type="FLOAT64",
+                    mode="REPEATED",
+                )
+            )
+        elif (
+            columns[self.text_embedding_field].field_type not in ("FLOAT", "FLOAT64")
+            or columns[self.text_embedding_field].mode != "REPEATED"
+        ):
+            raise ValueError(
+                f"Column {self.text_embedding_field} must be of " "ARRAY<FLOAT64> type"
+            )
+        if changed_schema:
+            self._logger.debug("Updated table `%s` schema.", self.full_table_id)
+            table.schema = schema
+            table = self.bq_client.update_table(table, fields=["schema"])
+        return table
+
+    def _initialize_vector_index(self) -> Any:
+        """
+        A vector index in BigQuery table enables efficient
+        approximate vector search.
+        """
+        from google.cloud import bigquery
+
+        if self._have_index or self._creating_index:
+            # Already have an index or in the process of creating one.
+            return
+        table = self.bq_client.get_table(self.vectors_table)
+        if (table.num_rows or 0) < _MIN_INDEX_ROWS:
+            # Not enough rows to create index.
+            self._logger.debug("Not enough rows to create a vector index.")
+            return
+        if (
+            datetime.utcnow() - self._last_index_check
+        ).total_seconds() < _INDEX_CHECK_PERIOD_SECONDS:
+            return
+        with _vector_table_lock:
+            if self._creating_index or self._have_index:
+                return
+            self._last_index_check = datetime.utcnow()
+            # Check if index exists, create if necessary
+            check_query = (
+                f"SELECT 1 FROM `{self.project_id}.{self.dataset_name}"
+                ".INFORMATION_SCHEMA.VECTOR_INDEXES` WHERE"
+                f" table_name = '{self.table_name}'"
+            )
+            job = self.bq_client.query(
+                check_query, api_method=bigquery.enums.QueryApiMethod.QUERY
+            )
+            if job.result().total_rows == 0:
+                # Need to create an index. Make it in a separate thread.
+                self._create_index_in_background()
+            else:
+                self._logger.debug("Vector index already exists.")
+                self._have_index = True
+
+    def _create_index_in_background(self):  # type: ignore[no-untyped-def]
+        if self._have_index or self._creating_index:
+            # Already have an index or in the process of creating one.
+            return
+        self._creating_index = True
+        self._logger.debug("Trying to create a vector index.")
+        thread = Thread(target=self._create_index, daemon=True)
+        thread.start()
+
+    def _create_index(self):  # type: ignore[no-untyped-def]
+        from google.api_core.exceptions import ClientError
+
+        table = self.bq_client.get_table(self.vectors_table)
+        if (table.num_rows or 0) < _MIN_INDEX_ROWS:
+            # Not enough rows to create index.
+            return
+        if self.distance_strategy == DistanceStrategy.EUCLIDEAN_DISTANCE:
+            distance_type = "EUCLIDEAN"
+        elif self.distance_strategy == DistanceStrategy.COSINE:
+            distance_type = "COSINE"
+        # Default to EUCLIDEAN_DISTANCE
+        else:
+            distance_type = "EUCLIDEAN"
+        index_name = f"{self.table_name}_langchain_index"
+        try:
+            sql = f"""
+                CREATE VECTOR INDEX IF NOT EXISTS
+                `{index_name}`
+                ON `{self.full_table_id}`({self.text_embedding_field})
+                OPTIONS(distance_type="{distance_type}", index_type="IVF")
+            """
+            self.bq_client.query(sql).result()
+            self._have_index = True
+        except ClientError as ex:
+            self._logger.debug("Vector index creation failed (%s).", ex.args[0])
+        finally:
+            self._creating_index = False
+
+    def _persist(self, data: Dict[str, Any]) -> None:
+        """Saves documents and embeddings to BigQuery."""
+        from google.cloud import bigquery
+
+        data_len = len(data[list(data.keys())[0]])
+        if data_len == 0:
+            return
+
+        list_of_dicts = [dict(zip(data, t)) for t in zip(*data.values())]
+
+        job_config = bigquery.LoadJobConfig()
+        job_config.schema = self.vectors_table.schema
+        job_config.schema_update_options = (
+            bigquery.SchemaUpdateOption.ALLOW_FIELD_ADDITION
+        )
+        job_config.write_disposition = bigquery.WriteDisposition.WRITE_APPEND
+        job = self.bq_client.load_table_from_json(
+            list_of_dicts, self.vectors_table, job_config=job_config
+        )
+        job.result()
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self.embedding_model
+
+    @property
+    def full_table_id(self) -> str:
+        return self._full_table_id
+
+    def add_texts(  # type: ignore[override]
+        self,
+        texts: List[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: List of strings to add to the vectorstore.
+            metadatas: Optional list of metadata associated with the texts.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        embs = self.embedding_model.embed_documents(texts)
+        return self.add_texts_with_embeddings(texts, embs, metadatas, **kwargs)
+
+    def add_texts_with_embeddings(
+        self,
+        texts: List[str],
+        embs: List[List[float]],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: List of strings to add to the vectorstore.
+            embs: List of lists of floats with text embeddings for texts.
+            metadatas: Optional list of metadata associated with the texts.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        ids = [uuid.uuid4().hex for _ in texts]
+        values_dict: Dict[str, List[Any]] = {
+            self.content_field: texts,
+            self.doc_id_field: ids,
+        }
+        if not metadatas:
+            metadatas = []
+        len_diff = len(ids) - len(metadatas)
+        add_meta = [None for _ in range(0, len_diff)]
+        metadatas = [m if m is not None else {} for m in metadatas + add_meta]
+        values_dict[self.metadata_field] = metadatas
+        values_dict[self.text_embedding_field] = embs
+        self._persist(values_dict)
+        return ids
+
+    def get_documents(
+        self, ids: Optional[List[str]] = None, filter: Optional[Dict[str, Any]] = None
+    ) -> List[Document]:
+        """Search documents by their ids or metadata values.
+
+        Args:
+            ids: List of ids of documents to retrieve from the vectorstore.
+            filter: Filter on metadata properties, e.g.
+                            {
+                                "str_property": "foo",
+                                "int_property": 123
+                            }
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        if ids and len(ids) > 0:
+            from google.cloud import bigquery
+
+            job_config = bigquery.QueryJobConfig(
+                query_parameters=[
+                    bigquery.ArrayQueryParameter("ids", "STRING", ids),
+                ]
+            )
+            id_expr = f"{self.doc_id_field} IN UNNEST(@ids)"
+        else:
+            job_config = None
+            id_expr = "TRUE"
+        if filter:
+            filter_expressions = []
+            for i in filter.items():
+                if isinstance(i[1], float):
+                    expr = (
+                        "ABS(CAST(JSON_VALUE("
+                        f"`{self.metadata_field}`,'$.{i[0]}') "
+                        f"AS FLOAT64) - {i[1]}) "
+                        f"<= {sys.float_info.epsilon}"
+                    )
+                else:
+                    val = str(i[1]).replace('"', '\\"')
+                    expr = (
+                        f"JSON_VALUE(`{self.metadata_field}`,'$.{i[0]}')" f' = "{val}"'
+                    )
+                filter_expressions.append(expr)
+            filter_expression_str = " AND ".join(filter_expressions)
+            where_filter_expr = f" AND ({filter_expression_str})"
+        else:
+            where_filter_expr = ""
+
+        job = self.bq_client.query(
+            f"""
+                    SELECT * FROM `{self.full_table_id}` WHERE {id_expr}
+                    {where_filter_expr}
+                    """,
+            job_config=job_config,
+        )
+        docs: List[Document] = []
+        for row in job:
+            metadata = None
+            if self.metadata_field:
+                metadata = row[self.metadata_field]
+            if metadata:
+                if not isinstance(metadata, dict):
+                    metadata = json.loads(metadata)
+            else:
+                metadata = {}
+            metadata["__id"] = row[self.doc_id_field]
+            doc = Document(page_content=row[self.content_field], metadata=metadata)
+            docs.append(doc)
+        return docs
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        """Delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+        if not ids or len(ids) == 0:
+            return True
+        from google.cloud import bigquery
+
+        job_config = bigquery.QueryJobConfig(
+            query_parameters=[
+                bigquery.ArrayQueryParameter("ids", "STRING", ids),
+            ]
+        )
+        self.bq_client.query(
+            f"""
+                    DELETE FROM `{self.full_table_id}` WHERE {self.doc_id_field}
+                    IN UNNEST(@ids)
+                    """,
+            job_config=job_config,
+        ).result()
+        return True
+
+    async def adelete(
+        self, ids: Optional[List[str]] = None, **kwargs: Any
+    ) -> Optional[bool]:
+        """Delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+        return await asyncio.get_running_loop().run_in_executor(
+            None, partial(self.delete, **kwargs), ids
+        )
+
+    def _search_with_score_and_embeddings_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_TOP_K,
+        filter: Optional[Dict[str, Any]] = None,
+        brute_force: bool = False,
+        fraction_lists_to_search: Optional[float] = None,
+    ) -> List[Tuple[Document, List[float], float]]:
+        from google.cloud import bigquery
+
+        # Create an index if no index exists.
+        if not self._have_index and not self._creating_index:
+            self._initialize_vector_index()
+        # Prepare filter
+        filter_expr = "TRUE"
+        if filter:
+            filter_expressions = []
+            for i in filter.items():
+                if isinstance(i[1], float):
+                    expr = (
+                        "ABS(CAST(JSON_VALUE("
+                        f"base.`{self.metadata_field}`,'$.{i[0]}') "
+                        f"AS FLOAT64) - {i[1]}) "
+                        f"<= {sys.float_info.epsilon}"
+                    )
+                else:
+                    val = str(i[1]).replace('"', '\\"')
+                    expr = (
+                        f"JSON_VALUE(base.`{self.metadata_field}`,'$.{i[0]}')"
+                        f' = "{val}"'
+                    )
+                filter_expressions.append(expr)
+            filter_expression_str = " AND ".join(filter_expressions)
+            filter_expr += f" AND ({filter_expression_str})"
+        # Configure and run a query job.
+        job_config = bigquery.QueryJobConfig(
+            query_parameters=[
+                bigquery.ArrayQueryParameter("v", "FLOAT64", embedding),
+            ],
+            use_query_cache=False,
+            priority=bigquery.QueryPriority.BATCH,
+        )
+        if self.distance_strategy == DistanceStrategy.EUCLIDEAN_DISTANCE:
+            distance_type = "EUCLIDEAN"
+        elif self.distance_strategy == DistanceStrategy.COSINE:
+            distance_type = "COSINE"
+        # Default to EUCLIDEAN_DISTANCE
+        else:
+            distance_type = "EUCLIDEAN"
+        if brute_force:
+            options_string = ",options => '{\"use_brute_force\":true}'"
+        elif fraction_lists_to_search:
+            if fraction_lists_to_search == 0 or fraction_lists_to_search >= 1.0:
+                raise ValueError(
+                    "`fraction_lists_to_search` must be between " "0.0 and 1.0"
+                )
+            options_string = (
+                ',options => \'{"fraction_lists_to_search":'
+                f"{fraction_lists_to_search}}}'"
+            )
+        else:
+            options_string = ""
+        query = f"""
+            SELECT
+                base.*,
+                distance AS _vector_search_distance
+            FROM VECTOR_SEARCH(
+                TABLE `{self.full_table_id}`,
+                "{self.text_embedding_field}",
+                (SELECT @v AS {self.text_embedding_field}),
+                distance_type => "{distance_type}",
+                top_k => {k}
+                {options_string}
+            )
+            WHERE {filter_expr}
+            LIMIT {k}
+        """
+        document_tuples: List[Tuple[Document, List[float], float]] = []
+        # TODO(vladkol): Use jobCreationMode=JOB_CREATION_OPTIONAL when available.
+        job = self.bq_client.query(
+            query, job_config=job_config, api_method=bigquery.enums.QueryApiMethod.QUERY
+        )
+        # Process job results.
+        for row in job:
+            metadata = row[self.metadata_field]
+            if metadata:
+                if not isinstance(metadata, dict):
+                    metadata = json.loads(metadata)
+            else:
+                metadata = {}
+            metadata["__id"] = row[self.doc_id_field]
+            metadata["__job_id"] = job.job_id
+            doc = Document(page_content=row[self.content_field], metadata=metadata)
+            document_tuples.append(
+                (doc, row[self.text_embedding_field], row["_vector_search_distance"])
+            )
+        return document_tuples
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_TOP_K,
+        filter: Optional[Dict[str, Any]] = None,
+        brute_force: bool = False,
+        fraction_lists_to_search: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on metadata properties, e.g.
+                            {
+                                "str_property": "foo",
+                                "int_property": 123
+                            }
+            brute_force: Whether to use brute force search. Defaults to False.
+            fraction_lists_to_search: Optional percentage of lists to search,
+                must be in range 0.0 and 1.0, exclusive.
+                If Node, uses service's default which is 0.05.
+
+        Returns:
+            List of Documents most similar to the query vector with distance.
+        """
+        del kwargs
+        document_tuples = self._search_with_score_and_embeddings_by_vector(
+            embedding, k, filter, brute_force, fraction_lists_to_search
+        )
+        return [(doc, distance) for doc, _, distance in document_tuples]
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_TOP_K,
+        filter: Optional[Dict[str, Any]] = None,
+        brute_force: bool = False,
+        fraction_lists_to_search: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on metadata properties, e.g.
+                            {
+                                "str_property": "foo",
+                                "int_property": 123
+                            }
+            brute_force: Whether to use brute force search. Defaults to False.
+            fraction_lists_to_search: Optional percentage of lists to search,
+                must be in range 0.0 and 1.0, exclusive.
+                If Node, uses service's default which is 0.05.
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        tuples = self.similarity_search_with_score_by_vector(
+            embedding, k, filter, brute_force, fraction_lists_to_search, **kwargs
+        )
+        return [i[0] for i in tuples]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = DEFAULT_TOP_K,
+        filter: Optional[Dict[str, Any]] = None,
+        brute_force: bool = False,
+        fraction_lists_to_search: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search with score.
+
+        Args:
+            query: search query text.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on metadata properties, e.g.
+                            {
+                                "str_property": "foo",
+                                "int_property": 123
+                            }
+            brute_force: Whether to use brute force search. Defaults to False.
+            fraction_lists_to_search: Optional percentage of lists to search,
+                must be in range 0.0 and 1.0, exclusive.
+                If Node, uses service's default which is 0.05.
+
+        Returns:
+            List of Documents most similar to the query vector, with similarity scores.
+        """
+        emb = self.embedding_model.embed_query(query)  # type: ignore
+        return self.similarity_search_with_score_by_vector(
+            emb, k, filter, brute_force, fraction_lists_to_search, **kwargs
+        )
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = DEFAULT_TOP_K,
+        filter: Optional[Dict[str, Any]] = None,
+        brute_force: bool = False,
+        fraction_lists_to_search: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search.
+
+        Args:
+            query: search query text.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on metadata properties, e.g.
+                            {
+                                "str_property": "foo",
+                                "int_property": 123
+                            }
+            brute_force: Whether to use brute force search. Defaults to False.
+            fraction_lists_to_search: Optional percentage of lists to search,
+                must be in range 0.0 and 1.0, exclusive.
+                If Node, uses service's default which is 0.05.
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        tuples = self.similarity_search_with_score(
+            query, k, filter, brute_force, fraction_lists_to_search, **kwargs
+        )
+        return [i[0] for i in tuples]
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        if self.distance_strategy == DistanceStrategy.COSINE:
+            return BigQueryVectorSearch._cosine_relevance_score_fn
+        else:
+            raise ValueError(
+                "Relevance score is not supported "
+                f"for `{self.distance_strategy}` distance."
+            )
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = DEFAULT_TOP_K,
+        fetch_k: int = DEFAULT_TOP_K * 5,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, Any]] = None,
+        brute_force: bool = False,
+        fraction_lists_to_search: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: search query text.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter: Filter on metadata properties, e.g.
+                            {
+                                "str_property": "foo",
+                                "int_property": 123
+                            }
+            brute_force: Whether to use brute force search. Defaults to False.
+            fraction_lists_to_search: Optional percentage of lists to search,
+                must be in range 0.0 and 1.0, exclusive.
+                If Node, uses service's default which is 0.05.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        query_embedding = self.embedding_model.embed_query(  # type: ignore
+            query
+        )
+        doc_tuples = self._search_with_score_and_embeddings_by_vector(
+            query_embedding, fetch_k, filter, brute_force, fraction_lists_to_search
+        )
+        doc_embeddings = [d[1] for d in doc_tuples]
+        mmr_doc_indexes = maximal_marginal_relevance(
+            np.array(query_embedding), doc_embeddings, lambda_mult=lambda_mult, k=k
+        )
+        return [doc_tuples[i][0] for i in mmr_doc_indexes]
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_TOP_K,
+        fetch_k: int = DEFAULT_TOP_K * 5,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, Any]] = None,
+        brute_force: bool = False,
+        fraction_lists_to_search: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter: Filter on metadata properties, e.g.
+                            {
+                                "str_property": "foo",
+                                "int_property": 123
+                            }
+            brute_force: Whether to use brute force search. Defaults to False.
+            fraction_lists_to_search: Optional percentage of lists to search,
+                must be in range 0.0 and 1.0, exclusive.
+                If Node, uses service's default which is 0.05.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        doc_tuples = self._search_with_score_and_embeddings_by_vector(
+            embedding, fetch_k, filter, brute_force, fraction_lists_to_search
+        )
+        doc_embeddings = [d[1] for d in doc_tuples]
+        mmr_doc_indexes = maximal_marginal_relevance(
+            np.array(embedding), doc_embeddings, lambda_mult=lambda_mult, k=k
+        )
+        return [doc_tuples[i][0] for i in mmr_doc_indexes]
+
+    async def amax_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = DEFAULT_TOP_K,
+        fetch_k: int = DEFAULT_TOP_K * 5,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, Any]] = None,
+        brute_force: bool = False,
+        fraction_lists_to_search: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance."""
+
+        func = partial(
+            self.max_marginal_relevance_search,
+            query,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            brute_force=brute_force,
+            fraction_lists_to_search=fraction_lists_to_search,
+            **kwargs,
+        )
+        return await asyncio.get_event_loop().run_in_executor(None, func)
+
+    async def amax_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_TOP_K,
+        fetch_k: int = DEFAULT_TOP_K * 5,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, Any]] = None,
+        brute_force: bool = False,
+        fraction_lists_to_search: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance."""
+        return await asyncio.get_running_loop().run_in_executor(
+            None,
+            partial(self.max_marginal_relevance_search_by_vector, **kwargs),
+            embedding,
+            k,
+            fetch_k,
+            lambda_mult,
+            filter,
+            brute_force,
+            fraction_lists_to_search,
+        )
+
+    @classmethod
+    def from_texts(
+        cls: Type["BigQueryVectorSearch"],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> "BigQueryVectorSearch":
+        """Return VectorStore initialized from texts and embeddings."""
+        vs_obj = BigQueryVectorSearch(embedding=embedding, **kwargs)
+        vs_obj.add_texts(texts, metadatas)
+        return vs_obj
+
+    def explore_job_stats(self, job_id: str) -> Dict:
+        """Return the statistics for a single job execution.
+
+        Args:
+            job_id: The BigQuery Job id.
+
+        Returns:
+            A dictionary of job statistics for a given job.
+        """
+        return self.bq_client.get_job(job_id)._properties["statistics"]
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/cassandra.py b/llm/Lib/site-packages/langchain_community/vectorstores/cassandra.py
new file mode 100644
index 0000000000000000000000000000000000000000..6eae961e4b6453f16dfe8650a7f9cba2e23f77f5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/cassandra.py
@@ -0,0 +1,550 @@
+from __future__ import annotations
+
+import typing
+import uuid
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+
+import numpy as np
+
+if typing.TYPE_CHECKING:
+    from cassandra.cluster import Session
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+CVST = TypeVar("CVST", bound="Cassandra")
+
+_NOT_SET = object()
+
+
+class Cassandra(VectorStore):
+    """Wrapper around Apache Cassandra(R) for vector-store workloads.
+
+    To use it, you need a recent installation of the `cassio` library
+    and a Cassandra cluster / Astra DB instance supporting vector capabilities.
+
+    Visit the cassio.org website for extensive quickstarts and code examples.
+
+    Example:
+        .. code-block:: python
+
+                from langchain_community.vectorstores import Cassandra
+                from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+                embeddings = OpenAIEmbeddings()
+                session = ...             # create your Cassandra session object
+                keyspace = 'my_keyspace'  # the keyspace should exist already
+                table_name = 'my_vector_store'
+                vectorstore = Cassandra(embeddings, session, keyspace, table_name)
+
+    Args:
+        embedding: Embedding function to use.
+        session: Cassandra driver session.
+        keyspace: Cassandra key space.
+        table_name: Cassandra table.
+        ttl_seconds: Optional time-to-live for the added texts.
+        body_index_options: Optional options used to create the body index.
+            Eg. body_index_options = [cassio.table.cql.STANDARD_ANALYZER]
+    """
+
+    _embedding_dimension: Union[int, None]
+
+    def _get_embedding_dimension(self) -> int:
+        if self._embedding_dimension is None:
+            self._embedding_dimension = len(
+                self.embedding.embed_query("This is a sample sentence.")
+            )
+        return self._embedding_dimension
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        session: Session,
+        keyspace: str,
+        table_name: str,
+        ttl_seconds: Optional[int] = None,
+        *,
+        body_index_options: Optional[List[Tuple[str, Any]]] = None,
+    ) -> None:
+        try:
+            from cassio.table import MetadataVectorCassandraTable
+        except (ImportError, ModuleNotFoundError):
+            raise ImportError(
+                "Could not import cassio python package. "
+                "Please install it with `pip install cassio`."
+            )
+        """Create a vector table."""
+        self.embedding = embedding
+        self.session = session
+        self.keyspace = keyspace
+        self.table_name = table_name
+        self.ttl_seconds = ttl_seconds
+        #
+        self._embedding_dimension = None
+        #
+        kwargs = {}
+        if body_index_options is not None:
+            kwargs["body_index_options"] = body_index_options
+
+        self.table = MetadataVectorCassandraTable(
+            session=session,
+            keyspace=keyspace,
+            table=table_name,
+            vector_dimension=self._get_embedding_dimension(),
+            metadata_indexing="all",
+            primary_key_type="TEXT",
+            **kwargs,
+        )
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The underlying VectorTable already returns a "score proper",
+        i.e. one in [0, 1] where higher means more *similar*,
+        so here the final score transformation is not reversing the interval:
+        """
+        return lambda score: score
+
+    def delete_collection(self) -> None:
+        """
+        Just an alias for `clear`
+        (to better align with other VectorStore implementations).
+        """
+        self.clear()
+
+    def clear(self) -> None:
+        """Empty the table."""
+        self.table.clear()
+
+    def delete_by_document_id(self, document_id: str) -> None:
+        return self.table.delete(row_id=document_id)
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        """Delete by vector IDs.
+
+
+        Args:
+            ids: List of ids to delete.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+
+        if ids is None:
+            raise ValueError("No ids provided to delete.")
+
+        for document_id in ids:
+            self.delete_by_document_id(document_id)
+        return True
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        batch_size: int = 16,
+        ttl_seconds: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Texts to add to the vectorstore.
+            metadatas: Optional list of metadatas.
+            ids: Optional list of IDs.
+            batch_size: Number of concurrent requests to send to the server.
+            ttl_seconds: Optional time-to-live for the added texts.
+
+        Returns:
+            List[str]: List of IDs of the added texts.
+        """
+        _texts = list(texts)  # lest it be a generator or something
+        if ids is None:
+            ids = [uuid.uuid4().hex for _ in _texts]
+        if metadatas is None:
+            metadatas = [{} for _ in _texts]
+        #
+        ttl_seconds = ttl_seconds or self.ttl_seconds
+        #
+        embedding_vectors = self.embedding.embed_documents(_texts)
+        #
+        for i in range(0, len(_texts), batch_size):
+            batch_texts = _texts[i : i + batch_size]
+            batch_embedding_vectors = embedding_vectors[i : i + batch_size]
+            batch_ids = ids[i : i + batch_size]
+            batch_metadatas = metadatas[i : i + batch_size]
+
+            futures = [
+                self.table.put_async(
+                    row_id=text_id,
+                    body_blob=text,
+                    vector=embedding_vector,
+                    metadata=metadata or {},
+                    ttl_seconds=ttl_seconds,
+                )
+                for text, embedding_vector, text_id, metadata in zip(
+                    batch_texts, batch_embedding_vectors, batch_ids, batch_metadatas
+                )
+            ]
+            for future in futures:
+                future.result()
+        return ids
+
+    # id-returning search facilities
+    def similarity_search_with_score_id_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, str]] = None,
+        body_search: Optional[Union[str, List[str]]] = None,
+    ) -> List[Tuple[Document, float, str]]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+            body_search: Document textual search terms to apply.
+                Only supported by Astra DB at the moment.
+        Returns:
+            List of (Document, score, id), the most similar to the query vector.
+        """
+        kwargs: Dict[str, Any] = {}
+        if filter is not None:
+            kwargs["metadata"] = filter
+        if body_search is not None:
+            kwargs["body_search"] = body_search
+        #
+        hits = self.table.metric_ann_search(
+            vector=embedding,
+            n=k,
+            metric="cos",
+            **kwargs,
+        )
+        # We stick to 'cos' distance as it can be normalized on a 0-1 axis
+        # (1=most relevant), as required by this class' contract.
+        return [
+            (
+                Document(
+                    page_content=hit["body_blob"],
+                    metadata=hit["metadata"],
+                ),
+                0.5 + 0.5 * hit["distance"],
+                hit["row_id"],
+            )
+            for hit in hits
+        ]
+
+    def similarity_search_with_score_id(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, str]] = None,
+        body_search: Optional[Union[str, List[str]]] = None,
+    ) -> List[Tuple[Document, float, str]]:
+        embedding_vector = self.embedding.embed_query(query)
+        return self.similarity_search_with_score_id_by_vector(
+            embedding=embedding_vector,
+            k=k,
+            filter=filter,
+            body_search=body_search,
+        )
+
+    # id-unaware search facilities
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, str]] = None,
+        body_search: Optional[Union[str, List[str]]] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter on the metadata to apply.
+            body_search: Document textual search terms to apply.
+                Only supported by Astra DB at the moment.
+        Returns:
+            List of (Document, score), the most similar to the query vector.
+        """
+        return [
+            (doc, score)
+            for (doc, score, docId) in self.similarity_search_with_score_id_by_vector(
+                embedding=embedding,
+                k=k,
+                filter=filter,
+                body_search=body_search,
+            )
+        ]
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, str]] = None,
+        body_search: Optional[Union[str, List[str]]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        embedding_vector = self.embedding.embed_query(query)
+        return self.similarity_search_by_vector(
+            embedding_vector,
+            k,
+            filter=filter,
+            body_search=body_search,
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, str]] = None,
+        body_search: Optional[Union[str, List[str]]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        return [
+            doc
+            for doc, _ in self.similarity_search_with_score_by_vector(
+                embedding,
+                k,
+                filter=filter,
+                body_search=body_search,
+            )
+        ]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, str]] = None,
+        body_search: Optional[Union[str, List[str]]] = None,
+    ) -> List[Tuple[Document, float]]:
+        embedding_vector = self.embedding.embed_query(query)
+        return self.similarity_search_with_score_by_vector(
+            embedding_vector,
+            k,
+            filter=filter,
+            body_search=body_search,
+        )
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        body_search: Optional[Union[str, List[str]]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding to maximum
+                diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter: Filter on the metadata to apply.
+            body_search: Document textual search terms to apply.
+                Only supported by Astra DB at the moment.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        _kwargs: Dict[str, Any] = {}
+        if filter is not None:
+            _kwargs["metadata"] = filter
+        if body_search is not None:
+            _kwargs["body_search"] = body_search
+
+        prefetch_hits = list(
+            self.table.metric_ann_search(
+                vector=embedding,
+                n=fetch_k,
+                metric="cos",
+                **_kwargs,
+            )
+        )
+        # let the mmr utility pick the *indices* in the above array
+        mmr_chosen_indices = maximal_marginal_relevance(
+            np.array(embedding, dtype=np.float32),
+            [pf_hit["vector"] for pf_hit in prefetch_hits],
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+        mmr_hits = [
+            pf_hit
+            for pf_index, pf_hit in enumerate(prefetch_hits)
+            if pf_index in mmr_chosen_indices
+        ]
+        return [
+            Document(
+                page_content=hit["body_blob"],
+                metadata=hit["metadata"],
+            )
+            for hit in mmr_hits
+        ]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        body_search: Optional[Union[str, List[str]]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding to maximum
+                diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter: Filter on the metadata to apply.
+            body_search: Document textual search terms to apply.
+                Only supported by Astra DB at the moment.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        embedding_vector = self.embedding.embed_query(query)
+        return self.max_marginal_relevance_search_by_vector(
+            embedding_vector,
+            k,
+            fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            body_search=body_search,
+        )
+
+    @classmethod
+    def from_texts(
+        cls: Type[CVST],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        *,
+        session: Session = _NOT_SET,
+        keyspace: str = "",
+        table_name: str = "",
+        ids: Optional[List[str]] = None,
+        batch_size: int = 16,
+        ttl_seconds: Optional[int] = None,
+        body_index_options: Optional[List[Tuple[str, Any]]] = None,
+        **kwargs: Any,
+    ) -> CVST:
+        """Create a Cassandra vectorstore from raw texts.
+
+        Args:
+            texts: Texts to add to the vectorstore.
+            embedding: Embedding function to use.
+            metadatas: Optional list of metadatas associated with the texts.
+            session: Cassandra driver session (required).
+            keyspace: Cassandra key space (required).
+            table_name: Cassandra table (required).
+            ids: Optional list of IDs associated with the texts.
+            batch_size: Number of concurrent requests to send to the server.
+                Defaults to 16.
+            ttl_seconds: Optional time-to-live for the added texts.
+            body_index_options: Optional options used to create the body index.
+                Eg. body_index_options = [cassio.table.cql.STANDARD_ANALYZER]
+
+        Returns:
+            a Cassandra vectorstore.
+        """
+        if session is _NOT_SET:
+            raise ValueError("session parameter is required")
+        if not keyspace:
+            raise ValueError("keyspace parameter is required")
+        if not table_name:
+            raise ValueError("table_name parameter is required")
+        store = cls(
+            embedding=embedding,
+            session=session,
+            keyspace=keyspace,
+            table_name=table_name,
+            ttl_seconds=ttl_seconds,
+            body_index_options=body_index_options,
+        )
+        store.add_texts(
+            texts=texts, metadatas=metadatas, ids=ids, batch_size=batch_size
+        )
+        return store
+
+    @classmethod
+    def from_documents(
+        cls: Type[CVST],
+        documents: List[Document],
+        embedding: Embeddings,
+        *,
+        session: Session = _NOT_SET,
+        keyspace: str = "",
+        table_name: str = "",
+        ids: Optional[List[str]] = None,
+        batch_size: int = 16,
+        ttl_seconds: Optional[int] = None,
+        body_index_options: Optional[List[Tuple[str, Any]]] = None,
+        **kwargs: Any,
+    ) -> CVST:
+        """Create a Cassandra vectorstore from a document list.
+
+        Args:
+            documents: Documents to add to the vectorstore.
+            embedding: Embedding function to use.
+            session: Cassandra driver session (required).
+            keyspace: Cassandra key space (required).
+            table_name: Cassandra table (required).
+            ids: Optional list of IDs associated with the documents.
+            batch_size: Number of concurrent requests to send to the server.
+                Defaults to 16.
+            ttl_seconds: Optional time-to-live for the added documents.
+            body_index_options: Optional options used to create the body index.
+                Eg. body_index_options = [cassio.table.cql.STANDARD_ANALYZER]
+
+        Returns:
+            a Cassandra vectorstore.
+        """
+        texts = [doc.page_content for doc in documents]
+        metadatas = [doc.metadata for doc in documents]
+        return cls.from_texts(
+            texts=texts,
+            embedding=embedding,
+            metadatas=metadatas,
+            session=session,
+            keyspace=keyspace,
+            table_name=table_name,
+            ids=ids,
+            batch_size=batch_size,
+            ttl_seconds=ttl_seconds,
+            body_index_options=body_index_options,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/chroma.py b/llm/Lib/site-packages/langchain_community/vectorstores/chroma.py
new file mode 100644
index 0000000000000000000000000000000000000000..7723285fafa6c70eb662f6bf860f8e67e388318a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/chroma.py
@@ -0,0 +1,801 @@
+from __future__ import annotations
+
+import base64
+import logging
+import uuid
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+)
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import xor_args
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+if TYPE_CHECKING:
+    import chromadb
+    import chromadb.config
+    from chromadb.api.types import ID, OneOrMany, Where, WhereDocument
+
+logger = logging.getLogger()
+DEFAULT_K = 4  # Number of Documents to return.
+
+
+def _results_to_docs(results: Any) -> List[Document]:
+    return [doc for doc, _ in _results_to_docs_and_scores(results)]
+
+
+def _results_to_docs_and_scores(results: Any) -> List[Tuple[Document, float]]:
+    return [
+        # TODO: Chroma can do batch querying,
+        # we shouldn't hard code to the 1st result
+        (Document(page_content=result[0], metadata=result[1] or {}), result[2])
+        for result in zip(
+            results["documents"][0],
+            results["metadatas"][0],
+            results["distances"][0],
+        )
+    ]
+
+
+class Chroma(VectorStore):
+    """`ChromaDB` vector store.
+
+    To use, you should have the ``chromadb`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+                from langchain_community.vectorstores import Chroma
+                from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+                embeddings = OpenAIEmbeddings()
+                vectorstore = Chroma("langchain_store", embeddings)
+    """
+
+    _LANGCHAIN_DEFAULT_COLLECTION_NAME = "langchain"
+
+    def __init__(
+        self,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        embedding_function: Optional[Embeddings] = None,
+        persist_directory: Optional[str] = None,
+        client_settings: Optional[chromadb.config.Settings] = None,
+        collection_metadata: Optional[Dict] = None,
+        client: Optional[chromadb.Client] = None,
+        relevance_score_fn: Optional[Callable[[float], float]] = None,
+    ) -> None:
+        """Initialize with a Chroma client."""
+        try:
+            import chromadb
+            import chromadb.config
+        except ImportError:
+            raise ImportError(
+                "Could not import chromadb python package. "
+                "Please install it with `pip install chromadb`."
+            )
+
+        if client is not None:
+            self._client_settings = client_settings
+            self._client = client
+            self._persist_directory = persist_directory
+        else:
+            if client_settings:
+                # If client_settings is provided with persist_directory specified,
+                # then it is "in-memory and persisting to disk" mode.
+                client_settings.persist_directory = (
+                    persist_directory or client_settings.persist_directory
+                )
+                if client_settings.persist_directory is not None:
+                    # Maintain backwards compatibility with chromadb < 0.4.0
+                    major, minor, _ = chromadb.__version__.split(".")
+                    if int(major) == 0 and int(minor) < 4:
+                        client_settings.chroma_db_impl = "duckdb+parquet"
+
+                _client_settings = client_settings
+            elif persist_directory:
+                # Maintain backwards compatibility with chromadb < 0.4.0
+                major, minor, _ = chromadb.__version__.split(".")
+                if int(major) == 0 and int(minor) < 4:
+                    _client_settings = chromadb.config.Settings(
+                        chroma_db_impl="duckdb+parquet",
+                    )
+                else:
+                    _client_settings = chromadb.config.Settings(is_persistent=True)
+                _client_settings.persist_directory = persist_directory
+            else:
+                _client_settings = chromadb.config.Settings()
+            self._client_settings = _client_settings
+            self._client = chromadb.Client(_client_settings)
+            self._persist_directory = (
+                _client_settings.persist_directory or persist_directory
+            )
+
+        self._embedding_function = embedding_function
+        self._collection = self._client.get_or_create_collection(
+            name=collection_name,
+            embedding_function=None,
+            metadata=collection_metadata,
+        )
+        self.override_relevance_score_fn = relevance_score_fn
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self._embedding_function
+
+    @xor_args(("query_texts", "query_embeddings"))
+    def __query_collection(
+        self,
+        query_texts: Optional[List[str]] = None,
+        query_embeddings: Optional[List[List[float]]] = None,
+        n_results: int = 4,
+        where: Optional[Dict[str, str]] = None,
+        where_document: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Query the chroma collection."""
+        try:
+            import chromadb  # noqa: F401
+        except ImportError:
+            raise ValueError(
+                "Could not import chromadb python package. "
+                "Please install it with `pip install chromadb`."
+            )
+        return self._collection.query(
+            query_texts=query_texts,
+            query_embeddings=query_embeddings,
+            n_results=n_results,
+            where=where,
+            where_document=where_document,
+            **kwargs,
+        )
+
+    def encode_image(self, uri: str) -> str:
+        """Get base64 string from image URI."""
+        with open(uri, "rb") as image_file:
+            return base64.b64encode(image_file.read()).decode("utf-8")
+
+    def add_images(
+        self,
+        uris: List[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more images through the embeddings and add to the vectorstore.
+
+        Args:
+            uris List[str]: File path to the image.
+            metadatas (Optional[List[dict]], optional): Optional list of metadatas.
+            ids (Optional[List[str]], optional): Optional list of IDs.
+
+        Returns:
+            List[str]: List of IDs of the added images.
+        """
+        # Map from uris to b64 encoded strings
+        b64_texts = [self.encode_image(uri=uri) for uri in uris]
+        # Populate IDs
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in uris]
+        embeddings = None
+        # Set embeddings
+        if self._embedding_function is not None and hasattr(
+            self._embedding_function, "embed_image"
+        ):
+            embeddings = self._embedding_function.embed_image(uris=uris)
+        if metadatas:
+            # fill metadatas with empty dicts if somebody
+            # did not specify metadata for all images
+            length_diff = len(uris) - len(metadatas)
+            if length_diff:
+                metadatas = metadatas + [{}] * length_diff
+            empty_ids = []
+            non_empty_ids = []
+            for idx, m in enumerate(metadatas):
+                if m:
+                    non_empty_ids.append(idx)
+                else:
+                    empty_ids.append(idx)
+            if non_empty_ids:
+                metadatas = [metadatas[idx] for idx in non_empty_ids]
+                images_with_metadatas = [b64_texts[idx] for idx in non_empty_ids]
+                embeddings_with_metadatas = (
+                    [embeddings[idx] for idx in non_empty_ids] if embeddings else None
+                )
+                ids_with_metadata = [ids[idx] for idx in non_empty_ids]
+                try:
+                    self._collection.upsert(
+                        metadatas=metadatas,
+                        embeddings=embeddings_with_metadatas,
+                        documents=images_with_metadatas,
+                        ids=ids_with_metadata,
+                    )
+                except ValueError as e:
+                    if "Expected metadata value to be" in str(e):
+                        msg = (
+                            "Try filtering complex metadata using "
+                            "langchain_community.vectorstores.utils.filter_complex_metadata."
+                        )
+                        raise ValueError(e.args[0] + "\n\n" + msg)
+                    else:
+                        raise e
+            if empty_ids:
+                images_without_metadatas = [b64_texts[j] for j in empty_ids]
+                embeddings_without_metadatas = (
+                    [embeddings[j] for j in empty_ids] if embeddings else None
+                )
+                ids_without_metadatas = [ids[j] for j in empty_ids]
+                self._collection.upsert(
+                    embeddings=embeddings_without_metadatas,
+                    documents=images_without_metadatas,
+                    ids=ids_without_metadatas,
+                )
+        else:
+            self._collection.upsert(
+                embeddings=embeddings,
+                documents=b64_texts,
+                ids=ids,
+            )
+        return ids
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts (Iterable[str]): Texts to add to the vectorstore.
+            metadatas (Optional[List[dict]], optional): Optional list of metadatas.
+            ids (Optional[List[str]], optional): Optional list of IDs.
+
+        Returns:
+            List[str]: List of IDs of the added texts.
+        """
+        # TODO: Handle the case where the user doesn't provide ids on the Collection
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+        embeddings = None
+        texts = list(texts)
+        if self._embedding_function is not None:
+            embeddings = self._embedding_function.embed_documents(texts)
+        if metadatas:
+            # fill metadatas with empty dicts if somebody
+            # did not specify metadata for all texts
+            length_diff = len(texts) - len(metadatas)
+            if length_diff:
+                metadatas = metadatas + [{}] * length_diff
+            empty_ids = []
+            non_empty_ids = []
+            for idx, m in enumerate(metadatas):
+                if m:
+                    non_empty_ids.append(idx)
+                else:
+                    empty_ids.append(idx)
+            if non_empty_ids:
+                metadatas = [metadatas[idx] for idx in non_empty_ids]
+                texts_with_metadatas = [texts[idx] for idx in non_empty_ids]
+                embeddings_with_metadatas = (
+                    [embeddings[idx] for idx in non_empty_ids] if embeddings else None
+                )
+                ids_with_metadata = [ids[idx] for idx in non_empty_ids]
+                try:
+                    self._collection.upsert(
+                        metadatas=metadatas,
+                        embeddings=embeddings_with_metadatas,
+                        documents=texts_with_metadatas,
+                        ids=ids_with_metadata,
+                    )
+                except ValueError as e:
+                    if "Expected metadata value to be" in str(e):
+                        msg = (
+                            "Try filtering complex metadata from the document using "
+                            "langchain_community.vectorstores.utils.filter_complex_metadata."
+                        )
+                        raise ValueError(e.args[0] + "\n\n" + msg)
+                    else:
+                        raise e
+            if empty_ids:
+                texts_without_metadatas = [texts[j] for j in empty_ids]
+                embeddings_without_metadatas = (
+                    [embeddings[j] for j in empty_ids] if embeddings else None
+                )
+                ids_without_metadatas = [ids[j] for j in empty_ids]
+                self._collection.upsert(
+                    embeddings=embeddings_without_metadatas,
+                    documents=texts_without_metadatas,
+                    ids=ids_without_metadatas,
+                )
+        else:
+            self._collection.upsert(
+                embeddings=embeddings,
+                documents=texts,
+                ids=ids,
+            )
+        return ids
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = DEFAULT_K,
+        filter: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search with Chroma.
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Document]: List of documents most similar to the query text.
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query, k, filter=filter, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_K,
+        filter: Optional[Dict[str, str]] = None,
+        where_document: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+        Args:
+            embedding (List[float]): Embedding to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        results = self.__query_collection(
+            query_embeddings=embedding,
+            n_results=k,
+            where=filter,
+            where_document=where_document,
+            **kwargs,
+        )
+        return _results_to_docs(results)
+
+    def similarity_search_by_vector_with_relevance_scores(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_K,
+        filter: Optional[Dict[str, str]] = None,
+        where_document: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """
+        Return docs most similar to embedding vector and similarity score.
+
+        Args:
+            embedding (List[float]): Embedding to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Tuple[Document, float]]: List of documents most similar to
+            the query text and cosine distance in float for each.
+            Lower score represents more similarity.
+        """
+        results = self.__query_collection(
+            query_embeddings=embedding,
+            n_results=k,
+            where=filter,
+            where_document=where_document,
+            **kwargs,
+        )
+        return _results_to_docs_and_scores(results)
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = DEFAULT_K,
+        filter: Optional[Dict[str, str]] = None,
+        where_document: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search with Chroma with distance.
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Tuple[Document, float]]: List of documents most similar to
+            the query text and cosine distance in float for each.
+            Lower score represents more similarity.
+        """
+        if self._embedding_function is None:
+            results = self.__query_collection(
+                query_texts=[query],
+                n_results=k,
+                where=filter,
+                where_document=where_document,
+                **kwargs,
+            )
+        else:
+            query_embedding = self._embedding_function.embed_query(query)
+            results = self.__query_collection(
+                query_embeddings=[query_embedding],
+                n_results=k,
+                where=filter,
+                where_document=where_document,
+                **kwargs,
+            )
+
+        return _results_to_docs_and_scores(results)
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+        """
+        if self.override_relevance_score_fn:
+            return self.override_relevance_score_fn
+
+        distance = "l2"
+        distance_key = "hnsw:space"
+        metadata = self._collection.metadata
+
+        if metadata and distance_key in metadata:
+            distance = metadata[distance_key]
+
+        if distance == "cosine":
+            return self._cosine_relevance_score_fn
+        elif distance == "l2":
+            return self._euclidean_relevance_score_fn
+        elif distance == "ip":
+            return self._max_inner_product_relevance_score_fn
+        else:
+            raise ValueError(
+                "No supported normalization function"
+                f" for distance metric of type: {distance}."
+                "Consider providing relevance_score_fn to Chroma constructor."
+            )
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_K,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        where_document: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+
+        results = self.__query_collection(
+            query_embeddings=embedding,
+            n_results=fetch_k,
+            where=filter,
+            where_document=where_document,
+            include=["metadatas", "documents", "distances", "embeddings"],
+            **kwargs,
+        )
+        mmr_selected = maximal_marginal_relevance(
+            np.array(embedding, dtype=np.float32),
+            results["embeddings"][0],
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+
+        candidates = _results_to_docs(results)
+
+        selected_results = [r for i, r in enumerate(candidates) if i in mmr_selected]
+        return selected_results
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = DEFAULT_K,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        where_document: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        if self._embedding_function is None:
+            raise ValueError(
+                "For MMR search, you must specify an embedding function on" "creation."
+            )
+
+        embedding = self._embedding_function.embed_query(query)
+        docs = self.max_marginal_relevance_search_by_vector(
+            embedding,
+            k,
+            fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            where_document=where_document,
+        )
+        return docs
+
+    def delete_collection(self) -> None:
+        """Delete the collection."""
+        self._client.delete_collection(self._collection.name)
+
+    def get(
+        self,
+        ids: Optional[OneOrMany[ID]] = None,
+        where: Optional[Where] = None,
+        limit: Optional[int] = None,
+        offset: Optional[int] = None,
+        where_document: Optional[WhereDocument] = None,
+        include: Optional[List[str]] = None,
+    ) -> Dict[str, Any]:
+        """Gets the collection.
+
+        Args:
+            ids: The ids of the embeddings to get. Optional.
+            where: A Where type dict used to filter results by.
+                   E.g. `{"color" : "red", "price": 4.20}`. Optional.
+            limit: The number of documents to return. Optional.
+            offset: The offset to start returning results from.
+                    Useful for paging results with limit. Optional.
+            where_document: A WhereDocument type dict used to filter by the documents.
+                            E.g. `{$contains: "hello"}`. Optional.
+            include: A list of what to include in the results.
+                     Can contain `"embeddings"`, `"metadatas"`, `"documents"`.
+                     Ids are always included.
+                     Defaults to `["metadatas", "documents"]`. Optional.
+        """
+        kwargs = {
+            "ids": ids,
+            "where": where,
+            "limit": limit,
+            "offset": offset,
+            "where_document": where_document,
+        }
+
+        if include is not None:
+            kwargs["include"] = include
+
+        return self._collection.get(**kwargs)
+
+    def persist(self) -> None:
+        """Persist the collection.
+
+        This can be used to explicitly persist the data to disk.
+        It will also be called automatically when the object is destroyed.
+        """
+        if self._persist_directory is None:
+            raise ValueError(
+                "You must specify a persist_directory on"
+                "creation to persist the collection."
+            )
+        import chromadb
+
+        # Maintain backwards compatibility with chromadb < 0.4.0
+        major, minor, _ = chromadb.__version__.split(".")
+        if int(major) == 0 and int(minor) < 4:
+            self._client.persist()
+
+    def update_document(self, document_id: str, document: Document) -> None:
+        """Update a document in the collection.
+
+        Args:
+            document_id (str): ID of the document to update.
+            document (Document): Document to update.
+        """
+        return self.update_documents([document_id], [document])
+
+    def update_documents(self, ids: List[str], documents: List[Document]) -> None:
+        """Update a document in the collection.
+
+        Args:
+            ids (List[str]): List of ids of the document to update.
+            documents (List[Document]): List of documents to update.
+        """
+        text = [document.page_content for document in documents]
+        metadata = [document.metadata for document in documents]
+        if self._embedding_function is None:
+            raise ValueError(
+                "For update, you must specify an embedding function on creation."
+            )
+        embeddings = self._embedding_function.embed_documents(text)
+
+        if hasattr(
+            self._collection._client, "max_batch_size"
+        ):  # for Chroma 0.4.10 and above
+            from chromadb.utils.batch_utils import create_batches
+
+            for batch in create_batches(
+                api=self._collection._client,
+                ids=ids,
+                metadatas=metadata,
+                documents=text,
+                embeddings=embeddings,
+            ):
+                self._collection.update(
+                    ids=batch[0],
+                    embeddings=batch[1],
+                    documents=batch[3],
+                    metadatas=batch[2],
+                )
+        else:
+            self._collection.update(
+                ids=ids,
+                embeddings=embeddings,
+                documents=text,
+                metadatas=metadata,
+            )
+
+    @classmethod
+    def from_texts(
+        cls: Type[Chroma],
+        texts: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        persist_directory: Optional[str] = None,
+        client_settings: Optional[chromadb.config.Settings] = None,
+        client: Optional[chromadb.Client] = None,
+        collection_metadata: Optional[Dict] = None,
+        **kwargs: Any,
+    ) -> Chroma:
+        """Create a Chroma vectorstore from a raw documents.
+
+        If a persist_directory is specified, the collection will be persisted there.
+        Otherwise, the data will be ephemeral in-memory.
+
+        Args:
+            texts (List[str]): List of texts to add to the collection.
+            collection_name (str): Name of the collection to create.
+            persist_directory (Optional[str]): Directory to persist the collection.
+            embedding (Optional[Embeddings]): Embedding function. Defaults to None.
+            metadatas (Optional[List[dict]]): List of metadatas. Defaults to None.
+            ids (Optional[List[str]]): List of document IDs. Defaults to None.
+            client_settings (Optional[chromadb.config.Settings]): Chroma client settings
+            collection_metadata (Optional[Dict]): Collection configurations.
+                                                  Defaults to None.
+
+        Returns:
+            Chroma: Chroma vectorstore.
+        """
+        chroma_collection = cls(
+            collection_name=collection_name,
+            embedding_function=embedding,
+            persist_directory=persist_directory,
+            client_settings=client_settings,
+            client=client,
+            collection_metadata=collection_metadata,
+            **kwargs,
+        )
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+        if hasattr(
+            chroma_collection._client, "max_batch_size"
+        ):  # for Chroma 0.4.10 and above
+            from chromadb.utils.batch_utils import create_batches
+
+            for batch in create_batches(
+                api=chroma_collection._client,
+                ids=ids,
+                metadatas=metadatas,
+                documents=texts,
+            ):
+                chroma_collection.add_texts(
+                    texts=batch[3] if batch[3] else [],
+                    metadatas=batch[2] if batch[2] else None,
+                    ids=batch[0],
+                )
+        else:
+            chroma_collection.add_texts(texts=texts, metadatas=metadatas, ids=ids)
+        return chroma_collection
+
+    @classmethod
+    def from_documents(
+        cls: Type[Chroma],
+        documents: List[Document],
+        embedding: Optional[Embeddings] = None,
+        ids: Optional[List[str]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        persist_directory: Optional[str] = None,
+        client_settings: Optional[chromadb.config.Settings] = None,
+        client: Optional[chromadb.Client] = None,  # Add this line
+        collection_metadata: Optional[Dict] = None,
+        **kwargs: Any,
+    ) -> Chroma:
+        """Create a Chroma vectorstore from a list of documents.
+
+        If a persist_directory is specified, the collection will be persisted there.
+        Otherwise, the data will be ephemeral in-memory.
+
+        Args:
+            collection_name (str): Name of the collection to create.
+            persist_directory (Optional[str]): Directory to persist the collection.
+            ids (Optional[List[str]]): List of document IDs. Defaults to None.
+            documents (List[Document]): List of documents to add to the vectorstore.
+            embedding (Optional[Embeddings]): Embedding function. Defaults to None.
+            client_settings (Optional[chromadb.config.Settings]): Chroma client settings
+            collection_metadata (Optional[Dict]): Collection configurations.
+                                                  Defaults to None.
+
+        Returns:
+            Chroma: Chroma vectorstore.
+        """
+        texts = [doc.page_content for doc in documents]
+        metadatas = [doc.metadata for doc in documents]
+        return cls.from_texts(
+            texts=texts,
+            embedding=embedding,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            persist_directory=persist_directory,
+            client_settings=client_settings,
+            client=client,
+            collection_metadata=collection_metadata,
+            **kwargs,
+        )
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> None:
+        """Delete by vector IDs.
+
+        Args:
+            ids: List of ids to delete.
+        """
+        self._collection.delete(ids=ids)
+
+    def __len__(self) -> int:
+        """Count the number of documents in the collection."""
+        return self._collection.count()
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/clarifai.py b/llm/Lib/site-packages/langchain_community/vectorstores/clarifai.py
new file mode 100644
index 0000000000000000000000000000000000000000..34ff88421cc4cd121a160e07a35953cd91199b06
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/clarifai.py
@@ -0,0 +1,329 @@
+from __future__ import annotations
+
+import logging
+import os
+import traceback
+import uuid
+from concurrent.futures import ThreadPoolExecutor
+from typing import Any, Iterable, List, Optional, Tuple
+
+import requests
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+logger = logging.getLogger(__name__)
+
+
+class Clarifai(VectorStore):
+    """`Clarifai AI` vector store.
+
+    To use, you should have the ``clarifai`` python SDK package installed.
+
+    Example:
+        .. code-block:: python
+
+                from langchain_community.vectorstores import Clarifai
+
+                clarifai_vector_db = Clarifai(
+                        user_id=USER_ID,
+                        app_id=APP_ID,
+                        number_of_docs=NUMBER_OF_DOCS,
+                        )
+    """
+
+    def __init__(
+        self,
+        user_id: Optional[str] = None,
+        app_id: Optional[str] = None,
+        number_of_docs: Optional[int] = 4,
+        pat: Optional[str] = None,
+        token: Optional[str] = None,
+        api_base: Optional[str] = "https://api.clarifai.com",
+    ) -> None:
+        """Initialize with Clarifai client.
+
+        Args:
+            user_id (Optional[str], optional): User ID. Defaults to None.
+            app_id (Optional[str], optional): App ID. Defaults to None.
+            pat (Optional[str], optional): Personal access token. Defaults to None.
+            token (Optional[str], optional): Session token. Defaults to None.
+            number_of_docs (Optional[int], optional): Number of documents to return
+            during vector search. Defaults to None.
+            api_base (Optional[str], optional): API base. Defaults to None.
+
+        Raises:
+            ValueError: If user ID, app ID or personal access token is not provided.
+        """
+        _user_id = user_id or os.environ.get("CLARIFAI_USER_ID")
+        _app_id = app_id or os.environ.get("CLARIFAI_APP_ID")
+        if _user_id is None or _app_id is None:
+            raise ValueError(
+                "Could not find CLARIFAI_USER_ID "
+                "or CLARIFAI_APP_ID in your environment. "
+                "Please set those env variables with a valid user ID, app ID"
+            )
+        self._number_of_docs = number_of_docs
+
+        try:
+            from clarifai.client.search import Search
+        except ImportError as e:
+            raise ImportError(
+                "Could not import clarifai python package. "
+                "Please install it with `pip install clarifai`."
+            ) from e
+
+        self._auth = Search(
+            user_id=_user_id,
+            app_id=_app_id,
+            top_k=number_of_docs,
+            pat=pat,
+            token=token,
+            base_url=api_base,
+        ).auth_helper
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add texts to the Clarifai vectorstore. This will push the text
+        to a Clarifai application.
+        Application use a base workflow that create and store embedding for each text.
+        Make sure you are using a base workflow that is compatible with text
+        (such as Language Understanding).
+
+        Args:
+            texts (Iterable[str]): Texts to add to the vectorstore.
+            metadatas (Optional[List[dict]], optional): Optional list of metadatas.
+            ids (Optional[List[str]], optional): Optional list of IDs.
+
+        """
+        try:
+            from clarifai.client.input import Inputs
+            from google.protobuf.struct_pb2 import Struct
+        except ImportError as e:
+            raise ImportError(
+                "Could not import clarifai python package. "
+                "Please install it with `pip install clarifai`."
+            ) from e
+
+        ltexts = list(texts)
+        length = len(ltexts)
+        assert length > 0, "No texts provided to add to the vectorstore."
+
+        if metadatas is not None:
+            assert length == len(
+                metadatas
+            ), "Number of texts and metadatas should be the same."
+
+        if ids is not None:
+            assert len(ltexts) == len(
+                ids
+            ), "Number of text inputs and input ids should be the same."
+
+        input_obj = Inputs.from_auth_helper(auth=self._auth)
+        batch_size = 32
+        input_job_ids = []
+        for idx in range(0, length, batch_size):
+            try:
+                batch_texts = ltexts[idx : idx + batch_size]
+                batch_metadatas = (
+                    metadatas[idx : idx + batch_size] if metadatas else None
+                )
+                if ids is None:
+                    batch_ids = [uuid.uuid4().hex for _ in range(len(batch_texts))]
+                else:
+                    batch_ids = ids[idx : idx + batch_size]
+                if batch_metadatas is not None:
+                    meta_list = []
+                    for meta in batch_metadatas:
+                        meta_struct = Struct()
+                        meta_struct.update(meta)
+                        meta_list.append(meta_struct)
+                input_batch = [
+                    input_obj.get_text_input(
+                        input_id=batch_ids[i],
+                        raw_text=text,
+                        metadata=meta_list[i] if batch_metadatas else None,
+                    )
+                    for i, text in enumerate(batch_texts)
+                ]
+                result_id = input_obj.upload_inputs(inputs=input_batch)
+                input_job_ids.extend(result_id)
+                logger.debug("Input posted successfully.")
+
+            except Exception as error:
+                logger.warning(f"Post inputs failed: {error}")
+                traceback.print_exc()
+
+        return input_job_ids
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: Optional[int] = None,
+        filters: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search with score using Clarifai.
+
+        Args:
+            query (str): Query text to search for.
+            k (Optional[int]): Number of results to return. If not set,
+            it'll take _number_of_docs. Defaults to None.
+            filter (Optional[Dict[str, str]]): Filter by metadata.
+            Defaults to None.
+
+        Returns:
+            List[Document]: List of documents most similar to the query text.
+        """
+        try:
+            from clarifai.client.search import Search
+            from clarifai_grpc.grpc.api import resources_pb2
+            from google.protobuf import json_format  # type: ignore
+        except ImportError as e:
+            raise ImportError(
+                "Could not import clarifai python package. "
+                "Please install it with `pip install clarifai`."
+            ) from e
+
+        # Get number of docs to return
+        top_k = k or self._number_of_docs
+
+        search_obj = Search.from_auth_helper(auth=self._auth, top_k=top_k)
+        rank = [{"text_raw": query}]
+        # Add filter by metadata if provided.
+        if filters is not None:
+            search_metadata = {"metadata": filters}
+            search_response = search_obj.query(ranks=rank, filters=[search_metadata])
+        else:
+            search_response = search_obj.query(ranks=rank)
+
+        # Retrieve hits
+        hits = [hit for data in search_response for hit in data.hits]
+        executor = ThreadPoolExecutor(max_workers=10)
+
+        def hit_to_document(hit: resources_pb2.Hit) -> Tuple[Document, float]:
+            metadata = json_format.MessageToDict(hit.input.data.metadata)
+            h = dict(self._auth.metadata)
+            request = requests.get(hit.input.data.text.url, headers=h)
+
+            # override encoding by real educated guess as provided by chardet
+            request.encoding = request.apparent_encoding
+            requested_text = request.text
+
+            logger.debug(
+                f"\tScore {hit.score:.2f} for annotation: {hit.annotation.id}\
+                off input: {hit.input.id}, text: {requested_text[:125]}"
+            )
+            return (Document(page_content=requested_text, metadata=metadata), hit.score)
+
+        # Iterate over hits and retrieve metadata and text
+        futures = [executor.submit(hit_to_document, hit) for hit in hits]
+        docs_and_scores = [future.result() for future in futures]
+
+        return docs_and_scores
+
+    def similarity_search(
+        self,
+        query: str,
+        k: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search using Clarifai.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return.
+            If not set, it'll take _number_of_docs. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        docs_and_scores = self.similarity_search_with_score(query, k=k, **kwargs)
+        return [doc for doc, _ in docs_and_scores]
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[dict]] = None,
+        user_id: Optional[str] = None,
+        app_id: Optional[str] = None,
+        number_of_docs: Optional[int] = None,
+        pat: Optional[str] = None,
+        token: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Clarifai:
+        """Create a Clarifai vectorstore from a list of texts.
+
+        Args:
+            user_id (str): User ID.
+            app_id (str): App ID.
+            texts (List[str]): List of texts to add.
+            number_of_docs (Optional[int]): Number of documents
+            to return during vector search. Defaults to None.
+            pat (Optional[str], optional): Personal access token.
+            Defaults to None.
+            token (Optional[str], optional): Session token. Defaults to None.
+            metadatas (Optional[List[dict]]): Optional list
+            of metadatas. Defaults to None.
+            **kwargs: Additional keyword arguments to be passed to the Search.
+
+        Returns:
+            Clarifai: Clarifai vectorstore.
+        """
+        clarifai_vector_db = cls(
+            user_id=user_id,
+            app_id=app_id,
+            number_of_docs=number_of_docs,
+            pat=pat,
+            token=token,
+            **kwargs,
+        )
+        clarifai_vector_db.add_texts(texts=texts, metadatas=metadatas)
+        return clarifai_vector_db
+
+    @classmethod
+    def from_documents(
+        cls,
+        documents: List[Document],
+        embedding: Optional[Embeddings] = None,
+        user_id: Optional[str] = None,
+        app_id: Optional[str] = None,
+        number_of_docs: Optional[int] = None,
+        pat: Optional[str] = None,
+        token: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Clarifai:
+        """Create a Clarifai vectorstore from a list of documents.
+
+        Args:
+            user_id (str): User ID.
+            app_id (str): App ID.
+            documents (List[Document]): List of documents to add.
+            number_of_docs (Optional[int]): Number of documents
+            to return during vector search. Defaults to None.
+            pat (Optional[str], optional): Personal access token. Defaults to None.
+            token (Optional[str], optional): Session token. Defaults to None.
+            **kwargs: Additional keyword arguments to be passed to the Search.
+
+        Returns:
+            Clarifai: Clarifai vectorstore.
+        """
+        texts = [doc.page_content for doc in documents]
+        metadatas = [doc.metadata for doc in documents]
+        return cls.from_texts(
+            user_id=user_id,
+            app_id=app_id,
+            texts=texts,
+            number_of_docs=number_of_docs,
+            pat=pat,
+            metadatas=metadatas,
+            token=token,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/clickhouse.py b/llm/Lib/site-packages/langchain_community/vectorstores/clickhouse.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc54108454787699779a4d709888bf76e2404265
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/clickhouse.py
@@ -0,0 +1,537 @@
+from __future__ import annotations
+
+import json
+import logging
+from hashlib import sha1
+from threading import Thread
+from typing import Any, Dict, Iterable, List, Optional, Tuple, Union
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseSettings
+from langchain_core.vectorstores import VectorStore
+
+logger = logging.getLogger()
+
+
+def has_mul_sub_str(s: str, *args: Any) -> bool:
+    """
+    Check if a string contains multiple substrings.
+    Args:
+        s: string to check.
+        *args: substrings to check.
+
+    Returns:
+        True if all substrings are in the string, False otherwise.
+    """
+    for a in args:
+        if a not in s:
+            return False
+    return True
+
+
+class ClickhouseSettings(BaseSettings):
+    """`ClickHouse` client configuration.
+
+    Attribute:
+        host (str) : An URL to connect to MyScale backend.
+                             Defaults to 'localhost'.
+        port (int) : URL port to connect with HTTP. Defaults to 8443.
+        username (str) : Username to login. Defaults to None.
+        password (str) : Password to login. Defaults to None.
+        index_type (str): index type string.
+        index_param (list): index build parameter.
+        index_query_params(dict): index query parameters.
+        database (str) : Database name to find the table. Defaults to 'default'.
+        table (str) : Table name to operate on.
+                      Defaults to 'vector_table'.
+        metric (str) : Metric to compute distance,
+                       supported are ('angular', 'euclidean', 'manhattan', 'hamming',
+                       'dot'). Defaults to 'angular'.
+                       https://github.com/spotify/annoy/blob/main/src/annoymodule.cc#L149-L169
+
+        column_map (Dict) : Column type map to project column name onto langchain
+                            semantics. Must have keys: `text`, `id`, `vector`,
+                            must be same size to number of columns. For example:
+                            .. code-block:: python
+
+                                {
+                                    'id': 'text_id',
+                                    'uuid': 'global_unique_id'
+                                    'embedding': 'text_embedding',
+                                    'document': 'text_plain',
+                                    'metadata': 'metadata_dictionary_in_json',
+                                }
+
+                            Defaults to identity map.
+    """
+
+    host: str = "localhost"
+    port: int = 8123
+
+    username: Optional[str] = None
+    password: Optional[str] = None
+
+    index_type: str = "annoy"
+    # Annoy supports L2Distance and cosineDistance.
+    index_param: Optional[Union[List, Dict]] = ["'L2Distance'", 100]
+    index_query_params: Dict[str, str] = {}
+
+    column_map: Dict[str, str] = {
+        "id": "id",
+        "uuid": "uuid",
+        "document": "document",
+        "embedding": "embedding",
+        "metadata": "metadata",
+    }
+
+    database: str = "default"
+    table: str = "langchain"
+    metric: str = "angular"
+
+    def __getitem__(self, item: str) -> Any:
+        return getattr(self, item)
+
+    class Config:
+        env_file = ".env"
+        env_prefix = "clickhouse_"
+        env_file_encoding = "utf-8"
+
+
+class Clickhouse(VectorStore):
+    """`ClickHouse VectorSearch` vector store.
+
+    You need a `clickhouse-connect` python package, and a valid account
+    to connect to ClickHouse.
+
+    ClickHouse can not only search with simple vector indexes,
+    it also supports complex query with multiple conditions,
+    constraints and even sub-queries.
+
+    For more information, please visit
+        [ClickHouse official site](https://clickhouse.com/clickhouse)
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        config: Optional[ClickhouseSettings] = None,
+        **kwargs: Any,
+    ) -> None:
+        """ClickHouse Wrapper to LangChain
+
+        embedding_function (Embeddings):
+        config (ClickHouseSettings): Configuration to ClickHouse Client
+        Other keyword arguments will pass into
+            [clickhouse-connect](https://docs.clickhouse.com/)
+        """
+        try:
+            from clickhouse_connect import get_client
+        except ImportError:
+            raise ImportError(
+                "Could not import clickhouse connect python package. "
+                "Please install it with `pip install clickhouse-connect`."
+            )
+        try:
+            from tqdm import tqdm
+
+            self.pgbar = tqdm
+        except ImportError:
+            # Just in case if tqdm is not installed
+            self.pgbar = lambda x, **kwargs: x
+        super().__init__()
+        if config is not None:
+            self.config = config
+        else:
+            self.config = ClickhouseSettings()
+        assert self.config
+        assert self.config.host and self.config.port
+        assert (
+            self.config.column_map
+            and self.config.database
+            and self.config.table
+            and self.config.metric
+        )
+        for k in ["id", "embedding", "document", "metadata", "uuid"]:
+            assert k in self.config.column_map
+        assert self.config.metric in [
+            "angular",
+            "euclidean",
+            "manhattan",
+            "hamming",
+            "dot",
+        ]
+
+        # initialize the schema
+        dim = len(embedding.embed_query("test"))
+
+        index_params = (
+            (
+                ",".join([f"'{k}={v}'" for k, v in self.config.index_param.items()])
+                if self.config.index_param
+                else ""
+            )
+            if isinstance(self.config.index_param, Dict)
+            else ",".join([str(p) for p in self.config.index_param])
+            if isinstance(self.config.index_param, List)
+            else self.config.index_param
+        )
+
+        self.schema = f"""\
+CREATE TABLE IF NOT EXISTS {self.config.database}.{self.config.table}(
+    {self.config.column_map['id']} Nullable(String),
+    {self.config.column_map['document']} Nullable(String),
+    {self.config.column_map['embedding']} Array(Float32),
+    {self.config.column_map['metadata']} JSON,
+    {self.config.column_map['uuid']} UUID DEFAULT generateUUIDv4(),
+    CONSTRAINT cons_vec_len CHECK length({self.config.column_map['embedding']}) = {dim},
+    INDEX vec_idx {self.config.column_map['embedding']} TYPE \
+{self.config.index_type}({index_params}) GRANULARITY 1000
+) ENGINE = MergeTree ORDER BY uuid SETTINGS index_granularity = 8192\
+"""
+        self.dim = dim
+        self.BS = "\\"
+        self.must_escape = ("\\", "'")
+        self.embedding_function = embedding
+        self.dist_order = "ASC"  # Only support ConsingDistance and L2Distance
+
+        # Create a connection to clickhouse
+        self.client = get_client(
+            host=self.config.host,
+            port=self.config.port,
+            username=self.config.username,
+            password=self.config.password,
+            **kwargs,
+        )
+        # Enable JSON type
+        self.client.command("SET allow_experimental_object_type=1")
+        # Enable index
+        self.client.command(f"SET allow_experimental_{self.config.index_type}_index=1")
+        self.client.command(self.schema)
+
+    @property
+    def embeddings(self) -> Embeddings:
+        """Provides access to the embedding mechanism used by the Clickhouse instance.
+
+        This property allows direct access to the embedding function or model being
+        used by the Clickhouse instance to convert text documents into embedding vectors
+        for vector similarity search.
+
+        Returns:
+            The `Embeddings` instance associated with this Clickhouse instance.
+        """
+        return self.embedding_function
+
+    def escape_str(self, value: str) -> str:
+        """Escape special characters in a string for Clickhouse SQL queries.
+
+        This method is used internally to prepare strings for safe insertion
+        into SQL queries by escaping special characters that might otherwise
+        interfere with the query syntax.
+
+        Args:
+            value: The string to be escaped.
+
+        Returns:
+            The escaped string, safe for insertion into SQL queries.
+        """
+        return "".join(f"{self.BS}{c}" if c in self.must_escape else c for c in value)
+
+    def _build_insert_sql(self, transac: Iterable, column_names: Iterable[str]) -> str:
+        """Construct an SQL query for inserting data into the Clickhouse database.
+
+        This method formats and constructs an SQL `INSERT` query string using the
+        provided transaction data and column names. It is utilized internally during
+        the process of batch insertion of documents and their embeddings into the
+        database.
+
+        Args:
+            transac: iterable of tuples, representing a row of data to be inserted.
+            column_names: iterable of strings representing the names of the columns
+                into which data will be inserted.
+
+        Returns:
+            A string containing the constructed SQL `INSERT` query.
+        """
+        ks = ",".join(column_names)
+        _data = []
+        for n in transac:
+            n = ",".join([f"'{self.escape_str(str(_n))}'" for _n in n])
+            _data.append(f"({n})")
+        i_str = f"""
+                INSERT INTO TABLE 
+                    {self.config.database}.{self.config.table}({ks})
+                VALUES
+                {','.join(_data)}
+                """
+        return i_str
+
+    def _insert(self, transac: Iterable, column_names: Iterable[str]) -> None:
+        """Execute an SQL query to insert data into the Clickhouse database.
+
+        This method performs the actual insertion of data into the database by
+        executing the SQL query constructed by `_build_insert_sql`. It's a critical
+        step in adding new documents and their associated data into the vector store.
+
+        Args:
+            transac:iterable of tuples, representing a row of data to be inserted.
+            column_names: An iterable of strings representing the names of the columns
+                into which data will be inserted.
+        """
+        _insert_query = self._build_insert_sql(transac, column_names)
+        self.client.command(_insert_query)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        batch_size: int = 32,
+        ids: Optional[Iterable[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Insert more texts through the embeddings and add to the VectorStore.
+
+        Args:
+            texts: Iterable of strings to add to the VectorStore.
+            ids: Optional list of ids to associate with the texts.
+            batch_size: Batch size of insertion
+            metadata: Optional column data to be inserted
+
+        Returns:
+            List of ids from adding the texts into the VectorStore.
+
+        """
+        # Embed and create the documents
+        ids = ids or [sha1(t.encode("utf-8")).hexdigest() for t in texts]
+        colmap_ = self.config.column_map
+        transac = []
+        column_names = {
+            colmap_["id"]: ids,
+            colmap_["document"]: texts,
+            colmap_["embedding"]: self.embedding_function.embed_documents(list(texts)),
+        }
+        metadatas = metadatas or [{} for _ in texts]
+        column_names[colmap_["metadata"]] = map(json.dumps, metadatas)
+        assert len(set(colmap_) - set(column_names)) >= 0
+        keys, values = zip(*column_names.items())
+        try:
+            t = None
+            for v in self.pgbar(
+                zip(*values), desc="Inserting data...", total=len(metadatas)
+            ):
+                assert (
+                    len(v[keys.index(self.config.column_map["embedding"])]) == self.dim
+                )
+                transac.append(v)
+                if len(transac) == batch_size:
+                    if t:
+                        t.join()
+                    t = Thread(target=self._insert, args=[transac, keys])
+                    t.start()
+                    transac = []
+            if len(transac) > 0:
+                if t:
+                    t.join()
+                self._insert(transac, keys)
+            return [i for i in ids]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        config: Optional[ClickhouseSettings] = None,
+        text_ids: Optional[Iterable[str]] = None,
+        batch_size: int = 32,
+        **kwargs: Any,
+    ) -> Clickhouse:
+        """Create ClickHouse wrapper with existing texts
+
+        Args:
+            embedding_function (Embeddings): Function to extract text embedding
+            texts (Iterable[str]): List or tuple of strings to be added
+            config (ClickHouseSettings, Optional): ClickHouse configuration
+            text_ids (Optional[Iterable], optional): IDs for the texts.
+                                                     Defaults to None.
+            batch_size (int, optional): Batchsize when transmitting data to ClickHouse.
+                                        Defaults to 32.
+            metadata (List[dict], optional): metadata to texts. Defaults to None.
+            Other keyword arguments will pass into
+                [clickhouse-connect](https://clickhouse.com/docs/en/integrations/python#clickhouse-connect-driver-api)
+        Returns:
+            ClickHouse Index
+        """
+        ctx = cls(embedding, config, **kwargs)
+        ctx.add_texts(texts, ids=text_ids, batch_size=batch_size, metadatas=metadatas)
+        return ctx
+
+    def __repr__(self) -> str:
+        """Text representation for ClickHouse Vector Store, prints backends, username
+            and schemas. Easy to use with `str(ClickHouse())`
+
+        Returns:
+            repr: string to show connection info and data schema
+        """
+        _repr = f"\033[92m\033[1m{self.config.database}.{self.config.table} @ "
+        _repr += f"{self.config.host}:{self.config.port}\033[0m\n\n"
+        _repr += f"\033[1musername: {self.config.username}\033[0m\n\nTable Schema:\n"
+        _repr += "-" * 51 + "\n"
+        for r in self.client.query(
+            f"DESC {self.config.database}.{self.config.table}"
+        ).named_results():
+            _repr += (
+                f"|\033[94m{r['name']:24s}\033[0m|\033[96m{r['type']:24s}\033[0m|\n"
+            )
+        _repr += "-" * 51 + "\n"
+        return _repr
+
+    def _build_query_sql(
+        self, q_emb: List[float], topk: int, where_str: Optional[str] = None
+    ) -> str:
+        """Construct an SQL query for performing a similarity search.
+
+        This internal method generates an SQL query for finding the top-k most similar
+        vectors in the database to a given query vector.It allows for optional filtering
+        conditions to be applied via a WHERE clause.
+
+        Args:
+            q_emb: The query vector as a list of floats.
+            topk: The number of top similar items to retrieve.
+            where_str: opt str representing additional WHERE conditions for the query
+                Defaults to None.
+
+        Returns:
+            A string containing the SQL query for the similarity search.
+        """
+        q_emb_str = ",".join(map(str, q_emb))
+        if where_str:
+            where_str = f"PREWHERE {where_str}"
+        else:
+            where_str = ""
+
+        settings_strs = []
+        if self.config.index_query_params:
+            for k in self.config.index_query_params:
+                settings_strs.append(f"SETTING {k}={self.config.index_query_params[k]}")
+        q_str = f"""
+            SELECT {self.config.column_map['document']}, 
+                {self.config.column_map['metadata']}, dist
+            FROM {self.config.database}.{self.config.table}
+            {where_str}
+            ORDER BY L2Distance({self.config.column_map['embedding']}, [{q_emb_str}]) 
+                AS dist {self.dist_order}
+            LIMIT {topk} {' '.join(settings_strs)}
+            """
+        return q_str
+
+    def similarity_search(
+        self, query: str, k: int = 4, where_str: Optional[str] = None, **kwargs: Any
+    ) -> List[Document]:
+        """Perform a similarity search with ClickHouse
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of Documents
+        """
+        return self.similarity_search_by_vector(
+            self.embedding_function.embed_query(query), k, where_str, **kwargs
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        where_str: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a similarity search with ClickHouse by vectors
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of documents
+        """
+        q_str = self._build_query_sql(embedding, k, where_str)
+        try:
+            return [
+                Document(
+                    page_content=r[self.config.column_map["document"]],
+                    metadata=r[self.config.column_map["metadata"]],
+                )
+                for r in self.client.query(q_str).named_results()
+            ]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    def similarity_search_with_relevance_scores(
+        self, query: str, k: int = 4, where_str: Optional[str] = None, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Perform a similarity search with ClickHouse
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of (Document, similarity)
+        """
+        q_str = self._build_query_sql(
+            self.embedding_function.embed_query(query), k, where_str
+        )
+        try:
+            return [
+                (
+                    Document(
+                        page_content=r[self.config.column_map["document"]],
+                        metadata=r[self.config.column_map["metadata"]],
+                    ),
+                    r["dist"],
+                )
+                for r in self.client.query(q_str).named_results()
+            ]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    def drop(self) -> None:
+        """
+        Helper function: Drop data
+        """
+        self.client.command(
+            f"DROP TABLE IF EXISTS {self.config.database}.{self.config.table}"
+        )
+
+    @property
+    def metadata_column(self) -> str:
+        return self.config.column_map["metadata"]
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/couchbase.py b/llm/Lib/site-packages/langchain_community/vectorstores/couchbase.py
new file mode 100644
index 0000000000000000000000000000000000000000..881d31b70fc02874f57797886dfbb4052308335b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/couchbase.py
@@ -0,0 +1,617 @@
+from __future__ import annotations
+
+import uuid
+from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Optional, Tuple, Type
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    from couchbase.cluster import Cluster
+
+
+class CouchbaseVectorStore(VectorStore):
+    """`Couchbase Vector Store` vector store.
+
+    To use it, you need
+    - a recent installation of the `couchbase` library
+    - a Couchbase database with a pre-defined Search index with support for
+        vector fields
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import CouchbaseVectorStore
+            from langchain_openai import OpenAIEmbeddings
+
+            from couchbase.cluster import Cluster
+            from couchbase.auth import PasswordAuthenticator
+            from couchbase.options import ClusterOptions
+            from datetime import timedelta
+
+            auth = PasswordAuthenticator(username, password)
+            options = ClusterOptions(auth)
+            connect_string = "couchbases://localhost"
+            cluster = Cluster(connect_string, options)
+
+            # Wait until the cluster is ready for use.
+            cluster.wait_until_ready(timedelta(seconds=5))
+
+            embeddings = OpenAIEmbeddings()
+
+            vectorstore = CouchbaseVectorStore(
+                cluster=cluster,
+                bucket_name="",
+                scope_name="",
+                collection_name="",
+                embedding=embeddings,
+                index_name="vector-index",
+            )
+
+            vectorstore.add_texts(["hello", "world"])
+            results = vectorstore.similarity_search("ola", k=1)
+    """
+
+    # Default batch size
+    DEFAULT_BATCH_SIZE = 100
+    _metadata_key = "metadata"
+    _default_text_key = "text"
+    _default_embedding_key = "embedding"
+
+    def _check_bucket_exists(self) -> bool:
+        """Check if the bucket exists in the linked Couchbase cluster"""
+        bucket_manager = self._cluster.buckets()
+        try:
+            bucket_manager.get_bucket(self._bucket_name)
+            return True
+        except Exception:
+            return False
+
+    def _check_scope_and_collection_exists(self) -> bool:
+        """Check if the scope and collection exists in the linked Couchbase bucket
+        Raises a ValueError if either is not found"""
+        scope_collection_map: Dict[str, Any] = {}
+
+        # Get a list of all scopes in the bucket
+        for scope in self._bucket.collections().get_all_scopes():
+            scope_collection_map[scope.name] = []
+
+            # Get a list of all the collections in the scope
+            for collection in scope.collections:
+                scope_collection_map[scope.name].append(collection.name)
+
+        # Check if the scope exists
+        if self._scope_name not in scope_collection_map.keys():
+            raise ValueError(
+                f"Scope {self._scope_name} not found in Couchbase "
+                f"bucket {self._bucket_name}"
+            )
+
+        # Check if the collection exists in the scope
+        if self._collection_name not in scope_collection_map[self._scope_name]:
+            raise ValueError(
+                f"Collection {self._collection_name} not found in scope "
+                f"{self._scope_name} in Couchbase bucket {self._bucket_name}"
+            )
+
+        return True
+
+    def _check_index_exists(self) -> bool:
+        """Check if the Search index exists in the linked Couchbase cluster
+        Raises a ValueError if the index does not exist"""
+        if self._scoped_index:
+            all_indexes = [
+                index.name for index in self._scope.search_indexes().get_all_indexes()
+            ]
+            if self._index_name not in all_indexes:
+                raise ValueError(
+                    f"Index {self._index_name} does not exist. "
+                    " Please create the index before searching."
+                )
+        else:
+            all_indexes = [
+                index.name for index in self._cluster.search_indexes().get_all_indexes()
+            ]
+            if self._index_name not in all_indexes:
+                raise ValueError(
+                    f"Index {self._index_name} does not exist. "
+                    " Please create the index before searching."
+                )
+
+        return True
+
+    def __init__(
+        self,
+        cluster: Cluster,
+        bucket_name: str,
+        scope_name: str,
+        collection_name: str,
+        embedding: Embeddings,
+        index_name: str,
+        *,
+        text_key: Optional[str] = _default_text_key,
+        embedding_key: Optional[str] = _default_embedding_key,
+        scoped_index: bool = True,
+    ) -> None:
+        """
+        Initialize the Couchbase Vector Store.
+
+        Args:
+
+            cluster (Cluster): couchbase cluster object with active connection.
+            bucket_name (str): name of bucket to store documents in.
+            scope_name (str): name of scope in the bucket to store documents in.
+            collection_name (str): name of collection in the scope to store documents in
+            embedding (Embeddings): embedding function to use.
+            index_name (str): name of the Search index to use.
+            text_key (optional[str]): key in document to use as text.
+                Set to text by default.
+            embedding_key (optional[str]): key in document to use for the embeddings.
+                Set to embedding by default.
+            scoped_index (optional[bool]): specify whether the index is a scoped index.
+                Set to True by default.
+        """
+        try:
+            from couchbase.cluster import Cluster
+        except ImportError as e:
+            raise ImportError(
+                "Could not import couchbase python package. "
+                "Please install couchbase SDK  with `pip install couchbase`."
+            ) from e
+
+        if not isinstance(cluster, Cluster):
+            raise ValueError(
+                f"cluster should be an instance of couchbase.Cluster, "
+                f"got {type(cluster)}"
+            )
+
+        self._cluster = cluster
+
+        if not embedding:
+            raise ValueError("Embeddings instance must be provided.")
+
+        if not bucket_name:
+            raise ValueError("bucket_name must be provided.")
+
+        if not scope_name:
+            raise ValueError("scope_name must be provided.")
+
+        if not collection_name:
+            raise ValueError("collection_name must be provided.")
+
+        if not index_name:
+            raise ValueError("index_name must be provided.")
+
+        self._bucket_name = bucket_name
+        self._scope_name = scope_name
+        self._collection_name = collection_name
+        self._embedding_function = embedding
+        self._text_key = text_key
+        self._embedding_key = embedding_key
+        self._index_name = index_name
+        self._scoped_index = scoped_index
+
+        # Check if the bucket exists
+        if not self._check_bucket_exists():
+            raise ValueError(
+                f"Bucket {self._bucket_name} does not exist. "
+                " Please create the bucket before searching."
+            )
+
+        try:
+            self._bucket = self._cluster.bucket(self._bucket_name)
+            self._scope = self._bucket.scope(self._scope_name)
+            self._collection = self._scope.collection(self._collection_name)
+        except Exception as e:
+            raise ValueError(
+                "Error connecting to couchbase. "
+                "Please check the connection and credentials."
+            ) from e
+
+        # Check if the scope and collection exists. Throws ValueError if they don't
+        try:
+            self._check_scope_and_collection_exists()
+        except Exception as e:
+            raise e
+
+        # Check if the index exists. Throws ValueError if it doesn't
+        try:
+            self._check_index_exists()
+        except Exception as e:
+            raise e
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict[str, Any]]] = None,
+        ids: Optional[List[str]] = None,
+        batch_size: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run texts through the embeddings and persist in vectorstore.
+
+        If the document IDs are passed, the existing documents (if any) will be
+        overwritten with the new ones.
+
+        Args:
+            texts (Iterable[str]): Iterable of strings to add to the vectorstore.
+            metadatas (Optional[List[Dict]]): Optional list of metadatas associated
+                with the texts.
+            ids (Optional[List[str]]): Optional list of ids associated with the texts.
+                IDs have to be unique strings across the collection.
+                If it is not specified uuids are generated and used as ids.
+            batch_size (Optional[int]): Optional batch size for bulk insertions.
+                Default is 100.
+
+        Returns:
+            List[str]:List of ids from adding the texts into the vectorstore.
+        """
+        from couchbase.exceptions import DocumentExistsException
+
+        if not batch_size:
+            batch_size = self.DEFAULT_BATCH_SIZE
+        doc_ids: List[str] = []
+
+        if ids is None:
+            ids = [uuid.uuid4().hex for _ in texts]
+
+        if metadatas is None:
+            metadatas = [{} for _ in texts]
+
+        embedded_texts = self._embedding_function.embed_documents(list(texts))
+
+        documents_to_insert = [
+            {
+                id: {
+                    self._text_key: text,
+                    self._embedding_key: vector,
+                    self._metadata_key: metadata,
+                }
+                for id, text, vector, metadata in zip(
+                    ids, texts, embedded_texts, metadatas
+                )
+            }
+        ]
+
+        # Insert in batches
+        for i in range(0, len(documents_to_insert), batch_size):
+            batch = documents_to_insert[i : i + batch_size]
+            try:
+                result = self._collection.upsert_multi(batch[0])
+                if result.all_ok:
+                    doc_ids.extend(batch[0].keys())
+            except DocumentExistsException as e:
+                raise ValueError(f"Document already exists: {e}")
+
+        return doc_ids
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        """Delete documents from the vector store by ids.
+
+        Args:
+            ids (List[str]): List of IDs of the documents to delete.
+            batch_size (Optional[int]): Optional batch size for bulk deletions.
+
+        Returns:
+            bool: True if all the documents were deleted successfully, False otherwise.
+
+        """
+        from couchbase.exceptions import DocumentNotFoundException
+
+        if ids is None:
+            raise ValueError("No document ids provided to delete.")
+
+        batch_size = kwargs.get("batch_size", self.DEFAULT_BATCH_SIZE)
+        deletion_status = True
+
+        # Delete in batches
+        for i in range(0, len(ids), batch_size):
+            batch = ids[i : i + batch_size]
+            try:
+                result = self._collection.remove_multi(batch)
+            except DocumentNotFoundException as e:
+                deletion_status = False
+                raise ValueError(f"Document not found: {e}")
+
+            deletion_status &= result.all_ok
+
+        return deletion_status
+
+    @property
+    def embeddings(self) -> Embeddings:
+        """Return the query embedding object."""
+        return self._embedding_function
+
+    def _format_metadata(self, row_fields: Dict[str, Any]) -> Dict[str, Any]:
+        """Helper method to format the metadata from the Couchbase Search API.
+        Args:
+            row_fields (Dict[str, Any]): The fields to format.
+
+        Returns:
+            Dict[str, Any]: The formatted metadata.
+        """
+        metadata = {}
+        for key, value in row_fields.items():
+            # Couchbase Search returns the metadata key with a prefix
+            # `metadata.` We remove it to get the original metadata key
+            if key.startswith(self._metadata_key):
+                new_key = key.split(self._metadata_key + ".")[-1]
+                metadata[new_key] = value
+            else:
+                metadata[key] = value
+
+        return metadata
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        search_options: Optional[Dict[str, Any]] = {},
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to embedding vector with their scores.
+
+        Args:
+            embedding (List[float]): Embedding vector to look up documents similar to.
+            k (int): Number of Documents to return.
+                Defaults to 4.
+            search_options (Optional[Dict[str, Any]]): Optional search options that are
+                passed to Couchbase search.
+                Defaults to empty dictionary.
+            fields (Optional[List[str]]): Optional list of fields to include in the
+                metadata of results. Note that these need to be stored in the index.
+                If nothing is specified, defaults to all the fields stored in the index.
+
+        Returns:
+            List of (Document, score) that are the most similar to the query vector.
+        """
+        import couchbase.search as search
+        from couchbase.options import SearchOptions
+        from couchbase.vector_search import VectorQuery, VectorSearch
+
+        fields = kwargs.get("fields", ["*"])
+
+        # Document text field needs to be returned from the search
+        if fields != ["*"] and self._text_key not in fields:
+            fields.append(self._text_key)
+
+        search_req = search.SearchRequest.create(
+            VectorSearch.from_vector_query(
+                VectorQuery(
+                    self._embedding_key,
+                    embedding,
+                    k,
+                )
+            )
+        )
+        try:
+            if self._scoped_index:
+                search_iter = self._scope.search(
+                    self._index_name,
+                    search_req,
+                    SearchOptions(
+                        limit=k,
+                        fields=fields,
+                        raw=search_options,
+                    ),
+                )
+
+            else:
+                search_iter = self._cluster.search(
+                    index=self._index_name,
+                    request=search_req,
+                    options=SearchOptions(limit=k, fields=fields, raw=search_options),
+                )
+
+            docs_with_score = []
+
+            # Parse the results
+            for row in search_iter.rows():
+                text = row.fields.pop(self._text_key, "")
+
+                # Format the metadata from Couchbase
+                metadata = self._format_metadata(row.fields)
+
+                score = row.score
+                doc = Document(page_content=text, metadata=metadata)
+                docs_with_score.append((doc, score))
+
+        except Exception as e:
+            raise ValueError(f"Search failed with error: {e}")
+
+        return docs_with_score
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        search_options: Optional[Dict[str, Any]] = {},
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return documents most similar to embedding vector with their scores.
+
+        Args:
+            query (str): Query to look up for similar documents
+            k (int): Number of Documents to return.
+                Defaults to 4.
+            search_options (Optional[Dict[str, Any]]): Optional search options that are
+                passed to Couchbase search.
+                Defaults to empty dictionary
+            fields (Optional[List[str]]): Optional list of fields to include in the
+                metadata of results. Note that these need to be stored in the index.
+                If nothing is specified, defaults to all the fields stored in the index.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        query_embedding = self.embeddings.embed_query(query)
+        docs_with_scores = self.similarity_search_with_score_by_vector(
+            query_embedding, k, search_options, **kwargs
+        )
+        return [doc for doc, _ in docs_with_scores]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        search_options: Optional[Dict[str, Any]] = {},
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return documents that are most similar to the query with their scores.
+
+        Args:
+            query (str): Query to look up for similar documents
+            k (int): Number of Documents to return.
+                Defaults to 4.
+            search_options (Optional[Dict[str, Any]]): Optional search options that are
+                passed to Couchbase search.
+                Defaults to empty dictionary.
+            fields (Optional[List[str]]): Optional list of fields to include in the
+                metadata of results. Note that these need to be stored in the index.
+                If nothing is specified, defaults to text and metadata fields.
+
+        Returns:
+            List of (Document, score) that are most similar to the query.
+        """
+        query_embedding = self.embeddings.embed_query(query)
+        docs_with_score = self.similarity_search_with_score_by_vector(
+            query_embedding, k, search_options, **kwargs
+        )
+        return docs_with_score
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        search_options: Optional[Dict[str, Any]] = {},
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return documents that are most similar to the vector embedding.
+
+        Args:
+            embedding (List[float]): Embedding to look up documents similar to.
+            k (int): Number of Documents to return.
+                Defaults to 4.
+            search_options (Optional[Dict[str, Any]]): Optional search options that are
+                passed to Couchbase search.
+                Defaults to empty dictionary.
+            fields (Optional[List[str]]): Optional list of fields to include in the
+                metadata of results. Note that these need to be stored in the index.
+                If nothing is specified, defaults to document text and metadata fields.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        docs_with_score = self.similarity_search_with_score_by_vector(
+            embedding, k, search_options, **kwargs
+        )
+        return [doc for doc, _ in docs_with_score]
+
+    @classmethod
+    def _from_kwargs(
+        cls: Type[CouchbaseVectorStore],
+        embedding: Embeddings,
+        **kwargs: Any,
+    ) -> CouchbaseVectorStore:
+        """Initialize the Couchbase vector store from keyword arguments for the
+        vector store.
+
+        Args:
+            embedding: Embedding object to use to embed text.
+            **kwargs: Keyword arguments to initialize the vector store with.
+                Accepted arguments are:
+                    - cluster
+                    - bucket_name
+                    - scope_name
+                    - collection_name
+                    - index_name
+                    - text_key
+                    - embedding_key
+                    - scoped_index
+
+        """
+        cluster = kwargs.get("cluster", None)
+        bucket_name = kwargs.get("bucket_name", None)
+        scope_name = kwargs.get("scope_name", None)
+        collection_name = kwargs.get("collection_name", None)
+        index_name = kwargs.get("index_name", None)
+        text_key = kwargs.get("text_key", cls._default_text_key)
+        embedding_key = kwargs.get("embedding_key", cls._default_embedding_key)
+        scoped_index = kwargs.get("scoped_index", True)
+
+        return cls(
+            embedding=embedding,
+            cluster=cluster,
+            bucket_name=bucket_name,
+            scope_name=scope_name,
+            collection_name=collection_name,
+            index_name=index_name,
+            text_key=text_key,
+            embedding_key=embedding_key,
+            scoped_index=scoped_index,
+        )
+
+    @classmethod
+    def from_texts(
+        cls: Type[CouchbaseVectorStore],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        **kwargs: Any,
+    ) -> CouchbaseVectorStore:
+        """Construct a Couchbase vector store from a list of texts.
+
+        Example:
+            .. code-block:: python
+
+            from langchain_community.vectorstores import CouchbaseVectorStore
+            from langchain_openai import OpenAIEmbeddings
+
+            from couchbase.cluster import Cluster
+            from couchbase.auth import PasswordAuthenticator
+            from couchbase.options import ClusterOptions
+            from datetime import timedelta
+
+            auth = PasswordAuthenticator(username, password)
+            options = ClusterOptions(auth)
+            connect_string = "couchbases://localhost"
+            cluster = Cluster(connect_string, options)
+
+            # Wait until the cluster is ready for use.
+            cluster.wait_until_ready(timedelta(seconds=5))
+
+            embeddings = OpenAIEmbeddings()
+
+            texts = ["hello", "world"]
+
+            vectorstore = CouchbaseVectorStore.from_texts(
+                texts,
+                embedding=embeddings,
+                cluster=cluster,
+                bucket_name="",
+                scope_name="",
+                collection_name="",
+                index_name="vector-index",
+            )
+
+        Args:
+            texts (List[str]): list of texts to add to the vector store.
+            embedding (Embeddings): embedding function to use.
+            metadatas (optional[List[Dict]): list of metadatas to add to documents.
+            **kwargs: Keyword arguments used to initialize the vector store with and/or
+                passed to `add_texts` method. Check the constructor and/or `add_texts`
+                for the list of accepted arguments.
+
+        Returns:
+            A Couchbase vector store.
+
+        """
+        vector_store = cls._from_kwargs(embedding, **kwargs)
+        batch_size = kwargs.get("batch_size", vector_store.DEFAULT_BATCH_SIZE)
+        ids = kwargs.get("ids", None)
+        vector_store.add_texts(
+            texts, metadatas=metadatas, ids=ids, batch_size=batch_size
+        )
+
+        return vector_store
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/dashvector.py b/llm/Lib/site-packages/langchain_community/vectorstores/dashvector.py
new file mode 100644
index 0000000000000000000000000000000000000000..48f054880f722ff8eec75ee1714f597a4839fda0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/dashvector.py
@@ -0,0 +1,401 @@
+from __future__ import annotations
+
+import logging
+import uuid
+from typing import (
+    Any,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+)
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_env
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+logger = logging.getLogger(__name__)
+
+
+class DashVector(VectorStore):
+    """`DashVector` vector store.
+
+    To use, you should have the ``dashvector`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import DashVector
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+            import dashvector
+
+            client = dashvector.Client(api_key="***")
+            client.create("langchain", dimension=1024)
+            collection = client.get("langchain")
+            embeddings = OpenAIEmbeddings()
+            vectorstore = DashVector(collection, embeddings.embed_query, "text")
+    """
+
+    def __init__(
+        self,
+        collection: Any,
+        embedding: Embeddings,
+        text_field: str,
+    ):
+        """Initialize with DashVector collection."""
+
+        try:
+            import dashvector
+        except ImportError:
+            raise ValueError(
+                "Could not import dashvector python package. "
+                "Please install it with `pip install dashvector`."
+            )
+
+        if not isinstance(collection, dashvector.Collection):
+            raise ValueError(
+                f"collection should be an instance of dashvector.Collection, "
+                f"bug got {type(collection)}"
+            )
+
+        self._collection = collection
+        self._embedding = embedding
+        self._text_field = text_field
+
+    def _create_partition_if_not_exists(self, partition: str) -> None:
+        """Create a Partition in current Collection."""
+        self._collection.create_partition(partition)
+
+    def _similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[str] = None,
+        partition: str = "default",
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query vector, along with scores"""
+
+        # query by vector
+        ret = self._collection.query(
+            embedding, topk=k, filter=filter, partition=partition
+        )
+        if not ret:
+            raise ValueError(
+                f"Fail to query docs by vector, error {self._collection.message}"
+            )
+
+        docs = []
+        for doc in ret:
+            metadata = doc.fields
+            text = metadata.pop(self._text_field)
+            score = doc.score
+            docs.append((Document(page_content=text, metadata=metadata), score))
+        return docs
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        batch_size: int = 25,
+        partition: str = "default",
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of ids associated with the texts.
+            batch_size: Optional batch size to upsert docs.
+            partition: a partition name in collection. [optional].
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        self._create_partition_if_not_exists(partition)
+        ids = ids or [str(uuid.uuid4().hex) for _ in texts]
+        text_list = list(texts)
+        for i in range(0, len(text_list), batch_size):
+            # batch end
+            end = min(i + batch_size, len(text_list))
+
+            batch_texts = text_list[i:end]
+            batch_ids = ids[i:end]
+            batch_embeddings = self._embedding.embed_documents(list(batch_texts))
+
+            # batch metadatas
+            if metadatas:
+                batch_metadatas = metadatas[i:end]
+            else:
+                batch_metadatas = [{} for _ in range(i, end)]
+            for metadata, text in zip(batch_metadatas, batch_texts):
+                metadata[self._text_field] = text
+
+            # batch upsert to collection
+            docs = list(zip(batch_ids, batch_embeddings, batch_metadatas))
+            ret = self._collection.upsert(docs, partition=partition)
+            if not ret:
+                raise ValueError(
+                    f"Fail to upsert docs to dashvector vector database,"
+                    f"Error: {ret.message}"
+                )
+        return ids
+
+    def delete(
+        self, ids: Optional[List[str]] = None, partition: str = "default", **kwargs: Any
+    ) -> bool:
+        """Delete by vector ID.
+
+        Args:
+            ids: List of ids to delete.
+            partition: a partition name in collection. [optional].
+
+        Returns:
+            True if deletion is successful,
+            False otherwise.
+        """
+        return bool(self._collection.delete(ids, partition=partition))
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[str] = None,
+        partition: str = "default",
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to search documents similar to.
+            k: Number of documents to return. Default to 4.
+            filter: Doc fields filter conditions that meet the SQL where clause
+                    specification.
+            partition: a partition name in collection. [optional].
+
+        Returns:
+            List of Documents most similar to the query text.
+        """
+
+        docs_and_scores = self.similarity_search_with_relevance_scores(
+            query, k, filter, partition
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[str] = None,
+        partition: str = "default",
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query text , alone with relevance scores.
+
+        Less is more similar, more is more dissimilar.
+
+        Args:
+            query: input text
+            k: Number of Documents to return. Defaults to 4.
+            filter: Doc fields filter conditions that meet the SQL where clause
+                    specification.
+            partition: a partition name in collection. [optional].
+
+        Returns:
+            List of Tuples of (doc, similarity_score)
+        """
+
+        embedding = self._embedding.embed_query(query)
+        return self._similarity_search_with_score_by_vector(
+            embedding, k=k, filter=filter, partition=partition
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[str] = None,
+        partition: str = "default",
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Doc fields filter conditions that meet the SQL where clause
+                    specification.
+            partition: a partition name in collection. [optional].
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        docs_and_scores = self._similarity_search_with_score_by_vector(
+            embedding, k, filter, partition
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[dict] = None,
+        partition: str = "default",
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter: Doc fields filter conditions that meet the SQL where clause
+                    specification.
+            partition: a partition name in collection. [optional].
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        embedding = self._embedding.embed_query(query)
+        return self.max_marginal_relevance_search_by_vector(
+            embedding, k, fetch_k, lambda_mult, filter, partition
+        )
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[dict] = None,
+        partition: str = "default",
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter: Doc fields filter conditions that meet the SQL where clause
+                    specification.
+            partition: a partition name in collection. [optional].
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+
+        # query by vector
+        ret = self._collection.query(
+            embedding,
+            topk=fetch_k,
+            filter=filter,
+            partition=partition,
+            include_vector=True,
+        )
+        if not ret:
+            raise ValueError(
+                f"Fail to query docs by vector, error {self._collection.message}"
+            )
+
+        candidate_embeddings = [doc.vector for doc in ret]
+        mmr_selected = maximal_marginal_relevance(
+            np.array(embedding), candidate_embeddings, lambda_mult, k
+        )
+
+        metadatas = [ret.output[i].fields for i in mmr_selected]
+        return [
+            Document(page_content=metadata.pop(self._text_field), metadata=metadata)
+            for metadata in metadatas
+        ]
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        dashvector_api_key: Optional[str] = None,
+        dashvector_endpoint: Optional[str] = None,
+        collection_name: str = "langchain",
+        text_field: str = "text",
+        batch_size: int = 25,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> DashVector:
+        """Return DashVector VectorStore initialized from texts and embeddings.
+
+        This is the quick way to get started with dashvector vector store.
+
+        Example:
+            .. code-block:: python
+
+            from langchain_community.vectorstores import DashVector
+            from langchain_community.embeddings import OpenAIEmbeddings
+            import dashvector
+
+            embeddings = OpenAIEmbeddings()
+            dashvector = DashVector.from_documents(
+                docs,
+                embeddings,
+                dashvector_api_key="{DASHVECTOR_API_KEY}"
+            )
+        """
+        try:
+            import dashvector
+        except ImportError:
+            raise ValueError(
+                "Could not import dashvector python package. "
+                "Please install it with `pip install dashvector`."
+            )
+
+        dashvector_api_key = dashvector_api_key or get_from_env(
+            "dashvector_api_key", "DASHVECTOR_API_KEY"
+        )
+
+        dashvector_endpoint = dashvector_endpoint or get_from_env(
+            "dashvector_endpoint",
+            "DASHVECTOR_ENDPOINT",
+            default="dashvector.cn-hangzhou.aliyuncs.com",
+        )
+        dashvector_client = dashvector.Client(
+            api_key=dashvector_api_key, endpoint=dashvector_endpoint
+        )
+        dashvector_client.delete(collection_name)
+        collection = dashvector_client.get(collection_name)
+        if not collection:
+            dim = len(embedding.embed_query(texts[0]))
+            # create collection if not existed
+            resp = dashvector_client.create(collection_name, dimension=dim)
+            if resp:
+                collection = dashvector_client.get(collection_name)
+            else:
+                raise ValueError(
+                    "Fail to create collection. " f"Error: {resp.message}."
+                )
+
+        dashvector_vector_db = cls(collection, embedding, text_field)
+        dashvector_vector_db.add_texts(texts, metadatas, ids, batch_size)
+        return dashvector_vector_db
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/databricks_vector_search.py b/llm/Lib/site-packages/langchain_community/vectorstores/databricks_vector_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..0a5e7a6d514c2029358a47e8e9bb8941c7b7cffd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/databricks_vector_search.py
@@ -0,0 +1,601 @@
+from __future__ import annotations
+
+import json
+import logging
+import uuid
+from typing import TYPE_CHECKING, Any, Callable, Iterable, List, Optional, Tuple, Type
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VST, VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+if TYPE_CHECKING:
+    from databricks.vector_search.client import VectorSearchIndex
+
+logger = logging.getLogger(__name__)
+
+
+class DatabricksVectorSearch(VectorStore):
+    """`Databricks Vector Search` vector store.
+
+    To use, you should have the ``databricks-vectorsearch`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import DatabricksVectorSearch
+            from databricks.vector_search.client import VectorSearchClient
+
+            vs_client = VectorSearchClient()
+            vs_index = vs_client.get_index(
+              endpoint_name="vs_endpoint",
+              index_name="ml.llm.index"
+            )
+            vectorstore = DatabricksVectorSearch(vs_index)
+
+    Args:
+        index: A Databricks Vector Search index object.
+        embedding: The embedding model.
+                  Required for direct-access index or delta-sync index
+                  with self-managed embeddings.
+        text_column: The name of the text column to use for the embeddings.
+                    Required for direct-access index or delta-sync index
+                    with self-managed embeddings.
+                    Make sure the text column specified is in the index.
+        columns: The list of column names to get when doing the search.
+                Defaults to ``[primary_key, text_column]``.
+
+    Delta-sync index with Databricks-managed embeddings manages the ingestion, deletion,
+    and embedding for you.
+    Manually ingestion/deletion of the documents/texts is not supported for delta-sync
+    index.
+
+    If you want to use a delta-sync index with self-managed embeddings, you need to
+    provide the embedding model and text column name to use for the embeddings.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import DatabricksVectorSearch
+            from databricks.vector_search.client import VectorSearchClient
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+            vs_client = VectorSearchClient()
+            vs_index = vs_client.get_index(
+              endpoint_name="vs_endpoint",
+              index_name="ml.llm.index"
+            )
+            vectorstore = DatabricksVectorSearch(
+              index=vs_index,
+              embedding=OpenAIEmbeddings(),
+              text_column="document_content"
+            )
+
+    If you want to manage the documents ingestion/deletion yourself, you can use a
+    direct-access index.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import DatabricksVectorSearch
+            from databricks.vector_search.client import VectorSearchClient
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+            vs_client = VectorSearchClient()
+            vs_index = vs_client.get_index(
+              endpoint_name="vs_endpoint",
+              index_name="ml.llm.index"
+            )
+            vectorstore = DatabricksVectorSearch(
+              index=vs_index,
+              embedding=OpenAIEmbeddings(),
+              text_column="document_content"
+            )
+            vectorstore.add_texts(
+              texts=["text1", "text2"]
+            )
+
+    For more information on Databricks Vector Search, see `Databricks Vector Search
+    documentation: https://docs.databricks.com/en/generative-ai/vector-search.html.
+
+    """
+
+    def __init__(
+        self,
+        index: VectorSearchIndex,
+        *,
+        embedding: Optional[Embeddings] = None,
+        text_column: Optional[str] = None,
+        columns: Optional[List[str]] = None,
+    ):
+        try:
+            from databricks.vector_search.client import VectorSearchIndex
+        except ImportError as e:
+            raise ImportError(
+                "Could not import databricks-vectorsearch python package. "
+                "Please install it with `pip install databricks-vectorsearch`."
+            ) from e
+        # index
+        self.index = index
+        if not isinstance(index, VectorSearchIndex):
+            raise TypeError("index must be of type VectorSearchIndex.")
+
+        # index_details
+        index_details = self.index.describe()
+        self.primary_key = index_details["primary_key"]
+        self.index_type = index_details.get("index_type")
+        self._delta_sync_index_spec = index_details.get("delta_sync_index_spec", dict())
+        self._direct_access_index_spec = index_details.get(
+            "direct_access_index_spec", dict()
+        )
+
+        # text_column
+        if self._is_databricks_managed_embeddings():
+            index_source_column = self._embedding_source_column_name()
+            # check if input text column matches the source column of the index
+            if text_column is not None and text_column != index_source_column:
+                raise ValueError(
+                    f"text_column '{text_column}' does not match with the "
+                    f"source column of the index: '{index_source_column}'."
+                )
+            self.text_column = index_source_column
+        else:
+            self._require_arg(text_column, "text_column")
+            self.text_column = text_column
+
+        # columns
+        self.columns = columns or []
+        # add primary key column and source column if not in columns
+        if self.primary_key not in self.columns:
+            self.columns.append(self.primary_key)
+        if self.text_column and self.text_column not in self.columns:
+            self.columns.append(self.text_column)
+
+        # Validate specified columns are in the index
+        if self._is_direct_access_index():
+            index_schema = self._index_schema()
+            if index_schema:
+                for col in self.columns:
+                    if col not in index_schema:
+                        raise ValueError(
+                            f"column '{col}' is not in the index's schema."
+                        )
+
+        # embedding model
+        if not self._is_databricks_managed_embeddings():
+            # embedding model is required for direct-access index
+            # or delta-sync index with self-managed embedding
+            self._require_arg(embedding, "embedding")
+            self._embedding = embedding
+            # validate dimension matches
+            index_embedding_dimension = self._embedding_vector_column_dimension()
+            if index_embedding_dimension is not None:
+                inferred_embedding_dimension = self._infer_embedding_dimension()
+                if inferred_embedding_dimension != index_embedding_dimension:
+                    raise ValueError(
+                        f"embedding model's dimension '{inferred_embedding_dimension}' "
+                        f"does not match with the index's dimension "
+                        f"'{index_embedding_dimension}'."
+                    )
+        else:
+            if embedding is not None:
+                logger.warning(
+                    "embedding model is not used in delta-sync index with "
+                    "Databricks-managed embeddings."
+                )
+            self._embedding = None
+
+    @classmethod
+    def from_texts(
+        cls: Type[VST],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> VST:
+        raise NotImplementedError(
+            "`from_texts` is not supported. "
+            "Use `add_texts` to add to existing direct-access index."
+        )
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[Any]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add texts to the index.
+
+        Only support direct-access index.
+
+        Args:
+            texts: List of texts to add.
+            metadatas: List of metadata for each text. Defaults to None.
+            ids: List of ids for each text. Defaults to None.
+                If not provided, a random uuid will be generated for each text.
+
+        Returns:
+            List of ids from adding the texts into the index.
+        """
+        self._op_require_direct_access_index("add_texts")
+        assert self.embeddings is not None, "embedding model is required."
+        # Wrap to list if input texts is a single string
+        if isinstance(texts, str):
+            texts = [texts]
+        texts = list(texts)
+        vectors = self.embeddings.embed_documents(texts)
+        ids = ids or [str(uuid.uuid4()) for _ in texts]
+        metadatas = metadatas or [{} for _ in texts]
+
+        updates = [
+            {
+                self.primary_key: id_,
+                self.text_column: text,
+                self._embedding_vector_column_name(): vector,
+                **metadata,
+            }
+            for text, vector, id_, metadata in zip(texts, vectors, ids, metadatas)
+        ]
+
+        upsert_resp = self.index.upsert(updates)
+        if upsert_resp.get("status") in ("PARTIAL_SUCCESS", "FAILURE"):
+            failed_ids = upsert_resp.get("result", dict()).get(
+                "failed_primary_keys", []
+            )
+            if upsert_resp.get("status") == "FAILURE":
+                logger.error("Failed to add texts to the index.")
+            else:
+                logger.warning("Some texts failed to be added to the index.")
+            return [id_ for id_ in ids if id_ not in failed_ids]
+
+        return ids
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        """Access the query embedding object if available."""
+        return self._embedding
+
+    def delete(self, ids: Optional[List[Any]] = None, **kwargs: Any) -> Optional[bool]:
+        """Delete documents from the index.
+
+        Only support direct-access index.
+
+        Args:
+            ids: List of ids of documents to delete.
+
+        Returns:
+            True if successful.
+        """
+        self._op_require_direct_access_index("delete")
+        if ids is None:
+            raise ValueError("ids must be provided.")
+        self.index.delete(ids)
+        return True
+
+    def similarity_search(
+        self, query: str, k: int = 4, filters: Optional[Any] = None, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filters: Filters to apply to the query. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the embedding.
+        """
+        docs_with_score = self.similarity_search_with_score(
+            query=query, k=k, filters=filters, **kwargs
+        )
+        return [doc for doc, _ in docs_with_score]
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, filters: Optional[Any] = None, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query, along with scores.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filters: Filters to apply to the query. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the embedding and score for each.
+        """
+        if self._is_databricks_managed_embeddings():
+            query_text = query
+            query_vector = None
+        else:
+            assert self.embeddings is not None, "embedding model is required."
+            query_text = None
+            query_vector = self.embeddings.embed_query(query)
+
+        search_resp = self.index.similarity_search(
+            columns=self.columns,
+            query_text=query_text,
+            query_vector=query_vector,
+            filters=filters,
+            num_results=k,
+        )
+        return self._parse_search_response(search_resp)
+
+    @staticmethod
+    def _identity_fn(score: float) -> float:
+        return score
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        Databricks Vector search uses a normalized score 1/(1+d) where d
+        is the L2 distance. Hence, we simply return the identity function.
+        """
+
+        return self._identity_fn
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filters: Optional[Any] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filters: Filters to apply to the query. Defaults to None.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        if not self._is_databricks_managed_embeddings():
+            assert self.embeddings is not None, "embedding model is required."
+            query_vector = self.embeddings.embed_query(query)
+        else:
+            raise ValueError(
+                "`max_marginal_relevance_search` is not supported for index with "
+                "Databricks-managed embeddings."
+            )
+
+        docs = self.max_marginal_relevance_search_by_vector(
+            query_vector,
+            k,
+            fetch_k,
+            lambda_mult=lambda_mult,
+            filters=filters,
+        )
+        return docs
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filters: Optional[Any] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filters: Filters to apply to the query. Defaults to None.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        if not self._is_databricks_managed_embeddings():
+            embedding_column = self._embedding_vector_column_name()
+        else:
+            raise ValueError(
+                "`max_marginal_relevance_search` is not supported for index with "
+                "Databricks-managed embeddings."
+            )
+
+        search_resp = self.index.similarity_search(
+            columns=list(set(self.columns + [embedding_column])),
+            query_text=None,
+            query_vector=embedding,
+            filters=filters,
+            num_results=fetch_k,
+        )
+
+        embeddings_result_index = (
+            search_resp.get("manifest").get("columns").index({"name": embedding_column})
+        )
+        embeddings = [
+            doc[embeddings_result_index]
+            for doc in search_resp.get("result").get("data_array")
+        ]
+
+        mmr_selected = maximal_marginal_relevance(
+            np.array(embedding, dtype=np.float32),
+            embeddings,
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+
+        ignore_cols: List = (
+            [embedding_column] if embedding_column not in self.columns else []
+        )
+        candidates = self._parse_search_response(search_resp, ignore_cols=ignore_cols)
+        selected_results = [r[0] for i, r in enumerate(candidates) if i in mmr_selected]
+        return selected_results
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filters: Optional[Any] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filters: Filters to apply to the query. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the embedding.
+        """
+        docs_with_score = self.similarity_search_by_vector_with_score(
+            embedding=embedding, k=k, filters=filters, **kwargs
+        )
+        return [doc for doc, _ in docs_with_score]
+
+    def similarity_search_by_vector_with_score(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filters: Optional[Any] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to embedding vector, along with scores.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filters: Filters to apply to the query. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the embedding and score for each.
+        """
+        if self._is_databricks_managed_embeddings():
+            raise ValueError(
+                "`similarity_search_by_vector` is not supported for index with "
+                "Databricks-managed embeddings."
+            )
+        search_resp = self.index.similarity_search(
+            columns=self.columns,
+            query_vector=embedding,
+            filters=filters,
+            num_results=k,
+        )
+        return self._parse_search_response(search_resp)
+
+    def _parse_search_response(
+        self, search_resp: dict, ignore_cols: Optional[List[str]] = None
+    ) -> List[Tuple[Document, float]]:
+        """Parse the search response into a list of Documents with score."""
+        if ignore_cols is None:
+            ignore_cols = []
+
+        columns = [
+            col["name"]
+            for col in search_resp.get("manifest", dict()).get("columns", [])
+        ]
+        docs_with_score = []
+        for result in search_resp.get("result", dict()).get("data_array", []):
+            doc_id = result[columns.index(self.primary_key)]
+            text_content = result[columns.index(self.text_column)]
+            metadata = {
+                col: value
+                for col, value in zip(columns[:-1], result[:-1])
+                if col not in ([self.primary_key, self.text_column] + ignore_cols)
+            }
+            metadata[self.primary_key] = doc_id
+            score = result[-1]
+            doc = Document(page_content=text_content, metadata=metadata)
+            docs_with_score.append((doc, score))
+        return docs_with_score
+
+    def _index_schema(self) -> Optional[dict]:
+        """Return the index schema as a dictionary.
+        Return None if no schema found.
+        """
+        if self._is_direct_access_index():
+            schema_json = self._direct_access_index_spec.get("schema_json")
+            if schema_json is not None:
+                return json.loads(schema_json)
+        return None
+
+    def _embedding_vector_column_name(self) -> Optional[str]:
+        """Return the name of the embedding vector column.
+        None if the index is not a self-managed embedding index.
+        """
+        return self._embedding_vector_column().get("name")
+
+    def _embedding_vector_column_dimension(self) -> Optional[int]:
+        """Return the dimension of the embedding vector column.
+        None if the index is not a self-managed embedding index.
+        """
+        return self._embedding_vector_column().get("embedding_dimension")
+
+    def _embedding_vector_column(self) -> dict:
+        """Return the embedding vector column configs as a dictionary.
+        Empty if the index is not a self-managed embedding index.
+        """
+        index_spec = (
+            self._delta_sync_index_spec
+            if self._is_delta_sync_index()
+            else self._direct_access_index_spec
+        )
+        return next(iter(index_spec.get("embedding_vector_columns") or list()), dict())
+
+    def _embedding_source_column_name(self) -> Optional[str]:
+        """Return the name of the embedding source column.
+        None if the index is not a Databricks-managed embedding index.
+        """
+        return self._embedding_source_column().get("name")
+
+    def _embedding_source_column(self) -> dict:
+        """Return the embedding source column configs as a dictionary.
+        Empty if the index is not a Databricks-managed embedding index.
+        """
+        index_spec = self._delta_sync_index_spec
+        return next(iter(index_spec.get("embedding_source_columns") or list()), dict())
+
+    def _is_delta_sync_index(self) -> bool:
+        """Return True if the index is a delta-sync index."""
+        return self.index_type == "DELTA_SYNC"
+
+    def _is_direct_access_index(self) -> bool:
+        """Return True if the index is a direct-access index."""
+        return self.index_type == "DIRECT_ACCESS"
+
+    def _is_databricks_managed_embeddings(self) -> bool:
+        """Return True if the embeddings are managed by Databricks Vector Search."""
+        return (
+            self._is_delta_sync_index()
+            and self._embedding_source_column_name() is not None
+        )
+
+    def _infer_embedding_dimension(self) -> int:
+        """Infer the embedding dimension from the embedding function."""
+        assert self.embeddings is not None, "embedding model is required."
+        return len(self.embeddings.embed_query("test"))
+
+    def _op_require_direct_access_index(self, op_name: str) -> None:
+        """
+        Raise ValueError if the operation is not supported for direct-access index."""
+        if not self._is_direct_access_index():
+            raise ValueError(f"`{op_name}` is only supported for direct-access index.")
+
+    @staticmethod
+    def _require_arg(arg: Any, arg_name: str) -> None:
+        """Raise ValueError if the required arg with name `arg_name` is None."""
+        if not arg:
+            raise ValueError(f"`{arg_name}` is required for this index.")
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/deeplake.py b/llm/Lib/site-packages/langchain_community/vectorstores/deeplake.py
new file mode 100644
index 0000000000000000000000000000000000000000..5ece84dc5572202fe3eae7a38fc58a99ebd6b8e2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/deeplake.py
@@ -0,0 +1,958 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Callable, Dict, Iterable, List, Optional, Tuple, Union
+
+import numpy as np
+
+try:
+    import deeplake
+    from deeplake import VectorStore as DeepLakeVectorStore
+    from deeplake.core.fast_forwarding import version_compare
+    from deeplake.util.exceptions import SampleExtendError
+
+    _DEEPLAKE_INSTALLED = True
+except ImportError:
+    _DEEPLAKE_INSTALLED = False
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+logger = logging.getLogger(__name__)
+
+
+class DeepLake(VectorStore):
+    """`Activeloop Deep Lake` vector store.
+
+    We integrated deeplake's similarity search and filtering for fast prototyping.
+    Now, it supports Tensor Query Language (TQL) for production use cases
+    over billion rows.
+
+    Why Deep Lake?
+
+    - Not only stores embeddings, but also the original data with version control.
+    - Serverless, doesn't require another service and can be used with major
+        cloud providers (S3, GCS, etc.)
+    - More than just a multi-modal vector store. You can use the dataset
+        to fine-tune your own LLM models.
+
+    To use, you should have the ``deeplake`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+                from langchain_community.vectorstores import DeepLake
+                from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+                embeddings = OpenAIEmbeddings()
+                vectorstore = DeepLake("langchain_store", embeddings.embed_query)
+    """
+
+    _LANGCHAIN_DEFAULT_DEEPLAKE_PATH = "./deeplake/"
+    _valid_search_kwargs = ["lambda_mult"]
+
+    def __init__(
+        self,
+        dataset_path: str = _LANGCHAIN_DEFAULT_DEEPLAKE_PATH,
+        token: Optional[str] = None,
+        embedding: Optional[Embeddings] = None,
+        embedding_function: Optional[Embeddings] = None,
+        read_only: bool = False,
+        ingestion_batch_size: int = 1024,
+        num_workers: int = 0,
+        verbose: bool = True,
+        exec_option: Optional[str] = None,
+        runtime: Optional[Dict] = None,
+        index_params: Optional[Dict[str, Union[int, str]]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Creates an empty DeepLakeVectorStore or loads an existing one.
+
+        The DeepLakeVectorStore is located at the specified ``path``.
+
+        Examples:
+            >>> # Create a vector store with default tensors
+            >>> deeplake_vectorstore = DeepLake(
+            ...        path = <path_for_storing_Data>,
+            ... )
+            >>>
+            >>> # Create a vector store in the Deep Lake Managed Tensor Database
+            >>> data = DeepLake(
+            ...        path = "hub://org_id/dataset_name",
+            ...        runtime = {"tensor_db": True},
+            ... )
+
+        Args:
+            dataset_path (str): The full path for storing to the Deep Lake
+                Vector Store. It can be:
+                - a Deep Lake cloud path of the form ``hub://org_id/dataset_name``.
+                    Requires registration with Deep Lake.
+                - an s3 path of the form ``s3://bucketname/path/to/dataset``.
+                    Credentials are required in either the environment or passed to
+                    the creds argument.
+                - a local file system path of the form ``./path/to/dataset``
+                    or ``~/path/to/dataset`` or ``path/to/dataset``.
+                - a memory path of the form ``mem://path/to/dataset`` which doesn't
+                    save the dataset but keeps it in memory instead.
+                    Should be used only for testing as it does not persist.
+                    Defaults to _LANGCHAIN_DEFAULT_DEEPLAKE_PATH.
+            token (str, optional):  Activeloop token, for fetching credentials
+                to the dataset at path if it is a Deep Lake dataset.
+                Tokens are normally autogenerated. Optional.
+            embedding (Embeddings, optional): Function to convert
+                either documents or query. Optional.
+            embedding_function (Embeddings, optional): Function to convert
+                either documents or query. Optional. Deprecated: keeping this
+                parameter for backwards compatibility.
+            read_only (bool): Open dataset in read-only mode. Default is False.
+            ingestion_batch_size (int): During data ingestion, data is divided
+                into batches. Batch size is the size of each batch.
+                Default is 1024.
+            num_workers (int): Number of workers to use during data ingestion.
+                Default is 0.
+            verbose (bool): Print dataset summary after each operation.
+                Default is True.
+            exec_option (str, optional): Default method for search execution.
+                It could be either ``"auto"``, ``"python"``, ``"compute_engine"``
+                or ``"tensor_db"``. Defaults to ``"auto"``.
+                If None, it's set to "auto".
+                - ``auto``- Selects the best execution method based on the storage
+                    location of the Vector Store. It is the default option.
+                - ``python`` - Pure-python implementation that runs on the client and
+                    can be used for data stored anywhere. WARNING: using this option
+                    with big datasets is discouraged because it can lead to
+                    memory issues.
+                - ``compute_engine`` - Performant C++ implementation of the Deep Lake
+                    Compute Engine that runs on the client and can be used for any data
+                    stored in or connected to Deep Lake. It cannot be used with
+                    in-memory or local datasets.
+                - ``tensor_db`` - Performant and fully-hosted Managed Tensor Database
+                    that is responsible for storage and query execution. Only available
+                    for data stored in the Deep Lake Managed Database. Store datasets
+                    in this database by specifying runtime = {"tensor_db": True}
+                    during dataset creation.
+            runtime (Dict, optional): Parameters for creating the Vector Store in
+                Deep Lake's Managed Tensor Database. Not applicable when loading an
+                existing Vector Store. To create a Vector Store in the Managed Tensor
+                Database, set `runtime = {"tensor_db": True}`.
+            index_params (Optional[Dict[str, Union[int, str]]], optional): Dictionary
+                containing information about vector index that will be created. Defaults
+                to None, which will utilize ``DEFAULT_VECTORSTORE_INDEX_PARAMS`` from
+                ``deeplake.constants``. The specified key-values override the default
+                ones.
+                - threshold: The threshold for the dataset size above which an index
+                    will be created for the embedding tensor. When the threshold value
+                    is set to -1, index creation is turned off. Defaults to -1, which
+                    turns off the index.
+                - distance_metric: This key specifies the method of calculating the
+                    distance between vectors when creating the vector database (VDB)
+                    index. It can either be a string that corresponds to a member of
+                    the DistanceType enumeration, or the string value itself.
+                    - If no value is provided, it defaults to "L2".
+                    - "L2" corresponds to DistanceType.L2_NORM.
+                    - "COS" corresponds to DistanceType.COSINE_SIMILARITY.
+                - additional_params: Additional parameters for fine-tuning the index.
+            **kwargs: Other optional keyword arguments.
+
+        Raises:
+            ValueError: If some condition is not met.
+        """
+
+        self.ingestion_batch_size = ingestion_batch_size
+        self.num_workers = num_workers
+        self.verbose = verbose
+
+        if _DEEPLAKE_INSTALLED is False:
+            raise ImportError(
+                "Could not import deeplake python package. "
+                "Please install it with `pip install deeplake[enterprise]`."
+            )
+
+        if (
+            runtime == {"tensor_db": True}
+            and version_compare(deeplake.__version__, "3.6.7") == -1
+        ):
+            raise ImportError(
+                "To use tensor_db option you need to update deeplake to `3.6.7` or "
+                "higher. "
+                f"Currently installed deeplake version is {deeplake.__version__}. "
+            )
+
+        self.dataset_path = dataset_path
+
+        if embedding_function:
+            logger.warning(
+                "Using embedding function is deprecated and will be removed "
+                "in the future. Please use embedding instead."
+            )
+
+        self.vectorstore = DeepLakeVectorStore(
+            path=self.dataset_path,
+            embedding_function=embedding_function or embedding,
+            read_only=read_only,
+            token=token,
+            exec_option=exec_option,
+            verbose=verbose,
+            runtime=runtime,
+            index_params=index_params,
+            **kwargs,
+        )
+
+        self._embedding_function = embedding_function or embedding
+        self._id_tensor_name = "ids" if "ids" in self.vectorstore.tensors() else "id"
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self._embedding_function
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Examples:
+            >>> ids = deeplake_vectorstore.add_texts(
+            ...     texts = <list_of_texts>,
+            ...     metadatas = <list_of_metadata_jsons>,
+            ...     ids = <list_of_ids>,
+            ... )
+
+        Args:
+            texts (Iterable[str]): Texts to add to the vectorstore.
+            metadatas (Optional[List[dict]], optional): Optional list of metadatas.
+            ids (Optional[List[str]], optional): Optional list of IDs.
+            embedding_function (Optional[Embeddings], optional): Embedding function
+                to use to convert the text into embeddings.
+            **kwargs (Any): Any additional keyword arguments passed is not supported
+                by this method.
+
+        Returns:
+            List[str]: List of IDs of the added texts.
+        """
+        self._validate_kwargs(kwargs, "add_texts")
+
+        kwargs = {}
+        if ids:
+            if self._id_tensor_name == "ids":  # for backwards compatibility
+                kwargs["ids"] = ids
+            else:
+                kwargs["id"] = ids
+
+        if metadatas is None:
+            metadatas = [{}] * len(list(texts))
+
+        if not isinstance(texts, list):
+            texts = list(texts)
+
+        if texts is None:
+            raise ValueError("`texts` parameter shouldn't be None.")
+        elif len(texts) == 0:
+            raise ValueError("`texts` parameter shouldn't be empty.")
+
+        try:
+            return self.vectorstore.add(
+                text=texts,
+                metadata=metadatas,
+                embedding_data=texts,
+                embedding_tensor="embedding",
+                embedding_function=self._embedding_function.embed_documents,  # type: ignore
+                return_ids=True,
+                **kwargs,
+            )
+        except SampleExtendError as e:
+            if "Failed to append a sample to the tensor 'metadata'" in str(e):
+                msg = (
+                    "**Hint: You might be using invalid type of argument in "
+                    "document loader (e.g. 'pathlib.PosixPath' instead of 'str')"
+                )
+                raise ValueError(e.args[0] + "\n\n" + msg)
+            else:
+                raise e
+
+    def _search_tql(
+        self,
+        tql: Optional[str],
+        exec_option: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Function for performing tql_search.
+
+        Args:
+            tql (str): TQL Query string for direct evaluation.
+                Available only for `compute_engine` and `tensor_db`.
+            exec_option (str, optional): Supports 3 ways to search.
+                Could be "python", "compute_engine" or "tensor_db". Default is "python".
+                - ``python`` - Pure-python implementation for the client.
+                    WARNING: not recommended for big datasets due to potential memory
+                    issues.
+                - ``compute_engine`` - C++ implementation of Deep Lake Compute
+                    Engine for the client. Not for in-memory or local datasets.
+                - ``tensor_db`` - Hosted Managed Tensor Database for storage
+                    and query execution. Only for data in Deep Lake Managed Database.
+                        Use runtime = {"db_engine": True} during dataset creation.
+            return_score (bool): Return score with document. Default is False.
+
+        Returns:
+            Tuple[List[Document], List[Tuple[Document, float]]] - A tuple of two lists.
+                The first list contains Documents, and the second list contains
+                tuples of Document and float score.
+
+        Raises:
+            ValueError: If return_score is True but some condition is not met.
+        """
+        result = self.vectorstore.search(
+            query=tql,
+            exec_option=exec_option,
+        )
+        metadatas = result["metadata"]
+        texts = result["text"]
+
+        docs = [
+            Document(
+                page_content=text,
+                metadata=metadata,
+            )
+            for text, metadata in zip(texts, metadatas)
+        ]
+
+        if kwargs:
+            unsupported_argument = next(iter(kwargs))
+            if kwargs[unsupported_argument] is not False:
+                raise ValueError(
+                    f"specifying {unsupported_argument} is "
+                    "not supported with tql search."
+                )
+
+        return docs
+
+    def _search(
+        self,
+        query: Optional[str] = None,
+        embedding: Optional[Union[List[float], np.ndarray]] = None,
+        embedding_function: Optional[Callable] = None,
+        k: int = 4,
+        distance_metric: Optional[str] = None,
+        use_maximal_marginal_relevance: bool = False,
+        fetch_k: Optional[int] = 20,
+        filter: Optional[Union[Dict, Callable]] = None,
+        return_score: bool = False,
+        exec_option: Optional[str] = None,
+        deep_memory: bool = False,
+        **kwargs: Any,
+    ) -> Any[List[Document], List[Tuple[Document, float]]]:
+        """
+        Return docs similar to query.
+
+        Args:
+            query (str, optional): Text to look up similar docs.
+            embedding (Union[List[float], np.ndarray], optional): Query's embedding.
+            embedding_function (Callable, optional): Function to convert `query`
+                into embedding.
+            k (int): Number of Documents to return.
+            distance_metric (Optional[str], optional): `L2` for Euclidean, `L1` for
+                Nuclear, `max` for L-infinity distance, `cos` for cosine similarity,
+                'dot' for dot product.
+            filter (Union[Dict, Callable], optional): Additional filter prior
+                to the embedding search.
+                - ``Dict`` - Key-value search on tensors of htype json, on an
+                    AND basis (a sample must satisfy all key-value filters to be True)
+                    Dict = {"tensor_name_1": {"key": value},
+                            "tensor_name_2": {"key": value}}
+                - ``Function`` - Any function compatible with `deeplake.filter`.
+            use_maximal_marginal_relevance (bool): Use maximal marginal relevance.
+            fetch_k (int): Number of Documents for MMR algorithm.
+            return_score (bool): Return the score.
+            exec_option (str, optional): Supports 3 ways to perform searching.
+                Could be "python", "compute_engine" or "tensor_db".
+                - ``python`` - Pure-python implementation for the client.
+                    WARNING: not recommended for big datasets.
+                - ``compute_engine`` - C++ implementation of Deep Lake Compute
+                    Engine for the client. Not for in-memory or local datasets.
+                - ``tensor_db`` - Hosted Managed Tensor Database for storage
+                    and query execution. Only for data in Deep Lake Managed Database.
+                    Use runtime = {"db_engine": True} during dataset creation.
+            deep_memory (bool): Whether to use the Deep Memory model for improving
+                search results. Defaults to False if deep_memory is not specified in
+                the Vector Store initialization. If True, the distance metric is set
+                to "deepmemory_distance", which represents the metric with which the
+                model was trained. The search is performed using the Deep Memory model.
+                If False, the distance metric is set to "COS" or whatever distance
+                metric user specifies.
+            **kwargs: Additional keyword arguments.
+
+        Returns:
+            List of Documents by the specified distance metric,
+            if return_score True, return a tuple of (Document, score)
+
+        Raises:
+            ValueError: if both `embedding` and `embedding_function` are not specified.
+        """
+        if kwargs.get("tql_query"):
+            logger.warning("`tql_query` is deprecated. Please use `tql` instead.")
+            kwargs["tql"] = kwargs.pop("tql_query")
+
+        if kwargs.get("tql"):
+            return self._search_tql(
+                tql=kwargs["tql"],
+                exec_option=exec_option,
+                return_score=return_score,
+                embedding=embedding,
+                embedding_function=embedding_function,
+                distance_metric=distance_metric,
+                use_maximal_marginal_relevance=use_maximal_marginal_relevance,
+                filter=filter,
+            )
+
+        self._validate_kwargs(kwargs, "search")
+
+        if embedding_function:
+            if isinstance(embedding_function, Embeddings):
+                _embedding_function = embedding_function.embed_query
+            else:
+                _embedding_function = embedding_function
+        elif self._embedding_function:
+            _embedding_function = self._embedding_function.embed_query
+        else:
+            _embedding_function = None
+
+        if embedding is None:
+            if _embedding_function is None:
+                raise ValueError(
+                    "Either `embedding` or `embedding_function` needs to be"
+                    " specified."
+                )
+
+            embedding = _embedding_function(query) if query else None
+
+        if isinstance(embedding, list):
+            embedding = np.array(embedding, dtype=np.float32)
+            if len(embedding.shape) > 1:
+                embedding = embedding[0]
+
+        result = self.vectorstore.search(
+            embedding=embedding,
+            k=fetch_k if use_maximal_marginal_relevance else k,
+            distance_metric=distance_metric,
+            filter=filter,
+            exec_option=exec_option,
+            return_tensors=["embedding", "metadata", "text", self._id_tensor_name],
+            deep_memory=deep_memory,
+        )
+        scores = result["score"]
+        embeddings = result["embedding"]
+        metadatas = result["metadata"]
+        texts = result["text"]
+
+        if use_maximal_marginal_relevance:
+            lambda_mult = kwargs.get("lambda_mult", 0.5)
+            indices = maximal_marginal_relevance(  # type: ignore
+                embedding,  # type: ignore
+                embeddings,
+                k=min(k, len(texts)),
+                lambda_mult=lambda_mult,
+            )
+
+            scores = [scores[i] for i in indices]
+            texts = [texts[i] for i in indices]
+            metadatas = [metadatas[i] for i in indices]
+
+        docs = [
+            Document(
+                page_content=text,
+                metadata=metadata,
+            )
+            for text, metadata in zip(texts, metadatas)
+        ]
+
+        if return_score:
+            if not isinstance(scores, list):
+                scores = [scores]
+
+            return [(doc, score) for doc, score in zip(docs, scores)]
+
+        return docs
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """
+        Return docs most similar to query.
+
+        Examples:
+            >>> # Search using an embedding
+            >>> data = vector_store.similarity_search(
+            ...     query=<your_query>,
+            ...     k=<num_items>,
+            ...     exec_option=<preferred_exec_option>,
+            ... )
+            >>> # Run tql search:
+            >>> data = vector_store.similarity_search(
+            ...     query=None,
+            ...     tql="SELECT * WHERE id == <id>",
+            ...     exec_option="compute_engine",
+            ... )
+
+        Args:
+            k (int): Number of Documents to return. Defaults to 4.
+            query (str): Text to look up similar documents.
+            **kwargs: Additional keyword arguments include:
+                embedding (Callable): Embedding function to use. Defaults to None.
+                distance_metric (str): 'L2' for Euclidean, 'L1' for Nuclear, 'max'
+                    for L-infinity, 'cos' for cosine, 'dot' for dot product.
+                    Defaults to 'L2'.
+                filter (Union[Dict, Callable], optional): Additional filter
+                    before embedding search.
+                    - Dict: Key-value search on tensors of htype json,
+                        (sample must satisfy all key-value filters)
+                        Dict = {"tensor_1": {"key": value}, "tensor_2": {"key": value}}
+                    - Function: Compatible with `deeplake.filter`.
+                    Defaults to None.
+                exec_option (str): Supports 3 ways to perform searching.
+                    'python', 'compute_engine', or 'tensor_db'. Defaults to 'python'.
+                    - 'python': Pure-python implementation for the client.
+                        WARNING: not recommended for big datasets.
+                    - 'compute_engine': C++ implementation of the Compute Engine for
+                        the client. Not for in-memory or local datasets.
+                    - 'tensor_db': Managed Tensor Database for storage and query.
+                        Only for data in Deep Lake Managed Database.
+                        Use `runtime = {"db_engine": True}` during dataset creation.
+                deep_memory (bool): Whether to use the Deep Memory model for improving
+                    search results. Defaults to False if deep_memory is not specified
+                    in the Vector Store initialization. If True, the distance metric
+                    is set to "deepmemory_distance", which represents the metric with
+                    which the model was trained. The search is performed using the Deep
+                    Memory model. If False, the distance metric is set to "COS" or
+                    whatever distance metric user specifies.
+
+        Returns:
+            List[Document]: List of Documents most similar to the query vector.
+        """
+
+        return self._search(
+            query=query,
+            k=k,
+            use_maximal_marginal_relevance=False,
+            return_score=False,
+            **kwargs,
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: Union[List[float], np.ndarray],
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """
+        Return docs most similar to embedding vector.
+
+        Examples:
+            >>> # Search using an embedding
+            >>> data = vector_store.similarity_search_by_vector(
+            ...    embedding=<your_embedding>,
+            ...    k=<num_items_to_return>,
+            ...    exec_option=<preferred_exec_option>,
+            ... )
+
+        Args:
+            embedding (Union[List[float], np.ndarray]):
+                Embedding to find similar docs.
+            k (int): Number of Documents to return. Defaults to 4.
+            **kwargs: Additional keyword arguments including:
+                filter (Union[Dict, Callable], optional):
+                    Additional filter before embedding search.
+                    - ``Dict`` - Key-value search on tensors of htype json. True
+                        if all key-value filters are satisfied.
+                        Dict = {"tensor_name_1": {"key": value},
+                                "tensor_name_2": {"key": value}}
+                    - ``Function`` - Any function compatible with
+                        `deeplake.filter`.
+                    Defaults to None.
+                exec_option (str): Options for search execution include
+                    "python", "compute_engine", or "tensor_db". Defaults to
+                    "python".
+                    - "python" - Pure-python implementation running on the client.
+                        Can be used for data stored anywhere. WARNING: using this
+                        option with big datasets is discouraged due to potential
+                        memory issues.
+                    - "compute_engine" - Performant C++ implementation of the Deep
+                        Lake Compute Engine. Runs on the client and can be used for
+                        any data stored in or connected to Deep Lake. It cannot be
+                        used with in-memory or local datasets.
+                    - "tensor_db" - Performant, fully-hosted Managed Tensor Database.
+                        Responsible for storage and query execution. Only available
+                        for data stored in the Deep Lake Managed Database.
+                        To store datasets in this database, specify
+                        `runtime = {"db_engine": True}` during dataset creation.
+                distance_metric (str): `L2` for Euclidean, `L1` for Nuclear,
+                    `max` for L-infinity distance, `cos` for cosine similarity,
+                    'dot' for dot product. Defaults to `L2`.
+                deep_memory (bool): Whether to use the Deep Memory model for improving
+                    search results. Defaults to False if deep_memory is not specified
+                    in the Vector Store initialization. If True, the distance metric
+                    is set to "deepmemory_distance", which represents the metric with
+                    which the model was trained. The search is performed using the Deep
+                    Memory model. If False, the distance metric is set to "COS" or
+                    whatever distance metric user specifies.
+
+        Returns:
+            List[Document]: List of Documents most similar to the query vector.
+        """
+
+        return self._search(
+            embedding=embedding,
+            k=k,
+            use_maximal_marginal_relevance=False,
+            return_score=False,
+            **kwargs,
+        )
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """
+        Run similarity search with Deep Lake with distance returned.
+
+        Examples:
+        >>> data = vector_store.similarity_search_with_score(
+        ...     query=<your_query>,
+        ...     embedding=<your_embedding_function>
+        ...     k=<number_of_items_to_return>,
+        ...     exec_option=<preferred_exec_option>,
+        ... )
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 4.
+            **kwargs: Additional keyword arguments. Some of these arguments are:
+                distance_metric: `L2` for Euclidean, `L1` for Nuclear, `max` L-infinity
+                    distance, `cos` for cosine similarity, 'dot' for dot product.
+                    Defaults to `L2`.
+                filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+                    embedding_function (Callable): Embedding function to use. Defaults
+                    to None.
+                exec_option (str): DeepLakeVectorStore supports 3 ways to perform
+                    searching. It could be either "python", "compute_engine" or
+                    "tensor_db". Defaults to "python".
+                    - "python" - Pure-python implementation running on the client.
+                        Can be used for data stored anywhere. WARNING: using this
+                        option with big datasets is discouraged due to potential
+                        memory issues.
+                    - "compute_engine" - Performant C++ implementation of the Deep
+                        Lake Compute Engine. Runs on the client and can be used for
+                        any data stored in or connected to Deep Lake. It cannot be used
+                        with in-memory or local datasets.
+                    - "tensor_db" - Performant, fully-hosted Managed Tensor Database.
+                        Responsible for storage and query execution. Only available for
+                        data stored in the Deep Lake Managed Database. To store datasets
+                        in this database, specify `runtime = {"db_engine": True}`
+                        during dataset creation.
+                deep_memory (bool): Whether to use the Deep Memory model for improving
+                    search results. Defaults to False if deep_memory is not specified
+                    in the Vector Store initialization. If True, the distance metric
+                    is set to "deepmemory_distance", which represents the metric with
+                    which the model was trained. The search is performed using the Deep
+                    Memory model. If False, the distance metric is set to "COS" or
+                    whatever distance metric user specifies.
+
+        Returns:
+            List[Tuple[Document, float]]: List of documents most similar to the query
+                text with distance in float."""
+
+        return self._search(
+            query=query,
+            k=k,
+            return_score=True,
+            **kwargs,
+        )
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        exec_option: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """
+        Return docs selected using the maximal marginal relevance. Maximal marginal
+        relevance optimizes for similarity to query AND diversity among selected docs.
+
+        Examples:
+        >>> data = vector_store.max_marginal_relevance_search_by_vector(
+        ...        embedding=<your_embedding>,
+        ...        fetch_k=<elements_to_fetch_before_mmr_search>,
+        ...        k=<number_of_items_to_return>,
+        ...        exec_option=<preferred_exec_option>,
+        ... )
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch for MMR algorithm.
+            lambda_mult: Number between 0 and 1 determining the degree of diversity.
+                0 corresponds to max diversity and 1 to min diversity. Defaults to 0.5.
+            exec_option (str): DeepLakeVectorStore supports 3 ways for searching.
+                Could be "python", "compute_engine" or "tensor_db". Defaults to
+                "python".
+                - "python" - Pure-python implementation running on the client.
+                    Can be used for data stored anywhere. WARNING: using this
+                    option with big datasets is discouraged due to potential
+                    memory issues.
+                - "compute_engine" - Performant C++ implementation of the Deep
+                    Lake Compute Engine. Runs on the client and can be used for
+                    any data stored in or connected to Deep Lake. It cannot be used
+                    with in-memory or local datasets.
+                - "tensor_db" - Performant, fully-hosted Managed Tensor Database.
+                    Responsible for storage and query execution. Only available for
+                    data stored in the Deep Lake Managed Database. To store datasets
+                    in this database, specify `runtime = {"db_engine": True}`
+                    during dataset creation.
+            deep_memory (bool): Whether to use the Deep Memory model for improving
+                search results. Defaults to False if deep_memory is not specified
+                in the Vector Store initialization. If True, the distance metric
+                is set to "deepmemory_distance", which represents the metric with
+                which the model was trained. The search is performed using the Deep
+                Memory model. If False, the distance metric is set to "COS" or
+                whatever distance metric user specifies.
+            **kwargs: Additional keyword arguments.
+
+        Returns:
+            List[Documents] - A list of documents.
+        """
+
+        return self._search(
+            embedding=embedding,
+            k=k,
+            fetch_k=fetch_k,
+            use_maximal_marginal_relevance=True,
+            lambda_mult=lambda_mult,
+            exec_option=exec_option,
+            **kwargs,
+        )
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        exec_option: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Examples:
+        >>> # Search using an embedding
+        >>> data = vector_store.max_marginal_relevance_search(
+        ...        query = <query_to_search>,
+        ...        embedding_function = <embedding_function_for_query>,
+        ...        k = <number_of_items_to_return>,
+        ...        exec_option = <preferred_exec_option>,
+        ... )
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents for MMR algorithm.
+            lambda_mult: Value between 0 and 1. 0 corresponds
+                        to maximum diversity and 1 to minimum.
+                        Defaults to 0.5.
+            exec_option (str): Supports 3 ways to perform searching.
+                - "python" - Pure-python implementation running on the client.
+                        Can be used for data stored anywhere. WARNING: using this
+                        option with big datasets is discouraged due to potential
+                        memory issues.
+                    - "compute_engine" - Performant C++ implementation of the Deep
+                        Lake Compute Engine. Runs on the client and can be used for
+                        any data stored in or connected to Deep Lake. It cannot be
+                        used with in-memory or local datasets.
+                    - "tensor_db" - Performant, fully-hosted Managed Tensor Database.
+                        Responsible for storage and query execution. Only available
+                        for data stored in the Deep Lake Managed Database. To store
+                        datasets in this database, specify
+                        `runtime = {"db_engine": True}` during dataset creation.
+            deep_memory (bool): Whether to use the Deep Memory model for improving
+                search results. Defaults to False if deep_memory is not specified
+                in the Vector Store initialization. If True, the distance metric
+                is set to "deepmemory_distance", which represents the metric with
+                which the model was trained. The search is performed using the Deep
+                Memory model. If False, the distance metric is set to "COS" or
+                whatever distance metric user specifies.
+            **kwargs: Additional keyword arguments
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+
+        Raises:
+            ValueError: when MRR search is on but embedding function is
+                not specified.
+        """
+        embedding_function = kwargs.get("embedding") or self._embedding_function
+        if embedding_function is None:
+            raise ValueError(
+                "For MMR search, you must specify an embedding function on"
+                " `creation` or during add call."
+            )
+        return self._search(
+            query=query,
+            k=k,
+            fetch_k=fetch_k,
+            use_maximal_marginal_relevance=True,
+            lambda_mult=lambda_mult,
+            exec_option=exec_option,
+            embedding_function=embedding_function,  # type: ignore
+            **kwargs,
+        )
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        dataset_path: str = _LANGCHAIN_DEFAULT_DEEPLAKE_PATH,
+        **kwargs: Any,
+    ) -> DeepLake:
+        """Create a Deep Lake dataset from a raw documents.
+
+        If a dataset_path is specified, the dataset will be persisted in that location,
+        otherwise by default at `./deeplake`
+
+        Examples:
+        >>> # Search using an embedding
+        >>> vector_store = DeepLake.from_texts(
+        ...        texts = <the_texts_that_you_want_to_embed>,
+        ...        embedding_function = <embedding_function_for_query>,
+        ...        k = <number_of_items_to_return>,
+        ...        exec_option = <preferred_exec_option>,
+        ... )
+
+        Args:
+            dataset_path (str): - The full path to the dataset. Can be:
+                - Deep Lake cloud path of the form ``hub://username/dataset_name``.
+                    To write to Deep Lake cloud datasets,
+                    ensure that you are logged in to Deep Lake
+                    (use 'activeloop login' from command line)
+                - AWS S3 path of the form ``s3://bucketname/path/to/dataset``.
+                    Credentials are required in either the environment
+                - Google Cloud Storage path of the form
+                    ``gcs://bucketname/path/to/dataset`` Credentials are required
+                    in either the environment
+                - Local file system path of the form ``./path/to/dataset`` or
+                    ``~/path/to/dataset`` or ``path/to/dataset``.
+                - In-memory path of the form ``mem://path/to/dataset`` which doesn't
+                    save the dataset, but keeps it in memory instead.
+                    Should be used only for testing as it does not persist.
+            texts (List[Document]): List of documents to add.
+            embedding (Optional[Embeddings]): Embedding function. Defaults to None.
+                Note, in other places, it is called embedding_function.
+            metadatas (Optional[List[dict]]): List of metadatas. Defaults to None.
+            ids (Optional[List[str]]): List of document IDs. Defaults to None.
+            **kwargs: Additional keyword arguments.
+
+        Returns:
+            DeepLake: Deep Lake dataset.
+        """
+        deeplake_dataset = cls(dataset_path=dataset_path, embedding=embedding, **kwargs)
+        deeplake_dataset.add_texts(
+            texts=texts,
+            metadatas=metadatas,
+            ids=ids,
+        )
+        return deeplake_dataset
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> bool:
+        """Delete the entities in the dataset.
+
+        Args:
+            ids (Optional[List[str]], optional): The document_ids to delete.
+                Defaults to None.
+            **kwargs: Other keyword arguments that subclasses might use.
+                - filter (Optional[Dict[str, str]], optional): The filter to delete by.
+                - delete_all (Optional[bool], optional): Whether to drop the dataset.
+
+        Returns:
+            bool: Whether the delete operation was successful.
+        """
+        filter = kwargs.get("filter")
+        delete_all = kwargs.get("delete_all")
+
+        self.vectorstore.delete(ids=ids, filter=filter, delete_all=delete_all)
+
+        return True
+
+    @classmethod
+    def force_delete_by_path(cls, path: str) -> None:
+        """Force delete dataset by path.
+
+        Args:
+            path (str): path of the dataset to delete.
+
+        Raises:
+            ValueError: if deeplake is not installed.
+        """
+
+        try:
+            import deeplake
+        except ImportError:
+            raise ValueError(
+                "Could not import deeplake python package. "
+                "Please install it with `pip install deeplake`."
+            )
+        deeplake.delete(path, large_ok=True, force=True)
+
+    def delete_dataset(self) -> None:
+        """Delete the collection."""
+        self.delete(delete_all=True)
+
+    def ds(self) -> Any:
+        logger.warning(
+            "this method is deprecated and will be removed, "
+            "better to use `db.vectorstore.dataset` instead."
+        )
+        return self.vectorstore.dataset
+
+    @classmethod
+    def _validate_kwargs(cls, kwargs, method_name):  # type: ignore[no-untyped-def]
+        if kwargs:
+            valid_items = cls._get_valid_args(method_name)
+            unsupported_items = cls._get_unsupported_items(kwargs, valid_items)
+
+            if unsupported_items:
+                raise TypeError(
+                    f"`{unsupported_items}` are not a valid "
+                    f"argument to {method_name} method"
+                )
+
+    @classmethod
+    def _get_valid_args(cls, method_name):  # type: ignore[no-untyped-def]
+        if method_name == "search":
+            return cls._valid_search_kwargs
+        else:
+            return []
+
+    @staticmethod
+    def _get_unsupported_items(kwargs, valid_items):  # type: ignore[no-untyped-def]
+        kwargs = {k: v for k, v in kwargs.items() if k not in valid_items}
+        unsupported_items = None
+        if kwargs:
+            unsupported_items = "`, `".join(set(kwargs.keys()))
+        return unsupported_items
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/dingo.py b/llm/Lib/site-packages/langchain_community/vectorstores/dingo.py
new file mode 100644
index 0000000000000000000000000000000000000000..a21c308eb44555f8ace4cd0fe673120cb98b543f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/dingo.py
@@ -0,0 +1,382 @@
+from __future__ import annotations
+
+import logging
+import uuid
+from typing import Any, Iterable, List, Optional, Tuple
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+logger = logging.getLogger(__name__)
+
+
+class Dingo(VectorStore):
+    """`Dingo` vector store.
+
+    To use, you should have the ``dingodb`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import Dingo
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+            embeddings = OpenAIEmbeddings()
+            dingo = Dingo(embeddings, "text")
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        text_key: str,
+        *,
+        client: Any = None,
+        index_name: Optional[str] = None,
+        dimension: int = 1024,
+        host: Optional[List[str]] = None,
+        user: str = "root",
+        password: str = "123123",
+        self_id: bool = False,
+    ):
+        """Initialize with Dingo client."""
+        try:
+            import dingodb
+        except ImportError:
+            raise ImportError(
+                "Could not import dingo python package. "
+                "Please install it with `pip install dingodb."
+            )
+
+        host = host if host is not None else ["172.20.31.10:13000"]
+
+        # collection
+        if client is not None:
+            dingo_client = client
+        else:
+            try:
+                # connect to dingo db
+                dingo_client = dingodb.DingoDB(user, password, host)
+            except ValueError as e:
+                raise ValueError(f"Dingo failed to connect: {e}")
+
+        self._text_key = text_key
+        self._client = dingo_client
+
+        if (
+            index_name is not None
+            and index_name not in dingo_client.get_index()
+            and index_name.upper() not in dingo_client.get_index()
+        ):
+            if self_id is True:
+                dingo_client.create_index(
+                    index_name, dimension=dimension, auto_id=False
+                )
+            else:
+                dingo_client.create_index(index_name, dimension=dimension)
+
+        self._index_name = index_name
+        self._embedding = embedding
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self._embedding
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        text_key: str = "text",
+        batch_size: int = 500,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of ids to associate with the texts.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+
+        """
+
+        # Embed and create the documents
+        ids = ids or [str(uuid.uuid4().int)[:13] for _ in texts]
+        metadatas_list = []
+        texts = list(texts)
+        embeds = self._embedding.embed_documents(texts)
+        for i, text in enumerate(texts):
+            metadata = metadatas[i] if metadatas else {}
+            metadata[self._text_key] = text
+            metadatas_list.append(metadata)
+        # upsert to Dingo
+        for i in range(0, len(list(texts)), batch_size):
+            j = i + batch_size
+            add_res = self._client.vector_add(
+                self._index_name, metadatas_list[i:j], embeds[i:j], ids[i:j]
+            )
+            if not add_res:
+                raise Exception("vector add fail")
+
+        return ids
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        search_params: Optional[dict] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return Dingo documents most similar to query, along with scores.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            search_params: Dictionary of argument(s) to filter on metadata
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query, k=k, search_params=search_params, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        search_params: Optional[dict] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return Dingo documents most similar to query, along with scores.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            search_params: Dictionary of argument(s) to filter on metadata
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        docs = []
+        query_obj = self._embedding.embed_query(query)
+        results = self._client.vector_search(
+            self._index_name, xq=query_obj, top_k=k, search_params=search_params
+        )
+
+        if not results:
+            return []
+
+        for res in results[0]["vectorWithDistances"]:
+            score = res["distance"]
+            if (
+                "score_threshold" in kwargs
+                and kwargs.get("score_threshold") is not None
+            ):
+                if score > kwargs.get("score_threshold"):
+                    continue
+            metadatas = res["scalarData"]
+            id = res["id"]
+            text = metadatas[self._text_key]["fields"][0]["data"]
+            metadata = {"id": id, "text": text, "score": score}
+            for meta_key in metadatas.keys():
+                metadata[meta_key] = metadatas[meta_key]["fields"][0]["data"]
+            docs.append((Document(page_content=text, metadata=metadata), score))
+
+        return docs
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        search_params: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        results = self._client.vector_search(
+            self._index_name, [embedding], search_params=search_params, top_k=k
+        )
+
+        mmr_selected = maximal_marginal_relevance(
+            np.array([embedding], dtype=np.float32),
+            [
+                item["vector"]["floatValues"]
+                for item in results[0]["vectorWithDistances"]
+            ],
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+        selected = []
+        for i in mmr_selected:
+            meta_data = {}
+            for k, v in results[0]["vectorWithDistances"][i]["scalarData"].items():
+                meta_data.update({str(k): v["fields"][0]["data"]})
+            selected.append(meta_data)
+        return [
+            Document(page_content=metadata.pop(self._text_key), metadata=metadata)
+            for metadata in selected
+        ]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        search_params: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        embedding = self._embedding.embed_query(query)
+        return self.max_marginal_relevance_search_by_vector(
+            embedding, k, fetch_k, lambda_mult, search_params
+        )
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        text_key: str = "text",
+        index_name: Optional[str] = None,
+        dimension: int = 1024,
+        client: Any = None,
+        host: List[str] = ["172.20.31.10:13000"],
+        user: str = "root",
+        password: str = "123123",
+        batch_size: int = 500,
+        **kwargs: Any,
+    ) -> Dingo:
+        """Construct Dingo wrapper from raw documents.
+
+                This is a user friendly interface that:
+                    1. Embeds documents.
+                    2. Adds the documents to a provided Dingo index
+
+                This is intended to be a quick way to get started.
+
+                Example:
+                    .. code-block:: python
+
+                        from langchain_community.vectorstores import Dingo
+                        from langchain_community.embeddings import OpenAIEmbeddings
+                        import dingodb
+        sss
+                        embeddings = OpenAIEmbeddings()
+                        dingo = Dingo.from_texts(
+                            texts,
+                            embeddings,
+                            index_name="langchain-demo"
+                        )
+        """
+        try:
+            import dingodb
+        except ImportError:
+            raise ImportError(
+                "Could not import dingo python package. "
+                "Please install it with `pip install dingodb`."
+            )
+
+        if client is not None:
+            dingo_client = client
+        else:
+            try:
+                # connect to dingo db
+                dingo_client = dingodb.DingoDB(user, password, host)
+            except ValueError as e:
+                raise ValueError(f"Dingo failed to connect: {e}")
+        if kwargs is not None and kwargs.get("self_id") is True:
+            if (
+                index_name is not None
+                and index_name not in dingo_client.get_index()
+                and index_name.upper() not in dingo_client.get_index()
+            ):
+                dingo_client.create_index(
+                    index_name, dimension=dimension, auto_id=False
+                )
+        else:
+            if (
+                index_name is not None
+                and index_name not in dingo_client.get_index()
+                and index_name.upper() not in dingo_client.get_index()
+            ):
+                dingo_client.create_index(index_name, dimension=dimension)
+
+        # Embed and create the documents
+
+        ids = ids or [str(uuid.uuid4().int)[:13] for _ in texts]
+        metadatas_list = []
+        texts = list(texts)
+        embeds = embedding.embed_documents(texts)
+        for i, text in enumerate(texts):
+            metadata = metadatas[i] if metadatas else {}
+            metadata[text_key] = text
+            metadatas_list.append(metadata)
+
+        # upsert to Dingo
+        for i in range(0, len(list(texts)), batch_size):
+            j = i + batch_size
+            add_res = dingo_client.vector_add(
+                index_name, metadatas_list[i:j], embeds[i:j], ids[i:j]
+            )
+            if not add_res:
+                raise Exception("vector add fail")
+        return cls(embedding, text_key, client=dingo_client, index_name=index_name)
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Delete by vector IDs or filter.
+        Args:
+            ids: List of ids to delete.
+        """
+
+        if ids is None:
+            raise ValueError("No ids provided to delete.")
+
+        return self._client.vector_delete(self._index_name, ids=ids)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__init__.py b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b5877fec88ba1a878b64a54bb58d03b901c2f9dd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__init__.py
@@ -0,0 +1,7 @@
+from langchain_community.vectorstores.docarray.hnsw import DocArrayHnswSearch
+from langchain_community.vectorstores.docarray.in_memory import DocArrayInMemorySearch
+
+__all__ = [
+    "DocArrayHnswSearch",
+    "DocArrayInMemorySearch",
+]
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..67900a566dfbebcb8f365dbc4734f3bff7593fc3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1fdeb9a5afb29ad8ab50457655853b54dc36a9a3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__pycache__/hnsw.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__pycache__/hnsw.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..119c1313c91f5be684287cee3547c05b93710491
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__pycache__/hnsw.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__pycache__/in_memory.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__pycache__/in_memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..30c12b958ee86f59d2a2d8ff6c4810a47bac64e5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/__pycache__/in_memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/docarray/base.py b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..4075cde9ea891ca1655c0fa6f49730b9dabb19b7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/base.py
@@ -0,0 +1,203 @@
+from abc import ABC
+from typing import TYPE_CHECKING, Any, Iterable, List, Optional, Tuple, Type
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import Field
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+if TYPE_CHECKING:
+    from docarray import BaseDoc
+    from docarray.index.abstract import BaseDocIndex
+
+
+def _check_docarray_import() -> None:
+    try:
+        import docarray
+
+        da_version = docarray.__version__.split(".")
+        if int(da_version[0]) == 0 and int(da_version[1]) <= 31:
+            raise ImportError(
+                f"To use the DocArrayHnswSearch VectorStore the docarray "
+                f"version >=0.32.0 is expected, received: {docarray.__version__}."
+                f"To upgrade, please run: `pip install -U docarray`."
+            )
+    except ImportError:
+        raise ImportError(
+            "Could not import docarray python package. "
+            'Please install it with `pip install "langchain[docarray]"`.'
+        )
+
+
+class DocArrayIndex(VectorStore, ABC):
+    """Base class for `DocArray` based vector stores."""
+
+    def __init__(
+        self,
+        doc_index: "BaseDocIndex",
+        embedding: Embeddings,
+    ):
+        """Initialize a vector store from DocArray's DocIndex."""
+        self.doc_index = doc_index
+        self.embedding = embedding
+
+    @staticmethod
+    def _get_doc_cls(**embeddings_params: Any) -> Type["BaseDoc"]:
+        """Get docarray Document class describing the schema of DocIndex."""
+        from docarray import BaseDoc
+        from docarray.typing import NdArray
+
+        class DocArrayDoc(BaseDoc):
+            text: Optional[str] = Field(default=None, required=False)
+            embedding: Optional[NdArray] = Field(**embeddings_params)
+            metadata: Optional[dict] = Field(default=None, required=False)
+
+        return DocArrayDoc
+
+    @property
+    def doc_cls(self) -> Type["BaseDoc"]:
+        if self.doc_index._schema is None:
+            raise ValueError("doc_index expected to have non-null _schema attribute.")
+        return self.doc_index._schema
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Embed texts and add to the vector store.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        ids: List[str] = []
+        embeddings = self.embedding.embed_documents(list(texts))
+        for i, (t, e) in enumerate(zip(texts, embeddings)):
+            m = metadatas[i] if metadatas else {}
+            doc = self.doc_cls(text=t, embedding=e, metadata=m)
+            self.doc_index.index([doc])
+            ids.append(str(doc.id))
+
+        return ids
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of documents most similar to the query text and
+            cosine distance in float for each.
+            Lower score represents more similarity.
+        """
+        query_embedding = self.embedding.embed_query(query)
+        query_doc = self.doc_cls(embedding=query_embedding)  # type: ignore
+        docs, scores = self.doc_index.find(query_doc, search_field="embedding", limit=k)
+
+        result = [
+            (Document(page_content=doc.text, metadata=doc.metadata), score)
+            for doc, score in zip(docs, scores)
+        ]
+        return result
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        results = self.similarity_search_with_score(query, k=k, **kwargs)
+        return [doc for doc, _ in results]
+
+    def _similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs and relevance scores, normalized on a scale from 0 to 1.
+
+        0 is dissimilar, 1 is most similar.
+        """
+        raise NotImplementedError()
+
+    def similarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+
+        query_doc = self.doc_cls(embedding=embedding)  # type: ignore
+        docs = self.doc_index.find(
+            query_doc, search_field="embedding", limit=k
+        ).documents
+
+        result = [
+            Document(page_content=doc.text, metadata=doc.metadata) for doc in docs
+        ]
+        return result
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        query_embedding = self.embedding.embed_query(query)
+        query_doc = self.doc_cls(embedding=query_embedding)  # type: ignore
+
+        docs = self.doc_index.find(
+            query_doc, search_field="embedding", limit=fetch_k
+        ).documents
+
+        mmr_selected = maximal_marginal_relevance(
+            np.array(query_embedding), docs.embedding, k=k
+        )
+        results = [
+            Document(page_content=docs[idx].text, metadata=docs[idx].metadata)
+            for idx in mmr_selected
+        ]
+        return results
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/docarray/hnsw.py b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/hnsw.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b33f7a0d58a66d98065a7b6217def28d3a832eb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/hnsw.py
@@ -0,0 +1,109 @@
+from __future__ import annotations
+
+from typing import Any, List, Literal, Optional
+
+from langchain_core.embeddings import Embeddings
+
+from langchain_community.vectorstores.docarray.base import (
+    DocArrayIndex,
+    _check_docarray_import,
+)
+
+
+class DocArrayHnswSearch(DocArrayIndex):
+    """`HnswLib` storage using `DocArray` package.
+
+    To use it, you should have the ``docarray`` package with version >=0.32.0 installed.
+    You can install it with `pip install "docarray[hnswlib]"`.
+    """
+
+    @classmethod
+    def from_params(
+        cls,
+        embedding: Embeddings,
+        work_dir: str,
+        n_dim: int,
+        dist_metric: Literal["cosine", "ip", "l2"] = "cosine",
+        max_elements: int = 1024,
+        index: bool = True,
+        ef_construction: int = 200,
+        ef: int = 10,
+        M: int = 16,
+        allow_replace_deleted: bool = True,
+        num_threads: int = 1,
+        **kwargs: Any,
+    ) -> DocArrayHnswSearch:
+        """Initialize DocArrayHnswSearch store.
+
+        Args:
+            embedding (Embeddings): Embedding function.
+            work_dir (str): path to the location where all the data will be stored.
+            n_dim (int): dimension of an embedding.
+            dist_metric (str): Distance metric for DocArrayHnswSearch can be one of:
+                "cosine", "ip", and "l2". Defaults to "cosine".
+            max_elements (int): Maximum number of vectors that can be stored.
+                Defaults to 1024.
+            index (bool): Whether an index should be built for this field.
+                Defaults to True.
+            ef_construction (int): defines a construction time/accuracy trade-off.
+                Defaults to 200.
+            ef (int): parameter controlling query time/accuracy trade-off.
+                Defaults to 10.
+            M (int): parameter that defines the maximum number of outgoing
+                connections in the graph. Defaults to 16.
+            allow_replace_deleted (bool): Enables replacing of deleted elements
+                with new added ones. Defaults to True.
+            num_threads (int): Sets the number of cpu threads to use. Defaults to 1.
+            **kwargs: Other keyword arguments to be passed to the get_doc_cls method.
+        """
+        _check_docarray_import()
+        from docarray.index import HnswDocumentIndex
+
+        doc_cls = cls._get_doc_cls(
+            dim=n_dim,
+            space=dist_metric,
+            max_elements=max_elements,
+            index=index,
+            ef_construction=ef_construction,
+            ef=ef,
+            M=M,
+            allow_replace_deleted=allow_replace_deleted,
+            num_threads=num_threads,
+            **kwargs,
+        )
+        doc_index = HnswDocumentIndex[doc_cls](work_dir=work_dir)  # type: ignore
+        return cls(doc_index, embedding)
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        work_dir: Optional[str] = None,
+        n_dim: Optional[int] = None,
+        **kwargs: Any,
+    ) -> DocArrayHnswSearch:
+        """Create an DocArrayHnswSearch store and insert data.
+
+
+        Args:
+            texts (List[str]): Text data.
+            embedding (Embeddings): Embedding function.
+            metadatas (Optional[List[dict]]): Metadata for each text if it exists.
+                Defaults to None.
+            work_dir (str): path to the location where all the data will be stored.
+            n_dim (int): dimension of an embedding.
+            **kwargs: Other keyword arguments to be passed to the __init__ method.
+
+        Returns:
+            DocArrayHnswSearch Vector Store
+        """
+        if work_dir is None:
+            raise ValueError("`work_dir` parameter has not been set.")
+        if n_dim is None:
+            raise ValueError("`n_dim` parameter has not been set.")
+
+        store = cls.from_params(embedding, work_dir, n_dim, **kwargs)
+        store.add_texts(texts=texts, metadatas=metadatas)
+        return store
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/docarray/in_memory.py b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/in_memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..468e5be20f5dfbabdf3a27d7b7fa55a3b8056164
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/docarray/in_memory.py
@@ -0,0 +1,70 @@
+"""Wrapper around in-memory storage."""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Literal, Optional
+
+from langchain_core.embeddings import Embeddings
+
+from langchain_community.vectorstores.docarray.base import (
+    DocArrayIndex,
+    _check_docarray_import,
+)
+
+
+class DocArrayInMemorySearch(DocArrayIndex):
+    """In-memory `DocArray` storage for exact search.
+
+    To use it, you should have the ``docarray`` package with version >=0.32.0 installed.
+    You can install it with `pip install "langchain[docarray]"`.
+    """
+
+    @classmethod
+    def from_params(
+        cls,
+        embedding: Embeddings,
+        metric: Literal[
+            "cosine_sim", "euclidian_dist", "sgeuclidean_dist"
+        ] = "cosine_sim",
+        **kwargs: Any,
+    ) -> DocArrayInMemorySearch:
+        """Initialize DocArrayInMemorySearch store.
+
+        Args:
+            embedding (Embeddings): Embedding function.
+            metric (str): metric for exact nearest-neighbor search.
+                Can be one of: "cosine_sim", "euclidean_dist" and "sqeuclidean_dist".
+                Defaults to "cosine_sim".
+            **kwargs: Other keyword arguments to be passed to the get_doc_cls method.
+        """
+        _check_docarray_import()
+        from docarray.index import InMemoryExactNNIndex
+
+        doc_cls = cls._get_doc_cls(space=metric, **kwargs)
+        doc_index = InMemoryExactNNIndex[doc_cls]()  # type: ignore
+        return cls(doc_index, embedding)
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        **kwargs: Any,
+    ) -> DocArrayInMemorySearch:
+        """Create an DocArrayInMemorySearch store and insert data.
+
+        Args:
+            texts (List[str]): Text data.
+            embedding (Embeddings): Embedding function.
+            metadatas (Optional[List[Dict[Any, Any]]]): Metadata for each text
+                if it exists. Defaults to None.
+            metric (str): metric for exact nearest-neighbor search.
+                Can be one of: "cosine_sim", "euclidean_dist" and "sqeuclidean_dist".
+                Defaults to "cosine_sim".
+
+        Returns:
+            DocArrayInMemorySearch Vector Store
+        """
+        store = cls.from_params(embedding, **kwargs)
+        store.add_texts(texts=texts, metadatas=metadatas)
+        return store
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/documentdb.py b/llm/Lib/site-packages/langchain_community/vectorstores/documentdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..847740d2e45cf127673d1db8f454a8b314d609d4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/documentdb.py
@@ -0,0 +1,361 @@
+from __future__ import annotations
+
+import logging
+from enum import Enum
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    Generator,
+    Iterable,
+    List,
+    Optional,
+    TypeVar,
+    Union,
+)
+
+from langchain_core.documents import Document
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    from langchain_core.embeddings import Embeddings
+    from pymongo.collection import Collection
+
+
+# Before Python 3.11 native StrEnum is not available
+class DocumentDBSimilarityType(str, Enum):
+    """DocumentDB Similarity Type as enumerator."""
+
+    COS = "cosine"
+    """Cosine similarity"""
+    DOT = "dotProduct"
+    """Dot product"""
+    EUC = "euclidean"
+    """Euclidean distance"""
+
+
+DocumentDBDocumentType = TypeVar("DocumentDBDocumentType", bound=Dict[str, Any])
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_INSERT_BATCH_SIZE = 128
+
+
+class DocumentDBVectorSearch(VectorStore):
+    """`Amazon DocumentDB (with MongoDB compatibility)` vector store.
+    Please refer to the official Vector Search documentation for more details:
+    https://docs.aws.amazon.com/documentdb/latest/developerguide/vector-search.html
+
+    To use, you should have both:
+    - the ``pymongo`` python package installed
+    - a connection string and credentials associated with a DocumentDB cluster
+
+    Example:
+        . code-block:: python
+
+            from langchain_community.vectorstores import DocumentDBVectorSearch
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+            from pymongo import MongoClient
+
+            mongo_client = MongoClient("<YOUR-CONNECTION-STRING>")
+            collection = mongo_client["<db_name>"]["<collection_name>"]
+            embeddings = OpenAIEmbeddings()
+            vectorstore = DocumentDBVectorSearch(collection, embeddings)
+    """
+
+    def __init__(
+        self,
+        collection: Collection[DocumentDBDocumentType],
+        embedding: Embeddings,
+        *,
+        index_name: str = "vectorSearchIndex",
+        text_key: str = "textContent",
+        embedding_key: str = "vectorContent",
+    ):
+        """Constructor for DocumentDBVectorSearch
+
+        Args:
+            collection: MongoDB collection to add the texts to.
+            embedding: Text embedding model to use.
+            index_name: Name of the Vector Search index.
+            text_key: MongoDB field that will contain the text
+                for each document.
+            embedding_key: MongoDB field that will contain the embedding
+                for each document.
+        """
+        self._collection = collection
+        self._embedding = embedding
+        self._index_name = index_name
+        self._text_key = text_key
+        self._embedding_key = embedding_key
+        self._similarity_type = DocumentDBSimilarityType.COS
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self._embedding
+
+    def get_index_name(self) -> str:
+        """Returns the index name
+
+        Returns:
+            Returns the index name
+
+        """
+        return self._index_name
+
+    @classmethod
+    def from_connection_string(
+        cls,
+        connection_string: str,
+        namespace: str,
+        embedding: Embeddings,
+        **kwargs: Any,
+    ) -> DocumentDBVectorSearch:
+        """Creates an Instance of DocumentDBVectorSearch from a Connection String
+
+        Args:
+            connection_string: The DocumentDB cluster endpoint connection string
+            namespace: The namespace (database.collection)
+            embedding: The embedding utility
+            **kwargs: Dynamic keyword arguments
+
+        Returns:
+            an instance of the vector store
+
+        """
+        try:
+            from pymongo import MongoClient
+        except ImportError:
+            raise ImportError(
+                "Could not import pymongo, please install it with "
+                "`pip install pymongo`."
+            )
+        client: MongoClient = MongoClient(connection_string)
+        db_name, collection_name = namespace.split(".")
+        collection = client[db_name][collection_name]
+        return cls(collection, embedding, **kwargs)
+
+    def index_exists(self) -> bool:
+        """Verifies if the specified index name during instance
+            construction exists on the collection
+
+        Returns:
+          Returns True on success and False if no such index exists
+            on the collection
+        """
+        cursor = self._collection.list_indexes()
+        index_name = self._index_name
+
+        for res in cursor:
+            current_index_name = res.pop("name")
+            if current_index_name == index_name:
+                return True
+
+        return False
+
+    def delete_index(self) -> None:
+        """Deletes the index specified during instance construction if it exists"""
+        if self.index_exists():
+            self._collection.drop_index(self._index_name)
+            # Raises OperationFailure on an error (e.g. trying to drop
+            # an index that does not exist)
+
+    def create_index(
+        self,
+        dimensions: int = 1536,
+        similarity: DocumentDBSimilarityType = DocumentDBSimilarityType.COS,
+        m: int = 16,
+        ef_construction: int = 64,
+    ) -> dict[str, Any]:
+        """Creates an index using the index name specified at
+            instance construction
+
+        Args:
+            dimensions: Number of dimensions for vector similarity.
+                The maximum number of supported dimensions is 2000
+
+            similarity: Similarity algorithm to use with the HNSW index.
+
+            m: Specifies the max number of connections for an HNSW index.
+                Large impact on memory consumption.
+
+            ef_construction: Specifies the size of the dynamic candidate list
+                for constructing the graph for HNSW index. Higher values lead
+                to more accurate results but slower indexing speed.
+
+                Possible options are:
+                    - DocumentDBSimilarityType.COS (cosine distance),
+                    - DocumentDBSimilarityType.EUC (Euclidean distance), and
+                    - DocumentDBSimilarityType.DOT (dot product).
+
+        Returns:
+            An object describing the created index
+
+        """
+        self._similarity_type = similarity
+
+        # prepare the command
+        create_index_commands = {
+            "createIndexes": self._collection.name,
+            "indexes": [
+                {
+                    "name": self._index_name,
+                    "key": {self._embedding_key: "vector"},
+                    "vectorOptions": {
+                        "type": "hnsw",
+                        "similarity": similarity,
+                        "dimensions": dimensions,
+                        "m": m,
+                        "efConstruction": ef_construction,
+                    },
+                }
+            ],
+        }
+
+        # retrieve the database object
+        current_database = self._collection.database
+
+        # invoke the command from the database object
+        create_index_responses: dict[str, Any] = current_database.command(
+            create_index_commands
+        )
+
+        return create_index_responses
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict[str, Any]]] = None,
+        **kwargs: Any,
+    ) -> List:
+        batch_size = kwargs.get("batch_size", DEFAULT_INSERT_BATCH_SIZE)
+        _metadatas: Union[List, Generator] = metadatas or ({} for _ in texts)
+        texts_batch = []
+        metadatas_batch = []
+        result_ids = []
+        for i, (text, metadata) in enumerate(zip(texts, _metadatas)):
+            texts_batch.append(text)
+            metadatas_batch.append(metadata)
+            if (i + 1) % batch_size == 0:
+                result_ids.extend(self._insert_texts(texts_batch, metadatas_batch))
+                texts_batch = []
+                metadatas_batch = []
+        if texts_batch:
+            result_ids.extend(self._insert_texts(texts_batch, metadatas_batch))
+        return result_ids
+
+    def _insert_texts(self, texts: List[str], metadatas: List[Dict[str, Any]]) -> List:
+        """Used to Load Documents into the collection
+
+        Args:
+            texts: The list of documents strings to load
+            metadatas: The list of metadata objects associated with each document
+
+        Returns:
+
+        """
+        # If the text is empty, then exit early
+        if not texts:
+            return []
+
+        # Embed and create the documents
+        embeddings = self._embedding.embed_documents(texts)
+        to_insert = [
+            {self._text_key: t, self._embedding_key: embedding, **m}
+            for t, m, embedding in zip(texts, metadatas, embeddings)
+        ]
+        # insert the documents in DocumentDB
+        insert_result = self._collection.insert_many(to_insert)  # type: ignore
+        return insert_result.inserted_ids
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection: Optional[Collection[DocumentDBDocumentType]] = None,
+        **kwargs: Any,
+    ) -> DocumentDBVectorSearch:
+        if collection is None:
+            raise ValueError("Must provide 'collection' named parameter.")
+        vectorstore = cls(collection, embedding, **kwargs)
+        vectorstore.add_texts(texts, metadatas=metadatas)
+        return vectorstore
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        if ids is None:
+            raise ValueError("No document ids provided to delete.")
+
+        for document_id in ids:
+            self.delete_document_by_id(document_id)
+        return True
+
+    def delete_document_by_id(self, document_id: Optional[str] = None) -> None:
+        """Removes a Specific Document by Id
+
+        Args:
+            document_id: The document identifier
+        """
+        try:
+            from bson.objectid import ObjectId
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import bson, please install with `pip install bson`."
+            ) from e
+        if document_id is None:
+            raise ValueError("No document id provided to delete.")
+
+        self._collection.delete_one({"_id": ObjectId(document_id)})
+
+    def _similarity_search_without_score(
+        self, embeddings: List[float], k: int = 4, ef_search: int = 40
+    ) -> List[Document]:
+        """Returns a list of documents.
+
+        Args:
+            embeddings: The query vector
+            k: the number of documents to return
+            ef_search: Specifies the size of the dynamic candidate list
+                that HNSW index uses during search. A higher value of
+                efSearch provides better recall at cost of speed.
+
+        Returns:
+            A list of documents closest to the query vector
+        """
+        pipeline: List[dict[str, Any]] = [
+            {
+                "$search": {
+                    "vectorSearch": {
+                        "vector": embeddings,
+                        "path": self._embedding_key,
+                        "similarity": self._similarity_type,
+                        "k": k,
+                        "efSearch": ef_search,
+                    }
+                }
+            }
+        ]
+
+        cursor = self._collection.aggregate(pipeline)
+
+        docs = []
+
+        for res in cursor:
+            text = res.pop(self._text_key)
+            docs.append(Document(page_content=text, metadata=res))
+
+        return docs
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        ef_search: int = 40,
+        **kwargs: Any,
+    ) -> List[Document]:
+        embeddings = self._embedding.embed_query(query)
+        docs = self._similarity_search_without_score(
+            embeddings=embeddings, k=k, ef_search=ef_search
+        )
+        return [doc for doc in docs]
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/duckdb.py b/llm/Lib/site-packages/langchain_community/vectorstores/duckdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..dd3b1611e87ec4115afb9b897eaab6d5c97f3357
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/duckdb.py
@@ -0,0 +1,263 @@
+# mypy: disable-error-code=func-returns-value
+from __future__ import annotations
+
+import json
+import uuid
+from typing import Any, Iterable, List, Optional, Type
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VST, VectorStore
+
+
+class DuckDB(VectorStore):
+    """`DuckDB` vector store.
+
+    This class provides a vector store interface for adding texts and performing
+    similarity searches using DuckDB.
+
+    For more information about DuckDB, see: https://duckdb.org/
+
+    This integration requires the `duckdb` Python package.
+    You can install it with `pip install duckdb`.
+
+    *Security Notice*: The default DuckDB configuration is not secure.
+
+        By **default**, DuckDB can interact with files across the entire file system,
+        which includes abilities to read, write, and list files and directories.
+        It can also access some python variables present in the global namespace.
+
+        When using this DuckDB vectorstore, we suggest that you initialize the
+        DuckDB connection with a secure configuration.
+
+        For example, you can set `enable_external_access` to `false` in the connection
+        configuration to disable external access to the DuckDB connection.
+
+        You can view the DuckDB configuration options here:
+
+        https://duckdb.org/docs/configuration/overview.html
+
+        Please review other relevant security considerations in the DuckDB
+        documentation. (e.g., "autoinstall_known_extensions": "false",
+        "autoload_known_extensions": "false")
+
+        See https://python.langchain.com/docs/security for more information.
+
+    Args:
+        connection: Optional DuckDB connection
+        embedding: The embedding function or model to use for generating embeddings.
+        vector_key: The column name for storing vectors. Defaults to `embedding`.
+        id_key: The column name for storing unique identifiers. Defaults to `id`.
+        text_key: The column name for storing text. Defaults to `text`.
+        table_name: The name of the table to use for storing embeddings. Defaults to
+          `embeddings`.
+
+    Example:
+        .. code-block:: python
+
+            import duckdb
+            conn = duckdb.connect(database=':memory:',
+                config={
+                    # Sample configuration to restrict some DuckDB capabilities
+                    # List is not exhaustive. Please review DuckDB documentation.
+                        "enable_external_access": "false",
+                        "autoinstall_known_extensions": "false",
+                        "autoload_known_extensions": "false"
+                    }
+            )
+            embedding_function = ... # Define or import your embedding function here
+            vector_store = DuckDB(conn, embedding_function)
+            vector_store.add_texts(['text1', 'text2'])
+            result = vector_store.similarity_search('text1')
+    """
+
+    def __init__(
+        self,
+        *,
+        connection: Optional[Any] = None,
+        embedding: Embeddings,
+        vector_key: str = "embedding",
+        id_key: str = "id",
+        text_key: str = "text",
+        table_name: str = "vectorstore",
+    ):
+        """Initialize with DuckDB connection and setup for vector storage."""
+        try:
+            import duckdb
+        except ImportError:
+            raise ImportError(
+                "Could not import duckdb package. "
+                "Please install it with `pip install duckdb`."
+            )
+        self.duckdb = duckdb
+        self._embedding = embedding
+        self._vector_key = vector_key
+        self._id_key = id_key
+        self._text_key = text_key
+        self._table_name = table_name
+
+        if self._embedding is None:
+            raise ValueError("An embedding function or model must be provided.")
+
+        if connection is None:
+            import warnings
+
+            warnings.warn(
+                "No DuckDB connection provided. A new connection will be created."
+                "This connection is running in memory and no data will be persisted."
+                "To persist data, specify `connection=duckdb.connect(...)` when using "
+                "the API. Please review the documentation of the vectorstore for "
+                "security recommendations on configuring the connection."
+            )
+
+        self._connection = connection or self.duckdb.connect(
+            database=":memory:", config={"enable_external_access": "false"}
+        )
+        self._ensure_table()
+        self._table = self._connection.table(self._table_name)
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        """Returns the embedding object used by the vector store."""
+        return self._embedding
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Turn texts into embedding and add it to the database using Pandas DataFrame
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: Additional parameters including optional 'ids' to associate
+              with the texts.
+
+        Returns:
+            List of ids of the added texts.
+        """
+
+        # Extract ids from kwargs or generate new ones if not provided
+        ids = kwargs.pop("ids", [str(uuid.uuid4()) for _ in texts])
+
+        # Embed texts and create documents
+        ids = ids or [str(uuid.uuid4()) for _ in texts]
+        embeddings = self._embedding.embed_documents(list(texts))
+        for idx, text in enumerate(texts):
+            embedding = embeddings[idx]
+            # Serialize metadata if present, else default to None
+            metadata = (
+                json.dumps(metadatas[idx])
+                if metadatas and idx < len(metadatas)
+                else None
+            )
+            self._connection.execute(
+                f"INSERT INTO {self._table_name} VALUES (?,?,?,?)",
+                [ids[idx], text, embedding, metadata],
+            )
+        return ids
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Performs a similarity search for a given query string.
+
+        Args:
+            query: The query string to search for.
+            k: The number of similar texts to return.
+
+        Returns:
+            A list of Documents most similar to the query.
+        """
+        embedding = self._embedding.embed_query(query)  # type: ignore
+        list_cosine_similarity = self.duckdb.FunctionExpression(
+            "list_cosine_similarity",
+            self.duckdb.ColumnExpression(self._vector_key),
+            self.duckdb.ConstantExpression(embedding),
+        )
+        docs = (
+            self._table.select(
+                *[
+                    self.duckdb.StarExpression(exclude=[]),
+                    list_cosine_similarity.alias("similarity"),
+                ]
+            )
+            .order("similarity desc")
+            .limit(k)
+            .select(
+                self.duckdb.StarExpression(exclude=["similarity", self._vector_key])
+            )
+            .fetchdf()
+        )
+        return [
+            Document(
+                page_content=docs[self._text_key][idx],
+                metadata=json.loads(docs["metadata"][idx])
+                if docs["metadata"][idx]
+                else {},
+            )
+            for idx in range(len(docs))
+        ]
+
+    @classmethod
+    def from_texts(
+        cls: Type[VST],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> DuckDB:
+        """Creates an instance of DuckDB and populates it with texts and
+          their embeddings.
+
+        Args:
+            texts: List of strings to add to the vector store.
+            embedding: The embedding function or model to use for generating embeddings.
+            metadatas: Optional list of metadata dictionaries associated with the texts.
+            **kwargs: Additional keyword arguments including:
+                - connection: DuckDB connection. If not provided, a new connection will
+                  be created.
+                - vector_key: The column name for storing vectors. Default "vector".
+                - id_key: The column name for storing unique identifiers. Default "id".
+                - text_key: The column name for storing text. Defaults to "text".
+                - table_name: The name of the table to use for storing embeddings.
+                    Defaults to "embeddings".
+
+        Returns:
+            An instance of DuckDB with the provided texts and their embeddings added.
+        """
+
+        # Extract kwargs for DuckDB instance creation
+        connection = kwargs.get("connection", None)
+        vector_key = kwargs.get("vector_key", "vector")
+        id_key = kwargs.get("id_key", "id")
+        text_key = kwargs.get("text_key", "text")
+        table_name = kwargs.get("table_name", "embeddings")
+
+        # Create an instance of DuckDB
+        instance = DuckDB(
+            connection=connection,
+            embedding=embedding,
+            vector_key=vector_key,
+            id_key=id_key,
+            text_key=text_key,
+            table_name=table_name,
+        )
+        # Add texts and their embeddings to the DuckDB vector store
+        instance.add_texts(texts, metadatas=metadatas, **kwargs)
+
+        return instance
+
+    def _ensure_table(self) -> None:
+        """Ensures the table for storing embeddings exists."""
+        create_table_sql = f"""
+        CREATE TABLE IF NOT EXISTS {self._table_name} (
+            {self._id_key} VARCHAR PRIMARY KEY,
+            {self._text_key} VARCHAR,
+            {self._vector_key} FLOAT[],
+            metadata VARCHAR
+        )
+        """
+        self._connection.execute(create_table_sql)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/ecloud_vector_search.py b/llm/Lib/site-packages/langchain_community/vectorstores/ecloud_vector_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..58401336f8e0c1f8deaf328a4e7cb037cf3fb09d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/ecloud_vector_search.py
@@ -0,0 +1,580 @@
+import logging
+import uuid
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Union,
+)
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    from elasticsearch import Elasticsearch
+
+logger = logging.getLogger(__name__)
+
+
+class EcloudESVectorStore(VectorStore):
+    """`ecloud Elasticsearch` vector store.
+
+    Example:
+        .. code-block:: python
+
+            from langchain.vectorstores import EcloudESVectorStore
+            from langchain.embeddings.openai import OpenAIEmbeddings
+
+            embeddings = OpenAIEmbeddings()
+            vectorstore = EcloudESVectorStore(
+                embedding=OpenAIEmbeddings(),
+                index_name="langchain-demo",
+                es_url="http://localhost:9200"
+            )
+
+    Args:
+        index_name: Name of the Elasticsearch index to create.
+        es_url: URL of the ecloud Elasticsearch instance to connect to.
+        user: Username to use when connecting to Elasticsearch.
+        password: Password to use when connecting to Elasticsearch.
+
+    """
+
+    def __init__(
+        self,
+        index_name: str,
+        es_url: str,
+        user: Optional[str] = None,
+        password: Optional[str] = None,
+        embedding: Optional[Embeddings] = None,
+        **kwargs: Optional[dict],
+    ) -> None:
+        self.embedding = embedding
+        self.index_name = index_name
+        self.text_field = kwargs.get("text_field", "text")
+        self.vector_field = kwargs.get("vector_field", "vector")
+        self.vector_type = kwargs.get("vector_type", "knn_dense_float_vector")
+        self.vector_params = kwargs.get("vector_params") or {}
+        self.model = self.vector_params.get("model", "")
+        self.index_settings = kwargs.get("index_settings") or {}
+
+        key_list = [
+            "text_field",
+            "vector_field",
+            "vector_type",
+            "vector_params",
+            "index_settings",
+        ]
+        [kwargs.pop(key, None) for key in key_list]
+        if es_url is not None:
+            self.client = EcloudESVectorStore.es_client(
+                es_url=es_url, username=user, password=password, **kwargs
+            )
+        else:
+            raise ValueError("""Please specified a es connection url.""")
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self.embedding
+
+    @staticmethod
+    def es_client(
+        *,
+        es_url: Optional[str] = None,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        **kwargs: Optional[dict],
+    ) -> "Elasticsearch":
+        try:
+            import elasticsearch
+        except ImportError:
+            raise ImportError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+
+        connection_params: Dict[str, Any] = {"hosts": [es_url]}
+
+        if username and password:
+            connection_params["http_auth"] = (username, password)
+        connection_params.update(kwargs)
+
+        es_client = elasticsearch.Elasticsearch(**connection_params)
+        try:
+            es_client.info()
+        except Exception as e:
+            logger.error(f"Error connecting to Elasticsearch: {e}")
+            raise e
+        return es_client
+
+    def _create_index_if_not_exists(self, dims_length: Optional[int] = None) -> None:
+        """Create the index if it doesn't already exist.
+
+        Args:
+            dims_length: Length of the embedding vectors.
+        """
+
+        if self.client.indices.exists(index=self.index_name):
+            logger.info(f"Index {self.index_name} already exists. Skipping creation.")
+
+        else:
+            if dims_length is None:
+                raise ValueError(
+                    "Cannot create index without specifying dims_length "
+                    + "when the index doesn't already exist. "
+                )
+
+            indexMapping = self._index_mapping(dims_length=dims_length)
+
+            logger.debug(
+                f"Creating index {self.index_name} with mappings {indexMapping}"
+            )
+
+            self.client.indices.create(
+                index=self.index_name,
+                body={
+                    "settings": {"index.knn": True, **self.index_settings},
+                    "mappings": {"properties": indexMapping},
+                },
+            )
+
+    def _index_mapping(self, dims_length: Union[int, None]) -> Dict:
+        """
+        Executes when the index is created.
+
+        Args:
+            dims_length: Numeric length of the embedding vectors,
+                        or None if not using vector-based query.
+            index_params: The extra pamameters for creating index.
+
+        Returns:
+            Dict: The Elasticsearch settings and mappings for the strategy.
+        """
+        model = self.vector_params.get("model", "")
+        if "lsh" == model:
+            mapping: Dict[Any, Any] = {
+                self.vector_field: {
+                    "type": self.vector_type,
+                    "knn": {
+                        "dims": dims_length,
+                        "model": "lsh",
+                        "similarity": self.vector_params.get("similarity", "cosine"),
+                        "L": self.vector_params.get("L", 99),
+                        "k": self.vector_params.get("k", 1),
+                    },
+                }
+            }
+            if mapping[self.vector_field]["knn"]["similarity"] == "l2":
+                mapping[self.vector_field]["knn"]["w"] = self.vector_params.get("w", 3)
+            return mapping
+        elif "permutation_lsh" == model:
+            return {
+                self.vector_field: {
+                    "type": self.vector_type,
+                    "knn": {
+                        "dims": dims_length,
+                        "model": "permutation_lsh",
+                        "k": self.vector_params.get("k", 10),
+                        "similarity": self.vector_params.get("similarity", "cosine"),
+                        "repeating": self.vector_params.get("repeating", True),
+                    },
+                }
+            }
+        else:
+            return {
+                self.vector_field: {
+                    "type": self.vector_type,
+                    "knn": {"dims": dims_length},
+                }
+            }
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Optional[bool]:
+        """Delete documents from the index.
+
+        Args:
+            ids: List of ids of documents to delete
+        """
+        try:
+            from elasticsearch.helpers import BulkIndexError, bulk
+        except ImportError:
+            raise ImportError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+
+        body = []
+
+        if ids is None:
+            raise ValueError("ids must be provided.")
+
+        for _id in ids:
+            body.append({"_op_type": "delete", "_index": self.index_name, "_id": _id})
+
+        if len(body) > 0:
+            try:
+                bulk(
+                    self.client,
+                    body,
+                    refresh=kwargs.get("refresh_indices", True),
+                    ignore_status=404,
+                )
+                logger.debug(f"Deleted {len(body)} texts from index")
+                return True
+            except BulkIndexError as e:
+                logger.error(f"Error deleting texts: {e}")
+                raise e
+        else:
+            logger.info("No documents to delete")
+            return False
+
+    def _query_body(
+        self,
+        query_vector: Union[List[float], None],
+        filter: Optional[dict] = None,
+        search_params: Dict = {},
+    ) -> Dict:
+        query_vector_body = {
+            "field": search_params.get("vector_field", self.vector_field)
+        }
+
+        if self.vector_type == "knn_dense_float_vector":
+            query_vector_body["vec"] = {"values": query_vector}
+            specific_params = self.get_dense_specific_model_similarity_params(
+                search_params
+            )
+            query_vector_body.update(specific_params)
+        else:
+            query_vector_body["vec"] = {
+                "true_indices": query_vector,
+                "total_indices": len(query_vector) if query_vector is not None else 0,
+            }
+            specific_params = self.get_sparse_specific_model_similarity_params(
+                search_params
+            )
+            query_vector_body.update(specific_params)
+
+        query_vector_body = {"knn_nearest_neighbors": query_vector_body}
+        if filter is not None and len(filter) != 0:
+            query_vector_body = {
+                "function_score": {"query": filter, "functions": [query_vector_body]}
+            }
+
+        return {
+            "size": search_params.get("size", 4),
+            "query": query_vector_body,
+        }
+
+    @staticmethod
+    def get_dense_specific_model_similarity_params(
+        search_params: Dict[str, Any],
+    ) -> Dict:
+        model = search_params.get("model", "exact")
+        similarity = search_params.get("similarity", "cosine")
+        specific_params = {"model": model, "similarity": similarity}
+        if not model == "exact":
+            if model not in ("lsh", "permutation_lsh"):
+                raise ValueError(
+                    f"vector type knn_dense_float_vector doesn't support model {model}"
+                )
+            if similarity not in ("cosine", "l2"):
+                raise ValueError(f"model exact doesn't support similarity {similarity}")
+            specific_params["candidates"] = search_params.get(
+                "candidates", search_params.get("size", 4)
+            )
+            if model == "lsh" and similarity == "l2":
+                specific_params["probes"] = search_params.get("probes", 0)
+        else:
+            if similarity not in ("cosine", "l2"):
+                raise ValueError(f"model exact don't support similarity {similarity}")
+
+        return specific_params
+
+    @staticmethod
+    def get_sparse_specific_model_similarity_params(
+        search_params: Dict[str, Any],
+    ) -> Dict:
+        model = search_params.get("model", "exact")
+        similarity = search_params.get("similarity", "hamming")
+        specific_params = {"model": model, "similarity": similarity}
+        if not model == "exact":
+            if model not in ("lsh",):
+                raise ValueError(
+                    f"vector type knn_dense_float_vector doesn't support model {model}"
+                )
+            if similarity not in ("hamming", "jaccard"):
+                raise ValueError(f"model exact doesn't support similarity {similarity}")
+            specific_params["candidates"] = search_params.get(
+                "candidates", search_params.get("size", 4)
+            )
+        else:
+            if similarity not in ("hamming", "jaccard"):
+                raise ValueError(f"model exact don't support similarity {similarity}")
+
+        return specific_params
+
+    def _search(
+        self,
+        query: Optional[str] = None,
+        query_vector: Union[List[float], None] = None,
+        filter: Optional[dict] = None,
+        custom_query: Optional[Callable[[Dict, Union[str, None]], Dict]] = None,
+        search_params: Dict = {},
+    ) -> List[Tuple[Document, float]]:
+        """Return searched documents result from ecloud ES
+
+        Args:
+            query: Text to look up documents similar to.
+            query_vector: Embedding to look up documents similar to.
+            filter: Array of ecloud ElasticSearch filter clauses to apply to the query.
+            custom_query: Function to modify the query body before it is sent to ES.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+
+        if self.embedding and query is not None:
+            query_vector = self.embedding.embed_query(query)
+
+        query_body = self._query_body(
+            query_vector=query_vector, filter=filter, search_params=search_params
+        )
+
+        if custom_query is not None:
+            query_body = custom_query(query_body, query)
+            logger.debug(f"Calling custom_query, Query body now: {query_body}")
+
+        logger.debug(f"Query body: {query_body}")
+
+        # Perform the kNN search on the ES index and return the results.
+        response = self.client.search(index=self.index_name, body=query_body)
+        logger.debug(f"response={response}")
+
+        hits = [hit for hit in response["hits"]["hits"]]
+        docs_and_scores = [
+            (
+                Document(
+                    page_content=hit["_source"][
+                        search_params.get("text_field", self.text_field)
+                    ],
+                    metadata=hit["_source"]["metadata"],
+                ),
+                hit["_score"],
+            )
+            for hit in hits
+        ]
+
+        return docs_and_scores
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return documents most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Array of Elasticsearch filter clauses to apply to the query.
+
+        Returns:
+            List of Documents most similar to the query,
+            in descending order of similarity.
+        """
+
+        results = self.similarity_search_with_score(
+            query=query, k=k, filter=filter, **kwargs
+        )
+        return [doc for doc, _ in results]
+
+    def similarity_search_with_score(
+        self, query: str, k: int, filter: Optional[dict] = None, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Return documents most similar to query, along with scores.
+
+        Args:
+            query: Text to look up documents similar to.
+            size: Number of Documents to return. Defaults to 4.
+            filter: Array of Elasticsearch filter clauses to apply to the query.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        search_params: Dict[str, Any] = kwargs.get("search_params") or {}
+
+        if len(search_params) == 0:
+            kwargs = {"search_params": {"size": k}}
+        elif search_params.get("size") is None:
+            search_params["size"] = k
+            kwargs["search_params"] = search_params
+
+        return self._search(query=query, filter=filter, **kwargs)
+
+    @classmethod
+    def from_documents(
+        cls,
+        documents: List[Document],
+        embedding: Optional[Embeddings] = None,
+        **kwargs: Any,
+    ) -> "EcloudESVectorStore":
+        """Construct EcloudESVectorStore wrapper from documents.
+
+        Args:
+            documents: List of documents to add to the Elasticsearch index.
+            embedding: Embedding function to use to embed the texts.
+                      Do not provide if using a strategy
+                      that doesn't require inference.
+            kwargs: create index key words arguments
+        """
+
+        vectorStore = EcloudESVectorStore._es_vector_store(
+            embedding=embedding, **kwargs
+        )
+        # Encode the provided texts and add them to the newly created index.
+        vectorStore.add_documents(documents)
+
+        return vectorStore
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[Dict[str, Any]]] = None,
+        **kwargs: Any,
+    ) -> "EcloudESVectorStore":
+        """Construct EcloudESVectorStore wrapper from raw documents.
+
+        Args:
+            texts: List of texts to add to the Elasticsearch index.
+            embedding: Embedding function to use to embed the texts.
+            metadatas: Optional list of metadatas associated with the texts.
+            index_name: Name of the Elasticsearch index to create.
+            kwargs: create index key words arguments
+        """
+
+        vectorStore = cls._es_vector_store(embedding=embedding, **kwargs)
+
+        # Encode the provided texts and add them to the newly created index.
+        vectorStore.add_texts(texts, metadatas=metadatas, **kwargs)
+
+        return vectorStore
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        try:
+            from elasticsearch.helpers import BulkIndexError, bulk
+        except ImportError:
+            raise ImportError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+
+        embeddings = []
+        create_index_if_not_exists = kwargs.get("create_index_if_not_exists", True)
+        ids = kwargs.get("ids", [str(uuid.uuid4()) for _ in texts])
+        refresh_indices = kwargs.get("refresh_indices", False)
+        requests = []
+
+        if self.embedding is not None:
+            embeddings = self.embedding.embed_documents(list(texts))
+            dims_length = len(embeddings[0])
+
+            if create_index_if_not_exists:
+                self._create_index_if_not_exists(dims_length=dims_length)
+
+            for i, (text, vector) in enumerate(zip(texts, embeddings)):
+                metadata = metadatas[i] if metadatas else {}
+                doc = {
+                    "_op_type": "index",
+                    "_index": self.index_name,
+                    self.text_field: text,
+                    "metadata": metadata,
+                    "_id": ids[i],
+                }
+                if self.vector_type == "knn_dense_float_vector":
+                    doc[self.vector_field] = vector
+                elif self.vector_type == "knn_sparse_bool_vector":
+                    doc[self.vector_field] = {
+                        "true_indices": vector,
+                        "total_indices": len(vector),
+                    }
+                requests.append(doc)
+        else:
+            if create_index_if_not_exists:
+                self._create_index_if_not_exists()
+
+            for i, text in enumerate(texts):
+                metadata = metadatas[i] if metadatas else {}
+
+                requests.append(
+                    {
+                        "_op_type": "index",
+                        "_index": self.index_name,
+                        self.text_field: text,
+                        "metadata": metadata,
+                        "_id": ids[i],
+                    }
+                )
+
+        if len(requests) > 0:
+            try:
+                success, failed = bulk(
+                    self.client, requests, stats_only=True, refresh=refresh_indices
+                )
+                logger.debug(
+                    f"Added {success} and failed to add {failed} texts to index"
+                )
+
+                logger.debug(f"added texts {ids} to index")
+                if refresh_indices:
+                    self.client.indices.refresh(index=self.index_name)
+                return ids
+            except BulkIndexError as e:
+                logger.error(f"Error adding texts: {e}")
+                firstError = e.errors[0].get("index", {}).get("error", {})
+                logger.error(f"First error reason: {firstError.get('reason')}")
+                raise e
+
+        else:
+            logger.debug("No texts to add to index")
+            return []
+
+    @staticmethod
+    def _es_vector_store(
+        embedding: Optional[Embeddings] = None, **kwargs: Any
+    ) -> "EcloudESVectorStore":
+        index_name = kwargs.get("index_name")
+
+        if index_name is None:
+            raise ValueError("Please provide an index_name.")
+
+        es_url = kwargs.get("es_url")
+        if es_url is None:
+            raise ValueError("Please provided a valid es connection url")
+
+        return EcloudESVectorStore(embedding=embedding, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/elastic_vector_search.py b/llm/Lib/site-packages/langchain_community/vectorstores/elastic_vector_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..32252008c2c39ad64b600797b280ae72f8f9549b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/elastic_vector_search.py
@@ -0,0 +1,811 @@
+from __future__ import annotations
+
+import uuid
+import warnings
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    Iterable,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Union,
+)
+
+from langchain_core._api import deprecated
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_dict_or_env
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    from elasticsearch import Elasticsearch
+
+
+def _default_text_mapping(dim: int) -> Dict:
+    return {
+        "properties": {
+            "text": {"type": "text"},
+            "vector": {"type": "dense_vector", "dims": dim},
+        }
+    }
+
+
+def _default_script_query(query_vector: List[float], filter: Optional[dict]) -> Dict:
+    if filter:
+        ((key, value),) = filter.items()
+        filter = {"match": {f"metadata.{key}.keyword": f"{value}"}}
+    else:
+        filter = {"match_all": {}}
+    return {
+        "script_score": {
+            "query": filter,
+            "script": {
+                "source": "cosineSimilarity(params.query_vector, 'vector') + 1.0",
+                "params": {"query_vector": query_vector},
+            },
+        }
+    }
+
+
+@deprecated(
+    "0.0.27",
+    alternative="Use ElasticsearchStore class in langchain-elasticsearch package",
+    pending=True,
+)
+class ElasticVectorSearch(VectorStore):
+    """
+
+    ElasticVectorSearch uses the brute force method of searching on vectors.
+
+    Recommended to use ElasticsearchStore instead, which gives you the option
+    to uses the approx  HNSW algorithm which performs better on large datasets.
+
+    ElasticsearchStore also supports metadata filtering, customising the
+    query retriever and much more!
+
+    You can read more on ElasticsearchStore:
+    https://python.langchain.com/docs/integrations/vectorstores/elasticsearch
+
+    To connect to an `Elasticsearch` instance that does not require
+    login credentials, pass the Elasticsearch URL and index name along with the
+    embedding object to the constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import ElasticVectorSearch
+            from langchain_community.embeddings import OpenAIEmbeddings
+
+            embedding = OpenAIEmbeddings()
+            elastic_vector_search = ElasticVectorSearch(
+                elasticsearch_url="http://localhost:9200",
+                index_name="test_index",
+                embedding=embedding
+            )
+
+
+    To connect to an Elasticsearch instance that requires login credentials,
+    including Elastic Cloud, use the Elasticsearch URL format
+    https://username:password@es_host:9243. For example, to connect to Elastic
+    Cloud, create the Elasticsearch URL with the required authentication details and
+    pass it to the ElasticVectorSearch constructor as the named parameter
+    elasticsearch_url.
+
+    You can obtain your Elastic Cloud URL and login credentials by logging in to the
+    Elastic Cloud console at https://cloud.elastic.co, selecting your deployment, and
+    navigating to the "Deployments" page.
+
+    To obtain your Elastic Cloud password for the default "elastic" user:
+
+    1. Log in to the Elastic Cloud console at https://cloud.elastic.co
+    2. Go to "Security" > "Users"
+    3. Locate the "elastic" user and click "Edit"
+    4. Click "Reset password"
+    5. Follow the prompts to reset the password
+
+    The format for Elastic Cloud URLs is
+    https://username:password@cluster_id.region_id.gcp.cloud.es.io:9243.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import ElasticVectorSearch
+            from langchain_community.embeddings import OpenAIEmbeddings
+
+            embedding = OpenAIEmbeddings()
+
+            elastic_host = "cluster_id.region_id.gcp.cloud.es.io"
+            elasticsearch_url = f"https://username:password@{elastic_host}:9243"
+            elastic_vector_search = ElasticVectorSearch(
+                elasticsearch_url=elasticsearch_url,
+                index_name="test_index",
+                embedding=embedding
+            )
+
+    Args:
+        elasticsearch_url (str): The URL for the Elasticsearch instance.
+        index_name (str): The name of the Elasticsearch index for the embeddings.
+        embedding (Embeddings): An object that provides the ability to embed text.
+                It should be an instance of a class that subclasses the Embeddings
+                abstract base class, such as OpenAIEmbeddings()
+
+    Raises:
+        ValueError: If the elasticsearch python package is not installed.
+    """
+
+    def __init__(
+        self,
+        elasticsearch_url: str,
+        index_name: str,
+        embedding: Embeddings,
+        *,
+        ssl_verify: Optional[Dict[str, Any]] = None,
+    ):
+        """Initialize with necessary components."""
+        warnings.warn(
+            "ElasticVectorSearch will be removed in a future release. See"
+            "Elasticsearch integration docs on how to upgrade."
+        )
+
+        try:
+            import elasticsearch
+        except ImportError:
+            raise ImportError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+        self.embedding = embedding
+        self.index_name = index_name
+        _ssl_verify = ssl_verify or {}
+        try:
+            self.client = elasticsearch.Elasticsearch(
+                elasticsearch_url,
+                **_ssl_verify,
+                headers={"user-agent": self.get_user_agent()},
+            )
+        except ValueError as e:
+            raise ValueError(
+                f"Your elasticsearch client string is mis-formatted. Got error: {e} "
+            )
+
+    @staticmethod
+    def get_user_agent() -> str:
+        from langchain_community import __version__
+
+        return f"langchain-py-dvs/{__version__}"
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        refresh_indices: bool = True,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of unique IDs.
+            refresh_indices: bool to refresh ElasticSearch indices
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        try:
+            from elasticsearch.exceptions import NotFoundError
+            from elasticsearch.helpers import bulk
+        except ImportError:
+            raise ImportError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+        requests = []
+        ids = ids or [str(uuid.uuid4()) for _ in texts]
+        embeddings = self.embedding.embed_documents(list(texts))
+        dim = len(embeddings[0])
+        mapping = _default_text_mapping(dim)
+
+        # check to see if the index already exists
+        try:
+            self.client.indices.get(index=self.index_name)
+        except NotFoundError:
+            # TODO would be nice to create index before embedding,
+            # just to save expensive steps for last
+            self.create_index(self.client, self.index_name, mapping)
+
+        for i, text in enumerate(texts):
+            metadata = metadatas[i] if metadatas else {}
+            request = {
+                "_op_type": "index",
+                "_index": self.index_name,
+                "vector": embeddings[i],
+                "text": text,
+                "metadata": metadata,
+                "_id": ids[i],
+            }
+            requests.append(request)
+        bulk(self.client, requests)
+
+        if refresh_indices:
+            self.client.indices.refresh(index=self.index_name)
+        return ids
+
+    def similarity_search(
+        self, query: str, k: int = 4, filter: Optional[dict] = None, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        docs_and_scores = self.similarity_search_with_score(query, k, filter=filter)
+        documents = [d[0] for d in docs_and_scores]
+        return documents
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, filter: Optional[dict] = None, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+        Returns:
+            List of Documents most similar to the query.
+        """
+        embedding = self.embedding.embed_query(query)
+        script_query = _default_script_query(embedding, filter)
+        response = self.client_search(
+            self.client, self.index_name, script_query, size=k
+        )
+        hits = [hit for hit in response["hits"]["hits"]]
+        docs_and_scores = [
+            (
+                Document(
+                    page_content=hit["_source"]["text"],
+                    metadata=hit["_source"]["metadata"],
+                ),
+                hit["_score"],
+            )
+            for hit in hits
+        ]
+        return docs_and_scores
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        index_name: Optional[str] = None,
+        refresh_indices: bool = True,
+        **kwargs: Any,
+    ) -> ElasticVectorSearch:
+        """Construct ElasticVectorSearch wrapper from raw documents.
+
+        This is a user-friendly interface that:
+            1. Embeds documents.
+            2. Creates a new index for the embeddings in the Elasticsearch instance.
+            3. Adds the documents to the newly created Elasticsearch index.
+
+        This is intended to be a quick way to get started.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import ElasticVectorSearch
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                elastic_vector_search = ElasticVectorSearch.from_texts(
+                    texts,
+                    embeddings,
+                    elasticsearch_url="http://localhost:9200"
+                )
+        """
+        elasticsearch_url = get_from_dict_or_env(
+            kwargs, "elasticsearch_url", "ELASTICSEARCH_URL"
+        )
+        if "elasticsearch_url" in kwargs:
+            del kwargs["elasticsearch_url"]
+        index_name = index_name or uuid.uuid4().hex
+        vectorsearch = cls(elasticsearch_url, index_name, embedding, **kwargs)
+        vectorsearch.add_texts(
+            texts, metadatas=metadatas, ids=ids, refresh_indices=refresh_indices
+        )
+        return vectorsearch
+
+    def create_index(self, client: Any, index_name: str, mapping: Dict) -> None:
+        version_num = client.info()["version"]["number"][0]
+        version_num = int(version_num)
+        if version_num >= 8:
+            client.indices.create(index=index_name, mappings=mapping)
+        else:
+            client.indices.create(index=index_name, body={"mappings": mapping})
+
+    def client_search(
+        self, client: Any, index_name: str, script_query: Dict, size: int
+    ) -> Any:
+        version_num = client.info()["version"]["number"][0]
+        version_num = int(version_num)
+        if version_num >= 8:
+            response = client.search(index=index_name, query=script_query, size=size)
+        else:
+            response = client.search(
+                index=index_name, body={"query": script_query, "size": size}
+            )
+        return response
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> None:
+        """Delete by vector IDs.
+
+        Args:
+            ids: List of ids to delete.
+        """
+
+        if ids is None:
+            raise ValueError("No ids provided to delete.")
+
+        # TODO: Check if this can be done in bulk
+        for id in ids:
+            self.client.delete(index=self.index_name, id=id)
+
+
+@deprecated(
+    "0.0.1",
+    alternative="Use ElasticsearchStore class in langchain-elasticsearch package",
+    pending=True,
+)
+class ElasticKnnSearch(VectorStore):
+    """[DEPRECATED] `Elasticsearch` with k-nearest neighbor search
+    (`k-NN`) vector store.
+
+    Recommended to use ElasticsearchStore instead, which supports
+    metadata filtering, customising the query retriever and much more!
+
+    You can read more on ElasticsearchStore:
+    https://python.langchain.com/docs/integrations/vectorstores/elasticsearch
+
+    It creates an Elasticsearch index of text data that
+    can be searched using k-NN search. The text data is transformed into
+    vector embeddings using a provided embedding model, and these embeddings
+    are stored in the Elasticsearch index.
+
+    Attributes:
+        index_name (str): The name of the Elasticsearch index.
+        embedding (Embeddings): The embedding model to use for transforming text data
+            into vector embeddings.
+        es_connection (Elasticsearch, optional): An existing Elasticsearch connection.
+        es_cloud_id (str, optional): The Cloud ID of your Elasticsearch Service
+            deployment.
+        es_user (str, optional): The username for your Elasticsearch Service deployment.
+        es_password (str, optional): The password for your Elasticsearch Service
+            deployment.
+        vector_query_field (str, optional): The name of the field in the Elasticsearch
+            index that contains the vector embeddings.
+        query_field (str, optional): The name of the field in the Elasticsearch index
+            that contains the original text data.
+
+    Usage:
+        >>> from embeddings import Embeddings
+        >>> embedding = Embeddings.load('glove')
+        >>> es_search = ElasticKnnSearch('my_index', embedding)
+        >>> es_search.add_texts(['Hello world!', 'Another text'])
+        >>> results = es_search.knn_search('Hello')
+        [(Document(page_content='Hello world!', metadata={}), 0.9)]
+    """
+
+    def __init__(
+        self,
+        index_name: str,
+        embedding: Embeddings,
+        es_connection: Optional["Elasticsearch"] = None,
+        es_cloud_id: Optional[str] = None,
+        es_user: Optional[str] = None,
+        es_password: Optional[str] = None,
+        vector_query_field: Optional[str] = "vector",
+        query_field: Optional[str] = "text",
+    ):
+        try:
+            import elasticsearch
+        except ImportError:
+            raise ImportError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+
+        warnings.warn(
+            "ElasticKnnSearch will be removed in a future release."
+            "Use ElasticsearchStore instead. See Elasticsearch "
+            "integration docs on how to upgrade."
+        )
+        self.embedding = embedding
+        self.index_name = index_name
+        self.query_field = query_field
+        self.vector_query_field = vector_query_field
+
+        # If a pre-existing Elasticsearch connection is provided, use it.
+        if es_connection is not None:
+            self.client = es_connection
+        else:
+            # If credentials for a new Elasticsearch connection are provided,
+            # create a new connection.
+            if es_cloud_id and es_user and es_password:
+                self.client = elasticsearch.Elasticsearch(
+                    cloud_id=es_cloud_id, basic_auth=(es_user, es_password)
+                )
+            else:
+                raise ValueError(
+                    """Either provide a pre-existing Elasticsearch connection, \
+                or valid credentials for creating a new connection."""
+                )
+
+    @staticmethod
+    def _default_knn_mapping(
+        dims: int, similarity: Optional[str] = "dot_product"
+    ) -> Dict:
+        return {
+            "properties": {
+                "text": {"type": "text"},
+                "vector": {
+                    "type": "dense_vector",
+                    "dims": dims,
+                    "index": True,
+                    "similarity": similarity,
+                },
+            }
+        }
+
+    def _default_knn_query(
+        self,
+        query_vector: Optional[List[float]] = None,
+        query: Optional[str] = None,
+        model_id: Optional[str] = None,
+        k: Optional[int] = 10,
+        num_candidates: Optional[int] = 10,
+    ) -> Dict:
+        knn: Dict = {
+            "field": self.vector_query_field,
+            "k": k,
+            "num_candidates": num_candidates,
+        }
+
+        # Case 1: `query_vector` is provided, but not `model_id` -> use query_vector
+        if query_vector and not model_id:
+            knn["query_vector"] = query_vector
+
+        # Case 2: `query` and `model_id` are provided, -> use query_vector_builder
+        elif query and model_id:
+            knn["query_vector_builder"] = {
+                "text_embedding": {
+                    "model_id": model_id,  # use 'model_id' argument
+                    "model_text": query,  # use 'query' argument
+                }
+            }
+
+        else:
+            raise ValueError(
+                "Either `query_vector` or `model_id` must be provided, but not both."
+            )
+
+        return knn
+
+    def similarity_search(
+        self, query: str, k: int = 4, filter: Optional[dict] = None, **kwargs: Any
+    ) -> List[Document]:
+        """
+        Pass through to `knn_search`
+        """
+        results = self.knn_search(query=query, k=k, **kwargs)
+        return [doc for doc, score in results]
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 10, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Pass through to `knn_search including score`"""
+        return self.knn_search(query=query, k=k, **kwargs)
+
+    def knn_search(
+        self,
+        query: Optional[str] = None,
+        k: Optional[int] = 10,
+        query_vector: Optional[List[float]] = None,
+        model_id: Optional[str] = None,
+        size: Optional[int] = 10,
+        source: Optional[bool] = True,
+        fields: Optional[
+            Union[List[Mapping[str, Any]], Tuple[Mapping[str, Any], ...], None]
+        ] = None,
+        page_content: Optional[str] = "text",
+    ) -> List[Tuple[Document, float]]:
+        """
+        Perform a k-NN search on the Elasticsearch index.
+
+        Args:
+            query (str, optional): The query text to search for.
+            k (int, optional): The number of nearest neighbors to return.
+            query_vector (List[float], optional): The query vector to search for.
+            model_id (str, optional): The ID of the model to use for transforming the
+                query text into a vector.
+            size (int, optional): The number of search results to return.
+            source (bool, optional): Whether to return the source of the search results.
+            fields (List[Mapping[str, Any]], optional): The fields to return in the
+                search results.
+            page_content (str, optional): The name of the field that contains the page
+                content.
+
+        Returns:
+            A list of tuples, where each tuple contains a Document object and a score.
+        """
+
+        # if not source and (fields == None or page_content not in fields):
+        if not source and (
+            fields is None or not any(page_content in field for field in fields)
+        ):
+            raise ValueError("If source=False `page_content` field must be in `fields`")
+
+        knn_query_body = self._default_knn_query(
+            query_vector=query_vector, query=query, model_id=model_id, k=k
+        )
+
+        # Perform the kNN search on the Elasticsearch index and return the results.
+        response = self.client.search(
+            index=self.index_name,
+            knn=knn_query_body,
+            size=size,
+            source=source,
+            fields=fields,
+        )
+
+        hits = [hit for hit in response["hits"]["hits"]]
+        docs_and_scores = [
+            (
+                Document(
+                    page_content=(
+                        hit["_source"][page_content]
+                        if source
+                        else hit["fields"][page_content][0]
+                    ),
+                    metadata=hit["fields"] if fields else {},
+                ),
+                hit["_score"],
+            )
+            for hit in hits
+        ]
+
+        return docs_and_scores
+
+    def knn_hybrid_search(
+        self,
+        query: Optional[str] = None,
+        k: Optional[int] = 10,
+        query_vector: Optional[List[float]] = None,
+        model_id: Optional[str] = None,
+        size: Optional[int] = 10,
+        source: Optional[bool] = True,
+        knn_boost: Optional[float] = 0.9,
+        query_boost: Optional[float] = 0.1,
+        fields: Optional[
+            Union[List[Mapping[str, Any]], Tuple[Mapping[str, Any], ...], None]
+        ] = None,
+        page_content: Optional[str] = "text",
+    ) -> List[Tuple[Document, float]]:
+        """
+        Perform a hybrid k-NN and text search on the Elasticsearch index.
+
+        Args:
+            query (str, optional): The query text to search for.
+            k (int, optional): The number of nearest neighbors to return.
+            query_vector (List[float], optional): The query vector to search for.
+            model_id (str, optional): The ID of the model to use for transforming the
+                query text into a vector.
+            size (int, optional): The number of search results to return.
+            source (bool, optional): Whether to return the source of the search results.
+            knn_boost (float, optional): The boost value to apply to the k-NN search
+                results.
+            query_boost (float, optional): The boost value to apply to the text search
+                results.
+            fields (List[Mapping[str, Any]], optional): The fields to return in the
+                search results.
+            page_content (str, optional): The name of the field that contains the page
+                content.
+
+        Returns:
+            A list of tuples, where each tuple contains a Document object and a score.
+        """
+
+        # if not source and (fields == None or page_content not in fields):
+        if not source and (
+            fields is None or not any(page_content in field for field in fields)
+        ):
+            raise ValueError("If source=False `page_content` field must be in `fields`")
+
+        knn_query_body = self._default_knn_query(
+            query_vector=query_vector, query=query, model_id=model_id, k=k
+        )
+
+        # Modify the knn_query_body to add a "boost" parameter
+        knn_query_body["boost"] = knn_boost
+
+        # Generate the body of the standard Elasticsearch query
+        match_query_body = {
+            "match": {self.query_field: {"query": query, "boost": query_boost}}
+        }
+
+        # Perform the hybrid search on the Elasticsearch index and return the results.
+        response = self.client.search(
+            index=self.index_name,
+            query=match_query_body,
+            knn=knn_query_body,
+            fields=fields,
+            size=size,
+            source=source,
+        )
+
+        hits = [hit for hit in response["hits"]["hits"]]
+        docs_and_scores = [
+            (
+                Document(
+                    page_content=(
+                        hit["_source"][page_content]
+                        if source
+                        else hit["fields"][page_content][0]
+                    ),
+                    metadata=hit["fields"] if fields else {},
+                ),
+                hit["_score"],
+            )
+            for hit in hits
+        ]
+
+        return docs_and_scores
+
+    def create_knn_index(self, mapping: Dict) -> None:
+        """
+        Create a new k-NN index in Elasticsearch.
+
+        Args:
+            mapping (Dict): The mapping to use for the new index.
+
+        Returns:
+            None
+        """
+
+        self.client.indices.create(index=self.index_name, mappings=mapping)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        model_id: Optional[str] = None,
+        refresh_indices: bool = False,
+        **kwargs: Any,
+    ) -> List[str]:
+        """
+        Add a list of texts to the Elasticsearch index.
+
+        Args:
+            texts (Iterable[str]): The texts to add to the index.
+            metadatas (List[Dict[Any, Any]], optional): A list of metadata dictionaries
+                to associate with the texts.
+            model_id (str, optional): The ID of the model to use for transforming the
+                texts into vectors.
+            refresh_indices (bool, optional): Whether to refresh the Elasticsearch
+                indices after adding the texts.
+            **kwargs: Arbitrary keyword arguments.
+
+        Returns:
+            A list of IDs for the added texts.
+        """
+
+        # Check if the index exists.
+        if not self.client.indices.exists(index=self.index_name):
+            dims = kwargs.get("dims")
+
+            if dims is None:
+                raise ValueError("ElasticKnnSearch requires 'dims' parameter")
+
+            similarity = kwargs.get("similarity")
+            optional_args = {}
+
+            if similarity is not None:
+                optional_args["similarity"] = similarity
+
+            mapping = self._default_knn_mapping(dims=dims, **optional_args)
+            self.create_knn_index(mapping)
+
+        embeddings = self.embedding.embed_documents(list(texts))
+
+        # body = []
+        body: List[Mapping[str, Any]] = []
+        for text, vector in zip(texts, embeddings):
+            body.extend(
+                [
+                    {"index": {"_index": self.index_name}},
+                    {"text": text, "vector": vector},
+                ]
+            )
+
+        responses = self.client.bulk(operations=body)
+
+        ids = [
+            item["index"]["_id"]
+            for item in responses["items"]
+            if item["index"]["result"] == "created"
+        ]
+
+        if refresh_indices:
+            self.client.indices.refresh(index=self.index_name)
+
+        return ids
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        **kwargs: Any,
+    ) -> ElasticKnnSearch:
+        """
+        Create a new ElasticKnnSearch instance and add a list of texts to the
+            Elasticsearch index.
+
+        Args:
+            texts (List[str]): The texts to add to the index.
+            embedding (Embeddings): The embedding model to use for transforming the
+                texts into vectors.
+            metadatas (List[Dict[Any, Any]], optional): A list of metadata dictionaries
+                to associate with the texts.
+            **kwargs: Arbitrary keyword arguments.
+
+        Returns:
+            A new ElasticKnnSearch instance.
+        """
+
+        index_name = kwargs.get("index_name", str(uuid.uuid4()))
+        es_connection = kwargs.get("es_connection")
+        es_cloud_id = kwargs.get("es_cloud_id")
+        es_user = kwargs.get("es_user")
+        es_password = kwargs.get("es_password")
+        vector_query_field = kwargs.get("vector_query_field", "vector")
+        query_field = kwargs.get("query_field", "text")
+        model_id = kwargs.get("model_id")
+        dims = kwargs.get("dims")
+
+        if dims is None:
+            raise ValueError("ElasticKnnSearch requires 'dims' parameter")
+
+        optional_args = {}
+
+        if vector_query_field is not None:
+            optional_args["vector_query_field"] = vector_query_field
+
+        if query_field is not None:
+            optional_args["query_field"] = query_field
+
+        knnvectorsearch = cls(
+            index_name=index_name,
+            embedding=embedding,
+            es_connection=es_connection,
+            es_cloud_id=es_cloud_id,
+            es_user=es_user,
+            es_password=es_password,
+            **optional_args,
+        )
+        # Encode the provided texts and add them to the newly created index.
+        knnvectorsearch.add_texts(texts, model_id=model_id, dims=dims, **optional_args)
+
+        return knnvectorsearch
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/elasticsearch.py b/llm/Lib/site-packages/langchain_community/vectorstores/elasticsearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..09f818ff05eb5a874afef9409386dcacc5531cbc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/elasticsearch.py
@@ -0,0 +1,1322 @@
+import logging
+import uuid
+from abc import ABC, abstractmethod
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Literal,
+    Optional,
+    Tuple,
+    Union,
+)
+
+import numpy as np
+from langchain_core._api import deprecated
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import (
+    DistanceStrategy,
+    maximal_marginal_relevance,
+)
+
+if TYPE_CHECKING:
+    from elasticsearch import Elasticsearch
+
+logger = logging.getLogger(__name__)
+
+
+class BaseRetrievalStrategy(ABC):
+    """Base class for `Elasticsearch` retrieval strategies."""
+
+    @abstractmethod
+    def query(
+        self,
+        query_vector: Union[List[float], None],
+        query: Union[str, None],
+        *,
+        k: int,
+        fetch_k: int,
+        vector_query_field: str,
+        text_field: str,
+        filter: List[dict],
+        similarity: Union[DistanceStrategy, None],
+    ) -> Dict:
+        """
+        Executes when a search is performed on the store.
+
+        Args:
+            query_vector: The query vector,
+                          or None if not using vector-based query.
+            query: The text query, or None if not using text-based query.
+            k: The total number of results to retrieve.
+            fetch_k: The number of results to fetch initially.
+            vector_query_field: The field containing the vector
+                                representations in the index.
+            text_field: The field containing the text data in the index.
+            filter: List of filter clauses to apply to the query.
+            similarity: The similarity strategy to use, or None if not using one.
+
+        Returns:
+            Dict: The Elasticsearch query body.
+        """
+
+    @abstractmethod
+    def index(
+        self,
+        dims_length: Union[int, None],
+        vector_query_field: str,
+        similarity: Union[DistanceStrategy, None],
+    ) -> Dict:
+        """
+        Executes when the index is created.
+
+        Args:
+            dims_length: Numeric length of the embedding vectors,
+                        or None if not using vector-based query.
+            vector_query_field: The field containing the vector
+                                representations in the index.
+            similarity: The similarity strategy to use,
+                        or None if not using one.
+
+        Returns:
+            Dict: The Elasticsearch settings and mappings for the strategy.
+        """
+
+    def before_index_setup(
+        self, client: "Elasticsearch", text_field: str, vector_query_field: str
+    ) -> None:
+        """
+        Executes before the index is created. Used for setting up
+        any required Elasticsearch resources like a pipeline.
+
+        Args:
+            client: The Elasticsearch client.
+            text_field: The field containing the text data in the index.
+            vector_query_field: The field containing the vector
+                                representations in the index.
+        """
+
+    def require_inference(self) -> bool:
+        """
+        Returns whether or not the strategy requires inference
+        to be performed on the text before it is added to the index.
+
+        Returns:
+            bool: Whether or not the strategy requires inference
+            to be performed on the text before it is added to the index.
+        """
+        return True
+
+
+@deprecated(
+    "0.0.27", alternative="Use class in langchain-elasticsearch package", pending=True
+)
+class ApproxRetrievalStrategy(BaseRetrievalStrategy):
+    """Approximate retrieval strategy using the `HNSW` algorithm."""
+
+    def __init__(
+        self,
+        query_model_id: Optional[str] = None,
+        hybrid: Optional[bool] = False,
+        rrf: Optional[Union[dict, bool]] = True,
+    ):
+        self.query_model_id = query_model_id
+        self.hybrid = hybrid
+
+        # RRF has two optional parameters
+        # 'rank_constant', 'window_size'
+        # https://www.elastic.co/guide/en/elasticsearch/reference/current/rrf.html
+        self.rrf = rrf
+
+    def query(
+        self,
+        query_vector: Union[List[float], None],
+        query: Union[str, None],
+        k: int,
+        fetch_k: int,
+        vector_query_field: str,
+        text_field: str,
+        filter: List[dict],
+        similarity: Union[DistanceStrategy, None],
+    ) -> Dict:
+        knn = {
+            "filter": filter,
+            "field": vector_query_field,
+            "k": k,
+            "num_candidates": fetch_k,
+        }
+
+        # Embedding provided via the embedding function
+        if query_vector and not self.query_model_id:
+            knn["query_vector"] = query_vector
+
+        # Case 2: Used when model has been deployed to
+        # Elasticsearch and can infer the query vector from the query text
+        elif query and self.query_model_id:
+            knn["query_vector_builder"] = {
+                "text_embedding": {
+                    "model_id": self.query_model_id,  # use 'model_id' argument
+                    "model_text": query,  # use 'query' argument
+                }
+            }
+
+        else:
+            raise ValueError(
+                "You must provide an embedding function or a"
+                " query_model_id to perform a similarity search."
+            )
+
+        # If hybrid, add a query to the knn query
+        # RRF is used to even the score from the knn query and text query
+        # RRF has two optional parameters: {'rank_constant':int, 'window_size':int}
+        # https://www.elastic.co/guide/en/elasticsearch/reference/current/rrf.html
+        if self.hybrid:
+            query_body = {
+                "knn": knn,
+                "query": {
+                    "bool": {
+                        "must": [
+                            {
+                                "match": {
+                                    text_field: {
+                                        "query": query,
+                                    }
+                                }
+                            }
+                        ],
+                        "filter": filter,
+                    }
+                },
+            }
+
+            if isinstance(self.rrf, dict):
+                query_body["rank"] = {"rrf": self.rrf}
+            elif isinstance(self.rrf, bool) and self.rrf is True:
+                query_body["rank"] = {"rrf": {}}
+
+            return query_body
+        else:
+            return {"knn": knn}
+
+    def index(
+        self,
+        dims_length: Union[int, None],
+        vector_query_field: str,
+        similarity: Union[DistanceStrategy, None],
+    ) -> Dict:
+        """Create the mapping for the Elasticsearch index."""
+
+        if similarity is DistanceStrategy.COSINE:
+            similarityAlgo = "cosine"
+        elif similarity is DistanceStrategy.EUCLIDEAN_DISTANCE:
+            similarityAlgo = "l2_norm"
+        elif similarity is DistanceStrategy.DOT_PRODUCT:
+            similarityAlgo = "dot_product"
+        elif similarity is DistanceStrategy.MAX_INNER_PRODUCT:
+            similarityAlgo = "max_inner_product"
+        else:
+            raise ValueError(f"Similarity {similarity} not supported.")
+
+        return {
+            "mappings": {
+                "properties": {
+                    vector_query_field: {
+                        "type": "dense_vector",
+                        "dims": dims_length,
+                        "index": True,
+                        "similarity": similarityAlgo,
+                    },
+                }
+            }
+        }
+
+
+@deprecated(
+    "0.0.27", alternative="Use class in langchain-elasticsearch package", pending=True
+)
+class ExactRetrievalStrategy(BaseRetrievalStrategy):
+    """Exact retrieval strategy using the `script_score` query."""
+
+    def query(
+        self,
+        query_vector: Union[List[float], None],
+        query: Union[str, None],
+        k: int,
+        fetch_k: int,
+        vector_query_field: str,
+        text_field: str,
+        filter: Union[List[dict], None],
+        similarity: Union[DistanceStrategy, None],
+    ) -> Dict:
+        if similarity is DistanceStrategy.COSINE:
+            similarityAlgo = (
+                f"cosineSimilarity(params.query_vector, '{vector_query_field}') + 1.0"
+            )
+        elif similarity is DistanceStrategy.EUCLIDEAN_DISTANCE:
+            similarityAlgo = (
+                f"1 / (1 + l2norm(params.query_vector, '{vector_query_field}'))"
+            )
+        elif similarity is DistanceStrategy.DOT_PRODUCT:
+            similarityAlgo = f"""
+            double value = dotProduct(params.query_vector, '{vector_query_field}');
+            return sigmoid(1, Math.E, -value);
+            """
+        else:
+            raise ValueError(f"Similarity {similarity} not supported.")
+
+        queryBool: Dict = {"match_all": {}}
+        if filter:
+            queryBool = {"bool": {"filter": filter}}
+
+        return {
+            "query": {
+                "script_score": {
+                    "query": queryBool,
+                    "script": {
+                        "source": similarityAlgo,
+                        "params": {"query_vector": query_vector},
+                    },
+                },
+            }
+        }
+
+    def index(
+        self,
+        dims_length: Union[int, None],
+        vector_query_field: str,
+        similarity: Union[DistanceStrategy, None],
+    ) -> Dict:
+        """Create the mapping for the Elasticsearch index."""
+
+        return {
+            "mappings": {
+                "properties": {
+                    vector_query_field: {
+                        "type": "dense_vector",
+                        "dims": dims_length,
+                        "index": False,
+                    },
+                }
+            }
+        }
+
+
+@deprecated(
+    "0.0.27", alternative="Use class in langchain-elasticsearch package", pending=True
+)
+class SparseRetrievalStrategy(BaseRetrievalStrategy):
+    """Sparse retrieval strategy using the `text_expansion` processor."""
+
+    def __init__(self, model_id: Optional[str] = None):
+        self.model_id = model_id or ".elser_model_1"
+
+    def query(
+        self,
+        query_vector: Union[List[float], None],
+        query: Union[str, None],
+        k: int,
+        fetch_k: int,
+        vector_query_field: str,
+        text_field: str,
+        filter: List[dict],
+        similarity: Union[DistanceStrategy, None],
+    ) -> Dict:
+        return {
+            "query": {
+                "bool": {
+                    "must": [
+                        {
+                            "text_expansion": {
+                                f"{vector_query_field}.tokens": {
+                                    "model_id": self.model_id,
+                                    "model_text": query,
+                                }
+                            }
+                        }
+                    ],
+                    "filter": filter,
+                }
+            }
+        }
+
+    def _get_pipeline_name(self) -> str:
+        return f"{self.model_id}_sparse_embedding"
+
+    def before_index_setup(
+        self, client: "Elasticsearch", text_field: str, vector_query_field: str
+    ) -> None:
+        # If model_id is provided, create a pipeline for the model
+        if self.model_id:
+            client.ingest.put_pipeline(
+                id=self._get_pipeline_name(),
+                description="Embedding pipeline for langchain vectorstore",
+                processors=[
+                    {
+                        "inference": {
+                            "model_id": self.model_id,
+                            "target_field": vector_query_field,
+                            "field_map": {text_field: "text_field"},
+                            "inference_config": {
+                                "text_expansion": {"results_field": "tokens"}
+                            },
+                        }
+                    }
+                ],
+            )
+
+    def index(
+        self,
+        dims_length: Union[int, None],
+        vector_query_field: str,
+        similarity: Union[DistanceStrategy, None],
+    ) -> Dict:
+        return {
+            "mappings": {
+                "properties": {
+                    vector_query_field: {
+                        "properties": {"tokens": {"type": "rank_features"}}
+                    }
+                }
+            },
+            "settings": {"default_pipeline": self._get_pipeline_name()},
+        }
+
+    def require_inference(self) -> bool:
+        return False
+
+
+@deprecated(
+    "0.0.27", alternative="Use class in langchain-elasticsearch package", pending=True
+)
+class ElasticsearchStore(VectorStore):
+    """`Elasticsearch` vector store.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import ElasticsearchStore
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+            vectorstore = ElasticsearchStore(
+                embedding=OpenAIEmbeddings(),
+                index_name="langchain-demo",
+                es_url="http://localhost:9200"
+            )
+
+    Args:
+        index_name: Name of the Elasticsearch index to create.
+        es_url: URL of the Elasticsearch instance to connect to.
+        cloud_id: Cloud ID of the Elasticsearch instance to connect to.
+        es_user: Username to use when connecting to Elasticsearch.
+        es_password: Password to use when connecting to Elasticsearch.
+        es_api_key: API key to use when connecting to Elasticsearch.
+        es_connection: Optional pre-existing Elasticsearch connection.
+        vector_query_field: Optional. Name of the field to store
+                            the embedding vectors in.
+        query_field: Optional. Name of the field to store the texts in.
+        strategy: Optional. Retrieval strategy to use when searching the index.
+                 Defaults to ApproxRetrievalStrategy. Can be one of
+                 ExactRetrievalStrategy, ApproxRetrievalStrategy,
+                 or SparseRetrievalStrategy.
+        distance_strategy: Optional. Distance strategy to use when
+                            searching the index.
+                            Defaults to COSINE. Can be one of COSINE,
+                            EUCLIDEAN_DISTANCE, MAX_INNER_PRODUCT or DOT_PRODUCT.
+
+    If you want to use a cloud hosted Elasticsearch instance, you can pass in the
+    cloud_id argument instead of the es_url argument.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import ElasticsearchStore
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+            vectorstore = ElasticsearchStore(
+                embedding=OpenAIEmbeddings(),
+                index_name="langchain-demo",
+                es_cloud_id="<cloud_id>"
+                es_user="elastic",
+                es_password="<password>"
+            )
+
+    You can also connect to an existing Elasticsearch instance by passing in a
+    pre-existing Elasticsearch connection via the es_connection argument.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import ElasticsearchStore
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+            from elasticsearch import Elasticsearch
+
+            es_connection = Elasticsearch("http://localhost:9200")
+
+            vectorstore = ElasticsearchStore(
+                embedding=OpenAIEmbeddings(),
+                index_name="langchain-demo",
+                es_connection=es_connection
+            )
+
+    ElasticsearchStore by default uses the ApproxRetrievalStrategy, which uses the
+    HNSW algorithm to perform approximate nearest neighbor search. This is the
+    fastest and most memory efficient algorithm.
+
+    If you want to use the Brute force / Exact strategy for searching vectors, you
+    can pass in the ExactRetrievalStrategy to the ElasticsearchStore constructor.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import ElasticsearchStore
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+            vectorstore = ElasticsearchStore(
+                embedding=OpenAIEmbeddings(),
+                index_name="langchain-demo",
+                es_url="http://localhost:9200",
+                strategy=ElasticsearchStore.ExactRetrievalStrategy()
+            )
+
+    Both strategies require that you know the similarity metric you want to use
+    when creating the index. The default is cosine similarity, but you can also
+    use dot product or euclidean distance.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import ElasticsearchStore
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+            from langchain_community.vectorstores.utils import DistanceStrategy
+
+            vectorstore = ElasticsearchStore(
+                "langchain-demo",
+                embedding=OpenAIEmbeddings(),
+                es_url="http://localhost:9200",
+                distance_strategy="DOT_PRODUCT"
+            )
+
+    """
+
+    def __init__(
+        self,
+        index_name: str,
+        *,
+        embedding: Optional[Embeddings] = None,
+        es_connection: Optional["Elasticsearch"] = None,
+        es_url: Optional[str] = None,
+        es_cloud_id: Optional[str] = None,
+        es_user: Optional[str] = None,
+        es_api_key: Optional[str] = None,
+        es_password: Optional[str] = None,
+        vector_query_field: str = "vector",
+        query_field: str = "text",
+        distance_strategy: Optional[
+            Literal[
+                DistanceStrategy.COSINE,
+                DistanceStrategy.DOT_PRODUCT,
+                DistanceStrategy.EUCLIDEAN_DISTANCE,
+                DistanceStrategy.MAX_INNER_PRODUCT,
+            ]
+        ] = None,
+        strategy: BaseRetrievalStrategy = ApproxRetrievalStrategy(),
+        es_params: Optional[Dict[str, Any]] = None,
+    ):
+        self.embedding = embedding
+        self.index_name = index_name
+        self.query_field = query_field
+        self.vector_query_field = vector_query_field
+        self.distance_strategy = (
+            DistanceStrategy.COSINE
+            if distance_strategy is None
+            else DistanceStrategy[distance_strategy]
+        )
+        self.strategy = strategy
+
+        if es_connection is not None:
+            headers = dict(es_connection._headers)
+            headers.update({"user-agent": self.get_user_agent()})
+            self.client = es_connection.options(headers=headers)
+        elif es_url is not None or es_cloud_id is not None:
+            self.client = ElasticsearchStore.connect_to_elasticsearch(
+                es_url=es_url,
+                username=es_user,
+                password=es_password,
+                cloud_id=es_cloud_id,
+                api_key=es_api_key,
+                es_params=es_params,
+            )
+        else:
+            raise ValueError(
+                """Either provide a pre-existing Elasticsearch connection, \
+                or valid credentials for creating a new connection."""
+            )
+
+    @staticmethod
+    def get_user_agent() -> str:
+        from langchain_community import __version__
+
+        return f"langchain-py-vs/{__version__}"
+
+    @staticmethod
+    def connect_to_elasticsearch(
+        *,
+        es_url: Optional[str] = None,
+        cloud_id: Optional[str] = None,
+        api_key: Optional[str] = None,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        es_params: Optional[Dict[str, Any]] = None,
+    ) -> "Elasticsearch":
+        try:
+            import elasticsearch
+        except ImportError:
+            raise ImportError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+
+        if es_url and cloud_id:
+            raise ValueError(
+                "Both es_url and cloud_id are defined. Please provide only one."
+            )
+
+        connection_params: Dict[str, Any] = {}
+
+        if es_url:
+            connection_params["hosts"] = [es_url]
+        elif cloud_id:
+            connection_params["cloud_id"] = cloud_id
+        else:
+            raise ValueError("Please provide either elasticsearch_url or cloud_id.")
+
+        if api_key:
+            connection_params["api_key"] = api_key
+        elif username and password:
+            connection_params["basic_auth"] = (username, password)
+
+        if es_params is not None:
+            connection_params.update(es_params)
+
+        es_client = elasticsearch.Elasticsearch(
+            **connection_params,
+            headers={"user-agent": ElasticsearchStore.get_user_agent()},
+        )
+        try:
+            es_client.info()
+        except Exception as e:
+            logger.error(f"Error connecting to Elasticsearch: {e}")
+            raise e
+
+        return es_client
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self.embedding
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 50,
+        filter: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return Elasticsearch documents most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to knn num_candidates.
+            filter: Array of Elasticsearch filter clauses to apply to the query.
+
+        Returns:
+            List of Documents most similar to the query,
+            in descending order of similarity.
+        """
+
+        results = self._search(
+            query=query, k=k, fetch_k=fetch_k, filter=filter, **kwargs
+        )
+        return [doc for doc, _ in results]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        fields: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            query (str): Text to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            fields: Other fields to get from elasticsearch source. These fields
+                will be added to the document metadata.
+
+        Returns:
+            List[Document]: A list of Documents selected by maximal marginal relevance.
+        """
+        if self.embedding is None:
+            raise ValueError("You must provide an embedding function to perform MMR")
+        remove_vector_query_field_from_metadata = True
+        if fields is None:
+            fields = [self.vector_query_field]
+        elif self.vector_query_field not in fields:
+            fields.append(self.vector_query_field)
+        else:
+            remove_vector_query_field_from_metadata = False
+
+        # Embed the query
+        query_embedding = self.embedding.embed_query(query)
+
+        # Fetch the initial documents
+        got_docs = self._search(
+            query_vector=query_embedding, k=fetch_k, fields=fields, **kwargs
+        )
+
+        # Get the embeddings for the fetched documents
+        got_embeddings = [doc.metadata[self.vector_query_field] for doc, _ in got_docs]
+
+        # Select documents using maximal marginal relevance
+        selected_indices = maximal_marginal_relevance(
+            np.array(query_embedding), got_embeddings, lambda_mult=lambda_mult, k=k
+        )
+        selected_docs = [got_docs[i][0] for i in selected_indices]
+
+        if remove_vector_query_field_from_metadata:
+            for doc in selected_docs:
+                del doc.metadata[self.vector_query_field]
+
+        return selected_docs
+
+    @staticmethod
+    def _identity_fn(score: float) -> float:
+        return score
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+
+        Vectorstores should define their own selection based method of relevance.
+        """
+        # All scores from Elasticsearch are already normalized similarities:
+        # https://www.elastic.co/guide/en/elasticsearch/reference/current/dense-vector.html#dense-vector-params
+        return self._identity_fn
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, filter: Optional[List[dict]] = None, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Return Elasticsearch documents most similar to query, along with scores.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Array of Elasticsearch filter clauses to apply to the query.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        if isinstance(self.strategy, ApproxRetrievalStrategy) and self.strategy.hybrid:
+            raise ValueError("scores are currently not supported in hybrid mode")
+
+        return self._search(query=query, k=k, filter=filter, **kwargs)
+
+    def similarity_search_by_vector_with_relevance_scores(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[List[Dict]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return Elasticsearch documents most similar to query, along with scores.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Array of Elasticsearch filter clauses to apply to the query.
+
+        Returns:
+            List of Documents most similar to the embedding and score for each
+        """
+        if isinstance(self.strategy, ApproxRetrievalStrategy) and self.strategy.hybrid:
+            raise ValueError("scores are currently not supported in hybrid mode")
+
+        return self._search(query_vector=embedding, k=k, filter=filter, **kwargs)
+
+    def _search(
+        self,
+        query: Optional[str] = None,
+        k: int = 4,
+        query_vector: Union[List[float], None] = None,
+        fetch_k: int = 50,
+        fields: Optional[List[str]] = None,
+        filter: Optional[List[dict]] = None,
+        custom_query: Optional[Callable[[Dict, Union[str, None]], Dict]] = None,
+        doc_builder: Optional[Callable[[Dict], Document]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return Elasticsearch documents most similar to query, along with scores.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            query_vector: Embedding to look up documents similar to.
+            fetch_k: Number of candidates to fetch from each shard.
+                    Defaults to 50.
+            fields: List of fields to return from Elasticsearch.
+                    Defaults to only returning the text field.
+            filter: Array of Elasticsearch filter clauses to apply to the query.
+            custom_query: Function to modify the Elasticsearch
+                         query body before it is sent to Elasticsearch.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        if fields is None:
+            fields = []
+
+        if "metadata" not in fields:
+            fields.append("metadata")
+
+        if self.query_field not in fields:
+            fields.append(self.query_field)
+
+        if self.embedding and query is not None:
+            query_vector = self.embedding.embed_query(query)
+
+        query_body = self.strategy.query(
+            query_vector=query_vector,
+            query=query,
+            k=k,
+            fetch_k=fetch_k,
+            vector_query_field=self.vector_query_field,
+            text_field=self.query_field,
+            filter=filter or [],
+            similarity=self.distance_strategy,
+        )
+
+        logger.debug(f"Query body: {query_body}")
+
+        if custom_query is not None:
+            query_body = custom_query(query_body, query)
+            logger.debug(f"Calling custom_query, Query body now: {query_body}")
+        # Perform the kNN search on the Elasticsearch index and return the results.
+        response = self.client.search(
+            index=self.index_name,
+            **query_body,
+            size=k,
+            source=fields,
+        )
+
+        def default_doc_builder(hit: Dict) -> Document:
+            return Document(
+                page_content=hit["_source"].get(self.query_field, ""),
+                metadata=hit["_source"]["metadata"],
+            )
+
+        doc_builder = doc_builder or default_doc_builder
+
+        docs_and_scores = []
+        for hit in response["hits"]["hits"]:
+            for field in fields:
+                if field in hit["_source"] and field not in [
+                    "metadata",
+                    self.query_field,
+                ]:
+                    if "metadata" not in hit["_source"]:
+                        hit["_source"]["metadata"] = {}
+                    hit["_source"]["metadata"][field] = hit["_source"][field]
+
+            docs_and_scores.append(
+                (
+                    doc_builder(hit),
+                    hit["_score"],
+                )
+            )
+        return docs_and_scores
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        refresh_indices: Optional[bool] = True,
+        **kwargs: Any,
+    ) -> Optional[bool]:
+        """Delete documents from the Elasticsearch index.
+
+        Args:
+            ids: List of ids of documents to delete.
+            refresh_indices: Whether to refresh the index
+                            after deleting documents. Defaults to True.
+        """
+        try:
+            from elasticsearch.helpers import BulkIndexError, bulk
+        except ImportError:
+            raise ImportError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+
+        body = []
+
+        if ids is None:
+            raise ValueError("ids must be provided.")
+
+        for _id in ids:
+            body.append({"_op_type": "delete", "_index": self.index_name, "_id": _id})
+
+        if len(body) > 0:
+            try:
+                bulk(self.client, body, refresh=refresh_indices, ignore_status=404)
+                logger.debug(f"Deleted {len(body)} texts from index")
+
+                return True
+            except BulkIndexError as e:
+                logger.error(f"Error deleting texts: {e}")
+                firstError = e.errors[0].get("index", {}).get("error", {})
+                logger.error(f"First error reason: {firstError.get('reason')}")
+                raise e
+
+        else:
+            logger.debug("No texts to delete from index")
+            return False
+
+    def _create_index_if_not_exists(
+        self, index_name: str, dims_length: Optional[int] = None
+    ) -> None:
+        """Create the Elasticsearch index if it doesn't already exist.
+
+        Args:
+            index_name: Name of the Elasticsearch index to create.
+            dims_length: Length of the embedding vectors.
+        """
+
+        if self.client.indices.exists(index=index_name):
+            logger.debug(f"Index {index_name} already exists. Skipping creation.")
+
+        else:
+            if dims_length is None and self.strategy.require_inference():
+                raise ValueError(
+                    "Cannot create index without specifying dims_length "
+                    "when the index doesn't already exist. We infer "
+                    "dims_length from the first embedding. Check that "
+                    "you have provided an embedding function."
+                )
+
+            self.strategy.before_index_setup(
+                client=self.client,
+                text_field=self.query_field,
+                vector_query_field=self.vector_query_field,
+            )
+
+            indexSettings = self.strategy.index(
+                vector_query_field=self.vector_query_field,
+                dims_length=dims_length,
+                similarity=self.distance_strategy,
+            )
+            logger.debug(
+                f"Creating index {index_name} with mappings {indexSettings['mappings']}"
+            )
+            self.client.indices.create(index=index_name, **indexSettings)
+
+    def __add(
+        self,
+        texts: Iterable[str],
+        embeddings: Optional[List[List[float]]],
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        ids: Optional[List[str]] = None,
+        refresh_indices: bool = True,
+        create_index_if_not_exists: bool = True,
+        bulk_kwargs: Optional[Dict] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        try:
+            from elasticsearch.helpers import BulkIndexError, bulk
+        except ImportError:
+            raise ImportError(
+                "Could not import elasticsearch python package. "
+                "Please install it with `pip install elasticsearch`."
+            )
+        bulk_kwargs = bulk_kwargs or {}
+        ids = ids or [str(uuid.uuid4()) for _ in texts]
+        requests = []
+
+        if create_index_if_not_exists:
+            if embeddings:
+                dims_length = len(embeddings[0])
+            else:
+                dims_length = None
+
+            self._create_index_if_not_exists(
+                index_name=self.index_name, dims_length=dims_length
+            )
+
+        for i, text in enumerate(texts):
+            metadata = metadatas[i] if metadatas else {}
+
+            request = {
+                "_op_type": "index",
+                "_index": self.index_name,
+                self.query_field: text,
+                "metadata": metadata,
+                "_id": ids[i],
+            }
+            if embeddings:
+                request[self.vector_query_field] = embeddings[i]
+
+            requests.append(request)
+
+        if len(requests) > 0:
+            try:
+                success, failed = bulk(
+                    self.client,
+                    requests,
+                    stats_only=True,
+                    refresh=refresh_indices,
+                    **bulk_kwargs,
+                )
+                logger.debug(
+                    f"Added {success} and failed to add {failed} texts to index"
+                )
+
+                logger.debug(f"added texts {ids} to index")
+                return ids
+            except BulkIndexError as e:
+                logger.error(f"Error adding texts: {e}")
+                firstError = e.errors[0].get("index", {}).get("error", {})
+                logger.error(f"First error reason: {firstError.get('reason')}")
+                raise e
+
+        else:
+            logger.debug("No texts to add to index")
+            return []
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        ids: Optional[List[str]] = None,
+        refresh_indices: bool = True,
+        create_index_if_not_exists: bool = True,
+        bulk_kwargs: Optional[Dict] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of ids to associate with the texts.
+            refresh_indices: Whether to refresh the Elasticsearch indices
+                            after adding the texts.
+            create_index_if_not_exists: Whether to create the Elasticsearch
+                                        index if it doesn't already exist.
+            *bulk_kwargs: Additional arguments to pass to Elasticsearch bulk.
+                - chunk_size: Optional. Number of texts to add to the
+                    index at a time. Defaults to 500.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        if self.embedding is not None:
+            # If no search_type requires inference, we use the provided
+            # embedding function to embed the texts.
+            embeddings = self.embedding.embed_documents(list(texts))
+        else:
+            # the search_type doesn't require inference, so we don't need to
+            # embed the texts.
+            embeddings = None
+
+        return self.__add(
+            texts,
+            embeddings,
+            metadatas=metadatas,
+            ids=ids,
+            refresh_indices=refresh_indices,
+            create_index_if_not_exists=create_index_if_not_exists,
+            bulk_kwargs=bulk_kwargs,
+            kwargs=kwargs,
+        )
+
+    def add_embeddings(
+        self,
+        text_embeddings: Iterable[Tuple[str, List[float]]],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        refresh_indices: bool = True,
+        create_index_if_not_exists: bool = True,
+        bulk_kwargs: Optional[Dict] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add the given texts and embeddings to the vectorstore.
+
+        Args:
+            text_embeddings: Iterable pairs of string and embedding to
+                add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of unique IDs.
+            refresh_indices: Whether to refresh the Elasticsearch indices
+                            after adding the texts.
+            create_index_if_not_exists: Whether to create the Elasticsearch
+                                        index if it doesn't already exist.
+            *bulk_kwargs: Additional arguments to pass to Elasticsearch bulk.
+                - chunk_size: Optional. Number of texts to add to the
+                    index at a time. Defaults to 500.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        texts, embeddings = zip(*text_embeddings)
+        return self.__add(
+            list(texts),
+            list(embeddings),
+            metadatas=metadatas,
+            ids=ids,
+            refresh_indices=refresh_indices,
+            create_index_if_not_exists=create_index_if_not_exists,
+            bulk_kwargs=bulk_kwargs,
+            kwargs=kwargs,
+        )
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[Dict[str, Any]]] = None,
+        bulk_kwargs: Optional[Dict] = None,
+        **kwargs: Any,
+    ) -> "ElasticsearchStore":
+        """Construct ElasticsearchStore wrapper from raw documents.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import ElasticsearchStore
+                from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+                db = ElasticsearchStore.from_texts(
+                    texts,
+                    // embeddings optional if using
+                    // a strategy that doesn't require inference
+                    embeddings,
+                    index_name="langchain-demo",
+                    es_url="http://localhost:9200"
+                )
+
+        Args:
+            texts: List of texts to add to the Elasticsearch index.
+            embedding: Embedding function to use to embed the texts.
+            metadatas: Optional list of metadatas associated with the texts.
+            index_name: Name of the Elasticsearch index to create.
+            es_url: URL of the Elasticsearch instance to connect to.
+            cloud_id: Cloud ID of the Elasticsearch instance to connect to.
+            es_user: Username to use when connecting to Elasticsearch.
+            es_password: Password to use when connecting to Elasticsearch.
+            es_api_key: API key to use when connecting to Elasticsearch.
+            es_connection: Optional pre-existing Elasticsearch connection.
+            vector_query_field: Optional. Name of the field to
+                                store the embedding vectors in.
+            query_field: Optional. Name of the field to store the texts in.
+            distance_strategy: Optional. Name of the distance
+                                strategy to use. Defaults to "COSINE".
+                                can be one of "COSINE",
+                                "EUCLIDEAN_DISTANCE", "DOT_PRODUCT",
+                                "MAX_INNER_PRODUCT".
+            bulk_kwargs: Optional. Additional arguments to pass to
+                        Elasticsearch bulk.
+        """
+
+        elasticsearchStore = ElasticsearchStore._create_cls_from_kwargs(
+            embedding=embedding, **kwargs
+        )
+
+        # Encode the provided texts and add them to the newly created index.
+        elasticsearchStore.add_texts(
+            texts, metadatas=metadatas, bulk_kwargs=bulk_kwargs
+        )
+
+        return elasticsearchStore
+
+    @staticmethod
+    def _create_cls_from_kwargs(
+        embedding: Optional[Embeddings] = None, **kwargs: Any
+    ) -> "ElasticsearchStore":
+        index_name = kwargs.get("index_name")
+
+        if index_name is None:
+            raise ValueError("Please provide an index_name.")
+
+        es_connection = kwargs.get("es_connection")
+        es_cloud_id = kwargs.get("es_cloud_id")
+        es_url = kwargs.get("es_url")
+        es_user = kwargs.get("es_user")
+        es_password = kwargs.get("es_password")
+        es_api_key = kwargs.get("es_api_key")
+        vector_query_field = kwargs.get("vector_query_field")
+        query_field = kwargs.get("query_field")
+        distance_strategy = kwargs.get("distance_strategy")
+        strategy = kwargs.get("strategy", ElasticsearchStore.ApproxRetrievalStrategy())
+
+        optional_args = {}
+
+        if vector_query_field is not None:
+            optional_args["vector_query_field"] = vector_query_field
+
+        if query_field is not None:
+            optional_args["query_field"] = query_field
+
+        return ElasticsearchStore(
+            index_name=index_name,
+            embedding=embedding,
+            es_url=es_url,
+            es_connection=es_connection,
+            es_cloud_id=es_cloud_id,
+            es_user=es_user,
+            es_password=es_password,
+            es_api_key=es_api_key,
+            strategy=strategy,
+            distance_strategy=distance_strategy,
+            **optional_args,
+        )
+
+    @classmethod
+    def from_documents(
+        cls,
+        documents: List[Document],
+        embedding: Optional[Embeddings] = None,
+        bulk_kwargs: Optional[Dict] = None,
+        **kwargs: Any,
+    ) -> "ElasticsearchStore":
+        """Construct ElasticsearchStore wrapper from documents.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import ElasticsearchStore
+                from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+                db = ElasticsearchStore.from_documents(
+                    texts,
+                    embeddings,
+                    index_name="langchain-demo",
+                    es_url="http://localhost:9200"
+                )
+
+        Args:
+            texts: List of texts to add to the Elasticsearch index.
+            embedding: Embedding function to use to embed the texts.
+                      Do not provide if using a strategy
+                      that doesn't require inference.
+            metadatas: Optional list of metadatas associated with the texts.
+            index_name: Name of the Elasticsearch index to create.
+            es_url: URL of the Elasticsearch instance to connect to.
+            cloud_id: Cloud ID of the Elasticsearch instance to connect to.
+            es_user: Username to use when connecting to Elasticsearch.
+            es_password: Password to use when connecting to Elasticsearch.
+            es_api_key: API key to use when connecting to Elasticsearch.
+            es_connection: Optional pre-existing Elasticsearch connection.
+            vector_query_field: Optional. Name of the field
+                                to store the embedding vectors in.
+            query_field: Optional. Name of the field to store the texts in.
+            bulk_kwargs: Optional. Additional arguments to pass to
+                        Elasticsearch bulk.
+        """
+
+        elasticsearchStore = ElasticsearchStore._create_cls_from_kwargs(
+            embedding=embedding, **kwargs
+        )
+        # Encode the provided texts and add them to the newly created index.
+        elasticsearchStore.add_documents(documents, bulk_kwargs=bulk_kwargs)
+
+        return elasticsearchStore
+
+    @staticmethod
+    def ExactRetrievalStrategy() -> "ExactRetrievalStrategy":
+        """Used to perform brute force / exact
+        nearest neighbor search via script_score."""
+        return ExactRetrievalStrategy()
+
+    @staticmethod
+    def ApproxRetrievalStrategy(
+        query_model_id: Optional[str] = None,
+        hybrid: Optional[bool] = False,
+        rrf: Optional[Union[dict, bool]] = True,
+    ) -> "ApproxRetrievalStrategy":
+        """Used to perform approximate nearest neighbor search
+        using the HNSW algorithm.
+
+        At build index time, this strategy will create a
+        dense vector field in the index and store the
+        embedding vectors in the index.
+
+        At query time, the text will either be embedded using the
+        provided embedding function or the query_model_id
+        will be used to embed the text using the model
+        deployed to Elasticsearch.
+
+        if query_model_id is used, do not provide an embedding function.
+
+        Args:
+            query_model_id: Optional. ID of the model to use to
+                            embed the query text within the stack. Requires
+                            embedding model to be deployed to Elasticsearch.
+            hybrid: Optional. If True, will perform a hybrid search
+                    using both the knn query and a text query.
+                    Defaults to False.
+            rrf: Optional. rrf is Reciprocal Rank Fusion.
+                 When `hybrid` is True,
+                    and `rrf` is True, then rrf: {}.
+                    and `rrf` is False, then rrf is omitted.
+                    and isinstance(rrf, dict) is True, then pass in the dict values.
+                 rrf could be passed for adjusting 'rank_constant' and 'window_size'.
+        """
+        return ApproxRetrievalStrategy(
+            query_model_id=query_model_id, hybrid=hybrid, rrf=rrf
+        )
+
+    @staticmethod
+    def SparseVectorRetrievalStrategy(
+        model_id: Optional[str] = None,
+    ) -> "SparseRetrievalStrategy":
+        """Used to perform sparse vector search via text_expansion.
+        Used for when you want to use ELSER model to perform document search.
+
+        At build index time, this strategy will create a pipeline that
+        will embed the text using the ELSER model and store the
+        resulting tokens in the index.
+
+        At query time, the text will be embedded using the ELSER
+        model and the resulting tokens will be used to
+        perform a text_expansion query.
+
+        Args:
+            model_id: Optional. Default is ".elser_model_1".
+                    ID of the model to use to embed the query text
+                    within the stack. Requires embedding model to be
+                    deployed to Elasticsearch.
+        """
+        return SparseRetrievalStrategy(model_id=model_id)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/epsilla.py b/llm/Lib/site-packages/langchain_community/vectorstores/epsilla.py
new file mode 100644
index 0000000000000000000000000000000000000000..b41a07d8025b502ee1e2cb9f7763e4bf83c26cbf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/epsilla.py
@@ -0,0 +1,375 @@
+"""Wrapper around Epsilla vector database."""
+from __future__ import annotations
+
+import logging
+import uuid
+from typing import TYPE_CHECKING, Any, Iterable, List, Optional, Type
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    from pyepsilla import vectordb
+
+logger = logging.getLogger()
+
+
+class Epsilla(VectorStore):
+    """
+    Wrapper around Epsilla vector database.
+
+    As a prerequisite, you need to install ``pyepsilla`` package
+    and have a running Epsilla vector database (for example, through our docker image)
+    See the following documentation for how to run an Epsilla vector database:
+    https://epsilla-inc.gitbook.io/epsilladb/quick-start
+
+    Args:
+        client (Any): Epsilla client to connect to.
+        embeddings (Embeddings): Function used to embed the texts.
+        db_path (Optional[str]): The path where the database will be persisted.
+                                 Defaults to "/tmp/langchain-epsilla".
+        db_name (Optional[str]): Give a name to the loaded database.
+                                 Defaults to "langchain_store".
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import Epsilla
+            from pyepsilla import vectordb
+
+            client = vectordb.Client()
+            embeddings = OpenAIEmbeddings()
+            db_path = "/tmp/vectorstore"
+            db_name = "langchain_store"
+            epsilla = Epsilla(client, embeddings, db_path, db_name)
+    """
+
+    _LANGCHAIN_DEFAULT_DB_NAME = "langchain_store"
+    _LANGCHAIN_DEFAULT_DB_PATH = "/tmp/langchain-epsilla"
+    _LANGCHAIN_DEFAULT_TABLE_NAME = "langchain_collection"
+
+    def __init__(
+        self,
+        client: Any,
+        embeddings: Embeddings,
+        db_path: Optional[str] = _LANGCHAIN_DEFAULT_DB_PATH,
+        db_name: Optional[str] = _LANGCHAIN_DEFAULT_DB_NAME,
+    ):
+        """Initialize with necessary components."""
+        try:
+            import pyepsilla
+        except ImportError as e:
+            raise ImportError(
+                "Could not import pyepsilla python package. "
+                "Please install pyepsilla package with `pip install pyepsilla`."
+            ) from e
+
+        if not isinstance(client, pyepsilla.vectordb.Client):
+            raise TypeError(
+                f"client should be an instance of pyepsilla.vectordb.Client, "
+                f"got {type(client)}"
+            )
+
+        self._client: vectordb.Client = client
+        self._db_name = db_name
+        self._embeddings = embeddings
+        self._collection_name = Epsilla._LANGCHAIN_DEFAULT_TABLE_NAME
+        self._client.load_db(db_name=db_name, db_path=db_path)
+        self._client.use_db(db_name=db_name)
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self._embeddings
+
+    def use_collection(self, collection_name: str) -> None:
+        """
+        Set default collection to use.
+
+        Args:
+            collection_name (str): The name of the collection.
+        """
+        self._collection_name = collection_name
+
+    def clear_data(self, collection_name: str = "") -> None:
+        """
+        Clear data in a collection.
+
+        Args:
+            collection_name (Optional[str]): The name of the collection.
+                If not provided, the default collection will be used.
+        """
+        if not collection_name:
+            collection_name = self._collection_name
+        self._client.drop_table(collection_name)
+
+    def get(
+        self, collection_name: str = "", response_fields: Optional[List[str]] = None
+    ) -> List[dict]:
+        """Get the collection.
+
+        Args:
+            collection_name (Optional[str]): The name of the collection
+                to retrieve data from.
+                If not provided, the default collection will be used.
+            response_fields (Optional[List[str]]): List of field names in the result.
+                If not specified, all available fields will be responded.
+
+        Returns:
+            A list of the retrieved data.
+        """
+        if not collection_name:
+            collection_name = self._collection_name
+        status_code, response = self._client.get(
+            table_name=collection_name, response_fields=response_fields
+        )
+        if status_code != 200:
+            logger.error(f"Failed to get records: {response['message']}")
+            raise Exception("Error: {}.".format(response["message"]))
+        return response["result"]
+
+    def _create_collection(
+        self, table_name: str, embeddings: list, metadatas: Optional[list[dict]] = None
+    ) -> None:
+        if not embeddings:
+            raise ValueError("Embeddings list is empty.")
+
+        dim = len(embeddings[0])
+        fields: List[dict] = [
+            {"name": "id", "dataType": "INT"},
+            {"name": "text", "dataType": "STRING"},
+            {"name": "embeddings", "dataType": "VECTOR_FLOAT", "dimensions": dim},
+        ]
+        if metadatas is not None:
+            field_names = [field["name"] for field in fields]
+            for metadata in metadatas:
+                for key, value in metadata.items():
+                    if key in field_names:
+                        continue
+                    d_type: str
+                    if isinstance(value, str):
+                        d_type = "STRING"
+                    elif isinstance(value, int):
+                        d_type = "INT"
+                    elif isinstance(value, float):
+                        d_type = "FLOAT"
+                    elif isinstance(value, bool):
+                        d_type = "BOOL"
+                    else:
+                        raise ValueError(f"Unsupported data type for {key}.")
+                    fields.append({"name": key, "dataType": d_type})
+                    field_names.append(key)
+
+        status_code, response = self._client.create_table(
+            table_name, table_fields=fields
+        )
+        if status_code != 200:
+            if status_code == 409:
+                logger.info(f"Continuing with the existing table {table_name}.")
+            else:
+                logger.error(
+                    f"Failed to create collection {table_name}: {response['message']}"
+                )
+                raise Exception("Error: {}.".format(response["message"]))
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        collection_name: Optional[str] = "",
+        drop_old: Optional[bool] = False,
+        **kwargs: Any,
+    ) -> List[str]:
+        """
+        Embed texts and add them to the database.
+
+        Args:
+            texts (Iterable[str]): The texts to embed.
+            metadatas (Optional[List[dict]]): Metadata dicts
+                        attached to each of the texts. Defaults to None.
+            collection_name (Optional[str]): Which collection to use.
+                        Defaults to "langchain_collection".
+                        If provided, default collection name will be set as well.
+            drop_old (Optional[bool]): Whether to drop the previous collection
+                        and create a new one. Defaults to False.
+
+        Returns:
+            List of ids of the added texts.
+        """
+        if not collection_name:
+            collection_name = self._collection_name
+        else:
+            self._collection_name = collection_name
+
+        if drop_old:
+            self._client.drop_db(db_name=collection_name)
+
+        texts = list(texts)
+        try:
+            embeddings = self._embeddings.embed_documents(texts)
+        except NotImplementedError:
+            embeddings = [self._embeddings.embed_query(x) for x in texts]
+
+        if len(embeddings) == 0:
+            logger.debug("Nothing to insert, skipping.")
+            return []
+
+        self._create_collection(
+            table_name=collection_name, embeddings=embeddings, metadatas=metadatas
+        )
+
+        ids = [hash(uuid.uuid4()) for _ in texts]
+        records = []
+        for index, id in enumerate(ids):
+            record = {
+                "id": id,
+                "text": texts[index],
+                "embeddings": embeddings[index],
+            }
+            if metadatas is not None:
+                metadata = metadatas[index].items()
+                for key, value in metadata:
+                    record[key] = value
+            records.append(record)
+
+        status_code, response = self._client.insert(
+            table_name=collection_name, records=records
+        )
+        if status_code != 200:
+            logger.error(
+                f"Failed to add records to {collection_name}: {response['message']}"
+            )
+            raise Exception("Error: {}.".format(response["message"]))
+        return [str(id) for id in ids]
+
+    def similarity_search(
+        self, query: str, k: int = 4, collection_name: str = "", **kwargs: Any
+    ) -> List[Document]:
+        """
+        Return the documents that are semantically most relevant to the query.
+
+        Args:
+            query (str): String to query the vectorstore with.
+            k (Optional[int]): Number of documents to return. Defaults to 4.
+            collection_name (Optional[str]): Collection to use.
+                Defaults to "langchain_store" or the one provided before.
+        Returns:
+            List of documents that are semantically most relevant to the query
+        """
+        if not collection_name:
+            collection_name = self._collection_name
+        query_vector = self._embeddings.embed_query(query)
+        status_code, response = self._client.query(
+            table_name=collection_name,
+            query_field="embeddings",
+            query_vector=query_vector,
+            limit=k,
+        )
+        if status_code != 200:
+            logger.error(f"Search failed: {response['message']}.")
+            raise Exception("Error: {}.".format(response["message"]))
+
+        exclude_keys = ["id", "text", "embeddings"]
+        return list(
+            map(
+                lambda item: Document(
+                    page_content=item["text"],
+                    metadata={
+                        key: item[key] for key in item if key not in exclude_keys
+                    },
+                ),
+                response["result"],
+            )
+        )
+
+    @classmethod
+    def from_texts(
+        cls: Type[Epsilla],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        client: Any = None,
+        db_path: Optional[str] = _LANGCHAIN_DEFAULT_DB_PATH,
+        db_name: Optional[str] = _LANGCHAIN_DEFAULT_DB_NAME,
+        collection_name: Optional[str] = _LANGCHAIN_DEFAULT_TABLE_NAME,
+        drop_old: Optional[bool] = False,
+        **kwargs: Any,
+    ) -> Epsilla:
+        """Create an Epsilla vectorstore from raw documents.
+
+        Args:
+            texts (List[str]): List of text data to be inserted.
+            embeddings (Embeddings): Embedding function.
+            client (pyepsilla.vectordb.Client): Epsilla client to connect to.
+            metadatas (Optional[List[dict]]): Metadata for each text.
+                    Defaults to None.
+            db_path (Optional[str]): The path where the database will be persisted.
+                    Defaults to "/tmp/langchain-epsilla".
+            db_name (Optional[str]): Give a name to the loaded database.
+                    Defaults to "langchain_store".
+            collection_name (Optional[str]): Which collection to use.
+                    Defaults to "langchain_collection".
+                    If provided, default collection name will be set as well.
+            drop_old (Optional[bool]): Whether to drop the previous collection
+                    and create a new one. Defaults to False.
+
+        Returns:
+            Epsilla: Epsilla vector store.
+        """
+        instance = Epsilla(client, embedding, db_path=db_path, db_name=db_name)
+        instance.add_texts(
+            texts,
+            metadatas=metadatas,
+            collection_name=collection_name,
+            drop_old=drop_old,
+            **kwargs,
+        )
+
+        return instance
+
+    @classmethod
+    def from_documents(
+        cls: Type[Epsilla],
+        documents: List[Document],
+        embedding: Embeddings,
+        client: Any = None,
+        db_path: Optional[str] = _LANGCHAIN_DEFAULT_DB_PATH,
+        db_name: Optional[str] = _LANGCHAIN_DEFAULT_DB_NAME,
+        collection_name: Optional[str] = _LANGCHAIN_DEFAULT_TABLE_NAME,
+        drop_old: Optional[bool] = False,
+        **kwargs: Any,
+    ) -> Epsilla:
+        """Create an Epsilla vectorstore from a list of documents.
+
+        Args:
+            texts (List[str]): List of text data to be inserted.
+            embeddings (Embeddings): Embedding function.
+            client (pyepsilla.vectordb.Client): Epsilla client to connect to.
+            metadatas (Optional[List[dict]]): Metadata for each text.
+                    Defaults to None.
+            db_path (Optional[str]): The path where the database will be persisted.
+                    Defaults to "/tmp/langchain-epsilla".
+            db_name (Optional[str]): Give a name to the loaded database.
+                    Defaults to "langchain_store".
+            collection_name (Optional[str]): Which collection to use.
+                    Defaults to "langchain_collection".
+                    If provided, default collection name will be set as well.
+            drop_old (Optional[bool]): Whether to drop the previous collection
+                    and create a new one. Defaults to False.
+
+        Returns:
+            Epsilla: Epsilla vector store.
+        """
+        texts = [doc.page_content for doc in documents]
+        metadatas = [doc.metadata for doc in documents]
+
+        return cls.from_texts(
+            texts,
+            embedding,
+            metadatas=metadatas,
+            client=client,
+            db_path=db_path,
+            db_name=db_name,
+            collection_name=collection_name,
+            drop_old=drop_old,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/faiss.py b/llm/Lib/site-packages/langchain_community/vectorstores/faiss.py
new file mode 100644
index 0000000000000000000000000000000000000000..d01de0068982ad62031398718253e652b36ca347
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/faiss.py
@@ -0,0 +1,1231 @@
+from __future__ import annotations
+
+import logging
+import operator
+import os
+import pickle
+import uuid
+import warnings
+from pathlib import Path
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Sized,
+    Tuple,
+    Union,
+)
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.runnables.config import run_in_executor
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.docstore.base import AddableMixin, Docstore
+from langchain_community.docstore.in_memory import InMemoryDocstore
+from langchain_community.vectorstores.utils import (
+    DistanceStrategy,
+    maximal_marginal_relevance,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def dependable_faiss_import(no_avx2: Optional[bool] = None) -> Any:
+    """
+    Import faiss if available, otherwise raise error.
+    If FAISS_NO_AVX2 environment variable is set, it will be considered
+    to load FAISS with no AVX2 optimization.
+
+    Args:
+        no_avx2: Load FAISS strictly with no AVX2 optimization
+            so that the vectorstore is portable and compatible with other devices.
+    """
+    if no_avx2 is None and "FAISS_NO_AVX2" in os.environ:
+        no_avx2 = bool(os.getenv("FAISS_NO_AVX2"))
+
+    try:
+        if no_avx2:
+            from faiss import swigfaiss as faiss
+        else:
+            import faiss
+    except ImportError:
+        raise ImportError(
+            "Could not import faiss python package. "
+            "Please install it with `pip install faiss-gpu` (for CUDA supported GPU) "
+            "or `pip install faiss-cpu` (depending on Python version)."
+        )
+    return faiss
+
+
+def _len_check_if_sized(x: Any, y: Any, x_name: str, y_name: str) -> None:
+    if isinstance(x, Sized) and isinstance(y, Sized) and len(x) != len(y):
+        raise ValueError(
+            f"{x_name} and {y_name} expected to be equal length but "
+            f"len({x_name})={len(x)} and len({y_name})={len(y)}"
+        )
+    return
+
+
+class FAISS(VectorStore):
+    """`Meta Faiss` vector store.
+
+    To use, you must have the ``faiss`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+            from langchain_community.vectorstores import FAISS
+
+            embeddings = OpenAIEmbeddings()
+            texts = ["FAISS is an important library", "LangChain supports FAISS"]
+            faiss = FAISS.from_texts(texts, embeddings)
+
+    """
+
+    def __init__(
+        self,
+        embedding_function: Union[
+            Callable[[str], List[float]],
+            Embeddings,
+        ],
+        index: Any,
+        docstore: Docstore,
+        index_to_docstore_id: Dict[int, str],
+        relevance_score_fn: Optional[Callable[[float], float]] = None,
+        normalize_L2: bool = False,
+        distance_strategy: DistanceStrategy = DistanceStrategy.EUCLIDEAN_DISTANCE,
+    ):
+        """Initialize with necessary components."""
+        if not isinstance(embedding_function, Embeddings):
+            logger.warning(
+                "`embedding_function` is expected to be an Embeddings object, support "
+                "for passing in a function will soon be removed."
+            )
+        self.embedding_function = embedding_function
+        self.index = index
+        self.docstore = docstore
+        self.index_to_docstore_id = index_to_docstore_id
+        self.distance_strategy = distance_strategy
+        self.override_relevance_score_fn = relevance_score_fn
+        self._normalize_L2 = normalize_L2
+        if (
+            self.distance_strategy != DistanceStrategy.EUCLIDEAN_DISTANCE
+            and self._normalize_L2
+        ):
+            warnings.warn(
+                "Normalizing L2 is not applicable for "
+                f"metric type: {self.distance_strategy}"
+            )
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return (
+            self.embedding_function
+            if isinstance(self.embedding_function, Embeddings)
+            else None
+        )
+
+    def _embed_documents(self, texts: List[str]) -> List[List[float]]:
+        if isinstance(self.embedding_function, Embeddings):
+            return self.embedding_function.embed_documents(texts)
+        else:
+            return [self.embedding_function(text) for text in texts]
+
+    async def _aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        if isinstance(self.embedding_function, Embeddings):
+            return await self.embedding_function.aembed_documents(texts)
+        else:
+            # return await asyncio.gather(
+            #     [self.embedding_function(text) for text in texts]
+            # )
+            raise Exception(
+                "`embedding_function` is expected to be an Embeddings object, support "
+                "for passing in a function will soon be removed."
+            )
+
+    def _embed_query(self, text: str) -> List[float]:
+        if isinstance(self.embedding_function, Embeddings):
+            return self.embedding_function.embed_query(text)
+        else:
+            return self.embedding_function(text)
+
+    async def _aembed_query(self, text: str) -> List[float]:
+        if isinstance(self.embedding_function, Embeddings):
+            return await self.embedding_function.aembed_query(text)
+        else:
+            # return await self.embedding_function(text)
+            raise Exception(
+                "`embedding_function` is expected to be an Embeddings object, support "
+                "for passing in a function will soon be removed."
+            )
+
+    def __add(
+        self,
+        texts: Iterable[str],
+        embeddings: Iterable[List[float]],
+        metadatas: Optional[Iterable[dict]] = None,
+        ids: Optional[List[str]] = None,
+    ) -> List[str]:
+        faiss = dependable_faiss_import()
+
+        if not isinstance(self.docstore, AddableMixin):
+            raise ValueError(
+                "If trying to add texts, the underlying docstore should support "
+                f"adding items, which {self.docstore} does not"
+            )
+
+        _len_check_if_sized(texts, metadatas, "texts", "metadatas")
+        _metadatas = metadatas or ({} for _ in texts)
+        documents = [
+            Document(page_content=t, metadata=m) for t, m in zip(texts, _metadatas)
+        ]
+
+        _len_check_if_sized(documents, embeddings, "documents", "embeddings")
+        _len_check_if_sized(documents, ids, "documents", "ids")
+
+        if ids and len(ids) != len(set(ids)):
+            raise ValueError("Duplicate ids found in the ids list.")
+
+        # Add to the index.
+        vector = np.array(embeddings, dtype=np.float32)
+        if self._normalize_L2:
+            faiss.normalize_L2(vector)
+        self.index.add(vector)
+
+        # Add information to docstore and index.
+        ids = ids or [str(uuid.uuid4()) for _ in texts]
+        self.docstore.add({id_: doc for id_, doc in zip(ids, documents)})
+        starting_len = len(self.index_to_docstore_id)
+        index_to_id = {starting_len + j: id_ for j, id_ in enumerate(ids)}
+        self.index_to_docstore_id.update(index_to_id)
+        return ids
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of unique IDs.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        texts = list(texts)
+        embeddings = self._embed_documents(texts)
+        return self.__add(texts, embeddings, metadatas=metadatas, ids=ids)
+
+    async def aadd_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore
+            asynchronously.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of unique IDs.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        texts = list(texts)
+        embeddings = await self._aembed_documents(texts)
+        return self.__add(texts, embeddings, metadatas=metadatas, ids=ids)
+
+    def add_embeddings(
+        self,
+        text_embeddings: Iterable[Tuple[str, List[float]]],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add the given texts and embeddings to the vectorstore.
+
+        Args:
+            text_embeddings: Iterable pairs of string and embedding to
+                add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of unique IDs.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        # Embed and create the documents.
+        texts, embeddings = zip(*text_embeddings)
+        return self.__add(texts, embeddings, metadatas=metadatas, ids=ids)
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            embedding: Embedding vector to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Union[Callable, Dict[str, Any]]]): Filter by metadata.
+                Defaults to None. If a callable, it must take as input the
+                metadata dict of Document and return a bool.
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+            **kwargs: kwargs to be passed to similarity search. Can include:
+                score_threshold: Optional, a floating point value between 0 to 1 to
+                    filter the resulting set of retrieved docs
+
+        Returns:
+            List of documents most similar to the query text and L2 distance
+            in float for each. Lower score represents more similarity.
+        """
+        faiss = dependable_faiss_import()
+        vector = np.array([embedding], dtype=np.float32)
+        if self._normalize_L2:
+            faiss.normalize_L2(vector)
+        scores, indices = self.index.search(vector, k if filter is None else fetch_k)
+        docs = []
+
+        if filter is not None:
+            filter_func = self._create_filter_func(filter)
+
+        for j, i in enumerate(indices[0]):
+            if i == -1:
+                # This happens when not enough docs are returned.
+                continue
+            _id = self.index_to_docstore_id[i]
+            doc = self.docstore.search(_id)
+            if not isinstance(doc, Document):
+                raise ValueError(f"Could not find document for id {_id}, got {doc}")
+            if filter is not None:
+                if filter_func(doc.metadata):
+                    docs.append((doc, scores[0][j]))
+            else:
+                docs.append((doc, scores[0][j]))
+
+        score_threshold = kwargs.get("score_threshold")
+        if score_threshold is not None:
+            cmp = (
+                operator.ge
+                if self.distance_strategy
+                in (DistanceStrategy.MAX_INNER_PRODUCT, DistanceStrategy.JACCARD)
+                else operator.le
+            )
+            docs = [
+                (doc, similarity)
+                for doc, similarity in docs
+                if cmp(similarity, score_threshold)
+            ]
+        return docs[:k]
+
+    async def asimilarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query asynchronously.
+
+        Args:
+            embedding: Embedding vector to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, Any]]): Filter by metadata.
+                Defaults to None. If a callable, it must take as input the
+                metadata dict of Document and return a bool.
+
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+            **kwargs: kwargs to be passed to similarity search. Can include:
+                score_threshold: Optional, a floating point value between 0 to 1 to
+                    filter the resulting set of retrieved docs
+
+        Returns:
+            List of documents most similar to the query text and L2 distance
+            in float for each. Lower score represents more similarity.
+        """
+
+        # This is a temporary workaround to make the similarity search asynchronous.
+        return await run_in_executor(
+            None,
+            self.similarity_search_with_score_by_vector,
+            embedding,
+            k=k,
+            filter=filter,
+            fetch_k=fetch_k,
+            **kwargs,
+        )
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata.
+                Defaults to None. If a callable, it must take as input the
+                metadata dict of Document and return a bool.
+
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+
+        Returns:
+            List of documents most similar to the query text with
+            L2 distance in float. Lower score represents more similarity.
+        """
+        embedding = self._embed_query(query)
+        docs = self.similarity_search_with_score_by_vector(
+            embedding,
+            k,
+            filter=filter,
+            fetch_k=fetch_k,
+            **kwargs,
+        )
+        return docs
+
+    async def asimilarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query asynchronously.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata.
+                Defaults to None. If a callable, it must take as input the
+                metadata dict of Document and return a bool.
+
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+
+        Returns:
+            List of documents most similar to the query text with
+            L2 distance in float. Lower score represents more similarity.
+        """
+        embedding = await self._aembed_query(query)
+        docs = await self.asimilarity_search_with_score_by_vector(
+            embedding,
+            k,
+            filter=filter,
+            fetch_k=fetch_k,
+            **kwargs,
+        )
+        return docs
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata.
+                Defaults to None. If a callable, it must take as input the
+                metadata dict of Document and return a bool.
+
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+
+        Returns:
+            List of Documents most similar to the embedding.
+        """
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding,
+            k,
+            filter=filter,
+            fetch_k=fetch_k,
+            **kwargs,
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    async def asimilarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector asynchronously.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata.
+                Defaults to None. If a callable, it must take as input the
+                metadata dict of Document and return a bool.
+
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+
+        Returns:
+            List of Documents most similar to the embedding.
+        """
+        docs_and_scores = await self.asimilarity_search_with_score_by_vector(
+            embedding,
+            k,
+            filter=filter,
+            fetch_k=fetch_k,
+            **kwargs,
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query, k, filter=filter, fetch_k=fetch_k, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    async def asimilarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query asynchronously.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        docs_and_scores = await self.asimilarity_search_with_score(
+            query, k, filter=filter, fetch_k=fetch_k, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def max_marginal_relevance_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        *,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs and their similarity scores selected using the maximal marginal
+            relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch before filtering to
+                     pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents and similarity scores selected by maximal marginal
+                relevance and score for each.
+        """
+        scores, indices = self.index.search(
+            np.array([embedding], dtype=np.float32),
+            fetch_k if filter is None else fetch_k * 2,
+        )
+        if filter is not None:
+            filter_func = self._create_filter_func(filter)
+            filtered_indices = []
+            for i in indices[0]:
+                if i == -1:
+                    # This happens when not enough docs are returned.
+                    continue
+                _id = self.index_to_docstore_id[i]
+                doc = self.docstore.search(_id)
+                if not isinstance(doc, Document):
+                    raise ValueError(f"Could not find document for id {_id}, got {doc}")
+                if filter_func(doc.metadata):
+                    filtered_indices.append(i)
+            indices = np.array([filtered_indices])
+        # -1 happens when not enough docs are returned.
+        embeddings = [self.index.reconstruct(int(i)) for i in indices[0] if i != -1]
+        mmr_selected = maximal_marginal_relevance(
+            np.array([embedding], dtype=np.float32),
+            embeddings,
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+
+        docs_and_scores = []
+        for i in mmr_selected:
+            if indices[0][i] == -1:
+                # This happens when not enough docs are returned.
+                continue
+            _id = self.index_to_docstore_id[indices[0][i]]
+            doc = self.docstore.search(_id)
+            if not isinstance(doc, Document):
+                raise ValueError(f"Could not find document for id {_id}, got {doc}")
+            docs_and_scores.append((doc, scores[0][i]))
+
+        return docs_and_scores
+
+    async def amax_marginal_relevance_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        *,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs and their similarity scores selected using the maximal marginal
+            relevance asynchronously.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch before filtering to
+                     pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents and similarity scores selected by maximal marginal
+                relevance and score for each.
+        """
+        # This is a temporary workaround to make the similarity search asynchronous.
+        return await run_in_executor(
+            None,
+            self.max_marginal_relevance_search_with_score_by_vector,
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+        )
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch before filtering to
+                     pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        docs_and_scores = self.max_marginal_relevance_search_with_score_by_vector(
+            embedding, k=k, fetch_k=fetch_k, lambda_mult=lambda_mult, filter=filter
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    async def amax_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance asynchronously.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch before filtering to
+                     pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        docs_and_scores = (
+            await self.amax_marginal_relevance_search_with_score_by_vector(
+                embedding, k=k, fetch_k=fetch_k, lambda_mult=lambda_mult, filter=filter
+            )
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch before filtering (if needed) to
+                     pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        embedding = self._embed_query(query)
+        docs = self.max_marginal_relevance_search_by_vector(
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+        return docs
+
+    async def amax_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance asynchronously.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch before filtering (if needed) to
+                     pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        embedding = await self._aembed_query(query)
+        docs = await self.amax_marginal_relevance_search_by_vector(
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+        return docs
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        """Delete by ID. These are the IDs in the vectorstore.
+
+        Args:
+            ids: List of ids to delete.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+        if ids is None:
+            raise ValueError("No ids provided to delete.")
+        missing_ids = set(ids).difference(self.index_to_docstore_id.values())
+        if missing_ids:
+            raise ValueError(
+                f"Some specified ids do not exist in the current store. Ids not found: "
+                f"{missing_ids}"
+            )
+
+        reversed_index = {id_: idx for idx, id_ in self.index_to_docstore_id.items()}
+        index_to_delete = {reversed_index[id_] for id_ in ids}
+
+        self.index.remove_ids(np.fromiter(index_to_delete, dtype=np.int64))
+        self.docstore.delete(ids)
+
+        remaining_ids = [
+            id_
+            for i, id_ in sorted(self.index_to_docstore_id.items())
+            if i not in index_to_delete
+        ]
+        self.index_to_docstore_id = {i: id_ for i, id_ in enumerate(remaining_ids)}
+
+        return True
+
+    def merge_from(self, target: FAISS) -> None:
+        """Merge another FAISS object with the current one.
+
+        Add the target FAISS to the current one.
+
+        Args:
+            target: FAISS object you wish to merge into the current one
+
+        Returns:
+            None.
+        """
+        if not isinstance(self.docstore, AddableMixin):
+            raise ValueError("Cannot merge with this type of docstore")
+        # Numerical index for target docs are incremental on existing ones
+        starting_len = len(self.index_to_docstore_id)
+
+        # Merge two IndexFlatL2
+        self.index.merge_from(target.index)
+
+        # Get id and docs from target FAISS object
+        full_info = []
+        for i, target_id in target.index_to_docstore_id.items():
+            doc = target.docstore.search(target_id)
+            if not isinstance(doc, Document):
+                raise ValueError("Document should be returned")
+            full_info.append((starting_len + i, target_id, doc))
+
+        # Add information to docstore and index_to_docstore_id.
+        self.docstore.add({_id: doc for _, _id, doc in full_info})
+        index_to_id = {index: _id for index, _id, _ in full_info}
+        self.index_to_docstore_id.update(index_to_id)
+
+    @classmethod
+    def __from(
+        cls,
+        texts: Iterable[str],
+        embeddings: List[List[float]],
+        embedding: Embeddings,
+        metadatas: Optional[Iterable[dict]] = None,
+        ids: Optional[List[str]] = None,
+        normalize_L2: bool = False,
+        distance_strategy: DistanceStrategy = DistanceStrategy.EUCLIDEAN_DISTANCE,
+        **kwargs: Any,
+    ) -> FAISS:
+        faiss = dependable_faiss_import()
+        if distance_strategy == DistanceStrategy.MAX_INNER_PRODUCT:
+            index = faiss.IndexFlatIP(len(embeddings[0]))
+        else:
+            # Default to L2, currently other metric types not initialized.
+            index = faiss.IndexFlatL2(len(embeddings[0]))
+        docstore = kwargs.pop("docstore", InMemoryDocstore())
+        index_to_docstore_id = kwargs.pop("index_to_docstore_id", {})
+        vecstore = cls(
+            embedding,
+            index,
+            docstore,
+            index_to_docstore_id,
+            normalize_L2=normalize_L2,
+            distance_strategy=distance_strategy,
+            **kwargs,
+        )
+        vecstore.__add(texts, embeddings, metadatas=metadatas, ids=ids)
+        return vecstore
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> FAISS:
+        """Construct FAISS wrapper from raw documents.
+
+        This is a user friendly interface that:
+            1. Embeds documents.
+            2. Creates an in memory docstore
+            3. Initializes the FAISS database
+
+        This is intended to be a quick way to get started.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import FAISS
+                from langchain_community.embeddings import OpenAIEmbeddings
+
+                embeddings = OpenAIEmbeddings()
+                faiss = FAISS.from_texts(texts, embeddings)
+        """
+        embeddings = embedding.embed_documents(texts)
+        return cls.__from(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            **kwargs,
+        )
+
+    @classmethod
+    async def afrom_texts(
+        cls,
+        texts: list[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> FAISS:
+        """Construct FAISS wrapper from raw documents asynchronously.
+
+        This is a user friendly interface that:
+            1. Embeds documents.
+            2. Creates an in memory docstore
+            3. Initializes the FAISS database
+
+        This is intended to be a quick way to get started.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import FAISS
+                from langchain_community.embeddings import OpenAIEmbeddings
+
+                embeddings = OpenAIEmbeddings()
+                faiss = await FAISS.afrom_texts(texts, embeddings)
+        """
+        embeddings = await embedding.aembed_documents(texts)
+        return cls.__from(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_embeddings(
+        cls,
+        text_embeddings: Iterable[Tuple[str, List[float]]],
+        embedding: Embeddings,
+        metadatas: Optional[Iterable[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> FAISS:
+        """Construct FAISS wrapper from raw documents.
+
+        This is a user friendly interface that:
+            1. Embeds documents.
+            2. Creates an in memory docstore
+            3. Initializes the FAISS database
+
+        This is intended to be a quick way to get started.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import FAISS
+                from langchain_community.embeddings import OpenAIEmbeddings
+
+                embeddings = OpenAIEmbeddings()
+                text_embeddings = embeddings.embed_documents(texts)
+                text_embedding_pairs = zip(texts, text_embeddings)
+                faiss = FAISS.from_embeddings(text_embedding_pairs, embeddings)
+        """
+        texts, embeddings = zip(*text_embeddings)
+        return cls.__from(
+            list(texts),
+            list(embeddings),
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            **kwargs,
+        )
+
+    @classmethod
+    async def afrom_embeddings(
+        cls,
+        text_embeddings: Iterable[Tuple[str, List[float]]],
+        embedding: Embeddings,
+        metadatas: Optional[Iterable[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> FAISS:
+        """Construct FAISS wrapper from raw documents asynchronously."""
+        return cls.from_embeddings(
+            text_embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            **kwargs,
+        )
+
+    def save_local(self, folder_path: str, index_name: str = "index") -> None:
+        """Save FAISS index, docstore, and index_to_docstore_id to disk.
+
+        Args:
+            folder_path: folder path to save index, docstore,
+                and index_to_docstore_id to.
+            index_name: for saving with a specific index file name
+        """
+        path = Path(folder_path)
+        path.mkdir(exist_ok=True, parents=True)
+
+        # save index separately since it is not picklable
+        faiss = dependable_faiss_import()
+        faiss.write_index(self.index, str(path / f"{index_name}.faiss"))
+
+        # save docstore and index_to_docstore_id
+        with open(path / f"{index_name}.pkl", "wb") as f:
+            pickle.dump((self.docstore, self.index_to_docstore_id), f)
+
+    @classmethod
+    def load_local(
+        cls,
+        folder_path: str,
+        embeddings: Embeddings,
+        index_name: str = "index",
+        *,
+        allow_dangerous_deserialization: bool = False,
+        **kwargs: Any,
+    ) -> FAISS:
+        """Load FAISS index, docstore, and index_to_docstore_id from disk.
+
+        Args:
+            folder_path: folder path to load index, docstore,
+                and index_to_docstore_id from.
+            embeddings: Embeddings to use when generating queries
+            index_name: for saving with a specific index file name
+            allow_dangerous_deserialization: whether to allow deserialization
+                of the data which involves loading a pickle file.
+                Pickle files can be modified by malicious actors to deliver a
+                malicious payload that results in execution of
+                arbitrary code on your machine.
+            asynchronous: whether to use async version or not
+        """
+        if not allow_dangerous_deserialization:
+            raise ValueError(
+                "The de-serialization relies loading a pickle file. "
+                "Pickle files can be modified to deliver a malicious payload that "
+                "results in execution of arbitrary code on your machine."
+                "You will need to set `allow_dangerous_deserialization` to `True` to "
+                "enable deserialization. If you do this, make sure that you "
+                "trust the source of the data. For example, if you are loading a "
+                "file that you created, and no that no one else has modified the file, "
+                "then this is safe to do. Do not set this to `True` if you are loading "
+                "a file from an untrusted source (e.g., some random site on the "
+                "internet.)."
+            )
+        path = Path(folder_path)
+        # load index separately since it is not picklable
+        faiss = dependable_faiss_import()
+        index = faiss.read_index(str(path / f"{index_name}.faiss"))
+
+        # load docstore and index_to_docstore_id
+        with open(path / f"{index_name}.pkl", "rb") as f:
+            docstore, index_to_docstore_id = pickle.load(f)
+        return cls(embeddings, index, docstore, index_to_docstore_id, **kwargs)
+
+    def serialize_to_bytes(self) -> bytes:
+        """Serialize FAISS index, docstore, and index_to_docstore_id to bytes."""
+        return pickle.dumps((self.index, self.docstore, self.index_to_docstore_id))
+
+    @classmethod
+    def deserialize_from_bytes(
+        cls,
+        serialized: bytes,
+        embeddings: Embeddings,
+        **kwargs: Any,
+    ) -> FAISS:
+        """Deserialize FAISS index, docstore, and index_to_docstore_id from bytes."""
+        index, docstore, index_to_docstore_id = pickle.loads(serialized)
+        return cls(embeddings, index, docstore, index_to_docstore_id, **kwargs)
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+        """
+        if self.override_relevance_score_fn is not None:
+            return self.override_relevance_score_fn
+
+        # Default strategy is to rely on distance strategy provided in
+        # vectorstore constructor
+        if self.distance_strategy == DistanceStrategy.MAX_INNER_PRODUCT:
+            return self._max_inner_product_relevance_score_fn
+        elif self.distance_strategy == DistanceStrategy.EUCLIDEAN_DISTANCE:
+            # Default behavior is to use euclidean distance relevancy
+            return self._euclidean_relevance_score_fn
+        elif self.distance_strategy == DistanceStrategy.COSINE:
+            return self._cosine_relevance_score_fn
+        else:
+            raise ValueError(
+                "Unknown distance strategy, must be cosine, max_inner_product,"
+                " or euclidean"
+            )
+
+    def _similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs and their similarity scores on a scale from 0 to 1."""
+        # Pop score threshold so that only relevancy scores, not raw scores, are
+        # filtered.
+        relevance_score_fn = self._select_relevance_score_fn()
+        if relevance_score_fn is None:
+            raise ValueError(
+                "normalize_score_fn must be provided to"
+                " FAISS constructor to normalize scores"
+            )
+        docs_and_scores = self.similarity_search_with_score(
+            query,
+            k=k,
+            filter=filter,
+            fetch_k=fetch_k,
+            **kwargs,
+        )
+        docs_and_rel_scores = [
+            (doc, relevance_score_fn(score)) for doc, score in docs_and_scores
+        ]
+        return docs_and_rel_scores
+
+    async def _asimilarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Union[Callable, Dict[str, Any]]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs and their similarity scores on a scale from 0 to 1."""
+        # Pop score threshold so that only relevancy scores, not raw scores, are
+        # filtered.
+        relevance_score_fn = self._select_relevance_score_fn()
+        if relevance_score_fn is None:
+            raise ValueError(
+                "normalize_score_fn must be provided to"
+                " FAISS constructor to normalize scores"
+            )
+        docs_and_scores = await self.asimilarity_search_with_score(
+            query,
+            k=k,
+            filter=filter,
+            fetch_k=fetch_k,
+            **kwargs,
+        )
+        docs_and_rel_scores = [
+            (doc, relevance_score_fn(score)) for doc, score in docs_and_scores
+        ]
+        return docs_and_rel_scores
+
+    @staticmethod
+    def _create_filter_func(
+        filter: Optional[Union[Callable, Dict[str, Any]]],
+    ) -> Callable[[Dict[str, Any]], bool]:
+        """
+        Create a filter function based on the provided filter.
+
+        Args:
+            filter: A callable or a dictionary representing the filter
+            conditions for documents.
+
+        Returns:
+            Callable[[Dict[str, Any]], bool]: A function that takes Document's metadata
+            and returns True if it satisfies the filter conditions, otherwise False.
+        """
+        if callable(filter):
+            return filter
+
+        if not isinstance(filter, dict):
+            raise ValueError(
+                f"filter must be a dict of metadata or a callable, not {type(filter)}"
+            )
+
+        def filter_func(metadata: Dict[str, Any]) -> bool:
+            return all(
+                metadata.get(key) in value
+                if isinstance(value, list)
+                else metadata.get(key) == value
+                for key, value in filter.items()  # type: ignore
+            )
+
+        return filter_func
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/hanavector.py b/llm/Lib/site-packages/langchain_community/vectorstores/hanavector.py
new file mode 100644
index 0000000000000000000000000000000000000000..cc8822c888e20b41b9ff759ab9bb33fc687f051e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/hanavector.py
@@ -0,0 +1,577 @@
+"""SAP HANA Cloud Vector Engine"""
+from __future__ import annotations
+
+import importlib.util
+import json
+import re
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+)
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.runnables.config import run_in_executor
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import (
+    DistanceStrategy,
+    maximal_marginal_relevance,
+)
+
+if TYPE_CHECKING:
+    from hdbcli import dbapi
+
+HANA_DISTANCE_FUNCTION: dict = {
+    DistanceStrategy.COSINE: ("COSINE_SIMILARITY", "DESC"),
+    DistanceStrategy.EUCLIDEAN_DISTANCE: ("L2DISTANCE", "ASC"),
+}
+
+default_distance_strategy = DistanceStrategy.COSINE
+default_table_name: str = "EMBEDDINGS"
+default_content_column: str = "VEC_TEXT"
+default_metadata_column: str = "VEC_META"
+default_vector_column: str = "VEC_VECTOR"
+default_vector_column_length: int = -1  # -1 means dynamic length
+
+
+class HanaDB(VectorStore):
+    """SAP HANA Cloud Vector Engine
+
+    The prerequisite for using this class is the installation of the ``hdbcli``
+    Python package.
+
+    The HanaDB vectorstore can be created by providing an embedding function and
+    an existing database connection. Optionally, the names of the table and the
+    columns to use.
+    """
+
+    def __init__(
+        self,
+        connection: dbapi.Connection,
+        embedding: Embeddings,
+        distance_strategy: DistanceStrategy = default_distance_strategy,
+        table_name: str = default_table_name,
+        content_column: str = default_content_column,
+        metadata_column: str = default_metadata_column,
+        vector_column: str = default_vector_column,
+        vector_column_length: int = default_vector_column_length,
+    ):
+        # Check if the hdbcli package is installed
+        if importlib.util.find_spec("hdbcli") is None:
+            raise ImportError(
+                "Could not import hdbcli python package. "
+                "Please install it with `pip install hdbcli`."
+            )
+
+        valid_distance = False
+        for key in HANA_DISTANCE_FUNCTION.keys():
+            if key is distance_strategy:
+                valid_distance = True
+        if not valid_distance:
+            raise ValueError(
+                "Unsupported distance_strategy: {}".format(distance_strategy)
+            )
+
+        self.connection = connection
+        self.embedding = embedding
+        self.distance_strategy = distance_strategy
+        self.table_name = HanaDB._sanitize_name(table_name)
+        self.content_column = HanaDB._sanitize_name(content_column)
+        self.metadata_column = HanaDB._sanitize_name(metadata_column)
+        self.vector_column = HanaDB._sanitize_name(vector_column)
+        self.vector_column_length = HanaDB._sanitize_int(vector_column_length)
+
+        # Check if the table exists, and eventually create it
+        if not self._table_exists(self.table_name):
+            sql_str = (
+                f'CREATE TABLE "{self.table_name}"('
+                f'"{self.content_column}" NCLOB, '
+                f'"{self.metadata_column}" NCLOB, '
+                f'"{self.vector_column}" REAL_VECTOR '
+            )
+            if self.vector_column_length == -1:
+                sql_str += ");"
+            else:
+                sql_str += f"({self.vector_column_length}));"
+
+            try:
+                cur = self.connection.cursor()
+                cur.execute(sql_str)
+            finally:
+                cur.close()
+
+        # Check if the needed columns exist and have the correct type
+        self._check_column(self.table_name, self.content_column, ["NCLOB", "NVARCHAR"])
+        self._check_column(self.table_name, self.metadata_column, ["NCLOB", "NVARCHAR"])
+        self._check_column(
+            self.table_name,
+            self.vector_column,
+            ["REAL_VECTOR"],
+            self.vector_column_length,
+        )
+
+    def _table_exists(self, table_name) -> bool:  # type: ignore[no-untyped-def]
+        sql_str = (
+            "SELECT COUNT(*) FROM SYS.TABLES WHERE SCHEMA_NAME = CURRENT_SCHEMA"
+            " AND TABLE_NAME = ?"
+        )
+        try:
+            cur = self.connection.cursor()
+            cur.execute(sql_str, (table_name))
+            if cur.has_result_set():
+                rows = cur.fetchall()
+                if rows[0][0] == 1:
+                    return True
+        finally:
+            cur.close()
+        return False
+
+    def _check_column(self, table_name, column_name, column_type, column_length=None):  # type: ignore[no-untyped-def]
+        sql_str = (
+            "SELECT DATA_TYPE_NAME, LENGTH FROM SYS.TABLE_COLUMNS WHERE "
+            "SCHEMA_NAME = CURRENT_SCHEMA "
+            "AND TABLE_NAME = ? AND COLUMN_NAME = ?"
+        )
+        try:
+            cur = self.connection.cursor()
+            cur.execute(sql_str, (table_name, column_name))
+            if cur.has_result_set():
+                rows = cur.fetchall()
+                if len(rows) == 0:
+                    raise AttributeError(f"Column {column_name} does not exist")
+                # Check data type
+                if rows[0][0] not in column_type:
+                    raise AttributeError(
+                        f"Column {column_name} has the wrong type: {rows[0][0]}"
+                    )
+                # Check length, if parameter was provided
+                if column_length is not None:
+                    if rows[0][1] != column_length:
+                        raise AttributeError(
+                            f"Column {column_name} has the wrong length: {rows[0][1]}"
+                        )
+            else:
+                raise AttributeError(f"Column {column_name} does not exist")
+        finally:
+            cur.close()
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding
+
+    def _sanitize_name(input_str: str) -> str:  # type: ignore[misc]
+        # Remove characters that are not alphanumeric or underscores
+        return re.sub(r"[^a-zA-Z0-9_]", "", input_str)
+
+    def _sanitize_int(input_int: any) -> int:  # type: ignore[valid-type]
+        value = int(str(input_int))
+        if value < -1:
+            raise ValueError(f"Value ({value}) must not be smaller than -1")
+        return int(str(input_int))
+
+    def _sanitize_list_float(embedding: List[float]) -> List[float]:  # type: ignore[misc]
+        for value in embedding:
+            if not isinstance(value, float):
+                raise ValueError(f"Value ({value}) does not have type float")
+        return embedding
+
+    # Compile pattern only once, for better performance
+    _compiled_pattern = re.compile("^[_a-zA-Z][_a-zA-Z0-9]*$")
+
+    def _sanitize_metadata_keys(metadata: dict) -> dict:  # type: ignore[misc]
+        for key in metadata.keys():
+            if not HanaDB._compiled_pattern.match(key):
+                raise ValueError(f"Invalid metadata key {key}")
+
+        return metadata
+
+    def add_texts(  # type: ignore[override]
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        embeddings: Optional[List[List[float]]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add more texts to the vectorstore.
+
+        Args:
+            texts (Iterable[str]): Iterable of strings/text to add to the vectorstore.
+            metadatas (Optional[List[dict]], optional): Optional list of metadatas.
+                Defaults to None.
+            embeddings (Optional[List[List[float]]], optional): Optional pre-generated
+                embeddings. Defaults to None.
+
+        Returns:
+            List[str]: empty list
+        """
+        # Create all embeddings of the texts beforehand to improve performance
+        if embeddings is None:
+            embeddings = self.embedding.embed_documents(list(texts))
+
+        cur = self.connection.cursor()
+        try:
+            # Insert data into the table
+            for i, text in enumerate(texts):
+                # Use provided values by default or fallback
+                metadata = metadatas[i] if metadatas else {}
+                embedding = (
+                    embeddings[i]
+                    if embeddings
+                    else self.embedding.embed_documents([text])[0]
+                )
+                sql_str = (
+                    f'INSERT INTO "{self.table_name}" ("{self.content_column}", '
+                    f'"{self.metadata_column}", "{self.vector_column}") '
+                    f"VALUES (?, ?, TO_REAL_VECTOR (?));"
+                )
+                cur.execute(
+                    sql_str,
+                    (
+                        text,
+                        json.dumps(HanaDB._sanitize_metadata_keys(metadata)),
+                        f"[{','.join(map(str, embedding))}]",
+                    ),
+                )
+        finally:
+            cur.close()
+        return []
+
+    @classmethod
+    def from_texts(  # type: ignore[no-untyped-def, override]
+        cls: Type[HanaDB],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        connection: dbapi.Connection = None,
+        distance_strategy: DistanceStrategy = default_distance_strategy,
+        table_name: str = default_table_name,
+        content_column: str = default_content_column,
+        metadata_column: str = default_metadata_column,
+        vector_column: str = default_vector_column,
+        vector_column_length: int = default_vector_column_length,
+    ):
+        """Create a HanaDB instance from raw documents.
+        This is a user-friendly interface that:
+            1. Embeds documents.
+            2. Creates a table if it does not yet exist.
+            3. Adds the documents to the table.
+        This is intended to be a quick way to get started.
+        """
+
+        instance = cls(
+            connection=connection,
+            embedding=embedding,
+            distance_strategy=distance_strategy,
+            table_name=table_name,
+            content_column=content_column,
+            metadata_column=metadata_column,
+            vector_column=vector_column,
+            vector_column_length=vector_column_length,  # -1 means dynamic length
+        )
+        instance.add_texts(texts, metadatas)
+        return instance
+
+    def similarity_search(  # type: ignore[override]
+        self, query: str, k: int = 4, filter: Optional[dict] = None
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: A dictionary of metadata fields and values to filter by.
+                    Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query=query, k=k, filter=filter
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, filter: Optional[dict] = None
+    ) -> List[Tuple[Document, float]]:
+        """Return documents and score values most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: A dictionary of metadata fields and values to filter by.
+                    Defaults to None.
+
+        Returns:
+            List of tuples (containing a Document and a score) that are
+            most similar to the query
+        """
+        embedding = self.embedding.embed_query(query)
+        return self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+
+    def similarity_search_with_score_and_vector_by_vector(
+        self, embedding: List[float], k: int = 4, filter: Optional[dict] = None
+    ) -> List[Tuple[Document, float, List[float]]]:
+        """Return docs most similar to the given embedding.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: A dictionary of metadata fields and values to filter by.
+                    Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query and
+            score and the document's embedding vector for each
+        """
+        result = []
+        k = HanaDB._sanitize_int(k)
+        embedding = HanaDB._sanitize_list_float(embedding)
+        distance_func_name = HANA_DISTANCE_FUNCTION[self.distance_strategy][0]
+        embedding_as_str = ",".join(map(str, embedding))
+        sql_str = (
+            f"SELECT TOP {k}"
+            f'  "{self.content_column}", '  # row[0]
+            f'  "{self.metadata_column}", '  # row[1]
+            f'  TO_NVARCHAR("{self.vector_column}"), '  # row[2]
+            f'  {distance_func_name}("{self.vector_column}", TO_REAL_VECTOR '
+            f"     (ARRAY({embedding_as_str}))) AS CS "  # row[3]
+            f'FROM "{self.table_name}"'
+        )
+        order_str = f" order by CS {HANA_DISTANCE_FUNCTION[self.distance_strategy][1]}"
+        where_str, query_tuple = self._create_where_by_filter(filter)
+        sql_str = sql_str + where_str
+        sql_str = sql_str + order_str
+        try:
+            cur = self.connection.cursor()
+            cur.execute(sql_str, query_tuple)
+            if cur.has_result_set():
+                rows = cur.fetchall()
+                for row in rows:
+                    js = json.loads(row[1])
+                    doc = Document(page_content=row[0], metadata=js)
+                    result_vector = HanaDB._parse_float_array_from_string(row[2])
+                    result.append((doc, row[3], result_vector))
+        finally:
+            cur.close()
+        return result
+
+    def similarity_search_with_score_by_vector(
+        self, embedding: List[float], k: int = 4, filter: Optional[dict] = None
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to the given embedding.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: A dictionary of metadata fields and values to filter by.
+                    Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        whole_result = self.similarity_search_with_score_and_vector_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return [(result_item[0], result_item[1]) for result_item in whole_result]
+
+    def similarity_search_by_vector(  # type: ignore[override]
+        self, embedding: List[float], k: int = 4, filter: Optional[dict] = None
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: A dictionary of metadata fields and values to filter by.
+                    Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def _create_where_by_filter(self, filter):  # type: ignore[no-untyped-def]
+        query_tuple = []
+        where_str = ""
+        if filter:
+            for i, key in enumerate(filter.keys()):
+                if i == 0:
+                    where_str += " WHERE "
+                else:
+                    where_str += " AND "
+
+                where_str += f" JSON_VALUE({self.metadata_column}, '$.{key}') = ?"
+
+                if isinstance(filter[key], bool):
+                    if filter[key]:
+                        query_tuple.append("true")
+                    else:
+                        query_tuple.append("false")
+                elif isinstance(filter[key], int) or isinstance(filter[key], str):
+                    query_tuple.append(filter[key])
+                else:
+                    raise ValueError(
+                        f"Unsupported filter data-type: {type(filter[key])}"
+                    )
+
+        return where_str, query_tuple
+
+    def delete(  # type: ignore[override]
+        self, ids: Optional[List[str]] = None, filter: Optional[dict] = None
+    ) -> Optional[bool]:
+        """Delete entries by filter with metadata values
+
+        Args:
+            ids: Deletion with ids is not supported! A ValueError will be raised.
+            filter: A dictionary of metadata fields and values to filter by.
+                    An empty filter ({}) will delete all entries in the table.
+
+        Returns:
+            Optional[bool]: True, if deletion is technically successful.
+            Deletion of zero entries, due to non-matching filters is a success.
+        """
+
+        if ids is not None:
+            raise ValueError("Deletion via ids is not supported")
+
+        if filter is None:
+            raise ValueError("Parameter 'filter' is required when calling 'delete'")
+
+        where_str, query_tuple = self._create_where_by_filter(filter)
+        sql_str = f'DELETE FROM "{self.table_name}" {where_str}'
+
+        try:
+            cur = self.connection.cursor()
+            cur.execute(sql_str, query_tuple)
+        finally:
+            cur.close()
+
+        return True
+
+    async def adelete(  # type: ignore[override]
+        self, ids: Optional[List[str]] = None, filter: Optional[dict] = None
+    ) -> Optional[bool]:
+        """Delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+        return await run_in_executor(None, self.delete, ids=ids, filter=filter)
+
+    def max_marginal_relevance_search(  # type: ignore[override]
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[dict] = None,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: search query text.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter: Filter on metadata properties, e.g.
+                            {
+                                "str_property": "foo",
+                                "int_property": 123
+                            }
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        embedding = self.embedding.embed_query(query)
+        return self.max_marginal_relevance_search_by_vector(
+            embedding=embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+        )
+
+    def _parse_float_array_from_string(array_as_string: str) -> List[float]:  # type: ignore[misc]
+        array_wo_brackets = array_as_string[1:-1]
+        return [float(x) for x in array_wo_brackets.split(",")]
+
+    def max_marginal_relevance_search_by_vector(  # type: ignore[override]
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[dict] = None,
+    ) -> List[Document]:
+        whole_result = self.similarity_search_with_score_and_vector_by_vector(
+            embedding=embedding, k=fetch_k, filter=filter
+        )
+        embeddings = [result_item[2] for result_item in whole_result]
+        mmr_doc_indexes = maximal_marginal_relevance(
+            np.array(embedding), embeddings, lambda_mult=lambda_mult, k=k
+        )
+
+        return [whole_result[i][0] for i in mmr_doc_indexes]
+
+    async def amax_marginal_relevance_search_by_vector(  # type: ignore[override]
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance."""
+        return await run_in_executor(
+            None,
+            self.max_marginal_relevance_search_by_vector,
+            embedding=embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+        )
+
+    @staticmethod
+    def _cosine_relevance_score_fn(distance: float) -> float:
+        return distance
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+
+        Vectorstores should define their own selection based method of relevance.
+        """
+        if self.distance_strategy == DistanceStrategy.COSINE:
+            return HanaDB._cosine_relevance_score_fn
+        elif self.distance_strategy == DistanceStrategy.EUCLIDEAN_DISTANCE:
+            return HanaDB._euclidean_relevance_score_fn
+        else:
+            raise ValueError(
+                "Unsupported distance_strategy: {}".format(self.distance_strategy)
+            )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/hippo.py b/llm/Lib/site-packages/langchain_community/vectorstores/hippo.py
new file mode 100644
index 0000000000000000000000000000000000000000..328a2f1e992266d433eeaab71ea1492dd6e38e90
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/hippo.py
@@ -0,0 +1,677 @@
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Optional, Tuple
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    from transwarp_hippo_api.hippo_client import HippoClient
+
+# Default connection
+DEFAULT_HIPPO_CONNECTION = {
+    "host": "localhost",
+    "port": "7788",
+    "username": "admin",
+    "password": "admin",
+}
+
+logger = logging.getLogger(__name__)
+
+
+class Hippo(VectorStore):
+    """`Hippo` vector store.
+
+    You need to install `hippo-api` and run Hippo.
+
+    Please visit our official website for how to run a Hippo instance:
+    https://www.transwarp.cn/starwarp
+
+    Args:
+        embedding_function (Embeddings): Function used to embed the text.
+        table_name (str): Which Hippo table to use. Defaults to
+            "test".
+        database_name (str): Which Hippo database to use. Defaults to
+            "default".
+        number_of_shards (int): The number of shards for the Hippo table.Defaults to
+            1.
+        number_of_replicas (int): The number of replicas for the Hippo table.Defaults to
+            1.
+        connection_args (Optional[dict[str, any]]): The connection args used for
+            this class comes in the form of a dict.
+        index_params (Optional[dict]): Which index params to use. Defaults to
+            IVF_FLAT.
+        drop_old (Optional[bool]): Whether to drop the current collection. Defaults
+            to False.
+        primary_field (str): Name of the primary key field. Defaults to "pk".
+        text_field (str): Name of the text field. Defaults to "text".
+        vector_field (str): Name of the vector field. Defaults to "vector".
+
+    The connection args used for this class comes in the form of a dict,
+    here are a few of the options:
+        host (str): The host of Hippo instance. Default at "localhost".
+        port (str/int): The port of Hippo instance. Default at 7788.
+        user (str): Use which user to connect to Hippo instance. If user and
+            password are provided, we will add related header in every RPC call.
+        password (str): Required when user is provided. The password
+            corresponding to the user.
+
+    Example:
+        .. code-block:: python
+
+        from langchain_community.vectorstores import Hippo
+        from langchain_community.embeddings import OpenAIEmbeddings
+
+        embedding = OpenAIEmbeddings()
+        # Connect to a hippo instance on localhost
+        vector_store = Hippo.from_documents(
+            docs,
+            embedding=embeddings,
+            table_name="langchain_test",
+            connection_args=HIPPO_CONNECTION
+        )
+
+    Raises:
+        ValueError: If the hippo-api python package is not installed.
+    """
+
+    def __init__(
+        self,
+        embedding_function: Embeddings,
+        table_name: str = "test",
+        database_name: str = "default",
+        number_of_shards: int = 1,
+        number_of_replicas: int = 1,
+        connection_args: Optional[Dict[str, Any]] = None,
+        index_params: Optional[dict] = None,
+        drop_old: Optional[bool] = False,
+    ):
+        self.number_of_shards = number_of_shards
+        self.number_of_replicas = number_of_replicas
+        self.embedding_func = embedding_function
+        self.table_name = table_name
+        self.database_name = database_name
+        self.index_params = index_params
+
+        # In order for a collection to be compatible,
+        # 'pk' should be an auto-increment primary key and string
+        self._primary_field = "pk"
+        # In order for compatibility, the text field will need to be called "text"
+        self._text_field = "text"
+        # In order for compatibility, the vector field needs to be called "vector"
+        self._vector_field = "vector"
+        self.fields: List[str] = []
+        # Create the connection to the server
+        if connection_args is None:
+            connection_args = DEFAULT_HIPPO_CONNECTION
+        self.hc = self._create_connection_alias(connection_args)
+        self.col: Any = None
+
+        # If the collection exists, delete it
+        try:
+            if (
+                self.hc.check_table_exists(self.table_name, self.database_name)
+                and drop_old
+            ):
+                self.hc.delete_table(self.table_name, self.database_name)
+        except Exception as e:
+            logging.error(
+                f"An error occurred while deleting the table " f"{self.table_name}: {e}"
+            )
+            raise
+
+        try:
+            if self.hc.check_table_exists(self.table_name, self.database_name):
+                self.col = self.hc.get_table(self.table_name, self.database_name)
+        except Exception as e:
+            logging.error(
+                f"An error occurred while getting the table " f"{self.table_name}: {e}"
+            )
+            raise
+
+        # Initialize the vector database
+        self._get_env()
+
+    def _create_connection_alias(self, connection_args: dict) -> HippoClient:
+        """Create the connection to the Hippo server."""
+        # Grab the connection arguments that are used for checking existing connection
+        try:
+            from transwarp_hippo_api.hippo_client import HippoClient
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import transwarp_hipp_api, please install with "
+                "`pip install hippo-api`."
+            ) from e
+
+        host: str = connection_args.get("host", None)
+        port: int = connection_args.get("port", None)
+        username: str = connection_args.get("username", "shiva")
+        password: str = connection_args.get("password", "shiva")
+
+        # Order of use is host/port, uri, address
+        if host is not None and port is not None:
+            if "," in host:
+                hosts = host.split(",")
+                given_address = ",".join([f"{h}:{port}" for h in hosts])
+            else:
+                given_address = str(host) + ":" + str(port)
+        else:
+            raise ValueError("Missing standard address type for reuse attempt")
+
+        try:
+            logger.info(f"create HippoClient[{given_address}]")
+            return HippoClient([given_address], username=username, pwd=password)
+        except Exception as e:
+            logger.error("Failed to create new connection")
+            raise e
+
+    def _get_env(
+        self, embeddings: Optional[list] = None, metadatas: Optional[List[dict]] = None
+    ) -> None:
+        logger.info("init ...")
+        if embeddings is not None:
+            logger.info("create collection")
+            self._create_collection(embeddings, metadatas)
+        self._extract_fields()
+        self._create_index()
+
+    def _create_collection(
+        self, embeddings: list, metadatas: Optional[List[dict]] = None
+    ) -> None:
+        from transwarp_hippo_api.hippo_client import HippoField
+        from transwarp_hippo_api.hippo_type import HippoType
+
+        # Determine embedding dim
+        dim = len(embeddings[0])
+        logger.debug(f"[_create_collection] dim: {dim}")
+        fields = []
+
+        # Create the primary key field
+        fields.append(HippoField(self._primary_field, True, HippoType.STRING))
+
+        # Create the text field
+
+        fields.append(HippoField(self._text_field, False, HippoType.STRING))
+
+        # Create the vector field, supports binary or float vectors
+        # to The binary vector type is to be developed.
+        fields.append(
+            HippoField(
+                self._vector_field,
+                False,
+                HippoType.FLOAT_VECTOR,
+                type_params={"dimension": dim},
+            )
+        )
+        # to In Hippo,there is no method similar to the infer_type_data
+        # types, so currently all non-vector data is converted to string type.
+
+        if metadatas:
+            #     # Create FieldSchema for each entry in metadata.
+            for key, value in metadatas[0].items():
+                #         # Infer the corresponding datatype of the metadata
+                if isinstance(value, list):
+                    value_dim = len(value)
+                    fields.append(
+                        HippoField(
+                            key,
+                            False,
+                            HippoType.FLOAT_VECTOR,
+                            type_params={"dimension": value_dim},
+                        )
+                    )
+                else:
+                    fields.append(HippoField(key, False, HippoType.STRING))
+
+        logger.debug(f"[_create_collection] fields: {fields}")
+
+        # Create the collection
+        self.hc.create_table(
+            name=self.table_name,
+            auto_id=True,
+            fields=fields,
+            database_name=self.database_name,
+            number_of_shards=self.number_of_shards,
+            number_of_replicas=self.number_of_replicas,
+        )
+        self.col = self.hc.get_table(self.table_name, self.database_name)
+        logger.info(
+            f"[_create_collection] : "
+            f"create table {self.table_name} in {self.database_name} successfully"
+        )
+
+    def _extract_fields(self) -> None:
+        """Grab the existing fields from the Collection"""
+        from transwarp_hippo_api.hippo_client import HippoTable
+
+        if isinstance(self.col, HippoTable):
+            schema = self.col.schema
+            logger.debug(f"[_extract_fields] schema:{schema}")
+            for x in schema:
+                self.fields.append(x.name)
+            logger.debug(f"04 [_extract_fields] fields:{self.fields}")
+
+    # TO CAN: Translated into English, your statement would be: "Currently,
+    # only the field named 'vector' (the automatically created vector field)
+    # is checked for indexing. Indexes need to be created manually for other
+    # vector type columns.
+    def _get_index(self) -> Optional[Dict[str, Any]]:
+        """Return the vector index information if it exists"""
+        from transwarp_hippo_api.hippo_client import HippoTable
+
+        if isinstance(self.col, HippoTable):
+            table_info = self.hc.get_table_info(
+                self.table_name, self.database_name
+            ).get(self.table_name, {})
+            embedding_indexes = table_info.get("embedding_indexes", None)
+            if embedding_indexes is None:
+                return None
+            else:
+                for x in self.hc.get_table_info(self.table_name, self.database_name)[
+                    self.table_name
+                ]["embedding_indexes"]:
+                    logger.debug(f"[_get_index] embedding_indexes {embedding_indexes}")
+                    if x["column"] == self._vector_field:
+                        return x
+        return None
+
+    # TO Indexes can only be created for the self._vector_field field.
+    def _create_index(self) -> None:
+        """Create a index on the collection"""
+        from transwarp_hippo_api.hippo_client import HippoTable
+        from transwarp_hippo_api.hippo_type import IndexType, MetricType
+
+        if isinstance(self.col, HippoTable) and self._get_index() is None:
+            if self._get_index() is None:
+                if self.index_params is None:
+                    self.index_params = {
+                        "index_name": "langchain_auto_create",
+                        "metric_type": MetricType.L2,
+                        "index_type": IndexType.IVF_FLAT,
+                        "nlist": 10,
+                    }
+
+                    self.col.create_index(
+                        self._vector_field,
+                        self.index_params["index_name"],
+                        self.index_params["index_type"],
+                        self.index_params["metric_type"],
+                        nlist=self.index_params["nlist"],
+                    )
+                    logger.debug(
+                        self.col.activate_index(self.index_params["index_name"])
+                    )
+                    logger.info("create index successfully")
+                else:
+                    index_dict = {
+                        "IVF_FLAT": IndexType.IVF_FLAT,
+                        "FLAT": IndexType.FLAT,
+                        "IVF_SQ": IndexType.IVF_SQ,
+                        "IVF_PQ": IndexType.IVF_PQ,
+                        "HNSW": IndexType.HNSW,
+                    }
+
+                    metric_dict = {
+                        "ip": MetricType.IP,
+                        "IP": MetricType.IP,
+                        "l2": MetricType.L2,
+                        "L2": MetricType.L2,
+                    }
+                    self.index_params["metric_type"] = metric_dict[
+                        self.index_params["metric_type"]
+                    ]
+
+                    if self.index_params["index_type"] == "FLAT":
+                        self.index_params["index_type"] = index_dict[
+                            self.index_params["index_type"]
+                        ]
+                        self.col.create_index(
+                            self._vector_field,
+                            self.index_params["index_name"],
+                            self.index_params["index_type"],
+                            self.index_params["metric_type"],
+                        )
+                        logger.debug(
+                            self.col.activate_index(self.index_params["index_name"])
+                        )
+                    elif (
+                        self.index_params["index_type"] == "IVF_FLAT"
+                        or self.index_params["index_type"] == "IVF_SQ"
+                    ):
+                        self.index_params["index_type"] = index_dict[
+                            self.index_params["index_type"]
+                        ]
+                        self.col.create_index(
+                            self._vector_field,
+                            self.index_params["index_name"],
+                            self.index_params["index_type"],
+                            self.index_params["metric_type"],
+                            nlist=self.index_params.get("nlist", 10),
+                            nprobe=self.index_params.get("nprobe", 10),
+                        )
+                        logger.debug(
+                            self.col.activate_index(self.index_params["index_name"])
+                        )
+                    elif self.index_params["index_type"] == "IVF_PQ":
+                        self.index_params["index_type"] = index_dict[
+                            self.index_params["index_type"]
+                        ]
+                        self.col.create_index(
+                            self._vector_field,
+                            self.index_params["index_name"],
+                            self.index_params["index_type"],
+                            self.index_params["metric_type"],
+                            nlist=self.index_params.get("nlist", 10),
+                            nprobe=self.index_params.get("nprobe", 10),
+                            nbits=self.index_params.get("nbits", 8),
+                            m=self.index_params.get("m"),
+                        )
+                        logger.debug(
+                            self.col.activate_index(self.index_params["index_name"])
+                        )
+                    elif self.index_params["index_type"] == "HNSW":
+                        self.index_params["index_type"] = index_dict[
+                            self.index_params["index_type"]
+                        ]
+                        self.col.create_index(
+                            self._vector_field,
+                            self.index_params["index_name"],
+                            self.index_params["index_type"],
+                            self.index_params["metric_type"],
+                            M=self.index_params.get("M"),
+                            ef_construction=self.index_params.get("ef_construction"),
+                            ef_search=self.index_params.get("ef_search"),
+                        )
+                        logger.debug(
+                            self.col.activate_index(self.index_params["index_name"])
+                        )
+                    else:
+                        raise ValueError(
+                            "Index name does not match, "
+                            "please enter the correct index name. "
+                            "(FLAT, IVF_FLAT, IVF_PQ,IVF_SQ, HNSW)"
+                        )
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        timeout: Optional[int] = None,
+        batch_size: int = 1000,
+        **kwargs: Any,
+    ) -> List[str]:
+        """
+        Add text to the collection.
+
+        Args:
+            texts: An iterable that contains the text to be added.
+            metadatas: An optional list of dictionaries,
+            each dictionary contains the metadata associated with a text.
+            timeout: Optional timeout, in seconds.
+            batch_size: The number of texts inserted in each batch, defaults to 1000.
+            **kwargs: Other optional parameters.
+
+        Returns:
+            A list of strings, containing the unique identifiers of the inserted texts.
+
+        Note:
+            If the collection has not yet been created,
+            this method will create a new collection.
+        """
+        from transwarp_hippo_api.hippo_client import HippoTable
+
+        if not texts or all(t == "" for t in texts):
+            logger.debug("Nothing to insert, skipping.")
+            return []
+        texts = list(texts)
+
+        logger.debug(f"[add_texts] texts: {texts}")
+
+        try:
+            embeddings = self.embedding_func.embed_documents(texts)
+        except NotImplementedError:
+            embeddings = [self.embedding_func.embed_query(x) for x in texts]
+
+        if len(embeddings) == 0:
+            logger.debug("Nothing to insert, skipping.")
+            return []
+
+        logger.debug(f"[add_texts] len_embeddings:{len(embeddings)}")
+
+        # 如果还没有创建collection则创建collection
+        if not isinstance(self.col, HippoTable):
+            self._get_env(embeddings, metadatas)
+
+        # Dict to hold all insert columns
+        insert_dict: Dict[str, list] = {
+            self._text_field: texts,
+            self._vector_field: embeddings,
+        }
+        logger.debug(f"[add_texts] metadatas:{metadatas}")
+        logger.debug(f"[add_texts] fields:{self.fields}")
+        if metadatas is not None:
+            for d in metadatas:
+                for key, value in d.items():
+                    if key in self.fields:
+                        insert_dict.setdefault(key, []).append(value)
+
+        logger.debug(insert_dict[self._text_field])
+
+        # Total insert count
+        vectors: list = insert_dict[self._vector_field]
+        total_count = len(vectors)
+
+        if "pk" in self.fields:
+            self.fields.remove("pk")
+
+        logger.debug(f"[add_texts] total_count:{total_count}")
+        for i in range(0, total_count, batch_size):
+            # Grab end index
+            end = min(i + batch_size, total_count)
+            # Convert dict to list of lists batch for insertion
+            insert_list = [insert_dict[x][i:end] for x in self.fields]
+            try:
+                res = self.col.insert_rows(insert_list)
+                logger.info(f"05 [add_texts] insert {res}")
+            except Exception as e:
+                logger.error(
+                    "Failed to insert batch starting at entity: %s/%s", i, total_count
+                )
+                raise e
+        return [""]
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """
+        Perform a similarity search on the query string.
+
+        Args:
+            query (str): The text to search for.
+            k (int, optional): The number of results to return. Default is 4.
+            param (dict, optional): Specifies the search parameters for the index.
+            Defaults to None.
+            expr (str, optional): Filtering expression. Defaults to None.
+            timeout (int, optional): Time to wait before a timeout error.
+            Defaults to None.
+            kwargs: Keyword arguments for Collection.search().
+
+        Returns:
+            List[Document]: The document results of the search.
+        """
+
+        if self.col is None:
+            logger.debug("No existing collection to search.")
+            return []
+        res = self.similarity_search_with_score(
+            query=query, k=k, param=param, expr=expr, timeout=timeout, **kwargs
+        )
+        return [doc for doc, _ in res]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """
+        Performs a search on the query string and returns results with scores.
+
+        Args:
+            query (str): The text being searched.
+            k (int, optional): The number of results to return.
+            Default is 4.
+            param (dict): Specifies the search parameters for the index.
+            Default is None.
+            expr (str, optional): Filtering expression. Default is None.
+            timeout (int, optional): The waiting time before a timeout error.
+            Default is None.
+            kwargs: Keyword arguments for Collection.search().
+
+        Returns:
+            List[float], List[Tuple[Document, any, any]]:
+        """
+
+        if self.col is None:
+            logger.debug("No existing collection to search.")
+            return []
+
+        # Embed the query text.
+        embedding = self.embedding_func.embed_query(query)
+
+        ret = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, param=param, expr=expr, timeout=timeout, **kwargs
+        )
+        return ret
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """
+        Performs a search on the query string and returns results with scores.
+
+        Args:
+            embedding (List[float]): The embedding vector being searched.
+            k (int, optional): The number of results to return.
+            Default is 4.
+            param (dict): Specifies the search parameters for the index.
+            Default is None.
+            expr (str, optional): Filtering expression. Default is None.
+            timeout (int, optional): The waiting time before a timeout error.
+            Default is None.
+            kwargs: Keyword arguments for Collection.search().
+
+        Returns:
+            List[Tuple[Document, float]]: Resulting documents and scores.
+        """
+        if self.col is None:
+            logger.debug("No existing collection to search.")
+            return []
+
+        # if param is None:
+        #     param = self.search_params
+
+        # Determine result metadata fields.
+        output_fields = self.fields[:]
+        output_fields.remove(self._vector_field)
+
+        # Perform the search.
+        logger.debug(f"search_field:{self._vector_field}")
+        logger.debug(f"vectors:{[embedding]}")
+        logger.debug(f"output_fields:{output_fields}")
+        logger.debug(f"topk:{k}")
+        logger.debug(f"dsl:{expr}")
+
+        res = self.col.query(
+            search_field=self._vector_field,
+            vectors=[embedding],
+            output_fields=output_fields,
+            topk=k,
+            dsl=expr,
+        )
+        # Organize results.
+        logger.debug(f"[similarity_search_with_score_by_vector] res:{res}")
+        score_col = self._text_field + "%scores"
+        ret = []
+        count = 0
+        for items in zip(*[res[0][field] for field in output_fields]):
+            meta = {field: value for field, value in zip(output_fields, items)}
+            doc = Document(page_content=meta.pop(self._text_field), metadata=meta)
+            logger.debug(
+                f"[similarity_search_with_score_by_vector] "
+                f"res[0][score_col]:{res[0][score_col]}"
+            )
+            score = res[0][score_col][count]
+            count += 1
+            ret.append((doc, score))
+
+        return ret
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        table_name: str = "test",
+        database_name: str = "default",
+        connection_args: Dict[str, Any] = DEFAULT_HIPPO_CONNECTION,
+        index_params: Optional[Dict[Any, Any]] = None,
+        search_params: Optional[Dict[str, Any]] = None,
+        drop_old: bool = False,
+        **kwargs: Any,
+    ) -> "Hippo":
+        """
+        Creates an instance of the VST class from the given texts.
+
+        Args:
+            texts (List[str]): List of texts to be added.
+            embedding (Embeddings): Embedding model for the texts.
+            metadatas (List[dict], optional):
+            List of metadata dictionaries for each text.Defaults to None.
+            table_name (str): Name of the table. Defaults to "test".
+            database_name (str): Name of the database. Defaults to "default".
+            connection_args (dict[str, Any]): Connection parameters.
+            Defaults to DEFAULT_HIPPO_CONNECTION.
+            index_params (dict): Indexing parameters. Defaults to None.
+            search_params (dict): Search parameters. Defaults to an empty dictionary.
+            drop_old (bool): Whether to drop the old collection. Defaults to False.
+            kwargs: Other arguments.
+
+        Returns:
+            Hippo: An instance of the VST class.
+        """
+
+        if search_params is None:
+            search_params = {}
+        logger.info("00 [from_texts] init the class of Hippo")
+        vector_db = cls(
+            embedding_function=embedding,
+            table_name=table_name,
+            database_name=database_name,
+            connection_args=connection_args,
+            index_params=index_params,
+            drop_old=drop_old,
+            **kwargs,
+        )
+        logger.debug(f"[from_texts] texts:{texts}")
+        logger.debug(f"[from_texts] metadatas:{metadatas}")
+        vector_db.add_texts(texts=texts, metadatas=metadatas)
+        return vector_db
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/hologres.py b/llm/Lib/site-packages/langchain_community/vectorstores/hologres.py
new file mode 100644
index 0000000000000000000000000000000000000000..84486dffd156fee072e56356345c470d13d18d13
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/hologres.py
@@ -0,0 +1,421 @@
+from __future__ import annotations
+
+import logging
+import uuid
+from typing import Any, Dict, Iterable, List, Optional, Tuple, Type
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_dict_or_env
+from langchain_core.vectorstores import VectorStore
+
+ADA_TOKEN_COUNT = 1536
+_LANGCHAIN_DEFAULT_TABLE_NAME = "langchain_pg_embedding"
+
+
+class Hologres(VectorStore):
+    """`Hologres API` vector store.
+
+    - `connection_string` is a hologres connection string.
+    - `embedding_function` any embedding function implementing
+        `langchain.embeddings.base.Embeddings` interface.
+    - `ndims` is the number of dimensions of the embedding output.
+    - `table_name` is the name of the table to store embeddings and data.
+        (default: langchain_pg_embedding)
+        - NOTE: The table will be created when initializing the store (if not exists)
+            So, make sure the user has the right permissions to create tables.
+    - `pre_delete_table` if True, will delete the table if it exists.
+        (default: False)
+        - Useful for testing.
+    """
+
+    def __init__(
+        self,
+        connection_string: str,
+        embedding_function: Embeddings,
+        ndims: int = ADA_TOKEN_COUNT,
+        table_name: str = _LANGCHAIN_DEFAULT_TABLE_NAME,
+        pre_delete_table: bool = False,
+        logger: Optional[logging.Logger] = None,
+    ) -> None:
+        self.connection_string = connection_string
+        self.ndims = ndims
+        self.table_name = table_name
+        self.embedding_function = embedding_function
+        self.pre_delete_table = pre_delete_table
+        self.logger = logger or logging.getLogger(__name__)
+        self.__post_init__()
+
+    def __post_init__(
+        self,
+    ) -> None:
+        """
+        Initialize the store.
+        """
+        from hologres_vector import HologresVector
+
+        self.storage = HologresVector(
+            self.connection_string,
+            ndims=self.ndims,
+            table_name=self.table_name,
+            table_schema={"document": "text"},
+            pre_delete_table=self.pre_delete_table,
+        )
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding_function
+
+    @classmethod
+    def __from(
+        cls,
+        texts: List[str],
+        embeddings: List[List[float]],
+        embedding_function: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        ndims: int = ADA_TOKEN_COUNT,
+        table_name: str = _LANGCHAIN_DEFAULT_TABLE_NAME,
+        pre_delete_table: bool = False,
+        **kwargs: Any,
+    ) -> Hologres:
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        connection_string = cls.get_connection_string(kwargs)
+
+        store = cls(
+            connection_string=connection_string,
+            embedding_function=embedding_function,
+            ndims=ndims,
+            table_name=table_name,
+            pre_delete_table=pre_delete_table,
+        )
+
+        store.add_embeddings(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+        return store
+
+    def add_embeddings(
+        self,
+        texts: Iterable[str],
+        embeddings: List[List[float]],
+        metadatas: List[dict],
+        ids: List[str],
+        **kwargs: Any,
+    ) -> None:
+        """Add embeddings to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            embeddings: List of list of embedding vectors.
+            metadatas: List of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+        """
+        try:
+            schema_datas = [{"document": t} for t in texts]
+            self.storage.upsert_vectors(embeddings, ids, metadatas, schema_datas)
+        except Exception as e:
+            self.logger.exception(e)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        embeddings = self.embedding_function.embed_documents(list(texts))
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        self.add_embeddings(texts, embeddings, metadatas, ids, **kwargs)
+
+        return ids
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search with Hologres with distance.
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        embedding = self.embedding_function.embed_query(text=query)
+        return self.similarity_search_by_vector(
+            embedding=embedding,
+            k=k,
+            filter=filter,
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        embedding = self.embedding_function.embed_query(query)
+        docs = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return docs
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[dict] = None,
+    ) -> List[Tuple[Document, float]]:
+        results: List[dict[str, Any]] = self.storage.search(
+            embedding, k=k, select_columns=["document"], metadata_filters=filter
+        )
+
+        docs = [
+            (
+                Document(
+                    page_content=result["document"],
+                    metadata=result["metadata"],
+                ),
+                result["distance"],
+            )
+            for result in results
+        ]
+        return docs
+
+    @classmethod
+    def from_texts(
+        cls: Type[Hologres],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ndims: int = ADA_TOKEN_COUNT,
+        table_name: str = _LANGCHAIN_DEFAULT_TABLE_NAME,
+        ids: Optional[List[str]] = None,
+        pre_delete_table: bool = False,
+        **kwargs: Any,
+    ) -> Hologres:
+        """
+        Return VectorStore initialized from texts and embeddings.
+        Hologres connection string is required
+        "Either pass it as a parameter
+        or set the HOLOGRES_CONNECTION_STRING environment variable.
+        Create the connection string by calling
+        HologresVector.connection_string_from_db_params
+        """
+        embeddings = embedding.embed_documents(list(texts))
+
+        return cls.__from(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            ndims=ndims,
+            table_name=table_name,
+            pre_delete_table=pre_delete_table,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_embeddings(
+        cls,
+        text_embeddings: List[Tuple[str, List[float]]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ndims: int = ADA_TOKEN_COUNT,
+        table_name: str = _LANGCHAIN_DEFAULT_TABLE_NAME,
+        ids: Optional[List[str]] = None,
+        pre_delete_table: bool = False,
+        **kwargs: Any,
+    ) -> Hologres:
+        """Construct Hologres wrapper from raw documents and pre-
+        generated embeddings.
+
+        Return VectorStore initialized from documents and embeddings.
+        Hologres connection string is required
+        "Either pass it as a parameter
+        or set the HOLOGRES_CONNECTION_STRING environment variable.
+        Create the connection string by calling
+        HologresVector.connection_string_from_db_params
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import Hologres
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                text_embeddings = embeddings.embed_documents(texts)
+                text_embedding_pairs = list(zip(texts, text_embeddings))
+                faiss = Hologres.from_embeddings(text_embedding_pairs, embeddings)
+        """
+        texts = [t[0] for t in text_embeddings]
+        embeddings = [t[1] for t in text_embeddings]
+
+        return cls.__from(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            ndims=ndims,
+            table_name=table_name,
+            pre_delete_table=pre_delete_table,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_existing_index(
+        cls: Type[Hologres],
+        embedding: Embeddings,
+        ndims: int = ADA_TOKEN_COUNT,
+        table_name: str = _LANGCHAIN_DEFAULT_TABLE_NAME,
+        pre_delete_table: bool = False,
+        **kwargs: Any,
+    ) -> Hologres:
+        """
+        Get instance of an existing Hologres store.This method will
+        return the instance of the store without inserting any new
+        embeddings
+        """
+
+        connection_string = cls.get_connection_string(kwargs)
+
+        store = cls(
+            connection_string=connection_string,
+            ndims=ndims,
+            table_name=table_name,
+            embedding_function=embedding,
+            pre_delete_table=pre_delete_table,
+        )
+
+        return store
+
+    @classmethod
+    def get_connection_string(cls, kwargs: Dict[str, Any]) -> str:
+        connection_string: str = get_from_dict_or_env(
+            data=kwargs,
+            key="connection_string",
+            env_key="HOLOGRES_CONNECTION_STRING",
+        )
+
+        if not connection_string:
+            raise ValueError(
+                "Hologres connection string is required"
+                "Either pass it as a parameter"
+                "or set the HOLOGRES_CONNECTION_STRING environment variable."
+                "Create the connection string by calling"
+                "HologresVector.connection_string_from_db_params"
+            )
+
+        return connection_string
+
+    @classmethod
+    def from_documents(
+        cls: Type[Hologres],
+        documents: List[Document],
+        embedding: Embeddings,
+        ndims: int = ADA_TOKEN_COUNT,
+        table_name: str = _LANGCHAIN_DEFAULT_TABLE_NAME,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> Hologres:
+        """
+        Return VectorStore initialized from documents and embeddings.
+        Hologres connection string is required
+        "Either pass it as a parameter
+        or set the HOLOGRES_CONNECTION_STRING environment variable.
+        Create the connection string by calling
+        HologresVector.connection_string_from_db_params
+        """
+
+        texts = [d.page_content for d in documents]
+        metadatas = [d.metadata for d in documents]
+        connection_string = cls.get_connection_string(kwargs)
+
+        kwargs["connection_string"] = connection_string
+
+        return cls.from_texts(
+            texts=texts,
+            pre_delete_collection=pre_delete_collection,
+            embedding=embedding,
+            metadatas=metadatas,
+            ids=ids,
+            ndims=ndims,
+            table_name=table_name,
+            **kwargs,
+        )
+
+    @classmethod
+    def connection_string_from_db_params(
+        cls,
+        host: str,
+        port: int,
+        database: str,
+        user: str,
+        password: str,
+    ) -> str:
+        """Return connection string from database parameters."""
+        return (
+            f"dbname={database} user={user} password={password} host={host} port={port}"
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/infinispanvs.py b/llm/Lib/site-packages/langchain_community/vectorstores/infinispanvs.py
new file mode 100644
index 0000000000000000000000000000000000000000..a7c3cee745a9aee562f8a703e623f2f842fda281
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/infinispanvs.py
@@ -0,0 +1,614 @@
+"""Module providing Infinispan as a VectorStore"""
+
+from __future__ import annotations
+
+import json
+import logging
+import uuid
+from typing import Any, Iterable, List, Optional, Tuple, Type, cast
+
+import requests
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+logger = logging.getLogger(__name__)
+
+
+class InfinispanVS(VectorStore):
+    """`Infinispan` VectorStore interface.
+
+        This class exposes the method to present Infinispan as a
+        VectorStore. It relies on the Infinispan class (below) which takes care
+        of the REST interface with the server.
+
+    Example:
+        ... code-block:: python
+            from langchain_community.vectorstores import InfinispanVS
+            from mymodels import RGBEmbeddings
+            ...
+            vectorDb = InfinispanVS.from_documents(docs,
+                            embedding=RGBEmbeddings(),
+                            output_fields=["texture", "color"],
+                            lambda_key=lambda text,meta: str(meta["_key"]),
+                            lambda_content=lambda item: item["color"])
+
+        or an empty InfinispanVS instance can be created if preliminary setup
+        is required before populating the store
+
+        ... code-block:: python
+            from langchain_community.vectorstores import InfinispanVS
+            from mymodels import RGBEmbeddings
+            ...
+            ispnVS = InfinispanVS()
+            # configure Infinispan here
+            # i.e. create cache and schema
+
+            # then populate the store
+            vectorDb = InfinispanVS.from_documents(docs,
+                            embedding=RGBEmbeddings(),
+                            output_fields: ["texture", "color"],
+                            lambda_key: lambda text,meta: str(meta["_key"]),
+                            lambda_content: lambda item: item["color"]})
+    """
+
+    def __init__(
+        self,
+        embedding: Optional[Embeddings] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ):
+        self.ispn = Infinispan(**kwargs)
+        self._configuration = kwargs
+        self._cache_name = str(self._configuration.get("cache_name", "vector"))
+        self._entity_name = str(self._configuration.get("entity_name", "vector"))
+        self._embedding = embedding
+        self._textfield = self._configuration.get("textfield", "text")
+        self._vectorfield = self._configuration.get("vectorfield", "vector")
+        self._to_content = self._configuration.get(
+            "lambda_content", lambda item: self._default_content(item)
+        )
+        self._to_metadata = self._configuration.get(
+            "lambda_metadata", lambda item: self._default_metadata(item)
+        )
+        self._output_fields = self._configuration.get("output_fields")
+        self._ids = ids
+
+    def _default_metadata(self, item: dict) -> dict:
+        meta = dict(item)
+        meta.pop(self._vectorfield, None)
+        meta.pop(self._textfield, None)
+        meta.pop("_type", None)
+        return meta
+
+    def _default_content(self, item: dict[str, Any]) -> Any:
+        return item.get(self._textfield)
+
+    def schema_builder(self, templ: dict, dimension: int) -> str:
+        metadata_proto_tpl = """
+/**
+* @Indexed
+*/
+message %s {
+/**
+* @Vector(dimension=%d)
+*/
+repeated float %s = 1;
+"""
+        metadata_proto = metadata_proto_tpl % (
+            self._entity_name,
+            dimension,
+            self._vectorfield,
+        )
+        idx = 2
+        for f, v in templ.items():
+            if isinstance(v, str):
+                metadata_proto += "optional string " + f + " = " + str(idx) + ";\n"
+            elif isinstance(v, int):
+                metadata_proto += "optional int64 " + f + " = " + str(idx) + ";\n"
+            elif isinstance(v, float):
+                metadata_proto += "optional double " + f + " = " + str(idx) + ";\n"
+            elif isinstance(v, bytes):
+                metadata_proto += "optional bytes " + f + " = " + str(idx) + ";\n"
+            elif isinstance(v, bool):
+                metadata_proto += "optional bool " + f + " = " + str(idx) + ";\n"
+            else:
+                raise Exception(
+                    "Unable to build proto schema for metadata. "
+                    "Unhandled type for field: " + f
+                )
+            idx += 1
+        metadata_proto += "}\n"
+        return metadata_proto
+
+    def schema_create(self, proto: str) -> requests.Response:
+        """Deploy the schema for the vector db
+        Args:
+            proto(str): protobuf schema
+        Returns:
+            An http Response containing the result of the operation
+        """
+        return self.ispn.schema_post(self._entity_name + ".proto", proto)
+
+    def schema_delete(self) -> requests.Response:
+        """Delete the schema for the vector db
+        Returns:
+            An http Response containing the result of the operation
+        """
+        return self.ispn.schema_delete(self._entity_name + ".proto")
+
+    def cache_create(self, config: str = "") -> requests.Response:
+        """Create the cache for the vector db
+        Args:
+            config(str): configuration of the cache.
+        Returns:
+            An http Response containing the result of the operation
+        """
+        if config == "":
+            config = (
+                '''
+            {
+  "distributed-cache": {
+    "owners": "2",
+    "mode": "SYNC",
+    "statistics": true,
+    "encoding": {
+      "media-type": "application/x-protostream"
+    },
+    "indexing": {
+      "enabled": true,
+      "storage": "filesystem",
+      "startup-mode": "AUTO",
+      "indexing-mode": "AUTO",
+      "indexed-entities": [
+        "'''
+                + self._entity_name
+                + """"
+      ]
+    }
+  }
+}
+"""
+            )
+        return self.ispn.cache_post(self._cache_name, config)
+
+    def cache_delete(self) -> requests.Response:
+        """Delete the cache for the vector db
+        Returns:
+            An http Response containing the result of the operation
+        """
+        return self.ispn.cache_delete(self._cache_name)
+
+    def cache_clear(self) -> requests.Response:
+        """Clear the cache for the vector db
+        Returns:
+            An http Response containing the result of the operation
+        """
+        return self.ispn.cache_clear(self._cache_name)
+
+    def cache_exists(self) -> bool:
+        """Checks if the cache exists
+        Returns:
+            true if exists
+        """
+        return self.ispn.cache_exists(self._cache_name)
+
+    def cache_index_clear(self) -> requests.Response:
+        """Clear the index for the vector db
+        Returns:
+            An http Response containing the result of the operation
+        """
+        return self.ispn.index_clear(self._cache_name)
+
+    def cache_index_reindex(self) -> requests.Response:
+        """Rebuild the for the vector db
+        Returns:
+            An http Response containing the result of the operation
+        """
+        return self.ispn.index_reindex(self._cache_name)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        last_vector: Optional[List[float]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        result = []
+        texts_l = list(texts)
+        if last_vector:
+            texts_l.pop()
+        embeds = self._embedding.embed_documents(texts_l)  # type: ignore
+        if last_vector:
+            embeds.append(last_vector)
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+        ids = self._ids or [str(uuid.uuid4()) for _ in texts]
+        data_input = list(zip(metadatas, embeds, ids))
+        for metadata, embed, key in data_input:
+            data = {"_type": self._entity_name, self._vectorfield: embed}
+            data.update(metadata)
+            data_str = json.dumps(data)
+            self.ispn.put(key, data_str, self._cache_name)
+            result.append(key)
+        return result
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query."""
+        documents = self.similarity_search_with_score(query=query, k=k)
+        return [doc for doc, _ in documents]
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Perform a search on a query string and return results with score.
+
+        Args:
+            query (str): The text being searched.
+            k (int, optional): The amount of results to return. Defaults to 4.
+
+        Returns:
+            List[Tuple[Document, float]]
+        """
+        embed = self._embedding.embed_query(query)  # type: ignore
+        documents = self.similarity_search_with_score_by_vector(embedding=embed, k=k)
+        return documents
+
+    def similarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        res = self.similarity_search_with_score_by_vector(embedding, k)
+        return [doc for doc, _ in res]
+
+    def similarity_search_with_score_by_vector(
+        self, embedding: List[float], k: int = 4
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of pair (Documents, score) most similar to the query vector.
+        """
+        if self._output_fields is None:
+            query_str = (
+                "select v, score(v) from "
+                + self._entity_name
+                + " v where v."
+                + self._vectorfield
+                + " <-> "
+                + json.dumps(embedding)
+                + "~"
+                + str(k)
+            )
+        else:
+            query_proj = "select "
+            for field in self._output_fields[:-1]:
+                query_proj = query_proj + "v." + field + ","
+            query_proj = query_proj + "v." + self._output_fields[-1]
+            query_str = (
+                query_proj
+                + ", score(v) from "
+                + self._entity_name
+                + " v where v."
+                + self._vectorfield
+                + " <-> "
+                + json.dumps(embedding)
+                + "~"
+                + str(k)
+            )
+        query_res = self.ispn.req_query(query_str, self._cache_name)
+        result = json.loads(query_res.text)
+        return self._query_result_to_docs(result)
+
+    def _query_result_to_docs(
+        self, result: dict[str, Any]
+    ) -> List[Tuple[Document, float]]:
+        documents = []
+        for row in result["hits"]:
+            hit = row["hit"] or {}
+            if self._output_fields is None:
+                entity = hit["*"]
+            else:
+                entity = {key: hit.get(key) for key in self._output_fields}
+            doc = Document(
+                page_content=self._to_content(entity),
+                metadata=self._to_metadata(entity),
+            )
+            documents.append((doc, hit["score()"]))
+        return documents
+
+    def configure(self, metadata: dict, dimension: int) -> None:
+        schema = self.schema_builder(metadata, dimension)
+        output = self.schema_create(schema)
+        assert output.ok, "Unable to create schema. Already exists? "
+        "Consider using clear_old=True"
+        assert json.loads(output.text)["error"] is None
+        if not self.cache_exists():
+            output = self.cache_create()
+            assert output.ok, "Unable to create cache. Already exists? "
+            "Consider using clear_old=True"
+            # Ensure index is clean
+            self.cache_index_clear()
+
+    def config_clear(self) -> None:
+        self.schema_delete()
+        self.cache_delete()
+
+    @classmethod
+    def from_texts(
+        cls: Type[InfinispanVS],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        clear_old: Optional[bool] = True,
+        auto_config: Optional[bool] = True,
+        **kwargs: Any,
+    ) -> InfinispanVS:
+        """Return VectorStore initialized from texts and embeddings."""
+        infinispanvs = cls(embedding=embedding, ids=ids, **kwargs)
+        if auto_config and len(metadatas or []) > 0:
+            if clear_old:
+                infinispanvs.config_clear()
+            vec = embedding.embed_query(texts[len(texts) - 1])
+            metadatas = cast(List[dict], metadatas)
+            infinispanvs.configure(metadatas[0], len(vec))
+        else:
+            if clear_old:
+                infinispanvs.cache_clear()
+            vec = embedding.embed_query(texts[len(texts) - 1])
+        if texts:
+            infinispanvs.add_texts(texts, metadatas, vector=vec)
+        return infinispanvs
+
+
+REST_TIMEOUT = 10
+
+
+class Infinispan:
+    """Helper class for `Infinispan` REST interface.
+
+    This class exposes the Infinispan operations needed to
+    create and set up a vector db.
+
+    You need a running Infinispan (15+) server without authentication.
+    You can easily start one, see:
+    https://github.com/rigazilla/infinispan-vector#run-infinispan
+    """
+
+    def __init__(self, **kwargs: Any):
+        self._configuration = kwargs
+        self._schema = str(self._configuration.get("schema", "http"))
+        self._host = str(self._configuration.get("hosts", ["127.0.0.1:11222"])[0])
+        self._default_node = self._schema + "://" + self._host
+        self._cache_url = str(self._configuration.get("cache_url", "/rest/v2/caches"))
+        self._schema_url = str(self._configuration.get("cache_url", "/rest/v2/schemas"))
+        self._use_post_for_query = str(
+            self._configuration.get("use_post_for_query", True)
+        )
+
+    def req_query(
+        self, query: str, cache_name: str, local: bool = False
+    ) -> requests.Response:
+        """Request a query
+        Args:
+            query(str): query requested
+            cache_name(str): name of the target cache
+            local(boolean): whether the query is local to clustered
+        Returns:
+            An http Response containing the result set or errors
+        """
+        if self._use_post_for_query:
+            return self._query_post(query, cache_name, local)
+        return self._query_get(query, cache_name, local)
+
+    def _query_post(
+        self, query_str: str, cache_name: str, local: bool = False
+    ) -> requests.Response:
+        api_url = (
+            self._default_node
+            + self._cache_url
+            + "/"
+            + cache_name
+            + "?action=search&local="
+            + str(local)
+        )
+        data = {"query": query_str}
+        data_json = json.dumps(data)
+        response = requests.post(
+            api_url,
+            data_json,
+            headers={"Content-Type": "application/json"},
+            timeout=REST_TIMEOUT,
+        )
+        return response
+
+    def _query_get(
+        self, query_str: str, cache_name: str, local: bool = False
+    ) -> requests.Response:
+        api_url = (
+            self._default_node
+            + self._cache_url
+            + "/"
+            + cache_name
+            + "?action=search&query="
+            + query_str
+            + "&local="
+            + str(local)
+        )
+        response = requests.get(api_url, timeout=REST_TIMEOUT)
+        return response
+
+    def post(self, key: str, data: str, cache_name: str) -> requests.Response:
+        """Post an entry
+        Args:
+            key(str): key of the entry
+            data(str): content of the entry in json format
+            cache_name(str): target cache
+        Returns:
+            An http Response containing the result of the operation
+        """
+        api_url = self._default_node + self._cache_url + "/" + cache_name + "/" + key
+        response = requests.post(
+            api_url,
+            data,
+            headers={"Content-Type": "application/json"},
+            timeout=REST_TIMEOUT,
+        )
+        return response
+
+    def put(self, key: str, data: str, cache_name: str) -> requests.Response:
+        """Put an entry
+        Args:
+            key(str): key of the entry
+            data(str): content of the entry in json format
+            cache_name(str): target cache
+        Returns:
+            An http Response containing the result of the operation
+        """
+        api_url = self._default_node + self._cache_url + "/" + cache_name + "/" + key
+        response = requests.put(
+            api_url,
+            data,
+            headers={"Content-Type": "application/json"},
+            timeout=REST_TIMEOUT,
+        )
+        return response
+
+    def get(self, key: str, cache_name: str) -> requests.Response:
+        """Get an entry
+        Args:
+            key(str): key of the entry
+            cache_name(str): target cache
+        Returns:
+            An http Response containing the entry or errors
+        """
+        api_url = self._default_node + self._cache_url + "/" + cache_name + "/" + key
+        response = requests.get(
+            api_url, headers={"Content-Type": "application/json"}, timeout=REST_TIMEOUT
+        )
+        return response
+
+    def schema_post(self, name: str, proto: str) -> requests.Response:
+        """Deploy a schema
+        Args:
+            name(str): name of the schema. Will be used as a key
+            proto(str): protobuf schema
+        Returns:
+            An http Response containing the result of the operation
+        """
+        api_url = self._default_node + self._schema_url + "/" + name
+        response = requests.post(api_url, proto, timeout=REST_TIMEOUT)
+        return response
+
+    def cache_post(self, name: str, config: str) -> requests.Response:
+        """Create a cache
+        Args:
+            name(str): name of the cache.
+            config(str): configuration of the cache.
+        Returns:
+            An http Response containing the result of the operation
+        """
+        api_url = self._default_node + self._cache_url + "/" + name
+        response = requests.post(
+            api_url,
+            config,
+            headers={"Content-Type": "application/json"},
+            timeout=REST_TIMEOUT,
+        )
+        return response
+
+    def schema_delete(self, name: str) -> requests.Response:
+        """Delete a schema
+        Args:
+            name(str): name of the schema.
+        Returns:
+            An http Response containing the result of the operation
+        """
+        api_url = self._default_node + self._schema_url + "/" + name
+        response = requests.delete(api_url, timeout=REST_TIMEOUT)
+        return response
+
+    def cache_delete(self, name: str) -> requests.Response:
+        """Delete a cache
+        Args:
+            name(str): name of the cache.
+        Returns:
+            An http Response containing the result of the operation
+        """
+        api_url = self._default_node + self._cache_url + "/" + name
+        response = requests.delete(api_url, timeout=REST_TIMEOUT)
+        return response
+
+    def cache_clear(self, cache_name: str) -> requests.Response:
+        """Clear a cache
+        Args:
+            cache_name(str): name of the cache.
+        Returns:
+            An http Response containing the result of the operation
+        """
+        api_url = (
+            self._default_node + self._cache_url + "/" + cache_name + "?action=clear"
+        )
+        response = requests.post(api_url, timeout=REST_TIMEOUT)
+        return response
+
+    def cache_exists(self, cache_name: str) -> bool:
+        """Check if a cache exists
+        Args:
+            cache_name(str): name of the cache.
+        Returns:
+            True if cache exists
+        """
+        api_url = (
+            self._default_node + self._cache_url + "/" + cache_name + "?action=clear"
+        )
+        return self.resource_exists(api_url)
+
+    @staticmethod
+    def resource_exists(api_url: str) -> bool:
+        """Check if a resource exists
+        Args:
+            api_url(str): url of the resource.
+        Returns:
+            true if resource exists
+        """
+        response = requests.head(api_url, timeout=REST_TIMEOUT)
+        return response.ok
+
+    def index_clear(self, cache_name: str) -> requests.Response:
+        """Clear an index on a cache
+        Args:
+            cache_name(str): name of the cache.
+        Returns:
+            An http Response containing the result of the operation
+        """
+        api_url = (
+            self._default_node
+            + self._cache_url
+            + "/"
+            + cache_name
+            + "/search/indexes?action=clear"
+        )
+        return requests.post(api_url, timeout=REST_TIMEOUT)
+
+    def index_reindex(self, cache_name: str) -> requests.Response:
+        """Rebuild index on a cache
+        Args:
+            cache_name(str): name of the cache.
+        Returns:
+            An http Response containing the result of the operation
+        """
+        api_url = (
+            self._default_node
+            + self._cache_url
+            + "/"
+            + cache_name
+            + "/search/indexes?action=reindex"
+        )
+        return requests.post(api_url, timeout=REST_TIMEOUT)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/inmemory.py b/llm/Lib/site-packages/langchain_community/vectorstores/inmemory.py
new file mode 100644
index 0000000000000000000000000000000000000000..7b73e0843d12512fad14389eee0a7954548982e4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/inmemory.py
@@ -0,0 +1,199 @@
+import uuid
+from typing import Any, Dict, Iterable, List, Optional, Sequence, Tuple
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.utils.math import cosine_similarity
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+
+class InMemoryVectorStore(VectorStore):
+    """In-memory implementation of VectorStore using a dictionary.
+    Uses numpy to compute cosine similarity for search.
+
+    Args:
+        embedding:  embedding function to use.
+    """
+
+    def __init__(self, embedding: Embeddings) -> None:
+        self.store: Dict[str, Dict[str, Any]] = {}
+        self.embedding = embedding
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding
+
+    def delete(self, ids: Optional[Sequence[str]] = None, **kwargs: Any) -> None:
+        if ids:
+            for _id in ids:
+                self.store.pop(_id, None)
+
+    async def adelete(self, ids: Optional[Sequence[str]] = None, **kwargs: Any) -> None:
+        self.delete(ids)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        ids = []
+        vectors = self.embedding.embed_documents(list(texts))
+
+        for i, text in enumerate(texts):
+            doc_id = str(uuid.uuid4())
+            ids.append(doc_id)
+            self.store[doc_id] = {
+                "id": doc_id,
+                "vector": vectors[i],
+                "text": text,
+                "metadata": metadatas[i] if metadatas else {},
+            }
+        return ids
+
+    async def aadd_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        return self.add_texts(texts, metadatas, **kwargs)
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+    ) -> List[Tuple[Document, float]]:
+        docs_with_similarity = []
+        for doc in self.store.values():
+            similarity = float(cosine_similarity([embedding], [doc["vector"]]).item(0))
+            docs_with_similarity.append(
+                (
+                    Document(page_content=doc["text"], metadata=doc["metadata"]),
+                    similarity,
+                )
+            )
+        docs_with_similarity.sort(key=lambda x: x[1], reverse=True)
+        return docs_with_similarity[:k]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        embedding = self.embedding.embed_query(query)
+        docs = self.similarity_search_with_score_by_vector(
+            embedding,
+            k,
+        )
+        return docs
+
+    async def asimilarity_search_with_score(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        return self.similarity_search_with_score(query, k, **kwargs)
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Document]:
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding,
+            k,
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    async def asimilarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        return self.similarity_search_by_vector(embedding, k, **kwargs)
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        return [doc for doc, _ in self.similarity_search_with_score(query, k, **kwargs)]
+
+    async def asimilarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        return self.similarity_search(query, k, **kwargs)
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        docs_with_similarity = []
+        for doc in self.store.values():
+            similarity = float(cosine_similarity([embedding], [doc["vector"]]).item(0))
+            docs_with_similarity.append(
+                (
+                    doc,
+                    similarity,
+                )
+            )
+        docs_with_similarity.sort(key=lambda x: x[1], reverse=True)
+        prefetch_hits = docs_with_similarity[:fetch_k]
+
+        mmr_chosen_indices = maximal_marginal_relevance(
+            np.array(embedding, dtype=np.float32),
+            [doc["vector"] for doc, _ in prefetch_hits],
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+        return [
+            Document(
+                page_content=prefetch_hits[idx][0]["text"],
+                metadata=prefetch_hits[idx][0]["metadata"],
+            )
+            for idx in mmr_chosen_indices
+        ]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        embedding_vector = self.embedding.embed_query(query)
+        return self.max_marginal_relevance_search_by_vector(
+            embedding_vector,
+            k,
+            fetch_k,
+            lambda_mult=lambda_mult,
+        )
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> "InMemoryVectorStore":
+        store = cls(
+            embedding=embedding,
+        )
+        store.add_texts(texts=texts, metadatas=metadatas)
+        return store
+
+    @classmethod
+    async def afrom_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> "InMemoryVectorStore":
+        return cls.from_texts(texts, embedding, metadatas, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/jaguar.py b/llm/Lib/site-packages/langchain_community/vectorstores/jaguar.py
new file mode 100644
index 0000000000000000000000000000000000000000..755e7a345f6aec5a853b9e1d745fe1d09c2574be
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/jaguar.py
@@ -0,0 +1,455 @@
+from __future__ import annotations
+
+import json
+import logging
+from typing import Any, List, Optional, Tuple
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+logger = logging.getLogger(__name__)
+
+
+class Jaguar(VectorStore):
+    """`Jaguar API` vector store.
+
+    See http://www.jaguardb.com
+    See http://github.com/fserv/jaguar-sdk
+
+    Example:
+       .. code-block:: python
+
+           from langchain_community.vectorstores.jaguar import Jaguar
+
+           vectorstore = Jaguar(
+               pod = 'vdb',
+               store = 'mystore',
+               vector_index = 'v',
+               vector_type = 'cosine_fraction_float',
+               vector_dimension = 1536,
+               url='http://192.168.8.88:8080/fwww/',
+               embedding=openai_model
+           )
+    """
+
+    def __init__(
+        self,
+        pod: str,
+        store: str,
+        vector_index: str,
+        vector_type: str,
+        vector_dimension: int,
+        url: str,
+        embedding: Embeddings,
+    ):
+        self._pod = pod
+        self._store = store
+        self._vector_index = vector_index
+        self._vector_type = vector_type
+        self._vector_dimension = vector_dimension
+
+        self._embedding = embedding
+        try:
+            from jaguardb_http_client.JaguarHttpClient import JaguarHttpClient
+        except ImportError:
+            raise ValueError(
+                "Could not import jaguardb-http-client python package. "
+                "Please install it with `pip install -U jaguardb-http-client`"
+            )
+
+        self._jag = JaguarHttpClient(url)
+        self._token = ""
+
+    def login(
+        self,
+        jaguar_api_key: Optional[str] = "",
+    ) -> bool:
+        """
+        login to jaguardb server with a jaguar_api_key or let self._jag find a key
+        Args:
+            pod (str):  name of a Pod
+            store (str):  name of a vector store
+            optional jaguar_api_key (str): API key of user to jaguardb server
+        Returns:
+            True if successful; False if not successful
+        """
+
+        if jaguar_api_key == "":
+            jaguar_api_key = self._jag.getApiKey()
+        self._jaguar_api_key = jaguar_api_key
+        self._token = self._jag.login(jaguar_api_key)
+        if self._token == "":
+            logger.error("E0001 error init(): invalid jaguar_api_key")
+            return False
+        return True
+
+    def create(
+        self,
+        metadata_str: str,
+        text_size: int,
+    ) -> None:
+        """
+        create the vector store on the backend database
+        Args:
+            metadata_str (str):  columns and their types
+        Returns:
+            True if successful; False if not successful
+        """
+        podstore = self._pod + "." + self._store
+
+        """
+        source column is required.
+        v:text column is required.
+        """
+        q = "create store "
+        q += podstore
+        q += f" ({self._vector_index} vector({self._vector_dimension},"
+        q += f" '{self._vector_type}'),"
+        q += f" source char(256), v:text char({text_size}),"
+        q += metadata_str + ")"
+        self.run(q)
+
+    def run(self, query: str, withFile: bool = False) -> dict:
+        """
+        Run any query statement in jaguardb
+        Args:
+            query (str): query statement to jaguardb
+        Returns:
+            None for invalid token, or
+            json result string
+        """
+        if self._token == "":
+            logger.error(f"E0005 error run({query})")
+            return {}
+
+        resp = self._jag.post(query, self._token, withFile)
+        txt = resp.text
+        try:
+            js = json.loads(txt)
+            return js
+        except Exception:
+            return {}
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self._embedding
+
+    def add_texts(  # type: ignore[override]
+        self,
+        texts: List[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """
+        Add  texts through the embeddings and add to the vectorstore.
+        Args:
+          texts: list of text strings to add to the jaguar vector store.
+          metadatas: Optional list of metadatas associated with the texts.
+            [{"m1": "v11", "m2": "v12", "m3": "v13", "filecol": "path_file1.jpg" },
+             {"m1": "v21", "m2": "v22", "m3": "v23", "filecol": "path_file2.jpg" },
+             {"m1": "v31", "m2": "v32", "m3": "v33", "filecol": "path_file3.jpg" },
+             {"m1": "v41", "m2": "v42", "m3": "v43", "filecol": "path_file4.jpg" }]
+          kwargs: vector_index=name_of_vector_index
+                  file_column=name_of_file_column
+
+        Returns:
+            List of ids from adding the texts into the vectorstore
+        """
+        vcol = self._vector_index
+        filecol = kwargs.get("file_column", "")
+        text_tag = kwargs.get("text_tag", "")
+        podstorevcol = self._pod + "." + self._store + "." + vcol
+        q = "textcol " + podstorevcol
+        js = self.run(q)
+        if js == "":
+            return []
+        textcol = js["data"]
+
+        if text_tag != "":
+            tag_texts = []
+            for t in texts:
+                tag_texts.append(text_tag + " " + t)
+            texts = tag_texts
+
+        embeddings = self._embedding.embed_documents(list(texts))
+        ids = []
+        if metadatas is None:
+            ### no meta and no files to upload
+            i = 0
+            for vec in embeddings:
+                str_vec = [str(x) for x in vec]
+                values_comma = ",".join(str_vec)
+                podstore = self._pod + "." + self._store
+                q = "insert into " + podstore + " ("
+                q += vcol + "," + textcol + ") values ('" + values_comma
+                txt = texts[i].replace("'", "\\'")
+                q += "','" + txt + "')"
+                js = self.run(q, False)
+                ids.append(js["zid"])
+                i += 1
+        else:
+            i = 0
+            for vec in embeddings:
+                str_vec = [str(x) for x in vec]
+                nvec, vvec, filepath = self._parseMeta(metadatas[i], filecol)
+                if filecol != "":
+                    rc = self._jag.postFile(self._token, filepath, 1)
+                    if not rc:
+                        return []
+                names_comma = ",".join(nvec)
+                names_comma += "," + vcol
+                ## col1,col2,col3,vecl
+                values_comma = "'" + "','".join(vvec) + "'"
+                ### 'va1','val2','val3'
+                values_comma += ",'" + ",".join(str_vec) + "'"
+                ### 'v1,v2,v3'
+                podstore = self._pod + "." + self._store
+                q = "insert into " + podstore + " ("
+                q += names_comma + "," + textcol + ") values (" + values_comma
+                txt = texts[i].replace("'", "\\'")
+                q += ",'" + txt + "')"
+                if filecol != "":
+                    js = self.run(q, True)
+                else:
+                    js = self.run(q, False)
+                ids.append(js["zid"])
+                i += 1
+
+        return ids
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 3,
+        fetch_k: int = -1,
+        where: Optional[str] = None,
+        args: Optional[str] = None,
+        metadatas: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """
+        Return Jaguar documents most similar to query, along with scores.
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 3.
+            lambda_val: lexical match parameter for hybrid search.
+            where: the where clause in select similarity. For example a
+                where can be "rating > 3.0 and (state = 'NV' or state = 'CA')"
+            args: extra options passed to select similarity
+            kwargs:  vector_index=vcol, vector_type=cosine_fraction_float
+        Returns:
+            List of Documents most similar to the query and score for each.
+            List of Tuples of (doc, similarity_score):
+                [ (doc, score), (doc, score), ...]
+        """
+        vcol = self._vector_index
+        vtype = self._vector_type
+        embeddings = self._embedding.embed_query(query)
+        str_embeddings = [str(f) for f in embeddings]
+        qv_comma = ",".join(str_embeddings)
+        podstore = self._pod + "." + self._store
+        q = (
+            "select similarity("
+            + vcol
+            + ",'"
+            + qv_comma
+            + "','topk="
+            + str(k)
+            + ",fetch_k="
+            + str(fetch_k)
+            + ",type="
+            + vtype
+        )
+        q += ",with_score=yes,with_text=yes"
+        if args is not None:
+            q += "," + args
+
+        if metadatas is not None:
+            meta = "&".join(metadatas)
+            q += ",metadata=" + meta
+
+        q += "') from " + podstore
+
+        if where is not None:
+            q += " where " + where
+
+        jarr = self.run(q)
+        if jarr is None:
+            return []
+
+        docs_with_score = []
+        for js in jarr:
+            score = js["score"]
+            text = js["text"]
+            zid = js["zid"]
+
+            ### give metadatas
+            md = {}
+            md["zid"] = zid
+            if metadatas is not None:
+                for m in metadatas:
+                    mv = js[m]
+                    md[m] = mv
+
+            doc = Document(page_content=text, metadata=md)
+            tup = (doc, score)
+            docs_with_score.append(tup)
+
+        return docs_with_score
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 3,
+        where: Optional[str] = None,
+        metadatas: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """
+        Return Jaguar documents most similar to query, along with scores.
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 5.
+            where: the where clause in select similarity. For example a
+                where can be "rating > 3.0 and (state = 'NV' or state = 'CA')"
+        Returns:
+            List of Documents most similar to the query
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query, k=k, where=where, metadatas=metadatas, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def is_anomalous(
+        self,
+        query: str,
+        **kwargs: Any,
+    ) -> bool:
+        """
+        Detect if given text is anomalous from the dataset
+        Args:
+            query: Text to detect if it is anomaly
+        Returns:
+            True or False
+        """
+        vcol = self._vector_index
+        vtype = self._vector_type
+        embeddings = self._embedding.embed_query(query)
+        str_embeddings = [str(f) for f in embeddings]
+        qv_comma = ",".join(str_embeddings)
+        podstore = self._pod + "." + self._store
+        q = "select anomalous(" + vcol + ", '" + qv_comma + "', 'type=" + vtype + "')"
+        q += " from " + podstore
+
+        js = self.run(q)
+        if isinstance(js, list) and len(js) == 0:
+            return False
+        jd = json.loads(js[0])
+        if jd["anomalous"] == "YES":
+            return True
+        return False
+
+    @classmethod
+    def from_texts(  # type: ignore[override]
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        url: str,
+        pod: str,
+        store: str,
+        vector_index: str,
+        vector_type: str,
+        vector_dimension: int,
+        metadatas: Optional[List[dict]] = None,
+        jaguar_api_key: Optional[str] = "",
+        **kwargs: Any,
+    ) -> Jaguar:
+        jagstore = cls(
+            pod, store, vector_index, vector_type, vector_dimension, url, embedding
+        )
+        jagstore.login(jaguar_api_key)
+        jagstore.clear()
+        jagstore.add_texts(texts, metadatas, **kwargs)
+        return jagstore
+
+    def clear(self) -> None:
+        """
+        Delete all records in jaguardb
+        Args: No args
+        Returns: None
+        """
+        podstore = self._pod + "." + self._store
+        q = "truncate store " + podstore
+        self.run(q)
+
+    def delete(self, zids: List[str], **kwargs: Any) -> None:  # type: ignore[override]
+        """
+        Delete records in jaguardb by a list of zero-ids
+        Args:
+            pod (str):  name of a Pod
+            ids (List[str]):  a list of zid as string
+        Returns:
+            Do not return anything
+        """
+        podstore = self._pod + "." + self._store
+        for zid in zids:
+            q = "delete from " + podstore + " where zid='" + zid + "'"
+            self.run(q)
+
+    def count(self) -> int:
+        """
+        Count records of a store in jaguardb
+        Args: no args
+        Returns: (int) number of records in pod store
+        """
+        podstore = self._pod + "." + self._store
+        q = "select count() from " + podstore
+        js = self.run(q)
+        if isinstance(js, list) and len(js) == 0:
+            return 0
+        jd = json.loads(js[0])
+        return int(jd["data"])
+
+    def drop(self) -> None:
+        """
+        Drop or remove a store in jaguardb
+        Args: no args
+        Returns: None
+        """
+        podstore = self._pod + "." + self._store
+        q = "drop store " + podstore
+        self.run(q)
+
+    def logout(self) -> None:
+        """
+        Logout to cleanup resources
+        Args: no args
+        Returns: None
+        """
+        self._jag.logout(self._token)
+
+    def prt(self, msg: str) -> None:
+        with open("/tmp/debugjaguar.log", "a") as file:
+            print(f"msg={msg}", file=file, flush=True)  # noqa: T201
+
+    def _parseMeta(self, nvmap: dict, filecol: str) -> Tuple[List[str], List[str], str]:
+        filepath = ""
+        if filecol == "":
+            nvec = list(nvmap.keys())
+            vvec = list(nvmap.values())
+        else:
+            nvec = []
+            vvec = []
+            if filecol in nvmap:
+                nvec.append(filecol)
+                vvec.append(nvmap[filecol])
+                filepath = nvmap[filecol]
+
+            for k, v in nvmap.items():
+                if k != filecol:
+                    nvec.append(k)
+                    vvec.append(v)
+
+        vvec_s = [str(e) for e in vvec]
+        return nvec, vvec_s, filepath
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/kdbai.py b/llm/Lib/site-packages/langchain_community/vectorstores/kdbai.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b1310293b0a9ffded92acc9c3840e3cc4528186
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/kdbai.py
@@ -0,0 +1,271 @@
+from __future__ import annotations
+
+import logging
+import uuid
+from typing import Any, Iterable, List, Optional, Tuple
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import DistanceStrategy
+
+logger = logging.getLogger(__name__)
+
+
+class KDBAI(VectorStore):
+    """`KDB.AI` vector store.
+
+     See [https://kdb.ai](https://kdb.ai)
+
+    To use, you should have the `kdbai_client` python package installed.
+
+    Args:
+        table: kdbai_client.Table object to use as storage,
+        embedding: Any embedding function implementing
+            `langchain.embeddings.base.Embeddings` interface,
+        distance_strategy: One option from DistanceStrategy.EUCLIDEAN_DISTANCE,
+            DistanceStrategy.DOT_PRODUCT or DistanceStrategy.COSINE.
+
+    See the example [notebook](https://github.com/KxSystems/langchain/blob/KDB.AI/docs/docs/integrations/vectorstores/kdbai.ipynb).
+    """
+
+    def __init__(
+        self,
+        table: Any,
+        embedding: Embeddings,
+        distance_strategy: Optional[
+            DistanceStrategy
+        ] = DistanceStrategy.EUCLIDEAN_DISTANCE,
+    ):
+        try:
+            import kdbai_client  # noqa
+        except ImportError:
+            raise ImportError(
+                "Could not import kdbai_client python package. "
+                "Please install it with `pip install kdbai_client`."
+            )
+        self._table = table
+        self._embedding = embedding
+        self.distance_strategy = distance_strategy
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        if isinstance(self._embedding, Embeddings):
+            return self._embedding
+        return None
+
+    def _embed_documents(self, texts: Iterable[str]) -> List[List[float]]:
+        if isinstance(self._embedding, Embeddings):
+            return self._embedding.embed_documents(list(texts))
+        return [self._embedding(t) for t in texts]
+
+    def _embed_query(self, text: str) -> List[float]:
+        if isinstance(self._embedding, Embeddings):
+            return self._embedding.embed_query(text)
+        return self._embedding(text)
+
+    def _insert(
+        self,
+        texts: List[str],
+        ids: Optional[List[str]],
+        metadata: Optional[Any] = None,
+    ) -> None:
+        try:
+            import numpy as np
+        except ImportError:
+            raise ImportError(
+                "Could not import numpy python package. "
+                "Please install it with `pip install numpy`."
+            )
+
+        try:
+            import pandas as pd
+        except ImportError:
+            raise ImportError(
+                "Could not import pandas python package. "
+                "Please install it with `pip install pandas`."
+            )
+
+        embeds = self._embedding.embed_documents(texts)
+        df = pd.DataFrame()
+        df["id"] = ids
+        df["text"] = [t.encode("utf-8") for t in texts]
+        df["embeddings"] = [np.array(e, dtype="float32") for e in embeds]
+        if metadata is not None:
+            df = pd.concat([df, metadata], axis=1)
+        self._table.insert(df, warn=False)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        batch_size: int = 32,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts (Iterable[str]): Texts to add to the vectorstore.
+            metadatas (Optional[List[dict]]): List of metadata corresponding to each
+                chunk of text.
+            ids (Optional[List[str]]): List of IDs corresponding to each chunk of text.
+            batch_size (Optional[int]): Size of batch of chunks of text to insert at
+                once.
+
+        Returns:
+            List[str]: List of IDs of the added texts.
+        """
+
+        try:
+            import pandas as pd
+        except ImportError:
+            raise ImportError(
+                "Could not import pandas python package. "
+                "Please install it with `pip install pandas`."
+            )
+
+        texts = list(texts)
+        metadf: pd.DataFrame = None
+        if metadatas is not None:
+            if isinstance(metadatas, pd.DataFrame):
+                metadf = metadatas
+            else:
+                metadf = pd.DataFrame(metadatas)
+        out_ids: List[str] = []
+        nbatches = (len(texts) - 1) // batch_size + 1
+        for i in range(nbatches):
+            istart = i * batch_size
+            iend = (i + 1) * batch_size
+            batch = texts[istart:iend]
+            if ids:
+                batch_ids = ids[istart:iend]
+            else:
+                batch_ids = [str(uuid.uuid4()) for _ in range(len(batch))]
+            if metadf is not None:
+                batch_meta = metadf.iloc[istart:iend].reset_index(drop=True)
+            else:
+                batch_meta = None
+            self._insert(batch, batch_ids, batch_meta)
+            out_ids = out_ids + batch_ids
+        return out_ids
+
+    def add_documents(
+        self, documents: List[Document], batch_size: int = 32, **kwargs: Any
+    ) -> List[str]:
+        """Run more documents through the embeddings and add to the vectorstore.
+
+        Args:
+            documents (List[Document]: Documents to add to the vectorstore.
+            batch_size (Optional[int]): Size of batch of documents to insert at once.
+
+        Returns:
+            List[str]: List of IDs of the added texts.
+        """
+
+        try:
+            import pandas as pd
+        except ImportError:
+            raise ImportError(
+                "Could not import pandas python package. "
+                "Please install it with `pip install pandas`."
+            )
+
+        texts = [x.page_content for x in documents]
+        metadata = pd.DataFrame([x.metadata for x in documents])
+        return self.add_texts(texts, metadata=metadata, batch_size=batch_size)
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 1,
+        filter: Optional[List] = [],
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search with distance from a query string.
+
+        Args:
+            query (str): Query string.
+            k (Optional[int]): number of neighbors to retrieve.
+            filter (Optional[List]): KDB.AI metadata filter clause: https://code.kx.com/kdbai/use/filter.html
+
+        Returns:
+            List[Document]: List of similar documents.
+        """
+        return self.similarity_search_by_vector_with_score(
+            self._embed_query(query), k=k, filter=filter, **kwargs
+        )
+
+    def similarity_search_by_vector_with_score(
+        self,
+        embedding: List[float],
+        *,
+        k: int = 1,
+        filter: Optional[List] = [],
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return documents most similar to embedding, along with scores.
+
+        Args:
+            embedding (List[float]): query vector.
+            k (Optional[int]): number of neighbors to retrieve.
+            filter (Optional[List]): KDB.AI metadata filter clause: https://code.kx.com/kdbai/use/filter.html
+
+        Returns:
+            List[Document]: List of similar documents.
+        """
+        if "n" in kwargs:
+            k = kwargs.pop("n")
+        matches = self._table.search(vectors=[embedding], n=k, filter=filter, **kwargs)
+        docs: list = []
+        if isinstance(matches, list):
+            matches = matches[0]
+        else:
+            return docs
+        for row in matches.to_dict(orient="records"):
+            text = row.pop("text")
+            score = row.pop("__nn_distance")
+            docs.append(
+                (
+                    Document(
+                        page_content=text,
+                        metadata={k: v for k, v in row.items() if k != "text"},
+                    ),
+                    score,
+                )
+            )
+        return docs
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 1,
+        filter: Optional[List] = [],
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search from a query string.
+
+        Args:
+            query (str): Query string.
+            k (Optional[int]): number of neighbors to retrieve.
+            filter (Optional[List]): KDB.AI metadata filter clause: https://code.kx.com/kdbai/use/filter.html
+
+        Returns:
+            List[Document]: List of similar documents.
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query, k=k, filter=filter, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    @classmethod
+    def from_texts(
+        cls: Any,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Not implemented."""
+        raise Exception("Not implemented.")
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/kinetica.py b/llm/Lib/site-packages/langchain_community/vectorstores/kinetica.py
new file mode 100644
index 0000000000000000000000000000000000000000..c25256883440209aa2f4b7be3e0de90dde98f268
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/kinetica.py
@@ -0,0 +1,919 @@
+from __future__ import annotations
+
+import asyncio
+import enum
+import json
+import logging
+import struct
+import uuid
+from collections import OrderedDict
+from enum import Enum
+from functools import partial
+from typing import Any, Callable, Dict, Iterable, List, Optional, Tuple, Type
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseSettings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+
+class DistanceStrategy(str, enum.Enum):
+    """Enumerator of the Distance strategies."""
+
+    EUCLIDEAN = "l2"
+    COSINE = "cosine"
+    MAX_INNER_PRODUCT = "inner"
+
+
+def _results_to_docs(docs_and_scores: Any) -> List[Document]:
+    """Return docs from docs and scores."""
+    return [doc for doc, _ in docs_and_scores]
+
+
+class Dimension(int, Enum):
+    """Some default dimensions for known embeddings."""
+
+    OPENAI = 1536
+
+
+DEFAULT_DISTANCE_STRATEGY = DistanceStrategy.EUCLIDEAN
+
+_LANGCHAIN_DEFAULT_SCHEMA_NAME = "langchain"  ## Default Kinetica schema name
+_LANGCHAIN_DEFAULT_COLLECTION_NAME = (
+    "langchain_kinetica_embeddings"  ## Default Kinetica table name
+)
+
+
+class KineticaSettings(BaseSettings):
+    """`Kinetica` client configuration.
+
+    Attribute:
+        host (str) : An URL to connect to MyScale backend.
+                             Defaults to 'localhost'.
+        port (int) : URL port to connect with HTTP. Defaults to 8443.
+        username (str) : Username to login. Defaults to None.
+        password (str) : Password to login. Defaults to None.
+        database (str) : Database name to find the table. Defaults to 'default'.
+        table (str) : Table name to operate on.
+                      Defaults to 'vector_table'.
+        metric (str) : Metric to compute distance,
+                       supported are ('angular', 'euclidean', 'manhattan', 'hamming',
+                       'dot'). Defaults to 'angular'.
+                       https://github.com/spotify/annoy/blob/main/src/annoymodule.cc#L149-L169
+
+    """
+
+    host: str = "http://127.0.0.1"
+    port: int = 9191
+
+    username: Optional[str] = None
+    password: Optional[str] = None
+
+    database: str = _LANGCHAIN_DEFAULT_SCHEMA_NAME
+    table: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME
+    metric: str = DEFAULT_DISTANCE_STRATEGY.value
+
+    def __getitem__(self, item: str) -> Any:
+        return getattr(self, item)
+
+    class Config:
+        env_file = ".env"
+        env_prefix = "kinetica_"
+        env_file_encoding = "utf-8"
+
+
+class Kinetica(VectorStore):
+    """`Kinetica` vector store.
+
+    To use, you should have the ``gpudb`` python package installed.
+
+    Args:
+        kinetica_settings: Kinetica connection settings class.
+        embedding_function: Any embedding function implementing
+            `langchain.embeddings.base.Embeddings` interface.
+        collection_name: The name of the collection to use. (default: langchain)
+            NOTE: This is not the name of the table, but the name of the collection.
+            The tables will be created when initializing the store (if not exists)
+            So, make sure the user has the right permissions to create tables.
+        distance_strategy: The distance strategy to use. (default: COSINE)
+        pre_delete_collection: If True, will delete the collection if it exists.
+            (default: False). Useful for testing.
+        engine_args: SQLAlchemy's create engine arguments.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import Kinetica, KineticaSettings
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+            kinetica_settings = KineticaSettings(
+                host="http://127.0.0.1", username="", password=""
+                )
+            COLLECTION_NAME = "kinetica_store"
+            embeddings = OpenAIEmbeddings()
+            vectorstore = Kinetica.from_documents(
+                documents=docs,
+                embedding=embeddings,
+                collection_name=COLLECTION_NAME,
+                config=kinetica_settings,
+            )
+    """
+
+    def __init__(
+        self,
+        config: KineticaSettings,
+        embedding_function: Embeddings,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        schema_name: str = _LANGCHAIN_DEFAULT_SCHEMA_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        pre_delete_collection: bool = False,
+        logger: Optional[logging.Logger] = None,
+        relevance_score_fn: Optional[Callable[[float], float]] = None,
+    ) -> None:
+        """Constructor for the Kinetica class
+
+        Args:
+            config (KineticaSettings): a `KineticaSettings` instance
+            embedding_function (Embeddings): embedding function to use
+            collection_name (str, optional): the Kinetica table name.
+                            Defaults to _LANGCHAIN_DEFAULT_COLLECTION_NAME.
+            schema_name (str, optional): the Kinetica table name.
+                            Defaults to _LANGCHAIN_DEFAULT_SCHEMA_NAME.
+            distance_strategy (DistanceStrategy, optional): _description_.
+                            Defaults to DEFAULT_DISTANCE_STRATEGY.
+            pre_delete_collection (bool, optional): _description_. Defaults to False.
+            logger (Optional[logging.Logger], optional): _description_.
+                            Defaults to None.
+        """
+
+        self._config = config
+        self.embedding_function = embedding_function
+        self.collection_name = collection_name
+        self.schema_name = schema_name
+        self._distance_strategy = distance_strategy
+        self.pre_delete_collection = pre_delete_collection
+        self.logger = logger or logging.getLogger(__name__)
+        self.override_relevance_score_fn = relevance_score_fn
+        self._db = self.__get_db(self._config)
+
+    def __post_init__(self, dimensions: int) -> None:
+        """
+        Initialize the store.
+        """
+        try:
+            from gpudb import GPUdbTable
+        except ImportError:
+            raise ImportError(
+                "Could not import Kinetica python API. "
+                "Please install it with `pip install gpudb==7.2.0.1`."
+            )
+
+        self.dimensions = dimensions
+        dimension_field = f"vector({dimensions})"
+
+        if self.pre_delete_collection:
+            self.delete_schema()
+
+        self.table_name = self.collection_name
+        if self.schema_name is not None and len(self.schema_name) > 0:
+            self.table_name = f"{self.schema_name}.{self.collection_name}"
+
+        self.table_schema = [
+            ["text", "string"],
+            ["embedding", "bytes", dimension_field],
+            ["metadata", "string", "json"],
+            ["id", "string", "uuid"],
+        ]
+
+        self.create_schema()
+        self.EmbeddingStore: GPUdbTable = self.create_tables_if_not_exists()
+
+    def __get_db(self, config: KineticaSettings) -> Any:
+        try:
+            from gpudb import GPUdb
+        except ImportError:
+            raise ImportError(
+                "Could not import Kinetica python API. "
+                "Please install it with `pip install gpudb==7.2.0.1`."
+            )
+
+        options = GPUdb.Options()
+        options.username = config.username
+        options.password = config.password
+        options.skip_ssl_cert_verification = True
+        return GPUdb(host=config.host, options=options)
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding_function
+
+    @classmethod
+    def __from(
+        cls,
+        config: KineticaSettings,
+        texts: List[str],
+        embeddings: List[List[float]],
+        embedding: Embeddings,
+        dimensions: int,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        pre_delete_collection: bool = False,
+        logger: Optional[logging.Logger] = None,
+        **kwargs: Any,
+    ) -> Kinetica:
+        """Class method to assist in constructing the `Kinetica` store instance
+            using different combinations of parameters
+
+        Args:
+            config (KineticaSettings): a `KineticaSettings` instance
+            texts (List[str]): The list of texts to generate embeddings for and store
+            embeddings (List[List[float]]): List of embeddings
+            embedding (Embeddings): the Embedding function
+            dimensions (int): The number of dimensions the embeddings have
+            metadatas (Optional[List[dict]], optional): List of JSON data associated
+                        with each text. Defaults to None.
+            ids (Optional[List[str]], optional): List of unique IDs (UUID by default)
+                        associated with each text. Defaults to None.
+            collection_name (str, optional): Kinetica schema name.
+                        Defaults to _LANGCHAIN_DEFAULT_COLLECTION_NAME.
+            distance_strategy (DistanceStrategy, optional): Not used for now.
+                        Defaults to DEFAULT_DISTANCE_STRATEGY.
+            pre_delete_collection (bool, optional): Whether to delete the Kinetica
+                        schema or not. Defaults to False.
+            logger (Optional[logging.Logger], optional): Logger to use for logging at
+                        different levels. Defaults to None.
+
+        Returns:
+            Kinetica: An instance of Kinetica class
+        """
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        store = cls(
+            config=config,
+            collection_name=collection_name,
+            embedding_function=embedding,
+            # dimensions=dimensions,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+            logger=logger,
+            **kwargs,
+        )
+
+        store.__post_init__(dimensions)
+
+        store.add_embeddings(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+        return store
+
+    def create_tables_if_not_exists(self) -> Any:
+        """Create the table to store the texts and embeddings"""
+
+        try:
+            from gpudb import GPUdbTable
+        except ImportError:
+            raise ImportError(
+                "Could not import Kinetica python API. "
+                "Please install it with `pip install gpudb==7.2.0.1`."
+            )
+        return GPUdbTable(
+            _type=self.table_schema,
+            name=self.table_name,
+            db=self._db,
+            options={"is_replicated": "true"},
+        )
+
+    def drop_tables(self) -> None:
+        """Delete the table"""
+        self._db.clear_table(
+            f"{self.table_name}", options={"no_error_if_not_exists": "true"}
+        )
+
+    def create_schema(self) -> None:
+        """Create a new Kinetica schema"""
+        self._db.create_schema(self.schema_name)
+
+    def delete_schema(self) -> None:
+        """Delete a Kinetica schema with cascade set to `true`
+        This method will delete a schema with all tables in it.
+        """
+        self.logger.debug("Trying to delete collection")
+        self._db.drop_schema(
+            self.schema_name, {"no_error_if_not_exists": "true", "cascade": "true"}
+        )
+
+    def add_embeddings(
+        self,
+        texts: Iterable[str],
+        embeddings: List[List[float]],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add embeddings to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            embeddings: List of list of embedding vectors.
+            metadatas: List of metadatas associated with the texts.
+            ids: List of ids for the text embedding pairs
+            kwargs: vectorstore specific parameters
+        """
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        records = []
+        for text, embedding, metadata, id in zip(texts, embeddings, metadatas, ids):
+            buf = struct.pack("%sf" % self.dimensions, *embedding)
+            records.append([text, buf, json.dumps(metadata), id])
+
+        self.EmbeddingStore.insert_records(records)
+
+        return ids
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas (JSON data) associated with the texts.
+            ids: List of IDs (UUID) for the texts supplied; will be generated if None
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        embeddings = self.embedding_function.embed_documents(list(texts))
+        self.dimensions = len(embeddings[0])
+        if not hasattr(self, "EmbeddingStore"):
+            self.__post_init__(self.dimensions)
+        return self.add_embeddings(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search with Kinetica with distance.
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        embedding = self.embedding_function.embed_query(text=query)
+        return self.similarity_search_by_vector(
+            embedding=embedding,
+            k=k,
+            filter=filter,
+        )
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        embedding = self.embedding_function.embed_query(query)
+        docs = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return docs
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[dict] = None,
+    ) -> List[Tuple[Document, float]]:
+        resp: Dict = self.__query_collection(embedding, k, filter)
+
+        records: OrderedDict = resp["records"]
+        results = list(zip(*list(records.values())))
+
+        return self._results_to_docs_and_scores(results)
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def _results_to_docs_and_scores(self, results: Any) -> List[Tuple[Document, float]]:
+        """Return docs and scores from results."""
+        docs = [
+            (
+                Document(
+                    page_content=result[0],
+                    metadata=json.loads(result[1]),
+                ),
+                result[2] if self.embedding_function is not None else None,
+            )
+            for result in results
+        ]
+        return docs
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+        """
+        if self.override_relevance_score_fn is not None:
+            return self.override_relevance_score_fn
+
+        # Default strategy is to rely on distance strategy provided
+        # in vectorstore constructor
+        if self._distance_strategy == DistanceStrategy.COSINE:
+            return self._cosine_relevance_score_fn
+        elif self._distance_strategy == DistanceStrategy.EUCLIDEAN:
+            return self._euclidean_relevance_score_fn
+        elif self._distance_strategy == DistanceStrategy.MAX_INNER_PRODUCT:
+            return self._max_inner_product_relevance_score_fn
+        else:
+            raise ValueError(
+                "No supported normalization function"
+                f" for distance_strategy of {self._distance_strategy}."
+                "Consider providing relevance_score_fn to Kinetica constructor."
+            )
+
+    @property
+    def distance_strategy(self) -> str:
+        if self._distance_strategy == DistanceStrategy.EUCLIDEAN:
+            return "l2_distance"
+        elif self._distance_strategy == DistanceStrategy.COSINE:
+            return "cosine_distance"
+        elif self._distance_strategy == DistanceStrategy.MAX_INNER_PRODUCT:
+            return "dot_product"
+        else:
+            raise ValueError(
+                f"Got unexpected value for distance: {self._distance_strategy}. "
+                f"Should be one of {', '.join([ds.value for ds in DistanceStrategy])}."
+            )
+
+    def __query_collection(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, str]] = None,
+    ) -> Dict:
+        """Query the collection."""
+        # if filter is not None:
+        #     filter_clauses = []
+        #     for key, value in filter.items():
+        #         IN = "in"
+        #         if isinstance(value, dict) and IN in map(str.lower, value):
+        #             value_case_insensitive = {
+        #                 k.lower(): v for k, v in value.items()
+        #             }
+        #             filter_by_metadata = self.EmbeddingStore.cmetadata[
+        #                 key
+        #             ].astext.in_(value_case_insensitive[IN])
+        #             filter_clauses.append(filter_by_metadata)
+        #         else:
+        #             filter_by_metadata = self.EmbeddingStore.cmetadata[
+        #                 key
+        #             ].astext == str(value)
+        #             filter_clauses.append(filter_by_metadata)
+
+        json_filter = json.dumps(filter) if filter is not None else None
+        where_clause = (
+            f" where '{json_filter}' = JSON(metadata) "
+            if json_filter is not None
+            else ""
+        )
+
+        embedding_str = "[" + ",".join([str(x) for x in embedding]) + "]"
+
+        dist_strategy = self.distance_strategy
+
+        query_string = f"""
+                SELECT text, metadata, {dist_strategy}(embedding, '{embedding_str}') 
+                as distance, embedding
+                FROM {self.table_name}
+                {where_clause}
+                ORDER BY distance asc NULLS LAST
+                LIMIT {k}
+        """
+
+        self.logger.debug(query_string)
+        resp = self._db.execute_sql_and_decode(query_string)
+        self.logger.debug(resp)
+        return resp
+
+    def max_marginal_relevance_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs selected using the maximal marginal relevance with score
+            to embedding vector.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Tuple[Document, float]]: List of Documents selected by maximal marginal
+                relevance to the query and score for each.
+        """
+        resp = self.__query_collection(embedding=embedding, k=fetch_k, filter=filter)
+        records: OrderedDict = resp["records"]
+        results = list(zip(*list(records.values())))
+
+        embedding_list = [
+            struct.unpack("%sf" % self.dimensions, embedding)
+            for embedding in records["embedding"]
+        ]
+
+        mmr_selected = maximal_marginal_relevance(
+            np.array(embedding, dtype=np.float32),
+            embedding_list,
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+
+        candidates = self._results_to_docs_and_scores(results)
+
+        return [r for i, r in enumerate(candidates) if i in mmr_selected]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            query (str): Text to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Document]: List of Documents selected by maximal marginal relevance.
+        """
+        embedding = self.embedding_function.embed_query(query)
+        return self.max_marginal_relevance_search_by_vector(
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+
+    def max_marginal_relevance_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs selected using the maximal marginal relevance with score.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            query (str): Text to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Tuple[Document, float]]: List of Documents selected by maximal marginal
+                relevance to the query and score for each.
+        """
+        embedding = self.embedding_function.embed_query(query)
+        docs = self.max_marginal_relevance_search_with_score_by_vector(
+            embedding=embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+        return docs
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance
+            to embedding vector.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            embedding (str): Text to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Document]: List of Documents selected by maximal marginal relevance.
+        """
+        docs_and_scores = self.max_marginal_relevance_search_with_score_by_vector(
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+
+        return _results_to_docs(docs_and_scores)
+
+    async def amax_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance."""
+
+        # This is a temporary workaround to make the similarity search
+        # asynchronous. The proper solution is to make the similarity search
+        # asynchronous in the vector store implementations.
+        func = partial(
+            self.max_marginal_relevance_search_by_vector,
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+        return await asyncio.get_event_loop().run_in_executor(None, func)
+
+    @classmethod
+    def from_texts(
+        cls: Type[Kinetica],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        config: KineticaSettings = KineticaSettings(),
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> Kinetica:
+        """Adds the texts passed in to the vector store and returns it
+
+        Args:
+            cls (Type[Kinetica]): Kinetica class
+            texts (List[str]): A list of texts for which the embeddings are generated
+            embedding (Embeddings): List of embeddings
+            metadatas (Optional[List[dict]], optional): List of dicts, JSON
+                        describing the texts/documents. Defaults to None.
+            config (KineticaSettings): a `KineticaSettings` instance
+            collection_name (str, optional): Kinetica schema name.
+                        Defaults to _LANGCHAIN_DEFAULT_COLLECTION_NAME.
+            distance_strategy (DistanceStrategy, optional): Distance strategy
+                        e.g., l2, cosine etc.. Defaults to DEFAULT_DISTANCE_STRATEGY.
+            ids (Optional[List[str]], optional): A list of UUIDs for each
+                        text/document. Defaults to None.
+            pre_delete_collection (bool, optional): Indicates whether the Kinetica
+                        schema is to be deleted or not. Defaults to False.
+
+        Returns:
+            Kinetica: a `Kinetica` instance
+        """
+
+        if len(texts) == 0:
+            raise ValueError("texts is empty")
+
+        try:
+            first_embedding = embedding.embed_documents(texts[0:1])
+        except NotImplementedError:
+            first_embedding = [embedding.embed_query(texts[0])]
+
+        dimensions = len(first_embedding[0])
+        embeddings = embedding.embed_documents(list(texts))
+
+        kinetica_store = cls.__from(
+            texts=texts,
+            embeddings=embeddings,
+            embedding=embedding,
+            dimensions=dimensions,
+            config=config,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+            **kwargs,
+        )
+
+        return kinetica_store
+
+    @classmethod
+    def from_embeddings(
+        cls: Type[Kinetica],
+        text_embeddings: List[Tuple[str, List[float]]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        config: KineticaSettings = KineticaSettings(),
+        dimensions: int = Dimension.OPENAI,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> Kinetica:
+        """Adds the embeddings passed in to the vector store and returns it
+
+        Args:
+            cls (Type[Kinetica]): Kinetica class
+            text_embeddings (List[Tuple[str, List[float]]]): A list of texts
+                            and the embeddings
+            embedding (Embeddings): List of embeddings
+            metadatas (Optional[List[dict]], optional): List of dicts, JSON describing
+                        the texts/documents. Defaults to None.
+            config (KineticaSettings): a `KineticaSettings` instance
+            dimensions (int, optional): Dimension for the vector data, if not passed a
+                        default will be used. Defaults to Dimension.OPENAI.
+            collection_name (str, optional): Kinetica schema name.
+                        Defaults to _LANGCHAIN_DEFAULT_COLLECTION_NAME.
+            distance_strategy (DistanceStrategy, optional): Distance strategy
+                        e.g., l2, cosine etc.. Defaults to DEFAULT_DISTANCE_STRATEGY.
+            ids (Optional[List[str]], optional): A list of UUIDs for each text/document.
+                        Defaults to None.
+            pre_delete_collection (bool, optional): Indicates whether the
+                        Kinetica schema is to be deleted or not. Defaults to False.
+
+        Returns:
+            Kinetica: a `Kinetica` instance
+        """
+
+        texts = [t[0] for t in text_embeddings]
+        embeddings = [t[1] for t in text_embeddings]
+        dimensions = len(embeddings[0])
+
+        return cls.__from(
+            texts=texts,
+            embeddings=embeddings,
+            embedding=embedding,
+            dimensions=dimensions,
+            config=config,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_documents(
+        cls: Type[Kinetica],
+        documents: List[Document],
+        embedding: Embeddings,
+        config: KineticaSettings = KineticaSettings(),
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> Kinetica:
+        """Adds the list of `Document` passed in to the vector store and returns it
+
+        Args:
+            cls (Type[Kinetica]): Kinetica class
+            texts (List[str]): A list of texts for which the embeddings are generated
+            embedding (Embeddings): List of embeddings
+            config (KineticaSettings): a `KineticaSettings` instance
+            metadatas (Optional[List[dict]], optional): List of dicts, JSON describing
+                        the texts/documents. Defaults to None.
+            collection_name (str, optional): Kinetica schema name.
+                        Defaults to _LANGCHAIN_DEFAULT_COLLECTION_NAME.
+            distance_strategy (DistanceStrategy, optional): Distance strategy
+                        e.g., l2, cosine etc.. Defaults to DEFAULT_DISTANCE_STRATEGY.
+            ids (Optional[List[str]], optional): A list of UUIDs for each text/document.
+                        Defaults to None.
+            pre_delete_collection (bool, optional): Indicates whether the Kinetica
+                        schema is to be deleted or not. Defaults to False.
+
+        Returns:
+            Kinetica: a `Kinetica` instance
+        """
+
+        texts = [d.page_content for d in documents]
+        metadatas = [d.metadata for d in documents]
+
+        return cls.from_texts(
+            texts=texts,
+            embedding=embedding,
+            metadatas=metadatas,
+            config=config,
+            collection_name=collection_name,
+            distance_strategy=distance_strategy,
+            ids=ids,
+            pre_delete_collection=pre_delete_collection,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/lancedb.py b/llm/Lib/site-packages/langchain_community/vectorstores/lancedb.py
new file mode 100644
index 0000000000000000000000000000000000000000..414517793ee44d6babc387267aa1454281abb330
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/lancedb.py
@@ -0,0 +1,186 @@
+from __future__ import annotations
+
+import uuid
+from typing import Any, Iterable, List, Optional
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+
+class LanceDB(VectorStore):
+    """`LanceDB` vector store.
+
+    To use, you should have ``lancedb`` python package installed.
+    You can install it with ``pip install lancedb``.
+
+    Args:
+        connection: LanceDB connection to use. If not provided, a new connection
+                    will be created.
+        embedding: Embedding to use for the vectorstore.
+        vector_key: Key to use for the vector in the database. Defaults to ``vector``.
+        id_key: Key to use for the id in the database. Defaults to ``id``.
+        text_key: Key to use for the text in the database. Defaults to ``text``.
+        table_name: Name of the table to use. Defaults to ``vectorstore``.
+
+
+
+    Example:
+        .. code-block:: python
+
+            db = lancedb.connect('./lancedb')
+            table = db.open_table('my_table')
+            vectorstore = LanceDB(table, embedding_function)
+            vectorstore.add_texts(['text1', 'text2'])
+            result = vectorstore.similarity_search('text1')
+    """
+
+    def __init__(
+        self,
+        connection: Optional[Any] = None,
+        embedding: Optional[Embeddings] = None,
+        vector_key: Optional[str] = "vector",
+        id_key: Optional[str] = "id",
+        text_key: Optional[str] = "text",
+        table_name: Optional[str] = "vectorstore",
+    ):
+        """Initialize with Lance DB vectorstore"""
+        try:
+            import lancedb
+        except ImportError:
+            raise ImportError(
+                "Could not import lancedb python package. "
+                "Please install it with `pip install lancedb`."
+            )
+        self.lancedb = lancedb
+        self._embedding = embedding
+        self._vector_key = vector_key
+        self._id_key = id_key
+        self._text_key = text_key
+        self._table_name = table_name
+
+        if self._embedding is None:
+            raise ValueError("embedding should be provided")
+
+        if connection is not None:
+            if not isinstance(connection, lancedb.db.LanceTable):
+                raise ValueError(
+                    "connection should be an instance of lancedb.db.LanceTable, ",
+                    f"got {type(connection)}",
+                )
+            self._connection = connection
+        else:
+            self._connection = self._init_table()
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self._embedding
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Turn texts into embedding and add it to the database
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of ids to associate with the texts.
+
+        Returns:
+            List of ids of the added texts.
+        """
+        # Embed texts and create documents
+        docs = []
+        ids = ids or [str(uuid.uuid4()) for _ in texts]
+        embeddings = self._embedding.embed_documents(list(texts))  # type: ignore
+        for idx, text in enumerate(texts):
+            embedding = embeddings[idx]
+            metadata = metadatas[idx] if metadatas else {}
+            docs.append(
+                {
+                    self._vector_key: embedding,
+                    self._id_key: ids[idx],
+                    self._text_key: text,
+                    **metadata,
+                }
+            )
+        self._connection.add(docs)
+        return ids
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return documents most similar to the query
+
+        Args:
+            query: String to query the vectorstore with.
+            k: Number of documents to return.
+
+        Returns:
+            List of documents most similar to the query.
+        """
+        embedding = self._embedding.embed_query(query)  # type: ignore
+        docs = (
+            self._connection.search(embedding, vector_column_name=self._vector_key)
+            .limit(k)
+            .to_arrow()
+        )
+        columns = docs.schema.names
+        return [
+            Document(
+                page_content=docs[self._text_key][idx].as_py(),
+                metadata={
+                    col: docs[col][idx].as_py()
+                    for col in columns
+                    if col != self._text_key
+                },
+            )
+            for idx in range(len(docs))
+        ]
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        connection: Any = None,
+        vector_key: Optional[str] = "vector",
+        id_key: Optional[str] = "id",
+        text_key: Optional[str] = "text",
+        **kwargs: Any,
+    ) -> LanceDB:
+        instance = LanceDB(
+            connection,
+            embedding,
+            vector_key,
+            id_key,
+            text_key,
+        )
+        instance.add_texts(texts, metadatas=metadatas, **kwargs)
+
+        return instance
+
+    def _init_table(self) -> Any:
+        import pyarrow as pa
+
+        schema = pa.schema(
+            [
+                pa.field(
+                    self._vector_key,
+                    pa.list_(
+                        pa.float32(),
+                        len(self.embeddings.embed_query("test")),  # type: ignore
+                    ),
+                ),
+                pa.field(self._id_key, pa.string()),
+                pa.field(self._text_key, pa.string()),
+            ]
+        )
+        db = self.lancedb.connect("/tmp/lancedb")
+        tbl = db.create_table(self._table_name, schema=schema, mode="overwrite")
+        return tbl
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/lantern.py b/llm/Lib/site-packages/langchain_community/vectorstores/lantern.py
new file mode 100644
index 0000000000000000000000000000000000000000..75e4d012ae5b4e1fe58541acad47fce1e20d1ebc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/lantern.py
@@ -0,0 +1,1020 @@
+from __future__ import annotations
+
+import contextlib
+import enum
+import logging
+import uuid
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Generator,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+import numpy as np
+import sqlalchemy
+from sqlalchemy import delete, func
+from sqlalchemy.dialects.postgresql import JSON, UUID
+from sqlalchemy.exc import ProgrammingError
+from sqlalchemy.orm import Session
+from sqlalchemy.sql import quoted_name
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+try:
+    from sqlalchemy.orm import declarative_base
+except ImportError:
+    from sqlalchemy.ext.declarative import declarative_base
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_dict_or_env
+from langchain_core.vectorstores import VectorStore
+
+ADA_TOKEN_COUNT = 1536
+_LANGCHAIN_DEFAULT_COLLECTION_NAME = "langchain"
+
+
+def _results_to_docs(docs_and_scores: Any) -> List[Document]:
+    """Return docs from docs and scores."""
+    return [doc for doc, _ in docs_and_scores]
+
+
+class BaseEmbeddingStore:
+    """Base class for the Lantern embedding store."""
+
+
+def get_embedding_store(
+    distance_strategy: DistanceStrategy, collection_name: str
+) -> Any:
+    """Get the embedding store class."""
+
+    embedding_type = None
+
+    if distance_strategy == DistanceStrategy.HAMMING:
+        embedding_type = sqlalchemy.INTEGER  # type: ignore
+    else:
+        embedding_type = sqlalchemy.REAL  # type: ignore
+
+    DynamicBase = declarative_base(class_registry=dict())  # type: Any
+
+    class EmbeddingStore(DynamicBase, BaseEmbeddingStore):
+        __tablename__ = collection_name
+        uuid = sqlalchemy.Column(
+            UUID(as_uuid=True), primary_key=True, default=uuid.uuid4
+        )
+        __table_args__ = {"extend_existing": True}
+        document = sqlalchemy.Column(sqlalchemy.String, nullable=True)
+        cmetadata = sqlalchemy.Column(JSON, nullable=True)
+        # custom_id : any user defined id
+        custom_id = sqlalchemy.Column(sqlalchemy.String, nullable=True)
+        embedding = sqlalchemy.Column(sqlalchemy.ARRAY(embedding_type))  # type: ignore
+
+    return EmbeddingStore
+
+
+class QueryResult:
+    """Result from a query."""
+
+    EmbeddingStore: BaseEmbeddingStore
+    distance: float
+
+
+class DistanceStrategy(str, enum.Enum):
+    """Enumerator of the Distance strategies."""
+
+    EUCLIDEAN = "l2sq"
+    COSINE = "cosine"
+    HAMMING = "hamming"
+
+
+DEFAULT_DISTANCE_STRATEGY = DistanceStrategy.COSINE
+
+
+class Lantern(VectorStore):
+    """`Postgres` with the `lantern` extension as a vector store.
+
+    lantern uses sequential scan by default. but you can create a HNSW index
+    using the create_hnsw_index method.
+    - `connection_string` is a postgres connection string.
+    - `embedding_function` any embedding function implementing
+        `langchain.embeddings.base.Embeddings` interface.
+    - `collection_name` is the name of the collection to use. (default: langchain)
+        - NOTE: This is the name of the table in which embedding data will be stored
+            The table will be created when initializing the store (if not exists)
+            So, make sure the user has the right permissions to create tables.
+    - `distance_strategy` is the distance strategy to use. (default: EUCLIDEAN)
+        - `EUCLIDEAN` is the euclidean distance.
+        - `COSINE` is the cosine distance.
+        - `HAMMING` is the hamming distance.
+    - `pre_delete_collection` if True, will delete the collection if it exists.
+        (default: False)
+        - Useful for testing.
+    """
+
+    def __init__(
+        self,
+        connection_string: str,
+        embedding_function: Embeddings,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        collection_metadata: Optional[dict] = None,
+        pre_delete_collection: bool = False,
+        logger: Optional[logging.Logger] = None,
+        relevance_score_fn: Optional[Callable[[float], float]] = None,
+    ) -> None:
+        self.connection_string = connection_string
+        self.embedding_function = embedding_function
+        self.collection_name = collection_name
+        self.collection_metadata = collection_metadata
+        self._distance_strategy = distance_strategy
+        self.pre_delete_collection = pre_delete_collection
+        self.logger = logger or logging.getLogger(__name__)
+        self.override_relevance_score_fn = relevance_score_fn
+        self.EmbeddingStore = get_embedding_store(
+            self.distance_strategy, collection_name
+        )
+        self.__post_init__()
+
+    def __post_init__(
+        self,
+    ) -> None:
+        self._conn = self.connect()
+        self.create_hnsw_extension()
+        self.create_collection()
+
+    @property
+    def distance_strategy(self) -> DistanceStrategy:
+        if isinstance(self._distance_strategy, DistanceStrategy):
+            return self._distance_strategy
+
+        if self._distance_strategy == DistanceStrategy.EUCLIDEAN.value:
+            return DistanceStrategy.EUCLIDEAN
+        elif self._distance_strategy == DistanceStrategy.COSINE.value:
+            return DistanceStrategy.COSINE
+        elif self._distance_strategy == DistanceStrategy.HAMMING.value:
+            return DistanceStrategy.HAMMING
+        else:
+            raise ValueError(
+                f"Got unexpected value for distance: {self._distance_strategy}. "
+                f"Should be one of {', '.join([ds.value for ds in DistanceStrategy])}."
+            )
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding_function
+
+    @classmethod
+    def connection_string_from_db_params(
+        cls,
+        driver: str,
+        host: str,
+        port: int,
+        database: str,
+        user: str,
+        password: str,
+    ) -> str:
+        """Return connection string from database parameters."""
+        return f"postgresql+{driver}://{user}:{password}@{host}:{port}/{database}"
+
+    def connect(self) -> sqlalchemy.engine.Connection:
+        engine = sqlalchemy.create_engine(self.connection_string)
+        conn = engine.connect()
+        return conn
+
+    @property
+    def distance_function(self) -> Any:
+        if self.distance_strategy == DistanceStrategy.EUCLIDEAN:
+            return "l2sq_dist"
+        elif self.distance_strategy == DistanceStrategy.COSINE:
+            return "cos_dist"
+        elif self.distance_strategy == DistanceStrategy.HAMMING:
+            return "hamming_dist"
+
+    def create_hnsw_extension(self) -> None:
+        try:
+            with Session(self._conn) as session:
+                statement = sqlalchemy.text("CREATE EXTENSION IF NOT EXISTS lantern")
+                session.execute(statement)
+                session.commit()
+        except Exception as e:
+            self.logger.exception(e)
+
+    def create_tables_if_not_exists(self) -> None:
+        try:
+            self.create_collection()
+        except ProgrammingError:
+            pass
+
+    def drop_table(self) -> None:
+        try:
+            self.EmbeddingStore.__table__.drop(self._conn.engine)
+        except ProgrammingError:
+            pass
+
+    def drop_tables(self) -> None:
+        self.drop_table()
+
+    def _hamming_relevance_score_fn(self, distance: float) -> float:
+        return distance
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+        """
+        if self.override_relevance_score_fn is not None:
+            return self.override_relevance_score_fn
+
+        # Default strategy is to rely on distance strategy provided
+        # in vectorstore constructor
+        if self.distance_strategy == DistanceStrategy.COSINE:
+            return self._cosine_relevance_score_fn
+        elif self.distance_strategy == DistanceStrategy.EUCLIDEAN:
+            return self._euclidean_relevance_score_fn
+        elif self.distance_strategy == DistanceStrategy.HAMMING:
+            return self._hamming_relevance_score_fn
+        else:
+            raise ValueError(
+                "No supported normalization function"
+                f" for distance_strategy of {self._distance_strategy}."
+                "Consider providing relevance_score_fn to Lantern constructor."
+            )
+
+    def _get_op_class(self) -> str:
+        if self.distance_strategy == DistanceStrategy.COSINE:
+            return "dist_cos_ops"
+        elif self.distance_strategy == DistanceStrategy.EUCLIDEAN:
+            return "dist_l2sq_ops"
+        elif self.distance_strategy == DistanceStrategy.HAMMING:
+            return "dist_hamming_ops"
+        else:
+            raise ValueError(
+                "No supported operator class"
+                f" for distance_strategy of {self._distance_strategy}."
+            )
+
+    def _get_operator(self) -> str:
+        if self.distance_strategy == DistanceStrategy.COSINE:
+            return "<=>"
+        elif self.distance_strategy == DistanceStrategy.EUCLIDEAN:
+            return "<->"
+        elif self.distance_strategy == DistanceStrategy.HAMMING:
+            return "<+>"
+        else:
+            raise ValueError(
+                "No supported operator"
+                f" for distance_strategy of {self._distance_strategy}."
+            )
+
+    def _typed_arg_for_distance(
+        self, embedding: List[Union[float, int]]
+    ) -> List[Union[float, int]]:
+        if self.distance_strategy == DistanceStrategy.HAMMING:
+            return list(map(lambda x: int(x), embedding))
+        return embedding
+
+    @property
+    def _index_name(self) -> str:
+        return f"langchain_{self.collection_name}_idx"
+
+    def create_hnsw_index(
+        self,
+        dims: int = ADA_TOKEN_COUNT,
+        m: int = 16,
+        ef_construction: int = 64,
+        ef_search: int = 64,
+        **_kwargs: Any,
+    ) -> None:
+        """Create HNSW index on collection.
+
+        Optional Keyword Args for HNSW Index:
+            engine: "nmslib", "faiss", "lucene"; default: "nmslib"
+
+            ef: Size of the dynamic list used during k-NN searches. Higher values
+            lead to more accurate but slower searches; default: 64
+
+            ef_construction: Size of the dynamic list used during k-NN graph creation.
+            Higher values lead to more accurate graph but slower indexing speed;
+            default: 64
+
+            m: Number of bidirectional links created for each new element. Large impact
+            on memory consumption. Between 2 and 100; default: 16
+
+            dims: Dimensions of the vectors in collection. default: 1536
+        """
+        create_index_query = sqlalchemy.text(
+            "CREATE INDEX IF NOT EXISTS {} "
+            "ON {} USING hnsw (embedding {}) "
+            "WITH ("
+            "dim = :dim, "
+            "m = :m, "
+            "ef_construction = :ef_construction, "
+            "ef = :ef"
+            ");".format(
+                quoted_name(self._index_name, True),
+                quoted_name(self.collection_name, True),
+                self._get_op_class(),
+            )
+        )
+
+        with Session(self._conn) as session:
+            # Create the HNSW index
+            session.execute(
+                create_index_query,
+                {
+                    "dim": dims,
+                    "m": m,
+                    "ef_construction": ef_construction,
+                    "ef": ef_search,
+                },
+            )
+            session.commit()
+        self.logger.info("HNSW extension and index created successfully.")
+
+    def drop_index(self) -> None:
+        with Session(self._conn) as session:
+            # Drop the HNSW index
+            session.execute(
+                sqlalchemy.text(
+                    "DROP INDEX IF EXISTS {}".format(
+                        quoted_name(self._index_name, True)
+                    )
+                )
+            )
+            session.commit()
+
+    def create_collection(self) -> None:
+        if self.pre_delete_collection:
+            self.delete_collection()
+            self.drop_table()
+
+        with self._conn.begin():
+            try:
+                self.EmbeddingStore.__table__.create(self._conn.engine)
+            except ProgrammingError as e:
+                # Duplicate table
+                if e.code == "f405":
+                    pass
+                else:
+                    raise e
+
+    def delete_collection(self) -> None:
+        self.logger.debug("Trying to delete collection")
+        self.drop_table()
+
+    @contextlib.contextmanager
+    def _make_session(self) -> Generator[Session, None, None]:
+        """Create a context manager for the session, bind to _conn string."""
+        yield Session(self._conn)
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Delete vectors by ids or uuids.
+
+        Args:
+            ids: List of ids to delete.
+        """
+        with Session(self._conn) as session:
+            if ids is not None:
+                self.logger.debug(
+                    "Trying to delete vectors by ids (represented by the model "
+                    "using the custom ids field)"
+                )
+                stmt = delete(self.EmbeddingStore).where(
+                    self.EmbeddingStore.custom_id.in_(ids)
+                )
+                session.execute(stmt)
+            session.commit()
+
+    @classmethod
+    def _initialize_from_embeddings(
+        cls,
+        texts: List[str],
+        embeddings: List[List[float]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> Lantern:
+        """
+        Order of elements for lists `ids`, `embeddings`, `texts`, `metadatas`
+        should match, so each row will be associated with correct values.
+
+        Postgres connection string is required
+        "Either pass it as `connection_string` parameter
+        or set the LANTERN_CONNECTION_STRING environment variable.
+
+        - `texts` texts to insert into collection.
+        - `embeddings` an Embeddings to insert into collection
+        - `embedding` is :class:`Embeddings` that will be used for
+                embedding the text sent. If none is sent, then the
+                multilingual Tensorflow Universal Sentence Encoder will be used.
+        - `metadatas` row metadata to insert into collection.
+        - `ids` row ids to insert into collection.
+        - `collection_name` is the name of the collection to use. (default: langchain)
+            - NOTE: This is the name of the table in which embedding data will be stored
+                The table will be created when initializing the store (if not exists)
+                So, make sure the user has the right permissions to create tables.
+        - `distance_strategy` is the distance strategy to use. (default: EUCLIDEAN)
+            - `EUCLIDEAN` is the euclidean distance.
+            - `COSINE` is the cosine distance.
+            - `HAMMING` is the hamming distance.
+        - `pre_delete_collection` if True, will delete the collection if it exists.
+            (default: False)
+            - Useful for testing.
+        """
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        connection_string = cls.__get_connection_string(kwargs)
+
+        store = cls(
+            connection_string=connection_string,
+            collection_name=collection_name,
+            embedding_function=embedding,
+            pre_delete_collection=pre_delete_collection,
+            distance_strategy=distance_strategy,
+        )
+
+        store.add_embeddings(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+        store.create_hnsw_index(**kwargs)
+
+        return store
+
+    def add_embeddings(
+        self,
+        texts: List[str],
+        embeddings: List[List[float]],
+        metadatas: List[dict],
+        ids: List[str],
+        **kwargs: Any,
+    ) -> None:
+        with Session(self._conn) as session:
+            for text, metadata, embedding, id in zip(texts, metadatas, embeddings, ids):
+                embedding_store = self.EmbeddingStore(
+                    embedding=embedding,
+                    document=text,
+                    cmetadata=metadata,
+                    custom_id=id,
+                )
+                session.add(embedding_store)
+            session.commit()
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        embeddings = self.embedding_function.embed_documents(list(texts))
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        with Session(self._conn) as session:
+            for text, metadata, embedding, id in zip(texts, metadatas, embeddings, ids):
+                embedding_store = self.EmbeddingStore(
+                    embedding=embedding,
+                    document=text,
+                    cmetadata=metadata,
+                    custom_id=id,
+                )
+                session.add(embedding_store)
+            session.commit()
+
+        return ids
+
+    def _results_to_docs_and_scores(self, results: Any) -> List[Tuple[Document, float]]:
+        """Return docs and scores from results."""
+        docs = [
+            (
+                Document(
+                    page_content=result.EmbeddingStore.document,
+                    metadata=result.EmbeddingStore.cmetadata,
+                ),
+                result.distance if self.embedding_function is not None else None,
+            )
+            for result in results
+        ]
+        return docs
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        embedding = self.embedding_function.embed_query(text=query)
+        return self.similarity_search_by_vector(
+            embedding=embedding,
+            k=k,
+            filter=filter,
+        )
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+    ) -> List[Tuple[Document, float]]:
+        embedding = self.embedding_function.embed_query(query)
+        docs = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return docs
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[dict] = None,
+    ) -> List[Tuple[Document, float]]:
+        results = self.__query_collection(embedding=embedding, k=k, filter=filter)
+
+        return self._results_to_docs_and_scores(results)
+
+    def __query_collection(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[dict] = None,
+    ) -> List[Any]:
+        with Session(self._conn) as session:
+            set_enable_seqscan_stmt = sqlalchemy.text("SET enable_seqscan = off")
+            set_init_k = sqlalchemy.text("SET hnsw.init_k = :k")
+            session.execute(set_enable_seqscan_stmt)
+            session.execute(set_init_k, {"k": k})
+
+            filter_by = None
+            if filter is not None:
+                filter_clauses = []
+                for key, value in filter.items():
+                    IN = "in"
+                    if isinstance(value, dict) and IN in map(str.lower, value):
+                        value_case_insensitive = {
+                            k.lower(): v for k, v in value.items()
+                        }
+                        filter_by_metadata = self.EmbeddingStore.cmetadata[
+                            key
+                        ].astext.in_(value_case_insensitive[IN])
+                        filter_clauses.append(filter_by_metadata)
+                    else:
+                        filter_by_metadata = self.EmbeddingStore.cmetadata[
+                            key
+                        ].astext == str(value)
+                        filter_clauses.append(filter_by_metadata)
+
+                filter_by = sqlalchemy.and_(*filter_clauses)
+
+            embedding = self._typed_arg_for_distance(embedding)
+            query = session.query(
+                self.EmbeddingStore,
+                getattr(func, self.distance_function)(
+                    self.EmbeddingStore.embedding, embedding
+                ).label("distance"),
+            )  # Specify the columns you need here, e.g., EmbeddingStore.embedding
+
+            if filter_by is not None:
+                query = query.filter(filter_by)
+
+            results: List[QueryResult] = (
+                query.order_by(
+                    self.EmbeddingStore.embedding.op(self._get_operator())(embedding)
+                )  # Using PostgreSQL specific operator with the correct column name
+                .limit(k)
+                .all()
+            )
+
+        return results
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return _results_to_docs(docs_and_scores)
+
+    @classmethod
+    def from_texts(
+        cls: Type[Lantern],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> Lantern:
+        """
+        Initialize Lantern vectorstore from list of texts.
+        The embeddings will be generated using `embedding` class provided.
+
+        Order of elements for lists `ids`, `texts`, `metadatas` should match,
+        so each row will be associated with correct values.
+
+        Postgres connection string is required
+        "Either pass it as `connection_string` parameter
+        or set the LANTERN_CONNECTION_STRING environment variable.
+
+        - `connection_string` is fully populated connection string for postgres database
+        - `texts` texts to insert into collection.
+        - `embedding` is :class:`Embeddings` that will be used for
+                embedding the text sent. If none is sent, then the
+                multilingual Tensorflow Universal Sentence Encoder will be used.
+        - `metadatas` row metadata to insert into collection.
+        - `collection_name` is the name of the collection to use. (default: langchain)
+            - NOTE: This is the name of the table in which embedding data will be stored
+                The table will be created when initializing the store (if not exists)
+                So, make sure the user has the right permissions to create tables.
+        - `distance_strategy` is the distance strategy to use. (default: EUCLIDEAN)
+            - `EUCLIDEAN` is the euclidean distance.
+            - `COSINE` is the cosine distance.
+            - `HAMMING` is the hamming distance.
+        - `ids` row ids to insert into collection.
+        - `pre_delete_collection` if True, will delete the collection if it exists.
+            (default: False)
+            - Useful for testing.
+        """
+        embeddings = embedding.embed_documents(list(texts))
+
+        return cls._initialize_from_embeddings(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            pre_delete_collection=pre_delete_collection,
+            distance_strategy=distance_strategy,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_embeddings(
+        cls,
+        text_embeddings: List[Tuple[str, List[float]]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        **kwargs: Any,
+    ) -> Lantern:
+        """Construct Lantern wrapper from raw documents and pre-
+        generated embeddings.
+
+        Postgres connection string is required
+        "Either pass it as `connection_string` parameter
+        or set the LANTERN_CONNECTION_STRING environment variable.
+
+        Order of elements for lists `ids`, `text_embeddings`, `metadatas` should match,
+        so each row will be associated with correct values.
+
+        - `connection_string` is fully populated connection string for postgres database
+        - `text_embeddings` is array with tuples (text, embedding)
+                to insert into collection.
+        - `embedding` is :class:`Embeddings` that will be used for
+                embedding the text sent. If none is sent, then the
+                multilingual Tensorflow Universal Sentence Encoder will be used.
+        - `metadatas` row metadata to insert into collection.
+        - `collection_name` is the name of the collection to use. (default: langchain)
+            - NOTE: This is the name of the table in which embedding data will be stored
+                The table will be created when initializing the store (if not exists)
+                So, make sure the user has the right permissions to create tables.
+        - `ids` row ids to insert into collection.
+        - `pre_delete_collection` if True, will delete the collection if it exists.
+            (default: False)
+            - Useful for testing.
+        - `distance_strategy` is the distance strategy to use. (default: EUCLIDEAN)
+            - `EUCLIDEAN` is the euclidean distance.
+            - `COSINE` is the cosine distance.
+            - `HAMMING` is the hamming distance.
+        """
+        texts = [t[0] for t in text_embeddings]
+        embeddings = [t[1] for t in text_embeddings]
+
+        return cls._initialize_from_embeddings(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            pre_delete_collection=pre_delete_collection,
+            distance_strategy=distance_strategy,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_existing_index(
+        cls: Type[Lantern],
+        embedding: Embeddings,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        pre_delete_collection: bool = False,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        **kwargs: Any,
+    ) -> Lantern:
+        """
+        Get instance of an existing Lantern store.This method will
+        return the instance of the store without inserting any new
+        embeddings
+
+        Postgres connection string is required
+        "Either pass it as `connection_string` parameter
+        or set the LANTERN_CONNECTION_STRING environment variable.
+
+        - `connection_string` is a postgres connection string.
+        - `embedding` is :class:`Embeddings` that will be used for
+                embedding the text sent. If none is sent, then the
+                multilingual Tensorflow Universal Sentence Encoder will be used.
+        - `collection_name` is the name of the collection to use. (default: langchain)
+            - NOTE: This is the name of the table in which embedding data will be stored
+                The table will be created when initializing the store (if not exists)
+                So, make sure the user has the right permissions to create tables.
+        - `ids` row ids to insert into collection.
+        - `pre_delete_collection` if True, will delete the collection if it exists.
+            (default: False)
+            - Useful for testing.
+        - `distance_strategy` is the distance strategy to use. (default: EUCLIDEAN)
+            - `EUCLIDEAN` is the euclidean distance.
+            - `COSINE` is the cosine distance.
+            - `HAMMING` is the hamming distance.
+        """
+        connection_string = cls.__get_connection_string(kwargs)
+
+        store = cls(
+            connection_string=connection_string,
+            collection_name=collection_name,
+            embedding_function=embedding,
+            pre_delete_collection=pre_delete_collection,
+            distance_strategy=distance_strategy,
+        )
+
+        return store
+
+    @classmethod
+    def __get_connection_string(cls, kwargs: Dict[str, Any]) -> str:
+        connection_string: str = get_from_dict_or_env(
+            data=kwargs,
+            key="connection_string",
+            env_key="LANTERN_CONNECTION_STRING",
+        )
+
+        if not connection_string:
+            raise ValueError(
+                "Postgres connection string is required"
+                "Either pass it as `connection_string` parameter"
+                "or set the LANTERN_CONNECTION_STRING variable."
+            )
+
+        return connection_string
+
+    @classmethod
+    def from_documents(
+        cls: Type[Lantern],
+        documents: List[Document],
+        embedding: Embeddings,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> Lantern:
+        """
+        Initialize a vector store with a set of documents.
+
+        Postgres connection string is required
+        "Either pass it as `connection_string` parameter
+        or set the LANTERN_CONNECTION_STRING environment variable.
+
+        - `connection_string` is a postgres connection string.
+        - `documents` is list of :class:`Document` to initialize the vector store with
+        - `embedding` is :class:`Embeddings` that will be used for
+                embedding the text sent. If none is sent, then the
+                multilingual Tensorflow Universal Sentence Encoder will be used.
+        - `collection_name` is the name of the collection to use. (default: langchain)
+            - NOTE: This is the name of the table in which embedding data will be stored
+                The table will be created when initializing the store (if not exists)
+                So, make sure the user has the right permissions to create tables.
+        - `distance_strategy` is the distance strategy to use. (default: EUCLIDEAN)
+            - `EUCLIDEAN` is the euclidean distance.
+            - `COSINE` is the cosine distance.
+            - `HAMMING` is the hamming distance.
+        - `ids` row ids to insert into collection.
+        - `pre_delete_collection` if True, will delete the collection if it exists.
+            (default: False)
+            - Useful for testing.
+        """
+        texts = [d.page_content for d in documents]
+        metadatas = [d.metadata for d in documents]
+        connection_string = cls.__get_connection_string(kwargs)
+
+        kwargs["connection_string"] = connection_string
+
+        return cls.from_texts(
+            texts=texts,
+            pre_delete_collection=pre_delete_collection,
+            embedding=embedding,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            distance_strategy=distance_strategy,
+            **kwargs,
+        )
+
+    def max_marginal_relevance_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs selected using the maximal marginal relevance with score
+            to embedding vector.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Tuple[Document, float]]: List of Documents selected by maximal marginal
+                relevance to the query and score for each.
+        """
+        results = self.__query_collection(embedding=embedding, k=fetch_k, filter=filter)
+        embedding_list = [result.EmbeddingStore.embedding for result in results]
+
+        mmr_selected = maximal_marginal_relevance(
+            np.array(embedding, dtype=np.float32),
+            embedding_list,
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+
+        candidates = self._results_to_docs_and_scores(results)
+
+        return [r for i, r in enumerate(candidates) if i in mmr_selected]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            query (str): Text to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Document]: List of Documents selected by maximal marginal relevance.
+        """
+        embedding = self.embedding_function.embed_query(query)
+        return self.max_marginal_relevance_search_by_vector(
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+
+    def max_marginal_relevance_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs selected using the maximal marginal relevance with score.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            query (str): Text to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Tuple[Document, float]]: List of Documents selected by maximal marginal
+                relevance to the query and score for each.
+        """
+        embedding = self.embedding_function.embed_query(query)
+        docs = self.max_marginal_relevance_search_with_score_by_vector(
+            embedding=embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+        return docs
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance
+            to embedding vector.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            embedding (str): Text to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Document]: List of Documents selected by maximal marginal relevance.
+        """
+        docs_and_scores = self.max_marginal_relevance_search_with_score_by_vector(
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+
+        return _results_to_docs(docs_and_scores)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/llm_rails.py b/llm/Lib/site-packages/langchain_community/vectorstores/llm_rails.py
new file mode 100644
index 0000000000000000000000000000000000000000..a46d74a32e0321483c6fefda5a63085e7c49e34c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/llm_rails.py
@@ -0,0 +1,244 @@
+"""Wrapper around LLMRails vector database."""
+from __future__ import annotations
+
+import json
+import logging
+import os
+import uuid
+from typing import Any, Iterable, List, Optional, Tuple
+
+import requests
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import Field
+from langchain_core.vectorstores import VectorStore, VectorStoreRetriever
+
+
+class LLMRails(VectorStore):
+    """Implementation of Vector Store using LLMRails.
+
+     See https://llmrails.com/
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import LLMRails
+
+            vectorstore = LLMRails(
+                api_key=llm_rails_api_key,
+                datastore_id=datastore_id
+            )
+    """
+
+    def __init__(
+        self,
+        datastore_id: Optional[str] = None,
+        api_key: Optional[str] = None,
+    ):
+        """Initialize with LLMRails API."""
+        self._datastore_id = datastore_id or os.environ.get("LLM_RAILS_DATASTORE_ID")
+        self._api_key = api_key or os.environ.get("LLM_RAILS_API_KEY")
+        if self._api_key is None:
+            logging.warning("Can't find Rails credentials in environment.")
+
+        self._session = requests.Session()  # to reuse connections
+        self.datastore_id = datastore_id
+        self.base_url = "https://api.llmrails.com/v1"
+
+    def _get_post_headers(self) -> dict:
+        """Returns headers that should be attached to each post request."""
+        return {"X-API-KEY": self._api_key}
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+
+        """
+        names: List[str] = []
+        for text in texts:
+            doc_name = str(uuid.uuid4())
+            response = self._session.post(
+                f"{self.base_url}/datastores/{self._datastore_id}/text",
+                json={"name": doc_name, "text": text},
+                verify=True,
+                headers=self._get_post_headers(),
+            )
+
+            if response.status_code != 200:
+                logging.error(
+                    f"Create request failed for doc_name = {doc_name} with status code "
+                    f"{response.status_code}, reason {response.reason}, text "
+                    f"{response.text}"
+                )
+
+                return names
+
+            names.append(doc_name)
+
+        return names
+
+    def add_files(
+        self,
+        files_list: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> bool:
+        """
+        LLMRails provides a way to add documents directly via our API where
+        pre-processing and chunking occurs internally in an optimal way
+        This method provides a way to use that API in LangChain
+
+        Args:
+            files_list: Iterable of strings, each representing a local file path.
+                    Files could be text, HTML, PDF, markdown, doc/docx, ppt/pptx, etc.
+                    see API docs for full list
+
+        Returns:
+            List of ids associated with each of the files indexed
+        """
+        files = []
+
+        for file in files_list:
+            if not os.path.exists(file):
+                logging.error(f"File {file} does not exist, skipping")
+                continue
+
+            files.append(("file", (os.path.basename(file), open(file, "rb"))))
+
+        response = self._session.post(
+            f"{self.base_url}/datastores/{self._datastore_id}/file",
+            files=files,
+            verify=True,
+            headers=self._get_post_headers(),
+        )
+
+        if response.status_code != 200:
+            logging.error(
+                f"Create request failed for datastore = {self._datastore_id} "
+                f"with status code {response.status_code}, reason {response.reason}, "
+                f"text {response.text}"
+            )
+
+            return False
+
+        return True
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 5
+    ) -> List[Tuple[Document, float]]:
+        """Return LLMRails documents most similar to query, along with scores.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 5 Max 10.
+            alpha: parameter for hybrid search .
+
+        Returns:
+            List of Documents most similar to the query and score for each.
+        """
+        response = self._session.post(
+            headers=self._get_post_headers(),
+            url=f"{self.base_url}/datastores/{self._datastore_id}/search",
+            data=json.dumps({"k": k, "text": query}),
+            timeout=10,
+        )
+
+        if response.status_code != 200:
+            logging.error(
+                "Query failed %s",
+                f"(code {response.status_code}, reason {response.reason}, details "
+                f"{response.text})",
+            )
+            return []
+
+        results = response.json()["results"]
+        docs = [
+            (
+                Document(
+                    page_content=x["text"],
+                    metadata={
+                        key: value
+                        for key, value in x["metadata"].items()
+                        if key != "score"
+                    },
+                ),
+                x["metadata"]["score"],
+            )
+            for x in results
+        ]
+
+        return docs
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return LLMRails documents most similar to query, along with scores.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 5.
+
+        Returns:
+            List of Documents most similar to the query
+        """
+        docs_and_scores = self.similarity_search_with_score(query, k=k)
+
+        return [doc for doc, _ in docs_and_scores]
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> LLMRails:
+        """Construct LLMRails wrapper from raw documents.
+        This is intended to be a quick way to get started.
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import LLMRails
+                llm_rails = LLMRails.from_texts(
+                    texts,
+                    datastore_id=datastore_id,
+                    api_key=llm_rails_api_key
+                )
+        """
+        # Note: LLMRails generates its own embeddings, so we ignore the provided
+        # embeddings (required by interface)
+        llm_rails = cls(**kwargs)
+        llm_rails.add_texts(texts)
+        return llm_rails
+
+    def as_retriever(self, **kwargs: Any) -> LLMRailsRetriever:
+        return LLMRailsRetriever(vectorstore=self, **kwargs)
+
+
+class LLMRailsRetriever(VectorStoreRetriever):
+    """Retriever for LLMRails."""
+
+    vectorstore: LLMRails
+    search_kwargs: dict = Field(default_factory=lambda: {"k": 5})
+    """Search params.
+        k: Number of Documents to return. Defaults to 5.
+        alpha: parameter for hybrid search .
+    """
+
+    def add_texts(self, texts: List[str]) -> None:
+        """Add text to the datastore.
+
+        Args:
+            texts (List[str]): The text
+        """
+        self.vectorstore.add_texts(texts)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/marqo.py b/llm/Lib/site-packages/langchain_community/vectorstores/marqo.py
new file mode 100644
index 0000000000000000000000000000000000000000..a2331bc65d8f3249a746aff64db97f31990d8c30
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/marqo.py
@@ -0,0 +1,470 @@
+from __future__ import annotations
+
+import json
+import uuid
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    import marqo
+
+
+class Marqo(VectorStore):
+    """`Marqo` vector store.
+
+    Marqo indexes have their own models associated with them to generate your
+    embeddings. This means that you can selected from a range of different models
+    and also use CLIP models to create multimodal indexes
+    with images and text together.
+
+    Marqo also supports more advanced queries with multiple weighted terms, see See
+    https://docs.marqo.ai/latest/#searching-using-weights-in-queries.
+    This class can flexibly take strings or dictionaries for weighted queries
+    in its similarity search methods.
+
+    To use, you should have the `marqo` python package installed, you can do this with
+    `pip install marqo`.
+
+    Example:
+        .. code-block:: python
+
+            import marqo
+            from langchain_community.vectorstores import Marqo
+            client = marqo.Client(url=os.environ["MARQO_URL"], ...)
+            vectorstore = Marqo(client, index_name)
+
+    """
+
+    def __init__(
+        self,
+        client: marqo.Client,
+        index_name: str,
+        add_documents_settings: Optional[Dict[str, Any]] = None,
+        searchable_attributes: Optional[List[str]] = None,
+        page_content_builder: Optional[Callable[[Dict[str, Any]], str]] = None,
+    ):
+        """Initialize with Marqo client."""
+        try:
+            import marqo
+        except ImportError:
+            raise ImportError(
+                "Could not import marqo python package. "
+                "Please install it with `pip install marqo`."
+            )
+        if not isinstance(client, marqo.Client):
+            raise ValueError(
+                f"client should be an instance of marqo.Client, got {type(client)}"
+            )
+        self._client = client
+        self._index_name = index_name
+        self._add_documents_settings = (
+            {} if add_documents_settings is None else add_documents_settings
+        )
+        self._searchable_attributes = searchable_attributes
+        self.page_content_builder = page_content_builder
+
+        self.tensor_fields = ["text"]
+
+        self._document_batch_size = 1024
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return None
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Upload texts with metadata (properties) to Marqo.
+
+        You can either have marqo generate ids for each document or you can provide
+        your own by including a "_id" field in the metadata objects.
+
+        Args:
+            texts (Iterable[str]): am iterator of texts - assumed to preserve an
+            order that matches the metadatas.
+            metadatas (Optional[List[dict]], optional): a list of metadatas.
+
+        Raises:
+            ValueError: if metadatas is provided and the number of metadatas differs
+            from the number of texts.
+
+        Returns:
+            List[str]: The list of ids that were added.
+        """
+
+        if self._client.index(self._index_name).get_settings()["index_defaults"][
+            "treat_urls_and_pointers_as_images"
+        ]:
+            raise ValueError(
+                "Marqo.add_texts is disabled for multimodal indexes. To add documents "
+                "with a multimodal index use the Python client for Marqo directly."
+            )
+        documents: List[Dict[str, str]] = []
+
+        num_docs = 0
+        for i, text in enumerate(texts):
+            doc = {
+                "text": text,
+                "metadata": json.dumps(metadatas[i]) if metadatas else json.dumps({}),
+            }
+            documents.append(doc)
+            num_docs += 1
+
+        ids = []
+        for i in range(0, num_docs, self._document_batch_size):
+            response = self._client.index(self._index_name).add_documents(
+                documents[i : i + self._document_batch_size],
+                tensor_fields=self.tensor_fields,
+                **self._add_documents_settings,
+            )
+            if response["errors"]:
+                err_msg = (
+                    f"Error in upload for documents in index range [{i},"
+                    f"{i + self._document_batch_size}], "
+                    f"check Marqo logs."
+                )
+                raise RuntimeError(err_msg)
+
+            ids += [item["_id"] for item in response["items"]]
+
+        return ids
+
+    def similarity_search(
+        self,
+        query: Union[str, Dict[str, float]],
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Search the marqo index for the most similar documents.
+
+        Args:
+            query (Union[str, Dict[str, float]]): The query for the search, either
+            as a string or a weighted query.
+            k (int, optional): The number of documents to return. Defaults to 4.
+
+        Returns:
+            List[Document]: k documents ordered from best to worst match.
+        """
+        results = self.marqo_similarity_search(query=query, k=k)
+
+        documents = self._construct_documents_from_results_without_score(results)
+        return documents
+
+    def similarity_search_with_score(
+        self,
+        query: Union[str, Dict[str, float]],
+        k: int = 4,
+    ) -> List[Tuple[Document, float]]:
+        """Return documents from Marqo that are similar to the query as well
+        as their scores.
+
+        Args:
+            query (str): The query to search with, either as a string or a weighted
+            query.
+            k (int, optional): The number of documents to return. Defaults to 4.
+
+        Returns:
+            List[Tuple[Document, float]]: The matching documents and their scores,
+            ordered by descending score.
+        """
+        results = self.marqo_similarity_search(query=query, k=k)
+
+        scored_documents = self._construct_documents_from_results_with_score(results)
+        return scored_documents
+
+    def bulk_similarity_search(
+        self,
+        queries: Iterable[Union[str, Dict[str, float]]],
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[List[Document]]:
+        """Search the marqo index for the most similar documents in bulk with multiple
+        queries.
+
+        Args:
+            queries (Iterable[Union[str, Dict[str, float]]]): An iterable of queries to
+            execute in bulk, queries in the list can be strings or dictionaries of
+            weighted queries.
+            k (int, optional): The number of documents to return for each query.
+            Defaults to 4.
+
+        Returns:
+            List[List[Document]]: A list of results for each query.
+        """
+        bulk_results = self.marqo_bulk_similarity_search(queries=queries, k=k)
+        bulk_documents: List[List[Document]] = []
+        for results in bulk_results["result"]:
+            documents = self._construct_documents_from_results_without_score(results)
+            bulk_documents.append(documents)
+
+        return bulk_documents
+
+    def bulk_similarity_search_with_score(
+        self,
+        queries: Iterable[Union[str, Dict[str, float]]],
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[List[Tuple[Document, float]]]:
+        """Return documents from Marqo that are similar to the query as well as
+        their scores using a batch of queries.
+
+        Args:
+            query (Iterable[Union[str, Dict[str, float]]]): An iterable of queries
+            to execute in bulk, queries in the list can be strings or dictionaries
+            of weighted queries.
+            k (int, optional): The number of documents to return. Defaults to 4.
+
+        Returns:
+            List[Tuple[Document, float]]: A list of lists of the matching
+            documents and their scores for each query
+        """
+        bulk_results = self.marqo_bulk_similarity_search(queries=queries, k=k)
+        bulk_documents: List[List[Tuple[Document, float]]] = []
+        for results in bulk_results["result"]:
+            documents = self._construct_documents_from_results_with_score(results)
+            bulk_documents.append(documents)
+
+        return bulk_documents
+
+    def _construct_documents_from_results_with_score(
+        self, results: Dict[str, List[Dict[str, str]]]
+    ) -> List[Tuple[Document, Any]]:
+        """Helper to convert Marqo results into documents.
+
+        Args:
+            results (List[dict]): A marqo results object with the 'hits'.
+            include_scores (bool, optional): Include scores alongside documents.
+            Defaults to False.
+
+        Returns:
+            Union[List[Document], List[Tuple[Document, float]]]: The documents or
+            document score pairs if `include_scores` is true.
+        """
+        documents: List[Tuple[Document, Any]] = []
+        for res in results["hits"]:
+            if self.page_content_builder is None:
+                text = res["text"]
+            else:
+                text = self.page_content_builder(res)
+
+            metadata = json.loads(res.get("metadata", "{}"))
+            documents.append(
+                (Document(page_content=text, metadata=metadata), res["_score"])
+            )
+        return documents
+
+    def _construct_documents_from_results_without_score(
+        self, results: Dict[str, List[Dict[str, str]]]
+    ) -> List[Document]:
+        """Helper to convert Marqo results into documents.
+
+        Args:
+            results (List[dict]): A marqo results object with the 'hits'.
+            include_scores (bool, optional): Include scores alongside documents.
+            Defaults to False.
+
+        Returns:
+            Union[List[Document], List[Tuple[Document, float]]]: The documents or
+            document score pairs if `include_scores` is true.
+        """
+        documents: List[Document] = []
+        for res in results["hits"]:
+            if self.page_content_builder is None:
+                text = res["text"]
+            else:
+                text = self.page_content_builder(res)
+
+            metadata = json.loads(res.get("metadata", "{}"))
+            documents.append(Document(page_content=text, metadata=metadata))
+        return documents
+
+    def marqo_similarity_search(
+        self,
+        query: Union[str, Dict[str, float]],
+        k: int = 4,
+    ) -> Dict[str, List[Dict[str, str]]]:
+        """Return documents from Marqo exposing Marqo's output directly
+
+        Args:
+            query (str): The query to search with.
+            k (int, optional): The number of documents to return. Defaults to 4.
+
+        Returns:
+            List[Dict[str, Any]]: This hits from marqo.
+        """
+        results = self._client.index(self._index_name).search(
+            q=query, searchable_attributes=self._searchable_attributes, limit=k
+        )
+        return results
+
+    def marqo_bulk_similarity_search(
+        self, queries: Iterable[Union[str, Dict[str, float]]], k: int = 4
+    ) -> Dict[str, List[Dict[str, List[Dict[str, str]]]]]:
+        """Return documents from Marqo using a bulk search, exposes Marqo's
+        output directly
+
+        Args:
+            queries (Iterable[Union[str, Dict[str, float]]]): A list of queries.
+            k (int, optional): The number of documents to return for each query.
+            Defaults to 4.
+
+        Returns:
+            Dict[str, Dict[List[Dict[str, Dict[str, Any]]]]]: A bulk search results
+            object
+        """
+        bulk_results = {
+            "result": [
+                self._client.index(self._index_name).search(
+                    q=query, searchable_attributes=self._searchable_attributes, limit=k
+                )
+                for query in queries
+            ]
+        }
+
+        return bulk_results
+
+    @classmethod
+    def from_documents(
+        cls: Type[Marqo],
+        documents: List[Document],
+        embedding: Union[Embeddings, None] = None,
+        **kwargs: Any,
+    ) -> Marqo:
+        """Return VectorStore initialized from documents. Note that Marqo does not
+        need embeddings, we retain the parameter to adhere to the Liskov substitution
+        principle.
+
+
+        Args:
+            documents (List[Document]): Input documents
+            embedding (Any, optional): Embeddings (not required). Defaults to None.
+
+        Returns:
+            VectorStore: A Marqo vectorstore
+        """
+        texts = [d.page_content for d in documents]
+        metadatas = [d.metadata for d in documents]
+        return cls.from_texts(texts, metadatas=metadatas, **kwargs)
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Any = None,
+        metadatas: Optional[List[dict]] = None,
+        index_name: str = "",
+        url: str = "http://localhost:8882",
+        api_key: str = "",
+        add_documents_settings: Optional[Dict[str, Any]] = None,
+        searchable_attributes: Optional[List[str]] = None,
+        page_content_builder: Optional[Callable[[Dict[str, str]], str]] = None,
+        index_settings: Optional[Dict[str, Any]] = None,
+        verbose: bool = True,
+        **kwargs: Any,
+    ) -> Marqo:
+        """Return Marqo initialized from texts. Note that Marqo does not need
+        embeddings, we retain the parameter to adhere to the Liskov
+        substitution principle.
+
+        This is a quick way to get started with marqo - simply provide your texts and
+        metadatas and this will create an instance of the data store and index the
+        provided data.
+
+        To know the ids of your documents with this approach you will need to include
+        them in under the key "_id" in your metadatas for each text
+
+        Example:
+        .. code-block:: python
+
+                from langchain_community.vectorstores import Marqo
+
+                datastore = Marqo(texts=['text'], index_name='my-first-index',
+                url='http://localhost:8882')
+
+        Args:
+            texts (List[str]): A list of texts to index into marqo upon creation.
+            embedding (Any, optional): Embeddings (not required). Defaults to None.
+            index_name (str, optional): The name of the index to use, if none is
+            provided then one will be created with a UUID. Defaults to None.
+            url (str, optional): The URL for Marqo. Defaults to "http://localhost:8882".
+            api_key (str, optional): The API key for Marqo. Defaults to "".
+            metadatas (Optional[List[dict]], optional): A list of metadatas, to
+            accompany the texts. Defaults to None.
+            this is only used when a new index is being created. Defaults to "cpu". Can
+            be "cpu" or "cuda".
+            add_documents_settings (Optional[Dict[str, Any]], optional): Settings
+            for adding documents, see
+            https://docs.marqo.ai/0.0.16/API-Reference/documents/#query-parameters.
+            Defaults to {}.
+            index_settings (Optional[Dict[str, Any]], optional): Index settings if
+            the index doesn't exist, see
+            https://docs.marqo.ai/0.0.16/API-Reference/indexes/#index-defaults-object.
+            Defaults to {}.
+
+        Returns:
+            Marqo: An instance of the Marqo vector store
+        """
+        try:
+            import marqo
+        except ImportError:
+            raise ImportError(
+                "Could not import marqo python package. "
+                "Please install it with `pip install marqo`."
+            )
+
+        if not index_name:
+            index_name = str(uuid.uuid4())
+
+        client = marqo.Client(url=url, api_key=api_key)
+
+        try:
+            client.create_index(index_name, settings_dict=index_settings or {})
+            if verbose:
+                print(f"Created {index_name} successfully.")  # noqa: T201
+        except Exception:
+            if verbose:
+                print(f"Index {index_name} exists.")  # noqa: T201
+
+        instance: Marqo = cls(
+            client,
+            index_name,
+            searchable_attributes=searchable_attributes,
+            add_documents_settings=add_documents_settings or {},
+            page_content_builder=page_content_builder,
+        )
+        instance.add_texts(texts, metadatas)
+        return instance
+
+    def get_indexes(self) -> List[Dict[str, str]]:
+        """Helper to see your available indexes in marqo, useful if the
+        from_texts method was used without an index name specified
+
+        Returns:
+            List[Dict[str, str]]: The list of indexes
+        """
+        return self._client.get_indexes()["results"]
+
+    def get_number_of_documents(self) -> int:
+        """Helper to see the number of documents in the index
+
+        Returns:
+            int: The number of documents
+        """
+        return self._client.index(self._index_name).get_stats()["numberOfDocuments"]
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/matching_engine.py b/llm/Lib/site-packages/langchain_community/vectorstores/matching_engine.py
new file mode 100644
index 0000000000000000000000000000000000000000..9cae484009c0b3f35875abc69d6b965843d90b97
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/matching_engine.py
@@ -0,0 +1,603 @@
+from __future__ import annotations
+
+import json
+import logging
+import time
+import uuid
+from typing import TYPE_CHECKING, Any, Iterable, List, Optional, Tuple, Type
+
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.utilities.vertexai import get_client_info
+
+if TYPE_CHECKING:
+    from google.cloud import storage
+    from google.cloud.aiplatform import MatchingEngineIndex, MatchingEngineIndexEndpoint
+    from google.cloud.aiplatform.matching_engine.matching_engine_index_endpoint import (
+        Namespace,
+    )
+    from google.oauth2.service_account import Credentials
+
+    from langchain_community.embeddings import TensorflowHubEmbeddings
+
+logger = logging.getLogger(__name__)
+
+
+@deprecated(
+    since="0.0.12",
+    removal="0.2.0",
+    alternative_import="langchain_google_vertexai.VectorSearchVectorStore",
+)
+class MatchingEngine(VectorStore):
+    """`Google Vertex AI Vector Search` (previously Matching Engine) vector store.
+
+    While the embeddings are stored in the Matching Engine, the embedded
+    documents will be stored in GCS.
+
+    An existing Index and corresponding Endpoint are preconditions for
+    using this module.
+
+    See usage in docs/integrations/vectorstores/google_vertex_ai_vector_search.ipynb
+
+    Note that this implementation is mostly meant for reading if you are
+    planning to do a real time implementation. While reading is a real time
+    operation, updating the index takes close to one hour."""
+
+    def __init__(
+        self,
+        project_id: str,
+        index: MatchingEngineIndex,
+        endpoint: MatchingEngineIndexEndpoint,
+        embedding: Embeddings,
+        gcs_client: storage.Client,
+        gcs_bucket_name: str,
+        credentials: Optional[Credentials] = None,
+        *,
+        document_id_key: Optional[str] = None,
+    ):
+        """Google Vertex AI Vector Search (previously Matching Engine)
+         implementation of the vector store.
+
+        While the embeddings are stored in the Matching Engine, the embedded
+        documents will be stored in GCS.
+
+        An existing Index and corresponding Endpoint are preconditions for
+        using this module.
+
+        See usage in
+        docs/integrations/vectorstores/google_vertex_ai_vector_search.ipynb.
+
+        Note that this implementation is mostly meant for reading if you are
+        planning to do a real time implementation. While reading is a real time
+        operation, updating the index takes close to one hour.
+
+        Attributes:
+            project_id: The GCS project id.
+            index: The created index class. See
+                ~:func:`MatchingEngine.from_components`.
+            endpoint: The created endpoint class. See
+                ~:func:`MatchingEngine.from_components`.
+            embedding: A :class:`Embeddings` that will be used for
+                embedding the text sent. If none is sent, then the
+                multilingual Tensorflow Universal Sentence Encoder will be used.
+            gcs_client: The GCS client.
+            gcs_bucket_name: The GCS bucket name.
+            credentials (Optional): Created GCP credentials.
+            document_id_key (Optional): Key for storing document ID in document
+                metadata. If None, document ID will not be returned in document
+                metadata.
+        """
+        super().__init__()
+        self._validate_google_libraries_installation()
+
+        self.project_id = project_id
+        self.index = index
+        self.endpoint = endpoint
+        self.embedding = embedding
+        self.gcs_client = gcs_client
+        self.credentials = credentials
+        self.gcs_bucket_name = gcs_bucket_name
+        self.document_id_key = document_id_key
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding
+
+    def _validate_google_libraries_installation(self) -> None:
+        """Validates that Google libraries that are needed are installed."""
+        try:
+            from google.cloud import aiplatform, storage  # noqa: F401
+            from google.oauth2 import service_account  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "You must run `pip install --upgrade "
+                "google-cloud-aiplatform google-cloud-storage`"
+                "to use the MatchingEngine Vectorstore."
+            )
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        texts = list(texts)
+        if metadatas is not None and len(texts) != len(metadatas):
+            raise ValueError(
+                "texts and metadatas do not have the same length. Received "
+                f"{len(texts)} texts and {len(metadatas)} metadatas."
+            )
+        logger.debug("Embedding documents.")
+        embeddings = self.embedding.embed_documents(texts)
+        jsons = []
+        ids = []
+        # Could be improved with async.
+        for idx, (embedding, text) in enumerate(zip(embeddings, texts)):
+            id = str(uuid.uuid4())
+            ids.append(id)
+            json_: dict = {"id": id, "embedding": embedding}
+            if metadatas is not None:
+                json_["metadata"] = metadatas[idx]
+            jsons.append(json_)
+            self._upload_to_gcs(text, f"documents/{id}")
+
+        logger.debug(f"Uploaded {len(ids)} documents to GCS.")
+
+        # Creating json lines from the embedded documents.
+        result_str = "\n".join([json.dumps(x) for x in jsons])
+
+        filename_prefix = f"indexes/{uuid.uuid4()}"
+        filename = f"{filename_prefix}/{time.time()}.json"
+        self._upload_to_gcs(result_str, filename)
+        logger.debug(
+            f"Uploaded updated json with embeddings to "
+            f"{self.gcs_bucket_name}/{filename}."
+        )
+
+        self.index = self.index.update_embeddings(
+            contents_delta_uri=f"gs://{self.gcs_bucket_name}/{filename_prefix}/"
+        )
+
+        logger.debug("Updated index with new configuration.")
+
+        return ids
+
+    def _upload_to_gcs(self, data: str, gcs_location: str) -> None:
+        """Uploads data to gcs_location.
+
+        Args:
+            data: The data that will be stored.
+            gcs_location: The location where the data will be stored.
+        """
+        bucket = self.gcs_client.get_bucket(self.gcs_bucket_name)
+        blob = bucket.blob(gcs_location)
+        blob.upload_from_string(data)
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[List[Namespace]] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query and their cosine distance from the query.
+
+        Args:
+            query: String query look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Optional. A list of Namespaces for filtering
+                the matching results.
+                For example:
+                [Namespace("color", ["red"], []), Namespace("shape", [], ["squared"])]
+                will match datapoints that satisfy "red color" but not include
+                datapoints with "squared shape". Please refer to
+                https://cloud.google.com/vertex-ai/docs/matching-engine/filtering#json
+                for more detail.
+
+        Returns:
+            List[Tuple[Document, float]]: List of documents most similar to
+            the query text and cosine distance in float for each.
+            Lower score represents more similarity.
+        """
+        logger.debug(f"Embedding query {query}.")
+        embedding_query = self.embedding.embed_query(query)
+        return self.similarity_search_by_vector_with_score(
+            embedding_query, k=k, filter=filter
+        )
+
+    def similarity_search_by_vector_with_score(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[List[Namespace]] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to the embedding and their cosine distance.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Optional. A list of Namespaces for filtering
+                the matching results.
+                For example:
+                [Namespace("color", ["red"], []), Namespace("shape", [], ["squared"])]
+                will match datapoints that satisfy "red color" but not include
+                datapoints with "squared shape". Please refer to
+                https://cloud.google.com/vertex-ai/docs/matching-engine/filtering#json
+                for more detail.
+
+        Returns:
+            List[Tuple[Document, float]]: List of documents most similar to
+            the query text and cosine distance in float for each.
+            Lower score represents more similarity.
+
+        """
+        filter = filter or []
+
+        # If the endpoint is public we use the find_neighbors function.
+        if hasattr(self.endpoint, "_public_match_client") and (
+            self.endpoint._public_match_client
+        ):
+            response = self.endpoint.find_neighbors(
+                deployed_index_id=self._get_index_id(),
+                queries=[embedding],
+                num_neighbors=k,
+                filter=filter,
+            )
+        else:
+            response = self.endpoint.match(
+                deployed_index_id=self._get_index_id(),
+                queries=[embedding],
+                num_neighbors=k,
+                filter=filter,
+            )
+
+        logger.debug(f"Found {len(response)} matches.")
+
+        if len(response) == 0:
+            return []
+
+        docs: List[Tuple[Document, float]] = []
+
+        # I'm only getting the first one because queries receives an array
+        # and the similarity_search method only receives one query. This
+        # means that the match method will always return an array with only
+        # one element.
+        for result in response[0]:
+            page_content = self._download_from_gcs(f"documents/{result.id}")
+            # TODO: return all metadata.
+            metadata = {}
+            if self.document_id_key is not None:
+                metadata[self.document_id_key] = result.id
+            document = Document(
+                page_content=page_content,
+                metadata=metadata,
+            )
+            docs.append((document, result.distance))
+
+        logger.debug("Downloaded documents for query.")
+
+        return docs
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[List[Namespace]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: The string that will be used to search for similar documents.
+            k: The amount of neighbors that will be retrieved.
+            filter: Optional. A list of Namespaces for filtering the matching results.
+                For example:
+                [Namespace("color", ["red"], []), Namespace("shape", [], ["squared"])]
+                will match datapoints that satisfy "red color" but not include
+                datapoints with "squared shape". Please refer to
+                https://cloud.google.com/vertex-ai/docs/matching-engine/filtering#json
+                 for more detail.
+
+        Returns:
+            A list of k matching documents.
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query, k=k, filter=filter, **kwargs
+        )
+
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[List[Namespace]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to the embedding.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: The amount of neighbors that will be retrieved.
+            filter: Optional. A list of Namespaces for filtering the matching results.
+                For example:
+                [Namespace("color", ["red"], []), Namespace("shape", [], ["squared"])]
+                will match datapoints that satisfy "red color" but not include
+                datapoints with "squared shape". Please refer to
+                https://cloud.google.com/vertex-ai/docs/matching-engine/filtering#json
+                 for more detail.
+
+        Returns:
+            A list of k matching documents.
+        """
+        docs_and_scores = self.similarity_search_by_vector_with_score(
+            embedding, k=k, filter=filter, **kwargs
+        )
+
+        return [doc for doc, _ in docs_and_scores]
+
+    def _get_index_id(self) -> str:
+        """Gets the correct index id for the endpoint.
+
+        Returns:
+            The index id if found (which should be found) or throws
+            ValueError otherwise.
+        """
+        for index in self.endpoint.deployed_indexes:
+            if index.index == self.index.resource_name:
+                return index.id
+
+        raise ValueError(
+            f"No index with id {self.index.resource_name} "
+            f"deployed on endpoint "
+            f"{self.endpoint.display_name}."
+        )
+
+    def _download_from_gcs(self, gcs_location: str) -> str:
+        """Downloads from GCS in text format.
+
+        Args:
+            gcs_location: The location where the file is located.
+
+        Returns:
+            The string contents of the file.
+        """
+        bucket = self.gcs_client.get_bucket(self.gcs_bucket_name)
+        blob = bucket.blob(gcs_location)
+        return blob.download_as_string()
+
+    @classmethod
+    def from_texts(
+        cls: Type["MatchingEngine"],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> "MatchingEngine":
+        """Use from components instead."""
+        raise NotImplementedError(
+            "This method is not implemented. Instead, you should initialize the class"
+            " with `MatchingEngine.from_components(...)` and then call "
+            "`add_texts`"
+        )
+
+    @classmethod
+    def from_components(
+        cls: Type["MatchingEngine"],
+        project_id: str,
+        region: str,
+        gcs_bucket_name: str,
+        index_id: str,
+        endpoint_id: str,
+        credentials_path: Optional[str] = None,
+        embedding: Optional[Embeddings] = None,
+        **kwargs: Any,
+    ) -> "MatchingEngine":
+        """Takes the object creation out of the constructor.
+
+        Args:
+            project_id: The GCP project id.
+            region: The default location making the API calls. It must have
+            the same location as the GCS bucket and must be regional.
+            gcs_bucket_name: The location where the vectors will be stored in
+            order for the index to be created.
+            index_id: The id of the created index.
+            endpoint_id: The id of the created endpoint.
+            credentials_path: (Optional) The path of the Google credentials on
+            the local file system.
+            embedding: The :class:`Embeddings` that will be used for
+            embedding the texts.
+            kwargs: Additional keyword arguments to pass to MatchingEngine.__init__().
+
+        Returns:
+            A configured MatchingEngine with the texts added to the index.
+        """
+        gcs_bucket_name = cls._validate_gcs_bucket(gcs_bucket_name)
+        credentials = cls._create_credentials_from_file(credentials_path)
+        index = cls._create_index_by_id(index_id, project_id, region, credentials)
+        endpoint = cls._create_endpoint_by_id(
+            endpoint_id, project_id, region, credentials
+        )
+
+        gcs_client = cls._get_gcs_client(credentials, project_id)
+        cls._init_aiplatform(project_id, region, gcs_bucket_name, credentials)
+
+        return cls(
+            project_id=project_id,
+            index=index,
+            endpoint=endpoint,
+            embedding=embedding or cls._get_default_embeddings(),
+            gcs_client=gcs_client,
+            credentials=credentials,
+            gcs_bucket_name=gcs_bucket_name,
+            **kwargs,
+        )
+
+    @classmethod
+    def _validate_gcs_bucket(cls, gcs_bucket_name: str) -> str:
+        """Validates the gcs_bucket_name as a bucket name.
+
+        Args:
+              gcs_bucket_name: The received bucket uri.
+
+        Returns:
+              A valid gcs_bucket_name or throws ValueError if full path is
+              provided.
+        """
+        gcs_bucket_name = gcs_bucket_name.replace("gs://", "")
+        if "/" in gcs_bucket_name:
+            raise ValueError(
+                f"The argument gcs_bucket_name should only be "
+                f"the bucket name. Received {gcs_bucket_name}"
+            )
+        return gcs_bucket_name
+
+    @classmethod
+    def _create_credentials_from_file(
+        cls, json_credentials_path: Optional[str]
+    ) -> Optional[Credentials]:
+        """Creates credentials for GCP.
+
+        Args:
+             json_credentials_path: The path on the file system where the
+             credentials are stored.
+
+         Returns:
+             An optional of Credentials or None, in which case the default
+             will be used.
+        """
+
+        from google.oauth2 import service_account
+
+        credentials = None
+        if json_credentials_path is not None:
+            credentials = service_account.Credentials.from_service_account_file(
+                json_credentials_path
+            )
+
+        return credentials
+
+    @classmethod
+    def _create_index_by_id(
+        cls, index_id: str, project_id: str, region: str, credentials: "Credentials"
+    ) -> MatchingEngineIndex:
+        """Creates a MatchingEngineIndex object by id.
+
+        Args:
+            index_id: The created index id.
+            project_id: The project to retrieve index from.
+            region: Location to retrieve index from.
+            credentials: GCS credentials.
+
+        Returns:
+            A configured MatchingEngineIndex.
+        """
+
+        from google.cloud import aiplatform
+
+        logger.debug(f"Creating matching engine index with id {index_id}.")
+        return aiplatform.MatchingEngineIndex(
+            index_name=index_id,
+            project=project_id,
+            location=region,
+            credentials=credentials,
+        )
+
+    @classmethod
+    def _create_endpoint_by_id(
+        cls, endpoint_id: str, project_id: str, region: str, credentials: "Credentials"
+    ) -> MatchingEngineIndexEndpoint:
+        """Creates a MatchingEngineIndexEndpoint object by id.
+
+        Args:
+            endpoint_id: The created endpoint id.
+            project_id: The project to retrieve index from.
+            region: Location to retrieve index from.
+            credentials: GCS credentials.
+
+        Returns:
+            A configured MatchingEngineIndexEndpoint.
+        """
+
+        from google.cloud import aiplatform
+
+        logger.debug(f"Creating endpoint with id {endpoint_id}.")
+        return aiplatform.MatchingEngineIndexEndpoint(
+            index_endpoint_name=endpoint_id,
+            project=project_id,
+            location=region,
+            credentials=credentials,
+        )
+
+    @classmethod
+    def _get_gcs_client(
+        cls, credentials: "Credentials", project_id: str
+    ) -> "storage.Client":
+        """Lazily creates a GCS client.
+
+        Returns:
+            A configured GCS client.
+        """
+
+        from google.cloud import storage
+
+        return storage.Client(
+            credentials=credentials,
+            project=project_id,
+            client_info=get_client_info(module="vertex-ai-matching-engine"),
+        )
+
+    @classmethod
+    def _init_aiplatform(
+        cls,
+        project_id: str,
+        region: str,
+        gcs_bucket_name: str,
+        credentials: "Credentials",
+    ) -> None:
+        """Configures the aiplatform library.
+
+        Args:
+            project_id: The GCP project id.
+            region: The default location making the API calls. It must have
+            the same location as the GCS bucket and must be regional.
+            gcs_bucket_name: GCS staging location.
+            credentials: The GCS Credentials object.
+        """
+
+        from google.cloud import aiplatform
+
+        logger.debug(
+            f"Initializing AI Platform for project {project_id} on "
+            f"{region} and for {gcs_bucket_name}."
+        )
+        aiplatform.init(
+            project=project_id,
+            location=region,
+            staging_bucket=gcs_bucket_name,
+            credentials=credentials,
+        )
+
+    @classmethod
+    def _get_default_embeddings(cls) -> "TensorflowHubEmbeddings":
+        """This function returns the default embedding.
+
+        Returns:
+            Default TensorflowHubEmbeddings to use.
+        """
+
+        from langchain_community.embeddings import TensorflowHubEmbeddings
+
+        return TensorflowHubEmbeddings()
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/meilisearch.py b/llm/Lib/site-packages/langchain_community/vectorstores/meilisearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..522f107405dbedc39f8ee0278be07d86f30166df
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/meilisearch.py
@@ -0,0 +1,349 @@
+from __future__ import annotations
+
+import uuid
+from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Optional, Tuple, Type
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_env
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    from meilisearch import Client
+
+
+def _create_client(
+    client: Optional[Client] = None,
+    url: Optional[str] = None,
+    api_key: Optional[str] = None,
+) -> Client:
+    try:
+        import meilisearch
+    except ImportError:
+        raise ImportError(
+            "Could not import meilisearch python package. "
+            "Please install it with `pip install meilisearch`."
+        )
+    if not client:
+        url = url or get_from_env("url", "MEILI_HTTP_ADDR")
+        try:
+            api_key = api_key or get_from_env("api_key", "MEILI_MASTER_KEY")
+        except Exception:
+            pass
+        client = meilisearch.Client(url=url, api_key=api_key)
+    elif not isinstance(client, meilisearch.Client):
+        raise ValueError(
+            f"client should be an instance of meilisearch.Client, "
+            f"got {type(client)}"
+        )
+    try:
+        client.version()
+    except ValueError as e:
+        raise ValueError(f"Failed to connect to Meilisearch: {e}")
+    return client
+
+
+class Meilisearch(VectorStore):
+    """`Meilisearch` vector store.
+
+    To use this, you need to have `meilisearch` python package installed,
+    and a running Meilisearch instance.
+
+    To learn more about Meilisearch Python, refer to the in-depth
+    Meilisearch Python documentation: https://meilisearch.github.io/meilisearch-python/.
+
+    See the following documentation for how to run a Meilisearch instance:
+    https://www.meilisearch.com/docs/learn/getting_started/quick_start.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import Meilisearch
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+            import meilisearch
+
+            # api_key is optional; provide it if your meilisearch instance requires it
+            client = meilisearch.Client(url='http://127.0.0.1:7700', api_key='***')
+            embeddings = OpenAIEmbeddings()
+            embedders = {
+                "theEmbedderName": {
+                    "source": "userProvided",
+                    "dimensions": "1536"
+                }
+            }
+            vectorstore = Meilisearch(
+                embedding=embeddings,
+                embedders=embedders,
+                client=client,
+                index_name='langchain_demo',
+                text_key='text')
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        client: Optional[Client] = None,
+        url: Optional[str] = None,
+        api_key: Optional[str] = None,
+        index_name: str = "langchain-demo",
+        text_key: str = "text",
+        metadata_key: str = "metadata",
+        *,
+        embedders: Optional[Dict[str, Any]] = None,
+    ):
+        """Initialize with Meilisearch client."""
+        client = _create_client(client=client, url=url, api_key=api_key)
+
+        self._client = client
+        self._index_name = index_name
+        self._embedding = embedding
+        self._text_key = text_key
+        self._metadata_key = metadata_key
+        self._embedders = embedders
+        self._embedders_settings = self._client.index(
+            str(self._index_name)
+        ).update_embedders(embedders)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        embedder_name: Optional[str] = "default",
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embedding and add them to the vector store.
+
+        Args:
+            texts (Iterable[str]): Iterable of strings/text to add to the vectorstore.
+            embedder_name: Name of the embedder. Defaults to "default".
+            metadatas (Optional[List[dict]]): Optional list of metadata.
+                Defaults to None.
+            ids Optional[List[str]]: Optional list of IDs.
+                Defaults to None.
+
+        Returns:
+            List[str]: List of IDs of the texts added to the vectorstore.
+        """
+        texts = list(texts)
+
+        # Embed and create the documents
+        docs = []
+        if ids is None:
+            ids = [uuid.uuid4().hex for _ in texts]
+        if metadatas is None:
+            metadatas = [{} for _ in texts]
+        embedding_vectors = self._embedding.embed_documents(texts)
+
+        for i, text in enumerate(texts):
+            id = ids[i]
+            metadata = metadatas[i]
+            metadata[self._text_key] = text
+            embedding = embedding_vectors[i]
+            docs.append(
+                {
+                    "id": id,
+                    "_vectors": {f"{embedder_name}": embedding},
+                    f"{self._metadata_key}": metadata,
+                }
+            )
+
+        # Send to Meilisearch
+        self._client.index(str(self._index_name)).add_documents(docs)
+        return ids
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, str]] = None,
+        embedder_name: Optional[str] = "default",
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return meilisearch documents most similar to the query.
+
+        Args:
+            query (str): Query text for which to find similar documents.
+            embedder_name: Name of the embedder to be used. Defaults to "default".
+            k (int): Number of documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata.
+                Defaults to None.
+
+        Returns:
+            List[Document]: List of Documents most similar to the query
+            text and score for each.
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query=query,
+            embedder_name=embedder_name,
+            k=k,
+            filter=filter,
+            kwargs=kwargs,
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, str]] = None,
+        embedder_name: Optional[str] = "default",
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return meilisearch documents most similar to the query, along with scores.
+
+        Args:
+            query (str): Query text for which to find similar documents.
+            embedder_name: Name of the embedder to be used. Defaults to "default".
+            k (int): Number of documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata.
+                Defaults to None.
+
+        Returns:
+            List[Document]: List of Documents most similar to the query
+            text and score for each.
+        """
+        _query = self._embedding.embed_query(query)
+
+        docs = self.similarity_search_by_vector_with_scores(
+            embedding=_query,
+            embedder_name=embedder_name,
+            k=k,
+            filter=filter,
+            kwargs=kwargs,
+        )
+        return docs
+
+    def similarity_search_by_vector_with_scores(
+        self,
+        embedding: List[float],
+        embedder_name: Optional[str] = "default",
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return meilisearch documents most similar to embedding vector.
+
+        Args:
+            embedding (List[float]): Embedding to look up similar documents.
+            embedder_name: Name of the embedder to be used. Defaults to "default".
+            k (int): Number of documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata.
+                Defaults to None.
+
+        Returns:
+            List[Document]: List of Documents most similar to the query
+                vector and score for each.
+        """
+        docs = []
+        results = self._client.index(str(self._index_name)).search(
+            "",
+            {
+                "vector": embedding,
+                "hybrid": {"semanticRatio": 1.0, "embedder": embedder_name},
+                "limit": k,
+                "filter": filter,
+            },
+        )
+
+        for result in results["hits"]:
+            metadata = result[self._metadata_key]
+            if self._text_key in metadata:
+                text = metadata.pop(self._text_key)
+                semantic_score = result["_semanticScore"]
+                docs.append(
+                    (Document(page_content=text, metadata=metadata), semantic_score)
+                )
+
+        return docs
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, str]] = None,
+        embedder_name: Optional[str] = "default",
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return meilisearch documents most similar to embedding vector.
+
+        Args:
+            embedding (List[float]): Embedding to look up similar documents.
+            embedder_name: Name of the embedder to be used. Defaults to "default".
+            k (int): Number of documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata.
+                Defaults to None.
+
+        Returns:
+            List[Document]: List of Documents most similar to the query
+                vector and score for each.
+        """
+        docs = self.similarity_search_by_vector_with_scores(
+            embedding=embedding,
+            embedder_name=embedder_name,
+            k=k,
+            filter=filter,
+            kwargs=kwargs,
+        )
+        return [doc for doc, _ in docs]
+
+    @classmethod
+    def from_texts(
+        cls: Type[Meilisearch],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        client: Optional[Client] = None,
+        url: Optional[str] = None,
+        api_key: Optional[str] = None,
+        index_name: str = "langchain-demo",
+        ids: Optional[List[str]] = None,
+        text_key: Optional[str] = "text",
+        metadata_key: Optional[str] = "metadata",
+        embedders: Dict[str, Any] = {},
+        embedder_name: Optional[str] = "default",
+        **kwargs: Any,
+    ) -> Meilisearch:
+        """Construct Meilisearch wrapper from raw documents.
+
+        This is a user-friendly interface that:
+            1. Embeds documents.
+            2. Adds the documents to a provided Meilisearch index.
+
+        This is intended to be a quick way to get started.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import Meilisearch
+                from langchain_community.embeddings import OpenAIEmbeddings
+                import meilisearch
+
+                # The environment should be the one specified next to the API key
+                # in your Meilisearch console
+                client = meilisearch.Client(url='http://127.0.0.1:7700', api_key='***')
+                embedding = OpenAIEmbeddings()
+                embedders: Embedders index setting.
+                embedder_name: Name of the embedder. Defaults to "default".
+                docsearch = Meilisearch.from_texts(
+                    client=client,
+                    embedding=embedding,
+                )
+        """
+        client = _create_client(client=client, url=url, api_key=api_key)
+
+        vectorstore = cls(
+            embedding=embedding,
+            embedders=embedders,
+            client=client,
+            index_name=index_name,
+        )
+        vectorstore.add_texts(
+            texts=texts,
+            embedder_name=embedder_name,
+            metadatas=metadatas,
+            ids=ids,
+            text_key=text_key,
+            metadata_key=metadata_key,
+        )
+        return vectorstore
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/milvus.py b/llm/Lib/site-packages/langchain_community/vectorstores/milvus.py
new file mode 100644
index 0000000000000000000000000000000000000000..a43f19e4ad18838e1709f93ad472560793288e22
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/milvus.py
@@ -0,0 +1,1083 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Iterable, List, Optional, Tuple, Union
+from uuid import uuid4
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_MILVUS_CONNECTION = {
+    "host": "localhost",
+    "port": "19530",
+    "user": "",
+    "password": "",
+    "secure": False,
+}
+
+
+class Milvus(VectorStore):
+    """`Milvus` vector store.
+
+    You need to install `pymilvus` and run Milvus.
+
+    See the following documentation for how to run a Milvus instance:
+    https://milvus.io/docs/install_standalone-docker.md
+
+    If looking for a hosted Milvus, take a look at this documentation:
+    https://zilliz.com/cloud and make use of the Zilliz vectorstore found in
+    this project.
+
+    IF USING L2/IP metric, IT IS HIGHLY SUGGESTED TO NORMALIZE YOUR DATA.
+
+    Args:
+        embedding_function (Embeddings): Function used to embed the text.
+        collection_name (str): Which Milvus collection to use. Defaults to
+            "LangChainCollection".
+        collection_description (str): The description of the collection. Defaults to
+            "".
+        collection_properties (Optional[dict[str, any]]): The collection properties.
+            Defaults to None.
+            If set, will override collection existing properties.
+            For example: {"collection.ttl.seconds": 60}.
+        connection_args (Optional[dict[str, any]]): The connection args used for
+            this class comes in the form of a dict.
+        consistency_level (str): The consistency level to use for a collection.
+            Defaults to "Session".
+        index_params (Optional[dict]): Which index params to use. Defaults to
+            HNSW/AUTOINDEX depending on service.
+        search_params (Optional[dict]): Which search params to use. Defaults to
+            default of index.
+        drop_old (Optional[bool]): Whether to drop the current collection. Defaults
+            to False.
+        auto_id (bool): Whether to enable auto id for primary key. Defaults to False.
+            If False, you needs to provide text ids (string less than 65535 bytes).
+            If True, Milvus will generate unique integers as primary keys.
+        primary_field (str): Name of the primary key field. Defaults to "pk".
+        text_field (str): Name of the text field. Defaults to "text".
+        vector_field (str): Name of the vector field. Defaults to "vector".
+        metadata_field (str): Name of the metadta field. Defaults to None.
+            When metadata_field is specified,
+            the document's metadata will store as json.
+
+    The connection args used for this class comes in the form of a dict,
+    here are a few of the options:
+        address (str): The actual address of Milvus
+            instance. Example address: "localhost:19530"
+        uri (str): The uri of Milvus instance. Example uri:
+            "http://randomwebsite:19530",
+            "tcp:foobarsite:19530",
+            "https://ok.s3.south.com:19530".
+        host (str): The host of Milvus instance. Default at "localhost",
+            PyMilvus will fill in the default host if only port is provided.
+        port (str/int): The port of Milvus instance. Default at 19530, PyMilvus
+            will fill in the default port if only host is provided.
+        user (str): Use which user to connect to Milvus instance. If user and
+            password are provided, we will add related header in every RPC call.
+        password (str): Required when user is provided. The password
+            corresponding to the user.
+        secure (bool): Default is false. If set to true, tls will be enabled.
+        client_key_path (str): If use tls two-way authentication, need to
+            write the client.key path.
+        client_pem_path (str): If use tls two-way authentication, need to
+            write the client.pem path.
+        ca_pem_path (str): If use tls two-way authentication, need to write
+            the ca.pem path.
+        server_pem_path (str): If use tls one-way authentication, need to
+            write the server.pem path.
+        server_name (str): If use tls, need to write the common name.
+
+    Example:
+        .. code-block:: python
+
+        from langchain_community.vectorstores import Milvus
+        from langchain_community.embeddings import OpenAIEmbeddings
+
+        embedding = OpenAIEmbeddings()
+        # Connect to a milvus instance on localhost
+        milvus_store = Milvus(
+            embedding_function = Embeddings,
+            collection_name = "LangChainCollection",
+            drop_old = True,
+            auto_id = True
+        )
+
+    Raises:
+        ValueError: If the pymilvus python package is not installed.
+    """
+
+    def __init__(
+        self,
+        embedding_function: Embeddings,
+        collection_name: str = "LangChainCollection",
+        collection_description: str = "",
+        collection_properties: Optional[dict[str, Any]] = None,
+        connection_args: Optional[dict[str, Any]] = None,
+        consistency_level: str = "Session",
+        index_params: Optional[dict] = None,
+        search_params: Optional[dict] = None,
+        drop_old: Optional[bool] = False,
+        auto_id: bool = False,
+        *,
+        primary_field: str = "pk",
+        text_field: str = "text",
+        vector_field: str = "vector",
+        metadata_field: Optional[str] = None,
+        partition_key_field: Optional[str] = None,
+        partition_names: Optional[list] = None,
+        replica_number: int = 1,
+        timeout: Optional[float] = None,
+        num_shards: Optional[int] = None,
+    ):
+        """Initialize the Milvus vector store."""
+        try:
+            from pymilvus import Collection, utility
+        except ImportError:
+            raise ValueError(
+                "Could not import pymilvus python package. "
+                "Please install it with `pip install pymilvus`."
+            )
+
+        # Default search params when one is not provided.
+        self.default_search_params = {
+            "IVF_FLAT": {"metric_type": "L2", "params": {"nprobe": 10}},
+            "IVF_SQ8": {"metric_type": "L2", "params": {"nprobe": 10}},
+            "IVF_PQ": {"metric_type": "L2", "params": {"nprobe": 10}},
+            "HNSW": {"metric_type": "L2", "params": {"ef": 10}},
+            "RHNSW_FLAT": {"metric_type": "L2", "params": {"ef": 10}},
+            "RHNSW_SQ": {"metric_type": "L2", "params": {"ef": 10}},
+            "RHNSW_PQ": {"metric_type": "L2", "params": {"ef": 10}},
+            "IVF_HNSW": {"metric_type": "L2", "params": {"nprobe": 10, "ef": 10}},
+            "ANNOY": {"metric_type": "L2", "params": {"search_k": 10}},
+            "SCANN": {"metric_type": "L2", "params": {"search_k": 10}},
+            "AUTOINDEX": {"metric_type": "L2", "params": {}},
+            "GPU_CAGRA": {
+                "metric_type": "L2",
+                "params": {
+                    "itopk_size": 128,
+                    "search_width": 4,
+                    "min_iterations": 0,
+                    "max_iterations": 0,
+                    "team_size": 0,
+                },
+            },
+            "GPU_IVF_FLAT": {"metric_type": "L2", "params": {"nprobe": 10}},
+            "GPU_IVF_PQ": {"metric_type": "L2", "params": {"nprobe": 10}},
+        }
+
+        self.embedding_func = embedding_function
+        self.collection_name = collection_name
+        self.collection_description = collection_description
+        self.collection_properties = collection_properties
+        self.index_params = index_params
+        self.search_params = search_params
+        self.consistency_level = consistency_level
+        self.auto_id = auto_id
+
+        # In order for a collection to be compatible, pk needs to be varchar
+        self._primary_field = primary_field
+        # In order for compatibility, the text field will need to be called "text"
+        self._text_field = text_field
+        # In order for compatibility, the vector field needs to be called "vector"
+        self._vector_field = vector_field
+        self._metadata_field = metadata_field
+        self._partition_key_field = partition_key_field
+        self.fields: list[str] = []
+        self.partition_names = partition_names
+        self.replica_number = replica_number
+        self.timeout = timeout
+        self.num_shards = num_shards
+
+        # Create the connection to the server
+        if connection_args is None:
+            connection_args = DEFAULT_MILVUS_CONNECTION
+        self.alias = self._create_connection_alias(connection_args)
+        self.col: Optional[Collection] = None
+
+        # Grab the existing collection if it exists
+        if utility.has_collection(self.collection_name, using=self.alias):
+            self.col = Collection(
+                self.collection_name,
+                using=self.alias,
+            )
+            if self.collection_properties is not None:
+                self.col.set_properties(self.collection_properties)
+        # If need to drop old, drop it
+        if drop_old and isinstance(self.col, Collection):
+            self.col.drop()
+            self.col = None
+
+        # Initialize the vector store
+        self._init(
+            partition_names=partition_names,
+            replica_number=replica_number,
+            timeout=timeout,
+        )
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding_func
+
+    def _create_connection_alias(self, connection_args: dict) -> str:
+        """Create the connection to the Milvus server."""
+        from pymilvus import MilvusException, connections
+
+        # Grab the connection arguments that are used for checking existing connection
+        host: str = connection_args.get("host", None)
+        port: Union[str, int] = connection_args.get("port", None)
+        address: str = connection_args.get("address", None)
+        uri: str = connection_args.get("uri", None)
+        user = connection_args.get("user", None)
+
+        # Order of use is host/port, uri, address
+        if host is not None and port is not None:
+            given_address = str(host) + ":" + str(port)
+        elif uri is not None:
+            if uri.startswith("https://"):
+                given_address = uri.split("https://")[1]
+            elif uri.startswith("http://"):
+                given_address = uri.split("http://")[1]
+            else:
+                logger.error("Invalid Milvus URI: %s", uri)
+                raise ValueError("Invalid Milvus URI: %s", uri)
+        elif address is not None:
+            given_address = address
+        else:
+            given_address = None
+            logger.debug("Missing standard address type for reuse attempt")
+
+        # User defaults to empty string when getting connection info
+        if user is not None:
+            tmp_user = user
+        else:
+            tmp_user = ""
+
+        # If a valid address was given, then check if a connection exists
+        if given_address is not None:
+            for con in connections.list_connections():
+                addr = connections.get_connection_addr(con[0])
+                if (
+                    con[1]
+                    and ("address" in addr)
+                    and (addr["address"] == given_address)
+                    and ("user" in addr)
+                    and (addr["user"] == tmp_user)
+                ):
+                    logger.debug("Using previous connection: %s", con[0])
+                    return con[0]
+
+        # Generate a new connection if one doesn't exist
+        alias = uuid4().hex
+        try:
+            connections.connect(alias=alias, **connection_args)
+            logger.debug("Created new connection using: %s", alias)
+            return alias
+        except MilvusException as e:
+            logger.error("Failed to create new connection using: %s", alias)
+            raise e
+
+    def _init(
+        self,
+        embeddings: Optional[list] = None,
+        metadatas: Optional[list[dict]] = None,
+        partition_names: Optional[list] = None,
+        replica_number: int = 1,
+        timeout: Optional[float] = None,
+    ) -> None:
+        if embeddings is not None:
+            self._create_collection(embeddings, metadatas)
+        self._extract_fields()
+        self._create_index()
+        self._create_search_params()
+        self._load(
+            partition_names=partition_names,
+            replica_number=replica_number,
+            timeout=timeout,
+        )
+
+    def _create_collection(
+        self, embeddings: list, metadatas: Optional[list[dict]] = None
+    ) -> None:
+        from pymilvus import (
+            Collection,
+            CollectionSchema,
+            DataType,
+            FieldSchema,
+            MilvusException,
+        )
+        from pymilvus.orm.types import infer_dtype_bydata
+
+        # Determine embedding dim
+        dim = len(embeddings[0])
+        fields = []
+        if self._metadata_field is not None:
+            fields.append(FieldSchema(self._metadata_field, DataType.JSON))
+        else:
+            # Determine metadata schema
+            if metadatas:
+                # Create FieldSchema for each entry in metadata.
+                for key, value in metadatas[0].items():
+                    # Infer the corresponding datatype of the metadata
+                    dtype = infer_dtype_bydata(value)
+                    # Datatype isn't compatible
+                    if dtype == DataType.UNKNOWN or dtype == DataType.NONE:
+                        logger.error(
+                            (
+                                "Failure to create collection, "
+                                "unrecognized dtype for key: %s"
+                            ),
+                            key,
+                        )
+                        raise ValueError(f"Unrecognized datatype for {key}.")
+                    # Dataype is a string/varchar equivalent
+                    elif dtype == DataType.VARCHAR:
+                        fields.append(
+                            FieldSchema(key, DataType.VARCHAR, max_length=65_535)
+                        )
+                    else:
+                        fields.append(FieldSchema(key, dtype))
+
+        # Create the text field
+        fields.append(
+            FieldSchema(self._text_field, DataType.VARCHAR, max_length=65_535)
+        )
+        # Create the primary key field
+        if self.auto_id:
+            fields.append(
+                FieldSchema(
+                    self._primary_field, DataType.INT64, is_primary=True, auto_id=True
+                )
+            )
+        else:
+            fields.append(
+                FieldSchema(
+                    self._primary_field,
+                    DataType.VARCHAR,
+                    is_primary=True,
+                    auto_id=False,
+                    max_length=65_535,
+                )
+            )
+        # Create the vector field, supports binary or float vectors
+        fields.append(
+            FieldSchema(self._vector_field, infer_dtype_bydata(embeddings[0]), dim=dim)
+        )
+
+        # Create the schema for the collection
+        schema = CollectionSchema(
+            fields,
+            description=self.collection_description,
+            partition_key_field=self._partition_key_field,
+        )
+
+        # Create the collection
+        try:
+            if self.num_shards is not None:
+                # Issue with defaults:
+                # https://github.com/milvus-io/pymilvus/blob/59bf5e811ad56e20946559317fed855330758d9c/pymilvus/client/prepare.py#L82-L85
+                self.col = Collection(
+                    name=self.collection_name,
+                    schema=schema,
+                    consistency_level=self.consistency_level,
+                    using=self.alias,
+                    num_shards=self.num_shards,
+                )
+            else:
+                self.col = Collection(
+                    name=self.collection_name,
+                    schema=schema,
+                    consistency_level=self.consistency_level,
+                    using=self.alias,
+                )
+            # Set the collection properties if they exist
+            if self.collection_properties is not None:
+                self.col.set_properties(self.collection_properties)
+        except MilvusException as e:
+            logger.error(
+                "Failed to create collection: %s error: %s", self.collection_name, e
+            )
+            raise e
+
+    def _extract_fields(self) -> None:
+        """Grab the existing fields from the Collection"""
+        from pymilvus import Collection
+
+        if isinstance(self.col, Collection):
+            schema = self.col.schema
+            for x in schema.fields:
+                self.fields.append(x.name)
+
+    def _get_index(self) -> Optional[dict[str, Any]]:
+        """Return the vector index information if it exists"""
+        from pymilvus import Collection
+
+        if isinstance(self.col, Collection):
+            for x in self.col.indexes:
+                if x.field_name == self._vector_field:
+                    return x.to_dict()
+        return None
+
+    def _create_index(self) -> None:
+        """Create a index on the collection"""
+        from pymilvus import Collection, MilvusException
+
+        if isinstance(self.col, Collection) and self._get_index() is None:
+            try:
+                # If no index params, use a default HNSW based one
+                if self.index_params is None:
+                    self.index_params = {
+                        "metric_type": "L2",
+                        "index_type": "HNSW",
+                        "params": {"M": 8, "efConstruction": 64},
+                    }
+
+                try:
+                    self.col.create_index(
+                        self._vector_field,
+                        index_params=self.index_params,
+                        using=self.alias,
+                    )
+
+                # If default did not work, most likely on Zilliz Cloud
+                except MilvusException:
+                    # Use AUTOINDEX based index
+                    self.index_params = {
+                        "metric_type": "L2",
+                        "index_type": "AUTOINDEX",
+                        "params": {},
+                    }
+                    self.col.create_index(
+                        self._vector_field,
+                        index_params=self.index_params,
+                        using=self.alias,
+                    )
+                logger.debug(
+                    "Successfully created an index on collection: %s",
+                    self.collection_name,
+                )
+
+            except MilvusException as e:
+                logger.error(
+                    "Failed to create an index on collection: %s", self.collection_name
+                )
+                raise e
+
+    def _create_search_params(self) -> None:
+        """Generate search params based on the current index type"""
+        from pymilvus import Collection
+
+        if isinstance(self.col, Collection) and self.search_params is None:
+            index = self._get_index()
+            if index is not None:
+                index_type: str = index["index_param"]["index_type"]
+                metric_type: str = index["index_param"]["metric_type"]
+                self.search_params = self.default_search_params[index_type]
+                self.search_params["metric_type"] = metric_type
+
+    def _load(
+        self,
+        partition_names: Optional[list] = None,
+        replica_number: int = 1,
+        timeout: Optional[float] = None,
+    ) -> None:
+        """Load the collection if available."""
+        from pymilvus import Collection, utility
+        from pymilvus.client.types import LoadState
+
+        timeout = self.timeout or timeout
+        if (
+            isinstance(self.col, Collection)
+            and self._get_index() is not None
+            and utility.load_state(self.collection_name, using=self.alias)
+            == LoadState.NotLoad
+        ):
+            self.col.load(
+                partition_names=partition_names,
+                replica_number=replica_number,
+                timeout=timeout,
+            )
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        timeout: Optional[float] = None,
+        batch_size: int = 1000,
+        *,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Insert text data into Milvus.
+
+        Inserting data when the collection has not be made yet will result
+        in creating a new Collection. The data of the first entity decides
+        the schema of the new collection, the dim is extracted from the first
+        embedding and the columns are decided by the first metadata dict.
+        Metadata keys will need to be present for all inserted values. At
+        the moment there is no None equivalent in Milvus.
+
+        Args:
+            texts (Iterable[str]): The texts to embed, it is assumed
+                that they all fit in memory.
+            metadatas (Optional[List[dict]]): Metadata dicts attached to each of
+                the texts. Defaults to None.
+            should be less than 65535 bytes. Required and work when auto_id is False.
+            timeout (Optional[float]): Timeout for each batch insert. Defaults
+                to None.
+            batch_size (int, optional): Batch size to use for insertion.
+                Defaults to 1000.
+            ids (Optional[List[str]]): List of text ids. The length of each item
+
+        Raises:
+            MilvusException: Failure to add texts
+
+        Returns:
+            List[str]: The resulting keys for each inserted element.
+        """
+        from pymilvus import Collection, MilvusException
+
+        texts = list(texts)
+        if not self.auto_id:
+            assert isinstance(
+                ids, list
+            ), "A list of valid ids are required when auto_id is False."
+            assert len(set(ids)) == len(
+                texts
+            ), "Different lengths of texts and unique ids are provided."
+            assert all(
+                len(x.encode()) <= 65_535 for x in ids
+            ), "Each id should be a string less than 65535 bytes."
+
+        try:
+            embeddings = self.embedding_func.embed_documents(texts)
+        except NotImplementedError:
+            embeddings = [self.embedding_func.embed_query(x) for x in texts]
+
+        if len(embeddings) == 0:
+            logger.debug("Nothing to insert, skipping.")
+            return []
+
+        # If the collection hasn't been initialized yet, perform all steps to do so
+        if not isinstance(self.col, Collection):
+            kwargs = {"embeddings": embeddings, "metadatas": metadatas}
+            if self.partition_names:
+                kwargs["partition_names"] = self.partition_names
+            if self.replica_number:
+                kwargs["replica_number"] = self.replica_number
+            if self.timeout:
+                kwargs["timeout"] = self.timeout
+            self._init(**kwargs)
+
+        # Dict to hold all insert columns
+        insert_dict: dict[str, list] = {
+            self._text_field: texts,
+            self._vector_field: embeddings,
+        }
+
+        if not self.auto_id:
+            insert_dict[self._primary_field] = ids  # type: ignore[assignment]
+
+        if self._metadata_field is not None:
+            for d in metadatas:  # type: ignore[union-attr]
+                insert_dict.setdefault(self._metadata_field, []).append(d)
+        else:
+            # Collect the metadata into the insert dict.
+            if metadatas is not None:
+                for d in metadatas:
+                    for key, value in d.items():
+                        keys = (
+                            [x for x in self.fields if x != self._primary_field]
+                            if self.auto_id
+                            else [x for x in self.fields]
+                        )
+                        if key in keys:
+                            insert_dict.setdefault(key, []).append(value)
+
+        # Total insert count
+        vectors: list = insert_dict[self._vector_field]
+        total_count = len(vectors)
+
+        pks: list[str] = []
+
+        assert isinstance(self.col, Collection)
+        for i in range(0, total_count, batch_size):
+            # Grab end index
+            end = min(i + batch_size, total_count)
+            # Convert dict to list of lists batch for insertion
+            insert_list = [
+                insert_dict[x][i:end] for x in self.fields if x in insert_dict
+            ]
+            # Insert into the collection.
+            try:
+                res: Collection
+                timeout = self.timeout or timeout
+                res = self.col.insert(insert_list, timeout=timeout, **kwargs)
+                pks.extend(res.primary_keys)
+            except MilvusException as e:
+                logger.error(
+                    "Failed to insert batch starting at entity: %s/%s", i, total_count
+                )
+                raise e
+        return pks
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        timeout: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a similarity search against the query string.
+
+        Args:
+            query (str): The text to search.
+            k (int, optional): How many results to return. Defaults to 4.
+            param (dict, optional): The search params for the index type.
+                Defaults to None.
+            expr (str, optional): Filtering expression. Defaults to None.
+            timeout (int, optional): How long to wait before timeout error.
+                Defaults to None.
+            kwargs: Collection.search() keyword arguments.
+
+        Returns:
+            List[Document]: Document results for search.
+        """
+        if self.col is None:
+            logger.debug("No existing collection to search.")
+            return []
+        timeout = self.timeout or timeout
+        res = self.similarity_search_with_score(
+            query=query, k=k, param=param, expr=expr, timeout=timeout, **kwargs
+        )
+        return [doc for doc, _ in res]
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        timeout: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a similarity search against the query string.
+
+        Args:
+            embedding (List[float]): The embedding vector to search.
+            k (int, optional): How many results to return. Defaults to 4.
+            param (dict, optional): The search params for the index type.
+                Defaults to None.
+            expr (str, optional): Filtering expression. Defaults to None.
+            timeout (int, optional): How long to wait before timeout error.
+                Defaults to None.
+            kwargs: Collection.search() keyword arguments.
+
+        Returns:
+            List[Document]: Document results for search.
+        """
+        if self.col is None:
+            logger.debug("No existing collection to search.")
+            return []
+        timeout = self.timeout or timeout
+        res = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, param=param, expr=expr, timeout=timeout, **kwargs
+        )
+        return [doc for doc, _ in res]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        timeout: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Perform a search on a query string and return results with score.
+
+        For more information about the search parameters, take a look at the pymilvus
+        documentation found here:
+        https://milvus.io/api-reference/pymilvus/v2.2.6/Collection/search().md
+
+        Args:
+            query (str): The text being searched.
+            k (int, optional): The amount of results to return. Defaults to 4.
+            param (dict): The search params for the specified index.
+                Defaults to None.
+            expr (str, optional): Filtering expression. Defaults to None.
+            timeout (float, optional): How long to wait before timeout error.
+                Defaults to None.
+            kwargs: Collection.search() keyword arguments.
+
+        Returns:
+            List[float], List[Tuple[Document, any, any]]:
+        """
+        if self.col is None:
+            logger.debug("No existing collection to search.")
+            return []
+
+        # Embed the query text.
+        embedding = self.embedding_func.embed_query(query)
+        timeout = self.timeout or timeout
+        res = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, param=param, expr=expr, timeout=timeout, **kwargs
+        )
+        return res
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        timeout: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Perform a search on a query string and return results with score.
+
+        For more information about the search parameters, take a look at the pymilvus
+        documentation found here:
+        https://milvus.io/api-reference/pymilvus/v2.2.6/Collection/search().md
+
+        Args:
+            embedding (List[float]): The embedding vector being searched.
+            k (int, optional): The amount of results to return. Defaults to 4.
+            param (dict): The search params for the specified index.
+                Defaults to None.
+            expr (str, optional): Filtering expression. Defaults to None.
+            timeout (float, optional): How long to wait before timeout error.
+                Defaults to None.
+            kwargs: Collection.search() keyword arguments.
+
+        Returns:
+            List[Tuple[Document, float]]: Result doc and score.
+        """
+        if self.col is None:
+            logger.debug("No existing collection to search.")
+            return []
+
+        if param is None:
+            param = self.search_params
+
+        # Determine result metadata fields with PK.
+        output_fields = self.fields[:]
+        output_fields.remove(self._vector_field)
+        timeout = self.timeout or timeout
+        # Perform the search.
+        res = self.col.search(
+            data=[embedding],
+            anns_field=self._vector_field,
+            param=param,
+            limit=k,
+            expr=expr,
+            output_fields=output_fields,
+            timeout=timeout,
+            **kwargs,
+        )
+        # Organize results.
+        ret = []
+        for result in res[0]:
+            data = {x: result.entity.get(x) for x in output_fields}
+            doc = self._parse_document(data)
+            pair = (doc, result.score)
+            ret.append(pair)
+
+        return ret
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        timeout: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a search and return results that are reordered by MMR.
+
+        Args:
+            query (str): The text being searched.
+            k (int, optional): How many results to give. Defaults to 4.
+            fetch_k (int, optional): Total results to select k from.
+                Defaults to 20.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5
+            param (dict, optional): The search params for the specified index.
+                Defaults to None.
+            expr (str, optional): Filtering expression. Defaults to None.
+            timeout (float, optional): How long to wait before timeout error.
+                Defaults to None.
+            kwargs: Collection.search() keyword arguments.
+
+
+        Returns:
+            List[Document]: Document results for search.
+        """
+        if self.col is None:
+            logger.debug("No existing collection to search.")
+            return []
+
+        embedding = self.embedding_func.embed_query(query)
+        timeout = self.timeout or timeout
+        return self.max_marginal_relevance_search_by_vector(
+            embedding=embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            param=param,
+            expr=expr,
+            timeout=timeout,
+            **kwargs,
+        )
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: list[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        timeout: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a search and return results that are reordered by MMR.
+
+        Args:
+            embedding (str): The embedding vector being searched.
+            k (int, optional): How many results to give. Defaults to 4.
+            fetch_k (int, optional): Total results to select k from.
+                Defaults to 20.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5
+            param (dict, optional): The search params for the specified index.
+                Defaults to None.
+            expr (str, optional): Filtering expression. Defaults to None.
+            timeout (float, optional): How long to wait before timeout error.
+                Defaults to None.
+            kwargs: Collection.search() keyword arguments.
+
+        Returns:
+            List[Document]: Document results for search.
+        """
+        if self.col is None:
+            logger.debug("No existing collection to search.")
+            return []
+
+        if param is None:
+            param = self.search_params
+
+        # Determine result metadata fields.
+        output_fields = self.fields[:]
+        output_fields.remove(self._vector_field)
+        timeout = self.timeout or timeout
+        # Perform the search.
+        res = self.col.search(
+            data=[embedding],
+            anns_field=self._vector_field,
+            param=param,
+            limit=fetch_k,
+            expr=expr,
+            output_fields=output_fields,
+            timeout=timeout,
+            **kwargs,
+        )
+        # Organize results.
+        ids = []
+        documents = []
+        scores = []
+        for result in res[0]:
+            data = {x: result.entity.get(x) for x in output_fields}
+            doc = self._parse_document(data)
+            documents.append(doc)
+            scores.append(result.score)
+            ids.append(result.id)
+
+        vectors = self.col.query(
+            expr=f"{self._primary_field} in {ids}",
+            output_fields=[self._primary_field, self._vector_field],
+            timeout=timeout,
+        )
+        # Reorganize the results from query to match search order.
+        vectors = {x[self._primary_field]: x[self._vector_field] for x in vectors}
+
+        ordered_result_embeddings = [vectors[x] for x in ids]
+
+        # Get the new order of results.
+        new_ordering = maximal_marginal_relevance(
+            np.array(embedding), ordered_result_embeddings, k=k, lambda_mult=lambda_mult
+        )
+
+        # Reorder the values and return.
+        ret = []
+        for x in new_ordering:
+            # Function can return -1 index
+            if x == -1:
+                break
+            else:
+                ret.append(documents[x])
+        return ret
+
+    def delete(  # type: ignore[no-untyped-def]
+        self, ids: Optional[List[str]] = None, expr: Optional[str] = None, **kwargs: str
+    ):
+        """Delete by vector ID or boolean expression.
+        Refer to [Milvus documentation](https://milvus.io/docs/delete_data.md)
+        for notes and examples of expressions.
+
+        Args:
+            ids: List of ids to delete.
+            expr: Boolean expression that specifies the entities to delete.
+            kwargs: Other parameters in Milvus delete api.
+        """
+        if isinstance(ids, list) and len(ids) > 0:
+            if expr is not None:
+                logger.warning(
+                    "Both ids and expr are provided. " "Ignore expr and delete by ids."
+                )
+            expr = f"{self._primary_field} in {ids}"
+        else:
+            assert isinstance(
+                expr, str
+            ), "Either ids list or expr string must be provided."
+        return self.col.delete(expr=expr, **kwargs)  # type: ignore[union-attr]
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = "LangChainCollection",
+        connection_args: dict[str, Any] = DEFAULT_MILVUS_CONNECTION,
+        consistency_level: str = "Session",
+        index_params: Optional[dict] = None,
+        search_params: Optional[dict] = None,
+        drop_old: bool = False,
+        *,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Milvus:
+        """Create a Milvus collection, indexes it with HNSW, and insert data.
+
+        Args:
+            texts (List[str]): Text data.
+            embedding (Embeddings): Embedding function.
+            metadatas (Optional[List[dict]]): Metadata for each text if it exists.
+                Defaults to None.
+            collection_name (str, optional): Collection name to use. Defaults to
+                "LangChainCollection".
+            connection_args (dict[str, Any], optional): Connection args to use. Defaults
+                to DEFAULT_MILVUS_CONNECTION.
+            consistency_level (str, optional): Which consistency level to use. Defaults
+                to "Session".
+            index_params (Optional[dict], optional): Which index_params to use. Defaults
+                to None.
+            search_params (Optional[dict], optional): Which search params to use.
+                Defaults to None.
+            drop_old (Optional[bool], optional): Whether to drop the collection with
+                that name if it exists. Defaults to False.
+            ids (Optional[List[str]]): List of text ids. Defaults to None.
+
+        Returns:
+            Milvus: Milvus Vector Store
+        """
+        if isinstance(ids, list) and len(ids) > 0:
+            auto_id = False
+        else:
+            auto_id = True
+
+        vector_db = cls(
+            embedding_function=embedding,
+            collection_name=collection_name,
+            connection_args=connection_args,
+            consistency_level=consistency_level,
+            index_params=index_params,
+            search_params=search_params,
+            drop_old=drop_old,
+            auto_id=auto_id,
+            **kwargs,
+        )
+        vector_db.add_texts(texts=texts, metadatas=metadatas, ids=ids)
+        return vector_db
+
+    def _parse_document(self, data: dict) -> Document:
+        return Document(
+            page_content=data.pop(self._text_field),
+            metadata=data.pop(self._metadata_field) if self._metadata_field else data,
+        )
+
+    def get_pks(self, expr: str, **kwargs: Any) -> List[int] | None:
+        """Get primary keys with expression
+
+        Args:
+            expr: Expression - E.g: "id in [1, 2]", or "title LIKE 'Abc%'"
+
+        Returns:
+            List[int]: List of IDs (Primary Keys)
+        """
+
+        from pymilvus import MilvusException
+
+        if self.col is None:
+            logger.debug("No existing collection to get pk.")
+            return None
+
+        try:
+            query_result = self.col.query(
+                expr=expr, output_fields=[self._primary_field]
+            )
+        except MilvusException as exc:
+            logger.error("Failed to get ids: %s error: %s", self.collection_name, exc)
+            raise exc
+        pks = [item.get(self._primary_field) for item in query_result]
+        return pks
+
+    def upsert(
+        self,
+        ids: Optional[List[str]] = None,
+        documents: List[Document] | None = None,
+        **kwargs: Any,
+    ) -> List[str] | None:
+        """Update/Insert documents to the vectorstore.
+
+        Args:
+            ids: IDs to update - Let's call get_pks to get ids with expression \n
+            documents (List[Document]): Documents to add to the vectorstore.
+
+        Returns:
+            List[str]: IDs of the added texts.
+        """
+
+        from pymilvus import MilvusException
+
+        if documents is None or len(documents) == 0:
+            logger.debug("No documents to upsert.")
+            return None
+
+        if ids is not None and len(ids):
+            try:
+                self.delete(ids=ids)
+            except MilvusException:
+                pass
+        try:
+            return self.add_documents(documents=documents, **kwargs)
+        except MilvusException as exc:
+            logger.error(
+                "Failed to upsert entities: %s error: %s", self.collection_name, exc
+            )
+            raise exc
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/momento_vector_index.py b/llm/Lib/site-packages/langchain_community/vectorstores/momento_vector_index.py
new file mode 100644
index 0000000000000000000000000000000000000000..4e2e03dd79f81b0ce7d9d22d7b22eeab1cd36fb2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/momento_vector_index.py
@@ -0,0 +1,489 @@
+import logging
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    cast,
+)
+from uuid import uuid4
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_env
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import (
+    DistanceStrategy,
+    maximal_marginal_relevance,
+)
+
+VST = TypeVar("VST", bound="VectorStore")
+
+logger = logging.getLogger(__name__)
+
+if TYPE_CHECKING:
+    from momento import PreviewVectorIndexClient
+
+
+class MomentoVectorIndex(VectorStore):
+    """`Momento Vector Index` (MVI) vector store.
+
+    Momento Vector Index is a serverless vector index that can be used to store and
+    search vectors. To use you should have the ``momento`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import OpenAIEmbeddings
+            from langchain_community.vectorstores import MomentoVectorIndex
+            from momento import (
+                CredentialProvider,
+                PreviewVectorIndexClient,
+                VectorIndexConfigurations,
+            )
+
+            vectorstore = MomentoVectorIndex(
+                embedding=OpenAIEmbeddings(),
+                client=PreviewVectorIndexClient(
+                    VectorIndexConfigurations.Default.latest(),
+                    credential_provider=CredentialProvider.from_environment_variable(
+                        "MOMENTO_API_KEY"
+                    ),
+                ),
+                index_name="my-index",
+            )
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        client: "PreviewVectorIndexClient",
+        index_name: str = "default",
+        distance_strategy: DistanceStrategy = DistanceStrategy.COSINE,
+        text_field: str = "text",
+        ensure_index_exists: bool = True,
+        **kwargs: Any,
+    ):
+        """Initialize a Vector Store backed by Momento Vector Index.
+
+        Args:
+            embedding (Embeddings): The embedding function to use.
+            configuration (VectorIndexConfiguration): The configuration to initialize
+                the Vector Index with.
+            credential_provider (CredentialProvider): The credential provider to
+                authenticate the Vector Index with.
+            index_name (str, optional): The name of the index to store the documents in.
+                Defaults to "default".
+            distance_strategy (DistanceStrategy, optional): The distance strategy to
+                use. If you select DistanceStrategy.EUCLIDEAN_DISTANCE, Momento uses
+                the squared Euclidean distance. Defaults to DistanceStrategy.COSINE.
+            text_field (str, optional): The name of the metadata field to store the
+                original text in. Defaults to "text".
+            ensure_index_exists (bool, optional): Whether to ensure that the index
+                exists before adding documents to it. Defaults to True.
+        """
+        try:
+            from momento import PreviewVectorIndexClient
+        except ImportError:
+            raise ImportError(
+                "Could not import momento python package. "
+                "Please install it with `pip install momento`."
+            )
+
+        self._client: PreviewVectorIndexClient = client
+        self._embedding = embedding
+        self.index_name = index_name
+        self.__validate_distance_strategy(distance_strategy)
+        self.distance_strategy = distance_strategy
+        self.text_field = text_field
+        self._ensure_index_exists = ensure_index_exists
+
+    @staticmethod
+    def __validate_distance_strategy(distance_strategy: DistanceStrategy) -> None:
+        if distance_strategy not in [
+            DistanceStrategy.COSINE,
+            DistanceStrategy.MAX_INNER_PRODUCT,
+            DistanceStrategy.MAX_INNER_PRODUCT,
+        ]:
+            raise ValueError(f"Distance strategy {distance_strategy} not implemented.")
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self._embedding
+
+    def _create_index_if_not_exists(self, num_dimensions: int) -> bool:
+        """Create index if it does not exist."""
+        from momento.requests.vector_index import SimilarityMetric
+        from momento.responses.vector_index import CreateIndex
+
+        similarity_metric = None
+        if self.distance_strategy == DistanceStrategy.COSINE:
+            similarity_metric = SimilarityMetric.COSINE_SIMILARITY
+        elif self.distance_strategy == DistanceStrategy.MAX_INNER_PRODUCT:
+            similarity_metric = SimilarityMetric.INNER_PRODUCT
+        elif self.distance_strategy == DistanceStrategy.EUCLIDEAN_DISTANCE:
+            similarity_metric = SimilarityMetric.EUCLIDEAN_SIMILARITY
+        else:
+            logger.error(f"Distance strategy {self.distance_strategy} not implemented.")
+            raise ValueError(
+                f"Distance strategy {self.distance_strategy} not implemented."
+            )
+
+        response = self._client.create_index(
+            self.index_name, num_dimensions, similarity_metric
+        )
+        if isinstance(response, CreateIndex.Success):
+            return True
+        elif isinstance(response, CreateIndex.IndexAlreadyExists):
+            return False
+        elif isinstance(response, CreateIndex.Error):
+            logger.error(f"Error creating index: {response.inner_exception}")
+            raise response.inner_exception
+        else:
+            logger.error(f"Unexpected response: {response}")
+            raise Exception(f"Unexpected response: {response}")
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts (Iterable[str]): Iterable of strings to add to the vectorstore.
+            metadatas (Optional[List[dict]]): Optional list of metadatas associated with
+                the texts.
+            kwargs (Any): Other optional parameters. Specifically:
+            - ids (List[str], optional): List of ids to use for the texts.
+                Defaults to None, in which case uuids are generated.
+
+        Returns:
+            List[str]: List of ids from adding the texts into the vectorstore.
+        """
+        from momento.requests.vector_index import Item
+        from momento.responses.vector_index import UpsertItemBatch
+
+        texts = list(texts)
+
+        if len(texts) == 0:
+            return []
+
+        if metadatas is not None:
+            for metadata, text in zip(metadatas, texts):
+                metadata[self.text_field] = text
+        else:
+            metadatas = [{self.text_field: text} for text in texts]
+
+        try:
+            embeddings = self._embedding.embed_documents(texts)
+        except NotImplementedError:
+            embeddings = [self._embedding.embed_query(x) for x in texts]
+
+        # Create index if it does not exist.
+        # We assume that if it does exist, then it was created with the desired number
+        # of dimensions and similarity metric.
+        if self._ensure_index_exists:
+            self._create_index_if_not_exists(len(embeddings[0]))
+
+        if "ids" in kwargs:
+            ids = kwargs["ids"]
+            if len(ids) != len(embeddings):
+                raise ValueError("Number of ids must match number of texts")
+        else:
+            ids = [str(uuid4()) for _ in range(len(embeddings))]
+
+        batch_size = 128
+        for i in range(0, len(embeddings), batch_size):
+            start = i
+            end = min(i + batch_size, len(embeddings))
+            items = [
+                Item(id=id, vector=vector, metadata=metadata)
+                for id, vector, metadata in zip(
+                    ids[start:end],
+                    embeddings[start:end],
+                    metadatas[start:end],
+                )
+            ]
+
+            response = self._client.upsert_item_batch(self.index_name, items)
+            if isinstance(response, UpsertItemBatch.Success):
+                pass
+            elif isinstance(response, UpsertItemBatch.Error):
+                raise response.inner_exception
+            else:
+                raise Exception(f"Unexpected response: {response}")
+
+        return ids
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        """Delete by vector ID.
+
+        Args:
+            ids (List[str]): List of ids to delete.
+            kwargs (Any): Other optional parameters (unused)
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+        from momento.responses.vector_index import DeleteItemBatch
+
+        if ids is None:
+            return True
+        response = self._client.delete_item_batch(self.index_name, ids)
+        return isinstance(response, DeleteItemBatch.Success)
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Search for similar documents to the query string.
+
+        Args:
+            query (str): The query string to search for.
+            k (int, optional): The number of results to return. Defaults to 4.
+
+        Returns:
+            List[Document]: A list of documents that are similar to the query.
+        """
+        res = self.similarity_search_with_score(query=query, k=k, **kwargs)
+        return [doc for doc, _ in res]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Search for similar documents to the query string.
+
+        Args:
+            query (str): The query string to search for.
+            k (int, optional): The number of results to return. Defaults to 4.
+            kwargs (Any): Vector Store specific search parameters. The following are
+                forwarded to the Momento Vector Index:
+            - top_k (int, optional): The number of results to return.
+
+        Returns:
+            List[Tuple[Document, float]]: A list of tuples of the form
+                (Document, score).
+        """
+        embedding = self._embedding.embed_query(query)
+
+        results = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, **kwargs
+        )
+        return results
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Search for similar documents to the query vector.
+
+        Args:
+            embedding (List[float]): The query vector to search for.
+            k (int, optional): The number of results to return. Defaults to 4.
+            kwargs (Any): Vector Store specific search parameters. The following are
+                forwarded to the Momento Vector Index:
+            - top_k (int, optional): The number of results to return.
+
+        Returns:
+            List[Tuple[Document, float]]: A list of tuples of the form
+                (Document, score).
+        """
+        from momento.requests.vector_index import ALL_METADATA
+        from momento.responses.vector_index import Search
+
+        if "top_k" in kwargs:
+            k = kwargs["k"]
+        filter_expression = kwargs.get("filter_expression", None)
+        response = self._client.search(
+            self.index_name,
+            embedding,
+            top_k=k,
+            metadata_fields=ALL_METADATA,
+            filter_expression=filter_expression,
+        )
+
+        if not isinstance(response, Search.Success):
+            return []
+
+        results = []
+        for hit in response.hits:
+            text = cast(str, hit.metadata.pop(self.text_field))
+            doc = Document(page_content=text, metadata=hit.metadata)
+            pair = (doc, hit.score)
+            results.append(pair)
+
+        return results
+
+    def similarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Search for similar documents to the query vector.
+
+        Args:
+            embedding (List[float]): The query vector to search for.
+            k (int, optional): The number of results to return. Defaults to 4.
+
+        Returns:
+            List[Document]: A list of documents that are similar to the query.
+        """
+        results = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, **kwargs
+        )
+        return [doc for doc, _ in results]
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        from momento.requests.vector_index import ALL_METADATA
+        from momento.responses.vector_index import SearchAndFetchVectors
+
+        filter_expression = kwargs.get("filter_expression", None)
+        response = self._client.search_and_fetch_vectors(
+            self.index_name,
+            embedding,
+            top_k=fetch_k,
+            metadata_fields=ALL_METADATA,
+            filter_expression=filter_expression,
+        )
+
+        if isinstance(response, SearchAndFetchVectors.Success):
+            pass
+        elif isinstance(response, SearchAndFetchVectors.Error):
+            logger.error(f"Error searching and fetching vectors: {response}")
+            return []
+        else:
+            logger.error(f"Unexpected response: {response}")
+            raise Exception(f"Unexpected response: {response}")
+
+        mmr_selected = maximal_marginal_relevance(
+            query_embedding=np.array([embedding], dtype=np.float32),
+            embedding_list=[hit.vector for hit in response.hits],
+            lambda_mult=lambda_mult,
+            k=k,
+        )
+        selected = [response.hits[i].metadata for i in mmr_selected]
+        return [
+            Document(page_content=metadata.pop(self.text_field, ""), metadata=metadata)  # type: ignore  # noqa: E501
+            for metadata in selected
+        ]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        embedding = self._embedding.embed_query(query)
+        return self.max_marginal_relevance_search_by_vector(
+            embedding, k, fetch_k, lambda_mult, **kwargs
+        )
+
+    @classmethod
+    def from_texts(
+        cls: Type[VST],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> VST:
+        """Return the Vector Store initialized from texts and embeddings.
+
+        Args:
+            cls (Type[VST]): The Vector Store class to use to initialize
+                the Vector Store.
+            texts (List[str]): The texts to initialize the Vector Store with.
+            embedding (Embeddings): The embedding function to use.
+            metadatas (Optional[List[dict]], optional): The metadata associated with
+                the texts. Defaults to None.
+            kwargs (Any): Vector Store specific parameters. The following are forwarded
+                to the Vector Store constructor and required:
+            - index_name (str, optional): The name of the index to store the documents
+                in. Defaults to "default".
+            - text_field (str, optional): The name of the metadata field to store the
+                original text in. Defaults to "text".
+            - distance_strategy (DistanceStrategy, optional): The distance strategy to
+                use. Defaults to DistanceStrategy.COSINE. If you select
+                DistanceStrategy.EUCLIDEAN_DISTANCE, Momento uses the squared
+                Euclidean distance.
+            - ensure_index_exists (bool, optional): Whether to ensure that the index
+                exists before adding documents to it. Defaults to True.
+            Additionally you can either pass in a client or an API key
+            - client (PreviewVectorIndexClient): The Momento Vector Index client to use.
+            - api_key (Optional[str]): The configuration to use to initialize
+                the Vector Index with. Defaults to None. If None, the configuration
+                is initialized from the environment variable `MOMENTO_API_KEY`.
+
+        Returns:
+            VST: Momento Vector Index vector store initialized from texts and
+                embeddings.
+        """
+        from momento import (
+            CredentialProvider,
+            PreviewVectorIndexClient,
+            VectorIndexConfigurations,
+        )
+
+        if "client" in kwargs:
+            client = kwargs.pop("client")
+        else:
+            supplied_api_key = kwargs.pop("api_key", None)
+            api_key = supplied_api_key or get_from_env("api_key", "MOMENTO_API_KEY")
+            client = PreviewVectorIndexClient(
+                configuration=VectorIndexConfigurations.Default.latest(),
+                credential_provider=CredentialProvider.from_string(api_key),
+            )
+        vector_db = cls(embedding=embedding, client=client, **kwargs)  # type: ignore
+        vector_db.add_texts(texts=texts, metadatas=metadatas, **kwargs)
+        return vector_db
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/mongodb_atlas.py b/llm/Lib/site-packages/langchain_community/vectorstores/mongodb_atlas.py
new file mode 100644
index 0000000000000000000000000000000000000000..ae645568f99206e3666c36940ca44fdcc9399087
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/mongodb_atlas.py
@@ -0,0 +1,376 @@
+from __future__ import annotations
+
+import logging
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Generator,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    TypeVar,
+    Union,
+)
+
+import numpy as np
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+if TYPE_CHECKING:
+    from pymongo.collection import Collection
+
+MongoDBDocumentType = TypeVar("MongoDBDocumentType", bound=Dict[str, Any])
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_INSERT_BATCH_SIZE = 100
+
+
+@deprecated(
+    since="0.0.25",
+    removal="0.2.0",
+    alternative_import="langchain_mongodb.MongoDBAtlasVectorSearch",
+)
+class MongoDBAtlasVectorSearch(VectorStore):
+    """`MongoDB Atlas Vector Search` vector store.
+
+    To use, you should have both:
+    - the ``pymongo`` python package installed
+    - a connection string associated with a MongoDB Atlas Cluster having deployed an
+        Atlas Search index
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import MongoDBAtlasVectorSearch
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+            from pymongo import MongoClient
+
+            mongo_client = MongoClient("<YOUR-CONNECTION-STRING>")
+            collection = mongo_client["<db_name>"]["<collection_name>"]
+            embeddings = OpenAIEmbeddings()
+            vectorstore = MongoDBAtlasVectorSearch(collection, embeddings)
+    """
+
+    def __init__(
+        self,
+        collection: Collection[MongoDBDocumentType],
+        embedding: Embeddings,
+        *,
+        index_name: str = "default",
+        text_key: str = "text",
+        embedding_key: str = "embedding",
+        relevance_score_fn: str = "cosine",
+    ):
+        """
+        Args:
+            collection: MongoDB collection to add the texts to.
+            embedding: Text embedding model to use.
+            text_key: MongoDB field that will contain the text for each
+                document.
+            embedding_key: MongoDB field that will contain the embedding for
+                each document.
+            index_name: Name of the Atlas Search index.
+            relevance_score_fn: The similarity score used for the index.
+            Currently supported: Euclidean, cosine, and dot product.
+        """
+        self._collection = collection
+        self._embedding = embedding
+        self._index_name = index_name
+        self._text_key = text_key
+        self._embedding_key = embedding_key
+        self._relevance_score_fn = relevance_score_fn
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self._embedding
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        if self._relevance_score_fn == "euclidean":
+            return self._euclidean_relevance_score_fn
+        elif self._relevance_score_fn == "dotProduct":
+            return self._max_inner_product_relevance_score_fn
+        elif self._relevance_score_fn == "cosine":
+            return self._cosine_relevance_score_fn
+        else:
+            raise NotImplementedError(
+                f"No relevance score function for ${self._relevance_score_fn}"
+            )
+
+    @classmethod
+    def from_connection_string(
+        cls,
+        connection_string: str,
+        namespace: str,
+        embedding: Embeddings,
+        **kwargs: Any,
+    ) -> MongoDBAtlasVectorSearch:
+        """Construct a `MongoDB Atlas Vector Search` vector store
+        from a MongoDB connection URI.
+
+        Args:
+            connection_string: A valid MongoDB connection URI.
+            namespace: A valid MongoDB namespace (database and collection).
+            embedding: The text embedding model to use for the vector store.
+
+        Returns:
+            A new MongoDBAtlasVectorSearch instance.
+
+        """
+        try:
+            from importlib.metadata import version
+
+            from pymongo import MongoClient
+            from pymongo.driver_info import DriverInfo
+        except ImportError:
+            raise ImportError(
+                "Could not import pymongo, please install it with "
+                "`pip install pymongo`."
+            )
+        client: MongoClient = MongoClient(
+            connection_string,
+            driver=DriverInfo(name="Langchain", version=version("langchain")),
+        )
+        db_name, collection_name = namespace.split(".")
+        collection = client[db_name][collection_name]
+        return cls(collection, embedding, **kwargs)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict[str, Any]]] = None,
+        **kwargs: Any,
+    ) -> List:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        batch_size = kwargs.get("batch_size", DEFAULT_INSERT_BATCH_SIZE)
+        _metadatas: Union[List, Generator] = metadatas or ({} for _ in texts)
+        texts_batch = []
+        metadatas_batch = []
+        result_ids = []
+        for i, (text, metadata) in enumerate(zip(texts, _metadatas)):
+            texts_batch.append(text)
+            metadatas_batch.append(metadata)
+            if (i + 1) % batch_size == 0:
+                result_ids.extend(self._insert_texts(texts_batch, metadatas_batch))
+                texts_batch = []
+                metadatas_batch = []
+        if texts_batch:
+            result_ids.extend(self._insert_texts(texts_batch, metadatas_batch))
+        return result_ids
+
+    def _insert_texts(self, texts: List[str], metadatas: List[Dict[str, Any]]) -> List:
+        if not texts:
+            return []
+        # Embed and create the documents
+        embeddings = self._embedding.embed_documents(texts)
+        to_insert = [
+            {self._text_key: t, self._embedding_key: embedding, **m}
+            for t, m, embedding in zip(texts, metadatas, embeddings)
+        ]
+        # insert the documents in MongoDB Atlas
+        insert_result = self._collection.insert_many(to_insert)  # type: ignore
+        return insert_result.inserted_ids
+
+    def _similarity_search_with_score(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        pre_filter: Optional[Dict] = None,
+        post_filter_pipeline: Optional[List[Dict]] = None,
+    ) -> List[Tuple[Document, float]]:
+        params = {
+            "queryVector": embedding,
+            "path": self._embedding_key,
+            "numCandidates": k * 10,
+            "limit": k,
+            "index": self._index_name,
+        }
+        if pre_filter:
+            params["filter"] = pre_filter
+        query = {"$vectorSearch": params}
+
+        pipeline = [
+            query,
+            {"$set": {"score": {"$meta": "vectorSearchScore"}}},
+        ]
+        if post_filter_pipeline is not None:
+            pipeline.extend(post_filter_pipeline)
+        cursor = self._collection.aggregate(pipeline)  # type: ignore[arg-type]
+        docs = []
+        for res in cursor:
+            text = res.pop(self._text_key)
+            score = res.pop("score")
+            docs.append((Document(page_content=text, metadata=res), score))
+        return docs
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        pre_filter: Optional[Dict] = None,
+        post_filter_pipeline: Optional[List[Dict]] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return MongoDB documents most similar to the given query and their scores.
+
+        Uses the vectorSearch operator available in MongoDB Atlas Search.
+        For more: https://www.mongodb.com/docs/atlas/atlas-vector-search/vector-search-stage/
+
+        Args:
+            query: Text to look up documents similar to.
+            k: (Optional) number of documents to return. Defaults to 4.
+            pre_filter: (Optional) dictionary of argument(s) to prefilter document
+                fields on.
+            post_filter_pipeline: (Optional) Pipeline of MongoDB aggregation stages
+                following the vectorSearch stage.
+
+        Returns:
+            List of documents most similar to the query and their scores.
+        """
+        embedding = self._embedding.embed_query(query)
+        docs = self._similarity_search_with_score(
+            embedding,
+            k=k,
+            pre_filter=pre_filter,
+            post_filter_pipeline=post_filter_pipeline,
+        )
+        return docs
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        pre_filter: Optional[Dict] = None,
+        post_filter_pipeline: Optional[List[Dict]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return MongoDB documents most similar to the given query.
+
+        Uses the vectorSearch operator available in MongoDB Atlas Search.
+        For more: https://www.mongodb.com/docs/atlas/atlas-vector-search/vector-search-stage/
+
+        Args:
+            query: Text to look up documents similar to.
+            k: (Optional) number of documents to return. Defaults to 4.
+            pre_filter: (Optional) dictionary of argument(s) to prefilter document
+                fields on.
+            post_filter_pipeline: (Optional) Pipeline of MongoDB aggregation stages
+                following the vectorSearch stage.
+
+        Returns:
+            List of documents most similar to the query and their scores.
+        """
+        additional = kwargs.get("additional")
+        docs_and_scores = self.similarity_search_with_score(
+            query,
+            k=k,
+            pre_filter=pre_filter,
+            post_filter_pipeline=post_filter_pipeline,
+        )
+
+        if additional and "similarity_score" in additional:
+            for doc, score in docs_and_scores:
+                doc.metadata["score"] = score
+        return [doc for doc, _ in docs_and_scores]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        pre_filter: Optional[Dict] = None,
+        post_filter_pipeline: Optional[List[Dict]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return documents selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: (Optional) number of documents to return. Defaults to 4.
+            fetch_k: (Optional) number of documents to fetch before passing to MMR
+                algorithm. Defaults to 20.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            pre_filter: (Optional) dictionary of argument(s) to prefilter on document
+                fields.
+            post_filter_pipeline: (Optional) pipeline of MongoDB aggregation stages
+                following the vectorSearch stage.
+        Returns:
+            List of documents selected by maximal marginal relevance.
+        """
+        query_embedding = self._embedding.embed_query(query)
+        docs = self._similarity_search_with_score(
+            query_embedding,
+            k=fetch_k,
+            pre_filter=pre_filter,
+            post_filter_pipeline=post_filter_pipeline,
+        )
+        mmr_doc_indexes = maximal_marginal_relevance(
+            np.array(query_embedding),
+            [doc.metadata[self._embedding_key] for doc, _ in docs],
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+        mmr_docs = [docs[i][0] for i in mmr_doc_indexes]
+        return mmr_docs
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[Dict]] = None,
+        collection: Optional[Collection[MongoDBDocumentType]] = None,
+        **kwargs: Any,
+    ) -> MongoDBAtlasVectorSearch:
+        """Construct a `MongoDB Atlas Vector Search` vector store from raw documents.
+
+        This is a user-friendly interface that:
+            1. Embeds documents.
+            2. Adds the documents to a provided MongoDB Atlas Vector Search index
+                (Lucene)
+
+        This is intended to be a quick way to get started.
+
+        Example:
+            .. code-block:: python
+                from pymongo import MongoClient
+
+                from langchain_community.vectorstores import MongoDBAtlasVectorSearch
+                from langchain_community.embeddings import OpenAIEmbeddings
+
+                mongo_client = MongoClient("<YOUR-CONNECTION-STRING>")
+                collection = mongo_client["<db_name>"]["<collection_name>"]
+                embeddings = OpenAIEmbeddings()
+                vectorstore = MongoDBAtlasVectorSearch.from_texts(
+                    texts,
+                    embeddings,
+                    metadatas=metadatas,
+                    collection=collection
+                )
+        """
+        if collection is None:
+            raise ValueError("Must provide 'collection' named parameter.")
+        vectorstore = cls(collection, embedding, **kwargs)
+        vectorstore.add_texts(texts, metadatas=metadatas)
+        return vectorstore
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/myscale.py b/llm/Lib/site-packages/langchain_community/vectorstores/myscale.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc90b27c0e50af43501113c35375e36eea662e6f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/myscale.py
@@ -0,0 +1,615 @@
+from __future__ import annotations
+
+import json
+import logging
+from hashlib import sha1
+from threading import Thread
+from typing import Any, Dict, Iterable, List, Optional, Tuple
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseSettings
+from langchain_core.vectorstores import VectorStore
+
+logger = logging.getLogger()
+
+
+def has_mul_sub_str(s: str, *args: Any) -> bool:
+    """
+    Check if a string contains multiple substrings.
+    Args:
+        s: string to check.
+        *args: substrings to check.
+
+    Returns:
+        True if all substrings are in the string, False otherwise.
+    """
+    for a in args:
+        if a not in s:
+            return False
+    return True
+
+
+class MyScaleSettings(BaseSettings):
+    """MyScale client configuration.
+
+    Attribute:
+        myscale_host (str) : An URL to connect to MyScale backend.
+                             Defaults to 'localhost'.
+        myscale_port (int) : URL port to connect with HTTP. Defaults to 8443.
+        username (str) : Username to login. Defaults to None.
+        password (str) : Password to login. Defaults to None.
+        index_type (str): index type string.
+        index_param (dict): index build parameter.
+        database (str) : Database name to find the table. Defaults to 'default'.
+        table (str) : Table name to operate on.
+                      Defaults to 'vector_table'.
+        metric (str) : Metric to compute distance,
+                       supported are ('L2', 'Cosine', 'IP'). Defaults to 'Cosine'.
+        column_map (Dict) : Column type map to project column name onto langchain
+                            semantics. Must have keys: `text`, `id`, `vector`,
+                            must be same size to number of columns. For example:
+                            .. code-block:: python
+
+                                {
+                                    'id': 'text_id',
+                                    'vector': 'text_embedding',
+                                    'text': 'text_plain',
+                                    'metadata': 'metadata_dictionary_in_json',
+                                }
+
+                            Defaults to identity map.
+
+    """
+
+    host: str = "localhost"
+    port: int = 8443
+
+    username: Optional[str] = None
+    password: Optional[str] = None
+
+    index_type: str = "MSTG"
+    index_param: Optional[Dict[str, str]] = None
+
+    column_map: Dict[str, str] = {
+        "id": "id",
+        "text": "text",
+        "vector": "vector",
+        "metadata": "metadata",
+    }
+
+    database: str = "default"
+    table: str = "langchain"
+    metric: str = "Cosine"
+
+    def __getitem__(self, item: str) -> Any:
+        return getattr(self, item)
+
+    class Config:
+        env_file = ".env"
+        env_prefix = "myscale_"
+        env_file_encoding = "utf-8"
+
+
+class MyScale(VectorStore):
+    """`MyScale` vector store.
+
+    You need a `clickhouse-connect` python package, and a valid account
+    to connect to MyScale.
+
+    MyScale can not only search with simple vector indexes.
+    It also supports a complex query with multiple conditions,
+    constraints and even sub-queries.
+
+    For more information, please visit
+        [myscale official site](https://docs.myscale.com/en/overview/)
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        config: Optional[MyScaleSettings] = None,
+        **kwargs: Any,
+    ) -> None:
+        """MyScale Wrapper to LangChain
+
+        embedding (Embeddings):
+        config (MyScaleSettings): Configuration to MyScale Client
+        Other keyword arguments will pass into
+            [clickhouse-connect](https://docs.myscale.com/)
+        """
+        try:
+            from clickhouse_connect import get_client
+        except ImportError:
+            raise ImportError(
+                "Could not import clickhouse connect python package. "
+                "Please install it with `pip install clickhouse-connect`."
+            )
+        try:
+            from tqdm import tqdm
+
+            self.pgbar = tqdm
+        except ImportError:
+            # Just in case if tqdm is not installed
+            self.pgbar = lambda x: x
+        super().__init__()
+        if config is not None:
+            self.config = config
+        else:
+            self.config = MyScaleSettings()
+        assert self.config
+        assert self.config.host and self.config.port
+        assert (
+            self.config.column_map
+            and self.config.database
+            and self.config.table
+            and self.config.metric
+        )
+        for k in ["id", "vector", "text", "metadata"]:
+            assert k in self.config.column_map
+        assert self.config.metric.upper() in ["IP", "COSINE", "L2"]
+        if self.config.metric in ["ip", "cosine", "l2"]:
+            logger.warning(
+                "Lower case metric types will be deprecated "
+                "the future. Please use one of ('IP', 'Cosine', 'L2')"
+            )
+
+        # initialize the schema
+        dim = len(embedding.embed_query("try this out"))
+
+        index_params = (
+            ", " + ",".join([f"'{k}={v}'" for k, v in self.config.index_param.items()])
+            if self.config.index_param
+            else ""
+        )
+        schema_ = f"""
+            CREATE TABLE IF NOT EXISTS {self.config.database}.{self.config.table}(
+                {self.config.column_map['id']} String,
+                {self.config.column_map['text']} String,
+                {self.config.column_map['vector']} Array(Float32),
+                {self.config.column_map['metadata']} JSON,
+                CONSTRAINT cons_vec_len CHECK length(\
+                    {self.config.column_map['vector']}) = {dim},
+                VECTOR INDEX vidx {self.config.column_map['vector']} \
+                    TYPE {self.config.index_type}(\
+                        'metric_type={self.config.metric}'{index_params})
+            ) ENGINE = MergeTree ORDER BY {self.config.column_map['id']}
+        """
+        self.dim = dim
+        self.BS = "\\"
+        self.must_escape = ("\\", "'")
+        self._embeddings = embedding
+        self.dist_order = (
+            "ASC" if self.config.metric.upper() in ["COSINE", "L2"] else "DESC"
+        )
+
+        # Create a connection to myscale
+        self.client = get_client(
+            host=self.config.host,
+            port=self.config.port,
+            username=self.config.username,
+            password=self.config.password,
+            **kwargs,
+        )
+        self.client.command("SET allow_experimental_object_type=1")
+        self.client.command(schema_)
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self._embeddings
+
+    def escape_str(self, value: str) -> str:
+        return "".join(f"{self.BS}{c}" if c in self.must_escape else c for c in value)
+
+    def _build_istr(self, transac: Iterable, column_names: Iterable[str]) -> str:
+        ks = ",".join(column_names)
+        _data = []
+        for n in transac:
+            n = ",".join([f"'{self.escape_str(str(_n))}'" for _n in n])
+            _data.append(f"({n})")
+        i_str = f"""
+                INSERT INTO TABLE 
+                    {self.config.database}.{self.config.table}({ks})
+                VALUES
+                {','.join(_data)}
+                """
+        return i_str
+
+    def _insert(self, transac: Iterable, column_names: Iterable[str]) -> None:
+        _i_str = self._build_istr(transac, column_names)
+        self.client.command(_i_str)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        batch_size: int = 32,
+        ids: Optional[Iterable[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            ids: Optional list of ids to associate with the texts.
+            batch_size: Batch size of insertion
+            metadata: Optional column data to be inserted
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+
+        """
+        # Embed and create the documents
+        ids = ids or [sha1(t.encode("utf-8")).hexdigest() for t in texts]
+        colmap_ = self.config.column_map
+
+        transac = []
+        column_names = {
+            colmap_["id"]: ids,
+            colmap_["text"]: texts,
+            colmap_["vector"]: map(self._embeddings.embed_query, texts),
+        }
+        metadatas = metadatas or [{} for _ in texts]
+        column_names[colmap_["metadata"]] = map(json.dumps, metadatas)
+        assert len(set(colmap_) - set(column_names)) >= 0
+        keys, values = zip(*column_names.items())
+        try:
+            t = None
+            for v in self.pgbar(
+                zip(*values), desc="Inserting data...", total=len(metadatas)
+            ):
+                assert len(v[keys.index(self.config.column_map["vector"])]) == self.dim
+                transac.append(v)
+                if len(transac) == batch_size:
+                    if t:
+                        t.join()
+                    t = Thread(target=self._insert, args=[transac, keys])
+                    t.start()
+                    transac = []
+            if len(transac) > 0:
+                if t:
+                    t.join()
+                self._insert(transac, keys)
+            return [i for i in ids]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: Iterable[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        config: Optional[MyScaleSettings] = None,
+        text_ids: Optional[Iterable[str]] = None,
+        batch_size: int = 32,
+        **kwargs: Any,
+    ) -> MyScale:
+        """Create Myscale wrapper with existing texts
+
+        Args:
+            texts (Iterable[str]): List or tuple of strings to be added
+            embedding (Embeddings): Function to extract text embedding
+            config (MyScaleSettings, Optional): Myscale configuration
+            text_ids (Optional[Iterable], optional): IDs for the texts.
+                                                     Defaults to None.
+            batch_size (int, optional): Batchsize when transmitting data to MyScale.
+                                        Defaults to 32.
+            metadata (List[dict], optional): metadata to texts. Defaults to None.
+            Other keyword arguments will pass into
+                [clickhouse-connect](https://clickhouse.com/docs/en/integrations/python#clickhouse-connect-driver-api)
+        Returns:
+            MyScale Index
+        """
+        ctx = cls(embedding, config, **kwargs)
+        ctx.add_texts(texts, ids=text_ids, batch_size=batch_size, metadatas=metadatas)
+        return ctx
+
+    def __repr__(self) -> str:
+        """Text representation for myscale, prints backends, username and schemas.
+            Easy to use with `str(Myscale())`
+
+        Returns:
+            repr: string to show connection info and data schema
+        """
+        _repr = f"\033[92m\033[1m{self.config.database}.{self.config.table} @ "
+        _repr += f"{self.config.host}:{self.config.port}\033[0m\n\n"
+        _repr += f"\033[1musername: {self.config.username}\033[0m\n\nTable Schema:\n"
+        _repr += "-" * 51 + "\n"
+        for r in self.client.query(
+            f"DESC {self.config.database}.{self.config.table}"
+        ).named_results():
+            _repr += (
+                f"|\033[94m{r['name']:24s}\033[0m|\033[96m{r['type']:24s}\033[0m|\n"
+            )
+        _repr += "-" * 51 + "\n"
+        return _repr
+
+    def _build_qstr(
+        self, q_emb: List[float], topk: int, where_str: Optional[str] = None
+    ) -> str:
+        q_emb_str = ",".join(map(str, q_emb))
+        if where_str:
+            where_str = f"PREWHERE {where_str}"
+        else:
+            where_str = ""
+
+        q_str = f"""
+            SELECT {self.config.column_map['text']}, 
+                {self.config.column_map['metadata']}, dist
+            FROM {self.config.database}.{self.config.table}
+            {where_str}
+            ORDER BY distance({self.config.column_map['vector']}, [{q_emb_str}]) 
+                AS dist {self.dist_order}
+            LIMIT {topk}
+            """
+        return q_str
+
+    def similarity_search(
+        self, query: str, k: int = 4, where_str: Optional[str] = None, **kwargs: Any
+    ) -> List[Document]:
+        """Perform a similarity search with MyScale
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of Documents
+        """
+        return self.similarity_search_by_vector(
+            self._embeddings.embed_query(query), k, where_str, **kwargs
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        where_str: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a similarity search with MyScale by vectors
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of (Document, similarity)
+        """
+        q_str = self._build_qstr(embedding, k, where_str)
+        try:
+            return [
+                Document(
+                    page_content=r[self.config.column_map["text"]],
+                    metadata=r[self.config.column_map["metadata"]],
+                )
+                for r in self.client.query(q_str).named_results()
+            ]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    def similarity_search_with_relevance_scores(
+        self, query: str, k: int = 4, where_str: Optional[str] = None, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Perform a similarity search with MyScale
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of documents most similar to the query text
+            and cosine distance in float for each.
+            Lower score represents more similarity.
+        """
+        q_str = self._build_qstr(self._embeddings.embed_query(query), k, where_str)
+        try:
+            return [
+                (
+                    Document(
+                        page_content=r[self.config.column_map["text"]],
+                        metadata=r[self.config.column_map["metadata"]],
+                    ),
+                    r["dist"],
+                )
+                for r in self.client.query(q_str).named_results()
+            ]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    def drop(self) -> None:
+        """
+        Helper function: Drop data
+        """
+        self.client.command(
+            f"DROP TABLE IF EXISTS {self.config.database}.{self.config.table}"
+        )
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        where_str: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Optional[bool]:
+        """Delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+        assert not (
+            ids is None and where_str is None
+        ), "You need to specify where to be deleted! Either with `ids` or `where_str`"
+        conds = []
+        if ids and len(ids) > 0:
+            id_list = ", ".join([f"'{id}'" for id in ids])
+            conds.append(f"{self.config.column_map['id']} IN ({id_list})")
+        if where_str:
+            conds.append(where_str)
+        assert len(conds) > 0
+        where_str_final = " AND ".join(conds)
+        qstr = (
+            f"DELETE FROM {self.config.database}.{self.config.table} "
+            f"WHERE {where_str_final}"
+        )
+        try:
+            self.client.command(qstr)
+            return True
+        except Exception as e:
+            logger.error(str(e))
+            return False
+
+    @property
+    def metadata_column(self) -> str:
+        return self.config.column_map["metadata"]
+
+
+class MyScaleWithoutJSON(MyScale):
+    """MyScale vector store without metadata column
+
+    This is super handy if you are working to a SQL-native table
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        config: Optional[MyScaleSettings] = None,
+        must_have_cols: List[str] = [],
+        **kwargs: Any,
+    ) -> None:
+        """Building a myscale vector store without metadata column
+
+        embedding (Embeddings): embedding model
+        config (MyScaleSettings): Configuration to MyScale Client
+        must_have_cols (List[str]): column names to be included in query
+        Other keyword arguments will pass into
+            [clickhouse-connect](https://docs.myscale.com/)
+        """
+        super().__init__(embedding, config, **kwargs)
+        self.must_have_cols: List[str] = must_have_cols
+
+    def _build_qstr(
+        self, q_emb: List[float], topk: int, where_str: Optional[str] = None
+    ) -> str:
+        q_emb_str = ",".join(map(str, q_emb))
+        if where_str:
+            where_str = f"PREWHERE {where_str}"
+        else:
+            where_str = ""
+
+        q_str = f"""
+            SELECT {self.config.column_map['text']}, dist, 
+                {','.join(self.must_have_cols)}
+            FROM {self.config.database}.{self.config.table}
+            {where_str}
+            ORDER BY distance({self.config.column_map['vector']}, [{q_emb_str}]) 
+                AS dist {self.dist_order}
+            LIMIT {topk}
+            """
+        return q_str
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        where_str: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a similarity search with MyScale by vectors
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of (Document, similarity)
+        """
+        q_str = self._build_qstr(embedding, k, where_str)
+        try:
+            return [
+                Document(
+                    page_content=r[self.config.column_map["text"]],
+                    metadata={k: r[k] for k in self.must_have_cols},
+                )
+                for r in self.client.query(q_str).named_results()
+            ]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    def similarity_search_with_relevance_scores(
+        self, query: str, k: int = 4, where_str: Optional[str] = None, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Perform a similarity search with MyScale
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of documents most similar to the query text
+            and cosine distance in float for each.
+            Lower score represents more similarity.
+        """
+        q_str = self._build_qstr(self._embeddings.embed_query(query), k, where_str)
+        try:
+            return [
+                (
+                    Document(
+                        page_content=r[self.config.column_map["text"]],
+                        metadata={k: r[k] for k in self.must_have_cols},
+                    ),
+                    r["dist"],
+                )
+                for r in self.client.query(q_str).named_results()
+            ]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    @property
+    def metadata_column(self) -> str:
+        return ""
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/neo4j_vector.py b/llm/Lib/site-packages/langchain_community/vectorstores/neo4j_vector.py
new file mode 100644
index 0000000000000000000000000000000000000000..3a9c57de42a9876d2af3519852a906cd17c15e00
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/neo4j_vector.py
@@ -0,0 +1,1458 @@
+from __future__ import annotations
+
+import enum
+import logging
+import os
+from hashlib import md5
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+)
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_dict_or_env
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import DistanceStrategy
+
+DEFAULT_DISTANCE_STRATEGY = DistanceStrategy.COSINE
+DISTANCE_MAPPING = {
+    DistanceStrategy.EUCLIDEAN_DISTANCE: "euclidean",
+    DistanceStrategy.COSINE: "cosine",
+}
+
+COMPARISONS_TO_NATIVE = {
+    "$eq": "=",
+    "$ne": "<>",
+    "$lt": "<",
+    "$lte": "<=",
+    "$gt": ">",
+    "$gte": ">=",
+}
+
+SPECIAL_CASED_OPERATORS = {
+    "$in",
+    "$nin",
+    "$between",
+}
+
+TEXT_OPERATORS = {
+    "$like",
+    "$ilike",
+}
+
+LOGICAL_OPERATORS = {"$and", "$or"}
+
+SUPPORTED_OPERATORS = (
+    set(COMPARISONS_TO_NATIVE)
+    .union(TEXT_OPERATORS)
+    .union(LOGICAL_OPERATORS)
+    .union(SPECIAL_CASED_OPERATORS)
+)
+
+
+class SearchType(str, enum.Enum):
+    """Enumerator of the Distance strategies."""
+
+    VECTOR = "vector"
+    HYBRID = "hybrid"
+
+
+DEFAULT_SEARCH_TYPE = SearchType.VECTOR
+
+
+class IndexType(str, enum.Enum):
+    """Enumerator of the index types."""
+
+    NODE = "NODE"
+    RELATIONSHIP = "RELATIONSHIP"
+
+
+DEFAULT_INDEX_TYPE = IndexType.NODE
+
+
+def _get_search_index_query(
+    search_type: SearchType, index_type: IndexType = DEFAULT_INDEX_TYPE
+) -> str:
+    if index_type == IndexType.NODE:
+        type_to_query_map = {
+            SearchType.VECTOR: (
+                "CALL db.index.vector.queryNodes($index, $k, $embedding) "
+                "YIELD node, score "
+            ),
+            SearchType.HYBRID: (
+                "CALL { "
+                "CALL db.index.vector.queryNodes($index, $k, $embedding) "
+                "YIELD node, score "
+                "WITH collect({node:node, score:score}) AS nodes, max(score) AS max "
+                "UNWIND nodes AS n "
+                # We use 0 as min
+                "RETURN n.node AS node, (n.score / max) AS score UNION "
+                "CALL db.index.fulltext.queryNodes($keyword_index, $query, "
+                "{limit: $k}) YIELD node, score "
+                "WITH collect({node:node, score:score}) AS nodes, max(score) AS max "
+                "UNWIND nodes AS n "
+                # We use 0 as min
+                "RETURN n.node AS node, (n.score / max) AS score "
+                "} "
+                # dedup
+                "WITH node, max(score) AS score ORDER BY score DESC LIMIT $k "
+            ),
+        }
+        return type_to_query_map[search_type]
+    else:
+        return (
+            "CALL db.index.vector.queryRelationships($index, $k, $embedding) "
+            "YIELD relationship, score "
+        )
+
+
+def check_if_not_null(props: List[str], values: List[Any]) -> None:
+    """Check if the values are not None or empty string"""
+    for prop, value in zip(props, values):
+        if not value:
+            raise ValueError(f"Parameter `{prop}` must not be None or empty string")
+
+
+def sort_by_index_name(
+    lst: List[Dict[str, Any]], index_name: str
+) -> List[Dict[str, Any]]:
+    """Sort first element to match the index_name if exists"""
+    return sorted(lst, key=lambda x: x.get("name") != index_name)
+
+
+def remove_lucene_chars(text: str) -> str:
+    """Remove Lucene special characters"""
+    special_chars = [
+        "+",
+        "-",
+        "&",
+        "|",
+        "!",
+        "(",
+        ")",
+        "{",
+        "}",
+        "[",
+        "]",
+        "^",
+        '"',
+        "~",
+        "*",
+        "?",
+        ":",
+        "\\",
+    ]
+    for char in special_chars:
+        if char in text:
+            text = text.replace(char, " ")
+    return text.strip()
+
+
+def dict_to_yaml_str(input_dict: Dict, indent: int = 0) -> str:
+    """
+    Convert a dictionary to a YAML-like string without using external libraries.
+
+    Parameters:
+    - input_dict (dict): The dictionary to convert.
+    - indent (int): The current indentation level.
+
+    Returns:
+    - str: The YAML-like string representation of the input dictionary.
+    """
+    yaml_str = ""
+    for key, value in input_dict.items():
+        padding = "  " * indent
+        if isinstance(value, dict):
+            yaml_str += f"{padding}{key}:\n{dict_to_yaml_str(value, indent + 1)}"
+        elif isinstance(value, list):
+            yaml_str += f"{padding}{key}:\n"
+            for item in value:
+                yaml_str += f"{padding}- {item}\n"
+        else:
+            yaml_str += f"{padding}{key}: {value}\n"
+    return yaml_str
+
+
+def combine_queries(
+    input_queries: List[Tuple[str, Dict[str, Any]]], operator: str
+) -> Tuple[str, Dict[str, Any]]:
+    """Combine multiple queries with an operator."""
+
+    # Initialize variables to hold the combined query and parameters
+    combined_query: str = ""
+    combined_params: Dict = {}
+    param_counter: Dict = {}
+
+    for query, params in input_queries:
+        # Process each query fragment and its parameters
+        new_query = query
+        for param, value in params.items():
+            # Update the parameter name to ensure uniqueness
+            if param in param_counter:
+                param_counter[param] += 1
+            else:
+                param_counter[param] = 1
+            new_param_name = f"{param}_{param_counter[param]}"
+
+            # Replace the parameter in the query fragment
+            new_query = new_query.replace(f"${param}", f"${new_param_name}")
+            # Add the parameter to the combined parameters dictionary
+            combined_params[new_param_name] = value
+
+        # Combine the query fragments with an AND operator
+        if combined_query:
+            combined_query += f" {operator} "
+        combined_query += f"({new_query})"
+
+    return combined_query, combined_params
+
+
+def collect_params(
+    input_data: List[Tuple[str, Dict[str, str]]],
+) -> Tuple[List[str], Dict[str, Any]]:
+    """Transform the input data into the desired format.
+
+    Args:
+    - input_data (list of tuples): Input data to transform.
+      Each tuple contains a string and a dictionary.
+
+    Returns:
+    - tuple: A tuple containing a list of strings and a dictionary.
+    """
+    # Initialize variables to hold the output parts
+    query_parts = []
+    params = {}
+
+    # Loop through each item in the input data
+    for query_part, param in input_data:
+        # Append the query part to the list
+        query_parts.append(query_part)
+        # Update the params dictionary with the param dictionary
+        params.update(param)
+
+    # Return the transformed data
+    return (query_parts, params)
+
+
+def _handle_field_filter(
+    field: str, value: Any, param_number: int = 1
+) -> Tuple[str, Dict]:
+    """Create a filter for a specific field.
+
+    Args:
+        field: name of field
+        value: value to filter
+            If provided as is then this will be an equality filter
+            If provided as a dictionary then this will be a filter, the key
+            will be the operator and the value will be the value to filter by
+        param_number: sequence number of parameters used to map between param
+           dict and Cypher snippet
+
+    Returns a tuple of
+        - Cypher filter snippet
+        - Dictionary with parameters used in filter snippet
+    """
+    if not isinstance(field, str):
+        raise ValueError(
+            f"field should be a string but got: {type(field)} with value: {field}"
+        )
+
+    if field.startswith("$"):
+        raise ValueError(
+            f"Invalid filter condition. Expected a field but got an operator: "
+            f"{field}"
+        )
+
+    # Allow [a-zA-Z0-9_], disallow $ for now until we support escape characters
+    if not field.isidentifier():
+        raise ValueError(f"Invalid field name: {field}. Expected a valid identifier.")
+
+    if isinstance(value, dict):
+        # This is a filter specification
+        if len(value) != 1:
+            raise ValueError(
+                "Invalid filter condition. Expected a value which "
+                "is a dictionary with a single key that corresponds to an operator "
+                f"but got a dictionary with {len(value)} keys. The first few "
+                f"keys are: {list(value.keys())[:3]}"
+            )
+        operator, filter_value = list(value.items())[0]
+        # Verify that that operator is an operator
+        if operator not in SUPPORTED_OPERATORS:
+            raise ValueError(
+                f"Invalid operator: {operator}. "
+                f"Expected one of {SUPPORTED_OPERATORS}"
+            )
+    else:  # Then we assume an equality operator
+        operator = "$eq"
+        filter_value = value
+
+    if operator in COMPARISONS_TO_NATIVE:
+        # Then we implement an equality filter
+        # native is trusted input
+        native = COMPARISONS_TO_NATIVE[operator]
+        query_snippet = f"n.`{field}` {native} $param_{param_number}"
+        query_param = {f"param_{param_number}": filter_value}
+        return (query_snippet, query_param)
+    elif operator == "$between":
+        low, high = filter_value
+        query_snippet = (
+            f"$param_{param_number}_low <= n.`{field}` <= $param_{param_number}_high"
+        )
+        query_param = {
+            f"param_{param_number}_low": low,
+            f"param_{param_number}_high": high,
+        }
+        return (query_snippet, query_param)
+
+    elif operator in {"$in", "$nin", "$like", "$ilike"}:
+        # We'll do force coercion to text
+        if operator in {"$in", "$nin"}:
+            for val in filter_value:
+                if not isinstance(val, (str, int, float)):
+                    raise NotImplementedError(
+                        f"Unsupported type: {type(val)} for value: {val}"
+                    )
+        if operator in {"$in"}:
+            query_snippet = f"n.`{field}` IN $param_{param_number}"
+            query_param = {f"param_{param_number}": filter_value}
+            return (query_snippet, query_param)
+        elif operator in {"$nin"}:
+            query_snippet = f"n.`{field}` NOT IN $param_{param_number}"
+            query_param = {f"param_{param_number}": filter_value}
+            return (query_snippet, query_param)
+        elif operator in {"$like"}:
+            query_snippet = f"n.`{field}` CONTAINS $param_{param_number}"
+            query_param = {f"param_{param_number}": filter_value.rstrip("%")}
+            return (query_snippet, query_param)
+        elif operator in {"$ilike"}:
+            query_snippet = f"toLower(n.`{field}`) CONTAINS $param_{param_number}"
+            query_param = {f"param_{param_number}": filter_value.rstrip("%")}
+            return (query_snippet, query_param)
+        else:
+            raise NotImplementedError()
+    else:
+        raise NotImplementedError()
+
+
+def construct_metadata_filter(filter: Dict[str, Any]) -> Tuple[str, Dict]:
+    """Construct a metadata filter.
+
+    Args:
+        filter: A dictionary representing the filter condition.
+
+    Returns:
+        Tuple[str, Dict]
+    """
+
+    if isinstance(filter, dict):
+        if len(filter) == 1:
+            # The only operators allowed at the top level are $AND and $OR
+            # First check if an operator or a field
+            key, value = list(filter.items())[0]
+            if key.startswith("$"):
+                # Then it's an operator
+                if key.lower() not in ["$and", "$or"]:
+                    raise ValueError(
+                        f"Invalid filter condition. Expected $and or $or "
+                        f"but got: {key}"
+                    )
+            else:
+                # Then it's a field
+                return _handle_field_filter(key, filter[key])
+
+            # Here we handle the $and and $or operators
+            if not isinstance(value, list):
+                raise ValueError(
+                    f"Expected a list, but got {type(value)} for value: {value}"
+                )
+            if key.lower() == "$and":
+                and_ = combine_queries(
+                    [construct_metadata_filter(el) for el in value], "AND"
+                )
+                if len(and_) >= 1:
+                    return and_
+                else:
+                    raise ValueError(
+                        "Invalid filter condition. Expected a dictionary "
+                        "but got an empty dictionary"
+                    )
+            elif key.lower() == "$or":
+                or_ = combine_queries(
+                    [construct_metadata_filter(el) for el in value], "OR"
+                )
+                if len(or_) >= 1:
+                    return or_
+                else:
+                    raise ValueError(
+                        "Invalid filter condition. Expected a dictionary "
+                        "but got an empty dictionary"
+                    )
+            else:
+                raise ValueError(
+                    f"Invalid filter condition. Expected $and or $or " f"but got: {key}"
+                )
+        elif len(filter) > 1:
+            # Then all keys have to be fields (they cannot be operators)
+            for key in filter.keys():
+                if key.startswith("$"):
+                    raise ValueError(
+                        f"Invalid filter condition. Expected a field but got: {key}"
+                    )
+            # These should all be fields and combined using an $and operator
+            and_multiple = collect_params(
+                [
+                    _handle_field_filter(k, v, index)
+                    for index, (k, v) in enumerate(filter.items())
+                ]
+            )
+            if len(and_multiple) >= 1:
+                return " AND ".join(and_multiple[0]), and_multiple[1]
+            else:
+                raise ValueError(
+                    "Invalid filter condition. Expected a dictionary "
+                    "but got an empty dictionary"
+                )
+        else:
+            raise ValueError("Got an empty dictionary for filters.")
+
+
+class Neo4jVector(VectorStore):
+    """`Neo4j` vector index.
+
+    To use, you should have the ``neo4j`` python package installed.
+
+    Args:
+        url: Neo4j connection url
+        username: Neo4j username.
+        password: Neo4j password
+        database: Optionally provide Neo4j database
+                  Defaults to "neo4j"
+        embedding: Any embedding function implementing
+            `langchain.embeddings.base.Embeddings` interface.
+        distance_strategy: The distance strategy to use. (default: COSINE)
+        pre_delete_collection: If True, will delete existing data if it exists.
+            (default: False). Useful for testing.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores.neo4j_vector import Neo4jVector
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+            url="bolt://localhost:7687"
+            username="neo4j"
+            password="pleaseletmein"
+            embeddings = OpenAIEmbeddings()
+            vectorestore = Neo4jVector.from_documents(
+                embedding=embeddings,
+                documents=docs,
+                url=url
+                username=username,
+                password=password,
+            )
+
+
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        *,
+        search_type: SearchType = SearchType.VECTOR,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        url: Optional[str] = None,
+        keyword_index_name: Optional[str] = "keyword",
+        database: Optional[str] = None,
+        index_name: str = "vector",
+        node_label: str = "Chunk",
+        embedding_node_property: str = "embedding",
+        text_node_property: str = "text",
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        logger: Optional[logging.Logger] = None,
+        pre_delete_collection: bool = False,
+        retrieval_query: str = "",
+        relevance_score_fn: Optional[Callable[[float], float]] = None,
+        index_type: IndexType = DEFAULT_INDEX_TYPE,
+    ) -> None:
+        try:
+            import neo4j
+        except ImportError:
+            raise ImportError(
+                "Could not import neo4j python package. "
+                "Please install it with `pip install neo4j`."
+            )
+
+        # Allow only cosine and euclidean distance strategies
+        if distance_strategy not in [
+            DistanceStrategy.EUCLIDEAN_DISTANCE,
+            DistanceStrategy.COSINE,
+        ]:
+            raise ValueError(
+                "distance_strategy must be either 'EUCLIDEAN_DISTANCE' or 'COSINE'"
+            )
+
+        # Handle if the credentials are environment variables
+
+        # Support URL for backwards compatibility
+        if not url:
+            url = os.environ.get("NEO4J_URL")
+
+        url = get_from_dict_or_env({"url": url}, "url", "NEO4J_URI")
+        username = get_from_dict_or_env(
+            {"username": username}, "username", "NEO4J_USERNAME"
+        )
+        password = get_from_dict_or_env(
+            {"password": password}, "password", "NEO4J_PASSWORD"
+        )
+        database = get_from_dict_or_env(
+            {"database": database}, "database", "NEO4J_DATABASE", "neo4j"
+        )
+
+        self._driver = neo4j.GraphDatabase.driver(url, auth=(username, password))
+        self._database = database
+        self.schema = ""
+        # Verify connection
+        try:
+            self._driver.verify_connectivity()
+        except neo4j.exceptions.ServiceUnavailable:
+            raise ValueError(
+                "Could not connect to Neo4j database. "
+                "Please ensure that the url is correct"
+            )
+        except neo4j.exceptions.AuthError:
+            raise ValueError(
+                "Could not connect to Neo4j database. "
+                "Please ensure that the username and password are correct"
+            )
+
+        # Verify if the version support vector index
+        self._is_enterprise = False
+        self.verify_version()
+
+        # Verify that required values are not null
+        check_if_not_null(
+            [
+                "index_name",
+                "node_label",
+                "embedding_node_property",
+                "text_node_property",
+            ],
+            [index_name, node_label, embedding_node_property, text_node_property],
+        )
+
+        self.embedding = embedding
+        self._distance_strategy = distance_strategy
+        self.index_name = index_name
+        self.keyword_index_name = keyword_index_name
+        self.node_label = node_label
+        self.embedding_node_property = embedding_node_property
+        self.text_node_property = text_node_property
+        self.logger = logger or logging.getLogger(__name__)
+        self.override_relevance_score_fn = relevance_score_fn
+        self.retrieval_query = retrieval_query
+        self.search_type = search_type
+        self._index_type = index_type
+        # Calculate embedding dimension
+        self.embedding_dimension = len(embedding.embed_query("foo"))
+
+        # Delete existing data if flagged
+        if pre_delete_collection:
+            from neo4j.exceptions import DatabaseError
+
+            self.query(
+                f"MATCH (n:`{self.node_label}`) "
+                "CALL { WITH n DETACH DELETE n } "
+                "IN TRANSACTIONS OF 10000 ROWS;"
+            )
+            # Delete index
+            try:
+                self.query(f"DROP INDEX {self.index_name}")
+            except DatabaseError:  # Index didn't exist yet
+                pass
+
+    def query(
+        self, query: str, *, params: Optional[dict] = None
+    ) -> List[Dict[str, Any]]:
+        """
+        This method sends a Cypher query to the connected Neo4j database
+        and returns the results as a list of dictionaries.
+
+        Args:
+            query (str): The Cypher query to execute.
+            params (dict, optional): Dictionary of query parameters. Defaults to {}.
+
+        Returns:
+            List[Dict[str, Any]]: List of dictionaries containing the query results.
+        """
+        from neo4j.exceptions import CypherSyntaxError
+
+        params = params or {}
+        with self._driver.session(database=self._database) as session:
+            try:
+                data = session.run(query, params)
+                return [r.data() for r in data]
+            except CypherSyntaxError as e:
+                raise ValueError(f"Cypher Statement is not valid\n{e}")
+
+    def verify_version(self) -> None:
+        """
+        Check if the connected Neo4j database version supports vector indexing.
+
+        Queries the Neo4j database to retrieve its version and compares it
+        against a target version (5.11.0) that is known to support vector
+        indexing. Raises a ValueError if the connected Neo4j version is
+        not supported.
+        """
+        db_data = self.query("CALL dbms.components()")
+        version = db_data[0]["versions"][0]
+        if "aura" in version:
+            version_tuple = tuple(map(int, version.split("-")[0].split("."))) + (0,)
+        else:
+            version_tuple = tuple(map(int, version.split(".")))
+
+        target_version = (5, 11, 0)
+
+        if version_tuple < target_version:
+            raise ValueError(
+                "Version index is only supported in Neo4j version 5.11 or greater"
+            )
+
+        # Flag for metadata filtering
+        metadata_target_version = (5, 18, 0)
+        if version_tuple < metadata_target_version:
+            self.support_metadata_filter = False
+        else:
+            self.support_metadata_filter = True
+        # Flag for enterprise
+        self._is_enterprise = True if db_data[0]["edition"] == "enterprise" else False
+
+    def retrieve_existing_index(self) -> Tuple[Optional[int], Optional[str]]:
+        """
+        Check if the vector index exists in the Neo4j database
+        and returns its embedding dimension.
+
+        This method queries the Neo4j database for existing indexes
+        and attempts to retrieve the dimension of the vector index
+        with the specified name. If the index exists, its dimension is returned.
+        If the index doesn't exist, `None` is returned.
+
+        Returns:
+            int or None: The embedding dimension of the existing index if found.
+        """
+
+        index_information = self.query(
+            "SHOW INDEXES YIELD name, type, entityType, labelsOrTypes, "
+            "properties, options WHERE type = 'VECTOR' AND (name = $index_name "
+            "OR (labelsOrTypes[0] = $node_label AND "
+            "properties[0] = $embedding_node_property)) "
+            "RETURN name, entityType, labelsOrTypes, properties, options ",
+            params={
+                "index_name": self.index_name,
+                "node_label": self.node_label,
+                "embedding_node_property": self.embedding_node_property,
+            },
+        )
+        # sort by index_name
+        index_information = sort_by_index_name(index_information, self.index_name)
+        try:
+            self.index_name = index_information[0]["name"]
+            self.node_label = index_information[0]["labelsOrTypes"][0]
+            self.embedding_node_property = index_information[0]["properties"][0]
+            self._index_type = index_information[0]["entityType"]
+            embedding_dimension = index_information[0]["options"]["indexConfig"][
+                "vector.dimensions"
+            ]
+
+            return embedding_dimension, index_information[0]["entityType"]
+        except IndexError:
+            return None, None
+
+    def retrieve_existing_fts_index(
+        self, text_node_properties: List[str] = []
+    ) -> Optional[str]:
+        """
+        Check if the fulltext index exists in the Neo4j database
+
+        This method queries the Neo4j database for existing fts indexes
+        with the specified name.
+
+        Returns:
+            (Tuple): keyword index information
+        """
+
+        index_information = self.query(
+            "SHOW INDEXES YIELD name, type, labelsOrTypes, properties, options "
+            "WHERE type = 'FULLTEXT' AND (name = $keyword_index_name "
+            "OR (labelsOrTypes = [$node_label] AND "
+            "properties = $text_node_property)) "
+            "RETURN name, labelsOrTypes, properties, options ",
+            params={
+                "keyword_index_name": self.keyword_index_name,
+                "node_label": self.node_label,
+                "text_node_property": text_node_properties or [self.text_node_property],
+            },
+        )
+        # sort by index_name
+        index_information = sort_by_index_name(index_information, self.index_name)
+        try:
+            self.keyword_index_name = index_information[0]["name"]
+            self.text_node_property = index_information[0]["properties"][0]
+            node_label = index_information[0]["labelsOrTypes"][0]
+            return node_label
+        except IndexError:
+            return None
+
+    def create_new_index(self) -> None:
+        """
+        This method constructs a Cypher query and executes it
+        to create a new vector index in Neo4j.
+        """
+        index_query = (
+            "CALL db.index.vector.createNodeIndex("
+            "$index_name,"
+            "$node_label,"
+            "$embedding_node_property,"
+            "toInteger($embedding_dimension),"
+            "$similarity_metric )"
+        )
+
+        parameters = {
+            "index_name": self.index_name,
+            "node_label": self.node_label,
+            "embedding_node_property": self.embedding_node_property,
+            "embedding_dimension": self.embedding_dimension,
+            "similarity_metric": DISTANCE_MAPPING[self._distance_strategy],
+        }
+        self.query(index_query, params=parameters)
+
+    def create_new_keyword_index(self, text_node_properties: List[str] = []) -> None:
+        """
+        This method constructs a Cypher query and executes it
+        to create a new full text index in Neo4j.
+        """
+        node_props = text_node_properties or [self.text_node_property]
+        fts_index_query = (
+            f"CREATE FULLTEXT INDEX {self.keyword_index_name} "
+            f"FOR (n:`{self.node_label}`) ON EACH "
+            f"[{', '.join(['n.`' + el + '`' for el in node_props])}]"
+        )
+        self.query(fts_index_query)
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding
+
+    @classmethod
+    def __from(
+        cls,
+        texts: List[str],
+        embeddings: List[List[float]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        create_id_index: bool = True,
+        search_type: SearchType = SearchType.VECTOR,
+        **kwargs: Any,
+    ) -> Neo4jVector:
+        if ids is None:
+            ids = [md5(text.encode("utf-8")).hexdigest() for text in texts]
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        store = cls(
+            embedding=embedding,
+            search_type=search_type,
+            **kwargs,
+        )
+        # Check if the vector index already exists
+        embedding_dimension, index_type = store.retrieve_existing_index()
+
+        # Raise error if relationship index type
+        if index_type == "RELATIONSHIP":
+            raise ValueError(
+                "Data ingestion is not supported with relationship vector index."
+            )
+
+        # If the vector index doesn't exist yet
+        if not embedding_dimension:
+            store.create_new_index()
+        # If the index already exists, check if embedding dimensions match
+        elif not store.embedding_dimension == embedding_dimension:
+            raise ValueError(
+                f"Index with name {store.index_name} already exists."
+                "The provided embedding function and vector index "
+                "dimensions do not match.\n"
+                f"Embedding function dimension: {store.embedding_dimension}\n"
+                f"Vector index dimension: {embedding_dimension}"
+            )
+
+        if search_type == SearchType.HYBRID:
+            fts_node_label = store.retrieve_existing_fts_index()
+            # If the FTS index doesn't exist yet
+            if not fts_node_label:
+                store.create_new_keyword_index()
+            else:  # Validate that FTS and Vector index use the same information
+                if not fts_node_label == store.node_label:
+                    raise ValueError(
+                        "Vector and keyword index don't index the same node label"
+                    )
+
+        # Create unique constraint for faster import
+        if create_id_index:
+            store.query(
+                "CREATE CONSTRAINT IF NOT EXISTS "
+                f"FOR (n:`{store.node_label}`) REQUIRE n.id IS UNIQUE;"
+            )
+
+        store.add_embeddings(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+        return store
+
+    def add_embeddings(
+        self,
+        texts: Iterable[str],
+        embeddings: List[List[float]],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add embeddings to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            embeddings: List of list of embedding vectors.
+            metadatas: List of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+        """
+        if ids is None:
+            ids = [md5(text.encode("utf-8")).hexdigest() for text in texts]
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        import_query = (
+            "UNWIND $data AS row "
+            "CALL { WITH row "
+            f"MERGE (c:`{self.node_label}` {{id: row.id}}) "
+            "WITH c, row "
+            f"CALL db.create.setVectorProperty(c, "
+            f"'{self.embedding_node_property}', row.embedding) "
+            "YIELD node "
+            f"SET c.`{self.text_node_property}` = row.text "
+            "SET c += row.metadata } IN TRANSACTIONS OF 1000 ROWS"
+        )
+
+        parameters = {
+            "data": [
+                {"text": text, "metadata": metadata, "embedding": embedding, "id": id}
+                for text, metadata, embedding, id in zip(
+                    texts, metadatas, embeddings, ids
+                )
+            ]
+        }
+
+        self.query(import_query, params=parameters)
+
+        return ids
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        embeddings = self.embedding.embed_documents(list(texts))
+        return self.add_embeddings(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        params: Dict[str, Any] = {},
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search with Neo4jVector.
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        embedding = self.embedding.embed_query(text=query)
+        return self.similarity_search_by_vector(
+            embedding=embedding,
+            k=k,
+            query=query,
+            params=params,
+            filter=filter,
+            **kwargs,
+        )
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        params: Dict[str, Any] = {},
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        embedding = self.embedding.embed_query(query)
+        docs = self.similarity_search_with_score_by_vector(
+            embedding=embedding,
+            k=k,
+            query=query,
+            params=params,
+            filter=filter,
+            **kwargs,
+        )
+        return docs
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        params: Dict[str, Any] = {},
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """
+        Perform a similarity search in the Neo4j database using a
+        given vector and return the top k similar documents with their scores.
+
+        This method uses a Cypher query to find the top k documents that
+        are most similar to a given embedding. The similarity is measured
+        using a vector index in the Neo4j database. The results are returned
+        as a list of tuples, each containing a Document object and
+        its similarity score.
+
+        Args:
+            embedding (List[float]): The embedding vector to compare against.
+            k (int, optional): The number of top similar documents to retrieve.
+
+        Returns:
+            List[Tuple[Document, float]]: A list of tuples, each containing
+                                a Document object and its similarity score.
+        """
+        if filter:
+            # Verify that 5.18 or later is used
+            if not self.support_metadata_filter:
+                raise ValueError(
+                    "Metadata filtering is only supported in "
+                    "Neo4j version 5.18 or greater"
+                )
+            # Metadata filtering and hybrid doesn't work
+            if self.search_type == SearchType.HYBRID:
+                raise ValueError(
+                    "Metadata filtering can't be use in combination with "
+                    "a hybrid search approach"
+                )
+            parallel_query = (
+                "CYPHER runtime = parallel parallelRuntimeSupport=all "
+                if self._is_enterprise
+                else ""
+            )
+            base_index_query = parallel_query + (
+                f"MATCH (n:`{self.node_label}`) WHERE "
+                f"n.`{self.embedding_node_property}` IS NOT NULL AND "
+                f"size(n.`{self.embedding_node_property}`) = "
+                f"toInteger({self.embedding_dimension}) AND "
+            )
+            base_cosine_query = (
+                " WITH n as node, vector.similarity.cosine("
+                f"n.`{self.embedding_node_property}`, "
+                "$embedding) AS score ORDER BY score DESC LIMIT toInteger($k) "
+            )
+            filter_snippets, filter_params = construct_metadata_filter(filter)
+            index_query = base_index_query + filter_snippets + base_cosine_query
+
+        else:
+            index_query = _get_search_index_query(self.search_type, self._index_type)
+            filter_params = {}
+
+        if self._index_type == IndexType.RELATIONSHIP:
+            default_retrieval = (
+                f"RETURN relationship.`{self.text_node_property}` AS text, score, "
+                f"relationship {{.*, `{self.text_node_property}`: Null, "
+                f"`{self.embedding_node_property}`: Null, id: Null }} AS metadata"
+            )
+        else:
+            default_retrieval = (
+                f"RETURN node.`{self.text_node_property}` AS text, score, "
+                f"node {{.*, `{self.text_node_property}`: Null, "
+                f"`{self.embedding_node_property}`: Null, id: Null }} AS metadata"
+            )
+
+        retrieval_query = (
+            self.retrieval_query if self.retrieval_query else default_retrieval
+        )
+
+        read_query = index_query + retrieval_query
+        parameters = {
+            "index": self.index_name,
+            "k": k,
+            "embedding": embedding,
+            "keyword_index": self.keyword_index_name,
+            "query": remove_lucene_chars(kwargs["query"]),
+            **params,
+            **filter_params,
+        }
+
+        results = self.query(read_query, params=parameters)
+
+        docs = [
+            (
+                Document(
+                    page_content=dict_to_yaml_str(result["text"])
+                    if isinstance(result["text"], dict)
+                    else result["text"],
+                    metadata={
+                        k: v for k, v in result["metadata"].items() if v is not None
+                    },
+                ),
+                result["score"],
+            )
+            for result in results
+        ]
+        return docs
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    @classmethod
+    def from_texts(
+        cls: Type[Neo4jVector],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Neo4jVector:
+        """
+        Return Neo4jVector initialized from texts and embeddings.
+        Neo4j credentials are required in the form of `url`, `username`,
+        and `password` and optional `database` parameters.
+        """
+        embeddings = embedding.embed_documents(list(texts))
+
+        return cls.__from(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            distance_strategy=distance_strategy,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_embeddings(
+        cls,
+        text_embeddings: List[Tuple[str, List[float]]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> Neo4jVector:
+        """Construct Neo4jVector wrapper from raw documents and pre-
+        generated embeddings.
+
+        Return Neo4jVector initialized from documents and embeddings.
+        Neo4j credentials are required in the form of `url`, `username`,
+        and `password` and optional `database` parameters.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores.neo4j_vector import Neo4jVector
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                text_embeddings = embeddings.embed_documents(texts)
+                text_embedding_pairs = list(zip(texts, text_embeddings))
+                vectorstore = Neo4jVector.from_embeddings(
+                    text_embedding_pairs, embeddings)
+        """
+        texts = [t[0] for t in text_embeddings]
+        embeddings = [t[1] for t in text_embeddings]
+
+        return cls.__from(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_existing_index(
+        cls: Type[Neo4jVector],
+        embedding: Embeddings,
+        index_name: str,
+        search_type: SearchType = DEFAULT_SEARCH_TYPE,
+        keyword_index_name: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Neo4jVector:
+        """
+        Get instance of an existing Neo4j vector index. This method will
+        return the instance of the store without inserting any new
+        embeddings.
+        Neo4j credentials are required in the form of `url`, `username`,
+        and `password` and optional `database` parameters along with
+        the `index_name` definition.
+        """
+
+        if search_type == SearchType.HYBRID and not keyword_index_name:
+            raise ValueError(
+                "keyword_index name has to be specified "
+                "when using hybrid search option"
+            )
+
+        store = cls(
+            embedding=embedding,
+            index_name=index_name,
+            keyword_index_name=keyword_index_name,
+            search_type=search_type,
+            **kwargs,
+        )
+
+        embedding_dimension, index_type = store.retrieve_existing_index()
+
+        # Raise error if relationship index type
+        if index_type == "RELATIONSHIP":
+            raise ValueError(
+                "Relationship vector index is not supported with "
+                "`from_existing_index` method. Please use the "
+                "`from_existing_relationship_index` method."
+            )
+
+        if not embedding_dimension:
+            raise ValueError(
+                "The specified vector index name does not exist. "
+                "Make sure to check if you spelled it correctly"
+            )
+
+        # Check if embedding function and vector index dimensions match
+        if not store.embedding_dimension == embedding_dimension:
+            raise ValueError(
+                "The provided embedding function and vector index "
+                "dimensions do not match.\n"
+                f"Embedding function dimension: {store.embedding_dimension}\n"
+                f"Vector index dimension: {embedding_dimension}"
+            )
+
+        if search_type == SearchType.HYBRID:
+            fts_node_label = store.retrieve_existing_fts_index()
+            # If the FTS index doesn't exist yet
+            if not fts_node_label:
+                raise ValueError(
+                    "The specified keyword index name does not exist. "
+                    "Make sure to check if you spelled it correctly"
+                )
+            else:  # Validate that FTS and Vector index use the same information
+                if not fts_node_label == store.node_label:
+                    raise ValueError(
+                        "Vector and keyword index don't index the same node label"
+                    )
+
+        return store
+
+    @classmethod
+    def from_existing_relationship_index(
+        cls: Type[Neo4jVector],
+        embedding: Embeddings,
+        index_name: str,
+        search_type: SearchType = DEFAULT_SEARCH_TYPE,
+        **kwargs: Any,
+    ) -> Neo4jVector:
+        """
+        Get instance of an existing Neo4j relationship vector index.
+        This method will return the instance of the store without
+        inserting any new embeddings.
+        Neo4j credentials are required in the form of `url`, `username`,
+        and `password` and optional `database` parameters along with
+        the `index_name` definition.
+        """
+
+        if search_type == SearchType.HYBRID:
+            raise ValueError(
+                "Hybrid search is not supported in combination "
+                "with relationship vector index"
+            )
+
+        store = cls(
+            embedding=embedding,
+            index_name=index_name,
+            **kwargs,
+        )
+
+        embedding_dimension, index_type = store.retrieve_existing_index()
+
+        if not embedding_dimension:
+            raise ValueError(
+                "The specified vector index name does not exist. "
+                "Make sure to check if you spelled it correctly"
+            )
+        # Raise error if relationship index type
+        if index_type == "NODE":
+            raise ValueError(
+                "Node vector index is not supported with "
+                "`from_existing_relationship_index` method. Please use the "
+                "`from_existing_index` method."
+            )
+
+        # Check if embedding function and vector index dimensions match
+        if not store.embedding_dimension == embedding_dimension:
+            raise ValueError(
+                "The provided embedding function and vector index "
+                "dimensions do not match.\n"
+                f"Embedding function dimension: {store.embedding_dimension}\n"
+                f"Vector index dimension: {embedding_dimension}"
+            )
+
+        return store
+
+    @classmethod
+    def from_documents(
+        cls: Type[Neo4jVector],
+        documents: List[Document],
+        embedding: Embeddings,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Neo4jVector:
+        """
+        Return Neo4jVector initialized from documents and embeddings.
+        Neo4j credentials are required in the form of `url`, `username`,
+        and `password` and optional `database` parameters.
+        """
+
+        texts = [d.page_content for d in documents]
+        metadatas = [d.metadata for d in documents]
+
+        return cls.from_texts(
+            texts=texts,
+            embedding=embedding,
+            distance_strategy=distance_strategy,
+            metadatas=metadatas,
+            ids=ids,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_existing_graph(
+        cls: Type[Neo4jVector],
+        embedding: Embeddings,
+        node_label: str,
+        embedding_node_property: str,
+        text_node_properties: List[str],
+        *,
+        keyword_index_name: Optional[str] = "keyword",
+        index_name: str = "vector",
+        search_type: SearchType = DEFAULT_SEARCH_TYPE,
+        retrieval_query: str = "",
+        **kwargs: Any,
+    ) -> Neo4jVector:
+        """
+        Initialize and return a Neo4jVector instance from an existing graph.
+
+        This method initializes a Neo4jVector instance using the provided
+        parameters and the existing graph. It validates the existence of
+        the indices and creates new ones if they don't exist.
+
+        Returns:
+        Neo4jVector: An instance of Neo4jVector initialized with the provided parameters
+                    and existing graph.
+
+        Example:
+        >>> neo4j_vector = Neo4jVector.from_existing_graph(
+        ...     embedding=my_embedding,
+        ...     node_label="Document",
+        ...     embedding_node_property="embedding",
+        ...     text_node_properties=["title", "content"]
+        ... )
+
+        Note:
+        Neo4j credentials are required in the form of `url`, `username`, and `password`,
+        and optional `database` parameters passed as additional keyword arguments.
+        """
+        # Validate the list is not empty
+        if not text_node_properties:
+            raise ValueError(
+                "Parameter `text_node_properties` must not be an empty list"
+            )
+        # Prefer retrieval query from params, otherwise construct it
+        if not retrieval_query:
+            retrieval_query = (
+                f"RETURN reduce(str='', k IN {text_node_properties} |"
+                " str + '\\n' + k + ': ' + coalesce(node[k], '')) AS text, "
+                "node {.*, `"
+                + embedding_node_property
+                + "`: Null, id: Null, "
+                + ", ".join([f"`{prop}`: Null" for prop in text_node_properties])
+                + "} AS metadata, score"
+            )
+        store = cls(
+            embedding=embedding,
+            index_name=index_name,
+            keyword_index_name=keyword_index_name,
+            search_type=search_type,
+            retrieval_query=retrieval_query,
+            node_label=node_label,
+            embedding_node_property=embedding_node_property,
+            **kwargs,
+        )
+
+        # Check if the vector index already exists
+        embedding_dimension, index_type = store.retrieve_existing_index()
+
+        # Raise error if relationship index type
+        if index_type == "RELATIONSHIP":
+            raise ValueError(
+                "`from_existing_graph` method does not support "
+                " existing relationship vector index. "
+                "Please use `from_existing_relationship_index` method"
+            )
+
+        # If the vector index doesn't exist yet
+        if not embedding_dimension:
+            store.create_new_index()
+        # If the index already exists, check if embedding dimensions match
+        elif not store.embedding_dimension == embedding_dimension:
+            raise ValueError(
+                f"Index with name {store.index_name} already exists."
+                "The provided embedding function and vector index "
+                "dimensions do not match.\n"
+                f"Embedding function dimension: {store.embedding_dimension}\n"
+                f"Vector index dimension: {embedding_dimension}"
+            )
+        # FTS index for Hybrid search
+        if search_type == SearchType.HYBRID:
+            fts_node_label = store.retrieve_existing_fts_index(text_node_properties)
+            # If the FTS index doesn't exist yet
+            if not fts_node_label:
+                store.create_new_keyword_index(text_node_properties)
+            else:  # Validate that FTS and Vector index use the same information
+                if not fts_node_label == store.node_label:
+                    raise ValueError(
+                        "Vector and keyword index don't index the same node label"
+                    )
+
+        # Populate embeddings
+        while True:
+            fetch_query = (
+                f"MATCH (n:`{node_label}`) "
+                f"WHERE n.{embedding_node_property} IS null "
+                "AND any(k in $props WHERE n[k] IS NOT null) "
+                f"RETURN elementId(n) AS id, reduce(str='',"
+                "k IN $props | str + '\\n' + k + ':' + coalesce(n[k], '')) AS text "
+                "LIMIT 1000"
+            )
+            data = store.query(fetch_query, params={"props": text_node_properties})
+            text_embeddings = embedding.embed_documents([el["text"] for el in data])
+
+            params = {
+                "data": [
+                    {"id": el["id"], "embedding": embedding}
+                    for el, embedding in zip(data, text_embeddings)
+                ]
+            }
+
+            store.query(
+                "UNWIND $data AS row "
+                f"MATCH (n:`{node_label}`) "
+                "WHERE elementId(n) = row.id "
+                f"CALL db.create.setVectorProperty(n, "
+                f"'{embedding_node_property}', row.embedding) "
+                "YIELD node RETURN count(*)",
+                params=params,
+            )
+            # If embedding calculation should be stopped
+            if len(data) < 1000:
+                break
+        return store
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+        """
+        if self.override_relevance_score_fn is not None:
+            return self.override_relevance_score_fn
+
+        # Default strategy is to rely on distance strategy provided
+        # in vectorstore constructor
+        if self._distance_strategy == DistanceStrategy.COSINE:
+            return lambda x: x
+        elif self._distance_strategy == DistanceStrategy.EUCLIDEAN_DISTANCE:
+            return lambda x: x
+        else:
+            raise ValueError(
+                "No supported normalization function"
+                f" for distance_strategy of {self._distance_strategy}."
+                "Consider providing relevance_score_fn to PGVector constructor."
+            )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/nucliadb.py b/llm/Lib/site-packages/langchain_community/vectorstores/nucliadb.py
new file mode 100644
index 0000000000000000000000000000000000000000..d20e51bbc7cbc9950fb310d97746e86b538e9dc4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/nucliadb.py
@@ -0,0 +1,159 @@
+import os
+from typing import Any, Dict, Iterable, List, Optional, Type
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VST, VectorStore
+
+FIELD_TYPES = {
+    "f": "files",
+    "t": "texts",
+    "l": "links",
+}
+
+
+class NucliaDB(VectorStore):
+    """NucliaDB vector store."""
+
+    _config: Dict[str, Any] = {}
+
+    def __init__(
+        self,
+        knowledge_box: str,
+        local: bool,
+        api_key: Optional[str] = None,
+        backend: Optional[str] = None,
+    ) -> None:
+        """Initialize the NucliaDB client.
+
+        Args:
+            knowledge_box: the Knowledge Box id.
+            local: Whether to use a local NucliaDB instance or Nuclia Cloud
+            api_key: A contributor API key for the kb (needed when local is False)
+            backend: The backend url to use when local is True, defaults to
+            http://localhost:8080
+        """
+        try:
+            from nuclia.sdk import NucliaAuth
+        except ImportError:
+            raise ValueError(
+                "nuclia python package not found. "
+                "Please install it with `pip install nuclia`."
+            )
+        self._config["LOCAL"] = local
+        zone = os.environ.get("NUCLIA_ZONE", "europe-1")
+        self._kb = knowledge_box
+        if local:
+            if not backend:
+                backend = "http://localhost:8080"
+            self._config["BACKEND"] = f"{backend}/api/v1"
+            self._config["TOKEN"] = None
+            NucliaAuth().nucliadb(url=backend)
+            NucliaAuth().kb(url=self.kb_url, interactive=False)
+        else:
+            self._config["BACKEND"] = f"https://{zone}.nuclia.cloud/api/v1"
+            self._config["TOKEN"] = api_key
+            NucliaAuth().kb(
+                url=self.kb_url, token=self._config["TOKEN"], interactive=False
+            )
+
+    @property
+    def is_local(self) -> str:
+        return self._config["LOCAL"]
+
+    @property
+    def kb_url(self) -> str:
+        return f"{self._config['BACKEND']}/kb/{self._kb}"
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Upload texts to NucliaDB"""
+        ids = []
+        from nuclia.sdk import NucliaResource
+
+        factory = NucliaResource()
+        for i, text in enumerate(texts):
+            extra: Dict[str, Any] = {"metadata": ""}
+            if metadatas:
+                extra = {"metadata": metadatas[i]}
+            id = factory.create(
+                texts={"text": {"body": text}},
+                extra=extra,
+                url=self.kb_url,
+                api_key=self._config["TOKEN"],
+            )
+            ids.append(id)
+        return ids
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        if not ids:
+            return None
+        from nuclia.sdk import NucliaResource
+
+        factory = NucliaResource()
+        results: List[bool] = []
+        for id in ids:
+            try:
+                factory.delete(rid=id, url=self.kb_url, api_key=self._config["TOKEN"])
+                results.append(True)
+            except ValueError:
+                results.append(False)
+        return all(results)
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        from nuclia.sdk import NucliaSearch
+        from nucliadb_models.search import FindRequest, ResourceProperties
+
+        request = FindRequest(
+            query=query,
+            page_size=k,
+            show=[ResourceProperties.VALUES, ResourceProperties.EXTRA],
+        )
+        search = NucliaSearch()
+        results = search.find(
+            query=request, url=self.kb_url, api_key=self._config["TOKEN"]
+        )
+        paragraphs = []
+        for resource in results.resources.values():
+            for field in resource.fields.values():
+                for paragraph_id, paragraph in field.paragraphs.items():
+                    info = paragraph_id.split("/")
+                    field_type = FIELD_TYPES.get(info[1], None)
+                    field_id = info[2]
+                    if not field_type:
+                        continue
+                    value = getattr(resource.data, field_type, {}).get(field_id, None)
+                    paragraphs.append(
+                        {
+                            "text": paragraph.text,
+                            "metadata": {
+                                "extra": getattr(
+                                    getattr(resource, "extra", {}), "metadata", None
+                                ),
+                                "value": value,
+                            },
+                            "order": paragraph.order,
+                        }
+                    )
+        sorted_paragraphs = sorted(paragraphs, key=lambda x: x["order"])
+        return [
+            Document(page_content=paragraph["text"], metadata=paragraph["metadata"])
+            for paragraph in sorted_paragraphs
+        ]
+
+    @classmethod
+    def from_texts(
+        cls: Type[VST],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> VST:
+        """Return VectorStore initialized from texts and embeddings."""
+        raise NotImplementedError
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/opensearch_vector_search.py b/llm/Lib/site-packages/langchain_community/vectorstores/opensearch_vector_search.py
new file mode 100644
index 0000000000000000000000000000000000000000..5f28de34ef544c296e31afe9757c820708c0ef81
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/opensearch_vector_search.py
@@ -0,0 +1,1350 @@
+from __future__ import annotations
+
+import uuid
+import warnings
+from typing import Any, Dict, Iterable, List, Optional, Tuple
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_dict_or_env
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+IMPORT_OPENSEARCH_PY_ERROR = (
+    "Could not import OpenSearch. Please install it with `pip install opensearch-py`."
+)
+IMPORT_ASYNC_OPENSEARCH_PY_ERROR = """
+Could not import AsyncOpenSearch. 
+Please install it with `pip install opensearch-py`."""
+
+SCRIPT_SCORING_SEARCH = "script_scoring"
+PAINLESS_SCRIPTING_SEARCH = "painless_scripting"
+MATCH_ALL_QUERY = {"match_all": {}}  # type: Dict
+
+
+def _import_opensearch() -> Any:
+    """Import OpenSearch if available, otherwise raise error."""
+    try:
+        from opensearchpy import OpenSearch
+    except ImportError:
+        raise ImportError(IMPORT_OPENSEARCH_PY_ERROR)
+    return OpenSearch
+
+
+def _import_async_opensearch() -> Any:
+    """Import AsyncOpenSearch if available, otherwise raise error."""
+    try:
+        from opensearchpy import AsyncOpenSearch
+    except ImportError:
+        raise ImportError(IMPORT_ASYNC_OPENSEARCH_PY_ERROR)
+    return AsyncOpenSearch
+
+
+def _import_bulk() -> Any:
+    """Import bulk if available, otherwise raise error."""
+    try:
+        from opensearchpy.helpers import bulk
+    except ImportError:
+        raise ImportError(IMPORT_OPENSEARCH_PY_ERROR)
+    return bulk
+
+
+def _import_async_bulk() -> Any:
+    """Import async_bulk if available, otherwise raise error."""
+    try:
+        from opensearchpy.helpers import async_bulk
+    except ImportError:
+        raise ImportError(IMPORT_ASYNC_OPENSEARCH_PY_ERROR)
+    return async_bulk
+
+
+def _import_not_found_error() -> Any:
+    """Import not found error if available, otherwise raise error."""
+    try:
+        from opensearchpy.exceptions import NotFoundError
+    except ImportError:
+        raise ImportError(IMPORT_OPENSEARCH_PY_ERROR)
+    return NotFoundError
+
+
+def _get_opensearch_client(opensearch_url: str, **kwargs: Any) -> Any:
+    """Get OpenSearch client from the opensearch_url, otherwise raise error."""
+    try:
+        opensearch = _import_opensearch()
+        client = opensearch(opensearch_url, **kwargs)
+    except ValueError as e:
+        raise ImportError(
+            f"OpenSearch client string provided is not in proper format. "
+            f"Got error: {e} "
+        )
+    return client
+
+
+def _get_async_opensearch_client(opensearch_url: str, **kwargs: Any) -> Any:
+    """Get AsyncOpenSearch client from the opensearch_url, otherwise raise error."""
+    try:
+        async_opensearch = _import_async_opensearch()
+        client = async_opensearch(opensearch_url, **kwargs)
+    except ValueError as e:
+        raise ImportError(
+            f"AsyncOpenSearch client string provided is not in proper format. "
+            f"Got error: {e} "
+        )
+    return client
+
+
+def _validate_embeddings_and_bulk_size(embeddings_length: int, bulk_size: int) -> None:
+    """Validate Embeddings Length and Bulk Size."""
+    if embeddings_length == 0:
+        raise RuntimeError("Embeddings size is zero")
+    if bulk_size < embeddings_length:
+        raise RuntimeError(
+            f"The embeddings count, {embeddings_length} is more than the "
+            f"[bulk_size], {bulk_size}. Increase the value of [bulk_size]."
+        )
+
+
+def _validate_aoss_with_engines(is_aoss: bool, engine: str) -> None:
+    """Validate AOSS with the engine."""
+    if is_aoss and engine != "nmslib" and engine != "faiss":
+        raise ValueError(
+            "Amazon OpenSearch Service Serverless only "
+            "supports `nmslib` or `faiss` engines"
+        )
+
+
+def _is_aoss_enabled(http_auth: Any) -> bool:
+    """Check if the service is http_auth is set as `aoss`."""
+    if (
+        http_auth is not None
+        and hasattr(http_auth, "service")
+        and http_auth.service == "aoss"
+    ):
+        return True
+    return False
+
+
+def _bulk_ingest_embeddings(
+    client: Any,
+    index_name: str,
+    embeddings: List[List[float]],
+    texts: Iterable[str],
+    metadatas: Optional[List[dict]] = None,
+    ids: Optional[List[str]] = None,
+    vector_field: str = "vector_field",
+    text_field: str = "text",
+    mapping: Optional[Dict] = None,
+    max_chunk_bytes: Optional[int] = 1 * 1024 * 1024,
+    is_aoss: bool = False,
+) -> List[str]:
+    """Bulk Ingest Embeddings into given index."""
+    if not mapping:
+        mapping = dict()
+
+    bulk = _import_bulk()
+    not_found_error = _import_not_found_error()
+    requests = []
+    return_ids = []
+    mapping = mapping
+
+    try:
+        client.indices.get(index=index_name)
+    except not_found_error:
+        client.indices.create(index=index_name, body=mapping)
+
+    for i, text in enumerate(texts):
+        metadata = metadatas[i] if metadatas else {}
+        _id = ids[i] if ids else str(uuid.uuid4())
+        request = {
+            "_op_type": "index",
+            "_index": index_name,
+            vector_field: embeddings[i],
+            text_field: text,
+            "metadata": metadata,
+        }
+        if is_aoss:
+            request["id"] = _id
+        else:
+            request["_id"] = _id
+        requests.append(request)
+        return_ids.append(_id)
+    bulk(client, requests, max_chunk_bytes=max_chunk_bytes)
+    if not is_aoss:
+        client.indices.refresh(index=index_name)
+    return return_ids
+
+
+async def _abulk_ingest_embeddings(
+    client: Any,
+    index_name: str,
+    embeddings: List[List[float]],
+    texts: Iterable[str],
+    metadatas: Optional[List[dict]] = None,
+    ids: Optional[List[str]] = None,
+    vector_field: str = "vector_field",
+    text_field: str = "text",
+    mapping: Optional[Dict] = None,
+    max_chunk_bytes: Optional[int] = 1 * 1024 * 1024,
+    is_aoss: bool = False,
+) -> List[str]:
+    """Bulk Ingest Embeddings into given index asynchronously using AsyncOpenSearch."""
+    if not mapping:
+        mapping = dict()
+
+    async_bulk = _import_async_bulk()
+    not_found_error = _import_not_found_error()
+    requests = []
+    return_ids = []
+
+    try:
+        await client.indices.get(index=index_name)
+    except not_found_error:
+        await client.indices.create(index=index_name, body=mapping)
+
+    for i, text in enumerate(texts):
+        metadata = metadatas[i] if metadatas else {}
+        _id = ids[i] if ids else str(uuid.uuid4())
+        request = {
+            "_op_type": "index",
+            "_index": index_name,
+            vector_field: embeddings[i],
+            text_field: text,
+            "metadata": metadata,
+        }
+        if is_aoss:
+            request["id"] = _id
+        else:
+            request["_id"] = _id
+        requests.append(request)
+        return_ids.append(_id)
+
+    await async_bulk(client, requests, max_chunk_bytes=max_chunk_bytes)
+    if not is_aoss:
+        await client.indices.refresh(index=index_name)
+
+    return return_ids
+
+
+def _default_scripting_text_mapping(
+    dim: int,
+    vector_field: str = "vector_field",
+) -> Dict:
+    """For Painless Scripting or Script Scoring,the default mapping to create index."""
+    return {
+        "mappings": {
+            "properties": {
+                vector_field: {"type": "knn_vector", "dimension": dim},
+            }
+        }
+    }
+
+
+def _default_text_mapping(
+    dim: int,
+    engine: str = "nmslib",
+    space_type: str = "l2",
+    ef_search: int = 512,
+    ef_construction: int = 512,
+    m: int = 16,
+    vector_field: str = "vector_field",
+) -> Dict:
+    """For Approximate k-NN Search, this is the default mapping to create index."""
+    return {
+        "settings": {"index": {"knn": True, "knn.algo_param.ef_search": ef_search}},
+        "mappings": {
+            "properties": {
+                vector_field: {
+                    "type": "knn_vector",
+                    "dimension": dim,
+                    "method": {
+                        "name": "hnsw",
+                        "space_type": space_type,
+                        "engine": engine,
+                        "parameters": {"ef_construction": ef_construction, "m": m},
+                    },
+                }
+            }
+        },
+    }
+
+
+def _default_approximate_search_query(
+    query_vector: List[float],
+    k: int = 4,
+    vector_field: str = "vector_field",
+) -> Dict:
+    """For Approximate k-NN Search, this is the default query."""
+    return {
+        "size": k,
+        "query": {"knn": {vector_field: {"vector": query_vector, "k": k}}},
+    }
+
+
+def _approximate_search_query_with_boolean_filter(
+    query_vector: List[float],
+    boolean_filter: Dict,
+    k: int = 4,
+    vector_field: str = "vector_field",
+    subquery_clause: str = "must",
+) -> Dict:
+    """For Approximate k-NN Search, with Boolean Filter."""
+    return {
+        "size": k,
+        "query": {
+            "bool": {
+                "filter": boolean_filter,
+                subquery_clause: [
+                    {"knn": {vector_field: {"vector": query_vector, "k": k}}}
+                ],
+            }
+        },
+    }
+
+
+def _approximate_search_query_with_efficient_filter(
+    query_vector: List[float],
+    efficient_filter: Dict,
+    k: int = 4,
+    vector_field: str = "vector_field",
+) -> Dict:
+    """For Approximate k-NN Search, with Efficient Filter for Lucene and
+    Faiss Engines."""
+    search_query = _default_approximate_search_query(
+        query_vector, k=k, vector_field=vector_field
+    )
+    search_query["query"]["knn"][vector_field]["filter"] = efficient_filter
+    return search_query
+
+
+def _default_script_query(
+    query_vector: List[float],
+    k: int = 4,
+    space_type: str = "l2",
+    pre_filter: Optional[Dict] = None,
+    vector_field: str = "vector_field",
+) -> Dict:
+    """For Script Scoring Search, this is the default query."""
+
+    if not pre_filter:
+        pre_filter = MATCH_ALL_QUERY
+
+    return {
+        "size": k,
+        "query": {
+            "script_score": {
+                "query": pre_filter,
+                "script": {
+                    "source": "knn_score",
+                    "lang": "knn",
+                    "params": {
+                        "field": vector_field,
+                        "query_value": query_vector,
+                        "space_type": space_type,
+                    },
+                },
+            }
+        },
+    }
+
+
+def __get_painless_scripting_source(
+    space_type: str, vector_field: str = "vector_field"
+) -> str:
+    """For Painless Scripting, it returns the script source based on space type."""
+    source_value = (
+        "(1.0 + " + space_type + "(params.query_value, doc['" + vector_field + "']))"
+    )
+    if space_type == "cosineSimilarity":
+        return source_value
+    else:
+        return "1/" + source_value
+
+
+def _default_painless_scripting_query(
+    query_vector: List[float],
+    k: int = 4,
+    space_type: str = "l2Squared",
+    pre_filter: Optional[Dict] = None,
+    vector_field: str = "vector_field",
+) -> Dict:
+    """For Painless Scripting Search, this is the default query."""
+
+    if not pre_filter:
+        pre_filter = MATCH_ALL_QUERY
+
+    source = __get_painless_scripting_source(space_type, vector_field=vector_field)
+    return {
+        "size": k,
+        "query": {
+            "script_score": {
+                "query": pre_filter,
+                "script": {
+                    "source": source,
+                    "params": {
+                        "field": vector_field,
+                        "query_value": query_vector,
+                    },
+                },
+            }
+        },
+    }
+
+
+class OpenSearchVectorSearch(VectorStore):
+    """`Amazon OpenSearch Vector Engine` vector store.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import OpenSearchVectorSearch
+            opensearch_vector_search = OpenSearchVectorSearch(
+                "http://localhost:9200",
+                "embeddings",
+                embedding_function
+            )
+
+    """
+
+    def __init__(
+        self,
+        opensearch_url: str,
+        index_name: str,
+        embedding_function: Embeddings,
+        **kwargs: Any,
+    ):
+        """Initialize with necessary components."""
+        self.embedding_function = embedding_function
+        self.index_name = index_name
+        http_auth = kwargs.get("http_auth")
+        self.is_aoss = _is_aoss_enabled(http_auth=http_auth)
+        self.client = _get_opensearch_client(opensearch_url, **kwargs)
+        self.async_client = _get_async_opensearch_client(opensearch_url, **kwargs)
+        self.engine = kwargs.get("engine")
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding_function
+
+    def __add(
+        self,
+        texts: Iterable[str],
+        embeddings: List[List[float]],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        bulk_size: int = 500,
+        **kwargs: Any,
+    ) -> List[str]:
+        _validate_embeddings_and_bulk_size(len(embeddings), bulk_size)
+        index_name = kwargs.get("index_name", self.index_name)
+        text_field = kwargs.get("text_field", "text")
+        dim = len(embeddings[0])
+        engine = kwargs.get("engine", "nmslib")
+        space_type = kwargs.get("space_type", "l2")
+        ef_search = kwargs.get("ef_search", 512)
+        ef_construction = kwargs.get("ef_construction", 512)
+        m = kwargs.get("m", 16)
+        vector_field = kwargs.get("vector_field", "vector_field")
+        max_chunk_bytes = kwargs.get("max_chunk_bytes", 1 * 1024 * 1024)
+
+        _validate_aoss_with_engines(self.is_aoss, engine)
+
+        mapping = _default_text_mapping(
+            dim, engine, space_type, ef_search, ef_construction, m, vector_field
+        )
+
+        return _bulk_ingest_embeddings(
+            self.client,
+            index_name,
+            embeddings,
+            texts,
+            metadatas=metadatas,
+            ids=ids,
+            vector_field=vector_field,
+            text_field=text_field,
+            mapping=mapping,
+            max_chunk_bytes=max_chunk_bytes,
+            is_aoss=self.is_aoss,
+        )
+
+    async def __aadd(
+        self,
+        texts: Iterable[str],
+        embeddings: List[List[float]],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        bulk_size: int = 500,
+        **kwargs: Any,
+    ) -> List[str]:
+        _validate_embeddings_and_bulk_size(len(embeddings), bulk_size)
+        index_name = kwargs.get("index_name", self.index_name)
+        text_field = kwargs.get("text_field", "text")
+        dim = len(embeddings[0])
+        engine = kwargs.get("engine", "nmslib")
+        space_type = kwargs.get("space_type", "l2")
+        ef_search = kwargs.get("ef_search", 512)
+        ef_construction = kwargs.get("ef_construction", 512)
+        m = kwargs.get("m", 16)
+        vector_field = kwargs.get("vector_field", "vector_field")
+        max_chunk_bytes = kwargs.get("max_chunk_bytes", 1 * 1024 * 1024)
+
+        _validate_aoss_with_engines(self.is_aoss, engine)
+
+        mapping = _default_text_mapping(
+            dim, engine, space_type, ef_search, ef_construction, m, vector_field
+        )
+
+        return await _abulk_ingest_embeddings(
+            self.async_client,
+            index_name,
+            embeddings,
+            texts,
+            metadatas=metadatas,
+            ids=ids,
+            vector_field=vector_field,
+            text_field=text_field,
+            mapping=mapping,
+            max_chunk_bytes=max_chunk_bytes,
+            is_aoss=self.is_aoss,
+        )
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        bulk_size: int = 500,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of ids to associate with the texts.
+            bulk_size: Bulk API request count; Default: 500
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+
+        Optional Args:
+            vector_field: Document field embeddings are stored in. Defaults to
+            "vector_field".
+
+            text_field: Document field the text of the document is stored in. Defaults
+            to "text".
+        """
+        embeddings = self.embedding_function.embed_documents(list(texts))
+        return self.__add(
+            texts,
+            embeddings,
+            metadatas=metadatas,
+            ids=ids,
+            bulk_size=bulk_size,
+            **kwargs,
+        )
+
+    async def aadd_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        bulk_size: int = 500,
+        **kwargs: Any,
+    ) -> List[str]:
+        """
+        Asynchronously run more texts through the embeddings
+        and add to the vectorstore.
+        """
+        embeddings = await self.embedding_function.aembed_documents(list(texts))
+        return await self.__aadd(
+            texts,
+            embeddings,
+            metadatas=metadatas,
+            ids=ids,
+            bulk_size=bulk_size,
+            **kwargs,
+        )
+
+    def add_embeddings(
+        self,
+        text_embeddings: Iterable[Tuple[str, List[float]]],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        bulk_size: int = 500,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add the given texts and embeddings to the vectorstore.
+
+        Args:
+            text_embeddings: Iterable pairs of string and embedding to
+                add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of ids to associate with the texts.
+            bulk_size: Bulk API request count; Default: 500
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+
+        Optional Args:
+            vector_field: Document field embeddings are stored in. Defaults to
+            "vector_field".
+
+            text_field: Document field the text of the document is stored in. Defaults
+            to "text".
+        """
+        texts, embeddings = zip(*text_embeddings)
+        return self.__add(
+            list(texts),
+            list(embeddings),
+            metadatas=metadatas,
+            ids=ids,
+            bulk_size=bulk_size,
+            **kwargs,
+        )
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        refresh_indices: Optional[bool] = True,
+        **kwargs: Any,
+    ) -> Optional[bool]:
+        """Delete documents from the Opensearch index.
+
+        Args:
+            ids: List of ids of documents to delete.
+            refresh_indices: Whether to refresh the index
+                            after deleting documents. Defaults to True.
+        """
+        bulk = _import_bulk()
+
+        body = []
+
+        if ids is None:
+            raise ValueError("ids must be provided.")
+
+        for _id in ids:
+            body.append({"_op_type": "delete", "_index": self.index_name, "_id": _id})
+
+        if len(body) > 0:
+            try:
+                bulk(self.client, body, refresh=refresh_indices, ignore_status=404)
+                return True
+            except Exception as e:
+                raise e
+        else:
+            return False
+
+    async def adelete(
+        self, ids: Optional[List[str]] = None, **kwargs: Any
+    ) -> Optional[bool]:
+        """Asynchronously delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+        if ids is None:
+            raise ValueError("No ids provided to delete.")
+
+        actions = [{"delete": {"_index": self.index_name, "_id": id_}} for id_ in ids]
+        response = await self.async_client.bulk(body=actions, **kwargs)
+        return not any(
+            item.get("delete", {}).get("error") for item in response["items"]
+        )
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        By default, supports Approximate Search.
+        Also supports Script Scoring and Painless Scripting.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query.
+
+        Optional Args:
+            vector_field: Document field embeddings are stored in. Defaults to
+            "vector_field".
+
+            text_field: Document field the text of the document is stored in. Defaults
+            to "text".
+
+            metadata_field: Document field that metadata is stored in. Defaults to
+            "metadata".
+            Can be set to a special value "*" to include the entire document.
+
+        Optional Args for Approximate Search:
+            search_type: "approximate_search"; default: "approximate_search"
+
+            boolean_filter: A Boolean filter is a post filter consists of a Boolean
+            query that contains a k-NN query and a filter.
+
+            subquery_clause: Query clause on the knn vector field; default: "must"
+
+            lucene_filter: the Lucene algorithm decides whether to perform an exact
+            k-NN search with pre-filtering or an approximate search with modified
+            post-filtering. (deprecated, use `efficient_filter`)
+
+            efficient_filter: the Lucene Engine or Faiss Engine decides whether to
+            perform an exact k-NN search with pre-filtering or an approximate search
+            with modified post-filtering.
+
+        Optional Args for Script Scoring Search:
+            search_type: "script_scoring"; default: "approximate_search"
+
+            space_type: "l2", "l1", "linf", "cosinesimil", "innerproduct",
+            "hammingbit"; default: "l2"
+
+            pre_filter: script_score query to pre-filter documents before identifying
+            nearest neighbors; default: {"match_all": {}}
+
+        Optional Args for Painless Scripting Search:
+            search_type: "painless_scripting"; default: "approximate_search"
+
+            space_type: "l2Squared", "l1Norm", "cosineSimilarity"; default: "l2Squared"
+
+            pre_filter: script_score query to pre-filter documents before identifying
+            nearest neighbors; default: {"match_all": {}}
+        """
+        docs_with_scores = self.similarity_search_with_score(query, k, **kwargs)
+        return [doc[0] for doc in docs_with_scores]
+
+    def similarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to the embedding vector."""
+        docs_with_scores = self.similarity_search_with_score_by_vector(
+            embedding, k, **kwargs
+        )
+        return [doc[0] for doc in docs_with_scores]
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Return docs and it's scores most similar to query.
+
+        By default, supports Approximate Search.
+        Also supports Script Scoring and Painless Scripting.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents along with its scores most similar to the query.
+
+        Optional Args:
+            same as `similarity_search`
+        """
+        embedding = self.embedding_function.embed_query(query)
+        return self.similarity_search_with_score_by_vector(embedding, k, **kwargs)
+
+    def similarity_search_with_score_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Return docs and it's scores most similar to the embedding vector.
+
+        By default, supports Approximate Search.
+        Also supports Script Scoring and Painless Scripting.
+
+        Args:
+            embedding: Embedding vector to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents along with its scores most similar to the query.
+
+        Optional Args:
+            same as `similarity_search`
+        """
+        text_field = kwargs.get("text_field", "text")
+        metadata_field = kwargs.get("metadata_field", "metadata")
+
+        hits = self._raw_similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, **kwargs
+        )
+
+        documents_with_scores = [
+            (
+                Document(
+                    page_content=hit["_source"][text_field],
+                    metadata=(
+                        hit["_source"]
+                        if metadata_field == "*" or metadata_field not in hit["_source"]
+                        else hit["_source"][metadata_field]
+                    ),
+                ),
+                hit["_score"],
+            )
+            for hit in hits
+        ]
+        return documents_with_scores
+
+    def _raw_similarity_search_with_score_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[dict]:
+        """Return raw opensearch documents (dict) including vectors,
+        scores most similar to the embedding vector.
+
+        By default, supports Approximate Search.
+        Also supports Script Scoring and Painless Scripting.
+
+        Args:
+            embedding: Embedding vector to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of dict with its scores most similar to the embedding.
+
+        Optional Args:
+            same as `similarity_search`
+        """
+        search_type = kwargs.get("search_type", "approximate_search")
+        vector_field = kwargs.get("vector_field", "vector_field")
+        index_name = kwargs.get("index_name", self.index_name)
+        filter = kwargs.get("filter", {})
+
+        if (
+            self.is_aoss
+            and search_type != "approximate_search"
+            and search_type != SCRIPT_SCORING_SEARCH
+        ):
+            raise ValueError(
+                "Amazon OpenSearch Service Serverless only "
+                "supports `approximate_search` and `script_scoring`"
+            )
+
+        if search_type == "approximate_search":
+            boolean_filter = kwargs.get("boolean_filter", {})
+            subquery_clause = kwargs.get("subquery_clause", "must")
+            efficient_filter = kwargs.get("efficient_filter", {})
+            # `lucene_filter` is deprecated, added for Backwards Compatibility
+            lucene_filter = kwargs.get("lucene_filter", {})
+
+            if boolean_filter != {} and efficient_filter != {}:
+                raise ValueError(
+                    "Both `boolean_filter` and `efficient_filter` are provided which "
+                    "is invalid"
+                )
+
+            if lucene_filter != {} and efficient_filter != {}:
+                raise ValueError(
+                    "Both `lucene_filter` and `efficient_filter` are provided which "
+                    "is invalid. `lucene_filter` is deprecated"
+                )
+
+            if lucene_filter != {} and boolean_filter != {}:
+                raise ValueError(
+                    "Both `lucene_filter` and `boolean_filter` are provided which "
+                    "is invalid. `lucene_filter` is deprecated"
+                )
+
+            if (
+                efficient_filter == {}
+                and boolean_filter == {}
+                and lucene_filter == {}
+                and filter != {}
+            ):
+                if self.engine in ["faiss", "lucene"]:
+                    efficient_filter = filter
+                else:
+                    boolean_filter = filter
+
+            if boolean_filter != {}:
+                search_query = _approximate_search_query_with_boolean_filter(
+                    embedding,
+                    boolean_filter,
+                    k=k,
+                    vector_field=vector_field,
+                    subquery_clause=subquery_clause,
+                )
+            elif efficient_filter != {}:
+                search_query = _approximate_search_query_with_efficient_filter(
+                    embedding, efficient_filter, k=k, vector_field=vector_field
+                )
+            elif lucene_filter != {}:
+                warnings.warn(
+                    "`lucene_filter` is deprecated. Please use the keyword argument"
+                    " `efficient_filter`"
+                )
+                search_query = _approximate_search_query_with_efficient_filter(
+                    embedding, lucene_filter, k=k, vector_field=vector_field
+                )
+            else:
+                search_query = _default_approximate_search_query(
+                    embedding, k=k, vector_field=vector_field
+                )
+        elif search_type == SCRIPT_SCORING_SEARCH:
+            space_type = kwargs.get("space_type", "l2")
+            pre_filter = kwargs.get("pre_filter", MATCH_ALL_QUERY)
+            search_query = _default_script_query(
+                embedding, k, space_type, pre_filter, vector_field
+            )
+        elif search_type == PAINLESS_SCRIPTING_SEARCH:
+            space_type = kwargs.get("space_type", "l2Squared")
+            pre_filter = kwargs.get("pre_filter", MATCH_ALL_QUERY)
+            search_query = _default_painless_scripting_query(
+                embedding, k, space_type, pre_filter, vector_field
+            )
+        else:
+            raise ValueError("Invalid `search_type` provided as an argument")
+
+        response = self.client.search(index=index_name, body=search_query)
+
+        return [hit for hit in response["hits"]["hits"]]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> list[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+                     Defaults to 20.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+
+        vector_field = kwargs.get("vector_field", "vector_field")
+        text_field = kwargs.get("text_field", "text")
+        metadata_field = kwargs.get("metadata_field", "metadata")
+
+        # Get embedding of the user query
+        embedding = self.embedding_function.embed_query(query)
+
+        # Do ANN/KNN search to get top fetch_k results where fetch_k >= k
+        results = self._raw_similarity_search_with_score_by_vector(
+            embedding, fetch_k, **kwargs
+        )
+
+        embeddings = [result["_source"][vector_field] for result in results]
+
+        # Rerank top k results using MMR, (mmr_selected is a list of indices)
+        mmr_selected = maximal_marginal_relevance(
+            np.array(embedding), embeddings, k=k, lambda_mult=lambda_mult
+        )
+
+        return [
+            Document(
+                page_content=results[i]["_source"][text_field],
+                metadata=results[i]["_source"][metadata_field],
+            )
+            for i in mmr_selected
+        ]
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        bulk_size: int = 500,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> OpenSearchVectorSearch:
+        """Construct OpenSearchVectorSearch wrapper from raw texts.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import OpenSearchVectorSearch
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                opensearch_vector_search = OpenSearchVectorSearch.from_texts(
+                    texts,
+                    embeddings,
+                    opensearch_url="http://localhost:9200"
+                )
+
+        OpenSearch by default supports Approximate Search powered by nmslib, faiss
+        and lucene engines recommended for large datasets. Also supports brute force
+        search through Script Scoring and Painless Scripting.
+
+        Optional Args:
+            vector_field: Document field embeddings are stored in. Defaults to
+            "vector_field".
+
+            text_field: Document field the text of the document is stored in. Defaults
+            to "text".
+
+        Optional Keyword Args for Approximate Search:
+            engine: "nmslib", "faiss", "lucene"; default: "nmslib"
+
+            space_type: "l2", "l1", "cosinesimil", "linf", "innerproduct"; default: "l2"
+
+            ef_search: Size of the dynamic list used during k-NN searches. Higher values
+            lead to more accurate but slower searches; default: 512
+
+            ef_construction: Size of the dynamic list used during k-NN graph creation.
+            Higher values lead to more accurate graph but slower indexing speed;
+            default: 512
+
+            m: Number of bidirectional links created for each new element. Large impact
+            on memory consumption. Between 2 and 100; default: 16
+
+        Keyword Args for Script Scoring or Painless Scripting:
+            is_appx_search: False
+
+        """
+        embeddings = embedding.embed_documents(texts)
+        return cls.from_embeddings(
+            embeddings,
+            texts,
+            embedding,
+            metadatas=metadatas,
+            bulk_size=bulk_size,
+            ids=ids,
+            **kwargs,
+        )
+
+    @classmethod
+    async def afrom_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        bulk_size: int = 500,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> OpenSearchVectorSearch:
+        """Asynchronously construct OpenSearchVectorSearch wrapper from raw texts.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import OpenSearchVectorSearch
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                opensearch_vector_search = await OpenSearchVectorSearch.afrom_texts(
+                    texts,
+                    embeddings,
+                    opensearch_url="http://localhost:9200"
+                )
+
+        OpenSearch by default supports Approximate Search powered by nmslib, faiss
+        and lucene engines recommended for large datasets. Also supports brute force
+        search through Script Scoring and Painless Scripting.
+
+        Optional Args:
+            vector_field: Document field embeddings are stored in. Defaults to
+            "vector_field".
+
+            text_field: Document field the text of the document is stored in. Defaults
+            to "text".
+
+        Optional Keyword Args for Approximate Search:
+            engine: "nmslib", "faiss", "lucene"; default: "nmslib"
+
+            space_type: "l2", "l1", "cosinesimil", "linf", "innerproduct"; default: "l2"
+
+            ef_search: Size of the dynamic list used during k-NN searches. Higher values
+            lead to more accurate but slower searches; default: 512
+
+            ef_construction: Size of the dynamic list used during k-NN graph creation.
+            Higher values lead to more accurate graph but slower indexing speed;
+            default: 512
+
+            m: Number of bidirectional links created for each new element. Large impact
+            on memory consumption. Between 2 and 100; default: 16
+
+        Keyword Args for Script Scoring or Painless Scripting:
+            is_appx_search: False
+
+        """
+        embeddings = await embedding.aembed_documents(texts)
+        return await cls.afrom_embeddings(
+            embeddings,
+            texts,
+            embedding,
+            metadatas=metadatas,
+            bulk_size=bulk_size,
+            ids=ids,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_embeddings(
+        cls,
+        embeddings: List[List[float]],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        bulk_size: int = 500,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> OpenSearchVectorSearch:
+        """Construct OpenSearchVectorSearch wrapper from pre-vectorized embeddings.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import OpenSearchVectorSearch
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embedder = OpenAIEmbeddings()
+                embeddings = embedder.embed_documents(["foo", "bar"])
+                opensearch_vector_search = OpenSearchVectorSearch.from_embeddings(
+                    embeddings,
+                    texts,
+                    embedder,
+                    opensearch_url="http://localhost:9200"
+                )
+
+        OpenSearch by default supports Approximate Search powered by nmslib, faiss
+        and lucene engines recommended for large datasets. Also supports brute force
+        search through Script Scoring and Painless Scripting.
+
+        Optional Args:
+            vector_field: Document field embeddings are stored in. Defaults to
+            "vector_field".
+
+            text_field: Document field the text of the document is stored in. Defaults
+            to "text".
+
+        Optional Keyword Args for Approximate Search:
+            engine: "nmslib", "faiss", "lucene"; default: "nmslib"
+
+            space_type: "l2", "l1", "cosinesimil", "linf", "innerproduct"; default: "l2"
+
+            ef_search: Size of the dynamic list used during k-NN searches. Higher values
+            lead to more accurate but slower searches; default: 512
+
+            ef_construction: Size of the dynamic list used during k-NN graph creation.
+            Higher values lead to more accurate graph but slower indexing speed;
+            default: 512
+
+            m: Number of bidirectional links created for each new element. Large impact
+            on memory consumption. Between 2 and 100; default: 16
+
+        Keyword Args for Script Scoring or Painless Scripting:
+            is_appx_search: False
+
+        """
+        opensearch_url = get_from_dict_or_env(
+            kwargs, "opensearch_url", "OPENSEARCH_URL"
+        )
+        # List of arguments that needs to be removed from kwargs
+        # before passing kwargs to get opensearch client
+        keys_list = [
+            "opensearch_url",
+            "index_name",
+            "is_appx_search",
+            "vector_field",
+            "text_field",
+            "engine",
+            "space_type",
+            "ef_search",
+            "ef_construction",
+            "m",
+            "max_chunk_bytes",
+            "is_aoss",
+        ]
+        _validate_embeddings_and_bulk_size(len(embeddings), bulk_size)
+        dim = len(embeddings[0])
+        # Get the index name from either from kwargs or ENV Variable
+        # before falling back to random generation
+        index_name = get_from_dict_or_env(
+            kwargs, "index_name", "OPENSEARCH_INDEX_NAME", default=uuid.uuid4().hex
+        )
+        is_appx_search = kwargs.get("is_appx_search", True)
+        vector_field = kwargs.get("vector_field", "vector_field")
+        text_field = kwargs.get("text_field", "text")
+        max_chunk_bytes = kwargs.get("max_chunk_bytes", 1 * 1024 * 1024)
+        http_auth = kwargs.get("http_auth")
+        is_aoss = _is_aoss_enabled(http_auth=http_auth)
+        engine = None
+
+        if is_aoss and not is_appx_search:
+            raise ValueError(
+                "Amazon OpenSearch Service Serverless only "
+                "supports `approximate_search`"
+            )
+
+        if is_appx_search:
+            engine = kwargs.get("engine", "nmslib")
+            space_type = kwargs.get("space_type", "l2")
+            ef_search = kwargs.get("ef_search", 512)
+            ef_construction = kwargs.get("ef_construction", 512)
+            m = kwargs.get("m", 16)
+
+            _validate_aoss_with_engines(is_aoss, engine)
+
+            mapping = _default_text_mapping(
+                dim, engine, space_type, ef_search, ef_construction, m, vector_field
+            )
+        else:
+            mapping = _default_scripting_text_mapping(dim)
+
+        [kwargs.pop(key, None) for key in keys_list]
+        client = _get_opensearch_client(opensearch_url, **kwargs)
+        _bulk_ingest_embeddings(
+            client,
+            index_name,
+            embeddings,
+            texts,
+            ids=ids,
+            metadatas=metadatas,
+            vector_field=vector_field,
+            text_field=text_field,
+            mapping=mapping,
+            max_chunk_bytes=max_chunk_bytes,
+            is_aoss=is_aoss,
+        )
+        kwargs["engine"] = engine
+        return cls(opensearch_url, index_name, embedding, **kwargs)
+
+    @classmethod
+    async def afrom_embeddings(
+        cls,
+        embeddings: List[List[float]],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        bulk_size: int = 500,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> OpenSearchVectorSearch:
+        """Asynchronously construct OpenSearchVectorSearch wrapper from pre-vectorized
+        embeddings.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import OpenSearchVectorSearch
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embedder = OpenAIEmbeddings()
+                embeddings = await embedder.aembed_documents(["foo", "bar"])
+                opensearch_vector_search =
+                    await OpenSearchVectorSearch.afrom_embeddings(
+                        embeddings,
+                        texts,
+                        embedder,
+                        opensearch_url="http://localhost:9200"
+                )
+
+        OpenSearch by default supports Approximate Search powered by nmslib, faiss
+        and lucene engines recommended for large datasets. Also supports brute force
+        search through Script Scoring and Painless Scripting.
+
+        Optional Args:
+            vector_field: Document field embeddings are stored in. Defaults to
+            "vector_field".
+
+            text_field: Document field the text of the document is stored in. Defaults
+            to "text".
+
+        Optional Keyword Args for Approximate Search:
+            engine: "nmslib", "faiss", "lucene"; default: "nmslib"
+
+            space_type: "l2", "l1", "cosinesimil", "linf", "innerproduct"; default: "l2"
+
+            ef_search: Size of the dynamic list used during k-NN searches. Higher values
+            lead to more accurate but slower searches; default: 512
+
+            ef_construction: Size of the dynamic list used during k-NN graph creation.
+            Higher values lead to more accurate graph but slower indexing speed;
+            default: 512
+
+            m: Number of bidirectional links created for each new element. Large impact
+            on memory consumption. Between 2 and 100; default: 16
+
+        Keyword Args for Script Scoring or Painless Scripting:
+            is_appx_search: False
+
+        """
+        opensearch_url = get_from_dict_or_env(
+            kwargs, "opensearch_url", "OPENSEARCH_URL"
+        )
+        # List of arguments that needs to be removed from kwargs
+        # before passing kwargs to get opensearch client
+        keys_list = [
+            "opensearch_url",
+            "index_name",
+            "is_appx_search",
+            "vector_field",
+            "text_field",
+            "engine",
+            "space_type",
+            "ef_search",
+            "ef_construction",
+            "m",
+            "max_chunk_bytes",
+            "is_aoss",
+        ]
+        _validate_embeddings_and_bulk_size(len(embeddings), bulk_size)
+        dim = len(embeddings[0])
+        # Get the index name from either from kwargs or ENV Variable
+        # before falling back to random generation
+        index_name = get_from_dict_or_env(
+            kwargs, "index_name", "OPENSEARCH_INDEX_NAME", default=uuid.uuid4().hex
+        )
+        is_appx_search = kwargs.get("is_appx_search", True)
+        vector_field = kwargs.get("vector_field", "vector_field")
+        text_field = kwargs.get("text_field", "text")
+        max_chunk_bytes = kwargs.get("max_chunk_bytes", 1 * 1024 * 1024)
+        http_auth = kwargs.get("http_auth")
+        is_aoss = _is_aoss_enabled(http_auth=http_auth)
+        engine = None
+
+        if is_aoss and not is_appx_search:
+            raise ValueError(
+                "Amazon OpenSearch Service Serverless only "
+                "supports `approximate_search`"
+            )
+
+        if is_appx_search:
+            engine = kwargs.get("engine", "nmslib")
+            space_type = kwargs.get("space_type", "l2")
+            ef_search = kwargs.get("ef_search", 512)
+            ef_construction = kwargs.get("ef_construction", 512)
+            m = kwargs.get("m", 16)
+
+            _validate_aoss_with_engines(is_aoss, engine)
+
+            mapping = _default_text_mapping(
+                dim, engine, space_type, ef_search, ef_construction, m, vector_field
+            )
+        else:
+            mapping = _default_scripting_text_mapping(dim)
+
+        [kwargs.pop(key, None) for key in keys_list]
+        client = _get_async_opensearch_client(opensearch_url, **kwargs)
+        await _abulk_ingest_embeddings(
+            client,
+            index_name,
+            embeddings,
+            texts,
+            ids=ids,
+            metadatas=metadatas,
+            vector_field=vector_field,
+            text_field=text_field,
+            mapping=mapping,
+            max_chunk_bytes=max_chunk_bytes,
+            is_aoss=is_aoss,
+        )
+        kwargs["engine"] = engine
+        return cls(opensearch_url, index_name, embedding, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/pathway.py b/llm/Lib/site-packages/langchain_community/vectorstores/pathway.py
new file mode 100644
index 0000000000000000000000000000000000000000..cc178935bdc2201c291e7703bc309e65baceed68
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/pathway.py
@@ -0,0 +1,228 @@
+"""
+Pathway Vector Store client.
+
+
+The Pathway Vector Server is a pipeline written in the Pathway framweork which indexes
+all files in a given folder, embeds them, and builds a vector index. The pipeline reacts
+to changes in source files, automatically updating appropriate index entries.
+
+The PathwayVectorClient implements the LangChain VectorStore interface and queries the
+PathwayVectorServer to retrieve up-to-date documents.
+
+You can use the client with managed instances of Pathway Vector Store, or run your own 
+instance as described at https://pathway.com/developers/user-guide/llm-xpack/vectorstore_pipeline/
+
+"""
+
+import json
+import logging
+from typing import Any, Callable, Iterable, List, Optional, Tuple
+
+import requests
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+
+# Copied from https://github.com/pathwaycom/pathway/blob/main/python/pathway/xpacks/llm/vector_store.py
+# to remove dependency on Pathway library.
+class _VectorStoreClient:
+    def __init__(
+        self,
+        host: Optional[str] = None,
+        port: Optional[int] = None,
+        url: Optional[str] = None,
+    ):
+        """
+        A client you can use to query :py:class:`VectorStoreServer`.
+
+        Please provide aither the `url`, or `host` and `port`.
+
+        Args:
+            - host: host on which `:py:class:`VectorStoreServer` listens
+            - port: port on which `:py:class:`VectorStoreServer` listens
+            - url: url at which `:py:class:`VectorStoreServer` listens
+        """
+        err = "Either (`host` and `port`) or `url` must be provided, but not both."
+        if url is not None:
+            if host or port:
+                raise ValueError(err)
+            self.url = url
+        else:
+            if host is None:
+                raise ValueError(err)
+            port = port or 80
+            self.url = f"http://{host}:{port}"
+
+    def query(
+        self, query: str, k: int = 3, metadata_filter: Optional[str] = None
+    ) -> List[dict]:
+        """
+        Perform a query to the vector store and fetch results.
+
+        Args:
+            - query:
+            - k: number of documents to be returned
+            - metadata_filter: optional string representing the metadata filtering query
+                in the JMESPath format. The search will happen only for documents
+                satisfying this filtering.
+        """
+
+        data = {"query": query, "k": k}
+        if metadata_filter is not None:
+            data["metadata_filter"] = metadata_filter
+        url = self.url + "/v1/retrieve"
+        response = requests.post(
+            url,
+            data=json.dumps(data),
+            headers={"Content-Type": "application/json"},
+            timeout=3,
+        )
+        responses = response.json()
+        return sorted(responses, key=lambda x: x["dist"])
+
+    # Make an alias
+    __call__ = query
+
+    def get_vectorstore_statistics(self) -> dict:
+        """Fetch basic statistics about the vector store."""
+
+        url = self.url + "/v1/statistics"
+        response = requests.post(
+            url,
+            json={},
+            headers={"Content-Type": "application/json"},
+        )
+        responses = response.json()
+        return responses
+
+    def get_input_files(
+        self,
+        metadata_filter: Optional[str] = None,
+        filepath_globpattern: Optional[str] = None,
+    ) -> list:
+        """
+        Fetch information on documents in the the vector store.
+
+        Args:
+            metadata_filter: optional string representing the metadata filtering query
+                in the JMESPath format. The search will happen only for documents
+                satisfying this filtering.
+            filepath_globpattern: optional glob pattern specifying which documents
+                will be searched for this query.
+        """
+        url = self.url + "/v1/inputs"
+        response = requests.post(
+            url,
+            json={
+                "metadata_filter": metadata_filter,
+                "filepath_globpattern": filepath_globpattern,
+            },
+            headers={"Content-Type": "application/json"},
+        )
+        responses = response.json()
+        return responses
+
+
+class PathwayVectorClient(VectorStore):
+    """
+    VectorStore connecting to Pathway Vector Store.
+    """
+
+    def __init__(
+        self,
+        host: Optional[str] = None,
+        port: Optional[int] = None,
+        url: Optional[str] = None,
+    ) -> None:
+        """
+        A client you can use to query Pathway Vector Store.
+
+        Please provide aither the `url`, or `host` and `port`.
+
+        Args:
+            - host: host on which Pathway Vector Store listens
+            - port: port on which Pathway Vector Store listens
+            - url: url at which Pathway Vector Store listens
+        """
+        self.client = _VectorStoreClient(host, port, url)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Pathway is not suitable for this method."""
+        raise NotImplementedError(
+            "Pathway vector store does not support adding or removing texts"
+            " from client."
+        )
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> "PathwayVectorClient":
+        raise NotImplementedError(
+            "Pathway vector store does not support initializing from_texts."
+        )
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        metadata_filter = kwargs.pop("metadata_filter", None)
+        if kwargs:
+            logging.warning(
+                "Unknown kwargs passed to PathwayVectorClient.similarity_search: %s",
+                kwargs,
+            )
+        rets = self.client(query=query, k=k, metadata_filter=metadata_filter)
+
+        return [
+            Document(page_content=ret["text"], metadata=ret["metadata"]) for ret in rets
+        ]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        metadata_filter: Optional[str] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search with Pathway with distance.
+
+        Args:
+            - query (str): Query text to search for.
+            - k (int): Number of results to return. Defaults to 4.
+            - metadata_filter (Optional[str]): Filter by metadata.
+                Filtering query should be in JMESPath format. Defaults to None.
+
+        Returns:
+            List[Tuple[Document, float]]: List of documents most similar to
+            the query text and cosine distance in float for each.
+            Lower score represents more similarity.
+        """
+        rets = self.client(query=query, k=k, metadata_filter=metadata_filter)
+
+        return [
+            (Document(page_content=ret["text"], metadata=ret["metadata"]), ret["dist"])
+            for ret in rets
+        ]
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        return self._cosine_relevance_score_fn
+
+    def get_vectorstore_statistics(self) -> dict:
+        """Fetch basic statistics about the Vector Store."""
+        return self.client.get_vectorstore_statistics()
+
+    def get_input_files(
+        self,
+        metadata_filter: Optional[str] = None,
+        filepath_globpattern: Optional[str] = None,
+    ) -> list:
+        """List files indexed by the Vector Store."""
+        return self.client.get_input_files(metadata_filter, filepath_globpattern)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/pgembedding.py b/llm/Lib/site-packages/langchain_community/vectorstores/pgembedding.py
new file mode 100644
index 0000000000000000000000000000000000000000..48f04ffef313f95a6a79b1e2a212afea17266c4f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/pgembedding.py
@@ -0,0 +1,531 @@
+from __future__ import annotations
+
+import logging
+import uuid
+from typing import Any, Dict, Iterable, List, Optional, Tuple, Type
+
+import sqlalchemy
+from sqlalchemy import func
+from sqlalchemy.dialects.postgresql import JSON, UUID
+from sqlalchemy.orm import Session, relationship
+
+try:
+    from sqlalchemy.orm import declarative_base
+except ImportError:
+    from sqlalchemy.ext.declarative import declarative_base
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_dict_or_env
+from langchain_core.vectorstores import VectorStore
+
+Base = declarative_base()  # type: Any
+
+
+ADA_TOKEN_COUNT = 1536
+_LANGCHAIN_DEFAULT_COLLECTION_NAME = "langchain"
+
+
+class BaseModel(Base):
+    """Base model for all SQL stores."""
+
+    __abstract__ = True
+    uuid = sqlalchemy.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+
+
+class CollectionStore(BaseModel):
+    """Collection store."""
+
+    __tablename__ = "langchain_pg_collection"
+
+    name = sqlalchemy.Column(sqlalchemy.String)
+    cmetadata = sqlalchemy.Column(JSON)
+
+    embeddings = relationship(
+        "EmbeddingStore",
+        back_populates="collection",
+        passive_deletes=True,
+    )
+
+    @classmethod
+    def get_by_name(cls, session: Session, name: str) -> Optional["CollectionStore"]:
+        return session.query(cls).filter(cls.name == name).first()  # type: ignore
+
+    @classmethod
+    def get_or_create(
+        cls,
+        session: Session,
+        name: str,
+        cmetadata: Optional[dict] = None,
+    ) -> Tuple["CollectionStore", bool]:
+        """
+        Get or create a collection.
+        Returns [Collection, bool] where the bool is True if the collection was created.
+        """
+        created = False
+        collection = cls.get_by_name(session, name)
+        if collection:
+            return collection, created
+
+        collection = cls(name=name, cmetadata=cmetadata)
+        session.add(collection)
+        session.commit()
+        created = True
+        return collection, created
+
+
+class EmbeddingStore(BaseModel):
+    """Embedding store."""
+
+    __tablename__ = "langchain_pg_embedding"
+
+    collection_id = sqlalchemy.Column(
+        UUID(as_uuid=True),
+        sqlalchemy.ForeignKey(
+            f"{CollectionStore.__tablename__}.uuid",
+            ondelete="CASCADE",
+        ),
+    )
+    collection = relationship(CollectionStore, back_populates="embeddings")
+
+    embedding = sqlalchemy.Column(sqlalchemy.ARRAY(sqlalchemy.REAL))  # type: ignore
+    document = sqlalchemy.Column(sqlalchemy.String, nullable=True)
+    cmetadata = sqlalchemy.Column(JSON, nullable=True)
+
+    # custom_id : any user defined id
+    custom_id = sqlalchemy.Column(sqlalchemy.String, nullable=True)
+
+
+class QueryResult:
+    """Result from a query."""
+
+    EmbeddingStore: EmbeddingStore
+    distance: float
+
+
+class PGEmbedding(VectorStore):
+    """`Postgres` with the `pg_embedding` extension as a vector store.
+
+    pg_embedding uses sequential scan by default. but you can create a HNSW index
+    using the create_hnsw_index method.
+    - `connection_string` is a postgres connection string.
+    - `embedding_function` any embedding function implementing
+        `langchain.embeddings.base.Embeddings` interface.
+    - `collection_name` is the name of the collection to use. (default: langchain)
+        - NOTE: This is not the name of the table, but the name of the collection.
+            The tables will be created when initializing the store (if not exists)
+            So, make sure the user has the right permissions to create tables.
+    - `distance_strategy` is the distance strategy to use. (default: EUCLIDEAN)
+        - `EUCLIDEAN` is the euclidean distance.
+    - `pre_delete_collection` if True, will delete the collection if it exists.
+        (default: False)
+        - Useful for testing.
+    """
+
+    def __init__(
+        self,
+        connection_string: str,
+        embedding_function: Embeddings,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        collection_metadata: Optional[dict] = None,
+        pre_delete_collection: bool = False,
+        logger: Optional[logging.Logger] = None,
+    ) -> None:
+        self.connection_string = connection_string
+        self.embedding_function = embedding_function
+        self.collection_name = collection_name
+        self.collection_metadata = collection_metadata
+        self.pre_delete_collection = pre_delete_collection
+        self.logger = logger or logging.getLogger(__name__)
+        self.__post_init__()
+
+    def __post_init__(
+        self,
+    ) -> None:
+        self._conn = self.connect()
+        self.create_hnsw_extension()
+        self.create_tables_if_not_exists()
+        self.create_collection()
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding_function
+
+    def connect(self) -> sqlalchemy.engine.Connection:
+        engine = sqlalchemy.create_engine(self.connection_string)
+        conn = engine.connect()
+        return conn
+
+    def create_hnsw_extension(self) -> None:
+        try:
+            with Session(self._conn) as session:
+                statement = sqlalchemy.text("CREATE EXTENSION IF NOT EXISTS embedding")
+                session.execute(statement)
+                session.commit()
+        except Exception as e:
+            self.logger.exception(e)
+
+    def create_tables_if_not_exists(self) -> None:
+        with self._conn.begin():
+            Base.metadata.create_all(self._conn)
+
+    def drop_tables(self) -> None:
+        with self._conn.begin():
+            Base.metadata.drop_all(self._conn)
+
+    def create_collection(self) -> None:
+        if self.pre_delete_collection:
+            self.delete_collection()
+        with Session(self._conn) as session:
+            CollectionStore.get_or_create(
+                session, self.collection_name, cmetadata=self.collection_metadata
+            )
+
+    def create_hnsw_index(
+        self,
+        max_elements: int = 10000,
+        dims: int = ADA_TOKEN_COUNT,
+        m: int = 8,
+        ef_construction: int = 16,
+        ef_search: int = 16,
+    ) -> None:
+        create_index_query = sqlalchemy.text(
+            "CREATE INDEX IF NOT EXISTS langchain_pg_embedding_idx "
+            "ON langchain_pg_embedding USING hnsw (embedding) "
+            "WITH ("
+            "maxelements = {}, "
+            "dims = {}, "
+            "m = {}, "
+            "efconstruction = {}, "
+            "efsearch = {}"
+            ");".format(max_elements, dims, m, ef_construction, ef_search)
+        )
+
+        # Execute the queries
+        try:
+            with Session(self._conn) as session:
+                # Create the HNSW index
+                session.execute(create_index_query)
+                session.commit()
+            print("HNSW extension and index created successfully.")  # noqa: T201
+        except Exception as e:
+            print(f"Failed to create HNSW extension or index: {e}")  # noqa: T201
+
+    def delete_collection(self) -> None:
+        self.logger.debug("Trying to delete collection")
+        with Session(self._conn) as session:
+            collection = self.get_collection(session)
+            if not collection:
+                self.logger.warning("Collection not found")
+                return
+            session.delete(collection)
+            session.commit()
+
+    def get_collection(self, session: Session) -> Optional["CollectionStore"]:
+        return CollectionStore.get_by_name(session, self.collection_name)
+
+    @classmethod
+    def _initialize_from_embeddings(
+        cls,
+        texts: List[str],
+        embeddings: List[List[float]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> PGEmbedding:
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        connection_string = cls.get_connection_string(kwargs)
+
+        store = cls(
+            connection_string=connection_string,
+            collection_name=collection_name,
+            embedding_function=embedding,
+            pre_delete_collection=pre_delete_collection,
+        )
+
+        store.add_embeddings(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+        return store
+
+    def add_embeddings(
+        self,
+        texts: List[str],
+        embeddings: List[List[float]],
+        metadatas: List[dict],
+        ids: List[str],
+        **kwargs: Any,
+    ) -> None:
+        with Session(self._conn) as session:
+            collection = self.get_collection(session)
+            if not collection:
+                raise ValueError("Collection not found")
+            for text, metadata, embedding, id in zip(texts, metadatas, embeddings, ids):
+                embedding_store = EmbeddingStore(
+                    embedding=embedding,
+                    document=text,
+                    cmetadata=metadata,
+                    custom_id=id,
+                )
+                collection.embeddings.append(embedding_store)
+                session.add(embedding_store)
+            session.commit()
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        embeddings = self.embedding_function.embed_documents(list(texts))
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        with Session(self._conn) as session:
+            collection = self.get_collection(session)
+            if not collection:
+                raise ValueError("Collection not found")
+            for text, metadata, embedding, id in zip(texts, metadatas, embeddings, ids):
+                embedding_store = EmbeddingStore(
+                    embedding=embedding,
+                    document=text,
+                    cmetadata=metadata,
+                    custom_id=id,
+                )
+                collection.embeddings.append(embedding_store)
+                session.add(embedding_store)
+            session.commit()
+
+        return ids
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        embedding = self.embedding_function.embed_query(text=query)
+        return self.similarity_search_by_vector(
+            embedding=embedding,
+            k=k,
+            filter=filter,
+        )
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+    ) -> List[Tuple[Document, float]]:
+        embedding = self.embedding_function.embed_query(query)
+        docs = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return docs
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[dict] = None,
+    ) -> List[Tuple[Document, float]]:
+        with Session(self._conn) as session:
+            collection = self.get_collection(session)
+            set_enable_seqscan_stmt = sqlalchemy.text("SET enable_seqscan = off")
+            session.execute(set_enable_seqscan_stmt)
+            if not collection:
+                raise ValueError("Collection not found")
+
+            filter_by = EmbeddingStore.collection_id == collection.uuid
+
+            if filter is not None:
+                filter_clauses = []
+                for key, value in filter.items():
+                    IN = "in"
+                    if isinstance(value, dict) and IN in map(str.lower, value):
+                        value_case_insensitive = {
+                            k.lower(): v for k, v in value.items()
+                        }
+                        filter_by_metadata = EmbeddingStore.cmetadata[key].astext.in_(
+                            value_case_insensitive[IN]
+                        )
+                        filter_clauses.append(filter_by_metadata)
+                    elif isinstance(value, dict) and "substring" in map(
+                        str.lower, value
+                    ):
+                        filter_by_metadata = EmbeddingStore.cmetadata[key].astext.ilike(
+                            f"%{value['substring']}%"
+                        )
+                        filter_clauses.append(filter_by_metadata)
+                    else:
+                        filter_by_metadata = EmbeddingStore.cmetadata[
+                            key
+                        ].astext == str(value)
+                        filter_clauses.append(filter_by_metadata)
+
+                filter_by = sqlalchemy.and_(filter_by, *filter_clauses)
+
+            results: List[QueryResult] = (
+                session.query(
+                    EmbeddingStore,
+                    func.abs(EmbeddingStore.embedding.op("<->")(embedding)).label(
+                        "distance"
+                    ),
+                )  # Specify the columns you need here, e.g., EmbeddingStore.embedding
+                .filter(filter_by)
+                .order_by(
+                    func.abs(EmbeddingStore.embedding.op("<->")(embedding)).asc()
+                )  # Using PostgreSQL specific operator with the correct column name
+                .limit(k)
+                .all()
+            )
+
+        docs = [
+            (
+                Document(
+                    page_content=result.EmbeddingStore.document,  # type: ignore[arg-type]
+                    metadata=result.EmbeddingStore.cmetadata,
+                ),
+                result.distance if self.embedding_function is not None else 0.0,
+            )
+            for result in results
+        ]
+        return docs
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    @classmethod
+    def from_texts(
+        cls: Type[PGEmbedding],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> PGEmbedding:
+        embeddings = embedding.embed_documents(list(texts))
+
+        return cls._initialize_from_embeddings(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            pre_delete_collection=pre_delete_collection,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_embeddings(
+        cls,
+        text_embeddings: List[Tuple[str, List[float]]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> PGEmbedding:
+        texts = [t[0] for t in text_embeddings]
+        embeddings = [t[1] for t in text_embeddings]
+
+        return cls._initialize_from_embeddings(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            pre_delete_collection=pre_delete_collection,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_existing_index(
+        cls: Type[PGEmbedding],
+        embedding: Embeddings,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> PGEmbedding:
+        connection_string = cls.get_connection_string(kwargs)
+
+        store = cls(
+            connection_string=connection_string,
+            collection_name=collection_name,
+            embedding_function=embedding,
+            pre_delete_collection=pre_delete_collection,
+        )
+
+        return store
+
+    @classmethod
+    def get_connection_string(cls, kwargs: Dict[str, Any]) -> str:
+        connection_string: str = get_from_dict_or_env(
+            data=kwargs,
+            key="connection_string",
+            env_key="POSTGRES_CONNECTION_STRING",
+        )
+
+        if not connection_string:
+            raise ValueError(
+                "Postgres connection string is required"
+                "Either pass it as a parameter"
+                "or set the POSTGRES_CONNECTION_STRING environment variable."
+            )
+
+        return connection_string
+
+    @classmethod
+    def from_documents(
+        cls: Type[PGEmbedding],
+        documents: List[Document],
+        embedding: Embeddings,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> PGEmbedding:
+        texts = [d.page_content for d in documents]
+        metadatas = [d.metadata for d in documents]
+        connection_string = cls.get_connection_string(kwargs)
+
+        kwargs["connection_string"] = connection_string
+
+        return cls.from_texts(
+            texts=texts,
+            pre_delete_collection=pre_delete_collection,
+            embedding=embedding,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/pgvecto_rs.py b/llm/Lib/site-packages/langchain_community/vectorstores/pgvecto_rs.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f1dbf42720223693b465f3f7b099b644557ed5b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/pgvecto_rs.py
@@ -0,0 +1,245 @@
+from __future__ import annotations
+
+import uuid
+from typing import Any, Dict, Iterable, List, Literal, Optional, Tuple, Union
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+
+class PGVecto_rs(VectorStore):
+    """VectorStore backed by pgvecto_rs."""
+
+    _store = None
+    _embedding: Embeddings
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        dimension: int,
+        db_url: str,
+        collection_name: str,
+        new_table: bool = False,
+    ) -> None:
+        """Initialize a PGVecto_rs vectorstore.
+
+        Args:
+            embedding: Embeddings to use.
+            dimension: Dimension of the embeddings.
+            db_url: Database URL.
+            collection_name: Name of the collection.
+            new_table: Whether to create a new table or connect to an existing one.
+            If true, the table will be dropped if exists, then recreated.
+            Defaults to False.
+        """
+        try:
+            from pgvecto_rs.sdk import PGVectoRs
+        except ImportError as e:
+            raise ImportError(
+                "Unable to import pgvector_rs.sdk , please install with "
+                '`pip install "pgvecto_rs[sdk]"`.'
+            ) from e
+        self._store = PGVectoRs(
+            db_url=db_url,
+            collection_name=collection_name,
+            dimension=dimension,
+            recreate=new_table,
+        )
+        self._embedding = embedding
+
+    # ================ Create interface =================
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        db_url: str = "",
+        collection_name: str = str(uuid.uuid4().hex),
+        **kwargs: Any,
+    ) -> PGVecto_rs:
+        """Return VectorStore initialized from texts and optional metadatas."""
+        sample_embedding = embedding.embed_query("Hello pgvecto_rs!")
+        dimension = len(sample_embedding)
+        if db_url is None:
+            raise ValueError("db_url must be provided")
+        _self: PGVecto_rs = cls(
+            embedding=embedding,
+            dimension=dimension,
+            db_url=db_url,
+            collection_name=collection_name,
+        )
+        _self.add_texts(texts, metadatas, **kwargs)
+        return _self
+
+    @classmethod
+    def from_documents(
+        cls,
+        documents: List[Document],
+        embedding: Embeddings,
+        db_url: str = "",
+        collection_name: str = str(uuid.uuid4().hex),
+        **kwargs: Any,
+    ) -> PGVecto_rs:
+        """Return VectorStore initialized from documents."""
+        texts = [document.page_content for document in documents]
+        metadatas = [document.metadata for document in documents]
+        return cls.from_texts(
+            texts, embedding, metadatas, db_url, collection_name, **kwargs
+        )
+
+    @classmethod
+    def from_collection_name(
+        cls,
+        embedding: Embeddings,
+        db_url: str,
+        collection_name: str,
+    ) -> PGVecto_rs:
+        """Create new empty vectorstore with collection_name.
+        Or connect to an existing vectorstore in database if exists.
+        Arguments should be the same as when the vectorstore was created."""
+        sample_embedding = embedding.embed_query("Hello pgvecto_rs!")
+        return cls(
+            embedding=embedding,
+            dimension=len(sample_embedding),
+            db_url=db_url,
+            collection_name=collection_name,
+        )
+
+    # ================ Insert interface =================
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids of the added texts.
+
+        """
+        from pgvecto_rs.sdk import Record
+
+        embeddings = self._embedding.embed_documents(list(texts))
+        records = [
+            Record.from_text(text, embedding, meta)
+            for text, embedding, meta in zip(texts, embeddings, metadatas or [])
+        ]
+        self._store.insert(records)  # type: ignore[union-attr]
+        return [str(record.id) for record in records]
+
+    def add_documents(self, documents: List[Document], **kwargs: Any) -> List[str]:
+        """Run more documents through the embeddings and add to the vectorstore.
+
+        Args:
+            documents (List[Document]): List of documents to add to the vectorstore.
+
+        Returns:
+            List of ids of the added documents.
+        """
+        return self.add_texts(
+            [document.page_content for document in documents],
+            [document.metadata for document in documents],
+            **kwargs,
+        )
+
+    # ================ Query interface =================
+    def similarity_search_with_score_by_vector(
+        self,
+        query_vector: List[float],
+        k: int = 4,
+        distance_func: Literal[
+            "sqrt_euclid", "neg_dot_prod", "ned_cos"
+        ] = "sqrt_euclid",
+        filter: Union[None, Dict[str, Any], Any] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query vector, with its score."""
+
+        from pgvecto_rs.sdk.filters import meta_contains
+
+        distance_func_map = {
+            "sqrt_euclid": "<->",
+            "neg_dot_prod": "<#>",
+            "ned_cos": "<=>",
+        }
+        if filter is None:
+            real_filter = None
+        elif isinstance(filter, dict):
+            real_filter = meta_contains(filter)
+        else:
+            real_filter = filter
+        results = self._store.search(  # type: ignore[union-attr]
+            query_vector,
+            distance_func_map[distance_func],
+            k,
+            filter=real_filter,
+        )
+
+        return [
+            (
+                Document(
+                    page_content=res[0].text,
+                    metadata=res[0].meta,
+                ),
+                res[1],
+            )
+            for res in results
+        ]
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        distance_func: Literal[
+            "sqrt_euclid", "neg_dot_prod", "ned_cos"
+        ] = "sqrt_euclid",
+        filter: Optional[Any] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        return [
+            doc
+            for doc, _score in self.similarity_search_with_score_by_vector(
+                embedding, k, distance_func, **kwargs
+            )
+        ]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        distance_func: Literal[
+            "sqrt_euclid", "neg_dot_prod", "ned_cos"
+        ] = "sqrt_euclid",
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        query_vector = self._embedding.embed_query(query)
+        return self.similarity_search_with_score_by_vector(
+            query_vector, k, distance_func, **kwargs
+        )
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        distance_func: Literal[
+            "sqrt_euclid", "neg_dot_prod", "ned_cos"
+        ] = "sqrt_euclid",
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query."""
+        query_vector = self._embedding.embed_query(query)
+        return [
+            doc
+            for doc, _score in self.similarity_search_with_score_by_vector(
+                query_vector, k, distance_func, **kwargs
+            )
+        ]
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/pgvector.py b/llm/Lib/site-packages/langchain_community/vectorstores/pgvector.py
new file mode 100644
index 0000000000000000000000000000000000000000..af0f9ad32ff3e56bab9991ce0c521300f4a31bb3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/pgvector.py
@@ -0,0 +1,1377 @@
+from __future__ import annotations
+
+import contextlib
+import enum
+import json
+import logging
+import uuid
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Generator,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+)
+
+import numpy as np
+import sqlalchemy
+from langchain_core._api import deprecated, warn_deprecated
+from sqlalchemy import SQLColumnExpression, delete, func
+from sqlalchemy.dialects.postgresql import JSON, JSONB, UUID
+from sqlalchemy.orm import Session, relationship
+
+try:
+    from sqlalchemy.orm import declarative_base
+except ImportError:
+    from sqlalchemy.ext.declarative import declarative_base
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.runnables.config import run_in_executor
+from langchain_core.utils import get_from_dict_or_env
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+
+class DistanceStrategy(str, enum.Enum):
+    """Enumerator of the Distance strategies."""
+
+    EUCLIDEAN = "l2"
+    COSINE = "cosine"
+    MAX_INNER_PRODUCT = "inner"
+
+
+DEFAULT_DISTANCE_STRATEGY = DistanceStrategy.COSINE
+
+Base = declarative_base()  # type: Any
+
+
+_LANGCHAIN_DEFAULT_COLLECTION_NAME = "langchain"
+
+
+class BaseModel(Base):
+    """Base model for the SQL stores."""
+
+    __abstract__ = True
+    uuid = sqlalchemy.Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+
+
+_classes: Any = None
+
+COMPARISONS_TO_NATIVE = {
+    "$eq": "==",
+    "$ne": "!=",
+    "$lt": "<",
+    "$lte": "<=",
+    "$gt": ">",
+    "$gte": ">=",
+}
+
+SPECIAL_CASED_OPERATORS = {
+    "$in",
+    "$nin",
+    "$between",
+}
+
+TEXT_OPERATORS = {
+    "$like",
+    "$ilike",
+}
+
+LOGICAL_OPERATORS = {"$and", "$or"}
+
+SUPPORTED_OPERATORS = (
+    set(COMPARISONS_TO_NATIVE)
+    .union(TEXT_OPERATORS)
+    .union(LOGICAL_OPERATORS)
+    .union(SPECIAL_CASED_OPERATORS)
+)
+
+
+def _get_embedding_collection_store(
+    vector_dimension: Optional[int] = None, *, use_jsonb: bool = True
+) -> Any:
+    global _classes
+    if _classes is not None:
+        return _classes
+
+    from pgvector.sqlalchemy import Vector
+
+    class CollectionStore(BaseModel):
+        """Collection store."""
+
+        __tablename__ = "langchain_pg_collection"
+
+        name = sqlalchemy.Column(sqlalchemy.String)
+        cmetadata = sqlalchemy.Column(JSON)
+
+        embeddings = relationship(
+            "EmbeddingStore",
+            back_populates="collection",
+            passive_deletes=True,
+        )
+
+        @classmethod
+        def get_by_name(
+            cls, session: Session, name: str
+        ) -> Optional["CollectionStore"]:
+            return session.query(cls).filter(cls.name == name).first()  # type: ignore
+
+        @classmethod
+        def get_or_create(
+            cls,
+            session: Session,
+            name: str,
+            cmetadata: Optional[dict] = None,
+        ) -> Tuple["CollectionStore", bool]:
+            """
+            Get or create a collection.
+            Returns [Collection, bool] where the bool is True if the collection was created.
+            """  # noqa: E501
+            created = False
+            collection = cls.get_by_name(session, name)
+            if collection:
+                return collection, created
+
+            collection = cls(name=name, cmetadata=cmetadata)
+            session.add(collection)
+            session.commit()
+            created = True
+            return collection, created
+
+    if use_jsonb:
+        # TODO(PRIOR TO LANDING): Create a gin index on the cmetadata field
+        class EmbeddingStore(BaseModel):
+            """Embedding store."""
+
+            __tablename__ = "langchain_pg_embedding"
+
+            collection_id = sqlalchemy.Column(
+                UUID(as_uuid=True),
+                sqlalchemy.ForeignKey(
+                    f"{CollectionStore.__tablename__}.uuid",
+                    ondelete="CASCADE",
+                ),
+            )
+            collection = relationship(CollectionStore, back_populates="embeddings")
+
+            embedding: Vector = sqlalchemy.Column(Vector(vector_dimension))
+            document = sqlalchemy.Column(sqlalchemy.String, nullable=True)
+            cmetadata = sqlalchemy.Column(JSONB, nullable=True)
+
+            # custom_id : any user defined id
+            custom_id = sqlalchemy.Column(sqlalchemy.String, nullable=True)
+
+            __table_args__ = (
+                sqlalchemy.Index(
+                    "ix_cmetadata_gin",
+                    "cmetadata",
+                    postgresql_using="gin",
+                    postgresql_ops={"cmetadata": "jsonb_path_ops"},
+                ),
+            )
+    else:
+        # For backwards comaptibilty with older versions of pgvector
+        # This should be removed in the future (remove during migration)
+        class EmbeddingStore(BaseModel):  # type: ignore[no-redef]
+            """Embedding store."""
+
+            __tablename__ = "langchain_pg_embedding"
+
+            collection_id = sqlalchemy.Column(
+                UUID(as_uuid=True),
+                sqlalchemy.ForeignKey(
+                    f"{CollectionStore.__tablename__}.uuid",
+                    ondelete="CASCADE",
+                ),
+            )
+            collection = relationship(CollectionStore, back_populates="embeddings")
+
+            embedding: Vector = sqlalchemy.Column(Vector(vector_dimension))
+            document = sqlalchemy.Column(sqlalchemy.String, nullable=True)
+            cmetadata = sqlalchemy.Column(JSON, nullable=True)
+
+            # custom_id : any user defined id
+            custom_id = sqlalchemy.Column(sqlalchemy.String, nullable=True)
+
+    _classes = (EmbeddingStore, CollectionStore)
+
+    return _classes
+
+
+def _results_to_docs(docs_and_scores: Any) -> List[Document]:
+    """Return docs from docs and scores."""
+    return [doc for doc, _ in docs_and_scores]
+
+
+@deprecated(
+    since="0.0.31",
+    message=(
+        "This class is pending deprecation and may be removed in a future version. "
+        "You can swap to using the `PGVector`"
+        " implementation in `langchain_postgres`. "
+        "Please read the guidelines in the doc-string of this class "
+        "to follow prior to migrating as there are some differences "
+        "between the implementations. "
+        "See https://github.com/langchain-ai/langchain-postgres for details about"
+        "the new implementation."
+    ),
+    alternative="from langchain_postgres import PGVector;",
+    pending=True,
+)
+class PGVector(VectorStore):
+    """`Postgres`/`PGVector` vector store.
+
+    **DEPRECATED**: This class is pending deprecation and will likely receive
+        no updates. An improved version of this class is available in
+        `langchain_postgres` as `PGVector`. Please use that class instead.
+
+        When migrating please keep in mind that:
+            * The new implementation works with psycopg3, not with psycopg2
+              (This implementation does not work with psycopg3).
+            * Filtering syntax has changed to use $ prefixed operators for JSONB
+              metadata fields. (New implementation only uses JSONB field for metadata)
+            * The new implementation made some schema changes to address issues
+              with the existing implementation. So you will need to re-create
+              your tables and re-index your data or else carry out a manual
+              migration.
+
+    To use, you should have the ``pgvector`` python package installed.
+
+    Args:
+        connection_string: Postgres connection string.
+        embedding_function: Any embedding function implementing
+            `langchain.embeddings.base.Embeddings` interface.
+        embedding_length: The length of the embedding vector. (default: None)
+            NOTE: This is not mandatory. Defining it will prevent vectors of
+            any other size to be added to the embeddings table but, without it,
+            the embeddings can't be indexed.
+        collection_name: The name of the collection to use. (default: langchain)
+            NOTE: This is not the name of the table, but the name of the collection.
+            The tables will be created when initializing the store (if not exists)
+            So, make sure the user has the right permissions to create tables.
+        distance_strategy: The distance strategy to use. (default: COSINE)
+        pre_delete_collection: If True, will delete the collection if it exists.
+            (default: False). Useful for testing.
+        engine_args: SQLAlchemy's create engine arguments.
+        use_jsonb: Use JSONB instead of JSON for metadata. (default: True)
+            Strongly discouraged from using JSON as it's not as efficient
+            for querying.
+            It's provided here for backwards compatibility with older versions,
+            and will be removed in the future.
+        create_extension: If True, will create the vector extension if it doesn't exist.
+            disabling creation is useful when using ReadOnly Databases.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import PGVector
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+            CONNECTION_STRING = "postgresql+psycopg2://hwc@localhost:5432/test3"
+            COLLECTION_NAME = "state_of_the_union_test"
+            embeddings = OpenAIEmbeddings()
+            vectorestore = PGVector.from_documents(
+                embedding=embeddings,
+                documents=docs,
+                collection_name=COLLECTION_NAME,
+                connection_string=CONNECTION_STRING,
+                use_jsonb=True,
+            )
+    """
+
+    def __init__(
+        self,
+        connection_string: str,
+        embedding_function: Embeddings,
+        embedding_length: Optional[int] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        collection_metadata: Optional[dict] = None,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        pre_delete_collection: bool = False,
+        logger: Optional[logging.Logger] = None,
+        relevance_score_fn: Optional[Callable[[float], float]] = None,
+        *,
+        connection: Optional[sqlalchemy.engine.Connection] = None,
+        engine_args: Optional[dict[str, Any]] = None,
+        use_jsonb: bool = False,
+        create_extension: bool = True,
+    ) -> None:
+        """Initialize the PGVector store."""
+        self.connection_string = connection_string
+        self.embedding_function = embedding_function
+        self._embedding_length = embedding_length
+        self.collection_name = collection_name
+        self.collection_metadata = collection_metadata
+        self._distance_strategy = distance_strategy
+        self.pre_delete_collection = pre_delete_collection
+        self.logger = logger or logging.getLogger(__name__)
+        self.override_relevance_score_fn = relevance_score_fn
+        self.engine_args = engine_args or {}
+        self._bind = connection if connection else self._create_engine()
+        self.use_jsonb = use_jsonb
+        self.create_extension = create_extension
+
+        if not use_jsonb:
+            # Replace with a deprecation warning.
+            warn_deprecated(
+                "0.0.29",
+                pending=True,
+                message=(
+                    "Please use JSONB instead of JSON for metadata. "
+                    "This change will allow for more efficient querying that "
+                    "involves filtering based on metadata."
+                    "Please note that filtering operators have been changed "
+                    "when using JSOB metadata to be prefixed with a $ sign "
+                    "to avoid name collisions with columns. "
+                    "If you're using an existing database, you will need to create a"
+                    "db migration for your metadata column to be JSONB and update your "
+                    "queries to use the new operators. "
+                ),
+                alternative=(
+                    "Instantiate with use_jsonb=True to use JSONB instead "
+                    "of JSON for metadata."
+                ),
+            )
+        self.__post_init__()
+
+    def __post_init__(
+        self,
+    ) -> None:
+        """Initialize the store."""
+        if self.create_extension:
+            self.create_vector_extension()
+
+        EmbeddingStore, CollectionStore = _get_embedding_collection_store(
+            self._embedding_length, use_jsonb=self.use_jsonb
+        )
+        self.CollectionStore = CollectionStore
+        self.EmbeddingStore = EmbeddingStore
+        self.create_tables_if_not_exists()
+        self.create_collection()
+
+    def __del__(self) -> None:
+        if isinstance(self._bind, sqlalchemy.engine.Connection):
+            self._bind.close()
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding_function
+
+    def _create_engine(self) -> sqlalchemy.engine.Engine:
+        return sqlalchemy.create_engine(url=self.connection_string, **self.engine_args)
+
+    def create_vector_extension(self) -> None:
+        try:
+            with Session(self._bind) as session:  # type: ignore[arg-type]
+                # The advisor lock fixes issue arising from concurrent
+                # creation of the vector extension.
+                # https://github.com/langchain-ai/langchain/issues/12933
+                # For more information see:
+                # https://www.postgresql.org/docs/16/explicit-locking.html#ADVISORY-LOCKS
+                statement = sqlalchemy.text(
+                    "BEGIN;"
+                    "SELECT pg_advisory_xact_lock(1573678846307946496);"
+                    "CREATE EXTENSION IF NOT EXISTS vector;"
+                    "COMMIT;"
+                )
+                session.execute(statement)
+                session.commit()
+        except Exception as e:
+            raise Exception(f"Failed to create vector extension: {e}") from e
+
+    def create_tables_if_not_exists(self) -> None:
+        with Session(self._bind) as session, session.begin():  # type: ignore[arg-type]
+            Base.metadata.create_all(session.get_bind())
+
+    def drop_tables(self) -> None:
+        with Session(self._bind) as session, session.begin():  # type: ignore[arg-type]
+            Base.metadata.drop_all(session.get_bind())
+
+    def create_collection(self) -> None:
+        if self.pre_delete_collection:
+            self.delete_collection()
+        with Session(self._bind) as session:  # type: ignore[arg-type]
+            self.CollectionStore.get_or_create(
+                session, self.collection_name, cmetadata=self.collection_metadata
+            )
+
+    def delete_collection(self) -> None:
+        self.logger.debug("Trying to delete collection")
+        with Session(self._bind) as session:  # type: ignore[arg-type]
+            collection = self.get_collection(session)
+            if not collection:
+                self.logger.warning("Collection not found")
+                return
+            session.delete(collection)
+            session.commit()
+
+    @contextlib.contextmanager
+    def _make_session(self) -> Generator[Session, None, None]:
+        """Create a context manager for the session, bind to _conn string."""
+        yield Session(self._bind)  # type: ignore[arg-type]
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        collection_only: bool = False,
+        **kwargs: Any,
+    ) -> None:
+        """Delete vectors by ids or uuids.
+
+        Args:
+            ids: List of ids to delete.
+            collection_only: Only delete ids in the collection.
+        """
+        with Session(self._bind) as session:  # type: ignore[arg-type]
+            if ids is not None:
+                self.logger.debug(
+                    "Trying to delete vectors by ids (represented by the model "
+                    "using the custom ids field)"
+                )
+
+                stmt = delete(self.EmbeddingStore)
+
+                if collection_only:
+                    collection = self.get_collection(session)
+                    if not collection:
+                        self.logger.warning("Collection not found")
+                        return
+
+                    stmt = stmt.where(
+                        self.EmbeddingStore.collection_id == collection.uuid
+                    )
+
+                stmt = stmt.where(self.EmbeddingStore.custom_id.in_(ids))
+                session.execute(stmt)
+            session.commit()
+
+    def get_collection(self, session: Session) -> Any:
+        return self.CollectionStore.get_by_name(session, self.collection_name)
+
+    @classmethod
+    def __from(
+        cls,
+        texts: List[str],
+        embeddings: List[List[float]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        connection_string: Optional[str] = None,
+        pre_delete_collection: bool = False,
+        *,
+        use_jsonb: bool = False,
+        **kwargs: Any,
+    ) -> PGVector:
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+        if connection_string is None:
+            connection_string = cls.get_connection_string(kwargs)
+
+        store = cls(
+            connection_string=connection_string,
+            collection_name=collection_name,
+            embedding_function=embedding,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+            use_jsonb=use_jsonb,
+            **kwargs,
+        )
+
+        store.add_embeddings(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+        return store
+
+    def add_embeddings(
+        self,
+        texts: Iterable[str],
+        embeddings: List[List[float]],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add embeddings to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            embeddings: List of list of embedding vectors.
+            metadatas: List of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+        """
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        with Session(self._bind) as session:  # type: ignore[arg-type]
+            collection = self.get_collection(session)
+            if not collection:
+                raise ValueError("Collection not found")
+            documents = []
+            for text, metadata, embedding, id in zip(texts, metadatas, embeddings, ids):
+                embedding_store = self.EmbeddingStore(
+                    embedding=embedding,
+                    document=text,
+                    cmetadata=metadata,
+                    custom_id=id,
+                    collection_id=collection.uuid,
+                )
+                documents.append(embedding_store)
+            session.bulk_save_objects(documents)
+            session.commit()
+
+        return ids
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        embeddings = self.embedding_function.embed_documents(list(texts))
+        return self.add_embeddings(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search with PGVector with distance.
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        embedding = self.embedding_function.embed_query(text=query)
+        return self.similarity_search_by_vector(
+            embedding=embedding,
+            k=k,
+            filter=filter,
+        )
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query and score for each.
+        """
+        embedding = self.embedding_function.embed_query(query)
+        docs = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return docs
+
+    @property
+    def distance_strategy(self) -> Any:
+        if self._distance_strategy == DistanceStrategy.EUCLIDEAN:
+            return self.EmbeddingStore.embedding.l2_distance
+        elif self._distance_strategy == DistanceStrategy.COSINE:
+            return self.EmbeddingStore.embedding.cosine_distance
+        elif self._distance_strategy == DistanceStrategy.MAX_INNER_PRODUCT:
+            return self.EmbeddingStore.embedding.max_inner_product
+        else:
+            raise ValueError(
+                f"Got unexpected value for distance: {self._distance_strategy}. "
+                f"Should be one of {', '.join([ds.value for ds in DistanceStrategy])}."
+            )
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[dict] = None,
+    ) -> List[Tuple[Document, float]]:
+        results = self.__query_collection(embedding=embedding, k=k, filter=filter)
+
+        return self._results_to_docs_and_scores(results)
+
+    def _results_to_docs_and_scores(self, results: Any) -> List[Tuple[Document, float]]:
+        """Return docs and scores from results."""
+        docs = [
+            (
+                Document(
+                    page_content=result.EmbeddingStore.document,
+                    metadata=result.EmbeddingStore.cmetadata,
+                ),
+                result.distance if self.embedding_function is not None else None,
+            )
+            for result in results
+        ]
+        return docs
+
+    def _handle_field_filter(
+        self,
+        field: str,
+        value: Any,
+    ) -> SQLColumnExpression:
+        """Create a filter for a specific field.
+
+        Args:
+            field: name of field
+            value: value to filter
+                If provided as is then this will be an equality filter
+                If provided as a dictionary then this will be a filter, the key
+                will be the operator and the value will be the value to filter by
+
+        Returns:
+            sqlalchemy expression
+        """
+        if not isinstance(field, str):
+            raise ValueError(
+                f"field should be a string but got: {type(field)} with value: {field}"
+            )
+
+        if field.startswith("$"):
+            raise ValueError(
+                f"Invalid filter condition. Expected a field but got an operator: "
+                f"{field}"
+            )
+
+        # Allow [a-zA-Z0-9_], disallow $ for now until we support escape characters
+        if not field.isidentifier():
+            raise ValueError(
+                f"Invalid field name: {field}. Expected a valid identifier."
+            )
+
+        if isinstance(value, dict):
+            # This is a filter specification
+            if len(value) != 1:
+                raise ValueError(
+                    "Invalid filter condition. Expected a value which "
+                    "is a dictionary with a single key that corresponds to an operator "
+                    f"but got a dictionary with {len(value)} keys. The first few "
+                    f"keys are: {list(value.keys())[:3]}"
+                )
+            operator, filter_value = list(value.items())[0]
+            # Verify that that operator is an operator
+            if operator not in SUPPORTED_OPERATORS:
+                raise ValueError(
+                    f"Invalid operator: {operator}. "
+                    f"Expected one of {SUPPORTED_OPERATORS}"
+                )
+        else:  # Then we assume an equality operator
+            operator = "$eq"
+            filter_value = value
+
+        if operator in COMPARISONS_TO_NATIVE:
+            # Then we implement an equality filter
+            # native is trusted input
+            native = COMPARISONS_TO_NATIVE[operator]
+            return func.jsonb_path_match(
+                self.EmbeddingStore.cmetadata,
+                f"$.{field} {native} $value",
+                json.dumps({"value": filter_value}),
+            )
+        elif operator == "$between":
+            # Use AND with two comparisons
+            low, high = filter_value
+
+            lower_bound = func.jsonb_path_match(
+                self.EmbeddingStore.cmetadata,
+                f"$.{field} >= $value",
+                json.dumps({"value": low}),
+            )
+            upper_bound = func.jsonb_path_match(
+                self.EmbeddingStore.cmetadata,
+                f"$.{field} <= $value",
+                json.dumps({"value": high}),
+            )
+            return sqlalchemy.and_(lower_bound, upper_bound)
+        elif operator in {"$in", "$nin", "$like", "$ilike"}:
+            # We'll do force coercion to text
+            if operator in {"$in", "$nin"}:
+                for val in filter_value:
+                    if not isinstance(val, (str, int, float)):
+                        raise NotImplementedError(
+                            f"Unsupported type: {type(val)} for value: {val}"
+                        )
+
+            queried_field = self.EmbeddingStore.cmetadata[field].astext
+
+            if operator in {"$in"}:
+                return queried_field.in_([str(val) for val in filter_value])
+            elif operator in {"$nin"}:
+                return queried_field.nin_([str(val) for val in filter_value])
+            elif operator in {"$like"}:
+                return queried_field.like(filter_value)
+            elif operator in {"$ilike"}:
+                return queried_field.ilike(filter_value)
+            else:
+                raise NotImplementedError()
+        else:
+            raise NotImplementedError()
+
+    def _create_filter_clause_deprecated(self, key, value):  # type: ignore[no-untyped-def]
+        """Deprecated functionality.
+
+        This is for backwards compatibility with the JSON based schema for metadata.
+        It uses incorrect operator syntax (operators are not prefixed with $).
+
+        This implementation is not efficient, and has bugs associated with
+        the way that it handles numeric filter clauses.
+        """
+        IN, NIN, BETWEEN, GT, LT, NE = "in", "nin", "between", "gt", "lt", "ne"
+        EQ, LIKE, CONTAINS, OR, AND = "eq", "like", "contains", "or", "and"
+
+        value_case_insensitive = {k.lower(): v for k, v in value.items()}
+        if IN in map(str.lower, value):
+            filter_by_metadata = self.EmbeddingStore.cmetadata[key].astext.in_(
+                value_case_insensitive[IN]
+            )
+        elif NIN in map(str.lower, value):
+            filter_by_metadata = self.EmbeddingStore.cmetadata[key].astext.not_in(
+                value_case_insensitive[NIN]
+            )
+        elif BETWEEN in map(str.lower, value):
+            filter_by_metadata = self.EmbeddingStore.cmetadata[key].astext.between(
+                str(value_case_insensitive[BETWEEN][0]),
+                str(value_case_insensitive[BETWEEN][1]),
+            )
+        elif GT in map(str.lower, value):
+            filter_by_metadata = self.EmbeddingStore.cmetadata[key].astext > str(
+                value_case_insensitive[GT]
+            )
+        elif LT in map(str.lower, value):
+            filter_by_metadata = self.EmbeddingStore.cmetadata[key].astext < str(
+                value_case_insensitive[LT]
+            )
+        elif NE in map(str.lower, value):
+            filter_by_metadata = self.EmbeddingStore.cmetadata[key].astext != str(
+                value_case_insensitive[NE]
+            )
+        elif EQ in map(str.lower, value):
+            filter_by_metadata = self.EmbeddingStore.cmetadata[key].astext == str(
+                value_case_insensitive[EQ]
+            )
+        elif LIKE in map(str.lower, value):
+            filter_by_metadata = self.EmbeddingStore.cmetadata[key].astext.like(
+                value_case_insensitive[LIKE]
+            )
+        elif CONTAINS in map(str.lower, value):
+            filter_by_metadata = self.EmbeddingStore.cmetadata[key].astext.contains(
+                value_case_insensitive[CONTAINS]
+            )
+        elif OR in map(str.lower, value):
+            or_clauses = [
+                self._create_filter_clause_deprecated(key, sub_value)
+                for sub_value in value_case_insensitive[OR]
+            ]
+            filter_by_metadata = sqlalchemy.or_(*or_clauses)
+        elif AND in map(str.lower, value):
+            and_clauses = [
+                self._create_filter_clause_deprecated(key, sub_value)
+                for sub_value in value_case_insensitive[AND]
+            ]
+            filter_by_metadata = sqlalchemy.and_(*and_clauses)
+
+        else:
+            filter_by_metadata = None
+
+        return filter_by_metadata
+
+    def _create_filter_clause_json_deprecated(
+        self, filter: Any
+    ) -> List[SQLColumnExpression]:
+        """Convert filters from IR to SQL clauses.
+
+        **DEPRECATED** This functionality will be deprecated in the future.
+
+        It implements translation of filters for a schema that uses JSON
+        for metadata rather than the JSONB field which is more efficient
+        for querying.
+        """
+        filter_clauses = []
+        for key, value in filter.items():
+            if isinstance(value, dict):
+                filter_by_metadata = self._create_filter_clause_deprecated(key, value)
+
+                if filter_by_metadata is not None:
+                    filter_clauses.append(filter_by_metadata)
+            else:
+                filter_by_metadata = self.EmbeddingStore.cmetadata[key].astext == str(
+                    value
+                )
+                filter_clauses.append(filter_by_metadata)
+        return filter_clauses
+
+    def _create_filter_clause(self, filters: Any) -> Any:
+        """Convert LangChain IR filter representation to matching SQLAlchemy clauses.
+
+        At the top level, we still don't know if we're working with a field
+        or an operator for the keys. After we've determined that we can
+        call the appropriate logic to handle filter creation.
+
+        Args:
+            filters: Dictionary of filters to apply to the query.
+
+        Returns:
+            SQLAlchemy clause to apply to the query.
+        """
+        if isinstance(filters, dict):
+            if len(filters) == 1:
+                # The only operators allowed at the top level are $AND and $OR
+                # First check if an operator or a field
+                key, value = list(filters.items())[0]
+                if key.startswith("$"):
+                    # Then it's an operator
+                    if key.lower() not in ["$and", "$or"]:
+                        raise ValueError(
+                            f"Invalid filter condition. Expected $and or $or "
+                            f"but got: {key}"
+                        )
+                else:
+                    # Then it's a field
+                    return self._handle_field_filter(key, filters[key])
+
+                # Here we handle the $and and $or operators
+                if not isinstance(value, list):
+                    raise ValueError(
+                        f"Expected a list, but got {type(value)} for value: {value}"
+                    )
+                if key.lower() == "$and":
+                    and_ = [self._create_filter_clause(el) for el in value]
+                    if len(and_) > 1:
+                        return sqlalchemy.and_(*and_)
+                    elif len(and_) == 1:
+                        return and_[0]
+                    else:
+                        raise ValueError(
+                            "Invalid filter condition. Expected a dictionary "
+                            "but got an empty dictionary"
+                        )
+                elif key.lower() == "$or":
+                    or_ = [self._create_filter_clause(el) for el in value]
+                    if len(or_) > 1:
+                        return sqlalchemy.or_(*or_)
+                    elif len(or_) == 1:
+                        return or_[0]
+                    else:
+                        raise ValueError(
+                            "Invalid filter condition. Expected a dictionary "
+                            "but got an empty dictionary"
+                        )
+                else:
+                    raise ValueError(
+                        f"Invalid filter condition. Expected $and or $or "
+                        f"but got: {key}"
+                    )
+            elif len(filters) > 1:
+                # Then all keys have to be fields (they cannot be operators)
+                for key in filters.keys():
+                    if key.startswith("$"):
+                        raise ValueError(
+                            f"Invalid filter condition. Expected a field but got: {key}"
+                        )
+                # These should all be fields and combined using an $and operator
+                and_ = [self._handle_field_filter(k, v) for k, v in filters.items()]
+                if len(and_) > 1:
+                    return sqlalchemy.and_(*and_)
+                elif len(and_) == 1:
+                    return and_[0]
+                else:
+                    raise ValueError(
+                        "Invalid filter condition. Expected a dictionary "
+                        "but got an empty dictionary"
+                    )
+            else:
+                raise ValueError("Got an empty dictionary for filters.")
+        else:
+            raise ValueError(
+                f"Invalid type: Expected a dictionary but got type: {type(filters)}"
+            )
+
+    def __query_collection(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, str]] = None,
+    ) -> List[Any]:
+        """Query the collection."""
+        with Session(self._bind) as session:  # type: ignore[arg-type]
+            collection = self.get_collection(session)
+            if not collection:
+                raise ValueError("Collection not found")
+
+            filter_by = [self.EmbeddingStore.collection_id == collection.uuid]
+            if filter:
+                if self.use_jsonb:
+                    filter_clauses = self._create_filter_clause(filter)
+                    if filter_clauses is not None:
+                        filter_by.append(filter_clauses)
+                else:
+                    # Old way of doing things
+                    filter_clauses = self._create_filter_clause_json_deprecated(filter)
+                    filter_by.extend(filter_clauses)
+
+            _type = self.EmbeddingStore
+
+            results: List[Any] = (
+                session.query(
+                    self.EmbeddingStore,
+                    self.distance_strategy(embedding).label("distance"),  # type: ignore
+                )
+                .filter(*filter_by)
+                .order_by(sqlalchemy.asc("distance"))
+                .join(
+                    self.CollectionStore,
+                    self.EmbeddingStore.collection_id == self.CollectionStore.uuid,
+                )
+                .limit(k)
+                .all()
+            )
+
+        return results
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter
+        )
+        return _results_to_docs(docs_and_scores)
+
+    @classmethod
+    def from_texts(
+        cls: Type[PGVector],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        *,
+        use_jsonb: bool = False,
+        **kwargs: Any,
+    ) -> PGVector:
+        """
+        Return VectorStore initialized from texts and embeddings.
+        Postgres connection string is required
+        "Either pass it as a parameter
+        or set the PGVECTOR_CONNECTION_STRING environment variable.
+        """
+        embeddings = embedding.embed_documents(list(texts))
+
+        return cls.__from(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+            use_jsonb=use_jsonb,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_embeddings(
+        cls,
+        text_embeddings: List[Tuple[str, List[float]]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> PGVector:
+        """Construct PGVector wrapper from raw documents and pre-
+        generated embeddings.
+
+        Return VectorStore initialized from documents and embeddings.
+        Postgres connection string is required
+        "Either pass it as a parameter
+        or set the PGVECTOR_CONNECTION_STRING environment variable.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import PGVector
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                text_embeddings = embeddings.embed_documents(texts)
+                text_embedding_pairs = list(zip(texts, text_embeddings))
+                faiss = PGVector.from_embeddings(text_embedding_pairs, embeddings)
+        """
+        texts = [t[0] for t in text_embeddings]
+        embeddings = [t[1] for t in text_embeddings]
+
+        return cls.__from(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_existing_index(
+        cls: Type[PGVector],
+        embedding: Embeddings,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> PGVector:
+        """
+        Get instance of an existing PGVector store.This method will
+        return the instance of the store without inserting any new
+        embeddings
+        """
+
+        connection_string = cls.get_connection_string(kwargs)
+
+        store = cls(
+            connection_string=connection_string,
+            collection_name=collection_name,
+            embedding_function=embedding,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+        )
+
+        return store
+
+    @classmethod
+    def get_connection_string(cls, kwargs: Dict[str, Any]) -> str:
+        connection_string: str = get_from_dict_or_env(
+            data=kwargs,
+            key="connection_string",
+            env_key="PGVECTOR_CONNECTION_STRING",
+        )
+
+        if not connection_string:
+            raise ValueError(
+                "Postgres connection string is required"
+                "Either pass it as a parameter"
+                "or set the PGVECTOR_CONNECTION_STRING environment variable."
+            )
+
+        return connection_string
+
+    @classmethod
+    def from_documents(
+        cls: Type[PGVector],
+        documents: List[Document],
+        embedding: Embeddings,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        *,
+        use_jsonb: bool = False,
+        **kwargs: Any,
+    ) -> PGVector:
+        """
+        Return VectorStore initialized from documents and embeddings.
+        Postgres connection string is required
+        "Either pass it as a parameter
+        or set the PGVECTOR_CONNECTION_STRING environment variable.
+        """
+
+        texts = [d.page_content for d in documents]
+        metadatas = [d.metadata for d in documents]
+        connection_string = cls.get_connection_string(kwargs)
+
+        kwargs["connection_string"] = connection_string
+
+        return cls.from_texts(
+            texts=texts,
+            pre_delete_collection=pre_delete_collection,
+            embedding=embedding,
+            distance_strategy=distance_strategy,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            use_jsonb=use_jsonb,
+            **kwargs,
+        )
+
+    @classmethod
+    def connection_string_from_db_params(
+        cls,
+        driver: str,
+        host: str,
+        port: int,
+        database: str,
+        user: str,
+        password: str,
+    ) -> str:
+        """Return connection string from database parameters."""
+        return f"postgresql+{driver}://{user}:{password}@{host}:{port}/{database}"
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+        """
+        if self.override_relevance_score_fn is not None:
+            return self.override_relevance_score_fn
+
+        # Default strategy is to rely on distance strategy provided
+        # in vectorstore constructor
+        if self._distance_strategy == DistanceStrategy.COSINE:
+            return self._cosine_relevance_score_fn
+        elif self._distance_strategy == DistanceStrategy.EUCLIDEAN:
+            return self._euclidean_relevance_score_fn
+        elif self._distance_strategy == DistanceStrategy.MAX_INNER_PRODUCT:
+            return self._max_inner_product_relevance_score_fn
+        else:
+            raise ValueError(
+                "No supported normalization function"
+                f" for distance_strategy of {self._distance_strategy}."
+                "Consider providing relevance_score_fn to PGVector constructor."
+            )
+
+    def max_marginal_relevance_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs selected using the maximal marginal relevance with score
+            to embedding vector.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Tuple[Document, float]]: List of Documents selected by maximal marginal
+                relevance to the query and score for each.
+        """
+        results = self.__query_collection(embedding=embedding, k=fetch_k, filter=filter)
+
+        embedding_list = [result.EmbeddingStore.embedding for result in results]
+
+        mmr_selected = maximal_marginal_relevance(
+            np.array(embedding, dtype=np.float32),
+            embedding_list,
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+
+        candidates = self._results_to_docs_and_scores(results)
+
+        return [r for i, r in enumerate(candidates) if i in mmr_selected]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            query (str): Text to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Document]: List of Documents selected by maximal marginal relevance.
+        """
+        embedding = self.embedding_function.embed_query(query)
+        return self.max_marginal_relevance_search_by_vector(
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+
+    def max_marginal_relevance_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs selected using the maximal marginal relevance with score.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            query (str): Text to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Tuple[Document, float]]: List of Documents selected by maximal marginal
+                relevance to the query and score for each.
+        """
+        embedding = self.embedding_function.embed_query(query)
+        docs = self.max_marginal_relevance_search_with_score_by_vector(
+            embedding=embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+        return docs
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance
+            to embedding vector.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            embedding (str): Text to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+                Defaults to 20.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Document]: List of Documents selected by maximal marginal relevance.
+        """
+        docs_and_scores = self.max_marginal_relevance_search_with_score_by_vector(
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+
+        return _results_to_docs(docs_and_scores)
+
+    async def amax_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance."""
+
+        # This is a temporary workaround to make the similarity search
+        # asynchronous. The proper solution is to make the similarity search
+        # asynchronous in the vector store implementations.
+        return await run_in_executor(
+            None,
+            self.max_marginal_relevance_search_by_vector,
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/pinecone.py b/llm/Lib/site-packages/langchain_community/vectorstores/pinecone.py
new file mode 100644
index 0000000000000000000000000000000000000000..a2a92d68f32ab62e7d16bf4d71181ab37120c9ab
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/pinecone.py
@@ -0,0 +1,488 @@
+from __future__ import annotations
+
+import logging
+import os
+import uuid
+import warnings
+from typing import TYPE_CHECKING, Any, Callable, Iterable, List, Optional, Tuple, Union
+
+import numpy as np
+from langchain_core._api.deprecation import deprecated
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils.iter import batch_iterate
+from langchain_core.vectorstores import VectorStore
+from packaging import version
+
+from langchain_community.vectorstores.utils import (
+    DistanceStrategy,
+    maximal_marginal_relevance,
+)
+
+if TYPE_CHECKING:
+    from pinecone import Index
+
+logger = logging.getLogger(__name__)
+
+
+def _import_pinecone() -> Any:
+    try:
+        import pinecone
+    except ImportError as e:
+        raise ImportError(
+            "Could not import pinecone python package. "
+            "Please install it with `pip install pinecone-client`."
+        ) from e
+    return pinecone
+
+
+def _is_pinecone_v3() -> bool:
+    pinecone = _import_pinecone()
+    pinecone_client_version = pinecone.__version__
+    return version.parse(pinecone_client_version) >= version.parse("3.0.0.dev")
+
+
+@deprecated(
+    since="0.0.18", removal="0.2.0", alternative_import="langchain_pinecone.Pinecone"
+)
+class Pinecone(VectorStore):
+    """`Pinecone` vector store.
+
+    To use, you should have the ``pinecone-client`` python package installed.
+
+    This version of Pinecone is deprecated. Please use `langchain_pinecone.Pinecone`
+    instead.
+    """
+
+    def __init__(
+        self,
+        index: Any,
+        embedding: Union[Embeddings, Callable],
+        text_key: str,
+        namespace: Optional[str] = None,
+        distance_strategy: Optional[DistanceStrategy] = DistanceStrategy.COSINE,
+    ):
+        """Initialize with Pinecone client."""
+        pinecone = _import_pinecone()
+        if not isinstance(embedding, Embeddings):
+            warnings.warn(
+                "Passing in `embedding` as a Callable is deprecated. Please pass in an"
+                " Embeddings object instead."
+            )
+        if not isinstance(index, pinecone.Index):
+            raise ValueError(
+                f"client should be an instance of pinecone.Index, " f"got {type(index)}"
+            )
+        self._index = index
+        self._embedding = embedding
+        self._text_key = text_key
+        self._namespace = namespace
+        self.distance_strategy = distance_strategy
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        """Access the query embedding object if available."""
+        if isinstance(self._embedding, Embeddings):
+            return self._embedding
+        return None
+
+    def _embed_documents(self, texts: Iterable[str]) -> List[List[float]]:
+        """Embed search docs."""
+        if isinstance(self._embedding, Embeddings):
+            return self._embedding.embed_documents(list(texts))
+        return [self._embedding(t) for t in texts]
+
+    def _embed_query(self, text: str) -> List[float]:
+        """Embed query text."""
+        if isinstance(self._embedding, Embeddings):
+            return self._embedding.embed_query(text)
+        return self._embedding(text)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        namespace: Optional[str] = None,
+        batch_size: int = 32,
+        embedding_chunk_size: int = 1000,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Upsert optimization is done by chunking the embeddings and upserting them.
+        This is done to avoid memory issues and optimize using HTTP based embeddings.
+        For OpenAI embeddings, use pool_threads>4 when constructing the pinecone.Index,
+        embedding_chunk_size>1000 and batch_size~64 for best performance.
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of ids to associate with the texts.
+            namespace: Optional pinecone namespace to add the texts to.
+            batch_size: Batch size to use when adding the texts to the vectorstore.
+            embedding_chunk_size: Chunk size to use when embedding the texts.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+
+        """
+        if namespace is None:
+            namespace = self._namespace
+
+        texts = list(texts)
+        ids = ids or [str(uuid.uuid4()) for _ in texts]
+        metadatas = metadatas or [{} for _ in texts]
+        for metadata, text in zip(metadatas, texts):
+            metadata[self._text_key] = text
+
+        # For loops to avoid memory issues and optimize when using HTTP based embeddings
+        # The first loop runs the embeddings, it benefits when using OpenAI embeddings
+        # The second loops runs the pinecone upsert asynchronously.
+        for i in range(0, len(texts), embedding_chunk_size):
+            chunk_texts = texts[i : i + embedding_chunk_size]
+            chunk_ids = ids[i : i + embedding_chunk_size]
+            chunk_metadatas = metadatas[i : i + embedding_chunk_size]
+            embeddings = self._embed_documents(chunk_texts)
+            async_res = [
+                self._index.upsert(
+                    vectors=batch,
+                    namespace=namespace,
+                    async_req=True,
+                    **kwargs,
+                )
+                for batch in batch_iterate(
+                    batch_size, zip(chunk_ids, embeddings, chunk_metadatas)
+                )
+            ]
+            [res.get() for res in async_res]
+
+        return ids
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+        namespace: Optional[str] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return pinecone documents most similar to query, along with scores.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Dictionary of argument(s) to filter on metadata
+            namespace: Namespace to search in. Default will search in '' namespace.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        return self.similarity_search_by_vector_with_score(
+            self._embed_query(query), k=k, filter=filter, namespace=namespace
+        )
+
+    def similarity_search_by_vector_with_score(
+        self,
+        embedding: List[float],
+        *,
+        k: int = 4,
+        filter: Optional[dict] = None,
+        namespace: Optional[str] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Return pinecone documents most similar to embedding, along with scores."""
+
+        if namespace is None:
+            namespace = self._namespace
+        docs = []
+        results = self._index.query(
+            vector=[embedding],
+            top_k=k,
+            include_metadata=True,
+            namespace=namespace,
+            filter=filter,
+        )
+        for res in results["matches"]:
+            metadata = res["metadata"]
+            if self._text_key in metadata:
+                text = metadata.pop(self._text_key)
+                score = res["score"]
+                docs.append((Document(page_content=text, metadata=metadata), score))
+            else:
+                logger.warning(
+                    f"Found document with no `{self._text_key}` key. Skipping."
+                )
+        return docs
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+        namespace: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return pinecone documents most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Dictionary of argument(s) to filter on metadata
+            namespace: Namespace to search in. Default will search in '' namespace.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query, k=k, filter=filter, namespace=namespace, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+        """
+
+        if self.distance_strategy == DistanceStrategy.COSINE:
+            return self._cosine_relevance_score_fn
+        elif self.distance_strategy == DistanceStrategy.MAX_INNER_PRODUCT:
+            return self._max_inner_product_relevance_score_fn
+        elif self.distance_strategy == DistanceStrategy.EUCLIDEAN_DISTANCE:
+            return self._euclidean_relevance_score_fn
+        else:
+            raise ValueError(
+                "Unknown distance strategy, must be cosine, max_inner_product "
+                "(dot product), or euclidean"
+            )
+
+    @staticmethod
+    def _cosine_relevance_score_fn(score: float) -> float:
+        """Pinecone returns cosine similarity scores between [-1,1]"""
+        return (score + 1) / 2
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[dict] = None,
+        namespace: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        if namespace is None:
+            namespace = self._namespace
+        results = self._index.query(
+            vector=[embedding],
+            top_k=fetch_k,
+            include_values=True,
+            include_metadata=True,
+            namespace=namespace,
+            filter=filter,
+        )
+        mmr_selected = maximal_marginal_relevance(
+            np.array([embedding], dtype=np.float32),
+            [item["values"] for item in results["matches"]],
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+        selected = [results["matches"][i]["metadata"] for i in mmr_selected]
+        return [
+            Document(page_content=metadata.pop((self._text_key)), metadata=metadata)
+            for metadata in selected
+        ]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[dict] = None,
+        namespace: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        embedding = self._embed_query(query)
+        return self.max_marginal_relevance_search_by_vector(
+            embedding, k, fetch_k, lambda_mult, filter, namespace
+        )
+
+    @classmethod
+    def get_pinecone_index(
+        cls,
+        index_name: Optional[str],
+        pool_threads: int = 4,
+    ) -> Index:
+        """Return a Pinecone Index instance.
+
+        Args:
+            index_name: Name of the index to use.
+            pool_threads: Number of threads to use for index upsert.
+        Returns:
+            Pinecone Index instance."""
+
+        pinecone = _import_pinecone()
+
+        if _is_pinecone_v3():
+            pinecone_instance = pinecone.Pinecone(
+                api_key=os.environ.get("PINECONE_API_KEY"), pool_threads=pool_threads
+            )
+            indexes = pinecone_instance.list_indexes()
+            index_names = [i.name for i in indexes.index_list["indexes"]]
+        else:
+            index_names = pinecone.list_indexes()
+
+        if index_name in index_names:
+            index = (
+                pinecone_instance.Index(index_name)
+                if _is_pinecone_v3()
+                else pinecone.Index(index_name, pool_threads=pool_threads)
+            )
+        elif len(index_names) == 0:
+            raise ValueError(
+                "No active indexes found in your Pinecone project, "
+                "are you sure you're using the right Pinecone API key and Environment? "
+                "Please double check your Pinecone dashboard."
+            )
+        else:
+            raise ValueError(
+                f"Index '{index_name}' not found in your Pinecone project. "
+                f"Did you mean one of the following indexes: {', '.join(index_names)}"
+            )
+        return index
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        batch_size: int = 32,
+        text_key: str = "text",
+        namespace: Optional[str] = None,
+        index_name: Optional[str] = None,
+        upsert_kwargs: Optional[dict] = None,
+        pool_threads: int = 4,
+        embeddings_chunk_size: int = 1000,
+        **kwargs: Any,
+    ) -> Pinecone:
+        """
+        DEPRECATED: use langchain_pinecone.PineconeVectorStore.from_texts instead:
+        Construct Pinecone wrapper from raw documents.
+
+        This is a user friendly interface that:
+            1. Embeds documents.
+            2. Adds the documents to a provided Pinecone index
+
+        This is intended to be a quick way to get started.
+
+        The `pool_threads` affects the speed of the upsert operations.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_pinecone import PineconeVectorStore
+                from langchain_openai import OpenAIEmbeddings
+
+                embeddings = OpenAIEmbeddings()
+                index_name = "my-index"
+                namespace = "my-namespace"
+                vectorstore = Pinecone(
+                    index_name=index_name,
+                    embedding=embedding,
+                    namespace=namespace,
+                )
+        """
+        pinecone_index = cls.get_pinecone_index(index_name, pool_threads)
+        pinecone = cls(pinecone_index, embedding, text_key, namespace, **kwargs)
+
+        pinecone.add_texts(
+            texts,
+            metadatas=metadatas,
+            ids=ids,
+            namespace=namespace,
+            batch_size=batch_size,
+            embedding_chunk_size=embeddings_chunk_size,
+            **(upsert_kwargs or {}),
+        )
+        return pinecone
+
+    @classmethod
+    def from_existing_index(
+        cls,
+        index_name: str,
+        embedding: Embeddings,
+        text_key: str = "text",
+        namespace: Optional[str] = None,
+        pool_threads: int = 4,
+    ) -> Pinecone:
+        """Load pinecone vectorstore from index name."""
+        pinecone_index = cls.get_pinecone_index(index_name, pool_threads)
+        return cls(pinecone_index, embedding, text_key, namespace)
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        delete_all: Optional[bool] = None,
+        namespace: Optional[str] = None,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Delete by vector IDs or filter.
+        Args:
+            ids: List of ids to delete.
+            filter: Dictionary of conditions to filter vectors to delete.
+        """
+
+        if namespace is None:
+            namespace = self._namespace
+
+        if delete_all:
+            self._index.delete(delete_all=True, namespace=namespace, **kwargs)
+        elif ids is not None:
+            chunk_size = 1000
+            for i in range(0, len(ids), chunk_size):
+                chunk = ids[i : i + chunk_size]
+                self._index.delete(ids=chunk, namespace=namespace, **kwargs)
+        elif filter is not None:
+            self._index.delete(filter=filter, namespace=namespace, **kwargs)
+        else:
+            raise ValueError("Either ids, delete_all, or filter must be provided.")
+
+        return None
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/qdrant.py b/llm/Lib/site-packages/langchain_community/vectorstores/qdrant.py
new file mode 100644
index 0000000000000000000000000000000000000000..d42c968689dac9a403e2dc86f54299e6c57cd378
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/qdrant.py
@@ -0,0 +1,2236 @@
+from __future__ import annotations
+
+import functools
+import uuid
+import warnings
+from itertools import islice
+from operator import itemgetter
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncGenerator,
+    Callable,
+    Dict,
+    Generator,
+    Iterable,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+)
+
+import numpy as np
+from langchain_core.embeddings import Embeddings
+from langchain_core.runnables.config import run_in_executor
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.docstore.document import Document
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+if TYPE_CHECKING:
+    from qdrant_client import grpc  # noqa
+    from qdrant_client.conversions import common_types
+    from qdrant_client.http import models as rest
+
+    DictFilter = Dict[str, Union[str, int, bool, dict, list]]
+    MetadataFilter = Union[DictFilter, common_types.Filter]
+
+
+class QdrantException(Exception):
+    """`Qdrant` related exceptions."""
+
+
+def sync_call_fallback(method: Callable) -> Callable:
+    """
+    Decorator to call the synchronous method of the class if the async method is not
+    implemented. This decorator might be only used for the methods that are defined
+    as async in the class.
+    """
+
+    @functools.wraps(method)
+    async def wrapper(self: Any, *args: Any, **kwargs: Any) -> Any:
+        try:
+            return await method(self, *args, **kwargs)
+        except NotImplementedError:
+            # If the async method is not implemented, call the synchronous method
+            # by removing the first letter from the method name. For example,
+            # if the async method is called ``aaad_texts``, the synchronous method
+            # will be called ``aad_texts``.
+            return await run_in_executor(
+                None, getattr(self, method.__name__[1:]), *args, **kwargs
+            )
+
+    return wrapper
+
+
+class Qdrant(VectorStore):
+    """`Qdrant` vector store.
+
+    To use you should have the ``qdrant-client`` package installed.
+
+    Example:
+        .. code-block:: python
+
+            from qdrant_client import QdrantClient
+            from langchain_community.vectorstores import Qdrant
+
+            client = QdrantClient()
+            collection_name = "MyCollection"
+            qdrant = Qdrant(client, collection_name, embedding_function)
+    """
+
+    CONTENT_KEY = "page_content"
+    METADATA_KEY = "metadata"
+    VECTOR_NAME = None
+
+    def __init__(
+        self,
+        client: Any,
+        collection_name: str,
+        embeddings: Optional[Embeddings] = None,
+        content_payload_key: str = CONTENT_KEY,
+        metadata_payload_key: str = METADATA_KEY,
+        distance_strategy: str = "COSINE",
+        vector_name: Optional[str] = VECTOR_NAME,
+        async_client: Optional[Any] = None,
+        embedding_function: Optional[Callable] = None,  # deprecated
+    ):
+        """Initialize with necessary components."""
+        try:
+            import qdrant_client
+        except ImportError:
+            raise ImportError(
+                "Could not import qdrant-client python package. "
+                "Please install it with `pip install qdrant-client`."
+            )
+
+        if not isinstance(client, qdrant_client.QdrantClient):
+            raise ValueError(
+                f"client should be an instance of qdrant_client.QdrantClient, "
+                f"got {type(client)}"
+            )
+
+        if async_client is not None and not isinstance(
+            async_client, qdrant_client.AsyncQdrantClient
+        ):
+            raise ValueError(
+                f"async_client should be an instance of qdrant_client.AsyncQdrantClient"
+                f"got {type(async_client)}"
+            )
+
+        if embeddings is None and embedding_function is None:
+            raise ValueError(
+                "`embeddings` value can't be None. Pass `Embeddings` instance."
+            )
+
+        if embeddings is not None and embedding_function is not None:
+            raise ValueError(
+                "Both `embeddings` and `embedding_function` are passed. "
+                "Use `embeddings` only."
+            )
+
+        self._embeddings = embeddings
+        self._embeddings_function = embedding_function
+        self.client: qdrant_client.QdrantClient = client
+        self.async_client: Optional[qdrant_client.AsyncQdrantClient] = async_client
+        self.collection_name = collection_name
+        self.content_payload_key = content_payload_key or self.CONTENT_KEY
+        self.metadata_payload_key = metadata_payload_key or self.METADATA_KEY
+        self.vector_name = vector_name or self.VECTOR_NAME
+
+        if embedding_function is not None:
+            warnings.warn(
+                "Using `embedding_function` is deprecated. "
+                "Pass `Embeddings` instance to `embeddings` instead."
+            )
+
+        if not isinstance(embeddings, Embeddings):
+            warnings.warn(
+                "`embeddings` should be an instance of `Embeddings`."
+                "Using `embeddings` as `embedding_function` which is deprecated"
+            )
+            self._embeddings_function = embeddings
+            self._embeddings = None
+
+        self.distance_strategy = distance_strategy.upper()
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self._embeddings
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[Sequence[str]] = None,
+        batch_size: int = 64,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids:
+                Optional list of ids to associate with the texts. Ids have to be
+                uuid-like strings.
+            batch_size:
+                How many vectors upload per-request.
+                Default: 64
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        added_ids = []
+        for batch_ids, points in self._generate_rest_batches(
+            texts, metadatas, ids, batch_size
+        ):
+            self.client.upsert(
+                collection_name=self.collection_name, points=points, **kwargs
+            )
+            added_ids.extend(batch_ids)
+
+        return added_ids
+
+    @sync_call_fallback
+    async def aadd_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[Sequence[str]] = None,
+        batch_size: int = 64,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids:
+                Optional list of ids to associate with the texts. Ids have to be
+                uuid-like strings.
+            batch_size:
+                How many vectors upload per-request.
+                Default: 64
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        from qdrant_client.local.async_qdrant_local import AsyncQdrantLocal
+
+        if self.async_client is None or isinstance(
+            self.async_client._client, AsyncQdrantLocal
+        ):
+            raise NotImplementedError(
+                "QdrantLocal cannot interoperate with sync and async clients"
+            )
+
+        added_ids = []
+        async for batch_ids, points in self._agenerate_rest_batches(
+            texts, metadatas, ids, batch_size
+        ):
+            await self.async_client.upsert(
+                collection_name=self.collection_name, points=points, **kwargs
+            )
+            added_ids.extend(batch_ids)
+
+        return added_ids
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[MetadataFilter] = None,
+        search_params: Optional[common_types.SearchParams] = None,
+        offset: int = 0,
+        score_threshold: Optional[float] = None,
+        consistency: Optional[common_types.ReadConsistency] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter by metadata. Defaults to None.
+            search_params: Additional search params
+            offset:
+                Offset of the first result to return.
+                May be used to paginate results.
+                Note: large offset values may cause performance issues.
+            score_threshold:
+                Define a minimal score threshold for the result.
+                If defined, less similar results will not be returned.
+                Score of the returned result might be higher or smaller than the
+                threshold depending on the Distance function used.
+                E.g. for cosine similarity only higher scores will be returned.
+            consistency:
+                Read consistency of the search. Defines how many replicas should be
+                queried before returning the result.
+                Values:
+                - int - number of replicas to query, values should present in all
+                        queried replicas
+                - 'majority' - query all replicas, but return values present in the
+                               majority of replicas
+                - 'quorum' - query the majority of replicas, return values present in
+                             all of them
+                - 'all' - query all replicas, and return values present in all replicas
+            **kwargs:
+                Any other named arguments to pass through to QdrantClient.search()
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        results = self.similarity_search_with_score(
+            query,
+            k,
+            filter=filter,
+            search_params=search_params,
+            offset=offset,
+            score_threshold=score_threshold,
+            consistency=consistency,
+            **kwargs,
+        )
+        return list(map(itemgetter(0), results))
+
+    @sync_call_fallback
+    async def asimilarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[MetadataFilter] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query.
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter by metadata. Defaults to None.
+        Returns:
+            List of Documents most similar to the query.
+        """
+        results = await self.asimilarity_search_with_score(query, k, filter, **kwargs)
+        return list(map(itemgetter(0), results))
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[MetadataFilter] = None,
+        search_params: Optional[common_types.SearchParams] = None,
+        offset: int = 0,
+        score_threshold: Optional[float] = None,
+        consistency: Optional[common_types.ReadConsistency] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter by metadata. Defaults to None.
+            search_params: Additional search params
+            offset:
+                Offset of the first result to return.
+                May be used to paginate results.
+                Note: large offset values may cause performance issues.
+            score_threshold:
+                Define a minimal score threshold for the result.
+                If defined, less similar results will not be returned.
+                Score of the returned result might be higher or smaller than the
+                threshold depending on the Distance function used.
+                E.g. for cosine similarity only higher scores will be returned.
+            consistency:
+                Read consistency of the search. Defines how many replicas should be
+                queried before returning the result.
+                Values:
+                - int - number of replicas to query, values should present in all
+                        queried replicas
+                - 'majority' - query all replicas, but return values present in the
+                               majority of replicas
+                - 'quorum' - query the majority of replicas, return values present in
+                             all of them
+                - 'all' - query all replicas, and return values present in all replicas
+            **kwargs:
+                Any other named arguments to pass through to QdrantClient.search()
+
+        Returns:
+            List of documents most similar to the query text and distance for each.
+        """
+        return self.similarity_search_with_score_by_vector(
+            self._embed_query(query),
+            k,
+            filter=filter,
+            search_params=search_params,
+            offset=offset,
+            score_threshold=score_threshold,
+            consistency=consistency,
+            **kwargs,
+        )
+
+    @sync_call_fallback
+    async def asimilarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[MetadataFilter] = None,
+        search_params: Optional[common_types.SearchParams] = None,
+        offset: int = 0,
+        score_threshold: Optional[float] = None,
+        consistency: Optional[common_types.ReadConsistency] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter by metadata. Defaults to None.
+            search_params: Additional search params
+            offset:
+                Offset of the first result to return.
+                May be used to paginate results.
+                Note: large offset values may cause performance issues.
+            score_threshold:
+                Define a minimal score threshold for the result.
+                If defined, less similar results will not be returned.
+                Score of the returned result might be higher or smaller than the
+                threshold depending on the Distance function used.
+                E.g. for cosine similarity only higher scores will be returned.
+            consistency:
+                Read consistency of the search. Defines how many replicas should be
+                queried before returning the result.
+                Values:
+                - int - number of replicas to query, values should present in all
+                        queried replicas
+                - 'majority' - query all replicas, but return values present in the
+                               majority of replicas
+                - 'quorum' - query the majority of replicas, return values present in
+                             all of them
+                - 'all' - query all replicas, and return values present in all replicas
+            **kwargs:
+                Any other named arguments to pass through to
+                AsyncQdrantClient.Search().
+
+        Returns:
+            List of documents most similar to the query text and distance for each.
+        """
+        query_embedding = await self._aembed_query(query)
+        return await self.asimilarity_search_with_score_by_vector(
+            query_embedding,
+            k,
+            filter=filter,
+            search_params=search_params,
+            offset=offset,
+            score_threshold=score_threshold,
+            consistency=consistency,
+            **kwargs,
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[MetadataFilter] = None,
+        search_params: Optional[common_types.SearchParams] = None,
+        offset: int = 0,
+        score_threshold: Optional[float] = None,
+        consistency: Optional[common_types.ReadConsistency] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding vector to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter by metadata. Defaults to None.
+            search_params: Additional search params
+            offset:
+                Offset of the first result to return.
+                May be used to paginate results.
+                Note: large offset values may cause performance issues.
+            score_threshold:
+                Define a minimal score threshold for the result.
+                If defined, less similar results will not be returned.
+                Score of the returned result might be higher or smaller than the
+                threshold depending on the Distance function used.
+                E.g. for cosine similarity only higher scores will be returned.
+            consistency:
+                Read consistency of the search. Defines how many replicas should be
+                queried before returning the result.
+                Values:
+                - int - number of replicas to query, values should present in all
+                        queried replicas
+                - 'majority' - query all replicas, but return values present in the
+                               majority of replicas
+                - 'quorum' - query the majority of replicas, return values present in
+                             all of them
+                - 'all' - query all replicas, and return values present in all replicas
+            **kwargs:
+                Any other named arguments to pass through to QdrantClient.search()
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        results = self.similarity_search_with_score_by_vector(
+            embedding,
+            k,
+            filter=filter,
+            search_params=search_params,
+            offset=offset,
+            score_threshold=score_threshold,
+            consistency=consistency,
+            **kwargs,
+        )
+        return list(map(itemgetter(0), results))
+
+    @sync_call_fallback
+    async def asimilarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[MetadataFilter] = None,
+        search_params: Optional[common_types.SearchParams] = None,
+        offset: int = 0,
+        score_threshold: Optional[float] = None,
+        consistency: Optional[common_types.ReadConsistency] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding vector to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter by metadata. Defaults to None.
+            search_params: Additional search params
+            offset:
+                Offset of the first result to return.
+                May be used to paginate results.
+                Note: large offset values may cause performance issues.
+            score_threshold:
+                Define a minimal score threshold for the result.
+                If defined, less similar results will not be returned.
+                Score of the returned result might be higher or smaller than the
+                threshold depending on the Distance function used.
+                E.g. for cosine similarity only higher scores will be returned.
+            consistency:
+                Read consistency of the search. Defines how many replicas should be
+                queried before returning the result.
+                Values:
+                - int - number of replicas to query, values should present in all
+                        queried replicas
+                - 'majority' - query all replicas, but return values present in the
+                               majority of replicas
+                - 'quorum' - query the majority of replicas, return values present in
+                             all of them
+                - 'all' - query all replicas, and return values present in all replicas
+            **kwargs:
+                Any other named arguments to pass through to
+                AsyncQdrantClient.Search().
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        results = await self.asimilarity_search_with_score_by_vector(
+            embedding,
+            k,
+            filter=filter,
+            search_params=search_params,
+            offset=offset,
+            score_threshold=score_threshold,
+            consistency=consistency,
+            **kwargs,
+        )
+        return list(map(itemgetter(0), results))
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[MetadataFilter] = None,
+        search_params: Optional[common_types.SearchParams] = None,
+        offset: int = 0,
+        score_threshold: Optional[float] = None,
+        consistency: Optional[common_types.ReadConsistency] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding vector to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter by metadata. Defaults to None.
+            search_params: Additional search params
+            offset:
+                Offset of the first result to return.
+                May be used to paginate results.
+                Note: large offset values may cause performance issues.
+            score_threshold:
+                Define a minimal score threshold for the result.
+                If defined, less similar results will not be returned.
+                Score of the returned result might be higher or smaller than the
+                threshold depending on the Distance function used.
+                E.g. for cosine similarity only higher scores will be returned.
+            consistency:
+                Read consistency of the search. Defines how many replicas should be
+                queried before returning the result.
+                Values:
+                - int - number of replicas to query, values should present in all
+                        queried replicas
+                - 'majority' - query all replicas, but return values present in the
+                               majority of replicas
+                - 'quorum' - query the majority of replicas, return values present in
+                             all of them
+                - 'all' - query all replicas, and return values present in all replicas
+            **kwargs:
+                Any other named arguments to pass through to QdrantClient.search()
+
+        Returns:
+            List of documents most similar to the query text and distance for each.
+        """
+        if filter is not None and isinstance(filter, dict):
+            warnings.warn(
+                "Using dict as a `filter` is deprecated. Please use qdrant-client "
+                "filters directly: "
+                "https://qdrant.tech/documentation/concepts/filtering/",
+                DeprecationWarning,
+            )
+            qdrant_filter = self._qdrant_filter_from_dict(filter)
+        else:
+            qdrant_filter = filter
+
+        query_vector = embedding
+        if self.vector_name is not None:
+            query_vector = (self.vector_name, embedding)  # type: ignore[assignment]
+
+        results = self.client.search(
+            collection_name=self.collection_name,
+            query_vector=query_vector,
+            query_filter=qdrant_filter,
+            search_params=search_params,
+            limit=k,
+            offset=offset,
+            with_payload=True,
+            with_vectors=False,  # Langchain does not expect vectors to be returned
+            score_threshold=score_threshold,
+            consistency=consistency,
+            **kwargs,
+        )
+        return [
+            (
+                self._document_from_scored_point(
+                    result,
+                    self.collection_name,
+                    self.content_payload_key,
+                    self.metadata_payload_key,
+                ),
+                result.score,
+            )
+            for result in results
+        ]
+
+    @sync_call_fallback
+    async def asimilarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[MetadataFilter] = None,
+        search_params: Optional[common_types.SearchParams] = None,
+        offset: int = 0,
+        score_threshold: Optional[float] = None,
+        consistency: Optional[common_types.ReadConsistency] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding vector to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter by metadata. Defaults to None.
+            search_params: Additional search params
+            offset:
+                Offset of the first result to return.
+                May be used to paginate results.
+                Note: large offset values may cause performance issues.
+            score_threshold:
+                Define a minimal score threshold for the result.
+                If defined, less similar results will not be returned.
+                Score of the returned result might be higher or smaller than the
+                threshold depending on the Distance function used.
+                E.g. for cosine similarity only higher scores will be returned.
+            consistency:
+                Read consistency of the search. Defines how many replicas should be
+                queried before returning the result.
+                Values:
+                - int - number of replicas to query, values should present in all
+                        queried replicas
+                - 'majority' - query all replicas, but return values present in the
+                               majority of replicas
+                - 'quorum' - query the majority of replicas, return values present in
+                             all of them
+                - 'all' - query all replicas, and return values present in all replicas
+            **kwargs:
+                Any other named arguments to pass through to
+                AsyncQdrantClient.Search().
+
+        Returns:
+            List of documents most similar to the query text and distance for each.
+        """
+        from qdrant_client.local.async_qdrant_local import AsyncQdrantLocal
+
+        if self.async_client is None or isinstance(
+            self.async_client._client, AsyncQdrantLocal
+        ):
+            raise NotImplementedError(
+                "QdrantLocal cannot interoperate with sync and async clients"
+            )
+        if filter is not None and isinstance(filter, dict):
+            warnings.warn(
+                "Using dict as a `filter` is deprecated. Please use qdrant-client "
+                "filters directly: "
+                "https://qdrant.tech/documentation/concepts/filtering/",
+                DeprecationWarning,
+            )
+            qdrant_filter = self._qdrant_filter_from_dict(filter)
+        else:
+            qdrant_filter = filter
+
+        query_vector = embedding
+        if self.vector_name is not None:
+            query_vector = (self.vector_name, embedding)  # type: ignore[assignment]
+
+        results = await self.async_client.search(
+            collection_name=self.collection_name,
+            query_vector=query_vector,
+            query_filter=qdrant_filter,
+            search_params=search_params,
+            limit=k,
+            offset=offset,
+            with_payload=True,
+            with_vectors=False,  # Langchain does not expect vectors to be returned
+            score_threshold=score_threshold,
+            consistency=consistency,
+            **kwargs,
+        )
+        return [
+            (
+                self._document_from_scored_point(
+                    result,
+                    self.collection_name,
+                    self.content_payload_key,
+                    self.metadata_payload_key,
+                ),
+                result.score,
+            )
+            for result in results
+        ]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[MetadataFilter] = None,
+        search_params: Optional[common_types.SearchParams] = None,
+        score_threshold: Optional[float] = None,
+        consistency: Optional[common_types.ReadConsistency] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+                     Defaults to 20.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter: Filter by metadata. Defaults to None.
+            search_params: Additional search params
+            score_threshold:
+                Define a minimal score threshold for the result.
+                If defined, less similar results will not be returned.
+                Score of the returned result might be higher or smaller than the
+                threshold depending on the Distance function used.
+                E.g. for cosine similarity only higher scores will be returned.
+            consistency:
+                Read consistency of the search. Defines how many replicas should be
+                queried before returning the result.
+                Values:
+                - int - number of replicas to query, values should present in all
+                        queried replicas
+                - 'majority' - query all replicas, but return values present in the
+                               majority of replicas
+                - 'quorum' - query the majority of replicas, return values present in
+                             all of them
+                - 'all' - query all replicas, and return values present in all replicas
+            **kwargs:
+                Any other named arguments to pass through to QdrantClient.search()
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        query_embedding = self._embed_query(query)
+        return self.max_marginal_relevance_search_by_vector(
+            query_embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            search_params=search_params,
+            score_threshold=score_threshold,
+            consistency=consistency,
+            **kwargs,
+        )
+
+    @sync_call_fallback
+    async def amax_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[MetadataFilter] = None,
+        search_params: Optional[common_types.SearchParams] = None,
+        score_threshold: Optional[float] = None,
+        consistency: Optional[common_types.ReadConsistency] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+                     Defaults to 20.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter: Filter by metadata. Defaults to None.
+            search_params: Additional search params
+            score_threshold:
+                Define a minimal score threshold for the result.
+                If defined, less similar results will not be returned.
+                Score of the returned result might be higher or smaller than the
+                threshold depending on the Distance function used.
+                E.g. for cosine similarity only higher scores will be returned.
+            consistency:
+                Read consistency of the search. Defines how many replicas should be
+                queried before returning the result.
+                Values:
+                - int - number of replicas to query, values should present in all
+                        queried replicas
+                - 'majority' - query all replicas, but return values present in the
+                               majority of replicas
+                - 'quorum' - query the majority of replicas, return values present in
+                             all of them
+                - 'all' - query all replicas, and return values present in all replicas
+            **kwargs:
+                Any other named arguments to pass through to
+                AsyncQdrantClient.Search().
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        query_embedding = await self._aembed_query(query)
+        return await self.amax_marginal_relevance_search_by_vector(
+            query_embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            search_params=search_params,
+            score_threshold=score_threshold,
+            consistency=consistency,
+            **kwargs,
+        )
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[MetadataFilter] = None,
+        search_params: Optional[common_types.SearchParams] = None,
+        score_threshold: Optional[float] = None,
+        consistency: Optional[common_types.ReadConsistency] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter: Filter by metadata. Defaults to None.
+            search_params: Additional search params
+            score_threshold:
+                Define a minimal score threshold for the result.
+                If defined, less similar results will not be returned.
+                Score of the returned result might be higher or smaller than the
+                threshold depending on the Distance function used.
+                E.g. for cosine similarity only higher scores will be returned.
+            consistency:
+                Read consistency of the search. Defines how many replicas should be
+                queried before returning the result.
+                Values:
+                - int - number of replicas to query, values should present in all
+                        queried replicas
+                - 'majority' - query all replicas, but return values present in the
+                               majority of replicas
+                - 'quorum' - query the majority of replicas, return values present in
+                             all of them
+                - 'all' - query all replicas, and return values present in all replicas
+            **kwargs:
+                Any other named arguments to pass through to QdrantClient.search()
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        results = self.max_marginal_relevance_search_with_score_by_vector(
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            search_params=search_params,
+            score_threshold=score_threshold,
+            consistency=consistency,
+            **kwargs,
+        )
+        return list(map(itemgetter(0), results))
+
+    @sync_call_fallback
+    async def amax_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[MetadataFilter] = None,
+        search_params: Optional[common_types.SearchParams] = None,
+        score_threshold: Optional[float] = None,
+        consistency: Optional[common_types.ReadConsistency] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+                     Defaults to 20.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter: Filter by metadata. Defaults to None.
+            search_params: Additional search params
+            score_threshold:
+                Define a minimal score threshold for the result.
+                If defined, less similar results will not be returned.
+                Score of the returned result might be higher or smaller than the
+                threshold depending on the Distance function used.
+                E.g. for cosine similarity only higher scores will be returned.
+            consistency:
+                Read consistency of the search. Defines how many replicas should be
+                queried before returning the result.
+                Values:
+                - int - number of replicas to query, values should present in all
+                        queried replicas
+                - 'majority' - query all replicas, but return values present in the
+                               majority of replicas
+                - 'quorum' - query the majority of replicas, return values present in
+                             all of them
+                - 'all' - query all replicas, and return values present in all replicas
+            **kwargs:
+                Any other named arguments to pass through to
+                AsyncQdrantClient.Search().
+        Returns:
+            List of Documents selected by maximal marginal relevance and distance for
+            each.
+        """
+        results = await self.amax_marginal_relevance_search_with_score_by_vector(
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            search_params=search_params,
+            score_threshold=score_threshold,
+            consistency=consistency,
+            **kwargs,
+        )
+        return list(map(itemgetter(0), results))
+
+    def max_marginal_relevance_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[MetadataFilter] = None,
+        search_params: Optional[common_types.SearchParams] = None,
+        score_threshold: Optional[float] = None,
+        consistency: Optional[common_types.ReadConsistency] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+                     Defaults to 20.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter: Filter by metadata. Defaults to None.
+            search_params: Additional search params
+            score_threshold:
+                Define a minimal score threshold for the result.
+                If defined, less similar results will not be returned.
+                Score of the returned result might be higher or smaller than the
+                threshold depending on the Distance function used.
+                E.g. for cosine similarity only higher scores will be returned.
+            consistency:
+                Read consistency of the search. Defines how many replicas should be
+                queried before returning the result.
+                Values:
+                - int - number of replicas to query, values should present in all
+                        queried replicas
+                - 'majority' - query all replicas, but return values present in the
+                               majority of replicas
+                - 'quorum' - query the majority of replicas, return values present in
+                             all of them
+                - 'all' - query all replicas, and return values present in all replicas
+            **kwargs:
+                Any other named arguments to pass through to QdrantClient.search()
+        Returns:
+            List of Documents selected by maximal marginal relevance and distance for
+            each.
+        """
+        query_vector = embedding
+        if self.vector_name is not None:
+            query_vector = (self.vector_name, query_vector)  # type: ignore[assignment]
+
+        results = self.client.search(
+            collection_name=self.collection_name,
+            query_vector=query_vector,
+            query_filter=filter,
+            search_params=search_params,
+            limit=fetch_k,
+            with_payload=True,
+            with_vectors=True,
+            score_threshold=score_threshold,
+            consistency=consistency,
+            **kwargs,
+        )
+        embeddings = [
+            result.vector.get(self.vector_name)  # type: ignore[index, union-attr]
+            if self.vector_name is not None
+            else result.vector
+            for result in results
+        ]
+        mmr_selected = maximal_marginal_relevance(
+            np.array(embedding), embeddings, k=k, lambda_mult=lambda_mult
+        )
+        return [
+            (
+                self._document_from_scored_point(
+                    results[i],
+                    self.collection_name,
+                    self.content_payload_key,
+                    self.metadata_payload_key,
+                ),
+                results[i].score,
+            )
+            for i in mmr_selected
+        ]
+
+    @sync_call_fallback
+    async def amax_marginal_relevance_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[MetadataFilter] = None,
+        search_params: Optional[common_types.SearchParams] = None,
+        score_threshold: Optional[float] = None,
+        consistency: Optional[common_types.ReadConsistency] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+                     Defaults to 20.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance and distance for
+            each.
+        """
+        from qdrant_client.local.async_qdrant_local import AsyncQdrantLocal
+
+        if self.async_client is None or isinstance(
+            self.async_client._client, AsyncQdrantLocal
+        ):
+            raise NotImplementedError(
+                "QdrantLocal cannot interoperate with sync and async clients"
+            )
+        query_vector = embedding
+        if self.vector_name is not None:
+            query_vector = (self.vector_name, query_vector)  # type: ignore[assignment]
+
+        results = await self.async_client.search(
+            collection_name=self.collection_name,
+            query_vector=query_vector,
+            query_filter=filter,
+            search_params=search_params,
+            limit=fetch_k,
+            with_payload=True,
+            with_vectors=True,
+            score_threshold=score_threshold,
+            consistency=consistency,
+            **kwargs,
+        )
+        embeddings = [
+            result.vector.get(self.vector_name)  # type: ignore[index, union-attr]
+            if self.vector_name is not None
+            else result.vector
+            for result in results
+        ]
+        mmr_selected = maximal_marginal_relevance(
+            np.array(embedding), embeddings, k=k, lambda_mult=lambda_mult
+        )
+        return [
+            (
+                self._document_from_scored_point(
+                    results[i],
+                    self.collection_name,
+                    self.content_payload_key,
+                    self.metadata_payload_key,
+                ),
+                results[i].score,
+            )
+            for i in mmr_selected
+        ]
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        """Delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            True if deletion is successful, False otherwise.
+        """
+        from qdrant_client.http import models as rest
+
+        result = self.client.delete(
+            collection_name=self.collection_name,
+            points_selector=ids,
+        )
+        return result.status == rest.UpdateStatus.COMPLETED
+
+    @sync_call_fallback
+    async def adelete(
+        self, ids: Optional[List[str]] = None, **kwargs: Any
+    ) -> Optional[bool]:
+        """Delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            True if deletion is successful, False otherwise.
+        """
+        from qdrant_client.local.async_qdrant_local import AsyncQdrantLocal
+
+        if self.async_client is None or isinstance(
+            self.async_client._client, AsyncQdrantLocal
+        ):
+            raise NotImplementedError(
+                "QdrantLocal cannot interoperate with sync and async clients"
+            )
+
+        from qdrant_client.http import models as rest
+
+        result = await self.async_client.delete(
+            collection_name=self.collection_name,
+            points_selector=ids,
+        )
+
+        return result.status == rest.UpdateStatus.COMPLETED
+
+    @classmethod
+    def from_texts(
+        cls: Type[Qdrant],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[Sequence[str]] = None,
+        location: Optional[str] = None,
+        url: Optional[str] = None,
+        port: Optional[int] = 6333,
+        grpc_port: int = 6334,
+        prefer_grpc: bool = False,
+        https: Optional[bool] = None,
+        api_key: Optional[str] = None,
+        prefix: Optional[str] = None,
+        timeout: Optional[float] = None,
+        host: Optional[str] = None,
+        path: Optional[str] = None,
+        collection_name: Optional[str] = None,
+        distance_func: str = "Cosine",
+        content_payload_key: str = CONTENT_KEY,
+        metadata_payload_key: str = METADATA_KEY,
+        vector_name: Optional[str] = VECTOR_NAME,
+        batch_size: int = 64,
+        shard_number: Optional[int] = None,
+        replication_factor: Optional[int] = None,
+        write_consistency_factor: Optional[int] = None,
+        on_disk_payload: Optional[bool] = None,
+        hnsw_config: Optional[common_types.HnswConfigDiff] = None,
+        optimizers_config: Optional[common_types.OptimizersConfigDiff] = None,
+        wal_config: Optional[common_types.WalConfigDiff] = None,
+        quantization_config: Optional[common_types.QuantizationConfig] = None,
+        init_from: Optional[common_types.InitFrom] = None,
+        on_disk: Optional[bool] = None,
+        force_recreate: bool = False,
+        **kwargs: Any,
+    ) -> Qdrant:
+        """Construct Qdrant wrapper from a list of texts.
+
+        Args:
+            texts: A list of texts to be indexed in Qdrant.
+            embedding: A subclass of `Embeddings`, responsible for text vectorization.
+            metadatas:
+                An optional list of metadata. If provided it has to be of the same
+                length as a list of texts.
+            ids:
+                Optional list of ids to associate with the texts. Ids have to be
+                uuid-like strings.
+            location:
+                If `:memory:` - use in-memory Qdrant instance.
+                If `str` - use it as a `url` parameter.
+                If `None` - fallback to relying on `host` and `port` parameters.
+            url: either host or str of "Optional[scheme], host, Optional[port],
+                Optional[prefix]". Default: `None`
+            port: Port of the REST API interface. Default: 6333
+            grpc_port: Port of the gRPC interface. Default: 6334
+            prefer_grpc:
+                If true - use gPRC interface whenever possible in custom methods.
+                Default: False
+            https: If true - use HTTPS(SSL) protocol. Default: None
+            api_key: API key for authentication in Qdrant Cloud. Default: None
+            prefix:
+                If not None - add prefix to the REST URL path.
+                Example: service/v1 will result in
+                    http://localhost:6333/service/v1/{qdrant-endpoint} for REST API.
+                Default: None
+            timeout:
+                Timeout for REST and gRPC API requests.
+                Default: 5.0 seconds for REST and unlimited for gRPC
+            host:
+                Host name of Qdrant service. If url and host are None, set to
+                'localhost'. Default: None
+            path:
+                Path in which the vectors will be stored while using local mode.
+                Default: None
+            collection_name:
+                Name of the Qdrant collection to be used. If not provided,
+                it will be created randomly. Default: None
+            distance_func:
+                Distance function. One of: "Cosine" / "Euclid" / "Dot".
+                Default: "Cosine"
+            content_payload_key:
+                A payload key used to store the content of the document.
+                Default: "page_content"
+            metadata_payload_key:
+                A payload key used to store the metadata of the document.
+                Default: "metadata"
+            vector_name:
+                Name of the vector to be used internally in Qdrant.
+                Default: None
+            batch_size:
+                How many vectors upload per-request.
+                Default: 64
+            shard_number: Number of shards in collection. Default is 1, minimum is 1.
+            replication_factor:
+                Replication factor for collection. Default is 1, minimum is 1.
+                Defines how many copies of each shard will be created.
+                Have effect only in distributed mode.
+            write_consistency_factor:
+                Write consistency factor for collection. Default is 1, minimum is 1.
+                Defines how many replicas should apply the operation for us to consider
+                it successful. Increasing this number will make the collection more
+                resilient to inconsistencies, but will also make it fail if not enough
+                replicas are available.
+                Does not have any performance impact.
+                Have effect only in distributed mode.
+            on_disk_payload:
+                If true - point`s payload will not be stored in memory.
+                It will be read from the disk every time it is requested.
+                This setting saves RAM by (slightly) increasing the response time.
+                Note: those payload values that are involved in filtering and are
+                indexed - remain in RAM.
+            hnsw_config: Params for HNSW index
+            optimizers_config: Params for optimizer
+            wal_config: Params for Write-Ahead-Log
+            quantization_config:
+                Params for quantization, if None - quantization will be disabled
+            init_from:
+                Use data stored in another collection to initialize this collection
+            force_recreate:
+                Force recreating the collection
+            **kwargs:
+                Additional arguments passed directly into REST client initialization
+
+        This is a user-friendly interface that:
+        1. Creates embeddings, one for each text
+        2. Initializes the Qdrant database as an in-memory docstore by default
+           (and overridable to a remote docstore)
+        3. Adds the text embeddings to the Qdrant database
+
+        This is intended to be a quick way to get started.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import Qdrant
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                qdrant = Qdrant.from_texts(texts, embeddings, "localhost")
+        """
+        qdrant = cls.construct_instance(
+            texts,
+            embedding,
+            location,
+            url,
+            port,
+            grpc_port,
+            prefer_grpc,
+            https,
+            api_key,
+            prefix,
+            timeout,
+            host,
+            path,
+            collection_name,
+            distance_func,
+            content_payload_key,
+            metadata_payload_key,
+            vector_name,
+            shard_number,
+            replication_factor,
+            write_consistency_factor,
+            on_disk_payload,
+            hnsw_config,
+            optimizers_config,
+            wal_config,
+            quantization_config,
+            init_from,
+            on_disk,
+            force_recreate,
+            **kwargs,
+        )
+        qdrant.add_texts(texts, metadatas, ids, batch_size)
+        return qdrant
+
+    @classmethod
+    @sync_call_fallback
+    async def afrom_texts(
+        cls: Type[Qdrant],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[Sequence[str]] = None,
+        location: Optional[str] = None,
+        url: Optional[str] = None,
+        port: Optional[int] = 6333,
+        grpc_port: int = 6334,
+        prefer_grpc: bool = False,
+        https: Optional[bool] = None,
+        api_key: Optional[str] = None,
+        prefix: Optional[str] = None,
+        timeout: Optional[float] = None,
+        host: Optional[str] = None,
+        path: Optional[str] = None,
+        collection_name: Optional[str] = None,
+        distance_func: str = "Cosine",
+        content_payload_key: str = CONTENT_KEY,
+        metadata_payload_key: str = METADATA_KEY,
+        vector_name: Optional[str] = VECTOR_NAME,
+        batch_size: int = 64,
+        shard_number: Optional[int] = None,
+        replication_factor: Optional[int] = None,
+        write_consistency_factor: Optional[int] = None,
+        on_disk_payload: Optional[bool] = None,
+        hnsw_config: Optional[common_types.HnswConfigDiff] = None,
+        optimizers_config: Optional[common_types.OptimizersConfigDiff] = None,
+        wal_config: Optional[common_types.WalConfigDiff] = None,
+        quantization_config: Optional[common_types.QuantizationConfig] = None,
+        init_from: Optional[common_types.InitFrom] = None,
+        on_disk: Optional[bool] = None,
+        force_recreate: bool = False,
+        **kwargs: Any,
+    ) -> Qdrant:
+        """Construct Qdrant wrapper from a list of texts.
+
+        Args:
+            texts: A list of texts to be indexed in Qdrant.
+            embedding: A subclass of `Embeddings`, responsible for text vectorization.
+            metadatas:
+                An optional list of metadata. If provided it has to be of the same
+                length as a list of texts.
+            ids:
+                Optional list of ids to associate with the texts. Ids have to be
+                uuid-like strings.
+            location:
+                If `:memory:` - use in-memory Qdrant instance.
+                If `str` - use it as a `url` parameter.
+                If `None` - fallback to relying on `host` and `port` parameters.
+            url: either host or str of "Optional[scheme], host, Optional[port],
+                Optional[prefix]". Default: `None`
+            port: Port of the REST API interface. Default: 6333
+            grpc_port: Port of the gRPC interface. Default: 6334
+            prefer_grpc:
+                If true - use gPRC interface whenever possible in custom methods.
+                Default: False
+            https: If true - use HTTPS(SSL) protocol. Default: None
+            api_key: API key for authentication in Qdrant Cloud. Default: None
+            prefix:
+                If not None - add prefix to the REST URL path.
+                Example: service/v1 will result in
+                    http://localhost:6333/service/v1/{qdrant-endpoint} for REST API.
+                Default: None
+            timeout:
+                Timeout for REST and gRPC API requests.
+                Default: 5.0 seconds for REST and unlimited for gRPC
+            host:
+                Host name of Qdrant service. If url and host are None, set to
+                'localhost'. Default: None
+            path:
+                Path in which the vectors will be stored while using local mode.
+                Default: None
+            collection_name:
+                Name of the Qdrant collection to be used. If not provided,
+                it will be created randomly. Default: None
+            distance_func:
+                Distance function. One of: "Cosine" / "Euclid" / "Dot".
+                Default: "Cosine"
+            content_payload_key:
+                A payload key used to store the content of the document.
+                Default: "page_content"
+            metadata_payload_key:
+                A payload key used to store the metadata of the document.
+                Default: "metadata"
+            vector_name:
+                Name of the vector to be used internally in Qdrant.
+                Default: None
+            batch_size:
+                How many vectors upload per-request.
+                Default: 64
+            shard_number: Number of shards in collection. Default is 1, minimum is 1.
+            replication_factor:
+                Replication factor for collection. Default is 1, minimum is 1.
+                Defines how many copies of each shard will be created.
+                Have effect only in distributed mode.
+            write_consistency_factor:
+                Write consistency factor for collection. Default is 1, minimum is 1.
+                Defines how many replicas should apply the operation for us to consider
+                it successful. Increasing this number will make the collection more
+                resilient to inconsistencies, but will also make it fail if not enough
+                replicas are available.
+                Does not have any performance impact.
+                Have effect only in distributed mode.
+            on_disk_payload:
+                If true - point`s payload will not be stored in memory.
+                It will be read from the disk every time it is requested.
+                This setting saves RAM by (slightly) increasing the response time.
+                Note: those payload values that are involved in filtering and are
+                indexed - remain in RAM.
+            hnsw_config: Params for HNSW index
+            optimizers_config: Params for optimizer
+            wal_config: Params for Write-Ahead-Log
+            quantization_config:
+                Params for quantization, if None - quantization will be disabled
+            init_from:
+                Use data stored in another collection to initialize this collection
+            force_recreate:
+                Force recreating the collection
+            **kwargs:
+                Additional arguments passed directly into REST client initialization
+
+        This is a user-friendly interface that:
+        1. Creates embeddings, one for each text
+        2. Initializes the Qdrant database as an in-memory docstore by default
+           (and overridable to a remote docstore)
+        3. Adds the text embeddings to the Qdrant database
+
+        This is intended to be a quick way to get started.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import Qdrant
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                qdrant = await Qdrant.afrom_texts(texts, embeddings, "localhost")
+        """
+        qdrant = await cls.aconstruct_instance(
+            texts,
+            embedding,
+            location,
+            url,
+            port,
+            grpc_port,
+            prefer_grpc,
+            https,
+            api_key,
+            prefix,
+            timeout,
+            host,
+            path,
+            collection_name,
+            distance_func,
+            content_payload_key,
+            metadata_payload_key,
+            vector_name,
+            shard_number,
+            replication_factor,
+            write_consistency_factor,
+            on_disk_payload,
+            hnsw_config,
+            optimizers_config,
+            wal_config,
+            quantization_config,
+            init_from,
+            on_disk,
+            force_recreate,
+            **kwargs,
+        )
+        await qdrant.aadd_texts(texts, metadatas, ids, batch_size)
+        return qdrant
+
+    @classmethod
+    def construct_instance(
+        cls: Type[Qdrant],
+        texts: List[str],
+        embedding: Embeddings,
+        location: Optional[str] = None,
+        url: Optional[str] = None,
+        port: Optional[int] = 6333,
+        grpc_port: int = 6334,
+        prefer_grpc: bool = False,
+        https: Optional[bool] = None,
+        api_key: Optional[str] = None,
+        prefix: Optional[str] = None,
+        timeout: Optional[float] = None,
+        host: Optional[str] = None,
+        path: Optional[str] = None,
+        collection_name: Optional[str] = None,
+        distance_func: str = "Cosine",
+        content_payload_key: str = CONTENT_KEY,
+        metadata_payload_key: str = METADATA_KEY,
+        vector_name: Optional[str] = VECTOR_NAME,
+        shard_number: Optional[int] = None,
+        replication_factor: Optional[int] = None,
+        write_consistency_factor: Optional[int] = None,
+        on_disk_payload: Optional[bool] = None,
+        hnsw_config: Optional[common_types.HnswConfigDiff] = None,
+        optimizers_config: Optional[common_types.OptimizersConfigDiff] = None,
+        wal_config: Optional[common_types.WalConfigDiff] = None,
+        quantization_config: Optional[common_types.QuantizationConfig] = None,
+        init_from: Optional[common_types.InitFrom] = None,
+        on_disk: Optional[bool] = None,
+        force_recreate: bool = False,
+        **kwargs: Any,
+    ) -> Qdrant:
+        try:
+            import qdrant_client  # noqa
+        except ImportError:
+            raise ValueError(
+                "Could not import qdrant-client python package. "
+                "Please install it with `pip install qdrant-client`."
+            )
+        from grpc import RpcError
+        from qdrant_client.http import models as rest
+        from qdrant_client.http.exceptions import UnexpectedResponse
+
+        # Just do a single quick embedding to get vector size
+        partial_embeddings = embedding.embed_documents(texts[:1])
+        vector_size = len(partial_embeddings[0])
+        collection_name = collection_name or uuid.uuid4().hex
+        distance_func = distance_func.upper()
+        client, async_client = cls._generate_clients(
+            location=location,
+            url=url,
+            port=port,
+            grpc_port=grpc_port,
+            prefer_grpc=prefer_grpc,
+            https=https,
+            api_key=api_key,
+            prefix=prefix,
+            timeout=timeout,
+            host=host,
+            path=path,
+            **kwargs,
+        )
+        try:
+            # Skip any validation in case of forced collection recreate.
+            if force_recreate:
+                raise ValueError
+
+            # Get the vector configuration of the existing collection and vector, if it
+            # was specified. If the old configuration does not match the current one,
+            # an exception is being thrown.
+            collection_info = client.get_collection(collection_name=collection_name)
+            current_vector_config = collection_info.config.params.vectors
+            if isinstance(current_vector_config, dict) and vector_name is not None:
+                if vector_name not in current_vector_config:
+                    raise QdrantException(
+                        f"Existing Qdrant collection {collection_name} does not "
+                        f"contain vector named {vector_name}. Did you mean one of the "
+                        f"existing vectors: {', '.join(current_vector_config.keys())}? "
+                        f"If you want to recreate the collection, set `force_recreate` "
+                        f"parameter to `True`."
+                    )
+                current_vector_config = current_vector_config.get(vector_name)  # type: ignore[assignment]
+            elif isinstance(current_vector_config, dict) and vector_name is None:
+                raise QdrantException(
+                    f"Existing Qdrant collection {collection_name} uses named vectors. "
+                    f"If you want to reuse it, please set `vector_name` to any of the "
+                    f"existing named vectors: "
+                    f"{', '.join(current_vector_config.keys())}."  # noqa
+                    f"If you want to recreate the collection, set `force_recreate` "
+                    f"parameter to `True`."
+                )
+            elif (
+                not isinstance(current_vector_config, dict) and vector_name is not None
+            ):
+                raise QdrantException(
+                    f"Existing Qdrant collection {collection_name} doesn't use named "
+                    f"vectors. If you want to reuse it, please set `vector_name` to "
+                    f"`None`. If you want to recreate the collection, set "
+                    f"`force_recreate` parameter to `True`."
+                )
+
+            # Check if the vector configuration has the same dimensionality.
+            if current_vector_config.size != vector_size:  # type: ignore[union-attr]
+                raise QdrantException(
+                    f"Existing Qdrant collection is configured for vectors with "
+                    f"{current_vector_config.size} "  # type: ignore[union-attr]
+                    f"dimensions. Selected embeddings are {vector_size}-dimensional. "
+                    f"If you want to recreate the collection, set `force_recreate` "
+                    f"parameter to `True`."
+                )
+
+            current_distance_func = (
+                current_vector_config.distance.name.upper()  # type: ignore[union-attr]
+            )
+            if current_distance_func != distance_func:
+                raise QdrantException(
+                    f"Existing Qdrant collection is configured for "
+                    f"{current_distance_func} similarity, but requested "
+                    f"{distance_func}. Please set `distance_func` parameter to "
+                    f"`{current_distance_func}` if you want to reuse it. "
+                    f"If you want to recreate the collection, set `force_recreate` "
+                    f"parameter to `True`."
+                )
+        except (UnexpectedResponse, RpcError, ValueError):
+            vectors_config = rest.VectorParams(
+                size=vector_size,
+                distance=rest.Distance[distance_func],
+                on_disk=on_disk,
+            )
+
+            # If vector name was provided, we're going to use the named vectors feature
+            # with just a single vector.
+            if vector_name is not None:
+                vectors_config = {  # type: ignore[assignment]
+                    vector_name: vectors_config,
+                }
+
+            client.recreate_collection(
+                collection_name=collection_name,
+                vectors_config=vectors_config,
+                shard_number=shard_number,
+                replication_factor=replication_factor,
+                write_consistency_factor=write_consistency_factor,
+                on_disk_payload=on_disk_payload,
+                hnsw_config=hnsw_config,
+                optimizers_config=optimizers_config,
+                wal_config=wal_config,
+                quantization_config=quantization_config,
+                init_from=init_from,
+                timeout=timeout,  # type: ignore[arg-type]
+            )
+        qdrant = cls(
+            client=client,
+            collection_name=collection_name,
+            embeddings=embedding,
+            content_payload_key=content_payload_key,
+            metadata_payload_key=metadata_payload_key,
+            distance_strategy=distance_func,
+            vector_name=vector_name,
+            async_client=async_client,
+        )
+        return qdrant
+
+    @classmethod
+    async def aconstruct_instance(
+        cls: Type[Qdrant],
+        texts: List[str],
+        embedding: Embeddings,
+        location: Optional[str] = None,
+        url: Optional[str] = None,
+        port: Optional[int] = 6333,
+        grpc_port: int = 6334,
+        prefer_grpc: bool = False,
+        https: Optional[bool] = None,
+        api_key: Optional[str] = None,
+        prefix: Optional[str] = None,
+        timeout: Optional[float] = None,
+        host: Optional[str] = None,
+        path: Optional[str] = None,
+        collection_name: Optional[str] = None,
+        distance_func: str = "Cosine",
+        content_payload_key: str = CONTENT_KEY,
+        metadata_payload_key: str = METADATA_KEY,
+        vector_name: Optional[str] = VECTOR_NAME,
+        shard_number: Optional[int] = None,
+        replication_factor: Optional[int] = None,
+        write_consistency_factor: Optional[int] = None,
+        on_disk_payload: Optional[bool] = None,
+        hnsw_config: Optional[common_types.HnswConfigDiff] = None,
+        optimizers_config: Optional[common_types.OptimizersConfigDiff] = None,
+        wal_config: Optional[common_types.WalConfigDiff] = None,
+        quantization_config: Optional[common_types.QuantizationConfig] = None,
+        init_from: Optional[common_types.InitFrom] = None,
+        on_disk: Optional[bool] = None,
+        force_recreate: bool = False,
+        **kwargs: Any,
+    ) -> Qdrant:
+        try:
+            import qdrant_client  # noqa
+        except ImportError:
+            raise ValueError(
+                "Could not import qdrant-client python package. "
+                "Please install it with `pip install qdrant-client`."
+            )
+        from grpc import RpcError
+        from qdrant_client.http import models as rest
+        from qdrant_client.http.exceptions import UnexpectedResponse
+
+        # Just do a single quick embedding to get vector size
+        partial_embeddings = await embedding.aembed_documents(texts[:1])
+        vector_size = len(partial_embeddings[0])
+        collection_name = collection_name or uuid.uuid4().hex
+        distance_func = distance_func.upper()
+        client, async_client = cls._generate_clients(
+            location=location,
+            url=url,
+            port=port,
+            grpc_port=grpc_port,
+            prefer_grpc=prefer_grpc,
+            https=https,
+            api_key=api_key,
+            prefix=prefix,
+            timeout=timeout,
+            host=host,
+            path=path,
+            **kwargs,
+        )
+        try:
+            # Skip any validation in case of forced collection recreate.
+            if force_recreate:
+                raise ValueError
+
+            # Get the vector configuration of the existing collection and vector, if it
+            # was specified. If the old configuration does not match the current one,
+            # an exception is being thrown.
+            collection_info = client.get_collection(collection_name=collection_name)
+            current_vector_config = collection_info.config.params.vectors
+            if isinstance(current_vector_config, dict) and vector_name is not None:
+                if vector_name not in current_vector_config:
+                    raise QdrantException(
+                        f"Existing Qdrant collection {collection_name} does not "
+                        f"contain vector named {vector_name}. Did you mean one of the "
+                        f"existing vectors: {', '.join(current_vector_config.keys())}? "
+                        f"If you want to recreate the collection, set `force_recreate` "
+                        f"parameter to `True`."
+                    )
+                current_vector_config = current_vector_config.get(vector_name)  # type: ignore[assignment]
+            elif isinstance(current_vector_config, dict) and vector_name is None:
+                raise QdrantException(
+                    f"Existing Qdrant collection {collection_name} uses named vectors. "
+                    f"If you want to reuse it, please set `vector_name` to any of the "
+                    f"existing named vectors: "
+                    f"{', '.join(current_vector_config.keys())}."  # noqa
+                    f"If you want to recreate the collection, set `force_recreate` "
+                    f"parameter to `True`."
+                )
+            elif (
+                not isinstance(current_vector_config, dict) and vector_name is not None
+            ):
+                raise QdrantException(
+                    f"Existing Qdrant collection {collection_name} doesn't use named "
+                    f"vectors. If you want to reuse it, please set `vector_name` to "
+                    f"`None`. If you want to recreate the collection, set "
+                    f"`force_recreate` parameter to `True`."
+                )
+
+            # Check if the vector configuration has the same dimensionality.
+            if current_vector_config.size != vector_size:  # type: ignore[union-attr]
+                raise QdrantException(
+                    f"Existing Qdrant collection is configured for vectors with "
+                    f"{current_vector_config.size} "  # type: ignore[union-attr]
+                    f"dimensions. Selected embeddings are {vector_size}-dimensional. "
+                    f"If you want to recreate the collection, set `force_recreate` "
+                    f"parameter to `True`."
+                )
+
+            current_distance_func = (
+                current_vector_config.distance.name.upper()  # type: ignore[union-attr]
+            )
+            if current_distance_func != distance_func:
+                raise QdrantException(
+                    f"Existing Qdrant collection is configured for "
+                    f"{current_vector_config.distance} "  # type: ignore[union-attr]
+                    f"similarity. Please set `distance_func` parameter to "
+                    f"`{distance_func}` if you want to reuse it. If you want to "
+                    f"recreate the collection, set `force_recreate` parameter to "
+                    f"`True`."
+                )
+        except (UnexpectedResponse, RpcError, ValueError):
+            vectors_config = rest.VectorParams(
+                size=vector_size,
+                distance=rest.Distance[distance_func],
+                on_disk=on_disk,
+            )
+
+            # If vector name was provided, we're going to use the named vectors feature
+            # with just a single vector.
+            if vector_name is not None:
+                vectors_config = {  # type: ignore[assignment]
+                    vector_name: vectors_config,
+                }
+
+            client.recreate_collection(
+                collection_name=collection_name,
+                vectors_config=vectors_config,
+                shard_number=shard_number,
+                replication_factor=replication_factor,
+                write_consistency_factor=write_consistency_factor,
+                on_disk_payload=on_disk_payload,
+                hnsw_config=hnsw_config,
+                optimizers_config=optimizers_config,
+                wal_config=wal_config,
+                quantization_config=quantization_config,
+                init_from=init_from,
+                timeout=timeout,  # type: ignore[arg-type]
+            )
+        qdrant = cls(
+            client=client,
+            collection_name=collection_name,
+            embeddings=embedding,
+            content_payload_key=content_payload_key,
+            metadata_payload_key=metadata_payload_key,
+            distance_strategy=distance_func,
+            vector_name=vector_name,
+            async_client=async_client,
+        )
+        return qdrant
+
+    @staticmethod
+    def _cosine_relevance_score_fn(distance: float) -> float:
+        """Normalize the distance to a score on a scale [0, 1]."""
+        return (distance + 1.0) / 2.0
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+        """
+
+        if self.distance_strategy == "COSINE":
+            return self._cosine_relevance_score_fn
+        elif self.distance_strategy == "DOT":
+            return self._max_inner_product_relevance_score_fn
+        elif self.distance_strategy == "EUCLID":
+            return self._euclidean_relevance_score_fn
+        else:
+            raise ValueError(
+                "Unknown distance strategy, must be cosine, "
+                "max_inner_product, or euclidean"
+            )
+
+    def _similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs and relevance scores in the range [0, 1].
+
+        0 is dissimilar, 1 is most similar.
+
+        Args:
+            query: input text
+            k: Number of Documents to return. Defaults to 4.
+            **kwargs: kwargs to be passed to similarity search. Should include:
+                score_threshold: Optional, a floating point value between 0 to 1 to
+                    filter the resulting set of retrieved docs
+
+        Returns:
+            List of Tuples of (doc, similarity_score)
+        """
+        return self.similarity_search_with_score(query, k, **kwargs)
+
+    @classmethod
+    def _build_payloads(
+        cls,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]],
+        content_payload_key: str,
+        metadata_payload_key: str,
+    ) -> List[dict]:
+        payloads = []
+        for i, text in enumerate(texts):
+            if text is None:
+                raise ValueError(
+                    "At least one of the texts is None. Please remove it before "
+                    "calling .from_texts or .add_texts on Qdrant instance."
+                )
+            metadata = metadatas[i] if metadatas is not None else None
+            payloads.append(
+                {
+                    content_payload_key: text,
+                    metadata_payload_key: metadata,
+                }
+            )
+
+        return payloads
+
+    @classmethod
+    def _document_from_scored_point(
+        cls,
+        scored_point: Any,
+        collection_name: str,
+        content_payload_key: str,
+        metadata_payload_key: str,
+    ) -> Document:
+        metadata = scored_point.payload.get(metadata_payload_key) or {}
+        metadata["_id"] = scored_point.id
+        metadata["_collection_name"] = collection_name
+        return Document(
+            page_content=scored_point.payload.get(content_payload_key),
+            metadata=metadata,
+        )
+
+    def _build_condition(self, key: str, value: Any) -> List[rest.FieldCondition]:
+        from qdrant_client.http import models as rest
+
+        out = []
+
+        if isinstance(value, dict):
+            for _key, value in value.items():
+                out.extend(self._build_condition(f"{key}.{_key}", value))
+        elif isinstance(value, list):
+            for _value in value:
+                if isinstance(_value, dict):
+                    out.extend(self._build_condition(f"{key}[]", _value))
+                else:
+                    out.extend(self._build_condition(f"{key}", _value))
+        else:
+            out.append(
+                rest.FieldCondition(
+                    key=f"{self.metadata_payload_key}.{key}",
+                    match=rest.MatchValue(value=value),
+                )
+            )
+
+        return out
+
+    def _qdrant_filter_from_dict(
+        self, filter: Optional[DictFilter]
+    ) -> Optional[rest.Filter]:
+        from qdrant_client.http import models as rest
+
+        if not filter:
+            return None
+
+        return rest.Filter(
+            must=[
+                condition
+                for key, value in filter.items()
+                for condition in self._build_condition(key, value)
+            ]
+        )
+
+    def _embed_query(self, query: str) -> List[float]:
+        """Embed query text.
+
+        Used to provide backward compatibility with `embedding_function` argument.
+
+        Args:
+            query: Query text.
+
+        Returns:
+            List of floats representing the query embedding.
+        """
+        if self.embeddings is not None:
+            embedding = self.embeddings.embed_query(query)
+        else:
+            if self._embeddings_function is not None:
+                embedding = self._embeddings_function(query)
+            else:
+                raise ValueError("Neither of embeddings or embedding_function is set")
+        return embedding.tolist() if hasattr(embedding, "tolist") else embedding
+
+    async def _aembed_query(self, query: str) -> List[float]:
+        """Embed query text asynchronously.
+
+        Used to provide backward compatibility with `embedding_function` argument.
+
+        Args:
+            query: Query text.
+
+        Returns:
+            List of floats representing the query embedding.
+        """
+        if self.embeddings is not None:
+            embedding = await self.embeddings.aembed_query(query)
+        else:
+            if self._embeddings_function is not None:
+                embedding = self._embeddings_function(query)
+            else:
+                raise ValueError("Neither of embeddings or embedding_function is set")
+        return embedding.tolist() if hasattr(embedding, "tolist") else embedding
+
+    def _embed_texts(self, texts: Iterable[str]) -> List[List[float]]:
+        """Embed search texts.
+
+        Used to provide backward compatibility with `embedding_function` argument.
+
+        Args:
+            texts: Iterable of texts to embed.
+
+        Returns:
+            List of floats representing the texts embedding.
+        """
+        if self.embeddings is not None:
+            embeddings = self.embeddings.embed_documents(list(texts))
+            if hasattr(embeddings, "tolist"):
+                embeddings = embeddings.tolist()
+        elif self._embeddings_function is not None:
+            embeddings = []
+            for text in texts:
+                embedding = self._embeddings_function(text)
+                if hasattr(embeddings, "tolist"):
+                    embedding = embedding.tolist()
+                embeddings.append(embedding)
+        else:
+            raise ValueError("Neither of embeddings or embedding_function is set")
+
+        return embeddings
+
+    async def _aembed_texts(self, texts: Iterable[str]) -> List[List[float]]:
+        """Embed search texts.
+
+        Used to provide backward compatibility with `embedding_function` argument.
+
+        Args:
+            texts: Iterable of texts to embed.
+
+        Returns:
+            List of floats representing the texts embedding.
+        """
+        if self.embeddings is not None:
+            embeddings = await self.embeddings.aembed_documents(list(texts))
+            if hasattr(embeddings, "tolist"):
+                embeddings = embeddings.tolist()
+        elif self._embeddings_function is not None:
+            embeddings = []
+            for text in texts:
+                embedding = self._embeddings_function(text)
+                if hasattr(embeddings, "tolist"):
+                    embedding = embedding.tolist()
+                embeddings.append(embedding)
+        else:
+            raise ValueError("Neither of embeddings or embedding_function is set")
+
+        return embeddings
+
+    def _generate_rest_batches(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[Sequence[str]] = None,
+        batch_size: int = 64,
+    ) -> Generator[Tuple[List[str], List[rest.PointStruct]], None, None]:
+        from qdrant_client.http import models as rest
+
+        texts_iterator = iter(texts)
+        metadatas_iterator = iter(metadatas or [])
+        ids_iterator = iter(ids or [uuid.uuid4().hex for _ in iter(texts)])
+        while batch_texts := list(islice(texts_iterator, batch_size)):
+            # Take the corresponding metadata and id for each text in a batch
+            batch_metadatas = list(islice(metadatas_iterator, batch_size)) or None
+            batch_ids = list(islice(ids_iterator, batch_size))
+
+            # Generate the embeddings for all the texts in a batch
+            batch_embeddings = self._embed_texts(batch_texts)
+
+            points = [
+                rest.PointStruct(
+                    id=point_id,
+                    vector=vector
+                    if self.vector_name is None
+                    else {self.vector_name: vector},
+                    payload=payload,
+                )
+                for point_id, vector, payload in zip(
+                    batch_ids,
+                    batch_embeddings,
+                    self._build_payloads(
+                        batch_texts,
+                        batch_metadatas,
+                        self.content_payload_key,
+                        self.metadata_payload_key,
+                    ),
+                )
+            ]
+
+            yield batch_ids, points
+
+    async def _agenerate_rest_batches(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[Sequence[str]] = None,
+        batch_size: int = 64,
+    ) -> AsyncGenerator[Tuple[List[str], List[rest.PointStruct]], None]:
+        from qdrant_client.http import models as rest
+
+        texts_iterator = iter(texts)
+        metadatas_iterator = iter(metadatas or [])
+        ids_iterator = iter(ids or [uuid.uuid4().hex for _ in iter(texts)])
+        while batch_texts := list(islice(texts_iterator, batch_size)):
+            # Take the corresponding metadata and id for each text in a batch
+            batch_metadatas = list(islice(metadatas_iterator, batch_size)) or None
+            batch_ids = list(islice(ids_iterator, batch_size))
+
+            # Generate the embeddings for all the texts in a batch
+            batch_embeddings = await self._aembed_texts(batch_texts)
+
+            points = [
+                rest.PointStruct(
+                    id=point_id,
+                    vector=vector
+                    if self.vector_name is None
+                    else {self.vector_name: vector},
+                    payload=payload,
+                )
+                for point_id, vector, payload in zip(
+                    batch_ids,
+                    batch_embeddings,
+                    self._build_payloads(
+                        batch_texts,
+                        batch_metadatas,
+                        self.content_payload_key,
+                        self.metadata_payload_key,
+                    ),
+                )
+            ]
+
+            yield batch_ids, points
+
+    @staticmethod
+    def _generate_clients(
+        location: Optional[str] = None,
+        url: Optional[str] = None,
+        port: Optional[int] = 6333,
+        grpc_port: int = 6334,
+        prefer_grpc: bool = False,
+        https: Optional[bool] = None,
+        api_key: Optional[str] = None,
+        prefix: Optional[str] = None,
+        timeout: Optional[float] = None,
+        host: Optional[str] = None,
+        path: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Tuple[Any, Any]:
+        from qdrant_client import AsyncQdrantClient, QdrantClient
+
+        sync_client = QdrantClient(
+            location=location,
+            url=url,
+            port=port,
+            grpc_port=grpc_port,
+            prefer_grpc=prefer_grpc,
+            https=https,
+            api_key=api_key,
+            prefix=prefix,
+            timeout=timeout,
+            host=host,
+            path=path,
+            **kwargs,
+        )
+
+        if location == ":memory:" or path is not None:
+            # Local Qdrant cannot co-exist with Sync and Async clients
+            # We fallback to sync operations in this case
+            async_client = None
+        else:
+            async_client = AsyncQdrantClient(
+                location=location,
+                url=url,
+                port=port,
+                grpc_port=grpc_port,
+                prefer_grpc=prefer_grpc,
+                https=https,
+                api_key=api_key,
+                prefix=prefix,
+                timeout=timeout,
+                host=host,
+                path=path,
+                **kwargs,
+            )
+
+        return sync_client, async_client
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/redis/__init__.py b/llm/Lib/site-packages/langchain_community/vectorstores/redis/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc088facf4ff974e904cc9869b65a13aaa086c0f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/redis/__init__.py
@@ -0,0 +1,16 @@
+from .base import Redis, RedisVectorStoreRetriever
+from .filters import (
+    RedisFilter,
+    RedisNum,
+    RedisTag,
+    RedisText,
+)
+
+__all__ = [
+    "Redis",
+    "RedisFilter",
+    "RedisTag",
+    "RedisText",
+    "RedisNum",
+    "RedisVectorStoreRetriever",
+]
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..17dfcd6ce851ed502ba33ee69d6d085430577610
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9a037d49339b5744ae4540f13e569da37b1a8ffa
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/constants.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/constants.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1971bf02a7bf8fddb1bb472844d30141c3229579
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/constants.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/filters.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/filters.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..311881e997d80cabc2926ff7c6c95449620433f3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/filters.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/schema.cpython-311.pyc b/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/schema.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6f83c1d0ae6f0fd5c02189301948d0d91a395e3c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_community/vectorstores/redis/__pycache__/schema.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/redis/base.py b/llm/Lib/site-packages/langchain_community/vectorstores/redis/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..39d0af280d54e1e351cabdfab999644129a28a3c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/redis/base.py
@@ -0,0 +1,1513 @@
+"""Wrapper around Redis vector database."""
+
+from __future__ import annotations
+
+import logging
+import os
+import uuid
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+
+import numpy as np
+import yaml
+from langchain_core._api import deprecated
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForRetrieverRun,
+    CallbackManagerForRetrieverRun,
+)
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_dict_or_env
+from langchain_core.vectorstores import VectorStore, VectorStoreRetriever
+
+from langchain_community.utilities.redis import (
+    _array_to_buffer,
+    _buffer_to_array,
+    check_redis_module_exist,
+    get_client,
+)
+from langchain_community.vectorstores.redis.constants import (
+    REDIS_REQUIRED_MODULES,
+    REDIS_TAG_SEPARATOR,
+)
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+logger = logging.getLogger(__name__)
+ListOfDict = List[Dict[str, str]]
+
+if TYPE_CHECKING:
+    from redis.client import Redis as RedisType
+    from redis.commands.search.query import Query
+
+    from langchain_community.vectorstores.redis.filters import RedisFilterExpression
+    from langchain_community.vectorstores.redis.schema import RedisModel
+
+
+def _default_relevance_score(val: float) -> float:
+    return 1 - val
+
+
+def check_index_exists(client: RedisType, index_name: str) -> bool:
+    """Check if Redis index exists."""
+    try:
+        client.ft(index_name).info()
+    except:  # noqa: E722
+        logger.debug("Index does not exist")
+        return False
+    logger.debug("Index already exists")
+    return True
+
+
+class Redis(VectorStore):
+    """Redis vector database.
+
+    To use, you should have the ``redis`` python package installed
+    and have a running Redis Enterprise or Redis-Stack server
+
+    For production use cases, it is recommended to use Redis Enterprise
+    as the scaling, performance, stability and availability is much
+    better than Redis-Stack.
+
+    For testing and prototyping, however, this is not required.
+    Redis-Stack is available as a docker container the full vector
+    search API available.
+
+    .. code-block:: bash
+
+        # to run redis stack in docker locally
+        docker run -d -p 6379:6379 -p 8001:8001 redis/redis-stack:latest
+
+    Once running, you can connect to the redis server with the following url schemas:
+    - redis://<host>:<port> # simple connection
+    - redis://<username>:<password>@<host>:<port> # connection with authentication
+    - rediss://<host>:<port> # connection with SSL
+    - rediss://<username>:<password>@<host>:<port> # connection with SSL and auth
+
+
+    Examples:
+
+    The following examples show various ways to use the Redis VectorStore with
+    LangChain.
+
+    For all the following examples assume we have the following imports:
+
+    .. code-block:: python
+
+        from langchain_community.vectorstores import Redis
+        from langchain_community.embeddings import OpenAIEmbeddings
+
+    Initialize, create index, and load Documents
+        .. code-block:: python
+
+            from langchain_community.vectorstores import Redis
+            from langchain_community.embeddings import OpenAIEmbeddings
+
+            rds = Redis.from_documents(
+                documents, # a list of Document objects from loaders or created
+                embeddings, # an Embeddings object
+                redis_url="redis://localhost:6379",
+            )
+
+    Initialize, create index, and load Documents with metadata
+        .. code-block:: python
+
+
+            rds = Redis.from_texts(
+                texts, # a list of strings
+                metadata, # a list of metadata dicts
+                embeddings, # an Embeddings object
+                redis_url="redis://localhost:6379",
+            )
+
+    Initialize, create index, and load Documents with metadata and return keys
+
+        .. code-block:: python
+
+            rds, keys = Redis.from_texts_return_keys(
+                texts, # a list of strings
+                metadata, # a list of metadata dicts
+                embeddings, # an Embeddings object
+                redis_url="redis://localhost:6379",
+            )
+
+    For use cases where the index needs to stay alive, you can initialize
+    with an index name such that it's easier to reference later
+
+        .. code-block:: python
+
+            rds = Redis.from_texts(
+                texts, # a list of strings
+                metadata, # a list of metadata dicts
+                embeddings, # an Embeddings object
+                index_name="my-index",
+                redis_url="redis://localhost:6379",
+            )
+
+    Initialize and connect to an existing index (from above)
+
+        .. code-block:: python
+
+            # must pass in schema and key_prefix from another index
+            existing_rds = Redis.from_existing_index(
+                embeddings, # an Embeddings object
+                index_name="my-index",
+                schema=rds.schema, # schema dumped from another index
+                key_prefix=rds.key_prefix, # key prefix from another index
+                redis_url="redis://localhost:6379",
+            )
+
+
+    Advanced examples:
+
+    Custom vector schema can be supplied to change the way that
+    Redis creates the underlying vector schema. This is useful
+    for production use cases where you want to optimize the
+    vector schema for your use case. ex. using HNSW instead of
+    FLAT (knn) which is the default
+
+        .. code-block:: python
+
+            vector_schema = {
+                "algorithm": "HNSW"
+            }
+
+            rds = Redis.from_texts(
+                texts, # a list of strings
+                metadata, # a list of metadata dicts
+                embeddings, # an Embeddings object
+                vector_schema=vector_schema,
+                redis_url="redis://localhost:6379",
+            )
+
+    Custom index schema can be supplied to change the way that the
+    metadata is indexed. This is useful for you would like to use the
+    hybrid querying (filtering) capability of Redis.
+
+    By default, this implementation will automatically generate the index
+    schema according to the following rules:
+        - All strings are indexed as text fields
+        - All numbers are indexed as numeric fields
+        - All lists of strings are indexed as tag fields (joined by
+            langchain_community.vectorstores.redis.constants.REDIS_TAG_SEPARATOR)
+        - All None values are not indexed but still stored in Redis these are
+            not retrievable through the interface here, but the raw Redis client
+            can be used to retrieve them.
+        - All other types are not indexed
+
+    To override these rules, you can pass in a custom index schema like the following
+
+        .. code-block:: yaml
+
+            tag:
+                - name: credit_score
+            text:
+                - name: user
+                - name: job
+
+    Typically, the ``credit_score`` field would be a text field since it's a string,
+    however, we can override this behavior by specifying the field type as shown with
+    the yaml config (can also be a dictionary) above and the code below.
+
+        .. code-block:: python
+
+            rds = Redis.from_texts(
+                texts, # a list of strings
+                metadata, # a list of metadata dicts
+                embeddings, # an Embeddings object
+                index_schema="path/to/index_schema.yaml", # can also be a dictionary
+                redis_url="redis://localhost:6379",
+            )
+
+    When connecting to an existing index where a custom schema has been applied, it's
+    important to pass in the same schema to the ``from_existing_index`` method.
+    Otherwise, the schema for newly added samples will be incorrect and metadata
+    will not be returned.
+
+    """
+
+    DEFAULT_VECTOR_SCHEMA = {
+        "name": "content_vector",
+        "algorithm": "FLAT",
+        "dims": 1536,
+        "distance_metric": "COSINE",
+        "datatype": "FLOAT32",
+    }
+
+    def __init__(
+        self,
+        redis_url: str,
+        index_name: str,
+        embedding: Embeddings,
+        index_schema: Optional[Union[Dict[str, ListOfDict], str, os.PathLike]] = None,
+        vector_schema: Optional[Dict[str, Union[str, int]]] = None,
+        relevance_score_fn: Optional[Callable[[float], float]] = None,
+        key_prefix: Optional[str] = None,
+        **kwargs: Any,
+    ):
+        """Initialize Redis vector store with necessary components."""
+        self._check_deprecated_kwargs(kwargs)
+        try:
+            # TODO use importlib to check if redis is installed
+            import redis  # noqa: F401
+
+        except ImportError as e:
+            raise ImportError(
+                "Could not import redis python package. "
+                "Please install it with `pip install redis`."
+            ) from e
+
+        self.index_name = index_name
+        self._embeddings = embedding
+        try:
+            redis_client = get_client(redis_url=redis_url, **kwargs)
+            # check if redis has redisearch module installed
+            check_redis_module_exist(redis_client, REDIS_REQUIRED_MODULES)
+        except ValueError as e:
+            raise ValueError(f"Redis failed to connect: {e}")
+
+        self.client = redis_client
+        self.relevance_score_fn = relevance_score_fn
+        self._schema = self._get_schema_with_defaults(index_schema, vector_schema)
+        self.key_prefix = key_prefix if key_prefix is not None else f"doc:{index_name}"
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        """Access the query embedding object if available."""
+        return self._embeddings
+
+    @classmethod
+    def from_texts_return_keys(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        index_name: Optional[str] = None,
+        index_schema: Optional[Union[Dict[str, ListOfDict], str, os.PathLike]] = None,
+        vector_schema: Optional[Dict[str, Union[str, int]]] = None,
+        **kwargs: Any,
+    ) -> Tuple[Redis, List[str]]:
+        """Create a Redis vectorstore from raw documents.
+
+        This is a user-friendly interface that:
+            1. Embeds documents.
+            2. Creates a new Redis index if it doesn't already exist
+            3. Adds the documents to the newly created Redis index.
+            4. Returns the keys of the newly created documents once stored.
+
+        This method will generate schema based on the metadata passed in
+        if the `index_schema` is not defined. If the `index_schema` is defined,
+        it will compare against the generated schema and warn if there are
+        differences. If you are purposefully defining the schema for the
+        metadata, then you can ignore that warning.
+
+        To examine the schema options, initialize an instance of this class
+        and print out the schema using the `Redis.schema`` property. This
+        will include the content and content_vector classes which are
+        always present in the langchain schema.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import Redis
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                redis, keys = Redis.from_texts_return_keys(
+                    texts,
+                    embeddings,
+                    redis_url="redis://localhost:6379"
+                )
+
+        Args:
+            texts (List[str]): List of texts to add to the vectorstore.
+            embedding (Embeddings): Embeddings to use for the vectorstore.
+            metadatas (Optional[List[dict]], optional): Optional list of metadata
+                dicts to add to the vectorstore. Defaults to None.
+            index_name (Optional[str], optional): Optional name of the index to
+                create or add to. Defaults to None.
+            index_schema (Optional[Union[Dict[str, ListOfDict], str, os.PathLike]],
+                optional):
+                Optional fields to index within the metadata. Overrides generated
+                schema. Defaults to None.
+            vector_schema (Optional[Dict[str, Union[str, int]]], optional): Optional
+                vector schema to use. Defaults to None.
+            **kwargs (Any): Additional keyword arguments to pass to the Redis client.
+
+        Returns:
+            Tuple[Redis, List[str]]: Tuple of the Redis instance and the keys of
+                the newly created documents.
+
+        Raises:
+            ValueError: If the number of metadatas does not match the number of texts.
+        """
+        try:
+            # TODO use importlib to check if redis is installed
+            import redis  # noqa: F401
+
+            from langchain_community.vectorstores.redis.schema import read_schema
+
+        except ImportError as e:
+            raise ImportError(
+                "Could not import redis python package. "
+                "Please install it with `pip install redis`."
+            ) from e
+
+        redis_url = get_from_dict_or_env(kwargs, "redis_url", "REDIS_URL")
+
+        if "redis_url" in kwargs:
+            kwargs.pop("redis_url")
+
+        # flag to use generated schema
+        if "generate" in kwargs:
+            kwargs.pop("generate")
+
+        # see if the user specified keys
+        keys = None
+        if "keys" in kwargs:
+            keys = kwargs.pop("keys")
+
+        # Name of the search index if not given
+        if not index_name:
+            index_name = uuid.uuid4().hex
+
+        # type check for metadata
+        if metadatas:
+            if isinstance(metadatas, list) and len(metadatas) != len(texts):  # type: ignore  # noqa: E501
+                raise ValueError("Number of metadatas must match number of texts")
+            if not (isinstance(metadatas, list) and isinstance(metadatas[0], dict)):
+                raise ValueError("Metadatas must be a list of dicts")
+
+            generated_schema = _generate_field_schema(metadatas[0])
+            if index_schema:
+                # read in the schema solely to compare to the generated schema
+                user_schema = read_schema(index_schema)  # type: ignore
+
+                # the very rare case where a super user decides to pass the index
+                # schema and a document loader is used that has metadata which
+                # we need to map into fields.
+                if user_schema != generated_schema:
+                    logger.warning(
+                        "`index_schema` does not match generated metadata schema.\n"
+                        + "If you meant to manually override the schema, please "
+                        + "ignore this message.\n"
+                        + f"index_schema: {user_schema}\n"
+                        + f"generated_schema: {generated_schema}\n"
+                    )
+            else:
+                # use the generated schema
+                index_schema = generated_schema
+
+        # Create instance
+        # init the class -- if Redis is unavailable, will throw exception
+        instance = cls(
+            redis_url,
+            index_name,
+            embedding,
+            index_schema=index_schema,
+            vector_schema=vector_schema,
+            **kwargs,
+        )
+
+        # Add data to Redis
+        keys = instance.add_texts(texts, metadatas, keys=keys)
+        return instance, keys
+
+    @classmethod
+    def from_texts(
+        cls: Type[Redis],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        index_name: Optional[str] = None,
+        index_schema: Optional[Union[Dict[str, ListOfDict], str, os.PathLike]] = None,
+        vector_schema: Optional[Dict[str, Union[str, int]]] = None,
+        **kwargs: Any,
+    ) -> Redis:
+        """Create a Redis vectorstore from a list of texts.
+
+        This is a user-friendly interface that:
+            1. Embeds documents.
+            2. Creates a new Redis index if it doesn't already exist
+            3. Adds the documents to the newly created Redis index.
+
+        This method will generate schema based on the metadata passed in
+        if the `index_schema` is not defined. If the `index_schema` is defined,
+        it will compare against the generated schema and warn if there are
+        differences. If you are purposefully defining the schema for the
+        metadata, then you can ignore that warning.
+
+        To examine the schema options, initialize an instance of this class
+        and print out the schema using the `Redis.schema`` property. This
+        will include the content and content_vector classes which are
+        always present in the langchain schema.
+
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import Redis
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                redisearch = RediSearch.from_texts(
+                    texts,
+                    embeddings,
+                    redis_url="redis://username:password@localhost:6379"
+                )
+
+        Args:
+            texts (List[str]): List of texts to add to the vectorstore.
+            embedding (Embeddings): Embedding model class (i.e. OpenAIEmbeddings)
+                for embedding queries.
+            metadatas (Optional[List[dict]], optional): Optional list of metadata dicts
+                to add to the vectorstore. Defaults to None.
+            index_name (Optional[str], optional): Optional name of the index to create
+                or add to. Defaults to None.
+            index_schema (Optional[Union[Dict[str, ListOfDict], str, os.PathLike]],
+                optional):
+                Optional fields to index within the metadata. Overrides generated
+                schema. Defaults to None.
+            vector_schema (Optional[Dict[str, Union[str, int]]], optional): Optional
+                vector schema to use. Defaults to None.
+            **kwargs (Any): Additional keyword arguments to pass to the Redis client.
+
+        Returns:
+            Redis: Redis VectorStore instance.
+
+        Raises:
+            ValueError: If the number of metadatas does not match the number of texts.
+            ImportError: If the redis python package is not installed.
+        """
+        instance, _ = cls.from_texts_return_keys(
+            texts,
+            embedding,
+            metadatas=metadatas,
+            index_name=index_name,
+            index_schema=index_schema,
+            vector_schema=vector_schema,
+            **kwargs,
+        )
+        return instance
+
+    @classmethod
+    def from_existing_index(
+        cls,
+        embedding: Embeddings,
+        index_name: str,
+        schema: Union[Dict[str, ListOfDict], str, os.PathLike, Dict[str, ListOfDict]],
+        key_prefix: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Redis:
+        """Connect to an existing Redis index.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import Redis
+                from langchain_community.embeddings import OpenAIEmbeddings
+
+                embeddings = OpenAIEmbeddings()
+
+                # must pass in schema and key_prefix from another index
+                existing_rds = Redis.from_existing_index(
+                    embeddings,
+                    index_name="my-index",
+                    schema=rds.schema, # schema dumped from another index
+                    key_prefix=rds.key_prefix, # key prefix from another index
+                    redis_url="redis://username:password@localhost:6379",
+                )
+
+        Args:
+            embedding (Embeddings): Embedding model class (i.e. OpenAIEmbeddings)
+                for embedding queries.
+            index_name (str): Name of the index to connect to.
+            schema (Union[Dict[str, str], str, os.PathLike, Dict[str, ListOfDict]]):
+                Schema of the index and the vector schema. Can be a dict, or path to
+                yaml file.
+            key_prefix (Optional[str]): Prefix to use for all keys in Redis associated
+                with this index.
+            **kwargs (Any): Additional keyword arguments to pass to the Redis client.
+
+        Returns:
+            Redis: Redis VectorStore instance.
+
+        Raises:
+            ValueError: If the index does not exist.
+            ImportError: If the redis python package is not installed.
+        """
+        redis_url = get_from_dict_or_env(kwargs, "redis_url", "REDIS_URL")
+        # We need to first remove redis_url from kwargs,
+        # otherwise passing it to Redis will result in an error.
+        if "redis_url" in kwargs:
+            kwargs.pop("redis_url")
+
+        # Create instance
+        # init the class -- if Redis is unavailable, will throw exception
+        instance = cls(
+            redis_url,
+            index_name,
+            embedding,
+            index_schema=schema,
+            key_prefix=key_prefix,
+            **kwargs,
+        )
+
+        # Check for existence of the declared index
+        if not check_index_exists(instance.client, index_name):
+            # Will only raise if the running Redis server does not
+            # have a record of this particular index
+            raise ValueError(
+                f"Redis failed to connect: Index {index_name} does not exist."
+            )
+
+        return instance
+
+    @property
+    def schema(self) -> Dict[str, List[Any]]:
+        """Return the schema of the index."""
+        return self._schema.as_dict()
+
+    def write_schema(self, path: Union[str, os.PathLike]) -> None:
+        """Write the schema to a yaml file."""
+        with open(path, "w+") as f:
+            yaml.dump(self.schema, f)
+
+    @staticmethod
+    def delete(
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> bool:
+        """
+        Delete a Redis entry.
+
+        Args:
+            ids: List of ids (keys in redis) to delete.
+            redis_url: Redis connection url. This should be passed in the kwargs
+                or set as an environment variable: REDIS_URL.
+
+        Returns:
+            bool: Whether or not the deletions were successful.
+
+        Raises:
+            ValueError: If the redis python package is not installed.
+            ValueError: If the ids (keys in redis) are not provided
+        """
+        redis_url = get_from_dict_or_env(kwargs, "redis_url", "REDIS_URL")
+
+        if ids is None:
+            raise ValueError("'ids' (keys)() were not provided.")
+
+        try:
+            import redis  # noqa: F401
+        except ImportError:
+            raise ValueError(
+                "Could not import redis python package. "
+                "Please install it with `pip install redis`."
+            )
+        try:
+            # We need to first remove redis_url from kwargs,
+            # otherwise passing it to Redis will result in an error.
+            if "redis_url" in kwargs:
+                kwargs.pop("redis_url")
+            client = get_client(redis_url=redis_url, **kwargs)
+        except ValueError as e:
+            raise ValueError(f"Your redis connected error: {e}")
+        # Check if index exists
+        try:
+            client.delete(*ids)
+            logger.info("Entries deleted")
+            return True
+        except:  # noqa: E722
+            # ids does not exist
+            return False
+
+    @staticmethod
+    def drop_index(
+        index_name: str,
+        delete_documents: bool,
+        **kwargs: Any,
+    ) -> bool:
+        """
+        Drop a Redis search index.
+
+        Args:
+            index_name (str): Name of the index to drop.
+            delete_documents (bool): Whether to drop the associated documents.
+
+        Returns:
+            bool: Whether or not the drop was successful.
+        """
+        redis_url = get_from_dict_or_env(kwargs, "redis_url", "REDIS_URL")
+        try:
+            import redis  # noqa: F401
+        except ImportError:
+            raise ValueError(
+                "Could not import redis python package. "
+                "Please install it with `pip install redis`."
+            )
+        try:
+            # We need to first remove redis_url from kwargs,
+            # otherwise passing it to Redis will result in an error.
+            if "redis_url" in kwargs:
+                kwargs.pop("redis_url")
+            client = get_client(redis_url=redis_url, **kwargs)
+        except ValueError as e:
+            raise ValueError(f"Your redis connected error: {e}")
+        # Check if index exists
+        try:
+            client.ft(index_name).dropindex(delete_documents)
+            logger.info("Drop index")
+            return True
+        except:  # noqa: E722
+            # Index not exist
+            return False
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        embeddings: Optional[List[List[float]]] = None,
+        batch_size: int = 1000,
+        clean_metadata: bool = True,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add more texts to the vectorstore.
+
+        Args:
+            texts (Iterable[str]): Iterable of strings/text to add to the vectorstore.
+            metadatas (Optional[List[dict]], optional): Optional list of metadatas.
+                Defaults to None.
+            embeddings (Optional[List[List[float]]], optional): Optional pre-generated
+                embeddings. Defaults to None.
+            keys (List[str]) or ids (List[str]): Identifiers of entries.
+                Defaults to None.
+            batch_size (int, optional): Batch size to use for writes. Defaults to 1000.
+
+        Returns:
+            List[str]: List of ids added to the vectorstore
+        """
+        ids = []
+
+        # Get keys or ids from kwargs
+        # Other vectorstores use ids
+        keys_or_ids = kwargs.get("keys", kwargs.get("ids"))
+
+        # type check for metadata
+        if metadatas:
+            if isinstance(metadatas, list) and len(metadatas) != len(texts):  # type: ignore  # noqa: E501
+                raise ValueError("Number of metadatas must match number of texts")
+            if not (isinstance(metadatas, list) and isinstance(metadatas[0], dict)):
+                raise ValueError("Metadatas must be a list of dicts")
+
+        embeddings = embeddings or self._embeddings.embed_documents(list(texts))
+        self._create_index_if_not_exist(dim=len(embeddings[0]))
+
+        # Write data to redis
+        pipeline = self.client.pipeline(transaction=False)
+        for i, text in enumerate(texts):
+            # Use provided values by default or fallback
+            key = keys_or_ids[i] if keys_or_ids else str(uuid.uuid4().hex)
+            if not key.startswith(self.key_prefix + ":"):
+                key = self.key_prefix + ":" + key
+            metadata = metadatas[i] if metadatas else {}
+            metadata = _prepare_metadata(metadata) if clean_metadata else metadata
+            pipeline.hset(
+                key,
+                mapping={
+                    self._schema.content_key: text,
+                    self._schema.content_vector_key: _array_to_buffer(
+                        embeddings[i], self._schema.vector_dtype
+                    ),
+                    **metadata,
+                },
+            )
+            ids.append(key)
+
+            # Write batch
+            if i % batch_size == 0:
+                pipeline.execute()
+
+        # Cleanup final batch
+        pipeline.execute()
+        return ids
+
+    def as_retriever(self, **kwargs: Any) -> RedisVectorStoreRetriever:
+        tags = kwargs.pop("tags", None) or []
+        tags.extend(self._get_retriever_tags())
+        return RedisVectorStoreRetriever(vectorstore=self, **kwargs, tags=tags)
+
+    @deprecated("0.0.1", alternative="similarity_search(distance_threshold=0.1)")
+    def similarity_search_limit_score(
+        self, query: str, k: int = 4, score_threshold: float = 0.2, **kwargs: Any
+    ) -> List[Document]:
+        """
+        Returns the most similar indexed documents to the query text within the
+        score_threshold range.
+
+        Deprecated: Use similarity_search with distance_threshold instead.
+
+        Args:
+            query (str): The query text for which to find similar documents.
+            k (int): The number of documents to return. Default is 4.
+            score_threshold (float): The minimum matching *distance* required
+                for a document to be considered a match. Defaults to 0.2.
+
+        Returns:
+            List[Document]: A list of documents that are most similar to the query text
+                including the match score for each document.
+
+        Note:
+            If there are no documents that satisfy the score_threshold value,
+            an empty list is returned.
+
+        """
+        return self.similarity_search(
+            query, k=k, distance_threshold=score_threshold, **kwargs
+        )
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[RedisFilterExpression] = None,
+        return_metadata: bool = True,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search with **vector distance**.
+
+        The "scores" returned from this function are the raw vector
+        distances from the query vector. For similarity scores, use
+        ``similarity_search_with_relevance_scores``.
+
+        Args:
+            query (str): The query text for which to find similar documents.
+            k (int): The number of documents to return. Default is 4.
+            filter (RedisFilterExpression, optional): Optional metadata filter.
+                Defaults to None.
+            return_metadata (bool, optional): Whether to return metadata.
+                Defaults to True.
+
+        Returns:
+            List[Tuple[Document, float]]: A list of documents that are
+                most similar to the query with the distance for each document.
+        """
+        try:
+            import redis
+
+        except ImportError as e:
+            raise ImportError(
+                "Could not import redis python package. "
+                "Please install it with `pip install redis`."
+            ) from e
+
+        if "score_threshold" in kwargs:
+            logger.warning(
+                "score_threshold is deprecated. Use distance_threshold instead."
+                + "score_threshold should only be used in "
+                + "similarity_search_with_relevance_scores."
+                + "score_threshold will be removed in a future release.",
+            )
+
+        query_embedding = self._embeddings.embed_query(query)
+
+        redis_query, params_dict = self._prepare_query(
+            query_embedding,
+            k=k,
+            filter=filter,
+            with_metadata=return_metadata,
+            with_distance=True,
+            **kwargs,
+        )
+
+        # Perform vector search
+        # ignore type because redis-py is wrong about bytes
+        try:
+            results = self.client.ft(self.index_name).search(redis_query, params_dict)  # type: ignore  # noqa: E501
+        except redis.exceptions.ResponseError as e:
+            # split error message and see if it starts with "Syntax"
+            if str(e).split(" ")[0] == "Syntax":
+                raise ValueError(
+                    "Query failed with syntax error. "
+                    + "This is likely due to malformation of "
+                    + "filter, vector, or query argument"
+                ) from e
+            raise e
+
+        # Prepare document results
+        docs_with_scores: List[Tuple[Document, float]] = []
+        for result in results.docs:
+            metadata = {}
+            if return_metadata:
+                metadata = {"id": result.id}
+                metadata.update(self._collect_metadata(result))
+
+            doc = Document(page_content=result.content, metadata=metadata)
+            distance = self._calculate_fp_distance(result.distance)
+            docs_with_scores.append((doc, distance))
+
+        return docs_with_scores
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[RedisFilterExpression] = None,
+        return_metadata: bool = True,
+        distance_threshold: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search
+
+        Args:
+            query (str): The query text for which to find similar documents.
+            k (int): The number of documents to return. Default is 4.
+            filter (RedisFilterExpression, optional): Optional metadata filter.
+                Defaults to None.
+            return_metadata (bool, optional): Whether to return metadata.
+                Defaults to True.
+            distance_threshold (Optional[float], optional): Maximum vector distance
+                between selected documents and the query vector. Defaults to None.
+
+        Returns:
+            List[Document]: A list of documents that are most similar to the query
+                text.
+        """
+        query_embedding = self._embeddings.embed_query(query)
+        return self.similarity_search_by_vector(
+            query_embedding,
+            k=k,
+            filter=filter,
+            return_metadata=return_metadata,
+            distance_threshold=distance_threshold,
+            **kwargs,
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[RedisFilterExpression] = None,
+        return_metadata: bool = True,
+        distance_threshold: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search between a query vector and the indexed vectors.
+
+        Args:
+            embedding (List[float]): The query vector for which to find similar
+                documents.
+            k (int): The number of documents to return. Default is 4.
+            filter (RedisFilterExpression, optional): Optional metadata filter.
+                Defaults to None.
+            return_metadata (bool, optional): Whether to return metadata.
+                Defaults to True.
+            distance_threshold (Optional[float], optional): Maximum vector distance
+                between selected documents and the query vector. Defaults to None.
+
+        Returns:
+            List[Document]: A list of documents that are most similar to the query
+                text.
+        """
+        try:
+            import redis
+
+        except ImportError as e:
+            raise ImportError(
+                "Could not import redis python package. "
+                "Please install it with `pip install redis`."
+            ) from e
+
+        if "score_threshold" in kwargs:
+            logger.warning(
+                "score_threshold is deprecated. Use distance_threshold instead."
+                + "score_threshold should only be used in "
+                + "similarity_search_with_relevance_scores."
+                + "score_threshold will be removed in a future release.",
+            )
+
+        redis_query, params_dict = self._prepare_query(
+            embedding,
+            k=k,
+            filter=filter,
+            distance_threshold=distance_threshold,
+            with_metadata=return_metadata,
+            with_distance=False,
+        )
+
+        # Perform vector search
+        # ignore type because redis-py is wrong about bytes
+        try:
+            results = self.client.ft(self.index_name).search(redis_query, params_dict)  # type: ignore  # noqa: E501
+        except redis.exceptions.ResponseError as e:
+            # split error message and see if it starts with "Syntax"
+            if str(e).split(" ")[0] == "Syntax":
+                raise ValueError(
+                    "Query failed with syntax error. "
+                    + "This is likely due to malformation of "
+                    + "filter, vector, or query argument"
+                ) from e
+            raise e
+
+        # Prepare document results
+        docs = []
+        for result in results.docs:
+            metadata = {}
+            if return_metadata:
+                metadata = {"id": result.id}
+                metadata.update(self._collect_metadata(result))
+
+            content_key = self._schema.content_key
+            docs.append(
+                Document(page_content=getattr(result, content_key), metadata=metadata)
+            )
+        return docs
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[RedisFilterExpression] = None,
+        return_metadata: bool = True,
+        distance_threshold: Optional[float] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+            among selected documents.
+
+        Args:
+            query (str): Text to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 4.
+            fetch_k (int): Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult (float): Number between 0 and 1 that determines the degree
+                of diversity among the results with 0 corresponding
+                to maximum diversity and 1 to minimum diversity.
+                Defaults to 0.5.
+            filter (RedisFilterExpression, optional): Optional metadata filter.
+                Defaults to None.
+            return_metadata (bool, optional): Whether to return metadata.
+                Defaults to True.
+            distance_threshold (Optional[float], optional): Maximum vector distance
+                between selected documents and the query vector. Defaults to None.
+
+        Returns:
+            List[Document]: A list of Documents selected by maximal marginal relevance.
+        """
+        # Embed the query
+        query_embedding = self._embeddings.embed_query(query)
+
+        # Fetch the initial documents
+        prefetch_docs = self.similarity_search_by_vector(
+            query_embedding,
+            k=fetch_k,
+            filter=filter,
+            return_metadata=return_metadata,
+            distance_threshold=distance_threshold,
+            **kwargs,
+        )
+        prefetch_ids = [doc.metadata["id"] for doc in prefetch_docs]
+
+        # Get the embeddings for the fetched documents
+        prefetch_embeddings = [
+            _buffer_to_array(
+                cast(
+                    bytes,
+                    self.client.hget(prefetch_id, self._schema.content_vector_key),
+                ),
+                dtype=self._schema.vector_dtype,
+            )
+            for prefetch_id in prefetch_ids
+        ]
+
+        # Select documents using maximal marginal relevance
+        selected_indices = maximal_marginal_relevance(
+            np.array(query_embedding), prefetch_embeddings, lambda_mult=lambda_mult, k=k
+        )
+        selected_docs = [prefetch_docs[i] for i in selected_indices]
+
+        return selected_docs
+
+    def _collect_metadata(self, result: "Document") -> Dict[str, Any]:
+        """Collect metadata from Redis.
+
+        Method ensures that there isn't a mismatch between the metadata
+        and the index schema passed to this class by the user or generated
+        by this class.
+
+        Args:
+            result (Document): redis.commands.search.Document object returned
+                from Redis.
+
+        Returns:
+            Dict[str, Any]: Collected metadata.
+        """
+        # new metadata dict as modified by this method
+        meta = {}
+        for key in self._schema.metadata_keys:
+            try:
+                meta[key] = getattr(result, key)
+            except AttributeError:
+                # warning about attribute missing
+                logger.warning(
+                    f"Metadata key {key} not found in metadata. "
+                    + "Setting to None. \n"
+                    + "Metadata fields defined for this instance: "
+                    + f"{self._schema.metadata_keys}"
+                )
+                meta[key] = None
+        return meta
+
+    def _prepare_query(
+        self,
+        query_embedding: List[float],
+        k: int = 4,
+        filter: Optional[RedisFilterExpression] = None,
+        distance_threshold: Optional[float] = None,
+        with_metadata: bool = True,
+        with_distance: bool = False,
+    ) -> Tuple["Query", Dict[str, Any]]:
+        # Creates Redis query
+        params_dict: Dict[str, Union[str, bytes, float]] = {
+            "vector": _array_to_buffer(query_embedding, self._schema.vector_dtype),
+        }
+
+        # prepare return fields including score
+        return_fields = [self._schema.content_key]
+        if with_distance:
+            return_fields.append("distance")
+        if with_metadata:
+            return_fields.extend(self._schema.metadata_keys)
+
+        if distance_threshold:
+            params_dict["distance_threshold"] = distance_threshold
+            return (
+                self._prepare_range_query(
+                    k, filter=filter, return_fields=return_fields
+                ),
+                params_dict,
+            )
+        return (
+            self._prepare_vector_query(k, filter=filter, return_fields=return_fields),
+            params_dict,
+        )
+
+    def _prepare_range_query(
+        self,
+        k: int,
+        filter: Optional[RedisFilterExpression] = None,
+        return_fields: Optional[List[str]] = None,
+    ) -> "Query":
+        try:
+            from redis.commands.search.query import Query
+        except ImportError as e:
+            raise ImportError(
+                "Could not import redis python package. "
+                "Please install it with `pip install redis`."
+            ) from e
+        return_fields = return_fields or []
+        vector_key = self._schema.content_vector_key
+        base_query = f"@{vector_key}:[VECTOR_RANGE $distance_threshold $vector]"
+
+        if filter:
+            base_query = str(filter) + " " + base_query
+
+        query_string = base_query + "=>{$yield_distance_as: distance}"
+
+        return (
+            Query(query_string)
+            .return_fields(*return_fields)
+            .sort_by("distance")
+            .paging(0, k)
+            .dialect(2)
+        )
+
+    def _prepare_vector_query(
+        self,
+        k: int,
+        filter: Optional[RedisFilterExpression] = None,
+        return_fields: Optional[List[str]] = None,
+    ) -> "Query":
+        """Prepare query for vector search.
+
+        Args:
+            k: Number of results to return.
+            filter: Optional metadata filter.
+
+        Returns:
+            query: Query object.
+        """
+        try:
+            from redis.commands.search.query import Query
+        except ImportError as e:
+            raise ImportError(
+                "Could not import redis python package. "
+                "Please install it with `pip install redis`."
+            ) from e
+        return_fields = return_fields or []
+        query_prefix = "*"
+        if filter:
+            query_prefix = f"{str(filter)}"
+        vector_key = self._schema.content_vector_key
+        base_query = f"({query_prefix})=>[KNN {k} @{vector_key} $vector AS distance]"
+
+        query = (
+            Query(base_query)
+            .return_fields(*return_fields)
+            .sort_by("distance")
+            .paging(0, k)
+            .dialect(2)
+        )
+        return query
+
+    def _get_schema_with_defaults(
+        self,
+        index_schema: Optional[Union[Dict[str, ListOfDict], str, os.PathLike]] = None,
+        vector_schema: Optional[Dict[str, Union[str, int]]] = None,
+    ) -> "RedisModel":
+        # should only be called after init of Redis (so Import handled)
+        from langchain_community.vectorstores.redis.schema import (
+            RedisModel,
+            read_schema,
+        )
+
+        schema = RedisModel()
+        # read in schema (yaml file or dict) and
+        # pass to the Pydantic validators
+        if index_schema:
+            schema_values = read_schema(index_schema)  # type: ignore
+            schema = RedisModel(**schema_values)
+
+            # ensure user did not exclude the content field
+            # no modifications if content field found
+            schema.add_content_field()
+
+        # if no content_vector field, add vector field to schema
+        # this makes adding a vector field to the schema optional when
+        # the user just wants additional metadata
+        try:
+            # see if user overrode the content vector
+            schema.content_vector
+            # if user overrode the content vector, check if they
+            # also passed vector schema. This won't be used since
+            # the index schema overrode the content vector
+            if vector_schema:
+                logger.warning(
+                    "`vector_schema` is ignored since content_vector is "
+                    + "overridden in `index_schema`."
+                )
+
+        # user did not override content vector
+        except ValueError:
+            # set default vector schema and update with user provided schema
+            # if the user provided any
+            vector_field = self.DEFAULT_VECTOR_SCHEMA.copy()
+            if vector_schema:
+                vector_field.update(vector_schema)
+
+            # add the vector field either way
+            schema.add_vector_field(vector_field)
+        return schema
+
+    def _create_index_if_not_exist(self, dim: int = 1536) -> None:
+        try:
+            from redis.commands.search.indexDefinition import (  # type: ignore
+                IndexDefinition,
+                IndexType,
+            )
+
+        except ImportError:
+            raise ImportError(
+                "Could not import redis python package. "
+                "Please install it with `pip install redis`."
+            )
+
+        # Set vector dimension
+        # can't obtain beforehand because we don't
+        # know which embedding model is being used.
+        self._schema.content_vector.dims = dim
+
+        # Check if index exists
+        if not check_index_exists(self.client, self.index_name):
+            # Create Redis Index
+            self.client.ft(self.index_name).create_index(
+                fields=self._schema.get_fields(),
+                definition=IndexDefinition(
+                    prefix=[self.key_prefix], index_type=IndexType.HASH
+                ),
+            )
+
+    def _calculate_fp_distance(self, distance: str) -> float:
+        """Calculate the distance based on the vector datatype
+
+        Two datatypes supported:
+        - FLOAT32
+        - FLOAT64
+
+        if it's FLOAT32, we need to round the distance to 4 decimal places
+        otherwise, round to 7 decimal places.
+        """
+        if self._schema.content_vector.datatype == "FLOAT32":
+            return round(float(distance), 4)
+        return round(float(distance), 7)
+
+    def _check_deprecated_kwargs(self, kwargs: Mapping[str, Any]) -> None:
+        """Check for deprecated kwargs."""
+
+        deprecated_kwargs = {
+            "redis_host": "redis_url",
+            "redis_port": "redis_url",
+            "redis_password": "redis_url",
+            "content_key": "index_schema",
+            "vector_key": "vector_schema",
+            "distance_metric": "vector_schema",
+        }
+        for key, value in kwargs.items():
+            if key in deprecated_kwargs:
+                raise ValueError(
+                    f"Keyword argument '{key}' is deprecated. "
+                    f"Please use '{deprecated_kwargs[key]}' instead."
+                )
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        if self.relevance_score_fn:
+            return self.relevance_score_fn
+
+        metric_map = {
+            "COSINE": self._cosine_relevance_score_fn,
+            "IP": self._max_inner_product_relevance_score_fn,
+            "L2": self._euclidean_relevance_score_fn,
+        }
+        try:
+            return metric_map[self._schema.content_vector.distance_metric]
+        except KeyError:
+            return _default_relevance_score
+
+
+def _generate_field_schema(data: Dict[str, Any]) -> Dict[str, Any]:
+    """
+    Generate a schema for the search index in Redis based on the input metadata.
+
+    Given a dictionary of metadata, this function categorizes each metadata
+        field into one of the three categories:
+    - text: The field contains textual data.
+    - numeric: The field contains numeric data (either integer or float).
+    - tag: The field contains list of tags (strings).
+
+    Args
+        data (Dict[str, Any]): A dictionary where keys are metadata field names
+            and values are the metadata values.
+
+    Returns:
+        Dict[str, Any]: A dictionary with three keys "text", "numeric", and "tag".
+            Each key maps to a list of fields that belong to that category.
+
+    Raises:
+        ValueError: If a metadata field cannot be categorized into any of
+            the three known types.
+    """
+    result: Dict[str, Any] = {
+        "text": [],
+        "numeric": [],
+        "tag": [],
+    }
+
+    for key, value in data.items():
+        # Numeric fields
+        try:
+            int(value)
+            result["numeric"].append({"name": key})
+            continue
+        except (ValueError, TypeError):
+            pass
+
+        # None values are not indexed as of now
+        if value is None:
+            continue
+
+        # if it's a list of strings, we assume it's a tag
+        if isinstance(value, (list, tuple)):
+            if not value or isinstance(value[0], str):
+                result["tag"].append({"name": key})
+            else:
+                name = type(value[0]).__name__
+                raise ValueError(
+                    f"List/tuple values should contain strings: '{key}': {name}"
+                )
+            continue
+
+        # Check if value is string before processing further
+        if isinstance(value, str):
+            result["text"].append({"name": key})
+            continue
+
+        # Unable to classify the field value
+        name = type(value).__name__
+        raise ValueError(
+            "Could not generate Redis index field type mapping "
+            + f"for metadata: '{key}': {name}"
+        )
+
+    return result
+
+
+def _prepare_metadata(metadata: Dict[str, Any]) -> Dict[str, Any]:
+    """
+    Prepare metadata for indexing in Redis by sanitizing its values.
+
+    - String, integer, and float values remain unchanged.
+    - None or empty values are replaced with empty strings.
+    - Lists/tuples of strings are joined into a single string with a comma separator.
+
+    Args:
+        metadata (Dict[str, Any]): A dictionary where keys are metadata
+            field names and values are the metadata values.
+
+    Returns:
+        Dict[str, Any]: A sanitized dictionary ready for indexing in Redis.
+
+    Raises:
+        ValueError: If any metadata value is not one of the known
+            types (string, int, float, or list of strings).
+    """
+
+    def raise_error(key: str, value: Any) -> None:
+        raise ValueError(
+            f"Metadata value for key '{key}' must be a string, int, "
+            + f"float, or list of strings. Got {type(value).__name__}"
+        )
+
+    clean_meta: Dict[str, Union[str, float, int]] = {}
+    for key, value in metadata.items():
+        if value is None:
+            clean_meta[key] = ""
+            continue
+
+        # No transformation needed
+        if isinstance(value, (str, int, float)):
+            clean_meta[key] = value
+
+        # if it's a list/tuple of strings, we join it
+        elif isinstance(value, (list, tuple)):
+            if not value or isinstance(value[0], str):
+                clean_meta[key] = REDIS_TAG_SEPARATOR.join(value)
+            else:
+                raise_error(key, value)
+        else:
+            raise_error(key, value)
+    return clean_meta
+
+
+class RedisVectorStoreRetriever(VectorStoreRetriever):
+    """Retriever for Redis VectorStore."""
+
+    vectorstore: Redis
+    """Redis VectorStore."""
+    search_type: str = "similarity"
+    """Type of search to perform. Can be either
+    'similarity',
+    'similarity_distance_threshold',
+    'similarity_score_threshold'
+    """
+
+    search_kwargs: Dict[str, Any] = {
+        "k": 4,
+        "score_threshold": 0.9,
+        # set to None to avoid distance used in score_threshold search
+        "distance_threshold": None,
+    }
+    """Default search kwargs."""
+
+    allowed_search_types = [
+        "similarity",
+        "similarity_distance_threshold",
+        "similarity_score_threshold",
+        "mmr",
+    ]
+    """Allowed search types."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        if self.search_type == "similarity":
+            docs = self.vectorstore.similarity_search(query, **self.search_kwargs)
+        elif self.search_type == "similarity_distance_threshold":
+            if self.search_kwargs["distance_threshold"] is None:
+                raise ValueError(
+                    "distance_threshold must be provided for "
+                    + "similarity_distance_threshold retriever"
+                )
+            docs = self.vectorstore.similarity_search(query, **self.search_kwargs)
+
+        elif self.search_type == "similarity_score_threshold":
+            docs_and_similarities = (
+                self.vectorstore.similarity_search_with_relevance_scores(
+                    query, **self.search_kwargs
+                )
+            )
+            docs = [doc for doc, _ in docs_and_similarities]
+        elif self.search_type == "mmr":
+            docs = self.vectorstore.max_marginal_relevance_search(
+                query, **self.search_kwargs
+            )
+        else:
+            raise ValueError(f"search_type of {self.search_type} not allowed.")
+        return docs
+
+    async def _aget_relevant_documents(
+        self, query: str, *, run_manager: AsyncCallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        if self.search_type == "similarity":
+            docs = await self.vectorstore.asimilarity_search(
+                query, **self.search_kwargs
+            )
+        elif self.search_type == "similarity_distance_threshold":
+            if self.search_kwargs["distance_threshold"] is None:
+                raise ValueError(
+                    "distance_threshold must be provided for "
+                    + "similarity_distance_threshold retriever"
+                )
+            docs = await self.vectorstore.asimilarity_search(
+                query, **self.search_kwargs
+            )
+        elif self.search_type == "similarity_score_threshold":
+            docs_and_similarities = (
+                await self.vectorstore.asimilarity_search_with_relevance_scores(
+                    query, **self.search_kwargs
+                )
+            )
+            docs = [doc for doc, _ in docs_and_similarities]
+        elif self.search_type == "mmr":
+            docs = await self.vectorstore.amax_marginal_relevance_search(
+                query, **self.search_kwargs
+            )
+        else:
+            raise ValueError(f"search_type of {self.search_type} not allowed.")
+        return docs
+
+    def add_documents(self, documents: List[Document], **kwargs: Any) -> List[str]:
+        """Add documents to vectorstore."""
+        return self.vectorstore.add_documents(documents, **kwargs)
+
+    async def aadd_documents(
+        self, documents: List[Document], **kwargs: Any
+    ) -> List[str]:
+        """Add documents to vectorstore."""
+        return await self.vectorstore.aadd_documents(documents, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/redis/constants.py b/llm/Lib/site-packages/langchain_community/vectorstores/redis/constants.py
new file mode 100644
index 0000000000000000000000000000000000000000..ddbfe4c58474ceb040610032377047580eb3475f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/redis/constants.py
@@ -0,0 +1,20 @@
+from typing import Any, Dict, List
+
+import numpy as np
+
+# required modules
+REDIS_REQUIRED_MODULES = [
+    {"name": "search", "ver": 20600},
+    {"name": "searchlight", "ver": 20600},
+]
+
+# distance metrics
+REDIS_DISTANCE_METRICS: List[str] = ["COSINE", "IP", "L2"]
+
+# supported vector datatypes
+REDIS_VECTOR_DTYPE_MAP: Dict[str, Any] = {
+    "FLOAT32": np.float32,
+    "FLOAT64": np.float64,
+}
+
+REDIS_TAG_SEPARATOR = ","
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/redis/filters.py b/llm/Lib/site-packages/langchain_community/vectorstores/redis/filters.py
new file mode 100644
index 0000000000000000000000000000000000000000..09a58bd281dcfe1c503f18e9a1df6151f6165b4f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/redis/filters.py
@@ -0,0 +1,462 @@
+from enum import Enum
+from functools import wraps
+from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Union
+
+from langchain_community.utilities.redis import TokenEscaper
+
+# disable mypy error for dunder method overrides
+# mypy: disable-error-code="override"
+
+
+class RedisFilterOperator(Enum):
+    """RedisFilterOperator enumerator is used to create RedisFilterExpressions."""
+
+    EQ = 1
+    NE = 2
+    LT = 3
+    GT = 4
+    LE = 5
+    GE = 6
+    OR = 7
+    AND = 8
+    LIKE = 9
+    IN = 10
+
+
+class RedisFilter:
+    """Collection of RedisFilterFields."""
+
+    @staticmethod
+    def text(field: str) -> "RedisText":
+        return RedisText(field)
+
+    @staticmethod
+    def num(field: str) -> "RedisNum":
+        return RedisNum(field)
+
+    @staticmethod
+    def tag(field: str) -> "RedisTag":
+        return RedisTag(field)
+
+
+class RedisFilterField:
+    """Base class for RedisFilterFields."""
+
+    escaper: "TokenEscaper" = TokenEscaper()
+    OPERATORS: Dict[RedisFilterOperator, str] = {}
+
+    def __init__(self, field: str):
+        self._field = field
+        self._value: Any = None
+        self._operator: RedisFilterOperator = RedisFilterOperator.EQ
+
+    def equals(self, other: "RedisFilterField") -> bool:
+        if not isinstance(other, type(self)):
+            return False
+        return self._field == other._field and self._value == other._value
+
+    def _set_value(
+        self, val: Any, val_type: Tuple[Any], operator: RedisFilterOperator
+    ) -> None:
+        # check that the operator is supported by this class
+        if operator not in self.OPERATORS:
+            raise ValueError(
+                f"Operator {operator} not supported by {self.__class__.__name__}. "
+                + f"Supported operators are {self.OPERATORS.values()}."
+            )
+
+        if not isinstance(val, val_type):
+            raise TypeError(
+                f"Right side argument passed to operator {self.OPERATORS[operator]} "
+                f"with left side "
+                f"argument {self.__class__.__name__} must be of type {val_type}, "
+                f"received value {val}"
+            )
+        self._value = val
+        self._operator = operator
+
+
+def check_operator_misuse(func: Callable) -> Callable:
+    """Decorator to check for misuse of equality operators."""
+
+    @wraps(func)
+    def wrapper(instance: Any, *args: Any, **kwargs: Any) -> Any:
+        # Extracting 'other' from positional arguments or keyword arguments
+        other = kwargs.get("other") if "other" in kwargs else None
+        if not other:
+            for arg in args:
+                if isinstance(arg, type(instance)):
+                    other = arg
+                    break
+
+        if isinstance(other, type(instance)):
+            raise ValueError(
+                "Equality operators are overridden for FilterExpression creation. Use "
+                ".equals() for equality checks"
+            )
+        return func(instance, *args, **kwargs)
+
+    return wrapper
+
+
+class RedisTag(RedisFilterField):
+    """RedisFilterField representing a tag in a Redis index."""
+
+    OPERATORS: Dict[RedisFilterOperator, str] = {
+        RedisFilterOperator.EQ: "==",
+        RedisFilterOperator.NE: "!=",
+        RedisFilterOperator.IN: "==",
+    }
+    OPERATOR_MAP: Dict[RedisFilterOperator, str] = {
+        RedisFilterOperator.EQ: "@%s:{%s}",
+        RedisFilterOperator.NE: "(-@%s:{%s})",
+        RedisFilterOperator.IN: "@%s:{%s}",
+    }
+    SUPPORTED_VAL_TYPES = (list, set, tuple, str, type(None))
+
+    def __init__(self, field: str):
+        """Create a RedisTag FilterField.
+
+        Args:
+            field (str): The name of the RedisTag field in the index to be queried
+                against.
+        """
+        super().__init__(field)
+
+    def _set_tag_value(
+        self,
+        other: Union[List[str], Set[str], Tuple[str], str],
+        operator: RedisFilterOperator,
+    ) -> None:
+        if isinstance(other, (list, set, tuple)):
+            try:
+                # "if val" clause removes non-truthy values from list
+                other = [str(val) for val in other if val]
+            except ValueError:
+                raise ValueError("All tags within collection must be strings")
+        # above to catch the "" case
+        elif not other:
+            other = []
+        elif isinstance(other, str):
+            other = [other]
+
+        self._set_value(other, self.SUPPORTED_VAL_TYPES, operator)  # type: ignore
+
+    @check_operator_misuse
+    def __eq__(
+        self, other: Union[List[str], Set[str], Tuple[str], str]
+    ) -> "RedisFilterExpression":
+        """Create a RedisTag equality filter expression.
+
+        Args:
+            other (Union[List[str], Set[str], Tuple[str], str]):
+                The tag(s) to filter on.
+
+        Example:
+            >>> from langchain_community.vectorstores.redis import RedisTag
+            >>> filter = RedisTag("brand") == "nike"
+        """
+        self._set_tag_value(other, RedisFilterOperator.EQ)
+        return RedisFilterExpression(str(self))
+
+    @check_operator_misuse
+    def __ne__(
+        self, other: Union[List[str], Set[str], Tuple[str], str]
+    ) -> "RedisFilterExpression":
+        """Create a RedisTag inequality filter expression.
+
+        Args:
+            other (Union[List[str], Set[str], Tuple[str], str]):
+                The tag(s) to filter on.
+
+        Example:
+            >>> from langchain_community.vectorstores.redis import RedisTag
+            >>> filter = RedisTag("brand") != "nike"
+        """
+        self._set_tag_value(other, RedisFilterOperator.NE)
+        return RedisFilterExpression(str(self))
+
+    @property
+    def _formatted_tag_value(self) -> str:
+        return "|".join([self.escaper.escape(tag) for tag in self._value])
+
+    def __str__(self) -> str:
+        """Return the query syntax for a RedisTag filter expression."""
+        if not self._value:
+            return "*"
+
+        return self.OPERATOR_MAP[self._operator] % (
+            self._field,
+            self._formatted_tag_value,
+        )
+
+
+class RedisNum(RedisFilterField):
+    """RedisFilterField representing a numeric field in a Redis index."""
+
+    OPERATORS: Dict[RedisFilterOperator, str] = {
+        RedisFilterOperator.EQ: "==",
+        RedisFilterOperator.NE: "!=",
+        RedisFilterOperator.LT: "<",
+        RedisFilterOperator.GT: ">",
+        RedisFilterOperator.LE: "<=",
+        RedisFilterOperator.GE: ">=",
+    }
+    OPERATOR_MAP: Dict[RedisFilterOperator, str] = {
+        RedisFilterOperator.EQ: "@%s:[%s %s]",
+        RedisFilterOperator.NE: "(-@%s:[%s %s])",
+        RedisFilterOperator.GT: "@%s:[(%s +inf]",
+        RedisFilterOperator.LT: "@%s:[-inf (%s]",
+        RedisFilterOperator.GE: "@%s:[%s +inf]",
+        RedisFilterOperator.LE: "@%s:[-inf %s]",
+    }
+    SUPPORTED_VAL_TYPES = (int, float, type(None))
+
+    def __str__(self) -> str:
+        """Return the query syntax for a RedisNum filter expression."""
+        if self._value is None:
+            return "*"
+
+        if (
+            self._operator == RedisFilterOperator.EQ
+            or self._operator == RedisFilterOperator.NE
+        ):
+            return self.OPERATOR_MAP[self._operator] % (
+                self._field,
+                self._value,
+                self._value,
+            )
+        else:
+            return self.OPERATOR_MAP[self._operator] % (self._field, self._value)
+
+    @check_operator_misuse
+    def __eq__(self, other: Union[int, float]) -> "RedisFilterExpression":
+        """Create a Numeric equality filter expression.
+
+        Args:
+            other (Union[int, float]): The value to filter on.
+
+        Example:
+            >>> from langchain_community.vectorstores.redis import RedisNum
+            >>> filter = RedisNum("zipcode") == 90210
+        """
+        self._set_value(other, self.SUPPORTED_VAL_TYPES, RedisFilterOperator.EQ)  # type: ignore
+        return RedisFilterExpression(str(self))
+
+    @check_operator_misuse
+    def __ne__(self, other: Union[int, float]) -> "RedisFilterExpression":
+        """Create a Numeric inequality filter expression.
+
+        Args:
+            other (Union[int, float]): The value to filter on.
+
+        Example:
+            >>> from langchain_community.vectorstores.redis import RedisNum
+            >>> filter = RedisNum("zipcode") != 90210
+        """
+        self._set_value(other, self.SUPPORTED_VAL_TYPES, RedisFilterOperator.NE)  # type: ignore
+        return RedisFilterExpression(str(self))
+
+    def __gt__(self, other: Union[int, float]) -> "RedisFilterExpression":
+        """Create a Numeric greater than filter expression.
+
+        Args:
+            other (Union[int, float]): The value to filter on.
+
+        Example:
+            >>> from langchain_community.vectorstores.redis import RedisNum
+            >>> filter = RedisNum("age") > 18
+        """
+        self._set_value(other, self.SUPPORTED_VAL_TYPES, RedisFilterOperator.GT)  # type: ignore
+        return RedisFilterExpression(str(self))
+
+    def __lt__(self, other: Union[int, float]) -> "RedisFilterExpression":
+        """Create a Numeric less than filter expression.
+
+        Args:
+            other (Union[int, float]): The value to filter on.
+
+        Example:
+            >>> from langchain_community.vectorstores.redis import RedisNum
+            >>> filter = RedisNum("age") < 18
+        """
+        self._set_value(other, self.SUPPORTED_VAL_TYPES, RedisFilterOperator.LT)  # type: ignore
+        return RedisFilterExpression(str(self))
+
+    def __ge__(self, other: Union[int, float]) -> "RedisFilterExpression":
+        """Create a Numeric greater than or equal to filter expression.
+
+        Args:
+            other (Union[int, float]): The value to filter on.
+
+        Example:
+            >>> from langchain_community.vectorstores.redis import RedisNum
+            >>> filter = RedisNum("age") >= 18
+        """
+        self._set_value(other, self.SUPPORTED_VAL_TYPES, RedisFilterOperator.GE)  # type: ignore
+        return RedisFilterExpression(str(self))
+
+    def __le__(self, other: Union[int, float]) -> "RedisFilterExpression":
+        """Create a Numeric less than or equal to filter expression.
+
+        Args:
+            other (Union[int, float]): The value to filter on.
+
+        Example:
+            >>> from langchain_community.vectorstores.redis import RedisNum
+            >>> filter = RedisNum("age") <= 18
+        """
+        self._set_value(other, self.SUPPORTED_VAL_TYPES, RedisFilterOperator.LE)  # type: ignore
+        return RedisFilterExpression(str(self))
+
+
+class RedisText(RedisFilterField):
+    """RedisFilterField representing a text field in a Redis index."""
+
+    OPERATORS: Dict[RedisFilterOperator, str] = {
+        RedisFilterOperator.EQ: "==",
+        RedisFilterOperator.NE: "!=",
+        RedisFilterOperator.LIKE: "%",
+    }
+    OPERATOR_MAP: Dict[RedisFilterOperator, str] = {
+        RedisFilterOperator.EQ: '@%s:("%s")',
+        RedisFilterOperator.NE: '(-@%s:"%s")',
+        RedisFilterOperator.LIKE: "@%s:(%s)",
+    }
+    SUPPORTED_VAL_TYPES = (str, type(None))
+
+    @check_operator_misuse
+    def __eq__(self, other: str) -> "RedisFilterExpression":
+        """Create a RedisText equality (exact match) filter expression.
+
+        Args:
+            other (str): The text value to filter on.
+
+        Example:
+            >>> from langchain_community.vectorstores.redis import RedisText
+            >>> filter = RedisText("job") == "engineer"
+        """
+        self._set_value(other, self.SUPPORTED_VAL_TYPES, RedisFilterOperator.EQ)  # type: ignore
+        return RedisFilterExpression(str(self))
+
+    @check_operator_misuse
+    def __ne__(self, other: str) -> "RedisFilterExpression":
+        """Create a RedisText inequality filter expression.
+
+        Args:
+            other (str): The text value to filter on.
+
+        Example:
+            >>> from langchain_community.vectorstores.redis import RedisText
+            >>> filter = RedisText("job") != "engineer"
+        """
+        self._set_value(other, self.SUPPORTED_VAL_TYPES, RedisFilterOperator.NE)  # type: ignore
+        return RedisFilterExpression(str(self))
+
+    def __mod__(self, other: str) -> "RedisFilterExpression":
+        """Create a RedisText "LIKE" filter expression.
+
+        Args:
+            other (str): The text value to filter on.
+
+        Example:
+            >>> from langchain_community.vectorstores.redis import RedisText
+            >>> filter = RedisText("job") % "engine*"         # suffix wild card match
+            >>> filter = RedisText("job") % "%%engine%%"      # fuzzy match w/ LD
+            >>> filter = RedisText("job") % "engineer|doctor" # contains either term
+            >>> filter = RedisText("job") % "engineer doctor" # contains both terms
+        """
+        self._set_value(other, self.SUPPORTED_VAL_TYPES, RedisFilterOperator.LIKE)  # type: ignore
+        return RedisFilterExpression(str(self))
+
+    def __str__(self) -> str:
+        """Return the query syntax for a RedisText filter expression."""
+        if not self._value:
+            return "*"
+
+        return self.OPERATOR_MAP[self._operator] % (
+            self._field,
+            self._value,
+        )
+
+
+class RedisFilterExpression:
+    """Logical expression of RedisFilterFields.
+
+    RedisFilterExpressions can be combined using the & and | operators to create
+    complex logical expressions that evaluate to the Redis Query language.
+
+    This presents an interface by which users can create complex queries
+    without having to know the Redis Query language.
+
+    Filter expressions are not initialized directly. Instead they are built
+    by combining RedisFilterFields using the & and | operators.
+
+    Examples:
+
+        >>> from langchain_community.vectorstores.redis import RedisTag, RedisNum
+        >>> brand_is_nike = RedisTag("brand") == "nike"
+        >>> price_is_under_100 = RedisNum("price") < 100
+        >>> filter = brand_is_nike & price_is_under_100
+        >>> print(str(filter))
+        (@brand:{nike} @price:[-inf (100)])
+
+    """
+
+    def __init__(
+        self,
+        _filter: Optional[str] = None,
+        operator: Optional[RedisFilterOperator] = None,
+        left: Optional["RedisFilterExpression"] = None,
+        right: Optional["RedisFilterExpression"] = None,
+    ):
+        self._filter = _filter
+        self._operator = operator
+        self._left = left
+        self._right = right
+
+    def __and__(self, other: "RedisFilterExpression") -> "RedisFilterExpression":
+        return RedisFilterExpression(
+            operator=RedisFilterOperator.AND, left=self, right=other
+        )
+
+    def __or__(self, other: "RedisFilterExpression") -> "RedisFilterExpression":
+        return RedisFilterExpression(
+            operator=RedisFilterOperator.OR, left=self, right=other
+        )
+
+    @staticmethod
+    def format_expression(
+        left: "RedisFilterExpression", right: "RedisFilterExpression", operator_str: str
+    ) -> str:
+        _left, _right = str(left), str(right)
+        if _left == _right == "*":
+            return _left
+        if _left == "*" != _right:
+            return _right
+        if _right == "*" != _left:
+            return _left
+        return f"({_left}{operator_str}{_right})"
+
+    def __str__(self) -> str:
+        # top level check that allows recursive calls to __str__
+        if not self._filter and not self._operator:
+            raise ValueError("Improperly initialized RedisFilterExpression")
+
+        # if there's an operator, combine expressions accordingly
+        if self._operator:
+            if not isinstance(self._left, RedisFilterExpression) or not isinstance(
+                self._right, RedisFilterExpression
+            ):
+                raise TypeError(
+                    "Improper combination of filters."
+                    "Both left and right should be type FilterExpression"
+                )
+
+            operator_str = " | " if self._operator == RedisFilterOperator.OR else " "
+            return self.format_expression(self._left, self._right, operator_str)
+
+        # check that base case, the filter is set
+        if not self._filter:
+            raise ValueError("Improperly initialized RedisFilterExpression")
+        return self._filter
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/redis/schema.py b/llm/Lib/site-packages/langchain_community/vectorstores/redis/schema.py
new file mode 100644
index 0000000000000000000000000000000000000000..5b8618797eb3bcbdddaf6cc2c7b51112ad84b2cd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/redis/schema.py
@@ -0,0 +1,308 @@
+from __future__ import annotations
+
+import os
+from enum import Enum
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Union
+
+import numpy as np
+import yaml
+from langchain_core.pydantic_v1 import BaseModel, Field, validator
+from typing_extensions import TYPE_CHECKING, Literal
+
+from langchain_community.vectorstores.redis.constants import REDIS_VECTOR_DTYPE_MAP
+
+if TYPE_CHECKING:
+    from redis.commands.search.field import (  # type: ignore
+        NumericField,
+        TagField,
+        TextField,
+        VectorField,
+    )
+
+
+class RedisDistanceMetric(str, Enum):
+    """Distance metrics for Redis vector fields."""
+
+    l2 = "L2"
+    cosine = "COSINE"
+    ip = "IP"
+
+
+class RedisField(BaseModel):
+    """Base class for Redis fields."""
+
+    name: str = Field(...)
+
+
+class TextFieldSchema(RedisField):
+    """Schema for text fields in Redis."""
+
+    weight: float = 1
+    no_stem: bool = False
+    phonetic_matcher: Optional[str] = None
+    withsuffixtrie: bool = False
+    no_index: bool = False
+    sortable: Optional[bool] = False
+
+    def as_field(self) -> TextField:
+        from redis.commands.search.field import TextField  # type: ignore
+
+        return TextField(
+            self.name,
+            weight=self.weight,
+            no_stem=self.no_stem,
+            phonetic_matcher=self.phonetic_matcher,  # type: ignore
+            sortable=self.sortable,
+            no_index=self.no_index,
+        )
+
+
+class TagFieldSchema(RedisField):
+    """Schema for tag fields in Redis."""
+
+    separator: str = ","
+    case_sensitive: bool = False
+    no_index: bool = False
+    sortable: Optional[bool] = False
+
+    def as_field(self) -> TagField:
+        from redis.commands.search.field import TagField  # type: ignore
+
+        return TagField(
+            self.name,
+            separator=self.separator,
+            case_sensitive=self.case_sensitive,
+            sortable=self.sortable,
+            no_index=self.no_index,
+        )
+
+
+class NumericFieldSchema(RedisField):
+    """Schema for numeric fields in Redis."""
+
+    no_index: bool = False
+    sortable: Optional[bool] = False
+
+    def as_field(self) -> NumericField:
+        from redis.commands.search.field import NumericField  # type: ignore
+
+        return NumericField(self.name, sortable=self.sortable, no_index=self.no_index)
+
+
+class RedisVectorField(RedisField):
+    """Base class for Redis vector fields."""
+
+    dims: int = Field(...)
+    algorithm: object = Field(...)
+    datatype: str = Field(default="FLOAT32")
+    distance_metric: RedisDistanceMetric = Field(default="COSINE")
+    initial_cap: Optional[int] = None
+
+    @validator("algorithm", "datatype", "distance_metric", pre=True, each_item=True)
+    def uppercase_strings(cls, v: str) -> str:
+        return v.upper()
+
+    @validator("datatype", pre=True)
+    def uppercase_and_check_dtype(cls, v: str) -> str:
+        if v.upper() not in REDIS_VECTOR_DTYPE_MAP:
+            raise ValueError(
+                f"datatype must be one of {REDIS_VECTOR_DTYPE_MAP.keys()}. Got {v}"
+            )
+        return v.upper()
+
+    def _fields(self) -> Dict[str, Any]:
+        field_data = {
+            "TYPE": self.datatype,
+            "DIM": self.dims,
+            "DISTANCE_METRIC": self.distance_metric,
+        }
+        if self.initial_cap is not None:  # Only include it if it's set
+            field_data["INITIAL_CAP"] = self.initial_cap
+        return field_data
+
+
+class FlatVectorField(RedisVectorField):
+    """Schema for flat vector fields in Redis."""
+
+    algorithm: Literal["FLAT"] = "FLAT"
+    block_size: Optional[int] = None
+
+    def as_field(self) -> VectorField:
+        from redis.commands.search.field import VectorField  # type: ignore
+
+        field_data = super()._fields()
+        if self.block_size is not None:
+            field_data["BLOCK_SIZE"] = self.block_size
+        return VectorField(self.name, self.algorithm, field_data)
+
+
+class HNSWVectorField(RedisVectorField):
+    """Schema for HNSW vector fields in Redis."""
+
+    algorithm: Literal["HNSW"] = "HNSW"
+    m: int = Field(default=16)
+    ef_construction: int = Field(default=200)
+    ef_runtime: int = Field(default=10)
+    epsilon: float = Field(default=0.01)
+
+    def as_field(self) -> VectorField:
+        from redis.commands.search.field import VectorField  # type: ignore
+
+        field_data = super()._fields()
+        field_data.update(
+            {
+                "M": self.m,
+                "EF_CONSTRUCTION": self.ef_construction,
+                "EF_RUNTIME": self.ef_runtime,
+                "EPSILON": self.epsilon,
+            }
+        )
+        return VectorField(self.name, self.algorithm, field_data)
+
+
+class RedisModel(BaseModel):
+    """Schema for Redis index."""
+
+    # always have a content field for text
+    text: List[TextFieldSchema] = [TextFieldSchema(name="content")]
+    tag: Optional[List[TagFieldSchema]] = None
+    numeric: Optional[List[NumericFieldSchema]] = None
+    extra: Optional[List[RedisField]] = None
+
+    # filled by default_vector_schema
+    vector: Optional[List[Union[FlatVectorField, HNSWVectorField]]] = None
+    content_key: str = "content"
+    content_vector_key: str = "content_vector"
+
+    def add_content_field(self) -> None:
+        if self.text is None:
+            self.text = []
+        for field in self.text:
+            if field.name == self.content_key:
+                return
+        self.text.append(TextFieldSchema(name=self.content_key))
+
+    def add_vector_field(self, vector_field: Dict[str, Any]) -> None:
+        # catch case where user inputted no vector field spec
+        # in the index schema
+        if self.vector is None:
+            self.vector = []
+
+        # ignore types as pydantic is handling type validation and conversion
+        if vector_field["algorithm"] == "FLAT":
+            self.vector.append(FlatVectorField(**vector_field))  # type: ignore
+        elif vector_field["algorithm"] == "HNSW":
+            self.vector.append(HNSWVectorField(**vector_field))  # type: ignore
+        else:
+            raise ValueError(
+                f"algorithm must be either FLAT or HNSW. Got "
+                f"{vector_field['algorithm']}"
+            )
+
+    def as_dict(self) -> Dict[str, List[Any]]:
+        schemas: Dict[str, List[Any]] = {"text": [], "tag": [], "numeric": []}
+        # iter over all class attributes
+        for attr, attr_value in self.__dict__.items():
+            # only non-empty lists
+            if isinstance(attr_value, list) and len(attr_value) > 0:
+                field_values: List[Dict[str, Any]] = []
+                # iterate over all fields in each category (tag, text, etc)
+                for val in attr_value:
+                    value: Dict[str, Any] = {}
+                    # iterate over values within each field to extract
+                    # settings for that field (i.e. name, weight, etc)
+                    for field, field_value in val.__dict__.items():
+                        # make enums into strings
+                        if isinstance(field_value, Enum):
+                            value[field] = field_value.value
+                        # don't write null values
+                        elif field_value is not None:
+                            value[field] = field_value
+                    field_values.append(value)
+
+                schemas[attr] = field_values
+
+        schema: Dict[str, List[Any]] = {}
+        # only write non-empty lists from defaults
+        for k, v in schemas.items():
+            if len(v) > 0:
+                schema[k] = v
+        return schema
+
+    @property
+    def content_vector(self) -> Union[FlatVectorField, HNSWVectorField]:
+        if not self.vector:
+            raise ValueError("No vector fields found")
+        for field in self.vector:
+            if field.name == self.content_vector_key:
+                return field
+        raise ValueError("No content_vector field found")
+
+    @property
+    def vector_dtype(self) -> np.dtype:
+        # should only ever be called after pydantic has validated the schema
+        return REDIS_VECTOR_DTYPE_MAP[self.content_vector.datatype]
+
+    @property
+    def is_empty(self) -> bool:
+        return all(
+            field is None for field in [self.tag, self.text, self.numeric, self.vector]
+        )
+
+    def get_fields(self) -> List["RedisField"]:
+        redis_fields: List["RedisField"] = []
+        if self.is_empty:
+            return redis_fields
+
+        for field_name in self.__fields__.keys():
+            if field_name not in ["content_key", "content_vector_key", "extra"]:
+                field_group = getattr(self, field_name)
+                if field_group is not None:
+                    for field in field_group:
+                        redis_fields.append(field.as_field())
+        return redis_fields
+
+    @property
+    def metadata_keys(self) -> List[str]:
+        keys: List[str] = []
+        if self.is_empty:
+            return keys
+
+        for field_name in self.__fields__.keys():
+            field_group = getattr(self, field_name)
+            if field_group is not None:
+                for field in field_group:
+                    # check if it's a metadata field. exclude vector and content key
+                    if not isinstance(field, str) and field.name not in [
+                        self.content_key,
+                        self.content_vector_key,
+                    ]:
+                        keys.append(field.name)
+        return keys
+
+
+def read_schema(
+    index_schema: Optional[Union[Dict[str, List[Any]], str, os.PathLike]],
+) -> Dict[str, Any]:
+    """Read in the index schema from a dict or yaml file.
+
+    Check if it is a dict and return RedisModel otherwise, check if it's a path and
+    read in the file assuming it's a yaml file and return a RedisModel
+    """
+    if isinstance(index_schema, dict):
+        return index_schema
+    elif isinstance(index_schema, Path):
+        with open(index_schema, "rb") as f:
+            return yaml.safe_load(f)
+    elif isinstance(index_schema, str):
+        if Path(index_schema).resolve().is_file():
+            with open(index_schema, "rb") as f:
+                return yaml.safe_load(f)
+        else:
+            raise FileNotFoundError(f"index_schema file {index_schema} does not exist")
+    else:
+        raise TypeError(
+            f"index_schema must be a dict, or path to a yaml file "
+            f"Got {type(index_schema)}"
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/rocksetdb.py b/llm/Lib/site-packages/langchain_community/vectorstores/rocksetdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..263a211fba32496a4006294248b782f9b92a353d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/rocksetdb.py
@@ -0,0 +1,418 @@
+from __future__ import annotations
+
+import logging
+from copy import deepcopy
+from enum import Enum
+from typing import Any, Iterable, List, Optional, Tuple
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.runnables import run_in_executor
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+logger = logging.getLogger(__name__)
+
+
+class Rockset(VectorStore):
+    """`Rockset` vector store.
+
+    To use, you should have the `rockset` python package installed. Note that to use
+    this, the collection being used must already exist in your Rockset instance.
+    You must also ensure you use a Rockset ingest transformation to apply
+    `VECTOR_ENFORCE` on the column being used to store `embedding_key` in the
+    collection.
+    See: https://rockset.com/blog/introducing-vector-search-on-rockset/ for more details
+
+    Everything below assumes `commons` Rockset workspace.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import Rockset
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+            import rockset
+
+            # Make sure you use the right host (region) for your Rockset instance
+            # and APIKEY has both read-write access to your collection.
+
+            rs = rockset.RocksetClient(host=rockset.Regions.use1a1, api_key="***")
+            collection_name = "langchain_demo"
+            embeddings = OpenAIEmbeddings()
+            vectorstore = Rockset(rs, collection_name, embeddings,
+                "description", "description_embedding")
+
+    """
+
+    def __init__(
+        self,
+        client: Any,
+        embeddings: Embeddings,
+        collection_name: str,
+        text_key: str,
+        embedding_key: str,
+        workspace: str = "commons",
+    ):
+        """Initialize with Rockset client.
+        Args:
+            client: Rockset client object
+            collection: Rockset collection to insert docs / query
+            embeddings: Langchain Embeddings object to use to generate
+                        embedding for given text.
+            text_key: column in Rockset collection to use to store the text
+            embedding_key: column in Rockset collection to use to store the embedding.
+                           Note: We must apply `VECTOR_ENFORCE()` on this column via
+                           Rockset ingest transformation.
+
+        """
+        try:
+            from rockset import RocksetClient
+        except ImportError:
+            raise ImportError(
+                "Could not import rockset client python package. "
+                "Please install it with `pip install rockset`."
+            )
+
+        if not isinstance(client, RocksetClient):
+            raise ValueError(
+                f"client should be an instance of rockset.RocksetClient, "
+                f"got {type(client)}"
+            )
+        # TODO: check that `collection_name` exists in rockset. Create if not.
+        self._client = client
+        self._collection_name = collection_name
+        self._embeddings = embeddings
+        self._text_key = text_key
+        self._embedding_key = embedding_key
+        self._workspace = workspace
+
+        try:
+            self._client.set_application("langchain")
+        except AttributeError:
+            # ignore
+            pass
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self._embeddings
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        batch_size: int = 32,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore
+
+                Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of ids to associate with the texts.
+            batch_size: Send documents in batches to rockset.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+
+        """
+        batch: list[dict] = []
+        stored_ids = []
+
+        for i, text in enumerate(texts):
+            if len(batch) == batch_size:
+                stored_ids += self._write_documents_to_rockset(batch)
+                batch = []
+            doc = {}
+            if metadatas and len(metadatas) > i:
+                doc = deepcopy(metadatas[i])
+            if ids and len(ids) > i:
+                doc["_id"] = ids[i]
+            doc[self._text_key] = text
+            doc[self._embedding_key] = self._embeddings.embed_query(text)
+            batch.append(doc)
+        if len(batch) > 0:
+            stored_ids += self._write_documents_to_rockset(batch)
+            batch = []
+        return stored_ids
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        client: Any = None,
+        collection_name: str = "",
+        text_key: str = "",
+        embedding_key: str = "",
+        ids: Optional[List[str]] = None,
+        batch_size: int = 32,
+        **kwargs: Any,
+    ) -> Rockset:
+        """Create Rockset wrapper with existing texts.
+        This is intended as a quicker way to get started.
+        """
+
+        # Sanitize inputs
+        assert client is not None, "Rockset Client cannot be None"
+        assert collection_name, "Collection name cannot be empty"
+        assert text_key, "Text key name cannot be empty"
+        assert embedding_key, "Embedding key cannot be empty"
+
+        rockset = cls(client, embedding, collection_name, text_key, embedding_key)
+        rockset.add_texts(texts, metadatas, ids, batch_size)
+        return rockset
+
+    # Rockset supports these vector distance functions.
+    class DistanceFunction(Enum):
+        COSINE_SIM = "COSINE_SIM"
+        EUCLIDEAN_DIST = "EUCLIDEAN_DIST"
+        DOT_PRODUCT = "DOT_PRODUCT"
+
+        # how to sort results for "similarity"
+        def order_by(self) -> str:
+            if self.value == "EUCLIDEAN_DIST":
+                return "ASC"
+            return "DESC"
+
+    def similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        distance_func: DistanceFunction = DistanceFunction.COSINE_SIM,
+        where_str: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Perform a similarity search with Rockset
+
+        Args:
+            query (str): Text to look up documents similar to.
+            distance_func (DistanceFunction): how to compute distance between two
+                vectors in Rockset.
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): Metadata filters supplied as a
+                SQL `where` condition string. Defaults to None.
+                eg. "price<=70.0 AND brand='Nintendo'"
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection.
+
+        Returns:
+            List[Tuple[Document, float]]: List of documents with their relevance score
+        """
+        return self.similarity_search_by_vector_with_relevance_scores(
+            self._embeddings.embed_query(query),
+            k,
+            distance_func,
+            where_str,
+            **kwargs,
+        )
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        distance_func: DistanceFunction = DistanceFunction.COSINE_SIM,
+        where_str: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Same as `similarity_search_with_relevance_scores` but
+        doesn't return the scores.
+        """
+        return self.similarity_search_by_vector(
+            self._embeddings.embed_query(query),
+            k,
+            distance_func,
+            where_str,
+            **kwargs,
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        distance_func: DistanceFunction = DistanceFunction.COSINE_SIM,
+        where_str: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Accepts a query_embedding (vector), and returns documents with
+        similar embeddings."""
+
+        docs_and_scores = self.similarity_search_by_vector_with_relevance_scores(
+            embedding, k, distance_func, where_str, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search_by_vector_with_relevance_scores(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        distance_func: DistanceFunction = DistanceFunction.COSINE_SIM,
+        where_str: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Accepts a query_embedding (vector), and returns documents with
+        similar embeddings along with their relevance scores."""
+
+        exclude_embeddings = True
+        if "exclude_embeddings" in kwargs:
+            exclude_embeddings = kwargs["exclude_embeddings"]
+        q_str = self._build_query_sql(
+            embedding, distance_func, k, where_str, exclude_embeddings
+        )
+        try:
+            query_response = self._client.Queries.query(sql={"query": q_str})
+        except Exception as e:
+            logger.error("Exception when querying Rockset: %s\n", e)
+            return []
+        finalResult: list[Tuple[Document, float]] = []
+        for document in query_response.results:
+            metadata = {}
+            assert isinstance(
+                document, dict
+            ), "document should be of type `dict[str,Any]`. But found: `{}`".format(
+                type(document)
+            )
+            for k, v in document.items():
+                if k == self._text_key:
+                    assert isinstance(v, str), (
+                        "page content stored in column `{}` must be of type `str`. "
+                        "But found: `{}`"
+                    ).format(self._text_key, type(v))
+                    page_content = v
+                elif k == "dist":
+                    assert isinstance(v, float), (
+                        "Computed distance between vectors must of type `float`. "
+                        "But found {}"
+                    ).format(type(v))
+                    score = v
+                elif k not in ["_id", "_event_time", "_meta"]:
+                    # These columns are populated by Rockset when documents are
+                    # inserted. No need to return them in metadata dict.
+                    metadata[k] = v
+            finalResult.append(
+                (Document(page_content=page_content, metadata=metadata), score)
+            )
+        return finalResult
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        *,
+        where_str: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            distance_func (DistanceFunction): how to compute distance between two
+                vectors in Rockset.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            where_str: where clause for the sql query
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        query_embedding = self._embeddings.embed_query(query)
+        initial_docs = self.similarity_search_by_vector(
+            query_embedding,
+            k=fetch_k,
+            where_str=where_str,
+            exclude_embeddings=False,
+            **kwargs,
+        )
+
+        embeddings = [doc.metadata[self._embedding_key] for doc in initial_docs]
+
+        selected_indices = maximal_marginal_relevance(
+            np.array(query_embedding),
+            embeddings,
+            lambda_mult=lambda_mult,
+            k=k,
+        )
+
+        # remove embeddings key before returning for cleanup to be consistent with
+        #   other search functions
+        for i in selected_indices:
+            del initial_docs[i].metadata[self._embedding_key]
+
+        return [initial_docs[i] for i in selected_indices]
+
+    # Helper functions
+
+    def _build_query_sql(
+        self,
+        query_embedding: List[float],
+        distance_func: DistanceFunction,
+        k: int = 4,
+        where_str: Optional[str] = None,
+        exclude_embeddings: bool = True,
+    ) -> str:
+        """Builds Rockset SQL query to query similar vectors to query_vector"""
+
+        q_embedding_str = ",".join(map(str, query_embedding))
+        distance_str = f"""{distance_func.value}({self._embedding_key}, \
+[{q_embedding_str}]) as dist"""
+        where_str = f"WHERE {where_str}\n" if where_str else ""
+        select_embedding = (
+            f" EXCEPT({self._embedding_key})," if exclude_embeddings else ","
+        )
+        return f"""\
+SELECT *{select_embedding} {distance_str}
+FROM {self._workspace}.{self._collection_name}
+{where_str}\
+ORDER BY dist {distance_func.order_by()}
+LIMIT {str(k)}
+"""
+
+    def _write_documents_to_rockset(self, batch: List[dict]) -> List[str]:
+        add_doc_res = self._client.Documents.add_documents(
+            collection=self._collection_name, data=batch, workspace=self._workspace
+        )
+        return [doc_status._id for doc_status in add_doc_res.data]
+
+    def delete_texts(self, ids: List[str]) -> None:
+        """Delete a list of docs from the Rockset collection"""
+        try:
+            from rockset.models import DeleteDocumentsRequestData
+        except ImportError:
+            raise ImportError(
+                "Could not import rockset client python package. "
+                "Please install it with `pip install rockset`."
+            )
+
+        self._client.Documents.delete_documents(
+            collection=self._collection_name,
+            data=[DeleteDocumentsRequestData(id=i) for i in ids],
+            workspace=self._workspace,
+        )
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        try:
+            if ids is None:
+                ids = []
+            self.delete_texts(ids)
+        except Exception as e:
+            logger.error("Exception when deleting docs from Rockset: %s\n", e)
+            return False
+
+        return True
+
+    async def adelete(
+        self, ids: Optional[List[str]] = None, **kwargs: Any
+    ) -> Optional[bool]:
+        return await run_in_executor(None, self.delete, ids, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/scann.py b/llm/Lib/site-packages/langchain_community/vectorstores/scann.py
new file mode 100644
index 0000000000000000000000000000000000000000..67fc46096e2f5be35fd33e95b2c1cb2738593b2c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/scann.py
@@ -0,0 +1,564 @@
+from __future__ import annotations
+
+import operator
+import pickle
+import uuid
+from pathlib import Path
+from typing import Any, Callable, Dict, Iterable, List, Optional, Tuple
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.docstore.base import AddableMixin, Docstore
+from langchain_community.docstore.in_memory import InMemoryDocstore
+from langchain_community.vectorstores.utils import DistanceStrategy
+
+
+def normalize(x: np.ndarray) -> np.ndarray:
+    """Normalize vectors to unit length."""
+    x /= np.clip(np.linalg.norm(x, axis=-1, keepdims=True), 1e-12, None)
+    return x
+
+
+def dependable_scann_import() -> Any:
+    """
+    Import `scann` if available, otherwise raise error.
+    """
+    try:
+        import scann
+    except ImportError:
+        raise ImportError(
+            "Could not import scann python package. "
+            "Please install it with `pip install scann` "
+        )
+    return scann
+
+
+class ScaNN(VectorStore):
+    """`ScaNN` vector store.
+
+    To use, you should have the ``scann`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import HuggingFaceEmbeddings
+            from langchain_community.vectorstores import ScaNN
+
+            db = ScaNN.from_texts(
+                ['foo', 'bar', 'barz', 'qux'],
+                HuggingFaceEmbeddings())
+            db.similarity_search('foo?', k=1)
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        index: Any,
+        docstore: Docstore,
+        index_to_docstore_id: Dict[int, str],
+        relevance_score_fn: Optional[Callable[[float], float]] = None,
+        normalize_L2: bool = False,
+        distance_strategy: DistanceStrategy = DistanceStrategy.EUCLIDEAN_DISTANCE,
+        scann_config: Optional[str] = None,
+    ):
+        """Initialize with necessary components."""
+        self.embedding = embedding
+        self.index = index
+        self.docstore = docstore
+        self.index_to_docstore_id = index_to_docstore_id
+        self.distance_strategy = distance_strategy
+        self.override_relevance_score_fn = relevance_score_fn
+        self._normalize_L2 = normalize_L2
+        self._scann_config = scann_config
+
+    def __add(
+        self,
+        texts: Iterable[str],
+        embeddings: Iterable[List[float]],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        if not isinstance(self.docstore, AddableMixin):
+            raise ValueError(
+                "If trying to add texts, the underlying docstore should support "
+                f"adding items, which {self.docstore} does not"
+            )
+        raise NotImplementedError("Updates are not available in ScaNN, yet.")
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of unique IDs.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        # Embed and create the documents.
+        embeddings = self.embedding.embed_documents(list(texts))
+        return self.__add(texts, embeddings, metadatas=metadatas, ids=ids, **kwargs)
+
+    def add_embeddings(
+        self,
+        text_embeddings: Iterable[Tuple[str, List[float]]],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            text_embeddings: Iterable pairs of string and embedding to
+                add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of unique IDs.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        if not isinstance(self.docstore, AddableMixin):
+            raise ValueError(
+                "If trying to add texts, the underlying docstore should support "
+                f"adding items, which {self.docstore} does not"
+            )
+        # Embed and create the documents.
+        texts, embeddings = zip(*text_embeddings)
+
+        return self.__add(texts, embeddings, metadatas=metadatas, ids=ids, **kwargs)
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        """Delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+
+        raise NotImplementedError("Deletions are not available in ScaNN, yet.")
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            embedding: Embedding vector to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, Any]]): Filter by metadata. Defaults to None.
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+            **kwargs: kwargs to be passed to similarity search. Can include:
+                score_threshold: Optional, a floating point value between 0 to 1 to
+                    filter the resulting set of retrieved docs
+
+        Returns:
+            List of documents most similar to the query text and L2 distance
+            in float for each. Lower score represents more similarity.
+        """
+        vector = np.array([embedding], dtype=np.float32)
+        if self._normalize_L2:
+            vector = normalize(vector)
+        indices, scores = self.index.search_batched(
+            vector, k if filter is None else fetch_k
+        )
+        docs = []
+        for j, i in enumerate(indices[0]):
+            if i == -1:
+                # This happens when not enough docs are returned.
+                continue
+            _id = self.index_to_docstore_id[i]
+            doc = self.docstore.search(_id)
+            if not isinstance(doc, Document):
+                raise ValueError(f"Could not find document for id {_id}, got {doc}")
+            if filter is not None:
+                filter = {
+                    key: [value] if not isinstance(value, list) else value
+                    for key, value in filter.items()
+                }
+                if all(doc.metadata.get(key) in value for key, value in filter.items()):
+                    docs.append((doc, scores[0][j]))
+            else:
+                docs.append((doc, scores[0][j]))
+
+        score_threshold = kwargs.get("score_threshold")
+        if score_threshold is not None:
+            cmp = (
+                operator.ge
+                if self.distance_strategy
+                in (DistanceStrategy.MAX_INNER_PRODUCT, DistanceStrategy.JACCARD)
+                else operator.le
+            )
+            docs = [
+                (doc, similarity)
+                for doc, similarity in docs
+                if cmp(similarity, score_threshold)
+            ]
+        return docs[:k]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+
+        Returns:
+            List of documents most similar to the query text with
+            L2 distance in float. Lower score represents more similarity.
+        """
+        embedding = self.embedding.embed_query(query)
+        docs = self.similarity_search_with_score_by_vector(
+            embedding,
+            k,
+            filter=filter,
+            fetch_k=fetch_k,
+            **kwargs,
+        )
+        return docs
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+
+        Returns:
+            List of Documents most similar to the embedding.
+        """
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding,
+            k,
+            filter=filter,
+            fetch_k=fetch_k,
+            **kwargs,
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query, k, filter=filter, fetch_k=fetch_k, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    @classmethod
+    def __from(
+        cls,
+        texts: List[str],
+        embeddings: List[List[float]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        normalize_L2: bool = False,
+        **kwargs: Any,
+    ) -> ScaNN:
+        scann = dependable_scann_import()
+        distance_strategy = kwargs.get(
+            "distance_strategy", DistanceStrategy.EUCLIDEAN_DISTANCE
+        )
+        scann_config = kwargs.get("scann_config", None)
+
+        vector = np.array(embeddings, dtype=np.float32)
+        if normalize_L2:
+            vector = normalize(vector)
+        if scann_config is not None:
+            index = scann.scann_ops_pybind.create_searcher(vector, scann_config)
+        else:
+            if distance_strategy == DistanceStrategy.MAX_INNER_PRODUCT:
+                index = (
+                    scann.scann_ops_pybind.builder(vector, 1, "dot_product")
+                    .score_brute_force()
+                    .build()
+                )
+            else:
+                # Default to L2, currently other metric types not initialized.
+                index = (
+                    scann.scann_ops_pybind.builder(vector, 1, "squared_l2")
+                    .score_brute_force()
+                    .build()
+                )
+        documents = []
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+        for i, text in enumerate(texts):
+            metadata = metadatas[i] if metadatas else {}
+            documents.append(Document(page_content=text, metadata=metadata))
+        index_to_id = dict(enumerate(ids))
+
+        if len(index_to_id) != len(documents):
+            raise Exception(
+                f"{len(index_to_id)} ids provided for {len(documents)} documents."
+                " Each document should have an id."
+            )
+
+        docstore = InMemoryDocstore(dict(zip(index_to_id.values(), documents)))
+        return cls(
+            embedding,
+            index,
+            docstore,
+            index_to_id,
+            normalize_L2=normalize_L2,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> ScaNN:
+        """Construct ScaNN wrapper from raw documents.
+
+        This is a user friendly interface that:
+            1. Embeds documents.
+            2. Creates an in memory docstore
+            3. Initializes the ScaNN database
+
+        This is intended to be a quick way to get started.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import ScaNN
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                scann = ScaNN.from_texts(texts, embeddings)
+        """
+        embeddings = embedding.embed_documents(texts)
+        return cls.__from(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_embeddings(
+        cls,
+        text_embeddings: List[Tuple[str, List[float]]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> ScaNN:
+        """Construct ScaNN wrapper from raw documents.
+
+        This is a user friendly interface that:
+            1. Embeds documents.
+            2. Creates an in memory docstore
+            3. Initializes the ScaNN database
+
+        This is intended to be a quick way to get started.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import ScaNN
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                text_embeddings = embeddings.embed_documents(texts)
+                text_embedding_pairs = list(zip(texts, text_embeddings))
+                scann = ScaNN.from_embeddings(text_embedding_pairs, embeddings)
+        """
+        texts = [t[0] for t in text_embeddings]
+        embeddings = [t[1] for t in text_embeddings]
+        return cls.__from(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            **kwargs,
+        )
+
+    def save_local(self, folder_path: str, index_name: str = "index") -> None:
+        """Save ScaNN index, docstore, and index_to_docstore_id to disk.
+
+        Args:
+            folder_path: folder path to save index, docstore,
+                and index_to_docstore_id to.
+        """
+        path = Path(folder_path)
+        scann_path = path / "{index_name}.scann".format(index_name=index_name)
+        scann_path.mkdir(exist_ok=True, parents=True)
+
+        # save index separately since it is not picklable
+        self.index.serialize(str(scann_path))
+
+        # save docstore and index_to_docstore_id
+        with open(path / "{index_name}.pkl".format(index_name=index_name), "wb") as f:
+            pickle.dump((self.docstore, self.index_to_docstore_id), f)
+
+    @classmethod
+    def load_local(
+        cls,
+        folder_path: str,
+        embedding: Embeddings,
+        index_name: str = "index",
+        *,
+        allow_dangerous_deserialization: bool = False,
+        **kwargs: Any,
+    ) -> ScaNN:
+        """Load ScaNN index, docstore, and index_to_docstore_id from disk.
+
+        Args:
+            folder_path: folder path to load index, docstore,
+                and index_to_docstore_id from.
+            embeddings: Embeddings to use when generating queries
+            index_name: for saving with a specific index file name
+            allow_dangerous_deserialization: whether to allow deserialization
+                of the data which involves loading a pickle file.
+                Pickle files can be modified by malicious actors to deliver a
+                malicious payload that results in execution of
+                arbitrary code on your machine.
+        """
+        if not allow_dangerous_deserialization:
+            raise ValueError(
+                "The de-serialization relies loading a pickle file. "
+                "Pickle files can be modified to deliver a malicious payload that "
+                "results in execution of arbitrary code on your machine."
+                "You will need to set `allow_dangerous_deserialization` to `True` to "
+                "enable deserialization. If you do this, make sure that you "
+                "trust the source of the data. For example, if you are loading a "
+                "file that you created, and no that no one else has modified the file, "
+                "then this is safe to do. Do not set this to `True` if you are loading "
+                "a file from an untrusted source (e.g., some random site on the "
+                "internet.)."
+            )
+        path = Path(folder_path)
+        scann_path = path / "{index_name}.scann".format(index_name=index_name)
+        scann_path.mkdir(exist_ok=True, parents=True)
+        # load index separately since it is not picklable
+        scann = dependable_scann_import()
+        index = scann.scann_ops_pybind.load_searcher(str(scann_path))
+
+        # load docstore and index_to_docstore_id
+        with open(path / "{index_name}.pkl".format(index_name=index_name), "rb") as f:
+            docstore, index_to_docstore_id = pickle.load(f)
+        return cls(embedding, index, docstore, index_to_docstore_id, **kwargs)
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+        """
+        if self.override_relevance_score_fn is not None:
+            return self.override_relevance_score_fn
+
+        # Default strategy is to rely on distance strategy provided in
+        # vectorstore constructor
+        if self.distance_strategy == DistanceStrategy.MAX_INNER_PRODUCT:
+            return self._max_inner_product_relevance_score_fn
+        elif self.distance_strategy == DistanceStrategy.EUCLIDEAN_DISTANCE:
+            # Default behavior is to use euclidean distance relevancy
+            return self._euclidean_relevance_score_fn
+        else:
+            raise ValueError(
+                "Unknown distance strategy, must be cosine, max_inner_product,"
+                " or euclidean"
+            )
+
+    def _similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs and their similarity scores on a scale from 0 to 1."""
+        # Pop score threshold so that only relevancy scores, not raw scores, are
+        # filtered.
+        score_threshold = kwargs.pop("score_threshold", None)
+        relevance_score_fn = self._select_relevance_score_fn()
+        if relevance_score_fn is None:
+            raise ValueError(
+                "normalize_score_fn must be provided to"
+                " ScaNN constructor to normalize scores"
+            )
+        docs_and_scores = self.similarity_search_with_score(
+            query,
+            k=k,
+            filter=filter,
+            fetch_k=fetch_k,
+            **kwargs,
+        )
+        docs_and_rel_scores = [
+            (doc, relevance_score_fn(score)) for doc, score in docs_and_scores
+        ]
+        if score_threshold is not None:
+            docs_and_rel_scores = [
+                (doc, similarity)
+                for doc, similarity in docs_and_rel_scores
+                if similarity >= score_threshold
+            ]
+        return docs_and_rel_scores
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/semadb.py b/llm/Lib/site-packages/langchain_community/vectorstores/semadb.py
new file mode 100644
index 0000000000000000000000000000000000000000..f80c046a2223ca4f722f795d6c3a89a14e4c443d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/semadb.py
@@ -0,0 +1,272 @@
+from typing import Any, Iterable, List, Optional, Tuple
+from uuid import uuid4
+
+import numpy as np
+import requests
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_env
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import DistanceStrategy
+
+
+class SemaDB(VectorStore):
+    """`SemaDB` vector store.
+
+    This vector store is a wrapper around the SemaDB database.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import SemaDB
+
+            db = SemaDB('mycollection', 768, embeddings, DistanceStrategy.COSINE)
+
+    """
+
+    HOST = "semadb.p.rapidapi.com"
+    BASE_URL = "https://" + HOST
+
+    def __init__(
+        self,
+        collection_name: str,
+        vector_size: int,
+        embedding: Embeddings,
+        distance_strategy: DistanceStrategy = DistanceStrategy.EUCLIDEAN_DISTANCE,
+        api_key: str = "",
+    ):
+        """initialize the SemaDB vector store."""
+        self.collection_name = collection_name
+        self.vector_size = vector_size
+        self.api_key = api_key or get_from_env("api_key", "SEMADB_API_KEY")
+        self._embedding = embedding
+        self.distance_strategy = distance_strategy
+
+    @property
+    def headers(self) -> dict:
+        """Return the common headers."""
+        return {
+            "content-type": "application/json",
+            "X-RapidAPI-Key": self.api_key,
+            "X-RapidAPI-Host": SemaDB.HOST,
+        }
+
+    def _get_internal_distance_strategy(self) -> str:
+        """Return the internal distance strategy."""
+        if self.distance_strategy == DistanceStrategy.EUCLIDEAN_DISTANCE:
+            return "euclidean"
+        elif self.distance_strategy == DistanceStrategy.MAX_INNER_PRODUCT:
+            raise ValueError("Max inner product is not supported by SemaDB")
+        elif self.distance_strategy == DistanceStrategy.DOT_PRODUCT:
+            return "dot"
+        elif self.distance_strategy == DistanceStrategy.JACCARD:
+            raise ValueError("Max inner product is not supported by SemaDB")
+        elif self.distance_strategy == DistanceStrategy.COSINE:
+            return "cosine"
+        else:
+            raise ValueError(f"Unknown distance strategy {self.distance_strategy}")
+
+    def create_collection(self) -> bool:
+        """Creates the corresponding collection in SemaDB."""
+        payload = {
+            "id": self.collection_name,
+            "vectorSize": self.vector_size,
+            "distanceMetric": self._get_internal_distance_strategy(),
+        }
+        response = requests.post(
+            SemaDB.BASE_URL + "/collections",
+            json=payload,
+            headers=self.headers,
+        )
+        return response.status_code == 200
+
+    def delete_collection(self) -> bool:
+        """Deletes the corresponding collection in SemaDB."""
+        response = requests.delete(
+            SemaDB.BASE_URL + f"/collections/{self.collection_name}",
+            headers=self.headers,
+        )
+        return response.status_code == 200
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        batch_size: int = 1000,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add texts to the vector store."""
+        if not isinstance(texts, list):
+            texts = list(texts)
+        embeddings = self._embedding.embed_documents(texts)
+        # Check dimensions
+        if len(embeddings[0]) != self.vector_size:
+            raise ValueError(
+                f"Embedding size mismatch {len(embeddings[0])} != {self.vector_size}"
+            )
+        # Normalise if needed
+        if self.distance_strategy == DistanceStrategy.COSINE:
+            embed_matrix = np.array(embeddings)
+            embed_matrix = embed_matrix / np.linalg.norm(
+                embed_matrix, axis=1, keepdims=True
+            )
+            embeddings = embed_matrix.tolist()
+        # Create points
+        ids: List[str] = []
+        points = []
+        if metadatas is not None:
+            for text, embedding, metadata in zip(texts, embeddings, metadatas):
+                new_id = str(uuid4())
+                ids.append(new_id)
+                points.append(
+                    {
+                        "id": new_id,
+                        "vector": embedding,
+                        "metadata": {**metadata, **{"text": text}},
+                    }
+                )
+        else:
+            for text, embedding in zip(texts, embeddings):
+                new_id = str(uuid4())
+                ids.append(new_id)
+                points.append(
+                    {
+                        "id": new_id,
+                        "vector": embedding,
+                        "metadata": {"text": text},
+                    }
+                )
+        # Insert points in batches
+        for i in range(0, len(points), batch_size):
+            batch = points[i : i + batch_size]
+            response = requests.post(
+                SemaDB.BASE_URL + f"/collections/{self.collection_name}/points",
+                json={"points": batch},
+                headers=self.headers,
+            )
+            if response.status_code != 200:
+                print("HERE--", batch)  # noqa: T201
+                raise ValueError(f"Error adding points: {response.text}")
+            failed_ranges = response.json()["failedRanges"]
+            if len(failed_ranges) > 0:
+                raise ValueError(f"Error adding points: {failed_ranges}")
+        # Return ids
+        return ids
+
+    @property
+    def embeddings(self) -> Embeddings:
+        """Return the embeddings."""
+        return self._embedding
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        """Delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+        payload = {
+            "ids": ids,
+        }
+        response = requests.delete(
+            SemaDB.BASE_URL + f"/collections/{self.collection_name}/points",
+            json=payload,
+            headers=self.headers,
+        )
+        return response.status_code == 200 and len(response.json()["failedPoints"]) == 0
+
+    def _search_points(self, embedding: List[float], k: int = 4) -> List[dict]:
+        """Search points."""
+        # Normalise if needed
+        if self.distance_strategy == DistanceStrategy.COSINE:
+            vec = np.array(embedding)
+            vec = vec / np.linalg.norm(vec)
+            embedding = vec.tolist()
+        # Perform search request
+        payload = {
+            "vector": embedding,
+            "limit": k,
+        }
+        response = requests.post(
+            SemaDB.BASE_URL + f"/collections/{self.collection_name}/points/search",
+            json=payload,
+            headers=self.headers,
+        )
+        if response.status_code != 200:
+            raise ValueError(f"Error searching: {response.text}")
+        return response.json()["points"]
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query."""
+        query_embedding = self._embedding.embed_query(query)
+        return self.similarity_search_by_vector(query_embedding, k=k)
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search with distance."""
+        query_embedding = self._embedding.embed_query(query)
+        points = self._search_points(query_embedding, k=k)
+        return [
+            (
+                Document(page_content=p["metadata"]["text"], metadata=p["metadata"]),
+                p["distance"],
+            )
+            for p in points
+        ]
+
+    def similarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        points = self._search_points(embedding, k=k)
+        return [
+            Document(page_content=p["metadata"]["text"], metadata=p["metadata"])
+            for p in points
+        ]
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = "",
+        vector_size: int = 0,
+        api_key: str = "",
+        distance_strategy: DistanceStrategy = DistanceStrategy.EUCLIDEAN_DISTANCE,
+        **kwargs: Any,
+    ) -> "SemaDB":
+        """Return VectorStore initialized from texts and embeddings."""
+        if not collection_name:
+            raise ValueError("Collection name must be provided")
+        if not vector_size:
+            raise ValueError("Vector size must be provided")
+        if not api_key:
+            raise ValueError("API key must be provided")
+        semadb = cls(
+            collection_name,
+            vector_size,
+            embedding,
+            distance_strategy=distance_strategy,
+            api_key=api_key,
+        )
+        if not semadb.create_collection():
+            raise ValueError("Error creating collection")
+        semadb.add_texts(texts, metadatas=metadatas)
+        return semadb
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/singlestoredb.py b/llm/Lib/site-packages/langchain_community/vectorstores/singlestoredb.py
new file mode 100644
index 0000000000000000000000000000000000000000..3eaba96a889c57c697463ebef2eace2e8ee31c84
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/singlestoredb.py
@@ -0,0 +1,553 @@
+from __future__ import annotations
+
+import json
+import re
+from typing import (
+    Any,
+    Callable,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+)
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore, VectorStoreRetriever
+from sqlalchemy.pool import QueuePool
+
+from langchain_community.vectorstores.utils import DistanceStrategy
+
+DEFAULT_DISTANCE_STRATEGY = DistanceStrategy.DOT_PRODUCT
+
+ORDERING_DIRECTIVE: dict = {
+    DistanceStrategy.EUCLIDEAN_DISTANCE: "",
+    DistanceStrategy.DOT_PRODUCT: "DESC",
+}
+
+
+class SingleStoreDB(VectorStore):
+    """`SingleStore DB` vector store.
+
+    The prerequisite for using this class is the installation of the ``singlestoredb``
+    Python package.
+
+    The SingleStoreDB vectorstore can be created by providing an embedding function and
+    the relevant parameters for the database connection, connection pool, and
+    optionally, the names of the table and the fields to use.
+    """
+
+    def _get_connection(self: SingleStoreDB) -> Any:
+        try:
+            import singlestoredb as s2
+        except ImportError:
+            raise ImportError(
+                "Could not import singlestoredb python package. "
+                "Please install it with `pip install singlestoredb`."
+            )
+        return s2.connect(**self.connection_kwargs)
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        *,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        table_name: str = "embeddings",
+        content_field: str = "content",
+        metadata_field: str = "metadata",
+        vector_field: str = "vector",
+        use_vector_index: bool = False,
+        vector_index_name: str = "",
+        vector_index_options: Optional[dict] = None,
+        vector_size: int = 1536,
+        pool_size: int = 5,
+        max_overflow: int = 10,
+        timeout: float = 30,
+        **kwargs: Any,
+    ):
+        """Initialize with necessary components.
+
+        Args:
+            embedding (Embeddings): A text embedding model.
+
+            distance_strategy (DistanceStrategy, optional):
+                Determines the strategy employed for calculating
+                the distance between vectors in the embedding space.
+                Defaults to DOT_PRODUCT.
+                Available options are:
+                - DOT_PRODUCT: Computes the scalar product of two vectors.
+                    This is the default behavior
+                - EUCLIDEAN_DISTANCE: Computes the Euclidean distance between
+                    two vectors. This metric considers the geometric distance in
+                    the vector space, and might be more suitable for embeddings
+                    that rely on spatial relationships.
+
+            table_name (str, optional): Specifies the name of the table in use.
+                Defaults to "embeddings".
+            content_field (str, optional): Specifies the field to store the content.
+                Defaults to "content".
+            metadata_field (str, optional): Specifies the field to store metadata.
+                Defaults to "metadata".
+            vector_field (str, optional): Specifies the field to store the vector.
+                Defaults to "vector".
+
+            use_vector_index (bool, optional): Toggles the use of a vector index.
+                Works only with SingleStoreDB 8.5 or later. Defaults to False.
+                If set to True, vector_size parameter is required to be set to
+                a proper value.
+
+            vector_index_name (str, optional): Specifies the name of the vector index.
+                Defaults to empty. Will be ignored if use_vector_index is set to False.
+
+            vector_index_options (dict, optional): Specifies the options for
+                the vector index. Defaults to {}.
+                Will be ignored if use_vector_index is set to False. The options are:
+                index_type (str, optional): Specifies the type of the index.
+                    Defaults to IVF_PQFS.
+                For more options, please refer to the SingleStoreDB documentation:
+                https://docs.singlestore.com/cloud/reference/sql-reference/vector-functions/vector-indexing/
+
+            vector_size (int, optional): Specifies the size of the vector.
+                Defaults to 1536. Required if use_vector_index is set to True.
+                Should be set to the same value as the size of the vectors
+                stored in the vector_field.
+
+            Following arguments pertain to the connection pool:
+
+            pool_size (int, optional): Determines the number of active connections in
+                the pool. Defaults to 5.
+            max_overflow (int, optional): Determines the maximum number of connections
+                allowed beyond the pool_size. Defaults to 10.
+            timeout (float, optional): Specifies the maximum wait time in seconds for
+                establishing a connection. Defaults to 30.
+
+            Following arguments pertain to the database connection:
+
+            host (str, optional): Specifies the hostname, IP address, or URL for the
+                database connection. The default scheme is "mysql".
+            user (str, optional): Database username.
+            password (str, optional): Database password.
+            port (int, optional): Database port. Defaults to 3306 for non-HTTP
+                connections, 80 for HTTP connections, and 443 for HTTPS connections.
+            database (str, optional): Database name.
+
+            Additional optional arguments provide further customization over the
+            database connection:
+
+            pure_python (bool, optional): Toggles the connector mode. If True,
+                operates in pure Python mode.
+            local_infile (bool, optional): Allows local file uploads.
+            charset (str, optional): Specifies the character set for string values.
+            ssl_key (str, optional): Specifies the path of the file containing the SSL
+                key.
+            ssl_cert (str, optional): Specifies the path of the file containing the SSL
+                certificate.
+            ssl_ca (str, optional): Specifies the path of the file containing the SSL
+                certificate authority.
+            ssl_cipher (str, optional): Sets the SSL cipher list.
+            ssl_disabled (bool, optional): Disables SSL usage.
+            ssl_verify_cert (bool, optional): Verifies the server's certificate.
+                Automatically enabled if ``ssl_ca`` is specified.
+            ssl_verify_identity (bool, optional): Verifies the server's identity.
+            conv (dict[int, Callable], optional): A dictionary of data conversion
+                functions.
+            credential_type (str, optional): Specifies the type of authentication to
+                use: auth.PASSWORD, auth.JWT, or auth.BROWSER_SSO.
+            autocommit (bool, optional): Enables autocommits.
+            results_type (str, optional): Determines the structure of the query results:
+                tuples, namedtuples, dicts.
+            results_format (str, optional): Deprecated. This option has been renamed to
+                results_type.
+
+        Examples:
+            Basic Usage:
+
+            .. code-block:: python
+
+                from langchain_community.embeddings import OpenAIEmbeddings
+                from langchain_community.vectorstores import SingleStoreDB
+
+                vectorstore = SingleStoreDB(
+                    OpenAIEmbeddings(),
+                    host="https://user:password@127.0.0.1:3306/database"
+                )
+
+            Advanced Usage:
+
+            .. code-block:: python
+
+                from langchain_community.embeddings import OpenAIEmbeddings
+                from langchain_community.vectorstores import SingleStoreDB
+
+                vectorstore = SingleStoreDB(
+                    OpenAIEmbeddings(),
+                    distance_strategy=DistanceStrategy.EUCLIDEAN_DISTANCE,
+                    host="127.0.0.1",
+                    port=3306,
+                    user="user",
+                    password="password",
+                    database="db",
+                    table_name="my_custom_table",
+                    pool_size=10,
+                    timeout=60,
+                )
+
+            Using environment variables:
+
+            .. code-block:: python
+
+                from langchain_community.embeddings import OpenAIEmbeddings
+                from langchain_community.vectorstores import SingleStoreDB
+
+                os.environ['SINGLESTOREDB_URL'] = 'me:p455w0rd@s2-host.com/my_db'
+                vectorstore = SingleStoreDB(OpenAIEmbeddings())
+
+            Using vector index:
+
+            .. code-block:: python
+
+                from langchain_community.embeddings import OpenAIEmbeddings
+                from langchain_community.vectorstores import SingleStoreDB
+
+                os.environ['SINGLESTOREDB_URL'] = 'me:p455w0rd@s2-host.com/my_db'
+                vectorstore = SingleStoreDB(
+                    OpenAIEmbeddings(),
+                    use_vector_index=True,
+                )
+        """
+
+        self.embedding = embedding
+        self.distance_strategy = distance_strategy
+        self.table_name = self._sanitize_input(table_name)
+        self.content_field = self._sanitize_input(content_field)
+        self.metadata_field = self._sanitize_input(metadata_field)
+        self.vector_field = self._sanitize_input(vector_field)
+
+        self.use_vector_index = bool(use_vector_index)
+        self.vector_index_name = self._sanitize_input(vector_index_name)
+        self.vector_index_options = dict(vector_index_options or {})
+        self.vector_index_options["metric_type"] = self.distance_strategy
+        self.vector_size = int(vector_size)
+
+        # Pass the rest of the kwargs to the connection.
+        self.connection_kwargs = kwargs
+
+        # Add program name and version to connection attributes.
+        if "conn_attrs" not in self.connection_kwargs:
+            self.connection_kwargs["conn_attrs"] = dict()
+
+        self.connection_kwargs["conn_attrs"]["_connector_name"] = "langchain python sdk"
+        self.connection_kwargs["conn_attrs"]["_connector_version"] = "1.0.2"
+
+        # Create connection pool.
+        self.connection_pool = QueuePool(
+            self._get_connection,
+            max_overflow=max_overflow,
+            pool_size=pool_size,
+            timeout=timeout,
+        )
+        self._create_table()
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding
+
+    def _sanitize_input(self, input_str: str) -> str:
+        # Remove characters that are not alphanumeric or underscores
+        return re.sub(r"[^a-zA-Z0-9_]", "", input_str)
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        return self._max_inner_product_relevance_score_fn
+
+    def _create_table(self: SingleStoreDB) -> None:
+        """Create table if it doesn't exist."""
+        conn = self.connection_pool.connect()
+        try:
+            cur = conn.cursor()
+            try:
+                if self.use_vector_index:
+                    index_options = ""
+                    if self.vector_index_options and len(self.vector_index_options) > 0:
+                        index_options = "INDEX_OPTIONS '{}'".format(
+                            json.dumps(self.vector_index_options)
+                        )
+                    cur.execute(
+                        """CREATE TABLE IF NOT EXISTS {}
+                        ({} TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci,
+                        {} VECTOR({}, F32) NOT NULL, {} JSON,
+                        VECTOR INDEX {} ({}) {});""".format(
+                            self.table_name,
+                            self.content_field,
+                            self.vector_field,
+                            self.vector_size,
+                            self.metadata_field,
+                            self.vector_index_name,
+                            self.vector_field,
+                            index_options,
+                        ),
+                    )
+                else:
+                    cur.execute(
+                        """CREATE TABLE IF NOT EXISTS {}
+                        ({} TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci,
+                        {} BLOB, {} JSON);""".format(
+                            self.table_name,
+                            self.content_field,
+                            self.vector_field,
+                            self.metadata_field,
+                        ),
+                    )
+            finally:
+                cur.close()
+        finally:
+            conn.close()
+
+    def add_images(
+        self,
+        uris: List[str],
+        metadatas: Optional[List[dict]] = None,
+        embeddings: Optional[List[List[float]]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run images through the embeddings and add to the vectorstore.
+
+        Args:
+            uris List[str]: File path to images.
+                Each URI will be added to the vectorstore as document content.
+            metadatas (Optional[List[dict]], optional): Optional list of metadatas.
+                Defaults to None.
+            embeddings (Optional[List[List[float]]], optional): Optional pre-generated
+                embeddings. Defaults to None.
+
+        Returns:
+            List[str]: empty list
+        """
+        # Set embeddings
+        if (
+            embeddings is None
+            and self.embedding is not None
+            and hasattr(self.embedding, "embed_image")
+        ):
+            embeddings = self.embedding.embed_image(uris=uris)
+        return self.add_texts(uris, metadatas, embeddings, **kwargs)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        embeddings: Optional[List[List[float]]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add more texts to the vectorstore.
+
+        Args:
+            texts (Iterable[str]): Iterable of strings/text to add to the vectorstore.
+            metadatas (Optional[List[dict]], optional): Optional list of metadatas.
+                Defaults to None.
+            embeddings (Optional[List[List[float]]], optional): Optional pre-generated
+                embeddings. Defaults to None.
+
+        Returns:
+            List[str]: empty list
+        """
+        conn = self.connection_pool.connect()
+        try:
+            cur = conn.cursor()
+            try:
+                # Write data to singlestore db
+                for i, text in enumerate(texts):
+                    # Use provided values by default or fallback
+                    metadata = metadatas[i] if metadatas else {}
+                    embedding = (
+                        embeddings[i]
+                        if embeddings
+                        else self.embedding.embed_documents([text])[0]
+                    )
+                    cur.execute(
+                        "INSERT INTO {} VALUES (%s, JSON_ARRAY_PACK(%s), %s)".format(
+                            self.table_name
+                        ),
+                        (
+                            text,
+                            "[{}]".format(",".join(map(str, embedding))),
+                            json.dumps(metadata),
+                        ),
+                    )
+                if self.use_vector_index:
+                    cur.execute("OPTIMIZE TABLE {} FLUSH;".format(self.table_name))
+            finally:
+                cur.close()
+        finally:
+            conn.close()
+        return []
+
+    def similarity_search(
+        self, query: str, k: int = 4, filter: Optional[dict] = None, **kwargs: Any
+    ) -> List[Document]:
+        """Returns the most similar indexed documents to the query text.
+
+        Uses cosine similarity.
+
+        Args:
+            query (str): The query text for which to find similar documents.
+            k (int): The number of documents to return. Default is 4.
+            filter (dict): A dictionary of metadata fields and values to filter by.
+
+        Returns:
+            List[Document]: A list of documents that are most similar to the query text.
+
+        Examples:
+            .. code-block:: python
+                from langchain_community.vectorstores import SingleStoreDB
+                from langchain_community.embeddings import OpenAIEmbeddings
+                s2 = SingleStoreDB.from_documents(
+                    docs,
+                    OpenAIEmbeddings(),
+                    host="username:password@localhost:3306/database"
+                )
+                s2.similarity_search("query text", 1,
+                    {"metadata_field": "metadata_value"})
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query=query, k=k, filter=filter
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, filter: Optional[dict] = None
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query. Uses cosine similarity.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: A dictionary of metadata fields and values to filter by.
+                    Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        # Creates embedding vector from user query
+        embedding = self.embedding.embed_query(query)
+        conn = self.connection_pool.connect()
+        result = []
+        where_clause: str = ""
+        where_clause_values: List[Any] = []
+        if filter:
+            where_clause = "WHERE "
+            arguments = []
+
+            def build_where_clause(
+                where_clause_values: List[Any],
+                sub_filter: dict,
+                prefix_args: Optional[List[str]] = None,
+            ) -> None:
+                prefix_args = prefix_args or []
+                for key in sub_filter.keys():
+                    if isinstance(sub_filter[key], dict):
+                        build_where_clause(
+                            where_clause_values, sub_filter[key], prefix_args + [key]
+                        )
+                    else:
+                        arguments.append(
+                            "JSON_EXTRACT_JSON({}, {}) = %s".format(
+                                self.metadata_field,
+                                ", ".join(["%s"] * (len(prefix_args) + 1)),
+                            )
+                        )
+                        where_clause_values += prefix_args + [key]
+                        where_clause_values.append(json.dumps(sub_filter[key]))
+
+            build_where_clause(where_clause_values, filter)
+            where_clause += " AND ".join(arguments)
+
+        try:
+            cur = conn.cursor()
+            try:
+                cur.execute(
+                    """SELECT {}, {}, {}({}, JSON_ARRAY_PACK(%s)) as __score
+                    FROM {} {} ORDER BY __score {} LIMIT %s""".format(
+                        self.content_field,
+                        self.metadata_field,
+                        self.distance_strategy.name
+                        if isinstance(self.distance_strategy, DistanceStrategy)
+                        else self.distance_strategy,
+                        self.vector_field,
+                        self.table_name,
+                        where_clause,
+                        ORDERING_DIRECTIVE[self.distance_strategy],
+                    ),
+                    ("[{}]".format(",".join(map(str, embedding))),)
+                    + tuple(where_clause_values)
+                    + (k,),
+                )
+
+                for row in cur.fetchall():
+                    doc = Document(page_content=row[0], metadata=row[1])
+                    result.append((doc, float(row[2])))
+            finally:
+                cur.close()
+        finally:
+            conn.close()
+        return result
+
+    @classmethod
+    def from_texts(
+        cls: Type[SingleStoreDB],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        table_name: str = "embeddings",
+        content_field: str = "content",
+        metadata_field: str = "metadata",
+        vector_field: str = "vector",
+        use_vector_index: bool = False,
+        vector_index_name: str = "",
+        vector_index_options: Optional[dict] = None,
+        vector_size: int = 1536,
+        pool_size: int = 5,
+        max_overflow: int = 10,
+        timeout: float = 30,
+        **kwargs: Any,
+    ) -> SingleStoreDB:
+        """Create a SingleStoreDB vectorstore from raw documents.
+        This is a user-friendly interface that:
+            1. Embeds documents.
+            2. Creates a new table for the embeddings in SingleStoreDB.
+            3. Adds the documents to the newly created table.
+        This is intended to be a quick way to get started.
+        Example:
+            .. code-block:: python
+                from langchain_community.vectorstores import SingleStoreDB
+                from langchain_community.embeddings import OpenAIEmbeddings
+                s2 = SingleStoreDB.from_texts(
+                    texts,
+                    OpenAIEmbeddings(),
+                    host="username:password@localhost:3306/database"
+                )
+        """
+
+        instance = cls(
+            embedding,
+            distance_strategy=distance_strategy,
+            table_name=table_name,
+            content_field=content_field,
+            metadata_field=metadata_field,
+            vector_field=vector_field,
+            pool_size=pool_size,
+            max_overflow=max_overflow,
+            timeout=timeout,
+            use_vector_index=use_vector_index,
+            vector_index_name=vector_index_name,
+            vector_index_options=vector_index_options,
+            vector_size=vector_size,
+            **kwargs,
+        )
+        instance.add_texts(texts, metadatas, embedding.embed_documents(texts), **kwargs)
+        return instance
+
+
+# SingleStoreDBRetriever is not needed, but we keep it for backwards compatibility
+SingleStoreDBRetriever = VectorStoreRetriever
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/sklearn.py b/llm/Lib/site-packages/langchain_community/vectorstores/sklearn.py
new file mode 100644
index 0000000000000000000000000000000000000000..8194e31db611f76e22078098914cc98189719eaf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/sklearn.py
@@ -0,0 +1,355 @@
+""" Wrapper around scikit-learn NearestNeighbors implementation.
+
+The vector store can be persisted in json, bson or parquet format.
+"""
+
+import json
+import math
+import os
+from abc import ABC, abstractmethod
+from typing import Any, Dict, Iterable, List, Literal, Optional, Tuple, Type
+from uuid import uuid4
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import guard_import
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+DEFAULT_K = 4  # Number of Documents to return.
+DEFAULT_FETCH_K = 20  # Number of Documents to initially fetch during MMR search.
+
+
+class BaseSerializer(ABC):
+    """Base class for serializing data."""
+
+    def __init__(self, persist_path: str) -> None:
+        self.persist_path = persist_path
+
+    @classmethod
+    @abstractmethod
+    def extension(cls) -> str:
+        """The file extension suggested by this serializer (without dot)."""
+
+    @abstractmethod
+    def save(self, data: Any) -> None:
+        """Saves the data to the persist_path"""
+
+    @abstractmethod
+    def load(self) -> Any:
+        """Loads the data from the persist_path"""
+
+
+class JsonSerializer(BaseSerializer):
+    """Serialize data in JSON using the json package from python standard library."""
+
+    @classmethod
+    def extension(cls) -> str:
+        return "json"
+
+    def save(self, data: Any) -> None:
+        with open(self.persist_path, "w") as fp:
+            json.dump(data, fp)
+
+    def load(self) -> Any:
+        with open(self.persist_path, "r") as fp:
+            return json.load(fp)
+
+
+class BsonSerializer(BaseSerializer):
+    """Serialize data in Binary JSON using the `bson` python package."""
+
+    def __init__(self, persist_path: str) -> None:
+        super().__init__(persist_path)
+        self.bson = guard_import("bson")
+
+    @classmethod
+    def extension(cls) -> str:
+        return "bson"
+
+    def save(self, data: Any) -> None:
+        with open(self.persist_path, "wb") as fp:
+            fp.write(self.bson.dumps(data))
+
+    def load(self) -> Any:
+        with open(self.persist_path, "rb") as fp:
+            return self.bson.loads(fp.read())
+
+
+class ParquetSerializer(BaseSerializer):
+    """Serialize data in `Apache Parquet` format using the `pyarrow` package."""
+
+    def __init__(self, persist_path: str) -> None:
+        super().__init__(persist_path)
+        self.pd = guard_import("pandas")
+        self.pa = guard_import("pyarrow")
+        self.pq = guard_import("pyarrow.parquet")
+
+    @classmethod
+    def extension(cls) -> str:
+        return "parquet"
+
+    def save(self, data: Any) -> None:
+        df = self.pd.DataFrame(data)
+        table = self.pa.Table.from_pandas(df)
+        if os.path.exists(self.persist_path):
+            backup_path = str(self.persist_path) + "-backup"
+            os.rename(self.persist_path, backup_path)
+            try:
+                self.pq.write_table(table, self.persist_path)
+            except Exception as exc:
+                os.rename(backup_path, self.persist_path)
+                raise exc
+            else:
+                os.remove(backup_path)
+        else:
+            self.pq.write_table(table, self.persist_path)
+
+    def load(self) -> Any:
+        table = self.pq.read_table(self.persist_path)
+        df = table.to_pandas()
+        return {col: series.tolist() for col, series in df.items()}
+
+
+SERIALIZER_MAP: Dict[str, Type[BaseSerializer]] = {
+    "json": JsonSerializer,
+    "bson": BsonSerializer,
+    "parquet": ParquetSerializer,
+}
+
+
+class SKLearnVectorStoreException(RuntimeError):
+    """Exception raised by SKLearnVectorStore."""
+
+    pass
+
+
+class SKLearnVectorStore(VectorStore):
+    """Simple in-memory vector store based on the `scikit-learn` library
+    `NearestNeighbors`."""
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        *,
+        persist_path: Optional[str] = None,
+        serializer: Literal["json", "bson", "parquet"] = "json",
+        metric: str = "cosine",
+        **kwargs: Any,
+    ) -> None:
+        np = guard_import("numpy")
+        sklearn_neighbors = guard_import("sklearn.neighbors", pip_name="scikit-learn")
+
+        # non-persistent properties
+        self._np = np
+        self._neighbors = sklearn_neighbors.NearestNeighbors(metric=metric, **kwargs)
+        self._neighbors_fitted = False
+        self._embedding_function = embedding
+        self._persist_path = persist_path
+        self._serializer: Optional[BaseSerializer] = None
+        if self._persist_path is not None:
+            serializer_cls = SERIALIZER_MAP[serializer]
+            self._serializer = serializer_cls(persist_path=self._persist_path)
+
+        # data properties
+        self._embeddings: List[List[float]] = []
+        self._texts: List[str] = []
+        self._metadatas: List[dict] = []
+        self._ids: List[str] = []
+
+        # cache properties
+        self._embeddings_np: Any = np.asarray([])
+
+        if self._persist_path is not None and os.path.isfile(self._persist_path):
+            self._load()
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self._embedding_function
+
+    def persist(self) -> None:
+        if self._serializer is None:
+            raise SKLearnVectorStoreException(
+                "You must specify a persist_path on creation to persist the "
+                "collection."
+            )
+        data = {
+            "ids": self._ids,
+            "texts": self._texts,
+            "metadatas": self._metadatas,
+            "embeddings": self._embeddings,
+        }
+        self._serializer.save(data)
+
+    def _load(self) -> None:
+        if self._serializer is None:
+            raise SKLearnVectorStoreException(
+                "You must specify a persist_path on creation to load the " "collection."
+            )
+        data = self._serializer.load()
+        self._embeddings = data["embeddings"]
+        self._texts = data["texts"]
+        self._metadatas = data["metadatas"]
+        self._ids = data["ids"]
+        self._update_neighbors()
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        _texts = list(texts)
+        _ids = ids or [str(uuid4()) for _ in _texts]
+        self._texts.extend(_texts)
+        self._embeddings.extend(self._embedding_function.embed_documents(_texts))
+        self._metadatas.extend(metadatas or ([{}] * len(_texts)))
+        self._ids.extend(_ids)
+        self._update_neighbors()
+        return _ids
+
+    def _update_neighbors(self) -> None:
+        if len(self._embeddings) == 0:
+            raise SKLearnVectorStoreException(
+                "No data was added to SKLearnVectorStore."
+            )
+        self._embeddings_np = self._np.asarray(self._embeddings)
+        self._neighbors.fit(self._embeddings_np)
+        self._neighbors_fitted = True
+
+    def _similarity_index_search_with_score(
+        self, query_embedding: List[float], *, k: int = DEFAULT_K, **kwargs: Any
+    ) -> List[Tuple[int, float]]:
+        """Search k embeddings similar to the query embedding. Returns a list of
+        (index, distance) tuples."""
+        if not self._neighbors_fitted:
+            raise SKLearnVectorStoreException(
+                "No data was added to SKLearnVectorStore."
+            )
+        neigh_dists, neigh_idxs = self._neighbors.kneighbors(
+            [query_embedding], n_neighbors=k
+        )
+        return list(zip(neigh_idxs[0], neigh_dists[0]))
+
+    def similarity_search_with_score(
+        self, query: str, *, k: int = DEFAULT_K, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        query_embedding = self._embedding_function.embed_query(query)
+        indices_dists = self._similarity_index_search_with_score(
+            query_embedding, k=k, **kwargs
+        )
+        return [
+            (
+                Document(
+                    page_content=self._texts[idx],
+                    metadata={"id": self._ids[idx], **self._metadatas[idx]},
+                ),
+                dist,
+            )
+            for idx, dist in indices_dists
+        ]
+
+    def similarity_search(
+        self, query: str, k: int = DEFAULT_K, **kwargs: Any
+    ) -> List[Document]:
+        docs_scores = self.similarity_search_with_score(query, k=k, **kwargs)
+        return [doc for doc, _ in docs_scores]
+
+    def _similarity_search_with_relevance_scores(
+        self, query: str, k: int = DEFAULT_K, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        docs_dists = self.similarity_search_with_score(query, k=k, **kwargs)
+        docs, dists = zip(*docs_dists)
+        scores = [1 / math.exp(dist) for dist in dists]
+        return list(zip(list(docs), scores))
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_K,
+        fetch_k: int = DEFAULT_FETCH_K,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        indices_dists = self._similarity_index_search_with_score(
+            embedding, k=fetch_k, **kwargs
+        )
+        indices, _ = zip(*indices_dists)
+        result_embeddings = self._embeddings_np[indices,]
+        mmr_selected = maximal_marginal_relevance(
+            self._np.array(embedding, dtype=self._np.float32),
+            result_embeddings,
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+        mmr_indices = [indices[i] for i in mmr_selected]
+        return [
+            Document(
+                page_content=self._texts[idx],
+                metadata={"id": self._ids[idx], **self._metadatas[idx]},
+            )
+            for idx in mmr_indices
+        ]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = DEFAULT_K,
+        fetch_k: int = DEFAULT_FETCH_K,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        if self._embedding_function is None:
+            raise ValueError(
+                "For MMR search, you must specify an embedding function on creation."
+            )
+
+        embedding = self._embedding_function.embed_query(query)
+        docs = self.max_marginal_relevance_search_by_vector(
+            embedding, k, fetch_k, lambda_mul=lambda_mult
+        )
+        return docs
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        persist_path: Optional[str] = None,
+        **kwargs: Any,
+    ) -> "SKLearnVectorStore":
+        vs = SKLearnVectorStore(embedding, persist_path=persist_path, **kwargs)
+        vs.add_texts(texts, metadatas=metadatas, ids=ids)
+        return vs
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/sqlitevss.py b/llm/Lib/site-packages/langchain_community/vectorstores/sqlitevss.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ea9f427700b14d85514a2ccf946d2d35e108d32
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/sqlitevss.py
@@ -0,0 +1,228 @@
+from __future__ import annotations
+
+import json
+import logging
+import warnings
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+)
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    import sqlite3
+
+logger = logging.getLogger(__name__)
+
+
+class SQLiteVSS(VectorStore):
+    """SQLite with VSS extension as a vector database.
+
+    To use, you should have the ``sqlite-vss`` python package installed.
+    Example:
+        .. code-block:: python
+            from langchain_community.vectorstores import SQLiteVSS
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+            ...
+    """
+
+    def __init__(
+        self,
+        table: str,
+        connection: Optional[sqlite3.Connection],
+        embedding: Embeddings,
+        db_file: str = "vss.db",
+    ):
+        """Initialize with sqlite client with vss extension."""
+        try:
+            import sqlite_vss  # noqa  # pylint: disable=unused-import
+        except ImportError:
+            raise ImportError(
+                "Could not import sqlite-vss python package. "
+                "Please install it with `pip install sqlite-vss`."
+            )
+
+        if not connection:
+            connection = self.create_connection(db_file)
+
+        if not isinstance(embedding, Embeddings):
+            warnings.warn("embeddings input must be Embeddings object.")
+
+        self._connection = connection
+        self._table = table
+        self._embedding = embedding
+
+        self.create_table_if_not_exists()
+
+    def create_table_if_not_exists(self) -> None:
+        self._connection.execute(
+            f"""
+            CREATE TABLE IF NOT EXISTS {self._table}
+            (
+              rowid INTEGER PRIMARY KEY AUTOINCREMENT,
+              text TEXT,
+              metadata BLOB,
+              text_embedding BLOB
+            )
+            ;
+            """
+        )
+        self._connection.execute(
+            f"""
+                CREATE VIRTUAL TABLE IF NOT EXISTS vss_{self._table} USING vss0(
+                  text_embedding({self.get_dimensionality()})
+                );
+            """
+        )
+        self._connection.execute(
+            f"""
+                CREATE TRIGGER IF NOT EXISTS embed_text 
+                AFTER INSERT ON {self._table}
+                BEGIN
+                    INSERT INTO vss_{self._table}(rowid, text_embedding)
+                    VALUES (new.rowid, new.text_embedding) 
+                    ;
+                END;
+            """
+        )
+        self._connection.commit()
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add more texts to the vectorstore index.
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+        """
+        max_id = self._connection.execute(
+            f"SELECT max(rowid) as rowid FROM {self._table}"
+        ).fetchone()["rowid"]
+        if max_id is None:  # no text added yet
+            max_id = 0
+
+        embeds = self._embedding.embed_documents(list(texts))
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+        data_input = [
+            (text, json.dumps(metadata), json.dumps(embed))
+            for text, metadata, embed in zip(texts, metadatas, embeds)
+        ]
+        self._connection.executemany(
+            f"INSERT INTO {self._table}(text, metadata, text_embedding) "
+            f"VALUES (?,?,?)",
+            data_input,
+        )
+        self._connection.commit()
+        # pulling every ids we just inserted
+        results = self._connection.execute(
+            f"SELECT rowid FROM {self._table} WHERE rowid > {max_id}"
+        )
+        return [row["rowid"] for row in results]
+
+    def similarity_search_with_score_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        sql_query = f"""
+            SELECT 
+                text,
+                metadata,
+                distance
+            FROM {self._table} e
+            INNER JOIN vss_{self._table} v on v.rowid = e.rowid  
+            WHERE vss_search(
+              v.text_embedding,
+              vss_search_params('{json.dumps(embedding)}', {k})
+            )
+        """
+        cursor = self._connection.cursor()
+        cursor.execute(sql_query)
+        results = cursor.fetchall()
+
+        documents = []
+        for row in results:
+            metadata = json.loads(row["metadata"]) or {}
+            doc = Document(page_content=row["text"], metadata=metadata)
+            documents.append((doc, row["distance"]))
+
+        return documents
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query."""
+        embedding = self._embedding.embed_query(query)
+        documents = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k
+        )
+        return [doc for doc, _ in documents]
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query."""
+        embedding = self._embedding.embed_query(query)
+        documents = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k
+        )
+        return documents
+
+    def similarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        documents = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k
+        )
+        return [doc for doc, _ in documents]
+
+    @classmethod
+    def from_texts(
+        cls: Type[SQLiteVSS],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        table: str = "langchain",
+        db_file: str = "vss.db",
+        **kwargs: Any,
+    ) -> SQLiteVSS:
+        """Return VectorStore initialized from texts and embeddings."""
+        connection = cls.create_connection(db_file)
+        vss = cls(
+            table=table, connection=connection, db_file=db_file, embedding=embedding
+        )
+        vss.add_texts(texts=texts, metadatas=metadatas)
+        return vss
+
+    @staticmethod
+    def create_connection(db_file: str) -> sqlite3.Connection:
+        import sqlite3
+
+        import sqlite_vss
+
+        connection = sqlite3.connect(db_file)
+        connection.row_factory = sqlite3.Row
+        connection.enable_load_extension(True)
+        sqlite_vss.load(connection)
+        connection.enable_load_extension(False)
+        return connection
+
+    def get_dimensionality(self) -> int:
+        """
+        Function that does a dummy embedding to figure out how many dimensions
+        this embedding function returns. Needed for the virtual table DDL.
+        """
+        dummy_text = "This is a dummy text"
+        dummy_embedding = self._embedding.embed_query(dummy_text)
+        return len(dummy_embedding)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/starrocks.py b/llm/Lib/site-packages/langchain_community/vectorstores/starrocks.py
new file mode 100644
index 0000000000000000000000000000000000000000..807a21f54de95592ebdfcc31919bd5f1f70b1b09
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/starrocks.py
@@ -0,0 +1,484 @@
+from __future__ import annotations
+
+import json
+import logging
+from hashlib import sha1
+from threading import Thread
+from typing import Any, Dict, Iterable, List, Optional, Tuple
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseSettings
+from langchain_core.vectorstores import VectorStore
+
+logger = logging.getLogger()
+DEBUG = False
+
+
+def has_mul_sub_str(s: str, *args: Any) -> bool:
+    """
+    Check if a string has multiple substrings.
+    Args:
+        s: The string to check
+        *args: The substrings to check for in the string
+
+    Returns:
+        bool: True if all substrings are present in the string, False otherwise
+    """
+    for a in args:
+        if a not in s:
+            return False
+    return True
+
+
+def debug_output(s: Any) -> None:
+    """
+    Print a debug message if DEBUG is True.
+    Args:
+        s: The message to print
+    """
+    if DEBUG:
+        print(s)  # noqa: T201
+
+
+def get_named_result(connection: Any, query: str) -> List[dict[str, Any]]:
+    """
+    Get a named result from a query.
+    Args:
+        connection: The connection to the database
+        query: The query to execute
+
+    Returns:
+        List[dict[str, Any]]: The result of the query
+    """
+    cursor = connection.cursor()
+    cursor.execute(query)
+    columns = cursor.description
+    result = []
+    for value in cursor.fetchall():
+        r = {}
+        for idx, datum in enumerate(value):
+            k = columns[idx][0]
+            r[k] = datum
+        result.append(r)
+    debug_output(result)
+    cursor.close()
+    return result
+
+
+class StarRocksSettings(BaseSettings):
+    """StarRocks client configuration.
+
+    Attribute:
+        StarRocks_host (str) : An URL to connect to MyScale backend.
+                             Defaults to 'localhost'.
+        StarRocks_port (int) : URL port to connect with HTTP. Defaults to 8443.
+        username (str) : Username to login. Defaults to None.
+        password (str) : Password to login. Defaults to None.
+        database (str) : Database name to find the table. Defaults to 'default'.
+        table (str) : Table name to operate on.
+                      Defaults to 'vector_table'.
+
+        column_map (Dict) : Column type map to project column name onto langchain
+                            semantics. Must have keys: `text`, `id`, `vector`,
+                            must be same size to number of columns. For example:
+                            .. code-block:: python
+
+                                {
+                                    'id': 'text_id',
+                                    'embedding': 'text_embedding',
+                                    'document': 'text_plain',
+                                    'metadata': 'metadata_dictionary_in_json',
+                                }
+
+                            Defaults to identity map.
+    """
+
+    host: str = "localhost"
+    port: int = 9030
+    username: str = "root"
+    password: str = ""
+
+    column_map: Dict[str, str] = {
+        "id": "id",
+        "document": "document",
+        "embedding": "embedding",
+        "metadata": "metadata",
+    }
+
+    database: str = "default"
+    table: str = "langchain"
+
+    def __getitem__(self, item: str) -> Any:
+        return getattr(self, item)
+
+    class Config:
+        env_file = ".env"
+        env_prefix = "starrocks_"
+        env_file_encoding = "utf-8"
+
+
+class StarRocks(VectorStore):
+    """`StarRocks` vector store.
+
+    You need a `pymysql` python package, and a valid account
+    to connect to StarRocks.
+
+    Right now StarRocks has only implemented `cosine_similarity` function to
+    compute distance between two vectors. And there is no vector inside right now,
+    so we have to iterate all vectors and compute spatial distance.
+
+    For more information, please visit
+        [StarRocks official site](https://www.starrocks.io/)
+        [StarRocks github](https://github.com/StarRocks/starrocks)
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        config: Optional[StarRocksSettings] = None,
+        **kwargs: Any,
+    ) -> None:
+        """StarRocks Wrapper to LangChain
+
+        embedding_function (Embeddings):
+        config (StarRocksSettings): Configuration to StarRocks Client
+        """
+        try:
+            import pymysql  # type: ignore[import]
+        except ImportError:
+            raise ImportError(
+                "Could not import pymysql python package. "
+                "Please install it with `pip install pymysql`."
+            )
+        try:
+            from tqdm import tqdm
+
+            self.pgbar = tqdm
+        except ImportError:
+            # Just in case if tqdm is not installed
+            self.pgbar = lambda x, **kwargs: x
+        super().__init__()
+        if config is not None:
+            self.config = config
+        else:
+            self.config = StarRocksSettings()
+        assert self.config
+        assert self.config.host and self.config.port
+        assert self.config.column_map and self.config.database and self.config.table
+        for k in ["id", "embedding", "document", "metadata"]:
+            assert k in self.config.column_map
+
+        # initialize the schema
+        dim = len(embedding.embed_query("test"))
+
+        self.schema = f"""\
+CREATE TABLE IF NOT EXISTS {self.config.database}.{self.config.table}(    
+    {self.config.column_map['id']} string,
+    {self.config.column_map['document']} string,
+    {self.config.column_map['embedding']} array<float>,
+    {self.config.column_map['metadata']} string
+) ENGINE = OLAP PRIMARY KEY(id) DISTRIBUTED BY HASH(id) \
+  PROPERTIES ("replication_num" = "1")\
+"""
+        self.dim = dim
+        self.BS = "\\"
+        self.must_escape = ("\\", "'")
+        self.embedding_function = embedding
+        self.dist_order = "DESC"
+        debug_output(self.config)
+
+        # Create a connection to StarRocks
+        self.connection = pymysql.connect(
+            host=self.config.host,
+            port=self.config.port,
+            user=self.config.username,
+            password=self.config.password,
+            database=self.config.database,
+            **kwargs,
+        )
+
+        debug_output(self.schema)
+        get_named_result(self.connection, self.schema)
+
+    def escape_str(self, value: str) -> str:
+        return "".join(f"{self.BS}{c}" if c in self.must_escape else c for c in value)
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding_function
+
+    def _build_insert_sql(self, transac: Iterable, column_names: Iterable[str]) -> str:
+        ks = ",".join(column_names)
+        embed_tuple_index = tuple(column_names).index(
+            self.config.column_map["embedding"]
+        )
+        _data = []
+        for n in transac:
+            n = ",".join(
+                [
+                    (
+                        f"'{self.escape_str(str(_n))}'"
+                        if idx != embed_tuple_index
+                        else f"array<float>{str(_n)}"
+                    )
+                    for (idx, _n) in enumerate(n)
+                ]
+            )
+            _data.append(f"({n})")
+        i_str = f"""
+                INSERT INTO
+                    {self.config.database}.{self.config.table}({ks})
+                VALUES
+                {','.join(_data)}
+                """
+        return i_str
+
+    def _insert(self, transac: Iterable, column_names: Iterable[str]) -> None:
+        _insert_query = self._build_insert_sql(transac, column_names)
+        debug_output(_insert_query)
+        get_named_result(self.connection, _insert_query)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        batch_size: int = 32,
+        ids: Optional[Iterable[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Insert more texts through the embeddings and add to the VectorStore.
+
+        Args:
+            texts: Iterable of strings to add to the VectorStore.
+            ids: Optional list of ids to associate with the texts.
+            batch_size: Batch size of insertion
+            metadata: Optional column data to be inserted
+
+        Returns:
+            List of ids from adding the texts into the VectorStore.
+
+        """
+        # Embed and create the documents
+        ids = ids or [sha1(t.encode("utf-8")).hexdigest() for t in texts]
+        colmap_ = self.config.column_map
+        transac = []
+        column_names = {
+            colmap_["id"]: ids,
+            colmap_["document"]: texts,
+            colmap_["embedding"]: self.embedding_function.embed_documents(list(texts)),
+        }
+        metadatas = metadatas or [{} for _ in texts]
+        column_names[colmap_["metadata"]] = map(json.dumps, metadatas)
+        assert len(set(colmap_) - set(column_names)) >= 0
+        keys, values = zip(*column_names.items())
+        try:
+            t = None
+            for v in self.pgbar(
+                zip(*values), desc="Inserting data...", total=len(metadatas)
+            ):
+                assert (
+                    len(v[keys.index(self.config.column_map["embedding"])]) == self.dim
+                )
+                transac.append(v)
+                if len(transac) == batch_size:
+                    if t:
+                        t.join()
+                    t = Thread(target=self._insert, args=[transac, keys])
+                    t.start()
+                    transac = []
+            if len(transac) > 0:
+                if t:
+                    t.join()
+                self._insert(transac, keys)
+            return [i for i in ids]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        config: Optional[StarRocksSettings] = None,
+        text_ids: Optional[Iterable[str]] = None,
+        batch_size: int = 32,
+        **kwargs: Any,
+    ) -> StarRocks:
+        """Create StarRocks wrapper with existing texts
+
+        Args:
+            embedding_function (Embeddings): Function to extract text embedding
+            texts (Iterable[str]): List or tuple of strings to be added
+            config (StarRocksSettings, Optional): StarRocks configuration
+            text_ids (Optional[Iterable], optional): IDs for the texts.
+                                                     Defaults to None.
+            batch_size (int, optional): Batchsize when transmitting data to StarRocks.
+                                        Defaults to 32.
+            metadata (List[dict], optional): metadata to texts. Defaults to None.
+        Returns:
+            StarRocks Index
+        """
+        ctx = cls(embedding, config, **kwargs)
+        ctx.add_texts(texts, ids=text_ids, batch_size=batch_size, metadatas=metadatas)
+        return ctx
+
+    def __repr__(self) -> str:
+        """Text representation for StarRocks Vector Store, prints backends, username
+            and schemas. Easy to use with `str(StarRocks())`
+
+        Returns:
+            repr: string to show connection info and data schema
+        """
+        _repr = f"\033[92m\033[1m{self.config.database}.{self.config.table} @ "
+        _repr += f"{self.config.host}:{self.config.port}\033[0m\n\n"
+        _repr += f"\033[1musername: {self.config.username}\033[0m\n\nTable Schema:\n"
+        width = 25
+        fields = 3
+        _repr += "-" * (width * fields + 1) + "\n"
+        columns = ["name", "type", "key"]
+        _repr += f"|\033[94m{columns[0]:24s}\033[0m|\033[96m{columns[1]:24s}"
+        _repr += f"\033[0m|\033[96m{columns[2]:24s}\033[0m|\n"
+        _repr += "-" * (width * fields + 1) + "\n"
+        q_str = f"DESC {self.config.database}.{self.config.table}"
+        debug_output(q_str)
+        rs = get_named_result(self.connection, q_str)
+        for r in rs:
+            _repr += f"|\033[94m{r['Field']:24s}\033[0m|\033[96m{r['Type']:24s}"
+            _repr += f"\033[0m|\033[96m{r['Key']:24s}\033[0m|\n"
+        _repr += "-" * (width * fields + 1) + "\n"
+        return _repr
+
+    def _build_query_sql(
+        self, q_emb: List[float], topk: int, where_str: Optional[str] = None
+    ) -> str:
+        q_emb_str = ",".join(map(str, q_emb))
+        if where_str:
+            where_str = f"WHERE {where_str}"
+        else:
+            where_str = ""
+
+        q_str = f"""
+            SELECT {self.config.column_map['document']}, 
+                {self.config.column_map['metadata']}, 
+                cosine_similarity_norm(array<float>[{q_emb_str}],
+                  {self.config.column_map['embedding']}) as dist
+            FROM {self.config.database}.{self.config.table}
+            {where_str}
+            ORDER BY dist {self.dist_order}
+            LIMIT {topk}
+            """
+
+        debug_output(q_str)
+        return q_str
+
+    def similarity_search(
+        self, query: str, k: int = 4, where_str: Optional[str] = None, **kwargs: Any
+    ) -> List[Document]:
+        """Perform a similarity search with StarRocks
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of Documents
+        """
+        return self.similarity_search_by_vector(
+            self.embedding_function.embed_query(query), k, where_str, **kwargs
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        where_str: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a similarity search with StarRocks by vectors
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of (Document, similarity)
+        """
+        q_str = self._build_query_sql(embedding, k, where_str)
+        try:
+            return [
+                Document(
+                    page_content=r[self.config.column_map["document"]],
+                    metadata=json.loads(r[self.config.column_map["metadata"]]),
+                )
+                for r in get_named_result(self.connection, q_str)
+            ]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    def similarity_search_with_relevance_scores(
+        self, query: str, k: int = 4, where_str: Optional[str] = None, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Perform a similarity search with StarRocks
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+            where_str (Optional[str], optional): where condition string.
+                                                 Defaults to None.
+
+            NOTE: Please do not let end-user to fill this and always be aware
+                  of SQL injection. When dealing with metadatas, remember to
+                  use `{self.metadata_column}.attribute` instead of `attribute`
+                  alone. The default name for it is `metadata`.
+
+        Returns:
+            List[Document]: List of documents
+        """
+        q_str = self._build_query_sql(
+            self.embedding_function.embed_query(query), k, where_str
+        )
+        try:
+            return [
+                (
+                    Document(
+                        page_content=r[self.config.column_map["document"]],
+                        metadata=json.loads(r[self.config.column_map["metadata"]]),
+                    ),
+                    r["dist"],
+                )
+                for r in get_named_result(self.connection, q_str)
+            ]
+        except Exception as e:
+            logger.error(f"\033[91m\033[1m{type(e)}\033[0m \033[95m{str(e)}\033[0m")
+            return []
+
+    def drop(self) -> None:
+        """
+        Helper function: Drop data
+        """
+        get_named_result(
+            self.connection,
+            f"DROP TABLE IF EXISTS {self.config.database}.{self.config.table}",
+        )
+
+    @property
+    def metadata_column(self) -> str:
+        return self.config.column_map["metadata"]
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/supabase.py b/llm/Lib/site-packages/langchain_community/vectorstores/supabase.py
new file mode 100644
index 0000000000000000000000000000000000000000..70b45eee02c7d007bee247fb5356ad16699034bf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/supabase.py
@@ -0,0 +1,480 @@
+from __future__ import annotations
+
+import uuid
+import warnings
+from itertools import repeat
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+if TYPE_CHECKING:
+    import supabase
+
+
+class SupabaseVectorStore(VectorStore):
+    """`Supabase Postgres` vector store.
+
+    It assumes you have the `pgvector`
+    extension installed and a `match_documents` (or similar) function. For more details:
+    https://integrations.langchain.com/vectorstores?integration_name=SupabaseVectorStore
+
+    You can implement your own `match_documents` function in order to limit the search
+    space to a subset of documents based on your own authorization or business logic.
+
+    Note that the Supabase Python client does not yet support async operations.
+
+    If you'd like to use `max_marginal_relevance_search`, please review the instructions
+    below on modifying the `match_documents` function to return matched embeddings.
+
+
+    Examples:
+
+    .. code-block:: python
+
+        from langchain_community.embeddings.openai import OpenAIEmbeddings
+        from langchain_core.documents import Document
+        from langchain_community.vectorstores import SupabaseVectorStore
+        from supabase.client import create_client
+
+        docs = [
+            Document(page_content="foo", metadata={"id": 1}),
+        ]
+        embeddings = OpenAIEmbeddings()
+        supabase_client = create_client("my_supabase_url", "my_supabase_key")
+        vector_store = SupabaseVectorStore.from_documents(
+            docs,
+            embeddings,
+            client=supabase_client,
+            table_name="documents",
+            query_name="match_documents",
+            chunk_size=500,
+        )
+
+    To load from an existing table:
+
+    .. code-block:: python
+
+        from langchain_community.embeddings.openai import OpenAIEmbeddings
+        from langchain_community.vectorstores import SupabaseVectorStore
+        from supabase.client import create_client
+
+
+        embeddings = OpenAIEmbeddings()
+        supabase_client = create_client("my_supabase_url", "my_supabase_key")
+        vector_store = SupabaseVectorStore(
+            client=supabase_client,
+            embedding=embeddings,
+            table_name="documents",
+            query_name="match_documents",
+        )
+
+    """
+
+    def __init__(
+        self,
+        client: supabase.client.Client,
+        embedding: Embeddings,
+        table_name: str,
+        chunk_size: int = 500,
+        query_name: Union[str, None] = None,
+    ) -> None:
+        """Initialize with supabase client."""
+        try:
+            import supabase  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "Could not import supabase python package. "
+                "Please install it with `pip install supabase`."
+            )
+
+        self._client = client
+        self._embedding: Embeddings = embedding
+        self.table_name = table_name or "documents"
+        self.query_name = query_name or "match_documents"
+        self.chunk_size = chunk_size or 500
+        # According to the SupabaseVectorStore JS implementation, the best chunk size
+        # is 500. Though for large datasets it can be too large so it is configurable.
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self._embedding
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        ids = ids or [str(uuid.uuid4()) for _ in texts]
+        docs = self._texts_to_documents(texts, metadatas)
+
+        vectors = self._embedding.embed_documents(list(texts))
+        return self.add_vectors(vectors, docs, ids)
+
+    @classmethod
+    def from_texts(
+        cls: Type["SupabaseVectorStore"],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        client: Optional[supabase.client.Client] = None,
+        table_name: Optional[str] = "documents",
+        query_name: Union[str, None] = "match_documents",
+        chunk_size: int = 500,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> "SupabaseVectorStore":
+        """Return VectorStore initialized from texts and embeddings."""
+
+        if not client:
+            raise ValueError("Supabase client is required.")
+
+        if not table_name:
+            raise ValueError("Supabase document table_name is required.")
+
+        embeddings = embedding.embed_documents(texts)
+        ids = [str(uuid.uuid4()) for _ in texts]
+        docs = cls._texts_to_documents(texts, metadatas)
+        cls._add_vectors(client, table_name, embeddings, docs, ids, chunk_size)
+
+        return cls(
+            client=client,
+            embedding=embedding,
+            table_name=table_name,
+            query_name=query_name,
+            chunk_size=chunk_size,
+        )
+
+    def add_vectors(
+        self,
+        vectors: List[List[float]],
+        documents: List[Document],
+        ids: List[str],
+    ) -> List[str]:
+        return self._add_vectors(
+            self._client, self.table_name, vectors, documents, ids, self.chunk_size
+        )
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        vector = self._embedding.embed_query(query)
+        return self.similarity_search_by_vector(vector, k=k, filter=filter, **kwargs)
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        result = self.similarity_search_by_vector_with_relevance_scores(
+            embedding, k=k, filter=filter, **kwargs
+        )
+
+        documents = [doc for doc, _ in result]
+
+        return documents
+
+    def similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        vector = self._embedding.embed_query(query)
+        return self.similarity_search_by_vector_with_relevance_scores(
+            vector, k=k, filter=filter, **kwargs
+        )
+
+    def match_args(
+        self, query: List[float], filter: Optional[Dict[str, Any]]
+    ) -> Dict[str, Any]:
+        ret: Dict[str, Any] = dict(query_embedding=query)
+        if filter:
+            ret["filter"] = filter
+        return ret
+
+    def similarity_search_by_vector_with_relevance_scores(
+        self,
+        query: List[float],
+        k: int,
+        filter: Optional[Dict[str, Any]] = None,
+        postgrest_filter: Optional[str] = None,
+        score_threshold: Optional[float] = None,
+    ) -> List[Tuple[Document, float]]:
+        match_documents_params = self.match_args(query, filter)
+        query_builder = self._client.rpc(self.query_name, match_documents_params)
+
+        if postgrest_filter:
+            query_builder.params = query_builder.params.set(
+                "and", f"({postgrest_filter})"
+            )
+
+        query_builder.params = query_builder.params.set("limit", k)
+
+        res = query_builder.execute()
+
+        match_result = [
+            (
+                Document(
+                    metadata=search.get("metadata", {}),  # type: ignore
+                    page_content=search.get("content", ""),
+                ),
+                search.get("similarity", 0.0),
+            )
+            for search in res.data
+            if search.get("content")
+        ]
+
+        if score_threshold is not None:
+            match_result = [
+                (doc, similarity)
+                for doc, similarity in match_result
+                if similarity >= score_threshold
+            ]
+            if len(match_result) == 0:
+                warnings.warn(
+                    "No relevant docs were retrieved using the relevance score"
+                    f" threshold {score_threshold}"
+                )
+
+        return match_result
+
+    def similarity_search_by_vector_returning_embeddings(
+        self,
+        query: List[float],
+        k: int,
+        filter: Optional[Dict[str, Any]] = None,
+        postgrest_filter: Optional[str] = None,
+    ) -> List[Tuple[Document, float, np.ndarray[np.float32, Any]]]:
+        match_documents_params = self.match_args(query, filter)
+        query_builder = self._client.rpc(self.query_name, match_documents_params)
+
+        if postgrest_filter:
+            query_builder.params = query_builder.params.set(
+                "and", f"({postgrest_filter})"
+            )
+
+        query_builder.params = query_builder.params.set("limit", k)
+
+        res = query_builder.execute()
+
+        match_result = [
+            (
+                Document(
+                    metadata=search.get("metadata", {}),  # type: ignore
+                    page_content=search.get("content", ""),
+                ),
+                search.get("similarity", 0.0),
+                # Supabase returns a vector type as its string represation (!).
+                # This is a hack to convert the string to numpy array.
+                np.fromstring(
+                    search.get("embedding", "").strip("[]"), np.float32, sep=","
+                ),
+            )
+            for search in res.data
+            if search.get("content")
+        ]
+
+        return match_result
+
+    @staticmethod
+    def _texts_to_documents(
+        texts: Iterable[str],
+        metadatas: Optional[Iterable[Dict[Any, Any]]] = None,
+    ) -> List[Document]:
+        """Return list of Documents from list of texts and metadatas."""
+        if metadatas is None:
+            metadatas = repeat({})
+
+        docs = [
+            Document(page_content=text, metadata=metadata)
+            for text, metadata in zip(texts, metadatas)
+        ]
+
+        return docs
+
+    @staticmethod
+    def _add_vectors(
+        client: supabase.client.Client,
+        table_name: str,
+        vectors: List[List[float]],
+        documents: List[Document],
+        ids: List[str],
+        chunk_size: int,
+    ) -> List[str]:
+        """Add vectors to Supabase table."""
+
+        rows: List[Dict[str, Any]] = [
+            {
+                "id": ids[idx],
+                "content": documents[idx].page_content,
+                "embedding": embedding,
+                "metadata": documents[idx].metadata,  # type: ignore
+            }
+            for idx, embedding in enumerate(vectors)
+        ]
+
+        id_list: List[str] = []
+        for i in range(0, len(rows), chunk_size):
+            chunk = rows[i : i + chunk_size]
+
+            result = client.from_(table_name).upsert(chunk).execute()  # type: ignore
+
+            if len(result.data) == 0:
+                raise Exception("Error inserting: No rows added")
+
+            # VectorStore.add_vectors returns ids as strings
+            ids = [str(i.get("id")) for i in result.data if i.get("id")]
+
+            id_list.extend(ids)
+
+        return id_list
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        result = self.similarity_search_by_vector_returning_embeddings(
+            embedding, fetch_k
+        )
+
+        matched_documents = [doc_tuple[0] for doc_tuple in result]
+        matched_embeddings = [doc_tuple[2] for doc_tuple in result]
+
+        mmr_selected = maximal_marginal_relevance(
+            np.array([embedding], dtype=np.float32),
+            matched_embeddings,
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+
+        filtered_documents = [matched_documents[i] for i in mmr_selected]
+
+        return filtered_documents
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+
+        `max_marginal_relevance_search` requires that `query_name` returns matched
+        embeddings alongside the match documents. The following function
+        demonstrates how to do this:
+
+        ```sql
+        CREATE FUNCTION match_documents_embeddings(query_embedding vector(1536),
+                                                   match_count int)
+            RETURNS TABLE(
+                id uuid,
+                content text,
+                metadata jsonb,
+                embedding vector(1536),
+                similarity float)
+            LANGUAGE plpgsql
+            AS $$
+            # variable_conflict use_column
+        BEGIN
+            RETURN query
+            SELECT
+                id,
+                content,
+                metadata,
+                embedding,
+                1 -(docstore.embedding <=> query_embedding) AS similarity
+            FROM
+                docstore
+            ORDER BY
+                docstore.embedding <=> query_embedding
+            LIMIT match_count;
+        END;
+        $$;
+        ```
+        """
+        embedding = self._embedding.embed_query(query)
+        docs = self.max_marginal_relevance_search_by_vector(
+            embedding, k, fetch_k, lambda_mult=lambda_mult
+        )
+        return docs
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> None:
+        """Delete by vector IDs.
+
+        Args:
+            ids: List of ids to delete.
+        """
+
+        if ids is None:
+            raise ValueError("No ids provided to delete.")
+
+        rows: List[Dict[str, Any]] = [
+            {
+                "id": id,
+            }
+            for id in ids
+        ]
+
+        # TODO: Check if this can be done in bulk
+        for row in rows:
+            self._client.from_(self.table_name).delete().eq("id", row["id"]).execute()
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/surrealdb.py b/llm/Lib/site-packages/langchain_community/vectorstores/surrealdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..7e48ea1e29571963e9cccdf25f98956548a77c71
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/surrealdb.py
@@ -0,0 +1,473 @@
+import asyncio
+from typing import (
+    Any,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+)
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+
+class SurrealDBStore(VectorStore):
+    """
+    SurrealDB as Vector Store.
+
+    To use, you should have the ``surrealdb`` python package installed.
+
+    Args:
+        embedding_function: Embedding function to use.
+        dburl: SurrealDB connection url
+        ns: surrealdb namespace for the vector store. (default: "langchain")
+        db: surrealdb database for the vector store. (default: "database")
+        collection: surrealdb collection for the vector store.
+            (default: "documents")
+
+        (optional) db_user and db_pass: surrealdb credentials
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores.surrealdb import SurrealDBStore
+            from langchain_community.embeddings import HuggingFaceEmbeddings
+
+            embedding_function = HuggingFaceEmbeddings()
+            dburl = "ws://localhost:8000/rpc"
+            ns = "langchain"
+            db = "docstore"
+            collection = "documents"
+            db_user = "root"
+            db_pass = "root"
+
+            sdb = SurrealDBStore.from_texts(
+                    texts=texts,
+                    embedding=embedding_function,
+                    dburl,
+                    ns, db, collection,
+                    db_user=db_user, db_pass=db_pass)
+    """
+
+    def __init__(
+        self,
+        embedding_function: Embeddings,
+        **kwargs: Any,
+    ) -> None:
+        try:
+            from surrealdb import Surreal
+        except ImportError as e:
+            raise ImportError(
+                """Cannot import from surrealdb.
+                please install with `pip install surrealdb`."""
+            ) from e
+
+        self.dburl = kwargs.pop("dburl", "ws://localhost:8000/rpc")
+
+        if self.dburl[0:2] == "ws":
+            self.sdb = Surreal(self.dburl)
+        else:
+            raise ValueError("Only websocket connections are supported at this time.")
+
+        self.ns = kwargs.pop("ns", "langchain")
+        self.db = kwargs.pop("db", "database")
+        self.collection = kwargs.pop("collection", "documents")
+        self.embedding_function = embedding_function
+        self.kwargs = kwargs
+
+    async def initialize(self) -> None:
+        """
+        Initialize connection to surrealdb database
+        and authenticate if credentials are provided
+        """
+        await self.sdb.connect()
+        if "db_user" in self.kwargs and "db_pass" in self.kwargs:
+            user = self.kwargs.get("db_user")
+            password = self.kwargs.get("db_pass")
+            await self.sdb.signin({"user": user, "pass": password})
+        await self.sdb.use(self.ns, self.db)
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return (
+            self.embedding_function
+            if isinstance(self.embedding_function, Embeddings)
+            else None
+        )
+
+    async def aadd_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add list of text along with embeddings to the vector store asynchronously
+
+        Args:
+            texts (Iterable[str]): collection of text to add to the database
+
+        Returns:
+            List of ids for the newly inserted documents
+        """
+        embeddings = self.embedding_function.embed_documents(list(texts))
+        ids = []
+        for idx, text in enumerate(texts):
+            data = {"text": text, "embedding": embeddings[idx]}
+            if metadatas is not None and idx < len(metadatas):
+                data["metadata"] = metadatas[idx]  # type: ignore[assignment]
+            else:
+                data["metadata"] = []
+            record = await self.sdb.create(
+                self.collection,
+                data,
+            )
+            ids.append(record[0]["id"])
+        return ids
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add list of text along with embeddings to the vector store
+
+        Args:
+            texts (Iterable[str]): collection of text to add to the database
+
+        Returns:
+            List of ids for the newly inserted documents
+        """
+
+        async def _add_texts(
+            texts: Iterable[str],
+            metadatas: Optional[List[dict]] = None,
+            **kwargs: Any,
+        ) -> List[str]:
+            await self.initialize()
+            return await self.aadd_texts(texts, metadatas, **kwargs)
+
+        return asyncio.run(_add_texts(texts, metadatas, **kwargs))
+
+    async def adelete(
+        self,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Optional[bool]:
+        """Delete by document ID asynchronously.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise.
+        """
+
+        if ids is None:
+            await self.sdb.delete(self.collection)
+            return True
+        else:
+            if isinstance(ids, str):
+                await self.sdb.delete(ids)
+                return True
+            else:
+                if isinstance(ids, list) and len(ids) > 0:
+                    _ = [await self.sdb.delete(id) for id in ids]
+                    return True
+        return False
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Optional[bool]:
+        """Delete by document ID.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise.
+        """
+
+        async def _delete(ids: Optional[List[str]], **kwargs: Any) -> Optional[bool]:
+            await self.initialize()
+            return await self.adelete(ids=ids, **kwargs)
+
+        return asyncio.run(_delete(ids, **kwargs))
+
+    async def _asimilarity_search_by_vector_with_score(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search for query embedding asynchronously
+        and return documents and scores
+
+        Args:
+            embedding (List[float]): Query embedding.
+            k (int): Number of results to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar along with scores
+        """
+        args = {
+            "collection": self.collection,
+            "embedding": embedding,
+            "k": k,
+            "score_threshold": kwargs.get("score_threshold", 0),
+        }
+        query = f"""
+        select
+            id,
+            text,
+            metadata,
+            vector::similarity::cosine(embedding, $embedding) as similarity
+        from ⟨{args["collection"]}⟩
+        where vector::similarity::cosine(embedding, $embedding) >= $score_threshold
+        order by similarity desc LIMIT $k;
+        """
+        results = await self.sdb.query(query, args)
+
+        if len(results) == 0:
+            return []
+
+        result = results[0]
+
+        if result["status"] != "OK":
+            from surrealdb.ws import SurrealException
+
+            err = result.get("result", "Unknown Error")
+            raise SurrealException(err)
+
+        return [
+            (
+                Document(
+                    page_content=doc["text"],
+                    metadata={"id": doc["id"], **(doc.get("metadata", None) or {})},
+                ),
+                doc["similarity"],
+            )
+            for doc in result["result"]
+        ]
+
+    async def asimilarity_search_with_relevance_scores(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search asynchronously and return relevance scores
+
+        Args:
+            query (str): Query
+            k (int): Number of results to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar along with relevance scores
+        """
+        query_embedding = self.embedding_function.embed_query(query)
+        return [
+            (document, similarity)
+            for document, similarity in (
+                await self._asimilarity_search_by_vector_with_score(
+                    query_embedding, k, **kwargs
+                )
+            )
+        ]
+
+    def similarity_search_with_relevance_scores(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search synchronously and return relevance scores
+
+        Args:
+            query (str): Query
+            k (int): Number of results to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar along with relevance scores
+        """
+
+        async def _similarity_search_with_relevance_scores() -> (
+            List[Tuple[Document, float]]
+        ):
+            await self.initialize()
+            return await self.asimilarity_search_with_relevance_scores(
+                query, k, **kwargs
+            )
+
+        return asyncio.run(_similarity_search_with_relevance_scores())
+
+    async def asimilarity_search_with_score(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search asynchronously and return distance scores
+
+        Args:
+            query (str): Query
+            k (int): Number of results to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar along with relevance distance scores
+        """
+        query_embedding = self.embedding_function.embed_query(query)
+        return [
+            (document, similarity)
+            for document, similarity in (
+                await self._asimilarity_search_by_vector_with_score(
+                    query_embedding, k, **kwargs
+                )
+            )
+        ]
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search synchronously and return distance scores
+
+        Args:
+            query (str): Query
+            k (int): Number of results to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar along with relevance distance scores
+        """
+
+        async def _similarity_search_with_score() -> List[Tuple[Document, float]]:
+            await self.initialize()
+            return await self.asimilarity_search_with_score(query, k, **kwargs)
+
+        return asyncio.run(_similarity_search_with_score())
+
+    async def asimilarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Run similarity search on query embedding asynchronously
+
+        Args:
+            embedding (List[float]): Query embedding
+            k (int): Number of results to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query
+        """
+        return [
+            document
+            for document, _ in await self._asimilarity_search_by_vector_with_score(
+                embedding, k, **kwargs
+            )
+        ]
+
+    def similarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Run similarity search on query embedding
+
+        Args:
+            embedding (List[float]): Query embedding
+            k (int): Number of results to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query
+        """
+
+        async def _similarity_search_by_vector() -> List[Document]:
+            await self.initialize()
+            return await self.asimilarity_search_by_vector(embedding, k, **kwargs)
+
+        return asyncio.run(_similarity_search_by_vector())
+
+    async def asimilarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Run similarity search on query asynchronously
+
+        Args:
+            query (str): Query
+            k (int): Number of results to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query
+        """
+        query_embedding = self.embedding_function.embed_query(query)
+        return await self.asimilarity_search_by_vector(query_embedding, k, **kwargs)
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Run similarity search on query
+
+        Args:
+            query (str): Query
+            k (int): Number of results to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query
+        """
+
+        async def _similarity_search() -> List[Document]:
+            await self.initialize()
+            return await self.asimilarity_search(query, k, **kwargs)
+
+        return asyncio.run(_similarity_search())
+
+    @classmethod
+    async def afrom_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> "SurrealDBStore":
+        """Create SurrealDBStore from list of text asynchronously
+
+        Args:
+            texts (List[str]): list of text to vectorize and store
+            embedding (Optional[Embeddings]): Embedding function.
+            dburl (str): SurrealDB connection url
+                (default: "ws://localhost:8000/rpc")
+            ns (str): surrealdb namespace for the vector store.
+                (default: "langchain")
+            db (str): surrealdb database for the vector store.
+                (default: "database")
+            collection (str): surrealdb collection for the vector store.
+                (default: "documents")
+
+            (optional) db_user and db_pass: surrealdb credentials
+
+        Returns:
+            SurrealDBStore object initialized and ready for use."""
+
+        sdb = cls(embedding, **kwargs)
+        await sdb.initialize()
+        await sdb.aadd_texts(texts, metadatas, **kwargs)
+        return sdb
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> "SurrealDBStore":
+        """Create SurrealDBStore from list of text
+
+        Args:
+            texts (List[str]): list of text to vectorize and store
+            embedding (Optional[Embeddings]): Embedding function.
+            dburl (str): SurrealDB connection url
+            ns (str): surrealdb namespace for the vector store.
+                (default: "langchain")
+            db (str): surrealdb database for the vector store.
+                (default: "database")
+            collection (str): surrealdb collection for the vector store.
+                (default: "documents")
+
+            (optional) db_user and db_pass: surrealdb credentials
+
+        Returns:
+            SurrealDBStore object initialized and ready for use."""
+        sdb = asyncio.run(cls.afrom_texts(texts, embedding, metadatas, **kwargs))
+        return sdb
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/tair.py b/llm/Lib/site-packages/langchain_community/vectorstores/tair.py
new file mode 100644
index 0000000000000000000000000000000000000000..4ff8fb8a35fdad7a832fcf0425f387ce1c4502a4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/tair.py
@@ -0,0 +1,309 @@
+from __future__ import annotations
+
+import json
+import logging
+import uuid
+from typing import Any, Iterable, List, Optional, Type
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_dict_or_env
+from langchain_core.vectorstores import VectorStore
+
+logger = logging.getLogger(__name__)
+
+
+def _uuid_key() -> str:
+    return uuid.uuid4().hex
+
+
+class Tair(VectorStore):
+    """`Tair` vector store."""
+
+    def __init__(
+        self,
+        embedding_function: Embeddings,
+        url: str,
+        index_name: str,
+        content_key: str = "content",
+        metadata_key: str = "metadata",
+        search_params: Optional[dict] = None,
+        **kwargs: Any,
+    ):
+        self.embedding_function = embedding_function
+        self.index_name = index_name
+        try:
+            from tair import Tair as TairClient
+        except ImportError:
+            raise ImportError(
+                "Could not import tair python package. "
+                "Please install it with `pip install tair`."
+            )
+        try:
+            # connect to tair from url
+            client = TairClient.from_url(url, **kwargs)
+        except ValueError as e:
+            raise ValueError(f"Tair failed to connect: {e}")
+
+        self.client = client
+        self.content_key = content_key
+        self.metadata_key = metadata_key
+        self.search_params = search_params
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding_function
+
+    def create_index_if_not_exist(
+        self,
+        dim: int,
+        distance_type: str,
+        index_type: str,
+        data_type: str,
+        **kwargs: Any,
+    ) -> bool:
+        index = self.client.tvs_get_index(self.index_name)
+        if index is not None:
+            logger.info("Index already exists")
+            return False
+        self.client.tvs_create_index(
+            self.index_name,
+            dim,
+            distance_type,
+            index_type,
+            data_type,
+            **kwargs,
+        )
+        return True
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add texts data to an existing index."""
+        ids = []
+        keys = kwargs.get("keys", None)
+        use_hybrid_search = False
+        index = self.client.tvs_get_index(self.index_name)
+        if index is not None and index.get("lexical_algorithm") == "bm25":
+            use_hybrid_search = True
+        # Write data to tair
+        pipeline = self.client.pipeline(transaction=False)
+        embeddings = self.embedding_function.embed_documents(list(texts))
+        for i, text in enumerate(texts):
+            # Use provided key otherwise use default key
+            key = keys[i] if keys else _uuid_key()
+            metadata = metadatas[i] if metadatas else {}
+            if use_hybrid_search:
+                # tair use TEXT attr hybrid search
+                pipeline.tvs_hset(
+                    self.index_name,
+                    key,
+                    embeddings[i],
+                    False,
+                    **{
+                        "TEXT": text,
+                        self.content_key: text,
+                        self.metadata_key: json.dumps(metadata),
+                    },
+                )
+            else:
+                pipeline.tvs_hset(
+                    self.index_name,
+                    key,
+                    embeddings[i],
+                    False,
+                    **{
+                        self.content_key: text,
+                        self.metadata_key: json.dumps(metadata),
+                    },
+                )
+            ids.append(key)
+        pipeline.execute()
+        return ids
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """
+        Returns the most similar indexed documents to the query text.
+
+        Args:
+            query (str): The query text for which to find similar documents.
+            k (int): The number of documents to return. Default is 4.
+
+        Returns:
+            List[Document]: A list of documents that are most similar to the query text.
+        """
+        # Creates embedding vector from user query
+        embedding = self.embedding_function.embed_query(query)
+
+        keys_and_scores = self.client.tvs_knnsearch(
+            self.index_name, k, embedding, False, None, **kwargs
+        )
+
+        pipeline = self.client.pipeline(transaction=False)
+        for key, _ in keys_and_scores:
+            pipeline.tvs_hmget(
+                self.index_name, key, self.metadata_key, self.content_key
+            )
+        docs = pipeline.execute()
+
+        return [
+            Document(
+                page_content=d[1],
+                metadata=json.loads(d[0]),
+            )
+            for d in docs
+        ]
+
+    @classmethod
+    def from_texts(
+        cls: Type[Tair],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        index_name: str = "langchain",
+        content_key: str = "content",
+        metadata_key: str = "metadata",
+        **kwargs: Any,
+    ) -> Tair:
+        try:
+            from tair import tairvector
+        except ImportError:
+            raise ValueError(
+                "Could not import tair python package. "
+                "Please install it with `pip install tair`."
+            )
+        url = get_from_dict_or_env(kwargs, "tair_url", "TAIR_URL")
+        if "tair_url" in kwargs:
+            kwargs.pop("tair_url")
+
+        distance_type = tairvector.DistanceMetric.InnerProduct
+        if "distance_type" in kwargs:
+            distance_type = kwargs.pop("distance_type")
+        index_type = tairvector.IndexType.HNSW
+        if "index_type" in kwargs:
+            index_type = kwargs.pop("index_type")
+        data_type = tairvector.DataType.Float32
+        if "data_type" in kwargs:
+            data_type = kwargs.pop("data_type")
+        index_params = {}
+        if "index_params" in kwargs:
+            index_params = kwargs.pop("index_params")
+        search_params = {}
+        if "search_params" in kwargs:
+            search_params = kwargs.pop("search_params")
+
+        keys = None
+        if "keys" in kwargs:
+            keys = kwargs.pop("keys")
+        try:
+            tair_vector_store = cls(
+                embedding,
+                url,
+                index_name,
+                content_key=content_key,
+                metadata_key=metadata_key,
+                search_params=search_params,
+                **kwargs,
+            )
+        except ValueError as e:
+            raise ValueError(f"tair failed to connect: {e}")
+
+        # Create embeddings for documents
+        embeddings = embedding.embed_documents(texts)
+
+        tair_vector_store.create_index_if_not_exist(
+            len(embeddings[0]),
+            distance_type,
+            index_type,
+            data_type,
+            **index_params,
+        )
+
+        tair_vector_store.add_texts(texts, metadatas, keys=keys)
+        return tair_vector_store
+
+    @classmethod
+    def from_documents(
+        cls,
+        documents: List[Document],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        index_name: str = "langchain",
+        content_key: str = "content",
+        metadata_key: str = "metadata",
+        **kwargs: Any,
+    ) -> Tair:
+        texts = [d.page_content for d in documents]
+        metadatas = [d.metadata for d in documents]
+
+        return cls.from_texts(
+            texts, embedding, metadatas, index_name, content_key, metadata_key, **kwargs
+        )
+
+    @staticmethod
+    def drop_index(
+        index_name: str = "langchain",
+        **kwargs: Any,
+    ) -> bool:
+        """
+        Drop an existing index.
+
+        Args:
+            index_name (str): Name of the index to drop.
+
+        Returns:
+            bool: True if the index is dropped successfully.
+        """
+        try:
+            from tair import Tair as TairClient
+        except ImportError:
+            raise ValueError(
+                "Could not import tair python package. "
+                "Please install it with `pip install tair`."
+            )
+        url = get_from_dict_or_env(kwargs, "tair_url", "TAIR_URL")
+
+        try:
+            if "tair_url" in kwargs:
+                kwargs.pop("tair_url")
+            client = TairClient.from_url(url=url, **kwargs)
+        except ValueError as e:
+            raise ValueError(f"Tair connection error: {e}")
+        # delete index
+        ret = client.tvs_del_index(index_name)
+        if ret == 0:
+            # index not exist
+            logger.info("Index does not exist")
+            return False
+        return True
+
+    @classmethod
+    def from_existing_index(
+        cls,
+        embedding: Embeddings,
+        index_name: str = "langchain",
+        content_key: str = "content",
+        metadata_key: str = "metadata",
+        **kwargs: Any,
+    ) -> Tair:
+        """Connect to an existing Tair index."""
+        url = get_from_dict_or_env(kwargs, "tair_url", "TAIR_URL")
+
+        search_params = {}
+        if "search_params" in kwargs:
+            search_params = kwargs.pop("search_params")
+
+        return cls(
+            embedding,
+            url,
+            index_name,
+            content_key=content_key,
+            metadata_key=metadata_key,
+            search_params=search_params,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/tencentvectordb.py b/llm/Lib/site-packages/langchain_community/vectorstores/tencentvectordb.py
new file mode 100644
index 0000000000000000000000000000000000000000..53036b4802e02c7c7944eccc6bbb718760064d1c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/tencentvectordb.py
@@ -0,0 +1,559 @@
+"""Wrapper around the Tencent vector database."""
+from __future__ import annotations
+
+import json
+import logging
+import time
+from enum import Enum
+from typing import Any, Dict, Iterable, List, Optional, Sequence, Tuple, Union, cast
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.utils import guard_import
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+logger = logging.getLogger(__name__)
+
+
+META_FIELD_TYPE_UINT64 = "uint64"
+META_FIELD_TYPE_STRING = "string"
+META_FIELD_TYPE_ARRAY = "array"
+META_FIELD_TYPE_VECTOR = "vector"
+
+META_FIELD_TYPES = [
+    META_FIELD_TYPE_UINT64,
+    META_FIELD_TYPE_STRING,
+    META_FIELD_TYPE_ARRAY,
+    META_FIELD_TYPE_VECTOR,
+]
+
+
+class ConnectionParams:
+    """Tencent vector DB Connection params.
+
+    See the following documentation for details:
+    https://cloud.tencent.com/document/product/1709/95820
+
+    Attribute:
+        url (str) : The access address of the vector database server
+            that the client needs to connect to.
+        key (str): API key for client to access the vector database server,
+            which is used for authentication.
+        username (str) : Account for client to access the vector database server.
+        timeout (int) : Request Timeout.
+    """
+
+    def __init__(self, url: str, key: str, username: str = "root", timeout: int = 10):
+        self.url = url
+        self.key = key
+        self.username = username
+        self.timeout = timeout
+
+
+class IndexParams:
+    """Tencent vector DB Index params.
+
+    See the following documentation for details:
+    https://cloud.tencent.com/document/product/1709/95826
+    """
+
+    def __init__(
+        self,
+        dimension: int,
+        shard: int = 1,
+        replicas: int = 2,
+        index_type: str = "HNSW",
+        metric_type: str = "L2",
+        params: Optional[Dict] = None,
+    ):
+        self.dimension = dimension
+        self.shard = shard
+        self.replicas = replicas
+        self.index_type = index_type
+        self.metric_type = metric_type
+        self.params = params
+
+
+class MetaField(BaseModel):
+    """MetaData Field for Tencent vector DB."""
+
+    name: str
+    description: Optional[str]
+    data_type: Union[str, Enum]
+    index: bool = False
+
+    def __init__(self, **data: Any) -> None:
+        super().__init__(**data)
+        enum = guard_import("tcvectordb.model.enum")
+        if isinstance(self.data_type, str):
+            if self.data_type not in META_FIELD_TYPES:
+                raise ValueError(f"unsupported data_type {self.data_type}")
+            target = [
+                fe
+                for fe in enum.FieldType
+                if fe.value.lower() == self.data_type.lower()
+            ]
+            if target:
+                self.data_type = target[0]
+            else:
+                raise ValueError(f"unsupported data_type {self.data_type}")
+        else:
+            if self.data_type not in enum.FieldType:
+                raise ValueError(f"unsupported data_type {self.data_type}")
+
+
+def translate_filter(
+    lc_filter: str, allowed_fields: Optional[Sequence[str]] = None
+) -> str:
+    from langchain.chains.query_constructor.base import fix_filter_directive
+    from langchain.chains.query_constructor.ir import FilterDirective
+    from langchain.chains.query_constructor.parser import get_parser
+    from langchain.retrievers.self_query.tencentvectordb import (
+        TencentVectorDBTranslator,
+    )
+
+    tvdb_visitor = TencentVectorDBTranslator(allowed_fields)
+    flt = cast(
+        Optional[FilterDirective],
+        get_parser(
+            allowed_comparators=tvdb_visitor.allowed_comparators,
+            allowed_operators=tvdb_visitor.allowed_operators,
+            allowed_attributes=allowed_fields,
+        ).parse(lc_filter),
+    )
+    flt = fix_filter_directive(flt)
+    return flt.accept(tvdb_visitor) if flt else ""
+
+
+class TencentVectorDB(VectorStore):
+    """Tencent VectorDB as a vector store.
+
+    In order to use this you need to have a database instance.
+    See the following documentation for details:
+    https://cloud.tencent.com/document/product/1709/94951
+    """
+
+    field_id: str = "id"
+    field_vector: str = "vector"
+    field_text: str = "text"
+    field_metadata: str = "metadata"
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        connection_params: ConnectionParams,
+        index_params: IndexParams = IndexParams(768),
+        database_name: str = "LangChainDatabase",
+        collection_name: str = "LangChainCollection",
+        drop_old: Optional[bool] = False,
+        collection_description: Optional[str] = "Collection for LangChain",
+        meta_fields: Optional[List[MetaField]] = None,
+        t_vdb_embedding: Optional[str] = "bge-base-zh",
+    ):
+        self.document = guard_import("tcvectordb.model.document")
+        tcvectordb = guard_import("tcvectordb")
+        tcollection = guard_import("tcvectordb.model.collection")
+        enum = guard_import("tcvectordb.model.enum")
+
+        if t_vdb_embedding:
+            embedding_model = [
+                model
+                for model in enum.EmbeddingModel
+                if t_vdb_embedding == model.model_name
+            ]
+            if not any(embedding_model):
+                raise ValueError(
+                    f"embedding model `{t_vdb_embedding}` is invalid. "
+                    f"choices: {[member.model_name for member in enum.EmbeddingModel]}"
+                )
+            self.embedding_model = tcollection.Embedding(
+                vector_field="vector", field="text", model=embedding_model[0]
+            )
+        self.embedding_func = embedding
+        self.index_params = index_params
+        self.collection_description = collection_description
+        self.vdb_client = tcvectordb.VectorDBClient(
+            url=connection_params.url,
+            username=connection_params.username,
+            key=connection_params.key,
+            timeout=connection_params.timeout,
+        )
+        self.meta_fields = meta_fields
+        db_list = self.vdb_client.list_databases()
+        db_exist: bool = False
+        for db in db_list:
+            if database_name == db.database_name:
+                db_exist = True
+                break
+        if db_exist:
+            self.database = self.vdb_client.database(database_name)
+        else:
+            self.database = self.vdb_client.create_database(database_name)
+        try:
+            self.collection = self.database.describe_collection(collection_name)
+            if drop_old:
+                self.database.drop_collection(collection_name)
+                self._create_collection(collection_name)
+        except tcvectordb.exceptions.VectorDBException:
+            self._create_collection(collection_name)
+
+    def _create_collection(self, collection_name: str) -> None:
+        enum = guard_import("tcvectordb.model.enum")
+        vdb_index = guard_import("tcvectordb.model.index")
+
+        index_type = enum.IndexType.__members__.get(self.index_params.index_type)
+        if index_type is None:
+            raise ValueError("unsupported index_type")
+        metric_type = enum.MetricType.__members__.get(self.index_params.metric_type)
+        if metric_type is None:
+            raise ValueError("unsupported metric_type")
+        params = vdb_index.HNSWParams(
+            m=(self.index_params.params or {}).get("M", 16),
+            efconstruction=(self.index_params.params or {}).get("efConstruction", 200),
+        )
+
+        index = vdb_index.Index(
+            vdb_index.FilterIndex(
+                self.field_id, enum.FieldType.String, enum.IndexType.PRIMARY_KEY
+            ),
+            vdb_index.VectorIndex(
+                self.field_vector,
+                self.index_params.dimension,
+                index_type,
+                metric_type,
+                params,
+            ),
+            vdb_index.FilterIndex(
+                self.field_text, enum.FieldType.String, enum.IndexType.FILTER
+            ),
+        )
+        # Add metadata indexes
+        if self.meta_fields is not None:
+            index_meta_fields = [field for field in self.meta_fields if field.index]
+            for field in index_meta_fields:
+                ft_index = vdb_index.FilterIndex(
+                    field.name, field.data_type, enum.IndexType.FILTER
+                )
+                index.add(ft_index)
+        else:
+            index.add(
+                vdb_index.FilterIndex(
+                    self.field_metadata, enum.FieldType.String, enum.IndexType.FILTER
+                )
+            )
+        self.collection = self.database.create_collection(
+            name=collection_name,
+            shard=self.index_params.shard,
+            replicas=self.index_params.replicas,
+            description=self.collection_description,
+            index=index,
+            embedding=self.embedding_model,
+        )
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding_func
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        filter_expr: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Optional[bool]:
+        """Delete documents from the collection."""
+        delete_attrs = {}
+        if ids:
+            delete_attrs["ids"] = ids
+        if filter_expr:
+            delete_attrs["filter"] = self.document.Filter(filter_expr)
+        self.collection.delete(**delete_attrs)
+        return True
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        connection_params: Optional[ConnectionParams] = None,
+        index_params: Optional[IndexParams] = None,
+        database_name: str = "LangChainDatabase",
+        collection_name: str = "LangChainCollection",
+        drop_old: Optional[bool] = False,
+        collection_description: Optional[str] = "Collection for LangChain",
+        meta_fields: Optional[List[MetaField]] = None,
+        t_vdb_embedding: Optional[str] = "bge-base-zh",
+        **kwargs: Any,
+    ) -> TencentVectorDB:
+        """Create a collection, indexes it with HNSW, and insert data."""
+        if len(texts) == 0:
+            raise ValueError("texts is empty")
+        if connection_params is None:
+            raise ValueError("connection_params is empty")
+        enum = guard_import("tcvectordb.model.enum")
+        if embedding is None and t_vdb_embedding is None:
+            raise ValueError("embedding and t_vdb_embedding cannot be both None")
+        if embedding:
+            embeddings = embedding.embed_documents(texts[0:1])
+            dimension = len(embeddings[0])
+        else:
+            embedding_model = [
+                model
+                for model in enum.EmbeddingModel
+                if t_vdb_embedding == model.model_name
+            ]
+            if not any(embedding_model):
+                raise ValueError(
+                    f"embedding model `{t_vdb_embedding}` is invalid. "
+                    f"choices: {[member.model_name for member in enum.EmbeddingModel]}"
+                )
+            dimension = embedding_model[0]._EmbeddingModel__dimensions
+        if index_params is None:
+            index_params = IndexParams(dimension=dimension)
+        else:
+            index_params.dimension = dimension
+        vector_db = cls(
+            embedding=embedding,
+            connection_params=connection_params,
+            index_params=index_params,
+            database_name=database_name,
+            collection_name=collection_name,
+            drop_old=drop_old,
+            collection_description=collection_description,
+            meta_fields=meta_fields,
+            t_vdb_embedding=t_vdb_embedding,
+        )
+        vector_db.add_texts(texts=texts, metadatas=metadatas)
+        return vector_db
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        timeout: Optional[int] = None,
+        batch_size: int = 1000,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Insert text data into TencentVectorDB."""
+        texts = list(texts)
+        if len(texts) == 0:
+            logger.debug("Nothing to insert, skipping.")
+            return []
+        if self.embedding_func:
+            embeddings = self.embedding_func.embed_documents(texts)
+        else:
+            embeddings = []
+        pks: list[str] = []
+        total_count = len(texts)
+        for start in range(0, total_count, batch_size):
+            # Grab end index
+            docs = []
+            end = min(start + batch_size, total_count)
+            for id in range(start, end, 1):
+                metadata = (
+                    self._get_meta(metadatas[id]) if metadatas and metadatas[id] else {}
+                )
+                doc_id = ids[id] if ids else None
+                doc_attrs: Dict[str, Any] = {
+                    "id": doc_id
+                    or "{}-{}-{}".format(time.time_ns(), hash(texts[id]), id)
+                }
+                if embeddings:
+                    doc_attrs["vector"] = embeddings[id]
+                else:
+                    doc_attrs["text"] = texts[id]
+                doc_attrs.update(metadata)
+                doc = self.document.Document(**doc_attrs)
+                docs.append(doc)
+                pks.append(doc_attrs["id"])
+            self.collection.upsert(docs, timeout)
+        return pks
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a similarity search against the query string."""
+        res = self.similarity_search_with_score(
+            query=query, k=k, param=param, expr=expr, timeout=timeout, **kwargs
+        )
+        return [doc for doc, _ in res]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Perform a search on a query string and return results with score."""
+        # Embed the query text.
+        if self.embedding_func:
+            embedding = self.embedding_func.embed_query(query)
+            return self.similarity_search_with_score_by_vector(
+                embedding=embedding,
+                k=k,
+                param=param,
+                expr=expr,
+                timeout=timeout,
+                **kwargs,
+            )
+        return self.similarity_search_with_score_by_vector(
+            embedding=[],
+            k=k,
+            param=param,
+            expr=expr,
+            timeout=timeout,
+            query=query,
+            **kwargs,
+        )
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a similarity search against the query string."""
+        docs = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, param=param, expr=expr, timeout=timeout, **kwargs
+        )
+        return [doc for doc, _ in docs]
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        filter: Optional[str] = None,
+        timeout: Optional[int] = None,
+        query: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Perform a search on a query string and return results with score."""
+        if filter and not expr:
+            expr = translate_filter(
+                filter, [f.name for f in (self.meta_fields or []) if f.index]
+            )
+        search_args = {
+            "filter": self.document.Filter(expr) if expr else None,
+            "params": self.document.HNSWSearchParams(ef=(param or {}).get("ef", 10)),
+            "retrieve_vector": False,
+            "limit": k,
+            "timeout": timeout,
+        }
+        if query:
+            search_args["embeddingItems"] = [query]
+            res: List[List[Dict]] = self.collection.searchByText(**search_args).get(
+                "documents"
+            )
+        else:
+            search_args["vectors"] = [embedding]
+            res = self.collection.search(**search_args)
+
+        ret: List[Tuple[Document, float]] = []
+        if res is None or len(res) == 0:
+            return ret
+        for result in res[0]:
+            meta = self._get_meta(result)
+            doc = Document(page_content=result.get(self.field_text), metadata=meta)  # type: ignore[arg-type]
+            pair = (doc, result.get("score", 0.0))
+            ret.append(pair)
+        return ret
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a search and return results that are reordered by MMR."""
+        if self.embedding_func:
+            embedding = self.embedding_func.embed_query(query)
+            return self.max_marginal_relevance_search_by_vector(
+                embedding=embedding,
+                k=k,
+                fetch_k=fetch_k,
+                lambda_mult=lambda_mult,
+                param=param,
+                expr=expr,
+                timeout=timeout,
+                **kwargs,
+            )
+        # tvdb will do the query embedding
+        docs = self.similarity_search_with_score(
+            query=query, k=fetch_k, param=param, expr=expr, timeout=timeout, **kwargs
+        )
+        return [doc for doc, _ in docs]
+
+    def _get_meta(self, result: Dict) -> Dict:
+        """Get metadata from the result."""
+
+        if self.meta_fields:
+            return {field.name: result.get(field.name) for field in self.meta_fields}
+        elif result.get(self.field_metadata):
+            raw_meta = result.get(self.field_metadata)
+            if raw_meta and isinstance(raw_meta, str):
+                return json.loads(raw_meta)
+        return {}
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: list[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        param: Optional[dict] = None,
+        expr: Optional[str] = None,
+        filter: Optional[str] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a search and return results that are reordered by MMR."""
+        if filter and not expr:
+            expr = translate_filter(
+                filter, [f.name for f in (self.meta_fields or []) if f.index]
+            )
+        res: List[List[Dict]] = self.collection.search(
+            vectors=[embedding],
+            filter=self.document.Filter(expr) if expr else None,
+            params=self.document.HNSWSearchParams(ef=(param or {}).get("ef", 10)),
+            retrieve_vector=True,
+            limit=fetch_k,
+            timeout=timeout,
+        )
+        # Organize results.
+        documents = []
+        ordered_result_embeddings = []
+        for result in res[0]:
+            meta = self._get_meta(result)
+            doc = Document(page_content=result.get(self.field_text), metadata=meta)  # type: ignore[arg-type]
+            documents.append(doc)
+            ordered_result_embeddings.append(result.get(self.field_vector))
+        # Get the new order of results.
+        new_ordering = maximal_marginal_relevance(
+            np.array(embedding), ordered_result_embeddings, k=k, lambda_mult=lambda_mult
+        )
+        # Reorder the values and return.
+        return [documents[x] for x in new_ordering if x != -1]
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/thirdai_neuraldb.py b/llm/Lib/site-packages/langchain_community/vectorstores/thirdai_neuraldb.py
new file mode 100644
index 0000000000000000000000000000000000000000..beece9ce3aec17792904624f6fc2f0378ab84768
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/thirdai_neuraldb.py
@@ -0,0 +1,316 @@
+import importlib
+import os
+import tempfile
+from pathlib import Path
+from typing import Any, Dict, Iterable, List, Optional, Tuple, Union
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import Extra, root_validator
+from langchain_core.utils import convert_to_secret_str, get_from_dict_or_env
+from langchain_core.vectorstores import VectorStore
+
+
+class NeuralDBVectorStore(VectorStore):
+    """Vectorstore that uses ThirdAI's NeuralDB.
+
+    To use, you should have the ``thirdai[neural_db]`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import NeuralDBVectorStore
+            from thirdai import neural_db as ndb
+
+            db = ndb.NeuralDB()
+            vectorstore = NeuralDBVectorStore(db=db)
+    """
+
+    def __init__(self, db: Any) -> None:
+        self.db = db
+
+    db: Any = None  #: :meta private:
+    """NeuralDB instance"""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        underscore_attrs_are_private = True
+
+    @staticmethod
+    def _verify_thirdai_library(thirdai_key: Optional[str] = None):  # type: ignore[no-untyped-def]
+        try:
+            from thirdai import licensing
+
+            importlib.util.find_spec("thirdai.neural_db")
+
+            licensing.activate(thirdai_key or os.getenv("THIRDAI_KEY"))
+        except ImportError:
+            raise ModuleNotFoundError(
+                "Could not import thirdai python package and neuraldb dependencies. "
+                "Please install it with `pip install thirdai[neural_db]`."
+            )
+
+    @classmethod
+    def from_scratch(  # type: ignore[no-untyped-def, no-untyped-def]
+        cls,
+        thirdai_key: Optional[str] = None,
+        **model_kwargs,
+    ):
+        """
+        Create a NeuralDBVectorStore from scratch.
+
+        To use, set the ``THIRDAI_KEY`` environment variable with your ThirdAI
+        API key, or pass ``thirdai_key`` as a named parameter.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import NeuralDBVectorStore
+
+                vectorstore = NeuralDBVectorStore.from_scratch(
+                    thirdai_key="your-thirdai-key",
+                )
+
+                vectorstore.insert([
+                    "/path/to/doc.pdf",
+                    "/path/to/doc.docx",
+                    "/path/to/doc.csv",
+                ])
+
+                documents = vectorstore.similarity_search("AI-driven music therapy")
+        """
+        NeuralDBVectorStore._verify_thirdai_library(thirdai_key)
+        from thirdai import neural_db as ndb
+
+        return cls(db=ndb.NeuralDB(**model_kwargs))  # type: ignore[call-arg]
+
+    @classmethod
+    def from_checkpoint(  # type: ignore[no-untyped-def]
+        cls,
+        checkpoint: Union[str, Path],
+        thirdai_key: Optional[str] = None,
+    ):
+        """
+        Create a NeuralDBVectorStore with a base model from a saved checkpoint
+
+        To use, set the ``THIRDAI_KEY`` environment variable with your ThirdAI
+        API key, or pass ``thirdai_key`` as a named parameter.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import NeuralDBVectorStore
+
+                vectorstore = NeuralDBVectorStore.from_checkpoint(
+                    checkpoint="/path/to/checkpoint.ndb",
+                    thirdai_key="your-thirdai-key",
+                )
+
+                vectorstore.insert([
+                    "/path/to/doc.pdf",
+                    "/path/to/doc.docx",
+                    "/path/to/doc.csv",
+                ])
+
+                documents = vectorstore.similarity_search("AI-driven music therapy")
+        """
+        NeuralDBVectorStore._verify_thirdai_library(thirdai_key)
+        from thirdai import neural_db as ndb
+
+        return cls(db=ndb.NeuralDB.from_checkpoint(checkpoint))  # type: ignore[call-arg]
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> "NeuralDBVectorStore":
+        """Return VectorStore initialized from texts and embeddings."""
+        model_kwargs = {}
+        if "thirdai_key" in kwargs:
+            model_kwargs["thirdai_key"] = kwargs["thirdai_key"]
+            del kwargs["thirdai_key"]
+        vectorstore = cls.from_scratch(**model_kwargs)
+        vectorstore.add_texts(texts, metadatas, **kwargs)
+        return vectorstore
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        import pandas as pd
+        from thirdai import neural_db as ndb
+
+        df = pd.DataFrame({"texts": texts})
+        if metadatas:
+            df = pd.concat([df, pd.DataFrame.from_records(metadatas)], axis=1)
+        temp = tempfile.NamedTemporaryFile("w", delete=False, delete_on_close=False)  # type: ignore[call-overload]
+        df.to_csv(temp)
+        source_id = self.insert([ndb.CSV(temp.name)], **kwargs)[0]
+        offset = self.db._savable_state.documents.get_source_by_id(source_id)[1]
+        return [str(offset + i) for i in range(len(texts))]  # type: ignore[arg-type]
+
+    @root_validator()
+    def validate_environments(cls, values: Dict) -> Dict:
+        """Validate ThirdAI environment variables."""
+        values["thirdai_key"] = convert_to_secret_str(
+            get_from_dict_or_env(
+                values,
+                "thirdai_key",
+                "THIRDAI_KEY",
+            )
+        )
+        return values
+
+    def insert(  # type: ignore[no-untyped-def, no-untyped-def]
+        self,
+        sources: List[Any],
+        train: bool = True,
+        fast_mode: bool = True,
+        **kwargs,
+    ):
+        """Inserts files / document sources into the vectorstore.
+
+        Args:
+            train: When True this means that the underlying model in the
+            NeuralDB will undergo unsupervised pretraining on the inserted files.
+            Defaults to True.
+            fast_mode: Much faster insertion with a slight drop in performance.
+            Defaults to True.
+        """
+        sources = self._preprocess_sources(sources)
+        self.db.insert(
+            sources=sources,
+            train=train,
+            fast_approximation=fast_mode,
+            **kwargs,
+        )
+
+    def _preprocess_sources(self, sources):  # type: ignore[no-untyped-def]
+        """Checks if the provided sources are string paths. If they are, convert
+        to NeuralDB document objects.
+
+        Args:
+            sources: list of either string paths to PDF, DOCX or CSV files, or
+            NeuralDB document objects.
+        """
+        from thirdai import neural_db as ndb
+
+        if not sources:
+            return sources
+        preprocessed_sources = []
+        for doc in sources:
+            if not isinstance(doc, str):
+                preprocessed_sources.append(doc)
+            else:
+                if doc.lower().endswith(".pdf"):
+                    preprocessed_sources.append(ndb.PDF(doc))
+                elif doc.lower().endswith(".docx"):
+                    preprocessed_sources.append(ndb.DOCX(doc))
+                elif doc.lower().endswith(".csv"):
+                    preprocessed_sources.append(ndb.CSV(doc))
+                else:
+                    raise RuntimeError(
+                        f"Could not automatically load {doc}. Only files "
+                        "with .pdf, .docx, or .csv extensions can be loaded "
+                        "automatically. For other formats, please use the "
+                        "appropriate document object from the ThirdAI library."
+                    )
+        return preprocessed_sources
+
+    def upvote(self, query: str, document_id: Union[int, str]):  # type: ignore[no-untyped-def]
+        """The vectorstore upweights the score of a document for a specific query.
+        This is useful for fine-tuning the vectorstore to user behavior.
+
+        Args:
+            query: text to associate with `document_id`
+            document_id: id of the document to associate query with.
+        """
+        self.db.text_to_result(query, int(document_id))
+
+    def upvote_batch(self, query_id_pairs: List[Tuple[str, int]]):  # type: ignore[no-untyped-def]
+        """Given a batch of (query, document id) pairs, the vectorstore upweights
+        the scores of the document for the corresponding queries.
+        This is useful for fine-tuning the vectorstore to user behavior.
+
+        Args:
+            query_id_pairs: list of (query, document id) pairs. For each pair in
+            this list, the model will upweight the document id for the query.
+        """
+        self.db.text_to_result_batch(
+            [(query, int(doc_id)) for query, doc_id in query_id_pairs]
+        )
+
+    def associate(self, source: str, target: str):  # type: ignore[no-untyped-def]
+        """The vectorstore associates a source phrase with a target phrase.
+        When the vectorstore sees the source phrase, it will also consider results
+        that are relevant to the target phrase.
+
+        Args:
+            source: text to associate to `target`.
+            target: text to associate `source` to.
+        """
+        self.db.associate(source, target)
+
+    def associate_batch(self, text_pairs: List[Tuple[str, str]]):  # type: ignore[no-untyped-def]
+        """Given a batch of (source, target) pairs, the vectorstore associates
+        each source phrase with the corresponding target phrase.
+
+        Args:
+            text_pairs: list of (source, target) text pairs. For each pair in
+            this list, the source will be associated with the target.
+        """
+        self.db.associate_batch(text_pairs)
+
+    def similarity_search(
+        self, query: str, k: int = 10, **kwargs: Any
+    ) -> List[Document]:
+        """Retrieve {k} contexts with for a given query
+
+        Args:
+            query: Query to submit to the model
+            k: The max number of context results to retrieve. Defaults to 10.
+        """
+        try:
+            references = self.db.search(query=query, top_k=k, **kwargs)
+            return [
+                Document(
+                    page_content=ref.text,
+                    metadata={
+                        "id": ref.id,
+                        "upvote_ids": ref.upvote_ids,
+                        "source": ref.source,
+                        "metadata": ref.metadata,
+                        "score": ref.score,
+                        "context": ref.context(1),
+                    },
+                )
+                for ref in references
+            ]
+        except Exception as e:
+            raise ValueError(f"Error while retrieving documents: {e}") from e
+
+    def save(self, path: str):  # type: ignore[no-untyped-def]
+        """Saves a NeuralDB instance to disk. Can be loaded into memory by
+        calling NeuralDB.from_checkpoint(path)
+
+        Args:
+            path: path on disk to save the NeuralDB instance to.
+        """
+        self.db.save(path)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/tidb_vector.py b/llm/Lib/site-packages/langchain_community/vectorstores/tidb_vector.py
new file mode 100644
index 0000000000000000000000000000000000000000..e98d3bb6c41f0c6fdcb92b977f0a4705aacf2d76
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/tidb_vector.py
@@ -0,0 +1,364 @@
+import uuid
+from typing import Any, Callable, Dict, Iterable, List, Optional, Tuple
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+DEFAULT_DISTANCE_STRATEGY = "cosine"  # or "l2", "inner_product"
+DEFAULT_TiDB_VECTOR_TABLE_NAME = "langchain_vector"
+
+
+class TiDBVectorStore(VectorStore):
+    """TiDB Vector Store."""
+
+    def __init__(
+        self,
+        connection_string: str,
+        embedding_function: Embeddings,
+        table_name: str = DEFAULT_TiDB_VECTOR_TABLE_NAME,
+        distance_strategy: str = DEFAULT_DISTANCE_STRATEGY,
+        *,
+        engine_args: Optional[Dict[str, Any]] = None,
+        drop_existing_table: bool = False,
+        **kwargs: Any,
+    ) -> None:
+        """
+        Initialize a TiDB Vector Store in Langchain with a flexible
+        and standardized table structure for storing vector data
+        which remains fixed regardless of the dynamic table name setting.
+
+        The vector table schema includes:
+        - 'id': a UUID for each entry.
+        - 'embedding': stores vector data in a VectorType column.
+        - 'document': a Text column for the original data or additional information.
+        - 'meta': a JSON column for flexible metadata storage.
+        - 'create_time' and 'update_time': timestamp columns for tracking data changes.
+
+        This table structure caters to general use cases and
+        complex scenarios where the table serves as a semantic layer for advanced
+        data integration and analysis, leveraging SQL for join queries.
+
+        Args:
+            connection_string (str): The connection string for the TiDB database,
+                format: "mysql+pymysql://root@34.212.137.91:4000/test".
+            embedding_function: The embedding function used to generate embeddings.
+            table_name (str, optional): The name of the table that will be used to
+                store vector data. If you do not provide a table name,
+                a default table named `langchain_vector` will be created automatically.
+            distance_strategy: The strategy used for similarity search,
+                defaults to "cosine", valid values: "l2", "cosine", "inner_product".
+            engine_args (Optional[Dict]): Additional arguments for the database engine,
+                defaults to None.
+            drop_existing_table: Drop the existing TiDB table before initializing,
+                defaults to False.
+            **kwargs (Any): Additional keyword arguments.
+
+        Examples:
+            .. code-block:: python
+
+            from langchain_community.vectorstores import TiDBVectorStore
+            from langchain_openai import OpenAIEmbeddings
+
+            embeddingFunc = OpenAIEmbeddings()
+            CONNECTION_STRING = "mysql+pymysql://root@34.212.137.91:4000/test"
+
+            vs = TiDBVector.from_texts(
+                embedding=embeddingFunc,
+                texts = [..., ...],
+                connection_string=CONNECTION_STRING,
+                distance_strategy="l2",
+                table_name="tidb_vector_langchain",
+            )
+
+            query = "What did the president say about Ketanji Brown Jackson"
+            docs = db.similarity_search_with_score(query)
+
+        """
+
+        super().__init__(**kwargs)
+        self._connection_string = connection_string
+        self._embedding_function = embedding_function
+        self._distance_strategy = distance_strategy
+        self._vector_dimension = self._get_dimension()
+
+        try:
+            from tidb_vector.integrations import TiDBVectorClient
+        except ImportError:
+            raise ImportError(
+                "Could not import tidbvec python package. "
+                "Please install it with `pip install tidb-vector`."
+            )
+
+        self._tidb = TiDBVectorClient(
+            connection_string=connection_string,
+            table_name=table_name,
+            distance_strategy=distance_strategy,
+            vector_dimension=self._vector_dimension,
+            engine_args=engine_args,
+            drop_existing_table=drop_existing_table,
+            **kwargs,
+        )
+
+    @property
+    def embeddings(self) -> Embeddings:
+        """Return the function used to generate embeddings."""
+        return self._embedding_function
+
+    @property
+    def tidb_vector_client(self) -> Any:
+        """Return the TiDB Vector Client."""
+        return self._tidb
+
+    @property
+    def distance_strategy(self) -> Any:
+        """
+        Returns the current distance strategy.
+        """
+        return self._distance_strategy
+
+    def _get_dimension(self) -> int:
+        """
+        Get the dimension of the vector using embedding functions.
+        """
+        return len(self._embedding_function.embed_query("test embedding length"))
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> "TiDBVectorStore":
+        """
+        Create a VectorStore from a list of texts.
+
+        Args:
+            texts (List[str]): The list of texts to be added to the TiDB Vector.
+            embedding (Embeddings): The function to use for generating embeddings.
+            metadatas: The list of metadata dictionaries corresponding to each text,
+                defaults to None.
+            **kwargs (Any): Additional keyword arguments.
+                connection_string (str): The connection string for the TiDB database,
+                    format: "mysql+pymysql://root@34.212.137.91:4000/test".
+                table_name (str, optional): The name of table used to store vector data,
+                    defaults to "langchain_vector".
+                distance_strategy: The distance strategy used for similarity search,
+                    defaults to "cosine", allowed: "l2", "cosine", "inner_product".
+                ids (Optional[List[str]]): The list of IDs corresponding to each text,
+                    defaults to None.
+                engine_args: Additional arguments for the underlying database engine,
+                    defaults to None.
+                drop_existing_table: Drop the existing TiDB table before initializing,
+                    defaults to False.
+
+        Returns:
+            VectorStore: The created TiDB Vector Store.
+
+        """
+
+        # Extract arguments from kwargs with default values
+        connection_string = kwargs.pop("connection_string", None)
+        if connection_string is None:
+            raise ValueError("please provide your tidb connection_url")
+        table_name = kwargs.pop("table_name", "langchain_vector")
+        distance_strategy = kwargs.pop("distance_strategy", "cosine")
+        ids = kwargs.pop("ids", None)
+        engine_args = kwargs.pop("engine_args", None)
+        drop_existing_table = kwargs.pop("drop_existing_table", False)
+
+        embeddings = embedding.embed_documents(list(texts))
+
+        vs = cls(
+            connection_string=connection_string,
+            table_name=table_name,
+            embedding_function=embedding,
+            distance_strategy=distance_strategy,
+            engine_args=engine_args,
+            drop_existing_table=drop_existing_table,
+            **kwargs,
+        )
+
+        vs._tidb.insert(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+        return vs
+
+    @classmethod
+    def from_existing_vector_table(
+        cls,
+        embedding: Embeddings,
+        connection_string: str,
+        table_name: str,
+        distance_strategy: str = DEFAULT_DISTANCE_STRATEGY,
+        *,
+        engine_args: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> VectorStore:
+        """
+        Create a VectorStore instance from an existing TiDB Vector Store in TiDB.
+
+        Args:
+            embedding (Embeddings): The function to use for generating embeddings.
+            connection_string (str): The connection string for the TiDB database,
+                format: "mysql+pymysql://root@34.212.137.91:4000/test".
+            table_name (str, optional): The name of table used to store vector data,
+                defaults to "langchain_vector".
+            distance_strategy: The distance strategy used for similarity search,
+                defaults to "cosine", allowed: "l2", "cosine", 'inner_product'.
+            engine_args: Additional arguments for the underlying database engine,
+                defaults to None.
+            **kwargs (Any): Additional keyword arguments.
+        Returns:
+            VectorStore: The VectorStore instance.
+
+        Raises:
+            NoSuchTableError: If the specified table does not exist in the TiDB.
+        """
+
+        try:
+            from tidb_vector.integrations import check_table_existence
+        except ImportError:
+            raise ImportError(
+                "Could not import tidbvec python package. "
+                "Please install it with `pip install tidb-vector`."
+            )
+
+        if check_table_existence(connection_string, table_name):
+            return cls(
+                connection_string=connection_string,
+                table_name=table_name,
+                embedding_function=embedding,
+                distance_strategy=distance_strategy,
+                engine_args=engine_args,
+                **kwargs,
+            )
+        else:
+            raise ValueError(f"Table {table_name} does not exist in the TiDB database.")
+
+    def drop_vectorstore(self) -> None:
+        """
+        Drop the Vector Store from the TiDB database.
+        """
+        self._tidb.drop_table()
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """
+        Add texts to TiDB Vector Store.
+
+        Args:
+            texts (Iterable[str]): The texts to be added.
+            metadatas (Optional[List[dict]]): The metadata associated with each text,
+                Defaults to None.
+            ids (Optional[List[str]]): The IDs to be assigned to each text,
+                Defaults to None, will be generated if not provided.
+
+        Returns:
+            List[str]: The IDs assigned to the added texts.
+        """
+
+        embeddings = self._embedding_function.embed_documents(list(texts))
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        return self._tidb.insert(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """
+        Delete vector data from the TiDB Vector Store.
+
+        Args:
+            ids (Optional[List[str]]): A list of vector IDs to delete.
+            **kwargs: Additional keyword arguments.
+        """
+
+        self._tidb.delete(ids=ids, **kwargs)
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """
+        Perform a similarity search using the given query.
+
+        Args:
+            query (str): The query string.
+            k (int, optional): The number of results to retrieve. Defaults to 4.
+            filter (dict, optional): A filter to apply to the search results.
+                Defaults to None.
+            **kwargs: Additional keyword arguments.
+
+        Returns:
+            List[Document]: A list of Document objects representing the search results.
+        """
+        result = self.similarity_search_with_score(query, k, filter, **kwargs)
+        return [doc for doc, _ in result]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 5,
+        filter: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """
+        Perform a similarity search with score based on the given query.
+
+        Args:
+            query (str): The query string.
+            k (int, optional): The number of results to return. Defaults to 5.
+            filter (dict, optional): A filter to apply to the search results.
+                Defaults to None.
+            **kwargs: Additional keyword arguments.
+
+        Returns:
+            A list of tuples containing relevant documents and their similarity scores.
+        """
+        query_vector = self._embedding_function.embed_query(query)
+        relevant_docs = self._tidb.query(
+            query_vector=query_vector, k=k, filter=filter, **kwargs
+        )
+        return [
+            (
+                Document(
+                    page_content=doc.document,
+                    metadata=doc.metadata,
+                ),
+                doc.distance,
+            )
+            for doc in relevant_docs
+        ]
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        Select the relevance score function based on the distance strategy.
+        """
+        if self._distance_strategy == "cosine":
+            return self._cosine_relevance_score_fn
+        elif self._distance_strategy == "l2":
+            return self._euclidean_relevance_score_fn
+        else:
+            raise ValueError(
+                "No supported normalization function"
+                f" for distance_strategy of {self._distance_strategy}."
+                "Consider providing relevance_score_fn to PGVector constructor."
+            )
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/tigris.py b/llm/Lib/site-packages/langchain_community/vectorstores/tigris.py
new file mode 100644
index 0000000000000000000000000000000000000000..96038b7c74940bd95f6e2174fda66672a1d323ab
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/tigris.py
@@ -0,0 +1,148 @@
+from __future__ import annotations
+
+import itertools
+from typing import TYPE_CHECKING, Any, Iterable, List, Optional, Tuple
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    from tigrisdb import TigrisClient
+    from tigrisdb import VectorStore as TigrisVectorStore
+    from tigrisdb.types.filters import Filter as TigrisFilter
+    from tigrisdb.types.vector import Document as TigrisDocument
+
+
+class Tigris(VectorStore):
+    """`Tigris` vector store."""
+
+    def __init__(self, client: TigrisClient, embeddings: Embeddings, index_name: str):
+        """Initialize Tigris vector store."""
+        try:
+            import tigrisdb  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "Could not import tigrisdb python package. "
+                "Please install it with `pip install tigrisdb`"
+            )
+
+        self._embed_fn = embeddings
+        self._vector_store = TigrisVectorStore(client.get_search(), index_name)
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self._embed_fn
+
+    @property
+    def search_index(self) -> TigrisVectorStore:
+        return self._vector_store
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of ids for documents.
+                Ids will be autogenerated if not provided.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        docs = self._prep_docs(texts, metadatas, ids)
+        result = self.search_index.add_documents(docs)
+        return [r.id for r in result]
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[TigrisFilter] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query."""
+        docs_with_scores = self.similarity_search_with_score(query, k, filter)
+        return [doc for doc, _ in docs_with_scores]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[TigrisFilter] = None,
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search with Chroma with distance.
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 4.
+            filter (Optional[TigrisFilter]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Tuple[Document, float]]: List of documents most similar to the query
+                text with distance in float.
+        """
+        vector = self._embed_fn.embed_query(query)
+        result = self.search_index.similarity_search(
+            vector=vector, k=k, filter_by=filter
+        )
+        docs: List[Tuple[Document, float]] = []
+        for r in result:
+            docs.append(
+                (
+                    Document(
+                        page_content=r.doc["text"], metadata=r.doc.get("metadata")
+                    ),
+                    r.score,
+                )
+            )
+        return docs
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        client: Optional[TigrisClient] = None,
+        index_name: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Tigris:
+        """Return VectorStore initialized from texts and embeddings."""
+        if not index_name:
+            raise ValueError("`index_name` is required")
+
+        if not client:
+            client = TigrisClient()
+        store = cls(client, embedding, index_name)
+        store.add_texts(texts=texts, metadatas=metadatas, ids=ids)
+        return store
+
+    def _prep_docs(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]],
+        ids: Optional[List[str]],
+    ) -> List[TigrisDocument]:
+        embeddings: List[List[float]] = self._embed_fn.embed_documents(list(texts))
+        docs: List[TigrisDocument] = []
+        for t, m, e, _id in itertools.zip_longest(
+            texts, metadatas or [], embeddings or [], ids or []
+        ):
+            doc: TigrisDocument = {
+                "text": t,
+                "embeddings": e or [],
+                "metadata": m or {},
+            }
+            if _id:
+                doc["id"] = _id
+            docs.append(doc)
+        return docs
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/tiledb.py b/llm/Lib/site-packages/langchain_community/vectorstores/tiledb.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b4a5cb5b3e70b428a21a3175485cdc636525e51
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/tiledb.py
@@ -0,0 +1,819 @@
+"""Wrapper around TileDB vector database."""
+from __future__ import annotations
+
+import pickle
+import random
+import sys
+from typing import Any, Dict, Iterable, List, Mapping, Optional, Tuple
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+INDEX_METRICS = frozenset(["euclidean"])
+DEFAULT_METRIC = "euclidean"
+DOCUMENTS_ARRAY_NAME = "documents"
+VECTOR_INDEX_NAME = "vectors"
+MAX_UINT64 = np.iinfo(np.dtype("uint64")).max
+MAX_FLOAT_32 = np.finfo(np.dtype("float32")).max
+MAX_FLOAT = sys.float_info.max
+
+
+def dependable_tiledb_import() -> Any:
+    """Import tiledb-vector-search if available, otherwise raise error."""
+    try:
+        import tiledb as tiledb
+        import tiledb.vector_search as tiledb_vs
+    except ImportError:
+        raise ValueError(
+            "Could not import tiledb-vector-search python package. "
+            "Please install it with `conda install -c tiledb tiledb-vector-search` "
+            "or `pip install tiledb-vector-search`"
+        )
+    return tiledb_vs, tiledb
+
+
+def get_vector_index_uri_from_group(group: Any) -> str:
+    """Get the URI of the vector index."""
+    return group[VECTOR_INDEX_NAME].uri
+
+
+def get_documents_array_uri_from_group(group: Any) -> str:
+    """Get the URI of the documents array from group.
+
+    Args:
+        group: TileDB group object.
+
+    Returns:
+        URI of the documents array.
+    """
+    return group[DOCUMENTS_ARRAY_NAME].uri
+
+
+def get_vector_index_uri(uri: str) -> str:
+    """Get the URI of the vector index."""
+    return f"{uri}/{VECTOR_INDEX_NAME}"
+
+
+def get_documents_array_uri(uri: str) -> str:
+    """Get the URI of the documents array."""
+    return f"{uri}/{DOCUMENTS_ARRAY_NAME}"
+
+
+class TileDB(VectorStore):
+    """TileDB vector store.
+
+    To use, you should have the ``tiledb-vector-search`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community import TileDB
+            embeddings = OpenAIEmbeddings()
+            db = TileDB(embeddings, index_uri, metric)
+
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        index_uri: str,
+        metric: str,
+        *,
+        vector_index_uri: str = "",
+        docs_array_uri: str = "",
+        config: Optional[Mapping[str, Any]] = None,
+        timestamp: Any = None,
+        allow_dangerous_deserialization: bool = False,
+        **kwargs: Any,
+    ):
+        """Initialize with necessary components.
+
+        Args:
+            allow_dangerous_deserialization: whether to allow deserialization
+                of the data which involves loading data using pickle.
+                data can be modified by malicious actors to deliver a
+                malicious payload that results in execution of
+                arbitrary code on your machine.
+        """
+        if not allow_dangerous_deserialization:
+            raise ValueError(
+                "TileDB relies on pickle for serialization and deserialization. "
+                "This can be dangerous if the data is intercepted and/or modified "
+                "by malicious actors prior to being de-serialized. "
+                "If you are sure that the data is safe from modification, you can "
+                " set allow_dangerous_deserialization=True to proceed. "
+                "Loading of compromised data using pickle can result in execution of "
+                "arbitrary code on your machine."
+            )
+        self.embedding = embedding
+        self.embedding_function = embedding.embed_query
+        self.index_uri = index_uri
+        self.metric = metric
+        self.config = config
+
+        tiledb_vs, tiledb = dependable_tiledb_import()
+        with tiledb.scope_ctx(ctx_or_config=config):
+            index_group = tiledb.Group(self.index_uri, "r")
+            self.vector_index_uri = (
+                vector_index_uri
+                if vector_index_uri != ""
+                else get_vector_index_uri_from_group(index_group)
+            )
+            self.docs_array_uri = (
+                docs_array_uri
+                if docs_array_uri != ""
+                else get_documents_array_uri_from_group(index_group)
+            )
+            index_group.close()
+            group = tiledb.Group(self.vector_index_uri, "r")
+            self.index_type = group.meta.get("index_type")
+            group.close()
+            self.timestamp = timestamp
+            if self.index_type == "FLAT":
+                self.vector_index = tiledb_vs.flat_index.FlatIndex(
+                    uri=self.vector_index_uri,
+                    config=self.config,
+                    timestamp=self.timestamp,
+                    **kwargs,
+                )
+            elif self.index_type == "IVF_FLAT":
+                self.vector_index = tiledb_vs.ivf_flat_index.IVFFlatIndex(
+                    uri=self.vector_index_uri,
+                    config=self.config,
+                    timestamp=self.timestamp,
+                    **kwargs,
+                )
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self.embedding
+
+    def process_index_results(
+        self,
+        ids: List[int],
+        scores: List[float],
+        *,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        score_threshold: float = MAX_FLOAT,
+    ) -> List[Tuple[Document, float]]:
+        """Turns TileDB results into a list of documents and scores.
+
+        Args:
+            ids: List of indices of the documents in the index.
+            scores: List of distances of the documents in the index.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, Any]]): Filter by metadata. Defaults to None.
+            score_threshold: Optional, a floating point value to filter the
+                resulting set of retrieved docs
+        Returns:
+            List of Documents and scores.
+        """
+        tiledb_vs, tiledb = dependable_tiledb_import()
+        docs = []
+        docs_array = tiledb.open(
+            self.docs_array_uri, "r", timestamp=self.timestamp, config=self.config
+        )
+        for idx, score in zip(ids, scores):
+            if idx == 0 and score == 0:
+                continue
+            if idx == MAX_UINT64 and score == MAX_FLOAT_32:
+                continue
+            doc = docs_array[idx]
+            if doc is None or len(doc["text"]) == 0:
+                raise ValueError(f"Could not find document for id {idx}, got {doc}")
+            pickled_metadata = doc.get("metadata")
+            result_doc = Document(page_content=str(doc["text"][0]))
+            if pickled_metadata is not None:
+                metadata = pickle.loads(
+                    np.array(pickled_metadata.tolist()).astype(np.uint8).tobytes()
+                )
+                result_doc.metadata = metadata
+            if filter is not None:
+                filter = {
+                    key: [value] if not isinstance(value, list) else value
+                    for key, value in filter.items()
+                }
+                if all(
+                    result_doc.metadata.get(key) in value
+                    for key, value in filter.items()
+                ):
+                    docs.append((result_doc, score))
+            else:
+                docs.append((result_doc, score))
+        docs_array.close()
+        docs = [(doc, score) for doc, score in docs if score <= score_threshold]
+        return docs[:k]
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        *,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            embedding: Embedding vector to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, Any]]): Filter by metadata. Defaults to None.
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+            **kwargs: kwargs to be passed to similarity search. Can include:
+                nprobe: Optional, number of partitions to check if using IVF_FLAT index
+                score_threshold: Optional, a floating point value to filter the
+                    resulting set of retrieved docs
+
+        Returns:
+            List of documents most similar to the query text and distance
+            in float for each. Lower score represents more similarity.
+        """
+        if "score_threshold" in kwargs:
+            score_threshold = kwargs.pop("score_threshold")
+        else:
+            score_threshold = MAX_FLOAT
+        d, i = self.vector_index.query(
+            np.array([np.array(embedding).astype(np.float32)]).astype(np.float32),
+            k=k if filter is None else fetch_k,
+            **kwargs,
+        )
+        return self.process_index_results(
+            ids=i[0], scores=d[0], filter=filter, k=k, score_threshold=score_threshold
+        )
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        *,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+
+        Returns:
+            List of documents most similar to the query text with
+            Distance as float. Lower score represents more similarity.
+        """
+        embedding = self.embedding_function(query)
+        docs = self.similarity_search_with_score_by_vector(
+            embedding,
+            k=k,
+            filter=filter,
+            fetch_k=fetch_k,
+            **kwargs,
+        )
+        return docs
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+
+        Returns:
+            List of Documents most similar to the embedding.
+        """
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding,
+            k=k,
+            filter=filter,
+            fetch_k=fetch_k,
+            **kwargs,
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, Any]] = None,
+        fetch_k: int = 20,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+            fetch_k: (Optional[int]) Number of Documents to fetch before filtering.
+                      Defaults to 20.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query, k=k, filter=filter, fetch_k=fetch_k, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def max_marginal_relevance_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        *,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs and their similarity scores selected using the maximal marginal
+            relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch before filtering to
+                     pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents and similarity scores selected by maximal marginal
+                relevance and score for each.
+        """
+        if "score_threshold" in kwargs:
+            score_threshold = kwargs.pop("score_threshold")
+        else:
+            score_threshold = MAX_FLOAT
+        scores, indices = self.vector_index.query(
+            np.array([np.array(embedding).astype(np.float32)]).astype(np.float32),
+            k=fetch_k if filter is None else fetch_k * 2,
+            **kwargs,
+        )
+        results = self.process_index_results(
+            ids=indices[0],
+            scores=scores[0],
+            filter=filter,
+            k=fetch_k if filter is None else fetch_k * 2,
+            score_threshold=score_threshold,
+        )
+        embeddings = [
+            self.embedding.embed_documents([doc.page_content])[0] for doc, _ in results
+        ]
+        mmr_selected = maximal_marginal_relevance(
+            np.array([embedding], dtype=np.float32),
+            embeddings,
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+        docs_and_scores = []
+        for i in mmr_selected:
+            docs_and_scores.append(results[i])
+        return docs_and_scores
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch before filtering to
+                     pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        docs_and_scores = self.max_marginal_relevance_search_with_score_by_vector(
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch before filtering (if needed) to
+                     pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        embedding = self.embedding_function(query)
+        docs = self.max_marginal_relevance_search_by_vector(
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+            **kwargs,
+        )
+        return docs
+
+    @classmethod
+    def create(
+        cls,
+        index_uri: str,
+        index_type: str,
+        dimensions: int,
+        vector_type: np.dtype,
+        *,
+        metadatas: bool = True,
+        config: Optional[Mapping[str, Any]] = None,
+    ) -> None:
+        tiledb_vs, tiledb = dependable_tiledb_import()
+        with tiledb.scope_ctx(ctx_or_config=config):
+            try:
+                tiledb.group_create(index_uri)
+            except tiledb.TileDBError as err:
+                raise err
+            group = tiledb.Group(index_uri, "w")
+            vector_index_uri = get_vector_index_uri(group.uri)
+            docs_uri = get_documents_array_uri(group.uri)
+            if index_type == "FLAT":
+                tiledb_vs.flat_index.create(
+                    uri=vector_index_uri,
+                    dimensions=dimensions,
+                    vector_type=vector_type,
+                    config=config,
+                )
+            elif index_type == "IVF_FLAT":
+                tiledb_vs.ivf_flat_index.create(
+                    uri=vector_index_uri,
+                    dimensions=dimensions,
+                    vector_type=vector_type,
+                    config=config,
+                )
+            group.add(vector_index_uri, name=VECTOR_INDEX_NAME)
+
+            # Create TileDB array to store Documents
+            # TODO add a Document store API to tiledb-vector-search to allow storing
+            #  different types of objects and metadata in a more generic way.
+            dim = tiledb.Dim(
+                name="id",
+                domain=(0, MAX_UINT64 - 1),
+                dtype=np.dtype(np.uint64),
+            )
+            dom = tiledb.Domain(dim)
+
+            text_attr = tiledb.Attr(name="text", dtype=np.dtype("U1"), var=True)
+            attrs = [text_attr]
+            if metadatas:
+                metadata_attr = tiledb.Attr(name="metadata", dtype=np.uint8, var=True)
+                attrs.append(metadata_attr)
+            schema = tiledb.ArraySchema(
+                domain=dom,
+                sparse=True,
+                allows_duplicates=False,
+                attrs=attrs,
+            )
+            tiledb.Array.create(docs_uri, schema)
+            group.add(docs_uri, name=DOCUMENTS_ARRAY_NAME)
+            group.close()
+
+    @classmethod
+    def __from(
+        cls,
+        texts: List[str],
+        embeddings: List[List[float]],
+        embedding: Embeddings,
+        index_uri: str,
+        *,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        metric: str = DEFAULT_METRIC,
+        index_type: str = "FLAT",
+        config: Optional[Mapping[str, Any]] = None,
+        index_timestamp: int = 0,
+        **kwargs: Any,
+    ) -> TileDB:
+        if metric not in INDEX_METRICS:
+            raise ValueError(
+                (
+                    f"Unsupported distance metric: {metric}. "
+                    f"Expected one of {list(INDEX_METRICS)}"
+                )
+            )
+        tiledb_vs, tiledb = dependable_tiledb_import()
+        input_vectors = np.array(embeddings).astype(np.float32)
+        cls.create(
+            index_uri=index_uri,
+            index_type=index_type,
+            dimensions=input_vectors.shape[1],
+            vector_type=input_vectors.dtype,
+            metadatas=metadatas is not None,
+            config=config,
+        )
+        with tiledb.scope_ctx(ctx_or_config=config):
+            if not embeddings:
+                raise ValueError("embeddings must be provided to build a TileDB index")
+
+            vector_index_uri = get_vector_index_uri(index_uri)
+            docs_uri = get_documents_array_uri(index_uri)
+            if ids is None:
+                ids = [str(random.randint(0, MAX_UINT64 - 1)) for _ in texts]
+            external_ids = np.array(ids).astype(np.uint64)
+
+            tiledb_vs.ingestion.ingest(
+                index_type=index_type,
+                index_uri=vector_index_uri,
+                input_vectors=input_vectors,
+                external_ids=external_ids,
+                index_timestamp=index_timestamp if index_timestamp != 0 else None,
+                config=config,
+                **kwargs,
+            )
+            with tiledb.open(docs_uri, "w") as A:
+                if external_ids is None:
+                    external_ids = np.zeros(len(texts), dtype=np.uint64)
+                    for i in range(len(texts)):
+                        external_ids[i] = i
+                data = {}
+                data["text"] = np.array(texts)
+                if metadatas is not None:
+                    metadata_attr = np.empty([len(metadatas)], dtype=object)
+                    i = 0
+                    for metadata in metadatas:
+                        metadata_attr[i] = np.frombuffer(
+                            pickle.dumps(metadata), dtype=np.uint8
+                        )
+                        i += 1
+                    data["metadata"] = metadata_attr
+
+                A[external_ids] = data
+        return cls(
+            embedding=embedding,
+            index_uri=index_uri,
+            metric=metric,
+            config=config,
+            **kwargs,
+        )
+
+    def delete(
+        self, ids: Optional[List[str]] = None, timestamp: int = 0, **kwargs: Any
+    ) -> Optional[bool]:
+        """Delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+            timestamp: Optional timestamp to delete with.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+
+        external_ids = np.array(ids).astype(np.uint64)
+        self.vector_index.delete_batch(
+            external_ids=external_ids, timestamp=timestamp if timestamp != 0 else None
+        )
+        return True
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        timestamp: int = 0,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional ids of each text object.
+            timestamp: Optional timestamp to write new texts with.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        tiledb_vs, tiledb = dependable_tiledb_import()
+        embeddings = self.embedding.embed_documents(list(texts))
+        if ids is None:
+            ids = [str(random.randint(0, MAX_UINT64 - 1)) for _ in texts]
+
+        external_ids = np.array(ids).astype(np.uint64)
+        vectors = np.empty((len(embeddings)), dtype="O")
+        for i in range(len(embeddings)):
+            vectors[i] = np.array(embeddings[i], dtype=np.float32)
+        self.vector_index.update_batch(
+            vectors=vectors,
+            external_ids=external_ids,
+            timestamp=timestamp if timestamp != 0 else None,
+        )
+
+        docs = {}
+        docs["text"] = np.array(texts)
+        if metadatas is not None:
+            metadata_attr = np.empty([len(metadatas)], dtype=object)
+            i = 0
+            for metadata in metadatas:
+                metadata_attr[i] = np.frombuffer(pickle.dumps(metadata), dtype=np.uint8)
+                i += 1
+            docs["metadata"] = metadata_attr
+
+        docs_array = tiledb.open(
+            self.docs_array_uri,
+            "w",
+            timestamp=timestamp if timestamp != 0 else None,
+            config=self.config,
+        )
+        docs_array[external_ids] = docs
+        docs_array.close()
+        return ids
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        metric: str = DEFAULT_METRIC,
+        index_uri: str = "/tmp/tiledb_array",
+        index_type: str = "FLAT",
+        config: Optional[Mapping[str, Any]] = None,
+        index_timestamp: int = 0,
+        **kwargs: Any,
+    ) -> TileDB:
+        """Construct a TileDB index from raw documents.
+
+        Args:
+            texts: List of documents to index.
+            embedding: Embedding function to use.
+            metadatas: List of metadata dictionaries to associate with documents.
+            ids: Optional ids of each text object.
+            metric: Metric to use for indexing. Defaults to "euclidean".
+            index_uri: The URI to write the TileDB arrays
+            index_type: Optional,  Vector index type ("FLAT", IVF_FLAT")
+            config: Optional, TileDB config
+            index_timestamp: Optional, timestamp to write new texts with.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community import TileDB
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                index = TileDB.from_texts(texts, embeddings)
+        """
+        embeddings = []
+        embeddings = embedding.embed_documents(texts)
+        return cls.__from(
+            texts=texts,
+            embeddings=embeddings,
+            embedding=embedding,
+            metadatas=metadatas,
+            ids=ids,
+            metric=metric,
+            index_uri=index_uri,
+            index_type=index_type,
+            config=config,
+            index_timestamp=index_timestamp,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_embeddings(
+        cls,
+        text_embeddings: List[Tuple[str, List[float]]],
+        embedding: Embeddings,
+        index_uri: str,
+        *,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        metric: str = DEFAULT_METRIC,
+        index_type: str = "FLAT",
+        config: Optional[Mapping[str, Any]] = None,
+        index_timestamp: int = 0,
+        **kwargs: Any,
+    ) -> TileDB:
+        """Construct TileDB index from embeddings.
+
+        Args:
+            text_embeddings: List of tuples of (text, embedding)
+            embedding: Embedding function to use.
+            index_uri: The URI to write the TileDB arrays
+            metadatas: List of metadata dictionaries to associate with documents.
+            metric: Optional, Metric to use for indexing. Defaults to "euclidean".
+            index_type: Optional, Vector index type ("FLAT", IVF_FLAT")
+            config: Optional, TileDB config
+            index_timestamp: Optional, timestamp to write new texts with.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community import TileDB
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                text_embeddings = embeddings.embed_documents(texts)
+                text_embedding_pairs = list(zip(texts, text_embeddings))
+                db = TileDB.from_embeddings(text_embedding_pairs, embeddings)
+        """
+        texts = [t[0] for t in text_embeddings]
+        embeddings = [t[1] for t in text_embeddings]
+
+        return cls.__from(
+            texts=texts,
+            embeddings=embeddings,
+            embedding=embedding,
+            metadatas=metadatas,
+            ids=ids,
+            metric=metric,
+            index_uri=index_uri,
+            index_type=index_type,
+            config=config,
+            index_timestamp=index_timestamp,
+            **kwargs,
+        )
+
+    @classmethod
+    def load(
+        cls,
+        index_uri: str,
+        embedding: Embeddings,
+        *,
+        metric: str = DEFAULT_METRIC,
+        config: Optional[Mapping[str, Any]] = None,
+        timestamp: Any = None,
+        **kwargs: Any,
+    ) -> TileDB:
+        """Load a TileDB index from a URI.
+
+        Args:
+            index_uri: The URI of the TileDB vector index.
+            embedding: Embeddings to use when generating queries.
+            metric: Optional, Metric to use for indexing. Defaults to "euclidean".
+            config: Optional, TileDB config
+            timestamp: Optional, timestamp to use for opening the arrays.
+        """
+        return cls(
+            embedding=embedding,
+            index_uri=index_uri,
+            metric=metric,
+            config=config,
+            timestamp=timestamp,
+            **kwargs,
+        )
+
+    def consolidate_updates(self, **kwargs: Any) -> None:
+        self.vector_index = self.vector_index.consolidate_updates(**kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/timescalevector.py b/llm/Lib/site-packages/langchain_community/vectorstores/timescalevector.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e3e3c41ad4b8b14ca9e0fc084637d7d6c7a955c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/timescalevector.py
@@ -0,0 +1,882 @@
+"""VectorStore wrapper around a Postgres-TimescaleVector database."""
+from __future__ import annotations
+
+import enum
+import logging
+import uuid
+from datetime import timedelta
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+)
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_dict_or_env
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import DistanceStrategy
+
+if TYPE_CHECKING:
+    from timescale_vector import Predicates
+
+
+DEFAULT_DISTANCE_STRATEGY = DistanceStrategy.COSINE
+
+ADA_TOKEN_COUNT = 1536
+
+_LANGCHAIN_DEFAULT_COLLECTION_NAME = "langchain_store"
+
+
+class TimescaleVector(VectorStore):
+    """Timescale Postgres vector store
+
+    To use, you should have the ``timescale_vector`` python package installed.
+
+    Args:
+        service_url: Service url on timescale cloud.
+        embedding: Any embedding function implementing
+            `langchain.embeddings.base.Embeddings` interface.
+        collection_name: The name of the collection to use. (default: langchain_store)
+            This will become the table name used for the collection.
+        distance_strategy: The distance strategy to use. (default: COSINE)
+        pre_delete_collection: If True, will delete the collection if it exists.
+            (default: False). Useful for testing.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import TimescaleVector
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+
+            SERVICE_URL = "postgres://tsdbadmin:<password>@<id>.tsdb.cloud.timescale.com:<port>/tsdb?sslmode=require"
+            COLLECTION_NAME = "state_of_the_union_test"
+            embeddings = OpenAIEmbeddings()
+            vectorestore = TimescaleVector.from_documents(
+                embedding=embeddings,
+                documents=docs,
+                collection_name=COLLECTION_NAME,
+                service_url=SERVICE_URL,
+            )
+    """  # noqa: E501
+
+    def __init__(
+        self,
+        service_url: str,
+        embedding: Embeddings,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        num_dimensions: int = ADA_TOKEN_COUNT,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        pre_delete_collection: bool = False,
+        logger: Optional[logging.Logger] = None,
+        relevance_score_fn: Optional[Callable[[float], float]] = None,
+        time_partition_interval: Optional[timedelta] = None,
+        **kwargs: Any,
+    ) -> None:
+        try:
+            from timescale_vector import client
+        except ImportError:
+            raise ImportError(
+                "Could not import timescale_vector python package. "
+                "Please install it with `pip install timescale-vector`."
+            )
+
+        self.service_url = service_url
+        self.embedding = embedding
+        self.collection_name = collection_name
+        self.num_dimensions = num_dimensions
+        self._distance_strategy = distance_strategy
+        self.pre_delete_collection = pre_delete_collection
+        self.logger = logger or logging.getLogger(__name__)
+        self.override_relevance_score_fn = relevance_score_fn
+        self._time_partition_interval = time_partition_interval
+        self.sync_client = client.Sync(
+            self.service_url,
+            self.collection_name,
+            self.num_dimensions,
+            self._distance_strategy.value.lower(),
+            time_partition_interval=self._time_partition_interval,
+            **kwargs,
+        )
+        self.async_client = client.Async(
+            self.service_url,
+            self.collection_name,
+            self.num_dimensions,
+            self._distance_strategy.value.lower(),
+            time_partition_interval=self._time_partition_interval,
+            **kwargs,
+        )
+        self.__post_init__()
+
+    def __post_init__(
+        self,
+    ) -> None:
+        """
+        Initialize the store.
+        """
+        self.sync_client.create_tables()
+        if self.pre_delete_collection:
+            self.sync_client.delete_all()
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding
+
+    def drop_tables(self) -> None:
+        self.sync_client.drop_table()
+
+    @classmethod
+    def __from(
+        cls,
+        texts: List[str],
+        embeddings: List[List[float]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        service_url: Optional[str] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> TimescaleVector:
+        num_dimensions = len(embeddings[0])
+
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        if service_url is None:
+            service_url = cls.get_service_url(kwargs)
+
+        store = cls(
+            service_url=service_url,
+            num_dimensions=num_dimensions,
+            collection_name=collection_name,
+            embedding=embedding,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+            **kwargs,
+        )
+
+        store.add_embeddings(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+        return store
+
+    @classmethod
+    async def __afrom(
+        cls,
+        texts: List[str],
+        embeddings: List[List[float]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        service_url: Optional[str] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> TimescaleVector:
+        num_dimensions = len(embeddings[0])
+
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        if service_url is None:
+            service_url = cls.get_service_url(kwargs)
+
+        store = cls(
+            service_url=service_url,
+            num_dimensions=num_dimensions,
+            collection_name=collection_name,
+            embedding=embedding,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+            **kwargs,
+        )
+
+        await store.aadd_embeddings(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+        return store
+
+    def add_embeddings(
+        self,
+        texts: Iterable[str],
+        embeddings: List[List[float]],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add embeddings to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            embeddings: List of list of embedding vectors.
+            metadatas: List of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+        """
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        records = list(zip(ids, metadatas, texts, embeddings))
+        self.sync_client.upsert(records)
+
+        return ids
+
+    async def aadd_embeddings(
+        self,
+        texts: Iterable[str],
+        embeddings: List[List[float]],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add embeddings to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            embeddings: List of list of embedding vectors.
+            metadatas: List of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+        """
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+
+        records = list(zip(ids, metadatas, texts, embeddings))
+        await self.async_client.upsert(records)
+
+        return ids
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        embeddings = self.embedding.embed_documents(list(texts))
+        return self.add_embeddings(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+    async def aadd_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        embeddings = self.embedding.embed_documents(list(texts))
+        return await self.aadd_embeddings(
+            texts=texts, embeddings=embeddings, metadatas=metadatas, ids=ids, **kwargs
+        )
+
+    def _embed_query(self, query: str) -> Optional[List[float]]:
+        # an empty query should not be embedded
+        if query is None or query == "" or query.isspace():
+            return None
+        else:
+            return self.embedding.embed_query(query)
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Union[dict, list]] = None,
+        predicates: Optional[Predicates] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search with TimescaleVector with distance.
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        embedding = self._embed_query(query)
+        return self.similarity_search_by_vector(
+            embedding=embedding,
+            k=k,
+            filter=filter,
+            predicates=predicates,
+            **kwargs,
+        )
+
+    async def asimilarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Union[dict, list]] = None,
+        predicates: Optional[Predicates] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search with TimescaleVector with distance.
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        embedding = self._embed_query(query)
+        return await self.asimilarity_search_by_vector(
+            embedding=embedding,
+            k=k,
+            filter=filter,
+            predicates=predicates,
+            **kwargs,
+        )
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Union[dict, list]] = None,
+        predicates: Optional[Predicates] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        embedding = self._embed_query(query)
+        docs = self.similarity_search_with_score_by_vector(
+            embedding=embedding,
+            k=k,
+            filter=filter,
+            predicates=predicates,
+            **kwargs,
+        )
+        return docs
+
+    async def asimilarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Union[dict, list]] = None,
+        predicates: Optional[Predicates] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+
+        embedding = self._embed_query(query)
+        return await self.asimilarity_search_with_score_by_vector(
+            embedding=embedding,
+            k=k,
+            filter=filter,
+            predicates=predicates,
+            **kwargs,
+        )
+
+    def date_to_range_filter(self, **kwargs: Any) -> Any:
+        constructor_args = {
+            key: kwargs[key]
+            for key in [
+                "start_date",
+                "end_date",
+                "time_delta",
+                "start_inclusive",
+                "end_inclusive",
+            ]
+            if key in kwargs
+        }
+        if not constructor_args or len(constructor_args) == 0:
+            return None
+
+        try:
+            from timescale_vector import client
+        except ImportError:
+            raise ImportError(
+                "Could not import timescale_vector python package. "
+                "Please install it with `pip install timescale-vector`."
+            )
+        return client.UUIDTimeRange(**constructor_args)
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: Optional[List[float]],
+        k: int = 4,
+        filter: Optional[Union[dict, list]] = None,
+        predicates: Optional[Predicates] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        try:
+            from timescale_vector import client
+        except ImportError:
+            raise ImportError(
+                "Could not import timescale_vector python package. "
+                "Please install it with `pip install timescale-vector`."
+            )
+
+        results = self.sync_client.search(
+            embedding,
+            limit=k,
+            filter=filter,
+            predicates=predicates,
+            uuid_time_filter=self.date_to_range_filter(**kwargs),
+        )
+
+        docs = [
+            (
+                Document(
+                    page_content=result[client.SEARCH_RESULT_CONTENTS_IDX],
+                    metadata=result[client.SEARCH_RESULT_METADATA_IDX],
+                ),
+                result[client.SEARCH_RESULT_DISTANCE_IDX],
+            )
+            for result in results
+        ]
+        return docs
+
+    async def asimilarity_search_with_score_by_vector(
+        self,
+        embedding: Optional[List[float]],
+        k: int = 4,
+        filter: Optional[Union[dict, list]] = None,
+        predicates: Optional[Predicates] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        try:
+            from timescale_vector import client
+        except ImportError:
+            raise ImportError(
+                "Could not import timescale_vector python package. "
+                "Please install it with `pip install timescale-vector`."
+            )
+
+        results = await self.async_client.search(
+            embedding,
+            limit=k,
+            filter=filter,
+            predicates=predicates,
+            uuid_time_filter=self.date_to_range_filter(**kwargs),
+        )
+
+        docs = [
+            (
+                Document(
+                    page_content=result[client.SEARCH_RESULT_CONTENTS_IDX],
+                    metadata=result[client.SEARCH_RESULT_METADATA_IDX],
+                ),
+                result[client.SEARCH_RESULT_DISTANCE_IDX],
+            )
+            for result in results
+        ]
+        return docs
+
+    def similarity_search_by_vector(
+        self,
+        embedding: Optional[List[float]],
+        k: int = 4,
+        filter: Optional[Union[dict, list]] = None,
+        predicates: Optional[Predicates] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter, predicates=predicates, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    async def asimilarity_search_by_vector(
+        self,
+        embedding: Optional[List[float]],
+        k: int = 4,
+        filter: Optional[Union[dict, list]] = None,
+        predicates: Optional[Predicates] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        docs_and_scores = await self.asimilarity_search_with_score_by_vector(
+            embedding=embedding, k=k, filter=filter, predicates=predicates, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    @classmethod
+    def from_texts(
+        cls: Type[TimescaleVector],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> TimescaleVector:
+        """
+        Return VectorStore initialized from texts and embeddings.
+        Postgres connection string is required
+        "Either pass it as a parameter
+        or set the TIMESCALE_SERVICE_URL environment variable.
+        """
+        embeddings = embedding.embed_documents(list(texts))
+
+        return cls.__from(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+            **kwargs,
+        )
+
+    @classmethod
+    async def afrom_texts(
+        cls: Type[TimescaleVector],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> TimescaleVector:
+        """
+        Return VectorStore initialized from texts and embeddings.
+        Postgres connection string is required
+        "Either pass it as a parameter
+        or set the TIMESCALE_SERVICE_URL environment variable.
+        """
+        embeddings = embedding.embed_documents(list(texts))
+
+        return await cls.__afrom(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_embeddings(
+        cls,
+        text_embeddings: List[Tuple[str, List[float]]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> TimescaleVector:
+        """Construct TimescaleVector wrapper from raw documents and pre-
+        generated embeddings.
+
+        Return VectorStore initialized from documents and embeddings.
+        Postgres connection string is required
+        "Either pass it as a parameter
+        or set the TIMESCALE_SERVICE_URL environment variable.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import TimescaleVector
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                text_embeddings = embeddings.embed_documents(texts)
+                text_embedding_pairs = list(zip(texts, text_embeddings))
+                tvs = TimescaleVector.from_embeddings(text_embedding_pairs, embeddings)
+        """
+        texts = [t[0] for t in text_embeddings]
+        embeddings = [t[1] for t in text_embeddings]
+
+        return cls.__from(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+            **kwargs,
+        )
+
+    @classmethod
+    async def afrom_embeddings(
+        cls,
+        text_embeddings: List[Tuple[str, List[float]]],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        ids: Optional[List[str]] = None,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> TimescaleVector:
+        """Construct TimescaleVector wrapper from raw documents and pre-
+        generated embeddings.
+
+        Return VectorStore initialized from documents and embeddings.
+        Postgres connection string is required
+        "Either pass it as a parameter
+        or set the TIMESCALE_SERVICE_URL environment variable.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import TimescaleVector
+                from langchain_community.embeddings import OpenAIEmbeddings
+                embeddings = OpenAIEmbeddings()
+                text_embeddings = embeddings.embed_documents(texts)
+                text_embedding_pairs = list(zip(texts, text_embeddings))
+                tvs = TimescaleVector.from_embeddings(text_embedding_pairs, embeddings)
+        """
+        texts = [t[0] for t in text_embeddings]
+        embeddings = [t[1] for t in text_embeddings]
+
+        return await cls.__afrom(
+            texts,
+            embeddings,
+            embedding,
+            metadatas=metadatas,
+            ids=ids,
+            collection_name=collection_name,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_existing_index(
+        cls: Type[TimescaleVector],
+        embedding: Embeddings,
+        collection_name: str = _LANGCHAIN_DEFAULT_COLLECTION_NAME,
+        distance_strategy: DistanceStrategy = DEFAULT_DISTANCE_STRATEGY,
+        pre_delete_collection: bool = False,
+        **kwargs: Any,
+    ) -> TimescaleVector:
+        """
+        Get instance of an existing TimescaleVector store.This method will
+        return the instance of the store without inserting any new
+        embeddings
+        """
+
+        service_url = cls.get_service_url(kwargs)
+
+        store = cls(
+            service_url=service_url,
+            collection_name=collection_name,
+            embedding=embedding,
+            distance_strategy=distance_strategy,
+            pre_delete_collection=pre_delete_collection,
+        )
+
+        return store
+
+    @classmethod
+    def get_service_url(cls, kwargs: Dict[str, Any]) -> str:
+        service_url: str = get_from_dict_or_env(
+            data=kwargs,
+            key="service_url",
+            env_key="TIMESCALE_SERVICE_URL",
+        )
+
+        if not service_url:
+            raise ValueError(
+                "Postgres connection string is required"
+                "Either pass it as a parameter"
+                "or set the TIMESCALE_SERVICE_URL environment variable."
+            )
+
+        return service_url
+
+    @classmethod
+    def service_url_from_db_params(
+        cls,
+        host: str,
+        port: int,
+        database: str,
+        user: str,
+        password: str,
+    ) -> str:
+        """Return connection string from database parameters."""
+        return f"postgresql://{user}:{password}@{host}:{port}/{database}"
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+        """
+        if self.override_relevance_score_fn is not None:
+            return self.override_relevance_score_fn
+
+        # Default strategy is to rely on distance strategy provided
+        # in vectorstore constructor
+        if self._distance_strategy == DistanceStrategy.COSINE:
+            return self._cosine_relevance_score_fn
+        elif self._distance_strategy == DistanceStrategy.EUCLIDEAN_DISTANCE:
+            return self._euclidean_relevance_score_fn
+        elif self._distance_strategy == DistanceStrategy.MAX_INNER_PRODUCT:
+            return self._max_inner_product_relevance_score_fn
+        else:
+            raise ValueError(
+                "No supported normalization function"
+                f" for distance_strategy of {self._distance_strategy}."
+                "Consider providing relevance_score_fn to TimescaleVector constructor."
+            )
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        """Delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+        if ids is None:
+            raise ValueError("No ids provided to delete.")
+
+        self.sync_client.delete_by_ids(ids)
+        return True
+
+    # todo should this be part of delete|()?
+    def delete_by_metadata(
+        self, filter: Union[Dict[str, str], List[Dict[str, str]]], **kwargs: Any
+    ) -> Optional[bool]:
+        """Delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+
+        self.sync_client.delete_by_metadata(filter)
+        return True
+
+    class IndexType(str, enum.Enum):
+        """Enumerator for the supported Index types"""
+
+        TIMESCALE_VECTOR = "tsv"
+        PGVECTOR_IVFFLAT = "ivfflat"
+        PGVECTOR_HNSW = "hnsw"
+
+    DEFAULT_INDEX_TYPE = IndexType.TIMESCALE_VECTOR
+
+    def create_index(
+        self, index_type: Union[IndexType, str] = DEFAULT_INDEX_TYPE, **kwargs: Any
+    ) -> None:
+        try:
+            from timescale_vector import client
+        except ImportError:
+            raise ImportError(
+                "Could not import timescale_vector python package. "
+                "Please install it with `pip install timescale-vector`."
+            )
+
+        index_type = (
+            index_type.value if isinstance(index_type, self.IndexType) else index_type
+        )
+        if index_type == self.IndexType.PGVECTOR_IVFFLAT.value:
+            self.sync_client.create_embedding_index(client.IvfflatIndex(**kwargs))
+
+        if index_type == self.IndexType.PGVECTOR_HNSW.value:
+            self.sync_client.create_embedding_index(client.HNSWIndex(**kwargs))
+
+        if index_type == self.IndexType.TIMESCALE_VECTOR.value:
+            self.sync_client.create_embedding_index(
+                client.TimescaleVectorIndex(**kwargs)
+            )
+
+    def drop_index(self) -> None:
+        self.sync_client.drop_embedding_index()
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/typesense.py b/llm/Lib/site-packages/langchain_community/vectorstores/typesense.py
new file mode 100644
index 0000000000000000000000000000000000000000..662a9185148f8e3177ab0ac7ff31e9cb780b1630
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/typesense.py
@@ -0,0 +1,275 @@
+from __future__ import annotations
+
+import uuid
+from typing import TYPE_CHECKING, Any, Iterable, List, Optional, Tuple, Union
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.utils import get_from_env
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    from typesense.client import Client
+    from typesense.collection import Collection
+
+
+class Typesense(VectorStore):
+    """`Typesense` vector store.
+
+    To use, you should have the ``typesense`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embedding.openai import OpenAIEmbeddings
+            from langchain_community.vectorstores import Typesense
+            import typesense
+
+            node = {
+                "host": "localhost",  # For Typesense Cloud use xxx.a1.typesense.net
+                "port": "8108",       # For Typesense Cloud use 443
+                "protocol": "http"    # For Typesense Cloud use https
+            }
+            typesense_client = typesense.Client(
+                {
+                  "nodes": [node],
+                  "api_key": "<API_KEY>",
+                  "connection_timeout_seconds": 2
+                }
+            )
+            typesense_collection_name = "langchain-memory"
+
+            embedding = OpenAIEmbeddings()
+            vectorstore = Typesense(
+                typesense_client=typesense_client,
+                embedding=embedding,
+                typesense_collection_name=typesense_collection_name,
+                text_key="text",
+            )
+    """
+
+    def __init__(
+        self,
+        typesense_client: Client,
+        embedding: Embeddings,
+        *,
+        typesense_collection_name: Optional[str] = None,
+        text_key: str = "text",
+    ):
+        """Initialize with Typesense client."""
+        try:
+            from typesense import Client
+        except ImportError:
+            raise ImportError(
+                "Could not import typesense python package. "
+                "Please install it with `pip install typesense`."
+            )
+        if not isinstance(typesense_client, Client):
+            raise ValueError(
+                f"typesense_client should be an instance of typesense.Client, "
+                f"got {type(typesense_client)}"
+            )
+        self._typesense_client = typesense_client
+        self._embedding = embedding
+        self._typesense_collection_name = (
+            typesense_collection_name or f"langchain-{str(uuid.uuid4())}"
+        )
+        self._text_key = text_key
+
+    @property
+    def _collection(self) -> Collection:
+        return self._typesense_client.collections[self._typesense_collection_name]
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self._embedding
+
+    def _prep_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]],
+        ids: Optional[List[str]],
+    ) -> List[dict]:
+        """Embed and create the documents"""
+        _ids = ids or (str(uuid.uuid4()) for _ in texts)
+        _metadatas: Iterable[dict] = metadatas or ({} for _ in texts)
+        embedded_texts = self._embedding.embed_documents(list(texts))
+        return [
+            {"id": _id, "vec": vec, f"{self._text_key}": text, "metadata": metadata}
+            for _id, vec, text, metadata in zip(_ids, embedded_texts, texts, _metadatas)
+        ]
+
+    def _create_collection(self, num_dim: int) -> None:
+        fields = [
+            {"name": "vec", "type": "float[]", "num_dim": num_dim},
+            {"name": f"{self._text_key}", "type": "string"},
+            {"name": ".*", "type": "auto"},
+        ]
+        self._typesense_client.collections.create(
+            {"name": self._typesense_collection_name, "fields": fields}
+        )
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embedding and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of ids to associate with the texts.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+
+        """
+        from typesense.exceptions import ObjectNotFound
+
+        docs = self._prep_texts(texts, metadatas, ids)
+        try:
+            self._collection.documents.import_(docs, {"action": "upsert"})
+        except ObjectNotFound:
+            # Create the collection if it doesn't already exist
+            self._create_collection(len(docs[0]["vec"]))
+            self._collection.documents.import_(docs, {"action": "upsert"})
+        return [doc["id"] for doc in docs]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 10,
+        filter: Optional[str] = "",
+    ) -> List[Tuple[Document, float]]:
+        """Return typesense documents most similar to query, along with scores.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 10.
+                Minimum 10 results would be returned.
+            filter: typesense filter_by expression to filter documents on
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        embedded_query = [str(x) for x in self._embedding.embed_query(query)]
+        query_obj = {
+            "q": "*",
+            "vector_query": f'vec:([{",".join(embedded_query)}], k:{k})',
+            "filter_by": filter,
+            "collection": self._typesense_collection_name,
+        }
+        docs = []
+        response = self._typesense_client.multi_search.perform(
+            {"searches": [query_obj]}, {}
+        )
+        for hit in response["results"][0]["hits"]:
+            document = hit["document"]
+            metadata = document["metadata"]
+            text = document[self._text_key]
+            score = hit["vector_distance"]
+            docs.append((Document(page_content=text, metadata=metadata), score))
+        return docs
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 10,
+        filter: Optional[str] = "",
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return typesense documents most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 10.
+                Minimum 10 results would be returned.
+            filter: typesense filter_by expression to filter documents on
+
+        Returns:
+            List of Documents most similar to the query and score for each
+        """
+        docs_and_score = self.similarity_search_with_score(query, k=k, filter=filter)
+        return [doc for doc, _ in docs_and_score]
+
+    @classmethod
+    def from_client_params(
+        cls,
+        embedding: Embeddings,
+        *,
+        host: str = "localhost",
+        port: Union[str, int] = "8108",
+        protocol: str = "http",
+        typesense_api_key: Optional[str] = None,
+        connection_timeout_seconds: int = 2,
+        **kwargs: Any,
+    ) -> Typesense:
+        """Initialize Typesense directly from client parameters.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.embedding.openai import OpenAIEmbeddings
+                from langchain_community.vectorstores import Typesense
+
+                # Pass in typesense_api_key as kwarg or set env var "TYPESENSE_API_KEY".
+                vectorstore = Typesense(
+                    OpenAIEmbeddings(),
+                    host="localhost",
+                    port="8108",
+                    protocol="http",
+                    typesense_collection_name="langchain-memory",
+                )
+        """
+        try:
+            from typesense import Client
+        except ImportError:
+            raise ValueError(
+                "Could not import typesense python package. "
+                "Please install it with `pip install typesense`."
+            )
+
+        node = {
+            "host": host,
+            "port": str(port),
+            "protocol": protocol,
+        }
+        typesense_api_key = typesense_api_key or get_from_env(
+            "typesense_api_key", "TYPESENSE_API_KEY"
+        )
+        client_config = {
+            "nodes": [node],
+            "api_key": typesense_api_key,
+            "connection_timeout_seconds": connection_timeout_seconds,
+        }
+        return cls(Client(client_config), embedding, **kwargs)
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        typesense_client: Optional[Client] = None,
+        typesense_client_params: Optional[dict] = None,
+        typesense_collection_name: Optional[str] = None,
+        text_key: str = "text",
+        **kwargs: Any,
+    ) -> Typesense:
+        """Construct Typesense wrapper from raw text."""
+        if typesense_client:
+            vectorstore = cls(typesense_client, embedding, **kwargs)
+        elif typesense_client_params:
+            vectorstore = cls.from_client_params(
+                embedding, **typesense_client_params, **kwargs
+            )
+        else:
+            raise ValueError(
+                "Must specify one of typesense_client or typesense_client_params."
+            )
+        vectorstore.add_texts(texts, metadatas=metadatas, ids=ids)
+        return vectorstore
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/usearch.py b/llm/Lib/site-packages/langchain_community/vectorstores/usearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ca66e630c81535731b3de9cb3597c462a7f30e0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/usearch.py
@@ -0,0 +1,176 @@
+from __future__ import annotations
+
+from typing import Any, Dict, Iterable, List, Optional, Tuple
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.docstore.base import AddableMixin, Docstore
+from langchain_community.docstore.in_memory import InMemoryDocstore
+
+
+def dependable_usearch_import() -> Any:
+    """
+    Import usearch if available, otherwise raise error.
+    """
+    try:
+        import usearch.index
+    except ImportError:
+        raise ImportError(
+            "Could not import usearch python package. "
+            "Please install it with `pip install usearch` "
+        )
+    return usearch.index
+
+
+class USearch(VectorStore):
+    """`USearch` vector store.
+
+    To use, you should have the ``usearch`` python package installed.
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        index: Any,
+        docstore: Docstore,
+        ids: List[str],
+    ):
+        """Initialize with necessary components."""
+        self.embedding = embedding
+        self.index = index
+        self.docstore = docstore
+        self.ids = ids
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict]] = None,
+        ids: Optional[np.ndarray] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of unique IDs.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        if not isinstance(self.docstore, AddableMixin):
+            raise ValueError(
+                "If trying to add texts, the underlying docstore should support "
+                f"adding items, which {self.docstore} does not"
+            )
+
+        embeddings = self.embedding.embed_documents(list(texts))
+        documents = []
+        for i, text in enumerate(texts):
+            metadata = metadatas[i] if metadatas else {}
+            documents.append(Document(page_content=text, metadata=metadata))
+        last_id = int(self.ids[-1]) + 1
+        if ids is None:
+            ids = np.array([str(last_id + id) for id, _ in enumerate(texts)])
+
+        self.index.add(np.array(ids), np.array(embeddings))
+        self.docstore.add(dict(zip(ids, documents)))
+        self.ids.extend(ids)
+        return ids.tolist()
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of documents most similar to the query with distance.
+        """
+        query_embedding = self.embedding.embed_query(query)
+        matches = self.index.search(np.array(query_embedding), k)
+
+        docs_with_scores: List[Tuple[Document, float]] = []
+        for id, score in zip(matches.keys, matches.distances):
+            doc = self.docstore.search(str(id))
+            if not isinstance(doc, Document):
+                raise ValueError(f"Could not find document for id {id}, got {doc}")
+            docs_with_scores.append((doc, score))
+
+        return docs_with_scores
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        query_embedding = self.embedding.embed_query(query)
+        matches = self.index.search(np.array(query_embedding), k)
+
+        docs: List[Document] = []
+        for id in matches.keys:
+            doc = self.docstore.search(str(id))
+            if not isinstance(doc, Document):
+                raise ValueError(f"Could not find document for id {id}, got {doc}")
+            docs.append(doc)
+
+        return docs
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[Dict]] = None,
+        ids: Optional[np.ndarray] = None,
+        metric: str = "cos",
+        **kwargs: Any,
+    ) -> USearch:
+        """Construct USearch wrapper from raw documents.
+        This is a user friendly interface that:
+            1. Embeds documents.
+            2. Creates an in memory docstore
+            3. Initializes the USearch database
+        This is intended to be a quick way to get started.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import USearch
+                from langchain_community.embeddings import OpenAIEmbeddings
+
+                embeddings = OpenAIEmbeddings()
+                usearch = USearch.from_texts(texts, embeddings)
+        """
+        embeddings = embedding.embed_documents(texts)
+
+        documents: List[Document] = []
+        if ids is None:
+            ids = np.array([str(id) for id, _ in enumerate(texts)])
+        for i, text in enumerate(texts):
+            metadata = metadatas[i] if metadatas else {}
+            documents.append(Document(page_content=text, metadata=metadata))
+
+        docstore = InMemoryDocstore(dict(zip(ids, documents)))
+        usearch = dependable_usearch_import()
+        index = usearch.Index(ndim=len(embeddings[0]), metric=metric)
+        index.add(np.array(ids), np.array(embeddings))
+        return cls(embedding, index, docstore, ids.tolist())
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/utils.py b/llm/Lib/site-packages/langchain_community/vectorstores/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..a21fcec2163351fbd62df72dbe8e39254a672b93
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/utils.py
@@ -0,0 +1,74 @@
+"""Utility functions for working with vectors and vectorstores."""
+
+from enum import Enum
+from typing import List, Tuple, Type
+
+import numpy as np
+from langchain_core.documents import Document
+
+from langchain_community.utils.math import cosine_similarity
+
+
+class DistanceStrategy(str, Enum):
+    """Enumerator of the Distance strategies for calculating distances
+    between vectors."""
+
+    EUCLIDEAN_DISTANCE = "EUCLIDEAN_DISTANCE"
+    MAX_INNER_PRODUCT = "MAX_INNER_PRODUCT"
+    DOT_PRODUCT = "DOT_PRODUCT"
+    JACCARD = "JACCARD"
+    COSINE = "COSINE"
+
+
+def maximal_marginal_relevance(
+    query_embedding: np.ndarray,
+    embedding_list: list,
+    lambda_mult: float = 0.5,
+    k: int = 4,
+) -> List[int]:
+    """Calculate maximal marginal relevance."""
+    if min(k, len(embedding_list)) <= 0:
+        return []
+    if query_embedding.ndim == 1:
+        query_embedding = np.expand_dims(query_embedding, axis=0)
+    similarity_to_query = cosine_similarity(query_embedding, embedding_list)[0]
+    most_similar = int(np.argmax(similarity_to_query))
+    idxs = [most_similar]
+    selected = np.array([embedding_list[most_similar]])
+    while len(idxs) < min(k, len(embedding_list)):
+        best_score = -np.inf
+        idx_to_add = -1
+        similarity_to_selected = cosine_similarity(embedding_list, selected)
+        for i, query_score in enumerate(similarity_to_query):
+            if i in idxs:
+                continue
+            redundant_score = max(similarity_to_selected[i])
+            equation_score = (
+                lambda_mult * query_score - (1 - lambda_mult) * redundant_score
+            )
+            if equation_score > best_score:
+                best_score = equation_score
+                idx_to_add = i
+        idxs.append(idx_to_add)
+        selected = np.append(selected, [embedding_list[idx_to_add]], axis=0)
+    return idxs
+
+
+def filter_complex_metadata(
+    documents: List[Document],
+    *,
+    allowed_types: Tuple[Type, ...] = (str, bool, int, float),
+) -> List[Document]:
+    """Filter out metadata types that are not supported for a vector store."""
+    updated_documents = []
+    for document in documents:
+        filtered_metadata = {}
+        for key, value in document.metadata.items():
+            if not isinstance(value, allowed_types):
+                continue
+            filtered_metadata[key] = value
+
+        document.metadata = filtered_metadata
+        updated_documents.append(document)
+
+    return updated_documents
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/vald.py b/llm/Lib/site-packages/langchain_community/vectorstores/vald.py
new file mode 100644
index 0000000000000000000000000000000000000000..31102ce0f7551f3ac6970d268a3f029819d5eda3
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/vald.py
@@ -0,0 +1,419 @@
+"""Wrapper around Vald vector database."""
+from __future__ import annotations
+
+from typing import Any, Iterable, List, Optional, Tuple, Type
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+
+class Vald(VectorStore):
+    """Vald vector database.
+
+    To use, you should have the ``vald-client-python`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import HuggingFaceEmbeddings
+            from langchain_community.vectorstores import Vald
+
+            texts = ['foo', 'bar', 'baz']
+            vald = Vald.from_texts(
+                texts=texts,
+                embedding=HuggingFaceEmbeddings(),
+                host="localhost",
+                port=8080,
+                skip_strict_exist_check=False,
+             )
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        host: str = "localhost",
+        port: int = 8080,
+        grpc_options: Tuple = (
+            ("grpc.keepalive_time_ms", 1000 * 10),
+            ("grpc.keepalive_timeout_ms", 1000 * 10),
+        ),
+        grpc_use_secure: bool = False,
+        grpc_credentials: Optional[Any] = None,
+    ):
+        self._embedding = embedding
+        self.target = host + ":" + str(port)
+        self.grpc_options = grpc_options
+        self.grpc_use_secure = grpc_use_secure
+        self.grpc_credentials = grpc_credentials
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self._embedding
+
+    def _get_channel(self) -> Any:
+        try:
+            import grpc
+        except ImportError:
+            raise ValueError(
+                "Could not import grpcio python package. "
+                "Please install it with `pip install grpcio`."
+            )
+        return (
+            grpc.secure_channel(
+                self.target, self.grpc_credentials, options=self.grpc_options
+            )
+            if self.grpc_use_secure
+            else grpc.insecure_channel(self.target, options=self.grpc_options)
+        )
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        grpc_metadata: Optional[Any] = None,
+        skip_strict_exist_check: bool = False,
+        **kwargs: Any,
+    ) -> List[str]:
+        """
+        Args:
+            skip_strict_exist_check: Deprecated. This is not used basically.
+        """
+        try:
+            from vald.v1.payload import payload_pb2
+            from vald.v1.vald import upsert_pb2_grpc
+        except ImportError:
+            raise ValueError(
+                "Could not import vald-client-python python package. "
+                "Please install it with `pip install vald-client-python`."
+            )
+
+        channel = self._get_channel()
+        # Depending on the network quality,
+        # it is necessary to wait for ChannelConnectivity.READY.
+        # _ = grpc.channel_ready_future(channel).result(timeout=10)
+        stub = upsert_pb2_grpc.UpsertStub(channel)
+        cfg = payload_pb2.Upsert.Config(skip_strict_exist_check=skip_strict_exist_check)
+
+        ids = []
+        embs = self._embedding.embed_documents(list(texts))
+        for text, emb in zip(texts, embs):
+            vec = payload_pb2.Object.Vector(id=text, vector=emb)
+            res = stub.Upsert(
+                payload_pb2.Upsert.Request(vector=vec, config=cfg),
+                metadata=grpc_metadata,
+            )
+            ids.append(res.uuid)
+
+        channel.close()
+        return ids
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        skip_strict_exist_check: bool = False,
+        grpc_metadata: Optional[Any] = None,
+        **kwargs: Any,
+    ) -> Optional[bool]:
+        """
+        Args:
+            skip_strict_exist_check: Deprecated. This is not used basically.
+        """
+        try:
+            from vald.v1.payload import payload_pb2
+            from vald.v1.vald import remove_pb2_grpc
+        except ImportError:
+            raise ValueError(
+                "Could not import vald-client-python python package. "
+                "Please install it with `pip install vald-client-python`."
+            )
+
+        if ids is None:
+            raise ValueError("No ids provided to delete")
+
+        channel = self._get_channel()
+        # Depending on the network quality,
+        # it is necessary to wait for ChannelConnectivity.READY.
+        # _ = grpc.channel_ready_future(channel).result(timeout=10)
+        stub = remove_pb2_grpc.RemoveStub(channel)
+        cfg = payload_pb2.Remove.Config(skip_strict_exist_check=skip_strict_exist_check)
+
+        for _id in ids:
+            oid = payload_pb2.Object.ID(id=_id)
+            _ = stub.Remove(
+                payload_pb2.Remove.Request(id=oid, config=cfg), metadata=grpc_metadata
+            )
+
+        channel.close()
+        return True
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        radius: float = -1.0,
+        epsilon: float = 0.01,
+        timeout: int = 3000000000,
+        grpc_metadata: Optional[Any] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        docs_and_scores = self.similarity_search_with_score(
+            query, k, radius, epsilon, timeout, grpc_metadata
+        )
+
+        docs = []
+        for doc, _ in docs_and_scores:
+            docs.append(doc)
+
+        return docs
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        radius: float = -1.0,
+        epsilon: float = 0.01,
+        timeout: int = 3000000000,
+        grpc_metadata: Optional[Any] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        emb = self._embedding.embed_query(query)
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            emb, k, radius, epsilon, timeout, grpc_metadata
+        )
+
+        return docs_and_scores
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        radius: float = -1.0,
+        epsilon: float = 0.01,
+        timeout: int = 3000000000,
+        grpc_metadata: Optional[Any] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding, k, radius, epsilon, timeout, grpc_metadata
+        )
+
+        docs = []
+        for doc, _ in docs_and_scores:
+            docs.append(doc)
+
+        return docs
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        radius: float = -1.0,
+        epsilon: float = 0.01,
+        timeout: int = 3000000000,
+        grpc_metadata: Optional[Any] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        try:
+            from vald.v1.payload import payload_pb2
+            from vald.v1.vald import search_pb2_grpc
+        except ImportError:
+            raise ValueError(
+                "Could not import vald-client-python python package. "
+                "Please install it with `pip install vald-client-python`."
+            )
+
+        channel = self._get_channel()
+        # Depending on the network quality,
+        # it is necessary to wait for ChannelConnectivity.READY.
+        # _ = grpc.channel_ready_future(channel).result(timeout=10)
+        stub = search_pb2_grpc.SearchStub(channel)
+        cfg = payload_pb2.Search.Config(
+            num=k, radius=radius, epsilon=epsilon, timeout=timeout
+        )
+
+        res = stub.Search(
+            payload_pb2.Search.Request(vector=embedding, config=cfg),
+            metadata=grpc_metadata,
+        )
+
+        docs_and_scores = []
+        for result in res.results:
+            docs_and_scores.append((Document(page_content=result.id), result.distance))
+
+        channel.close()
+        return docs_and_scores
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        radius: float = -1.0,
+        epsilon: float = 0.01,
+        timeout: int = 3000000000,
+        grpc_metadata: Optional[Any] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        emb = self._embedding.embed_query(query)
+        docs = self.max_marginal_relevance_search_by_vector(
+            emb,
+            k=k,
+            fetch_k=fetch_k,
+            radius=radius,
+            epsilon=epsilon,
+            timeout=timeout,
+            lambda_mult=lambda_mult,
+            grpc_metadata=grpc_metadata,
+        )
+
+        return docs
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        radius: float = -1.0,
+        epsilon: float = 0.01,
+        timeout: int = 3000000000,
+        grpc_metadata: Optional[Any] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        try:
+            from vald.v1.payload import payload_pb2
+            from vald.v1.vald import object_pb2_grpc
+        except ImportError:
+            raise ValueError(
+                "Could not import vald-client-python python package. "
+                "Please install it with `pip install vald-client-python`."
+            )
+        channel = self._get_channel()
+        # Depending on the network quality,
+        # it is necessary to wait for ChannelConnectivity.READY.
+        # _ = grpc.channel_ready_future(channel).result(timeout=10)
+        stub = object_pb2_grpc.ObjectStub(channel)
+
+        docs_and_scores = self.similarity_search_with_score_by_vector(
+            embedding,
+            fetch_k=fetch_k,
+            radius=radius,
+            epsilon=epsilon,
+            timeout=timeout,
+            grpc_metadata=grpc_metadata,
+        )
+
+        docs = []
+        embs = []
+        for doc, _ in docs_and_scores:
+            vec = stub.GetObject(
+                payload_pb2.Object.VectorRequest(
+                    id=payload_pb2.Object.ID(id=doc.page_content)
+                ),
+                metadata=grpc_metadata,
+            )
+            embs.append(vec.vector)
+            docs.append(doc)
+
+        mmr = maximal_marginal_relevance(
+            np.array(embedding),
+            embs,
+            lambda_mult=lambda_mult,
+            k=k,
+        )
+
+        channel.close()
+        return [docs[i] for i in mmr]
+
+    @classmethod
+    def from_texts(
+        cls: Type[Vald],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        host: str = "localhost",
+        port: int = 8080,
+        grpc_options: Tuple = (
+            ("grpc.keepalive_time_ms", 1000 * 10),
+            ("grpc.keepalive_timeout_ms", 1000 * 10),
+        ),
+        grpc_use_secure: bool = False,
+        grpc_credentials: Optional[Any] = None,
+        grpc_metadata: Optional[Any] = None,
+        skip_strict_exist_check: bool = False,
+        **kwargs: Any,
+    ) -> Vald:
+        """
+        Args:
+            skip_strict_exist_check: Deprecated. This is not used basically.
+        """
+        vald = cls(
+            embedding=embedding,
+            host=host,
+            port=port,
+            grpc_options=grpc_options,
+            grpc_use_secure=grpc_use_secure,
+            grpc_credentials=grpc_credentials,
+            **kwargs,
+        )
+        vald.add_texts(
+            texts=texts,
+            metadatas=metadatas,
+            grpc_metadata=grpc_metadata,
+            skip_strict_exist_check=skip_strict_exist_check,
+        )
+        return vald
+
+
+"""We will support if there are any requests."""
+#    async def aadd_texts(
+#        self,
+#        texts: Iterable[str],
+#        metadatas: Optional[List[dict]] = None,
+#        **kwargs: Any,
+#    ) -> List[str]:
+#        pass
+#
+#    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+#        pass
+#
+#    def _similarity_search_with_relevance_scores(
+#        self,
+#        query: str,
+#        k: int = 4,
+#        **kwargs: Any,
+#    ) -> List[Tuple[Document, float]]:
+#        pass
+#
+#    def similarity_search_with_relevance_scores(
+#        self,
+#        query: str,
+#        k: int = 4,
+#        **kwargs: Any,
+#    ) -> List[Tuple[Document, float]]:
+#        pass
+#
+#    async def amax_marginal_relevance_search_by_vector(
+#        self,
+#        embedding: List[float],
+#        k: int = 4,
+#        fetch_k: int = 20,
+#        lambda_mult: float = 0.5,
+#        **kwargs: Any,
+#    ) -> List[Document]:
+#        pass
+#
+#    @classmethod
+#    async def afrom_texts(
+#        cls: Type[VST],
+#        texts: List[str],
+#        embedding: Embeddings,
+#        metadatas: Optional[List[dict]] = None,
+#        **kwargs: Any,
+#    ) -> VST:
+#        pass
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/vdms.py b/llm/Lib/site-packages/langchain_community/vectorstores/vdms.py
new file mode 100644
index 0000000000000000000000000000000000000000..6c3bf4183eb6c7b515583a6ae9a808b1429239db
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/vdms.py
@@ -0,0 +1,1582 @@
+from __future__ import annotations
+
+import base64
+import logging
+import uuid
+from copy import deepcopy
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Literal,
+    Optional,
+    Sized,
+    Tuple,
+    Type,
+    Union,
+    get_args,
+)
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+if TYPE_CHECKING:
+    import vdms
+
+
+DISTANCE_METRICS = Literal[
+    "L2",  # Euclidean Distance
+    "IP",  # Inner Product
+]
+AVAILABLE_DISTANCE_METRICS: List[DISTANCE_METRICS] = list(get_args(DISTANCE_METRICS))
+ENGINES = Literal[
+    "TileDBDense",  # TileDB Dense
+    "TileDBSparse",  # TileDB Sparse
+    "FaissFlat",  # FAISS IndexFlat
+    "FaissIVFFlat",  # FAISS IndexIVFFlat
+    "Flinng",  # FLINNG
+]
+AVAILABLE_ENGINES: List[ENGINES] = list(get_args(ENGINES))
+DEFAULT_COLLECTION_NAME = "langchain"
+DEFAULT_INSERT_BATCH_SIZE = 32
+# Number of Documents to return.
+DEFAULT_K = 3
+# Number of Documents to fetch to pass to knn when filters applied.
+DEFAULT_FETCH_K = DEFAULT_K * 5
+DEFAULT_PROPERTIES = ["_distance", "id", "content"]
+INVALID_DOC_METADATA_KEYS = ["_distance", "content", "blob"]
+INVALID_METADATA_VALUE = ["Missing property", None, {}]  # type: List
+
+
+logger = logging.getLogger(__name__)
+
+
+def _len_check_if_sized(x: Any, y: Any, x_name: str, y_name: str) -> None:
+    """
+    Check that sizes of two variables are the same
+
+    Args:
+        x: Variable to compare
+        y: Variable to compare
+        x_name: Name for variable x
+        y_name: Name for variable y
+    """
+    if isinstance(x, Sized) and isinstance(y, Sized) and len(x) != len(y):
+        raise ValueError(
+            f"{x_name} and {y_name} expected to be equal length but "
+            f"len({x_name})={len(x)} and len({y_name})={len(y)}"
+        )
+    return
+
+
+def VDMS_Client(host: str = "localhost", port: int = 55555) -> vdms.vdms:
+    """VDMS client for the VDMS server.
+
+    Args:
+        host: IP or hostname of VDMS server
+        port: Port to connect to VDMS server
+    """
+    try:
+        import vdms
+    except ImportError:
+        raise ImportError(
+            "Could not import vdms python package. "
+            "Please install it with `pip install vdms."
+        )
+
+    client = vdms.vdms()
+    client.connect(host, port)
+    return client
+
+
+class VDMS(VectorStore):
+    """Intel Lab's VDMS for vector-store workloads.
+
+    To use, you should have both:
+    - the ``vdms`` python package installed
+    - a host (str) and port (int) associated with a deployed VDMS Server
+
+    Visit https://github.com/IntelLabs/vdms/wiki more information.
+
+    IT IS HIGHLY SUGGESTED TO NORMALIZE YOUR DATA.
+
+    Args:
+        client: VDMS Client used to connect to VDMS server
+        collection_name: Name of data collection [Default: langchain]
+        distance_strategy: Method used to calculate distances. VDMS supports
+            "L2" (euclidean distance) or "IP" (inner product) [Default: L2]
+        engine: Underlying implementation for indexing and computing distances.
+            VDMS supports TileDBDense, TileDBSparse, FaissFlat, FaissIVFFlat,
+            and Flinng [Default: FaissFlat]
+        embedding: Any embedding function implementing
+            `langchain_core.embeddings.Embeddings` interface.
+        relevance_score_fn: Function for obtaining relevance score
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.embeddings import HuggingFaceEmbeddings
+            from langchain_community.vectorstores.vdms import VDMS, VDMS_Client
+
+            vectorstore = VDMS(
+                client=VDMS_Client("localhost", 55555),
+                embedding=HuggingFaceEmbeddings(),
+                collection_name="langchain-demo",
+                distance_strategy="L2",
+                engine="FaissFlat",
+            )
+    """
+
+    def __init__(
+        self,
+        client: vdms.vdms,
+        *,
+        embedding: Optional[Embeddings] = None,
+        collection_name: str = DEFAULT_COLLECTION_NAME,  # DescriptorSet name
+        distance_strategy: DISTANCE_METRICS = "L2",
+        engine: ENGINES = "FaissFlat",
+        relevance_score_fn: Optional[Callable[[float], float]] = None,
+    ) -> None:
+        # Check required parameters
+        self._client = client
+        self.similarity_search_engine = engine
+        self.distance_strategy = distance_strategy
+        self.embedding = embedding
+        self._check_required_inputs(collection_name)
+
+        # Update other parameters
+        self.override_relevance_score_fn = relevance_score_fn
+
+        # Initialize collection
+        self._collection_name = self.__add_set(
+            collection_name,
+            engine=self.similarity_search_engine,
+            metric=self.distance_strategy,
+        )
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self.embedding
+
+    def _embed_documents(self, texts: List[str]) -> List[List[float]]:
+        if isinstance(self.embedding, Embeddings):
+            return self.embedding.embed_documents(texts)
+        else:
+            p_str = "Must provide `embedding` which is expected"
+            p_str += " to be an Embeddings object"
+            raise ValueError(p_str)
+
+    def _embed_image(self, uris: List[str]) -> List[List[float]]:
+        if self.embedding is not None and hasattr(self.embedding, "embed_image"):
+            return self.embedding.embed_image(uris=uris)
+        else:
+            raise ValueError(
+                "Must provide `embedding` which has attribute `embed_image`"
+            )
+
+    def _embed_query(self, text: str) -> List[float]:
+        if isinstance(self.embedding, Embeddings):
+            return self.embedding.embed_query(text)
+        else:
+            raise ValueError(
+                "Must provide `embedding` which is expected"
+                " to be an Embeddings object"
+            )
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+        """
+        if self.override_relevance_score_fn is not None:
+            return self.override_relevance_score_fn
+
+        # Default strategy is to rely on distance strategy provided
+        # in vectorstore constructor
+        if self.distance_strategy.lower() in ["ip", "l2"]:
+            return lambda x: x
+        else:
+            raise ValueError(
+                "No supported normalization function"
+                f" for distance_strategy of {self.distance_strategy}."
+                "Consider providing relevance_score_fn to VDMS constructor."
+            )
+
+    def _similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = DEFAULT_K,
+        fetch_k: int = DEFAULT_FETCH_K,
+        filter: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs and their similarity scores on a scale from 0 to 1."""
+        if self.override_relevance_score_fn is None:
+            kwargs["normalize_distance"] = True
+        docs_and_scores = self.similarity_search_with_score(
+            query,
+            k,
+            fetch_k,
+            filter,
+            **kwargs,
+        )
+
+        docs_and_rel_scores: List[Any] = []
+        for doc, score in docs_and_scores:
+            if self.override_relevance_score_fn is None:
+                docs_and_rel_scores.append((doc, score))
+            else:
+                docs_and_rel_scores.append(
+                    (doc, self.override_relevance_score_fn(score))
+                )
+        return docs_and_rel_scores
+
+    def __add(
+        self,
+        collection_name: str,
+        texts: List[str],
+        embeddings: List[List[float]],
+        metadatas: Optional[Union[List[None], List[Dict[str, Any]]]] = None,
+        ids: Optional[List[str]] = None,
+    ) -> List:
+        _len_check_if_sized(texts, embeddings, "texts", "embeddings")
+
+        metadatas = metadatas if metadatas is not None else [None for _ in texts]
+        _len_check_if_sized(texts, metadatas, "texts", "metadatas")
+
+        ids = ids if ids is not None else [str(uuid.uuid4()) for _ in texts]
+        _len_check_if_sized(texts, ids, "texts", "ids")
+
+        all_queries: List[Any] = []
+        all_blobs: List[Any] = []
+        inserted_ids: List[Any] = []
+        for meta, emb, doc, id in zip(metadatas, embeddings, texts, ids):
+            query, blob = self.__get_add_query(
+                collection_name, metadata=meta, embedding=emb, document=doc, id=id
+            )
+
+            if blob is not None:
+                all_queries.append(query)
+                all_blobs.append(blob)
+                inserted_ids.append(id)
+
+        response, response_array = self.__run_vdms_query(all_queries, all_blobs)
+
+        return inserted_ids
+
+    def __add_set(
+        self,
+        collection_name: str,
+        engine: ENGINES = "FaissFlat",
+        metric: DISTANCE_METRICS = "L2",
+    ) -> str:
+        query = _add_descriptorset(
+            "AddDescriptorSet",
+            collection_name,
+            self.embedding_dimension,
+            engine=getattr(engine, "value", engine),
+            metric=getattr(metric, "value", metric),
+        )
+
+        response, _ = self.__run_vdms_query([query])
+
+        if "FailedCommand" in response[0]:
+            raise ValueError(f"Failed to add collection {collection_name}")
+
+        return collection_name
+
+    def __delete(
+        self,
+        collection_name: str,
+        ids: Union[None, List[str]] = None,
+        constraints: Union[None, Dict[str, Any]] = None,
+    ) -> bool:
+        """
+        Deletes entire collection if id is not provided
+        """
+        all_queries: List[Any] = []
+        all_blobs: List[Any] = []
+
+        collection_properties = self.__get_properties(collection_name)
+        results = {"list": collection_properties}
+
+        if constraints is None:
+            constraints = {"_deletion": ["==", 1]}
+        else:
+            constraints["_deletion"] = ["==", 1]
+
+        if ids is not None:
+            constraints["id"] = ["==", ids[0]]  # if len(ids) > 1 else ids[0]]
+
+        query = _add_descriptor(
+            "FindDescriptor",
+            collection_name,
+            label=None,
+            ref=None,
+            props=None,
+            link=None,
+            k_neighbors=None,
+            constraints=constraints,
+            results=results,
+        )
+
+        all_queries.append(query)
+        response, response_array = self.__run_vdms_query(all_queries, all_blobs)
+        return "FindDescriptor" in response[0]
+
+    def __get_add_query(
+        self,
+        collection_name: str,
+        metadata: Optional[Any] = None,
+        embedding: Union[List[float], None] = None,
+        document: Optional[Any] = None,
+        id: Optional[str] = None,
+    ) -> Tuple[Dict[str, Dict[str, Any]], Union[bytes, None]]:
+        if id is None:
+            props: Dict[str, Any] = {}
+        else:
+            props = {"id": id}
+            id_exists, query = _check_descriptor_exists_by_id(
+                self._client, collection_name, id
+            )
+            if id_exists:
+                skipped_value = {
+                    prop_key: prop_val[-1]
+                    for prop_key, prop_val in query["FindDescriptor"][
+                        "constraints"
+                    ].items()
+                }
+                pstr = f"[!] Embedding with id ({id}) exists in DB;"
+                pstr += "Therefore, skipped and not inserted"
+                print(pstr)  # noqa: T201
+                print(f"\tSkipped values are: {skipped_value}")  # noqa: T201
+                return query, None
+
+        if metadata:
+            props.update(metadata)
+        if document:
+            props["content"] = document
+
+        for k in props.keys():
+            if k not in self.collection_properties:
+                self.collection_properties.append(k)
+
+        query = _add_descriptor(
+            "AddDescriptor",
+            collection_name,
+            label=None,
+            ref=None,
+            props=props,
+            link=None,
+            k_neighbors=None,
+            constraints=None,
+            results=None,
+        )
+
+        blob = embedding2bytes(embedding)
+
+        return (
+            query,
+            blob,
+        )
+
+    def __get_properties(
+        self,
+        collection_name: str,
+        unique_entity: Optional[bool] = False,
+        deletion: Optional[bool] = False,
+    ) -> List[str]:
+        find_query = _find_property_entity(
+            collection_name, unique_entity=unique_entity, deletion=deletion
+        )
+        response, response_blob = self.__run_vdms_query([find_query])
+        if len(response_blob) > 0:
+            collection_properties = _bytes2str(response_blob[0]).split(",")
+        else:
+            collection_properties = deepcopy(DEFAULT_PROPERTIES)
+        return collection_properties
+
+    def __run_vdms_query(
+        self,
+        all_queries: List[Dict],
+        all_blobs: Optional[List] = [],
+        print_last_response: Optional[bool] = False,
+    ) -> Tuple[Any, Any]:
+        response, response_array = self._client.query(all_queries, all_blobs)
+
+        _ = _check_valid_response(all_queries, response)
+        if print_last_response:
+            self._client.print_last_response()
+        return response, response_array
+
+    def __update(
+        self,
+        collection_name: str,
+        ids: List[str],
+        documents: List[str],
+        embeddings: List[List[float]],
+        metadatas: Optional[Union[List[None], List[Dict[str, Any]]]] = None,
+    ) -> None:
+        """
+        Updates (find, delete, add) a collection based on id.
+        If more than one collection returned with id, error occuers
+        """
+        _len_check_if_sized(ids, documents, "ids", "documents")
+
+        _len_check_if_sized(ids, embeddings, "ids", "embeddings")
+
+        metadatas = metadatas if metadatas is not None else [None for _ in ids]
+        _len_check_if_sized(ids, metadatas, "ids", "metadatas")
+
+        orig_props = self.__get_properties(collection_name)
+
+        updated_ids: List[Any] = []
+        for meta, emb, doc, id in zip(metadatas, embeddings, documents, ids):
+            results = {"list": self.collection_properties}
+
+            constraints = {"_deletion": ["==", 1]}
+
+            if id is not None:
+                constraints["id"] = ["==", id]
+
+            query = _add_descriptor(
+                "FindDescriptor",
+                collection_name,
+                label=None,
+                ref=None,
+                props=None,
+                link=None,
+                k_neighbors=None,
+                constraints=constraints,
+                results=results,
+            )
+
+            response, response_array = self.__run_vdms_query([query])
+
+            query, blob = self.__get_add_query(
+                collection_name,
+                metadata=meta,
+                embedding=emb,
+                document=doc,
+                id=id,
+            )
+            if blob is not None:
+                response, response_array = self.__run_vdms_query([query], [blob])
+                updated_ids.append(id)
+
+        self.__update_properties(
+            collection_name, orig_props, self.collection_properties
+        )
+
+    def __update_properties(
+        self,
+        collection_name: str,
+        current_collection_properties: List,
+        new_collection_properties: Optional[List],
+    ) -> None:
+        if new_collection_properties is not None:
+            old_collection_properties = deepcopy(current_collection_properties)
+            for prop in new_collection_properties:
+                if prop not in current_collection_properties:
+                    current_collection_properties.append(prop)
+
+            if current_collection_properties != old_collection_properties:
+                all_queries, blob_arr = _build_property_query(
+                    collection_name,
+                    command_type="update",
+                    all_properties=current_collection_properties,
+                )
+                response, _ = self.__run_vdms_query(all_queries, [blob_arr])
+
+    def add_images(
+        self,
+        uris: List[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        batch_size: int = DEFAULT_INSERT_BATCH_SIZE,
+        add_path: Optional[bool] = True,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more images through the embeddings and add to the vectorstore.
+
+        Images are added as embeddings (AddDescriptor) instead of separate
+        entity (AddImage) within VDMS to leverage similarity search capability
+
+        Args:
+            uris: List of paths to the images to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of unique IDs.
+            batch_size (int): Number of concurrent requests to send to the server.
+            add_path: Bool to add image path as metadata
+
+        Returns:
+            List of ids from adding images into the vectorstore.
+        """
+        # Map from uris to blobs to base64
+        b64_texts = [self.encode_image(image_path=uri) for uri in uris]
+
+        if add_path and metadatas:
+            for midx, uri in enumerate(uris):
+                metadatas[midx]["image_path"] = uri
+        elif add_path:
+            metadatas = []
+            for uri in uris:
+                metadatas.append({"image_path": uri})
+
+        # Populate IDs
+        ids = ids if ids is not None else [str(uuid.uuid4()) for _ in uris]
+
+        # Set embeddings
+        embeddings = self._embed_image(uris=uris)
+
+        if metadatas is None:
+            metadatas = [{} for _ in uris]
+        else:
+            metadatas = [_validate_vdms_properties(m) for m in metadatas]
+
+        self.__from(
+            texts=b64_texts,
+            embeddings=embeddings,
+            ids=ids,
+            metadatas=metadatas,
+            batch_size=batch_size,
+            **kwargs,
+        )
+        return ids
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        batch_size: int = DEFAULT_INSERT_BATCH_SIZE,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: List of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of unique IDs.
+            batch_size (int): Number of concurrent requests to send to the server.
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+
+        texts = list(texts)
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+
+        embeddings = self._embed_documents(texts)
+
+        if metadatas is None:
+            metadatas = [{} for _ in texts]
+        else:
+            metadatas = [_validate_vdms_properties(m) for m in metadatas]
+
+        inserted_ids = self.__from(
+            texts=texts,
+            embeddings=embeddings,
+            ids=ids,
+            metadatas=metadatas,
+            batch_size=batch_size,
+            **kwargs,
+        )
+        return inserted_ids
+
+    def __from(
+        self,
+        texts: List[str],
+        embeddings: List[List[float]],
+        ids: List[str],
+        metadatas: Optional[List[dict]] = None,
+        batch_size: int = DEFAULT_INSERT_BATCH_SIZE,
+        **kwargs: Any,
+    ) -> List[str]:
+        # Get initial properties
+        orig_props = self.__get_properties(self._collection_name)
+        inserted_ids: List[str] = []
+        for start_idx in range(0, len(texts), batch_size):
+            end_idx = min(start_idx + batch_size, len(texts))
+
+            batch_texts = texts[start_idx:end_idx]
+            batch_embedding_vectors = embeddings[start_idx:end_idx]
+            batch_ids = ids[start_idx:end_idx]
+            if metadatas:
+                batch_metadatas = metadatas[start_idx:end_idx]
+
+            result = self.__add(
+                self._collection_name,
+                embeddings=batch_embedding_vectors,
+                texts=batch_texts,
+                metadatas=batch_metadatas,
+                ids=batch_ids,
+            )
+
+            inserted_ids.extend(result)
+
+        # Update Properties
+        self.__update_properties(
+            self._collection_name, orig_props, self.collection_properties
+        )
+        return inserted_ids
+
+    def _check_required_inputs(self, collection_name: str) -> None:
+        # Check connection to client
+        if not self._client.is_connected():
+            raise ValueError(
+                "VDMS client must be connected to a VDMS server."
+                + "Please use VDMS_Client to establish a connection"
+            )
+
+        # Check Distance Metric
+        if self.distance_strategy not in AVAILABLE_DISTANCE_METRICS:
+            raise ValueError("distance_strategy must be either 'L2' or 'IP'")
+
+        # Check Engines
+        if self.similarity_search_engine not in AVAILABLE_ENGINES:
+            raise ValueError(
+                "engine must be either 'TileDBDense', 'TileDBSparse', "
+                + "'FaissFlat', 'FaissIVFFlat', or 'Flinng'"
+            )
+
+        # Check Embedding Func is provided and store dimension size
+        if self.embedding is None:
+            raise ValueError("Must provide embedding function")
+
+        self.embedding_dimension = len(self._embed_query("This is a sample sentence."))
+
+        # Check for properties
+        current_props = self.__get_properties(collection_name)
+        if hasattr(self, "collection_properties"):
+            self.collection_properties.extend(current_props)
+        else:
+            self.collection_properties: List[str] = current_props
+
+    def count(self, collection_name: str) -> int:
+        all_queries: List[Any] = []
+        all_blobs: List[Any] = []
+
+        results = {"count": "", "list": ["id"]}  # collection_properties}
+        query = _add_descriptor(
+            "FindDescriptor",
+            collection_name,
+            label=None,
+            ref=None,
+            props=None,
+            link=None,
+            k_neighbors=None,
+            constraints=None,
+            results=results,
+        )
+
+        all_queries.append(query)
+
+        response, response_array = self.__run_vdms_query(all_queries, all_blobs)
+        return response[0]["FindDescriptor"]["returned"]
+
+    def decode_image(self, base64_image: str) -> bytes:
+        return base64.b64decode(base64_image)
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        collection_name: Optional[str] = None,
+        constraints: Optional[Dict] = None,
+        **kwargs: Any,
+    ) -> bool:
+        """Delete by ID. These are the IDs in the vectorstore.
+
+        Args:
+            ids: List of ids to delete.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+        name = collection_name if collection_name is not None else self._collection_name
+        return self.__delete(name, ids=ids, constraints=constraints)
+
+    def get_k_candidates(
+        self,
+        setname: str,
+        fetch_k: Optional[int],
+        results: Optional[Dict[str, Any]] = None,
+        all_blobs: Optional[List] = None,
+        normalize: Optional[bool] = False,
+    ) -> Tuple[List[Dict[str, Any]], List, float]:
+        max_dist = 1
+        command_str = "FindDescriptor"
+        query = _add_descriptor(
+            command_str,
+            setname,
+            k_neighbors=fetch_k,
+            results=results,
+        )
+        response, response_array = self.__run_vdms_query([query], all_blobs)
+
+        if normalize:
+            max_dist = response[0][command_str]["entities"][-1]["_distance"]
+
+        return response, response_array, max_dist
+
+    def get_descriptor_response(
+        self,
+        command_str: str,
+        setname: str,
+        k_neighbors: int = DEFAULT_K,
+        fetch_k: int = DEFAULT_FETCH_K,
+        constraints: Optional[dict] = None,
+        results: Optional[Dict[str, Any]] = None,
+        query_embedding: Optional[List[float]] = None,
+        normalize_distance: bool = False,
+    ) -> Tuple[List[Dict[str, Any]], List]:
+        all_blobs: List[Any] = []
+        blob = embedding2bytes(query_embedding)
+        if blob is not None:
+            all_blobs.append(blob)
+
+        if constraints is None:
+            # K results returned
+            response, response_array, max_dist = self.get_k_candidates(
+                setname, k_neighbors, results, all_blobs, normalize=normalize_distance
+            )
+        else:
+            if results is None:
+                results = {"list": ["id"]}
+            elif "list" not in results:
+                results["list"] = ["id"]
+            elif "id" not in results["list"]:
+                results["list"].append("id")
+
+            # (1) Find docs satisfy constraints
+            query = _add_descriptor(
+                command_str,
+                setname,
+                constraints=constraints,
+                results=results,
+            )
+            response, response_array = self.__run_vdms_query([query])
+            ids_of_interest = [
+                ent["id"] for ent in response[0][command_str]["entities"]
+            ]
+
+            # (2) Find top fetch_k results
+            response, response_array, max_dist = self.get_k_candidates(
+                setname, fetch_k, results, all_blobs, normalize=normalize_distance
+            )
+
+            # (3) Intersection of (1) & (2) using ids
+            new_entities: List[Dict] = []
+            for ent in response[0][command_str]["entities"]:
+                if ent["id"] in ids_of_interest:
+                    new_entities.append(ent)
+                if len(new_entities) == k_neighbors:
+                    break
+            response[0][command_str]["entities"] = new_entities
+            response[0][command_str]["returned"] = len(new_entities)
+            if len(new_entities) < k_neighbors:
+                p_str = "Returned items < k_neighbors; Try increasing fetch_k"
+                print(p_str)  # noqa: T201
+
+        if normalize_distance:
+            max_dist = 1.0 if max_dist == 0 else max_dist
+            for ent_idx, ent in enumerate(response[0][command_str]["entities"]):
+                ent["_distance"] = ent["_distance"] / max_dist
+                response[0][command_str]["entities"][ent_idx]["_distance"] = ent[
+                    "_distance"
+                ]
+
+        return response, response_array
+
+    def encode_image(self, image_path: str) -> str:
+        with open(image_path, "rb") as f:
+            blob = f.read()
+            return base64.b64encode(blob).decode("utf-8")
+
+    @classmethod
+    def from_documents(
+        cls: Type[VDMS],
+        documents: List[Document],
+        embedding: Optional[Embeddings] = None,
+        ids: Optional[List[str]] = None,
+        batch_size: int = DEFAULT_INSERT_BATCH_SIZE,
+        collection_name: str = DEFAULT_COLLECTION_NAME,  # Add this line
+        **kwargs: Any,
+    ) -> VDMS:
+        """Create a VDMS vectorstore from a list of documents.
+
+        Args:
+            collection_name (str): Name of the collection to create.
+            documents (List[Document]): List of documents to add to vectorstore.
+            embedding (Embeddings): Embedding function. Defaults to None.
+            ids (Optional[List[str]]): List of document IDs. Defaults to None.
+            batch_size (int): Number of concurrent requests to send to the server.
+
+        Returns:
+            VDMS: VDMS vectorstore.
+        """
+        client: vdms.vdms = kwargs["client"]
+
+        return cls.from_texts(
+            client=client,
+            texts=[doc.page_content for doc in documents],
+            metadatas=[doc.metadata for doc in documents],
+            embedding=embedding,
+            ids=ids,
+            batch_size=batch_size,
+            collection_name=collection_name,
+            # **kwargs,
+        )
+
+    @classmethod
+    def from_texts(
+        cls: Type[VDMS],
+        texts: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        batch_size: int = DEFAULT_INSERT_BATCH_SIZE,
+        collection_name: str = DEFAULT_COLLECTION_NAME,
+        **kwargs: Any,
+    ) -> VDMS:
+        """Create a VDMS vectorstore from a raw documents.
+
+        Args:
+            texts (List[str]): List of texts to add to the collection.
+            embedding (Embeddings): Embedding function. Defaults to None.
+            metadatas (Optional[List[dict]]): List of metadatas. Defaults to None.
+            ids (Optional[List[str]]): List of document IDs. Defaults to None.
+            batch_size (int): Number of concurrent requests to send to the server.
+            collection_name (str): Name of the collection to create.
+
+        Returns:
+            VDMS: VDMS vectorstore.
+        """
+        client: vdms.vdms = kwargs["client"]
+        vdms_collection = cls(
+            collection_name=collection_name,
+            embedding=embedding,
+            client=client,
+            # **kwargs,
+        )
+        if ids is None:
+            ids = [str(uuid.uuid4()) for _ in texts]
+        vdms_collection.add_texts(
+            texts=texts,
+            metadatas=metadatas,
+            ids=ids,
+            batch_size=batch_size,  # **kwargs
+        )
+        return vdms_collection
+
+    def get(
+        self,
+        collection_name: str,
+        constraints: Optional[Dict] = None,
+        limit: Optional[int] = None,
+        include: List[str] = ["metadata"],
+    ) -> Tuple[Any, Any]:
+        """Gets the collection.
+        Get embeddings and their associated data from the data store.
+        If no constraints provided returns all embeddings up to limit.
+
+        Args:
+            constraints: A dict used to filter results by.
+                   E.g. `{"color" : ["==", "red"], "price": [">", 4.00]}`. Optional.
+            limit: The number of documents to return. Optional.
+            include: A list of what to include in the results.
+                     Can contain `"embeddings"`, `"metadatas"`, `"documents"`.
+                     Ids are always included.
+                     Defaults to `["metadatas", "documents"]`. Optional.
+        """
+        all_queries: List[Any] = []
+        all_blobs: List[Any] = []
+
+        results: Dict[str, Any] = {"count": ""}
+
+        if limit is not None:
+            results["limit"] = limit
+
+        # Include metadata
+        if "metadata" in include:
+            collection_properties = self.__get_properties(collection_name)
+            results["list"] = collection_properties
+
+        # Include embedding
+        if "embeddings" in include:
+            results["blob"] = True
+
+        query = _add_descriptor(
+            "FindDescriptor",
+            collection_name,
+            k_neighbors=None,
+            constraints=constraints,
+            results=results,
+        )
+
+        all_queries.append(query)
+
+        response, response_array = self.__run_vdms_query(all_queries, all_blobs)
+        return response, response_array
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = DEFAULT_K,
+        fetch_k: int = DEFAULT_FETCH_K,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, List]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        if self.embedding is None:
+            raise ValueError(
+                "For MMR search, you must specify an embedding function on" "creation."
+            )
+
+        embedding_vector: List[float] = self._embed_query(query)
+        docs = self.max_marginal_relevance_search_by_vector(
+            embedding_vector,
+            k,
+            fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+        )
+        return docs
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_K,
+        fetch_k: int = DEFAULT_FETCH_K,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, List]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        results = self.query_collection_embeddings(
+            query_embeddings=[embedding],
+            n_results=fetch_k,
+            filter=filter,
+            include=["metadatas", "documents", "distances", "embeddings"],
+        )
+
+        embedding_list = [list(_bytes2embedding(result)) for result in results[0][1]]
+
+        mmr_selected = maximal_marginal_relevance(
+            np.array(embedding, dtype=np.float32),
+            embedding_list,
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+
+        candidates = _results_to_docs(results)
+
+        selected_results = [r for i, r in enumerate(candidates) if i in mmr_selected]
+        return selected_results
+
+    def max_marginal_relevance_search_with_score(
+        self,
+        query: str,
+        k: int = DEFAULT_K,
+        fetch_k: int = DEFAULT_FETCH_K,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, List]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        if self.embedding is None:
+            raise ValueError(
+                "For MMR search, you must specify an embedding function on" "creation."
+            )
+
+        embedding = self._embed_query(query)
+        docs = self.max_marginal_relevance_search_with_score_by_vector(
+            embedding,
+            k,
+            fetch_k,
+            lambda_mult=lambda_mult,
+            filter=filter,
+        )
+        return docs
+
+    def max_marginal_relevance_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_K,
+        fetch_k: int = DEFAULT_FETCH_K,
+        lambda_mult: float = 0.5,
+        filter: Optional[Dict[str, List]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        results = self.query_collection_embeddings(
+            query_embeddings=[embedding],
+            n_results=fetch_k,
+            filter=filter,
+            include=["metadatas", "documents", "distances", "embeddings"],
+        )
+
+        embedding_list = [list(_bytes2embedding(result)) for result in results[0][1]]
+
+        mmr_selected = maximal_marginal_relevance(
+            np.array(embedding, dtype=np.float32),
+            embedding_list,
+            k=k,
+            lambda_mult=lambda_mult,
+        )
+
+        candidates = _results_to_docs_and_scores(results)
+
+        selected_results = [
+            (r, s) for i, (r, s) in enumerate(candidates) if i in mmr_selected
+        ]
+        return selected_results
+
+    def query_collection_embeddings(
+        self,
+        query_embeddings: Optional[List[List[float]]] = None,
+        collection_name: Optional[str] = None,
+        n_results: int = DEFAULT_K,
+        fetch_k: int = DEFAULT_FETCH_K,
+        filter: Union[None, Dict[str, Any]] = None,
+        results: Union[None, Dict[str, Any]] = None,
+        normalize_distance: bool = False,
+        **kwargs: Any,
+    ) -> List[Tuple[Dict[str, Any], List]]:
+        all_responses: List[Any] = []
+
+        if collection_name is None:
+            collection_name = self._collection_name
+
+        if query_embeddings is None:
+            return all_responses
+
+        include = kwargs.get("include", ["metadatas"])
+        if results is None and "metadatas" in include:
+            results = {
+                "list": self.collection_properties,
+                "blob": "embeddings" in include,
+            }
+
+        for qemb in query_embeddings:
+            response, response_array = self.get_descriptor_response(
+                "FindDescriptor",
+                collection_name,
+                k_neighbors=n_results,
+                fetch_k=fetch_k,
+                constraints=filter,
+                results=results,
+                normalize_distance=normalize_distance,
+                query_embedding=qemb,
+            )
+            all_responses.append([response, response_array])
+
+        return all_responses
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = DEFAULT_K,
+        fetch_k: int = DEFAULT_FETCH_K,
+        filter: Optional[Dict[str, List]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Run similarity search with VDMS.
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 3.
+            fetch_k (int): Number of candidates to fetch for knn (>= k).
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Document]: List of documents most similar to the query text.
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query, k, fetch_k, filter=filter, **kwargs
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_K,
+        fetch_k: int = DEFAULT_FETCH_K,
+        filter: Optional[Dict[str, List]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+        Args:
+            embedding (List[float]): Embedding to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 3.
+            fetch_k (int): Number of candidates to fetch for knn (>= k).
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        results = self.query_collection_embeddings(
+            query_embeddings=[embedding],
+            n_results=k,
+            fetch_k=fetch_k,
+            filter=filter,
+            **kwargs,
+        )
+
+        return _results_to_docs(results)
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = DEFAULT_K,
+        fetch_k: int = DEFAULT_FETCH_K,
+        filter: Optional[Dict[str, List]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search with VDMS with distance.
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 3.
+            fetch_k (int): Number of candidates to fetch for knn (>= k).
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Tuple[Document, float]]: List of documents most similar to
+            the query text and cosine distance in float for each.
+            Lower score represents more similarity.
+        """
+        if self.embedding is None:
+            raise ValueError("Must provide embedding function")
+        else:
+            query_embedding: List[float] = self._embed_query(query)
+            results = self.query_collection_embeddings(
+                query_embeddings=[query_embedding],
+                n_results=k,
+                fetch_k=fetch_k,
+                filter=filter,
+                **kwargs,
+            )
+
+        return _results_to_docs_and_scores(results)
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_K,
+        fetch_k: int = DEFAULT_FETCH_K,
+        filter: Optional[Dict[str, List]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """
+        Return docs most similar to embedding vector and similarity score.
+
+        Args:
+            embedding (List[float]): Embedding to look up documents similar to.
+            k (int): Number of Documents to return. Defaults to 3.
+            fetch_k (int): Number of candidates to fetch for knn (>= k).
+            filter (Optional[Dict[str, str]]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Tuple[Document, float]]: List of documents most similar to
+            the query text and cosine distance in float for each.
+            Lower score represents more similarity.
+        """
+        kwargs["normalize_distance"] = True
+
+        results = self.query_collection_embeddings(
+            query_embeddings=[embedding],
+            n_results=k,
+            fetch_k=fetch_k,
+            filter=filter,
+            **kwargs,
+        )
+        return _results_to_docs_and_scores(results)
+
+    def update_document(
+        self, collection_name: str, document_id: str, document: Document
+    ) -> None:
+        """Update a document in the collection.
+
+        Args:
+            document_id (str): ID of the document to update.
+            document (Document): Document to update.
+        """
+        return self.update_documents(collection_name, [document_id], [document])
+
+    def update_documents(
+        self, collection_name: str, ids: List[str], documents: List[Document]
+    ) -> None:
+        """Update a document in the collection.
+
+        Args:
+            ids (List[str]): List of ids of the document to update.
+            documents (List[Document]): List of documents to update.
+        """
+        text = [document.page_content for document in documents]
+        metadata = [
+            _validate_vdms_properties(document.metadata) for document in documents
+        ]
+        embeddings = self._embed_documents(text)
+
+        self.__update(
+            collection_name,
+            ids,
+            metadatas=metadata,
+            embeddings=embeddings,
+            documents=text,
+        )
+
+
+# VDMS UTILITY
+
+
+def _results_to_docs(results: Any) -> List[Document]:
+    return [doc for doc, _ in _results_to_docs_and_scores(results)]
+
+
+def _results_to_docs_and_scores(results: Any) -> List[Tuple[Document, float]]:
+    final_res: List[Any] = []
+    responses, blobs = results[0]
+    if (
+        "FindDescriptor" in responses[0]
+        and "entities" in responses[0]["FindDescriptor"]
+    ):
+        result_entities = responses[0]["FindDescriptor"]["entities"]
+        # result_blobs = blobs
+        for ent in result_entities:
+            distance = ent["_distance"]
+            txt_contents = ent["content"]
+            for p in INVALID_DOC_METADATA_KEYS:
+                if p in ent:
+                    del ent[p]
+            props = {
+                mkey: mval
+                for mkey, mval in ent.items()
+                if mval not in INVALID_METADATA_VALUE
+            }
+
+            final_res.append(
+                (Document(page_content=txt_contents, metadata=props), distance)
+            )
+    return final_res
+
+
+def _add_descriptor(
+    command_str: str,
+    setname: str,
+    label: Optional[str] = None,
+    ref: Optional[int] = None,
+    props: Optional[dict] = None,
+    link: Optional[dict] = None,
+    k_neighbors: Optional[int] = None,
+    constraints: Optional[dict] = None,
+    results: Optional[dict] = None,
+) -> Dict[str, Dict[str, Any]]:
+    entity: Dict[str, Any] = {"set": setname}
+
+    if "Add" in command_str and label:
+        entity["label"] = label
+
+    if ref is not None:
+        entity["_ref"] = ref
+
+    if props not in INVALID_METADATA_VALUE:
+        entity["properties"] = props
+
+    if "Add" in command_str and link is not None:
+        entity["link"] = link
+
+    if "Find" in command_str and k_neighbors is not None:
+        entity["k_neighbors"] = int(k_neighbors)
+
+    if "Find" in command_str and constraints not in INVALID_METADATA_VALUE:
+        entity["constraints"] = constraints
+
+    if "Find" in command_str and results not in INVALID_METADATA_VALUE:
+        entity["results"] = results
+
+    query = {command_str: entity}
+    return query
+
+
+def _add_descriptorset(
+    command_str: str,
+    name: str,
+    num_dims: Optional[int] = None,
+    engine: Optional[str] = None,
+    metric: Optional[str] = None,
+    ref: Optional[int] = None,
+    props: Optional[Dict] = None,
+    link: Optional[Dict] = None,
+    storeIndex: bool = False,
+    constraints: Optional[Dict] = None,
+    results: Optional[Dict] = None,
+) -> Dict[str, Any]:
+    if command_str == "AddDescriptorSet" and all(
+        var is not None for var in [name, num_dims]
+    ):
+        entity: Dict[str, Any] = {
+            "name": name,
+            "dimensions": num_dims,
+        }
+
+        if engine is not None:
+            entity["engine"] = engine
+
+        if metric is not None:
+            entity["metric"] = metric
+
+        if ref is not None:
+            entity["_ref"] = ref
+
+        if props not in [None, {}]:
+            entity["properties"] = props
+
+        if link is not None:
+            entity["link"] = link
+
+    elif command_str == "FindDescriptorSet":
+        entity = {"set": name}
+
+        if storeIndex:
+            entity["storeIndex"] = storeIndex
+
+        if constraints not in [None, {}]:
+            entity["constraints"] = constraints
+
+        if results is not None:
+            entity["results"] = results
+
+    else:
+        raise ValueError(f"Unknown command: {command_str}")
+
+    query = {command_str: entity}
+    return query
+
+
+def _add_entity_with_blob(
+    collection_name: str, all_properties: List
+) -> Tuple[Dict[str, Any], bytes]:
+    all_properties_str = ",".join(all_properties) if len(all_properties) > 0 else ""
+
+    querytype = "AddEntity"
+    entity: Dict[str, Any] = {}
+    entity["class"] = "properties"
+    entity["blob"] = True  # New
+
+    props: Dict[str, Any] = {"name": collection_name}
+    props["type"] = "queryable properties"
+    props["content"] = all_properties_str
+    entity["properties"] = props
+
+    byte_data = _str2bytes(all_properties_str)
+
+    query: Dict[str, Any] = {}
+    query[querytype] = entity
+    return query, byte_data
+
+
+def _build_property_query(
+    collection_name: str,
+    command_type: str = "find",
+    all_properties: List = [],
+    ref: Optional[int] = None,
+) -> Tuple[Any, Any]:
+    all_queries: List[Any] = []
+    blob_arr: List[Any] = []
+
+    choices = ["find", "add", "update"]
+    if command_type.lower() not in choices:
+        raise ValueError("[!] Invalid type. Choices are : {}".format(",".join(choices)))
+
+    if command_type.lower() == "find":
+        query = _find_property_entity(collection_name, unique_entity=True)
+        all_queries.append(query)
+
+    elif command_type.lower() == "add":
+        query, byte_data = _add_entity_with_blob(collection_name, all_properties)
+        all_queries.append(query)
+        blob_arr.append(byte_data)
+
+    elif command_type.lower() == "update":
+        # Find & Delete
+        query = _find_property_entity(collection_name, deletion=True)
+        all_queries.append(query)
+
+        # Add
+        query, byte_data = _add_entity_with_blob(collection_name, all_properties)
+        all_queries.append(query)
+        blob_arr.append(byte_data)
+
+    return all_queries, blob_arr
+
+
+def _bytes2embedding(blob: bytes) -> Any:
+    emb = np.frombuffer(blob, dtype="float32")
+    return emb
+
+
+def _bytes2str(in_bytes: bytes) -> str:
+    return in_bytes.decode()
+
+
+def _get_cmds_from_query(all_queries: list) -> List[str]:
+    return list(set([k for q in all_queries for k in q.keys()]))
+
+
+def _check_valid_response(all_queries: List[dict], response: Any) -> bool:
+    cmd_list = _get_cmds_from_query(all_queries)
+    valid_res = isinstance(response, list) and any(
+        cmd in response[0]
+        and "returned" in response[0][cmd]
+        and response[0][cmd]["returned"] > 0
+        for cmd in cmd_list
+    )
+    return valid_res
+
+
+def _check_descriptor_exists_by_id(
+    client: vdms.vdms,
+    setname: str,
+    id: str,
+) -> Tuple[bool, Any]:
+    constraints = {"id": ["==", id]}
+    findDescriptor = _add_descriptor(
+        "FindDescriptor",
+        setname,
+        constraints=constraints,
+        results={"list": ["id"], "count": ""},
+    )
+    all_queries = [findDescriptor]
+    res, _ = client.query(all_queries)
+
+    valid_res = _check_valid_response(all_queries, res)
+    return valid_res, findDescriptor
+
+
+def embedding2bytes(embedding: Union[List[float], None]) -> Union[bytes, None]:
+    """Convert embedding to bytes."""
+
+    blob = None
+    if embedding is not None:
+        emb = np.array(embedding, dtype="float32")
+        blob = emb.tobytes()
+    return blob
+
+
+def _find_property_entity(
+    collection_name: str,
+    unique_entity: Optional[bool] = False,
+    deletion: Optional[bool] = False,
+) -> Dict[str, Dict[str, Any]]:
+    querytype = "FindEntity"
+    entity: Dict[str, Any] = {}
+    entity["class"] = "properties"
+    if unique_entity:
+        entity["unique"] = unique_entity
+
+    results: Dict[str, Any] = {}
+    results["blob"] = True
+    results["count"] = ""
+    results["list"] = ["content"]
+    entity["results"] = results
+
+    constraints: Dict[str, Any] = {}
+    if deletion:
+        constraints["_deletion"] = ["==", 1]
+    constraints["name"] = ["==", collection_name]
+    entity["constraints"] = constraints
+
+    query: Dict[str, Any] = {}
+    query[querytype] = entity
+    return query
+
+
+def _str2bytes(in_str: str) -> bytes:
+    return str.encode(in_str)
+
+
+def _validate_vdms_properties(metadata: Dict[str, Any]) -> Dict:
+    new_metadata: Dict[str, Any] = {}
+    for key, value in metadata.items():
+        if not isinstance(value, list):
+            new_metadata[str(key)] = value
+    return new_metadata
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/vearch.py b/llm/Lib/site-packages/langchain_community/vectorstores/vearch.py
new file mode 100644
index 0000000000000000000000000000000000000000..5fac20f7b8aa8a79811c4fc22e5b2ed82305d8eb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/vearch.py
@@ -0,0 +1,577 @@
+from __future__ import annotations
+
+import os
+import time
+import uuid
+from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Optional, Tuple, Type
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    import vearch
+
+DEFAULT_TOPN = 4
+
+
+class Vearch(VectorStore):
+    _DEFAULT_TABLE_NAME = "langchain_vearch"
+    _DEFAULT_CLUSTER_DB_NAME = "cluster_client_db"
+    _DEFAULT_VERSION = 1
+
+    def __init__(
+        self,
+        embedding_function: Embeddings,
+        path_or_url: Optional[str] = None,
+        table_name: str = _DEFAULT_TABLE_NAME,
+        db_name: str = _DEFAULT_CLUSTER_DB_NAME,
+        flag: int = _DEFAULT_VERSION,
+        **kwargs: Any,
+    ) -> None:
+        """Initialize vearch vector store
+        flag 1 for cluster,0 for standalone
+        """
+        try:
+            if flag:
+                import vearch_cluster
+            else:
+                import vearch
+        except ImportError:
+            raise ValueError(
+                "Could not import suitable python package. "
+                "Please install it with `pip install vearch or vearch_cluster`."
+            )
+
+        if flag:
+            if path_or_url is None:
+                raise ValueError("Please input url of cluster")
+            if not db_name:
+                db_name = self._DEFAULT_CLUSTER_DB_NAME
+                db_name += "_"
+                db_name += str(uuid.uuid4()).split("-")[-1]
+            self.using_db_name = db_name
+            self.url = path_or_url
+            self.vearch = vearch_cluster.VearchCluster(path_or_url)
+
+        else:
+            if path_or_url is None:
+                metadata_path = os.getcwd().replace("\\", "/")
+            else:
+                metadata_path = path_or_url
+            if not os.path.isdir(metadata_path):
+                os.makedirs(metadata_path)
+            log_path = os.path.join(metadata_path, "log")
+            if not os.path.isdir(log_path):
+                os.makedirs(log_path)
+            self.vearch = vearch.Engine(metadata_path, log_path)
+            self.using_metapath = metadata_path
+        if not table_name:
+            table_name = self._DEFAULT_TABLE_NAME
+            table_name += "_"
+            table_name += str(uuid.uuid4()).split("-")[-1]
+        self.using_table_name = table_name
+        self.embedding_func = embedding_function
+        self.flag = flag
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self.embedding_func
+
+    @classmethod
+    def from_documents(
+        cls: Type[Vearch],
+        documents: List[Document],
+        embedding: Embeddings,
+        path_or_url: Optional[str] = None,
+        table_name: str = _DEFAULT_TABLE_NAME,
+        db_name: str = _DEFAULT_CLUSTER_DB_NAME,
+        flag: int = _DEFAULT_VERSION,
+        **kwargs: Any,
+    ) -> Vearch:
+        """Return Vearch VectorStore"""
+
+        texts = [d.page_content for d in documents]
+        metadatas = [d.metadata for d in documents]
+
+        return cls.from_texts(
+            texts=texts,
+            embedding=embedding,
+            metadatas=metadatas,
+            path_or_url=path_or_url,
+            table_name=table_name,
+            db_name=db_name,
+            flag=flag,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_texts(
+        cls: Type[Vearch],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        path_or_url: Optional[str] = None,
+        table_name: str = _DEFAULT_TABLE_NAME,
+        db_name: str = _DEFAULT_CLUSTER_DB_NAME,
+        flag: int = _DEFAULT_VERSION,
+        **kwargs: Any,
+    ) -> Vearch:
+        """Return Vearch VectorStore"""
+
+        vearch_db = cls(
+            embedding_function=embedding,
+            embedding=embedding,
+            path_or_url=path_or_url,
+            db_name=db_name,
+            table_name=table_name,
+            flag=flag,
+        )
+        vearch_db.add_texts(texts=texts, metadatas=metadatas)
+        return vearch_db
+
+    def _create_table(
+        self,
+        dim: int = 1024,
+        field_list: List[dict] = [
+            {"field": "text", "type": "str"},
+            {"field": "metadata", "type": "str"},
+        ],
+    ) -> int:
+        """
+        Create VectorStore Table
+        Args:
+            dim:dimension of vector
+            fields_list: the field you want to store
+        Return:
+            code,0 for success,1 for failed
+        """
+
+        type_dict = {"int": vearch.dataType.INT, "str": vearch.dataType.STRING}
+        engine_info = {
+            "index_size": 10000,
+            "retrieval_type": "IVFPQ",
+            "retrieval_param": {"ncentroids": 2048, "nsubvector": 32},
+        }
+        fields = [
+            vearch.GammaFieldInfo(fi["field"], type_dict[fi["type"]])
+            for fi in field_list
+        ]
+        vector_field = vearch.GammaVectorInfo(
+            name="text_embedding",
+            type=vearch.dataType.VECTOR,
+            is_index=True,
+            dimension=dim,
+            model_id="",
+            store_type="MemoryOnly",
+            store_param={"cache_size": 10000},
+            has_source=False,
+        )
+        response_code = self.vearch.create_table(
+            engine_info,
+            name=self.using_table_name,
+            fields=fields,
+            vector_field=vector_field,
+        )
+        return response_code
+
+    def _create_space(
+        self,
+        dim: int = 1024,
+    ) -> int:
+        """
+        Create VectorStore space
+        Args:
+            dim:dimension of vector
+        Return:
+            code,0 failed for ,1 for success
+        """
+        space_config = {
+            "name": self.using_table_name,
+            "partition_num": 1,
+            "replica_num": 1,
+            "engine": {
+                "name": "gamma",
+                "index_size": 1,
+                "retrieval_type": "FLAT",
+                "retrieval_param": {
+                    "metric_type": "L2",
+                },
+            },
+            "properties": {
+                "text": {
+                    "type": "string",
+                },
+                "metadata": {
+                    "type": "string",
+                },
+                "text_embedding": {
+                    "type": "vector",
+                    "index": True,
+                    "dimension": dim,
+                    "store_type": "MemoryOnly",
+                },
+            },
+        }
+        response_code = self.vearch.create_space(self.using_db_name, space_config)
+
+        return response_code
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        embeddings = None
+        if self.embedding_func is not None:
+            embeddings = self.embedding_func.embed_documents(list(texts))
+        if embeddings is None:
+            raise ValueError("embeddings is None")
+        if self.flag:
+            dbs_list = self.vearch.list_dbs()
+            if self.using_db_name not in dbs_list:
+                create_db_code = self.vearch.create_db(self.using_db_name)
+                if not create_db_code:
+                    raise ValueError("create db failed!!!")
+            space_list = self.vearch.list_spaces(self.using_db_name)
+            if self.using_table_name not in space_list:
+                create_space_code = self._create_space(len(embeddings[0]))
+                if not create_space_code:
+                    raise ValueError("create space failed!!!")
+            docid = []
+            if embeddings is not None and metadatas is not None:
+                for text, metadata, embed in zip(texts, metadatas, embeddings):
+                    profiles: dict[str, Any] = {}
+                    profiles["text"] = text
+                    profiles["metadata"] = metadata["source"]
+                    embed_np = np.array(embed)
+                    profiles["text_embedding"] = {
+                        "feature": (embed_np / np.linalg.norm(embed_np)).tolist()
+                    }
+                    insert_res = self.vearch.insert_one(
+                        self.using_db_name, self.using_table_name, profiles
+                    )
+                    if insert_res["status"] == 200:
+                        docid.append(insert_res["_id"])
+                        continue
+                    else:
+                        retry_insert = self.vearch.insert_one(
+                            self.using_db_name, self.using_table_name, profiles
+                        )
+                        docid.append(retry_insert["_id"])
+                        continue
+        else:
+            table_path = os.path.join(
+                self.using_metapath, self.using_table_name + ".schema"
+            )
+            if not os.path.exists(table_path):
+                dim = len(embeddings[0])
+                response_code = self._create_table(dim)
+                if response_code:
+                    raise ValueError("create table failed!!!")
+            if embeddings is not None and metadatas is not None:
+                doc_items = []
+                for text, metadata, embed in zip(texts, metadatas, embeddings):
+                    profiles_v: dict[str, Any] = {}
+                    profiles_v["text"] = text
+                    profiles_v["metadata"] = metadata["source"]
+                    embed_np = np.array(embed)
+                    profiles_v["text_embedding"] = embed_np / np.linalg.norm(embed_np)
+                    doc_items.append(profiles_v)
+
+                docid = self.vearch.add(doc_items)
+                t_time = 0
+                while len(docid) != len(embeddings):
+                    time.sleep(0.5)
+                    if t_time > 6:
+                        break
+                    t_time += 1
+                self.vearch.dump()
+        return docid
+
+    def _load(self) -> None:
+        """
+        load vearch engine for standalone vearch
+        """
+        self.vearch.load()
+
+    @classmethod
+    def load_local(
+        cls,
+        embedding: Embeddings,
+        path_or_url: Optional[str] = None,
+        table_name: str = _DEFAULT_TABLE_NAME,
+        db_name: str = _DEFAULT_CLUSTER_DB_NAME,
+        flag: int = _DEFAULT_VERSION,
+        **kwargs: Any,
+    ) -> Vearch:
+        """Load the local specified table of standalone vearch.
+        Returns:
+            Success or failure of loading the local specified table
+        """
+        if not path_or_url:
+            raise ValueError("No metadata path!!!")
+        if not table_name:
+            raise ValueError("No table name!!!")
+        table_path = os.path.join(path_or_url, table_name + ".schema")
+        if not os.path.exists(table_path):
+            raise ValueError("vearch vectorbase table not exist!!!")
+
+        vearch_db = cls(
+            embedding_function=embedding,
+            path_or_url=path_or_url,
+            table_name=table_name,
+            db_name=db_name,
+            flag=flag,
+        )
+        vearch_db._load()
+        return vearch_db
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = DEFAULT_TOPN,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """
+        Return docs most similar to query.
+
+        """
+        if self.embedding_func is None:
+            raise ValueError("embedding_func is None!!!")
+        embeddings = self.embedding_func.embed_query(query)
+        docs = self.similarity_search_by_vector(embeddings, k)
+        return docs
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = DEFAULT_TOPN,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """The most k similar documents and scores of the specified query.
+        Args:
+            embeddings: embedding vector of the query.
+            k: The k most similar documents to the text query.
+            min_score: the score of similar documents to the text query
+        Returns:
+            The k most similar documents to the specified text query.
+            0 is dissimilar, 1 is the most similar.
+        """
+        embed = np.array(embedding)
+        if self.flag:
+            query_data = {
+                "query": {
+                    "sum": [
+                        {
+                            "field": "text_embedding",
+                            "feature": (embed / np.linalg.norm(embed)).tolist(),
+                        }
+                    ],
+                },
+                "size": k,
+                "fields": ["text", "metadata"],
+            }
+            query_result = self.vearch.search(
+                self.using_db_name, self.using_table_name, query_data
+            )
+            res = query_result["hits"]["hits"]
+        else:
+            query_data = {
+                "vector": [
+                    {
+                        "field": "text_embedding",
+                        "feature": embed / np.linalg.norm(embed),
+                    }
+                ],
+                "fields": [],
+                "is_brute_search": 1,
+                "retrieval_param": {"metric_type": "InnerProduct", "nprobe": 20},
+                "topn": k,
+            }
+            query_result = self.vearch.search(query_data)
+            res = query_result[0]["result_items"]
+        docs = []
+        for item in res:
+            content = ""
+            meta_data = {}
+            if self.flag:
+                item = item["_source"]
+            for item_key in item:
+                if item_key == "text":
+                    content = item[item_key]
+                    continue
+                if item_key == "metadata":
+                    meta_data["source"] = item[item_key]
+                    continue
+            docs.append(Document(page_content=content, metadata=meta_data))
+        return docs
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = DEFAULT_TOPN,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """The most k similar documents and scores of the specified query.
+        Args:
+            embeddings: embedding vector of the query.
+            k: The k most similar documents to the text query.
+            min_score: the score of similar documents to the text query
+        Returns:
+            The k most similar documents to the specified text query.
+            0 is dissimilar, 1 is the most similar.
+        """
+        if self.embedding_func is None:
+            raise ValueError("embedding_func is None!!!")
+        embeddings = self.embedding_func.embed_query(query)
+        embed = np.array(embeddings)
+        if self.flag:
+            query_data = {
+                "query": {
+                    "sum": [
+                        {
+                            "field": "text_embedding",
+                            "feature": (embed / np.linalg.norm(embed)).tolist(),
+                        }
+                    ],
+                },
+                "size": k,
+                "fields": ["text_embedding", "text", "metadata"],
+            }
+            query_result = self.vearch.search(
+                self.using_db_name, self.using_table_name, query_data
+            )
+            res = query_result["hits"]["hits"]
+        else:
+            query_data = {
+                "vector": [
+                    {
+                        "field": "text_embedding",
+                        "feature": embed / np.linalg.norm(embed),
+                    }
+                ],
+                "fields": [],
+                "is_brute_search": 1,
+                "retrieval_param": {"metric_type": "InnerProduct", "nprobe": 20},
+                "topn": k,
+            }
+            query_result = self.vearch.search(query_data)
+            res = query_result[0]["result_items"]
+        results: List[Tuple[Document, float]] = []
+        for item in res:
+            content = ""
+            meta_data = {}
+            if self.flag:
+                score = item["_score"]
+                item = item["_source"]
+            for item_key in item:
+                if item_key == "text":
+                    content = item[item_key]
+                    continue
+                if item_key == "metadata":
+                    meta_data["source"] = item[item_key]
+                    continue
+                if self.flag != 1 and item_key == "score":
+                    score = item[item_key]
+                    continue
+            tmp_res = (Document(page_content=content, metadata=meta_data), score)
+            results.append(tmp_res)
+        return results
+
+    def _similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        return self.similarity_search_with_score(query, k, **kwargs)
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Optional[bool]:
+        """Delete the documents which have the specified ids.
+
+        Args:
+            ids: The ids of the embedding vectors.
+            **kwargs: Other keyword arguments that subclasses might use.
+        Returns:
+            Optional[bool]: True if deletion is successful.
+            False otherwise, None if not implemented.
+        """
+
+        ret: Optional[bool] = None
+        tmp_res = []
+        if ids is None or ids.__len__() == 0:
+            return ret
+        for _id in ids:
+            if self.flag:
+                ret = self.vearch.delete(self.using_db_name, self.using_table_name, _id)
+            else:
+                ret = self.vearch.del_doc(_id)
+            tmp_res.append(ret)
+        ret = all(i == 0 for i in tmp_res)
+        return ret
+
+    def get(
+        self,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Dict[str, Document]:
+        """Return docs according ids.
+
+        Args:
+            ids: The ids of the embedding vectors.
+        Returns:
+            Documents which satisfy the input conditions.
+        """
+
+        results: Dict[str, Document] = {}
+        if ids is None or ids.__len__() == 0:
+            return results
+        if self.flag:
+            query_data = {"query": {"ids": ids}}
+            docs_detail = self.vearch.mget_by_ids(
+                self.using_db_name, self.using_table_name, query_data
+            )
+            for record in docs_detail:
+                if record["found"] is False:
+                    continue
+                content = ""
+                meta_info = {}
+                for field in record["_source"]:
+                    if field == "text":
+                        content = record["_source"][field]
+                        continue
+                    elif field == "metadata":
+                        meta_info["source"] = record["_source"][field]
+                        continue
+                results[record["_id"]] = Document(
+                    page_content=content, metadata=meta_info
+                )
+        else:
+            for id in ids:
+                docs_detail = self.vearch.get_doc_by_id(id)
+                if docs_detail == {}:
+                    continue
+                content = ""
+                meta_info = {}
+                for field in docs_detail:
+                    if field == "text":
+                        content = docs_detail[field]
+                        continue
+                    elif field == "metadata":
+                        meta_info["source"] = docs_detail[field]
+                        continue
+                results[docs_detail["_id"]] = Document(
+                    page_content=content, metadata=meta_info
+                )
+        return results
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/vectara.py b/llm/Lib/site-packages/langchain_community/vectorstores/vectara.py
new file mode 100644
index 0000000000000000000000000000000000000000..2c66d38f84f99b55541fb1fc3c1ffc8d4161e9d6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/vectara.py
@@ -0,0 +1,608 @@
+from __future__ import annotations
+
+import json
+import logging
+import os
+from dataclasses import dataclass, field
+from hashlib import md5
+from typing import Any, Iterable, List, Optional, Tuple, Type
+
+import requests
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import Field
+from langchain_core.vectorstores import VectorStore, VectorStoreRetriever
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class SummaryConfig:
+    """Configuration for summary generation.
+
+    is_enabled: True if summary is enabled, False otherwise
+    max_results: maximum number of results to summarize
+    response_lang: requested language for the summary
+    prompt_name: name of the prompt to use for summarization
+      (see https://docs.vectara.com/docs/learn/grounded-generation/select-a-summarizer)
+    """
+
+    is_enabled: bool = False
+    max_results: int = 7
+    response_lang: str = "eng"
+    prompt_name: str = "vectara-summary-ext-v1.2.0"
+
+
+@dataclass
+class MMRConfig:
+    """Configuration for Maximal Marginal Relevance (MMR) search.
+
+    is_enabled: True if MMR is enabled, False otherwise
+    mmr_k: number of results to fetch for MMR, defaults to 50
+    diversity_bias: number between 0 and 1 that determines the degree
+        of diversity among the results with 0 corresponding
+        to minimum diversity and 1 to maximum diversity.
+        Defaults to 0.3.
+        Note: diversity_bias is equivalent 1-lambda_mult
+        where lambda_mult is the value often used in max_marginal_relevance_search()
+        We chose to use that since we believe it's more intuitive to the user.
+    """
+
+    is_enabled: bool = False
+    mmr_k: int = 50
+    diversity_bias: float = 0.3
+
+
+@dataclass
+class VectaraQueryConfig:
+    """Configuration for Vectara query.
+
+    k: Number of Documents to return. Defaults to 10.
+    lambda_val: lexical match parameter for hybrid search.
+    filter Dictionary of argument(s) to filter on metadata. For example a
+        filter can be "doc.rating > 3.0 and part.lang = 'deu'"} see
+        https://docs.vectara.com/docs/search-apis/sql/filter-overview
+        for more details.
+    score_threshold: minimal score threshold for the result.
+        If defined, results with score less than this value will be
+        filtered out.
+    n_sentence_context: number of sentences before/after the matching segment
+        to add, defaults to 2
+    mmr_config: MMRConfig configuration dataclass
+    summary_config: SummaryConfig configuration dataclass
+    """
+
+    k: int = 10
+    lambda_val: float = 0.0
+    filter: str = ""
+    score_threshold: Optional[float] = None
+    n_sentence_context: int = 2
+    mmr_config: MMRConfig = field(default_factory=MMRConfig)
+    summary_config: SummaryConfig = field(default_factory=SummaryConfig)
+
+
+class Vectara(VectorStore):
+    """`Vectara API` vector store.
+
+     See (https://vectara.com).
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import Vectara
+
+            vectorstore = Vectara(
+                vectara_customer_id=vectara_customer_id,
+                vectara_corpus_id=vectara_corpus_id,
+                vectara_api_key=vectara_api_key
+            )
+    """
+
+    def __init__(
+        self,
+        vectara_customer_id: Optional[str] = None,
+        vectara_corpus_id: Optional[str] = None,
+        vectara_api_key: Optional[str] = None,
+        vectara_api_timeout: int = 120,
+        source: str = "langchain",
+    ):
+        """Initialize with Vectara API."""
+        self._vectara_customer_id = vectara_customer_id or os.environ.get(
+            "VECTARA_CUSTOMER_ID"
+        )
+        self._vectara_corpus_id = vectara_corpus_id or os.environ.get(
+            "VECTARA_CORPUS_ID"
+        )
+        self._vectara_api_key = vectara_api_key or os.environ.get("VECTARA_API_KEY")
+        if (
+            self._vectara_customer_id is None
+            or self._vectara_corpus_id is None
+            or self._vectara_api_key is None
+        ):
+            logger.warning(
+                "Can't find Vectara credentials, customer_id or corpus_id in "
+                "environment."
+            )
+        else:
+            logger.debug(f"Using corpus id {self._vectara_corpus_id}")
+        self._source = source
+
+        self._session = requests.Session()  # to reuse connections
+        adapter = requests.adapters.HTTPAdapter(max_retries=3)
+        self._session.mount("http://", adapter)
+        self.vectara_api_timeout = vectara_api_timeout
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return None
+
+    def _get_post_headers(self) -> dict:
+        """Returns headers that should be attached to each post request."""
+        return {
+            "x-api-key": self._vectara_api_key,
+            "customer-id": self._vectara_customer_id,
+            "Content-Type": "application/json",
+            "X-Source": self._source,
+        }
+
+    def _delete_doc(self, doc_id: str) -> bool:
+        """
+        Delete a document from the Vectara corpus.
+
+        Args:
+            url (str): URL of the page to delete.
+            doc_id (str): ID of the document to delete.
+
+        Returns:
+            bool: True if deletion was successful, False otherwise.
+        """
+        body = {
+            "customer_id": self._vectara_customer_id,
+            "corpus_id": self._vectara_corpus_id,
+            "document_id": doc_id,
+        }
+        response = self._session.post(
+            "https://api.vectara.io/v1/delete-doc",
+            data=json.dumps(body),
+            verify=True,
+            headers=self._get_post_headers(),
+            timeout=self.vectara_api_timeout,
+        )
+        if response.status_code != 200:
+            logger.error(
+                f"Delete request failed for doc_id = {doc_id} with status code "
+                f"{response.status_code}, reason {response.reason}, text "
+                f"{response.text}"
+            )
+            return False
+        return True
+
+    def _index_doc(self, doc: dict, use_core_api: bool = False) -> str:
+        request: dict[str, Any] = {}
+        request["customer_id"] = self._vectara_customer_id
+        request["corpus_id"] = self._vectara_corpus_id
+        request["document"] = doc
+
+        api_endpoint = (
+            "https://api.vectara.io/v1/core/index"
+            if use_core_api
+            else "https://api.vectara.io/v1/index"
+        )
+        response = self._session.post(
+            headers=self._get_post_headers(),
+            url=api_endpoint,
+            data=json.dumps(request),
+            timeout=self.vectara_api_timeout,
+            verify=True,
+        )
+
+        status_code = response.status_code
+
+        result = response.json()
+        status_str = result["status"]["code"] if "status" in result else None
+        if status_code == 409 or status_str and (status_str == "ALREADY_EXISTS"):
+            return "E_ALREADY_EXISTS"
+        elif status_str and (status_str == "FORBIDDEN"):
+            return "E_NO_PERMISSIONS"
+        else:
+            return "E_SUCCEEDED"
+
+    def add_files(
+        self,
+        files_list: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """
+        Vectara provides a way to add documents directly via our API where
+        pre-processing and chunking occurs internally in an optimal way
+        This method provides a way to use that API in LangChain
+
+        Args:
+            files_list: Iterable of strings, each representing a local file path.
+                    Files could be text, HTML, PDF, markdown, doc/docx, ppt/pptx, etc.
+                    see API docs for full list
+            metadatas: Optional list of metadatas associated with each file
+
+        Returns:
+            List of ids associated with each of the files indexed
+        """
+        doc_ids = []
+        for inx, file in enumerate(files_list):
+            if not os.path.exists(file):
+                logger.error(f"File {file} does not exist, skipping")
+                continue
+            md = metadatas[inx] if metadatas else {}
+            files: dict = {
+                "file": (file, open(file, "rb")),
+                "doc_metadata": json.dumps(md),
+            }
+            headers = self._get_post_headers()
+            headers.pop("Content-Type")
+            response = self._session.post(
+                f"https://api.vectara.io/upload?c={self._vectara_customer_id}&o={self._vectara_corpus_id}&d=True",
+                files=files,
+                verify=True,
+                headers=headers,
+                timeout=self.vectara_api_timeout,
+            )
+
+            if response.status_code == 409:
+                doc_id = response.json()["document"]["documentId"]
+                logger.info(
+                    f"File {file} already exists on Vectara (doc_id={doc_id}), skipping"
+                )
+            elif response.status_code == 200:
+                doc_id = response.json()["document"]["documentId"]
+                doc_ids.append(doc_id)
+            else:
+                logger.info(f"Error indexing file {file}: {response.json()}")
+
+        return doc_ids
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        doc_metadata: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            doc_metadata: optional metadata for the document
+
+        This function indexes all the input text strings in the Vectara corpus as a
+        single Vectara document, where each input text is considered a "section" and the
+        metadata are associated with each section.
+        if 'doc_metadata' is provided, it is associated with the Vectara document.
+
+        Returns:
+            document ID of the document added
+
+        """
+        doc_hash = md5()
+        for t in texts:
+            doc_hash.update(t.encode())
+        doc_id = doc_hash.hexdigest()
+        if metadatas is None:
+            metadatas = [{} for _ in texts]
+        if doc_metadata:
+            doc_metadata["source"] = "langchain"
+        else:
+            doc_metadata = {"source": "langchain"}
+
+        use_core_api = kwargs.get("use_core_api", False)
+        section_key = "parts" if use_core_api else "section"
+        doc = {
+            "document_id": doc_id,
+            "metadataJson": json.dumps(doc_metadata),
+            section_key: [
+                {"text": text, "metadataJson": json.dumps(md)}
+                for text, md in zip(texts, metadatas)
+            ],
+        }
+
+        success_str = self._index_doc(doc, use_core_api=use_core_api)
+
+        if success_str == "E_ALREADY_EXISTS":
+            self._delete_doc(doc_id)
+            self._index_doc(doc)
+        elif success_str == "E_NO_PERMISSIONS":
+            print(  # noqa: T201
+                """No permissions to add document to Vectara. 
+                Check your corpus ID, customer ID and API key"""
+            )
+        return [doc_id]
+
+    def vectara_query(
+        self,
+        query: str,
+        config: VectaraQueryConfig,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Run a Vectara query
+
+        Args:
+            query: Text to look up documents similar to.
+            config: VectaraQueryConfig object
+        Returns:
+            A list of k Documents matching the given query
+            If summary is enabled, last document is the summary text with 'summary'=True
+        """
+        if isinstance(config.mmr_config, dict):
+            config.mmr_config = MMRConfig(**config.mmr_config)
+        if isinstance(config.summary_config, dict):
+            config.summary_config = SummaryConfig(**config.summary_config)
+
+        data = {
+            "query": [
+                {
+                    "query": query,
+                    "start": 0,
+                    "numResults": (
+                        config.mmr_config.mmr_k
+                        if config.mmr_config.is_enabled
+                        else config.k
+                    ),
+                    "contextConfig": {
+                        "sentencesBefore": config.n_sentence_context,
+                        "sentencesAfter": config.n_sentence_context,
+                    },
+                    "corpusKey": [
+                        {
+                            "customerId": self._vectara_customer_id,
+                            "corpusId": self._vectara_corpus_id,
+                            "metadataFilter": config.filter,
+                            "lexicalInterpolationConfig": {"lambda": config.lambda_val},
+                        }
+                    ],
+                }
+            ]
+        }
+        if config.mmr_config.is_enabled:
+            data["query"][0]["rerankingConfig"] = {
+                "rerankerId": 272725718,
+                "mmrConfig": {"diversityBias": config.mmr_config.diversity_bias},
+            }
+        if config.summary_config.is_enabled:
+            data["query"][0]["summary"] = [
+                {
+                    "maxSummarizedResults": config.summary_config.max_results,
+                    "responseLang": config.summary_config.response_lang,
+                    "summarizerPromptName": config.summary_config.prompt_name,
+                }
+            ]
+
+        response = self._session.post(
+            headers=self._get_post_headers(),
+            url="https://api.vectara.io/v1/query",
+            data=json.dumps(data),
+            timeout=self.vectara_api_timeout,
+        )
+
+        if response.status_code != 200:
+            logger.error(
+                "Query failed %s",
+                f"(code {response.status_code}, reason {response.reason}, details "
+                f"{response.text})",
+            )
+            return [], ""  # type: ignore[return-value]
+
+        result = response.json()
+
+        if config.score_threshold:
+            responses = [
+                r
+                for r in result["responseSet"][0]["response"]
+                if r["score"] > config.score_threshold
+            ]
+        else:
+            responses = result["responseSet"][0]["response"]
+        documents = result["responseSet"][0]["document"]
+
+        metadatas = []
+        for x in responses:
+            md = {m["name"]: m["value"] for m in x["metadata"]}
+            doc_num = x["documentIndex"]
+            doc_md = {m["name"]: m["value"] for m in documents[doc_num]["metadata"]}
+            if "source" not in doc_md:
+                doc_md["source"] = "vectara"
+            md.update(doc_md)
+            metadatas.append(md)
+
+        res = [
+            (
+                Document(
+                    page_content=x["text"],
+                    metadata=md,
+                ),
+                x["score"],
+            )
+            for x, md in zip(responses, metadatas)
+        ]
+
+        if config.mmr_config.is_enabled:
+            res = res[: config.k]
+        if config.summary_config.is_enabled:
+            summary = result["responseSet"][0]["summary"][0]["text"]
+            res.append(
+                (Document(page_content=summary, metadata={"summary": True}), 0.0)
+            )
+
+        return res
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return Vectara documents most similar to query, along with scores.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 10.
+            any other querying variable in VectaraQueryConfig like:
+            - lambda_val: lexical match parameter for hybrid search.
+            - filter: filter string
+            - score_threshold: minimal score threshold for the result.
+            - n_sentence_context: number of sentences before/after the matching segment
+            - mmr_config: optional configuration for MMR (see MMRConfig dataclass)
+            - summary_config: optional configuration for summary
+              (see SummaryConfig dataclass)
+        Returns:
+            List of Documents most similar to the query and score for each.
+        """
+        config = VectaraQueryConfig(**kwargs)
+        docs = self.vectara_query(query, config)
+        return docs
+
+    def similarity_search(  # type: ignore[override]
+        self,
+        query: str,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return Vectara documents most similar to query, along with scores.
+
+        Args:
+            query: Text to look up documents similar to.
+            any other querying variable in VectaraQueryConfig
+
+        Returns:
+            List of Documents most similar to the query
+        """
+        docs_and_scores = self.similarity_search_with_score(
+            query,
+            **kwargs,
+        )
+        return [doc for doc, _ in docs_and_scores]
+
+    def max_marginal_relevance_search(  # type: ignore[override]
+        self,
+        query: str,
+        fetch_k: int = 50,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 5.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+                     Defaults to 50
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            kwargs: any other querying variable in VectaraQueryConfig
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        kwargs["mmr_config"] = MMRConfig(
+            is_enabled=True, mmr_k=fetch_k, diversity_bias=1 - lambda_mult
+        )
+        return self.similarity_search(query, **kwargs)
+
+    @classmethod
+    def from_texts(
+        cls: Type[Vectara],
+        texts: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> Vectara:
+        """Construct Vectara wrapper from raw documents.
+        This is intended to be a quick way to get started.
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import Vectara
+                vectara = Vectara.from_texts(
+                    texts,
+                    vectara_customer_id=customer_id,
+                    vectara_corpus_id=corpus_id,
+                    vectara_api_key=api_key,
+                )
+        """
+        # Notes:
+        # * Vectara generates its own embeddings, so we ignore the provided
+        #   embeddings (required by interface)
+        # * when metadatas[] are provided they are associated with each "part"
+        #   in Vectara. doc_metadata can be used to provide additional metadata
+        #   for the document itself (applies to all "texts" in this call)
+        doc_metadata = kwargs.pop("doc_metadata", {})
+        vectara = cls(**kwargs)
+        vectara.add_texts(texts, metadatas, doc_metadata=doc_metadata, **kwargs)
+        return vectara
+
+    @classmethod
+    def from_files(
+        cls: Type[Vectara],
+        files: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> Vectara:
+        """Construct Vectara wrapper from raw documents.
+        This is intended to be a quick way to get started.
+        Example:
+            .. code-block:: python
+
+                from langchain_community.vectorstores import Vectara
+                vectara = Vectara.from_files(
+                    files_list,
+                    vectara_customer_id=customer_id,
+                    vectara_corpus_id=corpus_id,
+                    vectara_api_key=api_key,
+                )
+        """
+        # Note: Vectara generates its own embeddings, so we ignore the provided
+        # embeddings (required by interface)
+        vectara = cls(**kwargs)
+        vectara.add_files(files, metadatas)
+        return vectara
+
+
+class VectaraRetriever(VectorStoreRetriever):
+    """Retriever for `Vectara`."""
+
+    vectorstore: Vectara
+    """Vectara vectorstore."""
+    search_kwargs: dict = Field(
+        default_factory=lambda: {
+            "lambda_val": 0.0,
+            "k": 5,
+            "filter": "",
+            "n_sentence_context": "2",
+            "summary_config": SummaryConfig(),
+        }
+    )
+
+    """Search params.
+        k: Number of Documents to return. Defaults to 5.
+        lambda_val: lexical match parameter for hybrid search.
+        filter: Dictionary of argument(s) to filter on metadata. For example a
+            filter can be "doc.rating > 3.0 and part.lang = 'deu'"} see
+            https://docs.vectara.com/docs/search-apis/sql/filter-overview
+            for more details.
+        n_sentence_context: number of sentences before/after the matching segment to add
+    """
+
+    def add_texts(
+        self,
+        texts: List[str],
+        metadatas: Optional[List[dict]] = None,
+        doc_metadata: Optional[dict] = None,
+    ) -> None:
+        """Add text to the Vectara vectorstore.
+
+        Args:
+            texts (List[str]): The text
+            metadatas (List[dict]): Metadata dicts, must line up with existing store
+        """
+        self.vectorstore.add_texts(texts, metadatas, doc_metadata or {})
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/vespa.py b/llm/Lib/site-packages/langchain_community/vectorstores/vespa.py
new file mode 100644
index 0000000000000000000000000000000000000000..6fe6585cd86bea0432aa48f2eeb7f9a1f9edca8e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/vespa.py
@@ -0,0 +1,267 @@
+from __future__ import annotations
+
+from typing import Any, Dict, Iterable, List, Optional, Tuple, Type, Union
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore, VectorStoreRetriever
+
+
+class VespaStore(VectorStore):
+    """
+    `Vespa` vector store.
+
+    To use, you should have the python client library ``pyvespa`` installed.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_community.vectorstores import VespaStore
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+            from vespa.application import Vespa
+
+            # Create a vespa client dependent upon your application,
+            # e.g. either connecting to Vespa Cloud or a local deployment
+            # such as Docker. Please refer to the PyVespa documentation on
+            # how to initialize the client.
+
+            vespa_app = Vespa(url="...", port=..., application_package=...)
+
+            # You need to instruct LangChain on which fields to use for embeddings
+            vespa_config = dict(
+                page_content_field="text",
+                embedding_field="embedding",
+                input_field="query_embedding",
+                metadata_fields=["date", "rating", "author"]
+            )
+
+            embedding_function = OpenAIEmbeddings()
+            vectorstore = VespaStore(vespa_app, embedding_function, **vespa_config)
+
+    """
+
+    def __init__(
+        self,
+        app: Any,
+        embedding_function: Optional[Embeddings] = None,
+        page_content_field: Optional[str] = None,
+        embedding_field: Optional[str] = None,
+        input_field: Optional[str] = None,
+        metadata_fields: Optional[List[str]] = None,
+    ) -> None:
+        """
+        Initialize with a PyVespa client.
+        """
+        try:
+            from vespa.application import Vespa
+        except ImportError:
+            raise ImportError(
+                "Could not import Vespa python package. "
+                "Please install it with `pip install pyvespa`."
+            )
+        if not isinstance(app, Vespa):
+            raise ValueError(
+                f"app should be an instance of vespa.application.Vespa, got {type(app)}"
+            )
+
+        self._vespa_app = app
+        self._embedding_function = embedding_function
+        self._page_content_field = page_content_field
+        self._embedding_field = embedding_field
+        self._input_field = input_field
+        self._metadata_fields = metadata_fields
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """
+        Add texts to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            ids: Optional list of ids associated with the texts.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+
+        embeddings = None
+        if self._embedding_function is not None:
+            embeddings = self._embedding_function.embed_documents(list(texts))
+
+        if ids is None:
+            ids = [str(f"{i+1}") for i, _ in enumerate(texts)]
+
+        batch = []
+        for i, text in enumerate(texts):
+            fields: Dict[str, Union[str, List[float]]] = {}
+            if self._page_content_field is not None:
+                fields[self._page_content_field] = text
+            if self._embedding_field is not None and embeddings is not None:
+                fields[self._embedding_field] = embeddings[i]
+            if metadatas is not None and self._metadata_fields is not None:
+                for metadata_field in self._metadata_fields:
+                    if metadata_field in metadatas[i]:
+                        fields[metadata_field] = metadatas[i][metadata_field]
+            batch.append({"id": ids[i], "fields": fields})
+
+        results = self._vespa_app.feed_batch(batch)
+        for result in results:
+            if not (str(result.status_code).startswith("2")):
+                raise RuntimeError(
+                    f"Could not add document to Vespa. "
+                    f"Error code: {result.status_code}. "
+                    f"Message: {result.json['message']}"
+                )
+        return ids
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        if ids is None:
+            return False
+        batch = [{"id": id} for id in ids]
+        result = self._vespa_app.delete_batch(batch)
+        return sum([0 if r.status_code == 200 else 1 for r in result]) == 0
+
+    def _create_query(
+        self, query_embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> Dict:
+        hits = k
+        doc_embedding_field = self._embedding_field
+        input_embedding_field = self._input_field
+        ranking_function = kwargs["ranking"] if "ranking" in kwargs else "default"
+        filter = kwargs["filter"] if "filter" in kwargs else None
+
+        approximate = kwargs["approximate"] if "approximate" in kwargs else False
+        approximate = "true" if approximate else "false"
+
+        yql = "select * from sources * where "
+        yql += f"{{targetHits: {hits}, approximate: {approximate}}}"
+        yql += f"nearestNeighbor({doc_embedding_field}, {input_embedding_field})"
+        if filter is not None:
+            yql += f" and {filter}"
+
+        query = {
+            "yql": yql,
+            f"input.query({input_embedding_field})": query_embedding,
+            "ranking": ranking_function,
+            "hits": hits,
+        }
+        return query
+
+    def similarity_search_by_vector_with_score(
+        self, query_embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """
+        Performs similarity search from a embeddings vector.
+
+        Args:
+            query_embedding: Embeddings vector to search for.
+            k: Number of results to return.
+            custom_query: Use this custom query instead default query (kwargs)
+            kwargs: other vector store specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        if "custom_query" in kwargs:
+            query = kwargs["custom_query"]
+        else:
+            query = self._create_query(query_embedding, k, **kwargs)
+
+        try:
+            response = self._vespa_app.query(body=query)
+        except Exception as e:
+            raise RuntimeError(
+                f"Could not retrieve data from Vespa: "
+                f"{e.args[0][0]['summary']}. "
+                f"Error: {e.args[0][0]['message']}"
+            )
+        if not str(response.status_code).startswith("2"):
+            raise RuntimeError(
+                f"Could not retrieve data from Vespa. "
+                f"Error code: {response.status_code}. "
+                f"Message: {response.json['message']}"
+            )
+
+        root = response.json["root"]
+        if "errors" in root:
+            import json
+
+            raise RuntimeError(json.dumps(root["errors"]))
+
+        if response is None or response.hits is None:
+            return []
+
+        docs = []
+        for child in response.hits:
+            page_content = child["fields"][self._page_content_field]
+            score = child["relevance"]
+            metadata = {"id": child["id"]}
+            if self._metadata_fields is not None:
+                for field in self._metadata_fields:
+                    metadata[field] = child["fields"].get(field)
+            doc = Document(page_content=page_content, metadata=metadata)
+            docs.append((doc, score))
+        return docs
+
+    def similarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        results = self.similarity_search_by_vector_with_score(embedding, k, **kwargs)
+        return [r[0] for r in results]
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        query_emb = []
+        if self._embedding_function is not None:
+            query_emb = self._embedding_function.embed_query(query)
+        return self.similarity_search_by_vector_with_score(query_emb, k, **kwargs)
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        results = self.similarity_search_with_score(query, k, **kwargs)
+        return [r[0] for r in results]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        raise NotImplementedError("MMR search not implemented")
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        raise NotImplementedError("MMR search by vector not implemented")
+
+    @classmethod
+    def from_texts(
+        cls: Type[VespaStore],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> VespaStore:
+        vespa = cls(embedding_function=embedding, **kwargs)
+        vespa.add_texts(texts=texts, metadatas=metadatas, ids=ids)
+        return vespa
+
+    def as_retriever(self, **kwargs: Any) -> VectorStoreRetriever:
+        return super().as_retriever(**kwargs)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/vikingdb.py b/llm/Lib/site-packages/langchain_community/vectorstores/vikingdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..768971234e67ef6312d88f6622670e7b08876d6f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/vikingdb.py
@@ -0,0 +1,416 @@
+from __future__ import annotations
+
+import logging
+import uuid
+from typing import Any, List, Optional, Tuple
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+logger = logging.getLogger(__name__)
+
+
+class VikingDBConfig(object):
+    """vikingdb connection config
+
+    See the following documentation for details:
+    https://www.volcengine.com/docs/6459/1167770
+
+    Attribute:
+        host(str):The access address of the vector database server
+            that the client needs to connect to.
+        region(str):"cn-shanghai" or "cn-beijing"
+        ak(str):Access Key ID, security credentials for accessing
+            Volcano Engine services.
+        sk(str):Secret Access Key, security credentials for accessing
+            Volcano Engine services.
+        scheme(str):http or https, defaulting to http.
+    """
+
+    def __init__(self, host="host", region="region", ak="ak", sk="sk", scheme="http"):  # type: ignore[no-untyped-def]
+        self.host = host
+        self.region = region
+        self.ak = ak
+        self.sk = sk
+        self.scheme = scheme
+
+
+class VikingDB(VectorStore):
+    """vikingdb as a vector store
+
+    In order to use this you need to have a database instance.
+    See the following documentation for details:
+    https://www.volcengine.com/docs/6459/1167774
+    """
+
+    def __init__(
+        self,
+        embedding_function: Embeddings,
+        collection_name: str = "LangChainCollection",
+        connection_args: Optional[VikingDBConfig] = None,
+        index_params: Optional[dict] = None,
+        drop_old: Optional[bool] = False,
+        **kwargs: Any,
+    ):
+        try:
+            from volcengine.viking_db import Collection, VikingDBService
+        except ImportError:
+            raise ValueError(
+                "Could not import volcengine python package. "
+                "Please install it with `pip install --upgrade volcengine`."
+            )
+        self.embedding_func = embedding_function
+        self.collection_name = collection_name
+        self.index_name = "LangChainIndex"
+        self.connection_args = connection_args
+        self.index_params = index_params
+        self.drop_old = drop_old
+        self.service = VikingDBService(
+            connection_args.host,  # type: ignore[union-attr]
+            connection_args.region,  # type: ignore[union-attr]
+            connection_args.ak,  # type: ignore[union-attr]
+            connection_args.sk,  # type: ignore[union-attr]
+            connection_args.scheme,  # type: ignore[union-attr]
+        )
+
+        try:
+            col = self.service.get_collection(collection_name)
+        except Exception:
+            col = None
+        self.collection = col
+        self.index = None
+        if self.collection is not None:
+            self.index = self.service.get_index(self.collection_name, self.index_name)
+
+        if drop_old and isinstance(self.collection, Collection):
+            indexes = self.service.list_indexes(collection_name)
+            for index in indexes:
+                self.service.drop_index(collection_name, index.index_name)
+            self.service.drop_collection(collection_name)
+            self.collection = None
+            self.index = None
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self.embedding_func
+
+    def _create_collection(
+        self, embeddings: List, metadatas: Optional[List[dict]] = None
+    ) -> None:
+        try:
+            from volcengine.viking_db import Field, FieldType
+        except ImportError:
+            raise ValueError(
+                "Could not import volcengine python package. "
+                "Please install it with `pip install --upgrade volcengine`."
+            )
+        dim = len(embeddings[0])
+        fields = []
+        if metadatas:
+            for key, value in metadatas[0].items():
+                # print(key, value)
+                if isinstance(value, str):
+                    fields.append(Field(key, FieldType.String))
+                if isinstance(value, int):
+                    fields.append(Field(key, FieldType.Int64))
+                if isinstance(value, bool):
+                    fields.append(Field(key, FieldType.Bool))
+                if isinstance(value, list) and all(
+                    isinstance(item, str) for item in value
+                ):
+                    fields.append(Field(key, FieldType.List_String))
+                if isinstance(value, list) and all(
+                    isinstance(item, int) for item in value
+                ):
+                    fields.append(Field(key, FieldType.List_Int64))
+        fields.append(Field("text", FieldType.String))
+
+        fields.append(Field("primary_key", FieldType.String, is_primary_key=True))
+
+        fields.append(Field("vector", FieldType.Vector, dim=dim))
+
+        self.collection = self.service.create_collection(self.collection_name, fields)
+
+    def _create_index(self) -> None:
+        try:
+            from volcengine.viking_db import VectorIndexParams
+        except ImportError:
+            raise ValueError(
+                "Could not import volcengine python package. "
+                "Please install it with `pip install --upgrade volcengine`."
+            )
+        cpu_quota = 2
+        vector_index = VectorIndexParams()
+        partition_by = ""
+        scalar_index = None
+        if self.index_params is not None:
+            if self.index_params.get("cpu_quota") is not None:
+                cpu_quota = self.index_params["cpu_quota"]
+            if self.index_params.get("vector_index") is not None:
+                vector_index = self.index_params["vector_index"]
+            if self.index_params.get("partition_by") is not None:
+                partition_by = self.index_params["partition_by"]
+            if self.index_params.get("scalar_index") is not None:
+                scalar_index = self.index_params["scalar_index"]
+
+        self.index = self.service.create_index(
+            self.collection_name,
+            self.index_name,
+            vector_index=vector_index,
+            cpu_quota=cpu_quota,
+            partition_by=partition_by,
+            scalar_index=scalar_index,
+        )
+
+    def add_texts(  # type: ignore[override]
+        self,
+        texts: List[str],
+        metadatas: Optional[List[dict]] = None,
+        batch_size: int = 1000,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Insert text data into VikingDB."""
+        try:
+            from volcengine.viking_db import Data
+        except ImportError:
+            raise ValueError(
+                "Could not import volcengine python package. "
+                "Please install it with `pip install --upgrade volcengine`."
+            )
+        texts = list(texts)
+        try:
+            embeddings = self.embedding_func.embed_documents(texts)
+        except NotImplementedError:
+            embeddings = [self.embedding_func.embed_query(x) for x in texts]
+        if len(embeddings) == 0:
+            logger.debug("Nothing to insert, skipping.")
+            return []
+        if self.collection is None:
+            self._create_collection(embeddings, metadatas)
+            self._create_index()
+
+        # insert data
+        data = []
+        pks: List[str] = []
+        for index in range(len(embeddings)):
+            primary_key = str(uuid.uuid4())
+            pks.append(primary_key)
+            field = {
+                "text": texts[index],
+                "primary_key": primary_key,
+                "vector": embeddings[index],
+            }
+            if metadatas is not None and index < len(metadatas):
+                names = list(metadatas[index].keys())
+                for name in names:
+                    field[name] = metadatas[index].get(name)  # type: ignore[assignment]
+            data.append(Data(field))
+
+        total_count = len(data)
+        for i in range(0, total_count, batch_size):
+            end = min(i + batch_size, total_count)
+            insert_data = data[i:end]
+            # print(insert_data)
+            self.collection.upsert_data(insert_data)  # type: ignore[union-attr]
+        return pks
+
+    def similarity_search(  # type: ignore[override]
+        self,
+        query: str,
+        params: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a similarity search against the query string."""
+        res = self.similarity_search_with_score(query=query, params=params, **kwargs)
+        return [doc for doc, _ in res]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        params: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Perform a search on a query string and return results with score."""
+        embedding = self.embedding_func.embed_query(query)
+
+        res = self.similarity_search_with_score_by_vector(
+            embedding=embedding, params=params, **kwargs
+        )
+        return res
+
+    def similarity_search_by_vector(  # type: ignore[override]
+        self,
+        embedding: List[float],
+        params: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a similarity search against the query string."""
+        res = self.similarity_search_with_score_by_vector(
+            embedding=embedding, params=params, **kwargs
+        )
+        return [doc for doc, _ in res]
+
+    def similarity_search_with_score_by_vector(
+        self,
+        embedding: List[float],
+        params: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Perform a search on a query string and return results with score."""
+        if self.collection is None:
+            logger.debug("No existing collection to search.")
+            return []
+
+        filter = None
+        limit = 10
+        output_fields = None
+        partition = "default"
+        if params is not None:
+            if params.get("filter") is not None:
+                filter = params["filter"]
+            if params.get("limit") is not None:
+                limit = params["limit"]
+            if params.get("output_fields") is not None:
+                output_fields = params["output_fields"]
+            if params.get("partition") is not None:
+                partition = params["partition"]
+
+        res = self.index.search_by_vector(  # type: ignore[union-attr]
+            embedding,
+            filter=filter,
+            limit=limit,
+            output_fields=output_fields,
+            partition=partition,
+        )
+
+        ret = []
+        for item in res:
+            if "primary_key" in item.fields:
+                item.fields.pop("primary_key")
+            if "vector" in item.fields:
+                item.fields.pop("vector")
+            page_content = ""
+            if "text" in item.fields:
+                page_content = item.fields.pop("text")
+            doc = Document(page_content=page_content, metadata=item.fields)
+            pair = (doc, item.score)
+            ret.append(pair)
+        return ret
+
+    def max_marginal_relevance_search(  # type: ignore[override]
+        self,
+        query: str,
+        k: int = 4,
+        lambda_mult: float = 0.5,
+        params: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a search and return results that are reordered by MMR."""
+        embedding = self.embedding_func.embed_query(query)
+        return self.max_marginal_relevance_search_by_vector(
+            embedding=embedding,
+            k=k,
+            lambda_mult=lambda_mult,
+            params=params,
+            **kwargs,
+        )
+
+    def max_marginal_relevance_search_by_vector(  # type: ignore[override]
+        self,
+        embedding: List[float],
+        k: int = 4,
+        lambda_mult: float = 0.5,
+        params: Optional[dict] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Perform a search and return results that are reordered by MMR."""
+        if self.collection is None:
+            logger.debug("No existing collection to search.")
+            return []
+        filter = None
+        limit = 10
+        output_fields = None
+        partition = "default"
+        if params is not None:
+            if params.get("filter") is not None:
+                filter = params["filter"]
+            if params.get("limit") is not None:
+                limit = params["limit"]
+            if params.get("output_fields") is not None:
+                output_fields = params["output_fields"]
+            if params.get("partition") is not None:
+                partition = params["partition"]
+
+        res = self.index.search_by_vector(  # type: ignore[union-attr]
+            embedding,
+            filter=filter,
+            limit=limit,
+            output_fields=output_fields,
+            partition=partition,
+        )
+        documents = []
+        ordered_result_embeddings = []
+        for item in res:
+            if (
+                "vector" not in item.fields
+                or "primary_key" not in item.fields
+                or "text" not in item.fields
+            ):
+                continue
+            ordered_result_embeddings.append(item.fields.pop("vector"))
+            item.fields.pop("primary_key")
+            page_content = item.fields.pop("text")
+            doc = Document(page_content=page_content, metadata=item.fields)
+            documents.append(doc)
+
+        new_ordering = maximal_marginal_relevance(
+            np.array(embedding), ordered_result_embeddings, k=k, lambda_mult=lambda_mult
+        )
+        # Reorder the values and return.
+        ret = []
+        for x in new_ordering:
+            # Function can return -1 index
+            if x == -1:
+                break
+            else:
+                ret.append(documents[x])
+        return ret
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        if self.collection is None:
+            logger.debug("No existing collection to search.")
+        self.collection.delete_data(ids)  # type: ignore[union-attr]
+
+    @classmethod
+    def from_texts(  # type: ignore[no-untyped-def, override]
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        connection_args: Optional[VikingDBConfig] = None,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = "LangChainCollection",
+        index_params: Optional[dict] = None,
+        drop_old: bool = False,
+        **kwargs: Any,
+    ):
+        """Create a collection, indexes it and insert data."""
+        if connection_args is None:
+            raise Exception("VikingDBConfig does not exists")
+        vector_db = cls(
+            embedding_function=embedding,
+            collection_name=collection_name,
+            connection_args=connection_args,
+            index_params=index_params,
+            drop_old=drop_old,
+            **kwargs,
+        )
+        vector_db.add_texts(texts=texts, metadatas=metadatas)
+        return vector_db
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/vlite.py b/llm/Lib/site-packages/langchain_community/vectorstores/vlite.py
new file mode 100644
index 0000000000000000000000000000000000000000..41a790ff163ebb13f1950e81f4d2172bae80bce7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/vlite.py
@@ -0,0 +1,247 @@
+from __future__ import annotations
+
+# Standard library imports
+from typing import Any, Dict, Iterable, List, Optional, Tuple
+from uuid import uuid4
+
+# LangChain imports
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+
+class VLite(VectorStore):
+    """VLite is a simple and fast vector database for semantic search."""
+
+    def __init__(
+        self,
+        embedding_function: Embeddings,
+        collection: Optional[str] = None,
+        **kwargs: Any,
+    ):
+        super().__init__()
+        self.embedding_function = embedding_function
+        self.collection = collection or f"vlite_{uuid4().hex}"
+        # Third-party imports
+        try:
+            from vlite import VLite
+        except ImportError:
+            raise ImportError(
+                "Could not import vlite python package. "
+                "Please install it with `pip install vlite`."
+            )
+        self.vlite = VLite(collection=self.collection, **kwargs)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        texts = list(texts)
+        ids = kwargs.pop("ids", [str(uuid4()) for _ in texts])
+        embeddings = self.embedding_function.embed_documents(texts)
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+        data_points = [
+            {"text": text, "metadata": metadata, "id": id, "embedding": embedding}
+            for text, metadata, id, embedding in zip(texts, metadatas, ids, embeddings)
+        ]
+        results = self.vlite.add(data_points)
+        return [result[0] for result in results]
+
+    def add_documents(
+        self,
+        documents: List[Document],
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add a list of documents to the vectorstore.
+
+        Args:
+            documents: List of documents to add to the vectorstore.
+            kwargs: vectorstore specific parameters such as "file_path" for processing
+                    directly with vlite.
+
+        Returns:
+            List of ids from adding the documents into the vectorstore.
+        """
+        ids = kwargs.pop("ids", [str(uuid4()) for _ in documents])
+        texts = []
+        metadatas = []
+        for doc, id in zip(documents, ids):
+            if "file_path" in kwargs:
+                # Third-party imports
+                try:
+                    from vlite.utils import process_file
+                except ImportError:
+                    raise ImportError(
+                        "Could not import vlite python package. "
+                        "Please install it with `pip install vlite`."
+                    )
+                processed_data = process_file(kwargs["file_path"])
+                texts.extend(processed_data)
+                metadatas.extend([doc.metadata] * len(processed_data))
+                ids.extend([f"{id}_{i}" for i in range(len(processed_data))])
+            else:
+                texts.append(doc.page_content)
+                metadatas.append(doc.metadata)
+        return self.add_texts(texts, metadatas, ids=ids)
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        docs_and_scores = self.similarity_search_with_score(query, k=k)
+        return [doc for doc, _ in docs_and_scores]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        filter: Optional[Dict[str, str]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            filter: Filter by metadata. Defaults to None.
+
+        Returns:
+            List of Tuples of (doc, score), where score is the similarity score.
+        """
+        metadata = filter or {}
+        embedding = self.embedding_function.embed_query(query)
+        results = self.vlite.retrieve(
+            text=query,
+            top_k=k,
+            metadata=metadata,
+            return_scores=True,
+            embedding=embedding,
+        )
+        documents_with_scores = [
+            (Document(page_content=text, metadata=metadata), score)
+            for text, score, metadata in results
+        ]
+        return documents_with_scores
+
+    def update_document(self, document_id: str, document: Document) -> None:
+        """Update an existing document in the vectorstore."""
+        self.vlite.update(
+            document_id, text=document.page_content, metadata=document.metadata
+        )
+
+    def get(self, ids: List[str]) -> List[Document]:
+        """Get documents by their IDs."""
+        results = self.vlite.get(ids)
+        documents = [
+            Document(page_content=text, metadata=metadata) for text, metadata in results
+        ]
+        return documents
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        """Delete by ids."""
+        if ids is not None:
+            self.vlite.delete(ids, **kwargs)
+            return True
+        return None
+
+    @classmethod
+    def from_existing_index(
+        cls,
+        embedding: Embeddings,
+        collection: str,
+        **kwargs: Any,
+    ) -> VLite:
+        """Load an existing VLite index.
+
+        Args:
+            embedding: Embedding function
+            collection: Name of the collection to load.
+
+        Returns:
+            VLite vector store.
+        """
+        vlite = cls(embedding_function=embedding, collection=collection, **kwargs)
+        return vlite
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection: Optional[str] = None,
+        **kwargs: Any,
+    ) -> VLite:
+        """Construct VLite wrapper from raw documents.
+
+        This is a user-friendly interface that:
+        1. Embeds documents.
+        2. Adds the documents to the vectorstore.
+
+        This is intended to be a quick way to get started.
+
+        Example:
+        .. code-block:: python
+
+            from langchain import VLite
+            from langchain.embeddings import OpenAIEmbeddings
+
+            embeddings = OpenAIEmbeddings()
+            vlite = VLite.from_texts(texts, embeddings)
+        """
+        vlite = cls(embedding_function=embedding, collection=collection, **kwargs)
+        vlite.add_texts(texts, metadatas, **kwargs)
+        return vlite
+
+    @classmethod
+    def from_documents(
+        cls,
+        documents: List[Document],
+        embedding: Embeddings,
+        collection: Optional[str] = None,
+        **kwargs: Any,
+    ) -> VLite:
+        """Construct VLite wrapper from a list of documents.
+
+        This is a user-friendly interface that:
+        1. Embeds documents.
+        2. Adds the documents to the vectorstore.
+
+        This is intended to be a quick way to get started.
+
+        Example:
+        .. code-block:: python
+
+            from langchain import VLite
+            from langchain.embeddings import OpenAIEmbeddings
+
+            embeddings = OpenAIEmbeddings()
+            vlite = VLite.from_documents(documents, embeddings)
+        """
+        vlite = cls(embedding_function=embedding, collection=collection, **kwargs)
+        vlite.add_documents(documents, **kwargs)
+        return vlite
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/weaviate.py b/llm/Lib/site-packages/langchain_community/vectorstores/weaviate.py
new file mode 100644
index 0000000000000000000000000000000000000000..8d4e6e472b9990de7b6601e467e6dfe739e86310
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/weaviate.py
@@ -0,0 +1,528 @@
+from __future__ import annotations
+
+import datetime
+import os
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+)
+from uuid import uuid4
+
+import numpy as np
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.vectorstores.utils import maximal_marginal_relevance
+
+if TYPE_CHECKING:
+    import weaviate
+
+
+def _default_schema(index_name: str, text_key: str) -> Dict:
+    return {
+        "class": index_name,
+        "properties": [
+            {
+                "name": text_key,
+                "dataType": ["text"],
+            }
+        ],
+    }
+
+
+def _create_weaviate_client(
+    url: Optional[str] = None,
+    api_key: Optional[str] = None,
+    **kwargs: Any,
+) -> weaviate.Client:
+    try:
+        import weaviate
+    except ImportError:
+        raise ImportError(
+            "Could not import weaviate python  package. "
+            "Please install it with `pip install weaviate-client`"
+        )
+    url = url or os.environ.get("WEAVIATE_URL")
+    api_key = api_key or os.environ.get("WEAVIATE_API_KEY")
+    auth = weaviate.auth.AuthApiKey(api_key=api_key) if api_key else None
+    return weaviate.Client(url=url, auth_client_secret=auth, **kwargs)
+
+
+def _default_score_normalizer(val: float) -> float:
+    return 1 - 1 / (1 + np.exp(val))
+
+
+def _json_serializable(value: Any) -> Any:
+    if isinstance(value, datetime.datetime):
+        return value.isoformat()
+    return value
+
+
+class Weaviate(VectorStore):
+    """`Weaviate` vector store.
+
+    To use, you should have the ``weaviate-client`` python package installed.
+
+    Example:
+        .. code-block:: python
+
+            import weaviate
+            from langchain_community.vectorstores import Weaviate
+
+            client = weaviate.Client(url=os.environ["WEAVIATE_URL"], ...)
+            weaviate = Weaviate(client, index_name, text_key)
+
+    """
+
+    def __init__(
+        self,
+        client: Any,
+        index_name: str,
+        text_key: str,
+        embedding: Optional[Embeddings] = None,
+        attributes: Optional[List[str]] = None,
+        relevance_score_fn: Optional[
+            Callable[[float], float]
+        ] = _default_score_normalizer,
+        by_text: bool = True,
+    ):
+        """Initialize with Weaviate client."""
+        try:
+            import weaviate
+        except ImportError:
+            raise ImportError(
+                "Could not import weaviate python package. "
+                "Please install it with `pip install weaviate-client`."
+            )
+        if not isinstance(client, weaviate.Client):
+            raise ValueError(
+                f"client should be an instance of weaviate.Client, got {type(client)}"
+            )
+        self._client = client
+        self._index_name = index_name
+        self._embedding = embedding
+        self._text_key = text_key
+        self._query_attrs = [self._text_key]
+        self.relevance_score_fn = relevance_score_fn
+        self._by_text = by_text
+        if attributes is not None:
+            self._query_attrs.extend(attributes)
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        return self._embedding
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        return (
+            self.relevance_score_fn
+            if self.relevance_score_fn
+            else _default_score_normalizer
+        )
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Upload texts with metadata (properties) to Weaviate."""
+        from weaviate.util import get_valid_uuid
+
+        ids = []
+        embeddings: Optional[List[List[float]]] = None
+        if self._embedding:
+            if not isinstance(texts, list):
+                texts = list(texts)
+            embeddings = self._embedding.embed_documents(texts)
+
+        with self._client.batch as batch:
+            for i, text in enumerate(texts):
+                data_properties = {self._text_key: text}
+                if metadatas is not None:
+                    for key, val in metadatas[i].items():
+                        data_properties[key] = _json_serializable(val)
+
+                # Allow for ids (consistent w/ other methods)
+                # # Or uuids (backwards compatible w/ existing arg)
+                # If the UUID of one of the objects already exists
+                # then the existing object will be replaced by the new object.
+                _id = get_valid_uuid(uuid4())
+                if "uuids" in kwargs:
+                    _id = kwargs["uuids"][i]
+                elif "ids" in kwargs:
+                    _id = kwargs["ids"][i]
+
+                batch.add_data_object(
+                    data_object=data_properties,
+                    class_name=self._index_name,
+                    uuid=_id,
+                    vector=embeddings[i] if embeddings else None,
+                    tenant=kwargs.get("tenant"),
+                )
+                ids.append(_id)
+        return ids
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        if self._by_text:
+            return self.similarity_search_by_text(query, k, **kwargs)
+        else:
+            if self._embedding is None:
+                raise ValueError(
+                    "_embedding cannot be None for similarity_search when "
+                    "_by_text=False"
+                )
+            embedding = self._embedding.embed_query(query)
+            return self.similarity_search_by_vector(embedding, k, **kwargs)
+
+    def similarity_search_by_text(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        content: Dict[str, Any] = {"concepts": [query]}
+        if kwargs.get("search_distance"):
+            content["certainty"] = kwargs.get("search_distance")
+        query_obj = self._client.query.get(self._index_name, self._query_attrs)
+        if kwargs.get("where_filter"):
+            query_obj = query_obj.with_where(kwargs.get("where_filter"))
+        if kwargs.get("tenant"):
+            query_obj = query_obj.with_tenant(kwargs.get("tenant"))
+        if kwargs.get("additional"):
+            query_obj = query_obj.with_additional(kwargs.get("additional"))
+        result = query_obj.with_near_text(content).with_limit(k).do()
+        if "errors" in result:
+            raise ValueError(f"Error during query: {result['errors']}")
+        docs = []
+        for res in result["data"]["Get"][self._index_name]:
+            text = res.pop(self._text_key)
+            docs.append(Document(page_content=text, metadata=res))
+        return docs
+
+    def similarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Look up similar documents by embedding vector in Weaviate."""
+        vector = {"vector": embedding}
+        query_obj = self._client.query.get(self._index_name, self._query_attrs)
+        if kwargs.get("where_filter"):
+            query_obj = query_obj.with_where(kwargs.get("where_filter"))
+        if kwargs.get("tenant"):
+            query_obj = query_obj.with_tenant(kwargs.get("tenant"))
+        if kwargs.get("additional"):
+            query_obj = query_obj.with_additional(kwargs.get("additional"))
+        result = query_obj.with_near_vector(vector).with_limit(k).do()
+        if "errors" in result:
+            raise ValueError(f"Error during query: {result['errors']}")
+        docs = []
+        for res in result["data"]["Get"][self._index_name]:
+            text = res.pop(self._text_key)
+            docs.append(Document(page_content=text, metadata=res))
+        return docs
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        if self._embedding is not None:
+            embedding = self._embedding.embed_query(query)
+        else:
+            raise ValueError(
+                "max_marginal_relevance_search requires a suitable Embeddings object"
+            )
+
+        return self.max_marginal_relevance_search_by_vector(
+            embedding, k=k, fetch_k=fetch_k, lambda_mult=lambda_mult, **kwargs
+        )
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        vector = {"vector": embedding}
+        query_obj = self._client.query.get(self._index_name, self._query_attrs)
+        if kwargs.get("where_filter"):
+            query_obj = query_obj.with_where(kwargs.get("where_filter"))
+        if kwargs.get("tenant"):
+            query_obj = query_obj.with_tenant(kwargs.get("tenant"))
+        results = (
+            query_obj.with_additional("vector")
+            .with_near_vector(vector)
+            .with_limit(fetch_k)
+            .do()
+        )
+
+        payload = results["data"]["Get"][self._index_name]
+        embeddings = [result["_additional"]["vector"] for result in payload]
+        mmr_selected = maximal_marginal_relevance(
+            np.array(embedding), embeddings, k=k, lambda_mult=lambda_mult
+        )
+
+        docs = []
+        for idx in mmr_selected:
+            text = payload[idx].pop(self._text_key)
+            payload[idx].pop("_additional")
+            meta = payload[idx]
+            docs.append(Document(page_content=text, metadata=meta))
+        return docs
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """
+        Return list of documents most similar to the query
+        text and cosine distance in float for each.
+        Lower score represents more similarity.
+        """
+        if self._embedding is None:
+            raise ValueError(
+                "_embedding cannot be None for similarity_search_with_score"
+            )
+        content: Dict[str, Any] = {"concepts": [query]}
+        if kwargs.get("search_distance"):
+            content["certainty"] = kwargs.get("search_distance")
+        query_obj = self._client.query.get(self._index_name, self._query_attrs)
+        if kwargs.get("where_filter"):
+            query_obj = query_obj.with_where(kwargs.get("where_filter"))
+        if kwargs.get("tenant"):
+            query_obj = query_obj.with_tenant(kwargs.get("tenant"))
+
+        embedded_query = self._embedding.embed_query(query)
+        if not self._by_text:
+            vector = {"vector": embedded_query}
+            result = (
+                query_obj.with_near_vector(vector)
+                .with_limit(k)
+                .with_additional("vector")
+                .do()
+            )
+        else:
+            result = (
+                query_obj.with_near_text(content)
+                .with_limit(k)
+                .with_additional("vector")
+                .do()
+            )
+
+        if "errors" in result:
+            raise ValueError(f"Error during query: {result['errors']}")
+
+        docs_and_scores = []
+        for res in result["data"]["Get"][self._index_name]:
+            text = res.pop(self._text_key)
+            score = np.dot(res["_additional"]["vector"], embedded_query)
+            docs_and_scores.append((Document(page_content=text, metadata=res), score))
+        return docs_and_scores
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        *,
+        client: Optional[weaviate.Client] = None,
+        weaviate_url: Optional[str] = None,
+        weaviate_api_key: Optional[str] = None,
+        batch_size: Optional[int] = None,
+        index_name: Optional[str] = None,
+        text_key: str = "text",
+        by_text: bool = False,
+        relevance_score_fn: Optional[
+            Callable[[float], float]
+        ] = _default_score_normalizer,
+        **kwargs: Any,
+    ) -> Weaviate:
+        """Construct Weaviate wrapper from raw documents.
+
+        This is a user-friendly interface that:
+            1. Embeds documents.
+            2. Creates a new index for the embeddings in the Weaviate instance.
+            3. Adds the documents to the newly created Weaviate index.
+
+        This is intended to be a quick way to get started.
+
+        Args:
+            texts: Texts to add to vector store.
+            embedding: Text embedding model to use.
+            metadatas: Metadata associated with each text.
+            client: weaviate.Client to use.
+            weaviate_url: The Weaviate URL. If using Weaviate Cloud Services get it
+                from the ``Details`` tab. Can be passed in as a named param or by
+                setting the environment variable ``WEAVIATE_URL``. Should not be
+                specified if client is provided.
+            weaviate_api_key: The Weaviate API key. If enabled and using Weaviate Cloud
+                Services, get it from ``Details`` tab. Can be passed in as a named param
+                or by setting the environment variable ``WEAVIATE_API_KEY``. Should
+                not be specified if client is provided.
+            batch_size: Size of batch operations.
+            index_name: Index name.
+            text_key: Key to use for uploading/retrieving text to/from vectorstore.
+            by_text: Whether to search by text or by embedding.
+            relevance_score_fn: Function for converting whatever distance function the
+                vector store uses to a relevance score, which is a normalized similarity
+                score (0 means dissimilar, 1 means similar).
+            **kwargs: Additional named parameters to pass to ``Weaviate.__init__()``.
+
+        Example:
+            .. code-block:: python
+
+                from langchain_community.embeddings import OpenAIEmbeddings
+                from langchain_community.vectorstores import Weaviate
+
+                embeddings = OpenAIEmbeddings()
+                weaviate = Weaviate.from_texts(
+                    texts,
+                    embeddings,
+                    weaviate_url="http://localhost:8080"
+                )
+        """
+
+        try:
+            from weaviate.util import get_valid_uuid
+        except ImportError as e:
+            raise ImportError(
+                "Could not import weaviate python  package. "
+                "Please install it with `pip install weaviate-client`"
+            ) from e
+
+        client = client or _create_weaviate_client(
+            url=weaviate_url,
+            api_key=weaviate_api_key,
+        )
+        if batch_size:
+            client.batch.configure(batch_size=batch_size)
+
+        index_name = index_name or f"LangChain_{uuid4().hex}"
+        schema = _default_schema(index_name, text_key)
+        # check whether the index already exists
+        if not client.schema.exists(index_name):
+            client.schema.create_class(schema)
+
+        embeddings = embedding.embed_documents(texts) if embedding else None
+        attributes = list(metadatas[0].keys()) if metadatas else None
+
+        # If the UUID of one of the objects already exists
+        # then the existing object will be replaced by the new object.
+        if "uuids" in kwargs:
+            uuids = kwargs.pop("uuids")
+        else:
+            uuids = [get_valid_uuid(uuid4()) for _ in range(len(texts))]
+
+        with client.batch as batch:
+            for i, text in enumerate(texts):
+                data_properties = {
+                    text_key: text,
+                }
+                if metadatas is not None:
+                    for key in metadatas[i].keys():
+                        data_properties[key] = metadatas[i][key]
+
+                _id = uuids[i]
+
+                # if an embedding strategy is not provided, we let
+                # weaviate create the embedding. Note that this will only
+                # work if weaviate has been installed with a vectorizer module
+                # like text2vec-contextionary for example
+                params = {
+                    "uuid": _id,
+                    "data_object": data_properties,
+                    "class_name": index_name,
+                }
+                if embeddings is not None:
+                    params["vector"] = embeddings[i]
+
+                batch.add_data_object(**params)
+
+            batch.flush()
+
+        return cls(
+            client,
+            index_name,
+            text_key,
+            embedding=embedding,
+            attributes=attributes,
+            relevance_score_fn=relevance_score_fn,
+            by_text=by_text,
+            **kwargs,
+        )
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> None:
+        """Delete by vector IDs.
+
+        Args:
+            ids: List of ids to delete.
+        """
+
+        if ids is None:
+            raise ValueError("No ids provided to delete.")
+
+        # TODO: Check if this can be done in bulk
+        for id in ids:
+            self._client.data_object.delete(uuid=id)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/xata.py b/llm/Lib/site-packages/langchain_community/vectorstores/xata.py
new file mode 100644
index 0000000000000000000000000000000000000000..bb2c064536930d74db2424a5938b8281cbba307a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/xata.py
@@ -0,0 +1,263 @@
+from __future__ import annotations
+
+import time
+from itertools import repeat
+from typing import Any, Dict, Iterable, List, Optional, Tuple, Type
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+
+class XataVectorStore(VectorStore):
+    """`Xata` vector store.
+
+    It assumes you have a Xata database
+    created with the right schema. See the guide at:
+    https://integrations.langchain.com/vectorstores?integration_name=XataVectorStore
+
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        db_url: str,
+        embedding: Embeddings,
+        table_name: str,
+    ) -> None:
+        """Initialize with Xata client."""
+        try:
+            from xata.client import XataClient  # noqa: F401
+        except ImportError:
+            raise ImportError(
+                "Could not import xata python package. "
+                "Please install it with `pip install xata`."
+            )
+        self._client = XataClient(api_key=api_key, db_url=db_url)
+        self._embedding: Embeddings = embedding
+        self._table_name = table_name or "vectors"
+
+    @property
+    def embeddings(self) -> Embeddings:
+        return self._embedding
+
+    def add_vectors(
+        self,
+        vectors: List[List[float]],
+        documents: List[Document],
+        ids: Optional[List[str]] = None,
+    ) -> List[str]:
+        return self._add_vectors(vectors, documents, ids)
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        ids = ids
+        docs = self._texts_to_documents(texts, metadatas)
+
+        vectors = self._embedding.embed_documents(list(texts))
+        return self.add_vectors(vectors, docs, ids)
+
+    def _add_vectors(
+        self,
+        vectors: List[List[float]],
+        documents: List[Document],
+        ids: Optional[List[str]] = None,
+    ) -> List[str]:
+        """Add vectors to the Xata database."""
+
+        rows: List[Dict[str, Any]] = []
+        for idx, embedding in enumerate(vectors):
+            row = {
+                "content": documents[idx].page_content,
+                "embedding": embedding,
+            }
+            if ids:
+                row["id"] = ids[idx]
+            for key, val in documents[idx].metadata.items():
+                if key not in ["id", "content", "embedding"]:
+                    row[key] = val
+            rows.append(row)
+
+        # XXX: I would have liked to use the BulkProcessor here, but it
+        # doesn't return the IDs, which we need here. Manual chunking it is.
+        chunk_size = 1000
+        id_list: List[str] = []
+        for i in range(0, len(rows), chunk_size):
+            chunk = rows[i : i + chunk_size]
+
+            r = self._client.records().bulk_insert(self._table_name, {"records": chunk})
+            if r.status_code != 200:
+                raise Exception(f"Error adding vectors to Xata: {r.status_code} {r}")
+            id_list.extend(r["recordIDs"])
+        return id_list
+
+    @staticmethod
+    def _texts_to_documents(
+        texts: Iterable[str],
+        metadatas: Optional[Iterable[Dict[Any, Any]]] = None,
+    ) -> List[Document]:
+        """Return list of Documents from list of texts and metadatas."""
+        if metadatas is None:
+            metadatas = repeat({})
+
+        docs = [
+            Document(page_content=text, metadata=metadata)
+            for text, metadata in zip(texts, metadatas)
+        ]
+
+        return docs
+
+    @classmethod
+    def from_texts(
+        cls: Type["XataVectorStore"],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        api_key: Optional[str] = None,
+        db_url: Optional[str] = None,
+        table_name: str = "vectors",
+        ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> "XataVectorStore":
+        """Return VectorStore initialized from texts and embeddings."""
+
+        if not api_key or not db_url:
+            raise ValueError("Xata api_key and db_url must be set.")
+
+        embeddings = embedding.embed_documents(texts)
+        ids = None  # Xata will generate them for us
+        docs = cls._texts_to_documents(texts, metadatas)
+
+        vector_db = cls(
+            api_key=api_key,
+            db_url=db_url,
+            embedding=embedding,
+            table_name=table_name,
+        )
+
+        vector_db._add_vectors(embeddings, docs, ids)
+        return vector_db
+
+    def similarity_search(
+        self, query: str, k: int = 4, filter: Optional[dict] = None, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query.
+        """
+        docs_and_scores = self.similarity_search_with_score(query, k, filter=filter)
+        documents = [d[0] for d in docs_and_scores]
+        return documents
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, filter: Optional[dict] = None, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search with Chroma with distance.
+
+        Args:
+            query (str): Query text to search for.
+            k (int): Number of results to return. Defaults to 4.
+            filter (Optional[dict]): Filter by metadata. Defaults to None.
+
+        Returns:
+            List[Tuple[Document, float]]: List of documents most similar to the query
+                text with distance in float.
+        """
+        embedding = self._embedding.embed_query(query)
+        payload = {
+            "queryVector": embedding,
+            "column": "embedding",
+            "size": k,
+        }
+        if filter:
+            payload["filter"] = filter
+        r = self._client.data().vector_search(self._table_name, payload=payload)
+        if r.status_code != 200:
+            raise Exception(f"Error running similarity search: {r.status_code} {r}")
+        hits = r["records"]
+        docs_and_scores = [
+            (
+                Document(
+                    page_content=hit["content"],
+                    metadata=self._extractMetadata(hit),
+                ),
+                hit["xata"]["score"],
+            )
+            for hit in hits
+        ]
+        return docs_and_scores
+
+    def _extractMetadata(self, record: dict) -> dict:
+        """Extract metadata from a record. Filters out known columns."""
+        metadata = {}
+        for key, val in record.items():
+            if key not in ["id", "content", "embedding", "xata"]:
+                metadata[key] = val
+        return metadata
+
+    def delete(
+        self,
+        ids: Optional[List[str]] = None,
+        delete_all: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Delete by vector IDs.
+
+        Args:
+            ids: List of ids to delete.
+            delete_all: Delete all records in the table.
+        """
+        if delete_all:
+            self._delete_all()
+            self.wait_for_indexing(ndocs=0)
+        elif ids is not None:
+            chunk_size = 500
+            for i in range(0, len(ids), chunk_size):
+                chunk = ids[i : i + chunk_size]
+                operations = [
+                    {"delete": {"table": self._table_name, "id": id}} for id in chunk
+                ]
+                self._client.records().transaction(payload={"operations": operations})
+        else:
+            raise ValueError("Either ids or delete_all must be set.")
+
+    def _delete_all(self) -> None:
+        """Delete all records in the table."""
+        while True:
+            r = self._client.data().query(self._table_name, payload={"columns": ["id"]})
+            if r.status_code != 200:
+                raise Exception(f"Error running query: {r.status_code} {r}")
+            ids = [rec["id"] for rec in r["records"]]
+            if len(ids) == 0:
+                break
+            operations = [
+                {"delete": {"table": self._table_name, "id": id}} for id in ids
+            ]
+            self._client.records().transaction(payload={"operations": operations})
+
+    def wait_for_indexing(self, timeout: float = 5, ndocs: int = 1) -> None:
+        """Wait for the search index to contain a certain number of
+        documents. Useful in tests.
+        """
+        start = time.time()
+        while True:
+            r = self._client.data().search_table(
+                self._table_name, payload={"query": "", "page": {"size": 0}}
+            )
+            if r.status_code != 200:
+                raise Exception(f"Error running search: {r.status_code} {r}")
+            if r["totalCount"] == ndocs:
+                break
+            if time.time() - start > timeout:
+                raise Exception("Timed out waiting for indexing to complete.")
+            time.sleep(0.5)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/yellowbrick.py b/llm/Lib/site-packages/langchain_community/vectorstores/yellowbrick.py
new file mode 100644
index 0000000000000000000000000000000000000000..e3e5504346a6e8dfb8408684b2a0d4191f56ba2d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/yellowbrick.py
@@ -0,0 +1,328 @@
+from __future__ import annotations
+
+import json
+import logging
+import uuid
+import warnings
+from itertools import repeat
+from typing import (
+    Any,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+)
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+from langchain_community.docstore.document import Document
+
+logger = logging.getLogger(__name__)
+
+
+class Yellowbrick(VectorStore):
+    """Yellowbrick as a vector database.
+
+    Example:
+        .. code-block:: python
+            from langchain_community.vectorstores import Yellowbrick
+            from langchain_community.embeddings.openai import OpenAIEmbeddings
+            ...
+    """
+
+    def __init__(
+        self,
+        embedding: Embeddings,
+        connection_string: str,
+        table: str,
+    ) -> None:
+        """Initialize with yellowbrick client.
+        Args:
+            embedding: Embedding operator
+            connection_string: Format 'postgres://username:password@host:port/database'
+            table: Table used to store / retrieve embeddings from
+        """
+
+        import psycopg2
+
+        if not isinstance(embedding, Embeddings):
+            warnings.warn("embeddings input must be Embeddings object.")
+
+        self.connection_string = connection_string
+        self._table = table
+        self._embedding = embedding
+        self._connection = psycopg2.connect(connection_string)
+
+        self.__post_init__()
+
+    def __post_init__(
+        self,
+    ) -> None:
+        """Initialize the store."""
+        self.check_database_utf8()
+        self.create_table_if_not_exists()
+
+    def __del__(self) -> None:
+        if self._connection:
+            self._connection.close()
+
+    def create_table_if_not_exists(self) -> None:
+        """
+        Helper function: create table if not exists
+        """
+        from psycopg2 import sql
+
+        cursor = self._connection.cursor()
+        cursor.execute(
+            sql.SQL(
+                "CREATE TABLE IF NOT EXISTS {} ( \
+            id UUID, \
+            embedding_id INTEGER, \
+            text VARCHAR(60000), \
+            metadata VARCHAR(1024), \
+            embedding FLOAT)"
+            ).format(sql.Identifier(self._table))
+        )
+        self._connection.commit()
+        cursor.close()
+
+    def drop(self, table: str) -> None:
+        """
+        Helper function: Drop data
+        """
+        from psycopg2 import sql
+
+        cursor = self._connection.cursor()
+        cursor.execute(sql.SQL("DROP TABLE IF EXISTS {}").format(sql.Identifier(table)))
+        self._connection.commit()
+        cursor.close()
+
+    def check_database_utf8(self) -> bool:
+        """
+        Helper function: Test the database is UTF-8 encoded
+        """
+        cursor = self._connection.cursor()
+        query = "SELECT pg_encoding_to_char(encoding) \
+        FROM pg_database \
+        WHERE datname = current_database();"
+        cursor.execute(query)
+        encoding = cursor.fetchone()[0]
+        cursor.close()
+        if encoding.lower() == "utf8" or encoding.lower() == "utf-8":
+            return True
+        else:
+            raise Exception(
+                f"Database \
+           '{self.connection_string.split('/')[-1]}' encoding is not UTF-8"
+            )
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Add more texts to the vectorstore index.
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+        """
+        from psycopg2 import sql
+
+        texts = list(texts)
+        cursor = self._connection.cursor()
+        embeddings = self._embedding.embed_documents(list(texts))
+        results = []
+        if not metadatas:
+            metadatas = [{} for _ in texts]
+        for id in range(len(embeddings)):
+            doc_uuid = uuid.uuid4()
+            results.append(str(doc_uuid))
+            data_input = [
+                (str(id), embedding_id, text, json.dumps(metadata), embedding)
+                for id, embedding_id, text, metadata, embedding in zip(
+                    repeat(doc_uuid),
+                    range(len(embeddings[id])),
+                    repeat(texts[id]),
+                    repeat(metadatas[id]),
+                    embeddings[id],
+                )
+            ]
+            flattened_input = [val for sublist in data_input for val in sublist]
+            insert_query = sql.SQL(
+                "INSERT INTO {t} \
+                (id, embedding_id, text, metadata, embedding) VALUES {v}"
+            ).format(
+                t=sql.Identifier(self._table),
+                v=(
+                    sql.SQL(",").join(
+                        [
+                            sql.SQL("(%s,%s,%s,%s,%s)")
+                            for _ in range(len(embeddings[id]))
+                        ]
+                    )
+                ),
+            )
+            cursor.execute(insert_query, flattened_input)
+            self._connection.commit()
+        return results
+
+    @classmethod
+    def from_texts(
+        cls: Type[Yellowbrick],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        connection_string: str = "",
+        table: str = "langchain",
+        **kwargs: Any,
+    ) -> Yellowbrick:
+        """Add texts to the vectorstore index.
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            connection_string: URI to Yellowbrick instance
+            embedding: Embedding function
+            table: table to store embeddings
+            kwargs: vectorstore specific parameters
+        """
+        if connection_string is None:
+            raise ValueError("connection_string must be provided")
+        vss = cls(
+            embedding=embedding,
+            connection_string=connection_string,
+            table=table,
+        )
+        vss.add_texts(texts=texts, metadatas=metadatas)
+        return vss
+
+    def similarity_search_with_score_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Perform a similarity search with Yellowbrick with vector
+
+        Args:
+            embedding (List[float]): query embedding
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+
+            NOTE: Please do not let end-user fill this and always be aware
+                  of SQL injection.
+
+        Returns:
+            List[Document, float]: List of Documents and scores
+        """
+        from psycopg2 import sql
+
+        cursor = self._connection.cursor()
+        tmp_table = "tmp_" + self._table
+        cursor.execute(
+            sql.SQL(
+                "CREATE TEMPORARY TABLE {} ( \
+            embedding_id INTEGER, embedding FLOAT)"
+            ).format(sql.Identifier(tmp_table))
+        )
+        self._connection.commit()
+
+        data_input = [
+            (embedding_id, embedding)
+            for embedding_id, embedding in zip(range(len(embedding)), embedding)
+        ]
+        flattened_input = [val for sublist in data_input for val in sublist]
+        insert_query = sql.SQL(
+            "INSERT INTO {t} \
+            (embedding_id, embedding) VALUES {v}"
+        ).format(
+            t=sql.Identifier(tmp_table),
+            v=sql.SQL(",").join([sql.SQL("(%s,%s)") for _ in range(len(embedding))]),
+        )
+        cursor.execute(insert_query, flattened_input)
+        self._connection.commit()
+        sql_query = sql.SQL(
+            "SELECT text, \
+            metadata, \
+            sum(v1.embedding * v2.embedding) / \
+            ( sqrt(sum(v1.embedding * v1.embedding)) * \
+            sqrt(sum(v2.embedding * v2.embedding))) AS score \
+            FROM {v1} v1 INNER JOIN {v2} v2 \
+            ON v1.embedding_id = v2.embedding_id \
+            GROUP BY v2.id, v2.text, v2.metadata \
+            ORDER BY score DESC \
+            LIMIT %s"
+        ).format(v1=sql.Identifier(tmp_table), v2=sql.Identifier(self._table))
+        cursor.execute(sql_query, (k,))
+        results = cursor.fetchall()
+        self.drop(tmp_table)
+
+        documents: List[Tuple[Document, float]] = []
+        for result in results:
+            metadata = json.loads(result[1]) or {}
+            doc = Document(page_content=result[0], metadata=metadata)
+            documents.append((doc, result[2]))
+
+        cursor.close()
+        return documents
+
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Perform a similarity search with Yellowbrick
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+
+            NOTE: Please do not let end-user fill this and always be aware
+                  of SQL injection.
+
+        Returns:
+            List[Document]: List of Documents
+        """
+        embedding = self._embedding.embed_query(query)
+        documents = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k
+        )
+        return [doc for doc, _ in documents]
+
+    def similarity_search_with_score(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Perform a similarity search with Yellowbrick
+
+        Args:
+            query (str): query string
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+
+            NOTE: Please do not let end-user fill this and always be aware
+                  of SQL injection.
+
+        Returns:
+            List[Document]: List of (Document, similarity)
+        """
+        embedding = self._embedding.embed_query(query)
+        documents = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k
+        )
+        return documents
+
+    def similarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Perform a similarity search with Yellowbrick by vectors
+
+        Args:
+            embedding (List[float]): query embedding
+            k (int, optional): Top K neighbors to retrieve. Defaults to 4.
+
+            NOTE: Please do not let end-user fill this and always be aware
+                  of SQL injection.
+
+        Returns:
+            List[Document]: List of documents
+        """
+        documents = self.similarity_search_with_score_by_vector(
+            embedding=embedding, k=k
+        )
+        return [doc for doc, _ in documents]
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/zep.py b/llm/Lib/site-packages/langchain_community/vectorstores/zep.py
new file mode 100644
index 0000000000000000000000000000000000000000..5348dd8ac6ed0a1ef66a0ab1f30e3774ceba280c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/zep.py
@@ -0,0 +1,678 @@
+from __future__ import annotations
+
+import logging
+import warnings
+from dataclasses import asdict, dataclass
+from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Optional, Tuple
+
+from langchain_core.documents import Document
+from langchain_core.embeddings import Embeddings
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    from zep_python.document import Document as ZepDocument
+    from zep_python.document import DocumentCollection
+
+
+logger = logging.getLogger()
+
+
+@dataclass
+class CollectionConfig:
+    """Configuration for a `Zep Collection`.
+
+    If the collection does not exist, it will be created.
+
+    Attributes:
+        name (str): The name of the collection.
+        description (Optional[str]): An optional description of the collection.
+        metadata (Optional[Dict[str, Any]]): Optional metadata for the collection.
+        embedding_dimensions (int): The number of dimensions for the embeddings in
+            the collection. This should match the Zep server configuration
+            if auto-embed is true.
+        is_auto_embedded (bool): A flag indicating whether the collection is
+            automatically embedded by Zep.
+    """
+
+    name: str
+    description: Optional[str]
+    metadata: Optional[Dict[str, Any]]
+    embedding_dimensions: int
+    is_auto_embedded: bool
+
+
+class ZepVectorStore(VectorStore):
+    """`Zep` vector store.
+
+    It provides methods for adding texts or documents to the store,
+    searching for similar documents, and deleting documents.
+
+    Search scores are calculated using cosine similarity normalized to [0, 1].
+
+    Args:
+        api_url (str): The URL of the Zep API.
+        collection_name (str): The name of the collection in the Zep store.
+        api_key (Optional[str]): The API key for the Zep API.
+        config (Optional[CollectionConfig]): The configuration for the collection.
+            Required if the collection does not already exist.
+        embedding (Optional[Embeddings]): Optional embedding function to use to
+            embed the texts. Required if the collection is not auto-embedded.
+    """
+
+    def __init__(
+        self,
+        collection_name: str,
+        api_url: str,
+        *,
+        api_key: Optional[str] = None,
+        config: Optional[CollectionConfig] = None,
+        embedding: Optional[Embeddings] = None,
+    ) -> None:
+        super().__init__()
+        if not collection_name:
+            raise ValueError(
+                "collection_name must be specified when using ZepVectorStore."
+            )
+        try:
+            from zep_python import ZepClient
+        except ImportError:
+            raise ImportError(
+                "Could not import zep-python python package. "
+                "Please install it with `pip install zep-python`."
+            )
+        self._client = ZepClient(api_url, api_key=api_key)
+
+        self.collection_name = collection_name
+        # If for some reason the collection name is not the same as the one in the
+        # config, update it.
+        if config and config.name != self.collection_name:
+            config.name = self.collection_name
+
+        self._collection_config = config
+        self._collection = self._load_collection()
+        self._embedding = embedding
+
+        # self.add_texts(texts, metadatas=metadatas, **kwargs)
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        """Access the query embedding object if available."""
+        return self._embedding
+
+    def _load_collection(self) -> DocumentCollection:
+        """
+        Load the collection from the Zep backend.
+        """
+        from zep_python import NotFoundError
+
+        try:
+            collection = self._client.document.get_collection(self.collection_name)
+        except NotFoundError:
+            logger.info(
+                f"Collection {self.collection_name} not found. Creating new collection."
+            )
+            collection = self._create_collection()
+
+        return collection
+
+    def _create_collection(self) -> DocumentCollection:
+        """
+        Create a new collection in the Zep backend.
+        """
+        if not self._collection_config:
+            raise ValueError(
+                "Collection config must be specified when creating a new collection."
+            )
+        collection = self._client.document.add_collection(
+            **asdict(self._collection_config)
+        )
+        return collection
+
+    def _generate_documents_to_add(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict[Any, Any]]] = None,
+        document_ids: Optional[List[str]] = None,
+    ) -> List[ZepDocument]:
+        from zep_python.document import Document as ZepDocument
+
+        embeddings = None
+        if self._collection and self._collection.is_auto_embedded:
+            if self._embedding is not None:
+                warnings.warn(
+                    """The collection is set to auto-embed and an embedding 
+                function is present. Ignoring the embedding function.""",
+                    stacklevel=2,
+                )
+        elif self._embedding is not None:
+            embeddings = self._embedding.embed_documents(list(texts))
+            if self._collection and self._collection.embedding_dimensions != len(
+                embeddings[0]
+            ):
+                raise ValueError(
+                    "The embedding dimensions of the collection and the embedding"
+                    " function do not match. Collection dimensions:"
+                    f" {self._collection.embedding_dimensions}, Embedding dimensions:"
+                    f" {len(embeddings[0])}"
+                )
+        else:
+            pass
+
+        documents: List[ZepDocument] = []
+        for i, d in enumerate(texts):
+            documents.append(
+                ZepDocument(
+                    content=d,
+                    metadata=metadatas[i] if metadatas else None,
+                    document_id=document_ids[i] if document_ids else None,
+                    embedding=embeddings[i] if embeddings else None,
+                )
+            )
+        return documents
+
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict[str, Any]]] = None,
+        document_ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            document_ids: Optional list of document ids associated with the texts.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+        if not self._collection:
+            raise ValueError(
+                "collection should be an instance of a Zep DocumentCollection"
+            )
+
+        documents = self._generate_documents_to_add(texts, metadatas, document_ids)
+        uuids = self._collection.add_documents(documents)
+
+        return uuids
+
+    async def aadd_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[Dict[str, Any]]] = None,
+        document_ids: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore."""
+        if not self._collection:
+            raise ValueError(
+                "collection should be an instance of a Zep DocumentCollection"
+            )
+
+        documents = self._generate_documents_to_add(texts, metadatas, document_ids)
+        uuids = await self._collection.aadd_documents(documents)
+
+        return uuids
+
+    def search(
+        self,
+        query: str,
+        search_type: str,
+        metadata: Optional[Dict[str, Any]] = None,
+        k: int = 3,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query using specified search type."""
+        if search_type == "similarity":
+            return self.similarity_search(query, k=k, metadata=metadata, **kwargs)
+        elif search_type == "mmr":
+            return self.max_marginal_relevance_search(
+                query, k=k, metadata=metadata, **kwargs
+            )
+        else:
+            raise ValueError(
+                f"search_type of {search_type} not allowed. Expected "
+                "search_type to be 'similarity' or 'mmr'."
+            )
+
+    async def asearch(
+        self,
+        query: str,
+        search_type: str,
+        metadata: Optional[Dict[str, Any]] = None,
+        k: int = 3,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query using specified search type."""
+        if search_type == "similarity":
+            return await self.asimilarity_search(
+                query, k=k, metadata=metadata, **kwargs
+            )
+        elif search_type == "mmr":
+            return await self.amax_marginal_relevance_search(
+                query, k=k, metadata=metadata, **kwargs
+            )
+        else:
+            raise ValueError(
+                f"search_type of {search_type} not allowed. Expected "
+                "search_type to be 'similarity' or 'mmr'."
+            )
+
+    def similarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query."""
+
+        results = self._similarity_search_with_relevance_scores(
+            query, k=k, metadata=metadata, **kwargs
+        )
+        return [doc for doc, _ in results]
+
+    def similarity_search_with_score(
+        self,
+        query: str,
+        k: int = 4,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search with distance."""
+
+        return self._similarity_search_with_relevance_scores(
+            query, k=k, metadata=metadata, **kwargs
+        )
+
+    def _similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """
+        Default similarity search with relevance scores. Modify if necessary
+        in subclass.
+        Return docs and relevance scores in the range [0, 1].
+
+        0 is dissimilar, 1 is most similar.
+
+        Args:
+            query: input text
+            k: Number of Documents to return. Defaults to 4.
+            metadata: Optional, metadata filter
+            **kwargs: kwargs to be passed to similarity search. Should include:
+                score_threshold: Optional, a floating point value between 0 to 1 and
+                    filter the resulting set of retrieved docs
+
+        Returns:
+            List of Tuples of (doc, similarity_score)
+        """
+
+        if not self._collection:
+            raise ValueError(
+                "collection should be an instance of a Zep DocumentCollection"
+            )
+
+        if not self._collection.is_auto_embedded and self._embedding:
+            query_vector = self._embedding.embed_query(query)
+            results = self._collection.search(
+                embedding=query_vector, limit=k, metadata=metadata, **kwargs
+            )
+        else:
+            results = self._collection.search(
+                query, limit=k, metadata=metadata, **kwargs
+            )
+
+        return [
+            (
+                Document(
+                    page_content=doc.content,
+                    metadata=doc.metadata,
+                ),
+                doc.score or 0.0,
+            )
+            for doc in results
+        ]
+
+    async def asimilarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs most similar to query."""
+
+        if not self._collection:
+            raise ValueError(
+                "collection should be an instance of a Zep DocumentCollection"
+            )
+
+        if not self._collection.is_auto_embedded and self._embedding:
+            query_vector = self._embedding.embed_query(query)
+            results = await self._collection.asearch(
+                embedding=query_vector, limit=k, metadata=metadata, **kwargs
+            )
+        else:
+            results = await self._collection.asearch(
+                query, limit=k, metadata=metadata, **kwargs
+            )
+
+        return [
+            (
+                Document(
+                    page_content=doc.content,
+                    metadata=doc.metadata,
+                ),
+                doc.score or 0.0,
+            )
+            for doc in results
+        ]
+
+    async def asimilarity_search(
+        self,
+        query: str,
+        k: int = 4,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to query."""
+
+        results = await self.asimilarity_search_with_relevance_scores(
+            query, k, metadata=metadata, **kwargs
+        )
+
+        return [doc for doc, _ in results]
+
+    def similarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            metadata: Optional, metadata filter
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        if not self._collection:
+            raise ValueError(
+                "collection should be an instance of a Zep DocumentCollection"
+            )
+
+        results = self._collection.search(
+            embedding=embedding, limit=k, metadata=metadata, **kwargs
+        )
+
+        return [
+            Document(
+                page_content=doc.content,
+                metadata=doc.metadata,
+            )
+            for doc in results
+        ]
+
+    async def asimilarity_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector."""
+        if not self._collection:
+            raise ValueError(
+                "collection should be an instance of a Zep DocumentCollection"
+            )
+
+        results = self._collection.search(
+            embedding=embedding, limit=k, metadata=metadata, **kwargs
+        )
+
+        return [
+            Document(
+                page_content=doc.content,
+                metadata=doc.metadata,
+            )
+            for doc in results
+        ]
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+                     Zep determines this automatically and this parameter is
+                        ignored.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            metadata: Optional, metadata to filter the resulting set of retrieved docs
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+
+        if not self._collection:
+            raise ValueError(
+                "collection should be an instance of a Zep DocumentCollection"
+            )
+
+        if not self._collection.is_auto_embedded and self._embedding:
+            query_vector = self._embedding.embed_query(query)
+            results = self._collection.search(
+                embedding=query_vector,
+                limit=k,
+                metadata=metadata,
+                search_type="mmr",
+                mmr_lambda=lambda_mult,
+                **kwargs,
+            )
+        else:
+            results, query_vector = self._collection.search_return_query_vector(
+                query,
+                limit=k,
+                metadata=metadata,
+                search_type="mmr",
+                mmr_lambda=lambda_mult,
+                **kwargs,
+            )
+
+        return [Document(page_content=d.content, metadata=d.metadata) for d in results]
+
+    async def amax_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance."""
+
+        if not self._collection:
+            raise ValueError(
+                "collection should be an instance of a Zep DocumentCollection"
+            )
+
+        if not self._collection.is_auto_embedded and self._embedding:
+            query_vector = self._embedding.embed_query(query)
+            results = await self._collection.asearch(
+                embedding=query_vector,
+                limit=k,
+                metadata=metadata,
+                search_type="mmr",
+                mmr_lambda=lambda_mult,
+                **kwargs,
+            )
+        else:
+            results, query_vector = await self._collection.asearch_return_query_vector(
+                query,
+                limit=k,
+                metadata=metadata,
+                search_type="mmr",
+                mmr_lambda=lambda_mult,
+                **kwargs,
+            )
+
+        return [Document(page_content=d.content, metadata=d.metadata) for d in results]
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+                     Zep determines this automatically and this parameter is
+                        ignored.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+            metadata: Optional, metadata to filter the resulting set of retrieved docs
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        if not self._collection:
+            raise ValueError(
+                "collection should be an instance of a Zep DocumentCollection"
+            )
+
+        results = self._collection.search(
+            embedding=embedding,
+            limit=k,
+            metadata=metadata,
+            search_type="mmr",
+            mmr_lambda=lambda_mult,
+            **kwargs,
+        )
+
+        return [Document(page_content=d.content, metadata=d.metadata) for d in results]
+
+    async def amax_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance."""
+        if not self._collection:
+            raise ValueError(
+                "collection should be an instance of a Zep DocumentCollection"
+            )
+
+        results = await self._collection.asearch(
+            embedding=embedding,
+            limit=k,
+            metadata=metadata,
+            search_type="mmr",
+            mmr_lambda=lambda_mult,
+            **kwargs,
+        )
+
+        return [Document(page_content=d.content, metadata=d.metadata) for d in results]
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Optional[Embeddings] = None,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = "",
+        api_url: str = "",
+        api_key: Optional[str] = None,
+        config: Optional[CollectionConfig] = None,
+        **kwargs: Any,
+    ) -> ZepVectorStore:
+        """
+        Class method that returns a ZepVectorStore instance initialized from texts.
+
+        If the collection does not exist, it will be created.
+
+        Args:
+            texts (List[str]): The list of texts to add to the vectorstore.
+            embedding (Optional[Embeddings]): Optional embedding function to use to
+               embed the texts.
+            metadatas (Optional[List[Dict[str, Any]]]): Optional list of metadata
+               associated with the texts.
+            collection_name (str): The name of the collection in the Zep store.
+            api_url (str): The URL of the Zep API.
+            api_key (Optional[str]): The API key for the Zep API.
+            config (Optional[CollectionConfig]): The configuration for the collection.
+            **kwargs: Additional parameters specific to the vectorstore.
+
+        Returns:
+            ZepVectorStore: An instance of ZepVectorStore.
+        """
+        vecstore = cls(
+            collection_name,
+            api_url,
+            api_key=api_key,
+            config=config,
+            embedding=embedding,
+        )
+        vecstore.add_texts(texts, metadatas)
+        return vecstore
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> None:
+        """Delete by Zep vector UUIDs.
+
+        Parameters
+        ----------
+        ids : Optional[List[str]]
+            The UUIDs of the vectors to delete.
+
+        Raises
+        ------
+        ValueError
+            If no UUIDs are provided.
+        """
+
+        if ids is None or len(ids) == 0:
+            raise ValueError("No uuids provided to delete.")
+
+        if self._collection is None:
+            raise ValueError("No collection name provided.")
+
+        for u in ids:
+            self._collection.delete_document(u)
diff --git a/llm/Lib/site-packages/langchain_community/vectorstores/zilliz.py b/llm/Lib/site-packages/langchain_community/vectorstores/zilliz.py
new file mode 100644
index 0000000000000000000000000000000000000000..c6da0e8669702714fe4b7bb5e5e5035ba66d3eb2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_community/vectorstores/zilliz.py
@@ -0,0 +1,196 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, List, Optional
+
+from langchain_core.embeddings import Embeddings
+
+from langchain_community.vectorstores.milvus import Milvus
+
+logger = logging.getLogger(__name__)
+
+
+class Zilliz(Milvus):
+    """`Zilliz` vector store.
+
+    You need to have `pymilvus` installed and a
+    running Zilliz database.
+
+    See the following documentation for how to run a Zilliz instance:
+    https://docs.zilliz.com/docs/create-cluster
+
+
+    IF USING L2/IP metric IT IS HIGHLY SUGGESTED TO NORMALIZE YOUR DATA.
+
+    Args:
+        embedding_function (Embeddings): Function used to embed the text.
+        collection_name (str): Which Zilliz collection to use. Defaults to
+            "LangChainCollection".
+        connection_args (Optional[dict[str, any]]): The connection args used for
+            this class comes in the form of a dict.
+        consistency_level (str): The consistency level to use for a collection.
+            Defaults to "Session".
+        index_params (Optional[dict]): Which index params to use. Defaults to
+            HNSW/AUTOINDEX depending on service.
+        search_params (Optional[dict]): Which search params to use. Defaults to
+            default of index.
+        drop_old (Optional[bool]): Whether to drop the current collection. Defaults
+            to False.
+        auto_id (bool): Whether to enable auto id for primary key. Defaults to False.
+            If False, you needs to provide text ids (string less than 65535 bytes).
+            If True, Milvus will generate unique integers as primary keys.
+
+    The connection args used for this class comes in the form of a dict,
+    here are a few of the options:
+        address (str): The actual address of Zilliz
+            instance. Example address: "localhost:19530"
+        uri (str): The uri of Zilliz instance. Example uri:
+            "https://in03-ba4234asae.api.gcp-us-west1.zillizcloud.com",
+        host (str): The host of Zilliz instance. Default at "localhost",
+            PyMilvus will fill in the default host if only port is provided.
+        port (str/int): The port of Zilliz instance. Default at 19530, PyMilvus
+            will fill in the default port if only host is provided.
+        user (str): Use which user to connect to Zilliz instance. If user and
+            password are provided, we will add related header in every RPC call.
+        password (str): Required when user is provided. The password
+            corresponding to the user.
+        token (str): API key, for serverless clusters which can be used as
+            replacements for user and password.
+        secure (bool): Default is false. If set to true, tls will be enabled.
+        client_key_path (str): If use tls two-way authentication, need to
+            write the client.key path.
+        client_pem_path (str): If use tls two-way authentication, need to
+            write the client.pem path.
+        ca_pem_path (str): If use tls two-way authentication, need to write
+            the ca.pem path.
+        server_pem_path (str): If use tls one-way authentication, need to
+            write the server.pem path.
+        server_name (str): If use tls, need to write the common name.
+
+    Example:
+        .. code-block:: python
+
+        from langchain_community.vectorstores import Zilliz
+        from langchain_community.embeddings import OpenAIEmbeddings
+
+        embedding = OpenAIEmbeddings()
+        # Connect to a Zilliz instance
+        milvus_store = Milvus(
+            embedding_function = embedding,
+            collection_name = "LangChainCollection",
+            connection_args = {
+                "uri": "https://in03-ba4234asae.api.gcp-us-west1.zillizcloud.com",
+                "user": "temp",
+                "password": "temp",
+                "token": "temp", # API key as replacements for user and password
+                "secure": True
+            }
+            drop_old: True,
+        )
+
+    Raises:
+        ValueError: If the pymilvus python package is not installed.
+    """
+
+    def _create_index(self) -> None:
+        """Create a index on the collection"""
+        from pymilvus import Collection, MilvusException
+
+        if isinstance(self.col, Collection) and self._get_index() is None:
+            try:
+                # If no index params, use a default AutoIndex based one
+                if self.index_params is None:
+                    self.index_params = {
+                        "metric_type": "L2",
+                        "index_type": "AUTOINDEX",
+                        "params": {},
+                    }
+
+                try:
+                    self.col.create_index(
+                        self._vector_field,
+                        index_params=self.index_params,
+                        using=self.alias,
+                    )
+
+                # If default did not work, most likely Milvus self-hosted
+                except MilvusException:
+                    # Use HNSW based index
+                    self.index_params = {
+                        "metric_type": "L2",
+                        "index_type": "HNSW",
+                        "params": {"M": 8, "efConstruction": 64},
+                    }
+                    self.col.create_index(
+                        self._vector_field,
+                        index_params=self.index_params,
+                        using=self.alias,
+                    )
+                logger.debug(
+                    "Successfully created an index on collection: %s",
+                    self.collection_name,
+                )
+
+            except MilvusException as e:
+                logger.error(
+                    "Failed to create an index on collection: %s", self.collection_name
+                )
+                raise e
+
+    @classmethod
+    def from_texts(
+        cls,
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        collection_name: str = "LangChainCollection",
+        connection_args: Optional[Dict[str, Any]] = None,
+        consistency_level: str = "Session",
+        index_params: Optional[dict] = None,
+        search_params: Optional[dict] = None,
+        drop_old: bool = False,
+        *,
+        ids: Optional[List[str]] = None,
+        auto_id: bool = False,
+        **kwargs: Any,
+    ) -> Zilliz:
+        """Create a Zilliz collection, indexes it with HNSW, and insert data.
+
+        Args:
+            texts (List[str]): Text data.
+            embedding (Embeddings): Embedding function.
+            metadatas (Optional[List[dict]]): Metadata for each text if it exists.
+                Defaults to None.
+            collection_name (str, optional): Collection name to use. Defaults to
+                "LangChainCollection".
+            connection_args (dict[str, Any], optional): Connection args to use. Defaults
+                to DEFAULT_MILVUS_CONNECTION.
+            consistency_level (str, optional): Which consistency level to use. Defaults
+                to "Session".
+            index_params (Optional[dict], optional): Which index_params to use.
+                Defaults to None.
+            search_params (Optional[dict], optional): Which search params to use.
+                Defaults to None.
+            drop_old (Optional[bool], optional): Whether to drop the collection with
+                that name if it exists. Defaults to False.
+            ids (Optional[List[str]]): List of text ids.
+            auto_id (bool): Whether to enable auto id for primary key. Defaults to
+                False. If False, you needs to provide text ids (string less than 65535
+                bytes). If True, Milvus will generate unique integers as primary keys.
+
+        Returns:
+            Zilliz: Zilliz Vector Store
+        """
+        vector_db = cls(
+            embedding_function=embedding,
+            collection_name=collection_name,
+            connection_args=connection_args or {},
+            consistency_level=consistency_level,
+            index_params=index_params,
+            search_params=search_params,
+            drop_old=drop_old,
+            auto_id=auto_id,
+            **kwargs,
+        )
+        vector_db.add_texts(texts=texts, metadatas=metadatas, ids=ids)
+        return vector_db
diff --git a/llm/Lib/site-packages/langchain_core-0.1.45.dist-info/INSTALLER b/llm/Lib/site-packages/langchain_core-0.1.45.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core-0.1.45.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/llm/Lib/site-packages/langchain_core-0.1.45.dist-info/METADATA b/llm/Lib/site-packages/langchain_core-0.1.45.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..da1055b7768eba5cdd688394a5a9f96d7830c970
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core-0.1.45.dist-info/METADATA
@@ -0,0 +1,115 @@
+Metadata-Version: 2.1
+Name: langchain-core
+Version: 0.1.45
+Summary: Building applications with LLMs through composability
+Home-page: https://github.com/langchain-ai/langchain
+License: MIT
+Requires-Python: >=3.8.1,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Provides-Extra: extended-testing
+Requires-Dist: PyYAML (>=5.3)
+Requires-Dist: jinja2 (>=3,<4) ; extra == "extended-testing"
+Requires-Dist: jsonpatch (>=1.33,<2.0)
+Requires-Dist: langsmith (>=0.1.0,<0.2.0)
+Requires-Dist: packaging (>=23.2,<24.0)
+Requires-Dist: pydantic (>=1,<3)
+Requires-Dist: tenacity (>=8.1.0,<9.0.0)
+Project-URL: Repository, https://github.com/langchain-ai/langchain
+Description-Content-Type: text/markdown
+
+# 🦜🍎️ LangChain Core
+
+[![Downloads](https://static.pepy.tech/badge/langchain_core/month)](https://pepy.tech/project/langchain_core)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Quick Install
+
+```bash
+pip install langchain-core
+```
+
+## What is it?
+
+LangChain Core contains the base abstractions that power the rest of the LangChain ecosystem.
+
+These abstractions are designed to be as modular and simple as possible. Examples of these abstractions include those for language models, document loaders, embedding models, vectorstores, retrievers, and more.
+
+The benefit of having these abstractions is that any provider can implement the required interface and then easily be used in the rest of the LangChain ecosystem.
+
+For full documentation see the [API reference](https://api.python.langchain.com/en/stable/core_api_reference.html).
+
+## 1️⃣ Core Interface: Runnables
+
+The concept of a Runnable is central to LangChain Core – it is the interface that most LangChain Core components implement, giving them
+
+- a common invocation interface (invoke, batch, stream, etc.)
+- built-in utilities for retries, fallbacks, schemas and runtime configurability
+- easy deployment with [LangServe](https://github.com/langchain-ai/langserve)
+
+For more check out the [runnable docs](https://python.langchain.com/docs/expression_language/interface). Examples of components that implement the interface include: LLMs, Chat Models, Prompts, Retrievers, Tools, Output Parsers.
+
+You can use LangChain Core objects in two ways:
+
+1. **imperative**, ie. call them directly, eg. `model.invoke(...)`
+
+2. **declarative**, with LangChain Expression Language (LCEL)
+
+3. or a mix of both! eg. one of the steps in your LCEL sequence can be a custom function
+
+| Feature   | Imperative                      | Declarative    |
+| --------- | ------------------------------- | -------------- |
+| Syntax    | All of Python                   | LCEL           |
+| Tracing   | ✅ – Automatic                  | ✅ – Automatic |
+| Parallel  | ✅ – with threads or coroutines | ✅ – Automatic |
+| Streaming | ✅ – by yielding                | ✅ – Automatic |
+| Async     | ✅ – by writing async functions | ✅ – Automatic |
+
+## ⚡️ What is LangChain Expression Language?
+
+LangChain Expression Language (LCEL) is a _declarative language_ for composing LangChain Core runnables into sequences (or DAGs), covering the most common patterns when building with LLMs.
+
+LangChain Core compiles LCEL sequences to an _optimized execution plan_, with automatic parallelization, streaming, tracing, and async support.
+
+For more check out the [LCEL docs](https://python.langchain.com/docs/expression_language/).
+
+![Diagram outlining the hierarchical organization of the LangChain framework, displaying the interconnected parts across multiple layers.](../../docs/static/img/langchain_stack.png "LangChain Framework Overview")
+
+For more advanced use cases, also check out [LangGraph](https://github.com/langchain-ai/langgraph), which is a graph-based runner for cyclic and recursive LLM workflows.
+
+## 📕 Releases & Versioning
+
+`langchain-core` is currently on version `0.1.x`.
+
+As `langchain-core` contains the base abstractions and runtime for the whole LangChain ecosystem, we will communicate any breaking changes with advance notice and version bumps. The exception for this is anything in `langchain_core.beta`. The reason for `langchain_core.beta` is that given the rate of change of the field, being able to move quickly is still a priority, and this module is our attempt to do so.
+
+Minor version increases will occur for:
+
+- Breaking changes for any public interfaces NOT in `langchain_core.beta`
+
+Patch version increases will occur for:
+
+- Bug fixes
+- New features
+- Any changes to private interfaces
+- Any changes to `langchain_core.beta`
+
+## 💁 Contributing
+
+As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
+
+For detailed information on how to contribute, see the [Contributing Guide](https://python.langchain.com/docs/contributing/).
+
+## ⛰️ Why build on top of LangChain Core?
+
+The whole LangChain ecosystem is built on top of LangChain Core, so you're in good company when building on top of it. Some of the benefits:
+
+- **Modularity**: LangChain Core is designed around abstractions that are independent of each other, and not tied to any specific model provider.
+- **Stability**: We are committed to a stable versioning scheme, and will communicate any breaking changes with advance notice and version bumps.
+- **Battle-tested**: LangChain Core components have the largest install base in the LLM ecosystem, and are used in production by many companies.
+- **Community**: LangChain Core is developed in the open, and we welcome contributions from the community.
+
diff --git a/llm/Lib/site-packages/langchain_core-0.1.45.dist-info/RECORD b/llm/Lib/site-packages/langchain_core-0.1.45.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..13420ff333511b2e6210eef434612b6b9e61fb65
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core-0.1.45.dist-info/RECORD
@@ -0,0 +1,287 @@
+langchain_core-0.1.45.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+langchain_core-0.1.45.dist-info/METADATA,sha256=cj9hd6xFSd6EcBsnabtc_TDXLNR885__d4eTw65jbF8,5930
+langchain_core-0.1.45.dist-info/RECORD,,
+langchain_core-0.1.45.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+langchain_core/__init__.py,sha256=E5lFNLx921GzqI_S1zPEvNyH0qJc1qNfa5bnJtZdjHY,390
+langchain_core/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/__pycache__/agents.cpython-311.pyc,,
+langchain_core/__pycache__/caches.cpython-311.pyc,,
+langchain_core/__pycache__/chat_history.cpython-311.pyc,,
+langchain_core/__pycache__/chat_sessions.cpython-311.pyc,,
+langchain_core/__pycache__/env.cpython-311.pyc,,
+langchain_core/__pycache__/exceptions.cpython-311.pyc,,
+langchain_core/__pycache__/globals.cpython-311.pyc,,
+langchain_core/__pycache__/memory.cpython-311.pyc,,
+langchain_core/__pycache__/prompt_values.cpython-311.pyc,,
+langchain_core/__pycache__/retrievers.cpython-311.pyc,,
+langchain_core/__pycache__/stores.cpython-311.pyc,,
+langchain_core/__pycache__/sys_info.cpython-311.pyc,,
+langchain_core/__pycache__/tools.cpython-311.pyc,,
+langchain_core/__pycache__/vectorstores.cpython-311.pyc,,
+langchain_core/_api/__init__.py,sha256=GbjdqNg46AIRQEhJbybW_mGZo-vul8tQgk5cX5iAwhI,1025
+langchain_core/_api/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/_api/__pycache__/beta_decorator.cpython-311.pyc,,
+langchain_core/_api/__pycache__/deprecation.cpython-311.pyc,,
+langchain_core/_api/__pycache__/internal.cpython-311.pyc,,
+langchain_core/_api/__pycache__/path.cpython-311.pyc,,
+langchain_core/_api/beta_decorator.py,sha256=oVWtMbbTslHcDh3jxQE8sW76mWhsGbWp8PSc6QFwiA4,9644
+langchain_core/_api/deprecation.py,sha256=umEtuUmP6GRS_QPPAXedwf-0T23OZeZRxyIwyENhkXM,15031
+langchain_core/_api/internal.py,sha256=IIWzVbnkMsOWNLRqE6GCHcTuzR4ezsn9ODtNRuKfvXs,662
+langchain_core/_api/path.py,sha256=M93Jo_1CUpShRyqB6m___Qjczm1RU1D7yb4LSGaiysk,984
+langchain_core/agents.py,sha256=4obdlZY_OPfbHCVWlNw_8QQl_D1_--dD4oCVLYpo_v8,7002
+langchain_core/beta/__init__.py,sha256=8phOlCdTByvzqN1DR4CU_rvaO4SDRebKATmFKj0B5Nw,68
+langchain_core/beta/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/beta/runnables/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_core/beta/runnables/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/beta/runnables/__pycache__/context.cpython-311.pyc,,
+langchain_core/beta/runnables/context.py,sha256=Sif5b6D-YpXrdcAkQTehaWkA2eHvBNEK2gRl8LKhAvQ,12193
+langchain_core/caches.py,sha256=fErwT6q1HFJUcgEu_tQAT8aLjQlZMJtIiOH4c9EmmfE,4275
+langchain_core/callbacks/__init__.py,sha256=kstjE9uMi93aBigatBBMmhup9_StlDOHgRf3xsz4bbE,2131
+langchain_core/callbacks/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/callbacks/__pycache__/base.cpython-311.pyc,,
+langchain_core/callbacks/__pycache__/file.cpython-311.pyc,,
+langchain_core/callbacks/__pycache__/manager.cpython-311.pyc,,
+langchain_core/callbacks/__pycache__/stdout.cpython-311.pyc,,
+langchain_core/callbacks/__pycache__/streaming_stdout.cpython-311.pyc,,
+langchain_core/callbacks/base.py,sha256=DKeJjEEYjHpN3TKhXPCXN2v9CeoxciDVSRCUJqPO0W4,17991
+langchain_core/callbacks/file.py,sha256=F1o99wjd8VGmMZUEnlwrCmVptbrFSpbI7JPLPR6K5us,2626
+langchain_core/callbacks/manager.py,sha256=t4EfwfodC9-XtwPi2RfJm2vhQBQqZF0OQLELZMNa9Gc,64839
+langchain_core/callbacks/stdout.py,sha256=nlfSx2QO0D6FKVdGzkvDL5I90aSddHXcczOiUrEcZ7M,2314
+langchain_core/callbacks/streaming_stdout.py,sha256=ka-RAoQae5FG7HE0nYKMwWfHvxS47MIjpMAtAMNRShs,2433
+langchain_core/chat_history.py,sha256=0C9bES0X3Z4bmanQP7B9llhcgrVK2oP5itfHsM3D8uo,6612
+langchain_core/chat_sessions.py,sha256=8uc62O-T67nM_01LHElHuO4X0d1Imggux1Ds52Cdu6o,490
+langchain_core/document_loaders/__init__.py,sha256=4_78v3sVJHLfVxgf5g9J2Uf9fFL1udZKglMuihH4Gho,261
+langchain_core/document_loaders/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/document_loaders/__pycache__/base.cpython-311.pyc,,
+langchain_core/document_loaders/__pycache__/blob_loaders.cpython-311.pyc,,
+langchain_core/document_loaders/base.py,sha256=z2yoeXXy6Wwxgjmd8XOMQvJ1kZ1kflfyFjWdfZ6hi2c,4235
+langchain_core/document_loaders/blob_loaders.py,sha256=EVxDonoINV7CIGQB0d9fYaQYSHiAmpb9wdzSEWp6-ow,6636
+langchain_core/documents/__init__.py,sha256=qgg4YJylR3ufqzBqcOqTHAbyiRCFXiF4iMOLiRiJBqU,377
+langchain_core/documents/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/documents/__pycache__/base.cpython-311.pyc,,
+langchain_core/documents/__pycache__/compressor.cpython-311.pyc,,
+langchain_core/documents/__pycache__/transformers.cpython-311.pyc,,
+langchain_core/documents/base.py,sha256=yznwFS_4Qdn0m0CZiH60mXFhhQ6YXdhlswvVdEBYa4I,1036
+langchain_core/documents/compressor.py,sha256=0AL2GDSx43so4widMwIzxuUJZ68gow-LoCTdXq3tX4k,1039
+langchain_core/documents/transformers.py,sha256=6lNEO2WmAM8iSb7i0nTsX_VaL0VUMWfTNImWWTLiLtU,2494
+langchain_core/embeddings/__init__.py,sha256=xj8VOvl-bRd8HPzM6TJNb_By2CR02cbV6Wh3Sq06Lk0,220
+langchain_core/embeddings/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/embeddings/__pycache__/embeddings.cpython-311.pyc,,
+langchain_core/embeddings/__pycache__/fake.cpython-311.pyc,,
+langchain_core/embeddings/embeddings.py,sha256=msrEgbuBhWXAaJEb0C4a-vK_-6H4WcKI0xU_q5O5now,819
+langchain_core/embeddings/fake.py,sha256=I_5_N7HyJnSqzeBJ_ihL85FLotccATnhYeSgeZjXjY0,1649
+langchain_core/env.py,sha256=dP9HvyXMBWMFE479N1Jmxibtt86N---INzhil5j5j1c,486
+langchain_core/example_selectors/__init__.py,sha256=1XBlxpR8pwiN7eKXzSzh4HrsFAaJZpvhT3v84r5f9SA,680
+langchain_core/example_selectors/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/example_selectors/__pycache__/base.cpython-311.pyc,,
+langchain_core/example_selectors/__pycache__/length_based.cpython-311.pyc,,
+langchain_core/example_selectors/__pycache__/semantic_similarity.cpython-311.pyc,,
+langchain_core/example_selectors/base.py,sha256=jX-74IWrq9FH-trlEoNP1mw3-BquXQYIdukB9ytmG7Y,979
+langchain_core/example_selectors/length_based.py,sha256=tzEptFGmRcS2kccphA-5tbCvY4MHyzX2LIb32SRYy5w,2804
+langchain_core/example_selectors/semantic_similarity.py,sha256=GkVy6mk4e0VGEhLz2eSvOdp1Lf310GZJjsoTInNRp-U,12466
+langchain_core/exceptions.py,sha256=IErfIoqJ4g-I5DFDaUhW6Omp_cQhoDFdClBpADxRheo,1913
+langchain_core/globals.py,sha256=PDKCfqz7rkRVdNfN5AX8uTxU-z5pG4IpuetYee87PKY,8376
+langchain_core/language_models/__init__.py,sha256=kWyBfv1phbcMGxdPwpwRtnxyzMeOeHUnpBrKWh9Xbqc,1687
+langchain_core/language_models/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/language_models/__pycache__/base.cpython-311.pyc,,
+langchain_core/language_models/__pycache__/chat_models.cpython-311.pyc,,
+langchain_core/language_models/__pycache__/fake.cpython-311.pyc,,
+langchain_core/language_models/__pycache__/fake_chat_models.cpython-311.pyc,,
+langchain_core/language_models/__pycache__/llms.cpython-311.pyc,,
+langchain_core/language_models/base.py,sha256=UM7-OvvUC0ABcCkvSgSoyHniAjqh6hVEw_ch0zToeOA,12680
+langchain_core/language_models/chat_models.py,sha256=HjmA8z2c0Ll9dIdZzw13CPXqxxdMF28seWYT5RDHEtk,34366
+langchain_core/language_models/fake.py,sha256=jS_-tVfl0c-aO7W_QKuY_z3CEVcke0iATyd4WbCMBrU,2901
+langchain_core/language_models/fake_chat_models.py,sha256=n521kssD1nGErZ5fDUsy3uZ68rZlgPgoSsj7H7FSfSo,10869
+langchain_core/language_models/llms.py,sha256=AM4iAd_vG18uP9QyfEjk0Jw-EbJaR4OJpR8G5tzSWmM,48309
+langchain_core/load/__init__.py,sha256=FnH8QFABfh_5srefe_d5zb2uV9zoAleWo2jonPq80dg,288
+langchain_core/load/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/load/__pycache__/dump.cpython-311.pyc,,
+langchain_core/load/__pycache__/load.cpython-311.pyc,,
+langchain_core/load/__pycache__/mapping.cpython-311.pyc,,
+langchain_core/load/__pycache__/serializable.cpython-311.pyc,,
+langchain_core/load/dump.py,sha256=qKTQw4c-tFyA-y7CrAnS434k082pdPHT2yVul9WQhB8,1174
+langchain_core/load/load.py,sha256=C0aB29SyUFDRXq-wzbNT3P6dBg8p7obrS5Mc1KcSUXU,5744
+langchain_core/load/mapping.py,sha256=ZtkflMkhxlYRACx91TFchRcpMWorqDBfcl9uYhfj_JQ,27029
+langchain_core/load/serializable.py,sha256=P_Y_H_vS8tsHBImYdk5JlS6jgeBv_y-60jSWb_A1Qtc,6792
+langchain_core/memory.py,sha256=tfG-ENv6wrUb0pwDofAmb64YH2hFgY3RZrX5MJ7wUF8,2912
+langchain_core/messages/__init__.py,sha256=Nc7lhHPoaCYOqEqf1l394S0_zeGYnc503xjshgc7lCM,1970
+langchain_core/messages/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/messages/__pycache__/ai.cpython-311.pyc,,
+langchain_core/messages/__pycache__/base.cpython-311.pyc,,
+langchain_core/messages/__pycache__/chat.cpython-311.pyc,,
+langchain_core/messages/__pycache__/function.cpython-311.pyc,,
+langchain_core/messages/__pycache__/human.cpython-311.pyc,,
+langchain_core/messages/__pycache__/system.cpython-311.pyc,,
+langchain_core/messages/__pycache__/tool.cpython-311.pyc,,
+langchain_core/messages/__pycache__/utils.cpython-311.pyc,,
+langchain_core/messages/ai.py,sha256=2qYibPFCSfSlEF7Dz-E93PVZ0DDYarKpSl950iz47oc,6222
+langchain_core/messages/base.py,sha256=vj7N8xqjXreBuMUucnGwIomQ1kdLkqRbmnDKsQQYK1c,6134
+langchain_core/messages/chat.py,sha256=lTmdYTVQN75b82IoFmyUQ9QERMXkffJGS-xz3-PFEcQ,2395
+langchain_core/messages/function.py,sha256=HUYuSYvzPw8b7hT7pk_IoEcGK5TcvAw6qws92O59Amc,1957
+langchain_core/messages/human.py,sha256=da2f0deVJUO-aK7fmcFH47LbixPzSQ9iBvzxYej5P0g,1089
+langchain_core/messages/system.py,sha256=DUHMawISGMmwImW7pLBktnHBvlPu2O1tqc41bybuQ3U,1042
+langchain_core/messages/tool.py,sha256=9IcxNz-z5Up1ByXdTXTTfsctuqzQzLy2M5lhF3sxmTU,5691
+langchain_core/messages/utils.py,sha256=cz0xkSmRHiyZxzjhGd_HLE8oED52l4kX8-POu9Ek48Q,7967
+langchain_core/output_parsers/__init__.py,sha256=N7IdT7xmp0UYz7Cjqr8mtImn4bzCTy2h74BopQS_l1E,1452
+langchain_core/output_parsers/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/output_parsers/__pycache__/base.cpython-311.pyc,,
+langchain_core/output_parsers/__pycache__/format_instructions.cpython-311.pyc,,
+langchain_core/output_parsers/__pycache__/json.cpython-311.pyc,,
+langchain_core/output_parsers/__pycache__/list.cpython-311.pyc,,
+langchain_core/output_parsers/__pycache__/openai_functions.cpython-311.pyc,,
+langchain_core/output_parsers/__pycache__/openai_tools.cpython-311.pyc,,
+langchain_core/output_parsers/__pycache__/pydantic.cpython-311.pyc,,
+langchain_core/output_parsers/__pycache__/string.cpython-311.pyc,,
+langchain_core/output_parsers/__pycache__/transform.cpython-311.pyc,,
+langchain_core/output_parsers/__pycache__/xml.cpython-311.pyc,,
+langchain_core/output_parsers/base.py,sha256=6-1hLl7xy2_YQ6ZzsQzLPkdeNmXLXTE6dqE1HplAeD0,9841
+langchain_core/output_parsers/format_instructions.py,sha256=PuqeCjZPaOmppGWl4HW1ZglZlXX41lI6Wo_ijGoU5aA,527
+langchain_core/output_parsers/json.py,sha256=cUjLp1nbA9KHDX-tkjm3k0LX8bQ3VDD3fdbPzh8RkN0,3704
+langchain_core/output_parsers/list.py,sha256=2FZRwFhP_xLyV3JX2rV1KfrsNP8KgOXvRo5CS2qze-s,5507
+langchain_core/output_parsers/openai_functions.py,sha256=qeSKENsem0smv9uzExcF2USzY0VHn_ykMDXXcX_0HUY,8014
+langchain_core/output_parsers/openai_tools.py,sha256=mqiJJ6Uxf0IJ1tWK_ZvrbAv6Hi8KxHJzZqNOsXdJ3bE,7155
+langchain_core/output_parsers/pydantic.py,sha256=mSz8ljUsUT3z8w_HJ61NQ8OQDaKTuJhtlwwfsVRAGf8,3847
+langchain_core/output_parsers/string.py,sha256=0CsCYH9fZzWAC7ljSbjVjJjFOPGMvbJX-7xNy70x0vI,789
+langchain_core/output_parsers/transform.py,sha256=Nt4Nhg7yMOs99CYy2yYsKSSFb6OXN4051FA81T9Rc84,4466
+langchain_core/output_parsers/xml.py,sha256=pA9r2Ks0MB-MVvqO7j9PWFS-K0blqktZpyY8wHOgwwM,9277
+langchain_core/outputs/__init__.py,sha256=tm70SHredW7urRD9iYZCwzlHtxefwXPBV3fCEbBDDRo,593
+langchain_core/outputs/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/outputs/__pycache__/chat_generation.cpython-311.pyc,,
+langchain_core/outputs/__pycache__/chat_result.cpython-311.pyc,,
+langchain_core/outputs/__pycache__/generation.cpython-311.pyc,,
+langchain_core/outputs/__pycache__/llm_result.cpython-311.pyc,,
+langchain_core/outputs/__pycache__/run_info.cpython-311.pyc,,
+langchain_core/outputs/chat_generation.py,sha256=fvX9e5cYEyBMljyIkNNHRL56z4ph8qKA_sV4cY6tS68,3280
+langchain_core/outputs/chat_result.py,sha256=4fv7lxGqzgz_IJGHhlkQSVU2TnE7_pI97SOGAJK7qO4,511
+langchain_core/outputs/generation.py,sha256=HAuYG9GznID8yHumcn3O7f6FE_YKgSrsla4MV_HwKHw,1809
+langchain_core/outputs/llm_result.py,sha256=EkXKu2M0JP1LyOaPreB81aiQLet7YwtGeYGcGY6eOJA,2448
+langchain_core/outputs/run_info.py,sha256=kEdpyqXtNnSpWdUXSHNO-udoX7BKSlOLhWC8gbGTx0Y,295
+langchain_core/prompt_values.py,sha256=_vPxb2ldKT6SvXEJ_hw14HTabbO84NX-3N1elVsXGiw,3560
+langchain_core/prompts/__init__.py,sha256=OqncTlV1x_XhBCeZa0GmmQpxh-DjUt16DBIbQZaPJK4,2658
+langchain_core/prompts/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/prompts/__pycache__/base.cpython-311.pyc,,
+langchain_core/prompts/__pycache__/chat.cpython-311.pyc,,
+langchain_core/prompts/__pycache__/few_shot.cpython-311.pyc,,
+langchain_core/prompts/__pycache__/few_shot_with_templates.cpython-311.pyc,,
+langchain_core/prompts/__pycache__/image.cpython-311.pyc,,
+langchain_core/prompts/__pycache__/loading.cpython-311.pyc,,
+langchain_core/prompts/__pycache__/pipeline.cpython-311.pyc,,
+langchain_core/prompts/__pycache__/prompt.cpython-311.pyc,,
+langchain_core/prompts/__pycache__/string.cpython-311.pyc,,
+langchain_core/prompts/__pycache__/structured.cpython-311.pyc,,
+langchain_core/prompts/base.py,sha256=B1FSjUeFMHutOtt4-rAqwVFInRtz2f4fPW00o4VUtZY,12230
+langchain_core/prompts/chat.py,sha256=7aJrt_UwQt7sOoHEGstOmK_LbUj7HqC4W4LENOMdjOI,44051
+langchain_core/prompts/few_shot.py,sha256=upjsMNFSGYh3W3kNAyTsScPLmaGSlOiNDcd9Es5qh4g,14119
+langchain_core/prompts/few_shot_with_templates.py,sha256=NuMuj03qMh57wFPaEJ1cTsM6dk9xPFtnICB5VprK3ro,7508
+langchain_core/prompts/image.py,sha256=AoHhW0iK2S636_fN1TKxpiUcRJfgxluSz507ZTH8KF4,3109
+langchain_core/prompts/loading.py,sha256=ST_fW0L8jXtYxTeDyGipVQNt6EzFySAzdS7cTuD74lI,6452
+langchain_core/prompts/pipeline.py,sha256=rYMp6TC6NKNZh4Gifzn6WCq4mycWabuzYgQEYHuxPl4,3138
+langchain_core/prompts/prompt.py,sha256=t7-g4gvBpBdfvttElR9MakxYAh3XwPiQxbN31q5t_tU,10050
+langchain_core/prompts/string.py,sha256=G4rkGsx48h6rkNqzbH9RP1coVGwVQbZm4TK_4eTnvms,8411
+langchain_core/prompts/structured.py,sha256=1QmXXQFCGqZbU8__n2RdxtJD9fVokvpPjfDBwRGS60c,4584
+langchain_core/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_core/pydantic_v1/__init__.py,sha256=ySw8fDvfaGfpoOzFSJswNGYA5mVHbBJeyv7XcPH8GXM,927
+langchain_core/pydantic_v1/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/pydantic_v1/__pycache__/dataclasses.cpython-311.pyc,,
+langchain_core/pydantic_v1/__pycache__/main.cpython-311.pyc,,
+langchain_core/pydantic_v1/dataclasses.py,sha256=ua-hUftg0xEtbBLgu7gV7BGgpD2Hk3PGfDxCxUi5DZ8,134
+langchain_core/pydantic_v1/main.py,sha256=QH2LgCi4tr-tLt3t6KhMykILHDzbqpPWaGQN4BUspOY,120
+langchain_core/retrievers.py,sha256=amQWUGQ8Qus8r35_b7clZyJOm6y2p_Xd2VUPJHI_mNY,14063
+langchain_core/runnables/__init__.py,sha256=gXyZ7c7_WJokQiu3jbOhTaq6NvbEyl7xWGLQ0z4EqHU,2258
+langchain_core/runnables/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/base.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/branch.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/config.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/configurable.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/fallbacks.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/graph.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/graph_ascii.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/graph_mermaid.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/graph_png.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/history.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/learnable.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/passthrough.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/retry.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/router.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/schema.cpython-311.pyc,,
+langchain_core/runnables/__pycache__/utils.cpython-311.pyc,,
+langchain_core/runnables/base.py,sha256=0sJEt5OqhG4ynDZDbKjzU5o40RS90lHhezQsOw6s_AM,187117
+langchain_core/runnables/branch.py,sha256=OrLv6n5Z88CgzEHrPGGfDF7NmDVdU8TNN1H-9hMxBMI,14612
+langchain_core/runnables/config.py,sha256=ax7Rj7A97N_557B7SLtAphi_oSpHk8lbHjSQ_F1tTSY,17732
+langchain_core/runnables/configurable.py,sha256=YQbF1Dul1CpAnmy-XafTSk_NTLeXdqhPWpmoQChQ5W4,23191
+langchain_core/runnables/fallbacks.py,sha256=33WmTI1jFgwVoubMOUJKf-wrAF2aF2bIjVECUE7qaCE,20237
+langchain_core/runnables/graph.py,sha256=G5PF7GqfWs_NvFsY3vwhLueR3lkzEd73mbkShW8pTNg,12036
+langchain_core/runnables/graph_ascii.py,sha256=A5SR33pxrW5gg7hNq9E4lQg3zGeSpJuAU9ygA37-OAg,8787
+langchain_core/runnables/graph_mermaid.py,sha256=XUXgJ00ULOGOSjnivb12MMLwPfEpBDrGh6xEIxzt4zQ,8702
+langchain_core/runnables/graph_png.py,sha256=Kpo7zpDDprgOR4ytUMrifZKNjDnNPUW_p3WZWqAzawU,3717
+langchain_core/runnables/history.py,sha256=ADAs-Blul-tJn40OmH-cmMRs2P9-a07BNxr26gQ84-4,19425
+langchain_core/runnables/learnable.py,sha256=HlHEQkI_qoI7_TDgxNLJpTd1yJj5_vxPVHt20FaO0Ig,436
+langchain_core/runnables/passthrough.py,sha256=XAJ4FwkA0UDiR7_fEscFs3E1cDPWAIVOxG-p-eX8aeY,23965
+langchain_core/runnables/retry.py,sha256=Yv3u7EvW1D4JahCL3Cdy2DjHb7WD8KpkNxkX3G3h51c,11947
+langchain_core/runnables/router.py,sha256=rShOGjTtpmPZM9b-g83D_JxyBGQrrkEDWjjcflT-9ck,6703
+langchain_core/runnables/schema.py,sha256=wkY3uyGmMxGENtr5H7gRvV5b6IxnTN_N778xS4_RArg,4397
+langchain_core/runnables/utils.py,sha256=DNdWAm7Wqu0wnBlLFasIDRAPHtLn3tr__U8uPsz8vZk,16258
+langchain_core/stores.py,sha256=V-TE73xM7CSggp-KA1C9uo1CYZOj4O_EhVGITUizH1o,3829
+langchain_core/sys_info.py,sha256=P1jZ783A_LuMML4z4YRXk8-4cUTLaEmLKkVSN8ZrXXc,2778
+langchain_core/tools.py,sha256=w4G4fyxt8QBLVNjcEAOp62dZZOrAfxsx1RSyjnAhSlY,36717
+langchain_core/tracers/__init__.py,sha256=aX0WGdJb9rghqF78cxg22ncbue_Y-nCVSGHgurym2m0,896
+langchain_core/tracers/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/tracers/__pycache__/base.cpython-311.pyc,,
+langchain_core/tracers/__pycache__/context.cpython-311.pyc,,
+langchain_core/tracers/__pycache__/evaluation.cpython-311.pyc,,
+langchain_core/tracers/__pycache__/langchain.cpython-311.pyc,,
+langchain_core/tracers/__pycache__/langchain_v1.cpython-311.pyc,,
+langchain_core/tracers/__pycache__/log_stream.cpython-311.pyc,,
+langchain_core/tracers/__pycache__/memory_stream.cpython-311.pyc,,
+langchain_core/tracers/__pycache__/root_listeners.cpython-311.pyc,,
+langchain_core/tracers/__pycache__/run_collector.cpython-311.pyc,,
+langchain_core/tracers/__pycache__/schemas.cpython-311.pyc,,
+langchain_core/tracers/__pycache__/stdout.cpython-311.pyc,,
+langchain_core/tracers/base.py,sha256=ABG6W3kYcOSxAJX3HNnLUq5mIimU40Ha4XALXAj8SWw,23839
+langchain_core/tracers/context.py,sha256=tifxpznPR85ItOt5wJPAf37EPGQwOVZJlTfEVj_Z2Ro,6999
+langchain_core/tracers/evaluation.py,sha256=tKU5uGfzb0rIWXagkepRIWcU1rxy_2NeVv2xvs6OTeU,8218
+langchain_core/tracers/langchain.py,sha256=H0dSSemMXVvLqjkpQznPkJQLoYWWViNTH_fgX-RHrzQ,8518
+langchain_core/tracers/langchain_v1.py,sha256=Jfzdff5XDx3l4IhIgQQ_A0wYJjyXGCajjt8iiJhesew,398
+langchain_core/tracers/log_stream.py,sha256=wniQs5Bhjiu6wr5Nn2BfJtk57e-qXy96Vji50bOSFyQ,21471
+langchain_core/tracers/memory_stream.py,sha256=ggLmICpgjn04iR5xQhCyBA_Dhk3ebh46ErzLT22W1Mo,3933
+langchain_core/tracers/root_listeners.py,sha256=UUADWg3wJObLnrnaT_yBkkH1h1SH3DD2cON5xQDRoYY,1704
+langchain_core/tracers/run_collector.py,sha256=CiZrGulj3t1Vm0RmwNNrQfDdOu6yBbQnJZ0fH-MciJM,1530
+langchain_core/tracers/schemas.py,sha256=dLb-bOBXbmm4GGAgtHFR0eBVQzglTGr1ZCGukANr0bA,4265
+langchain_core/tracers/stdout.py,sha256=C0xC7tgVM443WIkWXtvTej8RQKybz01dwYQ_776lqzU,6186
+langchain_core/utils/__init__.py,sha256=myTixw6f536MXfoMx6E9ZQrXgARf1vm0bkEuhPMn0ME,1284
+langchain_core/utils/__pycache__/__init__.cpython-311.pyc,,
+langchain_core/utils/__pycache__/_merge.cpython-311.pyc,,
+langchain_core/utils/__pycache__/aiter.cpython-311.pyc,,
+langchain_core/utils/__pycache__/env.cpython-311.pyc,,
+langchain_core/utils/__pycache__/formatting.cpython-311.pyc,,
+langchain_core/utils/__pycache__/function_calling.cpython-311.pyc,,
+langchain_core/utils/__pycache__/html.cpython-311.pyc,,
+langchain_core/utils/__pycache__/image.cpython-311.pyc,,
+langchain_core/utils/__pycache__/input.cpython-311.pyc,,
+langchain_core/utils/__pycache__/interactive_env.cpython-311.pyc,,
+langchain_core/utils/__pycache__/iter.cpython-311.pyc,,
+langchain_core/utils/__pycache__/json.cpython-311.pyc,,
+langchain_core/utils/__pycache__/json_schema.cpython-311.pyc,,
+langchain_core/utils/__pycache__/loading.cpython-311.pyc,,
+langchain_core/utils/__pycache__/mustache.cpython-311.pyc,,
+langchain_core/utils/__pycache__/pydantic.cpython-311.pyc,,
+langchain_core/utils/__pycache__/strings.cpython-311.pyc,,
+langchain_core/utils/__pycache__/utils.cpython-311.pyc,,
+langchain_core/utils/_merge.py,sha256=el0HypMHT0MPZhgKFyESsd_4AO-WtQKGHE93N9Qob3I,2648
+langchain_core/utils/aiter.py,sha256=3Wx2XXfHUlGUyKCnVOHTbeQVA_q_CLVOGxTGI2P6LVY,7198
+langchain_core/utils/env.py,sha256=7g6BjEFPjba9rwL2LQemRKiSkCv0VpYT_yI3LedL3Mc,1297
+langchain_core/utils/formatting.py,sha256=Lm0mrVKl1fTC9c8-ZwwN7reIVBZoq5E36bEjmfjK3-w,893
+langchain_core/utils/function_calling.py,sha256=Km3Pv6X5ePiTOqjIwUMZwDmqsNY_U0zueMswQ3SX6LE,15041
+langchain_core/utils/html.py,sha256=pn4DAvsrQHwNIDFtb5u9MLNLF17OMiKcgxK2iMjZl18,3623
+langchain_core/utils/image.py,sha256=NhXEGM7n0yizWjpt6a_dwcPETWBARxri8cLP1vdExi4,423
+langchain_core/utils/input.py,sha256=5aTw8MEveK2dAChFsQsy0OlRlx47GKFkbdlMvyouZN4,1304
+langchain_core/utils/interactive_env.py,sha256=NlnXizhm1TG3l_qKNI0qHJiHkh9q2jRjt5zGJsg_BCA,139
+langchain_core/utils/iter.py,sha256=1ZMzsxa7X1qVfxEjkITM4DVm4-wtjMLHN0YaIsMaNt0,6011
+langchain_core/utils/json.py,sha256=HseE49BKEvQFLw1C5yr1sz3owiKanQtVddOVv5spCWY,5805
+langchain_core/utils/json_schema.py,sha256=-DqNH1x0xByX913dm-PyRp7HWpnSHev_Zn2Pa-y34HQ,3067
+langchain_core/utils/loading.py,sha256=QaY52dsJuc62sDVfJL5TYH_iC95ppVTpitQ2q4TEG6c,793
+langchain_core/utils/mustache.py,sha256=qwCdmiQ15ReuxviJL5izBUTbHFBK4b6QAa-EpXHn-9Q,19817
+langchain_core/utils/pydantic.py,sha256=CjxTgZofB9LawZd6_TwSlUx_PF4emqrps3C7TVnYOfE,301
+langchain_core/utils/strings.py,sha256=vv_DcgTgtEkp6XzJxhwWzOq4_nM6Tj-7Xr3tLSTm-ac,908
+langchain_core/utils/utils.py,sha256=GiAvCKNDL6SPXXN4x02hKPniSjXL43zSSKrt9RrrULg,6160
+langchain_core/vectorstores.py,sha256=ljkRIjN7PyMapknm8NNJjMgJz_BaUxvN_9AqQWyUAzQ,27149
diff --git a/llm/Lib/site-packages/langchain_core-0.1.45.dist-info/WHEEL b/llm/Lib/site-packages/langchain_core-0.1.45.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..7c881525d384f1537e81e8a783c8433a748a7089
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core-0.1.45.dist-info/WHEEL
@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 1.8.1
+Root-Is-Purelib: true
+Tag: py3-none-any
diff --git a/llm/Lib/site-packages/langchain_core/__init__.py b/llm/Lib/site-packages/langchain_core/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2d90a7b689c71dbdd7866e7c5bac9dc110e21b4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/__init__.py
@@ -0,0 +1,15 @@
+from importlib import metadata
+
+from langchain_core._api import (
+    surface_langchain_beta_warnings,
+    surface_langchain_deprecation_warnings,
+)
+
+try:
+    __version__ = metadata.version(__package__)
+except metadata.PackageNotFoundError:
+    # Case where package metadata is not available.
+    __version__ = ""
+
+surface_langchain_deprecation_warnings()
+surface_langchain_beta_warnings()
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6d42f9c8d3268730d24ce37302ee86b7a09287aa
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/agents.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/agents.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..71b6a083dba1d3b9349a27e70878eae4bc7545bd
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/agents.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/caches.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/caches.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..24de2d02014b09bbae9460c9757862a6f3a9b33e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/caches.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/chat_history.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/chat_history.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c3bb08b16b4c8245086a7235c3e775e323926ab5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/chat_history.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/chat_sessions.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/chat_sessions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0da24c5e00fb75099df6cd002305298c90bb6e4b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/chat_sessions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/env.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/env.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ae77f6a1f9a6a11b81dba5c88348d1b96f466b57
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/env.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/exceptions.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/exceptions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cd212caa7f16a766788f6719e9d6a20735d731d5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/exceptions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/globals.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/globals.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..28ebfcea1dbb9572465b4ed5d695f5b5fc118e44
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/globals.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/memory.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/memory.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..792ef319b908ee8e70e88d9f16b7b5b75582d13e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/memory.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/prompt_values.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/prompt_values.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ee006c10e7f9ce467f43153d6448b6a6aa7143c2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/prompt_values.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/retrievers.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/retrievers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..afd581f1cdeb38c7425e79fcedbf5c76c886506f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/retrievers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/stores.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/stores.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b22582cff54943cf897e45a40d0d82352a596f58
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/stores.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/sys_info.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/sys_info.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5c478bc01953a695773e5084fedd0f1e97df2a3b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/sys_info.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/tools.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/tools.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9671fdbeb587a1dac627f6a19346f9d7cce3c48b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/tools.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/__pycache__/vectorstores.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/__pycache__/vectorstores.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1f70d17fa2ebdcc6ab500a4e0b93e82247f61d95
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/__pycache__/vectorstores.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/_api/__init__.py b/llm/Lib/site-packages/langchain_core/_api/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..57a94aa472adaf5f6d23aaddda2a141d935c4547
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/_api/__init__.py
@@ -0,0 +1,38 @@
+"""Helper functions for managing the LangChain API.
+
+This module is only relevant for LangChain developers, not for users.
+
+.. warning::
+
+    This module and its submodules are for internal use only.  Do not use them
+    in your own code.  We may change the API at any time with no warning.
+
+"""
+from .beta_decorator import (
+    LangChainBetaWarning,
+    beta,
+    suppress_langchain_beta_warning,
+    surface_langchain_beta_warnings,
+)
+from .deprecation import (
+    LangChainDeprecationWarning,
+    deprecated,
+    suppress_langchain_deprecation_warning,
+    surface_langchain_deprecation_warnings,
+    warn_deprecated,
+)
+from .path import as_import_path, get_relative_path
+
+__all__ = [
+    "as_import_path",
+    "beta",
+    "deprecated",
+    "get_relative_path",
+    "LangChainBetaWarning",
+    "LangChainDeprecationWarning",
+    "suppress_langchain_beta_warning",
+    "surface_langchain_beta_warnings",
+    "suppress_langchain_deprecation_warning",
+    "surface_langchain_deprecation_warnings",
+    "warn_deprecated",
+]
diff --git a/llm/Lib/site-packages/langchain_core/_api/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/_api/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..df7b39b0695ea3067e28c7698e202226be90cb39
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/_api/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/_api/__pycache__/beta_decorator.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/_api/__pycache__/beta_decorator.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9b7835764918deb8d3d653289e0172376cb02531
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/_api/__pycache__/beta_decorator.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/_api/__pycache__/deprecation.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/_api/__pycache__/deprecation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..563a2395316d3d31f9dd8c2689b81a018d52c8eb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/_api/__pycache__/deprecation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/_api/__pycache__/internal.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/_api/__pycache__/internal.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..090559eacf39c43b7275bccaa2b7c7fb4e99a444
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/_api/__pycache__/internal.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/_api/__pycache__/path.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/_api/__pycache__/path.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ad10be833b58501edaea6ec6b81363c988c98708
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/_api/__pycache__/path.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/_api/beta_decorator.py b/llm/Lib/site-packages/langchain_core/_api/beta_decorator.py
new file mode 100644
index 0000000000000000000000000000000000000000..280c1c99c2709375ed5f66a43c91a99b70b16359
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/_api/beta_decorator.py
@@ -0,0 +1,293 @@
+"""Helper functions for marking parts of the LangChain API as beta.
+
+This module was loosely adapted from matplotlibs _api/deprecation.py module:
+
+https://github.com/matplotlib/matplotlib/blob/main/lib/matplotlib/_api/deprecation.py
+
+.. warning::
+
+    This module is for internal use only.  Do not use it in your own code.
+    We may change the API at any time with no warning.
+"""
+
+import contextlib
+import functools
+import inspect
+import warnings
+from typing import Any, Callable, Generator, Type, TypeVar, Union, cast
+
+from langchain_core._api.internal import is_caller_internal
+
+
+class LangChainBetaWarning(DeprecationWarning):
+    """A class for issuing beta warnings for LangChain users."""
+
+
+# PUBLIC API
+
+
+T = TypeVar("T", bound=Union[Callable[..., Any], Type])
+
+
+def beta(
+    *,
+    message: str = "",
+    name: str = "",
+    obj_type: str = "",
+    addendum: str = "",
+) -> Callable[[T], T]:
+    """Decorator to mark a function, a class, or a property as beta.
+
+    When marking a classmethod, a staticmethod, or a property, the
+    ``@beta`` decorator should go *under* ``@classmethod`` and
+    ``@staticmethod`` (i.e., `beta` should directly decorate the
+    underlying callable), but *over* ``@property``.
+
+    When marking a class ``C`` intended to be used as a base class in a
+    multiple inheritance hierarchy, ``C`` *must* define an ``__init__`` method
+    (if ``C`` instead inherited its ``__init__`` from its own base class, then
+    ``@beta`` would mess up ``__init__`` inheritance when installing its
+    own (annotation-emitting) ``C.__init__``).
+
+    Arguments:
+        message : str, optional
+            Override the default beta message. The %(since)s,
+            %(name)s, %(alternative)s, %(obj_type)s, %(addendum)s,
+            and %(removal)s format specifiers will be replaced by the
+            values of the respective arguments passed to this function.
+        name : str, optional
+            The name of the beta object.
+        obj_type : str, optional
+            The object type being beta.
+        addendum : str, optional
+            Additional text appended directly to the final message.
+
+    Examples
+    --------
+
+        .. code-block:: python
+
+            @beta
+            def the_function_to_annotate():
+                pass
+    """
+
+    def beta(
+        obj: T,
+        *,
+        _obj_type: str = obj_type,
+        _name: str = name,
+        _message: str = message,
+        _addendum: str = addendum,
+    ) -> T:
+        """Implementation of the decorator returned by `beta`."""
+
+        def emit_warning() -> None:
+            """Emit the warning."""
+            warn_beta(
+                message=_message,
+                name=_name,
+                obj_type=_obj_type,
+                addendum=_addendum,
+            )
+
+        warned = False
+
+        def warning_emitting_wrapper(*args: Any, **kwargs: Any) -> Any:
+            """Wrapper for the original wrapped callable that emits a warning.
+
+            Args:
+                *args: The positional arguments to the function.
+                **kwargs: The keyword arguments to the function.
+
+            Returns:
+                The return value of the function being wrapped.
+            """
+            nonlocal warned
+            if not warned and not is_caller_internal():
+                warned = True
+                emit_warning()
+            return wrapped(*args, **kwargs)
+
+        async def awarning_emitting_wrapper(*args: Any, **kwargs: Any) -> Any:
+            """Same as warning_emitting_wrapper, but for async functions."""
+            nonlocal warned
+            if not warned and not is_caller_internal():
+                warned = True
+                emit_warning()
+            return await wrapped(*args, **kwargs)
+
+        if isinstance(obj, type):
+            if not _obj_type:
+                _obj_type = "class"
+            wrapped = obj.__init__  # type: ignore
+            _name = _name or obj.__name__
+            old_doc = obj.__doc__
+
+            def finalize(wrapper: Callable[..., Any], new_doc: str) -> T:
+                """Finalize the annotation of a class."""
+                try:
+                    obj.__doc__ = new_doc
+                except AttributeError:  # Can't set on some extension objects.
+                    pass
+
+                def warn_if_direct_instance(
+                    self: Any, *args: Any, **kwargs: Any
+                ) -> Any:
+                    """Warn that the class is in beta."""
+                    nonlocal warned
+                    if not warned and type(self) is obj and not is_caller_internal():
+                        warned = True
+                        emit_warning()
+                    return wrapped(self, *args, **kwargs)
+
+                obj.__init__ = functools.wraps(obj.__init__)(  # type: ignore[misc]
+                    warn_if_direct_instance
+                )
+                return cast(T, obj)
+
+        elif isinstance(obj, property):
+            if not _obj_type:
+                _obj_type = "attribute"
+            wrapped = None
+            _name = _name or obj.fget.__name__
+            old_doc = obj.__doc__
+
+            class _beta_property(property):
+                """A beta property."""
+
+                def __init__(self, fget=None, fset=None, fdel=None, doc=None):
+                    super().__init__(fget, fset, fdel, doc)
+                    self.__orig_fget = fget
+                    self.__orig_fset = fset
+                    self.__orig_fdel = fdel
+
+                def __get__(self, instance, owner=None):
+                    if instance is not None or owner is not None:
+                        emit_warning()
+                    return self.fget(instance)
+
+                def __set__(self, instance, value):
+                    if instance is not None:
+                        emit_warning()
+                    return self.fset(instance, value)
+
+                def __delete__(self, instance):
+                    if instance is not None:
+                        emit_warning()
+                    return self.fdel(instance)
+
+                def __set_name__(self, owner, set_name):
+                    nonlocal _name
+                    if _name == "<lambda>":
+                        _name = set_name
+
+            def finalize(wrapper: Callable[..., Any], new_doc: str) -> Any:
+                """Finalize the property."""
+                return _beta_property(
+                    fget=obj.fget, fset=obj.fset, fdel=obj.fdel, doc=new_doc
+                )
+
+        else:
+            if not _obj_type:
+                _obj_type = "function"
+            wrapped = obj
+            _name = _name or obj.__name__
+            old_doc = wrapped.__doc__
+
+            def finalize(wrapper: Callable[..., Any], new_doc: str) -> T:
+                """Wrap the wrapped function using the wrapper and update the docstring.
+
+                Args:
+                    wrapper: The wrapper function.
+                    new_doc: The new docstring.
+
+                Returns:
+                    The wrapped function.
+                """
+                wrapper = functools.wraps(wrapped)(wrapper)
+                wrapper.__doc__ = new_doc
+                return cast(T, wrapper)
+
+        old_doc = inspect.cleandoc(old_doc or "").strip("\n")
+
+        # old_doc can be None
+        if not old_doc:
+            old_doc = ""
+
+        # Modify the docstring to include a beta notice.
+        notes_header = "\nNotes\n-----"
+        components = [
+            message,
+            addendum,
+        ]
+        details = " ".join([component.strip() for component in components if component])
+        new_doc = (
+            f"[*Beta*] {old_doc}\n"
+            f"{notes_header if notes_header not in old_doc else ''}\n"
+            f".. beta::\n"
+            f"   {details}"
+        )
+
+        if inspect.iscoroutinefunction(obj):
+            finalized = finalize(awarning_emitting_wrapper, new_doc)
+        else:
+            finalized = finalize(warning_emitting_wrapper, new_doc)
+        return cast(T, finalized)
+
+    return beta
+
+
+@contextlib.contextmanager
+def suppress_langchain_beta_warning() -> Generator[None, None, None]:
+    """Context manager to suppress LangChainDeprecationWarning."""
+    with warnings.catch_warnings():
+        warnings.simplefilter("ignore", LangChainBetaWarning)
+        yield
+
+
+def warn_beta(
+    *,
+    message: str = "",
+    name: str = "",
+    obj_type: str = "",
+    addendum: str = "",
+) -> None:
+    """Display a standardized beta annotation.
+
+    Arguments:
+        message : str, optional
+            Override the default beta message. The
+            %(name)s, %(obj_type)s, %(addendum)s
+            format specifiers will be replaced by the
+            values of the respective arguments passed to this function.
+        name : str, optional
+            The name of the annotated object.
+        obj_type : str, optional
+            The object type being annotated.
+        addendum : str, optional
+            Additional text appended directly to the final message.
+    """
+    if not message:
+        message = ""
+
+        if obj_type:
+            message += f"The {obj_type} `{name}`"
+        else:
+            message += f"`{name}`"
+
+        message += " is in beta. It is actively being worked on, so the API may change."
+
+        if addendum:
+            message += f" {addendum}"
+
+    warning = LangChainBetaWarning(message)
+    warnings.warn(warning, category=LangChainBetaWarning, stacklevel=2)
+
+
+def surface_langchain_beta_warnings() -> None:
+    """Unmute LangChain beta warnings."""
+    warnings.filterwarnings(
+        "default",
+        category=LangChainBetaWarning,
+    )
diff --git a/llm/Lib/site-packages/langchain_core/_api/deprecation.py b/llm/Lib/site-packages/langchain_core/_api/deprecation.py
new file mode 100644
index 0000000000000000000000000000000000000000..1c253d992150551257c37be5c6f04886bece6174
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/_api/deprecation.py
@@ -0,0 +1,413 @@
+"""Helper functions for deprecating parts of the LangChain API.
+
+This module was adapted from matplotlibs _api/deprecation.py module:
+
+https://github.com/matplotlib/matplotlib/blob/main/lib/matplotlib/_api/deprecation.py
+
+.. warning::
+
+    This module is for internal use only.  Do not use it in your own code.
+    We may change the API at any time with no warning.
+"""
+
+import contextlib
+import functools
+import inspect
+import warnings
+from typing import Any, Callable, Generator, Type, TypeVar, Union, cast
+
+from langchain_core._api.internal import is_caller_internal
+
+
+class LangChainDeprecationWarning(DeprecationWarning):
+    """A class for issuing deprecation warnings for LangChain users."""
+
+
+class LangChainPendingDeprecationWarning(PendingDeprecationWarning):
+    """A class for issuing deprecation warnings for LangChain users."""
+
+
+# PUBLIC API
+
+
+T = TypeVar("T", bound=Union[Type, Callable[..., Any]])
+
+
+def deprecated(
+    since: str,
+    *,
+    message: str = "",
+    name: str = "",
+    alternative: str = "",
+    alternative_import: str = "",
+    pending: bool = False,
+    obj_type: str = "",
+    addendum: str = "",
+    removal: str = "",
+    package: str = "",
+) -> Callable[[T], T]:
+    """Decorator to mark a function, a class, or a property as deprecated.
+
+    When deprecating a classmethod, a staticmethod, or a property, the
+    ``@deprecated`` decorator should go *under* ``@classmethod`` and
+    ``@staticmethod`` (i.e., `deprecated` should directly decorate the
+    underlying callable), but *over* ``@property``.
+
+    When deprecating a class ``C`` intended to be used as a base class in a
+    multiple inheritance hierarchy, ``C`` *must* define an ``__init__`` method
+    (if ``C`` instead inherited its ``__init__`` from its own base class, then
+    ``@deprecated`` would mess up ``__init__`` inheritance when installing its
+    own (deprecation-emitting) ``C.__init__``).
+
+    Parameters are the same as for `warn_deprecated`, except that *obj_type*
+    defaults to 'class' if decorating a class, 'attribute' if decorating a
+    property, and 'function' otherwise.
+
+    Arguments:
+        since : str
+            The release at which this API became deprecated.
+        message : str, optional
+            Override the default deprecation message. The %(since)s,
+            %(name)s, %(alternative)s, %(obj_type)s, %(addendum)s,
+            and %(removal)s format specifiers will be replaced by the
+            values of the respective arguments passed to this function.
+        name : str, optional
+            The name of the deprecated object.
+        alternative : str, optional
+            An alternative API that the user may use in place of the
+            deprecated API. The deprecation warning will tell the user
+            about this alternative if provided.
+        pending : bool, optional
+            If True, uses a PendingDeprecationWarning instead of a
+            DeprecationWarning. Cannot be used together with removal.
+        obj_type : str, optional
+            The object type being deprecated.
+        addendum : str, optional
+            Additional text appended directly to the final message.
+        removal : str, optional
+            The expected removal version. With the default (an empty
+            string), a removal version is automatically computed from
+            since. Set to other Falsy values to not schedule a removal
+            date. Cannot be used together with pending.
+
+    Examples
+    --------
+
+        .. code-block:: python
+
+            @deprecated('1.4.0')
+            def the_function_to_deprecate():
+                pass
+    """
+
+    def deprecate(
+        obj: T,
+        *,
+        _obj_type: str = obj_type,
+        _name: str = name,
+        _message: str = message,
+        _alternative: str = alternative,
+        _alternative_import: str = alternative_import,
+        _pending: bool = pending,
+        _addendum: str = addendum,
+        _package: str = package,
+    ) -> T:
+        """Implementation of the decorator returned by `deprecated`."""
+
+        def emit_warning() -> None:
+            """Emit the warning."""
+            warn_deprecated(
+                since,
+                message=_message,
+                name=_name,
+                alternative=_alternative,
+                alternative_import=_alternative_import,
+                pending=_pending,
+                obj_type=_obj_type,
+                addendum=_addendum,
+                removal=removal,
+                package=_package,
+            )
+
+        warned = False
+
+        def warning_emitting_wrapper(*args: Any, **kwargs: Any) -> Any:
+            """Wrapper for the original wrapped callable that emits a warning.
+
+            Args:
+                *args: The positional arguments to the function.
+                **kwargs: The keyword arguments to the function.
+
+            Returns:
+                The return value of the function being wrapped.
+            """
+            nonlocal warned
+            if not warned and not is_caller_internal():
+                warned = True
+                emit_warning()
+            return wrapped(*args, **kwargs)
+
+        async def awarning_emitting_wrapper(*args: Any, **kwargs: Any) -> Any:
+            """Same as warning_emitting_wrapper, but for async functions."""
+
+            nonlocal warned
+            if not warned and not is_caller_internal():
+                warned = True
+                emit_warning()
+            return await wrapped(*args, **kwargs)
+
+        _package = _package or obj.__module__.split(".")[0].replace("_", "-")
+
+        if isinstance(obj, type):
+            if not _obj_type:
+                _obj_type = "class"
+            wrapped = obj.__init__  # type: ignore
+            _name = _name or obj.__qualname__
+            old_doc = obj.__doc__
+
+            def finalize(wrapper: Callable[..., Any], new_doc: str) -> T:
+                """Finalize the deprecation of a class."""
+                try:
+                    obj.__doc__ = new_doc
+                except AttributeError:  # Can't set on some extension objects.
+                    pass
+
+                def warn_if_direct_instance(
+                    self: Any, *args: Any, **kwargs: Any
+                ) -> Any:
+                    """Warn that the class is in beta."""
+                    nonlocal warned
+                    if not warned and type(self) is obj and not is_caller_internal():
+                        warned = True
+                        emit_warning()
+                    return wrapped(self, *args, **kwargs)
+
+                obj.__init__ = functools.wraps(obj.__init__)(  # type: ignore[misc]
+                    warn_if_direct_instance
+                )
+                return cast(T, obj)
+
+        elif isinstance(obj, property):
+            if not _obj_type:
+                _obj_type = "attribute"
+            wrapped = None
+            _name = _name or obj.fget.__qualname__
+            old_doc = obj.__doc__
+
+            class _deprecated_property(property):
+                """A deprecated property."""
+
+                def __init__(self, fget=None, fset=None, fdel=None, doc=None):
+                    super().__init__(fget, fset, fdel, doc)
+                    self.__orig_fget = fget
+                    self.__orig_fset = fset
+                    self.__orig_fdel = fdel
+
+                def __get__(self, instance, owner=None):
+                    if instance is not None or owner is not None:
+                        emit_warning()
+                    return self.fget(instance)
+
+                def __set__(self, instance, value):
+                    if instance is not None:
+                        emit_warning()
+                    return self.fset(instance, value)
+
+                def __delete__(self, instance):
+                    if instance is not None:
+                        emit_warning()
+                    return self.fdel(instance)
+
+                def __set_name__(self, owner, set_name):
+                    nonlocal _name
+                    if _name == "<lambda>":
+                        _name = set_name
+
+            def finalize(wrapper: Callable[..., Any], new_doc: str) -> Any:
+                """Finalize the property."""
+                return _deprecated_property(
+                    fget=obj.fget, fset=obj.fset, fdel=obj.fdel, doc=new_doc
+                )
+
+        else:
+            _name = _name or obj.__qualname__
+            if not _obj_type:
+                # edge case: when a function is within another function
+                # within a test, this will call it a "method" not a "function"
+                _obj_type = "function" if "." not in _name else "method"
+            wrapped = obj
+            old_doc = wrapped.__doc__
+
+            def finalize(wrapper: Callable[..., Any], new_doc: str) -> T:
+                """Wrap the wrapped function using the wrapper and update the docstring.
+
+                Args:
+                    wrapper: The wrapper function.
+                    new_doc: The new docstring.
+
+                Returns:
+                    The wrapped function.
+                """
+                wrapper = functools.wraps(wrapped)(wrapper)
+                wrapper.__doc__ = new_doc
+                return cast(T, wrapper)
+
+        old_doc = inspect.cleandoc(old_doc or "").strip("\n")
+
+        # old_doc can be None
+        if not old_doc:
+            old_doc = ""
+
+        # Modify the docstring to include a deprecation notice.
+        notes_header = "\nNotes\n-----"
+        components = [
+            message,
+            f"Use {alternative} instead." if alternative else "",
+            addendum,
+        ]
+        details = " ".join([component.strip() for component in components if component])
+        package = (
+            _package or _name.split(".")[0].replace("_", "-") if "." in _name else None
+        )
+        since_str = f"{package}=={since}" if package else since
+        new_doc = (
+            f"[*Deprecated*] {old_doc}\n"
+            f"{notes_header if notes_header not in old_doc else ''}\n"
+            f".. deprecated:: {since_str}\n"
+            f"   {details}"
+        )
+
+        if inspect.iscoroutinefunction(obj):
+            finalized = finalize(awarning_emitting_wrapper, new_doc)
+        else:
+            finalized = finalize(warning_emitting_wrapper, new_doc)
+        return cast(T, finalized)
+
+    return deprecate
+
+
+@contextlib.contextmanager
+def suppress_langchain_deprecation_warning() -> Generator[None, None, None]:
+    """Context manager to suppress LangChainDeprecationWarning."""
+    with warnings.catch_warnings():
+        warnings.simplefilter("ignore", LangChainDeprecationWarning)
+        warnings.simplefilter("ignore", LangChainPendingDeprecationWarning)
+        yield
+
+
+def warn_deprecated(
+    since: str,
+    *,
+    message: str = "",
+    name: str = "",
+    alternative: str = "",
+    alternative_import: str = "",
+    pending: bool = False,
+    obj_type: str = "",
+    addendum: str = "",
+    removal: str = "",
+    package: str = "",
+) -> None:
+    """Display a standardized deprecation.
+
+    Arguments:
+        since : str
+            The release at which this API became deprecated.
+        message : str, optional
+            Override the default deprecation message. The %(since)s,
+            %(name)s, %(alternative)s, %(obj_type)s, %(addendum)s,
+            and %(removal)s format specifiers will be replaced by the
+            values of the respective arguments passed to this function.
+        name : str, optional
+            The name of the deprecated object.
+        alternative : str, optional
+            An alternative API that the user may use in place of the
+            deprecated API. The deprecation warning will tell the user
+            about this alternative if provided.
+        pending : bool, optional
+            If True, uses a PendingDeprecationWarning instead of a
+            DeprecationWarning. Cannot be used together with removal.
+        obj_type : str, optional
+            The object type being deprecated.
+        addendum : str, optional
+            Additional text appended directly to the final message.
+        removal : str, optional
+            The expected removal version. With the default (an empty
+            string), a removal version is automatically computed from
+            since. Set to other Falsy values to not schedule a removal
+            date. Cannot be used together with pending.
+    """
+    if pending and removal:
+        raise ValueError("A pending deprecation cannot have a scheduled removal")
+    if alternative and alternative_import:
+        raise ValueError("Cannot specify both alternative and alternative_import")
+    if alternative_import and "." not in alternative_import:
+        raise ValueError("alternative_import must be a fully qualified module path")
+
+    if not pending:
+        if not removal:
+            removal = f"in {removal}" if removal else "within ?? minor releases"
+            raise NotImplementedError(
+                f"Need to determine which default deprecation schedule to use. "
+                f"{removal}"
+            )
+        else:
+            removal = f"in {removal}"
+
+    if not message:
+        message = ""
+        _package = (
+            package or name.split(".")[0].replace("_", "-")
+            if "." in name
+            else "LangChain"
+        )
+
+        if obj_type:
+            message += f"The {obj_type} `{name}`"
+        else:
+            message += f"`{name}`"
+
+        if pending:
+            message += " will be deprecated in a future version"
+        else:
+            message += f" was deprecated in {_package} {since}"
+
+            if removal:
+                message += f" and will be removed {removal}"
+
+        if alternative_import:
+            alt_package = alternative_import.split(".")[0].replace("_", "-")
+            if alt_package == _package:
+                message += f". Use {alternative_import} instead."
+            else:
+                alt_module, alt_name = alternative_import.rsplit(".", 1)
+                message += (
+                    f". An updated version of the {obj_type} exists in the "
+                    f"{alt_package} package and should be used instead. To use it run "
+                    f"`pip install -U {alt_package}` and import as "
+                    f"`from {alt_module} import {alt_name}`."
+                )
+        elif alternative:
+            message += f". Use {alternative} instead."
+
+        if addendum:
+            message += f" {addendum}"
+
+    warning_cls = (
+        LangChainPendingDeprecationWarning if pending else LangChainDeprecationWarning
+    )
+    warning = warning_cls(message)
+    warnings.warn(warning, category=LangChainDeprecationWarning, stacklevel=2)
+
+
+def surface_langchain_deprecation_warnings() -> None:
+    """Unmute LangChain deprecation warnings."""
+    warnings.filterwarnings(
+        "default",
+        category=LangChainPendingDeprecationWarning,
+    )
+
+    warnings.filterwarnings(
+        "default",
+        category=LangChainDeprecationWarning,
+    )
diff --git a/llm/Lib/site-packages/langchain_core/_api/internal.py b/llm/Lib/site-packages/langchain_core/_api/internal.py
new file mode 100644
index 0000000000000000000000000000000000000000..0dca40ad668a891755b9ac395bdb8842f874bd2c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/_api/internal.py
@@ -0,0 +1,23 @@
+import inspect
+
+
+def is_caller_internal(depth: int = 2) -> bool:
+    """Return whether the caller at `depth` of this function is internal."""
+    try:
+        frame = inspect.currentframe()
+    except AttributeError:
+        return False
+    if frame is None:
+        return False
+    try:
+        for _ in range(depth):
+            frame = frame.f_back
+            if frame is None:
+                return False
+        caller_module = inspect.getmodule(frame)
+        if caller_module is None:
+            return False
+        caller_module_name = caller_module.__name__
+        return caller_module_name.startswith("langchain")
+    finally:
+        del frame
diff --git a/llm/Lib/site-packages/langchain_core/_api/path.py b/llm/Lib/site-packages/langchain_core/_api/path.py
new file mode 100644
index 0000000000000000000000000000000000000000..0589ae44956980bf74d2a07299408175486f6277
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/_api/path.py
@@ -0,0 +1,36 @@
+import os
+from pathlib import Path
+from typing import Optional, Union
+
+HERE = Path(__file__).parent
+
+# Get directory of langchain package
+PACKAGE_DIR = HERE.parent
+SEPARATOR = os.sep
+
+
+def get_relative_path(
+    file: Union[Path, str], *, relative_to: Path = PACKAGE_DIR
+) -> str:
+    """Get the path of the file as a relative path to the package directory."""
+    if isinstance(file, str):
+        file = Path(file)
+    return str(file.relative_to(relative_to))
+
+
+def as_import_path(
+    file: Union[Path, str],
+    *,
+    suffix: Optional[str] = None,
+    relative_to: Path = PACKAGE_DIR,
+) -> str:
+    """Path of the file as a LangChain import exclude langchain top namespace."""
+    if isinstance(file, str):
+        file = Path(file)
+    path = get_relative_path(file, relative_to=relative_to)
+    if file.is_file():
+        path = path[: -len(file.suffix)]
+    import_path = path.replace(SEPARATOR, ".")
+    if suffix:
+        import_path += "." + suffix
+    return import_path
diff --git a/llm/Lib/site-packages/langchain_core/agents.py b/llm/Lib/site-packages/langchain_core/agents.py
new file mode 100644
index 0000000000000000000000000000000000000000..105587ae8da53bd60170be7e87a6612a37938471
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/agents.py
@@ -0,0 +1,205 @@
+"""
+**Agent** is a class that uses an LLM to choose a sequence of actions to take.
+
+In Chains, a sequence of actions is hardcoded. In Agents,
+a language model is used as a reasoning engine to determine which actions
+to take and in which order.
+
+Agents select and use **Tools** and **Toolkits** for actions.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseSingleActionAgent --> LLMSingleActionAgent
+                              OpenAIFunctionsAgent
+                              XMLAgent
+                              Agent --> <name>Agent  # Examples: ZeroShotAgent, ChatAgent
+
+
+    BaseMultiActionAgent  --> OpenAIMultiFunctionsAgent
+
+
+**Main helpers:**
+
+.. code-block::
+
+    AgentType, AgentExecutor, AgentOutputParser, AgentExecutorIterator,
+    AgentAction, AgentFinish, AgentStep
+
+"""  # noqa: E501
+from __future__ import annotations
+
+import json
+from typing import Any, List, Literal, Sequence, Union
+
+from langchain_core.load.serializable import Serializable
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    FunctionMessage,
+    HumanMessage,
+)
+
+
+class AgentAction(Serializable):
+    """A full description of an action for an ActionAgent to execute."""
+
+    tool: str
+    """The name of the Tool to execute."""
+    tool_input: Union[str, dict]
+    """The input to pass in to the Tool."""
+    log: str
+    """Additional information to log about the action.
+    This log can be used in a few ways. First, it can be used to audit
+    what exactly the LLM predicted to lead to this (tool, tool_input).
+    Second, it can be used in future iterations to show the LLMs prior
+    thoughts. This is useful when (tool, tool_input) does not contain
+    full information about the LLM prediction (for example, any `thought`
+    before the tool/tool_input)."""
+    type: Literal["AgentAction"] = "AgentAction"
+
+    def __init__(
+        self, tool: str, tool_input: Union[str, dict], log: str, **kwargs: Any
+    ):
+        """Override init to support instantiation by position for backward compat."""
+        super().__init__(tool=tool, tool_input=tool_input, log=log, **kwargs)
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether or not the class is serializable."""
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "agent"]
+
+    @property
+    def messages(self) -> Sequence[BaseMessage]:
+        """Return the messages that correspond to this action."""
+        return _convert_agent_action_to_messages(self)
+
+
+class AgentActionMessageLog(AgentAction):
+    message_log: Sequence[BaseMessage]
+    """Similar to log, this can be used to pass along extra
+    information about what exact messages were predicted by the LLM
+    before parsing out the (tool, tool_input). This is again useful
+    if (tool, tool_input) cannot be used to fully recreate the LLM
+    prediction, and you need that LLM prediction (for future agent iteration).
+    Compared to `log`, this is useful when the underlying LLM is a
+    ChatModel (and therefore returns messages rather than a string)."""
+    # Ignoring type because we're overriding the type from AgentAction.
+    # And this is the correct thing to do in this case.
+    # The type literal is used for serialization purposes.
+    type: Literal["AgentActionMessageLog"] = "AgentActionMessageLog"  # type: ignore
+
+
+class AgentStep(Serializable):
+    """The result of running an AgentAction."""
+
+    action: AgentAction
+    """The AgentAction that was executed."""
+    observation: Any
+    """The result of the AgentAction."""
+
+    @property
+    def messages(self) -> Sequence[BaseMessage]:
+        """Return the messages that correspond to this observation."""
+        return _convert_agent_observation_to_messages(self.action, self.observation)
+
+
+class AgentFinish(Serializable):
+    """The final return value of an ActionAgent."""
+
+    return_values: dict
+    """Dictionary of return values."""
+    log: str
+    """Additional information to log about the return value.
+    This is used to pass along the full LLM prediction, not just the parsed out
+    return value. For example, if the full LLM prediction was
+    `Final Answer: 2` you may want to just return `2` as a return value, but pass
+    along the full string as a `log` (for debugging or observability purposes).
+    """
+    type: Literal["AgentFinish"] = "AgentFinish"
+
+    def __init__(self, return_values: dict, log: str, **kwargs: Any):
+        """Override init to support instantiation by position for backward compat."""
+        super().__init__(return_values=return_values, log=log, **kwargs)
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether or not the class is serializable."""
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "agent"]
+
+    @property
+    def messages(self) -> Sequence[BaseMessage]:
+        """Return the messages that correspond to this observation."""
+        return [AIMessage(content=self.log)]
+
+
+def _convert_agent_action_to_messages(
+    agent_action: AgentAction,
+) -> Sequence[BaseMessage]:
+    """Convert an agent action to a message.
+
+    This code is used to reconstruct the original AI message from the agent action.
+
+    Args:
+        agent_action: Agent action to convert.
+
+    Returns:
+        AIMessage that corresponds to the original tool invocation.
+    """
+    if isinstance(agent_action, AgentActionMessageLog):
+        return agent_action.message_log
+    else:
+        return [AIMessage(content=agent_action.log)]
+
+
+def _convert_agent_observation_to_messages(
+    agent_action: AgentAction, observation: Any
+) -> Sequence[BaseMessage]:
+    """Convert an agent action to a message.
+
+    This code is used to reconstruct the original AI message from the agent action.
+
+    Args:
+        agent_action: Agent action to convert.
+
+    Returns:
+        AIMessage that corresponds to the original tool invocation.
+    """
+    if isinstance(agent_action, AgentActionMessageLog):
+        return [_create_function_message(agent_action, observation)]
+    else:
+        return [HumanMessage(content=observation)]
+
+
+def _create_function_message(
+    agent_action: AgentAction, observation: Any
+) -> FunctionMessage:
+    """Convert agent action and observation into a function message.
+    Args:
+        agent_action: the tool invocation request from the agent
+        observation: the result of the tool invocation
+    Returns:
+        FunctionMessage that corresponds to the original tool invocation
+    """
+    if not isinstance(observation, str):
+        try:
+            content = json.dumps(observation, ensure_ascii=False)
+        except Exception:
+            content = str(observation)
+    else:
+        content = observation
+    return FunctionMessage(
+        name=agent_action.tool,
+        content=content,
+    )
diff --git a/llm/Lib/site-packages/langchain_core/beta/__init__.py b/llm/Lib/site-packages/langchain_core/beta/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7f79e3a449ee153bffb31d8c5fd933cad57191fb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/beta/__init__.py
@@ -0,0 +1 @@
+"""Some **beta** features that are not yet ready for production."""
diff --git a/llm/Lib/site-packages/langchain_core/beta/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/beta/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0e9d33984f40c2a5961e66c11b2dc56d996ed154
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/beta/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/beta/runnables/__init__.py b/llm/Lib/site-packages/langchain_core/beta/runnables/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_core/beta/runnables/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/beta/runnables/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e122b4ae11c6b37d1febc9698aebe16ba2fad734
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/beta/runnables/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/beta/runnables/__pycache__/context.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/beta/runnables/__pycache__/context.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fbb5188f38a3a3181699448d6dc31cbfd589e579
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/beta/runnables/__pycache__/context.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/beta/runnables/context.py b/llm/Lib/site-packages/langchain_core/beta/runnables/context.py
new file mode 100644
index 0000000000000000000000000000000000000000..13767e352dd5a0fb1284f52ef088cc614950cfa0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/beta/runnables/context.py
@@ -0,0 +1,402 @@
+import asyncio
+import threading
+from collections import defaultdict
+from functools import partial
+from itertools import groupby
+from typing import (
+    Any,
+    Awaitable,
+    Callable,
+    DefaultDict,
+    Dict,
+    List,
+    Mapping,
+    Optional,
+    Sequence,
+    Type,
+    TypeVar,
+    Union,
+)
+
+from langchain_core._api.beta_decorator import beta
+from langchain_core.runnables.base import (
+    Runnable,
+    RunnableSerializable,
+    coerce_to_runnable,
+)
+from langchain_core.runnables.config import RunnableConfig, ensure_config, patch_config
+from langchain_core.runnables.utils import ConfigurableFieldSpec, Input, Output
+
+T = TypeVar("T")
+Values = Dict[Union[asyncio.Event, threading.Event], Any]
+CONTEXT_CONFIG_PREFIX = "__context__/"
+CONTEXT_CONFIG_SUFFIX_GET = "/get"
+CONTEXT_CONFIG_SUFFIX_SET = "/set"
+
+
+async def _asetter(done: asyncio.Event, values: Values, value: T) -> T:
+    values[done] = value
+    done.set()
+    return value
+
+
+async def _agetter(done: asyncio.Event, values: Values) -> Any:
+    await done.wait()
+    return values[done]
+
+
+def _setter(done: threading.Event, values: Values, value: T) -> T:
+    values[done] = value
+    done.set()
+    return value
+
+
+def _getter(done: threading.Event, values: Values) -> Any:
+    done.wait()
+    return values[done]
+
+
+def _key_from_id(id_: str) -> str:
+    wout_prefix = id_.split(CONTEXT_CONFIG_PREFIX, maxsplit=1)[1]
+    if wout_prefix.endswith(CONTEXT_CONFIG_SUFFIX_GET):
+        return wout_prefix[: -len(CONTEXT_CONFIG_SUFFIX_GET)]
+    elif wout_prefix.endswith(CONTEXT_CONFIG_SUFFIX_SET):
+        return wout_prefix[: -len(CONTEXT_CONFIG_SUFFIX_SET)]
+    else:
+        raise ValueError(f"Invalid context config id {id_}")
+
+
+def _config_with_context(
+    config: RunnableConfig,
+    steps: List[Runnable],
+    setter: Callable,
+    getter: Callable,
+    event_cls: Union[Type[threading.Event], Type[asyncio.Event]],
+) -> RunnableConfig:
+    if any(k.startswith(CONTEXT_CONFIG_PREFIX) for k in config.get("configurable", {})):
+        return config
+
+    context_specs = [
+        (spec, i)
+        for i, step in enumerate(steps)
+        for spec in step.config_specs
+        if spec.id.startswith(CONTEXT_CONFIG_PREFIX)
+    ]
+    grouped_by_key = {
+        key: list(group)
+        for key, group in groupby(
+            sorted(context_specs, key=lambda s: s[0].id),
+            key=lambda s: _key_from_id(s[0].id),
+        )
+    }
+    deps_by_key = {
+        key: set(
+            _key_from_id(dep) for spec in group for dep in (spec[0].dependencies or [])
+        )
+        for key, group in grouped_by_key.items()
+    }
+
+    values: Values = {}
+    events: DefaultDict[str, Union[asyncio.Event, threading.Event]] = defaultdict(
+        event_cls
+    )
+    context_funcs: Dict[str, Callable[[], Any]] = {}
+    for key, group in grouped_by_key.items():
+        getters = [s for s in group if s[0].id.endswith(CONTEXT_CONFIG_SUFFIX_GET)]
+        setters = [s for s in group if s[0].id.endswith(CONTEXT_CONFIG_SUFFIX_SET)]
+
+        for dep in deps_by_key[key]:
+            if key in deps_by_key[dep]:
+                raise ValueError(
+                    f"Deadlock detected between context keys {key} and {dep}"
+                )
+        if len(setters) != 1:
+            raise ValueError(f"Expected exactly one setter for context key {key}")
+        setter_idx = setters[0][1]
+        if any(getter_idx < setter_idx for _, getter_idx in getters):
+            raise ValueError(
+                f"Context setter for key {key} must be defined after all getters."
+            )
+
+        if getters:
+            context_funcs[getters[0][0].id] = partial(getter, events[key], values)
+        context_funcs[setters[0][0].id] = partial(setter, events[key], values)
+
+    return patch_config(config, configurable=context_funcs)
+
+
+def aconfig_with_context(
+    config: RunnableConfig,
+    steps: List[Runnable],
+) -> RunnableConfig:
+    """Asynchronously patch a runnable config with context getters and setters.
+
+    Args:
+        config: The runnable config.
+        steps: The runnable steps.
+
+    Returns:
+        The patched runnable config.
+    """
+    return _config_with_context(config, steps, _asetter, _agetter, asyncio.Event)
+
+
+def config_with_context(
+    config: RunnableConfig,
+    steps: List[Runnable],
+) -> RunnableConfig:
+    """Patch a runnable config with context getters and setters.
+
+    Args:
+        config: The runnable config.
+        steps: The runnable steps.
+
+    Returns:
+        The patched runnable config.
+    """
+    return _config_with_context(config, steps, _setter, _getter, threading.Event)
+
+
+@beta()
+class ContextGet(RunnableSerializable):
+    """Get a context value."""
+
+    prefix: str = ""
+
+    key: Union[str, List[str]]
+
+    def __str__(self) -> str:
+        return f"ContextGet({_print_keys(self.key)})"
+
+    @property
+    def ids(self) -> List[str]:
+        prefix = self.prefix + "/" if self.prefix else ""
+        keys = self.key if isinstance(self.key, list) else [self.key]
+        return [
+            f"{CONTEXT_CONFIG_PREFIX}{prefix}{k}{CONTEXT_CONFIG_SUFFIX_GET}"
+            for k in keys
+        ]
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        return super().config_specs + [
+            ConfigurableFieldSpec(
+                id=id_,
+                annotation=Callable[[], Any],
+            )
+            for id_ in self.ids
+        ]
+
+    def invoke(self, input: Any, config: Optional[RunnableConfig] = None) -> Any:
+        config = ensure_config(config)
+        configurable = config.get("configurable", {})
+        if isinstance(self.key, list):
+            return {key: configurable[id_]() for key, id_ in zip(self.key, self.ids)}
+        else:
+            return configurable[self.ids[0]]()
+
+    async def ainvoke(
+        self, input: Any, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> Any:
+        config = ensure_config(config)
+        configurable = config.get("configurable", {})
+        if isinstance(self.key, list):
+            values = await asyncio.gather(*(configurable[id_]() for id_ in self.ids))
+            return {key: value for key, value in zip(self.key, values)}
+        else:
+            return await configurable[self.ids[0]]()
+
+
+SetValue = Union[
+    Runnable[Input, Output],
+    Callable[[Input], Output],
+    Callable[[Input], Awaitable[Output]],
+    Any,
+]
+
+
+def _coerce_set_value(value: SetValue) -> Runnable[Input, Output]:
+    if not isinstance(value, Runnable) and not callable(value):
+        return coerce_to_runnable(lambda _: value)
+    return coerce_to_runnable(value)
+
+
+@beta()
+class ContextSet(RunnableSerializable):
+    """Set a context value."""
+
+    prefix: str = ""
+
+    keys: Mapping[str, Optional[Runnable]]
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    def __init__(
+        self,
+        key: Optional[str] = None,
+        value: Optional[SetValue] = None,
+        prefix: str = "",
+        **kwargs: SetValue,
+    ):
+        if key is not None:
+            kwargs[key] = value
+        super().__init__(  # type: ignore[call-arg]
+            keys={
+                k: _coerce_set_value(v) if v is not None else None
+                for k, v in kwargs.items()
+            },
+            prefix=prefix,
+        )
+
+    def __str__(self) -> str:
+        return f"ContextSet({_print_keys(list(self.keys.keys()))})"
+
+    @property
+    def ids(self) -> List[str]:
+        prefix = self.prefix + "/" if self.prefix else ""
+        return [
+            f"{CONTEXT_CONFIG_PREFIX}{prefix}{key}{CONTEXT_CONFIG_SUFFIX_SET}"
+            for key in self.keys
+        ]
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        mapper_config_specs = [
+            s
+            for mapper in self.keys.values()
+            if mapper is not None
+            for s in mapper.config_specs
+        ]
+        for spec in mapper_config_specs:
+            if spec.id.endswith(CONTEXT_CONFIG_SUFFIX_GET):
+                getter_key = spec.id.split("/")[1]
+                if getter_key in self.keys:
+                    raise ValueError(
+                        f"Circular reference in context setter for key {getter_key}"
+                    )
+        return super().config_specs + [
+            ConfigurableFieldSpec(
+                id=id_,
+                annotation=Callable[[], Any],
+            )
+            for id_ in self.ids
+        ]
+
+    def invoke(self, input: Any, config: Optional[RunnableConfig] = None) -> Any:
+        config = ensure_config(config)
+        configurable = config.get("configurable", {})
+        for id_, mapper in zip(self.ids, self.keys.values()):
+            if mapper is not None:
+                configurable[id_](mapper.invoke(input, config))
+            else:
+                configurable[id_](input)
+        return input
+
+    async def ainvoke(
+        self, input: Any, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> Any:
+        config = ensure_config(config)
+        configurable = config.get("configurable", {})
+        for id_, mapper in zip(self.ids, self.keys.values()):
+            if mapper is not None:
+                await configurable[id_](await mapper.ainvoke(input, config))
+            else:
+                await configurable[id_](input)
+        return input
+
+
+class Context:
+    """
+    Context for a runnable.
+
+    The `Context` class provides methods for creating context scopes,
+    getters, and setters within a runnable. It allows for managing
+    and accessing contextual information throughout the execution
+    of a program.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_core.beta.runnables.context import Context
+            from langchain_core.runnables.passthrough import RunnablePassthrough
+            from langchain_core.prompts.prompt import PromptTemplate
+            from langchain_core.output_parsers.string import StrOutputParser
+            from tests.unit_tests.fake.llm import FakeListLLM
+
+            chain = (
+                Context.setter("input")
+                | {
+                    "context": RunnablePassthrough()
+                            | Context.setter("context"),
+                    "question": RunnablePassthrough(),
+                }
+                | PromptTemplate.from_template("{context} {question}")
+                | FakeListLLM(responses=["hello"])
+                | StrOutputParser()
+                | {
+                    "result": RunnablePassthrough(),
+                    "context": Context.getter("context"),
+                    "input": Context.getter("input"),
+                }
+            )
+
+            # Use the chain
+            output = chain.invoke("What's your name?")
+            print(output["result"])  # Output: "hello"
+            print(output["context"])  # Output: "What's your name?"
+            print(output["input"])  # Output: "What's your name?
+    """
+
+    @staticmethod
+    def create_scope(scope: str, /) -> "PrefixContext":
+        """Create a context scope.
+
+        Args:
+            scope: The scope.
+
+        Returns:
+            The context scope.
+        """
+        return PrefixContext(prefix=scope)
+
+    @staticmethod
+    def getter(key: Union[str, List[str]], /) -> ContextGet:
+        return ContextGet(key=key)
+
+    @staticmethod
+    def setter(
+        _key: Optional[str] = None,
+        _value: Optional[SetValue] = None,
+        /,
+        **kwargs: SetValue,
+    ) -> ContextSet:
+        return ContextSet(_key, _value, prefix="", **kwargs)
+
+
+class PrefixContext:
+    """Context for a runnable with a prefix."""
+
+    prefix: str = ""
+
+    def __init__(self, prefix: str = ""):
+        self.prefix = prefix
+
+    def getter(self, key: Union[str, List[str]], /) -> ContextGet:
+        return ContextGet(key=key, prefix=self.prefix)
+
+    def setter(
+        self,
+        _key: Optional[str] = None,
+        _value: Optional[SetValue] = None,
+        /,
+        **kwargs: SetValue,
+    ) -> ContextSet:
+        return ContextSet(_key, _value, prefix=self.prefix, **kwargs)
+
+
+def _print_keys(keys: Union[str, Sequence[str]]) -> str:
+    if isinstance(keys, str):
+        return f"'{keys}'"
+    else:
+        return ", ".join(f"'{k}'" for k in keys)
diff --git a/llm/Lib/site-packages/langchain_core/caches.py b/llm/Lib/site-packages/langchain_core/caches.py
new file mode 100644
index 0000000000000000000000000000000000000000..4c494c4fbc84950aed84326c2ffd9e74f0eace39
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/caches.py
@@ -0,0 +1,107 @@
+"""
+.. warning::
+  Beta Feature!
+
+**Cache** provides an optional caching layer for LLMs.
+
+Cache is useful for two reasons:
+
+- It can save you money by reducing the number of API calls you make to the LLM
+  provider if you're often requesting the same completion multiple times.
+- It can speed up your application by reducing the number of API calls you make
+  to the LLM provider.
+
+Cache directly competes with Memory. See documentation for Pros and Cons.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseCache --> <name>Cache  # Examples: InMemoryCache, RedisCache, GPTCache
+"""
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import Any, Optional, Sequence
+
+from langchain_core.outputs import Generation
+from langchain_core.runnables import run_in_executor
+
+RETURN_VAL_TYPE = Sequence[Generation]
+
+
+class BaseCache(ABC):
+    """This interfaces provides a caching layer for LLMs and Chat models.
+
+    The cache interface consists of the following methods:
+
+    - lookup: Look up a value based on a prompt and llm_string.
+    - update: Update the cache based on a prompt and llm_string.
+    - clear: Clear the cache.
+
+    In addition, the cache interface provides an async version of each method.
+
+    The default implementation of the async methods is to run the synchronous
+    method in an executor. It's recommended to override the async methods
+    and provide an async implementations to avoid unnecessary overhead.
+    """
+
+    @abstractmethod
+    def lookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Look up based on prompt and llm_string.
+
+        A cache implementation is expected to generate a key from the 2-tuple
+        of prompt and llm_string (e.g., by concatenating them with a delimiter).
+
+        Args:
+            prompt: a string representation of the prompt.
+                    In the case of a Chat model, the prompt is a non-trivial
+                    serialization of the prompt into the language model.
+            llm_string: A string representation of the LLM configuration.
+                This is used to capture the invocation parameters of the LLM
+                (e.g., model name, temperature, stop tokens, max tokens, etc.).
+                These invocation parameters are serialized into a string
+                representation.
+
+        Returns:
+            On a cache miss, return None. On a cache hit, return the cached value.
+            The cached value is a list of Generations (or subclasses).
+        """
+
+    @abstractmethod
+    def update(self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE) -> None:
+        """Update cache based on prompt and llm_string.
+
+        The prompt and llm_string are used to generate a key for the cache.
+        The key should match that of the look up method.
+
+        Args:
+            prompt: a string representation of the prompt.
+                    In the case of a Chat model, the prompt is a non-trivial
+                    serialization of the prompt into the language model.
+            llm_string: A string representation of the LLM configuration.
+                This is used to capture the invocation parameters of the LLM
+                (e.g., model name, temperature, stop tokens, max tokens, etc.).
+                These invocation parameters are serialized into a string
+                representation.
+            return_val: The value to be cached. The value is a list of Generations
+                (or subclasses).
+        """
+
+    @abstractmethod
+    def clear(self, **kwargs: Any) -> None:
+        """Clear cache that can take additional keyword arguments."""
+
+    async def alookup(self, prompt: str, llm_string: str) -> Optional[RETURN_VAL_TYPE]:
+        """Async version of lookup."""
+        return await run_in_executor(None, self.lookup, prompt, llm_string)
+
+    async def aupdate(
+        self, prompt: str, llm_string: str, return_val: RETURN_VAL_TYPE
+    ) -> None:
+        """Async version of aupdate."""
+        return await run_in_executor(None, self.update, prompt, llm_string, return_val)
+
+    async def aclear(self, **kwargs: Any) -> None:
+        """Clear cache that can take additional keyword arguments."""
+        return await run_in_executor(None, self.clear, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_core/callbacks/__init__.py b/llm/Lib/site-packages/langchain_core/callbacks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..65df88d69e58e060875ca1cdc31c610757c44975
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/callbacks/__init__.py
@@ -0,0 +1,75 @@
+"""**Callback handlers** allow listening to events in LangChain.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseCallbackHandler --> <name>CallbackHandler  # Example: AimCallbackHandler
+"""
+from langchain_core.callbacks.base import (
+    AsyncCallbackHandler,
+    BaseCallbackHandler,
+    BaseCallbackManager,
+    CallbackManagerMixin,
+    Callbacks,
+    ChainManagerMixin,
+    LLMManagerMixin,
+    RetrieverManagerMixin,
+    RunManagerMixin,
+    ToolManagerMixin,
+)
+from langchain_core.callbacks.file import FileCallbackHandler
+from langchain_core.callbacks.manager import (
+    AsyncCallbackManager,
+    AsyncCallbackManagerForChainGroup,
+    AsyncCallbackManagerForChainRun,
+    AsyncCallbackManagerForLLMRun,
+    AsyncCallbackManagerForRetrieverRun,
+    AsyncCallbackManagerForToolRun,
+    AsyncParentRunManager,
+    AsyncRunManager,
+    BaseRunManager,
+    CallbackManager,
+    CallbackManagerForChainGroup,
+    CallbackManagerForChainRun,
+    CallbackManagerForLLMRun,
+    CallbackManagerForRetrieverRun,
+    CallbackManagerForToolRun,
+    ParentRunManager,
+    RunManager,
+)
+from langchain_core.callbacks.stdout import StdOutCallbackHandler
+from langchain_core.callbacks.streaming_stdout import StreamingStdOutCallbackHandler
+
+__all__ = [
+    "RetrieverManagerMixin",
+    "LLMManagerMixin",
+    "ChainManagerMixin",
+    "ToolManagerMixin",
+    "Callbacks",
+    "CallbackManagerMixin",
+    "RunManagerMixin",
+    "BaseCallbackHandler",
+    "AsyncCallbackHandler",
+    "BaseCallbackManager",
+    "BaseRunManager",
+    "RunManager",
+    "ParentRunManager",
+    "AsyncRunManager",
+    "AsyncParentRunManager",
+    "CallbackManagerForLLMRun",
+    "AsyncCallbackManagerForLLMRun",
+    "CallbackManagerForChainRun",
+    "AsyncCallbackManagerForChainRun",
+    "CallbackManagerForToolRun",
+    "AsyncCallbackManagerForToolRun",
+    "CallbackManagerForRetrieverRun",
+    "AsyncCallbackManagerForRetrieverRun",
+    "CallbackManager",
+    "CallbackManagerForChainGroup",
+    "AsyncCallbackManager",
+    "AsyncCallbackManagerForChainGroup",
+    "StdOutCallbackHandler",
+    "StreamingStdOutCallbackHandler",
+    "FileCallbackHandler",
+]
diff --git a/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0d53f459541d4a1fd8ff633f5fe0a8d3b55aec5a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1042186ea02bd9b3a63833b3d4a5d1e465ce762f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/file.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/file.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ae0326e6a290d1547c039332faa2dc60dcce0523
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/file.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/manager.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/manager.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fb992e461fc5f55f7655dae9a499efb24757173c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/manager.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/stdout.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/stdout.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..94cadc6cbfca75112bbe40cf78209c8c0e0bc6e8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/stdout.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/streaming_stdout.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/streaming_stdout.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d8db343ff7647c39468153246137058fb6899270
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/callbacks/__pycache__/streaming_stdout.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/callbacks/base.py b/llm/Lib/site-packages/langchain_core/callbacks/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..900cb2fcffc02fe4a09a080fbd8329c1b50cf841
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/callbacks/base.py
@@ -0,0 +1,636 @@
+"""Base callback handler that can be used to handle callbacks in langchain."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Sequence, TypeVar, Union
+from uuid import UUID
+
+from tenacity import RetryCallState
+
+if TYPE_CHECKING:
+    from langchain_core.agents import AgentAction, AgentFinish
+    from langchain_core.documents import Document
+    from langchain_core.messages import BaseMessage
+    from langchain_core.outputs import ChatGenerationChunk, GenerationChunk, LLMResult
+
+
+class RetrieverManagerMixin:
+    """Mixin for Retriever callbacks."""
+
+    def on_retriever_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when Retriever errors."""
+
+    def on_retriever_end(
+        self,
+        documents: Sequence[Document],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when Retriever ends running."""
+
+
+class LLMManagerMixin:
+    """Mixin for LLM callbacks."""
+
+    def on_llm_new_token(
+        self,
+        token: str,
+        *,
+        chunk: Optional[Union[GenerationChunk, ChatGenerationChunk]] = None,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run on new LLM token. Only available when streaming is enabled.
+
+        Args:
+            token (str): The new token.
+            chunk (GenerationChunk | ChatGenerationChunk): The new generated chunk,
+            containing content and other information.
+        """
+
+    def on_llm_end(
+        self,
+        response: LLMResult,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when LLM ends running."""
+
+    def on_llm_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when LLM errors.
+        Args:
+            error (BaseException): The error that occurred.
+            kwargs (Any): Additional keyword arguments.
+                - response (LLMResult): The response which was generated before
+                    the error occurred.
+        """
+
+
+class ChainManagerMixin:
+    """Mixin for chain callbacks."""
+
+    def on_chain_end(
+        self,
+        outputs: Dict[str, Any],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when chain ends running."""
+
+    def on_chain_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when chain errors."""
+
+    def on_agent_action(
+        self,
+        action: AgentAction,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run on agent action."""
+
+    def on_agent_finish(
+        self,
+        finish: AgentFinish,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run on agent end."""
+
+
+class ToolManagerMixin:
+    """Mixin for tool callbacks."""
+
+    def on_tool_end(
+        self,
+        output: Any,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when tool ends running."""
+
+    def on_tool_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when tool errors."""
+
+
+class CallbackManagerMixin:
+    """Mixin for callback manager."""
+
+    def on_llm_start(
+        self,
+        serialized: Dict[str, Any],
+        prompts: List[str],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when LLM starts running.
+
+        **ATTENTION**: This method is called for non-chat models (regular LLMs). If
+            you're implementing a handler for a chat model,
+            you should use on_chat_model_start instead.
+        """
+
+    def on_chat_model_start(
+        self,
+        serialized: Dict[str, Any],
+        messages: List[List[BaseMessage]],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when a chat model starts running.
+
+        **ATTENTION**: This method is called for chat models. If you're implementing
+            a handler for a non-chat model, you should use on_llm_start instead.
+        """
+        # NotImplementedError is thrown intentionally
+        # Callback handler will fall back to on_llm_start if this is exception is thrown
+        raise NotImplementedError(
+            f"{self.__class__.__name__} does not implement `on_chat_model_start`"
+        )
+
+    def on_retriever_start(
+        self,
+        serialized: Dict[str, Any],
+        query: str,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when Retriever starts running."""
+
+    def on_chain_start(
+        self,
+        serialized: Dict[str, Any],
+        inputs: Dict[str, Any],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when chain starts running."""
+
+    def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        inputs: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when tool starts running."""
+
+
+class RunManagerMixin:
+    """Mixin for run manager."""
+
+    def on_text(
+        self,
+        text: str,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run on arbitrary text."""
+
+    def on_retry(
+        self,
+        retry_state: RetryCallState,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run on a retry event."""
+
+
+class BaseCallbackHandler(
+    LLMManagerMixin,
+    ChainManagerMixin,
+    ToolManagerMixin,
+    RetrieverManagerMixin,
+    CallbackManagerMixin,
+    RunManagerMixin,
+):
+    """Base callback handler that handles callbacks from LangChain."""
+
+    raise_error: bool = False
+
+    run_inline: bool = False
+
+    @property
+    def ignore_llm(self) -> bool:
+        """Whether to ignore LLM callbacks."""
+        return False
+
+    @property
+    def ignore_retry(self) -> bool:
+        """Whether to ignore retry callbacks."""
+        return False
+
+    @property
+    def ignore_chain(self) -> bool:
+        """Whether to ignore chain callbacks."""
+        return False
+
+    @property
+    def ignore_agent(self) -> bool:
+        """Whether to ignore agent callbacks."""
+        return False
+
+    @property
+    def ignore_retriever(self) -> bool:
+        """Whether to ignore retriever callbacks."""
+        return False
+
+    @property
+    def ignore_chat_model(self) -> bool:
+        """Whether to ignore chat model callbacks."""
+        return False
+
+
+class AsyncCallbackHandler(BaseCallbackHandler):
+    """Async callback handler that handles callbacks from LangChain."""
+
+    async def on_llm_start(
+        self,
+        serialized: Dict[str, Any],
+        prompts: List[str],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run when LLM starts running.
+
+        **ATTENTION**: This method is called for non-chat models (regular LLMs). If
+            you're implementing a handler for a chat model,
+            you should use on_chat_model_start instead.
+        """
+
+    async def on_chat_model_start(
+        self,
+        serialized: Dict[str, Any],
+        messages: List[List[BaseMessage]],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when a chat model starts running.
+
+        **ATTENTION**: This method is called for chat models. If you're implementing
+            a handler for a non-chat model, you should use on_llm_start instead.
+        """
+        # NotImplementedError is thrown intentionally
+        # Callback handler will fall back to on_llm_start if this is exception is thrown
+        raise NotImplementedError(
+            f"{self.__class__.__name__} does not implement `on_chat_model_start`"
+        )
+
+    async def on_llm_new_token(
+        self,
+        token: str,
+        *,
+        chunk: Optional[Union[GenerationChunk, ChatGenerationChunk]] = None,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run on new LLM token. Only available when streaming is enabled."""
+
+    async def on_llm_end(
+        self,
+        response: LLMResult,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run when LLM ends running."""
+
+    async def on_llm_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run when LLM errors.
+
+        Args:
+            error: The error that occurred.
+            kwargs (Any): Additional keyword arguments.
+                - response (LLMResult): The response which was generated before
+                    the error occurred.
+        """
+
+    async def on_chain_start(
+        self,
+        serialized: Dict[str, Any],
+        inputs: Dict[str, Any],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run when chain starts running."""
+
+    async def on_chain_end(
+        self,
+        outputs: Dict[str, Any],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run when chain ends running."""
+
+    async def on_chain_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run when chain errors."""
+
+    async def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        inputs: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run when tool starts running."""
+
+    async def on_tool_end(
+        self,
+        output: Any,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run when tool ends running."""
+
+    async def on_tool_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run when tool errors."""
+
+    async def on_text(
+        self,
+        text: str,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run on arbitrary text."""
+
+    async def on_retry(
+        self,
+        retry_state: RetryCallState,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run on a retry event."""
+
+    async def on_agent_action(
+        self,
+        action: AgentAction,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run on agent action."""
+
+    async def on_agent_finish(
+        self,
+        finish: AgentFinish,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run on agent end."""
+
+    async def on_retriever_start(
+        self,
+        serialized: Dict[str, Any],
+        query: str,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run on retriever start."""
+
+    async def on_retriever_end(
+        self,
+        documents: Sequence[Document],
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run on retriever end."""
+
+    async def on_retriever_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run on retriever error."""
+
+
+T = TypeVar("T", bound="BaseCallbackManager")
+
+
+class BaseCallbackManager(CallbackManagerMixin):
+    """Base callback manager that handles callbacks from LangChain."""
+
+    def __init__(
+        self,
+        handlers: List[BaseCallbackHandler],
+        inheritable_handlers: Optional[List[BaseCallbackHandler]] = None,
+        parent_run_id: Optional[UUID] = None,
+        *,
+        tags: Optional[List[str]] = None,
+        inheritable_tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        inheritable_metadata: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        """Initialize callback manager."""
+        self.handlers: List[BaseCallbackHandler] = handlers
+        self.inheritable_handlers: List[BaseCallbackHandler] = (
+            inheritable_handlers or []
+        )
+        self.parent_run_id: Optional[UUID] = parent_run_id
+        self.tags = tags or []
+        self.inheritable_tags = inheritable_tags or []
+        self.metadata = metadata or {}
+        self.inheritable_metadata = inheritable_metadata or {}
+
+    def copy(self: T) -> T:
+        """Copy the callback manager."""
+        return self.__class__(
+            handlers=self.handlers,
+            inheritable_handlers=self.inheritable_handlers,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            inheritable_tags=self.inheritable_tags,
+            metadata=self.metadata,
+            inheritable_metadata=self.inheritable_metadata,
+        )
+
+    @property
+    def is_async(self) -> bool:
+        """Whether the callback manager is async."""
+        return False
+
+    def add_handler(self, handler: BaseCallbackHandler, inherit: bool = True) -> None:
+        """Add a handler to the callback manager."""
+        if handler not in self.handlers:
+            self.handlers.append(handler)
+        if inherit and handler not in self.inheritable_handlers:
+            self.inheritable_handlers.append(handler)
+
+    def remove_handler(self, handler: BaseCallbackHandler) -> None:
+        """Remove a handler from the callback manager."""
+        self.handlers.remove(handler)
+        self.inheritable_handlers.remove(handler)
+
+    def set_handlers(
+        self, handlers: List[BaseCallbackHandler], inherit: bool = True
+    ) -> None:
+        """Set handlers as the only handlers on the callback manager."""
+        self.handlers = []
+        self.inheritable_handlers = []
+        for handler in handlers:
+            self.add_handler(handler, inherit=inherit)
+
+    def set_handler(self, handler: BaseCallbackHandler, inherit: bool = True) -> None:
+        """Set handler as the only handler on the callback manager."""
+        self.set_handlers([handler], inherit=inherit)
+
+    def add_tags(self, tags: List[str], inherit: bool = True) -> None:
+        for tag in tags:
+            if tag in self.tags:
+                self.remove_tags([tag])
+        self.tags.extend(tags)
+        if inherit:
+            self.inheritable_tags.extend(tags)
+
+    def remove_tags(self, tags: List[str]) -> None:
+        for tag in tags:
+            self.tags.remove(tag)
+            self.inheritable_tags.remove(tag)
+
+    def add_metadata(self, metadata: Dict[str, Any], inherit: bool = True) -> None:
+        self.metadata.update(metadata)
+        if inherit:
+            self.inheritable_metadata.update(metadata)
+
+    def remove_metadata(self, keys: List[str]) -> None:
+        for key in keys:
+            self.metadata.pop(key)
+            self.inheritable_metadata.pop(key)
+
+
+Callbacks = Optional[Union[List[BaseCallbackHandler], BaseCallbackManager]]
diff --git a/llm/Lib/site-packages/langchain_core/callbacks/file.py b/llm/Lib/site-packages/langchain_core/callbacks/file.py
new file mode 100644
index 0000000000000000000000000000000000000000..daef52945049f4b96fedfdefc07d6cb3fa107f1b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/callbacks/file.py
@@ -0,0 +1,72 @@
+"""Callback Handler that writes to a file."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, Optional, TextIO, cast
+
+from langchain_core.agents import AgentAction, AgentFinish
+from langchain_core.callbacks import BaseCallbackHandler
+from langchain_core.utils.input import print_text
+
+
+class FileCallbackHandler(BaseCallbackHandler):
+    """Callback Handler that writes to a file."""
+
+    def __init__(
+        self, filename: str, mode: str = "a", color: Optional[str] = None
+    ) -> None:
+        """Initialize callback handler."""
+        self.file = cast(TextIO, open(filename, mode, encoding="utf-8"))
+        self.color = color
+
+    def __del__(self) -> None:
+        """Destructor to cleanup when done."""
+        self.file.close()
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Print out that we are entering a chain."""
+        class_name = serialized.get("name", serialized.get("id", ["<unknown>"])[-1])
+        print_text(
+            f"\n\n\033[1m> Entering new {class_name} chain...\033[0m",
+            end="\n",
+            file=self.file,
+        )
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Print out that we finished a chain."""
+        print_text("\n\033[1m> Finished chain.\033[0m", end="\n", file=self.file)
+
+    def on_agent_action(
+        self, action: AgentAction, color: Optional[str] = None, **kwargs: Any
+    ) -> Any:
+        """Run on agent action."""
+        print_text(action.log, color=color or self.color, file=self.file)
+
+    def on_tool_end(
+        self,
+        output: str,
+        color: Optional[str] = None,
+        observation_prefix: Optional[str] = None,
+        llm_prefix: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        """If not the final action, print out observation."""
+        if observation_prefix is not None:
+            print_text(f"\n{observation_prefix}", file=self.file)
+        print_text(output, color=color or self.color, file=self.file)
+        if llm_prefix is not None:
+            print_text(f"\n{llm_prefix}", file=self.file)
+
+    def on_text(
+        self, text: str, color: Optional[str] = None, end: str = "", **kwargs: Any
+    ) -> None:
+        """Run when agent ends."""
+        print_text(text, color=color or self.color, end=end, file=self.file)
+
+    def on_agent_finish(
+        self, finish: AgentFinish, color: Optional[str] = None, **kwargs: Any
+    ) -> None:
+        """Run on agent end."""
+        print_text(finish.log, color=color or self.color, end="\n", file=self.file)
diff --git a/llm/Lib/site-packages/langchain_core/callbacks/manager.py b/llm/Lib/site-packages/langchain_core/callbacks/manager.py
new file mode 100644
index 0000000000000000000000000000000000000000..74f4d1a639148408f42870bcd5daa3bc37547b96
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/callbacks/manager.py
@@ -0,0 +1,2026 @@
+from __future__ import annotations
+
+import asyncio
+import functools
+import logging
+import uuid
+from abc import ABC, abstractmethod
+from concurrent.futures import ThreadPoolExecutor
+from contextlib import asynccontextmanager, contextmanager
+from contextvars import copy_context
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncGenerator,
+    Callable,
+    Coroutine,
+    Dict,
+    Generator,
+    List,
+    Optional,
+    Sequence,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+)
+from uuid import UUID
+
+from langsmith.run_helpers import get_run_tree_context
+from tenacity import RetryCallState
+
+from langchain_core.callbacks.base import (
+    BaseCallbackHandler,
+    BaseCallbackManager,
+    Callbacks,
+    ChainManagerMixin,
+    LLMManagerMixin,
+    RetrieverManagerMixin,
+    RunManagerMixin,
+    ToolManagerMixin,
+)
+from langchain_core.callbacks.stdout import StdOutCallbackHandler
+from langchain_core.messages import BaseMessage, get_buffer_string
+from langchain_core.utils.env import env_var_is_set
+
+if TYPE_CHECKING:
+    from langchain_core.agents import AgentAction, AgentFinish
+    from langchain_core.documents import Document
+    from langchain_core.outputs import ChatGenerationChunk, GenerationChunk, LLMResult
+
+logger = logging.getLogger(__name__)
+
+
+def _get_debug() -> bool:
+    from langchain_core.globals import get_debug
+
+    return get_debug()
+
+
+@contextmanager
+def trace_as_chain_group(
+    group_name: str,
+    callback_manager: Optional[CallbackManager] = None,
+    *,
+    inputs: Optional[Dict[str, Any]] = None,
+    project_name: Optional[str] = None,
+    example_id: Optional[Union[str, UUID]] = None,
+    run_id: Optional[UUID] = None,
+    tags: Optional[List[str]] = None,
+    metadata: Optional[Dict[str, Any]] = None,
+) -> Generator[CallbackManagerForChainGroup, None, None]:
+    """Get a callback manager for a chain group in a context manager.
+    Useful for grouping different calls together as a single run even if
+    they aren't composed in a single chain.
+
+    Args:
+        group_name (str): The name of the chain group.
+        callback_manager (CallbackManager, optional): The callback manager to use.
+        inputs (Dict[str, Any], optional): The inputs to the chain group.
+        project_name (str, optional): The name of the project.
+            Defaults to None.
+        example_id (str or UUID, optional): The ID of the example.
+            Defaults to None.
+        run_id (UUID, optional): The ID of the run.
+        tags (List[str], optional): The inheritable tags to apply to all runs.
+            Defaults to None.
+        metadata (Dict[str, Any], optional): The metadata to apply to all runs.
+            Defaults to None.
+
+    Note: must have LANGCHAIN_TRACING_V2 env var set to true to see the trace in LangSmith.
+
+    Returns:
+        CallbackManagerForChainGroup: The callback manager for the chain group.
+
+    Example:
+        .. code-block:: python
+
+            llm_input = "Foo"
+            with trace_as_chain_group("group_name", inputs={"input": llm_input}) as manager:
+                # Use the callback manager for the chain group
+                res = llm.invoke(llm_input, {"callbacks": manager})
+                manager.on_chain_end({"output": res})
+    """  # noqa: E501
+    from langchain_core.tracers.context import _get_trace_callbacks
+
+    cb = _get_trace_callbacks(
+        project_name, example_id, callback_manager=callback_manager
+    )
+    cm = CallbackManager.configure(
+        inheritable_callbacks=cb,
+        inheritable_tags=tags,
+        inheritable_metadata=metadata,
+    )
+
+    run_manager = cm.on_chain_start({"name": group_name}, inputs or {}, run_id=run_id)
+    child_cm = run_manager.get_child()
+    group_cm = CallbackManagerForChainGroup(
+        child_cm.handlers,
+        child_cm.inheritable_handlers,
+        child_cm.parent_run_id,
+        parent_run_manager=run_manager,
+        tags=child_cm.tags,
+        inheritable_tags=child_cm.inheritable_tags,
+        metadata=child_cm.metadata,
+        inheritable_metadata=child_cm.inheritable_metadata,
+    )
+    try:
+        yield group_cm
+    except Exception as e:
+        if not group_cm.ended:
+            run_manager.on_chain_error(e)
+        raise e
+    else:
+        if not group_cm.ended:
+            run_manager.on_chain_end({})
+
+
+@asynccontextmanager
+async def atrace_as_chain_group(
+    group_name: str,
+    callback_manager: Optional[AsyncCallbackManager] = None,
+    *,
+    inputs: Optional[Dict[str, Any]] = None,
+    project_name: Optional[str] = None,
+    example_id: Optional[Union[str, UUID]] = None,
+    run_id: Optional[UUID] = None,
+    tags: Optional[List[str]] = None,
+    metadata: Optional[Dict[str, Any]] = None,
+) -> AsyncGenerator[AsyncCallbackManagerForChainGroup, None]:
+    """Get an async callback manager for a chain group in a context manager.
+    Useful for grouping different async calls together as a single run even if
+    they aren't composed in a single chain.
+
+    Args:
+        group_name (str): The name of the chain group.
+        callback_manager (AsyncCallbackManager, optional): The async callback manager to use,
+            which manages tracing and other callback behavior.
+        project_name (str, optional): The name of the project.
+            Defaults to None.
+        example_id (str or UUID, optional): The ID of the example.
+            Defaults to None.
+        run_id (UUID, optional): The ID of the run.
+        tags (List[str], optional): The inheritable tags to apply to all runs.
+            Defaults to None.
+        metadata (Dict[str, Any], optional): The metadata to apply to all runs.
+            Defaults to None.
+    Returns:
+        AsyncCallbackManager: The async callback manager for the chain group.
+
+    Note: must have LANGCHAIN_TRACING_V2 env var set to true to see the trace in LangSmith.
+
+    Example:
+        .. code-block:: python
+
+            llm_input = "Foo"
+            async with atrace_as_chain_group("group_name", inputs={"input": llm_input}) as manager:
+                # Use the async callback manager for the chain group
+                res = await llm.ainvoke(llm_input, {"callbacks": manager})
+                await manager.on_chain_end({"output": res})
+    """  # noqa: E501
+    from langchain_core.tracers.context import _get_trace_callbacks
+
+    cb = _get_trace_callbacks(
+        project_name, example_id, callback_manager=callback_manager
+    )
+    cm = AsyncCallbackManager.configure(
+        inheritable_callbacks=cb, inheritable_tags=tags, inheritable_metadata=metadata
+    )
+
+    run_manager = await cm.on_chain_start(
+        {"name": group_name}, inputs or {}, run_id=run_id
+    )
+    child_cm = run_manager.get_child()
+    group_cm = AsyncCallbackManagerForChainGroup(
+        child_cm.handlers,
+        child_cm.inheritable_handlers,
+        child_cm.parent_run_id,
+        parent_run_manager=run_manager,
+        tags=child_cm.tags,
+        inheritable_tags=child_cm.inheritable_tags,
+        metadata=child_cm.metadata,
+        inheritable_metadata=child_cm.inheritable_metadata,
+    )
+    try:
+        yield group_cm
+    except Exception as e:
+        if not group_cm.ended:
+            await run_manager.on_chain_error(e)
+        raise e
+    else:
+        if not group_cm.ended:
+            await run_manager.on_chain_end({})
+
+
+Func = TypeVar("Func", bound=Callable)
+
+
+def shielded(func: Func) -> Func:
+    """
+    Makes so an awaitable method is always shielded from cancellation
+    """
+
+    @functools.wraps(func)
+    async def wrapped(*args: Any, **kwargs: Any) -> Any:
+        return await asyncio.shield(func(*args, **kwargs))
+
+    return cast(Func, wrapped)
+
+
+def handle_event(
+    handlers: List[BaseCallbackHandler],
+    event_name: str,
+    ignore_condition_name: Optional[str],
+    *args: Any,
+    **kwargs: Any,
+) -> None:
+    """Generic event handler for CallbackManager.
+
+    Note: This function is used by langserve to handle events.
+
+    Args:
+        handlers: The list of handlers that will handle the event
+        event_name: The name of the event (e.g., "on_llm_start")
+        ignore_condition_name: Name of the attribute defined on handler
+            that if True will cause the handler to be skipped for the given event
+        *args: The arguments to pass to the event handler
+        **kwargs: The keyword arguments to pass to the event handler
+    """
+    coros: List[Coroutine[Any, Any, Any]] = []
+
+    try:
+        message_strings: Optional[List[str]] = None
+        for handler in handlers:
+            try:
+                if ignore_condition_name is None or not getattr(
+                    handler, ignore_condition_name
+                ):
+                    event = getattr(handler, event_name)(*args, **kwargs)
+                    if asyncio.iscoroutine(event):
+                        coros.append(event)
+            except NotImplementedError as e:
+                if event_name == "on_chat_model_start":
+                    if message_strings is None:
+                        message_strings = [get_buffer_string(m) for m in args[1]]
+                    handle_event(
+                        [handler],
+                        "on_llm_start",
+                        "ignore_llm",
+                        args[0],
+                        message_strings,
+                        *args[2:],
+                        **kwargs,
+                    )
+                else:
+                    handler_name = handler.__class__.__name__
+                    logger.warning(
+                        f"NotImplementedError in {handler_name}.{event_name}"
+                        f" callback: {repr(e)}"
+                    )
+            except Exception as e:
+                logger.warning(
+                    f"Error in {handler.__class__.__name__}.{event_name} callback:"
+                    f" {repr(e)}"
+                )
+                if handler.raise_error:
+                    raise e
+    finally:
+        if coros:
+            try:
+                # Raises RuntimeError if there is no current event loop.
+                asyncio.get_running_loop()
+                loop_running = True
+            except RuntimeError:
+                loop_running = False
+
+            if loop_running:
+                # If we try to submit this coroutine to the running loop
+                # we end up in a deadlock, as we'd have gotten here from a
+                # running coroutine, which we cannot interrupt to run this one.
+                # The solution is to create a new loop in a new thread.
+                with ThreadPoolExecutor(1) as executor:
+                    executor.submit(
+                        cast(Callable, copy_context().run), _run_coros, coros
+                    ).result()
+            else:
+                _run_coros(coros)
+
+
+def _run_coros(coros: List[Coroutine[Any, Any, Any]]) -> None:
+    if hasattr(asyncio, "Runner"):
+        # Python 3.11+
+        # Run the coroutines in a new event loop, taking care to
+        # - install signal handlers
+        # - run pending tasks scheduled by `coros`
+        # - close asyncgens and executors
+        # - close the loop
+        with asyncio.Runner() as runner:
+            # Run the coroutine, get the result
+            for coro in coros:
+                try:
+                    runner.run(coro)
+                except Exception as e:
+                    logger.warning(f"Error in callback coroutine: {repr(e)}")
+
+            # Run pending tasks scheduled by coros until they are all done
+            while pending := asyncio.all_tasks(runner.get_loop()):
+                runner.run(asyncio.wait(pending))
+    else:
+        # Before Python 3.11 we need to run each coroutine in a new event loop
+        # as the Runner api is not available.
+        for coro in coros:
+            try:
+                asyncio.run(coro)
+            except Exception as e:
+                logger.warning(f"Error in callback coroutine: {repr(e)}")
+
+
+async def _ahandle_event_for_handler(
+    handler: BaseCallbackHandler,
+    event_name: str,
+    ignore_condition_name: Optional[str],
+    *args: Any,
+    **kwargs: Any,
+) -> None:
+    try:
+        if ignore_condition_name is None or not getattr(handler, ignore_condition_name):
+            event = getattr(handler, event_name)
+            if asyncio.iscoroutinefunction(event):
+                await event(*args, **kwargs)
+            else:
+                if handler.run_inline:
+                    event(*args, **kwargs)
+                else:
+                    await asyncio.get_event_loop().run_in_executor(
+                        None,
+                        cast(
+                            Callable,
+                            functools.partial(
+                                copy_context().run, event, *args, **kwargs
+                            ),
+                        ),
+                    )
+    except NotImplementedError as e:
+        if event_name == "on_chat_model_start":
+            message_strings = [get_buffer_string(m) for m in args[1]]
+            await _ahandle_event_for_handler(
+                handler,
+                "on_llm_start",
+                "ignore_llm",
+                args[0],
+                message_strings,
+                *args[2:],
+                **kwargs,
+            )
+        else:
+            logger.warning(
+                f"NotImplementedError in {handler.__class__.__name__}.{event_name}"
+                f" callback: {repr(e)}"
+            )
+    except Exception as e:
+        logger.warning(
+            f"Error in {handler.__class__.__name__}.{event_name} callback:"
+            f" {repr(e)}"
+        )
+        if handler.raise_error:
+            raise e
+
+
+async def ahandle_event(
+    handlers: List[BaseCallbackHandler],
+    event_name: str,
+    ignore_condition_name: Optional[str],
+    *args: Any,
+    **kwargs: Any,
+) -> None:
+    """Generic event handler for AsyncCallbackManager.
+
+    Note: This function is used by langserve to handle events.
+
+    Args:
+        handlers: The list of handlers that will handle the event
+        event_name: The name of the event (e.g., "on_llm_start")
+        ignore_condition_name: Name of the attribute defined on handler
+            that if True will cause the handler to be skipped for the given event
+        *args: The arguments to pass to the event handler
+        **kwargs: The keyword arguments to pass to the event handler
+    """
+    for handler in [h for h in handlers if h.run_inline]:
+        await _ahandle_event_for_handler(
+            handler, event_name, ignore_condition_name, *args, **kwargs
+        )
+    await asyncio.gather(
+        *(
+            _ahandle_event_for_handler(
+                handler,
+                event_name,
+                ignore_condition_name,
+                *args,
+                **kwargs,
+            )
+            for handler in handlers
+            if not handler.run_inline
+        )
+    )
+
+
+BRM = TypeVar("BRM", bound="BaseRunManager")
+
+
+class BaseRunManager(RunManagerMixin):
+    """Base class for run manager (a bound callback manager)."""
+
+    def __init__(
+        self,
+        *,
+        run_id: UUID,
+        handlers: List[BaseCallbackHandler],
+        inheritable_handlers: List[BaseCallbackHandler],
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        inheritable_tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        inheritable_metadata: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        """Initialize the run manager.
+
+        Args:
+            run_id (UUID): The ID of the run.
+            handlers (List[BaseCallbackHandler]): The list of handlers.
+            inheritable_handlers (List[BaseCallbackHandler]):
+                The list of inheritable handlers.
+            parent_run_id (UUID, optional): The ID of the parent run.
+                Defaults to None.
+            tags (Optional[List[str]]): The list of tags.
+            inheritable_tags (Optional[List[str]]): The list of inheritable tags.
+            metadata (Optional[Dict[str, Any]]): The metadata.
+            inheritable_metadata (Optional[Dict[str, Any]]): The inheritable metadata.
+        """
+        self.run_id = run_id
+        self.handlers = handlers
+        self.inheritable_handlers = inheritable_handlers
+        self.parent_run_id = parent_run_id
+        self.tags = tags or []
+        self.inheritable_tags = inheritable_tags or []
+        self.metadata = metadata or {}
+        self.inheritable_metadata = inheritable_metadata or {}
+
+    @classmethod
+    def get_noop_manager(cls: Type[BRM]) -> BRM:
+        """Return a manager that doesn't perform any operations.
+
+        Returns:
+            BaseRunManager: The noop manager.
+        """
+        return cls(
+            run_id=uuid.uuid4(),
+            handlers=[],
+            inheritable_handlers=[],
+            tags=[],
+            inheritable_tags=[],
+            metadata={},
+            inheritable_metadata={},
+        )
+
+
+class RunManager(BaseRunManager):
+    """Sync Run Manager."""
+
+    def on_text(
+        self,
+        text: str,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when text is received.
+
+        Args:
+            text (str): The received text.
+
+        Returns:
+            Any: The result of the callback.
+        """
+        handle_event(
+            self.handlers,
+            "on_text",
+            None,
+            text,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    def on_retry(
+        self,
+        retry_state: RetryCallState,
+        **kwargs: Any,
+    ) -> None:
+        handle_event(
+            self.handlers,
+            "on_retry",
+            "ignore_retry",
+            retry_state,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+
+class ParentRunManager(RunManager):
+    """Sync Parent Run Manager."""
+
+    def get_child(self, tag: Optional[str] = None) -> CallbackManager:
+        """Get a child callback manager.
+
+        Args:
+            tag (str, optional): The tag for the child callback manager.
+                Defaults to None.
+
+        Returns:
+            CallbackManager: The child callback manager.
+        """
+        manager = CallbackManager(handlers=[], parent_run_id=self.run_id)
+        manager.set_handlers(self.inheritable_handlers)
+        manager.add_tags(self.inheritable_tags)
+        manager.add_metadata(self.inheritable_metadata)
+        if tag is not None:
+            manager.add_tags([tag], False)
+        return manager
+
+
+class AsyncRunManager(BaseRunManager, ABC):
+    """Async Run Manager."""
+
+    @abstractmethod
+    def get_sync(self) -> RunManager:
+        """Get the equivalent sync RunManager.
+
+        Returns:
+            RunManager: The sync RunManager.
+        """
+
+    async def on_text(
+        self,
+        text: str,
+        **kwargs: Any,
+    ) -> Any:
+        """Run when text is received.
+
+        Args:
+            text (str): The received text.
+
+        Returns:
+            Any: The result of the callback.
+        """
+        await ahandle_event(
+            self.handlers,
+            "on_text",
+            None,
+            text,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    async def on_retry(
+        self,
+        retry_state: RetryCallState,
+        **kwargs: Any,
+    ) -> None:
+        await ahandle_event(
+            self.handlers,
+            "on_retry",
+            "ignore_retry",
+            retry_state,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+
+class AsyncParentRunManager(AsyncRunManager):
+    """Async Parent Run Manager."""
+
+    def get_child(self, tag: Optional[str] = None) -> AsyncCallbackManager:
+        """Get a child callback manager.
+
+        Args:
+            tag (str, optional): The tag for the child callback manager.
+                Defaults to None.
+
+        Returns:
+            AsyncCallbackManager: The child callback manager.
+        """
+        manager = AsyncCallbackManager(handlers=[], parent_run_id=self.run_id)
+        manager.set_handlers(self.inheritable_handlers)
+        manager.add_tags(self.inheritable_tags)
+        manager.add_metadata(self.inheritable_metadata)
+        if tag is not None:
+            manager.add_tags([tag], False)
+        return manager
+
+
+class CallbackManagerForLLMRun(RunManager, LLMManagerMixin):
+    """Callback manager for LLM run."""
+
+    def on_llm_new_token(
+        self,
+        token: str,
+        *,
+        chunk: Optional[Union[GenerationChunk, ChatGenerationChunk]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run when LLM generates a new token.
+
+        Args:
+            token (str): The new token.
+        """
+        handle_event(
+            self.handlers,
+            "on_llm_new_token",
+            "ignore_llm",
+            token=token,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            chunk=chunk,
+            **kwargs,
+        )
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Run when LLM ends running.
+
+        Args:
+            response (LLMResult): The LLM result.
+        """
+        handle_event(
+            self.handlers,
+            "on_llm_end",
+            "ignore_llm",
+            response,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    def on_llm_error(
+        self,
+        error: BaseException,
+        **kwargs: Any,
+    ) -> None:
+        """Run when LLM errors.
+
+        Args:
+            error (Exception or KeyboardInterrupt): The error.
+            kwargs (Any): Additional keyword arguments.
+                - response (LLMResult): The response which was generated before
+                    the error occurred.
+        """
+        handle_event(
+            self.handlers,
+            "on_llm_error",
+            "ignore_llm",
+            error,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+
+class AsyncCallbackManagerForLLMRun(AsyncRunManager, LLMManagerMixin):
+    """Async callback manager for LLM run."""
+
+    def get_sync(self) -> CallbackManagerForLLMRun:
+        """Get the equivalent sync RunManager.
+
+        Returns:
+            CallbackManagerForLLMRun: The sync RunManager.
+        """
+        return CallbackManagerForLLMRun(
+            run_id=self.run_id,
+            handlers=self.handlers,
+            inheritable_handlers=self.inheritable_handlers,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            inheritable_tags=self.inheritable_tags,
+            metadata=self.metadata,
+            inheritable_metadata=self.inheritable_metadata,
+        )
+
+    @shielded
+    async def on_llm_new_token(
+        self,
+        token: str,
+        *,
+        chunk: Optional[Union[GenerationChunk, ChatGenerationChunk]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Run when LLM generates a new token.
+
+        Args:
+            token (str): The new token.
+        """
+        await ahandle_event(
+            self.handlers,
+            "on_llm_new_token",
+            "ignore_llm",
+            token,
+            chunk=chunk,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    @shielded
+    async def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Run when LLM ends running.
+
+        Args:
+            response (LLMResult): The LLM result.
+        """
+        await ahandle_event(
+            self.handlers,
+            "on_llm_end",
+            "ignore_llm",
+            response,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    @shielded
+    async def on_llm_error(
+        self,
+        error: BaseException,
+        **kwargs: Any,
+    ) -> None:
+        """Run when LLM errors.
+
+        Args:
+            error (Exception or KeyboardInterrupt): The error.
+            kwargs (Any): Additional keyword arguments.
+                - response (LLMResult): The response which was generated before
+                    the error occurred.
+
+
+
+        """
+        await ahandle_event(
+            self.handlers,
+            "on_llm_error",
+            "ignore_llm",
+            error,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+
+class CallbackManagerForChainRun(ParentRunManager, ChainManagerMixin):
+    """Callback manager for chain run."""
+
+    def on_chain_end(self, outputs: Union[Dict[str, Any], Any], **kwargs: Any) -> None:
+        """Run when chain ends running.
+
+        Args:
+            outputs (Union[Dict[str, Any], Any]): The outputs of the chain.
+        """
+        handle_event(
+            self.handlers,
+            "on_chain_end",
+            "ignore_chain",
+            outputs,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    def on_chain_error(
+        self,
+        error: BaseException,
+        **kwargs: Any,
+    ) -> None:
+        """Run when chain errors.
+
+        Args:
+            error (Exception or KeyboardInterrupt): The error.
+        """
+        handle_event(
+            self.handlers,
+            "on_chain_error",
+            "ignore_chain",
+            error,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Run when agent action is received.
+
+        Args:
+            action (AgentAction): The agent action.
+
+        Returns:
+            Any: The result of the callback.
+        """
+        handle_event(
+            self.handlers,
+            "on_agent_action",
+            "ignore_agent",
+            action,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> Any:
+        """Run when agent finish is received.
+
+        Args:
+            finish (AgentFinish): The agent finish.
+
+        Returns:
+            Any: The result of the callback.
+        """
+        handle_event(
+            self.handlers,
+            "on_agent_finish",
+            "ignore_agent",
+            finish,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+
+class AsyncCallbackManagerForChainRun(AsyncParentRunManager, ChainManagerMixin):
+    """Async callback manager for chain run."""
+
+    def get_sync(self) -> CallbackManagerForChainRun:
+        """Get the equivalent sync RunManager.
+
+        Returns:
+            CallbackManagerForChainRun: The sync RunManager.
+        """
+        return CallbackManagerForChainRun(
+            run_id=self.run_id,
+            handlers=self.handlers,
+            inheritable_handlers=self.inheritable_handlers,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            inheritable_tags=self.inheritable_tags,
+            metadata=self.metadata,
+            inheritable_metadata=self.inheritable_metadata,
+        )
+
+    @shielded
+    async def on_chain_end(
+        self, outputs: Union[Dict[str, Any], Any], **kwargs: Any
+    ) -> None:
+        """Run when chain ends running.
+
+        Args:
+            outputs (Union[Dict[str, Any], Any]): The outputs of the chain.
+        """
+        await ahandle_event(
+            self.handlers,
+            "on_chain_end",
+            "ignore_chain",
+            outputs,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    @shielded
+    async def on_chain_error(
+        self,
+        error: BaseException,
+        **kwargs: Any,
+    ) -> None:
+        """Run when chain errors.
+
+        Args:
+            error (Exception or KeyboardInterrupt): The error.
+        """
+        await ahandle_event(
+            self.handlers,
+            "on_chain_error",
+            "ignore_chain",
+            error,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    @shielded
+    async def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Run when agent action is received.
+
+        Args:
+            action (AgentAction): The agent action.
+
+        Returns:
+            Any: The result of the callback.
+        """
+        await ahandle_event(
+            self.handlers,
+            "on_agent_action",
+            "ignore_agent",
+            action,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    @shielded
+    async def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> Any:
+        """Run when agent finish is received.
+
+        Args:
+            finish (AgentFinish): The agent finish.
+
+        Returns:
+            Any: The result of the callback.
+        """
+        await ahandle_event(
+            self.handlers,
+            "on_agent_finish",
+            "ignore_agent",
+            finish,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+
+class CallbackManagerForToolRun(ParentRunManager, ToolManagerMixin):
+    """Callback manager for tool run."""
+
+    def on_tool_end(
+        self,
+        output: Any,
+        **kwargs: Any,
+    ) -> None:
+        """Run when tool ends running.
+
+        Args:
+            output (Any): The output of the tool.
+        """
+        handle_event(
+            self.handlers,
+            "on_tool_end",
+            "ignore_agent",
+            output,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    def on_tool_error(
+        self,
+        error: BaseException,
+        **kwargs: Any,
+    ) -> None:
+        """Run when tool errors.
+
+        Args:
+            error (Exception or KeyboardInterrupt): The error.
+        """
+        handle_event(
+            self.handlers,
+            "on_tool_error",
+            "ignore_agent",
+            error,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+
+class AsyncCallbackManagerForToolRun(AsyncParentRunManager, ToolManagerMixin):
+    """Async callback manager for tool run."""
+
+    def get_sync(self) -> CallbackManagerForToolRun:
+        """Get the equivalent sync RunManager.
+
+        Returns:
+            CallbackManagerForToolRun: The sync RunManager.
+        """
+        return CallbackManagerForToolRun(
+            run_id=self.run_id,
+            handlers=self.handlers,
+            inheritable_handlers=self.inheritable_handlers,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            inheritable_tags=self.inheritable_tags,
+            metadata=self.metadata,
+            inheritable_metadata=self.inheritable_metadata,
+        )
+
+    @shielded
+    async def on_tool_end(self, output: Any, **kwargs: Any) -> None:
+        """Run when tool ends running.
+
+        Args:
+            output (Any): The output of the tool.
+        """
+        output = str(output)
+        await ahandle_event(
+            self.handlers,
+            "on_tool_end",
+            "ignore_agent",
+            output,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    @shielded
+    async def on_tool_error(
+        self,
+        error: BaseException,
+        **kwargs: Any,
+    ) -> None:
+        """Run when tool errors.
+
+        Args:
+            error (Exception or KeyboardInterrupt): The error.
+        """
+        await ahandle_event(
+            self.handlers,
+            "on_tool_error",
+            "ignore_agent",
+            error,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+
+class CallbackManagerForRetrieverRun(ParentRunManager, RetrieverManagerMixin):
+    """Callback manager for retriever run."""
+
+    def on_retriever_end(
+        self,
+        documents: Sequence[Document],
+        **kwargs: Any,
+    ) -> None:
+        """Run when retriever ends running."""
+        handle_event(
+            self.handlers,
+            "on_retriever_end",
+            "ignore_retriever",
+            documents,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    def on_retriever_error(
+        self,
+        error: BaseException,
+        **kwargs: Any,
+    ) -> None:
+        """Run when retriever errors."""
+        handle_event(
+            self.handlers,
+            "on_retriever_error",
+            "ignore_retriever",
+            error,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+
+class AsyncCallbackManagerForRetrieverRun(
+    AsyncParentRunManager,
+    RetrieverManagerMixin,
+):
+    """Async callback manager for retriever run."""
+
+    def get_sync(self) -> CallbackManagerForRetrieverRun:
+        """Get the equivalent sync RunManager.
+
+        Returns:
+            CallbackManagerForRetrieverRun: The sync RunManager.
+        """
+        return CallbackManagerForRetrieverRun(
+            run_id=self.run_id,
+            handlers=self.handlers,
+            inheritable_handlers=self.inheritable_handlers,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            inheritable_tags=self.inheritable_tags,
+            metadata=self.metadata,
+            inheritable_metadata=self.inheritable_metadata,
+        )
+
+    @shielded
+    async def on_retriever_end(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> None:
+        """Run when retriever ends running."""
+        await ahandle_event(
+            self.handlers,
+            "on_retriever_end",
+            "ignore_retriever",
+            documents,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+    @shielded
+    async def on_retriever_error(
+        self,
+        error: BaseException,
+        **kwargs: Any,
+    ) -> None:
+        """Run when retriever errors."""
+        await ahandle_event(
+            self.handlers,
+            "on_retriever_error",
+            "ignore_retriever",
+            error,
+            run_id=self.run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            **kwargs,
+        )
+
+
+class CallbackManager(BaseCallbackManager):
+    """Callback manager that handles callbacks from LangChain."""
+
+    def on_llm_start(
+        self,
+        serialized: Dict[str, Any],
+        prompts: List[str],
+        run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> List[CallbackManagerForLLMRun]:
+        """Run when LLM starts running.
+
+        Args:
+            serialized (Dict[str, Any]): The serialized LLM.
+            prompts (List[str]): The list of prompts.
+            run_id (UUID, optional): The ID of the run. Defaults to None.
+
+        Returns:
+            List[CallbackManagerForLLMRun]: A callback manager for each
+                prompt as an LLM run.
+        """
+        managers = []
+        for i, prompt in enumerate(prompts):
+            # Can't have duplicate runs with the same run ID (if provided)
+            run_id_ = run_id if i == 0 and run_id is not None else uuid.uuid4()
+            handle_event(
+                self.handlers,
+                "on_llm_start",
+                "ignore_llm",
+                serialized,
+                [prompt],
+                run_id=run_id_,
+                parent_run_id=self.parent_run_id,
+                tags=self.tags,
+                metadata=self.metadata,
+                **kwargs,
+            )
+
+            managers.append(
+                CallbackManagerForLLMRun(
+                    run_id=run_id_,
+                    handlers=self.handlers,
+                    inheritable_handlers=self.inheritable_handlers,
+                    parent_run_id=self.parent_run_id,
+                    tags=self.tags,
+                    inheritable_tags=self.inheritable_tags,
+                    metadata=self.metadata,
+                    inheritable_metadata=self.inheritable_metadata,
+                )
+            )
+
+        return managers
+
+    def on_chat_model_start(
+        self,
+        serialized: Dict[str, Any],
+        messages: List[List[BaseMessage]],
+        run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> List[CallbackManagerForLLMRun]:
+        """Run when LLM starts running.
+
+        Args:
+            serialized (Dict[str, Any]): The serialized LLM.
+            messages (List[List[BaseMessage]]): The list of messages.
+            run_id (UUID, optional): The ID of the run. Defaults to None.
+
+        Returns:
+            List[CallbackManagerForLLMRun]: A callback manager for each
+                list of messages as an LLM run.
+        """
+
+        managers = []
+        for message_list in messages:
+            if run_id is not None:
+                run_id_ = run_id
+                run_id = None
+            else:
+                run_id_ = uuid.uuid4()
+            handle_event(
+                self.handlers,
+                "on_chat_model_start",
+                "ignore_chat_model",
+                serialized,
+                [message_list],
+                run_id=run_id_,
+                parent_run_id=self.parent_run_id,
+                tags=self.tags,
+                metadata=self.metadata,
+                **kwargs,
+            )
+
+            managers.append(
+                CallbackManagerForLLMRun(
+                    run_id=run_id_,
+                    handlers=self.handlers,
+                    inheritable_handlers=self.inheritable_handlers,
+                    parent_run_id=self.parent_run_id,
+                    tags=self.tags,
+                    inheritable_tags=self.inheritable_tags,
+                    metadata=self.metadata,
+                    inheritable_metadata=self.inheritable_metadata,
+                )
+            )
+
+        return managers
+
+    def on_chain_start(
+        self,
+        serialized: Dict[str, Any],
+        inputs: Union[Dict[str, Any], Any],
+        run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> CallbackManagerForChainRun:
+        """Run when chain starts running.
+
+        Args:
+            serialized (Dict[str, Any]): The serialized chain.
+            inputs (Union[Dict[str, Any], Any]): The inputs to the chain.
+            run_id (UUID, optional): The ID of the run. Defaults to None.
+
+        Returns:
+            CallbackManagerForChainRun: The callback manager for the chain run.
+        """
+        if run_id is None:
+            run_id = uuid.uuid4()
+        handle_event(
+            self.handlers,
+            "on_chain_start",
+            "ignore_chain",
+            serialized,
+            inputs,
+            run_id=run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            metadata=self.metadata,
+            **kwargs,
+        )
+
+        return CallbackManagerForChainRun(
+            run_id=run_id,
+            handlers=self.handlers,
+            inheritable_handlers=self.inheritable_handlers,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            inheritable_tags=self.inheritable_tags,
+            metadata=self.metadata,
+            inheritable_metadata=self.inheritable_metadata,
+        )
+
+    def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        run_id: Optional[UUID] = None,
+        parent_run_id: Optional[UUID] = None,
+        inputs: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> CallbackManagerForToolRun:
+        """Run when tool starts running.
+
+        Args:
+            serialized: Serialized representation of the tool.
+            input_str: The  input to the tool as a string.
+                Non-string inputs are cast to strings.
+            run_id: ID for the run. Defaults to None.
+            parent_run_id: The ID of the parent run. Defaults to None.
+            inputs: The original input to the tool if provided.
+                Recommended for usage instead of input_str when the original
+                input is needed.
+                If provided, the inputs are expected to be formatted as a dict.
+                The keys will correspond to the named-arguments in the tool.
+
+        Returns:
+            CallbackManagerForToolRun: The callback manager for the tool run.
+        """
+        if run_id is None:
+            run_id = uuid.uuid4()
+
+        handle_event(
+            self.handlers,
+            "on_tool_start",
+            "ignore_agent",
+            serialized,
+            input_str,
+            run_id=run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            metadata=self.metadata,
+            inputs=inputs,
+            **kwargs,
+        )
+
+        return CallbackManagerForToolRun(
+            run_id=run_id,
+            handlers=self.handlers,
+            inheritable_handlers=self.inheritable_handlers,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            inheritable_tags=self.inheritable_tags,
+            metadata=self.metadata,
+            inheritable_metadata=self.inheritable_metadata,
+        )
+
+    def on_retriever_start(
+        self,
+        serialized: Dict[str, Any],
+        query: str,
+        run_id: Optional[UUID] = None,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> CallbackManagerForRetrieverRun:
+        """Run when retriever starts running."""
+        if run_id is None:
+            run_id = uuid.uuid4()
+
+        handle_event(
+            self.handlers,
+            "on_retriever_start",
+            "ignore_retriever",
+            serialized,
+            query,
+            run_id=run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            metadata=self.metadata,
+            **kwargs,
+        )
+
+        return CallbackManagerForRetrieverRun(
+            run_id=run_id,
+            handlers=self.handlers,
+            inheritable_handlers=self.inheritable_handlers,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            inheritable_tags=self.inheritable_tags,
+            metadata=self.metadata,
+            inheritable_metadata=self.inheritable_metadata,
+        )
+
+    @classmethod
+    def configure(
+        cls,
+        inheritable_callbacks: Callbacks = None,
+        local_callbacks: Callbacks = None,
+        verbose: bool = False,
+        inheritable_tags: Optional[List[str]] = None,
+        local_tags: Optional[List[str]] = None,
+        inheritable_metadata: Optional[Dict[str, Any]] = None,
+        local_metadata: Optional[Dict[str, Any]] = None,
+    ) -> CallbackManager:
+        """Configure the callback manager.
+
+        Args:
+            inheritable_callbacks (Optional[Callbacks], optional): The inheritable
+                callbacks. Defaults to None.
+            local_callbacks (Optional[Callbacks], optional): The local callbacks.
+                Defaults to None.
+            verbose (bool, optional): Whether to enable verbose mode. Defaults to False.
+            inheritable_tags (Optional[List[str]], optional): The inheritable tags.
+                Defaults to None.
+            local_tags (Optional[List[str]], optional): The local tags.
+                Defaults to None.
+            inheritable_metadata (Optional[Dict[str, Any]], optional): The inheritable
+                metadata. Defaults to None.
+            local_metadata (Optional[Dict[str, Any]], optional): The local metadata.
+                Defaults to None.
+
+        Returns:
+            CallbackManager: The configured callback manager.
+        """
+        return _configure(
+            cls,
+            inheritable_callbacks,
+            local_callbacks,
+            verbose,
+            inheritable_tags,
+            local_tags,
+            inheritable_metadata,
+            local_metadata,
+        )
+
+
+class CallbackManagerForChainGroup(CallbackManager):
+    """Callback manager for the chain group."""
+
+    def __init__(
+        self,
+        handlers: List[BaseCallbackHandler],
+        inheritable_handlers: Optional[List[BaseCallbackHandler]] = None,
+        parent_run_id: Optional[UUID] = None,
+        *,
+        parent_run_manager: CallbackManagerForChainRun,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(
+            handlers,
+            inheritable_handlers,
+            parent_run_id,
+            **kwargs,
+        )
+        self.parent_run_manager = parent_run_manager
+        self.ended = False
+
+    def copy(self) -> CallbackManagerForChainGroup:
+        return self.__class__(
+            handlers=self.handlers,
+            inheritable_handlers=self.inheritable_handlers,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            inheritable_tags=self.inheritable_tags,
+            metadata=self.metadata,
+            inheritable_metadata=self.inheritable_metadata,
+            parent_run_manager=self.parent_run_manager,
+        )
+
+    def on_chain_end(self, outputs: Union[Dict[str, Any], Any], **kwargs: Any) -> None:
+        """Run when traced chain group ends.
+
+        Args:
+            outputs (Union[Dict[str, Any], Any]): The outputs of the chain.
+        """
+        self.ended = True
+        return self.parent_run_manager.on_chain_end(outputs, **kwargs)
+
+    def on_chain_error(
+        self,
+        error: BaseException,
+        **kwargs: Any,
+    ) -> None:
+        """Run when chain errors.
+
+        Args:
+            error (Exception or KeyboardInterrupt): The error.
+        """
+        self.ended = True
+        return self.parent_run_manager.on_chain_error(error, **kwargs)
+
+
+class AsyncCallbackManager(BaseCallbackManager):
+    """Async callback manager that handles callbacks from LangChain."""
+
+    @property
+    def is_async(self) -> bool:
+        """Return whether the handler is async."""
+        return True
+
+    async def on_llm_start(
+        self,
+        serialized: Dict[str, Any],
+        prompts: List[str],
+        run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> List[AsyncCallbackManagerForLLMRun]:
+        """Run when LLM starts running.
+
+        Args:
+            serialized (Dict[str, Any]): The serialized LLM.
+            prompts (List[str]): The list of prompts.
+            run_id (UUID, optional): The ID of the run. Defaults to None.
+
+        Returns:
+            List[AsyncCallbackManagerForLLMRun]: The list of async
+                callback managers, one for each LLM Run corresponding
+                to each prompt.
+        """
+
+        tasks = []
+        managers = []
+
+        for prompt in prompts:
+            if run_id is not None:
+                run_id_ = run_id
+                run_id = None
+            else:
+                run_id_ = uuid.uuid4()
+
+            tasks.append(
+                ahandle_event(
+                    self.handlers,
+                    "on_llm_start",
+                    "ignore_llm",
+                    serialized,
+                    [prompt],
+                    run_id=run_id_,
+                    parent_run_id=self.parent_run_id,
+                    tags=self.tags,
+                    metadata=self.metadata,
+                    **kwargs,
+                )
+            )
+
+            managers.append(
+                AsyncCallbackManagerForLLMRun(
+                    run_id=run_id_,
+                    handlers=self.handlers,
+                    inheritable_handlers=self.inheritable_handlers,
+                    parent_run_id=self.parent_run_id,
+                    tags=self.tags,
+                    inheritable_tags=self.inheritable_tags,
+                    metadata=self.metadata,
+                    inheritable_metadata=self.inheritable_metadata,
+                )
+            )
+
+        await asyncio.gather(*tasks)
+
+        return managers
+
+    async def on_chat_model_start(
+        self,
+        serialized: Dict[str, Any],
+        messages: List[List[BaseMessage]],
+        run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> List[AsyncCallbackManagerForLLMRun]:
+        """Run when LLM starts running.
+
+        Args:
+            serialized (Dict[str, Any]): The serialized LLM.
+            messages (List[List[BaseMessage]]): The list of messages.
+            run_id (UUID, optional): The ID of the run. Defaults to None.
+
+        Returns:
+            List[AsyncCallbackManagerForLLMRun]: The list of
+                async callback managers, one for each LLM Run
+                corresponding to each inner  message list.
+        """
+        tasks = []
+        managers = []
+
+        for message_list in messages:
+            if run_id is not None:
+                run_id_ = run_id
+                run_id = None
+            else:
+                run_id_ = uuid.uuid4()
+
+            tasks.append(
+                ahandle_event(
+                    self.handlers,
+                    "on_chat_model_start",
+                    "ignore_chat_model",
+                    serialized,
+                    [message_list],
+                    run_id=run_id_,
+                    parent_run_id=self.parent_run_id,
+                    tags=self.tags,
+                    metadata=self.metadata,
+                    **kwargs,
+                )
+            )
+
+            managers.append(
+                AsyncCallbackManagerForLLMRun(
+                    run_id=run_id_,
+                    handlers=self.handlers,
+                    inheritable_handlers=self.inheritable_handlers,
+                    parent_run_id=self.parent_run_id,
+                    tags=self.tags,
+                    inheritable_tags=self.inheritable_tags,
+                    metadata=self.metadata,
+                    inheritable_metadata=self.inheritable_metadata,
+                )
+            )
+
+        await asyncio.gather(*tasks)
+        return managers
+
+    async def on_chain_start(
+        self,
+        serialized: Dict[str, Any],
+        inputs: Union[Dict[str, Any], Any],
+        run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> AsyncCallbackManagerForChainRun:
+        """Run when chain starts running.
+
+        Args:
+            serialized (Dict[str, Any]): The serialized chain.
+            inputs (Union[Dict[str, Any], Any]): The inputs to the chain.
+            run_id (UUID, optional): The ID of the run. Defaults to None.
+
+        Returns:
+            AsyncCallbackManagerForChainRun: The async callback manager
+                for the chain run.
+        """
+        if run_id is None:
+            run_id = uuid.uuid4()
+
+        await ahandle_event(
+            self.handlers,
+            "on_chain_start",
+            "ignore_chain",
+            serialized,
+            inputs,
+            run_id=run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            metadata=self.metadata,
+            **kwargs,
+        )
+
+        return AsyncCallbackManagerForChainRun(
+            run_id=run_id,
+            handlers=self.handlers,
+            inheritable_handlers=self.inheritable_handlers,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            inheritable_tags=self.inheritable_tags,
+            metadata=self.metadata,
+            inheritable_metadata=self.inheritable_metadata,
+        )
+
+    async def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        run_id: Optional[UUID] = None,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> AsyncCallbackManagerForToolRun:
+        """Run when tool starts running.
+
+        Args:
+            serialized (Dict[str, Any]): The serialized tool.
+            input_str (str): The input to the tool.
+            run_id (UUID, optional): The ID of the run. Defaults to None.
+            parent_run_id (UUID, optional): The ID of the parent run.
+                Defaults to None.
+
+        Returns:
+            AsyncCallbackManagerForToolRun: The async callback manager
+                for the tool run.
+        """
+        if run_id is None:
+            run_id = uuid.uuid4()
+
+        await ahandle_event(
+            self.handlers,
+            "on_tool_start",
+            "ignore_agent",
+            serialized,
+            input_str,
+            run_id=run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            metadata=self.metadata,
+            **kwargs,
+        )
+
+        return AsyncCallbackManagerForToolRun(
+            run_id=run_id,
+            handlers=self.handlers,
+            inheritable_handlers=self.inheritable_handlers,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            inheritable_tags=self.inheritable_tags,
+            metadata=self.metadata,
+            inheritable_metadata=self.inheritable_metadata,
+        )
+
+    async def on_retriever_start(
+        self,
+        serialized: Dict[str, Any],
+        query: str,
+        run_id: Optional[UUID] = None,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> AsyncCallbackManagerForRetrieverRun:
+        """Run when retriever starts running."""
+        if run_id is None:
+            run_id = uuid.uuid4()
+
+        await ahandle_event(
+            self.handlers,
+            "on_retriever_start",
+            "ignore_retriever",
+            serialized,
+            query,
+            run_id=run_id,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            metadata=self.metadata,
+            **kwargs,
+        )
+
+        return AsyncCallbackManagerForRetrieverRun(
+            run_id=run_id,
+            handlers=self.handlers,
+            inheritable_handlers=self.inheritable_handlers,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            inheritable_tags=self.inheritable_tags,
+            metadata=self.metadata,
+            inheritable_metadata=self.inheritable_metadata,
+        )
+
+    @classmethod
+    def configure(
+        cls,
+        inheritable_callbacks: Callbacks = None,
+        local_callbacks: Callbacks = None,
+        verbose: bool = False,
+        inheritable_tags: Optional[List[str]] = None,
+        local_tags: Optional[List[str]] = None,
+        inheritable_metadata: Optional[Dict[str, Any]] = None,
+        local_metadata: Optional[Dict[str, Any]] = None,
+    ) -> AsyncCallbackManager:
+        """Configure the async callback manager.
+
+        Args:
+            inheritable_callbacks (Optional[Callbacks], optional): The inheritable
+                callbacks. Defaults to None.
+            local_callbacks (Optional[Callbacks], optional): The local callbacks.
+                Defaults to None.
+            verbose (bool, optional): Whether to enable verbose mode. Defaults to False.
+            inheritable_tags (Optional[List[str]], optional): The inheritable tags.
+                Defaults to None.
+            local_tags (Optional[List[str]], optional): The local tags.
+                Defaults to None.
+            inheritable_metadata (Optional[Dict[str, Any]], optional): The inheritable
+                metadata. Defaults to None.
+            local_metadata (Optional[Dict[str, Any]], optional): The local metadata.
+                Defaults to None.
+
+        Returns:
+            AsyncCallbackManager: The configured async callback manager.
+        """
+        return _configure(
+            cls,
+            inheritable_callbacks,
+            local_callbacks,
+            verbose,
+            inheritable_tags,
+            local_tags,
+            inheritable_metadata,
+            local_metadata,
+        )
+
+
+class AsyncCallbackManagerForChainGroup(AsyncCallbackManager):
+    """Async callback manager for the chain group."""
+
+    def __init__(
+        self,
+        handlers: List[BaseCallbackHandler],
+        inheritable_handlers: Optional[List[BaseCallbackHandler]] = None,
+        parent_run_id: Optional[UUID] = None,
+        *,
+        parent_run_manager: AsyncCallbackManagerForChainRun,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(
+            handlers,
+            inheritable_handlers,
+            parent_run_id,
+            **kwargs,
+        )
+        self.parent_run_manager = parent_run_manager
+        self.ended = False
+
+    def copy(self) -> AsyncCallbackManagerForChainGroup:
+        return self.__class__(
+            handlers=self.handlers,
+            inheritable_handlers=self.inheritable_handlers,
+            parent_run_id=self.parent_run_id,
+            tags=self.tags,
+            inheritable_tags=self.inheritable_tags,
+            metadata=self.metadata,
+            inheritable_metadata=self.inheritable_metadata,
+            parent_run_manager=self.parent_run_manager,
+        )
+
+    async def on_chain_end(
+        self, outputs: Union[Dict[str, Any], Any], **kwargs: Any
+    ) -> None:
+        """Run when traced chain group ends.
+
+        Args:
+            outputs (Union[Dict[str, Any], Any]): The outputs of the chain.
+        """
+        self.ended = True
+        await self.parent_run_manager.on_chain_end(outputs, **kwargs)
+
+    async def on_chain_error(
+        self,
+        error: BaseException,
+        **kwargs: Any,
+    ) -> None:
+        """Run when chain errors.
+
+        Args:
+            error (Exception or KeyboardInterrupt): The error.
+        """
+        self.ended = True
+        await self.parent_run_manager.on_chain_error(error, **kwargs)
+
+
+T = TypeVar("T", CallbackManager, AsyncCallbackManager)
+
+
+H = TypeVar("H", bound=BaseCallbackHandler, covariant=True)
+
+
+def _configure(
+    callback_manager_cls: Type[T],
+    inheritable_callbacks: Callbacks = None,
+    local_callbacks: Callbacks = None,
+    verbose: bool = False,
+    inheritable_tags: Optional[List[str]] = None,
+    local_tags: Optional[List[str]] = None,
+    inheritable_metadata: Optional[Dict[str, Any]] = None,
+    local_metadata: Optional[Dict[str, Any]] = None,
+) -> T:
+    """Configure the callback manager.
+
+    Args:
+        callback_manager_cls (Type[T]): The callback manager class.
+        inheritable_callbacks (Optional[Callbacks], optional): The inheritable
+            callbacks. Defaults to None.
+        local_callbacks (Optional[Callbacks], optional): The local callbacks.
+            Defaults to None.
+        verbose (bool, optional): Whether to enable verbose mode. Defaults to False.
+        inheritable_tags (Optional[List[str]], optional): The inheritable tags.
+            Defaults to None.
+        local_tags (Optional[List[str]], optional): The local tags. Defaults to None.
+        inheritable_metadata (Optional[Dict[str, Any]], optional): The inheritable
+            metadata. Defaults to None.
+        local_metadata (Optional[Dict[str, Any]], optional): The local metadata.
+            Defaults to None.
+
+    Returns:
+        T: The configured callback manager.
+    """
+    from langchain_core.tracers.context import (
+        _configure_hooks,
+        _get_tracer_project,
+        _tracing_v2_is_enabled,
+        tracing_v2_callback_var,
+    )
+
+    run_tree = get_run_tree_context()
+    parent_run_id = None if run_tree is None else getattr(run_tree, "id")
+    callback_manager = callback_manager_cls(handlers=[], parent_run_id=parent_run_id)
+    if inheritable_callbacks or local_callbacks:
+        if isinstance(inheritable_callbacks, list) or inheritable_callbacks is None:
+            inheritable_callbacks_ = inheritable_callbacks or []
+            callback_manager = callback_manager_cls(
+                handlers=inheritable_callbacks_.copy(),
+                inheritable_handlers=inheritable_callbacks_.copy(),
+                parent_run_id=parent_run_id,
+            )
+        else:
+            callback_manager = callback_manager_cls(
+                handlers=inheritable_callbacks.handlers.copy(),
+                inheritable_handlers=inheritable_callbacks.inheritable_handlers.copy(),
+                parent_run_id=inheritable_callbacks.parent_run_id,
+                tags=inheritable_callbacks.tags.copy(),
+                inheritable_tags=inheritable_callbacks.inheritable_tags.copy(),
+                metadata=inheritable_callbacks.metadata.copy(),
+                inheritable_metadata=inheritable_callbacks.inheritable_metadata.copy(),
+            )
+        local_handlers_ = (
+            local_callbacks
+            if isinstance(local_callbacks, list)
+            else (local_callbacks.handlers if local_callbacks else [])
+        )
+        for handler in local_handlers_:
+            callback_manager.add_handler(handler, False)
+    if inheritable_tags or local_tags:
+        callback_manager.add_tags(inheritable_tags or [])
+        callback_manager.add_tags(local_tags or [], False)
+    if inheritable_metadata or local_metadata:
+        callback_manager.add_metadata(inheritable_metadata or {})
+        callback_manager.add_metadata(local_metadata or {}, False)
+
+    v1_tracing_enabled_ = env_var_is_set("LANGCHAIN_TRACING") or env_var_is_set(
+        "LANGCHAIN_HANDLER"
+    )
+
+    tracer_v2 = tracing_v2_callback_var.get()
+    tracing_v2_enabled_ = _tracing_v2_is_enabled()
+
+    if v1_tracing_enabled_ and not tracing_v2_enabled_:
+        # if both are enabled, can silently ignore the v1 tracer
+        raise RuntimeError(
+            "Tracing using LangChainTracerV1 is no longer supported. "
+            "Please set the LANGCHAIN_TRACING_V2 environment variable to enable "
+            "tracing instead."
+        )
+
+    tracer_project = _get_tracer_project()
+    debug = _get_debug()
+    if verbose or debug or tracing_v2_enabled_:
+        from langchain_core.tracers.langchain import LangChainTracer
+        from langchain_core.tracers.stdout import ConsoleCallbackHandler
+
+        if verbose and not any(
+            isinstance(handler, StdOutCallbackHandler)
+            for handler in callback_manager.handlers
+        ):
+            if debug:
+                pass
+            else:
+                callback_manager.add_handler(StdOutCallbackHandler(), False)
+        if debug and not any(
+            isinstance(handler, ConsoleCallbackHandler)
+            for handler in callback_manager.handlers
+        ):
+            callback_manager.add_handler(ConsoleCallbackHandler(), True)
+        if tracing_v2_enabled_ and not any(
+            isinstance(handler, LangChainTracer)
+            for handler in callback_manager.handlers
+        ):
+            if tracer_v2:
+                callback_manager.add_handler(tracer_v2, True)
+            else:
+                try:
+                    handler = LangChainTracer(project_name=tracer_project)
+                    callback_manager.add_handler(handler, True)
+                except Exception as e:
+                    logger.warning(
+                        "Unable to load requested LangChainTracer."
+                        " To disable this warning,"
+                        " unset the LANGCHAIN_TRACING_V2 environment variables.",
+                        e,
+                    )
+    for var, inheritable, handler_class, env_var in _configure_hooks:
+        create_one = (
+            env_var is not None
+            and env_var_is_set(env_var)
+            and handler_class is not None
+        )
+        if var.get() is not None or create_one:
+            var_handler = var.get() or cast(Type[BaseCallbackHandler], handler_class)()
+            if handler_class is None:
+                if not any(
+                    handler is var_handler  # direct pointer comparison
+                    for handler in callback_manager.handlers
+                ):
+                    callback_manager.add_handler(var_handler, inheritable)
+            else:
+                if not any(
+                    isinstance(handler, handler_class)
+                    for handler in callback_manager.handlers
+                ):
+                    callback_manager.add_handler(var_handler, inheritable)
+    return callback_manager
diff --git a/llm/Lib/site-packages/langchain_core/callbacks/stdout.py b/llm/Lib/site-packages/langchain_core/callbacks/stdout.py
new file mode 100644
index 0000000000000000000000000000000000000000..0408eb19845a63269dcc3dc95687be32fd159225
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/callbacks/stdout.py
@@ -0,0 +1,68 @@
+"""Callback Handler that prints to std out."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, Optional
+
+from langchain_core.callbacks.base import BaseCallbackHandler
+from langchain_core.utils import print_text
+
+if TYPE_CHECKING:
+    from langchain_core.agents import AgentAction, AgentFinish
+
+
+class StdOutCallbackHandler(BaseCallbackHandler):
+    """Callback Handler that prints to std out."""
+
+    def __init__(self, color: Optional[str] = None) -> None:
+        """Initialize callback handler."""
+        self.color = color
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Print out that we are entering a chain."""
+        class_name = serialized.get("name", serialized.get("id", ["<unknown>"])[-1])
+        print(f"\n\n\033[1m> Entering new {class_name} chain...\033[0m")  # noqa: T201
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Print out that we finished a chain."""
+        print("\n\033[1m> Finished chain.\033[0m")  # noqa: T201
+
+    def on_agent_action(
+        self, action: AgentAction, color: Optional[str] = None, **kwargs: Any
+    ) -> Any:
+        """Run on agent action."""
+        print_text(action.log, color=color or self.color)
+
+    def on_tool_end(
+        self,
+        output: Any,
+        color: Optional[str] = None,
+        observation_prefix: Optional[str] = None,
+        llm_prefix: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        """If not the final action, print out observation."""
+        output = str(output)
+        if observation_prefix is not None:
+            print_text(f"\n{observation_prefix}")
+        print_text(output, color=color or self.color)
+        if llm_prefix is not None:
+            print_text(f"\n{llm_prefix}")
+
+    def on_text(
+        self,
+        text: str,
+        color: Optional[str] = None,
+        end: str = "",
+        **kwargs: Any,
+    ) -> None:
+        """Run when agent ends."""
+        print_text(text, color=color or self.color, end=end)
+
+    def on_agent_finish(
+        self, finish: AgentFinish, color: Optional[str] = None, **kwargs: Any
+    ) -> None:
+        """Run on agent end."""
+        print_text(finish.log, color=color or self.color, end="\n")
diff --git a/llm/Lib/site-packages/langchain_core/callbacks/streaming_stdout.py b/llm/Lib/site-packages/langchain_core/callbacks/streaming_stdout.py
new file mode 100644
index 0000000000000000000000000000000000000000..4966aa2e11cb8dfecb48c822aff31356d3903345
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/callbacks/streaming_stdout.py
@@ -0,0 +1,72 @@
+"""Callback Handler streams to stdout on new llm token."""
+from __future__ import annotations
+
+import sys
+from typing import TYPE_CHECKING, Any, Dict, List
+
+from langchain_core.callbacks.base import BaseCallbackHandler
+
+if TYPE_CHECKING:
+    from langchain_core.agents import AgentAction, AgentFinish
+    from langchain_core.messages import BaseMessage
+    from langchain_core.outputs import LLMResult
+
+
+class StreamingStdOutCallbackHandler(BaseCallbackHandler):
+    """Callback handler for streaming. Only works with LLMs that support streaming."""
+
+    def on_llm_start(
+        self, serialized: Dict[str, Any], prompts: List[str], **kwargs: Any
+    ) -> None:
+        """Run when LLM starts running."""
+
+    def on_chat_model_start(
+        self,
+        serialized: Dict[str, Any],
+        messages: List[List[BaseMessage]],
+        **kwargs: Any,
+    ) -> None:
+        """Run when LLM starts running."""
+
+    def on_llm_new_token(self, token: str, **kwargs: Any) -> None:
+        """Run on new LLM token. Only available when streaming is enabled."""
+        sys.stdout.write(token)
+        sys.stdout.flush()
+
+    def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None:
+        """Run when LLM ends running."""
+
+    def on_llm_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when LLM errors."""
+
+    def on_chain_start(
+        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
+    ) -> None:
+        """Run when chain starts running."""
+
+    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
+        """Run when chain ends running."""
+
+    def on_chain_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when chain errors."""
+
+    def on_tool_start(
+        self, serialized: Dict[str, Any], input_str: str, **kwargs: Any
+    ) -> None:
+        """Run when tool starts running."""
+
+    def on_agent_action(self, action: AgentAction, **kwargs: Any) -> Any:
+        """Run on agent action."""
+        pass
+
+    def on_tool_end(self, output: Any, **kwargs: Any) -> None:
+        """Run when tool ends running."""
+
+    def on_tool_error(self, error: BaseException, **kwargs: Any) -> None:
+        """Run when tool errors."""
+
+    def on_text(self, text: str, **kwargs: Any) -> None:
+        """Run on arbitrary text."""
+
+    def on_agent_finish(self, finish: AgentFinish, **kwargs: Any) -> None:
+        """Run on agent end."""
diff --git a/llm/Lib/site-packages/langchain_core/chat_history.py b/llm/Lib/site-packages/langchain_core/chat_history.py
new file mode 100644
index 0000000000000000000000000000000000000000..8f930745585973fe02bc4e9bd168bbb50be8dd79
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/chat_history.py
@@ -0,0 +1,186 @@
+"""**Chat message history** stores a history of the message interactions in a chat.
+
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseChatMessageHistory --> <name>ChatMessageHistory  # Examples: FileChatMessageHistory, PostgresChatMessageHistory
+
+**Main helpers:**
+
+.. code-block::
+
+    AIMessage, HumanMessage, BaseMessage
+
+"""  # noqa: E501
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import List, Sequence, Union
+
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    HumanMessage,
+    get_buffer_string,
+)
+from langchain_core.runnables import run_in_executor
+
+
+class BaseChatMessageHistory(ABC):
+    """Abstract base class for storing chat message history.
+
+    Implementations guidelines:
+
+    Implementations are expected to over-ride all or some of the following methods:
+
+    * add_messages: sync variant for bulk addition of messages
+    * aadd_messages: async variant for bulk addition of messages
+    * messages: sync variant for getting messages
+    * aget_messages: async variant for getting messages
+    * clear: sync variant for clearing messages
+    * aclear: async variant for clearing messages
+
+    add_messages contains a default implementation that calls add_message
+    for each message in the sequence. This is provided for backwards compatibility
+    with existing implementations which only had add_message.
+
+    Async variants all have default implementations that call the sync variants.
+    Implementers can choose to over-ride the async implementations to provide
+    truly async implementations.
+
+    Usage guidelines:
+
+    When used for updating history, users should favor usage of `add_messages`
+    over `add_message` or other variants like `add_user_message` and `add_ai_message`
+    to avoid unnecessary round-trips to the underlying persistence layer.
+
+    Example: Shows a default implementation.
+
+        .. code-block:: python
+
+            class FileChatMessageHistory(BaseChatMessageHistory):
+                storage_path:  str
+                session_id: str
+
+               @property
+               def messages(self):
+                   with open(os.path.join(storage_path, session_id), 'r:utf-8') as f:
+                       messages = json.loads(f.read())
+                    return messages_from_dict(messages)
+
+               def add_messages(self, messages: Sequence[BaseMessage]) -> None:
+                   all_messages = list(self.messages) # Existing messages
+                   all_messages.extend(messages) # Add new messages
+
+                   serialized = [message_to_dict(message) for message in all_messages]
+                   # Can be further optimized by only writing new messages
+                   # using append mode.
+                   with open(os.path.join(storage_path, session_id), 'w') as f:
+                       json.dump(f, messages)
+
+               def clear(self):
+                   with open(os.path.join(storage_path, session_id), 'w') as f:
+                       f.write("[]")
+    """
+
+    messages: List[BaseMessage]
+    """A property or attribute that returns a list of messages.
+
+    In general, getting the messages may involve IO to the underlying
+    persistence layer, so this operation is expected to incur some
+    latency.
+    """
+
+    async def aget_messages(self) -> List[BaseMessage]:
+        """Async version of getting messages.
+
+        Can over-ride this method to provide an efficient async implementation.
+
+        In general, fetching messages may involve IO to the underlying
+        persistence layer.
+        """
+        return await run_in_executor(None, lambda: self.messages)
+
+    def add_user_message(self, message: Union[HumanMessage, str]) -> None:
+        """Convenience method for adding a human message string to the store.
+
+        Please note that this is a convenience method. Code should favor the
+        bulk add_messages interface instead to save on round-trips to the underlying
+        persistence layer.
+
+        This method may be deprecated in a future release.
+
+        Args:
+            message: The human message to add
+        """
+        if isinstance(message, HumanMessage):
+            self.add_message(message)
+        else:
+            self.add_message(HumanMessage(content=message))
+
+    def add_ai_message(self, message: Union[AIMessage, str]) -> None:
+        """Convenience method for adding an AI message string to the store.
+
+        Please note that this is a convenience method. Code should favor the bulk
+        add_messages interface instead to save on round-trips to the underlying
+        persistence layer.
+
+        This method may be deprecated in a future release.
+
+        Args:
+            message: The AI message to add.
+        """
+        if isinstance(message, AIMessage):
+            self.add_message(message)
+        else:
+            self.add_message(AIMessage(content=message))
+
+    def add_message(self, message: BaseMessage) -> None:
+        """Add a Message object to the store.
+
+        Args:
+            message: A BaseMessage object to store.
+        """
+        if type(self).add_messages != BaseChatMessageHistory.add_messages:
+            # This means that the sub-class has implemented an efficient add_messages
+            # method, so we should use it.
+            self.add_messages([message])
+        else:
+            raise NotImplementedError(
+                "add_message is not implemented for this class. "
+                "Please implement add_message or add_messages."
+            )
+
+    def add_messages(self, messages: Sequence[BaseMessage]) -> None:
+        """Add a list of messages.
+
+        Implementations should over-ride this method to handle bulk addition of messages
+        in an efficient manner to avoid unnecessary round-trips to the underlying store.
+
+        Args:
+            messages: A list of BaseMessage objects to store.
+        """
+        for message in messages:
+            self.add_message(message)
+
+    async def aadd_messages(self, messages: Sequence[BaseMessage]) -> None:
+        """Add a list of messages.
+
+        Args:
+            messages: A list of BaseMessage objects to store.
+        """
+        await run_in_executor(None, self.add_messages, messages)
+
+    @abstractmethod
+    def clear(self) -> None:
+        """Remove all messages from the store"""
+
+    async def aclear(self) -> None:
+        """Remove all messages from the store"""
+        await run_in_executor(None, self.clear)
+
+    def __str__(self) -> str:
+        """Return a string representation of the chat history."""
+        return get_buffer_string(self.messages)
diff --git a/llm/Lib/site-packages/langchain_core/chat_sessions.py b/llm/Lib/site-packages/langchain_core/chat_sessions.py
new file mode 100644
index 0000000000000000000000000000000000000000..1379a6b66725edc3e34b118b25484dc9e7f15432
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/chat_sessions.py
@@ -0,0 +1,16 @@
+"""**Chat Sessions** are a collection of messages and function calls.
+
+"""
+from typing import Sequence, TypedDict
+
+from langchain_core.messages import BaseMessage
+
+
+class ChatSession(TypedDict, total=False):
+    """Chat Session represents a single
+    conversation, channel, or other group of messages."""
+
+    messages: Sequence[BaseMessage]
+    """The LangChain chat messages loaded from the source."""
+    functions: Sequence[dict]
+    """The function calling specs for the messages."""
diff --git a/llm/Lib/site-packages/langchain_core/document_loaders/__init__.py b/llm/Lib/site-packages/langchain_core/document_loaders/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..05a48a9be01f0b3aa38afdbfdf706489fa1a0fa0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/document_loaders/__init__.py
@@ -0,0 +1,10 @@
+from langchain_core.document_loaders.base import BaseBlobParser, BaseLoader
+from langchain_core.document_loaders.blob_loaders import Blob, BlobLoader, PathLike
+
+__all__ = [
+    "BaseBlobParser",
+    "BaseLoader",
+    "Blob",
+    "BlobLoader",
+    "PathLike",
+]
diff --git a/llm/Lib/site-packages/langchain_core/document_loaders/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/document_loaders/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9286c3b45535a074fb86a8fc18bcc35a4b9d2bf1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/document_loaders/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/document_loaders/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/document_loaders/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ae270150a8d1c9c5689562d3c56e874baba786be
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/document_loaders/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/document_loaders/__pycache__/blob_loaders.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/document_loaders/__pycache__/blob_loaders.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9c6633406f94a60846218c99912352f27b890e7d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/document_loaders/__pycache__/blob_loaders.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/document_loaders/base.py b/llm/Lib/site-packages/langchain_core/document_loaders/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..5a584aa5b3cb425f6d91a917a099dcaf2fb3e787
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/document_loaders/base.py
@@ -0,0 +1,125 @@
+"""Abstract interface for document loader implementations."""
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import TYPE_CHECKING, AsyncIterator, Iterator, List, Optional
+
+from langchain_core.documents import Document
+from langchain_core.runnables import run_in_executor
+
+if TYPE_CHECKING:
+    from langchain_text_splitters import TextSplitter
+
+from langchain_core.document_loaders.blob_loaders import Blob
+
+
+class BaseLoader(ABC):
+    """Interface for Document Loader.
+
+    Implementations should implement the lazy-loading method using generators
+    to avoid loading all Documents into memory at once.
+
+    `load` is provided just for user convenience and should not be overridden.
+    """
+
+    # Sub-classes should not implement this method directly. Instead, they
+    # should implement the lazy load method.
+    def load(self) -> List[Document]:
+        """Load data into Document objects."""
+        return list(self.lazy_load())
+
+    async def aload(self) -> List[Document]:
+        """Load data into Document objects."""
+        return [document async for document in self.alazy_load()]
+
+    def load_and_split(
+        self, text_splitter: Optional[TextSplitter] = None
+    ) -> List[Document]:
+        """Load Documents and split into chunks. Chunks are returned as Documents.
+
+        Do not override this method. It should be considered to be deprecated!
+
+        Args:
+            text_splitter: TextSplitter instance to use for splitting documents.
+              Defaults to RecursiveCharacterTextSplitter.
+
+        Returns:
+            List of Documents.
+        """
+
+        if text_splitter is None:
+            try:
+                from langchain_text_splitters import RecursiveCharacterTextSplitter
+            except ImportError as e:
+                raise ImportError(
+                    "Unable to import from langchain_text_splitters. Please specify "
+                    "text_splitter or install langchain_text_splitters with "
+                    "`pip install -U langchain-text-splitters`."
+                ) from e
+
+            _text_splitter: TextSplitter = RecursiveCharacterTextSplitter()
+        else:
+            _text_splitter = text_splitter
+        docs = self.load()
+        return _text_splitter.split_documents(docs)
+
+    # Attention: This method will be upgraded into an abstractmethod once it's
+    #            implemented in all the existing subclasses.
+    def lazy_load(self) -> Iterator[Document]:
+        """A lazy loader for Documents."""
+        if type(self).load != BaseLoader.load:
+            return iter(self.load())
+        raise NotImplementedError(
+            f"{self.__class__.__name__} does not implement lazy_load()"
+        )
+
+    async def alazy_load(self) -> AsyncIterator[Document]:
+        """A lazy loader for Documents."""
+        iterator = await run_in_executor(None, self.lazy_load)
+        done = object()
+        while True:
+            doc = await run_in_executor(None, next, iterator, done)  # type: ignore[call-arg, arg-type]
+            if doc is done:
+                break
+            yield doc  # type: ignore[misc]
+
+
+class BaseBlobParser(ABC):
+    """Abstract interface for blob parsers.
+
+    A blob parser provides a way to parse raw data stored in a blob into one
+    or more documents.
+
+    The parser can be composed with blob loaders, making it easy to reuse
+    a parser independent of how the blob was originally loaded.
+    """
+
+    @abstractmethod
+    def lazy_parse(self, blob: Blob) -> Iterator[Document]:
+        """Lazy parsing interface.
+
+        Subclasses are required to implement this method.
+
+        Args:
+            blob: Blob instance
+
+        Returns:
+            Generator of documents
+        """
+
+    def parse(self, blob: Blob) -> List[Document]:
+        """Eagerly parse the blob into a document or documents.
+
+        This is a convenience method for interactive development environment.
+
+        Production applications should favor the lazy_parse method instead.
+
+        Subclasses should generally not over-ride this parse method.
+
+        Args:
+            blob: Blob instance
+
+        Returns:
+            List of documents
+        """
+        return list(self.lazy_parse(blob))
diff --git a/llm/Lib/site-packages/langchain_core/document_loaders/blob_loaders.py b/llm/Lib/site-packages/langchain_core/document_loaders/blob_loaders.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2f88a14015ab02922b01eba1d21090c48d538bb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/document_loaders/blob_loaders.py
@@ -0,0 +1,195 @@
+"""Schema for Blobs and Blob Loaders.
+
+The goal is to facilitate decoupling of content loading from content parsing code.
+
+In addition, content loading code should provide a lazy loading interface by default.
+"""
+from __future__ import annotations
+
+import contextlib
+import mimetypes
+from abc import ABC, abstractmethod
+from io import BufferedReader, BytesIO
+from pathlib import PurePath
+from typing import Any, Dict, Generator, Iterable, Mapping, Optional, Union, cast
+
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+
+PathLike = Union[str, PurePath]
+
+
+class Blob(BaseModel):
+    """Blob represents raw data by either reference or value.
+
+    Provides an interface to materialize the blob in different representations, and
+    help to decouple the development of data loaders from the downstream parsing of
+    the raw data.
+
+    Inspired by: https://developer.mozilla.org/en-US/docs/Web/API/Blob
+    """
+
+    data: Union[bytes, str, None]
+    """Raw data associated with the blob."""
+    mimetype: Optional[str] = None
+    """MimeType not to be confused with a file extension."""
+    encoding: str = "utf-8"
+    """Encoding to use if decoding the bytes into a string.
+    
+    Use utf-8 as default encoding, if decoding to string.
+    """
+    path: Optional[PathLike] = None
+    """Location where the original content was found."""
+
+    metadata: Dict[str, Any] = Field(default_factory=dict)
+    """Metadata about the blob (e.g., source)"""
+
+    class Config:
+        arbitrary_types_allowed = True
+        frozen = True
+
+    @property
+    def source(self) -> Optional[str]:
+        """The source location of the blob as string if known otherwise none.
+
+        If a path is associated with the blob, it will default to the path location.
+
+        Unless explicitly set via a metadata field called "source", in which
+        case that value will be used instead.
+        """
+        if self.metadata and "source" in self.metadata:
+            return cast(Optional[str], self.metadata["source"])
+        return str(self.path) if self.path else None
+
+    @root_validator(pre=True)
+    def check_blob_is_valid(cls, values: Mapping[str, Any]) -> Mapping[str, Any]:
+        """Verify that either data or path is provided."""
+        if "data" not in values and "path" not in values:
+            raise ValueError("Either data or path must be provided")
+        return values
+
+    def as_string(self) -> str:
+        """Read data as a string."""
+        if self.data is None and self.path:
+            with open(str(self.path), "r", encoding=self.encoding) as f:
+                return f.read()
+        elif isinstance(self.data, bytes):
+            return self.data.decode(self.encoding)
+        elif isinstance(self.data, str):
+            return self.data
+        else:
+            raise ValueError(f"Unable to get string for blob {self}")
+
+    def as_bytes(self) -> bytes:
+        """Read data as bytes."""
+        if isinstance(self.data, bytes):
+            return self.data
+        elif isinstance(self.data, str):
+            return self.data.encode(self.encoding)
+        elif self.data is None and self.path:
+            with open(str(self.path), "rb") as f:
+                return f.read()
+        else:
+            raise ValueError(f"Unable to get bytes for blob {self}")
+
+    @contextlib.contextmanager
+    def as_bytes_io(self) -> Generator[Union[BytesIO, BufferedReader], None, None]:
+        """Read data as a byte stream."""
+        if isinstance(self.data, bytes):
+            yield BytesIO(self.data)
+        elif self.data is None and self.path:
+            with open(str(self.path), "rb") as f:
+                yield f
+        else:
+            raise NotImplementedError(f"Unable to convert blob {self}")
+
+    @classmethod
+    def from_path(
+        cls,
+        path: PathLike,
+        *,
+        encoding: str = "utf-8",
+        mime_type: Optional[str] = None,
+        guess_type: bool = True,
+        metadata: Optional[dict] = None,
+    ) -> Blob:
+        """Load the blob from a path like object.
+
+        Args:
+            path: path like object to file to be read
+            encoding: Encoding to use if decoding the bytes into a string
+            mime_type: if provided, will be set as the mime-type of the data
+            guess_type: If True, the mimetype will be guessed from the file extension,
+                        if a mime-type was not provided
+            metadata: Metadata to associate with the blob
+
+        Returns:
+            Blob instance
+        """
+        if mime_type is None and guess_type:
+            _mimetype = mimetypes.guess_type(path)[0] if guess_type else None
+        else:
+            _mimetype = mime_type
+        # We do not load the data immediately, instead we treat the blob as a
+        # reference to the underlying data.
+        return cls(
+            data=None,
+            mimetype=_mimetype,
+            encoding=encoding,
+            path=path,
+            metadata=metadata if metadata is not None else {},
+        )
+
+    @classmethod
+    def from_data(
+        cls,
+        data: Union[str, bytes],
+        *,
+        encoding: str = "utf-8",
+        mime_type: Optional[str] = None,
+        path: Optional[str] = None,
+        metadata: Optional[dict] = None,
+    ) -> Blob:
+        """Initialize the blob from in-memory data.
+
+        Args:
+            data: the in-memory data associated with the blob
+            encoding: Encoding to use if decoding the bytes into a string
+            mime_type: if provided, will be set as the mime-type of the data
+            path: if provided, will be set as the source from which the data came
+            metadata: Metadata to associate with the blob
+
+        Returns:
+            Blob instance
+        """
+        return cls(
+            data=data,
+            mimetype=mime_type,
+            encoding=encoding,
+            path=path,
+            metadata=metadata if metadata is not None else {},
+        )
+
+    def __repr__(self) -> str:
+        """Define the blob representation."""
+        str_repr = f"Blob {id(self)}"
+        if self.source:
+            str_repr += f" {self.source}"
+        return str_repr
+
+
+class BlobLoader(ABC):
+    """Abstract interface for blob loaders implementation.
+
+    Implementer should be able to load raw content from a storage system according
+    to some criteria and return the raw content lazily as a stream of blobs.
+    """
+
+    @abstractmethod
+    def yield_blobs(
+        self,
+    ) -> Iterable[Blob]:
+        """A lazy loader for raw data represented by LangChain's Blob object.
+
+        Returns:
+            A generator over blobs
+        """
diff --git a/llm/Lib/site-packages/langchain_core/documents/__init__.py b/llm/Lib/site-packages/langchain_core/documents/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..11943477c7ded1c592e220de8a9c024e52f6d9a5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/documents/__init__.py
@@ -0,0 +1,9 @@
+"""**Document** module is a collection of classes that handle documents
+and their transformations.
+
+"""
+from langchain_core.documents.base import Document
+from langchain_core.documents.compressor import BaseDocumentCompressor
+from langchain_core.documents.transformers import BaseDocumentTransformer
+
+__all__ = ["Document", "BaseDocumentTransformer", "BaseDocumentCompressor"]
diff --git a/llm/Lib/site-packages/langchain_core/documents/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/documents/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..88ad410fd30f38ed8bb98392f91080a9c9341bd1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/documents/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/documents/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/documents/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1f8f8e1f777e5da3adafd039bffdf49fd4576e12
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/documents/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/documents/__pycache__/compressor.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/documents/__pycache__/compressor.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a46e0ed96f1164118a35d4320bb547fee3294143
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/documents/__pycache__/compressor.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/documents/__pycache__/transformers.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/documents/__pycache__/transformers.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0935a39dcfd7cb6c5e26fc8eb7bcbbb3285edf8b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/documents/__pycache__/transformers.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/documents/base.py b/llm/Lib/site-packages/langchain_core/documents/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..c72bfa724fd637c652e203ed0fc45112f71021fb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/documents/base.py
@@ -0,0 +1,32 @@
+from __future__ import annotations
+
+from typing import Any, List, Literal
+
+from langchain_core.load.serializable import Serializable
+from langchain_core.pydantic_v1 import Field
+
+
+class Document(Serializable):
+    """Class for storing a piece of text and associated metadata."""
+
+    page_content: str
+    """String text."""
+    metadata: dict = Field(default_factory=dict)
+    """Arbitrary metadata about the page content (e.g., source, relationships to other
+        documents, etc.).
+    """
+    type: Literal["Document"] = "Document"
+
+    def __init__(self, page_content: str, **kwargs: Any) -> None:
+        """Pass page_content in as positional or named arg."""
+        super().__init__(page_content=page_content, **kwargs)
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this class is serializable."""
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "document"]
diff --git a/llm/Lib/site-packages/langchain_core/documents/compressor.py b/llm/Lib/site-packages/langchain_core/documents/compressor.py
new file mode 100644
index 0000000000000000000000000000000000000000..228caf660a6c174604c4b6f3ea8d452621e51e86
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/documents/compressor.py
@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import Optional, Sequence
+
+from langchain_core.callbacks import Callbacks
+from langchain_core.documents import Document
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.runnables import run_in_executor
+
+
+class BaseDocumentCompressor(BaseModel, ABC):
+    """Base class for document compressors."""
+
+    @abstractmethod
+    def compress_documents(
+        self,
+        documents: Sequence[Document],
+        query: str,
+        callbacks: Optional[Callbacks] = None,
+    ) -> Sequence[Document]:
+        """Compress retrieved documents given the query context."""
+
+    async def acompress_documents(
+        self,
+        documents: Sequence[Document],
+        query: str,
+        callbacks: Optional[Callbacks] = None,
+    ) -> Sequence[Document]:
+        """Compress retrieved documents given the query context."""
+        return await run_in_executor(
+            None, self.compress_documents, documents, query, callbacks
+        )
diff --git a/llm/Lib/site-packages/langchain_core/documents/transformers.py b/llm/Lib/site-packages/langchain_core/documents/transformers.py
new file mode 100644
index 0000000000000000000000000000000000000000..245e6a715c295716fb409ca0d11d9cae01271540
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/documents/transformers.py
@@ -0,0 +1,74 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import TYPE_CHECKING, Any, Sequence
+
+from langchain_core.runnables.config import run_in_executor
+
+if TYPE_CHECKING:
+    from langchain_core.documents import Document
+
+
+class BaseDocumentTransformer(ABC):
+    """Abstract base class for document transformation systems.
+
+    A document transformation system takes a sequence of Documents and returns a
+    sequence of transformed Documents.
+
+    Example:
+        .. code-block:: python
+
+            class EmbeddingsRedundantFilter(BaseDocumentTransformer, BaseModel):
+                embeddings: Embeddings
+                similarity_fn: Callable = cosine_similarity
+                similarity_threshold: float = 0.95
+
+                class Config:
+                    arbitrary_types_allowed = True
+
+                def transform_documents(
+                    self, documents: Sequence[Document], **kwargs: Any
+                ) -> Sequence[Document]:
+                    stateful_documents = get_stateful_documents(documents)
+                    embedded_documents = _get_embeddings_from_stateful_docs(
+                        self.embeddings, stateful_documents
+                    )
+                    included_idxs = _filter_similar_embeddings(
+                        embedded_documents, self.similarity_fn, self.similarity_threshold
+                    )
+                    return [stateful_documents[i] for i in sorted(included_idxs)]
+
+                async def atransform_documents(
+                    self, documents: Sequence[Document], **kwargs: Any
+                ) -> Sequence[Document]:
+                    raise NotImplementedError
+
+    """  # noqa: E501
+
+    @abstractmethod
+    def transform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        """Transform a list of documents.
+
+        Args:
+            documents: A sequence of Documents to be transformed.
+
+        Returns:
+            A list of transformed Documents.
+        """
+
+    async def atransform_documents(
+        self, documents: Sequence[Document], **kwargs: Any
+    ) -> Sequence[Document]:
+        """Asynchronously transform a list of documents.
+
+        Args:
+            documents: A sequence of Documents to be transformed.
+
+        Returns:
+            A list of transformed Documents.
+        """
+        return await run_in_executor(
+            None, self.transform_documents, documents, **kwargs
+        )
diff --git a/llm/Lib/site-packages/langchain_core/embeddings/__init__.py b/llm/Lib/site-packages/langchain_core/embeddings/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..532950f2ad903a41dcdd4ecdb8cede943caec2ac
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/embeddings/__init__.py
@@ -0,0 +1,4 @@
+from langchain_core.embeddings.embeddings import Embeddings
+from langchain_core.embeddings.fake import DeterministicFakeEmbedding, FakeEmbeddings
+
+__all__ = ["DeterministicFakeEmbedding", "Embeddings", "FakeEmbeddings"]
diff --git a/llm/Lib/site-packages/langchain_core/embeddings/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/embeddings/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f0440b503ab8cf9784e9d3caad7530a131f46652
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/embeddings/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/embeddings/__pycache__/embeddings.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/embeddings/__pycache__/embeddings.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..53acad2097f6453186809abc4cd4886a1f1b6780
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/embeddings/__pycache__/embeddings.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/embeddings/__pycache__/fake.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/embeddings/__pycache__/fake.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..e0be856274e41ffc3a4f3ed643526f2eb3de1d19
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/embeddings/__pycache__/fake.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/embeddings/embeddings.py b/llm/Lib/site-packages/langchain_core/embeddings/embeddings.py
new file mode 100644
index 0000000000000000000000000000000000000000..d48d4ecdf49a17392b4a2f39fd16d07720059cc2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/embeddings/embeddings.py
@@ -0,0 +1,25 @@
+"""**Embeddings** interface."""
+from abc import ABC, abstractmethod
+from typing import List
+
+from langchain_core.runnables.config import run_in_executor
+
+
+class Embeddings(ABC):
+    """Interface for embedding models."""
+
+    @abstractmethod
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Embed search docs."""
+
+    @abstractmethod
+    def embed_query(self, text: str) -> List[float]:
+        """Embed query text."""
+
+    async def aembed_documents(self, texts: List[str]) -> List[List[float]]:
+        """Asynchronous Embed search docs."""
+        return await run_in_executor(None, self.embed_documents, texts)
+
+    async def aembed_query(self, text: str) -> List[float]:
+        """Asynchronous Embed query text."""
+        return await run_in_executor(None, self.embed_query, text)
diff --git a/llm/Lib/site-packages/langchain_core/embeddings/fake.py b/llm/Lib/site-packages/langchain_core/embeddings/fake.py
new file mode 100644
index 0000000000000000000000000000000000000000..3a9f103d2a60ef616ec75de998bcace3dae796df
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/embeddings/fake.py
@@ -0,0 +1,52 @@
+import hashlib
+from typing import List
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import BaseModel
+
+
+class FakeEmbeddings(Embeddings, BaseModel):
+    """Fake embedding model."""
+
+    size: int
+    """The size of the embedding vector."""
+
+    def _get_embedding(self) -> List[float]:
+        import numpy as np  # type: ignore[import-not-found, import-untyped]
+
+        return list(np.random.normal(size=self.size))
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        return [self._get_embedding() for _ in texts]
+
+    def embed_query(self, text: str) -> List[float]:
+        return self._get_embedding()
+
+
+class DeterministicFakeEmbedding(Embeddings, BaseModel):
+    """
+    Fake embedding model that always returns
+    the same embedding vector for the same text.
+    """
+
+    size: int
+    """The size of the embedding vector."""
+
+    def _get_embedding(self, seed: int) -> List[float]:
+        import numpy as np  # type: ignore[import-not-found, import-untyped]
+
+        # set the seed for the random generator
+        np.random.seed(seed)
+        return list(np.random.normal(size=self.size))
+
+    def _get_seed(self, text: str) -> int:
+        """
+        Get a seed for the random generator, using the hash of the text.
+        """
+        return int(hashlib.sha256(text.encode("utf-8")).hexdigest(), 16) % 10**8
+
+    def embed_documents(self, texts: List[str]) -> List[List[float]]:
+        return [self._get_embedding(seed=self._get_seed(_)) for _ in texts]
+
+    def embed_query(self, text: str) -> List[float]:
+        return self._get_embedding(seed=self._get_seed(text))
diff --git a/llm/Lib/site-packages/langchain_core/env.py b/llm/Lib/site-packages/langchain_core/env.py
new file mode 100644
index 0000000000000000000000000000000000000000..79c3a9b5c828cdcf701e9dcd5737358f93d4e79d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/env.py
@@ -0,0 +1,17 @@
+import platform
+from functools import lru_cache
+
+
+@lru_cache(maxsize=1)
+def get_runtime_environment() -> dict:
+    """Get information about the LangChain runtime environment."""
+    # Lazy import to avoid circular imports
+    from langchain_core import __version__
+
+    return {
+        "library_version": __version__,
+        "library": "langchain-core",
+        "platform": platform.platform(),
+        "runtime": "python",
+        "runtime_version": platform.python_version(),
+    }
diff --git a/llm/Lib/site-packages/langchain_core/example_selectors/__init__.py b/llm/Lib/site-packages/langchain_core/example_selectors/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..838a42984b3b52a419622de801ce9d84213d4b48
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/example_selectors/__init__.py
@@ -0,0 +1,21 @@
+"""**Example selector** implements logic for selecting examples to include them
+in prompts.
+This allows us to select examples that are most relevant to the input.
+"""
+from langchain_core.example_selectors.base import BaseExampleSelector
+from langchain_core.example_selectors.length_based import (
+    LengthBasedExampleSelector,
+)
+from langchain_core.example_selectors.semantic_similarity import (
+    MaxMarginalRelevanceExampleSelector,
+    SemanticSimilarityExampleSelector,
+    sorted_values,
+)
+
+__all__ = [
+    "BaseExampleSelector",
+    "LengthBasedExampleSelector",
+    "MaxMarginalRelevanceExampleSelector",
+    "SemanticSimilarityExampleSelector",
+    "sorted_values",
+]
diff --git a/llm/Lib/site-packages/langchain_core/example_selectors/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/example_selectors/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..aa650640e5dc4d906b31adb1be9b1d684071fe3f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/example_selectors/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/example_selectors/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/example_selectors/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d49ba8a89d5912b9685a0f21d88055dc0208238d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/example_selectors/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/example_selectors/__pycache__/length_based.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/example_selectors/__pycache__/length_based.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4073d167438cd9d7096946215787686896073214
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/example_selectors/__pycache__/length_based.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/example_selectors/__pycache__/semantic_similarity.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/example_selectors/__pycache__/semantic_similarity.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..112786071c47d6b253cce1256b9f5ee710cbeb62
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/example_selectors/__pycache__/semantic_similarity.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/example_selectors/base.py b/llm/Lib/site-packages/langchain_core/example_selectors/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9b1aba0d52bafe710b65e5f2b21aac7cab58c4c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/example_selectors/base.py
@@ -0,0 +1,25 @@
+"""Interface for selecting examples to include in prompts."""
+from abc import ABC, abstractmethod
+from typing import Any, Dict, List
+
+from langchain_core.runnables import run_in_executor
+
+
+class BaseExampleSelector(ABC):
+    """Interface for selecting examples to include in prompts."""
+
+    @abstractmethod
+    def add_example(self, example: Dict[str, str]) -> Any:
+        """Add new example to store."""
+
+    async def aadd_example(self, example: Dict[str, str]) -> Any:
+        """Add new example to store."""
+        return await run_in_executor(None, self.add_example, example)
+
+    @abstractmethod
+    def select_examples(self, input_variables: Dict[str, str]) -> List[dict]:
+        """Select which examples to use based on the inputs."""
+
+    async def aselect_examples(self, input_variables: Dict[str, str]) -> List[dict]:
+        """Select which examples to use based on the inputs."""
+        return await run_in_executor(None, self.select_examples, input_variables)
diff --git a/llm/Lib/site-packages/langchain_core/example_selectors/length_based.py b/llm/Lib/site-packages/langchain_core/example_selectors/length_based.py
new file mode 100644
index 0000000000000000000000000000000000000000..20282952f3c270e58e66a7138ffb56fb8c51ef66
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/example_selectors/length_based.py
@@ -0,0 +1,71 @@
+"""Select examples based on length."""
+import re
+from typing import Callable, Dict, List
+
+from langchain_core.example_selectors.base import BaseExampleSelector
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, validator
+
+
+def _get_length_based(text: str) -> int:
+    return len(re.split("\n| ", text))
+
+
+class LengthBasedExampleSelector(BaseExampleSelector, BaseModel):
+    """Select examples based on length."""
+
+    examples: List[dict]
+    """A list of the examples that the prompt template expects."""
+
+    example_prompt: PromptTemplate
+    """Prompt template used to format the examples."""
+
+    get_text_length: Callable[[str], int] = _get_length_based
+    """Function to measure prompt length. Defaults to word count."""
+
+    max_length: int = 2048
+    """Max length for the prompt, beyond which examples are cut."""
+
+    example_text_lengths: List[int] = []  #: :meta private:
+
+    def add_example(self, example: Dict[str, str]) -> None:
+        """Add new example to list."""
+        self.examples.append(example)
+        string_example = self.example_prompt.format(**example)
+        self.example_text_lengths.append(self.get_text_length(string_example))
+
+    async def aadd_example(self, example: Dict[str, str]) -> None:
+        """Add new example to list."""
+        self.add_example(example)
+
+    @validator("example_text_lengths", always=True)
+    def calculate_example_text_lengths(cls, v: List[int], values: Dict) -> List[int]:
+        """Calculate text lengths if they don't exist."""
+        # Check if text lengths were passed in
+        if v:
+            return v
+        # If they were not, calculate them
+        example_prompt = values["example_prompt"]
+        get_text_length = values["get_text_length"]
+        string_examples = [example_prompt.format(**eg) for eg in values["examples"]]
+        return [get_text_length(eg) for eg in string_examples]
+
+    def select_examples(self, input_variables: Dict[str, str]) -> List[dict]:
+        """Select which examples to use based on the input lengths."""
+        inputs = " ".join(input_variables.values())
+        remaining_length = self.max_length - self.get_text_length(inputs)
+        i = 0
+        examples = []
+        while remaining_length > 0 and i < len(self.examples):
+            new_length = remaining_length - self.example_text_lengths[i]
+            if new_length < 0:
+                break
+            else:
+                examples.append(self.examples[i])
+                remaining_length = new_length
+            i += 1
+        return examples
+
+    async def aselect_examples(self, input_variables: Dict[str, str]) -> List[dict]:
+        """Select which examples to use based on the input lengths."""
+        return self.select_examples(input_variables)
diff --git a/llm/Lib/site-packages/langchain_core/example_selectors/semantic_similarity.py b/llm/Lib/site-packages/langchain_core/example_selectors/semantic_similarity.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a6a9044e988c9b62cc300fd3c6ec2f5085565fb
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/example_selectors/semantic_similarity.py
@@ -0,0 +1,306 @@
+"""Example selector that selects examples based on SemanticSimilarity."""
+from __future__ import annotations
+
+from abc import ABC
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Type
+
+from langchain_core.documents import Document
+from langchain_core.example_selectors.base import BaseExampleSelector
+from langchain_core.pydantic_v1 import BaseModel, Extra
+from langchain_core.vectorstores import VectorStore
+
+if TYPE_CHECKING:
+    from langchain_core.embeddings import Embeddings
+
+
+def sorted_values(values: Dict[str, str]) -> List[Any]:
+    """Return a list of values in dict sorted by key."""
+    return [values[val] for val in sorted(values)]
+
+
+class _VectorStoreExampleSelector(BaseExampleSelector, BaseModel, ABC):
+    """Example selector that selects examples based on SemanticSimilarity."""
+
+    vectorstore: VectorStore
+    """VectorStore than contains information about examples."""
+    k: int = 4
+    """Number of examples to select."""
+    example_keys: Optional[List[str]] = None
+    """Optional keys to filter examples to."""
+    input_keys: Optional[List[str]] = None
+    """Optional keys to filter input to. If provided, the search is based on
+    the input variables instead of all variables."""
+    vectorstore_kwargs: Optional[Dict[str, Any]] = None
+    """Extra arguments passed to similarity_search function of the vectorstore."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @staticmethod
+    def _example_to_text(
+        example: Dict[str, str], input_keys: Optional[List[str]]
+    ) -> str:
+        if input_keys:
+            return " ".join(sorted_values({key: example[key] for key in input_keys}))
+        else:
+            return " ".join(sorted_values(example))
+
+    def _documents_to_examples(self, documents: List[Document]) -> List[dict]:
+        # Get the examples from the metadata.
+        # This assumes that examples are stored in metadata.
+        examples = [dict(e.metadata) for e in documents]
+        # If example keys are provided, filter examples to those keys.
+        if self.example_keys:
+            examples = [{k: eg[k] for k in self.example_keys} for eg in examples]
+        return examples
+
+    def add_example(self, example: Dict[str, str]) -> str:
+        """Add new example to vectorstore."""
+        ids = self.vectorstore.add_texts(
+            [self._example_to_text(example, self.input_keys)], metadatas=[example]
+        )
+        return ids[0]
+
+    async def aadd_example(self, example: Dict[str, str]) -> str:
+        """Add new example to vectorstore."""
+        ids = await self.vectorstore.aadd_texts(
+            [self._example_to_text(example, self.input_keys)], metadatas=[example]
+        )
+        return ids[0]
+
+
+class SemanticSimilarityExampleSelector(_VectorStoreExampleSelector):
+    """Example selector that selects examples based on SemanticSimilarity."""
+
+    def select_examples(self, input_variables: Dict[str, str]) -> List[dict]:
+        """Select which examples to use based on semantic similarity."""
+        # Get the docs with the highest similarity.
+        vectorstore_kwargs = self.vectorstore_kwargs or {}
+        example_docs = self.vectorstore.similarity_search(
+            self._example_to_text(input_variables, self.input_keys),
+            k=self.k,
+            **vectorstore_kwargs,
+        )
+        return self._documents_to_examples(example_docs)
+
+    async def aselect_examples(self, input_variables: Dict[str, str]) -> List[dict]:
+        """Select which examples to use based on semantic similarity."""
+        # Get the docs with the highest similarity.
+        vectorstore_kwargs = self.vectorstore_kwargs or {}
+        example_docs = await self.vectorstore.asimilarity_search(
+            self._example_to_text(input_variables, self.input_keys),
+            k=self.k,
+            **vectorstore_kwargs,
+        )
+        return self._documents_to_examples(example_docs)
+
+    @classmethod
+    def from_examples(
+        cls,
+        examples: List[dict],
+        embeddings: Embeddings,
+        vectorstore_cls: Type[VectorStore],
+        k: int = 4,
+        input_keys: Optional[List[str]] = None,
+        *,
+        example_keys: Optional[List[str]] = None,
+        vectorstore_kwargs: Optional[dict] = None,
+        **vectorstore_cls_kwargs: Any,
+    ) -> SemanticSimilarityExampleSelector:
+        """Create k-shot example selector using example list and embeddings.
+
+        Reshuffles examples dynamically based on query similarity.
+
+        Args:
+            examples: List of examples to use in the prompt.
+            embeddings: An initialized embedding API interface, e.g. OpenAIEmbeddings().
+            vectorstore_cls: A vector store DB interface class, e.g. FAISS.
+            k: Number of examples to select
+            input_keys: If provided, the search is based on the input variables
+                instead of all variables.
+            example_keys: If provided, keys to filter examples to.
+            vectorstore_kwargs: Extra arguments passed to similarity_search function
+                of the vectorstore.
+            vectorstore_cls_kwargs: optional kwargs containing url for vector store
+
+        Returns:
+            The ExampleSelector instantiated, backed by a vector store.
+        """
+        string_examples = [cls._example_to_text(eg, input_keys) for eg in examples]
+        vectorstore = vectorstore_cls.from_texts(
+            string_examples, embeddings, metadatas=examples, **vectorstore_cls_kwargs
+        )
+        return cls(
+            vectorstore=vectorstore,
+            k=k,
+            input_keys=input_keys,
+            example_keys=example_keys,
+            vectorstore_kwargs=vectorstore_kwargs,
+        )
+
+    @classmethod
+    async def afrom_examples(
+        cls,
+        examples: List[dict],
+        embeddings: Embeddings,
+        vectorstore_cls: Type[VectorStore],
+        k: int = 4,
+        input_keys: Optional[List[str]] = None,
+        *,
+        example_keys: Optional[List[str]] = None,
+        vectorstore_kwargs: Optional[dict] = None,
+        **vectorstore_cls_kwargs: Any,
+    ) -> SemanticSimilarityExampleSelector:
+        """Create k-shot example selector using example list and embeddings.
+
+        Reshuffles examples dynamically based on query similarity.
+
+        Args:
+            examples: List of examples to use in the prompt.
+            embeddings: An initialized embedding API interface, e.g. OpenAIEmbeddings().
+            vectorstore_cls: A vector store DB interface class, e.g. FAISS.
+            k: Number of examples to select
+            input_keys: If provided, the search is based on the input variables
+                instead of all variables.
+            example_keys: If provided, keys to filter examples to.
+            vectorstore_kwargs: Extra arguments passed to similarity_search function
+                of the vectorstore.
+            vectorstore_cls_kwargs: optional kwargs containing url for vector store
+
+        Returns:
+            The ExampleSelector instantiated, backed by a vector store.
+        """
+        string_examples = [cls._example_to_text(eg, input_keys) for eg in examples]
+        vectorstore = await vectorstore_cls.afrom_texts(
+            string_examples, embeddings, metadatas=examples, **vectorstore_cls_kwargs
+        )
+        return cls(
+            vectorstore=vectorstore,
+            k=k,
+            input_keys=input_keys,
+            example_keys=example_keys,
+            vectorstore_kwargs=vectorstore_kwargs,
+        )
+
+
+class MaxMarginalRelevanceExampleSelector(_VectorStoreExampleSelector):
+    """ExampleSelector that selects examples based on Max Marginal Relevance.
+
+    This was shown to improve performance in this paper:
+    https://arxiv.org/pdf/2211.13892.pdf
+    """
+
+    fetch_k: int = 20
+    """Number of examples to fetch to rerank."""
+
+    def select_examples(self, input_variables: Dict[str, str]) -> List[dict]:
+        example_docs = self.vectorstore.max_marginal_relevance_search(
+            self._example_to_text(input_variables, self.input_keys),
+            k=self.k,
+            fetch_k=self.fetch_k,
+        )
+        return self._documents_to_examples(example_docs)
+
+    async def aselect_examples(self, input_variables: Dict[str, str]) -> List[dict]:
+        example_docs = await self.vectorstore.amax_marginal_relevance_search(
+            self._example_to_text(input_variables, self.input_keys),
+            k=self.k,
+            fetch_k=self.fetch_k,
+        )
+        return self._documents_to_examples(example_docs)
+
+    @classmethod
+    def from_examples(
+        cls,
+        examples: List[dict],
+        embeddings: Embeddings,
+        vectorstore_cls: Type[VectorStore],
+        k: int = 4,
+        input_keys: Optional[List[str]] = None,
+        fetch_k: int = 20,
+        example_keys: Optional[List[str]] = None,
+        vectorstore_kwargs: Optional[dict] = None,
+        **vectorstore_cls_kwargs: Any,
+    ) -> MaxMarginalRelevanceExampleSelector:
+        """Create k-shot example selector using example list and embeddings.
+
+        Reshuffles examples dynamically based on Max Marginal Relevance.
+
+        Args:
+            examples: List of examples to use in the prompt.
+            embeddings: An initialized embedding API interface, e.g. OpenAIEmbeddings().
+            vectorstore_cls: A vector store DB interface class, e.g. FAISS.
+            k: Number of examples to select
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            input_keys: If provided, the search is based on the input variables
+                instead of all variables.
+            example_keys: If provided, keys to filter examples to.
+            vectorstore_kwargs: Extra arguments passed to similarity_search function
+                of the vectorstore.
+            vectorstore_cls_kwargs: optional kwargs containing url for vector store
+
+        Returns:
+            The ExampleSelector instantiated, backed by a vector store.
+        """
+        string_examples = [cls._example_to_text(eg, input_keys) for eg in examples]
+        vectorstore = vectorstore_cls.from_texts(
+            string_examples, embeddings, metadatas=examples, **vectorstore_cls_kwargs
+        )
+        return cls(
+            vectorstore=vectorstore,
+            k=k,
+            fetch_k=fetch_k,
+            input_keys=input_keys,
+            example_keys=example_keys,
+            vectorstore_kwargs=vectorstore_kwargs,
+        )
+
+    @classmethod
+    async def afrom_examples(
+        cls,
+        examples: List[dict],
+        embeddings: Embeddings,
+        vectorstore_cls: Type[VectorStore],
+        *,
+        k: int = 4,
+        input_keys: Optional[List[str]] = None,
+        fetch_k: int = 20,
+        example_keys: Optional[List[str]] = None,
+        vectorstore_kwargs: Optional[dict] = None,
+        **vectorstore_cls_kwargs: Any,
+    ) -> MaxMarginalRelevanceExampleSelector:
+        """Create k-shot example selector using example list and embeddings.
+
+        Reshuffles examples dynamically based on Max Marginal Relevance.
+
+        Args:
+            examples: List of examples to use in the prompt.
+            embeddings: An initialized embedding API interface, e.g. OpenAIEmbeddings().
+            vectorstore_cls: A vector store DB interface class, e.g. FAISS.
+            k: Number of examples to select
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            input_keys: If provided, the search is based on the input variables
+                instead of all variables.
+            example_keys: If provided, keys to filter examples to.
+            vectorstore_kwargs: Extra arguments passed to similarity_search function
+                of the vectorstore.
+            vectorstore_cls_kwargs: optional kwargs containing url for vector store
+
+        Returns:
+            The ExampleSelector instantiated, backed by a vector store.
+        """
+        string_examples = [cls._example_to_text(eg, input_keys) for eg in examples]
+        vectorstore = await vectorstore_cls.afrom_texts(
+            string_examples, embeddings, metadatas=examples, **vectorstore_cls_kwargs
+        )
+        return cls(
+            vectorstore=vectorstore,
+            k=k,
+            fetch_k=fetch_k,
+            input_keys=input_keys,
+            example_keys=example_keys,
+            vectorstore_kwargs=vectorstore_kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain_core/exceptions.py b/llm/Lib/site-packages/langchain_core/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..05c36a9a9005b0c65dde7e46eaf7caa162becffd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/exceptions.py
@@ -0,0 +1,49 @@
+"""Custom **exceptions** for LangChain. """
+from typing import Any, Optional
+
+
+class LangChainException(Exception):
+    """General LangChain exception."""
+
+
+class TracerException(LangChainException):
+    """Base class for exceptions in tracers module."""
+
+
+class OutputParserException(ValueError, LangChainException):
+    """Exception that output parsers should raise to signify a parsing error.
+
+    This exists to differentiate parsing errors from other code or execution errors
+    that also may arise inside the output parser. OutputParserExceptions will be
+    available to catch and handle in ways to fix the parsing error, while other
+    errors will be raised.
+
+    Args:
+        error: The error that's being re-raised or an error message.
+        observation: String explanation of error which can be passed to a
+            model to try and remediate the issue.
+        llm_output: String model output which is error-ing.
+        send_to_llm: Whether to send the observation and llm_output back to an Agent
+            after an OutputParserException has been raised. This gives the underlying
+            model driving the agent the context that the previous output was improperly
+            structured, in the hopes that it will update the output to the correct
+            format.
+    """
+
+    def __init__(
+        self,
+        error: Any,
+        observation: Optional[str] = None,
+        llm_output: Optional[str] = None,
+        send_to_llm: bool = False,
+    ):
+        super(OutputParserException, self).__init__(error)
+        if send_to_llm:
+            if observation is None or llm_output is None:
+                raise ValueError(
+                    "Arguments 'observation' & 'llm_output'"
+                    " are required if 'send_to_llm' is True"
+                )
+        self.observation = observation
+        self.llm_output = llm_output
+        self.send_to_llm = send_to_llm
diff --git a/llm/Lib/site-packages/langchain_core/globals.py b/llm/Lib/site-packages/langchain_core/globals.py
new file mode 100644
index 0000000000000000000000000000000000000000..89963f4dace62932a0011fe2a127b7a6cda08e08
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/globals.py
@@ -0,0 +1,197 @@
+# flake8: noqa
+"""Global values and configuration that apply to all of LangChain."""
+import warnings
+from typing import TYPE_CHECKING, Optional
+
+if TYPE_CHECKING:
+    from langchain_core.caches import BaseCache
+
+
+# DO NOT USE THESE VALUES DIRECTLY!
+# Use them only via `get_<X>()` and `set_<X>()` below,
+# or else your code may behave unexpectedly with other uses of these global settings:
+# https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+_verbose: bool = False
+_debug: bool = False
+_llm_cache: Optional["BaseCache"] = None
+
+
+def set_verbose(value: bool) -> None:
+    """Set a new value for the `verbose` global setting."""
+    try:
+        import langchain  # type: ignore[import]
+
+        # We're about to run some deprecated code, don't report warnings from it.
+        # The user called the correct (non-deprecated) code path and shouldn't get warnings.
+        with warnings.catch_warnings():
+            warnings.filterwarnings(
+                "ignore",
+                message=(
+                    "Importing verbose from langchain root module is no longer supported"
+                ),
+            )
+            # N.B.: This is a workaround for an unfortunate quirk of Python's
+            #       module-level `__getattr__()` implementation:
+            # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+            #
+            # Remove it once `langchain.verbose` is no longer supported, and once all users
+            # have migrated to using `set_verbose()` here.
+            langchain.verbose = value
+    except ImportError:
+        pass
+
+    global _verbose
+    _verbose = value
+
+
+def get_verbose() -> bool:
+    """Get the value of the `verbose` global setting."""
+    try:
+        import langchain  # type: ignore[import]
+
+        # We're about to run some deprecated code, don't report warnings from it.
+        # The user called the correct (non-deprecated) code path and shouldn't get warnings.
+        with warnings.catch_warnings():
+            warnings.filterwarnings(
+                "ignore",
+                message=(
+                    ".*Importing verbose from langchain root module is no longer supported"
+                ),
+            )
+            # N.B.: This is a workaround for an unfortunate quirk of Python's
+            #       module-level `__getattr__()` implementation:
+            # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+            #
+            # Remove it once `langchain.verbose` is no longer supported, and once all users
+            # have migrated to using `set_verbose()` here.
+            #
+            # In the meantime, the `verbose` setting is considered True if either the old
+            # or the new value are True. This accommodates users who haven't migrated
+            # to using `set_verbose()` yet. Those users are getting deprecation warnings
+            # directing them to use `set_verbose()` when they import `langhchain.verbose`.
+            old_verbose = langchain.verbose
+    except ImportError:
+        old_verbose = False
+
+    global _verbose
+    return _verbose or old_verbose
+
+
+def set_debug(value: bool) -> None:
+    """Set a new value for the `debug` global setting."""
+    try:
+        import langchain  # type: ignore[import]
+
+        # We're about to run some deprecated code, don't report warnings from it.
+        # The user called the correct (non-deprecated) code path and shouldn't get warnings.
+        with warnings.catch_warnings():
+            warnings.filterwarnings(
+                "ignore",
+                message="Importing debug from langchain root module is no longer supported",
+            )
+            # N.B.: This is a workaround for an unfortunate quirk of Python's
+            #       module-level `__getattr__()` implementation:
+            # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+            #
+            # Remove it once `langchain.debug` is no longer supported, and once all users
+            # have migrated to using `set_debug()` here.
+            langchain.debug = value
+    except ImportError:
+        pass
+
+    global _debug
+    _debug = value
+
+
+def get_debug() -> bool:
+    """Get the value of the `debug` global setting."""
+    try:
+        import langchain  # type: ignore[import]
+
+        # We're about to run some deprecated code, don't report warnings from it.
+        # The user called the correct (non-deprecated) code path and shouldn't get warnings.
+        with warnings.catch_warnings():
+            warnings.filterwarnings(
+                "ignore",
+                message="Importing debug from langchain root module is no longer supported",
+            )
+            # N.B.: This is a workaround for an unfortunate quirk of Python's
+            #       module-level `__getattr__()` implementation:
+            # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+            #
+            # Remove it once `langchain.debug` is no longer supported, and once all users
+            # have migrated to using `set_debug()` here.
+            #
+            # In the meantime, the `debug` setting is considered True if either the old
+            # or the new value are True. This accommodates users who haven't migrated
+            # to using `set_debug()` yet. Those users are getting deprecation warnings
+            # directing them to use `set_debug()` when they import `langhchain.debug`.
+            old_debug = langchain.debug
+    except ImportError:
+        old_debug = False
+
+    global _debug
+    return _debug or old_debug
+
+
+def set_llm_cache(value: Optional["BaseCache"]) -> None:
+    """Set a new LLM cache, overwriting the previous value, if any."""
+    try:
+        import langchain  # type: ignore[import]
+
+        # We're about to run some deprecated code, don't report warnings from it.
+        # The user called the correct (non-deprecated) code path and shouldn't get warnings.
+        with warnings.catch_warnings():
+            warnings.filterwarnings(
+                "ignore",
+                message=(
+                    "Importing llm_cache from langchain root module is no longer supported"
+                ),
+            )
+            # N.B.: This is a workaround for an unfortunate quirk of Python's
+            #       module-level `__getattr__()` implementation:
+            # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+            #
+            # Remove it once `langchain.llm_cache` is no longer supported, and
+            # once all users have migrated to using `set_llm_cache()` here.
+            langchain.llm_cache = value
+    except ImportError:
+        pass
+
+    global _llm_cache
+    _llm_cache = value
+
+
+def get_llm_cache() -> "BaseCache":
+    """Get the value of the `llm_cache` global setting."""
+    try:
+        import langchain  # type: ignore[import]
+
+        # We're about to run some deprecated code, don't report warnings from it.
+        # The user called the correct (non-deprecated) code path and shouldn't get warnings.
+        with warnings.catch_warnings():
+            warnings.filterwarnings(
+                "ignore",
+                message=(
+                    "Importing llm_cache from langchain root module is no longer supported"
+                ),
+            )
+            # N.B.: This is a workaround for an unfortunate quirk of Python's
+            #       module-level `__getattr__()` implementation:
+            # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
+            #
+            # Remove it once `langchain.llm_cache` is no longer supported, and
+            # once all users have migrated to using `set_llm_cache()` here.
+            #
+            # In the meantime, the `llm_cache` setting returns whichever of
+            # its two backing sources is truthy (not `None` and non-empty),
+            # or the old value if both are falsy. This accommodates users
+            # who haven't migrated to using `set_llm_cache()` yet.
+            # Those users are getting deprecation warnings directing them
+            # to use `set_llm_cache()` when they import `langhchain.llm_cache`.
+            old_llm_cache = langchain.llm_cache
+    except ImportError:
+        old_llm_cache = None
+
+    global _llm_cache
+    return _llm_cache or old_llm_cache
diff --git a/llm/Lib/site-packages/langchain_core/language_models/__init__.py b/llm/Lib/site-packages/langchain_core/language_models/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a29c891682e43dc59866cc6bce74b32dc6134716
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/language_models/__init__.py
@@ -0,0 +1,58 @@
+"""**Language Model** is a type of model that can generate text or complete
+text prompts. 
+
+LangChain has two main classes to work with language models:
+- **LLM** classes provide access to the large language model (**LLM**) APIs and services.
+- **Chat Models** are a variation on language models.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseLanguageModel --> BaseLLM --> LLM --> <name>  # Examples: AI21, HuggingFaceHub, OpenAI
+                      --> BaseChatModel --> <name>    # Examples: ChatOpenAI, ChatGooglePalm
+
+**Main helpers:**
+
+.. code-block::
+
+    LLMResult, PromptValue,
+    CallbackManagerForLLMRun, AsyncCallbackManagerForLLMRun,
+    CallbackManager, AsyncCallbackManager,
+    AIMessage, BaseMessage, HumanMessage
+"""  # noqa: E501
+
+from langchain_core.language_models.base import (
+    BaseLanguageModel,
+    LanguageModelInput,
+    LanguageModelLike,
+    LanguageModelOutput,
+    get_tokenizer,
+)
+from langchain_core.language_models.chat_models import BaseChatModel, SimpleChatModel
+from langchain_core.language_models.fake import FakeListLLM, FakeStreamingListLLM
+from langchain_core.language_models.fake_chat_models import (
+    FakeListChatModel,
+    FakeMessagesListChatModel,
+    GenericFakeChatModel,
+    ParrotFakeChatModel,
+)
+from langchain_core.language_models.llms import LLM, BaseLLM
+
+__all__ = [
+    "BaseLanguageModel",
+    "BaseChatModel",
+    "SimpleChatModel",
+    "BaseLLM",
+    "LLM",
+    "LanguageModelInput",
+    "get_tokenizer",
+    "LanguageModelOutput",
+    "LanguageModelLike",
+    "FakeListLLM",
+    "FakeStreamingListLLM",
+    "FakeListChatModel",
+    "FakeMessagesListChatModel",
+    "GenericFakeChatModel",
+    "ParrotFakeChatModel",
+]
diff --git a/llm/Lib/site-packages/langchain_core/language_models/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/language_models/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1f4c219ebad1a59442adf3dc4445a5a5884bcfa8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/language_models/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/language_models/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/language_models/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..2582d813a4f899745670f5b8f054200a43761868
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/language_models/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/language_models/__pycache__/chat_models.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/language_models/__pycache__/chat_models.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1c74f8b9a04fb76379ef343f7b9146b4c19c66e7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/language_models/__pycache__/chat_models.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/language_models/__pycache__/fake.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/language_models/__pycache__/fake.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b6d015b6551de41cb1bdcbb81c99f1fe6c88db1f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/language_models/__pycache__/fake.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/language_models/__pycache__/fake_chat_models.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/language_models/__pycache__/fake_chat_models.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a8228fa115b3151d3230fafdcdfa757842b5dee4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/language_models/__pycache__/fake_chat_models.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/language_models/__pycache__/llms.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/language_models/__pycache__/llms.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..26958e70d15e67149ed5c7dfead74b8ed57b456c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/language_models/__pycache__/llms.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/language_models/base.py b/llm/Lib/site-packages/langchain_core/language_models/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..4941faea345890eb2656df59f5699f1786bd2b5d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/language_models/base.py
@@ -0,0 +1,347 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from functools import lru_cache
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    List,
+    Mapping,
+    Optional,
+    Sequence,
+    Set,
+    Type,
+    TypeVar,
+    Union,
+)
+
+from typing_extensions import TypeAlias
+
+from langchain_core._api import beta, deprecated
+from langchain_core.messages import (
+    AnyMessage,
+    BaseMessage,
+    MessageLikeRepresentation,
+    get_buffer_string,
+)
+from langchain_core.prompt_values import PromptValue
+from langchain_core.pydantic_v1 import BaseModel, Field, validator
+from langchain_core.runnables import Runnable, RunnableSerializable
+from langchain_core.utils import get_pydantic_field_names
+
+if TYPE_CHECKING:
+    from langchain_core.caches import BaseCache
+    from langchain_core.callbacks import Callbacks
+    from langchain_core.outputs import LLMResult
+
+
+@lru_cache(maxsize=None)  # Cache the tokenizer
+def get_tokenizer() -> Any:
+    try:
+        from transformers import GPT2TokenizerFast  # type: ignore[import]
+    except ImportError:
+        raise ImportError(
+            "Could not import transformers python package. "
+            "This is needed in order to calculate get_token_ids. "
+            "Please install it with `pip install transformers`."
+        )
+    # create a GPT-2 tokenizer instance
+    return GPT2TokenizerFast.from_pretrained("gpt2")
+
+
+def _get_token_ids_default_method(text: str) -> List[int]:
+    """Encode the text into token IDs."""
+    # get the cached tokenizer
+    tokenizer = get_tokenizer()
+
+    # tokenize the text using the GPT-2 tokenizer
+    return tokenizer.encode(text)
+
+
+LanguageModelInput = Union[PromptValue, str, Sequence[MessageLikeRepresentation]]
+LanguageModelOutput = Union[BaseMessage, str]
+LanguageModelLike = Runnable[LanguageModelInput, LanguageModelOutput]
+LanguageModelOutputVar = TypeVar("LanguageModelOutputVar", BaseMessage, str)
+
+
+def _get_verbosity() -> bool:
+    from langchain_core.globals import get_verbose
+
+    return get_verbose()
+
+
+class BaseLanguageModel(
+    RunnableSerializable[LanguageModelInput, LanguageModelOutputVar], ABC
+):
+    """Abstract base class for interfacing with language models.
+
+    All language model wrappers inherit from BaseLanguageModel.
+    """
+
+    cache: Union[BaseCache, bool, None] = None
+    """Whether to cache the response.
+    
+    * If true, will use the global cache.
+    * If false, will not use a cache
+    * If None, will use the global cache if it's set, otherwise no cache.
+    * If instance of BaseCache, will use the provided cache.
+    
+    Caching is not currently supported for streaming methods of models.
+    """
+    verbose: bool = Field(default_factory=_get_verbosity)
+    """Whether to print out response text."""
+    callbacks: Callbacks = Field(default=None, exclude=True)
+    """Callbacks to add to the run trace."""
+    tags: Optional[List[str]] = Field(default=None, exclude=True)
+    """Tags to add to the run trace."""
+    metadata: Optional[Dict[str, Any]] = Field(default=None, exclude=True)
+    """Metadata to add to the run trace."""
+
+    @validator("verbose", pre=True, always=True)
+    def set_verbose(cls, verbose: Optional[bool]) -> bool:
+        """If verbose is None, set it.
+
+        This allows users to pass in None as verbose to access the global setting.
+        """
+        if verbose is None:
+            return _get_verbosity()
+        else:
+            return verbose
+
+    @property
+    def InputType(self) -> TypeAlias:
+        """Get the input type for this runnable."""
+        from langchain_core.prompt_values import (
+            ChatPromptValueConcrete,
+            StringPromptValue,
+        )
+
+        # This is a version of LanguageModelInput which replaces the abstract
+        # base class BaseMessage with a union of its subclasses, which makes
+        # for a much better schema.
+        return Union[
+            str,
+            Union[StringPromptValue, ChatPromptValueConcrete],
+            List[AnyMessage],
+        ]
+
+    @abstractmethod
+    def generate_prompt(
+        self,
+        prompts: List[PromptValue],
+        stop: Optional[List[str]] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Pass a sequence of prompts to the model and return model generations.
+
+        This method should make use of batched calls for models that expose a batched
+        API.
+
+        Use this method when you want to:
+            1. take advantage of batched calls,
+            2. need more output from the model than just the top generated value,
+            3. are building chains that are agnostic to the underlying language model
+                type (e.g., pure text completion models vs chat models).
+
+        Args:
+            prompts: List of PromptValues. A PromptValue is an object that can be
+                converted to match the format of any language model (string for pure
+                text generation models and BaseMessages for chat models).
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of these substrings.
+            callbacks: Callbacks to pass through. Used for executing additional
+                functionality, such as logging or streaming, throughout generation.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            An LLMResult, which contains a list of candidate Generations for each input
+                prompt and additional model provider-specific output.
+        """
+
+    @abstractmethod
+    async def agenerate_prompt(
+        self,
+        prompts: List[PromptValue],
+        stop: Optional[List[str]] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Asynchronously pass a sequence of prompts and return model generations.
+
+        This method should make use of batched calls for models that expose a batched
+        API.
+
+        Use this method when you want to:
+            1. take advantage of batched calls,
+            2. need more output from the model than just the top generated value,
+            3. are building chains that are agnostic to the underlying language model
+                type (e.g., pure text completion models vs chat models).
+
+        Args:
+            prompts: List of PromptValues. A PromptValue is an object that can be
+                converted to match the format of any language model (string for pure
+                text generation models and BaseMessages for chat models).
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of these substrings.
+            callbacks: Callbacks to pass through. Used for executing additional
+                functionality, such as logging or streaming, throughout generation.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            An LLMResult, which contains a list of candidate Generations for each input
+                prompt and additional model provider-specific output.
+        """
+
+    @beta()
+    def with_structured_output(
+        self, schema: Union[Dict, Type[BaseModel]], **kwargs: Any
+    ) -> Runnable[LanguageModelInput, Union[Dict, BaseModel]]:
+        """Implement this if there is a way of steering the model to generate responses that match a given schema."""  # noqa: E501
+        raise NotImplementedError()
+
+    @deprecated("0.1.7", alternative="invoke", removal="0.2.0")
+    @abstractmethod
+    def predict(
+        self, text: str, *, stop: Optional[Sequence[str]] = None, **kwargs: Any
+    ) -> str:
+        """Pass a single string input to the model and return a string.
+
+         Use this method when passing in raw text. If you want to pass in specific
+            types of chat messages, use predict_messages.
+
+        Args:
+            text: String input to pass to the model.
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of these substrings.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            Top model prediction as a string.
+        """
+
+    @deprecated("0.1.7", alternative="invoke", removal="0.2.0")
+    @abstractmethod
+    def predict_messages(
+        self,
+        messages: List[BaseMessage],
+        *,
+        stop: Optional[Sequence[str]] = None,
+        **kwargs: Any,
+    ) -> BaseMessage:
+        """Pass a message sequence to the model and return a message.
+
+        Use this method when passing in chat messages. If you want to pass in raw text,
+            use predict.
+
+        Args:
+            messages: A sequence of chat messages corresponding to a single model input.
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of these substrings.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            Top model prediction as a message.
+        """
+
+    @deprecated("0.1.7", alternative="ainvoke", removal="0.2.0")
+    @abstractmethod
+    async def apredict(
+        self, text: str, *, stop: Optional[Sequence[str]] = None, **kwargs: Any
+    ) -> str:
+        """Asynchronously pass a string to the model and return a string.
+
+        Use this method when calling pure text generation models and only the top
+            candidate generation is needed.
+
+        Args:
+            text: String input to pass to the model.
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of these substrings.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            Top model prediction as a string.
+        """
+
+    @deprecated("0.1.7", alternative="ainvoke", removal="0.2.0")
+    @abstractmethod
+    async def apredict_messages(
+        self,
+        messages: List[BaseMessage],
+        *,
+        stop: Optional[Sequence[str]] = None,
+        **kwargs: Any,
+    ) -> BaseMessage:
+        """Asynchronously pass messages to the model and return a message.
+
+        Use this method when calling chat models and only the top
+            candidate generation is needed.
+
+        Args:
+            messages: A sequence of chat messages corresponding to a single model input.
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of these substrings.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            Top model prediction as a message.
+        """
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        """Get the identifying parameters."""
+        return self.lc_attributes
+
+    def get_token_ids(self, text: str) -> List[int]:
+        """Return the ordered ids of the tokens in a text.
+
+        Args:
+            text: The string input to tokenize.
+
+        Returns:
+            A list of ids corresponding to the tokens in the text, in order they occur
+                in the text.
+        """
+        return _get_token_ids_default_method(text)
+
+    def get_num_tokens(self, text: str) -> int:
+        """Get the number of tokens present in the text.
+
+        Useful for checking if an input will fit in a model's context window.
+
+        Args:
+            text: The string input to tokenize.
+
+        Returns:
+            The integer number of tokens in the text.
+        """
+        return len(self.get_token_ids(text))
+
+    def get_num_tokens_from_messages(self, messages: List[BaseMessage]) -> int:
+        """Get the number of tokens in the messages.
+
+        Useful for checking if an input will fit in a model's context window.
+
+        Args:
+            messages: The message inputs to tokenize.
+
+        Returns:
+            The sum of the number of tokens across the messages.
+        """
+        return sum([self.get_num_tokens(get_buffer_string([m])) for m in messages])
+
+    @classmethod
+    def _all_required_field_names(cls) -> Set:
+        """DEPRECATED: Kept for backwards compatibility.
+
+        Use get_pydantic_field_names.
+        """
+        return get_pydantic_field_names(cls)
diff --git a/llm/Lib/site-packages/langchain_core/language_models/chat_models.py b/llm/Lib/site-packages/langchain_core/language_models/chat_models.py
new file mode 100644
index 0000000000000000000000000000000000000000..f24c52e4311eaeb353eba9402fb84a334c5857fd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/language_models/chat_models.py
@@ -0,0 +1,963 @@
+from __future__ import annotations
+
+import asyncio
+import inspect
+import uuid
+import warnings
+from abc import ABC, abstractmethod
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+    Sequence,
+    Type,
+    Union,
+    cast,
+)
+
+from langchain_core._api import deprecated
+from langchain_core.caches import BaseCache
+from langchain_core.callbacks import (
+    AsyncCallbackManager,
+    AsyncCallbackManagerForLLMRun,
+    BaseCallbackManager,
+    CallbackManager,
+    CallbackManagerForLLMRun,
+    Callbacks,
+)
+from langchain_core.globals import get_llm_cache
+from langchain_core.language_models.base import BaseLanguageModel, LanguageModelInput
+from langchain_core.load import dumpd, dumps
+from langchain_core.messages import (
+    AIMessage,
+    AnyMessage,
+    BaseMessage,
+    BaseMessageChunk,
+    HumanMessage,
+    convert_to_messages,
+    message_chunk_to_message,
+)
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatGenerationChunk,
+    ChatResult,
+    LLMResult,
+    RunInfo,
+)
+from langchain_core.prompt_values import ChatPromptValue, PromptValue, StringPromptValue
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.runnables.config import ensure_config, run_in_executor
+from langchain_core.tracers.log_stream import LogStreamCallbackHandler
+
+if TYPE_CHECKING:
+    from langchain_core.pydantic_v1 import BaseModel
+    from langchain_core.runnables import Runnable, RunnableConfig
+    from langchain_core.tools import BaseTool
+
+
+def generate_from_stream(stream: Iterator[ChatGenerationChunk]) -> ChatResult:
+    """Generate from a stream."""
+
+    generation: Optional[ChatGenerationChunk] = None
+    for chunk in stream:
+        if generation is None:
+            generation = chunk
+        else:
+            generation += chunk
+    assert generation is not None
+    return ChatResult(
+        generations=[
+            ChatGeneration(
+                message=message_chunk_to_message(generation.message),
+                generation_info=generation.generation_info,
+            )
+        ]
+    )
+
+
+async def agenerate_from_stream(
+    stream: AsyncIterator[ChatGenerationChunk],
+) -> ChatResult:
+    """Async generate from a stream."""
+
+    generation: Optional[ChatGenerationChunk] = None
+    async for chunk in stream:
+        if generation is None:
+            generation = chunk
+        else:
+            generation += chunk
+    assert generation is not None
+    return ChatResult(
+        generations=[
+            ChatGeneration(
+                message=message_chunk_to_message(generation.message),
+                generation_info=generation.generation_info,
+            )
+        ]
+    )
+
+
+class BaseChatModel(BaseLanguageModel[BaseMessage], ABC):
+    """Base class for Chat models."""
+
+    callback_manager: Optional[BaseCallbackManager] = Field(default=None, exclude=True)
+    """[DEPRECATED] Callback manager to add to the run trace."""
+
+    @root_validator()
+    def raise_deprecation(cls, values: Dict) -> Dict:
+        """Raise deprecation warning if callback_manager is used."""
+        if values.get("callback_manager") is not None:
+            warnings.warn(
+                "callback_manager is deprecated. Please use callbacks instead.",
+                DeprecationWarning,
+            )
+            values["callbacks"] = values.pop("callback_manager", None)
+        return values
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    # --- Runnable methods ---
+
+    @property
+    def OutputType(self) -> Any:
+        """Get the output type for this runnable."""
+        return AnyMessage
+
+    def _convert_input(self, input: LanguageModelInput) -> PromptValue:
+        if isinstance(input, PromptValue):
+            return input
+        elif isinstance(input, str):
+            return StringPromptValue(text=input)
+        elif isinstance(input, Sequence):
+            return ChatPromptValue(messages=convert_to_messages(input))
+        else:
+            raise ValueError(
+                f"Invalid input type {type(input)}. "
+                "Must be a PromptValue, str, or list of BaseMessages."
+            )
+
+    def invoke(
+        self,
+        input: LanguageModelInput,
+        config: Optional[RunnableConfig] = None,
+        *,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> BaseMessage:
+        config = ensure_config(config)
+        return cast(
+            ChatGeneration,
+            self.generate_prompt(
+                [self._convert_input(input)],
+                stop=stop,
+                callbacks=config.get("callbacks"),
+                tags=config.get("tags"),
+                metadata=config.get("metadata"),
+                run_name=config.get("run_name"),
+                run_id=config.pop("run_id", None),
+                **kwargs,
+            ).generations[0][0],
+        ).message
+
+    async def ainvoke(
+        self,
+        input: LanguageModelInput,
+        config: Optional[RunnableConfig] = None,
+        *,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> BaseMessage:
+        config = ensure_config(config)
+        llm_result = await self.agenerate_prompt(
+            [self._convert_input(input)],
+            stop=stop,
+            callbacks=config.get("callbacks"),
+            tags=config.get("tags"),
+            metadata=config.get("metadata"),
+            run_name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+            **kwargs,
+        )
+        return cast(ChatGeneration, llm_result.generations[0][0]).message
+
+    def stream(
+        self,
+        input: LanguageModelInput,
+        config: Optional[RunnableConfig] = None,
+        *,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Iterator[BaseMessageChunk]:
+        if type(self)._stream == BaseChatModel._stream:
+            # model doesn't implement streaming, so use default implementation
+            yield cast(
+                BaseMessageChunk, self.invoke(input, config=config, stop=stop, **kwargs)
+            )
+        else:
+            config = ensure_config(config)
+            messages = self._convert_input(input).to_messages()
+            params = self._get_invocation_params(stop=stop, **kwargs)
+            options = {"stop": stop, **kwargs}
+            callback_manager = CallbackManager.configure(
+                config.get("callbacks"),
+                self.callbacks,
+                self.verbose,
+                config.get("tags"),
+                self.tags,
+                config.get("metadata"),
+                self.metadata,
+            )
+            (run_manager,) = callback_manager.on_chat_model_start(
+                dumpd(self),
+                [messages],
+                invocation_params=params,
+                options=options,
+                name=config.get("run_name"),
+                run_id=config.pop("run_id", None),
+                batch_size=1,
+            )
+            generation: Optional[ChatGenerationChunk] = None
+            try:
+                for chunk in self._stream(messages, stop=stop, **kwargs):
+                    if chunk.message.id is None:
+                        chunk.message.id = f"run-{run_manager.run_id}"
+                    chunk.message.response_metadata = _gen_info_and_msg_metadata(chunk)
+                    run_manager.on_llm_new_token(
+                        cast(str, chunk.message.content), chunk=chunk
+                    )
+                    yield chunk.message
+                    if generation is None:
+                        generation = chunk
+                    else:
+                        generation += chunk
+                assert generation is not None
+            except BaseException as e:
+                run_manager.on_llm_error(
+                    e,
+                    response=LLMResult(
+                        generations=[[generation]] if generation else []
+                    ),
+                )
+                raise e
+            else:
+                run_manager.on_llm_end(LLMResult(generations=[[generation]]))
+
+    async def astream(
+        self,
+        input: LanguageModelInput,
+        config: Optional[RunnableConfig] = None,
+        *,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[BaseMessageChunk]:
+        if (
+            type(self)._astream is BaseChatModel._astream
+            and type(self)._stream is BaseChatModel._stream
+        ):
+            # No async or sync stream is implemented, so fall back to ainvoke
+            yield cast(
+                BaseMessageChunk,
+                await self.ainvoke(input, config=config, stop=stop, **kwargs),
+            )
+            return
+
+        config = ensure_config(config)
+        messages = self._convert_input(input).to_messages()
+        params = self._get_invocation_params(stop=stop, **kwargs)
+        options = {"stop": stop, **kwargs}
+        callback_manager = AsyncCallbackManager.configure(
+            config.get("callbacks"),
+            self.callbacks,
+            self.verbose,
+            config.get("tags"),
+            self.tags,
+            config.get("metadata"),
+            self.metadata,
+        )
+        (run_manager,) = await callback_manager.on_chat_model_start(
+            dumpd(self),
+            [messages],
+            invocation_params=params,
+            options=options,
+            name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+            batch_size=1,
+        )
+
+        generation: Optional[ChatGenerationChunk] = None
+        try:
+            async for chunk in self._astream(
+                messages,
+                stop=stop,
+                **kwargs,
+            ):
+                if chunk.message.id is None:
+                    chunk.message.id = f"run-{run_manager.run_id}"
+                chunk.message.response_metadata = _gen_info_and_msg_metadata(chunk)
+                await run_manager.on_llm_new_token(
+                    cast(str, chunk.message.content), chunk=chunk
+                )
+                yield chunk.message
+                if generation is None:
+                    generation = chunk
+                else:
+                    generation += chunk
+            assert generation is not None
+        except BaseException as e:
+            await run_manager.on_llm_error(
+                e,
+                response=LLMResult(generations=[[generation]] if generation else []),
+            )
+            raise e
+        else:
+            await run_manager.on_llm_end(
+                LLMResult(generations=[[generation]]),
+            )
+
+    # --- Custom methods ---
+
+    def _combine_llm_outputs(self, llm_outputs: List[Optional[dict]]) -> dict:
+        return {}
+
+    def _get_invocation_params(
+        self,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> dict:
+        params = self.dict()
+        params["stop"] = stop
+        return {**params, **kwargs}
+
+    def _get_llm_string(self, stop: Optional[List[str]] = None, **kwargs: Any) -> str:
+        if self.is_lc_serializable():
+            params = {**kwargs, **{"stop": stop}}
+            param_string = str(sorted([(k, v) for k, v in params.items()]))
+            llm_string = dumps(self)
+            return llm_string + "---" + param_string
+        else:
+            params = self._get_invocation_params(stop=stop, **kwargs)
+            params = {**params, **kwargs}
+            return str(sorted([(k, v) for k, v in params.items()]))
+
+    def generate(
+        self,
+        messages: List[List[BaseMessage]],
+        stop: Optional[List[str]] = None,
+        callbacks: Callbacks = None,
+        *,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        run_name: Optional[str] = None,
+        run_id: Optional[uuid.UUID] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Pass a sequence of prompts to the model and return model generations.
+
+        This method should make use of batched calls for models that expose a batched
+        API.
+
+        Use this method when you want to:
+            1. take advantage of batched calls,
+            2. need more output from the model than just the top generated value,
+            3. are building chains that are agnostic to the underlying language model
+                type (e.g., pure text completion models vs chat models).
+
+        Args:
+            messages: List of list of messages.
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of these substrings.
+            callbacks: Callbacks to pass through. Used for executing additional
+                functionality, such as logging or streaming, throughout generation.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            An LLMResult, which contains a list of candidate Generations for each input
+                prompt and additional model provider-specific output.
+        """
+        params = self._get_invocation_params(stop=stop, **kwargs)
+        options = {"stop": stop}
+
+        callback_manager = CallbackManager.configure(
+            callbacks,
+            self.callbacks,
+            self.verbose,
+            tags,
+            self.tags,
+            metadata,
+            self.metadata,
+        )
+        run_managers = callback_manager.on_chat_model_start(
+            dumpd(self),
+            messages,
+            invocation_params=params,
+            options=options,
+            name=run_name,
+            run_id=run_id,
+            batch_size=len(messages),
+        )
+        results = []
+        for i, m in enumerate(messages):
+            try:
+                results.append(
+                    self._generate_with_cache(
+                        m,
+                        stop=stop,
+                        run_manager=run_managers[i] if run_managers else None,
+                        **kwargs,
+                    )
+                )
+            except BaseException as e:
+                if run_managers:
+                    run_managers[i].on_llm_error(e, response=LLMResult(generations=[]))
+                raise e
+        flattened_outputs = [
+            LLMResult(generations=[res.generations], llm_output=res.llm_output)  # type: ignore[list-item]
+            for res in results
+        ]
+        llm_output = self._combine_llm_outputs([res.llm_output for res in results])
+        generations = [res.generations for res in results]
+        output = LLMResult(generations=generations, llm_output=llm_output)  # type: ignore[arg-type]
+        if run_managers:
+            run_infos = []
+            for manager, flattened_output in zip(run_managers, flattened_outputs):
+                manager.on_llm_end(flattened_output)
+                run_infos.append(RunInfo(run_id=manager.run_id))
+            output.run = run_infos
+        return output
+
+    async def agenerate(
+        self,
+        messages: List[List[BaseMessage]],
+        stop: Optional[List[str]] = None,
+        callbacks: Callbacks = None,
+        *,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        run_name: Optional[str] = None,
+        run_id: Optional[uuid.UUID] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Asynchronously pass a sequence of prompts to a model and return generations.
+
+        This method should make use of batched calls for models that expose a batched
+        API.
+
+        Use this method when you want to:
+            1. take advantage of batched calls,
+            2. need more output from the model than just the top generated value,
+            3. are building chains that are agnostic to the underlying language model
+                type (e.g., pure text completion models vs chat models).
+
+        Args:
+            messages: List of list of messages.
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of these substrings.
+            callbacks: Callbacks to pass through. Used for executing additional
+                functionality, such as logging or streaming, throughout generation.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            An LLMResult, which contains a list of candidate Generations for each input
+                prompt and additional model provider-specific output.
+        """
+        params = self._get_invocation_params(stop=stop, **kwargs)
+        options = {"stop": stop}
+
+        callback_manager = AsyncCallbackManager.configure(
+            callbacks,
+            self.callbacks,
+            self.verbose,
+            tags,
+            self.tags,
+            metadata,
+            self.metadata,
+        )
+
+        run_managers = await callback_manager.on_chat_model_start(
+            dumpd(self),
+            messages,
+            invocation_params=params,
+            options=options,
+            name=run_name,
+            batch_size=len(messages),
+            run_id=run_id,
+        )
+
+        results = await asyncio.gather(
+            *[
+                self._agenerate_with_cache(
+                    m,
+                    stop=stop,
+                    run_manager=run_managers[i] if run_managers else None,
+                    **kwargs,
+                )
+                for i, m in enumerate(messages)
+            ],
+            return_exceptions=True,
+        )
+        exceptions = []
+        for i, res in enumerate(results):
+            if isinstance(res, BaseException):
+                if run_managers:
+                    await run_managers[i].on_llm_error(
+                        res, response=LLMResult(generations=[])
+                    )
+                exceptions.append(res)
+        if exceptions:
+            if run_managers:
+                await asyncio.gather(
+                    *[
+                        run_manager.on_llm_end(
+                            LLMResult(
+                                generations=[res.generations],  # type: ignore[list-item, union-attr]
+                                llm_output=res.llm_output,  # type: ignore[list-item, union-attr]
+                            )
+                        )
+                        for run_manager, res in zip(run_managers, results)
+                        if not isinstance(res, Exception)
+                    ]
+                )
+            raise exceptions[0]
+        flattened_outputs = [
+            LLMResult(generations=[res.generations], llm_output=res.llm_output)  # type: ignore[list-item, union-attr]
+            for res in results
+        ]
+        llm_output = self._combine_llm_outputs([res.llm_output for res in results])  # type: ignore[union-attr]
+        generations = [res.generations for res in results]  # type: ignore[union-attr]
+        output = LLMResult(generations=generations, llm_output=llm_output)  # type: ignore[arg-type]
+        await asyncio.gather(
+            *[
+                run_manager.on_llm_end(flattened_output)
+                for run_manager, flattened_output in zip(
+                    run_managers, flattened_outputs
+                )
+            ]
+        )
+        if run_managers:
+            output.run = [
+                RunInfo(run_id=run_manager.run_id) for run_manager in run_managers
+            ]
+        return output
+
+    def generate_prompt(
+        self,
+        prompts: List[PromptValue],
+        stop: Optional[List[str]] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        prompt_messages = [p.to_messages() for p in prompts]
+        return self.generate(prompt_messages, stop=stop, callbacks=callbacks, **kwargs)
+
+    async def agenerate_prompt(
+        self,
+        prompts: List[PromptValue],
+        stop: Optional[List[str]] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        prompt_messages = [p.to_messages() for p in prompts]
+        return await self.agenerate(
+            prompt_messages, stop=stop, callbacks=callbacks, **kwargs
+        )
+
+    def _generate_with_cache(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if isinstance(self.cache, BaseCache):
+            llm_cache = self.cache
+        else:
+            llm_cache = get_llm_cache()
+        # We should check the cache unless it's explicitly set to False
+        # A None cache means we should use the default global cache
+        # if it's configured.
+        check_cache = self.cache or self.cache is None
+        if check_cache:
+            if llm_cache:
+                llm_string = self._get_llm_string(stop=stop, **kwargs)
+                prompt = dumps(messages)
+                cache_val = llm_cache.lookup(prompt, llm_string)
+                if isinstance(cache_val, list):
+                    return ChatResult(generations=cache_val)
+            elif self.cache is None:
+                pass
+            else:
+                raise ValueError(
+                    "Asked to cache, but no cache found at `langchain.cache`."
+                )
+        # If stream is not explicitly set, check if implicitly requested by
+        # astream_events() or astream_log(). Bail out if _stream not implemented
+        if type(self)._stream != BaseChatModel._stream and kwargs.pop(
+            "stream",
+            (
+                next(
+                    (
+                        True
+                        for h in run_manager.handlers
+                        if isinstance(h, LogStreamCallbackHandler)
+                    ),
+                    False,
+                )
+                if run_manager
+                else False
+            ),
+        ):
+            chunks: List[ChatGenerationChunk] = []
+            for chunk in self._stream(messages, stop=stop, **kwargs):
+                chunk.message.response_metadata = _gen_info_and_msg_metadata(chunk)
+                if run_manager:
+                    if chunk.message.id is None:
+                        chunk.message.id = f"run-{run_manager.run_id}"
+                    run_manager.on_llm_new_token(
+                        cast(str, chunk.message.content), chunk=chunk
+                    )
+                chunks.append(chunk)
+            result = generate_from_stream(iter(chunks))
+        else:
+            if inspect.signature(self._generate).parameters.get("run_manager"):
+                result = self._generate(
+                    messages, stop=stop, run_manager=run_manager, **kwargs
+                )
+            else:
+                result = self._generate(messages, stop=stop, **kwargs)
+
+        # Add response metadata to each generation
+        for idx, generation in enumerate(result.generations):
+            if run_manager and generation.message.id is None:
+                generation.message.id = f"run-{run_manager.run_id}-{idx}"
+            generation.message.response_metadata = _gen_info_and_msg_metadata(
+                generation
+            )
+        if len(result.generations) == 1 and result.llm_output is not None:
+            result.generations[0].message.response_metadata = {
+                **result.llm_output,
+                **result.generations[0].message.response_metadata,
+            }
+        if check_cache and llm_cache:
+            llm_cache.update(prompt, llm_string, result.generations)
+        return result
+
+    async def _agenerate_with_cache(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        if isinstance(self.cache, BaseCache):
+            llm_cache = self.cache
+        else:
+            llm_cache = get_llm_cache()
+        # We should check the cache unless it's explicitly set to False
+        # A None cache means we should use the default global cache
+        # if it's configured.
+        check_cache = self.cache or self.cache is None
+        if check_cache:
+            if llm_cache:
+                llm_string = self._get_llm_string(stop=stop, **kwargs)
+                prompt = dumps(messages)
+                cache_val = await llm_cache.alookup(prompt, llm_string)
+                if isinstance(cache_val, list):
+                    return ChatResult(generations=cache_val)
+            elif self.cache is None:
+                pass
+            else:
+                raise ValueError(
+                    "Asked to cache, but no cache found at `langchain.cache`."
+                )
+        # If stream is not explicitly set, check if implicitly requested by
+        # astream_events() or astream_log(). Bail out if _astream not implemented
+        if (
+            type(self)._astream != BaseChatModel._astream
+            or type(self)._stream != BaseChatModel._stream
+        ) and kwargs.pop(
+            "stream",
+            (
+                next(
+                    (
+                        True
+                        for h in run_manager.handlers
+                        if isinstance(h, LogStreamCallbackHandler)
+                    ),
+                    False,
+                )
+                if run_manager
+                else False
+            ),
+        ):
+            chunks: List[ChatGenerationChunk] = []
+            async for chunk in self._astream(messages, stop=stop, **kwargs):
+                chunk.message.response_metadata = _gen_info_and_msg_metadata(chunk)
+                if run_manager:
+                    if chunk.message.id is None:
+                        chunk.message.id = f"run-{run_manager.run_id}"
+                    await run_manager.on_llm_new_token(
+                        cast(str, chunk.message.content), chunk=chunk
+                    )
+                chunks.append(chunk)
+            result = generate_from_stream(iter(chunks))
+        else:
+            if inspect.signature(self._agenerate).parameters.get("run_manager"):
+                result = await self._agenerate(
+                    messages, stop=stop, run_manager=run_manager, **kwargs
+                )
+            else:
+                result = await self._agenerate(messages, stop=stop, **kwargs)
+
+        # Add response metadata to each generation
+        for idx, generation in enumerate(result.generations):
+            if run_manager and generation.message.id is None:
+                generation.message.id = f"run-{run_manager.run_id}-{idx}"
+            generation.message.response_metadata = _gen_info_and_msg_metadata(
+                generation
+            )
+        if len(result.generations) == 1 and result.llm_output is not None:
+            result.generations[0].message.response_metadata = {
+                **result.llm_output,
+                **result.generations[0].message.response_metadata,
+            }
+        if check_cache and llm_cache:
+            await llm_cache.aupdate(prompt, llm_string, result.generations)
+        return result
+
+    @abstractmethod
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Top Level call"""
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Top Level call"""
+        return await run_in_executor(
+            None,
+            self._generate,
+            messages,
+            stop,
+            run_manager.get_sync() if run_manager else None,
+            **kwargs,
+        )
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        raise NotImplementedError()
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        iterator = await run_in_executor(
+            None,
+            self._stream,
+            messages,
+            stop,
+            run_manager.get_sync() if run_manager else None,
+            **kwargs,
+        )
+        done = object()
+        while True:
+            item = await run_in_executor(
+                None,
+                next,
+                iterator,
+                done,  # type: ignore[call-arg, arg-type]
+            )
+            if item is done:
+                break
+            yield item  # type: ignore[misc]
+
+    @deprecated("0.1.7", alternative="invoke", removal="0.2.0")
+    def __call__(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> BaseMessage:
+        generation = self.generate(
+            [messages], stop=stop, callbacks=callbacks, **kwargs
+        ).generations[0][0]
+        if isinstance(generation, ChatGeneration):
+            return generation.message
+        else:
+            raise ValueError("Unexpected generation type")
+
+    async def _call_async(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        callbacks: Callbacks = None,
+        **kwargs: Any,
+    ) -> BaseMessage:
+        result = await self.agenerate(
+            [messages], stop=stop, callbacks=callbacks, **kwargs
+        )
+        generation = result.generations[0][0]
+        if isinstance(generation, ChatGeneration):
+            return generation.message
+        else:
+            raise ValueError("Unexpected generation type")
+
+    @deprecated("0.1.7", alternative="invoke", removal="0.2.0")
+    def call_as_llm(
+        self, message: str, stop: Optional[List[str]] = None, **kwargs: Any
+    ) -> str:
+        return self.predict(message, stop=stop, **kwargs)
+
+    @deprecated("0.1.7", alternative="invoke", removal="0.2.0")
+    def predict(
+        self, text: str, *, stop: Optional[Sequence[str]] = None, **kwargs: Any
+    ) -> str:
+        if stop is None:
+            _stop = None
+        else:
+            _stop = list(stop)
+        result = self([HumanMessage(content=text)], stop=_stop, **kwargs)
+        if isinstance(result.content, str):
+            return result.content
+        else:
+            raise ValueError("Cannot use predict when output is not a string.")
+
+    @deprecated("0.1.7", alternative="invoke", removal="0.2.0")
+    def predict_messages(
+        self,
+        messages: List[BaseMessage],
+        *,
+        stop: Optional[Sequence[str]] = None,
+        **kwargs: Any,
+    ) -> BaseMessage:
+        if stop is None:
+            _stop = None
+        else:
+            _stop = list(stop)
+        return self(messages, stop=_stop, **kwargs)
+
+    @deprecated("0.1.7", alternative="ainvoke", removal="0.2.0")
+    async def apredict(
+        self, text: str, *, stop: Optional[Sequence[str]] = None, **kwargs: Any
+    ) -> str:
+        if stop is None:
+            _stop = None
+        else:
+            _stop = list(stop)
+        result = await self._call_async(
+            [HumanMessage(content=text)], stop=_stop, **kwargs
+        )
+        if isinstance(result.content, str):
+            return result.content
+        else:
+            raise ValueError("Cannot use predict when output is not a string.")
+
+    @deprecated("0.1.7", alternative="ainvoke", removal="0.2.0")
+    async def apredict_messages(
+        self,
+        messages: List[BaseMessage],
+        *,
+        stop: Optional[Sequence[str]] = None,
+        **kwargs: Any,
+    ) -> BaseMessage:
+        if stop is None:
+            _stop = None
+        else:
+            _stop = list(stop)
+        return await self._call_async(messages, stop=_stop, **kwargs)
+
+    @property
+    @abstractmethod
+    def _llm_type(self) -> str:
+        """Return type of chat model."""
+
+    def dict(self, **kwargs: Any) -> Dict:
+        """Return a dictionary of the LLM."""
+        starter_dict = dict(self._identifying_params)
+        starter_dict["_type"] = self._llm_type
+        return starter_dict
+
+    def bind_tools(
+        self,
+        tools: Sequence[Union[Dict[str, Any], Type[BaseModel], Callable, BaseTool]],
+        **kwargs: Any,
+    ) -> Runnable[LanguageModelInput, BaseMessage]:
+        raise NotImplementedError()
+
+
+class SimpleChatModel(BaseChatModel):
+    """A simplified implementation for a chat model to inherit from."""
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        output_str = self._call(messages, stop=stop, run_manager=run_manager, **kwargs)
+        message = AIMessage(content=output_str)
+        generation = ChatGeneration(message=message)
+        return ChatResult(generations=[generation])
+
+    @abstractmethod
+    def _call(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Simpler interface."""
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        return await run_in_executor(
+            None,
+            self._generate,
+            messages,
+            stop=stop,
+            run_manager=run_manager.get_sync() if run_manager else None,
+            **kwargs,
+        )
+
+
+def _gen_info_and_msg_metadata(
+    generation: Union[ChatGeneration, ChatGenerationChunk],
+) -> dict:
+    return {
+        **(generation.generation_info or {}),
+        **generation.message.response_metadata,
+    }
diff --git a/llm/Lib/site-packages/langchain_core/language_models/fake.py b/llm/Lib/site-packages/langchain_core/language_models/fake.py
new file mode 100644
index 0000000000000000000000000000000000000000..426098fb33c3112c2358e4788ff6c835fef90554
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/language_models/fake.py
@@ -0,0 +1,104 @@
+import asyncio
+import time
+from typing import Any, AsyncIterator, Iterator, List, Mapping, Optional
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models import LanguageModelInput
+from langchain_core.language_models.llms import LLM
+from langchain_core.runnables import RunnableConfig
+
+
+class FakeListLLM(LLM):
+    """Fake LLM for testing purposes."""
+
+    responses: List[str]
+    sleep: Optional[float] = None
+    i: int = 0
+
+    @property
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+        return "fake-list"
+
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Return next response"""
+        response = self.responses[self.i]
+        if self.i < len(self.responses) - 1:
+            self.i += 1
+        else:
+            self.i = 0
+        return response
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Return next response"""
+        response = self.responses[self.i]
+        if self.i < len(self.responses) - 1:
+            self.i += 1
+        else:
+            self.i = 0
+        return response
+
+    @property
+    def _identifying_params(self) -> Mapping[str, Any]:
+        return {"responses": self.responses}
+
+
+class FakeStreamingListLLM(FakeListLLM):
+    """Fake streaming list LLM for testing purposes."""
+
+    error_on_chunk_number: Optional[int] = None
+
+    def stream(
+        self,
+        input: LanguageModelInput,
+        config: Optional[RunnableConfig] = None,
+        *,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Iterator[str]:
+        result = self.invoke(input, config)
+        for i_c, c in enumerate(result):
+            if self.sleep is not None:
+                time.sleep(self.sleep)
+
+            if (
+                self.error_on_chunk_number is not None
+                and i_c == self.error_on_chunk_number
+            ):
+                raise Exception("Fake error")
+            yield c
+
+    async def astream(
+        self,
+        input: LanguageModelInput,
+        config: Optional[RunnableConfig] = None,
+        *,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[str]:
+        result = await self.ainvoke(input, config)
+        for i_c, c in enumerate(result):
+            if self.sleep is not None:
+                await asyncio.sleep(self.sleep)
+
+            if (
+                self.error_on_chunk_number is not None
+                and i_c == self.error_on_chunk_number
+            ):
+                raise Exception("Fake error")
+            yield c
diff --git a/llm/Lib/site-packages/langchain_core/language_models/fake_chat_models.py b/llm/Lib/site-packages/langchain_core/language_models/fake_chat_models.py
new file mode 100644
index 0000000000000000000000000000000000000000..8285d79674d4b0043f1aa70064adf75b560c007f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/language_models/fake_chat_models.py
@@ -0,0 +1,308 @@
+"""Fake ChatModel for testing purposes."""
+import asyncio
+import re
+import time
+from typing import Any, AsyncIterator, Dict, Iterator, List, Optional, Union, cast
+
+from langchain_core.callbacks import (
+    AsyncCallbackManagerForLLMRun,
+    CallbackManagerForLLMRun,
+)
+from langchain_core.language_models.chat_models import BaseChatModel, SimpleChatModel
+from langchain_core.messages import AIMessage, AIMessageChunk, BaseMessage
+from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult
+
+
+class FakeMessagesListChatModel(BaseChatModel):
+    """Fake ChatModel for testing purposes."""
+
+    responses: List[BaseMessage]
+    sleep: Optional[float] = None
+    i: int = 0
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        response = self.responses[self.i]
+        if self.i < len(self.responses) - 1:
+            self.i += 1
+        else:
+            self.i = 0
+        generation = ChatGeneration(message=response)
+        return ChatResult(generations=[generation])
+
+    @property
+    def _llm_type(self) -> str:
+        return "fake-messages-list-chat-model"
+
+
+class FakeListChatModel(SimpleChatModel):
+    """Fake ChatModel for testing purposes."""
+
+    responses: List
+    sleep: Optional[float] = None
+    i: int = 0
+    error_on_chunk_number: Optional[int] = None
+
+    @property
+    def _llm_type(self) -> str:
+        return "fake-list-chat-model"
+
+    def _call(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """First try to lookup in queries, else return 'foo' or 'bar'."""
+        response = self.responses[self.i]
+        if self.i < len(self.responses) - 1:
+            self.i += 1
+        else:
+            self.i = 0
+        return response
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Union[List[str], None] = None,
+        run_manager: Union[CallbackManagerForLLMRun, None] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        response = self.responses[self.i]
+        if self.i < len(self.responses) - 1:
+            self.i += 1
+        else:
+            self.i = 0
+        for i_c, c in enumerate(response):
+            if self.sleep is not None:
+                time.sleep(self.sleep)
+            if (
+                self.error_on_chunk_number is not None
+                and i_c == self.error_on_chunk_number
+            ):
+                raise Exception("Fake error")
+
+            yield ChatGenerationChunk(message=AIMessageChunk(content=c))
+
+    async def _astream(
+        self,
+        messages: List[BaseMessage],
+        stop: Union[List[str], None] = None,
+        run_manager: Union[AsyncCallbackManagerForLLMRun, None] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[ChatGenerationChunk]:
+        response = self.responses[self.i]
+        if self.i < len(self.responses) - 1:
+            self.i += 1
+        else:
+            self.i = 0
+        for i_c, c in enumerate(response):
+            if self.sleep is not None:
+                await asyncio.sleep(self.sleep)
+            if (
+                self.error_on_chunk_number is not None
+                and i_c == self.error_on_chunk_number
+            ):
+                raise Exception("Fake error")
+            yield ChatGenerationChunk(message=AIMessageChunk(content=c))
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        return {"responses": self.responses}
+
+
+class FakeChatModel(SimpleChatModel):
+    """Fake Chat Model wrapper for testing purposes."""
+
+    def _call(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        return "fake response"
+
+    async def _agenerate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        output_str = "fake response"
+        message = AIMessage(content=output_str)
+        generation = ChatGeneration(message=message)
+        return ChatResult(generations=[generation])
+
+    @property
+    def _llm_type(self) -> str:
+        return "fake-chat-model"
+
+    @property
+    def _identifying_params(self) -> Dict[str, Any]:
+        return {"key": "fake"}
+
+
+class GenericFakeChatModel(BaseChatModel):
+    """A generic fake chat model that can be used to test the chat model interface.
+
+    * Chat model should be usable in both sync and async tests
+    * Invokes on_llm_new_token to allow for testing of callback related code for new
+      tokens.
+    * Includes logic to break messages into message chunk to facilitate testing of
+      streaming.
+    """
+
+    messages: Iterator[Union[AIMessage, str]]
+    """Get an iterator over messages.
+
+    This can be expanded to accept other types like Callables / dicts / strings
+    to make the interface more generic if needed.
+
+    Note: if you want to pass a list, you can use `iter` to convert it to an iterator.
+
+    Please note that streaming is not implemented yet. We should try to implement it
+    in the future by delegating to invoke and then breaking the resulting output
+    into message chunks.
+    """
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Top Level call"""
+        message = next(self.messages)
+        if isinstance(message, str):
+            message_ = AIMessage(content=message)
+        else:
+            message_ = message
+        generation = ChatGeneration(message=message_)
+        return ChatResult(generations=[generation])
+
+    def _stream(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[ChatGenerationChunk]:
+        """Stream the output of the model."""
+        chat_result = self._generate(
+            messages, stop=stop, run_manager=run_manager, **kwargs
+        )
+        if not isinstance(chat_result, ChatResult):
+            raise ValueError(
+                f"Expected generate to return a ChatResult, "
+                f"but got {type(chat_result)} instead."
+            )
+
+        message = chat_result.generations[0].message
+
+        if not isinstance(message, AIMessage):
+            raise ValueError(
+                f"Expected invoke to return an AIMessage, "
+                f"but got {type(message)} instead."
+            )
+
+        content = message.content
+
+        if content:
+            # Use a regular expression to split on whitespace with a capture group
+            # so that we can preserve the whitespace in the output.
+            assert isinstance(content, str)
+            content_chunks = cast(List[str], re.split(r"(\s)", content))
+
+            for token in content_chunks:
+                chunk = ChatGenerationChunk(
+                    message=AIMessageChunk(content=token, id=message.id)
+                )
+                if run_manager:
+                    run_manager.on_llm_new_token(token, chunk=chunk)
+                yield chunk
+
+        if message.additional_kwargs:
+            for key, value in message.additional_kwargs.items():
+                # We should further break down the additional kwargs into chunks
+                # Special case for function call
+                if key == "function_call":
+                    for fkey, fvalue in value.items():
+                        if isinstance(fvalue, str):
+                            # Break function call by `,`
+                            fvalue_chunks = cast(List[str], re.split(r"(,)", fvalue))
+                            for fvalue_chunk in fvalue_chunks:
+                                chunk = ChatGenerationChunk(
+                                    message=AIMessageChunk(
+                                        id=message.id,
+                                        content="",
+                                        additional_kwargs={
+                                            "function_call": {fkey: fvalue_chunk}
+                                        },
+                                    )
+                                )
+                                if run_manager:
+                                    run_manager.on_llm_new_token(
+                                        "",
+                                        chunk=chunk,  # No token for function call
+                                    )
+                                yield chunk
+                        else:
+                            chunk = ChatGenerationChunk(
+                                message=AIMessageChunk(
+                                    id=message.id,
+                                    content="",
+                                    additional_kwargs={"function_call": {fkey: fvalue}},
+                                )
+                            )
+                            if run_manager:
+                                run_manager.on_llm_new_token(
+                                    "",
+                                    chunk=chunk,  # No token for function call
+                                )
+                            yield chunk
+                else:
+                    chunk = ChatGenerationChunk(
+                        message=AIMessageChunk(
+                            id=message.id, content="", additional_kwargs={key: value}
+                        )
+                    )
+                    if run_manager:
+                        run_manager.on_llm_new_token(
+                            "",
+                            chunk=chunk,  # No token for function call
+                        )
+                    yield chunk
+
+    @property
+    def _llm_type(self) -> str:
+        return "generic-fake-chat-model"
+
+
+class ParrotFakeChatModel(BaseChatModel):
+    """A generic fake chat model that can be used to test the chat model interface.
+
+    * Chat model should be usable in both sync and async tests
+    """
+
+    def _generate(
+        self,
+        messages: List[BaseMessage],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> ChatResult:
+        """Top Level call"""
+        return ChatResult(generations=[ChatGeneration(message=messages[-1])])
+
+    @property
+    def _llm_type(self) -> str:
+        return "parrot-fake-chat-model"
diff --git a/llm/Lib/site-packages/langchain_core/language_models/llms.py b/llm/Lib/site-packages/langchain_core/language_models/llms.py
new file mode 100644
index 0000000000000000000000000000000000000000..e307e8035c3175503008f2f42ca19ff42e5886bc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/language_models/llms.py
@@ -0,0 +1,1341 @@
+"""Base interface for large language models to expose."""
+
+from __future__ import annotations
+
+import asyncio
+import functools
+import inspect
+import json
+import logging
+import uuid
+import warnings
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import (
+    Any,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+
+import yaml
+from tenacity import (
+    RetryCallState,
+    before_sleep_log,
+    retry,
+    retry_base,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+from langchain_core._api import deprecated
+from langchain_core.caches import BaseCache
+from langchain_core.callbacks import (
+    AsyncCallbackManager,
+    AsyncCallbackManagerForLLMRun,
+    BaseCallbackManager,
+    CallbackManager,
+    CallbackManagerForLLMRun,
+    Callbacks,
+)
+from langchain_core.globals import get_llm_cache
+from langchain_core.language_models.base import BaseLanguageModel, LanguageModelInput
+from langchain_core.load import dumpd
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    convert_to_messages,
+    get_buffer_string,
+)
+from langchain_core.outputs import Generation, GenerationChunk, LLMResult, RunInfo
+from langchain_core.prompt_values import ChatPromptValue, PromptValue, StringPromptValue
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.runnables import RunnableConfig, ensure_config, get_config_list
+from langchain_core.runnables.config import run_in_executor
+
+logger = logging.getLogger(__name__)
+
+
+@functools.lru_cache
+def _log_error_once(msg: str) -> None:
+    """Log an error once."""
+    logger.error(msg)
+
+
+def create_base_retry_decorator(
+    error_types: List[Type[BaseException]],
+    max_retries: int = 1,
+    run_manager: Optional[
+        Union[AsyncCallbackManagerForLLMRun, CallbackManagerForLLMRun]
+    ] = None,
+) -> Callable[[Any], Any]:
+    """Create a retry decorator for a given LLM and provided list of error types."""
+
+    _logging = before_sleep_log(logger, logging.WARNING)
+
+    def _before_sleep(retry_state: RetryCallState) -> None:
+        _logging(retry_state)
+        if run_manager:
+            if isinstance(run_manager, AsyncCallbackManagerForLLMRun):
+                coro = run_manager.on_retry(retry_state)
+                try:
+                    loop = asyncio.get_event_loop()
+                    if loop.is_running():
+                        loop.create_task(coro)
+                    else:
+                        asyncio.run(coro)
+                except Exception as e:
+                    _log_error_once(f"Error in on_retry: {e}")
+            else:
+                run_manager.on_retry(retry_state)
+        return None
+
+    min_seconds = 4
+    max_seconds = 10
+    # Wait 2^x * 1 second between each retry starting with
+    # 4 seconds, then up to 10 seconds, then 10 seconds afterwards
+    retry_instance: "retry_base" = retry_if_exception_type(error_types[0])
+    for error in error_types[1:]:
+        retry_instance = retry_instance | retry_if_exception_type(error)
+    return retry(
+        reraise=True,
+        stop=stop_after_attempt(max_retries),
+        wait=wait_exponential(multiplier=1, min=min_seconds, max=max_seconds),
+        retry=retry_instance,
+        before_sleep=_before_sleep,
+    )
+
+
+def _resolve_cache(cache: Union[BaseCache, bool, None]) -> Optional[BaseCache]:
+    """Resolve the cache."""
+    if isinstance(cache, BaseCache):
+        llm_cache = cache
+    elif cache is None:
+        llm_cache = get_llm_cache()
+    elif cache is True:
+        llm_cache = get_llm_cache()
+        if llm_cache is None:
+            raise ValueError(
+                "No global cache was configured. Use `set_llm_cache`."
+                "to set a global cache if you want to use a global cache."
+                "Otherwise either pass a cache object or set cache to False/None"
+            )
+    elif cache is False:
+        llm_cache = None
+    else:
+        raise ValueError(f"Unsupported cache value {cache}")
+    return llm_cache
+
+
+def get_prompts(
+    params: Dict[str, Any],
+    prompts: List[str],
+    cache: Optional[Union[BaseCache, bool, None]] = None,
+) -> Tuple[Dict[int, List], str, List[int], List[str]]:
+    """Get prompts that are already cached."""
+    llm_string = str(sorted([(k, v) for k, v in params.items()]))
+    missing_prompts = []
+    missing_prompt_idxs = []
+    existing_prompts = {}
+
+    llm_cache = _resolve_cache(cache)
+    for i, prompt in enumerate(prompts):
+        if llm_cache:
+            cache_val = llm_cache.lookup(prompt, llm_string)
+            if isinstance(cache_val, list):
+                existing_prompts[i] = cache_val
+            else:
+                missing_prompts.append(prompt)
+                missing_prompt_idxs.append(i)
+    return existing_prompts, llm_string, missing_prompt_idxs, missing_prompts
+
+
+async def aget_prompts(
+    params: Dict[str, Any],
+    prompts: List[str],
+    cache: Optional[Union[BaseCache, bool, None]] = None,
+) -> Tuple[Dict[int, List], str, List[int], List[str]]:
+    """Get prompts that are already cached. Async version."""
+    llm_string = str(sorted([(k, v) for k, v in params.items()]))
+    missing_prompts = []
+    missing_prompt_idxs = []
+    existing_prompts = {}
+    llm_cache = _resolve_cache(cache)
+    for i, prompt in enumerate(prompts):
+        if llm_cache:
+            cache_val = await llm_cache.alookup(prompt, llm_string)
+            if isinstance(cache_val, list):
+                existing_prompts[i] = cache_val
+            else:
+                missing_prompts.append(prompt)
+                missing_prompt_idxs.append(i)
+    return existing_prompts, llm_string, missing_prompt_idxs, missing_prompts
+
+
+def update_cache(
+    cache: Union[BaseCache, bool, None],
+    existing_prompts: Dict[int, List],
+    llm_string: str,
+    missing_prompt_idxs: List[int],
+    new_results: LLMResult,
+    prompts: List[str],
+) -> Optional[dict]:
+    """Update the cache and get the LLM output."""
+    llm_cache = _resolve_cache(cache)
+    for i, result in enumerate(new_results.generations):
+        existing_prompts[missing_prompt_idxs[i]] = result
+        prompt = prompts[missing_prompt_idxs[i]]
+        if llm_cache is not None:
+            llm_cache.update(prompt, llm_string, result)
+    llm_output = new_results.llm_output
+    return llm_output
+
+
+async def aupdate_cache(
+    cache: Union[BaseCache, bool, None],
+    existing_prompts: Dict[int, List],
+    llm_string: str,
+    missing_prompt_idxs: List[int],
+    new_results: LLMResult,
+    prompts: List[str],
+) -> Optional[dict]:
+    """Update the cache and get the LLM output. Async version"""
+    llm_cache = _resolve_cache(cache)
+    for i, result in enumerate(new_results.generations):
+        existing_prompts[missing_prompt_idxs[i]] = result
+        prompt = prompts[missing_prompt_idxs[i]]
+        if llm_cache:
+            await llm_cache.aupdate(prompt, llm_string, result)
+    llm_output = new_results.llm_output
+    return llm_output
+
+
+class BaseLLM(BaseLanguageModel[str], ABC):
+    """Base LLM abstract interface.
+
+    It should take in a prompt and return a string."""
+
+    callback_manager: Optional[BaseCallbackManager] = Field(default=None, exclude=True)
+    """[DEPRECATED]"""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @root_validator()
+    def raise_deprecation(cls, values: Dict) -> Dict:
+        """Raise deprecation warning if callback_manager is used."""
+        if values.get("callback_manager") is not None:
+            warnings.warn(
+                "callback_manager is deprecated. Please use callbacks instead.",
+                DeprecationWarning,
+            )
+            values["callbacks"] = values.pop("callback_manager", None)
+        return values
+
+    # --- Runnable methods ---
+
+    @property
+    def OutputType(self) -> Type[str]:
+        """Get the input type for this runnable."""
+        return str
+
+    def _convert_input(self, input: LanguageModelInput) -> PromptValue:
+        if isinstance(input, PromptValue):
+            return input
+        elif isinstance(input, str):
+            return StringPromptValue(text=input)
+        elif isinstance(input, Sequence):
+            return ChatPromptValue(messages=convert_to_messages(input))
+        else:
+            raise ValueError(
+                f"Invalid input type {type(input)}. "
+                "Must be a PromptValue, str, or list of BaseMessages."
+            )
+
+    def invoke(
+        self,
+        input: LanguageModelInput,
+        config: Optional[RunnableConfig] = None,
+        *,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> str:
+        config = ensure_config(config)
+        return (
+            self.generate_prompt(
+                [self._convert_input(input)],
+                stop=stop,
+                callbacks=config.get("callbacks"),
+                tags=config.get("tags"),
+                metadata=config.get("metadata"),
+                run_name=config.get("run_name"),
+                run_id=config.pop("run_id", None),
+                **kwargs,
+            )
+            .generations[0][0]
+            .text
+        )
+
+    async def ainvoke(
+        self,
+        input: LanguageModelInput,
+        config: Optional[RunnableConfig] = None,
+        *,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> str:
+        config = ensure_config(config)
+        llm_result = await self.agenerate_prompt(
+            [self._convert_input(input)],
+            stop=stop,
+            callbacks=config.get("callbacks"),
+            tags=config.get("tags"),
+            metadata=config.get("metadata"),
+            run_name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+            **kwargs,
+        )
+        return llm_result.generations[0][0].text
+
+    def batch(
+        self,
+        inputs: List[LanguageModelInput],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Any,
+    ) -> List[str]:
+        if not inputs:
+            return []
+
+        config = get_config_list(config, len(inputs))
+        max_concurrency = config[0].get("max_concurrency")
+
+        if max_concurrency is None:
+            try:
+                llm_result = self.generate_prompt(
+                    [self._convert_input(input) for input in inputs],
+                    callbacks=[c.get("callbacks") for c in config],
+                    tags=[c.get("tags") for c in config],
+                    metadata=[c.get("metadata") for c in config],
+                    run_name=[c.get("run_name") for c in config],
+                    **kwargs,
+                )
+                return [g[0].text for g in llm_result.generations]
+            except Exception as e:
+                if return_exceptions:
+                    return cast(List[str], [e for _ in inputs])
+                else:
+                    raise e
+        else:
+            batches = [
+                inputs[i : i + max_concurrency]
+                for i in range(0, len(inputs), max_concurrency)
+            ]
+            config = [{**c, "max_concurrency": None} for c in config]  # type: ignore[misc]
+            return [
+                output
+                for i, batch in enumerate(batches)
+                for output in self.batch(
+                    batch,
+                    config=config[i * max_concurrency : (i + 1) * max_concurrency],
+                    return_exceptions=return_exceptions,
+                    **kwargs,
+                )
+            ]
+
+    async def abatch(
+        self,
+        inputs: List[LanguageModelInput],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Any,
+    ) -> List[str]:
+        if not inputs:
+            return []
+        config = get_config_list(config, len(inputs))
+        max_concurrency = config[0].get("max_concurrency")
+
+        if max_concurrency is None:
+            try:
+                llm_result = await self.agenerate_prompt(
+                    [self._convert_input(input) for input in inputs],
+                    callbacks=[c.get("callbacks") for c in config],
+                    tags=[c.get("tags") for c in config],
+                    metadata=[c.get("metadata") for c in config],
+                    run_name=[c.get("run_name") for c in config],
+                    **kwargs,
+                )
+                return [g[0].text for g in llm_result.generations]
+            except Exception as e:
+                if return_exceptions:
+                    return cast(List[str], [e for _ in inputs])
+                else:
+                    raise e
+        else:
+            batches = [
+                inputs[i : i + max_concurrency]
+                for i in range(0, len(inputs), max_concurrency)
+            ]
+            config = [{**c, "max_concurrency": None} for c in config]  # type: ignore[misc]
+            return [
+                output
+                for i, batch in enumerate(batches)
+                for output in await self.abatch(
+                    batch,
+                    config=config[i * max_concurrency : (i + 1) * max_concurrency],
+                    return_exceptions=return_exceptions,
+                    **kwargs,
+                )
+            ]
+
+    def stream(
+        self,
+        input: LanguageModelInput,
+        config: Optional[RunnableConfig] = None,
+        *,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> Iterator[str]:
+        if type(self)._stream == BaseLLM._stream:
+            # model doesn't implement streaming, so use default implementation
+            yield self.invoke(input, config=config, stop=stop, **kwargs)
+        else:
+            prompt = self._convert_input(input).to_string()
+            config = ensure_config(config)
+            params = self.dict()
+            params["stop"] = stop
+            params = {**params, **kwargs}
+            options = {"stop": stop}
+            callback_manager = CallbackManager.configure(
+                config.get("callbacks"),
+                self.callbacks,
+                self.verbose,
+                config.get("tags"),
+                self.tags,
+                config.get("metadata"),
+                self.metadata,
+            )
+            (run_manager,) = callback_manager.on_llm_start(
+                dumpd(self),
+                [prompt],
+                invocation_params=params,
+                options=options,
+                name=config.get("run_name"),
+                run_id=config.pop("run_id", None),
+                batch_size=1,
+            )
+            generation: Optional[GenerationChunk] = None
+            try:
+                for chunk in self._stream(
+                    prompt, stop=stop, run_manager=run_manager, **kwargs
+                ):
+                    yield chunk.text
+                    if generation is None:
+                        generation = chunk
+                    else:
+                        generation += chunk
+                assert generation is not None
+            except BaseException as e:
+                run_manager.on_llm_error(
+                    e,
+                    response=LLMResult(
+                        generations=[[generation]] if generation else []
+                    ),
+                )
+                raise e
+            else:
+                run_manager.on_llm_end(LLMResult(generations=[[generation]]))
+
+    async def astream(
+        self,
+        input: LanguageModelInput,
+        config: Optional[RunnableConfig] = None,
+        *,
+        stop: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[str]:
+        if (
+            type(self)._astream is BaseLLM._astream
+            and type(self)._stream is BaseLLM._stream
+        ):
+            yield await self.ainvoke(input, config=config, stop=stop, **kwargs)
+            return
+
+        prompt = self._convert_input(input).to_string()
+        config = ensure_config(config)
+        params = self.dict()
+        params["stop"] = stop
+        params = {**params, **kwargs}
+        options = {"stop": stop}
+        callback_manager = AsyncCallbackManager.configure(
+            config.get("callbacks"),
+            self.callbacks,
+            self.verbose,
+            config.get("tags"),
+            self.tags,
+            config.get("metadata"),
+            self.metadata,
+        )
+        (run_manager,) = await callback_manager.on_llm_start(
+            dumpd(self),
+            [prompt],
+            invocation_params=params,
+            options=options,
+            name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+            batch_size=1,
+        )
+        generation: Optional[GenerationChunk] = None
+        try:
+            async for chunk in self._astream(
+                prompt,
+                stop=stop,
+                run_manager=run_manager,
+                **kwargs,
+            ):
+                yield chunk.text
+                if generation is None:
+                    generation = chunk
+                else:
+                    generation += chunk
+            assert generation is not None
+        except BaseException as e:
+            await run_manager.on_llm_error(
+                e,
+                response=LLMResult(generations=[[generation]] if generation else []),
+            )
+            raise e
+        else:
+            await run_manager.on_llm_end(LLMResult(generations=[[generation]]))
+
+    # --- Custom methods ---
+
+    @abstractmethod
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Run the LLM on the given prompts."""
+
+    async def _agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Run the LLM on the given prompts."""
+        return await run_in_executor(
+            None,
+            self._generate,
+            prompts,
+            stop,
+            run_manager.get_sync() if run_manager else None,
+            **kwargs,
+        )
+
+    def _stream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> Iterator[GenerationChunk]:
+        """Stream the LLM on the given prompt.
+
+        This method should be overridden by subclasses that support streaming.
+
+        If not implemented, the default behavior of calls to stream will be to
+        fallback to the non-streaming version of the model and return
+        the output as a single chunk.
+
+        Args:
+            prompt: The prompt to generate from.
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of these substrings.
+            run_manager: Callback manager for the run.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            An iterator of GenerationChunks.
+        """
+        raise NotImplementedError()
+
+    async def _astream(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[GenerationChunk]:
+        """An async version of the _stream method.
+
+        The default implementation uses the synchronous _stream method and wraps it in
+        an async iterator. Subclasses that need to provide a true async implementation
+        should override this method.
+
+        Args:
+            prompt: The prompt to generate from.
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of these substrings.
+            run_manager: Callback manager for the run.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            An async iterator of GenerationChunks.
+        """
+        iterator = await run_in_executor(
+            None,
+            self._stream,
+            prompt,
+            stop,
+            run_manager.get_sync() if run_manager else None,
+            **kwargs,
+        )
+        done = object()
+        while True:
+            item = await run_in_executor(
+                None,
+                next,
+                iterator,
+                done,  # type: ignore[call-arg, arg-type]
+            )
+            if item is done:
+                break
+            yield item  # type: ignore[misc]
+
+    def generate_prompt(
+        self,
+        prompts: List[PromptValue],
+        stop: Optional[List[str]] = None,
+        callbacks: Optional[Union[Callbacks, List[Callbacks]]] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        prompt_strings = [p.to_string() for p in prompts]
+        return self.generate(prompt_strings, stop=stop, callbacks=callbacks, **kwargs)
+
+    async def agenerate_prompt(
+        self,
+        prompts: List[PromptValue],
+        stop: Optional[List[str]] = None,
+        callbacks: Optional[Union[Callbacks, List[Callbacks]]] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        prompt_strings = [p.to_string() for p in prompts]
+        return await self.agenerate(
+            prompt_strings, stop=stop, callbacks=callbacks, **kwargs
+        )
+
+    def _generate_helper(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]],
+        run_managers: List[CallbackManagerForLLMRun],
+        new_arg_supported: bool,
+        **kwargs: Any,
+    ) -> LLMResult:
+        try:
+            output = (
+                self._generate(
+                    prompts,
+                    stop=stop,
+                    # TODO: support multiple run managers
+                    run_manager=run_managers[0] if run_managers else None,
+                    **kwargs,
+                )
+                if new_arg_supported
+                else self._generate(prompts, stop=stop)
+            )
+        except BaseException as e:
+            for run_manager in run_managers:
+                run_manager.on_llm_error(e, response=LLMResult(generations=[]))
+            raise e
+        flattened_outputs = output.flatten()
+        for manager, flattened_output in zip(run_managers, flattened_outputs):
+            manager.on_llm_end(flattened_output)
+        if run_managers:
+            output.run = [
+                RunInfo(run_id=run_manager.run_id) for run_manager in run_managers
+            ]
+        return output
+
+    def generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        callbacks: Optional[Union[Callbacks, List[Callbacks]]] = None,
+        *,
+        tags: Optional[Union[List[str], List[List[str]]]] = None,
+        metadata: Optional[Union[Dict[str, Any], List[Dict[str, Any]]]] = None,
+        run_name: Optional[Union[str, List[str]]] = None,
+        run_id: Optional[Union[uuid.UUID, List[Optional[uuid.UUID]]]] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Pass a sequence of prompts to a model and return generations.
+
+        This method should make use of batched calls for models that expose a batched
+        API.
+
+        Use this method when you want to:
+            1. take advantage of batched calls,
+            2. need more output from the model than just the top generated value,
+            3. are building chains that are agnostic to the underlying language model
+                type (e.g., pure text completion models vs chat models).
+
+        Args:
+            prompts: List of string prompts.
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of these substrings.
+            callbacks: Callbacks to pass through. Used for executing additional
+                functionality, such as logging or streaming, throughout generation.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            An LLMResult, which contains a list of candidate Generations for each input
+                prompt and additional model provider-specific output.
+        """
+        if not isinstance(prompts, list):
+            raise ValueError(
+                "Argument 'prompts' is expected to be of type List[str], received"
+                f" argument of type {type(prompts)}."
+            )
+        # Create callback managers
+        if (
+            isinstance(callbacks, list)
+            and callbacks
+            and (
+                isinstance(callbacks[0], (list, BaseCallbackManager))
+                or callbacks[0] is None
+            )
+        ):
+            # We've received a list of callbacks args to apply to each input
+            assert len(callbacks) == len(prompts)
+            assert tags is None or (
+                isinstance(tags, list) and len(tags) == len(prompts)
+            )
+            assert metadata is None or (
+                isinstance(metadata, list) and len(metadata) == len(prompts)
+            )
+            assert run_name is None or (
+                isinstance(run_name, list) and len(run_name) == len(prompts)
+            )
+            callbacks = cast(List[Callbacks], callbacks)
+            tags_list = cast(List[Optional[List[str]]], tags or ([None] * len(prompts)))
+            metadata_list = cast(
+                List[Optional[Dict[str, Any]]], metadata or ([{}] * len(prompts))
+            )
+            run_name_list = run_name or cast(
+                List[Optional[str]], ([None] * len(prompts))
+            )
+            callback_managers = [
+                CallbackManager.configure(
+                    callback,
+                    self.callbacks,
+                    self.verbose,
+                    tag,
+                    self.tags,
+                    meta,
+                    self.metadata,
+                )
+                for callback, tag, meta in zip(callbacks, tags_list, metadata_list)
+            ]
+        else:
+            # We've received a single callbacks arg to apply to all inputs
+            callback_managers = [
+                CallbackManager.configure(
+                    cast(Callbacks, callbacks),
+                    self.callbacks,
+                    self.verbose,
+                    cast(List[str], tags),
+                    self.tags,
+                    cast(Dict[str, Any], metadata),
+                    self.metadata,
+                )
+            ] * len(prompts)
+            run_name_list = [cast(Optional[str], run_name)] * len(prompts)
+        run_ids_list = self._get_run_ids_list(run_id, prompts)
+        params = self.dict()
+        params["stop"] = stop
+        options = {"stop": stop}
+        (
+            existing_prompts,
+            llm_string,
+            missing_prompt_idxs,
+            missing_prompts,
+        ) = get_prompts(params, prompts, self.cache)
+        new_arg_supported = inspect.signature(self._generate).parameters.get(
+            "run_manager"
+        )
+        if (self.cache is None and get_llm_cache() is None) or self.cache is False:
+            run_managers = [
+                callback_manager.on_llm_start(
+                    dumpd(self),
+                    [prompt],
+                    invocation_params=params,
+                    options=options,
+                    name=run_name,
+                    batch_size=len(prompts),
+                    run_id=run_id_,
+                )[0]
+                for callback_manager, prompt, run_name, run_id_ in zip(
+                    callback_managers, prompts, run_name_list, run_ids_list
+                )
+            ]
+            output = self._generate_helper(
+                prompts, stop, run_managers, bool(new_arg_supported), **kwargs
+            )
+            return output
+        if len(missing_prompts) > 0:
+            run_managers = [
+                callback_managers[idx].on_llm_start(
+                    dumpd(self),
+                    [prompts[idx]],
+                    invocation_params=params,
+                    options=options,
+                    name=run_name_list[idx],
+                    batch_size=len(missing_prompts),
+                )[0]
+                for idx in missing_prompt_idxs
+            ]
+            new_results = self._generate_helper(
+                missing_prompts, stop, run_managers, bool(new_arg_supported), **kwargs
+            )
+            llm_output = update_cache(
+                self.cache,
+                existing_prompts,
+                llm_string,
+                missing_prompt_idxs,
+                new_results,
+                prompts,
+            )
+            run_info = (
+                [RunInfo(run_id=run_manager.run_id) for run_manager in run_managers]
+                if run_managers
+                else None
+            )
+        else:
+            llm_output = {}
+            run_info = None
+        generations = [existing_prompts[i] for i in range(len(prompts))]
+        return LLMResult(generations=generations, llm_output=llm_output, run=run_info)
+
+    @staticmethod
+    def _get_run_ids_list(
+        run_id: Optional[Union[uuid.UUID, List[Optional[uuid.UUID]]]], prompts: list
+    ) -> list:
+        if run_id is None:
+            return [None] * len(prompts)
+        if isinstance(run_id, list):
+            if len(run_id) != len(prompts):
+                raise ValueError(
+                    "Number of manually provided run_id's does not match batch length."
+                    f" {len(run_id)} != {len(prompts)}"
+                )
+            return run_id
+        return [run_id] + [None] * (len(prompts) - 1)
+
+    async def _agenerate_helper(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]],
+        run_managers: List[AsyncCallbackManagerForLLMRun],
+        new_arg_supported: bool,
+        **kwargs: Any,
+    ) -> LLMResult:
+        try:
+            output = (
+                await self._agenerate(
+                    prompts,
+                    stop=stop,
+                    run_manager=run_managers[0] if run_managers else None,
+                    **kwargs,
+                )
+                if new_arg_supported
+                else await self._agenerate(prompts, stop=stop)
+            )
+        except BaseException as e:
+            await asyncio.gather(
+                *[
+                    run_manager.on_llm_error(e, response=LLMResult(generations=[]))
+                    for run_manager in run_managers
+                ]
+            )
+            raise e
+        flattened_outputs = output.flatten()
+        await asyncio.gather(
+            *[
+                run_manager.on_llm_end(flattened_output)
+                for run_manager, flattened_output in zip(
+                    run_managers, flattened_outputs
+                )
+            ]
+        )
+        if run_managers:
+            output.run = [
+                RunInfo(run_id=run_manager.run_id) for run_manager in run_managers
+            ]
+        return output
+
+    async def agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        callbacks: Optional[Union[Callbacks, List[Callbacks]]] = None,
+        *,
+        tags: Optional[Union[List[str], List[List[str]]]] = None,
+        metadata: Optional[Union[Dict[str, Any], List[Dict[str, Any]]]] = None,
+        run_name: Optional[Union[str, List[str]]] = None,
+        run_id: Optional[Union[uuid.UUID, List[Optional[uuid.UUID]]]] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Asynchronously pass a sequence of prompts to a model and return generations.
+
+        This method should make use of batched calls for models that expose a batched
+        API.
+
+        Use this method when you want to:
+            1. take advantage of batched calls,
+            2. need more output from the model than just the top generated value,
+            3. are building chains that are agnostic to the underlying language model
+                type (e.g., pure text completion models vs chat models).
+
+        Args:
+            prompts: List of string prompts.
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of these substrings.
+            callbacks: Callbacks to pass through. Used for executing additional
+                functionality, such as logging or streaming, throughout generation.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            An LLMResult, which contains a list of candidate Generations for each input
+                prompt and additional model provider-specific output.
+        """
+        # Create callback managers
+        if isinstance(callbacks, list) and (
+            isinstance(callbacks[0], (list, BaseCallbackManager))
+            or callbacks[0] is None
+        ):
+            # We've received a list of callbacks args to apply to each input
+            assert len(callbacks) == len(prompts)
+            assert tags is None or (
+                isinstance(tags, list) and len(tags) == len(prompts)
+            )
+            assert metadata is None or (
+                isinstance(metadata, list) and len(metadata) == len(prompts)
+            )
+            assert run_name is None or (
+                isinstance(run_name, list) and len(run_name) == len(prompts)
+            )
+            callbacks = cast(List[Callbacks], callbacks)
+            tags_list = cast(List[Optional[List[str]]], tags or ([None] * len(prompts)))
+            metadata_list = cast(
+                List[Optional[Dict[str, Any]]], metadata or ([{}] * len(prompts))
+            )
+            run_name_list = run_name or cast(
+                List[Optional[str]], ([None] * len(prompts))
+            )
+            callback_managers = [
+                AsyncCallbackManager.configure(
+                    callback,
+                    self.callbacks,
+                    self.verbose,
+                    tag,
+                    self.tags,
+                    meta,
+                    self.metadata,
+                )
+                for callback, tag, meta in zip(callbacks, tags_list, metadata_list)
+            ]
+        else:
+            # We've received a single callbacks arg to apply to all inputs
+            callback_managers = [
+                AsyncCallbackManager.configure(
+                    cast(Callbacks, callbacks),
+                    self.callbacks,
+                    self.verbose,
+                    cast(List[str], tags),
+                    self.tags,
+                    cast(Dict[str, Any], metadata),
+                    self.metadata,
+                )
+            ] * len(prompts)
+            run_name_list = [cast(Optional[str], run_name)] * len(prompts)
+        run_ids_list = self._get_run_ids_list(run_id, prompts)
+        params = self.dict()
+        params["stop"] = stop
+        options = {"stop": stop}
+        (
+            existing_prompts,
+            llm_string,
+            missing_prompt_idxs,
+            missing_prompts,
+        ) = await aget_prompts(params, prompts, self.cache)
+
+        # Verify whether the cache is set, and if the cache is set,
+        # verify whether the cache is available.
+        new_arg_supported = inspect.signature(self._agenerate).parameters.get(
+            "run_manager"
+        )
+        if (self.cache is None and get_llm_cache() is None) or self.cache is False:
+            run_managers = await asyncio.gather(
+                *[
+                    callback_manager.on_llm_start(
+                        dumpd(self),
+                        [prompt],
+                        invocation_params=params,
+                        options=options,
+                        name=run_name,
+                        batch_size=len(prompts),
+                        run_id=run_id_,
+                    )
+                    for callback_manager, prompt, run_name, run_id_ in zip(
+                        callback_managers, prompts, run_name_list, run_ids_list
+                    )
+                ]
+            )
+            run_managers = [r[0] for r in run_managers]  # type: ignore[misc]
+            output = await self._agenerate_helper(
+                prompts,
+                stop,
+                run_managers,  # type: ignore[arg-type]
+                bool(new_arg_supported),
+                **kwargs,  # type: ignore[arg-type]
+            )
+            return output
+        if len(missing_prompts) > 0:
+            run_managers = await asyncio.gather(
+                *[
+                    callback_managers[idx].on_llm_start(
+                        dumpd(self),
+                        [prompts[idx]],
+                        invocation_params=params,
+                        options=options,
+                        name=run_name_list[idx],
+                        batch_size=len(missing_prompts),
+                    )
+                    for idx in missing_prompt_idxs
+                ]
+            )
+            run_managers = [r[0] for r in run_managers]  # type: ignore[misc]
+            new_results = await self._agenerate_helper(
+                missing_prompts,
+                stop,
+                run_managers,  # type: ignore[arg-type]
+                bool(new_arg_supported),
+                **kwargs,  # type: ignore[arg-type]
+            )
+            llm_output = await aupdate_cache(
+                self.cache,
+                existing_prompts,
+                llm_string,
+                missing_prompt_idxs,
+                new_results,
+                prompts,
+            )
+            run_info = (
+                [RunInfo(run_id=run_manager.run_id) for run_manager in run_managers]  # type: ignore[attr-defined]
+                if run_managers
+                else None
+            )
+        else:
+            llm_output = {}
+            run_info = None
+        generations = [existing_prompts[i] for i in range(len(prompts))]
+        return LLMResult(generations=generations, llm_output=llm_output, run=run_info)
+
+    @deprecated("0.1.7", alternative="invoke", removal="0.2.0")
+    def __call__(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        callbacks: Callbacks = None,
+        *,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Check Cache and run the LLM on the given prompt and input."""
+        if not isinstance(prompt, str):
+            raise ValueError(
+                "Argument `prompt` is expected to be a string. Instead found "
+                f"{type(prompt)}. If you want to run the LLM on multiple prompts, use "
+                "`generate` instead."
+            )
+        return (
+            self.generate(
+                [prompt],
+                stop=stop,
+                callbacks=callbacks,
+                tags=tags,
+                metadata=metadata,
+                **kwargs,
+            )
+            .generations[0][0]
+            .text
+        )
+
+    async def _call_async(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        callbacks: Callbacks = None,
+        *,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Check Cache and run the LLM on the given prompt and input."""
+        result = await self.agenerate(
+            [prompt],
+            stop=stop,
+            callbacks=callbacks,
+            tags=tags,
+            metadata=metadata,
+            **kwargs,
+        )
+        return result.generations[0][0].text
+
+    @deprecated("0.1.7", alternative="invoke", removal="0.2.0")
+    def predict(
+        self, text: str, *, stop: Optional[Sequence[str]] = None, **kwargs: Any
+    ) -> str:
+        if stop is None:
+            _stop = None
+        else:
+            _stop = list(stop)
+        return self(text, stop=_stop, **kwargs)
+
+    @deprecated("0.1.7", alternative="invoke", removal="0.2.0")
+    def predict_messages(
+        self,
+        messages: List[BaseMessage],
+        *,
+        stop: Optional[Sequence[str]] = None,
+        **kwargs: Any,
+    ) -> BaseMessage:
+        text = get_buffer_string(messages)
+        if stop is None:
+            _stop = None
+        else:
+            _stop = list(stop)
+        content = self(text, stop=_stop, **kwargs)
+        return AIMessage(content=content)
+
+    @deprecated("0.1.7", alternative="ainvoke", removal="0.2.0")
+    async def apredict(
+        self, text: str, *, stop: Optional[Sequence[str]] = None, **kwargs: Any
+    ) -> str:
+        if stop is None:
+            _stop = None
+        else:
+            _stop = list(stop)
+        return await self._call_async(text, stop=_stop, **kwargs)
+
+    @deprecated("0.1.7", alternative="ainvoke", removal="0.2.0")
+    async def apredict_messages(
+        self,
+        messages: List[BaseMessage],
+        *,
+        stop: Optional[Sequence[str]] = None,
+        **kwargs: Any,
+    ) -> BaseMessage:
+        text = get_buffer_string(messages)
+        if stop is None:
+            _stop = None
+        else:
+            _stop = list(stop)
+        content = await self._call_async(text, stop=_stop, **kwargs)
+        return AIMessage(content=content)
+
+    def __str__(self) -> str:
+        """Get a string representation of the object for printing."""
+        cls_name = f"\033[1m{self.__class__.__name__}\033[0m"
+        return f"{cls_name}\nParams: {self._identifying_params}"
+
+    @property
+    @abstractmethod
+    def _llm_type(self) -> str:
+        """Return type of llm."""
+
+    def dict(self, **kwargs: Any) -> Dict:
+        """Return a dictionary of the LLM."""
+        starter_dict = dict(self._identifying_params)
+        starter_dict["_type"] = self._llm_type
+        return starter_dict
+
+    def save(self, file_path: Union[Path, str]) -> None:
+        """Save the LLM.
+
+        Args:
+            file_path: Path to file to save the LLM to.
+
+        Example:
+        .. code-block:: python
+
+            llm.save(file_path="path/llm.yaml")
+        """
+        # Convert file to Path object.
+        if isinstance(file_path, str):
+            save_path = Path(file_path)
+        else:
+            save_path = file_path
+
+        directory_path = save_path.parent
+        directory_path.mkdir(parents=True, exist_ok=True)
+
+        # Fetch dictionary to save
+        prompt_dict = self.dict()
+
+        if save_path.suffix == ".json":
+            with open(file_path, "w") as f:
+                json.dump(prompt_dict, f, indent=4)
+        elif save_path.suffix.endswith((".yaml", ".yml")):
+            with open(file_path, "w") as f:
+                yaml.dump(prompt_dict, f, default_flow_style=False)
+        else:
+            raise ValueError(f"{save_path} must be json or yaml")
+
+
+class LLM(BaseLLM):
+    """This class exposes a simple interface for implementing a custom LLM.
+
+    You should subclass this class and implement the following:
+
+    - `_call` method: Run the LLM on the given prompt and input (used by `invoke`).
+    - `_identifying_params` property: Return a dictionary of the identifying parameters
+        This is critical for caching and tracing purposes. Identifying parameters
+        is a dict that identifies the LLM.
+        It should mostly include a `model_name`.
+
+    Optional: Override the following methods to provide more optimizations:
+
+    - `_acall`: Provide a native async version of the `_call` method.
+        If not provided, will delegate to the synchronous version using
+        `run_in_executor`. (Used by `ainvoke`).
+    - `_stream`: Stream the LLM on the given prompt and input.
+        `stream` will use `_stream` if provided, otherwise it
+        use `_call` and output will arrive in one chunk.
+    - `_astream`: Override to provide a native async version of the `_stream` method.
+        `astream` will use `_astream` if provided, otherwise it will implement
+        a fallback behavior that will use `_stream` if `_stream` is implemented,
+        and use `_acall` if `_stream` is not implemented.
+    """
+
+    @abstractmethod
+    def _call(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Run the LLM on the given input.
+
+        Override this method to implement the LLM logic.
+
+        Args:
+            prompt: The prompt to generate from.
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of the stop substrings.
+                If stop tokens are not supported consider raising NotImplementedError.
+            run_manager: Callback manager for the run.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            The model output as a string. SHOULD NOT include the prompt.
+        """
+
+    async def _acall(
+        self,
+        prompt: str,
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Async version of the _call method.
+
+        The default implementation delegates to the synchronous _call method using
+        `run_in_executor`. Subclasses that need to provide a true async implementation
+        should override this method to reduce the overhead of using `run_in_executor`.
+
+        Args:
+            prompt: The prompt to generate from.
+            stop: Stop words to use when generating. Model output is cut off at the
+                first occurrence of any of the stop substrings.
+                If stop tokens are not supported consider raising NotImplementedError.
+            run_manager: Callback manager for the run.
+            **kwargs: Arbitrary additional keyword arguments. These are usually passed
+                to the model provider API call.
+
+        Returns:
+            The model output as a string. SHOULD NOT include the prompt.
+        """
+        return await run_in_executor(
+            None,
+            self._call,
+            prompt,
+            stop,
+            run_manager.get_sync() if run_manager else None,
+            **kwargs,
+        )
+
+    def _generate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[CallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Run the LLM on the given prompt and input."""
+        # TODO: add caching here.
+        generations = []
+        new_arg_supported = inspect.signature(self._call).parameters.get("run_manager")
+        for prompt in prompts:
+            text = (
+                self._call(prompt, stop=stop, run_manager=run_manager, **kwargs)
+                if new_arg_supported
+                else self._call(prompt, stop=stop, **kwargs)
+            )
+            generations.append([Generation(text=text)])
+        return LLMResult(generations=generations)
+
+    async def _agenerate(
+        self,
+        prompts: List[str],
+        stop: Optional[List[str]] = None,
+        run_manager: Optional[AsyncCallbackManagerForLLMRun] = None,
+        **kwargs: Any,
+    ) -> LLMResult:
+        """Run the LLM on the given prompt and input."""
+        generations = []
+        new_arg_supported = inspect.signature(self._acall).parameters.get("run_manager")
+        for prompt in prompts:
+            text = (
+                await self._acall(prompt, stop=stop, run_manager=run_manager, **kwargs)
+                if new_arg_supported
+                else await self._acall(prompt, stop=stop, **kwargs)
+            )
+            generations.append([Generation(text=text)])
+        return LLMResult(generations=generations)
diff --git a/llm/Lib/site-packages/langchain_core/load/__init__.py b/llm/Lib/site-packages/langchain_core/load/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..71f5f04a0986237e44e054a477271d183de4e7e5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/load/__init__.py
@@ -0,0 +1,6 @@
+"""**Load** module helps with serialization and deserialization."""
+from langchain_core.load.dump import dumpd, dumps
+from langchain_core.load.load import load, loads
+from langchain_core.load.serializable import Serializable
+
+__all__ = ["dumpd", "dumps", "load", "loads", "Serializable"]
diff --git a/llm/Lib/site-packages/langchain_core/load/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/load/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0b5c7579f6d4d3e4cc1c2cb88ddf6718b0899c6a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/load/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/load/__pycache__/dump.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/load/__pycache__/dump.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f0d2d861864f3ad9b3f5662a574e853db7567c90
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/load/__pycache__/dump.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/load/__pycache__/load.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/load/__pycache__/load.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c7e6d40f37e908cd7333adb55441a71665130755
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/load/__pycache__/load.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/load/__pycache__/mapping.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/load/__pycache__/mapping.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..203da33c2c1c27203b7c5cae4f518deceb41f621
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/load/__pycache__/mapping.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/load/__pycache__/serializable.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/load/__pycache__/serializable.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6b02453700307e237355473aa64aabb8f490c7e3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/load/__pycache__/serializable.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/load/dump.py b/llm/Lib/site-packages/langchain_core/load/dump.py
new file mode 100644
index 0000000000000000000000000000000000000000..783ab9271d4b18ffb4c334c312dcb6850904c41a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/load/dump.py
@@ -0,0 +1,35 @@
+import json
+from typing import Any, Dict
+
+from langchain_core.load.serializable import Serializable, to_json_not_implemented
+
+
+def default(obj: Any) -> Any:
+    """Return a default value for a Serializable object or
+    a SerializedNotImplemented object."""
+    if isinstance(obj, Serializable):
+        return obj.to_json()
+    else:
+        return to_json_not_implemented(obj)
+
+
+def dumps(obj: Any, *, pretty: bool = False, **kwargs: Any) -> str:
+    """Return a json string representation of an object."""
+    if "default" in kwargs:
+        raise ValueError("`default` should not be passed to dumps")
+    try:
+        if pretty:
+            indent = kwargs.pop("indent", 2)
+            return json.dumps(obj, default=default, indent=indent, **kwargs)
+        else:
+            return json.dumps(obj, default=default, **kwargs)
+    except TypeError:
+        if pretty:
+            return json.dumps(to_json_not_implemented(obj), indent=indent, **kwargs)
+        else:
+            return json.dumps(to_json_not_implemented(obj), **kwargs)
+
+
+def dumpd(obj: Any) -> Dict[str, Any]:
+    """Return a json dict representation of an object."""
+    return json.loads(dumps(obj))
diff --git a/llm/Lib/site-packages/langchain_core/load/load.py b/llm/Lib/site-packages/langchain_core/load/load.py
new file mode 100644
index 0000000000000000000000000000000000000000..ec5c67f2a08b903f760bcb55f5570ac897d930d4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/load/load.py
@@ -0,0 +1,176 @@
+import importlib
+import json
+import os
+from typing import Any, Dict, List, Optional
+
+from langchain_core._api import beta
+from langchain_core.load.mapping import (
+    _JS_SERIALIZABLE_MAPPING,
+    _OG_SERIALIZABLE_MAPPING,
+    OLD_CORE_NAMESPACES_MAPPING,
+    SERIALIZABLE_MAPPING,
+)
+from langchain_core.load.serializable import Serializable
+
+DEFAULT_NAMESPACES = [
+    "langchain",
+    "langchain_core",
+    "langchain_community",
+    "langchain_anthropic",
+]
+
+ALL_SERIALIZABLE_MAPPINGS = {
+    **SERIALIZABLE_MAPPING,
+    **OLD_CORE_NAMESPACES_MAPPING,
+    **_OG_SERIALIZABLE_MAPPING,
+    **_JS_SERIALIZABLE_MAPPING,
+}
+
+
+class Reviver:
+    """Reviver for JSON objects."""
+
+    def __init__(
+        self,
+        secrets_map: Optional[Dict[str, str]] = None,
+        valid_namespaces: Optional[List[str]] = None,
+        secrets_from_env: bool = True,
+    ) -> None:
+        self.secrets_from_env = secrets_from_env
+        self.secrets_map = secrets_map or dict()
+        # By default only support langchain, but user can pass in additional namespaces
+        self.valid_namespaces = (
+            [*DEFAULT_NAMESPACES, *valid_namespaces]
+            if valid_namespaces
+            else DEFAULT_NAMESPACES
+        )
+
+    def __call__(self, value: Dict[str, Any]) -> Any:
+        if (
+            value.get("lc", None) == 1
+            and value.get("type", None) == "secret"
+            and value.get("id", None) is not None
+        ):
+            [key] = value["id"]
+            if key in self.secrets_map:
+                return self.secrets_map[key]
+            else:
+                if self.secrets_from_env and key in os.environ and os.environ[key]:
+                    return os.environ[key]
+                raise KeyError(f'Missing key "{key}" in load(secrets_map)')
+
+        if (
+            value.get("lc", None) == 1
+            and value.get("type", None) == "not_implemented"
+            and value.get("id", None) is not None
+        ):
+            raise NotImplementedError(
+                "Trying to load an object that doesn't implement "
+                f"serialization: {value}"
+            )
+
+        if (
+            value.get("lc", None) == 1
+            and value.get("type", None) == "constructor"
+            and value.get("id", None) is not None
+        ):
+            [*namespace, name] = value["id"]
+
+            if namespace[0] not in self.valid_namespaces:
+                raise ValueError(f"Invalid namespace: {value}")
+
+            # The root namespace "langchain" is not a valid identifier.
+            if len(namespace) == 1 and namespace[0] == "langchain":
+                raise ValueError(f"Invalid namespace: {value}")
+
+            # If namespace is in known namespaces, try to use mapping
+            if namespace[0] in DEFAULT_NAMESPACES:
+                # Get the importable path
+                key = tuple(namespace + [name])
+                if key not in ALL_SERIALIZABLE_MAPPINGS:
+                    raise ValueError(
+                        "Trying to deserialize something that cannot "
+                        "be deserialized in current version of langchain-core: "
+                        f"{key}"
+                    )
+                import_path = ALL_SERIALIZABLE_MAPPINGS[key]
+                # Split into module and name
+                import_dir, import_obj = import_path[:-1], import_path[-1]
+                # Import module
+                mod = importlib.import_module(".".join(import_dir))
+                # Import class
+                cls = getattr(mod, import_obj)
+            # Otherwise, load by path
+            else:
+                mod = importlib.import_module(".".join(namespace))
+                cls = getattr(mod, name)
+
+            # The class must be a subclass of Serializable.
+            if not issubclass(cls, Serializable):
+                raise ValueError(f"Invalid namespace: {value}")
+
+            # We don't need to recurse on kwargs
+            # as json.loads will do that for us.
+            kwargs = value.get("kwargs", dict())
+            return cls(**kwargs)
+
+        return value
+
+
+@beta()
+def loads(
+    text: str,
+    *,
+    secrets_map: Optional[Dict[str, str]] = None,
+    valid_namespaces: Optional[List[str]] = None,
+    secrets_from_env: bool = True,
+) -> Any:
+    """Revive a LangChain class from a JSON string.
+    Equivalent to `load(json.loads(text))`.
+
+    Args:
+        text: The string to load.
+        secrets_map: A map of secrets to load.
+        valid_namespaces: A list of additional namespaces (modules)
+            to allow to be deserialized.
+
+    Returns:
+        Revived LangChain objects.
+    """
+    return json.loads(
+        text, object_hook=Reviver(secrets_map, valid_namespaces, secrets_from_env)
+    )
+
+
+@beta()
+def load(
+    obj: Any,
+    *,
+    secrets_map: Optional[Dict[str, str]] = None,
+    valid_namespaces: Optional[List[str]] = None,
+    secrets_from_env: bool = True,
+) -> Any:
+    """Revive a LangChain class from a JSON object. Use this if you already
+    have a parsed JSON object, eg. from `json.load` or `orjson.loads`.
+
+    Args:
+        obj: The object to load.
+        secrets_map: A map of secrets to load.
+        valid_namespaces: A list of additional namespaces (modules)
+            to allow to be deserialized.
+
+    Returns:
+        Revived LangChain objects.
+    """
+    reviver = Reviver(secrets_map, valid_namespaces, secrets_from_env)
+
+    def _load(obj: Any) -> Any:
+        if isinstance(obj, dict):
+            # Need to revive leaf nodes before reviving this node
+            loaded_obj = {k: _load(v) for k, v in obj.items()}
+            return reviver(loaded_obj)
+        if isinstance(obj, list):
+            return [_load(o) for o in obj]
+        return obj
+
+    return _load(obj)
diff --git a/llm/Lib/site-packages/langchain_core/load/mapping.py b/llm/Lib/site-packages/langchain_core/load/mapping.py
new file mode 100644
index 0000000000000000000000000000000000000000..417d54e35e5f82da353baa328ed659ac83829518
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/load/mapping.py
@@ -0,0 +1,984 @@
+from typing import Dict, Tuple
+
+# First value is the value that it is serialized as
+# Second value is the path to load it from
+SERIALIZABLE_MAPPING: Dict[Tuple[str, ...], Tuple[str, ...]] = {
+    ("langchain", "schema", "messages", "AIMessage"): (
+        "langchain_core",
+        "messages",
+        "ai",
+        "AIMessage",
+    ),
+    ("langchain", "schema", "messages", "AIMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "ai",
+        "AIMessageChunk",
+    ),
+    ("langchain", "schema", "messages", "BaseMessage"): (
+        "langchain_core",
+        "messages",
+        "base",
+        "BaseMessage",
+    ),
+    ("langchain", "schema", "messages", "BaseMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "base",
+        "BaseMessageChunk",
+    ),
+    ("langchain", "schema", "messages", "ChatMessage"): (
+        "langchain_core",
+        "messages",
+        "chat",
+        "ChatMessage",
+    ),
+    ("langchain", "schema", "messages", "FunctionMessage"): (
+        "langchain_core",
+        "messages",
+        "function",
+        "FunctionMessage",
+    ),
+    ("langchain", "schema", "messages", "HumanMessage"): (
+        "langchain_core",
+        "messages",
+        "human",
+        "HumanMessage",
+    ),
+    ("langchain", "schema", "messages", "SystemMessage"): (
+        "langchain_core",
+        "messages",
+        "system",
+        "SystemMessage",
+    ),
+    ("langchain", "schema", "messages", "ToolMessage"): (
+        "langchain_core",
+        "messages",
+        "tool",
+        "ToolMessage",
+    ),
+    ("langchain", "schema", "agent", "AgentAction"): (
+        "langchain_core",
+        "agents",
+        "AgentAction",
+    ),
+    ("langchain", "schema", "agent", "AgentFinish"): (
+        "langchain_core",
+        "agents",
+        "AgentFinish",
+    ),
+    ("langchain", "schema", "prompt_template", "BasePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "base",
+        "BasePromptTemplate",
+    ),
+    ("langchain", "chains", "llm", "LLMChain"): (
+        "langchain",
+        "chains",
+        "llm",
+        "LLMChain",
+    ),
+    ("langchain", "prompts", "prompt", "PromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "prompt",
+        "PromptTemplate",
+    ),
+    ("langchain", "prompts", "chat", "MessagesPlaceholder"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "MessagesPlaceholder",
+    ),
+    ("langchain", "llms", "openai", "OpenAI"): (
+        "langchain_openai",
+        "llms",
+        "base",
+        "OpenAI",
+    ),
+    ("langchain", "prompts", "chat", "ChatPromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "ChatPromptTemplate",
+    ),
+    ("langchain", "prompts", "chat", "HumanMessagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "HumanMessagePromptTemplate",
+    ),
+    ("langchain", "prompts", "chat", "SystemMessagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "SystemMessagePromptTemplate",
+    ),
+    ("langchain", "prompts", "image", "ImagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "image",
+        "ImagePromptTemplate",
+    ),
+    ("langchain", "schema", "agent", "AgentActionMessageLog"): (
+        "langchain_core",
+        "agents",
+        "AgentActionMessageLog",
+    ),
+    ("langchain", "schema", "agent", "ToolAgentAction"): (
+        "langchain",
+        "agents",
+        "output_parsers",
+        "tools",
+        "ToolAgentAction",
+    ),
+    ("langchain", "prompts", "chat", "BaseMessagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "BaseMessagePromptTemplate",
+    ),
+    ("langchain", "schema", "output", "ChatGeneration"): (
+        "langchain_core",
+        "outputs",
+        "chat_generation",
+        "ChatGeneration",
+    ),
+    ("langchain", "schema", "output", "Generation"): (
+        "langchain_core",
+        "outputs",
+        "generation",
+        "Generation",
+    ),
+    ("langchain", "schema", "document", "Document"): (
+        "langchain_core",
+        "documents",
+        "base",
+        "Document",
+    ),
+    ("langchain", "output_parsers", "fix", "OutputFixingParser"): (
+        "langchain",
+        "output_parsers",
+        "fix",
+        "OutputFixingParser",
+    ),
+    ("langchain", "prompts", "chat", "AIMessagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "AIMessagePromptTemplate",
+    ),
+    ("langchain", "output_parsers", "regex", "RegexParser"): (
+        "langchain",
+        "output_parsers",
+        "regex",
+        "RegexParser",
+    ),
+    ("langchain", "schema", "runnable", "DynamicRunnable"): (
+        "langchain_core",
+        "runnables",
+        "configurable",
+        "DynamicRunnable",
+    ),
+    ("langchain", "schema", "prompt", "PromptValue"): (
+        "langchain_core",
+        "prompt_values",
+        "PromptValue",
+    ),
+    ("langchain", "schema", "runnable", "RunnableBinding"): (
+        "langchain_core",
+        "runnables",
+        "base",
+        "RunnableBinding",
+    ),
+    ("langchain", "schema", "runnable", "RunnableBranch"): (
+        "langchain_core",
+        "runnables",
+        "branch",
+        "RunnableBranch",
+    ),
+    ("langchain", "schema", "runnable", "RunnableWithFallbacks"): (
+        "langchain_core",
+        "runnables",
+        "fallbacks",
+        "RunnableWithFallbacks",
+    ),
+    ("langchain", "schema", "output_parser", "StrOutputParser"): (
+        "langchain_core",
+        "output_parsers",
+        "string",
+        "StrOutputParser",
+    ),
+    ("langchain", "chat_models", "openai", "ChatOpenAI"): (
+        "langchain_openai",
+        "chat_models",
+        "base",
+        "ChatOpenAI",
+    ),
+    ("langchain", "output_parsers", "list", "CommaSeparatedListOutputParser"): (
+        "langchain_core",
+        "output_parsers",
+        "list",
+        "CommaSeparatedListOutputParser",
+    ),
+    ("langchain", "schema", "runnable", "RunnableParallel"): (
+        "langchain_core",
+        "runnables",
+        "base",
+        "RunnableParallel",
+    ),
+    ("langchain", "chat_models", "azure_openai", "AzureChatOpenAI"): (
+        "langchain_openai",
+        "chat_models",
+        "azure",
+        "AzureChatOpenAI",
+    ),
+    ("langchain", "chat_models", "bedrock", "BedrockChat"): (
+        "langchain_aws",
+        "chat_models",
+        "bedrock",
+        "ChatBedrock",
+    ),
+    ("langchain", "chat_models", "anthropic", "ChatAnthropic"): (
+        "langchain_anthropic",
+        "chat_models",
+        "ChatAnthropic",
+    ),
+    ("langchain", "chat_models", "fireworks", "ChatFireworks"): (
+        "langchain_fireworks",
+        "chat_models",
+        "ChatFireworks",
+    ),
+    ("langchain", "chat_models", "google_palm", "ChatGooglePalm"): (
+        "langchain",
+        "chat_models",
+        "google_palm",
+        "ChatGooglePalm",
+    ),
+    ("langchain", "chat_models", "vertexai", "ChatVertexAI"): (
+        "langchain_google_vertexai",
+        "chat_models",
+        "ChatVertexAI",
+    ),
+    ("langchain", "schema", "output", "ChatGenerationChunk"): (
+        "langchain_core",
+        "outputs",
+        "chat_generation",
+        "ChatGenerationChunk",
+    ),
+    ("langchain", "schema", "messages", "ChatMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "chat",
+        "ChatMessageChunk",
+    ),
+    ("langchain", "schema", "messages", "HumanMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "human",
+        "HumanMessageChunk",
+    ),
+    ("langchain", "schema", "messages", "FunctionMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "function",
+        "FunctionMessageChunk",
+    ),
+    ("langchain", "schema", "messages", "SystemMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "system",
+        "SystemMessageChunk",
+    ),
+    ("langchain", "schema", "messages", "ToolMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "tool",
+        "ToolMessageChunk",
+    ),
+    ("langchain", "schema", "output", "GenerationChunk"): (
+        "langchain_core",
+        "outputs",
+        "generation",
+        "GenerationChunk",
+    ),
+    ("langchain", "llms", "openai", "BaseOpenAI"): (
+        "langchain",
+        "llms",
+        "openai",
+        "BaseOpenAI",
+    ),
+    ("langchain", "llms", "bedrock", "Bedrock"): (
+        "langchain_aws",
+        "llms",
+        "bedrock",
+        "BedrockLLM",
+    ),
+    ("langchain", "llms", "fireworks", "Fireworks"): (
+        "langchain_fireworks",
+        "llms",
+        "Fireworks",
+    ),
+    ("langchain", "llms", "google_palm", "GooglePalm"): (
+        "langchain",
+        "llms",
+        "google_palm",
+        "GooglePalm",
+    ),
+    ("langchain", "llms", "openai", "AzureOpenAI"): (
+        "langchain_openai",
+        "llms",
+        "azure",
+        "AzureOpenAI",
+    ),
+    ("langchain", "llms", "replicate", "Replicate"): (
+        "langchain",
+        "llms",
+        "replicate",
+        "Replicate",
+    ),
+    ("langchain", "llms", "vertexai", "VertexAI"): (
+        "langchain_vertexai",
+        "llms",
+        "VertexAI",
+    ),
+    ("langchain", "output_parsers", "combining", "CombiningOutputParser"): (
+        "langchain",
+        "output_parsers",
+        "combining",
+        "CombiningOutputParser",
+    ),
+    ("langchain", "schema", "prompt_template", "BaseChatPromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "BaseChatPromptTemplate",
+    ),
+    ("langchain", "prompts", "chat", "ChatMessagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "ChatMessagePromptTemplate",
+    ),
+    ("langchain", "prompts", "few_shot_with_templates", "FewShotPromptWithTemplates"): (
+        "langchain_core",
+        "prompts",
+        "few_shot_with_templates",
+        "FewShotPromptWithTemplates",
+    ),
+    ("langchain", "prompts", "pipeline", "PipelinePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "pipeline",
+        "PipelinePromptTemplate",
+    ),
+    ("langchain", "prompts", "base", "StringPromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "string",
+        "StringPromptTemplate",
+    ),
+    ("langchain", "prompts", "base", "StringPromptValue"): (
+        "langchain_core",
+        "prompt_values",
+        "StringPromptValue",
+    ),
+    ("langchain", "prompts", "chat", "BaseStringMessagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "BaseStringMessagePromptTemplate",
+    ),
+    ("langchain", "prompts", "chat", "ChatPromptValue"): (
+        "langchain_core",
+        "prompt_values",
+        "ChatPromptValue",
+    ),
+    ("langchain", "prompts", "chat", "ChatPromptValueConcrete"): (
+        "langchain_core",
+        "prompt_values",
+        "ChatPromptValueConcrete",
+    ),
+    ("langchain", "schema", "runnable", "HubRunnable"): (
+        "langchain",
+        "runnables",
+        "hub",
+        "HubRunnable",
+    ),
+    ("langchain", "schema", "runnable", "RunnableBindingBase"): (
+        "langchain_core",
+        "runnables",
+        "base",
+        "RunnableBindingBase",
+    ),
+    ("langchain", "schema", "runnable", "OpenAIFunctionsRouter"): (
+        "langchain",
+        "runnables",
+        "openai_functions",
+        "OpenAIFunctionsRouter",
+    ),
+    ("langchain", "schema", "runnable", "RouterRunnable"): (
+        "langchain_core",
+        "runnables",
+        "router",
+        "RouterRunnable",
+    ),
+    ("langchain", "schema", "runnable", "RunnablePassthrough"): (
+        "langchain_core",
+        "runnables",
+        "passthrough",
+        "RunnablePassthrough",
+    ),
+    ("langchain", "schema", "runnable", "RunnableSequence"): (
+        "langchain_core",
+        "runnables",
+        "base",
+        "RunnableSequence",
+    ),
+    ("langchain", "schema", "runnable", "RunnableEach"): (
+        "langchain_core",
+        "runnables",
+        "base",
+        "RunnableEach",
+    ),
+    ("langchain", "schema", "runnable", "RunnableEachBase"): (
+        "langchain_core",
+        "runnables",
+        "base",
+        "RunnableEachBase",
+    ),
+    ("langchain", "schema", "runnable", "RunnableConfigurableAlternatives"): (
+        "langchain_core",
+        "runnables",
+        "configurable",
+        "RunnableConfigurableAlternatives",
+    ),
+    ("langchain", "schema", "runnable", "RunnableConfigurableFields"): (
+        "langchain_core",
+        "runnables",
+        "configurable",
+        "RunnableConfigurableFields",
+    ),
+    ("langchain", "schema", "runnable", "RunnableWithMessageHistory"): (
+        "langchain_core",
+        "runnables",
+        "history",
+        "RunnableWithMessageHistory",
+    ),
+    ("langchain", "schema", "runnable", "RunnableAssign"): (
+        "langchain_core",
+        "runnables",
+        "passthrough",
+        "RunnableAssign",
+    ),
+    ("langchain", "schema", "runnable", "RunnableRetry"): (
+        "langchain_core",
+        "runnables",
+        "retry",
+        "RunnableRetry",
+    ),
+    ("langchain_core", "prompts", "structured", "StructuredPrompt"): (
+        "langchain_core",
+        "prompts",
+        "structured",
+        "StructuredPrompt",
+    ),
+}
+
+# Needed for backwards compatibility for old versions of LangChain where things
+# Were in different place
+_OG_SERIALIZABLE_MAPPING: Dict[Tuple[str, ...], Tuple[str, ...]] = {
+    ("langchain", "schema", "AIMessage"): (
+        "langchain_core",
+        "messages",
+        "ai",
+        "AIMessage",
+    ),
+    ("langchain", "schema", "ChatMessage"): (
+        "langchain_core",
+        "messages",
+        "chat",
+        "ChatMessage",
+    ),
+    ("langchain", "schema", "FunctionMessage"): (
+        "langchain_core",
+        "messages",
+        "function",
+        "FunctionMessage",
+    ),
+    ("langchain", "schema", "HumanMessage"): (
+        "langchain_core",
+        "messages",
+        "human",
+        "HumanMessage",
+    ),
+    ("langchain", "schema", "SystemMessage"): (
+        "langchain_core",
+        "messages",
+        "system",
+        "SystemMessage",
+    ),
+    ("langchain", "schema", "prompt_template", "ImagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "image",
+        "ImagePromptTemplate",
+    ),
+    ("langchain", "schema", "agent", "OpenAIToolAgentAction"): (
+        "langchain",
+        "agents",
+        "output_parsers",
+        "openai_tools",
+        "OpenAIToolAgentAction",
+    ),
+}
+
+# Needed for backwards compatibility for a few versions where we serialized
+# with langchain_core paths.
+OLD_CORE_NAMESPACES_MAPPING: Dict[Tuple[str, ...], Tuple[str, ...]] = {
+    ("langchain_core", "messages", "ai", "AIMessage"): (
+        "langchain_core",
+        "messages",
+        "ai",
+        "AIMessage",
+    ),
+    ("langchain_core", "messages", "ai", "AIMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "ai",
+        "AIMessageChunk",
+    ),
+    ("langchain_core", "messages", "base", "BaseMessage"): (
+        "langchain_core",
+        "messages",
+        "base",
+        "BaseMessage",
+    ),
+    ("langchain_core", "messages", "base", "BaseMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "base",
+        "BaseMessageChunk",
+    ),
+    ("langchain_core", "messages", "chat", "ChatMessage"): (
+        "langchain_core",
+        "messages",
+        "chat",
+        "ChatMessage",
+    ),
+    ("langchain_core", "messages", "function", "FunctionMessage"): (
+        "langchain_core",
+        "messages",
+        "function",
+        "FunctionMessage",
+    ),
+    ("langchain_core", "messages", "human", "HumanMessage"): (
+        "langchain_core",
+        "messages",
+        "human",
+        "HumanMessage",
+    ),
+    ("langchain_core", "messages", "system", "SystemMessage"): (
+        "langchain_core",
+        "messages",
+        "system",
+        "SystemMessage",
+    ),
+    ("langchain_core", "messages", "tool", "ToolMessage"): (
+        "langchain_core",
+        "messages",
+        "tool",
+        "ToolMessage",
+    ),
+    ("langchain_core", "agents", "AgentAction"): (
+        "langchain_core",
+        "agents",
+        "AgentAction",
+    ),
+    ("langchain_core", "agents", "AgentFinish"): (
+        "langchain_core",
+        "agents",
+        "AgentFinish",
+    ),
+    ("langchain_core", "prompts", "base", "BasePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "base",
+        "BasePromptTemplate",
+    ),
+    ("langchain_core", "prompts", "prompt", "PromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "prompt",
+        "PromptTemplate",
+    ),
+    ("langchain_core", "prompts", "chat", "MessagesPlaceholder"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "MessagesPlaceholder",
+    ),
+    ("langchain_core", "prompts", "chat", "ChatPromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "ChatPromptTemplate",
+    ),
+    ("langchain_core", "prompts", "chat", "HumanMessagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "HumanMessagePromptTemplate",
+    ),
+    ("langchain_core", "prompts", "chat", "SystemMessagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "SystemMessagePromptTemplate",
+    ),
+    ("langchain_core", "agents", "AgentActionMessageLog"): (
+        "langchain_core",
+        "agents",
+        "AgentActionMessageLog",
+    ),
+    ("langchain_core", "prompts", "chat", "BaseMessagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "BaseMessagePromptTemplate",
+    ),
+    ("langchain_core", "outputs", "chat_generation", "ChatGeneration"): (
+        "langchain_core",
+        "outputs",
+        "chat_generation",
+        "ChatGeneration",
+    ),
+    ("langchain_core", "outputs", "generation", "Generation"): (
+        "langchain_core",
+        "outputs",
+        "generation",
+        "Generation",
+    ),
+    ("langchain_core", "documents", "base", "Document"): (
+        "langchain_core",
+        "documents",
+        "base",
+        "Document",
+    ),
+    ("langchain_core", "prompts", "chat", "AIMessagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "AIMessagePromptTemplate",
+    ),
+    ("langchain_core", "runnables", "configurable", "DynamicRunnable"): (
+        "langchain_core",
+        "runnables",
+        "configurable",
+        "DynamicRunnable",
+    ),
+    ("langchain_core", "prompt_values", "PromptValue"): (
+        "langchain_core",
+        "prompt_values",
+        "PromptValue",
+    ),
+    ("langchain_core", "runnables", "base", "RunnableBinding"): (
+        "langchain_core",
+        "runnables",
+        "base",
+        "RunnableBinding",
+    ),
+    ("langchain_core", "runnables", "branch", "RunnableBranch"): (
+        "langchain_core",
+        "runnables",
+        "branch",
+        "RunnableBranch",
+    ),
+    ("langchain_core", "runnables", "fallbacks", "RunnableWithFallbacks"): (
+        "langchain_core",
+        "runnables",
+        "fallbacks",
+        "RunnableWithFallbacks",
+    ),
+    ("langchain_core", "output_parsers", "string", "StrOutputParser"): (
+        "langchain_core",
+        "output_parsers",
+        "string",
+        "StrOutputParser",
+    ),
+    ("langchain_core", "output_parsers", "list", "CommaSeparatedListOutputParser"): (
+        "langchain_core",
+        "output_parsers",
+        "list",
+        "CommaSeparatedListOutputParser",
+    ),
+    ("langchain_core", "runnables", "base", "RunnableParallel"): (
+        "langchain_core",
+        "runnables",
+        "base",
+        "RunnableParallel",
+    ),
+    ("langchain_core", "outputs", "chat_generation", "ChatGenerationChunk"): (
+        "langchain_core",
+        "outputs",
+        "chat_generation",
+        "ChatGenerationChunk",
+    ),
+    ("langchain_core", "messages", "chat", "ChatMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "chat",
+        "ChatMessageChunk",
+    ),
+    ("langchain_core", "messages", "human", "HumanMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "human",
+        "HumanMessageChunk",
+    ),
+    ("langchain_core", "messages", "function", "FunctionMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "function",
+        "FunctionMessageChunk",
+    ),
+    ("langchain_core", "messages", "system", "SystemMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "system",
+        "SystemMessageChunk",
+    ),
+    ("langchain_core", "messages", "tool", "ToolMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "tool",
+        "ToolMessageChunk",
+    ),
+    ("langchain_core", "outputs", "generation", "GenerationChunk"): (
+        "langchain_core",
+        "outputs",
+        "generation",
+        "GenerationChunk",
+    ),
+    ("langchain_core", "prompts", "chat", "BaseChatPromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "BaseChatPromptTemplate",
+    ),
+    ("langchain_core", "prompts", "chat", "ChatMessagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "ChatMessagePromptTemplate",
+    ),
+    (
+        "langchain_core",
+        "prompts",
+        "few_shot_with_templates",
+        "FewShotPromptWithTemplates",
+    ): (
+        "langchain_core",
+        "prompts",
+        "few_shot_with_templates",
+        "FewShotPromptWithTemplates",
+    ),
+    ("langchain_core", "prompts", "pipeline", "PipelinePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "pipeline",
+        "PipelinePromptTemplate",
+    ),
+    ("langchain_core", "prompts", "string", "StringPromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "string",
+        "StringPromptTemplate",
+    ),
+    ("langchain_core", "prompt_values", "StringPromptValue"): (
+        "langchain_core",
+        "prompt_values",
+        "StringPromptValue",
+    ),
+    ("langchain_core", "prompts", "chat", "BaseStringMessagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "chat",
+        "BaseStringMessagePromptTemplate",
+    ),
+    ("langchain_core", "prompt_values", "ChatPromptValue"): (
+        "langchain_core",
+        "prompt_values",
+        "ChatPromptValue",
+    ),
+    ("langchain_core", "prompt_values", "ChatPromptValueConcrete"): (
+        "langchain_core",
+        "prompt_values",
+        "ChatPromptValueConcrete",
+    ),
+    ("langchain_core", "runnables", "base", "RunnableBindingBase"): (
+        "langchain_core",
+        "runnables",
+        "base",
+        "RunnableBindingBase",
+    ),
+    ("langchain_core", "runnables", "router", "RouterRunnable"): (
+        "langchain_core",
+        "runnables",
+        "router",
+        "RouterRunnable",
+    ),
+    ("langchain_core", "runnables", "passthrough", "RunnablePassthrough"): (
+        "langchain_core",
+        "runnables",
+        "passthrough",
+        "RunnablePassthrough",
+    ),
+    ("langchain_core", "runnables", "base", "RunnableSequence"): (
+        "langchain_core",
+        "runnables",
+        "base",
+        "RunnableSequence",
+    ),
+    ("langchain_core", "runnables", "base", "RunnableEach"): (
+        "langchain_core",
+        "runnables",
+        "base",
+        "RunnableEach",
+    ),
+    ("langchain_core", "runnables", "base", "RunnableEachBase"): (
+        "langchain_core",
+        "runnables",
+        "base",
+        "RunnableEachBase",
+    ),
+    (
+        "langchain_core",
+        "runnables",
+        "configurable",
+        "RunnableConfigurableAlternatives",
+    ): (
+        "langchain_core",
+        "runnables",
+        "configurable",
+        "RunnableConfigurableAlternatives",
+    ),
+    ("langchain_core", "runnables", "configurable", "RunnableConfigurableFields"): (
+        "langchain_core",
+        "runnables",
+        "configurable",
+        "RunnableConfigurableFields",
+    ),
+    ("langchain_core", "runnables", "history", "RunnableWithMessageHistory"): (
+        "langchain_core",
+        "runnables",
+        "history",
+        "RunnableWithMessageHistory",
+    ),
+    ("langchain_core", "runnables", "passthrough", "RunnableAssign"): (
+        "langchain_core",
+        "runnables",
+        "passthrough",
+        "RunnableAssign",
+    ),
+    ("langchain_core", "runnables", "retry", "RunnableRetry"): (
+        "langchain_core",
+        "runnables",
+        "retry",
+        "RunnableRetry",
+    ),
+}
+
+_JS_SERIALIZABLE_MAPPING: Dict[Tuple[str, ...], Tuple[str, ...]] = {
+    ("langchain_core", "messages", "AIMessage"): (
+        "langchain_core",
+        "messages",
+        "ai",
+        "AIMessage",
+    ),
+    ("langchain_core", "messages", "AIMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "ai",
+        "AIMessageChunk",
+    ),
+    ("langchain_core", "messages", "BaseMessage"): (
+        "langchain_core",
+        "messages",
+        "base",
+        "BaseMessage",
+    ),
+    ("langchain_core", "messages", "BaseMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "base",
+        "BaseMessageChunk",
+    ),
+    ("langchain_core", "messages", "ChatMessage"): (
+        "langchain_core",
+        "messages",
+        "chat",
+        "ChatMessage",
+    ),
+    ("langchain_core", "messages", "ChatMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "chat",
+        "ChatMessageChunk",
+    ),
+    ("langchain_core", "messages", "FunctionMessage"): (
+        "langchain_core",
+        "messages",
+        "function",
+        "FunctionMessage",
+    ),
+    ("langchain_core", "messages", "FunctionMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "function",
+        "FunctionMessageChunk",
+    ),
+    ("langchain_core", "messages", "HumanMessage"): (
+        "langchain_core",
+        "messages",
+        "human",
+        "HumanMessage",
+    ),
+    ("langchain_core", "messages", "HumanMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "human",
+        "HumanMessageChunk",
+    ),
+    ("langchain_core", "messages", "SystemMessage"): (
+        "langchain_core",
+        "messages",
+        "system",
+        "SystemMessage",
+    ),
+    ("langchain_core", "messages", "SystemMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "system",
+        "SystemMessageChunk",
+    ),
+    ("langchain_core", "messages", "ToolMessage"): (
+        "langchain_core",
+        "messages",
+        "tool",
+        "ToolMessage",
+    ),
+    ("langchain_core", "messages", "ToolMessageChunk"): (
+        "langchain_core",
+        "messages",
+        "tool",
+        "ToolMessageChunk",
+    ),
+    ("langchain_core", "prompts", "image", "ImagePromptTemplate"): (
+        "langchain_core",
+        "prompts",
+        "image",
+        "ImagePromptTemplate",
+    ),
+}
diff --git a/llm/Lib/site-packages/langchain_core/load/serializable.py b/llm/Lib/site-packages/langchain_core/load/serializable.py
new file mode 100644
index 0000000000000000000000000000000000000000..38f7fc1d3d18c9894e75369012aa0290ca2b0e67
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/load/serializable.py
@@ -0,0 +1,238 @@
+from abc import ABC
+from typing import (
+    Any,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    TypedDict,
+    Union,
+    cast,
+)
+
+from typing_extensions import NotRequired
+
+from langchain_core.pydantic_v1 import BaseModel, PrivateAttr
+
+
+class BaseSerialized(TypedDict):
+    """Base class for serialized objects."""
+
+    lc: int
+    id: List[str]
+    name: NotRequired[str]
+    graph: NotRequired[Dict[str, Any]]
+
+
+class SerializedConstructor(BaseSerialized):
+    """Serialized constructor."""
+
+    type: Literal["constructor"]
+    kwargs: Dict[str, Any]
+
+
+class SerializedSecret(BaseSerialized):
+    """Serialized secret."""
+
+    type: Literal["secret"]
+
+
+class SerializedNotImplemented(BaseSerialized):
+    """Serialized not implemented."""
+
+    type: Literal["not_implemented"]
+    repr: Optional[str]
+
+
+def try_neq_default(value: Any, key: str, model: BaseModel) -> bool:
+    """Try to determine if a value is different from the default.
+
+    Args:
+        value: The value.
+        key: The key.
+        model: The model.
+
+    Returns:
+        Whether the value is different from the default.
+    """
+    try:
+        return model.__fields__[key].get_default() != value
+    except Exception:
+        return True
+
+
+class Serializable(BaseModel, ABC):
+    """Serializable base class."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Is this class serializable?"""
+        return False
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object.
+
+        For example, if the class is `langchain.llms.openai.OpenAI`, then the
+        namespace is ["langchain", "llms", "openai"]
+        """
+        return cls.__module__.split(".")
+
+    @property
+    def lc_secrets(self) -> Dict[str, str]:
+        """A map of constructor argument names to secret ids.
+
+        For example,
+            {"openai_api_key": "OPENAI_API_KEY"}
+        """
+        return dict()
+
+    @property
+    def lc_attributes(self) -> Dict:
+        """List of attribute names that should be included in the serialized kwargs.
+
+        These attributes must be accepted by the constructor.
+        """
+        return {}
+
+    @classmethod
+    def lc_id(cls) -> List[str]:
+        """A unique identifier for this class for serialization purposes.
+
+        The unique identifier is a list of strings that describes the path
+        to the object.
+        """
+        return [*cls.get_lc_namespace(), cls.__name__]
+
+    class Config:
+        extra = "ignore"
+
+    def __repr_args__(self) -> Any:
+        return [
+            (k, v)
+            for k, v in super().__repr_args__()
+            if (k not in self.__fields__ or try_neq_default(v, k, self))
+        ]
+
+    _lc_kwargs = PrivateAttr(default_factory=dict)
+
+    def __init__(self, **kwargs: Any) -> None:
+        super().__init__(**kwargs)
+        self._lc_kwargs = kwargs
+
+    def to_json(self) -> Union[SerializedConstructor, SerializedNotImplemented]:
+        if not self.is_lc_serializable():
+            return self.to_json_not_implemented()
+
+        secrets = dict()
+        # Get latest values for kwargs if there is an attribute with same name
+        lc_kwargs = {
+            k: getattr(self, k, v)
+            for k, v in self._lc_kwargs.items()
+            if not (self.__exclude_fields__ or {}).get(k, False)  # type: ignore
+        }
+
+        # Merge the lc_secrets and lc_attributes from every class in the MRO
+        for cls in [None, *self.__class__.mro()]:
+            # Once we get to Serializable, we're done
+            if cls is Serializable:
+                break
+
+            if cls:
+                deprecated_attributes = [
+                    "lc_namespace",
+                    "lc_serializable",
+                ]
+
+                for attr in deprecated_attributes:
+                    if hasattr(cls, attr):
+                        raise ValueError(
+                            f"Class {self.__class__} has a deprecated "
+                            f"attribute {attr}. Please use the corresponding "
+                            f"classmethod instead."
+                        )
+
+            # Get a reference to self bound to each class in the MRO
+            this = cast(Serializable, self if cls is None else super(cls, self))
+
+            secrets.update(this.lc_secrets)
+            # Now also add the aliases for the secrets
+            # This ensures known secret aliases are hidden.
+            # Note: this does NOT hide any other extra kwargs
+            # that are not present in the fields.
+            for key in list(secrets):
+                value = secrets[key]
+                if key in this.__fields__:
+                    secrets[this.__fields__[key].alias] = value
+            lc_kwargs.update(this.lc_attributes)
+
+        # include all secrets, even if not specified in kwargs
+        # as these secrets may be passed as an environment variable instead
+        for key in secrets.keys():
+            secret_value = getattr(self, key, None) or lc_kwargs.get(key)
+            if secret_value is not None:
+                lc_kwargs.update({key: secret_value})
+
+        return {
+            "lc": 1,
+            "type": "constructor",
+            "id": self.lc_id(),
+            "kwargs": lc_kwargs
+            if not secrets
+            else _replace_secrets(lc_kwargs, secrets),
+        }
+
+    def to_json_not_implemented(self) -> SerializedNotImplemented:
+        return to_json_not_implemented(self)
+
+
+def _replace_secrets(
+    root: Dict[Any, Any], secrets_map: Dict[str, str]
+) -> Dict[Any, Any]:
+    result = root.copy()
+    for path, secret_id in secrets_map.items():
+        [*parts, last] = path.split(".")
+        current = result
+        for part in parts:
+            if part not in current:
+                break
+            current[part] = current[part].copy()
+            current = current[part]
+        if last in current:
+            current[last] = {
+                "lc": 1,
+                "type": "secret",
+                "id": [secret_id],
+            }
+    return result
+
+
+def to_json_not_implemented(obj: object) -> SerializedNotImplemented:
+    """Serialize a "not implemented" object.
+
+    Args:
+        obj: object to serialize
+
+    Returns:
+        SerializedNotImplemented
+    """
+    _id: List[str] = []
+    try:
+        if hasattr(obj, "__name__"):
+            _id = [*obj.__module__.split("."), obj.__name__]
+        elif hasattr(obj, "__class__"):
+            _id = [*obj.__class__.__module__.split("."), obj.__class__.__name__]
+    except Exception:
+        pass
+
+    result: SerializedNotImplemented = {
+        "lc": 1,
+        "type": "not_implemented",
+        "id": _id,
+        "repr": None,
+    }
+    try:
+        result["repr"] = repr(obj)
+    except Exception:
+        pass
+    return result
diff --git a/llm/Lib/site-packages/langchain_core/memory.py b/llm/Lib/site-packages/langchain_core/memory.py
new file mode 100644
index 0000000000000000000000000000000000000000..f7960cc30930b0493bd2bd9c9cd27e3f0b63db2d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/memory.py
@@ -0,0 +1,83 @@
+"""**Memory** maintains Chain state, incorporating context from past runs.
+
+**Class hierarchy for Memory:**
+
+.. code-block::
+
+    BaseMemory --> <name>Memory --> <name>Memory  # Examples: BaseChatMemory -> MotorheadMemory
+
+"""  # noqa: E501
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import Any, Dict, List
+
+from langchain_core.load.serializable import Serializable
+from langchain_core.runnables import run_in_executor
+
+
+class BaseMemory(Serializable, ABC):
+    """Abstract base class for memory in Chains.
+
+    Memory refers to state in Chains. Memory can be used to store information about
+        past executions of a Chain and inject that information into the inputs of
+        future executions of the Chain. For example, for conversational Chains Memory
+        can be used to store conversations and automatically add them to future model
+        prompts so that the model has the necessary context to respond coherently to
+        the latest input.
+
+    Example:
+        .. code-block:: python
+
+            class SimpleMemory(BaseMemory):
+                memories: Dict[str, Any] = dict()
+
+                @property
+                def memory_variables(self) -> List[str]:
+                    return list(self.memories.keys())
+
+                def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, str]:
+                    return self.memories
+
+                def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+                    pass
+
+                def clear(self) -> None:
+                    pass
+    """  # noqa: E501
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @property
+    @abstractmethod
+    def memory_variables(self) -> List[str]:
+        """The string keys this memory class will add to chain inputs."""
+
+    @abstractmethod
+    def load_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, Any]:
+        """Return key-value pairs given the text input to the chain."""
+
+    async def aload_memory_variables(self, inputs: Dict[str, Any]) -> Dict[str, Any]:
+        """Return key-value pairs given the text input to the chain."""
+        return await run_in_executor(None, self.load_memory_variables, inputs)
+
+    @abstractmethod
+    def save_context(self, inputs: Dict[str, Any], outputs: Dict[str, str]) -> None:
+        """Save the context of this chain run to memory."""
+
+    async def asave_context(
+        self, inputs: Dict[str, Any], outputs: Dict[str, str]
+    ) -> None:
+        """Save the context of this chain run to memory."""
+        await run_in_executor(None, self.save_context, inputs, outputs)
+
+    @abstractmethod
+    def clear(self) -> None:
+        """Clear memory contents."""
+
+    async def aclear(self) -> None:
+        """Clear memory contents."""
+        await run_in_executor(None, self.clear)
diff --git a/llm/Lib/site-packages/langchain_core/messages/__init__.py b/llm/Lib/site-packages/langchain_core/messages/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..286da353f0aa1c50d824a697ab8ae602c8e77b41
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/messages/__init__.py
@@ -0,0 +1,78 @@
+"""**Messages** are objects used in prompts and chat conversations.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseMessage --> SystemMessage, AIMessage, HumanMessage, ChatMessage, FunctionMessage, ToolMessage
+                --> BaseMessageChunk --> SystemMessageChunk, AIMessageChunk, HumanMessageChunk, ChatMessageChunk, FunctionMessageChunk, ToolMessageChunk
+
+**Main helpers:**
+
+.. code-block::
+
+    ChatPromptTemplate
+
+"""  # noqa: E501
+
+from langchain_core.messages.ai import (
+    AIMessage,
+    AIMessageChunk,
+)
+from langchain_core.messages.base import (
+    BaseMessage,
+    BaseMessageChunk,
+    merge_content,
+    message_to_dict,
+    messages_to_dict,
+)
+from langchain_core.messages.chat import ChatMessage, ChatMessageChunk
+from langchain_core.messages.function import FunctionMessage, FunctionMessageChunk
+from langchain_core.messages.human import HumanMessage, HumanMessageChunk
+from langchain_core.messages.system import SystemMessage, SystemMessageChunk
+from langchain_core.messages.tool import (
+    InvalidToolCall,
+    ToolCall,
+    ToolCallChunk,
+    ToolMessage,
+    ToolMessageChunk,
+)
+from langchain_core.messages.utils import (
+    AnyMessage,
+    MessageLikeRepresentation,
+    _message_from_dict,
+    convert_to_messages,
+    get_buffer_string,
+    message_chunk_to_message,
+    messages_from_dict,
+)
+
+__all__ = [
+    "AIMessage",
+    "AIMessageChunk",
+    "AnyMessage",
+    "BaseMessage",
+    "BaseMessageChunk",
+    "ChatMessage",
+    "ChatMessageChunk",
+    "FunctionMessage",
+    "FunctionMessageChunk",
+    "HumanMessage",
+    "HumanMessageChunk",
+    "InvalidToolCall",
+    "MessageLikeRepresentation",
+    "SystemMessage",
+    "SystemMessageChunk",
+    "ToolCall",
+    "ToolCallChunk",
+    "ToolMessage",
+    "ToolMessageChunk",
+    "_message_from_dict",
+    "convert_to_messages",
+    "get_buffer_string",
+    "merge_content",
+    "message_chunk_to_message",
+    "message_to_dict",
+    "messages_from_dict",
+    "messages_to_dict",
+]
diff --git a/llm/Lib/site-packages/langchain_core/messages/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/messages/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d36d6a988a8ac000fcb2cfb98e2353959f24156a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/messages/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/messages/__pycache__/ai.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/messages/__pycache__/ai.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5760082d818ba69f7b7694602427cfd461b8c5c3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/messages/__pycache__/ai.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/messages/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/messages/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6e5892549db35df9775c47e601040ea8686f9232
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/messages/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/messages/__pycache__/chat.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/messages/__pycache__/chat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..906ed4f302bcab249ae90f09ba9b70edafbb260f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/messages/__pycache__/chat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/messages/__pycache__/function.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/messages/__pycache__/function.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6e25641e83a1a1f93bc39ef2591bdec10af1c87c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/messages/__pycache__/function.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/messages/__pycache__/human.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/messages/__pycache__/human.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a8ee6abe8ad99769998817a88dde8f64a18352fa
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/messages/__pycache__/human.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/messages/__pycache__/system.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/messages/__pycache__/system.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3c84741abffa2aeb82a458d8914f55afc2bc8432
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/messages/__pycache__/system.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/messages/__pycache__/tool.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/messages/__pycache__/tool.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..84939636f9b624b4f787cf96548839f17ddb71ba
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/messages/__pycache__/tool.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/messages/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/messages/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..98612a37f7cc9cb08e095a9bb59124307bbaabea
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/messages/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/messages/ai.py b/llm/Lib/site-packages/langchain_core/messages/ai.py
new file mode 100644
index 0000000000000000000000000000000000000000..e1556cb7a6096557d76e43b3dad63aaead27b6bd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/messages/ai.py
@@ -0,0 +1,179 @@
+from typing import Any, Dict, List, Literal
+
+from langchain_core.messages.base import (
+    BaseMessage,
+    BaseMessageChunk,
+    merge_content,
+)
+from langchain_core.messages.tool import (
+    InvalidToolCall,
+    ToolCall,
+    ToolCallChunk,
+    default_tool_chunk_parser,
+    default_tool_parser,
+)
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.utils._merge import merge_dicts, merge_lists
+from langchain_core.utils.json import (
+    parse_partial_json,
+)
+
+
+class AIMessage(BaseMessage):
+    """Message from an AI."""
+
+    example: bool = False
+    """Whether this Message is being passed in to the model as part of an example 
+        conversation.
+    """
+
+    tool_calls: List[ToolCall] = []
+    """If provided, tool calls associated with the message."""
+    invalid_tool_calls: List[InvalidToolCall] = []
+    """If provided, tool calls with parsing errors associated with the message."""
+
+    type: Literal["ai"] = "ai"
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
+
+    @property
+    def lc_attributes(self) -> Dict:
+        """Attrs to be serialized even if they are derived from other init args."""
+        return {
+            "tool_calls": self.tool_calls,
+            "invalid_tool_calls": self.invalid_tool_calls,
+        }
+
+    @root_validator()
+    def _backwards_compat_tool_calls(cls, values: dict) -> dict:
+        raw_tool_calls = values.get("additional_kwargs", {}).get("tool_calls")
+        tool_calls = (
+            values.get("tool_calls")
+            or values.get("invalid_tool_calls")
+            or values.get("tool_call_chunks")
+        )
+        if raw_tool_calls and not tool_calls:
+            try:
+                if issubclass(cls, AIMessageChunk):  # type: ignore
+                    values["tool_call_chunks"] = default_tool_chunk_parser(
+                        raw_tool_calls
+                    )
+                else:
+                    tool_calls, invalid_tool_calls = default_tool_parser(raw_tool_calls)
+                    values["tool_calls"] = tool_calls
+                    values["invalid_tool_calls"] = invalid_tool_calls
+            except Exception:
+                pass
+        return values
+
+
+AIMessage.update_forward_refs()
+
+
+class AIMessageChunk(AIMessage, BaseMessageChunk):
+    """Message chunk from an AI."""
+
+    # Ignoring mypy re-assignment here since we're overriding the value
+    # to make sure that the chunk variant can be discriminated from the
+    # non-chunk variant.
+    type: Literal["AIMessageChunk"] = "AIMessageChunk"  # type: ignore[assignment] # noqa: E501
+
+    tool_call_chunks: List[ToolCallChunk] = []
+    """If provided, tool call chunks associated with the message."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
+
+    @property
+    def lc_attributes(self) -> Dict:
+        """Attrs to be serialized even if they are derived from other init args."""
+        return {
+            "tool_calls": self.tool_calls,
+            "invalid_tool_calls": self.invalid_tool_calls,
+        }
+
+    @root_validator()
+    def init_tool_calls(cls, values: dict) -> dict:
+        if not values["tool_call_chunks"]:
+            values["tool_calls"] = []
+            values["invalid_tool_calls"] = []
+            return values
+        tool_calls = []
+        invalid_tool_calls = []
+        for chunk in values["tool_call_chunks"]:
+            try:
+                args_ = parse_partial_json(chunk["args"])
+                if isinstance(args_, dict):
+                    tool_calls.append(
+                        ToolCall(
+                            name=chunk["name"] or "",
+                            args=args_,
+                            id=chunk["id"],
+                        )
+                    )
+                else:
+                    raise ValueError("Malformed args.")
+            except Exception:
+                invalid_tool_calls.append(
+                    InvalidToolCall(
+                        name=chunk["name"],
+                        args=chunk["args"],
+                        id=chunk["id"],
+                        error="Malformed args.",
+                    )
+                )
+        values["tool_calls"] = tool_calls
+        values["invalid_tool_calls"] = invalid_tool_calls
+        return values
+
+    def __add__(self, other: Any) -> BaseMessageChunk:  # type: ignore
+        if isinstance(other, AIMessageChunk):
+            if self.example != other.example:
+                raise ValueError(
+                    "Cannot concatenate AIMessageChunks with different example values."
+                )
+
+            content = merge_content(self.content, other.content)
+            additional_kwargs = merge_dicts(
+                self.additional_kwargs, other.additional_kwargs
+            )
+            response_metadata = merge_dicts(
+                self.response_metadata, other.response_metadata
+            )
+
+            # Merge tool call chunks
+            if self.tool_call_chunks or other.tool_call_chunks:
+                raw_tool_calls = merge_lists(
+                    self.tool_call_chunks,
+                    other.tool_call_chunks,
+                )
+                if raw_tool_calls:
+                    tool_call_chunks = [
+                        ToolCallChunk(
+                            name=rtc.get("name"),
+                            args=rtc.get("args"),
+                            index=rtc.get("index"),
+                            id=rtc.get("id"),
+                        )
+                        for rtc in raw_tool_calls
+                    ]
+                else:
+                    tool_call_chunks = []
+            else:
+                tool_call_chunks = []
+
+            return self.__class__(
+                example=self.example,
+                content=content,
+                additional_kwargs=additional_kwargs,
+                tool_call_chunks=tool_call_chunks,
+                response_metadata=response_metadata,
+                id=self.id,
+            )
+
+        return super().__add__(other)
diff --git a/llm/Lib/site-packages/langchain_core/messages/base.py b/llm/Lib/site-packages/langchain_core/messages/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..60c57220033e0e9ad5eee9ebb440224909f0f3a4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/messages/base.py
@@ -0,0 +1,183 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Sequence, Union
+
+from langchain_core.load.serializable import Serializable
+from langchain_core.pydantic_v1 import Extra, Field
+from langchain_core.utils import get_bolded_text
+from langchain_core.utils._merge import merge_dicts
+from langchain_core.utils.interactive_env import is_interactive_env
+
+if TYPE_CHECKING:
+    from langchain_core.prompts.chat import ChatPromptTemplate
+
+
+class BaseMessage(Serializable):
+    """Base abstract Message class.
+
+    Messages are the inputs and outputs of ChatModels.
+    """
+
+    content: Union[str, List[Union[str, Dict]]]
+    """The string contents of the message."""
+
+    additional_kwargs: dict = Field(default_factory=dict)
+    """Reserved for additional payload data associated with the message.
+    
+    For example, for a message from an AI, this could include tool calls."""
+
+    response_metadata: dict = Field(default_factory=dict)
+    """Response metadata. For example: response headers, logprobs, token counts."""
+
+    type: str
+
+    name: Optional[str] = None
+
+    id: Optional[str] = None
+    """An optional unique identifier for the message. This should ideally be
+    provided by the provider/model which created the message."""
+
+    class Config:
+        extra = Extra.allow
+
+    def __init__(
+        self, content: Union[str, List[Union[str, Dict]]], **kwargs: Any
+    ) -> None:
+        """Pass in content as positional arg."""
+        return super().__init__(content=content, **kwargs)
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this class is serializable."""
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
+
+    def __add__(self, other: Any) -> ChatPromptTemplate:
+        from langchain_core.prompts.chat import ChatPromptTemplate
+
+        prompt = ChatPromptTemplate(messages=[self])  # type: ignore[call-arg]
+        return prompt + other
+
+    def pretty_repr(self, html: bool = False) -> str:
+        title = get_msg_title_repr(self.type.title() + " Message", bold=html)
+        # TODO: handle non-string content.
+        if self.name is not None:
+            title += f"\nName: {self.name}"
+        return f"{title}\n\n{self.content}"
+
+    def pretty_print(self) -> None:
+        print(self.pretty_repr(html=is_interactive_env()))  # noqa: T201
+
+
+def merge_content(
+    first_content: Union[str, List[Union[str, Dict]]],
+    second_content: Union[str, List[Union[str, Dict]]],
+) -> Union[str, List[Union[str, Dict]]]:
+    """Merge two message contents.
+
+    Args:
+        first_content: The first content.
+        second_content: The second content.
+
+    Returns:
+        The merged content.
+    """
+    # If first chunk is a string
+    if isinstance(first_content, str):
+        # If the second chunk is also a string, then merge them naively
+        if isinstance(second_content, str):
+            return first_content + second_content
+        # If the second chunk is a list, add the first chunk to the start of the list
+        else:
+            return_list: List[Union[str, Dict]] = [first_content]
+            return return_list + second_content
+    # If both are lists, merge them naively
+    elif isinstance(second_content, List):
+        return first_content + second_content
+    # If the first content is a list, and the second content is a string
+    else:
+        # If the last element of the first content is a string
+        # Add the second content to the last element
+        if isinstance(first_content[-1], str):
+            return first_content[:-1] + [first_content[-1] + second_content]
+        else:
+            # Otherwise, add the second content as a new element of the list
+            return first_content + [second_content]
+
+
+class BaseMessageChunk(BaseMessage):
+    """Message chunk, which can be concatenated with other Message chunks."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
+
+    def __add__(self, other: Any) -> BaseMessageChunk:  # type: ignore
+        if isinstance(other, BaseMessageChunk):
+            # If both are (subclasses of) BaseMessageChunk,
+            # concat into a single BaseMessageChunk
+
+            return self.__class__(  # type: ignore[call-arg]
+                id=self.id,
+                content=merge_content(self.content, other.content),
+                additional_kwargs=merge_dicts(
+                    self.additional_kwargs, other.additional_kwargs
+                ),
+                response_metadata=merge_dicts(
+                    self.response_metadata, other.response_metadata
+                ),
+            )
+        else:
+            raise TypeError(
+                'unsupported operand type(s) for +: "'
+                f"{self.__class__.__name__}"
+                f'" and "{other.__class__.__name__}"'
+            )
+
+
+def message_to_dict(message: BaseMessage) -> dict:
+    """Convert a Message to a dictionary.
+
+    Args:
+        message: Message to convert.
+
+    Returns:
+        Message as a dict.
+    """
+    return {"type": message.type, "data": message.dict()}
+
+
+def messages_to_dict(messages: Sequence[BaseMessage]) -> List[dict]:
+    """Convert a sequence of Messages to a list of dictionaries.
+
+    Args:
+        messages: Sequence of messages (as BaseMessages) to convert.
+
+    Returns:
+        List of messages as dicts.
+    """
+    return [message_to_dict(m) for m in messages]
+
+
+def get_msg_title_repr(title: str, *, bold: bool = False) -> str:
+    """Get a title representation for a message.
+
+    Args:
+        title: The title.
+        bold: Whether to bold the title.
+
+    Returns:
+        The title representation.
+    """
+    padded = " " + title + " "
+    sep_len = (80 - len(padded)) // 2
+    sep = "=" * sep_len
+    second_sep = sep + "=" if len(padded) % 2 else sep
+    if bold:
+        padded = get_bolded_text(padded)
+    return f"{sep}{padded}{second_sep}"
diff --git a/llm/Lib/site-packages/langchain_core/messages/chat.py b/llm/Lib/site-packages/langchain_core/messages/chat.py
new file mode 100644
index 0000000000000000000000000000000000000000..f8a9add85e1cbc191ce9903668b468fe4f02edd5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/messages/chat.py
@@ -0,0 +1,72 @@
+from typing import Any, List, Literal
+
+from langchain_core.messages.base import (
+    BaseMessage,
+    BaseMessageChunk,
+    merge_content,
+)
+from langchain_core.utils._merge import merge_dicts
+
+
+class ChatMessage(BaseMessage):
+    """Message that can be assigned an arbitrary speaker (i.e. role)."""
+
+    role: str
+    """The speaker / role of the Message."""
+
+    type: Literal["chat"] = "chat"
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
+
+
+ChatMessage.update_forward_refs()
+
+
+class ChatMessageChunk(ChatMessage, BaseMessageChunk):
+    """Chat Message chunk."""
+
+    # Ignoring mypy re-assignment here since we're overriding the value
+    # to make sure that the chunk variant can be discriminated from the
+    # non-chunk variant.
+    type: Literal["ChatMessageChunk"] = "ChatMessageChunk"  # type: ignore
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
+
+    def __add__(self, other: Any) -> BaseMessageChunk:  # type: ignore
+        if isinstance(other, ChatMessageChunk):
+            if self.role != other.role:
+                raise ValueError(
+                    "Cannot concatenate ChatMessageChunks with different roles."
+                )
+
+            return self.__class__(
+                role=self.role,
+                content=merge_content(self.content, other.content),
+                additional_kwargs=merge_dicts(
+                    self.additional_kwargs, other.additional_kwargs
+                ),
+                response_metadata=merge_dicts(
+                    self.response_metadata, other.response_metadata
+                ),
+                id=self.id,
+            )
+        elif isinstance(other, BaseMessageChunk):
+            return self.__class__(
+                role=self.role,
+                content=merge_content(self.content, other.content),
+                additional_kwargs=merge_dicts(
+                    self.additional_kwargs, other.additional_kwargs
+                ),
+                response_metadata=merge_dicts(
+                    self.response_metadata, other.response_metadata
+                ),
+                id=self.id,
+            )
+        else:
+            return super().__add__(other)
diff --git a/llm/Lib/site-packages/langchain_core/messages/function.py b/llm/Lib/site-packages/langchain_core/messages/function.py
new file mode 100644
index 0000000000000000000000000000000000000000..c28f42b9391c05f7340c17a457bd35ca8c115cf6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/messages/function.py
@@ -0,0 +1,60 @@
+from typing import Any, List, Literal
+
+from langchain_core.messages.base import (
+    BaseMessage,
+    BaseMessageChunk,
+    merge_content,
+)
+from langchain_core.utils._merge import merge_dicts
+
+
+class FunctionMessage(BaseMessage):
+    """Message for passing the result of executing a function back to a model."""
+
+    name: str
+    """The name of the function that was executed."""
+
+    type: Literal["function"] = "function"
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
+
+
+FunctionMessage.update_forward_refs()
+
+
+class FunctionMessageChunk(FunctionMessage, BaseMessageChunk):
+    """Function Message chunk."""
+
+    # Ignoring mypy re-assignment here since we're overriding the value
+    # to make sure that the chunk variant can be discriminated from the
+    # non-chunk variant.
+    type: Literal["FunctionMessageChunk"] = "FunctionMessageChunk"  # type: ignore[assignment]
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
+
+    def __add__(self, other: Any) -> BaseMessageChunk:  # type: ignore
+        if isinstance(other, FunctionMessageChunk):
+            if self.name != other.name:
+                raise ValueError(
+                    "Cannot concatenate FunctionMessageChunks with different names."
+                )
+
+            return self.__class__(
+                name=self.name,
+                content=merge_content(self.content, other.content),
+                additional_kwargs=merge_dicts(
+                    self.additional_kwargs, other.additional_kwargs
+                ),
+                response_metadata=merge_dicts(
+                    self.response_metadata, other.response_metadata
+                ),
+                id=self.id,
+            )
+
+        return super().__add__(other)
diff --git a/llm/Lib/site-packages/langchain_core/messages/human.py b/llm/Lib/site-packages/langchain_core/messages/human.py
new file mode 100644
index 0000000000000000000000000000000000000000..b89860a562853cb262df982815020de482c218b2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/messages/human.py
@@ -0,0 +1,36 @@
+from typing import List, Literal
+
+from langchain_core.messages.base import BaseMessage, BaseMessageChunk
+
+
+class HumanMessage(BaseMessage):
+    """Message from a human."""
+
+    example: bool = False
+    """Whether this Message is being passed in to the model as part of an example 
+        conversation.
+    """
+
+    type: Literal["human"] = "human"
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
+
+
+HumanMessage.update_forward_refs()
+
+
+class HumanMessageChunk(HumanMessage, BaseMessageChunk):
+    """Human Message chunk."""
+
+    # Ignoring mypy re-assignment here since we're overriding the value
+    # to make sure that the chunk variant can be discriminated from the
+    # non-chunk variant.
+    type: Literal["HumanMessageChunk"] = "HumanMessageChunk"  # type: ignore[assignment] # noqa: E501
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
diff --git a/llm/Lib/site-packages/langchain_core/messages/system.py b/llm/Lib/site-packages/langchain_core/messages/system.py
new file mode 100644
index 0000000000000000000000000000000000000000..c86a60f91ffd07fb260595224bb633c72c08b965
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/messages/system.py
@@ -0,0 +1,33 @@
+from typing import List, Literal
+
+from langchain_core.messages.base import BaseMessage, BaseMessageChunk
+
+
+class SystemMessage(BaseMessage):
+    """Message for priming AI behavior, usually passed in as the first of a sequence
+    of input messages.
+    """
+
+    type: Literal["system"] = "system"
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
+
+
+SystemMessage.update_forward_refs()
+
+
+class SystemMessageChunk(SystemMessage, BaseMessageChunk):
+    """System Message chunk."""
+
+    # Ignoring mypy re-assignment here since we're overriding the value
+    # to make sure that the chunk variant can be discriminated from the
+    # non-chunk variant.
+    type: Literal["SystemMessageChunk"] = "SystemMessageChunk"  # type: ignore[assignment] # noqa: E501
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
diff --git a/llm/Lib/site-packages/langchain_core/messages/tool.py b/llm/Lib/site-packages/langchain_core/messages/tool.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2d06f47fabc27f9346562bed1fe8705df748eda
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/messages/tool.py
@@ -0,0 +1,175 @@
+import json
+from typing import Any, Dict, List, Literal, Optional, Tuple
+
+from typing_extensions import TypedDict
+
+from langchain_core.messages.base import (
+    BaseMessage,
+    BaseMessageChunk,
+    merge_content,
+)
+from langchain_core.utils._merge import merge_dicts
+
+
+class ToolMessage(BaseMessage):
+    """Message for passing the result of executing a tool back to a model."""
+
+    tool_call_id: str
+    """Tool call that this message is responding to."""
+    # TODO: Add is_error param?
+    # is_error: bool = False
+    # """Whether the tool errored."""
+
+    type: Literal["tool"] = "tool"
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
+
+
+ToolMessage.update_forward_refs()
+
+
+class ToolMessageChunk(ToolMessage, BaseMessageChunk):
+    """Tool Message chunk."""
+
+    # Ignoring mypy re-assignment here since we're overriding the value
+    # to make sure that the chunk variant can be discriminated from the
+    # non-chunk variant.
+    type: Literal["ToolMessageChunk"] = "ToolMessageChunk"  # type: ignore[assignment]
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "messages"]
+
+    def __add__(self, other: Any) -> BaseMessageChunk:  # type: ignore
+        if isinstance(other, ToolMessageChunk):
+            if self.tool_call_id != other.tool_call_id:
+                raise ValueError(
+                    "Cannot concatenate ToolMessageChunks with different names."
+                )
+
+            return self.__class__(
+                tool_call_id=self.tool_call_id,
+                content=merge_content(self.content, other.content),
+                additional_kwargs=merge_dicts(
+                    self.additional_kwargs, other.additional_kwargs
+                ),
+                response_metadata=merge_dicts(
+                    self.response_metadata, other.response_metadata
+                ),
+                id=self.id,
+            )
+
+        return super().__add__(other)
+
+
+class ToolCall(TypedDict):
+    """Represents a request to call a tool.
+
+    Attributes:
+        name: (str) the name of the tool to be called
+        args: (dict) the arguments to the tool call
+        id: (str) if provided, an identifier associated with the tool call
+    """
+
+    name: str
+    args: Dict[str, Any]
+    id: Optional[str]
+
+
+class ToolCallChunk(TypedDict):
+    """A chunk of a tool call (e.g., as part of a stream).
+
+    When merging ToolCallChunks (e.g., via AIMessageChunk.__add__),
+    all string attributes are concatenated. Chunks are only merged if their
+    values of `index` are equal and not None.
+
+    Example:
+
+    .. code-block:: python
+
+        left_chunks = [ToolCallChunk(name="foo", args='{"a":', index=0)]
+        right_chunks = [ToolCallChunk(name=None, args='1}', index=0)]
+        (
+            AIMessageChunk(content="", tool_call_chunks=left_chunks)
+            + AIMessageChunk(content="", tool_call_chunks=right_chunks)
+        ).tool_call_chunks == [ToolCallChunk(name='foo', args='{"a":1}', index=0)]
+
+    Attributes:
+        name: (str) if provided, a substring of the name of the tool to be called
+        args: (str) if provided, a JSON substring of the arguments to the tool call
+        id: (str) if provided, a substring of an identifier for the tool call
+        index: (int) if provided, the index of the tool call in a sequence
+    """
+
+    name: Optional[str]
+    args: Optional[str]
+    id: Optional[str]
+    index: Optional[int]
+
+
+class InvalidToolCall(TypedDict):
+    """Allowance for errors made by LLM.
+
+    Here we add an `error` key to surface errors made during generation
+    (e.g., invalid JSON arguments.)
+    """
+
+    name: Optional[str]
+    args: Optional[str]
+    id: Optional[str]
+    error: Optional[str]
+
+
+def default_tool_parser(
+    raw_tool_calls: List[dict],
+) -> Tuple[List[ToolCall], List[InvalidToolCall]]:
+    """Best-effort parsing of tools."""
+    tool_calls = []
+    invalid_tool_calls = []
+    for tool_call in raw_tool_calls:
+        if "function" not in tool_call:
+            continue
+        else:
+            function_name = tool_call["function"]["name"]
+            try:
+                function_args = json.loads(tool_call["function"]["arguments"])
+                parsed = ToolCall(
+                    name=function_name or "",
+                    args=function_args or {},
+                    id=tool_call.get("id"),
+                )
+                tool_calls.append(parsed)
+            except json.JSONDecodeError:
+                invalid_tool_calls.append(
+                    InvalidToolCall(
+                        name=function_name,
+                        args=tool_call["function"]["arguments"],
+                        id=tool_call.get("id"),
+                        error="Malformed args.",
+                    )
+                )
+    return tool_calls, invalid_tool_calls
+
+
+def default_tool_chunk_parser(raw_tool_calls: List[dict]) -> List[ToolCallChunk]:
+    """Best-effort parsing of tool chunks."""
+    tool_call_chunks = []
+    for tool_call in raw_tool_calls:
+        if "function" not in tool_call:
+            function_args = None
+            function_name = None
+        else:
+            function_args = tool_call["function"]["arguments"]
+            function_name = tool_call["function"]["name"]
+        parsed = ToolCallChunk(
+            name=function_name,
+            args=function_args,
+            id=tool_call.get("id"),
+            index=tool_call.get("index"),
+        )
+        tool_call_chunks.append(parsed)
+    return tool_call_chunks
diff --git a/llm/Lib/site-packages/langchain_core/messages/utils.py b/llm/Lib/site-packages/langchain_core/messages/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..8f8957a9bafdd8185e90dde4ab53c9191416e595
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/messages/utils.py
@@ -0,0 +1,234 @@
+from typing import Any, Dict, List, Optional, Sequence, Tuple, Union
+
+from langchain_core.messages.ai import (
+    AIMessage,
+    AIMessageChunk,
+)
+from langchain_core.messages.base import (
+    BaseMessage,
+    BaseMessageChunk,
+)
+from langchain_core.messages.chat import ChatMessage, ChatMessageChunk
+from langchain_core.messages.function import FunctionMessage, FunctionMessageChunk
+from langchain_core.messages.human import HumanMessage, HumanMessageChunk
+from langchain_core.messages.system import SystemMessage, SystemMessageChunk
+from langchain_core.messages.tool import ToolMessage, ToolMessageChunk
+
+AnyMessage = Union[
+    AIMessage, HumanMessage, ChatMessage, SystemMessage, FunctionMessage, ToolMessage
+]
+
+
+def get_buffer_string(
+    messages: Sequence[BaseMessage], human_prefix: str = "Human", ai_prefix: str = "AI"
+) -> str:
+    """Convert a sequence of Messages to strings and concatenate them into one string.
+
+    Args:
+        messages: Messages to be converted to strings.
+        human_prefix: The prefix to prepend to contents of HumanMessages.
+        ai_prefix: THe prefix to prepend to contents of AIMessages.
+
+    Returns:
+        A single string concatenation of all input messages.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_core import AIMessage, HumanMessage
+
+            messages = [
+                HumanMessage(content="Hi, how are you?"),
+                AIMessage(content="Good, how are you?"),
+            ]
+            get_buffer_string(messages)
+            # -> "Human: Hi, how are you?\nAI: Good, how are you?"
+    """
+    string_messages = []
+    for m in messages:
+        if isinstance(m, HumanMessage):
+            role = human_prefix
+        elif isinstance(m, AIMessage):
+            role = ai_prefix
+        elif isinstance(m, SystemMessage):
+            role = "System"
+        elif isinstance(m, FunctionMessage):
+            role = "Function"
+        elif isinstance(m, ToolMessage):
+            role = "Tool"
+        elif isinstance(m, ChatMessage):
+            role = m.role
+        else:
+            raise ValueError(f"Got unsupported message type: {m}")
+        message = f"{role}: {m.content}"
+        if isinstance(m, AIMessage) and "function_call" in m.additional_kwargs:
+            message += f"{m.additional_kwargs['function_call']}"
+        string_messages.append(message)
+
+    return "\n".join(string_messages)
+
+
+def _message_from_dict(message: dict) -> BaseMessage:
+    _type = message["type"]
+    if _type == "human":
+        return HumanMessage(**message["data"])
+    elif _type == "ai":
+        return AIMessage(**message["data"])
+    elif _type == "system":
+        return SystemMessage(**message["data"])
+    elif _type == "chat":
+        return ChatMessage(**message["data"])
+    elif _type == "function":
+        return FunctionMessage(**message["data"])
+    elif _type == "tool":
+        return ToolMessage(**message["data"])
+    elif _type == "AIMessageChunk":
+        return AIMessageChunk(**message["data"])
+    elif _type == "HumanMessageChunk":
+        return HumanMessageChunk(**message["data"])
+    elif _type == "FunctionMessageChunk":
+        return FunctionMessageChunk(**message["data"])
+    elif _type == "ToolMessageChunk":
+        return ToolMessageChunk(**message["data"])
+    elif _type == "SystemMessageChunk":
+        return SystemMessageChunk(**message["data"])
+    elif _type == "ChatMessageChunk":
+        return ChatMessageChunk(**message["data"])
+    else:
+        raise ValueError(f"Got unexpected message type: {_type}")
+
+
+def messages_from_dict(messages: Sequence[dict]) -> List[BaseMessage]:
+    """Convert a sequence of messages from dicts to Message objects.
+
+    Args:
+        messages: Sequence of messages (as dicts) to convert.
+
+    Returns:
+        List of messages (BaseMessages).
+    """
+    return [_message_from_dict(m) for m in messages]
+
+
+def message_chunk_to_message(chunk: BaseMessageChunk) -> BaseMessage:
+    """Convert a message chunk to a message.
+
+    Args:
+        chunk: Message chunk to convert.
+
+    Returns:
+        Message.
+    """
+    if not isinstance(chunk, BaseMessageChunk):
+        return chunk
+    # chunk classes always have the equivalent non-chunk class as their first parent
+    ignore_keys = ["type"]
+    if isinstance(chunk, AIMessageChunk):
+        ignore_keys.append("tool_call_chunks")
+    return chunk.__class__.__mro__[1](
+        **{k: v for k, v in chunk.__dict__.items() if k not in ignore_keys}
+    )
+
+
+MessageLikeRepresentation = Union[BaseMessage, Tuple[str, str], str, Dict[str, Any]]
+
+
+def _create_message_from_message_type(
+    message_type: str,
+    content: str,
+    name: Optional[str] = None,
+    tool_call_id: Optional[str] = None,
+    **additional_kwargs: Any,
+) -> BaseMessage:
+    """Create a message from a message type and content string.
+
+    Args:
+        message_type: str the type of the message (e.g., "human", "ai", etc.)
+        content: str the content string.
+
+    Returns:
+        a message of the appropriate type.
+    """
+    kwargs: Dict[str, Any] = {}
+    if name is not None:
+        kwargs["name"] = name
+    if tool_call_id is not None:
+        kwargs["tool_call_id"] = tool_call_id
+    if additional_kwargs:
+        kwargs["additional_kwargs"] = additional_kwargs  # type: ignore[assignment]
+    if message_type in ("human", "user"):
+        message: BaseMessage = HumanMessage(content=content, **kwargs)
+    elif message_type in ("ai", "assistant"):
+        message = AIMessage(content=content, **kwargs)
+    elif message_type == "system":
+        message = SystemMessage(content=content, **kwargs)
+    elif message_type == "function":
+        message = FunctionMessage(content=content, **kwargs)
+    elif message_type == "tool":
+        message = ToolMessage(content=content, **kwargs)
+    else:
+        raise ValueError(
+            f"Unexpected message type: {message_type}. Use one of 'human',"
+            f" 'user', 'ai', 'assistant', or 'system'."
+        )
+    return message
+
+
+def _convert_to_message(
+    message: MessageLikeRepresentation,
+) -> BaseMessage:
+    """Instantiate a message from a variety of message formats.
+
+    The message format can be one of the following:
+
+    - BaseMessagePromptTemplate
+    - BaseMessage
+    - 2-tuple of (role string, template); e.g., ("human", "{user_input}")
+    - dict: a message dict with role and content keys
+    - string: shorthand for ("human", template); e.g., "{user_input}"
+
+    Args:
+        message: a representation of a message in one of the supported formats
+
+    Returns:
+        an instance of a message or a message template
+    """
+    if isinstance(message, BaseMessage):
+        _message = message
+    elif isinstance(message, str):
+        _message = _create_message_from_message_type("human", message)
+    elif isinstance(message, tuple):
+        if len(message) != 2:
+            raise ValueError(f"Expected 2-tuple of (role, template), got {message}")
+        message_type_str, template = message
+        _message = _create_message_from_message_type(message_type_str, template)
+    elif isinstance(message, dict):
+        msg_kwargs = message.copy()
+        try:
+            msg_type = msg_kwargs.pop("role")
+            msg_content = msg_kwargs.pop("content")
+        except KeyError:
+            raise ValueError(
+                f"Message dict must contain 'role' and 'content' keys, got {message}"
+            )
+        _message = _create_message_from_message_type(
+            msg_type, msg_content, **msg_kwargs
+        )
+    else:
+        raise NotImplementedError(f"Unsupported message type: {type(message)}")
+
+    return _message
+
+
+def convert_to_messages(
+    messages: Sequence[MessageLikeRepresentation],
+) -> List[BaseMessage]:
+    """Convert a sequence of messages to a list of messages.
+
+    Args:
+        messages: Sequence of messages to convert.
+
+    Returns:
+        List of messages (BaseMessages).
+    """
+    return [_convert_to_message(m) for m in messages]
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/__init__.py b/llm/Lib/site-packages/langchain_core/output_parsers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e896193cc15d8bbca8ccff81daf5f6f29f9b3126
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/output_parsers/__init__.py
@@ -0,0 +1,50 @@
+"""**OutputParser** classes parse the output of an LLM call.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseLLMOutputParser --> BaseOutputParser --> <name>OutputParser  # ListOutputParser, PydanticOutputParser
+
+**Main helpers:**
+
+.. code-block::
+
+    Serializable, Generation, PromptValue
+"""  # noqa: E501
+from langchain_core.output_parsers.base import (
+    BaseGenerationOutputParser,
+    BaseLLMOutputParser,
+    BaseOutputParser,
+)
+from langchain_core.output_parsers.json import JsonOutputParser, SimpleJsonOutputParser
+from langchain_core.output_parsers.list import (
+    CommaSeparatedListOutputParser,
+    ListOutputParser,
+    MarkdownListOutputParser,
+    NumberedListOutputParser,
+)
+from langchain_core.output_parsers.pydantic import PydanticOutputParser
+from langchain_core.output_parsers.string import StrOutputParser
+from langchain_core.output_parsers.transform import (
+    BaseCumulativeTransformOutputParser,
+    BaseTransformOutputParser,
+)
+from langchain_core.output_parsers.xml import XMLOutputParser
+
+__all__ = [
+    "BaseLLMOutputParser",
+    "BaseGenerationOutputParser",
+    "BaseOutputParser",
+    "ListOutputParser",
+    "CommaSeparatedListOutputParser",
+    "NumberedListOutputParser",
+    "MarkdownListOutputParser",
+    "StrOutputParser",
+    "BaseTransformOutputParser",
+    "BaseCumulativeTransformOutputParser",
+    "SimpleJsonOutputParser",
+    "XMLOutputParser",
+    "JsonOutputParser",
+    "PydanticOutputParser",
+]
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d400f7973e9809b57cf350f7362afcaf71b7ada3
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5e1d9475409c58a5d1da33511b345ffd1465501b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/format_instructions.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/format_instructions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..68ab064b6069a6f1872a07aae9cc8f5b906d7318
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/format_instructions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/json.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/json.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..34ac09b867f411f2052e5b4cc47c884045bb2359
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/json.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/list.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/list.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..90365498dbf36c3d3b7e9a6cfa1abeef29a0b60c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/list.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/openai_functions.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/openai_functions.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b6d3ba5b1bf6be01590d48cb780a82d15cf0cf44
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/openai_functions.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/openai_tools.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/openai_tools.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..24cb4a3e265622e16f832c58d9df218224465278
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/openai_tools.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/pydantic.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/pydantic.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9430c7bbd7064275e0f164b60b813cf5a61782ad
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/pydantic.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/string.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/string.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b9a3b470e5fc6f3a4f234171d3ffa9944b9629cc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/string.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/transform.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/transform.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d8a1ab59da8db62c7a2a8cb707494e908d2028a1
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/transform.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/xml.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/xml.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d660dd9a580209df2d4361bcd6e2db50dff707e4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/output_parsers/__pycache__/xml.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/base.py b/llm/Lib/site-packages/langchain_core/output_parsers/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..cad5da3b6a9c1678eb655695764d7aaf35b672e6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/output_parsers/base.py
@@ -0,0 +1,298 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    Generic,
+    List,
+    Optional,
+    Type,
+    TypeVar,
+    Union,
+)
+
+from typing_extensions import get_args
+
+from langchain_core.language_models import LanguageModelOutput
+from langchain_core.messages import AnyMessage, BaseMessage
+from langchain_core.outputs import ChatGeneration, Generation
+from langchain_core.runnables import Runnable, RunnableConfig, RunnableSerializable
+from langchain_core.runnables.config import run_in_executor
+
+if TYPE_CHECKING:
+    from langchain_core.prompt_values import PromptValue
+
+T = TypeVar("T")
+OutputParserLike = Runnable[LanguageModelOutput, T]
+
+
+class BaseLLMOutputParser(Generic[T], ABC):
+    """Abstract base class for parsing the outputs of a model."""
+
+    @abstractmethod
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> T:
+        """Parse a list of candidate model Generations into a specific format.
+
+        Args:
+            result: A list of Generations to be parsed. The Generations are assumed
+                to be different candidate outputs for a single model input.
+
+        Returns:
+            Structured output.
+        """
+
+    async def aparse_result(
+        self, result: List[Generation], *, partial: bool = False
+    ) -> T:
+        """Parse a list of candidate model Generations into a specific format.
+
+        Args:
+            result: A list of Generations to be parsed. The Generations are assumed
+                to be different candidate outputs for a single model input.
+
+        Returns:
+            Structured output.
+        """
+        return await run_in_executor(None, self.parse_result, result)
+
+
+class BaseGenerationOutputParser(
+    BaseLLMOutputParser, RunnableSerializable[LanguageModelOutput, T]
+):
+    """Base class to parse the output of an LLM call."""
+
+    @property
+    def InputType(self) -> Any:
+        return Union[str, AnyMessage]
+
+    @property
+    def OutputType(self) -> Type[T]:
+        # even though mypy complains this isn't valid,
+        # it is good enough for pydantic to build the schema from
+        return T  # type: ignore[misc]
+
+    def invoke(
+        self, input: Union[str, BaseMessage], config: Optional[RunnableConfig] = None
+    ) -> T:
+        if isinstance(input, BaseMessage):
+            return self._call_with_config(
+                lambda inner_input: self.parse_result(
+                    [ChatGeneration(message=inner_input)]
+                ),
+                input,
+                config,
+                run_type="parser",
+            )
+        else:
+            return self._call_with_config(
+                lambda inner_input: self.parse_result([Generation(text=inner_input)]),
+                input,
+                config,
+                run_type="parser",
+            )
+
+    async def ainvoke(
+        self,
+        input: Union[str, BaseMessage],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> T:
+        if isinstance(input, BaseMessage):
+            return await self._acall_with_config(
+                lambda inner_input: self.aparse_result(
+                    [ChatGeneration(message=inner_input)]
+                ),
+                input,
+                config,
+                run_type="parser",
+            )
+        else:
+            return await self._acall_with_config(
+                lambda inner_input: self.aparse_result([Generation(text=inner_input)]),
+                input,
+                config,
+                run_type="parser",
+            )
+
+
+class BaseOutputParser(
+    BaseLLMOutputParser, RunnableSerializable[LanguageModelOutput, T]
+):
+    """Base class to parse the output of an LLM call.
+
+    Output parsers help structure language model responses.
+
+    Example:
+        .. code-block:: python
+
+            class BooleanOutputParser(BaseOutputParser[bool]):
+                true_val: str = "YES"
+                false_val: str = "NO"
+
+                def parse(self, text: str) -> bool:
+                    cleaned_text = text.strip().upper()
+                    if cleaned_text not in (self.true_val.upper(), self.false_val.upper()):
+                        raise OutputParserException(
+                            f"BooleanOutputParser expected output value to either be "
+                            f"{self.true_val} or {self.false_val} (case-insensitive). "
+                            f"Received {cleaned_text}."
+                        )
+                    return cleaned_text == self.true_val.upper()
+
+                @property
+                def _type(self) -> str:
+                    return "boolean_output_parser"
+    """  # noqa: E501
+
+    @property
+    def InputType(self) -> Any:
+        return Union[str, AnyMessage]
+
+    @property
+    def OutputType(self) -> Type[T]:
+        for cls in self.__class__.__orig_bases__:  # type: ignore[attr-defined]
+            type_args = get_args(cls)
+            if type_args and len(type_args) == 1:
+                return type_args[0]
+
+        raise TypeError(
+            f"Runnable {self.__class__.__name__} doesn't have an inferable OutputType. "
+            "Override the OutputType property to specify the output type."
+        )
+
+    def invoke(
+        self, input: Union[str, BaseMessage], config: Optional[RunnableConfig] = None
+    ) -> T:
+        if isinstance(input, BaseMessage):
+            return self._call_with_config(
+                lambda inner_input: self.parse_result(
+                    [ChatGeneration(message=inner_input)]
+                ),
+                input,
+                config,
+                run_type="parser",
+            )
+        else:
+            return self._call_with_config(
+                lambda inner_input: self.parse_result([Generation(text=inner_input)]),
+                input,
+                config,
+                run_type="parser",
+            )
+
+    async def ainvoke(
+        self,
+        input: Union[str, BaseMessage],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> T:
+        if isinstance(input, BaseMessage):
+            return await self._acall_with_config(
+                lambda inner_input: self.aparse_result(
+                    [ChatGeneration(message=inner_input)]
+                ),
+                input,
+                config,
+                run_type="parser",
+            )
+        else:
+            return await self._acall_with_config(
+                lambda inner_input: self.aparse_result([Generation(text=inner_input)]),
+                input,
+                config,
+                run_type="parser",
+            )
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> T:
+        """Parse a list of candidate model Generations into a specific format.
+
+        The return value is parsed from only the first Generation in the result, which
+            is assumed to be the highest-likelihood Generation.
+
+        Args:
+            result: A list of Generations to be parsed. The Generations are assumed
+                to be different candidate outputs for a single model input.
+
+        Returns:
+            Structured output.
+        """
+        return self.parse(result[0].text)
+
+    @abstractmethod
+    def parse(self, text: str) -> T:
+        """Parse a single string model output into some structure.
+
+        Args:
+            text: String output of a language model.
+
+        Returns:
+            Structured output.
+        """
+
+    async def aparse_result(
+        self, result: List[Generation], *, partial: bool = False
+    ) -> T:
+        """Parse a list of candidate model Generations into a specific format.
+
+        The return value is parsed from only the first Generation in the result, which
+            is assumed to be the highest-likelihood Generation.
+
+        Args:
+            result: A list of Generations to be parsed. The Generations are assumed
+                to be different candidate outputs for a single model input.
+
+        Returns:
+            Structured output.
+        """
+        return await run_in_executor(None, self.parse_result, result, partial=partial)
+
+    async def aparse(self, text: str) -> T:
+        """Parse a single string model output into some structure.
+
+        Args:
+            text: String output of a language model.
+
+        Returns:
+            Structured output.
+        """
+        return await run_in_executor(None, self.parse, text)
+
+    # TODO: rename 'completion' -> 'text'.
+    def parse_with_prompt(self, completion: str, prompt: PromptValue) -> Any:
+        """Parse the output of an LLM call with the input prompt for context.
+
+        The prompt is largely provided in the event the OutputParser wants
+        to retry or fix the output in some way, and needs information from
+        the prompt to do so.
+
+        Args:
+            completion: String output of a language model.
+            prompt: Input PromptValue.
+
+        Returns:
+            Structured output
+        """
+        return self.parse(completion)
+
+    def get_format_instructions(self) -> str:
+        """Instructions on how the LLM output should be formatted."""
+        raise NotImplementedError
+
+    @property
+    def _type(self) -> str:
+        """Return the output parser type for serialization."""
+        raise NotImplementedError(
+            f"_type property is not implemented in class {self.__class__.__name__}."
+            " This is required for serialization."
+        )
+
+    def dict(self, **kwargs: Any) -> Dict:
+        """Return dictionary representation of output parser."""
+        output_parser_dict = super().dict(**kwargs)
+        try:
+            output_parser_dict["_type"] = self._type
+        except NotImplementedError:
+            pass
+        return output_parser_dict
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/format_instructions.py b/llm/Lib/site-packages/langchain_core/output_parsers/format_instructions.py
new file mode 100644
index 0000000000000000000000000000000000000000..400756e8663d9ef9126c096312f8b791ed10c760
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/output_parsers/format_instructions.py
@@ -0,0 +1,11 @@
+# flake8: noqa
+
+JSON_FORMAT_INSTRUCTIONS = """The output should be formatted as a JSON instance that conforms to the JSON schema below.
+
+As an example, for the schema {{"properties": {{"foo": {{"title": "Foo", "description": "a list of strings", "type": "array", "items": {{"type": "string"}}}}}}, "required": ["foo"]}}
+the object {{"foo": ["bar", "baz"]}} is a well-formatted instance of the schema. The object {{"properties": {{"foo": ["bar", "baz"]}}}} is not well-formatted.
+
+Here is the output schema:
+```
+{schema}
+```"""
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/json.py b/llm/Lib/site-packages/langchain_core/output_parsers/json.py
new file mode 100644
index 0000000000000000000000000000000000000000..9652fde424e0b46187ce596e59f376de7a2f53e6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/output_parsers/json.py
@@ -0,0 +1,99 @@
+from __future__ import annotations
+
+import json
+from json import JSONDecodeError
+from typing import Any, List, Optional, Type, TypeVar, Union
+
+import jsonpatch  # type: ignore[import]
+import pydantic  # pydantic: ignore
+
+from langchain_core.exceptions import OutputParserException
+from langchain_core.output_parsers.format_instructions import JSON_FORMAT_INSTRUCTIONS
+from langchain_core.output_parsers.transform import BaseCumulativeTransformOutputParser
+from langchain_core.outputs import Generation
+from langchain_core.utils.json import (
+    parse_and_check_json_markdown,
+    parse_json_markdown,
+    parse_partial_json,
+)
+from langchain_core.utils.pydantic import PYDANTIC_MAJOR_VERSION
+
+if PYDANTIC_MAJOR_VERSION < 2:
+    PydanticBaseModel = pydantic.BaseModel
+
+else:
+    from pydantic.v1 import BaseModel  # pydantic: ignore
+
+    # Union type needs to be last assignment to PydanticBaseModel to make mypy happy.
+    PydanticBaseModel = Union[BaseModel, pydantic.BaseModel]  # type: ignore
+
+TBaseModel = TypeVar("TBaseModel", bound=PydanticBaseModel)
+
+
+class JsonOutputParser(BaseCumulativeTransformOutputParser[Any]):
+    """Parse the output of an LLM call to a JSON object.
+
+    When used in streaming mode, it will yield partial JSON objects containing
+    all the keys that have been returned so far.
+
+    In streaming, if `diff` is set to `True`, yields JSONPatch operations
+    describing the difference between the previous and the current object.
+    """
+
+    pydantic_object: Optional[Type[TBaseModel]] = None  # type: ignore
+
+    def _diff(self, prev: Optional[Any], next: Any) -> Any:
+        return jsonpatch.make_patch(prev, next).patch
+
+    def _get_schema(self, pydantic_object: Type[TBaseModel]) -> dict[str, Any]:
+        if PYDANTIC_MAJOR_VERSION == 2:
+            if issubclass(pydantic_object, pydantic.BaseModel):
+                return pydantic_object.model_json_schema()
+            elif issubclass(pydantic_object, pydantic.v1.BaseModel):
+                return pydantic_object.schema()
+        return pydantic_object.schema()
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        text = result[0].text
+        text = text.strip()
+        if partial:
+            try:
+                return parse_json_markdown(text)
+            except JSONDecodeError:
+                return None
+        else:
+            try:
+                return parse_json_markdown(text)
+            except JSONDecodeError as e:
+                msg = f"Invalid json output: {text}"
+                raise OutputParserException(msg, llm_output=text) from e
+
+    def parse(self, text: str) -> Any:
+        return self.parse_result([Generation(text=text)])
+
+    def get_format_instructions(self) -> str:
+        if self.pydantic_object is None:
+            return "Return a JSON object."
+        else:
+            # Copy schema to avoid altering original Pydantic schema.
+            schema = {k: v for k, v in self._get_schema(self.pydantic_object).items()}
+
+            # Remove extraneous fields.
+            reduced_schema = schema
+            if "title" in reduced_schema:
+                del reduced_schema["title"]
+            if "type" in reduced_schema:
+                del reduced_schema["type"]
+            # Ensure json in context is well-formed with double quotes.
+            schema_str = json.dumps(reduced_schema)
+            return JSON_FORMAT_INSTRUCTIONS.format(schema=schema_str)
+
+    @property
+    def _type(self) -> str:
+        return "simple_json_output_parser"
+
+
+# For backwards compatibility
+SimpleJsonOutputParser = JsonOutputParser
+parse_partial_json = parse_partial_json
+parse_and_check_json_markdown = parse_and_check_json_markdown
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/list.py b/llm/Lib/site-packages/langchain_core/output_parsers/list.py
new file mode 100644
index 0000000000000000000000000000000000000000..36b9f7e9b776bd24f918e668539a55968fd8be7f
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/output_parsers/list.py
@@ -0,0 +1,172 @@
+from __future__ import annotations
+
+import re
+from abc import abstractmethod
+from collections import deque
+from typing import AsyncIterator, Deque, Iterator, List, TypeVar, Union
+
+from langchain_core.messages import BaseMessage
+from langchain_core.output_parsers.transform import BaseTransformOutputParser
+
+T = TypeVar("T")
+
+
+def droplastn(iter: Iterator[T], n: int) -> Iterator[T]:
+    """Drop the last n elements of an iterator."""
+    buffer: Deque[T] = deque()
+    for item in iter:
+        buffer.append(item)
+        if len(buffer) > n:
+            yield buffer.popleft()
+
+
+class ListOutputParser(BaseTransformOutputParser[List[str]]):
+    """Parse the output of an LLM call to a list."""
+
+    @property
+    def _type(self) -> str:
+        return "list"
+
+    @abstractmethod
+    def parse(self, text: str) -> List[str]:
+        """Parse the output of an LLM call."""
+
+    def parse_iter(self, text: str) -> Iterator[re.Match]:
+        """Parse the output of an LLM call."""
+        raise NotImplementedError
+
+    def _transform(
+        self, input: Iterator[Union[str, BaseMessage]]
+    ) -> Iterator[List[str]]:
+        buffer = ""
+        for chunk in input:
+            if isinstance(chunk, BaseMessage):
+                # extract text
+                chunk_content = chunk.content
+                if not isinstance(chunk_content, str):
+                    continue
+                chunk = chunk_content
+            # add current chunk to buffer
+            buffer += chunk
+            # parse buffer into a list of parts
+            try:
+                done_idx = 0
+                # yield only complete parts
+                for m in droplastn(self.parse_iter(buffer), 1):
+                    done_idx = m.end()
+                    yield [m.group(1)]
+                buffer = buffer[done_idx:]
+            except NotImplementedError:
+                parts = self.parse(buffer)
+                # yield only complete parts
+                if len(parts) > 1:
+                    for part in parts[:-1]:
+                        yield [part]
+                    buffer = parts[-1]
+        # yield the last part
+        for part in self.parse(buffer):
+            yield [part]
+
+    async def _atransform(
+        self, input: AsyncIterator[Union[str, BaseMessage]]
+    ) -> AsyncIterator[List[str]]:
+        buffer = ""
+        async for chunk in input:
+            if isinstance(chunk, BaseMessage):
+                # extract text
+                chunk_content = chunk.content
+                if not isinstance(chunk_content, str):
+                    continue
+                chunk = chunk_content
+            # add current chunk to buffer
+            buffer += chunk
+            # parse buffer into a list of parts
+            try:
+                done_idx = 0
+                # yield only complete parts
+                for m in droplastn(self.parse_iter(buffer), 1):
+                    done_idx = m.end()
+                    yield [m.group(1)]
+                buffer = buffer[done_idx:]
+            except NotImplementedError:
+                parts = self.parse(buffer)
+                # yield only complete parts
+                if len(parts) > 1:
+                    for part in parts[:-1]:
+                        yield [part]
+                    buffer = parts[-1]
+        # yield the last part
+        for part in self.parse(buffer):
+            yield [part]
+
+
+class CommaSeparatedListOutputParser(ListOutputParser):
+    """Parse the output of an LLM call to a comma-separated list."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "output_parsers", "list"]
+
+    def get_format_instructions(self) -> str:
+        return (
+            "Your response should be a list of comma separated values, "
+            "eg: `foo, bar, baz`"
+        )
+
+    def parse(self, text: str) -> List[str]:
+        """Parse the output of an LLM call."""
+        return text.strip().split(", ")
+
+    @property
+    def _type(self) -> str:
+        return "comma-separated-list"
+
+
+class NumberedListOutputParser(ListOutputParser):
+    """Parse a numbered list."""
+
+    pattern = r"\d+\.\s([^\n]+)"
+
+    def get_format_instructions(self) -> str:
+        return (
+            "Your response should be a numbered list with each item on a new line. "
+            "For example: \n\n1. foo\n\n2. bar\n\n3. baz"
+        )
+
+    def parse(self, text: str) -> List[str]:
+        """Parse the output of an LLM call."""
+        return re.findall(self.pattern, text)
+
+    def parse_iter(self, text: str) -> Iterator[re.Match]:
+        """Parse the output of an LLM call."""
+        return re.finditer(self.pattern, text)
+
+    @property
+    def _type(self) -> str:
+        return "numbered-list"
+
+
+class MarkdownListOutputParser(ListOutputParser):
+    """Parse a markdown list."""
+
+    pattern = r"^\s*[-*]\s([^\n]+)$"
+
+    def get_format_instructions(self) -> str:
+        return "Your response should be a markdown list, " "eg: `- foo\n- bar\n- baz`"
+
+    def parse(self, text: str) -> List[str]:
+        """Parse the output of an LLM call."""
+        return re.findall(self.pattern, text, re.MULTILINE)
+
+    def parse_iter(self, text: str) -> Iterator[re.Match]:
+        """Parse the output of an LLM call."""
+        return re.finditer(self.pattern, text, re.MULTILINE)
+
+    @property
+    def _type(self) -> str:
+        return "markdown-list"
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/openai_functions.py b/llm/Lib/site-packages/langchain_core/output_parsers/openai_functions.py
new file mode 100644
index 0000000000000000000000000000000000000000..721ab180bac10ffbde46489e533f8302d12c8ba6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/output_parsers/openai_functions.py
@@ -0,0 +1,220 @@
+import copy
+import json
+from typing import Any, Dict, List, Optional, Type, Union
+
+import jsonpatch  # type: ignore[import]
+
+from langchain_core.exceptions import OutputParserException
+from langchain_core.output_parsers import (
+    BaseCumulativeTransformOutputParser,
+    BaseGenerationOutputParser,
+)
+from langchain_core.output_parsers.json import parse_partial_json
+from langchain_core.outputs import ChatGeneration, Generation
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+
+
+class OutputFunctionsParser(BaseGenerationOutputParser[Any]):
+    """Parse an output that is one of sets of values."""
+
+    args_only: bool = True
+    """Whether to only return the arguments to the function call."""
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        generation = result[0]
+        if not isinstance(generation, ChatGeneration):
+            raise OutputParserException(
+                "This output parser can only be used with a chat generation."
+            )
+        message = generation.message
+        try:
+            func_call = copy.deepcopy(message.additional_kwargs["function_call"])
+        except KeyError as exc:
+            raise OutputParserException(f"Could not parse function call: {exc}")
+
+        if self.args_only:
+            return func_call["arguments"]
+        return func_call
+
+
+class JsonOutputFunctionsParser(BaseCumulativeTransformOutputParser[Any]):
+    """Parse an output as the Json object."""
+
+    strict: bool = False
+    """Whether to allow non-JSON-compliant strings.
+    
+    See: https://docs.python.org/3/library/json.html#encoders-and-decoders
+    
+    Useful when the parsed output may include unicode characters or new lines.
+    """
+
+    args_only: bool = True
+    """Whether to only return the arguments to the function call."""
+
+    @property
+    def _type(self) -> str:
+        return "json_functions"
+
+    def _diff(self, prev: Optional[Any], next: Any) -> Any:
+        return jsonpatch.make_patch(prev, next).patch
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        if len(result) != 1:
+            raise OutputParserException(
+                f"Expected exactly one result, but got {len(result)}"
+            )
+        generation = result[0]
+        if not isinstance(generation, ChatGeneration):
+            raise OutputParserException(
+                "This output parser can only be used with a chat generation."
+            )
+        message = generation.message
+        try:
+            function_call = message.additional_kwargs["function_call"]
+        except KeyError as exc:
+            if partial:
+                return None
+            else:
+                raise OutputParserException(f"Could not parse function call: {exc}")
+        try:
+            if partial:
+                try:
+                    if self.args_only:
+                        return parse_partial_json(
+                            function_call["arguments"], strict=self.strict
+                        )
+                    else:
+                        return {
+                            **function_call,
+                            "arguments": parse_partial_json(
+                                function_call["arguments"], strict=self.strict
+                            ),
+                        }
+                except json.JSONDecodeError:
+                    return None
+            else:
+                if self.args_only:
+                    try:
+                        return json.loads(
+                            function_call["arguments"], strict=self.strict
+                        )
+                    except (json.JSONDecodeError, TypeError) as exc:
+                        raise OutputParserException(
+                            f"Could not parse function call data: {exc}"
+                        )
+                else:
+                    try:
+                        return {
+                            **function_call,
+                            "arguments": json.loads(
+                                function_call["arguments"], strict=self.strict
+                            ),
+                        }
+                    except (json.JSONDecodeError, TypeError) as exc:
+                        raise OutputParserException(
+                            f"Could not parse function call data: {exc}"
+                        )
+        except KeyError:
+            return None
+
+    # This method would be called by the default implementation of `parse_result`
+    # but we're overriding that method so it's not needed.
+    def parse(self, text: str) -> Any:
+        raise NotImplementedError()
+
+
+class JsonKeyOutputFunctionsParser(JsonOutputFunctionsParser):
+    """Parse an output as the element of the Json object."""
+
+    key_name: str
+    """The name of the key to return."""
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        res = super().parse_result(result, partial=partial)
+        if partial and res is None:
+            return None
+        return res.get(self.key_name) if partial else res[self.key_name]
+
+
+class PydanticOutputFunctionsParser(OutputFunctionsParser):
+    """Parse an output as a pydantic object.
+
+    This parser is used to parse the output of a ChatModel that uses
+    OpenAI function format to invoke functions.
+
+    The parser extracts the function call invocation and matches
+    them to the pydantic schema provided.
+
+    An exception will be raised if the function call does not match
+    the provided schema.
+
+    Example:
+
+        ... code-block:: python
+
+            message = AIMessage(
+                content="This is a test message",
+                additional_kwargs={
+                    "function_call": {
+                        "name": "cookie",
+                        "arguments": json.dumps({"name": "value", "age": 10}),
+                    }
+                },
+            )
+            chat_generation = ChatGeneration(message=message)
+
+            class Cookie(BaseModel):
+                name: str
+                age: int
+
+            class Dog(BaseModel):
+                species: str
+
+            # Full output
+            parser = PydanticOutputFunctionsParser(
+                pydantic_schema={"cookie": Cookie, "dog": Dog}
+            )
+            result = parser.parse_result([chat_generation])
+    """
+
+    pydantic_schema: Union[Type[BaseModel], Dict[str, Type[BaseModel]]]
+    """The pydantic schema to parse the output with.
+    
+    If multiple schemas are provided, then the function name will be used to
+    determine which schema to use.
+    """
+
+    @root_validator(pre=True)
+    def validate_schema(cls, values: Dict) -> Dict:
+        schema = values["pydantic_schema"]
+        if "args_only" not in values:
+            values["args_only"] = isinstance(schema, type) and issubclass(
+                schema, BaseModel
+            )
+        elif values["args_only"] and isinstance(schema, Dict):
+            raise ValueError(
+                "If multiple pydantic schemas are provided then args_only should be"
+                " False."
+            )
+        return values
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        _result = super().parse_result(result)
+        if self.args_only:
+            pydantic_args = self.pydantic_schema.parse_raw(_result)  # type: ignore
+        else:
+            fn_name = _result["name"]
+            _args = _result["arguments"]
+            pydantic_args = self.pydantic_schema[fn_name].parse_raw(_args)  # type: ignore  # noqa: E501
+        return pydantic_args
+
+
+class PydanticAttrOutputFunctionsParser(PydanticOutputFunctionsParser):
+    """Parse an output as an attribute of a pydantic object."""
+
+    attr_name: str
+    """The name of the attribute to return."""
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        result = super().parse_result(result)
+        return getattr(result, self.attr_name)
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/openai_tools.py b/llm/Lib/site-packages/langchain_core/output_parsers/openai_tools.py
new file mode 100644
index 0000000000000000000000000000000000000000..f79bac5e28369ed372775e5510aca7c810ab9dd8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/output_parsers/openai_tools.py
@@ -0,0 +1,205 @@
+import copy
+import json
+from json import JSONDecodeError
+from typing import Any, Dict, List, Optional, Type
+
+from langchain_core.exceptions import OutputParserException
+from langchain_core.messages import AIMessage, InvalidToolCall
+from langchain_core.output_parsers import BaseCumulativeTransformOutputParser
+from langchain_core.outputs import ChatGeneration, Generation
+from langchain_core.pydantic_v1 import BaseModel, ValidationError
+from langchain_core.utils.json import parse_partial_json
+
+
+def parse_tool_call(
+    raw_tool_call: Dict[str, Any],
+    *,
+    partial: bool = False,
+    strict: bool = False,
+    return_id: bool = True,
+) -> Optional[Dict[str, Any]]:
+    """Parse a single tool call."""
+    if "function" not in raw_tool_call:
+        return None
+    if partial:
+        try:
+            function_args = parse_partial_json(
+                raw_tool_call["function"]["arguments"], strict=strict
+            )
+        except (JSONDecodeError, TypeError):  # None args raise TypeError
+            return None
+    else:
+        try:
+            function_args = json.loads(
+                raw_tool_call["function"]["arguments"], strict=strict
+            )
+        except JSONDecodeError as e:
+            raise OutputParserException(
+                f"Function {raw_tool_call['function']['name']} arguments:\n\n"
+                f"{raw_tool_call['function']['arguments']}\n\nare not valid JSON. "
+                f"Received JSONDecodeError {e}"
+            )
+    parsed = {
+        "name": raw_tool_call["function"]["name"] or "",
+        "args": function_args or {},
+    }
+    if return_id:
+        parsed["id"] = raw_tool_call.get("id")
+    return parsed
+
+
+def make_invalid_tool_call(
+    raw_tool_call: Dict[str, Any],
+    error_msg: Optional[str],
+) -> InvalidToolCall:
+    """Create an InvalidToolCall from a raw tool call."""
+    return InvalidToolCall(
+        name=raw_tool_call["function"]["name"],
+        args=raw_tool_call["function"]["arguments"],
+        id=raw_tool_call.get("id"),
+        error=error_msg,
+    )
+
+
+def parse_tool_calls(
+    raw_tool_calls: List[dict],
+    *,
+    partial: bool = False,
+    strict: bool = False,
+    return_id: bool = True,
+) -> List[Dict[str, Any]]:
+    """Parse a list of tool calls."""
+    final_tools: List[Dict[str, Any]] = []
+    exceptions = []
+    for tool_call in raw_tool_calls:
+        try:
+            parsed = parse_tool_call(
+                tool_call, partial=partial, strict=strict, return_id=return_id
+            )
+            if parsed:
+                final_tools.append(parsed)
+        except OutputParserException as e:
+            exceptions.append(str(e))
+            continue
+    if exceptions:
+        raise OutputParserException("\n\n".join(exceptions))
+    return final_tools
+
+
+class JsonOutputToolsParser(BaseCumulativeTransformOutputParser[Any]):
+    """Parse tools from OpenAI response."""
+
+    strict: bool = False
+    """Whether to allow non-JSON-compliant strings.
+
+    See: https://docs.python.org/3/library/json.html#encoders-and-decoders
+
+    Useful when the parsed output may include unicode characters or new lines.
+    """
+    return_id: bool = False
+    """Whether to return the tool call id."""
+    first_tool_only: bool = False
+    """Whether to return only the first tool call.
+
+    If False, the result will be a list of tool calls, or an empty list 
+    if no tool calls are found.
+
+    If true, and multiple tool calls are found, only the first one will be returned,
+    and the other tool calls will be ignored. 
+    If no tool calls are found, None will be returned. 
+    """
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        generation = result[0]
+        if not isinstance(generation, ChatGeneration):
+            raise OutputParserException(
+                "This output parser can only be used with a chat generation."
+            )
+        message = generation.message
+        if isinstance(message, AIMessage) and message.tool_calls:
+            tool_calls = [dict(tc) for tc in message.tool_calls]
+            for tool_call in tool_calls:
+                if not self.return_id:
+                    _ = tool_call.pop("id")
+        else:
+            try:
+                raw_tool_calls = copy.deepcopy(message.additional_kwargs["tool_calls"])
+            except KeyError:
+                return []
+            tool_calls = parse_tool_calls(
+                raw_tool_calls,
+                partial=partial,
+                strict=self.strict,
+                return_id=self.return_id,
+            )
+        # for backwards compatibility
+        for tc in tool_calls:
+            tc["type"] = tc.pop("name")
+
+        if self.first_tool_only:
+            return tool_calls[0] if tool_calls else None
+        return tool_calls
+
+    def parse(self, text: str) -> Any:
+        raise NotImplementedError()
+
+
+class JsonOutputKeyToolsParser(JsonOutputToolsParser):
+    """Parse tools from OpenAI response."""
+
+    key_name: str
+    """The type of tools to return."""
+
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        parsed_result = super().parse_result(result, partial=partial)
+
+        if self.first_tool_only:
+            single_result = (
+                parsed_result
+                if parsed_result and parsed_result["type"] == self.key_name
+                else None
+            )
+            if self.return_id:
+                return single_result
+            elif single_result:
+                return single_result["args"]
+            else:
+                return None
+        parsed_result = [res for res in parsed_result if res["type"] == self.key_name]
+        if not self.return_id:
+            parsed_result = [res["args"] for res in parsed_result]
+        return parsed_result
+
+
+class PydanticToolsParser(JsonOutputToolsParser):
+    """Parse tools from OpenAI response."""
+
+    tools: List[Type[BaseModel]]
+
+    # TODO: Support more granular streaming of objects. Currently only streams once all
+    # Pydantic object fields are present.
+    def parse_result(self, result: List[Generation], *, partial: bool = False) -> Any:
+        json_results = super().parse_result(result, partial=partial)
+        if not json_results:
+            return None if self.first_tool_only else []
+
+        json_results = [json_results] if self.first_tool_only else json_results
+        name_dict = {tool.__name__: tool for tool in self.tools}
+        pydantic_objects = []
+        for res in json_results:
+            try:
+                if not isinstance(res["args"], dict):
+                    raise ValueError(
+                        f"Tool arguments must be specified as a dict, received: "
+                        f"{res['args']}"
+                    )
+                pydantic_objects.append(name_dict[res["type"]](**res["args"]))
+            except (ValidationError, ValueError) as e:
+                if partial:
+                    continue
+                else:
+                    raise e
+        if self.first_tool_only:
+            return pydantic_objects[0] if pydantic_objects else None
+        else:
+            return pydantic_objects
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/pydantic.py b/llm/Lib/site-packages/langchain_core/output_parsers/pydantic.py
new file mode 100644
index 0000000000000000000000000000000000000000..73444d45af283ce693bac795638a531e5a1adfcd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/output_parsers/pydantic.py
@@ -0,0 +1,99 @@
+import json
+from typing import Generic, List, Type, TypeVar, Union
+
+import pydantic  # pydantic: ignore
+
+from langchain_core.exceptions import OutputParserException
+from langchain_core.output_parsers import JsonOutputParser
+from langchain_core.outputs import Generation
+from langchain_core.utils.pydantic import PYDANTIC_MAJOR_VERSION
+
+if PYDANTIC_MAJOR_VERSION < 2:
+    PydanticBaseModel = pydantic.BaseModel
+
+else:
+    from pydantic.v1 import BaseModel  # pydantic: ignore
+
+    # Union type needs to be last assignment to PydanticBaseModel to make mypy happy.
+    PydanticBaseModel = Union[BaseModel, pydantic.BaseModel]  # type: ignore
+
+TBaseModel = TypeVar("TBaseModel", bound=PydanticBaseModel)
+
+
+class PydanticOutputParser(JsonOutputParser, Generic[TBaseModel]):
+    """Parse an output using a pydantic model."""
+
+    pydantic_object: Type[TBaseModel]  # type: ignore
+    """The pydantic model to parse."""
+
+    def _parse_obj(self, obj: dict) -> TBaseModel:
+        if PYDANTIC_MAJOR_VERSION == 2:
+            try:
+                if issubclass(self.pydantic_object, pydantic.BaseModel):
+                    return self.pydantic_object.model_validate(obj)
+                elif issubclass(self.pydantic_object, pydantic.v1.BaseModel):
+                    return self.pydantic_object.parse_obj(obj)
+                else:
+                    raise OutputParserException(
+                        f"Unsupported model version for PydanticOutputParser: \
+                            {self.pydantic_object.__class__}"
+                    )
+            except (pydantic.ValidationError, pydantic.v1.ValidationError) as e:
+                raise self._parser_exception(e, obj)
+        else:  # pydantic v1
+            try:
+                return self.pydantic_object.parse_obj(obj)
+            except pydantic.ValidationError as e:
+                raise self._parser_exception(e, obj)
+
+    def _parser_exception(
+        self, e: Exception, json_object: dict
+    ) -> OutputParserException:
+        json_string = json.dumps(json_object)
+        name = self.pydantic_object.__name__
+        msg = f"Failed to parse {name} from completion {json_string}. Got: {e}"
+        return OutputParserException(msg, llm_output=json_string)
+
+    def parse_result(
+        self, result: List[Generation], *, partial: bool = False
+    ) -> TBaseModel:
+        json_object = super().parse_result(result)
+        return self._parse_obj(json_object)
+
+    def parse(self, text: str) -> TBaseModel:
+        return super().parse(text)
+
+    def get_format_instructions(self) -> str:
+        # Copy schema to avoid altering original Pydantic schema.
+        schema = {k: v for k, v in self.pydantic_object.schema().items()}
+
+        # Remove extraneous fields.
+        reduced_schema = schema
+        if "title" in reduced_schema:
+            del reduced_schema["title"]
+        if "type" in reduced_schema:
+            del reduced_schema["type"]
+        # Ensure json in context is well-formed with double quotes.
+        schema_str = json.dumps(reduced_schema)
+
+        return _PYDANTIC_FORMAT_INSTRUCTIONS.format(schema=schema_str)
+
+    @property
+    def _type(self) -> str:
+        return "pydantic"
+
+    @property
+    def OutputType(self) -> Type[TBaseModel]:
+        """Return the pydantic model."""
+        return self.pydantic_object
+
+
+_PYDANTIC_FORMAT_INSTRUCTIONS = """The output should be formatted as a JSON instance that conforms to the JSON schema below.
+
+As an example, for the schema {{"properties": {{"foo": {{"title": "Foo", "description": "a list of strings", "type": "array", "items": {{"type": "string"}}}}}}, "required": ["foo"]}}
+the object {{"foo": ["bar", "baz"]}} is a well-formatted instance of the schema. The object {{"properties": {{"foo": ["bar", "baz"]}}}} is not well-formatted.
+
+Here is the output schema:
+```
+{schema}
+```"""  # noqa: E501
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/string.py b/llm/Lib/site-packages/langchain_core/output_parsers/string.py
new file mode 100644
index 0000000000000000000000000000000000000000..12350bf0d84bbfbfcae33d8741a777b4ed5271ed
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/output_parsers/string.py
@@ -0,0 +1,26 @@
+from typing import List
+
+from langchain_core.output_parsers.transform import BaseTransformOutputParser
+
+
+class StrOutputParser(BaseTransformOutputParser[str]):
+    """OutputParser that parses LLMResult into the top likely string."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this class is serializable."""
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "output_parser"]
+
+    @property
+    def _type(self) -> str:
+        """Return the output parser type for serialization."""
+        return "default"
+
+    def parse(self, text: str) -> str:
+        """Returns the input text with no changes."""
+        return text
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/transform.py b/llm/Lib/site-packages/langchain_core/output_parsers/transform.py
new file mode 100644
index 0000000000000000000000000000000000000000..96688174d4ae665b9a862c52598a5bc7f2eaacce
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/output_parsers/transform.py
@@ -0,0 +1,131 @@
+from __future__ import annotations
+
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Iterator,
+    Optional,
+    Union,
+)
+
+from langchain_core.messages import BaseMessage, BaseMessageChunk
+from langchain_core.output_parsers.base import BaseOutputParser, T
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatGenerationChunk,
+    Generation,
+    GenerationChunk,
+)
+
+if TYPE_CHECKING:
+    from langchain_core.runnables import RunnableConfig
+
+
+class BaseTransformOutputParser(BaseOutputParser[T]):
+    """Base class for an output parser that can handle streaming input."""
+
+    def _transform(self, input: Iterator[Union[str, BaseMessage]]) -> Iterator[T]:
+        for chunk in input:
+            if isinstance(chunk, BaseMessage):
+                yield self.parse_result([ChatGeneration(message=chunk)])
+            else:
+                yield self.parse_result([Generation(text=chunk)])
+
+    async def _atransform(
+        self, input: AsyncIterator[Union[str, BaseMessage]]
+    ) -> AsyncIterator[T]:
+        async for chunk in input:
+            if isinstance(chunk, BaseMessage):
+                yield self.parse_result([ChatGeneration(message=chunk)])
+            else:
+                yield self.parse_result([Generation(text=chunk)])
+
+    def transform(
+        self,
+        input: Iterator[Union[str, BaseMessage]],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Iterator[T]:
+        yield from self._transform_stream_with_config(
+            input, self._transform, config, run_type="parser"
+        )
+
+    async def atransform(
+        self,
+        input: AsyncIterator[Union[str, BaseMessage]],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[T]:
+        async for chunk in self._atransform_stream_with_config(
+            input, self._atransform, config, run_type="parser"
+        ):
+            yield chunk
+
+
+class BaseCumulativeTransformOutputParser(BaseTransformOutputParser[T]):
+    """Base class for an output parser that can handle streaming input."""
+
+    diff: bool = False
+    """In streaming mode, whether to yield diffs between the previous and current
+    parsed output, or just the current parsed output.
+    """
+
+    def _diff(self, prev: Optional[T], next: T) -> T:
+        """Convert parsed outputs into a diff format. The semantics of this are
+        up to the output parser."""
+        raise NotImplementedError()
+
+    def _transform(self, input: Iterator[Union[str, BaseMessage]]) -> Iterator[Any]:
+        prev_parsed = None
+        acc_gen = None
+        for chunk in input:
+            if isinstance(chunk, BaseMessageChunk):
+                chunk_gen: Generation = ChatGenerationChunk(message=chunk)
+            elif isinstance(chunk, BaseMessage):
+                chunk_gen = ChatGenerationChunk(
+                    message=BaseMessageChunk(**chunk.dict())
+                )
+            else:
+                chunk_gen = GenerationChunk(text=chunk)
+
+            if acc_gen is None:
+                acc_gen = chunk_gen
+            else:
+                acc_gen = acc_gen + chunk_gen
+
+            parsed = self.parse_result([acc_gen], partial=True)
+            if parsed is not None and parsed != prev_parsed:
+                if self.diff:
+                    yield self._diff(prev_parsed, parsed)
+                else:
+                    yield parsed
+                prev_parsed = parsed
+
+    async def _atransform(
+        self, input: AsyncIterator[Union[str, BaseMessage]]
+    ) -> AsyncIterator[T]:
+        prev_parsed = None
+        acc_gen = None
+        async for chunk in input:
+            if isinstance(chunk, BaseMessageChunk):
+                chunk_gen: Generation = ChatGenerationChunk(message=chunk)
+            elif isinstance(chunk, BaseMessage):
+                chunk_gen = ChatGenerationChunk(
+                    message=BaseMessageChunk(**chunk.dict())
+                )
+            else:
+                chunk_gen = GenerationChunk(text=chunk)
+
+            if acc_gen is None:
+                acc_gen = chunk_gen
+            else:
+                acc_gen = acc_gen + chunk_gen
+
+            parsed = await self.aparse_result([acc_gen], partial=True)
+            if parsed is not None and parsed != prev_parsed:
+                if self.diff:
+                    yield self._diff(prev_parsed, parsed)
+                else:
+                    yield parsed
+                prev_parsed = parsed
diff --git a/llm/Lib/site-packages/langchain_core/output_parsers/xml.py b/llm/Lib/site-packages/langchain_core/output_parsers/xml.py
new file mode 100644
index 0000000000000000000000000000000000000000..890a4d7c7179a1ec7b2bc8abd957be8e2b1c4da6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/output_parsers/xml.py
@@ -0,0 +1,234 @@
+import re
+import xml
+import xml.etree.ElementTree as ET
+from typing import Any, AsyncIterator, Dict, Iterator, List, Literal, Optional, Union
+from xml.etree.ElementTree import TreeBuilder
+
+from langchain_core.exceptions import OutputParserException
+from langchain_core.messages import BaseMessage
+from langchain_core.output_parsers.transform import BaseTransformOutputParser
+from langchain_core.runnables.utils import AddableDict
+
+XML_FORMAT_INSTRUCTIONS = """The output should be formatted as a XML file.
+1. Output should conform to the tags below. 
+2. If tags are not given, make them on your own.
+3. Remember to always open and close all the tags.
+
+As an example, for the tags ["foo", "bar", "baz"]:
+1. String "<foo>\n   <bar>\n      <baz></baz>\n   </bar>\n</foo>" is a well-formatted instance of the schema. 
+2. String "<foo>\n   <bar>\n   </foo>" is a badly-formatted instance.
+3. String "<foo>\n   <tag>\n   </tag>\n</foo>" is a badly-formatted instance.
+
+Here are the output tags:
+```
+{tags}
+```"""  # noqa: E501
+
+
+class _StreamingParser:
+    """Streaming parser for XML.
+
+    This implementation is pulled into a class to avoid implementation
+    drift between transform and atransform of the XMLOutputParser.
+    """
+
+    def __init__(self, parser: Literal["defusedxml", "xml"]) -> None:
+        """Initialize the streaming parser.
+
+        Args:
+            parser: Parser to use for XML parsing. Can be either 'defusedxml' or 'xml'.
+              See documentation in XMLOutputParser for more information.
+        """
+        if parser == "defusedxml":
+            try:
+                from defusedxml import ElementTree as DET  # type: ignore
+            except ImportError:
+                raise ImportError(
+                    "defusedxml is not installed. "
+                    "Please install it to use the defusedxml parser."
+                    "You can install it with `pip install defusedxml` "
+                )
+            _parser = DET.DefusedXMLParser(target=TreeBuilder())
+        else:
+            _parser = None
+        self.pull_parser = ET.XMLPullParser(["start", "end"], _parser=_parser)
+        self.xml_start_re = re.compile(r"<[a-zA-Z:_]")
+        self.current_path: List[str] = []
+        self.current_path_has_children = False
+        self.buffer = ""
+        self.xml_started = False
+
+    def parse(self, chunk: Union[str, BaseMessage]) -> Iterator[AddableDict]:
+        """Parse a chunk of text.
+
+        Args:
+            chunk: A chunk of text to parse. This can be a string or a BaseMessage.
+
+        Yields:
+            AddableDict: A dictionary representing the parsed XML element.
+        """
+        if isinstance(chunk, BaseMessage):
+            # extract text
+            chunk_content = chunk.content
+            if not isinstance(chunk_content, str):
+                # ignore non-string messages (e.g., function calls)
+                return
+            chunk = chunk_content
+        # add chunk to buffer of unprocessed text
+        self.buffer += chunk
+        # if xml string hasn't started yet, continue to next chunk
+        if not self.xml_started:
+            if match := self.xml_start_re.search(self.buffer):
+                # if xml string has started, remove all text before it
+                self.buffer = self.buffer[match.start() :]
+                self.xml_started = True
+            else:
+                return
+        # feed buffer to parser
+        self.pull_parser.feed(self.buffer)
+        self.buffer = ""
+        # yield all events
+        try:
+            for event, elem in self.pull_parser.read_events():
+                if event == "start":
+                    # update current path
+                    self.current_path.append(elem.tag)
+                    self.current_path_has_children = False
+                elif event == "end":
+                    # remove last element from current path
+                    #
+                    self.current_path.pop()
+                    # yield element
+                    if not self.current_path_has_children:
+                        yield nested_element(self.current_path, elem)
+                    # prevent yielding of parent element
+                    if self.current_path:
+                        self.current_path_has_children = True
+                    else:
+                        self.xml_started = False
+        except xml.etree.ElementTree.ParseError:
+            # This might be junk at the end of the XML input.
+            # Let's check whether the current path is empty.
+            if not self.current_path:
+                # If it is empty, we can ignore this error.
+                return
+            else:
+                raise
+
+    def close(self) -> None:
+        """Close the parser."""
+        try:
+            self.pull_parser.close()
+        except xml.etree.ElementTree.ParseError:
+            # Ignore. This will ignore any incomplete XML at the end of the input
+            pass
+
+
+class XMLOutputParser(BaseTransformOutputParser):
+    """Parse an output using xml format."""
+
+    tags: Optional[List[str]] = None
+    encoding_matcher: re.Pattern = re.compile(
+        r"<([^>]*encoding[^>]*)>\n(.*)", re.MULTILINE | re.DOTALL
+    )
+    parser: Literal["defusedxml", "xml"] = "defusedxml"
+    """Parser to use for XML parsing. Can be either 'defusedxml' or 'xml'.
+    
+    * 'defusedxml' is the default parser and is used to prevent XML vulnerabilities 
+       present in some distributions of Python's standard library xml.
+       `defusedxml` is a wrapper around the standard library parser that
+       sets up the parser with secure defaults.
+    * 'xml' is the standard library parser.
+    
+    Use `xml` only if you are sure that your distribution of the standard library
+    is not vulnerable to XML vulnerabilities. 
+    
+    Please review the following resources for more information:
+    
+    * https://docs.python.org/3/library/xml.html#xml-vulnerabilities
+    * https://github.com/tiran/defusedxml 
+    
+    The standard library relies on libexpat for parsing XML:
+    https://github.com/libexpat/libexpat 
+    """
+
+    def get_format_instructions(self) -> str:
+        return XML_FORMAT_INSTRUCTIONS.format(tags=self.tags)
+
+    def parse(self, text: str) -> Dict[str, Union[str, List[Any]]]:
+        # Try to find XML string within triple backticks
+        # Imports are temporarily placed here to avoid issue with caching on CI
+        # likely if you're reading this you can move them to the top of the file
+        if self.parser == "defusedxml":
+            try:
+                from defusedxml import ElementTree as DET  # type: ignore
+            except ImportError:
+                raise ImportError(
+                    "defusedxml is not installed. "
+                    "Please install it to use the defusedxml parser."
+                    "You can install it with `pip install defusedxml`"
+                    "See https://github.com/tiran/defusedxml for more details"
+                )
+            _ET = DET  # Use the defusedxml parser
+        else:
+            _ET = ET  # Use the standard library parser
+
+        match = re.search(r"```(xml)?(.*)```", text, re.DOTALL)
+        if match is not None:
+            # If match found, use the content within the backticks
+            text = match.group(2)
+        encoding_match = self.encoding_matcher.search(text)
+        if encoding_match:
+            text = encoding_match.group(2)
+
+        text = text.strip()
+        try:
+            root = ET.fromstring(text)
+            return self._root_to_dict(root)
+
+        except ET.ParseError as e:
+            msg = f"Failed to parse XML format from completion {text}. Got: {e}"
+            raise OutputParserException(msg, llm_output=text) from e
+
+    def _transform(
+        self, input: Iterator[Union[str, BaseMessage]]
+    ) -> Iterator[AddableDict]:
+        streaming_parser = _StreamingParser(self.parser)
+        for chunk in input:
+            yield from streaming_parser.parse(chunk)
+        streaming_parser.close()
+
+    async def _atransform(
+        self, input: AsyncIterator[Union[str, BaseMessage]]
+    ) -> AsyncIterator[AddableDict]:
+        streaming_parser = _StreamingParser(self.parser)
+        async for chunk in input:
+            for output in streaming_parser.parse(chunk):
+                yield output
+        streaming_parser.close()
+
+    def _root_to_dict(self, root: ET.Element) -> Dict[str, Union[str, List[Any]]]:
+        """Converts xml tree to python dictionary."""
+        if root.text and bool(re.search(r"\S", root.text)):
+            # If root text contains any non-whitespace character it
+            # returns {root.tag: root.text}
+            return {root.tag: root.text}
+        result: Dict = {root.tag: []}
+        for child in root:
+            if len(child) == 0:
+                result[root.tag].append({child.tag: child.text})
+            else:
+                result[root.tag].append(self._root_to_dict(child))
+        return result
+
+    @property
+    def _type(self) -> str:
+        return "xml"
+
+
+def nested_element(path: List[str], elem: ET.Element) -> Any:
+    """Get nested element from path."""
+    if len(path) == 0:
+        return AddableDict({elem.tag: elem.text})
+    else:
+        return AddableDict({path[0]: [nested_element(path[1:], elem)]})
diff --git a/llm/Lib/site-packages/langchain_core/outputs/__init__.py b/llm/Lib/site-packages/langchain_core/outputs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e5bb7970fe45c6a56ed62194a03d27b98a0b491a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/outputs/__init__.py
@@ -0,0 +1,19 @@
+"""**Output** classes are used to represent the output of a language model call
+and the output of a chat.
+
+"""
+from langchain_core.outputs.chat_generation import ChatGeneration, ChatGenerationChunk
+from langchain_core.outputs.chat_result import ChatResult
+from langchain_core.outputs.generation import Generation, GenerationChunk
+from langchain_core.outputs.llm_result import LLMResult
+from langchain_core.outputs.run_info import RunInfo
+
+__all__ = [
+    "ChatGeneration",
+    "ChatGenerationChunk",
+    "ChatResult",
+    "Generation",
+    "GenerationChunk",
+    "LLMResult",
+    "RunInfo",
+]
diff --git a/llm/Lib/site-packages/langchain_core/outputs/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/outputs/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9a4c5bc0ee9976f16ca7f5d38254db1cd70bd7f5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/outputs/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/outputs/__pycache__/chat_generation.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/outputs/__pycache__/chat_generation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b8678c5d3670a1870b9ed0e34699021730d63c29
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/outputs/__pycache__/chat_generation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/outputs/__pycache__/chat_result.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/outputs/__pycache__/chat_result.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..201b86d895dd016e876f56c8b78625047bb1f565
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/outputs/__pycache__/chat_result.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/outputs/__pycache__/generation.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/outputs/__pycache__/generation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f3b3f1c8824d179ce01495092c3aa46cffa0eb7c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/outputs/__pycache__/generation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/outputs/__pycache__/llm_result.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/outputs/__pycache__/llm_result.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b42201d46d4ddece9bfb6f1b3938b7c128be6d5c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/outputs/__pycache__/llm_result.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/outputs/__pycache__/run_info.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/outputs/__pycache__/run_info.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8f5402ec0f2bc9c312759aa79ee352e9b103bca0
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/outputs/__pycache__/run_info.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/outputs/chat_generation.py b/llm/Lib/site-packages/langchain_core/outputs/chat_generation.py
new file mode 100644
index 0000000000000000000000000000000000000000..17ce470053009663e79a8660a017b9bec0319708
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/outputs/chat_generation.py
@@ -0,0 +1,85 @@
+from __future__ import annotations
+
+from typing import Any, Dict, List, Literal
+
+from langchain_core.messages import BaseMessage, BaseMessageChunk
+from langchain_core.outputs.generation import Generation
+from langchain_core.pydantic_v1 import root_validator
+from langchain_core.utils._merge import merge_dicts
+
+
+class ChatGeneration(Generation):
+    """A single chat generation output."""
+
+    text: str = ""
+    """*SHOULD NOT BE SET DIRECTLY* The text contents of the output message."""
+    message: BaseMessage
+    """The message output by the chat model."""
+    # Override type to be ChatGeneration, ignore mypy error as this is intentional
+    type: Literal["ChatGeneration"] = "ChatGeneration"  # type: ignore[assignment]
+    """Type is used exclusively for serialization purposes."""
+
+    @root_validator
+    def set_text(cls, values: Dict[str, Any]) -> Dict[str, Any]:
+        """Set the text attribute to be the contents of the message."""
+        try:
+            text = ""
+            if isinstance(values["message"].content, str):
+                text = values["message"].content
+            # HACK: Assumes text in content blocks in OpenAI format.
+            # Uses first text block.
+            elif isinstance(values["message"].content, list):
+                for block in values["message"].content:
+                    if isinstance(block, str):
+                        text = block
+                        break
+                    elif isinstance(block, dict) and "text" in block:
+                        text = block["text"]
+                        break
+                    else:
+                        pass
+            else:
+                pass
+            values["text"] = text
+        except (KeyError, AttributeError) as e:
+            raise ValueError("Error while initializing ChatGeneration") from e
+        return values
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "output"]
+
+
+class ChatGenerationChunk(ChatGeneration):
+    """ChatGeneration chunk, which can be concatenated with other
+      ChatGeneration chunks.
+
+    Attributes:
+        message: The message chunk output by the chat model.
+    """
+
+    message: BaseMessageChunk
+    # Override type to be ChatGeneration, ignore mypy error as this is intentional
+    type: Literal["ChatGenerationChunk"] = "ChatGenerationChunk"  # type: ignore[assignment] # noqa: E501
+    """Type is used exclusively for serialization purposes."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "output"]
+
+    def __add__(self, other: ChatGenerationChunk) -> ChatGenerationChunk:
+        if isinstance(other, ChatGenerationChunk):
+            generation_info = merge_dicts(
+                self.generation_info or {},
+                other.generation_info or {},
+            )
+            return ChatGenerationChunk(
+                message=self.message + other.message,
+                generation_info=generation_info or None,
+            )
+        else:
+            raise TypeError(
+                f"unsupported operand type(s) for +: '{type(self)}' and '{type(other)}'"
+            )
diff --git a/llm/Lib/site-packages/langchain_core/outputs/chat_result.py b/llm/Lib/site-packages/langchain_core/outputs/chat_result.py
new file mode 100644
index 0000000000000000000000000000000000000000..f985ca82753ee46d6ace4249415442d215eb4e03
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/outputs/chat_result.py
@@ -0,0 +1,15 @@
+from typing import List, Optional
+
+from langchain_core.outputs.chat_generation import ChatGeneration
+from langchain_core.pydantic_v1 import BaseModel
+
+
+class ChatResult(BaseModel):
+    """Class that contains all results for a single chat model call."""
+
+    generations: List[ChatGeneration]
+    """List of the chat generations. This is a List because an input can have multiple 
+        candidate generations.
+    """
+    llm_output: Optional[dict] = None
+    """For arbitrary LLM provider specific output."""
diff --git a/llm/Lib/site-packages/langchain_core/outputs/generation.py b/llm/Lib/site-packages/langchain_core/outputs/generation.py
new file mode 100644
index 0000000000000000000000000000000000000000..34e219771d125a388b398125d1ec151451ad224b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/outputs/generation.py
@@ -0,0 +1,55 @@
+from __future__ import annotations
+
+from typing import Any, Dict, List, Literal, Optional
+
+from langchain_core.load import Serializable
+from langchain_core.utils._merge import merge_dicts
+
+
+class Generation(Serializable):
+    """A single text generation output."""
+
+    text: str
+    """Generated text output."""
+
+    generation_info: Optional[Dict[str, Any]] = None
+    """Raw response from the provider. May include things like the 
+        reason for finishing or token log probabilities.
+    """
+    type: Literal["Generation"] = "Generation"
+    """Type is used exclusively for serialization purposes."""
+    # TODO: add log probs as separate attribute
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this class is serializable."""
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "output"]
+
+
+class GenerationChunk(Generation):
+    """Generation chunk, which can be concatenated with other Generation chunks."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "output"]
+
+    def __add__(self, other: GenerationChunk) -> GenerationChunk:
+        if isinstance(other, GenerationChunk):
+            generation_info = merge_dicts(
+                self.generation_info or {},
+                other.generation_info or {},
+            )
+            return GenerationChunk(
+                text=self.text + other.text,
+                generation_info=generation_info or None,
+            )
+        else:
+            raise TypeError(
+                f"unsupported operand type(s) for +: '{type(self)}' and '{type(other)}'"
+            )
diff --git a/llm/Lib/site-packages/langchain_core/outputs/llm_result.py b/llm/Lib/site-packages/langchain_core/outputs/llm_result.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1df4c8304601a867b1b4c3f59c18b6381f01d88
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/outputs/llm_result.py
@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+from copy import deepcopy
+from typing import List, Optional
+
+from langchain_core.outputs.generation import Generation
+from langchain_core.outputs.run_info import RunInfo
+from langchain_core.pydantic_v1 import BaseModel
+
+
+class LLMResult(BaseModel):
+    """Class that contains all results for a batched LLM call."""
+
+    generations: List[List[Generation]]
+    """List of generated outputs. This is a List[List[]] because
+    each input could have multiple candidate generations."""
+    llm_output: Optional[dict] = None
+    """Arbitrary LLM provider-specific output."""
+    run: Optional[List[RunInfo]] = None
+    """List of metadata info for model call for each input."""
+
+    def flatten(self) -> List[LLMResult]:
+        """Flatten generations into a single list.
+
+        Unpack List[List[Generation]] -> List[LLMResult] where each returned LLMResult
+            contains only a single Generation. If token usage information is available,
+            it is kept only for the LLMResult corresponding to the top-choice
+            Generation, to avoid over-counting of token usage downstream.
+
+        Returns:
+            List of LLMResults where each returned LLMResult contains a single
+                Generation.
+        """
+        llm_results = []
+        for i, gen_list in enumerate(self.generations):
+            # Avoid double counting tokens in OpenAICallback
+            if i == 0:
+                llm_results.append(
+                    LLMResult(
+                        generations=[gen_list],
+                        llm_output=self.llm_output,
+                    )
+                )
+            else:
+                if self.llm_output is not None:
+                    llm_output = deepcopy(self.llm_output)
+                    llm_output["token_usage"] = dict()
+                else:
+                    llm_output = None
+                llm_results.append(
+                    LLMResult(
+                        generations=[gen_list],
+                        llm_output=llm_output,
+                    )
+                )
+        return llm_results
+
+    def __eq__(self, other: object) -> bool:
+        """Check for LLMResult equality by ignoring any metadata related to runs."""
+        if not isinstance(other, LLMResult):
+            return NotImplemented
+        return (
+            self.generations == other.generations
+            and self.llm_output == other.llm_output
+        )
diff --git a/llm/Lib/site-packages/langchain_core/outputs/run_info.py b/llm/Lib/site-packages/langchain_core/outputs/run_info.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c6c69826bd5ba9235e1f219db7fa1bc3f4f44d7
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/outputs/run_info.py
@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from uuid import UUID
+
+from langchain_core.pydantic_v1 import BaseModel
+
+
+class RunInfo(BaseModel):
+    """Class that contains metadata for a single execution of a Chain or model."""
+
+    run_id: UUID
+    """A unique identifier for the model or chain run."""
diff --git a/llm/Lib/site-packages/langchain_core/prompt_values.py b/llm/Lib/site-packages/langchain_core/prompt_values.py
new file mode 100644
index 0000000000000000000000000000000000000000..37957daa3276f92ad298abee4971cf61b606cd8c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/prompt_values.py
@@ -0,0 +1,127 @@
+"""**Prompt values** for language model prompts.
+
+Prompt values are used to represent different pieces of prompts.
+They can be used to represent text, images, or chat message pieces.
+"""
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import List, Literal, Sequence, cast
+
+from typing_extensions import TypedDict
+
+from langchain_core.load.serializable import Serializable
+from langchain_core.messages import (
+    AnyMessage,
+    BaseMessage,
+    HumanMessage,
+    get_buffer_string,
+)
+
+
+class PromptValue(Serializable, ABC):
+    """Base abstract class for inputs to any language model.
+
+    PromptValues can be converted to both LLM (pure text-generation) inputs and
+        ChatModel inputs.
+    """
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this class is serializable."""
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "prompt"]
+
+    @abstractmethod
+    def to_string(self) -> str:
+        """Return prompt value as string."""
+
+    @abstractmethod
+    def to_messages(self) -> List[BaseMessage]:
+        """Return prompt as a list of Messages."""
+
+
+class StringPromptValue(PromptValue):
+    """String prompt value."""
+
+    text: str
+    """Prompt text."""
+    type: Literal["StringPromptValue"] = "StringPromptValue"
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "base"]
+
+    def to_string(self) -> str:
+        """Return prompt as string."""
+        return self.text
+
+    def to_messages(self) -> List[BaseMessage]:
+        """Return prompt as messages."""
+        return [HumanMessage(content=self.text)]
+
+
+class ChatPromptValue(PromptValue):
+    """Chat prompt value.
+
+    A type of a prompt value that is built from messages.
+    """
+
+    messages: Sequence[BaseMessage]
+    """List of messages."""
+
+    def to_string(self) -> str:
+        """Return prompt as string."""
+        return get_buffer_string(self.messages)
+
+    def to_messages(self) -> List[BaseMessage]:
+        """Return prompt as a list of messages."""
+        return list(self.messages)
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "chat"]
+
+
+class ImageURL(TypedDict, total=False):
+    detail: Literal["auto", "low", "high"]
+    """Specifies the detail level of the image."""
+
+    url: str
+    """Either a URL of the image or the base64 encoded image data."""
+
+
+class ImagePromptValue(PromptValue):
+    """Image prompt value."""
+
+    image_url: ImageURL
+    """Prompt image."""
+    type: Literal["ImagePromptValue"] = "ImagePromptValue"
+
+    def to_string(self) -> str:
+        """Return prompt as string."""
+        return self.image_url["url"]
+
+    def to_messages(self) -> List[BaseMessage]:
+        """Return prompt as messages."""
+        return [HumanMessage(content=[cast(dict, self.image_url)])]
+
+
+class ChatPromptValueConcrete(ChatPromptValue):
+    """Chat prompt value which explicitly lists out the message types it accepts.
+    For use in external schemas."""
+
+    messages: Sequence[AnyMessage]
+
+    type: Literal["ChatPromptValueConcrete"] = "ChatPromptValueConcrete"
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "chat"]
diff --git a/llm/Lib/site-packages/langchain_core/prompts/__init__.py b/llm/Lib/site-packages/langchain_core/prompts/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1c9545dca17f3ae8bdf9b93cc636577267214a99
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/prompts/__init__.py
@@ -0,0 +1,79 @@
+"""**Prompt** is the input to the model.
+
+Prompt is often constructed
+from multiple components and prompt values. Prompt classes and functions make constructing
+ and working with prompts easy.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BasePromptTemplate --> PipelinePromptTemplate
+                           StringPromptTemplate --> PromptTemplate
+                                                    FewShotPromptTemplate
+                                                    FewShotPromptWithTemplates
+                           BaseChatPromptTemplate --> AutoGPTPrompt
+                                                      ChatPromptTemplate --> AgentScratchPadChatPromptTemplate
+
+
+
+    BaseMessagePromptTemplate --> MessagesPlaceholder
+                                  BaseStringMessagePromptTemplate --> ChatMessagePromptTemplate
+                                                                      HumanMessagePromptTemplate
+                                                                      AIMessagePromptTemplate
+                                                                      SystemMessagePromptTemplate
+
+"""  # noqa: E501
+from langchain_core.prompts.base import (
+    BasePromptTemplate,
+    aformat_document,
+    format_document,
+)
+from langchain_core.prompts.chat import (
+    AIMessagePromptTemplate,
+    BaseChatPromptTemplate,
+    ChatMessagePromptTemplate,
+    ChatPromptTemplate,
+    HumanMessagePromptTemplate,
+    MessagesPlaceholder,
+    SystemMessagePromptTemplate,
+)
+from langchain_core.prompts.few_shot import (
+    FewShotChatMessagePromptTemplate,
+    FewShotPromptTemplate,
+)
+from langchain_core.prompts.few_shot_with_templates import FewShotPromptWithTemplates
+from langchain_core.prompts.loading import load_prompt
+from langchain_core.prompts.pipeline import PipelinePromptTemplate
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.prompts.string import (
+    StringPromptTemplate,
+    check_valid_template,
+    get_template_variables,
+    jinja2_formatter,
+    validate_jinja2,
+)
+
+__all__ = [
+    "AIMessagePromptTemplate",
+    "BaseChatPromptTemplate",
+    "BasePromptTemplate",
+    "ChatMessagePromptTemplate",
+    "ChatPromptTemplate",
+    "FewShotPromptTemplate",
+    "FewShotPromptWithTemplates",
+    "FewShotChatMessagePromptTemplate",
+    "HumanMessagePromptTemplate",
+    "MessagesPlaceholder",
+    "PipelinePromptTemplate",
+    "PromptTemplate",
+    "StringPromptTemplate",
+    "SystemMessagePromptTemplate",
+    "load_prompt",
+    "format_document",
+    "aformat_document",
+    "check_valid_template",
+    "get_template_variables",
+    "jinja2_formatter",
+    "validate_jinja2",
+]
diff --git a/llm/Lib/site-packages/langchain_core/prompts/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4484f2e670c00248b046539565cdd58533f140fd
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/prompts/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..77ff75017c621d3de2adf8bfb81ddfb41dc937a5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/prompts/__pycache__/chat.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/chat.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5925d0018a2b0fe54adfb4cc98213c37199bec16
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/chat.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/prompts/__pycache__/few_shot.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/few_shot.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..89c5852b4880cd73f99c646613e1c193549ec80d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/few_shot.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/prompts/__pycache__/few_shot_with_templates.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/few_shot_with_templates.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..6cfd5cebfde53f67587b2209f30b3bb11d49b139
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/few_shot_with_templates.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/prompts/__pycache__/image.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/image.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..799457d0e600f3e3aad12f3d346e7b82de5f79ef
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/image.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/prompts/__pycache__/loading.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/loading.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3abff0f4a23105a14c2c1f315715ef22ab6c4cdc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/loading.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/prompts/__pycache__/pipeline.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/pipeline.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..648ebd25dc2f68e7008332c733e061760a7f1cb8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/pipeline.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/prompts/__pycache__/prompt.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/prompt.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b5d145a0763e01e9db336621b543b94a0831afae
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/prompt.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/prompts/__pycache__/string.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/string.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8ca9d81731e34881748df542c6515f58b3e0e9c8
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/string.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/prompts/__pycache__/structured.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/structured.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ecbead8b16323cf2edfebee88a87ba28f10d3eba
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/prompts/__pycache__/structured.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/prompts/base.py b/llm/Lib/site-packages/langchain_core/prompts/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..381ce854d3e446df51311868eaab5d998f655940
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/prompts/base.py
@@ -0,0 +1,358 @@
+from __future__ import annotations
+
+import json
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Generic,
+    List,
+    Mapping,
+    Optional,
+    Type,
+    TypeVar,
+    Union,
+)
+
+import yaml
+
+from langchain_core.output_parsers.base import BaseOutputParser
+from langchain_core.prompt_values import (
+    ChatPromptValueConcrete,
+    PromptValue,
+    StringPromptValue,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+from langchain_core.runnables import RunnableConfig, RunnableSerializable
+from langchain_core.runnables.config import ensure_config
+from langchain_core.runnables.utils import create_model
+
+if TYPE_CHECKING:
+    from langchain_core.documents import Document
+
+
+FormatOutputType = TypeVar("FormatOutputType")
+
+
+class BasePromptTemplate(
+    RunnableSerializable[Dict, PromptValue], Generic[FormatOutputType], ABC
+):
+    """Base class for all prompt templates, returning a prompt."""
+
+    input_variables: List[str]
+    """A list of the names of the variables the prompt template expects."""
+    input_types: Dict[str, Any] = Field(default_factory=dict)
+    """A dictionary of the types of the variables the prompt template expects.
+    If not provided, all variables are assumed to be strings."""
+    output_parser: Optional[BaseOutputParser] = None
+    """How to parse the output of calling an LLM on this formatted prompt."""
+    partial_variables: Mapping[str, Any] = Field(default_factory=dict)
+    """A dictionary of the partial variables the prompt template carries.
+    
+    Partial variables populate the template so that you don't need to
+    pass them in every time you call the prompt."""
+    metadata: Optional[Dict[str, Any]] = None
+    """Metadata to be used for tracing."""
+    tags: Optional[List[str]] = None
+    """Tags to be used for tracing."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "prompt_template"]
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this class is serializable."""
+        return True
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @property
+    def OutputType(self) -> Any:
+        return Union[StringPromptValue, ChatPromptValueConcrete]
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        # This is correct, but pydantic typings/mypy don't think so.
+        return create_model(  # type: ignore[call-overload]
+            "PromptInput",
+            **{k: (self.input_types.get(k, str), None) for k in self.input_variables},
+        )
+
+    def _validate_input(self, inner_input: Dict) -> Dict:
+        if not isinstance(inner_input, dict):
+            if len(self.input_variables) == 1:
+                var_name = self.input_variables[0]
+                inner_input = {var_name: inner_input}
+
+            else:
+                raise TypeError(
+                    f"Expected mapping type as input to {self.__class__.__name__}. "
+                    f"Received {type(inner_input)}."
+                )
+        missing = set(self.input_variables).difference(inner_input)
+        if missing:
+            raise KeyError(
+                f"Input to {self.__class__.__name__} is missing variables {missing}. "
+                f" Expected: {self.input_variables}"
+                f" Received: {list(inner_input.keys())}"
+            )
+        return inner_input
+
+    def _format_prompt_with_error_handling(self, inner_input: Dict) -> PromptValue:
+        _inner_input = self._validate_input(inner_input)
+        return self.format_prompt(**_inner_input)
+
+    async def _aformat_prompt_with_error_handling(
+        self, inner_input: Dict
+    ) -> PromptValue:
+        _inner_input = self._validate_input(inner_input)
+        return await self.aformat_prompt(**_inner_input)
+
+    def invoke(
+        self, input: Dict, config: Optional[RunnableConfig] = None
+    ) -> PromptValue:
+        config = ensure_config(config)
+        if self.metadata:
+            config["metadata"] = {**config["metadata"], **self.metadata}
+        if self.tags:
+            config["tags"] = config["tags"] + self.tags
+        return self._call_with_config(
+            self._format_prompt_with_error_handling,
+            input,
+            config,
+            run_type="prompt",
+        )
+
+    async def ainvoke(
+        self, input: Dict, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> PromptValue:
+        config = ensure_config(config)
+        if self.metadata:
+            config["metadata"].update(self.metadata)
+        if self.tags:
+            config["tags"].extend(self.tags)
+        return await self._acall_with_config(
+            self._aformat_prompt_with_error_handling,
+            input,
+            config,
+            run_type="prompt",
+        )
+
+    @abstractmethod
+    def format_prompt(self, **kwargs: Any) -> PromptValue:
+        """Create Prompt Value."""
+
+    async def aformat_prompt(self, **kwargs: Any) -> PromptValue:
+        """Create Prompt Value."""
+        return self.format_prompt(**kwargs)
+
+    @root_validator()
+    def validate_variable_names(cls, values: Dict) -> Dict:
+        """Validate variable names do not include restricted names."""
+        if "stop" in values["input_variables"]:
+            raise ValueError(
+                "Cannot have an input variable named 'stop', as it is used internally,"
+                " please rename."
+            )
+        if "stop" in values["partial_variables"]:
+            raise ValueError(
+                "Cannot have an partial variable named 'stop', as it is used "
+                "internally, please rename."
+            )
+
+        overall = set(values["input_variables"]).intersection(
+            values["partial_variables"]
+        )
+        if overall:
+            raise ValueError(
+                f"Found overlapping input and partial variables: {overall}"
+            )
+        return values
+
+    def partial(self, **kwargs: Union[str, Callable[[], str]]) -> BasePromptTemplate:
+        """Return a partial of the prompt template."""
+        prompt_dict = self.__dict__.copy()
+        prompt_dict["input_variables"] = list(
+            set(self.input_variables).difference(kwargs)
+        )
+        prompt_dict["partial_variables"] = {**self.partial_variables, **kwargs}
+        return type(self)(**prompt_dict)
+
+    def _merge_partial_and_user_variables(self, **kwargs: Any) -> Dict[str, Any]:
+        # Get partial params:
+        partial_kwargs = {
+            k: v if not callable(v) else v() for k, v in self.partial_variables.items()
+        }
+        return {**partial_kwargs, **kwargs}
+
+    @abstractmethod
+    def format(self, **kwargs: Any) -> FormatOutputType:
+        """Format the prompt with the inputs.
+
+        Args:
+            kwargs: Any arguments to be passed to the prompt template.
+
+        Returns:
+            A formatted string.
+
+        Example:
+
+        .. code-block:: python
+
+            prompt.format(variable1="foo")
+        """
+
+    async def aformat(self, **kwargs: Any) -> FormatOutputType:
+        """Format the prompt with the inputs.
+
+        Args:
+            kwargs: Any arguments to be passed to the prompt template.
+
+        Returns:
+            A formatted string.
+
+        Example:
+
+        .. code-block:: python
+
+            await prompt.aformat(variable1="foo")
+        """
+        return self.format(**kwargs)
+
+    @property
+    def _prompt_type(self) -> str:
+        """Return the prompt type key."""
+        raise NotImplementedError
+
+    def dict(self, **kwargs: Any) -> Dict:
+        """Return dictionary representation of prompt."""
+        prompt_dict = super().dict(**kwargs)
+        try:
+            prompt_dict["_type"] = self._prompt_type
+        except NotImplementedError:
+            pass
+        return prompt_dict
+
+    def save(self, file_path: Union[Path, str]) -> None:
+        """Save the prompt.
+
+        Args:
+            file_path: Path to directory to save prompt to.
+
+        Example:
+        .. code-block:: python
+
+            prompt.save(file_path="path/prompt.yaml")
+        """
+        if self.partial_variables:
+            raise ValueError("Cannot save prompt with partial variables.")
+
+        # Fetch dictionary to save
+        prompt_dict = self.dict()
+        if "_type" not in prompt_dict:
+            raise NotImplementedError(f"Prompt {self} does not support saving.")
+
+        # Convert file to Path object.
+        if isinstance(file_path, str):
+            save_path = Path(file_path)
+        else:
+            save_path = file_path
+
+        directory_path = save_path.parent
+        directory_path.mkdir(parents=True, exist_ok=True)
+
+        if save_path.suffix == ".json":
+            with open(file_path, "w") as f:
+                json.dump(prompt_dict, f, indent=4)
+        elif save_path.suffix.endswith((".yaml", ".yml")):
+            with open(file_path, "w") as f:
+                yaml.dump(prompt_dict, f, default_flow_style=False)
+        else:
+            raise ValueError(f"{save_path} must be json or yaml")
+
+
+def _get_document_info(doc: Document, prompt: BasePromptTemplate[str]) -> Dict:
+    base_info = {"page_content": doc.page_content, **doc.metadata}
+    missing_metadata = set(prompt.input_variables).difference(base_info)
+    if len(missing_metadata) > 0:
+        required_metadata = [
+            iv for iv in prompt.input_variables if iv != "page_content"
+        ]
+        raise ValueError(
+            f"Document prompt requires documents to have metadata variables: "
+            f"{required_metadata}. Received document with missing metadata: "
+            f"{list(missing_metadata)}."
+        )
+    return {k: base_info[k] for k in prompt.input_variables}
+
+
+def format_document(doc: Document, prompt: BasePromptTemplate[str]) -> str:
+    """Format a document into a string based on a prompt template.
+
+    First, this pulls information from the document from two sources:
+
+    1. `page_content`:
+        This takes the information from the `document.page_content`
+        and assigns it to a variable named `page_content`.
+    2. metadata:
+        This takes information from `document.metadata` and assigns
+        it to variables of the same name.
+
+    Those variables are then passed into the `prompt` to produce a formatted string.
+
+    Args:
+        doc: Document, the page_content and metadata will be used to create
+            the final string.
+        prompt: BasePromptTemplate, will be used to format the page_content
+            and metadata into the final string.
+
+    Returns:
+        string of the document formatted.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_core.documents import Document
+            from langchain_core.prompts import PromptTemplate
+
+            doc = Document(page_content="This is a joke", metadata={"page": "1"})
+            prompt = PromptTemplate.from_template("Page {page}: {page_content}")
+            format_document(doc, prompt)
+            >>> "Page 1: This is a joke"
+    """
+    return prompt.format(**_get_document_info(doc, prompt))
+
+
+async def aformat_document(doc: Document, prompt: BasePromptTemplate[str]) -> str:
+    """Format a document into a string based on a prompt template.
+
+    First, this pulls information from the document from two sources:
+
+    1. `page_content`:
+        This takes the information from the `document.page_content`
+        and assigns it to a variable named `page_content`.
+    2. metadata:
+        This takes information from `document.metadata` and assigns
+        it to variables of the same name.
+
+    Those variables are then passed into the `prompt` to produce a formatted string.
+
+    Args:
+        doc: Document, the page_content and metadata will be used to create
+            the final string.
+        prompt: BasePromptTemplate, will be used to format the page_content
+            and metadata into the final string.
+
+    Returns:
+        string of the document formatted.
+    """
+    return await prompt.aformat(**_get_document_info(doc, prompt))
diff --git a/llm/Lib/site-packages/langchain_core/prompts/chat.py b/llm/Lib/site-packages/langchain_core/prompts/chat.py
new file mode 100644
index 0000000000000000000000000000000000000000..4316dc5bdd9494ba20d0952baab1d45854323177
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/prompts/chat.py
@@ -0,0 +1,1238 @@
+"""Chat prompt template."""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import (
+    Any,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypedDict,
+    TypeVar,
+    Union,
+    cast,
+    overload,
+)
+
+from langchain_core._api import deprecated
+from langchain_core.load import Serializable
+from langchain_core.messages import (
+    AIMessage,
+    AnyMessage,
+    BaseMessage,
+    ChatMessage,
+    HumanMessage,
+    SystemMessage,
+    convert_to_messages,
+)
+from langchain_core.messages.base import get_msg_title_repr
+from langchain_core.prompt_values import ChatPromptValue, ImageURL, PromptValue
+from langchain_core.prompts.base import BasePromptTemplate
+from langchain_core.prompts.image import ImagePromptTemplate
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.prompts.string import StringPromptTemplate, get_template_variables
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.utils import get_colored_text
+from langchain_core.utils.interactive_env import is_interactive_env
+
+
+class BaseMessagePromptTemplate(Serializable, ABC):
+    """Base class for message prompt templates."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether or not the class is serializable."""
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "chat"]
+
+    @abstractmethod
+    def format_messages(self, **kwargs: Any) -> List[BaseMessage]:
+        """Format messages from kwargs. Should return a list of BaseMessages.
+
+        Args:
+            **kwargs: Keyword arguments to use for formatting.
+
+        Returns:
+            List of BaseMessages.
+        """
+
+    async def aformat_messages(self, **kwargs: Any) -> List[BaseMessage]:
+        """Format messages from kwargs. Should return a list of BaseMessages.
+
+        Args:
+            **kwargs: Keyword arguments to use for formatting.
+
+        Returns:
+            List of BaseMessages.
+        """
+        return self.format_messages(**kwargs)
+
+    @property
+    @abstractmethod
+    def input_variables(self) -> List[str]:
+        """Input variables for this prompt template.
+
+        Returns:
+            List of input variables.
+        """
+
+    def pretty_repr(self, html: bool = False) -> str:
+        """Human-readable representation."""
+        raise NotImplementedError
+
+    def pretty_print(self) -> None:
+        print(self.pretty_repr(html=is_interactive_env()))  # noqa: T201
+
+    def __add__(self, other: Any) -> ChatPromptTemplate:
+        """Combine two prompt templates.
+
+        Args:
+            other: Another prompt template.
+
+        Returns:
+            Combined prompt template.
+        """
+        prompt = ChatPromptTemplate(messages=[self])  # type: ignore[call-arg]
+        return prompt + other
+
+
+class MessagesPlaceholder(BaseMessagePromptTemplate):
+    """Prompt template that assumes variable is already list of messages.
+
+    A placeholder which can be used to pass in a list of messages.
+
+    Direct usage:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import MessagesPlaceholder
+
+            prompt = MessagesPlaceholder("history")
+            prompt.format_messages() # raises KeyError
+
+            prompt = MessagesPlaceholder("history", optional=True)
+            prompt.format_messages() # returns empty list []
+
+            prompt.format_messages(
+                history=[
+                    ("system", "You are an AI assistant."),
+                    ("human", "Hello!"),
+                ]
+            )
+            # -> [
+            #     SystemMessage(content="You are an AI assistant."),
+            #     HumanMessage(content="Hello!"),
+            # ]
+
+    Building a prompt with chat history:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder
+
+            prompt = ChatPromptTemplate.from_messages(
+                [
+                    ("system", "You are a helpful assistant."),
+                    MessagesPlaceholder("history"),
+                    ("human", "{question}")
+                ]
+            )
+            prompt.invoke(
+               {
+                   "history": [("human", "what's 5 + 2"), ("ai", "5 + 2 is 7")],
+                   "question": "now multiply that by 4"
+               }
+            )
+            # -> ChatPromptValue(messages=[
+            #     SystemMessage(content="You are a helpful assistant."),
+            #     HumanMessage(content="what's 5 + 2"),
+            #     AIMessage(content="5 + 2 is 7"),
+            #     HumanMessage(content="now multiply that by 4"),
+            # ])
+    """
+
+    variable_name: str
+    """Name of variable to use as messages."""
+
+    optional: bool = False
+    """If True format_messages can be called with no arguments and will return an empty 
+        list. If False then a named argument with name `variable_name` must be passed 
+        in, even if the value is an empty list."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "chat"]
+
+    def __init__(self, variable_name: str, *, optional: bool = False, **kwargs: Any):
+        super().__init__(variable_name=variable_name, optional=optional, **kwargs)
+
+    def format_messages(self, **kwargs: Any) -> List[BaseMessage]:
+        """Format messages from kwargs.
+
+        Args:
+            **kwargs: Keyword arguments to use for formatting.
+
+        Returns:
+            List of BaseMessage.
+        """
+        value = (
+            kwargs.get(self.variable_name, [])
+            if self.optional
+            else kwargs[self.variable_name]
+        )
+        if not isinstance(value, list):
+            raise ValueError(
+                f"variable {self.variable_name} should be a list of base messages, "
+                f"got {value}"
+            )
+        return convert_to_messages(value)
+
+    @property
+    def input_variables(self) -> List[str]:
+        """Input variables for this prompt template.
+
+        Returns:
+            List of input variable names.
+        """
+        return [self.variable_name] if not self.optional else []
+
+    def pretty_repr(self, html: bool = False) -> str:
+        var = "{" + self.variable_name + "}"
+        if html:
+            title = get_msg_title_repr("Messages Placeholder", bold=True)
+            var = get_colored_text(var, "yellow")
+        else:
+            title = get_msg_title_repr("Messages Placeholder")
+        return f"{title}\n\n{var}"
+
+
+MessagePromptTemplateT = TypeVar(
+    "MessagePromptTemplateT", bound="BaseStringMessagePromptTemplate"
+)
+"""Type variable for message prompt templates."""
+
+
+class BaseStringMessagePromptTemplate(BaseMessagePromptTemplate, ABC):
+    """Base class for message prompt templates that use a string prompt template."""
+
+    prompt: StringPromptTemplate
+    """String prompt template."""
+    additional_kwargs: dict = Field(default_factory=dict)
+    """Additional keyword arguments to pass to the prompt template."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "chat"]
+
+    @classmethod
+    def from_template(
+        cls: Type[MessagePromptTemplateT],
+        template: str,
+        template_format: str = "f-string",
+        partial_variables: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> MessagePromptTemplateT:
+        """Create a class from a string template.
+
+        Args:
+            template: a template.
+            template_format: format of the template.
+            partial_variables: A dictionary of variables that can be used to partially
+                               fill in the template. For example, if the template is
+                              `"{variable1} {variable2}"`, and `partial_variables` is
+                              `{"variable1": "foo"}`, then the final prompt will be
+                              `"foo {variable2}"`.
+            **kwargs: keyword arguments to pass to the constructor.
+
+        Returns:
+            A new instance of this class.
+        """
+        prompt = PromptTemplate.from_template(
+            template,
+            template_format=template_format,
+            partial_variables=partial_variables,
+        )
+        return cls(prompt=prompt, **kwargs)
+
+    @classmethod
+    def from_template_file(
+        cls: Type[MessagePromptTemplateT],
+        template_file: Union[str, Path],
+        input_variables: List[str],
+        **kwargs: Any,
+    ) -> MessagePromptTemplateT:
+        """Create a class from a template file.
+
+        Args:
+            template_file: path to a template file. String or Path.
+            input_variables: list of input variables.
+            **kwargs: keyword arguments to pass to the constructor.
+
+        Returns:
+            A new instance of this class.
+        """
+        prompt = PromptTemplate.from_file(template_file, input_variables)
+        return cls(prompt=prompt, **kwargs)
+
+    @abstractmethod
+    def format(self, **kwargs: Any) -> BaseMessage:
+        """Format the prompt template.
+
+        Args:
+            **kwargs: Keyword arguments to use for formatting.
+
+        Returns:
+            Formatted message.
+        """
+
+    async def aformat(self, **kwargs: Any) -> BaseMessage:
+        """Format the prompt template.
+
+        Args:
+            **kwargs: Keyword arguments to use for formatting.
+
+        Returns:
+            Formatted message.
+        """
+        return self.format(**kwargs)
+
+    def format_messages(self, **kwargs: Any) -> List[BaseMessage]:
+        """Format messages from kwargs.
+
+        Args:
+            **kwargs: Keyword arguments to use for formatting.
+
+        Returns:
+            List of BaseMessages.
+        """
+        return [self.format(**kwargs)]
+
+    async def aformat_messages(self, **kwargs: Any) -> List[BaseMessage]:
+        return [await self.aformat(**kwargs)]
+
+    @property
+    def input_variables(self) -> List[str]:
+        """
+        Input variables for this prompt template.
+
+        Returns:
+            List of input variable names.
+        """
+        return self.prompt.input_variables
+
+    def pretty_repr(self, html: bool = False) -> str:
+        # TODO: Handle partials
+        title = self.__class__.__name__.replace("MessagePromptTemplate", " Message")
+        title = get_msg_title_repr(title, bold=html)
+        return f"{title}\n\n{self.prompt.pretty_repr(html=html)}"
+
+
+class ChatMessagePromptTemplate(BaseStringMessagePromptTemplate):
+    """Chat message prompt template."""
+
+    role: str
+    """Role of the message."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "chat"]
+
+    def format(self, **kwargs: Any) -> BaseMessage:
+        """Format the prompt template.
+
+        Args:
+            **kwargs: Keyword arguments to use for formatting.
+
+        Returns:
+            Formatted message.
+        """
+        text = self.prompt.format(**kwargs)
+        return ChatMessage(
+            content=text, role=self.role, additional_kwargs=self.additional_kwargs
+        )
+
+    async def aformat(self, **kwargs: Any) -> BaseMessage:
+        text = await self.prompt.aformat(**kwargs)
+        return ChatMessage(
+            content=text, role=self.role, additional_kwargs=self.additional_kwargs
+        )
+
+
+_StringImageMessagePromptTemplateT = TypeVar(
+    "_StringImageMessagePromptTemplateT", bound="_StringImageMessagePromptTemplate"
+)
+
+
+class _TextTemplateParam(TypedDict, total=False):
+    text: Union[str, Dict]
+
+
+class _ImageTemplateParam(TypedDict, total=False):
+    image_url: Union[str, Dict]
+
+
+class _StringImageMessagePromptTemplate(BaseMessagePromptTemplate):
+    """Human message prompt template. This is a message sent from the user."""
+
+    prompt: Union[
+        StringPromptTemplate, List[Union[StringPromptTemplate, ImagePromptTemplate]]
+    ]
+    """Prompt template."""
+    additional_kwargs: dict = Field(default_factory=dict)
+    """Additional keyword arguments to pass to the prompt template."""
+
+    _msg_class: Type[BaseMessage]
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "chat"]
+
+    @classmethod
+    def from_template(
+        cls: Type[_StringImageMessagePromptTemplateT],
+        template: Union[str, List[Union[str, _TextTemplateParam, _ImageTemplateParam]]],
+        template_format: str = "f-string",
+        **kwargs: Any,
+    ) -> _StringImageMessagePromptTemplateT:
+        """Create a class from a string template.
+
+        Args:
+            template: a template.
+            template_format: format of the template.
+            **kwargs: keyword arguments to pass to the constructor.
+
+        Returns:
+            A new instance of this class.
+        """
+        if isinstance(template, str):
+            prompt: Union[StringPromptTemplate, List] = PromptTemplate.from_template(
+                template, template_format=template_format
+            )
+            return cls(prompt=prompt, **kwargs)
+        elif isinstance(template, list):
+            prompt = []
+            for tmpl in template:
+                if isinstance(tmpl, str) or isinstance(tmpl, dict) and "text" in tmpl:
+                    if isinstance(tmpl, str):
+                        text: str = tmpl
+                    else:
+                        text = cast(_TextTemplateParam, tmpl)["text"]  # type: ignore[assignment]  # noqa: E501
+                    prompt.append(
+                        PromptTemplate.from_template(
+                            text, template_format=template_format
+                        )
+                    )
+                elif isinstance(tmpl, dict) and "image_url" in tmpl:
+                    img_template = cast(_ImageTemplateParam, tmpl)["image_url"]
+                    if isinstance(img_template, str):
+                        vars = get_template_variables(img_template, "f-string")
+                        if vars:
+                            if len(vars) > 1:
+                                raise ValueError(
+                                    "Only one format variable allowed per image"
+                                    f" template.\nGot: {vars}"
+                                    f"\nFrom: {tmpl}"
+                                )
+                            input_variables = [vars[0]]
+                        else:
+                            input_variables = None
+                        img_template = {"url": img_template}
+                        img_template_obj = ImagePromptTemplate(
+                            input_variables=input_variables, template=img_template
+                        )
+                    elif isinstance(img_template, dict):
+                        img_template = dict(img_template)
+                        if "url" in img_template:
+                            input_variables = get_template_variables(
+                                img_template["url"], "f-string"
+                            )
+                        else:
+                            input_variables = None
+                        img_template_obj = ImagePromptTemplate(
+                            input_variables=input_variables, template=img_template
+                        )
+                    else:
+                        raise ValueError()
+                    prompt.append(img_template_obj)
+                else:
+                    raise ValueError()
+            return cls(prompt=prompt, **kwargs)
+        else:
+            raise ValueError()
+
+    @classmethod
+    def from_template_file(
+        cls: Type[_StringImageMessagePromptTemplateT],
+        template_file: Union[str, Path],
+        input_variables: List[str],
+        **kwargs: Any,
+    ) -> _StringImageMessagePromptTemplateT:
+        """Create a class from a template file.
+
+        Args:
+            template_file: path to a template file. String or Path.
+            input_variables: list of input variables.
+            **kwargs: keyword arguments to pass to the constructor.
+
+        Returns:
+            A new instance of this class.
+        """
+        with open(str(template_file), "r") as f:
+            template = f.read()
+        return cls.from_template(template, input_variables=input_variables, **kwargs)
+
+    def format_messages(self, **kwargs: Any) -> List[BaseMessage]:
+        """Format messages from kwargs.
+
+        Args:
+            **kwargs: Keyword arguments to use for formatting.
+
+        Returns:
+            List of BaseMessages.
+        """
+        return [self.format(**kwargs)]
+
+    async def aformat_messages(self, **kwargs: Any) -> List[BaseMessage]:
+        return [await self.aformat(**kwargs)]
+
+    @property
+    def input_variables(self) -> List[str]:
+        """
+        Input variables for this prompt template.
+
+        Returns:
+            List of input variable names.
+        """
+        prompts = self.prompt if isinstance(self.prompt, list) else [self.prompt]
+        input_variables = [iv for prompt in prompts for iv in prompt.input_variables]
+        return input_variables
+
+    def format(self, **kwargs: Any) -> BaseMessage:
+        """Format the prompt template.
+
+        Args:
+            **kwargs: Keyword arguments to use for formatting.
+
+        Returns:
+            Formatted message.
+        """
+        if isinstance(self.prompt, StringPromptTemplate):
+            text = self.prompt.format(**kwargs)
+            return self._msg_class(
+                content=text, additional_kwargs=self.additional_kwargs
+            )
+        else:
+            content: List = []
+            for prompt in self.prompt:
+                inputs = {var: kwargs[var] for var in prompt.input_variables}
+                if isinstance(prompt, StringPromptTemplate):
+                    formatted: Union[str, ImageURL] = prompt.format(**inputs)
+                    content.append({"type": "text", "text": formatted})
+                elif isinstance(prompt, ImagePromptTemplate):
+                    formatted = prompt.format(**inputs)
+                    content.append({"type": "image_url", "image_url": formatted})
+            return self._msg_class(
+                content=content, additional_kwargs=self.additional_kwargs
+            )
+
+    async def aformat(self, **kwargs: Any) -> BaseMessage:
+        """Format the prompt template.
+
+        Args:
+            **kwargs: Keyword arguments to use for formatting.
+
+        Returns:
+            Formatted message.
+        """
+        if isinstance(self.prompt, StringPromptTemplate):
+            text = await self.prompt.aformat(**kwargs)
+            return self._msg_class(
+                content=text, additional_kwargs=self.additional_kwargs
+            )
+        else:
+            content: List = []
+            for prompt in self.prompt:
+                inputs = {var: kwargs[var] for var in prompt.input_variables}
+                if isinstance(prompt, StringPromptTemplate):
+                    formatted: Union[str, ImageURL] = await prompt.aformat(**inputs)
+                    content.append({"type": "text", "text": formatted})
+                elif isinstance(prompt, ImagePromptTemplate):
+                    formatted = await prompt.aformat(**inputs)
+                    content.append({"type": "image_url", "image_url": formatted})
+            return self._msg_class(
+                content=content, additional_kwargs=self.additional_kwargs
+            )
+
+    def pretty_repr(self, html: bool = False) -> str:
+        # TODO: Handle partials
+        title = self.__class__.__name__.replace("MessagePromptTemplate", " Message")
+        title = get_msg_title_repr(title, bold=html)
+        prompts = self.prompt if isinstance(self.prompt, list) else [self.prompt]
+        prompt_reprs = "\n\n".join(prompt.pretty_repr(html=html) for prompt in prompts)
+        return f"{title}\n\n{prompt_reprs}"
+
+
+class HumanMessagePromptTemplate(_StringImageMessagePromptTemplate):
+    """Human message prompt template. This is a message sent from the user."""
+
+    _msg_class: Type[BaseMessage] = HumanMessage
+
+
+class AIMessagePromptTemplate(_StringImageMessagePromptTemplate):
+    """AI message prompt template. This is a message sent from the AI."""
+
+    _msg_class: Type[BaseMessage] = AIMessage
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "chat"]
+
+
+class SystemMessagePromptTemplate(_StringImageMessagePromptTemplate):
+    """System message prompt template.
+    This is a message that is not sent to the user.
+    """
+
+    _msg_class: Type[BaseMessage] = SystemMessage
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "chat"]
+
+
+class BaseChatPromptTemplate(BasePromptTemplate, ABC):
+    """Base class for chat prompt templates."""
+
+    @property
+    def lc_attributes(self) -> Dict:
+        """
+        Return a list of attribute names that should be included in the
+        serialized kwargs. These attributes must be accepted by the
+        constructor.
+        """
+        return {"input_variables": self.input_variables}
+
+    def format(self, **kwargs: Any) -> str:
+        """Format the chat template into a string.
+
+        Args:
+            **kwargs: keyword arguments to use for filling in template variables
+                      in all the template messages in this chat template.
+
+        Returns:
+            formatted string
+        """
+        return self.format_prompt(**kwargs).to_string()
+
+    async def aformat(self, **kwargs: Any) -> str:
+        """Format the chat template into a string.
+
+        Args:
+            **kwargs: keyword arguments to use for filling in template variables
+                      in all the template messages in this chat template.
+
+        Returns:
+            formatted string
+        """
+        return (await self.aformat_prompt(**kwargs)).to_string()
+
+    def format_prompt(self, **kwargs: Any) -> PromptValue:
+        """
+        Format prompt. Should return a PromptValue.
+        Args:
+            **kwargs: Keyword arguments to use for formatting.
+
+        Returns:
+            PromptValue.
+        """
+        messages = self.format_messages(**kwargs)
+        return ChatPromptValue(messages=messages)
+
+    async def aformat_prompt(self, **kwargs: Any) -> PromptValue:
+        messages = await self.aformat_messages(**kwargs)
+        return ChatPromptValue(messages=messages)
+
+    @abstractmethod
+    def format_messages(self, **kwargs: Any) -> List[BaseMessage]:
+        """Format kwargs into a list of messages."""
+
+    async def aformat_messages(self, **kwargs: Any) -> List[BaseMessage]:
+        """Format kwargs into a list of messages."""
+        return self.format_messages(**kwargs)
+
+    def pretty_repr(self, html: bool = False) -> str:
+        """Human-readable representation."""
+        raise NotImplementedError
+
+    def pretty_print(self) -> None:
+        print(self.pretty_repr(html=is_interactive_env()))  # noqa: T201
+
+
+MessageLike = Union[BaseMessagePromptTemplate, BaseMessage, BaseChatPromptTemplate]
+
+MessageLikeRepresentation = Union[
+    MessageLike,
+    Tuple[
+        Union[str, Type],
+        Union[str, List[dict], List[object]],
+    ],
+    str,
+]
+
+
+class ChatPromptTemplate(BaseChatPromptTemplate):
+    """Prompt template for chat models.
+
+    Use to create flexible templated prompts for chat models.
+
+    Examples:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import ChatPromptTemplate
+
+            template = ChatPromptTemplate.from_messages([
+                ("system", "You are a helpful AI bot. Your name is {name}."),
+                ("human", "Hello, how are you doing?"),
+                ("ai", "I'm doing well, thanks!"),
+                ("human", "{user_input}"),
+            ])
+
+            prompt_value = template.invoke(
+                {
+                    "name": "Bob",
+                    "user_input": "What is your name?"
+                }
+            )
+            # Output:
+            # ChatPromptValue(
+            #    messages=[
+            #        SystemMessage(content='You are a helpful AI bot. Your name is Bob.'),
+            #        HumanMessage(content='Hello, how are you doing?'),
+            #        AIMessage(content="I'm doing well, thanks!"),
+            #        HumanMessage(content='What is your name?')
+            #    ]
+            #)
+
+    Messages Placeholder:
+
+        .. code-block:: python
+
+            # In addition to Human/AI/Tool/Function messages,
+            # you can initialize the template with a MessagesPlaceholder
+            # either using the class directly or with the shorthand tuple syntax:
+
+            template = ChatPromptTemplate.from_messages([
+                ("system", "You are a helpful AI bot."),
+                # Means the template will receive an optional list of messages under
+                # the "conversation" key
+                ("placeholder", "{conversation}")
+                # Equivalently:
+                # MessagesPlaceholder(variable_name="conversation", optional=True)
+            ])
+
+            prompt_value = template.invoke(
+                {
+                    "conversation": [
+                        ("human", "Hi!"),
+                        ("ai", "How can I assist you today?"),
+                        ("human", "Can you make me an ice cream sundae?"),
+                        ("ai", "No.")
+                    ]
+                }
+            )
+
+            # Output:
+            # ChatPromptValue(
+            #    messages=[
+            #        SystemMessage(content='You are a helpful AI bot.'),
+            #        HumanMessage(content='Hi!'),
+            #        AIMessage(content='How can I assist you today?'),
+            #        HumanMessage(content='Can you make me an ice cream sundae?'),
+            #        AIMessage(content='No.'),
+            #    ]
+            #)
+
+    Single-variable template:
+
+        If your prompt has only a single input variable (i.e., 1 instance of "{variable_nams}"),
+        and you invoke the template with a non-dict object, the prompt template will
+        inject the provided argument into that variable location.
+
+
+        .. code-block:: python
+
+            from langchain_core.prompts import ChatPromptTemplate
+
+            template = ChatPromptTemplate.from_messages([
+                ("system", "You are a helpful AI bot. Your name is Carl."),
+                ("human", "{user_input}"),
+            ])
+
+            prompt_value = template.invoke("Hello, there!")
+            # Equivalent to
+            # prompt_value = template.invoke({"user_input": "Hello, there!"})
+
+            # Output:
+            #  ChatPromptValue(
+            #     messages=[
+            #         SystemMessage(content='You are a helpful AI bot. Your name is Carl.'),
+            #         HumanMessage(content='Hello, there!'),
+            #     ]
+            # )
+
+    """  # noqa: E501
+
+    input_variables: List[str]
+    """List of input variables in template messages. Used for validation."""
+    messages: List[MessageLike]
+    """List of messages consisting of either message prompt templates or messages."""
+    validate_template: bool = False
+    """Whether or not to try validating the template."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "chat"]
+
+    def __add__(self, other: Any) -> ChatPromptTemplate:
+        """Combine two prompt templates.
+
+        Args:
+            other: Another prompt template.
+
+        Returns:
+            Combined prompt template.
+        """
+        # Allow for easy combining
+        if isinstance(other, ChatPromptTemplate):
+            return ChatPromptTemplate(messages=self.messages + other.messages)  # type: ignore[call-arg]
+        elif isinstance(
+            other, (BaseMessagePromptTemplate, BaseMessage, BaseChatPromptTemplate)
+        ):
+            return ChatPromptTemplate(messages=self.messages + [other])  # type: ignore[call-arg]
+        elif isinstance(other, (list, tuple)):
+            _other = ChatPromptTemplate.from_messages(other)
+            return ChatPromptTemplate(messages=self.messages + _other.messages)  # type: ignore[call-arg]
+        elif isinstance(other, str):
+            prompt = HumanMessagePromptTemplate.from_template(other)
+            return ChatPromptTemplate(messages=self.messages + [prompt])  # type: ignore[call-arg]
+        else:
+            raise NotImplementedError(f"Unsupported operand type for +: {type(other)}")
+
+    @root_validator(pre=True)
+    def validate_input_variables(cls, values: dict) -> dict:
+        """Validate input variables.
+
+        If input_variables is not set, it will be set to the union of
+        all input variables in the messages.
+
+        Args:
+            values: values to validate.
+
+        Returns:
+            Validated values.
+        """
+        messages = values["messages"]
+        input_vars = set()
+        input_types: Dict[str, Any] = values.get("input_types", {})
+        for message in messages:
+            if isinstance(message, (BaseMessagePromptTemplate, BaseChatPromptTemplate)):
+                input_vars.update(message.input_variables)
+            if isinstance(message, MessagesPlaceholder):
+                if message.variable_name not in input_types:
+                    input_types[message.variable_name] = List[AnyMessage]
+        if "partial_variables" in values:
+            input_vars = input_vars - set(values["partial_variables"])
+        if "input_variables" in values and values.get("validate_template"):
+            if input_vars != set(values["input_variables"]):
+                raise ValueError(
+                    "Got mismatched input_variables. "
+                    f"Expected: {input_vars}. "
+                    f"Got: {values['input_variables']}"
+                )
+        else:
+            values["input_variables"] = sorted(input_vars)
+        values["input_types"] = input_types
+        return values
+
+    @classmethod
+    def from_template(cls, template: str, **kwargs: Any) -> ChatPromptTemplate:
+        """Create a chat prompt template from a template string.
+
+        Creates a chat template consisting of a single message assumed to be from
+        the human.
+
+        Args:
+            template: template string
+            **kwargs: keyword arguments to pass to the constructor.
+
+        Returns:
+            A new instance of this class.
+        """
+        prompt_template = PromptTemplate.from_template(template, **kwargs)
+        message = HumanMessagePromptTemplate(prompt=prompt_template)
+        return cls.from_messages([message])
+
+    @classmethod
+    @deprecated("0.0.1", alternative="from_messages classmethod", pending=True)
+    def from_role_strings(
+        cls, string_messages: List[Tuple[str, str]]
+    ) -> ChatPromptTemplate:
+        """Create a chat prompt template from a list of (role, template) tuples.
+
+        Args:
+            string_messages: list of (role, template) tuples.
+
+        Returns:
+            a chat prompt template
+        """
+        return cls(  # type: ignore[call-arg]
+            messages=[
+                ChatMessagePromptTemplate.from_template(template, role=role)
+                for role, template in string_messages
+            ]
+        )
+
+    @classmethod
+    @deprecated("0.0.1", alternative="from_messages classmethod", pending=True)
+    def from_strings(
+        cls, string_messages: List[Tuple[Type[BaseMessagePromptTemplate], str]]
+    ) -> ChatPromptTemplate:
+        """Create a chat prompt template from a list of (role class, template) tuples.
+
+        Args:
+            string_messages: list of (role class, template) tuples.
+
+        Returns:
+            a chat prompt template
+        """
+        return cls.from_messages(string_messages)
+
+    @classmethod
+    def from_messages(
+        cls,
+        messages: Sequence[MessageLikeRepresentation],
+        template_format: Literal["f-string", "mustache"] = "f-string",
+    ) -> ChatPromptTemplate:
+        """Create a chat prompt template from a variety of message formats.
+
+        Examples:
+
+            Instantiation from a list of message templates:
+
+            .. code-block:: python
+
+                template = ChatPromptTemplate.from_messages([
+                    ("human", "Hello, how are you?"),
+                    ("ai", "I'm doing well, thanks!"),
+                    ("human", "That's good to hear."),
+                ])
+
+            Instantiation from mixed message formats:
+
+            .. code-block:: python
+
+                template = ChatPromptTemplate.from_messages([
+                    SystemMessage(content="hello"),
+                    ("human", "Hello, how are you?"),
+                ])
+
+        Args:
+            messages: sequence of message representations.
+                  A message can be represented using the following formats:
+                  (1) BaseMessagePromptTemplate, (2) BaseMessage, (3) 2-tuple of
+                  (message type, template); e.g., ("human", "{user_input}"),
+                  (4) 2-tuple of (message class, template), (4) a string which is
+                  shorthand for ("human", template); e.g., "{user_input}"
+
+        Returns:
+            a chat prompt template
+        """
+        _messages = [
+            _convert_to_message(message, template_format) for message in messages
+        ]
+
+        # Automatically infer input variables from messages
+        input_vars: Set[str] = set()
+        partial_vars: Dict[str, Any] = {}
+        for _message in _messages:
+            if isinstance(_message, MessagesPlaceholder) and _message.optional:
+                partial_vars[_message.variable_name] = []
+            elif isinstance(
+                _message, (BaseChatPromptTemplate, BaseMessagePromptTemplate)
+            ):
+                input_vars.update(_message.input_variables)
+
+        return cls(
+            input_variables=sorted(input_vars),
+            messages=_messages,
+            partial_variables=partial_vars,
+        )
+
+    def format_messages(self, **kwargs: Any) -> List[BaseMessage]:
+        """Format the chat template into a list of finalized messages.
+
+        Args:
+            **kwargs: keyword arguments to use for filling in template variables
+                      in all the template messages in this chat template.
+
+        Returns:
+            list of formatted messages
+        """
+        kwargs = self._merge_partial_and_user_variables(**kwargs)
+        result = []
+        for message_template in self.messages:
+            if isinstance(message_template, BaseMessage):
+                result.extend([message_template])
+            elif isinstance(
+                message_template, (BaseMessagePromptTemplate, BaseChatPromptTemplate)
+            ):
+                message = message_template.format_messages(**kwargs)
+                result.extend(message)
+            else:
+                raise ValueError(f"Unexpected input: {message_template}")
+        return result
+
+    async def aformat_messages(self, **kwargs: Any) -> List[BaseMessage]:
+        """Format the chat template into a list of finalized messages.
+
+        Args:
+            **kwargs: keyword arguments to use for filling in template variables
+                      in all the template messages in this chat template.
+
+        Returns:
+            list of formatted messages
+        """
+        kwargs = self._merge_partial_and_user_variables(**kwargs)
+        result = []
+        for message_template in self.messages:
+            if isinstance(message_template, BaseMessage):
+                result.extend([message_template])
+            elif isinstance(
+                message_template, (BaseMessagePromptTemplate, BaseChatPromptTemplate)
+            ):
+                message = await message_template.aformat_messages(**kwargs)
+                result.extend(message)
+            else:
+                raise ValueError(f"Unexpected input: {message_template}")
+        return result
+
+    def partial(self, **kwargs: Any) -> ChatPromptTemplate:
+        """Get a new ChatPromptTemplate with some input variables already filled in.
+
+        Args:
+            **kwargs: keyword arguments to use for filling in template variables. Ought
+                        to be a subset of the input variables.
+
+        Returns:
+            A new ChatPromptTemplate.
+
+
+        Example:
+
+            .. code-block:: python
+
+                from langchain_core.prompts import ChatPromptTemplate
+
+                template = ChatPromptTemplate.from_messages(
+                    [
+                        ("system", "You are an AI assistant named {name}."),
+                        ("human", "Hi I'm {user}"),
+                        ("ai", "Hi there, {user}, I'm {name}."),
+                        ("human", "{input}"),
+                    ]
+                )
+                template2 = template.partial(user="Lucy", name="R2D2")
+
+                template2.format_messages(input="hello")
+        """
+        prompt_dict = self.__dict__.copy()
+        prompt_dict["input_variables"] = list(
+            set(self.input_variables).difference(kwargs)
+        )
+        prompt_dict["partial_variables"] = {**self.partial_variables, **kwargs}
+        return type(self)(**prompt_dict)
+
+    def append(self, message: MessageLikeRepresentation) -> None:
+        """Append message to the end of the chat template.
+
+        Args:
+            message: representation of a message to append.
+        """
+        self.messages.append(_convert_to_message(message))
+
+    def extend(self, messages: Sequence[MessageLikeRepresentation]) -> None:
+        """Extend the chat template with a sequence of messages."""
+        self.messages.extend([_convert_to_message(message) for message in messages])
+
+    @overload
+    def __getitem__(self, index: int) -> MessageLike:
+        ...
+
+    @overload
+    def __getitem__(self, index: slice) -> ChatPromptTemplate:
+        ...
+
+    def __getitem__(
+        self, index: Union[int, slice]
+    ) -> Union[MessageLike, ChatPromptTemplate]:
+        """Use to index into the chat template."""
+        if isinstance(index, slice):
+            start, stop, step = index.indices(len(self.messages))
+            messages = self.messages[start:stop:step]
+            return ChatPromptTemplate.from_messages(messages)
+        else:
+            return self.messages[index]
+
+    def __len__(self) -> int:
+        """Get the length of the chat template."""
+        return len(self.messages)
+
+    @property
+    def _prompt_type(self) -> str:
+        """Name of prompt type."""
+        return "chat"
+
+    def save(self, file_path: Union[Path, str]) -> None:
+        """Save prompt to file.
+
+        Args:
+            file_path: path to file.
+        """
+        raise NotImplementedError()
+
+    def pretty_repr(self, html: bool = False) -> str:
+        # TODO: handle partials
+        return "\n\n".join(msg.pretty_repr(html=html) for msg in self.messages)
+
+
+def _create_template_from_message_type(
+    message_type: str,
+    template: Union[str, list],
+    template_format: Literal["f-string", "mustache"] = "f-string",
+) -> BaseMessagePromptTemplate:
+    """Create a message prompt template from a message type and template string.
+
+    Args:
+        message_type: str the type of the message template (e.g., "human", "ai", etc.)
+        template: str the template string.
+
+    Returns:
+        a message prompt template of the appropriate type.
+    """
+    if message_type in ("human", "user"):
+        message: BaseMessagePromptTemplate = HumanMessagePromptTemplate.from_template(
+            template, template_format=template_format
+        )
+    elif message_type in ("ai", "assistant"):
+        message = AIMessagePromptTemplate.from_template(
+            cast(str, template), template_format=template_format
+        )
+    elif message_type == "system":
+        message = SystemMessagePromptTemplate.from_template(
+            cast(str, template), template_format=template_format
+        )
+    elif message_type == "placeholder":
+        if isinstance(template, str):
+            if template[0] != "{" or template[-1] != "}":
+                raise ValueError(
+                    f"Invalid placeholder template: {template}."
+                    " Expected a variable name surrounded by curly braces."
+                )
+            var_name = template[1:-1]
+            message = MessagesPlaceholder(variable_name=var_name, optional=True)
+        elif len(template) == 2 and isinstance(template[1], bool):
+            var_name_wrapped, is_optional = template
+            if not isinstance(var_name_wrapped, str):
+                raise ValueError(
+                    "Expected variable name to be a string." f" Got: {var_name_wrapped}"
+                )
+            if var_name_wrapped[0] != "{" or var_name_wrapped[-1] != "}":
+                raise ValueError(
+                    f"Invalid placeholder template: {var_name_wrapped}."
+                    " Expected a variable name surrounded by curly braces."
+                )
+            var_name = var_name_wrapped[1:-1]
+
+            message = MessagesPlaceholder(variable_name=var_name, optional=is_optional)
+        else:
+            raise ValueError(
+                "Unexpected arguments for placeholder message type."
+                " Expected either a single string variable name"
+                " or a list of [variable_name: str, is_optional: bool]."
+                f" Got: {template}"
+            )
+    else:
+        raise ValueError(
+            f"Unexpected message type: {message_type}. Use one of 'human',"
+            f" 'user', 'ai', 'assistant', or 'system'."
+        )
+    return message
+
+
+def _convert_to_message(
+    message: MessageLikeRepresentation,
+    template_format: Literal["f-string", "mustache"] = "f-string",
+) -> Union[BaseMessage, BaseMessagePromptTemplate, BaseChatPromptTemplate]:
+    """Instantiate a message from a variety of message formats.
+
+    The message format can be one of the following:
+
+    - BaseMessagePromptTemplate
+    - BaseMessage
+    - 2-tuple of (role string, template); e.g., ("human", "{user_input}")
+    - 2-tuple of (message class, template)
+    - string: shorthand for ("human", template); e.g., "{user_input}"
+
+    Args:
+        message: a representation of a message in one of the supported formats
+
+    Returns:
+        an instance of a message or a message template
+    """
+    if isinstance(message, (BaseMessagePromptTemplate, BaseChatPromptTemplate)):
+        _message: Union[
+            BaseMessage, BaseMessagePromptTemplate, BaseChatPromptTemplate
+        ] = message
+    elif isinstance(message, BaseMessage):
+        _message = message
+    elif isinstance(message, str):
+        _message = _create_template_from_message_type(
+            "human", message, template_format=template_format
+        )
+    elif isinstance(message, tuple):
+        if len(message) != 2:
+            raise ValueError(f"Expected 2-tuple of (role, template), got {message}")
+        message_type_str, template = message
+        if isinstance(message_type_str, str):
+            _message = _create_template_from_message_type(
+                message_type_str, template, template_format=template_format
+            )
+        else:
+            _message = message_type_str(
+                prompt=PromptTemplate.from_template(
+                    cast(str, template), template_format=template_format
+                )
+            )
+    else:
+        raise NotImplementedError(f"Unsupported message type: {type(message)}")
+
+    return _message
diff --git a/llm/Lib/site-packages/langchain_core/prompts/few_shot.py b/llm/Lib/site-packages/langchain_core/prompts/few_shot.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf0d55f84e76c8cc0a8adcc6ec93637e0d714d8a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/prompts/few_shot.py
@@ -0,0 +1,395 @@
+"""Prompt template that contains few shot examples."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any, Dict, List, Literal, Optional, Union
+
+from langchain_core.example_selectors import BaseExampleSelector
+from langchain_core.messages import BaseMessage, get_buffer_string
+from langchain_core.prompts.chat import (
+    BaseChatPromptTemplate,
+    BaseMessagePromptTemplate,
+)
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.prompts.string import (
+    DEFAULT_FORMATTER_MAPPING,
+    StringPromptTemplate,
+    check_valid_template,
+    get_template_variables,
+)
+from langchain_core.pydantic_v1 import BaseModel, Extra, Field, root_validator
+
+
+class _FewShotPromptTemplateMixin(BaseModel):
+    """Prompt template that contains few shot examples."""
+
+    examples: Optional[List[dict]] = None
+    """Examples to format into the prompt.
+    Either this or example_selector should be provided."""
+
+    example_selector: Optional[BaseExampleSelector] = None
+    """ExampleSelector to choose the examples to format into the prompt.
+    Either this or examples should be provided."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    @root_validator(pre=True)
+    def check_examples_and_selector(cls, values: Dict) -> Dict:
+        """Check that one and only one of examples/example_selector are provided."""
+        examples = values.get("examples", None)
+        example_selector = values.get("example_selector", None)
+        if examples and example_selector:
+            raise ValueError(
+                "Only one of 'examples' and 'example_selector' should be provided"
+            )
+
+        if examples is None and example_selector is None:
+            raise ValueError(
+                "One of 'examples' and 'example_selector' should be provided"
+            )
+
+        return values
+
+    def _get_examples(self, **kwargs: Any) -> List[dict]:
+        """Get the examples to use for formatting the prompt.
+
+        Args:
+            **kwargs: Keyword arguments to be passed to the example selector.
+
+        Returns:
+            List of examples.
+        """
+        if self.examples is not None:
+            return self.examples
+        elif self.example_selector is not None:
+            return self.example_selector.select_examples(kwargs)
+        else:
+            raise ValueError(
+                "One of 'examples' and 'example_selector' should be provided"
+            )
+
+    async def _aget_examples(self, **kwargs: Any) -> List[dict]:
+        """Get the examples to use for formatting the prompt.
+
+        Args:
+            **kwargs: Keyword arguments to be passed to the example selector.
+
+        Returns:
+            List of examples.
+        """
+        if self.examples is not None:
+            return self.examples
+        elif self.example_selector is not None:
+            return await self.example_selector.aselect_examples(kwargs)
+        else:
+            raise ValueError(
+                "One of 'examples' and 'example_selector' should be provided"
+            )
+
+
+class FewShotPromptTemplate(_FewShotPromptTemplateMixin, StringPromptTemplate):
+    """Prompt template that contains few shot examples."""
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether or not the class is serializable."""
+        return False
+
+    validate_template: bool = False
+    """Whether or not to try validating the template."""
+
+    input_variables: List[str]
+    """A list of the names of the variables the prompt template expects."""
+
+    example_prompt: PromptTemplate
+    """PromptTemplate used to format an individual example."""
+
+    suffix: str
+    """A prompt template string to put after the examples."""
+
+    example_separator: str = "\n\n"
+    """String separator used to join the prefix, the examples, and suffix."""
+
+    prefix: str = ""
+    """A prompt template string to put before the examples."""
+
+    template_format: Literal["f-string", "jinja2"] = "f-string"
+    """The format of the prompt template. Options are: 'f-string', 'jinja2'."""
+
+    @root_validator()
+    def template_is_valid(cls, values: Dict) -> Dict:
+        """Check that prefix, suffix, and input variables are consistent."""
+        if values["validate_template"]:
+            check_valid_template(
+                values["prefix"] + values["suffix"],
+                values["template_format"],
+                values["input_variables"] + list(values["partial_variables"]),
+            )
+        elif values.get("template_format"):
+            values["input_variables"] = [
+                var
+                for var in get_template_variables(
+                    values["prefix"] + values["suffix"], values["template_format"]
+                )
+                if var not in values["partial_variables"]
+            ]
+        return values
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    def format(self, **kwargs: Any) -> str:
+        kwargs = self._merge_partial_and_user_variables(**kwargs)
+        # Get the examples to use.
+        examples = self._get_examples(**kwargs)
+        examples = [
+            {k: e[k] for k in self.example_prompt.input_variables} for e in examples
+        ]
+        # Format the examples.
+        example_strings = [
+            self.example_prompt.format(**example) for example in examples
+        ]
+        # Create the overall template.
+        pieces = [self.prefix, *example_strings, self.suffix]
+        template = self.example_separator.join([piece for piece in pieces if piece])
+
+        # Format the template with the input variables.
+        return DEFAULT_FORMATTER_MAPPING[self.template_format](template, **kwargs)
+
+    async def aformat(self, **kwargs: Any) -> str:
+        kwargs = self._merge_partial_and_user_variables(**kwargs)
+        # Get the examples to use.
+        examples = await self._aget_examples(**kwargs)
+        examples = [
+            {k: e[k] for k in self.example_prompt.input_variables} for e in examples
+        ]
+        # Format the examples.
+        example_strings = [
+            await self.example_prompt.aformat(**example) for example in examples
+        ]
+        # Create the overall template.
+        pieces = [self.prefix, *example_strings, self.suffix]
+        template = self.example_separator.join([piece for piece in pieces if piece])
+
+        # Format the template with the input variables.
+        return DEFAULT_FORMATTER_MAPPING[self.template_format](template, **kwargs)
+
+    @property
+    def _prompt_type(self) -> str:
+        """Return the prompt type key."""
+        return "few_shot"
+
+    def save(self, file_path: Union[Path, str]) -> None:
+        if self.example_selector:
+            raise ValueError("Saving an example selector is not currently supported")
+        return super().save(file_path)
+
+
+class FewShotChatMessagePromptTemplate(
+    BaseChatPromptTemplate, _FewShotPromptTemplateMixin
+):
+    """Chat prompt template that supports few-shot examples.
+
+    The high level structure of produced by this prompt template is a list of messages
+    consisting of prefix message(s), example message(s), and suffix message(s).
+
+    This structure enables creating a conversation with intermediate examples like:
+
+        System: You are a helpful AI Assistant
+        Human: What is 2+2?
+        AI: 4
+        Human: What is 2+3?
+        AI: 5
+        Human: What is 4+4?
+
+    This prompt template can be used to generate a fixed list of examples or else
+    to dynamically select examples based on the input.
+
+    Examples:
+
+        Prompt template with a fixed list of examples (matching the sample
+        conversation above):
+
+        .. code-block:: python
+
+            from langchain_core.prompts import (
+                FewShotChatMessagePromptTemplate,
+                ChatPromptTemplate
+            )
+
+            examples = [
+                {"input": "2+2", "output": "4"},
+                {"input": "2+3", "output": "5"},
+            ]
+
+            example_prompt = ChatPromptTemplate.from_messages(
+                [('human', '{input}'), ('ai', '{output}')]
+            )
+
+            few_shot_prompt = FewShotChatMessagePromptTemplate(
+                examples=examples,
+                # This is a prompt template used to format each individual example.
+                example_prompt=example_prompt,
+            )
+
+            final_prompt = ChatPromptTemplate.from_messages(
+                [
+                    ('system', 'You are a helpful AI Assistant'),
+                    few_shot_prompt,
+                    ('human', '{input}'),
+                ]
+            )
+            final_prompt.format(input="What is 4+4?")
+
+        Prompt template with dynamically selected examples:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import SemanticSimilarityExampleSelector
+            from langchain_core.embeddings import OpenAIEmbeddings
+            from langchain_core.vectorstores import Chroma
+
+            examples = [
+                {"input": "2+2", "output": "4"},
+                {"input": "2+3", "output": "5"},
+                {"input": "2+4", "output": "6"},
+                # ...
+            ]
+
+            to_vectorize = [
+                " ".join(example.values())
+                for example in examples
+            ]
+            embeddings = OpenAIEmbeddings()
+            vectorstore = Chroma.from_texts(
+                to_vectorize, embeddings, metadatas=examples
+            )
+            example_selector = SemanticSimilarityExampleSelector(
+                vectorstore=vectorstore
+            )
+
+            from langchain_core import SystemMessage
+            from langchain_core.prompts import HumanMessagePromptTemplate
+            from langchain_core.prompts.few_shot import FewShotChatMessagePromptTemplate
+
+            few_shot_prompt = FewShotChatMessagePromptTemplate(
+                # Which variable(s) will be passed to the example selector.
+                input_variables=["input"],
+                example_selector=example_selector,
+                # Define how each example will be formatted.
+                # In this case, each example will become 2 messages:
+                # 1 human, and 1 AI
+                example_prompt=(
+                    HumanMessagePromptTemplate.from_template("{input}")
+                    + AIMessagePromptTemplate.from_template("{output}")
+                ),
+            )
+            # Define the overall prompt.
+            final_prompt = (
+                SystemMessagePromptTemplate.from_template(
+                    "You are a helpful AI Assistant"
+                )
+                + few_shot_prompt
+                + HumanMessagePromptTemplate.from_template("{input}")
+            )
+            # Show the prompt
+            print(final_prompt.format_messages(input="What's 3+3?"))  # noqa: T201
+
+            # Use within an LLM
+            from langchain_core.chat_models import ChatAnthropic
+            chain = final_prompt | ChatAnthropic()
+            chain.invoke({"input": "What's 3+3?"})
+    """
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether or not the class is serializable."""
+        return False
+
+    input_variables: List[str] = Field(default_factory=list)
+    """A list of the names of the variables the prompt template will use
+    to pass to the example_selector, if provided."""
+    example_prompt: Union[BaseMessagePromptTemplate, BaseChatPromptTemplate]
+    """The class to format each example."""
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    def format_messages(self, **kwargs: Any) -> List[BaseMessage]:
+        """Format kwargs into a list of messages.
+
+        Args:
+            **kwargs: keyword arguments to use for filling in templates in messages.
+
+        Returns:
+            A list of formatted messages with all template variables filled in.
+        """
+        # Get the examples to use.
+        examples = self._get_examples(**kwargs)
+        examples = [
+            {k: e[k] for k in self.example_prompt.input_variables} for e in examples
+        ]
+        # Format the examples.
+        messages = [
+            message
+            for example in examples
+            for message in self.example_prompt.format_messages(**example)
+        ]
+        return messages
+
+    async def aformat_messages(self, **kwargs: Any) -> List[BaseMessage]:
+        """Format kwargs into a list of messages.
+
+        Args:
+            **kwargs: keyword arguments to use for filling in templates in messages.
+
+        Returns:
+            A list of formatted messages with all template variables filled in.
+        """
+        # Get the examples to use.
+        examples = await self._aget_examples(**kwargs)
+        examples = [
+            {k: e[k] for k in self.example_prompt.input_variables} for e in examples
+        ]
+        # Format the examples.
+        messages = [
+            message
+            for example in examples
+            for message in await self.example_prompt.aformat_messages(**example)
+        ]
+        return messages
+
+    def format(self, **kwargs: Any) -> str:
+        """Format the prompt with inputs generating a string.
+
+        Use this method to generate a string representation of a prompt consisting
+        of chat messages.
+
+        Useful for feeding into a string based completion language model or debugging.
+
+        Args:
+            **kwargs: keyword arguments to use for formatting.
+
+        Returns:
+            A string representation of the prompt
+        """
+        messages = self.format_messages(**kwargs)
+        return get_buffer_string(messages)
+
+    async def aformat(self, **kwargs: Any) -> str:
+        messages = await self.aformat_messages(**kwargs)
+        return get_buffer_string(messages)
+
+    def pretty_repr(self, html: bool = False) -> str:
+        raise NotImplementedError()
diff --git a/llm/Lib/site-packages/langchain_core/prompts/few_shot_with_templates.py b/llm/Lib/site-packages/langchain_core/prompts/few_shot_with_templates.py
new file mode 100644
index 0000000000000000000000000000000000000000..a6724a179adafc7eb712fa2c5a672b231f75eb2a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/prompts/few_shot_with_templates.py
@@ -0,0 +1,204 @@
+"""Prompt template that contains few shot examples."""
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Union
+
+from langchain_core.prompts.prompt import PromptTemplate
+from langchain_core.prompts.string import (
+    DEFAULT_FORMATTER_MAPPING,
+    StringPromptTemplate,
+)
+from langchain_core.pydantic_v1 import Extra, root_validator
+
+
+class FewShotPromptWithTemplates(StringPromptTemplate):
+    """Prompt template that contains few shot examples."""
+
+    examples: Optional[List[dict]] = None
+    """Examples to format into the prompt.
+    Either this or example_selector should be provided."""
+
+    example_selector: Any = None
+    """ExampleSelector to choose the examples to format into the prompt.
+    Either this or examples should be provided."""
+
+    example_prompt: PromptTemplate
+    """PromptTemplate used to format an individual example."""
+
+    suffix: StringPromptTemplate
+    """A PromptTemplate to put after the examples."""
+
+    input_variables: List[str]
+    """A list of the names of the variables the prompt template expects."""
+
+    example_separator: str = "\n\n"
+    """String separator used to join the prefix, the examples, and suffix."""
+
+    prefix: Optional[StringPromptTemplate] = None
+    """A PromptTemplate to put before the examples."""
+
+    template_format: str = "f-string"
+    """The format of the prompt template. Options are: 'f-string', 'jinja2'."""
+
+    validate_template: bool = False
+    """Whether or not to try validating the template."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "few_shot_with_templates"]
+
+    @root_validator(pre=True)
+    def check_examples_and_selector(cls, values: Dict) -> Dict:
+        """Check that one and only one of examples/example_selector are provided."""
+        examples = values.get("examples", None)
+        example_selector = values.get("example_selector", None)
+        if examples and example_selector:
+            raise ValueError(
+                "Only one of 'examples' and 'example_selector' should be provided"
+            )
+
+        if examples is None and example_selector is None:
+            raise ValueError(
+                "One of 'examples' and 'example_selector' should be provided"
+            )
+
+        return values
+
+    @root_validator()
+    def template_is_valid(cls, values: Dict) -> Dict:
+        """Check that prefix, suffix, and input variables are consistent."""
+        if values["validate_template"]:
+            input_variables = values["input_variables"]
+            expected_input_variables = set(values["suffix"].input_variables)
+            expected_input_variables |= set(values["partial_variables"])
+            if values["prefix"] is not None:
+                expected_input_variables |= set(values["prefix"].input_variables)
+            missing_vars = expected_input_variables.difference(input_variables)
+            if missing_vars:
+                raise ValueError(
+                    f"Got input_variables={input_variables}, but based on "
+                    f"prefix/suffix expected {expected_input_variables}"
+                )
+        else:
+            values["input_variables"] = sorted(
+                set(values["suffix"].input_variables)
+                | set(values["prefix"].input_variables if values["prefix"] else [])
+                - set(values["partial_variables"])
+            )
+        return values
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        extra = Extra.forbid
+        arbitrary_types_allowed = True
+
+    def _get_examples(self, **kwargs: Any) -> List[dict]:
+        if self.examples is not None:
+            return self.examples
+        elif self.example_selector is not None:
+            return self.example_selector.select_examples(kwargs)
+        else:
+            raise ValueError
+
+    async def _aget_examples(self, **kwargs: Any) -> List[dict]:
+        if self.examples is not None:
+            return self.examples
+        elif self.example_selector is not None:
+            return await self.example_selector.aselect_examples(kwargs)
+        else:
+            raise ValueError
+
+    def format(self, **kwargs: Any) -> str:
+        """Format the prompt with the inputs.
+
+        Args:
+            kwargs: Any arguments to be passed to the prompt template.
+
+        Returns:
+            A formatted string.
+
+        Example:
+
+        .. code-block:: python
+
+            prompt.format(variable1="foo")
+        """
+        kwargs = self._merge_partial_and_user_variables(**kwargs)
+        # Get the examples to use.
+        examples = self._get_examples(**kwargs)
+        # Format the examples.
+        example_strings = [
+            self.example_prompt.format(**example) for example in examples
+        ]
+        # Create the overall prefix.
+        if self.prefix is None:
+            prefix = ""
+        else:
+            prefix_kwargs = {
+                k: v for k, v in kwargs.items() if k in self.prefix.input_variables
+            }
+            for k in prefix_kwargs.keys():
+                kwargs.pop(k)
+            prefix = self.prefix.format(**prefix_kwargs)
+
+        # Create the overall suffix
+        suffix_kwargs = {
+            k: v for k, v in kwargs.items() if k in self.suffix.input_variables
+        }
+        for k in suffix_kwargs.keys():
+            kwargs.pop(k)
+        suffix = self.suffix.format(
+            **suffix_kwargs,
+        )
+
+        pieces = [prefix, *example_strings, suffix]
+        template = self.example_separator.join([piece for piece in pieces if piece])
+        # Format the template with the input variables.
+        return DEFAULT_FORMATTER_MAPPING[self.template_format](template, **kwargs)
+
+    async def aformat(self, **kwargs: Any) -> str:
+        kwargs = self._merge_partial_and_user_variables(**kwargs)
+        # Get the examples to use.
+        examples = await self._aget_examples(**kwargs)
+        # Format the examples.
+        example_strings = [
+            # We can use the sync method here as PromptTemplate doesn't block
+            self.example_prompt.format(**example)
+            for example in examples
+        ]
+        # Create the overall prefix.
+        if self.prefix is None:
+            prefix = ""
+        else:
+            prefix_kwargs = {
+                k: v for k, v in kwargs.items() if k in self.prefix.input_variables
+            }
+            for k in prefix_kwargs.keys():
+                kwargs.pop(k)
+            prefix = await self.prefix.aformat(**prefix_kwargs)
+
+        # Create the overall suffix
+        suffix_kwargs = {
+            k: v for k, v in kwargs.items() if k in self.suffix.input_variables
+        }
+        for k in suffix_kwargs.keys():
+            kwargs.pop(k)
+        suffix = await self.suffix.aformat(
+            **suffix_kwargs,
+        )
+
+        pieces = [prefix, *example_strings, suffix]
+        template = self.example_separator.join([piece for piece in pieces if piece])
+        # Format the template with the input variables.
+        return DEFAULT_FORMATTER_MAPPING[self.template_format](template, **kwargs)
+
+    @property
+    def _prompt_type(self) -> str:
+        """Return the prompt type key."""
+        return "few_shot_with_templates"
+
+    def save(self, file_path: Union[Path, str]) -> None:
+        if self.example_selector:
+            raise ValueError("Saving an example selector is not currently supported")
+        return super().save(file_path)
diff --git a/llm/Lib/site-packages/langchain_core/prompts/image.py b/llm/Lib/site-packages/langchain_core/prompts/image.py
new file mode 100644
index 0000000000000000000000000000000000000000..d4f47779a3ad5e830e11ec538d8b9e4b255b3901
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/prompts/image.py
@@ -0,0 +1,90 @@
+from typing import Any, List
+
+from langchain_core.prompt_values import ImagePromptValue, ImageURL, PromptValue
+from langchain_core.prompts.base import BasePromptTemplate
+from langchain_core.pydantic_v1 import Field
+from langchain_core.runnables import run_in_executor
+from langchain_core.utils import image as image_utils
+
+
+class ImagePromptTemplate(BasePromptTemplate[ImageURL]):
+    """An image prompt template for a multimodal model."""
+
+    template: dict = Field(default_factory=dict)
+    """Template for the prompt."""
+
+    def __init__(self, **kwargs: Any) -> None:
+        if "input_variables" not in kwargs:
+            kwargs["input_variables"] = []
+
+        overlap = set(kwargs["input_variables"]) & set(("url", "path", "detail"))
+        if overlap:
+            raise ValueError(
+                "input_variables for the image template cannot contain"
+                " any of 'url', 'path', or 'detail'."
+                f" Found: {overlap}"
+            )
+        super().__init__(**kwargs)
+
+    @property
+    def _prompt_type(self) -> str:
+        """Return the prompt type key."""
+        return "image-prompt"
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "image"]
+
+    def format_prompt(self, **kwargs: Any) -> PromptValue:
+        return ImagePromptValue(image_url=self.format(**kwargs))
+
+    async def aformat_prompt(self, **kwargs: Any) -> PromptValue:
+        return ImagePromptValue(image_url=await self.aformat(**kwargs))
+
+    def format(
+        self,
+        **kwargs: Any,
+    ) -> ImageURL:
+        """Format the prompt with the inputs.
+
+        Args:
+            kwargs: Any arguments to be passed to the prompt template.
+
+        Returns:
+            A formatted string.
+
+        Example:
+
+            .. code-block:: python
+
+                prompt.format(variable1="foo")
+        """
+        formatted = {}
+        for k, v in self.template.items():
+            if isinstance(v, str):
+                formatted[k] = v.format(**kwargs)
+            else:
+                formatted[k] = v
+        url = kwargs.get("url") or formatted.get("url")
+        path = kwargs.get("path") or formatted.get("path")
+        detail = kwargs.get("detail") or formatted.get("detail")
+        if not url and not path:
+            raise ValueError("Must provide either url or path.")
+        if not url:
+            if not isinstance(path, str):
+                raise ValueError("path must be a string.")
+            url = image_utils.image_to_data_url(path)
+        if not isinstance(url, str):
+            raise ValueError("url must be a string.")
+        output: ImageURL = {"url": url}
+        if detail:
+            # Don't check literal values here: let the API check them
+            output["detail"] = detail  # type: ignore[typeddict-item]
+        return output
+
+    async def aformat(self, **kwargs: Any) -> ImageURL:
+        return await run_in_executor(None, self.format, **kwargs)
+
+    def pretty_repr(self, html: bool = False) -> str:
+        raise NotImplementedError()
diff --git a/llm/Lib/site-packages/langchain_core/prompts/loading.py b/llm/Lib/site-packages/langchain_core/prompts/loading.py
new file mode 100644
index 0000000000000000000000000000000000000000..eeb2c57bfb1ec09bc14c5c676f563790fca09a37
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/prompts/loading.py
@@ -0,0 +1,176 @@
+"""Load prompts."""
+
+import json
+import logging
+from pathlib import Path
+from typing import Callable, Dict, Union
+
+import yaml
+
+from langchain_core.output_parsers.string import StrOutputParser
+from langchain_core.prompts.base import BasePromptTemplate
+from langchain_core.prompts.chat import ChatPromptTemplate
+from langchain_core.prompts.few_shot import FewShotPromptTemplate
+from langchain_core.prompts.prompt import PromptTemplate
+
+URL_BASE = "https://raw.githubusercontent.com/hwchase17/langchain-hub/master/prompts/"
+logger = logging.getLogger(__name__)
+
+
+def load_prompt_from_config(config: dict) -> BasePromptTemplate:
+    """Load prompt from Config Dict."""
+    if "_type" not in config:
+        logger.warning("No `_type` key found, defaulting to `prompt`.")
+    config_type = config.pop("_type", "prompt")
+
+    if config_type not in type_to_loader_dict:
+        raise ValueError(f"Loading {config_type} prompt not supported")
+
+    prompt_loader = type_to_loader_dict[config_type]
+    return prompt_loader(config)
+
+
+def _load_template(var_name: str, config: dict) -> dict:
+    """Load template from the path if applicable."""
+    # Check if template_path exists in config.
+    if f"{var_name}_path" in config:
+        # If it does, make sure template variable doesn't also exist.
+        if var_name in config:
+            raise ValueError(
+                f"Both `{var_name}_path` and `{var_name}` cannot be provided."
+            )
+        # Pop the template path from the config.
+        template_path = Path(config.pop(f"{var_name}_path"))
+        # Load the template.
+        if template_path.suffix == ".txt":
+            with open(template_path) as f:
+                template = f.read()
+        else:
+            raise ValueError
+        # Set the template variable to the extracted variable.
+        config[var_name] = template
+    return config
+
+
+def _load_examples(config: dict) -> dict:
+    """Load examples if necessary."""
+    if isinstance(config["examples"], list):
+        pass
+    elif isinstance(config["examples"], str):
+        with open(config["examples"]) as f:
+            if config["examples"].endswith(".json"):
+                examples = json.load(f)
+            elif config["examples"].endswith((".yaml", ".yml")):
+                examples = yaml.safe_load(f)
+            else:
+                raise ValueError(
+                    "Invalid file format. Only json or yaml formats are supported."
+                )
+        config["examples"] = examples
+    else:
+        raise ValueError("Invalid examples format. Only list or string are supported.")
+    return config
+
+
+def _load_output_parser(config: dict) -> dict:
+    """Load output parser."""
+    if "output_parser" in config and config["output_parser"]:
+        _config = config.pop("output_parser")
+        output_parser_type = _config.pop("_type")
+        if output_parser_type == "default":
+            output_parser = StrOutputParser(**_config)
+        else:
+            raise ValueError(f"Unsupported output parser {output_parser_type}")
+        config["output_parser"] = output_parser
+    return config
+
+
+def _load_few_shot_prompt(config: dict) -> FewShotPromptTemplate:
+    """Load the "few shot" prompt from the config."""
+    # Load the suffix and prefix templates.
+    config = _load_template("suffix", config)
+    config = _load_template("prefix", config)
+    # Load the example prompt.
+    if "example_prompt_path" in config:
+        if "example_prompt" in config:
+            raise ValueError(
+                "Only one of example_prompt and example_prompt_path should "
+                "be specified."
+            )
+        config["example_prompt"] = load_prompt(config.pop("example_prompt_path"))
+    else:
+        config["example_prompt"] = load_prompt_from_config(config["example_prompt"])
+    # Load the examples.
+    config = _load_examples(config)
+    config = _load_output_parser(config)
+    return FewShotPromptTemplate(**config)
+
+
+def _load_prompt(config: dict) -> PromptTemplate:
+    """Load the prompt template from config."""
+    # Load the template from disk if necessary.
+    config = _load_template("template", config)
+    config = _load_output_parser(config)
+
+    template_format = config.get("template_format", "f-string")
+    if template_format == "jinja2":
+        # Disabled due to:
+        # https://github.com/langchain-ai/langchain/issues/4394
+        raise ValueError(
+            f"Loading templates with '{template_format}' format is no longer supported "
+            f"since it can lead to arbitrary code execution. Please migrate to using "
+            f"the 'f-string' template format, which does not suffer from this issue."
+        )
+
+    return PromptTemplate(**config)
+
+
+def load_prompt(path: Union[str, Path]) -> BasePromptTemplate:
+    """Unified method for loading a prompt from LangChainHub or local fs."""
+    if isinstance(path, str) and path.startswith("lc://"):
+        raise RuntimeError(
+            "Loading from the deprecated github-based Hub is no longer supported. "
+            "Please use the new LangChain Hub at https://smith.langchain.com/hub "
+            "instead."
+        )
+    return _load_prompt_from_file(path)
+
+
+def _load_prompt_from_file(file: Union[str, Path]) -> BasePromptTemplate:
+    """Load prompt from file."""
+    # Convert file to a Path object.
+    if isinstance(file, str):
+        file_path = Path(file)
+    else:
+        file_path = file
+    # Load from either json or yaml.
+    if file_path.suffix == ".json":
+        with open(file_path) as f:
+            config = json.load(f)
+    elif file_path.suffix.endswith((".yaml", ".yml")):
+        with open(file_path, "r") as f:
+            config = yaml.safe_load(f)
+    else:
+        raise ValueError(f"Got unsupported file type {file_path.suffix}")
+    # Load the prompt from the config now.
+    return load_prompt_from_config(config)
+
+
+def _load_chat_prompt(config: Dict) -> ChatPromptTemplate:
+    """Load chat prompt from config"""
+
+    messages = config.pop("messages")
+    template = messages[0]["prompt"].pop("template") if messages else None
+    config.pop("input_variables")
+
+    if not template:
+        raise ValueError("Can't load chat prompt without template")
+
+    return ChatPromptTemplate.from_template(template=template, **config)
+
+
+type_to_loader_dict: Dict[str, Callable[[dict], BasePromptTemplate]] = {
+    "prompt": _load_prompt,
+    "few_shot": _load_few_shot_prompt,
+    "chat": _load_chat_prompt,
+}
diff --git a/llm/Lib/site-packages/langchain_core/prompts/pipeline.py b/llm/Lib/site-packages/langchain_core/prompts/pipeline.py
new file mode 100644
index 0000000000000000000000000000000000000000..f89c341d2f319266abf085e58213d50613664aa9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/prompts/pipeline.py
@@ -0,0 +1,75 @@
+from typing import Any, Dict, List, Tuple
+
+from langchain_core.prompt_values import PromptValue
+from langchain_core.prompts.base import BasePromptTemplate
+from langchain_core.prompts.chat import BaseChatPromptTemplate
+from langchain_core.pydantic_v1 import root_validator
+
+
+def _get_inputs(inputs: dict, input_variables: List[str]) -> dict:
+    return {k: inputs[k] for k in input_variables}
+
+
+class PipelinePromptTemplate(BasePromptTemplate):
+    """Prompt template for composing multiple prompt templates together.
+
+    This can be useful when you want to reuse parts of prompts.
+    A PipelinePrompt consists of two main parts:
+        - final_prompt: This is the final prompt that is returned
+        - pipeline_prompts: This is a list of tuples, consisting
+            of a string (`name`) and a Prompt Template.
+            Each PromptTemplate will be formatted and then passed
+            to future prompt templates as a variable with
+            the same name as `name`
+    """
+
+    final_prompt: BasePromptTemplate
+    """The final prompt that is returned."""
+    pipeline_prompts: List[Tuple[str, BasePromptTemplate]]
+    """A list of tuples, consisting of a string (`name`) and a Prompt Template."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "pipeline"]
+
+    @root_validator(pre=True)
+    def get_input_variables(cls, values: Dict) -> Dict:
+        """Get input variables."""
+        created_variables = set()
+        all_variables = set()
+        for k, prompt in values["pipeline_prompts"]:
+            created_variables.add(k)
+            all_variables.update(prompt.input_variables)
+        values["input_variables"] = list(all_variables.difference(created_variables))
+        return values
+
+    def format_prompt(self, **kwargs: Any) -> PromptValue:
+        for k, prompt in self.pipeline_prompts:
+            _inputs = _get_inputs(kwargs, prompt.input_variables)
+            if isinstance(prompt, BaseChatPromptTemplate):
+                kwargs[k] = prompt.format_messages(**_inputs)
+            else:
+                kwargs[k] = prompt.format(**_inputs)
+        _inputs = _get_inputs(kwargs, self.final_prompt.input_variables)
+        return self.final_prompt.format_prompt(**_inputs)
+
+    async def aformat_prompt(self, **kwargs: Any) -> PromptValue:
+        for k, prompt in self.pipeline_prompts:
+            _inputs = _get_inputs(kwargs, prompt.input_variables)
+            if isinstance(prompt, BaseChatPromptTemplate):
+                kwargs[k] = await prompt.aformat_messages(**_inputs)
+            else:
+                kwargs[k] = await prompt.aformat(**_inputs)
+        _inputs = _get_inputs(kwargs, self.final_prompt.input_variables)
+        return await self.final_prompt.aformat_prompt(**_inputs)
+
+    def format(self, **kwargs: Any) -> str:
+        return self.format_prompt(**kwargs).to_string()
+
+    async def aformat(self, **kwargs: Any) -> str:
+        return (await self.aformat_prompt(**kwargs)).to_string()
+
+    @property
+    def _prompt_type(self) -> str:
+        raise ValueError
diff --git a/llm/Lib/site-packages/langchain_core/prompts/prompt.py b/llm/Lib/site-packages/langchain_core/prompts/prompt.py
new file mode 100644
index 0000000000000000000000000000000000000000..e909ee9088d71bb6867359095aac7eea4275e77e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/prompts/prompt.py
@@ -0,0 +1,258 @@
+"""Prompt schema definition."""
+from __future__ import annotations
+
+import warnings
+from pathlib import Path
+from typing import Any, Dict, List, Literal, Optional, Union
+
+from langchain_core.prompts.string import (
+    DEFAULT_FORMATTER_MAPPING,
+    StringPromptTemplate,
+    check_valid_template,
+    get_template_variables,
+    mustache_schema,
+)
+from langchain_core.pydantic_v1 import BaseModel, root_validator
+from langchain_core.runnables.config import RunnableConfig
+
+
+class PromptTemplate(StringPromptTemplate):
+    """A prompt template for a language model.
+
+    A prompt template consists of a string template. It accepts a set of parameters
+    from the user that can be used to generate a prompt for a language model.
+
+    The template can be formatted using either f-strings (default) or jinja2 syntax.
+
+    *Security warning*: Prefer using `template_format="f-string"` instead of
+        `template_format="jinja2"`, or make sure to NEVER accept jinja2 templates
+        from untrusted sources as they may lead to arbitrary Python code execution.
+
+        As of LangChain 0.0.329, Jinja2 templates will be rendered using
+        Jinja2's SandboxedEnvironment by default. This sand-boxing should
+        be treated as a best-effort approach rather than a guarantee of security,
+        as it is an opt-out rather than opt-in approach.
+
+        Despite the sand-boxing, we recommend to never use jinja2 templates
+        from untrusted sources.
+
+    Example:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import PromptTemplate
+
+            # Instantiation using from_template (recommended)
+            prompt = PromptTemplate.from_template("Say {foo}")
+            prompt.format(foo="bar")
+
+            # Instantiation using initializer
+            prompt = PromptTemplate(input_variables=["foo"], template="Say {foo}")
+    """
+
+    @property
+    def lc_attributes(self) -> Dict[str, Any]:
+        return {
+            "template_format": self.template_format,
+        }
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "prompt"]
+
+    input_variables: List[str]
+    """A list of the names of the variables the prompt template expects."""
+
+    template: str
+    """The prompt template."""
+
+    template_format: Literal["f-string", "mustache", "jinja2"] = "f-string"
+    """The format of the prompt template.
+    Options are: 'f-string', 'mustache', 'jinja2'."""
+
+    validate_template: bool = False
+    """Whether or not to try validating the template."""
+
+    def get_input_schema(self, config: RunnableConfig | None = None) -> type[BaseModel]:
+        if self.template_format != "mustache":
+            return super().get_input_schema(config)
+
+        return mustache_schema(self.template)
+
+    def __add__(self, other: Any) -> PromptTemplate:
+        """Override the + operator to allow for combining prompt templates."""
+        # Allow for easy combining
+        if isinstance(other, PromptTemplate):
+            if self.template_format != "f-string":
+                raise ValueError(
+                    "Adding prompt templates only supported for f-strings."
+                )
+            if other.template_format != "f-string":
+                raise ValueError(
+                    "Adding prompt templates only supported for f-strings."
+                )
+            input_variables = list(
+                set(self.input_variables) | set(other.input_variables)
+            )
+            template = self.template + other.template
+            # If any do not want to validate, then don't
+            validate_template = self.validate_template and other.validate_template
+            partial_variables = {k: v for k, v in self.partial_variables.items()}
+            for k, v in other.partial_variables.items():
+                if k in partial_variables:
+                    raise ValueError("Cannot have same variable partialed twice.")
+                else:
+                    partial_variables[k] = v
+            return PromptTemplate(
+                template=template,
+                input_variables=input_variables,
+                partial_variables=partial_variables,
+                template_format="f-string",
+                validate_template=validate_template,
+            )
+        elif isinstance(other, str):
+            prompt = PromptTemplate.from_template(other)
+            return self + prompt
+        else:
+            raise NotImplementedError(f"Unsupported operand type for +: {type(other)}")
+
+    @property
+    def _prompt_type(self) -> str:
+        """Return the prompt type key."""
+        return "prompt"
+
+    def format(self, **kwargs: Any) -> str:
+        kwargs = self._merge_partial_and_user_variables(**kwargs)
+        return DEFAULT_FORMATTER_MAPPING[self.template_format](self.template, **kwargs)
+
+    @root_validator()
+    def template_is_valid(cls, values: Dict) -> Dict:
+        """Check that template and input variables are consistent."""
+        if values["validate_template"]:
+            if values["template_format"] == "mustache":
+                raise ValueError("Mustache templates cannot be validated.")
+            all_inputs = values["input_variables"] + list(values["partial_variables"])
+            check_valid_template(
+                values["template"], values["template_format"], all_inputs
+            )
+        elif values.get("template_format"):
+            values["input_variables"] = [
+                var
+                for var in get_template_variables(
+                    values["template"], values["template_format"]
+                )
+                if var not in values["partial_variables"]
+            ]
+        return values
+
+    @classmethod
+    def from_examples(
+        cls,
+        examples: List[str],
+        suffix: str,
+        input_variables: List[str],
+        example_separator: str = "\n\n",
+        prefix: str = "",
+        **kwargs: Any,
+    ) -> PromptTemplate:
+        """Take examples in list format with prefix and suffix to create a prompt.
+
+        Intended to be used as a way to dynamically create a prompt from examples.
+
+        Args:
+            examples: List of examples to use in the prompt.
+            suffix: String to go after the list of examples. Should generally
+                set up the user's input.
+            input_variables: A list of variable names the final prompt template
+                will expect.
+            example_separator: The separator to use in between examples. Defaults
+                to two new line characters.
+            prefix: String that should go before any examples. Generally includes
+                examples. Default to an empty string.
+
+        Returns:
+            The final prompt generated.
+        """
+        template = example_separator.join([prefix, *examples, suffix])
+        return cls(input_variables=input_variables, template=template, **kwargs)
+
+    @classmethod
+    def from_file(
+        cls,
+        template_file: Union[str, Path],
+        input_variables: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> PromptTemplate:
+        """Load a prompt from a file.
+
+        Args:
+            template_file: The path to the file containing the prompt template.
+            input_variables: [DEPRECATED] A list of variable names the final prompt
+                template will expect.
+
+        input_variables is ignored as from_file now delegates to from_template().
+
+        Returns:
+            The prompt loaded from the file.
+        """
+        with open(str(template_file), "r") as f:
+            template = f.read()
+        if input_variables:
+            warnings.warn(
+                "`input_variables' is deprecated and ignored.", DeprecationWarning
+            )
+        return cls.from_template(template=template, **kwargs)
+
+    @classmethod
+    def from_template(
+        cls,
+        template: str,
+        *,
+        template_format: str = "f-string",
+        partial_variables: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> PromptTemplate:
+        """Load a prompt template from a template.
+
+        *Security warning*: Prefer using `template_format="f-string"` instead of
+            `template_format="jinja2"`, or make sure to NEVER accept jinja2 templates
+            from untrusted sources as they may lead to arbitrary Python code execution.
+
+            As of LangChain 0.0.329, Jinja2 templates will be rendered using
+            Jinja2's SandboxedEnvironment by default. This sand-boxing should
+            be treated as a best-effort approach rather than a guarantee of security,
+            as it is an opt-out rather than opt-in approach.
+
+            Despite the sand-boxing, we recommend to never use jinja2 templates
+            from untrusted sources.
+
+        Args:
+            template: The template to load.
+            template_format: The format of the template. Use `jinja2` for jinja2,
+                             and `f-string` or None for f-strings.
+            partial_variables: A dictionary of variables that can be used to partially
+                               fill in the template. For example, if the template is
+                              `"{variable1} {variable2}"`, and `partial_variables` is
+                              `{"variable1": "foo"}`, then the final prompt will be
+                              `"foo {variable2}"`.
+
+        Returns:
+            The prompt template loaded from the template.
+        """
+
+        input_variables = get_template_variables(template, template_format)
+        _partial_variables = partial_variables or {}
+
+        if _partial_variables:
+            input_variables = [
+                var for var in input_variables if var not in _partial_variables
+            ]
+
+        return cls(
+            input_variables=input_variables,
+            template=template,
+            template_format=template_format,  # type: ignore[arg-type]
+            partial_variables=_partial_variables,
+            **kwargs,
+        )
diff --git a/llm/Lib/site-packages/langchain_core/prompts/string.py b/llm/Lib/site-packages/langchain_core/prompts/string.py
new file mode 100644
index 0000000000000000000000000000000000000000..4abbd30111917e196815b3287a2794a3b782aef0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/prompts/string.py
@@ -0,0 +1,246 @@
+"""BasePrompt schema definition."""
+
+from __future__ import annotations
+
+import warnings
+from abc import ABC
+from string import Formatter
+from typing import Any, Callable, Dict, List, Set, Tuple, Type
+
+import langchain_core.utils.mustache as mustache
+from langchain_core.prompt_values import PromptValue, StringPromptValue
+from langchain_core.prompts.base import BasePromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, create_model
+from langchain_core.utils import get_colored_text
+from langchain_core.utils.formatting import formatter
+from langchain_core.utils.interactive_env import is_interactive_env
+
+
+def jinja2_formatter(template: str, **kwargs: Any) -> str:
+    """Format a template using jinja2.
+
+    *Security warning*: As of LangChain 0.0.329, this method uses Jinja2's
+        SandboxedEnvironment by default. However, this sand-boxing should
+        be treated as a best-effort approach rather than a guarantee of security.
+        Do not accept jinja2 templates from untrusted sources as they may lead
+        to arbitrary Python code execution.
+
+        https://jinja.palletsprojects.com/en/3.1.x/sandbox/
+    """
+    try:
+        from jinja2.sandbox import SandboxedEnvironment
+    except ImportError:
+        raise ImportError(
+            "jinja2 not installed, which is needed to use the jinja2_formatter. "
+            "Please install it with `pip install jinja2`."
+            "Please be cautious when using jinja2 templates. "
+            "Do not expand jinja2 templates using unverified or user-controlled "
+            "inputs as that can result in arbitrary Python code execution."
+        )
+
+    # This uses a sandboxed environment to prevent arbitrary code execution.
+    # Jinja2 uses an opt-out rather than opt-in approach for sand-boxing.
+    # Please treat this sand-boxing as a best-effort approach rather than
+    # a guarantee of security.
+    # We recommend to never use jinja2 templates with untrusted inputs.
+    # https://jinja.palletsprojects.com/en/3.1.x/sandbox/
+    # approach not a guarantee of security.
+    return SandboxedEnvironment().from_string(template).render(**kwargs)
+
+
+def validate_jinja2(template: str, input_variables: List[str]) -> None:
+    """
+    Validate that the input variables are valid for the template.
+    Issues a warning if missing or extra variables are found.
+
+    Args:
+        template: The template string.
+        input_variables: The input variables.
+    """
+    input_variables_set = set(input_variables)
+    valid_variables = _get_jinja2_variables_from_template(template)
+    missing_variables = valid_variables - input_variables_set
+    extra_variables = input_variables_set - valid_variables
+
+    warning_message = ""
+    if missing_variables:
+        warning_message += f"Missing variables: {missing_variables} "
+
+    if extra_variables:
+        warning_message += f"Extra variables: {extra_variables}"
+
+    if warning_message:
+        warnings.warn(warning_message.strip())
+
+
+def _get_jinja2_variables_from_template(template: str) -> Set[str]:
+    try:
+        from jinja2 import Environment, meta
+    except ImportError:
+        raise ImportError(
+            "jinja2 not installed, which is needed to use the jinja2_formatter. "
+            "Please install it with `pip install jinja2`."
+        )
+    env = Environment()
+    ast = env.parse(template)
+    variables = meta.find_undeclared_variables(ast)
+    return variables
+
+
+def mustache_formatter(template: str, **kwargs: Any) -> str:
+    """Format a template using mustache."""
+    return mustache.render(template, kwargs)
+
+
+def mustache_template_vars(
+    template: str,
+) -> Set[str]:
+    """Get the variables from a mustache template."""
+    vars: Set[str] = set()
+    in_section = False
+    for type, key in mustache.tokenize(template):
+        if type == "end":
+            in_section = False
+        elif in_section:
+            continue
+        elif type in ("variable", "section") and key != ".":
+            vars.add(key.split(".")[0])
+            if type == "section":
+                in_section = True
+    return vars
+
+
+Defs = Dict[str, "Defs"]
+
+
+def mustache_schema(
+    template: str,
+) -> Type[BaseModel]:
+    """Get the variables from a mustache template."""
+    fields = set()
+    prefix: Tuple[str, ...] = ()
+    for type, key in mustache.tokenize(template):
+        if key == ".":
+            continue
+        if type == "end":
+            prefix = prefix[: -key.count(".")]
+        elif type == "section":
+            prefix = prefix + tuple(key.split("."))
+        elif type == "variable":
+            fields.add(prefix + tuple(key.split(".")))
+    defs: Defs = {}  # None means leaf node
+    while fields:
+        field = fields.pop()
+        current = defs
+        for part in field[:-1]:
+            current = current.setdefault(part, {})
+        current[field[-1]] = {}
+    return _create_model_recursive("PromptInput", defs)
+
+
+def _create_model_recursive(name: str, defs: Defs) -> Type:
+    return create_model(  # type: ignore[call-overload]
+        name,
+        **{
+            k: (_create_model_recursive(k, v), None) if v else (str, None)
+            for k, v in defs.items()
+        },
+    )
+
+
+DEFAULT_FORMATTER_MAPPING: Dict[str, Callable] = {
+    "f-string": formatter.format,
+    "mustache": mustache_formatter,
+    "jinja2": jinja2_formatter,
+}
+
+DEFAULT_VALIDATOR_MAPPING: Dict[str, Callable] = {
+    "f-string": formatter.validate_input_variables,
+    "jinja2": validate_jinja2,
+}
+
+
+def check_valid_template(
+    template: str, template_format: str, input_variables: List[str]
+) -> None:
+    """Check that template string is valid.
+
+    Args:
+        template: The template string.
+        template_format: The template format. Should be one of "f-string" or "jinja2".
+        input_variables: The input variables.
+
+    Raises:
+        ValueError: If the template format is not supported.
+    """
+    try:
+        validator_func = DEFAULT_VALIDATOR_MAPPING[template_format]
+    except KeyError as exc:
+        raise ValueError(
+            f"Invalid template format {template_format!r}, should be one of"
+            f" {list(DEFAULT_FORMATTER_MAPPING)}."
+        ) from exc
+    try:
+        validator_func(template, input_variables)
+    except (KeyError, IndexError) as exc:
+        raise ValueError(
+            "Invalid prompt schema; check for mismatched or missing input parameters"
+            f" from {input_variables}."
+        ) from exc
+
+
+def get_template_variables(template: str, template_format: str) -> List[str]:
+    """Get the variables from the template.
+
+    Args:
+        template: The template string.
+        template_format: The template format. Should be one of "f-string" or "jinja2".
+
+    Returns:
+        The variables from the template.
+
+    Raises:
+        ValueError: If the template format is not supported.
+    """
+    if template_format == "jinja2":
+        # Get the variables for the template
+        input_variables = _get_jinja2_variables_from_template(template)
+    elif template_format == "f-string":
+        input_variables = {
+            v for _, v, _, _ in Formatter().parse(template) if v is not None
+        }
+    elif template_format == "mustache":
+        input_variables = mustache_template_vars(template)
+    else:
+        raise ValueError(f"Unsupported template format: {template_format}")
+
+    return sorted(input_variables)
+
+
+class StringPromptTemplate(BasePromptTemplate, ABC):
+    """String prompt that exposes the format method, returning a prompt."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "prompts", "base"]
+
+    def format_prompt(self, **kwargs: Any) -> PromptValue:
+        return StringPromptValue(text=self.format(**kwargs))
+
+    async def aformat_prompt(self, **kwargs: Any) -> PromptValue:
+        return StringPromptValue(text=await self.aformat(**kwargs))
+
+    def pretty_repr(self, html: bool = False) -> str:
+        # TODO: handle partials
+        dummy_vars = {
+            input_var: "{" + f"{input_var}" + "}" for input_var in self.input_variables
+        }
+        if html:
+            dummy_vars = {
+                k: get_colored_text(v, "yellow") for k, v in dummy_vars.items()
+            }
+        return self.format(**dummy_vars)
+
+    def pretty_print(self) -> None:
+        print(self.pretty_repr(html=is_interactive_env()))  # noqa: T201
diff --git a/llm/Lib/site-packages/langchain_core/prompts/structured.py b/llm/Lib/site-packages/langchain_core/prompts/structured.py
new file mode 100644
index 0000000000000000000000000000000000000000..882f34cc8279eb19f9cd9d16d7b5284a5a08e482
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/prompts/structured.py
@@ -0,0 +1,143 @@
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Sequence,
+    Set,
+    Type,
+    Union,
+)
+
+from langchain_core._api.beta_decorator import beta
+from langchain_core.language_models.base import BaseLanguageModel
+from langchain_core.prompts.chat import (
+    BaseChatPromptTemplate,
+    BaseMessagePromptTemplate,
+    ChatPromptTemplate,
+    MessageLikeRepresentation,
+    MessagesPlaceholder,
+    _convert_to_message,
+)
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.runnables.base import (
+    Other,
+    Runnable,
+    RunnableSequence,
+    RunnableSerializable,
+)
+
+
+@beta()
+class StructuredPrompt(ChatPromptTemplate):
+    schema_: Union[Dict, Type[BaseModel]]
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object.
+
+        For example, if the class is `langchain.llms.openai.OpenAI`, then the
+        namespace is ["langchain", "llms", "openai"]
+        """
+        return cls.__module__.split(".")
+
+    @classmethod
+    def from_messages_and_schema(
+        cls,
+        messages: Sequence[MessageLikeRepresentation],
+        schema: Union[Dict, Type[BaseModel]],
+    ) -> ChatPromptTemplate:
+        """Create a chat prompt template from a variety of message formats.
+
+        Examples:
+
+            Instantiation from a list of message templates:
+
+            .. code-block:: python
+
+                class OutputSchema(BaseModel):
+                    name: str
+                    value: int
+
+                template = ChatPromptTemplate.from_messages(
+                    [
+                        ("human", "Hello, how are you?"),
+                        ("ai", "I'm doing well, thanks!"),
+                        ("human", "That's good to hear."),
+                    ],
+                    OutputSchema,
+                )
+
+        Args:
+            messages: sequence of message representations.
+                  A message can be represented using the following formats:
+                  (1) BaseMessagePromptTemplate, (2) BaseMessage, (3) 2-tuple of
+                  (message type, template); e.g., ("human", "{user_input}"),
+                  (4) 2-tuple of (message class, template), (4) a string which is
+                  shorthand for ("human", template); e.g., "{user_input}"
+            schema: a dictionary representation of function call, or a Pydantic model.
+
+        Returns:
+            a structured prompt template
+        """
+        _messages = [_convert_to_message(message) for message in messages]
+
+        # Automatically infer input variables from messages
+        input_vars: Set[str] = set()
+        partial_vars: Dict[str, Any] = {}
+        for _message in _messages:
+            if isinstance(_message, MessagesPlaceholder) and _message.optional:
+                partial_vars[_message.variable_name] = []
+            elif isinstance(
+                _message, (BaseChatPromptTemplate, BaseMessagePromptTemplate)
+            ):
+                input_vars.update(_message.input_variables)
+
+        return cls(
+            input_variables=sorted(input_vars),
+            messages=_messages,
+            partial_variables=partial_vars,
+            schema_=schema,
+        )
+
+    def __or__(
+        self,
+        other: Union[
+            Runnable[Any, Other],
+            Callable[[Any], Other],
+            Callable[[Iterator[Any]], Iterator[Other]],
+            Mapping[str, Union[Runnable[Any, Other], Callable[[Any], Other], Any]],
+        ],
+    ) -> RunnableSerializable[Dict, Other]:
+        if isinstance(other, BaseLanguageModel) or hasattr(
+            other, "with_structured_output"
+        ):
+            return RunnableSequence(self, other.with_structured_output(self.schema_))
+        else:
+            raise NotImplementedError(
+                "Structured prompts need to be piped to a language model."
+            )
+
+    def pipe(
+        self,
+        *others: Union[Runnable[Any, Other], Callable[[Any], Other]],
+        name: Optional[str] = None,
+    ) -> RunnableSerializable[Dict, Other]:
+        if (
+            others
+            and isinstance(others[0], BaseLanguageModel)
+            or hasattr(others[0], "with_structured_output")
+        ):
+            return RunnableSequence(
+                self,
+                others[0].with_structured_output(self.schema_),
+                *others[1:],
+                name=name,
+            )
+        else:
+            raise NotImplementedError(
+                "Structured prompts need to be piped to a language model."
+            )
diff --git a/llm/Lib/site-packages/langchain_core/py.typed b/llm/Lib/site-packages/langchain_core/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/llm/Lib/site-packages/langchain_core/pydantic_v1/__init__.py b/llm/Lib/site-packages/langchain_core/pydantic_v1/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6b52dfcabeb457237493b74866918df4fdc6dd3a
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/pydantic_v1/__init__.py
@@ -0,0 +1,23 @@
+from importlib import metadata
+
+## Create namespaces for pydantic v1 and v2.
+# This code must stay at the top of the file before other modules may
+# attempt to import pydantic since it adds pydantic_v1 and pydantic_v2 to sys.modules.
+#
+# This hack is done for the following reasons:
+# * Langchain will attempt to remain compatible with both pydantic v1 and v2 since
+#   both dependencies and dependents may be stuck on either version of v1 or v2.
+# * Creating namespaces for pydantic v1 and v2 should allow us to write code that
+#   unambiguously uses either v1 or v2 API.
+# * This change is easier to roll out and roll back.
+
+try:
+    from pydantic.v1 import *  # noqa: F403 # type: ignore
+except ImportError:
+    from pydantic import *  # noqa: F403 # type: ignore
+
+
+try:
+    _PYDANTIC_MAJOR_VERSION: int = int(metadata.version("pydantic").split(".")[0])
+except metadata.PackageNotFoundError:
+    _PYDANTIC_MAJOR_VERSION = 0
diff --git a/llm/Lib/site-packages/langchain_core/pydantic_v1/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/pydantic_v1/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..731d8f4ec456711de0fa84a0a18d98b4411fb471
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/pydantic_v1/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/pydantic_v1/__pycache__/dataclasses.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/pydantic_v1/__pycache__/dataclasses.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..baa25295a0be3bc6e28d786c7720ba042e6add98
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/pydantic_v1/__pycache__/dataclasses.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/pydantic_v1/__pycache__/main.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/pydantic_v1/__pycache__/main.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..cd0da5410540f4c5f38f2a5dde3d8e6a7957c0c9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/pydantic_v1/__pycache__/main.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/pydantic_v1/dataclasses.py b/llm/Lib/site-packages/langchain_core/pydantic_v1/dataclasses.py
new file mode 100644
index 0000000000000000000000000000000000000000..bb7253c29d74e4f20424f68aa09baf9a76694fe8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/pydantic_v1/dataclasses.py
@@ -0,0 +1,4 @@
+try:
+    from pydantic.v1.dataclasses import *  # noqa: F403
+except ImportError:
+    from pydantic.dataclasses import *  # noqa: F403
diff --git a/llm/Lib/site-packages/langchain_core/pydantic_v1/main.py b/llm/Lib/site-packages/langchain_core/pydantic_v1/main.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b8f1670e137456ea75d111a2b507e3f6a477981
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/pydantic_v1/main.py
@@ -0,0 +1,4 @@
+try:
+    from pydantic.v1.main import *  # noqa: F403
+except ImportError:
+    from pydantic.main import *  # noqa: F403
diff --git a/llm/Lib/site-packages/langchain_core/retrievers.py b/llm/Lib/site-packages/langchain_core/retrievers.py
new file mode 100644
index 0000000000000000000000000000000000000000..cf158da4cedce56d969fc32a00e1e96577e382a2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/retrievers.py
@@ -0,0 +1,389 @@
+"""**Retriever** class returns Documents given a text **query**.
+
+It is more general than a vector store. A retriever does not need to be able to
+store documents, only to return (or retrieve) it. Vector stores can be used as
+the backbone of a retriever, but there are other types of retrievers as well.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseRetriever --> <name>Retriever  # Examples: ArxivRetriever, MergerRetriever
+
+**Main helpers:**
+
+.. code-block::
+
+    RetrieverInput, RetrieverOutput, RetrieverLike, RetrieverOutputLike,
+    Document, Serializable, Callbacks,
+    CallbackManagerForRetrieverRun, AsyncCallbackManagerForRetrieverRun
+"""
+from __future__ import annotations
+
+import warnings
+from abc import ABC, abstractmethod
+from inspect import signature
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+from langchain_core.documents import Document
+from langchain_core.load.dump import dumpd
+from langchain_core.runnables import (
+    Runnable,
+    RunnableConfig,
+    RunnableSerializable,
+    ensure_config,
+)
+from langchain_core.runnables.config import run_in_executor
+
+if TYPE_CHECKING:
+    from langchain_core.callbacks.manager import (
+        AsyncCallbackManagerForRetrieverRun,
+        CallbackManagerForRetrieverRun,
+        Callbacks,
+    )
+
+RetrieverInput = str
+RetrieverOutput = List[Document]
+RetrieverLike = Runnable[RetrieverInput, RetrieverOutput]
+RetrieverOutputLike = Runnable[Any, RetrieverOutput]
+
+
+class BaseRetriever(RunnableSerializable[RetrieverInput, RetrieverOutput], ABC):
+    """Abstract base class for a Document retrieval system.
+
+
+    A retrieval system is defined as something that can take string queries and return
+    the most 'relevant' Documents from some source.
+
+    Usage:
+
+    A retriever follows the standard Runnable interface, and should be used
+    via the standard runnable methods of `invoke`, `ainvoke`, `batch`, `abatch`.
+
+    Implementation:
+
+    When implementing a custom retriever, the class should implement
+    the `_get_relevant_documents` method to define the logic for retrieving documents.
+
+    Optionally, an async native implementations can be provided by overriding the
+    `_aget_relevant_documents` method.
+
+    Example: A retriever that returns the first 5 documents from a list of documents
+
+        .. code-block:: python
+
+            from langchain_core import Document, BaseRetriever
+            from typing import List
+
+            class SimpleRetriever(BaseRetriever):
+                docs: List[Document]
+                k: int = 5
+
+                def _get_relevant_documents(self, query: str) -> List[Document]:
+                    \"\"\"Return the first k documents from the list of documents\"\"\"
+                    return self.docs[:self.k]
+
+                async def _aget_relevant_documents(self, query: str) -> List[Document]:
+                    \"\"\"(Optional) async native implementation.\"\"\"
+                    return self.docs[:self.k]
+
+    Example: A simple retriever based on a scitkit learn vectorizer
+
+        .. code-block:: python
+
+            from sklearn.metrics.pairwise import cosine_similarity
+
+            class TFIDFRetriever(BaseRetriever, BaseModel):
+                vectorizer: Any
+                docs: List[Document]
+                tfidf_array: Any
+                k: int = 4
+
+                class Config:
+                    arbitrary_types_allowed = True
+
+                def _get_relevant_documents(self, query: str) -> List[Document]:
+                    # Ip -- (n_docs,x), Op -- (n_docs,n_Feats)
+                    query_vec = self.vectorizer.transform([query])
+                    # Op -- (n_docs,1) -- Cosine Sim with each doc
+                    results = cosine_similarity(self.tfidf_array, query_vec).reshape((-1,))
+                    return [self.docs[i] for i in results.argsort()[-self.k :][::-1]]
+    """  # noqa: E501
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    _new_arg_supported: bool = False
+    _expects_other_args: bool = False
+    tags: Optional[List[str]] = None
+    """Optional list of tags associated with the retriever. Defaults to None
+    These tags will be associated with each call to this retriever,
+    and passed as arguments to the handlers defined in `callbacks`.
+    You can use these to eg identify a specific instance of a retriever with its 
+    use case.
+    """
+    metadata: Optional[Dict[str, Any]] = None
+    """Optional metadata associated with the retriever. Defaults to None
+    This metadata will be associated with each call to this retriever,
+    and passed as arguments to the handlers defined in `callbacks`.
+    You can use these to eg identify a specific instance of a retriever with its 
+    use case.
+    """
+
+    def __init_subclass__(cls, **kwargs: Any) -> None:
+        super().__init_subclass__(**kwargs)
+        # Version upgrade for old retrievers that implemented the public
+        # methods directly.
+        if cls.get_relevant_documents != BaseRetriever.get_relevant_documents:
+            warnings.warn(
+                "Retrievers must implement abstract `_get_relevant_documents` method"
+                " instead of `get_relevant_documents`",
+                DeprecationWarning,
+            )
+            swap = cls.get_relevant_documents
+            cls.get_relevant_documents = (  # type: ignore[assignment]
+                BaseRetriever.get_relevant_documents
+            )
+            cls._get_relevant_documents = swap  # type: ignore[assignment]
+        if (
+            hasattr(cls, "aget_relevant_documents")
+            and cls.aget_relevant_documents != BaseRetriever.aget_relevant_documents
+        ):
+            warnings.warn(
+                "Retrievers must implement abstract `_aget_relevant_documents` method"
+                " instead of `aget_relevant_documents`",
+                DeprecationWarning,
+            )
+            aswap = cls.aget_relevant_documents
+            cls.aget_relevant_documents = (  # type: ignore[assignment]
+                BaseRetriever.aget_relevant_documents
+            )
+            cls._aget_relevant_documents = aswap  # type: ignore[assignment]
+        parameters = signature(cls._get_relevant_documents).parameters
+        cls._new_arg_supported = parameters.get("run_manager") is not None
+        # If a V1 retriever broke the interface and expects additional arguments
+        cls._expects_other_args = (
+            len(set(parameters.keys()) - {"self", "query", "run_manager"}) > 0
+        )
+
+    def invoke(
+        self, input: str, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> List[Document]:
+        """Invoke the retriever to get relevant documents.
+
+        Main entry point for synchronous retriever invocations.
+
+        Args:
+            input: The query string
+            config: Configuration for the retriever
+            **kwargs: Additional arguments to pass to the retriever
+
+        Returns:
+            List of relevant documents
+
+        Examples:
+
+        .. code-block:: python
+
+            retriever.invoke("query")
+        """
+        config = ensure_config(config)
+        return self.get_relevant_documents(
+            input,
+            callbacks=config.get("callbacks"),
+            tags=config.get("tags"),
+            metadata=config.get("metadata"),
+            run_name=config.get("run_name"),
+            **kwargs,
+        )
+
+    async def ainvoke(
+        self,
+        input: str,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Asynchronously invoke the retriever to get relevant documents.
+
+        Main entry point for asynchronous retriever invocations.
+
+        Args:
+            input: The query string
+            config: Configuration for the retriever
+            **kwargs: Additional arguments to pass to the retriever
+
+        Returns:
+            List of relevant documents
+
+        Examples:
+
+        .. code-block:: python
+
+            await retriever.ainvoke("query")
+        """
+        config = ensure_config(config)
+        return await self.aget_relevant_documents(
+            input,
+            callbacks=config.get("callbacks"),
+            tags=config.get("tags"),
+            metadata=config.get("metadata"),
+            run_name=config.get("run_name"),
+            **kwargs,
+        )
+
+    @abstractmethod
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Get documents relevant to a query.
+        Args:
+            query: String to find relevant documents for
+            run_manager: The callbacks handler to use
+        Returns:
+            List of relevant documents
+        """
+
+    async def _aget_relevant_documents(
+        self, query: str, *, run_manager: AsyncCallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        """Asynchronously get documents relevant to a query.
+        Args:
+            query: String to find relevant documents for
+            run_manager: The callbacks handler to use
+        Returns:
+            List of relevant documents
+        """
+        return await run_in_executor(
+            None,
+            self._get_relevant_documents,
+            query,
+            run_manager=run_manager.get_sync(),
+        )
+
+    def get_relevant_documents(
+        self,
+        query: str,
+        *,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        run_name: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Retrieve documents relevant to a query.
+
+        Users should favor using `.invoke` or `.batch` rather than
+        `get_relevant_documents directly`.
+
+        Args:
+            query: string to find relevant documents for
+            callbacks: Callback manager or list of callbacks
+            tags: Optional list of tags associated with the retriever. Defaults to None
+                These tags will be associated with each call to this retriever,
+                and passed as arguments to the handlers defined in `callbacks`.
+            metadata: Optional metadata associated with the retriever. Defaults to None
+                This metadata will be associated with each call to this retriever,
+                and passed as arguments to the handlers defined in `callbacks`.
+            run_name: Optional name for the run.
+
+        Returns:
+            List of relevant documents
+        """
+        from langchain_core.callbacks.manager import CallbackManager
+
+        callback_manager = CallbackManager.configure(
+            callbacks,
+            None,
+            verbose=kwargs.get("verbose", False),
+            inheritable_tags=tags,
+            local_tags=self.tags,
+            inheritable_metadata=metadata,
+            local_metadata=self.metadata,
+        )
+        run_manager = callback_manager.on_retriever_start(
+            dumpd(self),
+            query,
+            name=run_name,
+            run_id=kwargs.pop("run_id", None),
+        )
+        try:
+            _kwargs = kwargs if self._expects_other_args else {}
+            if self._new_arg_supported:
+                result = self._get_relevant_documents(
+                    query, run_manager=run_manager, **_kwargs
+                )
+            else:
+                result = self._get_relevant_documents(query, **_kwargs)
+        except Exception as e:
+            run_manager.on_retriever_error(e)
+            raise e
+        else:
+            run_manager.on_retriever_end(
+                result,
+            )
+            return result
+
+    async def aget_relevant_documents(
+        self,
+        query: str,
+        *,
+        callbacks: Callbacks = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        run_name: Optional[str] = None,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Asynchronously get documents relevant to a query.
+
+        Users should favor using `.ainvoke` or `.abatch` rather than
+        `aget_relevant_documents directly`.
+
+        Args:
+            query: string to find relevant documents for
+            callbacks: Callback manager or list of callbacks
+            tags: Optional list of tags associated with the retriever. Defaults to None
+                These tags will be associated with each call to this retriever,
+                and passed as arguments to the handlers defined in `callbacks`.
+            metadata: Optional metadata associated with the retriever. Defaults to None
+                This metadata will be associated with each call to this retriever,
+                and passed as arguments to the handlers defined in `callbacks`.
+            run_name: Optional name for the run.
+
+        Returns:
+            List of relevant documents
+        """
+        from langchain_core.callbacks.manager import AsyncCallbackManager
+
+        callback_manager = AsyncCallbackManager.configure(
+            callbacks,
+            None,
+            verbose=kwargs.get("verbose", False),
+            inheritable_tags=tags,
+            local_tags=self.tags,
+            inheritable_metadata=metadata,
+            local_metadata=self.metadata,
+        )
+        run_manager = await callback_manager.on_retriever_start(
+            dumpd(self),
+            query,
+            name=run_name,
+            run_id=kwargs.pop("run_id", None),
+        )
+        try:
+            _kwargs = kwargs if self._expects_other_args else {}
+            if self._new_arg_supported:
+                result = await self._aget_relevant_documents(
+                    query, run_manager=run_manager, **_kwargs
+                )
+            else:
+                result = await self._aget_relevant_documents(query, **_kwargs)
+        except Exception as e:
+            await run_manager.on_retriever_error(e)
+            raise e
+        else:
+            await run_manager.on_retriever_end(
+                result,
+            )
+            return result
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__init__.py b/llm/Lib/site-packages/langchain_core/runnables/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9c4362c9c861c0214f85d99bb14a979d1ce4b1b2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/__init__.py
@@ -0,0 +1,84 @@
+"""LangChain **Runnable** and the **LangChain Expression Language (LCEL)**.
+
+The LangChain Expression Language (LCEL) offers a declarative method to build
+production-grade programs that harness the power of LLMs.
+
+Programs created using LCEL and LangChain Runnables inherently support
+synchronous, asynchronous, batch, and streaming operations.
+
+Support for **async** allows servers hosting LCEL based programs to scale better
+for higher concurrent loads.
+
+**Batch** operations allow for processing multiple inputs in parallel.
+
+**Streaming** of intermediate outputs, as they're being generated, allows for
+creating more responsive UX.
+
+This module contains schema and implementation of LangChain Runnables primitives.
+"""
+from langchain_core.runnables.base import (
+    Runnable,
+    RunnableBinding,
+    RunnableGenerator,
+    RunnableLambda,
+    RunnableMap,
+    RunnableParallel,
+    RunnableSequence,
+    RunnableSerializable,
+    chain,
+)
+from langchain_core.runnables.branch import RunnableBranch
+from langchain_core.runnables.config import (
+    RunnableConfig,
+    ensure_config,
+    get_config_list,
+    patch_config,
+    run_in_executor,
+)
+from langchain_core.runnables.fallbacks import RunnableWithFallbacks
+from langchain_core.runnables.passthrough import (
+    RunnableAssign,
+    RunnablePassthrough,
+    RunnablePick,
+)
+from langchain_core.runnables.router import RouterInput, RouterRunnable
+from langchain_core.runnables.utils import (
+    AddableDict,
+    ConfigurableField,
+    ConfigurableFieldMultiOption,
+    ConfigurableFieldSingleOption,
+    ConfigurableFieldSpec,
+    aadd,
+    add,
+)
+
+__all__ = [
+    "chain",
+    "AddableDict",
+    "ConfigurableField",
+    "ConfigurableFieldSingleOption",
+    "ConfigurableFieldMultiOption",
+    "ConfigurableFieldSpec",
+    "ensure_config",
+    "run_in_executor",
+    "patch_config",
+    "RouterInput",
+    "RouterRunnable",
+    "Runnable",
+    "RunnableSerializable",
+    "RunnableBinding",
+    "RunnableBranch",
+    "RunnableConfig",
+    "RunnableGenerator",
+    "RunnableLambda",
+    "RunnableMap",
+    "RunnableParallel",
+    "RunnablePassthrough",
+    "RunnableAssign",
+    "RunnablePick",
+    "RunnableSequence",
+    "RunnableWithFallbacks",
+    "get_config_list",
+    "aadd",
+    "add",
+]
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..8b7301d93b7edf35d69dc8397d416b3f4b7438ee
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fe83b0b6247d5c53708af8b617150abe4877ddd2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/branch.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/branch.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f3112782e6cd6e90144fc36daf538938bafc8f77
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/branch.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/config.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/config.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b55727384f7751ef031b1e5cf72e0bb5c9b4237c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/config.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/configurable.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/configurable.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..185668a3ebce11fb686276332af7e39843ac13a7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/configurable.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/fallbacks.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/fallbacks.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fca8b1bb08ce206cdb57cb73d74455ed395a275f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/fallbacks.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/graph.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/graph.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..912ed149e8c3e37d20e397d3a8fb71e533923c2f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/graph.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/graph_ascii.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/graph_ascii.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..69a1135944409a0666e2546e6aba2daf5d58986d
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/graph_ascii.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/graph_mermaid.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/graph_mermaid.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bfda710f4a26aa3ba03bab849b96724a3b6e6572
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/graph_mermaid.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/graph_png.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/graph_png.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4ffd0c961b092253286a25f1d7c2cc178b493093
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/graph_png.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/history.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/history.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c450d93a83610004cb0bd44a9cf362fc78a187c5
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/history.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/learnable.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/learnable.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..0f809b164445bef8ab675fc0786ec48919a0f4dc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/learnable.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/passthrough.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/passthrough.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b03534d71d61dfb61da62c509f032f75ac5ddfa6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/passthrough.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/retry.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/retry.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..97c02d2903715a56bc117bc34f8d88cb554bf2b2
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/retry.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/router.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/router.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f1eef58eef078d6fc5fbf8a7932b51e8fa113c19
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/router.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/schema.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/schema.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..b146349729618c18a9cbb9a5e7450388d1a2abef
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/schema.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c0ca3e5d13ff01dc258b6ef4ec823217e069ea63
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/runnables/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/runnables/base.py b/llm/Lib/site-packages/langchain_core/runnables/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..a29a0677ee9908b5869be4f92a5ecc2c92fcd400
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/base.py
@@ -0,0 +1,5038 @@
+from __future__ import annotations
+
+import asyncio
+import collections
+import inspect
+import threading
+from abc import ABC, abstractmethod
+from concurrent.futures import FIRST_COMPLETED, wait
+from contextvars import copy_context
+from functools import wraps
+from itertools import groupby, tee
+from operator import itemgetter
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Awaitable,
+    Callable,
+    Coroutine,
+    Dict,
+    Generic,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+    overload,
+)
+
+from typing_extensions import Literal, get_args
+
+from langchain_core._api import beta_decorator
+from langchain_core.load.dump import dumpd
+from langchain_core.load.serializable import (
+    Serializable,
+    SerializedConstructor,
+    SerializedNotImplemented,
+)
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_core.runnables.config import (
+    RunnableConfig,
+    acall_func_with_variable_args,
+    call_func_with_variable_args,
+    ensure_config,
+    get_async_callback_manager_for_config,
+    get_callback_manager_for_config,
+    get_config_list,
+    get_executor_for_config,
+    merge_configs,
+    patch_config,
+    run_in_executor,
+    var_child_runnable_config,
+)
+from langchain_core.runnables.graph import Graph
+from langchain_core.runnables.schema import EventData, StreamEvent
+from langchain_core.runnables.utils import (
+    AddableDict,
+    AnyConfigurableField,
+    ConfigurableField,
+    ConfigurableFieldSpec,
+    Input,
+    Output,
+    accepts_config,
+    accepts_context,
+    accepts_run_manager,
+    adapt_first_streaming_chunk,
+    create_model,
+    gather_with_concurrency,
+    get_function_first_arg_dict_keys,
+    get_function_nonlocals,
+    get_lambda_source,
+    get_unique_config_specs,
+    indent_lines_after_first,
+)
+from langchain_core.utils.aiter import atee, py_anext
+from langchain_core.utils.iter import safetee
+
+if TYPE_CHECKING:
+    from langchain_core.callbacks.manager import (
+        AsyncCallbackManagerForChainRun,
+        CallbackManagerForChainRun,
+    )
+    from langchain_core.prompts.base import BasePromptTemplate
+    from langchain_core.runnables.fallbacks import (
+        RunnableWithFallbacks as RunnableWithFallbacksT,
+    )
+    from langchain_core.tracers.log_stream import (
+        LogEntry,
+        RunLog,
+        RunLogPatch,
+    )
+    from langchain_core.tracers.root_listeners import Listener
+
+
+Other = TypeVar("Other")
+
+
+class Runnable(Generic[Input, Output], ABC):
+    """A unit of work that can be invoked, batched, streamed, transformed and composed.
+
+     Key Methods
+     ===========
+
+    - **invoke/ainvoke**: Transforms a single input into an output.
+    - **batch/abatch**: Efficiently transforms multiple inputs into outputs.
+    - **stream/astream**: Streams output from a single input as it's produced.
+    - **astream_log**: Streams output and selected intermediate results from an input.
+
+    Built-in optimizations:
+
+    - **Batch**: By default, batch runs invoke() in parallel using a thread pool executor.
+             Override to optimize batching.
+
+    - **Async**: Methods with "a" suffix are asynchronous. By default, they execute
+             the sync counterpart using asyncio's thread pool.
+             Override for native async.
+
+    All methods accept an optional config argument, which can be used to configure
+    execution, add tags and metadata for tracing and debugging etc.
+
+    Runnables expose schematic information about their input, output and config via
+    the input_schema property, the output_schema property and config_schema method.
+
+    LCEL and Composition
+    ====================
+
+    The LangChain Expression Language (LCEL) is a declarative way to compose Runnables
+    into chains. Any chain constructed this way will automatically have sync, async,
+    batch, and streaming support.
+
+    The main composition primitives are RunnableSequence and RunnableParallel.
+
+    RunnableSequence invokes a series of runnables sequentially, with one runnable's
+    output serving as the next's input. Construct using the `|` operator or by
+    passing a list of runnables to RunnableSequence.
+
+    RunnableParallel invokes runnables concurrently, providing the same input
+    to each. Construct it using a dict literal within a sequence or by passing a
+    dict to RunnableParallel.
+
+
+    For example,
+
+    .. code-block:: python
+
+        from langchain_core.runnables import RunnableLambda
+
+        # A RunnableSequence constructed using the `|` operator
+        sequence = RunnableLambda(lambda x: x + 1) | RunnableLambda(lambda x: x * 2)
+        sequence.invoke(1) # 4
+        sequence.batch([1, 2, 3]) # [4, 6, 8]
+
+
+        # A sequence that contains a RunnableParallel constructed using a dict literal
+        sequence = RunnableLambda(lambda x: x + 1) | {
+            'mul_2': RunnableLambda(lambda x: x * 2),
+            'mul_5': RunnableLambda(lambda x: x * 5)
+        }
+        sequence.invoke(1) # {'mul_2': 4, 'mul_5': 10}
+
+    Standard Methods
+    ================
+
+    All Runnables expose additional methods that can be used to modify their behavior
+    (e.g., add a retry policy, add lifecycle listeners, make them configurable, etc.).
+
+    These methods will work on any Runnable, including Runnable chains constructed
+    by composing other Runnables. See the individual methods for details.
+
+    For example,
+
+    .. code-block:: python
+
+        from langchain_core.runnables import RunnableLambda
+
+        import random
+
+        def add_one(x: int) -> int:
+            return x + 1
+
+
+        def buggy_double(y: int) -> int:
+            '''Buggy code that will fail 70% of the time'''
+            if random.random() > 0.3:
+                print('This code failed, and will probably be retried!')  # noqa: T201
+                raise ValueError('Triggered buggy code')
+            return y * 2
+
+        sequence = (
+            RunnableLambda(add_one) |
+            RunnableLambda(buggy_double).with_retry( # Retry on failure
+                stop_after_attempt=10,
+                wait_exponential_jitter=False
+            )
+        )
+
+        print(sequence.input_schema.schema()) # Show inferred input schema
+        print(sequence.output_schema.schema()) # Show inferred output schema
+        print(sequence.invoke(2)) # invoke the sequence (note the retry above!!)
+
+    Debugging and tracing
+    =====================
+
+    As the chains get longer, it can be useful to be able to see intermediate results
+    to debug and trace the chain.
+
+    You can set the global debug flag to True to enable debug output for all chains:
+
+        .. code-block:: python
+
+            from langchain_core.globals import set_debug
+            set_debug(True)
+
+    Alternatively, you can pass existing or custom callbacks to any given chain:
+
+        .. code-block:: python
+
+            from langchain_core.tracers import ConsoleCallbackHandler
+
+            chain.invoke(
+                ...,
+                config={'callbacks': [ConsoleCallbackHandler()]}
+            )
+
+    For a UI (and much more) checkout LangSmith: https://docs.smith.langchain.com/
+    """  # noqa: E501
+
+    name: Optional[str] = None
+    """The name of the runnable. Used for debugging and tracing."""
+
+    def get_name(
+        self, suffix: Optional[str] = None, *, name: Optional[str] = None
+    ) -> str:
+        """Get the name of the runnable."""
+        name = name or self.name or self.__class__.__name__
+        if suffix:
+            if name[0].isupper():
+                return name + suffix.title()
+            else:
+                return name + "_" + suffix.lower()
+        else:
+            return name
+
+    @property
+    def InputType(self) -> Type[Input]:
+        """The type of input this runnable accepts specified as a type annotation."""
+        for cls in self.__class__.__orig_bases__:  # type: ignore[attr-defined]
+            type_args = get_args(cls)
+            if type_args and len(type_args) == 2:
+                return type_args[0]
+
+        raise TypeError(
+            f"Runnable {self.get_name()} doesn't have an inferable InputType. "
+            "Override the InputType property to specify the input type."
+        )
+
+    @property
+    def OutputType(self) -> Type[Output]:
+        """The type of output this runnable produces specified as a type annotation."""
+        for cls in self.__class__.__orig_bases__:  # type: ignore[attr-defined]
+            type_args = get_args(cls)
+            if type_args and len(type_args) == 2:
+                return type_args[1]
+
+        raise TypeError(
+            f"Runnable {self.get_name()} doesn't have an inferable OutputType. "
+            "Override the OutputType property to specify the output type."
+        )
+
+    @property
+    def input_schema(self) -> Type[BaseModel]:
+        """The type of input this runnable accepts specified as a pydantic model."""
+        return self.get_input_schema()
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        """Get a pydantic model that can be used to validate input to the runnable.
+
+        Runnables that leverage the configurable_fields and configurable_alternatives
+        methods will have a dynamic input schema that depends on which
+        configuration the runnable is invoked with.
+
+        This method allows to get an input schema for a specific configuration.
+
+        Args:
+            config: A config to use when generating the schema.
+
+        Returns:
+            A pydantic model that can be used to validate input.
+        """
+        root_type = self.InputType
+
+        if inspect.isclass(root_type) and issubclass(root_type, BaseModel):
+            return root_type
+
+        return create_model(
+            self.get_name("Input"),
+            __root__=(root_type, None),
+        )
+
+    @property
+    def output_schema(self) -> Type[BaseModel]:
+        """The type of output this runnable produces specified as a pydantic model."""
+        return self.get_output_schema()
+
+    def get_output_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        """Get a pydantic model that can be used to validate output to the runnable.
+
+        Runnables that leverage the configurable_fields and configurable_alternatives
+        methods will have a dynamic output schema that depends on which
+        configuration the runnable is invoked with.
+
+        This method allows to get an output schema for a specific configuration.
+
+        Args:
+            config: A config to use when generating the schema.
+
+        Returns:
+            A pydantic model that can be used to validate output.
+        """
+        root_type = self.OutputType
+
+        if inspect.isclass(root_type) and issubclass(root_type, BaseModel):
+            return root_type
+
+        return create_model(
+            self.get_name("Output"),
+            __root__=(root_type, None),
+        )
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        """List configurable fields for this runnable."""
+        return []
+
+    def config_schema(
+        self, *, include: Optional[Sequence[str]] = None
+    ) -> Type[BaseModel]:
+        """The type of config this runnable accepts specified as a pydantic model.
+
+        To mark a field as configurable, see the `configurable_fields`
+        and `configurable_alternatives` methods.
+
+        Args:
+            include: A list of fields to include in the config schema.
+
+        Returns:
+            A pydantic model that can be used to validate config.
+        """
+
+        include = include or []
+        config_specs = self.config_specs
+        configurable = (
+            create_model(  # type: ignore[call-overload]
+                "Configurable",
+                **{
+                    spec.id: (
+                        spec.annotation,
+                        Field(
+                            spec.default, title=spec.name, description=spec.description
+                        ),
+                    )
+                    for spec in config_specs
+                },
+            )
+            if config_specs
+            else None
+        )
+
+        return create_model(  # type: ignore[call-overload]
+            self.get_name("Config"),
+            **({"configurable": (configurable, None)} if configurable else {}),
+            **{
+                field_name: (field_type, None)
+                for field_name, field_type in RunnableConfig.__annotations__.items()
+                if field_name in [i for i in include if i != "configurable"]
+            },
+        )
+
+    def get_graph(self, config: Optional[RunnableConfig] = None) -> Graph:
+        """Return a graph representation of this runnable."""
+        from langchain_core.runnables.graph import Graph
+
+        graph = Graph()
+        input_node = graph.add_node(self.get_input_schema(config))
+        runnable_node = graph.add_node(self)
+        output_node = graph.add_node(self.get_output_schema(config))
+        graph.add_edge(input_node, runnable_node)
+        graph.add_edge(runnable_node, output_node)
+        return graph
+
+    def get_prompts(
+        self, config: Optional[RunnableConfig] = None
+    ) -> List[BasePromptTemplate]:
+        from langchain_core.prompts.base import BasePromptTemplate
+
+        prompts = []
+        for _, node in self.get_graph(config=config).nodes.items():
+            if isinstance(node.data, BasePromptTemplate):
+                prompts.append(node.data)
+        return prompts
+
+    def __or__(
+        self,
+        other: Union[
+            Runnable[Any, Other],
+            Callable[[Any], Other],
+            Callable[[Iterator[Any]], Iterator[Other]],
+            Mapping[str, Union[Runnable[Any, Other], Callable[[Any], Other], Any]],
+        ],
+    ) -> RunnableSerializable[Input, Other]:
+        """Compose this runnable with another object to create a RunnableSequence."""
+        return RunnableSequence(self, coerce_to_runnable(other))
+
+    def __ror__(
+        self,
+        other: Union[
+            Runnable[Other, Any],
+            Callable[[Other], Any],
+            Callable[[Iterator[Other]], Iterator[Any]],
+            Mapping[str, Union[Runnable[Other, Any], Callable[[Other], Any], Any]],
+        ],
+    ) -> RunnableSerializable[Other, Output]:
+        """Compose this runnable with another object to create a RunnableSequence."""
+        return RunnableSequence(coerce_to_runnable(other), self)
+
+    def pipe(
+        self,
+        *others: Union[Runnable[Any, Other], Callable[[Any], Other]],
+        name: Optional[str] = None,
+    ) -> RunnableSerializable[Input, Other]:
+        """Compose this Runnable with Runnable-like objects to make a RunnableSequence.
+
+        Equivalent to `RunnableSequence(self, *others)` or `self | others[0] | ...`
+
+        Example:
+            .. code-block:: python
+
+                from langchain_core.runnables import RunnableLambda
+
+                def add_one(x: int) -> int:
+                    return x + 1
+
+                def mul_two(x: int) -> int:
+                    return x * 2
+
+                runnable_1 = RunnableLambda(add_one)
+                runnable_2 = RunnableLambda(mul_two)
+                sequence = runnable_1.pipe(runnable_2)
+                # Or equivalently:
+                # sequence = runnable_1 | runnable_2
+                # sequence = RunnableSequence(first=runnable_1, last=runnable_2)
+                sequence.invoke(1)
+                await sequence.ainvoke(1)
+                # -> 4
+
+                sequence.batch([1, 2, 3])
+                await sequence.abatch([1, 2, 3])
+                # -> [4, 6, 8]
+        """
+        return RunnableSequence(self, *others, name=name)
+
+    def pick(self, keys: Union[str, List[str]]) -> RunnableSerializable[Any, Any]:
+        """Pick keys from the dict output of this runnable.
+
+        Pick single key:
+            .. code-block:: python
+
+                import json
+
+                from langchain_core.runnables import RunnableLambda, RunnableMap
+
+                as_str = RunnableLambda(str)
+                as_json = RunnableLambda(json.loads)
+                chain = RunnableMap(str=as_str, json=as_json)
+
+                chain.invoke("[1, 2, 3]")
+                # -> {"str": "[1, 2, 3]", "json": [1, 2, 3]}
+
+                json_only_chain = chain.pick("json")
+                json_only_chain.invoke("[1, 2, 3]")
+                # -> [1, 2, 3]
+
+        Pick list of keys:
+            .. code-block:: python
+
+                from typing import Any
+
+                import json
+
+                from langchain_core.runnables import RunnableLambda, RunnableMap
+
+                as_str = RunnableLambda(str)
+                as_json = RunnableLambda(json.loads)
+                def as_bytes(x: Any) -> bytes:
+                    return bytes(x, "utf-8")
+
+                chain = RunnableMap(
+                    str=as_str,
+                    json=as_json,
+                    bytes=RunnableLambda(as_bytes)
+                )
+
+                chain.invoke("[1, 2, 3]")
+                # -> {"str": "[1, 2, 3]", "json": [1, 2, 3], "bytes": b"[1, 2, 3]"}
+
+                json_and_bytes_chain = chain.pick(["json", "bytes"])
+                json_and_bytes_chain.invoke("[1, 2, 3]")
+                # -> {"json": [1, 2, 3], "bytes": b"[1, 2, 3]"}
+
+        """  # noqa: E501
+        from langchain_core.runnables.passthrough import RunnablePick
+
+        return self | RunnablePick(keys)
+
+    def assign(
+        self,
+        **kwargs: Union[
+            Runnable[Dict[str, Any], Any],
+            Callable[[Dict[str, Any]], Any],
+            Mapping[
+                str,
+                Union[Runnable[Dict[str, Any], Any], Callable[[Dict[str, Any]], Any]],
+            ],
+        ],
+    ) -> RunnableSerializable[Any, Any]:
+        """Assigns new fields to the dict output of this runnable.
+        Returns a new runnable.
+
+        .. code-block:: python
+
+            from langchain_community.llms.fake import FakeStreamingListLLM
+            from langchain_core.output_parsers import StrOutputParser
+            from langchain_core.prompts import SystemMessagePromptTemplate
+            from langchain_core.runnables import Runnable
+            from operator import itemgetter
+
+            prompt = (
+                SystemMessagePromptTemplate.from_template("You are a nice assistant.")
+                + "{question}"
+            )
+            llm = FakeStreamingListLLM(responses=["foo-lish"])
+
+            chain: Runnable = prompt | llm | {"str": StrOutputParser()}
+
+            chain_with_assign = chain.assign(hello=itemgetter("str") | llm)
+
+            print(chain_with_assign.input_schema.schema())
+            # {'title': 'PromptInput', 'type': 'object', 'properties':
+            {'question': {'title': 'Question', 'type': 'string'}}}
+            print(chain_with_assign.output_schema.schema()) #
+            {'title': 'RunnableSequenceOutput', 'type': 'object', 'properties':
+            {'str': {'title': 'Str',
+            'type': 'string'}, 'hello': {'title': 'Hello', 'type': 'string'}}}
+
+        """
+        from langchain_core.runnables.passthrough import RunnableAssign
+
+        return self | RunnableAssign(RunnableParallel(kwargs))
+
+    """ --- Public API --- """
+
+    @abstractmethod
+    def invoke(self, input: Input, config: Optional[RunnableConfig] = None) -> Output:
+        """Transform a single input into an output. Override to implement.
+
+        Args:
+            input: The input to the runnable.
+            config: A config to use when invoking the runnable.
+               The config supports standard keys like 'tags', 'metadata' for tracing
+               purposes, 'max_concurrency' for controlling how much work to do
+               in parallel, and other keys. Please refer to the RunnableConfig
+               for more details.
+
+        Returns:
+            The output of the runnable.
+        """
+
+    async def ainvoke(
+        self, input: Input, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> Output:
+        """Default implementation of ainvoke, calls invoke from a thread.
+
+        The default implementation allows usage of async code even if
+        the runnable did not implement a native async version of invoke.
+
+        Subclasses should override this method if they can run asynchronously.
+        """
+        return await run_in_executor(config, self.invoke, input, config, **kwargs)
+
+    def batch(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        """Default implementation runs invoke in parallel using a thread pool executor.
+
+        The default implementation of batch works well for IO bound runnables.
+
+        Subclasses should override this method if they can batch more efficiently;
+        e.g., if the underlying runnable uses an API which supports a batch mode.
+        """
+        if not inputs:
+            return []
+
+        configs = get_config_list(config, len(inputs))
+
+        def invoke(input: Input, config: RunnableConfig) -> Union[Output, Exception]:
+            if return_exceptions:
+                try:
+                    return self.invoke(input, config, **kwargs)
+                except Exception as e:
+                    return e
+            else:
+                return self.invoke(input, config, **kwargs)
+
+        # If there's only one input, don't bother with the executor
+        if len(inputs) == 1:
+            return cast(List[Output], [invoke(inputs[0], configs[0])])
+
+        with get_executor_for_config(configs[0]) as executor:
+            return cast(List[Output], list(executor.map(invoke, inputs, configs)))
+
+    @overload
+    def batch_as_completed(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: Literal[False] = False,
+        **kwargs: Any,
+    ) -> Iterator[Tuple[int, Output]]:
+        ...
+
+    @overload
+    def batch_as_completed(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: Literal[True],
+        **kwargs: Any,
+    ) -> Iterator[Tuple[int, Union[Output, Exception]]]:
+        ...
+
+    def batch_as_completed(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Tuple[int, Union[Output, Exception]]]:
+        """Run invoke in parallel on a list of inputs,
+        yielding results as they complete."""
+
+        if not inputs:
+            return
+
+        configs = get_config_list(config, len(inputs))
+
+        def invoke(
+            i: int, input: Input, config: RunnableConfig
+        ) -> Tuple[int, Union[Output, Exception]]:
+            if return_exceptions:
+                try:
+                    out: Union[Output, Exception] = self.invoke(input, config, **kwargs)
+                except Exception as e:
+                    out = e
+            else:
+                out = self.invoke(input, config, **kwargs)
+
+            return (i, out)
+
+        if len(inputs) == 1:
+            yield invoke(0, inputs[0], configs[0])
+            return
+
+        with get_executor_for_config(configs[0]) as executor:
+            futures = {
+                executor.submit(invoke, i, input, config)
+                for i, (input, config) in enumerate(zip(inputs, configs))
+            }
+
+            try:
+                while futures:
+                    done, futures = wait(futures, return_when=FIRST_COMPLETED)
+                    while done:
+                        yield done.pop().result()
+            finally:
+                for future in futures:
+                    future.cancel()
+
+    async def abatch(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        """Default implementation runs ainvoke in parallel using asyncio.gather.
+
+        The default implementation of batch works well for IO bound runnables.
+
+        Subclasses should override this method if they can batch more efficiently;
+        e.g., if the underlying runnable uses an API which supports a batch mode.
+        """
+        if not inputs:
+            return []
+
+        configs = get_config_list(config, len(inputs))
+
+        async def ainvoke(
+            input: Input, config: RunnableConfig
+        ) -> Union[Output, Exception]:
+            if return_exceptions:
+                try:
+                    return await self.ainvoke(input, config, **kwargs)
+                except Exception as e:
+                    return e
+            else:
+                return await self.ainvoke(input, config, **kwargs)
+
+        coros = map(ainvoke, inputs, configs)
+        return await gather_with_concurrency(configs[0].get("max_concurrency"), *coros)
+
+    @overload
+    def abatch_as_completed(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: Literal[False] = False,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Tuple[int, Output]]:
+        ...
+
+    @overload
+    def abatch_as_completed(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: Literal[True],
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Tuple[int, Union[Output, Exception]]]:
+        ...
+
+    async def abatch_as_completed(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Tuple[int, Union[Output, Exception]]]:
+        """Run ainvoke in parallel on a list of inputs,
+        yielding results as they complete."""
+
+        if not inputs:
+            return
+
+        configs = get_config_list(config, len(inputs))
+
+        async def ainvoke(
+            i: int, input: Input, config: RunnableConfig
+        ) -> Tuple[int, Union[Output, Exception]]:
+            if return_exceptions:
+                try:
+                    out: Union[Output, Exception] = await self.ainvoke(
+                        input, config, **kwargs
+                    )
+                except Exception as e:
+                    out = e
+            else:
+                out = await self.ainvoke(input, config, **kwargs)
+
+            return (i, out)
+
+        coros = map(ainvoke, range(len(inputs)), inputs, configs)
+
+        for coro in asyncio.as_completed(coros):
+            yield await coro
+
+    def stream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Output]:
+        """
+        Default implementation of stream, which calls invoke.
+        Subclasses should override this method if they support streaming output.
+        """
+        yield self.invoke(input, config, **kwargs)
+
+    async def astream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Output]:
+        """
+        Default implementation of astream, which calls ainvoke.
+        Subclasses should override this method if they support streaming output.
+        """
+        yield await self.ainvoke(input, config, **kwargs)
+
+    @overload
+    def astream_log(
+        self,
+        input: Any,
+        config: Optional[RunnableConfig] = None,
+        *,
+        diff: Literal[True] = True,
+        with_streamed_output_list: bool = True,
+        include_names: Optional[Sequence[str]] = None,
+        include_types: Optional[Sequence[str]] = None,
+        include_tags: Optional[Sequence[str]] = None,
+        exclude_names: Optional[Sequence[str]] = None,
+        exclude_types: Optional[Sequence[str]] = None,
+        exclude_tags: Optional[Sequence[str]] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[RunLogPatch]:
+        ...
+
+    @overload
+    def astream_log(
+        self,
+        input: Any,
+        config: Optional[RunnableConfig] = None,
+        *,
+        diff: Literal[False],
+        with_streamed_output_list: bool = True,
+        include_names: Optional[Sequence[str]] = None,
+        include_types: Optional[Sequence[str]] = None,
+        include_tags: Optional[Sequence[str]] = None,
+        exclude_names: Optional[Sequence[str]] = None,
+        exclude_types: Optional[Sequence[str]] = None,
+        exclude_tags: Optional[Sequence[str]] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[RunLog]:
+        ...
+
+    async def astream_log(
+        self,
+        input: Any,
+        config: Optional[RunnableConfig] = None,
+        *,
+        diff: bool = True,
+        with_streamed_output_list: bool = True,
+        include_names: Optional[Sequence[str]] = None,
+        include_types: Optional[Sequence[str]] = None,
+        include_tags: Optional[Sequence[str]] = None,
+        exclude_names: Optional[Sequence[str]] = None,
+        exclude_types: Optional[Sequence[str]] = None,
+        exclude_tags: Optional[Sequence[str]] = None,
+        **kwargs: Any,
+    ) -> Union[AsyncIterator[RunLogPatch], AsyncIterator[RunLog]]:
+        """
+        Stream all output from a runnable, as reported to the callback system.
+        This includes all inner runs of LLMs, Retrievers, Tools, etc.
+
+        Output is streamed as Log objects, which include a list of
+        jsonpatch ops that describe how the state of the run has changed in each
+        step, and the final state of the run.
+
+        The jsonpatch ops can be applied in order to construct state.
+
+        Args:
+            input: The input to the runnable.
+            config: The config to use for the runnable.
+            diff: Whether to yield diffs between each step, or the current state.
+            with_streamed_output_list: Whether to yield the streamed_output list.
+            include_names: Only include logs with these names.
+            include_types: Only include logs with these types.
+            include_tags: Only include logs with these tags.
+            exclude_names: Exclude logs with these names.
+            exclude_types: Exclude logs with these types.
+            exclude_tags: Exclude logs with these tags.
+        """
+        from langchain_core.tracers.log_stream import (
+            LogStreamCallbackHandler,
+            _astream_log_implementation,
+        )
+
+        stream = LogStreamCallbackHandler(
+            auto_close=False,
+            include_names=include_names,
+            include_types=include_types,
+            include_tags=include_tags,
+            exclude_names=exclude_names,
+            exclude_types=exclude_types,
+            exclude_tags=exclude_tags,
+            _schema_format="original",
+        )
+
+        # Mypy isn't resolving the overloads here
+        # Likely an issue b/c `self` is being passed through
+        # and it's can't map it to Runnable[Input,Output]?
+        async for item in _astream_log_implementation(  # type: ignore
+            self,
+            input,
+            config,
+            diff=diff,
+            stream=stream,
+            with_streamed_output_list=with_streamed_output_list,
+            **kwargs,
+        ):
+            yield item
+
+    @beta_decorator.beta(message="This API is in beta and may change in the future.")
+    async def astream_events(
+        self,
+        input: Any,
+        config: Optional[RunnableConfig] = None,
+        *,
+        version: Literal["v1"],
+        include_names: Optional[Sequence[str]] = None,
+        include_types: Optional[Sequence[str]] = None,
+        include_tags: Optional[Sequence[str]] = None,
+        exclude_names: Optional[Sequence[str]] = None,
+        exclude_types: Optional[Sequence[str]] = None,
+        exclude_tags: Optional[Sequence[str]] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[StreamEvent]:
+        """Generate a stream of events.
+
+        Use to create an iterator over StreamEvents that provide real-time information
+        about the progress of the runnable, including StreamEvents from intermediate
+        results.
+
+        A StreamEvent is a dictionary with the following schema:
+
+        - ``event``: **str** - Event names are of the
+            format: on_[runnable_type]_(start|stream|end).
+        - ``name``: **str** - The name of the runnable that generated the event.
+        - ``run_id``: **str** - randomly generated ID associated with the given execution of
+            the runnable that emitted the event.
+            A child runnable that gets invoked as part of the execution of a
+            parent runnable is assigned its own unique ID.
+        - ``tags``: **Optional[List[str]]** - The tags of the runnable that generated
+            the event.
+        - ``metadata``: **Optional[Dict[str, Any]]** - The metadata of the runnable
+            that generated the event.
+        - ``data``: **Dict[str, Any]**
+
+
+        Below is a table that illustrates some evens that might be emitted by various
+        chains. Metadata fields have been omitted from the table for brevity.
+        Chain definitions have been included after the table.
+
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | event                | name             | chunk                           | input                                         | output                                          |
+        +======================+==================+=================================+===============================================+=================================================+
+        | on_chat_model_start  | [model name]     |                                 | {"messages": [[SystemMessage, HumanMessage]]} |                                                 |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_chat_model_stream | [model name]     | AIMessageChunk(content="hello") |                                               |                                                 |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_chat_model_end    | [model name]     |                                 | {"messages": [[SystemMessage, HumanMessage]]} | {"generations": [...], "llm_output": None, ...} |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_llm_start         | [model name]     |                                 | {'input': 'hello'}                            |                                                 |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_llm_stream        | [model name]     | 'Hello'                         |                                               |                                                 |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_llm_end           | [model name]     |                                 | 'Hello human!'                                |                                                 |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_chain_start       | format_docs      |                                 |                                               |                                                 |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_chain_stream      | format_docs      | "hello world!, goodbye world!"  |                                               |                                                 |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_chain_end         | format_docs      |                                 | [Document(...)]                               | "hello world!, goodbye world!"                  |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_tool_start        | some_tool        |                                 | {"x": 1, "y": "2"}                            |                                                 |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_tool_stream       | some_tool        | {"x": 1, "y": "2"}              |                                               |                                                 |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_tool_end          | some_tool        |                                 |                                               | {"x": 1, "y": "2"}                              |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_retriever_start   | [retriever name] |                                 | {"query": "hello"}                            |                                                 |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_retriever_chunk   | [retriever name] | {documents: [...]}              |                                               |                                                 |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_retriever_end     | [retriever name] |                                 | {"query": "hello"}                            | {documents: [...]}                              |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_prompt_start      | [template_name]  |                                 | {"question": "hello"}                         |                                                 |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+        | on_prompt_end        | [template_name]  |                                 | {"question": "hello"}                         | ChatPromptValue(messages: [SystemMessage, ...]) |
+        +----------------------+------------------+---------------------------------+-----------------------------------------------+-------------------------------------------------+
+
+        Here are declarations associated with the events shown above:
+
+        `format_docs`:
+
+        .. code-block:: python
+
+            def format_docs(docs: List[Document]) -> str:
+                '''Format the docs.'''
+                return ", ".join([doc.page_content for doc in docs])
+
+            format_docs = RunnableLambda(format_docs)
+
+        `some_tool`:
+
+        .. code-block:: python
+
+            @tool
+            def some_tool(x: int, y: str) -> dict:
+                '''Some_tool.'''
+                return {"x": x, "y": y}
+
+        `prompt`:
+
+        .. code-block:: python
+
+            template = ChatPromptTemplate.from_messages(
+                [("system", "You are Cat Agent 007"), ("human", "{question}")]
+            ).with_config({"run_name": "my_template", "tags": ["my_template"]})
+
+
+        Example:
+
+        .. code-block:: python
+
+            from langchain_core.runnables import RunnableLambda
+
+            async def reverse(s: str) -> str:
+                return s[::-1]
+
+            chain = RunnableLambda(func=reverse)
+
+            events = [
+                event async for event in chain.astream_events("hello", version="v1")
+            ]
+
+            # will produce the following events (run_id has been omitted for brevity):
+            [
+                {
+                    "data": {"input": "hello"},
+                    "event": "on_chain_start",
+                    "metadata": {},
+                    "name": "reverse",
+                    "tags": [],
+                },
+                {
+                    "data": {"chunk": "olleh"},
+                    "event": "on_chain_stream",
+                    "metadata": {},
+                    "name": "reverse",
+                    "tags": [],
+                },
+                {
+                    "data": {"output": "olleh"},
+                    "event": "on_chain_end",
+                    "metadata": {},
+                    "name": "reverse",
+                    "tags": [],
+                },
+            ]
+
+        Args:
+            input: The input to the runnable.
+            config: The config to use for the runnable.
+            version: The version of the schema to use.
+                     Currently only version 1 is available.
+                     No default will be assigned until the API is stabilized.
+            include_names: Only include events from runnables with matching names.
+            include_types: Only include events from runnables with matching types.
+            include_tags: Only include events from runnables with matching tags.
+            exclude_names: Exclude events from runnables with matching names.
+            exclude_types: Exclude events from runnables with matching types.
+            exclude_tags: Exclude events from runnables with matching tags.
+            kwargs: Additional keyword arguments to pass to the runnable.
+                These will be passed to astream_log as this implementation
+                of astream_events is built on top of astream_log.
+
+        Returns:
+            An async stream of StreamEvents.
+        """  # noqa: E501
+        if version != "v1":
+            raise NotImplementedError(
+                'Only version "v1" of the schema is currently supported.'
+            )
+
+        from langchain_core.runnables.utils import (
+            _RootEventFilter,
+        )
+        from langchain_core.tracers.log_stream import (
+            LogStreamCallbackHandler,
+            RunLog,
+            _astream_log_implementation,
+        )
+
+        stream = LogStreamCallbackHandler(
+            auto_close=False,
+            include_names=include_names,
+            include_types=include_types,
+            include_tags=include_tags,
+            exclude_names=exclude_names,
+            exclude_types=exclude_types,
+            exclude_tags=exclude_tags,
+            _schema_format="streaming_events",
+        )
+
+        run_log = RunLog(state=None)  # type: ignore[arg-type]
+        encountered_start_event = False
+
+        _root_event_filter = _RootEventFilter(
+            include_names=include_names,
+            include_types=include_types,
+            include_tags=include_tags,
+            exclude_names=exclude_names,
+            exclude_types=exclude_types,
+            exclude_tags=exclude_tags,
+        )
+
+        config = ensure_config(config)
+        root_tags = config.get("tags", [])
+        root_metadata = config.get("metadata", {})
+        root_name = config.get("run_name", self.get_name())
+
+        # Ignoring mypy complaint about too many different union combinations
+        # This arises because many of the argument types are unions
+        async for log in _astream_log_implementation(  # type: ignore[misc]
+            self,
+            input,
+            config=config,
+            stream=stream,
+            diff=True,
+            with_streamed_output_list=True,
+            **kwargs,
+        ):
+            run_log = run_log + log
+
+            if not encountered_start_event:
+                # Yield the start event for the root runnable.
+                encountered_start_event = True
+                state = run_log.state.copy()
+
+                event = StreamEvent(
+                    event=f"on_{state['type']}_start",
+                    run_id=state["id"],
+                    name=root_name,
+                    tags=root_tags,
+                    metadata=root_metadata,
+                    data={
+                        "input": input,
+                    },
+                )
+
+                if _root_event_filter.include_event(event, state["type"]):
+                    yield event
+
+            paths = {
+                op["path"].split("/")[2]
+                for op in log.ops
+                if op["path"].startswith("/logs/")
+            }
+            # Elements in a set should be iterated in the same order
+            # as they were inserted in modern python versions.
+            for path in paths:
+                data: EventData = {}
+                log_entry: LogEntry = run_log.state["logs"][path]
+                if log_entry["end_time"] is None:
+                    if log_entry["streamed_output"]:
+                        event_type = "stream"
+                    else:
+                        event_type = "start"
+                else:
+                    event_type = "end"
+
+                if event_type == "start":
+                    # Include the inputs with the start event if they are available.
+                    # Usually they will NOT be available for components that operate
+                    # on streams, since those components stream the input and
+                    # don't know its final value until the end of the stream.
+                    inputs = log_entry["inputs"]
+                    if inputs is not None:
+                        data["input"] = inputs
+                    pass
+
+                if event_type == "end":
+                    inputs = log_entry["inputs"]
+                    if inputs is not None:
+                        data["input"] = inputs
+
+                    # None is a VALID output for an end event
+                    data["output"] = log_entry["final_output"]
+
+                if event_type == "stream":
+                    num_chunks = len(log_entry["streamed_output"])
+                    if num_chunks != 1:
+                        raise AssertionError(
+                            f"Expected exactly one chunk of streamed output, "
+                            f"got {num_chunks} instead. This is impossible. "
+                            f"Encountered in: {log_entry['name']}"
+                        )
+
+                    data = {"chunk": log_entry["streamed_output"][0]}
+                    # Clean up the stream, we don't need it anymore.
+                    # And this avoids duplicates as well!
+                    log_entry["streamed_output"] = []
+
+                yield StreamEvent(
+                    event=f"on_{log_entry['type']}_{event_type}",
+                    name=log_entry["name"],
+                    run_id=log_entry["id"],
+                    tags=log_entry["tags"],
+                    metadata=log_entry["metadata"],
+                    data=data,
+                )
+
+            # Finally, we take care of the streaming output from the root chain
+            # if there is any.
+            state = run_log.state
+            if state["streamed_output"]:
+                num_chunks = len(state["streamed_output"])
+                if num_chunks != 1:
+                    raise AssertionError(
+                        f"Expected exactly one chunk of streamed output, "
+                        f"got {num_chunks} instead. This is impossible. "
+                        f"Encountered in: {state['name']}"
+                    )
+
+                data = {"chunk": state["streamed_output"][0]}
+                # Clean up the stream, we don't need it anymore.
+                state["streamed_output"] = []
+
+                event = StreamEvent(
+                    event=f"on_{state['type']}_stream",
+                    run_id=state["id"],
+                    tags=root_tags,
+                    metadata=root_metadata,
+                    name=root_name,
+                    data=data,
+                )
+                if _root_event_filter.include_event(event, state["type"]):
+                    yield event
+
+        state = run_log.state
+
+        # Finally yield the end event for the root runnable.
+        event = StreamEvent(
+            event=f"on_{state['type']}_end",
+            name=root_name,
+            run_id=state["id"],
+            tags=root_tags,
+            metadata=root_metadata,
+            data={
+                "output": state["final_output"],
+            },
+        )
+        if _root_event_filter.include_event(event, state["type"]):
+            yield event
+
+    def transform(
+        self,
+        input: Iterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Output]:
+        """
+        Default implementation of transform, which buffers input and then calls stream.
+        Subclasses should override this method if they can start producing output while
+        input is still being generated.
+        """
+        final: Input
+        got_first_val = False
+
+        for chunk in input:
+            if not got_first_val:
+                final = adapt_first_streaming_chunk(chunk)  # type: ignore
+                got_first_val = True
+            else:
+                # Make a best effort to gather, for any type that supports `+`
+                # This method should throw an error if gathering fails.
+                try:
+                    final = final + chunk  # type: ignore[operator]
+                except TypeError:
+                    raise TypeError(
+                        f"Failed while trying to add together "
+                        f"type {type(final)} and {type(chunk)}."
+                        f"These types should be addable for transform to work."
+                    )
+
+        if got_first_val:
+            yield from self.stream(final, config, **kwargs)
+
+    async def atransform(
+        self,
+        input: AsyncIterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Output]:
+        """
+        Default implementation of atransform, which buffers input and calls astream.
+        Subclasses should override this method if they can start producing output while
+        input is still being generated.
+        """
+        final: Input
+        got_first_val = False
+
+        async for chunk in input:
+            if not got_first_val:
+                final = adapt_first_streaming_chunk(chunk)  # type: ignore
+                got_first_val = True
+            else:
+                # Make a best effort to gather, for any type that supports `+`
+                # This method should throw an error if gathering fails.
+                try:
+                    final = final + chunk  # type: ignore[operator]
+                except TypeError:
+                    raise TypeError(
+                        f"Failed while trying to add together "
+                        f"type {type(final)} and {type(chunk)}."
+                        f"These types should be addable for atransform to work."
+                    )
+
+        if got_first_val:
+            async for output in self.astream(final, config, **kwargs):
+                yield output
+
+    def bind(self, **kwargs: Any) -> Runnable[Input, Output]:
+        """
+        Bind arguments to a Runnable, returning a new Runnable.
+
+        Useful when a runnable in a chain requires an argument that is not
+        in the output of the previous runnable or included in the user input.
+
+        Example:
+
+        .. code-block:: python
+
+            from langchain_community.chat_models import ChatOllama
+            from langchain_core.output_parsers import StrOutputParser
+
+            llm = ChatOllama(model='llama2')
+
+            # Without bind.
+            chain = (
+                llm
+                | StrOutputParser()
+            )
+
+            chain.invoke("Repeat quoted words exactly: 'One two three four five.'")
+            # Output is 'One two three four five.'
+
+            # With bind.
+            chain = (
+                llm.bind(stop=["three"])
+                | StrOutputParser()
+            )
+
+            chain.invoke("Repeat quoted words exactly: 'One two three four five.'")
+            # Output is 'One two'
+
+        """
+        return RunnableBinding(bound=self, kwargs=kwargs, config={})
+
+    def with_config(
+        self,
+        config: Optional[RunnableConfig] = None,
+        # Sadly Unpack is not well supported by mypy so this will have to be untyped
+        **kwargs: Any,
+    ) -> Runnable[Input, Output]:
+        """
+        Bind config to a Runnable, returning a new Runnable.
+        """
+        return RunnableBinding(
+            bound=self,
+            config=cast(
+                RunnableConfig,
+                {**(config or {}), **kwargs},
+            ),  # type: ignore[misc]
+            kwargs={},
+        )
+
+    def with_listeners(
+        self,
+        *,
+        on_start: Optional[Listener] = None,
+        on_end: Optional[Listener] = None,
+        on_error: Optional[Listener] = None,
+    ) -> Runnable[Input, Output]:
+        """
+        Bind lifecycle listeners to a Runnable, returning a new Runnable.
+
+        on_start: Called before the runnable starts running, with the Run object.
+        on_end: Called after the runnable finishes running, with the Run object.
+        on_error: Called if the runnable throws an error, with the Run object.
+
+        The Run object contains information about the run, including its id,
+        type, input, output, error, start_time, end_time, and any tags or metadata
+        added to the run.
+
+        Example:
+
+        .. code-block:: python
+            from langchain_core.runnables import RunnableLambda
+            import time
+
+            def test_runnable(time_to_sleep : int):
+                time.sleep(time_to_sleep)
+
+            def fn_start(run_obj : Runnable):
+                print("start_time:", run_obj.start_time)
+
+            def fn_end(run_obj : Runnable):
+                print("end_time:", run_obj.end_time)
+
+            RunnableLambda(test_runnable).with_listeners(
+                on_start=fn_start,
+                on_end=fn_end
+                ).invoke(2)
+        """
+        from langchain_core.tracers.root_listeners import RootListenersTracer
+
+        return RunnableBinding(
+            bound=self,
+            config_factories=[
+                lambda config: {
+                    "callbacks": [
+                        RootListenersTracer(
+                            config=config,
+                            on_start=on_start,
+                            on_end=on_end,
+                            on_error=on_error,
+                        )
+                    ],
+                }
+            ],
+        )
+
+    def with_types(
+        self,
+        *,
+        input_type: Optional[Type[Input]] = None,
+        output_type: Optional[Type[Output]] = None,
+    ) -> Runnable[Input, Output]:
+        """
+        Bind input and output types to a Runnable, returning a new Runnable.
+        """
+        return RunnableBinding(
+            bound=self,
+            custom_input_type=input_type,
+            custom_output_type=output_type,
+            kwargs={},
+        )
+
+    def with_retry(
+        self,
+        *,
+        retry_if_exception_type: Tuple[Type[BaseException], ...] = (Exception,),
+        wait_exponential_jitter: bool = True,
+        stop_after_attempt: int = 3,
+    ) -> Runnable[Input, Output]:
+        """Create a new Runnable that retries the original runnable on exceptions.
+
+        Example:
+
+        .. code-block:: python
+            from langchain_core.runnables import RunnableLambda
+
+            count = 0
+
+
+            def _lambda(x: int) -> None:
+                global count
+                count = count + 1
+                if x == 1:
+                    raise ValueError("x is 1")
+                else:
+                     pass
+
+
+            runnable = RunnableLambda(_lambda)
+            try:
+                runnable.with_retry(
+                    stop_after_attempt=2,
+                    retry_if_exception_type=(ValueError,),
+                ).invoke(1)
+            except ValueError:
+                pass
+
+            assert (count == 2)
+
+
+        Args:
+            retry_if_exception_type: A tuple of exception types to retry on
+            wait_exponential_jitter: Whether to add jitter to the wait time
+                                     between retries
+            stop_after_attempt: The maximum number of attempts to make before giving up
+
+        Returns:
+            A new Runnable that retries the original runnable on exceptions.
+        """
+        from langchain_core.runnables.retry import RunnableRetry
+
+        return RunnableRetry(
+            bound=self,
+            kwargs={},
+            config={},
+            retry_exception_types=retry_if_exception_type,
+            wait_exponential_jitter=wait_exponential_jitter,
+            max_attempt_number=stop_after_attempt,
+        )
+
+    def map(self) -> Runnable[List[Input], List[Output]]:
+        """
+        Return a new Runnable that maps a list of inputs to a list of outputs,
+        by calling invoke() with each input.
+
+        Example:
+
+            .. code-block:: python
+
+                    from langchain_core.runnables import RunnableLambda
+
+                    def _lambda(x: int) -> int:
+                        return x + 1
+
+                    runnable = RunnableLambda(_lambda)
+                    print(runnable.map().invoke([1, 2, 3])) # [2, 3, 4]
+        """
+        return RunnableEach(bound=self)
+
+    def with_fallbacks(
+        self,
+        fallbacks: Sequence[Runnable[Input, Output]],
+        *,
+        exceptions_to_handle: Tuple[Type[BaseException], ...] = (Exception,),
+        exception_key: Optional[str] = None,
+    ) -> RunnableWithFallbacksT[Input, Output]:
+        """Add fallbacks to a runnable, returning a new Runnable.
+
+        Example:
+
+            .. code-block:: python
+
+                from typing import Iterator
+
+                from langchain_core.runnables import RunnableGenerator
+
+
+                def _generate_immediate_error(input: Iterator) -> Iterator[str]:
+                    raise ValueError()
+                    yield ""
+
+
+                def _generate(input: Iterator) -> Iterator[str]:
+                    yield from "foo bar"
+
+
+                runnable = RunnableGenerator(_generate_immediate_error).with_fallbacks(
+                    [RunnableGenerator(_generate)]
+                    )
+                print(''.join(runnable.stream({}))) #foo bar
+
+        Args:
+            fallbacks: A sequence of runnables to try if the original runnable fails.
+            exceptions_to_handle: A tuple of exception types to handle.
+            exception_key: If string is specified then handled exceptions will be passed
+                to fallbacks as part of the input under the specified key. If None,
+                exceptions will not be passed to fallbacks. If used, the base runnable
+                and its fallbacks must accept a dictionary as input.
+
+        Returns:
+            A new Runnable that will try the original runnable, and then each
+            fallback in order, upon failures.
+
+        """
+        from langchain_core.runnables.fallbacks import RunnableWithFallbacks
+
+        return RunnableWithFallbacks(
+            runnable=self,
+            fallbacks=fallbacks,
+            exceptions_to_handle=exceptions_to_handle,
+            exception_key=exception_key,
+        )
+
+    """ --- Helper methods for Subclasses --- """
+
+    def _call_with_config(
+        self,
+        func: Union[
+            Callable[[Input], Output],
+            Callable[[Input, CallbackManagerForChainRun], Output],
+            Callable[[Input, CallbackManagerForChainRun, RunnableConfig], Output],
+        ],
+        input: Input,
+        config: Optional[RunnableConfig],
+        run_type: Optional[str] = None,
+        **kwargs: Optional[Any],
+    ) -> Output:
+        """Helper method to transform an Input value to an Output value,
+        with callbacks. Use this method to implement invoke() in subclasses."""
+        config = ensure_config(config)
+        callback_manager = get_callback_manager_for_config(config)
+        run_manager = callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            run_type=run_type,
+            name=config.get("run_name") or self.get_name(),
+            run_id=config.pop("run_id", None),
+        )
+        try:
+            child_config = patch_config(config, callbacks=run_manager.get_child())
+            context = copy_context()
+            context.run(var_child_runnable_config.set, child_config)
+            output = cast(
+                Output,
+                context.run(
+                    call_func_with_variable_args,  # type: ignore[arg-type]
+                    func,  # type: ignore[arg-type]
+                    input,  # type: ignore[arg-type]
+                    config,
+                    run_manager,
+                    **kwargs,
+                ),
+            )
+        except BaseException as e:
+            run_manager.on_chain_error(e)
+            raise
+        else:
+            run_manager.on_chain_end(output)
+            return output
+
+    async def _acall_with_config(
+        self,
+        func: Union[
+            Callable[[Input], Awaitable[Output]],
+            Callable[[Input, AsyncCallbackManagerForChainRun], Awaitable[Output]],
+            Callable[
+                [Input, AsyncCallbackManagerForChainRun, RunnableConfig],
+                Awaitable[Output],
+            ],
+        ],
+        input: Input,
+        config: Optional[RunnableConfig],
+        run_type: Optional[str] = None,
+        **kwargs: Optional[Any],
+    ) -> Output:
+        """Helper method to transform an Input value to an Output value,
+        with callbacks. Use this method to implement ainvoke() in subclasses."""
+        config = ensure_config(config)
+        callback_manager = get_async_callback_manager_for_config(config)
+        run_manager = await callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            run_type=run_type,
+            name=config.get("run_name") or self.get_name(),
+            run_id=config.pop("run_id", None),
+        )
+        try:
+            child_config = patch_config(config, callbacks=run_manager.get_child())
+            context = copy_context()
+            context.run(var_child_runnable_config.set, child_config)
+            coro = acall_func_with_variable_args(
+                func, input, config, run_manager, **kwargs
+            )
+            if accepts_context(asyncio.create_task):
+                output: Output = await asyncio.create_task(coro, context=context)  # type: ignore
+            else:
+                output = await coro
+        except BaseException as e:
+            await run_manager.on_chain_error(e)
+            raise
+        else:
+            await run_manager.on_chain_end(output)
+            return output
+
+    def _batch_with_config(
+        self,
+        func: Union[
+            Callable[[List[Input]], List[Union[Exception, Output]]],
+            Callable[
+                [List[Input], List[CallbackManagerForChainRun]],
+                List[Union[Exception, Output]],
+            ],
+            Callable[
+                [List[Input], List[CallbackManagerForChainRun], List[RunnableConfig]],
+                List[Union[Exception, Output]],
+            ],
+        ],
+        input: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        run_type: Optional[str] = None,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        """Helper method to transform an Input value to an Output value,
+        with callbacks. Use this method to implement invoke() in subclasses."""
+        if not input:
+            return []
+
+        configs = get_config_list(config, len(input))
+        callback_managers = [get_callback_manager_for_config(c) for c in configs]
+        run_managers = [
+            callback_manager.on_chain_start(
+                dumpd(self),
+                input,
+                run_type=run_type,
+                name=config.get("run_name") or self.get_name(),
+                run_id=config.pop("run_id", None),
+            )
+            for callback_manager, input, config in zip(
+                callback_managers, input, configs
+            )
+        ]
+        try:
+            if accepts_config(func):
+                kwargs["config"] = [
+                    patch_config(c, callbacks=rm.get_child())
+                    for c, rm in zip(configs, run_managers)
+                ]
+            if accepts_run_manager(func):
+                kwargs["run_manager"] = run_managers
+            output = func(input, **kwargs)  # type: ignore[call-arg]
+        except BaseException as e:
+            for run_manager in run_managers:
+                run_manager.on_chain_error(e)
+            if return_exceptions:
+                return cast(List[Output], [e for _ in input])
+            else:
+                raise
+        else:
+            first_exception: Optional[Exception] = None
+            for run_manager, out in zip(run_managers, output):
+                if isinstance(out, Exception):
+                    first_exception = first_exception or out
+                    run_manager.on_chain_error(out)
+                else:
+                    run_manager.on_chain_end(out)
+            if return_exceptions or first_exception is None:
+                return cast(List[Output], output)
+            else:
+                raise first_exception
+
+    async def _abatch_with_config(
+        self,
+        func: Union[
+            Callable[[List[Input]], Awaitable[List[Union[Exception, Output]]]],
+            Callable[
+                [List[Input], List[AsyncCallbackManagerForChainRun]],
+                Awaitable[List[Union[Exception, Output]]],
+            ],
+            Callable[
+                [
+                    List[Input],
+                    List[AsyncCallbackManagerForChainRun],
+                    List[RunnableConfig],
+                ],
+                Awaitable[List[Union[Exception, Output]]],
+            ],
+        ],
+        input: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        run_type: Optional[str] = None,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        """Helper method to transform an Input value to an Output value,
+        with callbacks. Use this method to implement invoke() in subclasses."""
+        if not input:
+            return []
+
+        configs = get_config_list(config, len(input))
+        callback_managers = [get_async_callback_manager_for_config(c) for c in configs]
+        run_managers: List[AsyncCallbackManagerForChainRun] = await asyncio.gather(
+            *(
+                callback_manager.on_chain_start(
+                    dumpd(self),
+                    input,
+                    run_type=run_type,
+                    name=config.get("run_name") or self.get_name(),
+                    run_id=config.pop("run_id", None),
+                )
+                for callback_manager, input, config in zip(
+                    callback_managers, input, configs
+                )
+            )
+        )
+        try:
+            if accepts_config(func):
+                kwargs["config"] = [
+                    patch_config(c, callbacks=rm.get_child())
+                    for c, rm in zip(configs, run_managers)
+                ]
+            if accepts_run_manager(func):
+                kwargs["run_manager"] = run_managers
+            output = await func(input, **kwargs)  # type: ignore[call-arg]
+        except BaseException as e:
+            await asyncio.gather(
+                *(run_manager.on_chain_error(e) for run_manager in run_managers)
+            )
+            if return_exceptions:
+                return cast(List[Output], [e for _ in input])
+            else:
+                raise
+        else:
+            first_exception: Optional[Exception] = None
+            coros: List[Awaitable[None]] = []
+            for run_manager, out in zip(run_managers, output):
+                if isinstance(out, Exception):
+                    first_exception = first_exception or out
+                    coros.append(run_manager.on_chain_error(out))
+                else:
+                    coros.append(run_manager.on_chain_end(out))
+            await asyncio.gather(*coros)
+            if return_exceptions or first_exception is None:
+                return cast(List[Output], output)
+            else:
+                raise first_exception
+
+    def _transform_stream_with_config(
+        self,
+        input: Iterator[Input],
+        transformer: Union[
+            Callable[[Iterator[Input]], Iterator[Output]],
+            Callable[[Iterator[Input], CallbackManagerForChainRun], Iterator[Output]],
+            Callable[
+                [
+                    Iterator[Input],
+                    CallbackManagerForChainRun,
+                    RunnableConfig,
+                ],
+                Iterator[Output],
+            ],
+        ],
+        config: Optional[RunnableConfig],
+        run_type: Optional[str] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Output]:
+        """Helper method to transform an Iterator of Input values into an Iterator of
+        Output values, with callbacks.
+        Use this to implement `stream()` or `transform()` in Runnable subclasses."""
+        # tee the input so we can iterate over it twice
+        input_for_tracing, input_for_transform = tee(input, 2)
+        # Start the input iterator to ensure the input runnable starts before this one
+        final_input: Optional[Input] = next(input_for_tracing, None)
+        final_input_supported = True
+        final_output: Optional[Output] = None
+        final_output_supported = True
+
+        config = ensure_config(config)
+        callback_manager = get_callback_manager_for_config(config)
+        run_manager = callback_manager.on_chain_start(
+            dumpd(self),
+            {"input": ""},
+            run_type=run_type,
+            name=config.get("run_name") or self.get_name(),
+            run_id=config.pop("run_id", None),
+        )
+        try:
+            child_config = patch_config(config, callbacks=run_manager.get_child())
+            if accepts_config(transformer):
+                kwargs["config"] = child_config
+            if accepts_run_manager(transformer):
+                kwargs["run_manager"] = run_manager
+            context = copy_context()
+            context.run(var_child_runnable_config.set, child_config)
+            iterator = context.run(transformer, input_for_transform, **kwargs)  # type: ignore[arg-type]
+            try:
+                while True:
+                    chunk: Output = context.run(next, iterator)  # type: ignore
+                    yield chunk
+                    if final_output_supported:
+                        if final_output is None:
+                            final_output = chunk
+                        else:
+                            try:
+                                final_output = final_output + chunk  # type: ignore
+                            except TypeError:
+                                final_output = chunk
+                                final_output_supported = False
+                    else:
+                        final_output = chunk
+            except StopIteration:
+                pass
+            for ichunk in input_for_tracing:
+                if final_input_supported:
+                    if final_input is None:
+                        final_input = ichunk
+                    else:
+                        try:
+                            final_input = final_input + ichunk  # type: ignore
+                        except TypeError:
+                            final_input = ichunk
+                            final_input_supported = False
+                else:
+                    final_input = ichunk
+        except BaseException as e:
+            run_manager.on_chain_error(e, inputs=final_input)
+            raise
+        else:
+            run_manager.on_chain_end(final_output, inputs=final_input)
+
+    async def _atransform_stream_with_config(
+        self,
+        input: AsyncIterator[Input],
+        transformer: Union[
+            Callable[[AsyncIterator[Input]], AsyncIterator[Output]],
+            Callable[
+                [AsyncIterator[Input], AsyncCallbackManagerForChainRun],
+                AsyncIterator[Output],
+            ],
+            Callable[
+                [
+                    AsyncIterator[Input],
+                    AsyncCallbackManagerForChainRun,
+                    RunnableConfig,
+                ],
+                AsyncIterator[Output],
+            ],
+        ],
+        config: Optional[RunnableConfig],
+        run_type: Optional[str] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Output]:
+        """Helper method to transform an Async Iterator of Input values into an Async
+        Iterator of Output values, with callbacks.
+        Use this to implement `astream()` or `atransform()` in Runnable subclasses."""
+        from langchain_core.tracers.log_stream import LogStreamCallbackHandler
+
+        # tee the input so we can iterate over it twice
+        input_for_tracing, input_for_transform = atee(input, 2)
+        # Start the input iterator to ensure the input runnable starts before this one
+        final_input: Optional[Input] = await py_anext(input_for_tracing, None)
+        final_input_supported = True
+        final_output: Optional[Output] = None
+        final_output_supported = True
+
+        config = ensure_config(config)
+        callback_manager = get_async_callback_manager_for_config(config)
+        run_manager = await callback_manager.on_chain_start(
+            dumpd(self),
+            {"input": ""},
+            run_type=run_type,
+            name=config.get("run_name") or self.get_name(),
+            run_id=config.pop("run_id", None),
+        )
+        try:
+            child_config = patch_config(config, callbacks=run_manager.get_child())
+            if accepts_config(transformer):
+                kwargs["config"] = child_config
+            if accepts_run_manager(transformer):
+                kwargs["run_manager"] = run_manager
+            context = copy_context()
+            context.run(var_child_runnable_config.set, child_config)
+            iterator = context.run(transformer, input_for_transform, **kwargs)  # type: ignore[arg-type]
+            if stream_log := next(
+                (
+                    h
+                    for h in run_manager.handlers
+                    if isinstance(h, LogStreamCallbackHandler)
+                ),
+                None,
+            ):
+                # populates streamed_output in astream_log() output if needed
+                iterator = stream_log.tap_output_aiter(run_manager.run_id, iterator)
+            try:
+                while True:
+                    if accepts_context(asyncio.create_task):
+                        chunk: Output = await asyncio.create_task(  # type: ignore[call-arg]
+                            py_anext(iterator),  # type: ignore[arg-type]
+                            context=context,
+                        )
+                    else:
+                        chunk = cast(Output, await py_anext(iterator))
+                    yield chunk
+                    if final_output_supported:
+                        if final_output is None:
+                            final_output = chunk
+                        else:
+                            try:
+                                final_output = final_output + chunk  # type: ignore
+                            except TypeError:
+                                final_output = chunk
+                                final_output_supported = False
+                    else:
+                        final_output = chunk
+            except StopAsyncIteration:
+                pass
+            async for ichunk in input_for_tracing:
+                if final_input_supported:
+                    if final_input is None:
+                        final_input = ichunk
+                    else:
+                        try:
+                            final_input = final_input + ichunk  # type: ignore[operator]
+                        except TypeError:
+                            final_input = ichunk
+                            final_input_supported = False
+                else:
+                    final_input = ichunk
+        except BaseException as e:
+            await run_manager.on_chain_error(e, inputs=final_input)
+            raise
+        else:
+            await run_manager.on_chain_end(final_output, inputs=final_input)
+
+
+class RunnableSerializable(Serializable, Runnable[Input, Output]):
+    """Runnable that can be serialized to JSON."""
+
+    name: Optional[str] = None
+    """The name of the runnable. Used for debugging and tracing."""
+
+    def to_json(self) -> Union[SerializedConstructor, SerializedNotImplemented]:
+        """Serialize the runnable to JSON."""
+        dumped = super().to_json()
+        try:
+            dumped["name"] = self.get_name()
+            dumped["graph"] = self.get_graph().to_json()
+        except Exception:
+            pass
+        return dumped
+
+    def configurable_fields(
+        self, **kwargs: AnyConfigurableField
+    ) -> RunnableSerializable[Input, Output]:
+        """Configure particular runnable fields at runtime.
+
+        .. code-block:: python
+
+            from langchain_core.runnables import ConfigurableField
+            from langchain_openai import ChatOpenAI
+
+            model = ChatOpenAI(max_tokens=20).configurable_fields(
+                max_tokens=ConfigurableField(
+                    id="output_token_number",
+                    name="Max tokens in the output",
+                    description="The maximum number of tokens in the output",
+                )
+            )
+
+            # max_tokens = 20
+            print(
+                "max_tokens_20: ",
+                model.invoke("tell me something about chess").content
+            )
+
+            # max_tokens = 200
+            print("max_tokens_200: ", model.with_config(
+                configurable={"output_token_number": 200}
+                ).invoke("tell me something about chess").content
+            )
+        """
+        from langchain_core.runnables.configurable import RunnableConfigurableFields
+
+        for key in kwargs:
+            if key not in self.__fields__:
+                raise ValueError(
+                    f"Configuration key {key} not found in {self}: "
+                    f"available keys are {self.__fields__.keys()}"
+                )
+
+        return RunnableConfigurableFields(default=self, fields=kwargs)
+
+    def configurable_alternatives(
+        self,
+        which: ConfigurableField,
+        *,
+        default_key: str = "default",
+        prefix_keys: bool = False,
+        **kwargs: Union[Runnable[Input, Output], Callable[[], Runnable[Input, Output]]],
+    ) -> RunnableSerializable[Input, Output]:
+        """Configure alternatives for runnables that can be set at runtime.
+
+        .. code-block:: python
+
+            from langchain_anthropic import ChatAnthropic
+            from langchain_core.runnables.utils import ConfigurableField
+            from langchain_openai import ChatOpenAI
+
+            model = ChatAnthropic(
+                model_name="claude-3-sonnet-20240229"
+            ).configurable_alternatives(
+                ConfigurableField(id="llm"),
+                default_key="anthropic",
+                openai=ChatOpenAI()
+            )
+
+            # uses the default model ChatAnthropic
+            print(model.invoke("which organization created you?").content)
+
+            # uses ChatOpenaAI
+            print(
+                model.with_config(
+                    configurable={"llm": "openai"}
+                ).invoke("which organization created you?").content
+            )
+        """
+        from langchain_core.runnables.configurable import (
+            RunnableConfigurableAlternatives,
+        )
+
+        return RunnableConfigurableAlternatives(
+            which=which,
+            default=self,
+            alternatives=kwargs,
+            default_key=default_key,
+            prefix_keys=prefix_keys,
+        )
+
+
+def _seq_input_schema(
+    steps: List[Runnable[Any, Any]], config: Optional[RunnableConfig]
+) -> Type[BaseModel]:
+    from langchain_core.runnables.passthrough import RunnableAssign, RunnablePick
+
+    first = steps[0]
+    if len(steps) == 1:
+        return first.get_input_schema(config)
+    elif isinstance(first, RunnableAssign):
+        next_input_schema = _seq_input_schema(steps[1:], config)
+        if not next_input_schema.__custom_root_type__:
+            # it's a dict as expected
+            return create_model(  # type: ignore[call-overload]
+                "RunnableSequenceInput",
+                **{
+                    k: (v.annotation, v.default)
+                    for k, v in next_input_schema.__fields__.items()
+                    if k not in first.mapper.steps__
+                },
+            )
+    elif isinstance(first, RunnablePick):
+        return _seq_input_schema(steps[1:], config)
+
+    return first.get_input_schema(config)
+
+
+def _seq_output_schema(
+    steps: List[Runnable[Any, Any]], config: Optional[RunnableConfig]
+) -> Type[BaseModel]:
+    from langchain_core.runnables.passthrough import RunnableAssign, RunnablePick
+
+    last = steps[-1]
+    if len(steps) == 1:
+        return last.get_input_schema(config)
+    elif isinstance(last, RunnableAssign):
+        mapper_output_schema = last.mapper.get_output_schema(config)
+        prev_output_schema = _seq_output_schema(steps[:-1], config)
+        if not prev_output_schema.__custom_root_type__:
+            # it's a dict as expected
+            return create_model(  # type: ignore[call-overload]
+                "RunnableSequenceOutput",
+                **{
+                    **{
+                        k: (v.annotation, v.default)
+                        for k, v in prev_output_schema.__fields__.items()
+                    },
+                    **{
+                        k: (v.annotation, v.default)
+                        for k, v in mapper_output_schema.__fields__.items()
+                    },
+                },
+            )
+    elif isinstance(last, RunnablePick):
+        prev_output_schema = _seq_output_schema(steps[:-1], config)
+        if not prev_output_schema.__custom_root_type__:
+            # it's a dict as expected
+            if isinstance(last.keys, list):
+                return create_model(  # type: ignore[call-overload]
+                    "RunnableSequenceOutput",
+                    **{
+                        k: (v.annotation, v.default)
+                        for k, v in prev_output_schema.__fields__.items()
+                        if k in last.keys
+                    },
+                )
+            else:
+                field = prev_output_schema.__fields__[last.keys]
+                return create_model(  # type: ignore[call-overload]
+                    "RunnableSequenceOutput",
+                    __root__=(field.annotation, field.default),
+                )
+
+    return last.get_output_schema(config)
+
+
+class RunnableSequence(RunnableSerializable[Input, Output]):
+    """Sequence of Runnables, where the output of each is the input of the next.
+
+    RunnableSequence is the most important composition operator in LangChain as it is
+    used in virtually every chain.
+
+    A RunnableSequence can be instantiated directly or more commonly by using the `|`
+    operator where either the left or right operands (or both) must be a Runnable.
+
+    Any RunnableSequence automatically supports sync, async, batch.
+
+    The default implementations of `batch` and `abatch` utilize threadpools and
+    asyncio gather and will be faster than naive invocation of invoke or ainvoke
+    for IO bound Runnables.
+
+    Batching is implemented by invoking the batch method on each component of the
+    RunnableSequence in order.
+
+    A RunnableSequence preserves the streaming properties of its components, so if all
+    components of the sequence implement a `transform` method -- which
+    is the method that implements the logic to map a streaming input to a streaming
+    output -- then the sequence will be able to stream input to output!
+
+    If any component of the sequence does not implement transform then the
+    streaming will only begin after this component is run. If there are
+    multiple blocking components, streaming begins after the last one.
+
+    Please note: RunnableLambdas do not support `transform` by default! So if
+        you need to use a RunnableLambdas be careful about where you place them in a
+        RunnableSequence (if you need to use the .stream()/.astream() methods).
+
+        If you need arbitrary logic and need streaming, you can subclass
+        Runnable, and implement `transform` for whatever logic you need.
+
+    Here is a simple example that uses simple functions to illustrate the use of
+    RunnableSequence:
+
+        .. code-block:: python
+
+            from langchain_core.runnables import RunnableLambda
+
+            def add_one(x: int) -> int:
+                return x + 1
+
+            def mul_two(x: int) -> int:
+                return x * 2
+
+            runnable_1 = RunnableLambda(add_one)
+            runnable_2 = RunnableLambda(mul_two)
+            sequence = runnable_1 | runnable_2
+            # Or equivalently:
+            # sequence = RunnableSequence(first=runnable_1, last=runnable_2)
+            sequence.invoke(1)
+            await sequence.ainvoke(1)
+
+            sequence.batch([1, 2, 3])
+            await sequence.abatch([1, 2, 3])
+
+    Here's an example that uses streams JSON output generated by an LLM:
+
+        .. code-block:: python
+
+            from langchain_core.output_parsers.json import SimpleJsonOutputParser
+            from langchain_openai import ChatOpenAI
+
+            prompt = PromptTemplate.from_template(
+                'In JSON format, give me a list of {topic} and their '
+                'corresponding names in French, Spanish and in a '
+                'Cat Language.'
+            )
+
+            model = ChatOpenAI()
+            chain = prompt | model | SimpleJsonOutputParser()
+
+            async for chunk in chain.astream({'topic': 'colors'}):
+                print('-')  # noqa: T201
+                print(chunk, sep='', flush=True)  # noqa: T201
+    """
+
+    # The steps are broken into first, middle and last, solely for type checking
+    # purposes. It allows specifying the `Input` on the first type, the `Output` of
+    # the last type.
+    first: Runnable[Input, Any]
+    """The first runnable in the sequence."""
+    middle: List[Runnable[Any, Any]] = Field(default_factory=list)
+    """The middle runnables in the sequence."""
+    last: Runnable[Any, Output]
+    """The last runnable in the sequence."""
+
+    def __init__(
+        self,
+        *steps: RunnableLike,
+        name: Optional[str] = None,
+        first: Optional[Runnable[Any, Any]] = None,
+        middle: Optional[List[Runnable[Any, Any]]] = None,
+        last: Optional[Runnable[Any, Any]] = None,
+    ) -> None:
+        """Create a new RunnableSequence.
+
+        Args:
+            steps: The steps to include in the sequence.
+        """
+        steps_flat: List[Runnable] = []
+        if not steps:
+            if first is not None and last is not None:
+                steps_flat = [first] + (middle or []) + [last]
+        for step in steps:
+            if isinstance(step, RunnableSequence):
+                steps_flat.extend(step.steps)
+            else:
+                steps_flat.append(coerce_to_runnable(step))
+        if len(steps_flat) < 2:
+            raise ValueError(
+                f"RunnableSequence must have at least 2 steps, got {len(steps_flat)}"
+            )
+        super().__init__(  # type: ignore[call-arg]
+            first=steps_flat[0],
+            middle=list(steps_flat[1:-1]),
+            last=steps_flat[-1],
+            name=name,
+        )
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    @property
+    def steps(self) -> List[Runnable[Any, Any]]:
+        """All the runnables that make up the sequence in order."""
+        return [self.first] + self.middle + [self.last]
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    @property
+    def InputType(self) -> Type[Input]:
+        return self.first.InputType
+
+    @property
+    def OutputType(self) -> Type[Output]:
+        return self.last.OutputType
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        return _seq_input_schema(self.steps, config)
+
+    def get_output_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        return _seq_output_schema(self.steps, config)
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        from langchain_core.beta.runnables.context import (
+            CONTEXT_CONFIG_PREFIX,
+            _key_from_id,
+        )
+
+        # get all specs
+        all_specs = [
+            (spec, idx)
+            for idx, step in enumerate(self.steps)
+            for spec in step.config_specs
+        ]
+        # calculate context dependencies
+        specs_by_pos = groupby(
+            [tup for tup in all_specs if tup[0].id.startswith(CONTEXT_CONFIG_PREFIX)],
+            lambda x: x[1],
+        )
+        next_deps: Set[str] = set()
+        deps_by_pos: Dict[int, Set[str]] = {}
+        for pos, specs in specs_by_pos:
+            deps_by_pos[pos] = next_deps
+            next_deps = next_deps | {spec[0].id for spec in specs}
+        # assign context dependencies
+        for pos, (spec, idx) in enumerate(all_specs):
+            if spec.id.startswith(CONTEXT_CONFIG_PREFIX):
+                all_specs[pos] = (
+                    ConfigurableFieldSpec(
+                        id=spec.id,
+                        annotation=spec.annotation,
+                        name=spec.name,
+                        default=spec.default,
+                        description=spec.description,
+                        is_shared=spec.is_shared,
+                        dependencies=[
+                            d
+                            for d in deps_by_pos[idx]
+                            if _key_from_id(d) != _key_from_id(spec.id)
+                        ]
+                        + (spec.dependencies or []),
+                    ),
+                    idx,
+                )
+
+        return get_unique_config_specs(spec for spec, _ in all_specs)
+
+    def get_graph(self, config: Optional[RunnableConfig] = None) -> Graph:
+        from langchain_core.runnables.graph import Graph
+
+        graph = Graph()
+        for step in self.steps:
+            current_last_node = graph.last_node()
+            step_graph = step.get_graph(config)
+            if step is not self.first:
+                step_graph.trim_first_node()
+            if step is not self.last:
+                step_graph.trim_last_node()
+            graph.extend(step_graph)
+            step_first_node = step_graph.first_node()
+            if not step_first_node:
+                raise ValueError(f"Runnable {step} has no first node")
+            if current_last_node:
+                graph.add_edge(current_last_node, step_first_node)
+
+        return graph
+
+    def __repr__(self) -> str:
+        return "\n| ".join(
+            repr(s) if i == 0 else indent_lines_after_first(repr(s), "| ")
+            for i, s in enumerate(self.steps)
+        )
+
+    def __or__(
+        self,
+        other: Union[
+            Runnable[Any, Other],
+            Callable[[Any], Other],
+            Callable[[Iterator[Any]], Iterator[Other]],
+            Mapping[str, Union[Runnable[Any, Other], Callable[[Any], Other], Any]],
+        ],
+    ) -> RunnableSerializable[Input, Other]:
+        if isinstance(other, RunnableSequence):
+            return RunnableSequence(
+                self.first,
+                *self.middle,
+                self.last,
+                other.first,
+                *other.middle,
+                other.last,
+                name=self.name or other.name,
+            )
+        else:
+            return RunnableSequence(
+                self.first,
+                *self.middle,
+                self.last,
+                coerce_to_runnable(other),
+                name=self.name,
+            )
+
+    def __ror__(
+        self,
+        other: Union[
+            Runnable[Other, Any],
+            Callable[[Other], Any],
+            Callable[[Iterator[Other]], Iterator[Any]],
+            Mapping[str, Union[Runnable[Other, Any], Callable[[Other], Any], Any]],
+        ],
+    ) -> RunnableSerializable[Other, Output]:
+        if isinstance(other, RunnableSequence):
+            return RunnableSequence(
+                other.first,
+                *other.middle,
+                other.last,
+                self.first,
+                *self.middle,
+                self.last,
+                name=other.name or self.name,
+            )
+        else:
+            return RunnableSequence(
+                coerce_to_runnable(other),
+                self.first,
+                *self.middle,
+                self.last,
+                name=self.name,
+            )
+
+    def invoke(self, input: Input, config: Optional[RunnableConfig] = None) -> Output:
+        from langchain_core.beta.runnables.context import config_with_context
+
+        # setup callbacks and context
+        config = config_with_context(ensure_config(config), self.steps)
+        callback_manager = get_callback_manager_for_config(config)
+        # start the root run
+        run_manager = callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name") or self.get_name(),
+            run_id=config.pop("run_id", None),
+        )
+
+        # invoke all steps in sequence
+        try:
+            for i, step in enumerate(self.steps):
+                input = step.invoke(
+                    input,
+                    # mark each step as a child run
+                    patch_config(
+                        config, callbacks=run_manager.get_child(f"seq:step:{i+1}")
+                    ),
+                )
+        # finish the root run
+        except BaseException as e:
+            run_manager.on_chain_error(e)
+            raise
+        else:
+            run_manager.on_chain_end(input)
+            return cast(Output, input)
+
+    async def ainvoke(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Output:
+        from langchain_core.beta.runnables.context import aconfig_with_context
+
+        # setup callbacks and context
+        config = aconfig_with_context(ensure_config(config), self.steps)
+        callback_manager = get_async_callback_manager_for_config(config)
+        # start the root run
+        run_manager = await callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name") or self.get_name(),
+            run_id=config.pop("run_id", None),
+        )
+
+        # invoke all steps in sequence
+        try:
+            for i, step in enumerate(self.steps):
+                input = await step.ainvoke(
+                    input,
+                    # mark each step as a child run
+                    patch_config(
+                        config, callbacks=run_manager.get_child(f"seq:step:{i+1}")
+                    ),
+                )
+        # finish the root run
+        except BaseException as e:
+            await run_manager.on_chain_error(e)
+            raise
+        else:
+            await run_manager.on_chain_end(input)
+            return cast(Output, input)
+
+    def batch(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        from langchain_core.beta.runnables.context import config_with_context
+        from langchain_core.callbacks.manager import CallbackManager
+
+        if not inputs:
+            return []
+
+        # setup callbacks and context
+        configs = [
+            config_with_context(c, self.steps)
+            for c in get_config_list(config, len(inputs))
+        ]
+        callback_managers = [
+            CallbackManager.configure(
+                inheritable_callbacks=config.get("callbacks"),
+                local_callbacks=None,
+                verbose=False,
+                inheritable_tags=config.get("tags"),
+                local_tags=None,
+                inheritable_metadata=config.get("metadata"),
+                local_metadata=None,
+            )
+            for config in configs
+        ]
+        # start the root runs, one per input
+        run_managers = [
+            cm.on_chain_start(
+                dumpd(self),
+                input,
+                name=config.get("run_name") or self.get_name(),
+                run_id=config.pop("run_id", None),
+            )
+            for cm, input, config in zip(callback_managers, inputs, configs)
+        ]
+
+        # invoke
+        try:
+            if return_exceptions:
+                # Track which inputs (by index) failed so far
+                # If an input has failed it will be present in this map,
+                # and the value will be the exception that was raised.
+                failed_inputs_map: Dict[int, Exception] = {}
+                for stepidx, step in enumerate(self.steps):
+                    # Assemble the original indexes of the remaining inputs
+                    # (i.e. the ones that haven't failed yet)
+                    remaining_idxs = [
+                        i for i in range(len(configs)) if i not in failed_inputs_map
+                    ]
+                    # Invoke the step on the remaining inputs
+                    inputs = step.batch(
+                        [
+                            inp
+                            for i, inp in zip(remaining_idxs, inputs)
+                            if i not in failed_inputs_map
+                        ],
+                        [
+                            # each step a child run of the corresponding root run
+                            patch_config(
+                                config, callbacks=rm.get_child(f"seq:step:{stepidx+1}")
+                            )
+                            for i, (rm, config) in enumerate(zip(run_managers, configs))
+                            if i not in failed_inputs_map
+                        ],
+                        return_exceptions=return_exceptions,
+                        **kwargs,
+                    )
+                    # If an input failed, add it to the map
+                    for i, inp in zip(remaining_idxs, inputs):
+                        if isinstance(inp, Exception):
+                            failed_inputs_map[i] = inp
+                    inputs = [inp for inp in inputs if not isinstance(inp, Exception)]
+                    # If all inputs have failed, stop processing
+                    if len(failed_inputs_map) == len(configs):
+                        break
+
+                # Reassemble the outputs, inserting Exceptions for failed inputs
+                inputs_copy = inputs.copy()
+                inputs = []
+                for i in range(len(configs)):
+                    if i in failed_inputs_map:
+                        inputs.append(cast(Input, failed_inputs_map[i]))
+                    else:
+                        inputs.append(inputs_copy.pop(0))
+            else:
+                for i, step in enumerate(self.steps):
+                    inputs = step.batch(
+                        inputs,
+                        [
+                            # each step a child run of the corresponding root run
+                            patch_config(
+                                config, callbacks=rm.get_child(f"seq:step:{i+1}")
+                            )
+                            for rm, config in zip(run_managers, configs)
+                        ],
+                    )
+
+        # finish the root runs
+        except BaseException as e:
+            for rm in run_managers:
+                rm.on_chain_error(e)
+            if return_exceptions:
+                return cast(List[Output], [e for _ in inputs])
+            else:
+                raise
+        else:
+            first_exception: Optional[Exception] = None
+            for run_manager, out in zip(run_managers, inputs):
+                if isinstance(out, Exception):
+                    first_exception = first_exception or out
+                    run_manager.on_chain_error(out)
+                else:
+                    run_manager.on_chain_end(out)
+            if return_exceptions or first_exception is None:
+                return cast(List[Output], inputs)
+            else:
+                raise first_exception
+
+    async def abatch(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        from langchain_core.beta.runnables.context import aconfig_with_context
+        from langchain_core.callbacks.manager import AsyncCallbackManager
+
+        if not inputs:
+            return []
+
+        # setup callbacks and context
+        configs = [
+            aconfig_with_context(c, self.steps)
+            for c in get_config_list(config, len(inputs))
+        ]
+        callback_managers = [
+            AsyncCallbackManager.configure(
+                inheritable_callbacks=config.get("callbacks"),
+                local_callbacks=None,
+                verbose=False,
+                inheritable_tags=config.get("tags"),
+                local_tags=None,
+                inheritable_metadata=config.get("metadata"),
+                local_metadata=None,
+            )
+            for config in configs
+        ]
+        # start the root runs, one per input
+        run_managers: List[AsyncCallbackManagerForChainRun] = await asyncio.gather(
+            *(
+                cm.on_chain_start(
+                    dumpd(self),
+                    input,
+                    name=config.get("run_name") or self.get_name(),
+                    run_id=config.pop("run_id", None),
+                )
+                for cm, input, config in zip(callback_managers, inputs, configs)
+            )
+        )
+
+        # invoke .batch() on each step
+        # this uses batching optimizations in Runnable subclasses, like LLM
+        try:
+            if return_exceptions:
+                # Track which inputs (by index) failed so far
+                # If an input has failed it will be present in this map,
+                # and the value will be the exception that was raised.
+                failed_inputs_map: Dict[int, Exception] = {}
+                for stepidx, step in enumerate(self.steps):
+                    # Assemble the original indexes of the remaining inputs
+                    # (i.e. the ones that haven't failed yet)
+                    remaining_idxs = [
+                        i for i in range(len(configs)) if i not in failed_inputs_map
+                    ]
+                    # Invoke the step on the remaining inputs
+                    inputs = await step.abatch(
+                        [
+                            inp
+                            for i, inp in zip(remaining_idxs, inputs)
+                            if i not in failed_inputs_map
+                        ],
+                        [
+                            # each step a child run of the corresponding root run
+                            patch_config(
+                                config, callbacks=rm.get_child(f"seq:step:{stepidx+1}")
+                            )
+                            for i, (rm, config) in enumerate(zip(run_managers, configs))
+                            if i not in failed_inputs_map
+                        ],
+                        return_exceptions=return_exceptions,
+                        **kwargs,
+                    )
+                    # If an input failed, add it to the map
+                    for i, inp in zip(remaining_idxs, inputs):
+                        if isinstance(inp, Exception):
+                            failed_inputs_map[i] = inp
+                    inputs = [inp for inp in inputs if not isinstance(inp, Exception)]
+                    # If all inputs have failed, stop processing
+                    if len(failed_inputs_map) == len(configs):
+                        break
+
+                # Reassemble the outputs, inserting Exceptions for failed inputs
+                inputs_copy = inputs.copy()
+                inputs = []
+                for i in range(len(configs)):
+                    if i in failed_inputs_map:
+                        inputs.append(cast(Input, failed_inputs_map[i]))
+                    else:
+                        inputs.append(inputs_copy.pop(0))
+            else:
+                for i, step in enumerate(self.steps):
+                    inputs = await step.abatch(
+                        inputs,
+                        [
+                            # each step a child run of the corresponding root run
+                            patch_config(
+                                config, callbacks=rm.get_child(f"seq:step:{i+1}")
+                            )
+                            for rm, config in zip(run_managers, configs)
+                        ],
+                    )
+        # finish the root runs
+        except BaseException as e:
+            await asyncio.gather(*(rm.on_chain_error(e) for rm in run_managers))
+            if return_exceptions:
+                return cast(List[Output], [e for _ in inputs])
+            else:
+                raise
+        else:
+            first_exception: Optional[Exception] = None
+            coros: List[Awaitable[None]] = []
+            for run_manager, out in zip(run_managers, inputs):
+                if isinstance(out, Exception):
+                    first_exception = first_exception or out
+                    coros.append(run_manager.on_chain_error(out))
+                else:
+                    coros.append(run_manager.on_chain_end(out))
+            await asyncio.gather(*coros)
+            if return_exceptions or first_exception is None:
+                return cast(List[Output], inputs)
+            else:
+                raise first_exception
+
+    def _transform(
+        self,
+        input: Iterator[Input],
+        run_manager: CallbackManagerForChainRun,
+        config: RunnableConfig,
+    ) -> Iterator[Output]:
+        from langchain_core.beta.runnables.context import config_with_context
+
+        steps = [self.first] + self.middle + [self.last]
+        config = config_with_context(config, self.steps)
+
+        # transform the input stream of each step with the next
+        # steps that don't natively support transforming an input stream will
+        # buffer input in memory until all available, and then start emitting output
+        final_pipeline = cast(Iterator[Output], input)
+        for step in steps:
+            final_pipeline = step.transform(
+                final_pipeline,
+                patch_config(
+                    config,
+                    callbacks=run_manager.get_child(f"seq:step:{steps.index(step)+1}"),
+                ),
+            )
+
+        for output in final_pipeline:
+            yield output
+
+    async def _atransform(
+        self,
+        input: AsyncIterator[Input],
+        run_manager: AsyncCallbackManagerForChainRun,
+        config: RunnableConfig,
+    ) -> AsyncIterator[Output]:
+        from langchain_core.beta.runnables.context import aconfig_with_context
+
+        steps = [self.first] + self.middle + [self.last]
+        config = aconfig_with_context(config, self.steps)
+
+        # stream the last steps
+        # transform the input stream of each step with the next
+        # steps that don't natively support transforming an input stream will
+        # buffer input in memory until all available, and then start emitting output
+        final_pipeline = cast(AsyncIterator[Output], input)
+        for step in steps:
+            final_pipeline = step.atransform(
+                final_pipeline,
+                patch_config(
+                    config,
+                    callbacks=run_manager.get_child(f"seq:step:{steps.index(step)+1}"),
+                ),
+            )
+        async for output in final_pipeline:
+            yield output
+
+    def transform(
+        self,
+        input: Iterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Output]:
+        yield from self._transform_stream_with_config(
+            input,
+            self._transform,
+            patch_config(config, run_name=(config or {}).get("run_name") or self.name),
+            **kwargs,
+        )
+
+    def stream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Output]:
+        yield from self.transform(iter([input]), config, **kwargs)
+
+    async def atransform(
+        self,
+        input: AsyncIterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Output]:
+        async for chunk in self._atransform_stream_with_config(
+            input,
+            self._atransform,
+            patch_config(config, run_name=(config or {}).get("run_name") or self.name),
+            **kwargs,
+        ):
+            yield chunk
+
+    async def astream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Output]:
+        async def input_aiter() -> AsyncIterator[Input]:
+            yield input
+
+        async for chunk in self.atransform(input_aiter(), config, **kwargs):
+            yield chunk
+
+
+class RunnableParallel(RunnableSerializable[Input, Dict[str, Any]]):
+    """Runnable that runs a mapping of Runnables in parallel, and returns a mapping
+    of their outputs.
+
+    RunnableParallel is one of the two main composition primitives for the LCEL,
+    alongside RunnableSequence. It invokes Runnables concurrently, providing the same
+    input to each.
+
+    A RunnableParallel can be instantiated directly or by using a dict literal within a
+    sequence.
+
+    Here is a simple example that uses functions to illustrate the use of
+    RunnableParallel:
+
+        .. code-block:: python
+
+            from langchain_core.runnables import RunnableLambda
+
+            def add_one(x: int) -> int:
+                return x + 1
+
+            def mul_two(x: int) -> int:
+                return x * 2
+
+            def mul_three(x: int) -> int:
+                return x * 3
+
+            runnable_1 = RunnableLambda(add_one)
+            runnable_2 = RunnableLambda(mul_two)
+            runnable_3 = RunnableLambda(mul_three)
+
+            sequence = runnable_1 | {  # this dict is coerced to a RunnableParallel
+                "mul_two": runnable_2,
+                "mul_three": runnable_3,
+            }
+            # Or equivalently:
+            # sequence = runnable_1 | RunnableParallel(
+            #     {"mul_two": runnable_2, "mul_three": runnable_3}
+            # )
+            # Also equivalently:
+            # sequence = runnable_1 | RunnableParallel(
+            #     mul_two=runnable_2,
+            #     mul_three=runnable_3,
+            # )
+
+            sequence.invoke(1)
+            await sequence.ainvoke(1)
+
+            sequence.batch([1, 2, 3])
+            await sequence.abatch([1, 2, 3])
+
+    RunnableParallel makes it easy to run Runnables in parallel. In the below example,
+    we simultaneously stream output from two different Runnables:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import ChatPromptTemplate
+            from langchain_core.runnables import RunnableParallel
+            from langchain_openai import ChatOpenAI
+
+            model = ChatOpenAI()
+            joke_chain = (
+                ChatPromptTemplate.from_template("tell me a joke about {topic}")
+                | model
+            )
+            poem_chain = (
+                ChatPromptTemplate.from_template("write a 2-line poem about {topic}")
+                | model
+            )
+
+            runnable = RunnableParallel(joke=joke_chain, poem=poem_chain)
+
+            # Display stream
+            output = {key: "" for key, _ in runnable.output_schema()}
+            for chunk in runnable.stream({"topic": "bear"}):
+                for key in chunk:
+                    output[key] = output[key] + chunk[key].content
+                print(output)  # noqa: T201
+    """
+
+    steps__: Mapping[str, Runnable[Input, Any]]
+
+    def __init__(
+        self,
+        steps__: Optional[
+            Mapping[
+                str,
+                Union[
+                    Runnable[Input, Any],
+                    Callable[[Input], Any],
+                    Mapping[str, Union[Runnable[Input, Any], Callable[[Input], Any]]],
+                ],
+            ]
+        ] = None,
+        **kwargs: Union[
+            Runnable[Input, Any],
+            Callable[[Input], Any],
+            Mapping[str, Union[Runnable[Input, Any], Callable[[Input], Any]]],
+        ],
+    ) -> None:
+        merged = {**steps__} if steps__ is not None else {}
+        merged.update(kwargs)
+        super().__init__(  # type: ignore[call-arg]
+            steps__={key: coerce_to_runnable(r) for key, r in merged.items()}
+        )
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    def get_name(
+        self, suffix: Optional[str] = None, *, name: Optional[str] = None
+    ) -> str:
+        name = name or self.name or f"RunnableParallel<{','.join(self.steps__.keys())}>"
+        return super().get_name(suffix, name=name)
+
+    @property
+    def InputType(self) -> Any:
+        for step in self.steps__.values():
+            if step.InputType:
+                return step.InputType
+
+        return Any
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        if all(
+            s.get_input_schema(config).schema().get("type", "object") == "object"
+            for s in self.steps__.values()
+        ):
+            # This is correct, but pydantic typings/mypy don't think so.
+            return create_model(  # type: ignore[call-overload]
+                self.get_name("Input"),
+                **{
+                    k: (v.annotation, v.default)
+                    for step in self.steps__.values()
+                    for k, v in step.get_input_schema(config).__fields__.items()
+                    if k != "__root__"
+                },
+            )
+
+        return super().get_input_schema(config)
+
+    def get_output_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        # This is correct, but pydantic typings/mypy don't think so.
+        return create_model(  # type: ignore[call-overload]
+            self.get_name("Output"),
+            **{k: (v.OutputType, None) for k, v in self.steps__.items()},
+        )
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        return get_unique_config_specs(
+            spec for step in self.steps__.values() for spec in step.config_specs
+        )
+
+    def get_graph(self, config: Optional[RunnableConfig] = None) -> Graph:
+        from langchain_core.runnables.graph import Graph
+
+        graph = Graph()
+        input_node = graph.add_node(self.get_input_schema(config))
+        output_node = graph.add_node(self.get_output_schema(config))
+        for step in self.steps__.values():
+            step_graph = step.get_graph()
+            step_graph.trim_first_node()
+            step_graph.trim_last_node()
+            if not step_graph:
+                graph.add_edge(input_node, output_node)
+            else:
+                graph.extend(step_graph)
+                step_first_node = step_graph.first_node()
+                if not step_first_node:
+                    raise ValueError(f"Runnable {step} has no first node")
+                step_last_node = step_graph.last_node()
+                if not step_last_node:
+                    raise ValueError(f"Runnable {step} has no last node")
+                graph.add_edge(input_node, step_first_node)
+                graph.add_edge(step_last_node, output_node)
+
+        return graph
+
+    def __repr__(self) -> str:
+        map_for_repr = ",\n  ".join(
+            f"{k}: {indent_lines_after_first(repr(v), '  ' + k + ': ')}"
+            for k, v in self.steps__.items()
+        )
+        return "{\n  " + map_for_repr + "\n}"
+
+    def invoke(
+        self, input: Input, config: Optional[RunnableConfig] = None
+    ) -> Dict[str, Any]:
+        from langchain_core.callbacks.manager import CallbackManager
+
+        # setup callbacks
+        config = ensure_config(config)
+        callback_manager = CallbackManager.configure(
+            inheritable_callbacks=config.get("callbacks"),
+            local_callbacks=None,
+            verbose=False,
+            inheritable_tags=config.get("tags"),
+            local_tags=None,
+            inheritable_metadata=config.get("metadata"),
+            local_metadata=None,
+        )
+        # start the root run
+        run_manager = callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name") or self.get_name(),
+            run_id=config.pop("run_id", None),
+        )
+
+        # gather results from all steps
+        try:
+            # copy to avoid issues from the caller mutating the steps during invoke()
+            steps = dict(self.steps__)
+            with get_executor_for_config(config) as executor:
+                futures = [
+                    executor.submit(
+                        step.invoke,
+                        input,
+                        # mark each step as a child run
+                        patch_config(
+                            config,
+                            callbacks=run_manager.get_child(f"map:key:{key}"),
+                        ),
+                    )
+                    for key, step in steps.items()
+                ]
+                output = {key: future.result() for key, future in zip(steps, futures)}
+        # finish the root run
+        except BaseException as e:
+            run_manager.on_chain_error(e)
+            raise
+        else:
+            run_manager.on_chain_end(output)
+            return output
+
+    async def ainvoke(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Dict[str, Any]:
+        # setup callbacks
+        config = ensure_config(config)
+        callback_manager = get_async_callback_manager_for_config(config)
+        # start the root run
+        run_manager = await callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name") or self.get_name(),
+            run_id=config.pop("run_id", None),
+        )
+
+        # gather results from all steps
+        try:
+            # copy to avoid issues from the caller mutating the steps during invoke()
+            steps = dict(self.steps__)
+            results = await asyncio.gather(
+                *(
+                    step.ainvoke(
+                        input,
+                        # mark each step as a child run
+                        patch_config(
+                            config, callbacks=run_manager.get_child(f"map:key:{key}")
+                        ),
+                    )
+                    for key, step in steps.items()
+                )
+            )
+            output = {key: value for key, value in zip(steps, results)}
+        # finish the root run
+        except BaseException as e:
+            await run_manager.on_chain_error(e)
+            raise
+        else:
+            await run_manager.on_chain_end(output)
+            return output
+
+    def _transform(
+        self,
+        input: Iterator[Input],
+        run_manager: CallbackManagerForChainRun,
+        config: RunnableConfig,
+    ) -> Iterator[AddableDict]:
+        # Shallow copy steps to ignore mutations while in progress
+        steps = dict(self.steps__)
+        # Each step gets a copy of the input iterator,
+        # which is consumed in parallel in a separate thread.
+        input_copies = list(safetee(input, len(steps), lock=threading.Lock()))
+        with get_executor_for_config(config) as executor:
+            # Create the transform() generator for each step
+            named_generators = [
+                (
+                    name,
+                    step.transform(
+                        input_copies.pop(),
+                        patch_config(
+                            config, callbacks=run_manager.get_child(f"map:key:{name}")
+                        ),
+                    ),
+                )
+                for name, step in steps.items()
+            ]
+            # Start the first iteration of each generator
+            futures = {
+                executor.submit(next, generator): (step_name, generator)
+                for step_name, generator in named_generators
+            }
+            # Yield chunks from each as they become available,
+            # and start the next iteration of that generator that yielded it.
+            # When all generators are exhausted, stop.
+            while futures:
+                completed_futures, _ = wait(futures, return_when=FIRST_COMPLETED)
+                for future in completed_futures:
+                    (step_name, generator) = futures.pop(future)
+                    try:
+                        chunk = AddableDict({step_name: future.result()})
+                        yield chunk
+                        futures[executor.submit(next, generator)] = (
+                            step_name,
+                            generator,
+                        )
+                    except StopIteration:
+                        pass
+
+    def transform(
+        self,
+        input: Iterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Iterator[Dict[str, Any]]:
+        yield from self._transform_stream_with_config(
+            input, self._transform, config, **kwargs
+        )
+
+    def stream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Dict[str, Any]]:
+        yield from self.transform(iter([input]), config)
+
+    async def _atransform(
+        self,
+        input: AsyncIterator[Input],
+        run_manager: AsyncCallbackManagerForChainRun,
+        config: RunnableConfig,
+    ) -> AsyncIterator[AddableDict]:
+        # Shallow copy steps to ignore mutations while in progress
+        steps = dict(self.steps__)
+        # Each step gets a copy of the input iterator,
+        # which is consumed in parallel in a separate thread.
+        input_copies = list(atee(input, len(steps), lock=asyncio.Lock()))
+        # Create the transform() generator for each step
+        named_generators = [
+            (
+                name,
+                step.atransform(
+                    input_copies.pop(),
+                    patch_config(
+                        config, callbacks=run_manager.get_child(f"map:key:{name}")
+                    ),
+                ),
+            )
+            for name, step in steps.items()
+        ]
+
+        # Wrap in a coroutine to satisfy linter
+        async def get_next_chunk(generator: AsyncIterator) -> Optional[Output]:
+            return await py_anext(generator)
+
+        # Start the first iteration of each generator
+        tasks = {
+            asyncio.create_task(get_next_chunk(generator)): (step_name, generator)
+            for step_name, generator in named_generators
+        }
+        # Yield chunks from each as they become available,
+        # and start the next iteration of the generator that yielded it.
+        # When all generators are exhausted, stop.
+        while tasks:
+            completed_tasks, _ = await asyncio.wait(
+                tasks, return_when=asyncio.FIRST_COMPLETED
+            )
+            for task in completed_tasks:
+                (step_name, generator) = tasks.pop(task)
+                try:
+                    chunk = AddableDict({step_name: task.result()})
+                    yield chunk
+                    new_task = asyncio.create_task(get_next_chunk(generator))
+                    tasks[new_task] = (step_name, generator)
+                except StopAsyncIteration:
+                    pass
+
+    async def atransform(
+        self,
+        input: AsyncIterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[Dict[str, Any]]:
+        async for chunk in self._atransform_stream_with_config(
+            input, self._atransform, config, **kwargs
+        ):
+            yield chunk
+
+    async def astream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Dict[str, Any]]:
+        async def input_aiter() -> AsyncIterator[Input]:
+            yield input
+
+        async for chunk in self.atransform(input_aiter(), config):
+            yield chunk
+
+
+# We support both names
+RunnableMap = RunnableParallel
+
+
+class RunnableGenerator(Runnable[Input, Output]):
+    """Runnable that runs a generator function.
+
+    RunnableGenerators can be instantiated directly or by using a generator within
+    a sequence.
+
+    RunnableGenerators can be used to implement custom behavior, such as custom output
+    parsers, while preserving streaming capabilities. Given a generator function with
+    a signature Iterator[A] -> Iterator[B], wrapping it in a RunnableGenerator allows
+    it to emit output chunks as soon as they are streamed in from the previous step.
+
+    Note that if a generator function has a signature A -> Iterator[B], such that it
+    requires its input from the previous step to be completed before emitting chunks
+    (e.g., most LLMs need the entire prompt available to start generating), it can
+    instead be wrapped in a RunnableLambda.
+
+    Here is an example to show the basic mechanics of a RunnableGenerator:
+
+        .. code-block:: python
+
+            from typing import Any, AsyncIterator, Iterator
+
+            from langchain_core.runnables import RunnableGenerator
+
+
+            def gen(input: Iterator[Any]) -> Iterator[str]:
+                for token in ["Have", " a", " nice", " day"]:
+                    yield token
+
+
+            runnable = RunnableGenerator(gen)
+            runnable.invoke(None)  # "Have a nice day"
+            list(runnable.stream(None))  # ["Have", " a", " nice", " day"]
+            runnable.batch([None, None])  # ["Have a nice day", "Have a nice day"]
+
+
+            # Async version:
+            async def agen(input: AsyncIterator[Any]) -> AsyncIterator[str]:
+                for token in ["Have", " a", " nice", " day"]:
+                    yield token
+
+            runnable = RunnableGenerator(agen)
+            await runnable.ainvoke(None)  # "Have a nice day"
+            [p async for p in runnable.astream(None)] # ["Have", " a", " nice", " day"]
+
+    RunnableGenerator makes it easy to implement custom behavior within a streaming
+    context. Below we show an example:
+        .. code-block:: python
+
+            from langchain_core.prompts import ChatPromptTemplate
+            from langchain_core.runnables import RunnableGenerator, RunnableLambda
+            from langchain_openai import ChatOpenAI
+            from langchain_core.output_parsers import StrOutputParser
+
+
+            model = ChatOpenAI()
+            chant_chain = (
+                ChatPromptTemplate.from_template("Give me a 3 word chant about {topic}")
+                | model
+                | StrOutputParser()
+            )
+
+            def character_generator(input: Iterator[str]) -> Iterator[str]:
+                for token in input:
+                    if "," in token or "." in token:
+                        yield "👏" + token
+                    else:
+                        yield token
+
+
+            runnable = chant_chain | character_generator
+            assert type(runnable.last) is RunnableGenerator
+            "".join(runnable.stream({"topic": "waste"})) # Reduce👏, Reuse👏, Recycle👏.
+
+            # Note that RunnableLambda can be used to delay streaming of one step in a
+            # sequence until the previous step is finished:
+            def reverse_generator(input: str) -> Iterator[str]:
+                # Yield characters of input in reverse order.
+                for character in input[::-1]:
+                    yield character
+
+            runnable = chant_chain | RunnableLambda(reverse_generator)
+            "".join(runnable.stream({"topic": "waste"}))  # ".elcycer ,esuer ,ecudeR"
+    """
+
+    def __init__(
+        self,
+        transform: Union[
+            Callable[[Iterator[Input]], Iterator[Output]],
+            Callable[[AsyncIterator[Input]], AsyncIterator[Output]],
+        ],
+        atransform: Optional[
+            Callable[[AsyncIterator[Input]], AsyncIterator[Output]]
+        ] = None,
+    ) -> None:
+        if atransform is not None:
+            self._atransform = atransform
+            func_for_name: Callable = atransform
+
+        if inspect.isasyncgenfunction(transform):
+            self._atransform = transform  # type: ignore[assignment]
+            func_for_name = transform
+        elif inspect.isgeneratorfunction(transform):
+            self._transform = transform
+            func_for_name = transform
+        else:
+            raise TypeError(
+                "Expected a generator function type for `transform`."
+                f"Instead got an unsupported type: {type(transform)}"
+            )
+
+        try:
+            self.name = func_for_name.__name__
+        except AttributeError:
+            pass
+
+    @property
+    def InputType(self) -> Any:
+        func = getattr(self, "_transform", None) or getattr(self, "_atransform")
+        try:
+            params = inspect.signature(func).parameters
+            first_param = next(iter(params.values()), None)
+            if first_param and first_param.annotation != inspect.Parameter.empty:
+                return getattr(first_param.annotation, "__args__", (Any,))[0]
+            else:
+                return Any
+        except ValueError:
+            return Any
+
+    @property
+    def OutputType(self) -> Any:
+        func = getattr(self, "_transform", None) or getattr(self, "_atransform")
+        try:
+            sig = inspect.signature(func)
+            return (
+                getattr(sig.return_annotation, "__args__", (Any,))[0]
+                if sig.return_annotation != inspect.Signature.empty
+                else Any
+            )
+        except ValueError:
+            return Any
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, RunnableGenerator):
+            if hasattr(self, "_transform") and hasattr(other, "_transform"):
+                return self._transform == other._transform
+            elif hasattr(self, "_atransform") and hasattr(other, "_atransform"):
+                return self._atransform == other._atransform
+            else:
+                return False
+        else:
+            return False
+
+    def __repr__(self) -> str:
+        return f"RunnableGenerator({self.name})"
+
+    def transform(
+        self,
+        input: Iterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Iterator[Output]:
+        if not hasattr(self, "_transform"):
+            raise NotImplementedError(f"{repr(self)} only supports async methods.")
+        return self._transform_stream_with_config(
+            input,
+            self._transform,  # type: ignore[arg-type]
+            config,
+            **kwargs,  # type: ignore[arg-type]
+        )
+
+    def stream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Iterator[Output]:
+        return self.transform(iter([input]), config, **kwargs)
+
+    def invoke(
+        self, input: Input, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> Output:
+        final = None
+        for output in self.stream(input, config, **kwargs):
+            if final is None:
+                final = output
+            else:
+                final = final + output
+        return cast(Output, final)
+
+    def atransform(
+        self,
+        input: AsyncIterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[Output]:
+        if not hasattr(self, "_atransform"):
+            raise NotImplementedError(f"{repr(self)} only supports sync methods.")
+
+        return self._atransform_stream_with_config(
+            input, self._atransform, config, **kwargs
+        )
+
+    def astream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[Output]:
+        async def input_aiter() -> AsyncIterator[Input]:
+            yield input
+
+        return self.atransform(input_aiter(), config, **kwargs)
+
+    async def ainvoke(
+        self, input: Input, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> Output:
+        final = None
+        async for output in self.astream(input, config, **kwargs):
+            if final is None:
+                final = output
+            else:
+                final = final + output
+        return cast(Output, final)
+
+
+class RunnableLambda(Runnable[Input, Output]):
+    """RunnableLambda converts a python callable into a Runnable.
+
+    Wrapping a callable in a RunnableLambda makes the callable usable
+    within either a sync or async context.
+
+    RunnableLambda can be composed as any other Runnable and provides
+    seamless integration with LangChain tracing.
+
+    Examples:
+
+        .. code-block:: python
+
+            # This is a RunnableLambda
+            from langchain_core.runnables import RunnableLambda
+
+            def add_one(x: int) -> int:
+                return x + 1
+
+            runnable = RunnableLambda(add_one)
+
+            runnable.invoke(1) # returns 2
+            runnable.batch([1, 2, 3]) # returns [2, 3, 4]
+
+            # Async is supported by default by delegating to the sync implementation
+            await runnable.ainvoke(1) # returns 2
+            await runnable.abatch([1, 2, 3]) # returns [2, 3, 4]
+
+
+            # Alternatively, can provide both synd and sync implementations
+            async def add_one_async(x: int) -> int:
+                return x + 1
+
+            runnable = RunnableLambda(add_one, afunc=add_one_async)
+            runnable.invoke(1) # Uses add_one
+            await runnable.ainvoke(1) # Uses add_one_async
+    """
+
+    def __init__(
+        self,
+        func: Union[
+            Union[
+                Callable[[Input], Output],
+                Callable[[Input], Iterator[Output]],
+                Callable[[Input, RunnableConfig], Output],
+                Callable[[Input, CallbackManagerForChainRun], Output],
+                Callable[[Input, CallbackManagerForChainRun, RunnableConfig], Output],
+            ],
+            Union[
+                Callable[[Input], Awaitable[Output]],
+                Callable[[Input], AsyncIterator[Output]],
+                Callable[[Input, RunnableConfig], Awaitable[Output]],
+                Callable[[Input, AsyncCallbackManagerForChainRun], Awaitable[Output]],
+                Callable[
+                    [Input, AsyncCallbackManagerForChainRun, RunnableConfig],
+                    Awaitable[Output],
+                ],
+            ],
+        ],
+        afunc: Optional[
+            Union[
+                Callable[[Input], Awaitable[Output]],
+                Callable[[Input], AsyncIterator[Output]],
+                Callable[[Input, RunnableConfig], Awaitable[Output]],
+                Callable[[Input, AsyncCallbackManagerForChainRun], Awaitable[Output]],
+                Callable[
+                    [Input, AsyncCallbackManagerForChainRun, RunnableConfig],
+                    Awaitable[Output],
+                ],
+            ]
+        ] = None,
+        name: Optional[str] = None,
+    ) -> None:
+        """Create a RunnableLambda from a callable, and async callable or both.
+
+        Accepts both sync and async variants to allow providing efficient
+        implementations for sync and async execution.
+
+        Args:
+            func: Either sync or async callable
+            afunc: An async callable that takes an input and returns an output.
+        """
+        if afunc is not None:
+            self.afunc = afunc
+            func_for_name: Callable = afunc
+
+        if inspect.iscoroutinefunction(func) or inspect.isasyncgenfunction(func):
+            if afunc is not None:
+                raise TypeError(
+                    "Func was provided as a coroutine function, but afunc was "
+                    "also provided. If providing both, func should be a regular "
+                    "function to avoid ambiguity."
+                )
+            self.afunc = func
+            func_for_name = func
+        elif callable(func):
+            self.func = cast(Callable[[Input], Output], func)
+            func_for_name = func
+        else:
+            raise TypeError(
+                "Expected a callable type for `func`."
+                f"Instead got an unsupported type: {type(func)}"
+            )
+
+        try:
+            if name is not None:
+                self.name = name
+            elif func_for_name.__name__ != "<lambda>":
+                self.name = func_for_name.__name__
+        except AttributeError:
+            pass
+
+    @property
+    def InputType(self) -> Any:
+        """The type of the input to this runnable."""
+        func = getattr(self, "func", None) or getattr(self, "afunc")
+        try:
+            params = inspect.signature(func).parameters
+            first_param = next(iter(params.values()), None)
+            if first_param and first_param.annotation != inspect.Parameter.empty:
+                return first_param.annotation
+            else:
+                return Any
+        except ValueError:
+            return Any
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        """The pydantic schema for the input to this runnable."""
+        func = getattr(self, "func", None) or getattr(self, "afunc")
+
+        if isinstance(func, itemgetter):
+            # This is terrible, but afaict it's not possible to access _items
+            # on itemgetter objects, so we have to parse the repr
+            items = str(func).replace("operator.itemgetter(", "")[:-1].split(", ")
+            if all(
+                item[0] == "'" and item[-1] == "'" and len(item) > 2 for item in items
+            ):
+                # It's a dict, lol
+                return create_model(
+                    self.get_name("Input"),
+                    **{item[1:-1]: (Any, None) for item in items},  # type: ignore
+                )
+            else:
+                return create_model(
+                    self.get_name("Input"),
+                    __root__=(List[Any], None),
+                )
+
+        if self.InputType != Any:
+            return super().get_input_schema(config)
+
+        if dict_keys := get_function_first_arg_dict_keys(func):
+            return create_model(
+                self.get_name("Input"),
+                **{key: (Any, None) for key in dict_keys},  # type: ignore
+            )
+
+        return super().get_input_schema(config)
+
+    @property
+    def OutputType(self) -> Any:
+        """The type of the output of this runnable as a type annotation."""
+        func = getattr(self, "func", None) or getattr(self, "afunc")
+        try:
+            sig = inspect.signature(func)
+            if sig.return_annotation != inspect.Signature.empty:
+                # unwrap iterator types
+                if getattr(sig.return_annotation, "__origin__", None) in (
+                    collections.abc.Iterator,
+                    collections.abc.AsyncIterator,
+                ):
+                    return getattr(sig.return_annotation, "__args__", (Any,))[0]
+                return sig.return_annotation
+            else:
+                return Any
+        except ValueError:
+            return Any
+
+    @property
+    def deps(self) -> List[Runnable]:
+        """The dependencies of this runnable."""
+        if hasattr(self, "func"):
+            objects = get_function_nonlocals(self.func)
+        elif hasattr(self, "afunc"):
+            objects = get_function_nonlocals(self.afunc)
+        else:
+            objects = []
+
+        deps: List[Runnable] = []
+        for obj in objects:
+            if isinstance(obj, Runnable):
+                deps.append(obj)
+            elif isinstance(getattr(obj, "__self__", None), Runnable):
+                deps.append(obj.__self__)
+        return deps
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        return get_unique_config_specs(
+            spec for dep in self.deps for spec in dep.config_specs
+        )
+
+    def get_graph(self, config: RunnableConfig | None = None) -> Graph:
+        if deps := self.deps:
+            graph = Graph()
+            input_node = graph.add_node(self.get_input_schema(config))
+            output_node = graph.add_node(self.get_output_schema(config))
+            for dep in deps:
+                dep_graph = dep.get_graph()
+                dep_graph.trim_first_node()
+                dep_graph.trim_last_node()
+                if not dep_graph:
+                    graph.add_edge(input_node, output_node)
+                else:
+                    graph.extend(dep_graph)
+                    dep_first_node = dep_graph.first_node()
+                    if not dep_first_node:
+                        raise ValueError(f"Runnable {dep} has no first node")
+                    dep_last_node = dep_graph.last_node()
+                    if not dep_last_node:
+                        raise ValueError(f"Runnable {dep} has no last node")
+                    graph.add_edge(input_node, dep_first_node)
+                    graph.add_edge(dep_last_node, output_node)
+        else:
+            graph = super().get_graph(config)
+
+        return graph
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, RunnableLambda):
+            if hasattr(self, "func") and hasattr(other, "func"):
+                return self.func == other.func
+            elif hasattr(self, "afunc") and hasattr(other, "afunc"):
+                return self.afunc == other.afunc
+            else:
+                return False
+        else:
+            return False
+
+    def __repr__(self) -> str:
+        """A string representation of this runnable."""
+        if hasattr(self, "func") and isinstance(self.func, itemgetter):
+            return f"RunnableLambda({str(self.func)[len('operator.'):]})"
+        elif hasattr(self, "func"):
+            return f"RunnableLambda({get_lambda_source(self.func) or '...'})"
+        elif hasattr(self, "afunc"):
+            return f"RunnableLambda(afunc={get_lambda_source(self.afunc) or '...'})"
+        else:
+            return "RunnableLambda(...)"
+
+    def _invoke(
+        self,
+        input: Input,
+        run_manager: CallbackManagerForChainRun,
+        config: RunnableConfig,
+        **kwargs: Any,
+    ) -> Output:
+        if inspect.isgeneratorfunction(self.func):
+            output: Optional[Output] = None
+            for chunk in call_func_with_variable_args(
+                cast(Callable[[Input], Iterator[Output]], self.func),
+                input,
+                config,
+                run_manager,
+                **kwargs,
+            ):
+                if output is None:
+                    output = chunk
+                else:
+                    try:
+                        output = output + chunk  # type: ignore[operator]
+                    except TypeError:
+                        output = chunk
+        else:
+            output = call_func_with_variable_args(
+                self.func, input, config, run_manager, **kwargs
+            )
+        # If the output is a runnable, invoke it
+        if isinstance(output, Runnable):
+            recursion_limit = config["recursion_limit"]
+            if recursion_limit <= 0:
+                raise RecursionError(
+                    f"Recursion limit reached when invoking {self} with input {input}."
+                )
+            output = output.invoke(
+                input,
+                patch_config(
+                    config,
+                    callbacks=run_manager.get_child(),
+                    recursion_limit=recursion_limit - 1,
+                ),
+            )
+        return cast(Output, output)
+
+    async def _ainvoke(
+        self,
+        input: Input,
+        run_manager: AsyncCallbackManagerForChainRun,
+        config: RunnableConfig,
+        **kwargs: Any,
+    ) -> Output:
+        if hasattr(self, "afunc"):
+            afunc = self.afunc
+        else:
+            if inspect.isgeneratorfunction(self.func):
+
+                def func(
+                    input: Input,
+                    run_manager: AsyncCallbackManagerForChainRun,
+                    config: RunnableConfig,
+                    **kwargs: Any,
+                ) -> Output:
+                    output: Optional[Output] = None
+                    for chunk in call_func_with_variable_args(
+                        cast(Callable[[Input], Iterator[Output]], self.func),
+                        input,
+                        config,
+                        run_manager.get_sync(),
+                        **kwargs,
+                    ):
+                        if output is None:
+                            output = chunk
+                        else:
+                            try:
+                                output = output + chunk  # type: ignore[operator]
+                            except TypeError:
+                                output = chunk
+                    return cast(Output, output)
+
+            else:
+
+                def func(
+                    input: Input,
+                    run_manager: AsyncCallbackManagerForChainRun,
+                    config: RunnableConfig,
+                    **kwargs: Any,
+                ) -> Output:
+                    return call_func_with_variable_args(
+                        self.func, input, config, run_manager.get_sync(), **kwargs
+                    )
+
+            @wraps(func)
+            async def f(*args, **kwargs):  # type: ignore[no-untyped-def]
+                return await run_in_executor(config, func, *args, **kwargs)
+
+            afunc = f
+
+        if inspect.isasyncgenfunction(afunc):
+            output: Optional[Output] = None
+            async for chunk in cast(
+                AsyncIterator[Output],
+                acall_func_with_variable_args(
+                    cast(Callable, afunc),
+                    input,
+                    config,
+                    run_manager,
+                    **kwargs,
+                ),
+            ):
+                if output is None:
+                    output = chunk
+                else:
+                    try:
+                        output = output + chunk  # type: ignore[operator]
+                    except TypeError:
+                        output = chunk
+        else:
+            output = await acall_func_with_variable_args(
+                cast(Callable, afunc), input, config, run_manager, **kwargs
+            )
+        # If the output is a runnable, invoke it
+        if isinstance(output, Runnable):
+            recursion_limit = config["recursion_limit"]
+            if recursion_limit <= 0:
+                raise RecursionError(
+                    f"Recursion limit reached when invoking {self} with input {input}."
+                )
+            output = await output.ainvoke(
+                input,
+                patch_config(
+                    config,
+                    callbacks=run_manager.get_child(),
+                    recursion_limit=recursion_limit - 1,
+                ),
+            )
+        return cast(Output, output)
+
+    def _config(
+        self, config: Optional[RunnableConfig], callable: Callable[..., Any]
+    ) -> RunnableConfig:
+        return ensure_config(config)
+
+    def invoke(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Output:
+        """Invoke this runnable synchronously."""
+        if hasattr(self, "func"):
+            return self._call_with_config(
+                self._invoke,
+                input,
+                self._config(config, self.func),
+                **kwargs,
+            )
+        else:
+            raise TypeError(
+                "Cannot invoke a coroutine function synchronously."
+                "Use `ainvoke` instead."
+            )
+
+    async def ainvoke(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Output:
+        """Invoke this runnable asynchronously."""
+        the_func = self.afunc if hasattr(self, "afunc") else self.func
+        return await self._acall_with_config(
+            self._ainvoke,
+            input,
+            self._config(config, the_func),
+            **kwargs,
+        )
+
+    def _transform(
+        self,
+        input: Iterator[Input],
+        run_manager: CallbackManagerForChainRun,
+        config: RunnableConfig,
+        **kwargs: Any,
+    ) -> Iterator[Output]:
+        final: Optional[Input] = None
+        for ichunk in input:
+            if final is None:
+                final = adapt_first_streaming_chunk(ichunk)  # type: ignore
+            else:
+                try:
+                    final = final + ichunk  # type: ignore[operator]
+                except TypeError:
+                    final = ichunk
+
+        if inspect.isgeneratorfunction(self.func):
+            output: Optional[Output] = None
+            for chunk in call_func_with_variable_args(
+                self.func, cast(Input, final), config, run_manager, **kwargs
+            ):
+                yield chunk
+                if output is None:
+                    output = chunk
+                else:
+                    try:
+                        output = output + chunk
+                    except TypeError:
+                        output = chunk
+        else:
+            output = call_func_with_variable_args(
+                self.func, cast(Input, final), config, run_manager, **kwargs
+            )
+
+        # If the output is a runnable, use its stream output
+        if isinstance(output, Runnable):
+            recursion_limit = config["recursion_limit"]
+            if recursion_limit <= 0:
+                raise RecursionError(
+                    f"Recursion limit reached when invoking "
+                    f"{self} with input {final}."
+                )
+            for chunk in output.stream(
+                final,
+                patch_config(
+                    config,
+                    callbacks=run_manager.get_child(),
+                    recursion_limit=recursion_limit - 1,
+                ),
+            ):
+                yield chunk
+        elif not inspect.isgeneratorfunction(self.func):
+            # Otherwise, just yield it
+            yield cast(Output, output)
+
+    def transform(
+        self,
+        input: Iterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Output]:
+        if hasattr(self, "func"):
+            for output in self._transform_stream_with_config(
+                input,
+                self._transform,
+                self._config(config, self.func),
+                **kwargs,
+            ):
+                yield output
+        else:
+            raise TypeError(
+                "Cannot stream a coroutine function synchronously."
+                "Use `astream` instead."
+            )
+
+    def stream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Output]:
+        return self.transform(iter([input]), config, **kwargs)
+
+    async def _atransform(
+        self,
+        input: AsyncIterator[Input],
+        run_manager: AsyncCallbackManagerForChainRun,
+        config: RunnableConfig,
+        **kwargs: Any,
+    ) -> AsyncIterator[Output]:
+        final: Optional[Input] = None
+        async for ichunk in input:
+            if final is None:
+                final = adapt_first_streaming_chunk(ichunk)
+            else:
+                try:
+                    final = final + ichunk  # type: ignore[operator]
+                except TypeError:
+                    final = ichunk
+
+        if hasattr(self, "afunc"):
+            afunc = self.afunc
+        else:
+            if inspect.isgeneratorfunction(self.func):
+                raise TypeError(
+                    "Cannot stream from a generator function asynchronously."
+                    "Use .stream() instead."
+                )
+
+            def func(
+                input: Input,
+                run_manager: AsyncCallbackManagerForChainRun,
+                config: RunnableConfig,
+                **kwargs: Any,
+            ) -> Output:
+                return call_func_with_variable_args(
+                    self.func, input, config, run_manager.get_sync(), **kwargs
+                )
+
+            @wraps(func)
+            async def f(*args, **kwargs):  # type: ignore[no-untyped-def]
+                return await run_in_executor(config, func, *args, **kwargs)
+
+            afunc = f
+
+        if inspect.isasyncgenfunction(afunc):
+            output: Optional[Output] = None
+            async for chunk in cast(
+                AsyncIterator[Output],
+                acall_func_with_variable_args(
+                    cast(Callable, afunc),
+                    cast(Input, final),
+                    config,
+                    run_manager,
+                    **kwargs,
+                ),
+            ):
+                yield chunk
+                if output is None:
+                    output = chunk
+                else:
+                    try:
+                        output = output + chunk  # type: ignore[operator]
+                    except TypeError:
+                        output = chunk
+        else:
+            output = await acall_func_with_variable_args(
+                cast(Callable, afunc), cast(Input, final), config, run_manager, **kwargs
+            )
+
+        # If the output is a runnable, use its astream output
+        if isinstance(output, Runnable):
+            recursion_limit = config["recursion_limit"]
+            if recursion_limit <= 0:
+                raise RecursionError(
+                    f"Recursion limit reached when invoking "
+                    f"{self} with input {final}."
+                )
+            async for chunk in output.astream(
+                final,
+                patch_config(
+                    config,
+                    callbacks=run_manager.get_child(),
+                    recursion_limit=recursion_limit - 1,
+                ),
+            ):
+                yield chunk
+        elif not inspect.isasyncgenfunction(afunc):
+            # Otherwise, just yield it
+            yield cast(Output, output)
+
+    async def atransform(
+        self,
+        input: AsyncIterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Output]:
+        async for output in self._atransform_stream_with_config(
+            input,
+            self._atransform,
+            self._config(config, self.afunc if hasattr(self, "afunc") else self.func),
+            **kwargs,
+        ):
+            yield output
+
+    async def astream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Output]:
+        async def input_aiter() -> AsyncIterator[Input]:
+            yield input
+
+        async for chunk in self.atransform(input_aiter(), config, **kwargs):
+            yield chunk
+
+
+class RunnableEachBase(RunnableSerializable[List[Input], List[Output]]):
+    """Runnable that delegates calls to another Runnable
+    with each element of the input sequence.
+
+    Use only if creating a new RunnableEach subclass with different __init__ args.
+
+    See documentation for RunnableEach for more details.
+    """
+
+    bound: Runnable[Input, Output]
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    @property
+    def InputType(self) -> Any:
+        return List[self.bound.InputType]  # type: ignore[name-defined]
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        return create_model(
+            self.get_name("Input"),
+            __root__=(
+                List[self.bound.get_input_schema(config)],  # type: ignore
+                None,
+            ),
+        )
+
+    @property
+    def OutputType(self) -> Type[List[Output]]:
+        return List[self.bound.OutputType]  # type: ignore[name-defined]
+
+    def get_output_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        schema = self.bound.get_output_schema(config)
+        return create_model(
+            self.get_name("Output"),
+            __root__=(
+                List[schema],  # type: ignore
+                None,
+            ),
+        )
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        return self.bound.config_specs
+
+    def get_graph(self, config: Optional[RunnableConfig] = None) -> Graph:
+        return self.bound.get_graph(config)
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    def _invoke(
+        self,
+        inputs: List[Input],
+        run_manager: CallbackManagerForChainRun,
+        config: RunnableConfig,
+        **kwargs: Any,
+    ) -> List[Output]:
+        return self.bound.batch(
+            inputs, patch_config(config, callbacks=run_manager.get_child()), **kwargs
+        )
+
+    def invoke(
+        self, input: List[Input], config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> List[Output]:
+        return self._call_with_config(self._invoke, input, config, **kwargs)
+
+    async def _ainvoke(
+        self,
+        inputs: List[Input],
+        run_manager: AsyncCallbackManagerForChainRun,
+        config: RunnableConfig,
+        **kwargs: Any,
+    ) -> List[Output]:
+        return await self.bound.abatch(
+            inputs, patch_config(config, callbacks=run_manager.get_child()), **kwargs
+        )
+
+    async def ainvoke(
+        self, input: List[Input], config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> List[Output]:
+        return await self._acall_with_config(self._ainvoke, input, config, **kwargs)
+
+    async def astream_events(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[StreamEvent]:
+        for _ in range(1):
+            raise NotImplementedError(
+                "RunnableEach does not support astream_events yet."
+            )
+            yield
+
+
+class RunnableEach(RunnableEachBase[Input, Output]):
+    """Runnable that delegates calls to another Runnable
+    with each element of the input sequence.
+
+    It allows you to call multiple inputs with the bounded Runnable.
+
+    RunnableEach makes it easy to run multiple inputs for the runnable.
+    In the below example, we associate and run three inputs
+    with a Runnable:
+
+        .. code-block:: python
+
+            from langchain_core.runnables.base import RunnableEach
+            from langchain_openai import ChatOpenAI
+            from langchain_core.prompts import ChatPromptTemplate
+            from langchain_core.output_parsers import StrOutputParser
+            prompt = ChatPromptTemplate.from_template("Tell me a short joke about
+            {topic}")
+            model = ChatOpenAI()
+            output_parser = StrOutputParser()
+            runnable = prompt | model | output_parser
+            runnable_each = RunnableEach(bound=runnable)
+            output = runnable_each.invoke([{'topic':'Computer Science'},
+                                        {'topic':'Art'},
+                                        {'topic':'Biology'}])
+            print(output)  # noqa: T201
+    """
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    def get_name(
+        self, suffix: Optional[str] = None, *, name: Optional[str] = None
+    ) -> str:
+        name = name or self.name or f"RunnableEach<{self.bound.get_name()}>"
+        return super().get_name(suffix, name=name)
+
+    def bind(self, **kwargs: Any) -> RunnableEach[Input, Output]:
+        return RunnableEach(bound=self.bound.bind(**kwargs))
+
+    def with_config(
+        self, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> RunnableEach[Input, Output]:
+        return RunnableEach(bound=self.bound.with_config(config, **kwargs))
+
+    def with_listeners(
+        self,
+        *,
+        on_start: Optional[Listener] = None,
+        on_end: Optional[Listener] = None,
+        on_error: Optional[Listener] = None,
+    ) -> RunnableEach[Input, Output]:
+        """
+        Bind lifecycle listeners to a Runnable, returning a new Runnable.
+
+        on_start: Called before the runnable starts running, with the Run object.
+        on_end: Called after the runnable finishes running, with the Run object.
+        on_error: Called if the runnable throws an error, with the Run object.
+
+        The Run object contains information about the run, including its id,
+        type, input, output, error, start_time, end_time, and any tags or metadata
+        added to the run.
+        """
+        return RunnableEach(
+            bound=self.bound.with_listeners(
+                on_start=on_start, on_end=on_end, on_error=on_error
+            )
+        )
+
+
+class RunnableBindingBase(RunnableSerializable[Input, Output]):
+    """Runnable that delegates calls to another Runnable with a set of kwargs.
+
+    Use only if creating a new RunnableBinding subclass with different __init__ args.
+
+    See documentation for RunnableBinding for more details.
+    """
+
+    bound: Runnable[Input, Output]
+    """The underlying runnable that this runnable delegates to."""
+
+    kwargs: Mapping[str, Any] = Field(default_factory=dict)
+    """kwargs to pass to the underlying runnable when running.
+
+    For example, when the runnable binding is invoked the underlying
+    runnable will be invoked with the same input but with these additional
+    kwargs.
+    """
+
+    config: RunnableConfig = Field(default_factory=dict)
+    """The config to bind to the underlying runnable."""
+
+    config_factories: List[Callable[[RunnableConfig], RunnableConfig]] = Field(
+        default_factory=list
+    )
+    """The config factories to bind to the underlying runnable."""
+
+    # Union[Type[Input], BaseModel] + things like List[str]
+    custom_input_type: Optional[Any] = None
+    """Override the input type of the underlying runnable with a custom type.
+
+    The type can be a pydantic model, or a type annotation (e.g., `List[str]`).
+    """
+    # Union[Type[Output], BaseModel] + things like List[str]
+    custom_output_type: Optional[Any] = None
+    """Override the output type of the underlying runnable with a custom type.
+
+    The type can be a pydantic model, or a type annotation (e.g., `List[str]`).
+    """
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    def __init__(
+        self,
+        *,
+        bound: Runnable[Input, Output],
+        kwargs: Optional[Mapping[str, Any]] = None,
+        config: Optional[RunnableConfig] = None,
+        config_factories: Optional[
+            List[Callable[[RunnableConfig], RunnableConfig]]
+        ] = None,
+        custom_input_type: Optional[Union[Type[Input], BaseModel]] = None,
+        custom_output_type: Optional[Union[Type[Output], BaseModel]] = None,
+        **other_kwargs: Any,
+    ) -> None:
+        """Create a RunnableBinding from a runnable and kwargs.
+
+        Args:
+            bound: The underlying runnable that this runnable delegates calls to.
+            kwargs: optional kwargs to pass to the underlying runnable, when running
+                    the underlying runnable (e.g., via `invoke`, `batch`,
+                    `transform`, or `stream` or async variants)
+            config: config_factories:
+            config_factories: optional list of config factories to apply to the
+            custom_input_type: Specify to override the input type of the underlying
+                               runnable with a custom type.
+            custom_output_type: Specify to override the output type of the underlying
+                runnable with a custom type.
+            **other_kwargs: Unpacked into the base class.
+        """
+        super().__init__(  # type: ignore[call-arg]
+            bound=bound,
+            kwargs=kwargs or {},
+            config=config or {},
+            config_factories=config_factories or [],
+            custom_input_type=custom_input_type,
+            custom_output_type=custom_output_type,
+            **other_kwargs,
+        )
+        # if we don't explicitly set config to the TypedDict here,
+        # the pydantic init above will strip out any of the "extra"
+        # fields even though total=False on the typed dict.
+        self.config = config or {}
+
+    def get_name(
+        self, suffix: Optional[str] = None, *, name: Optional[str] = None
+    ) -> str:
+        return self.bound.get_name(suffix, name=name)
+
+    @property
+    def InputType(self) -> Type[Input]:
+        return (
+            cast(Type[Input], self.custom_input_type)
+            if self.custom_input_type is not None
+            else self.bound.InputType
+        )
+
+    @property
+    def OutputType(self) -> Type[Output]:
+        return (
+            cast(Type[Output], self.custom_output_type)
+            if self.custom_output_type is not None
+            else self.bound.OutputType
+        )
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        if self.custom_input_type is not None:
+            return super().get_input_schema(config)
+        return self.bound.get_input_schema(merge_configs(self.config, config))
+
+    def get_output_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        if self.custom_output_type is not None:
+            return super().get_output_schema(config)
+        return self.bound.get_output_schema(merge_configs(self.config, config))
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        return self.bound.config_specs
+
+    def get_graph(self, config: Optional[RunnableConfig] = None) -> Graph:
+        return self.bound.get_graph(config)
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    def _merge_configs(self, *configs: Optional[RunnableConfig]) -> RunnableConfig:
+        config = merge_configs(self.config, *configs)
+        return merge_configs(config, *(f(config) for f in self.config_factories))
+
+    def invoke(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Output:
+        return self.bound.invoke(
+            input,
+            self._merge_configs(config),
+            **{**self.kwargs, **kwargs},
+        )
+
+    async def ainvoke(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Output:
+        return await self.bound.ainvoke(
+            input,
+            self._merge_configs(config),
+            **{**self.kwargs, **kwargs},
+        )
+
+    def batch(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        if isinstance(config, list):
+            configs = cast(
+                List[RunnableConfig],
+                [self._merge_configs(conf) for conf in config],
+            )
+        else:
+            configs = [self._merge_configs(config) for _ in range(len(inputs))]
+        return self.bound.batch(
+            inputs,
+            configs,
+            return_exceptions=return_exceptions,
+            **{**self.kwargs, **kwargs},
+        )
+
+    async def abatch(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        if isinstance(config, list):
+            configs = cast(
+                List[RunnableConfig],
+                [self._merge_configs(conf) for conf in config],
+            )
+        else:
+            configs = [self._merge_configs(config) for _ in range(len(inputs))]
+        return await self.bound.abatch(
+            inputs,
+            configs,
+            return_exceptions=return_exceptions,
+            **{**self.kwargs, **kwargs},
+        )
+
+    @overload
+    def batch_as_completed(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: Literal[False] = False,
+        **kwargs: Any,
+    ) -> Iterator[Tuple[int, Output]]:
+        ...
+
+    @overload
+    def batch_as_completed(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: Literal[True],
+        **kwargs: Any,
+    ) -> Iterator[Tuple[int, Union[Output, Exception]]]:
+        ...
+
+    def batch_as_completed(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Tuple[int, Union[Output, Exception]]]:
+        if isinstance(config, list):
+            configs = cast(
+                List[RunnableConfig],
+                [self._merge_configs(conf) for conf in config],
+            )
+        else:
+            configs = [self._merge_configs(config) for _ in range(len(inputs))]
+        # lol mypy
+        if return_exceptions:
+            yield from self.bound.batch_as_completed(
+                inputs,
+                configs,
+                return_exceptions=return_exceptions,
+                **{**self.kwargs, **kwargs},
+            )
+        else:
+            yield from self.bound.batch_as_completed(
+                inputs,
+                configs,
+                return_exceptions=return_exceptions,
+                **{**self.kwargs, **kwargs},
+            )
+
+    @overload
+    def abatch_as_completed(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: Literal[False] = False,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Tuple[int, Output]]:
+        ...
+
+    @overload
+    def abatch_as_completed(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: Literal[True],
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Tuple[int, Union[Output, Exception]]]:
+        ...
+
+    async def abatch_as_completed(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Tuple[int, Union[Output, Exception]]]:
+        if isinstance(config, list):
+            configs = cast(
+                List[RunnableConfig],
+                [self._merge_configs(conf) for conf in config],
+            )
+        else:
+            configs = [self._merge_configs(config) for _ in range(len(inputs))]
+        if return_exceptions:
+            async for item in self.bound.abatch_as_completed(
+                inputs,
+                configs,
+                return_exceptions=return_exceptions,
+                **{**self.kwargs, **kwargs},
+            ):
+                yield item
+        else:
+            async for item in self.bound.abatch_as_completed(
+                inputs,
+                configs,
+                return_exceptions=return_exceptions,
+                **{**self.kwargs, **kwargs},
+            ):
+                yield item
+
+    def stream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Output]:
+        yield from self.bound.stream(
+            input,
+            self._merge_configs(config),
+            **{**self.kwargs, **kwargs},
+        )
+
+    async def astream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Output]:
+        async for item in self.bound.astream(
+            input,
+            self._merge_configs(config),
+            **{**self.kwargs, **kwargs},
+        ):
+            yield item
+
+    async def astream_events(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[StreamEvent]:
+        async for item in self.bound.astream_events(
+            input, self._merge_configs(config), **{**self.kwargs, **kwargs}
+        ):
+            yield item
+
+    def transform(
+        self,
+        input: Iterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Iterator[Output]:
+        yield from self.bound.transform(
+            input,
+            self._merge_configs(config),
+            **{**self.kwargs, **kwargs},
+        )
+
+    async def atransform(
+        self,
+        input: AsyncIterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[Output]:
+        async for item in self.bound.atransform(
+            input,
+            self._merge_configs(config),
+            **{**self.kwargs, **kwargs},
+        ):
+            yield item
+
+
+RunnableBindingBase.update_forward_refs(RunnableConfig=RunnableConfig)
+
+
+class RunnableBinding(RunnableBindingBase[Input, Output]):
+    """Wrap a Runnable with additional functionality.
+
+    A RunnableBinding can be thought of as a "runnable decorator" that
+    preserves the essential features of Runnable; i.e., batching, streaming,
+    and async support, while adding additional functionality.
+
+    Any class that inherits from Runnable can be bound to a `RunnableBinding`.
+    Runnables expose a standard set of methods for creating `RunnableBindings`
+    or sub-classes of `RunnableBindings` (e.g., `RunnableRetry`,
+    `RunnableWithFallbacks`) that add additional functionality.
+
+    These methods include:
+    - `bind`: Bind kwargs to pass to the underlying runnable when running it.
+    - `with_config`: Bind config to pass to the underlying runnable when running it.
+    - `with_listeners`:  Bind lifecycle listeners to the underlying runnable.
+    - `with_types`: Override the input and output types of the underlying runnable.
+    - `with_retry`: Bind a retry policy to the underlying runnable.
+    - `with_fallbacks`: Bind a fallback policy to the underlying runnable.
+
+    Example:
+
+    `bind`: Bind kwargs to pass to the underlying runnable when running it.
+
+        .. code-block:: python
+
+            # Create a runnable binding that invokes the ChatModel with the
+            # additional kwarg `stop=['-']` when running it.
+            from langchain_community.chat_models import ChatOpenAI
+            model = ChatOpenAI()
+            model.invoke('Say "Parrot-MAGIC"', stop=['-']) # Should return `Parrot`
+            # Using it the easy way via `bind` method which returns a new
+            # RunnableBinding
+            runnable_binding = model.bind(stop=['-'])
+            runnable_binding.invoke('Say "Parrot-MAGIC"') # Should return `Parrot`
+
+        Can also be done by instantiating a RunnableBinding directly (not recommended):
+
+        .. code-block:: python
+
+            from langchain_core.runnables import RunnableBinding
+            runnable_binding = RunnableBinding(
+                bound=model,
+                kwargs={'stop': ['-']} # <-- Note the additional kwargs
+            )
+            runnable_binding.invoke('Say "Parrot-MAGIC"') # Should return `Parrot`
+    """
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    def bind(self, **kwargs: Any) -> Runnable[Input, Output]:
+        """Bind additional kwargs to a Runnable, returning a new Runnable.
+
+        Args:
+            **kwargs: The kwargs to bind to the Runnable.
+
+        Returns:
+            A new Runnable with the same type and config as the original,
+            but with the additional kwargs bound.
+        """
+        return self.__class__(
+            bound=self.bound,
+            config=self.config,
+            kwargs={**self.kwargs, **kwargs},
+            custom_input_type=self.custom_input_type,
+            custom_output_type=self.custom_output_type,
+        )
+
+    def with_config(
+        self,
+        config: Optional[RunnableConfig] = None,
+        # Sadly Unpack is not well supported by mypy so this will have to be untyped
+        **kwargs: Any,
+    ) -> Runnable[Input, Output]:
+        return self.__class__(
+            bound=self.bound,
+            kwargs=self.kwargs,
+            config=cast(RunnableConfig, {**self.config, **(config or {}), **kwargs}),
+            custom_input_type=self.custom_input_type,
+            custom_output_type=self.custom_output_type,
+        )
+
+    def with_listeners(
+        self,
+        *,
+        on_start: Optional[Listener] = None,
+        on_end: Optional[Listener] = None,
+        on_error: Optional[Listener] = None,
+    ) -> Runnable[Input, Output]:
+        """Bind lifecycle listeners to a Runnable, returning a new Runnable.
+
+        Args:
+            on_start: Called before the runnable starts running, with the Run object.
+            on_end: Called after the runnable finishes running, with the Run object.
+            on_error: Called if the runnable throws an error, with the Run object.
+
+        Returns:
+            The Run object contains information about the run, including its id,
+            type, input, output, error, start_time, end_time, and any tags or metadata
+            added to the run.
+        """
+        from langchain_core.tracers.root_listeners import RootListenersTracer
+
+        return self.__class__(
+            bound=self.bound,
+            kwargs=self.kwargs,
+            config=self.config,
+            config_factories=[
+                lambda config: {
+                    "callbacks": [
+                        RootListenersTracer(
+                            config=config,
+                            on_start=on_start,
+                            on_end=on_end,
+                            on_error=on_error,
+                        )
+                    ],
+                }
+            ],
+            custom_input_type=self.custom_input_type,
+            custom_output_type=self.custom_output_type,
+        )
+
+    def with_types(
+        self,
+        input_type: Optional[Union[Type[Input], BaseModel]] = None,
+        output_type: Optional[Union[Type[Output], BaseModel]] = None,
+    ) -> Runnable[Input, Output]:
+        return self.__class__(
+            bound=self.bound,
+            kwargs=self.kwargs,
+            config=self.config,
+            custom_input_type=(
+                input_type if input_type is not None else self.custom_input_type
+            ),
+            custom_output_type=(
+                output_type if output_type is not None else self.custom_output_type
+            ),
+        )
+
+    def with_retry(self, **kwargs: Any) -> Runnable[Input, Output]:
+        return self.__class__(
+            bound=self.bound.with_retry(**kwargs),
+            kwargs=self.kwargs,
+            config=self.config,
+        )
+
+    def __getattr__(self, name: str) -> Any:
+        attr = getattr(self.bound, name)
+
+        if callable(attr) and (
+            config_param := inspect.signature(attr).parameters.get("config")
+        ):
+            if config_param.kind == inspect.Parameter.KEYWORD_ONLY:
+
+                @wraps(attr)
+                def wrapper(*args: Any, **kwargs: Any) -> Any:
+                    return attr(
+                        *args,
+                        config=merge_configs(self.config, kwargs.pop("config", None)),
+                        **kwargs,
+                    )
+
+                return wrapper
+            elif config_param.kind == inspect.Parameter.POSITIONAL_OR_KEYWORD:
+                idx = list(inspect.signature(attr).parameters).index("config")
+
+                @wraps(attr)
+                def wrapper(*args: Any, **kwargs: Any) -> Any:
+                    if len(args) >= idx + 1:
+                        argsl = list(args)
+                        argsl[idx] = merge_configs(self.config, argsl[idx])
+                        return attr(*argsl, **kwargs)
+                    else:
+                        return attr(
+                            *args,
+                            config=merge_configs(
+                                self.config, kwargs.pop("config", None)
+                            ),
+                            **kwargs,
+                        )
+
+                return wrapper
+
+        return attr
+
+
+RunnableLike = Union[
+    Runnable[Input, Output],
+    Callable[[Input], Output],
+    Callable[[Input], Awaitable[Output]],
+    Callable[[Iterator[Input]], Iterator[Output]],
+    Callable[[AsyncIterator[Input]], AsyncIterator[Output]],
+    Mapping[str, Any],
+]
+
+
+def coerce_to_runnable(thing: RunnableLike) -> Runnable[Input, Output]:
+    """Coerce a runnable-like object into a Runnable.
+
+    Args:
+        thing: A runnable-like object.
+
+    Returns:
+        A Runnable.
+    """
+    if isinstance(thing, Runnable):
+        return thing
+    elif inspect.isasyncgenfunction(thing) or inspect.isgeneratorfunction(thing):
+        return RunnableGenerator(thing)
+    elif callable(thing):
+        return RunnableLambda(cast(Callable[[Input], Output], thing))
+    elif isinstance(thing, dict):
+        return cast(Runnable[Input, Output], RunnableParallel(thing))
+    else:
+        raise TypeError(
+            f"Expected a Runnable, callable or dict."
+            f"Instead got an unsupported type: {type(thing)}"
+        )
+
+
+@overload
+def chain(
+    func: Callable[[Input], Coroutine[Any, Any, Output]],
+) -> Runnable[Input, Output]:
+    ...
+
+
+@overload
+def chain(
+    func: Callable[[Input], Iterator[Output]],
+) -> Runnable[Input, Output]:
+    ...
+
+
+@overload
+def chain(
+    func: Callable[[Input], AsyncIterator[Output]],
+) -> Runnable[Input, Output]:
+    ...
+
+
+@overload
+def chain(
+    func: Callable[[Input], Output],
+) -> Runnable[Input, Output]:
+    ...
+
+
+def chain(
+    func: Union[
+        Callable[[Input], Output],
+        Callable[[Input], Iterator[Output]],
+        Callable[[Input], Coroutine[Any, Any, Output]],
+        Callable[[Input], AsyncIterator[Output]],
+    ],
+) -> Runnable[Input, Output]:
+    """Decorate a function to make it a Runnable.
+    Sets the name of the runnable to the name of the function.
+    Any runnables called by the function will be traced as dependencies.
+
+    Args:
+        func: A callable.
+
+    Returns:
+        A Runnable.
+
+    Example:
+
+    .. code-block:: python
+
+        from langchain_core.runnables import chain
+        from langchain_core.prompts import PromptTemplate
+        from langchain_openai import OpenAI
+
+        @chain
+        def my_func(fields):
+            prompt = PromptTemplate("Hello, {name}!")
+            llm = OpenAI()
+            formatted = prompt.invoke(**fields)
+
+            for chunk in llm.stream(formatted):
+                yield chunk
+    """
+    return RunnableLambda(func)
diff --git a/llm/Lib/site-packages/langchain_core/runnables/branch.py b/llm/Lib/site-packages/langchain_core/runnables/branch.py
new file mode 100644
index 0000000000000000000000000000000000000000..ddafdd2a6e70da7de4546a33132703ad8a694c56
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/branch.py
@@ -0,0 +1,421 @@
+from typing import (
+    Any,
+    AsyncIterator,
+    Awaitable,
+    Callable,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+
+from langchain_core.load.dump import dumpd
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.runnables.base import (
+    Runnable,
+    RunnableLike,
+    RunnableSerializable,
+    coerce_to_runnable,
+)
+from langchain_core.runnables.config import (
+    RunnableConfig,
+    ensure_config,
+    get_async_callback_manager_for_config,
+    get_callback_manager_for_config,
+    patch_config,
+)
+from langchain_core.runnables.utils import (
+    ConfigurableFieldSpec,
+    Input,
+    Output,
+    get_unique_config_specs,
+)
+
+
+class RunnableBranch(RunnableSerializable[Input, Output]):
+    """Runnable that selects which branch to run based on a condition.
+
+    The Runnable is initialized with a list of (condition, Runnable) pairs and
+    a default branch.
+
+    When operating on an input, the first condition that evaluates to True is
+    selected, and the corresponding Runnable is run on the input.
+
+    If no condition evaluates to True, the default branch is run on the input.
+
+    Examples:
+
+        .. code-block:: python
+
+            from langchain_core.runnables import RunnableBranch
+
+            branch = RunnableBranch(
+                (lambda x: isinstance(x, str), lambda x: x.upper()),
+                (lambda x: isinstance(x, int), lambda x: x + 1),
+                (lambda x: isinstance(x, float), lambda x: x * 2),
+                lambda x: "goodbye",
+            )
+
+            branch.invoke("hello") # "HELLO"
+            branch.invoke(None) # "goodbye"
+    """
+
+    branches: Sequence[Tuple[Runnable[Input, bool], Runnable[Input, Output]]]
+    default: Runnable[Input, Output]
+
+    def __init__(
+        self,
+        *branches: Union[
+            Tuple[
+                Union[
+                    Runnable[Input, bool],
+                    Callable[[Input], bool],
+                    Callable[[Input], Awaitable[bool]],
+                ],
+                RunnableLike,
+            ],
+            RunnableLike,  # To accommodate the default branch
+        ],
+    ) -> None:
+        """A Runnable that runs one of two branches based on a condition."""
+        if len(branches) < 2:
+            raise ValueError("RunnableBranch requires at least two branches")
+
+        default = branches[-1]
+
+        if not isinstance(
+            default,
+            (Runnable, Callable, Mapping),  # type: ignore[arg-type]
+        ):
+            raise TypeError(
+                "RunnableBranch default must be runnable, callable or mapping."
+            )
+
+        default_ = cast(
+            Runnable[Input, Output], coerce_to_runnable(cast(RunnableLike, default))
+        )
+
+        _branches = []
+
+        for branch in branches[:-1]:
+            if not isinstance(branch, (tuple, list)):  # type: ignore[arg-type]
+                raise TypeError(
+                    f"RunnableBranch branches must be "
+                    f"tuples or lists, not {type(branch)}"
+                )
+
+            if not len(branch) == 2:
+                raise ValueError(
+                    f"RunnableBranch branches must be "
+                    f"tuples or lists of length 2, not {len(branch)}"
+                )
+            condition, runnable = branch
+            condition = cast(Runnable[Input, bool], coerce_to_runnable(condition))
+            runnable = coerce_to_runnable(runnable)
+            _branches.append((condition, runnable))
+
+        super().__init__(branches=_branches, default=default_)  # type: ignore[call-arg]
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """RunnableBranch is serializable if all its branches are serializable."""
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        runnables = (
+            [self.default]
+            + [r for _, r in self.branches]
+            + [r for r, _ in self.branches]
+        )
+
+        for runnable in runnables:
+            if runnable.get_input_schema(config).schema().get("type") is not None:
+                return runnable.get_input_schema(config)
+
+        return super().get_input_schema(config)
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        from langchain_core.beta.runnables.context import (
+            CONTEXT_CONFIG_PREFIX,
+            CONTEXT_CONFIG_SUFFIX_SET,
+        )
+
+        specs = get_unique_config_specs(
+            spec
+            for step in (
+                [self.default]
+                + [r for _, r in self.branches]
+                + [r for r, _ in self.branches]
+            )
+            for spec in step.config_specs
+        )
+        if any(
+            s.id.startswith(CONTEXT_CONFIG_PREFIX)
+            and s.id.endswith(CONTEXT_CONFIG_SUFFIX_SET)
+            for s in specs
+        ):
+            raise ValueError("RunnableBranch cannot contain context setters.")
+        return specs
+
+    def invoke(
+        self, input: Input, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> Output:
+        """First evaluates the condition, then delegate to true or false branch."""
+        config = ensure_config(config)
+        callback_manager = get_callback_manager_for_config(config)
+        run_manager = callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+        )
+
+        try:
+            for idx, branch in enumerate(self.branches):
+                condition, runnable = branch
+
+                expression_value = condition.invoke(
+                    input,
+                    config=patch_config(
+                        config,
+                        callbacks=run_manager.get_child(tag=f"condition:{idx + 1}"),
+                    ),
+                )
+
+                if expression_value:
+                    output = runnable.invoke(
+                        input,
+                        config=patch_config(
+                            config,
+                            callbacks=run_manager.get_child(tag=f"branch:{idx + 1}"),
+                        ),
+                        **kwargs,
+                    )
+                    break
+            else:
+                output = self.default.invoke(
+                    input,
+                    config=patch_config(
+                        config, callbacks=run_manager.get_child(tag="branch:default")
+                    ),
+                    **kwargs,
+                )
+        except BaseException as e:
+            run_manager.on_chain_error(e)
+            raise
+        run_manager.on_chain_end(dumpd(output))
+        return output
+
+    async def ainvoke(
+        self, input: Input, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> Output:
+        """Async version of invoke."""
+        config = ensure_config(config)
+        callback_manager = get_async_callback_manager_for_config(config)
+        run_manager = await callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+        )
+        try:
+            for idx, branch in enumerate(self.branches):
+                condition, runnable = branch
+
+                expression_value = await condition.ainvoke(
+                    input,
+                    config=patch_config(
+                        config,
+                        callbacks=run_manager.get_child(tag=f"condition:{idx + 1}"),
+                    ),
+                )
+
+                if expression_value:
+                    output = await runnable.ainvoke(
+                        input,
+                        config=patch_config(
+                            config,
+                            callbacks=run_manager.get_child(tag=f"branch:{idx + 1}"),
+                        ),
+                        **kwargs,
+                    )
+                    break
+            else:
+                output = await self.default.ainvoke(
+                    input,
+                    config=patch_config(
+                        config, callbacks=run_manager.get_child(tag="branch:default")
+                    ),
+                    **kwargs,
+                )
+        except BaseException as e:
+            await run_manager.on_chain_error(e)
+            raise
+        await run_manager.on_chain_end(dumpd(output))
+        return output
+
+    def stream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Output]:
+        """First evaluates the condition,
+        then delegate to true or false branch."""
+        config = ensure_config(config)
+        callback_manager = get_callback_manager_for_config(config)
+        run_manager = callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+        )
+        final_output: Optional[Output] = None
+        final_output_supported = True
+
+        try:
+            for idx, branch in enumerate(self.branches):
+                condition, runnable = branch
+
+                expression_value = condition.invoke(
+                    input,
+                    config=patch_config(
+                        config,
+                        callbacks=run_manager.get_child(tag=f"condition:{idx + 1}"),
+                    ),
+                )
+
+                if expression_value:
+                    for chunk in runnable.stream(
+                        input,
+                        config=patch_config(
+                            config,
+                            callbacks=run_manager.get_child(tag=f"branch:{idx + 1}"),
+                        ),
+                        **kwargs,
+                    ):
+                        yield chunk
+                        if final_output_supported:
+                            if final_output is None:
+                                final_output = chunk
+                            else:
+                                try:
+                                    final_output = final_output + chunk  # type: ignore
+                                except TypeError:
+                                    final_output = None
+                                    final_output_supported = False
+                    break
+            else:
+                for chunk in self.default.stream(
+                    input,
+                    config=patch_config(
+                        config,
+                        callbacks=run_manager.get_child(tag="branch:default"),
+                    ),
+                    **kwargs,
+                ):
+                    yield chunk
+                    if final_output_supported:
+                        if final_output is None:
+                            final_output = chunk
+                        else:
+                            try:
+                                final_output = final_output + chunk  # type: ignore
+                            except TypeError:
+                                final_output = None
+                                final_output_supported = False
+        except BaseException as e:
+            run_manager.on_chain_error(e)
+            raise
+        run_manager.on_chain_end(final_output)
+
+    async def astream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Output]:
+        """First evaluates the condition,
+        then delegate to true or false branch."""
+        config = ensure_config(config)
+        callback_manager = get_async_callback_manager_for_config(config)
+        run_manager = await callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+        )
+        final_output: Optional[Output] = None
+        final_output_supported = True
+
+        try:
+            for idx, branch in enumerate(self.branches):
+                condition, runnable = branch
+
+                expression_value = await condition.ainvoke(
+                    input,
+                    config=patch_config(
+                        config,
+                        callbacks=run_manager.get_child(tag=f"condition:{idx + 1}"),
+                    ),
+                )
+
+                if expression_value:
+                    async for chunk in runnable.astream(
+                        input,
+                        config=patch_config(
+                            config,
+                            callbacks=run_manager.get_child(tag=f"branch:{idx + 1}"),
+                        ),
+                        **kwargs,
+                    ):
+                        yield chunk
+                        if final_output_supported:
+                            if final_output is None:
+                                final_output = chunk
+                            else:
+                                try:
+                                    final_output = final_output + chunk  # type: ignore
+                                except TypeError:
+                                    final_output = None
+                                    final_output_supported = False
+                    break
+            else:
+                async for chunk in self.default.astream(
+                    input,
+                    config=patch_config(
+                        config,
+                        callbacks=run_manager.get_child(tag="branch:default"),
+                    ),
+                    **kwargs,
+                ):
+                    yield chunk
+                    if final_output_supported:
+                        if final_output is None:
+                            final_output = chunk
+                        else:
+                            try:
+                                final_output = final_output + chunk  # type: ignore
+                            except TypeError:
+                                final_output = None
+                                final_output_supported = False
+        except BaseException as e:
+            await run_manager.on_chain_error(e)
+            raise
+        await run_manager.on_chain_end(final_output)
diff --git a/llm/Lib/site-packages/langchain_core/runnables/config.py b/llm/Lib/site-packages/langchain_core/runnables/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..b89a3da38fc7871c96724b7780f18372f3ec2f80
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/config.py
@@ -0,0 +1,521 @@
+from __future__ import annotations
+
+import asyncio
+import uuid
+import warnings
+from concurrent.futures import Executor, Future, ThreadPoolExecutor
+from contextlib import contextmanager
+from contextvars import ContextVar, copy_context
+from functools import partial
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Awaitable,
+    Callable,
+    Dict,
+    Generator,
+    Iterable,
+    Iterator,
+    List,
+    Optional,
+    TypeVar,
+    Union,
+    cast,
+)
+
+from typing_extensions import ParamSpec, TypedDict
+
+from langchain_core.runnables.utils import (
+    Input,
+    Output,
+    accepts_config,
+    accepts_run_manager,
+)
+
+if TYPE_CHECKING:
+    from langchain_core.callbacks.base import BaseCallbackManager, Callbacks
+    from langchain_core.callbacks.manager import (
+        AsyncCallbackManager,
+        AsyncCallbackManagerForChainRun,
+        CallbackManager,
+        CallbackManagerForChainRun,
+    )
+else:
+    # Pydantic validates through typed dicts, but
+    # the callbacks need forward refs updated
+    Callbacks = Optional[Union[List, Any]]
+
+
+class EmptyDict(TypedDict, total=False):
+    """Empty dict type."""
+
+    pass
+
+
+class RunnableConfig(TypedDict, total=False):
+    """Configuration for a Runnable."""
+
+    tags: List[str]
+    """
+    Tags for this call and any sub-calls (eg. a Chain calling an LLM).
+    You can use these to filter calls.
+    """
+
+    metadata: Dict[str, Any]
+    """
+    Metadata for this call and any sub-calls (eg. a Chain calling an LLM).
+    Keys should be strings, values should be JSON-serializable.
+    """
+
+    callbacks: Callbacks
+    """
+    Callbacks for this call and any sub-calls (eg. a Chain calling an LLM).
+    Tags are passed to all callbacks, metadata is passed to handle*Start callbacks.
+    """
+
+    run_name: str
+    """
+    Name for the tracer run for this call. Defaults to the name of the class.
+    """
+
+    max_concurrency: Optional[int]
+    """
+    Maximum number of parallel calls to make. If not provided, defaults to 
+    ThreadPoolExecutor's default.
+    """
+
+    recursion_limit: int
+    """
+    Maximum number of times a call can recurse. If not provided, defaults to 25.
+    """
+
+    configurable: Dict[str, Any]
+    """
+    Runtime values for attributes previously made configurable on this Runnable,
+    or sub-Runnables, through .configurable_fields() or .configurable_alternatives().
+    Check .output_schema() for a description of the attributes that have been made 
+    configurable.
+    """
+
+    run_id: Optional[uuid.UUID]
+    """
+    Unique identifier for the tracer run for this call. If not provided, a new UUID
+        will be generated.
+    """
+
+
+var_child_runnable_config = ContextVar(
+    "child_runnable_config", default=RunnableConfig()
+)
+
+
+def ensure_config(config: Optional[RunnableConfig] = None) -> RunnableConfig:
+    """Ensure that a config is a dict with all keys present.
+
+    Args:
+        config (Optional[RunnableConfig], optional): The config to ensure.
+          Defaults to None.
+
+    Returns:
+        RunnableConfig: The ensured config.
+    """
+    empty = RunnableConfig(
+        tags=[],
+        metadata={},
+        callbacks=None,
+        recursion_limit=25,
+        run_id=None,
+    )
+    if var_config := var_child_runnable_config.get():
+        empty.update(
+            cast(RunnableConfig, {k: v for k, v in var_config.items() if v is not None})
+        )
+    if config is not None:
+        empty.update(
+            cast(RunnableConfig, {k: v for k, v in config.items() if v is not None})
+        )
+    for key, value in empty.get("configurable", {}).items():
+        if isinstance(value, (str, int, float, bool)) and key not in empty["metadata"]:
+            empty["metadata"][key] = value
+    return empty
+
+
+def get_config_list(
+    config: Optional[Union[RunnableConfig, List[RunnableConfig]]], length: int
+) -> List[RunnableConfig]:
+    """Get a list of configs from a single config or a list of configs.
+
+     It is useful for subclasses overriding batch() or abatch().
+
+    Args:
+        config (Optional[Union[RunnableConfig, List[RunnableConfig]]]):
+          The config or list of configs.
+        length (int): The length of the list.
+
+    Returns:
+        List[RunnableConfig]: The list of configs.
+
+    Raises:
+        ValueError: If the length of the list is not equal to the length of the inputs.
+
+    """
+    if length < 0:
+        raise ValueError(f"length must be >= 0, but got {length}")
+    if isinstance(config, list) and len(config) != length:
+        raise ValueError(
+            f"config must be a list of the same length as inputs, "
+            f"but got {len(config)} configs for {length} inputs"
+        )
+
+    if isinstance(config, list):
+        return list(map(ensure_config, config))
+    if length > 1 and isinstance(config, dict) and config.get("run_id") is not None:
+        warnings.warn(
+            "Provided run_id be used only for the first element of the batch.",
+            category=RuntimeWarning,
+        )
+        subsequent = cast(
+            RunnableConfig, {k: v for k, v in config.items() if k != "run_id"}
+        )
+        return [
+            ensure_config(subsequent) if i else ensure_config(config)
+            for i in range(length)
+        ]
+    return [ensure_config(config) for i in range(length)]
+
+
+def patch_config(
+    config: Optional[RunnableConfig],
+    *,
+    callbacks: Optional[BaseCallbackManager] = None,
+    recursion_limit: Optional[int] = None,
+    max_concurrency: Optional[int] = None,
+    run_name: Optional[str] = None,
+    configurable: Optional[Dict[str, Any]] = None,
+) -> RunnableConfig:
+    """Patch a config with new values.
+
+    Args:
+        config (Optional[RunnableConfig]): The config to patch.
+        copy_locals (bool, optional): Whether to copy locals. Defaults to False.
+        callbacks (Optional[BaseCallbackManager], optional): The callbacks to set.
+          Defaults to None.
+        recursion_limit (Optional[int], optional): The recursion limit to set.
+          Defaults to None.
+        max_concurrency (Optional[int], optional): The max concurrency to set.
+          Defaults to None.
+        run_name (Optional[str], optional): The run name to set. Defaults to None.
+        configurable (Optional[Dict[str, Any]], optional): The configurable to set.
+          Defaults to None.
+
+    Returns:
+        RunnableConfig: The patched config.
+    """
+    config = ensure_config(config)
+    if callbacks is not None:
+        # If we're replacing callbacks, we need to unset run_name
+        # As that should apply only to the same run as the original callbacks
+        config["callbacks"] = callbacks
+        if "run_name" in config:
+            del config["run_name"]
+        if "run_id" in config:
+            del config["run_id"]
+    if recursion_limit is not None:
+        config["recursion_limit"] = recursion_limit
+    if max_concurrency is not None:
+        config["max_concurrency"] = max_concurrency
+    if run_name is not None:
+        config["run_name"] = run_name
+    if configurable is not None:
+        config["configurable"] = {**config.get("configurable", {}), **configurable}
+    return config
+
+
+def merge_configs(*configs: Optional[RunnableConfig]) -> RunnableConfig:
+    """Merge multiple configs into one.
+
+    Args:
+        *configs (Optional[RunnableConfig]): The configs to merge.
+
+    Returns:
+        RunnableConfig: The merged config.
+    """
+    base: RunnableConfig = {}
+    # Even though the keys aren't literals, this is correct
+    # because both dicts are the same type
+    for config in (c for c in configs if c is not None):
+        for key in config:
+            if key == "metadata":
+                base[key] = {  # type: ignore
+                    **base.get(key, {}),  # type: ignore
+                    **(config.get(key) or {}),  # type: ignore
+                }
+            elif key == "tags":
+                base[key] = list(  # type: ignore
+                    set(base.get(key, []) + (config.get(key) or [])),  # type: ignore
+                )
+            elif key == "configurable":
+                base[key] = {  # type: ignore
+                    **base.get(key, {}),  # type: ignore
+                    **(config.get(key) or {}),  # type: ignore
+                }
+            elif key == "callbacks":
+                base_callbacks = base.get("callbacks")
+                these_callbacks = config["callbacks"]
+                # callbacks can be either None, list[handler] or manager
+                # so merging two callbacks values has 6 cases
+                if isinstance(these_callbacks, list):
+                    if base_callbacks is None:
+                        base["callbacks"] = these_callbacks
+                    elif isinstance(base_callbacks, list):
+                        base["callbacks"] = base_callbacks + these_callbacks
+                    else:
+                        # base_callbacks is a manager
+                        mngr = base_callbacks.copy()
+                        for callback in these_callbacks:
+                            mngr.add_handler(callback, inherit=True)
+                        base["callbacks"] = mngr
+                elif these_callbacks is not None:
+                    # these_callbacks is a manager
+                    if base_callbacks is None:
+                        base["callbacks"] = these_callbacks
+                    elif isinstance(base_callbacks, list):
+                        mngr = these_callbacks.copy()
+                        for callback in base_callbacks:
+                            mngr.add_handler(callback, inherit=True)
+                        base["callbacks"] = mngr
+                    else:
+                        # base_callbacks is also a manager
+                        base["callbacks"] = base_callbacks.__class__(
+                            parent_run_id=base_callbacks.parent_run_id
+                            or these_callbacks.parent_run_id,
+                            handlers=base_callbacks.handlers + these_callbacks.handlers,
+                            inheritable_handlers=base_callbacks.inheritable_handlers
+                            + these_callbacks.inheritable_handlers,
+                            tags=list(set(base_callbacks.tags + these_callbacks.tags)),
+                            inheritable_tags=list(
+                                set(
+                                    base_callbacks.inheritable_tags
+                                    + these_callbacks.inheritable_tags
+                                )
+                            ),
+                            metadata={
+                                **base_callbacks.metadata,
+                                **these_callbacks.metadata,
+                            },
+                        )
+            else:
+                base[key] = config[key] or base.get(key)  # type: ignore
+    return base
+
+
+def call_func_with_variable_args(
+    func: Union[
+        Callable[[Input], Output],
+        Callable[[Input, RunnableConfig], Output],
+        Callable[[Input, CallbackManagerForChainRun], Output],
+        Callable[[Input, CallbackManagerForChainRun, RunnableConfig], Output],
+    ],
+    input: Input,
+    config: RunnableConfig,
+    run_manager: Optional[CallbackManagerForChainRun] = None,
+    **kwargs: Any,
+) -> Output:
+    """Call function that may optionally accept a run_manager and/or config.
+
+    Args:
+        func (Union[Callable[[Input], Output],
+          Callable[[Input, CallbackManagerForChainRun], Output],
+          Callable[[Input, CallbackManagerForChainRun, RunnableConfig], Output]]):
+           The function to call.
+        input (Input): The input to the function.
+        run_manager (CallbackManagerForChainRun): The run manager to
+          pass to the function.
+        config (RunnableConfig): The config to pass to the function.
+        **kwargs (Any): The keyword arguments to pass to the function.
+
+    Returns:
+        Output: The output of the function.
+    """
+    if accepts_config(func):
+        if run_manager is not None:
+            kwargs["config"] = patch_config(config, callbacks=run_manager.get_child())
+        else:
+            kwargs["config"] = config
+    if run_manager is not None and accepts_run_manager(func):
+        kwargs["run_manager"] = run_manager
+    return func(input, **kwargs)  # type: ignore[call-arg]
+
+
+def acall_func_with_variable_args(
+    func: Union[
+        Callable[[Input], Awaitable[Output]],
+        Callable[[Input, RunnableConfig], Awaitable[Output]],
+        Callable[[Input, AsyncCallbackManagerForChainRun], Awaitable[Output]],
+        Callable[
+            [Input, AsyncCallbackManagerForChainRun, RunnableConfig],
+            Awaitable[Output],
+        ],
+    ],
+    input: Input,
+    config: RunnableConfig,
+    run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
+    **kwargs: Any,
+) -> Awaitable[Output]:
+    """Call function that may optionally accept a run_manager and/or config.
+
+    Args:
+        func (Union[Callable[[Input], Awaitable[Output]], Callable[[Input,
+            AsyncCallbackManagerForChainRun], Awaitable[Output]], Callable[[Input,
+            AsyncCallbackManagerForChainRun, RunnableConfig], Awaitable[Output]]]):
+            The function to call.
+        input (Input): The input to the function.
+        run_manager (AsyncCallbackManagerForChainRun): The run manager
+          to pass to the function.
+        config (RunnableConfig): The config to pass to the function.
+        **kwargs (Any): The keyword arguments to pass to the function.
+
+    Returns:
+        Output: The output of the function.
+    """
+    if accepts_config(func):
+        if run_manager is not None:
+            kwargs["config"] = patch_config(config, callbacks=run_manager.get_child())
+        else:
+            kwargs["config"] = config
+    if run_manager is not None and accepts_run_manager(func):
+        kwargs["run_manager"] = run_manager
+    return func(input, **kwargs)  # type: ignore[call-arg]
+
+
+def get_callback_manager_for_config(config: RunnableConfig) -> CallbackManager:
+    """Get a callback manager for a config.
+
+    Args:
+        config (RunnableConfig): The config.
+
+    Returns:
+        CallbackManager: The callback manager.
+    """
+    from langchain_core.callbacks.manager import CallbackManager
+
+    return CallbackManager.configure(
+        inheritable_callbacks=config.get("callbacks"),
+        inheritable_tags=config.get("tags"),
+        inheritable_metadata=config.get("metadata"),
+    )
+
+
+def get_async_callback_manager_for_config(
+    config: RunnableConfig,
+) -> AsyncCallbackManager:
+    """Get an async callback manager for a config.
+
+    Args:
+        config (RunnableConfig): The config.
+
+    Returns:
+        AsyncCallbackManager: The async callback manager.
+    """
+    from langchain_core.callbacks.manager import AsyncCallbackManager
+
+    return AsyncCallbackManager.configure(
+        inheritable_callbacks=config.get("callbacks"),
+        inheritable_tags=config.get("tags"),
+        inheritable_metadata=config.get("metadata"),
+    )
+
+
+P = ParamSpec("P")
+T = TypeVar("T")
+
+
+class ContextThreadPoolExecutor(ThreadPoolExecutor):
+    """ThreadPoolExecutor that copies the context to the child thread."""
+
+    def submit(  # type: ignore[override]
+        self,
+        func: Callable[P, T],
+        *args: P.args,
+        **kwargs: P.kwargs,
+    ) -> Future[T]:
+        """Submit a function to the executor.
+
+        Args:
+            func (Callable[..., T]): The function to submit.
+            *args (Any): The positional arguments to the function.
+            **kwargs (Any): The keyword arguments to the function.
+
+        Returns:
+            Future[T]: The future for the function.
+        """
+        return super().submit(
+            cast(Callable[..., T], partial(copy_context().run, func, *args, **kwargs))
+        )
+
+    def map(
+        self,
+        fn: Callable[..., T],
+        *iterables: Iterable[Any],
+        timeout: float | None = None,
+        chunksize: int = 1,
+    ) -> Iterator[T]:
+        contexts = [copy_context() for _ in range(len(iterables[0]))]  # type: ignore[arg-type]
+
+        def _wrapped_fn(*args: Any) -> T:
+            return contexts.pop().run(fn, *args)
+
+        return super().map(
+            _wrapped_fn,
+            *iterables,
+            timeout=timeout,
+            chunksize=chunksize,
+        )
+
+
+@contextmanager
+def get_executor_for_config(
+    config: Optional[RunnableConfig],
+) -> Generator[Executor, None, None]:
+    """Get an executor for a config.
+
+    Args:
+        config (RunnableConfig): The config.
+
+    Yields:
+        Generator[Executor, None, None]: The executor.
+    """
+    config = config or {}
+    with ContextThreadPoolExecutor(
+        max_workers=config.get("max_concurrency")
+    ) as executor:
+        yield executor
+
+
+async def run_in_executor(
+    executor_or_config: Optional[Union[Executor, RunnableConfig]],
+    func: Callable[P, T],
+    *args: P.args,
+    **kwargs: P.kwargs,
+) -> T:
+    """Run a function in an executor.
+
+    Args:
+        executor (Executor): The executor.
+        func (Callable[P, Output]): The function.
+        *args (Any): The positional arguments to the function.
+        **kwargs (Any): The keyword arguments to the function.
+
+    Returns:
+        Output: The output of the function.
+    """
+    if executor_or_config is None or isinstance(executor_or_config, dict):
+        # Use default executor with context copied from current context
+        return await asyncio.get_running_loop().run_in_executor(
+            None,
+            cast(Callable[..., T], partial(copy_context().run, func, *args, **kwargs)),
+        )
+
+    return await asyncio.get_running_loop().run_in_executor(
+        executor_or_config, partial(func, **kwargs), *args
+    )
diff --git a/llm/Lib/site-packages/langchain_core/runnables/configurable.py b/llm/Lib/site-packages/langchain_core/runnables/configurable.py
new file mode 100644
index 0000000000000000000000000000000000000000..410cd976f9dd668b167fc9c490c97d47ac064fe5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/configurable.py
@@ -0,0 +1,671 @@
+from __future__ import annotations
+
+import enum
+import threading
+from abc import abstractmethod
+from functools import wraps
+from typing import (
+    Any,
+    AsyncIterator,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+from weakref import WeakValueDictionary
+
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.runnables.base import Runnable, RunnableSerializable
+from langchain_core.runnables.config import (
+    RunnableConfig,
+    ensure_config,
+    get_config_list,
+    get_executor_for_config,
+    merge_configs,
+)
+from langchain_core.runnables.graph import Graph
+from langchain_core.runnables.utils import (
+    AnyConfigurableField,
+    ConfigurableField,
+    ConfigurableFieldMultiOption,
+    ConfigurableFieldSingleOption,
+    ConfigurableFieldSpec,
+    Input,
+    Output,
+    gather_with_concurrency,
+    get_unique_config_specs,
+)
+
+
+class DynamicRunnable(RunnableSerializable[Input, Output]):
+    """Serializable Runnable that can be dynamically configured."""
+
+    default: RunnableSerializable[Input, Output]
+
+    config: Optional[RunnableConfig] = None
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    @property
+    def InputType(self) -> Type[Input]:
+        return self.default.InputType
+
+    @property
+    def OutputType(self) -> Type[Output]:
+        return self.default.OutputType
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        runnable, config = self.prepare(config)
+        return runnable.get_input_schema(config)
+
+    def get_output_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        runnable, config = self.prepare(config)
+        return runnable.get_output_schema(config)
+
+    def get_graph(self, config: Optional[RunnableConfig] = None) -> Graph:
+        runnable, config = self.prepare(config)
+        return runnable.get_graph(config)
+
+    def with_config(
+        self,
+        config: Optional[RunnableConfig] = None,
+        # Sadly Unpack is not well supported by mypy so this will have to be untyped
+        **kwargs: Any,
+    ) -> Runnable[Input, Output]:
+        return self.__class__(
+            **{**self.__dict__, "config": ensure_config(merge_configs(config, kwargs))}  # type: ignore[arg-type]
+        )
+
+    def prepare(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Tuple[Runnable[Input, Output], RunnableConfig]:
+        runnable: Runnable[Input, Output] = self
+        while isinstance(runnable, DynamicRunnable):
+            runnable, config = runnable._prepare(merge_configs(runnable.config, config))
+        return runnable, cast(RunnableConfig, config)
+
+    @abstractmethod
+    def _prepare(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Tuple[Runnable[Input, Output], RunnableConfig]:
+        ...
+
+    def invoke(
+        self, input: Input, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> Output:
+        runnable, config = self.prepare(config)
+        return runnable.invoke(input, config, **kwargs)
+
+    async def ainvoke(
+        self, input: Input, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> Output:
+        runnable, config = self.prepare(config)
+        return await runnable.ainvoke(input, config, **kwargs)
+
+    def batch(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        configs = get_config_list(config, len(inputs))
+        prepared = [self.prepare(c) for c in configs]
+
+        if all(p is self.default for p, _ in prepared):
+            return self.default.batch(
+                inputs,
+                [c for _, c in prepared],
+                return_exceptions=return_exceptions,
+                **kwargs,
+            )
+
+        if not inputs:
+            return []
+
+        def invoke(
+            prepared: Tuple[Runnable[Input, Output], RunnableConfig],
+            input: Input,
+        ) -> Union[Output, Exception]:
+            bound, config = prepared
+            if return_exceptions:
+                try:
+                    return bound.invoke(input, config, **kwargs)
+                except Exception as e:
+                    return e
+            else:
+                return bound.invoke(input, config, **kwargs)
+
+        # If there's only one input, don't bother with the executor
+        if len(inputs) == 1:
+            return cast(List[Output], [invoke(prepared[0], inputs[0])])
+
+        with get_executor_for_config(configs[0]) as executor:
+            return cast(List[Output], list(executor.map(invoke, prepared, inputs)))
+
+    async def abatch(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        configs = get_config_list(config, len(inputs))
+        prepared = [self.prepare(c) for c in configs]
+
+        if all(p is self.default for p, _ in prepared):
+            return await self.default.abatch(
+                inputs,
+                [c for _, c in prepared],
+                return_exceptions=return_exceptions,
+                **kwargs,
+            )
+
+        if not inputs:
+            return []
+
+        async def ainvoke(
+            prepared: Tuple[Runnable[Input, Output], RunnableConfig],
+            input: Input,
+        ) -> Union[Output, Exception]:
+            bound, config = prepared
+            if return_exceptions:
+                try:
+                    return await bound.ainvoke(input, config, **kwargs)
+                except Exception as e:
+                    return e
+            else:
+                return await bound.ainvoke(input, config, **kwargs)
+
+        coros = map(ainvoke, prepared, inputs)
+        return await gather_with_concurrency(configs[0].get("max_concurrency"), *coros)
+
+    def stream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Output]:
+        runnable, config = self.prepare(config)
+        return runnable.stream(input, config, **kwargs)
+
+    async def astream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Output]:
+        runnable, config = self.prepare(config)
+        async for chunk in runnable.astream(input, config, **kwargs):
+            yield chunk
+
+    def transform(
+        self,
+        input: Iterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Output]:
+        runnable, config = self.prepare(config)
+        return runnable.transform(input, config, **kwargs)
+
+    async def atransform(
+        self,
+        input: AsyncIterator[Input],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Output]:
+        runnable, config = self.prepare(config)
+        async for chunk in runnable.atransform(input, config, **kwargs):
+            yield chunk
+
+    def __getattr__(self, name: str) -> Any:
+        attr = getattr(self.default, name)
+        if callable(attr):
+
+            @wraps(attr)
+            def wrapper(*args: Any, **kwargs: Any) -> Any:
+                for key, arg in kwargs.items():
+                    if key == "config" and (
+                        isinstance(arg, dict)
+                        and "configurable" in arg
+                        and isinstance(arg["configurable"], dict)
+                    ):
+                        runnable, config = self.prepare(cast(RunnableConfig, arg))
+                        kwargs = {**kwargs, "config": config}
+                        return getattr(runnable, name)(*args, **kwargs)
+
+                for idx, arg in enumerate(args):
+                    if (
+                        isinstance(arg, dict)
+                        and "configurable" in arg
+                        and isinstance(arg["configurable"], dict)
+                    ):
+                        runnable, config = self.prepare(cast(RunnableConfig, arg))
+                        argsl = list(args)
+                        argsl[idx] = config
+                        return getattr(runnable, name)(*argsl, **kwargs)
+
+                if self.config:
+                    runnable, config = self.prepare()
+                    return getattr(runnable, name)(*args, **kwargs)
+
+                return attr(*args, **kwargs)
+
+            return wrapper
+
+        else:
+            return attr
+
+
+class RunnableConfigurableFields(DynamicRunnable[Input, Output]):
+    """Runnable that can be dynamically configured.
+
+    A RunnableConfigurableFields should be initiated using the
+    `configurable_fields` method of a Runnable.
+
+    Here is an example of using a RunnableConfigurableFields with LLMs:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import PromptTemplate
+            from langchain_core.runnables import ConfigurableField
+            from langchain_openai import ChatOpenAI
+
+            model = ChatOpenAI(temperature=0).configurable_fields(
+                temperature=ConfigurableField(
+                    id="temperature",
+                    name="LLM Temperature",
+                    description="The temperature of the LLM",
+                )
+            )
+            # This creates a RunnableConfigurableFields for a chat model.
+
+            # When invoking the created RunnableSequence, you can pass in the
+            # value for your ConfigurableField's id which in this case
+            # will be change in temperature
+
+            prompt = PromptTemplate.from_template("Pick a random number above {x}")
+            chain = prompt | model
+
+            chain.invoke({"x": 0})
+            chain.invoke({"x": 0}, config={"configurable": {"temperature": 0.9}})
+
+
+    Here is an example of using a RunnableConfigurableFields with HubRunnables:
+
+        .. code-block:: python
+
+            from langchain_core.prompts import PromptTemplate
+            from langchain_core.runnables import ConfigurableField
+            from langchain_openai import ChatOpenAI
+            from langchain.runnables.hub import HubRunnable
+
+            prompt = HubRunnable("rlm/rag-prompt").configurable_fields(
+                owner_repo_commit=ConfigurableField(
+                    id="hub_commit",
+                    name="Hub Commit",
+                    description="The Hub commit to pull from",
+                )
+            )
+
+            prompt.invoke({"question": "foo", "context": "bar"})
+
+            # Invoking prompt with `with_config` method
+
+            prompt.invoke(
+                {"question": "foo", "context": "bar"},
+                config={"configurable": {"hub_commit": "rlm/rag-prompt-llama"}},
+            )
+    """
+
+    fields: Dict[str, AnyConfigurableField]
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        return get_unique_config_specs(
+            [
+                (
+                    ConfigurableFieldSpec(
+                        id=spec.id,
+                        name=spec.name,
+                        description=spec.description
+                        or self.default.__fields__[field_name].field_info.description,
+                        annotation=spec.annotation
+                        or self.default.__fields__[field_name].annotation,
+                        default=getattr(self.default, field_name),
+                        is_shared=spec.is_shared,
+                    )
+                    if isinstance(spec, ConfigurableField)
+                    else make_options_spec(
+                        spec, self.default.__fields__[field_name].field_info.description
+                    )
+                )
+                for field_name, spec in self.fields.items()
+            ]
+            + list(self.default.config_specs)
+        )
+
+    def configurable_fields(
+        self, **kwargs: AnyConfigurableField
+    ) -> RunnableSerializable[Input, Output]:
+        return self.default.configurable_fields(**{**self.fields, **kwargs})
+
+    def _prepare(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Tuple[Runnable[Input, Output], RunnableConfig]:
+        config = ensure_config(config)
+        specs_by_id = {spec.id: (key, spec) for key, spec in self.fields.items()}
+        configurable_fields = {
+            specs_by_id[k][0]: v
+            for k, v in config.get("configurable", {}).items()
+            if k in specs_by_id and isinstance(specs_by_id[k][1], ConfigurableField)
+        }
+        configurable_single_options = {
+            k: v.options[(config.get("configurable", {}).get(v.id) or v.default)]
+            for k, v in self.fields.items()
+            if isinstance(v, ConfigurableFieldSingleOption)
+        }
+        configurable_multi_options = {
+            k: [
+                v.options[o]
+                for o in config.get("configurable", {}).get(v.id, v.default)
+            ]
+            for k, v in self.fields.items()
+            if isinstance(v, ConfigurableFieldMultiOption)
+        }
+        configurable = {
+            **configurable_fields,
+            **configurable_single_options,
+            **configurable_multi_options,
+        }
+
+        if configurable:
+            init_params = {
+                k: v
+                for k, v in self.default.__dict__.items()
+                if k in self.default.__fields__
+            }
+            return (
+                self.default.__class__(**{**init_params, **configurable}),
+                config,
+            )
+        else:
+            return (self.default, config)
+
+
+# Before Python 3.11 native StrEnum is not available
+class StrEnum(str, enum.Enum):
+    """String enum."""
+
+    pass
+
+
+_enums_for_spec: WeakValueDictionary[
+    Union[
+        ConfigurableFieldSingleOption, ConfigurableFieldMultiOption, ConfigurableField
+    ],
+    Type[StrEnum],
+] = WeakValueDictionary()
+
+_enums_for_spec_lock = threading.Lock()
+
+
+class RunnableConfigurableAlternatives(DynamicRunnable[Input, Output]):
+    """Runnable that can be dynamically configured.
+
+    A RunnableConfigurableAlternatives should be initiated using the
+    `configurable_alternatives` method of a Runnable or can be
+    initiated directly as well.
+
+    Here is an example of using a RunnableConfigurableAlternatives that uses
+    alternative prompts to illustrate its functionality:
+
+        .. code-block:: python
+
+            from langchain_core.runnables import ConfigurableField
+            from langchain_openai import ChatOpenAI
+
+            # This creates a RunnableConfigurableAlternatives for Prompt Runnable
+            # with two alternatives.
+            prompt = PromptTemplate.from_template(
+                "Tell me a joke about {topic}"
+            ).configurable_alternatives(
+                ConfigurableField(id="prompt"),
+                default_key="joke",
+                poem=PromptTemplate.from_template("Write a short poem about {topic}")
+            )
+
+            # When invoking the created RunnableSequence, you can pass in the
+            # value for your ConfigurableField's id which in this case will either be
+            # `joke` or `poem`.
+            chain = prompt | ChatOpenAI(model="gpt-3.5-turbo-0125", temperature=0)
+
+            # The `with_config` method brings in the desired Prompt Runnable in your
+            # Runnable Sequence.
+            chain.with_config(configurable={"prompt": "poem"}).invoke({"topic": "bears"})
+
+
+    Equivalently, you can initialize RunnableConfigurableAlternatives directly
+    and use in LCEL in the same way:
+
+        .. code-block:: python
+
+            from langchain_core.runnables import ConfigurableField
+            from langchain_core.runnables.configurable import RunnableConfigurableAlternatives
+            from langchain_openai import ChatOpenAI
+
+            prompt = RunnableConfigurableAlternatives(
+                which=ConfigurableField(id='prompt'),
+                default=PromptTemplate.from_template("Tell me a joke about {topic}"),
+                default_key='joke',
+                prefix_keys=False,
+                alternatives={"poem":PromptTemplate.from_template("Write a short poem about {topic}")}
+            )
+            chain = prompt | ChatOpenAI(model="gpt-3.5-turbo-0125", temperature=0)
+            chain.with_config(configurable={"prompt": "poem"}).invoke({"topic": "bears"})
+
+    """  # noqa: E501
+
+    which: ConfigurableField
+
+    alternatives: Dict[
+        str,
+        Union[Runnable[Input, Output], Callable[[], Runnable[Input, Output]]],
+    ]
+
+    default_key: str = "default"
+    """The enum value to use for the default option. Defaults to "default"."""
+
+    prefix_keys: bool
+    """Whether to prefix configurable fields of each alternative with a namespace
+    of the form <which.id>==<alternative_key>, eg. a key named "temperature" used by 
+    the alternative named "gpt3" becomes "model==gpt3/temperature"."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        with _enums_for_spec_lock:
+            if which_enum := _enums_for_spec.get(self.which):
+                pass
+            else:
+                which_enum = StrEnum(  # type: ignore[call-overload]
+                    self.which.name or self.which.id,
+                    (
+                        (v, v)
+                        for v in list(self.alternatives.keys()) + [self.default_key]
+                    ),
+                )
+                _enums_for_spec[self.which] = cast(Type[StrEnum], which_enum)
+        return get_unique_config_specs(
+            # which alternative
+            [
+                ConfigurableFieldSpec(
+                    id=self.which.id,
+                    name=self.which.name,
+                    description=self.which.description,
+                    annotation=which_enum,
+                    default=self.default_key,
+                    is_shared=self.which.is_shared,
+                ),
+            ]
+            # config specs of the default option
+            + (
+                [
+                    prefix_config_spec(s, f"{self.which.id}=={self.default_key}")
+                    for s in self.default.config_specs
+                ]
+                if self.prefix_keys
+                else self.default.config_specs
+            )
+            # config specs of the alternatives
+            + [
+                (
+                    prefix_config_spec(s, f"{self.which.id}=={alt_key}")
+                    if self.prefix_keys
+                    else s
+                )
+                for alt_key, alt in self.alternatives.items()
+                if isinstance(alt, RunnableSerializable)
+                for s in alt.config_specs
+            ]
+        )
+
+    def configurable_fields(
+        self, **kwargs: AnyConfigurableField
+    ) -> RunnableSerializable[Input, Output]:
+        return self.__class__(
+            which=self.which,
+            default=self.default.configurable_fields(**kwargs),
+            alternatives=self.alternatives,
+            default_key=self.default_key,
+            prefix_keys=self.prefix_keys,
+        )
+
+    def _prepare(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Tuple[Runnable[Input, Output], RunnableConfig]:
+        config = ensure_config(config)
+        which = config.get("configurable", {}).get(self.which.id, self.default_key)
+        # remap configurable keys for the chosen alternative
+        if self.prefix_keys:
+            config = cast(
+                RunnableConfig,
+                {
+                    **config,
+                    "configurable": {
+                        _strremoveprefix(k, f"{self.which.id}=={which}/"): v
+                        for k, v in config.get("configurable", {}).items()
+                    },
+                },
+            )
+        # return the chosen alternative
+        if which == self.default_key:
+            return (self.default, config)
+        elif which in self.alternatives:
+            alt = self.alternatives[which]
+            if isinstance(alt, Runnable):
+                return (alt, config)
+            else:
+                return (alt(), config)
+        else:
+            raise ValueError(f"Unknown alternative: {which}")
+
+
+def _strremoveprefix(s: str, prefix: str) -> str:
+    """str.removeprefix() is only available in Python 3.9+."""
+    return s.replace(prefix, "", 1) if s.startswith(prefix) else s
+
+
+def prefix_config_spec(
+    spec: ConfigurableFieldSpec, prefix: str
+) -> ConfigurableFieldSpec:
+    """Prefix the id of a ConfigurableFieldSpec.
+
+    This is useful when a RunnableConfigurableAlternatives is used as a
+    ConfigurableField of another RunnableConfigurableAlternatives.
+
+    Args:
+        spec: The ConfigurableFieldSpec to prefix.
+        prefix: The prefix to add.
+
+    Returns:
+
+    """
+    return (
+        ConfigurableFieldSpec(
+            id=f"{prefix}/{spec.id}",
+            name=spec.name,
+            description=spec.description,
+            annotation=spec.annotation,
+            default=spec.default,
+            is_shared=spec.is_shared,
+        )
+        if not spec.is_shared
+        else spec
+    )
+
+
+def make_options_spec(
+    spec: Union[ConfigurableFieldSingleOption, ConfigurableFieldMultiOption],
+    description: Optional[str],
+) -> ConfigurableFieldSpec:
+    """Make a ConfigurableFieldSpec for a ConfigurableFieldSingleOption or
+    ConfigurableFieldMultiOption."""
+    with _enums_for_spec_lock:
+        if enum := _enums_for_spec.get(spec):
+            pass
+        else:
+            enum = StrEnum(  # type: ignore[call-overload]
+                spec.name or spec.id,
+                ((v, v) for v in list(spec.options.keys())),
+            )
+            _enums_for_spec[spec] = cast(Type[StrEnum], enum)
+    if isinstance(spec, ConfigurableFieldSingleOption):
+        return ConfigurableFieldSpec(
+            id=spec.id,
+            name=spec.name,
+            description=spec.description or description,
+            annotation=enum,
+            default=spec.default,
+            is_shared=spec.is_shared,
+        )
+    else:
+        return ConfigurableFieldSpec(
+            id=spec.id,
+            name=spec.name,
+            description=spec.description or description,
+            annotation=Sequence[enum],  # type: ignore[valid-type]
+            default=spec.default,
+            is_shared=spec.is_shared,
+        )
diff --git a/llm/Lib/site-packages/langchain_core/runnables/fallbacks.py b/llm/Lib/site-packages/langchain_core/runnables/fallbacks.py
new file mode 100644
index 0000000000000000000000000000000000000000..131061e9e9f6fc9dd90b83690295dcaf0fb926b6
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/fallbacks.py
@@ -0,0 +1,549 @@
+import asyncio
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Awaitable,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+
+from langchain_core.load.dump import dumpd
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.runnables.base import Runnable, RunnableSerializable
+from langchain_core.runnables.config import (
+    RunnableConfig,
+    ensure_config,
+    get_async_callback_manager_for_config,
+    get_callback_manager_for_config,
+    get_config_list,
+    patch_config,
+)
+from langchain_core.runnables.utils import (
+    ConfigurableFieldSpec,
+    Input,
+    Output,
+    get_unique_config_specs,
+)
+from langchain_core.utils.aiter import py_anext
+
+if TYPE_CHECKING:
+    from langchain_core.callbacks.manager import AsyncCallbackManagerForChainRun
+
+
+class RunnableWithFallbacks(RunnableSerializable[Input, Output]):
+    """Runnable that can fallback to other Runnables if it fails.
+
+    External APIs (e.g., APIs for a language model) may at times experience
+    degraded performance or even downtime.
+
+    In these cases, it can be useful to have a fallback Runnable that can be
+    used in place of the original Runnable (e.g., fallback to another LLM provider).
+
+    Fallbacks can be defined at the level of a single Runnable, or at the level
+    of a chain of Runnables. Fallbacks are tried in order until one succeeds or
+    all fail.
+
+    While you can instantiate a ``RunnableWithFallbacks`` directly, it is usually
+    more convenient to use the ``with_fallbacks`` method on a Runnable.
+
+    Example:
+
+        .. code-block:: python
+
+            from langchain_core.chat_models.openai import ChatOpenAI
+            from langchain_core.chat_models.anthropic import ChatAnthropic
+
+            model = ChatAnthropic().with_fallbacks([ChatOpenAI()])
+            # Will usually use ChatAnthropic, but fallback to ChatOpenAI
+            # if ChatAnthropic fails.
+            model.invoke('hello')
+
+            # And you can also use fallbacks at the level of a chain.
+            # Here if both LLM providers fail, we'll fallback to a good hardcoded
+            # response.
+
+            from langchain_core.prompts import PromptTemplate
+            from langchain_core.output_parser import StrOutputParser
+            from langchain_core.runnables import RunnableLambda
+
+            def when_all_is_lost(inputs):
+                return ("Looks like our LLM providers are down. "
+                        "Here's a nice 🦜️ emoji for you instead.")
+
+            chain_with_fallback = (
+                PromptTemplate.from_template('Tell me a joke about {topic}')
+                | model
+                | StrOutputParser()
+            ).with_fallbacks([RunnableLambda(when_all_is_lost)])
+    """
+
+    runnable: Runnable[Input, Output]
+    """The runnable to run first."""
+    fallbacks: Sequence[Runnable[Input, Output]]
+    """A sequence of fallbacks to try."""
+    exceptions_to_handle: Tuple[Type[BaseException], ...] = (Exception,)
+    """The exceptions on which fallbacks should be tried.
+    
+    Any exception that is not a subclass of these exceptions will be raised immediately.
+    """
+    exception_key: Optional[str] = None
+    """If string is specified then handled exceptions will be passed to fallbacks as 
+        part of the input under the specified key. If None, exceptions
+        will not be passed to fallbacks. If used, the base runnable and its fallbacks 
+        must accept a dictionary as input."""
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    @property
+    def InputType(self) -> Type[Input]:
+        return self.runnable.InputType
+
+    @property
+    def OutputType(self) -> Type[Output]:
+        return self.runnable.OutputType
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        return self.runnable.get_input_schema(config)
+
+    def get_output_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        return self.runnable.get_output_schema(config)
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        return get_unique_config_specs(
+            spec
+            for step in [self.runnable, *self.fallbacks]
+            for spec in step.config_specs
+        )
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    @property
+    def runnables(self) -> Iterator[Runnable[Input, Output]]:
+        yield self.runnable
+        yield from self.fallbacks
+
+    def invoke(
+        self, input: Input, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> Output:
+        if self.exception_key is not None and not isinstance(input, dict):
+            raise ValueError(
+                "If 'exception_key' is specified then input must be a dictionary."
+                f"However found a type of {type(input)} for input"
+            )
+        # setup callbacks
+        config = ensure_config(config)
+        callback_manager = get_callback_manager_for_config(config)
+        # start the root run
+        run_manager = callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+        )
+        first_error = None
+        last_error = None
+        for runnable in self.runnables:
+            try:
+                if self.exception_key and last_error is not None:
+                    input[self.exception_key] = last_error
+                output = runnable.invoke(
+                    input,
+                    patch_config(config, callbacks=run_manager.get_child()),
+                    **kwargs,
+                )
+            except self.exceptions_to_handle as e:
+                if first_error is None:
+                    first_error = e
+                last_error = e
+            except BaseException as e:
+                run_manager.on_chain_error(e)
+                raise e
+            else:
+                run_manager.on_chain_end(output)
+                return output
+        if first_error is None:
+            raise ValueError("No error stored at end of fallbacks.")
+        run_manager.on_chain_error(first_error)
+        raise first_error
+
+    async def ainvoke(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Output:
+        if self.exception_key is not None and not isinstance(input, dict):
+            raise ValueError(
+                "If 'exception_key' is specified then input must be a dictionary."
+                f"However found a type of {type(input)} for input"
+            )
+        # setup callbacks
+        config = ensure_config(config)
+        callback_manager = get_async_callback_manager_for_config(config)
+        # start the root run
+        run_manager = await callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+        )
+
+        first_error = None
+        last_error = None
+        for runnable in self.runnables:
+            try:
+                if self.exception_key and last_error is not None:
+                    input[self.exception_key] = last_error
+                output = await runnable.ainvoke(
+                    input,
+                    patch_config(config, callbacks=run_manager.get_child()),
+                    **kwargs,
+                )
+            except self.exceptions_to_handle as e:
+                if first_error is None:
+                    first_error = e
+                last_error = e
+            except BaseException as e:
+                await run_manager.on_chain_error(e)
+                raise e
+            else:
+                await run_manager.on_chain_end(output)
+                return output
+        if first_error is None:
+            raise ValueError("No error stored at end of fallbacks.")
+        await run_manager.on_chain_error(first_error)
+        raise first_error
+
+    def batch(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        from langchain_core.callbacks.manager import CallbackManager
+
+        if self.exception_key is not None and not all(
+            isinstance(input, dict) for input in inputs
+        ):
+            raise ValueError(
+                "If 'exception_key' is specified then inputs must be dictionaries."
+                f"However found a type of {type(inputs[0])} for input"
+            )
+
+        if not inputs:
+            return []
+
+        # setup callbacks
+        configs = get_config_list(config, len(inputs))
+        callback_managers = [
+            CallbackManager.configure(
+                inheritable_callbacks=config.get("callbacks"),
+                local_callbacks=None,
+                verbose=False,
+                inheritable_tags=config.get("tags"),
+                local_tags=None,
+                inheritable_metadata=config.get("metadata"),
+                local_metadata=None,
+            )
+            for config in configs
+        ]
+        # start the root runs, one per input
+        run_managers = [
+            cm.on_chain_start(
+                dumpd(self),
+                input if isinstance(input, dict) else {"input": input},
+                name=config.get("run_name"),
+                run_id=config.pop("run_id", None),
+            )
+            for cm, input, config in zip(callback_managers, inputs, configs)
+        ]
+
+        to_return: Dict[int, Any] = {}
+        run_again = {i: input for i, input in enumerate(inputs)}
+        handled_exceptions: Dict[int, BaseException] = {}
+        first_to_raise = None
+        for runnable in self.runnables:
+            outputs = runnable.batch(
+                [input for _, input in sorted(run_again.items())],
+                [
+                    # each step a child run of the corresponding root run
+                    patch_config(configs[i], callbacks=run_managers[i].get_child())
+                    for i in sorted(run_again)
+                ],
+                return_exceptions=True,
+                **kwargs,
+            )
+            for (i, input), output in zip(sorted(run_again.copy().items()), outputs):
+                if isinstance(output, BaseException) and not isinstance(
+                    output, self.exceptions_to_handle
+                ):
+                    if not return_exceptions:
+                        first_to_raise = first_to_raise or output
+                    else:
+                        handled_exceptions[i] = cast(BaseException, output)
+                    run_again.pop(i)
+                elif isinstance(output, self.exceptions_to_handle):
+                    if self.exception_key:
+                        input[self.exception_key] = output  # type: ignore
+                    handled_exceptions[i] = cast(BaseException, output)
+                else:
+                    run_managers[i].on_chain_end(output)
+                    to_return[i] = output
+                    run_again.pop(i)
+                    handled_exceptions.pop(i, None)
+            if first_to_raise:
+                raise first_to_raise
+            if not run_again:
+                break
+
+        sorted_handled_exceptions = sorted(handled_exceptions.items())
+        for i, error in sorted_handled_exceptions:
+            run_managers[i].on_chain_error(error)
+        if not return_exceptions and sorted_handled_exceptions:
+            raise sorted_handled_exceptions[0][1]
+        to_return.update(handled_exceptions)
+        return [output for _, output in sorted(to_return.items())]
+
+    async def abatch(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        from langchain_core.callbacks.manager import AsyncCallbackManager
+
+        if self.exception_key is not None and not all(
+            isinstance(input, dict) for input in inputs
+        ):
+            raise ValueError(
+                "If 'exception_key' is specified then inputs must be dictionaries."
+                f"However found a type of {type(inputs[0])} for input"
+            )
+
+        if not inputs:
+            return []
+
+        # setup callbacks
+        configs = get_config_list(config, len(inputs))
+        callback_managers = [
+            AsyncCallbackManager.configure(
+                inheritable_callbacks=config.get("callbacks"),
+                local_callbacks=None,
+                verbose=False,
+                inheritable_tags=config.get("tags"),
+                local_tags=None,
+                inheritable_metadata=config.get("metadata"),
+                local_metadata=None,
+            )
+            for config in configs
+        ]
+        # start the root runs, one per input
+        run_managers: List[AsyncCallbackManagerForChainRun] = await asyncio.gather(
+            *(
+                cm.on_chain_start(
+                    dumpd(self),
+                    input,
+                    name=config.get("run_name"),
+                    run_id=config.pop("run_id", None),
+                )
+                for cm, input, config in zip(callback_managers, inputs, configs)
+            )
+        )
+
+        to_return = {}
+        run_again = {i: input for i, input in enumerate(inputs)}
+        handled_exceptions: Dict[int, BaseException] = {}
+        first_to_raise = None
+        for runnable in self.runnables:
+            outputs = await runnable.abatch(
+                [input for _, input in sorted(run_again.items())],
+                [
+                    # each step a child run of the corresponding root run
+                    patch_config(configs[i], callbacks=run_managers[i].get_child())
+                    for i in sorted(run_again)
+                ],
+                return_exceptions=True,
+                **kwargs,
+            )
+
+            for (i, input), output in zip(sorted(run_again.copy().items()), outputs):
+                if isinstance(output, BaseException) and not isinstance(
+                    output, self.exceptions_to_handle
+                ):
+                    if not return_exceptions:
+                        first_to_raise = first_to_raise or output
+                    else:
+                        handled_exceptions[i] = cast(BaseException, output)
+                    run_again.pop(i)
+                elif isinstance(output, self.exceptions_to_handle):
+                    if self.exception_key:
+                        input[self.exception_key] = output  # type: ignore
+                    handled_exceptions[i] = cast(BaseException, output)
+                else:
+                    to_return[i] = output
+                    await run_managers[i].on_chain_end(output)
+                    run_again.pop(i)
+                    handled_exceptions.pop(i, None)
+
+            if first_to_raise:
+                raise first_to_raise
+            if not run_again:
+                break
+
+        sorted_handled_exceptions = sorted(handled_exceptions.items())
+        await asyncio.gather(
+            *(
+                run_managers[i].on_chain_error(error)
+                for i, error in sorted_handled_exceptions
+            )
+        )
+        if not return_exceptions and sorted_handled_exceptions:
+            raise sorted_handled_exceptions[0][1]
+        to_return.update(handled_exceptions)
+        return [output for _, output in sorted(to_return.items())]  # type: ignore
+
+    def stream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Output]:
+        """"""
+        if self.exception_key is not None and not isinstance(input, dict):
+            raise ValueError(
+                "If 'exception_key' is specified then input must be a dictionary."
+                f"However found a type of {type(input)} for input"
+            )
+        # setup callbacks
+        config = ensure_config(config)
+        callback_manager = get_callback_manager_for_config(config)
+        # start the root run
+        run_manager = callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+        )
+        first_error = None
+        last_error = None
+        for runnable in self.runnables:
+            try:
+                if self.exception_key and last_error is not None:
+                    input[self.exception_key] = last_error
+                stream = runnable.stream(
+                    input,
+                    patch_config(config, callbacks=run_manager.get_child()),
+                    **kwargs,
+                )
+                chunk = next(stream)
+            except self.exceptions_to_handle as e:
+                first_error = e if first_error is None else first_error
+                last_error = e
+            except BaseException as e:
+                run_manager.on_chain_error(e)
+                raise e
+            else:
+                first_error = None
+                break
+        if first_error:
+            run_manager.on_chain_error(first_error)
+            raise first_error
+
+        yield chunk
+        output: Optional[Output] = chunk
+        try:
+            for chunk in stream:
+                yield chunk
+                try:
+                    output = output + chunk  # type: ignore
+                except TypeError:
+                    output = None
+        except BaseException as e:
+            run_manager.on_chain_error(e)
+            raise e
+        run_manager.on_chain_end(output)
+
+    async def astream(
+        self,
+        input: Input,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Output]:
+        if self.exception_key is not None and not isinstance(input, dict):
+            raise ValueError(
+                "If 'exception_key' is specified then input must be a dictionary."
+                f"However found a type of {type(input)} for input"
+            )
+        # setup callbacks
+        config = ensure_config(config)
+        callback_manager = get_async_callback_manager_for_config(config)
+        # start the root run
+        run_manager = await callback_manager.on_chain_start(
+            dumpd(self),
+            input,
+            name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+        )
+        first_error = None
+        last_error = None
+        for runnable in self.runnables:
+            try:
+                if self.exception_key and last_error is not None:
+                    input[self.exception_key] = last_error
+                stream = runnable.astream(
+                    input,
+                    patch_config(config, callbacks=run_manager.get_child()),
+                    **kwargs,
+                )
+                chunk = await cast(Awaitable[Output], py_anext(stream))
+            except self.exceptions_to_handle as e:
+                first_error = e if first_error is None else first_error
+                last_error = e
+            except BaseException as e:
+                await run_manager.on_chain_error(e)
+                raise e
+            else:
+                first_error = None
+                break
+        if first_error:
+            await run_manager.on_chain_error(first_error)
+            raise first_error
+
+        yield chunk
+        output: Optional[Output] = chunk
+        try:
+            async for chunk in stream:
+                yield chunk
+                try:
+                    output = output + chunk  # type: ignore
+                except TypeError:
+                    output = None
+        except BaseException as e:
+            await run_manager.on_chain_error(e)
+            raise e
+        await run_manager.on_chain_end(output)
diff --git a/llm/Lib/site-packages/langchain_core/runnables/graph.py b/llm/Lib/site-packages/langchain_core/runnables/graph.py
new file mode 100644
index 0000000000000000000000000000000000000000..f92b4b064a271913ec2fabd6ba84730959aa5009
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/graph.py
@@ -0,0 +1,401 @@
+from __future__ import annotations
+
+import inspect
+from dataclasses import dataclass, field
+from enum import Enum
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    List,
+    NamedTuple,
+    Optional,
+    Type,
+    TypedDict,
+    Union,
+    overload,
+)
+from uuid import UUID, uuid4
+
+from langchain_core.pydantic_v1 import BaseModel
+
+if TYPE_CHECKING:
+    from langchain_core.runnables.base import Runnable as RunnableType
+
+
+class LabelsDict(TypedDict):
+    nodes: dict[str, str]
+    edges: dict[str, str]
+
+
+def is_uuid(value: str) -> bool:
+    try:
+        UUID(value)
+        return True
+    except ValueError:
+        return False
+
+
+class Edge(NamedTuple):
+    """Edge in a graph."""
+
+    source: str
+    target: str
+    data: Optional[str] = None
+    conditional: bool = False
+
+
+class Node(NamedTuple):
+    """Node in a graph."""
+
+    id: str
+    data: Union[Type[BaseModel], RunnableType]
+
+
+class Branch(NamedTuple):
+    """Branch in a graph."""
+
+    condition: Callable[..., str]
+    ends: Optional[dict[str, str]]
+
+
+class CurveStyle(Enum):
+    """Enum for different curve styles supported by Mermaid"""
+
+    BASIS = "basis"
+    BUMP_X = "bumpX"
+    BUMP_Y = "bumpY"
+    CARDINAL = "cardinal"
+    CATMULL_ROM = "catmullRom"
+    LINEAR = "linear"
+    MONOTONE_X = "monotoneX"
+    MONOTONE_Y = "monotoneY"
+    NATURAL = "natural"
+    STEP = "step"
+    STEP_AFTER = "stepAfter"
+    STEP_BEFORE = "stepBefore"
+
+
+@dataclass
+class NodeColors:
+    """Schema for Hexadecimal color codes for different node types"""
+
+    start: str = "#ffdfba"
+    end: str = "#baffc9"
+    other: str = "#fad7de"
+
+
+class MermaidDrawMethod(Enum):
+    """Enum for different draw methods supported by Mermaid"""
+
+    PYPPETEER = "pyppeteer"  # Uses Pyppeteer to render the graph
+    API = "api"  # Uses Mermaid.INK API to render the graph
+
+
+def node_data_str(node: Node) -> str:
+    from langchain_core.runnables.base import Runnable
+
+    if not is_uuid(node.id):
+        return node.id
+    elif isinstance(node.data, Runnable):
+        try:
+            data = str(node.data)
+            if (
+                data.startswith("<")
+                or data[0] != data[0].upper()
+                or len(data.splitlines()) > 1
+            ):
+                data = node.data.__class__.__name__
+            elif len(data) > 42:
+                data = data[:42] + "..."
+        except Exception:
+            data = node.data.__class__.__name__
+    else:
+        data = node.data.__name__
+    return data if not data.startswith("Runnable") else data[8:]
+
+
+def node_data_json(
+    node: Node, *, with_schemas: bool = False
+) -> Dict[str, Union[str, Dict[str, Any]]]:
+    from langchain_core.load.serializable import to_json_not_implemented
+    from langchain_core.runnables.base import Runnable, RunnableSerializable
+
+    if isinstance(node.data, RunnableSerializable):
+        return {
+            "type": "runnable",
+            "data": {
+                "id": node.data.lc_id(),
+                "name": node.data.get_name(),
+            },
+        }
+    elif isinstance(node.data, Runnable):
+        return {
+            "type": "runnable",
+            "data": {
+                "id": to_json_not_implemented(node.data)["id"],
+                "name": node.data.get_name(),
+            },
+        }
+    elif inspect.isclass(node.data) and issubclass(node.data, BaseModel):
+        return (
+            {
+                "type": "schema",
+                "data": node.data.schema(),
+            }
+            if with_schemas
+            else {
+                "type": "schema",
+                "data": node_data_str(node),
+            }
+        )
+    else:
+        return {
+            "type": "unknown",
+            "data": node_data_str(node),
+        }
+
+
+@dataclass
+class Graph:
+    """Graph of nodes and edges."""
+
+    nodes: Dict[str, Node] = field(default_factory=dict)
+    edges: List[Edge] = field(default_factory=list)
+
+    def to_json(self, *, with_schemas: bool = False) -> Dict[str, List[Dict[str, Any]]]:
+        """Convert the graph to a JSON-serializable format."""
+        stable_node_ids = {
+            node.id: i if is_uuid(node.id) else node.id
+            for i, node in enumerate(self.nodes.values())
+        }
+        edges: List[Dict[str, Any]] = []
+        for edge in self.edges:
+            edge_dict = {
+                "source": stable_node_ids[edge.source],
+                "target": stable_node_ids[edge.target],
+            }
+            if edge.data is not None:
+                edge_dict["data"] = edge.data
+            if edge.conditional:
+                edge_dict["conditional"] = True
+            edges.append(edge_dict)
+
+        return {
+            "nodes": [
+                {
+                    "id": stable_node_ids[node.id],
+                    **node_data_json(node, with_schemas=with_schemas),
+                }
+                for node in self.nodes.values()
+            ],
+            "edges": edges,
+        }
+
+    def __bool__(self) -> bool:
+        return bool(self.nodes)
+
+    def next_id(self) -> str:
+        return uuid4().hex
+
+    def add_node(
+        self, data: Union[Type[BaseModel], RunnableType], id: Optional[str] = None
+    ) -> Node:
+        """Add a node to the graph and return it."""
+        if id is not None and id in self.nodes:
+            raise ValueError(f"Node with id {id} already exists")
+        node = Node(id=id or self.next_id(), data=data)
+        self.nodes[node.id] = node
+        return node
+
+    def remove_node(self, node: Node) -> None:
+        """Remove a node from the graphm and all edges connected to it."""
+        self.nodes.pop(node.id)
+        self.edges = [
+            edge
+            for edge in self.edges
+            if edge.source != node.id and edge.target != node.id
+        ]
+
+    def add_edge(
+        self,
+        source: Node,
+        target: Node,
+        data: Optional[str] = None,
+        conditional: bool = False,
+    ) -> Edge:
+        """Add an edge to the graph and return it."""
+        if source.id not in self.nodes:
+            raise ValueError(f"Source node {source.id} not in graph")
+        if target.id not in self.nodes:
+            raise ValueError(f"Target node {target.id} not in graph")
+        edge = Edge(
+            source=source.id, target=target.id, data=data, conditional=conditional
+        )
+        self.edges.append(edge)
+        return edge
+
+    def extend(self, graph: Graph) -> None:
+        """Add all nodes and edges from another graph.
+        Note this doesn't check for duplicates, nor does it connect the graphs."""
+        self.nodes.update(graph.nodes)
+        self.edges.extend(graph.edges)
+
+    def first_node(self) -> Optional[Node]:
+        """Find the single node that is not a target of any edge.
+        If there is no such node, or there are multiple, return None.
+        When drawing the graph this node would be the origin."""
+        targets = {edge.target for edge in self.edges}
+        found: List[Node] = []
+        for node in self.nodes.values():
+            if node.id not in targets:
+                found.append(node)
+        return found[0] if len(found) == 1 else None
+
+    def last_node(self) -> Optional[Node]:
+        """Find the single node that is not a source of any edge.
+        If there is no such node, or there are multiple, return None.
+        When drawing the graph this node would be the destination.
+        """
+        sources = {edge.source for edge in self.edges}
+        found: List[Node] = []
+        for node in self.nodes.values():
+            if node.id not in sources:
+                found.append(node)
+        return found[0] if len(found) == 1 else None
+
+    def trim_first_node(self) -> None:
+        """Remove the first node if it exists and has a single outgoing edge,
+        ie. if removing it would not leave the graph without a "first" node."""
+        first_node = self.first_node()
+        if first_node:
+            if (
+                len(self.nodes) == 1
+                or len([edge for edge in self.edges if edge.source == first_node.id])
+                == 1
+            ):
+                self.remove_node(first_node)
+
+    def trim_last_node(self) -> None:
+        """Remove the last node if it exists and has a single incoming edge,
+        ie. if removing it would not leave the graph without a "last" node."""
+        last_node = self.last_node()
+        if last_node:
+            if (
+                len(self.nodes) == 1
+                or len([edge for edge in self.edges if edge.target == last_node.id])
+                == 1
+            ):
+                self.remove_node(last_node)
+
+    def draw_ascii(self) -> str:
+        from langchain_core.runnables.graph_ascii import draw_ascii
+
+        return draw_ascii(
+            {node.id: node_data_str(node) for node in self.nodes.values()},
+            self.edges,
+        )
+
+    def print_ascii(self) -> None:
+        print(self.draw_ascii())  # noqa: T201
+
+    @overload
+    def draw_png(
+        self,
+        output_file_path: str,
+        fontname: Optional[str] = None,
+        labels: Optional[LabelsDict] = None,
+    ) -> None:
+        ...
+
+    @overload
+    def draw_png(
+        self,
+        output_file_path: None,
+        fontname: Optional[str] = None,
+        labels: Optional[LabelsDict] = None,
+    ) -> bytes:
+        ...
+
+    def draw_png(
+        self,
+        output_file_path: Optional[str] = None,
+        fontname: Optional[str] = None,
+        labels: Optional[LabelsDict] = None,
+    ) -> Union[bytes, None]:
+        from langchain_core.runnables.graph_png import PngDrawer
+
+        default_node_labels = {
+            node.id: node_data_str(node) for node in self.nodes.values()
+        }
+
+        return PngDrawer(
+            fontname,
+            LabelsDict(
+                nodes={
+                    **default_node_labels,
+                    **(labels["nodes"] if labels is not None else {}),
+                },
+                edges=labels["edges"] if labels is not None else {},
+            ),
+        ).draw(self, output_file_path)
+
+    def draw_mermaid(
+        self,
+        *,
+        with_styles: bool = True,
+        curve_style: CurveStyle = CurveStyle.LINEAR,
+        node_colors: NodeColors = NodeColors(
+            start="#ffdfba", end="#baffc9", other="#fad7de"
+        ),
+        wrap_label_n_words: int = 9,
+    ) -> str:
+        from langchain_core.runnables.graph_mermaid import draw_mermaid
+
+        nodes = {node.id: node_data_str(node) for node in self.nodes.values()}
+
+        first_node = self.first_node()
+        first_label = node_data_str(first_node) if first_node is not None else None
+
+        last_node = self.last_node()
+        last_label = node_data_str(last_node) if last_node is not None else None
+
+        return draw_mermaid(
+            nodes=nodes,
+            edges=self.edges,
+            first_node_label=first_label,
+            last_node_label=last_label,
+            with_styles=with_styles,
+            curve_style=curve_style,
+            node_colors=node_colors,
+            wrap_label_n_words=wrap_label_n_words,
+        )
+
+    def draw_mermaid_png(
+        self,
+        *,
+        curve_style: CurveStyle = CurveStyle.LINEAR,
+        node_colors: NodeColors = NodeColors(
+            start="#ffdfba", end="#baffc9", other="#fad7de"
+        ),
+        wrap_label_n_words: int = 9,
+        output_file_path: Optional[str] = None,
+        draw_method: MermaidDrawMethod = MermaidDrawMethod.API,
+        background_color: str = "white",
+        padding: int = 10,
+    ) -> bytes:
+        from langchain_core.runnables.graph_mermaid import draw_mermaid_png
+
+        mermaid_syntax = self.draw_mermaid(
+            curve_style=curve_style,
+            node_colors=node_colors,
+            wrap_label_n_words=wrap_label_n_words,
+        )
+        return draw_mermaid_png(
+            mermaid_syntax=mermaid_syntax,
+            output_file_path=output_file_path,
+            draw_method=draw_method,
+            background_color=background_color,
+            padding=padding,
+        )
diff --git a/llm/Lib/site-packages/langchain_core/runnables/graph_ascii.py b/llm/Lib/site-packages/langchain_core/runnables/graph_ascii.py
new file mode 100644
index 0000000000000000000000000000000000000000..089cdb992381a01569083ff578b5705ca8d5e477
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/graph_ascii.py
@@ -0,0 +1,307 @@
+"""Draws DAG in ASCII.
+Adapted from https://github.com/iterative/dvc/blob/main/dvc/dagascii.py"""
+
+import math
+import os
+from typing import Any, Mapping, Sequence
+
+from langchain_core.runnables.graph import Edge as LangEdge
+
+
+class VertexViewer:
+    """Class to define vertex box boundaries that will be accounted for during
+    graph building by grandalf.
+
+    Args:
+        name (str): name of the vertex.
+    """
+
+    HEIGHT = 3  # top and bottom box edges + text
+
+    def __init__(self, name: str) -> None:
+        self._h = self.HEIGHT  # top and bottom box edges + text
+        self._w = len(name) + 2  # right and left bottom edges + text
+
+    @property
+    def h(self) -> int:
+        """Height of the box."""
+        return self._h
+
+    @property
+    def w(self) -> int:
+        """Width of the box."""
+        return self._w
+
+
+class AsciiCanvas:
+    """Class for drawing in ASCII.
+
+    Args:
+        cols (int): number of columns in the canvas. Should be > 1.
+        lines (int): number of lines in the canvas. Should be > 1.
+    """
+
+    TIMEOUT = 10
+
+    def __init__(self, cols: int, lines: int) -> None:
+        assert cols > 1
+        assert lines > 1
+
+        self.cols = cols
+        self.lines = lines
+
+        self.canvas = [[" "] * cols for line in range(lines)]
+
+    def draw(self) -> str:
+        """Draws ASCII canvas on the screen."""
+        lines = map("".join, self.canvas)
+        return os.linesep.join(lines)
+
+    def point(self, x: int, y: int, char: str) -> None:
+        """Create a point on ASCII canvas.
+
+        Args:
+            x (int): x coordinate. Should be >= 0 and < number of columns in
+                the canvas.
+            y (int): y coordinate. Should be >= 0 an < number of lines in the
+                canvas.
+            char (str): character to place in the specified point on the
+                canvas.
+        """
+        assert len(char) == 1
+        assert x >= 0
+        assert x < self.cols
+        assert y >= 0
+        assert y < self.lines
+
+        self.canvas[y][x] = char
+
+    def line(self, x0: int, y0: int, x1: int, y1: int, char: str) -> None:
+        """Create a line on ASCII canvas.
+
+        Args:
+            x0 (int): x coordinate where the line should start.
+            y0 (int): y coordinate where the line should start.
+            x1 (int): x coordinate where the line should end.
+            y1 (int): y coordinate where the line should end.
+            char (str): character to draw the line with.
+        """
+        if x0 > x1:
+            x1, x0 = x0, x1
+            y1, y0 = y0, y1
+
+        dx = x1 - x0
+        dy = y1 - y0
+
+        if dx == 0 and dy == 0:
+            self.point(x0, y0, char)
+        elif abs(dx) >= abs(dy):
+            for x in range(x0, x1 + 1):
+                if dx == 0:
+                    y = y0
+                else:
+                    y = y0 + int(round((x - x0) * dy / float(dx)))
+                self.point(x, y, char)
+        elif y0 < y1:
+            for y in range(y0, y1 + 1):
+                if dy == 0:
+                    x = x0
+                else:
+                    x = x0 + int(round((y - y0) * dx / float(dy)))
+                self.point(x, y, char)
+        else:
+            for y in range(y1, y0 + 1):
+                if dy == 0:
+                    x = x0
+                else:
+                    x = x1 + int(round((y - y1) * dx / float(dy)))
+                self.point(x, y, char)
+
+    def text(self, x: int, y: int, text: str) -> None:
+        """Print a text on ASCII canvas.
+
+        Args:
+            x (int): x coordinate where the text should start.
+            y (int): y coordinate where the text should start.
+            text (str): string that should be printed.
+        """
+        for i, char in enumerate(text):
+            self.point(x + i, y, char)
+
+    def box(self, x0: int, y0: int, width: int, height: int) -> None:
+        """Create a box on ASCII canvas.
+
+        Args:
+            x0 (int): x coordinate of the box corner.
+            y0 (int): y coordinate of the box corner.
+            width (int): box width.
+            height (int): box height.
+        """
+        assert width > 1
+        assert height > 1
+
+        width -= 1
+        height -= 1
+
+        for x in range(x0, x0 + width):
+            self.point(x, y0, "-")
+            self.point(x, y0 + height, "-")
+
+        for y in range(y0, y0 + height):
+            self.point(x0, y, "|")
+            self.point(x0 + width, y, "|")
+
+        self.point(x0, y0, "+")
+        self.point(x0 + width, y0, "+")
+        self.point(x0, y0 + height, "+")
+        self.point(x0 + width, y0 + height, "+")
+
+
+def _build_sugiyama_layout(
+    vertices: Mapping[str, str], edges: Sequence[LangEdge]
+) -> Any:
+    try:
+        from grandalf.graphs import Edge, Graph, Vertex  # type: ignore[import]
+        from grandalf.layouts import SugiyamaLayout  # type: ignore[import]
+        from grandalf.routing import (  # type: ignore[import]
+            EdgeViewer,
+            route_with_lines,
+        )
+    except ImportError as exc:
+        raise ImportError(
+            "Install grandalf to draw graphs: `pip install grandalf`."
+        ) from exc
+
+    #
+    # Just a reminder about naming conventions:
+    # +------------X
+    # |
+    # |
+    # |
+    # |
+    # Y
+    #
+
+    vertices_ = {id: Vertex(f" {data} ") for id, data in vertices.items()}
+    edges_ = [Edge(vertices_[s], vertices_[e], data=cond) for s, e, _, cond in edges]
+    vertices_list = vertices_.values()
+    graph = Graph(vertices_list, edges_)
+
+    for vertex in vertices_list:
+        vertex.view = VertexViewer(vertex.data)
+
+    # NOTE: determine min box length to create the best layout
+    minw = min(v.view.w for v in vertices_list)
+
+    for edge in edges_:
+        edge.view = EdgeViewer()
+
+    sug = SugiyamaLayout(graph.C[0])
+    graph = graph.C[0]
+    roots = list(filter(lambda x: len(x.e_in()) == 0, graph.sV))
+
+    sug.init_all(roots=roots, optimize=True)
+
+    sug.yspace = VertexViewer.HEIGHT
+    sug.xspace = minw
+    sug.route_edge = route_with_lines
+
+    sug.draw()
+
+    return sug
+
+
+def draw_ascii(vertices: Mapping[str, str], edges: Sequence[LangEdge]) -> str:
+    """Build a DAG and draw it in ASCII.
+
+    Args:
+        vertices (list): list of graph vertices.
+        edges (list): list of graph edges.
+
+    Returns:
+        str: ASCII representation
+
+    Example:
+        >>> vertices = [1, 2, 3, 4]
+        >>> edges = [(1, 2), (2, 3), (2, 4), (1, 4)]
+        >>> print(draw(vertices, edges))
+        +---+     +---+
+        | 3 |     | 4 |
+        +---+    *+---+
+          *    **   *
+          *  **     *
+          * *       *
+        +---+       *
+        | 2 |      *
+        +---+     *
+             *    *
+              *  *
+               **
+             +---+
+             | 1 |
+             +---+
+    """
+
+    # NOTE: coordinates might me negative, so we need to shift
+    # everything to the positive plane before we actually draw it.
+    Xs = []  # noqa: N806
+    Ys = []  # noqa: N806
+
+    sug = _build_sugiyama_layout(vertices, edges)
+
+    for vertex in sug.g.sV:
+        # NOTE: moving boxes w/2 to the left
+        Xs.append(vertex.view.xy[0] - vertex.view.w / 2.0)
+        Xs.append(vertex.view.xy[0] + vertex.view.w / 2.0)
+        Ys.append(vertex.view.xy[1])
+        Ys.append(vertex.view.xy[1] + vertex.view.h)
+
+    for edge in sug.g.sE:
+        for x, y in edge.view._pts:
+            Xs.append(x)
+            Ys.append(y)
+
+    minx = min(Xs)
+    miny = min(Ys)
+    maxx = max(Xs)
+    maxy = max(Ys)
+
+    canvas_cols = int(math.ceil(math.ceil(maxx) - math.floor(minx))) + 1
+    canvas_lines = int(round(maxy - miny))
+
+    canvas = AsciiCanvas(canvas_cols, canvas_lines)
+
+    # NOTE: first draw edges so that node boxes could overwrite them
+    for edge in sug.g.sE:
+        assert len(edge.view._pts) > 1
+        for index in range(1, len(edge.view._pts)):
+            start = edge.view._pts[index - 1]
+            end = edge.view._pts[index]
+
+            start_x = int(round(start[0] - minx))
+            start_y = int(round(start[1] - miny))
+            end_x = int(round(end[0] - minx))
+            end_y = int(round(end[1] - miny))
+
+            assert start_x >= 0
+            assert start_y >= 0
+            assert end_x >= 0
+            assert end_y >= 0
+
+            canvas.line(start_x, start_y, end_x, end_y, "." if edge.data else "*")
+
+    for vertex in sug.g.sV:
+        # NOTE: moving boxes w/2 to the left
+        x = vertex.view.xy[0] - vertex.view.w / 2.0
+        y = vertex.view.xy[1]
+
+        canvas.box(
+            int(round(x - minx)),
+            int(round(y - miny)),
+            vertex.view.w,
+            vertex.view.h,
+        )
+
+        canvas.text(int(round(x - minx)) + 1, int(round(y - miny)) + 1, vertex.data)
+
+    return canvas.draw()
diff --git a/llm/Lib/site-packages/langchain_core/runnables/graph_mermaid.py b/llm/Lib/site-packages/langchain_core/runnables/graph_mermaid.py
new file mode 100644
index 0000000000000000000000000000000000000000..93e052d8919dbb7c8b74157a91687dc113acd986
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/graph_mermaid.py
@@ -0,0 +1,273 @@
+import base64
+import re
+from dataclasses import asdict
+from typing import Dict, List, Optional, Tuple
+
+from langchain_core.runnables.graph import (
+    CurveStyle,
+    Edge,
+    MermaidDrawMethod,
+    NodeColors,
+)
+
+
+def draw_mermaid(
+    nodes: Dict[str, str],
+    edges: List[Edge],
+    *,
+    first_node_label: Optional[str] = None,
+    last_node_label: Optional[str] = None,
+    with_styles: bool = True,
+    curve_style: CurveStyle = CurveStyle.LINEAR,
+    node_colors: NodeColors = NodeColors(),
+    wrap_label_n_words: int = 9,
+) -> str:
+    """Draws a Mermaid graph using the provided graph data
+
+    Args:
+        nodes (dict[str, str]): List of node ids
+        edges (List[Edge]): List of edges, object with source,
+        target and data.
+        curve_style (CurveStyle, optional): Curve style for the edges.
+        node_colors (NodeColors, optional): Node colors for different types.
+        wrap_label_n_words (int, optional): Words to wrap the edge labels.
+
+    Returns:
+        str: Mermaid graph syntax
+    """
+    # Initialize Mermaid graph configuration
+    mermaid_graph = (
+        (
+            f"%%{{init: {{'flowchart': {{'curve': '{curve_style.value}'"
+            f"}}}}}}%%\ngraph TD;\n"
+        )
+        if with_styles
+        else "graph TD;\n"
+    )
+
+    if with_styles:
+        # Node formatting templates
+        default_class_label = "default"
+        format_dict = {default_class_label: "{0}([{0}]):::otherclass"}
+        if first_node_label is not None:
+            format_dict[first_node_label] = "{0}[{0}]:::startclass"
+        if last_node_label is not None:
+            format_dict[last_node_label] = "{0}[{0}]:::endclass"
+
+        # Add nodes to the graph
+        for node in nodes.values():
+            node_label = format_dict.get(node, format_dict[default_class_label]).format(
+                _escape_node_label(node)
+            )
+            mermaid_graph += f"\t{node_label};\n"
+
+    # Add edges to the graph
+    for edge in edges:
+        adjusted_edge = _adjust_mermaid_edge(edge=edge, nodes=nodes)
+        if (
+            adjusted_edge is None
+        ):  # Ignore if it is connection between source and intermediate node
+            continue
+
+        source, target = adjusted_edge
+
+        # Add BR every wrap_label_n_words words
+        if edge.data is not None:
+            edge_data = edge.data
+            words = edge_data.split()  # Split the string into words
+            # Group words into chunks of wrap_label_n_words size
+            if len(words) > wrap_label_n_words:
+                edge_data = "<br>".join(
+                    [
+                        " ".join(words[i : i + wrap_label_n_words])
+                        for i in range(0, len(words), wrap_label_n_words)
+                    ]
+                )
+            if edge.conditional:
+                edge_label = f" -. {edge_data} .-> "
+            else:
+                edge_label = f" -- {edge_data} --> "
+        else:
+            if edge.conditional:
+                edge_label = " -.-> "
+            else:
+                edge_label = " --> "
+        mermaid_graph += (
+            f"\t{_escape_node_label(source)}{edge_label}"
+            f"{_escape_node_label(target)};\n"
+        )
+
+    # Add custom styles for nodes
+    if with_styles:
+        mermaid_graph += _generate_mermaid_graph_styles(node_colors)
+    return mermaid_graph
+
+
+def _escape_node_label(node_label: str) -> str:
+    """Escapes the node label for Mermaid syntax."""
+    return re.sub(r"[^a-zA-Z-_]", "_", node_label)
+
+
+def _adjust_mermaid_edge(
+    edge: Edge,
+    nodes: Dict[str, str],
+) -> Optional[Tuple[str, str]]:
+    """Adjusts Mermaid edge to map conditional nodes to pure nodes."""
+    source_node_label = nodes.get(edge.source, edge.source)
+    target_node_label = nodes.get(edge.target, edge.target)
+
+    return source_node_label, target_node_label
+
+
+def _generate_mermaid_graph_styles(node_colors: NodeColors) -> str:
+    """Generates Mermaid graph styles for different node types."""
+    styles = ""
+    for class_name, color in asdict(node_colors).items():
+        styles += f"\tclassDef {class_name}class fill:{color};\n"
+    return styles
+
+
+def draw_mermaid_png(
+    mermaid_syntax: str,
+    output_file_path: Optional[str] = None,
+    draw_method: MermaidDrawMethod = MermaidDrawMethod.API,
+    background_color: Optional[str] = "white",
+    padding: int = 10,
+) -> bytes:
+    """Draws a Mermaid graph as PNG using provided syntax."""
+    if draw_method == MermaidDrawMethod.PYPPETEER:
+        import asyncio
+
+        img_bytes = asyncio.run(
+            _render_mermaid_using_pyppeteer(
+                mermaid_syntax, output_file_path, background_color, padding
+            )
+        )
+    elif draw_method == MermaidDrawMethod.API:
+        img_bytes = _render_mermaid_using_api(
+            mermaid_syntax, output_file_path, background_color
+        )
+    else:
+        supported_methods = ", ".join([m.value for m in MermaidDrawMethod])
+        raise ValueError(
+            f"Invalid draw method: {draw_method}. "
+            f"Supported draw methods are: {supported_methods}"
+        )
+
+    return img_bytes
+
+
+async def _render_mermaid_using_pyppeteer(
+    mermaid_syntax: str,
+    output_file_path: Optional[str] = None,
+    background_color: Optional[str] = "white",
+    padding: int = 10,
+    device_scale_factor: int = 3,
+) -> bytes:
+    """Renders Mermaid graph using Pyppeteer."""
+    try:
+        from pyppeteer import launch  # type: ignore[import]
+    except ImportError as e:
+        raise ImportError(
+            "Install Pyppeteer to use the Pyppeteer method: `pip install pyppeteer`."
+        ) from e
+
+    browser = await launch()
+    page = await browser.newPage()
+
+    # Setup Mermaid JS
+    await page.goto("about:blank")
+    await page.addScriptTag(
+        {"url": "https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"}
+    )
+    await page.evaluate(
+        """() => {
+                mermaid.initialize({startOnLoad:true});
+            }"""
+    )
+
+    # Render SVG
+    svg_code = await page.evaluate(
+        """(mermaidGraph) => {
+                return mermaid.mermaidAPI.render('mermaid', mermaidGraph);
+            }""",
+        mermaid_syntax,
+    )
+
+    # Set the page background to white
+    await page.evaluate(
+        """(svg, background_color) => {
+            document.body.innerHTML = svg;
+            document.body.style.background = background_color;
+        }""",
+        svg_code["svg"],
+        background_color,
+    )
+
+    # Take a screenshot
+    dimensions = await page.evaluate(
+        """() => {
+            const svgElement = document.querySelector('svg');
+            const rect = svgElement.getBoundingClientRect();
+            return { width: rect.width, height: rect.height };
+        }"""
+    )
+    await page.setViewport(
+        {
+            "width": int(dimensions["width"] + padding),
+            "height": int(dimensions["height"] + padding),
+            "deviceScaleFactor": device_scale_factor,
+        }
+    )
+
+    img_bytes = await page.screenshot({"fullPage": False})
+    await browser.close()
+
+    if output_file_path is not None:
+        with open(output_file_path, "wb") as file:
+            file.write(img_bytes)
+
+    return img_bytes
+
+
+def _render_mermaid_using_api(
+    mermaid_syntax: str,
+    output_file_path: Optional[str] = None,
+    background_color: Optional[str] = "white",
+) -> bytes:
+    """Renders Mermaid graph using the Mermaid.INK API."""
+    try:
+        import requests  # type: ignore[import]
+    except ImportError as e:
+        raise ImportError(
+            "Install the `requests` module to use the Mermaid.INK API: "
+            "`pip install requests`."
+        ) from e
+
+    # Use Mermaid API to render the image
+    mermaid_syntax_encoded = base64.b64encode(mermaid_syntax.encode("utf8")).decode(
+        "ascii"
+    )
+
+    # Check if the background color is a hexadecimal color code using regex
+    if background_color is not None:
+        hex_color_pattern = re.compile(r"^#(?:[0-9a-fA-F]{3}){1,2}$")
+        if not hex_color_pattern.match(background_color):
+            background_color = f"!{background_color}"
+
+    image_url = (
+        f"https://mermaid.ink/img/{mermaid_syntax_encoded}?bgColor={background_color}"
+    )
+    response = requests.get(image_url)
+    if response.status_code == 200:
+        img_bytes = response.content
+        if output_file_path is not None:
+            with open(output_file_path, "wb") as file:
+                file.write(response.content)
+
+        return img_bytes
+    else:
+        raise ValueError(
+            f"Failed to render the graph using the Mermaid.INK API. "
+            f"Status code: {response.status_code}."
+        )
diff --git a/llm/Lib/site-packages/langchain_core/runnables/graph_png.py b/llm/Lib/site-packages/langchain_core/runnables/graph_png.py
new file mode 100644
index 0000000000000000000000000000000000000000..9116fc81f9bdb74d272600b53f2e1ea7d90402c5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/graph_png.py
@@ -0,0 +1,114 @@
+from typing import Any, Optional
+
+from langchain_core.runnables.graph import Graph, LabelsDict
+
+
+class PngDrawer:
+    """
+    A helper class to draw a state graph into a PNG file.
+    Requires graphviz and pygraphviz to be installed.
+    :param fontname: The font to use for the labels
+    :param labels: A dictionary of label overrides. The dictionary
+        should have the following format:
+        {
+            "nodes": {
+                "node1": "CustomLabel1",
+                "node2": "CustomLabel2",
+                "__end__": "End Node"
+            },
+            "edges": {
+                "continue": "ContinueLabel",
+                "end": "EndLabel"
+            }
+        }
+        The keys are the original labels, and the values are the new labels.
+    Usage:
+        drawer = PngDrawer()
+        drawer.draw(state_graph, 'graph.png')
+    """
+
+    def __init__(
+        self, fontname: Optional[str] = None, labels: Optional[LabelsDict] = None
+    ) -> None:
+        self.fontname = fontname or "arial"
+        self.labels = labels or LabelsDict(nodes={}, edges={})
+
+    def get_node_label(self, label: str) -> str:
+        label = self.labels.get("nodes", {}).get(label, label)
+        return f"<<B>{label}</B>>"
+
+    def get_edge_label(self, label: str) -> str:
+        label = self.labels.get("edges", {}).get(label, label)
+        return f"<<U>{label}</U>>"
+
+    def add_node(self, viz: Any, node: str) -> None:
+        viz.add_node(
+            node,
+            label=self.get_node_label(node),
+            style="filled",
+            fillcolor="yellow",
+            fontsize=15,
+            fontname=self.fontname,
+        )
+
+    def add_edge(
+        self,
+        viz: Any,
+        source: str,
+        target: str,
+        label: Optional[str] = None,
+        conditional: bool = False,
+    ) -> None:
+        viz.add_edge(
+            source,
+            target,
+            label=self.get_edge_label(label) if label else "",
+            fontsize=12,
+            fontname=self.fontname,
+            style="dotted" if conditional else "solid",
+        )
+
+    def draw(self, graph: Graph, output_path: Optional[str] = None) -> Optional[bytes]:
+        """
+        Draws the given state graph into a PNG file.
+        Requires graphviz and pygraphviz to be installed.
+        :param graph: The graph to draw
+        :param output_path: The path to save the PNG. If None, PNG bytes are returned.
+        """
+
+        try:
+            import pygraphviz as pgv  # type: ignore[import]
+        except ImportError as exc:
+            raise ImportError(
+                "Install pygraphviz to draw graphs: `pip install pygraphviz`."
+            ) from exc
+
+        # Create a directed graph
+        viz = pgv.AGraph(directed=True, nodesep=0.9, ranksep=1.0)
+
+        # Add nodes, conditional edges, and edges to the graph
+        self.add_nodes(viz, graph)
+        self.add_edges(viz, graph)
+
+        # Update entrypoint and END styles
+        self.update_styles(viz, graph)
+
+        # Save the graph as PNG
+        try:
+            return viz.draw(output_path, format="png", prog="dot")
+        finally:
+            viz.close()
+
+    def add_nodes(self, viz: Any, graph: Graph) -> None:
+        for node in graph.nodes:
+            self.add_node(viz, node)
+
+    def add_edges(self, viz: Any, graph: Graph) -> None:
+        for start, end, label, cond in graph.edges:
+            self.add_edge(viz, start, end, label, cond)
+
+    def update_styles(self, viz: Any, graph: Graph) -> None:
+        if first := graph.first_node():
+            viz.get_node(first.id).attr.update(fillcolor="lightblue")
+        if last := graph.last_node():
+            viz.get_node(last.id).attr.update(fillcolor="orange")
diff --git a/llm/Lib/site-packages/langchain_core/runnables/history.py b/llm/Lib/site-packages/langchain_core/runnables/history.py
new file mode 100644
index 0000000000000000000000000000000000000000..f02364bccde1dbeb0da40de2267dfdd80e7d4005
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/history.py
@@ -0,0 +1,493 @@
+from __future__ import annotations
+
+import inspect
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    List,
+    Optional,
+    Sequence,
+    Type,
+    Union,
+)
+
+from langchain_core.chat_history import BaseChatMessageHistory
+from langchain_core.load.load import load
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.runnables.base import Runnable, RunnableBindingBase, RunnableLambda
+from langchain_core.runnables.passthrough import RunnablePassthrough
+from langchain_core.runnables.utils import (
+    ConfigurableFieldSpec,
+    create_model,
+    get_unique_config_specs,
+)
+
+if TYPE_CHECKING:
+    from langchain_core.messages import BaseMessage
+    from langchain_core.runnables.config import RunnableConfig
+    from langchain_core.tracers.schemas import Run
+
+
+MessagesOrDictWithMessages = Union[Sequence["BaseMessage"], Dict[str, Any]]
+GetSessionHistoryCallable = Callable[..., BaseChatMessageHistory]
+
+
+class RunnableWithMessageHistory(RunnableBindingBase):
+    """Runnable that manages chat message history for another Runnable.
+
+    A chat message history is a sequence of messages that represent a conversation.
+
+    RunnableWithMessageHistory wraps another Runnable and manages the chat message
+    history for it; it is responsible for reading and updating the chat message
+    history.
+
+    The formats supports for the inputs and outputs of the wrapped Runnable
+    are described below.
+
+    RunnableWithMessageHistory must always be called with a config that contains
+    the appropriate parameters for the chat message history factory.
+
+    By default the Runnable is expected to take a single configuration parameter
+    called `session_id` which is a string. This parameter is used to create a new
+    or look up an existing chat message history that matches the given session_id.
+
+    In this case, the invocation would look like this:
+
+    `with_history.invoke(..., config={"configurable": {"session_id": "bar"}})`
+    ; e.g., ``{"configurable": {"session_id": "<SESSION_ID>"}}``.
+
+    The configuration can be customized by passing in a list of
+    ``ConfigurableFieldSpec`` objects to the ``history_factory_config`` parameter (see
+    example below).
+
+    In the examples, we will use a chat message history with an in-memory
+    implementation to make it easy to experiment and see the results.
+
+    For production use cases, you will want to use a persistent implementation
+    of chat message history, such as ``RedisChatMessageHistory``.
+
+
+    Example: Chat message history with an in-memory implementation for testing.
+
+    .. code-block:: python
+
+        from operator import itemgetter
+        from typing import List
+
+        from langchain_openai.chat_models import ChatOpenAI
+
+        from langchain_core.chat_history import BaseChatMessageHistory
+        from langchain_core.documents import Document
+        from langchain_core.messages import BaseMessage, AIMessage
+        from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder
+        from langchain_core.pydantic_v1 import BaseModel, Field
+        from langchain_core.runnables import (
+            RunnableLambda,
+            ConfigurableFieldSpec,
+            RunnablePassthrough,
+        )
+        from langchain_core.runnables.history import RunnableWithMessageHistory
+
+
+        class InMemoryHistory(BaseChatMessageHistory, BaseModel):
+            \"\"\"In memory implementation of chat message history.\"\"\"
+
+            messages: List[BaseMessage] = Field(default_factory=list)
+
+            def add_messages(self, messages: List[BaseMessage]) -> None:
+                \"\"\"Add a list of messages to the store\"\"\"
+                self.messages.extend(messages)
+
+            def clear(self) -> None:
+                self.messages = []
+
+        # Here we use a global variable to store the chat message history.
+        # This will make it easier to inspect it to see the underlying results.
+        store = {}
+
+        def get_by_session_id(session_id: str) -> BaseChatMessageHistory:
+            if session_id not in store:
+                store[session_id] = InMemoryHistory()
+            return store[session_id]
+
+
+        history = get_by_session_id("1")
+        history.add_message(AIMessage(content="hello"))
+        print(store)  # noqa: T201
+
+
+    Example where the wrapped Runnable takes a dictionary input:
+
+        .. code-block:: python
+
+            from typing import Optional
+
+            from langchain_community.chat_models import ChatAnthropic
+            from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder
+            from langchain_core.runnables.history import RunnableWithMessageHistory
+
+
+            prompt = ChatPromptTemplate.from_messages([
+                ("system", "You're an assistant who's good at {ability}"),
+                MessagesPlaceholder(variable_name="history"),
+                ("human", "{question}"),
+            ])
+
+            chain = prompt | ChatAnthropic(model="claude-2")
+
+            chain_with_history = RunnableWithMessageHistory(
+                chain,
+                # Uses the get_by_session_id function defined in the example
+                # above.
+                get_by_session_id,
+                input_messages_key="question",
+                history_messages_key="history",
+            )
+
+            print(chain_with_history.invoke(  # noqa: T201
+                {"ability": "math", "question": "What does cosine mean?"},
+                config={"configurable": {"session_id": "foo"}}
+            ))
+
+            # Uses the store defined in the example above.
+            print(store)  # noqa: T201
+
+            print(chain_with_history.invoke(  # noqa: T201
+                {"ability": "math", "question": "What's its inverse"},
+                config={"configurable": {"session_id": "foo"}}
+            ))
+
+            print(store)  # noqa: T201
+
+
+    Example where the session factory takes two keys, user_id and conversation id):
+
+        .. code-block:: python
+
+            store = {}
+
+            def get_session_history(
+                user_id: str, conversation_id: str
+            ) -> BaseChatMessageHistory:
+                if (user_id, conversation_id) not in store:
+                    store[(user_id, conversation_id)] = InMemoryHistory()
+                return store[(user_id, conversation_id)]
+
+            prompt = ChatPromptTemplate.from_messages([
+                ("system", "You're an assistant who's good at {ability}"),
+                MessagesPlaceholder(variable_name="history"),
+                ("human", "{question}"),
+            ])
+
+            chain = prompt | ChatAnthropic(model="claude-2")
+
+            with_message_history = RunnableWithMessageHistory(
+                chain,
+                get_session_history=get_session_history,
+                input_messages_key="question",
+                history_messages_key="history",
+                history_factory_config=[
+                    ConfigurableFieldSpec(
+                        id="user_id",
+                        annotation=str,
+                        name="User ID",
+                        description="Unique identifier for the user.",
+                        default="",
+                        is_shared=True,
+                    ),
+                    ConfigurableFieldSpec(
+                        id="conversation_id",
+                        annotation=str,
+                        name="Conversation ID",
+                        description="Unique identifier for the conversation.",
+                        default="",
+                        is_shared=True,
+                    ),
+                ],
+            )
+
+            with_message_history.invoke(
+                {"ability": "math", "question": "What does cosine mean?"},
+                config={"configurable": {"user_id": "123", "conversation_id": "1"}}
+            )
+
+    """  # noqa: E501
+
+    get_session_history: GetSessionHistoryCallable
+    input_messages_key: Optional[str] = None
+    output_messages_key: Optional[str] = None
+    history_messages_key: Optional[str] = None
+    history_factory_config: Sequence[ConfigurableFieldSpec]
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    def __init__(
+        self,
+        runnable: Runnable[
+            MessagesOrDictWithMessages,
+            Union[str, BaseMessage, MessagesOrDictWithMessages],
+        ],
+        get_session_history: GetSessionHistoryCallable,
+        *,
+        input_messages_key: Optional[str] = None,
+        output_messages_key: Optional[str] = None,
+        history_messages_key: Optional[str] = None,
+        history_factory_config: Optional[Sequence[ConfigurableFieldSpec]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Initialize RunnableWithMessageHistory.
+
+        Args:
+            runnable: The base Runnable to be wrapped. Must take as input one of:
+                1. A sequence of BaseMessages
+                2. A dict with one key for all messages
+                3. A dict with one key for the current input string/message(s) and
+                    a separate key for historical messages. If the input key points
+                    to a string, it will be treated as a HumanMessage in history.
+
+                Must return as output one of:
+                1. A string which can be treated as an AIMessage
+                2. A BaseMessage or sequence of BaseMessages
+                3. A dict with a key for a BaseMessage or sequence of BaseMessages
+
+            get_session_history: Function that returns a new BaseChatMessageHistory.
+                This function should either take a single positional argument
+                `session_id` of type string and return a corresponding
+                chat message history instance.
+                .. code-block:: python
+
+                    def get_session_history(
+                        session_id: str,
+                        *,
+                        user_id: Optional[str]=None
+                    ) -> BaseChatMessageHistory:
+                      ...
+
+                Or it should take keyword arguments that match the keys of
+                `session_history_config_specs` and return a corresponding
+                chat message history instance.
+
+                .. code-block:: python
+
+                    def get_session_history(
+                        *,
+                        user_id: str,
+                        thread_id: str,
+                    ) -> BaseChatMessageHistory:
+                        ...
+
+            input_messages_key: Must be specified if the base runnable accepts a dict
+                as input.
+            output_messages_key: Must be specified if the base runnable returns a dict
+                as output.
+            history_messages_key: Must be specified if the base runnable accepts a dict
+                as input and expects a separate key for historical messages.
+            history_factory_config: Configure fields that should be passed to the
+                chat history factory. See ``ConfigurableFieldSpec`` for more details.
+                Specifying these allows you to pass multiple config keys
+                into the get_session_history factory.
+            **kwargs: Arbitrary additional kwargs to pass to parent class
+                ``RunnableBindingBase`` init.
+        """  # noqa: E501
+        history_chain: Runnable = RunnableLambda(
+            self._enter_history, self._aenter_history
+        ).with_config(run_name="load_history")
+        messages_key = history_messages_key or input_messages_key
+        if messages_key:
+            history_chain = RunnablePassthrough.assign(
+                **{messages_key: history_chain}
+            ).with_config(run_name="insert_history")
+        bound = (
+            history_chain | runnable.with_listeners(on_end=self._exit_history)
+        ).with_config(run_name="RunnableWithMessageHistory")
+
+        if history_factory_config:
+            _config_specs = history_factory_config
+        else:
+            # If not provided, then we'll use the default session_id field
+            _config_specs = [
+                ConfigurableFieldSpec(
+                    id="session_id",
+                    annotation=str,
+                    name="Session ID",
+                    description="Unique identifier for a session.",
+                    default="",
+                    is_shared=True,
+                ),
+            ]
+
+        super().__init__(
+            get_session_history=get_session_history,
+            input_messages_key=input_messages_key,
+            output_messages_key=output_messages_key,
+            bound=bound,
+            history_messages_key=history_messages_key,
+            history_factory_config=_config_specs,
+            **kwargs,
+        )
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        return get_unique_config_specs(
+            super().config_specs + list(self.history_factory_config)
+        )
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        super_schema = super().get_input_schema(config)
+        if super_schema.__custom_root_type__ or not super_schema.schema().get(
+            "properties"
+        ):
+            from langchain_core.messages import BaseMessage
+
+            fields: Dict = {}
+            if self.input_messages_key and self.history_messages_key:
+                fields[self.input_messages_key] = (
+                    Union[str, BaseMessage, Sequence[BaseMessage]],
+                    ...,
+                )
+            elif self.input_messages_key:
+                fields[self.input_messages_key] = (Sequence[BaseMessage], ...)
+            else:
+                fields["__root__"] = (Sequence[BaseMessage], ...)
+            return create_model(  # type: ignore[call-overload]
+                "RunnableWithChatHistoryInput",
+                **fields,
+            )
+        else:
+            return super_schema
+
+    def _get_input_messages(
+        self, input_val: Union[str, BaseMessage, Sequence[BaseMessage]]
+    ) -> List[BaseMessage]:
+        from langchain_core.messages import BaseMessage
+
+        if isinstance(input_val, str):
+            from langchain_core.messages import HumanMessage
+
+            return [HumanMessage(content=input_val)]
+        elif isinstance(input_val, BaseMessage):
+            return [input_val]
+        elif isinstance(input_val, (list, tuple)):
+            return list(input_val)
+        else:
+            raise ValueError(
+                f"Expected str, BaseMessage, List[BaseMessage], or Tuple[BaseMessage]. "
+                f"Got {input_val}."
+            )
+
+    def _get_output_messages(
+        self, output_val: Union[str, BaseMessage, Sequence[BaseMessage], dict]
+    ) -> List[BaseMessage]:
+        from langchain_core.messages import BaseMessage
+
+        if isinstance(output_val, dict):
+            output_val = output_val[self.output_messages_key or "output"]
+
+        if isinstance(output_val, str):
+            from langchain_core.messages import AIMessage
+
+            return [AIMessage(content=output_val)]
+        elif isinstance(output_val, BaseMessage):
+            return [output_val]
+        elif isinstance(output_val, (list, tuple)):
+            return list(output_val)
+        else:
+            raise ValueError()
+
+    def _enter_history(self, input: Any, config: RunnableConfig) -> List[BaseMessage]:
+        hist: BaseChatMessageHistory = config["configurable"]["message_history"]
+        messages = hist.messages.copy()
+
+        if not self.history_messages_key:
+            # return all messages
+            input_val = (
+                input if not self.input_messages_key else input[self.input_messages_key]
+            )
+            messages += self._get_input_messages(input_val)
+        return messages
+
+    async def _aenter_history(
+        self, input: Dict[str, Any], config: RunnableConfig
+    ) -> List[BaseMessage]:
+        hist: BaseChatMessageHistory = config["configurable"]["message_history"]
+        messages = (await hist.aget_messages()).copy()
+
+        if not self.history_messages_key:
+            # return all messages
+            input_val = (
+                input if not self.input_messages_key else input[self.input_messages_key]
+            )
+            messages += self._get_input_messages(input_val)
+        return messages
+
+    def _exit_history(self, run: Run, config: RunnableConfig) -> None:
+        hist: BaseChatMessageHistory = config["configurable"]["message_history"]
+
+        # Get the input messages
+        inputs = load(run.inputs)
+        input_val = inputs[self.input_messages_key or "input"]
+        input_messages = self._get_input_messages(input_val)
+
+        # If historic messages were prepended to the input messages, remove them to
+        # avoid adding duplicate messages to history.
+        if not self.history_messages_key:
+            historic_messages = config["configurable"]["message_history"].messages
+            input_messages = input_messages[len(historic_messages) :]
+
+        # Get the output messages
+        output_val = load(run.outputs)
+        output_messages = self._get_output_messages(output_val)
+        hist.add_messages(input_messages + output_messages)
+
+    def _merge_configs(self, *configs: Optional[RunnableConfig]) -> RunnableConfig:
+        config = super()._merge_configs(*configs)
+        expected_keys = [field_spec.id for field_spec in self.history_factory_config]
+
+        configurable = config.get("configurable", {})
+
+        missing_keys = set(expected_keys) - set(configurable.keys())
+
+        if missing_keys:
+            example_input = {self.input_messages_key: "foo"}
+            example_configurable = {
+                missing_key: "[your-value-here]" for missing_key in missing_keys
+            }
+            example_config = {"configurable": example_configurable}
+            raise ValueError(
+                f"Missing keys {sorted(missing_keys)} in config['configurable'] "
+                f"Expected keys are {sorted(expected_keys)}."
+                f"When using via .invoke() or .stream(), pass in a config; "
+                f"e.g., chain.invoke({example_input}, {example_config})"
+            )
+
+        parameter_names = _get_parameter_names(self.get_session_history)
+
+        if len(expected_keys) == 1:
+            # If arity = 1, then invoke function by positional arguments
+            message_history = self.get_session_history(configurable[expected_keys[0]])
+        else:
+            # otherwise verify that names of keys patch and invoke by named arguments
+            if set(expected_keys) != set(parameter_names):
+                raise ValueError(
+                    f"Expected keys {sorted(expected_keys)} do not match parameter "
+                    f"names {sorted(parameter_names)} of get_session_history."
+                )
+
+            message_history = self.get_session_history(
+                **{key: configurable[key] for key in expected_keys}
+            )
+        config["configurable"]["message_history"] = message_history
+        return config
+
+
+def _get_parameter_names(callable_: GetSessionHistoryCallable) -> List[str]:
+    """Get the parameter names of the callable."""
+    sig = inspect.signature(callable_)
+    return list(sig.parameters.keys())
diff --git a/llm/Lib/site-packages/langchain_core/runnables/learnable.py b/llm/Lib/site-packages/langchain_core/runnables/learnable.py
new file mode 100644
index 0000000000000000000000000000000000000000..f56815858bc9510883a8acfc561b25d90207baef
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/learnable.py
@@ -0,0 +1,15 @@
+# from langchain_core.runnables.base import RunnableBinding
+
+
+# class RunnableLearnable(RunnableBinding):
+#     def __init__(self, *args, **kwargs):
+#         super().__init__(*args, **kwargs)
+#         self.parameters = []
+
+#     def backward(self):
+#         for param in self.parameters:
+#             param.backward()
+
+#     def update(self, optimizer):
+#         for param in self.parameters:
+#             optimizer.update(param)
diff --git a/llm/Lib/site-packages/langchain_core/runnables/passthrough.py b/llm/Lib/site-packages/langchain_core/runnables/passthrough.py
new file mode 100644
index 0000000000000000000000000000000000000000..d2fbf30e4b9c87f85adb5ae16b550c1119bb02b1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/passthrough.py
@@ -0,0 +1,763 @@
+"""Implementation of the RunnablePassthrough."""
+
+from __future__ import annotations
+
+import asyncio
+import inspect
+import threading
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Awaitable,
+    Callable,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Type,
+    Union,
+    cast,
+)
+
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.runnables.base import (
+    Other,
+    Runnable,
+    RunnableParallel,
+    RunnableSerializable,
+)
+from langchain_core.runnables.config import (
+    RunnableConfig,
+    acall_func_with_variable_args,
+    call_func_with_variable_args,
+    ensure_config,
+    get_executor_for_config,
+    patch_config,
+)
+from langchain_core.runnables.graph import Graph
+from langchain_core.runnables.utils import (
+    AddableDict,
+    ConfigurableFieldSpec,
+    adapt_first_streaming_chunk,
+    create_model,
+)
+from langchain_core.utils.aiter import atee, py_anext
+from langchain_core.utils.iter import safetee
+
+if TYPE_CHECKING:
+    from langchain_core.callbacks.manager import (
+        AsyncCallbackManagerForChainRun,
+        CallbackManagerForChainRun,
+    )
+
+
+def identity(x: Other) -> Other:
+    """Identity function"""
+    return x
+
+
+async def aidentity(x: Other) -> Other:
+    """Async identity function"""
+    return x
+
+
+class RunnablePassthrough(RunnableSerializable[Other, Other]):
+    """Runnable to passthrough inputs unchanged or with additional keys.
+
+    This runnable behaves almost like the identity function, except that it
+    can be configured to add additional keys to the output, if the input is a
+    dict.
+
+    The examples below demonstrate this Runnable works using a few simple
+    chains. The chains rely on simple lambdas to make the examples easy to execute
+    and experiment with.
+
+    Examples:
+
+        .. code-block:: python
+
+            from langchain_core.runnables import (
+                RunnableLambda,
+                RunnableParallel,
+                RunnablePassthrough,
+            )
+
+            runnable = RunnableParallel(
+                origin=RunnablePassthrough(),
+                modified=lambda x: x+1
+            )
+
+            runnable.invoke(1) # {'origin': 1, 'modified': 2}
+
+
+            def fake_llm(prompt: str) -> str: # Fake LLM for the example
+                return "completion"
+
+            chain = RunnableLambda(fake_llm) | {
+                'original': RunnablePassthrough(), # Original LLM output
+                'parsed': lambda text: text[::-1] # Parsing logic
+            }
+
+            chain.invoke('hello') # {'original': 'completion', 'parsed': 'noitelpmoc'}
+
+    In some cases, it may be useful to pass the input through while adding some
+    keys to the output. In this case, you can use the `assign` method:
+
+        .. code-block:: python
+
+            from langchain_core.runnables import RunnablePassthrough
+
+            def fake_llm(prompt: str) -> str: # Fake LLM for the example
+                return "completion"
+
+            runnable = {
+                'llm1':  fake_llm,
+                'llm2':  fake_llm,
+            } | RunnablePassthrough.assign(
+                total_chars=lambda inputs: len(inputs['llm1'] + inputs['llm2'])
+            )
+
+            runnable.invoke('hello')
+            # {'llm1': 'completion', 'llm2': 'completion', 'total_chars': 20}
+    """
+
+    input_type: Optional[Type[Other]] = None
+
+    func: Optional[
+        Union[Callable[[Other], None], Callable[[Other, RunnableConfig], None]]
+    ] = None
+
+    afunc: Optional[
+        Union[
+            Callable[[Other], Awaitable[None]],
+            Callable[[Other, RunnableConfig], Awaitable[None]],
+        ]
+    ] = None
+
+    def __repr_args__(self) -> Any:
+        # Without this repr(self) raises a RecursionError
+        # See https://github.com/pydantic/pydantic/issues/7327
+        return []
+
+    def __init__(
+        self,
+        func: Optional[
+            Union[
+                Union[Callable[[Other], None], Callable[[Other, RunnableConfig], None]],
+                Union[
+                    Callable[[Other], Awaitable[None]],
+                    Callable[[Other, RunnableConfig], Awaitable[None]],
+                ],
+            ]
+        ] = None,
+        afunc: Optional[
+            Union[
+                Callable[[Other], Awaitable[None]],
+                Callable[[Other, RunnableConfig], Awaitable[None]],
+            ]
+        ] = None,
+        *,
+        input_type: Optional[Type[Other]] = None,
+        **kwargs: Any,
+    ) -> None:
+        if inspect.iscoroutinefunction(func):
+            afunc = func
+            func = None
+
+        super().__init__(func=func, afunc=afunc, input_type=input_type, **kwargs)  # type: ignore[call-arg]
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    @property
+    def InputType(self) -> Any:
+        return self.input_type or Any
+
+    @property
+    def OutputType(self) -> Any:
+        return self.input_type or Any
+
+    @classmethod
+    def assign(
+        cls,
+        **kwargs: Union[
+            Runnable[Dict[str, Any], Any],
+            Callable[[Dict[str, Any]], Any],
+            Mapping[
+                str,
+                Union[Runnable[Dict[str, Any], Any], Callable[[Dict[str, Any]], Any]],
+            ],
+        ],
+    ) -> "RunnableAssign":
+        """Merge the Dict input with the output produced by the mapping argument.
+
+        Args:
+            mapping: A mapping from keys to runnables or callables.
+
+        Returns:
+            A runnable that merges the Dict input with the output produced by the
+            mapping argument.
+        """
+        return RunnableAssign(RunnableParallel(kwargs))
+
+    def invoke(
+        self, input: Other, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> Other:
+        if self.func is not None:
+            call_func_with_variable_args(
+                self.func, input, ensure_config(config), **kwargs
+            )
+        return self._call_with_config(identity, input, config)
+
+    async def ainvoke(
+        self,
+        input: Other,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Other:
+        if self.afunc is not None:
+            await acall_func_with_variable_args(
+                self.afunc, input, ensure_config(config), **kwargs
+            )
+        elif self.func is not None:
+            call_func_with_variable_args(
+                self.func, input, ensure_config(config), **kwargs
+            )
+        return await self._acall_with_config(aidentity, input, config)
+
+    def transform(
+        self,
+        input: Iterator[Other],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Iterator[Other]:
+        if self.func is None:
+            for chunk in self._transform_stream_with_config(input, identity, config):
+                yield chunk
+        else:
+            final = None
+
+            for chunk in self._transform_stream_with_config(input, identity, config):
+                yield chunk
+                if final is None:
+                    final = adapt_first_streaming_chunk(chunk)
+                else:
+                    final = final + chunk
+
+            if final is not None:
+                call_func_with_variable_args(
+                    self.func, final, ensure_config(config), **kwargs
+                )
+
+    async def atransform(
+        self,
+        input: AsyncIterator[Other],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[Other]:
+        if self.afunc is None and self.func is None:
+            async for chunk in self._atransform_stream_with_config(
+                input, identity, config
+            ):
+                yield chunk
+        else:
+            final = None
+
+            async for chunk in self._atransform_stream_with_config(
+                input, identity, config
+            ):
+                yield chunk
+                if final is None:
+                    final = adapt_first_streaming_chunk(chunk)
+                else:
+                    final = final + chunk
+
+            if final is not None:
+                config = ensure_config(config)
+                if self.afunc is not None:
+                    await acall_func_with_variable_args(
+                        self.afunc, final, config, **kwargs
+                    )
+                elif self.func is not None:
+                    call_func_with_variable_args(self.func, final, config, **kwargs)
+
+    def stream(
+        self,
+        input: Other,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Iterator[Other]:
+        return self.transform(iter([input]), config, **kwargs)
+
+    async def astream(
+        self,
+        input: Other,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[Other]:
+        async def input_aiter() -> AsyncIterator[Other]:
+            yield input
+
+        async for chunk in self.atransform(input_aiter(), config, **kwargs):
+            yield chunk
+
+
+_graph_passthrough: RunnablePassthrough = RunnablePassthrough()
+
+
+class RunnableAssign(RunnableSerializable[Dict[str, Any], Dict[str, Any]]):
+    """
+    A runnable that assigns key-value pairs to Dict[str, Any] inputs.
+
+    The `RunnableAssign` class takes input dictionaries and, through a
+    `RunnableParallel` instance, applies transformations, then combines
+    these with the original data, introducing new key-value pairs based
+    on the mapper's logic.
+
+    Examples:
+        .. code-block:: python
+
+            # This is a RunnableAssign
+            from typing import Dict
+            from langchain_core.runnables.passthrough import (
+                RunnableAssign,
+                RunnableParallel,
+            )
+            from langchain_core.runnables.base import RunnableLambda
+
+            def add_ten(x: Dict[str, int]) -> Dict[str, int]:
+                return {"added": x["input"] + 10}
+
+            mapper = RunnableParallel(
+                {"add_step": RunnableLambda(add_ten),}
+            )
+
+            runnable_assign = RunnableAssign(mapper)
+
+            # Synchronous example
+            runnable_assign.invoke({"input": 5})
+            # returns {'input': 5, 'add_step': {'added': 15}}
+
+            # Asynchronous example
+            await runnable_assign.ainvoke({"input": 5})
+            # returns {'input': 5, 'add_step': {'added': 15}}
+    """
+
+    mapper: RunnableParallel[Dict[str, Any]]
+
+    def __init__(self, mapper: RunnableParallel[Dict[str, Any]], **kwargs: Any) -> None:
+        super().__init__(mapper=mapper, **kwargs)  # type: ignore[call-arg]
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    def get_name(
+        self, suffix: Optional[str] = None, *, name: Optional[str] = None
+    ) -> str:
+        name = (
+            name
+            or self.name
+            or f"RunnableAssign<{','.join(self.mapper.steps__.keys())}>"
+        )
+        return super().get_name(suffix, name=name)
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        map_input_schema = self.mapper.get_input_schema(config)
+        if not map_input_schema.__custom_root_type__:
+            # ie. it's a dict
+            return map_input_schema
+
+        return super().get_input_schema(config)
+
+    def get_output_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        map_input_schema = self.mapper.get_input_schema(config)
+        map_output_schema = self.mapper.get_output_schema(config)
+        if (
+            not map_input_schema.__custom_root_type__
+            and not map_output_schema.__custom_root_type__
+        ):
+            # ie. both are dicts
+            return create_model(  # type: ignore[call-overload]
+                "RunnableAssignOutput",
+                **{
+                    k: (v.type_, v.default)
+                    for s in (map_input_schema, map_output_schema)
+                    for k, v in s.__fields__.items()
+                },
+            )
+        elif not map_output_schema.__custom_root_type__:
+            # ie. only map output is a dict
+            # ie. input type is either unknown or inferred incorrectly
+            return map_output_schema
+
+        return super().get_output_schema(config)
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        return self.mapper.config_specs
+
+    def get_graph(self, config: RunnableConfig | None = None) -> Graph:
+        # get graph from mapper
+        graph = self.mapper.get_graph(config)
+        # add passthrough node and edges
+        input_node = graph.first_node()
+        output_node = graph.last_node()
+        if input_node is not None and output_node is not None:
+            passthrough_node = graph.add_node(_graph_passthrough)
+            graph.add_edge(input_node, passthrough_node)
+            graph.add_edge(passthrough_node, output_node)
+        return graph
+
+    def _invoke(
+        self,
+        input: Dict[str, Any],
+        run_manager: CallbackManagerForChainRun,
+        config: RunnableConfig,
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        assert isinstance(
+            input, dict
+        ), "The input to RunnablePassthrough.assign() must be a dict."
+
+        return {
+            **input,
+            **self.mapper.invoke(
+                input,
+                patch_config(config, callbacks=run_manager.get_child()),
+                **kwargs,
+            ),
+        }
+
+    def invoke(
+        self,
+        input: Dict[str, Any],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        return self._call_with_config(self._invoke, input, config, **kwargs)
+
+    async def _ainvoke(
+        self,
+        input: Dict[str, Any],
+        run_manager: AsyncCallbackManagerForChainRun,
+        config: RunnableConfig,
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        assert isinstance(
+            input, dict
+        ), "The input to RunnablePassthrough.assign() must be a dict."
+
+        return {
+            **input,
+            **await self.mapper.ainvoke(
+                input,
+                patch_config(config, callbacks=run_manager.get_child()),
+                **kwargs,
+            ),
+        }
+
+    async def ainvoke(
+        self,
+        input: Dict[str, Any],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        return await self._acall_with_config(self._ainvoke, input, config, **kwargs)
+
+    def _transform(
+        self,
+        input: Iterator[Dict[str, Any]],
+        run_manager: CallbackManagerForChainRun,
+        config: RunnableConfig,
+        **kwargs: Any,
+    ) -> Iterator[Dict[str, Any]]:
+        # collect mapper keys
+        mapper_keys = set(self.mapper.steps__.keys())
+        # create two streams, one for the map and one for the passthrough
+        for_passthrough, for_map = safetee(input, 2, lock=threading.Lock())
+
+        # create map output stream
+        map_output = self.mapper.transform(
+            for_map,
+            patch_config(
+                config,
+                callbacks=run_manager.get_child(),
+            ),
+            **kwargs,
+        )
+
+        # get executor to start map output stream in background
+        with get_executor_for_config(config) as executor:
+            # start map output stream
+            first_map_chunk_future = executor.submit(
+                next,
+                map_output,  # type: ignore
+                None,
+            )
+            # consume passthrough stream
+            for chunk in for_passthrough:
+                assert isinstance(
+                    chunk, dict
+                ), "The input to RunnablePassthrough.assign() must be a dict."
+                # remove mapper keys from passthrough chunk, to be overwritten by map
+                filtered = AddableDict(
+                    {k: v for k, v in chunk.items() if k not in mapper_keys}
+                )
+                if filtered:
+                    yield filtered
+            # yield map output
+            yield cast(Dict[str, Any], first_map_chunk_future.result())
+            for chunk in map_output:
+                yield chunk
+
+    def transform(
+        self,
+        input: Iterator[Dict[str, Any]],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any | None,
+    ) -> Iterator[Dict[str, Any]]:
+        yield from self._transform_stream_with_config(
+            input, self._transform, config, **kwargs
+        )
+
+    async def _atransform(
+        self,
+        input: AsyncIterator[Dict[str, Any]],
+        run_manager: AsyncCallbackManagerForChainRun,
+        config: RunnableConfig,
+        **kwargs: Any,
+    ) -> AsyncIterator[Dict[str, Any]]:
+        # collect mapper keys
+        mapper_keys = set(self.mapper.steps__.keys())
+        # create two streams, one for the map and one for the passthrough
+        for_passthrough, for_map = atee(input, 2, lock=asyncio.Lock())
+        # create map output stream
+        map_output = self.mapper.atransform(
+            for_map,
+            patch_config(
+                config,
+                callbacks=run_manager.get_child(),
+            ),
+            **kwargs,
+        )
+        # start map output stream
+        first_map_chunk_task: asyncio.Task = asyncio.create_task(
+            py_anext(map_output, None),  # type: ignore[arg-type]
+        )
+        # consume passthrough stream
+        async for chunk in for_passthrough:
+            assert isinstance(
+                chunk, dict
+            ), "The input to RunnablePassthrough.assign() must be a dict."
+            # remove mapper keys from passthrough chunk, to be overwritten by map output
+            filtered = AddableDict(
+                {k: v for k, v in chunk.items() if k not in mapper_keys}
+            )
+            if filtered:
+                yield filtered
+        # yield map output
+        yield await first_map_chunk_task
+        async for chunk in map_output:
+            yield chunk
+
+    async def atransform(
+        self,
+        input: AsyncIterator[Dict[str, Any]],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[Dict[str, Any]]:
+        async for chunk in self._atransform_stream_with_config(
+            input, self._atransform, config, **kwargs
+        ):
+            yield chunk
+
+    def stream(
+        self,
+        input: Dict[str, Any],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Iterator[Dict[str, Any]]:
+        return self.transform(iter([input]), config, **kwargs)
+
+    async def astream(
+        self,
+        input: Dict[str, Any],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[Dict[str, Any]]:
+        async def input_aiter() -> AsyncIterator[Dict[str, Any]]:
+            yield input
+
+        async for chunk in self.atransform(input_aiter(), config, **kwargs):
+            yield chunk
+
+
+class RunnablePick(RunnableSerializable[Dict[str, Any], Dict[str, Any]]):
+    """Runnable that picks keys from Dict[str, Any] inputs.
+
+    RunnablePick class represents a runnable that selectively picks keys from a
+    dictionary input. It allows you to specify one or more keys to extract
+    from the input dictionary. It returns a new dictionary containing only
+    the selected keys.
+
+    Example :
+        .. code-block:: python
+
+            from langchain_core.runnables.passthrough import RunnablePick
+
+            input_data = {
+                'name': 'John',
+                'age': 30,
+                'city': 'New York',
+                'country': 'USA'
+            }
+
+            runnable = RunnablePick(keys=['name', 'age'])
+
+            output_data = runnable.invoke(input_data)
+
+            print(output_data)  # Output: {'name': 'John', 'age': 30}
+    """
+
+    keys: Union[str, List[str]]
+
+    def __init__(self, keys: Union[str, List[str]], **kwargs: Any) -> None:
+        super().__init__(keys=keys, **kwargs)  # type: ignore[call-arg]
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    def get_name(
+        self, suffix: Optional[str] = None, *, name: Optional[str] = None
+    ) -> str:
+        name = (
+            name
+            or self.name
+            or f"RunnablePick<{','.join([self.keys] if isinstance(self.keys, str) else self.keys)}>"  # noqa: E501
+        )
+        return super().get_name(suffix, name=name)
+
+    def _pick(self, input: Dict[str, Any]) -> Any:
+        assert isinstance(
+            input, dict
+        ), "The input to RunnablePassthrough.assign() must be a dict."
+
+        if isinstance(self.keys, str):
+            return input.get(self.keys)
+        else:
+            picked = {k: input.get(k) for k in self.keys if k in input}
+            if picked:
+                return AddableDict(picked)
+            else:
+                return None
+
+    def _invoke(
+        self,
+        input: Dict[str, Any],
+    ) -> Dict[str, Any]:
+        return self._pick(input)
+
+    def invoke(
+        self,
+        input: Dict[str, Any],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        return self._call_with_config(self._invoke, input, config, **kwargs)
+
+    async def _ainvoke(
+        self,
+        input: Dict[str, Any],
+    ) -> Dict[str, Any]:
+        return self._pick(input)
+
+    async def ainvoke(
+        self,
+        input: Dict[str, Any],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        return await self._acall_with_config(self._ainvoke, input, config, **kwargs)
+
+    def _transform(
+        self,
+        input: Iterator[Dict[str, Any]],
+    ) -> Iterator[Dict[str, Any]]:
+        for chunk in input:
+            picked = self._pick(chunk)
+            if picked is not None:
+                yield picked
+
+    def transform(
+        self,
+        input: Iterator[Dict[str, Any]],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Iterator[Dict[str, Any]]:
+        yield from self._transform_stream_with_config(
+            input, self._transform, config, **kwargs
+        )
+
+    async def _atransform(
+        self,
+        input: AsyncIterator[Dict[str, Any]],
+    ) -> AsyncIterator[Dict[str, Any]]:
+        async for chunk in input:
+            picked = self._pick(chunk)
+            if picked is not None:
+                yield picked
+
+    async def atransform(
+        self,
+        input: AsyncIterator[Dict[str, Any]],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[Dict[str, Any]]:
+        async for chunk in self._atransform_stream_with_config(
+            input, self._atransform, config, **kwargs
+        ):
+            yield chunk
+
+    def stream(
+        self,
+        input: Dict[str, Any],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Iterator[Dict[str, Any]]:
+        return self.transform(iter([input]), config, **kwargs)
+
+    async def astream(
+        self,
+        input: Dict[str, Any],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> AsyncIterator[Dict[str, Any]]:
+        async def input_aiter() -> AsyncIterator[Dict[str, Any]]:
+            yield input
+
+        async for chunk in self.atransform(input_aiter(), config, **kwargs):
+            yield chunk
diff --git a/llm/Lib/site-packages/langchain_core/runnables/retry.py b/llm/Lib/site-packages/langchain_core/runnables/retry.py
new file mode 100644
index 0000000000000000000000000000000000000000..bb1d08eaf1bc1f19fd3a68b0f9c308d6c694c19d
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/retry.py
@@ -0,0 +1,342 @@
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+)
+
+from tenacity import (
+    AsyncRetrying,
+    RetryCallState,
+    RetryError,
+    Retrying,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential_jitter,
+)
+
+from langchain_core.runnables.base import Input, Output, RunnableBindingBase
+from langchain_core.runnables.config import RunnableConfig, patch_config
+
+if TYPE_CHECKING:
+    from langchain_core.callbacks.manager import (
+        AsyncCallbackManagerForChainRun,
+        CallbackManagerForChainRun,
+    )
+
+    T = TypeVar("T", CallbackManagerForChainRun, AsyncCallbackManagerForChainRun)
+U = TypeVar("U")
+
+
+class RunnableRetry(RunnableBindingBase[Input, Output]):
+    """Retry a Runnable if it fails.
+
+    RunnableRetry can be used to add retry logic to any object
+    that subclasses the base Runnable.
+
+    Such retries are especially useful for network calls that may fail
+    due to transient errors.
+
+    The RunnableRetry is implemented as a RunnableBinding. The easiest
+    way to use it is through the `.with_retry()` method on all Runnables.
+
+    Example:
+
+    Here's an example that uses a RunnableLambda to raise an exception
+
+        .. code-block:: python
+
+            import time
+
+            def foo(input) -> None:
+                '''Fake function that raises an exception.'''
+                raise ValueError(f"Invoking foo failed. At time {time.time()}")
+
+            runnable = RunnableLambda(foo)
+
+            runnable_with_retries = runnable.with_retry(
+                retry_if_exception_type=(ValueError,), # Retry only on ValueError
+                wait_exponential_jitter=True, # Add jitter to the exponential backoff
+                stop_after_attempt=2, # Try twice
+            )
+
+            # The method invocation above is equivalent to the longer form below:
+
+            runnable_with_retries = RunnableRetry(
+                bound=runnable,
+                retry_exception_types=(ValueError,),
+                max_attempt_number=2,
+                wait_exponential_jitter=True
+            )
+
+    This logic can be used to retry any Runnable, including a chain of Runnables,
+    but in general it's best practice to keep the scope of the retry as small as
+    possible. For example, if you have a chain of Runnables, you should only retry
+    the Runnable that is likely to fail, not the entire chain.
+
+    Example:
+
+        .. code-block:: python
+
+            from langchain_core.chat_models import ChatOpenAI
+            from langchain_core.prompts import PromptTemplate
+
+            template = PromptTemplate.from_template("tell me a joke about {topic}.")
+            model = ChatOpenAI(temperature=0.5)
+
+            # Good
+            chain = template | model.with_retry()
+
+            # Bad
+            chain = template | model
+            retryable_chain = chain.with_retry()
+    """
+
+    retry_exception_types: Tuple[Type[BaseException], ...] = (Exception,)
+    """The exception types to retry on. By default all exceptions are retried.
+    
+    In general you should only retry on exceptions that are likely to be
+    transient, such as network errors.
+    
+    Good exceptions to retry are all server errors (5xx) and selected client
+    errors (4xx) such as 429 Too Many Requests.
+    """
+
+    wait_exponential_jitter: bool = True
+    """Whether to add jitter to the exponential backoff."""
+
+    max_attempt_number: int = 3
+    """The maximum number of attempts to retry the runnable."""
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    @property
+    def _kwargs_retrying(self) -> Dict[str, Any]:
+        kwargs: Dict[str, Any] = dict()
+
+        if self.max_attempt_number:
+            kwargs["stop"] = stop_after_attempt(self.max_attempt_number)
+
+        if self.wait_exponential_jitter:
+            kwargs["wait"] = wait_exponential_jitter()
+
+        if self.retry_exception_types:
+            kwargs["retry"] = retry_if_exception_type(self.retry_exception_types)
+
+        return kwargs
+
+    def _sync_retrying(self, **kwargs: Any) -> Retrying:
+        return Retrying(**self._kwargs_retrying, **kwargs)
+
+    def _async_retrying(self, **kwargs: Any) -> AsyncRetrying:
+        return AsyncRetrying(**self._kwargs_retrying, **kwargs)
+
+    def _patch_config(
+        self,
+        config: RunnableConfig,
+        run_manager: "T",
+        retry_state: RetryCallState,
+    ) -> RunnableConfig:
+        attempt = retry_state.attempt_number
+        tag = "retry:attempt:{}".format(attempt) if attempt > 1 else None
+        return patch_config(config, callbacks=run_manager.get_child(tag))
+
+    def _patch_config_list(
+        self,
+        config: List[RunnableConfig],
+        run_manager: List["T"],
+        retry_state: RetryCallState,
+    ) -> List[RunnableConfig]:
+        return [
+            self._patch_config(c, rm, retry_state) for c, rm in zip(config, run_manager)
+        ]
+
+    def _invoke(
+        self,
+        input: Input,
+        run_manager: "CallbackManagerForChainRun",
+        config: RunnableConfig,
+        **kwargs: Any,
+    ) -> Output:
+        for attempt in self._sync_retrying(reraise=True):
+            with attempt:
+                result = super().invoke(
+                    input,
+                    self._patch_config(config, run_manager, attempt.retry_state),
+                    **kwargs,
+                )
+            if attempt.retry_state.outcome and not attempt.retry_state.outcome.failed:
+                attempt.retry_state.set_result(result)
+        return result
+
+    def invoke(
+        self, input: Input, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> Output:
+        return self._call_with_config(self._invoke, input, config, **kwargs)
+
+    async def _ainvoke(
+        self,
+        input: Input,
+        run_manager: "AsyncCallbackManagerForChainRun",
+        config: RunnableConfig,
+        **kwargs: Any,
+    ) -> Output:
+        async for attempt in self._async_retrying(reraise=True):
+            with attempt:
+                result = await super().ainvoke(
+                    input,
+                    self._patch_config(config, run_manager, attempt.retry_state),
+                    **kwargs,
+                )
+            if attempt.retry_state.outcome and not attempt.retry_state.outcome.failed:
+                attempt.retry_state.set_result(result)
+        return result
+
+    async def ainvoke(
+        self, input: Input, config: Optional[RunnableConfig] = None, **kwargs: Any
+    ) -> Output:
+        return await self._acall_with_config(self._ainvoke, input, config, **kwargs)
+
+    def _batch(
+        self,
+        inputs: List[Input],
+        run_manager: List["CallbackManagerForChainRun"],
+        config: List[RunnableConfig],
+        **kwargs: Any,
+    ) -> List[Union[Output, Exception]]:
+        results_map: Dict[int, Output] = {}
+
+        def pending(iterable: List[U]) -> List[U]:
+            return [item for idx, item in enumerate(iterable) if idx not in results_map]
+
+        try:
+            for attempt in self._sync_retrying():
+                with attempt:
+                    # Get the results of the inputs that have not succeeded yet.
+                    result = super().batch(
+                        pending(inputs),
+                        self._patch_config_list(
+                            pending(config), pending(run_manager), attempt.retry_state
+                        ),
+                        return_exceptions=True,
+                        **kwargs,
+                    )
+                    # Register the results of the inputs that have succeeded.
+                    first_exception = None
+                    for i, r in enumerate(result):
+                        if isinstance(r, Exception):
+                            if not first_exception:
+                                first_exception = r
+                            continue
+                        results_map[i] = r
+                    # If any exception occurred, raise it, to retry the failed ones
+                    if first_exception:
+                        raise first_exception
+                if (
+                    attempt.retry_state.outcome
+                    and not attempt.retry_state.outcome.failed
+                ):
+                    attempt.retry_state.set_result(result)
+        except RetryError as e:
+            try:
+                result
+            except UnboundLocalError:
+                result = cast(List[Output], [e] * len(inputs))
+
+        outputs: List[Union[Output, Exception]] = []
+        for idx, _ in enumerate(inputs):
+            if idx in results_map:
+                outputs.append(results_map[idx])
+            else:
+                outputs.append(result.pop(0))
+        return outputs
+
+    def batch(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Any,
+    ) -> List[Output]:
+        return self._batch_with_config(
+            self._batch, inputs, config, return_exceptions=return_exceptions, **kwargs
+        )
+
+    async def _abatch(
+        self,
+        inputs: List[Input],
+        run_manager: List["AsyncCallbackManagerForChainRun"],
+        config: List[RunnableConfig],
+        **kwargs: Any,
+    ) -> List[Union[Output, Exception]]:
+        results_map: Dict[int, Output] = {}
+
+        def pending(iterable: List[U]) -> List[U]:
+            return [item for idx, item in enumerate(iterable) if idx not in results_map]
+
+        try:
+            async for attempt in self._async_retrying():
+                with attempt:
+                    # Get the results of the inputs that have not succeeded yet.
+                    result = await super().abatch(
+                        pending(inputs),
+                        self._patch_config_list(
+                            pending(config), pending(run_manager), attempt.retry_state
+                        ),
+                        return_exceptions=True,
+                        **kwargs,
+                    )
+                    # Register the results of the inputs that have succeeded.
+                    first_exception = None
+                    for i, r in enumerate(result):
+                        if isinstance(r, Exception):
+                            if not first_exception:
+                                first_exception = r
+                            continue
+                        results_map[i] = r
+                    # If any exception occurred, raise it, to retry the failed ones
+                    if first_exception:
+                        raise first_exception
+                if (
+                    attempt.retry_state.outcome
+                    and not attempt.retry_state.outcome.failed
+                ):
+                    attempt.retry_state.set_result(result)
+        except RetryError as e:
+            try:
+                result
+            except UnboundLocalError:
+                result = cast(List[Output], [e] * len(inputs))
+
+        outputs: List[Union[Output, Exception]] = []
+        for idx, _ in enumerate(inputs):
+            if idx in results_map:
+                outputs.append(results_map[idx])
+            else:
+                outputs.append(result.pop(0))
+        return outputs
+
+    async def abatch(
+        self,
+        inputs: List[Input],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Any,
+    ) -> List[Output]:
+        return await self._abatch_with_config(
+            self._abatch, inputs, config, return_exceptions=return_exceptions, **kwargs
+        )
+
+    # stream() and transform() are not retried because retrying a stream
+    # is not very intuitive.
diff --git a/llm/Lib/site-packages/langchain_core/runnables/router.py b/llm/Lib/site-packages/langchain_core/runnables/router.py
new file mode 100644
index 0000000000000000000000000000000000000000..82587b3e2077dad4665fbee06d16a8f290e07697
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/router.py
@@ -0,0 +1,220 @@
+from __future__ import annotations
+
+from typing import (
+    Any,
+    AsyncIterator,
+    Callable,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Union,
+    cast,
+)
+
+from typing_extensions import TypedDict
+
+from langchain_core.runnables.base import (
+    Input,
+    Output,
+    Runnable,
+    RunnableSerializable,
+    coerce_to_runnable,
+)
+from langchain_core.runnables.config import (
+    RunnableConfig,
+    get_config_list,
+    get_executor_for_config,
+)
+from langchain_core.runnables.utils import (
+    ConfigurableFieldSpec,
+    gather_with_concurrency,
+    get_unique_config_specs,
+)
+
+
+class RouterInput(TypedDict):
+    """Router input.
+
+    Attributes:
+        key: The key to route on.
+        input: The input to pass to the selected runnable.
+    """
+
+    key: str
+    input: Any
+
+
+class RouterRunnable(RunnableSerializable[RouterInput, Output]):
+    """
+    Runnable that routes to a set of Runnables based on Input['key'].
+    Returns the output of the selected Runnable.
+
+    For example,
+
+    .. code-block:: python
+
+        from langchain_core.runnables.router import RouterRunnable
+        from langchain_core.runnables import RunnableLambda
+
+        add = RunnableLambda(func=lambda x: x + 1)
+        square = RunnableLambda(func=lambda x: x**2)
+
+        router = RouterRunnable(runnables={"add": add, "square": square})
+        router.invoke({"key": "square", "input": 3})
+    """
+
+    runnables: Mapping[str, Runnable[Any, Output]]
+
+    @property
+    def config_specs(self) -> List[ConfigurableFieldSpec]:
+        return get_unique_config_specs(
+            spec for step in self.runnables.values() for spec in step.config_specs
+        )
+
+    def __init__(
+        self,
+        runnables: Mapping[str, Union[Runnable[Any, Output], Callable[[Any], Output]]],
+    ) -> None:
+        super().__init__(  # type: ignore[call-arg]
+            runnables={key: coerce_to_runnable(r) for key, r in runnables.items()}
+        )
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        """Return whether this class is serializable."""
+        return True
+
+    @classmethod
+    def get_lc_namespace(cls) -> List[str]:
+        """Get the namespace of the langchain object."""
+        return ["langchain", "schema", "runnable"]
+
+    def invoke(
+        self, input: RouterInput, config: Optional[RunnableConfig] = None
+    ) -> Output:
+        key = input["key"]
+        actual_input = input["input"]
+        if key not in self.runnables:
+            raise ValueError(f"No runnable associated with key '{key}'")
+
+        runnable = self.runnables[key]
+        return runnable.invoke(actual_input, config)
+
+    async def ainvoke(
+        self,
+        input: RouterInput,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Output:
+        key = input["key"]
+        actual_input = input["input"]
+        if key not in self.runnables:
+            raise ValueError(f"No runnable associated with key '{key}'")
+
+        runnable = self.runnables[key]
+        return await runnable.ainvoke(actual_input, config)
+
+    def batch(
+        self,
+        inputs: List[RouterInput],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        if not inputs:
+            return []
+
+        keys = [input["key"] for input in inputs]
+        actual_inputs = [input["input"] for input in inputs]
+        if any(key not in self.runnables for key in keys):
+            raise ValueError("One or more keys do not have a corresponding runnable")
+
+        def invoke(
+            runnable: Runnable, input: Input, config: RunnableConfig
+        ) -> Union[Output, Exception]:
+            if return_exceptions:
+                try:
+                    return runnable.invoke(input, config, **kwargs)
+                except Exception as e:
+                    return e
+            else:
+                return runnable.invoke(input, config, **kwargs)
+
+        runnables = [self.runnables[key] for key in keys]
+        configs = get_config_list(config, len(inputs))
+        with get_executor_for_config(configs[0]) as executor:
+            return cast(
+                List[Output],
+                list(executor.map(invoke, runnables, actual_inputs, configs)),
+            )
+
+    async def abatch(
+        self,
+        inputs: List[RouterInput],
+        config: Optional[Union[RunnableConfig, List[RunnableConfig]]] = None,
+        *,
+        return_exceptions: bool = False,
+        **kwargs: Optional[Any],
+    ) -> List[Output]:
+        if not inputs:
+            return []
+
+        keys = [input["key"] for input in inputs]
+        actual_inputs = [input["input"] for input in inputs]
+        if any(key not in self.runnables for key in keys):
+            raise ValueError("One or more keys do not have a corresponding runnable")
+
+        async def ainvoke(
+            runnable: Runnable, input: Input, config: RunnableConfig
+        ) -> Union[Output, Exception]:
+            if return_exceptions:
+                try:
+                    return await runnable.ainvoke(input, config, **kwargs)
+                except Exception as e:
+                    return e
+            else:
+                return await runnable.ainvoke(input, config, **kwargs)
+
+        runnables = [self.runnables[key] for key in keys]
+        configs = get_config_list(config, len(inputs))
+        return await gather_with_concurrency(
+            configs[0].get("max_concurrency"),
+            *(
+                ainvoke(runnable, input, config)
+                for runnable, input, config in zip(runnables, actual_inputs, configs)
+            ),
+        )
+
+    def stream(
+        self,
+        input: RouterInput,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> Iterator[Output]:
+        key = input["key"]
+        actual_input = input["input"]
+        if key not in self.runnables:
+            raise ValueError(f"No runnable associated with key '{key}'")
+
+        runnable = self.runnables[key]
+        yield from runnable.stream(actual_input, config)
+
+    async def astream(
+        self,
+        input: RouterInput,
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Optional[Any],
+    ) -> AsyncIterator[Output]:
+        key = input["key"]
+        actual_input = input["input"]
+        if key not in self.runnables:
+            raise ValueError(f"No runnable associated with key '{key}'")
+
+        runnable = self.runnables[key]
+        async for output in runnable.astream(actual_input, config):
+            yield output
diff --git a/llm/Lib/site-packages/langchain_core/runnables/schema.py b/llm/Lib/site-packages/langchain_core/runnables/schema.py
new file mode 100644
index 0000000000000000000000000000000000000000..db4ad13a34ac63f3a333b1406f448bcc8bcb7866
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/schema.py
@@ -0,0 +1,133 @@
+"""Module contains typedefs that are used with runnables."""
+from __future__ import annotations
+
+from typing import Any, Dict, List
+
+from typing_extensions import NotRequired, TypedDict
+
+
+class EventData(TypedDict, total=False):
+    """Data associated with a streaming event."""
+
+    input: Any
+    """The input passed to the runnable that generated the event.
+    
+    Inputs will sometimes be available at the *START* of the Runnable, and 
+    sometimes at the *END* of the Runnable.
+    
+    If a Runnable is able to stream its inputs, then its input by definition
+    won't be known until the *END* of the Runnable when it has finished streaming
+    its inputs.
+    """
+    output: Any
+    """The output of the Runnable that generated the event.
+    
+    Outputs will only be available at the *END* of the Runnable.
+    
+    For most Runnables, this field can be inferred from the `chunk` field,
+    though there might be some exceptions for special cased Runnables (e.g., like
+    chat models), which may return more information.
+    """
+    chunk: Any
+    """A streaming chunk from the output that generated the event.
+    
+    chunks support addition in general, and adding them up should result
+    in the output of the Runnable that generated the event.
+    """
+
+
+class StreamEvent(TypedDict):
+    """Streaming event.
+
+    Schema of a streaming event which is produced from the astream_events method.
+
+    Example:
+
+        .. code-block:: python
+
+            from langchain_core.runnables import RunnableLambda
+
+            async def reverse(s: str) -> str:
+                return s[::-1]
+
+            chain = RunnableLambda(func=reverse)
+
+            events = [event async for event in chain.astream_events("hello")]
+
+            # will produce the following events (run_id has been omitted for brevity):
+            [
+                {
+                    "data": {"input": "hello"},
+                    "event": "on_chain_start",
+                    "metadata": {},
+                    "name": "reverse",
+                    "tags": [],
+                },
+                {
+                    "data": {"chunk": "olleh"},
+                    "event": "on_chain_stream",
+                    "metadata": {},
+                    "name": "reverse",
+                    "tags": [],
+                },
+                {
+                    "data": {"output": "olleh"},
+                    "event": "on_chain_end",
+                    "metadata": {},
+                    "name": "reverse",
+                    "tags": [],
+                },
+            ]
+    """
+
+    event: str
+    """Event names are of the format: on_[runnable_type]_(start|stream|end).
+    
+    Runnable types are one of: 
+    * llm - used by non chat models
+    * chat_model - used by chat models
+    * prompt --  e.g., ChatPromptTemplate
+    * tool -- from tools defined via @tool decorator or inheriting from Tool/BaseTool
+    * chain - most Runnables are of this type
+    
+    Further, the events are categorized as one of:
+    * start - when the runnable starts
+    * stream - when the runnable is streaming
+    * end - when the runnable ends
+    
+    start, stream and end are associated with slightly different `data` payload.
+    
+    Please see the documentation for `EventData` for more details.
+    """
+    name: str
+    """The name of the runnable that generated the event."""
+    run_id: str
+    """An randomly generated ID to keep track of the execution of the given runnable.
+    
+    Each child runnable that gets invoked as part of the execution of a parent runnable
+    is assigned its own unique ID.
+    """
+    tags: NotRequired[List[str]]
+    """Tags associated with the runnable that generated this event.
+    
+    Tags are always inherited from parent runnables.
+    
+    Tags can either be bound to a runnable using `.with_config({"tags":  ["hello"]})`
+    or passed at run time using `.astream_events(..., {"tags": ["hello"]})`.
+    """
+    metadata: NotRequired[Dict[str, Any]]
+    """Metadata associated with the runnable that generated this event.
+    
+    Metadata can either be bound to a runnable using 
+    
+        `.with_config({"metadata": { "foo": "bar" }})`
+        
+    or passed at run time using 
+    
+        `.astream_events(..., {"metadata": {"foo": "bar"}})`.
+    """
+    data: EventData
+    """Event data.
+
+    The contents of the event data depend on the event type.
+    """
diff --git a/llm/Lib/site-packages/langchain_core/runnables/utils.py b/llm/Lib/site-packages/langchain_core/runnables/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..dff10ad04957afdb5b4f081dcf3d723a5a23323c
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/runnables/utils.py
@@ -0,0 +1,534 @@
+"""Utility code for runnables."""
+from __future__ import annotations
+
+import ast
+import asyncio
+import inspect
+import textwrap
+from functools import lru_cache
+from inspect import signature
+from itertools import groupby
+from typing import (
+    Any,
+    AsyncIterable,
+    Callable,
+    Coroutine,
+    Dict,
+    Iterable,
+    List,
+    Mapping,
+    NamedTuple,
+    Optional,
+    Protocol,
+    Sequence,
+    Set,
+    Type,
+    TypeVar,
+    Union,
+)
+
+from langchain_core.pydantic_v1 import BaseConfig, BaseModel
+from langchain_core.pydantic_v1 import create_model as _create_model_base
+from langchain_core.runnables.schema import StreamEvent
+
+Input = TypeVar("Input", contravariant=True)
+# Output type should implement __concat__, as eg str, list, dict do
+Output = TypeVar("Output", covariant=True)
+
+
+async def gated_coro(semaphore: asyncio.Semaphore, coro: Coroutine) -> Any:
+    """Run a coroutine with a semaphore.
+    Args:
+        semaphore: The semaphore to use.
+        coro: The coroutine to run.
+
+    Returns:
+        The result of the coroutine.
+    """
+    async with semaphore:
+        return await coro
+
+
+async def gather_with_concurrency(n: Union[int, None], *coros: Coroutine) -> list:
+    """Gather coroutines with a limit on the number of concurrent coroutines.
+
+    Args:
+        n: The number of coroutines to run concurrently.
+        coros: The coroutines to run.
+
+    Returns:
+        The results of the coroutines.
+    """
+    if n is None:
+        return await asyncio.gather(*coros)
+
+    semaphore = asyncio.Semaphore(n)
+
+    return await asyncio.gather(*(gated_coro(semaphore, c) for c in coros))
+
+
+def accepts_run_manager(callable: Callable[..., Any]) -> bool:
+    """Check if a callable accepts a run_manager argument."""
+    try:
+        return signature(callable).parameters.get("run_manager") is not None
+    except ValueError:
+        return False
+
+
+def accepts_config(callable: Callable[..., Any]) -> bool:
+    """Check if a callable accepts a config argument."""
+    try:
+        return signature(callable).parameters.get("config") is not None
+    except ValueError:
+        return False
+
+
+def accepts_context(callable: Callable[..., Any]) -> bool:
+    """Check if a callable accepts a context argument."""
+    try:
+        return signature(callable).parameters.get("context") is not None
+    except ValueError:
+        return False
+
+
+class IsLocalDict(ast.NodeVisitor):
+    """Check if a name is a local dict."""
+
+    def __init__(self, name: str, keys: Set[str]) -> None:
+        self.name = name
+        self.keys = keys
+
+    def visit_Subscript(self, node: ast.Subscript) -> Any:
+        if (
+            isinstance(node.ctx, ast.Load)
+            and isinstance(node.value, ast.Name)
+            and node.value.id == self.name
+            and isinstance(node.slice, ast.Constant)
+            and isinstance(node.slice.value, str)
+        ):
+            # we've found a subscript access on the name we're looking for
+            self.keys.add(node.slice.value)
+
+    def visit_Call(self, node: ast.Call) -> Any:
+        if (
+            isinstance(node.func, ast.Attribute)
+            and isinstance(node.func.value, ast.Name)
+            and node.func.value.id == self.name
+            and node.func.attr == "get"
+            and len(node.args) in (1, 2)
+            and isinstance(node.args[0], ast.Constant)
+            and isinstance(node.args[0].value, str)
+        ):
+            # we've found a .get() call on the name we're looking for
+            self.keys.add(node.args[0].value)
+
+
+class IsFunctionArgDict(ast.NodeVisitor):
+    """Check if the first argument of a function is a dict."""
+
+    def __init__(self) -> None:
+        self.keys: Set[str] = set()
+
+    def visit_Lambda(self, node: ast.Lambda) -> Any:
+        if not node.args.args:
+            return
+        input_arg_name = node.args.args[0].arg
+        IsLocalDict(input_arg_name, self.keys).visit(node.body)
+
+    def visit_FunctionDef(self, node: ast.FunctionDef) -> Any:
+        if not node.args.args:
+            return
+        input_arg_name = node.args.args[0].arg
+        IsLocalDict(input_arg_name, self.keys).visit(node)
+
+    def visit_AsyncFunctionDef(self, node: ast.AsyncFunctionDef) -> Any:
+        if not node.args.args:
+            return
+        input_arg_name = node.args.args[0].arg
+        IsLocalDict(input_arg_name, self.keys).visit(node)
+
+
+class NonLocals(ast.NodeVisitor):
+    """Get nonlocal variables accessed."""
+
+    def __init__(self) -> None:
+        self.loads: Set[str] = set()
+        self.stores: Set[str] = set()
+
+    def visit_Name(self, node: ast.Name) -> Any:
+        if isinstance(node.ctx, ast.Load):
+            self.loads.add(node.id)
+        elif isinstance(node.ctx, ast.Store):
+            self.stores.add(node.id)
+
+    def visit_Attribute(self, node: ast.Attribute) -> Any:
+        if isinstance(node.ctx, ast.Load):
+            parent = node.value
+            attr_expr = node.attr
+            while isinstance(parent, ast.Attribute):
+                attr_expr = parent.attr + "." + attr_expr
+                parent = parent.value
+            if isinstance(parent, ast.Name):
+                self.loads.add(parent.id + "." + attr_expr)
+                self.loads.discard(parent.id)
+
+
+class FunctionNonLocals(ast.NodeVisitor):
+    """Get the nonlocal variables accessed of a function."""
+
+    def __init__(self) -> None:
+        self.nonlocals: Set[str] = set()
+
+    def visit_FunctionDef(self, node: ast.FunctionDef) -> Any:
+        visitor = NonLocals()
+        visitor.visit(node)
+        self.nonlocals.update(visitor.loads - visitor.stores)
+
+    def visit_AsyncFunctionDef(self, node: ast.AsyncFunctionDef) -> Any:
+        visitor = NonLocals()
+        visitor.visit(node)
+        self.nonlocals.update(visitor.loads - visitor.stores)
+
+    def visit_Lambda(self, node: ast.Lambda) -> Any:
+        visitor = NonLocals()
+        visitor.visit(node)
+        self.nonlocals.update(visitor.loads - visitor.stores)
+
+
+class GetLambdaSource(ast.NodeVisitor):
+    """Get the source code of a lambda function."""
+
+    def __init__(self) -> None:
+        """Initialize the visitor."""
+        self.source: Optional[str] = None
+        self.count = 0
+
+    def visit_Lambda(self, node: ast.Lambda) -> Any:
+        """Visit a lambda function."""
+        self.count += 1
+        if hasattr(ast, "unparse"):
+            self.source = ast.unparse(node)
+
+
+def get_function_first_arg_dict_keys(func: Callable) -> Optional[List[str]]:
+    """Get the keys of the first argument of a function if it is a dict."""
+    try:
+        code = inspect.getsource(func)
+        tree = ast.parse(textwrap.dedent(code))
+        visitor = IsFunctionArgDict()
+        visitor.visit(tree)
+        return list(visitor.keys) if visitor.keys else None
+    except (SyntaxError, TypeError, OSError):
+        return None
+
+
+def get_lambda_source(func: Callable) -> Optional[str]:
+    """Get the source code of a lambda function.
+
+    Args:
+        func: a callable that can be a lambda function
+
+    Returns:
+        str: the source code of the lambda function
+    """
+    try:
+        name = func.__name__ if func.__name__ != "<lambda>" else None
+    except AttributeError:
+        name = None
+    try:
+        code = inspect.getsource(func)
+        tree = ast.parse(textwrap.dedent(code))
+        visitor = GetLambdaSource()
+        visitor.visit(tree)
+        return visitor.source if visitor.count == 1 else name
+    except (SyntaxError, TypeError, OSError):
+        return name
+
+
+def get_function_nonlocals(func: Callable) -> List[Any]:
+    """Get the nonlocal variables accessed by a function."""
+    try:
+        code = inspect.getsource(func)
+        tree = ast.parse(textwrap.dedent(code))
+        visitor = FunctionNonLocals()
+        visitor.visit(tree)
+        values: List[Any] = []
+        for k, v in inspect.getclosurevars(func).nonlocals.items():
+            if k in visitor.nonlocals:
+                values.append(v)
+            for kk in visitor.nonlocals:
+                if "." in kk and kk.startswith(k):
+                    vv = v
+                    for part in kk.split(".")[1:]:
+                        if vv is None:
+                            break
+                        else:
+                            try:
+                                vv = getattr(vv, part)
+                            except AttributeError:
+                                break
+                    else:
+                        values.append(vv)
+        return values
+    except (SyntaxError, TypeError, OSError):
+        return []
+
+
+def indent_lines_after_first(text: str, prefix: str) -> str:
+    """Indent all lines of text after the first line.
+
+    Args:
+        text:  The text to indent
+        prefix: Used to determine the number of spaces to indent
+
+    Returns:
+        str: The indented text
+    """
+    n_spaces = len(prefix)
+    spaces = " " * n_spaces
+    lines = text.splitlines()
+    return "\n".join([lines[0]] + [spaces + line for line in lines[1:]])
+
+
+class AddableDict(Dict[str, Any]):
+    """
+    Dictionary that can be added to another dictionary.
+    """
+
+    def __add__(self, other: AddableDict) -> AddableDict:
+        chunk = AddableDict(self)
+        for key in other:
+            if key not in chunk or chunk[key] is None:
+                chunk[key] = other[key]
+            elif other[key] is not None:
+                try:
+                    added = chunk[key] + other[key]
+                except TypeError:
+                    added = other[key]
+                chunk[key] = added
+        return chunk
+
+    def __radd__(self, other: AddableDict) -> AddableDict:
+        chunk = AddableDict(other)
+        for key in self:
+            if key not in chunk or chunk[key] is None:
+                chunk[key] = self[key]
+            elif self[key] is not None:
+                try:
+                    added = chunk[key] + self[key]
+                except TypeError:
+                    added = self[key]
+                chunk[key] = added
+        return chunk
+
+
+_T_co = TypeVar("_T_co", covariant=True)
+_T_contra = TypeVar("_T_contra", contravariant=True)
+
+
+class SupportsAdd(Protocol[_T_contra, _T_co]):
+    """Protocol for objects that support addition."""
+
+    def __add__(self, __x: _T_contra) -> _T_co:
+        ...
+
+
+Addable = TypeVar("Addable", bound=SupportsAdd[Any, Any])
+
+
+def add(addables: Iterable[Addable]) -> Optional[Addable]:
+    """Add a sequence of addable objects together."""
+    final = None
+    for chunk in addables:
+        if final is None:
+            final = chunk
+        else:
+            final = final + chunk
+    return final
+
+
+async def aadd(addables: AsyncIterable[Addable]) -> Optional[Addable]:
+    """Asynchronously add a sequence of addable objects together."""
+    final = None
+    async for chunk in addables:
+        if final is None:
+            final = chunk
+        else:
+            final = final + chunk
+    return final
+
+
+class ConfigurableField(NamedTuple):
+    """Field that can be configured by the user."""
+
+    id: str
+
+    name: Optional[str] = None
+    description: Optional[str] = None
+    annotation: Optional[Any] = None
+    is_shared: bool = False
+
+    def __hash__(self) -> int:
+        return hash((self.id, self.annotation))
+
+
+class ConfigurableFieldSingleOption(NamedTuple):
+    """Field that can be configured by the user with a default value."""
+
+    id: str
+    options: Mapping[str, Any]
+    default: str
+
+    name: Optional[str] = None
+    description: Optional[str] = None
+    is_shared: bool = False
+
+    def __hash__(self) -> int:
+        return hash((self.id, tuple(self.options.keys()), self.default))
+
+
+class ConfigurableFieldMultiOption(NamedTuple):
+    """Field that can be configured by the user with multiple default values."""
+
+    id: str
+    options: Mapping[str, Any]
+    default: Sequence[str]
+
+    name: Optional[str] = None
+    description: Optional[str] = None
+    is_shared: bool = False
+
+    def __hash__(self) -> int:
+        return hash((self.id, tuple(self.options.keys()), tuple(self.default)))
+
+
+AnyConfigurableField = Union[
+    ConfigurableField, ConfigurableFieldSingleOption, ConfigurableFieldMultiOption
+]
+
+
+class ConfigurableFieldSpec(NamedTuple):
+    """Field that can be configured by the user. It is a specification of a field."""
+
+    id: str
+    annotation: Any
+
+    name: Optional[str] = None
+    description: Optional[str] = None
+    default: Any = None
+    is_shared: bool = False
+    dependencies: Optional[List[str]] = None
+
+
+def get_unique_config_specs(
+    specs: Iterable[ConfigurableFieldSpec],
+) -> List[ConfigurableFieldSpec]:
+    """Get the unique config specs from a sequence of config specs."""
+    grouped = groupby(
+        sorted(specs, key=lambda s: (s.id, *(s.dependencies or []))), lambda s: s.id
+    )
+    unique: List[ConfigurableFieldSpec] = []
+    for id, dupes in grouped:
+        first = next(dupes)
+        others = list(dupes)
+        if len(others) == 0:
+            unique.append(first)
+        elif all(o == first for o in others):
+            unique.append(first)
+        else:
+            raise ValueError(
+                "RunnableSequence contains conflicting config specs"
+                f"for {id}: {[first] + others}"
+            )
+    return unique
+
+
+class _RootEventFilter:
+    def __init__(
+        self,
+        *,
+        include_names: Optional[Sequence[str]] = None,
+        include_types: Optional[Sequence[str]] = None,
+        include_tags: Optional[Sequence[str]] = None,
+        exclude_names: Optional[Sequence[str]] = None,
+        exclude_types: Optional[Sequence[str]] = None,
+        exclude_tags: Optional[Sequence[str]] = None,
+    ) -> None:
+        """Utility to filter the root event in the astream_events implementation.
+
+        This is simply binding the arguments to the namespace to make save on
+        a bit of typing in the astream_events implementation.
+        """
+        self.include_names = include_names
+        self.include_types = include_types
+        self.include_tags = include_tags
+        self.exclude_names = exclude_names
+        self.exclude_types = exclude_types
+        self.exclude_tags = exclude_tags
+
+    def include_event(self, event: StreamEvent, root_type: str) -> bool:
+        """Determine whether to include an event."""
+        if (
+            self.include_names is None
+            and self.include_types is None
+            and self.include_tags is None
+        ):
+            include = True
+        else:
+            include = False
+
+        event_tags = event.get("tags") or []
+
+        if self.include_names is not None:
+            include = include or event["name"] in self.include_names
+        if self.include_types is not None:
+            include = include or root_type in self.include_types
+        if self.include_tags is not None:
+            include = include or any(tag in self.include_tags for tag in event_tags)
+
+        if self.exclude_names is not None:
+            include = include and event["name"] not in self.exclude_names
+        if self.exclude_types is not None:
+            include = include and root_type not in self.exclude_types
+        if self.exclude_tags is not None:
+            include = include and all(
+                tag not in self.exclude_tags for tag in event_tags
+            )
+
+        return include
+
+
+class _SchemaConfig(BaseConfig):
+    arbitrary_types_allowed = True
+    frozen = True
+
+
+def create_model(
+    __model_name: str,
+    **field_definitions: Any,
+) -> Type[BaseModel]:
+    try:
+        return _create_model_cached(__model_name, **field_definitions)
+    except TypeError:
+        # something in field definitions is not hashable
+        return _create_model_base(
+            __model_name, __config__=_SchemaConfig, **field_definitions
+        )
+
+
+@lru_cache(maxsize=256)
+def _create_model_cached(
+    __model_name: str,
+    **field_definitions: Any,
+) -> Type[BaseModel]:
+    return _create_model_base(
+        __model_name, __config__=_SchemaConfig, **field_definitions
+    )
+
+
+def adapt_first_streaming_chunk(chunk: Any) -> Any:
+    """This might transform the first chunk of a stream into an AddableDict."""
+    if isinstance(chunk, dict) and not isinstance(chunk, AddableDict):
+        return AddableDict(chunk)
+    else:
+        return chunk
diff --git a/llm/Lib/site-packages/langchain_core/stores.py b/llm/Lib/site-packages/langchain_core/stores.py
new file mode 100644
index 0000000000000000000000000000000000000000..7695816ae147e0fdf5ee0c9a00ff982eea362778
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/stores.py
@@ -0,0 +1,125 @@
+"""**Store** implements the key-value stores and storage helpers.
+
+Module provides implementations of various key-value stores that conform
+to a simple key-value interface.
+
+The primary goal of these storages is to support implementation of caching.
+"""
+from abc import ABC, abstractmethod
+from typing import (
+    AsyncIterator,
+    Generic,
+    Iterator,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    TypeVar,
+    Union,
+)
+
+from langchain_core.runnables import run_in_executor
+
+K = TypeVar("K")
+V = TypeVar("V")
+
+
+class BaseStore(Generic[K, V], ABC):
+    """Abstract interface for a key-value store."""
+
+    @abstractmethod
+    def mget(self, keys: Sequence[K]) -> List[Optional[V]]:
+        """Get the values associated with the given keys.
+
+        Args:
+            keys (Sequence[K]): A sequence of keys.
+
+        Returns:
+            A sequence of optional values associated with the keys.
+            If a key is not found, the corresponding value will be None.
+        """
+
+    async def amget(self, keys: Sequence[K]) -> List[Optional[V]]:
+        """Get the values associated with the given keys.
+
+        Args:
+            keys (Sequence[K]): A sequence of keys.
+
+        Returns:
+            A sequence of optional values associated with the keys.
+            If a key is not found, the corresponding value will be None.
+        """
+        return await run_in_executor(None, self.mget, keys)
+
+    @abstractmethod
+    def mset(self, key_value_pairs: Sequence[Tuple[K, V]]) -> None:
+        """Set the values for the given keys.
+
+        Args:
+            key_value_pairs (Sequence[Tuple[K, V]]): A sequence of key-value pairs.
+        """
+
+    async def amset(self, key_value_pairs: Sequence[Tuple[K, V]]) -> None:
+        """Set the values for the given keys.
+
+        Args:
+            key_value_pairs (Sequence[Tuple[K, V]]): A sequence of key-value pairs.
+        """
+        return await run_in_executor(None, self.mset, key_value_pairs)
+
+    @abstractmethod
+    def mdelete(self, keys: Sequence[K]) -> None:
+        """Delete the given keys and their associated values.
+
+        Args:
+            keys (Sequence[K]): A sequence of keys to delete.
+        """
+
+    async def amdelete(self, keys: Sequence[K]) -> None:
+        """Delete the given keys and their associated values.
+
+        Args:
+            keys (Sequence[K]): A sequence of keys to delete.
+        """
+        return await run_in_executor(None, self.mdelete, keys)
+
+    @abstractmethod
+    def yield_keys(
+        self, *, prefix: Optional[str] = None
+    ) -> Union[Iterator[K], Iterator[str]]:
+        """Get an iterator over keys that match the given prefix.
+
+        Args:
+            prefix (str): The prefix to match.
+
+        Returns:
+            Iterator[K | str]: An iterator over keys that match the given prefix.
+
+            This method is allowed to return an iterator over either K or str
+            depending on what makes more sense for the given store.
+        """
+
+    async def ayield_keys(
+        self, *, prefix: Optional[str] = None
+    ) -> Union[AsyncIterator[K], AsyncIterator[str]]:
+        """Get an iterator over keys that match the given prefix.
+
+        Args:
+            prefix (str): The prefix to match.
+
+        Returns:
+            Iterator[K | str]: An iterator over keys that match the given prefix.
+
+            This method is allowed to return an iterator over either K or str
+            depending on what makes more sense for the given store.
+        """
+        iterator = await run_in_executor(None, self.yield_keys, prefix=prefix)
+        done = object()
+        while True:
+            item = await run_in_executor(None, lambda it: next(it, done), iterator)
+            if item is done:
+                break
+            yield item  # type: ignore[misc]
+
+
+ByteStore = BaseStore[str, bytes]
diff --git a/llm/Lib/site-packages/langchain_core/sys_info.py b/llm/Lib/site-packages/langchain_core/sys_info.py
new file mode 100644
index 0000000000000000000000000000000000000000..77def43ed4eb7a1b86133b2dfa21ef3d5ab0fcf1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/sys_info.py
@@ -0,0 +1,89 @@
+"""**sys_info** prints information about the system and langchain packages
+for debugging purposes.
+"""
+
+from typing import Sequence
+
+
+def print_sys_info(*, additional_pkgs: Sequence[str] = tuple()) -> None:
+    """Print information about the environment for debugging purposes."""
+    import pkgutil
+    import platform
+    import sys
+    from importlib import metadata, util
+
+    # Packages that do not start with "langchain" prefix.
+    other_langchain_packages = [
+        "langserve",
+        "langgraph",
+        "langsmith",
+    ]
+
+    langchain_pkgs = [
+        name for _, name, _ in pkgutil.iter_modules() if name.startswith("langchain")
+    ]
+
+    all_packages = sorted(
+        set(langchain_pkgs + other_langchain_packages + list(additional_pkgs))
+    )
+
+    # Always surface these packages to the top
+    order_by = ["langchain_core", "langchain", "langchain_community", "langsmith"]
+
+    for pkg in reversed(order_by):
+        if pkg in all_packages:
+            all_packages.remove(pkg)
+            all_packages = [pkg] + list(all_packages)
+
+    system_info = {
+        "OS": platform.system(),
+        "OS Version": platform.version(),
+        "Python Version": sys.version,
+    }
+    print()  # noqa: T201
+    print("System Information")  # noqa: T201
+    print("------------------")  # noqa: T201
+    print("> OS: ", system_info["OS"])  # noqa: T201
+    print("> OS Version: ", system_info["OS Version"])  # noqa: T201
+    print("> Python Version: ", system_info["Python Version"])  # noqa: T201
+
+    # Print out only langchain packages
+    print()  # noqa: T201
+    print("Package Information")  # noqa: T201
+    print("-------------------")  # noqa: T201
+
+    not_installed = []
+
+    for pkg in all_packages:
+        try:
+            found_package = util.find_spec(pkg)
+        except Exception:
+            found_package = None
+        if found_package is None:
+            not_installed.append(pkg)
+            continue
+
+        # Package version
+        try:
+            package_version = metadata.version(pkg)
+        except Exception:
+            package_version = None
+
+        # Print package with version
+        if package_version is not None:
+            print(f"> {pkg}: {package_version}")  # noqa: T201
+        else:
+            print(f"> {pkg}: Installed. No version info available.")  # noqa: T201
+
+    if not_installed:
+        print()  # noqa: T201
+        print("Packages not installed (Not Necessarily a Problem)")  # noqa: T201
+        print("--------------------------------------------------")  # noqa: T201
+        print("The following packages were not found:")  # noqa: T201
+        print()  # noqa: T201
+        for pkg in not_installed:
+            print(f"> {pkg}")  # noqa: T201
+
+
+if __name__ == "__main__":
+    print_sys_info()
diff --git a/llm/Lib/site-packages/langchain_core/tools.py b/llm/Lib/site-packages/langchain_core/tools.py
new file mode 100644
index 0000000000000000000000000000000000000000..8f10ce770f0a5ec1ee7c5090dfcc05a1312db032
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/tools.py
@@ -0,0 +1,1040 @@
+"""**Tools** are classes that an Agent uses to interact with the world.
+
+Each tool has a **description**. Agent uses the description to choose the right
+tool for the job.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    RunnableSerializable --> BaseTool --> <name>Tool  # Examples: AIPluginTool, BaseGraphQLTool
+                                          <name>      # Examples: BraveSearch, HumanInputRun
+
+**Main helpers:**
+
+.. code-block::
+
+    CallbackManagerForToolRun, AsyncCallbackManagerForToolRun
+"""  # noqa: E501
+
+from __future__ import annotations
+
+import inspect
+import uuid
+import warnings
+from abc import abstractmethod
+from functools import partial
+from inspect import signature
+from typing import Any, Awaitable, Callable, Dict, List, Optional, Tuple, Type, Union
+
+from langchain_core.callbacks import (
+    AsyncCallbackManager,
+    AsyncCallbackManagerForToolRun,
+    BaseCallbackManager,
+    CallbackManager,
+    CallbackManagerForToolRun,
+)
+from langchain_core.callbacks.manager import (
+    Callbacks,
+)
+from langchain_core.load.serializable import Serializable
+from langchain_core.prompts import (
+    BasePromptTemplate,
+    PromptTemplate,
+    aformat_document,
+    format_document,
+)
+from langchain_core.pydantic_v1 import (
+    BaseModel,
+    Extra,
+    Field,
+    ValidationError,
+    create_model,
+    root_validator,
+    validate_arguments,
+)
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.runnables import (
+    Runnable,
+    RunnableConfig,
+    RunnableSerializable,
+    ensure_config,
+)
+from langchain_core.runnables.config import run_in_executor
+
+
+class SchemaAnnotationError(TypeError):
+    """Raised when 'args_schema' is missing or has an incorrect type annotation."""
+
+
+def _create_subset_model(
+    name: str, model: Type[BaseModel], field_names: list
+) -> Type[BaseModel]:
+    """Create a pydantic model with only a subset of model's fields."""
+    fields = {}
+    for field_name in field_names:
+        field = model.__fields__[field_name]
+        t = (
+            # this isn't perfect but should work for most functions
+            field.outer_type_
+            if field.required and not field.allow_none
+            else Optional[field.outer_type_]
+        )
+        fields[field_name] = (t, field.field_info)
+    rtn = create_model(name, **fields)  # type: ignore
+    return rtn
+
+
+def _get_filtered_args(
+    inferred_model: Type[BaseModel],
+    func: Callable,
+) -> dict:
+    """Get the arguments from a function's signature."""
+    schema = inferred_model.schema()["properties"]
+    valid_keys = signature(func).parameters
+    return {k: schema[k] for k in valid_keys if k not in ("run_manager", "callbacks")}
+
+
+class _SchemaConfig:
+    """Configuration for the pydantic model."""
+
+    extra: Any = Extra.forbid
+    arbitrary_types_allowed: bool = True
+
+
+def create_schema_from_function(
+    model_name: str,
+    func: Callable,
+) -> Type[BaseModel]:
+    """Create a pydantic schema from a function's signature.
+    Args:
+        model_name: Name to assign to the generated pydandic schema
+        func: Function to generate the schema from
+    Returns:
+        A pydantic model with the same arguments as the function
+    """
+    # https://docs.pydantic.dev/latest/usage/validation_decorator/
+    validated = validate_arguments(func, config=_SchemaConfig)  # type: ignore
+    inferred_model = validated.model  # type: ignore
+    if "run_manager" in inferred_model.__fields__:
+        del inferred_model.__fields__["run_manager"]
+    if "callbacks" in inferred_model.__fields__:
+        del inferred_model.__fields__["callbacks"]
+    # Pydantic adds placeholder virtual fields we need to strip
+    valid_properties = _get_filtered_args(inferred_model, func)
+    return _create_subset_model(
+        f"{model_name}Schema", inferred_model, list(valid_properties)
+    )
+
+
+class ToolException(Exception):
+    """Optional exception that tool throws when execution error occurs.
+
+    When this exception is thrown, the agent will not stop working,
+    but it will handle the exception according to the handle_tool_error
+    variable of the tool, and the processing result will be returned
+    to the agent as observation, and printed in red on the console.
+    """
+
+    pass
+
+
+class BaseTool(RunnableSerializable[Union[str, Dict], Any]):
+    """Interface LangChain tools must implement."""
+
+    def __init_subclass__(cls, **kwargs: Any) -> None:
+        """Create the definition of the new tool class."""
+        super().__init_subclass__(**kwargs)
+
+        args_schema_type = cls.__annotations__.get("args_schema", None)
+
+        if args_schema_type is not None and args_schema_type == BaseModel:
+            # Throw errors for common mis-annotations.
+            # TODO: Use get_args / get_origin and fully
+            # specify valid annotations.
+            typehint_mandate = """
+class ChildTool(BaseTool):
+    ...
+    args_schema: Type[BaseModel] = SchemaClass
+    ..."""
+            name = cls.__name__
+            raise SchemaAnnotationError(
+                f"Tool definition for {name} must include valid type annotations"
+                f" for argument 'args_schema' to behave as expected.\n"
+                f"Expected annotation of 'Type[BaseModel]'"
+                f" but got '{args_schema_type}'.\n"
+                f"Expected class looks like:\n"
+                f"{typehint_mandate}"
+            )
+
+    name: str
+    """The unique name of the tool that clearly communicates its purpose."""
+    description: str
+    """Used to tell the model how/when/why to use the tool.
+    
+    You can provide few-shot examples as a part of the description.
+    """
+    args_schema: Optional[Type[BaseModel]] = None
+    """Pydantic model class to validate and parse the tool's input arguments."""
+    return_direct: bool = False
+    """Whether to return the tool's output directly. Setting this to True means
+    
+    that after the tool is called, the AgentExecutor will stop looping.
+    """
+    verbose: bool = False
+    """Whether to log the tool's progress."""
+
+    callbacks: Callbacks = Field(default=None, exclude=True)
+    """Callbacks to be called during tool execution."""
+    callback_manager: Optional[BaseCallbackManager] = Field(default=None, exclude=True)
+    """Deprecated. Please use callbacks instead."""
+    tags: Optional[List[str]] = None
+    """Optional list of tags associated with the tool. Defaults to None
+    These tags will be associated with each call to this tool,
+    and passed as arguments to the handlers defined in `callbacks`.
+    You can use these to eg identify a specific instance of a tool with its use case.
+    """
+    metadata: Optional[Dict[str, Any]] = None
+    """Optional metadata associated with the tool. Defaults to None
+    This metadata will be associated with each call to this tool,
+    and passed as arguments to the handlers defined in `callbacks`.
+    You can use these to eg identify a specific instance of a tool with its use case.
+    """
+
+    handle_tool_error: Optional[
+        Union[bool, str, Callable[[ToolException], str]]
+    ] = False
+    """Handle the content of the ToolException thrown."""
+
+    handle_validation_error: Optional[
+        Union[bool, str, Callable[[ValidationError], str]]
+    ] = False
+    """Handle the content of the ValidationError thrown."""
+
+    class Config(Serializable.Config):
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @property
+    def is_single_input(self) -> bool:
+        """Whether the tool only accepts a single input."""
+        keys = {k for k in self.args if k != "kwargs"}
+        return len(keys) == 1
+
+    @property
+    def args(self) -> dict:
+        if self.args_schema is not None:
+            return self.args_schema.schema()["properties"]
+        else:
+            schema = create_schema_from_function(self.name, self._run)
+            return schema.schema()["properties"]
+
+    # --- Runnable ---
+
+    def get_input_schema(
+        self, config: Optional[RunnableConfig] = None
+    ) -> Type[BaseModel]:
+        """The tool's input schema."""
+        if self.args_schema is not None:
+            return self.args_schema
+        else:
+            return create_schema_from_function(self.name, self._run)
+
+    def invoke(
+        self,
+        input: Union[str, Dict],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Any:
+        config = ensure_config(config)
+        return self.run(
+            input,
+            callbacks=config.get("callbacks"),
+            tags=config.get("tags"),
+            metadata=config.get("metadata"),
+            run_name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+            **kwargs,
+        )
+
+    async def ainvoke(
+        self,
+        input: Union[str, Dict],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Any:
+        config = ensure_config(config)
+        return await self.arun(
+            input,
+            callbacks=config.get("callbacks"),
+            tags=config.get("tags"),
+            metadata=config.get("metadata"),
+            run_name=config.get("run_name"),
+            run_id=config.pop("run_id", None),
+            **kwargs,
+        )
+
+    # --- Tool ---
+
+    def _parse_input(
+        self,
+        tool_input: Union[str, Dict],
+    ) -> Union[str, Dict[str, Any]]:
+        """Convert tool input to pydantic model."""
+        input_args = self.args_schema
+        if isinstance(tool_input, str):
+            if input_args is not None:
+                key_ = next(iter(input_args.__fields__.keys()))
+                input_args.validate({key_: tool_input})
+            return tool_input
+        else:
+            if input_args is not None:
+                result = input_args.parse_obj(tool_input)
+                return {
+                    k: getattr(result, k)
+                    for k, v in result.dict().items()
+                    if k in tool_input
+                }
+        return tool_input
+
+    @root_validator()
+    def raise_deprecation(cls, values: Dict) -> Dict:
+        """Raise deprecation warning if callback_manager is used."""
+        if values.get("callback_manager") is not None:
+            warnings.warn(
+                "callback_manager is deprecated. Please use callbacks instead.",
+                DeprecationWarning,
+            )
+            values["callbacks"] = values.pop("callback_manager", None)
+        return values
+
+    @abstractmethod
+    def _run(
+        self,
+        *args: Any,
+        **kwargs: Any,
+    ) -> Any:
+        """Use the tool.
+
+        Add run_manager: Optional[CallbackManagerForToolRun] = None
+        to child implementations to enable tracing,
+        """
+
+    async def _arun(
+        self,
+        *args: Any,
+        **kwargs: Any,
+    ) -> Any:
+        """Use the tool asynchronously.
+
+        Add run_manager: Optional[AsyncCallbackManagerForToolRun] = None
+        to child implementations to enable tracing,
+        """
+        return await run_in_executor(None, self._run, *args, **kwargs)
+
+    def _to_args_and_kwargs(self, tool_input: Union[str, Dict]) -> Tuple[Tuple, Dict]:
+        # For backwards compatibility, if run_input is a string,
+        # pass as a positional argument.
+        if isinstance(tool_input, str):
+            return (tool_input,), {}
+        else:
+            return (), tool_input
+
+    def run(
+        self,
+        tool_input: Union[str, Dict[str, Any]],
+        verbose: Optional[bool] = None,
+        start_color: Optional[str] = "green",
+        color: Optional[str] = "green",
+        callbacks: Callbacks = None,
+        *,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        run_name: Optional[str] = None,
+        run_id: Optional[uuid.UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run the tool."""
+        if not self.verbose and verbose is not None:
+            verbose_ = verbose
+        else:
+            verbose_ = self.verbose
+        callback_manager = CallbackManager.configure(
+            callbacks,
+            self.callbacks,
+            verbose_,
+            tags,
+            self.tags,
+            metadata,
+            self.metadata,
+        )
+        # TODO: maybe also pass through run_manager is _run supports kwargs
+        new_arg_supported = signature(self._run).parameters.get("run_manager")
+        run_manager = callback_manager.on_tool_start(
+            {"name": self.name, "description": self.description},
+            tool_input if isinstance(tool_input, str) else str(tool_input),
+            color=start_color,
+            name=run_name,
+            run_id=run_id,
+            # Inputs by definition should always be dicts.
+            # For now, it's unclear whether this assumption is ever violated,
+            # but if it is we will send a `None` value to the callback instead
+            # And will need to address issue via a patch.
+            inputs=None if isinstance(tool_input, str) else tool_input,
+            **kwargs,
+        )
+        try:
+            parsed_input = self._parse_input(tool_input)
+            tool_args, tool_kwargs = self._to_args_and_kwargs(parsed_input)
+            observation = (
+                self._run(*tool_args, run_manager=run_manager, **tool_kwargs)
+                if new_arg_supported
+                else self._run(*tool_args, **tool_kwargs)
+            )
+        except ValidationError as e:
+            if not self.handle_validation_error:
+                raise e
+            elif isinstance(self.handle_validation_error, bool):
+                observation = "Tool input validation error"
+            elif isinstance(self.handle_validation_error, str):
+                observation = self.handle_validation_error
+            elif callable(self.handle_validation_error):
+                observation = self.handle_validation_error(e)
+            else:
+                raise ValueError(
+                    f"Got unexpected type of `handle_validation_error`. Expected bool, "
+                    f"str or callable. Received: {self.handle_validation_error}"
+                )
+            return observation
+        except ToolException as e:
+            if not self.handle_tool_error:
+                run_manager.on_tool_error(e)
+                raise e
+            elif isinstance(self.handle_tool_error, bool):
+                if e.args:
+                    observation = e.args[0]
+                else:
+                    observation = "Tool execution error"
+            elif isinstance(self.handle_tool_error, str):
+                observation = self.handle_tool_error
+            elif callable(self.handle_tool_error):
+                observation = self.handle_tool_error(e)
+            else:
+                raise ValueError(
+                    f"Got unexpected type of `handle_tool_error`. Expected bool, str "
+                    f"or callable. Received: {self.handle_tool_error}"
+                )
+            run_manager.on_tool_end(observation, color="red", name=self.name, **kwargs)
+            return observation
+        except (Exception, KeyboardInterrupt) as e:
+            run_manager.on_tool_error(e)
+            raise e
+        else:
+            run_manager.on_tool_end(observation, color=color, name=self.name, **kwargs)
+            return observation
+
+    async def arun(
+        self,
+        tool_input: Union[str, Dict],
+        verbose: Optional[bool] = None,
+        start_color: Optional[str] = "green",
+        color: Optional[str] = "green",
+        callbacks: Callbacks = None,
+        *,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        run_name: Optional[str] = None,
+        run_id: Optional[uuid.UUID] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Run the tool asynchronously."""
+        if not self.verbose and verbose is not None:
+            verbose_ = verbose
+        else:
+            verbose_ = self.verbose
+        callback_manager = AsyncCallbackManager.configure(
+            callbacks,
+            self.callbacks,
+            verbose_,
+            tags,
+            self.tags,
+            metadata,
+            self.metadata,
+        )
+        new_arg_supported = signature(self._arun).parameters.get("run_manager")
+        run_manager = await callback_manager.on_tool_start(
+            {"name": self.name, "description": self.description},
+            tool_input if isinstance(tool_input, str) else str(tool_input),
+            color=start_color,
+            name=run_name,
+            inputs=tool_input,
+            run_id=run_id,
+            **kwargs,
+        )
+        try:
+            parsed_input = self._parse_input(tool_input)
+            # We then call the tool on the tool input to get an observation
+            tool_args, tool_kwargs = self._to_args_and_kwargs(parsed_input)
+            observation = (
+                await self._arun(*tool_args, run_manager=run_manager, **tool_kwargs)
+                if new_arg_supported
+                else await self._arun(*tool_args, **tool_kwargs)
+            )
+        except ValidationError as e:
+            if not self.handle_validation_error:
+                raise e
+            elif isinstance(self.handle_validation_error, bool):
+                observation = "Tool input validation error"
+            elif isinstance(self.handle_validation_error, str):
+                observation = self.handle_validation_error
+            elif callable(self.handle_validation_error):
+                observation = self.handle_validation_error(e)
+            else:
+                raise ValueError(
+                    f"Got unexpected type of `handle_validation_error`. Expected bool, "
+                    f"str or callable. Received: {self.handle_validation_error}"
+                )
+            return observation
+        except ToolException as e:
+            if not self.handle_tool_error:
+                await run_manager.on_tool_error(e)
+                raise e
+            elif isinstance(self.handle_tool_error, bool):
+                if e.args:
+                    observation = e.args[0]
+                else:
+                    observation = "Tool execution error"
+            elif isinstance(self.handle_tool_error, str):
+                observation = self.handle_tool_error
+            elif callable(self.handle_tool_error):
+                observation = self.handle_tool_error(e)
+            else:
+                raise ValueError(
+                    f"Got unexpected type of `handle_tool_error`. Expected bool, str "
+                    f"or callable. Received: {self.handle_tool_error}"
+                )
+            await run_manager.on_tool_end(
+                observation, color="red", name=self.name, **kwargs
+            )
+            return observation
+        except (Exception, KeyboardInterrupt) as e:
+            await run_manager.on_tool_error(e)
+            raise e
+        else:
+            await run_manager.on_tool_end(
+                observation, color=color, name=self.name, **kwargs
+            )
+            return observation
+
+    def __call__(self, tool_input: str, callbacks: Callbacks = None) -> str:
+        """Make tool callable."""
+        return self.run(tool_input, callbacks=callbacks)
+
+
+class Tool(BaseTool):
+    """Tool that takes in function or coroutine directly."""
+
+    description: str = ""
+    func: Optional[Callable[..., str]]
+    """The function to run when the tool is called."""
+    coroutine: Optional[Callable[..., Awaitable[str]]] = None
+    """The asynchronous version of the function."""
+
+    # --- Runnable ---
+
+    async def ainvoke(
+        self,
+        input: Union[str, Dict],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if not self.coroutine:
+            # If the tool does not implement async, fall back to default implementation
+            return await run_in_executor(config, self.invoke, input, config, **kwargs)
+
+        return await super().ainvoke(input, config, **kwargs)
+
+    # --- Tool ---
+
+    @property
+    def args(self) -> dict:
+        """The tool's input arguments."""
+        if self.args_schema is not None:
+            return self.args_schema.schema()["properties"]
+        # For backwards compatibility, if the function signature is ambiguous,
+        # assume it takes a single string input.
+        return {"tool_input": {"type": "string"}}
+
+    def _to_args_and_kwargs(self, tool_input: Union[str, Dict]) -> Tuple[Tuple, Dict]:
+        """Convert tool input to pydantic model."""
+        args, kwargs = super()._to_args_and_kwargs(tool_input)
+        # For backwards compatibility. The tool must be run with a single input
+        all_args = list(args) + list(kwargs.values())
+        if len(all_args) != 1:
+            raise ToolException(
+                f"""Too many arguments to single-input tool {self.name}.
+                Consider using StructuredTool instead."""
+                f" Args: {all_args}"
+            )
+        return tuple(all_args), {}
+
+    def _run(
+        self,
+        *args: Any,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Use the tool."""
+        if self.func:
+            new_argument_supported = signature(self.func).parameters.get("callbacks")
+            return (
+                self.func(
+                    *args,
+                    callbacks=run_manager.get_child() if run_manager else None,
+                    **kwargs,
+                )
+                if new_argument_supported
+                else self.func(*args, **kwargs)
+            )
+        raise NotImplementedError("Tool does not support sync")
+
+    async def _arun(
+        self,
+        *args: Any,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Use the tool asynchronously."""
+        if self.coroutine:
+            new_argument_supported = signature(self.coroutine).parameters.get(
+                "callbacks"
+            )
+            return (
+                await self.coroutine(
+                    *args,
+                    callbacks=run_manager.get_child() if run_manager else None,
+                    **kwargs,
+                )
+                if new_argument_supported
+                else await self.coroutine(*args, **kwargs)
+            )
+        else:
+            return await run_in_executor(
+                None,
+                self._run,
+                run_manager=run_manager.get_sync() if run_manager else None,
+                *args,
+                **kwargs,
+            )
+
+    # TODO: this is for backwards compatibility, remove in future
+    def __init__(
+        self, name: str, func: Optional[Callable], description: str, **kwargs: Any
+    ) -> None:
+        """Initialize tool."""
+        super(Tool, self).__init__(  # type: ignore[call-arg]
+            name=name, func=func, description=description, **kwargs
+        )
+
+    @classmethod
+    def from_function(
+        cls,
+        func: Optional[Callable],
+        name: str,  # We keep these required to support backwards compatibility
+        description: str,
+        return_direct: bool = False,
+        args_schema: Optional[Type[BaseModel]] = None,
+        coroutine: Optional[
+            Callable[..., Awaitable[Any]]
+        ] = None,  # This is last for compatibility, but should be after func
+        **kwargs: Any,
+    ) -> Tool:
+        """Initialize tool from a function."""
+        if func is None and coroutine is None:
+            raise ValueError("Function and/or coroutine must be provided")
+        return cls(
+            name=name,
+            func=func,
+            coroutine=coroutine,
+            description=description,
+            return_direct=return_direct,
+            args_schema=args_schema,
+            **kwargs,
+        )
+
+
+class StructuredTool(BaseTool):
+    """Tool that can operate on any number of inputs."""
+
+    description: str = ""
+    args_schema: Type[BaseModel] = Field(..., description="The tool schema.")
+    """The input arguments' schema."""
+    func: Optional[Callable[..., Any]]
+    """The function to run when the tool is called."""
+    coroutine: Optional[Callable[..., Awaitable[Any]]] = None
+    """The asynchronous version of the function."""
+
+    # --- Runnable ---
+
+    async def ainvoke(
+        self,
+        input: Union[str, Dict],
+        config: Optional[RunnableConfig] = None,
+        **kwargs: Any,
+    ) -> Any:
+        if not self.coroutine:
+            # If the tool does not implement async, fall back to default implementation
+            return await run_in_executor(config, self.invoke, input, config, **kwargs)
+
+        return await super().ainvoke(input, config, **kwargs)
+
+    # --- Tool ---
+
+    @property
+    def args(self) -> dict:
+        """The tool's input arguments."""
+        return self.args_schema.schema()["properties"]
+
+    def _run(
+        self,
+        *args: Any,
+        run_manager: Optional[CallbackManagerForToolRun] = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Use the tool."""
+        if self.func:
+            new_argument_supported = signature(self.func).parameters.get("callbacks")
+            return (
+                self.func(
+                    *args,
+                    callbacks=run_manager.get_child() if run_manager else None,
+                    **kwargs,
+                )
+                if new_argument_supported
+                else self.func(*args, **kwargs)
+            )
+        raise NotImplementedError("Tool does not support sync")
+
+    async def _arun(
+        self,
+        *args: Any,
+        run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
+        **kwargs: Any,
+    ) -> str:
+        """Use the tool asynchronously."""
+        if self.coroutine:
+            new_argument_supported = signature(self.coroutine).parameters.get(
+                "callbacks"
+            )
+            return (
+                await self.coroutine(
+                    *args,
+                    callbacks=run_manager.get_child() if run_manager else None,
+                    **kwargs,
+                )
+                if new_argument_supported
+                else await self.coroutine(*args, **kwargs)
+            )
+        return await run_in_executor(
+            None,
+            self._run,
+            run_manager=run_manager.get_sync() if run_manager else None,
+            *args,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_function(
+        cls,
+        func: Optional[Callable] = None,
+        coroutine: Optional[Callable[..., Awaitable[Any]]] = None,
+        name: Optional[str] = None,
+        description: Optional[str] = None,
+        return_direct: bool = False,
+        args_schema: Optional[Type[BaseModel]] = None,
+        infer_schema: bool = True,
+        **kwargs: Any,
+    ) -> StructuredTool:
+        """Create tool from a given function.
+
+        A classmethod that helps to create a tool from a function.
+
+        Args:
+            func: The function from which to create a tool
+            coroutine: The async function from which to create a tool
+            name: The name of the tool. Defaults to the function name
+            description: The description of the tool. Defaults to the function docstring
+            return_direct: Whether to return the result directly or as a callback
+            args_schema: The schema of the tool's input arguments
+            infer_schema: Whether to infer the schema from the function's signature
+            **kwargs: Additional arguments to pass to the tool
+
+        Returns:
+            The tool
+
+        Examples:
+
+            .. code-block:: python
+
+                def add(a: int, b: int) -> int:
+                    \"\"\"Add two numbers\"\"\"
+                    return a + b
+                tool = StructuredTool.from_function(add)
+                tool.run(1, 2) # 3
+        """
+
+        if func is not None:
+            source_function = func
+        elif coroutine is not None:
+            source_function = coroutine
+        else:
+            raise ValueError("Function and/or coroutine must be provided")
+        name = name or source_function.__name__
+        description = description or source_function.__doc__
+        if description is None:
+            raise ValueError(
+                "Function must have a docstring if description not provided."
+            )
+
+        # Description example:
+        # search_api(query: str) - Searches the API for the query.
+        sig = signature(source_function)
+        description = f"{name}{sig} - {description.strip()}"
+        _args_schema = args_schema
+        if _args_schema is None and infer_schema:
+            # schema name is appended within function
+            _args_schema = create_schema_from_function(name, source_function)
+        return cls(
+            name=name,
+            func=func,
+            coroutine=coroutine,
+            args_schema=_args_schema,  # type: ignore[arg-type]
+            description=description,
+            return_direct=return_direct,
+            **kwargs,
+        )
+
+
+def tool(
+    *args: Union[str, Callable, Runnable],
+    return_direct: bool = False,
+    args_schema: Optional[Type[BaseModel]] = None,
+    infer_schema: bool = True,
+) -> Callable:
+    """Make tools out of functions, can be used with or without arguments.
+
+    Args:
+        *args: The arguments to the tool.
+        return_direct: Whether to return directly from the tool rather
+            than continuing the agent loop.
+        args_schema: optional argument schema for user to specify
+        infer_schema: Whether to infer the schema of the arguments from
+            the function's signature. This also makes the resultant tool
+            accept a dictionary input to its `run()` function.
+
+    Requires:
+        - Function must be of type (str) -> str
+        - Function must have a docstring
+
+    Examples:
+        .. code-block:: python
+
+            @tool
+            def search_api(query: str) -> str:
+                # Searches the API for the query.
+                return
+
+            @tool("search", return_direct=True)
+            def search_api(query: str) -> str:
+                # Searches the API for the query.
+                return
+    """
+
+    def _make_with_name(tool_name: str) -> Callable:
+        def _make_tool(dec_func: Union[Callable, Runnable]) -> BaseTool:
+            if isinstance(dec_func, Runnable):
+                runnable = dec_func
+
+                if runnable.input_schema.schema().get("type") != "object":
+                    raise ValueError("Runnable must have an object schema.")
+
+                async def ainvoke_wrapper(
+                    callbacks: Optional[Callbacks] = None, **kwargs: Any
+                ) -> Any:
+                    return await runnable.ainvoke(kwargs, {"callbacks": callbacks})
+
+                def invoke_wrapper(
+                    callbacks: Optional[Callbacks] = None, **kwargs: Any
+                ) -> Any:
+                    return runnable.invoke(kwargs, {"callbacks": callbacks})
+
+                coroutine = ainvoke_wrapper
+                func = invoke_wrapper
+                schema: Optional[Type[BaseModel]] = runnable.input_schema
+                description = repr(runnable)
+            elif inspect.iscoroutinefunction(dec_func):
+                coroutine = dec_func
+                func = None
+                schema = args_schema
+                description = None
+            else:
+                coroutine = None
+                func = dec_func
+                schema = args_schema
+                description = None
+
+            if infer_schema or args_schema is not None:
+                return StructuredTool.from_function(
+                    func,
+                    coroutine,
+                    name=tool_name,
+                    description=description,
+                    return_direct=return_direct,
+                    args_schema=schema,
+                    infer_schema=infer_schema,
+                )
+            # If someone doesn't want a schema applied, we must treat it as
+            # a simple string->string function
+            if func.__doc__ is None:
+                raise ValueError(
+                    "Function must have a docstring if "
+                    "description not provided and infer_schema is False."
+                )
+            return Tool(
+                name=tool_name,
+                func=func,
+                description=f"{tool_name} tool",
+                return_direct=return_direct,
+                coroutine=coroutine,
+            )
+
+        return _make_tool
+
+    if len(args) == 2 and isinstance(args[0], str) and isinstance(args[1], Runnable):
+        return _make_with_name(args[0])(args[1])
+    elif len(args) == 1 and isinstance(args[0], str):
+        # if the argument is a string, then we use the string as the tool name
+        # Example usage: @tool("search", return_direct=True)
+        return _make_with_name(args[0])
+    elif len(args) == 1 and callable(args[0]):
+        # if the argument is a function, then we use the function name as the tool name
+        # Example usage: @tool
+        return _make_with_name(args[0].__name__)(args[0])
+    elif len(args) == 0:
+        # if there are no arguments, then we use the function name as the tool name
+        # Example usage: @tool(return_direct=True)
+        def _partial(func: Callable[[str], str]) -> BaseTool:
+            return _make_with_name(func.__name__)(func)
+
+        return _partial
+    else:
+        raise ValueError("Too many arguments for tool decorator")
+
+
+class RetrieverInput(BaseModel):
+    """Input to the retriever."""
+
+    query: str = Field(description="query to look up in retriever")
+
+
+def _get_relevant_documents(
+    query: str,
+    retriever: BaseRetriever,
+    document_prompt: BasePromptTemplate,
+    document_separator: str,
+    callbacks: Callbacks = None,
+) -> str:
+    docs = retriever.get_relevant_documents(query, callbacks=callbacks)
+    return document_separator.join(
+        format_document(doc, document_prompt) for doc in docs
+    )
+
+
+async def _aget_relevant_documents(
+    query: str,
+    retriever: BaseRetriever,
+    document_prompt: BasePromptTemplate,
+    document_separator: str,
+    callbacks: Callbacks = None,
+) -> str:
+    docs = await retriever.aget_relevant_documents(query, callbacks=callbacks)
+    return document_separator.join(
+        [await aformat_document(doc, document_prompt) for doc in docs]
+    )
+
+
+def create_retriever_tool(
+    retriever: BaseRetriever,
+    name: str,
+    description: str,
+    *,
+    document_prompt: Optional[BasePromptTemplate] = None,
+    document_separator: str = "\n\n",
+) -> Tool:
+    """Create a tool to do retrieval of documents.
+
+    Args:
+        retriever: The retriever to use for the retrieval
+        name: The name for the tool. This will be passed to the language model,
+            so should be unique and somewhat descriptive.
+        description: The description for the tool. This will be passed to the language
+            model, so should be descriptive.
+
+    Returns:
+        Tool class to pass to an agent
+    """
+    document_prompt = document_prompt or PromptTemplate.from_template("{page_content}")
+    func = partial(
+        _get_relevant_documents,
+        retriever=retriever,
+        document_prompt=document_prompt,
+        document_separator=document_separator,
+    )
+    afunc = partial(
+        _aget_relevant_documents,
+        retriever=retriever,
+        document_prompt=document_prompt,
+        document_separator=document_separator,
+    )
+    return Tool(
+        name=name,
+        description=description,
+        func=func,
+        coroutine=afunc,
+        args_schema=RetrieverInput,
+    )
+
+
+ToolsRenderer = Callable[[List[BaseTool]], str]
+
+
+def render_text_description(tools: List[BaseTool]) -> str:
+    """Render the tool name and description in plain text.
+
+    Output will be in the format of:
+
+    .. code-block:: markdown
+
+        search: This tool is used for search
+        calculator: This tool is used for math
+    """
+    return "\n".join([f"{tool.name}: {tool.description}" for tool in tools])
+
+
+def render_text_description_and_args(tools: List[BaseTool]) -> str:
+    """Render the tool name, description, and args in plain text.
+
+    Output will be in the format of:
+
+    .. code-block:: markdown
+
+        search: This tool is used for search, args: {"query": {"type": "string"}}
+        calculator: This tool is used for math, \
+args: {"expression": {"type": "string"}}
+    """
+    tool_strings = []
+    for tool in tools:
+        args_schema = str(tool.args)
+        tool_strings.append(f"{tool.name}: {tool.description}, args: {args_schema}")
+    return "\n".join(tool_strings)
diff --git a/llm/Lib/site-packages/langchain_core/tracers/__init__.py b/llm/Lib/site-packages/langchain_core/tracers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..05440d395a702a9e3d6f9b15f9f4b812e1ce91c2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/tracers/__init__.py
@@ -0,0 +1,31 @@
+"""**Tracers** are classes for tracing runs.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    BaseCallbackHandler --> BaseTracer --> <name>Tracer  # Examples: LangChainTracer, RootListenersTracer
+                                       --> <name>  # Examples: LogStreamCallbackHandler
+"""  # noqa: E501
+
+__all__ = [
+    "BaseTracer",
+    "EvaluatorCallbackHandler",
+    "LangChainTracer",
+    "ConsoleCallbackHandler",
+    "Run",
+    "RunLog",
+    "RunLogPatch",
+    "LogStreamCallbackHandler",
+]
+
+from langchain_core.tracers.base import BaseTracer
+from langchain_core.tracers.evaluation import EvaluatorCallbackHandler
+from langchain_core.tracers.langchain import LangChainTracer
+from langchain_core.tracers.log_stream import (
+    LogStreamCallbackHandler,
+    RunLog,
+    RunLogPatch,
+)
+from langchain_core.tracers.schemas import Run
+from langchain_core.tracers.stdout import ConsoleCallbackHandler
diff --git a/llm/Lib/site-packages/langchain_core/tracers/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a9261fdeeeb3d347c08e671f7050e8cfcf13a345
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/tracers/__pycache__/base.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/base.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..abfad811112a8b2d90ac9985899987e3d6279f3a
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/base.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/tracers/__pycache__/context.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/context.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..dd1d4b9e3143b2c72839431bbe86042a94db7f90
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/context.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/tracers/__pycache__/evaluation.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/evaluation.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..460e7dceff9d956de0c21ef55eafb231aec4b98f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/evaluation.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/tracers/__pycache__/langchain.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/langchain.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..eaca37ac3331eb7c9420c9b51ff818f3486a827e
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/langchain.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/tracers/__pycache__/langchain_v1.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/langchain_v1.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3ae61e05921fb5291f2dea45185c701d1ea316be
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/langchain_v1.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/tracers/__pycache__/log_stream.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/log_stream.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4ef799daaa834b8d1ef670156c6c4d70d1b915a7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/log_stream.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/tracers/__pycache__/memory_stream.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/memory_stream.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..fbf2b14b0944fc2780808ed4026b07bd830847b9
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/memory_stream.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/tracers/__pycache__/root_listeners.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/root_listeners.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..17b6361eb2b16dda996b427034202948bb450c93
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/root_listeners.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/tracers/__pycache__/run_collector.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/run_collector.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4a2120e06f79efc5a349817137000db6dcbead56
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/run_collector.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/tracers/__pycache__/schemas.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/schemas.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4beef70a3561eeb3ef19983a39962014355953c6
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/schemas.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/tracers/__pycache__/stdout.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/stdout.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..9dc2a7c355e97ce7280130f240a6ee2ae052750b
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/tracers/__pycache__/stdout.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/tracers/base.py b/llm/Lib/site-packages/langchain_core/tracers/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..cdecedb09df991473ea00d70b6adbfa1d1eefbec
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/tracers/base.py
@@ -0,0 +1,657 @@
+"""Base interfaces for tracing runs."""
+from __future__ import annotations
+
+import logging
+import sys
+import traceback
+from abc import ABC, abstractmethod
+from datetime import datetime, timezone
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    Sequence,
+    Set,
+    Union,
+    cast,
+)
+from uuid import UUID
+
+from tenacity import RetryCallState
+
+from langchain_core.callbacks.base import BaseCallbackHandler
+from langchain_core.exceptions import TracerException
+from langchain_core.load import dumpd
+from langchain_core.messages import BaseMessage
+from langchain_core.outputs import (
+    ChatGeneration,
+    ChatGenerationChunk,
+    GenerationChunk,
+    LLMResult,
+)
+from langchain_core.tracers.schemas import Run
+
+if TYPE_CHECKING:
+    from langchain_core.documents import Document
+
+logger = logging.getLogger(__name__)
+
+
+class BaseTracer(BaseCallbackHandler, ABC):
+    """Base interface for tracers."""
+
+    def __init__(
+        self,
+        *,
+        _schema_format: Literal["original", "streaming_events"] = "original",
+        **kwargs: Any,
+    ) -> None:
+        """Initialize the tracer.
+
+        Args:
+            _schema_format: Primarily changes how the inputs and outputs are
+                handled. For internal use only. This API will change.
+                - 'original' is the format used by all current tracers.
+                   This format is slightly inconsistent with respect to inputs
+                   and outputs.
+                - 'streaming_events' is used for supporting streaming events,
+                   for internal usage. It will likely change in the future, or
+                   be deprecated entirely in favor of a dedicated async tracer
+                   for streaming events.
+            kwargs: Additional keyword arguments that will be passed to
+                    the super class.
+        """
+        super().__init__(**kwargs)
+        self._schema_format = _schema_format  # For internal use only API will change.
+        self.run_map: Dict[str, Run] = {}
+
+    @staticmethod
+    def _add_child_run(
+        parent_run: Run,
+        child_run: Run,
+    ) -> None:
+        """Add child run to a chain run or tool run."""
+        parent_run.child_runs.append(child_run)
+
+    @abstractmethod
+    def _persist_run(self, run: Run) -> None:
+        """Persist a run."""
+
+    @staticmethod
+    def _get_stacktrace(error: BaseException) -> str:
+        """Get the stacktrace of the parent error."""
+        msg = repr(error)
+        try:
+            if sys.version_info < (3, 10):
+                tb = traceback.format_exception(
+                    error.__class__, error, error.__traceback__
+                )
+            else:
+                tb = traceback.format_exception(error)
+            return (msg + "\n\n".join(tb)).strip()
+        except:  # noqa: E722
+            return msg
+
+    def _start_trace(self, run: Run) -> None:
+        """Start a trace for a run."""
+        current_dotted_order = run.start_time.strftime("%Y%m%dT%H%M%S%fZ") + str(run.id)
+        if run.parent_run_id:
+            parent_run = self.run_map.get(str(run.parent_run_id))
+            if parent_run:
+                self._add_child_run(parent_run, run)
+                parent_run.child_execution_order = max(
+                    parent_run.child_execution_order, run.child_execution_order
+                )
+                run.trace_id = parent_run.trace_id
+                if parent_run.dotted_order:
+                    run.dotted_order = (
+                        parent_run.dotted_order + "." + current_dotted_order
+                    )
+                else:
+                    # Something wrong with tracer parent run has no dotted_order
+                    logger.debug(
+                        f"Parent run with UUID {run.parent_run_id} has no dotted_order."
+                    )
+            else:
+                # Something wrong with tracer, parent run not found
+                # Calculate the trace_id and dotted_order server side
+                logger.debug(f"Parent run with UUID {run.parent_run_id} not found.")
+        else:
+            run.trace_id = run.id
+            run.dotted_order = current_dotted_order
+        self.run_map[str(run.id)] = run
+        self._on_run_create(run)
+
+    def _end_trace(self, run: Run) -> None:
+        """End a trace for a run."""
+        if not run.parent_run_id:
+            self._persist_run(run)
+        else:
+            parent_run = self.run_map.get(str(run.parent_run_id))
+            if parent_run is None:
+                logger.debug(f"Parent run with UUID {run.parent_run_id} not found.")
+            elif (
+                run.child_execution_order is not None
+                and parent_run.child_execution_order is not None
+                and run.child_execution_order > parent_run.child_execution_order
+            ):
+                parent_run.child_execution_order = run.child_execution_order
+        self.run_map.pop(str(run.id))
+        self._on_run_update(run)
+
+    def _get_execution_order(self, parent_run_id: Optional[str] = None) -> int:
+        """Get the execution order for a run."""
+        if parent_run_id is None:
+            return 1
+
+        parent_run = self.run_map.get(parent_run_id)
+        if parent_run is None:
+            logger.debug(f"Parent run with UUID {parent_run_id} not found.")
+            return 1
+        if parent_run.child_execution_order is None:
+            raise TracerException(
+                f"Parent run with UUID {parent_run_id} has no child execution order."
+            )
+
+        return parent_run.child_execution_order + 1
+
+    def _get_run(
+        self, run_id: UUID, run_type: Union[str, Set[str], None] = None
+    ) -> Run:
+        try:
+            run = self.run_map[str(run_id)]
+        except KeyError as exc:
+            raise TracerException(f"No indexed run ID {run_id}.") from exc
+
+        if isinstance(run_type, str):
+            run_types: Union[Set[str], None] = {run_type}
+        else:
+            run_types = run_type
+        if run_types is not None and run.run_type not in run_types:
+            raise TracerException(
+                f"Found {run.run_type} run at ID {run_id}, "
+                f"but expected {run_types} run."
+            )
+        return run
+
+    def on_chat_model_start(
+        self,
+        serialized: Dict[str, Any],
+        messages: List[List[BaseMessage]],
+        *,
+        run_id: UUID,
+        tags: Optional[List[str]] = None,
+        parent_run_id: Optional[UUID] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        name: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Run:
+        """Start a trace for an LLM run."""
+        if self._schema_format != "streaming_events":
+            # Please keep this un-implemented for backwards compatibility.
+            # When it's unimplemented old tracers that use the "original" format
+            # fallback on the on_llm_start method implementation if they
+            # find that the on_chat_model_start method is not implemented.
+            # This can eventually be cleaned up by writing a "modern" tracer
+            # that has all the updated schema changes corresponding to
+            # the "streaming_events" format.
+            raise NotImplementedError(
+                f"Chat model tracing is not supported in "
+                f"for {self._schema_format} format."
+            )
+        parent_run_id_ = str(parent_run_id) if parent_run_id else None
+        execution_order = self._get_execution_order(parent_run_id_)
+        start_time = datetime.now(timezone.utc)
+        if metadata:
+            kwargs.update({"metadata": metadata})
+        chat_model_run = Run(
+            id=run_id,
+            parent_run_id=parent_run_id,
+            serialized=serialized,
+            inputs={"messages": [[dumpd(msg) for msg in batch] for batch in messages]},
+            extra=kwargs,
+            events=[{"name": "start", "time": start_time}],
+            start_time=start_time,
+            execution_order=execution_order,
+            child_execution_order=execution_order,
+            # WARNING: This is valid ONLY for streaming_events.
+            # run_type="llm" is what's used by virtually all tracers.
+            # Changing this to "chat_model" may break triggering on_llm_start
+            run_type="chat_model",
+            tags=tags,
+            name=name,  # type: ignore[arg-type]
+        )
+        self._start_trace(chat_model_run)
+        self._on_chat_model_start(chat_model_run)
+        return chat_model_run
+
+    def on_llm_start(
+        self,
+        serialized: Dict[str, Any],
+        prompts: List[str],
+        *,
+        run_id: UUID,
+        tags: Optional[List[str]] = None,
+        parent_run_id: Optional[UUID] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        name: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Run:
+        """Start a trace for an LLM run."""
+        parent_run_id_ = str(parent_run_id) if parent_run_id else None
+        execution_order = self._get_execution_order(parent_run_id_)
+        start_time = datetime.now(timezone.utc)
+        if metadata:
+            kwargs.update({"metadata": metadata})
+        llm_run = Run(
+            id=run_id,
+            parent_run_id=parent_run_id,
+            serialized=serialized,
+            # TODO: Figure out how to expose kwargs here
+            inputs={"prompts": prompts},
+            extra=kwargs,
+            events=[{"name": "start", "time": start_time}],
+            start_time=start_time,
+            execution_order=execution_order,
+            child_execution_order=execution_order,
+            run_type="llm",
+            tags=tags or [],
+            name=name,  # type: ignore[arg-type]
+        )
+        self._start_trace(llm_run)
+        self._on_llm_start(llm_run)
+        return llm_run
+
+    def on_llm_new_token(
+        self,
+        token: str,
+        *,
+        chunk: Optional[Union[GenerationChunk, ChatGenerationChunk]] = None,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        **kwargs: Any,
+    ) -> Run:
+        """Run on new LLM token. Only available when streaming is enabled."""
+        # "chat_model" is only used for the experimental new streaming_events format.
+        # This change should not affect any existing tracers.
+        llm_run = self._get_run(run_id, run_type={"llm", "chat_model"})
+        event_kwargs: Dict[str, Any] = {"token": token}
+        if chunk:
+            event_kwargs["chunk"] = chunk
+        llm_run.events.append(
+            {
+                "name": "new_token",
+                "time": datetime.now(timezone.utc),
+                "kwargs": event_kwargs,
+            },
+        )
+        self._on_llm_new_token(llm_run, token, chunk)
+        return llm_run
+
+    def on_retry(
+        self,
+        retry_state: RetryCallState,
+        *,
+        run_id: UUID,
+        **kwargs: Any,
+    ) -> Run:
+        llm_run = self._get_run(run_id)
+        retry_d: Dict[str, Any] = {
+            "slept": retry_state.idle_for,
+            "attempt": retry_state.attempt_number,
+        }
+        if retry_state.outcome is None:
+            retry_d["outcome"] = "N/A"
+        elif retry_state.outcome.failed:
+            retry_d["outcome"] = "failed"
+            exception = retry_state.outcome.exception()
+            retry_d["exception"] = str(exception)
+            retry_d["exception_type"] = exception.__class__.__name__
+        else:
+            retry_d["outcome"] = "success"
+            retry_d["result"] = str(retry_state.outcome.result())
+        llm_run.events.append(
+            {
+                "name": "retry",
+                "time": datetime.now(timezone.utc),
+                "kwargs": retry_d,
+            },
+        )
+        return llm_run
+
+    def on_llm_end(self, response: LLMResult, *, run_id: UUID, **kwargs: Any) -> Run:
+        """End a trace for an LLM run."""
+        # "chat_model" is only used for the experimental new streaming_events format.
+        # This change should not affect any existing tracers.
+        llm_run = self._get_run(run_id, run_type={"llm", "chat_model"})
+        llm_run.outputs = response.dict()
+        for i, generations in enumerate(response.generations):
+            for j, generation in enumerate(generations):
+                output_generation = llm_run.outputs["generations"][i][j]
+                if "message" in output_generation:
+                    output_generation["message"] = dumpd(
+                        cast(ChatGeneration, generation).message
+                    )
+        llm_run.end_time = datetime.now(timezone.utc)
+        llm_run.events.append({"name": "end", "time": llm_run.end_time})
+        self._end_trace(llm_run)
+        self._on_llm_end(llm_run)
+        return llm_run
+
+    def on_llm_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        **kwargs: Any,
+    ) -> Run:
+        """Handle an error for an LLM run."""
+        # "chat_model" is only used for the experimental new streaming_events format.
+        # This change should not affect any existing tracers.
+        llm_run = self._get_run(run_id, run_type={"llm", "chat_model"})
+        llm_run.error = self._get_stacktrace(error)
+        llm_run.end_time = datetime.now(timezone.utc)
+        llm_run.events.append({"name": "error", "time": llm_run.end_time})
+        self._end_trace(llm_run)
+        self._on_llm_error(llm_run)
+        return llm_run
+
+    def on_chain_start(
+        self,
+        serialized: Dict[str, Any],
+        inputs: Dict[str, Any],
+        *,
+        run_id: UUID,
+        tags: Optional[List[str]] = None,
+        parent_run_id: Optional[UUID] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        run_type: Optional[str] = None,
+        name: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Run:
+        """Start a trace for a chain run."""
+        parent_run_id_ = str(parent_run_id) if parent_run_id else None
+        execution_order = self._get_execution_order(parent_run_id_)
+        start_time = datetime.now(timezone.utc)
+        if metadata:
+            kwargs.update({"metadata": metadata})
+        chain_run = Run(
+            id=run_id,
+            parent_run_id=parent_run_id,
+            serialized=serialized,
+            inputs=self._get_chain_inputs(inputs),
+            extra=kwargs,
+            events=[{"name": "start", "time": start_time}],
+            start_time=start_time,
+            execution_order=execution_order,
+            child_execution_order=execution_order,
+            child_runs=[],
+            run_type=run_type or "chain",
+            name=name,  # type: ignore[arg-type]
+            tags=tags or [],
+        )
+        self._start_trace(chain_run)
+        self._on_chain_start(chain_run)
+        return chain_run
+
+    def _get_chain_inputs(self, inputs: Any) -> Any:
+        """Get the inputs for a chain run."""
+        if self._schema_format == "original":
+            return inputs if isinstance(inputs, dict) else {"input": inputs}
+        elif self._schema_format == "streaming_events":
+            return {
+                "input": inputs,
+            }
+        else:
+            raise ValueError(f"Invalid format: {self._schema_format}")
+
+    def _get_chain_outputs(self, outputs: Any) -> Any:
+        """Get the outputs for a chain run."""
+        if self._schema_format == "original":
+            return outputs if isinstance(outputs, dict) else {"output": outputs}
+        elif self._schema_format == "streaming_events":
+            return {
+                "output": outputs,
+            }
+        else:
+            raise ValueError(f"Invalid format: {self._schema_format}")
+
+    def on_chain_end(
+        self,
+        outputs: Dict[str, Any],
+        *,
+        run_id: UUID,
+        inputs: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> Run:
+        """End a trace for a chain run."""
+        chain_run = self._get_run(run_id)
+        chain_run.outputs = self._get_chain_outputs(outputs)
+        chain_run.end_time = datetime.now(timezone.utc)
+        chain_run.events.append({"name": "end", "time": chain_run.end_time})
+        if inputs is not None:
+            chain_run.inputs = self._get_chain_inputs(inputs)
+        self._end_trace(chain_run)
+        self._on_chain_end(chain_run)
+        return chain_run
+
+    def on_chain_error(
+        self,
+        error: BaseException,
+        *,
+        inputs: Optional[Dict[str, Any]] = None,
+        run_id: UUID,
+        **kwargs: Any,
+    ) -> Run:
+        """Handle an error for a chain run."""
+        chain_run = self._get_run(run_id)
+        chain_run.error = self._get_stacktrace(error)
+        chain_run.end_time = datetime.now(timezone.utc)
+        chain_run.events.append({"name": "error", "time": chain_run.end_time})
+        if inputs is not None:
+            chain_run.inputs = self._get_chain_inputs(inputs)
+        self._end_trace(chain_run)
+        self._on_chain_error(chain_run)
+        return chain_run
+
+    def on_tool_start(
+        self,
+        serialized: Dict[str, Any],
+        input_str: str,
+        *,
+        run_id: UUID,
+        tags: Optional[List[str]] = None,
+        parent_run_id: Optional[UUID] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        name: Optional[str] = None,
+        inputs: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> Run:
+        """Start a trace for a tool run."""
+        parent_run_id_ = str(parent_run_id) if parent_run_id else None
+        execution_order = self._get_execution_order(parent_run_id_)
+        start_time = datetime.now(timezone.utc)
+        if metadata:
+            kwargs.update({"metadata": metadata})
+
+        if self._schema_format == "original":
+            inputs = {"input": input_str}
+        elif self._schema_format == "streaming_events":
+            inputs = {"input": inputs}
+        else:
+            raise AssertionError(f"Invalid format: {self._schema_format}")
+
+        tool_run = Run(
+            id=run_id,
+            parent_run_id=parent_run_id,
+            serialized=serialized,
+            # Wrapping in dict since Run requires a dict object.
+            inputs=inputs,
+            extra=kwargs,
+            events=[{"name": "start", "time": start_time}],
+            start_time=start_time,
+            execution_order=execution_order,
+            child_execution_order=execution_order,
+            child_runs=[],
+            run_type="tool",
+            tags=tags or [],
+            name=name,  # type: ignore[arg-type]
+        )
+        self._start_trace(tool_run)
+        self._on_tool_start(tool_run)
+        return tool_run
+
+    def on_tool_end(self, output: Any, *, run_id: UUID, **kwargs: Any) -> Run:
+        """End a trace for a tool run."""
+        tool_run = self._get_run(run_id, run_type="tool")
+        tool_run.outputs = {"output": output}
+        tool_run.end_time = datetime.now(timezone.utc)
+        tool_run.events.append({"name": "end", "time": tool_run.end_time})
+        self._end_trace(tool_run)
+        self._on_tool_end(tool_run)
+        return tool_run
+
+    def on_tool_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        **kwargs: Any,
+    ) -> Run:
+        """Handle an error for a tool run."""
+        tool_run = self._get_run(run_id, run_type="tool")
+        tool_run.error = self._get_stacktrace(error)
+        tool_run.end_time = datetime.now(timezone.utc)
+        tool_run.events.append({"name": "error", "time": tool_run.end_time})
+        self._end_trace(tool_run)
+        self._on_tool_error(tool_run)
+        return tool_run
+
+    def on_retriever_start(
+        self,
+        serialized: Dict[str, Any],
+        query: str,
+        *,
+        run_id: UUID,
+        parent_run_id: Optional[UUID] = None,
+        tags: Optional[List[str]] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        name: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Run:
+        """Run when Retriever starts running."""
+        parent_run_id_ = str(parent_run_id) if parent_run_id else None
+        execution_order = self._get_execution_order(parent_run_id_)
+        start_time = datetime.now(timezone.utc)
+        if metadata:
+            kwargs.update({"metadata": metadata})
+        retrieval_run = Run(
+            id=run_id,
+            name=name or "Retriever",
+            parent_run_id=parent_run_id,
+            serialized=serialized,
+            inputs={"query": query},
+            extra=kwargs,
+            events=[{"name": "start", "time": start_time}],
+            start_time=start_time,
+            execution_order=execution_order,
+            child_execution_order=execution_order,
+            tags=tags,
+            child_runs=[],
+            run_type="retriever",
+        )
+        self._start_trace(retrieval_run)
+        self._on_retriever_start(retrieval_run)
+        return retrieval_run
+
+    def on_retriever_error(
+        self,
+        error: BaseException,
+        *,
+        run_id: UUID,
+        **kwargs: Any,
+    ) -> Run:
+        """Run when Retriever errors."""
+        retrieval_run = self._get_run(run_id, run_type="retriever")
+        retrieval_run.error = self._get_stacktrace(error)
+        retrieval_run.end_time = datetime.now(timezone.utc)
+        retrieval_run.events.append({"name": "error", "time": retrieval_run.end_time})
+        self._end_trace(retrieval_run)
+        self._on_retriever_error(retrieval_run)
+        return retrieval_run
+
+    def on_retriever_end(
+        self, documents: Sequence[Document], *, run_id: UUID, **kwargs: Any
+    ) -> Run:
+        """Run when Retriever ends running."""
+        retrieval_run = self._get_run(run_id, run_type="retriever")
+        retrieval_run.outputs = {"documents": documents}
+        retrieval_run.end_time = datetime.now(timezone.utc)
+        retrieval_run.events.append({"name": "end", "time": retrieval_run.end_time})
+        self._end_trace(retrieval_run)
+        self._on_retriever_end(retrieval_run)
+        return retrieval_run
+
+    def __deepcopy__(self, memo: dict) -> BaseTracer:
+        """Deepcopy the tracer."""
+        return self
+
+    def __copy__(self) -> BaseTracer:
+        """Copy the tracer."""
+        return self
+
+    def _on_run_create(self, run: Run) -> None:
+        """Process a run upon creation."""
+
+    def _on_run_update(self, run: Run) -> None:
+        """Process a run upon update."""
+
+    def _on_llm_start(self, run: Run) -> None:
+        """Process the LLM Run upon start."""
+
+    def _on_llm_new_token(
+        self,
+        run: Run,
+        token: str,
+        chunk: Optional[Union[GenerationChunk, ChatGenerationChunk]],
+    ) -> None:
+        """Process new LLM token."""
+
+    def _on_llm_end(self, run: Run) -> None:
+        """Process the LLM Run."""
+
+    def _on_llm_error(self, run: Run) -> None:
+        """Process the LLM Run upon error."""
+
+    def _on_chain_start(self, run: Run) -> None:
+        """Process the Chain Run upon start."""
+
+    def _on_chain_end(self, run: Run) -> None:
+        """Process the Chain Run."""
+
+    def _on_chain_error(self, run: Run) -> None:
+        """Process the Chain Run upon error."""
+
+    def _on_tool_start(self, run: Run) -> None:
+        """Process the Tool Run upon start."""
+
+    def _on_tool_end(self, run: Run) -> None:
+        """Process the Tool Run."""
+
+    def _on_tool_error(self, run: Run) -> None:
+        """Process the Tool Run upon error."""
+
+    def _on_chat_model_start(self, run: Run) -> None:
+        """Process the Chat Model Run upon start."""
+
+    def _on_retriever_start(self, run: Run) -> None:
+        """Process the Retriever Run upon start."""
+
+    def _on_retriever_end(self, run: Run) -> None:
+        """Process the Retriever Run."""
+
+    def _on_retriever_error(self, run: Run) -> None:
+        """Process the Retriever Run upon error."""
diff --git a/llm/Lib/site-packages/langchain_core/tracers/context.py b/llm/Lib/site-packages/langchain_core/tracers/context.py
new file mode 100644
index 0000000000000000000000000000000000000000..990049ee3693499b17e48c364a3e40d360a2ee0b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/tracers/context.py
@@ -0,0 +1,222 @@
+from __future__ import annotations
+
+from contextlib import contextmanager
+from contextvars import ContextVar
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Generator,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+from uuid import UUID
+
+from langsmith import utils as ls_utils
+from langsmith.run_helpers import get_run_tree_context
+
+from langchain_core.tracers.langchain import LangChainTracer
+from langchain_core.tracers.run_collector import RunCollectorCallbackHandler
+from langchain_core.tracers.schemas import TracerSessionV1
+from langchain_core.utils.env import env_var_is_set
+
+if TYPE_CHECKING:
+    from langsmith import Client as LangSmithClient
+
+    from langchain_core.callbacks.base import BaseCallbackHandler, Callbacks
+    from langchain_core.callbacks.manager import AsyncCallbackManager, CallbackManager
+
+# for backwards partial compatibility if this is imported by users but unused
+tracing_callback_var: Any = None
+tracing_v2_callback_var: ContextVar[Optional[LangChainTracer]] = ContextVar(
+    "tracing_callback_v2", default=None
+)  # noqa: E501
+run_collector_var: ContextVar[Optional[RunCollectorCallbackHandler]] = ContextVar(
+    "run_collector", default=None
+)  # noqa: E501
+
+
+@contextmanager
+def tracing_enabled(
+    session_name: str = "default",
+) -> Generator[TracerSessionV1, None, None]:
+    """Throws an error because this has been replaced by tracing_v2_enabled."""
+    raise RuntimeError(
+        "tracing_enabled is no longer supported. Please use tracing_enabled_v2 instead."
+    )
+
+
+@contextmanager
+def tracing_v2_enabled(
+    project_name: Optional[str] = None,
+    *,
+    example_id: Optional[Union[str, UUID]] = None,
+    tags: Optional[List[str]] = None,
+    client: Optional[LangSmithClient] = None,
+) -> Generator[LangChainTracer, None, None]:
+    """Instruct LangChain to log all runs in context to LangSmith.
+
+    Args:
+        project_name (str, optional): The name of the project.
+            Defaults to "default".
+        example_id (str or UUID, optional): The ID of the example.
+            Defaults to None.
+        tags (List[str], optional): The tags to add to the run.
+            Defaults to None.
+        client (LangSmithClient, optional): The client of the langsmith.
+            Defaults to None.
+
+    Returns:
+        None
+
+    Example:
+        >>> with tracing_v2_enabled():
+        ...     # LangChain code will automatically be traced
+
+        You can use this to fetch the LangSmith run URL:
+
+        >>> with tracing_v2_enabled() as cb:
+        ...     chain.invoke("foo")
+        ...     run_url = cb.get_run_url()
+    """
+    if isinstance(example_id, str):
+        example_id = UUID(example_id)
+    cb = LangChainTracer(
+        example_id=example_id,
+        project_name=project_name,
+        tags=tags,
+        client=client,
+    )
+    try:
+        tracing_v2_callback_var.set(cb)
+        yield cb
+    finally:
+        tracing_v2_callback_var.set(None)
+
+
+@contextmanager
+def collect_runs() -> Generator[RunCollectorCallbackHandler, None, None]:
+    """Collect all run traces in context.
+
+    Returns:
+        run_collector.RunCollectorCallbackHandler: The run collector callback handler.
+
+    Example:
+        >>> with collect_runs() as runs_cb:
+                chain.invoke("foo")
+                run_id = runs_cb.traced_runs[0].id
+    """
+    cb = RunCollectorCallbackHandler()
+    run_collector_var.set(cb)
+    yield cb
+    run_collector_var.set(None)
+
+
+def _get_trace_callbacks(
+    project_name: Optional[str] = None,
+    example_id: Optional[Union[str, UUID]] = None,
+    callback_manager: Optional[Union[CallbackManager, AsyncCallbackManager]] = None,
+) -> Callbacks:
+    if _tracing_v2_is_enabled():
+        project_name_ = project_name or _get_tracer_project()
+        tracer = tracing_v2_callback_var.get() or LangChainTracer(
+            project_name=project_name_,
+            example_id=example_id,
+        )
+        if callback_manager is None:
+            from langchain_core.callbacks.base import Callbacks
+
+            cb = cast(Callbacks, [tracer])
+        else:
+            if not any(
+                isinstance(handler, LangChainTracer)
+                for handler in callback_manager.handlers
+            ):
+                callback_manager.add_handler(tracer, True)
+                # If it already has a LangChainTracer, we don't need to add another one.
+                # this would likely mess up the trace hierarchy.
+            cb = callback_manager
+    else:
+        cb = None
+    return cb
+
+
+def _tracing_v2_is_enabled() -> bool:
+    return (
+        env_var_is_set("LANGCHAIN_TRACING_V2")
+        or tracing_v2_callback_var.get() is not None
+        or get_run_tree_context() is not None
+    )
+
+
+def _get_tracer_project() -> str:
+    run_tree = get_run_tree_context()
+    return getattr(
+        run_tree,
+        "session_name",
+        getattr(
+            # Note, if people are trying to nest @traceable functions and the
+            # tracing_v2_enabled context manager, this will likely mess up the
+            # tree structure.
+            tracing_v2_callback_var.get(),
+            "project",
+            # Have to set this to a string even though it always will return
+            # a string because `get_tracer_project` technically can return
+            # None, but only when a specific argument is supplied.
+            # Therefore, this just tricks the mypy type checker
+            str(ls_utils.get_tracer_project()),
+        ),
+    )
+
+
+_configure_hooks: List[
+    Tuple[
+        ContextVar[Optional[BaseCallbackHandler]],
+        bool,
+        Optional[Type[BaseCallbackHandler]],
+        Optional[str],
+    ]
+] = []
+
+
+def register_configure_hook(
+    context_var: ContextVar[Optional[Any]],
+    inheritable: bool,
+    handle_class: Optional[Type[BaseCallbackHandler]] = None,
+    env_var: Optional[str] = None,
+) -> None:
+    """Register a configure hook.
+
+    Args:
+        context_var (ContextVar[Optional[Any]]): The context variable.
+        inheritable (bool): Whether the context variable is inheritable.
+        handle_class (Optional[Type[BaseCallbackHandler]], optional):
+          The callback handler class. Defaults to None.
+        env_var (Optional[str], optional): The environment variable. Defaults to None.
+
+    Raises:
+        ValueError: If env_var is set, handle_class must also be set
+          to a non-None value.
+    """
+    if env_var is not None and handle_class is None:
+        raise ValueError(
+            "If env_var is set, handle_class must also be set to a non-None value."
+        )
+    from langchain_core.callbacks.base import BaseCallbackHandler
+
+    _configure_hooks.append(
+        (
+            # the typings of ContextVar do not have the generic arg set as covariant
+            # so we have to cast it
+            cast(ContextVar[Optional[BaseCallbackHandler]], context_var),
+            inheritable,
+            handle_class,
+            env_var,
+        )
+    )
+
+
+register_configure_hook(run_collector_var, False)
diff --git a/llm/Lib/site-packages/langchain_core/tracers/evaluation.py b/llm/Lib/site-packages/langchain_core/tracers/evaluation.py
new file mode 100644
index 0000000000000000000000000000000000000000..3caeda2b0c0f49c14818d236c22152fbb2f5e8f8
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/tracers/evaluation.py
@@ -0,0 +1,223 @@
+"""A tracer that runs evaluators over completed runs."""
+from __future__ import annotations
+
+import logging
+import threading
+import weakref
+from concurrent.futures import Future, ThreadPoolExecutor, wait
+from typing import Any, Dict, List, Optional, Sequence, Tuple, Union, cast
+from uuid import UUID
+
+import langsmith
+from langsmith.evaluation.evaluator import EvaluationResult, EvaluationResults
+
+from langchain_core.tracers import langchain as langchain_tracer
+from langchain_core.tracers.base import BaseTracer
+from langchain_core.tracers.context import tracing_v2_enabled
+from langchain_core.tracers.langchain import _get_executor
+from langchain_core.tracers.schemas import Run
+
+logger = logging.getLogger(__name__)
+
+_TRACERS: weakref.WeakSet[EvaluatorCallbackHandler] = weakref.WeakSet()
+
+
+def wait_for_all_evaluators() -> None:
+    """Wait for all tracers to finish."""
+    global _TRACERS
+    for tracer in list(_TRACERS):
+        if tracer is not None:
+            tracer.wait_for_futures()
+
+
+class EvaluatorCallbackHandler(BaseTracer):
+    """Tracer that runs a run evaluator whenever a run is persisted.
+
+    Parameters
+    ----------
+    evaluators : Sequence[RunEvaluator]
+        The run evaluators to apply to all top level runs.
+    client : LangSmith Client, optional
+        The LangSmith client instance to use for evaluating the runs.
+        If not specified, a new instance will be created.
+    example_id : Union[UUID, str], optional
+        The example ID to be associated with the runs.
+    project_name : str, optional
+        The LangSmith project name to be organize eval chain runs under.
+
+    Attributes
+    ----------
+    example_id : Union[UUID, None]
+        The example ID associated with the runs.
+    client : Client
+        The LangSmith client instance used for evaluating the runs.
+    evaluators : Sequence[RunEvaluator]
+        The sequence of run evaluators to be executed.
+    executor : ThreadPoolExecutor
+        The thread pool executor used for running the evaluators.
+    futures : Set[Future]
+        The set of futures representing the running evaluators.
+    skip_unfinished : bool
+        Whether to skip runs that are not finished or raised
+        an error.
+    project_name : Optional[str]
+        The LangSmith project name to be organize eval chain runs under.
+    """
+
+    name = "evaluator_callback_handler"
+
+    def __init__(
+        self,
+        evaluators: Sequence[langsmith.RunEvaluator],
+        client: Optional[langsmith.Client] = None,
+        example_id: Optional[Union[UUID, str]] = None,
+        skip_unfinished: bool = True,
+        project_name: Optional[str] = "evaluators",
+        max_concurrency: Optional[int] = None,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(**kwargs)
+        self.example_id = (
+            UUID(example_id) if isinstance(example_id, str) else example_id
+        )
+        self.client = client or langchain_tracer.get_client()
+        self.evaluators = evaluators
+        if max_concurrency is None:
+            self.executor: Optional[ThreadPoolExecutor] = _get_executor()
+        elif max_concurrency > 0:
+            self.executor = ThreadPoolExecutor(max_workers=max_concurrency)
+            weakref.finalize(
+                self,
+                lambda: cast(ThreadPoolExecutor, self.executor).shutdown(wait=True),
+            )
+        else:
+            self.executor = None
+        self.futures: weakref.WeakSet[Future] = weakref.WeakSet()
+        self.skip_unfinished = skip_unfinished
+        self.project_name = project_name
+        self.logged_eval_results: Dict[Tuple[str, str], List[EvaluationResult]] = {}
+        self.lock = threading.Lock()
+        global _TRACERS
+        _TRACERS.add(self)
+
+    def _evaluate_in_project(self, run: Run, evaluator: langsmith.RunEvaluator) -> None:
+        """Evaluate the run in the project.
+
+        Parameters
+        ----------
+        run : Run
+            The run to be evaluated.
+        evaluator : RunEvaluator
+            The evaluator to use for evaluating the run.
+
+        """
+        try:
+            if self.project_name is None:
+                eval_result = self.client.evaluate_run(run, evaluator)
+                eval_results = [eval_result]
+            with tracing_v2_enabled(
+                project_name=self.project_name, tags=["eval"], client=self.client
+            ) as cb:
+                reference_example = (
+                    self.client.read_example(run.reference_example_id)
+                    if run.reference_example_id
+                    else None
+                )
+                evaluation_result = evaluator.evaluate_run(
+                    # This is subclass, but getting errors for some reason
+                    run,  # type: ignore
+                    example=reference_example,
+                )
+                eval_results = self._log_evaluation_feedback(
+                    evaluation_result,
+                    run,
+                    source_run_id=cb.latest_run.id if cb.latest_run else None,
+                )
+        except Exception as e:
+            logger.error(
+                f"Error evaluating run {run.id} with "
+                f"{evaluator.__class__.__name__}: {repr(e)}",
+                exc_info=True,
+            )
+            raise e
+        example_id = str(run.reference_example_id)
+        with self.lock:
+            for res in eval_results:
+                run_id = (
+                    str(getattr(res, "target_run_id"))
+                    if hasattr(res, "target_run_id")
+                    else str(run.id)
+                )
+                self.logged_eval_results.setdefault((run_id, example_id), []).append(
+                    res
+                )
+
+    def _select_eval_results(
+        self,
+        results: Union[EvaluationResult, EvaluationResults],
+    ) -> List[EvaluationResult]:
+        if isinstance(results, EvaluationResult):
+            results_ = [results]
+        elif isinstance(results, dict) and "results" in results:
+            results_ = cast(List[EvaluationResult], results["results"])
+        else:
+            raise TypeError(
+                f"Invalid evaluation result type {type(results)}."
+                " Expected EvaluationResult or EvaluationResults."
+            )
+        return results_
+
+    def _log_evaluation_feedback(
+        self,
+        evaluator_response: Union[EvaluationResult, EvaluationResults],
+        run: Run,
+        source_run_id: Optional[UUID] = None,
+    ) -> List[EvaluationResult]:
+        results = self._select_eval_results(evaluator_response)
+        for res in results:
+            source_info_: Dict[str, Any] = {}
+            if res.evaluator_info:
+                source_info_ = {**res.evaluator_info, **source_info_}
+            run_id_ = (
+                getattr(res, "target_run_id")
+                if hasattr(res, "target_run_id") and res.target_run_id is not None
+                else run.id
+            )
+            self.client.create_feedback(
+                run_id_,
+                res.key,
+                score=res.score,
+                value=res.value,
+                comment=res.comment,
+                correction=res.correction,
+                source_info=source_info_,
+                source_run_id=res.source_run_id or source_run_id,
+                feedback_source_type=langsmith.schemas.FeedbackSourceType.MODEL,
+            )
+        return results
+
+    def _persist_run(self, run: Run) -> None:
+        """Run the evaluator on the run.
+
+        Parameters
+        ----------
+        run : Run
+            The run to be evaluated.
+
+        """
+        if self.skip_unfinished and not run.outputs:
+            logger.debug(f"Skipping unfinished run {run.id}")
+            return
+        run_ = run.copy()
+        run_.reference_example_id = self.example_id
+        for evaluator in self.evaluators:
+            if self.executor is None:
+                self._evaluate_in_project(run_, evaluator)
+            else:
+                self.futures.add(
+                    self.executor.submit(self._evaluate_in_project, run_, evaluator)
+                )
+
+    def wait_for_futures(self) -> None:
+        """Wait for all futures to complete."""
+        wait(self.futures)
diff --git a/llm/Lib/site-packages/langchain_core/tracers/langchain.py b/llm/Lib/site-packages/langchain_core/tracers/langchain.py
new file mode 100644
index 0000000000000000000000000000000000000000..9f7036451260ae44fc4cf2de651749d0af9ad799
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/tracers/langchain.py
@@ -0,0 +1,250 @@
+"""A Tracer implementation that records to LangChain endpoint."""
+
+from __future__ import annotations
+
+import logging
+from concurrent.futures import ThreadPoolExecutor
+from datetime import datetime, timezone
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Union
+from uuid import UUID
+
+from langsmith import Client
+from langsmith import utils as ls_utils
+from tenacity import (
+    Retrying,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential_jitter,
+)
+
+from langchain_core.env import get_runtime_environment
+from langchain_core.load import dumpd
+from langchain_core.tracers.base import BaseTracer
+from langchain_core.tracers.schemas import Run
+
+if TYPE_CHECKING:
+    from langchain_core.messages import BaseMessage
+
+logger = logging.getLogger(__name__)
+_LOGGED = set()
+_CLIENT: Optional[Client] = None
+_EXECUTOR: Optional[ThreadPoolExecutor] = None
+
+
+def log_error_once(method: str, exception: Exception) -> None:
+    """Log an error once."""
+    global _LOGGED
+    if (method, type(exception)) in _LOGGED:
+        return
+    _LOGGED.add((method, type(exception)))
+    logger.error(exception)
+
+
+def wait_for_all_tracers() -> None:
+    """Wait for all tracers to finish."""
+    global _CLIENT
+    if _CLIENT is not None and _CLIENT.tracing_queue is not None:
+        _CLIENT.tracing_queue.join()
+
+
+def get_client() -> Client:
+    """Get the client."""
+    global _CLIENT
+    if _CLIENT is None:
+        _CLIENT = Client()
+    return _CLIENT
+
+
+def _get_executor() -> ThreadPoolExecutor:
+    """Get the executor."""
+    global _EXECUTOR
+    if _EXECUTOR is None:
+        _EXECUTOR = ThreadPoolExecutor()
+    return _EXECUTOR
+
+
+def _run_to_dict(run: Run) -> dict:
+    return {
+        **run.dict(exclude={"child_runs", "inputs", "outputs"}),
+        "inputs": run.inputs.copy() if run.inputs is not None else None,
+        "outputs": run.outputs.copy() if run.outputs is not None else None,
+    }
+
+
+class LangChainTracer(BaseTracer):
+    """Implementation of the SharedTracer that POSTS to the LangChain endpoint."""
+
+    def __init__(
+        self,
+        example_id: Optional[Union[UUID, str]] = None,
+        project_name: Optional[str] = None,
+        client: Optional[Client] = None,
+        tags: Optional[List[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        """Initialize the LangChain tracer."""
+        super().__init__(**kwargs)
+        self.example_id = (
+            UUID(example_id) if isinstance(example_id, str) else example_id
+        )
+        self.project_name = project_name or ls_utils.get_tracer_project()
+        self.client = client or get_client()
+        self.tags = tags or []
+        self.latest_run: Optional[Run] = None
+
+    def on_chat_model_start(
+        self,
+        serialized: Dict[str, Any],
+        messages: List[List[BaseMessage]],
+        *,
+        run_id: UUID,
+        tags: Optional[List[str]] = None,
+        parent_run_id: Optional[UUID] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        name: Optional[str] = None,
+        **kwargs: Any,
+    ) -> Run:
+        """Start a trace for an LLM run."""
+        parent_run_id_ = str(parent_run_id) if parent_run_id else None
+        execution_order = self._get_execution_order(parent_run_id_)
+        start_time = datetime.now(timezone.utc)
+        if metadata:
+            kwargs.update({"metadata": metadata})
+        chat_model_run = Run(
+            id=run_id,
+            parent_run_id=parent_run_id,
+            serialized=serialized,
+            inputs={"messages": [[dumpd(msg) for msg in batch] for batch in messages]},
+            extra=kwargs,
+            events=[{"name": "start", "time": start_time}],
+            start_time=start_time,
+            execution_order=execution_order,
+            child_execution_order=execution_order,
+            run_type="llm",
+            tags=tags,
+            name=name,  # type: ignore[arg-type]
+        )
+        self._start_trace(chat_model_run)
+        self._on_chat_model_start(chat_model_run)
+        return chat_model_run
+
+    def _persist_run(self, run: Run) -> None:
+        run_ = run.copy()
+        run_.reference_example_id = self.example_id
+        self.latest_run = run_
+
+    def get_run_url(self) -> str:
+        """Get the LangSmith root run URL"""
+        if not self.latest_run:
+            raise ValueError("No traced run found.")
+        # If this is the first run in a project, the project may not yet be created.
+        # This method is only really useful for debugging flows, so we will assume
+        # there is some tolerace for latency.
+        for attempt in Retrying(
+            stop=stop_after_attempt(5),
+            wait=wait_exponential_jitter(),
+            retry=retry_if_exception_type(ls_utils.LangSmithError),
+        ):
+            with attempt:
+                return self.client.get_run_url(
+                    run=self.latest_run, project_name=self.project_name
+                )
+        raise ValueError("Failed to get run URL.")
+
+    def _get_tags(self, run: Run) -> List[str]:
+        """Get combined tags for a run."""
+        tags = set(run.tags or [])
+        tags.update(self.tags or [])
+        return list(tags)
+
+    def _persist_run_single(self, run: Run) -> None:
+        """Persist a run."""
+        run_dict = _run_to_dict(run)
+        run_dict["tags"] = self._get_tags(run)
+        extra = run_dict.get("extra", {})
+        extra["runtime"] = get_runtime_environment()
+        run_dict["extra"] = extra
+        try:
+            self.client.create_run(**run_dict, project_name=self.project_name)
+        except Exception as e:
+            # Errors are swallowed by the thread executor so we need to log them here
+            log_error_once("post", e)
+            raise
+
+    def _update_run_single(self, run: Run) -> None:
+        """Update a run."""
+        try:
+            run_dict = _run_to_dict(run)
+            run_dict["tags"] = self._get_tags(run)
+            self.client.update_run(run.id, **run_dict)
+        except Exception as e:
+            # Errors are swallowed by the thread executor so we need to log them here
+            log_error_once("patch", e)
+            raise
+
+    def _on_llm_start(self, run: Run) -> None:
+        """Persist an LLM run."""
+        if run.parent_run_id is None:
+            run.reference_example_id = self.example_id
+        self._persist_run_single(run)
+
+    def _on_chat_model_start(self, run: Run) -> None:
+        """Persist an LLM run."""
+        if run.parent_run_id is None:
+            run.reference_example_id = self.example_id
+        self._persist_run_single(run)
+
+    def _on_llm_end(self, run: Run) -> None:
+        """Process the LLM Run."""
+        self._update_run_single(run)
+
+    def _on_llm_error(self, run: Run) -> None:
+        """Process the LLM Run upon error."""
+        self._update_run_single(run)
+
+    def _on_chain_start(self, run: Run) -> None:
+        """Process the Chain Run upon start."""
+        if run.parent_run_id is None:
+            run.reference_example_id = self.example_id
+        self._persist_run_single(run)
+
+    def _on_chain_end(self, run: Run) -> None:
+        """Process the Chain Run."""
+        self._update_run_single(run)
+
+    def _on_chain_error(self, run: Run) -> None:
+        """Process the Chain Run upon error."""
+        self._update_run_single(run)
+
+    def _on_tool_start(self, run: Run) -> None:
+        """Process the Tool Run upon start."""
+        if run.parent_run_id is None:
+            run.reference_example_id = self.example_id
+        self._persist_run_single(run)
+
+    def _on_tool_end(self, run: Run) -> None:
+        """Process the Tool Run."""
+        self._update_run_single(run)
+
+    def _on_tool_error(self, run: Run) -> None:
+        """Process the Tool Run upon error."""
+        self._update_run_single(run)
+
+    def _on_retriever_start(self, run: Run) -> None:
+        """Process the Retriever Run upon start."""
+        if run.parent_run_id is None:
+            run.reference_example_id = self.example_id
+        self._persist_run_single(run)
+
+    def _on_retriever_end(self, run: Run) -> None:
+        """Process the Retriever Run."""
+        self._update_run_single(run)
+
+    def _on_retriever_error(self, run: Run) -> None:
+        """Process the Retriever Run upon error."""
+        self._update_run_single(run)
+
+    def wait_for_futures(self) -> None:
+        """Wait for the given futures to complete."""
+        if self.client is not None and self.client.tracing_queue is not None:
+            self.client.tracing_queue.join()
diff --git a/llm/Lib/site-packages/langchain_core/tracers/langchain_v1.py b/llm/Lib/site-packages/langchain_core/tracers/langchain_v1.py
new file mode 100644
index 0000000000000000000000000000000000000000..aac99a720611cc5625080f9bc3fab1c615317d37
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/tracers/langchain_v1.py
@@ -0,0 +1,14 @@
+from typing import Any
+
+
+def get_headers(*args: Any, **kwargs: Any) -> Any:
+    raise RuntimeError(
+        "get_headers for LangChainTracerV1 is no longer supported. "
+        "Please use LangChainTracer instead."
+    )
+
+
+def LangChainTracerV1(*args: Any, **kwargs: Any) -> Any:
+    raise RuntimeError(
+        "LangChainTracerV1 is no longer supported. Please use LangChainTracer instead."
+    )
diff --git a/llm/Lib/site-packages/langchain_core/tracers/log_stream.py b/llm/Lib/site-packages/langchain_core/tracers/log_stream.py
new file mode 100644
index 0000000000000000000000000000000000000000..4c02f933e428384316d5e451d07406e701224389
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/tracers/log_stream.py
@@ -0,0 +1,618 @@
+from __future__ import annotations
+
+import asyncio
+import copy
+import threading
+from collections import defaultdict
+from typing import (
+    Any,
+    AsyncIterator,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    Sequence,
+    TypeVar,
+    Union,
+    overload,
+)
+from uuid import UUID
+
+import jsonpatch  # type: ignore[import]
+from typing_extensions import NotRequired, TypedDict
+
+from langchain_core.load import dumps
+from langchain_core.load.load import load
+from langchain_core.outputs import ChatGenerationChunk, GenerationChunk
+from langchain_core.runnables import Runnable, RunnableConfig, ensure_config
+from langchain_core.runnables.utils import Input, Output
+from langchain_core.tracers.base import BaseTracer
+from langchain_core.tracers.memory_stream import _MemoryStream
+from langchain_core.tracers.schemas import Run
+
+
+class LogEntry(TypedDict):
+    """A single entry in the run log."""
+
+    id: str
+    """ID of the sub-run."""
+    name: str
+    """Name of the object being run."""
+    type: str
+    """Type of the object being run, eg. prompt, chain, llm, etc."""
+    tags: List[str]
+    """List of tags for the run."""
+    metadata: Dict[str, Any]
+    """Key-value pairs of metadata for the run."""
+    start_time: str
+    """ISO-8601 timestamp of when the run started."""
+
+    streamed_output_str: List[str]
+    """List of LLM tokens streamed by this run, if applicable."""
+    streamed_output: List[Any]
+    """List of output chunks streamed by this run, if available."""
+    inputs: NotRequired[Optional[Any]]
+    """Inputs to this run. Not available currently via astream_log."""
+    final_output: Optional[Any]
+    """Final output of this run. 
+    
+    Only available after the run has finished successfully."""
+    end_time: Optional[str]
+    """ISO-8601 timestamp of when the run ended.
+    Only available after the run has finished."""
+
+
+class RunState(TypedDict):
+    """State of the run."""
+
+    id: str
+    """ID of the run."""
+    streamed_output: List[Any]
+    """List of output chunks streamed by Runnable.stream()"""
+    final_output: Optional[Any]
+    """Final output of the run, usually the result of aggregating (`+`) streamed_output.
+    Updated throughout the run when supported by the Runnable."""
+
+    name: str
+    """Name of the object being run."""
+    type: str
+    """Type of the object being run, eg. prompt, chain, llm, etc."""
+
+    # Do we want tags/metadata on the root run? Client kinda knows it in most situations
+    # tags: List[str]
+
+    logs: Dict[str, LogEntry]
+    """Map of run names to sub-runs. If filters were supplied, this list will
+    contain only the runs that matched the filters."""
+
+
+class RunLogPatch:
+    """Patch to the run log."""
+
+    ops: List[Dict[str, Any]]
+    """List of jsonpatch operations, which describe how to create the run state
+    from an empty dict. This is the minimal representation of the log, designed to
+    be serialized as JSON and sent over the wire to reconstruct the log on the other
+    side. Reconstruction of the state can be done with any jsonpatch-compliant library,
+    see https://jsonpatch.com for more information."""
+
+    def __init__(self, *ops: Dict[str, Any]) -> None:
+        self.ops = list(ops)
+
+    def __add__(self, other: Union[RunLogPatch, Any]) -> RunLog:
+        if type(other) == RunLogPatch:
+            ops = self.ops + other.ops
+            state = jsonpatch.apply_patch(None, copy.deepcopy(ops))
+            return RunLog(*ops, state=state)
+
+        raise TypeError(
+            f"unsupported operand type(s) for +: '{type(self)}' and '{type(other)}'"
+        )
+
+    def __repr__(self) -> str:
+        from pprint import pformat
+
+        # 1:-1 to get rid of the [] around the list
+        return f"RunLogPatch({pformat(self.ops)[1:-1]})"
+
+    def __eq__(self, other: object) -> bool:
+        return isinstance(other, RunLogPatch) and self.ops == other.ops
+
+
+class RunLog(RunLogPatch):
+    """Run log."""
+
+    state: RunState
+    """Current state of the log, obtained from applying all ops in sequence."""
+
+    def __init__(self, *ops: Dict[str, Any], state: RunState) -> None:
+        super().__init__(*ops)
+        self.state = state
+
+    def __add__(self, other: Union[RunLogPatch, Any]) -> RunLog:
+        if type(other) == RunLogPatch:
+            ops = self.ops + other.ops
+            state = jsonpatch.apply_patch(self.state, other.ops)
+            return RunLog(*ops, state=state)
+
+        raise TypeError(
+            f"unsupported operand type(s) for +: '{type(self)}' and '{type(other)}'"
+        )
+
+    def __repr__(self) -> str:
+        from pprint import pformat
+
+        return f"RunLog({pformat(self.state)})"
+
+    def __eq__(self, other: object) -> bool:
+        # First compare that the state is the same
+        if not isinstance(other, RunLog):
+            return False
+        if self.state != other.state:
+            return False
+        # Then compare that the ops are the same
+        return super().__eq__(other)
+
+
+T = TypeVar("T")
+
+
+class LogStreamCallbackHandler(BaseTracer):
+    """Tracer that streams run logs to a stream."""
+
+    def __init__(
+        self,
+        *,
+        auto_close: bool = True,
+        include_names: Optional[Sequence[str]] = None,
+        include_types: Optional[Sequence[str]] = None,
+        include_tags: Optional[Sequence[str]] = None,
+        exclude_names: Optional[Sequence[str]] = None,
+        exclude_types: Optional[Sequence[str]] = None,
+        exclude_tags: Optional[Sequence[str]] = None,
+        # Schema format is for internal use only.
+        _schema_format: Literal["original", "streaming_events"] = "streaming_events",
+    ) -> None:
+        """A tracer that streams run logs to a stream.
+
+        Args:
+            auto_close: Whether to close the stream when the root run finishes.
+            include_names: Only include runs from Runnables with matching names.
+            include_types: Only include runs from Runnables with matching types.
+            include_tags: Only include runs from Runnables with matching tags.
+            exclude_names: Exclude runs from Runnables with matching names.
+            exclude_types: Exclude runs from Runnables with matching types.
+            exclude_tags: Exclude runs from Runnables with matching tags.
+            _schema_format: Primarily changes how the inputs and outputs are
+                handled.
+                **For internal use only. This API will change.**
+                - 'original' is the format used by all current tracers.
+                   This format is slightly inconsistent with respect to inputs
+                   and outputs.
+                - 'streaming_events' is used for supporting streaming events,
+                   for internal usage. It will likely change in the future, or
+                   be deprecated entirely in favor of a dedicated async tracer
+                   for streaming events.
+        """
+        if _schema_format not in {"original", "streaming_events"}:
+            raise ValueError(
+                f"Invalid schema format: {_schema_format}. "
+                f"Expected one of 'original', 'streaming_events'."
+            )
+        super().__init__(_schema_format=_schema_format)
+
+        self.auto_close = auto_close
+        self.include_names = include_names
+        self.include_types = include_types
+        self.include_tags = include_tags
+        self.exclude_names = exclude_names
+        self.exclude_types = exclude_types
+        self.exclude_tags = exclude_tags
+
+        loop = asyncio.get_event_loop()
+        memory_stream = _MemoryStream[RunLogPatch](loop)
+        self.lock = threading.Lock()
+        self.send_stream = memory_stream.get_send_stream()
+        self.receive_stream = memory_stream.get_receive_stream()
+        self._key_map_by_run_id: Dict[UUID, str] = {}
+        self._counter_map_by_name: Dict[str, int] = defaultdict(int)
+        self.root_id: Optional[UUID] = None
+
+    def __aiter__(self) -> AsyncIterator[RunLogPatch]:
+        return self.receive_stream.__aiter__()
+
+    def send(self, *ops: Dict[str, Any]) -> bool:
+        """Send a patch to the stream, return False if the stream is closed."""
+        # We will likely want to wrap this in try / except at some point
+        # to handle exceptions that might arise at run time.
+        # For now we'll let the exception bubble up, and always return
+        # True on the happy path.
+        self.send_stream.send_nowait(RunLogPatch(*ops))
+        return True
+
+    async def tap_output_aiter(
+        self, run_id: UUID, output: AsyncIterator[T]
+    ) -> AsyncIterator[T]:
+        """Tap an output async iterator to stream its values to the log."""
+        async for chunk in output:
+            # root run is handled in .astream_log()
+            if run_id != self.root_id:
+                # if we can't find the run silently ignore
+                # eg. because this run wasn't included in the log
+                if key := self._key_map_by_run_id.get(run_id):
+                    if not self.send(
+                        {
+                            "op": "add",
+                            "path": f"/logs/{key}/streamed_output/-",
+                            "value": chunk,
+                        }
+                    ):
+                        break
+
+            yield chunk
+
+    def include_run(self, run: Run) -> bool:
+        if run.id == self.root_id:
+            return False
+
+        run_tags = run.tags or []
+
+        if (
+            self.include_names is None
+            and self.include_types is None
+            and self.include_tags is None
+        ):
+            include = True
+        else:
+            include = False
+
+        if self.include_names is not None:
+            include = include or run.name in self.include_names
+        if self.include_types is not None:
+            include = include or run.run_type in self.include_types
+        if self.include_tags is not None:
+            include = include or any(tag in self.include_tags for tag in run_tags)
+
+        if self.exclude_names is not None:
+            include = include and run.name not in self.exclude_names
+        if self.exclude_types is not None:
+            include = include and run.run_type not in self.exclude_types
+        if self.exclude_tags is not None:
+            include = include and all(tag not in self.exclude_tags for tag in run_tags)
+
+        return include
+
+    def _persist_run(self, run: Run) -> None:
+        # This is a legacy method only called once for an entire run tree
+        # therefore not useful here
+        pass
+
+    def _on_run_create(self, run: Run) -> None:
+        """Start a run."""
+        if self.root_id is None:
+            self.root_id = run.id
+            if not self.send(
+                {
+                    "op": "replace",
+                    "path": "",
+                    "value": RunState(
+                        id=str(run.id),
+                        streamed_output=[],
+                        final_output=None,
+                        logs={},
+                        name=run.name,
+                        type=run.run_type,
+                    ),
+                }
+            ):
+                return
+
+        if not self.include_run(run):
+            return
+
+        # Determine previous index, increment by 1
+        with self.lock:
+            self._counter_map_by_name[run.name] += 1
+            count = self._counter_map_by_name[run.name]
+            self._key_map_by_run_id[run.id] = (
+                run.name if count == 1 else f"{run.name}:{count}"
+            )
+
+        entry = LogEntry(
+            id=str(run.id),
+            name=run.name,
+            type=run.run_type,
+            tags=run.tags or [],
+            metadata=(run.extra or {}).get("metadata", {}),
+            start_time=run.start_time.isoformat(timespec="milliseconds"),
+            streamed_output=[],
+            streamed_output_str=[],
+            final_output=None,
+            end_time=None,
+        )
+
+        if self._schema_format == "streaming_events":
+            # If using streaming events let's add inputs as well
+            entry["inputs"] = _get_standardized_inputs(run, self._schema_format)
+
+        # Add the run to the stream
+        self.send(
+            {
+                "op": "add",
+                "path": f"/logs/{self._key_map_by_run_id[run.id]}",
+                "value": entry,
+            }
+        )
+
+    def _on_run_update(self, run: Run) -> None:
+        """Finish a run."""
+        try:
+            index = self._key_map_by_run_id.get(run.id)
+
+            if index is None:
+                return
+
+            ops = []
+
+            if self._schema_format == "streaming_events":
+                ops.append(
+                    {
+                        "op": "replace",
+                        "path": f"/logs/{index}/inputs",
+                        "value": _get_standardized_inputs(run, self._schema_format),
+                    }
+                )
+
+            ops.extend(
+                [
+                    # Replace 'inputs' with final inputs
+                    # This is needed because in many cases the inputs are not
+                    # known until after the run is finished and the entire
+                    # input stream has been processed by the runnable.
+                    {
+                        "op": "add",
+                        "path": f"/logs/{index}/final_output",
+                        # to undo the dumpd done by some runnables / tracer / etc
+                        "value": _get_standardized_outputs(run, self._schema_format),
+                    },
+                    {
+                        "op": "add",
+                        "path": f"/logs/{index}/end_time",
+                        "value": run.end_time.isoformat(timespec="milliseconds")
+                        if run.end_time is not None
+                        else None,
+                    },
+                ]
+            )
+
+            self.send(*ops)
+        finally:
+            if run.id == self.root_id:
+                if self.auto_close:
+                    self.send_stream.close()
+
+    def _on_llm_new_token(
+        self,
+        run: Run,
+        token: str,
+        chunk: Optional[Union[GenerationChunk, ChatGenerationChunk]],
+    ) -> None:
+        """Process new LLM token."""
+        index = self._key_map_by_run_id.get(run.id)
+
+        if index is None:
+            return
+
+        self.send(
+            {
+                "op": "add",
+                "path": f"/logs/{index}/streamed_output_str/-",
+                "value": token,
+            },
+            {
+                "op": "add",
+                "path": f"/logs/{index}/streamed_output/-",
+                "value": chunk.message
+                if isinstance(chunk, ChatGenerationChunk)
+                else token,
+            },
+        )
+
+
+def _get_standardized_inputs(
+    run: Run, schema_format: Literal["original", "streaming_events"]
+) -> Optional[Dict[str, Any]]:
+    """Extract standardized inputs from a run.
+
+    Standardizes the inputs based on the type of the runnable used.
+
+    Args:
+        run: Run object
+        schema_format: The schema format to use.
+
+    Returns:
+        Valid inputs are only dict. By conventions, inputs always represented
+        invocation using named arguments.
+        A None means that the input is not yet known!
+    """
+    if schema_format == "original":
+        raise NotImplementedError(
+            "Do not assign inputs with original schema drop the key for now."
+            "When inputs are added to astream_log they should be added with "
+            "standardized schema for streaming events."
+        )
+
+    inputs = load(run.inputs)
+
+    if run.run_type in {"retriever", "llm", "chat_model"}:
+        return inputs
+
+    # new style chains
+    # These nest an additional 'input' key inside the 'inputs' to make sure
+    # the input is always a dict. We need to unpack and user the inner value.
+    inputs = inputs["input"]
+    # We should try to fix this in Runnables and callbacks/tracers
+    # Runnables should be using a None type here not a placeholder
+    # dict.
+    if inputs == {"input": ""}:  # Workaround for Runnables not using None
+        # The input is not known, so we don't assign data['input']
+        return None
+    return inputs
+
+
+def _get_standardized_outputs(
+    run: Run, schema_format: Literal["original", "streaming_events"]
+) -> Optional[Any]:
+    """Extract standardized output from a run.
+
+    Standardizes the outputs based on the type of the runnable used.
+
+    Args:
+        log: The log entry.
+        schema_format: The schema format to use.
+
+    Returns:
+        An output if returned, otherwise a None
+    """
+    outputs = load(run.outputs)
+    if schema_format == "original":
+        if run.run_type == "prompt" and "output" in outputs:
+            # These were previously dumped before the tracer.
+            # Now we needn't do anything to them.
+            return outputs["output"]
+        # Return the old schema, without standardizing anything
+        return outputs
+
+    if run.run_type in {"retriever", "llm", "chat_model"}:
+        return outputs
+
+    if isinstance(outputs, dict):
+        return outputs.get("output", None)
+
+    return None
+
+
+@overload
+def _astream_log_implementation(
+    runnable: Runnable[Input, Output],
+    input: Any,
+    config: Optional[RunnableConfig] = None,
+    *,
+    stream: LogStreamCallbackHandler,
+    diff: Literal[True] = True,
+    with_streamed_output_list: bool = True,
+    **kwargs: Any,
+) -> AsyncIterator[RunLogPatch]:
+    ...
+
+
+@overload
+def _astream_log_implementation(
+    runnable: Runnable[Input, Output],
+    input: Any,
+    config: Optional[RunnableConfig] = None,
+    *,
+    stream: LogStreamCallbackHandler,
+    diff: Literal[False],
+    with_streamed_output_list: bool = True,
+    **kwargs: Any,
+) -> AsyncIterator[RunLog]:
+    ...
+
+
+async def _astream_log_implementation(
+    runnable: Runnable[Input, Output],
+    input: Any,
+    config: Optional[RunnableConfig] = None,
+    *,
+    stream: LogStreamCallbackHandler,
+    diff: bool = True,
+    with_streamed_output_list: bool = True,
+    **kwargs: Any,
+) -> Union[AsyncIterator[RunLogPatch], AsyncIterator[RunLog]]:
+    """Implementation of astream_log for a given runnable.
+
+    The implementation has been factored out (at least temporarily) as both
+    astream_log and astream_events relies on it.
+    """
+    import jsonpatch  # type: ignore[import]
+
+    from langchain_core.callbacks.base import BaseCallbackManager
+    from langchain_core.tracers.log_stream import (
+        RunLog,
+        RunLogPatch,
+    )
+
+    # Assign the stream handler to the config
+    config = ensure_config(config)
+    callbacks = config.get("callbacks")
+    if callbacks is None:
+        config["callbacks"] = [stream]
+    elif isinstance(callbacks, list):
+        config["callbacks"] = callbacks + [stream]
+    elif isinstance(callbacks, BaseCallbackManager):
+        callbacks = callbacks.copy()
+        callbacks.add_handler(stream, inherit=True)
+        config["callbacks"] = callbacks
+    else:
+        raise ValueError(
+            f"Unexpected type for callbacks: {callbacks}."
+            "Expected None, list or AsyncCallbackManager."
+        )
+
+    # Call the runnable in streaming mode,
+    # add each chunk to the output stream
+    async def consume_astream() -> None:
+        try:
+            prev_final_output: Optional[Output] = None
+            final_output: Optional[Output] = None
+
+            async for chunk in runnable.astream(input, config, **kwargs):
+                prev_final_output = final_output
+                if final_output is None:
+                    final_output = chunk
+                else:
+                    try:
+                        final_output = final_output + chunk  # type: ignore
+                    except TypeError:
+                        prev_final_output = None
+                        final_output = chunk
+                patches: List[Dict[str, Any]] = []
+                if with_streamed_output_list:
+                    patches.append(
+                        {
+                            "op": "add",
+                            "path": "/streamed_output/-",
+                            # chunk cannot be shared between
+                            # streamed_output and final_output
+                            # otherwise jsonpatch.apply will
+                            # modify both
+                            "value": copy.deepcopy(chunk),
+                        }
+                    )
+                for op in jsonpatch.JsonPatch.from_diff(
+                    prev_final_output, final_output, dumps=dumps
+                ):
+                    patches.append({**op, "path": f"/final_output{op['path']}"})
+                await stream.send_stream.send(RunLogPatch(*patches))
+        finally:
+            await stream.send_stream.aclose()
+
+    # Start the runnable in a task, so we can start consuming output
+    task = asyncio.create_task(consume_astream())
+    try:
+        # Yield each chunk from the output stream
+        if diff:
+            async for log in stream:
+                yield log
+        else:
+            state = RunLog(state=None)  # type: ignore[arg-type]
+            async for log in stream:
+                state = state + log
+                yield state
+    finally:
+        # Wait for the runnable to finish, if not cancelled (eg. by break)
+        try:
+            await task
+        except asyncio.CancelledError:
+            pass
diff --git a/llm/Lib/site-packages/langchain_core/tracers/memory_stream.py b/llm/Lib/site-packages/langchain_core/tracers/memory_stream.py
new file mode 100644
index 0000000000000000000000000000000000000000..871b5ca932e93f791d0b41b35fed5aadf6182724
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/tracers/memory_stream.py
@@ -0,0 +1,104 @@
+"""Module implements a memory stream for communication between two co-routines.
+
+This module provides a way to communicate between two co-routines using a memory
+channel. The writer and reader can be in the same event loop or in different event
+loops. When they're in different event loops, they will also be in different
+threads.
+
+This is useful in situations when there's a mix of synchronous and asynchronous
+used in the code.
+"""
+import asyncio
+from asyncio import AbstractEventLoop, Queue
+from typing import AsyncIterator, Generic, TypeVar
+
+T = TypeVar("T")
+
+
+class _SendStream(Generic[T]):
+    def __init__(
+        self, reader_loop: AbstractEventLoop, queue: Queue, done: object
+    ) -> None:
+        """Create a writer for the queue and done object.
+
+        Args:
+            reader_loop: The event loop to use for the writer. This loop will be used
+                         to schedule the writes to the queue.
+            queue: The queue to write to. This is an asyncio queue.
+            done: Special sentinel object to indicate that the writer is done.
+        """
+        self._reader_loop = reader_loop
+        self._queue = queue
+        self._done = done
+
+    async def send(self, item: T) -> None:
+        """Schedule the item to be written to the queue using the original loop."""
+        return self.send_nowait(item)
+
+    def send_nowait(self, item: T) -> None:
+        """Schedule the item to be written to the queue using the original loop."""
+        self._reader_loop.call_soon_threadsafe(self._queue.put_nowait, item)
+
+    async def aclose(self) -> None:
+        """Schedule the done object write the queue using the original loop."""
+        return self.close()
+
+    def close(self) -> None:
+        """Schedule the done object write the queue using the original loop."""
+        self._reader_loop.call_soon_threadsafe(self._queue.put_nowait, self._done)
+
+
+class _ReceiveStream(Generic[T]):
+    def __init__(self, queue: Queue, done: object) -> None:
+        """Create a reader for the queue and done object.
+
+        This reader should be used in the same loop as the loop that was passed
+        to the channel.
+        """
+        self._queue = queue
+        self._done = done
+        self._is_closed = False
+
+    async def __aiter__(self) -> AsyncIterator[T]:
+        while True:
+            item = await self._queue.get()
+            if item is self._done:
+                self._is_closed = True
+                break
+            yield item
+
+
+class _MemoryStream(Generic[T]):
+    """Stream data from a writer to a reader even if they are in different threads.
+
+    Uses asyncio queues to communicate between two co-routines. This implementation
+    should work even if the writer and reader co-routines belong to two different
+    event loops (e.g. one running from an event loop in the main thread
+    and the other running in an event loop in a background thread).
+
+    This implementation is meant to be used with a single writer and a single reader.
+
+    This is an internal implementation to LangChain please do not use it directly.
+    """
+
+    def __init__(self, loop: AbstractEventLoop) -> None:
+        """Create a channel for the given loop.
+
+        Args:
+            loop: The event loop to use for the channel. The reader is assumed
+                  to be running in the same loop as the one passed to this constructor.
+                  This will NOT be validated at run time.
+        """
+        self._loop = loop
+        self._queue: asyncio.Queue = asyncio.Queue(maxsize=0)
+        self._done = object()
+
+    def get_send_stream(self) -> _SendStream[T]:
+        """Get a writer for the channel."""
+        return _SendStream[T](
+            reader_loop=self._loop, queue=self._queue, done=self._done
+        )
+
+    def get_receive_stream(self) -> _ReceiveStream[T]:
+        """Get a reader for the channel."""
+        return _ReceiveStream[T](queue=self._queue, done=self._done)
diff --git a/llm/Lib/site-packages/langchain_core/tracers/root_listeners.py b/llm/Lib/site-packages/langchain_core/tracers/root_listeners.py
new file mode 100644
index 0000000000000000000000000000000000000000..7db7407d268f23194c1a088c50051be709172bb9
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/tracers/root_listeners.py
@@ -0,0 +1,56 @@
+from typing import Callable, Optional, Union
+from uuid import UUID
+
+from langchain_core.runnables.config import (
+    RunnableConfig,
+    call_func_with_variable_args,
+)
+from langchain_core.tracers.base import BaseTracer
+from langchain_core.tracers.schemas import Run
+
+Listener = Union[Callable[[Run], None], Callable[[Run, RunnableConfig], None]]
+
+
+class RootListenersTracer(BaseTracer):
+    """Tracer that calls listeners on run start, end, and error."""
+
+    def __init__(
+        self,
+        *,
+        config: RunnableConfig,
+        on_start: Optional[Listener],
+        on_end: Optional[Listener],
+        on_error: Optional[Listener],
+    ) -> None:
+        super().__init__()
+
+        self.config = config
+        self._arg_on_start = on_start
+        self._arg_on_end = on_end
+        self._arg_on_error = on_error
+        self.root_id: Optional[UUID] = None
+
+    def _persist_run(self, run: Run) -> None:
+        # This is a legacy method only called once for an entire run tree
+        # therefore not useful here
+        pass
+
+    def _on_run_create(self, run: Run) -> None:
+        if self.root_id is not None:
+            return
+
+        self.root_id = run.id
+
+        if self._arg_on_start is not None:
+            call_func_with_variable_args(self._arg_on_start, run, self.config)
+
+    def _on_run_update(self, run: Run) -> None:
+        if run.id != self.root_id:
+            return
+
+        if run.error is None:
+            if self._arg_on_end is not None:
+                call_func_with_variable_args(self._arg_on_end, run, self.config)
+        else:
+            if self._arg_on_error is not None:
+                call_func_with_variable_args(self._arg_on_error, run, self.config)
diff --git a/llm/Lib/site-packages/langchain_core/tracers/run_collector.py b/llm/Lib/site-packages/langchain_core/tracers/run_collector.py
new file mode 100644
index 0000000000000000000000000000000000000000..9442daa413201b0253d70544f461351789be4eb2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/tracers/run_collector.py
@@ -0,0 +1,52 @@
+"""A tracer that collects all nested runs in a list."""
+
+from typing import Any, List, Optional, Union
+from uuid import UUID
+
+from langchain_core.tracers.base import BaseTracer
+from langchain_core.tracers.schemas import Run
+
+
+class RunCollectorCallbackHandler(BaseTracer):
+    """
+    Tracer that collects all nested runs in a list.
+
+    This tracer is useful for inspection and evaluation purposes.
+
+    Parameters
+    ----------
+    example_id : Optional[Union[UUID, str]], default=None
+        The ID of the example being traced. It can be either a UUID or a string.
+    """
+
+    name: str = "run-collector_callback_handler"
+
+    def __init__(
+        self, example_id: Optional[Union[UUID, str]] = None, **kwargs: Any
+    ) -> None:
+        """
+        Initialize the RunCollectorCallbackHandler.
+
+        Parameters
+        ----------
+        example_id : Optional[Union[UUID, str]], default=None
+            The ID of the example being traced. It can be either a UUID or a string.
+        """
+        super().__init__(**kwargs)
+        self.example_id = (
+            UUID(example_id) if isinstance(example_id, str) else example_id
+        )
+        self.traced_runs: List[Run] = []
+
+    def _persist_run(self, run: Run) -> None:
+        """
+        Persist a run by adding it to the traced_runs list.
+
+        Parameters
+        ----------
+        run : Run
+            The run to be persisted.
+        """
+        run_ = run.copy()
+        run_.reference_example_id = self.example_id
+        self.traced_runs.append(run_)
diff --git a/llm/Lib/site-packages/langchain_core/tracers/schemas.py b/llm/Lib/site-packages/langchain_core/tracers/schemas.py
new file mode 100644
index 0000000000000000000000000000000000000000..cec04e1d9d351195b57ec1eab2cdff497055242e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/tracers/schemas.py
@@ -0,0 +1,153 @@
+"""Schemas for tracers."""
+from __future__ import annotations
+
+import datetime
+import warnings
+from typing import Any, Dict, List, Optional, Type
+from uuid import UUID
+
+from langsmith.schemas import RunBase as BaseRunV2
+from langsmith.schemas import RunTypeEnum as RunTypeEnumDep
+
+from langchain_core._api import deprecated
+from langchain_core.outputs import LLMResult
+from langchain_core.pydantic_v1 import BaseModel, Field, root_validator
+
+
+@deprecated("0.1.0", alternative="Use string instead.", removal="0.2.0")
+def RunTypeEnum() -> Type[RunTypeEnumDep]:
+    """RunTypeEnum."""
+    warnings.warn(
+        "RunTypeEnum is deprecated. Please directly use a string instead"
+        " (e.g. 'llm', 'chain', 'tool').",
+        DeprecationWarning,
+    )
+    return RunTypeEnumDep
+
+
+@deprecated("0.1.0", removal="0.2.0")
+class TracerSessionV1Base(BaseModel):
+    """Base class for TracerSessionV1."""
+
+    start_time: datetime.datetime = Field(default_factory=datetime.datetime.utcnow)
+    name: Optional[str] = None
+    extra: Optional[Dict[str, Any]] = None
+
+
+@deprecated("0.1.0", removal="0.2.0")
+class TracerSessionV1Create(TracerSessionV1Base):
+    """Create class for TracerSessionV1."""
+
+
+@deprecated("0.1.0", removal="0.2.0")
+class TracerSessionV1(TracerSessionV1Base):
+    """TracerSessionV1 schema."""
+
+    id: int
+
+
+@deprecated("0.1.0", removal="0.2.0")
+class TracerSessionBase(TracerSessionV1Base):
+    """Base class for TracerSession."""
+
+    tenant_id: UUID
+
+
+@deprecated("0.1.0", removal="0.2.0")
+class TracerSession(TracerSessionBase):
+    """TracerSessionV1 schema for the V2 API."""
+
+    id: UUID
+
+
+@deprecated("0.1.0", alternative="Run", removal="0.2.0")
+class BaseRun(BaseModel):
+    """Base class for Run."""
+
+    uuid: str
+    parent_uuid: Optional[str] = None
+    start_time: datetime.datetime = Field(default_factory=datetime.datetime.utcnow)
+    end_time: datetime.datetime = Field(default_factory=datetime.datetime.utcnow)
+    extra: Optional[Dict[str, Any]] = None
+    execution_order: int
+    child_execution_order: int
+    serialized: Dict[str, Any]
+    session_id: int
+    error: Optional[str] = None
+
+
+@deprecated("0.1.0", alternative="Run", removal="0.2.0")
+class LLMRun(BaseRun):
+    """Class for LLMRun."""
+
+    prompts: List[str]
+    response: Optional[LLMResult] = None
+
+
+@deprecated("0.1.0", alternative="Run", removal="0.2.0")
+class ChainRun(BaseRun):
+    """Class for ChainRun."""
+
+    inputs: Dict[str, Any]
+    outputs: Optional[Dict[str, Any]] = None
+    child_llm_runs: List[LLMRun] = Field(default_factory=list)
+    child_chain_runs: List[ChainRun] = Field(default_factory=list)
+    child_tool_runs: List[ToolRun] = Field(default_factory=list)
+
+
+@deprecated("0.1.0", alternative="Run", removal="0.2.0")
+class ToolRun(BaseRun):
+    """Class for ToolRun."""
+
+    tool_input: str
+    output: Optional[str] = None
+    action: str
+    child_llm_runs: List[LLMRun] = Field(default_factory=list)
+    child_chain_runs: List[ChainRun] = Field(default_factory=list)
+    child_tool_runs: List[ToolRun] = Field(default_factory=list)
+
+
+# Begin V2 API Schemas
+
+
+class Run(BaseRunV2):
+    """Run schema for the V2 API in the Tracer."""
+
+    execution_order: int
+    child_execution_order: int
+    child_runs: List[Run] = Field(default_factory=list)
+    tags: Optional[List[str]] = Field(default_factory=list)
+    events: List[Dict[str, Any]] = Field(default_factory=list)
+    trace_id: Optional[UUID] = None
+    dotted_order: Optional[str] = None
+
+    @root_validator(pre=True)
+    def assign_name(cls, values: dict) -> dict:
+        """Assign name to the run."""
+        if values.get("name") is None:
+            if "name" in values["serialized"]:
+                values["name"] = values["serialized"]["name"]
+            elif "id" in values["serialized"]:
+                values["name"] = values["serialized"]["id"][-1]
+        if values.get("events") is None:
+            values["events"] = []
+        return values
+
+
+ChainRun.update_forward_refs()
+ToolRun.update_forward_refs()
+Run.update_forward_refs()
+
+__all__ = [
+    "BaseRun",
+    "ChainRun",
+    "LLMRun",
+    "Run",
+    "RunTypeEnum",
+    "ToolRun",
+    "TracerSession",
+    "TracerSessionBase",
+    "TracerSessionV1",
+    "TracerSessionV1Base",
+    "TracerSessionV1Create",
+]
diff --git a/llm/Lib/site-packages/langchain_core/tracers/stdout.py b/llm/Lib/site-packages/langchain_core/tracers/stdout.py
new file mode 100644
index 0000000000000000000000000000000000000000..0054b3471b85f46566baead3ec7a19799b8b23b2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/tracers/stdout.py
@@ -0,0 +1,178 @@
+import json
+from typing import Any, Callable, List
+
+from langchain_core.tracers.base import BaseTracer
+from langchain_core.tracers.schemas import Run
+from langchain_core.utils.input import get_bolded_text, get_colored_text
+
+
+def try_json_stringify(obj: Any, fallback: str) -> str:
+    """
+    Try to stringify an object to JSON.
+    Args:
+        obj: Object to stringify.
+        fallback: Fallback string to return if the object cannot be stringified.
+
+    Returns:
+        A JSON string if the object can be stringified, otherwise the fallback string.
+
+    """
+    try:
+        return json.dumps(obj, indent=2, ensure_ascii=False)
+    except Exception:
+        return fallback
+
+
+def elapsed(run: Any) -> str:
+    """Get the elapsed time of a run.
+
+    Args:
+        run: any object with a start_time and end_time attribute.
+
+    Returns:
+        A string with the elapsed time in seconds or
+            milliseconds if time is less than a second.
+
+    """
+    elapsed_time = run.end_time - run.start_time
+    milliseconds = elapsed_time.total_seconds() * 1000
+    if milliseconds < 1000:
+        return f"{milliseconds:.0f}ms"
+    return f"{(milliseconds / 1000):.2f}s"
+
+
+class FunctionCallbackHandler(BaseTracer):
+    """Tracer that calls a function with a single str parameter."""
+
+    name: str = "function_callback_handler"
+
+    def __init__(self, function: Callable[[str], None], **kwargs: Any) -> None:
+        super().__init__(**kwargs)
+        self.function_callback = function
+
+    def _persist_run(self, run: Run) -> None:
+        pass
+
+    def get_parents(self, run: Run) -> List[Run]:
+        parents = []
+        current_run = run
+        while current_run.parent_run_id:
+            parent = self.run_map.get(str(current_run.parent_run_id))
+            if parent:
+                parents.append(parent)
+                current_run = parent
+            else:
+                break
+        return parents
+
+    def get_breadcrumbs(self, run: Run) -> str:
+        parents = self.get_parents(run)[::-1]
+        string = " > ".join(
+            f"{parent.execution_order}:{parent.run_type}:{parent.name}"
+            if i != len(parents) - 1
+            else f"{parent.execution_order}:{parent.run_type}:{parent.name}"
+            for i, parent in enumerate(parents + [run])
+        )
+        return string
+
+    # logging methods
+    def _on_chain_start(self, run: Run) -> None:
+        crumbs = self.get_breadcrumbs(run)
+        run_type = run.run_type.capitalize()
+        self.function_callback(
+            f"{get_colored_text('[chain/start]', color='green')} "
+            + get_bolded_text(f"[{crumbs}] Entering {run_type} run with input:\n")
+            + f"{try_json_stringify(run.inputs, '[inputs]')}"
+        )
+
+    def _on_chain_end(self, run: Run) -> None:
+        crumbs = self.get_breadcrumbs(run)
+        run_type = run.run_type.capitalize()
+        self.function_callback(
+            f"{get_colored_text('[chain/end]', color='blue')} "
+            + get_bolded_text(
+                f"[{crumbs}] [{elapsed(run)}] Exiting {run_type} run with output:\n"
+            )
+            + f"{try_json_stringify(run.outputs, '[outputs]')}"
+        )
+
+    def _on_chain_error(self, run: Run) -> None:
+        crumbs = self.get_breadcrumbs(run)
+        run_type = run.run_type.capitalize()
+        self.function_callback(
+            f"{get_colored_text('[chain/error]', color='red')} "
+            + get_bolded_text(
+                f"[{crumbs}] [{elapsed(run)}] {run_type} run errored with error:\n"
+            )
+            + f"{try_json_stringify(run.error, '[error]')}"
+        )
+
+    def _on_llm_start(self, run: Run) -> None:
+        crumbs = self.get_breadcrumbs(run)
+        inputs = (
+            {"prompts": [p.strip() for p in run.inputs["prompts"]]}
+            if "prompts" in run.inputs
+            else run.inputs
+        )
+        self.function_callback(
+            f"{get_colored_text('[llm/start]', color='green')} "
+            + get_bolded_text(f"[{crumbs}] Entering LLM run with input:\n")
+            + f"{try_json_stringify(inputs, '[inputs]')}"
+        )
+
+    def _on_llm_end(self, run: Run) -> None:
+        crumbs = self.get_breadcrumbs(run)
+        self.function_callback(
+            f"{get_colored_text('[llm/end]', color='blue')} "
+            + get_bolded_text(
+                f"[{crumbs}] [{elapsed(run)}] Exiting LLM run with output:\n"
+            )
+            + f"{try_json_stringify(run.outputs, '[response]')}"
+        )
+
+    def _on_llm_error(self, run: Run) -> None:
+        crumbs = self.get_breadcrumbs(run)
+        self.function_callback(
+            f"{get_colored_text('[llm/error]', color='red')} "
+            + get_bolded_text(
+                f"[{crumbs}] [{elapsed(run)}] LLM run errored with error:\n"
+            )
+            + f"{try_json_stringify(run.error, '[error]')}"
+        )
+
+    def _on_tool_start(self, run: Run) -> None:
+        crumbs = self.get_breadcrumbs(run)
+        self.function_callback(
+            f'{get_colored_text("[tool/start]", color="green")} '
+            + get_bolded_text(f"[{crumbs}] Entering Tool run with input:\n")
+            + f'"{run.inputs["input"].strip()}"'
+        )
+
+    def _on_tool_end(self, run: Run) -> None:
+        crumbs = self.get_breadcrumbs(run)
+        if run.outputs:
+            self.function_callback(
+                f'{get_colored_text("[tool/end]", color="blue")} '
+                + get_bolded_text(
+                    f"[{crumbs}] [{elapsed(run)}] Exiting Tool run with output:\n"
+                )
+                + f'"{run.outputs["output"].strip()}"'
+            )
+
+    def _on_tool_error(self, run: Run) -> None:
+        crumbs = self.get_breadcrumbs(run)
+        self.function_callback(
+            f"{get_colored_text('[tool/error]', color='red')} "
+            + get_bolded_text(f"[{crumbs}] [{elapsed(run)}] ")
+            + f"Tool run errored with error:\n"
+            f"{run.error}"
+        )
+
+
+class ConsoleCallbackHandler(FunctionCallbackHandler):
+    """Tracer that prints to the console."""
+
+    name: str = "console_callback_handler"
+
+    def __init__(self, **kwargs: Any) -> None:
+        super().__init__(function=print, **kwargs)
diff --git a/llm/Lib/site-packages/langchain_core/utils/__init__.py b/llm/Lib/site-packages/langchain_core/utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..92f919bac399b21c7816b4e77898825a383c165e
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/__init__.py
@@ -0,0 +1,51 @@
+"""
+**Utility functions** for LangChain.
+
+These functions do not depend on any other LangChain module.
+"""
+
+from langchain_core.utils import image
+from langchain_core.utils.env import get_from_dict_or_env, get_from_env
+from langchain_core.utils.formatting import StrictFormatter, formatter
+from langchain_core.utils.input import (
+    get_bolded_text,
+    get_color_mapping,
+    get_colored_text,
+    print_text,
+)
+from langchain_core.utils.loading import try_load_from_hub
+from langchain_core.utils.strings import comma_list, stringify_dict, stringify_value
+from langchain_core.utils.utils import (
+    build_extra_kwargs,
+    check_package_version,
+    convert_to_secret_str,
+    get_pydantic_field_names,
+    guard_import,
+    mock_now,
+    raise_for_status_with_text,
+    xor_args,
+)
+
+__all__ = [
+    "StrictFormatter",
+    "check_package_version",
+    "convert_to_secret_str",
+    "formatter",
+    "get_bolded_text",
+    "get_color_mapping",
+    "get_colored_text",
+    "get_pydantic_field_names",
+    "guard_import",
+    "mock_now",
+    "print_text",
+    "raise_for_status_with_text",
+    "xor_args",
+    "try_load_from_hub",
+    "build_extra_kwargs",
+    "image",
+    "get_from_env",
+    "get_from_dict_or_env",
+    "stringify_dict",
+    "comma_list",
+    "stringify_value",
+]
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/__init__.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/__init__.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1e33bc22e6c9d6fc8edb02022985091edace89cb
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/__init__.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/_merge.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/_merge.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..c69a43705476d6a62774a60d875e508f95945f5c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/_merge.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/aiter.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/aiter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a5464c994597e9ce88d48392edcabc35f8303ed7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/aiter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/env.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/env.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..bc7a296299406677a84b621c30e20da33c726ffc
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/env.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/formatting.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/formatting.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..677552685242e986371ea4289ad5e33d31d90309
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/formatting.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/function_calling.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/function_calling.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..1173769c8da6766dd4affa965dfb81032de072ac
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/function_calling.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/html.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/html.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..4d3d4296d7dddef191f58a71d71ed65f4e7090e7
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/html.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/image.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/image.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..764d2e6378873bc007c173c68314d7f601ec0117
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/image.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/input.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/input.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f44c4cb88082e754de1a749a3c9896b0183a382c
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/input.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/interactive_env.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/interactive_env.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..03b8db66954f15acbc9d251a4da3edde559c8e2f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/interactive_env.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/iter.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/iter.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..3d068571a5bac71e76da56fa3cebe3773f64d46f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/iter.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/json.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/json.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5156813ca26cef7217ebd7ddaede12c655c6292f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/json.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/json_schema.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/json_schema.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d141e254c263045b6d25c1d3f9e3da259ab2c687
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/json_schema.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/loading.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/loading.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..96608ec5776e6846dbb4cd2ce49d98bcd910a400
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/loading.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/mustache.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/mustache.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..a8f63606136e4d14658647638f11f82e519240a4
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/mustache.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/pydantic.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/pydantic.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..f64a5bf5024039a2e2630e1eb06243ec6c2ec2cf
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/pydantic.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/strings.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/strings.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..ad182373a449cc969d43211d90e8408bf5462580
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/strings.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/__pycache__/utils.cpython-311.pyc b/llm/Lib/site-packages/langchain_core/utils/__pycache__/utils.cpython-311.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..5eaf4285e2f5951e8df98db55be95c3cc0a59b2f
Binary files /dev/null and b/llm/Lib/site-packages/langchain_core/utils/__pycache__/utils.cpython-311.pyc differ
diff --git a/llm/Lib/site-packages/langchain_core/utils/_merge.py b/llm/Lib/site-packages/langchain_core/utils/_merge.py
new file mode 100644
index 0000000000000000000000000000000000000000..b6f3ab25d43af965181962ef1f54cf3e55d481e0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/_merge.py
@@ -0,0 +1,68 @@
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+
+def merge_dicts(left: Dict[str, Any], right: Dict[str, Any]) -> Dict[str, Any]:
+    """Merge two dicts, handling specific scenarios where a key exists in both
+    dictionaries but has a value of None in 'left'. In such cases, the method uses the
+    value from 'right' for that key in the merged dictionary.
+
+    Example:
+        If left = {"function_call": {"arguments": None}} and
+        right = {"function_call": {"arguments": "{\n"}}
+        then, after merging, for the key "function_call",
+        the value from 'right' is used,
+        resulting in merged = {"function_call": {"arguments": "{\n"}}.
+    """
+    merged = left.copy()
+    for right_k, right_v in right.items():
+        if right_k not in merged:
+            merged[right_k] = right_v
+        elif right_v is not None and merged[right_k] is None:
+            merged[right_k] = right_v
+        elif right_v is None:
+            continue
+        elif type(merged[right_k]) != type(right_v):
+            raise TypeError(
+                f'additional_kwargs["{right_k}"] already exists in this message,'
+                " but with a different type."
+            )
+        elif isinstance(merged[right_k], str):
+            merged[right_k] += right_v
+        elif isinstance(merged[right_k], dict):
+            merged[right_k] = merge_dicts(merged[right_k], right_v)
+        elif isinstance(merged[right_k], list):
+            merged[right_k] = merge_lists(merged[right_k], right_v)
+        elif merged[right_k] == right_v:
+            continue
+        else:
+            raise TypeError(
+                f"Additional kwargs key {right_k} already exists in left dict and "
+                f"value has unsupported type {type(merged[right_k])}."
+            )
+    return merged
+
+
+def merge_lists(left: Optional[List], right: Optional[List]) -> Optional[List]:
+    """Add two lists, handling None."""
+    if left is None and right is None:
+        return None
+    elif left is None or right is None:
+        return left or right
+    else:
+        merged = left.copy()
+        for e in right:
+            if isinstance(e, dict) and "index" in e and isinstance(e["index"], int):
+                to_merge = [
+                    i
+                    for i, e_left in enumerate(merged)
+                    if e_left["index"] == e["index"]
+                ]
+                if to_merge:
+                    merged[to_merge[0]] = merge_dicts(merged[to_merge[0]], e)
+                else:
+                    merged = merged + [e]
+            else:
+                merged = merged + [e]
+        return merged
diff --git a/llm/Lib/site-packages/langchain_core/utils/aiter.py b/llm/Lib/site-packages/langchain_core/utils/aiter.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca44dee3958d353606fbde0e954f96b44b3dfccf
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/aiter.py
@@ -0,0 +1,209 @@
+"""
+Adapted from
+https://github.com/maxfischer2781/asyncstdlib/blob/master/asyncstdlib/itertools.py
+MIT License
+"""
+
+from collections import deque
+from typing import (
+    Any,
+    AsyncContextManager,
+    AsyncGenerator,
+    AsyncIterator,
+    Awaitable,
+    Callable,
+    Deque,
+    Generic,
+    Iterator,
+    List,
+    Optional,
+    Tuple,
+    TypeVar,
+    Union,
+    cast,
+    overload,
+)
+
+T = TypeVar("T")
+
+_no_default = object()
+
+
+# https://github.com/python/cpython/blob/main/Lib/test/test_asyncgen.py#L54
+# before 3.10, the builtin anext() was not available
+def py_anext(
+    iterator: AsyncIterator[T], default: Union[T, Any] = _no_default
+) -> Awaitable[Union[T, None, Any]]:
+    """Pure-Python implementation of anext() for testing purposes.
+
+    Closely matches the builtin anext() C implementation.
+    Can be used to compare the built-in implementation of the inner
+    coroutines machinery to C-implementation of __anext__() and send()
+    or throw() on the returned generator.
+    """
+
+    try:
+        __anext__ = cast(
+            Callable[[AsyncIterator[T]], Awaitable[T]], type(iterator).__anext__
+        )
+    except AttributeError:
+        raise TypeError(f"{iterator!r} is not an async iterator")
+
+    if default is _no_default:
+        return __anext__(iterator)
+
+    async def anext_impl() -> Union[T, Any]:
+        try:
+            # The C code is way more low-level than this, as it implements
+            # all methods of the iterator protocol. In this implementation
+            # we're relying on higher-level coroutine concepts, but that's
+            # exactly what we want -- crosstest pure-Python high-level
+            # implementation and low-level C anext() iterators.
+            return await __anext__(iterator)
+        except StopAsyncIteration:
+            return default
+
+    return anext_impl()
+
+
+class NoLock:
+    """Dummy lock that provides the proper interface but no protection"""
+
+    async def __aenter__(self) -> None:
+        pass
+
+    async def __aexit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> bool:
+        return False
+
+
+async def tee_peer(
+    iterator: AsyncIterator[T],
+    # the buffer specific to this peer
+    buffer: Deque[T],
+    # the buffers of all peers, including our own
+    peers: List[Deque[T]],
+    lock: AsyncContextManager[Any],
+) -> AsyncGenerator[T, None]:
+    """An individual iterator of a :py:func:`~.tee`"""
+    try:
+        while True:
+            if not buffer:
+                async with lock:
+                    # Another peer produced an item while we were waiting for the lock.
+                    # Proceed with the next loop iteration to yield the item.
+                    if buffer:
+                        continue
+                    try:
+                        item = await iterator.__anext__()
+                    except StopAsyncIteration:
+                        break
+                    else:
+                        # Append to all buffers, including our own. We'll fetch our
+                        # item from the buffer again, instead of yielding it directly.
+                        # This ensures the proper item ordering if any of our peers
+                        # are fetching items concurrently. They may have buffered their
+                        # item already.
+                        for peer_buffer in peers:
+                            peer_buffer.append(item)
+            yield buffer.popleft()
+    finally:
+        async with lock:
+            # this peer is done – remove its buffer
+            for idx, peer_buffer in enumerate(peers):  # pragma: no branch
+                if peer_buffer is buffer:
+                    peers.pop(idx)
+                    break
+            # if we are the last peer, try and close the iterator
+            if not peers and hasattr(iterator, "aclose"):
+                await iterator.aclose()
+
+
+class Tee(Generic[T]):
+    """
+    Create ``n`` separate asynchronous iterators over ``iterable``
+
+    This splits a single ``iterable`` into multiple iterators, each providing
+    the same items in the same order.
+    All child iterators may advance separately but share the same items
+    from ``iterable`` -- when the most advanced iterator retrieves an item,
+    it is buffered until the least advanced iterator has yielded it as well.
+    A ``tee`` works lazily and can handle an infinite ``iterable``, provided
+    that all iterators advance.
+
+    .. code-block:: python3
+
+        async def derivative(sensor_data):
+            previous, current = a.tee(sensor_data, n=2)
+            await a.anext(previous)  # advance one iterator
+            return a.map(operator.sub, previous, current)
+
+    Unlike :py:func:`itertools.tee`, :py:func:`~.tee` returns a custom type instead
+    of a :py:class:`tuple`. Like a tuple, it can be indexed, iterated and unpacked
+    to get the child iterators. In addition, its :py:meth:`~.tee.aclose` method
+    immediately closes all children, and it can be used in an ``async with`` context
+    for the same effect.
+
+    If ``iterable`` is an iterator and read elsewhere, ``tee`` will *not*
+    provide these items. Also, ``tee`` must internally buffer each item until the
+    last iterator has yielded it; if the most and least advanced iterator differ
+    by most data, using a :py:class:`list` is more efficient (but not lazy).
+
+    If the underlying iterable is concurrency safe (``anext`` may be awaited
+    concurrently) the resulting iterators are concurrency safe as well. Otherwise,
+    the iterators are safe if there is only ever one single "most advanced" iterator.
+    To enforce sequential use of ``anext``, provide a ``lock``
+    - e.g. an :py:class:`asyncio.Lock` instance in an :py:mod:`asyncio` application -
+    and access is automatically synchronised.
+    """
+
+    def __init__(
+        self,
+        iterable: AsyncIterator[T],
+        n: int = 2,
+        *,
+        lock: Optional[AsyncContextManager[Any]] = None,
+    ):
+        self._iterator = iterable.__aiter__()  # before 3.10 aiter() doesn't exist
+        self._buffers: List[Deque[T]] = [deque() for _ in range(n)]
+        self._children = tuple(
+            tee_peer(
+                iterator=self._iterator,
+                buffer=buffer,
+                peers=self._buffers,
+                lock=lock if lock is not None else NoLock(),
+            )
+            for buffer in self._buffers
+        )
+
+    def __len__(self) -> int:
+        return len(self._children)
+
+    @overload
+    def __getitem__(self, item: int) -> AsyncIterator[T]:
+        ...
+
+    @overload
+    def __getitem__(self, item: slice) -> Tuple[AsyncIterator[T], ...]:
+        ...
+
+    def __getitem__(
+        self, item: Union[int, slice]
+    ) -> Union[AsyncIterator[T], Tuple[AsyncIterator[T], ...]]:
+        return self._children[item]
+
+    def __iter__(self) -> Iterator[AsyncIterator[T]]:
+        yield from self._children
+
+    async def __aenter__(self) -> "Tee[T]":
+        return self
+
+    async def __aexit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> bool:
+        await self.aclose()
+        return False
+
+    async def aclose(self) -> None:
+        for child in self._children:
+            await child.aclose()
+
+
+atee = Tee
diff --git a/llm/Lib/site-packages/langchain_core/utils/env.py b/llm/Lib/site-packages/langchain_core/utils/env.py
new file mode 100644
index 0000000000000000000000000000000000000000..e0841cbd9875a69f28b3d76acfb94d2a5bfda52b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/env.py
@@ -0,0 +1,45 @@
+from __future__ import annotations
+
+import os
+from typing import Any, Dict, Optional
+
+
+def env_var_is_set(env_var: str) -> bool:
+    """Check if an environment variable is set.
+
+    Args:
+        env_var (str): The name of the environment variable.
+
+    Returns:
+        bool: True if the environment variable is set, False otherwise.
+    """
+    return env_var in os.environ and os.environ[env_var] not in (
+        "",
+        "0",
+        "false",
+        "False",
+    )
+
+
+def get_from_dict_or_env(
+    data: Dict[str, Any], key: str, env_key: str, default: Optional[str] = None
+) -> str:
+    """Get a value from a dictionary or an environment variable."""
+    if key in data and data[key]:
+        return data[key]
+    else:
+        return get_from_env(key, env_key, default=default)
+
+
+def get_from_env(key: str, env_key: str, default: Optional[str] = None) -> str:
+    """Get a value from a dictionary or an environment variable."""
+    if env_key in os.environ and os.environ[env_key]:
+        return os.environ[env_key]
+    elif default is not None:
+        return default
+    else:
+        raise ValueError(
+            f"Did not find {key}, please add an environment variable"
+            f" `{env_key}` which contains it, or pass"
+            f" `{key}` as a named parameter."
+        )
diff --git a/llm/Lib/site-packages/langchain_core/utils/formatting.py b/llm/Lib/site-packages/langchain_core/utils/formatting.py
new file mode 100644
index 0000000000000000000000000000000000000000..d2e5376b6837c6f40d6cc95d35094e3447d96a64
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/formatting.py
@@ -0,0 +1,27 @@
+"""Utilities for formatting strings."""
+from string import Formatter
+from typing import Any, List, Mapping, Sequence
+
+
+class StrictFormatter(Formatter):
+    """Formatter that checks for extra keys."""
+
+    def vformat(
+        self, format_string: str, args: Sequence, kwargs: Mapping[str, Any]
+    ) -> str:
+        """Check that no arguments are provided."""
+        if len(args) > 0:
+            raise ValueError(
+                "No arguments should be provided, "
+                "everything should be passed as keyword arguments."
+            )
+        return super().vformat(format_string, args, kwargs)
+
+    def validate_input_variables(
+        self, format_string: str, input_variables: List[str]
+    ) -> None:
+        dummy_inputs = {input_variable: "foo" for input_variable in input_variables}
+        super().format(format_string, **dummy_inputs)
+
+
+formatter = StrictFormatter()
diff --git a/llm/Lib/site-packages/langchain_core/utils/function_calling.py b/llm/Lib/site-packages/langchain_core/utils/function_calling.py
new file mode 100644
index 0000000000000000000000000000000000000000..860259a93e35f5e21e1fd9a3d1b167a2b451fadd
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/function_calling.py
@@ -0,0 +1,434 @@
+"""Methods for creating function specs in the style of OpenAI Functions"""
+
+from __future__ import annotations
+
+import inspect
+import uuid
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
+
+from typing_extensions import TypedDict
+
+from langchain_core._api import deprecated
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    HumanMessage,
+    ToolMessage,
+)
+from langchain_core.pydantic_v1 import BaseModel
+from langchain_core.utils.json_schema import dereference_refs
+
+if TYPE_CHECKING:
+    from langchain_core.tools import BaseTool
+
+PYTHON_TO_JSON_TYPES = {
+    "str": "string",
+    "int": "integer",
+    "float": "number",
+    "bool": "boolean",
+}
+
+
+class FunctionDescription(TypedDict):
+    """Representation of a callable function to send to an LLM."""
+
+    name: str
+    """The name of the function."""
+    description: str
+    """A description of the function."""
+    parameters: dict
+    """The parameters of the function."""
+
+
+class ToolDescription(TypedDict):
+    """Representation of a callable function to the OpenAI API."""
+
+    type: Literal["function"]
+    function: FunctionDescription
+
+
+def _rm_titles(kv: dict, prev_key: str = "") -> dict:
+    new_kv = {}
+    for k, v in kv.items():
+        if k == "title":
+            if isinstance(v, dict) and prev_key == "properties" and "title" in v.keys():
+                new_kv[k] = _rm_titles(v, k)
+            else:
+                continue
+        elif isinstance(v, dict):
+            new_kv[k] = _rm_titles(v, k)
+        else:
+            new_kv[k] = v
+    return new_kv
+
+
+@deprecated(
+    "0.1.16",
+    alternative="langchain_core.utils.function_calling.convert_to_openai_function()",
+    removal="0.2.0",
+)
+def convert_pydantic_to_openai_function(
+    model: Type[BaseModel],
+    *,
+    name: Optional[str] = None,
+    description: Optional[str] = None,
+    rm_titles: bool = True,
+) -> FunctionDescription:
+    """Converts a Pydantic model to a function description for the OpenAI API."""
+    schema = dereference_refs(model.schema())
+    schema.pop("definitions", None)
+    title = schema.pop("title", "")
+    default_description = schema.pop("description", "")
+    return {
+        "name": name or title,
+        "description": description or default_description,
+        "parameters": _rm_titles(schema) if rm_titles else schema,
+    }
+
+
+@deprecated(
+    "0.1.16",
+    alternative="langchain_core.utils.function_calling.convert_to_openai_tool()",
+    removal="0.2.0",
+)
+def convert_pydantic_to_openai_tool(
+    model: Type[BaseModel],
+    *,
+    name: Optional[str] = None,
+    description: Optional[str] = None,
+) -> ToolDescription:
+    """Converts a Pydantic model to a function description for the OpenAI API."""
+    function = convert_pydantic_to_openai_function(
+        model, name=name, description=description
+    )
+    return {"type": "function", "function": function}
+
+
+def _get_python_function_name(function: Callable) -> str:
+    """Get the name of a Python function."""
+    return function.__name__
+
+
+def _parse_python_function_docstring(function: Callable) -> Tuple[str, dict]:
+    """Parse the function and argument descriptions from the docstring of a function.
+
+    Assumes the function docstring follows Google Python style guide.
+    """
+    docstring = inspect.getdoc(function)
+    if docstring:
+        docstring_blocks = docstring.split("\n\n")
+        descriptors = []
+        args_block = None
+        past_descriptors = False
+        for block in docstring_blocks:
+            if block.startswith("Args:"):
+                args_block = block
+                break
+            elif block.startswith("Returns:") or block.startswith("Example:"):
+                # Don't break in case Args come after
+                past_descriptors = True
+            elif not past_descriptors:
+                descriptors.append(block)
+            else:
+                continue
+        description = " ".join(descriptors)
+    else:
+        description = ""
+        args_block = None
+    arg_descriptions = {}
+    if args_block:
+        arg = None
+        for line in args_block.split("\n")[1:]:
+            if ":" in line:
+                arg, desc = line.split(":", maxsplit=1)
+                arg_descriptions[arg.strip()] = desc.strip()
+            elif arg:
+                arg_descriptions[arg.strip()] += " " + line.strip()
+    return description, arg_descriptions
+
+
+def _get_python_function_arguments(function: Callable, arg_descriptions: dict) -> dict:
+    """Get JsonSchema describing a Python functions arguments.
+
+    Assumes all function arguments are of primitive types (int, float, str, bool) or
+    are subclasses of pydantic.BaseModel.
+    """
+    properties = {}
+    annotations = inspect.getfullargspec(function).annotations
+    for arg, arg_type in annotations.items():
+        if arg == "return":
+            continue
+        if isinstance(arg_type, type) and issubclass(arg_type, BaseModel):
+            # Mypy error:
+            # "type" has no attribute "schema"
+            properties[arg] = arg_type.schema()  # type: ignore[attr-defined]
+        elif (
+            hasattr(arg_type, "__name__")
+            and getattr(arg_type, "__name__") in PYTHON_TO_JSON_TYPES
+        ):
+            properties[arg] = {"type": PYTHON_TO_JSON_TYPES[arg_type.__name__]}
+        elif (
+            hasattr(arg_type, "__dict__")
+            and getattr(arg_type, "__dict__").get("__origin__", None) == Literal
+        ):
+            properties[arg] = {
+                "enum": list(arg_type.__args__),  # type: ignore
+                "type": PYTHON_TO_JSON_TYPES[arg_type.__args__[0].__class__.__name__],  # type: ignore
+            }
+        if arg in arg_descriptions:
+            if arg not in properties:
+                properties[arg] = {}
+            properties[arg]["description"] = arg_descriptions[arg]
+    return properties
+
+
+def _get_python_function_required_args(function: Callable) -> List[str]:
+    """Get the required arguments for a Python function."""
+    spec = inspect.getfullargspec(function)
+    required = spec.args[: -len(spec.defaults)] if spec.defaults else spec.args
+    required += [k for k in spec.kwonlyargs if k not in (spec.kwonlydefaults or {})]
+
+    is_class = type(function) is type
+    if is_class and required[0] == "self":
+        required = required[1:]
+    return required
+
+
+@deprecated(
+    "0.1.16",
+    alternative="langchain_core.utils.function_calling.convert_to_openai_function()",
+    removal="0.2.0",
+)
+def convert_python_function_to_openai_function(
+    function: Callable,
+) -> Dict[str, Any]:
+    """Convert a Python function to an OpenAI function-calling API compatible dict.
+
+    Assumes the Python function has type hints and a docstring with a description. If
+        the docstring has Google Python style argument descriptions, these will be
+        included as well.
+    """
+    description, arg_descriptions = _parse_python_function_docstring(function)
+    return {
+        "name": _get_python_function_name(function),
+        "description": description,
+        "parameters": {
+            "type": "object",
+            "properties": _get_python_function_arguments(function, arg_descriptions),
+            "required": _get_python_function_required_args(function),
+        },
+    }
+
+
+@deprecated(
+    "0.1.16",
+    alternative="langchain_core.utils.function_calling.convert_to_openai_function()",
+    removal="0.2.0",
+)
+def format_tool_to_openai_function(tool: BaseTool) -> FunctionDescription:
+    """Format tool into the OpenAI function API."""
+    if tool.args_schema:
+        return convert_pydantic_to_openai_function(
+            tool.args_schema, name=tool.name, description=tool.description
+        )
+    else:
+        return {
+            "name": tool.name,
+            "description": tool.description,
+            "parameters": {
+                # This is a hack to get around the fact that some tools
+                # do not expose an args_schema, and expect an argument
+                # which is a string.
+                # And Open AI does not support an array type for the
+                # parameters.
+                "properties": {
+                    "__arg1": {"title": "__arg1", "type": "string"},
+                },
+                "required": ["__arg1"],
+                "type": "object",
+            },
+        }
+
+
+@deprecated(
+    "0.1.16",
+    alternative="langchain_core.utils.function_calling.convert_to_openai_tool()",
+    removal="0.2.0",
+)
+def format_tool_to_openai_tool(tool: BaseTool) -> ToolDescription:
+    """Format tool into the OpenAI function API."""
+    function = format_tool_to_openai_function(tool)
+    return {"type": "function", "function": function}
+
+
+def convert_to_openai_function(
+    function: Union[Dict[str, Any], Type[BaseModel], Callable, BaseTool],
+) -> Dict[str, Any]:
+    """Convert a raw function/class to an OpenAI function.
+
+    Args:
+        function: Either a dictionary, a pydantic.BaseModel class, or a Python function.
+            If a dictionary is passed in, it is assumed to already be a valid OpenAI
+            function or a JSON schema with top-level 'title' and 'description' keys
+            specified.
+
+    Returns:
+        A dict version of the passed in function which is compatible with the
+            OpenAI function-calling API.
+    """
+    from langchain_core.tools import BaseTool
+
+    # already in OpenAI function format
+    if isinstance(function, dict) and all(
+        k in function for k in ("name", "description", "parameters")
+    ):
+        return function
+    # a JSON schema with title and description
+    elif isinstance(function, dict) and all(
+        k in function for k in ("title", "description", "properties")
+    ):
+        function = function.copy()
+        return {
+            "name": function.pop("title"),
+            "description": function.pop("description"),
+            "parameters": function,
+        }
+    elif isinstance(function, type) and issubclass(function, BaseModel):
+        return cast(Dict, convert_pydantic_to_openai_function(function))
+    elif isinstance(function, BaseTool):
+        return cast(Dict, format_tool_to_openai_function(function))
+    elif callable(function):
+        return convert_python_function_to_openai_function(function)
+    else:
+        raise ValueError(
+            f"Unsupported function\n\n{function}\n\nFunctions must be passed in"
+            " as Dict, pydantic.BaseModel, or Callable. If they're a dict they must"
+            " either be in OpenAI function format or valid JSON schema with top-level"
+            " 'title' and 'description' keys."
+        )
+
+
+def convert_to_openai_tool(
+    tool: Union[Dict[str, Any], Type[BaseModel], Callable, BaseTool],
+) -> Dict[str, Any]:
+    """Convert a raw function/class to an OpenAI tool.
+
+    Args:
+        tool: Either a dictionary, a pydantic.BaseModel class, Python function, or
+            BaseTool. If a dictionary is passed in, it is assumed to already be a valid
+            OpenAI tool, OpenAI function, or a JSON schema with top-level 'title' and
+            'description' keys specified.
+
+    Returns:
+        A dict version of the passed in tool which is compatible with the
+            OpenAI tool-calling API.
+    """
+    if isinstance(tool, dict) and tool.get("type") == "function" and "function" in tool:
+        return tool
+    function = convert_to_openai_function(tool)
+    return {"type": "function", "function": function}
+
+
+def tool_example_to_messages(
+    input: str, tool_calls: List[BaseModel], tool_outputs: Optional[List[str]] = None
+) -> List[BaseMessage]:
+    """Convert an example into a list of messages that can be fed into an LLM.
+
+    This code is an adapter that converts a single example to a list of messages
+    that can be fed into a chat model.
+
+    The list of messages per example corresponds to:
+
+    1) HumanMessage: contains the content from which content should be extracted.
+    2) AIMessage: contains the extracted information from the model
+    3) ToolMessage: contains confirmation to the model that the model requested a tool
+        correctly.
+
+    The ToolMessage is required because some chat models are hyper-optimized for agents
+    rather than for an extraction use case.
+
+    Arguments:
+        input: string, the user input
+        tool_calls: List[BaseModel], a list of tool calls represented as Pydantic
+            BaseModels
+        tool_outputs: Optional[List[str]], a list of tool call outputs.
+            Does not need to be provided. If not provided, a placeholder value
+            will be inserted.
+
+    Returns:
+        A list of messages
+
+    Examples:
+
+        .. code-block:: python
+
+            from typing import List, Optional
+            from langchain_core.pydantic_v1 import BaseModel, Field
+            from langchain_openai import ChatOpenAI
+
+            class Person(BaseModel):
+                '''Information about a person.'''
+                name: Optional[str] = Field(..., description="The name of the person")
+                hair_color: Optional[str] = Field(
+                    ..., description="The color of the peron's eyes if known"
+                )
+                height_in_meters: Optional[str] = Field(
+                    ..., description="Height in METERs"
+                )
+
+            examples = [
+                (
+                    "The ocean is vast and blue. It's more than 20,000 feet deep.",
+                    Person(name=None, height_in_meters=None, hair_color=None),
+                ),
+                (
+                    "Fiona traveled far from France to Spain.",
+                    Person(name="Fiona", height_in_meters=None, hair_color=None),
+                ),
+            ]
+
+
+            messages = []
+
+            for txt, tool_call in examples:
+                messages.extend(
+                    tool_example_to_messages(txt, [tool_call])
+                )
+    """
+    messages: List[BaseMessage] = [HumanMessage(content=input)]
+    openai_tool_calls = []
+    for tool_call in tool_calls:
+        openai_tool_calls.append(
+            {
+                "id": str(uuid.uuid4()),
+                "type": "function",
+                "function": {
+                    # The name of the function right now corresponds to the name
+                    # of the pydantic model. This is implicit in the API right now,
+                    # and will be improved over time.
+                    "name": tool_call.__class__.__name__,
+                    "arguments": tool_call.json(),
+                },
+            }
+        )
+    messages.append(
+        AIMessage(content="", additional_kwargs={"tool_calls": openai_tool_calls})
+    )
+    tool_outputs = tool_outputs or ["You have correctly called this tool."] * len(
+        openai_tool_calls
+    )
+    for output, tool_call_dict in zip(tool_outputs, openai_tool_calls):
+        messages.append(ToolMessage(content=output, tool_call_id=tool_call_dict["id"]))  # type: ignore
+    return messages
diff --git a/llm/Lib/site-packages/langchain_core/utils/html.py b/llm/Lib/site-packages/langchain_core/utils/html.py
new file mode 100644
index 0000000000000000000000000000000000000000..837b19ed101daf7b330e4d1ee9b73f35c15a4d08
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/html.py
@@ -0,0 +1,116 @@
+import logging
+import re
+from typing import List, Optional, Sequence, Union
+from urllib.parse import urljoin, urlparse
+
+logger = logging.getLogger(__name__)
+
+PREFIXES_TO_IGNORE = ("javascript:", "mailto:", "#")
+SUFFIXES_TO_IGNORE = (
+    ".css",
+    ".js",
+    ".ico",
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".svg",
+    ".csv",
+    ".bz2",
+    ".zip",
+    ".epub",
+)
+SUFFIXES_TO_IGNORE_REGEX = (
+    "(?!" + "|".join([re.escape(s) + r"[\#'\"]" for s in SUFFIXES_TO_IGNORE]) + ")"
+)
+PREFIXES_TO_IGNORE_REGEX = (
+    "(?!" + "|".join([re.escape(s) for s in PREFIXES_TO_IGNORE]) + ")"
+)
+DEFAULT_LINK_REGEX = (
+    rf"href=[\"']{PREFIXES_TO_IGNORE_REGEX}((?:{SUFFIXES_TO_IGNORE_REGEX}.)*?)[\#'\"]"
+)
+
+
+def find_all_links(
+    raw_html: str, *, pattern: Union[str, re.Pattern, None] = None
+) -> List[str]:
+    """Extract all links from a raw html string.
+
+    Args:
+        raw_html: original html.
+        pattern: Regex to use for extracting links from raw html.
+
+    Returns:
+        List[str]: all links
+    """
+    pattern = pattern or DEFAULT_LINK_REGEX
+    return list(set(re.findall(pattern, raw_html)))
+
+
+def extract_sub_links(
+    raw_html: str,
+    url: str,
+    *,
+    base_url: Optional[str] = None,
+    pattern: Union[str, re.Pattern, None] = None,
+    prevent_outside: bool = True,
+    exclude_prefixes: Sequence[str] = (),
+    continue_on_failure: bool = False,
+) -> List[str]:
+    """Extract all links from a raw html string and convert into absolute paths.
+
+    Args:
+        raw_html: original html.
+        url: the url of the html.
+        base_url: the base url to check for outside links against.
+        pattern: Regex to use for extracting links from raw html.
+        prevent_outside: If True, ignore external links which are not children
+            of the base url.
+        exclude_prefixes: Exclude any URLs that start with one of these prefixes.
+        continue_on_failure: If True, continue if parsing a specific link raises an
+            exception. Otherwise, raise the exception.
+    Returns:
+        List[str]: sub links
+    """
+    base_url_to_use = base_url if base_url is not None else url
+    parsed_base_url = urlparse(base_url_to_use)
+    parsed_url = urlparse(url)
+    all_links = find_all_links(raw_html, pattern=pattern)
+    absolute_paths = set()
+    for link in all_links:
+        try:
+            parsed_link = urlparse(link)
+            # Some may be absolute links like https://to/path
+            if parsed_link.scheme == "http" or parsed_link.scheme == "https":
+                absolute_path = link
+            # Some may have omitted the protocol like //to/path
+            elif link.startswith("//"):
+                absolute_path = f"{parsed_url.scheme}:{link}"
+            else:
+                absolute_path = urljoin(url, parsed_link.path)
+            absolute_paths.add(absolute_path)
+        except Exception as e:
+            if continue_on_failure:
+                logger.warning(f"Unable to load link {link}. Raised exception:\n\n{e}")
+                continue
+            else:
+                raise e
+
+    results = []
+    for path in absolute_paths:
+        if any(path.startswith(exclude_prefix) for exclude_prefix in exclude_prefixes):
+            continue
+
+        if prevent_outside:
+            parsed_path = urlparse(path)
+
+            if parsed_base_url.netloc != parsed_path.netloc:
+                continue
+
+            # Will take care of verifying rest of path after netloc
+            # if it's more specific
+            if not path.startswith(base_url_to_use):
+                continue
+
+        results.append(path)
+    return results
diff --git a/llm/Lib/site-packages/langchain_core/utils/image.py b/llm/Lib/site-packages/langchain_core/utils/image.py
new file mode 100644
index 0000000000000000000000000000000000000000..b59682bd37f1bb76d957f3bcb07ec363b609da09
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/image.py
@@ -0,0 +1,14 @@
+import base64
+import mimetypes
+
+
+def encode_image(image_path: str) -> str:
+    """Get base64 string from image URI."""
+    with open(image_path, "rb") as image_file:
+        return base64.b64encode(image_file.read()).decode("utf-8")
+
+
+def image_to_data_url(image_path: str) -> str:
+    encoding = encode_image(image_path)
+    mime_type = mimetypes.guess_type(image_path)[0]
+    return f"data:{mime_type};base64,{encoding}"
diff --git a/llm/Lib/site-packages/langchain_core/utils/input.py b/llm/Lib/site-packages/langchain_core/utils/input.py
new file mode 100644
index 0000000000000000000000000000000000000000..beb8b653d1e8b692ff74efecb1ed01d33e5b87d4
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/input.py
@@ -0,0 +1,43 @@
+"""Handle chained inputs."""
+
+from typing import Dict, List, Optional, TextIO
+
+_TEXT_COLOR_MAPPING = {
+    "blue": "36;1",
+    "yellow": "33;1",
+    "pink": "38;5;200",
+    "green": "32;1",
+    "red": "31;1",
+}
+
+
+def get_color_mapping(
+    items: List[str], excluded_colors: Optional[List] = None
+) -> Dict[str, str]:
+    """Get mapping for items to a support color."""
+    colors = list(_TEXT_COLOR_MAPPING.keys())
+    if excluded_colors is not None:
+        colors = [c for c in colors if c not in excluded_colors]
+    color_mapping = {item: colors[i % len(colors)] for i, item in enumerate(items)}
+    return color_mapping
+
+
+def get_colored_text(text: str, color: str) -> str:
+    """Get colored text."""
+    color_str = _TEXT_COLOR_MAPPING[color]
+    return f"\u001b[{color_str}m\033[1;3m{text}\u001b[0m"
+
+
+def get_bolded_text(text: str) -> str:
+    """Get bolded text."""
+    return f"\033[1m{text}\033[0m"
+
+
+def print_text(
+    text: str, color: Optional[str] = None, end: str = "", file: Optional[TextIO] = None
+) -> None:
+    """Print text with highlighting and no end characters."""
+    text_to_print = get_colored_text(text, color) if color else text
+    print(text_to_print, end=end, file=file)  # noqa: T201
+    if file:
+        file.flush()  # ensure all printed content are written to file
diff --git a/llm/Lib/site-packages/langchain_core/utils/interactive_env.py b/llm/Lib/site-packages/langchain_core/utils/interactive_env.py
new file mode 100644
index 0000000000000000000000000000000000000000..7752b6b403cc1df30c5803891f53c94512e5e704
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/interactive_env.py
@@ -0,0 +1,5 @@
+def is_interactive_env() -> bool:
+    """Determine if running within IPython or Jupyter."""
+    import sys
+
+    return hasattr(sys, "ps2")
diff --git a/llm/Lib/site-packages/langchain_core/utils/iter.py b/llm/Lib/site-packages/langchain_core/utils/iter.py
new file mode 100644
index 0000000000000000000000000000000000000000..4191ea9ab5d57844a4fd1913270305bdfdb96da0
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/iter.py
@@ -0,0 +1,183 @@
+from collections import deque
+from itertools import islice
+from typing import (
+    Any,
+    ContextManager,
+    Deque,
+    Generator,
+    Generic,
+    Iterable,
+    Iterator,
+    List,
+    Optional,
+    Tuple,
+    TypeVar,
+    Union,
+    overload,
+)
+
+from typing_extensions import Literal
+
+T = TypeVar("T")
+
+
+class NoLock:
+    """Dummy lock that provides the proper interface but no protection"""
+
+    def __enter__(self) -> None:
+        pass
+
+    def __exit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> Literal[False]:
+        return False
+
+
+def tee_peer(
+    iterator: Iterator[T],
+    # the buffer specific to this peer
+    buffer: Deque[T],
+    # the buffers of all peers, including our own
+    peers: List[Deque[T]],
+    lock: ContextManager[Any],
+) -> Generator[T, None, None]:
+    """An individual iterator of a :py:func:`~.tee`"""
+    try:
+        while True:
+            if not buffer:
+                with lock:
+                    # Another peer produced an item while we were waiting for the lock.
+                    # Proceed with the next loop iteration to yield the item.
+                    if buffer:
+                        continue
+                    try:
+                        item = next(iterator)
+                    except StopIteration:
+                        break
+                    else:
+                        # Append to all buffers, including our own. We'll fetch our
+                        # item from the buffer again, instead of yielding it directly.
+                        # This ensures the proper item ordering if any of our peers
+                        # are fetching items concurrently. They may have buffered their
+                        # item already.
+                        for peer_buffer in peers:
+                            peer_buffer.append(item)
+            yield buffer.popleft()
+    finally:
+        with lock:
+            # this peer is done – remove its buffer
+            for idx, peer_buffer in enumerate(peers):  # pragma: no branch
+                if peer_buffer is buffer:
+                    peers.pop(idx)
+                    break
+            # if we are the last peer, try and close the iterator
+            if not peers and hasattr(iterator, "close"):
+                iterator.close()
+
+
+class Tee(Generic[T]):
+    """
+    Create ``n`` separate asynchronous iterators over ``iterable``
+
+    This splits a single ``iterable`` into multiple iterators, each providing
+    the same items in the same order.
+    All child iterators may advance separately but share the same items
+    from ``iterable`` -- when the most advanced iterator retrieves an item,
+    it is buffered until the least advanced iterator has yielded it as well.
+    A ``tee`` works lazily and can handle an infinite ``iterable``, provided
+    that all iterators advance.
+
+    .. code-block:: python3
+
+        async def derivative(sensor_data):
+            previous, current = a.tee(sensor_data, n=2)
+            await a.anext(previous)  # advance one iterator
+            return a.map(operator.sub, previous, current)
+
+    Unlike :py:func:`itertools.tee`, :py:func:`~.tee` returns a custom type instead
+    of a :py:class:`tuple`. Like a tuple, it can be indexed, iterated and unpacked
+    to get the child iterators. In addition, its :py:meth:`~.tee.aclose` method
+    immediately closes all children, and it can be used in an ``async with`` context
+    for the same effect.
+
+    If ``iterable`` is an iterator and read elsewhere, ``tee`` will *not*
+    provide these items. Also, ``tee`` must internally buffer each item until the
+    last iterator has yielded it; if the most and least advanced iterator differ
+    by most data, using a :py:class:`list` is more efficient (but not lazy).
+
+    If the underlying iterable is concurrency safe (``anext`` may be awaited
+    concurrently) the resulting iterators are concurrency safe as well. Otherwise,
+    the iterators are safe if there is only ever one single "most advanced" iterator.
+    To enforce sequential use of ``anext``, provide a ``lock``
+    - e.g. an :py:class:`asyncio.Lock` instance in an :py:mod:`asyncio` application -
+    and access is automatically synchronised.
+    """
+
+    def __init__(
+        self,
+        iterable: Iterator[T],
+        n: int = 2,
+        *,
+        lock: Optional[ContextManager[Any]] = None,
+    ):
+        self._iterator = iter(iterable)
+        self._buffers: List[Deque[T]] = [deque() for _ in range(n)]
+        self._children = tuple(
+            tee_peer(
+                iterator=self._iterator,
+                buffer=buffer,
+                peers=self._buffers,
+                lock=lock if lock is not None else NoLock(),
+            )
+            for buffer in self._buffers
+        )
+
+    def __len__(self) -> int:
+        return len(self._children)
+
+    @overload
+    def __getitem__(self, item: int) -> Iterator[T]:
+        ...
+
+    @overload
+    def __getitem__(self, item: slice) -> Tuple[Iterator[T], ...]:
+        ...
+
+    def __getitem__(
+        self, item: Union[int, slice]
+    ) -> Union[Iterator[T], Tuple[Iterator[T], ...]]:
+        return self._children[item]
+
+    def __iter__(self) -> Iterator[Iterator[T]]:
+        yield from self._children
+
+    def __enter__(self) -> "Tee[T]":
+        return self
+
+    def __exit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> Literal[False]:
+        self.close()
+        return False
+
+    def close(self) -> None:
+        for child in self._children:
+            child.close()
+
+
+# Why this is needed https://stackoverflow.com/a/44638570
+safetee = Tee
+
+
+def batch_iterate(size: Optional[int], iterable: Iterable[T]) -> Iterator[List[T]]:
+    """Utility batching function.
+
+    Args:
+        size: The size of the batch. If None, returns a single batch.
+        iterable: The iterable to batch.
+
+    Returns:
+        An iterator over the batches.
+    """
+    it = iter(iterable)
+    while True:
+        chunk = list(islice(it, size))
+        if not chunk:
+            return
+        yield chunk
diff --git a/llm/Lib/site-packages/langchain_core/utils/json.py b/llm/Lib/site-packages/langchain_core/utils/json.py
new file mode 100644
index 0000000000000000000000000000000000000000..e7867a3a82831c252df6c1f530bf29f5afe8c4d1
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/json.py
@@ -0,0 +1,185 @@
+from __future__ import annotations
+
+import json
+import re
+from typing import Any, Callable, List
+
+from langchain_core.exceptions import OutputParserException
+
+
+def _replace_new_line(match: re.Match[str]) -> str:
+    value = match.group(2)
+    value = re.sub(r"\n", r"\\n", value)
+    value = re.sub(r"\r", r"\\r", value)
+    value = re.sub(r"\t", r"\\t", value)
+    value = re.sub(r'(?<!\\)"', r"\"", value)
+
+    return match.group(1) + value + match.group(3)
+
+
+def _custom_parser(multiline_string: str) -> str:
+    """
+    The LLM response for `action_input` may be a multiline
+    string containing unescaped newlines, tabs or quotes. This function
+    replaces those characters with their escaped counterparts.
+    (newlines in JSON must be double-escaped: `\\n`)
+    """
+    if isinstance(multiline_string, (bytes, bytearray)):
+        multiline_string = multiline_string.decode()
+
+    multiline_string = re.sub(
+        r'("action_input"\:\s*")(.*?)(")',
+        _replace_new_line,
+        multiline_string,
+        flags=re.DOTALL,
+    )
+
+    return multiline_string
+
+
+# Adapted from https://github.com/KillianLucas/open-interpreter/blob/5b6080fae1f8c68938a1e4fa8667e3744084ee21/interpreter/utils/parse_partial_json.py
+# MIT License
+
+
+def parse_partial_json(s: str, *, strict: bool = False) -> Any:
+    """Parse a JSON string that may be missing closing braces.
+
+    Args:
+        s: The JSON string to parse.
+        strict: Whether to use strict parsing. Defaults to False.
+
+    Returns:
+        The parsed JSON object as a Python dictionary.
+    """
+    # Attempt to parse the string as-is.
+    try:
+        return json.loads(s, strict=strict)
+    except json.JSONDecodeError:
+        pass
+
+    # Initialize variables.
+    new_s = ""
+    stack = []
+    is_inside_string = False
+    escaped = False
+
+    # Process each character in the string one at a time.
+    for char in s:
+        if is_inside_string:
+            if char == '"' and not escaped:
+                is_inside_string = False
+            elif char == "\n" and not escaped:
+                char = "\\n"  # Replace the newline character with the escape sequence.
+            elif char == "\\":
+                escaped = not escaped
+            else:
+                escaped = False
+        else:
+            if char == '"':
+                is_inside_string = True
+                escaped = False
+            elif char == "{":
+                stack.append("}")
+            elif char == "[":
+                stack.append("]")
+            elif char == "}" or char == "]":
+                if stack and stack[-1] == char:
+                    stack.pop()
+                else:
+                    # Mismatched closing character; the input is malformed.
+                    return None
+
+        # Append the processed character to the new string.
+        new_s += char
+
+    # If we're still inside a string at the end of processing,
+    # we need to close the string.
+    if is_inside_string:
+        new_s += '"'
+
+    # Try to parse mods of string until we succeed or run out of characters.
+    while new_s:
+        final_s = new_s
+
+        # Close any remaining open structures in the reverse
+        # order that they were opened.
+        for closing_char in reversed(stack):
+            final_s += closing_char
+
+        # Attempt to parse the modified string as JSON.
+        try:
+            return json.loads(final_s, strict=strict)
+        except json.JSONDecodeError:
+            # If we still can't parse the string as JSON,
+            # try removing the last character
+            new_s = new_s[:-1]
+
+    # If we got here, we ran out of characters to remove
+    # and still couldn't parse the string as JSON, so return the parse error
+    # for the original string.
+    return json.loads(s, strict=strict)
+
+
+def parse_json_markdown(
+    json_string: str, *, parser: Callable[[str], Any] = parse_partial_json
+) -> dict:
+    """
+    Parse a JSON string from a Markdown string.
+
+    Args:
+        json_string: The Markdown string.
+
+    Returns:
+        The parsed JSON object as a Python dictionary.
+    """
+    try:
+        return _parse_json(json_string, parser=parser)
+    except json.JSONDecodeError:
+        # Try to find JSON string within triple backticks
+        match = re.search(r"```(json)?(.*)", json_string, re.DOTALL)
+
+        # If no match found, assume the entire string is a JSON string
+        if match is None:
+            json_str = json_string
+        else:
+            # If match found, use the content within the backticks
+            json_str = match.group(2)
+    return _parse_json(json_str, parser=parser)
+
+
+def _parse_json(
+    json_str: str, *, parser: Callable[[str], Any] = parse_partial_json
+) -> dict:
+    # Strip whitespace and newlines from the start and end
+    json_str = json_str.strip().strip("`")
+
+    # handle newlines and other special characters inside the returned value
+    json_str = _custom_parser(json_str)
+
+    # Parse the JSON string into a Python dictionary
+    return parser(json_str)
+
+
+def parse_and_check_json_markdown(text: str, expected_keys: List[str]) -> dict:
+    """
+    Parse a JSON string from a Markdown string and check that it
+    contains the expected keys.
+
+    Args:
+        text: The Markdown string.
+        expected_keys: The expected keys in the JSON string.
+
+    Returns:
+        The parsed JSON object as a Python dictionary.
+    """
+    try:
+        json_obj = parse_json_markdown(text)
+    except json.JSONDecodeError as e:
+        raise OutputParserException(f"Got invalid JSON object. Error: {e}")
+    for key in expected_keys:
+        if key not in json_obj:
+            raise OutputParserException(
+                f"Got invalid return object. Expected key `{key}` "
+                f"to be present, but got {json_obj}"
+            )
+    return json_obj
diff --git a/llm/Lib/site-packages/langchain_core/utils/json_schema.py b/llm/Lib/site-packages/langchain_core/utils/json_schema.py
new file mode 100644
index 0000000000000000000000000000000000000000..aecdae470d8498045e09c9614224b23b411fcfd5
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/json_schema.py
@@ -0,0 +1,101 @@
+from __future__ import annotations
+
+from copy import deepcopy
+from typing import Any, Dict, List, Optional, Sequence, Set
+
+
+def _retrieve_ref(path: str, schema: dict) -> dict:
+    components = path.split("/")
+    if components[0] != "#":
+        raise ValueError(
+            "ref paths are expected to be URI fragments, meaning they should start "
+            "with #."
+        )
+    out = schema
+    for component in components[1:]:
+        if component.isdigit():
+            out = out[int(component)]
+        else:
+            out = out[component]
+    return deepcopy(out)
+
+
+def _dereference_refs_helper(
+    obj: Any,
+    full_schema: Dict[str, Any],
+    skip_keys: Sequence[str],
+    processed_refs: Optional[Set[str]] = None,
+) -> Any:
+    if processed_refs is None:
+        processed_refs = set()
+
+    if isinstance(obj, dict):
+        obj_out = {}
+        for k, v in obj.items():
+            if k in skip_keys:
+                obj_out[k] = v
+            elif k == "$ref":
+                if v in processed_refs:
+                    continue
+                processed_refs.add(v)
+                ref = _retrieve_ref(v, full_schema)
+                full_ref = _dereference_refs_helper(
+                    ref, full_schema, skip_keys, processed_refs
+                )
+                processed_refs.remove(v)
+                return full_ref
+            elif isinstance(v, (list, dict)):
+                obj_out[k] = _dereference_refs_helper(
+                    v, full_schema, skip_keys, processed_refs
+                )
+            else:
+                obj_out[k] = v
+        return obj_out
+    elif isinstance(obj, list):
+        return [
+            _dereference_refs_helper(el, full_schema, skip_keys, processed_refs)
+            for el in obj
+        ]
+    else:
+        return obj
+
+
+def _infer_skip_keys(
+    obj: Any, full_schema: dict, processed_refs: Optional[Set[str]] = None
+) -> List[str]:
+    if processed_refs is None:
+        processed_refs = set()
+
+    keys = []
+    if isinstance(obj, dict):
+        for k, v in obj.items():
+            if k == "$ref":
+                if v in processed_refs:
+                    continue
+                processed_refs.add(v)
+                ref = _retrieve_ref(v, full_schema)
+                keys.append(v.split("/")[1])
+                keys += _infer_skip_keys(ref, full_schema, processed_refs)
+            elif isinstance(v, (list, dict)):
+                keys += _infer_skip_keys(v, full_schema, processed_refs)
+    elif isinstance(obj, list):
+        for el in obj:
+            keys += _infer_skip_keys(el, full_schema, processed_refs)
+    return keys
+
+
+def dereference_refs(
+    schema_obj: dict,
+    *,
+    full_schema: Optional[dict] = None,
+    skip_keys: Optional[Sequence[str]] = None,
+) -> dict:
+    """Try to substitute $refs in JSON Schema."""
+
+    full_schema = full_schema or schema_obj
+    skip_keys = (
+        skip_keys
+        if skip_keys is not None
+        else _infer_skip_keys(schema_obj, full_schema)
+    )
+    return _dereference_refs_helper(schema_obj, full_schema, skip_keys)
diff --git a/llm/Lib/site-packages/langchain_core/utils/loading.py b/llm/Lib/site-packages/langchain_core/utils/loading.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9abf7ee7a37927ea60e72a715e564237fb6004b
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/loading.py
@@ -0,0 +1,28 @@
+"""Utilities for loading configurations from langchain_core-hub."""
+
+import warnings
+from typing import Any
+
+from langchain_core._api.deprecation import deprecated
+
+
+@deprecated(
+    since="0.1.30",
+    removal="0.2",
+    message=(
+        "Using the hwchase17/langchain-hub "
+        "repo for prompts is deprecated. Please use "
+        "https://smith.langchain.com/hub instead."
+    ),
+)
+def try_load_from_hub(
+    *args: Any,
+    **kwargs: Any,
+) -> Any:
+    warnings.warn(
+        "Loading from the deprecated github-based Hub is no longer supported. "
+        "Please use the new LangChain Hub at https://smith.langchain.com/hub instead."
+    )
+    # return None, which indicates that we shouldn't load from old hub
+    # and might just be a filepath for e.g. load_chain
+    return None
diff --git a/llm/Lib/site-packages/langchain_core/utils/mustache.py b/llm/Lib/site-packages/langchain_core/utils/mustache.py
new file mode 100644
index 0000000000000000000000000000000000000000..06ea9cd002fc0bc13e0a9d17565ab46dfab7d6bc
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/mustache.py
@@ -0,0 +1,641 @@
+"""
+Adapted from https://github.com/noahmorrison/chevron
+MIT License
+"""
+
+import logging
+from typing import (
+    Any,
+    Dict,
+    Iterator,
+    List,
+    Literal,
+    Optional,
+    Sequence,
+    Tuple,
+    Union,
+    cast,
+)
+
+from typing_extensions import TypeAlias
+
+logger = logging.getLogger(__name__)
+
+
+Scopes: TypeAlias = List[Union[Literal[False, 0], Dict[str, Any]]]
+
+
+# Globals
+_CURRENT_LINE = 1
+_LAST_TAG_LINE = None
+
+
+class ChevronError(SyntaxError):
+    pass
+
+
+#
+# Helper functions
+#
+
+
+def grab_literal(template: str, l_del: str) -> Tuple[str, str]:
+    """Parse a literal from the template"""
+
+    global _CURRENT_LINE
+
+    try:
+        # Look for the next tag and move the template to it
+        literal, template = template.split(l_del, 1)
+        _CURRENT_LINE += literal.count("\n")
+        return (literal, template)
+
+    # There are no more tags in the template?
+    except ValueError:
+        # Then the rest of the template is a literal
+        return (template, "")
+
+
+def l_sa_check(template: str, literal: str, is_standalone: bool) -> bool:
+    """Do a preliminary check to see if a tag could be a standalone"""
+
+    # If there is a newline, or the previous tag was a standalone
+    if literal.find("\n") != -1 or is_standalone:
+        padding = literal.split("\n")[-1]
+
+        # If all the characters since the last newline are spaces
+        if padding.isspace() or padding == "":
+            # Then the next tag could be a standalone
+            return True
+        else:
+            # Otherwise it can't be
+            return False
+    else:
+        return False
+
+
+def r_sa_check(template: str, tag_type: str, is_standalone: bool) -> bool:
+    """Do a final checkto see if a tag could be a standalone"""
+
+    # Check right side if we might be a standalone
+    if is_standalone and tag_type not in ["variable", "no escape"]:
+        on_newline = template.split("\n", 1)
+
+        # If the stuff to the right of us are spaces we're a standalone
+        if on_newline[0].isspace() or not on_newline[0]:
+            return True
+        else:
+            return False
+
+    # If we're a tag can't be a standalone
+    else:
+        return False
+
+
+def parse_tag(template: str, l_del: str, r_del: str) -> Tuple[Tuple[str, str], str]:
+    """Parse a tag from a template"""
+    global _CURRENT_LINE
+    global _LAST_TAG_LINE
+
+    tag_types = {
+        "!": "comment",
+        "#": "section",
+        "^": "inverted section",
+        "/": "end",
+        ">": "partial",
+        "=": "set delimiter?",
+        "{": "no escape?",
+        "&": "no escape",
+    }
+
+    # Get the tag
+    try:
+        tag, template = template.split(r_del, 1)
+    except ValueError:
+        raise ChevronError("unclosed tag " "at line {0}".format(_CURRENT_LINE))
+
+    # Find the type meaning of the first character
+    tag_type = tag_types.get(tag[0], "variable")
+
+    # If the type is not a variable
+    if tag_type != "variable":
+        # Then that first character is not needed
+        tag = tag[1:]
+
+    # If we might be a set delimiter tag
+    if tag_type == "set delimiter?":
+        # Double check to make sure we are
+        if tag.endswith("="):
+            tag_type = "set delimiter"
+            # Remove the equal sign
+            tag = tag[:-1]
+
+        # Otherwise we should complain
+        else:
+            raise ChevronError(
+                "unclosed set delimiter tag\n" "at line {0}".format(_CURRENT_LINE)
+            )
+
+    # If we might be a no html escape tag
+    elif tag_type == "no escape?":
+        # And we have a third curly brace
+        # (And are using curly braces as delimiters)
+        if l_del == "{{" and r_del == "}}" and template.startswith("}"):
+            # Then we are a no html escape tag
+            template = template[1:]
+            tag_type = "no escape"
+
+    # Strip the whitespace off the key and return
+    return ((tag_type, tag.strip()), template)
+
+
+#
+# The main tokenizing function
+#
+
+
+def tokenize(
+    template: str, def_ldel: str = "{{", def_rdel: str = "}}"
+) -> Iterator[Tuple[str, str]]:
+    """Tokenize a mustache template
+
+    Tokenizes a mustache template in a generator fashion,
+    using file-like objects. It also accepts a string containing
+    the template.
+
+
+    Arguments:
+
+    template -- a file-like object, or a string of a mustache template
+
+    def_ldel -- The default left delimiter
+                ("{{" by default, as in spec compliant mustache)
+
+    def_rdel -- The default right delimiter
+                ("}}" by default, as in spec compliant mustache)
+
+
+    Returns:
+
+    A generator of mustache tags in the form of a tuple
+
+    -- (tag_type, tag_key)
+
+    Where tag_type is one of:
+     * literal
+     * section
+     * inverted section
+     * end
+     * partial
+     * no escape
+
+    And tag_key is either the key or in the case of a literal tag,
+    the literal itself.
+    """
+
+    global _CURRENT_LINE, _LAST_TAG_LINE
+    _CURRENT_LINE = 1
+    _LAST_TAG_LINE = None
+
+    is_standalone = True
+    open_sections = []
+    l_del = def_ldel
+    r_del = def_rdel
+
+    while template:
+        literal, template = grab_literal(template, l_del)
+
+        # If the template is completed
+        if not template:
+            # Then yield the literal and leave
+            yield ("literal", literal)
+            break
+
+        # Do the first check to see if we could be a standalone
+        is_standalone = l_sa_check(template, literal, is_standalone)
+
+        # Parse the tag
+        tag, template = parse_tag(template, l_del, r_del)
+        tag_type, tag_key = tag
+
+        # Special tag logic
+
+        # If we are a set delimiter tag
+        if tag_type == "set delimiter":
+            # Then get and set the delimiters
+            dels = tag_key.strip().split(" ")
+            l_del, r_del = dels[0], dels[-1]
+
+        # If we are a section tag
+        elif tag_type in ["section", "inverted section"]:
+            # Then open a new section
+            open_sections.append(tag_key)
+            _LAST_TAG_LINE = _CURRENT_LINE
+
+        # If we are an end tag
+        elif tag_type == "end":
+            # Then check to see if the last opened section
+            # is the same as us
+            try:
+                last_section = open_sections.pop()
+            except IndexError:
+                raise ChevronError(
+                    'Trying to close tag "{0}"\n'
+                    "Looks like it was not opened.\n"
+                    "line {1}".format(tag_key, _CURRENT_LINE + 1)
+                )
+            if tag_key != last_section:
+                # Otherwise we need to complain
+                raise ChevronError(
+                    'Trying to close tag "{0}"\n'
+                    'last open tag is "{1}"\n'
+                    "line {2}".format(tag_key, last_section, _CURRENT_LINE + 1)
+                )
+
+        # Do the second check to see if we're a standalone
+        is_standalone = r_sa_check(template, tag_type, is_standalone)
+
+        # Which if we are
+        if is_standalone:
+            # Remove the stuff before the newline
+            template = template.split("\n", 1)[-1]
+
+            # Partials need to keep the spaces on their left
+            if tag_type != "partial":
+                # But other tags don't
+                literal = literal.rstrip(" ")
+
+        # Start yielding
+        # Ignore literals that are empty
+        if literal != "":
+            yield ("literal", literal)
+
+        # Ignore comments and set delimiters
+        if tag_type not in ["comment", "set delimiter?"]:
+            yield (tag_type, tag_key)
+
+    # If there are any open sections when we're done
+    if open_sections:
+        # Then we need to complain
+        raise ChevronError(
+            "Unexpected EOF\n"
+            'the tag "{0}" was never closed\n'
+            "was opened at line {1}".format(open_sections[-1], _LAST_TAG_LINE)
+        )
+
+
+#
+# Helper functions
+#
+
+
+def _html_escape(string: str) -> str:
+    """HTML escape all of these " & < >"""
+
+    html_codes = {
+        '"': "&quot;",
+        "<": "&lt;",
+        ">": "&gt;",
+    }
+
+    # & must be handled first
+    string = string.replace("&", "&amp;")
+    for char in html_codes:
+        string = string.replace(char, html_codes[char])
+    return string
+
+
+def _get_key(
+    key: str,
+    scopes: Scopes,
+    warn: bool,
+    keep: bool,
+    def_ldel: str,
+    def_rdel: str,
+) -> Any:
+    """Get a key from the current scope"""
+
+    # If the key is a dot
+    if key == ".":
+        # Then just return the current scope
+        return scopes[0]
+
+    # Loop through the scopes
+    for scope in scopes:
+        try:
+            # Return an empty string if falsy, with two exceptions
+            # 0 should return 0, and False should return False
+            if scope in (0, False):
+                return scope
+
+            # For every dot separated key
+            for child in key.split("."):
+                # Return an empty string if falsy, with two exceptions
+                # 0 should return 0, and False should return False
+                if scope in (0, False):
+                    return scope
+                # Move into the scope
+                try:
+                    # Try subscripting (Normal dictionaries)
+                    scope = cast(Dict[str, Any], scope)[child]
+                except (TypeError, AttributeError):
+                    try:
+                        scope = getattr(scope, child)
+                    except (TypeError, AttributeError):
+                        # Try as a list
+                        scope = scope[int(child)]  # type: ignore
+
+            try:
+                # This allows for custom falsy data types
+                # https://github.com/noahmorrison/chevron/issues/35
+                if scope._CHEVRON_return_scope_when_falsy:  # type: ignore
+                    return scope
+            except AttributeError:
+                return scope or ""
+        except (AttributeError, KeyError, IndexError, ValueError):
+            # We couldn't find the key in the current scope
+            # We'll try again on the next pass
+            pass
+
+    # We couldn't find the key in any of the scopes
+
+    if warn:
+        logger.warn("Could not find key '%s'" % (key))
+
+    if keep:
+        return "%s %s %s" % (def_ldel, key, def_rdel)
+
+    return ""
+
+
+def _get_partial(name: str, partials_dict: Dict[str, str]) -> str:
+    """Load a partial"""
+    try:
+        # Maybe the partial is in the dictionary
+        return partials_dict[name]
+    except KeyError:
+        return ""
+
+
+#
+# The main rendering function
+#
+g_token_cache: Dict[str, List[Tuple[str, str]]] = {}
+
+
+def render(
+    template: Union[str, List[Tuple[str, str]]] = "",
+    data: Dict[str, Any] = {},
+    partials_dict: Dict[str, str] = {},
+    padding: str = "",
+    def_ldel: str = "{{",
+    def_rdel: str = "}}",
+    scopes: Optional[Scopes] = None,
+    warn: bool = False,
+    keep: bool = False,
+) -> str:
+    """Render a mustache template.
+
+    Renders a mustache template with a data scope and inline partial capability.
+
+    Arguments:
+
+    template      -- A file-like object or a string containing the template
+
+    data          -- A python dictionary with your data scope
+
+    partials_path -- The path to where your partials are stored
+                     If set to None, then partials won't be loaded from the file system
+                     (defaults to '.')
+
+    partials_ext  -- The extension that you want the parser to look for
+                     (defaults to 'mustache')
+
+    partials_dict -- A python dictionary which will be search for partials
+                     before the filesystem is. {'include': 'foo'} is the same
+                     as a file called include.mustache
+                     (defaults to {})
+
+    padding       -- This is for padding partials, and shouldn't be used
+                     (but can be if you really want to)
+
+    def_ldel      -- The default left delimiter
+                     ("{{" by default, as in spec compliant mustache)
+
+    def_rdel      -- The default right delimiter
+                     ("}}" by default, as in spec compliant mustache)
+
+    scopes        -- The list of scopes that get_key will look through
+
+    warn          -- Log a warning when a template substitution isn't found in the data
+
+    keep          -- Keep unreplaced tags when a substitution isn't found in the data
+
+
+    Returns:
+
+    A string containing the rendered template.
+    """
+
+    # If the template is a sequence but not derived from a string
+    if isinstance(template, Sequence) and not isinstance(template, str):
+        # Then we don't need to tokenize it
+        # But it does need to be a generator
+        tokens: Iterator[Tuple[str, str]] = (token for token in template)
+    else:
+        if template in g_token_cache:
+            tokens = (token for token in g_token_cache[template])
+        else:
+            # Otherwise make a generator
+            tokens = tokenize(template, def_ldel, def_rdel)
+
+    output = ""
+
+    if scopes is None:
+        scopes = [data]
+
+    # Run through the tokens
+    for tag, key in tokens:
+        # Set the current scope
+        current_scope = scopes[0]
+
+        # If we're an end tag
+        if tag == "end":
+            # Pop out of the latest scope
+            del scopes[0]
+
+        # If the current scope is falsy and not the only scope
+        elif not current_scope and len(scopes) != 1:
+            if tag in ["section", "inverted section"]:
+                # Set the most recent scope to a falsy value
+                scopes.insert(0, False)
+
+        # If we're a literal tag
+        elif tag == "literal":
+            # Add padding to the key and add it to the output
+            output += key.replace("\n", "\n" + padding)
+
+        # If we're a variable tag
+        elif tag == "variable":
+            # Add the html escaped key to the output
+            thing = _get_key(
+                key, scopes, warn=warn, keep=keep, def_ldel=def_ldel, def_rdel=def_rdel
+            )
+            if thing is True and key == ".":
+                # if we've coerced into a boolean by accident
+                # (inverted tags do this)
+                # then get the un-coerced object (next in the stack)
+                thing = scopes[1]
+            if not isinstance(thing, str):
+                thing = str(thing)
+            output += _html_escape(thing)
+
+        # If we're a no html escape tag
+        elif tag == "no escape":
+            # Just lookup the key and add it
+            thing = _get_key(
+                key, scopes, warn=warn, keep=keep, def_ldel=def_ldel, def_rdel=def_rdel
+            )
+            if not isinstance(thing, str):
+                thing = str(thing)
+            output += thing
+
+        # If we're a section tag
+        elif tag == "section":
+            # Get the sections scope
+            scope = _get_key(
+                key, scopes, warn=warn, keep=keep, def_ldel=def_ldel, def_rdel=def_rdel
+            )
+
+            # If the scope is a callable (as described in
+            # https://mustache.github.io/mustache.5.html)
+            if callable(scope):
+                # Generate template text from tags
+                text = ""
+                tags: List[Tuple[str, str]] = []
+                for token in tokens:
+                    if token == ("end", key):
+                        break
+
+                    tags.append(token)
+                    tag_type, tag_key = token
+                    if tag_type == "literal":
+                        text += tag_key
+                    elif tag_type == "no escape":
+                        text += "%s& %s %s" % (def_ldel, tag_key, def_rdel)
+                    else:
+                        text += "%s%s %s%s" % (
+                            def_ldel,
+                            {
+                                "comment": "!",
+                                "section": "#",
+                                "inverted section": "^",
+                                "end": "/",
+                                "partial": ">",
+                                "set delimiter": "=",
+                                "no escape": "&",
+                                "variable": "",
+                            }[tag_type],
+                            tag_key,
+                            def_rdel,
+                        )
+
+                g_token_cache[text] = tags
+
+                rend = scope(
+                    text,
+                    lambda template, data=None: render(
+                        template,
+                        data={},
+                        partials_dict=partials_dict,
+                        padding=padding,
+                        def_ldel=def_ldel,
+                        def_rdel=def_rdel,
+                        scopes=data and [data] + scopes or scopes,
+                        warn=warn,
+                        keep=keep,
+                    ),
+                )
+
+                output += rend
+
+            # If the scope is a sequence, an iterator or generator but not
+            # derived from a string
+            elif isinstance(scope, (Sequence, Iterator)) and not isinstance(scope, str):
+                # Then we need to do some looping
+
+                # Gather up all the tags inside the section
+                # (And don't be tricked by nested end tags with the same key)
+                # TODO: This feels like it still has edge cases, no?
+                tags = []
+                tags_with_same_key = 0
+                for token in tokens:
+                    if token == ("section", key):
+                        tags_with_same_key += 1
+                    if token == ("end", key):
+                        tags_with_same_key -= 1
+                        if tags_with_same_key < 0:
+                            break
+                    tags.append(token)
+
+                # For every item in the scope
+                for thing in scope:
+                    # Append it as the most recent scope and render
+                    new_scope = [thing] + scopes
+                    rend = render(
+                        template=tags,
+                        scopes=new_scope,
+                        padding=padding,
+                        partials_dict=partials_dict,
+                        def_ldel=def_ldel,
+                        def_rdel=def_rdel,
+                        warn=warn,
+                        keep=keep,
+                    )
+
+                    output += rend
+
+            else:
+                # Otherwise we're just a scope section
+                scopes.insert(0, scope)
+
+        # If we're an inverted section
+        elif tag == "inverted section":
+            # Add the flipped scope to the scopes
+            scope = _get_key(
+                key, scopes, warn=warn, keep=keep, def_ldel=def_ldel, def_rdel=def_rdel
+            )
+            scopes.insert(0, cast(Literal[False], not scope))
+
+        # If we're a partial
+        elif tag == "partial":
+            # Load the partial
+            partial = _get_partial(key, partials_dict)
+
+            # Find what to pad the partial with
+            left = output.rpartition("\n")[2]
+            part_padding = padding
+            if left.isspace():
+                part_padding += left
+
+            # Render the partial
+            part_out = render(
+                template=partial,
+                partials_dict=partials_dict,
+                def_ldel=def_ldel,
+                def_rdel=def_rdel,
+                padding=part_padding,
+                scopes=scopes,
+                warn=warn,
+                keep=keep,
+            )
+
+            # If the partial was indented
+            if left.isspace():
+                # then remove the spaces from the end
+                part_out = part_out.rstrip(" \t")
+
+            # Add the partials output to the output
+            output += part_out
+
+    return output
diff --git a/llm/Lib/site-packages/langchain_core/utils/pydantic.py b/llm/Lib/site-packages/langchain_core/utils/pydantic.py
new file mode 100644
index 0000000000000000000000000000000000000000..80ddb81fcb9955c58b6dcfd683ae8c88b7868292
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/pydantic.py
@@ -0,0 +1,14 @@
+"""Utilities for tests."""
+
+
+def get_pydantic_major_version() -> int:
+    """Get the major version of Pydantic."""
+    try:
+        import pydantic
+
+        return int(pydantic.__version__.split(".")[0])
+    except ImportError:
+        return 0
+
+
+PYDANTIC_MAJOR_VERSION = get_pydantic_major_version()
diff --git a/llm/Lib/site-packages/langchain_core/utils/strings.py b/llm/Lib/site-packages/langchain_core/utils/strings.py
new file mode 100644
index 0000000000000000000000000000000000000000..3e866f059ffe2964d8bb27eaea28786a7fcc9f84
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/strings.py
@@ -0,0 +1,40 @@
+from typing import Any, List
+
+
+def stringify_value(val: Any) -> str:
+    """Stringify a value.
+
+    Args:
+        val: The value to stringify.
+
+    Returns:
+        str: The stringified value.
+    """
+    if isinstance(val, str):
+        return val
+    elif isinstance(val, dict):
+        return "\n" + stringify_dict(val)
+    elif isinstance(val, list):
+        return "\n".join(stringify_value(v) for v in val)
+    else:
+        return str(val)
+
+
+def stringify_dict(data: dict) -> str:
+    """Stringify a dictionary.
+
+    Args:
+        data: The dictionary to stringify.
+
+    Returns:
+        str: The stringified dictionary.
+    """
+    text = ""
+    for key, value in data.items():
+        text += key + ": " + stringify_value(value) + "\n"
+    return text
+
+
+def comma_list(items: List[Any]) -> str:
+    """Convert a list to a comma-separated string."""
+    return ", ".join(str(item) for item in items)
diff --git a/llm/Lib/site-packages/langchain_core/utils/utils.py b/llm/Lib/site-packages/langchain_core/utils/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b63ddf3ea63fe9eccab236fcb0e02f94d7985c2
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/utils/utils.py
@@ -0,0 +1,180 @@
+"""Generic utility functions."""
+import contextlib
+import datetime
+import functools
+import importlib
+import warnings
+from importlib.metadata import version
+from typing import Any, Callable, Dict, Optional, Set, Tuple, Union
+
+from packaging.version import parse
+from requests import HTTPError, Response
+
+from langchain_core.pydantic_v1 import SecretStr
+
+
+def xor_args(*arg_groups: Tuple[str, ...]) -> Callable:
+    """Validate specified keyword args are mutually exclusive."""
+
+    def decorator(func: Callable) -> Callable:
+        @functools.wraps(func)
+        def wrapper(*args: Any, **kwargs: Any) -> Any:
+            """Validate exactly one arg in each group is not None."""
+            counts = [
+                sum(1 for arg in arg_group if kwargs.get(arg) is not None)
+                for arg_group in arg_groups
+            ]
+            invalid_groups = [i for i, count in enumerate(counts) if count != 1]
+            if invalid_groups:
+                invalid_group_names = [", ".join(arg_groups[i]) for i in invalid_groups]
+                raise ValueError(
+                    "Exactly one argument in each of the following"
+                    " groups must be defined:"
+                    f" {', '.join(invalid_group_names)}"
+                )
+            return func(*args, **kwargs)
+
+        return wrapper
+
+    return decorator
+
+
+def raise_for_status_with_text(response: Response) -> None:
+    """Raise an error with the response text."""
+    try:
+        response.raise_for_status()
+    except HTTPError as e:
+        raise ValueError(response.text) from e
+
+
+@contextlib.contextmanager
+def mock_now(dt_value):  # type: ignore
+    """Context manager for mocking out datetime.now() in unit tests.
+
+    Example:
+    with mock_now(datetime.datetime(2011, 2, 3, 10, 11)):
+        assert datetime.datetime.now() == datetime.datetime(2011, 2, 3, 10, 11)
+    """
+
+    class MockDateTime(datetime.datetime):
+        """Mock datetime.datetime.now() with a fixed datetime."""
+
+        @classmethod
+        def now(cls):  # type: ignore
+            # Create a copy of dt_value.
+            return datetime.datetime(
+                dt_value.year,
+                dt_value.month,
+                dt_value.day,
+                dt_value.hour,
+                dt_value.minute,
+                dt_value.second,
+                dt_value.microsecond,
+                dt_value.tzinfo,
+            )
+
+    real_datetime = datetime.datetime
+    datetime.datetime = MockDateTime
+    try:
+        yield datetime.datetime
+    finally:
+        datetime.datetime = real_datetime
+
+
+def guard_import(
+    module_name: str, *, pip_name: Optional[str] = None, package: Optional[str] = None
+) -> Any:
+    """Dynamically imports a module and raises a helpful exception if the module is not
+    installed."""
+    try:
+        module = importlib.import_module(module_name, package)
+    except ImportError:
+        raise ImportError(
+            f"Could not import {module_name} python package. "
+            f"Please install it with `pip install {pip_name or module_name}`."
+        )
+    return module
+
+
+def check_package_version(
+    package: str,
+    lt_version: Optional[str] = None,
+    lte_version: Optional[str] = None,
+    gt_version: Optional[str] = None,
+    gte_version: Optional[str] = None,
+) -> None:
+    """Check the version of a package."""
+    imported_version = parse(version(package))
+    if lt_version is not None and imported_version >= parse(lt_version):
+        raise ValueError(
+            f"Expected {package} version to be < {lt_version}. Received "
+            f"{imported_version}."
+        )
+    if lte_version is not None and imported_version > parse(lte_version):
+        raise ValueError(
+            f"Expected {package} version to be <= {lte_version}. Received "
+            f"{imported_version}."
+        )
+    if gt_version is not None and imported_version <= parse(gt_version):
+        raise ValueError(
+            f"Expected {package} version to be > {gt_version}. Received "
+            f"{imported_version}."
+        )
+    if gte_version is not None and imported_version < parse(gte_version):
+        raise ValueError(
+            f"Expected {package} version to be >= {gte_version}. Received "
+            f"{imported_version}."
+        )
+
+
+def get_pydantic_field_names(pydantic_cls: Any) -> Set[str]:
+    """Get field names, including aliases, for a pydantic class.
+
+    Args:
+        pydantic_cls: Pydantic class."""
+    all_required_field_names = set()
+    for field in pydantic_cls.__fields__.values():
+        all_required_field_names.add(field.name)
+        if field.has_alias:
+            all_required_field_names.add(field.alias)
+    return all_required_field_names
+
+
+def build_extra_kwargs(
+    extra_kwargs: Dict[str, Any],
+    values: Dict[str, Any],
+    all_required_field_names: Set[str],
+) -> Dict[str, Any]:
+    """Build extra kwargs from values and extra_kwargs.
+
+    Args:
+        extra_kwargs: Extra kwargs passed in by user.
+        values: Values passed in by user.
+        all_required_field_names: All required field names for the pydantic class.
+    """
+    for field_name in list(values):
+        if field_name in extra_kwargs:
+            raise ValueError(f"Found {field_name} supplied twice.")
+        if field_name not in all_required_field_names:
+            warnings.warn(
+                f"""WARNING! {field_name} is not default parameter.
+                {field_name} was transferred to model_kwargs.
+                Please confirm that {field_name} is what you intended."""
+            )
+            extra_kwargs[field_name] = values.pop(field_name)
+
+    invalid_model_kwargs = all_required_field_names.intersection(extra_kwargs.keys())
+    if invalid_model_kwargs:
+        raise ValueError(
+            f"Parameters {invalid_model_kwargs} should be specified explicitly. "
+            f"Instead they were passed in as part of `model_kwargs` parameter."
+        )
+
+    return extra_kwargs
+
+
+def convert_to_secret_str(value: Union[SecretStr, str]) -> SecretStr:
+    """Convert a string to a SecretStr if needed."""
+    if isinstance(value, SecretStr):
+        return value
+    return SecretStr(value)
diff --git a/llm/Lib/site-packages/langchain_core/vectorstores.py b/llm/Lib/site-packages/langchain_core/vectorstores.py
new file mode 100644
index 0000000000000000000000000000000000000000..d6299c61d77661d40e74b31accad032de7e34068
--- /dev/null
+++ b/llm/Lib/site-packages/langchain_core/vectorstores.py
@@ -0,0 +1,742 @@
+"""**Vector store** stores embedded data and performs vector search.
+
+One of the most common ways to store and search over unstructured data is to
+embed it and store the resulting embedding vectors, and then query the store
+and retrieve the data that are 'most similar' to the embedded query.
+
+**Class hierarchy:**
+
+.. code-block::
+
+    VectorStore --> <name>  # Examples: Annoy, FAISS, Milvus
+
+    BaseRetriever --> VectorStoreRetriever --> <name>Retriever  # Example: VespaRetriever
+
+**Main helpers:**
+
+.. code-block::
+
+    Embeddings, Document
+"""  # noqa: E501
+from __future__ import annotations
+
+import logging
+import math
+import warnings
+from abc import ABC, abstractmethod
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    ClassVar,
+    Collection,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+)
+
+from langchain_core.embeddings import Embeddings
+from langchain_core.pydantic_v1 import Field, root_validator
+from langchain_core.retrievers import BaseRetriever
+from langchain_core.runnables.config import run_in_executor
+
+if TYPE_CHECKING:
+    from langchain_core.callbacks.manager import (
+        AsyncCallbackManagerForRetrieverRun,
+        CallbackManagerForRetrieverRun,
+    )
+    from langchain_core.documents import Document
+
+logger = logging.getLogger(__name__)
+
+VST = TypeVar("VST", bound="VectorStore")
+
+
+class VectorStore(ABC):
+    """Interface for vector store."""
+
+    @abstractmethod
+    def add_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore.
+
+        Args:
+            texts: Iterable of strings to add to the vectorstore.
+            metadatas: Optional list of metadatas associated with the texts.
+            kwargs: vectorstore specific parameters
+
+        Returns:
+            List of ids from adding the texts into the vectorstore.
+        """
+
+    @property
+    def embeddings(self) -> Optional[Embeddings]:
+        """Access the query embedding object if available."""
+        logger.debug(
+            f"{Embeddings.__name__} is not implemented for {self.__class__.__name__}"
+        )
+        return None
+
+    def delete(self, ids: Optional[List[str]] = None, **kwargs: Any) -> Optional[bool]:
+        """Delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+
+        raise NotImplementedError("delete method must be implemented by subclass.")
+
+    async def adelete(
+        self, ids: Optional[List[str]] = None, **kwargs: Any
+    ) -> Optional[bool]:
+        """Delete by vector ID or other criteria.
+
+        Args:
+            ids: List of ids to delete.
+            **kwargs: Other keyword arguments that subclasses might use.
+
+        Returns:
+            Optional[bool]: True if deletion is successful,
+            False otherwise, None if not implemented.
+        """
+        return await run_in_executor(None, self.delete, ids, **kwargs)
+
+    async def aadd_texts(
+        self,
+        texts: Iterable[str],
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> List[str]:
+        """Run more texts through the embeddings and add to the vectorstore."""
+        return await run_in_executor(None, self.add_texts, texts, metadatas, **kwargs)
+
+    def add_documents(self, documents: List[Document], **kwargs: Any) -> List[str]:
+        """Run more documents through the embeddings and add to the vectorstore.
+
+        Args:
+            documents (List[Document]: Documents to add to the vectorstore.
+
+        Returns:
+            List[str]: List of IDs of the added texts.
+        """
+        # TODO: Handle the case where the user doesn't provide ids on the Collection
+        texts = [doc.page_content for doc in documents]
+        metadatas = [doc.metadata for doc in documents]
+        return self.add_texts(texts, metadatas, **kwargs)
+
+    async def aadd_documents(
+        self, documents: List[Document], **kwargs: Any
+    ) -> List[str]:
+        """Run more documents through the embeddings and add to the vectorstore.
+
+        Args:
+            documents (List[Document]: Documents to add to the vectorstore.
+
+        Returns:
+            List[str]: List of IDs of the added texts.
+        """
+        texts = [doc.page_content for doc in documents]
+        metadatas = [doc.metadata for doc in documents]
+        return await self.aadd_texts(texts, metadatas, **kwargs)
+
+    def search(self, query: str, search_type: str, **kwargs: Any) -> List[Document]:
+        """Return docs most similar to query using specified search type."""
+        if search_type == "similarity":
+            return self.similarity_search(query, **kwargs)
+        elif search_type == "mmr":
+            return self.max_marginal_relevance_search(query, **kwargs)
+        else:
+            raise ValueError(
+                f"search_type of {search_type} not allowed. Expected "
+                "search_type to be 'similarity' or 'mmr'."
+            )
+
+    async def asearch(
+        self, query: str, search_type: str, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query using specified search type."""
+        if search_type == "similarity":
+            return await self.asimilarity_search(query, **kwargs)
+        elif search_type == "mmr":
+            return await self.amax_marginal_relevance_search(query, **kwargs)
+        else:
+            raise ValueError(
+                f"search_type of {search_type} not allowed. Expected "
+                "search_type to be 'similarity' or 'mmr'."
+            )
+
+    @abstractmethod
+    def similarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query."""
+
+    @staticmethod
+    def _euclidean_relevance_score_fn(distance: float) -> float:
+        """Return a similarity score on a scale [0, 1]."""
+        # The 'correct' relevance function
+        # may differ depending on a few things, including:
+        # - the distance / similarity metric used by the VectorStore
+        # - the scale of your embeddings (OpenAI's are unit normed. Many
+        #  others are not!)
+        # - embedding dimensionality
+        # - etc.
+        # This function converts the euclidean norm of normalized embeddings
+        # (0 is most similar, sqrt(2) most dissimilar)
+        # to a similarity function (0 to 1)
+        return 1.0 - distance / math.sqrt(2)
+
+    @staticmethod
+    def _cosine_relevance_score_fn(distance: float) -> float:
+        """Normalize the distance to a score on a scale [0, 1]."""
+
+        return 1.0 - distance
+
+    @staticmethod
+    def _max_inner_product_relevance_score_fn(distance: float) -> float:
+        """Normalize the distance to a score on a scale [0, 1]."""
+        if distance > 0:
+            return 1.0 - distance
+
+        return -1.0 * distance
+
+    def _select_relevance_score_fn(self) -> Callable[[float], float]:
+        """
+        The 'correct' relevance function
+        may differ depending on a few things, including:
+        - the distance / similarity metric used by the VectorStore
+        - the scale of your embeddings (OpenAI's are unit normed. Many others are not!)
+        - embedding dimensionality
+        - etc.
+
+        Vectorstores should define their own selection based method of relevance.
+        """
+        raise NotImplementedError
+
+    def similarity_search_with_score(
+        self, *args: Any, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search with distance."""
+        raise NotImplementedError
+
+    async def asimilarity_search_with_score(
+        self, *args: Any, **kwargs: Any
+    ) -> List[Tuple[Document, float]]:
+        """Run similarity search with distance asynchronously."""
+
+        # This is a temporary workaround to make the similarity search
+        # asynchronous. The proper solution is to make the similarity search
+        # asynchronous in the vector store implementations.
+        return await run_in_executor(
+            None, self.similarity_search_with_score, *args, **kwargs
+        )
+
+    def _similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """
+        Default similarity search with relevance scores. Modify if necessary
+        in subclass.
+        Return docs and relevance scores in the range [0, 1].
+
+        0 is dissimilar, 1 is most similar.
+
+        Args:
+            query: input text
+            k: Number of Documents to return. Defaults to 4.
+            **kwargs: kwargs to be passed to similarity search. Should include:
+                score_threshold: Optional, a floating point value between 0 to 1 to
+                    filter the resulting set of retrieved docs
+
+        Returns:
+            List of Tuples of (doc, similarity_score)
+        """
+        relevance_score_fn = self._select_relevance_score_fn()
+        docs_and_scores = self.similarity_search_with_score(query, k, **kwargs)
+        return [(doc, relevance_score_fn(score)) for doc, score in docs_and_scores]
+
+    async def _asimilarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """
+        Default async similarity search with relevance scores. Modify if necessary
+        in subclass.
+        Return docs and relevance scores in the range [0, 1].
+
+        0 is dissimilar, 1 is most similar.
+
+        Args:
+            query: input text
+            k: Number of Documents to return. Defaults to 4.
+            **kwargs: kwargs to be passed to similarity search. Should include:
+                score_threshold: Optional, a floating point value between 0 to 1 to
+                    filter the resulting set of retrieved docs
+
+        Returns:
+            List of Tuples of (doc, similarity_score)
+        """
+        relevance_score_fn = self._select_relevance_score_fn()
+        docs_and_scores = await self.asimilarity_search_with_score(query, k, **kwargs)
+        return [(doc, relevance_score_fn(score)) for doc, score in docs_and_scores]
+
+    def similarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs and relevance scores in the range [0, 1].
+
+        0 is dissimilar, 1 is most similar.
+
+        Args:
+            query: input text
+            k: Number of Documents to return. Defaults to 4.
+            **kwargs: kwargs to be passed to similarity search. Should include:
+                score_threshold: Optional, a floating point value between 0 to 1 to
+                    filter the resulting set of retrieved docs
+
+        Returns:
+            List of Tuples of (doc, similarity_score)
+        """
+        score_threshold = kwargs.pop("score_threshold", None)
+
+        docs_and_similarities = self._similarity_search_with_relevance_scores(
+            query, k=k, **kwargs
+        )
+        if any(
+            similarity < 0.0 or similarity > 1.0
+            for _, similarity in docs_and_similarities
+        ):
+            warnings.warn(
+                "Relevance scores must be between"
+                f" 0 and 1, got {docs_and_similarities}"
+            )
+
+        if score_threshold is not None:
+            docs_and_similarities = [
+                (doc, similarity)
+                for doc, similarity in docs_and_similarities
+                if similarity >= score_threshold
+            ]
+            if len(docs_and_similarities) == 0:
+                warnings.warn(
+                    "No relevant docs were retrieved using the relevance score"
+                    f" threshold {score_threshold}"
+                )
+        return docs_and_similarities
+
+    async def asimilarity_search_with_relevance_scores(
+        self,
+        query: str,
+        k: int = 4,
+        **kwargs: Any,
+    ) -> List[Tuple[Document, float]]:
+        """Return docs and relevance scores in the range [0, 1], asynchronously.
+
+        0 is dissimilar, 1 is most similar.
+
+        Args:
+            query: input text
+            k: Number of Documents to return. Defaults to 4.
+            **kwargs: kwargs to be passed to similarity search. Should include:
+                score_threshold: Optional, a floating point value between 0 to 1 to
+                    filter the resulting set of retrieved docs
+
+        Returns:
+            List of Tuples of (doc, similarity_score)
+        """
+        score_threshold = kwargs.pop("score_threshold", None)
+
+        docs_and_similarities = await self._asimilarity_search_with_relevance_scores(
+            query, k=k, **kwargs
+        )
+        if any(
+            similarity < 0.0 or similarity > 1.0
+            for _, similarity in docs_and_similarities
+        ):
+            warnings.warn(
+                "Relevance scores must be between"
+                f" 0 and 1, got {docs_and_similarities}"
+            )
+
+        if score_threshold is not None:
+            docs_and_similarities = [
+                (doc, similarity)
+                for doc, similarity in docs_and_similarities
+                if similarity >= score_threshold
+            ]
+            if len(docs_and_similarities) == 0:
+                warnings.warn(
+                    "No relevant docs were retrieved using the relevance score"
+                    f" threshold {score_threshold}"
+                )
+        return docs_and_similarities
+
+    async def asimilarity_search(
+        self, query: str, k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to query."""
+
+        # This is a temporary workaround to make the similarity search
+        # asynchronous. The proper solution is to make the similarity search
+        # asynchronous in the vector store implementations.
+        return await run_in_executor(None, self.similarity_search, query, k=k, **kwargs)
+
+    def similarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+
+        Returns:
+            List of Documents most similar to the query vector.
+        """
+        raise NotImplementedError
+
+    async def asimilarity_search_by_vector(
+        self, embedding: List[float], k: int = 4, **kwargs: Any
+    ) -> List[Document]:
+        """Return docs most similar to embedding vector."""
+
+        # This is a temporary workaround to make the similarity search
+        # asynchronous. The proper solution is to make the similarity search
+        # asynchronous in the vector store implementations.
+        return await run_in_executor(
+            None, self.similarity_search_by_vector, embedding, k=k, **kwargs
+        )
+
+    def max_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        raise NotImplementedError
+
+    async def amax_marginal_relevance_search(
+        self,
+        query: str,
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            query: Text to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+
+        # This is a temporary workaround to make the similarity search
+        # asynchronous. The proper solution is to make the similarity search
+        # asynchronous in the vector store implementations.
+        return await run_in_executor(
+            None,
+            self.max_marginal_relevance_search,
+            query,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            **kwargs,
+        )
+
+    def max_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance.
+
+        Maximal marginal relevance optimizes for similarity to query AND diversity
+        among selected documents.
+
+        Args:
+            embedding: Embedding to look up documents similar to.
+            k: Number of Documents to return. Defaults to 4.
+            fetch_k: Number of Documents to fetch to pass to MMR algorithm.
+            lambda_mult: Number between 0 and 1 that determines the degree
+                        of diversity among the results with 0 corresponding
+                        to maximum diversity and 1 to minimum diversity.
+                        Defaults to 0.5.
+        Returns:
+            List of Documents selected by maximal marginal relevance.
+        """
+        raise NotImplementedError
+
+    async def amax_marginal_relevance_search_by_vector(
+        self,
+        embedding: List[float],
+        k: int = 4,
+        fetch_k: int = 20,
+        lambda_mult: float = 0.5,
+        **kwargs: Any,
+    ) -> List[Document]:
+        """Return docs selected using the maximal marginal relevance."""
+        return await run_in_executor(
+            None,
+            self.max_marginal_relevance_search_by_vector,
+            embedding,
+            k=k,
+            fetch_k=fetch_k,
+            lambda_mult=lambda_mult,
+            **kwargs,
+        )
+
+    @classmethod
+    def from_documents(
+        cls: Type[VST],
+        documents: List[Document],
+        embedding: Embeddings,
+        **kwargs: Any,
+    ) -> VST:
+        """Return VectorStore initialized from documents and embeddings."""
+        texts = [d.page_content for d in documents]
+        metadatas = [d.metadata for d in documents]
+        return cls.from_texts(texts, embedding, metadatas=metadatas, **kwargs)
+
+    @classmethod
+    async def afrom_documents(
+        cls: Type[VST],
+        documents: List[Document],
+        embedding: Embeddings,
+        **kwargs: Any,
+    ) -> VST:
+        """Return VectorStore initialized from documents and embeddings."""
+        texts = [d.page_content for d in documents]
+        metadatas = [d.metadata for d in documents]
+        return await cls.afrom_texts(texts, embedding, metadatas=metadatas, **kwargs)
+
+    @classmethod
+    @abstractmethod
+    def from_texts(
+        cls: Type[VST],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> VST:
+        """Return VectorStore initialized from texts and embeddings."""
+
+    @classmethod
+    async def afrom_texts(
+        cls: Type[VST],
+        texts: List[str],
+        embedding: Embeddings,
+        metadatas: Optional[List[dict]] = None,
+        **kwargs: Any,
+    ) -> VST:
+        """Return VectorStore initialized from texts and embeddings."""
+        return await run_in_executor(
+            None, cls.from_texts, texts, embedding, metadatas, **kwargs
+        )
+
+    def _get_retriever_tags(self) -> List[str]:
+        """Get tags for retriever."""
+        tags = [self.__class__.__name__]
+        if self.embeddings:
+            tags.append(self.embeddings.__class__.__name__)
+        return tags
+
+    def as_retriever(self, **kwargs: Any) -> VectorStoreRetriever:
+        """Return VectorStoreRetriever initialized from this VectorStore.
+
+        Args:
+            search_type (Optional[str]): Defines the type of search that
+                the Retriever should perform.
+                Can be "similarity" (default), "mmr", or
+                "similarity_score_threshold".
+            search_kwargs (Optional[Dict]): Keyword arguments to pass to the
+                search function. Can include things like:
+                    k: Amount of documents to return (Default: 4)
+                    score_threshold: Minimum relevance threshold
+                        for similarity_score_threshold
+                    fetch_k: Amount of documents to pass to MMR algorithm (Default: 20)
+                    lambda_mult: Diversity of results returned by MMR;
+                        1 for minimum diversity and 0 for maximum. (Default: 0.5)
+                    filter: Filter by document metadata
+
+        Returns:
+            VectorStoreRetriever: Retriever class for VectorStore.
+
+        Examples:
+
+        .. code-block:: python
+
+            # Retrieve more documents with higher diversity
+            # Useful if your dataset has many similar documents
+            docsearch.as_retriever(
+                search_type="mmr",
+                search_kwargs={'k': 6, 'lambda_mult': 0.25}
+            )
+
+            # Fetch more documents for the MMR algorithm to consider
+            # But only return the top 5
+            docsearch.as_retriever(
+                search_type="mmr",
+                search_kwargs={'k': 5, 'fetch_k': 50}
+            )
+
+            # Only retrieve documents that have a relevance score
+            # Above a certain threshold
+            docsearch.as_retriever(
+                search_type="similarity_score_threshold",
+                search_kwargs={'score_threshold': 0.8}
+            )
+
+            # Only get the single most similar document from the dataset
+            docsearch.as_retriever(search_kwargs={'k': 1})
+
+            # Use a filter to only retrieve documents from a specific paper
+            docsearch.as_retriever(
+                search_kwargs={'filter': {'paper_title':'GPT-4 Technical Report'}}
+            )
+        """
+        tags = kwargs.pop("tags", None) or []
+        tags.extend(self._get_retriever_tags())
+        return VectorStoreRetriever(vectorstore=self, **kwargs, tags=tags)
+
+
+class VectorStoreRetriever(BaseRetriever):
+    """Base Retriever class for VectorStore."""
+
+    vectorstore: VectorStore
+    """VectorStore to use for retrieval."""
+    search_type: str = "similarity"
+    """Type of search to perform. Defaults to "similarity"."""
+    search_kwargs: dict = Field(default_factory=dict)
+    """Keyword arguments to pass to the search function."""
+    allowed_search_types: ClassVar[Collection[str]] = (
+        "similarity",
+        "similarity_score_threshold",
+        "mmr",
+    )
+
+    class Config:
+        """Configuration for this pydantic object."""
+
+        arbitrary_types_allowed = True
+
+    @root_validator()
+    def validate_search_type(cls, values: Dict) -> Dict:
+        """Validate search type."""
+        search_type = values["search_type"]
+        if search_type not in cls.allowed_search_types:
+            raise ValueError(
+                f"search_type of {search_type} not allowed. Valid values are: "
+                f"{cls.allowed_search_types}"
+            )
+        if search_type == "similarity_score_threshold":
+            score_threshold = values["search_kwargs"].get("score_threshold")
+            if (score_threshold is None) or (not isinstance(score_threshold, float)):
+                raise ValueError(
+                    "`score_threshold` is not specified with a float value(0~1) "
+                    "in `search_kwargs`."
+                )
+        return values
+
+    def _get_relevant_documents(
+        self, query: str, *, run_manager: CallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        if self.search_type == "similarity":
+            docs = self.vectorstore.similarity_search(query, **self.search_kwargs)
+        elif self.search_type == "similarity_score_threshold":
+            docs_and_similarities = (
+                self.vectorstore.similarity_search_with_relevance_scores(
+                    query, **self.search_kwargs
+                )
+            )
+            docs = [doc for doc, _ in docs_and_similarities]
+        elif self.search_type == "mmr":
+            docs = self.vectorstore.max_marginal_relevance_search(
+                query, **self.search_kwargs
+            )
+        else:
+            raise ValueError(f"search_type of {self.search_type} not allowed.")
+        return docs
+
+    async def _aget_relevant_documents(
+        self, query: str, *, run_manager: AsyncCallbackManagerForRetrieverRun
+    ) -> List[Document]:
+        if self.search_type == "similarity":
+            docs = await self.vectorstore.asimilarity_search(
+                query, **self.search_kwargs
+            )
+        elif self.search_type == "similarity_score_threshold":
+            docs_and_similarities = (
+                await self.vectorstore.asimilarity_search_with_relevance_scores(
+                    query, **self.search_kwargs
+                )
+            )
+            docs = [doc for doc, _ in docs_and_similarities]
+        elif self.search_type == "mmr":
+            docs = await self.vectorstore.amax_marginal_relevance_search(
+                query, **self.search_kwargs
+            )
+        else:
+            raise ValueError(f"search_type of {self.search_type} not allowed.")
+        return docs
+
+    def add_documents(self, documents: List[Document], **kwargs: Any) -> List[str]:
+        """Add documents to vectorstore."""
+        return self.vectorstore.add_documents(documents, **kwargs)
+
+    async def aadd_documents(
+        self, documents: List[Document], **kwargs: Any
+    ) -> List[str]:
+        """Add documents to vectorstore."""
+        return await self.vectorstore.aadd_documents(documents, **kwargs)
diff --git a/llm/Scripts/Activate.ps1 b/llm/Scripts/Activate.ps1
new file mode 100644
index 0000000000000000000000000000000000000000..b49d77ba44b24fe6d69f6bbe75139b3b5dc23075
--- /dev/null
+++ b/llm/Scripts/Activate.ps1
@@ -0,0 +1,247 @@
+<#
+.Synopsis
+Activate a Python virtual environment for the current PowerShell session.
+
+.Description
+Pushes the python executable for a virtual environment to the front of the
+$Env:PATH environment variable and sets the prompt to signify that you are
+in a Python virtual environment. Makes use of the command line switches as
+well as the `pyvenv.cfg` file values present in the virtual environment.
+
+.Parameter VenvDir
+Path to the directory that contains the virtual environment to activate. The
+default value for this is the parent of the directory that the Activate.ps1
+script is located within.
+
+.Parameter Prompt
+The prompt prefix to display when this virtual environment is activated. By
+default, this prompt is the name of the virtual environment folder (VenvDir)
+surrounded by parentheses and followed by a single space (ie. '(.venv) ').
+
+.Example
+Activate.ps1
+Activates the Python virtual environment that contains the Activate.ps1 script.
+
+.Example
+Activate.ps1 -Verbose
+Activates the Python virtual environment that contains the Activate.ps1 script,
+and shows extra information about the activation as it executes.
+
+.Example
+Activate.ps1 -VenvDir C:\Users\MyUser\Common\.venv
+Activates the Python virtual environment located in the specified location.
+
+.Example
+Activate.ps1 -Prompt "MyPython"
+Activates the Python virtual environment that contains the Activate.ps1 script,
+and prefixes the current prompt with the specified string (surrounded in
+parentheses) while the virtual environment is active.
+
+.Notes
+On Windows, it may be required to enable this Activate.ps1 script by setting the
+execution policy for the user. You can do this by issuing the following PowerShell
+command:
+
+PS C:\> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+
+For more information on Execution Policies: 
+https://go.microsoft.com/fwlink/?LinkID=135170
+
+#>
+Param(
+    [Parameter(Mandatory = $false)]
+    [String]
+    $VenvDir,
+    [Parameter(Mandatory = $false)]
+    [String]
+    $Prompt
+)
+
+<# Function declarations --------------------------------------------------- #>
+
+<#
+.Synopsis
+Remove all shell session elements added by the Activate script, including the
+addition of the virtual environment's Python executable from the beginning of
+the PATH variable.
+
+.Parameter NonDestructive
+If present, do not remove this function from the global namespace for the
+session.
+
+#>
+function global:deactivate ([switch]$NonDestructive) {
+    # Revert to original values
+
+    # The prior prompt:
+    if (Test-Path -Path Function:_OLD_VIRTUAL_PROMPT) {
+        Copy-Item -Path Function:_OLD_VIRTUAL_PROMPT -Destination Function:prompt
+        Remove-Item -Path Function:_OLD_VIRTUAL_PROMPT
+    }
+
+    # The prior PYTHONHOME:
+    if (Test-Path -Path Env:_OLD_VIRTUAL_PYTHONHOME) {
+        Copy-Item -Path Env:_OLD_VIRTUAL_PYTHONHOME -Destination Env:PYTHONHOME
+        Remove-Item -Path Env:_OLD_VIRTUAL_PYTHONHOME
+    }
+
+    # The prior PATH:
+    if (Test-Path -Path Env:_OLD_VIRTUAL_PATH) {
+        Copy-Item -Path Env:_OLD_VIRTUAL_PATH -Destination Env:PATH
+        Remove-Item -Path Env:_OLD_VIRTUAL_PATH
+    }
+
+    # Just remove the VIRTUAL_ENV altogether:
+    if (Test-Path -Path Env:VIRTUAL_ENV) {
+        Remove-Item -Path env:VIRTUAL_ENV
+    }
+
+    # Just remove VIRTUAL_ENV_PROMPT altogether.
+    if (Test-Path -Path Env:VIRTUAL_ENV_PROMPT) {
+        Remove-Item -Path env:VIRTUAL_ENV_PROMPT
+    }
+
+    # Just remove the _PYTHON_VENV_PROMPT_PREFIX altogether:
+    if (Get-Variable -Name "_PYTHON_VENV_PROMPT_PREFIX" -ErrorAction SilentlyContinue) {
+        Remove-Variable -Name _PYTHON_VENV_PROMPT_PREFIX -Scope Global -Force
+    }
+
+    # Leave deactivate function in the global namespace if requested:
+    if (-not $NonDestructive) {
+        Remove-Item -Path function:deactivate
+    }
+}
+
+<#
+.Description
+Get-PyVenvConfig parses the values from the pyvenv.cfg file located in the
+given folder, and returns them in a map.
+
+For each line in the pyvenv.cfg file, if that line can be parsed into exactly
+two strings separated by `=` (with any amount of whitespace surrounding the =)
+then it is considered a `key = value` line. The left hand string is the key,
+the right hand is the value.
+
+If the value starts with a `'` or a `"` then the first and last character is
+stripped from the value before being captured.
+
+.Parameter ConfigDir
+Path to the directory that contains the `pyvenv.cfg` file.
+#>
+function Get-PyVenvConfig(
+    [String]
+    $ConfigDir
+) {
+    Write-Verbose "Given ConfigDir=$ConfigDir, obtain values in pyvenv.cfg"
+
+    # Ensure the file exists, and issue a warning if it doesn't (but still allow the function to continue).
+    $pyvenvConfigPath = Join-Path -Resolve -Path $ConfigDir -ChildPath 'pyvenv.cfg' -ErrorAction Continue
+
+    # An empty map will be returned if no config file is found.
+    $pyvenvConfig = @{ }
+
+    if ($pyvenvConfigPath) {
+
+        Write-Verbose "File exists, parse `key = value` lines"
+        $pyvenvConfigContent = Get-Content -Path $pyvenvConfigPath
+
+        $pyvenvConfigContent | ForEach-Object {
+            $keyval = $PSItem -split "\s*=\s*", 2
+            if ($keyval[0] -and $keyval[1]) {
+                $val = $keyval[1]
+
+                # Remove extraneous quotations around a string value.
+                if ("'""".Contains($val.Substring(0, 1))) {
+                    $val = $val.Substring(1, $val.Length - 2)
+                }
+
+                $pyvenvConfig[$keyval[0]] = $val
+                Write-Verbose "Adding Key: '$($keyval[0])'='$val'"
+            }
+        }
+    }
+    return $pyvenvConfig
+}
+
+
+<# Begin Activate script --------------------------------------------------- #>
+
+# Determine the containing directory of this script
+$VenvExecPath = Split-Path -Parent $MyInvocation.MyCommand.Definition
+$VenvExecDir = Get-Item -Path $VenvExecPath
+
+Write-Verbose "Activation script is located in path: '$VenvExecPath'"
+Write-Verbose "VenvExecDir Fullname: '$($VenvExecDir.FullName)"
+Write-Verbose "VenvExecDir Name: '$($VenvExecDir.Name)"
+
+# Set values required in priority: CmdLine, ConfigFile, Default
+# First, get the location of the virtual environment, it might not be
+# VenvExecDir if specified on the command line.
+if ($VenvDir) {
+    Write-Verbose "VenvDir given as parameter, using '$VenvDir' to determine values"
+}
+else {
+    Write-Verbose "VenvDir not given as a parameter, using parent directory name as VenvDir."
+    $VenvDir = $VenvExecDir.Parent.FullName.TrimEnd("\\/")
+    Write-Verbose "VenvDir=$VenvDir"
+}
+
+# Next, read the `pyvenv.cfg` file to determine any required value such
+# as `prompt`.
+$pyvenvCfg = Get-PyVenvConfig -ConfigDir $VenvDir
+
+# Next, set the prompt from the command line, or the config file, or
+# just use the name of the virtual environment folder.
+if ($Prompt) {
+    Write-Verbose "Prompt specified as argument, using '$Prompt'"
+}
+else {
+    Write-Verbose "Prompt not specified as argument to script, checking pyvenv.cfg value"
+    if ($pyvenvCfg -and $pyvenvCfg['prompt']) {
+        Write-Verbose "  Setting based on value in pyvenv.cfg='$($pyvenvCfg['prompt'])'"
+        $Prompt = $pyvenvCfg['prompt'];
+    }
+    else {
+        Write-Verbose "  Setting prompt based on parent's directory's name. (Is the directory name passed to venv module when creating the virtual environment)"
+        Write-Verbose "  Got leaf-name of $VenvDir='$(Split-Path -Path $venvDir -Leaf)'"
+        $Prompt = Split-Path -Path $venvDir -Leaf
+    }
+}
+
+Write-Verbose "Prompt = '$Prompt'"
+Write-Verbose "VenvDir='$VenvDir'"
+
+# Deactivate any currently active virtual environment, but leave the
+# deactivate function in place.
+deactivate -nondestructive
+
+# Now set the environment variable VIRTUAL_ENV, used by many tools to determine
+# that there is an activated venv.
+$env:VIRTUAL_ENV = $VenvDir
+
+if (-not $Env:VIRTUAL_ENV_DISABLE_PROMPT) {
+
+    Write-Verbose "Setting prompt to '$Prompt'"
+
+    # Set the prompt to include the env name
+    # Make sure _OLD_VIRTUAL_PROMPT is global
+    function global:_OLD_VIRTUAL_PROMPT { "" }
+    Copy-Item -Path function:prompt -Destination function:_OLD_VIRTUAL_PROMPT
+    New-Variable -Name _PYTHON_VENV_PROMPT_PREFIX -Description "Python virtual environment prompt prefix" -Scope Global -Option ReadOnly -Visibility Public -Value $Prompt
+
+    function global:prompt {
+        Write-Host -NoNewline -ForegroundColor Green "($_PYTHON_VENV_PROMPT_PREFIX) "
+        _OLD_VIRTUAL_PROMPT
+    }
+    $env:VIRTUAL_ENV_PROMPT = $Prompt
+}
+
+# Clear PYTHONHOME
+if (Test-Path -Path Env:PYTHONHOME) {
+    Copy-Item -Path Env:PYTHONHOME -Destination Env:_OLD_VIRTUAL_PYTHONHOME
+    Remove-Item -Path Env:PYTHONHOME
+}
+
+# Add the venv to the PATH
+Copy-Item -Path Env:PATH -Destination Env:_OLD_VIRTUAL_PATH
+$Env:PATH = "$VenvExecDir$([System.IO.Path]::PathSeparator)$Env:PATH"
diff --git a/llm/Scripts/accelerate-config.exe b/llm/Scripts/accelerate-config.exe
new file mode 100644
index 0000000000000000000000000000000000000000..8fa718cc56a236d250f7ae640ac2875a6106e8d8
Binary files /dev/null and b/llm/Scripts/accelerate-config.exe differ
diff --git a/llm/Scripts/accelerate-estimate-memory.exe b/llm/Scripts/accelerate-estimate-memory.exe
new file mode 100644
index 0000000000000000000000000000000000000000..b70e91e8c7b1363fb4455ebd7459d05524e1604c
Binary files /dev/null and b/llm/Scripts/accelerate-estimate-memory.exe differ
diff --git a/llm/Scripts/accelerate-launch.exe b/llm/Scripts/accelerate-launch.exe
new file mode 100644
index 0000000000000000000000000000000000000000..a3b4b0c122aa9debb8792560d67b4b3a4633a194
Binary files /dev/null and b/llm/Scripts/accelerate-launch.exe differ
diff --git a/llm/Scripts/accelerate.exe b/llm/Scripts/accelerate.exe
new file mode 100644
index 0000000000000000000000000000000000000000..6bae1d5c6c4d7d43499203a0e73d4001d42b7502
Binary files /dev/null and b/llm/Scripts/accelerate.exe differ
diff --git a/llm/Scripts/activate b/llm/Scripts/activate
new file mode 100644
index 0000000000000000000000000000000000000000..a716caa23c996726325bc6be085072612d708905
--- /dev/null
+++ b/llm/Scripts/activate
@@ -0,0 +1,63 @@
+# This file must be used with "source bin/activate" *from bash*
+# you cannot run it directly
+
+deactivate () {
+    # reset old environment variables
+    if [ -n "${_OLD_VIRTUAL_PATH:-}" ] ; then
+        PATH="${_OLD_VIRTUAL_PATH:-}"
+        export PATH
+        unset _OLD_VIRTUAL_PATH
+    fi
+    if [ -n "${_OLD_VIRTUAL_PYTHONHOME:-}" ] ; then
+        PYTHONHOME="${_OLD_VIRTUAL_PYTHONHOME:-}"
+        export PYTHONHOME
+        unset _OLD_VIRTUAL_PYTHONHOME
+    fi
+
+    # Call hash to forget past commands. Without forgetting
+    # past commands the $PATH changes we made may not be respected
+    hash -r 2> /dev/null
+
+    if [ -n "${_OLD_VIRTUAL_PS1:-}" ] ; then
+        PS1="${_OLD_VIRTUAL_PS1:-}"
+        export PS1
+        unset _OLD_VIRTUAL_PS1
+    fi
+
+    unset VIRTUAL_ENV
+    unset VIRTUAL_ENV_PROMPT
+    if [ ! "${1:-}" = "nondestructive" ] ; then
+    # Self destruct!
+        unset -f deactivate
+    fi
+}
+
+# unset irrelevant variables
+deactivate nondestructive
+
+VIRTUAL_ENV="D:\MECL\llm"
+export VIRTUAL_ENV
+
+_OLD_VIRTUAL_PATH="$PATH"
+PATH="$VIRTUAL_ENV/Scripts:$PATH"
+export PATH
+
+# unset PYTHONHOME if set
+# this will fail if PYTHONHOME is set to the empty string (which is bad anyway)
+# could use `if (set -u; : $PYTHONHOME) ;` in bash
+if [ -n "${PYTHONHOME:-}" ] ; then
+    _OLD_VIRTUAL_PYTHONHOME="${PYTHONHOME:-}"
+    unset PYTHONHOME
+fi
+
+if [ -z "${VIRTUAL_ENV_DISABLE_PROMPT:-}" ] ; then
+    _OLD_VIRTUAL_PS1="${PS1:-}"
+    PS1="(llm) ${PS1:-}"
+    export PS1
+    VIRTUAL_ENV_PROMPT="(llm) "
+    export VIRTUAL_ENV_PROMPT
+fi
+
+# Call hash to forget past commands. Without forgetting
+# past commands the $PATH changes we made may not be respected
+hash -r 2> /dev/null
diff --git a/llm/Scripts/activate.bat b/llm/Scripts/activate.bat
new file mode 100644
index 0000000000000000000000000000000000000000..83d5241fcd9d77697e88c45b422ee9353e54b36c
--- /dev/null
+++ b/llm/Scripts/activate.bat
@@ -0,0 +1,34 @@
+@echo off
+
+rem This file is UTF-8 encoded, so we need to update the current code page while executing it
+for /f "tokens=2 delims=:." %%a in ('"%SystemRoot%\System32\chcp.com"') do (
+    set _OLD_CODEPAGE=%%a
+)
+if defined _OLD_CODEPAGE (
+    "%SystemRoot%\System32\chcp.com" 65001 > nul
+)
+
+set VIRTUAL_ENV=D:\MECL\llm
+
+if not defined PROMPT set PROMPT=$P$G
+
+if defined _OLD_VIRTUAL_PROMPT set PROMPT=%_OLD_VIRTUAL_PROMPT%
+if defined _OLD_VIRTUAL_PYTHONHOME set PYTHONHOME=%_OLD_VIRTUAL_PYTHONHOME%
+
+set _OLD_VIRTUAL_PROMPT=%PROMPT%
+set PROMPT=(llm) %PROMPT%
+
+if defined PYTHONHOME set _OLD_VIRTUAL_PYTHONHOME=%PYTHONHOME%
+set PYTHONHOME=
+
+if defined _OLD_VIRTUAL_PATH set PATH=%_OLD_VIRTUAL_PATH%
+if not defined _OLD_VIRTUAL_PATH set _OLD_VIRTUAL_PATH=%PATH%
+
+set PATH=%VIRTUAL_ENV%\Scripts;%PATH%
+set VIRTUAL_ENV_PROMPT=(llm) 
+
+:END
+if defined _OLD_CODEPAGE (
+    "%SystemRoot%\System32\chcp.com" %_OLD_CODEPAGE% > nul
+    set _OLD_CODEPAGE=
+)
diff --git a/llm/Scripts/cassio-create-init-string.exe b/llm/Scripts/cassio-create-init-string.exe
new file mode 100644
index 0000000000000000000000000000000000000000..adeca759e60ed137e65c3f0363897fd2551b2181
Binary files /dev/null and b/llm/Scripts/cassio-create-init-string.exe differ
diff --git a/llm/Scripts/convert-caffe2-to-onnx.exe b/llm/Scripts/convert-caffe2-to-onnx.exe
new file mode 100644
index 0000000000000000000000000000000000000000..d7853304b81571b775a412d9bcbc78724d80779a
Binary files /dev/null and b/llm/Scripts/convert-caffe2-to-onnx.exe differ
diff --git a/llm/Scripts/convert-onnx-to-caffe2.exe b/llm/Scripts/convert-onnx-to-caffe2.exe
new file mode 100644
index 0000000000000000000000000000000000000000..646525a8bc644857f2df799a9f03c96c98b29953
Binary files /dev/null and b/llm/Scripts/convert-onnx-to-caffe2.exe differ
diff --git a/llm/Scripts/cpuinfo.exe b/llm/Scripts/cpuinfo.exe
new file mode 100644
index 0000000000000000000000000000000000000000..f16066a822a761e077d0c8fca9c12cedfec0cc0d
Binary files /dev/null and b/llm/Scripts/cpuinfo.exe differ
diff --git a/llm/Scripts/deactivate.bat b/llm/Scripts/deactivate.bat
new file mode 100644
index 0000000000000000000000000000000000000000..44dae49537073789b536689bb940456e65929b99
--- /dev/null
+++ b/llm/Scripts/deactivate.bat
@@ -0,0 +1,22 @@
+@echo off
+
+if defined _OLD_VIRTUAL_PROMPT (
+    set "PROMPT=%_OLD_VIRTUAL_PROMPT%"
+)
+set _OLD_VIRTUAL_PROMPT=
+
+if defined _OLD_VIRTUAL_PYTHONHOME (
+    set "PYTHONHOME=%_OLD_VIRTUAL_PYTHONHOME%"
+    set _OLD_VIRTUAL_PYTHONHOME=
+)
+
+if defined _OLD_VIRTUAL_PATH (
+    set "PATH=%_OLD_VIRTUAL_PATH%"
+)
+
+set _OLD_VIRTUAL_PATH=
+
+set VIRTUAL_ENV=
+set VIRTUAL_ENV_PROMPT=
+
+:END
diff --git a/llm/Scripts/distro.exe b/llm/Scripts/distro.exe
new file mode 100644
index 0000000000000000000000000000000000000000..1f048fecb70f3ed15cb993681de056e1de384303
Binary files /dev/null and b/llm/Scripts/distro.exe differ
diff --git a/llm/Scripts/f2py.exe b/llm/Scripts/f2py.exe
new file mode 100644
index 0000000000000000000000000000000000000000..94e866a45c362e46f30fdc90679aab705708e6b6
Binary files /dev/null and b/llm/Scripts/f2py.exe differ
diff --git a/llm/Scripts/geomet.exe b/llm/Scripts/geomet.exe
new file mode 100644
index 0000000000000000000000000000000000000000..415f0f3c7a42f4029a06fe8bb34eced39acafa08
Binary files /dev/null and b/llm/Scripts/geomet.exe differ
diff --git a/llm/Scripts/httpx.exe b/llm/Scripts/httpx.exe
new file mode 100644
index 0000000000000000000000000000000000000000..f1732ed838de5f13619e80cc8b133fb70da6cb54
Binary files /dev/null and b/llm/Scripts/httpx.exe differ
diff --git a/llm/Scripts/huggingface-cli.exe b/llm/Scripts/huggingface-cli.exe
new file mode 100644
index 0000000000000000000000000000000000000000..ab8770ecf90ba5a059907b88eb737bc0ca27b38b
Binary files /dev/null and b/llm/Scripts/huggingface-cli.exe differ
diff --git a/llm/Scripts/isympy.exe b/llm/Scripts/isympy.exe
new file mode 100644
index 0000000000000000000000000000000000000000..b7d5b3eb326c996a00a7ea5f09c5de9f04aa91dc
Binary files /dev/null and b/llm/Scripts/isympy.exe differ
diff --git a/llm/Scripts/jsondiff b/llm/Scripts/jsondiff
new file mode 100644
index 0000000000000000000000000000000000000000..868854705bd99a016b03e986d54b117ee002026d
--- /dev/null
+++ b/llm/Scripts/jsondiff
@@ -0,0 +1,41 @@
+#!D:\MECL\llm\Scripts\python.exe
+# -*- coding: utf-8 -*-
+
+from __future__ import print_function
+
+import sys
+import json
+import jsonpatch
+import argparse
+
+
+parser = argparse.ArgumentParser(description='Diff two JSON files')
+parser.add_argument('FILE1', type=argparse.FileType('r'))
+parser.add_argument('FILE2', type=argparse.FileType('r'))
+parser.add_argument('--indent', type=int, default=None,
+                    help='Indent output by n spaces')
+parser.add_argument('-u', '--preserve-unicode', action='store_true',
+                    help='Output Unicode character as-is without using Code Point')
+parser.add_argument('-v', '--version', action='version',
+                    version='%(prog)s ' + jsonpatch.__version__)
+
+
+def main():
+    try:
+        diff_files()
+    except KeyboardInterrupt:
+        sys.exit(1)
+
+
+def diff_files():
+    """ Diffs two JSON files and prints a patch """
+    args = parser.parse_args()
+    doc1 = json.load(args.FILE1)
+    doc2 = json.load(args.FILE2)
+    patch = jsonpatch.make_patch(doc1, doc2)
+    if patch.patch:
+        print(json.dumps(patch.patch, indent=args.indent, ensure_ascii=not(args.preserve_unicode)))
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Scripts/jsonpatch b/llm/Scripts/jsonpatch
new file mode 100644
index 0000000000000000000000000000000000000000..ca5b972aa0d4dd2ba6291ea538212acb7f5c7b2c
--- /dev/null
+++ b/llm/Scripts/jsonpatch
@@ -0,0 +1,107 @@
+#!D:\MECL\llm\Scripts\python.exe
+# -*- coding: utf-8 -*-
+
+import sys
+import os.path
+import json
+import jsonpatch
+import tempfile
+import argparse
+
+
+parser = argparse.ArgumentParser(
+    description='Apply a JSON patch on a JSON file')
+parser.add_argument('ORIGINAL', type=argparse.FileType('r'),
+                    help='Original file')
+parser.add_argument('PATCH', type=argparse.FileType('r'),
+                    nargs='?', default=sys.stdin,
+                    help='Patch file (read from stdin if omitted)')
+parser.add_argument('--indent', type=int, default=None,
+                    help='Indent output by n spaces')
+parser.add_argument('-b', '--backup', action='store_true',
+                    help='Back up ORIGINAL if modifying in-place')
+parser.add_argument('-i', '--in-place', action='store_true',
+                    help='Modify ORIGINAL in-place instead of to stdout')
+parser.add_argument('-v', '--version', action='version',
+                    version='%(prog)s ' + jsonpatch.__version__)
+parser.add_argument('-u', '--preserve-unicode', action='store_true',
+                    help='Output Unicode character as-is without using Code Point')
+
+def main():
+    try:
+        patch_files()
+    except KeyboardInterrupt:
+        sys.exit(1)
+
+
+def patch_files():
+    """ Diffs two JSON files and prints a patch """
+    args = parser.parse_args()
+    doc = json.load(args.ORIGINAL)
+    patch = json.load(args.PATCH)
+    result = jsonpatch.apply_patch(doc, patch)
+
+    if args.in_place:
+        dirname = os.path.abspath(os.path.dirname(args.ORIGINAL.name))
+
+        try:
+            # Attempt to replace the file atomically.  We do this by
+            # creating a temporary file in the same directory as the
+            # original file so we can atomically move the new file over
+            # the original later.  (This is done in the same directory
+	    # because atomic renames do not work across mount points.)
+
+            fd, pathname = tempfile.mkstemp(dir=dirname)
+            fp = os.fdopen(fd, 'w')
+            atomic = True
+
+        except OSError:
+            # We failed to create the temporary file for an atomic
+            # replace, so fall back to non-atomic mode by backing up
+            # the original (if desired) and writing a new file.
+
+            if args.backup:
+                os.rename(args.ORIGINAL.name, args.ORIGINAL.name + '.orig')
+            fp = open(args.ORIGINAL.name, 'w')
+            atomic = False
+
+    else:
+        # Since we're not replacing the original file in-place, write
+        # the modified JSON to stdout instead.
+
+        fp = sys.stdout
+
+    # By this point we have some sort of file object we can write the 
+    # modified JSON to.
+    
+    json.dump(result, fp, indent=args.indent, ensure_ascii=not(args.preserve_unicode))
+    fp.write('\n')
+
+    if args.in_place:
+        # Close the new file.  If we aren't replacing atomically, this
+        # is our last step, since everything else is already in place.
+
+        fp.close()
+
+        if atomic:
+            try:
+                # Complete the atomic replace by linking the original
+                # to a backup (if desired), fixing up the permissions
+                # on the temporary file, and moving it into place.
+
+                if args.backup:
+                    os.link(args.ORIGINAL.name, args.ORIGINAL.name + '.orig')
+                os.chmod(pathname, os.stat(args.ORIGINAL.name).st_mode)
+                os.rename(pathname, args.ORIGINAL.name)
+
+            except OSError:
+                # In the event we could not actually do the atomic
+                # replace, unlink the original to move it out of the
+                # way and finally move the temporary file into place.
+                
+                os.unlink(args.ORIGINAL.name)
+                os.rename(pathname, args.ORIGINAL.name)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Scripts/jsonpointer b/llm/Scripts/jsonpointer
new file mode 100644
index 0000000000000000000000000000000000000000..248fa28aae1744c34aff9872fe4ef4c579d10224
--- /dev/null
+++ b/llm/Scripts/jsonpointer
@@ -0,0 +1,69 @@
+#!D:\MECL\llm\Scripts\python.exe
+# -*- coding: utf-8 -*-
+
+from __future__ import print_function
+
+import sys
+import os.path
+import json
+import jsonpointer
+import argparse
+
+
+parser = argparse.ArgumentParser(
+    description='Resolve a JSON pointer on JSON files')
+
+# Accept pointer as argument or as file
+ptr_group = parser.add_mutually_exclusive_group(required=True)
+
+ptr_group.add_argument('-f', '--pointer-file', type=argparse.FileType('r'),
+                       nargs='?',
+                       help='File containing a JSON pointer expression')
+
+ptr_group.add_argument('POINTER',  type=str, nargs='?',
+                       help='A JSON pointer expression')
+
+parser.add_argument('FILE', type=argparse.FileType('r'), nargs='+',
+                    help='Files for which the pointer should be resolved')
+parser.add_argument('--indent', type=int, default=None,
+                    help='Indent output by n spaces')
+parser.add_argument('-v', '--version', action='version',
+                    version='%(prog)s ' + jsonpointer.__version__)
+
+
+def main():
+    try:
+        resolve_files()
+    except KeyboardInterrupt:
+        sys.exit(1)
+
+
+def parse_pointer(args):
+    if args.POINTER:
+        ptr = args.POINTER
+    elif args.pointer_file:
+        ptr = args.pointer_file.read().strip()
+    else:
+        parser.print_usage()
+        sys.exit(1)
+
+    return ptr
+
+
+def resolve_files():
+    """ Resolve a JSON pointer on JSON files """
+    args = parser.parse_args()
+
+    ptr = parse_pointer(args)
+
+    for f in args.FILE:
+        doc = json.load(f)
+        try:
+            result = jsonpointer.resolve_pointer(doc, ptr)
+            print(json.dumps(result, indent=args.indent))
+        except jsonpointer.JsonPointerException as e:
+            print('Could not resolve pointer: %s' % str(e), file=sys.stderr)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/llm/Scripts/jsonschema.exe b/llm/Scripts/jsonschema.exe
new file mode 100644
index 0000000000000000000000000000000000000000..207eb7b8084a5fdf4f72b4809cc8d40ab65314a5
Binary files /dev/null and b/llm/Scripts/jsonschema.exe differ
diff --git a/llm/Scripts/langchain-server.exe b/llm/Scripts/langchain-server.exe
new file mode 100644
index 0000000000000000000000000000000000000000..6cabe7c188672a44cdcdb362c5636e0830c9b432
Binary files /dev/null and b/llm/Scripts/langchain-server.exe differ
diff --git a/llm/Scripts/langsmith.exe b/llm/Scripts/langsmith.exe
new file mode 100644
index 0000000000000000000000000000000000000000..a67b66dbbe372dd476fa1d6dbbf45ba05b9a01cd
Binary files /dev/null and b/llm/Scripts/langsmith.exe differ
diff --git a/llm/Scripts/markdown-it.exe b/llm/Scripts/markdown-it.exe
new file mode 100644
index 0000000000000000000000000000000000000000..e5d8219d7ac3f6a22b0e632432f3bc6b866821fd
Binary files /dev/null and b/llm/Scripts/markdown-it.exe differ
diff --git a/llm/Scripts/normalizer.exe b/llm/Scripts/normalizer.exe
new file mode 100644
index 0000000000000000000000000000000000000000..8a1b97a8c0a3fe2f230279853650655503e793d8
Binary files /dev/null and b/llm/Scripts/normalizer.exe differ
diff --git a/llm/Scripts/openai.exe b/llm/Scripts/openai.exe
new file mode 100644
index 0000000000000000000000000000000000000000..ed695c6e6fa97cf025aa3dc9dd0a2b25c32544d5
Binary files /dev/null and b/llm/Scripts/openai.exe differ
diff --git a/llm/Scripts/pip.exe b/llm/Scripts/pip.exe
new file mode 100644
index 0000000000000000000000000000000000000000..1cd6004bd984949176273f145adf373c0e9a8bf4
Binary files /dev/null and b/llm/Scripts/pip.exe differ
diff --git a/llm/Scripts/pip3.11.exe b/llm/Scripts/pip3.11.exe
new file mode 100644
index 0000000000000000000000000000000000000000..1cd6004bd984949176273f145adf373c0e9a8bf4
Binary files /dev/null and b/llm/Scripts/pip3.11.exe differ
diff --git a/llm/Scripts/pip3.exe b/llm/Scripts/pip3.exe
new file mode 100644
index 0000000000000000000000000000000000000000..1cd6004bd984949176273f145adf373c0e9a8bf4
Binary files /dev/null and b/llm/Scripts/pip3.exe differ
diff --git a/llm/Scripts/pygmentize.exe b/llm/Scripts/pygmentize.exe
new file mode 100644
index 0000000000000000000000000000000000000000..aa51aacbfdb043f0143feec09fa667652d49e382
Binary files /dev/null and b/llm/Scripts/pygmentize.exe differ
diff --git a/llm/Scripts/python.exe b/llm/Scripts/python.exe
new file mode 100644
index 0000000000000000000000000000000000000000..45af0feebbc73cd6c0cc715e869736154263b1b1
Binary files /dev/null and b/llm/Scripts/python.exe differ
diff --git a/llm/Scripts/pythonw.exe b/llm/Scripts/pythonw.exe
new file mode 100644
index 0000000000000000000000000000000000000000..a2d4dd8bded8d8f156a1f40c11611a6f193e82b4
Binary files /dev/null and b/llm/Scripts/pythonw.exe differ
diff --git a/llm/Scripts/streamlit.cmd b/llm/Scripts/streamlit.cmd
new file mode 100644
index 0000000000000000000000000000000000000000..cdcbbada905fd696cd0154e361945de88061381e
--- /dev/null
+++ b/llm/Scripts/streamlit.cmd
@@ -0,0 +1,16 @@
+rem Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2024)
+rem
+rem Licensed under the Apache License, Version 2.0 (the "License");
+rem you may not use this file except in compliance with the License.
+rem You may obtain a copy of the License at
+rem
+rem     http://www.apache.org/licenses/LICENSE-2.0
+rem
+rem Unless required by applicable law or agreed to in writing, software
+rem distributed under the License is distributed on an "AS IS" BASIS,
+rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+rem See the License for the specific language governing permissions and
+rem limitations under the License.
+
+@echo OFF
+python -m streamlit %*
diff --git a/llm/Scripts/streamlit.exe b/llm/Scripts/streamlit.exe
new file mode 100644
index 0000000000000000000000000000000000000000..de70ac23997a03466c2fc37018b4f1e59d307384
Binary files /dev/null and b/llm/Scripts/streamlit.exe differ
diff --git a/llm/Scripts/torchrun.exe b/llm/Scripts/torchrun.exe
new file mode 100644
index 0000000000000000000000000000000000000000..a8e95d60ab5ac9b21128b734bf3490b1a780c48b
Binary files /dev/null and b/llm/Scripts/torchrun.exe differ
diff --git a/llm/Scripts/tqdm.exe b/llm/Scripts/tqdm.exe
new file mode 100644
index 0000000000000000000000000000000000000000..08777f639dcddcc00c9b82f5a1b46ada643feb24
Binary files /dev/null and b/llm/Scripts/tqdm.exe differ
diff --git a/llm/Scripts/transformers-cli.exe b/llm/Scripts/transformers-cli.exe
new file mode 100644
index 0000000000000000000000000000000000000000..d3c2ace3234260d3a4385182c07fb51cd3a92502
Binary files /dev/null and b/llm/Scripts/transformers-cli.exe differ
diff --git a/llm/Scripts/watchmedo.exe b/llm/Scripts/watchmedo.exe
new file mode 100644
index 0000000000000000000000000000000000000000..d37f815729ce08915e0d7053102ce29f9aa0e286
Binary files /dev/null and b/llm/Scripts/watchmedo.exe differ
diff --git a/llm/etc/jupyter/nbconfig/notebook.d/pydeck.json b/llm/etc/jupyter/nbconfig/notebook.d/pydeck.json
new file mode 100644
index 0000000000000000000000000000000000000000..143b42aeb573b96bac0391209543ff04ab82f651
--- /dev/null
+++ b/llm/etc/jupyter/nbconfig/notebook.d/pydeck.json
@@ -0,0 +1,5 @@
+{
+    "load_extensions": {
+        "pydeck/extension": true
+    }
+}
diff --git a/llm/pyvenv.cfg b/llm/pyvenv.cfg
new file mode 100644
index 0000000000000000000000000000000000000000..7b2b1d7e5e1c37713bb483d377dbedd3d836fc23
--- /dev/null
+++ b/llm/pyvenv.cfg
@@ -0,0 +1,5 @@
+home = C:\Users\Shubhangi\anaconda3
+include-system-site-packages = false
+version = 3.11.7
+executable = C:\Users\Shubhangi\anaconda3\python.exe
+command = C:\Users\Shubhangi\anaconda3\python.exe -m venv D:\MECL\llm
diff --git a/llm/share/jupyter/nbextensions/pydeck/extensionRequires.js b/llm/share/jupyter/nbextensions/pydeck/extensionRequires.js
new file mode 100644
index 0000000000000000000000000000000000000000..f663cc192edcb23360ed281390a083352c743434
--- /dev/null
+++ b/llm/share/jupyter/nbextensions/pydeck/extensionRequires.js
@@ -0,0 +1,15 @@
+/* eslint-disable */
+define(function() {
+  'use strict';
+  requirejs.config({
+    map: {
+      '*': {
+        '@deck.gl/jupyter-widget': 'nbextensions/pydeck/index'
+      }
+    }
+  });
+  // Export the required load_ipython_extension function
+  return {
+    load_ipython_extension: function() {}
+  };
+});
diff --git a/llm/share/jupyter/nbextensions/pydeck/index.js b/llm/share/jupyter/nbextensions/pydeck/index.js
new file mode 100644
index 0000000000000000000000000000000000000000..0bca0f10a290a101d20ba7efb5ee462d13c07ff6
--- /dev/null
+++ b/llm/share/jupyter/nbextensions/pydeck/index.js
@@ -0,0 +1,26 @@
+!function(t,e){if("object"==typeof exports&&"object"==typeof module)module.exports=e(require("@jupyter-widgets/base"));else if("function"==typeof define&&define.amd)define(["@jupyter-widgets/base"],e);else{var n="object"==typeof exports?e(require("@jupyter-widgets/base")):e(t["@jupyter-widgets/base"]);for(var r in n)("object"==typeof exports?exports:t)[r]=n[r]}}(window,(function(t){return function(t){var e={};function n(r){if(e[r])return e[r].exports;var i=e[r]={i:r,l:!1,exports:{}};return t[r].call(i.exports,i,i.exports,n),i.l=!0,i.exports}return n.m=t,n.c=e,n.d=function(t,e,r){n.o(t,e)||Object.defineProperty(t,e,{enumerable:!0,get:r})},n.r=function(t){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(t,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(t,"__esModule",{value:!0})},n.t=function(t,e){if(1&e&&(t=n(t)),8&e)return t;if(4&e&&"object"==typeof t&&t&&t.__esModule)return t;var r=Object.create(null);if(n.r(r),Object.defineProperty(r,"default",{enumerable:!0,value:t}),2&e&&"string"!=typeof t)for(var i in t)n.d(r,i,function(e){return t[e]}.bind(null,i));return r},n.n=function(t){var e=t&&t.__esModule?function(){return t.default}:function(){return t};return n.d(e,"a",e),e},n.o=function(t,e){return Object.prototype.hasOwnProperty.call(t,e)},n.p="",n(n.s=260)}([function(t,e){t.exports=function(t,e,n){return e in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t}},function(t,e){function n(e){return t.exports=n=Object.setPrototypeOf?Object.getPrototypeOf:function(t){return t.__proto__||Object.getPrototypeOf(t)},n(e)}t.exports=n},function(t,e,n){"use strict";function r(t,e,n){return e in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t}n.d(e,"a",(function(){return r}))},function(t,e){t.exports=function(t,e){if(!(t instanceof e))throw new TypeError("Cannot call a class as a function")}},function(t,e){function n(t,e){for(var n=0;n<e.length;n++){var r=e[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(t,r.key,r)}}t.exports=function(t,e,r){return e&&n(t.prototype,e),r&&n(t,r),t}},function(t,e,n){var r=n(275);t.exports=function(t,e){if("function"!=typeof e&&null!==e)throw new TypeError("Super expression must either be null or a function");t.prototype=Object.create(e&&e.prototype,{constructor:{value:t,writable:!0,configurable:!0}}),e&&r(t,e)}},function(t,e,n){var r=n(28),i=n(27);t.exports=function(t,e){return!e||"object"!==r(e)&&"function"!=typeof e?i(t):e}},function(t,e,n){"use strict";const r=new(n(298).a)({id:"luma.gl"});function i(t,e){if(!t)throw new Error(e||"luma.gl: assertion failed.")}function o(t){return"undefined"!=typeof WebGLRenderingContext&&t instanceof WebGLRenderingContext||("undefined"!=typeof WebGL2RenderingContext&&t instanceof WebGL2RenderingContext||Boolean(t&&Number.isFinite(t._version)))}function a(t){return"undefined"!=typeof WebGL2RenderingContext&&t instanceof WebGL2RenderingContext||Boolean(t&&2===t._version)}function s(t){return a(t)?t:null}function u(t){return i(o(t),"Invalid WebGLRenderingContext"),t}function c(t){return i(a(t),"Requires WebGL2"),t}const l={};function h(t,e){var n;l[t]=!0,void 0!==e&&(n=e,globalThis.console&&globalThis.console.error&&globalThis.console.error(n))}const f=function t(e){const n=e.gl;this.ext=e,this.isAlive=!0,this.hasBeenBound=!1,this.elementArrayBuffer=null,this.attribs=new Array(e.maxVertexAttribs);for(let e=0;e<this.attribs.length;e++){const r=new t.VertexAttrib(n);this.attribs[e]=r}this.maxAttrib=0};(f.VertexAttrib=function(t){this.enabled=!1,this.buffer=null,this.size=4,this.type=5126,this.normalized=!1,this.stride=16,this.offset=0,this.cached="",this.recache()}).prototype.recache=function(){this.cached=[this.size,this.type,this.normalized,this.stride,this.offset].join(":")};const p=function(t){const e=this;this.gl=t,function(t){const e=t.getError;t.getError=function(){let n;do{n=e.apply(t),0!==n&&(l[n]=!0)}while(0!==n);for(n in l)if(l[n])return delete l[n],parseInt(n,10);return 0}}(t);const n=this.original={getParameter:t.getParameter,enableVertexAttribArray:t.enableVertexAttribArray,disableVertexAttribArray:t.disableVertexAttribArray,bindBuffer:t.bindBuffer,getVertexAttrib:t.getVertexAttrib,vertexAttribPointer:t.vertexAttribPointer};t.getParameter=function(t){return t===e.VERTEX_ARRAY_BINDING_OES?e.currentVertexArrayObject===e.defaultVertexArrayObject?null:e.currentVertexArrayObject:n.getParameter.apply(this,arguments)},t.enableVertexAttribArray=function(t){const r=e.currentVertexArrayObject;r.maxAttrib=Math.max(r.maxAttrib,t);const i=r.attribs[t];return i.enabled=!0,n.enableVertexAttribArray.apply(this,arguments)},t.disableVertexAttribArray=function(t){const r=e.currentVertexArrayObject;r.maxAttrib=Math.max(r.maxAttrib,t);const i=r.attribs[t];return i.enabled=!1,n.disableVertexAttribArray.apply(this,arguments)},t.bindBuffer=function(t,r){switch(t){case 34962:e.currentArrayBuffer=r;break;case 34963:e.currentVertexArrayObject.elementArrayBuffer=r}return n.bindBuffer.apply(this,arguments)},t.getVertexAttrib=function(t,r){const i=e.currentVertexArrayObject,o=i.attribs[t];switch(r){case 34975:return o.buffer;case 34338:return o.enabled;case 34339:return o.size;case 34340:return o.stride;case 34341:return o.type;case 34922:return o.normalized;default:return n.getVertexAttrib.apply(this,arguments)}},t.vertexAttribPointer=function(t,r,i,o,a,s){const u=e.currentVertexArrayObject;u.maxAttrib=Math.max(u.maxAttrib,t);const c=u.attribs[t];return c.buffer=e.currentArrayBuffer,c.size=r,c.type=i,c.normalized=o,c.stride=a,c.offset=s,c.recache(),n.vertexAttribPointer.apply(this,arguments)},t.instrumentExtension&&t.instrumentExtension(this,"OES_vertex_array_object"),t.canvas&&t.canvas.addEventListener("webglcontextrestored",()=>{var t;t="OESVertexArrayObject emulation library context restored",globalThis.console&&globalThis.console.log&&globalThis.console.log(t),e.reset_()},!0),this.reset_()};p.prototype.VERTEX_ARRAY_BINDING_OES=34229,p.prototype.reset_=function(){if(void 0!==this.vertexArrayObjects)for(let t=0;t<this.vertexArrayObjects.length;++t)this.vertexArrayObjects.isAlive=!1;const t=this.gl;this.maxVertexAttribs=t.getParameter(34921),this.defaultVertexArrayObject=new f(this),this.currentVertexArrayObject=null,this.currentArrayBuffer=null,this.vertexArrayObjects=[this.defaultVertexArrayObject],this.bindVertexArrayOES(null)},p.prototype.createVertexArrayOES=function(){const t=new f(this);return this.vertexArrayObjects.push(t),t},p.prototype.deleteVertexArrayOES=function(t){t.isAlive=!1,this.vertexArrayObjects.splice(this.vertexArrayObjects.indexOf(t),1),this.currentVertexArrayObject===t&&this.bindVertexArrayOES(null)},p.prototype.isVertexArrayOES=function(t){return!!(t&&t instanceof f&&t.hasBeenBound&&t.ext===this)},p.prototype.bindVertexArrayOES=function(t){const e=this.gl;if(t&&!t.isAlive)return void h(1282,"bindVertexArrayOES: attempt to bind deleted arrayObject");const n=this.original,r=this.currentVertexArrayObject;this.currentVertexArrayObject=t||this.defaultVertexArrayObject,this.currentVertexArrayObject.hasBeenBound=!0;const i=this.currentVertexArrayObject;if(r===i)return;r&&i.elementArrayBuffer===r.elementArrayBuffer||n.bindBuffer.call(e,34963,i.elementArrayBuffer);let o=this.currentArrayBuffer;const a=Math.max(r?r.maxAttrib:0,i.maxAttrib);for(let t=0;t<=a;t++){const a=i.attribs[t],s=r?r.attribs[t]:null;if(r&&a.enabled===s.enabled||(a.enabled?n.enableVertexAttribArray.call(e,t):n.disableVertexAttribArray.call(e,t)),a.enabled){let i=!1;r&&a.buffer===s.buffer||(o!==a.buffer&&(n.bindBuffer.call(e,34962,a.buffer),o=a.buffer),i=!0),(i||a.cached!==s.cached)&&n.vertexAttribPointer.call(e,t,a.size,a.type,a.normalized,a.stride,a.offset)}}this.currentArrayBuffer!==o&&n.bindBuffer.call(e,34962,this.currentArrayBuffer)};const d=t=>a(t)?void 0:0,A={3074:t=>a(t)?void 0:36064,35723:t=>a(t)?void 0:4352,35977:d,32937:d,36795:(t,e)=>{const n=a(t)?t.getExtension("EXT_disjoint_timer_query_webgl2"):t.getExtension("EXT_disjoint_timer_query");return n&&n.GPU_DISJOINT_EXT?e(n.GPU_DISJOINT_EXT):0},37445:(t,e)=>{const n=t.getExtension("WEBGL_debug_renderer_info");return e(n&&n.UNMASKED_VENDOR_WEBGL||7936)},37446:(t,e)=>{const n=t.getExtension("WEBGL_debug_renderer_info");return e(n&&n.UNMASKED_RENDERER_WEBGL||7937)},34047:(t,e)=>{const n=t.luma.extensions.EXT_texture_filter_anisotropic;return n?e(n.MAX_TEXTURE_MAX_ANISOTROPY_EXT):1},32883:d,35071:d,37447:d,36063:(t,e)=>{if(!a(t)){const n=t.getExtension("WEBGL_draw_buffers");return n?e(n.MAX_COLOR_ATTACHMENTS_WEBGL):0}},35379:d,35374:d,35377:d,34852:t=>{if(!a(t)){const e=t.getExtension("WEBGL_draw_buffers");return e?e.MAX_DRAW_BUFFERS_WEBGL:0}},36203:t=>t.getExtension("OES_element_index")?2147483647:65535,33001:t=>t.getExtension("OES_element_index")?16777216:65535,33e3:t=>16777216,37157:d,35373:d,35657:d,36183:d,37137:d,34045:d,35978:d,35979:d,35968:d,35376:d,35375:d,35659:d,37154:d,35371:d,35658:d,35076:d,35077:d,35380:d};const g={OES_vertex_array_object:{meta:{suffix:"OES"},createVertexArray:()=>{i(!1,"VertexArray requires WebGL2 or OES_vertex_array_object extension")},deleteVertexArray:()=>{},bindVertexArray:()=>{},isVertexArray:()=>!1},ANGLE_instanced_arrays:{meta:{suffix:"ANGLE"},vertexAttribDivisor(t,e){i(0===e,"WebGL instanced rendering not supported")},drawElementsInstanced:()=>{},drawArraysInstanced:()=>{}},WEBGL_draw_buffers:{meta:{suffix:"WEBGL"},drawBuffers:()=>{i(!1)}},EXT_disjoint_timer_query:{meta:{suffix:"EXT"},createQuery:()=>{i(!1)},deleteQuery:()=>{i(!1)},beginQuery:()=>{i(!1)},endQuery:()=>{},getQuery(t,e){return this.getQueryObject(t,e)},getQueryParameter(t,e){return this.getQueryObject(t,e)},getQueryObject:()=>{}}},m={readBuffer:(t,e,n)=>{a(t)&&e(n)},getVertexAttrib:(t,e,n,r)=>{const{webgl2:i,ext:o}=function(t,e){return{webgl2:a(t),ext:t.getExtension(e)}}(t,"ANGLE_instanced_arrays");let s;switch(r){case 35069:s=!!i&&void 0;break;case 35070:s=i||o?void 0:0}return void 0!==s?s:e(n,r)},getProgramParameter:(t,e,n,r)=>{if(!a(t))switch(r){case 35967:return 35981;case 35971:case 35382:return 0}return e(n,r)},getInternalformatParameter:(t,e,n,r,i)=>{if(!a(t))switch(i){case 32937:return new Int32Array([0])}return t.getInternalformatParameter(n,r,i)},getTexParameter(t,e,n,r){switch(r){case 34046:const{extensions:e}=t.luma,n=e.EXT_texture_filter_anisotropic;r=n&&n.TEXTURE_MAX_ANISOTROPY_EXT||34046}return e(n,r)},getParameter:function(t,e,n){const r=A[n],i="function"==typeof r?r(t,e,n):r;return void 0!==i?i:e(n)},hint:(t,e,n,r)=>e(n,r)};function y(t,e){let{extension:n,target:r,target2:o}=e;const a=g[n];i(a);const{meta:s={}}=a,{suffix:u=""}=s,c=t.getExtension(n);for(const e of Object.keys(a)){const n="".concat(e).concat(u);let i=null;"meta"===e||"function"==typeof t[e]||(c&&"function"==typeof c[n]?i=function(){return c[n](...arguments)}:"function"==typeof a[e]&&(i=a[e].bind(r))),i&&(r[e]=i,o[e]=i)}}globalThis.polyfillContext=function(t){t.luma=t.luma||{};const{luma:e}=t;return e.polyfilled||(!function(t){if("function"==typeof t.createVertexArray)return;const e=t.getSupportedExtensions;t.getSupportedExtensions=function(){const t=e.call(this)||[];return t.indexOf("OES_vertex_array_object")<0&&t.push("OES_vertex_array_object"),t};const n=t.getExtension;t.getExtension=function(e){const r=n.call(this,e);return r||("OES_vertex_array_object"!==e?null:(t.__OESVertexArrayObject||(this.__OESVertexArrayObject=new p(this)),this.__OESVertexArrayObject))}}(t),function(t){t.luma.extensions={};const e=t.getSupportedExtensions()||[];for(const n of e)t.luma[n]=t.getExtension(n)}(t),function(t,e){for(const n of Object.getOwnPropertyNames(e))"overrides"!==n&&y(t,{extension:n,target:t.luma,target2:t})}(t,g),function(t,e){let{target:n,target2:r}=e;Object.keys(m).forEach(e=>{if("function"==typeof m[e]){const i=t[e]?t[e].bind(t):()=>{},o=m[e].bind(null,t,i);n[e]=o,r[e]=o}})}(t,{target:e,target2:t}),e.polyfilled=!0),t};const v={3042:!1,32773:new Float32Array([0,0,0,0]),32777:32774,34877:32774,32969:1,32968:0,32971:1,32970:0,3106:new Float32Array([0,0,0,0]),3107:[!0,!0,!0,!0],2884:!1,2885:1029,2929:!1,2931:1,2932:513,2928:new Float32Array([0,1]),2930:!0,3024:!0,36006:null,2886:2305,33170:4352,2849:1,32823:!1,32824:0,10752:0,32938:1,32939:!1,3089:!1,3088:new Int32Array([0,0,1024,1024]),2960:!1,2961:0,2968:4294967295,36005:4294967295,2962:519,2967:0,2963:4294967295,34816:519,36003:0,36004:4294967295,2964:7680,2965:7680,2966:7680,34817:7680,34818:7680,34819:7680,2978:[0,0,1024,1024],3333:4,3317:4,37440:!1,37441:!1,37443:37444,35723:4352,36010:null,35977:!1,3330:0,3332:0,3331:0,3314:0,32878:0,3316:0,3315:0,32877:0},_=(t,e,n)=>e?t.enable(n):t.disable(n),b=(t,e,n)=>t.hint(n,e),x=(t,e,n)=>t.pixelStorei(n,e);function w(t){return Array.isArray(t)||ArrayBuffer.isView(t)}const E={3042:_,32773:(t,e)=>t.blendColor(...e),32777:"blendEquation",34877:"blendEquation",32969:"blendFunc",32968:"blendFunc",32971:"blendFunc",32970:"blendFunc",3106:(t,e)=>t.clearColor(...e),3107:(t,e)=>t.colorMask(...e),2884:_,2885:(t,e)=>t.cullFace(e),2929:_,2931:(t,e)=>t.clearDepth(e),2932:(t,e)=>t.depthFunc(e),2928:(t,e)=>t.depthRange(...e),2930:(t,e)=>t.depthMask(e),3024:_,35723:b,36006:(t,e)=>{const n=a(t)?36009:36160;return t.bindFramebuffer(n,e)},2886:(t,e)=>t.frontFace(e),33170:b,2849:(t,e)=>t.lineWidth(e),32823:_,32824:"polygonOffset",10752:"polygonOffset",35977:_,32938:"sampleCoverage",32939:"sampleCoverage",3089:_,3088:(t,e)=>t.scissor(...e),2960:_,2961:(t,e)=>t.clearStencil(e),2968:(t,e)=>t.stencilMaskSeparate(1028,e),36005:(t,e)=>t.stencilMaskSeparate(1029,e),2962:"stencilFuncFront",2967:"stencilFuncFront",2963:"stencilFuncFront",34816:"stencilFuncBack",36003:"stencilFuncBack",36004:"stencilFuncBack",2964:"stencilOpFront",2965:"stencilOpFront",2966:"stencilOpFront",34817:"stencilOpBack",34818:"stencilOpBack",34819:"stencilOpBack",2978:(t,e)=>t.viewport(...e),3333:x,3317:x,37440:x,37441:x,37443:x,3330:x,3332:x,3331:x,36010:(t,e)=>t.bindFramebuffer(36008,e),3314:x,32878:x,3316:x,3315:x,32877:x,framebuffer:(t,e)=>{const n=e&&"handle"in e?e.handle:e;return t.bindFramebuffer(36160,n)},blend:(t,e)=>e?t.enable(3042):t.disable(3042),blendColor:(t,e)=>t.blendColor(...e),blendEquation:(t,e)=>{e=w(e)?e:[e,e],t.blendEquationSeparate(...e)},blendFunc:(t,e)=>{e=w(e)&&2===e.length?[...e,...e]:e,t.blendFuncSeparate(...e)},clearColor:(t,e)=>t.clearColor(...e),clearDepth:(t,e)=>t.clearDepth(e),clearStencil:(t,e)=>t.clearStencil(e),colorMask:(t,e)=>t.colorMask(...e),cull:(t,e)=>e?t.enable(2884):t.disable(2884),cullFace:(t,e)=>t.cullFace(e),depthTest:(t,e)=>e?t.enable(2929):t.disable(2929),depthFunc:(t,e)=>t.depthFunc(e),depthMask:(t,e)=>t.depthMask(e),depthRange:(t,e)=>t.depthRange(...e),dither:(t,e)=>e?t.enable(3024):t.disable(3024),derivativeHint:(t,e)=>{t.hint(35723,e)},frontFace:(t,e)=>t.frontFace(e),mipmapHint:(t,e)=>t.hint(33170,e),lineWidth:(t,e)=>t.lineWidth(e),polygonOffsetFill:(t,e)=>e?t.enable(32823):t.disable(32823),polygonOffset:(t,e)=>t.polygonOffset(...e),sampleCoverage:(t,e)=>t.sampleCoverage(...e),scissorTest:(t,e)=>e?t.enable(3089):t.disable(3089),scissor:(t,e)=>t.scissor(...e),stencilTest:(t,e)=>e?t.enable(2960):t.disable(2960),stencilMask:(t,e)=>{e=w(e)?e:[e,e];const[n,r]=e;t.stencilMaskSeparate(1028,n),t.stencilMaskSeparate(1029,r)},stencilFunc:(t,e)=>{e=w(e)&&3===e.length?[...e,...e]:e;const[n,r,i,o,a,s]=e;t.stencilFuncSeparate(1028,n,r,i),t.stencilFuncSeparate(1029,o,a,s)},stencilOp:(t,e)=>{e=w(e)&&3===e.length?[...e,...e]:e;const[n,r,i,o,a,s]=e;t.stencilOpSeparate(1028,n,r,i),t.stencilOpSeparate(1029,o,a,s)},viewport:(t,e)=>t.viewport(...e)};function O(t,e,n){return void 0!==e[t]?e[t]:n[t]}const S={blendEquation:(t,e,n)=>t.blendEquationSeparate(O(32777,e,n),O(34877,e,n)),blendFunc:(t,e,n)=>t.blendFuncSeparate(O(32969,e,n),O(32968,e,n),O(32971,e,n),O(32970,e,n)),polygonOffset:(t,e,n)=>t.polygonOffset(O(32824,e,n),O(10752,e,n)),sampleCoverage:(t,e,n)=>t.sampleCoverage(O(32938,e,n),O(32939,e,n)),stencilFuncFront:(t,e,n)=>t.stencilFuncSeparate(1028,O(2962,e,n),O(2967,e,n),O(2963,e,n)),stencilFuncBack:(t,e,n)=>t.stencilFuncSeparate(1029,O(34816,e,n),O(36003,e,n),O(36004,e,n)),stencilOpFront:(t,e,n)=>t.stencilOpSeparate(1028,O(2964,e,n),O(2965,e,n),O(2966,e,n)),stencilOpBack:(t,e,n)=>t.stencilOpSeparate(1029,O(34817,e,n),O(34818,e,n),O(34819,e,n))},T={enable:(t,e)=>t({[e]:!0}),disable:(t,e)=>t({[e]:!1}),pixelStorei:(t,e,n)=>t({[e]:n}),hint:(t,e,n)=>t({[e]:n}),bindFramebuffer:(t,e,n)=>{switch(e){case 36160:return t({36006:n,36010:n});case 36009:return t({36006:n});case 36008:return t({36010:n});default:return null}},blendColor:(t,e,n,r,i)=>t({32773:new Float32Array([e,n,r,i])}),blendEquation:(t,e)=>t({32777:e,34877:e}),blendEquationSeparate:(t,e,n)=>t({32777:e,34877:n}),blendFunc:(t,e,n)=>t({32969:e,32968:n,32971:e,32970:n}),blendFuncSeparate:(t,e,n,r,i)=>t({32969:e,32968:n,32971:r,32970:i}),clearColor:(t,e,n,r,i)=>t({3106:new Float32Array([e,n,r,i])}),clearDepth:(t,e)=>t({2931:e}),clearStencil:(t,e)=>t({2961:e}),colorMask:(t,e,n,r,i)=>t({3107:[e,n,r,i]}),cullFace:(t,e)=>t({2885:e}),depthFunc:(t,e)=>t({2932:e}),depthRange:(t,e,n)=>t({2928:new Float32Array([e,n])}),depthMask:(t,e)=>t({2930:e}),frontFace:(t,e)=>t({2886:e}),lineWidth:(t,e)=>t({2849:e}),polygonOffset:(t,e,n)=>t({32824:e,10752:n}),sampleCoverage:(t,e,n)=>t({32938:e,32939:n}),scissor:(t,e,n,r,i)=>t({3088:new Int32Array([e,n,r,i])}),stencilMask:(t,e)=>t({2968:e,36005:e}),stencilMaskSeparate:(t,e,n)=>t({[1028===e?2968:36005]:n}),stencilFunc:(t,e,n,r)=>t({2962:e,2967:n,2963:r,34816:e,36003:n,36004:r}),stencilFuncSeparate:(t,e,n,r,i)=>t({[1028===e?2962:34816]:n,[1028===e?2967:36003]:r,[1028===e?2963:36004]:i}),stencilOp:(t,e,n,r)=>t({2964:e,2965:n,2966:r,34817:e,34818:n,34819:r}),stencilOpSeparate:(t,e,n,r,i)=>t({[1028===e?2964:34817]:n,[1028===e?2965:34818]:r,[1028===e?2966:34819]:i}),viewport:(t,e,n,r,i)=>t({2978:[e,n,r,i]})},C=(t,e)=>t.isEnabled(e),P={3042:C,2884:C,2929:C,3024:C,32823:C,32926:C,32928:C,3089:C,2960:C,35977:C};function M(t){for(const e in t)return!1;return!0}function I(t,e){if(t===e)return!0;const n=Array.isArray(t)||ArrayBuffer.isView(t),r=Array.isArray(e)||ArrayBuffer.isView(e);if(n&&r&&t.length===e.length){for(let n=0;n<t.length;++n)if(t[n]!==e[n])return!1;return!0}return!1}function B(t,e){const n=t[e].bind(t);t[e]=function(){const e=arguments.length<=0?void 0:arguments[0];return e in t.state.cache&&t.state.enable?t.state.cache[e]:n(...arguments)},Object.defineProperty(t[e],"name",{value:"".concat(e,"-from-cache"),configurable:!1})}function R(t,e,n){const r=t[e].bind(t);t[e]=function(){for(var e=arguments.length,i=new Array(e),o=0;o<e;o++)i[o]=arguments[o];const{valueChanged:a,oldValue:s}=n(t.state._updateCache,...i);return a&&r(...i),s},Object.defineProperty(t[e],"name",{value:"".concat(e,"-to-cache"),configurable:!1})}function k(t){const e=t.useProgram.bind(t);t.useProgram=function(n){t.state.program!==n&&(e(n),t.state.program=n)}}class D{constructor(t){let{copyState:e=!1,log:n=(()=>{})}=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};this.gl=t,this.program=null,this.stateStack=[],this.enable=!0,this.cache=e?z(t):Object.assign({},v),this.log=n,this._updateCache=this._updateCache.bind(this),Object.seal(this)}push(){this.stateStack.push({})}pop(){i(this.stateStack.length>0);const t=this.stateStack[this.stateStack.length-1];F(this.gl,t),this.stateStack.pop()}_updateCache(t){let e,n=!1;const r=this.stateStack.length>0&&this.stateStack[this.stateStack.length-1];for(const o in t){i(void 0!==o);const a=t[o],s=this.cache[o];I(a,s)||(n=!0,e=s,r&&!(o in r)&&(r[o]=s),this.cache[o]=a)}return{valueChanged:n,oldValue:e}}}function L(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};const{enable:n=!0,copyState:r}=e;if(i(void 0!==r),!t.state){const{polyfillContext:e}=globalThis;e&&e(t),t.state=new D(t,{copyState:r}),k(t);for(const e in T){R(t,e,T[e])}B(t,"getParameter"),B(t,"isEnabled")}return t.state.enable=n,t}function j(t){i(t.state),t.state.pop()}function F(t,e){if(i(o(t),"setParameters requires a WebGL context"),M(e))return;const n={};for(const r in e){const i=Number(r),o=E[r];o&&("string"==typeof o?n[o]=!0:o(t,e[r],i))}const r=t.state&&t.state.cache;if(r)for(const i in n){(0,S[i])(t,e,r)}}function z(t,e){if("number"==typeof(e=e||v)){const n=e,r=P[n];return r?r(t,n):t.getParameter(n)}const n=Array.isArray(e)?e:Object.keys(e),r={};for(const e of n){const n=P[e];r[e]=n?n(t,Number(e)):t.getParameter(Number(e))}return r}function U(t){F(t,v)}function N(t,e,n){if(M(e))return n(t);const{nocatch:r=!0}=e;let i;if(function(t){t.state||L(t,{copyState:!1}),t.state.push()}(t),F(t,e),r)i=n(t),j(t);else try{i=n(t)}finally{j(t)}return i}var G=n(142);function V(t){const{luma:e}=t;if(t.canvas&&e){const{clientWidth:n}=e.canvasSizeInfo;return n?t.drawingBufferWidth/n:1}return 1}function H(t,e){let n=!(arguments.length>2&&void 0!==arguments[2])||arguments[2];const r=V(t),i=t.drawingBufferWidth,o=t.drawingBufferHeight;return q(e,r,i,o,n)}function W(t){const e="undefined"==typeof window?1:window.devicePixelRatio||1;return Number.isFinite(t)?t<=0?1:t:t?e:1}function q(t,e,n,r,i){const o=X(t[0],e,n);let a=Z(t[1],e,r,i),s=X(t[0]+1,e,n);const u=s===n-1?s:s-1;let c;return s=Z(t[1]+1,e,r,i),i?(s=0===s?s:s+1,c=a,a=s):c=s===r-1?s:s-1,{x:o,y:a,width:Math.max(u-o+1,1),height:Math.max(c-a+1,1)}}function X(t,e,n){return Math.min(Math.round(t*e),n-1)}function Z(t,e,n,r){return r?Math.max(0,n-1-Math.round(t*e)):Math.min(Math.round(t*e),n-1)}const J=Object(G.a)(),Q=J&&"undefined"!=typeof document,K={webgl2:!0,webgl1:!0,throwOnError:!0,manageState:!0,canvas:null,debug:!1,width:800,height:600};function Y(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};i(J,"createGLContext only available in the browser.\nCreate your own headless context or use 'createHeadlessContext' from @luma.gl/test-utils"),t=Object.assign({},K,t);const{width:e,height:n}=t;function r(e){if(t.throwOnError)throw new Error(e);return console.error(e),null}let o;t.onError=r;const{canvas:a}=t,s=nt({canvas:a,width:e,height:n,onError:r});return o=et(s,t),o?(o=$(o,t),rt(o),o):null}function $(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};if(!t||t._instrumented)return t;t._version=t._version||it(t),t.luma=t.luma||{},t.luma.canvasSizeInfo=t.luma.canvasSizeInfo||{},e=Object.assign({},K,e);const{manageState:n,debug:i}=e;return n&&L(t,{copyState:!1,log:function(){for(var t=arguments.length,e=new Array(t),n=0;n<t;n++)e[n]=arguments[n];return r.log(1,...e)()}}),J&&i&&(globalThis.makeDebugContext?(t=globalThis.makeDebugContext(t,e),r.level=Math.max(r.level,1)):r.warn('WebGL debug mode not activated. import "@luma.gl/debug" to enable.')()),t._instrumented=!0,t}function tt(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};if(t.canvas){return void ot(t,W(e.useDevicePixels),e)}const n=t.getExtension("STACKGL_resize_drawingbuffer");n&&"width"in e&&"height"in e&&n.resize(e.width,e.height)}function et(t,e){const{onError:n}=e;let r=null;const i=t=>r=t.statusMessage||r;t.addEventListener("webglcontextcreationerror",i,!1);const{webgl1:o=!0,webgl2:a=!0}=e;let s=null;return a&&(s=s||t.getContext("webgl2",e),s=s||t.getContext("experimental-webgl2",e)),o&&(s=s||t.getContext("webgl",e),s=s||t.getContext("experimental-webgl",e)),t.removeEventListener("webglcontextcreationerror",i,!1),s?(e.onContextLost&&t.addEventListener("webglcontextlost",e.onContextLost,!1),e.onContextRestored&&t.addEventListener("webglcontextrestored",e.onContextRestored,!1),s):n("Failed to create ".concat(a&&!o?"WebGL2":"WebGL"," context: ").concat(r||"Unknown error"))}function nt(t){let e,{canvas:n,width:r=800,height:i=600,onError:o}=t;if("string"==typeof n){Q&&"complete"===document.readyState||o("createGLContext called on canvas '".concat(n,"' before page was loaded")),e=document.getElementById(n)}else n?e=n:(e=document.createElement("canvas"),e.id="lumagl-canvas",e.style.width=Number.isFinite(r)?"".concat(r,"px"):"100%",e.style.height=Number.isFinite(i)?"".concat(i,"px"):"100%",document.body.insertBefore(e,document.body.firstChild));return e}function rt(t){const e=a(t)?"WebGL2":"WebGL1",n=function(t){const e=t.getParameter(7936),n=t.getParameter(7937),r=t.getExtension("WEBGL_debug_renderer_info");return{vendor:r&&t.getParameter(r.UNMASKED_VENDOR_WEBGL||7936)||e,renderer:r&&t.getParameter(r.UNMASKED_RENDERER_WEBGL||7937)||n,vendorMasked:e,rendererMasked:n,version:t.getParameter(7938),shadingLanguageVersion:t.getParameter(35724)}}(t),i=n?"(".concat(n.vendor,",").concat(n.renderer,")"):"",o=t.debug?" debug":"";r.info(1,"".concat(e).concat(o," context ").concat(i))()}function it(t){return"undefined"!=typeof WebGL2RenderingContext&&t instanceof WebGL2RenderingContext?2:1}function ot(t,e,n){let i="width"in n?n.width:t.canvas.clientWidth,o="height"in n?n.height:t.canvas.clientHeight;i&&o||(r.log(1,"Canvas clientWidth/clientHeight is 0")(),e=1,i=t.canvas.width||1,o=t.canvas.height||1),t.luma=t.luma||{},t.luma.canvasSizeInfo=t.luma.canvasSizeInfo||{};const a=t.luma.canvasSizeInfo;if(a.clientWidth!==i||a.clientHeight!==o||a.devicePixelRatio!==e){let n=e;const a=Math.floor(i*n),s=Math.floor(o*n);t.canvas.width=a,t.canvas.height=s,t.drawingBufferWidth===a&&t.drawingBufferHeight===s||(r.warn("Device pixel ratio clamped")(),n=Math.min(t.drawingBufferWidth/i,t.drawingBufferHeight/o),t.canvas.width=Math.floor(i*n),t.canvas.height=Math.floor(o*n)),Object.assign(t.luma.canvasSizeInfo,{clientWidth:i,clientHeight:o,devicePixelRatio:e})}}n.d(e,"k",(function(){return r})),n.d(e,"i",(function(){return o})),n.d(e,"j",(function(){return a})),n.d(e,"g",(function(){return s})),n.d(e,"b",(function(){return u})),n.d(e,"a",(function(){return c})),n.d(e,"f",(function(){return z})),n.d(e,"n",(function(){return F})),n.d(e,"l",(function(){return U})),n.d(e,"o",(function(){return N})),n.d(e,"c",(function(){return Y})),n.d(e,"m",(function(){return tt})),n.d(e,"h",(function(){return $})),n.d(e,"e",(function(){return V})),n.d(e,"d",(function(){return H}))},function(t,e,n){var r=n(274);function i(e,n,o){return"undefined"!=typeof Reflect&&Reflect.get?t.exports=i=Reflect.get:t.exports=i=function(t,e,n){var i=r(t,e);if(i){var o=Object.getOwnPropertyDescriptor(i,e);return o.get?o.get.call(n):o.value}},i(e,n,o||e)}t.exports=i},function(t,e,n){var r=n(271),i=n(272),o=n(273);t.exports=function(t,e){return r(t)||i(t,e)||o()}},function(t,e,n){"use strict";function r(t,e){if(!t)throw new Error(e||"luma.gl: assertion failed.")}n.d(e,"a",(function(){return r}))},function(t,e,n){"use strict";n.d(e,"b",(function(){return r})),n.d(e,"a",(function(){return i})),n.d(e,"c",(function(){return o}));var r=1e-6,i="undefined"!=typeof Float32Array?Float32Array:Array,o=Math.random;Math.PI;Math.hypot||(Math.hypot=function(){for(var t=0,e=arguments.length;e--;)t+=arguments[e]*arguments[e];return Math.sqrt(t)})},function(t,e,n){"use strict";n.d(e,"a",(function(){return i})),n.d(e,"d",(function(){return o})),n.d(e,"e",(function(){return a})),n.d(e,"b",(function(){return s})),n.d(e,"c",(function(){return u}));var r=n(21),i={DEFAULT:-1,LNGLAT:1,METER_OFFSETS:2,LNGLAT_OFFSETS:3,CARTESIAN:0};Object.defineProperty(i,"IDENTITY",{get:function(){return r.a.deprecated("COORDINATE_SYSTEM.IDENTITY","COORDINATE_SYSTEM.CARTESIAN")(),0}});var o={WEB_MERCATOR:1,GLOBE:2,WEB_MERCATOR_AUTO_OFFSET:4,IDENTITY:0},a={common:0,meters:1,pixels:2},s={click:{handler:"onClick"},panstart:{handler:"onDragStart"},panmove:{handler:"onDrag"},panend:{handler:"onDragEnd"}},u={DRAW:"draw",MASK:"mask"}},function(t,e,n){"use strict";n.d(e,"b",(function(){return o})),n.d(e,"e",(function(){return a})),n.d(e,"f",(function(){return s})),n.d(e,"j",(function(){return u})),n.d(e,"i",(function(){return c})),n.d(e,"h",(function(){return l})),n.d(e,"c",(function(){return h})),n.d(e,"a",(function(){return f})),n.d(e,"g",(function(){return p})),n.d(e,"d",(function(){return d}));n(144);const r=1/Math.PI*180,i=1/180*Math.PI,o={EPSILON:1e-12,debug:!1,precision:4,printTypes:!1,printDegrees:!1,printRowMajor:!0};function a(t,{precision:e=o.precision}={}){return t=function(t){return Math.round(t/o.EPSILON)*o.EPSILON}(t),"".concat(parseFloat(t.toPrecision(e)))}function s(t){return Array.isArray(t)||ArrayBuffer.isView(t)&&!(t instanceof DataView)}function u(t){return l(t)}function c(t){return h(t)}function l(t,e){return A(t,t=>t*i,e)}function h(t,e){return A(t,t=>t*r,e)}function f(t,e,n){return A(t,t=>Math.max(e,Math.min(n,t)))}function p(t,e,n){return s(t)?t.map((t,r)=>p(t,e[r],n)):n*e+(1-n)*t}function d(t,e,n){const r=o.EPSILON;n&&(o.EPSILON=n);try{if(t===e)return!0;if(s(t)&&s(e)){if(t.length!==e.length)return!1;for(let n=0;n<t.length;++n)if(!d(t[n],e[n]))return!1;return!0}return t&&t.equals?t.equals(e):e&&e.equals?e.equals(t):"number"==typeof t&&"number"==typeof e&&Math.abs(t-e)<=o.EPSILON*Math.max(1,Math.abs(t),Math.abs(e))}finally{o.EPSILON=r}}function A(t,e,n){if(s(t)){const r=t;n=n||function(t){return t.clone?t.clone():new Array(t.length)}(r);for(let i=0;i<n.length&&i<r.length;++i)n[i]=e(t[i],i,n);return n}return e(t)}},,function(t,e,n){"use strict";n.d(e,"b",(function(){return r})),n.d(e,"a",(function(){return i})),n.d(e,"c",(function(){return o}));var r=1e-6,i="undefined"!=typeof Float32Array?Float32Array:Array,o=Math.random;Math.PI;Math.hypot||(Math.hypot=function(){for(var t=0,e=arguments.length;e--;)t+=arguments[e]*arguments[e];return Math.sqrt(t)})},function(t,e,n){"use strict";n.r(e);var r=n(12),i=n(139),o=n(152),a=n(102),s=n(3),u=n.n(s),c=n(4),l=n.n(c),h=n(0),f=n.n(h),p=n(145);function d(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function A(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?d(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):d(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var g=[255,255,255],m=[0,0,1],y=[0,0,1],v=0,_=function(){function t(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};u()(this,t),f()(this,"type","point");var n=e.color,r=void 0===n?g:n,i=e.intensity,o=void 0===i?1:i,a=e.position,s=void 0===a?y:a;this.id=e.id||"point-".concat(v++),this.color=r,this.intensity=o,this.type="point",this.position=s,this.attenuation=b(e),this.projectedLight=A({},this)}return l()(t,[{key:"getProjectedLight",value:function(t){var e=t.layer,n=this.projectedLight,i=e.context.viewport,o=e.props,a=o.coordinateSystem,s=o.coordinateOrigin,u=Object(p.b)(this.position,{viewport:i,coordinateSystem:a,coordinateOrigin:s,fromCoordinateSystem:i.isGeospatial?r.a.LNGLAT:r.a.CARTESIAN,fromCoordinateOrigin:[0,0,0]});return n.color=this.color,n.intensity=this.intensity,n.position=u,n}}]),t}();function b(t){return t.attenuation?t.attenuation:"intensity"in t?[0,0,t.intensity||0]:m}var x=n(5),w=n.n(x),E=n(6),O=n.n(E),S=n(1),T=n.n(S),C=n(124);function P(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=T()(t);if(e){var i=T()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return O()(this,n)}}var M=function(t){w()(n,t);var e=P(n);function n(){return u()(this,n),e.apply(this,arguments)}return l()(n,[{key:"getProjectedLight",value:function(t){var e=t.layer,n=this.projectedLight,r=e.context.viewport,i=e.props,o=i.coordinateSystem,a=i.coordinateOrigin,s=i.modelMatrix,u=Object(C.b)({viewport:r,modelMatrix:s,coordinateSystem:o,coordinateOrigin:a}).project_uCameraPosition;return n.color=this.color,n.intensity=this.intensity,n.position=u,n}}]),n}(_),I=n(9),B=n.n(I);const R=Math.PI/180,k=23.4397*R;function D(t,e,n){const r=R*-n,i=R*e,o=function(t){return function(t){return("number"==typeof t?t:t.getTime())/864e5-.5+2440588}(t)-2451545}(t),a=function(t){const e=function(t){const e=t,n=R*(1.9148*Math.sin(e)+.02*Math.sin(2*e)+3e-4*Math.sin(3*e));return e+n+102.9372*R+Math.PI}((n=t,R*(357.5291+.98560028*n)));var n;return{declination:F(e,0),rightAscension:j(e,0)}}(o),s=function(t,e){return R*(280.147+360.9856235*t)-e}(o,r)-a.rightAscension;return{azimuth:z(s,i,a.declination),altitude:U(s,i,a.declination)}}function L(t,e,n){const{azimuth:r,altitude:i}=D(t,e,n);return[Math.sin(r)*Math.cos(i),Math.cos(r)*Math.cos(i),-Math.sin(i)]}function j(t,e){const n=t;return Math.atan2(Math.sin(n)*Math.cos(k)-Math.tan(e)*Math.sin(k),Math.cos(n))}function F(t,e){const n=t;return Math.asin(Math.sin(e)*Math.cos(k)+Math.cos(e)*Math.sin(k)*Math.sin(n))}function z(t,e,n){const r=t,i=e,o=n;return Math.atan2(Math.sin(r),Math.cos(r)*Math.sin(i)-Math.tan(o)*Math.cos(i))}function U(t,e,n){const r=t,i=e,o=n;return Math.asin(Math.sin(i)*Math.sin(o)+Math.cos(i)*Math.cos(o)*Math.cos(r))}function N(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=T()(t);if(e){var i=T()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return O()(this,n)}}var G=function(t){w()(n,t);var e=N(n);function n(t){var r;return u()(this,n),(r=e.call(this,t)).timestamp=t.timestamp,r}return l()(n,[{key:"getProjectedLight",value:function(t){var e=t.layer.context.viewport;if(e.resolution&&e.resolution>0){var n=L(this.timestamp,0,0),r=B()(n,3),i=r[0],o=r[1],a=r[2];this.direction=[i,-a,o]}else{var s=e.latitude,u=e.longitude;this.direction=L(this.timestamp,s,u)}return this}}]),n}(a.a),V=n(186),H=n(60);const W=[-1,-1,1,-1,-1,1,1,1];class q extends V.a{constructor(t,e){const n=W.map(t=>-1===t?0:t);super(t,Object.assign({},e,{vs:"attribute vec2 aClipSpacePosition;\nattribute vec2 aTexCoord;\nattribute vec2 aCoordinate;\n\nvarying vec2 position;\nvarying vec2 coordinate;\nvarying vec2 uv;\n\nvoid main(void) {\n  gl_Position = vec4(aClipSpacePosition, 0., 1.);\n  position = aClipSpacePosition;\n  coordinate = aCoordinate;\n  uv = aTexCoord;\n}\n",geometry:new H.a({drawMode:5,vertexCount:4,attributes:{aClipSpacePosition:{size:2,value:new Float32Array(W)},aTexCoord:{size:2,value:new Float32Array(n)},aCoordinate:{size:2,value:new Float32Array(n)}}})})),this.setVertexCount(4)}}var X=n(7),Z=n(188);function J(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=T()(t);if(e){var i=T()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return O()(this,n)}}var Q=function(t){w()(n,t);var e=J(n);function n(t,r){var i;u()(this,n),i=e.call(this,t,r);var o=r.module,a=r.fs,s=r.id;return i.model=new q(t,{id:s,fs:a,modules:[o]}),i}return l()(n,[{key:"render",value:function(t){var e=this,n=this.gl;Object(X.n)(n,{viewport:[0,0,n.drawingBufferWidth,n.drawingBufferHeight]}),Object(X.o)(n,{framebuffer:t.outputBuffer,clearColor:[0,0,0,0]},(function(){return e._renderPass(n,t)}))}},{key:"delete",value:function(){this.model.delete(),this.model=null}},{key:"_renderPass",value:function(t,e){var n=e.inputBuffer;Object(Z.a)(t,{color:!0}),this.model.draw({moduleSettings:this.props.moduleSettings,uniforms:{texture:n,texSize:[n.width,n.height]},parameters:{depthWrite:!1,depthTest:!1}})}}]),n}(n(178).a),K=n(205);function Y(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return $(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return $(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function $(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var tt=function(){function t(e){var n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};u()(this,t),this.id="".concat(e.name,"-pass"),this.props=n,Object(K.b)(e),this.module=e}return l()(t,[{key:"preRender",value:function(){}},{key:"postRender",value:function(t,e){var n=this.passes||function(t,e,n,r){if(!e.passes){var i=rt(e);return[new Q(t,{id:n,module:e,fs:i,moduleSettings:r})]}return e.passes.map((function(i,o){var a=rt(e,i),s="".concat(n,"-").concat(o);return new Q(t,{id:s,module:e,fs:a,moduleSettings:r})}))}(t,this.module,this.id,this.props);this.passes=n;for(var r=e.target,i=e.inputBuffer,o=e.swapBuffer,a=0;a<this.passes.length;a++){r&&a===this.passes.length-1&&(o=r),this.passes[a].render({inputBuffer:i,outputBuffer:o});var s=o;o=i,i=s}return i}},{key:"cleanup",value:function(){if(this.passes){var t,e=Y(this.passes);try{for(e.s();!(t=e.n()).done;){t.value.delete()}}catch(t){e.e(t)}finally{e.f()}this.passes=void 0}}}]),t}();var et=function(t){return"uniform sampler2D texture;\nuniform vec2 texSize;\n\nvarying vec2 position;\nvarying vec2 coordinate;\nvarying vec2 uv;\n\nvoid main() {\n  vec2 texCoord = coordinate;\n\n  gl_FragColor = texture2D(texture, texCoord);\n  gl_FragColor = ".concat(t,"(gl_FragColor, texSize, texCoord);\n}\n")},nt=function(t){return"uniform sampler2D texture;\nuniform vec2 texSize;\n\nvarying vec2 position;\nvarying vec2 coordinate;\nvarying vec2 uv;\n\nvoid main() {\n  vec2 texCoord = coordinate;\n\n  gl_FragColor = ".concat(t,"(texture, texSize, texCoord);\n}\n")};function rt(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:t;if(e.filter){var n="string"==typeof e.filter?e.filter:"".concat(t.name,"_filterColor");return et(n)}if(e.sampler){var r="string"==typeof e.sampler?e.sampler:"".concat(t.name,"_sampleColor");return nt(r)}return null}var it=n(73),ot=n(199),at=n(170),st=n(165),ut=n(164),ct=n(198),lt=n(172),ht=n(42),ft=n(86),pt=n(163),dt=n(78),At=n(19);function gt(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function mt(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?gt(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):gt(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function yt(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=T()(t);if(e){var i=T()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return O()(this,n)}}var vt=Math.PI/180;function _t(t){var e=t.height,n=t.focalDistance,r=t.orbitAxis,i=t.rotationX,o=t.rotationOrbit,a=t.zoom,s="Z"===r?[0,0,1]:[0,1,0],u="Z"===r?[0,-n,0]:[0,0,n],c=(new dt.a).lookAt({eye:u,up:s});c.rotateX(i*vt),"Z"===r?c.rotateZ(o*vt):c.rotateY(o*vt);var l=Math.pow(2,a)/e;return c.scale(l),c}var bt=function(t){w()(n,t);var e=yt(n);function n(t){var r;u()(this,n);var i=t.height,o=t.projectionMatrix,a=t.fovy,s=void 0===a?50:a,c=t.orbitAxis,l=void 0===c?"Z":c,h=t.target,f=void 0===h?[0,0,0]:h,p=t.rotationX,d=void 0===p?0:p,A=t.rotationOrbit,g=void 0===A?0:A,m=t.zoom,y=void 0===m?0:m,v=o?o[5]/2:Object(At.e)(s);return(r=e.call(this,mt(mt({},t),{},{longitude:void 0,viewMatrix:_t({height:i||1,focalDistance:v,orbitAxis:l,rotationX:d,rotationOrbit:g,zoom:y}),fovy:s,focalDistance:v,position:f,zoom:y}))).projectedCenter=r.project(r.center),r}return l()(n,[{key:"unproject",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},n=e.topLeft,r=void 0===n||n,i=B()(t,3),o=i[0],a=i[1],s=i[2],u=void 0===s?this.projectedCenter[2]:s,c=r?a:this.height-a,l=Object(At.n)([o,c,u],this.pixelUnprojectionMatrix),h=B()(l,3),f=h[0],p=h[1],d=h[2];return[f,p,d]}},{key:"panByPosition",value:function(t,e){var n=this.project(t),r=[this.width/2+n[0]-e[0],this.height/2+n[1]-e[1],this.projectedCenter[2]];return{target:this.unproject(r)}}}]),n}(ht.a),xt=n(159);function wt(t,e,n){return e in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t}var Et=n(84),Ot=n(13),St=n(25);class Tt{constructor({phi:t=0,theta:e=0,radius:n=1,bearing:r,pitch:i,altitude:o,radiusScale:a=6371e3}={}){wt(this,"phi",void 0),wt(this,"theta",void 0),wt(this,"radius",void 0),wt(this,"radiusScale",void 0),this.phi=t,this.theta=e,this.radius=n||o||1,this.radiusScale=a||1,void 0!==r&&(this.bearing=r),void 0!==i&&(this.pitch=i),this.check()}toString(){return this.formatString(Ot.b)}formatString({printTypes:t=!1}){const e=Ot.e;return"".concat(t?"Spherical":"","[rho:").concat(e(this.radius),",theta:").concat(e(this.theta),",phi:").concat(e(this.phi),"]")}equals(t){return Object(Ot.d)(this.radius,t.radius)&&Object(Ot.d)(this.theta,t.theta)&&Object(Ot.d)(this.phi,t.phi)}exactEquals(t){return this.radius===t.radius&&this.theta===t.theta&&this.phi===t.phi}get bearing(){return 180-Object(Ot.c)(this.phi)}set bearing(t){this.phi=Math.PI-Object(Ot.h)(t)}get pitch(){return Object(Ot.c)(this.theta)}set pitch(t){this.theta=Object(Ot.h)(t)}get longitude(){return Object(Ot.c)(this.phi)}get latitude(){return Object(Ot.c)(this.theta)}get lng(){return Object(Ot.c)(this.phi)}get lat(){return Object(Ot.c)(this.theta)}get z(){return(this.radius-1)*this.radiusScale}set(t,e,n){return this.radius=t,this.phi=e,this.theta=n,this.check()}clone(){return(new Tt).copy(this)}copy(t){return this.radius=t.radius,this.phi=t.phi,this.theta=t.theta,this.check()}fromLngLatZ([t,e,n]){return this.radius=1+n/this.radiusScale,this.phi=Object(Ot.h)(e),this.theta=Object(Ot.h)(t),this.check()}fromVector3(t){return this.radius=St.h(t),this.radius>0&&(this.theta=Math.atan2(t[0],t[1]),this.phi=Math.acos(Object(Ot.a)(t[2]/this.radius,-1,1))),this.check()}toVector3(){return new Et.a(0,0,this.radius).rotateX({radians:this.theta}).rotateZ({radians:this.phi})}makeSafe(){return this.phi=Math.max(1e-6,Math.min(Math.PI-1e-6,this.phi)),this}check(){if(!(Number.isFinite(this.phi)&&Number.isFinite(this.theta)&&this.radius>0))throw new Error("SphericalCoordinates: some fields set to invalid numbers");return this}}function Ct(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function Pt(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Ct(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Ct(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function Mt(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=T()(t);if(e){var i=T()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return O()(this,n)}}var It=function(t){w()(n,t);var e=Mt(n);function n(t){var r;u()(this,n);var i=t.longitude,o=t.latitude,a=t.modelMatrix,s=t.bearing,c=void 0===s?0:s,l=t.pitch,h=void 0===l?0:l,f=t.up,p=void 0===f?[0,0,1]:f,d=new Tt({bearing:c,pitch:-90===h?1e-4:90+h}).toVector3().normalize(),A=a?new dt.a(a).transformAsVector(d):d,g=Number.isFinite(o)?Object(At.i)({latitude:o}):0,m=Math.pow(2,g),y=(new dt.a).lookAt({eye:[0,0,0],center:A,up:p}).scale(m);return(r=e.call(this,Pt(Pt({},t),{},{zoom:g,viewMatrix:y}))).latitude=o,r.longitude=i,r}return n}(ht.a),Bt=n(234),Rt=n(104),kt=n(217),Dt=n(235),Lt=n(123),jt=n(59),Ft=n(153),zt=n(27),Ut=n.n(zt),Nt=n(58),Gt=n(125),Vt=n(35),Ht=n(50);function Wt(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function qt(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Wt(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Wt(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function Xt(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=T()(t);if(e){var i=T()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return O()(this,n)}}var Zt=function(t){w()(n,t);var e=Xt(n);function n(t){u()(this,n);var r=t.width,i=t.height,o=t.position,a=void 0===o?[0,0,0]:o,s=t.bearing,c=void 0===s?0:s,l=t.pitch,h=void 0===l?0:l,f=t.longitude,p=void 0===f?null:f,d=t.latitude,A=void 0===d?null:d,g=t.maxPitch,m=void 0===g?90:g,y=t.minPitch,v=void 0===y?-90:y,_=t.startRotatePos,b=t.startBearing,x=t.startPitch,w=t.startZoomPosition;return e.call(this,{width:r,height:i,position:a,bearing:c,pitch:h,longitude:p,latitude:A,maxPitch:m,minPitch:v},{startRotatePos:_,startBearing:b,startPitch:x,startZoomPosition:w})}return l()(n,[{key:"panStart",value:function(){return this}},{key:"pan",value:function(){return this}},{key:"panEnd",value:function(){return this}},{key:"rotateStart",value:function(t){var e=t.pos;return this._getUpdatedState({startRotatePos:e,startBearing:this.getViewportProps().bearing,startPitch:this.getViewportProps().pitch})}},{key:"rotate",value:function(t){var e,n=t.pos,r=t.deltaAngleX,i=void 0===r?0:r,o=t.deltaAngleY,a=void 0===o?0:o,s=this.getState(),u=s.startRotatePos,c=s.startBearing,l=s.startPitch,h=this.getViewportProps(),f=h.width,p=h.height;if(!u||void 0===c||void 0===l)return this;n?e={bearing:c-180*((n[0]-u[0])/f),pitch:l-90*((n[1]-u[1])/p)}:e={bearing:c-i,pitch:l-a};return this._getUpdatedState(e)}},{key:"rotateEnd",value:function(){return this._getUpdatedState({startRotatePos:null,startBearing:null,startPitch:null})}},{key:"zoomStart",value:function(){return this._getUpdatedState({startZoomPosition:this.getViewportProps().position})}},{key:"zoom",value:function(t){var e=t.scale,n=this.getState().startZoomPosition;n||(n=this.getViewportProps().position);var r=this.getDirection();return this._move(r,20*Math.log2(e),n)}},{key:"zoomEnd",value:function(){return this._getUpdatedState({startZoomPosition:null})}},{key:"moveLeft",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:20,e=this.getDirection(!0);return this._move(e.rotateZ({radians:Math.PI/2}),t)}},{key:"moveRight",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:20,e=this.getDirection(!0);return this._move(e.rotateZ({radians:-Math.PI/2}),t)}},{key:"moveUp",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:20,e=this.getDirection(!0);return this._move(e,t)}},{key:"moveDown",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:20,e=this.getDirection(!0);return this._move(e.negate(),t)}},{key:"rotateLeft",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:15;return this._getUpdatedState({bearing:this.getViewportProps().bearing-t})}},{key:"rotateRight",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:15;return this._getUpdatedState({bearing:this.getViewportProps().bearing+t})}},{key:"rotateUp",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:10;return this._getUpdatedState({pitch:this.getViewportProps().pitch+t})}},{key:"rotateDown",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:10;return this._getUpdatedState({pitch:this.getViewportProps().pitch-t})}},{key:"zoomIn",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:2;return this.zoom({scale:t})}},{key:"zoomOut",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:2;return this.zoom({scale:1/t})}},{key:"shortestPathFrom",value:function(t){var e=t.getViewportProps(),n=qt({},this.getViewportProps()),r=n.bearing,i=n.longitude;return Math.abs(r-e.bearing)>180&&(n.bearing=r<0?r+360:r-360),null!==i&&null!==e.longitude&&Math.abs(i-e.longitude)>180&&(n.longitude=i<0?i+360:i-360),n}},{key:"_move",value:function(t,e){var n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:this.getViewportProps().position,r=t.scale(e);return this._getUpdatedState({position:new Et.a(n).add(r)})}},{key:"getDirection",value:function(){var t=arguments.length>0&&void 0!==arguments[0]&&arguments[0],e=new Tt({bearing:this.getViewportProps().bearing,pitch:t?90:90+this.getViewportProps().pitch}),n=e.toVector3().normalize();return n}},{key:"_getUpdatedState",value:function(t){return new n(qt(qt(qt({},this.getViewportProps()),this.getState()),t))}},{key:"applyConstraints",value:function(t){var e=t.pitch,n=t.maxPitch,r=t.minPitch,i=t.longitude,o=t.bearing;return t.pitch=Object(Ot.a)(e,r,n),null!==i&&(i<-180||i>180)&&(t.longitude=Object(Vt.e)(i+180,360)-180),(o<-180||o>180)&&(t.bearing=Object(Vt.e)(o+180,360)-180),t}}]),n}(Gt.a),Jt=function(t){w()(n,t);var e=Xt(n);function n(){var t;u()(this,n);for(var r=arguments.length,i=new Array(r),o=0;o<r;o++)i[o]=arguments[o];return t=e.call.apply(e,[this].concat(i)),f()(Ut()(t),"ControllerState",Zt),f()(Ut()(t),"transition",{transitionDuration:300,transitionInterpolator:new Ht.a(["position","pitch","bearing"])}),t}return n}(Nt.a);function Qt(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=T()(t);if(e){var i=T()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return O()(this,n)}}var Kt=function(t){w()(n,t);var e=Qt(n);function n(){return u()(this,n),e.apply(this,arguments)}return l()(n,[{key:"ViewportType",get:function(){return It}},{key:"ControllerType",get:function(){return Jt}}]),n}(jt.a);f()(Kt,"displayName","FirstPersonView");var Yt=n(115);function $t(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=T()(t);if(e){var i=T()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return O()(this,n)}}var te=function(t){w()(n,t);var e=$t(n);function n(){var t,r=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return u()(this,n),(t=e.call(this,r)).props.orbitAxis=r.orbitAxis||"Z",t}return l()(n,[{key:"ViewportType",get:function(){return bt}},{key:"ControllerType",get:function(){return Yt.b}}]),n}(jt.a);f()(te,"displayName","OrbitView");var ee=n(158),ne=n(8),re=n.n(ne),ie=n(113);function oe(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=T()(t);if(e){var i=T()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return O()(this,n)}}var ae=function(t){w()(n,t);var e=oe(n);function n(){return u()(this,n),e.apply(this,arguments)}return l()(n,[{key:"applyConstraints",value:function(t){var e=t.maxZoom,n=t.minZoom,r=t.zoom;t.zoom=Object(Ot.a)(r,n,e);var i=t.longitude,o=t.latitude;return(i<-180||i>180)&&(t.longitude=Object(Vt.e)(i+180,360)-180),t.latitude=Object(Ot.a)(o,-89,89),t}}]),n}(ie.a),se=function(t){w()(n,t);var e=oe(n);function n(){var t;u()(this,n);for(var r=arguments.length,i=new Array(r),o=0;o<r;o++)i[o]=arguments[o];return t=e.call.apply(e,[this].concat(i)),f()(Ut()(t),"ControllerState",ae),f()(Ut()(t),"transition",{transitionDuration:300,transitionInterpolator:new Ht.a(["longitude","latitude","zoom"])}),f()(Ut()(t),"dragMode","pan"),t}return l()(n,[{key:"setProps",value:function(t){re()(T()(n.prototype),"setProps",this).call(this,t),this.dragRotate=!1,this.touchRotate=!1}}]),n}(Nt.a);function ue(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=T()(t);if(e){var i=T()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return O()(this,n)}}var ce=function(t){w()(n,t);var e=ue(n);function n(){return u()(this,n),e.apply(this,arguments)}return l()(n,[{key:"ViewportType",get:function(){return pt.a}},{key:"ControllerType",get:function(){return se}}]),n}(jt.a);f()(ce,"displayName","GlobeView");var le=n(160),he=n(218),fe=n(154),pe=n(114);function de(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return Ae(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return Ae(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function Ae(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function ge(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function me(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?ge(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):ge(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function ye(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=T()(t);if(e){var i=T()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return O()(this,n)}}var ve=["bearing","pitch"],_e={speed:1.2,curve:1.414},be=function(t){w()(n,t);var e=ye(n);function n(){var t,r=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return u()(this,n),(t=e.call(this,{compare:["longitude","latitude","zoom","bearing","pitch"],extract:["width","height","longitude","latitude","zoom","bearing","pitch"],required:["width","height","latitude","longitude","zoom"]})).opts=me(me({},_e),r),t}return l()(n,[{key:"interpolateProps",value:function(t,e,n){var r,i=Object(At.d)(t,e,n,this.opts),o=de(ve);try{for(o.s();!(r=o.n()).done;){var a=r.value;i[a]=Object(Ot.g)(t[a]||0,e[a]||0,n)}}catch(t){o.e(t)}finally{o.f()}return i}},{key:"getDuration",value:function(t,e){var n=e.transitionDuration;return"auto"===n&&(n=Object(At.h)(t,e,this.opts)),n}}]),n}(pe.a),xe=n(21),we=n(29),Ee=n(52),Oe=n(219),Se=n(67),Te=n(161),Ce=n(80),Pe=n(162),Me=n(138);n.d(e,"COORDINATE_SYSTEM",(function(){return r.a})),n.d(e,"OPERATION",(function(){return r.c})),n.d(e,"UNIT",(function(){return r.e})),n.d(e,"LightingEffect",(function(){return i.a})),n.d(e,"AmbientLight",(function(){return o.a})),n.d(e,"DirectionalLight",(function(){return a.a})),n.d(e,"PointLight",(function(){return _})),n.d(e,"_CameraLight",(function(){return M})),n.d(e,"_SunLight",(function(){return G})),n.d(e,"PostProcessEffect",(function(){return tt})),n.d(e,"_LayersPass",(function(){return it.a})),n.d(e,"Deck",(function(){return ot.a})),n.d(e,"LayerManager",(function(){return at.a})),n.d(e,"AttributeManager",(function(){return st.a})),n.d(e,"Layer",(function(){return ut.a})),n.d(e,"CompositeLayer",(function(){return ct.a})),n.d(e,"DeckRenderer",(function(){return lt.a})),n.d(e,"Viewport",(function(){return ht.a})),n.d(e,"WebMercatorViewport",(function(){return ft.a})),n.d(e,"_GlobeViewport",(function(){return pt.a})),n.d(e,"OrbitViewport",(function(){return bt})),n.d(e,"OrthographicViewport",(function(){return xt.a})),n.d(e,"FirstPersonViewport",(function(){return It})),n.d(e,"picking",(function(){return Bt.a})),n.d(e,"project",(function(){return Rt.a})),n.d(e,"project32",(function(){return kt.a})),n.d(e,"gouraudLighting",(function(){return Dt.a})),n.d(e,"phongLighting",(function(){return Dt.b})),n.d(e,"shadow",(function(){return Lt.a})),n.d(e,"View",(function(){return jt.a})),n.d(e,"MapView",(function(){return Ft.a})),n.d(e,"FirstPersonView",(function(){return Kt})),n.d(e,"OrbitView",(function(){return te})),n.d(e,"OrthographicView",(function(){return ee.a})),n.d(e,"_GlobeView",(function(){return ce})),n.d(e,"Controller",(function(){return Nt.a})),n.d(e,"MapController",(function(){return ie.b})),n.d(e,"_GlobeController",(function(){return se})),n.d(e,"FirstPersonController",(function(){return Jt})),n.d(e,"OrbitController",(function(){return Yt.b})),n.d(e,"OrthographicController",(function(){return le.a})),n.d(e,"LayerExtension",(function(){return he.a})),n.d(e,"TRANSITION_EVENTS",(function(){return fe.a})),n.d(e,"TransitionInterpolator",(function(){return pe.a})),n.d(e,"LinearInterpolator",(function(){return Ht.a})),n.d(e,"FlyToInterpolator",(function(){return be})),n.d(e,"log",(function(){return xe.a})),n.d(e,"assert",(function(){return we.a})),n.d(e,"createIterable",(function(){return Ee.a})),n.d(e,"fp64LowPart",(function(){return Vt.b})),n.d(e,"Tesselator",(function(){return Oe.a})),n.d(e,"_fillArray",(function(){return Se.a})),n.d(e,"_flatten",(function(){return Se.b})),n.d(e,"_count",(function(){return Te.a})),n.d(e,"_memoize",(function(){return Ce.a})),n.d(e,"_mergeShaders",(function(){return Pe.a})),n.d(e,"_compareProps",(function(){return Me.a}))},function(t,e,n){"use strict";function r(t){return(r="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t})(t)}function i(t){var e=function(t,e){if("object"!==r(t)||null===t)return t;var n=t[Symbol.toPrimitive];if(void 0!==n){var i=n.call(t,e||"default");if("object"!==r(i))return i;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===e?String:Number)(t)}(t,"string");return"symbol"===r(e)?e:String(e)}function o(t,e,n){return(e=i(e))in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t}n.d(e,"a",(function(){return o}))},,function(t,e,n){"use strict";var r=n(36);function i(t,e){const n=Object(r.n)([],e,t);return Object(r.k)(n,n,1/n[3]),n}function o(t,e){const n=t%e;return n<0?e+n:n}function a(t,e,n){return t<e?e:t>n?n:t}const s=Math.log2||function(t){return Math.log(t)*Math.LOG2E};var u=n(26),c=n(34),l=n(25);function h(t,e){if(!t)throw new Error(e||"@math.gl/web-mercator: assertion failed.")}const f=Math.PI,p=f/4,d=f/180,A=180/f,g=1.5;function m(t){return Math.pow(2,t)}function y(t){return s(t)}function v(t){const[e,n]=t;h(Number.isFinite(e)),h(Number.isFinite(n)&&n>=-90&&n<=90,"invalid latitude");const r=n*d;return[512*(e*d+f)/(2*f),512*(f+Math.log(Math.tan(p+.5*r)))/(2*f)]}function _(t){const[e,n]=t,r=e/512*(2*f)-f,i=2*(Math.atan(Math.exp(n/512*(2*f)-f))-p);return[r*A,i*A]}function b(t){const{latitude:e}=t;h(Number.isFinite(e));return y(4003e4*Math.cos(e*d))-9}function x(t){return 512/4003e4/Math.cos(t*d)}function w(t){const{latitude:e,longitude:n,highPrecision:r=!1}=t;h(Number.isFinite(e)&&Number.isFinite(n));const i=Math.cos(e*d),o=512/360/i,a=512/4003e4/i,s={unitsPerMeter:[a,a,a],metersPerUnit:[1/a,1/a,1/a],unitsPerDegree:[512/360,o,a],degreesPerUnit:[.703125,1/o,1/a]};if(r){const t=d*Math.tan(e*d)/i,n=512/360*t/2,r=512/4003e4*t,u=r/o*a;s.unitsPerDegree2=[0,n,r],s.unitsPerMeter2=[u,0,u]}return s}function E(t,e){const[n,r,i]=t,[o,a,s]=e,{unitsPerMeter:u,unitsPerMeter2:c}=w({longitude:n,latitude:r,highPrecision:!0}),l=v(t);l[0]+=o*(u[0]+c[0]*a),l[1]+=a*(u[1]+c[1]*a);const h=_(l),f=(i||0)+(s||0);return Number.isFinite(i)||Number.isFinite(s)?[h[0],h[1],f]:h}function O(t){const{height:e,pitch:n,bearing:r,altitude:i,scale:o,center:a}=t,s=[1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,1];u.p(s,s,[0,0,-i]),u.l(s,s,-n*d),u.n(s,s,r*d);const c=o/e;return u.o(s,s,[c,c,c]),a&&u.p(s,s,l.j([],a)),s}function S(t){const{width:e,height:n,altitude:r,pitch:i=0,offset:o,center:s,scale:u,nearZMultiplier:c=1,farZMultiplier:l=1}=t;let{fovy:h=T(g)}=t;void 0!==r&&(h=T(r));const f=h*d,p=i*d,A=C(h);let m=A;s&&(m+=s[2]*u/Math.cos(p)/n);const y=f*(.5+(o?o[1]:0)/n),v=Math.sin(y)*m/Math.sin(a(Math.PI/2-p-y,.01,Math.PI-.01)),_=Math.sin(p)*v+m,b=10*m;return{fov:f,aspect:e/n,focalDistance:A,near:c,far:Math.min(_*l,b)}}function T(t){return 2*Math.atan(.5/t)*A}function C(t){return.5/Math.tan(.5*t*d)}function P(t,e){const[n,r,o=0]=t;return h(Number.isFinite(n)&&Number.isFinite(r)&&Number.isFinite(o)),i(e,[n,r,o,1])}function M(t,e,n=0){const[r,o,a]=t;if(h(Number.isFinite(r)&&Number.isFinite(o),"invalid pixel coordinate"),Number.isFinite(a)){return i(e,[r,o,a,1])}const s=i(e,[r,o,0,1]),u=i(e,[r,o,1,1]),l=s[2],f=u[2],p=l===f?0:((n||0)-l)/(f-l);return c.c([],s,u,p)}function I(t){const{width:e,height:n,bounds:r,minExtent:i=0,maxZoom:o=24,offset:u=[0,0]}=t,[[c,l],[f,p]]=r,d=function(t=0){if("number"==typeof t)return{top:t,bottom:t,left:t,right:t};return h(Number.isFinite(t.top)&&Number.isFinite(t.bottom)&&Number.isFinite(t.left)&&Number.isFinite(t.right)),t}(t.padding),A=v([c,a(p,-85.051129,85.051129)]),g=v([f,a(l,-85.051129,85.051129)]),m=[Math.max(Math.abs(g[0]-A[0]),i),Math.max(Math.abs(g[1]-A[1]),i)],y=[e-d.left-d.right-2*Math.abs(u[0]),n-d.top-d.bottom-2*Math.abs(u[1])];h(y[0]>0&&y[1]>0);const b=y[0]/m[0],x=y[1]/m[1],w=(d.right-d.left)/2/b,E=(d.bottom-d.top)/2/x,O=_([(g[0]+A[0])/2+w,(g[1]+A[1])/2+E]),S=Math.min(o,s(Math.abs(Math.min(b,x))));return h(Number.isFinite(S)),{longitude:O[0],latitude:O[1],zoom:S}}const B=Math.PI/180;function R(t,e=0){const{width:n,height:r,unproject:i}=t,o={targetZ:e},a=i([0,r],o),s=i([n,r],o);let u,c;return(t.fovy?.5*t.fovy*B:Math.atan(.5/t.altitude))>(90-t.pitch)*B-.01?(u=k(t,0,e),c=k(t,n,e)):(u=i([0,0],o),c=i([n,0],o)),[a,s,c,u]}function k(t,e,n){const{pixelUnprojectionMatrix:r}=t,o=i(r,[e,0,1,1]),a=i(r,[e,t.height,1,1]),s=(n*t.distanceScales.unitsPerMeter[2]-o[2])/(a[2]-o[2]),u=_(c.c([],o,a,s));return u.push(n),u}function D(t){const{width:e,height:n,pitch:r=0}=t;let{longitude:i,latitude:a,zoom:u,bearing:c=0}=t;(i<-180||i>180)&&(i=o(i+180,360)-180),(c<-180||c>180)&&(c=o(c+180,360)-180);const l=s(n/512);if(u<=l)u=l,a=0;else{const t=n/2/Math.pow(2,u),e=_([0,t])[1];if(a<e)a=e;else{const e=_([0,512-t])[1];a>e&&(a=e)}}return{width:e,height:n,longitude:i,latitude:a,zoom:u,pitch:r,bearing:c}}const L=["longitude","latitude","zoom"],j={curve:1.414,speed:1.2};function F(t,e,n,r){const{startZoom:i,startCenterXY:o,uDelta:a,w0:s,u1:u,S:l,rho:h,rho2:f,r0:p}=U(t,e,r);if(u<.01){const r={};for(const i of L){const o=t[i],a=e[i];r[i]=(d=n)*a+(1-d)*o}return r}var d;const A=n*l,g=Math.cosh(p)/Math.cosh(p+h*A),m=s*((Math.cosh(p)*Math.tanh(p+h*A)-Math.sinh(p))/f)/u,v=i+y(1/g),b=c.e([],a,m);c.a(b,b,o);const x=_(b);return{longitude:x[0],latitude:x[1],zoom:v}}function z(t,e,n){const r={...j,...n},{screenSpeed:i,speed:o,maxDuration:a}=r,{S:s,rho:u}=U(t,e,r),c=1e3*s;let l;return l=Number.isFinite(i)?c/(i/u):c/o,Number.isFinite(a)&&l>a?0:l}function U(t,e,n){const r=(n=Object.assign({},j,n)).curve,i=t.zoom,o=[t.longitude,t.latitude],a=m(i),s=e.zoom,u=[e.longitude,e.latitude],l=m(s-i),h=v(o),f=v(u),p=c.f([],f,h),d=Math.max(t.width,t.height),A=d/l,g=c.b(p)*a,y=Math.max(g,.01),_=r*r,b=(A*A-d*d+_*_*y*y)/(2*d*_*y),x=(A*A-d*d-_*_*y*y)/(2*A*_*y),w=Math.log(Math.sqrt(b*b+1)-b),E=Math.log(Math.sqrt(x*x+1)-x);return{startZoom:i,startCenterXY:h,uDelta:p,w0:d,u1:g,S:(E-w)/r,rho:r,rho2:_,r0:w,r1:E}}n.d(e,"f",(function(){return R})),n.d(e,"c",(function(){return I})),n.d(e,"m",(function(){return D})),n.d(e,"d",(function(){return F})),n.d(e,"h",(function(){return z})),n.d(e,"l",(function(){return v})),n.d(e,"p",(function(){return _})),n.d(e,"q",(function(){return P})),n.d(e,"n",(function(){return M})),n.d(e,"b",(function(){return T})),n.d(e,"e",(function(){return C})),n.d(e,"i",(function(){return b})),n.d(e,"o",(function(){return x})),n.d(e,"g",(function(){return w})),n.d(e,"a",(function(){return E})),n.d(e,"k",(function(){return O})),n.d(e,"j",(function(){return S}))},function(t,e,n){"use strict";var r={};function i(t){const e=t&&t.lastIndexOf("/");return e>=0?t.substr(e+1):""}function o(t){const e=t&&t.lastIndexOf("/");return e>=0?t.substr(0,e):""}function a(...t){return(t=t.map((e,n)=>(n&&(e=e.replace(new RegExp("^".concat("/")),"")),n!==t.length-1&&(e=e.replace(new RegExp("".concat("/","$")),"")),e))).join("/")}n.r(r),n.d(r,"filename",(function(){return i})),n.d(r,"dirname",(function(){return o})),n.d(r,"join",(function(){return a}));n(149);var s=n(216);n.d(e,"b",(function(){return r})),n.d(e,"a",(function(){return s}))},function(t,e,n){"use strict";var r=n(298);e.a=new r.a({id:"deck"})},function(t,e,n){"use strict";n.d(e,"f",(function(){return o})),n.d(e,"h",(function(){return a})),n.d(e,"g",(function(){return s})),n.d(e,"d",(function(){return u})),n.d(e,"a",(function(){return c})),n.d(e,"e",(function(){return l})),n.d(e,"j",(function(){return h})),n.d(e,"b",(function(){return f})),n.d(e,"c",(function(){return p})),n.d(e,"i",(function(){return d})),n.d(e,"k",(function(){return A}));const r=t=>"boolean"==typeof t,i=t=>"function"==typeof t,o=t=>null!==t&&"object"==typeof t,a=t=>o(t)&&t.constructor==={}.constructor,s=t=>o(t)&&i(t.then),u=t=>t&&"function"==typeof t[Symbol.iterator],c=t=>t&&"function"==typeof t[Symbol.asyncIterator],l=t=>t&&i(t.next),h=t=>"undefined"!=typeof Response&&t instanceof Response||t&&t.arrayBuffer&&t.text&&t.json,f=t=>"undefined"!=typeof Blob&&t instanceof Blob,p=t=>t&&"object"==typeof t&&t.isBuffer,d=t=>(t=>"undefined"!=typeof ReadableStream&&t instanceof ReadableStream||o(t)&&i(t.tee)&&i(t.cancel)&&i(t.getReader))(t)||(t=>o(t)&&i(t.read)&&i(t.pipe)&&r(t.readable))(t),A=t=>(t=>o(t)&&i(t.abort)&&i(t.getWriter))(t)||(t=>o(t)&&i(t.end)&&i(t.write)&&r(t.writable))(t)},function(t,e,n){"use strict";n.d(e,"a",(function(){return i})),n.d(e,"b",(function(){return o}));var r=n(13);function i(t){if(!Number.isFinite(t))throw new Error("Invalid number ".concat(t));return t}function o(t,e,n=""){if(r.b.debug&&!function(t,e){if(t.length!==e)return!1;for(let e=0;e<t.length;++e)if(!Number.isFinite(t[e]))return!1;return!0}(t,e))throw new Error("math.gl: ".concat(n," some fields set to invalid numbers'"));return t}},function(t,e,n){"use strict";n.d(e,"e",(function(){return r})),n.d(e,"d",(function(){return i})),n.d(e,"a",(function(){return o})),n.d(e,"b",(function(){return a})),n.d(e,"c",(function(){return s}));var r={NO_STATE:"Awaiting state",MATCHED:"Matched. State transferred from previous layer",INITIALIZED:"Initialized",AWAITING_GC:"Discarded. Awaiting garbage collection",AWAITING_FINALIZATION:"No longer matched. Awaiting garbage collection",FINALIZED:"Finalized! Awaiting garbage collection"},i=Symbol.for("component"),o=Symbol.for("asyncPropDefaults"),a=Symbol.for("asyncPropOriginal"),s=Symbol.for("asyncPropResolved")},function(t,e,n){"use strict";n.d(e,"c",(function(){return i})),n.d(e,"h",(function(){return o})),n.d(e,"f",(function(){return a})),n.d(e,"a",(function(){return s})),n.d(e,"j",(function(){return u})),n.d(e,"k",(function(){return c})),n.d(e,"e",(function(){return l})),n.d(e,"d",(function(){return h})),n.d(e,"p",(function(){return f})),n.d(e,"o",(function(){return p})),n.d(e,"q",(function(){return d})),n.d(e,"l",(function(){return A})),n.d(e,"m",(function(){return g})),n.d(e,"n",(function(){return m})),n.d(e,"b",(function(){return y})),n.d(e,"i",(function(){return _})),n.d(e,"g",(function(){return b}));var r=n(11);function i(){var t=new r.a(3);return r.a!=Float32Array&&(t[0]=0,t[1]=0,t[2]=0),t}function o(t){var e=t[0],n=t[1],r=t[2];return Math.hypot(e,n,r)}function a(t,e,n){var i=new r.a(3);return i[0]=t,i[1]=e,i[2]=n,i}function s(t,e,n){return t[0]=e[0]+n[0],t[1]=e[1]+n[1],t[2]=e[2]+n[2],t}function u(t,e){return t[0]=-e[0],t[1]=-e[1],t[2]=-e[2],t}function c(t,e){var n=e[0],r=e[1],i=e[2],o=n*n+r*r+i*i;return o>0&&(o=1/Math.sqrt(o)),t[0]=e[0]*o,t[1]=e[1]*o,t[2]=e[2]*o,t}function l(t,e){return t[0]*e[0]+t[1]*e[1]+t[2]*e[2]}function h(t,e,n){var r=e[0],i=e[1],o=e[2],a=n[0],s=n[1],u=n[2];return t[0]=i*u-o*s,t[1]=o*a-r*u,t[2]=r*s-i*a,t}function f(t,e,n){var r=e[0],i=e[1],o=e[2],a=n[3]*r+n[7]*i+n[11]*o+n[15];return a=a||1,t[0]=(n[0]*r+n[4]*i+n[8]*o+n[12])/a,t[1]=(n[1]*r+n[5]*i+n[9]*o+n[13])/a,t[2]=(n[2]*r+n[6]*i+n[10]*o+n[14])/a,t}function p(t,e,n){var r=e[0],i=e[1],o=e[2];return t[0]=r*n[0]+i*n[3]+o*n[6],t[1]=r*n[1]+i*n[4]+o*n[7],t[2]=r*n[2]+i*n[5]+o*n[8],t}function d(t,e,n){var r=n[0],i=n[1],o=n[2],a=n[3],s=e[0],u=e[1],c=e[2],l=i*c-o*u,h=o*s-r*c,f=r*u-i*s,p=i*f-o*h,d=o*l-r*f,A=r*h-i*l,g=2*a;return l*=g,h*=g,f*=g,p*=2,d*=2,A*=2,t[0]=s+l+p,t[1]=u+h+d,t[2]=c+f+A,t}function A(t,e,n,r){var i=[],o=[];return i[0]=e[0]-n[0],i[1]=e[1]-n[1],i[2]=e[2]-n[2],o[0]=i[0],o[1]=i[1]*Math.cos(r)-i[2]*Math.sin(r),o[2]=i[1]*Math.sin(r)+i[2]*Math.cos(r),t[0]=o[0]+n[0],t[1]=o[1]+n[1],t[2]=o[2]+n[2],t}function g(t,e,n,r){var i=[],o=[];return i[0]=e[0]-n[0],i[1]=e[1]-n[1],i[2]=e[2]-n[2],o[0]=i[2]*Math.sin(r)+i[0]*Math.cos(r),o[1]=i[1],o[2]=i[2]*Math.cos(r)-i[0]*Math.sin(r),t[0]=o[0]+n[0],t[1]=o[1]+n[1],t[2]=o[2]+n[2],t}function m(t,e,n,r){var i=[],o=[];return i[0]=e[0]-n[0],i[1]=e[1]-n[1],i[2]=e[2]-n[2],o[0]=i[0]*Math.cos(r)-i[1]*Math.sin(r),o[1]=i[0]*Math.sin(r)+i[1]*Math.cos(r),o[2]=i[2],t[0]=o[0]+n[0],t[1]=o[1]+n[1],t[2]=o[2]+n[2],t}function y(t,e){var n=t[0],r=t[1],i=t[2],o=e[0],a=e[1],s=e[2],u=Math.sqrt(n*n+r*r+i*i)*Math.sqrt(o*o+a*a+s*s),c=u&&l(t,e)/u;return Math.acos(Math.min(Math.max(c,-1),1))}var v,_=function(t,e,n){return t[0]=e[0]*n[0],t[1]=e[1]*n[1],t[2]=e[2]*n[2],t},b=o;v=i()},function(t,e,n){"use strict";n.d(e,"q",(function(){return i})),n.d(e,"f",(function(){return o})),n.d(e,"a",(function(){return a})),n.d(e,"h",(function(){return s})),n.d(e,"p",(function(){return u})),n.d(e,"o",(function(){return c})),n.d(e,"k",(function(){return l})),n.d(e,"l",(function(){return h})),n.d(e,"m",(function(){return f})),n.d(e,"n",(function(){return p})),n.d(e,"e",(function(){return d})),n.d(e,"c",(function(){return A})),n.d(e,"d",(function(){return g})),n.d(e,"j",(function(){return m})),n.d(e,"i",(function(){return y})),n.d(e,"g",(function(){return v})),n.d(e,"b",(function(){return _}));var r=n(11);function i(t,e){if(t===e){var n=e[1],r=e[2],i=e[3],o=e[6],a=e[7],s=e[11];t[1]=e[4],t[2]=e[8],t[3]=e[12],t[4]=n,t[6]=e[9],t[7]=e[13],t[8]=r,t[9]=o,t[11]=e[14],t[12]=i,t[13]=a,t[14]=s}else t[0]=e[0],t[1]=e[4],t[2]=e[8],t[3]=e[12],t[4]=e[1],t[5]=e[5],t[6]=e[9],t[7]=e[13],t[8]=e[2],t[9]=e[6],t[10]=e[10],t[11]=e[14],t[12]=e[3],t[13]=e[7],t[14]=e[11],t[15]=e[15];return t}function o(t,e){var n=e[0],r=e[1],i=e[2],o=e[3],a=e[4],s=e[5],u=e[6],c=e[7],l=e[8],h=e[9],f=e[10],p=e[11],d=e[12],A=e[13],g=e[14],m=e[15],y=n*s-r*a,v=n*u-i*a,_=n*c-o*a,b=r*u-i*s,x=r*c-o*s,w=i*c-o*u,E=l*A-h*d,O=l*g-f*d,S=l*m-p*d,T=h*g-f*A,C=h*m-p*A,P=f*m-p*g,M=y*P-v*C+_*T+b*S-x*O+w*E;return M?(M=1/M,t[0]=(s*P-u*C+c*T)*M,t[1]=(i*C-r*P-o*T)*M,t[2]=(A*w-g*x+m*b)*M,t[3]=(f*x-h*w-p*b)*M,t[4]=(u*S-a*P-c*O)*M,t[5]=(n*P-i*S+o*O)*M,t[6]=(g*_-d*w-m*v)*M,t[7]=(l*w-f*_+p*v)*M,t[8]=(a*C-s*S+c*E)*M,t[9]=(r*S-n*C-o*E)*M,t[10]=(d*x-A*_+m*y)*M,t[11]=(h*_-l*x-p*y)*M,t[12]=(s*O-a*T-u*E)*M,t[13]=(n*T-r*O+i*E)*M,t[14]=(A*v-d*b-g*y)*M,t[15]=(l*b-h*v+f*y)*M,t):null}function a(t){var e=t[0],n=t[1],r=t[2],i=t[3],o=t[4],a=t[5],s=t[6],u=t[7],c=t[8],l=t[9],h=t[10],f=t[11],p=t[12],d=t[13],A=t[14],g=t[15];return(e*a-n*o)*(h*g-f*A)-(e*s-r*o)*(l*g-f*d)+(e*u-i*o)*(l*A-h*d)+(n*s-r*a)*(c*g-f*p)-(n*u-i*a)*(c*A-h*p)+(r*u-i*s)*(c*d-l*p)}function s(t,e,n){var r=e[0],i=e[1],o=e[2],a=e[3],s=e[4],u=e[5],c=e[6],l=e[7],h=e[8],f=e[9],p=e[10],d=e[11],A=e[12],g=e[13],m=e[14],y=e[15],v=n[0],_=n[1],b=n[2],x=n[3];return t[0]=v*r+_*s+b*h+x*A,t[1]=v*i+_*u+b*f+x*g,t[2]=v*o+_*c+b*p+x*m,t[3]=v*a+_*l+b*d+x*y,v=n[4],_=n[5],b=n[6],x=n[7],t[4]=v*r+_*s+b*h+x*A,t[5]=v*i+_*u+b*f+x*g,t[6]=v*o+_*c+b*p+x*m,t[7]=v*a+_*l+b*d+x*y,v=n[8],_=n[9],b=n[10],x=n[11],t[8]=v*r+_*s+b*h+x*A,t[9]=v*i+_*u+b*f+x*g,t[10]=v*o+_*c+b*p+x*m,t[11]=v*a+_*l+b*d+x*y,v=n[12],_=n[13],b=n[14],x=n[15],t[12]=v*r+_*s+b*h+x*A,t[13]=v*i+_*u+b*f+x*g,t[14]=v*o+_*c+b*p+x*m,t[15]=v*a+_*l+b*d+x*y,t}function u(t,e,n){var r,i,o,a,s,u,c,l,h,f,p,d,A=n[0],g=n[1],m=n[2];return e===t?(t[12]=e[0]*A+e[4]*g+e[8]*m+e[12],t[13]=e[1]*A+e[5]*g+e[9]*m+e[13],t[14]=e[2]*A+e[6]*g+e[10]*m+e[14],t[15]=e[3]*A+e[7]*g+e[11]*m+e[15]):(r=e[0],i=e[1],o=e[2],a=e[3],s=e[4],u=e[5],c=e[6],l=e[7],h=e[8],f=e[9],p=e[10],d=e[11],t[0]=r,t[1]=i,t[2]=o,t[3]=a,t[4]=s,t[5]=u,t[6]=c,t[7]=l,t[8]=h,t[9]=f,t[10]=p,t[11]=d,t[12]=r*A+s*g+h*m+e[12],t[13]=i*A+u*g+f*m+e[13],t[14]=o*A+c*g+p*m+e[14],t[15]=a*A+l*g+d*m+e[15]),t}function c(t,e,n){var r=n[0],i=n[1],o=n[2];return t[0]=e[0]*r,t[1]=e[1]*r,t[2]=e[2]*r,t[3]=e[3]*r,t[4]=e[4]*i,t[5]=e[5]*i,t[6]=e[6]*i,t[7]=e[7]*i,t[8]=e[8]*o,t[9]=e[9]*o,t[10]=e[10]*o,t[11]=e[11]*o,t[12]=e[12],t[13]=e[13],t[14]=e[14],t[15]=e[15],t}function l(t,e,n,i){var o,a,s,u,c,l,h,f,p,d,A,g,m,y,v,_,b,x,w,E,O,S,T,C,P=i[0],M=i[1],I=i[2],B=Math.hypot(P,M,I);return B<r.b?null:(P*=B=1/B,M*=B,I*=B,o=Math.sin(n),s=1-(a=Math.cos(n)),u=e[0],c=e[1],l=e[2],h=e[3],f=e[4],p=e[5],d=e[6],A=e[7],g=e[8],m=e[9],y=e[10],v=e[11],_=P*P*s+a,b=M*P*s+I*o,x=I*P*s-M*o,w=P*M*s-I*o,E=M*M*s+a,O=I*M*s+P*o,S=P*I*s+M*o,T=M*I*s-P*o,C=I*I*s+a,t[0]=u*_+f*b+g*x,t[1]=c*_+p*b+m*x,t[2]=l*_+d*b+y*x,t[3]=h*_+A*b+v*x,t[4]=u*w+f*E+g*O,t[5]=c*w+p*E+m*O,t[6]=l*w+d*E+y*O,t[7]=h*w+A*E+v*O,t[8]=u*S+f*T+g*C,t[9]=c*S+p*T+m*C,t[10]=l*S+d*T+y*C,t[11]=h*S+A*T+v*C,e!==t&&(t[12]=e[12],t[13]=e[13],t[14]=e[14],t[15]=e[15]),t)}function h(t,e,n){var r=Math.sin(n),i=Math.cos(n),o=e[4],a=e[5],s=e[6],u=e[7],c=e[8],l=e[9],h=e[10],f=e[11];return e!==t&&(t[0]=e[0],t[1]=e[1],t[2]=e[2],t[3]=e[3],t[12]=e[12],t[13]=e[13],t[14]=e[14],t[15]=e[15]),t[4]=o*i+c*r,t[5]=a*i+l*r,t[6]=s*i+h*r,t[7]=u*i+f*r,t[8]=c*i-o*r,t[9]=l*i-a*r,t[10]=h*i-s*r,t[11]=f*i-u*r,t}function f(t,e,n){var r=Math.sin(n),i=Math.cos(n),o=e[0],a=e[1],s=e[2],u=e[3],c=e[8],l=e[9],h=e[10],f=e[11];return e!==t&&(t[4]=e[4],t[5]=e[5],t[6]=e[6],t[7]=e[7],t[12]=e[12],t[13]=e[13],t[14]=e[14],t[15]=e[15]),t[0]=o*i-c*r,t[1]=a*i-l*r,t[2]=s*i-h*r,t[3]=u*i-f*r,t[8]=o*r+c*i,t[9]=a*r+l*i,t[10]=s*r+h*i,t[11]=u*r+f*i,t}function p(t,e,n){var r=Math.sin(n),i=Math.cos(n),o=e[0],a=e[1],s=e[2],u=e[3],c=e[4],l=e[5],h=e[6],f=e[7];return e!==t&&(t[8]=e[8],t[9]=e[9],t[10]=e[10],t[11]=e[11],t[12]=e[12],t[13]=e[13],t[14]=e[14],t[15]=e[15]),t[0]=o*i+c*r,t[1]=a*i+l*r,t[2]=s*i+h*r,t[3]=u*i+f*r,t[4]=c*i-o*r,t[5]=l*i-a*r,t[6]=h*i-s*r,t[7]=f*i-u*r,t}function d(t,e){var n=e[0],r=e[1],i=e[2],o=e[4],a=e[5],s=e[6],u=e[8],c=e[9],l=e[10];return t[0]=Math.hypot(n,r,i),t[1]=Math.hypot(o,a,s),t[2]=Math.hypot(u,c,l),t}function A(t,e){var n=e[0],r=e[1],i=e[2],o=e[3],a=n+n,s=r+r,u=i+i,c=n*a,l=r*a,h=r*s,f=i*a,p=i*s,d=i*u,A=o*a,g=o*s,m=o*u;return t[0]=1-h-d,t[1]=l+m,t[2]=f-g,t[3]=0,t[4]=l-m,t[5]=1-c-d,t[6]=p+A,t[7]=0,t[8]=f+g,t[9]=p-A,t[10]=1-c-h,t[11]=0,t[12]=0,t[13]=0,t[14]=0,t[15]=1,t}function g(t,e,n,r,i,o,a){var s=1/(n-e),u=1/(i-r),c=1/(o-a);return t[0]=2*o*s,t[1]=0,t[2]=0,t[3]=0,t[4]=0,t[5]=2*o*u,t[6]=0,t[7]=0,t[8]=(n+e)*s,t[9]=(i+r)*u,t[10]=(a+o)*c,t[11]=-1,t[12]=0,t[13]=0,t[14]=a*o*2*c,t[15]=0,t}var m=function(t,e,n,r,i){var o,a=1/Math.tan(e/2);return t[0]=a/n,t[1]=0,t[2]=0,t[3]=0,t[4]=0,t[5]=a,t[6]=0,t[7]=0,t[8]=0,t[9]=0,t[11]=-1,t[12]=0,t[13]=0,t[15]=0,null!=i&&i!==1/0?(o=1/(r-i),t[10]=(i+r)*o,t[14]=2*i*r*o):(t[10]=-1,t[14]=-2*r),t};var y=function(t,e,n,r,i,o,a){var s=1/(e-n),u=1/(r-i),c=1/(o-a);return t[0]=-2*s,t[1]=0,t[2]=0,t[3]=0,t[4]=0,t[5]=-2*u,t[6]=0,t[7]=0,t[8]=0,t[9]=0,t[10]=2*c,t[11]=0,t[12]=(e+n)*s,t[13]=(i+r)*u,t[14]=(a+o)*c,t[15]=1,t};function v(t,e,n,i){var o,a,s,u,c,l,h,f,p,d,A=e[0],g=e[1],m=e[2],y=i[0],v=i[1],_=i[2],b=n[0],x=n[1],w=n[2];return Math.abs(A-b)<r.b&&Math.abs(g-x)<r.b&&Math.abs(m-w)<r.b?function(t){return t[0]=1,t[1]=0,t[2]=0,t[3]=0,t[4]=0,t[5]=1,t[6]=0,t[7]=0,t[8]=0,t[9]=0,t[10]=1,t[11]=0,t[12]=0,t[13]=0,t[14]=0,t[15]=1,t}(t):(h=A-b,f=g-x,p=m-w,o=v*(p*=d=1/Math.hypot(h,f,p))-_*(f*=d),a=_*(h*=d)-y*p,s=y*f-v*h,(d=Math.hypot(o,a,s))?(o*=d=1/d,a*=d,s*=d):(o=0,a=0,s=0),u=f*s-p*a,c=p*o-h*s,l=h*a-f*o,(d=Math.hypot(u,c,l))?(u*=d=1/d,c*=d,l*=d):(u=0,c=0,l=0),t[0]=o,t[1]=u,t[2]=h,t[3]=0,t[4]=a,t[5]=c,t[6]=f,t[7]=0,t[8]=s,t[9]=l,t[10]=p,t[11]=0,t[12]=-(o*A+a*g+s*m),t[13]=-(u*A+c*g+l*m),t[14]=-(h*A+f*g+p*m),t[15]=1,t)}function _(t,e){var n=t[0],i=t[1],o=t[2],a=t[3],s=t[4],u=t[5],c=t[6],l=t[7],h=t[8],f=t[9],p=t[10],d=t[11],A=t[12],g=t[13],m=t[14],y=t[15],v=e[0],_=e[1],b=e[2],x=e[3],w=e[4],E=e[5],O=e[6],S=e[7],T=e[8],C=e[9],P=e[10],M=e[11],I=e[12],B=e[13],R=e[14],k=e[15];return Math.abs(n-v)<=r.b*Math.max(1,Math.abs(n),Math.abs(v))&&Math.abs(i-_)<=r.b*Math.max(1,Math.abs(i),Math.abs(_))&&Math.abs(o-b)<=r.b*Math.max(1,Math.abs(o),Math.abs(b))&&Math.abs(a-x)<=r.b*Math.max(1,Math.abs(a),Math.abs(x))&&Math.abs(s-w)<=r.b*Math.max(1,Math.abs(s),Math.abs(w))&&Math.abs(u-E)<=r.b*Math.max(1,Math.abs(u),Math.abs(E))&&Math.abs(c-O)<=r.b*Math.max(1,Math.abs(c),Math.abs(O))&&Math.abs(l-S)<=r.b*Math.max(1,Math.abs(l),Math.abs(S))&&Math.abs(h-T)<=r.b*Math.max(1,Math.abs(h),Math.abs(T))&&Math.abs(f-C)<=r.b*Math.max(1,Math.abs(f),Math.abs(C))&&Math.abs(p-P)<=r.b*Math.max(1,Math.abs(p),Math.abs(P))&&Math.abs(d-M)<=r.b*Math.max(1,Math.abs(d),Math.abs(M))&&Math.abs(A-I)<=r.b*Math.max(1,Math.abs(A),Math.abs(I))&&Math.abs(g-B)<=r.b*Math.max(1,Math.abs(g),Math.abs(B))&&Math.abs(m-R)<=r.b*Math.max(1,Math.abs(m),Math.abs(R))&&Math.abs(y-k)<=r.b*Math.max(1,Math.abs(y),Math.abs(k))}},function(t,e){t.exports=function(t){if(void 0===t)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return t}},function(t,e){function n(e){return"function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?t.exports=n=function(t){return typeof t}:t.exports=n=function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t},n(e)}t.exports=n},function(t,e,n){"use strict";function r(t,e){if(!t)throw new Error(e||"deck.gl: assertion failed.")}n.d(e,"a",(function(){return r}))},function(t,e,n){t.exports=n(279)()},,function(t,e,n){"use strict";n.d(e,"b",(function(){return o})),n.d(e,"a",(function(){return a}));var r=n(21),i={};function o(t){i=t}function a(t,e,n,o){r.a.level>0&&i[t]&&i[t].call(null,e,n,o)}},function(t,e,n){"use strict";n.d(e,"a",(function(){return f}));var r=n(38),i=n(63),o=n(53),a=n(7),s=n(10),u=n(143);const c={offset:"accessor.offset",stride:"accessor.stride",type:"accessor.type",size:"accessor.size",divisor:"accessor.divisor",normalized:"accessor.normalized",integer:"accessor.integer",instanced:"accessor.divisor",isInstanced:"accessor.divisor"},l={removedProps:{},replacedProps:{bytes:"byteLength"},deprecatedProps:c},h={removedProps:c};class f extends r.a{get[Symbol.toStringTag](){return"Buffer"}constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};super(t,e),this.stubRemovedMethods("Buffer","v6.0",["layout","setLayout","getIndexedParameter"]),this.target=e.target||(this.gl.webgl2?36662:34962),this.initialize(e),Object.seal(this)}getElementCount(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:this.accessor;return Math.round(this.byteLength/i.a.getBytesPerElement(t))}getVertexCount(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:this.accessor;return Math.round(this.byteLength/i.a.getBytesPerVertex(t))}initialize(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return ArrayBuffer.isView(t)&&(t={data:t}),Number.isFinite(t)&&(t={byteLength:t}),t=Object(u.a)("Buffer",t,l),this.usage=t.usage||35044,this.debugData=null,this.setAccessor(Object.assign({},t,t.accessor)),t.data?this._setData(t.data,t.offset,t.byteLength):this._setByteLength(t.byteLength||0),this}setProps(t){return"accessor"in(t=Object(u.a)("Buffer",t,h))&&this.setAccessor(t.accessor),this}setAccessor(t){return delete(t=Object.assign({},t)).buffer,this.accessor=new i.a(t),this}reallocate(t){return t>this.byteLength?(this._setByteLength(t),!0):(this.bytesUsed=t,!1)}setData(t){return this.initialize(t)}subData(t){ArrayBuffer.isView(t)&&(t={data:t});const{data:e,offset:n=0,srcOffset:r=0}=t,i=t.byteLength||t.length;Object(s.a)(e);const o=this.gl.webgl2?36663:this.target;return this.gl.bindBuffer(o,this.handle),0!==r||void 0!==i?(Object(a.a)(this.gl),this.gl.bufferSubData(this.target,n,e,r,i)):this.gl.bufferSubData(o,n,e),this.gl.bindBuffer(o,null),this.debugData=null,this._inferType(e),this}copyData(t){let{sourceBuffer:e,readOffset:n=0,writeOffset:r=0,size:i}=t;const{gl:o}=this;return Object(a.a)(o),o.bindBuffer(36662,e.handle),o.bindBuffer(36663,this.handle),o.copyBufferSubData(36662,36663,n,r,i),o.bindBuffer(36662,null),o.bindBuffer(36663,null),this.debugData=null,this}getData(){let{dstData:t=null,srcByteOffset:e=0,dstOffset:n=0,length:r=0}=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};Object(a.a)(this.gl);const i=Object(o.c)(this.accessor.type||5126,{clamped:!1}),u=this._getAvailableElementCount(e),c=n;let l,h;t?(h=t.length,l=h-c):(l=Math.min(u,r||u),h=c+l);const f=Math.min(u,l);return r=r||f,Object(s.a)(r<=f),t=t||new i(h),this.gl.bindBuffer(36662,this.handle),this.gl.getBufferSubData(36662,e,t,n,r),this.gl.bindBuffer(36662,null),t}bind(){let{target:t=this.target,index:e=this.accessor&&this.accessor.index,offset:n=0,size:r}=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return 35345===t||35982===t?void 0!==r?this.gl.bindBufferRange(t,e,this.handle,n,r):(Object(s.a)(0===n),this.gl.bindBufferBase(t,e,this.handle)):this.gl.bindBuffer(t,this.handle),this}unbind(){let{target:t=this.target,index:e=this.accessor&&this.accessor.index}=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return 35345===t||35982===t?this.gl.bindBufferBase(t,e,null):this.gl.bindBuffer(t,null),this}getDebugData(){return this.debugData?{data:this.debugData,changed:!1}:(this.debugData=this.getData({length:Math.min(10,this.byteLength)}),{data:this.debugData,changed:!0})}invalidateDebugData(){this.debugData=null}_setData(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:0,n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:t.byteLength+e;Object(s.a)(ArrayBuffer.isView(t)),this._trackDeallocatedMemory();const r=this._getTarget();this.gl.bindBuffer(r,this.handle),this.gl.bufferData(r,n,this.usage),this.gl.bufferSubData(r,e,t),this.gl.bindBuffer(r,null),this.debugData=t.slice(0,10),this.bytesUsed=n,this._trackAllocatedMemory(n);const a=Object(o.b)(t);return Object(s.a)(a),this.setAccessor(new i.a(this.accessor,{type:a})),this}_setByteLength(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:this.usage;Object(s.a)(t>=0),this._trackDeallocatedMemory();let n=t;0===t&&(n=new Float32Array(0));const r=this._getTarget();return this.gl.bindBuffer(r,this.handle),this.gl.bufferData(r,n,e),this.gl.bindBuffer(r,null),this.usage=e,this.debugData=null,this.bytesUsed=t,this._trackAllocatedMemory(t),this}_getTarget(){return this.gl.webgl2?36663:this.target}_getAvailableElementCount(t){const e=t/Object(o.c)(this.accessor.type||5126,{clamped:!1}).BYTES_PER_ELEMENT;return this.getElementCount()-e}_inferType(t){this.accessor.type||this.setAccessor(new i.a(this.accessor,{type:Object(o.b)(t)}))}_createHandle(){return this.gl.createBuffer()}_deleteHandle(){this.gl.deleteBuffer(this.handle),this._trackDeallocatedMemory()}_getParameter(t){this.gl.bindBuffer(this.target,this.handle);const e=this.gl.getBufferParameter(this.target,t);return this.gl.bindBuffer(this.target,null),e}get type(){return a.k.deprecated("Buffer.type","Buffer.accessor.type")(),this.accessor.type}get bytes(){return a.k.deprecated("Buffer.bytes","Buffer.byteLength")(),this.byteLength}setByteLength(t){return a.k.deprecated("setByteLength","reallocate")(),this.reallocate(t)}updateAccessor(t){return a.k.deprecated("updateAccessor(...)","setAccessor(new Accessor(buffer.accessor, ...)")(),this.accessor=new i.a(this.accessor,t),this}}},function(t,e,n){"use strict";n.d(e,"a",(function(){return i})),n.d(e,"e",(function(){return o})),n.d(e,"b",(function(){return a})),n.d(e,"d",(function(){return s})),n.d(e,"c",(function(){return u})),n.d(e,"g",(function(){return c})),n.d(e,"h",(function(){return l})),n.d(e,"i",(function(){return h})),n.d(e,"j",(function(){return f})),n.d(e,"f",(function(){return A}));var r=n(11);function i(t,e,n){return t[0]=e[0]+n[0],t[1]=e[1]+n[1],t}function o(t,e,n){return t[0]=e[0]*n,t[1]=e[1]*n,t}function a(t){var e=t[0],n=t[1];return Math.hypot(e,n)}function s(t,e){return t[0]=-e[0],t[1]=-e[1],t}function u(t,e,n,r){var i=e[0],o=e[1];return t[0]=i+r*(n[0]-i),t[1]=o+r*(n[1]-o),t}function c(t,e,n){var r=e[0],i=e[1];return t[0]=n[0]*r+n[2]*i,t[1]=n[1]*r+n[3]*i,t}function l(t,e,n){var r=e[0],i=e[1];return t[0]=n[0]*r+n[2]*i+n[4],t[1]=n[1]*r+n[3]*i+n[5],t}function h(t,e,n){var r=e[0],i=e[1];return t[0]=n[0]*r+n[3]*i+n[6],t[1]=n[1]*r+n[4]*i+n[7],t}function f(t,e,n){var r=e[0],i=e[1];return t[0]=n[0]*r+n[4]*i+n[12],t[1]=n[1]*r+n[5]*i+n[13],t}var p,d,A=function(t,e,n){return t[0]=e[0]-n[0],t[1]=e[1]-n[1],t};p=new r.a(2),r.a!=Float32Array&&(p[0]=0,p[1]=0),d=p},function(t,e,n){"use strict";n.d(e,"a",(function(){return o})),n.d(e,"e",(function(){return a})),n.d(e,"c",(function(){return s})),n.d(e,"d",(function(){return u})),n.d(e,"b",(function(){return f})),n.d(e,"f",(function(){return p}));var r=n(68),i=n(84);function o(){return[1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,1]}function a(t,e){var n=t%e;return n<0?e+n:n}function s(t){return[t[12],t[13],t[14]]}function u(t){return{left:h(t[3]+t[0],t[7]+t[4],t[11]+t[8],t[15]+t[12]),right:h(t[3]-t[0],t[7]-t[4],t[11]-t[8],t[15]-t[12]),bottom:h(t[3]+t[1],t[7]+t[5],t[11]+t[9],t[15]+t[13]),top:h(t[3]-t[1],t[7]-t[5],t[11]-t[9],t[15]-t[13]),near:h(t[3]+t[2],t[7]+t[6],t[11]+t[10],t[15]+t[14]),far:h(t[3]-t[2],t[7]-t[6],t[11]-t[10],t[15]-t[14])}}var c,l=new i.a;function h(t,e,n,r){l.set(t,e,n);var o=l.len();return{distance:r/o,normal:new i.a(-t/o,-e/o,-n/o)}}function f(t){return t-Math.fround(t)}function p(t,e){var n=e.size,i=void 0===n?1:n,o=e.startIndex,a=void 0===o?0:o,s=void 0!==e.endIndex?e.endIndex:t.length,u=(s-a)/i;c=r.a.allocate(c,u,{type:Float32Array,size:2*i});for(var l=a,h=0;l<s;){for(var p=0;p<i;p++){var d=t[l++];c[h+p]=d,c[h+p+i]=f(d)}h+=2*i}return c.subarray(0,u*i*2)}},function(t,e,n){"use strict";n.d(e,"b",(function(){return i})),n.d(e,"g",(function(){return o})),n.d(e,"c",(function(){return a})),n.d(e,"l",(function(){return s})),n.d(e,"a",(function(){return u})),n.d(e,"k",(function(){return c})),n.d(e,"h",(function(){return l})),n.d(e,"m",(function(){return h})),n.d(e,"j",(function(){return f})),n.d(e,"d",(function(){return p})),n.d(e,"i",(function(){return d})),n.d(e,"n",(function(){return A})),n.d(e,"o",(function(){return g})),n.d(e,"f",(function(){return m})),n.d(e,"e",(function(){return y}));var r=n(11);function i(t){var e=new r.a(4);return e[0]=t[0],e[1]=t[1],e[2]=t[2],e[3]=t[3],e}function o(t,e,n,i){var o=new r.a(4);return o[0]=t,o[1]=e,o[2]=n,o[3]=i,o}function a(t,e){return t[0]=e[0],t[1]=e[1],t[2]=e[2],t[3]=e[3],t}function s(t,e,n,r,i){return t[0]=e,t[1]=n,t[2]=r,t[3]=i,t}function u(t,e,n){return t[0]=e[0]+n[0],t[1]=e[1]+n[1],t[2]=e[2]+n[2],t[3]=e[3]+n[3],t}function c(t,e,n){return t[0]=e[0]*n,t[1]=e[1]*n,t[2]=e[2]*n,t[3]=e[3]*n,t}function l(t){var e=t[0],n=t[1],r=t[2],i=t[3];return Math.hypot(e,n,r,i)}function h(t){var e=t[0],n=t[1],r=t[2],i=t[3];return e*e+n*n+r*r+i*i}function f(t,e){var n=e[0],r=e[1],i=e[2],o=e[3],a=n*n+r*r+i*i+o*o;return a>0&&(a=1/Math.sqrt(a)),t[0]=n*a,t[1]=r*a,t[2]=i*a,t[3]=o*a,t}function p(t,e){return t[0]*e[0]+t[1]*e[1]+t[2]*e[2]+t[3]*e[3]}function d(t,e,n,r){var i=e[0],o=e[1],a=e[2],s=e[3];return t[0]=i+r*(n[0]-i),t[1]=o+r*(n[1]-o),t[2]=a+r*(n[2]-a),t[3]=s+r*(n[3]-s),t}function A(t,e,n){var r=e[0],i=e[1],o=e[2],a=e[3];return t[0]=n[0]*r+n[4]*i+n[8]*o+n[12]*a,t[1]=n[1]*r+n[5]*i+n[9]*o+n[13]*a,t[2]=n[2]*r+n[6]*i+n[10]*o+n[14]*a,t[3]=n[3]*r+n[7]*i+n[11]*o+n[15]*a,t}function g(t,e,n){var r=e[0],i=e[1],o=e[2],a=n[0],s=n[1],u=n[2],c=n[3],l=c*r+s*o-u*i,h=c*i+u*r-a*o,f=c*o+a*i-s*r,p=-a*r-s*i-u*o;return t[0]=l*c+p*-a+h*-u-f*-s,t[1]=h*c+p*-s+f*-a-l*-u,t[2]=f*c+p*-u+l*-s-h*-a,t[3]=e[3],t}function m(t,e){return t[0]===e[0]&&t[1]===e[1]&&t[2]===e[2]&&t[3]===e[3]}function y(t,e){var n=t[0],i=t[1],o=t[2],a=t[3],s=e[0],u=e[1],c=e[2],l=e[3];return Math.abs(n-s)<=r.b*Math.max(1,Math.abs(n),Math.abs(s))&&Math.abs(i-u)<=r.b*Math.max(1,Math.abs(i),Math.abs(u))&&Math.abs(o-c)<=r.b*Math.max(1,Math.abs(o),Math.abs(c))&&Math.abs(a-l)<=r.b*Math.max(1,Math.abs(a),Math.abs(l))}var v,_;v=new r.a(4),r.a!=Float32Array&&(v[0]=0,v[1]=0,v[2]=0,v[3]=0),_=v},function(t,e,n){"use strict";n(2),n(13);const r={CLOCKWISE:1,COUNTER_CLOCKWISE:-1};function i(t,e,n={}){return function(t,e={}){return Math.sign(o(t,e))}(t,n)!==e&&(function(t,e){const{start:n=0,end:r=t.length,size:i=2}=e,o=(r-n)/i,a=Math.floor(o/2);for(let e=0;e<a;++e){const r=n+e*i,a=n+(o-1-e)*i;for(let e=0;e<i;++e){const n=t[r+e];t[r+e]=t[a+e],t[a+e]=n}}}(t,n),!0)}function o(t,e={}){const{start:n=0,end:r=t.length}=e,i=e.size||2;let o=0;for(let e=n,a=r-i;e<r;e+=i)o+=(t[e]-t[a])*(t[e+1]+t[a+1]),a=e;return o/2}function a(t,e,n=2,r){const i=e&&e.length,o=i?e[0]*n:t.length;let a=s(t,0,o,n,!0,r&&r[0]);const l=[];if(!a||a.next===a.prev)return l;let h,f,p,g,m,v,_;if(i&&(a=function(t,e,n,r,i){const o=[];let a,c,l,h,f;for(a=0,c=e.length;a<c;a++)l=e[a]*r,h=a<c-1?e[a+1]*r:t.length,f=s(t,l,h,r,!1,i&&i[a+1]),f===f.next&&(f.steiner=!0),o.push(y(f));for(o.sort(d),a=0;a<o.length;a++)A(o[a],n),n=u(n,n.next);return n}(t,e,a,n,r)),t.length>80*n){g=f=t[0],m=p=t[1];for(let e=n;e<o;e+=n)v=t[e],_=t[e+1],v<g&&(g=v),_<m&&(m=_),v>f&&(f=v),_>p&&(p=_);h=Math.max(f-g,p-m),h=0!==h?1/h:0}return c(a,l,n,g,m,h),l}function s(t,e,n,r,i,a){let s,u;if(void 0===a&&(a=o(t,{start:e,end:n,size:r})),i===a<0)for(s=e;s<n;s+=r)u=C(s,t[s],t[s+1],u);else for(s=n-r;s>=e;s-=r)u=C(s,t[s],t[s+1],u);return u&&x(u,u.next)&&(P(u),u=u.next),u}function u(t,e){if(!t)return t;e||(e=t);let n,r=t;do{if(n=!1,r.steiner||!x(r,r.next)&&0!==b(r.prev,r,r.next))r=r.next;else{if(P(r),r=e=r.prev,r===r.next)break;n=!0}}while(n||r!==e);return e}function c(t,e,n,r,i,o,a){if(!t)return;!a&&o&&function(t,e,n,r){let i=t;do{null===i.z&&(i.z=m(i.x,i.y,e,n,r)),i.prevZ=i.prev,i.nextZ=i.next,i=i.next}while(i!==t);i.prevZ.nextZ=null,i.prevZ=null,function(t){let e,n,r,i,o,a,s,u,c=1;do{for(i=t,t=null,u=null,r=0;i;){for(r++,a=i,o=0,n=0;n<c&&(o++,a=a.nextZ,a);n++);for(s=c;o>0||s>0&&a;)0!==o&&(0===s||!a||i.z<=a.z)?(e=i,i=i.nextZ,o--):(e=a,a=a.nextZ,s--),u?u.nextZ=e:t=e,e.prevZ=u,u=e;i=a}u.nextZ=null,c*=2}while(r>1)}(i)}(t,r,i,o);let s,d,A=t;for(;t.prev!==t.next;)if(s=t.prev,d=t.next,o?h(t,r,i,o):l(t))e.push(s.i/n),e.push(t.i/n),e.push(d.i/n),P(t),t=d.next,A=d.next;else if((t=d)===A){a?1===a?c(t=f(u(t),e,n),e,n,r,i,o,2):2===a&&p(t,e,n,r,i,o):c(u(t),e,n,r,i,o,1);break}}function l(t){const e=t.prev,n=t,r=t.next;if(b(e,n,r)>=0)return!1;let i=t.next.next;for(;i!==t.prev;){if(v(e.x,e.y,n.x,n.y,r.x,r.y,i.x,i.y)&&b(i.prev,i,i.next)>=0)return!1;i=i.next}return!0}function h(t,e,n,r){const i=t.prev,o=t,a=t.next;if(b(i,o,a)>=0)return!1;const s=i.x<o.x?i.x<a.x?i.x:a.x:o.x<a.x?o.x:a.x,u=i.y<o.y?i.y<a.y?i.y:a.y:o.y<a.y?o.y:a.y,c=i.x>o.x?i.x>a.x?i.x:a.x:o.x>a.x?o.x:a.x,l=i.y>o.y?i.y>a.y?i.y:a.y:o.y>a.y?o.y:a.y,h=m(s,u,e,n,r),f=m(c,l,e,n,r);let p=t.prevZ,d=t.nextZ;for(;p&&p.z>=h&&d&&d.z<=f;){if(p!==t.prev&&p!==t.next&&v(i.x,i.y,o.x,o.y,a.x,a.y,p.x,p.y)&&b(p.prev,p,p.next)>=0)return!1;if(p=p.prevZ,d!==t.prev&&d!==t.next&&v(i.x,i.y,o.x,o.y,a.x,a.y,d.x,d.y)&&b(d.prev,d,d.next)>=0)return!1;d=d.nextZ}for(;p&&p.z>=h;){if(p!==t.prev&&p!==t.next&&v(i.x,i.y,o.x,o.y,a.x,a.y,p.x,p.y)&&b(p.prev,p,p.next)>=0)return!1;p=p.prevZ}for(;d&&d.z<=f;){if(d!==t.prev&&d!==t.next&&v(i.x,i.y,o.x,o.y,a.x,a.y,d.x,d.y)&&b(d.prev,d,d.next)>=0)return!1;d=d.nextZ}return!0}function f(t,e,n){let r=t;do{const i=r.prev,o=r.next.next;!x(i,o)&&w(i,r,r.next,o)&&S(i,o)&&S(o,i)&&(e.push(i.i/n),e.push(r.i/n),e.push(o.i/n),P(r),P(r.next),r=t=o),r=r.next}while(r!==t);return u(r)}function p(t,e,n,r,i,o){let a=t;do{let t=a.next.next;for(;t!==a.prev;){if(a.i!==t.i&&_(a,t)){let s=T(a,t);return a=u(a,a.next),s=u(s,s.next),c(a,e,n,r,i,o),void c(s,e,n,r,i,o)}t=t.next}a=a.next}while(a!==t)}function d(t,e){return t.x-e.x}function A(t,e){if(e=function(t,e){let n=e;const r=t.x,i=t.y;let o,a=-1/0;do{if(i<=n.y&&i>=n.next.y&&n.next.y!==n.y){const t=n.x+(i-n.y)*(n.next.x-n.x)/(n.next.y-n.y);if(t<=r&&t>a){if(a=t,t===r){if(i===n.y)return n;if(i===n.next.y)return n.next}o=n.x<n.next.x?n:n.next}}n=n.next}while(n!==e);if(!o)return null;if(r===a)return o;const s=o,u=o.x,c=o.y;let l,h=1/0;n=o;do{r>=n.x&&n.x>=u&&r!==n.x&&v(i<c?r:a,i,u,c,i<c?a:r,i,n.x,n.y)&&(l=Math.abs(i-n.y)/(r-n.x),S(n,t)&&(l<h||l===h&&(n.x>o.x||n.x===o.x&&g(o,n)))&&(o=n,h=l)),n=n.next}while(n!==s);return o}(t,e)){const n=T(e,t);u(e,e.next),u(n,n.next)}}function g(t,e){return b(t.prev,t,e.prev)<0&&b(e.next,t,t.next)<0}function m(t,e,n,r,i){return(t=1431655765&((t=858993459&((t=252645135&((t=16711935&((t=32767*(t-n)*i)|t<<8))|t<<4))|t<<2))|t<<1))|(e=1431655765&((e=858993459&((e=252645135&((e=16711935&((e=32767*(e-r)*i)|e<<8))|e<<4))|e<<2))|e<<1))<<1}function y(t){let e=t,n=t;do{(e.x<n.x||e.x===n.x&&e.y<n.y)&&(n=e),e=e.next}while(e!==t);return n}function v(t,e,n,r,i,o,a,s){return(i-a)*(e-s)-(t-a)*(o-s)>=0&&(t-a)*(r-s)-(n-a)*(e-s)>=0&&(n-a)*(o-s)-(i-a)*(r-s)>=0}function _(t,e){return t.next.i!==e.i&&t.prev.i!==e.i&&!function(t,e){let n=t;do{if(n.i!==t.i&&n.next.i!==t.i&&n.i!==e.i&&n.next.i!==e.i&&w(n,n.next,t,e))return!0;n=n.next}while(n!==t);return!1}(t,e)&&(S(t,e)&&S(e,t)&&function(t,e){let n=t,r=!1;const i=(t.x+e.x)/2,o=(t.y+e.y)/2;do{n.y>o!=n.next.y>o&&n.next.y!==n.y&&i<(n.next.x-n.x)*(o-n.y)/(n.next.y-n.y)+n.x&&(r=!r),n=n.next}while(n!==t);return r}(t,e)&&(b(t.prev,t,e.prev)||b(t,e.prev,e))||x(t,e)&&b(t.prev,t,t.next)>0&&b(e.prev,e,e.next)>0)}function b(t,e,n){return(e.y-t.y)*(n.x-e.x)-(e.x-t.x)*(n.y-e.y)}function x(t,e){return t.x===e.x&&t.y===e.y}function w(t,e,n,r){const i=O(b(t,e,n)),o=O(b(t,e,r)),a=O(b(n,r,t)),s=O(b(n,r,e));return i!==o&&a!==s||(!(0!==i||!E(t,n,e))||(!(0!==o||!E(t,r,e))||(!(0!==a||!E(n,t,r))||!(0!==s||!E(n,e,r)))))}function E(t,e,n){return e.x<=Math.max(t.x,n.x)&&e.x>=Math.min(t.x,n.x)&&e.y<=Math.max(t.y,n.y)&&e.y>=Math.min(t.y,n.y)}function O(t){return t>0?1:t<0?-1:0}function S(t,e){return b(t.prev,t,t.next)<0?b(t,e,t.next)>=0&&b(t,t.prev,e)>=0:b(t,e,t.prev)<0||b(t,t.next,e)<0}function T(t,e){const n=new M(t.i,t.x,t.y),r=new M(e.i,e.x,e.y),i=t.next,o=e.prev;return t.next=e,e.prev=t,n.next=i,i.prev=n,r.next=n,n.prev=r,o.next=r,r.prev=o,r}function C(t,e,n,r){const i=new M(t,e,n);return r?(i.next=r.next,i.prev=r,r.next.prev=i,r.next=i):(i.prev=i,i.next=i),i}function P(t){t.next.prev=t.prev,t.prev.next=t.next,t.prevZ&&(t.prevZ.nextZ=t.nextZ),t.nextZ&&(t.nextZ.prevZ=t.prevZ)}function M(t,e,n){this.i=t,this.x=e,this.y=n,this.prev=null,this.next=null,this.z=null,this.prevZ=null,this.nextZ=null,this.steiner=!1}function I(t,e){const n=e.length,r=t.length;if(r>0){let i=!0;for(let o=0;o<n;o++)if(t[r-n+o]!==e[o]){i=!1;break}if(i)return!1}for(let i=0;i<n;i++)t[r+i]=e[i];return!0}function B(t,e){const n=e.length;for(let r=0;r<n;r++)t[r]=e[r]}function R(t,e,n,r,i=[]){const o=r+e*n;for(let e=0;e<n;e++)i[e]=t[o+e];return i}function k(t,e,n,r,i=[]){let o,a;if(8&n)o=(r[3]-t[1])/(e[1]-t[1]),a=3;else if(4&n)o=(r[1]-t[1])/(e[1]-t[1]),a=1;else if(2&n)o=(r[2]-t[0])/(e[0]-t[0]),a=2;else{if(!(1&n))return null;o=(r[0]-t[0])/(e[0]-t[0]),a=0}for(let n=0;n<t.length;n++)i[n]=(1&a)===n?r[a]:o*(e[n]-t[n])+t[n];return i}function D(t,e){let n=0;return t[0]<e[0]?n|=1:t[0]>e[2]&&(n|=2),t[1]<e[1]?n|=4:t[1]>e[3]&&(n|=8),n}function L(t,e){const{size:n=2,broken:r=!1,gridResolution:i=10,gridOffset:o=[0,0],startIndex:a=0,endIndex:s=t.length}=e||{},u=(s-a)/n;let c=[];const l=[c],h=R(t,0,n,a);let f,p;const d=U(h,i,o,[]),A=[];I(c,h);for(let e=1;e<u;e++){for(f=R(t,e,n,a,f),p=D(f,d);p;){k(h,f,p,d,A);const t=D(A,d);t&&(k(h,A,t,d,A),p=t),I(c,A),B(h,A),N(d,i,p),r&&c.length>n&&(c=[],l.push(c),I(c,h)),p=D(f,d)}I(c,f),B(h,f)}return r?l:l[0]}function j(t,e){for(let n=0;n<e.length;n++)t.push(e[n]);return t}function F(t,e=null,n){if(!t.length)return[];const{size:r=2,gridResolution:i=10,gridOffset:o=[0,0],edgeTypes:a=!1}=n||{},s=[],u=[{pos:t,types:a?new Array(t.length/r).fill(1):null,holes:e||[]}],c=[[],[]];let l=[];for(;u.length;){const{pos:t,types:e,holes:n}=u.shift();G(t,r,n[0]||t.length,c),l=U(c[0],i,o,l);const h=D(c[1],l);if(h){let i=z(t,e,r,0,n[0]||t.length,l,h);const o={pos:i[0].pos,types:i[0].types,holes:[]},s={pos:i[1].pos,types:i[1].types,holes:[]};u.push(o,s);for(let u=0;u<n.length;u++)i=z(t,e,r,n[u],n[u+1]||t.length,l,h),i[0]&&(o.holes.push(o.pos.length),o.pos=j(o.pos,i[0].pos),a&&(o.types=j(o.types,i[0].types))),i[1]&&(s.holes.push(s.pos.length),s.pos=j(s.pos,i[1].pos),a&&(s.types=j(s.types,i[1].types)))}else{const r={positions:t};a&&(r.edgeTypes=e),n.length&&(r.holeIndices=n),s.push(r)}}return s}function z(t,e,n,r,i,o,a){const s=(i-r)/n,u=[],c=[],l=[],h=[],f=[];let p,d,A;const g=R(t,s-1,n,r);let m=Math.sign(8&a?g[1]-o[3]:g[0]-o[2]),y=e&&e[s-1],v=0,_=0;for(let i=0;i<s;i++)p=R(t,i,n,r,p),d=Math.sign(8&a?p[1]-o[3]:p[0]-o[2]),A=e&&e[r/n+i],d&&m&&m!==d&&(k(g,p,a,o,f),I(u,f)&&l.push(y),I(c,f)&&h.push(y)),d<=0?(I(u,p)&&l.push(A),v-=d):l.length&&(l[l.length-1]=0),d>=0?(I(c,p)&&h.push(A),_+=d):h.length&&(h[h.length-1]=0),B(g,p),m=d,y=A;return[v?{pos:u,types:e&&l}:null,_?{pos:c,types:e&&h}:null]}function U(t,e,n,r){const i=Math.floor((t[0]-n[0])/e)*e+n[0],o=Math.floor((t[1]-n[1])/e)*e+n[1];return r[0]=i,r[1]=o,r[2]=i+e,r[3]=o+e,r}function N(t,e,n){8&n?(t[1]+=e,t[3]+=e):4&n?(t[1]-=e,t[3]-=e):2&n?(t[0]+=e,t[2]+=e):1&n&&(t[0]-=e,t[2]-=e)}function G(t,e,n,r){let i=1/0,o=-1/0,a=1/0,s=-1/0;for(let r=0;r<n;r+=e){const e=t[r],n=t[r+1];i=e<i?e:i,o=e>o?e:o,a=n<a?n:a,s=n>s?n:s}return r[0][0]=i,r[0][1]=a,r[1][0]=o,r[1][1]=s,r}function V(t,e){const{size:n=2,startIndex:r=0,endIndex:i=t.length,normalize:o=!0}=e||{},a=t.slice(r,i);X(a,n,0,i-r);const s=L(a,{size:n,broken:!0,gridResolution:360,gridOffset:[-180,-180]});if(o)for(const t of s)Z(t,n);return s}function H(t,e=null,n){const{size:r=2,normalize:i=!0,edgeTypes:o=!1}=n||{};e=e||[];const a=[],s=[];let u=0,c=0;for(let i=0;i<=e.length;i++){const o=e[i]||t.length,l=c,h=W(t,r,u,o);for(let e=h;e<o;e++)a[c++]=t[e];for(let e=u;e<h;e++)a[c++]=t[e];X(a,r,l,c),q(a,r,l,c,null==n?void 0:n.maxLatitude),u=o,s[i]=c}s.pop();const l=F(a,s,{size:r,gridResolution:360,gridOffset:[-180,-180],edgeTypes:o});if(i)for(const t of l)Z(t.positions,r);return l}function W(t,e,n,r){let i=-1,o=-1;for(let a=n+1;a<r;a+=e){const e=Math.abs(t[a]);e>i&&(i=e,o=a-1)}return o}function q(t,e,n,r,i=85.051129){const o=t[n],a=t[r-e];if(Math.abs(o-a)>180){const r=R(t,0,e,n);r[0]+=360*Math.round((a-o)/360),I(t,r),r[1]=Math.sign(r[1])*i,I(t,r),r[0]=o,I(t,r)}}function X(t,e,n,r){let i,o=t[0];for(let a=n;a<r;a+=e){i=t[a];const e=i-o;(e>180||e<-180)&&(i-=360*Math.round(e/360)),t[a]=o=i}}function Z(t,e){let n;const r=t.length/e;for(let i=0;i<r&&(n=t[i*e],(n+180)%360==0);i++);const i=360*-Math.round(n/360);if(0!==i)for(let n=0;n<r;n++)t[n*e]+=i}n.d(e,"g",(function(){return o})),n.d(e,"h",(function(){return i})),n.d(e,"a",(function(){return r})),n.d(e,"f",(function(){return a})),n.d(e,"b",(function(){return F})),n.d(e,"d",(function(){return L})),n.d(e,"e",(function(){return V})),n.d(e,"c",(function(){return H}))},function(t,e,n){"use strict";n.d(e,"a",(function(){return l}));var r=n(7),i=n(132),o=n(48),a=n(10),s=n(47),u=n(176);const c="Resource subclass must define virtual methods";class l{get[Symbol.toStringTag](){return"Resource"}constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};Object(r.b)(t);const{id:n,userData:i={}}=e;this.gl=t,this.gl2=t,this.id=n||Object(s.c)(this[Symbol.toStringTag]),this.userData=i,this._bound=!1,this._handle=e.handle,void 0===this._handle&&(this._handle=this._createHandle()),this.byteLength=0,this._initStats(),this._addStats()}toString(){return"".concat(this[Symbol.toStringTag]||this.constructor.name,"(").concat(this.id,")")}get handle(){return this._handle}delete(){let{deleteChildren:t=!1}=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const e=this._handle&&this._deleteHandle(this._handle);return this._handle&&this._removeStats(),this._handle=null,e&&t&&e.filter(Boolean).forEach(t=>t.delete()),this}bind(){let t,e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:this.handle;return"function"!=typeof e?(this._bindHandle(e),this):(this._bound?t=e():(this._bindHandle(this.handle),this._bound=!0,t=e(),this._bound=!1,this._bindHandle(null)),t)}unbind(){this.bind(null)}getParameter(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};t=Object(o.b)(this.gl,t),Object(a.a)(t);const n=(this.constructor.PARAMETERS||{})[t];if(n){const t=Object(r.j)(this.gl);if(!((!("webgl2"in n)||t)&&(!("extension"in n)||this.gl.getExtension(n.extension)))){const e=n.webgl1,r="webgl2"in n?n.webgl2:n.webgl1;return t?r:e}}return this._getParameter(t,e)}getParameters(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{parameters:e,keys:n}=t,i=this.constructor.PARAMETERS||{},a=Object(r.j)(this.gl),s={},u=e||Object.keys(i);for(const e of u){const r=i[e];if(r&&(!("webgl2"in r)||a)&&(!("extension"in r)||this.gl.getExtension(r.extension))){const i=n?Object(o.a)(this.gl,e):e;s[i]=this.getParameter(e,t),n&&"GLenum"===r.type&&(s[i]=Object(o.a)(this.gl,s[i]))}}return s}setParameter(t,e){t=Object(o.b)(this.gl,t),Object(a.a)(t);const n=(this.constructor.PARAMETERS||{})[t];if(n){const t=Object(r.j)(this.gl);if(!((!("webgl2"in n)||t)&&(!("extension"in n)||this.gl.getExtension(n.extension))))throw new Error("Parameter not available on this platform");"GLenum"===n.type&&(e=Object(o.b)(e))}return this._setParameter(t,e),this}setParameters(t){for(const e in t)this.setParameter(e,t[e]);return this}stubRemovedMethods(t,e,n){return Object(u.a)(this,t,e,n)}initialize(t){}_createHandle(){throw new Error(c)}_deleteHandle(){throw new Error(c)}_bindHandle(t){throw new Error(c)}_getOptsFromHandle(){throw new Error(c)}_getParameter(t,e){throw new Error(c)}_setParameter(t,e){throw new Error(c)}_context(){return this.gl.luma=this.gl.luma||{},this.gl.luma}_initStats(){this.gl.stats=this.gl.stats||new i.a}_addStats(){const t=this[Symbol.toStringTag],e=i.b.get("Resource Counts");e.get("Resources Created").incrementCount(),e.get("".concat(t,"s Created")).incrementCount(),e.get("".concat(t,"s Active")).incrementCount()}_removeStats(){const t=this[Symbol.toStringTag];i.b.get("Resource Counts").get("".concat(t,"s Active")).decrementCount()}_trackAllocatedMemory(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:this[Symbol.toStringTag];this._doTrackAllocatedMemory(t,e),this._doTrackAllocatedMemory(t,e,this.gl.stats.get("Memory Usage"))}_doTrackAllocatedMemory(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:this[Symbol.toStringTag],n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:i.b.get("Memory Usage");n.get("GPU Memory").addCount(t),n.get("".concat(e," Memory")).addCount(t),this.byteLength=t}_trackDeallocatedMemory(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:this[Symbol.toStringTag];this._doTrackDeallocatedMemory(t),this._doTrackDeallocatedMemory(t,this.gl.stats.get("Memory Usage"))}_doTrackDeallocatedMemory(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:this[Symbol.toStringTag],e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:i.b.get("Memory Usage");e.get("GPU Memory").subtractCount(this.byteLength),e.get("".concat(t," Memory")).subtractCount(this.byteLength),this.byteLength=0}}},function(t,e,n){t.exports=n(277)},function(t,e,n){var r=n(268),i=n(269),o=n(270);t.exports=function(t){return r(t)||i(t)||o()}},function(t,e,n){var r=n(266);Object.assign(r,n(66),n(292),n(291),n(151),n(294),n(196)),t.exports=r},function(t,e,n){"use strict";n.d(e,"a",(function(){return w}));var r=n(9),i=n.n(r),o=n(3),a=n.n(o),s=n(4),u=n.n(s),c=n(0),l=n.n(c),h=n(21),f=n(35),p=n(78),d=n(13),A=n(84),g=n(70),m=n(19),y=n(12),v=Math.PI/180,_=Object(f.a)(),b=[0,0,0],x={unitsPerMeter:[1,1,1],metersPerUnit:[1,1,1]};var w=function(){function t(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};a()(this,t),l()(this,"_frustumPlanes",{}),this.id=e.id||this.constructor.displayName||"viewport",this.x=e.x||0,this.y=e.y||0,this.width=e.width||1,this.height=e.height||1,this.zoom=e.zoom||0,this.padding=e.padding,this.distanceScales=e.distanceScales||x,this.focalDistance=e.focalDistance||1,this.position=e.position||b,this.modelMatrix=e.modelMatrix||null;var n=e.longitude,r=e.latitude;this.isGeospatial=Number.isFinite(r)&&Number.isFinite(n),this._initProps(e),this._initMatrices(e),this.equals=this.equals.bind(this),this.project=this.project.bind(this),this.unproject=this.unproject.bind(this),this.projectPosition=this.projectPosition.bind(this),this.unprojectPosition=this.unprojectPosition.bind(this),this.projectFlat=this.projectFlat.bind(this),this.unprojectFlat=this.unprojectFlat.bind(this)}return u()(t,[{key:"metersPerPixel",get:function(){return this.distanceScales.metersPerUnit[2]/this.scale}},{key:"projectionMode",get:function(){return this.isGeospatial?this.zoom<12?y.d.WEB_MERCATOR:y.d.WEB_MERCATOR_AUTO_OFFSET:y.d.IDENTITY}},{key:"equals",value:function(e){return e instanceof t&&(this===e||e.width===this.width&&e.height===this.height&&e.scale===this.scale&&Object(d.d)(e.projectionMatrix,this.projectionMatrix)&&Object(d.d)(e.viewMatrix,this.viewMatrix))}},{key:"project",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},n=e.topLeft,r=void 0===n||n,o=this.projectPosition(t),a=Object(m.q)(o,this.pixelProjectionMatrix),s=i()(a,2),u=s[0],c=s[1],l=r?c:this.height-c;return 2===t.length?[u,l]:[u,l,a[2]]}},{key:"unproject",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},n=e.topLeft,r=void 0===n||n,o=e.targetZ,a=i()(t,3),s=a[0],u=a[1],c=a[2],l=r?u:this.height-u,h=o&&o*this.distanceScales.unitsPerMeter[2],f=Object(m.n)([s,l,c],this.pixelUnprojectionMatrix,h),p=this.unprojectPosition(f),d=i()(p,3),A=d[0],g=d[1],y=d[2];return Number.isFinite(c)?[A,g,y]:Number.isFinite(o)?[A,g,o]:[A,g]}},{key:"projectPosition",value:function(t){var e=this.projectFlat(t),n=i()(e,2);return[n[0],n[1],(t[2]||0)*this.distanceScales.unitsPerMeter[2]]}},{key:"unprojectPosition",value:function(t){var e=this.unprojectFlat(t),n=i()(e,2);return[n[0],n[1],(t[2]||0)*this.distanceScales.metersPerUnit[2]]}},{key:"projectFlat",value:function(t){if(this.isGeospatial){var e=Object(m.l)(t);return e[1]=Object(d.a)(e[1],-318,830),e}return t}},{key:"unprojectFlat",value:function(t){return this.isGeospatial?Object(m.p)(t):t}},{key:"getBounds",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},e={targetZ:t.z||0},n=this.unproject([0,0],e),r=this.unproject([this.width,0],e),i=this.unproject([0,this.height],e),o=this.unproject([this.width,this.height],e);return[Math.min(n[0],r[0],i[0],o[0]),Math.min(n[1],r[1],i[1],o[1]),Math.max(n[0],r[0],i[0],o[0]),Math.max(n[1],r[1],i[1],o[1])]}},{key:"getDistanceScales",value:function(t){return t?Object(m.g)({longitude:t[0],latitude:t[1],highPrecision:!0}):this.distanceScales}},{key:"containsPixel",value:function(t){var e=t.x,n=t.y,r=t.width,i=void 0===r?1:r,o=t.height,a=void 0===o?1:o;return e<this.x+this.width&&this.x<e+i&&n<this.y+this.height&&this.y<n+a}},{key:"getFrustumPlanes",value:function(){return this._frustumPlanes.near||Object.assign(this._frustumPlanes,Object(f.d)(this.viewProjectionMatrix)),this._frustumPlanes}},{key:"panByPosition",value:function(t,e){return null}},{key:"_initProps",value:function(t){var e=t.longitude,n=t.latitude;this.isGeospatial&&(Number.isFinite(t.zoom)||(this.zoom=Object(m.i)({latitude:n})+Math.log2(this.focalDistance)),this.distanceScales=t.distanceScales||Object(m.g)({latitude:n,longitude:e}));var r=Math.pow(2,this.zoom);this.scale=r;var i=t.position,o=t.modelMatrix,a=b;if(i&&(a=o?new p.a(o).transformAsVector(i,[]):i),this.isGeospatial){var s=this.projectPosition([e,n,0]);this.center=new A.a(a).scale(this.distanceScales.unitsPerMeter).add(s)}else this.center=this.projectPosition(a)}},{key:"_initMatrices",value:function(t){var e=t.viewMatrix,n=void 0===e?_:e,r=t.projectionMatrix,i=void 0===r?null:r,o=t.orthographic,a=void 0!==o&&o,s=t.fovyRadians,u=t.fovy,c=void 0===u?75:u,l=t.near,m=void 0===l?.1:l,y=t.far,b=void 0===y?1e3:y,x=t.padding,w=void 0===x?null:x,E=t.focalDistance,O=void 0===E?1:E;this.viewMatrixUncentered=n,this.viewMatrix=(new p.a).multiplyRight(n).translate(new A.a(this.center).negate()),this.projectionMatrix=i||function(t){var e=t.width,n=t.height,r=t.orthographic,i=t.fovyRadians,o=t.focalDistance,a=t.padding,s=t.near,u=t.far,c=e/n,l=r?(new p.a).orthographic({fovy:i,aspect:c,focalDistance:o,near:s,far:u}):(new p.a).perspective({fovy:i,aspect:c,near:s,far:u});if(a){var h=a.left,f=void 0===h?0:h,A=a.right,g=void 0===A?0:A,m=a.top,y=void 0===m?0:m,v=a.bottom,_=void 0===v?0:v,b=Object(d.a)((f+e-g)/2,0,e)-e/2,x=Object(d.a)((y+n-_)/2,0,n)-n/2;l[8]-=2*b/e,l[9]+=2*x/n}return l}({width:this.width,height:this.height,orthographic:a,fovyRadians:s||c*v,focalDistance:O,padding:w,near:m,far:b});var S=Object(f.a)();g.b(S,S,this.projectionMatrix),g.b(S,S,this.viewMatrix),this.viewProjectionMatrix=S,this.viewMatrixInverse=g.a([],this.viewMatrix)||this.viewMatrix,this.cameraPosition=Object(f.c)(this.viewMatrixInverse);var T=Object(f.a)(),C=Object(f.a)();g.c(T,T,[this.width/2,-this.height/2,1]),g.d(T,T,[1,-1,0]),g.b(C,T,this.viewProjectionMatrix),this.pixelProjectionMatrix=C,this.pixelUnprojectionMatrix=g.a(Object(f.a)(),this.pixelProjectionMatrix),this.pixelUnprojectionMatrix||h.a.warn("Pixel project matrix not invertible")()}}]),t}();l()(w,"displayName","Viewport")},function(t,e,n){"use strict";var r=n(0),i=n.n(r);function o(t){var e=t.source,n=t.target,r=t.start,i=void 0===r?0:r,o=t.size,a=t.getData,s=t.end||n.length,u=e.length,c=s-i;if(u>c)n.set(e.subarray(0,c),i);else if(n.set(e,i),a)for(var l=u;l<c;)for(var h=a(l,e),f=0;f<o;f++)n[i+l]=h[f]||0,l++}function a(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function s(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?a(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):a(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}n.d(e,"e",(function(){return c})),n.d(e,"d",(function(){return l})),n.d(e,"c",(function(){return h})),n.d(e,"a",(function(){return f})),n.d(e,"b",(function(){return p})),n.d(e,"f",(function(){return d}));var u={interpolation:{duration:0,easing:function(t){return t}},spring:{stiffness:.05,damping:.5}};function c(t,e){if(!t)return null;Number.isFinite(t)&&(t={type:"interpolation",duration:t});var n=t.type||"interpolation";return s(s(s(s({},u[n]),e),t),{},{type:n})}function l(t,e){var n=e.getBuffer();return n?[n,{divisor:0,size:e.size,normalized:e.settings.normalized}]:e.value}function h(t){switch(t){case 1:return"float";case 2:return"vec2";case 3:return"vec3";case 4:return"vec4";default:throw new Error('No defined attribute type for size "'.concat(t,'"'))}}function f(t){t.push(t.shift())}function p(t,e){var n=t.doublePrecision,r=t.settings,i=t.value,o=t.size,a=n&&i instanceof Float64Array?2:1;return(r.noAlloc?i.length:e*o)*a}function d(t){var e=t.buffer,n=t.numInstances,r=t.attribute,i=t.fromLength,a=t.fromStartIndices,s=t.getData,u=void 0===s?function(t){return t}:s,c=r.doublePrecision&&r.value instanceof Float64Array?2:1,l=r.size*c,h=r.byteOffset,f=r.startIndices,d=a&&f,A=p(r,n),g=r.isConstant;if(d||!(i>=A)){var m=g?r.value:r.getBuffer().getData({srcByteOffset:h});if(r.settings.normalized&&!g){var y=u;u=function(t,e){return r.normalizeConstant(y(t,e))}}var v=g?function(t,e){return u(m,e)}:function(t,e){return u(m.subarray(t,t+l),e)},_=e.getData({length:i}),b=new Float32Array(A);!function(t){var e=t.source,n=t.target,r=t.size,i=t.getData,a=t.sourceStartIndices,s=t.targetStartIndices;if(!Array.isArray(s))return o({source:e,target:n,size:r,getData:i}),n;for(var u=0,c=0,l=i&&function(t,e){return i(t+c,e)},h=Math.min(a.length,s.length),f=1;f<h;f++){var p=a[f]*r,d=s[f]*r;o({source:e.subarray(u,p),target:n,start:c,end:d,size:r,getData:l}),u=p,c=d}c<n.length&&o({source:[],target:n,start:c,size:r,getData:l})}({source:_,target:b,sourceStartIndices:a,targetStartIndices:f,size:l,getData:v}),e.byteLength<b.byteLength+h&&e.reallocate(b.byteLength+h),e.subData({data:b,offset:h})}}},function(t,e){var n,r,i=t.exports={};function o(){throw new Error("setTimeout has not been defined")}function a(){throw new Error("clearTimeout has not been defined")}function s(t){if(n===setTimeout)return setTimeout(t,0);if((n===o||!n)&&setTimeout)return n=setTimeout,setTimeout(t,0);try{return n(t,0)}catch(e){try{return n.call(null,t,0)}catch(e){return n.call(this,t,0)}}}!function(){try{n="function"==typeof setTimeout?setTimeout:o}catch(t){n=o}try{r="function"==typeof clearTimeout?clearTimeout:a}catch(t){r=a}}();var u,c=[],l=!1,h=-1;function f(){l&&u&&(l=!1,u.length?c=u.concat(c):h=-1,c.length&&p())}function p(){if(!l){var t=s(f);l=!0;for(var e=c.length;e;){for(u=c,c=[];++h<e;)u&&u[h].run();h=-1,e=c.length}u=null,l=!1,function(t){if(r===clearTimeout)return clearTimeout(t);if((r===a||!r)&&clearTimeout)return r=clearTimeout,clearTimeout(t);try{r(t)}catch(e){try{return r.call(null,t)}catch(e){return r.call(this,t)}}}(t)}}function d(t,e){this.fun=t,this.array=e}function A(){}i.nextTick=function(t){var e=new Array(arguments.length-1);if(arguments.length>1)for(var n=1;n<arguments.length;n++)e[n-1]=arguments[n];c.push(new d(t,e)),1!==c.length||l||s(p)},d.prototype.run=function(){this.fun.apply(null,this.array)},i.title="browser",i.browser=!0,i.env={},i.argv=[],i.version="",i.versions={},i.on=A,i.addListener=A,i.once=A,i.off=A,i.removeListener=A,i.removeAllListeners=A,i.emit=A,i.prependListener=A,i.prependOnceListener=A,i.listeners=function(t){return[]},i.binding=function(t){throw new Error("process.binding is not supported")},i.cwd=function(){return"/"},i.chdir=function(t){throw new Error("process.chdir is not supported")},i.umask=function(){return 0}},function(t,e,n){"use strict";n.d(e,"a",(function(){return i})),n.d(e,"b",(function(){return o}));var r=n(106);function i(t){var e;if(!t)return!1;Array.isArray(t)&&(t=t[0]);return Array.isArray(null===(e=t)||void 0===e?void 0:e.extensions)}function o(t){var e,n;let o;return Object(r.a)(t,"null loader"),Object(r.a)(i(t),"invalid loader"),Array.isArray(t)&&(o=t[1],t=t[0],t={...t,options:{...t.options,...o}}),(null!==(e=t)&&void 0!==e&&e.parseTextSync||null!==(n=t)&&void 0!==n&&n.parseText)&&(t.text=!0),t.text||(t.binary=!0),t}},function(t,e,n){"use strict";var r=n(22),i=n(103),o=n(2),a=n(239);const s=Object(a.a)();class u{constructor(t,e,n="sessionStorage"){this.storage=function(t){try{const e=window[t],n="__storage_test__";return e.setItem(n,n),e.removeItem(n),e}catch(t){return null}}(n),this.id=t,this.config={},Object.assign(this.config,e),this._loadConfiguration()}getConfiguration(){return this.config}setConfiguration(t){return this.config={},this.updateConfiguration(t)}updateConfiguration(t){if(Object.assign(this.config,t),this.storage){const t=JSON.stringify(this.config);this.storage.setItem(this.id,t)}return this}_loadConfiguration(){let t={};if(this.storage){const e=this.storage.getItem(this.id);t=e?JSON.parse(e):{}}return Object.assign(this.config,t),this}}function c(t,e,n,r=600){const i=t.src.replace(/\(/g,"%28").replace(/\)/g,"%29");t.width>r&&(n=Math.min(n,r/t.width));const o=t.width*n,a=t.height*n,s=["font-size:1px;","padding:".concat(Math.floor(a/2),"px ").concat(Math.floor(o/2),"px;"),"line-height:".concat(a,"px;"),"background:url(".concat(i,");"),"background-size:".concat(o,"px ").concat(a,"px;"),"color:transparent;"].join("");return["".concat(e," %c+"),s]}const l={BLACK:30,RED:31,GREEN:32,YELLOW:33,BLUE:34,MAGENTA:35,CYAN:36,WHITE:37,BRIGHT_BLACK:90,BRIGHT_RED:91,BRIGHT_GREEN:92,BRIGHT_YELLOW:93,BRIGHT_BLUE:94,BRIGHT_MAGENTA:95,BRIGHT_CYAN:96,BRIGHT_WHITE:97};function h(t){return"string"==typeof t?l[t.toUpperCase()]||l.WHITE:t}function f(t,e){if(!t)throw new Error(e||"Assertion failed")}var p=n(98);function d(){let t;if(s&&p.b.performance)t=p.b.performance.now();else if(p.a.hrtime){const e=p.a.hrtime();t=1e3*e[0]+e[1]/1e6}else t=Date.now();return t}const A={debug:s&&console.debug||console.log,log:console.log,info:console.info,warn:console.warn,error:console.error},g={enabled:!0,level:0};function m(){}const y={},v={once:!0};function _(t){for(const e in t)for(const n in t[e])return n||"untitled";return"empty"}class b{constructor({id:t}={id:""}){this.id=t,this.VERSION="8.9.7",this._startTs=d(),this._deltaTs=d(),this.LOG_THROTTLE_TIMEOUT=0,this._storage=new u("__probe-".concat(this.id,"__"),g),this.userData={},this.timeStamp("".concat(this.id," started")),function(t,e=["constructor"]){const n=Object.getPrototypeOf(t),r=Object.getOwnPropertyNames(n);for(const n of r)"function"==typeof t[n]&&(e.find(t=>n===t)||(t[n]=t[n].bind(t)))}(this),Object.seal(this)}set level(t){this.setLevel(t)}get level(){return this.getLevel()}isEnabled(){return this._storage.config.enabled}getLevel(){return this._storage.config.level}getTotal(){return Number((d()-this._startTs).toPrecision(10))}getDelta(){return Number((d()-this._deltaTs).toPrecision(10))}set priority(t){this.level=t}get priority(){return this.level}getPriority(){return this.level}enable(t=!0){return this._storage.updateConfiguration({enabled:t}),this}setLevel(t){return this._storage.updateConfiguration({level:t}),this}assert(t,e){f(t,e)}warn(t){return this._getLogFunction(0,t,A.warn,arguments,v)}error(t){return this._getLogFunction(0,t,A.error,arguments)}deprecated(t,e){return this.warn("`".concat(t,"` is deprecated and will be removed in a later version. Use `").concat(e,"` instead"))}removed(t,e){return this.error("`".concat(t,"` has been removed. Use `").concat(e,"` instead"))}probe(t,e){return this._getLogFunction(t,e,A.log,arguments,{time:!0,once:!0})}log(t,e){return this._getLogFunction(t,e,A.debug,arguments)}info(t,e){return this._getLogFunction(t,e,console.info,arguments)}once(t,e){return this._getLogFunction(t,e,A.debug||A.info,arguments,v)}table(t,e,n){return e?this._getLogFunction(t,e,console.table||m,n&&[n],{tag:_(e)}):m}image({logLevel:t,priority:e,image:r,message:i="",scale:o=1}){return this._shouldLog(t||e)?s?function({image:t,message:e="",scale:n=1}){if("string"==typeof t){const r=new Image;return r.onload=()=>{const t=c(r,e,n);console.log(...t)},r.src=t,m}const r=t.nodeName||"";if("img"===r.toLowerCase())return console.log(...c(t,e,n)),m;if("canvas"===r.toLowerCase()){const r=new Image;return r.onload=()=>console.log(...c(r,e,n)),r.src=t.toDataURL(),m}return m}({image:r,message:i,scale:o}):function({image:t,message:e="",scale:r=1}){let i=null;try{i=n(276)}catch(t){}if(i)return()=>i(t,{fit:"box",width:"".concat(Math.round(80*r),"%")}).then(t=>console.log(t));return m}({image:r,message:i,scale:o}):m}settings(){console.table?console.table(this._storage.config):console.log(this._storage.config)}get(t){return this._storage.config[t]}set(t,e){this._storage.updateConfiguration({[t]:e})}time(t,e){return this._getLogFunction(t,e,console.time?console.time:console.info)}timeEnd(t,e){return this._getLogFunction(t,e,console.timeEnd?console.timeEnd:console.info)}timeStamp(t,e){return this._getLogFunction(t,e,console.timeStamp||m)}group(t,e,n={collapsed:!1}){n=w({logLevel:t,message:e,opts:n});const{collapsed:r}=n;return n.method=(r?console.groupCollapsed:console.group)||console.info,this._getLogFunction(n)}groupCollapsed(t,e,n={}){return this.group(t,e,Object.assign({},n,{collapsed:!0}))}groupEnd(t){return this._getLogFunction(t,"",console.groupEnd||m)}withGroup(t,e,n){this.group(t,e)();try{n()}finally{this.groupEnd(t)()}}trace(){console.trace&&console.trace()}_shouldLog(t){return this.isEnabled()&&this.getLevel()>=x(t)}_getLogFunction(t,e,n,r=[],i){if(this._shouldLog(t)){i=w({logLevel:t,message:e,args:r,opts:i}),f(n=n||i.method),i.total=this.getTotal(),i.delta=this.getDelta(),this._deltaTs=d();const o=i.tag||i.message;if(i.once){if(y[o])return m;y[o]=d()}return e=function(t,e,n){if("string"==typeof e){const a=n.time?function(t,e=8){const n=Math.max(e-t.length,0);return"".concat(" ".repeat(n)).concat(t)}(function(t){let e;return e=t<10?"".concat(t.toFixed(2),"ms"):t<100?"".concat(t.toFixed(1),"ms"):t<1e3?"".concat(t.toFixed(0),"ms"):"".concat((t/1e3).toFixed(2),"s"),e}(n.total)):"";e=n.time?"".concat(t,": ").concat(a,"  ").concat(e):"".concat(t,": ").concat(e),r=e,i=n.color,o=n.background,s||"string"!=typeof r||(i&&(i=h(i),r="[".concat(i,"m").concat(r,"")),o&&(i=h(o),r="[".concat(o+10,"m").concat(r,""))),e=r}var r,i,o;return e}(this.id,i.message,i),n.bind(console,e,...i.args)}return m}}function x(t){if(!t)return 0;let e;switch(typeof t){case"number":e=t;break;case"object":e=t.logLevel||t.priority||0;break;default:return 0}return f(Number.isFinite(e)&&e>=0),e}function w(t){const{logLevel:e,message:n}=t;t.logLevel=x(e);const r=t.args?Array.from(t.args):[];for(;r.length&&r.shift()!==n;);switch(t.args=r,typeof e){case"string":case"function":void 0!==n&&r.unshift(n),t.message=e;break;case"object":Object.assign(t,e)}"function"==typeof t.message&&(t.message=t.message());const i=typeof t.message;return f("string"===i||"object"===i),Object.assign(t,t.opts)}b.VERSION="8.9.7";const E=new b({id:"loaders.gl"});class O{log(){return()=>{}}info(){return()=>{}}warn(){return()=>{}}error(){return()=>{}}}var S=n(72);const T={fetch:null,mimeType:void 0,nothrow:!1,log:new class{constructor(){Object(o.a)(this,"console",void 0),this.console=console}log(...t){return this.console.log.bind(this.console,...t)}info(...t){return this.console.info.bind(this.console,...t)}warn(...t){return this.console.warn.bind(this.console,...t)}error(...t){return this.console.error.bind(this.console,...t)}},CDN:"https://unpkg.com/@loaders.gl",worker:!0,maxConcurrency:3,maxMobileConcurrency:1,reuseWorkers:S.c,_nodeWorkers:!1,_workerType:"",limit:0,_limitMB:0,batchSize:"auto",batchDebounceMs:0,metadata:!1,transforms:[]},C={throws:"nothrow",dataType:"(no longer used)",uri:"baseUri",method:"fetch.method",headers:"fetch.headers",body:"fetch.body",mode:"fetch.mode",credentials:"fetch.credentials",cache:"fetch.cache",redirect:"fetch.redirect",referrer:"fetch.referrer",referrerPolicy:"fetch.referrerPolicy",integrity:"fetch.integrity",keepalive:"fetch.keepalive",signal:"fetch.signal"};function P(){globalThis.loaders=globalThis.loaders||{};const{loaders:t}=globalThis;return t._state=t._state||{},t._state}n.d(e,"c",(function(){return P})),n.d(e,"b",(function(){return M})),n.d(e,"e",(function(){return I})),n.d(e,"d",(function(){return B})),n.d(e,"a",(function(){return R}));const M=()=>{const t=P();return t.globalOptions=t.globalOptions||{...T},t.globalOptions};function I(t){const e=P(),n=M();e.globalOptions=L(n,t)}function B(t,e,n,r){return n=n||[],function(t,e){k(t,null,T,C,e);for(const n of e){const r=t&&t[n.id]||{},i=n.options&&n.options[n.id]||{},o=n.deprecatedOptions&&n.deprecatedOptions[n.id]||{};k(r,n.id,i,o,e)}}(t,n=Array.isArray(n)?n:[n]),L(e,t,r)}function R(t,e){const n=M(),o=t||n;return"function"==typeof o.fetch?o.fetch:Object(r.f)(o.fetch)?t=>Object(i.a)(t,o):null!=e&&e.fetch?null==e?void 0:e.fetch:i.a}function k(t,e,n,i,o){const a=e||"Top level",s=e?"".concat(e,"."):"";for(const u in t){const c=!e&&Object(r.f)(t[u]),l="baseUri"===u&&!e,h="workerUrl"===u&&e;if(!(u in n)&&!l&&!h)if(u in i)E.warn("".concat(a," loader option '").concat(s).concat(u,"' no longer supported, use '").concat(i[u],"'"))();else if(!c){const t=D(u,o);E.warn("".concat(a," loader option '").concat(s).concat(u,"' not recognized. ").concat(t))()}}}function D(t,e){const n=t.toLowerCase();let r="";for(const i of e)for(const e in i.options){if(t===e)return"Did you mean '".concat(i.id,".").concat(e,"'?");const o=e.toLowerCase();(n.startsWith(o)||o.startsWith(n))&&(r=r||"Did you mean '".concat(i.id,".").concat(e,"'?"))}return r}function L(t,e,n){const r={...t.options||{}};return function(t,e){e&&!("baseUri"in t)&&(t.baseUri=e)}(r,n),null===r.log&&(r.log=new O),j(r,M()),j(r,e),r}function j(t,e){for(const n in e)if(n in e){const i=e[n];Object(r.h)(i)&&Object(r.h)(t[n])?t[n]={...t[n],...e[n]}:t[n]=e[n]}}},function(t,e,n){"use strict";n.d(e,"c",(function(){return o})),n.d(e,"b",(function(){return a})),n.d(e,"a",(function(){return s}));var r=n(10);const i={};function o(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:"id";i[t]=i[t]||1;const e=i[t]++;return"".concat(t,"-").concat(e)}function a(t){return Object(r.a)("number"==typeof t,"Input must be a number"),t&&0==(t&t-1)}function s(t){let e=!0;for(const n in t){e=!1;break}return e}},function(t,e,n){"use strict";n.d(e,"b",(function(){return i})),n.d(e,"a",(function(){return o}));var r=n(10);function i(t,e){if("string"!=typeof e)return e;const n=Number(e);if(!isNaN(n))return n;const i=t[e=e.replace(/^.*\./,"")];return Object(r.a)(void 0!==i,"Accessing undefined constant GL.".concat(e)),i}function o(t,e){e=Number(e);for(const n in t)if(t[n]===e)return"GL.".concat(n);return String(e)}},function(t,e,n){"use strict";(function(t,r){n.d(e,"a",(function(){return o})),n.d(e,"b",(function(){return a})),n.d(e,"d",(function(){return s})),n.d(e,"c",(function(){return u}));const i={self:"undefined"!=typeof self&&self,window:"undefined"!=typeof window&&window,global:void 0!==t&&t,document:"undefined"!=typeof document&&document},o=i.global||i.self||i.window||{},a="object"!=typeof r||"[object process]"!==String(r)||r.browser,s="function"==typeof importScripts,u="undefined"!=typeof window&&void 0!==window.orientation,c=void 0!==r&&r.version&&/v([0-9]*)/.exec(r.version);c&&parseFloat(c[1])}).call(this,n(71),n(44))},function(t,e,n){"use strict";n.d(e,"a",(function(){return S}));var r=n(0),i=n.n(r),o=n(3),a=n.n(o),s=n(4),u=n.n(s),c=n(8),l=n.n(c),h=n(5),f=n.n(h),p=n(6),d=n.n(p),A=n(1),g=n.n(A),m=n(114),y=n(13);function v(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function _(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?v(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):v(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function b(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return x(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return x(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function x(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function w(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=g()(t);if(e){var i=g()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return d()(this,n)}}var E=["longitude","latitude","zoom","bearing","pitch"],O=["longitude","latitude","zoom"],S=function(t){f()(n,t);var e=w(n);function n(){var t,r=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};a()(this,n);var i=Array.isArray(r)?r:r.transitionProps,o=Array.isArray(r)?{}:r;return o.transitionProps=Array.isArray(i)?{compare:i,required:i}:i||{compare:E,required:O},(t=e.call(this,o.transitionProps)).opts=o,t}return u()(n,[{key:"initializeProps",value:function(t,e){var r=l()(g()(n.prototype),"initializeProps",this).call(this,t,e),i=this.opts,o=i.makeViewport,a=i.around;if(o&&a){var s=o(t),u=o(e),c=s.unproject(a);r.start.around=a,Object.assign(r.end,{around:u.project(c),aroundPosition:c,width:e.width,height:e.height})}return r}},{key:"interpolateProps",value:function(t,e,n){var r,i={},o=b(this._propsToExtract);try{for(o.s();!(r=o.n()).done;){var a=r.value;i[a]=Object(y.g)(t[a]||0,e[a]||0,n)}}catch(t){o.e(t)}finally{o.f()}if(e.aroundPosition&&this.opts.makeViewport){var s=this.opts.makeViewport(_(_({},e),i));Object.assign(i,s.panByPosition(e.aroundPosition,Object(y.g)(t.around,e.around,n)))}return i}}]),n}(m.a)},function(t,e,n){"use strict";function r(t,e){if(!t)throw new Error(e||"loaders.gl assertion failed.")}n.d(e,"a",(function(){return r}))},function(t,e,n){"use strict";n.d(e,"a",(function(){return o})),n.d(e,"c",(function(){return a})),n.d(e,"b",(function(){return s}));var r=[],i=[];function o(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:0,n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:1/0,o=r,a={index:-1,data:t,target:[]};return t?"function"==typeof t[Symbol.iterator]?o=t:t.length>0&&(i.length=t.length,o=i):o=r,(e>0||Number.isFinite(n))&&(o=(Array.isArray(o)?o:Array.from(o)).slice(e,n),a.index=e-1),{iterable:o,objectInfo:a}}function a(t){return t&&t[Symbol.asyncIterator]}function s(t,e){var n=e.size,r=e.stride,i=e.offset,o=e.startIndices,a=e.nested,s=t.BYTES_PER_ELEMENT,u=r?r/s:n,c=i?i/s:0,l=Math.floor((t.length-c)/u);return function(e,r){var i=r.index,s=r.target;if(!o){for(var h=i*u+c,f=0;f<n;f++)s[f]=t[h+f];return s}var p,d=o[i],A=o[i+1]||l;if(a){p=new Array(A-d);for(var g=d;g<A;g++){var m=g*u+c;s=new Array(n);for(var y=0;y<n;y++)s[y]=t[m+y];p[g-d]=s}}else if(u===n)p=t.subarray(d*n+c,A*n+c);else{p=new t.constructor((A-d)*n);for(var v=0,_=d;_<A;_++)for(var b=_*u+c,x=0;x<n;x++)p[v++]=t[b+x]}return p}}},function(t,e,n){"use strict";n.d(e,"b",(function(){return r})),n.d(e,"c",(function(){return i})),n.d(e,"a",(function(){return o})),n.d(e,"d",(function(){return a}));function r(t){switch(ArrayBuffer.isView(t)?t.constructor:t){case Float32Array:return 5126;case Uint16Array:return 5123;case Uint32Array:return 5125;case Uint8Array:case Uint8ClampedArray:return 5121;case Int8Array:return 5120;case Int16Array:return 5122;case Int32Array:return 5124;default:throw new Error("Failed to deduce GL constant from typed array")}}function i(t){let{clamped:e=!0}=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};switch(t){case 5126:return Float32Array;case 5123:case 33635:case 32819:case 32820:return Uint16Array;case 5125:return Uint32Array;case 5121:return e?Uint8ClampedArray:Uint8Array;case 5120:return Int8Array;case 5122:return Int16Array;case 5124:return Int32Array;default:throw new Error("Failed to deduce typed array type from GL constant")}}function o(t){let{data:e,width:n,height:r,bytesPerPixel:i=4,temp:o}=t;const a=n*i;o=o||new Uint8Array(a);for(let t=0;t<r/2;++t){const n=t*a,i=(r-t-1)*a;o.set(e.subarray(n,n+a)),e.copyWithin(n,i,i+a),e.set(o,i)}}function a(t){let{data:e,width:n,height:r}=t;const i=Math.round(n/2),o=Math.round(r/2),a=new Uint8Array(i*o*4);for(let t=0;t<o;t++)for(let r=0;r<i;r++)for(let o=0;o<4;o++)a[4*(t*i+r)+o]=e[4*(2*t*n+2*r)+o];return{data:a,width:i,height:o}}},function(t,e,n){"use strict";n.d(e,"a",(function(){return h}));var r=n(7),i=n(38),o=n(33),a=n(82),s=n(10),u=n(47);const c=[9729,9728],l=globalThis.WebGLBuffer||function(){};class h extends i.a{get[Symbol.toStringTag](){return"Texture"}static isSupported(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};const{format:n,linearFiltering:r}=e;let i=!0;return n&&(i=i&&Object(a.d)(t,n),i=i&&(!r||Object(a.e)(t,n))),i}constructor(t,e){const{id:n=Object(u.c)("texture"),handle:r,target:i}=e;super(t,{id:n,handle:r}),this.target=i,this.textureUnit=void 0,this.loaded=!1,this.width=void 0,this.height=void 0,this.depth=void 0,this.format=void 0,this.type=void 0,this.dataFormat=void 0,this.border=void 0,this.textureUnit=void 0,this.mipmaps=void 0}toString(){return"Texture(".concat(this.id,",").concat(this.width,"x").concat(this.height,")")}initialize(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},e=t.data;if(e instanceof Promise)return e.then(e=>this.initialize(Object.assign({},t,{pixels:e,data:e}))),this;const n="undefined"!=typeof HTMLVideoElement&&e instanceof HTMLVideoElement;if(n&&e.readyState<HTMLVideoElement.HAVE_METADATA)return this._video=null,e.addEventListener("loadeddata",()=>this.initialize(t)),this;const{pixels:i=null,format:o=6408,border:a=0,recreate:s=!1,parameters:u={},pixelStore:c={},textureUnit:l}=t;e||(e=i);let{width:h,height:f,dataFormat:p,type:d,compressed:A=!1,mipmaps:g=!0}=t;const{depth:m=0}=t;return({width:h,height:f,compressed:A,dataFormat:p,type:d}=this._deduceParameters({format:o,type:d,dataFormat:p,compressed:A,data:e,width:h,height:f})),this.width=h,this.height=f,this.depth=m,this.format=o,this.type=d,this.dataFormat=p,this.border=a,this.textureUnit=l,Number.isFinite(this.textureUnit)&&(this.gl.activeTexture(33984+this.textureUnit),this.gl.bindTexture(this.target,this.handle)),g&&this._isNPOT()&&(r.k.warn("texture: ".concat(this," is Non-Power-Of-Two, disabling mipmaping"))(),g=!1,this._updateForNPOT(u)),this.mipmaps=g,this.setImageData({data:e,width:h,height:f,depth:m,format:o,type:d,dataFormat:p,border:a,mipmaps:g,parameters:c,compressed:A}),g&&this.generateMipmap(),this.setParameters(u),s&&(this.data=e),n&&(this._video={video:e,parameters:u,lastTime:e.readyState>=HTMLVideoElement.HAVE_CURRENT_DATA?e.currentTime:-1}),this}update(){if(this._video){const{video:t,parameters:e,lastTime:n}=this._video;if(n===t.currentTime||t.readyState<HTMLVideoElement.HAVE_CURRENT_DATA)return;this.setSubImageData({data:t,parameters:e}),this.mipmaps&&this.generateMipmap(),this._video.lastTime=t.currentTime}}resize(t){let{height:e,width:n,mipmaps:r=!1}=t;return n!==this.width||e!==this.height?this.initialize({width:n,height:e,format:this.format,type:this.type,dataFormat:this.dataFormat,border:this.border,mipmaps:r}):this}generateMipmap(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return this._isNPOT()?(r.k.warn("texture: ".concat(this," is Non-Power-Of-Two, disabling mipmaping"))(),this):(this.mipmaps=!0,this.gl.bindTexture(this.target,this.handle),Object(r.o)(this.gl,t,()=>{this.gl.generateMipmap(this.target)}),this.gl.bindTexture(this.target,null),this)}setImageData(t){this._trackDeallocatedMemory("Texture");const{target:e=this.target,pixels:n=null,level:i=0,format:o=this.format,border:u=this.border,offset:c=0,parameters:l={}}=t;let{data:h=null,type:f=this.type,width:p=this.width,height:d=this.height,dataFormat:A=this.dataFormat,compressed:g=!1}=t;h||(h=n),({type:f,dataFormat:A,compressed:g,width:p,height:d}=this._deduceParameters({format:o,type:f,dataFormat:A,compressed:g,data:h,width:p,height:d}));const{gl:m}=this;m.bindTexture(this.target,this.handle);let y,v=null;({data:h,dataType:v}=this._getDataType({data:h,compressed:g}));let _=0;if(Object(r.o)(this.gl,l,()=>{switch(v){case"null":m.texImage2D(e,i,o,p,d,u,A,f,h);break;case"typed-array":m.texImage2D(e,i,o,p,d,u,A,f,h,c);break;case"buffer":y=Object(r.a)(m),y.bindBuffer(35052,h.handle||h),y.texImage2D(e,i,o,p,d,u,A,f,c),y.bindBuffer(35052,null);break;case"browser-object":Object(r.j)(m)?m.texImage2D(e,i,o,p,d,u,A,f,h):m.texImage2D(e,i,o,A,f,h);break;case"compressed":for(const[t,n]of h.entries())m.compressedTexImage2D(e,t,n.format,n.width,n.height,u,n.data),_+=n.levelSize;break;default:Object(s.a)(!1,"Unknown image data type")}}),"compressed"===v)this._trackAllocatedMemory(_,"Texture");else if(h&&h.byteLength)this._trackAllocatedMemory(h.byteLength,"Texture");else{const t=a.a[this.dataFormat]||4,e=a.c[this.type]||1;this._trackAllocatedMemory(this.width*this.height*t*e,"Texture")}return this.loaded=!0,this}setSubImageData(t){let{target:e=this.target,pixels:n=null,data:i=null,x:a=0,y:u=0,width:c=this.width,height:h=this.height,level:f=0,format:p=this.format,type:d=this.type,dataFormat:A=this.dataFormat,compressed:g=!1,offset:m=0,border:y=this.border,parameters:v={}}=t;if(({type:d,dataFormat:A,compressed:g,width:c,height:h}=this._deduceParameters({format:p,type:d,dataFormat:A,compressed:g,data:i,width:c,height:h})),Object(s.a)(0===this.depth,"texSubImage not supported for 3D textures"),i||(i=n),i&&i.data){const t=i;i=t.data,c=t.shape[0],h=t.shape[1]}i instanceof o.a&&(i=i.handle),this.gl.bindTexture(this.target,this.handle),Object(r.o)(this.gl,v,()=>{if(g)this.gl.compressedTexSubImage2D(e,f,a,u,c,h,p,i);else if(null===i)this.gl.texSubImage2D(e,f,a,u,c,h,A,d,null);else if(ArrayBuffer.isView(i))this.gl.texSubImage2D(e,f,a,u,c,h,A,d,i,m);else if(i instanceof l){const t=Object(r.a)(this.gl);t.bindBuffer(35052,i),t.texSubImage2D(e,f,a,u,c,h,A,d,m),t.bindBuffer(35052,null)}else if(Object(r.j)(this.gl)){Object(r.a)(this.gl).texSubImage2D(e,f,a,u,c,h,A,d,i)}else this.gl.texSubImage2D(e,f,a,u,A,d,i)}),this.gl.bindTexture(this.target,null)}copyFramebuffer(){return r.k.error("Texture.copyFramebuffer({...}) is no logner supported, use copyToTexture(source, target, opts})")(),null}getActiveUnit(){return this.gl.getParameter(34016)-33984}bind(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:this.textureUnit;const{gl:e}=this;return void 0!==t&&(this.textureUnit=t,e.activeTexture(33984+t)),e.bindTexture(this.target,this.handle),t}unbind(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:this.textureUnit;const{gl:e}=this;return void 0!==t&&(this.textureUnit=t,e.activeTexture(33984+t)),e.bindTexture(this.target,null),t}_getDataType(t){let{data:e,compressed:n=!1}=t;return n?{data:e,dataType:"compressed"}:null===e?{data:e,dataType:"null"}:ArrayBuffer.isView(e)?{data:e,dataType:"typed-array"}:e instanceof o.a?{data:e.handle,dataType:"buffer"}:e instanceof l?{data:e,dataType:"buffer"}:{data:e,dataType:"browser-object"}}_deduceParameters(t){const{format:e,data:n}=t;let{width:r,height:i,dataFormat:o,type:s,compressed:u}=t;const c=a.b[e];return o=o||c&&c.dataFormat,s=s||c&&c.types[0],u=u||c&&c.compressed,({width:r,height:i}=this._deduceImageSize(n,r,i)),{dataFormat:o,type:s,compressed:u,width:r,height:i,format:e,data:n}}_deduceImageSize(t,e,n){let r;return r="undefined"!=typeof ImageData&&t instanceof ImageData?{width:t.width,height:t.height}:"undefined"!=typeof HTMLImageElement&&t instanceof HTMLImageElement?{width:t.naturalWidth,height:t.naturalHeight}:"undefined"!=typeof HTMLCanvasElement&&t instanceof HTMLCanvasElement||"undefined"!=typeof ImageBitmap&&t instanceof ImageBitmap?{width:t.width,height:t.height}:"undefined"!=typeof HTMLVideoElement&&t instanceof HTMLVideoElement?{width:t.videoWidth,height:t.videoHeight}:t?{width:e,height:n}:{width:e>=0?e:1,height:n>=0?n:1},Object(s.a)(r,"Could not deduced texture size"),Object(s.a)(void 0===e||r.width===e,"Deduced texture width does not match supplied width"),Object(s.a)(void 0===n||r.height===n,"Deduced texture height does not match supplied height"),r}_createHandle(){return this.gl.createTexture()}_deleteHandle(){this.gl.deleteTexture(this.handle),this._trackDeallocatedMemory("Texture")}_getParameter(t){switch(t){case 4096:return this.width;case 4097:return this.height;default:this.gl.bindTexture(this.target,this.handle);const e=this.gl.getTexParameter(this.target,t);return this.gl.bindTexture(this.target,null),e}}_setParameter(t,e){switch(this.gl.bindTexture(this.target,this.handle),e=this._getNPOTParam(t,e),t){case 33082:case 33083:this.gl.texParameterf(this.handle,t,e);break;case 4096:case 4097:Object(s.a)(!1);break;default:this.gl.texParameteri(this.target,t,e)}return this.gl.bindTexture(this.target,null),this}_isNPOT(){return!Object(r.j)(this.gl)&&(!(!this.width||!this.height)&&(!Object(u.b)(this.width)||!Object(u.b)(this.height)))}_updateForNPOT(t){void 0===t[this.gl.TEXTURE_MIN_FILTER]&&(t[this.gl.TEXTURE_MIN_FILTER]=this.gl.LINEAR),void 0===t[this.gl.TEXTURE_WRAP_S]&&(t[this.gl.TEXTURE_WRAP_S]=this.gl.CLAMP_TO_EDGE),void 0===t[this.gl.TEXTURE_WRAP_T]&&(t[this.gl.TEXTURE_WRAP_T]=this.gl.CLAMP_TO_EDGE)}_getNPOTParam(t,e){if(this._isNPOT())switch(t){case 10241:-1===c.indexOf(e)&&(e=9729);break;case 10242:case 10243:33071!==e&&(e=33071)}return e}}},function(t,e,n){"use strict";function r(t,e,n){const r=e[0],i=e[1],o=n[3]*r+n[7]*i||1;return t[0]=(n[0]*r+n[4]*i)/o,t[1]=(n[1]*r+n[5]*i)/o,t}function i(t,e,n){const r=e[0],i=e[1],o=e[2],a=n[3]*r+n[7]*i+n[11]*o||1;return t[0]=(n[0]*r+n[4]*i+n[8]*o)/a,t[1]=(n[1]*r+n[5]*i+n[9]*o)/a,t[2]=(n[2]*r+n[6]*i+n[10]*o)/a,t}function o(t,e,n){const r=e[0],i=e[1];return t[0]=n[0]*r+n[2]*i,t[1]=n[1]*r+n[3]*i,t[2]=e[2],t}function a(t,e,n){const r=e[0],i=e[1];return t[0]=n[0]*r+n[2]*i,t[1]=n[1]*r+n[3]*i,t[2]=e[2],t[3]=e[3],t}function s(t,e,n){const r=e[0],i=e[1],o=e[2];return t[0]=n[0]*r+n[3]*i+n[6]*o,t[1]=n[1]*r+n[4]*i+n[7]*o,t[2]=n[2]*r+n[5]*i+n[8]*o,t[3]=e[3],t}n.d(e,"a",(function(){return r})),n.d(e,"c",(function(){return i})),n.d(e,"b",(function(){return o})),n.d(e,"d",(function(){return a})),n.d(e,"e",(function(){return s}))},function(t,e){function n(e){return t.exports=n=Object.setPrototypeOf?Object.getPrototypeOf.bind():function(t){return t.__proto__||Object.getPrototypeOf(t)},t.exports.__esModule=!0,t.exports.default=t.exports,n(e)}t.exports=n,t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){"use strict";n.d(e,"a",(function(){return i})),n.d(e,"i",(function(){return o})),n.d(e,"d",(function(){return a})),n.d(e,"b",(function(){return s})),n.d(e,"e",(function(){return u})),n.d(e,"h",(function(){return c})),n.d(e,"f",(function(){return l})),n.d(e,"g",(function(){return h})),n.d(e,"c",(function(){return f}));var r=n(11);function i(){var t=new r.a(9);return r.a!=Float32Array&&(t[1]=0,t[2]=0,t[3]=0,t[5]=0,t[6]=0,t[7]=0),t[0]=1,t[4]=1,t[8]=1,t}function o(t,e){if(t===e){var n=e[1],r=e[2],i=e[5];t[1]=e[3],t[2]=e[6],t[3]=n,t[5]=e[7],t[6]=r,t[7]=i}else t[0]=e[0],t[1]=e[3],t[2]=e[6],t[3]=e[1],t[4]=e[4],t[5]=e[7],t[6]=e[2],t[7]=e[5],t[8]=e[8];return t}function a(t,e){var n=e[0],r=e[1],i=e[2],o=e[3],a=e[4],s=e[5],u=e[6],c=e[7],l=e[8],h=l*a-s*c,f=-l*o+s*u,p=c*o-a*u,d=n*h+r*f+i*p;return d?(d=1/d,t[0]=h*d,t[1]=(-l*r+i*c)*d,t[2]=(s*r-i*a)*d,t[3]=f*d,t[4]=(l*n-i*u)*d,t[5]=(-s*n+i*o)*d,t[6]=p*d,t[7]=(-c*n+r*u)*d,t[8]=(a*n-r*o)*d,t):null}function s(t){var e=t[0],n=t[1],r=t[2],i=t[3],o=t[4],a=t[5],s=t[6],u=t[7],c=t[8];return e*(c*o-a*u)+n*(-c*i+a*s)+r*(u*i-o*s)}function u(t,e,n){var r=e[0],i=e[1],o=e[2],a=e[3],s=e[4],u=e[5],c=e[6],l=e[7],h=e[8],f=n[0],p=n[1],d=n[2],A=n[3],g=n[4],m=n[5],y=n[6],v=n[7],_=n[8];return t[0]=f*r+p*a+d*c,t[1]=f*i+p*s+d*l,t[2]=f*o+p*u+d*h,t[3]=A*r+g*a+m*c,t[4]=A*i+g*s+m*l,t[5]=A*o+g*u+m*h,t[6]=y*r+v*a+_*c,t[7]=y*i+v*s+_*l,t[8]=y*o+v*u+_*h,t}function c(t,e,n){var r=e[0],i=e[1],o=e[2],a=e[3],s=e[4],u=e[5],c=e[6],l=e[7],h=e[8],f=n[0],p=n[1];return t[0]=r,t[1]=i,t[2]=o,t[3]=a,t[4]=s,t[5]=u,t[6]=f*r+p*a+c,t[7]=f*i+p*s+l,t[8]=f*o+p*u+h,t}function l(t,e,n){var r=e[0],i=e[1],o=e[2],a=e[3],s=e[4],u=e[5],c=e[6],l=e[7],h=e[8],f=Math.sin(n),p=Math.cos(n);return t[0]=p*r+f*a,t[1]=p*i+f*s,t[2]=p*o+f*u,t[3]=p*a-f*r,t[4]=p*s-f*i,t[5]=p*u-f*o,t[6]=c,t[7]=l,t[8]=h,t}function h(t,e,n){var r=n[0],i=n[1];return t[0]=r*e[0],t[1]=r*e[1],t[2]=r*e[2],t[3]=i*e[3],t[4]=i*e[4],t[5]=i*e[5],t[6]=e[6],t[7]=e[7],t[8]=e[8],t}function f(t,e){var n=e[0],r=e[1],i=e[2],o=e[3],a=n+n,s=r+r,u=i+i,c=n*a,l=r*a,h=r*s,f=i*a,p=i*s,d=i*u,A=o*a,g=o*s,m=o*u;return t[0]=1-h-d,t[3]=l-m,t[6]=f+g,t[1]=l+m,t[4]=1-c-d,t[7]=p-A,t[2]=f-g,t[5]=p+A,t[8]=1-c-h,t}},function(t,e,n){"use strict";n.d(e,"a",(function(){return x}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(0),u=n.n(s),c=n(154),l=n(50);function h(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function f(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?h(Object(n),!0).forEach((function(e){u()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):h(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var p={transitionDuration:0},d=function(t){return 1-(1-t)*(1-t)},A=["wheel"],g=["panstart","panmove","panend"],m=["pinchstart","pinchmove","pinchend"],y=["tripanstart","tripanmove","tripanend"],v=["doubletap"],_=["keydown"],b={},x=function(){function t(e){var n=this;i()(this,t),u()(this,"state",{}),u()(this,"_events",{}),u()(this,"_interactionState",{isDragging:!1}),u()(this,"_customEvents",[]),u()(this,"_eventStartBlocked",null),u()(this,"_panMove",!1),u()(this,"invertPan",!1),u()(this,"dragMode","rotate"),u()(this,"inertia",0),u()(this,"scrollZoom",!0),u()(this,"dragPan",!0),u()(this,"dragRotate",!0),u()(this,"doubleClickZoom",!0),u()(this,"touchZoom",!0),u()(this,"touchRotate",!1),u()(this,"keyboard",!0),this.transitionManager=new c.b(f(f({},e),{},{getControllerState:function(t){return new n.ControllerState(t)},onViewStateChange:this._onTransition.bind(this),onStateChange:this._setInteractionState.bind(this)})),this.handleEvent=this.handleEvent.bind(this),this.eventManager=e.eventManager,this.onViewStateChange=e.onViewStateChange||function(){},this.onStateChange=e.onStateChange||function(){},this.makeViewport=e.makeViewport}return a()(t,[{key:"events",set:function(t){this.toggleEvents(this._customEvents,!1),this.toggleEvents(t,!0),this._customEvents=t,this.props&&this.setProps(this.props)}},{key:"finalize",value:function(){for(var t in this._events){var e;if(this._events[t])null===(e=this.eventManager)||void 0===e||e.off(t,this.handleEvent)}this.transitionManager.finalize()}},{key:"handleEvent",value:function(t){this._controllerState=void 0;var e=this._eventStartBlocked;switch(t.type){case"panstart":return!e&&this._onPanStart(t);case"panmove":return this._onPan(t);case"panend":return this._onPanEnd(t);case"pinchstart":return!e&&this._onPinchStart(t);case"pinchmove":return this._onPinch(t);case"pinchend":return this._onPinchEnd(t);case"tripanstart":return!e&&this._onTriplePanStart(t);case"tripanmove":return this._onTriplePan(t);case"tripanend":return this._onTriplePanEnd(t);case"doubletap":return this._onDoubleTap(t);case"wheel":return this._onWheel(t);case"keydown":return this._onKeyDown(t);default:return!1}}},{key:"controllerState",get:function(){return this._controllerState=this._controllerState||new this.ControllerState(f(f({makeViewport:this.makeViewport},this.props),this.state)),this._controllerState}},{key:"getCenter",value:function(t){var e=this.props,n=e.x,r=e.y,i=t.offsetCenter;return[i.x-n,i.y-r]}},{key:"isPointInBounds",value:function(t,e){var n=this.props,r=n.width,i=n.height;if(e&&e.handled)return!1;var o=t[0]>=0&&t[0]<=r&&t[1]>=0&&t[1]<=i;return o&&e&&e.stopPropagation(),o}},{key:"isFunctionKeyPressed",value:function(t){var e=t.srcEvent;return Boolean(e.metaKey||e.altKey||e.ctrlKey||e.shiftKey)}},{key:"isDragging",value:function(){return this._interactionState.isDragging||!1}},{key:"blockEvents",value:function(t){var e=this,n=setTimeout((function(){e._eventStartBlocked===n&&(e._eventStartBlocked=null)}),t);this._eventStartBlocked=n}},{key:"setProps",value:function(t){t.dragMode&&(this.dragMode=t.dragMode),this.props=t,"transitionInterpolator"in t||(t.transitionInterpolator=this._getTransitionProps().transitionInterpolator),this.transitionManager.processViewStateChange(t);var e=t.inertia;this.inertia=Number.isFinite(e)?e:!0===e?300:0;var n=t.scrollZoom,r=void 0===n||n,i=t.dragPan,o=void 0===i||i,a=t.dragRotate,s=void 0===a||a,u=t.doubleClickZoom,c=void 0===u||u,l=t.touchZoom,h=void 0===l||l,f=t.touchRotate,p=void 0!==f&&f,d=t.keyboard,b=void 0===d||d,x=Boolean(this.onViewStateChange);this.toggleEvents(A,x&&r),this.toggleEvents(g,x&&(o||s)),this.toggleEvents(m,x&&(h||p)),this.toggleEvents(y,x&&p),this.toggleEvents(v,x&&c),this.toggleEvents(_,x&&b),this.scrollZoom=r,this.dragPan=o,this.dragRotate=s,this.doubleClickZoom=c,this.touchZoom=h,this.touchRotate=p,this.keyboard=b}},{key:"updateTransition",value:function(){this.transitionManager.updateTransition()}},{key:"toggleEvents",value:function(t,e){var n=this;this.eventManager&&t.forEach((function(t){n._events[t]!==e&&(n._events[t]=e,e?n.eventManager.on(t,n.handleEvent):n.eventManager.off(t,n.handleEvent))}))}},{key:"updateViewport",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:null,n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{},r=f(f({},t.getViewportProps()),e),i=this.controllerState!==t;if(this.state=t.getState(),this._setInteractionState(n),i){var o=this.controllerState&&this.controllerState.getViewportProps();this.onViewStateChange&&this.onViewStateChange({viewState:r,interactionState:this._interactionState,oldViewState:o})}}},{key:"_onTransition",value:function(t){this.onViewStateChange(f(f({},t),{},{interactionState:this._interactionState}))}},{key:"_setInteractionState",value:function(t){Object.assign(this._interactionState,t),this.onStateChange(this._interactionState)}},{key:"_onPanStart",value:function(t){var e=this.getCenter(t);if(!this.isPointInBounds(e,t))return!1;var n=this.isFunctionKeyPressed(t)||t.rightButton||!1;(this.invertPan||"pan"===this.dragMode)&&(n=!n);var r=this.controllerState[n?"panStart":"rotateStart"]({pos:e});return this._panMove=n,this.updateViewport(r,p,{isDragging:!0}),!0}},{key:"_onPan",value:function(t){return!!this.isDragging()&&(this._panMove?this._onPanMove(t):this._onPanRotate(t))}},{key:"_onPanEnd",value:function(t){return!!this.isDragging()&&(this._panMove?this._onPanMoveEnd(t):this._onPanRotateEnd(t))}},{key:"_onPanMove",value:function(t){if(!this.dragPan)return!1;var e=this.getCenter(t),n=this.controllerState.pan({pos:e});return this.updateViewport(n,p,{isDragging:!0,isPanning:!0}),!0}},{key:"_onPanMoveEnd",value:function(t){var e=this.inertia;if(this.dragPan&&e&&t.velocity){var n=this.getCenter(t),r=[n[0]+t.velocityX*e/2,n[1]+t.velocityY*e/2],i=this.controllerState.pan({pos:r}).panEnd();this.updateViewport(i,f(f({},this._getTransitionProps()),{},{transitionDuration:e,transitionEasing:d}),{isDragging:!1,isPanning:!0})}else{var o=this.controllerState.panEnd();this.updateViewport(o,null,{isDragging:!1,isPanning:!1})}return!0}},{key:"_onPanRotate",value:function(t){if(!this.dragRotate)return!1;var e=this.getCenter(t),n=this.controllerState.rotate({pos:e});return this.updateViewport(n,p,{isDragging:!0,isRotating:!0}),!0}},{key:"_onPanRotateEnd",value:function(t){var e=this.inertia;if(this.dragRotate&&e&&t.velocity){var n=this.getCenter(t),r=[n[0]+t.velocityX*e/2,n[1]+t.velocityY*e/2],i=this.controllerState.rotate({pos:r}).rotateEnd();this.updateViewport(i,f(f({},this._getTransitionProps()),{},{transitionDuration:e,transitionEasing:d}),{isDragging:!1,isRotating:!0})}else{var o=this.controllerState.rotateEnd();this.updateViewport(o,null,{isDragging:!1,isRotating:!1})}return!0}},{key:"_onWheel",value:function(t){if(!this.scrollZoom)return!1;t.srcEvent.preventDefault();var e=this.getCenter(t);if(!this.isPointInBounds(e,t))return!1;var n=!0===this.scrollZoom?{}:this.scrollZoom,r=n.speed,i=void 0===r?.01:r,o=n.smooth,a=void 0!==o&&o,s=t.delta,u=2/(1+Math.exp(-Math.abs(s*i)));s<0&&0!==u&&(u=1/u);var c=this.controllerState.zoom({pos:e,scale:u});return this.updateViewport(c,f(f({},this._getTransitionProps({around:e})),{},{transitionDuration:a?250:1}),{isZooming:!0,isPanning:!0}),!0}},{key:"_onTriplePanStart",value:function(t){var e=this.getCenter(t);if(!this.isPointInBounds(e,t))return!1;var n=this.controllerState.rotateStart({pos:e});return this.updateViewport(n,p,{isDragging:!0}),!0}},{key:"_onTriplePan",value:function(t){if(!this.touchRotate)return!1;if(!this.isDragging())return!1;var e=this.getCenter(t);e[0]-=t.deltaX;var n=this.controllerState.rotate({pos:e});return this.updateViewport(n,p,{isDragging:!0,isRotating:!0}),!0}},{key:"_onTriplePanEnd",value:function(t){if(!this.isDragging())return!1;var e=this.inertia;if(this.touchRotate&&e&&t.velocityY){var n=this.getCenter(t),r=[n[0],n[1]+=t.velocityY*e/2],i=this.controllerState.rotate({pos:r});this.updateViewport(i,f(f({},this._getTransitionProps()),{},{transitionDuration:e,transitionEasing:d}),{isDragging:!1,isRotating:!0}),this.blockEvents(e)}else{var o=this.controllerState.rotateEnd();this.updateViewport(o,null,{isDragging:!1,isRotating:!1})}return!0}},{key:"_onPinchStart",value:function(t){var e=this.getCenter(t);if(!this.isPointInBounds(e,t))return!1;var n=this.controllerState.zoomStart({pos:e}).rotateStart({pos:e});return b._startPinchRotation=t.rotation,b._lastPinchEvent=t,this.updateViewport(n,p,{isDragging:!0}),!0}},{key:"_onPinch",value:function(t){if(!this.touchZoom&&!this.touchRotate)return!1;if(!this.isDragging())return!1;var e=this.controllerState;if(this.touchZoom){var n=t.scale,r=this.getCenter(t);e=e.zoom({pos:r,scale:n})}if(this.touchRotate){var i=t.rotation;e=e.rotate({deltaAngleX:b._startPinchRotation-i})}return this.updateViewport(e,p,{isDragging:!0,isPanning:this.touchZoom,isZooming:this.touchZoom,isRotating:this.touchRotate}),b._lastPinchEvent=t,!0}},{key:"_onPinchEnd",value:function(t){if(!this.isDragging())return!1;var e=this.inertia,n=b._lastPinchEvent;if(this.touchZoom&&e&&n&&t.scale!==n.scale){var r=this.getCenter(t),i=this.controllerState.rotateEnd(),o=Math.log2(t.scale),a=(o-Math.log2(n.scale))/(t.deltaTime-n.deltaTime),s=Math.pow(2,o+a*e/2);i=i.zoom({pos:r,scale:s}).zoomEnd(),this.updateViewport(i,f(f({},this._getTransitionProps({around:r})),{},{transitionDuration:e,transitionEasing:d}),{isDragging:!1,isPanning:this.touchZoom,isZooming:this.touchZoom,isRotating:!1}),this.blockEvents(e)}else{var u=this.controllerState.zoomEnd().rotateEnd();this.updateViewport(u,null,{isDragging:!1,isPanning:!1,isZooming:!1,isRotating:!1})}return b._startPinchRotation=null,b._lastPinchEvent=null,!0}},{key:"_onDoubleTap",value:function(t){if(!this.doubleClickZoom)return!1;var e=this.getCenter(t);if(!this.isPointInBounds(e,t))return!1;var n=this.isFunctionKeyPressed(t),r=this.controllerState.zoom({pos:e,scale:n?.5:2});return this.updateViewport(r,this._getTransitionProps({around:e}),{isZooming:!0,isPanning:!0}),this.blockEvents(100),!0}},{key:"_onKeyDown",value:function(t){if(!this.keyboard)return!1;var e,n=this.isFunctionKeyPressed(t),r=!0===this.keyboard?{}:this.keyboard,i=r.zoomSpeed,o=r.moveSpeed,a=r.rotateSpeedX,s=r.rotateSpeedY,u=this.controllerState,c={};switch(t.srcEvent.code){case"Minus":e=n?u.zoomOut(i).zoomOut(i):u.zoomOut(i),c.isZooming=!0;break;case"Equal":e=n?u.zoomIn(i).zoomIn(i):u.zoomIn(i),c.isZooming=!0;break;case"ArrowLeft":n?(e=u.rotateLeft(a),c.isRotating=!0):(e=u.moveLeft(o),c.isPanning=!0);break;case"ArrowRight":n?(e=u.rotateRight(a),c.isRotating=!0):(e=u.moveRight(o),c.isPanning=!0);break;case"ArrowUp":n?(e=u.rotateUp(s),c.isRotating=!0):(e=u.moveUp(o),c.isPanning=!0);break;case"ArrowDown":n?(e=u.rotateDown(s),c.isRotating=!0):(e=u.moveDown(o),c.isPanning=!0);break;default:return!1}return this.updateViewport(e,this._getTransitionProps(),c),!0}},{key:"_getTransitionProps",value:function(t){var e=this.transition;return e&&e.transitionInterpolator?t?f(f({},e),{},{transitionInterpolator:new l.a(f(f(f({},t),e.transitionInterpolator.opts),{},{makeViewport:this.controllerState.makeViewport}))}):e:p}}]),t}()},function(t,e,n){"use strict";var r=n(28),i=n.n(r),o=n(0),a=n.n(o),s=n(3),u=n.n(s),c=n(4),l=n.n(c),h=n(42),f=/([0-9]+\.?[0-9]*)(%|px)/;function p(t){switch(i()(t)){case"number":return{position:t,relative:!1};case"string":var e=f.exec(t);if(e&&e.length>=3){var n="%"===e[2],r=parseFloat(e[1]);return{position:n?r/100:r,relative:n}}default:throw new Error("Could not parse position string ".concat(t))}}function d(t,e){return t.relative?Math.round(t.position*e):t.position}var A=n(61),g=n(29);function m(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function y(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?m(Object(n),!0).forEach((function(e){a()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):m(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}n.d(e,"a",(function(){return v}));var v=function(){function t(e){u()(this,t);var n=e||{},r=n.id,i=n.x,o=void 0===i?0:i,a=n.y,s=void 0===a?0:a,c=n.width,l=void 0===c?"100%":c,f=n.height,d=void 0===f?"100%":f,A=n.padding,m=void 0===A?null:A,v=n.viewportInstance;Object(g.a)(!v||v instanceof h.a),this.viewportInstance=v,this.id=r||this.constructor.displayName||"view",this.props=y(y({},e),{},{id:this.id}),this._x=p(o),this._y=p(s),this._width=p(l),this._height=p(d),this._padding=m&&{left:p(m.left||0),right:p(m.right||0),top:p(m.top||0),bottom:p(m.bottom||0)},this.equals=this.equals.bind(this),Object.seal(this)}return l()(t,[{key:"equals",value:function(t){return this===t||(this.viewportInstance?!!t.viewportInstance&&this.viewportInstance.equals(t.viewportInstance):this.ViewportType===t.ViewportType&&Object(A.a)(this.props,t.props))}},{key:"makeViewport",value:function(t){var e=t.width,n=t.height,r=t.viewState;if(this.viewportInstance)return this.viewportInstance;r=this.filterViewState(r);var i=this.getDimensions({width:e,height:n});return new this.ViewportType(y(y(y({},r),this.props),i))}},{key:"getViewStateId",value:function(){var t=this.props.viewState;return"string"==typeof t?t:(null==t?void 0:t.id)||this.id}},{key:"filterViewState",value:function(t){if(this.props.viewState&&"object"===i()(this.props.viewState)){if(!this.props.viewState.id)return this.props.viewState;var e=y({},t);for(var n in this.props.viewState)"id"!==n&&(e[n]=this.props.viewState[n]);return e}return t}},{key:"getDimensions",value:function(t){var e=t.width,n=t.height,r={x:d(this._x,e),y:d(this._y,n),width:d(this._width,e),height:d(this._height,n)};return this._padding&&(r.padding={left:d(this._padding.left,e),top:d(this._padding.top,n),right:d(this._padding.right,e),bottom:d(this._padding.bottom,n)}),r}},{key:"controller",get:function(){var t=this.props.controller;return t?!0===t?{type:this.ControllerType}:"function"==typeof t?{type:t}:y({type:this.ControllerType},t):null}}]),t}()},function(t,e,n){"use strict";n.d(e,"a",(function(){return a}));var r=n(47),i=n(10);const o={POINTS:0,LINES:1,LINE_LOOP:2,LINE_STRIP:3,TRIANGLES:4,TRIANGLE_STRIP:5,TRIANGLE_FAN:6};class a{static get DRAW_MODE(){return o}constructor(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{id:e=Object(r.c)("geometry"),drawMode:n=o.TRIANGLES,attributes:i={},indices:a=null,vertexCount:s=null}=t;this.id=e,this.drawMode=0|n,this.attributes={},this.userData={},this._setAttributes(i,a),this.vertexCount=s||this._calculateVertexCount(this.attributes,this.indices)}get mode(){return this.drawMode}getVertexCount(){return this.vertexCount}getAttributes(){return this.indices?{indices:this.indices,...this.attributes}:this.attributes}_print(t){return"Geometry ".concat(this.id," attribute ").concat(t)}_setAttributes(t,e){e&&(this.indices=ArrayBuffer.isView(e)?{value:e,size:1}:e);for(const e in t){let n=t[e];n=ArrayBuffer.isView(n)?{value:n}:n,Object(i.a)(ArrayBuffer.isView(n.value),"".concat(this._print(e),": must be typed array or object with value as typed array")),"POSITION"!==e&&"positions"!==e||n.size||(n.size=3),"indices"===e?(Object(i.a)(!this.indices),this.indices=n):this.attributes[e]=n}return this.indices&&void 0!==this.indices.isIndexed&&(this.indices=Object.assign({},this.indices),delete this.indices.isIndexed),this}_calculateVertexCount(t,e){if(e)return e.value.length;let n=1/0;for(const e in t){const r=t[e],{value:i,size:o,constant:a}=r;!a&&i&&o>=1&&(n=Math.min(n,i.length/o))}return Object(i.a)(Number.isFinite(n)),n}}},function(t,e,n){"use strict";function r(t,e){if(t===e)return!0;if(!t||!e)return!1;for(var n in t){var i=t[n],o=e[n];if(!(i===o||Array.isArray(i)&&Array.isArray(o)&&r(i,o)))return!1}return!0}n.d(e,"a",(function(){return r}))},function(t,e,n){"use strict";var r=n(22);const i=/^data:([-\w.]+\/[-\w.+]+)(;|,)/,o=/^([-\w.]+\/[-\w.+]+)/;function a(t){const e=o.exec(t);return e?e[1]:t}function s(t){const e=i.exec(t);return e?e[1]:""}n.d(e,"b",(function(){return c})),n.d(e,"a",(function(){return l}));const u=/\?.*/;function c(t){if(Object(r.j)(t)){const e=h(t.url||"");return{url:e,type:a(t.headers.get("content-type")||"")||s(e)}}return Object(r.b)(t)?{url:h(t.name||""),type:t.type||""}:"string"==typeof t?{url:h(t),type:s(t)}:{url:"",type:""}}function l(t){return Object(r.j)(t)?t.headers["content-length"]||-1:Object(r.b)(t)?t.size:"string"==typeof t?t.length:t instanceof ArrayBuffer||ArrayBuffer.isView(t)?t.byteLength:-1}function h(t){return t.replace(u,"")}},function(t,e,n){"use strict";n.d(e,"a",(function(){return u}));var r=n(53),i=n(10),o=n(143);const a={offset:0,stride:0,type:5126,size:1,divisor:0,normalized:!1,integer:!1},s={deprecatedProps:{instanced:"divisor",isInstanced:"divisor"}};class u{static getBytesPerElement(t){return Object(r.c)(t.type||5126).BYTES_PER_ELEMENT}static getBytesPerVertex(t){Object(i.a)(t.size);return Object(r.c)(t.type||5126).BYTES_PER_ELEMENT*t.size}static resolve(){for(var t=arguments.length,e=new Array(t),n=0;n<t;n++)e[n]=arguments[n];return new u(...[a,...e])}constructor(){for(var t=arguments.length,e=new Array(t),n=0;n<t;n++)e[n]=arguments[n];e.forEach(t=>this._assign(t)),Object.freeze(this)}toString(){return JSON.stringify(this)}get BYTES_PER_ELEMENT(){return u.getBytesPerElement(this)}get BYTES_PER_VERTEX(){return u.getBytesPerVertex(this)}_assign(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return t=Object(o.a)("Accessor",t,s),void 0!==t.type&&(this.type=t.type,5124!==t.type&&5125!==t.type||(this.integer=!0)),void 0!==t.size&&(this.size=t.size),void 0!==t.offset&&(this.offset=t.offset),void 0!==t.stride&&(this.stride=t.stride),void 0!==t.normalized&&(this.normalized=t.normalized),void 0!==t.integer&&(this.integer=t.integer),void 0!==t.divisor&&(this.divisor=t.divisor),void 0!==t.buffer&&(this.buffer=t.buffer),void 0!==t.index&&("boolean"==typeof t.index?this.index=t.index?1:0:this.index=t.index),void 0!==t.instanced&&(this.divisor=t.instanced?1:0),void 0!==t.isInstanced&&(this.divisor=t.isInstanced?1:0),this}}},function(t,e,n){"use strict";n.d(e,"b",(function(){return p})),n.d(e,"a",(function(){return d})),n.d(e,"d",(function(){return y})),n.d(e,"c",(function(){return b}));var r=n(9),i=n.n(r),o=n(245),a=n.n(o),s=n(37);function u(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return c(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return c(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function c(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var l=s.a.CLOCKWISE,h=s.a.COUNTER_CLOCKWISE,f={isClosed:!0};function p(t){return"positions"in t?t.positions:t}function d(t){return"holeIndices"in t?t.holeIndices:null}function A(t,e,n,r){for(var i=0;i<e;i++)if(t[n+i]!==t[r-e+i])return!1;return!0}function g(t,e,n,r,i){for(var o=e,a=n.length,u=0;u<a;u++)for(var c=0;c<r;c++)t[o++]=n[u][c]||0;if(!function(t){var e=t[0],n=t[t.length-1];return e[0]===n[0]&&e[1]===n[1]&&e[2]===n[2]}(n))for(var l=0;l<r;l++)t[o++]=n[0][l]||0;return f.start=e,f.end=o,f.size=r,Object(s.h)(t,i,f),o}function m(t,e,n,r){var i=arguments.length>4&&void 0!==arguments[4]?arguments[4]:0,o=arguments.length>5?arguments[5]:void 0,a=arguments.length>6?arguments[6]:void 0,u=(o=o||n.length)-i;if(u<=0)return e;for(var c=e,l=0;l<u;l++)t[c++]=n[i+l];if(!A(n,r,i,o))for(var h=0;h<r;h++)t[c++]=n[i+h];return f.start=e,f.end=c,f.size=r,Object(s.h)(t,a,f),c}function y(t,e){!function(t){if(t=t&&t.positions||t,!Array.isArray(t)&&!ArrayBuffer.isView(t))throw new Error("invalid polygon")}(t);var n=[],r=[];if("positions"in t){var o=t,a=o.positions,s=o.holeIndices;if(s){for(var c=0,f=0;f<=s.length;f++)c=m(n,c,a,e,s[f-1],s[f],0===f?l:h),r.push(c);return r.pop(),{positions:n,holeIndices:r}}t=a}if(!function(t){return Array.isArray(t[0])}(t))return m(n,0,t,e,0,n.length,l),n;if(!function(t){return t.length>=1&&t[0].length>=2&&Number.isFinite(t[0][0])}(t)){var p,d=0,A=u(t.entries());try{for(A.s();!(p=A.n()).done;){var y=i()(p.value,2),v=y[0];d=g(n,d,y[1],e,0===v?l:h),r.push(d)}}catch(t){A.e(t)}finally{A.f()}return r.pop(),{positions:n,holeIndices:r}}return g(n,0,t,e,l),n}function v(t,e,n){for(var r=t.length/3,i=0,o=0;o<r;o++){var a=(o+1)%r;i+=t[3*o+e]*t[3*a+n],i-=t[3*a+e]*t[3*o+n]}return Math.abs(i/2)}function _(t,e,n,r){for(var i=t.length/3,o=0;o<i;o++){var a=3*o,s=t[a+0],u=t[a+1],c=t[a+2];t[a+e]=s,t[a+n]=u,t[a+r]=c}}function b(t,e,n,r){var i=d(t);i&&(i=i.map((function(t){return t/e})));var o=p(t),s=r&&3===e;if(n){var u=o.length;o=o.slice();for(var c=[],l=0;l<u;l+=e){c[0]=o[l],c[1]=o[l+1],s&&(c[2]=o[l+2]);var h=n(c);o[l]=h[0],o[l+1]=h[1],s&&(o[l+2]=h[2])}}if(s){var f=v(o,0,1),A=v(o,0,2),g=v(o,1,2);if(!f&&!A&&!g)return[];f>A&&f>g||(A>g?(n||(o=o.slice()),_(o,0,2,1)):(n||(o=o.slice()),_(o,1,2,0)))}return a()(o,i,e)}},function(t,e,n){"use strict";n.r(e);var r=n(103),i=n(20);async function o(t,e,n){if("number"==typeof t)return await i.a._readToArrayBuffer(t,e,n);t instanceof Blob||(t=new Blob([t]));const r=t.slice(e,e+n);return await async function(t){return await new Promise((e,n)=>{const r=new FileReader;r.onload=t=>{var n;return e(null==t||null===(n=t.target)||void 0===n?void 0:n.result)},r.onerror=t=>n(t),r.readAsArrayBuffer(t)})}(r)}var a=n(100),s=n(72),u=n(85),c=n(106);function l(t,e={}){if(t=Object(a.b)(t),!s.c){const n=i.a.readFileSync(t,e);return"string"!=typeof n?Object(u.d)(n):n}return e.nothrow||Object(c.a)(!1),null}var h=n(101);async function f(t,e,n){t=Object(a.b)(t),s.c||await i.a.writeFile(t,Object(h.c)(e),{flag:"w"}),Object(c.a)(!1)}function p(t,e,n){t=Object(a.b)(t),s.c||i.a.writeFileSync(t,Object(h.c)(e),{flag:"w"}),Object(c.a)(!1)}var d=n(46),A=n(112),g=n(79),m=n(105),y=n(45),v=n(126),_=n(91),b=n(62);function x(t,e,n,r){Object(c.a)(!r||"object"==typeof r),Array.isArray(e)||Object(y.a)(e)||(r=void 0,n=e,e=void 0),n=n||{};const i=e,o=Object(_.b)(i,r),a=Object(g.b)(t,o,n);if(!a)return null;n=Object(d.d)(n,a,o);const{url:s}=Object(b.b)(t);return function(t,e,n,r){if(e=Object(v.b)(e,t,n),t.parseTextSync&&"string"==typeof e)return t.parseTextSync(e,n);if(t.parseSync&&e instanceof ArrayBuffer)return t.parseSync(e,n,r);throw new Error("".concat(t.name," loader: 'parseSync' not supported by this loader, use 'parse' instead. ").concat(r.url||""))}(a,t,n,r=Object(_.a)({url:s,parseSync:x,parse:()=>{throw new Error("parseSync called parse")},loaders:e},n))}var w=n(156);async function E(t,e,n,r){Object(c.a)(!r||"object"==typeof r),Array.isArray(e)||Object(y.a)(e)||(r=void 0,n=e,e=void 0),t=await t,n=n||{};const{url:i}=Object(b.b)(t),o=await Object(g.a)(t,e,n);return o?(n=Object(d.d)(n,o,e,i),r=Object(_.a)({url:i,parseInBatches:E,parse:m.a,loaders:e},n,r),await async function(t,e,n,r){const i=await async function(t,e,n,r){const i=await Object(v.c)(e,n),o=await async function(t,e=[]){let n=t;for await(const t of e)n=t(n);return n}(i,(null==n?void 0:n.transforms)||[]);if(t.parseInBatches)return t.parseInBatches(o,n,r);return async function*(){const e=await Object(w.a)(o),i=await Object(m.a)(e,t,{...n,mimeType:t.mimeTypes[0]},r),a={mimeType:t.mimeTypes[0],shape:Array.isArray(i)?"row-table":"unknown",batchType:"data",data:i,length:Array.isArray(i)?i.length:1};yield a}()}(t,e,n,r);if(!n.metadata)return i;const o={batchType:"metadata",metadata:{_loader:t,_context:r},data:[],bytesUsed:0};return async function*(t){yield o,yield*t}(i)}(o,t,n,r)):null}var O=n(215);function S(t,e,n,r){Array.isArray(e)||Object(y.a)(e)||(void 0,n=e,e=null);const i=Object(d.a)(n||{});if(!Array.isArray(t))return T(t,e,n,i);return t.map(t=>T(t,e,n,i))}async function T(t,e,n,r){if("string"==typeof t){const i=t,o=await r(i);return await E(o,e,n)}return await E(t,e,n)}var C=n(220),P=n(134),M=n(190),I=n(179);async function B(t,e,n={},r={}){const i=Object(M.a)(t),o=P.a.getWorkerFarm(n),{source:a}=n,s={name:i,source:a};a||(s.url=Object(M.b)(t,n));const u=o.getWorkerPool(s),c=n.jobName||t.name,l=await u.startJob(c,R.bind(null,r)),h=Object(I.b)(n);l.postMessage("process",{input:e,options:h});return(await l.result).result}async function R(t,e,n,r){switch(n){case"done":e.done(r);break;case"error":e.error(new Error(r.error));break;case"process":const{id:i,input:o,options:a}=r;try{if(!t.process)return void e.postMessage("error",{id:i,error:"Worker not set up to process on main thread"});const n=await t.process(o,a);e.postMessage("done",{id:i,result:n})}catch(t){const n=t instanceof Error?t.message:"unknown error";e.postMessage("error",{id:i,error:n})}break;default:console.warn("process-on-worker: unknown message ".concat(n))}}async function k(t,e,n){if(n={...Object(d.b)(),...n},Object(C.a)(e,n))return await B(e,t,n);if(e.encode)return await e.encode(t,n);if(e.encodeSync)return e.encodeSync(t,n);if(e.encodeText)return(new TextEncoder).encode(await e.encodeText(t,n));if(e.encodeInBatches){const r=j(t,e,n),i=[];for await(const t of r)i.push(t);return Object(u.b)(...i)}if(!s.c&&e.encodeURLtoURL){const i=z("input");await f(i,t);const o=z("output"),a=await F(i,o,e,n);return(await Object(r.a)(a)).arrayBuffer()}throw new Error("Writer could not encode data")}function D(t,e,n){if(e.encodeSync)return e.encodeSync(t,n);throw new Error("Writer could not synchronously encode data")}async function L(t,e,n){if(e.text&&e.encodeText)return await e.encodeText(t,n);if(e.text&&(e.encode||e.encodeInBatches)){const r=await k(t,e,n);return(new TextDecoder).decode(r)}throw new Error("Writer could not encode data as text")}function j(t,e,n){if(e.encodeInBatches){const r=function(t){return[{table:t,start:0,end:t.length}]}(t);return e.encodeInBatches(r,n)}throw new Error("Writer could not encode data in batches")}async function F(t,e,n,r){if(t=Object(a.b)(t),e=Object(a.b)(e),s.c||!n.encodeURLtoURL)throw new Error;return await n.encodeURLtoURL(t,e,r)}function z(t){return"/tmp/".concat(t)}async function U(t,e,n,r){const i=await k(t,n,r);return await f(e,i)}function N(t,e,n,r){return p(e,D(t,n,r))}var G=n(221),V=n(127);function H(t,e){const n=t[Symbol.asyncIterator]?t[Symbol.asyncIterator]():t[Symbol.iterator]();return new ReadableStream({type:"bytes",async pull(t){try{const{done:e,value:r}=await n.next();e?t.close():t.enqueue(new Uint8Array(r))}catch(e){t.error(e)}},async cancel(){var t;await(null==n||null===(t=n.return)||void 0===t?void 0:t.call(n))}},{highWaterMark:2**24,...e})}const W={name:"Null loader",id:"null",module:"core",version:"3.2.10",worker:!0,mimeTypes:["application/x.empty"],extensions:["null"],tests:[()=>!1],options:{null:{}}};function q(t,e,n){return e.null.echoParameters?{arrayBuffer:t,options:e,context:n=n&&JSON.parse(JSON.stringify(n))}:null}const X={name:"Null loader",id:"null",module:"core",version:"3.2.10",mimeTypes:["application/x.empty"],extensions:["null"],parse:async(t,e,n)=>q(t,e,n),parseSync:q,parseInBatches:async function*(t,e,n){for await(const r of t)yield q(r,e,n)},tests:[()=>!1],options:{null:{echoParameters:!1}}};var Z=n(222);async function J(t,e,n=(()=>{}),r=(()=>{})){if(!(t=await t).ok)return t;const i=t.body;if(!i)return t;const o=t.headers.get("content-length")||0,a=o&&parseInt(o);if(!(o>0))return t;if("undefined"==typeof ReadableStream||!i.getReader)return t;const s=new ReadableStream({async start(t){const o=i.getReader();await async function t(e,n,r,i,o,a,s){try{const{done:u,value:c}=await n.read();if(u)return a(),void e.close();r+=c.byteLength;const l=Math.round(r/i*100);o(l,{loadedBytes:r,totalBytes:i}),e.enqueue(c),await t(e,n,r,i,o,a,s)}catch(t){e.error(t),s(t)}}(t,o,0,a,e,n,r)}});return new Response(s)}var Q=n(2);class K{constructor(t,e){Object(Q.a)(this,"_fetch",void 0),Object(Q.a)(this,"files",{}),Object(Q.a)(this,"lowerCaseFiles",{}),Object(Q.a)(this,"usedFiles",{}),this._fetch=(null==e?void 0:e.fetch)||fetch;for(let e=0;e<t.length;++e){const n=t[e];this.files[n.name]=n,this.lowerCaseFiles[n.name.toLowerCase()]=n,this.usedFiles[n.name]=!1}this.fetch=this.fetch.bind(this)}async fetch(t,e){if(t.includes("://"))return this._fetch(t,e);const n=this.files[t];if(!n)return new Response(t,{status:400,statusText:"NOT FOUND"});const r=new Headers(null==e?void 0:e.headers).get("Range"),i=r&&/bytes=($1)-($2)/.exec(r);if(i){const e=parseInt(i[1]),r=parseInt(i[2]),o=await n.slice(e,r).arrayBuffer(),a=new Response(o);return Object.defineProperty(a,"url",{value:t}),a}const o=new Response(n);return Object.defineProperty(o,"url",{value:t}),o}async readdir(t){const e=[];for(const t in this.files)e.push(t);return e}async stat(t,e){const n=this.files[t];if(!n)throw new Error(t);return{size:n.size}}async unlink(t){delete this.files[t],delete this.lowerCaseFiles[t],this.usedFiles[t]=!0}async open(t,e,n){return this.files[t]}async read(t,e,n=0,r=e.byteLength,i=null){const o=t;return{bytesRead:r,buffer:await o.slice(0,0+r).arrayBuffer()}}async close(t){}_getFile(t,e){const n=this.files[t]||this.lowerCaseFiles[t];return n&&e&&(this.usedFiles[t]=!0),n}}var Y=n(135),$=n(22);n.d(e,"fetchFile",(function(){return r.a})),n.d(e,"readArrayBuffer",(function(){return o})),n.d(e,"readFileSync",(function(){return l})),n.d(e,"writeFile",(function(){return f})),n.d(e,"writeFileSync",(function(){return p})),n.d(e,"setLoaderOptions",(function(){return d.e})),n.d(e,"getLoaderOptions",(function(){return d.b})),n.d(e,"registerLoaders",(function(){return A.c})),n.d(e,"selectLoader",(function(){return g.a})),n.d(e,"selectLoaderSync",(function(){return g.b})),n.d(e,"parse",(function(){return m.a})),n.d(e,"parseSync",(function(){return x})),n.d(e,"parseInBatches",(function(){return E})),n.d(e,"load",(function(){return O.a})),n.d(e,"loadInBatches",(function(){return S})),n.d(e,"encode",(function(){return k})),n.d(e,"encodeSync",(function(){return D})),n.d(e,"encodeInBatches",(function(){return j})),n.d(e,"encodeText",(function(){return L})),n.d(e,"encodeURLtoURL",(function(){return F})),n.d(e,"save",(function(){return U})),n.d(e,"saveSync",(function(){return N})),n.d(e,"setPathPrefix",(function(){return a.c})),n.d(e,"getPathPrefix",(function(){return a.a})),n.d(e,"resolvePath",(function(){return a.b})),n.d(e,"RequestScheduler",(function(){return G.a})),n.d(e,"makeIterator",(function(){return V.a})),n.d(e,"makeStream",(function(){return H})),n.d(e,"NullWorkerLoader",(function(){return W})),n.d(e,"NullLoader",(function(){return X})),n.d(e,"JSONLoader",(function(){return Z.a})),n.d(e,"_fetchProgress",(function(){return J})),n.d(e,"_BrowserFileSystem",(function(){return K})),n.d(e,"_unregisterLoaders",(function(){return A.a})),n.d(e,"isBrowser",(function(){return s.c})),n.d(e,"isWorker",(function(){return s.d})),n.d(e,"self",(function(){return s.e})),n.d(e,"window",(function(){return s.f})),n.d(e,"global",(function(){return s.b})),n.d(e,"document",(function(){return s.a})),n.d(e,"assert",(function(){return c.a})),n.d(e,"forEach",(function(){return w.b})),n.d(e,"concatenateArrayBuffersAsync",(function(){return w.a})),n.d(e,"makeTextDecoderIterator",(function(){return Y.c})),n.d(e,"makeTextEncoderIterator",(function(){return Y.d})),n.d(e,"makeLineIterator",(function(){return Y.a})),n.d(e,"makeNumberedLineIterator",(function(){return Y.b})),n.d(e,"isPureObject",(function(){return $.h})),n.d(e,"isPromise",(function(){return $.g})),n.d(e,"isIterable",(function(){return $.d})),n.d(e,"isAsyncIterable",(function(){return $.a})),n.d(e,"isIterator",(function(){return $.e})),n.d(e,"isResponse",(function(){return $.j})),n.d(e,"isReadableStream",(function(){return $.i})),n.d(e,"isWritableStream",(function(){return $.k}))},function(t,e,n){"use strict";n.r(e);var r=n(230),i=n(9),o=n.n(i),a=n(3),s=n.n(a),u=n(4),c=n.n(u),l=n(8),h=n.n(l),f=n(5),p=n.n(f),d=n(6),A=n.n(d),g=n(1),m=n.n(g),y=n(0),v=n.n(y),_=n(12),b=n(217),x=n(234),w=n(164),E=n(186),O=n(60),S=n(19),T=n(13),C=new Uint16Array([0,2,1,0,3,2]),P=new Float32Array([0,1,0,0,1,0,1,1]);function M(t,e){if(!e)return function(t){for(var e=new Float64Array(12),n=0;n<t.length;n++)e[3*n+0]=t[n][0],e[3*n+1]=t[n][1],e[3*n+2]=t[n][2]||0;return{vertexCount:6,positions:e,indices:C,texCoords:P}}(t);for(var n=Math.max(Math.abs(t[0][0]-t[3][0]),Math.abs(t[1][0]-t[2][0])),r=Math.max(Math.abs(t[1][1]-t[0][1]),Math.abs(t[2][1]-t[3][1])),i=Math.ceil(n/e)+1,o=Math.ceil(r/e)+1,a=(i-1)*(o-1)*6,s=new Uint32Array(a),u=new Float32Array(i*o*2),c=new Float64Array(i*o*3),l=0,h=0,f=0;f<i;f++)for(var p=f/(i-1),d=0;d<o;d++){var A=d/(o-1),g=I(t,p,A);c[3*l+0]=g[0],c[3*l+1]=g[1],c[3*l+2]=g[2]||0,u[2*l+0]=p,u[2*l+1]=1-A,f>0&&d>0&&(s[h++]=l-o,s[h++]=l-o-1,s[h++]=l-1,s[h++]=l-o,s[h++]=l-1,s[h++]=l),l++}return{vertexCount:a,positions:c,indices:s,texCoords:u}}function I(t,e,n){return Object(T.g)(Object(T.g)(t[0],t[1],n),Object(T.g)(t[3],t[2],n),e)}var B="\n#define SHADER_NAME bitmap-layer-fragment-shader\n\n#ifdef GL_ES\nprecision highp float;\n#endif\n\nuniform sampler2D bitmapTexture;\n\nvarying vec2 vTexCoord;\nvarying vec2 vTexPos;\n\nuniform float desaturate;\nuniform vec4 transparentColor;\nuniform vec3 tintColor;\nuniform float opacity;\n\nuniform float coordinateConversion;\nuniform vec4 bounds;\n\n/* projection utils */\nconst float TILE_SIZE = 512.0;\nconst float PI = 3.1415926536;\nconst float WORLD_SCALE = TILE_SIZE / PI / 2.0;\n\n// from degrees to Web Mercator\nvec2 lnglat_to_mercator(vec2 lnglat) {\n  float x = lnglat.x;\n  float y = clamp(lnglat.y, -89.9, 89.9);\n  return vec2(\n    radians(x) + PI,\n    PI + log(tan(PI * 0.25 + radians(y) * 0.5))\n  ) * WORLD_SCALE;\n}\n\n// from Web Mercator to degrees\nvec2 mercator_to_lnglat(vec2 xy) {\n  xy /= WORLD_SCALE;\n  return degrees(vec2(\n    xy.x - PI,\n    atan(exp(xy.y - PI)) * 2.0 - PI * 0.5\n  ));\n}\n/* End projection utils */\n\n// apply desaturation\nvec3 color_desaturate(vec3 color) {\n  float luminance = (color.r + color.g + color.b) * 0.333333333;\n  return mix(color, vec3(luminance), desaturate);\n}\n\n// apply tint\nvec3 color_tint(vec3 color) {\n  return color * tintColor;\n}\n\n// blend with background color\nvec4 apply_opacity(vec3 color, float alpha) {\n  if (transparentColor.a == 0.0) {\n    return vec4(color, alpha);\n  }\n  float blendedAlpha = alpha + transparentColor.a * (1.0 - alpha);\n  float highLightRatio = alpha / blendedAlpha;\n  vec3 blendedRGB = mix(transparentColor.rgb, color, highLightRatio);\n  return vec4(blendedRGB, blendedAlpha);\n}\n\nvec2 getUV(vec2 pos) {\n  return vec2(\n    (pos.x - bounds[0]) / (bounds[2] - bounds[0]),\n    (pos.y - bounds[3]) / (bounds[1] - bounds[3])\n  );\n}\n\n".concat("\nvec3 packUVsIntoRGB(vec2 uv) {\n  // Extract the top 8 bits. We want values to be truncated down so we can add a fraction\n  vec2 uv8bit = floor(uv * 256.);\n\n  // Calculate the normalized remainders of u and v parts that do not fit into 8 bits\n  // Scale and clamp to 0-1 range\n  vec2 uvFraction = fract(uv * 256.);\n  vec2 uvFraction4bit = floor(uvFraction * 16.);\n\n  // Remainder can be encoded in blue channel, encode as 4 bits for pixel coordinates\n  float fractions = uvFraction4bit.x + uvFraction4bit.y * 16.;\n\n  return vec3(uv8bit, fractions) / 255.;\n}\n","\n\nvoid main(void) {\n  vec2 uv = vTexCoord;\n  if (coordinateConversion < -0.5) {\n    vec2 lnglat = mercator_to_lnglat(vTexPos);\n    uv = getUV(lnglat);\n  } else if (coordinateConversion > 0.5) {\n    vec2 commonPos = lnglat_to_mercator(vTexPos);\n    uv = getUV(commonPos);\n  }\n  vec4 bitmapColor = texture2D(bitmapTexture, uv);\n\n  gl_FragColor = apply_opacity(color_tint(color_desaturate(bitmapColor.rgb)), bitmapColor.a * opacity);\n\n  geometry.uv = uv;\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n\n  if (picking_uActive) {\n    // Since instance information is not used, we can use picking color for pixel index\n    gl_FragColor.rgb = packUVsIntoRGB(uv);\n  }\n}\n");function R(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function k(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?R(Object(n),!0).forEach((function(e){v()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):R(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function D(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=m()(t);if(e){var i=m()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return A()(this,n)}}var L={image:{type:"image",value:null,async:!0},bounds:{type:"array",value:[1,0,0,1],compare:!0},_imageCoordinateSystem:_.a.DEFAULT,desaturate:{type:"number",min:0,max:1,value:0},transparentColor:{type:"color",value:[0,0,0,0]},tintColor:{type:"color",value:[255,255,255]}},j=function(t){p()(n,t);var e=D(n);function n(){return s()(this,n),e.apply(this,arguments)}return c()(n,[{key:"getShaders",value:function(){return h()(m()(n.prototype),"getShaders",this).call(this,{vs:"\n#define SHADER_NAME bitmap-layer-vertex-shader\n\nattribute vec2 texCoords;\nattribute vec3 positions;\nattribute vec3 positions64Low;\n\nvarying vec2 vTexCoord;\nvarying vec2 vTexPos;\n\nuniform float coordinateConversion;\n\nconst vec3 pickingColor = vec3(1.0, 0.0, 0.0);\n\nvoid main(void) {\n  geometry.worldPosition = positions;\n  geometry.uv = texCoords;\n  geometry.pickingColor = pickingColor;\n\n  gl_Position = project_position_to_clipspace(positions, positions64Low, vec3(0.0), geometry.position);\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  vTexCoord = texCoords;\n\n  if (coordinateConversion < -0.5) {\n    vTexPos = geometry.position.xy + project_uCommonOrigin.xy;\n  } else if (coordinateConversion > 0.5) {\n    vTexPos = geometry.worldPosition.xy;\n  }\n\n  vec4 color = vec4(0.0);\n  DECKGL_FILTER_COLOR(color, geometry);\n}\n",fs:B,modules:[b.a,x.a]})}},{key:"initializeState",value:function(){var t=this,e=this.getAttributeManager();e.remove(["instancePickingColors"]);e.add({indices:{size:1,isIndexed:!0,update:function(e){return e.value=t.state.mesh.indices},noAlloc:!0},positions:{size:3,type:5130,fp64:this.use64bitPositions(),update:function(e){return e.value=t.state.mesh.positions},noAlloc:!0},texCoords:{size:2,update:function(e){return e.value=t.state.mesh.texCoords},noAlloc:!0}})}},{key:"updateState",value:function(t){var e=t.props,n=t.oldProps,r=t.changeFlags,i=this.getAttributeManager();if(r.extensionsChanged){var o,a=this.context.gl;null===(o=this.state.model)||void 0===o||o.delete(),this.state.model=this._getModel(a),i.invalidateAll()}if(e.bounds!==n.bounds){var s=this.state.mesh,u=this._createMesh();for(var c in this.state.model.setVertexCount(u.vertexCount),u)s&&s[c]!==u[c]&&i.invalidate(c);this.setState(k({mesh:u},this._getCoordinateUniforms()))}else e._imageCoordinateSystem!==n._imageCoordinateSystem&&this.setState(this._getCoordinateUniforms())}},{key:"getPickingInfo",value:function(t){var e=this.props.image,n=t.info;if(!n.color||!e)return n.bitmap=null,n;var r=e,i=r.width,a=r.height;n.index=0;var s,u,c,l,h,f=(s=n.color,u=o()(s,3),c=u[0],l=u[1],h=u[2],[(c+(15&h)/16)/256,(l+(240&h)/256)/256]),p=[Math.floor(f[0]*i),Math.floor(f[1]*a)];return n.bitmap={size:{width:i,height:a},uv:f,pixel:p},n}},{key:"disablePickingIndex",value:function(){this.setState({disablePicking:!0})}},{key:"restorePickingColors",value:function(){this.setState({disablePicking:!1})}},{key:"_updateAutoHighlight",value:function(t){h()(m()(n.prototype),"_updateAutoHighlight",this).call(this,k(k({},t),{},{color:this.encodePickingColor(0)}))}},{key:"_createMesh",value:function(){var t=this.props.bounds,e=t;return F(t)&&(e=[[t[0],t[1]],[t[0],t[3]],[t[2],t[3]],[t[2],t[1]]]),M(e,this.context.viewport.resolution)}},{key:"_getModel",value:function(t){return t?new E.a(t,k(k({},this.getShaders()),{},{id:this.props.id,geometry:new O.a({drawMode:4,vertexCount:6}),isInstanced:!1})):null}},{key:"draw",value:function(t){var e=t.uniforms,n=t.moduleParameters,r=this.state,i=r.model,o=r.coordinateConversion,a=r.bounds,s=r.disablePicking,u=this.props,c=u.image,l=u.desaturate,h=u.transparentColor,f=u.tintColor;n.pickingActive&&s||c&&i&&i.setUniforms(e).setUniforms({bitmapTexture:c,desaturate:l,transparentColor:h.map((function(t){return t/255})),tintColor:f.slice(0,3).map((function(t){return t/255})),coordinateConversion:o,bounds:a}).draw()}},{key:"_getCoordinateUniforms",value:function(){var t=_.a.LNGLAT,e=_.a.CARTESIAN,n=_.a.DEFAULT,r=this.props._imageCoordinateSystem;if(r!==n){var i=this.props.bounds;if(!F(i))throw new Error("_imageCoordinateSystem only supports rectangular bounds");var o=this.context.viewport.resolution?t:e;if((r=r===t?t:e)===t&&o===e)return{coordinateConversion:-1,bounds:i};if(r===e&&o===t){var a=Object(S.l)([i[0],i[1]]),s=Object(S.l)([i[2],i[3]]);return{coordinateConversion:1,bounds:[a[0],a[1],s[0],s[1]]}}}return{coordinateConversion:0,bounds:[0,0,0,0]}}}]),n}(w.a);function F(t){return Number.isFinite(t[0])}v()(j,"layerName","BitmapLayer"),v()(j,"defaultProps",L);var z=n(118),U=n(231),N=n(232),G=n(168),V=n(167),H=n(223),W=n(117),q=n(224),X=n(229),Z=n(166),J=n(116),Q=n(171),K=n(169);n.d(e,"ArcLayer",(function(){return r.a})),n.d(e,"BitmapLayer",(function(){return j})),n.d(e,"IconLayer",(function(){return z.a})),n.d(e,"LineLayer",(function(){return U.a})),n.d(e,"PointCloudLayer",(function(){return N.a})),n.d(e,"ScatterplotLayer",(function(){return G.a})),n.d(e,"ColumnLayer",(function(){return V.a})),n.d(e,"GridCellLayer",(function(){return H.a})),n.d(e,"PathLayer",(function(){return W.a})),n.d(e,"PolygonLayer",(function(){return q.a})),n.d(e,"GeoJsonLayer",(function(){return X.a})),n.d(e,"TextLayer",(function(){return Z.a})),n.d(e,"SolidPolygonLayer",(function(){return J.a})),n.d(e,"_MultiIconLayer",(function(){return Q.a})),n.d(e,"_TextBackgroundLayer",(function(){return K.a}))},function(t,e,n){"use strict";function r(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:function(){return!0};return Array.isArray(t)?i(t,e,[]):e(t)?[t]:[]}function i(t,e,n){for(var r=-1;++r<t.length;){var o=t[r];Array.isArray(o)?i(o,e,n):e(o)&&n.push(o)}return n}function o(t){for(var e=t.target,n=t.source,r=t.start,i=void 0===r?0:r,o=t.count,a=void 0===o?1:o,s=n.length,u=a*s,c=0,l=i;c<s;c++)e[l++]=n[c];for(;c<u;)c<u-c?(e.copyWithin(i+c,i,i+c),c*=2):(e.copyWithin(i+c,i,i+u-c),c=u);return e}n.d(e,"b",(function(){return r})),n.d(e,"a",(function(){return o}))},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(0),u=n.n(s),c=function(){function t(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};i()(this,t),u()(this,"_pool",[]),u()(this,"opts",{overAlloc:2,poolSize:100}),this.setOptions(e)}return a()(t,[{key:"setOptions",value:function(t){Object.assign(this.opts,t)}},{key:"allocate",value:function(t,e,n){var r=n.size,i=void 0===r?1:r,o=n.type,a=n.padding,s=void 0===a?0:a,u=n.copy,c=void 0!==u&&u,l=n.initialize,h=void 0!==l&&l,f=n.maxCount,p=o||t&&t.constructor||Float32Array,d=e*i+s;if(ArrayBuffer.isView(t)){if(d<=t.length)return t;if(d*t.BYTES_PER_ELEMENT<=t.buffer.byteLength)return new p(t.buffer,0,d)}var A=1/0;f&&(A=f*i+s);var g=this._allocate(p,d,h,A);return t&&c?g.set(t):h||g.fill(0,0,4),this._release(t),g}},{key:"release",value:function(t){this._release(t)}},{key:"_allocate",value:function(t,e,n,r){var i=Math.max(Math.ceil(e*this.opts.overAlloc),1);i>r&&(i=r);var o=this._pool,a=t.BYTES_PER_ELEMENT*i,s=o.findIndex((function(t){return t.byteLength>=a}));if(s>=0){var u=new t(o.splice(s,1)[0],0,i);return n&&u.fill(0),u}return new t(i)}},{key:"_release",value:function(t){if(ArrayBuffer.isView(t)){var e=this._pool,n=t.buffer,r=n.byteLength,i=e.findIndex((function(t){return t.byteLength>=r}));i<0?e.push(n):(i>0||e.length<this.opts.poolSize)&&e.splice(i,0,n),e.length>this.opts.poolSize&&e.shift()}}}]),t}();e.a=new c},function(t,e){function n(t,e,n,r,i,o,a){try{var s=t[o](a),u=s.value}catch(t){return void n(t)}s.done?e(u):Promise.resolve(u).then(r,i)}t.exports=function(t){return function(){var e=this,r=arguments;return new Promise((function(i,o){var a=t.apply(e,r);function s(t){n(a,i,o,s,u,"next",t)}function u(t){n(a,i,o,s,u,"throw",t)}s(void 0)}))}}},function(t,e,n){"use strict";n.d(e,"a",(function(){return r})),n.d(e,"b",(function(){return i})),n.d(e,"d",(function(){return o})),n.d(e,"c",(function(){return a}));n(15);function r(t,e){var n=e[0],r=e[1],i=e[2],o=e[3],a=e[4],s=e[5],u=e[6],c=e[7],l=e[8],h=e[9],f=e[10],p=e[11],d=e[12],A=e[13],g=e[14],m=e[15],y=n*s-r*a,v=n*u-i*a,_=n*c-o*a,b=r*u-i*s,x=r*c-o*s,w=i*c-o*u,E=l*A-h*d,O=l*g-f*d,S=l*m-p*d,T=h*g-f*A,C=h*m-p*A,P=f*m-p*g,M=y*P-v*C+_*T+b*S-x*O+w*E;return M?(M=1/M,t[0]=(s*P-u*C+c*T)*M,t[1]=(i*C-r*P-o*T)*M,t[2]=(A*w-g*x+m*b)*M,t[3]=(f*x-h*w-p*b)*M,t[4]=(u*S-a*P-c*O)*M,t[5]=(n*P-i*S+o*O)*M,t[6]=(g*_-d*w-m*v)*M,t[7]=(l*w-f*_+p*v)*M,t[8]=(a*C-s*S+c*E)*M,t[9]=(r*S-n*C-o*E)*M,t[10]=(d*x-A*_+m*y)*M,t[11]=(h*_-l*x-p*y)*M,t[12]=(s*O-a*T-u*E)*M,t[13]=(n*T-r*O+i*E)*M,t[14]=(A*v-d*b-g*y)*M,t[15]=(l*b-h*v+f*y)*M,t):null}function i(t,e,n){var r=e[0],i=e[1],o=e[2],a=e[3],s=e[4],u=e[5],c=e[6],l=e[7],h=e[8],f=e[9],p=e[10],d=e[11],A=e[12],g=e[13],m=e[14],y=e[15],v=n[0],_=n[1],b=n[2],x=n[3];return t[0]=v*r+_*s+b*h+x*A,t[1]=v*i+_*u+b*f+x*g,t[2]=v*o+_*c+b*p+x*m,t[3]=v*a+_*l+b*d+x*y,v=n[4],_=n[5],b=n[6],x=n[7],t[4]=v*r+_*s+b*h+x*A,t[5]=v*i+_*u+b*f+x*g,t[6]=v*o+_*c+b*p+x*m,t[7]=v*a+_*l+b*d+x*y,v=n[8],_=n[9],b=n[10],x=n[11],t[8]=v*r+_*s+b*h+x*A,t[9]=v*i+_*u+b*f+x*g,t[10]=v*o+_*c+b*p+x*m,t[11]=v*a+_*l+b*d+x*y,v=n[12],_=n[13],b=n[14],x=n[15],t[12]=v*r+_*s+b*h+x*A,t[13]=v*i+_*u+b*f+x*g,t[14]=v*o+_*c+b*p+x*m,t[15]=v*a+_*l+b*d+x*y,t}function o(t,e,n){var r,i,o,a,s,u,c,l,h,f,p,d,A=n[0],g=n[1],m=n[2];return e===t?(t[12]=e[0]*A+e[4]*g+e[8]*m+e[12],t[13]=e[1]*A+e[5]*g+e[9]*m+e[13],t[14]=e[2]*A+e[6]*g+e[10]*m+e[14],t[15]=e[3]*A+e[7]*g+e[11]*m+e[15]):(r=e[0],i=e[1],o=e[2],a=e[3],s=e[4],u=e[5],c=e[6],l=e[7],h=e[8],f=e[9],p=e[10],d=e[11],t[0]=r,t[1]=i,t[2]=o,t[3]=a,t[4]=s,t[5]=u,t[6]=c,t[7]=l,t[8]=h,t[9]=f,t[10]=p,t[11]=d,t[12]=r*A+s*g+h*m+e[12],t[13]=i*A+u*g+f*m+e[13],t[14]=o*A+c*g+p*m+e[14],t[15]=a*A+l*g+d*m+e[15]),t}function a(t,e,n){var r=n[0],i=n[1],o=n[2];return t[0]=e[0]*r,t[1]=e[1]*r,t[2]=e[2]*r,t[3]=e[3]*r,t[4]=e[4]*i,t[5]=e[5]*i,t[6]=e[6]*i,t[7]=e[7]*i,t[8]=e[8]*o,t[9]=e[9]*o,t[10]=e[10]*o,t[11]=e[11]*o,t[12]=e[12],t[13]=e[13],t[14]=e[14],t[15]=e[15],t}},function(t,e){var n;n=function(){return this}();try{n=n||new Function("return this")()}catch(t){"object"==typeof window&&(n=window)}t.exports=n},function(t,e,n){"use strict";(function(t,r){n.d(e,"e",(function(){return o})),n.d(e,"f",(function(){return a})),n.d(e,"b",(function(){return s})),n.d(e,"a",(function(){return u})),n.d(e,"c",(function(){return c})),n.d(e,"d",(function(){return l}));const i={self:"undefined"!=typeof self&&self,window:"undefined"!=typeof window&&window,global:void 0!==t&&t,document:"undefined"!=typeof document&&document},o=i.self||i.window||i.global||{},a=i.window||i.self||i.global||{},s=i.global||i.self||i.window||{},u=i.document||{},c=Boolean("object"!=typeof r||"[object process]"!==String(r)||r.browser),l="function"==typeof importScripts,h=void 0!==r&&r.version&&/v([0-9]*)/.exec(r.version);h&&parseFloat(h[1])}).call(this,n(71),n(44))},function(t,e,n){"use strict";n.d(e,"a",(function(){return w}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(27),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(178),y=n(7),v=n(188);function _(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return b(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return b(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function b(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function x(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}var w=function(t){l()(n,t);var e=x(n);function n(){var t;i()(this,n);for(var r=arguments.length,o=new Array(r),a=0;a<r;a++)o[a]=arguments[a];return t=e.call.apply(e,[this].concat(o)),g()(u()(t),"_lastRenderIndex",-1),t}return a()(n,[{key:"render",value:function(t){var e=this.gl;return Object(y.n)(e,{framebuffer:t.target}),this._drawLayers(t)}},{key:"_drawLayers",value:function(t){var e=t.target,n=t.moduleParameters,r=t.viewports,i=t.views,o=t.onViewportActive,a=t.clearStack,s=void 0===a||a,u=t.clearCanvas,c=void 0===u||u;t.pass=t.pass||"unknown";var l=this.gl;c&&function(t){var e=t.drawingBufferWidth,n=t.drawingBufferHeight;Object(y.n)(t,{viewport:[0,0,e,n]}),t.clear(16640)}(l),s&&(this._lastRenderIndex=-1);var h,f=[],p=_(r);try{for(p.s();!(h=p.n()).done;){var d=h.value,A=i&&i[d.id];o(d);var g,m=this._getDrawLayerParams(d,t),v=_(d.subViewports||[d]);try{for(v.s();!(g=v.n()).done;){var b=g.value,x=this._drawLayersInViewport(l,{target:e,moduleParameters:n,viewport:b,view:A,pass:t.pass,layers:t.layers},m);f.push(x)}}catch(t){v.e(t)}finally{v.f()}}}catch(t){p.e(t)}finally{p.f()}return f}},{key:"_getDrawLayerParams",value:function(t,e){for(var n=e.layers,r=e.pass,i=e.layerFilter,o=e.cullRect,a=e.effects,s=e.moduleParameters,u=[],c=function t(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:0,n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},r={},i=function i(o,a){var s,u=o.props._offset,c=o.id,l=o.parent&&o.parent.id;if(l&&!(l in n)&&i(o.parent,!1),l in r){var h=r[l]=r[l]||t(n[l],n);s=h(o,a),r[c]=h}else Number.isFinite(u)?(s=u+(n[l]||0),r[c]=null):s=e;return a&&s>=e&&(e=s+1),n[c]=s,s};return i}(this._lastRenderIndex+1),l={layer:n[0],viewport:t,isPicking:r.startsWith("picking"),renderPass:r,cullRect:o},h={},f=0;f<n.length;f++){var p=n[f],d=this._shouldDrawLayer(p,l,i,h),A={shouldDrawLayer:d};d&&(A.layerRenderIndex=c(p,d),A.moduleParameters=this._getModuleParameters(p,a,r,s),A.layerParameters=this.getLayerParameters(p,f,t)),u[f]=A}return u}},{key:"_drawLayersInViewport",value:function(t,e,n){var r=e.layers,i=e.moduleParameters,o=e.pass,a=e.target,s=e.viewport,u=e.view,c=function(t,e){var n=e.moduleParameters,r=e.target,i=e.viewport,o=r&&"default-framebuffer"!==r.id,a=n&&n.devicePixelRatio||Object(y.e)(t),s=o?r.height:t.drawingBufferHeight,u=i;return[u.x*a,s-(u.y+u.height)*a,u.width*a,u.height*a]}(t,{moduleParameters:i,target:a,viewport:s});if(u&&u.props.clear){var l=!0===u.props.clear?{color:!0,depth:!0}:u.props.clear;Object(y.o)(t,{scissorTest:!0,scissor:c},(function(){return Object(v.a)(t,l)}))}var h={totalCount:r.length,visibleCount:0,compositeCount:0,pickableCount:0};Object(y.n)(t,{viewport:c});for(var f=0;f<r.length;f++){var p=r[f],d=n[f],A=d.shouldDrawLayer,g=d.layerRenderIndex,m=d.moduleParameters,_=d.layerParameters;if(A&&p.props.pickable&&h.pickableCount++,p.isComposite)h.compositeCount++;else if(A){h.visibleCount++,this._lastRenderIndex=Math.max(this._lastRenderIndex,g),m.viewport=s;try{p._drawLayer({moduleParameters:m,uniforms:{layerIndex:g},parameters:_})}catch(t){p.raiseError(t,"drawing ".concat(p," to ").concat(o))}}}return h}},{key:"shouldDrawLayer",value:function(t){return!0}},{key:"getModuleParameters",value:function(t,e){return null}},{key:"getLayerParameters",value:function(t,e,n){return t.props.parameters}},{key:"_shouldDrawLayer",value:function(t,e,n,r){if(!(t.props.visible&&this.shouldDrawLayer(t)))return!1;e.layer=t;for(var i=t.parent;i;){if(!i.props.visible||!i.filterSubLayer(e))return!1;e.layer=i,i=i.parent}if(n){var o=e.layer.id;if(o in r||(r[o]=n(e)),!r[o])return!1}return t.activateViewport(e.viewport),!0}},{key:"_getModuleParameters",value:function(t,e,n,r){var i,o=Object.assign(Object.create((null===(i=t.internalState)||void 0===i?void 0:i.propsInTransition)||t.props),{autoWrapLongitude:t.wrapLongitude,viewport:t.context.viewport,mousePosition:t.context.mousePosition,pickingActive:0,devicePixelRatio:Object(y.e)(this.gl)});if(e){var a,s=_(e);try{for(s.s();!(a=s.n()).done;){var u,c=a.value;Object.assign(o,null===(u=c.getModuleParameters)||void 0===u?void 0:u.call(c,t))}}catch(t){s.e(t)}finally{s.f()}}return Object.assign(o,this.getModuleParameters(t,e),r)}}]),n}(m.a)},function(t,e,n){"use strict";n.d(e,"a",(function(){return f}));var r=n(7),i=n(38),o=n(107),a=n(109),s=n(188),u=n(206),c=n(251),l=n(48),h=n(10);class f extends i.a{get[Symbol.toStringTag](){return"Framebuffer"}static isSupported(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};const{colorBufferFloat:n,colorBufferHalfFloat:r}=e;let i=!0;return n&&(i=Boolean(t.getExtension("EXT_color_buffer_float")||t.getExtension("WEBGL_color_buffer_float")||t.getExtension("OES_texture_float"))),r&&(i=i&&Boolean(t.getExtension("EXT_color_buffer_float")||t.getExtension("EXT_color_buffer_half_float"))),i}static getDefaultFramebuffer(t){return t.luma=t.luma||{},t.luma.defaultFramebuffer=t.luma.defaultFramebuffer||new f(t,{id:"default-framebuffer",handle:null,attachments:{}}),t.luma.defaultFramebuffer}get MAX_COLOR_ATTACHMENTS(){const t=Object(r.a)(this.gl);return t.getParameter(t.MAX_COLOR_ATTACHMENTS)}get MAX_DRAW_BUFFERS(){const t=Object(r.a)(this.gl);return t.getParameter(t.MAX_DRAW_BUFFERS)}constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};super(t,e),this.width=null,this.height=null,this.attachments={},this.readBuffer=36064,this.drawBuffers=[36064],this.ownResources=[],this.initialize(e),Object.seal(this)}get color(){return this.attachments[36064]||null}get texture(){return this.attachments[36064]||null}get depth(){return this.attachments[36096]||this.attachments[33306]||null}get stencil(){return this.attachments[36128]||this.attachments[33306]||null}initialize(t){let{width:e=1,height:n=1,attachments:r=null,color:i=!0,depth:o=!0,stencil:a=!1,check:s=!0,readBuffer:u,drawBuffers:c}=t;if(Object(h.a)(e>=0&&n>=0,"Width and height need to be integers"),this.width=e,this.height=n,r)for(const t in r){const i=r[t];(Array.isArray(i)?i[0]:i).resize({width:e,height:n})}else r=this._createDefaultAttachments(i,o,a,e,n);this.update({clearAttachments:!0,attachments:r,readBuffer:u,drawBuffers:c}),r&&s&&this.checkStatus()}delete(){for(const t of this.ownResources)t.delete();return super.delete(),this}update(t){let{attachments:e={},readBuffer:n,drawBuffers:r,clearAttachments:i=!1,resizeAttachments:o=!0}=t;this.attach(e,{clearAttachments:i,resizeAttachments:o});const{gl:a}=this,s=a.bindFramebuffer(36160,this.handle);return n&&this._setReadBuffer(n),r&&this._setDrawBuffers(r),a.bindFramebuffer(36160,s||null),this}resize(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},{width:e,height:n}=t;if(null===this.handle)return Object(h.a)(void 0===e&&void 0===n),this.width=this.gl.drawingBufferWidth,this.height=this.gl.drawingBufferHeight,this;void 0===e&&(e=this.gl.drawingBufferWidth),void 0===n&&(n=this.gl.drawingBufferHeight),e!==this.width&&n!==this.height&&r.k.log(2,"Resizing framebuffer ".concat(this.id," to ").concat(e,"x").concat(n))();for(const t in this.attachments)this.attachments[t].resize({width:e,height:n});return this.width=e,this.height=n,this}attach(t){let{clearAttachments:e=!1,resizeAttachments:n=!0}=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};const r={};e&&Object.keys(this.attachments).forEach(t=>{r[t]=null}),Object.assign(r,t);const i=this.gl.bindFramebuffer(36160,this.handle);for(const t in r){Object(h.a)(void 0!==t,"Misspelled framebuffer binding point?");const e=Number(t),i=r[e];let o=i;if(o)if(o instanceof a.a)this._attachRenderbuffer({attachment:e,renderbuffer:o});else if(Array.isArray(i)){const[t,n=0,r=0]=i;o=t,this._attachTexture({attachment:e,texture:t,layer:n,level:r})}else this._attachTexture({attachment:e,texture:o,layer:0,level:0});else this._unattach(e);n&&o&&o.resize({width:this.width,height:this.height})}this.gl.bindFramebuffer(36160,i||null),Object.assign(this.attachments,t),Object.keys(this.attachments).filter(t=>!this.attachments[t]).forEach(t=>{delete this.attachments[t]})}checkStatus(){const{gl:t}=this,e=this.getStatus();if(36053!==e)throw new Error(function(t){return(f.STATUS||{})[t]||"Framebuffer error ".concat(t)}(e));return this}getStatus(){const{gl:t}=this,e=t.bindFramebuffer(36160,this.handle),n=t.checkFramebufferStatus(36160);return t.bindFramebuffer(36160,e||null),n}clear(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{color:e,depth:n,stencil:r,drawBuffers:i=[]}=t,o=this.gl.bindFramebuffer(36160,this.handle);return(e||n||r)&&Object(s.a)(this.gl,{color:e,depth:n,stencil:r}),i.forEach((t,e)=>{Object(s.b)(this.gl,{drawBuffer:e,value:t})}),this.gl.bindFramebuffer(36160,o||null),this}readPixels(){return r.k.error("Framebuffer.readPixels() is no logner supported, use readPixelsToArray(framebuffer)")(),null}readPixelsToBuffer(){return r.k.error("Framebuffer.readPixelsToBuffer()is no logner supported, use readPixelsToBuffer(framebuffer)")(),null}copyToDataUrl(){return r.k.error("Framebuffer.copyToDataUrl() is no logner supported, use copyToDataUrl(framebuffer)")(),null}copyToImage(){return r.k.error("Framebuffer.copyToImage() is no logner supported, use copyToImage(framebuffer)")(),null}copyToTexture(){return r.k.error("Framebuffer.copyToTexture({...}) is no logner supported, use copyToTexture(source, target, opts})")(),null}blit(){return r.k.error("Framebuffer.blit({...}) is no logner supported, use blit(source, target, opts)")(),null}invalidate(t){let{attachments:e=[],x:n=0,y:i=0,width:o,height:a}=t;const s=Object(r.a)(this.gl),u=s.bindFramebuffer(36008,this.handle);return 0===n&&0===i&&void 0===o&&void 0===a?s.invalidateFramebuffer(36008,e):s.invalidateFramebuffer(36008,e,n,i,o,a),s.bindFramebuffer(36008,u),this}getAttachmentParameter(t,e,n){let r=this._getAttachmentParameterFallback(e);return null===r&&(this.gl.bindFramebuffer(36160,this.handle),r=this.gl.getFramebufferAttachmentParameter(36160,t,e),this.gl.bindFramebuffer(36160,null)),n&&r>1e3&&(r=Object(l.a)(this.gl,r)),r}getAttachmentParameters(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:36064,e=arguments.length>1?arguments[1]:void 0,n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:this.constructor.ATTACHMENT_PARAMETERS||[];const r={};for(const i of n){r[e?Object(l.a)(this.gl,i):i]=this.getAttachmentParameter(t,i,e)}return r}getParameters(){let t=!(arguments.length>0&&void 0!==arguments[0])||arguments[0];const e=Object.keys(this.attachments),n={};for(const r of e){const e=Number(r);n[t?Object(l.a)(this.gl,e):e]=this.getAttachmentParameters(e,t)}return n}show(){return"undefined"!=typeof window&&window.open(Object(u.a)(this),"luma-debug-texture"),this}log(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:0,e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:"";if(t>r.k.level||"undefined"==typeof window)return this;e=e||"Framebuffer ".concat(this.id);const n=Object(u.a)(this,{targetMaxHeight:100});return r.k.image({logLevel:t,message:e,image:n},e)(),this}bind(){let{target:t=36160}=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return this.gl.bindFramebuffer(t,this.handle),this}unbind(){let{target:t=36160}=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return this.gl.bindFramebuffer(t,null),this}_createDefaultAttachments(t,e,n,r,i){let s=null;return t&&(s=s||{},s[36064]=new o.a(this.gl,{id:"".concat(this.id,"-color0"),pixels:null,format:6408,type:5121,width:r,height:i,mipmaps:!1,parameters:{10241:9729,10240:9729,10242:33071,10243:33071}}),this.ownResources.push(s[36064])),e&&n?(s=s||{},s[33306]=new a.a(this.gl,{id:"".concat(this.id,"-depth-stencil"),format:35056,width:r,height:111}),this.ownResources.push(s[33306])):e?(s=s||{},s[36096]=new a.a(this.gl,{id:"".concat(this.id,"-depth"),format:33189,width:r,height:i}),this.ownResources.push(s[36096])):n&&Object(h.a)(!1),s}_unattach(t){const e=this.attachments[t];e&&(e instanceof a.a?this.gl.framebufferRenderbuffer(36160,t,36161,null):this.gl.framebufferTexture2D(36160,t,3553,null,0),delete this.attachments[t])}_attachRenderbuffer(t){let{attachment:e=36064,renderbuffer:n}=t;const{gl:r}=this;r.framebufferRenderbuffer(36160,e,36161,n.handle),this.attachments[e]=n}_attachTexture(t){let{attachment:e=36064,texture:n,layer:i,level:o}=t;const{gl:a}=this;switch(a.bindTexture(n.target,n.handle),n.target){case 35866:case 32879:Object(r.a)(a).framebufferTextureLayer(36160,e,n.target,o,i);break;case 34067:const t=function(t){return t<34069?t+34069:t}(i);a.framebufferTexture2D(36160,e,t,n.handle,o);break;case 3553:a.framebufferTexture2D(36160,e,3553,n.handle,o);break;default:Object(h.a)(!1,"Illegal texture type")}a.bindTexture(n.target,null),this.attachments[e]=n}_setReadBuffer(t){const e=Object(r.g)(this.gl);e?e.readBuffer(t):Object(h.a)(36064===t||1029===t,"Multiple render targets not supported"),this.readBuffer=t}_setDrawBuffers(t){const{gl:e}=this,n=Object(r.a)(e);if(n)n.drawBuffers(t);else{const n=e.getExtension("WEBGL_draw_buffers");n?n.drawBuffersWEBGL(t):Object(h.a)(1===t.length&&(36064===t[0]||1029===t[0]),"Multiple render targets not supported")}this.drawBuffers=t}_getAttachmentParameterFallback(t){const e=Object(c.a)(this.gl);switch(t){case 36052:return e.WEBGL2?null:0;case 33298:case 33299:case 33300:case 33301:case 33302:case 33303:return e.WEBGL2?null:8;case 33297:return e.WEBGL2?null:5125;case 33296:return e.WEBGL2||e.EXT_sRGB?null:9729;default:return null}}_createHandle(){return this.gl.createFramebuffer()}_deleteHandle(){this.gl.deleteFramebuffer(this.handle)}_bindHandle(t){return this.gl.bindFramebuffer(36160,t)}}f.ATTACHMENT_PARAMETERS=[36049,36048,33296,33298,33299,33300,33301,33302,33303]},function(t,e,n){"use strict";n.d(e,"a",(function(){return s}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=function(){function t(e){i()(this,t),this._inProgress=!1,this._handle=null,this._timeline=e,this.time=0,this.settings={duration:0}}return a()(t,[{key:"inProgress",get:function(){return this._inProgress}},{key:"start",value:function(t){var e,n;this.cancel(),this.settings=t,this._inProgress=!0,null===(e=(n=this.settings).onStart)||void 0===e||e.call(n,this)}},{key:"end",value:function(){var t,e;this._inProgress&&(this._timeline.removeChannel(this._handle),this._handle=null,this._inProgress=!1,null===(t=(e=this.settings).onEnd)||void 0===t||t.call(e,this))}},{key:"cancel",value:function(){var t,e;this._inProgress&&(null===(t=(e=this.settings).onInterrupt)||void 0===t||t.call(e,this),this._timeline.removeChannel(this._handle),this._handle=null,this._inProgress=!1)}},{key:"update",value:function(){var t,e;if(!this._inProgress)return!1;if(null===this._handle){var n=this._timeline,r=this.settings;this._handle=n.addChannel({delay:n.getTime(),duration:r.duration})}return this.time=this._timeline.getTime(this._handle),this._onUpdate(),null===(t=(e=this.settings).onUpdate)||void 0===t||t.call(e,this),this._timeline.isFinished(this._handle)&&this.end(),!0}},{key:"_onUpdate",value:function(){}}]),t}()},function(t,e,n){"use strict";var r=n(2),i=n(137);class o{constructor(t,e){Object(r.a)(this,"name",void 0),Object(r.a)(this,"type",void 0),Object(r.a)(this,"sampleSize",1),Object(r.a)(this,"time",void 0),Object(r.a)(this,"count",void 0),Object(r.a)(this,"samples",void 0),Object(r.a)(this,"lastTiming",void 0),Object(r.a)(this,"lastSampleTime",void 0),Object(r.a)(this,"lastSampleCount",void 0),Object(r.a)(this,"_count",0),Object(r.a)(this,"_time",0),Object(r.a)(this,"_samples",0),Object(r.a)(this,"_startTime",0),Object(r.a)(this,"_timerPending",!1),this.name=t,this.type=e,this.reset()}setSampleSize(t){return this.sampleSize=t,this}incrementCount(){return this.addCount(1),this}decrementCount(){return this.subtractCount(1),this}addCount(t){return this._count+=t,this._samples++,this._checkSampling(),this}subtractCount(t){return this._count-=t,this._samples++,this._checkSampling(),this}addTime(t){return this._time+=t,this.lastTiming=t,this._samples++,this._checkSampling(),this}timeStart(){return this._startTime=Object(i.a)(),this._timerPending=!0,this}timeEnd(){return this._timerPending?(this.addTime(Object(i.a)()-this._startTime),this._timerPending=!1,this._checkSampling(),this):this}getSampleAverageCount(){return this.sampleSize>0?this.lastSampleCount/this.sampleSize:0}getSampleAverageTime(){return this.sampleSize>0?this.lastSampleTime/this.sampleSize:0}getSampleHz(){return this.lastSampleTime>0?this.sampleSize/(this.lastSampleTime/1e3):0}getAverageCount(){return this.samples>0?this.count/this.samples:0}getAverageTime(){return this.samples>0?this.time/this.samples:0}getHz(){return this.time>0?this.samples/(this.time/1e3):0}reset(){return this.time=0,this.count=0,this.samples=0,this.lastTiming=0,this.lastSampleTime=0,this.lastSampleCount=0,this._count=0,this._time=0,this._samples=0,this._startTime=0,this._timerPending=!1,this}_checkSampling(){this._samples===this.sampleSize&&(this.lastSampleTime=this._time,this.lastSampleCount=this._count,this.count+=this._count,this.time+=this._time,this.samples+=this._samples,this._time=0,this._count=0,this._samples=0)}}class a{constructor(t){Object(r.a)(this,"id",void 0),Object(r.a)(this,"stats",{}),this.id=t.id,this.stats={},this._initializeStats(t.stats),Object.seal(this)}get(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:"count";return this._getOrCreate({name:t,type:e})}get size(){return Object.keys(this.stats).length}reset(){for(const t in this.stats)this.stats[t].reset();return this}forEach(t){for(const e in this.stats)t(this.stats[e])}getTable(){const t={};return this.forEach(e=>{t[e.name]={time:e.time||0,count:e.count||0,average:e.getAverageTime()||0,hz:e.getHz()||0}}),t}_initializeStats(){(arguments.length>0&&void 0!==arguments[0]?arguments[0]:[]).forEach(t=>this._getOrCreate(t))}_getOrCreate(t){if(!t||!t.name)return null;const{name:e,type:n}=t;return this.stats[e]||(this.stats[e]=t instanceof o?t:new o(e,n)),this.stats[e]}}n.d(e,"a",(function(){return a}))},function(t,e,n){"use strict";n.d(e,"b",(function(){return r})),n.d(e,"a",(function(){return i}));const r="vs",i="fs"},function(t,e,n){"use strict";n.d(e,"a",(function(){return g}));var r,i=n(177),o=n(23),a=n(55),s=n(26),u=n(34),c=n(25),l=n(36);!function(t){t[t.COL0ROW0=0]="COL0ROW0",t[t.COL0ROW1=1]="COL0ROW1",t[t.COL0ROW2=2]="COL0ROW2",t[t.COL0ROW3=3]="COL0ROW3",t[t.COL1ROW0=4]="COL1ROW0",t[t.COL1ROW1=5]="COL1ROW1",t[t.COL1ROW2=6]="COL1ROW2",t[t.COL1ROW3=7]="COL1ROW3",t[t.COL2ROW0=8]="COL2ROW0",t[t.COL2ROW1=9]="COL2ROW1",t[t.COL2ROW2=10]="COL2ROW2",t[t.COL2ROW3=11]="COL2ROW3",t[t.COL3ROW0=12]="COL3ROW0",t[t.COL3ROW1=13]="COL3ROW1",t[t.COL3ROW2=14]="COL3ROW2",t[t.COL3ROW3=15]="COL3ROW3"}(r||(r={}));const h=45*Math.PI/180,f=1,p=.1,d=500,A=Object.freeze([1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,1]);class g extends i.a{static get IDENTITY(){return function(){y||(y=new g,Object.freeze(y));return y}()}static get ZERO(){return function(){m||(m=new g([0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]),Object.freeze(m));return m}()}get ELEMENTS(){return 16}get RANK(){return 4}get INDICES(){return r}constructor(t){super(-0,-0,-0,-0,-0,-0,-0,-0,-0,-0,-0,-0,-0,-0,-0,-0),1===arguments.length&&Array.isArray(t)?this.copy(t):this.identity()}copy(t){return this[0]=t[0],this[1]=t[1],this[2]=t[2],this[3]=t[3],this[4]=t[4],this[5]=t[5],this[6]=t[6],this[7]=t[7],this[8]=t[8],this[9]=t[9],this[10]=t[10],this[11]=t[11],this[12]=t[12],this[13]=t[13],this[14]=t[14],this[15]=t[15],this.check()}set(t,e,n,r,i,o,a,s,u,c,l,h,f,p,d,A){return this[0]=t,this[1]=e,this[2]=n,this[3]=r,this[4]=i,this[5]=o,this[6]=a,this[7]=s,this[8]=u,this[9]=c,this[10]=l,this[11]=h,this[12]=f,this[13]=p,this[14]=d,this[15]=A,this.check()}setRowMajor(t,e,n,r,i,o,a,s,u,c,l,h,f,p,d,A){return this[0]=t,this[1]=i,this[2]=u,this[3]=f,this[4]=e,this[5]=o,this[6]=c,this[7]=p,this[8]=n,this[9]=a,this[10]=l,this[11]=d,this[12]=r,this[13]=s,this[14]=h,this[15]=A,this.check()}toRowMajor(t){return t[0]=this[0],t[1]=this[4],t[2]=this[8],t[3]=this[12],t[4]=this[1],t[5]=this[5],t[6]=this[9],t[7]=this[13],t[8]=this[2],t[9]=this[6],t[10]=this[10],t[11]=this[14],t[12]=this[3],t[13]=this[7],t[14]=this[11],t[15]=this[15],t}identity(){return this.copy(A)}fromObject(t){return this.check()}fromQuaternion(t){return s.c(this,t),this.check()}frustum(t){const{left:e,right:n,bottom:r,top:i,near:o=p,far:a=d}=t;return a===1/0?function(t,e,n,r,i,o){const a=2*o/(n-e),s=2*o/(i-r),u=(n+e)/(n-e),c=(i+r)/(i-r),l=-2*o;t[0]=a,t[1]=0,t[2]=0,t[3]=0,t[4]=0,t[5]=s,t[6]=0,t[7]=0,t[8]=u,t[9]=c,t[10]=-1,t[11]=-1,t[12]=0,t[13]=0,t[14]=l,t[15]=0}(this,e,n,r,i,o):s.d(this,e,n,r,i,o,a),this.check()}lookAt(t){const{eye:e,center:n=[0,0,0],up:r=[0,1,0]}=t;return s.g(this,e,n,r),this.check()}ortho(t){const{left:e,right:n,bottom:r,top:i,near:o=p,far:a=d}=t;return s.i(this,e,n,r,i,o,a),this.check()}orthographic(t){const{fovy:e=h,aspect:n=f,focalDistance:r=1,near:i=p,far:o=d}=t;v(e);const a=e/2,s=r*Math.tan(a),u=s*n;return this.ortho({left:-u,right:u,bottom:-s,top:s,near:i,far:o})}perspective(t){const{fovy:e=45*Math.PI/180,aspect:n=1,near:r=.1,far:i=500}=t;return v(e),s.j(this,e,n,r,i),this.check()}determinant(){return s.a(this)}getScale(t=[-0,-0,-0]){return t[0]=Math.sqrt(this[0]*this[0]+this[1]*this[1]+this[2]*this[2]),t[1]=Math.sqrt(this[4]*this[4]+this[5]*this[5]+this[6]*this[6]),t[2]=Math.sqrt(this[8]*this[8]+this[9]*this[9]+this[10]*this[10]),t}getTranslation(t=[-0,-0,-0]){return t[0]=this[12],t[1]=this[13],t[2]=this[14],t}getRotation(t,e){t=t||[-0,-0,-0,-0,-0,-0,-0,-0,-0,-0,-0,-0,-0,-0,-0,-0],e=e||[-0,-0,-0];const n=this.getScale(e),r=1/n[0],i=1/n[1],o=1/n[2];return t[0]=this[0]*r,t[1]=this[1]*i,t[2]=this[2]*o,t[3]=0,t[4]=this[4]*r,t[5]=this[5]*i,t[6]=this[6]*o,t[7]=0,t[8]=this[8]*r,t[9]=this[9]*i,t[10]=this[10]*o,t[11]=0,t[12]=0,t[13]=0,t[14]=0,t[15]=1,t}getRotationMatrix3(t,e){t=t||[-0,-0,-0,-0,-0,-0,-0,-0,-0],e=e||[-0,-0,-0];const n=this.getScale(e),r=1/n[0],i=1/n[1],o=1/n[2];return t[0]=this[0]*r,t[1]=this[1]*i,t[2]=this[2]*o,t[3]=this[4]*r,t[4]=this[5]*i,t[5]=this[6]*o,t[6]=this[8]*r,t[7]=this[9]*i,t[8]=this[10]*o,t}transpose(){return s.q(this,this),this.check()}invert(){return s.f(this,this),this.check()}multiplyLeft(t){return s.h(this,t,this),this.check()}multiplyRight(t){return s.h(this,this,t),this.check()}rotateX(t){return s.l(this,this,t),this.check()}rotateY(t){return s.m(this,this,t),this.check()}rotateZ(t){return s.n(this,this,t),this.check()}rotateXYZ(t){return this.rotateX(t[0]).rotateY(t[1]).rotateZ(t[2])}rotateAxis(t,e){return s.k(this,this,t,e),this.check()}scale(t){return s.o(this,this,Array.isArray(t)?t:[t,t,t]),this.check()}translate(t){return s.p(this,this,t),this.check()}transform(t,e){return 4===t.length?(e=l.n(e||[-0,-0,-0,-0],t,this),Object(o.b)(e,4),e):this.transformAsPoint(t,e)}transformAsPoint(t,e){const{length:n}=t;let r;switch(n){case 2:r=u.j(e||[-0,-0],t,this);break;case 3:r=c.p(e||[-0,-0,-0],t,this);break;default:throw new Error("Illegal vector")}return Object(o.b)(r,t.length),r}transformAsVector(t,e){let n;switch(t.length){case 2:n=Object(a.a)(e||[-0,-0],t,this);break;case 3:n=Object(a.c)(e||[-0,-0,-0],t,this);break;default:throw new Error("Illegal vector")}return Object(o.b)(n,t.length),n}transformPoint(t,e){return this.transformAsPoint(t,e)}transformVector(t,e){return this.transformAsPoint(t,e)}transformDirection(t,e){return this.transformAsVector(t,e)}makeRotationX(t){return this.identity().rotateX(t)}makeTranslation(t,e,n){return this.identity().translate([t,e,n])}}let m,y;function v(t){if(t>2*Math.PI)throw Error("expected radians")}},function(t,e,n){"use strict";var r=n(20),i=n(85),o=n(45);const a=new(n(298).a)({id:"loaders.gl"});var s=n(62),u=n(112),c=n(22);n.d(e,"a",(function(){return h})),n.d(e,"b",(function(){return f}));const l=/\.([^.]+)$/;async function h(t,e=[],n,r){if(!p(t))return null;let i=f(t,e,{...n,nothrow:!0},r);if(i)return i;if(Object(c.b)(t)&&(i=f(t=await t.slice(0,10).arrayBuffer(),e,n,r)),!(i||null!=n&&n.nothrow))throw new Error(d(t));return i}function f(t,e=[],n,r){if(!p(t))return null;if(e&&!Array.isArray(e))return Object(o.b)(e);let i=[];e&&(i=i.concat(e)),null!=n&&n.ignoreRegisteredLoaders||i.push(...Object(u.b)()),function(t){for(const e of t)Object(o.b)(e)}(i);const c=function(t,e,n,r){const{url:i,type:o}=Object(s.b)(t),u=i||(null==r?void 0:r.url);let c=null,h="";null!=n&&n.mimeType&&(c=A(e,null==n?void 0:n.mimeType),h="match forced by supplied MIME type ".concat(null==n?void 0:n.mimeType));var f;c=c||function(t,e){const n=e&&l.exec(e),r=n&&n[1];return r?function(t,e){e=e.toLowerCase();for(const n of t)for(const t of n.extensions)if(t.toLowerCase()===e)return n;return null}(t,r):null}(e,u),h=h||(c?"matched url ".concat(u):""),c=c||A(e,o),h=h||(c?"matched MIME type ".concat(o):""),c=c||function(t,e){if(!e)return null;for(const n of t)if("string"==typeof e){if(g(e,n))return n}else if(ArrayBuffer.isView(e)){if(m(e.buffer,e.byteOffset,n))return n}else if(e instanceof ArrayBuffer){if(m(e,0,n))return n}return null}(e,t),h=h||(c?"matched initial data ".concat(y(t)):""),c=c||A(e,null==n?void 0:n.fallbackMimeType),h=h||(c?"matched fallback MIME type ".concat(o):""),h&&a.log(1,"selectLoader selected ".concat(null===(f=c)||void 0===f?void 0:f.name,": ").concat(h,"."));return c}(t,i,n,r);if(!(c||null!=n&&n.nothrow))throw new Error(d(t));return c}function p(t){return!(t instanceof Response&&204===t.status)}function d(t){const{url:e,type:n}=Object(s.b)(t);let i="No valid loader found (";i+=e?"".concat(r.b.filename(e),", "):"no url provided, ",i+="MIME type: ".concat(n?'"'.concat(n,'"'):"not provided",", ");const o=t?y(t):"";return i+=o?' first bytes: "'.concat(o,'"'):"first bytes: not available",i+=")",i}function A(t,e){for(const n of t){if(n.mimeTypes&&n.mimeTypes.includes(e))return n;if(e==="application/x.".concat(n.id))return n}return null}function g(t,e){if(e.testText)return e.testText(t);return(Array.isArray(e.tests)?e.tests:[e.tests]).some(e=>t.startsWith(e))}function m(t,e,n){return(Array.isArray(n.tests)?n.tests:[n.tests]).some(r=>function(t,e,n,r){if(r instanceof ArrayBuffer)return Object(i.a)(r,t,r.byteLength);switch(typeof r){case"function":return r(t,n);case"string":const i=v(t,e,r.length);return r===i;default:return!1}}(t,e,n,r))}function y(t,e=5){if("string"==typeof t)return t.slice(0,e);if(ArrayBuffer.isView(t))return v(t.buffer,t.byteOffset,e);if(t instanceof ArrayBuffer){return v(t,0,e)}return""}function v(t,e,n){if(t.byteLength<e+n)return"";const r=new DataView(t);let i="";for(let t=0;t<n;t++)i+=String.fromCharCode(r.getUint8(e+t));return i}},function(t,e,n){"use strict";function r(t,e){if(t===e)return!0;if(Array.isArray(t)){var n=t.length;if(!e||e.length!==n)return!1;for(var r=0;r<n;r++)if(t[r]!==e[r])return!1;return!0}return!1}function i(t){var e,n={};return function(i){for(var o in i)if(!r(i[o],n[o])){e=t(i),n=i;break}return e}}n.d(e,"a",(function(){return i}))},function(t,e,n){"use strict";n.d(e,"c",(function(){return o})),n.d(e,"a",(function(){return a})),n.d(e,"b",(function(){return s}));var r=n(10);const i={5126:[5126,1,"float"],35664:[5126,2,"vec2"],35665:[5126,3,"vec3"],35666:[5126,4,"vec4"],5124:[5124,1,"int"],35667:[5124,2,"ivec2"],35668:[5124,3,"ivec3"],35669:[5124,4,"ivec4"],5125:[5125,1,"uint"],36294:[5125,2,"uvec2"],36295:[5125,3,"uvec3"],36296:[5125,4,"uvec4"],35670:[5126,1,"bool"],35671:[5126,2,"bvec2"],35672:[5126,3,"bvec3"],35673:[5126,4,"bvec4"],35674:[5126,8,"mat2"],35685:[5126,8,"mat2x3"],35686:[5126,8,"mat2x4"],35675:[5126,12,"mat3"],35687:[5126,12,"mat3x2"],35688:[5126,12,"mat3x4"],35676:[5126,16,"mat4"],35689:[5126,16,"mat4x2"],35690:[5126,16,"mat4x3"]};function o(t){switch(t){case 0:return 0;case 1:case 3:case 2:return 1;case 4:case 5:case 6:return 4;default:return Object(r.a)(!1),0}}function a(t){const e=i[t];if(!e)return null;const[n,r]=e;return{type:n,components:r}}function s(t,e){switch(t){case 5120:case 5121:case 5122:case 5123:t=5126}for(const n in i){const[r,o,a]=i[n];if(r===t&&o===e)return{glType:n,name:a}}return null}},function(t,e,n){"use strict";n.d(e,"b",(function(){return i})),n.d(e,"a",(function(){return o})),n.d(e,"c",(function(){return a})),n.d(e,"d",(function(){return s})),n.d(e,"e",(function(){return u}));var r=n(7);const i={6407:{dataFormat:6407,types:[5121,33635]},6408:{dataFormat:6408,types:[5121,32819,32820]},6406:{dataFormat:6406,types:[5121]},6409:{dataFormat:6409,types:[5121]},6410:{dataFormat:6410,types:[5121]},33326:{dataFormat:6403,types:[5126],gl2:!0},33328:{dataFormat:33319,types:[5126],gl2:!0},34837:{dataFormat:6407,types:[5126],gl2:!0},34836:{dataFormat:6408,types:[5126],gl2:!0}},o={6403:1,36244:1,33319:2,33320:2,6407:3,36248:3,6408:4,36249:4,6402:1,34041:1,6406:1,6409:1,6410:2},a={5126:4,5125:4,5124:4,5123:2,5122:2,5131:2,5120:1,5121:1};function s(t,e){const n=i[e];if(!n)return!1;if(void 0===n.gl1&&void 0===n.gl2)return!0;const o=Object(r.j)(t)&&n.gl2||n.gl1;return"string"==typeof o?t.getExtension(o):o}function u(t,e){const n=i[e];switch(n&&n.types[0]){case 5126:return t.getExtension("OES_texture_float_linear");case 5131:return t.getExtension("OES_texture_half_float_linear");default:return!0}}},function(t,e,n){"use strict";n.d(e,"b",(function(){return i})),n.d(e,"d",(function(){return s})),n.d(e,"a",(function(){return u})),n.d(e,"c",(function(){return c}));var r=n(15);function i(t,e,n,r){var i=e[0],o=e[1],a=e[2];return t[0]=i+r*(n[0]-i),t[1]=o+r*(n[1]-o),t[2]=a+r*(n[2]-a),t}var o,a,s=function(t,e,n){return t[0]=e[0]-n[0],t[1]=e[1]-n[1],t[2]=e[2]-n[2],t},u=function(t){var e=t[0],n=t[1],r=t[2];return Math.hypot(e,n,r)},c=function(t){var e=t[0],n=t[1],r=t[2];return e*e+n*n+r*r};o=new r.a(3),r.a!=Float32Array&&(o[0]=0,o[1]=0,o[2]=0),a=o},function(t,e,n){"use strict";n.d(e,"a",(function(){return l}));var r=n(121),i=n(13),o=n(23),a=n(25),s=n(55);const u=[0,0,0];let c;class l extends r.a{static get ZERO(){return c||(c=new l(0,0,0),Object.freeze(c)),c}constructor(t=0,e=0,n=0){super(-0,-0,-0),1===arguments.length&&Object(i.f)(t)?this.copy(t):(i.b.debug&&(Object(o.a)(t),Object(o.a)(e),Object(o.a)(n)),this[0]=t,this[1]=e,this[2]=n)}set(t,e,n){return this[0]=t,this[1]=e,this[2]=n,this.check()}copy(t){return this[0]=t[0],this[1]=t[1],this[2]=t[2],this.check()}fromObject(t){return i.b.debug&&(Object(o.a)(t.x),Object(o.a)(t.y),Object(o.a)(t.z)),this[0]=t.x,this[1]=t.y,this[2]=t.z,this.check()}toObject(t){return t.x=this[0],t.y=this[1],t.z=this[2],t}get ELEMENTS(){return 3}get z(){return this[2]}set z(t){this[2]=Object(o.a)(t)}angle(t){return a.b(this,t)}cross(t){return a.d(this,this,t),this.check()}rotateX({radians:t,origin:e=u}){return a.l(this,this,e,t),this.check()}rotateY({radians:t,origin:e=u}){return a.m(this,this,e,t),this.check()}rotateZ({radians:t,origin:e=u}){return a.n(this,this,e,t),this.check()}transform(t){return this.transformAsPoint(t)}transformAsPoint(t){return a.p(this,this,t),this.check()}transformAsVector(t){return Object(s.c)(this,this,t),this.check()}transformByMatrix3(t){return a.o(this,this,t),this.check()}transformByMatrix2(t){return Object(s.b)(this,this,t),this.check()}transformByQuaternion(t){return a.q(this,this,t),this.check()}}},function(t,e,n){"use strict";n.d(e,"d",(function(){return i})),n.d(e,"a",(function(){return o})),n.d(e,"b",(function(){return a})),n.d(e,"c",(function(){return s}));var r=n(101);function i(t){if(Object(r.b)(t))return Object(r.a)(t);if(t instanceof ArrayBuffer)return t;if(ArrayBuffer.isView(t))return 0===t.byteOffset&&t.byteLength===t.buffer.byteLength?t.buffer:t.buffer.slice(t.byteOffset,t.byteOffset+t.byteLength);if("string"==typeof t){const e=t;return(new TextEncoder).encode(e).buffer}if(t&&"object"==typeof t&&t._toArrayBuffer)return t._toArrayBuffer();throw new Error("toArrayBuffer")}function o(t,e,n){if(n=n||t.byteLength,t.byteLength<n||e.byteLength<n)return!1;const r=new Uint8Array(t),i=new Uint8Array(e);for(let t=0;t<r.length;++t)if(r[t]!==i[t])return!1;return!0}function a(...t){const e=t.map(t=>t instanceof ArrayBuffer?new Uint8Array(t):t),n=e.reduce((t,e)=>t+e.byteLength,0),r=new Uint8Array(n);let i=0;for(const t of e)r.set(t,i),i+=t.byteLength;return r.buffer}function s(t,e,n){const r=void 0!==n?new Uint8Array(t).subarray(e,e+n):new Uint8Array(t).subarray(e);return new Uint8Array(r).buffer}},function(t,e,n){"use strict";n.d(e,"a",(function(){return P}));var r=n(9),i=n.n(r),o=n(3),a=n.n(o),s=n(4),u=n.n(s),c=n(27),l=n.n(c),h=n(8),f=n.n(h),p=n(5),d=n.n(p),A=n(6),g=n.n(A),m=n(1),y=n.n(m),v=n(0),_=n.n(v),b=n(42),x=n(19),w=n(92),E=n(13),O=n(78);function S(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function T(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?S(Object(n),!0).forEach((function(e){_()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):S(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function C(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=y()(t);if(e){var i=y()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return g()(this,n)}}var P=function(t){d()(n,t);var e=C(n);function n(){var t,r=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};a()(this,n);var i,o=r.latitude,s=void 0===o?0:o,u=r.longitude,c=void 0===u?0:u,h=r.zoom,f=void 0===h?0:h,p=r.pitch,d=void 0===p?0:p,A=r.bearing,g=void 0===A?0:A,m=r.nearZMultiplier,y=void 0===m?.1:m,v=r.farZMultiplier,_=void 0===v?1.01:v,b=r.orthographic,w=void 0!==b&&b,S=r.projectionMatrix,C=r.repeat,P=void 0!==C&&C,M=r.worldOffset,I=void 0===M?0:M,B=r.position,R=r.padding,k=r.legacyMeterSizes,D=void 0!==k&&k,L=r.width,j=r.height,F=r.altitude,z=void 0===F?1.5:F,U=Math.pow(2,f);L=L||1,j=j||1;var N=null;if(S)z=S[5]/2,i=Object(x.b)(z);else{var G;if(r.fovy?(i=r.fovy,z=Object(x.e)(i)):i=Object(x.b)(z),R){var V=R.top,H=void 0===V?0:V,W=R.bottom,q=void 0===W?0:W;G=[0,Object(E.a)((H+j-q)/2,0,j)-j/2]}N=Object(x.j)({width:L,height:j,scale:U,center:B&&[0,0,B[2]*Object(x.o)(s)],offset:G,pitch:d,fovy:i,nearZMultiplier:y,farZMultiplier:_})}var X=Object(x.k)({height:j,pitch:d,bearing:g,scale:U,altitude:z});if(I){var Z=(new O.a).translate([512*I,0,0]);X=Z.multiplyLeft(X)}return(t=e.call(this,T(T(T({},r),{},{width:L,height:j,viewMatrix:X,longitude:c,latitude:s,zoom:f},N),{},{fovy:i,focalDistance:z}))).latitude=s,t.longitude=c,t.zoom=f,t.pitch=d,t.bearing=g,t.altitude=z,t.fovy=i,t.orthographic=w,t._subViewports=P?[]:null,t._pseudoMeters=D,Object.freeze(l()(t)),t}return u()(n,[{key:"subViewports",get:function(){if(this._subViewports&&!this._subViewports.length)for(var t=this.getBounds(),e=Math.floor((t[0]+180)/360),r=Math.ceil((t[2]-180)/360),i=e;i<=r;i++){var o=i?new n(T(T({},this),{},{worldOffset:i})):this;this._subViewports.push(o)}return this._subViewports}},{key:"projectPosition",value:function(t){if(this._pseudoMeters)return f()(y()(n.prototype),"projectPosition",this).call(this,t);var e=this.projectFlat(t),r=i()(e,2);return[r[0],r[1],(t[2]||0)*Object(x.o)(t[1])]}},{key:"unprojectPosition",value:function(t){if(this._pseudoMeters)return f()(y()(n.prototype),"unprojectPosition",this).call(this,t);var e=this.unprojectFlat(t),r=i()(e,2),o=r[0],a=r[1];return[o,a,(t[2]||0)/Object(x.o)(a)]}},{key:"addMetersToLngLat",value:function(t,e){return Object(x.a)(t,e)}},{key:"panByPosition",value:function(t,e){var n=Object(x.n)(e,this.pixelUnprojectionMatrix),r=this.projectFlat(t),o=w.a([],r,w.b([],n)),a=w.a([],this.center,o),s=this.unprojectFlat(a),u=i()(s,2);return{longitude:u[0],latitude:u[1]}}},{key:"getBounds",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},e=Object(x.f)(this,t.z||0);return[Math.min(e[0][0],e[1][0],e[2][0],e[3][0]),Math.min(e[0][1],e[1][1],e[2][1],e[3][1]),Math.max(e[0][0],e[1][0],e[2][0],e[3][0]),Math.max(e[0][1],e[1][1],e[2][1],e[3][1])]}},{key:"fitBounds",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},r=this.width,i=this.height,o=Object(x.c)(T({width:r,height:i,bounds:t},e)),a=o.longitude,s=o.latitude,u=o.zoom;return new n({width:r,height:i,longitude:a,latitude:s,zoom:u})}}]),n}(b.a);_()(P,"displayName","WebMercatorViewport")},function(t,e,n){"use strict";n.r(e);var r=n(174),i=n.n(r);function o(t,e){if(!t)throw new Error("null row");if(!e)throw new Error("no headers");const n={};for(let r=0;r<e.length;r++)n[e[r]]=t[r];return n}function a(t,e){if(!t)throw new Error("null row");if(!e)throw new Error("no headers");const n=new Array(e.length);for(let r=0;r<e.length;r++)n[r]=t[e[r]];return n}var s=n(17);let u;class c extends Array{enqueue(t){return this.push(t)}dequeue(){return this.shift()}}u=Symbol.asyncIterator;class l{constructor(){Object(s.a)(this,"_values",void 0),Object(s.a)(this,"_settlers",void 0),Object(s.a)(this,"_closed",void 0),this._values=new c,this._settlers=new c,this._closed=!1}close(){for(;this._settlers.length>0;)this._settlers.dequeue().resolve({done:!0});this._closed=!0}[u](){return this}enqueue(t){if(this._closed)throw new Error("Closed");if(this._settlers.length>0){if(this._values.length>0)throw new Error("Illegal internal state");const e=this._settlers.dequeue();t instanceof Error?e.reject(t):e.resolve({value:t})}else this._values.enqueue(t)}next(){if(this._values.length>0){const t=this._values.dequeue();return t instanceof Error?Promise.reject(t):Promise.resolve({value:t})}if(this._closed){if(this._settlers.length>0)throw new Error("Illegal internal state");return Promise.resolve({done:!0})}return new Promise((t,e)=>{this._settlers.enqueue({resolve:t,reject:e})})}}class h{constructor(t,e){if(Object(s.a)(this,"schema",void 0),Object(s.a)(this,"options",void 0),Object(s.a)(this,"length",0),Object(s.a)(this,"rows",null),Object(s.a)(this,"cursor",0),Object(s.a)(this,"_headers",[]),this.options=e,this.schema=t,!Array.isArray(t)){this._headers=[];for(const e in t)this._headers[t[e].index]=t[e].name}}rowCount(){return this.length}addArrayRow(t,e){Number.isFinite(e)&&(this.cursor=e),this.rows=this.rows||new Array(100),this.rows[this.length]=t,this.length++}addObjectRow(t,e){Number.isFinite(e)&&(this.cursor=e),this.rows=this.rows||new Array(100),this.rows[this.length]=t,this.length++}getBatch(){let t=this.rows;if(!t)return null;t=t.slice(0,this.length),this.rows=null;return{shape:this.options.shape,batchType:"data",data:t,length:this.length,schema:this.schema,cursor:this.cursor}}}class f{constructor(t,e){if(Object(s.a)(this,"schema",void 0),Object(s.a)(this,"options",void 0),Object(s.a)(this,"length",0),Object(s.a)(this,"objectRows",null),Object(s.a)(this,"arrayRows",null),Object(s.a)(this,"cursor",0),Object(s.a)(this,"_headers",[]),this.options=e,this.schema=t,!Array.isArray(t)){this._headers=[];for(const e in t)this._headers[t[e].index]=t[e].name}}rowCount(){return this.length}addArrayRow(t,e){switch(Number.isFinite(e)&&(this.cursor=e),this.options.shape){case"object-row-table":const n=o(t,this._headers);this.addObjectRow(n,e);break;case"array-row-table":this.arrayRows=this.arrayRows||new Array(100),this.arrayRows[this.length]=t,this.length++}}addObjectRow(t,e){switch(Number.isFinite(e)&&(this.cursor=e),this.options.shape){case"array-row-table":const n=a(t,this._headers);this.addArrayRow(n,e);break;case"object-row-table":this.objectRows=this.objectRows||new Array(100),this.objectRows[this.length]=t,this.length++}}getBatch(){let t=this.arrayRows||this.objectRows;return t?(t=t.slice(0,this.length),this.arrayRows=null,this.objectRows=null,{shape:this.options.shape,batchType:"data",data:t,length:this.length,schema:this.schema,cursor:this.cursor}):null}}class p{constructor(t,e){Object(s.a)(this,"schema",void 0),Object(s.a)(this,"length",0),Object(s.a)(this,"allocated",0),Object(s.a)(this,"columns",{}),this.schema=t,this._reallocateColumns()}rowCount(){return this.length}addArrayRow(t){this._reallocateColumns();let e=0;for(const n in this.columns)this.columns[n][this.length]=t[e++];this.length++}addObjectRow(t){this._reallocateColumns();for(const e in t)this.columns[e][this.length]=t[e];this.length++}getBatch(){this._pruneColumns();const t=Array.isArray(this.schema)?this.columns:{};if(!Array.isArray(this.schema))for(const e in this.schema){const n=this.schema[e];t[n.name]=this.columns[n.index]}this.columns={};return{shape:"columnar-table",batchType:"data",data:t,schema:this.schema,length:this.length}}_reallocateColumns(){if(!(this.length<this.allocated)){this.allocated=this.allocated>0?this.allocated*=2:100,this.columns={};for(const t in this.schema){const e=this.schema[t],n=e.type||Float32Array,r=this.columns[e.index];if(r&&ArrayBuffer.isView(r)){const t=new n(this.allocated);t.set(r),this.columns[e.index]=t}else r?(r.length=this.allocated,this.columns[e.index]=r):this.columns[e.index]=new n(this.allocated)}}}_pruneColumns(){for(const[t,e]of Object.entries(this.columns))this.columns[t]=e.slice(0,this.length)}}const d={shape:"array-row-table",batchSize:"auto",batchDebounceMs:0,limit:0,_limitMB:0};class A{constructor(t,e){Object(s.a)(this,"schema",void 0),Object(s.a)(this,"options",void 0),Object(s.a)(this,"aggregator",null),Object(s.a)(this,"batchCount",0),Object(s.a)(this,"bytesUsed",0),Object(s.a)(this,"isChunkComplete",!1),Object(s.a)(this,"lastBatchEmittedMs",Date.now()),Object(s.a)(this,"totalLength",0),Object(s.a)(this,"totalBytes",0),Object(s.a)(this,"rowBytes",0),this.schema=t,this.options={...d,...e}}limitReached(){var t,e;return!!(Boolean(null===(t=this.options)||void 0===t?void 0:t.limit)&&this.totalLength>=this.options.limit)||!!(Boolean(null===(e=this.options)||void 0===e?void 0:e._limitMB)&&this.totalBytes/1e6>=this.options._limitMB)}addRow(t){this.limitReached()||(this.totalLength++,this.rowBytes=this.rowBytes||this._estimateRowMB(t),this.totalBytes+=this.rowBytes,Array.isArray(t)?this.addArrayRow(t):this.addObjectRow(t))}addArrayRow(t){if(!this.aggregator){const t=this._getTableBatchType();this.aggregator=new t(this.schema,this.options)}this.aggregator.addArrayRow(t)}addObjectRow(t){if(!this.aggregator){const t=this._getTableBatchType();this.aggregator=new t(this.schema,this.options)}this.aggregator.addObjectRow(t)}chunkComplete(t){t instanceof ArrayBuffer&&(this.bytesUsed+=t.byteLength),"string"==typeof t&&(this.bytesUsed+=t.length),this.isChunkComplete=!0}getFullBatch(t){return this._isFull()?this._getBatch(t):null}getFinalBatch(t){return this._getBatch(t)}_estimateRowMB(t){return Array.isArray(t)?8*t.length:8*Object.keys(t).length}_isFull(){if(!this.aggregator||0===this.aggregator.rowCount())return!1;if("auto"===this.options.batchSize){if(!this.isChunkComplete)return!1}else if(this.options.batchSize>this.aggregator.rowCount())return!1;return!(this.options.batchDebounceMs>Date.now()-this.lastBatchEmittedMs)&&(this.isChunkComplete=!1,this.lastBatchEmittedMs=Date.now(),!0)}_getBatch(t){if(!this.aggregator)return null;null!=t&&t.bytesUsed&&(this.bytesUsed=t.bytesUsed);const e=this.aggregator.getBatch();return e.count=this.batchCount,e.bytesUsed=this.bytesUsed,Object.assign(e,t),this.batchCount++,this.aggregator=null,e}_getTableBatchType(){switch(this.options.shape){case"row-table":return h;case"array-row-table":case"object-row-table":return f;case"columnar-table":return p;case"arrow-table":if(!A.ArrowBatch)throw new Error("TableBatchBuilder");return A.ArrowBatch;default:throw new Error("TableBatchBuilder")}}}Object(s.a)(A,"ArrowBatch",void 0);
+/* @license
+Papa Parse
+v5.0.0-beta.0
+https://github.com/mholt/PapaParse
+License: MIT
+*/
+const g={parse:function(t,e,n){var r=(e=e||{}).dynamicTyping||!1;E(r)&&(e.dynamicTypingFunction=r,r={});if(e.dynamicTyping=r,e.transform=!!E(e.transform)&&e.transform,e.worker&&g.WORKERS_SUPPORTED){var i=newWorker();return i.userStep=e.step,i.userChunk=e.chunk,i.userComplete=e.complete,i.userError=e.error,e.step=E(e.step),e.chunk=E(e.chunk),e.complete=E(e.complete),e.error=E(e.error),delete e.worker,void i.postMessage({input:t,config:e,workerId:i.id})}var o=null;"string"==typeof t&&(o=new v(e));o||(o=new n(e));return o.stream(t)},unparse:function(t,e){var n=!1,r=!0,i=",",o="\r\n",a='"',s=a+a,u=!1,c=null;!function(){if("object"!=typeof e)return;"string"!=typeof e.delimiter||g.BAD_DELIMITERS.filter((function(t){return-1!==e.delimiter.indexOf(t)})).length||(i=e.delimiter);("boolean"==typeof e.quotes||Array.isArray(e.quotes))&&(n=e.quotes);"boolean"!=typeof e.skipEmptyLines&&"string"!=typeof e.skipEmptyLines||(u=e.skipEmptyLines);"string"==typeof e.newline&&(o=e.newline);"string"==typeof e.quoteChar&&(a=e.quoteChar);"boolean"==typeof e.header&&(r=e.header);if(Array.isArray(e.columns)){if(0===e.columns.length)throw new Error("Option columns is empty");c=e.columns}void 0!==e.escapeChar&&(s=e.escapeChar+a)}();var l=new RegExp(b(a),"g");"string"==typeof t&&(t=JSON.parse(t));if(Array.isArray(t)){if(!t.length||Array.isArray(t[0]))return f(null,t,u);if("object"==typeof t[0])return f(c||h(t[0]),t,u)}else if("object"==typeof t)return"string"==typeof t.data&&(t.data=JSON.parse(t.data)),Array.isArray(t.data)&&(t.fields||(t.fields=t.meta&&t.meta.fields),t.fields||(t.fields=Array.isArray(t.data[0])?t.fields:h(t.data[0])),Array.isArray(t.data[0])||"object"==typeof t.data[0]||(t.data=[t.data])),f(t.fields||[],t.data||[],u);throw new Error("Unable to serialize unrecognized input");function h(t){if("object"!=typeof t)return[];var e=[];for(var n in t)e.push(n);return e}function f(t,e,n){var a="";"string"==typeof t&&(t=JSON.parse(t)),"string"==typeof e&&(e=JSON.parse(e));var s=Array.isArray(t)&&t.length>0,u=!Array.isArray(e[0]);if(s&&r){for(var c=0;c<t.length;c++)c>0&&(a+=i),a+=p(t[c],c);e.length>0&&(a+=o)}for(var l=0;l<e.length;l++){var h=s?t.length:e[l].length,f=!1,d=s?0===Object.keys(e[l]).length:0===e[l].length;if(n&&!s&&(f="greedy"===n?""===e[l].join("").trim():1===e[l].length&&0===e[l][0].length),"greedy"===n&&s){for(var A=[],g=0;g<h;g++){var m=u?t[g]:g;A.push(e[l][m])}f=""===A.join("").trim()}if(!f){for(var y=0;y<h;y++){y>0&&!d&&(a+=i);var v=s&&u?t[y]:y;a+=p(e[l][v],y)}l<e.length-1&&(!n||h>0&&!d)&&(a+=o)}}return a}function p(t,e){return null==t?"":t.constructor===Date?JSON.stringify(t).slice(1,25):(t=t.toString().replace(l,s),"boolean"==typeof n&&n||Array.isArray(n)&&n[e]||function(t,e){for(var n=0;n<e.length;n++)if(t.indexOf(e[n])>-1)return!0;return!1}(t,g.BAD_DELIMITERS)||t.indexOf(i)>-1||" "===t.charAt(0)||" "===t.charAt(t.length-1)?a+t+a:t)}},RECORD_SEP:String.fromCharCode(30),UNIT_SEP:String.fromCharCode(31),BYTE_ORDER_MARK:"\ufeff",BAD_DELIMITERS:["\r","\n",'"',"\ufeff"],WORKERS_SUPPORTED:!1,NODE_STREAM_INPUT:1,LocalChunkSize:10485760,RemoteChunkSize:5242880,DefaultDelimiter:",",Parser:x,ParserHandle:_,ChunkStreamer:y,StringStreamer:v};var m=g;function y(t){this._handle=null,this._finished=!1,this._completed=!1,this._input=null,this._baseIndex=0,this._partialLine="",this._rowCount=0,this._start=0,this._nextChunk=null,this.isFirstChunk=!0,this._completeResults={data:[],errors:[],meta:{}},function(t){var e=w(t);e.chunkSize=parseInt(e.chunkSize),t.step||t.chunk||(e.chunkSize=null);this._handle=new _(e),this._handle.streamer=this,this._config=e}.call(this,t),this.parseChunk=function(t,e){if(this.isFirstChunk&&E(this._config.beforeFirstChunk)){var n=this._config.beforeFirstChunk(t);void 0!==n&&(t=n)}this.isFirstChunk=!1;var r=this._partialLine+t;this._partialLine="";var i=this._handle.parse(r,this._baseIndex,!this._finished);if(!this._handle.paused()&&!this._handle.aborted()){var o=i.meta.cursor;this._finished||(this._partialLine=r.substring(o-this._baseIndex),this._baseIndex=o),i&&i.data&&(this._rowCount+=i.data.length);var a=this._finished||this._config.preview&&this._rowCount>=this._config.preview;if(E(this._config.chunk)&&!e){if(this._config.chunk(i,this._handle),this._handle.paused()||this._handle.aborted())return;i=void 0,this._completeResults=void 0}return this._config.step||this._config.chunk||(this._completeResults.data=this._completeResults.data.concat(i.data),this._completeResults.errors=this._completeResults.errors.concat(i.errors),this._completeResults.meta=i.meta),this._completed||!a||!E(this._config.complete)||i&&i.meta.aborted||(this._config.complete(this._completeResults,this._input),this._completed=!0),a||i&&i.meta.paused||this._nextChunk(),i}},this._sendError=function(t){E(this._config.error)&&this._config.error(t)}}function v(t){var e;t=t||{},y.call(this,t),this.stream=function(t){return e=t,this._nextChunk()},this._nextChunk=function(){if(!this._finished){var t=this._config.chunkSize,n=t?e.substr(0,t):e;return e=t?e.substr(t):"",this._finished=!e,this.parseChunk(n)}}}function _(t){var e,n,r,i=/^\s*-?(\d*\.?\d+|\d+\.?\d*)(e[-+]?\d+)?\s*$/i,o=/(\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d\.\d+([+-][0-2]\d:[0-5]\d|Z))|(\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d([+-][0-2]\d:[0-5]\d|Z))|(\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d([+-][0-2]\d:[0-5]\d|Z))/,a=this,s=0,u=0,c=!1,l=!1,h=[],f={data:[],errors:[],meta:{}};if(E(t.step)){var p=t.step;t.step=function(e){if(f=e,m())A();else{if(A(),!f.data||0===f.data.length)return;s+=e.data.length,t.preview&&s>t.preview?n.abort():p(f,a)}}}function d(e){return"greedy"===t.skipEmptyLines?""===e.join("").trim():1===e.length&&0===e[0].length}function A(){if(f&&r&&(v("Delimiter","UndetectableDelimiter","Unable to auto-detect delimiting character; defaulted to '"+g.DefaultDelimiter+"'"),r=!1),t.skipEmptyLines)for(var e=0;e<f.data.length;e++)d(f.data[e])&&f.data.splice(e--,1);return m()&&function(){if(!f)return;function e(e){E(t.transformHeader)&&(e=t.transformHeader(e)),h.push(e)}if(Array.isArray(f.data[0])){for(var n=0;m()&&n<f.data.length;n++)f.data[n].forEach(e);f.data.splice(0,1)}else f.data.forEach(e)}(),function(){if(!f||!f.data||!t.header&&!t.dynamicTyping&&!t.transform)return f;function e(e,n){var r,i=t.header?{}:[];for(r=0;r<e.length;r++){var o=r,a=e[r];t.header&&(o=r>=h.length?"__parsed_extra":h[r]),t.transform&&(a=t.transform(a,o)),a=y(o,a),"__parsed_extra"===o?(i[o]=i[o]||[],i[o].push(a)):i[o]=a}return t.header&&(r>h.length?v("FieldMismatch","TooManyFields","Too many fields: expected "+h.length+" fields but parsed "+r,u+n):r<h.length&&v("FieldMismatch","TooFewFields","Too few fields: expected "+h.length+" fields but parsed "+r,u+n)),i}var n=1;!f.data[0]||Array.isArray(f.data[0])?(f.data=f.data.map(e),n=f.data.length):f.data=e(f.data,0);t.header&&f.meta&&(f.meta.fields=h);return u+=n,f}()}function m(){return t.header&&0===h.length}function y(e,n){return function(e){return t.dynamicTypingFunction&&void 0===t.dynamicTyping[e]&&(t.dynamicTyping[e]=t.dynamicTypingFunction(e)),!0===(t.dynamicTyping[e]||t.dynamicTyping)}(e)?"true"===n||"TRUE"===n||"false"!==n&&"FALSE"!==n&&(i.test(n)?parseFloat(n):o.test(n)?new Date(n):""===n?null:n):n}function v(t,e,n,r){f.errors.push({type:t,code:e,message:n,row:r})}this.parse=function(i,o,a){var s=t.quoteChar||'"';if(t.newline||(t.newline=function(t,e){t=t.substr(0,1048576);var n=new RegExp(b(e)+"([^]*?)"+b(e),"gm"),r=(t=t.replace(n,"")).split("\r"),i=t.split("\n"),o=i.length>1&&i[0].length<r[0].length;if(1===r.length||o)return"\n";for(var a=0,s=0;s<r.length;s++)"\n"===r[s][0]&&a++;return a>=r.length/2?"\r\n":"\r"}(i,s)),r=!1,t.delimiter)E(t.delimiter)&&(t.delimiter=t.delimiter(i),f.meta.delimiter=t.delimiter);else{var u=function(e,n,r,i,o){var a,s,u;o=o||[",","\t","|",";",g.RECORD_SEP,g.UNIT_SEP];for(var c=0;c<o.length;c++){var l=o[c],h=0,f=0,p=0;u=void 0;for(var A=new x({comments:i,delimiter:l,newline:n,preview:10}).parse(e),m=0;m<A.data.length;m++)if(r&&d(A.data[m]))p++;else{var y=A.data[m].length;f+=y,void 0!==u?y>1&&(h+=Math.abs(y-u),u=y):u=0}A.data.length>0&&(f/=A.data.length-p),(void 0===s||h>s)&&f>1.99&&(s=h,a=l)}return t.delimiter=a,{successful:!!a,bestDelimiter:a}}(i,t.newline,t.skipEmptyLines,t.comments,t.delimitersToGuess);u.successful?t.delimiter=u.bestDelimiter:(r=!0,t.delimiter=g.DefaultDelimiter),f.meta.delimiter=t.delimiter}var l=w(t);return t.preview&&t.header&&l.preview++,e=i,n=new x(l),f=n.parse(e,o,a),A(),c?{meta:{paused:!0}}:f||{meta:{paused:!1}}},this.paused=function(){return c},this.pause=function(){c=!0,n.abort(),e=e.substr(n.getCharIndex())},this.resume=function(){c=!1,a.streamer.parseChunk(e,!0)},this.aborted=function(){return l},this.abort=function(){l=!0,n.abort(),f.meta.aborted=!0,E(t.complete)&&t.complete(f),e=""}}function b(t){return t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function x(t){var e,n=(t=t||{}).delimiter,r=t.newline,i=t.comments,o=t.step,a=t.preview,s=t.fastMode,u=e=void 0===t.quoteChar?'"':t.quoteChar;if(void 0!==t.escapeChar&&(u=t.escapeChar),("string"!=typeof n||g.BAD_DELIMITERS.indexOf(n)>-1)&&(n=","),i===n)throw new Error("Comment character same as delimiter");!0===i?i="#":("string"!=typeof i||g.BAD_DELIMITERS.indexOf(i)>-1)&&(i=!1),"\n"!==r&&"\r"!==r&&"\r\n"!==r&&(r="\n");var c=0,l=!1;this.parse=function(t,h,f){if("string"!=typeof t)throw new Error("Input must be a string");var p=t.length,d=n.length,A=r.length,g=i.length,m=E(o);c=0;var y=[],v=[],_=[],x=0;if(!t)return L();if(s||!1!==s&&-1===t.indexOf(e)){for(var w=t.split(r),O=0;O<w.length;O++){if(_=w[O],c+=_.length,O!==w.length-1)c+=r.length;else if(f)return L();if(!i||_.substr(0,g)!==i){if(m){if(y=[],B(_.split(n)),j(),l)return L()}else B(_.split(n));if(a&&O>=a)return y=y.slice(0,a),L(!0)}}return L()}for(var S,T=t.indexOf(n,c),C=t.indexOf(r,c),P=new RegExp(b(u)+b(e),"g");;)if(t[c]!==e)if(i&&0===_.length&&t.substr(c,g)===i){if(-1===C)return L();c=C+A,C=t.indexOf(r,c),T=t.indexOf(n,c)}else if(-1!==T&&(T<C||-1===C))_.push(t.substring(c,T)),c=T+d,T=t.indexOf(n,c);else{if(-1===C)break;if(_.push(t.substring(c,C)),D(C+A),m&&(j(),l))return L();if(a&&y.length>=a)return L(!0)}else{for(S=c,c++;;){if(-1===(S=t.indexOf(e,S+1)))return f||v.push({type:"Quotes",code:"MissingQuotes",message:"Quoted field unterminated",row:y.length,index:c}),k();if(S===p-1)return k(t.substring(c,S).replace(P,e));if(e!==u||t[S+1]!==u){if(e===u||0===S||t[S-1]!==u){var M=R(-1===C?T:Math.min(T,C));if(t[S+1+M]===n){if(_.push(t.substring(c,S).replace(P,e)),c=S+1+M+d,T=t.indexOf(n,c),C=t.indexOf(r,c),m&&(j(),l))return L();if(a&&y.length>=a)return L(!0);break}var I=R(C);if(t.substr(S+1+I,A)===r){if(_.push(t.substring(c,S).replace(P,e)),D(S+1+I+A),T=t.indexOf(n,c),m&&(j(),l))return L();if(a&&y.length>=a)return L(!0);break}v.push({type:"Quotes",code:"InvalidQuotes",message:"Trailing quote on quoted field is malformed",row:y.length,index:c}),S++}}else S++}if(m&&(j(),l))return L();if(a&&y.length>=a)return L(!0)}return k();function B(t){y.push(t),x=c}function R(e){var n=0;if(-1!==e){var r=t.substring(S+1,e);r&&""===r.trim()&&(n=r.length)}return n}function k(e){return f||(void 0===e&&(e=t.substr(c)),_.push(e),c=p,B(_),m&&j()),L()}function D(e){c=e,B(_),_=[],C=t.indexOf(r,c)}function L(t,e){return{data:e||!1?y[0]:y,errors:v,meta:{delimiter:n,linebreak:r,aborted:l,truncated:!!t,cursor:x+(h||0)}}}function j(){o(L(void 0,!0)),y=[],v=[]}},this.abort=function(){l=!0},this.getCharIndex=function(){return c}}function w(t){if("object"!=typeof t||null===t)return t;var e=Array.isArray(t)?[]:{};for(var n in t)e[n]=w(t[n]);return e}function E(t){return"function"==typeof t}v.prototype=Object.create(v.prototype),v.prototype.constructor=v;const{ChunkStreamer:O}=m;function S(t){t=t||{},O.call(this,t),this.textDecoder=new TextDecoder(this._config.encoding),this.stream=async function(t){this._input=t;try{for await(const e of t)this.parseChunk(this.getStringChunk(e));this._finished=!0,this.parseChunk("")}catch(t){this._sendError(t)}},this._nextChunk=function(){},this.getStringChunk=function(t){return"string"==typeof t?t:this.textDecoder.decode(t,{stream:!0})}}S.prototype=Object.create(O.prototype),S.prototype.constructor=S;const T={csv:{shape:"object-row-table",optimizeMemoryUsage:!1,header:"auto",columnPrefix:"column",quoteChar:'"',escapeChar:'"',dynamicTyping:!0,comments:!1,skipEmptyLines:!0,delimitersToGuess:[",","\t","|",";"]}},C={id:"csv",module:"csv",name:"CSV",version:"3.3.3",extensions:["csv","tsv","dsv"],mimeTypes:["text/csv","text/tab-separated-values","text/dsv"],category:"table",parse:async(t,e)=>P((new TextDecoder).decode(t),e),parseText:(t,e)=>P(t,e),parseInBatches:function(t,e){var n;"auto"===(e={...e}).batchSize&&(e.batchSize=4e3);const r={...T.csv,...null===(n=e)||void 0===n?void 0:n.csv},i=new l;let o=!0,a=null,s=null,u=null;const c={...r,header:!1,download:!1,chunkSize:5242880,skipEmptyLines:!1,step(t){let n=t.data;if(r.skipEmptyLines){if(""===n.flat().join("").trim())return}const c=t.meta.cursor;if(o&&!a){if("auto"===r.header?M(n):Boolean(r.header))return void(a=n.map(I()))}o&&(o=!1,a||(a=B(r.columnPrefix,n.length)),u=function(t,e){const n=e?{}:[];for(let r=0;r<t.length;r++){const i=e&&e[r]||r;switch(typeof t[r]){case"number":case"boolean":n[i]={name:String(i),index:r,type:Float32Array};break;case"string":default:n[i]={name:String(i),index:r,type:Array}}}return n}(n,a)),r.optimizeMemoryUsage&&(n=JSON.parse(JSON.stringify(n))),s=s||new A(u,{shape:r.shape||"array-row-table",...e});try{s.addRow(n);const t=s&&s.getFullBatch({bytesUsed:c});t&&i.enqueue(t)}catch(t){i.enqueue(t)}},complete(t){try{const e=t.meta.cursor,n=s&&s.getFinalBatch({bytesUsed:e});n&&i.enqueue(n)}catch(t){i.enqueue(t)}i.close()}};return m.parse(t,c,S),i},options:T};async function P(t,e){const n={...T.csv,...null==e?void 0:e.csv},r=function(t){return m.parse(t,{download:!1,dynamicTyping:!0,preview:1}).data[0]}(t),i="auto"===n.header?M(r):Boolean(n.header),s={...n,header:i,download:!1,transformHeader:i?I():void 0,error:t=>{throw new Error(t)}},u=m.parse(t,s);let{data:c}=u;const l=u.meta.fields||B(n.columnPrefix,r.length);switch(n.shape){case"object-row-table":c=c.map(t=>Array.isArray(t)?o(t,l):t);break;case"array-row-table":c=c.map(t=>Array.isArray(t)?t:a(t,l))}return c}function M(t){return t&&t.every(t=>"string"==typeof t)}function I(){const t=new Set;return e=>{let n=e,r=1;for(;t.has(n);)n="".concat(e,".").concat(r),r++;return t.add(n),n}}function B(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:0;const n=[];for(let r=0;r<e;r++)n.push("".concat(t).concat(r+1));return n}function R(t,e){if(!t)throw new Error(e||"loader assertion failed.")}function k(t){var e,n;let r;return R(t,"null loader"),R(function(t){var e;return!!t&&(Array.isArray(t)&&(t=t[0]),Array.isArray(null===(e=t)||void 0===e?void 0:e.extensions))}(t),"invalid loader"),Array.isArray(t)&&(r=t[1],t=t[0],t={...t,options:{...t.options,...r}}),(null!==(e=t)&&void 0!==e&&e.parseTextSync||null!==(n=t)&&void 0!==n&&n.parseText)&&(t.text=!0),t.text||(t.binary=!0),t}var D=n(248);Object(D.a)();class L{constructor(t,e){let n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:"sessionStorage";Object(s.a)(this,"storage",void 0),Object(s.a)(this,"id",void 0),Object(s.a)(this,"config",void 0),this.storage=function(t){try{const e=window[t],n="__storage_test__";return e.setItem(n,n),e.removeItem(n),e}catch(t){return null}}(n),this.id=t,this.config=e,this._loadConfiguration()}getConfiguration(){return this.config}setConfiguration(t){if(Object.assign(this.config,t),this.storage){const t=JSON.stringify(this.config);this.storage.setItem(this.id,t)}}_loadConfiguration(){let t={};if(this.storage){const e=this.storage.getItem(this.id);t=e?JSON.parse(e):{}}return Object.assign(this.config,t),this}}function j(t,e,n){let r=arguments.length>3&&void 0!==arguments[3]?arguments[3]:600;const i=t.src.replace(/\(/g,"%28").replace(/\)/g,"%29");t.width>r&&(n=Math.min(n,r/t.width));const o=t.width*n,a=t.height*n,s=["font-size:1px;","padding:".concat(Math.floor(a/2),"px ").concat(Math.floor(o/2),"px;"),"line-height:".concat(a,"px;"),"background:url(".concat(i,");"),"background-size:".concat(o,"px ").concat(a,"px;"),"color:transparent;"].join("");return["".concat(e," %c+"),s]}let F;function z(t){return"string"==typeof t?F[t.toUpperCase()]||F.WHITE:t}function U(t,e){if(!t)throw new Error(e||"Assertion failed")}!function(t){t[t.BLACK=30]="BLACK",t[t.RED=31]="RED",t[t.GREEN=32]="GREEN",t[t.YELLOW=33]="YELLOW",t[t.BLUE=34]="BLUE",t[t.MAGENTA=35]="MAGENTA",t[t.CYAN=36]="CYAN",t[t.WHITE=37]="WHITE",t[t.BRIGHT_BLACK=90]="BRIGHT_BLACK",t[t.BRIGHT_RED=91]="BRIGHT_RED",t[t.BRIGHT_GREEN=92]="BRIGHT_GREEN",t[t.BRIGHT_YELLOW=93]="BRIGHT_YELLOW",t[t.BRIGHT_BLUE=94]="BRIGHT_BLUE",t[t.BRIGHT_MAGENTA=95]="BRIGHT_MAGENTA",t[t.BRIGHT_CYAN=96]="BRIGHT_CYAN",t[t.BRIGHT_WHITE=97]="BRIGHT_WHITE"}(F||(F={}));var N=n(99);function G(){let t;var e,n;if(D.a&&"performance"in N.b)t=null===N.b||void 0===N.b||null===(e=N.b.performance)||void 0===e||null===(n=e.now)||void 0===n?void 0:n.call(e);else if("hrtime"in N.a){var r;const e=null===N.a||void 0===N.a||null===(r=N.a.hrtime)||void 0===r?void 0:r.call(N.a);t=1e3*e[0]+e[1]/1e6}else t=Date.now();return t}const V={debug:D.a&&console.debug||console.log,log:console.log,info:console.info,warn:console.warn,error:console.error},H={enabled:!0,level:0};function W(){}const q={},X={once:!0};class Z{constructor(){let{id:t}=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{id:""};Object(s.a)(this,"id",void 0),Object(s.a)(this,"VERSION","8.9.7"),Object(s.a)(this,"_startTs",G()),Object(s.a)(this,"_deltaTs",G()),Object(s.a)(this,"_storage",void 0),Object(s.a)(this,"userData",{}),Object(s.a)(this,"LOG_THROTTLE_TIMEOUT",0),this.id=t,this.userData={},this._storage=new L("__probe-".concat(this.id,"__"),H),this.timeStamp("".concat(this.id," started")),function(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:["constructor"];const n=Object.getPrototypeOf(t),r=Object.getOwnPropertyNames(n);for(const n of r)"function"==typeof t[n]&&(e.find(t=>n===t)||(t[n]=t[n].bind(t)))}(this),Object.seal(this)}set level(t){this.setLevel(t)}get level(){return this.getLevel()}isEnabled(){return this._storage.config.enabled}getLevel(){return this._storage.config.level}getTotal(){return Number((G()-this._startTs).toPrecision(10))}getDelta(){return Number((G()-this._deltaTs).toPrecision(10))}set priority(t){this.level=t}get priority(){return this.level}getPriority(){return this.level}enable(){let t=!(arguments.length>0&&void 0!==arguments[0])||arguments[0];return this._storage.setConfiguration({enabled:t}),this}setLevel(t){return this._storage.setConfiguration({level:t}),this}get(t){return this._storage.config[t]}set(t,e){this._storage.setConfiguration({[t]:e})}settings(){console.table?console.table(this._storage.config):console.log(this._storage.config)}assert(t,e){U(t,e)}warn(t){return this._getLogFunction(0,t,V.warn,arguments,X)}error(t){return this._getLogFunction(0,t,V.error,arguments)}deprecated(t,e){return this.warn("`".concat(t,"` is deprecated and will be removed in a later version. Use `").concat(e,"` instead"))}removed(t,e){return this.error("`".concat(t,"` has been removed. Use `").concat(e,"` instead"))}probe(t,e){return this._getLogFunction(t,e,V.log,arguments,{time:!0,once:!0})}log(t,e){return this._getLogFunction(t,e,V.debug,arguments)}info(t,e){return this._getLogFunction(t,e,console.info,arguments)}once(t,e){for(var n=arguments.length,r=new Array(n>2?n-2:0),i=2;i<n;i++)r[i-2]=arguments[i];return this._getLogFunction(t,e,V.debug||V.info,arguments,X)}table(t,e,n){return e?this._getLogFunction(t,e,console.table||W,n&&[n],{tag:K(e)}):W}image(t){let{logLevel:e,priority:n,image:r,message:i="",scale:o=1}=t;return this._shouldLog(e||n)?D.a?function(t){let{image:e,message:n="",scale:r=1}=t;if("string"==typeof e){const t=new Image;return t.onload=()=>{const e=j(t,n,r);console.log(...e)},t.src=e,W}const i=e.nodeName||"";if("img"===i.toLowerCase())return console.log(...j(e,n,r)),W;if("canvas"===i.toLowerCase()){const t=new Image;return t.onload=()=>console.log(...j(t,n,r)),t.src=e.toDataURL(),W}return W}({image:r,message:i,scale:o}):function(t){let{image:e,message:n="",scale:r=1}=t;return console.warn("removed"),W}({image:r,message:i,scale:o}):W}time(t,e){return this._getLogFunction(t,e,console.time?console.time:console.info)}timeEnd(t,e){return this._getLogFunction(t,e,console.timeEnd?console.timeEnd:console.info)}timeStamp(t,e){return this._getLogFunction(t,e,console.timeStamp||W)}group(t,e){let n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{collapsed:!1};const r=Q({logLevel:t,message:e,opts:n}),{collapsed:i}=n;return r.method=(i?console.groupCollapsed:console.group)||console.info,this._getLogFunction(r)}groupCollapsed(t,e){let n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{};return this.group(t,e,Object.assign({},n,{collapsed:!0}))}groupEnd(t){return this._getLogFunction(t,"",console.groupEnd||W)}withGroup(t,e,n){this.group(t,e)();try{n()}finally{this.groupEnd(t)()}}trace(){console.trace&&console.trace()}_shouldLog(t){return this.isEnabled()&&this.getLevel()>=J(t)}_getLogFunction(t,e,n,r,i){if(this._shouldLog(t)){i=Q({logLevel:t,message:e,args:r,opts:i}),U(n=n||i.method),i.total=this.getTotal(),i.delta=this.getDelta(),this._deltaTs=G();const o=i.tag||i.message;if(i.once){if(q[o])return W;q[o]=G()}return e=function(t,e,n){if("string"==typeof e){const a=n.time?function(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:8;const n=Math.max(e-t.length,0);return"".concat(" ".repeat(n)).concat(t)}(function(t){let e;return e=t<10?"".concat(t.toFixed(2),"ms"):t<100?"".concat(t.toFixed(1),"ms"):t<1e3?"".concat(t.toFixed(0),"ms"):"".concat((t/1e3).toFixed(2),"s"),e}(n.total)):"";e=n.time?"".concat(t,": ").concat(a,"  ").concat(e):"".concat(t,": ").concat(e),r=e,i=n.color,o=n.background,D.a||"string"!=typeof r||(i&&(i=z(i),r="[".concat(i,"m").concat(r,"")),o&&(i=z(o),r="[".concat(o+10,"m").concat(r,""))),e=r}var r,i,o;return e}(this.id,i.message,i),n.bind(console,e,...i.args)}return W}}function J(t){if(!t)return 0;let e;switch(typeof t){case"number":e=t;break;case"object":e=t.logLevel||t.priority||0;break;default:return 0}return U(Number.isFinite(e)&&e>=0),e}function Q(t){const{logLevel:e,message:n}=t;t.logLevel=J(e);const r=t.args?Array.from(t.args):[];for(;r.length&&r.shift()!==n;);switch(typeof e){case"string":case"function":void 0!==n&&r.unshift(n),t.message=e;break;case"object":Object.assign(t,e)}"function"==typeof t.message&&(t.message=t.message());const i=typeof t.message;return U("string"===i||"object"===i),Object.assign(t,{args:r},t.opts)}function K(t){for(const e in t)for(const n in t[e])return n||"untitled";return"empty"}Object(s.a)(Z,"VERSION","8.9.7");new Z({id:"loaders.gl"});var Y=n(318);new class{constructor(){Object(s.a)(this,"console",void 0),this.console=console}log(){for(var t=arguments.length,e=new Array(t),n=0;n<t;n++)e[n]=arguments[n];return this.console.log.bind(this.console,...e)}info(){for(var t=arguments.length,e=new Array(t),n=0;n<t;n++)e[n]=arguments[n];return this.console.info.bind(this.console,...e)}warn(){for(var t=arguments.length,e=new Array(t),n=0;n<t;n++)e[n]=arguments[n];return this.console.warn.bind(this.console,...e)}error(){for(var t=arguments.length,e=new Array(t),n=0;n<t;n++)e[n]=arguments[n];return this.console.error.bind(this.console,...e)}},Y.a;function $(){globalThis.loaders=globalThis.loaders||{};const{loaders:t}=globalThis;return t._state=t._state||{},t._state}const tt=()=>{const t=$();return t.loaderRegistry=t.loaderRegistry||[],t.loaderRegistry};var et,nt,rt=n(250),it=n.n(rt);function ot(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return at(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return at(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function at(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var st={fontFamily:'"Helvetica Neue", Helvetica, Arial, sans-serif',display:"flex",flex:"wrap",maxWidth:"500px",flexDirection:"column",zIndex:2};function ut(){return document.createElement("div")}function ct(t){if(!t.picked)return null;if(t.object===et)return nt;var e={html:ht(t.object),style:st};return nt=e,et=t.object,e}var lt=new Set(["position","index"]);function ht(t){var e=ut();for(var n in t)if(!lt.has(n)){var r=ut();r.className="header",r.textContent=n;var i=ut();i.className="value",i.textContent=pt(t[n]);var o=ut();ft(o,r,i),o.appendChild(r),o.appendChild(i),e.appendChild(o)}return e.innerHTML}function ft(t,e,n){Object.assign(e.style,{fontWeight:700,marginRight:"10px",flex:"1 1 0%"}),Object.assign(n.style,{flex:"none",maxWidth:"250px",overflow:"hidden",whiteSpace:"nowrap",textOverflow:"ellipsis"}),Object.assign(t.style,{display:"flex",flexDirection:"row",justifyContent:"space-between",alignItems:"stretch"})}function pt(t){var e;if(Array.isArray(t)&&t.length>4)e="Array<".concat(t.length,">");else if("string"==typeof t)e=t;else if("number"==typeof t)e=String(t);else try{e=JSON.stringify(t)}catch(t){e="<Non-Serializable Object>"}return e.length>50&&(e=e.slice(0,50)),e}function dt(t,e){var n,r,i=t,o=ot(it()(new Set(t.match(/{[^}]*}/g).map((function(t){return t.replace(/[{}]/g,"")})))));try{for(o.s();!(r=o.n()).done;){var a=r.value;if(a.includes(".")){n=e;var s,u=ot(a.split("."));try{for(u.s();!(s=u.n()).done;){var c=s.value;if(!n.hasOwnProperty(c)){n=void 0;break}n=n[c]}}catch(t){u.e(t)}finally{u.f()}}else n=e.hasOwnProperty(a)?e[a]:e.properties&&e.properties.hasOwnProperty(a)?e.properties[a]:void 0;i=i.replaceAll("{".concat(a,"}"),n)}}catch(t){o.e(t)}finally{o.f()}return i}var At=n(131),gt={};var mt=n(41);var yt=n(88),vt=n.n(yt),_t=n(89),bt=n.n(_t),xt={position:"absolute",top:"0px",left:"0px",width:344,padding:"12px 24px",margin:24,overflowX:"hidden",overflowY:"overlay",outline:"none",maxHeight:"94%",boxSizing:"border-box",backgroundColor:"rgb(255, 255, 255)",fontFamily:'"Fira Sans", sans-serif',zIndex:1},wt=function(){function t(e){var n=e.container,r=e.props;vt()(this,t);var i=r.description,o=document.createElement("div");o.className="deck-json-description-box",Object.assign(o.style,xt),this.el=o;var a=document.createElement("div");a.innerHTML=i,o.appendChild(a),n.append(o)}return bt()(t,[{key:"remove",value:function(){this.el.remove(),this.description=null}}],[{key:"stringName",get:function(){return"description"}}]),t}();function Et(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function Ot(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Et(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Et(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function St(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return Tt(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return Tt(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function Tt(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}n.d(e,"addCustomLibraries",(function(){return Rt})),n.d(e,"createDeck",(function(){return Lt})),n.d(e,"updateDeck",(function(){return kt})),n.d(e,"jsonConverter",(function(){return Bt}));var Ct=function(t){return t.charAt(0)===t.charAt(0).toUpperCase()},Pt=function(t){return t.charAt(0)===t.charAt(0).toLowerCase()&&"_"!=t.charAt(0)};function Mt(){var t,e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},n=arguments.length>1?arguments[1]:void 0,r={},i=Object.keys(e).filter(n),o=St(i);try{for(o.s();!(t=o.n()).done;){var a=t.value;r[a]=e[a]}}catch(t){o.e(t)}finally{o.f()}return r}var It={classes:Mt(mt,Ct),enumerations:{COORDINATE_SYSTEM:mt.COORDINATE_SYSTEM,GL:{DEPTH_BUFFER_BIT:256,STENCIL_BUFFER_BIT:1024,COLOR_BUFFER_BIT:16384,POINTS:0,LINES:1,LINE_LOOP:2,LINE_STRIP:3,TRIANGLES:4,TRIANGLE_STRIP:5,TRIANGLE_FAN:6,ZERO:0,ONE:1,SRC_COLOR:768,ONE_MINUS_SRC_COLOR:769,SRC_ALPHA:770,ONE_MINUS_SRC_ALPHA:771,DST_ALPHA:772,ONE_MINUS_DST_ALPHA:773,DST_COLOR:774,ONE_MINUS_DST_COLOR:775,SRC_ALPHA_SATURATE:776,CONSTANT_COLOR:32769,ONE_MINUS_CONSTANT_COLOR:32770,CONSTANT_ALPHA:32771,ONE_MINUS_CONSTANT_ALPHA:32772,FUNC_ADD:32774,FUNC_SUBTRACT:32778,FUNC_REVERSE_SUBTRACT:32779,BLEND_EQUATION:32777,BLEND_EQUATION_RGB:32777,BLEND_EQUATION_ALPHA:34877,BLEND_DST_RGB:32968,BLEND_SRC_RGB:32969,BLEND_DST_ALPHA:32970,BLEND_SRC_ALPHA:32971,BLEND_COLOR:32773,ARRAY_BUFFER_BINDING:34964,ELEMENT_ARRAY_BUFFER_BINDING:34965,LINE_WIDTH:2849,ALIASED_POINT_SIZE_RANGE:33901,ALIASED_LINE_WIDTH_RANGE:33902,CULL_FACE_MODE:2885,FRONT_FACE:2886,DEPTH_RANGE:2928,DEPTH_WRITEMASK:2930,DEPTH_CLEAR_VALUE:2931,DEPTH_FUNC:2932,STENCIL_CLEAR_VALUE:2961,STENCIL_FUNC:2962,STENCIL_FAIL:2964,STENCIL_PASS_DEPTH_FAIL:2965,STENCIL_PASS_DEPTH_PASS:2966,STENCIL_REF:2967,STENCIL_VALUE_MASK:2963,STENCIL_WRITEMASK:2968,STENCIL_BACK_FUNC:34816,STENCIL_BACK_FAIL:34817,STENCIL_BACK_PASS_DEPTH_FAIL:34818,STENCIL_BACK_PASS_DEPTH_PASS:34819,STENCIL_BACK_REF:36003,STENCIL_BACK_VALUE_MASK:36004,STENCIL_BACK_WRITEMASK:36005,VIEWPORT:2978,SCISSOR_BOX:3088,COLOR_CLEAR_VALUE:3106,COLOR_WRITEMASK:3107,UNPACK_ALIGNMENT:3317,PACK_ALIGNMENT:3333,MAX_TEXTURE_SIZE:3379,MAX_VIEWPORT_DIMS:3386,SUBPIXEL_BITS:3408,RED_BITS:3410,GREEN_BITS:3411,BLUE_BITS:3412,ALPHA_BITS:3413,DEPTH_BITS:3414,STENCIL_BITS:3415,POLYGON_OFFSET_UNITS:10752,POLYGON_OFFSET_FACTOR:32824,TEXTURE_BINDING_2D:32873,SAMPLE_BUFFERS:32936,SAMPLES:32937,SAMPLE_COVERAGE_VALUE:32938,SAMPLE_COVERAGE_INVERT:32939,COMPRESSED_TEXTURE_FORMATS:34467,VENDOR:7936,RENDERER:7937,VERSION:7938,IMPLEMENTATION_COLOR_READ_TYPE:35738,IMPLEMENTATION_COLOR_READ_FORMAT:35739,BROWSER_DEFAULT_WEBGL:37444,STATIC_DRAW:35044,STREAM_DRAW:35040,DYNAMIC_DRAW:35048,ARRAY_BUFFER:34962,ELEMENT_ARRAY_BUFFER:34963,BUFFER_SIZE:34660,BUFFER_USAGE:34661,CURRENT_VERTEX_ATTRIB:34342,VERTEX_ATTRIB_ARRAY_ENABLED:34338,VERTEX_ATTRIB_ARRAY_SIZE:34339,VERTEX_ATTRIB_ARRAY_STRIDE:34340,VERTEX_ATTRIB_ARRAY_TYPE:34341,VERTEX_ATTRIB_ARRAY_NORMALIZED:34922,VERTEX_ATTRIB_ARRAY_POINTER:34373,VERTEX_ATTRIB_ARRAY_BUFFER_BINDING:34975,CULL_FACE:2884,FRONT:1028,BACK:1029,FRONT_AND_BACK:1032,BLEND:3042,DEPTH_TEST:2929,DITHER:3024,POLYGON_OFFSET_FILL:32823,SAMPLE_ALPHA_TO_COVERAGE:32926,SAMPLE_COVERAGE:32928,SCISSOR_TEST:3089,STENCIL_TEST:2960,NO_ERROR:0,INVALID_ENUM:1280,INVALID_VALUE:1281,INVALID_OPERATION:1282,OUT_OF_MEMORY:1285,CONTEXT_LOST_WEBGL:37442,CW:2304,CCW:2305,DONT_CARE:4352,FASTEST:4353,NICEST:4354,GENERATE_MIPMAP_HINT:33170,BYTE:5120,UNSIGNED_BYTE:5121,SHORT:5122,UNSIGNED_SHORT:5123,INT:5124,UNSIGNED_INT:5125,FLOAT:5126,DOUBLE:5130,DEPTH_COMPONENT:6402,ALPHA:6406,RGB:6407,RGBA:6408,LUMINANCE:6409,LUMINANCE_ALPHA:6410,UNSIGNED_SHORT_4_4_4_4:32819,UNSIGNED_SHORT_5_5_5_1:32820,UNSIGNED_SHORT_5_6_5:33635,FRAGMENT_SHADER:35632,VERTEX_SHADER:35633,COMPILE_STATUS:35713,DELETE_STATUS:35712,LINK_STATUS:35714,VALIDATE_STATUS:35715,ATTACHED_SHADERS:35717,ACTIVE_ATTRIBUTES:35721,ACTIVE_UNIFORMS:35718,MAX_VERTEX_ATTRIBS:34921,MAX_VERTEX_UNIFORM_VECTORS:36347,MAX_VARYING_VECTORS:36348,MAX_COMBINED_TEXTURE_IMAGE_UNITS:35661,MAX_VERTEX_TEXTURE_IMAGE_UNITS:35660,MAX_TEXTURE_IMAGE_UNITS:34930,MAX_FRAGMENT_UNIFORM_VECTORS:36349,SHADER_TYPE:35663,SHADING_LANGUAGE_VERSION:35724,CURRENT_PROGRAM:35725,NEVER:512,ALWAYS:519,LESS:513,EQUAL:514,LEQUAL:515,GREATER:516,GEQUAL:518,NOTEQUAL:517,KEEP:7680,REPLACE:7681,INCR:7682,DECR:7683,INVERT:5386,INCR_WRAP:34055,DECR_WRAP:34056,NEAREST:9728,LINEAR:9729,NEAREST_MIPMAP_NEAREST:9984,LINEAR_MIPMAP_NEAREST:9985,NEAREST_MIPMAP_LINEAR:9986,LINEAR_MIPMAP_LINEAR:9987,TEXTURE_MAG_FILTER:10240,TEXTURE_MIN_FILTER:10241,TEXTURE_WRAP_S:10242,TEXTURE_WRAP_T:10243,TEXTURE_2D:3553,TEXTURE:5890,TEXTURE_CUBE_MAP:34067,TEXTURE_BINDING_CUBE_MAP:34068,TEXTURE_CUBE_MAP_POSITIVE_X:34069,TEXTURE_CUBE_MAP_NEGATIVE_X:34070,TEXTURE_CUBE_MAP_POSITIVE_Y:34071,TEXTURE_CUBE_MAP_NEGATIVE_Y:34072,TEXTURE_CUBE_MAP_POSITIVE_Z:34073,TEXTURE_CUBE_MAP_NEGATIVE_Z:34074,MAX_CUBE_MAP_TEXTURE_SIZE:34076,TEXTURE0:33984,ACTIVE_TEXTURE:34016,REPEAT:10497,CLAMP_TO_EDGE:33071,MIRRORED_REPEAT:33648,TEXTURE_WIDTH:4096,TEXTURE_HEIGHT:4097,FLOAT_VEC2:35664,FLOAT_VEC3:35665,FLOAT_VEC4:35666,INT_VEC2:35667,INT_VEC3:35668,INT_VEC4:35669,BOOL:35670,BOOL_VEC2:35671,BOOL_VEC3:35672,BOOL_VEC4:35673,FLOAT_MAT2:35674,FLOAT_MAT3:35675,FLOAT_MAT4:35676,SAMPLER_2D:35678,SAMPLER_CUBE:35680,LOW_FLOAT:36336,MEDIUM_FLOAT:36337,HIGH_FLOAT:36338,LOW_INT:36339,MEDIUM_INT:36340,HIGH_INT:36341,FRAMEBUFFER:36160,RENDERBUFFER:36161,RGBA4:32854,RGB5_A1:32855,RGB565:36194,DEPTH_COMPONENT16:33189,STENCIL_INDEX:6401,STENCIL_INDEX8:36168,DEPTH_STENCIL:34041,RENDERBUFFER_WIDTH:36162,RENDERBUFFER_HEIGHT:36163,RENDERBUFFER_INTERNAL_FORMAT:36164,RENDERBUFFER_RED_SIZE:36176,RENDERBUFFER_GREEN_SIZE:36177,RENDERBUFFER_BLUE_SIZE:36178,RENDERBUFFER_ALPHA_SIZE:36179,RENDERBUFFER_DEPTH_SIZE:36180,RENDERBUFFER_STENCIL_SIZE:36181,FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE:36048,FRAMEBUFFER_ATTACHMENT_OBJECT_NAME:36049,FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL:36050,FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE:36051,COLOR_ATTACHMENT0:36064,DEPTH_ATTACHMENT:36096,STENCIL_ATTACHMENT:36128,DEPTH_STENCIL_ATTACHMENT:33306,NONE:0,FRAMEBUFFER_COMPLETE:36053,FRAMEBUFFER_INCOMPLETE_ATTACHMENT:36054,FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT:36055,FRAMEBUFFER_INCOMPLETE_DIMENSIONS:36057,FRAMEBUFFER_UNSUPPORTED:36061,FRAMEBUFFER_BINDING:36006,RENDERBUFFER_BINDING:36007,READ_FRAMEBUFFER:36008,DRAW_FRAMEBUFFER:36009,MAX_RENDERBUFFER_SIZE:34024,INVALID_FRAMEBUFFER_OPERATION:1286,UNPACK_FLIP_Y_WEBGL:37440,UNPACK_PREMULTIPLY_ALPHA_WEBGL:37441,UNPACK_COLORSPACE_CONVERSION_WEBGL:37443,READ_BUFFER:3074,UNPACK_ROW_LENGTH:3314,UNPACK_SKIP_ROWS:3315,UNPACK_SKIP_PIXELS:3316,PACK_ROW_LENGTH:3330,PACK_SKIP_ROWS:3331,PACK_SKIP_PIXELS:3332,TEXTURE_BINDING_3D:32874,UNPACK_SKIP_IMAGES:32877,UNPACK_IMAGE_HEIGHT:32878,MAX_3D_TEXTURE_SIZE:32883,MAX_ELEMENTS_VERTICES:33e3,MAX_ELEMENTS_INDICES:33001,MAX_TEXTURE_LOD_BIAS:34045,MAX_FRAGMENT_UNIFORM_COMPONENTS:35657,MAX_VERTEX_UNIFORM_COMPONENTS:35658,MAX_ARRAY_TEXTURE_LAYERS:35071,MIN_PROGRAM_TEXEL_OFFSET:35076,MAX_PROGRAM_TEXEL_OFFSET:35077,MAX_VARYING_COMPONENTS:35659,FRAGMENT_SHADER_DERIVATIVE_HINT:35723,RASTERIZER_DISCARD:35977,VERTEX_ARRAY_BINDING:34229,MAX_VERTEX_OUTPUT_COMPONENTS:37154,MAX_FRAGMENT_INPUT_COMPONENTS:37157,MAX_SERVER_WAIT_TIMEOUT:37137,MAX_ELEMENT_INDEX:36203,RED:6403,RGB8:32849,RGBA8:32856,RGB10_A2:32857,TEXTURE_3D:32879,TEXTURE_WRAP_R:32882,TEXTURE_MIN_LOD:33082,TEXTURE_MAX_LOD:33083,TEXTURE_BASE_LEVEL:33084,TEXTURE_MAX_LEVEL:33085,TEXTURE_COMPARE_MODE:34892,TEXTURE_COMPARE_FUNC:34893,SRGB:35904,SRGB8:35905,SRGB8_ALPHA8:35907,COMPARE_REF_TO_TEXTURE:34894,RGBA32F:34836,RGB32F:34837,RGBA16F:34842,RGB16F:34843,TEXTURE_2D_ARRAY:35866,TEXTURE_BINDING_2D_ARRAY:35869,R11F_G11F_B10F:35898,RGB9_E5:35901,RGBA32UI:36208,RGB32UI:36209,RGBA16UI:36214,RGB16UI:36215,RGBA8UI:36220,RGB8UI:36221,RGBA32I:36226,RGB32I:36227,RGBA16I:36232,RGB16I:36233,RGBA8I:36238,RGB8I:36239,RED_INTEGER:36244,RGB_INTEGER:36248,RGBA_INTEGER:36249,R8:33321,RG8:33323,R16F:33325,R32F:33326,RG16F:33327,RG32F:33328,R8I:33329,R8UI:33330,R16I:33331,R16UI:33332,R32I:33333,R32UI:33334,RG8I:33335,RG8UI:33336,RG16I:33337,RG16UI:33338,RG32I:33339,RG32UI:33340,R8_SNORM:36756,RG8_SNORM:36757,RGB8_SNORM:36758,RGBA8_SNORM:36759,RGB10_A2UI:36975,TEXTURE_IMMUTABLE_FORMAT:37167,TEXTURE_IMMUTABLE_LEVELS:33503,UNSIGNED_INT_2_10_10_10_REV:33640,UNSIGNED_INT_10F_11F_11F_REV:35899,UNSIGNED_INT_5_9_9_9_REV:35902,FLOAT_32_UNSIGNED_INT_24_8_REV:36269,UNSIGNED_INT_24_8:34042,HALF_FLOAT:5131,RG:33319,RG_INTEGER:33320,INT_2_10_10_10_REV:36255,CURRENT_QUERY:34917,QUERY_RESULT:34918,QUERY_RESULT_AVAILABLE:34919,ANY_SAMPLES_PASSED:35887,ANY_SAMPLES_PASSED_CONSERVATIVE:36202,MAX_DRAW_BUFFERS:34852,DRAW_BUFFER0:34853,DRAW_BUFFER1:34854,DRAW_BUFFER2:34855,DRAW_BUFFER3:34856,DRAW_BUFFER4:34857,DRAW_BUFFER5:34858,DRAW_BUFFER6:34859,DRAW_BUFFER7:34860,DRAW_BUFFER8:34861,DRAW_BUFFER9:34862,DRAW_BUFFER10:34863,DRAW_BUFFER11:34864,DRAW_BUFFER12:34865,DRAW_BUFFER13:34866,DRAW_BUFFER14:34867,DRAW_BUFFER15:34868,MAX_COLOR_ATTACHMENTS:36063,COLOR_ATTACHMENT1:36065,COLOR_ATTACHMENT2:36066,COLOR_ATTACHMENT3:36067,COLOR_ATTACHMENT4:36068,COLOR_ATTACHMENT5:36069,COLOR_ATTACHMENT6:36070,COLOR_ATTACHMENT7:36071,COLOR_ATTACHMENT8:36072,COLOR_ATTACHMENT9:36073,COLOR_ATTACHMENT10:36074,COLOR_ATTACHMENT11:36075,COLOR_ATTACHMENT12:36076,COLOR_ATTACHMENT13:36077,COLOR_ATTACHMENT14:36078,COLOR_ATTACHMENT15:36079,SAMPLER_3D:35679,SAMPLER_2D_SHADOW:35682,SAMPLER_2D_ARRAY:36289,SAMPLER_2D_ARRAY_SHADOW:36292,SAMPLER_CUBE_SHADOW:36293,INT_SAMPLER_2D:36298,INT_SAMPLER_3D:36299,INT_SAMPLER_CUBE:36300,INT_SAMPLER_2D_ARRAY:36303,UNSIGNED_INT_SAMPLER_2D:36306,UNSIGNED_INT_SAMPLER_3D:36307,UNSIGNED_INT_SAMPLER_CUBE:36308,UNSIGNED_INT_SAMPLER_2D_ARRAY:36311,MAX_SAMPLES:36183,SAMPLER_BINDING:35097,PIXEL_PACK_BUFFER:35051,PIXEL_UNPACK_BUFFER:35052,PIXEL_PACK_BUFFER_BINDING:35053,PIXEL_UNPACK_BUFFER_BINDING:35055,COPY_READ_BUFFER:36662,COPY_WRITE_BUFFER:36663,COPY_READ_BUFFER_BINDING:36662,COPY_WRITE_BUFFER_BINDING:36663,FLOAT_MAT2x3:35685,FLOAT_MAT2x4:35686,FLOAT_MAT3x2:35687,FLOAT_MAT3x4:35688,FLOAT_MAT4x2:35689,FLOAT_MAT4x3:35690,UNSIGNED_INT_VEC2:36294,UNSIGNED_INT_VEC3:36295,UNSIGNED_INT_VEC4:36296,UNSIGNED_NORMALIZED:35863,SIGNED_NORMALIZED:36764,VERTEX_ATTRIB_ARRAY_INTEGER:35069,VERTEX_ATTRIB_ARRAY_DIVISOR:35070,TRANSFORM_FEEDBACK_BUFFER_MODE:35967,MAX_TRANSFORM_FEEDBACK_SEPARATE_COMPONENTS:35968,TRANSFORM_FEEDBACK_VARYINGS:35971,TRANSFORM_FEEDBACK_BUFFER_START:35972,TRANSFORM_FEEDBACK_BUFFER_SIZE:35973,TRANSFORM_FEEDBACK_PRIMITIVES_WRITTEN:35976,MAX_TRANSFORM_FEEDBACK_INTERLEAVED_COMPONENTS:35978,MAX_TRANSFORM_FEEDBACK_SEPARATE_ATTRIBS:35979,INTERLEAVED_ATTRIBS:35980,SEPARATE_ATTRIBS:35981,TRANSFORM_FEEDBACK_BUFFER:35982,TRANSFORM_FEEDBACK_BUFFER_BINDING:35983,TRANSFORM_FEEDBACK:36386,TRANSFORM_FEEDBACK_PAUSED:36387,TRANSFORM_FEEDBACK_ACTIVE:36388,TRANSFORM_FEEDBACK_BINDING:36389,FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING:33296,FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE:33297,FRAMEBUFFER_ATTACHMENT_RED_SIZE:33298,FRAMEBUFFER_ATTACHMENT_GREEN_SIZE:33299,FRAMEBUFFER_ATTACHMENT_BLUE_SIZE:33300,FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE:33301,FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE:33302,FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE:33303,FRAMEBUFFER_DEFAULT:33304,DEPTH24_STENCIL8:35056,DRAW_FRAMEBUFFER_BINDING:36006,READ_FRAMEBUFFER_BINDING:36010,RENDERBUFFER_SAMPLES:36011,FRAMEBUFFER_ATTACHMENT_TEXTURE_LAYER:36052,FRAMEBUFFER_INCOMPLETE_MULTISAMPLE:36182,UNIFORM_BUFFER:35345,UNIFORM_BUFFER_BINDING:35368,UNIFORM_BUFFER_START:35369,UNIFORM_BUFFER_SIZE:35370,MAX_VERTEX_UNIFORM_BLOCKS:35371,MAX_FRAGMENT_UNIFORM_BLOCKS:35373,MAX_COMBINED_UNIFORM_BLOCKS:35374,MAX_UNIFORM_BUFFER_BINDINGS:35375,MAX_UNIFORM_BLOCK_SIZE:35376,MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS:35377,MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS:35379,UNIFORM_BUFFER_OFFSET_ALIGNMENT:35380,ACTIVE_UNIFORM_BLOCKS:35382,UNIFORM_TYPE:35383,UNIFORM_SIZE:35384,UNIFORM_BLOCK_INDEX:35386,UNIFORM_OFFSET:35387,UNIFORM_ARRAY_STRIDE:35388,UNIFORM_MATRIX_STRIDE:35389,UNIFORM_IS_ROW_MAJOR:35390,UNIFORM_BLOCK_BINDING:35391,UNIFORM_BLOCK_DATA_SIZE:35392,UNIFORM_BLOCK_ACTIVE_UNIFORMS:35394,UNIFORM_BLOCK_ACTIVE_UNIFORM_INDICES:35395,UNIFORM_BLOCK_REFERENCED_BY_VERTEX_SHADER:35396,UNIFORM_BLOCK_REFERENCED_BY_FRAGMENT_SHADER:35398,OBJECT_TYPE:37138,SYNC_CONDITION:37139,SYNC_STATUS:37140,SYNC_FLAGS:37141,SYNC_FENCE:37142,SYNC_GPU_COMMANDS_COMPLETE:37143,UNSIGNALED:37144,SIGNALED:37145,ALREADY_SIGNALED:37146,TIMEOUT_EXPIRED:37147,CONDITION_SATISFIED:37148,WAIT_FAILED:37149,SYNC_FLUSH_COMMANDS_BIT:1,COLOR:6144,DEPTH:6145,STENCIL:6146,MIN:32775,MAX:32776,DEPTH_COMPONENT24:33190,STREAM_READ:35041,STREAM_COPY:35042,STATIC_READ:35045,STATIC_COPY:35046,DYNAMIC_READ:35049,DYNAMIC_COPY:35050,DEPTH_COMPONENT32F:36012,DEPTH32F_STENCIL8:36013,INVALID_INDEX:4294967295,TIMEOUT_IGNORED:-1,MAX_CLIENT_WAIT_TIMEOUT_WEBGL:37447,VERTEX_ATTRIB_ARRAY_DIVISOR_ANGLE:35070,UNMASKED_VENDOR_WEBGL:37445,UNMASKED_RENDERER_WEBGL:37446,MAX_TEXTURE_MAX_ANISOTROPY_EXT:34047,TEXTURE_MAX_ANISOTROPY_EXT:34046,COMPRESSED_RGB_S3TC_DXT1_EXT:33776,COMPRESSED_RGBA_S3TC_DXT1_EXT:33777,COMPRESSED_RGBA_S3TC_DXT3_EXT:33778,COMPRESSED_RGBA_S3TC_DXT5_EXT:33779,COMPRESSED_R11_EAC:37488,COMPRESSED_SIGNED_R11_EAC:37489,COMPRESSED_RG11_EAC:37490,COMPRESSED_SIGNED_RG11_EAC:37491,COMPRESSED_RGB8_ETC2:37492,COMPRESSED_RGBA8_ETC2_EAC:37493,COMPRESSED_SRGB8_ETC2:37494,COMPRESSED_SRGB8_ALPHA8_ETC2_EAC:37495,COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2:37496,COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2:37497,COMPRESSED_RGB_PVRTC_4BPPV1_IMG:35840,COMPRESSED_RGBA_PVRTC_4BPPV1_IMG:35842,COMPRESSED_RGB_PVRTC_2BPPV1_IMG:35841,COMPRESSED_RGBA_PVRTC_2BPPV1_IMG:35843,COMPRESSED_RGB_ETC1_WEBGL:36196,COMPRESSED_RGB_ATC_WEBGL:35986,COMPRESSED_RGBA_ATC_EXPLICIT_ALPHA_WEBGL:35986,COMPRESSED_RGBA_ATC_INTERPOLATED_ALPHA_WEBGL:34798,UNSIGNED_INT_24_8_WEBGL:34042,HALF_FLOAT_OES:36193,RGBA32F_EXT:34836,RGB32F_EXT:34837,FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE_EXT:33297,UNSIGNED_NORMALIZED_EXT:35863,MIN_EXT:32775,MAX_EXT:32776,SRGB_EXT:35904,SRGB_ALPHA_EXT:35906,SRGB8_ALPHA8_EXT:35907,FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING_EXT:33296,FRAGMENT_SHADER_DERIVATIVE_HINT_OES:35723,COLOR_ATTACHMENT0_WEBGL:36064,COLOR_ATTACHMENT1_WEBGL:36065,COLOR_ATTACHMENT2_WEBGL:36066,COLOR_ATTACHMENT3_WEBGL:36067,COLOR_ATTACHMENT4_WEBGL:36068,COLOR_ATTACHMENT5_WEBGL:36069,COLOR_ATTACHMENT6_WEBGL:36070,COLOR_ATTACHMENT7_WEBGL:36071,COLOR_ATTACHMENT8_WEBGL:36072,COLOR_ATTACHMENT9_WEBGL:36073,COLOR_ATTACHMENT10_WEBGL:36074,COLOR_ATTACHMENT11_WEBGL:36075,COLOR_ATTACHMENT12_WEBGL:36076,COLOR_ATTACHMENT13_WEBGL:36077,COLOR_ATTACHMENT14_WEBGL:36078,COLOR_ATTACHMENT15_WEBGL:36079,DRAW_BUFFER0_WEBGL:34853,DRAW_BUFFER1_WEBGL:34854,DRAW_BUFFER2_WEBGL:34855,DRAW_BUFFER3_WEBGL:34856,DRAW_BUFFER4_WEBGL:34857,DRAW_BUFFER5_WEBGL:34858,DRAW_BUFFER6_WEBGL:34859,DRAW_BUFFER7_WEBGL:34860,DRAW_BUFFER8_WEBGL:34861,DRAW_BUFFER9_WEBGL:34862,DRAW_BUFFER10_WEBGL:34863,DRAW_BUFFER11_WEBGL:34864,DRAW_BUFFER12_WEBGL:34865,DRAW_BUFFER13_WEBGL:34866,DRAW_BUFFER14_WEBGL:34867,DRAW_BUFFER15_WEBGL:34868,MAX_COLOR_ATTACHMENTS_WEBGL:36063,MAX_DRAW_BUFFERS_WEBGL:34852,VERTEX_ARRAY_BINDING_OES:34229,QUERY_COUNTER_BITS_EXT:34916,CURRENT_QUERY_EXT:34917,QUERY_RESULT_EXT:34918,QUERY_RESULT_AVAILABLE_EXT:34919,TIME_ELAPSED_EXT:35007,TIMESTAMP_EXT:36392,GPU_DISJOINT_EXT:36795}}};!function(t){const e=tt();t=Array.isArray(t)?t:[t];for(const n of t){const t=k(n);e.find(e=>t===e)||e.unshift(t)}}([C]);var Bt=new mt.JSONConverter({configuration:It});function Rt(t,e){if(t){var n={};t.forEach((function(t){var e=t.libraryName,i=t.resourceUri;n[e]=!1,e in window?r(e,window[e]):(Object.defineProperty(window,e,{set:function(t){return r(e,t)},get:function(){return n[e]}}),function(t){if(!gt[t]){var e=document.createElement("script");e.type="text/javascript",e.src=t,document.querySelector("head").appendChild(e),gt[t]=new Promise((function(t){e.onload=t}))}gt[t]}(i))}))}function r(t,r){!function(t,e){var n={classes:Mt(t,Ct),functions:Mt(t,Pt)};e.mergeConfiguration(n)}(r,Bt),n[t]=r,Object.values(n).every((function(t){return t}))&&"function"==typeof e&&e()}}function kt(t,e){var n=Bt.convert(t);e.setProps(n)}function Dt(t){var e=t.mapProvider,n=t.props,r=t.mapboxApiKey,i=t.googleMapsKey,o=t.handleEvent,a=t.getTooltip,s=t.container,u=Ot(Ot({},o?{onClick:function(t){return o("deck-click-event",t)},onHover:function(t){return o("deck-hover-event",t)},onResize:function(t){return o("deck-resize-event",t)},onViewStateChange:function(t){var e=t.viewState,n=(t.interactionState,t.oldViewState,new mt.WebMercatorViewport(e));e.nw=n.unproject([0,0]),e.se=n.unproject([n.width,n.height]),o("deck-view-state-change-event",e)},onDragStart:function(t){return o("deck-drag-start-event",t)},onDrag:function(t){return o("deck-drag-event",t)},onDragEnd:function(t){return o("deck-drag-end-event",t)}}:null),{},{getTooltip:a,container:s});switch(e){case"mapbox":return mt.log.info("Using Mapbox base maps")(),new mt.DeckGL(Ot(Ot(Ot({},u),n),{},{map:At.a,mapboxApiAccessToken:r,onLoad:At.c}));case"carto":return mt.log.info("Using Carto base maps")(),new mt.DeckGL(Ot(Ot({map:At.a},u),n));case"google_maps":return mt.log.info("Using Google Maps base maps")(),function(t){var e=t.container,n=(t.onClick,t.onComplete,t.getTooltip,t.googleMapsKey),r=t.layers,i=t.mapStyle,o=void 0===i?"satellite":i,a=t.initialViewState,s=void 0===a?{latitude:0,longitude:0,zoom:1}:a;if(!n)return mt.log.warn("No Google Maps API key set")(),null;var u=new mt.GoogleMapsOverlay({layers:r}),c={center:{lat:s.latitude,lng:s.longitude},mapTypeId:o,zoom:s.zoom},l=new window.google.maps.Map(e,c);return u.setMap(l),u}(Ot(Ot(Ot({},u),n),{},{googleMapsKey:i}));default:return mt.log.info("No recognized map provider specified")(),new mt.DeckGL(Ot(Ot(Ot({},u),n),{},{map:null,mapboxApiAccessToken:null}))}}function Lt(t){var e,n=t.mapboxApiKey,r=t.googleMapsKey,i=t.container,o=t.jsonInput,a=t.tooltip,s=t.handleEvent,u=t.customLibraries,c=t.configuration;try{c&&Bt.mergeConfiguration(c);var l=o.layers||[],h=Bt.convert(o);!function(t,e){var n=document.createElement("div");n.className="deckgl-ui-elements-overlay",n.style.zIndex=1,t.insertAdjacentElement("beforebegin",n);for(var r=[],i=0,o=Object.keys(e);i<o.length;i++){switch(o[i]){case"description":var a=new wt({container:n,props:e});r.push(a)}}}(i,h);var f=(h.layers||[]).filter((function(t){return t})),p=function(t,e){return t.filter((function(t){return t&&t.id&&!e.find((function(e){return e.id===t.id}))}))}(l,f),d=function(t){return t?t.html||t.text?function(e){if(!e.picked)return null;var n={style:t.style||st};return t.html?n.html=dt(t.html,e.object):n.text=dt(t.text,e.object),n}:ct:null}(a),A=h.mapProvider;e=Dt({mapProvider:A,props:h,mapboxApiKey:n,googleMapsKey:r,handleEvent:s,getTooltip:d,container:i});Rt(u,(function(){if(p.length){var t=(Bt.convert({layers:o.layers}).layers||[]).filter((function(t){return t}));t.length>f.length&&e.setProps({layers:t})}}))}catch(t){console.error(t)}return e}},function(t,e){t.exports=function(t,e){if(!(t instanceof e))throw new TypeError("Cannot call a class as a function")},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){var r=n(214);function i(t,e){for(var n=0;n<e.length;n++){var i=e[n];i.enumerable=i.enumerable||!1,i.configurable=!0,"value"in i&&(i.writable=!0),Object.defineProperty(t,r(i.key),i)}}t.exports=function(t,e,n){return e&&i(t.prototype,e),n&&i(t,n),Object.defineProperty(t,"prototype",{writable:!1}),t},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){"use strict";n.d(e,"a",(function(){return i})),n.d(e,"b",(function(){return o}));var r=n(15);function i(t,e,n){return t[0]=e[0]*n,t[1]=e[1]*n,t[2]=e[2]*n,t[3]=e[3]*n,t}function o(t,e,n){var r=e[0],i=e[1],o=e[2],a=e[3];return t[0]=n[0]*r+n[4]*i+n[8]*o+n[12]*a,t[1]=n[1]*r+n[5]*i+n[9]*o+n[13]*a,t[2]=n[2]*r+n[6]*i+n[10]*o+n[14]*a,t[3]=n[3]*r+n[7]*i+n[11]*o+n[15]*a,t}var a,s;a=new r.a(4),r.a!=Float32Array&&(a[0]=0,a[1]=0,a[2]=0,a[3]=0),s=a},function(t,e,n){"use strict";n.d(e,"a",(function(){return i})),n.d(e,"b",(function(){return o}));var r=n(46);function i(t,e,n=null){if(n)return n;const i={fetch:Object(r.a)(e,t),...t};return Array.isArray(i.loaders)||(i.loaders=null),i}function o(t,e){if(!e&&t&&!Array.isArray(t))return t;let n;if(t&&(n=Array.isArray(t)?t:[t]),e&&e.loaders){const t=Array.isArray(e.loaders)?e.loaders:[e.loaders];n=n?[...n,...t]:t}return n&&n.length?n:null}},function(t,e,n){"use strict";n.d(e,"a",(function(){return i})),n.d(e,"b",(function(){return o}));var r=n(15);function i(t,e,n){return t[0]=e[0]+n[0],t[1]=e[1]+n[1],t}function o(t,e){return t[0]=-e[0],t[1]=-e[1],t}var a,s;a=new r.a(2),r.a!=Float32Array&&(a[0]=0,a[1]=0),s=a},,,,,function(t,e,n){"use strict";(function(t,r){n.d(e,"b",(function(){return o})),n.d(e,"a",(function(){return a}));const i={self:"undefined"!=typeof self&&self,window:"undefined"!=typeof window&&window,global:void 0!==t&&t,document:"undefined"!=typeof document&&document,process:"object"==typeof r&&r},o=(globalThis,i.window||i.self||i.global),a=i.process||{};console}).call(this,n(71),n(44))},function(t,e,n){"use strict";(function(t,r){n.d(e,"b",(function(){return o})),n.d(e,"a",(function(){return a}));const i={self:"undefined"!=typeof self&&self,window:"undefined"!=typeof window&&window,global:void 0!==t&&t,document:"undefined"!=typeof document&&document,process:"object"==typeof r&&r},o=i.window||i.self||i.global,a=i.process||{};console}).call(this,n(71),n(44))},function(t,e,n){"use strict";(function(t,r){n.d(e,"b",(function(){return o})),n.d(e,"a",(function(){return a}));const i={self:"undefined"!=typeof self&&self,window:"undefined"!=typeof window&&window,global:void 0!==t&&t,document:"undefined"!=typeof document&&document,process:"object"==typeof r&&r},o=(globalThis,i.window||i.self||i.global),a=i.process||{};console}).call(this,n(71),n(44))},function(t,e,n){"use strict";n.d(e,"c",(function(){return o})),n.d(e,"a",(function(){return a})),n.d(e,"b",(function(){return s}));let r="";const i={};function o(t){r=t}function a(){return r}function s(t){for(const e in i)if(t.startsWith(e)){const n=i[e];t=t.replace(e,n)}return t.startsWith("http://")||t.startsWith("https://")||(t="".concat(r).concat(t)),t}},function(t,e,n){"use strict";n.d(e,"b",(function(){return i})),n.d(e,"c",(function(){return o})),n.d(e,"a",(function(){return a}));var r=n(201);function i(t){return t&&"object"==typeof t&&t.isBuffer}function o(t){return r.toBuffer?r.toBuffer(t):t}function a(t){if(i(t)){return new Uint8Array(t.buffer,t.byteOffset,t.length).slice().buffer}return t}},function(t,e,n){"use strict";n.d(e,"a",(function(){return p}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(0),u=n.n(s),c=n(84),l=[255,255,255],h=[0,0,-1],f=0,p=function(){function t(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};i()(this,t),u()(this,"type","directional");var n=e.color,r=void 0===n?l:n,o=e.intensity,a=void 0===o?1:o,s=e.direction,p=void 0===s?h:s,d=e._shadow,A=void 0!==d&&d;this.id=e.id||"directional-".concat(f++),this.color=r,this.intensity=a,this.type="directional",this.direction=new c.a(p).normalize().toArray(),this.shadow=A}return a()(t,[{key:"getProjectedLight",value:function(t){return this}}]),t}()},function(t,e,n){"use strict";n.d(e,"a",(function(){return o}));var r=n(100),i=n(108);async function o(t,e){if("string"==typeof t){t=Object(r.b)(t);let n=e;return null!=e&&e.fetch&&"function"!=typeof(null==e?void 0:e.fetch)&&(n=e.fetch),await fetch(t,n)}return await Object(i.b)(t)}},function(t,e,n){"use strict";const r={name:"fp32",vs:"#ifdef LUMA_FP32_TAN_PRECISION_WORKAROUND\nconst float TWO_PI = 6.2831854820251465;\nconst float PI_2 = 1.5707963705062866;\nconst float PI_16 = 0.1963495463132858;\n\nconst float SIN_TABLE_0 = 0.19509032368659973;\nconst float SIN_TABLE_1 = 0.3826834261417389;\nconst float SIN_TABLE_2 = 0.5555702447891235;\nconst float SIN_TABLE_3 = 0.7071067690849304;\n\nconst float COS_TABLE_0 = 0.9807852506637573;\nconst float COS_TABLE_1 = 0.9238795042037964;\nconst float COS_TABLE_2 = 0.8314695954322815;\nconst float COS_TABLE_3 = 0.7071067690849304;\n\nconst float INVERSE_FACTORIAL_3 = 1.666666716337204e-01;\nconst float INVERSE_FACTORIAL_5 = 8.333333767950535e-03;\nconst float INVERSE_FACTORIAL_7 = 1.9841270113829523e-04;\nconst float INVERSE_FACTORIAL_9 = 2.75573188446287533e-06;\n\nfloat sin_taylor_fp32(float a) {\n  float r, s, t, x;\n\n  if (a == 0.0) {\n    return 0.0;\n  }\n\n  x = -a * a;\n  s = a;\n  r = a;\n\n  r = r * x;\n  t = r * INVERSE_FACTORIAL_3;\n  s = s + t;\n\n  r = r * x;\n  t = r * INVERSE_FACTORIAL_5;\n  s = s + t;\n\n  r = r * x;\n  t = r * INVERSE_FACTORIAL_7;\n  s = s + t;\n\n  r = r * x;\n  t = r * INVERSE_FACTORIAL_9;\n  s = s + t;\n\n  return s;\n}\n\nvoid sincos_taylor_fp32(float a, out float sin_t, out float cos_t) {\n  if (a == 0.0) {\n    sin_t = 0.0;\n    cos_t = 1.0;\n  }\n  sin_t = sin_taylor_fp32(a);\n  cos_t = sqrt(1.0 - sin_t * sin_t);\n}\n\nfloat tan_taylor_fp32(float a) {\n    float sin_a;\n    float cos_a;\n\n    if (a == 0.0) {\n        return 0.0;\n    }\n    float z = floor(a / TWO_PI);\n    float r = a - TWO_PI * z;\n\n    float t;\n    float q = floor(r / PI_2 + 0.5);\n    int j = int(q);\n\n    if (j < -2 || j > 2) {\n        return 1.0 / 0.0;\n    }\n\n    t = r - PI_2 * q;\n\n    q = floor(t / PI_16 + 0.5);\n    int k = int(q);\n    int abs_k = int(abs(float(k)));\n\n    if (abs_k > 4) {\n        return 1.0 / 0.0;\n    } else {\n        t = t - PI_16 * q;\n    }\n\n    float u = 0.0;\n    float v = 0.0;\n\n    float sin_t, cos_t;\n    float s, c;\n    sincos_taylor_fp32(t, sin_t, cos_t);\n\n    if (k == 0) {\n        s = sin_t;\n        c = cos_t;\n    } else {\n        if (abs(float(abs_k) - 1.0) < 0.5) {\n            u = COS_TABLE_0;\n            v = SIN_TABLE_0;\n        } else if (abs(float(abs_k) - 2.0) < 0.5) {\n            u = COS_TABLE_1;\n            v = SIN_TABLE_1;\n        } else if (abs(float(abs_k) - 3.0) < 0.5) {\n            u = COS_TABLE_2;\n            v = SIN_TABLE_2;\n        } else if (abs(float(abs_k) - 4.0) < 0.5) {\n            u = COS_TABLE_3;\n            v = SIN_TABLE_3;\n        }\n        if (k > 0) {\n            s = u * sin_t + v * cos_t;\n            c = u * cos_t - v * sin_t;\n        } else {\n            s = u * sin_t - v * cos_t;\n            c = u * cos_t + v * sin_t;\n        }\n    }\n\n    if (j == 0) {\n        sin_a = s;\n        cos_a = c;\n    } else if (j == 1) {\n        sin_a = c;\n        cos_a = -s;\n    } else if (j == -1) {\n        sin_a = -c;\n        cos_a = s;\n    } else {\n        sin_a = -s;\n        cos_a = -c;\n    }\n    return sin_a / cos_a;\n}\n#endif\n\nfloat tan_fp32(float a) {\n#ifdef LUMA_FP32_TAN_PRECISION_WORKAROUND\n  return tan_taylor_fp32(a);\n#else\n  return tan(a);\n#endif\n}\n",fs:null};var i="#define SMOOTH_EDGE_RADIUS 0.5",o={name:"geometry",vs:"\n".concat(i,"\n\nstruct VertexGeometry {\n  vec4 position;\n  vec3 worldPosition;\n  vec3 worldPositionAlt;\n  vec3 normal;\n  vec2 uv;\n  vec3 pickingColor;\n} geometry = VertexGeometry(\n  vec4(0.0, 0.0, 1.0, 0.0),\n  vec3(0.0),\n  vec3(0.0),\n  vec3(0.0),\n  vec2(0.0),\n  vec3(0.0)\n);\n"),fs:"\n".concat(i,"\n\nstruct FragmentGeometry {\n  vec2 uv;\n} geometry;\n\nfloat smoothedge(float edge, float x) {\n  return smoothstep(edge - SMOOTH_EDGE_RADIUS, edge + SMOOTH_EDGE_RADIUS, x);\n}\n")},a=n(12),s=Object.keys(a.a).map((function(t){return"const int COORDINATE_SYSTEM_".concat(t," = ").concat(a.a[t],";")})).join(""),u=Object.keys(a.d).map((function(t){return"const int PROJECTION_MODE_".concat(t," = ").concat(a.d[t],";")})).join(""),c=Object.keys(a.e).map((function(t){return"const int UNIT_".concat(t.toUpperCase()," = ").concat(a.e[t],";")})).join(""),l="".concat(s,"\n").concat(u,"\n").concat(c,'\n\nuniform int project_uCoordinateSystem;\nuniform int project_uProjectionMode;\nuniform float project_uScale;\nuniform bool project_uWrapLongitude;\nuniform vec3 project_uCommonUnitsPerMeter;\nuniform vec3 project_uCommonUnitsPerWorldUnit;\nuniform vec3 project_uCommonUnitsPerWorldUnit2;\nuniform vec4 project_uCenter;\nuniform mat4 project_uModelMatrix;\nuniform mat4 project_uViewProjectionMatrix;\nuniform vec2 project_uViewportSize;\nuniform float project_uDevicePixelRatio;\nuniform float project_uFocalDistance;\nuniform vec3 project_uCameraPosition;\nuniform vec3 project_uCoordinateOrigin;\nuniform vec3 project_uCommonOrigin;\nuniform bool project_uPseudoMeters;\n\nconst float TILE_SIZE = 512.0;\nconst float PI = 3.1415926536;\nconst float WORLD_SCALE = TILE_SIZE / (PI * 2.0);\nconst vec3 ZERO_64_LOW = vec3(0.0);\nconst float EARTH_RADIUS = 6370972.0; // meters\nconst float GLOBE_RADIUS = 256.0;\n\n// returns an adjustment factor for uCommonUnitsPerMeter\nfloat project_size_at_latitude(float lat) {\n  float y = clamp(lat, -89.9, 89.9);\n  return 1.0 / cos(radians(y));\n}\n\nfloat project_size() {\n  if (project_uProjectionMode == PROJECTION_MODE_WEB_MERCATOR &&\n    project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT &&\n    project_uPseudoMeters == false) {\n\n    // uCommonUnitsPerMeter in low-zoom Web Mercator is non-linear\n    // Adjust by 1 / cos(latitude)\n    // If geometry.position (vertex in common space) is populated, use it\n    // Otherwise use geometry.worldPosition (anchor in world space)\n    \n    if (geometry.position.w == 0.0) {\n      return project_size_at_latitude(geometry.worldPosition.y);\n    }\n\n    // latitude from common y: 2.0 * (atan(exp(y / TILE_SIZE * 2.0 * PI - PI)) - PI / 4.0)\n    // Taylor series of 1 / cos(latitude)\n    // Max error < 0.003\n  \n    float y = geometry.position.y / TILE_SIZE * 2.0 - 1.0;\n    float y2 = y * y;\n    float y4 = y2 * y2;\n    float y6 = y4 * y2;\n    return 1.0 + 4.9348 * y2 + 4.0587 * y4 + 1.5642 * y6;\n  }\n  return 1.0;\n}\n\nfloat project_size_at_latitude(float meters, float lat) {\n  return meters * project_uCommonUnitsPerMeter.z * project_size_at_latitude(lat);\n}\n\n//\n// Scaling offsets - scales meters to "world distance"\n// Note the scalar version of project_size is for scaling the z component only\n//\nfloat project_size(float meters) {\n  return meters * project_uCommonUnitsPerMeter.z * project_size();\n}\n\nvec2 project_size(vec2 meters) {\n  return meters * project_uCommonUnitsPerMeter.xy * project_size();\n}\n\nvec3 project_size(vec3 meters) {\n  return meters * project_uCommonUnitsPerMeter * project_size();\n}\n\nvec4 project_size(vec4 meters) {\n  return vec4(meters.xyz * project_uCommonUnitsPerMeter, meters.w);\n}\n\n// Get rotation matrix that aligns the z axis with the given up vector\n// Find 3 unit vectors ux, uy, uz that are perpendicular to each other and uz == up\nmat3 project_get_orientation_matrix(vec3 up) {\n  vec3 uz = normalize(up);\n  // Tangent on XY plane\n  vec3 ux = abs(uz.z) == 1.0 ? vec3(1.0, 0.0, 0.0) : normalize(vec3(uz.y, -uz.x, 0));\n  vec3 uy = cross(uz, ux);\n  return mat3(ux, uy, uz);\n}\n\nbool project_needs_rotation(vec3 commonPosition, out mat3 transform) {\n  if (project_uProjectionMode == PROJECTION_MODE_GLOBE) {\n    transform = project_get_orientation_matrix(commonPosition);\n    return true;\n  }\n  return false;\n}\n\n//\n// Projecting normal - transform deltas from current coordinate system to\n// normals in the worldspace\n//\nvec3 project_normal(vec3 vector) {\n  // Apply model matrix\n  vec4 normal_modelspace = project_uModelMatrix * vec4(vector, 0.0);\n  vec3 n = normalize(normal_modelspace.xyz * project_uCommonUnitsPerMeter);\n  mat3 rotation;\n  if (project_needs_rotation(geometry.position.xyz, rotation)) {\n    n = rotation * n;\n  }\n  return n;\n}\n\nvec4 project_offset_(vec4 offset) {\n  float dy = offset.y;\n  vec3 commonUnitsPerWorldUnit = project_uCommonUnitsPerWorldUnit + project_uCommonUnitsPerWorldUnit2 * dy;\n  return vec4(offset.xyz * commonUnitsPerWorldUnit, offset.w);\n}\n\n//\n// Projecting positions - non-linear projection: lnglats => unit tile [0-1, 0-1]\n//\nvec2 project_mercator_(vec2 lnglat) {\n  float x = lnglat.x;\n  if (project_uWrapLongitude) {\n    x = mod(x + 180., 360.0) - 180.;\n  }\n  float y = clamp(lnglat.y, -89.9, 89.9);\n  return vec2(\n    radians(x) + PI,\n    PI + log(tan_fp32(PI * 0.25 + radians(y) * 0.5))\n  ) * WORLD_SCALE;\n}\n\nvec3 project_globe_(vec3 lnglatz) {\n  float lambda = radians(lnglatz.x);\n  float phi = radians(lnglatz.y);\n  float cosPhi = cos(phi);\n  float D = (lnglatz.z / EARTH_RADIUS + 1.0) * GLOBE_RADIUS;\n\n  return vec3(\n    sin(lambda) * cosPhi,\n    -cos(lambda) * cosPhi,\n    sin(phi)\n  ) * D;\n}\n\n//\n// Projects positions (defined by project_uCoordinateSystem) to common space (defined by project_uProjectionMode)\n//\nvec4 project_position(vec4 position, vec3 position64Low) {\n  vec4 position_world = project_uModelMatrix * position;\n\n  // Work around for a Mac+NVIDIA bug https://github.com/visgl/deck.gl/issues/4145\n  if (project_uProjectionMode == PROJECTION_MODE_WEB_MERCATOR) {\n    if (project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT) {\n      return vec4(\n        project_mercator_(position_world.xy),\n        project_size_at_latitude(position_world.z, position_world.y),\n        position_world.w\n      );\n    }\n    if (project_uCoordinateSystem == COORDINATE_SYSTEM_CARTESIAN) {\n      position_world.xyz += project_uCoordinateOrigin;\n    }\n  }\n  if (project_uProjectionMode == PROJECTION_MODE_GLOBE) {\n    if (project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT) {\n      return vec4(\n        project_globe_(position_world.xyz),\n        position_world.w\n      );\n    }\n  }\n  if (project_uProjectionMode == PROJECTION_MODE_WEB_MERCATOR_AUTO_OFFSET) {\n    if (project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT) {\n      if (abs(position_world.y - project_uCoordinateOrigin.y) > 0.25) {\n        // Too far from the projection center for offset mode to be accurate\n        // Only use high parts\n        return vec4(\n          project_mercator_(position_world.xy) - project_uCommonOrigin.xy,\n          project_size(position_world.z),\n          position_world.w\n        );\n      }\n    }\n  }\n  if (project_uProjectionMode == PROJECTION_MODE_IDENTITY ||\n    (project_uProjectionMode == PROJECTION_MODE_WEB_MERCATOR_AUTO_OFFSET &&\n    (project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT ||\n     project_uCoordinateSystem == COORDINATE_SYSTEM_CARTESIAN))) {\n    // Subtract high part of 64 bit value. Convert remainder to float32, preserving precision.\n    position_world.xyz -= project_uCoordinateOrigin;\n  }\n\n  // Translation is already added to the high parts\n  return project_offset_(position_world + project_uModelMatrix * vec4(position64Low, 0.0));\n}\n\nvec4 project_position(vec4 position) {\n  return project_position(position, ZERO_64_LOW);\n}\n\nvec3 project_position(vec3 position, vec3 position64Low) {\n  vec4 projected_position = project_position(vec4(position, 1.0), position64Low);\n  return projected_position.xyz;\n}\n\nvec3 project_position(vec3 position) {\n  vec4 projected_position = project_position(vec4(position, 1.0), ZERO_64_LOW);\n  return projected_position.xyz;\n}\n\nvec2 project_position(vec2 position) {\n  vec4 projected_position = project_position(vec4(position, 0.0, 1.0), ZERO_64_LOW);\n  return projected_position.xy;\n}\n\nvec4 project_common_position_to_clipspace(vec4 position, mat4 viewProjectionMatrix, vec4 center) {\n  return viewProjectionMatrix * position + center;\n}\n\n//\n// Projects from common space coordinates to clip space.\n// Uses project_uViewProjectionMatrix\n//\nvec4 project_common_position_to_clipspace(vec4 position) {\n  return project_common_position_to_clipspace(position, project_uViewProjectionMatrix, project_uCenter);\n}\n\n// Returns a clip space offset that corresponds to a given number of screen pixels\nvec2 project_pixel_size_to_clipspace(vec2 pixels) {\n  vec2 offset = pixels / project_uViewportSize * project_uDevicePixelRatio * 2.0;\n  return offset * project_uFocalDistance;\n}\n\nfloat project_size_to_pixel(float meters) {\n  return project_size(meters) * project_uScale;\n}\nfloat project_size_to_pixel(float size, int unit) {\n  if (unit == UNIT_METERS) return project_size_to_pixel(size);\n  if (unit == UNIT_COMMON) return size * project_uScale;\n  // UNIT_PIXELS\n  return size;\n}\nfloat project_pixel_size(float pixels) {\n  return pixels / project_uScale;\n}\nvec2 project_pixel_size(vec2 pixels) {\n  return pixels / project_uScale;\n}\n'),h=n(124),f={};e.a={name:"project",dependencies:[r,o],vs:l,getUniforms:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:f;return"viewport"in t?Object(h.b)(t):{}}}},function(t,e,n){"use strict";var r=n(51),i=n(155);var o=n(195),a=n(45),s=n(22),u=n(46),c=n(126),l=n(91),h=n(62),f=n(79);async function p(t,e,n,d){Object(r.a)(!d||"object"==typeof d),!e||Array.isArray(e)||Object(a.a)(e)||(d=void 0,n=e,e=void 0),t=await t,n=n||{};const{url:A}=Object(h.b)(t),g=e,m=Object(l.b)(g,d),y=await Object(f.a)(t,m,n);return y?(n=Object(u.d)(n,y,m,A),d=Object(l.a)({url:A,parse:p,loaders:m},n,d),await async function(t,e,n,a){if(function(t,e=i.a){Object(r.a)(t,"no worker provided");const n=t.version}(t),Object(s.j)(e)){const t=e,{ok:n,redirected:r,status:i,statusText:o,type:s,url:u}=t,c=Object.fromEntries(t.headers.entries());a.response={headers:c,ok:n,redirected:r,status:i,statusText:o,type:s,url:u}}if(e=await Object(c.a)(e,t,n),t.parseTextSync&&"string"==typeof e)return n.dataType="text",t.parseTextSync(e,n,a,t);if(Object(o.a)(t,n))return await Object(o.b)(t,e,n,a,p);if(t.parseText&&"string"==typeof e)return await t.parseText(e,n,a,t);if(t.parse)return await t.parse(e,n,a,t);throw Object(r.a)(!t.parseSync),new Error("".concat(t.id," loader - no parser found and worker is disabled"))}(y,t,n,d)):null}n.d(e,"a",(function(){return p}))},function(t,e,n){"use strict";function r(t,e){if(!t)throw new Error(e||"loader assertion failed.")}n.d(e,"a",(function(){return r}))},function(t,e,n){"use strict";var r=n(7),i=n(54),o=n(10);let a="";n.d(e,"a",(function(){return s}));class s extends i.a{get[Symbol.toStringTag](){return"Texture2D"}static isSupported(t,e){return i.a.isSupported(t,e)}constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};var n,i;Object(r.b)(t),(e instanceof Promise||"string"==typeof e)&&(e={data:e}),"string"==typeof e.data&&(e=Object.assign({},e,{data:(n=e.data,Object(o.a)("string"==typeof n),n=a+n,new Promise((t,e)=>{try{const r=new Image;r.onload=()=>t(r),r.onerror=()=>e(new Error("Could not load image ".concat(n,"."))),r.crossOrigin=i&&i.crossOrigin||"anonymous",r.src=n}catch(t){e(t)}}))})),super(t,Object.assign({},e,{target:3553})),this.initialize(e),Object.seal(this)}}},function(t,e,n){"use strict";n.d(e,"b",(function(){return o})),n.d(e,"a",(function(){return a}));var r=n(22),i=n(62);async function o(t){if(Object(r.j)(t))return t;const e={},n=Object(i.a)(t);n>=0&&(e["content-length"]=String(n));const{url:o,type:a}=Object(i.b)(t);a&&(e["content-type"]=a);const s=await async function(t){if("string"==typeof t)return"data:,".concat(t.slice(0,5));if(t instanceof Blob){const e=t.slice(0,5);return await new Promise(t=>{const n=new FileReader;n.onload=e=>{var n;return t(null==e||null===(n=e.target)||void 0===n?void 0:n.result)},n.readAsDataURL(e)})}if(t instanceof ArrayBuffer){const e=function(t){let e="";const n=new Uint8Array(t);for(let t=0;t<n.byteLength;t++)e+=String.fromCharCode(n[t]);return btoa(e)}(t.slice(0,5));return"data:base64,".concat(e)}return null}(t);s&&(e["x-first-bytes"]=s),"string"==typeof t&&(t=(new TextEncoder).encode(t));const u=new Response(t,{headers:e});return Object.defineProperty(u,"url",{value:o}),u}async function a(t){if(!t.ok){const e=await async function(t){let e="Failed to fetch resource ".concat(t.url," (").concat(t.status,"): ");try{const n=t.headers.get("Content-Type");let r=t.statusText;n.includes("application/json")&&(r+=" ".concat(await t.text())),e+=r,e=e.length>60?"".concat(e.slice(0,60),"..."):e}catch(t){}return e}(t);throw new Error(e)}}},function(t,e,n){"use strict";var r=n(38);const i="EXT_color_buffer_float";var o={33189:{bpp:2},33190:{gl2:!0,bpp:3},36012:{gl2:!0,bpp:4},36168:{bpp:1},34041:{bpp:4},35056:{gl2:!0,bpp:4},36013:{gl2:!0,bpp:5},32854:{bpp:2},36194:{bpp:2},32855:{bpp:2},33321:{gl2:!0,bpp:1},33330:{gl2:!0,bpp:1},33329:{gl2:!0,bpp:1},33332:{gl2:!0,bpp:2},33331:{gl2:!0,bpp:2},33334:{gl2:!0,bpp:4},33333:{gl2:!0,bpp:4},33323:{gl2:!0,bpp:2},33336:{gl2:!0,bpp:2},33335:{gl2:!0,bpp:2},33338:{gl2:!0,bpp:4},33337:{gl2:!0,bpp:4},33340:{gl2:!0,bpp:8},33339:{gl2:!0,bpp:8},32849:{gl2:!0,bpp:3},32856:{gl2:!0,bpp:4},32857:{gl2:!0,bpp:4},36220:{gl2:!0,bpp:4},36238:{gl2:!0,bpp:4},36975:{gl2:!0,bpp:4},36214:{gl2:!0,bpp:8},36232:{gl2:!0,bpp:8},36226:{gl2:!0,bpp:16},36208:{gl2:!0,bpp:16},33325:{gl2:i,bpp:2},33327:{gl2:i,bpp:4},34842:{gl2:i,bpp:8},33326:{gl2:i,bpp:4},33328:{gl2:i,bpp:8},34836:{gl2:i,bpp:16},35898:{gl2:i,bpp:4}},a=n(7),s=n(10);n.d(e,"a",(function(){return u}));class u extends r.a{get[Symbol.toStringTag](){return"Renderbuffer"}static isSupported(t){let{format:e}=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{format:null};return!e||function(t,e,n){const r=n[e];if(!r)return!1;const i=Object(a.j)(t)&&r.gl2||r.gl1;return"string"==typeof i?t.getExtension(i):i}(t,e,o)}static getSamplesForFormat(t,e){let{format:n}=e;return t.getInternalformatParameter(36161,n,32937)}constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};super(t,e),this.initialize(e),Object.seal(this)}initialize(t){let{format:e,width:n=1,height:r=1,samples:i=0}=t;return Object(s.a)(e,"Needs format"),this._trackDeallocatedMemory(),this.gl.bindRenderbuffer(36161,this.handle),0!==i&&Object(a.j)(this.gl)?this.gl.renderbufferStorageMultisample(36161,i,e,n,r):this.gl.renderbufferStorage(36161,e,n,r),this.format=e,this.width=n,this.height=r,this.samples=i,this._trackAllocatedMemory(this.width*this.height*(this.samples||1)*o[this.format].bpp),this}resize(t){let{width:e,height:n}=t;return e!==this.width||n!==this.height?this.initialize({width:e,height:n,format:this.format,samples:this.samples}):this}_createHandle(){return this.gl.createRenderbuffer()}_deleteHandle(){this.gl.deleteRenderbuffer(this.handle),this._trackDeallocatedMemory()}_bindHandle(t){this.gl.bindRenderbuffer(36161,t)}_syncHandle(t){this.format=this.getParameter(36164),this.width=this.getParameter(36162),this.height=this.getParameter(36163),this.samples=this.getParameter(36011)}_getParameter(t){this.gl.bindRenderbuffer(36161,this.handle);return this.gl.getRenderbufferParameter(36161,t)}}},function(t,e,n){"use strict";(function(t){n.d(e,"b",(function(){return r})),n.d(e,"c",(function(){return i})),n.d(e,"a",(function(){return o}));const r="undefined"!=typeof navigator&&navigator.userAgent?navigator.userAgent.toLowerCase():"",i="undefined"!=typeof window?window:t;void 0!==t||window,"undefined"!=typeof document&&document;let o=!1;try{const t={get passive(){return o=!0,!0}};i.addEventListener("test",null,t),i.removeEventListener("test",null)}catch(t){o=!1}}).call(this,n(71))},function(t,e,n){"use strict";(function(t){n.d(e,"a",(function(){return r}));"undefined"!=typeof window&&window,void 0!==t||window;var r="undefined"!=typeof document?document:{}}).call(this,n(71))},function(t,e,n){"use strict";n.d(e,"c",(function(){return a})),n.d(e,"b",(function(){return s})),n.d(e,"a",(function(){return u}));var r=n(45),i=n(46);const o=()=>{const t=Object(i.c)();return t.loaderRegistry=t.loaderRegistry||[],t.loaderRegistry};function a(t){const e=o();t=Array.isArray(t)?t:[t];for(const n of t){const t=Object(r.b)(n);e.find(e=>t===e)||e.unshift(t)}}function s(){return o()}function u(){Object(i.c)().loaderRegistry=[]}},function(t,e,n){"use strict";n.d(e,"a",(function(){return C})),n.d(e,"b",(function(){return P}));var r=n(27),i=n.n(r),o=n(8),a=n.n(o),s=n(0),u=n.n(s),c=n(3),l=n.n(c),h=n(4),f=n.n(h),p=n(5),d=n.n(p),A=n(6),g=n.n(A),m=n(1),y=n.n(m),v=n(13),_=n(58),b=n(125),x=n(19),w=n(29),E=n(50);function O(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function S(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?O(Object(n),!0).forEach((function(e){u()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):O(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function T(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=y()(t);if(e){var i=y()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return g()(this,n)}}var C=function(t){d()(n,t);var e=T(n);function n(t){var r;l()(this,n);var i=t.width,o=t.height,a=t.latitude,s=t.longitude,u=t.zoom,c=t.bearing,h=void 0===c?0:c,f=t.pitch,p=void 0===f?0:f,d=t.altitude,A=void 0===d?1.5:d,g=t.position,m=void 0===g?[0,0,0]:g,y=t.maxZoom,v=void 0===y?20:y,_=t.minZoom,b=void 0===_?0:_,x=t.maxPitch,E=void 0===x?60:x,O=t.minPitch,S=void 0===O?0:O,T=t.startPanLngLat,C=t.startZoomLngLat,P=t.startRotatePos,M=t.startBearing,I=t.startPitch,B=t.startZoom,R=t.normalize,k=void 0===R||R;return Object(w.a)(Number.isFinite(s)),Object(w.a)(Number.isFinite(a)),Object(w.a)(Number.isFinite(u)),(r=e.call(this,{width:i,height:o,latitude:a,longitude:s,zoom:u,bearing:h,pitch:p,altitude:A,maxZoom:v,minZoom:b,maxPitch:E,minPitch:S,normalize:k,position:m},{startPanLngLat:T,startZoomLngLat:C,startRotatePos:P,startBearing:M,startPitch:I,startZoom:B})).makeViewport=t.makeViewport,r}return f()(n,[{key:"panStart",value:function(t){var e=t.pos;return this._getUpdatedState({startPanLngLat:this._unproject(e)})}},{key:"pan",value:function(t){var e=t.pos,n=t.startPos,r=this.getState().startPanLngLat||this._unproject(n);if(!r)return this;var i=this.makeViewport(this.getViewportProps()).panByPosition(r,e);return this._getUpdatedState(i)}},{key:"panEnd",value:function(){return this._getUpdatedState({startPanLngLat:null})}},{key:"rotateStart",value:function(t){var e=t.pos;return this._getUpdatedState({startRotatePos:e,startBearing:this.getViewportProps().bearing,startPitch:this.getViewportProps().pitch})}},{key:"rotate",value:function(t){var e,n=t.pos,r=t.deltaAngleX,i=void 0===r?0:r,o=t.deltaAngleY,a=void 0===o?0:o,s=this.getState(),u=s.startRotatePos,c=s.startBearing,l=s.startPitch;return u&&void 0!==c&&void 0!==l?(e=n?this._getNewRotation(n,u,l,c):{bearing:c+i,pitch:l+a},this._getUpdatedState(e)):this}},{key:"rotateEnd",value:function(){return this._getUpdatedState({startBearing:null,startPitch:null})}},{key:"zoomStart",value:function(t){var e=t.pos;return this._getUpdatedState({startZoomLngLat:this._unproject(e),startZoom:this.getViewportProps().zoom})}},{key:"zoom",value:function(t){var e=t.pos,n=t.startPos,r=t.scale,i=this.getState(),o=i.startZoom,a=i.startZoomLngLat;if(a||(o=this.getViewportProps().zoom,a=this._unproject(n)||this._unproject(e)),!a)return this;var s=this.getViewportProps(),u=s.maxZoom,c=s.minZoom,l=o+Math.log2(r);l=Object(v.a)(l,c,u);var h=this.makeViewport(S(S({},this.getViewportProps()),{},{zoom:l}));return this._getUpdatedState(S({zoom:l},h.panByPosition(a,e)))}},{key:"zoomEnd",value:function(){return this._getUpdatedState({startZoomLngLat:null,startZoom:null})}},{key:"zoomIn",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:2;return this._zoomFromCenter(t)}},{key:"zoomOut",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:2;return this._zoomFromCenter(1/t)}},{key:"moveLeft",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:100;return this._panFromCenter([t,0])}},{key:"moveRight",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:100;return this._panFromCenter([-t,0])}},{key:"moveUp",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:100;return this._panFromCenter([0,t])}},{key:"moveDown",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:100;return this._panFromCenter([0,-t])}},{key:"rotateLeft",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:15;return this._getUpdatedState({bearing:this.getViewportProps().bearing-t})}},{key:"rotateRight",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:15;return this._getUpdatedState({bearing:this.getViewportProps().bearing+t})}},{key:"rotateUp",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:10;return this._getUpdatedState({pitch:this.getViewportProps().pitch+t})}},{key:"rotateDown",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:10;return this._getUpdatedState({pitch:this.getViewportProps().pitch-t})}},{key:"shortestPathFrom",value:function(t){var e=t.getViewportProps(),n=S({},this.getViewportProps()),r=n.bearing,i=n.longitude;return Math.abs(r-e.bearing)>180&&(n.bearing=r<0?r+360:r-360),Math.abs(i-e.longitude)>180&&(n.longitude=i<0?i+360:i-360),n}},{key:"applyConstraints",value:function(t){var e=t.maxZoom,n=t.minZoom,r=t.zoom;t.zoom=Object(v.a)(r,n,e);var i=t.maxPitch,o=t.minPitch,a=t.pitch;t.pitch=Object(v.a)(a,o,i);var s=t.normalize;return(void 0===s||s)&&Object.assign(t,Object(x.m)(t)),t}},{key:"_zoomFromCenter",value:function(t){var e=this.getViewportProps(),n=e.width,r=e.height;return this.zoom({pos:[n/2,r/2],scale:t})}},{key:"_panFromCenter",value:function(t){var e=this.getViewportProps(),n=e.width,r=e.height;return this.pan({startPos:[n/2,r/2],pos:[n/2+t[0],r/2+t[1]]})}},{key:"_getUpdatedState",value:function(t){return new this.constructor(S(S(S({makeViewport:this.makeViewport},this.getViewportProps()),this.getState()),t))}},{key:"_unproject",value:function(t){var e=this.makeViewport(this.getViewportProps());return t&&e.unproject(t)}},{key:"_getNewRotation",value:function(t,e,n,r){var i=t[0]-e[0],o=t[1]-e[1],a=t[1],s=e[1],u=this.getViewportProps(),c=u.width,l=u.height,h=i/c,f=0;o>0?Math.abs(l-s)>5&&(f=o/(s-l)*1.2):o<0&&s>5&&(f=1-a/s),f=Object(v.a)(f,-1,1);var p=this.getViewportProps(),d=p.minPitch,A=p.maxPitch,g=n;return f>0?g=n+f*(A-n):f<0&&(g=n-f*(d-n)),{pitch:g,bearing:r+180*h}}}]),n}(b.a),P=function(t){d()(n,t);var e=T(n);function n(){var t;l()(this,n);for(var r=arguments.length,o=new Array(r),a=0;a<r;a++)o[a]=arguments[a];return t=e.call.apply(e,[this].concat(o)),u()(i()(t),"ControllerState",C),u()(i()(t),"transition",{transitionDuration:300,transitionInterpolator:new E.a({transitionProps:{compare:["longitude","latitude","zoom","bearing","pitch","position"],required:["longitude","latitude","zoom"]}})}),u()(i()(t),"dragMode","pan"),t}return f()(n,[{key:"setProps",value:function(t){t.position=t.position||[0,0,0];var e=this.props;a()(y()(n.prototype),"setProps",this).call(this,t),(!e||e.height!==t.height)&&this.updateViewport(new this.ControllerState(S(S({makeViewport:this.makeViewport},t),this.state)))}}]),n}(_.a)},function(t,e,n){"use strict";n.d(e,"a",(function(){return h}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(13),u=n(29);function c(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return l(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return l(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function l(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var h=function(){function t(e){i()(this,t);var n=e.compare,r=e.extract,o=e.required;this._propsToCompare=n,this._propsToExtract=r||n,this._requiredProps=o}return a()(t,[{key:"arePropsEqual",value:function(t,e){var n,r=c(this._propsToCompare);try{for(r.s();!(n=r.n()).done;){var i=n.value;if(!(i in t)||!(i in e)||!Object(s.d)(t[i],e[i]))return!1}}catch(t){r.e(t)}finally{r.f()}return!0}},{key:"initializeProps",value:function(t,e){var n,r={},i={},o=c(this._propsToExtract);try{for(o.s();!(n=o.n()).done;){var a=n.value;(a in t||a in e)&&(r[a]=t[a],i[a]=e[a])}}catch(t){o.e(t)}finally{o.f()}return this._checkRequiredProps(r),this._checkRequiredProps(i),{start:r,end:i}}},{key:"getDuration",value:function(t,e){return e.transitionDuration}},{key:"_checkRequiredProps",value:function(t){this._requiredProps&&this._requiredProps.forEach((function(e){var n=t[e];Object(u.a)(Number.isFinite(n)||Array.isArray(n),"".concat(e," is required for transition"))}))}}]),t}()},function(t,e,n){"use strict";n.d(e,"a",(function(){return O})),n.d(e,"b",(function(){return S}));var r=n(27),i=n.n(r),o=n(0),a=n.n(o),s=n(3),u=n.n(s),c=n(4),l=n.n(c),h=n(5),f=n.n(h),p=n(6),d=n.n(p),A=n(1),g=n.n(A),m=n(13),y=n(58),v=n(125),_=n(35),b=n(50);function x(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function w(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?x(Object(n),!0).forEach((function(e){a()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):x(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function E(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=g()(t);if(e){var i=g()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return d()(this,n)}}var O=function(t){f()(n,t);var e=E(n);function n(t){var r;u()(this,n);var i=t.width,o=t.height,a=t.rotationX,s=void 0===a?0:a,c=t.rotationOrbit,l=void 0===c?0:c,h=t.target,f=void 0===h?[0,0,0]:h,p=t.zoom,d=void 0===p?0:p,A=t.minRotationX,g=void 0===A?-90:A,m=t.maxRotationX,y=void 0===m?90:m,v=t.minZoom,_=void 0===v?-1/0:v,b=t.maxZoom,x=void 0===b?1/0:b,w=t.startPanPosition,E=t.startRotatePos,O=t.startRotationX,S=t.startRotationOrbit,T=t.startZoomPosition,C=t.startZoom;return(r=e.call(this,{width:i,height:o,rotationX:s,rotationOrbit:l,target:f,zoom:d,minRotationX:g,maxRotationX:y,minZoom:_,maxZoom:x},{startPanPosition:w,startRotatePos:E,startRotationX:O,startRotationOrbit:S,startZoomPosition:T,startZoom:C})).makeViewport=t.makeViewport,r}return l()(n,[{key:"panStart",value:function(t){var e=t.pos;return this._getUpdatedState({startPanPosition:this._unproject(e)})}},{key:"pan",value:function(t){var e=t.pos,n=t.startPosition,r=this.getState().startPanPosition||n;if(!r)return this;var i=this.makeViewport(this.getViewportProps()).panByPosition(r,e);return this._getUpdatedState(i)}},{key:"panEnd",value:function(){return this._getUpdatedState({startPanPosition:null})}},{key:"rotateStart",value:function(t){var e=t.pos;return this._getUpdatedState({startRotatePos:e,startRotationX:this.getViewportProps().rotationX,startRotationOrbit:this.getViewportProps().rotationOrbit})}},{key:"rotate",value:function(t){var e,n=t.pos,r=t.deltaAngleX,i=void 0===r?0:r,o=t.deltaAngleY,a=void 0===o?0:o,s=this.getState(),u=s.startRotatePos,c=s.startRotationX,l=s.startRotationOrbit,h=this.getViewportProps(),f=h.width,p=h.height;if(!u||void 0===c||void 0===l)return this;if(n){var d=(n[0]-u[0])/f;(c<-90||c>90)&&(d*=-1),e={rotationX:c+180*((n[1]-u[1])/p),rotationOrbit:l+180*d}}else e={rotationX:c+a,rotationOrbit:l+i};return this._getUpdatedState(e)}},{key:"rotateEnd",value:function(){return this._getUpdatedState({startRotationX:null,startRotationOrbit:null})}},{key:"shortestPathFrom",value:function(t){var e=t.getViewportProps(),n=w({},this.getViewportProps()),r=n.rotationOrbit;return Math.abs(r-e.rotationOrbit)>180&&(n.rotationOrbit=r<0?r+360:r-360),n}},{key:"zoomStart",value:function(t){var e=t.pos;return this._getUpdatedState({startZoomPosition:this._unproject(e),startZoom:this.getViewportProps().zoom})}},{key:"zoom",value:function(t){var e=t.pos,n=t.startPos,r=t.scale,i=this.getState(),o=i.startZoom,a=i.startZoomPosition;if(a||(o=this.getViewportProps().zoom,a=this._unproject(n)||this._unproject(e)),!a)return this;var s=this._calculateNewZoom({scale:r,startZoom:o}),u=this.makeViewport(w(w({},this.getViewportProps()),{},{zoom:s}));return this._getUpdatedState(w({zoom:s},u.panByPosition(a,e)))}},{key:"zoomEnd",value:function(){return this._getUpdatedState({startZoomPosition:null,startZoom:null})}},{key:"zoomIn",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:2;return this._getUpdatedState({zoom:this._calculateNewZoom({scale:t})})}},{key:"zoomOut",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:2;return this._getUpdatedState({zoom:this._calculateNewZoom({scale:1/t})})}},{key:"moveLeft",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:50;return this._panFromCenter([-t,0])}},{key:"moveRight",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:50;return this._panFromCenter([t,0])}},{key:"moveUp",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:50;return this._panFromCenter([0,-t])}},{key:"moveDown",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:50;return this._panFromCenter([0,t])}},{key:"rotateLeft",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:15;return this._getUpdatedState({rotationOrbit:this.getViewportProps().rotationOrbit-t})}},{key:"rotateRight",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:15;return this._getUpdatedState({rotationOrbit:this.getViewportProps().rotationOrbit+t})}},{key:"rotateUp",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:10;return this._getUpdatedState({rotationX:this.getViewportProps().rotationX-t})}},{key:"rotateDown",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:10;return this._getUpdatedState({rotationX:this.getViewportProps().rotationX+t})}},{key:"_unproject",value:function(t){var e=this.makeViewport(this.getViewportProps());return t&&e.unproject(t)}},{key:"_calculateNewZoom",value:function(t){var e=t.scale,n=t.startZoom,r=this.getViewportProps(),i=r.maxZoom,o=r.minZoom;void 0===n&&(n=this.getViewportProps().zoom);var a=n+Math.log2(e);return Object(m.a)(a,o,i)}},{key:"_panFromCenter",value:function(t){var e=this.getViewportProps(),n=e.width,r=e.height,i=e.target;return this.pan({startPosition:i,pos:[n/2+t[0],r/2+t[1]]})}},{key:"_getUpdatedState",value:function(t){return new this.constructor(w(w(w({makeViewport:this.makeViewport},this.getViewportProps()),this.getState()),t))}},{key:"applyConstraints",value:function(t){var e=t.maxZoom,n=t.minZoom,r=t.zoom,i=t.maxRotationX,o=t.minRotationX,a=t.rotationOrbit;return t.zoom=Array.isArray(r)?[Object(m.a)(r[0],n,e),Object(m.a)(r[1],n,e)]:Object(m.a)(r,n,e),t.rotationX=Object(m.a)(t.rotationX,o,i),(a<-180||a>180)&&(t.rotationOrbit=Object(_.e)(a+180,360)-180),t}}]),n}(v.a),S=function(t){f()(n,t);var e=E(n);function n(){var t;u()(this,n);for(var r=arguments.length,o=new Array(r),s=0;s<r;s++)o[s]=arguments[s];return t=e.call.apply(e,[this].concat(o)),a()(i()(t),"ControllerState",O),a()(i()(t),"transition",{transitionDuration:300,transitionInterpolator:new b.a({transitionProps:{compare:["target","zoom","rotationX","rotationOrbit"],required:["target","zoom"]}})}),t}return n}(y.a)},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(8),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(217),y=n(235),v=n(234),_=n(12),b=n(164),x=n(251),w=n(189),E=n(186),O=n(60),S=n(64),T=n(219),C=n(37);function P(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return M(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return M(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function M(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function I(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function B(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?I(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):I(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function R(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}var k=function(t){l()(n,t);var e=R(n);function n(t){i()(this,n);var r=t.fp64,o=t.IndexType,a=void 0===o?Uint32Array:o;return e.call(this,B(B({},t),{},{attributes:{positions:{size:3,type:r?Float64Array:Float32Array},vertexValid:{type:Uint8ClampedArray,size:1},indices:{type:a,size:1}}}))}return a()(n,[{key:"get",value:function(t){var e=this.attributes;return"indices"===t?e.indices&&e.indices.subarray(0,this.vertexCount):e[t]}},{key:"updateGeometry",value:function(t){u()(d()(n.prototype),"updateGeometry",this).call(this,t);var e=this.buffers.indices;if(e)this.vertexCount=(e.value||e).length;else if(this.data&&!this.getGeometry)throw new Error("missing indices buffer")}},{key:"normalizeGeometry",value:function(t){if(this.normalize){var e=S.d(t,this.positionSize);return this.opts.resolution?Object(C.b)(S.b(e),S.a(e),{size:this.positionSize,gridResolution:this.opts.resolution,edgeTypes:!0}):this.opts.wrapLongitude?Object(C.c)(S.b(e),S.a(e),{size:this.positionSize,maxLatitude:86,edgeTypes:!0}):e}return t}},{key:"getGeometrySize",value:function(t){if(D(t)){var e,n=0,r=P(t);try{for(r.s();!(e=r.n()).done;){var i=e.value;n+=this.getGeometrySize(i)}}catch(t){r.e(t)}finally{r.f()}return n}return S.b(t).length/this.positionSize}},{key:"getGeometryFromBuffer",value:function(t){return this.normalize||!this.buffers.indices?u()(d()(n.prototype),"getGeometryFromBuffer",this).call(this,t):null}},{key:"updateGeometryAttributes",value:function(t,e){if(t&&D(t)){var n,r=P(t);try{for(r.s();!(n=r.n()).done;){var i=n.value,o=this.getGeometrySize(i);e.geometrySize=o,this.updateGeometryAttributes(i,e),e.vertexStart+=o,e.indexStart=this.indexStarts[e.geometryIndex+1]}}catch(t){r.e(t)}finally{r.f()}}else this._updateIndices(t,e),this._updatePositions(t,e),this._updateVertexValid(t,e)}},{key:"_updateIndices",value:function(t,e){var n=e.geometryIndex,r=e.vertexStart,i=e.indexStart,o=this.attributes,a=this.indexStarts,s=this.typedArrayManager,u=o.indices;if(u&&t){var c=i,l=S.c(t,this.positionSize,this.opts.preproject,this.opts.full3d);u=s.allocate(u,i+l.length,{copy:!0});for(var h=0;h<l.length;h++)u[c++]=l[h]+r;a[n+1]=i+l.length,o.indices=u}}},{key:"_updatePositions",value:function(t,e){var n=e.vertexStart,r=e.geometrySize,i=this.attributes.positions,o=this.positionSize;if(i&&t)for(var a=S.b(t),s=n,u=0;u<r;s++,u++){var c=a[u*o],l=a[u*o+1],h=o>2?a[u*o+2]:0;i[3*s]=c,i[3*s+1]=l,i[3*s+2]=h}}},{key:"_updateVertexValid",value:function(t,e){var n=e.vertexStart,r=e.geometrySize,i=this.positionSize,o=this.attributes.vertexValid,a=t&&S.a(t);if(t&&t.edgeTypes?o.set(t.edgeTypes,n):o.fill(1,n,n+r),a)for(var s=0;s<a.length;s++)o[n+a[s]/i-1]=0;o[n+r-1]=0}}]),n}(T.a);function D(t){return Array.isArray(t)&&t.length>0&&!Number.isFinite(t[0])}var L="\nattribute vec2 vertexPositions;\nattribute float vertexValid;\n\nuniform bool extruded;\nuniform bool isWireframe;\nuniform float elevationScale;\nuniform float opacity;\n\nvarying vec4 vColor;\n\nstruct PolygonProps {\n  vec4 fillColors;\n  vec4 lineColors;\n  vec3 positions;\n  vec3 nextPositions;\n  vec3 pickingColors;\n  vec3 positions64Low;\n  vec3 nextPositions64Low;\n  float elevations;\n};\n\nvec3 project_offset_normal(vec3 vector) {\n  if (project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT ||\n    project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT_OFFSETS) {\n    // normals generated by the polygon tesselator are in lnglat offsets instead of meters\n    return normalize(vector * project_uCommonUnitsPerWorldUnit);\n  }\n  return project_normal(vector);\n}\n\nvoid calculatePosition(PolygonProps props) {\n#ifdef IS_SIDE_VERTEX\n  if(vertexValid < 0.5){\n    gl_Position = vec4(0.);\n    return;\n  }\n#endif\n\n  vec3 pos;\n  vec3 pos64Low;\n  vec3 normal;\n  vec4 colors = isWireframe ? props.lineColors : props.fillColors;\n\n  geometry.worldPosition = props.positions;\n  geometry.worldPositionAlt = props.nextPositions;\n  geometry.pickingColor = props.pickingColors;\n\n#ifdef IS_SIDE_VERTEX\n  pos = mix(props.positions, props.nextPositions, vertexPositions.x);\n  pos64Low = mix(props.positions64Low, props.nextPositions64Low, vertexPositions.x);\n#else\n  pos = props.positions;\n  pos64Low = props.positions64Low;\n#endif\n\n  if (extruded) {\n    pos.z += props.elevations * vertexPositions.y * elevationScale;\n  }\n  gl_Position = project_position_to_clipspace(pos, pos64Low, vec3(0.), geometry.position);\n\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  if (extruded) {\n  #ifdef IS_SIDE_VERTEX\n    normal = vec3(\n      props.positions.y - props.nextPositions.y + (props.positions64Low.y - props.nextPositions64Low.y),\n      props.nextPositions.x - props.positions.x + (props.nextPositions64Low.x - props.positions64Low.x),\n      0.0);\n    normal = project_offset_normal(normal);\n  #else\n    normal = project_normal(vec3(0.0, 0.0, 1.0));\n  #endif\n    geometry.normal = normal;\n    vec3 lightColor = lighting_getLightColor(colors.rgb, project_uCameraPosition, geometry.position.xyz, normal);\n    vColor = vec4(lightColor, colors.a * opacity);\n  } else {\n    vColor = vec4(colors.rgb, colors.a * opacity);\n  }\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n",j="#define SHADER_NAME solid-polygon-layer-vertex-shader\n\nattribute vec3 positions;\nattribute vec3 positions64Low;\nattribute float elevations;\nattribute vec4 fillColors;\nattribute vec4 lineColors;\nattribute vec3 pickingColors;\n\n".concat(L,"\n\nvoid main(void) {\n  PolygonProps props;\n\n  props.positions = positions;\n  props.positions64Low = positions64Low;\n  props.elevations = elevations;\n  props.fillColors = fillColors;\n  props.lineColors = lineColors;\n  props.pickingColors = pickingColors;\n\n  calculatePosition(props);\n}\n"),F="#define SHADER_NAME solid-polygon-layer-vertex-shader-side\n#define IS_SIDE_VERTEX\n\n\nattribute vec3 instancePositions;\nattribute vec3 nextPositions;\nattribute vec3 instancePositions64Low;\nattribute vec3 nextPositions64Low;\nattribute float instanceElevations;\nattribute vec4 instanceFillColors;\nattribute vec4 instanceLineColors;\nattribute vec3 instancePickingColors;\n\n".concat(L,"\n\nvoid main(void) {\n  PolygonProps props;\n\n  #if RING_WINDING_ORDER_CW == 1\n    props.positions = instancePositions;\n    props.positions64Low = instancePositions64Low;\n    props.nextPositions = nextPositions;\n    props.nextPositions64Low = nextPositions64Low;\n  #else\n    props.positions = nextPositions;\n    props.positions64Low = nextPositions64Low;\n    props.nextPositions = instancePositions;\n    props.nextPositions64Low = instancePositions64Low;\n  #endif\n  props.elevations = instanceElevations;\n  props.fillColors = instanceFillColors;\n  props.lineColors = instanceLineColors;\n  props.pickingColors = instancePickingColors;\n\n  calculatePosition(props);\n}\n");function z(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function U(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?z(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):z(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function N(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}n.d(e,"a",(function(){return W}));var G=[0,0,0,255],V={filled:!0,extruded:!1,wireframe:!1,_normalize:!0,_windingOrder:"CW",_full3d:!1,elevationScale:{type:"number",min:0,value:1},getPolygon:{type:"accessor",value:function(t){return t.polygon}},getElevation:{type:"accessor",value:1e3},getFillColor:{type:"accessor",value:G},getLineColor:{type:"accessor",value:G},material:!0},H={enter:function(t,e){return e.length?e.subarray(e.length-t.length):t}},W=function(t){l()(n,t);var e=N(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(t){return u()(d()(n.prototype),"getShaders",this).call(this,{vs:"top"===t?j:F,fs:"#define SHADER_NAME solid-polygon-layer-fragment-shader\n\nprecision highp float;\n\nvarying vec4 vColor;\n\nvoid main(void) {\n  gl_FragColor = vColor;\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n",defines:{RING_WINDING_ORDER_CW:this.props._normalize||"CCW"!==this.props._windingOrder?1:0},modules:[m.a,y.a,v.a]})}},{key:"wrapLongitude",get:function(){return!1}},{key:"initializeState",value:function(){var t,e=this,n=this.context,r=n.gl,i=n.viewport,o=this.props.coordinateSystem,a=this.props._full3d;i.isGeospatial&&o===_.a.DEFAULT&&(o=_.a.LNGLAT),o===_.a.LNGLAT&&(t=a?i.projectPosition.bind(i):i.projectFlat.bind(i)),this.setState({numInstances:0,polygonTesselator:new k({preproject:t,fp64:this.use64bitPositions(),IndexType:!r||Object(x.c)(r,w.a.ELEMENT_INDEX_UINT32)?Uint32Array:Uint16Array})});var s=this.getAttributeManager();s.remove(["instancePickingColors"]),s.add({indices:{size:1,isIndexed:!0,update:this.calculateIndices,noAlloc:!0},positions:{size:3,type:5130,fp64:this.use64bitPositions(),transition:H,accessor:"getPolygon",update:this.calculatePositions,noAlloc:!0,shaderAttributes:{positions:{vertexOffset:0,divisor:0},instancePositions:{vertexOffset:0,divisor:1},nextPositions:{vertexOffset:1,divisor:1}}},vertexValid:{size:1,divisor:1,type:5121,update:this.calculateVertexValid,noAlloc:!0},elevations:{size:1,transition:H,accessor:"getElevation",shaderAttributes:{elevations:{divisor:0},instanceElevations:{divisor:1}}},fillColors:{size:this.props.colorFormat.length,type:5121,normalized:!0,transition:H,accessor:"getFillColor",defaultValue:G,shaderAttributes:{fillColors:{divisor:0},instanceFillColors:{divisor:1}}},lineColors:{size:this.props.colorFormat.length,type:5121,normalized:!0,transition:H,accessor:"getLineColor",defaultValue:G,shaderAttributes:{lineColors:{divisor:0},instanceLineColors:{divisor:1}}},pickingColors:{size:3,type:5121,accessor:function(t,n){var r=n.index,i=n.target;return e.encodePickingColor(t&&t.__source?t.__source.index:r,i)},shaderAttributes:{pickingColors:{divisor:0},instancePickingColors:{divisor:1}}}})}},{key:"getPickingInfo",value:function(t){var e=u()(d()(n.prototype),"getPickingInfo",this).call(this,t),r=e.index,i=this.props.data;return i[0]&&i[0].__source&&(e.object=i.find((function(t){return t.__source.index===r}))),e}},{key:"disablePickingIndex",value:function(t){var e=this.props.data;if(e[0]&&e[0].__source)for(var n=0;n<e.length;n++)e[n].__source.index===t&&this._disablePickingIndex(n);else this._disablePickingIndex(t)}},{key:"draw",value:function(t){var e=t.uniforms,n=this.props,r=n.extruded,i=n.filled,o=n.wireframe,a=n.elevationScale,s=this.state,u=s.topModel,c=s.sideModel,l=s.polygonTesselator,h=U(U({},e),{},{extruded:Boolean(r),elevationScale:a});c&&(c.setInstanceCount(l.instanceCount-1),c.setUniforms(h),o&&(c.setDrawMode(3),c.setUniforms({isWireframe:!0}).draw()),i&&(c.setDrawMode(6),c.setUniforms({isWireframe:!1}).draw())),u&&(u.setVertexCount(l.vertexCount),u.setUniforms(h).draw())}},{key:"updateState",value:function(t){u()(d()(n.prototype),"updateState",this).call(this,t),this.updateGeometry(t);var e,r=t.props,i=t.oldProps,o=t.changeFlags,a=this.getAttributeManager();(o.extensionsChanged||r.filled!==i.filled||r.extruded!==i.extruded)&&(null===(e=this.state.models)||void 0===e||e.forEach((function(t){return t.delete()})),this.setState(this._getModels(this.context.gl)),a.invalidateAll())}},{key:"updateGeometry",value:function(t){var e=t.props,n=(t.oldProps,t.changeFlags);if(n.dataChanged||n.updateTriggersChanged&&(n.updateTriggersChanged.all||n.updateTriggersChanged.getPolygon)){var r=this.state.polygonTesselator,i=e.data.attributes||{};r.updateGeometry({data:e.data,normalize:e._normalize,geometryBuffer:i.getPolygon,buffers:i,getGeometry:e.getPolygon,positionFormat:e.positionFormat,wrapLongitude:e.wrapLongitude,resolution:this.context.viewport.resolution,fp64:this.use64bitPositions(),dataChanged:n.dataChanged,full3d:e._full3d}),this.setState({numInstances:r.instanceCount,startIndices:r.vertexStarts}),n.dataChanged||this.getAttributeManager().invalidateAll()}}},{key:"_getModels",value:function(t){var e,n,r=this.props,i=r.id,o=r.filled,a=r.extruded;if(o){var s=this.getShaders("top");s.defines.NON_INSTANCED_MODEL=1,e=new E.a(t,U(U({},s),{},{id:"".concat(i,"-top"),drawMode:4,attributes:{vertexPositions:new Float32Array([0,1])},uniforms:{isWireframe:!1,isSideVertex:!1},vertexCount:0,isIndexed:!0}))}return a&&((n=new E.a(t,U(U({},this.getShaders("side")),{},{id:"".concat(i,"-side"),geometry:new O.a({drawMode:1,vertexCount:4,attributes:{vertexPositions:{size:2,value:new Float32Array([1,0,0,0,0,1,1,1])}}}),instanceCount:0,isInstanced:1}))).userData.excludeAttributes={indices:!0}),{models:[n,e].filter(Boolean),topModel:e,sideModel:n}}},{key:"calculateIndices",value:function(t){var e=this.state.polygonTesselator;t.startIndices=e.indexStarts,t.value=e.get("indices")}},{key:"calculatePositions",value:function(t){var e=this.state.polygonTesselator;t.startIndices=e.vertexStarts,t.value=e.get("positions")}},{key:"calculateVertexValid",value:function(t){t.value=this.state.polygonTesselator.get("vertexValid")}}]),n}(b.a);g()(W,"defaultProps",V),g()(W,"layerName","SolidPolygonLayer")},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(8),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(217),y=n(234),v=n(12),_=n(164),b=n(186),x=n(60),w=n(219),E=n(37);function O(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return S(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return S(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function S(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function T(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function C(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?T(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):T(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function P(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}var M=function(t){l()(n,t);var e=P(n);function n(t){return i()(this,n),e.call(this,C(C({},t),{},{attributes:{positions:{size:3,padding:18,initialize:!0,type:t.fp64?Float64Array:Float32Array},segmentTypes:{size:1,type:Uint8ClampedArray}}}))}return a()(n,[{key:"get",value:function(t){return this.attributes[t]}},{key:"getGeometryFromBuffer",value:function(t){return this.normalize?u()(d()(n.prototype),"getGeometryFromBuffer",this).call(this,t):null}},{key:"normalizeGeometry",value:function(t){return this.normalize?function(t,e,n,r){var i;if(Array.isArray(t[0])){var o=t.length*e;i=new Array(o);for(var a=0;a<t.length;a++)for(var s=0;s<e;s++)i[a*e+s]=t[a][s]||0}else i=t;return n?Object(E.d)(i,{size:e,gridResolution:n}):r?Object(E.e)(i,{size:e}):i}(t,this.positionSize,this.opts.resolution,this.opts.wrapLongitude):t}},{key:"getGeometrySize",value:function(t){if(I(t)){var e,n=0,r=O(t);try{for(r.s();!(e=r.n()).done;){var i=e.value;n+=this.getGeometrySize(i)}}catch(t){r.e(t)}finally{r.f()}return n}var o=this.getPathLength(t);return o<2?0:this.isClosed(t)?o<3?0:o+2:o}},{key:"updateGeometryAttributes",value:function(t,e){if(0!==e.geometrySize)if(t&&I(t)){var n,r=O(t);try{for(r.s();!(n=r.n()).done;){var i=n.value,o=this.getGeometrySize(i);e.geometrySize=o,this.updateGeometryAttributes(i,e),e.vertexStart+=o}}catch(t){r.e(t)}finally{r.f()}}else this._updateSegmentTypes(t,e),this._updatePositions(t,e)}},{key:"_updateSegmentTypes",value:function(t,e){var n=this.attributes.segmentTypes,r=!!t&&this.isClosed(t),i=e.vertexStart,o=e.geometrySize;n.fill(0,i,i+o),r?(n[i]=4,n[i+o-2]=4):(n[i]+=1,n[i+o-2]+=2),n[i+o-1]=4}},{key:"_updatePositions",value:function(t,e){var n=this.attributes.positions;if(n&&t)for(var r=e.vertexStart,i=e.geometrySize,o=new Array(3),a=r,s=0;s<i;a++,s++)this.getPointOnPath(t,s,o),n[3*a]=o[0],n[3*a+1]=o[1],n[3*a+2]=o[2]}},{key:"getPathLength",value:function(t){return t.length/this.positionSize}},{key:"getPointOnPath",value:function(t,e){var n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:[],r=this.positionSize;e*r>=t.length&&(e+=1-t.length/r);var i=e*r;return n[0]=t[i],n[1]=t[i+1],n[2]=3===r&&t[i+2]||0,n}},{key:"isClosed",value:function(t){if(!this.normalize)return Boolean(this.opts.loop);var e=this.positionSize,n=t.length-e;return t[0]===t[n]&&t[1]===t[n+1]&&(2===e||t[2]===t[n+2])}}]),n}(w.a);function I(t){return Array.isArray(t[0])}function B(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function R(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?B(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):B(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function k(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}n.d(e,"a",(function(){return F}));var D=[0,0,0,255],L={widthUnits:"meters",widthScale:{type:"number",min:0,value:1},widthMinPixels:{type:"number",min:0,value:0},widthMaxPixels:{type:"number",min:0,value:Number.MAX_SAFE_INTEGER},jointRounded:!1,capRounded:!1,miterLimit:{type:"number",min:0,value:4},billboard:!1,_pathType:null,getPath:{type:"accessor",value:function(t){return t.path}},getColor:{type:"accessor",value:D},getWidth:{type:"accessor",value:1},rounded:{deprecatedFor:["jointRounded","capRounded"]}},j={enter:function(t,e){return e.length?e.subarray(e.length-t.length):t}},F=function(t){l()(n,t);var e=k(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(){return u()(d()(n.prototype),"getShaders",this).call(this,{vs:"#define SHADER_NAME path-layer-vertex-shader\n\nattribute vec2 positions;\n\nattribute float instanceTypes;\nattribute vec3 instanceStartPositions;\nattribute vec3 instanceEndPositions;\nattribute vec3 instanceLeftPositions;\nattribute vec3 instanceRightPositions;\nattribute vec3 instanceLeftPositions64Low;\nattribute vec3 instanceStartPositions64Low;\nattribute vec3 instanceEndPositions64Low;\nattribute vec3 instanceRightPositions64Low;\nattribute float instanceStrokeWidths;\nattribute vec4 instanceColors;\nattribute vec3 instancePickingColors;\n\nuniform float widthScale;\nuniform float widthMinPixels;\nuniform float widthMaxPixels;\nuniform float jointType;\nuniform float capType;\nuniform float miterLimit;\nuniform bool billboard;\nuniform int widthUnits;\n\nuniform float opacity;\n\nvarying vec4 vColor;\nvarying vec2 vCornerOffset;\nvarying float vMiterLength;\nvarying vec2 vPathPosition;\nvarying float vPathLength;\nvarying float vJointType;\n\nconst float EPSILON = 0.001;\nconst vec3 ZERO_OFFSET = vec3(0.0);\n\nfloat flipIfTrue(bool flag) {\n  return -(float(flag) * 2. - 1.);\n}\n\n// calculate line join positions\nvec3 lineJoin(\n  vec3 prevPoint, vec3 currPoint, vec3 nextPoint,\n  vec2 width\n) {\n  bool isEnd = positions.x > 0.0;\n  // side of the segment - -1: left, 0: center, 1: right\n  float sideOfPath = positions.y;\n  float isJoint = float(sideOfPath == 0.0);\n\n  vec3 deltaA3 = (currPoint - prevPoint);\n  vec3 deltaB3 = (nextPoint - currPoint);\n\n  mat3 rotationMatrix;\n  bool needsRotation = !billboard && project_needs_rotation(currPoint, rotationMatrix);\n  if (needsRotation) {\n    deltaA3 = deltaA3 * rotationMatrix;\n    deltaB3 = deltaB3 * rotationMatrix;\n  }\n  vec2 deltaA = deltaA3.xy / width;\n  vec2 deltaB = deltaB3.xy / width;\n\n  float lenA = length(deltaA);\n  float lenB = length(deltaB);\n\n  vec2 dirA = lenA > 0. ? normalize(deltaA) : vec2(0.0, 0.0);\n  vec2 dirB = lenB > 0. ? normalize(deltaB) : vec2(0.0, 0.0);\n\n  vec2 perpA = vec2(-dirA.y, dirA.x);\n  vec2 perpB = vec2(-dirB.y, dirB.x);\n\n  // tangent of the corner\n  vec2 tangent = dirA + dirB;\n  tangent = length(tangent) > 0. ? normalize(tangent) : perpA;\n  // direction of the corner\n  vec2 miterVec = vec2(-tangent.y, tangent.x);\n  // direction of the segment\n  vec2 dir = isEnd ? dirA : dirB;\n  // direction of the extrusion\n  vec2 perp = isEnd ? perpA : perpB;\n  // length of the segment\n  float L = isEnd ? lenA : lenB;\n\n  // A = angle of the corner\n  float sinHalfA = abs(dot(miterVec, perp));\n  float cosHalfA = abs(dot(dirA, miterVec));\n\n  // -1: right, 1: left\n  float turnDirection = flipIfTrue(dirA.x * dirB.y >= dirA.y * dirB.x);\n\n  // relative position to the corner:\n  // -1: inside (smaller side of the angle)\n  // 0: center\n  // 1: outside (bigger side of the angle)\n  float cornerPosition = sideOfPath * turnDirection;\n\n  float miterSize = 1.0 / max(sinHalfA, EPSILON);\n  // trim if inside corner extends further than the line segment\n  miterSize = mix(\n    min(miterSize, max(lenA, lenB) / max(cosHalfA, EPSILON)),\n    miterSize,\n    step(0.0, cornerPosition)\n  );\n\n  vec2 offsetVec = mix(miterVec * miterSize, perp, step(0.5, cornerPosition))\n    * (sideOfPath + isJoint * turnDirection);\n\n  // special treatment for start cap and end cap\n  bool isStartCap = lenA == 0.0 || (!isEnd && (instanceTypes == 1.0 || instanceTypes == 3.0));\n  bool isEndCap = lenB == 0.0 || (isEnd && (instanceTypes == 2.0 || instanceTypes == 3.0));\n  bool isCap = isStartCap || isEndCap;\n\n  // extend out a triangle to envelope the round cap\n  if (isCap) {\n    offsetVec = mix(perp * sideOfPath, dir * capType * 4.0 * flipIfTrue(isStartCap), isJoint);\n    vJointType = capType;\n  } else {\n    vJointType = jointType;\n  }\n\n  // Generate variables for fragment shader\n  vPathLength = L;\n  vCornerOffset = offsetVec;\n  vMiterLength = dot(vCornerOffset, miterVec * turnDirection);\n  vMiterLength = isCap ? isJoint : vMiterLength;\n\n  vec2 offsetFromStartOfPath = vCornerOffset + deltaA * float(isEnd);\n  vPathPosition = vec2(\n    dot(offsetFromStartOfPath, perp),\n    dot(offsetFromStartOfPath, dir)\n  );\n  geometry.uv = vPathPosition;\n\n  float isValid = step(instanceTypes, 3.5);\n  vec3 offset = vec3(offsetVec * width * isValid, 0.0);\n\n  if (needsRotation) {\n    offset = rotationMatrix * offset;\n  }\n  return currPoint + offset;\n}\n\n// In clipspace extrusion, if a line extends behind the camera, clip it to avoid visual artifacts\nvoid clipLine(inout vec4 position, vec4 refPosition) {\n  if (position.w < EPSILON) {\n    float r = (EPSILON - refPosition.w) / (position.w - refPosition.w);\n    position = refPosition + (position - refPosition) * r;\n  }\n}\n\nvoid main() {\n  geometry.pickingColor = instancePickingColors;\n\n  vColor = vec4(instanceColors.rgb, instanceColors.a * opacity);\n\n  float isEnd = positions.x;\n\n  vec3 prevPosition = mix(instanceLeftPositions, instanceStartPositions, isEnd);\n  vec3 prevPosition64Low = mix(instanceLeftPositions64Low, instanceStartPositions64Low, isEnd);\n\n  vec3 currPosition = mix(instanceStartPositions, instanceEndPositions, isEnd);\n  vec3 currPosition64Low = mix(instanceStartPositions64Low, instanceEndPositions64Low, isEnd);\n\n  vec3 nextPosition = mix(instanceEndPositions, instanceRightPositions, isEnd);\n  vec3 nextPosition64Low = mix(instanceEndPositions64Low, instanceRightPositions64Low, isEnd);\n\n  geometry.worldPosition = currPosition;\n  vec2 widthPixels = vec2(clamp(\n    project_size_to_pixel(instanceStrokeWidths * widthScale, widthUnits),\n    widthMinPixels, widthMaxPixels) / 2.0);\n  vec3 width;\n\n  if (billboard) {\n    // Extrude in clipspace\n    vec4 prevPositionScreen = project_position_to_clipspace(prevPosition, prevPosition64Low, ZERO_OFFSET);\n    vec4 currPositionScreen = project_position_to_clipspace(currPosition, currPosition64Low, ZERO_OFFSET, geometry.position);\n    vec4 nextPositionScreen = project_position_to_clipspace(nextPosition, nextPosition64Low, ZERO_OFFSET);\n\n    clipLine(prevPositionScreen, currPositionScreen);\n    clipLine(nextPositionScreen, currPositionScreen);\n    clipLine(currPositionScreen, mix(nextPositionScreen, prevPositionScreen, isEnd));\n\n    width = vec3(widthPixels, 0.0);\n    DECKGL_FILTER_SIZE(width, geometry);\n\n    vec3 pos = lineJoin(\n      prevPositionScreen.xyz / prevPositionScreen.w,\n      currPositionScreen.xyz / currPositionScreen.w,\n      nextPositionScreen.xyz / nextPositionScreen.w,\n      project_pixel_size_to_clipspace(width.xy)\n    );\n\n    gl_Position = vec4(pos * currPositionScreen.w, currPositionScreen.w);\n  } else {\n    // Extrude in commonspace\n    prevPosition = project_position(prevPosition, prevPosition64Low);\n    currPosition = project_position(currPosition, currPosition64Low);\n    nextPosition = project_position(nextPosition, nextPosition64Low);\n\n    width = vec3(project_pixel_size(widthPixels), 0.0);\n    DECKGL_FILTER_SIZE(width, geometry);\n\n    vec4 pos = vec4(\n      lineJoin(prevPosition, currPosition, nextPosition, width.xy),\n      1.0);\n    geometry.position = pos;\n    gl_Position = project_common_position_to_clipspace(pos);\n  }\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n",fs:"#define SHADER_NAME path-layer-fragment-shader\n\nprecision highp float;\n\nuniform float miterLimit;\n\nvarying vec4 vColor;\nvarying vec2 vCornerOffset;\nvarying float vMiterLength;\n/*\n * vPathPosition represents the relative coordinates of the current fragment on the path segment.\n * vPathPosition.x - position along the width of the path, between [-1, 1]. 0 is the center line.\n * vPathPosition.y - position along the length of the path, between [0, L / width].\n */\nvarying vec2 vPathPosition;\nvarying float vPathLength;\nvarying float vJointType;\n\nvoid main(void) {\n  geometry.uv = vPathPosition;\n\n  if (vPathPosition.y < 0.0 || vPathPosition.y > vPathLength) {\n    // if joint is rounded, test distance from the corner\n    if (vJointType > 0.5 && length(vCornerOffset) > 1.0) {\n      discard;\n    }\n    // trim miter\n    if (vJointType < 0.5 && vMiterLength > miterLimit + 1.0) {\n      discard;\n    }\n  }\n  gl_FragColor = vColor;\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n",modules:[m.a,y.a]})}},{key:"wrapLongitude",get:function(){return!1}},{key:"initializeState",value:function(){var t=this;this.getAttributeManager().addInstanced({positions:{size:3,vertexOffset:1,type:5130,fp64:this.use64bitPositions(),transition:j,accessor:"getPath",update:this.calculatePositions,noAlloc:!0,shaderAttributes:{instanceLeftPositions:{vertexOffset:0},instanceStartPositions:{vertexOffset:1},instanceEndPositions:{vertexOffset:2},instanceRightPositions:{vertexOffset:3}}},instanceTypes:{size:1,type:5121,update:this.calculateSegmentTypes,noAlloc:!0},instanceStrokeWidths:{size:1,accessor:"getWidth",transition:j,defaultValue:1},instanceColors:{size:this.props.colorFormat.length,type:5121,normalized:!0,accessor:"getColor",transition:j,defaultValue:D},instancePickingColors:{size:3,type:5121,accessor:function(e,n){var r=n.index,i=n.target;return t.encodePickingColor(e&&e.__source?e.__source.index:r,i)}}}),this.setState({pathTesselator:new M({fp64:this.use64bitPositions()})})}},{key:"updateState",value:function(t){u()(d()(n.prototype),"updateState",this).call(this,t);var e=t.props,r=t.changeFlags,i=this.getAttributeManager();if(r.dataChanged||r.updateTriggersChanged&&(r.updateTriggersChanged.all||r.updateTriggersChanged.getPath)){var o=this.state.pathTesselator,a=e.data.attributes||{};o.updateGeometry({data:e.data,geometryBuffer:a.getPath,buffers:a,normalize:!e._pathType,loop:"loop"===e._pathType,getGeometry:e.getPath,positionFormat:e.positionFormat,wrapLongitude:e.wrapLongitude,resolution:this.context.viewport.resolution,dataChanged:r.dataChanged}),this.setState({numInstances:o.instanceCount,startIndices:o.vertexStarts}),r.dataChanged||i.invalidateAll()}if(r.extensionsChanged){var s,c=this.context.gl;null===(s=this.state.model)||void 0===s||s.delete(),this.state.model=this._getModel(c),i.invalidateAll()}}},{key:"getPickingInfo",value:function(t){var e=u()(d()(n.prototype),"getPickingInfo",this).call(this,t),r=e.index,i=this.props.data;return i[0]&&i[0].__source&&(e.object=i.find((function(t){return t.__source.index===r}))),e}},{key:"disablePickingIndex",value:function(t){var e=this.props.data;if(e[0]&&e[0].__source)for(var n=0;n<e.length;n++)e[n].__source.index===t&&this._disablePickingIndex(n);else this._disablePickingIndex(t)}},{key:"draw",value:function(t){var e=t.uniforms,n=this.props,r=n.jointRounded,i=n.capRounded,o=n.billboard,a=n.miterLimit,s=n.widthUnits,u=n.widthScale,c=n.widthMinPixels,l=n.widthMaxPixels;this.state.model.setUniforms(e).setUniforms({jointType:Number(r),capType:Number(i),billboard:o,widthUnits:v.e[s],widthScale:u,miterLimit:a,widthMinPixels:c,widthMaxPixels:l}).draw()}},{key:"_getModel",value:function(t){return new b.a(t,R(R({},this.getShaders()),{},{id:this.props.id,geometry:new x.a({drawMode:4,attributes:{indices:new Uint16Array([0,1,2,1,4,2,1,3,4,3,5,4]),positions:{value:new Float32Array([0,0,0,-1,0,1,1,-1,1,1,1,0]),size:2}}}),isInstanced:!0}))}},{key:"calculatePositions",value:function(t){var e=this.state.pathTesselator;t.startIndices=e.vertexStarts,t.value=e.get("positions")}},{key:"calculateSegmentTypes",value:function(t){var e=this.state.pathTesselator;t.startIndices=e.vertexStarts,t.value=e.get("segmentTypes")}}]),n}(_.a);g()(F,"defaultProps",L),g()(F,"layerName","PathLayer")},function(t,e,n){"use strict";var r,i=n(3),o=n.n(i),a=n(4),s=n.n(a),u=n(8),c=n.n(u),l=n(5),h=n.n(l),f=n(6),p=n.n(f),d=n(1),A=n.n(d),g=n(0),m=n.n(g),y=n(217),v=n(234),_=n(12),b=n(21),x=n(164),w=n(186),E=n(60),O=n(107),S=n(206),T=n(215),C=n(52);function P(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return M(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return M(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function M(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function I(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function B(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?I(Object(n),!0).forEach((function(e){m()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):I(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var R=function(){},k=(r={},m()(r,10241,9987),m()(r,10240,9729),m()(r,10242,33071),m()(r,10243,33071),r);function D(t){return t&&(t.id||t.url)}function L(t,e,n){for(var r=0;r<e.length;r++){var i=e[r],o=i.icon,a=i.xOffset;t[D(o)]=B(B({},o),{},{x:a,y:n})}}var j=function(){function t(e,n){var r=n.onUpdate,i=void 0===r?R:r,a=n.onError,s=void 0===a?R:a;o()(this,t),m()(this,"_loadOptions",null),m()(this,"_texture",null),m()(this,"_externalTexture",null),m()(this,"_mapping",{}),m()(this,"_textureParameters",null),m()(this,"_pendingCount",0),m()(this,"_autoPacking",!1),m()(this,"_xOffset",0),m()(this,"_yOffset",0),m()(this,"_rowHeight",0),m()(this,"_buffer",4),m()(this,"_canvasWidth",1024),m()(this,"_canvasHeight",0),m()(this,"_canvas",null),this.gl=e,this.onUpdate=i,this.onError=s}return s()(t,[{key:"finalize",value:function(){var t;null===(t=this._texture)||void 0===t||t.delete()}},{key:"getTexture",value:function(){return this._texture||this._externalTexture}},{key:"getIconMapping",value:function(t){var e=this._autoPacking?D(t):t;return this._mapping[e]||{}}},{key:"setProps",value:function(t){var e,n=t.loadOptions,r=t.autoPacking,i=t.iconAtlas,o=t.iconMapping,a=t.textureParameters;(n&&(this._loadOptions=n),void 0!==r&&(this._autoPacking=r),o&&(this._mapping=o),i)&&(null===(e=this._texture)||void 0===e||e.delete(),this._texture=null,this._externalTexture=i);a&&(this._textureParameters=a)}},{key:"isLoaded",get:function(){return 0===this._pendingCount}},{key:"packIcons",value:function(t,e){if(this._autoPacking&&"undefined"!=typeof document){var n,r,i,o,a,s,u,c=Object.values(function(t,e,n){if(!t||!e)return null;n=n||{};var r,i={},o=Object(C.a)(t),a=o.iterable,s=o.objectInfo,u=P(a);try{for(u.s();!(r=u.n()).done;){var c=r.value;s.index++;var l=e(c,s),h=D(l);if(!l)throw new Error("Icon is missing.");if(!l.url)throw new Error("Icon url is missing.");i[h]||n[h]&&l.url===n[h].url||(i[h]=B(B({},l),{},{source:c,sourceIndex:s.index}))}}catch(t){u.e(t)}finally{u.f()}return i}(t,e,this._mapping)||{});if(c.length>0){var l=function(t){for(var e,n=t.icons,r=t.buffer,i=t.mapping,o=void 0===i?{}:i,a=t.xOffset,s=void 0===a?0:a,u=t.yOffset,c=void 0===u?0:u,l=t.rowHeight,h=void 0===l?0:l,f=t.canvasWidth,p=[],d=0;d<n.length;d++){var A=n[d];if(!o[D(A)]){var g=A.height,m=A.width;s+m+r>f&&(L(o,p,c),s=0,c=h+c+r,h=0,p=[]),p.push({icon:A,xOffset:s}),s=s+m+r,h=Math.max(h,g)}}return p.length>0&&L(o,p,c),{mapping:o,rowHeight:h,xOffset:s,yOffset:c,canvasWidth:f,canvasHeight:(e=h+c+r,Math.pow(2,Math.ceil(Math.log2(e))))}}({icons:c,buffer:this._buffer,canvasWidth:this._canvasWidth,mapping:this._mapping,rowHeight:this._rowHeight,xOffset:this._xOffset,yOffset:this._yOffset}),h=l.mapping,f=l.xOffset,p=l.yOffset,d=l.rowHeight,A=l.canvasHeight;this._rowHeight=d,this._mapping=h,this._xOffset=f,this._yOffset=p,this._canvasHeight=A,this._texture||(this._texture=new O.a(this.gl,{width:this._canvasWidth,height:this._canvasHeight,parameters:this._textureParameters||k})),this._texture.height!==this._canvasHeight&&(this._texture=(n=this._texture,r=this._canvasWidth,i=this._canvasHeight,o=this._textureParameters||k,a=n.width,s=n.height,u=new O.a(n.gl,{width:r,height:i,parameters:o}),Object(S.b)(n,u,{targetY:0,width:a,height:s}),n.delete(),u)),this.onUpdate(),this._canvas=this._canvas||document.createElement("canvas"),this._loadIcons(c)}}}},{key:"_loadIcons",value:function(t){var e,n=this,r=this._canvas.getContext("2d"),i=P(t);try{var o=function(){var t=e.value;n._pendingCount++,Object(T.a)(t.url,n._loadOptions).then((function(e){var i=D(t),o=n._mapping[i],a=o.x,s=o.y,u=o.width,c=o.height,l=function(t,e,n,r){return n===e.width&&r===e.height?e:(t.canvas.height=r,t.canvas.width=n,t.clearRect(0,0,t.canvas.width,t.canvas.height),t.drawImage(e,0,0,e.width,e.height,0,0,n,r),t.canvas)}(r,e,u,c);n._texture.setSubImageData({data:l,x:a,y:s,width:u,height:c}),n._texture.generateMipmap(),n.onUpdate()})).catch((function(e){n.onError({url:t.url,source:t.source,sourceIndex:t.sourceIndex,loadOptions:n._loadOptions,error:e})})).finally((function(){n._pendingCount--}))};for(i.s();!(e=i.n()).done;)o()}catch(t){i.e(t)}finally{i.f()}}}]),t}();function F(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function z(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?F(Object(n),!0).forEach((function(e){m()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):F(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function U(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=A()(t);if(e){var i=A()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return p()(this,n)}}n.d(e,"a",(function(){return V}));var N=[0,0,0,255],G={iconAtlas:{type:"image",value:null,async:!0},iconMapping:{type:"object",value:{},async:!0},sizeScale:{type:"number",value:1,min:0},billboard:!0,sizeUnits:"pixels",sizeMinPixels:{type:"number",min:0,value:0},sizeMaxPixels:{type:"number",min:0,value:Number.MAX_SAFE_INTEGER},alphaCutoff:{type:"number",value:.05,min:0,max:1},getPosition:{type:"accessor",value:function(t){return t.position}},getIcon:{type:"accessor",value:function(t){return t.icon}},getColor:{type:"accessor",value:N},getSize:{type:"accessor",value:1},getAngle:{type:"accessor",value:0},getPixelOffset:{type:"accessor",value:[0,0]},onIconError:{type:"function",value:null,compare:!1,optional:!0}},V=function(t){h()(n,t);var e=U(n);function n(){return o()(this,n),e.apply(this,arguments)}return s()(n,[{key:"getShaders",value:function(){return c()(A()(n.prototype),"getShaders",this).call(this,{vs:'#define SHADER_NAME icon-layer-vertex-shader\n\nattribute vec2 positions;\n\nattribute vec3 instancePositions;\nattribute vec3 instancePositions64Low;\nattribute float instanceSizes;\nattribute float instanceAngles;\nattribute vec4 instanceColors;\nattribute vec3 instancePickingColors;\nattribute vec4 instanceIconFrames;\nattribute float instanceColorModes;\nattribute vec2 instanceOffsets;\nattribute vec2 instancePixelOffset;\n\nuniform float sizeScale;\nuniform vec2 iconsTextureDim;\nuniform float sizeMinPixels;\nuniform float sizeMaxPixels;\nuniform bool billboard;\nuniform int sizeUnits;\n\nvarying float vColorMode;\nvarying vec4 vColor;\nvarying vec2 vTextureCoords;\nvarying vec2 uv;\n\nvec2 rotate_by_angle(vec2 vertex, float angle) {\n  float angle_radian = angle * PI / 180.0;\n  float cos_angle = cos(angle_radian);\n  float sin_angle = sin(angle_radian);\n  mat2 rotationMatrix = mat2(cos_angle, -sin_angle, sin_angle, cos_angle);\n  return rotationMatrix * vertex;\n}\n\nvoid main(void) {\n  geometry.worldPosition = instancePositions;\n  geometry.uv = positions;\n  geometry.pickingColor = instancePickingColors;\n  uv = positions;\n\n  vec2 iconSize = instanceIconFrames.zw;\n  // convert size in meters to pixels, then scaled and clamp\n \n  // project meters to pixels and clamp to limits \n  float sizePixels = clamp(\n    project_size_to_pixel(instanceSizes * sizeScale, sizeUnits), \n    sizeMinPixels, sizeMaxPixels\n  );\n\n  // scale icon height to match instanceSize\n  float instanceScale = iconSize.y == 0.0 ? 0.0 : sizePixels / iconSize.y;\n\n  // scale and rotate vertex in "pixel" value and convert back to fraction in clipspace\n  vec2 pixelOffset = positions / 2.0 * iconSize + instanceOffsets;\n  pixelOffset = rotate_by_angle(pixelOffset, instanceAngles) * instanceScale;\n  pixelOffset += instancePixelOffset;\n  pixelOffset.y *= -1.0;\n\n  if (billboard)  {\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, vec3(0.0), geometry.position);\n    vec3 offset = vec3(pixelOffset, 0.0);\n    DECKGL_FILTER_SIZE(offset, geometry);\n    gl_Position.xy += project_pixel_size_to_clipspace(offset.xy);\n\n  } else {\n    vec3 offset_common = vec3(project_pixel_size(pixelOffset), 0.0);\n    DECKGL_FILTER_SIZE(offset_common, geometry);\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, offset_common, geometry.position); \n  }\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  vTextureCoords = mix(\n    instanceIconFrames.xy,\n    instanceIconFrames.xy + iconSize,\n    (positions.xy + 1.0) / 2.0\n  ) / iconsTextureDim;\n\n  vColor = instanceColors;\n  DECKGL_FILTER_COLOR(vColor, geometry);\n\n  vColorMode = instanceColorModes;\n}\n',fs:"#define SHADER_NAME icon-layer-fragment-shader\n\nprecision highp float;\n\nuniform float opacity;\nuniform sampler2D iconsTexture;\nuniform float alphaCutoff;\n\nvarying float vColorMode;\nvarying vec4 vColor;\nvarying vec2 vTextureCoords;\nvarying vec2 uv;\n\nvoid main(void) {\n  geometry.uv = uv;\n\n  vec4 texColor = texture2D(iconsTexture, vTextureCoords);\n\n  // if colorMode == 0, use pixel color from the texture\n  // if colorMode == 1 or rendering picking buffer, use texture as transparency mask\n  vec3 color = mix(texColor.rgb, vColor.rgb, vColorMode);\n  // Take the global opacity and the alpha from vColor into account for the alpha component\n  float a = texColor.a * opacity * vColor.a;\n\n  if (a < alphaCutoff) {\n    discard;\n  }\n\n  gl_FragColor = vec4(color, a);\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n",modules:[y.a,v.a]})}},{key:"initializeState",value:function(){this.state={iconManager:new j(this.context.gl,{onUpdate:this._onUpdate.bind(this),onError:this._onError.bind(this)})},this.getAttributeManager().addInstanced({instancePositions:{size:3,type:5130,fp64:this.use64bitPositions(),transition:!0,accessor:"getPosition"},instanceSizes:{size:1,transition:!0,accessor:"getSize",defaultValue:1},instanceOffsets:{size:2,accessor:"getIcon",transform:this.getInstanceOffset},instanceIconFrames:{size:4,accessor:"getIcon",transform:this.getInstanceIconFrame},instanceColorModes:{size:1,type:5121,accessor:"getIcon",transform:this.getInstanceColorMode},instanceColors:{size:this.props.colorFormat.length,type:5121,normalized:!0,transition:!0,accessor:"getColor",defaultValue:N},instanceAngles:{size:1,transition:!0,accessor:"getAngle"},instancePixelOffset:{size:2,transition:!0,accessor:"getPixelOffset"}})}},{key:"updateState",value:function(t){c()(A()(n.prototype),"updateState",this).call(this,t);var e=t.props,r=t.oldProps,i=t.changeFlags,o=this.getAttributeManager(),a=e.iconAtlas,s=e.iconMapping,u=e.data,l=e.getIcon,h=e.textureParameters,f=this.state.iconManager,p=a||this.internalState.isAsyncPropLoading("iconAtlas");if(f.setProps({loadOptions:e.loadOptions,autoPacking:!p,iconAtlas:a,iconMapping:p?s:null,textureParameters:h}),p?r.iconMapping!==e.iconMapping&&o.invalidate("getIcon"):(i.dataChanged||i.updateTriggersChanged&&(i.updateTriggersChanged.all||i.updateTriggersChanged.getIcon))&&f.packIcons(u,l),i.extensionsChanged){var d,g=this.context.gl;null===(d=this.state.model)||void 0===d||d.delete(),this.state.model=this._getModel(g),o.invalidateAll()}}},{key:"isLoaded",get:function(){return c()(A()(n.prototype),"isLoaded",this)&&this.state.iconManager.isLoaded}},{key:"finalizeState",value:function(t){c()(A()(n.prototype),"finalizeState",this).call(this,t),this.state.iconManager.finalize()}},{key:"draw",value:function(t){var e=t.uniforms,n=this.props,r=n.sizeScale,i=n.sizeMinPixels,o=n.sizeMaxPixels,a=n.sizeUnits,s=n.billboard,u=n.alphaCutoff,c=this.state.iconManager.getTexture();c&&this.state.model.setUniforms(e).setUniforms({iconsTexture:c,iconsTextureDim:[c.width,c.height],sizeUnits:_.e[a],sizeScale:r,sizeMinPixels:i,sizeMaxPixels:o,billboard:s,alphaCutoff:u}).draw()}},{key:"_getModel",value:function(t){return new w.a(t,z(z({},this.getShaders()),{},{id:this.props.id,geometry:new E.a({drawMode:6,attributes:{positions:{size:2,value:new Float32Array([-1,-1,-1,1,1,1,1,-1])}}}),isInstanced:!0}))}},{key:"_onUpdate",value:function(){this.setNeedsRedraw()}},{key:"_onError",value:function(t){var e,n=null===(e=this.getCurrentLayer())||void 0===e?void 0:e.props.onIconError;n?n(t):b.a.error(t.error.message)()}},{key:"getInstanceOffset",value:function(t){var e=this.state.iconManager.getIconMapping(t),n=e.width,r=e.height,i=e.anchorX,o=void 0===i?n/2:i,a=e.anchorY;return[n/2-o,r/2-(void 0===a?r/2:a)]}},{key:"getInstanceColorMode",value:function(t){return this.state.iconManager.getIconMapping(t).mask?1:0}},{key:"getInstanceIconFrame",value:function(t){var e=this.state.iconManager.getIconMapping(t);return[e.x,e.y,e.width,e.height]}}]),n}(x.a);m()(V,"defaultProps",G),m()(V,"layerName","IconLayer")},function(t,e,n){var r=n(262);t.exports=function(t,e){if("function"!=typeof e&&null!==e)throw new TypeError("Super expression must either be null or a function");t.prototype=Object.create(e&&e.prototype,{constructor:{value:t,writable:!0,configurable:!0}}),Object.defineProperty(t,"prototype",{writable:!1}),e&&r(t,e)},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){var r=n(194).default,i=n(263);t.exports=function(t,e){if(e&&("object"===r(e)||"function"==typeof e))return e;if(void 0!==e)throw new TypeError("Derived constructors may only return object or undefined");return i(t)},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){"use strict";n.d(e,"a",(function(){return a}));var r=n(122),i=n(23),o=n(144);class a extends r.a{get x(){return this[0]}set x(t){this[0]=Object(i.a)(t)}get y(){return this[1]}set y(t){this[1]=Object(i.a)(t)}len(){return Math.sqrt(this.lengthSquared())}magnitude(){return this.len()}lengthSquared(){let t=0;for(let e=0;e<this.ELEMENTS;++e)t+=this[e]*this[e];return t}magnitudeSquared(){return this.lengthSquared()}distance(t){return Math.sqrt(this.distanceSquared(t))}distanceSquared(t){let e=0;for(let n=0;n<this.ELEMENTS;++n){const r=this[n]-t[n];e+=r*r}return Object(i.a)(e)}dot(t){let e=0;for(let n=0;n<this.ELEMENTS;++n)e+=this[n]*t[n];return Object(i.a)(e)}normalize(){const t=this.magnitude();if(0!==t)for(let e=0;e<this.ELEMENTS;++e)this[e]/=t;return this.check()}multiply(...t){for(const e of t)for(let t=0;t<this.ELEMENTS;++t)this[t]*=e[t];return this.check()}divide(...t){for(const e of t)for(let t=0;t<this.ELEMENTS;++t)this[t]/=e[t];return this.check()}lengthSq(){return this.lengthSquared()}distanceTo(t){return this.distance(t)}distanceToSquared(t){return this.distanceSquared(t)}getComponent(t){return Object(o.a)(t>=0&&t<this.ELEMENTS,"index is out of range"),Object(i.a)(this[t])}setComponent(t,e){return Object(o.a)(t>=0&&t<this.ELEMENTS,"index is out of range"),this[t]=e,this.check()}addVectors(t,e){return this.copy(t).add(e)}subVectors(t,e){return this.copy(t).subtract(e)}multiplyVectors(t,e){return this.copy(t).multiply(e)}addScaledVector(t,e){return this.add(new this.constructor(t).multiplyScalar(e))}}},function(t,e,n){"use strict";n.d(e,"a",(function(){return i}));var r=n(13);class i extends(function(t){function e(){var e=Reflect.construct(t,Array.from(arguments));return Object.setPrototypeOf(e,Object.getPrototypeOf(this)),e}return e.prototype=Object.create(t.prototype,{constructor:{value:t,enumerable:!1,writable:!0,configurable:!0}}),Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t,e}(Array)){clone(){return(new this.constructor).copy(this)}fromArray(t,e=0){for(let n=0;n<this.ELEMENTS;++n)this[n]=t[n+e];return this.check()}toArray(t=[],e=0){for(let n=0;n<this.ELEMENTS;++n)t[e+n]=this[n];return t}from(t){return Array.isArray(t)?this.copy(t):this.fromObject(t)}to(t){return t===this?this:Object(r.f)(t)?this.toArray(t):this.toObject(t)}toTarget(t){return t?this.to(t):this}toFloat32Array(){return new Float32Array(this)}toString(){return this.formatString(r.b)}formatString(t){let e="";for(let n=0;n<this.ELEMENTS;++n)e+=(n>0?", ":"")+Object(r.e)(this[n],t);return"".concat(t.printTypes?this.constructor.name:"","[").concat(e,"]")}equals(t){if(!t||this.length!==t.length)return!1;for(let e=0;e<this.ELEMENTS;++e)if(!Object(r.d)(this[e],t[e]))return!1;return!0}exactEquals(t){if(!t||this.length!==t.length)return!1;for(let e=0;e<this.ELEMENTS;++e)if(this[e]!==t[e])return!1;return!0}negate(){for(let t=0;t<this.ELEMENTS;++t)this[t]=-this[t];return this.check()}lerp(t,e,n){if(void 0===n)return this.lerp(this,t,e);for(let r=0;r<this.ELEMENTS;++r){const i=t[r];this[r]=i+n*(e[r]-i)}return this.check()}min(t){for(let e=0;e<this.ELEMENTS;++e)this[e]=Math.min(t[e],this[e]);return this.check()}max(t){for(let e=0;e<this.ELEMENTS;++e)this[e]=Math.max(t[e],this[e]);return this.check()}clamp(t,e){for(let n=0;n<this.ELEMENTS;++n)this[n]=Math.min(Math.max(this[n],t[n]),e[n]);return this.check()}add(...t){for(const e of t)for(let t=0;t<this.ELEMENTS;++t)this[t]+=e[t];return this.check()}subtract(...t){for(const e of t)for(let t=0;t<this.ELEMENTS;++t)this[t]-=e[t];return this.check()}scale(t){if("number"==typeof t)for(let e=0;e<this.ELEMENTS;++e)this[e]*=t;else for(let e=0;e<this.ELEMENTS&&e<t.length;++e)this[e]*=t[e];return this.check()}multiplyByScalar(t){for(let e=0;e<this.ELEMENTS;++e)this[e]*=t;return this.check()}check(){if(r.b.debug&&!this.validate())throw new Error("math.gl: ".concat(this.constructor.name," some fields set to invalid numbers'"));return this}validate(){let t=this.length===this.ELEMENTS;for(let e=0;e<this.ELEMENTS;++e)t=t&&Number.isFinite(this[e]);return t}sub(t){return this.subtract(t)}setScalar(t){for(let e=0;e<this.ELEMENTS;++e)this[e]=t;return this.check()}addScalar(t){for(let e=0;e<this.ELEMENTS;++e)this[e]+=t;return this.check()}subScalar(t){return this.addScalar(-t)}multiplyScalar(t){for(let e=0;e<this.ELEMENTS;++e)this[e]*=t;return this.check()}divideScalar(t){return this.multiplyByScalar(1/t)}clampScalar(t,e){for(let n=0;n<this.ELEMENTS;++n)this[n]=Math.min(Math.max(this[n],t),e);return this.check()}get elements(){return this}}},function(t,e,n){"use strict";var r=n(40),i=n.n(r),o=n(9),a=n.n(o),s=n(12),u=n(104),c=n(78),l=n(84),h=n(80),f=n(19);function p(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return d(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return d(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function d(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var A=Object(h.a)((function(t){var e=t.viewport,n=t.center;return new c.a(e.viewProjectionMatrix).invert().transform(n)})),g=Object(h.a)((function(t){var e,n=t.viewport,r=t.shadowMatrices,o=[],s=n.pixelUnprojectionMatrix,u=n.isGeospatial?void 0:1,h=[[0,0,u],[n.width,0,u],[0,n.height,u],[n.width,n.height,u],[0,0,-1],[n.width,0,-1],[0,n.height,-1],[n.width,n.height,-1]].map((function(t){return function(t,e){var n=a()(t,3),r=n[0],i=n[1],o=n[2],s=Object(f.n)([r,i,o],e);if(Number.isFinite(o))return s;return[s[0],s[1],0]}(t,s)})),d=p(r);try{var A=function(){var t=e.value,r=t.clone().translate(new l.a(n.center).negate()),a=h.map((function(t){return r.transform(t)})),s=(new c.a).ortho({left:Math.min.apply(Math,i()(a.map((function(t){return t[0]})))),right:Math.max.apply(Math,i()(a.map((function(t){return t[0]})))),bottom:Math.min.apply(Math,i()(a.map((function(t){return t[1]})))),top:Math.max.apply(Math,i()(a.map((function(t){return t[1]})))),near:Math.min.apply(Math,i()(a.map((function(t){return-t[2]})))),far:Math.max.apply(Math,i()(a.map((function(t){return-t[2]}))))});o.push(s.multiplyRight(t))};for(d.s();!(e=d.n()).done;)A()}catch(t){d.e(t)}finally{d.f()}return o})),m=[0,0,0,1],y=[1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,0];function v(t,e){var n=t.shadowEnabled;if(!(void 0===n||n)||!t.shadowMatrices||!t.shadowMatrices.length)return{shadow_uDrawShadowMap:!1,shadow_uUseShadowMap:!1};for(var r={shadow_uDrawShadowMap:Boolean(t.drawToShadowMap),shadow_uUseShadowMap:!!t.shadowMaps&&t.shadowMaps.length>0,shadow_uColor:t.shadowColor||m,shadow_uLightId:t.shadowLightId||0,shadow_uLightCount:t.shadowMatrices.length},i=A({viewport:t.viewport,center:e.project_uCenter}),o=[],a=g({shadowMatrices:t.shadowMatrices,viewport:t.viewport}).slice(),u=0;u<t.shadowMatrices.length;u++){var c=a[u],h=c.clone().translate(new l.a(t.viewport.center).negate());e.project_uCoordinateSystem===s.a.LNGLAT&&e.project_uProjectionMode===s.d.WEB_MERCATOR?(a[u]=h,o[u]=i):(a[u]=c.clone().multiplyRight(y),o[u]=h.transform(i))}for(var f=0;f<a.length;f++)r["shadow_uViewProjectionMatrices[".concat(f,"]")]=a[f],r["shadow_uProjectCenters[".concat(f,"]")]=o[f],t.shadowMaps&&t.shadowMaps.length>0?r["shadow_uShadowMap".concat(f)]=t.shadowMaps[f]:r["shadow_uShadowMap".concat(f)]=t.dummyShadowMap;return r}e.a={name:"shadow",dependencies:[u.a],vs:"\nconst int max_lights = 2;\nuniform mat4 shadow_uViewProjectionMatrices[max_lights];\nuniform vec4 shadow_uProjectCenters[max_lights];\nuniform bool shadow_uDrawShadowMap;\nuniform bool shadow_uUseShadowMap;\nuniform int shadow_uLightId;\nuniform float shadow_uLightCount;\n\nvarying vec3 shadow_vPosition[max_lights];\n\nvec4 shadow_setVertexPosition(vec4 position_commonspace) {\n  if (shadow_uDrawShadowMap) {\n    return project_common_position_to_clipspace(position_commonspace, shadow_uViewProjectionMatrices[shadow_uLightId], shadow_uProjectCenters[shadow_uLightId]);\n  }\n  if (shadow_uUseShadowMap) {\n    for (int i = 0; i < max_lights; i++) {\n      if(i < int(shadow_uLightCount)) {\n        vec4 shadowMap_position = project_common_position_to_clipspace(position_commonspace, shadow_uViewProjectionMatrices[i], shadow_uProjectCenters[i]);\n        shadow_vPosition[i] = (shadowMap_position.xyz / shadowMap_position.w + 1.0) / 2.0;\n      }\n    }\n  }\n  return gl_Position;\n}\n",fs:"\nconst int max_lights = 2;\nuniform bool shadow_uDrawShadowMap;\nuniform bool shadow_uUseShadowMap;\nuniform sampler2D shadow_uShadowMap0;\nuniform sampler2D shadow_uShadowMap1;\nuniform vec4 shadow_uColor;\nuniform float shadow_uLightCount;\n\nvarying vec3 shadow_vPosition[max_lights];\n\nconst vec4 bitPackShift = vec4(1.0, 255.0, 65025.0, 16581375.0);\nconst vec4 bitUnpackShift = 1.0 / bitPackShift;\nconst vec4 bitMask = vec4(1.0 / 255.0, 1.0 / 255.0, 1.0 / 255.0,  0.0);\n\nfloat shadow_getShadowWeight(vec3 position, sampler2D shadowMap) {\n  vec4 rgbaDepth = texture2D(shadowMap, position.xy);\n\n  float z = dot(rgbaDepth, bitUnpackShift);\n  return smoothstep(0.001, 0.01, position.z - z);\n}\n\nvec4 shadow_filterShadowColor(vec4 color) {\n  if (shadow_uDrawShadowMap) {\n    vec4 rgbaDepth = fract(gl_FragCoord.z * bitPackShift);\n    rgbaDepth -= rgbaDepth.gbaa * bitMask;\n    return rgbaDepth;\n  }\n  if (shadow_uUseShadowMap) {\n    float shadowAlpha = 0.0;\n    shadowAlpha += shadow_getShadowWeight(shadow_vPosition[0], shadow_uShadowMap0);\n    if(shadow_uLightCount > 1.0) {\n      shadowAlpha += shadow_getShadowWeight(shadow_vPosition[1], shadow_uShadowMap1);\n    }\n    shadowAlpha *= shadow_uColor.a / shadow_uLightCount;\n    float blendedAlpha = shadowAlpha + color.a * (1.0 - shadowAlpha);\n\n    return vec4(\n      mix(color.rgb, shadow_uColor.rgb, shadowAlpha / blendedAlpha),\n      blendedAlpha\n    );\n  }\n  return color;\n}\n",inject:{"vs:DECKGL_FILTER_GL_POSITION":"\n    position = shadow_setVertexPosition(geometry.position);\n    ","fs:DECKGL_FILTER_COLOR":"\n    color = shadow_filterShadowColor(color);\n    "},getUniforms:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};return"viewport"in t&&(t.drawToShadowMap||t.shadowMaps&&t.shadowMaps.length>0)?v(t,e):{}}}},function(t,e,n){"use strict";n.d(e,"a",(function(){return p})),n.d(e,"b",(function(){return d}));var r=n(70),i=n(90),o=n(12),a=n(80),s=[0,0,0,0],u=[1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,0],c=[1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,1],l=[0,0,0],h=[0,0,0],f=Object(a.a)((function(t){var e=t.viewport,n=t.devicePixelRatio,a=t.coordinateSystem,h=t.coordinateOrigin,f=function(t,e,n){var o=t.viewMatrixUncentered,a=t.projectionMatrix,c=t.viewMatrix,l=t.viewProjectionMatrix,h=s,f=s,d=t.cameraPosition,A=p(t,e,n),g=A.geospatialOrigin,m=A.shaderCoordinateOrigin;A.offsetMode&&(f=t.projectPosition(g||m),d=[d[0]-f[0],d[1]-f[1],d[2]-f[2]],f[3]=1,h=i.b([],f,l),c=o||c,l=r.b([],a,c),l=r.b([],l,u));return{viewMatrix:c,viewProjectionMatrix:l,projectionCenter:h,originCommon:f,cameraPosCommon:d,shaderCoordinateOrigin:m,geospatialOrigin:g}}(e,a,h),d=f.projectionCenter,A=f.viewProjectionMatrix,g=f.originCommon,m=f.cameraPosCommon,y=f.shaderCoordinateOrigin,v=f.geospatialOrigin,_=e.getDistanceScales(),b=[e.width*n,e.height*n],x=i.b([],[0,0,-e.focalDistance,1],e.projectionMatrix)[3]||1,w={project_uCoordinateSystem:a,project_uProjectionMode:e.projectionMode,project_uCoordinateOrigin:y,project_uCommonOrigin:g.slice(0,3),project_uCenter:d,project_uPseudoMeters:Boolean(e._pseudoMeters),project_uViewportSize:b,project_uDevicePixelRatio:n,project_uFocalDistance:x,project_uCommonUnitsPerMeter:_.unitsPerMeter,project_uCommonUnitsPerWorldUnit:_.unitsPerMeter,project_uCommonUnitsPerWorldUnit2:l,project_uScale:e.scale,project_uWrapLongitude:!1,project_uViewProjectionMatrix:A,project_uModelMatrix:c,project_uCameraPosition:m};if(v){var E=e.getDistanceScales(v);switch(a){case o.a.METER_OFFSETS:w.project_uCommonUnitsPerWorldUnit=E.unitsPerMeter,w.project_uCommonUnitsPerWorldUnit2=E.unitsPerMeter2;break;case o.a.LNGLAT:case o.a.LNGLAT_OFFSETS:e._pseudoMeters||(w.project_uCommonUnitsPerMeter=E.unitsPerMeter),w.project_uCommonUnitsPerWorldUnit=E.unitsPerDegree,w.project_uCommonUnitsPerWorldUnit2=E.unitsPerDegree2;break;case o.a.CARTESIAN:w.project_uCommonUnitsPerWorldUnit=[1,1,E.unitsPerMeter[2]],w.project_uCommonUnitsPerWorldUnit2=[0,0,E.unitsPerMeter2[2]]}}return w}));function p(t,e){var n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:h;n.length<3&&(n=[n[0],n[1],0]);var r,i=n,a=!0;switch(r=e===o.a.LNGLAT_OFFSETS||e===o.a.METER_OFFSETS?n:t.isGeospatial?[Math.fround(t.longitude),Math.fround(t.latitude),0]:null,t.projectionMode){case o.d.WEB_MERCATOR:e!==o.a.LNGLAT&&e!==o.a.CARTESIAN||(r=[0,0,0],a=!1);break;case o.d.WEB_MERCATOR_AUTO_OFFSET:e===o.a.LNGLAT?i=r:e===o.a.CARTESIAN&&(i=[Math.fround(t.center[0]),Math.fround(t.center[1]),0],r=t.unprojectPosition(i),i[0]-=n[0],i[1]-=n[1],i[2]-=n[2]);break;case o.d.IDENTITY:(i=t.position.map(Math.fround))[2]=i[2]||0;break;case o.d.GLOBE:a=!1,r=null;break;default:a=!1}return{geospatialOrigin:r,shaderCoordinateOrigin:i,offsetMode:a}}function d(t){var e=t.viewport,n=t.devicePixelRatio,r=void 0===n?1:n,i=t.modelMatrix,a=void 0===i?null:i,s=t.coordinateSystem,u=void 0===s?o.a.DEFAULT:s,l=t.coordinateOrigin,p=void 0===l?h:l,d=t.autoWrapLongitude,A=void 0!==d&&d;u===o.a.DEFAULT&&(u=e.isGeospatial?o.a.LNGLAT:o.a.CARTESIAN);var g=f({viewport:e,devicePixelRatio:r,coordinateSystem:u,coordinateOrigin:p});return g.project_uWrapLongitude=A,g.project_uModelMatrix=a||c,g}},function(t,e,n){"use strict";n.d(e,"a",(function(){return s}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=function(){function t(e,n){i()(this,t),this._viewportProps=this.applyConstraints(e),this._state=n}return a()(t,[{key:"getViewportProps",value:function(){return this._viewportProps}},{key:"getState",value:function(){return this._state}}]),t}()},function(t,e,n){"use strict";n.d(e,"b",(function(){return u})),n.d(e,"a",(function(){return c})),n.d(e,"c",(function(){return l}));var r=n(156),i=n(22),o=n(127),a=n(108);const s="Cannot convert supplied data type";function u(t,e,n){if(e.text&&"string"==typeof t)return t;if(Object(i.c)(t)&&(t=t.buffer),t instanceof ArrayBuffer){const n=t;if(e.text&&!e.binary){return new TextDecoder("utf8").decode(n)}return n}if(ArrayBuffer.isView(t)){if(e.text&&!e.binary){return new TextDecoder("utf8").decode(t)}let n=t.buffer;const r=t.byteLength||t.length;return 0===t.byteOffset&&r===n.byteLength||(n=n.slice(t.byteOffset,t.byteOffset+r)),n}throw new Error(s)}async function c(t,e,n){const c=t instanceof ArrayBuffer||ArrayBuffer.isView(t);if("string"==typeof t||c)return u(t,e);if(Object(i.b)(t)&&(t=await Object(a.b)(t)),Object(i.j)(t)){const n=t;return await Object(a.a)(n),e.binary?await n.arrayBuffer():await n.text()}if(Object(i.i)(t)&&(t=Object(o.a)(t,n)),Object(i.d)(t)||Object(i.a)(t))return Object(r.a)(t);throw new Error(s)}async function l(t,e){if(Object(i.e)(t))return t;if(Object(i.j)(t)){const n=t;await Object(a.a)(n);const r=await n.body;return Object(o.a)(r,e)}return Object(i.b)(t)||Object(i.i)(t)?Object(o.a)(t,e):Object(i.a)(t)?t[Symbol.asyncIterator]():function(t){if(ArrayBuffer.isView(t))return function*(){yield t.buffer}();if(t instanceof ArrayBuffer)return function*(){yield t}();if(Object(i.e)(t))return t;if(Object(i.d)(t))return t[Symbol.iterator]();throw new Error(s)}(t)}},function(t,e,n){"use strict";const r=262144;var i=n(72),o=n(85);function a(t,e){return i.c?async function*(t,e){const n=t.getReader();let r;try{for(;;){const t=r||n.read();null!=e&&e._streamReadAhead&&(r=n.read());const{done:i,value:a}=await t;if(i)return;yield Object(o.d)(a)}}catch(t){n.releaseLock()}}(t,e):async function*(t,e){for await(const e of t)yield Object(o.d)(e)}(t)}var s=n(22);function u(t,e){if("string"==typeof t)return function*(t,e){const n=(null==e?void 0:e.chunkSize)||262144;let r=0;const i=new TextEncoder;for(;r<t.length;){const e=Math.min(t.length-r,n),o=t.slice(r,r+e);r+=e,yield i.encode(o)}}(t,e);if(t instanceof ArrayBuffer)return function*(t,e={}){const{chunkSize:n=r}=e;let i=0;for(;i<t.byteLength;){const e=Math.min(t.byteLength-i,n),r=new ArrayBuffer(e),o=new Uint8Array(t,i,e);new Uint8Array(r).set(o),i+=e,yield r}}(t,e);if(Object(s.b)(t))return async function*(t,e){const n=(null==e?void 0:e.chunkSize)||1048576;let r=0;for(;r<t.size;){const e=r+n,i=await t.slice(r,e).arrayBuffer();r=e,yield i}}(t,e);if(Object(s.i)(t))return a(t,e);if(Object(s.j)(t)){return a(t.body,e)}throw new Error("makeIterator")}n.d(e,"a",(function(){return u}))},function(t,e,n){"use strict";n.r(e),n.d(e,"MODULE_VERSION",(function(){return r})),n.d(e,"MODULE_NAME",(function(){return i}));var r="8.9.7",i="@deck.gl/jupyter-widget"},function(t,e,n){var r,i,o;
+/**
+ * @license long.js (c) 2013 Daniel Wirtz <dcode@dcode.io>
+ * Released under the Apache License, Version 2.0
+ * see: https://github.com/dcodeIO/long.js for details
+ */i=[],void 0===(o="function"==typeof(r=function(){"use strict";function t(t,e,n){this.low=0|t,this.high=0|e,this.unsigned=!!n}function e(t){return!0===(t&&t.__isLong__)}t.prototype.__isLong__,Object.defineProperty(t.prototype,"__isLong__",{value:!0,enumerable:!1,configurable:!1}),t.isLong=e;var n={},r={};function i(t,e){var i,o,s;return e?(s=0<=(t>>>=0)&&t<256)&&(o=r[t])?o:(i=a(t,(0|t)<0?-1:0,!0),s&&(r[t]=i),i):(s=-128<=(t|=0)&&t<128)&&(o=n[t])?o:(i=a(t,t<0?-1:0,!1),s&&(n[t]=i),i)}function o(t,e){if(isNaN(t)||!isFinite(t))return e?A:d;if(e){if(t<0)return A;if(t>=h)return _}else{if(t<=-f)return b;if(t+1>=f)return v}return t<0?o(-t,e).neg():a(t%l|0,t/l|0,e)}function a(e,n,r){return new t(e,n,r)}t.fromInt=i,t.fromNumber=o,t.fromBits=a;var s=Math.pow;function u(t,e,n){if(0===t.length)throw Error("empty string");if("NaN"===t||"Infinity"===t||"+Infinity"===t||"-Infinity"===t)return d;if("number"==typeof e?(n=e,e=!1):e=!!e,(n=n||10)<2||36<n)throw RangeError("radix");var r;if((r=t.indexOf("-"))>0)throw Error("interior hyphen");if(0===r)return u(t.substring(1),e,n).neg();for(var i=o(s(n,8)),a=d,c=0;c<t.length;c+=8){var l=Math.min(8,t.length-c),h=parseInt(t.substring(c,c+l),n);if(l<8){var f=o(s(n,l));a=a.mul(f).add(o(h))}else a=(a=a.mul(i)).add(o(h))}return a.unsigned=e,a}function c(e){return e instanceof t?e:"number"==typeof e?o(e):"string"==typeof e?u(e):a(e.low,e.high,e.unsigned)}t.fromString=u,t.fromValue=c;var l=4294967296,h=l*l,f=h/2,p=i(1<<24),d=i(0);t.ZERO=d;var A=i(0,!0);t.UZERO=A;var g=i(1);t.ONE=g;var m=i(1,!0);t.UONE=m;var y=i(-1);t.NEG_ONE=y;var v=a(-1,2147483647,!1);t.MAX_VALUE=v;var _=a(-1,-1,!0);t.MAX_UNSIGNED_VALUE=_;var b=a(0,-2147483648,!1);t.MIN_VALUE=b;var x=t.prototype;return x.toInt=function(){return this.unsigned?this.low>>>0:this.low},x.toNumber=function(){return this.unsigned?(this.high>>>0)*l+(this.low>>>0):this.high*l+(this.low>>>0)},x.toString=function(t){if((t=t||10)<2||36<t)throw RangeError("radix");if(this.isZero())return"0";if(this.isNegative()){if(this.eq(b)){var e=o(t),n=this.div(e),r=n.mul(e).sub(this);return n.toString(t)+r.toInt().toString(t)}return"-"+this.neg().toString(t)}for(var i=o(s(t,6),this.unsigned),a=this,u="";;){var c=a.div(i),l=(a.sub(c.mul(i)).toInt()>>>0).toString(t);if((a=c).isZero())return l+u;for(;l.length<6;)l="0"+l;u=""+l+u}},x.getHighBits=function(){return this.high},x.getHighBitsUnsigned=function(){return this.high>>>0},x.getLowBits=function(){return this.low},x.getLowBitsUnsigned=function(){return this.low>>>0},x.getNumBitsAbs=function(){if(this.isNegative())return this.eq(b)?64:this.neg().getNumBitsAbs();for(var t=0!=this.high?this.high:this.low,e=31;e>0&&0==(t&1<<e);e--);return 0!=this.high?e+33:e+1},x.isZero=function(){return 0===this.high&&0===this.low},x.isNegative=function(){return!this.unsigned&&this.high<0},x.isPositive=function(){return this.unsigned||this.high>=0},x.isOdd=function(){return 1==(1&this.low)},x.isEven=function(){return 0==(1&this.low)},x.equals=function(t){return e(t)||(t=c(t)),(this.unsigned===t.unsigned||this.high>>>31!=1||t.high>>>31!=1)&&this.high===t.high&&this.low===t.low},x.eq=x.equals,x.notEquals=function(t){return!this.eq(t)},x.neq=x.notEquals,x.lessThan=function(t){return this.comp(t)<0},x.lt=x.lessThan,x.lessThanOrEqual=function(t){return this.comp(t)<=0},x.lte=x.lessThanOrEqual,x.greaterThan=function(t){return this.comp(t)>0},x.gt=x.greaterThan,x.greaterThanOrEqual=function(t){return this.comp(t)>=0},x.gte=x.greaterThanOrEqual,x.compare=function(t){if(e(t)||(t=c(t)),this.eq(t))return 0;var n=this.isNegative(),r=t.isNegative();return n&&!r?-1:!n&&r?1:this.unsigned?t.high>>>0>this.high>>>0||t.high===this.high&&t.low>>>0>this.low>>>0?-1:1:this.sub(t).isNegative()?-1:1},x.comp=x.compare,x.negate=function(){return!this.unsigned&&this.eq(b)?b:this.not().add(g)},x.neg=x.negate,x.add=function(t){e(t)||(t=c(t));var n=this.high>>>16,r=65535&this.high,i=this.low>>>16,o=65535&this.low,s=t.high>>>16,u=65535&t.high,l=t.low>>>16,h=0,f=0,p=0,d=0;return p+=(d+=o+(65535&t.low))>>>16,f+=(p+=i+l)>>>16,h+=(f+=r+u)>>>16,h+=n+s,a((p&=65535)<<16|(d&=65535),(h&=65535)<<16|(f&=65535),this.unsigned)},x.subtract=function(t){return e(t)||(t=c(t)),this.add(t.neg())},x.sub=x.subtract,x.multiply=function(t){if(this.isZero())return d;if(e(t)||(t=c(t)),t.isZero())return d;if(this.eq(b))return t.isOdd()?b:d;if(t.eq(b))return this.isOdd()?b:d;if(this.isNegative())return t.isNegative()?this.neg().mul(t.neg()):this.neg().mul(t).neg();if(t.isNegative())return this.mul(t.neg()).neg();if(this.lt(p)&&t.lt(p))return o(this.toNumber()*t.toNumber(),this.unsigned);var n=this.high>>>16,r=65535&this.high,i=this.low>>>16,s=65535&this.low,u=t.high>>>16,l=65535&t.high,h=t.low>>>16,f=65535&t.low,A=0,g=0,m=0,y=0;return m+=(y+=s*f)>>>16,g+=(m+=i*f)>>>16,m&=65535,g+=(m+=s*h)>>>16,A+=(g+=r*f)>>>16,g&=65535,A+=(g+=i*h)>>>16,g&=65535,A+=(g+=s*l)>>>16,A+=n*f+r*h+i*l+s*u,a((m&=65535)<<16|(y&=65535),(A&=65535)<<16|(g&=65535),this.unsigned)},x.mul=x.multiply,x.divide=function(t){if(e(t)||(t=c(t)),t.isZero())throw Error("division by zero");if(this.isZero())return this.unsigned?A:d;var n,r,i;if(this.unsigned){if(t.unsigned||(t=t.toUnsigned()),t.gt(this))return A;if(t.gt(this.shru(1)))return m;i=A}else{if(this.eq(b))return t.eq(g)||t.eq(y)?b:t.eq(b)?g:(n=this.shr(1).div(t).shl(1)).eq(d)?t.isNegative()?g:y:(r=this.sub(t.mul(n)),i=n.add(r.div(t)));if(t.eq(b))return this.unsigned?A:d;if(this.isNegative())return t.isNegative()?this.neg().div(t.neg()):this.neg().div(t).neg();if(t.isNegative())return this.div(t.neg()).neg();i=d}for(r=this;r.gte(t);){n=Math.max(1,Math.floor(r.toNumber()/t.toNumber()));for(var a=Math.ceil(Math.log(n)/Math.LN2),u=a<=48?1:s(2,a-48),l=o(n),h=l.mul(t);h.isNegative()||h.gt(r);)h=(l=o(n-=u,this.unsigned)).mul(t);l.isZero()&&(l=g),i=i.add(l),r=r.sub(h)}return i},x.div=x.divide,x.modulo=function(t){return e(t)||(t=c(t)),this.sub(this.div(t).mul(t))},x.mod=x.modulo,x.not=function(){return a(~this.low,~this.high,this.unsigned)},x.and=function(t){return e(t)||(t=c(t)),a(this.low&t.low,this.high&t.high,this.unsigned)},x.or=function(t){return e(t)||(t=c(t)),a(this.low|t.low,this.high|t.high,this.unsigned)},x.xor=function(t){return e(t)||(t=c(t)),a(this.low^t.low,this.high^t.high,this.unsigned)},x.shiftLeft=function(t){return e(t)&&(t=t.toInt()),0==(t&=63)?this:t<32?a(this.low<<t,this.high<<t|this.low>>>32-t,this.unsigned):a(0,this.low<<t-32,this.unsigned)},x.shl=x.shiftLeft,x.shiftRight=function(t){return e(t)&&(t=t.toInt()),0==(t&=63)?this:t<32?a(this.low>>>t|this.high<<32-t,this.high>>t,this.unsigned):a(this.high>>t-32,this.high>=0?0:-1,this.unsigned)},x.shr=x.shiftRight,x.shiftRightUnsigned=function(t){if(e(t)&&(t=t.toInt()),0==(t&=63))return this;var n=this.high;return t<32?a(this.low>>>t|n<<32-t,n>>>t,this.unsigned):a(32===t?n:n>>>t-32,0,this.unsigned)},x.shru=x.shiftRightUnsigned,x.toSigned=function(){return this.unsigned?a(this.low,this.high,!1):this},x.toUnsigned=function(){return this.unsigned?this:a(this.low,this.high,!0)},x.toBytes=function(t){return t?this.toBytesLE():this.toBytesBE()},x.toBytesLE=function(){var t=this.high,e=this.low;return[255&e,e>>>8&255,e>>>16&255,e>>>24&255,255&t,t>>>8&255,t>>>16&255,t>>>24&255]},x.toBytesBE=function(){var t=this.high,e=this.low;return[t>>>24&255,t>>>16&255,t>>>8&255,255&t,e>>>24&255,e>>>16&255,e>>>8&255,255&e]},t})?r.apply(e,i):r)||(t.exports=o)},function(t,e,n){"use strict";n.d(e,"a",(function(){return f})),n.d(e,"b",(function(){return p}));var r=n(52),i=n(12);function o(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return a(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return a(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,s=!0,u=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return s=t.done,t},e:function(t){u=!0,o=t},f:function(){try{s||null==n.return||n.return()}finally{if(u)throw o}}}}function a(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var s=Math.PI/180,u=new Float32Array(16),c=new Float32Array(12);function l(t,e,n){var r=e[0]*s,i=e[1]*s,o=e[2]*s,a=Math.sin(o),u=Math.sin(r),c=Math.sin(i),l=Math.cos(o),h=Math.cos(r),f=Math.cos(i),p=n[0],d=n[1],A=n[2];t[0]=p*f*h,t[1]=p*c*h,t[2]=p*-u,t[3]=d*(-c*l+f*u*a),t[4]=d*(f*l+c*u*a),t[5]=d*h*a,t[6]=A*(c*a+f*u*l),t[7]=A*(-f*a+c*u*l),t[8]=A*h*l}function h(t){return t[0]=t[0],t[1]=t[1],t[2]=t[2],t[3]=t[4],t[4]=t[5],t[5]=t[6],t[6]=t[8],t[7]=t[9],t[8]=t[10],t[9]=t[12],t[10]=t[13],t[11]=t[14],t.subarray(0,12)}var f={size:12,accessor:["getOrientation","getScale","getTranslation","getTransformMatrix"],shaderAttributes:{instanceModelMatrix__LOCATION_0:{size:3,elementOffset:0},instanceModelMatrix__LOCATION_1:{size:3,elementOffset:3},instanceModelMatrix__LOCATION_2:{size:3,elementOffset:6},instanceTranslation:{size:3,elementOffset:9}},update:function(t,e){var n=e.startRow,i=e.endRow,a=this.props,s=a.data,f=a.getOrientation,p=a.getScale,d=a.getTranslation,A=a.getTransformMatrix,g=Array.isArray(A),m=g&&16===A.length,y=Array.isArray(p),v=Array.isArray(f),_=Array.isArray(d),b=m||!g&&Boolean(A(s[0]));t.constant=b?m:v&&y&&_;var x=t.value;if(t.constant){var w;if(b)u.set(A),w=h(u);else l(w=c,f,p),w.set(d,9);t.value=new Float32Array(w)}else{var E,O=n*t.size,S=Object(r.a)(s,n,i),T=S.iterable,C=S.objectInfo,P=o(T);try{for(P.s();!(E=P.n()).done;){var M=E.value;C.index++;var I=void 0;if(b)u.set(m?A:A(M,C)),I=h(u);else l(I=c,v?f:f(M,C),y?p:p(M,C)),I.set(_?d:d(M,C),9);x[O++]=I[0],x[O++]=I[1],x[O++]=I[2],x[O++]=I[3],x[O++]=I[4],x[O++]=I[5],x[O++]=I[6],x[O++]=I[7],x[O++]=I[8],x[O++]=I[9],x[O++]=I[10],x[O++]=I[11]}}catch(t){P.e(t)}finally{P.f()}}}};function p(t,e){return e===i.a.CARTESIAN||e===i.a.METER_OFFSETS||e===i.a.DEFAULT&&!t.isGeospatial}},function(t,e,n){"use strict";(function(t){n.d(e,"b",(function(){return a})),n.d(e,"c",(function(){return s}));var r,i=n(184);t.browser&&(r=n(286));var o="https://api.tiles.mapbox.com/mapbox-gl-js/v1.2.1/mapbox-gl.css";function a(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:o;Object(i.b)(t)}function s(){for(var t=0,e=["mapboxgl-missing-css"];t<e.length;t++){var n=e[t],r=document.getElementsByClassName(n)[0];r&&r.style&&(r.style.display="none")}}e.a=r}).call(this,n(44))},function(t,e,n){"use strict";n.d(e,"a",(function(){return a})),n.d(e,"b",(function(){return s}));var r=n(7),i=n(76),o=n(142);class a{constructor(){this.stats=new Map}get(t){return this.stats.has(t)||this.stats.set(t,new i.a({id:t})),this.stats.get(t)}}const s=new a;if(globalThis.luma&&"8.5.16"!==globalThis.luma.VERSION)throw new Error("luma.gl - multiple VERSIONs detected: ".concat(globalThis.luma.VERSION," vs ").concat("8.5.16"));globalThis.luma||(Object(o.a)()&&r.k.log(1,"luma.gl ".concat("8.5.16"," - ").concat("set luma.log.level=1 (or higher) to trace rendering"))(),globalThis.luma=globalThis.luma||{VERSION:"8.5.16",version:"8.5.16",log:r.k,stats:s,globals:{modules:{},nodeIO:{}}});globalThis.luma},function(t,e){},function(t,e,n){"use strict";var r=n(2),i=n(49);class o{}var a=n(51);const s=new Map;function u(t){Object(a.a)(t.source&&!t.url||!t.source&&t.url);let e=s.get(t.source||t.url);return e||(t.url&&(e=function(t){if(!t.startsWith("http"))return t;return c((e=t,"try {\n  importScripts('".concat(e,"');\n} catch (error) {\n  console.error(error);\n  throw error;\n}")));var e}(t.url),s.set(t.url,e)),t.source&&(e=c(t.source),s.set(t.source,e))),Object(a.a)(e),e}function c(t){const e=new Blob([t],{type:"application/javascript"});return URL.createObjectURL(e)}var l=n(179);const h=()=>{};class f{static isSupported(){return"undefined"!=typeof Worker&&i.b||void 0!==o&&!i.b}constructor(t){Object(r.a)(this,"name",void 0),Object(r.a)(this,"source",void 0),Object(r.a)(this,"url",void 0),Object(r.a)(this,"terminated",!1),Object(r.a)(this,"worker",void 0),Object(r.a)(this,"onMessage",void 0),Object(r.a)(this,"onError",void 0),Object(r.a)(this,"_loadableURL","");const{name:e,source:n,url:o}=t;Object(a.a)(n||o),this.name=e,this.source=n,this.url=o,this.onMessage=h,this.onError=t=>console.log(t),this.worker=i.b?this._createBrowserWorker():this._createNodeWorker()}destroy(){this.onMessage=h,this.onError=h,this.worker.terminate(),this.terminated=!0}get isRunning(){return Boolean(this.onMessage)}postMessage(t,e){e=e||Object(l.a)(t),this.worker.postMessage(t,e)}_getErrorFromErrorEvent(t){let e="Failed to load ";return e+="worker ".concat(this.name," from ").concat(this.url,". "),t.message&&(e+="".concat(t.message," in ")),t.lineno&&(e+=":".concat(t.lineno,":").concat(t.colno)),new Error(e)}_createBrowserWorker(){this._loadableURL=u({source:this.source,url:this.url});const t=new Worker(this._loadableURL,{name:this.name});return t.onmessage=t=>{t.data?this.onMessage(t.data):this.onError(new Error("No data received"))},t.onerror=t=>{this.onError(this._getErrorFromErrorEvent(t)),this.terminated=!0},t.onmessageerror=t=>console.error(t),t}_createNodeWorker(){let t;if(this.url){const e=this.url.includes(":/")||this.url.startsWith("/")?this.url:"./".concat(this.url);t=new o(e,{eval:!1})}else{if(!this.source)throw new Error("no worker");t=new o(this.source,{eval:!0})}return t.on("message",t=>{this.onMessage(t)}),t.on("error",t=>{this.onError(t)}),t.on("exit",t=>{}),t}}class p{constructor(t,e){Object(r.a)(this,"name",void 0),Object(r.a)(this,"workerThread",void 0),Object(r.a)(this,"isRunning",!0),Object(r.a)(this,"result",void 0),Object(r.a)(this,"_resolve",()=>{}),Object(r.a)(this,"_reject",()=>{}),this.name=t,this.workerThread=e,this.result=new Promise((t,e)=>{this._resolve=t,this._reject=e})}postMessage(t,e){this.workerThread.postMessage({source:"loaders.gl",type:t,payload:e})}done(t){Object(a.a)(this.isRunning),this.isRunning=!1,this._resolve(t)}error(t){Object(a.a)(this.isRunning),this.isRunning=!1,this._reject(t)}}class d{static isSupported(){return f.isSupported()}constructor(t){Object(r.a)(this,"name","unnamed"),Object(r.a)(this,"source",void 0),Object(r.a)(this,"url",void 0),Object(r.a)(this,"maxConcurrency",1),Object(r.a)(this,"maxMobileConcurrency",1),Object(r.a)(this,"onDebug",()=>{}),Object(r.a)(this,"reuseWorkers",!0),Object(r.a)(this,"props",{}),Object(r.a)(this,"jobQueue",[]),Object(r.a)(this,"idleQueue",[]),Object(r.a)(this,"count",0),Object(r.a)(this,"isDestroyed",!1),this.source=t.source,this.url=t.url,this.setProps(t)}destroy(){this.idleQueue.forEach(t=>t.destroy()),this.isDestroyed=!0}setProps(t){this.props={...this.props,...t},void 0!==t.name&&(this.name=t.name),void 0!==t.maxConcurrency&&(this.maxConcurrency=t.maxConcurrency),void 0!==t.maxMobileConcurrency&&(this.maxMobileConcurrency=t.maxMobileConcurrency),void 0!==t.reuseWorkers&&(this.reuseWorkers=t.reuseWorkers),void 0!==t.onDebug&&(this.onDebug=t.onDebug)}async startJob(t,e=((t,e,n)=>t.done(n)),n=((t,e)=>t.error(e))){const r=new Promise(r=>(this.jobQueue.push({name:t,onMessage:e,onError:n,onStart:r}),this));return this._startQueuedJob(),await r}async _startQueuedJob(){if(!this.jobQueue.length)return;const t=this._getAvailableWorker();if(!t)return;const e=this.jobQueue.shift();if(e){this.onDebug({message:"Starting job",name:e.name,workerThread:t,backlog:this.jobQueue.length});const n=new p(e.name,t);t.onMessage=t=>e.onMessage(n,t.type,t.payload),t.onError=t=>e.onError(n,t),e.onStart(n);try{await n.result}finally{this.returnWorkerToQueue(t)}}}returnWorkerToQueue(t){this.isDestroyed||!this.reuseWorkers||this.count>this._getMaxConcurrency()?(t.destroy(),this.count--):this.idleQueue.push(t),this.isDestroyed||this._startQueuedJob()}_getAvailableWorker(){if(this.idleQueue.length>0)return this.idleQueue.shift()||null;if(this.count<this._getMaxConcurrency()){this.count++;const t="".concat(this.name.toLowerCase()," (#").concat(this.count," of ").concat(this.maxConcurrency,")");return new f({name:t,source:this.source,url:this.url})}return null}_getMaxConcurrency(){return i.c?this.maxMobileConcurrency:this.maxConcurrency}}n.d(e,"a",(function(){return g}));const A={maxConcurrency:3,maxMobileConcurrency:1,reuseWorkers:!0,onDebug:()=>{}};class g{static isSupported(){return f.isSupported()}static getWorkerFarm(t={}){return g._workerFarm=g._workerFarm||new g({}),g._workerFarm.setProps(t),g._workerFarm}constructor(t){Object(r.a)(this,"props",void 0),Object(r.a)(this,"workerPools",new Map),this.props={...A},this.setProps(t),this.workerPools=new Map}destroy(){for(const t of this.workerPools.values())t.destroy();this.workerPools=new Map}setProps(t){this.props={...this.props,...t};for(const t of this.workerPools.values())t.setProps(this._getWorkerPoolProps())}getWorkerPool(t){const{name:e,source:n,url:r}=t;let i=this.workerPools.get(e);return i||(i=new d({name:e,source:n,url:r}),i.setProps(this._getWorkerPoolProps()),this.workerPools.set(e,i)),i}_getWorkerPoolProps(){return{maxConcurrency:this.props.maxConcurrency,maxMobileConcurrency:this.props.maxMobileConcurrency,reuseWorkers:this.props.reuseWorkers,onDebug:this.props.onDebug}}}Object(r.a)(g,"_workerFarm",void 0)},function(t,e,n){"use strict";async function*r(t,e={}){const n=new TextDecoder(void 0,e);for await(const e of t)yield"string"==typeof e?e:n.decode(e,{stream:!0})}async function*i(t){const e=new TextEncoder;for await(const n of t)yield"string"==typeof n?e.encode(n):n}async function*o(t){let e="";for await(const n of t){let t;for(e+=n;(t=e.indexOf("\n"))>=0;){const n=e.slice(0,t+1);e=e.slice(t+1),yield n}}e.length>0&&(yield e)}async function*a(t){let e=1;for await(const n of t)yield{counter:e,line:n},e++}n.d(e,"c",(function(){return r})),n.d(e,"d",(function(){return i})),n.d(e,"a",(function(){return o})),n.d(e,"b",(function(){return a}))},function(t,e,n){"use strict";function r(t,e=5){if("string"==typeof t)return t.slice(0,e);if(ArrayBuffer.isView(t))return i(t.buffer,t.byteOffset,e);if(t instanceof ArrayBuffer){return i(t,0,e)}return""}function i(t,e,n){if(t.byteLength<=e+n)return"";const r=new DataView(t);let i="";for(let t=0;t<n;t++)i+=String.fromCharCode(r.getUint8(e+t));return i}n.d(e,"a",(function(){return r}))},function(t,e,n){"use strict";(function(t){function r(){let e;if("undefined"!=typeof window&&window.performance)e=window.performance.now();else if(void 0!==t&&t.hrtime){const n=t.hrtime();e=1e3*n[0]+n[1]/1e6}else e=Date.now();return e}n.d(e,"a",(function(){return r}))}).call(this,n(44))},function(t,e,n){"use strict";n.d(e,"c",(function(){return a})),n.d(e,"b",(function(){return s})),n.d(e,"a",(function(){return c}));var r=n(28),i=n.n(r),o=n(24);function a(t){var e=p(t);for(var n in e){var r=e[n],i=r.validate;if(i&&!i(t[n],r))throw new Error("Invalid prop ".concat(n,": ").concat(t[n]))}}function s(t,e){var n=c({newProps:t,oldProps:e,propTypes:p(t),ignoreProps:{data:null,updateTriggers:null,extensions:null,transitions:null}}),r=function(t,e){if(null===e)return"oldProps is null, initial diff";var n=!1,r=t.dataComparator,i=t._dataDiff;r?r(t.data,e.data)||(n="Data comparator detected a change"):t.data!==e.data&&(n="A new data container was supplied");n&&i&&(n=i(t.data,e.data)||n);return n}(t,e),i=!1;return r||(i=function(t,e){if(null===e)return{all:!0};if("all"in t.updateTriggers){if(f(t,e,"all"))return{all:!0}}var n={},r=!1;for(var i in t.updateTriggers){if("all"!==i)f(t,e,i)&&(n[i]=!0,r=!0)}return!!r&&n}(t,e)),{dataChanged:r,propsChanged:n,updateTriggersChanged:i,extensionsChanged:h(t,e),transitionsChanged:u(t,e)}}function u(t,e){if(!t.transitions)return!1;var n={},r=p(t),i=!1;for(var o in t.transitions){var a=r[o],s=a&&a.type;("number"===s||"color"===s||"array"===s)&&l(t[o],e[o],a)&&(n[o]=!0,i=!0)}return!!i&&n}function c(t){var e=t.newProps,n=t.oldProps,r=t.ignoreProps,o=void 0===r?{}:r,a=t.propTypes,s=void 0===a?{}:a,u=t.triggerName,c=void 0===u?"props":u;if(n===e)return!1;if("object"!==i()(e)||null===e)return"".concat(c," changed shallowly");if("object"!==i()(n)||null===n)return"".concat(c," changed shallowly");for(var h=0,f=Object.keys(e);h<f.length;h++){var p=f[h];if(!(p in o)){if(!(p in n))return"".concat(c,".").concat(p," added");var d=l(e[p],n[p],s[p]);if(d)return"".concat(c,".").concat(p," ").concat(d)}}for(var A=0,g=Object.keys(n);A<g.length;A++){var m=g[A];if(!(m in o)){if(!(m in e))return"".concat(c,".").concat(m," dropped");if(!Object.hasOwnProperty.call(e,m)){var y=l(e[m],n[m],s[m]);if(y)return"".concat(c,".").concat(m," ").concat(y)}}}return!1}function l(t,e,n){var r=n&&n.equal;return r&&!r(t,e,n)?"changed deeply":r||!(r=t&&e&&t.equals)||r.call(t,e)?r||e===t?null:"changed shallowly":"changed deeply"}function h(t,e){if(null===e)return!0;var n=e.extensions,r=t.extensions;if(r===n)return!1;if(!n||!r)return!0;if(r.length!==n.length)return!0;for(var i=0;i<r.length;i++)if(!r[i].equals(n[i]))return!0;return!1}function f(t,e,n){var r=t.updateTriggers[n];r=null==r?{}:r;var i=e.updateTriggers[n];return c({oldProps:i=null==i?{}:i,newProps:r,triggerName:n})}function p(t){var e=t[o.d],n=e&&e.constructor;return n?n._propTypes:{}}},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(0),u=n.n(s),c=n(204),l=n(107),h=n(152),f=n(102),p=n(78),d=n(84),A=n(8),g=n.n(A),m=n(5),y=n.n(m),v=n(6),_=n.n(v),b=n(1),x=n.n(b),w=n(73),E=n(109),O=n(74),S=n(7);function T(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function C(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?T(Object(n),!0).forEach((function(e){u()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):T(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function P(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=x()(t);if(e){var i=x()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return _()(this,n)}}var M=function(t){y()(n,t);var e=P(n);function n(t,r){var o,a,s;return i()(this,n),(s=e.call(this,t,r)).shadowMap=new l.a(t,{width:1,height:1,parameters:(o={},u()(o,10241,9729),u()(o,10240,9729),u()(o,10242,33071),u()(o,10243,33071),o)}),s.depthBuffer=new E.a(t,{format:33189,width:1,height:1}),s.fbo=new O.a(t,{id:"shadowmap",width:1,height:1,attachments:(a={},u()(a,36064,s.shadowMap),u()(a,36096,s.depthBuffer),a)}),s}return a()(n,[{key:"render",value:function(t){var e=this,r=this.fbo;Object(S.o)(this.gl,{depthRange:[0,1],depthTest:!0,blend:!1,clearColor:[1,1,1,1]},(function(){var i=t.viewports[0],o=Object(S.e)(e.gl),a=i.width*o,s=i.height*o;a===r.width&&s===r.height||r.resize({width:a,height:s}),g()(x()(n.prototype),"render",e).call(e,C(C({},t),{},{target:r,pass:"shadow"}))}))}},{key:"shouldDrawLayer",value:function(t){return!1!==t.props.shadowEnabled}},{key:"getModuleParameters",value:function(){return{drawToShadowMap:!0}}},{key:"delete",value:function(){this.fbo&&(this.fbo.delete(),this.fbo=null),this.shadowMap&&(this.shadowMap.delete(),this.shadowMap=null),this.depthBuffer&&(this.depthBuffer.delete(),this.depthBuffer=null)}}]),n}(w.a),I=n(123);function B(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return R(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return R(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function R(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}n.d(e,"a",(function(){return j}));var k={color:[255,255,255],intensity:1},D=[{color:[255,255,255],intensity:1,direction:[-1,3,-1]},{color:[255,255,255],intensity:.9,direction:[1,-8,-2.5]}],L=[0,0,0,200/255],j=function(){function t(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};for(var n in i()(this,t),u()(this,"id","lighting-effect"),u()(this,"props",null),u()(this,"shadowColor",L),u()(this,"ambientLight",null),u()(this,"directionalLights",[]),u()(this,"pointLights",[]),u()(this,"shadowPasses",[]),u()(this,"shadowMaps",[]),u()(this,"dummyShadowMap",null),e){var r=e[n];switch(r.type){case"ambient":this.ambientLight=r;break;case"directional":this.directionalLights.push(r);break;case"point":this.pointLights.push(r)}}this._applyDefaultLights(),this.shadow=this.directionalLights.some((function(t){return t.shadow}))}return a()(t,[{key:"preRender",value:function(t,e){var n=e.layers,r=e.layerFilter,i=e.viewports,o=e.onViewportActive,a=e.views;if(this.shadow){this.shadowMatrices=this._calculateMatrices(),0===this.shadowPasses.length&&this._createShadowPasses(t),this.programManager||(this.programManager=c.a.getDefaultProgramManager(t),I.a&&this.programManager.addDefaultModule(I.a)),this.dummyShadowMap||(this.dummyShadowMap=new l.a(t,{width:1,height:1}));for(var s=0;s<this.shadowPasses.length;s++){this.shadowPasses[s].render({layers:n,layerFilter:r,viewports:i,onViewportActive:o,views:a,moduleParameters:{shadowLightId:s,dummyShadowMap:this.dummyShadowMap,shadowMatrices:this.shadowMatrices}})}}}},{key:"getModuleParameters",value:function(t){var e=this.shadow?{shadowMaps:this.shadowMaps,dummyShadowMap:this.dummyShadowMap,shadowColor:this.shadowColor,shadowMatrices:this.shadowMatrices}:{};return e.lightSources={ambientLight:this.ambientLight,directionalLights:this.directionalLights.map((function(e){return e.getProjectedLight({layer:t})})),pointLights:this.pointLights.map((function(e){return e.getProjectedLight({layer:t})}))},e}},{key:"cleanup",value:function(){var t,e=B(this.shadowPasses);try{for(e.s();!(t=e.n()).done;){t.value.delete()}}catch(t){e.e(t)}finally{e.f()}this.shadowPasses.length=0,this.shadowMaps.length=0,this.dummyShadowMap&&(this.dummyShadowMap.delete(),this.dummyShadowMap=null),this.shadow&&this.programManager&&(this.programManager.removeDefaultModule(I.a),this.programManager=null)}},{key:"_calculateMatrices",value:function(){var t,e=[],n=B(this.directionalLights);try{for(n.s();!(t=n.n()).done;){var r=t.value,i=(new p.a).lookAt({eye:new d.a(r.direction).negate()});e.push(i)}}catch(t){n.e(t)}finally{n.f()}return e}},{key:"_createShadowPasses",value:function(t){for(var e=0;e<this.directionalLights.length;e++){var n=new M(t);this.shadowPasses[e]=n,this.shadowMaps[e]=n.shadowMap}}},{key:"_applyDefaultLights",value:function(){var t=this.ambientLight,e=this.pointLights,n=this.directionalLights;t||0!==e.length||0!==n.length||(this.ambientLight=new h.a(k),this.directionalLights.push(new f.a(D[0]),new f.a(D[1])))}}]),t}()},function(t,e,n){var r=n(264);function i(){return"undefined"!=typeof Reflect&&Reflect.get?(t.exports=i=Reflect.get.bind(),t.exports.__esModule=!0,t.exports.default=t.exports):(t.exports=i=function(t,e,n){var i=r(t,e);if(i){var o=Object.getOwnPropertyDescriptor(i,e);return o.get?o.get.call(arguments.length<3?t:n):o.value}},t.exports.__esModule=!0,t.exports.default=t.exports),i.apply(this,arguments)}t.exports=i,t.exports.__esModule=!0,t.exports.default=t.exports},function(e,n){e.exports=t},function(t,e,n){"use strict";(function(t){n.d(e,"a",(function(){return i}));var r=n(175);function i(){return!("object"==typeof t&&"[object process]"===String(t)&&!t.browser)||Object(r.a)()}}).call(this,n(44))},function(t,e,n){"use strict";n.d(e,"a",(function(){return i}));var r=n(7);function i(t,e,n){const{removedProps:i={},deprecatedProps:o={},replacedProps:a={}}=n;for(const n in i)if(n in e){const e=i[n]?"".concat(t,".").concat(i[n]):"N/A";r.k.removed("".concat(t,".").concat(n),e)()}for(const n in o)if(n in e){const e=o[n];r.k.deprecated("".concat(t,".").concat(n),"".concat(t,".").concat(e))()}let s=null;for(const n in a)if(n in e){const i=a[n];r.k.deprecated("".concat(t,".").concat(n),"".concat(t,".").concat(i))(),s=s||Object.assign({},e),s[i]=e[n],delete s[n]}return s||e}},function(t,e,n){"use strict";function r(t,e){if(!t)throw new Error("math.gl assertion ".concat(e))}n.d(e,"a",(function(){return r}))},function(t,e,n){"use strict";n.d(e,"a",(function(){return f})),n.d(e,"b",(function(){return p}));var r=n(9),i=n.n(r),o=n(12),a=n(124),s=n(86),u=n(90),c=n(83),l=n(19);function h(t,e){var n=arguments.length>2&&void 0!==arguments[2]&&arguments[2],r=e.projectPosition(t);if(n&&e instanceof s.a){var o=i()(t,3),a=o[0],u=o[1],c=o[2],l=void 0===c?0:c,h=e.getDistanceScales([a,u]);r[2]=l*h.unitsPerMeter[2]}return r}function f(t,e){var n=e.viewport,r=e.modelMatrix,a=e.coordinateSystem,s=e.coordinateOrigin,c=e.offsetMode,f=i()(t,3),p=f[0],d=f[1],A=f[2],g=void 0===A?0:A;if(r){var m=u.b([],[p,d,g,1],r),y=i()(m,3);p=y[0],d=y[1],g=y[2]}switch(a){case o.a.LNGLAT:return h([p,d,g],n,c);case o.a.LNGLAT_OFFSETS:return h([p+s[0],d+s[1],g+(s[2]||0)],n,c);case o.a.METER_OFFSETS:return h(Object(l.a)(s,[p,d,g]),n,c);case o.a.CARTESIAN:default:return n.isGeospatial?[p+s[0],d+s[1],g+s[2]]:n.projectPosition([p,d,g])}}function p(t,e){var n=function(t){var e=t.viewport,n=t.modelMatrix,r=t.coordinateOrigin,i=t.coordinateSystem,a=t.fromCoordinateSystem,s=t.fromCoordinateOrigin;return i===o.a.DEFAULT&&(i=e.isGeospatial?o.a.LNGLAT:o.a.CARTESIAN),void 0===a&&(a=i),void 0===s&&(s=r),{viewport:e,coordinateSystem:i,coordinateOrigin:r,modelMatrix:n,fromCoordinateSystem:a,fromCoordinateOrigin:s}}(e),r=n.viewport,i=n.coordinateSystem,s=n.coordinateOrigin,u=n.modelMatrix,l=n.fromCoordinateSystem,h=n.fromCoordinateOrigin,p=Object(a.a)(r,i,s),d=p.geospatialOrigin,A=p.shaderCoordinateOrigin,g=p.offsetMode,m=f(t,{viewport:r,modelMatrix:u,coordinateSystem:l,coordinateOrigin:h,offsetMode:g});if(g){var y=r.projectPosition(d||A);c.d(m,m,y)}return m}},function(t,e,n){"use strict";var r="#if (defined(SHADER_TYPE_FRAGMENT) && defined(LIGHTING_FRAGMENT)) || (defined(SHADER_TYPE_VERTEX) && defined(LIGHTING_VERTEX))\n\nstruct AmbientLight {\n vec3 color;\n};\n\nstruct PointLight {\n vec3 color;\n vec3 position;\n vec3 attenuation;\n};\n\nstruct DirectionalLight {\n  vec3 color;\n  vec3 direction;\n};\n\nuniform AmbientLight lighting_uAmbientLight;\nuniform PointLight lighting_uPointLight[MAX_LIGHTS];\nuniform DirectionalLight lighting_uDirectionalLight[MAX_LIGHTS];\nuniform int lighting_uPointLightCount;\nuniform int lighting_uDirectionalLightCount;\n\nuniform bool lighting_uEnabled;\n\nfloat getPointLightAttenuation(PointLight pointLight, float distance) {\n  return pointLight.attenuation.x\n       + pointLight.attenuation.y * distance\n       + pointLight.attenuation.z * distance * distance;\n}\n\n#endif\n";n.d(e,"a",(function(){return s}));const i={lightSources:{}};function o(){let{color:t=[0,0,0],intensity:e=1}=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return t.map(t=>t*e/255)}function a(t){let{ambientLight:e,pointLights:n=[],directionalLights:r=[]}=t;const i={};return i["lighting_uAmbientLight.color"]=e?o(e):[0,0,0],n.forEach((t,e)=>{i["lighting_uPointLight[".concat(e,"].color")]=o(t),i["lighting_uPointLight[".concat(e,"].position")]=t.position,i["lighting_uPointLight[".concat(e,"].attenuation")]=t.attenuation||[1,0,0]}),i.lighting_uPointLightCount=n.length,r.forEach((t,e)=>{i["lighting_uDirectionalLight[".concat(e,"].color")]=o(t),i["lighting_uDirectionalLight[".concat(e,"].direction")]=t.direction}),i.lighting_uDirectionalLightCount=r.length,i}const s={name:"lights",vs:r,fs:r,getUniforms:function t(){let e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:i;if("lightSources"in e){const{ambientLight:t,pointLights:n,directionalLights:r}=e.lightSources||{};return t||n&&n.length>0||r&&r.length>0?Object.assign({},a({ambientLight:t,pointLights:n,directionalLights:r}),{lighting_uEnabled:!0}):{lighting_uEnabled:!1}}if("lights"in e){const n={pointLights:[],directionalLights:[]};for(const t of e.lights||[])switch(t.type){case"ambient":n.ambientLight=t;break;case"directional":n.directionalLights.push(t);break;case"point":n.pointLights.push(t)}return t({lightSources:n})}return{}},defines:{MAX_LIGHTS:3}}},function(t,e,n){var r;
+/*! Hammer.JS - v2.0.7 - 2016-04-22
+ * http://hammerjs.github.io/
+ *
+ * Copyright (c) 2016 Jorik Tangelder;
+ * Licensed under the MIT license */!function(i,o,a,s){"use strict";var u,c=["","webkit","Moz","MS","ms","o"],l=o.createElement("div"),h=Math.round,f=Math.abs,p=Date.now;function d(t,e,n){return setTimeout(b(t,n),e)}function A(t,e,n){return!!Array.isArray(t)&&(g(t,n[e],n),!0)}function g(t,e,n){var r;if(t)if(t.forEach)t.forEach(e,n);else if(void 0!==t.length)for(r=0;r<t.length;)e.call(n,t[r],r,t),r++;else for(r in t)t.hasOwnProperty(r)&&e.call(n,t[r],r,t)}function m(t,e,n){var r="DEPRECATED METHOD: "+e+"\n"+n+" AT \n";return function(){var e=new Error("get-stack-trace"),n=e&&e.stack?e.stack.replace(/^[^\(]+?[\n$]/gm,"").replace(/^\s+at\s+/gm,"").replace(/^Object.<anonymous>\s*\(/gm,"{anonymous}()@"):"Unknown Stack Trace",o=i.console&&(i.console.warn||i.console.log);return o&&o.call(i.console,r,n),t.apply(this,arguments)}}u="function"!=typeof Object.assign?function(t){if(null==t)throw new TypeError("Cannot convert undefined or null to object");for(var e=Object(t),n=1;n<arguments.length;n++){var r=arguments[n];if(null!=r)for(var i in r)r.hasOwnProperty(i)&&(e[i]=r[i])}return e}:Object.assign;var y=m((function(t,e,n){for(var r=Object.keys(e),i=0;i<r.length;)(!n||n&&void 0===t[r[i]])&&(t[r[i]]=e[r[i]]),i++;return t}),"extend","Use `assign`."),v=m((function(t,e){return y(t,e,!0)}),"merge","Use `assign`.");function _(t,e,n){var r,i=e.prototype;(r=t.prototype=Object.create(i)).constructor=t,r._super=i,n&&u(r,n)}function b(t,e){return function(){return t.apply(e,arguments)}}function x(t,e){return"function"==typeof t?t.apply(e&&e[0]||void 0,e):t}function w(t,e){return void 0===t?e:t}function E(t,e,n){g(C(e),(function(e){t.addEventListener(e,n,!1)}))}function O(t,e,n){g(C(e),(function(e){t.removeEventListener(e,n,!1)}))}function S(t,e){for(;t;){if(t==e)return!0;t=t.parentNode}return!1}function T(t,e){return t.indexOf(e)>-1}function C(t){return t.trim().split(/\s+/g)}function P(t,e,n){if(t.indexOf&&!n)return t.indexOf(e);for(var r=0;r<t.length;){if(n&&t[r][n]==e||!n&&t[r]===e)return r;r++}return-1}function M(t){return Array.prototype.slice.call(t,0)}function I(t,e,n){for(var r=[],i=[],o=0;o<t.length;){var a=e?t[o][e]:t[o];P(i,a)<0&&r.push(t[o]),i[o]=a,o++}return n&&(r=e?r.sort((function(t,n){return t[e]>n[e]})):r.sort()),r}function B(t,e){for(var n,r,i=e[0].toUpperCase()+e.slice(1),o=0;o<c.length;){if((r=(n=c[o])?n+i:e)in t)return r;o++}}var R=1;function k(t){var e=t.ownerDocument||t;return e.defaultView||e.parentWindow||i}var D="ontouchstart"in i,L=void 0!==B(i,"PointerEvent"),j=D&&/mobile|tablet|ip(ad|hone|od)|android/i.test(navigator.userAgent),F=["x","y"],z=["clientX","clientY"];function U(t,e){var n=this;this.manager=t,this.callback=e,this.element=t.element,this.target=t.options.inputTarget,this.domHandler=function(e){x(t.options.enable,[t])&&n.handler(e)},this.init()}function N(t,e,n){var r=n.pointers.length,i=n.changedPointers.length,o=1&e&&r-i==0,a=12&e&&r-i==0;n.isFirst=!!o,n.isFinal=!!a,o&&(t.session={}),n.eventType=e,function(t,e){var n=t.session,r=e.pointers,i=r.length;n.firstInput||(n.firstInput=G(e));i>1&&!n.firstMultiple?n.firstMultiple=G(e):1===i&&(n.firstMultiple=!1);var o=n.firstInput,a=n.firstMultiple,s=a?a.center:o.center,u=e.center=V(r);e.timeStamp=p(),e.deltaTime=e.timeStamp-o.timeStamp,e.angle=X(s,u),e.distance=q(s,u),function(t,e){var n=e.center,r=t.offsetDelta||{},i=t.prevDelta||{},o=t.prevInput||{};1!==e.eventType&&4!==o.eventType||(i=t.prevDelta={x:o.deltaX||0,y:o.deltaY||0},r=t.offsetDelta={x:n.x,y:n.y});e.deltaX=i.x+(n.x-r.x),e.deltaY=i.y+(n.y-r.y)}(n,e),e.offsetDirection=W(e.deltaX,e.deltaY);var c=H(e.deltaTime,e.deltaX,e.deltaY);e.overallVelocityX=c.x,e.overallVelocityY=c.y,e.overallVelocity=f(c.x)>f(c.y)?c.x:c.y,e.scale=a?(l=a.pointers,h=r,q(h[0],h[1],z)/q(l[0],l[1],z)):1,e.rotation=a?function(t,e){return X(e[1],e[0],z)+X(t[1],t[0],z)}(a.pointers,r):0,e.maxPointers=n.prevInput?e.pointers.length>n.prevInput.maxPointers?e.pointers.length:n.prevInput.maxPointers:e.pointers.length,function(t,e){var n,r,i,o,a=t.lastInterval||e,s=e.timeStamp-a.timeStamp;if(8!=e.eventType&&(s>25||void 0===a.velocity)){var u=e.deltaX-a.deltaX,c=e.deltaY-a.deltaY,l=H(s,u,c);r=l.x,i=l.y,n=f(l.x)>f(l.y)?l.x:l.y,o=W(u,c),t.lastInterval=e}else n=a.velocity,r=a.velocityX,i=a.velocityY,o=a.direction;e.velocity=n,e.velocityX=r,e.velocityY=i,e.direction=o}(n,e);var l,h;var d=t.element;S(e.srcEvent.target,d)&&(d=e.srcEvent.target);e.target=d}(t,n),t.emit("hammer.input",n),t.recognize(n),t.session.prevInput=n}function G(t){for(var e=[],n=0;n<t.pointers.length;)e[n]={clientX:h(t.pointers[n].clientX),clientY:h(t.pointers[n].clientY)},n++;return{timeStamp:p(),pointers:e,center:V(e),deltaX:t.deltaX,deltaY:t.deltaY}}function V(t){var e=t.length;if(1===e)return{x:h(t[0].clientX),y:h(t[0].clientY)};for(var n=0,r=0,i=0;i<e;)n+=t[i].clientX,r+=t[i].clientY,i++;return{x:h(n/e),y:h(r/e)}}function H(t,e,n){return{x:e/t||0,y:n/t||0}}function W(t,e){return t===e?1:f(t)>=f(e)?t<0?2:4:e<0?8:16}function q(t,e,n){n||(n=F);var r=e[n[0]]-t[n[0]],i=e[n[1]]-t[n[1]];return Math.sqrt(r*r+i*i)}function X(t,e,n){n||(n=F);var r=e[n[0]]-t[n[0]],i=e[n[1]]-t[n[1]];return 180*Math.atan2(i,r)/Math.PI}U.prototype={handler:function(){},init:function(){this.evEl&&E(this.element,this.evEl,this.domHandler),this.evTarget&&E(this.target,this.evTarget,this.domHandler),this.evWin&&E(k(this.element),this.evWin,this.domHandler)},destroy:function(){this.evEl&&O(this.element,this.evEl,this.domHandler),this.evTarget&&O(this.target,this.evTarget,this.domHandler),this.evWin&&O(k(this.element),this.evWin,this.domHandler)}};var Z={mousedown:1,mousemove:2,mouseup:4};function J(){this.evEl="mousedown",this.evWin="mousemove mouseup",this.pressed=!1,U.apply(this,arguments)}_(J,U,{handler:function(t){var e=Z[t.type];1&e&&0===t.button&&(this.pressed=!0),2&e&&1!==t.which&&(e=4),this.pressed&&(4&e&&(this.pressed=!1),this.callback(this.manager,e,{pointers:[t],changedPointers:[t],pointerType:"mouse",srcEvent:t}))}});var Q={pointerdown:1,pointermove:2,pointerup:4,pointercancel:8,pointerout:8},K={2:"touch",3:"pen",4:"mouse",5:"kinect"},Y="pointerdown",$="pointermove pointerup pointercancel";function tt(){this.evEl=Y,this.evWin=$,U.apply(this,arguments),this.store=this.manager.session.pointerEvents=[]}i.MSPointerEvent&&!i.PointerEvent&&(Y="MSPointerDown",$="MSPointerMove MSPointerUp MSPointerCancel"),_(tt,U,{handler:function(t){var e=this.store,n=!1,r=t.type.toLowerCase().replace("ms",""),i=Q[r],o=K[t.pointerType]||t.pointerType,a="touch"==o,s=P(e,t.pointerId,"pointerId");1&i&&(0===t.button||a)?s<0&&(e.push(t),s=e.length-1):12&i&&(n=!0),s<0||(e[s]=t,this.callback(this.manager,i,{pointers:e,changedPointers:[t],pointerType:o,srcEvent:t}),n&&e.splice(s,1))}});var et={touchstart:1,touchmove:2,touchend:4,touchcancel:8};function nt(){this.evTarget="touchstart",this.evWin="touchstart touchmove touchend touchcancel",this.started=!1,U.apply(this,arguments)}function rt(t,e){var n=M(t.touches),r=M(t.changedTouches);return 12&e&&(n=I(n.concat(r),"identifier",!0)),[n,r]}_(nt,U,{handler:function(t){var e=et[t.type];if(1===e&&(this.started=!0),this.started){var n=rt.call(this,t,e);12&e&&n[0].length-n[1].length==0&&(this.started=!1),this.callback(this.manager,e,{pointers:n[0],changedPointers:n[1],pointerType:"touch",srcEvent:t})}}});var it={touchstart:1,touchmove:2,touchend:4,touchcancel:8};function ot(){this.evTarget="touchstart touchmove touchend touchcancel",this.targetIds={},U.apply(this,arguments)}function at(t,e){var n=M(t.touches),r=this.targetIds;if(3&e&&1===n.length)return r[n[0].identifier]=!0,[n,n];var i,o,a=M(t.changedTouches),s=[],u=this.target;if(o=n.filter((function(t){return S(t.target,u)})),1===e)for(i=0;i<o.length;)r[o[i].identifier]=!0,i++;for(i=0;i<a.length;)r[a[i].identifier]&&s.push(a[i]),12&e&&delete r[a[i].identifier],i++;return s.length?[I(o.concat(s),"identifier",!0),s]:void 0}_(ot,U,{handler:function(t){var e=it[t.type],n=at.call(this,t,e);n&&this.callback(this.manager,e,{pointers:n[0],changedPointers:n[1],pointerType:"touch",srcEvent:t})}});function st(){U.apply(this,arguments);var t=b(this.handler,this);this.touch=new ot(this.manager,t),this.mouse=new J(this.manager,t),this.primaryTouch=null,this.lastTouches=[]}function ut(t,e){1&t?(this.primaryTouch=e.changedPointers[0].identifier,ct.call(this,e)):12&t&&ct.call(this,e)}function ct(t){var e=t.changedPointers[0];if(e.identifier===this.primaryTouch){var n={x:e.clientX,y:e.clientY};this.lastTouches.push(n);var r=this.lastTouches;setTimeout((function(){var t=r.indexOf(n);t>-1&&r.splice(t,1)}),2500)}}function lt(t){for(var e=t.srcEvent.clientX,n=t.srcEvent.clientY,r=0;r<this.lastTouches.length;r++){var i=this.lastTouches[r],o=Math.abs(e-i.x),a=Math.abs(n-i.y);if(o<=25&&a<=25)return!0}return!1}_(st,U,{handler:function(t,e,n){var r="touch"==n.pointerType,i="mouse"==n.pointerType;if(!(i&&n.sourceCapabilities&&n.sourceCapabilities.firesTouchEvents)){if(r)ut.call(this,e,n);else if(i&&lt.call(this,n))return;this.callback(t,e,n)}},destroy:function(){this.touch.destroy(),this.mouse.destroy()}});var ht=B(l.style,"touchAction"),ft=void 0!==ht,pt=function(){if(!ft)return!1;var t={},e=i.CSS&&i.CSS.supports;return["auto","manipulation","pan-y","pan-x","pan-x pan-y","none"].forEach((function(n){t[n]=!e||i.CSS.supports("touch-action",n)})),t}();function dt(t,e){this.manager=t,this.set(e)}dt.prototype={set:function(t){"compute"==t&&(t=this.compute()),ft&&this.manager.element.style&&pt[t]&&(this.manager.element.style[ht]=t),this.actions=t.toLowerCase().trim()},update:function(){this.set(this.manager.options.touchAction)},compute:function(){var t=[];return g(this.manager.recognizers,(function(e){x(e.options.enable,[e])&&(t=t.concat(e.getTouchAction()))})),function(t){if(T(t,"none"))return"none";var e=T(t,"pan-x"),n=T(t,"pan-y");if(e&&n)return"none";if(e||n)return e?"pan-x":"pan-y";if(T(t,"manipulation"))return"manipulation";return"auto"}(t.join(" "))},preventDefaults:function(t){var e=t.srcEvent,n=t.offsetDirection;if(this.manager.session.prevented)e.preventDefault();else{var r=this.actions,i=T(r,"none")&&!pt.none,o=T(r,"pan-y")&&!pt["pan-y"],a=T(r,"pan-x")&&!pt["pan-x"];if(i){var s=1===t.pointers.length,u=t.distance<2,c=t.deltaTime<250;if(s&&u&&c)return}if(!a||!o)return i||o&&6&n||a&&24&n?this.preventSrc(e):void 0}},preventSrc:function(t){this.manager.session.prevented=!0,t.preventDefault()}};function At(t){this.options=u({},this.defaults,t||{}),this.id=R++,this.manager=null,this.options.enable=w(this.options.enable,!0),this.state=1,this.simultaneous={},this.requireFail=[]}function gt(t){return 16&t?"cancel":8&t?"end":4&t?"move":2&t?"start":""}function mt(t){return 16==t?"down":8==t?"up":2==t?"left":4==t?"right":""}function yt(t,e){var n=e.manager;return n?n.get(t):t}function vt(){At.apply(this,arguments)}function _t(){vt.apply(this,arguments),this.pX=null,this.pY=null}function bt(){vt.apply(this,arguments)}function xt(){At.apply(this,arguments),this._timer=null,this._input=null}function wt(){vt.apply(this,arguments)}function Et(){vt.apply(this,arguments)}function Ot(){At.apply(this,arguments),this.pTime=!1,this.pCenter=!1,this._timer=null,this._input=null,this.count=0}function St(t,e){return(e=e||{}).recognizers=w(e.recognizers,St.defaults.preset),new Tt(t,e)}At.prototype={defaults:{},set:function(t){return u(this.options,t),this.manager&&this.manager.touchAction.update(),this},recognizeWith:function(t){if(A(t,"recognizeWith",this))return this;var e=this.simultaneous;return e[(t=yt(t,this)).id]||(e[t.id]=t,t.recognizeWith(this)),this},dropRecognizeWith:function(t){return A(t,"dropRecognizeWith",this)||(t=yt(t,this),delete this.simultaneous[t.id]),this},requireFailure:function(t){if(A(t,"requireFailure",this))return this;var e=this.requireFail;return-1===P(e,t=yt(t,this))&&(e.push(t),t.requireFailure(this)),this},dropRequireFailure:function(t){if(A(t,"dropRequireFailure",this))return this;t=yt(t,this);var e=P(this.requireFail,t);return e>-1&&this.requireFail.splice(e,1),this},hasRequireFailures:function(){return this.requireFail.length>0},canRecognizeWith:function(t){return!!this.simultaneous[t.id]},emit:function(t){var e=this,n=this.state;function r(n){e.manager.emit(n,t)}n<8&&r(e.options.event+gt(n)),r(e.options.event),t.additionalEvent&&r(t.additionalEvent),n>=8&&r(e.options.event+gt(n))},tryEmit:function(t){if(this.canEmit())return this.emit(t);this.state=32},canEmit:function(){for(var t=0;t<this.requireFail.length;){if(!(33&this.requireFail[t].state))return!1;t++}return!0},recognize:function(t){var e=u({},t);if(!x(this.options.enable,[this,e]))return this.reset(),void(this.state=32);56&this.state&&(this.state=1),this.state=this.process(e),30&this.state&&this.tryEmit(e)},process:function(t){},getTouchAction:function(){},reset:function(){}},_(vt,At,{defaults:{pointers:1},attrTest:function(t){var e=this.options.pointers;return 0===e||t.pointers.length===e},process:function(t){var e=this.state,n=t.eventType,r=6&e,i=this.attrTest(t);return r&&(8&n||!i)?16|e:r||i?4&n?8|e:2&e?4|e:2:32}}),_(_t,vt,{defaults:{event:"pan",threshold:10,pointers:1,direction:30},getTouchAction:function(){var t=this.options.direction,e=[];return 6&t&&e.push("pan-y"),24&t&&e.push("pan-x"),e},directionTest:function(t){var e=this.options,n=!0,r=t.distance,i=t.direction,o=t.deltaX,a=t.deltaY;return i&e.direction||(6&e.direction?(i=0===o?1:o<0?2:4,n=o!=this.pX,r=Math.abs(t.deltaX)):(i=0===a?1:a<0?8:16,n=a!=this.pY,r=Math.abs(t.deltaY))),t.direction=i,n&&r>e.threshold&&i&e.direction},attrTest:function(t){return vt.prototype.attrTest.call(this,t)&&(2&this.state||!(2&this.state)&&this.directionTest(t))},emit:function(t){this.pX=t.deltaX,this.pY=t.deltaY;var e=mt(t.direction);e&&(t.additionalEvent=this.options.event+e),this._super.emit.call(this,t)}}),_(bt,vt,{defaults:{event:"pinch",threshold:0,pointers:2},getTouchAction:function(){return["none"]},attrTest:function(t){return this._super.attrTest.call(this,t)&&(Math.abs(t.scale-1)>this.options.threshold||2&this.state)},emit:function(t){if(1!==t.scale){var e=t.scale<1?"in":"out";t.additionalEvent=this.options.event+e}this._super.emit.call(this,t)}}),_(xt,At,{defaults:{event:"press",pointers:1,time:251,threshold:9},getTouchAction:function(){return["auto"]},process:function(t){var e=this.options,n=t.pointers.length===e.pointers,r=t.distance<e.threshold,i=t.deltaTime>e.time;if(this._input=t,!r||!n||12&t.eventType&&!i)this.reset();else if(1&t.eventType)this.reset(),this._timer=d((function(){this.state=8,this.tryEmit()}),e.time,this);else if(4&t.eventType)return 8;return 32},reset:function(){clearTimeout(this._timer)},emit:function(t){8===this.state&&(t&&4&t.eventType?this.manager.emit(this.options.event+"up",t):(this._input.timeStamp=p(),this.manager.emit(this.options.event,this._input)))}}),_(wt,vt,{defaults:{event:"rotate",threshold:0,pointers:2},getTouchAction:function(){return["none"]},attrTest:function(t){return this._super.attrTest.call(this,t)&&(Math.abs(t.rotation)>this.options.threshold||2&this.state)}}),_(Et,vt,{defaults:{event:"swipe",threshold:10,velocity:.3,direction:30,pointers:1},getTouchAction:function(){return _t.prototype.getTouchAction.call(this)},attrTest:function(t){var e,n=this.options.direction;return 30&n?e=t.overallVelocity:6&n?e=t.overallVelocityX:24&n&&(e=t.overallVelocityY),this._super.attrTest.call(this,t)&&n&t.offsetDirection&&t.distance>this.options.threshold&&t.maxPointers==this.options.pointers&&f(e)>this.options.velocity&&4&t.eventType},emit:function(t){var e=mt(t.offsetDirection);e&&this.manager.emit(this.options.event+e,t),this.manager.emit(this.options.event,t)}}),_(Ot,At,{defaults:{event:"tap",pointers:1,taps:1,interval:300,time:250,threshold:9,posThreshold:10},getTouchAction:function(){return["manipulation"]},process:function(t){var e=this.options,n=t.pointers.length===e.pointers,r=t.distance<e.threshold,i=t.deltaTime<e.time;if(this.reset(),1&t.eventType&&0===this.count)return this.failTimeout();if(r&&i&&n){if(4!=t.eventType)return this.failTimeout();var o=!this.pTime||t.timeStamp-this.pTime<e.interval,a=!this.pCenter||q(this.pCenter,t.center)<e.posThreshold;if(this.pTime=t.timeStamp,this.pCenter=t.center,a&&o?this.count+=1:this.count=1,this._input=t,0===this.count%e.taps)return this.hasRequireFailures()?(this._timer=d((function(){this.state=8,this.tryEmit()}),e.interval,this),2):8}return 32},failTimeout:function(){return this._timer=d((function(){this.state=32}),this.options.interval,this),32},reset:function(){clearTimeout(this._timer)},emit:function(){8==this.state&&(this._input.tapCount=this.count,this.manager.emit(this.options.event,this._input))}}),St.VERSION="2.0.7",St.defaults={domEvents:!1,touchAction:"compute",enable:!0,inputTarget:null,inputClass:null,preset:[[wt,{enable:!1}],[bt,{enable:!1},["rotate"]],[Et,{direction:6}],[_t,{direction:6},["swipe"]],[Ot],[Ot,{event:"doubletap",taps:2},["tap"]],[xt]],cssProps:{userSelect:"none",touchSelect:"none",touchCallout:"none",contentZooming:"none",userDrag:"none",tapHighlightColor:"rgba(0,0,0,0)"}};function Tt(t,e){var n;this.options=u({},St.defaults,e||{}),this.options.inputTarget=this.options.inputTarget||t,this.handlers={},this.session={},this.recognizers=[],this.oldCssProps={},this.element=t,this.input=new((n=this).options.inputClass||(L?tt:j?ot:D?st:J))(n,N),this.touchAction=new dt(this,this.options.touchAction),Ct(this,!0),g(this.options.recognizers,(function(t){var e=this.add(new t[0](t[1]));t[2]&&e.recognizeWith(t[2]),t[3]&&e.requireFailure(t[3])}),this)}function Ct(t,e){var n,r=t.element;r.style&&(g(t.options.cssProps,(function(i,o){n=B(r.style,o),e?(t.oldCssProps[n]=r.style[n],r.style[n]=i):r.style[n]=t.oldCssProps[n]||""})),e||(t.oldCssProps={}))}Tt.prototype={set:function(t){return u(this.options,t),t.touchAction&&this.touchAction.update(),t.inputTarget&&(this.input.destroy(),this.input.target=t.inputTarget,this.input.init()),this},stop:function(t){this.session.stopped=t?2:1},recognize:function(t){var e=this.session;if(!e.stopped){var n;this.touchAction.preventDefaults(t);var r=this.recognizers,i=e.curRecognizer;(!i||i&&8&i.state)&&(i=e.curRecognizer=null);for(var o=0;o<r.length;)n=r[o],2===e.stopped||i&&n!=i&&!n.canRecognizeWith(i)?n.reset():n.recognize(t),!i&&14&n.state&&(i=e.curRecognizer=n),o++}},get:function(t){if(t instanceof At)return t;for(var e=this.recognizers,n=0;n<e.length;n++)if(e[n].options.event==t)return e[n];return null},add:function(t){if(A(t,"add",this))return this;var e=this.get(t.options.event);return e&&this.remove(e),this.recognizers.push(t),t.manager=this,this.touchAction.update(),t},remove:function(t){if(A(t,"remove",this))return this;if(t=this.get(t)){var e=this.recognizers,n=P(e,t);-1!==n&&(e.splice(n,1),this.touchAction.update())}return this},on:function(t,e){if(void 0!==t&&void 0!==e){var n=this.handlers;return g(C(t),(function(t){n[t]=n[t]||[],n[t].push(e)})),this}},off:function(t,e){if(void 0!==t){var n=this.handlers;return g(C(t),(function(t){e?n[t]&&n[t].splice(P(n[t],e),1):delete n[t]})),this}},emit:function(t,e){this.options.domEvents&&function(t,e){var n=o.createEvent("Event");n.initEvent(t,!0,!0),n.gesture=e,e.target.dispatchEvent(n)}(t,e);var n=this.handlers[t]&&this.handlers[t].slice();if(n&&n.length){e.type=t,e.preventDefault=function(){e.srcEvent.preventDefault()};for(var r=0;r<n.length;)n[r](e),r++}},destroy:function(){this.element&&Ct(this,!1),this.handlers={},this.session={},this.input.destroy(),this.element=null}},u(St,{INPUT_START:1,INPUT_MOVE:2,INPUT_END:4,INPUT_CANCEL:8,STATE_POSSIBLE:1,STATE_BEGAN:2,STATE_CHANGED:4,STATE_ENDED:8,STATE_RECOGNIZED:8,STATE_CANCELLED:16,STATE_FAILED:32,DIRECTION_NONE:1,DIRECTION_LEFT:2,DIRECTION_RIGHT:4,DIRECTION_UP:8,DIRECTION_DOWN:16,DIRECTION_HORIZONTAL:6,DIRECTION_VERTICAL:24,DIRECTION_ALL:30,Manager:Tt,Input:U,TouchAction:dt,TouchInput:ot,MouseInput:J,PointerEventInput:tt,TouchMouseInput:st,SingleTouchInput:nt,Recognizer:At,AttrRecognizer:vt,Tap:Ot,Pan:_t,Swipe:Et,Pinch:bt,Rotate:wt,Press:xt,on:E,off:O,each:g,merge:v,extend:y,assign:u,inherit:_,bindFn:b,prefixed:B}),(void 0!==i?i:"undefined"!=typeof self?self:{}).Hammer=St,void 0===(r=function(){return St}.call(e,n,e,t))||(t.exports=r)}(window,document)},,function(t,e){},function(t,e,n){"use strict";n.d(e,"b",(function(){return i})),n.d(e,"a",(function(){return o}));var r=n(106);function i(t,e){return Object(r.a)(t>=0),Object(r.a)(e>0),t+(e-1)&~(e-1)}function o(t,e,n){let r;if(t instanceof ArrayBuffer)r=new Uint8Array(t);else{const e=t.byteOffset,n=t.byteLength;r=new Uint8Array(t.buffer||t.arrayBuffer,e,n)}return e.set(r,n),n+i(r.byteLength,4)}},function(t,e,n){"use strict";n.r(e);var r=n(233);n.d(e,"SimpleMeshLayer",(function(){return r.a}));var i=n(228);n.d(e,"ScenegraphLayer",(function(){return i.a}))},function(t,e,n){"use strict";n.d(e,"a",(function(){return c}));var r=n(3),i=n.n(r),o=n(0),a=n.n(o),s=[255,255,255],u=0,c=function t(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};i()(this,t),a()(this,"type","ambient");var n=e.color,r=void 0===n?s:n,o=e.intensity,c=void 0===o?1:o;this.id=e.id||"ambient-".concat(u++),this.color=r,this.intensity=c}},function(t,e,n){"use strict";n.d(e,"a",(function(){return v}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(5),u=n.n(s),c=n(6),l=n.n(c),h=n(1),f=n.n(h),p=n(0),d=n.n(p),A=n(59),g=n(86),m=n(113);function y(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=f()(t);if(e){var i=f()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return l()(this,n)}}var v=function(t){u()(n,t);var e=y(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"ViewportType",get:function(){return g.a}},{key:"ControllerType",get:function(){return m.b}}]),n}(A.a);d()(v,"displayName","MapView")},function(t,e,n){"use strict";n.d(e,"a",(function(){return p})),n.d(e,"b",(function(){return g}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(0),u=n.n(s),c=n(75);function l(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function h(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?l(Object(n),!0).forEach((function(e){u()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):l(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var f=function(){},p={BREAK:1,SNAP_TO_END:2,IGNORE:3},d=function(t){return t},A=p.BREAK,g=function(){function t(e){var n=this;i()(this,t),u()(this,"_onTransitionUpdate",(function(t){var e=t.time,r=t.settings,i=r.interpolator,o=r.startProps,a=r.endProps,s=r.duration,u=(0,r.easing)(e/s),c=i.interpolateProps(o,a,u);n.propsInTransition=n.getControllerState(h(h({},n.props),c)).getViewportProps(),n.onViewStateChange({viewState:n.propsInTransition,oldViewState:n.props})})),this.getControllerState=e.getControllerState,this.propsInTransition=null,this.transition=new c.a(e.timeline),this.onViewStateChange=e.onViewStateChange||f,this.onStateChange=e.onStateChange||f}return a()(t,[{key:"finalize",value:function(){this.transition.cancel()}},{key:"getViewportInTransition",value:function(){return this.propsInTransition}},{key:"processViewStateChange",value:function(t){var e=!1,n=this.props;if(this.props=t,!n||this._shouldIgnoreViewportChange(n,t))return!1;if(this._isTransitionEnabled(t)){var r=n;if(this.transition.inProgress){var i=this.transition.settings,o=i.interruption,a=i.endProps;r=h(h({},n),o===p.SNAP_TO_END?a:this.propsInTransition||n)}this._triggerTransition(r,t),e=!0}else this.transition.cancel();return e}},{key:"updateTransition",value:function(){this.transition.update()}},{key:"_isTransitionEnabled",value:function(t){var e=t.transitionDuration,n=t.transitionInterpolator;return(e>0||"auto"===e)&&Boolean(n)}},{key:"_isUpdateDueToCurrentTransition",value:function(t){return!(!this.transition.inProgress||!this.propsInTransition)&&this.transition.settings.interpolator.arePropsEqual(t,this.propsInTransition)}},{key:"_shouldIgnoreViewportChange",value:function(t,e){return this.transition.inProgress?this.transition.settings.interruption===p.IGNORE||this._isUpdateDueToCurrentTransition(e):!this._isTransitionEnabled(e)||e.transitionInterpolator.arePropsEqual(t,e)}},{key:"_triggerTransition",value:function(t,e){var n=this.getControllerState(t),r=this.getControllerState(e).shortestPathFrom(n),i=e.transitionInterpolator,o=i.getDuration?i.getDuration(t,e):e.transitionDuration;if(0!==o){var a=i.initializeProps(t,r);this.propsInTransition={};var s={duration:o,easing:e.transitionEasing||d,interpolator:i,interruption:e.transitionInterruption||A,startProps:a.start,endProps:a.end,onStart:e.onTransitionStart,onUpdate:this._onTransitionUpdate,onInterrupt:this._onTransitionEnd(e.onTransitionInterrupt),onEnd:this._onTransitionEnd(e.onTransitionEnd)};this.transition.start(s),this.onStateChange({inTransition:!0}),this.updateTransition()}}},{key:"_onTransitionEnd",value:function(t){var e=this;return function(n){e.propsInTransition=null,e.onStateChange({inTransition:!1,isZooming:!1,isPanning:!1,isRotating:!1}),null==t||t(n)}}}]),t}()},function(t,e,n){"use strict";n.d(e,"a",(function(){return r}));const r="3.2.10"},function(t,e,n){"use strict";n.d(e,"b",(function(){return i})),n.d(e,"a",(function(){return o}));var r=n(85);async function i(t,e){for(;;){const{done:n,value:r}=await t.next();if(n)return void t.return();if(e(r))return}}async function o(t){const e=[];for await(const n of t)e.push(n);return Object(r.b)(...e)}},function(t,e,n){"use strict";n.d(e,"a",(function(){return u}));var r=n(204);function i(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return o(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return o(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var a,s=!0,u=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return s=t.done,t},e:function(t){u=!0,a=t},f:function(){try{s||null==n.return||n.return()}finally{if(u)throw a}}}}function o(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var a=[n(104).a],s=["vs:DECKGL_FILTER_SIZE(inout vec3 size, VertexGeometry geometry)","vs:DECKGL_FILTER_GL_POSITION(inout vec4 position, VertexGeometry geometry)","vs:DECKGL_FILTER_COLOR(inout vec4 color, VertexGeometry geometry)","fs:DECKGL_FILTER_COLOR(inout vec4 color, FragmentGeometry geometry)"];function u(t){var e,n=r.a.getDefaultProgramManager(t),o=i(a);try{for(o.s();!(e=o.n()).done;){var u=e.value;n.addDefaultModule(u)}}catch(t){o.e(t)}finally{o.f()}var c,l=i(s);try{for(l.s();!(c=l.n()).done;){var h=c.value;n.addShaderHook(h)}}catch(t){l.e(t)}finally{l.f()}return n}},function(t,e,n){"use strict";n.d(e,"a",(function(){return v}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(5),u=n.n(s),c=n(6),l=n.n(c),h=n(1),f=n.n(h),p=n(0),d=n.n(p),A=n(59),g=n(159),m=n(160);function y(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=f()(t);if(e){var i=f()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return l()(this,n)}}var v=function(t){u()(n,t);var e=y(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"ViewportType",get:function(){return g.a}},{key:"ControllerType",get:function(){return m.a}}]),n}(A.a);d()(v,"displayName","OrthographicView")},function(t,e,n){"use strict";n.d(e,"a",(function(){return T}));var r=n(9),i=n.n(r),o=n(0),a=n.n(o),s=n(3),u=n.n(s),c=n(4),l=n.n(c),h=n(5),f=n.n(h),p=n(6),d=n.n(p),A=n(1),g=n.n(A),m=n(42),y=n(78),v=n(13),_=n(19),b=n(92);function x(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function w(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?x(Object(n),!0).forEach((function(e){a()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):x(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function E(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=g()(t);if(e){var i=g()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return d()(this,n)}}var O=(new y.a).lookAt({eye:[0,0,1]});function S(t){var e=t.width,n=t.height,r=t.near,i=t.far,o=t.padding,a=-e/2,s=e/2,u=-n/2,c=n/2;if(o){var l=o.left,h=void 0===l?0:l,f=o.right,p=void 0===f?0:f,d=o.top,A=void 0===d?0:d,g=o.bottom,m=void 0===g?0:g,_=Object(v.a)((h+e-p)/2,0,e)-e/2,b=Object(v.a)((A+n-m)/2,0,n)-n/2;a-=_,s-=_,u+=b,c+=b}return(new y.a).ortho({left:a,right:s,bottom:u,top:c,near:r,far:i})}var T=function(t){f()(n,t);var e=E(n);function n(t){u()(this,n);var r,i=t.width,o=t.height,a=t.near,s=void 0===a?.1:a,c=t.far,l=void 0===c?1e3:c,h=t.zoom,f=void 0===h?0:h,p=t.target,d=void 0===p?[0,0,0]:p,A=t.padding,g=void 0===A?null:A,m=t.flipY,y=void 0===m||m,v=Array.isArray(f)?f[0]:f,_=Array.isArray(f)?f[1]:f,b=Math.min(v,_),x=Math.pow(2,b);if(v!==_){var E=Math.pow(2,v),T=Math.pow(2,_);r={unitsPerMeter:[E/x,T/x,1],metersPerUnit:[x/E,x/T,1]}}return e.call(this,w(w({},t),{},{longitude:void 0,position:d,viewMatrix:O.clone().scale([x,x*(y?-1:1),x]),projectionMatrix:S({width:i||1,height:o||1,padding:g,near:s,far:l}),zoom:b,distanceScales:r}))}return l()(n,[{key:"projectFlat",value:function(t){var e=i()(t,2),n=e[0],r=e[1],o=this.distanceScales.unitsPerMeter;return[n*o[0],r*o[1]]}},{key:"unprojectFlat",value:function(t){var e=i()(t,2),n=e[0],r=e[1],o=this.distanceScales.metersPerUnit;return[n*o[0],r*o[1]]}},{key:"panByPosition",value:function(t,e){var n=Object(_.n)(e,this.pixelUnprojectionMatrix),r=this.projectFlat(t),i=b.a([],r,b.b([],n)),o=b.a([],this.center,i);return{target:this.unprojectFlat(o)}}}]),n}(m.a)},function(t,e,n){"use strict";n.d(e,"a",(function(){return O}));var r=n(27),i=n.n(r),o=n(0),a=n.n(o),s=n(9),u=n.n(s),c=n(3),l=n.n(c),h=n(4),f=n.n(h),p=n(5),d=n.n(p),A=n(6),g=n.n(A),m=n(1),y=n.n(m),v=n(13),_=n(58),b=n(115),x=n(50);function w(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=y()(t);if(e){var i=y()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return g()(this,n)}}var E=function(t){d()(n,t);var e=w(n);function n(t){var r;return l()(this,n),(r=e.call(this,t)).zoomAxis=t.zoomAxis||"all",r}return f()(n,[{key:"_calculateNewZoom",value:function(t){var e=t.scale,n=t.startZoom,r=this.getViewportProps(),i=r.maxZoom,o=r.minZoom;void 0===n&&(n=this.getViewportProps().zoom);var a=Math.log2(e);if(Array.isArray(n)){var s=n,c=u()(s,2),l=c[0],h=c[1];switch(this.zoomAxis){case"X":l=Object(v.a)(l+a,o,i);break;case"Y":h=Object(v.a)(h+a,o,i);break;default:var f=Math.min(l+a,h+a);f<o&&(a+=o-f),(f=Math.max(l+a,h+a))>i&&(a+=i-f),l+=a,h+=a}return[l,h]}return Object(v.a)(n+a,o,i)}}]),n}(b.a),O=function(t){d()(n,t);var e=w(n);function n(){var t;l()(this,n);for(var r=arguments.length,o=new Array(r),s=0;s<r;s++)o[s]=arguments[s];return t=e.call.apply(e,[this].concat(o)),a()(i()(t),"ControllerState",E),a()(i()(t),"transition",{transitionDuration:300,transitionInterpolator:new x.a(["target","zoom"])}),a()(i()(t),"dragMode","pan"),t}return f()(n,[{key:"_onPanRotate",value:function(){return!1}}]),n}(_.a)},function(t,e,n){"use strict";n.d(e,"a",(function(){return o}));var r=n(28),i=n.n(r);function o(t){if(null===(e=t)||"object"!==i()(e))throw new Error("count(): argument not an object");var e;if("function"==typeof t.count)return t.count();if(Number.isFinite(t.size))return t.size;if(Number.isFinite(t.length))return t.length;if(function(t){return null!==t&&"object"===i()(t)&&t.constructor===Object}(t))return Object.keys(t).length;throw new Error("count(): argument not a container")}},function(t,e,n){"use strict";n.d(e,"a",(function(){return s}));var r=n(0),i=n.n(r);function o(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function a(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?o(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):o(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function s(t,e){if(!e)return t;var n=a(a({},t),e);if("defines"in e&&(n.defines=a(a({},t.defines),e.defines)),"modules"in e&&(n.modules=(t.modules||[]).concat(e.modules),e.modules.some((function(t){return"project64"===t.name})))){var r=n.modules.findIndex((function(t){return"project32"===t.name}));r>=0&&n.modules.splice(r,1)}if("inject"in e)if(t.inject){var i=a({},t.inject);for(var o in e.inject)i[o]=(i[o]||"")+e.inject[o];n.inject=i}else n.inject=e.inject;return n}},function(t,e,n){"use strict";n.d(e,"a",(function(){return C}));var r=n(9),i=n.n(r),o=n(0),a=n.n(o),s=n(3),u=n.n(s),c=n(4),l=n.n(c),h=n(5),f=n.n(h),p=n(6),d=n.n(p),A=n(1),g=n.n(A),m=n(78),y=n(42),v=n(12),_=n(83),b=n(90);function x(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function w(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?x(Object(n),!0).forEach((function(e){a()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):x(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function E(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=g()(t);if(e){var i=g()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return d()(this,n)}}var O=Math.PI/180,S=180/Math.PI;function T(){var t=Math.PI/180*256;return{unitsPerMeter:[256/6370972,256/6370972,256/6370972],unitsPerMeter2:[0,0,0],metersPerUnit:[24886.609375,24886.609375,24886.609375],unitsPerDegree:[t,t,256/6370972],unitsPerDegree2:[0,0,0],degreesPerUnit:[1/t,1/t,24886.609375]}}var C=function(t){f()(n,t);var e=E(n);function n(){var t,r=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};u()(this,n);var i=r.latitude,o=void 0===i?0:i,a=r.longitude,s=void 0===a?0:a,c=r.zoom,l=void 0===c?0:c,h=r.nearZMultiplier,f=void 0===h?.1:h,p=r.farZMultiplier,d=void 0===p?2:p,A=r.resolution,g=void 0===A?10:A,y=r.height,v=r.altitude,_=void 0===v?1.5:v;y=y||1,_=Math.max(.75,_);var b=(new m.a).lookAt({eye:[0,-_,0],up:[0,0,1]}),x=Math.pow(2,l);b.rotateX(o*O),b.rotateZ(-s*O),b.scale(x/y);var E=Math.atan(.5/_),S=512*x/y;return(t=e.call(this,w(w({},r),{},{height:y,viewMatrix:b,longitude:s,latitude:o,zoom:l,distanceScales:T(),fovyRadians:2*E,focalDistance:_,near:f,far:Math.min(2,1/S+1)*_*d}))).latitude=o,t.longitude=s,t.resolution=g,t}return l()(n,[{key:"projectionMode",get:function(){return v.d.GLOBE}},{key:"getDistanceScales",value:function(){return this.distanceScales}},{key:"getBounds",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},e={targetZ:t.z||0},n=this.unproject([0,this.height/2],e),r=this.unproject([this.width/2,0],e),i=this.unproject([this.width,this.height/2],e),o=this.unproject([this.width/2,this.height],e);return i[0]<this.longitude&&(i[0]+=360),n[0]>this.longitude&&(n[0]-=360),[Math.min(n[0],i[0],r[0],o[0]),Math.min(n[1],i[1],r[1],o[1]),Math.max(n[0],i[0],r[0],o[0]),Math.max(n[1],i[1],r[1],o[1])]}},{key:"unproject",value:function(t){var e,n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},r=n.topLeft,o=void 0===r||r,a=n.targetZ,s=i()(t,3),u=s[0],c=s[1],l=s[2],h=o?c:this.height-c,f=this.pixelUnprojectionMatrix;if(Number.isFinite(l))e=P(f,[u,h,l,1]);else{var p=P(f,[u,h,-1,1]),d=P(f,[u,h,1,1]),A=256*((a||0)/6370972+1),g=_.c(_.d([],p,d)),m=_.c(p),y=_.c(d),v=(4*m*y-Math.pow(g-m-y,2))/16,b=4*v/g,x=Math.sqrt(m-b),w=Math.sqrt(Math.max(0,A*A-b)),E=(x-w)/Math.sqrt(g);e=_.b([],p,d,E)}var O=this.unprojectPosition(e),S=i()(O,3),T=S[0],C=S[1],M=S[2];return Number.isFinite(l)?[T,C,M]:Number.isFinite(a)?[T,C,a]:[T,C]}},{key:"projectPosition",value:function(t){var e=i()(t,3),n=e[0],r=e[1],o=e[2],a=void 0===o?0:o,s=n*O,u=r*O,c=Math.cos(u),l=256*(a/6370972+1);return[Math.sin(s)*c*l,-Math.cos(s)*c*l,Math.sin(u)*l]}},{key:"unprojectPosition",value:function(t){var e=i()(t,3),n=e[0],r=e[1],o=e[2],a=_.a(t),s=Math.asin(o/a);return[Math.atan2(n,-r)*S,s*S,6370972*(a/256-1)]}},{key:"projectFlat",value:function(t){return t}},{key:"unprojectFlat",value:function(t){return t}},{key:"panByPosition",value:function(t,e){var n=this.unproject(e);return{longitude:t[0]-n[0]+this.longitude,latitude:t[1]-n[1]+this.latitude}}}]),n}(y.a);function P(t,e){var n=b.b([],e,t);return b.a(n,n,1/n[3]),n}},function(t,e,n){"use strict";var r=n(9),i=n.n(r),o=n(3),a=n.n(o),s=n(4),u=n.n(s),c=n(27),l=n.n(c),h=n(5),f=n.n(h),p=n(6),d=n.n(p),A=n(1),g=n.n(A),m=n(0),y=n.n(m),v=n(12),_=n(165),b=n(43),x=n(13),w=n(75);function E(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=g()(t);if(e){var i=g()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return d()(this,n)}}var O=function(t){f()(n,t);var e=E(n);function n(){return a()(this,n),e.apply(this,arguments)}return u()(n,[{key:"value",get:function(){return this._value}},{key:"_onUpdate",value:function(){var t=this.time,e=this.settings,n=e.fromValue,r=e.toValue,i=e.duration,o=(0,e.easing)(t/i);this._value=Object(x.g)(n,r,o)}}]),n}(w.a);function S(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=g()(t);if(e){var i=g()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return d()(this,n)}}function T(t,e,n,r,i){var o=e-t;return(n-e)*i+-o*r+o+e}function C(t,e){if(Array.isArray(t)){for(var n=0,r=0;r<t.length;r++){var i=t[r]-e[r];n+=i*i}return Math.sqrt(n)}return Math.abs(t-e)}var P=function(t){f()(n,t);var e=S(n);function n(){return a()(this,n),e.apply(this,arguments)}return u()(n,[{key:"value",get:function(){return this._currValue}},{key:"_onUpdate",value:function(){var t=this.settings,e=t.fromValue,n=t.toValue,r=t.damping,i=t.stiffness,o=this._prevValue,a=void 0===o?e:o,s=this._currValue,u=void 0===s?e:s,c=function(t,e,n,r,i){if(Array.isArray(n)){for(var o=[],a=0;a<n.length;a++)o[a]=T(t[a],e[a],n[a],r,i);return o}return T(t,e,n,r,i)}(a,u,n,r,i),l=C(c,n),h=C(c,u);l<1e-5&&h<1e-5&&(c=n,this.end()),this._prevValue=u,this._currValue=c}}]),n}(w.a),M=n(21);function I(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return B(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return B(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function B(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function R(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function k(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?R(Object(n),!0).forEach((function(e){y()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):R(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var D,L={interpolation:O,spring:P},j=function(){function t(e){a()(this,t),this.transitions=new Map,this.timeline=e}return u()(t,[{key:"active",get:function(){return this.transitions.size>0}},{key:"add",value:function(t,e,n,r){var i=this.transitions;if(i.has(t)){var o=i.get(t),a=o.value;e=void 0===a?o.settings.fromValue:a,this.remove(t)}if(r=Object(b.e)(r)){var s=L[r.type];if(s){var u=new s(this.timeline);u.start(k(k({},r),{},{fromValue:e,toValue:n})),i.set(t,u)}else M.a.error("unsupported transition type '".concat(r.type,"'"))()}}},{key:"remove",value:function(t){var e=this.transitions;e.has(t)&&(e.get(t).cancel(),e.delete(t))}},{key:"update",value:function(){var t,e={},n=I(this.transitions);try{for(n.s();!(t=n.n()).done;){var r=i()(t.value,2),o=r[0],a=r[1];a.update(),e[o]=a.value,a.inProgress||this.remove(o)}}catch(t){n.e(t)}finally{n.f()}return e}},{key:"clear",value:function(){var t,e=I(this.transitions.keys());try{for(e.s();!(t=e.n()).done;){var n=t.value;this.remove(n)}}catch(t){e.e(t)}finally{e.f()}}}]),t}(),F=n(138),z=n(24),U=n(161),N=n(32),G=n(7),V=n(29),H=n(80),W=n(162),q=n(145),X=n(68),Z=n(52),J=n(28),Q=n.n(J),K=n(107);function Y(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function $(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Y(Object(n),!0).forEach((function(e){y()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Y(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var tt=(D={},y()(D,10241,9987),y()(D,10240,9729),y()(D,10242,33071),y()(D,10243,33071),D),et={};var nt=n(61);function rt(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function it(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?rt(Object(n),!0).forEach((function(e){y()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):rt(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var ot={boolean:{validate:function(t,e){return!0},equal:function(t,e,n){return Boolean(t)===Boolean(e)}},number:{validate:function(t,e){return Number.isFinite(t)&&(!("max"in e)||t<=e.max)&&(!("min"in e)||t>=e.min)}},color:{validate:function(t,e){return e.optional&&!t||ct(t)&&(3===t.length||4===t.length)},equal:function(t,e,n){return at(t,e)}},accessor:{validate:function(t,e){var n=lt(t);return"function"===n||n===lt(e.value)},equal:function(t,e,n){return"function"==typeof e||at(t,e)}},array:{validate:function(t,e){return e.optional&&!t||ct(t)},equal:function(t,e,n){return n.compare?at(t,e):t===e}},object:{equal:function(t,e,n){return n.compare?Object(nt.a)(t,e):t===e}},function:{validate:function(t,e){return e.optional&&!t||"function"==typeof t},equal:function(t,e,n){return!n.compare||t===e}},data:{transform:function(t,e,n){var r=n.props.dataTransform;return r&&t?r(t):t}},image:{transform:function(t,e,n){return function(t,e){var n=t.context&&t.context.gl;if(!n||!e)return null;if(e instanceof K.a)return e;e.constructor&&"Object"!==e.constructor.name&&(e={data:e});var r=null;e.compressed&&(r=y()({},10241,e.data.length>1?9985:9729));var i=new K.a(n,$($({},e),{},{parameters:$($($({},tt),r),t.props.textureParameters)}));return et[i.id]=!0,i}(n,t)},release:function(t){var e;(e=t)&&e instanceof K.a&&et[e.id]&&(e.delete(),delete et[e.id])}}};function at(t,e){if(t===e)return!0;if(!ct(t)||!ct(e))return!1;var n=t.length;if(n!==e.length)return!1;for(var r=0;r<n;r++)if(t[r]!==e[r])return!1;return!0}function st(t,e){switch(lt(e)){case"object":return ut(t,e);case"array":return ut(t,{type:"array",value:e,compare:!1});case"boolean":return ut(t,{type:"boolean",value:e});case"number":return ut(t,{type:"number",value:e});case"function":return ut(t,{type:"function",value:e,compare:!0});default:return{name:t,type:"unknown",value:e}}}function ut(t,e){return"type"in e?it(it({name:t},ot[e.type]),e):"value"in e?it({name:t,type:lt(e.value)},e):{name:t,type:"object",value:e}}function ct(t){return Array.isArray(t)||ArrayBuffer.isView(t)}function lt(t){return ct(t)?"array":null===t?"null":Q()(t)}function ht(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return ft(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return ft(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function ft(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function pt(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function dt(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?pt(Object(n),!0).forEach((function(e){y()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):pt(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function At(t,e){var n=gt(t.constructor),r=Object.create(n);r[z.d]=t,r[z.b]={},r[z.c]={};for(var i=0;i<e.length;++i){var o=e[i];for(var a in o)r[a]=o[a]}return Object.freeze(r),r}function gt(t){var e=vt(t,"_mergedDefaultProps");return e||(function(t){if(!t.prototype)return;var e=Object.getPrototypeOf(t),n=gt(e),r=function(t){for(var e={},n={},r={},o=0,a=Object.entries(t);o<a.length;o++){var s=i()(a[o],2),u=s[0],c=s[1],l=null==c?void 0:c.deprecatedFor;if(l)r[u]=Array.isArray(l)?l:[l];else{var h=st(u,c);e[u]=h,n[u]=h.value}}return{propTypes:e,defaultProps:n,deprecatedProps:r}}(vt(t,"defaultProps")||{}),o=function(t,e,n){var r=Object.create(null);Object.assign(r,e,t);var i=function(t){var e=vt(t,"layerName")||vt(t,"componentName");e||M.a.once(0,"".concat(t.name,".componentName not specified"))();return e||t.name}(n);return delete t.id,Object.defineProperties(r,{id:{writable:!0,value:i}}),r}(r.defaultProps,n,t),a=dt(dt({},e._propTypes),r.propTypes);!function(t,e){var n={},r={};for(var i in e){var o=e[i],a=o.name,s=o.value;o.async&&(n[a]=s,r[a]=mt(a))}t[z.a]=n,t[z.b]={},Object.defineProperties(t,r)}(o,a);var s=dt(dt({},e._deprecatedProps),r.deprecatedProps);(function(t,e){var n=function(n){Object.defineProperty(t,n,{enumerable:!1,set:function(t){var r,i="".concat(this.id,": ").concat(n),o=ht(e[n]);try{for(o.s();!(r=o.n()).done;){var a=r.value;yt(this,a)||(this[a]=t)}}catch(t){o.e(t)}finally{o.f()}M.a.deprecated(i,e[n].join("/"))()}})};for(var r in e)n(r)})(o,s),t._mergedDefaultProps=o,t._propTypes=a,t._deprecatedProps=s}(t),t._mergedDefaultProps)}function mt(t){return{enumerable:!0,set:function(e){"string"==typeof e||e instanceof Promise||Object(Z.c)(e)?this[z.b][t]=e:this[z.c][t]=e},get:function(){if(this[z.c]){if(t in this[z.c])return this[z.c][t]||this[z.a][t];if(t in this[z.b]){var e=this[z.d]&&this[z.d].internalState;if(e&&e.hasAsyncProp(t))return e.getAsyncProp(t)||this[z.a][t]}}return this[z.a][t]}}}function yt(t,e){return Object.prototype.hasOwnProperty.call(t,e)}function vt(t,e){return yt(t,e)&&t[e]}function _t(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function bt(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?_t(Object(n),!0).forEach((function(e){y()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):_t(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var xt=0,wt=function(){function t(){a()(this,t);for(var e=arguments.length,n=new Array(e),r=0;r<e;r++)n[r]=arguments[r];this.props=At(this,n),this.id=this.props.id,this.count=xt++}return u()(t,[{key:"clone",value:function(t){var e=this.props,n={};for(var r in e[z.a])r in e[z.c]?n[r]=e[z.c][r]:r in e[z.b]&&(n[r]=e[z.b][r]);return new this.constructor(bt(bt(bt({},e),n),t))}}]),t}();y()(wt,"componentName","Component"),y()(wt,"defaultProps",{});var Et=n(8),Ot=n.n(Et),St=n(69),Tt=n.n(St),Ct=n(241),Pt=n.n(Ct),Mt=n(39),It=n.n(Mt),Bt=Object.freeze({});function Rt(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=g()(t);if(e){var i=g()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return d()(this,n)}}var kt=function(t){f()(n,t);var e=Rt(n);function n(t){var r,i=t.attributeManager,o=t.layer;return a()(this,n),(r=e.call(this,o)).attributeManager=i,r.needsRedraw=!0,r.needsUpdate=!0,r.subLayers=null,r.usesPickingColorCache=!1,r}return u()(n,[{key:"layer",get:function(){return this.component},set:function(t){this.component=t}},{key:"_fetch",value:function(t,e){var r=this.component.props.fetch;return r?r(e,{propName:t,layer:this.layer}):Ot()(g()(n.prototype),"_fetch",this).call(this,t,e)}},{key:"_onResolve",value:function(t,e){var n=this.component.props.onDataLoad;"data"===t&&n&&n(e,{propName:t,layer:this.layer})}},{key:"_onError",value:function(t,e){this.layer.raiseError(e,"loading ".concat(t," of ").concat(this.layer))}}]),n}(function(){function t(e){a()(this,t),this.component=e,this.asyncProps={},this.onAsyncPropUpdated=function(){},this.oldProps=null,this.oldAsyncProps=null}var e;return u()(t,[{key:"finalize",value:function(){for(var t in this.asyncProps){var e=this.asyncProps[t];e&&e.type&&e.type.release&&e.type.release(e.resolvedValue,e.type,this.component)}}},{key:"getOldProps",value:function(){return this.oldAsyncProps||this.oldProps||Bt}},{key:"resetOldProps",value:function(){this.oldAsyncProps=null,this.oldProps=this.component.props}},{key:"hasAsyncProp",value:function(t){return t in this.asyncProps}},{key:"getAsyncProp",value:function(t){var e=this.asyncProps[t];return e&&e.resolvedValue}},{key:"isAsyncPropLoading",value:function(t){if(t){var e=this.asyncProps[t];return Boolean(e&&e.pendingLoadCount>0&&e.pendingLoadCount!==e.resolvedLoadCount)}for(var n in this.asyncProps)if(this.isAsyncPropLoading(n))return!0;return!1}},{key:"reloadAsyncProp",value:function(t,e){this._watchPromise(t,Promise.resolve(e))}},{key:"setAsyncProps",value:function(t){var e=t[z.c]||{},n=t[z.b]||t,r=t[z.a]||{};for(var i in e){var o=e[i];this._createAsyncPropData(i,r[i]),this._updateAsyncProp(i,o),e[i]=this.getAsyncProp(i)}for(var a in n){var s=n[a];this._createAsyncPropData(a,r[a]),this._updateAsyncProp(a,s)}}},{key:"_fetch",value:function(t,e){return null}},{key:"_onResolve",value:function(t,e){}},{key:"_onError",value:function(t,e){}},{key:"_updateAsyncProp",value:function(t,e){this._didAsyncInputValueChange(t,e)&&("string"==typeof e&&(e=this._fetch(t,e)),e instanceof Promise?this._watchPromise(t,e):Object(Z.c)(e)?this._resolveAsyncIterable(t,e):this._setPropValue(t,e))}},{key:"_freezeAsyncOldProps",value:function(){if(!this.oldAsyncProps&&this.oldProps)for(var t in this.oldAsyncProps=Object.create(this.oldProps),this.asyncProps)Object.defineProperty(this.oldAsyncProps,t,{enumerable:!0,value:this.oldProps[t]})}},{key:"_didAsyncInputValueChange",value:function(t,e){var n=this.asyncProps[t];return e!==n.resolvedValue&&e!==n.lastValue&&(n.lastValue=e,!0)}},{key:"_setPropValue",value:function(t,e){this._freezeAsyncOldProps();var n=this.asyncProps[t];n&&(e=this._postProcessValue(n,e),n.resolvedValue=e,n.pendingLoadCount++,n.resolvedLoadCount=n.pendingLoadCount)}},{key:"_setAsyncPropValue",value:function(t,e,n){var r=this.asyncProps[t];r&&n>=r.resolvedLoadCount&&void 0!==e&&(this._freezeAsyncOldProps(),r.resolvedValue=e,r.resolvedLoadCount=n,this.onAsyncPropUpdated(t,e))}},{key:"_watchPromise",value:function(t,e){var n=this,r=this.asyncProps[t];if(r){r.pendingLoadCount++;var i=r.pendingLoadCount;e.then((function(e){e=n._postProcessValue(r,e),n._setAsyncPropValue(t,e,i),n._onResolve(t,e)})).catch((function(e){n._onError(t,e)}))}}},{key:"_resolveAsyncIterable",value:(e=Tt()(It.a.mark((function t(e,n){var r,i,o,a,s,u,c,l,h,f,p;return It.a.wrap((function(t){for(;;)switch(t.prev=t.next){case 0:if("data"===e){t.next=3;break}return this._setPropValue(e,n),t.abrupt("return");case 3:if(r=this.asyncProps[e]){t.next=6;break}return t.abrupt("return");case 6:r.pendingLoadCount++,i=r.pendingLoadCount,o=[],a=0,s=!1,u=!1,t.prev=12,l=Pt()(n);case 14:return t.next=16,l.next();case 16:if(!(s=!(h=t.sent).done)){t.next=26;break}f=h.value,p=this.component.props.dataTransform,o=p?p(f,o):o.concat(f),Object.defineProperty(o,"__diff",{enumerable:!1,value:[{startRow:a,endRow:o.length}]}),a=o.length,this._setAsyncPropValue(e,o,i);case 23:s=!1,t.next=14;break;case 26:t.next=32;break;case 28:t.prev=28,t.t0=t.catch(12),u=!0,c=t.t0;case 32:if(t.prev=32,t.prev=33,!s||null==l.return){t.next=37;break}return t.next=37,l.return();case 37:if(t.prev=37,!u){t.next=40;break}throw c;case 40:return t.finish(37);case 41:return t.finish(32);case 42:this._onResolve(e,o);case 43:case"end":return t.stop()}}),t,this,[[12,28,32,42],[33,,37,41]])}))),function(t,n){return e.apply(this,arguments)})},{key:"_postProcessValue",value:function(t,e){var n=t.type;return n&&(n.release&&n.release(t.resolvedValue,n,this.component),n.transform)?n.transform(e,n,this.component):e}},{key:"_createAsyncPropData",value:function(t,e){if(!this.asyncProps[t]){var n=this.component&&this.component.constructor._propTypes;this.asyncProps[t]={type:n&&n[t],lastValue:null,resolvedValue:e,pendingLoadCount:0,resolvedLoadCount:0}}}}]),t}()),Dt=n(19),Lt=n(215);function jt(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return Ft(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return Ft(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function Ft(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function zt(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=g()(t);if(e){var i=g()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return d()(this,n)}}function Ut(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function Nt(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Ut(Object(n),!0).forEach((function(e){y()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Ut(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}n.d(e,"a",(function(){return Xt}));var Gt=Math.pow(2,24)-1,Vt=Object.freeze([]),Ht=Object(H.a)((function(t){var e=t.oldViewport,n=t.viewport;return e.equals(n)})),Wt=new Uint8ClampedArray(0),qt={data:{type:"data",value:Vt,async:!0},dataComparator:{type:"function",value:null,compare:!1,optional:!0},_dataDiff:{type:"function",value:function(t){return t&&t.__diff},compare:!1,optional:!0},dataTransform:{type:"function",value:null,compare:!1,optional:!0},onDataLoad:{type:"function",value:null,compare:!1,optional:!0},onError:{type:"function",value:null,compare:!1,optional:!0},fetch:{type:"function",value:function(t,e){var n,r=e.propName,i=e.layer,o=e.loaders,a=e.loadOptions,s=e.signal,u=i.context.resourceManager;(a=a||i.getLoadOptions(),o=o||i.props.loaders,s)&&(a=Nt(Nt({},a),{},{fetch:Nt(Nt({},null===(n=a)||void 0===n?void 0:n.fetch),{},{signal:s})}));var c=u.contains(t);return c||a||(u.add({resourceId:t,data:Object(Lt.a)(t,o),persistent:!1}),c=!0),c?u.subscribe({resourceId:t,onChange:function(t){var e;return null===(e=i.internalState)||void 0===e?void 0:e.reloadAsyncProp(r,t)},consumerId:i.id,requestId:r}):Object(Lt.a)(t,o,a)},compare:!1},updateTriggers:{},visible:!0,pickable:!1,opacity:{type:"number",min:0,max:1,value:1},operation:v.c.DRAW,onHover:{type:"function",value:null,compare:!1,optional:!0},onClick:{type:"function",value:null,compare:!1,optional:!0},onDragStart:{type:"function",value:null,compare:!1,optional:!0},onDrag:{type:"function",value:null,compare:!1,optional:!0},onDragEnd:{type:"function",value:null,compare:!1,optional:!0},coordinateSystem:v.a.DEFAULT,coordinateOrigin:{type:"array",value:[0,0,0],compare:!0},modelMatrix:{type:"array",value:null,compare:!0,optional:!0},wrapLongitude:!1,positionFormat:"XYZ",colorFormat:"RGBA",parameters:{type:"object",value:{},optional:!0,compare:!0},transitions:null,extensions:[],loaders:{type:"array",value:[],optional:!0,compare:!0},getPolygonOffset:{type:"function",value:function(t){return[0,100*-t.layerIndex]},compare:!1},highlightedObjectIndex:null,autoHighlight:!1,highlightColor:{type:"accessor",value:[0,0,128,128]}},Xt=function(t){f()(n,t);var e=zt(n);function n(){var t;a()(this,n);for(var r=arguments.length,i=new Array(r),o=0;o<r;o++)i[o]=arguments[o];return t=e.call.apply(e,[this].concat(i)),y()(l()(t),"internalState",null),y()(l()(t),"lifecycle",z.e.NO_STATE),y()(l()(t),"parent",null),t}return u()(n,[{key:"root",get:function(){for(var t=this;t.parent;)t=t.parent;return t}},{key:"toString",value:function(){var t=this.constructor.layerName||this.constructor.name;return"".concat(t,"({id: '").concat(this.props.id,"'})")}},{key:"project",value:function(t){Object(V.a)(this.internalState);var e=this.internalState.viewport||this.context.viewport,n=Object(q.a)(t,{viewport:e,modelMatrix:this.props.modelMatrix,coordinateOrigin:this.props.coordinateOrigin,coordinateSystem:this.props.coordinateSystem}),r=Object(Dt.q)(n,e.pixelProjectionMatrix),o=i()(r,3),a=o[0],s=o[1],u=o[2];return 2===t.length?[a,s]:[a,s,u]}},{key:"unproject",value:function(t){return Object(V.a)(this.internalState),(this.internalState.viewport||this.context.viewport).unproject(t)}},{key:"projectPosition",value:function(t,e){Object(V.a)(this.internalState);var n=this.internalState.viewport||this.context.viewport;return Object(q.b)(t,Nt({viewport:n,modelMatrix:this.props.modelMatrix,coordinateOrigin:this.props.coordinateOrigin,coordinateSystem:this.props.coordinateSystem},e))}},{key:"isComposite",get:function(){return!1}},{key:"setState",value:function(t){this.setChangeFlags({stateChanged:!0}),Object.assign(this.state,t),this.setNeedsRedraw()}},{key:"setNeedsRedraw",value:function(){this.internalState&&(this.internalState.needsRedraw=!0)}},{key:"setNeedsUpdate",value:function(){this.internalState&&(this.context.layerManager.setNeedsUpdate(String(this)),this.internalState.needsUpdate=!0)}},{key:"isLoaded",get:function(){return!!this.internalState&&!this.internalState.isAsyncPropLoading()}},{key:"wrapLongitude",get:function(){return this.props.wrapLongitude}},{key:"isPickable",value:function(){return this.props.pickable&&this.props.visible}},{key:"getModels",value:function(){return this.state&&(this.state.models||this.state.model&&[this.state.model])||[]}},{key:"setModuleParameters",value:function(t){var e,n=jt(this.getModels());try{for(n.s();!(e=n.n()).done;){e.value.updateModuleSettings(t)}}catch(t){n.e(t)}finally{n.f()}}},{key:"getAttributeManager",value:function(){return this.internalState&&this.internalState.attributeManager}},{key:"getCurrentLayer",value:function(){return this.internalState&&this.internalState.layer}},{key:"getLoadOptions",value:function(){return this.props.loadOptions}},{key:"use64bitPositions",value:function(){var t=this.props.coordinateSystem;return t===v.a.DEFAULT||t===v.a.LNGLAT||t===v.a.CARTESIAN}},{key:"onHover",value:function(t,e){return this.props.onHover&&this.props.onHover(t,e)||!1}},{key:"onClick",value:function(t,e){return this.props.onClick&&this.props.onClick(t,e)||!1}},{key:"nullPickingColor",value:function(){return[0,0,0]}},{key:"encodePickingColor",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:[];return e[0]=t+1&255,e[1]=t+1>>8&255,e[2]=t+1>>8>>8&255,e}},{key:"decodePickingColor",value:function(t){Object(V.a)(t instanceof Uint8Array);var e=i()(t,3);return e[0]+256*e[1]+65536*e[2]-1}},{key:"getNumInstances",value:function(){return Number.isFinite(this.props.numInstances)?this.props.numInstances:this.state&&void 0!==this.state.numInstances?this.state.numInstances:Object(U.a)(this.props.data)}},{key:"getStartIndices",value:function(){return this.props.startIndices?this.props.startIndices:this.state&&this.state.startIndices?this.state.startIndices:null}},{key:"getBounds",value:function(){var t,e=this.getAttributeManager();if(!e)return null;var n=e.attributes,r=n.positions,i=n.instancePositions;return null===(t=r||i)||void 0===t?void 0:t.getBounds()}},{key:"getShaders",value:function(t){var e,n=jt(this.props.extensions);try{for(n.s();!(e=n.n()).done;){var r=e.value;t=Object(W.a)(t,r.getShaders.call(this,r))}}catch(t){n.e(t)}finally{n.f()}return t}},{key:"shouldUpdateState",value:function(t){return t.changeFlags.propsOrDataChanged}},{key:"updateState",value:function(t){var e=this.getAttributeManager(),n=t.changeFlags.dataChanged;if(n&&e)if(Array.isArray(n)){var r,i=jt(n);try{for(i.s();!(r=i.n()).done;){var o=r.value;e.invalidateAll(o)}}catch(t){i.e(t)}finally{i.f()}}else e.invalidateAll();var a=t.props,s=t.oldProps,u=Number.isInteger(s.highlightedObjectIndex)||s.pickable,c=Number.isInteger(a.highlightedObjectIndex)||a.pickable;if(u!==c&&e){var l=e.attributes,h=l.pickingColors,f=l.instancePickingColors,p=h||f;p&&(c&&p.constant&&(p.constant=!1,e.invalidate(p.id)),p.value||c||(p.constant=!0,p.value=[0,0,0]))}}},{key:"finalizeState",value:function(t){var e,n=jt(this.getModels());try{for(n.s();!(e=n.n()).done;){e.value.delete()}}catch(t){n.e(t)}finally{n.f()}var r=this.getAttributeManager();r&&r.finalize(),this.context&&this.context.resourceManager.unsubscribe({consumerId:this.id}),this.internalState&&(this.internalState.uniformTransitions.clear(),this.internalState.finalize())}},{key:"draw",value:function(t){var e,n=jt(this.getModels());try{for(n.s();!(e=n.n()).done;){e.value.draw(t)}}catch(t){n.e(t)}finally{n.f()}}},{key:"getPickingInfo",value:function(t){var e=t.info,n=(t.mode,t.sourceLayer,e.index);return n>=0&&Array.isArray(this.props.data)&&(e.object=this.props.data[n]),e}},{key:"raiseError",value:function(t,e){var n,r,i,o;(e&&(t.message="".concat(e,": ").concat(t.message)),null!==(n=(r=this.props).onError)&&void 0!==n&&n.call(r,t))||(null===(i=this.context)||void 0===i||null===(o=i.onError)||void 0===o||o.call(i,t,this))}},{key:"getNeedsRedraw",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{clearRedrawFlags:!1};return this._getNeedsRedraw(t)}},{key:"needsUpdate",value:function(){return!!this.internalState&&(this.internalState.needsUpdate||this.hasUniformTransition()||this.shouldUpdateState(this._getUpdateParams()))}},{key:"hasUniformTransition",value:function(){var t;return(null===(t=this.internalState)||void 0===t?void 0:t.uniformTransitions.active)||!1}},{key:"activateViewport",value:function(t){if(this.internalState){var e=this.internalState.viewport;this.internalState.viewport=t,e&&Ht({oldViewport:e,viewport:t})||(this.setChangeFlags({viewportChanged:!0}),this.isComposite?this.needsUpdate()&&this.setNeedsUpdate():this._update())}}},{key:"invalidateAttribute",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:"all",e=this.getAttributeManager();e&&("all"===t?e.invalidateAll():e.invalidate(t))}},{key:"updateAttributes",value:function(t){var e,n=jt(this.getModels());try{for(n.s();!(e=n.n()).done;){var r=e.value;this._setModelAttributes(r,t)}}catch(t){n.e(t)}finally{n.f()}}},{key:"_updateAttributes",value:function(){var t=this.getAttributeManager();if(t){var e=this.props,n=this.getNumInstances(),r=this.getStartIndices();t.update({data:e.data,numInstances:n,startIndices:r,props:e,transitions:e.transitions,buffers:e.data.attributes,context:this});var i=t.getChangedAttributes({clearChangedFlags:!0});this.updateAttributes(i)}}},{key:"_updateAttributeTransition",value:function(){var t=this.getAttributeManager();t&&t.updateTransition()}},{key:"_updateUniformTransition",value:function(){var t=this.internalState.uniformTransitions;if(t.active){var e=t.update(),n=Object.create(this.props);for(var r in e)Object.defineProperty(n,r,{value:e[r]});return n}return this.props}},{key:"calculateInstancePickingColors",value:function(t,e){var n=e.numInstances;if(!t.constant){var r=Math.floor(Wt.length/3);if(this.internalState.usesPickingColorCache=!0,r<n){n>Gt&&M.a.warn("Layer has too many data objects. Picking might not be able to distinguish all objects.")(),Wt=X.a.allocate(Wt,n,{size:3,copy:!0,maxCount:Math.max(n,Gt)});for(var i=Math.floor(Wt.length/3),o=[],a=r;a<i;a++)this.encodePickingColor(a,o),Wt[3*a+0]=o[0],Wt[3*a+1]=o[1],Wt[3*a+2]=o[2]}t.value=Wt.subarray(0,3*n)}}},{key:"_setModelAttributes",value:function(t,e){var n=this.getAttributeManager(),r=t.userData.excludeAttributes||{},i=n.getShaderAttributes(e,r);t.setAttributes(i)}},{key:"disablePickingIndex",value:function(t){this._disablePickingIndex(t)}},{key:"_disablePickingIndex",value:function(t){var e=this.getAttributeManager().attributes,n=e.pickingColors,r=e.instancePickingColors,i=n||r;if(i){var o=i.getVertexOffset(t),a=i.getVertexOffset(t+1);i.buffer.subData({data:new Uint8Array(a-o),offset:o})}}},{key:"restorePickingColors",value:function(){var t=this.getAttributeManager().attributes,e=t.pickingColors,n=t.instancePickingColors,r=e||n;r&&(this.internalState.usesPickingColorCache&&r.value.buffer!==Wt.buffer&&(r.value=Wt.subarray(0,r.value.length)),r.updateSubBuffer({startOffset:0}))}},{key:"_initialize",value:function(){Object(V.a)(!this.internalState),Object(V.a)(Number.isFinite(this.props.coordinateSystem)),Object(N.a)("layer.initialize",this);var t=this._getAttributeManager();t&&t.addInstanced({instancePickingColors:{type:5121,size:3,noAlloc:!0,update:this.calculateInstancePickingColors}}),this.internalState=new kt({attributeManager:t,layer:this}),this._clearChangeFlags(),this.state={},Object.defineProperty(this.state,"attributeManager",{get:function(){return M.a.deprecated("layer.state.attributeManager","layer.getAttributeManager()")(),t}}),this.internalState.layer=this,this.internalState.uniformTransitions=new j(this.context.timeline),this.internalState.onAsyncPropUpdated=this._onAsyncPropUpdated.bind(this),this.internalState.setAsyncProps(this.props),this.initializeState(this.context);var e,n=jt(this.props.extensions);try{for(n.s();!(e=n.n()).done;){var r=e.value;r.initializeState.call(this,this.context,r)}}catch(t){n.e(t)}finally{n.f()}this.setChangeFlags({dataChanged:"init",propsChanged:"init",viewportChanged:!0,extensionsChanged:!0}),this._update()}},{key:"_transferState",value:function(t){Object(N.a)("layer.matched",this,this===t);var e=t.state,n=t.internalState;this!==t&&(this.internalState=n,this.internalState.layer=this,this.state=e,this.internalState.setAsyncProps(this.props),this._diffProps(this.props,this.internalState.getOldProps()))}},{key:"_update",value:function(){var t=this.needsUpdate();if(Object(N.a)("layer.update",this,t),t){var e=this.props,n=this.context,r=this.internalState,i=n.viewport,o=this._updateUniformTransition();r.propsInTransition=o,n.viewport=r.viewport||i,this.props=o;try{var a=this._getUpdateParams(),s=this.getModels();if(n.gl)this.updateState(a);else try{this.updateState(a)}catch(t){}var u,c=jt(this.props.extensions);try{for(c.s();!(u=c.n()).done;){var l=u.value;l.updateState.call(this,a,l)}}catch(t){c.e(t)}finally{c.f()}var h=this.getModels()[0]!==s[0];this._postUpdate(a,h)}finally{n.viewport=i,this.props=e,this._clearChangeFlags(),r.needsUpdate=!1,r.resetOldProps()}}}},{key:"_finalize",value:function(){Object(N.a)("layer.finalize",this),this.finalizeState(this.context);var t,e=jt(this.props.extensions);try{for(e.s();!(t=e.n()).done;){var n=t.value;n.finalizeState.call(this,n)}}catch(t){e.e(t)}finally{e.f()}}},{key:"_drawLayer",value:function(t){var e=this,n=t.moduleParameters,r=void 0===n?null:n,i=t.uniforms,o=void 0===i?{}:i,a=t.parameters,s=void 0===a?{}:a;this._updateAttributeTransition();var u=this.props,c=this.context;this.props=this.internalState.propsInTransition||u;var l=this.props.opacity;o.opacity=Math.pow(l,1/2.2);try{r&&this.setModuleParameters(r);var h=this.props.getPolygonOffset,f=h&&h(o)||[0,0];Object(G.n)(c.gl,{polygonOffset:f}),Object(G.o)(c.gl,s,(function(){var t,n={moduleParameters:r,uniforms:o,parameters:s,context:c},i=jt(e.props.extensions);try{for(i.s();!(t=i.n()).done;){var a=t.value;a.draw.call(e,n,a)}}catch(t){i.e(t)}finally{i.f()}e.draw(n)}))}finally{this.props=u}}},{key:"getChangeFlags",value:function(){var t;return null===(t=this.internalState)||void 0===t?void 0:t.changeFlags}},{key:"setChangeFlags",value:function(t){if(this.internalState){var e=this.internalState.changeFlags;for(var n in t)if(t[n]){var r=!1;switch(n){case"dataChanged":var i=t[n],o=e[n];i&&Array.isArray(o)&&(e.dataChanged=Array.isArray(i)?o.concat(i):i,r=!0);default:e[n]||(e[n]=t[n],r=!0)}r&&Object(N.a)("layer.changeFlag",this,n,t)}var a=Boolean(e.dataChanged||e.updateTriggersChanged||e.propsChanged||e.extensionsChanged);e.propsOrDataChanged=a,e.somethingChanged=a||e.viewportChanged||e.stateChanged}}},{key:"_clearChangeFlags",value:function(){this.internalState.changeFlags={dataChanged:!1,propsChanged:!1,updateTriggersChanged:!1,viewportChanged:!1,stateChanged:!1,extensionsChanged:!1,propsOrDataChanged:!1,somethingChanged:!1}}},{key:"_diffProps",value:function(t,e){var n=Object(F.b)(t,e);if(n.updateTriggersChanged)for(var r in n.updateTriggersChanged)n.updateTriggersChanged[r]&&this.invalidateAttribute(r);if(n.transitionsChanged)for(var i in n.transitionsChanged){var o;this.internalState.uniformTransitions.add(i,e[i],t[i],null===(o=t.transitions)||void 0===o?void 0:o[i])}return this.setChangeFlags(n)}},{key:"validateProps",value:function(){Object(F.c)(this.props)}},{key:"updateAutoHighlight",value:function(t){this.props.autoHighlight&&!Number.isInteger(this.props.highlightedObjectIndex)&&this._updateAutoHighlight(t)}},{key:"_updateAutoHighlight",value:function(t){var e={pickingSelectedColor:t.picked?t.color:null},n=this.props.highlightColor;t.picked&&"function"==typeof n&&(e.pickingHighlightColor=n(t)),this.setModuleParameters(e),this.setNeedsRedraw()}},{key:"_getAttributeManager",value:function(){var t=this.context;return new _.a(t.gl,{id:this.props.id,stats:t.stats,timeline:t.timeline})}},{key:"_postUpdate",value:function(t,e){var n=t.props,r=t.oldProps;this.setNeedsRedraw(),this._updateAttributes();var i=this.state.model;null==i||i.setInstanceCount(this.getNumInstances());var o=n.autoHighlight,a=n.highlightedObjectIndex,s=n.highlightColor;if(e||r.autoHighlight!==o||r.highlightedObjectIndex!==a||r.highlightColor!==s){var u={};o||(u.pickingSelectedColor=null),Array.isArray(s)&&(u.pickingHighlightColor=s),Number.isInteger(a)&&(u.pickingSelectedColor=Number.isFinite(a)&&a>=0?this.encodePickingColor(a):null),this.setModuleParameters(u)}}},{key:"_getUpdateParams",value:function(){return{props:this.props,oldProps:this.internalState.getOldProps(),context:this.context,changeFlags:this.internalState.changeFlags}}},{key:"_getNeedsRedraw",value:function(t){if(!this.internalState)return!1;var e=!1;e=e||this.internalState.needsRedraw&&this.id,this.internalState.needsRedraw=this.internalState.needsRedraw&&!t.clearRedrawFlags;var n=this.getAttributeManager(),r=!!n&&n.getNeedsRedraw(t);return e=e||r}},{key:"_onAsyncPropUpdated",value:function(){this._diffProps(this.props,this.internalState.getOldProps()),this.setNeedsUpdate()}}]),n}(wt);y()(Xt,"defaultProps",qt),y()(Xt,"layerName","Layer")},function(t,e,n){"use strict";var r=n(0),i=n.n(r),o=n(3),a=n.n(o),s=n(4),u=n.n(s),c=n(9),l=n.n(c),h=n(27),f=n.n(h),p=n(8),d=n.n(p),A=n(5),g=n.n(A),m=n(6),y=n.n(m),v=n(1),_=n.n(v),b=n(251),x=n(189),w=n(33);function E(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function O(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?E(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):E(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var S=function(){function t(e,n){a()(this,t),this.opts=n,this.source=e}return u()(t,[{key:"value",get:function(){return this.source.value}},{key:"getValue",value:function(){var t=this.source.getBuffer(),e=this.getAccessor();if(t)return[t,e];var n=this.source.value,r=e.size,i=n;if(n&&n.length!==r){i=new Float32Array(r);for(var o=e.elementOffset||0,a=0;a<r;++a)i[a]=n[o+a]}return i}},{key:"getAccessor",value:function(){return O(O({},this.source.getAccessor()),this.opts)}}]),t}();var T=n(68),C=n(35),P=n(21);function M(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function I(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?M(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):M(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function B(t){return t.stride||t.size*t.bytesPerElement}function R(t,e){e.offset&&P.a.removed("shaderAttribute.offset","vertexOffset, elementOffset")();var n=B(t),r=(void 0!==e.vertexOffset?e.vertexOffset:t.vertexOffset||0)*n+(e.elementOffset||0)*t.bytesPerElement+(t.offset||0);return I(I({},e),{},{offset:r,stride:n})}var k=function(){function t(e,n,r){a()(this,t),this.gl=e,this.id=n.id||"",this.size=n.size||1;var i,o=n.logicalType||n.type,s=5130===o,u=n.defaultValue;u=Number.isFinite(u)?[u]:u||new Array(this.size).fill(0),i=s?5126:!o&&n.isIndexed?e&&Object(b.b)(e,x.a.ELEMENT_INDEX_UINT32)?5125:5123:o||5126;var c=function(t){switch(t){case 5126:return Float32Array;case 5130:return Float64Array;case 5123:case 33635:case 32819:case 32820:return Uint16Array;case 5125:return Uint32Array;case 5121:return Uint8ClampedArray;case 5120:return Int8Array;case 5122:return Int16Array;case 5124:return Int32Array;default:throw new Error("Unknown GL type")}}(o||i||5126);this.doublePrecision=s,s&&!1===n.fp64&&(c=Float32Array),this.value=null,this.settings=I(I({},n),{},{defaultType:c,defaultValue:u,logicalType:o,type:i,size:this.size,bytesPerElement:c.BYTES_PER_ELEMENT}),this.state=I(I({},r),{},{externalBuffer:null,bufferAccessor:this.settings,allocatedValue:null,numInstances:0,bounds:null,constant:!1}),this._buffer=null}return u()(t,[{key:"isConstant",get:function(){return this.state.constant}},{key:"buffer",get:function(){if(!this._buffer){var t=this.settings,e=t.isIndexed,n=t.type;this._buffer=new w.a(this.gl,{id:this.id,target:e?34963:34962,accessor:{type:n}})}return this._buffer}},{key:"byteOffset",get:function(){var t=this.getAccessor();return t.vertexOffset?t.vertexOffset*B(t):0}},{key:"numInstances",get:function(){return this.state.numInstances},set:function(t){this.state.numInstances=t}},{key:"delete",value:function(){this._buffer&&(this._buffer.delete(),this._buffer=null),T.a.release(this.state.allocatedValue)}},{key:"getShaderAttributes",value:function(t,e){if(this.doublePrecision){var n={},r=this.value instanceof Float64Array,o=(a=this.getAccessor(),{high:s=R(a,e||{}),low:I(I({},s),{},{offset:s.offset+4*a.size})});return n[t]=new S(this,o.high),n["".concat(t,"64Low")]=r?new S(this,o.low):new Float32Array(this.size),n}var a,s;if(e){var u=R(this.getAccessor(),e);return i()({},t,new S(this,u))}return i()({},t,this)}},{key:"getBuffer",value:function(){return this.state.constant?null:this.state.externalBuffer||this._buffer}},{key:"getValue",value:function(){return this.state.constant?this.value:[this.getBuffer(),this.getAccessor()]}},{key:"getAccessor",value:function(){return this.state.bufferAccessor}},{key:"getBounds",value:function(){if(this.state.bounds)return this.state.bounds;var t=null;if(this.state.constant&&this.value){var e=Array.from(this.value);t=[e,e]}else{var n=this.value,r=this.numInstances,i=this.size,o=r*i;if(n&&o&&n.length>=o){for(var a=new Array(i).fill(1/0),s=new Array(i).fill(-1/0),u=0;u<o;)for(var c=0;c<i;c++){var l=n[u++];l<a[c]&&(a[c]=l),l>s[c]&&(s[c]=l)}t=[a,s]}}return this.state.bounds=t,t}},{key:"setData",value:function(t){var e,n=this.state;e=ArrayBuffer.isView(t)?{value:t}:t instanceof w.a?{buffer:t}:t;var r=I(I({},this.settings),e);if(n.bufferAccessor=r,n.bounds=null,e.constant){var i=e.value;if(i=this._normalizeValue(i,[],0),this.settings.normalized&&(i=this.normalizeConstant(i)),!(!n.constant||!this._areValuesEqual(i,this.value)))return!1;n.externalBuffer=null,n.constant=!0,this.value=i}else if(e.buffer){var o=e.buffer;n.externalBuffer=o,n.constant=!1,this.value=e.value||null;var a=e.value instanceof Float64Array;r.type=e.type||o.accessor.type,r.bytesPerElement=o.accessor.BYTES_PER_ELEMENT*(a?2:1),r.stride=B(r)}else if(e.value){this._checkExternalBuffer(e);var s=e.value;n.externalBuffer=null,n.constant=!1,this.value=s,r.bytesPerElement=s.BYTES_PER_ELEMENT,r.stride=B(r);var u=this.buffer,c=this.byteOffset;this.doublePrecision&&s instanceof Float64Array&&(s=Object(C.f)(s,r));var l=s.byteLength+c+2*r.stride;u.byteLength<l&&u.reallocate(l),u.setAccessor(null),u.subData({data:s,offset:c}),r.type=e.type||u.accessor.type}return!0}},{key:"updateSubBuffer",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};this.state.bounds=null;var e=this.value,n=t.startOffset,r=void 0===n?0:n,i=t.endOffset;this.buffer.subData({data:this.doublePrecision&&e instanceof Float64Array?Object(C.f)(e,{size:this.size,startIndex:r,endIndex:i}):e.subarray(r,i),offset:r*e.BYTES_PER_ELEMENT+this.byteOffset})}},{key:"allocate",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]&&arguments[1],n=this.state,r=n.allocatedValue,i=T.a.allocate(r,t+1,{size:this.size,type:this.settings.defaultType,copy:e});this.value=i;var o=this.buffer,a=this.byteOffset;return o.byteLength<i.byteLength+a&&(o.reallocate(i.byteLength+a),e&&r&&o.subData({data:r instanceof Float64Array?Object(C.f)(r,this):r,offset:a})),n.allocatedValue=i,n.constant=!1,n.externalBuffer=null,n.bufferAccessor=this.settings,!0}},{key:"_checkExternalBuffer",value:function(t){var e=t.value;if(!ArrayBuffer.isView(e))throw new Error("Attribute ".concat(this.id," value is not TypedArray"));var n=this.settings.defaultType,r=!1;if(this.doublePrecision&&(r=e.BYTES_PER_ELEMENT<4),r)throw new Error("Attribute ".concat(this.id," does not support ").concat(e.constructor.name));e instanceof n||!this.settings.normalized||"normalized"in t||P.a.warn("Attribute ".concat(this.id," is normalized"))()}},{key:"normalizeConstant",value:function(t){switch(this.settings.type){case 5120:return new Float32Array(t).map((function(t){return(t+128)/255*2-1}));case 5122:return new Float32Array(t).map((function(t){return(t+32768)/65535*2-1}));case 5121:return new Float32Array(t).map((function(t){return t/255}));case 5123:return new Float32Array(t).map((function(t){return t/65535}));default:return t}}},{key:"_normalizeValue",value:function(t,e,n){var r=this.settings,i=r.defaultValue,o=r.size;if(Number.isFinite(t))return e[n]=t,e;if(!t)return e[n]=i[0],e;switch(o){case 4:e[n+3]=Number.isFinite(t[3])?t[3]:i[3];case 3:e[n+2]=Number.isFinite(t[2])?t[2]:i[2];case 2:e[n+1]=Number.isFinite(t[1])?t[1]:i[1];case 1:e[n+0]=Number.isFinite(t[0])?t[0]:i[0];break;default:for(var a=o;--a>=0;)e[n+a]=Number.isFinite(t[a])?t[a]:i[a]}return e}},{key:"_areValuesEqual",value:function(t,e){if(!t||!e)return!1;for(var n=this.size,r=0;r<n;r++)if(t[r]!==e[r])return!1;return!0}}]),t}(),D=n(29),L=n(52),j=n(67),F=[],z=[[0,1/0]];function U(t,e){if(t===z)return t;if(e[0]<0&&(e[0]=0),e[0]>=e[1])return t;for(var n=[],r=t.length,i=0,o=0;o<r;o++){var a=t[o];a[1]<e[0]?(n.push(a),i=o+1):a[0]>e[1]?n.push(a):e=[Math.min(a[0],e[0]),Math.max(a[1],e[1])]}return n.splice(i,0,e),n}var N=n(43);function G(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return V(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return V(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function V(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function H(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=_()(t);if(e){var i=_()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return y()(this,n)}}var W=function(t){g()(n,t);var e=H(n);function n(t,r){var o;return a()(this,n),o=e.call(this,t,r,{startIndices:null,lastExternalBuffer:null,binaryValue:null,binaryAccessor:null,needsUpdate:!0,needsRedraw:!1,updateRanges:z}),i()(f()(o),"constant",!1),o.settings.update=r.update||(r.accessor?o._autoUpdater:void 0),Object.seal(o.settings),Object.seal(o.state),o._validateAttributeUpdaters(),o}return u()(n,[{key:"startIndices",get:function(){return this.state.startIndices},set:function(t){this.state.startIndices=t}},{key:"needsUpdate",value:function(){return this.state.needsUpdate}},{key:"needsRedraw",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},e=t.clearChangedFlags,n=void 0!==e&&e,r=this.state.needsRedraw;return this.state.needsRedraw=r&&!n,r}},{key:"getUpdateTriggers",value:function(){var t=this.settings.accessor;return[this.id].concat("function"!=typeof t&&t||[])}},{key:"supportsTransition",value:function(){return Boolean(this.settings.transition)}},{key:"getTransitionSetting",value:function(t){if(!t||!this.supportsTransition())return null;var e=this.settings.accessor,n=this.settings.transition,r=Array.isArray(e)?t[e.find((function(e){return t[e]}))]:t[e];return Object(N.e)(r,n)}},{key:"setNeedsUpdate",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:this.id,e=arguments.length>1?arguments[1]:void 0;if(this.state.needsUpdate=this.state.needsUpdate||t,this.setNeedsRedraw(t),e){var n=e.startRow,r=void 0===n?0:n,i=e.endRow,o=void 0===i?1/0:i;this.state.updateRanges=U(this.state.updateRanges,[r,o])}else this.state.updateRanges=z}},{key:"clearNeedsUpdate",value:function(){this.state.needsUpdate=!1,this.state.updateRanges=F}},{key:"setNeedsRedraw",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:this.id;this.state.needsRedraw=this.state.needsRedraw||t}},{key:"allocate",value:function(t){var e=this.state,r=this.settings;return!r.noAlloc&&(!!r.update&&(d()(_()(n.prototype),"allocate",this).call(this,t,e.updateRanges!==z),!0))}},{key:"updateBuffer",value:function(t){var e=t.numInstances,r=t.data,i=t.props,o=t.context;if(!this.needsUpdate())return!1;var a=this.state.updateRanges,s=this.settings,u=s.update,c=s.noAlloc,h=!0;if(u){var f,p=G(a);try{for(p.s();!(f=p.n()).done;){var A=l()(f.value,2),g=A[0],m=A[1];u.call(o,this,{data:r,startRow:g,endRow:m,props:i,numInstances:e})}}catch(t){p.e(t)}finally{p.f()}if(this.value)if(this.constant||this.buffer.byteLength<this.value.byteLength+this.byteOffset)this.setData({value:this.value,constant:this.constant}),this.constant=!1;else{var y,v=G(a);try{for(v.s();!(y=v.n()).done;){var b=l()(y.value,2),x=b[0],w=b[1],E=Number.isFinite(x)?this.getVertexOffset(x):0,O=Number.isFinite(w)?this.getVertexOffset(w):c||!Number.isFinite(e)?this.value.length:e*this.size;d()(_()(n.prototype),"updateSubBuffer",this).call(this,{startOffset:E,endOffset:O})}}catch(t){v.e(t)}finally{v.f()}}else;this._checkAttributeArray()}else h=!1;return this.clearNeedsUpdate(),this.setNeedsRedraw(),h}},{key:"setConstantValue",value:function(t){return void 0!==t&&"function"!=typeof t&&(this.setData({constant:!0,value:t})&&this.setNeedsRedraw(),this.clearNeedsUpdate(),!0)}},{key:"setExternalBuffer",value:function(t){var e=this.state;return t?(this.clearNeedsUpdate(),e.lastExternalBuffer===t||(e.lastExternalBuffer=t,this.setNeedsRedraw(),this.setData(t)),!0):(e.lastExternalBuffer=null,!1)}},{key:"setBinaryValue",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:null,n=this.state,r=this.settings;if(!t)return n.binaryValue=null,n.binaryAccessor=null,!1;if(r.noAlloc)return!1;if(n.binaryValue===t)return this.clearNeedsUpdate(),!0;n.binaryValue=t,this.setNeedsRedraw();var i=r.transform||e!==this.startIndices;if(i){ArrayBuffer.isView(t)&&(t={value:t});var o=t;Object(D.a)(ArrayBuffer.isView(o.value),"invalid ".concat(r.accessor));var a=Boolean(o.size)&&o.size!==this.size;return n.binaryAccessor=Object(L.b)(o.value,{size:o.size||this.size,stride:o.stride,offset:o.offset,startIndices:e,nested:a}),!1}return this.clearNeedsUpdate(),this.setData(t),!0}},{key:"getVertexOffset",value:function(t){var e=this.startIndices;return(e?e[t]:t)*this.size}},{key:"getShaderAttributes",value:function(){var t=this.settings.shaderAttributes||i()({},this.id,null),e={};for(var r in t)Object.assign(e,d()(_()(n.prototype),"getShaderAttributes",this).call(this,r,t[r]));return e}},{key:"_autoUpdater",value:function(t,e){var n=e.data,r=e.startRow,i=e.endRow,o=e.props,a=e.numInstances;if(!t.constant){var s=t.settings,u=t.state,c=t.value,l=t.size,h=t.startIndices,f=s.accessor,p=s.transform,d=u.binaryAccessor||("function"==typeof f?f:o[f]);Object(D.a)("function"==typeof d,'accessor "'.concat(f,'" is not a function'));var A,g=t.getVertexOffset(r),m=Object(L.a)(n,r,i),y=m.iterable,v=m.objectInfo,_=G(y);try{for(_.s();!(A=_.n()).done;){var b=A.value;v.index++;var x=d(b,v);if(p&&(x=p.call(this,x)),h){var w=(v.index<h.length-1?h[v.index+1]:a)-h[v.index];if(x&&Array.isArray(x[0])){var E,O=g,S=G(x);try{for(S.s();!(E=S.n()).done;){var T=E.value;t._normalizeValue(T,c,O),O+=l}}catch(t){S.e(t)}finally{S.f()}}else x&&x.length>l?c.set(x,g):(t._normalizeValue(x,v.target,0),Object(j.a)({target:c,source:v.target,start:g,count:w}));g+=w*l}else t._normalizeValue(x,c,g),g+=l}}catch(t){_.e(t)}finally{_.f()}}}},{key:"_validateAttributeUpdaters",value:function(){var t=this.settings;if(!(t.noAlloc||"function"==typeof t.update))throw new Error("Attribute ".concat(this.id," missing update or accessor"))}},{key:"_checkAttributeArray",value:function(){var t=this.value,e=Math.min(4,this.size);if(t&&t.length>=e){var n=!0;switch(e){case 4:n=n&&Number.isFinite(t[3]);case 3:n=n&&Number.isFinite(t[2]);case 2:n=n&&Number.isFinite(t[1]);case 1:n=n&&Number.isFinite(t[0]);break;default:n=!1}if(!n)throw new Error("Illegal attribute generated for ".concat(this.id))}}}]),n}(k),q=n(32),X=n(322),Z=n(75);function J(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function Q(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?J(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):J(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function K(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return Y(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return Y(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function Y(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var $=function(){function t(e){var n=e.gl,r=e.attribute,o=e.timeline;a()(this,t),i()(this,"type","interpolation"),this.gl=n,this.transition=new Z.a(o),this.attribute=r,this.attributeInTransition=new W(n,r.settings),this.currentStartIndices=r.startIndices,this.currentLength=0,this.transform=function(t,e){var n=Object(N.c)(e.size);return new X.a(t,{vs:"\n#define SHADER_NAME interpolation-transition-vertex-shader\n\nuniform float time;\nattribute ATTRIBUTE_TYPE aFrom;\nattribute ATTRIBUTE_TYPE aTo;\nvarying ATTRIBUTE_TYPE vCurrent;\n\nvoid main(void) {\n  vCurrent = mix(aFrom, aTo, time);\n  gl_Position = vec4(0.0);\n}\n",defines:{ATTRIBUTE_TYPE:n},varyings:["vCurrent"]})}(n,r);var s={byteLength:0,usage:35050};this.buffers=[new w.a(n,s),new w.a(n,s)]}return u()(t,[{key:"inProgress",get:function(){return this.transition.inProgress}},{key:"start",value:function(t,e){if(t.duration<=0)this.transition.cancel();else{this.settings=t;var n=this.gl,r=this.buffers,i=this.attribute;Object(N.a)(r);var o,a={numInstances:e,attribute:i,fromLength:this.currentLength,fromStartIndices:this.currentStartIndices,getData:t.enter},s=K(r);try{for(s.s();!(o=s.n()).done;){var u=o.value;Object(N.f)(Q({buffer:u},a))}}catch(t){s.e(t)}finally{s.f()}this.currentStartIndices=i.startIndices,this.currentLength=Object(N.b)(i,e),this.attributeInTransition.setData({buffer:r[1],value:i.value}),this.transition.start(t),this.transform.update({elementCount:Math.floor(this.currentLength/i.size),sourceBuffers:{aFrom:r[0],aTo:Object(N.d)(n,i)},feedbackBuffers:{vCurrent:r[1]}})}}},{key:"update",value:function(){var t=this.transition.update();if(t){var e=this.settings,n=e.duration,r=e.easing,i=this.transition.time/n;r&&(i=r(i)),this.transform.run({uniforms:{time:i}})}return t}},{key:"cancel",value:function(){this.transition.cancel(),this.transform.delete();var t,e=K(this.buffers);try{for(e.s();!(t=e.n()).done;){t.value.delete()}}catch(t){e.e(t)}finally{e.f()}this.buffers.length=0}}]),t}();var tt=n(206),et=n(107),nt=n(74);function rt(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return it(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return it(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function it(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function ot(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function at(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?ot(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):ot(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var st={interpolation:$,spring:function(){function t(e){var n=e.gl,r=e.attribute,o=e.timeline;a()(this,t),i()(this,"type","spring"),this.gl=n,this.type="spring",this.transition=new Z.a(o),this.attribute=r,this.attributeInTransition=new W(n,at(at({},r.settings),{},{normalized:!1})),this.currentStartIndices=r.startIndices,this.currentLength=0,this.texture=function(t){return new et.a(t,{data:new Uint8Array(4),format:6408,type:5121,border:0,mipmaps:!1,dataFormat:6408,width:1,height:1})}(n),this.framebuffer=function(t,e){return new nt.a(t,{id:"spring-transition-is-transitioning-framebuffer",width:1,height:1,attachments:i()({},36064,e)})}(n,this.texture),this.transform=function(t,e,n){var r=Object(N.c)(e.size);return new X.a(t,{framebuffer:n,vs:"\n#define SHADER_NAME spring-transition-vertex-shader\n\n#define EPSILON 0.00001\n\nuniform float stiffness;\nuniform float damping;\nattribute ATTRIBUTE_TYPE aPrev;\nattribute ATTRIBUTE_TYPE aCur;\nattribute ATTRIBUTE_TYPE aTo;\nvarying ATTRIBUTE_TYPE vNext;\nvarying float vIsTransitioningFlag;\n\nATTRIBUTE_TYPE getNextValue(ATTRIBUTE_TYPE cur, ATTRIBUTE_TYPE prev, ATTRIBUTE_TYPE dest) {\n  ATTRIBUTE_TYPE velocity = cur - prev;\n  ATTRIBUTE_TYPE delta = dest - cur;\n  ATTRIBUTE_TYPE spring = delta * stiffness;\n  ATTRIBUTE_TYPE damper = velocity * -1.0 * damping;\n  return spring + damper + velocity + cur;\n}\n\nvoid main(void) {\n  bool isTransitioning = length(aCur - aPrev) > EPSILON || length(aTo - aCur) > EPSILON;\n  vIsTransitioningFlag = isTransitioning ? 1.0 : 0.0;\n\n  vNext = getNextValue(aCur, aPrev, aTo);\n  gl_Position = vec4(0, 0, 0, 1);\n  gl_PointSize = 100.0;\n}\n",fs:"\n#define SHADER_NAME spring-transition-is-transitioning-fragment-shader\n\nvarying float vIsTransitioningFlag;\n\nvoid main(void) {\n  if (vIsTransitioningFlag == 0.0) {\n    discard;\n  }\n  gl_FragColor = vec4(1.0);\n}",defines:{ATTRIBUTE_TYPE:r},varyings:["vNext"]})}(n,r,this.framebuffer);var s={byteLength:0,usage:35050};this.buffers=[new w.a(n,s),new w.a(n,s),new w.a(n,s)]}return u()(t,[{key:"inProgress",get:function(){return this.transition.inProgress}},{key:"start",value:function(t,e){var n,r=this.gl,i=this.buffers,o=this.attribute,a={numInstances:e,attribute:o,fromLength:this.currentLength,fromStartIndices:this.currentStartIndices,getData:t.enter},s=rt(i);try{for(s.s();!(n=s.n()).done;){var u=n.value;Object(N.f)(at({buffer:u},a))}}catch(t){s.e(t)}finally{s.f()}this.settings=t,this.currentStartIndices=o.startIndices,this.currentLength=Object(N.b)(o,e),this.attributeInTransition.setData({buffer:i[1],value:o.value}),this.transition.start(at(at({},t),{},{duration:1/0})),this.transform.update({elementCount:Math.floor(this.currentLength/o.size),sourceBuffers:{aTo:Object(N.d)(r,o)}})}},{key:"update",value:function(){var t=this.buffers,e=this.transform,n=this.framebuffer,r=this.transition;if(!r.update())return!1;var i=this.settings;return e.update({sourceBuffers:{aPrev:t[0],aCur:t[1]},feedbackBuffers:{vNext:t[2]}}),e.run({framebuffer:n,discard:!1,clearRenderTarget:!0,uniforms:{stiffness:i.stiffness,damping:i.damping},parameters:{depthTest:!1,blend:!0,viewport:[0,0,1,1],blendFunc:[1,1],blendEquation:[32776,32776]}}),Object(N.a)(t),this.attributeInTransition.setData({buffer:t[1],value:this.attribute.value}),Object(tt.c)(n)[0]>0||r.end(),!0}},{key:"cancel",value:function(){this.transition.cancel(),this.transform.delete();var t,e=rt(this.buffers);try{for(e.s();!(t=e.n()).done;){t.value.delete()}}catch(t){e.e(t)}finally{e.f()}this.buffers.length=0,this.texture.delete(),this.framebuffer.delete()}}]),t}()},ut=function(){function t(e,n){var r=n.id,i=n.timeline;a()(this,t),this.id=r,this.gl=e,this.timeline=i,this.transitions={},this.needsRedraw=!1,this.numInstances=1,this.isSupported=X.a.isSupported(e)}return u()(t,[{key:"finalize",value:function(){for(var t in this.transitions)this._removeTransition(t)}},{key:"update",value:function(t){var e=t.attributes,n=t.transitions,r=t.numInstances;for(var i in this.numInstances=r||1,e){var o=e[i],a=o.getTransitionSetting(n);a&&this._updateAttribute(i,o,a)}for(var s in this.transitions){var u=e[s];u&&u.getTransitionSetting(n)||this._removeTransition(s)}}},{key:"hasAttribute",value:function(t){var e=this.transitions[t];return e&&e.inProgress}},{key:"getAttributes",value:function(){var t={};for(var e in this.transitions){var n=this.transitions[e];n.inProgress&&(t[e]=n.attributeInTransition)}return t}},{key:"run",value:function(){if(!this.isSupported||0===this.numInstances)return!1;for(var t in this.transitions){this.transitions[t].update()&&(this.needsRedraw=!0)}var e=this.needsRedraw;return this.needsRedraw=!1,e}},{key:"_removeTransition",value:function(t){this.transitions[t].cancel(),delete this.transitions[t]}},{key:"_updateAttribute",value:function(t,e,n){var r=this.transitions[t],i=!r||r.type!==n.type;if(i){if(!this.isSupported)return void P.a.warn("WebGL2 not supported by this browser. Transition for ".concat(t," is disabled."))();r&&this._removeTransition(t);var o=st[n.type];o?this.transitions[t]=new o({attribute:e,timeline:this.timeline,gl:this.gl}):(P.a.error("unsupported transition type '".concat(n.type,"'"))(),i=!1)}(i||e.needsRedraw())&&(this.needsRedraw=!0,this.transitions[t].start(n,this.numInstances))}}]),t}();function ct(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function lt(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?ct(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):ct(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function ht(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return ft(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return ft(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function ft(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}n.d(e,"a",(function(){return pt}));var pt=function(){function t(e){var n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},r=n.id,i=void 0===r?"attribute-manager":r,o=n.stats,s=n.timeline;a()(this,t),this.id=i,this.gl=e,this.attributes={},this.updateTriggers={},this.needsRedraw=!0,this.userData={},this.stats=o,this.attributeTransitionManager=new ut(e,{id:"".concat(i,"-transitions"),timeline:s}),Object.seal(this)}return u()(t,[{key:"finalize",value:function(){for(var t in this.attributes)this.attributes[t].delete();this.attributeTransitionManager.finalize()}},{key:"getNeedsRedraw",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{clearRedrawFlags:!1},e=this.needsRedraw;return this.needsRedraw=this.needsRedraw&&!t.clearRedrawFlags,e&&this.id}},{key:"setNeedsRedraw",value:function(){this.needsRedraw=!0}},{key:"add",value:function(t){this._add(t)}},{key:"addInstanced",value:function(t){this._add(t,{instanced:1})}},{key:"remove",value:function(t){var e,n=ht(t);try{for(n.s();!(e=n.n()).done;){var r=e.value;void 0!==this.attributes[r]&&(this.attributes[r].delete(),delete this.attributes[r])}}catch(t){n.e(t)}finally{n.f()}}},{key:"invalidate",value:function(t,e){var n=this._invalidateTrigger(t,e);Object(q.a)("attributeManager.invalidate",this,t,n)}},{key:"invalidateAll",value:function(t){for(var e in this.attributes)this.attributes[e].setNeedsUpdate(e,t);Object(q.a)("attributeManager.invalidate",this,"all")}},{key:"update",value:function(t){var e=t.data,n=t.numInstances,r=t.startIndices,i=void 0===r?null:r,o=t.transitions,a=t.props,s=void 0===a?{}:a,u=t.buffers,c=void 0===u?{}:u,l=t.context,h=void 0===l?{}:l,f=!1;for(var p in Object(q.a)("attributeManager.updateStart",this),this.stats&&this.stats.get("Update Attributes").timeStart(),this.attributes){var d=this.attributes[p],A=d.settings.accessor;d.startIndices=i,d.numInstances=n,s[p]&&P.a.removed("props.".concat(p),"data.attributes.".concat(p))(),d.setExternalBuffer(c[p])||d.setBinaryValue("string"==typeof A?c[A]:void 0,e.startIndices)||"string"==typeof A&&!c[A]&&d.setConstantValue(s[A])||d.needsUpdate()&&(f=!0,this._updateAttribute({attribute:d,numInstances:n,data:e,props:s,context:h})),this.needsRedraw=this.needsRedraw||d.needsRedraw()}f&&Object(q.a)("attributeManager.updateEnd",this,n),this.stats&&this.stats.get("Update Attributes").timeEnd(),this.attributeTransitionManager.update({attributes:this.attributes,numInstances:n,transitions:o})}},{key:"updateTransition",value:function(){var t=this.attributeTransitionManager.run();return this.needsRedraw=this.needsRedraw||t,t}},{key:"getAttributes",value:function(){return this.attributes}},{key:"getChangedAttributes",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{clearChangedFlags:!1},e=this.attributes,n=this.attributeTransitionManager,r=lt({},n.getAttributes());for(var i in e){var o=e[i];o.needsRedraw(t)&&!n.hasAttribute(i)&&(r[i]=o)}return r}},{key:"getShaderAttributes",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};t||(t=this.getAttributes());var n={};for(var r in t)e[r]||Object.assign(n,t[r].getShaderAttributes());return n}},{key:"_add",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};for(var n in t){var r=t[n];this.attributes[n]=this._createAttribute(n,r,e)}this._mapUpdateTriggersToAttributes()}},{key:"_createAttribute",value:function(t,e,n){var r=lt(lt({},e),{},{id:t,size:(e.isIndexed?1:e.size)||1,divisor:n.instanced?1:e.divisor||0});return new W(this.gl,r)}},{key:"_mapUpdateTriggersToAttributes",value:function(){var t=this,e={},n=function(n){t.attributes[n].getUpdateTriggers().forEach((function(t){e[t]||(e[t]=[]),e[t].push(n)}))};for(var r in this.attributes)n(r);this.updateTriggers=e}},{key:"_invalidateTrigger",value:function(t,e){var n=this.attributes,r=this.updateTriggers[t];return r&&r.forEach((function(t){var r=n[t];r&&r.setNeedsUpdate(r.id,e)})),r}},{key:"_updateAttribute",value:function(t){var e=t.attribute,n=t.numInstances;(Object(q.a)("attribute.updateStart",e),e.constant)?e.setConstantValue(e.value):(e.allocate(n)&&Object(q.a)("attribute.allocate",e,n),e.updateBuffer(t)&&(this.needsRedraw=!0,Object(q.a)("attribute.updateEnd",e,n)))}}]),t}()},function(t,e,n){"use strict";var r=n(9),i=n.n(r),o=n(3),a=n.n(o),s=n(4),u=n.n(s),c=n(27),l=n.n(c),h=n(5),f=n.n(h),p=n(6),d=n.n(p),A=n(1),g=n.n(A),m=n(0),y=n.n(m),v=n(52),_=n(198),b=n(171);const x=1e20;class w{constructor({fontSize:t=24,buffer:e=3,radius:n=8,cutoff:r=.25,fontFamily:i="sans-serif",fontWeight:o="normal",fontStyle:a="normal"}={}){this.buffer=e,this.cutoff=r,this.radius=n;const s=this.size=t+4*e,u=this._createCanvas(s),c=this.ctx=u.getContext("2d",{willReadFrequently:!0});c.font=`${a} ${o} ${t}px ${i}`,c.textBaseline="alphabetic",c.textAlign="left",c.fillStyle="black",this.gridOuter=new Float64Array(s*s),this.gridInner=new Float64Array(s*s),this.f=new Float64Array(s),this.z=new Float64Array(s+1),this.v=new Uint16Array(s)}_createCanvas(t){const e=document.createElement("canvas");return e.width=e.height=t,e}draw(t){const{width:e,actualBoundingBoxAscent:n,actualBoundingBoxDescent:r,actualBoundingBoxLeft:i,actualBoundingBoxRight:o}=this.ctx.measureText(t),a=Math.ceil(n),s=Math.min(this.size-this.buffer,Math.ceil(o-i)),u=Math.min(this.size-this.buffer,a+Math.ceil(r)),c=s+2*this.buffer,l=u+2*this.buffer,h=Math.max(c*l,0),f=new Uint8ClampedArray(h),p={data:f,width:c,height:l,glyphWidth:s,glyphHeight:u,glyphTop:a,glyphLeft:0,glyphAdvance:e};if(0===s||0===u)return p;const{ctx:d,buffer:A,gridInner:g,gridOuter:m}=this;d.clearRect(A,A,s,u),d.fillText(t,A,A+a);const y=d.getImageData(A,A,s,u);m.fill(x,0,h),g.fill(0,0,h);for(let t=0;t<u;t++)for(let e=0;e<s;e++){const n=y.data[4*(t*s+e)+3]/255;if(0===n)continue;const r=(t+A)*c+e+A;if(1===n)m[r]=0,g[r]=x;else{const t=.5-n;m[r]=t>0?t*t:0,g[r]=t<0?t*t:0}}E(m,0,0,c,l,c,this.f,this.v,this.z),E(g,A,A,s,u,c,this.f,this.v,this.z);for(let t=0;t<h;t++){const e=Math.sqrt(m[t])-Math.sqrt(g[t]);f[t]=Math.round(255-255*(e/this.radius+this.cutoff))}return p}}function E(t,e,n,r,i,o,a,s,u){for(let c=e;c<e+r;c++)O(t,n*o+c,o,i,a,s,u);for(let c=n;c<n+i;c++)O(t,c*o+e,1,r,a,s,u)}function O(t,e,n,r,i,o,a){o[0]=0,a[0]=-x,a[1]=x,i[0]=t[e];for(let s=1,u=0,c=0;s<r;s++){i[s]=t[e+s*n];const r=s*s;do{const t=o[u];c=(i[s]-i[t]+r-t*t)/(s-t)/2}while(c<=a[u]&&--u>-1);u++,o[u]=s,a[u]=c,a[u+1]=x}for(let s=0,u=0;s<r;s++){for(;a[u+1]<s;)u++;const r=o[u],c=s-r;t[e+s*n]=i[r]+c*c}}var S=n(21);function T(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return C(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return C(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function C(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var P=[];function M(t,e,n,r){for(var i=0,o=e;o<n;o++){var a;i+=(null===(a=r[t[o]])||void 0===a?void 0:a.layoutWidth)||0}return i}function I(t,e,n,r,i,o){for(var a=e,s=0,u=e;u<n;u++){var c=M(t,u,u+1,i);s+c>r&&(a<u&&o.push(u),a=u,s=0),s+=c}return s}function B(t,e,n,r,i,o){for(var a=e,s=e,u=e,c=0,l=e;l<n;l++)if(" "===t[l]?u=l+1:" "!==t[l+1]&&l+1!==n||(u=l+1),u>s){var h=M(t,s,u,i);c+h>r&&(a<s&&(o.push(s),a=s,c=0),h>r&&(h=I(t,s,u,r,i,o),a=o[o.length-1])),s=u,c+=h}return c}function R(t,e,n,r){var i=arguments.length>4&&void 0!==arguments[4]?arguments[4]:0,o=arguments.length>5?arguments[5]:void 0;void 0===o&&(o=t.length);var a=[];return"break-all"===e?I(t,i,o,n,r,a):B(t,i,o,n,r,a),a}function k(t,e,n,r,i,o){for(var a=0,s=0,u=e;u<n;u++){var c=t[u],l=r[c];l?(s||(s=l.layoutHeight),i[u]=a+l.layoutWidth/2,a+=l.layoutWidth):(S.a.warn("Missing character: ".concat(c," (").concat(c.codePointAt(0),")"))(),i[u]=a,a+=32)}o[0]=a,o[1]=s}function D(t,e,n,r,i){for(var o=Array.from(t),a=o.length,s=new Array(a),u=new Array(a),c=new Array(a),l=("break-word"===n||"break-all"===n)&&isFinite(r)&&r>0,h=[0,0],f=[0,0],p=0,d=0,A=0,g=0;g<=a;g++){var m=o[g];if("\n"!==m&&g!==a||(A=g),A>d){for(var y=l?R(o,n,r,i,d,A):P,v=0;v<=y.length;v++){var _=0===v?d:y[v-1],b=v<y.length?y[v]:A;k(o,_,b,i,s,f);for(var x=_;x<b;x++){var w,E=(null===(w=i[o[x]])||void 0===w?void 0:w.layoutOffsetY)||0;u[x]=p+f[1]/2+E,c[x]=f[0]}p+=f[1]*e,h[0]=Math.max(h[0],f[0])}d=A}"\n"===m&&(s[d]=0,u[d]=0,c[d]=0,d++)}return h[1]=p,{x:s,y:u,rowWidth:c,size:h}}var L=function(){function t(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:5;a()(this,t),y()(this,"_cache",{}),y()(this,"_order",[]),this.limit=e}return u()(t,[{key:"get",value:function(t){var e=this._cache[t];return e&&(this._deleteOrder(t),this._appendOrder(t)),e}},{key:"set",value:function(t,e){this._cache[t]?(this.delete(t),this._cache[t]=e,this._appendOrder(t)):(Object.keys(this._cache).length===this.limit&&this.delete(this._order[0]),this._cache[t]=e,this._appendOrder(t))}},{key:"delete",value:function(t){this._cache[t]&&(delete this._cache[t],this._deleteOrder(t))}},{key:"_deleteOrder",value:function(t){var e=this._order.indexOf(t);e>=0&&this._order.splice(e,1)}},{key:"_appendOrder",value:function(t){this._order.push(t)}}]),t}();function j(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return F(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return F(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function F(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function z(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function U(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?z(Object(n),!0).forEach((function(e){y()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):z(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var N={fontFamily:"Monaco, monospace",fontWeight:"normal",characterSet:function(){for(var t=[],e=32;e<128;e++)t.push(String.fromCharCode(e));return t}(),fontSize:64,buffer:4,sdf:!1,cutoff:.25,radius:12,smoothing:.1},G=new L(3);function V(t,e){var n;n="string"==typeof e?new Set(Array.from(e)):new Set(e);var r=G.get(t);if(!r)return n;for(var i in r.mapping)n.has(i)&&n.delete(i);return n}function H(t,e){for(var n=0;n<t.length;n++)e.data[4*n+3]=t[n]}function W(t,e,n,r){t.font="".concat(r," ").concat(n,"px ").concat(e),t.fillStyle="#000",t.textBaseline="alphabetic",t.textAlign="left"}var q=function(){function t(){a()(this,t),y()(this,"props",U({},N))}return u()(t,[{key:"texture",get:function(){return this._atlas}},{key:"mapping",get:function(){return this._atlas&&this._atlas.mapping}},{key:"scale",get:function(){var t=this.props,e=t.fontSize;return(1.2*e+2*t.buffer)/e}},{key:"setProps",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};Object.assign(this.props,t),this._key=this._getKey();var e=V(this._key,this.props.characterSet),n=G.get(this._key);if(n&&0===e.size)this._atlas!==n&&(this._atlas=n);else{var r=this._generateFontAtlas(e,n);this._atlas=r,G.set(this._key,r)}}},{key:"_generateFontAtlas",value:function(t,e){var n=this.props,r=n.fontFamily,i=n.fontWeight,o=n.fontSize,a=n.buffer,s=n.sdf,u=n.radius,c=n.cutoff,l=e&&e.data;l||((l=document.createElement("canvas")).width=1024);var h=l.getContext("2d");W(h,r,o,i);var f=function(t){var e,n,r=t.characterSet,i=t.getFontWidth,o=t.fontHeight,a=t.buffer,s=t.maxCanvasWidth,u=t.mapping,c=void 0===u?{}:u,l=t.xOffset,h=void 0===l?0:l,f=t.yOffset,p=void 0===f?0:f,d=0,A=h,g=o+2*a,m=T(r);try{for(m.s();!(e=m.n()).done;){var y=e.value;if(!c[y]){var v=i(y);A+v+2*a>s&&(A=0,d++),c[y]={x:A+a,y:p+d*g+a,width:v,height:g,layoutWidth:v,layoutHeight:o},A+=v+2*a}}}catch(t){m.e(t)}finally{m.f()}return{mapping:c,xOffset:A,yOffset:p+d*g,canvasHeight:(n=p+(d+1)*g,Math.pow(2,Math.ceil(Math.log2(n))))}}(U({getFontWidth:function(t){return h.measureText(t).width},fontHeight:1.2*o,buffer:a,characterSet:t,maxCanvasWidth:1024},e&&{mapping:e.mapping,xOffset:e.xOffset,yOffset:e.yOffset})),p=f.mapping,d=f.canvasHeight,A=f.xOffset,g=f.yOffset;if(l.height!==d){var m=h.getImageData(0,0,l.width,l.height);l.height=d,h.putImageData(m,0,0)}if(W(h,r,o,i),s){var y,v=new w({fontSize:o,buffer:a,radius:u,cutoff:c,fontFamily:r,fontWeight:"".concat(i)}),_=j(t);try{for(_.s();!(y=_.n()).done;){var b=y.value,x=v.draw(b),E=x.data,O=x.width,S=x.height,C=x.glyphTop;p[b].width=O,p[b].layoutOffsetY=.9*o-C;var P=h.createImageData(O,S);H(E,P),h.putImageData(P,p[b].x,p[b].y)}}catch(t){_.e(t)}finally{_.f()}}else{var M,I=j(t);try{for(I.s();!(M=I.n()).done;){var B=M.value;h.fillText(B,p[B].x,p[B].y+a+.9*o)}}catch(t){I.e(t)}finally{I.f()}}return{xOffset:A,yOffset:g,mapping:p,data:l,width:l.width,height:l.height}}},{key:"_getKey",value:function(){var t=this.props,e=t.fontFamily,n=t.fontWeight,r=t.fontSize,i=t.buffer,o=t.sdf,a=t.radius,s=t.cutoff;return o?"".concat(e," ").concat(n," ").concat(r," ").concat(i," ").concat(a," ").concat(s):"".concat(e," ").concat(n," ").concat(r," ").concat(i)}}]),t}(),X=n(169);function Z(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return J(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return J(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function J(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function Q(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function K(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Q(Object(n),!0).forEach((function(e){y()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Q(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function Y(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=g()(t);if(e){var i=g()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return d()(this,n)}}n.d(e,"a",(function(){return rt}));var $={start:1,middle:0,end:-1},tt={top:1,center:0,bottom:-1},et=[0,0,0,255],nt={billboard:!0,sizeScale:1,sizeUnits:"pixels",sizeMinPixels:0,sizeMaxPixels:Number.MAX_SAFE_INTEGER,background:!1,getBackgroundColor:{type:"accessor",value:[255,255,255,255]},getBorderColor:{type:"accessor",value:et},getBorderWidth:{type:"accessor",value:0},backgroundPadding:{type:"array",value:[0,0,0,0]},characterSet:{type:"object",value:N.characterSet},fontFamily:N.fontFamily,fontWeight:N.fontWeight,lineHeight:1,outlineWidth:{type:"number",value:0,min:0},outlineColor:{type:"color",value:et},fontSettings:{},wordBreak:"break-word",maxWidth:{type:"number",value:-1},getText:{type:"accessor",value:function(t){return t.text}},getPosition:{type:"accessor",value:function(t){return t.position}},getColor:{type:"accessor",value:et},getSize:{type:"accessor",value:32},getAngle:{type:"accessor",value:0},getTextAnchor:{type:"accessor",value:"middle"},getAlignmentBaseline:{type:"accessor",value:"center"},getPixelOffset:{type:"accessor",value:[0,0]},backgroundColor:{deprecatedFor:["background","getBackgroundColor"]}},rt=function(t){f()(n,t);var e=Y(n);function n(){var t;a()(this,n);for(var r=arguments.length,o=new Array(r),s=0;s<r;s++)o[s]=arguments[s];return t=e.call.apply(e,[this].concat(o)),y()(l()(t),"getBoundingRect",(function(e,n){var r=t.state.fontAtlasManager.mapping,o=t.state.getText,a=t.props,s=a.wordBreak,u=a.maxWidth,c=a.lineHeight,l=a.getTextAnchor,h=a.getAlignmentBaseline,f=D(o(e,n)||"",c,s,u,r),p=i()(f.size,2),d=p[0],A=p[1];return[($["function"==typeof l?l(e,n):l]-1)*d/2,(tt["function"==typeof h?h(e,n):h]-1)*A/2,d,A]})),y()(l()(t),"getIconOffsets",(function(e,n){for(var r=t.state.fontAtlasManager.mapping,o=t.state.getText,a=t.props,s=a.wordBreak,u=a.maxWidth,c=a.lineHeight,l=a.getTextAnchor,h=a.getAlignmentBaseline,f=D(o(e,n)||"",c,s,u,r),p=f.x,d=f.y,A=f.rowWidth,g=i()(f.size,2),m=g[0],y=g[1],v=$["function"==typeof l?l(e,n):l],_=tt["function"==typeof h?h(e,n):h],b=p.length,x=new Array(2*b),w=0,E=0;E<b;E++){var O=(1-v)*(m-A[E])/2;x[w++]=(v-1)*m/2+O+p[E],x[w++]=(_-1)*y/2+d[E]}return x})),t}return u()(n,[{key:"initializeState",value:function(){this.state={styleVersion:0,fontAtlasManager:new q}}},{key:"updateState",value:function(t){var e=t.props,n=t.oldProps,r=t.changeFlags;(r.dataChanged||r.updateTriggersChanged&&(r.updateTriggersChanged.all||r.updateTriggersChanged.getText))&&this._updateText(),(this._updateFontAtlas()||e.lineHeight!==n.lineHeight||e.wordBreak!==n.wordBreak||e.maxWidth!==n.maxWidth)&&this.setState({styleVersion:this.state.styleVersion+1})}},{key:"getPickingInfo",value:function(t){var e=t.info;return e.object=e.index>=0?this.props.data[e.index]:null,e}},{key:"_updateFontAtlas",value:function(){var t=this.props,e=t.fontSettings,n=t.fontFamily,r=t.fontWeight,i=this.state,o=i.fontAtlasManager,a=i.characterSet,s=K(K({},e),{},{characterSet:a,fontFamily:n,fontWeight:r});if(!o.mapping)return o.setProps(s),!0;for(var u in s)if(s[u]!==o.props[u])return o.setProps(s),!0;return!1}},{key:"_updateText",value:function(){var t,e,n=this.props,r=n.data,i=n.characterSet,o=null===(t=r.attributes)||void 0===t?void 0:t.getText,a=this.props.getText,s=r.startIndices,u="auto"===i&&new Set;if(o&&s){var c=function(t){var e=t.value,n=t.length,r=t.stride,i=t.offset,o=t.startIndices,a=t.characterSet,s=e.BYTES_PER_ELEMENT,u=r?r/s:1,c=i?i/s:0,l=o[n]||Math.ceil((e.length-c)/u),h=a&&new Set,f=new Array(n),p=e;if(u>1||c>0){p=new(0,e.constructor)(l);for(var d=0;d<l;d++)p[d]=e[d*u+c]}for(var A=0;A<n;A++){var g=o[A],m=o[A+1]||l,y=p.subarray(g,m);f[A]=String.fromCodePoint.apply(null,y),h&&y.forEach(h.add,h)}if(h){var v,_=T(h);try{for(_.s();!(v=_.n()).done;){var b=v.value;a.add(String.fromCodePoint(b))}}catch(t){_.e(t)}finally{_.f()}}return{texts:f,characterCount:l}}(K(K({},ArrayBuffer.isView(o)?{value:o}:o),{},{length:r.length,startIndices:s,characterSet:u})),l=c.texts;e=c.characterCount,a=function(t,e){var n=e.index;return l[n]}}else{var h=Object(v.a)(r),f=h.iterable,p=h.objectInfo;s=[0],e=0;var d,A=Z(f);try{for(A.s();!(d=A.n()).done;){var g=d.value;p.index++;var m=Array.from(a(g,p)||"");u&&m.forEach(u.add,u),e+=m.length,s.push(e)}}catch(t){A.e(t)}finally{A.f()}}this.setState({getText:a,startIndices:s,numInstances:e,characterSet:u||i})}},{key:"renderLayers",value:function(){var t=this.state,e=t.startIndices,n=t.numInstances,r=t.getText,i=t.fontAtlasManager,o=i.scale,a=i.texture,s=i.mapping,u=t.styleVersion,c=this.props,l=c.data,h=c._dataDiff,f=c.getPosition,p=c.getColor,d=c.getSize,A=c.getAngle,g=c.getPixelOffset,m=c.getBackgroundColor,y=c.getBorderColor,v=c.getBorderWidth,_=c.backgroundPadding,x=c.background,w=c.billboard,E=c.fontSettings,O=c.outlineWidth,S=c.outlineColor,T=c.sizeScale,C=c.sizeUnits,P=c.sizeMinPixels,M=c.sizeMaxPixels,I=c.transitions,B=c.updateTriggers,R=this.getSubLayerClass("characters",b.a),k=this.getSubLayerClass("background",X.a);return[x&&new k({getFillColor:m,getLineColor:y,getLineWidth:v,padding:_,getPosition:f,getSize:d,getAngle:A,getPixelOffset:g,billboard:w,sizeScale:T/this.state.fontAtlasManager.props.fontSize,sizeUnits:C,sizeMinPixels:P,sizeMaxPixels:M,transitions:I&&{getPosition:I.getPosition,getAngle:I.getAngle,getSize:I.getSize,getFillColor:I.getBackgroundColor,getLineColor:I.getBorderColor,getLineWidth:I.getBorderWidth,getPixelOffset:I.getPixelOffset}},this.getSubLayerProps({id:"background",updateTriggers:{getPosition:B.getPosition,getAngle:B.getAngle,getSize:B.getSize,getFillColor:B.getBackgroundColor,getLineColor:B.getBorderColor,getLineWidth:B.getBorderWidth,getPixelOffset:B.getPixelOffset,getBoundingRect:{getText:B.getText,getTextAnchor:B.getTextAnchor,getAlignmentBaseline:B.getAlignmentBaseline,styleVersion:u}}}),{data:l.attributes&&l.attributes.background?{length:l.length,attributes:l.attributes.background}:l,_dataDiff:h,autoHighlight:!1,getBoundingRect:this.getBoundingRect}),new R({sdf:E.sdf,smoothing:Number.isFinite(E.smoothing)?E.smoothing:N.smoothing,outlineWidth:O/(E.radius||N.radius),outlineColor:S,iconAtlas:a,iconMapping:s,getPosition:f,getColor:p,getSize:d,getAngle:A,getPixelOffset:g,billboard:w,sizeScale:T*o,sizeUnits:C,sizeMinPixels:P*o,sizeMaxPixels:M*o,transitions:I&&{getPosition:I.getPosition,getAngle:I.getAngle,getColor:I.getColor,getSize:I.getSize,getPixelOffset:I.getPixelOffset}},this.getSubLayerProps({id:"characters",updateTriggers:{getIcon:B.getText,getPosition:B.getPosition,getAngle:B.getAngle,getColor:B.getColor,getSize:B.getSize,getPixelOffset:B.getPixelOffset,getIconOffsets:{getText:B.getText,getTextAnchor:B.getTextAnchor,getAlignmentBaseline:B.getAlignmentBaseline,styleVersion:u}}}),{data:l,_dataDiff:h,startIndices:e,numInstances:n,getIconOffsets:this.getIconOffsets,getIcon:r})]}}],[{key:"fontAtlasCacheLimit",set:function(t){!function(t){S.a.assert(Number.isFinite(t)&&t>=3,"Invalid cache limit"),G=new L(t)}(t)}}]),n}(_.a);y()(rt,"defaultProps",nt),y()(rt,"layerName","TextLayer")},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(8),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(217),y=n(235),v=n(234),_=n(12),b=n(164),x=n(7),w=n(251),E=n(189),O=n(186),S=n(21),T=n(47),C=n(60),P=n(37);function M(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function I(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?M(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):M(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function B(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}var R=function(t){l()(n,t);var e=B(n);function n(t){i()(this,n);var r=t.id,o=void 0===r?Object(T.c)("column-geometry"):r,a=function(t){var e=t.radius,n=t.height,r=void 0===n?1:n,i=t.nradial,o=void 0===i?10:i,a=t.vertices;a&&(S.a.assert(a.length>=o),a=a.flatMap((function(t){return[t[0],t[1]]})),Object(P.h)(a,P.a.COUNTER_CLOCKWISE));var s=r>0,u=o+1,c=s?3*u+1:o,l=2*Math.PI/o,h=new Uint16Array(s?3*o*2:0),f=new Float32Array(3*c),p=new Float32Array(3*c),d=0;if(s){for(var A=0;A<u;A++)for(var g=A*l,m=A%o,y=Math.sin(g),v=Math.cos(g),_=0;_<2;_++)f[d+0]=a?a[2*m]:v*e,f[d+1]=a?a[2*m+1]:y*e,f[d+2]=(.5-_)*r,p[d+0]=a?a[2*m]:v,p[d+1]=a?a[2*m+1]:y,d+=3;f[d+0]=f[d-3],f[d+1]=f[d-2],f[d+2]=f[d-1],d+=3}for(var b=s?0:1;b<u;b++){var x=Math.floor(b/2)*Math.sign(.5-b%2),w=x*l,E=(x+o)%o,O=Math.sin(w),T=Math.cos(w);f[d+0]=a?a[2*E]:T*e,f[d+1]=a?a[2*E+1]:O*e,f[d+2]=r/2,p[d+2]=1,d+=3}if(s)for(var C=0,M=0;M<o;M++)h[C++]=2*M+0,h[C++]=2*M+2,h[C++]=2*M+0,h[C++]=2*M+1,h[C++]=2*M+1,h[C++]=2*M+3;return{indices:h,attributes:{POSITION:{size:3,value:f},NORMAL:{size:3,value:p}}}}(t),s=a.indices,u=a.attributes;return e.call(this,I(I({},t),{},{id:o,indices:s,attributes:u}))}return n}(C.a);function k(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function D(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?k(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):k(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function L(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}n.d(e,"a",(function(){return z}));var j=[0,0,0,255],F={diskResolution:{type:"number",min:4,value:20},vertices:null,radius:{type:"number",min:0,value:1e3},angle:{type:"number",value:0},offset:{type:"array",value:[0,0]},coverage:{type:"number",min:0,max:1,value:1},elevationScale:{type:"number",min:0,value:1},radiusUnits:"meters",lineWidthUnits:"meters",lineWidthScale:1,lineWidthMinPixels:0,lineWidthMaxPixels:Number.MAX_SAFE_INTEGER,extruded:!0,wireframe:!1,filled:!0,stroked:!1,getPosition:{type:"accessor",value:function(t){return t.position}},getFillColor:{type:"accessor",value:j},getLineColor:{type:"accessor",value:j},getLineWidth:{type:"accessor",value:1},getElevation:{type:"accessor",value:1e3},material:!0,getColor:{deprecatedFor:["getFillColor","getLineColor"]}},z=function(t){l()(n,t);var e=L(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(){var t=this.context.gl,e=!Object(x.j)(t),r={},i=this.props.flatShading&&Object(w.b)(t,E.a.GLSL_DERIVATIVES);return i&&(r.FLAT_SHADING=1),u()(d()(n.prototype),"getShaders",this).call(this,{vs:"#version 300 es\n\n#define SHADER_NAME column-layer-vertex-shader\n\nin vec3 positions;\nin vec3 normals;\n\nin vec3 instancePositions;\nin float instanceElevations;\nin vec3 instancePositions64Low;\nin vec4 instanceFillColors;\nin vec4 instanceLineColors;\nin float instanceStrokeWidths;\n\nin vec3 instancePickingColors;\n\n// Custom uniforms\nuniform float opacity;\nuniform float radius;\nuniform float angle;\nuniform vec2 offset;\nuniform bool extruded;\nuniform bool stroked;\nuniform bool isStroke;\nuniform float coverage;\nuniform float elevationScale;\nuniform float edgeDistance;\nuniform float widthScale;\nuniform float widthMinPixels;\nuniform float widthMaxPixels;\nuniform int radiusUnits;\nuniform int widthUnits;\n\n// Result\nout vec4 vColor;\n#ifdef FLAT_SHADING\nout vec4 position_commonspace;\n#endif\n\nvoid main(void) {\n  geometry.worldPosition = instancePositions;\n\n  vec4 color = isStroke ? instanceLineColors : instanceFillColors;\n  // rotate primitive position and normal\n  mat2 rotationMatrix = mat2(cos(angle), sin(angle), -sin(angle), cos(angle));\n\n  // calculate elevation, if 3d not enabled set to 0\n  // cylindar gemoetry height are between -1.0 to 1.0, transform it to between 0, 1\n  float elevation = 0.0;\n  // calculate stroke offset\n  float strokeOffsetRatio = 1.0;\n\n  if (extruded) {\n    elevation = instanceElevations * (positions.z + 1.0) / 2.0 * elevationScale;\n  } else if (stroked) {\n    float widthPixels = clamp(\n      project_size_to_pixel(instanceStrokeWidths * widthScale, widthUnits),\n      widthMinPixels, widthMaxPixels) / 2.0;\n    float halfOffset = project_pixel_size(widthPixels) / project_size(edgeDistance * coverage * radius);\n    if (isStroke) {\n      strokeOffsetRatio -= sign(positions.z) * halfOffset;\n    } else {\n      strokeOffsetRatio -= halfOffset;\n    }\n  }\n\n  // if alpha == 0.0 or z < 0.0, do not render element\n  float shouldRender = float(color.a > 0.0 && instanceElevations >= 0.0);\n  float dotRadius = radius * coverage * shouldRender;\n\n  geometry.pickingColor = instancePickingColors;\n\n  // project center of column\n  vec3 centroidPosition = vec3(instancePositions.xy, instancePositions.z + elevation);\n  vec3 centroidPosition64Low = instancePositions64Low;\n  vec2 offset = (rotationMatrix * positions.xy * strokeOffsetRatio + offset) * dotRadius;\n  if (radiusUnits == UNIT_METERS) {\n    offset = project_size(offset);\n  }\n  vec3 pos = vec3(offset, 0.);\n  DECKGL_FILTER_SIZE(pos, geometry);\n\n  gl_Position = project_position_to_clipspace(centroidPosition, centroidPosition64Low, pos, geometry.position);\n  geometry.normal = project_normal(vec3(rotationMatrix * normals.xy, normals.z));\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  // Light calculations\n  if (extruded && !isStroke) {\n#ifdef FLAT_SHADING\n    position_commonspace = geometry.position;\n    vColor = vec4(color.rgb, color.a * opacity);\n#else\n    vec3 lightColor = lighting_getLightColor(color.rgb, project_uCameraPosition, geometry.position.xyz, geometry.normal);\n    vColor = vec4(lightColor, color.a * opacity);\n#endif\n  } else {\n    vColor = vec4(color.rgb, color.a * opacity);\n  }\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n",fs:"#version 300 es\n#define SHADER_NAME column-layer-fragment-shader\n\nprecision highp float;\n\nuniform vec3 project_uCameraPosition;\nuniform bool extruded;\nuniform bool isStroke;\n\nout vec4 fragColor;\n\nin vec4 vColor;\n#ifdef FLAT_SHADING\nin vec4 position_commonspace;\n#endif\n\nvoid main(void) {\n  fragColor = vColor;\n#ifdef FLAT_SHADING\n  if (extruded && !isStroke && !picking_uActive) {\n    vec3 normal = normalize(cross(dFdx(position_commonspace.xyz), dFdy(position_commonspace.xyz)));\n    fragColor.rgb = lighting_getLightColor(vColor.rgb, project_uCameraPosition, position_commonspace.xyz, normal);\n  }\n#endif\n  DECKGL_FILTER_COLOR(fragColor, geometry);\n}\n",defines:r,transpileToGLSL100:e,modules:[m.a,i?y.b:y.a,v.a]})}},{key:"initializeState",value:function(){this.getAttributeManager().addInstanced({instancePositions:{size:3,type:5130,fp64:this.use64bitPositions(),transition:!0,accessor:"getPosition"},instanceElevations:{size:1,transition:!0,accessor:"getElevation"},instanceFillColors:{size:this.props.colorFormat.length,type:5121,normalized:!0,transition:!0,accessor:"getFillColor",defaultValue:j},instanceLineColors:{size:this.props.colorFormat.length,type:5121,normalized:!0,transition:!0,accessor:"getLineColor",defaultValue:j},instanceStrokeWidths:{size:1,accessor:"getLineWidth",transition:!0}})}},{key:"updateState",value:function(t){u()(d()(n.prototype),"updateState",this).call(this,t);var e=t.props,r=t.oldProps,i=t.changeFlags.extensionsChanged||e.flatShading!==r.flatShading;if(i){var o,a=this.context.gl;null===(o=this.state.model)||void 0===o||o.delete(),this.state.model=this._getModel(a),this.getAttributeManager().invalidateAll()}(i||e.diskResolution!==r.diskResolution||e.vertices!==r.vertices||(e.extruded||e.stroked)!==(r.extruded||r.stroked))&&this._updateGeometry(e)}},{key:"getGeometry",value:function(t,e,n){var r=new R({radius:1,height:n?2:0,vertices:e,nradial:t}),i=0;if(e)for(var o=0;o<t;o++){var a=e[o];i+=Math.sqrt(a[0]*a[0]+a[1]*a[1])/t}else i=1;return this.setState({edgeDistance:Math.cos(Math.PI/t)*i}),r}},{key:"_getModel",value:function(t){return new O.a(t,D(D({},this.getShaders()),{},{id:this.props.id,isInstanced:!0}))}},{key:"_updateGeometry",value:function(t){var e=t.diskResolution,n=t.vertices,r=t.extruded,i=t.stroked,o=this.getGeometry(e,n,r||i);this.setState({fillVertexCount:o.attributes.POSITION.value.length/3,wireframeVertexCount:o.indices.value.length}),this.state.model.setProps({geometry:o})}},{key:"draw",value:function(t){var e=t.uniforms,n=this.props,r=n.lineWidthUnits,i=n.lineWidthScale,o=n.lineWidthMinPixels,a=n.lineWidthMaxPixels,s=n.radiusUnits,u=n.elevationScale,c=n.extruded,l=n.filled,h=n.stroked,f=n.wireframe,p=n.offset,d=n.coverage,A=n.radius,g=n.angle,m=this.state,y=m.model,v=m.fillVertexCount,b=m.wireframeVertexCount,x=m.edgeDistance;y.setUniforms(e).setUniforms({radius:A,angle:g/180*Math.PI,offset:p,extruded:c,stroked:h,coverage:d,elevationScale:u,edgeDistance:x,radiusUnits:_.e[s],widthUnits:_.e[r],widthScale:i,widthMinPixels:o,widthMaxPixels:a}),c&&f&&(y.setProps({isIndexed:!0}),y.setVertexCount(b).setDrawMode(1).setUniforms({isStroke:!0}).draw()),l&&(y.setProps({isIndexed:!1}),y.setVertexCount(v).setDrawMode(5).setUniforms({isStroke:!1}).draw()),!c&&h&&(y.setProps({isIndexed:!1}),y.setVertexCount(2*v/3).setDrawMode(5).setUniforms({isStroke:!0}).draw())}}]),n}(b.a);g()(z,"layerName","ColumnLayer"),g()(z,"defaultProps",F)},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(8),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(217),y=n(234),v=n(12),_=n(164),b=n(186),x=n(60);function w(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function E(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?w(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):w(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function O(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}n.d(e,"a",(function(){return C}));var S=[0,0,0,255],T={radiusUnits:"meters",radiusScale:{type:"number",min:0,value:1},radiusMinPixels:{type:"number",min:0,value:0},radiusMaxPixels:{type:"number",min:0,value:Number.MAX_SAFE_INTEGER},lineWidthUnits:"meters",lineWidthScale:{type:"number",min:0,value:1},lineWidthMinPixels:{type:"number",min:0,value:0},lineWidthMaxPixels:{type:"number",min:0,value:Number.MAX_SAFE_INTEGER},stroked:!1,filled:!0,billboard:!1,antialiasing:!0,getPosition:{type:"accessor",value:function(t){return t.position}},getRadius:{type:"accessor",value:1},getFillColor:{type:"accessor",value:S},getLineColor:{type:"accessor",value:S},getLineWidth:{type:"accessor",value:1},strokeWidth:{deprecatedFor:"getLineWidth"},outline:{deprecatedFor:"stroked"},getColor:{deprecatedFor:["getFillColor","getLineColor"]}},C=function(t){l()(n,t);var e=O(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(){return u()(d()(n.prototype),"getShaders",this).call(this,{vs:"#define SHADER_NAME scatterplot-layer-vertex-shader\n\nattribute vec3 positions;\n\nattribute vec3 instancePositions;\nattribute vec3 instancePositions64Low;\nattribute float instanceRadius;\nattribute float instanceLineWidths;\nattribute vec4 instanceFillColors;\nattribute vec4 instanceLineColors;\nattribute vec3 instancePickingColors;\n\nuniform float opacity;\nuniform float radiusScale;\nuniform float radiusMinPixels;\nuniform float radiusMaxPixels;\nuniform float lineWidthScale;\nuniform float lineWidthMinPixels;\nuniform float lineWidthMaxPixels;\nuniform float stroked;\nuniform bool filled;\nuniform bool antialiasing;\nuniform bool billboard;\nuniform int radiusUnits;\nuniform int lineWidthUnits;\n\nvarying vec4 vFillColor;\nvarying vec4 vLineColor;\nvarying vec2 unitPosition;\nvarying float innerUnitRadius;\nvarying float outerRadiusPixels;\n\n\nvoid main(void) {\n  geometry.worldPosition = instancePositions;\n\n  // Multiply out radius and clamp to limits\n  outerRadiusPixels = clamp(\n    project_size_to_pixel(radiusScale * instanceRadius, radiusUnits),\n    radiusMinPixels, radiusMaxPixels\n  );\n  \n  // Multiply out line width and clamp to limits\n  float lineWidthPixels = clamp(\n    project_size_to_pixel(lineWidthScale * instanceLineWidths, lineWidthUnits),\n    lineWidthMinPixels, lineWidthMaxPixels\n  );\n\n  // outer radius needs to offset by half stroke width\n  outerRadiusPixels += stroked * lineWidthPixels / 2.0;\n\n  // Expand geometry to accomodate edge smoothing\n  float edgePadding = antialiasing ? (outerRadiusPixels + SMOOTH_EDGE_RADIUS) / outerRadiusPixels : 1.0;\n\n  // position on the containing square in [-1, 1] space\n  unitPosition = edgePadding * positions.xy;\n  geometry.uv = unitPosition;\n  geometry.pickingColor = instancePickingColors;\n\n  innerUnitRadius = 1.0 - stroked * lineWidthPixels / outerRadiusPixels;\n  \n  if (billboard) {\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, vec3(0.0), geometry.position);\n    vec3 offset = edgePadding * positions * outerRadiusPixels;\n    DECKGL_FILTER_SIZE(offset, geometry);\n    gl_Position.xy += project_pixel_size_to_clipspace(offset.xy);\n  } else {\n    vec3 offset = edgePadding * positions * project_pixel_size(outerRadiusPixels);\n    DECKGL_FILTER_SIZE(offset, geometry);\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, offset, geometry.position);\n  }\n\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  // Apply opacity to instance color, or return instance picking color\n  vFillColor = vec4(instanceFillColors.rgb, instanceFillColors.a * opacity);\n  DECKGL_FILTER_COLOR(vFillColor, geometry);\n  vLineColor = vec4(instanceLineColors.rgb, instanceLineColors.a * opacity);\n  DECKGL_FILTER_COLOR(vLineColor, geometry);\n}\n",fs:"#define SHADER_NAME scatterplot-layer-fragment-shader\n\nprecision highp float;\n\nuniform bool filled;\nuniform float stroked;\nuniform bool antialiasing;\n\nvarying vec4 vFillColor;\nvarying vec4 vLineColor;\nvarying vec2 unitPosition;\nvarying float innerUnitRadius;\nvarying float outerRadiusPixels;\n\nvoid main(void) {\n  geometry.uv = unitPosition;\n\n  float distToCenter = length(unitPosition) * outerRadiusPixels;\n  float inCircle = antialiasing ? \n    smoothedge(distToCenter, outerRadiusPixels) : \n    step(distToCenter, outerRadiusPixels);\n\n  if (inCircle == 0.0) {\n    discard;\n  }\n\n  if (stroked > 0.5) {\n    float isLine = antialiasing ? \n      smoothedge(innerUnitRadius * outerRadiusPixels, distToCenter) :\n      step(innerUnitRadius * outerRadiusPixels, distToCenter);\n\n    if (filled) {\n      gl_FragColor = mix(vFillColor, vLineColor, isLine);\n    } else {\n      if (isLine == 0.0) {\n        discard;\n      }\n      gl_FragColor = vec4(vLineColor.rgb, vLineColor.a * isLine);\n    }\n  } else if (filled) {\n    gl_FragColor = vFillColor;\n  } else {\n    discard;\n  }\n\n  gl_FragColor.a *= inCircle;\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n",modules:[m.a,y.a]})}},{key:"initializeState",value:function(){this.getAttributeManager().addInstanced({instancePositions:{size:3,type:5130,fp64:this.use64bitPositions(),transition:!0,accessor:"getPosition"},instanceRadius:{size:1,transition:!0,accessor:"getRadius",defaultValue:1},instanceFillColors:{size:this.props.colorFormat.length,transition:!0,normalized:!0,type:5121,accessor:"getFillColor",defaultValue:[0,0,0,255]},instanceLineColors:{size:this.props.colorFormat.length,transition:!0,normalized:!0,type:5121,accessor:"getLineColor",defaultValue:[0,0,0,255]},instanceLineWidths:{size:1,transition:!0,accessor:"getLineWidth",defaultValue:1}})}},{key:"updateState",value:function(t){if(u()(d()(n.prototype),"updateState",this).call(this,t),t.changeFlags.extensionsChanged){var e,r=this.context.gl;null===(e=this.state.model)||void 0===e||e.delete(),this.state.model=this._getModel(r),this.getAttributeManager().invalidateAll()}}},{key:"draw",value:function(t){var e=t.uniforms,n=this.props,r=n.radiusUnits,i=n.radiusScale,o=n.radiusMinPixels,a=n.radiusMaxPixels,s=n.stroked,u=n.filled,c=n.billboard,l=n.antialiasing,h=n.lineWidthUnits,f=n.lineWidthScale,p=n.lineWidthMinPixels,d=n.lineWidthMaxPixels;this.state.model.setUniforms(e).setUniforms({stroked:s?1:0,filled:u,billboard:c,antialiasing:l,radiusUnits:v.e[r],radiusScale:i,radiusMinPixels:o,radiusMaxPixels:a,lineWidthUnits:v.e[h],lineWidthScale:f,lineWidthMinPixels:p,lineWidthMaxPixels:d}).draw()}},{key:"_getModel",value:function(t){return new b.a(t,E(E({},this.getShaders()),{},{id:this.props.id,geometry:new x.a({drawMode:6,vertexCount:4,attributes:{positions:{size:3,value:new Float32Array([-1,-1,0,1,-1,0,1,1,0,-1,1,0])}}}),isInstanced:!0}))}}]),n}(_.a);g()(C,"defaultProps",T),g()(C,"layerName","ScatterplotLayer")},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(8),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(217),y=n(234),v=n(12),_=n(164),b=n(186),x=n(60);function w(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function E(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?w(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):w(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function O(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}n.d(e,"a",(function(){return T}));var S={billboard:!0,sizeScale:1,sizeUnits:"pixels",sizeMinPixels:0,sizeMaxPixels:Number.MAX_SAFE_INTEGER,padding:{type:"array",value:[0,0,0,0]},getPosition:{type:"accessor",value:function(t){return t.position}},getSize:{type:"accessor",value:1},getAngle:{type:"accessor",value:0},getPixelOffset:{type:"accessor",value:[0,0]},getBoundingRect:{type:"accessor",value:[0,0,0,0]},getFillColor:{type:"accessor",value:[0,0,0,255]},getLineColor:{type:"accessor",value:[0,0,0,255]},getLineWidth:{type:"accessor",value:1}},T=function(t){l()(n,t);var e=O(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(){return u()(d()(n.prototype),"getShaders",this).call(this,{vs:"#define SHADER_NAME text-background-layer-vertex-shader\n\nattribute vec2 positions;\n\nattribute vec3 instancePositions;\nattribute vec3 instancePositions64Low;\nattribute vec4 instanceRects;\nattribute float instanceSizes;\nattribute float instanceAngles;\nattribute vec2 instancePixelOffsets;\nattribute float instanceLineWidths;\nattribute vec4 instanceFillColors;\nattribute vec4 instanceLineColors;\nattribute vec3 instancePickingColors;\n\nuniform bool billboard;\nuniform float opacity;\nuniform float sizeScale;\nuniform float sizeMinPixels;\nuniform float sizeMaxPixels;\nuniform vec4 padding;\nuniform int sizeUnits;\n\nvarying vec4 vFillColor;\nvarying vec4 vLineColor;\nvarying float vLineWidth;\nvarying vec2 uv;\nvarying vec2 dimensions;\n\nvec2 rotate_by_angle(vec2 vertex, float angle) {\n  float angle_radian = radians(angle);\n  float cos_angle = cos(angle_radian);\n  float sin_angle = sin(angle_radian);\n  mat2 rotationMatrix = mat2(cos_angle, -sin_angle, sin_angle, cos_angle);\n  return rotationMatrix * vertex;\n}\n\nvoid main(void) {\n  geometry.worldPosition = instancePositions;\n  geometry.uv = positions;\n  geometry.pickingColor = instancePickingColors;\n  uv = positions;\n  vLineWidth = instanceLineWidths;\n\n  // convert size in meters to pixels, then scaled and clamp\n\n  // project meters to pixels and clamp to limits\n  float sizePixels = clamp(\n    project_size_to_pixel(instanceSizes * sizeScale, sizeUnits),\n    sizeMinPixels, sizeMaxPixels\n  );\n\n  dimensions = instanceRects.zw * sizePixels + padding.xy + padding.zw;\n\n  vec2 pixelOffset = (positions * instanceRects.zw + instanceRects.xy) * sizePixels + mix(-padding.xy, padding.zw, positions);\n  pixelOffset = rotate_by_angle(pixelOffset, instanceAngles);\n  pixelOffset += instancePixelOffsets;\n  pixelOffset.y *= -1.0;\n\n  if (billboard)  {\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, vec3(0.0), geometry.position);\n    vec3 offset = vec3(pixelOffset, 0.0);\n    DECKGL_FILTER_SIZE(offset, geometry);\n    gl_Position.xy += project_pixel_size_to_clipspace(offset.xy);\n  } else {\n    vec3 offset_common = vec3(project_pixel_size(pixelOffset), 0.0);\n    DECKGL_FILTER_SIZE(offset_common, geometry);\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, offset_common, geometry.position);\n  }\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  // Apply opacity to instance color, or return instance picking color\n  vFillColor = vec4(instanceFillColors.rgb, instanceFillColors.a * opacity);\n  DECKGL_FILTER_COLOR(vFillColor, geometry);\n  vLineColor = vec4(instanceLineColors.rgb, instanceLineColors.a * opacity);\n  DECKGL_FILTER_COLOR(vLineColor, geometry);\n}\n",fs:"#define SHADER_NAME text-background-layer-fragment-shader\n\nprecision highp float;\n\nuniform bool stroked;\n\nvarying vec4 vFillColor;\nvarying vec4 vLineColor;\nvarying float vLineWidth;\nvarying vec2 uv;\nvarying vec2 dimensions;\n\nvoid main(void) {\n  geometry.uv = uv;\n\n  vec2 pixelPosition = uv * dimensions;\n  if (stroked) {\n    float distToEdge = min(\n      min(pixelPosition.x, dimensions.x - pixelPosition.x),\n      min(pixelPosition.y, dimensions.y - pixelPosition.y)\n    );\n    float isBorder = smoothedge(distToEdge, vLineWidth);\n    gl_FragColor = mix(vFillColor, vLineColor, isBorder);\n  } else {\n    gl_FragColor = vFillColor;\n  }\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n",modules:[m.a,y.a]})}},{key:"initializeState",value:function(){this.getAttributeManager().addInstanced({instancePositions:{size:3,type:5130,fp64:this.use64bitPositions(),transition:!0,accessor:"getPosition"},instanceSizes:{size:1,transition:!0,accessor:"getSize",defaultValue:1},instanceAngles:{size:1,transition:!0,accessor:"getAngle"},instanceRects:{size:4,accessor:"getBoundingRect"},instancePixelOffsets:{size:2,transition:!0,accessor:"getPixelOffset"},instanceFillColors:{size:4,transition:!0,normalized:!0,type:5121,accessor:"getFillColor",defaultValue:[0,0,0,255]},instanceLineColors:{size:4,transition:!0,normalized:!0,type:5121,accessor:"getLineColor",defaultValue:[0,0,0,255]},instanceLineWidths:{size:1,transition:!0,accessor:"getLineWidth",defaultValue:1}})}},{key:"updateState",value:function(t){if(u()(d()(n.prototype),"updateState",this).call(this,t),t.changeFlags.extensionsChanged){var e,r=this.context.gl;null===(e=this.state.model)||void 0===e||e.delete(),this.state.model=this._getModel(r),this.getAttributeManager().invalidateAll()}}},{key:"draw",value:function(t){var e=t.uniforms,n=this.props,r=n.billboard,i=n.sizeScale,o=n.sizeUnits,a=n.sizeMinPixels,s=n.sizeMaxPixels,u=n.getLineWidth,c=this.props.padding;c.length<4&&(c=[c[0],c[1],c[0],c[1]]),this.state.model.setUniforms(e).setUniforms({billboard:r,stroked:Boolean(u),padding:c,sizeUnits:v.e[o],sizeScale:i,sizeMinPixels:a,sizeMaxPixels:s}).draw()}},{key:"_getModel",value:function(t){return new b.a(t,E(E({},this.getShaders()),{},{id:this.props.id,geometry:new x.a({drawMode:6,vertexCount:4,attributes:{positions:{size:2,value:new Float32Array([0,0,1,0,1,1,0,1])}}}),isInstanced:!0}))}}]),n}(_.a);g()(T,"defaultProps",S),g()(T,"layerName","TextBackgroundLayer")},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(0),u=n.n(s),c=n(315),l=n(24),h=n(21),f=n(32),p=n(67),d=n(76),A=n(215);function g(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return m(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return m(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function m(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var y=function(){function t(e,n,r){i()(this,t),u()(this,"_loadCount",0),u()(this,"_subscribers",new Set),this.id=e,this.context=r,this.setData(n)}return a()(t,[{key:"subscribe",value:function(t){this._subscribers.add(t)}},{key:"unsubscribe",value:function(t){this._subscribers.delete(t)}},{key:"inUse",value:function(){return this._subscribers.size>0}},{key:"delete",value:function(){}},{key:"getData",value:function(){var t=this;return this.isLoaded?this._error?Promise.reject(this._error):this._content:this._loader.then((function(){return t.getData()}))}},{key:"setData",value:function(t,e){var n=this;if(t!==this._data||e){this._data=t;var r=++this._loadCount,i=t;"string"==typeof t&&(i=Object(A.a)(t)),i instanceof Promise?(this.isLoaded=!1,this._loader=i.then((function(t){n._loadCount===r&&(n.isLoaded=!0,n._error=void 0,n._content=t)})).catch((function(t){n._loadCount===r&&(n.isLoaded=!0,n._error=t||!0)}))):(this.isLoaded=!0,this._error=void 0,this._content=t);var o,a=g(this._subscribers);try{for(a.s();!(o=a.n()).done;){o.value.onChange(this.getData())}}catch(t){a.e(t)}finally{a.f()}}}}]),t}(),v=function(){function t(e){var n=e.gl,r=e.protocol;i()(this,t),this.protocol=r||"resource://",this._context={gl:n,resourceManager:this},this._resources={},this._consumers={},this._pruneRequest=null}return a()(t,[{key:"contains",value:function(t){return!!t.startsWith(this.protocol)||t in this._resources}},{key:"add",value:function(t){var e=t.resourceId,n=t.data,r=t.forceUpdate,i=void 0!==r&&r,o=t.persistent,a=void 0===o||o,s=this._resources[e];s?s.setData(n,i):(s=new y(e,n,this._context),this._resources[e]=s),s.persistent=a}},{key:"remove",value:function(t){var e=this._resources[t];e&&(e.delete(),delete this._resources[t])}},{key:"unsubscribe",value:function(t){var e=t.consumerId,n=this._consumers[e];if(n){for(var r in n){var i=n[r],o=this._resources[i.resourceId];o&&o.unsubscribe(i)}delete this._consumers[e],this.prune()}}},{key:"subscribe",value:function(t){var e=t.resourceId,n=t.onChange,r=t.consumerId,i=t.requestId,o=void 0===i?"default":i,a=this._resources,s=this.protocol;e.startsWith(s)&&(a[e=e.replace(s,"")]||this.add({resourceId:e,data:null,persistent:!1}));var u=a[e];if(this._track(r,o,u,n),u)return u.getData()}},{key:"prune",value:function(){var t=this;this._pruneRequest||(this._pruneRequest=setTimeout((function(){return t._prune()}),0))}},{key:"finalize",value:function(){for(var t in this._resources)this._resources[t].delete()}},{key:"_track",value:function(t,e,n,r){var i=this._consumers,o=i[t]=i[t]||{},a=o[e]||{},s=a.resourceId&&this._resources[a.resourceId];s&&(s.unsubscribe(a),this.prune()),n&&(o[e]=a,a.onChange=r,a.resourceId=n.id,n.subscribe(a))}},{key:"_prune",value:function(){this._pruneRequest=null;for(var t=0,e=Object.keys(this._resources);t<e.length;t++){var n=e[t],r=this._resources[n];r.persistent||r.inUse()||(r.delete(),delete this._resources[n])}}}]),t}(),_=n(42),b=n(157);function x(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return w(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return w(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function w(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}n.d(e,"a",(function(){return E}));var E=function(){function t(e){var n=this,r=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},o=r.deck,a=r.stats,s=r.viewport,l=r.timeline;i()(this,t),u()(this,"_lastRenderedLayers",[]),u()(this,"_needsRedraw",!1),u()(this,"_needsUpdate",!1),u()(this,"_nextLayers",null),u()(this,"_debug",!1),u()(this,"activateViewport",(function(t){Object(f.a)("layerManager.activateViewport",n,t),t&&(n.context.viewport=t)})),this.layers=[],this.resourceManager=new v({gl:e,protocol:"deck://"}),this.context={mousePosition:null,userData:{},layerManager:this,gl:e,deck:o,programManager:e&&Object(b.a)(e),stats:a||new d.a({id:"deck.gl"}),viewport:s||new _.a({id:"DEFAULT-INITIAL-VIEWPORT"}),timeline:l||new c.a,resourceManager:this.resourceManager,onError:void 0},Object.seal(this)}return a()(t,[{key:"finalize",value:function(){this.resourceManager.finalize();var t,e=x(this.layers);try{for(e.s();!(t=e.n()).done;){var n=t.value;this._finalizeLayer(n)}}catch(t){e.e(t)}finally{e.f()}}},{key:"needsRedraw",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{clearRedrawFlags:!1},e=this._needsRedraw;t.clearRedrawFlags&&(this._needsRedraw=!1);var n,r=x(this.layers);try{for(r.s();!(n=r.n()).done;){var i=n.value,o=i.getNeedsRedraw(t);e=e||o}}catch(t){r.e(t)}finally{r.f()}return e}},{key:"needsUpdate",value:function(){return this._nextLayers&&this._nextLayers!==this._lastRenderedLayers?"layers changed":this._needsUpdate}},{key:"setNeedsRedraw",value:function(t){this._needsRedraw=this._needsRedraw||t}},{key:"setNeedsUpdate",value:function(t){this._needsUpdate=this._needsUpdate||t}},{key:"getLayers",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},e=t.layerIds;return e?this.layers.filter((function(t){return e.find((function(e){return 0===t.id.indexOf(e)}))})):this.layers}},{key:"setProps",value:function(t){"debug"in t&&(this._debug=t.debug),"userData"in t&&(this.context.userData=t.userData),"layers"in t&&(this._nextLayers=t.layers),"onError"in t&&(this.context.onError=t.onError)}},{key:"setLayers",value:function(t,e){Object(f.a)("layerManager.setLayers",this,e,t),this._lastRenderedLayers=t;var n,r=Object(p.b)(t,Boolean),i=x(r);try{for(i.s();!(n=i.n()).done;){n.value.context=this.context}}catch(t){i.e(t)}finally{i.f()}this._updateLayers(this.layers,r)}},{key:"updateLayers",value:function(){var t=this.needsUpdate();t&&(this.setNeedsRedraw("updating layers: ".concat(t)),this.setLayers(this._nextLayers||this._lastRenderedLayers,t)),this._nextLayers=null}},{key:"_handleError",value:function(t,e,n){n.raiseError(e,"".concat(t," of ").concat(n))}},{key:"_updateLayers",value:function(t,e){var n,r={},i=x(t);try{for(i.s();!(n=i.n()).done;){var o=n.value;r[o.id]?h.a.warn("Multiple old layers with same id ".concat(o.id))():r[o.id]=o}}catch(t){i.e(t)}finally{i.f()}var a=[];this._updateSublayersRecursively(e,r,a),this._finalizeOldLayers(r);for(var s=!1,u=0,c=a;u<c.length;u++){var l=c[u];if(l.hasUniformTransition()){s="Uniform transition in ".concat(l);break}}this._needsUpdate=s,this.layers=a}},{key:"_updateSublayersRecursively",value:function(t,e,n){var r,i=x(t);try{for(i.s();!(r=i.n()).done;){var o=r.value;o.context=this.context;var a=e[o.id];null===a&&h.a.warn("Multiple new layers with same id ".concat(o.id))(),e[o.id]=null;var s=null;try{this._debug&&a!==o&&o.validateProps(),a?(this._transferLayerState(a,o),this._updateLayer(o)):this._initializeLayer(o),n.push(o),s=o.isComposite?o.getSubLayers():null}catch(t){this._handleError("matching",t,o)}s&&this._updateSublayersRecursively(s,e,n)}}catch(t){i.e(t)}finally{i.f()}}},{key:"_finalizeOldLayers",value:function(t){for(var e in t){var n=t[e];n&&this._finalizeLayer(n)}}},{key:"_initializeLayer",value:function(t){try{t._initialize(),t.lifecycle=l.e.INITIALIZED}catch(e){this._handleError("initialization",e,t)}}},{key:"_transferLayerState",value:function(t,e){e._transferState(t),e.lifecycle=l.e.MATCHED,e!==t&&(t.lifecycle=l.e.AWAITING_GC)}},{key:"_updateLayer",value:function(t){try{t._update()}catch(e){this._handleError("update",e,t)}}},{key:"_finalizeLayer",value:function(t){this._needsRedraw=this._needsRedraw||"finalized ".concat(t),t.lifecycle=l.e.AWAITING_FINALIZATION;try{t._finalize(),t.lifecycle=l.e.FINALIZED}catch(e){this._handleError("finalization",e,t)}}}]),t}()},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(8),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(21),y=n(118);function v(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function _(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?v(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):v(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function b(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}n.d(e,"a",(function(){return w}));var x=[],w=function(t){l()(n,t);var e=b(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(){return _(_({},u()(d()(n.prototype),"getShaders",this).call(this)),{},{fs:"#define SHADER_NAME multi-icon-layer-fragment-shader\n\nprecision highp float;\n\nuniform float opacity;\nuniform sampler2D iconsTexture;\nuniform float gamma;\nuniform bool sdf;\nuniform float alphaCutoff;\nuniform float buffer;\nuniform float outlineBuffer;\nuniform vec4 outlineColor;\n\nvarying vec4 vColor;\nvarying vec2 vTextureCoords;\nvarying vec2 uv;\n\nvoid main(void) {\n  geometry.uv = uv;\n\n  if (!picking_uActive) {\n    float alpha = texture2D(iconsTexture, vTextureCoords).a;\n    vec4 color = vColor;\n\n    // if enable sdf (signed distance fields)\n    if (sdf) {\n      float distance = alpha;\n      alpha = smoothstep(buffer - gamma, buffer + gamma, distance);\n\n      if (outlineBuffer > 0.0) {\n        float inFill = alpha;\n        float inBorder = smoothstep(outlineBuffer - gamma, outlineBuffer + gamma, distance);\n        color = mix(outlineColor, vColor, inFill);\n        alpha = inBorder;\n      }\n    }\n\n    // Take the global opacity and the alpha from color into account for the alpha component\n    float a = alpha * color.a;\n    \n    if (a < alphaCutoff) {\n      discard;\n    }\n\n    gl_FragColor = vec4(color.rgb, a * opacity);\n  }\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n"})}},{key:"initializeState",value:function(){var t=this;u()(d()(n.prototype),"initializeState",this).call(this),this.getAttributeManager().addInstanced({instanceOffsets:{size:2,accessor:"getIconOffsets"},instancePickingColors:{type:5121,size:3,accessor:function(e,n){var r=n.index,i=n.target;return t.encodePickingColor(r,i)}}})}},{key:"updateState",value:function(t){u()(d()(n.prototype),"updateState",this).call(this,t);var e=t.props,r=t.oldProps,i=e.outlineColor;i!==r.outlineColor&&((i=i.map((function(t){return t/255})))[3]=Number.isFinite(i[3])?i[3]:1,this.setState({outlineColor:i})),!e.sdf&&e.outlineWidth&&m.a.warn("".concat(this.id,": fontSettings.sdf is required to render outline"))()}},{key:"draw",value:function(t){var e=this.props,r=e.sdf,i=e.smoothing,o=e.outlineWidth,a=this.state.outlineColor,s=o?Math.max(i,.75*(1-o)):-1;(t.uniforms=_(_({},t.uniforms),{},{buffer:.75,outlineBuffer:s,gamma:i,sdf:Boolean(r),outlineColor:a}),u()(d()(n.prototype),"draw",this).call(this,t),r&&o)&&(this.state.iconManager.getTexture()&&this.state.model.draw({uniforms:{outlineBuffer:.75}}))}},{key:"getInstanceOffset",value:function(t){var e=this;return t?Array.from(t).flatMap((function(t){return u()(d()(n.prototype),"getInstanceOffset",e).call(e,t)})):x}},{key:"getInstanceColorMode",value:function(t){return 1}},{key:"getInstanceIconFrame",value:function(t){var e=this;return t?Array.from(t).flatMap((function(t){return u()(d()(n.prototype),"getInstanceIconFrame",e).call(e,t)})):x}}]),n}(y.a);g()(w,"defaultProps",{getIconOffsets:{type:"accessor",value:function(t){return t.offsets}},alphaCutoff:.001,smoothing:.1,outlineWidth:0,outlineColor:{type:"color",value:[0,0,0,255]}}),g()(w,"layerName","MultiIconLayer")},function(t,e,n){"use strict";var r=n(0),i=n.n(r),o=n(3),a=n.n(o),s=n(4),u=n.n(s),c=n(32),l=n(5),h=n.n(l),f=n(6),p=n.n(f),d=n(1),A=n.n(d),g=n(12);function m(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=A()(t);if(e){var i=A()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return p()(this,n)}}var y=function(t){h()(n,t);var e=m(n);function n(){return a()(this,n),e.apply(this,arguments)}return u()(n,[{key:"shouldDrawLayer",value:function(t){return t.props.operation===g.c.DRAW}}]),n}(n(73).a),v=n(180),_=n(74);function b(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return x(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return x(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function x(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function w(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function E(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?w(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):w(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}n.d(e,"a",(function(){return O}));var O=function(){function t(e){a()(this,t),this.gl=e,this.layerFilter=null,this.drawPickingColors=!1,this.drawLayersPass=new y(e),this.pickLayersPass=new v.a(e),this.renderCount=0,this._needsRedraw="Initial render",this.renderBuffers=[],this.lastPostProcessEffect=null}return u()(t,[{key:"setProps",value:function(t){"layerFilter"in t&&this.layerFilter!==t.layerFilter&&(this.layerFilter=t.layerFilter,this._needsRedraw="layerFilter changed"),"drawPickingColors"in t&&this.drawPickingColors!==t.drawPickingColors&&(this.drawPickingColors=t.drawPickingColors,this._needsRedraw="drawPickingColors changed")}},{key:"renderLayers",value:function(t){var e=this.drawPickingColors?this.pickLayersPass:this.drawLayersPass;t.layerFilter=t.layerFilter||this.layerFilter,t.effects=t.effects||[],t.target=t.target||_.a.getDefaultFramebuffer(this.gl),this._preRender(t.effects,t);var n=this.lastPostProcessEffect?this.renderBuffers[0]:t.target,r=e.render(E(E({},t),{},{target:n}));this._postRender(t.effects,t),this.renderCount++,Object(c.a)("deckRenderer.renderLayers",this,r,t)}},{key:"needsRedraw",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{clearRedrawFlags:!1},e=this._needsRedraw;return t.clearRedrawFlags&&(this._needsRedraw=!1),e}},{key:"finalize",value:function(){var t,e=this.renderBuffers,n=b(e);try{for(n.s();!(t=n.n()).done;){t.value.delete()}}catch(t){n.e(t)}finally{n.f()}e.length=0}},{key:"_preRender",value:function(t,e){var n,r=null,i=b(t);try{for(i.s();!(n=i.n()).done;){var o=n.value;o.preRender(this.gl,e),o.postRender&&(r=o)}}catch(t){i.e(t)}finally{i.f()}r&&this._resizeRenderBuffers(),this.lastPostProcessEffect=r}},{key:"_resizeRenderBuffers",value:function(){var t=this.renderBuffers;0===t.length&&t.push(new _.a(this.gl),new _.a(this.gl));var e,n=b(t);try{for(n.s();!(e=n.n()).done;){e.value.resize()}}catch(t){n.e(t)}finally{n.f()}}},{key:"_postRender",value:function(t,e){var n,r=this.renderBuffers,i={inputBuffer:r[0],swapBuffer:r[1],target:null},o=b(t);try{for(o.s();!(n=o.n()).done;){var a=n.value;if(a.postRender){if(a===this.lastPostProcessEffect){i.target=e.target,a.postRender(this.gl,i);break}var s=a.postRender(this.gl,i);i.inputBuffer=s,i.swapBuffer=s===r[0]?r[1]:r[0]}}}catch(t){o.e(t)}finally{o.f()}}}]),t}()},function(t,e,n){"use strict";n.d(e,"a",(function(){return d}));var r=n(28),i=n.n(r),o=n(0),a=n.n(o),s=n(3),u=n.n(s),c=n(4),l=n.n(c);function h(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function f(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?h(Object(n),!0).forEach((function(e){a()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):h(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var p={onIninitialize:function(t){return t},onFinalize:function(t){return t},onMessage:null},d=function(){function t(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:"Transport";u()(this,t),this.name=e,this._messageQueue=[],this.userData={}}return l()(t,[{key:"getRootDOMElement",value:function(){return"undefined"!=typeof document?document.body:null}},{key:"sendJSONMessage",value:function(){console.error("Back-channel not implemented for this transport")}},{key:"sendBinaryMessage",value:function(){console.error("Back-channel not implemented for this transport")}},{key:"_initialize",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},e=f({transport:this},t);p.onInitialize(e)}},{key:"_finalize",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},e=f({transport:this},t);p.onFinalize(e),this._destroyed=!0}},{key:"_messageReceived",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};t=f({transport:this},t),console.debug("Delivering transport message",t),p.onMessage(t)}}],[{key:"setCallbacks",value:function(t){var e=t.onInitialize,n=t.onFinalize,r=t.onMessage;e&&(p.onInitialize=e),n&&(p.onFinalize=n),r&&(p.onMessage=r)}},{key:"_stringifyJSONSafe",value:function(t){var e=new Set;return JSON.stringify(t,(function(t,n){if("object"===i()(n)&&null!==n){if(e.has(n))try{return JSON.parse(JSON.stringify(n))}catch(t){return}e.add(n)}return n}))}}]),t}()},function(t,e,n){var r=n(214);t.exports=function(t,e,n){return(e=r(e))in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){"use strict";(function(t){function r(e){if("undefined"!=typeof window&&"object"==typeof window.process&&"renderer"===window.process.type)return!0;if(void 0!==t&&"object"==typeof t.versions&&Boolean(t.versions.electron))return!0;const n="object"==typeof navigator&&"string"==typeof navigator.userAgent&&navigator.userAgent,r=e||n;return!!(r&&r.indexOf("Electron")>=0)}n.d(e,"a",(function(){return r}))}).call(this,n(44))},function(t,e,n){"use strict";n.d(e,"a",(function(){return i}));var r=n(7);function i(t,e,n,i){const o="See luma.gl ".concat(n," Upgrade Guide at https://luma.gl/docs/upgrade-guide"),a=Object.getPrototypeOf(t);i.forEach(t=>{a.methodName||(a[t]=()=>{throw r.k.removed("Calling removed method ".concat(e,".").concat(t,": "),o)(),new Error(t)})})}},function(t,e,n){"use strict";n.d(e,"a",(function(){return a}));var r=n(122),i=n(23),o=n(13);class a extends r.a{toString(){let t="[";if(o.b.printRowMajor){t+="row-major:";for(let e=0;e<this.RANK;++e)for(let n=0;n<this.RANK;++n)t+=" ".concat(this[n*this.RANK+e])}else{t+="column-major:";for(let e=0;e<this.ELEMENTS;++e)t+=" ".concat(this[e])}return t+="]",t}getElementIndex(t,e){return e*this.RANK+t}getElement(t,e){return this[e*this.RANK+t]}setElement(t,e,n){return this[e*this.RANK+t]=Object(i.a)(n),this}getColumn(t,e=new Array(this.RANK).fill(-0)){const n=t*this.RANK;for(let t=0;t<this.RANK;++t)e[t]=this[n+t];return e}setColumn(t,e){const n=t*this.RANK;for(let t=0;t<this.RANK;++t)this[n+t]=e[t];return this}}},function(t,e,n){"use strict";n.d(e,"a",(function(){return h}));var r=n(0),i=n.n(r),o=n(3),a=n.n(o),s=n(4),u=n.n(s);function c(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function l(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?c(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):c(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var h=function(){function t(e){var n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{id:"pass"};a()(this,t);var r=n.id;this.id=r,this.gl=e,this.props=l({},n)}return u()(t,[{key:"setProps",value:function(t){Object.assign(this.props,t)}},{key:"render",value:function(t){}},{key:"cleanup",value:function(){}}]),t}()},function(t,e,n){"use strict";function r(t,e=!0,n){const o=n||new Set;if(t){if(i(t))o.add(t);else if(i(t.buffer))o.add(t.buffer);else if(ArrayBuffer.isView(t));else if(e&&"object"==typeof t)for(const n in t)r(t[n],e,o)}else;return void 0===n?Array.from(o):[]}function i(t){return!!t&&(t instanceof ArrayBuffer||("undefined"!=typeof MessagePort&&t instanceof MessagePort||("undefined"!=typeof ImageBitmap&&t instanceof ImageBitmap||"undefined"!=typeof OffscreenCanvas&&t instanceof OffscreenCanvas)))}function o(t){if(null===t)return{};const e=Object.assign({},t);return Object.keys(e).forEach(n=>{"object"!=typeof t[n]||ArrayBuffer.isView(t[n])?"function"==typeof e[n]||e[n]instanceof RegExp?e[n]={}:e[n]=t[n]:e[n]=o(t[n])}),e}n.d(e,"a",(function(){return r})),n.d(e,"b",(function(){return o}))},function(t,e,n){"use strict";n.d(e,"a",(function(){return T}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(27),u=n.n(s),c=n(8),l=n.n(c),h=n(5),f=n.n(h),p=n(6),d=n.n(p),A=n(1),g=n.n(A),m=n(0),y=n.n(m),v=n(73),_=n(7),b=n(12),x=n(21);function w(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function E(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?w(Object(n),!0).forEach((function(e){y()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):w(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function O(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=g()(t);if(e){var i=g()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return d()(this,n)}}var S={blendFunc:[1,0,32771,0],blendEquation:32774},T=function(t){f()(n,t);var e=O(n);function n(){var t;i()(this,n);for(var r=arguments.length,o=new Array(r),a=0;a<r;a++)o[a]=arguments[a];return t=e.call.apply(e,[this].concat(o)),y()(u()(t),"_colors",null),t}return a()(n,[{key:"render",value:function(t){return t.pickingFBO?this._drawPickingBuffer(t):l()(g()(n.prototype),"render",this).call(this,t)}},{key:"_drawPickingBuffer",value:function(t){var e=this,r=t.layers,i=t.layerFilter,o=t.views,a=t.viewports,s=t.onViewportActive,u=t.pickingFBO,c=t.deviceRect,h=c.x,f=c.y,p=c.width,d=c.height,A=t.cullRect,m=t.effects,y=t.pass,v=void 0===y?"picking":y,b=t.pickZ,x=this.gl;this.pickZ=b;var w=b?null:{byLayer:new Map,byAlpha:[]};this._colors=w;var O=Object(_.o)(x,E(E({scissorTest:!0,scissor:[h,f,p,d],clearColor:[0,0,0,0],depthMask:!0,depthTest:!0,depthRange:[0,1],colorMask:[!0,!0,!0,!0]},S),{},{blend:!b}),(function(){return l()(g()(n.prototype),"render",e).call(e,{target:u,layers:r,layerFilter:i,views:o,viewports:a,onViewportActive:s,cullRect:A,effects:null==m?void 0:m.filter((function(t){return t.useInPicking})),pass:v})}));return this._colors=null,{decodePickingColor:w&&C.bind(null,w),stats:O}}},{key:"shouldDrawLayer",value:function(t){return t.props.pickable&&t.props.operation===b.c.DRAW}},{key:"getModuleParameters",value:function(){return{pickingActive:1,pickingAttribute:this.pickZ,lightSources:{}}}},{key:"getLayerParameters",value:function(t,e,n){var r=E({},t.props.parameters);return this._colors?(Object.assign(r,S),r.blend=!0,r.blendColor=function(t,e,n){var r,i=t.byLayer,o=t.byAlpha,a=i.get(e);a?(a.viewports.push(n),r=a.a):(r=i.size+1)<=255?(a={a:r,layer:e,viewports:[n]},i.set(e,a),o[r]=a):(x.a.warn("Too many pickable layers, only picking the first 255")(),r=0);return[0,0,0,r/255]}(this._colors,t,n)):r.blend=!1,r}}]),n}(v.a);function C(t,e){var n=t.byAlpha[e[3]];return n&&{pickedLayer:n.layer,pickedViewports:n.viewports,pickedObjectIndex:n.layer.decodePickingColor(e)}}},function(t,e,n){"use strict";n.d(e,"a",(function(){return r}));function r(t){const e=i(t);return function(t){const e=i(t);if(!(e.byteLength>=24&&2303741511===e.getUint32(0,!1)))return null;return{mimeType:"image/png",width:e.getUint32(16,!1),height:e.getUint32(20,!1)}}(e)||function(t){const e=i(t);if(!(e.byteLength>=3&&65496===e.getUint16(0,!1)&&255===e.getUint8(2)))return null;const{tableMarkers:n,sofMarkers:r}=function(){const t=new Set([65499,65476,65484,65501,65534]);for(let e=65504;e<65520;++e)t.add(e);const e=new Set([65472,65473,65474,65475,65477,65478,65479,65481,65482,65483,65485,65486,65487,65502]);return{tableMarkers:t,sofMarkers:e}}();let o=2;for(;o+9<e.byteLength;){const t=e.getUint16(o,!1);if(r.has(t))return{mimeType:"image/jpeg",height:e.getUint16(o+5,!1),width:e.getUint16(o+7,!1)};if(!n.has(t))return null;o+=2,o+=e.getUint16(o,!1)}return null}(e)||function(t){const e=i(t);if(!(e.byteLength>=10&&1195984440===e.getUint32(0,!1)))return null;return{mimeType:"image/gif",width:e.getUint16(6,!0),height:e.getUint16(8,!0)}}(e)||function(t){const e=i(t);if(!(e.byteLength>=14&&16973===e.getUint16(0,!1)&&e.getUint32(2,!0)===e.byteLength))return null;return{mimeType:"image/bmp",width:e.getUint32(18,!0),height:e.getUint32(22,!0)}}(e)}function i(t){if(t instanceof DataView)return t;if(ArrayBuffer.isView(t))return new DataView(t.buffer);if(t instanceof ArrayBuffer)return new DataView(t);throw new Error("toDataView")}},function(t,e,n){"use strict";function r(t){for(var e=t.data,n=t.getIndex,r=t.dataRange,i=t.replace,o=r.startRow,a=void 0===o?0:o,s=r.endRow,u=void 0===s?1/0:s,c=e.length,l=c,h=c,f=0;f<c;f++){var p=n(e[f]);if(l>f&&p>=a&&(l=f),p>=u){h=f;break}}for(var d=l,A=h-l!==i.length?e.slice(h):void 0,g=0;g<i.length;g++)e[d++]=i[g];if(A){for(var m=0;m<A.length;m++)e[d++]=A[m];e.length=d}return{startRow:l,endRow:l+i.length}}n.d(e,"a",(function(){return r}))},function(t,e,n){var r=n(281);t.exports=function(t,e){if(null==t)return{};var n,i,o=r(t,e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(t);for(i=0;i<a.length;i++)n=a[i],e.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(t,n)&&(o[n]=t[n])}return o}},function(t,e,n){"use strict";function r(t){var e=document.createElement("link");e.type="text/css",e.rel="stylesheet",e.href=t,document.getElementsByTagName("head")[0].appendChild(e)}function i(t,e){var n=document.createElement("div");return n.style.width=Number.isFinite(t)?"".concat(t,"px"):t,n.style.height="".concat(e,"px"),n.style.position="relative",n}n.d(e,"b",(function(){return r})),n.d(e,"a",(function(){return i}))},function(t,e,n){"use strict";const r={name:"Draco",id:"draco",module:"draco",shapes:["mesh"],version:"3.2.10",worker:!0,extensions:["drc"],mimeTypes:["application/octet-stream"],binary:!0,tests:["DRACO"],options:{draco:{decoderType:"object"==typeof WebAssembly?"wasm":"js",libraryPath:"libs/",extraAttributes:{},attributeNameEntry:void 0}}};var i=n(2);class o{constructor(t,e){Object(i.a)(this,"fields",void 0),Object(i.a)(this,"metadata",void 0),function(t,e){if(!t)throw new Error(e||"loader assertion failed.")}(Array.isArray(t)),function(t){const e={};for(const n of t)e[n.name]&&console.warn("Schema: duplicated field name",n.name,n),e[n.name]=!0}(t),this.fields=t,this.metadata=e||new Map}compareTo(t){if(this.metadata!==t.metadata)return!1;if(this.fields.length!==t.fields.length)return!1;for(let e=0;e<this.fields.length;++e)if(!this.fields[e].compareTo(t.fields[e]))return!1;return!0}select(...t){const e=Object.create(null);for(const n of t)e[n]=!0;const n=this.fields.filter(t=>e[t.name]);return new o(n,this.metadata)}selectAt(...t){const e=t.map(t=>this.fields[t]).filter(Boolean);return new o(e,this.metadata)}assign(t){let e,n=this.metadata;if(t instanceof o){const r=t;e=r.fields,n=a(a(new Map,this.metadata),r.metadata)}else e=t;const r=Object.create(null);for(const t of this.fields)r[t.name]=t;for(const t of e)r[t.name]=t;const i=Object.values(r);return new o(i,n)}}function a(t,e){return new Map([...t||new Map,...e||new Map])}class s{constructor(t,e,n=!1,r=new Map){Object(i.a)(this,"name",void 0),Object(i.a)(this,"type",void 0),Object(i.a)(this,"nullable",void 0),Object(i.a)(this,"metadata",void 0),this.name=t,this.type=e,this.nullable=n,this.metadata=r}get typeId(){return this.type&&this.type.typeId}clone(){return new s(this.name,this.type,this.nullable,this.metadata)}compareTo(t){return this.name===t.name&&this.type===t.type&&this.nullable===t.nullable&&this.metadata===t.metadata}toString(){return"".concat(this.type).concat(this.nullable?", nullable":"").concat(this.metadata?", metadata: ".concat(this.metadata):"")}}let u,c,l,h,f,p,d,A,g;!function(t){t[t.NONE=0]="NONE",t[t.Null=1]="Null",t[t.Int=2]="Int",t[t.Float=3]="Float",t[t.Binary=4]="Binary",t[t.Utf8=5]="Utf8",t[t.Bool=6]="Bool",t[t.Decimal=7]="Decimal",t[t.Date=8]="Date",t[t.Time=9]="Time",t[t.Timestamp=10]="Timestamp",t[t.Interval=11]="Interval",t[t.List=12]="List",t[t.Struct=13]="Struct",t[t.Union=14]="Union",t[t.FixedSizeBinary=15]="FixedSizeBinary",t[t.FixedSizeList=16]="FixedSizeList",t[t.Map=17]="Map",t[t.Dictionary=-1]="Dictionary",t[t.Int8=-2]="Int8",t[t.Int16=-3]="Int16",t[t.Int32=-4]="Int32",t[t.Int64=-5]="Int64",t[t.Uint8=-6]="Uint8",t[t.Uint16=-7]="Uint16",t[t.Uint32=-8]="Uint32",t[t.Uint64=-9]="Uint64",t[t.Float16=-10]="Float16",t[t.Float32=-11]="Float32",t[t.Float64=-12]="Float64",t[t.DateDay=-13]="DateDay",t[t.DateMillisecond=-14]="DateMillisecond",t[t.TimestampSecond=-15]="TimestampSecond",t[t.TimestampMillisecond=-16]="TimestampMillisecond",t[t.TimestampMicrosecond=-17]="TimestampMicrosecond",t[t.TimestampNanosecond=-18]="TimestampNanosecond",t[t.TimeSecond=-19]="TimeSecond",t[t.TimeMillisecond=-20]="TimeMillisecond",t[t.TimeMicrosecond=-21]="TimeMicrosecond",t[t.TimeNanosecond=-22]="TimeNanosecond",t[t.DenseUnion=-23]="DenseUnion",t[t.SparseUnion=-24]="SparseUnion",t[t.IntervalDayTime=-25]="IntervalDayTime",t[t.IntervalYearMonth=-26]="IntervalYearMonth"}(u||(u={}));class m{static isNull(t){return t&&t.typeId===u.Null}static isInt(t){return t&&t.typeId===u.Int}static isFloat(t){return t&&t.typeId===u.Float}static isBinary(t){return t&&t.typeId===u.Binary}static isUtf8(t){return t&&t.typeId===u.Utf8}static isBool(t){return t&&t.typeId===u.Bool}static isDecimal(t){return t&&t.typeId===u.Decimal}static isDate(t){return t&&t.typeId===u.Date}static isTime(t){return t&&t.typeId===u.Time}static isTimestamp(t){return t&&t.typeId===u.Timestamp}static isInterval(t){return t&&t.typeId===u.Interval}static isList(t){return t&&t.typeId===u.List}static isStruct(t){return t&&t.typeId===u.Struct}static isUnion(t){return t&&t.typeId===u.Union}static isFixedSizeBinary(t){return t&&t.typeId===u.FixedSizeBinary}static isFixedSizeList(t){return t&&t.typeId===u.FixedSizeList}static isMap(t){return t&&t.typeId===u.Map}static isDictionary(t){return t&&t.typeId===u.Dictionary}get typeId(){return u.NONE}compareTo(t){return this===t}}Symbol.toStringTag;Symbol.toStringTag;c=Symbol.toStringTag;class y extends m{constructor(t,e){super(),Object(i.a)(this,"isSigned",void 0),Object(i.a)(this,"bitWidth",void 0),this.isSigned=t,this.bitWidth=e}get typeId(){return u.Int}get[c](){return"Int"}toString(){return"".concat(this.isSigned?"I":"Ui","nt").concat(this.bitWidth)}}class v extends y{constructor(){super(!0,8)}}class _ extends y{constructor(){super(!0,16)}}class b extends y{constructor(){super(!0,32)}}class x extends y{constructor(){super(!1,8)}}class w extends y{constructor(){super(!1,16)}}class E extends y{constructor(){super(!1,32)}}const O=32,S=64;l=Symbol.toStringTag;class T extends m{constructor(t){super(),Object(i.a)(this,"precision",void 0),this.precision=t}get typeId(){return u.Float}get[l](){return"Float"}toString(){return"Float".concat(this.precision)}}class C extends T{constructor(){super(O)}}class P extends T{constructor(){super(S)}}Symbol.toStringTag;Symbol.toStringTag;h=Symbol.toStringTag;f=Symbol.toStringTag;p=Symbol.toStringTag;d=Symbol.toStringTag;A=Symbol.toStringTag;class M extends m{constructor(t,e){super(),Object(i.a)(this,"listSize",void 0),Object(i.a)(this,"children",void 0),this.listSize=t,this.children=[e]}get typeId(){return u.FixedSizeList}get valueType(){return this.children[0].type}get valueField(){return this.children[0]}get[A](){return"FixedSizeList"}toString(){return"FixedSizeList[".concat(this.listSize,"]<").concat(this.valueType,">")}}g=Symbol.toStringTag;function I(t,e,n){const r=function(t){switch(t.constructor){case Int8Array:return new v;case Uint8Array:return new x;case Int16Array:return new _;case Uint16Array:return new w;case Int32Array:return new b;case Uint32Array:return new E;case Float32Array:return new C;case Float64Array:return new P;default:throw new Error("array type not supported")}}(e.value),i=n||function(t){const e=new Map;"byteOffset"in t&&e.set("byteOffset",t.byteOffset.toString(10));"byteStride"in t&&e.set("byteStride",t.byteStride.toString(10));"normalized"in t&&e.set("normalized",t.normalized.toString());return e}(e);return new s(t,new M(e.size,new s("value",r)),!1,i)}function B(t,e,n){return I(t,e,n?R(n.metadata):void 0)}function R(t){const e=new Map;for(const n in t)e.set("".concat(n,".string"),JSON.stringify(t[n]));return e}const k={POSITION:"POSITION",NORMAL:"NORMAL",COLOR:"COLOR_0",TEX_COORD:"TEXCOORD_0"},D={1:Int8Array,2:Uint8Array,3:Int16Array,4:Uint16Array,5:Int32Array,6:Uint32Array,9:Float32Array};class L{constructor(t){Object(i.a)(this,"draco",void 0),Object(i.a)(this,"decoder",void 0),Object(i.a)(this,"metadataQuerier",void 0),this.draco=t,this.decoder=new this.draco.Decoder,this.metadataQuerier=new this.draco.MetadataQuerier}destroy(){this.draco.destroy(this.decoder),this.draco.destroy(this.metadataQuerier)}parseSync(t,e={}){const n=new this.draco.DecoderBuffer;n.Init(new Int8Array(t),t.byteLength),this._disableAttributeTransforms(e);const r=this.decoder.GetEncodedGeometryType(n),i=r===this.draco.TRIANGULAR_MESH?new this.draco.Mesh:new this.draco.PointCloud;try{let t;switch(r){case this.draco.TRIANGULAR_MESH:t=this.decoder.DecodeBufferToMesh(n,i);break;case this.draco.POINT_CLOUD:t=this.decoder.DecodeBufferToPointCloud(n,i);break;default:throw new Error("DRACO: Unknown geometry type.")}if(!t.ok()||!i.ptr){const e="DRACO decompression failed: ".concat(t.error_msg());throw new Error(e)}const a=this._getDracoLoaderData(i,r,e),s=this._getMeshData(i,a,e),u=function(t){let e=1/0,n=1/0,r=1/0,i=-1/0,o=-1/0,a=-1/0;const s=t.POSITION?t.POSITION.value:[],u=s&&s.length;for(let t=0;t<u;t+=3){const u=s[t],c=s[t+1],l=s[t+2];e=u<e?u:e,n=c<n?c:n,r=l<r?l:r,i=u>i?u:i,o=c>o?c:o,a=l>a?l:a}return[[e,n,r],[i,o,a]]}(s.attributes),c=function(t,e,n){const r=R(e.metadata),i=[],a=function(t){const e={};for(const n in t){const r=t[n];e[r.name||"undefined"]=r}return e}(e.attributes);for(const e in t){const n=B(e,t[e],a[e]);i.push(n)}if(n){const t=B("indices",n);i.push(t)}return new o(i,r)}(s.attributes,a,s.indices);return{loader:"draco",loaderData:a,header:{vertexCount:i.num_points(),boundingBox:u},...s,schema:c}}finally{this.draco.destroy(n),i&&this.draco.destroy(i)}}_getDracoLoaderData(t,e,n){const r=this._getTopLevelMetadata(t),i=this._getDracoAttributes(t,n);return{geometry_type:e,num_attributes:t.num_attributes(),num_points:t.num_points(),num_faces:t instanceof this.draco.Mesh?t.num_faces():0,metadata:r,attributes:i}}_getDracoAttributes(t,e){const n={};for(let r=0;r<t.num_attributes();r++){const i=this.decoder.GetAttribute(t,r),o=this._getAttributeMetadata(t,r);n[i.unique_id()]={unique_id:i.unique_id(),attribute_type:i.attribute_type(),data_type:i.data_type(),num_components:i.num_components(),byte_offset:i.byte_offset(),byte_stride:i.byte_stride(),normalized:i.normalized(),attribute_index:r,metadata:o};const a=this._getQuantizationTransform(i,e);a&&(n[i.unique_id()].quantization_transform=a);const s=this._getOctahedronTransform(i,e);s&&(n[i.unique_id()].octahedron_transform=s)}return n}_getMeshData(t,e,n){const r=this._getMeshAttributes(e,t,n);if(!r.POSITION)throw new Error("DRACO: No position attribute found.");if(t instanceof this.draco.Mesh)switch(n.topology){case"triangle-strip":return{topology:"triangle-strip",mode:4,attributes:r,indices:{value:this._getTriangleStripIndices(t),size:1}};case"triangle-list":default:return{topology:"triangle-list",mode:5,attributes:r,indices:{value:this._getTriangleListIndices(t),size:1}}}return{topology:"point-list",mode:0,attributes:r}}_getMeshAttributes(t,e,n){const r={};for(const i of Object.values(t.attributes)){const t=this._deduceAttributeName(i,n);i.name=t;const{value:o,size:a}=this._getAttributeValues(e,i);r[t]={value:o,size:a,byteOffset:i.byte_offset,byteStride:i.byte_stride,normalized:i.normalized}}return r}_getTriangleListIndices(t){const e=3*t.num_faces(),n=4*e,r=this.draco._malloc(n);try{return this.decoder.GetTrianglesUInt32Array(t,n,r),new Uint32Array(this.draco.HEAPF32.buffer,r,e).slice()}finally{this.draco._free(r)}}_getTriangleStripIndices(t){const e=new this.draco.DracoInt32Array;try{return this.decoder.GetTriangleStripsFromMesh(t,e),function(t){const e=t.size(),n=new Int32Array(e);for(let r=0;r<e;r++)n[r]=t.GetValue(r);return n}(e)}finally{this.draco.destroy(e)}}_getAttributeValues(t,e){const n=D[e.data_type],r=e.num_components,i=t.num_points()*r,o=i*n.BYTES_PER_ELEMENT,a=function(t,e){switch(e){case Float32Array:return t.DT_FLOAT32;case Int8Array:return t.DT_INT8;case Int16Array:return t.DT_INT16;case Int32Array:return t.DT_INT32;case Uint8Array:return t.DT_UINT8;case Uint16Array:return t.DT_UINT16;case Uint32Array:return t.DT_UINT32;default:return t.DT_INVALID}}(this.draco,n);let s;const u=this.draco._malloc(o);try{const r=this.decoder.GetAttribute(t,e.attribute_index);this.decoder.GetAttributeDataArrayForAllPoints(t,r,a,o,u),s=new n(this.draco.HEAPF32.buffer,u,i).slice()}finally{this.draco._free(u)}return{value:s,size:r}}_deduceAttributeName(t,e){const n=t.unique_id;for(const[t,r]of Object.entries(e.extraAttributes||{}))if(r===n)return t;const r=t.attribute_type;for(const t in k){if(this.draco[t]===r)return k[t]}const i=e.attributeNameEntry||"name";return t.metadata[i]?t.metadata[i].string:"CUSTOM_ATTRIBUTE_".concat(n)}_getTopLevelMetadata(t){const e=this.decoder.GetMetadata(t);return this._getDracoMetadata(e)}_getAttributeMetadata(t,e){const n=this.decoder.GetAttributeMetadata(t,e);return this._getDracoMetadata(n)}_getDracoMetadata(t){if(!t||!t.ptr)return{};const e={},n=this.metadataQuerier.NumEntries(t);for(let r=0;r<n;r++){const n=this.metadataQuerier.GetEntryName(t,r);e[n]=this._getDracoMetadataField(t,n)}return e}_getDracoMetadataField(t,e){const n=new this.draco.DracoInt32Array;try{this.metadataQuerier.GetIntEntryArray(t,e,n);const r=function(t){const e=t.size(),n=new Int32Array(e);for(let r=0;r<e;r++)n[r]=t.GetValue(r);return n}(n);return{int:this.metadataQuerier.GetIntEntry(t,e),string:this.metadataQuerier.GetStringEntry(t,e),double:this.metadataQuerier.GetDoubleEntry(t,e),intArray:r}}finally{this.draco.destroy(n)}}_disableAttributeTransforms(t){const{quantizedAttributes:e=[],octahedronAttributes:n=[]}=t,r=[...e,...n];for(const t of r)this.decoder.SkipAttributeTransform(this.draco[t])}_getQuantizationTransform(t,e){const{quantizedAttributes:n=[]}=e,r=t.attribute_type();if(n.map(t=>this.decoder[t]).includes(r)){const e=new this.draco.AttributeQuantizationTransform;try{if(e.InitFromAttribute(t))return{quantization_bits:e.quantization_bits(),range:e.range(),min_values:new Float32Array([1,2,3]).map(t=>e.min_value(t))}}finally{this.draco.destroy(e)}}return null}_getOctahedronTransform(t,e){const{octahedronAttributes:n=[]}=e,r=t.attribute_type();if(n.map(t=>this.decoder[t]).includes(r)){const e=new this.draco.AttributeQuantizationTransform;try{if(e.InitFromAttribute(t))return{quantization_bits:e.quantization_bits()}}finally{this.draco.destroy(e)}}return null}}var j=n(317);const F="https://www.gstatic.com/draco/versioned/decoders/".concat("1.4.1","/draco_decoder.js"),z="https://www.gstatic.com/draco/versioned/decoders/".concat("1.4.1","/draco_wasm_wrapper.js"),U="https://www.gstatic.com/draco/versioned/decoders/".concat("1.4.1","/draco_decoder.wasm");"https://raw.githubusercontent.com/google/draco/".concat("1.4.1","/javascript/draco_encoder.js");let N;async function G(t){const e=t.modules||{};return N=e.draco3d?N||e.draco3d.createDecoderModule({}).then(t=>({draco:t})):N||async function(t){let e,n;switch(t.draco&&t.draco.decoderType){case"js":e=await Object(j.a)(F,"draco",t);break;case"wasm":default:[e,n]=await Promise.all([await Object(j.a)(z,"draco",t),await Object(j.a)(U,"draco",t)])}return e=e||globalThis.DracoDecoderModule,await function(t,e){const n={};e&&(n.wasmBinary=e);return new Promise(e=>{t({...n,onModuleLoaded:t=>e({draco:t})})})}(e,n)}(t),await N}var V=n(49);n.d(e,"a",(function(){return H}));V.b;const H={...r,parse:async function(t,e){const{draco:n}=await G(e),r=new L(n);try{return r.parseSync(t,null==e?void 0:e.draco)}finally{r.destroy()}}}},function(t,e,n){"use strict";var r=n(7),i=n(204),o=n(47),a=n(10),s=n(188),u=n(321),c=n(63),l=n(33),h=n(38);let f=null;function p(t,e){var n;return new t((n=t.BYTES_PER_ELEMENT*e,(!f||f.byteLength<n)&&(f=new ArrayBuffer(n)),f),0,e)}var d=n(313);class A extends h.a{get[Symbol.toStringTag](){return"VertexArrayObject"}static isSupported(t){return!(arguments.length>1&&void 0!==arguments[1]?arguments[1]:{}).constantAttributeZero||(Object(r.j)(t)||"Chrome"===Object(d.a)())}static getDefaultArray(t){return t.luma=t.luma||{},t.luma.defaultVertexArray||(t.luma.defaultVertexArray=new A(t,{handle:null,isDefaultArray:!0})),t.luma.defaultVertexArray}static getMaxAttributes(t){return A.MAX_ATTRIBUTES=A.MAX_ATTRIBUTES||t.getParameter(34921),A.MAX_ATTRIBUTES}static setConstant(t,e,n){switch(n.constructor){case Float32Array:A._setConstantFloatArray(t,e,n);break;case Int32Array:A._setConstantIntArray(t,e,n);break;case Uint32Array:A._setConstantUintArray(t,e,n);break;default:Object(a.a)(!1)}}constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};const n=e.id||e.program&&e.program.id;super(t,Object.assign({},e,{id:n})),this.buffer=null,this.bufferValue=null,this.isDefaultArray=e.isDefaultArray||!1,this.gl2=t,this.initialize(e),Object.seal(this)}delete(){return super.delete(),this.buffer&&this.buffer.delete(),this}get MAX_ATTRIBUTES(){return A.getMaxAttributes(this.gl)}initialize(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return this.setProps(t)}setProps(t){return this}setElementBuffer(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:null;return Object(a.a)(!t||34963===t.target,"elements must be GL.ELEMENT_ARRAY_BUFFER"),this.bind(()=>{this.gl.bindBuffer(34963,t?t.handle:null)}),this}setBuffer(t,e,n){if(34963===e.target)return this.setElementBuffer(e,n);const{size:i,type:o,stride:s,offset:u,normalized:c,integer:l,divisor:h}=n,{gl:f,gl2:p}=this;return t=Number(t),this.bind(()=>{f.bindBuffer(34962,e.handle),l?(Object(a.a)(Object(r.j)(f)),p.vertexAttribIPointer(t,i,o,s,u)):f.vertexAttribPointer(t,i,o,c,s,u),f.enableVertexAttribArray(t),p.vertexAttribDivisor(t,h||0)}),this}enable(t){let e=!(arguments.length>1&&void 0!==arguments[1])||arguments[1];return!e&&0===t&&!A.isSupported(this.gl,{constantAttributeZero:!0})||(t=Number(t),this.bind(()=>e?this.gl.enableVertexAttribArray(t):this.gl.disableVertexAttribArray(t))),this}getConstantBuffer(t,e){const n=this._normalizeConstantArrayValue(e),r=n.byteLength*t,i=n.length*t;let o=!this.buffer;if(this.buffer=this.buffer||new l.a(this.gl,r),o=o||this.buffer.reallocate(r),o=o||!this._compareConstantArrayValues(n,this.bufferValue),o){const t=p(e.constructor,i);!function(t){let{target:e,source:n,start:r=0,count:i=1}=t;const o=n.length,a=i*o;let s=0;for(let t=r;s<o;s++)e[t++]=n[s];for(;s<a;)s<a-s?(e.copyWithin(r+s,r,r+s),s*=2):(e.copyWithin(r+s,r,r+a-s),s=a)}({target:t,source:n,start:0,count:i}),this.buffer.subData(t),this.bufferValue=e}return this.buffer}_normalizeConstantArrayValue(t){return Array.isArray(t)?new Float32Array(t):t}_compareConstantArrayValues(t,e){if(!t||!e||t.length!==e.length||t.constructor!==e.constructor)return!1;for(let n=0;n<t.length;++n)if(t[n]!==e[n])return!1;return!0}static _setConstantFloatArray(t,e,n){switch(n.length){case 1:t.vertexAttrib1fv(e,n);break;case 2:t.vertexAttrib2fv(e,n);break;case 3:t.vertexAttrib3fv(e,n);break;case 4:t.vertexAttrib4fv(e,n);break;default:Object(a.a)(!1)}}static _setConstantIntArray(t,e,n){switch(Object(a.a)(Object(r.j)(t)),n.length){case 1:t.vertexAttribI1iv(e,n);break;case 2:t.vertexAttribI2iv(e,n);break;case 3:t.vertexAttribI3iv(e,n);break;case 4:t.vertexAttribI4iv(e,n);break;default:Object(a.a)(!1)}}static _setConstantUintArray(t,e,n){switch(Object(a.a)(Object(r.j)(t)),n.length){case 1:t.vertexAttribI1uiv(e,n);break;case 2:t.vertexAttribI2uiv(e,n);break;case 3:t.vertexAttribI3uiv(e,n);break;case 4:t.vertexAttribI4uiv(e,n);break;default:Object(a.a)(!1)}}_createHandle(){return this.gl.createVertexArray()}_deleteHandle(t){return this.gl2.deleteVertexArray(t),[this.elements]}_bindHandle(t){this.gl2.bindVertexArray(t)}_getParameter(t,e){let{location:n}=e;return Object(a.a)(Number.isFinite(n)),this.bind(()=>{switch(t){case 34373:return this.gl.getVertexAttribOffset(n,t);default:return this.gl.getVertexAttrib(n,t)}})}}var g=n(176);const m=/^(.+)__LOCATION_([0-9]+)$/,y=["setBuffers","setGeneric","clearBindings","setLocations","setGenericValues","setDivisor","enable","disable"];class v{constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};const n=e.id||e.program&&e.program.id;this.id=n,this.gl=t,this.configuration=null,this.elements=null,this.elementsAccessor=null,this.values=null,this.accessors=null,this.unused=null,this.drawParams=null,this.buffer=null,this.attributes={},this.vertexArrayObject=new A(t),Object(g.a)(this,"VertexArray","v6.0",y),this.initialize(e),Object.seal(this)}delete(){this.buffer&&this.buffer.delete(),this.vertexArrayObject.delete()}initialize(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return this.reset(),this.configuration=null,this.bindOnUse=!1,this.setProps(t)}reset(){this.elements=null,this.elementsAccessor=null;const{MAX_ATTRIBUTES:t}=this.vertexArrayObject;return this.values=new Array(t).fill(null),this.accessors=new Array(t).fill(null),this.unused={},this.drawParams=null,this}setProps(t){return"program"in t&&(this.configuration=t.program&&t.program.configuration),"configuration"in t&&(this.configuration=t.configuration),"attributes"in t&&this.setAttributes(t.attributes),"elements"in t&&this.setElementBuffer(t.elements),"bindOnUse"in t&&(t=t.bindOnUse),this}clearDrawParams(){this.drawParams=null}getDrawParams(){return this.drawParams=this.drawParams||this._updateDrawParams(),this.drawParams}setAttributes(t){return Object.assign(this.attributes,t),this.vertexArrayObject.bind(()=>{for(const e in t){const n=t[e];this._setAttribute(e,n)}this.gl.bindBuffer(34962,null)}),this}setElementBuffer(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:null,e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};return this.elements=t,this.elementsAccessor=e,this.clearDrawParams(),this.vertexArrayObject.setElementBuffer(t,e),this}setBuffer(t,e){let n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{};if(34963===e.target)return this.setElementBuffer(e,n);const{location:r,accessor:i}=this._resolveLocationAndAccessor(t,e,e.accessor,n);return r>=0&&(this.values[r]=e,this.accessors[r]=i,this.clearDrawParams(),this.vertexArrayObject.setBuffer(r,e,i)),this}setConstant(t,e){let n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{};const{location:r,accessor:i}=this._resolveLocationAndAccessor(t,e,Object.assign({size:e.length},n));return r>=0&&(e=this.vertexArrayObject._normalizeConstantArrayValue(e),this.values[r]=e,this.accessors[r]=i,this.clearDrawParams(),this.vertexArrayObject.enable(r,!1)),this}unbindBuffers(){return this.vertexArrayObject.bind(()=>{this.elements&&this.vertexArrayObject.setElementBuffer(null),this.buffer=this.buffer||new l.a(this.gl,{accessor:{size:4}});for(let t=0;t<this.vertexArrayObject.MAX_ATTRIBUTES;t++)this.values[t]instanceof l.a&&(this.gl.disableVertexAttribArray(t),this.gl.bindBuffer(34962,this.buffer.handle),this.gl.vertexAttribPointer(t,1,5126,!1,0,0))}),this}bindBuffers(){return this.vertexArrayObject.bind(()=>{this.elements&&this.setElementBuffer(this.elements);for(let t=0;t<this.vertexArrayObject.MAX_ATTRIBUTES;t++){const e=this.values[t];e instanceof l.a&&this.setBuffer(t,e)}}),this}bindForDraw(t,e,n){let r;return this.vertexArrayObject.bind(()=>{this._setConstantAttributes(t,e),r=n()}),r}_resolveLocationAndAccessor(t,e,n,i){const o={location:-1,accessor:null},{location:s,name:u}=this._getAttributeIndex(t);if(!Number.isFinite(s)||s<0)return this.unused[t]=e,r.k.once(3,()=>"unused value ".concat(t," in ").concat(this.id))(),o;const l=this._getAttributeInfo(u||s);if(!l)return o;const h=this.accessors[s]||{},f=c.a.resolve(l.accessor,h,n,i),{size:p,type:d}=f;return Object(a.a)(Number.isFinite(p)&&Number.isFinite(d)),{location:s,accessor:f}}_getAttributeInfo(t){return this.configuration&&this.configuration.getAttributeInfo(t)}_getAttributeIndex(t){const e=Number(t);if(Number.isFinite(e))return{location:e};const n=m.exec(t),r=n?n[1]:t,i=n?Number(n[2]):0;return this.configuration?{location:this.configuration.getAttributeLocation(r)+i,name:r}:{location:-1}}_setAttribute(t,e){if(e instanceof l.a)this.setBuffer(t,e);else if(Array.isArray(e)&&e.length&&e[0]instanceof l.a){const n=e[0],r=e[1];this.setBuffer(t,n,r)}else if(ArrayBuffer.isView(e)||Array.isArray(e)){const n=e;this.setConstant(t,n)}else{if(!(e.buffer instanceof l.a))throw new Error("VertexArray: attributes must be Buffers or constants (i.e. typed array)");{const n=e;this.setBuffer(t,n.buffer,n)}}}_setConstantAttributes(t,e){const n=Math.max(0|t,0|e);let r=this.values[0];ArrayBuffer.isView(r)&&this._setConstantAttributeZero(r,n);for(let t=1;t<this.vertexArrayObject.MAX_ATTRIBUTES;t++)r=this.values[t],ArrayBuffer.isView(r)&&this._setConstantAttribute(t,r)}_setConstantAttributeZero(t,e){if(A.isSupported(this.gl,{constantAttributeZero:!0}))return void this._setConstantAttribute(0,t);const n=this.vertexArrayObject.getConstantBuffer(e,t);this.vertexArrayObject.setBuffer(0,n,this.accessors[0])}_setConstantAttribute(t,e){A.setConstant(this.gl,t,e)}_updateDrawParams(){const t={isIndexed:!1,isInstanced:!1,indexCount:1/0,vertexCount:1/0,instanceCount:1/0};for(let e=0;e<this.vertexArrayObject.MAX_ATTRIBUTES;e++)this._updateDrawParamsForLocation(t,e);return this.elements&&(t.elementCount=this.elements.getElementCount(this.elements.accessor),t.isIndexed=!0,t.indexType=this.elementsAccessor.type||this.elements.accessor.type,t.indexOffset=this.elementsAccessor.offset||0),t.indexCount===1/0&&(t.indexCount=0),t.vertexCount===1/0&&(t.vertexCount=0),t.instanceCount===1/0&&(t.instanceCount=0),t}_updateDrawParamsForLocation(t,e){const n=this.values[e],r=this.accessors[e];if(!n)return;const{divisor:i}=r,o=i>0;if(t.isInstanced=t.isInstanced||o,n instanceof l.a){const e=n;if(o){const n=e.getVertexCount(r);t.instanceCount=Math.min(t.instanceCount,n)}else{const n=e.getVertexCount(r);t.vertexCount=Math.min(t.vertexCount,n)}}}setElements(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:null,e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};return r.k.deprecated("setElements","setElementBuffer")(),this.setElementBuffer(t,e)}}var _=n(314),b=n(48),x=n(81);function w(t,e){const{maxElts:n=16,size:r=1}=e;let i="[";for(let o=0;o<t.length&&o<n;++o)o>0&&(i+=",".concat(o%r==0?" ":"")),i+=E(t[o],e);const o=t.length>n?"...":"]";return"".concat(i).concat(o)}function E(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};const n=1e-16,{isInteger:r=!1}=e;if(Array.isArray(t)||ArrayBuffer.isView(t))return w(t,e);if(!Number.isFinite(t))return String(t);if(Math.abs(t)<n)return r?"0":"0.";if(r)return t.toFixed(0);if(Math.abs(t)>100&&Math.abs(t)<1e4)return t.toFixed(0);const i=t.toPrecision(2),o=i.indexOf(".0");return o===i.length-2?i.slice(0,-1):i}function O(t,e,n,r){const{gl:i}=t;if(!e)return{[r]:"null","Format ":"N/A"};let o,a,s,u="NOT PROVIDED",c=1,h=0,f=0;if(n&&(u=n.type,c=n.size,u=String(u).replace("Array",""),o=-1!==u.indexOf("nt")),e instanceof l.a){const t=e,{data:l,changed:p}=t.getDebugData();let d;if(a=p?"*":"",s=l,f=t.byteLength,h=f/l.BYTES_PER_ELEMENT/c,n){const t=n.divisor>0;d="".concat(t?"I ":"P "," ").concat(h," (x").concat(c,"=").concat(f," bytes ").concat(Object(b.a)(i,u),")")}else o=!0,d="".concat(f," bytes");return{[r]:"".concat(a).concat(E(s,{size:c,isInteger:o})),"Format ":d}}return s=e,c=e.length,u=String(e.constructor.name).replace("Array",""),o=-1!==u.indexOf("nt"),{[r]:"".concat(E(s,{size:c,isInteger:o})," (constant)"),"Format ":"".concat(c,"x").concat(u," (constant)")}}function S(t,e){const{type:n,size:r}=e,i=Object(x.b)(n,r);return i?"".concat(t," (").concat(i.name,")"):t}function T(t){let{header:e="Uniforms",program:n,uniforms:r,undefinedOnly:i=!1}=t;Object(a.a)(n);const o=n._uniformSetters,s={},u=Object.keys(o).sort();let c=0;for(const t of u)t.match(".*_.*")||t.match(".*Matrix")||C({table:s,header:e,uniforms:r,uniformName:t,undefinedOnly:i})&&c++;for(const t of u)t.match(".*Matrix")&&C({table:s,header:e,uniforms:r,uniformName:t,undefinedOnly:i})&&c++;for(const t of u)s[t]||C({table:s,header:e,uniforms:r,uniformName:t,undefinedOnly:i})&&c++;let l=0;const h={};if(!i)for(const t in r){const n=r[t];s[t]||(l++,h[t]={Type:"NOT USED: ".concat(n),[e]:E(n)})}return{table:s,count:c,unusedTable:h,unusedCount:l}}function C(t){let{table:e,header:n,uniforms:r,uniformName:i,undefinedOnly:o}=t;const a=r[i],s=function(t){return null!=t}(a);return(!o||!s)&&(e[i]={[n]:s?E(a):"N/A","Uniform Type":s?a:"NOT PROVIDED"},!0)}function P(t){const{type:e,size:n}=t.accessor,r=Object(x.b)(e,n);return r?"".concat(r.name," ").concat(t.name):t.name}const M={POSITION:"positions",NORMAL:"normals",COLOR_0:"colors",TEXCOORD_0:"texCoords",TEXCOORD_1:"texCoords1",TEXCOORD_2:"texCoords2"};function I(t,e){const{attributeMap:n=M}=e||{};return n&&n[t]||t}function B(t,e){let n;switch(t){case"texCoords":case"texCoord1":case"texCoord2":case"texCoord3":n="uvs";break;case"vertices":case"positions":case"normals":case"pickingColors":n="vectors"}switch(n){case"vectors":e.size=e.size||3;break;case"uvs":e.size=e.size||2}Object(a.a)(Number.isFinite(e.size),"attribute ".concat(t," needs size"))}n.d(e,"a",(function(){return D}));const R=()=>{},k={};class D{constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};const{id:n=Object(o.c)("model")}=e;Object(a.a)(Object(r.i)(t)),this.id=n,this.gl=t,this.id=e.id||Object(o.c)("Model"),this.lastLogTime=0,this.animated=!1,this.initialize(e)}initialize(t){this.props={},this.programManager=t.programManager||i.a.getDefaultProgramManager(this.gl),this._programManagerState=-1,this._managedProgram=!1;const{program:e=null,vs:n,fs:r,modules:o,defines:s,inject:u,varyings:c,bufferMode:l,transpileToGLSL100:h}=t;this.programProps={program:e,vs:n,fs:r,modules:o,defines:s,inject:u,varyings:c,bufferMode:l,transpileToGLSL100:h},this.program=null,this.vertexArray=null,this._programDirty=!0,this.userData={},this.needsRedraw=!0,this._attributes={},this.attributes={},this.uniforms={},this.pickable=!0,this._checkProgram(),this.setUniforms(Object.assign({},this.getModuleUniforms(t.moduleSettings))),this.drawMode=void 0!==t.drawMode?t.drawMode:4,this.vertexCount=t.vertexCount||0,this.geometryBuffers={},this.isInstanced=t.isInstanced||t.instanced||t.instanceCount>0,this._setModelProps(t),this.geometry={},Object(a.a)(void 0!==this.drawMode&&Number.isFinite(this.vertexCount),"Model needs drawMode and vertexCount")}setProps(t){this._setModelProps(t)}delete(){for(const t in this._attributes)this._attributes[t]!==this.attributes[t]&&this._attributes[t].delete();this._managedProgram&&(this.programManager.release(this.program),this._managedProgram=!1),this.vertexArray.delete(),this._deleteGeometryBuffers()}getDrawMode(){return this.drawMode}getVertexCount(){return this.vertexCount}getInstanceCount(){return this.instanceCount}getAttributes(){return this.attributes}getProgram(){return this.program}setProgram(t){const{program:e,vs:n,fs:r,modules:i,defines:o,inject:a,varyings:s,bufferMode:u,transpileToGLSL100:c}=t;this.programProps={program:e,vs:n,fs:r,modules:i,defines:o,inject:a,varyings:s,bufferMode:u,transpileToGLSL100:c},this._programDirty=!0}getUniforms(){return this.uniforms}setDrawMode(t){return this.drawMode=t,this}setVertexCount(t){return Object(a.a)(Number.isFinite(t)),this.vertexCount=t,this}setInstanceCount(t){return Object(a.a)(Number.isFinite(t)),this.instanceCount=t,this}setGeometry(t){return this.drawMode=t.drawMode,this.vertexCount=t.getVertexCount(),this._deleteGeometryBuffers(),this.geometryBuffers=function(t,e,n){const r={};let i=e.indices;for(const o in e.attributes){const a=e.attributes[o],s=I(o,n);if("indices"===o)i=a;else if(a.constant)r[s]=a.value;else{const e=a.value,n={...a};delete n.value,r[s]=[new l.a(t,e),n],B(o,n)}}if(i){const e=i.value||i;Object(a.a)(e instanceof Uint16Array||e instanceof Uint32Array,'attribute array for "indices" must be of integer type');const n={size:1,isIndexed:void 0===i.isIndexed||i.isIndexed};r.indices=[new l.a(t,{data:e,target:34963}),n]}return r}(this.gl,t),this.vertexArray.setAttributes(this.geometryBuffers),this}setAttributes(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};if(Object(o.a)(t))return this;const e={};for(const n in t){const r=t[n];e[n]=r.getValue?r.getValue():r}return this.vertexArray.setAttributes(e),this}setUniforms(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return Object.assign(this.uniforms,t),this}getModuleUniforms(t){this._checkProgram();const e=this.programManager.getUniforms(this.program);return e?e(t):{}}updateModuleSettings(t){const e=this.getModuleUniforms(t||{});return this.setUniforms(e)}clear(t){return Object(s.a)(this.program.gl,t),this}draw(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};this._checkProgram();const{moduleSettings:e=null,framebuffer:n,uniforms:i={},attributes:o={},transformFeedback:a=this.transformFeedback,parameters:s={},vertexArray:u=this.vertexArray}=t;let c;this.setAttributes(o),this.updateModuleSettings(e),this.setUniforms(i),r.k.priority>=2&&(c=this._logDrawCallStart(2));const l=this.vertexArray.getDrawParams(),{isIndexed:h=l.isIndexed,indexType:f=l.indexType,indexOffset:p=l.indexOffset,vertexArrayInstanced:d=l.isInstanced}=this.props;d&&!this.isInstanced&&r.k.warn("Found instanced attributes on non-instanced model",this.id)();const{isInstanced:A,instanceCount:g}=this,{onBeforeRender:m=R,onAfterRender:y=R}=this.props;m(),this.program.setUniforms(this.uniforms);const v=this.program.draw(Object.assign(k,t,{logPriority:c,uniforms:null,framebuffer:n,parameters:s,drawMode:this.getDrawMode(),vertexCount:this.getVertexCount(),vertexArray:u,transformFeedback:a,isIndexed:h,indexType:f,isInstanced:A,instanceCount:g,offset:h?p:0}));return y(),r.k.priority>=2&&this._logDrawCallEnd(c,u,n),v}transform(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{discard:e=!0,feedbackBuffers:n,unbindModels:r=[]}=t;let{parameters:i}=t;n&&this._setFeedbackBuffers(n),e&&(i=Object.assign({},i,{35977:e})),r.forEach(t=>t.vertexArray.unbindBuffers());try{this.draw(Object.assign({},t,{parameters:i}))}finally{r.forEach(t=>t.vertexArray.bindBuffers())}return this}render(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return r.k.warn("Model.render() is deprecated. Use Model.setUniforms() and Model.draw()")(),this.setUniforms(t).draw()}_setModelProps(t){Object.assign(this.props,t),"uniforms"in t&&this.setUniforms(t.uniforms),"pickable"in t&&(this.pickable=t.pickable),"instanceCount"in t&&(this.instanceCount=t.instanceCount),"geometry"in t&&this.setGeometry(t.geometry),"attributes"in t&&this.setAttributes(t.attributes),"_feedbackBuffers"in t&&this._setFeedbackBuffers(t._feedbackBuffers)}_checkProgram(){if(!(this._programDirty||this.programManager.stateHash!==this._programManagerState))return;let{program:t}=this.programProps;if(t)this._managedProgram=!1;else{const{vs:e,fs:n,modules:r,inject:i,defines:o,varyings:a,bufferMode:s,transpileToGLSL100:u}=this.programProps;t=this.programManager.get({vs:e,fs:n,modules:r,inject:i,defines:o,varyings:a,bufferMode:s,transpileToGLSL100:u}),this.program&&this._managedProgram&&this.programManager.release(this.program),this._programManagerState=this.programManager.stateHash,this._managedProgram=!0}Object(a.a)(t instanceof u.a,"Model needs a program"),this._programDirty=!1,t!==this.program&&(this.program=t,this.vertexArray?this.vertexArray.setProps({program:this.program,attributes:this.vertexArray.attributes}):this.vertexArray=new v(this.gl,{program:this.program}),this.setUniforms(Object.assign({},this.getModuleUniforms())))}_deleteGeometryBuffers(){for(const t in this.geometryBuffers){const e=this.geometryBuffers[t][0]||this.geometryBuffers[t];e instanceof l.a&&e.delete()}}_setAnimationProps(t){this.animated&&Object(a.a)(t,"Model.draw(): animated uniforms but no animationProps")}_setFeedbackBuffers(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};if(Object(o.a)(t))return this;const{gl:e}=this.program;return this.transformFeedback=this.transformFeedback||new _.a(e,{program:this.program}),this.transformFeedback.setBuffers(t),this}_logDrawCallStart(t){const e=t>3?0:1e4;if(!(Date.now()-this.lastLogTime<e))return this.lastLogTime=Date.now(),r.k.group(2,">>> DRAWING MODEL ".concat(this.id),{collapsed:r.k.level<=2})(),t}_logDrawCallEnd(t,e,n,i){if(void 0===t)return;const o=function(t){let{vertexArray:e,header:n="Attributes"}=t;if(!e.configuration)return{};const r={};e.elements&&(r.ELEMENT_ARRAY_BUFFER=O(e,e.elements,null,n));const i=e.values;for(const t in i){const o=e._getAttributeInfo(t);if(o){let a="".concat(t,": ").concat(o.name);const s=e.accessors[o.location];s&&(a="".concat(t,": ").concat(S(o.name,s))),r[a]=O(e,i[t],s,n)}}return r}({vertexArray:e,header:"".concat(this.id," attributes"),attributes:this._attributes}),{table:a,unusedTable:s,unusedCount:u}=T({header:"".concat(this.id," uniforms"),program:this.program,uniforms:Object.assign({},this.program.uniforms,n)}),{table:c,count:l}=T({header:"".concat(this.id," uniforms"),program:this.program,uniforms:Object.assign({},this.program.uniforms,n),undefinedOnly:!0});l>0&&r.k.log("MISSING UNIFORMS",Object.keys(c))(),u>0&&r.k.log("UNUSED UNIFORMS",Object.keys(s))();const h=function(t){const e={},n="Accessors for ".concat(t.id);for(const r of t.attributeInfos)if(r){const t=P(r);e["in ".concat(t)]={[n]:JSON.stringify(r.accessor)}}for(const r of t.varyingInfos)if(r){const t=P(r);e["out ".concat(t)]={[n]:JSON.stringify(r.accessor)}}return e}(this.vertexArray.configuration);r.k.table(t,o)(),r.k.table(t,a)(),r.k.table(t+1,h)(),i&&i.log({logLevel:2,message:"Rendered to ".concat(i.id)}),r.k.groupEnd(2)()}}},function(t,e,n){"use strict";function r(t,e){if(!t)throw new Error(e||"shadertools: assertion failed.")}n.d(e,"a",(function(){return r}))},function(t,e,n){"use strict";n.d(e,"a",(function(){return a})),n.d(e,"b",(function(){return s}));var r=n(7),i=n(10);const o=6144;function a(t){let{framebuffer:e=null,color:n=null,depth:o=null,stencil:a=null}=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};const s={};e&&(s.framebuffer=e);let u=0;n&&(u|=16384,!0!==n&&(s.clearColor=n)),o&&(u|=256,!0!==o&&(s.clearDepth=o)),a&&(u|=1024,!0!==o&&(s.clearStencil=o)),Object(i.a)(0!==u,"clear: bad arguments"),Object(r.o)(t,s,()=>{t.clear(u)})}function s(t){let{framebuffer:e=null,buffer:n=o,drawBuffer:a=0,value:s=[0,0,0,0]}=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};Object(r.a)(t),Object(r.o)(t,{framebuffer:e},()=>{switch(n){case o:switch(s.constructor){case Int32Array:t.clearBufferiv(n,a,s);break;case Uint32Array:t.clearBufferuiv(n,a,s);break;case Float32Array:default:t.clearBufferfv(n,a,s)}break;case 6145:t.clearBufferfv(6145,0,[s]);break;case 6146:t.clearBufferiv(6146,0,[s]);break;case 34041:const[e,r]=s;t.clearBufferfi(34041,0,e,r);break;default:Object(i.a)(!1,"clear: bad arguments")}})}},function(t,e,n){"use strict";n.d(e,"a",(function(){return o}));var r=n(74),i=n(107);const o={WEBGL2:"WEBGL2",VERTEX_ARRAY_OBJECT:"VERTEX_ARRAY_OBJECT",TIMER_QUERY:"TIMER_QUERY",INSTANCED_RENDERING:"INSTANCED_RENDERING",MULTIPLE_RENDER_TARGETS:"MULTIPLE_RENDER_TARGETS",ELEMENT_INDEX_UINT32:"ELEMENT_INDEX_UINT32",BLEND_EQUATION_MINMAX:"BLEND_EQUATION_MINMAX",FLOAT_BLEND:"FLOAT_BLEND",COLOR_ENCODING_SRGB:"COLOR_ENCODING_SRGB",TEXTURE_DEPTH:"TEXTURE_DEPTH",TEXTURE_FLOAT:"TEXTURE_FLOAT",TEXTURE_HALF_FLOAT:"TEXTURE_HALF_FLOAT",TEXTURE_FILTER_LINEAR_FLOAT:"TEXTURE_FILTER_LINEAR_FLOAT",TEXTURE_FILTER_LINEAR_HALF_FLOAT:"TEXTURE_FILTER_LINEAR_HALF_FLOAT",TEXTURE_FILTER_ANISOTROPIC:"TEXTURE_FILTER_ANISOTROPIC",COLOR_ATTACHMENT_RGBA32F:"COLOR_ATTACHMENT_RGBA32F",COLOR_ATTACHMENT_FLOAT:"COLOR_ATTACHMENT_FLOAT",COLOR_ATTACHMENT_HALF_FLOAT:"COLOR_ATTACHMENT_HALF_FLOAT",GLSL_FRAG_DATA:"GLSL_FRAG_DATA",GLSL_FRAG_DEPTH:"GLSL_FRAG_DEPTH",GLSL_DERIVATIVES:"GLSL_DERIVATIVES",GLSL_TEXTURE_LOD:"GLSL_TEXTURE_LOD"};e.b={[o.WEBGL2]:[!1,!0],[o.VERTEX_ARRAY_OBJECT]:["OES_vertex_array_object",!0],[o.TIMER_QUERY]:["EXT_disjoint_timer_query","EXT_disjoint_timer_query_webgl2"],[o.INSTANCED_RENDERING]:["ANGLE_instanced_arrays",!0],[o.MULTIPLE_RENDER_TARGETS]:["WEBGL_draw_buffers",!0],[o.ELEMENT_INDEX_UINT32]:["OES_element_index_uint",!0],[o.BLEND_EQUATION_MINMAX]:["EXT_blend_minmax",!0],[o.FLOAT_BLEND]:["EXT_float_blend"],[o.COLOR_ENCODING_SRGB]:["EXT_sRGB",!0],[o.TEXTURE_DEPTH]:["WEBGL_depth_texture",!0],[o.TEXTURE_FLOAT]:["OES_texture_float",!0],[o.TEXTURE_HALF_FLOAT]:["OES_texture_half_float",!0],[o.TEXTURE_FILTER_LINEAR_FLOAT]:["OES_texture_float_linear"],[o.TEXTURE_FILTER_LINEAR_HALF_FLOAT]:["OES_texture_half_float_linear"],[o.TEXTURE_FILTER_ANISOTROPIC]:["EXT_texture_filter_anisotropic"],[o.COLOR_ATTACHMENT_RGBA32F]:[function(t){const e=new i.a(t,{format:6408,type:5126,dataFormat:6408}),n=new r.a(t,{id:"test-framebuffer",check:!1,attachments:{36064:e}}),o=n.getStatus();return e.delete(),n.delete(),36053===o},"EXT_color_buffer_float"],[o.COLOR_ATTACHMENT_FLOAT]:[!1,"EXT_color_buffer_float"],[o.COLOR_ATTACHMENT_HALF_FLOAT]:["EXT_color_buffer_half_float"],[o.GLSL_FRAG_DATA]:["WEBGL_draw_buffers",!0],[o.GLSL_FRAG_DEPTH]:["EXT_frag_depth",!0],[o.GLSL_DERIVATIVES]:["OES_standard_derivatives",!0],[o.GLSL_TEXTURE_LOD]:["EXT_shader_texture_lod",!0]}},function(t,e,n){"use strict";n.d(e,"a",(function(){return i})),n.d(e,"b",(function(){return o}));var r=n(51);function i(t){const e="3.2.10"!==t.version?" (worker-utils@".concat("3.2.10",")"):"";return"".concat(t.name,"@").concat(t.version).concat(e)}function o(t,e={}){const n=e[t.id]||{},i="".concat(t.id,"-worker.js");let o=n.workerUrl;if(o||"compression"!==t.id||(o=e.workerUrl),"test"===e._workerType&&(o="modules/".concat(t.module,"/dist/").concat(i)),!o){let e=t.version;"latest"===e&&(e="latest");const n=e?"@".concat(e):"";o="https://unpkg.com/@loaders.gl/".concat(t.module).concat(n,"/dist/").concat(i)}return Object(r.a)(o),o}},function(t,e,n){"use strict";var r=n(77),i=n(187);n.d(e,"a",(function(){return a})),n.d(e,"c",(function(){return l})),n.d(e,"b",(function(){return h}));const o={[r.b]:"#ifdef MODULE_LOGDEPTH\n  logdepth_adjustPosition(gl_Position);\n#endif\n",[r.a]:"#ifdef MODULE_MATERIAL\n  gl_FragColor = material_filterColor(gl_FragColor);\n#endif\n\n#ifdef MODULE_LIGHTING\n  gl_FragColor = lighting_filterColor(gl_FragColor);\n#endif\n\n#ifdef MODULE_FOG\n  gl_FragColor = fog_filterColor(gl_FragColor);\n#endif\n\n#ifdef MODULE_PICKING\n  gl_FragColor = picking_filterHighlightColor(gl_FragColor);\n  gl_FragColor = picking_filterPickingColor(gl_FragColor);\n#endif\n\n#ifdef MODULE_LOGDEPTH\n  logdepth_setFragDepth();\n#endif\n"},a="__LUMA_INJECT_DECLARATIONS__",s=/void\s+main\s*\([^)]*\)\s*\{\n?/,u=/}\n?[^{}]*$/,c=[];function l(t,e,n){let i=arguments.length>3&&void 0!==arguments[3]&&arguments[3];const l=e===r.b;for(const e in n){const r=n[e];r.sort((t,e)=>t.order-e.order),c.length=r.length;for(let t=0,e=r.length;t<e;++t)c[t]=r[t].injection;const i="".concat(c.join("\n"),"\n");switch(e){case"vs:#decl":l&&(t=t.replace(a,i));break;case"vs:#main-start":l&&(t=t.replace(s,t=>t+i));break;case"vs:#main-end":l&&(t=t.replace(u,t=>i+t));break;case"fs:#decl":l||(t=t.replace(a,i));break;case"fs:#main-start":l||(t=t.replace(s,t=>t+i));break;case"fs:#main-end":l||(t=t.replace(u,t=>i+t));break;default:t=t.replace(e,t=>t+i)}}return t=t.replace(a,""),i&&(t=t.replace(/\}\s*$/,t=>t+o[e])),t}function h(t){const e={};return Object(i.a)(Array.isArray(t)&&t.length>1),t.forEach(t=>{for(const n in t)e[n]=e[n]?"".concat(e[n],"\n").concat(t[n]):t[n]}),e}},,,function(t,e){function n(e){return t.exports=n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t},t.exports.__esModule=!0,t.exports.default=t.exports,n(e)}t.exports=n,t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){"use strict";n.d(e,"a",(function(){return a})),n.d(e,"b",(function(){return s}));var r=n(49),i=n(134),o=n(190);function a(t,e){return!!i.a.isSupported()&&(!!(r.b||null!=e&&e._nodeWorkers)&&(t.worker&&(null==e?void 0:e.worker)))}async function s(t,e,n,r,a){const s=t.id,c=Object(o.b)(t,n),l=i.a.getWorkerFarm(n).getWorkerPool({name:s,url:c});n=JSON.parse(JSON.stringify(n)),r=JSON.parse(JSON.stringify(r||{}));const h=await l.startJob("process-on-worker",u.bind(null,a));h.postMessage("process",{input:e,options:n,context:r});const f=await h.result;return await f.result}async function u(t,e,n,r){switch(n){case"done":e.done(r);break;case"error":e.error(new Error(r.error));break;case"process":const{id:i,input:o,options:a}=r;try{const n=await t(o,a);e.postMessage("done",{id:i,result:n})}catch(t){const n=t instanceof Error?t.message:"unknown error";e.postMessage("error",{id:i,error:n})}break;default:console.warn("parse-with-worker unknown message ".concat(n))}}},function(t,e,n){"use strict";n.r(e);var r=n(9),i=n.n(r),o=n(0),a=n.n(o),s=n(3),u=n.n(s),c=n(4),l=n.n(c),h=n(28),f=n.n(h);function p(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:"";if(!t)throw new Error("JSON conversion error ".concat(e))}function d(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return A(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return A(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function A(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function g(t,e){var n,r=t,i=d(function(t){if("string"==typeof t){var e=y[t];return e||(e=t.split("."),y[t]=e),e}return Array.isArray(t)?t:[t]}(e));try{for(i.s();!(n=i.n()).done;){var o=n.value;r=m(r)?r[o]:void 0}}catch(t){i.e(t)}finally{i.f()}return r}function m(t){return null!==t&&"object"===f()(t)}var y={};var v=n(203),_=n.n(v),b={"-":function(t){return t}};function x(t,e){if(t in b)return b[t];var n,r=_.a.parse(t);return r.right||r.left||"Identifier"!==r.type?(!function t(e,n){if(Array.isArray(e))e.forEach((function(e){return t(e,n)}));else if(e&&"object"===f()(e))for(var r in e.type&&n(e),e)t(e[r],n)}(r,(function(t){if("CallExpression"===t.type)throw new Error("Function calls not allowed in JSON expressions")})),n=function(t){return _.a.eval(r,t)}):n=function(e){return g(e,t)},b[t]=n,n}var w=function(t){return t&&"object"===f()(t)},E=function(){function t(){u()(this,t),this.typeKey="@@type",this.functionKey="@@function",this.log=console,this.classes={},this.reactComponents={},this.enumerations={},this.constants={},this.functions={},this.convertFunction=x,this.preProcessClassProps=function(t,e){return e},this.postProcessConvertedJson=function(t){return t};for(var e=arguments.length,n=new Array(e),r=0;r<e;r++)n[r]=arguments[r];for(var i=0,o=n;i<o.length;i++){var a=o[i];this.merge(a)}}return l()(t,[{key:"merge",value:function(t){for(var e in t)switch(e){case"layers":case"views":Object.assign(this.classes,t[e]);break;default:if(e in this){var n=t[e];this[e]=w(this[e])?Object.assign(this[e],n):n}}}},{key:"validate",value:function(t){return p(!this.typeKey||"string"==typeof this.typeKey),p(w(this.classes)),!0}}]),t}();function O(t){return t.replace("@@=","")}function S(t,e){var n,r={};for(var i in t){var o=t[i];"string"==typeof(n=o)&&n.startsWith("@@=")&&(o=x(o=O(o))),r[i]=o}return r}function T(t,e,n){var r=n.classes[t],i=n.reactComponents[t];if(!r&&!i){var o=n.log;if(o){var a=JSON.stringify(e,null,0).slice(0,40);o.warn("JSON converter: No registered class of type ".concat(t,"(").concat(a,"...)  "))}return null}return r?function(t,e,n){n.preProcessClassProps&&(e=n.preProcessClassProps(t,e,n));return e=S(e),new t(e)}(r,e,n):function(t,e,n){var r=n.React,i=e.children,o=void 0===i?[]:i;delete e.children,n.preProcessClassProps&&(e=n.preProcessClassProps(t,e,n));return e=S(e),r.createElement(t,e,o)}(i,e,n)}function C(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function P(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?C(Object(n),!0).forEach((function(e){a()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):C(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var M=function(t){return t&&"object"===f()(t)},I=function(){function t(e){u()(this,t),this.log=console,this.configuration={},this.onJSONChange=function(){},this.json=null,this.convertedJson=null,this.setProps(e)}return l()(t,[{key:"finalize",value:function(){}},{key:"setProps",value:function(t){"configuration"in t&&(this.configuration=t.configuration instanceof E?t.configuration:new E(t.configuration)),"onJSONChange"in t&&(this.onJSONChange=t.onJSONChange)}},{key:"mergeConfiguration",value:function(t){this.configuration.merge(t)}},{key:"convert",value:function(t){if(!t||t===this.json)return this.convertedJson;this.json=t;var e=function(t,e){return e=new E(e),B(t,"",e)}(function(t){return"string"==typeof t?JSON.parse(t):t}(t),this.configuration);return e=this.configuration.postProcessConvertedJson(e),this.convertedJson=e,e}},{key:"convertJson",value:function(t){return this.convert(t)}}]),t}();function B(t,e,n){return Array.isArray(t)?t.map((function(t,e){return B(t,String(e),n)})):function(t,e){var n=e.typeKey;return M(t)&&Boolean(t[n])}(t,n)?function(t,e){var n=e.typeKey,r=t[n],i=P({},t);return delete i[n],i=R(i,e),T(r,i,e)}(t,n):M(t)?"@@function"in t?function(t,e){var n=e.functionKey,r=t[n],i=P({},t);return delete i[n],i=R(i,e),function(t,e,n){var r=n.functions[t];if(!r){var i=n.log;if(i){var o=JSON.stringify(e,null,0).slice(0,40);i.warn("JSON converter: No registered function ".concat(t,"(").concat(o,"...)  "))}return null}return r(e)}(r,i,e)}(t,n):R(t,n):"string"==typeof t?function(t,e,n){if(t.startsWith("@@=")&&n.convertFunction)return t=t.replace("@@=",""),n.convertFunction(t,n);if(t.startsWith("@@#")){if(t=t.replace("@@#",""),n.constants[t])return n.constants[t];var r=t.split("."),o=i()(r,2),a=o[0],s=o[1];return n.enumerations[a][s]}return t}(t,0,n):t}function R(t,e){p(M(t));var n={};for(var r in t){var i=t[r];n[r]=B(i,0,e)}return n}var k=n(173);function D(t,e){if(t===e)return!0;if("object"!==f()(t)||null===t||"object"!==f()(e)||null===e)return!1;if(Object.keys(t).length!==Object.keys(e).length)return!1;for(var n in t)if(!(n in e)||t[n]!==e[n])return!1;for(var r in e)if(!(r in t))return!1;return!0}n.d(e,"JSONConverter",(function(){return I})),n.d(e,"JSONConfiguration",(function(){return E})),n.d(e,"Transport",(function(){return k.a})),n.d(e,"_convertFunctions",(function(){return S})),n.d(e,"_parseExpressionString",(function(){return x})),n.d(e,"_shallowEqualObjects",(function(){return D}))},function(t,e,n){"use strict";n.r(e),n.d(e,"default",(function(){return A}));var r=n(88),i=n.n(r),o=n(89),a=n.n(o),s=n(119),u=n.n(s),c=n(120),l=n.n(c),h=n(56),f=n.n(h),p=n(173);function d(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=f()(t);if(e){var i=f()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return l()(this,n)}}var A=function(t){u()(n,t);var e=d(n);function n(){var t;return i()(this,n),(t=e.call(this,"Jupyter Transport (JavaScript <=> Jupyter Kernel)")).jupyterModel=null,t.jupyterView=null,t}return a()(n,[{key:"getRootDOMElement",value:function(){return this.jupyterView.el}},{key:"sendJSONMessage",value:function(t,e){var n=p.a._stringifyJSONSafe({type:t,data:e});this.jupyterModel.send(n)}}]),n}(p.a)},function(t,e,n){"use strict";n.d(e,"a",(function(){return O}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(8),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(164),y=n(32),v=n(67);function _(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return b(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return b(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function b(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function x(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function w(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?x(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):x(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function E(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}var O=function(t){l()(n,t);var e=E(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"isComposite",get:function(){return!0}},{key:"isLoaded",get:function(){return u()(d()(n.prototype),"isLoaded",this)&&this.getSubLayers().every((function(t){return t.isLoaded}))}},{key:"getSubLayers",value:function(){return this.internalState&&this.internalState.subLayers||[]}},{key:"initializeState",value:function(t){}},{key:"setState",value:function(t){u()(d()(n.prototype),"setState",this).call(this,t),this.setNeedsUpdate()}},{key:"getPickingInfo",value:function(t){var e=t.info,n=e.object;return n&&n.__source&&n.__source.parent&&n.__source.parent.id===this.id?(e.object=n.__source.object,e.index=n.__source.index,e):e}},{key:"filterSubLayer",value:function(t){return!0}},{key:"shouldRenderSubLayer",value:function(t,e){return e&&e.length}},{key:"getSubLayerClass",value:function(t,e){var n=this.props._subLayerProps;return n&&n[t]&&n[t].type||e}},{key:"getSubLayerRow",value:function(t,e,n){return t.__source={parent:this,object:e,index:n},t}},{key:"getSubLayerAccessor",value:function(t){if("function"==typeof t){var e={index:-1,data:this.props.data,target:[]};return function(n,r){return n&&n.__source?(e.index=n.__source.index,t(n.__source.object,e)):t(n,r)}}return t}},{key:"getSubLayerProps",value:function(){var t,e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},n=this.props,r=n.opacity,i=n.pickable,o=n.visible,a=n.parameters,s=n.getPolygonOffset,u=n.highlightedObjectIndex,c=n.autoHighlight,l=n.highlightColor,h=n.coordinateSystem,f=n.coordinateOrigin,p=n.wrapLongitude,d=n.positionFormat,A=n.modelMatrix,g=n.extensions,m=n.fetch,y=n.operation,v=n._subLayerProps,b={id:"",updateTriggers:{},opacity:r,pickable:i,visible:o,parameters:a,getPolygonOffset:s,highlightedObjectIndex:u,autoHighlight:c,highlightColor:l,coordinateSystem:h,coordinateOrigin:f,wrapLongitude:p,positionFormat:d,modelMatrix:A,extensions:g,fetch:m,operation:y},x=v&&e.id&&v[e.id],E=x&&x.updateTriggers,O=e.id||"sublayer";if(x){var S=this.constructor._propTypes,T=e.type?e.type._propTypes:{};for(var C in x){var P=T[C]||S[C];P&&"accessor"===P.type&&(x[C]=this.getSubLayerAccessor(x[C]))}}Object.assign(b,e,x),b.id="".concat(this.props.id,"-").concat(O),b.updateTriggers=w(w({all:null===(t=this.props.updateTriggers)||void 0===t?void 0:t.all},e.updateTriggers),E);var M,I=_(g);try{for(I.s();!(M=I.n()).done;){var B=M.value,R=B.getSubLayerProps.call(this,B);R&&Object.assign(b,R,{updateTriggers:Object.assign(b.updateTriggers,R.updateTriggers)})}}catch(t){I.e(t)}finally{I.f()}return b}},{key:"_updateAutoHighlight",value:function(t){var e,n=_(this.getSubLayers());try{for(n.s();!(e=n.n()).done;){e.value.updateAutoHighlight(t)}}catch(t){n.e(t)}finally{n.f()}}},{key:"_getAttributeManager",value:function(){return null}},{key:"_postUpdate",value:function(t,e){var n=this.internalState.subLayers,r=!n||this.needsUpdate();if(r){var i=this.renderLayers();n=Object(v.b)(i,Boolean),this.internalState.subLayers=n}Object(y.a)("compositeLayer.renderLayers",this,r,n);var o,a=_(n);try{for(a.s();!(o=a.n()).done;){o.value.parent=this}}catch(t){a.e(t)}finally{a.f()}}}]),n}(m.a);g()(O,"layerName","CompositeLayer")},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(0),u=n.n(s),c=n(170),l=n(61),h=n(21),f=n(67);function p(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function d(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?p(Object(n),!0).forEach((function(e){u()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):p(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var A=function(){function t(e){i()(this,t),this.views=[],this.width=100,this.height=100,this.viewState={},this.controllers={},this.timeline=e.timeline,this._viewports=[],this._viewportMap={},this._isUpdating=!1,this._needsRedraw="First render",this._needsUpdate="Initialize",this._eventManager=e.eventManager,this._eventCallbacks={onViewStateChange:e.onViewStateChange,onInteractionStateChange:e.onInteractionStateChange},Object.seal(this),this.setProps(e)}return a()(t,[{key:"finalize",value:function(){for(var t in this.controllers){var e=this.controllers[t];e&&e.finalize()}this.controllers={}}},{key:"needsRedraw",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{clearRedrawFlags:!1},e=this._needsRedraw;return t.clearRedrawFlags&&(this._needsRedraw=!1),e}},{key:"setNeedsUpdate",value:function(t){this._needsUpdate=this._needsUpdate||t,this._needsRedraw=this._needsRedraw||t}},{key:"updateViewStates",value:function(){for(var t in this.controllers){var e=this.controllers[t];e&&e.updateTransition()}}},{key:"getViewports",value:function(t){return t?this._viewports.filter((function(e){return e.containsPixel(t)})):this._viewports}},{key:"getViews",value:function(){var t={};return this.views.forEach((function(e){t[e.id]=e})),t}},{key:"getView",value:function(t){return this.views.find((function(e){return e.id===t}))}},{key:"getViewState",value:function(t){var e="string"==typeof t?this.getView(t):t,n=e&&this.viewState[e.getViewStateId()]||this.viewState;return e?e.filterViewState(n):n}},{key:"getViewport",value:function(t){return this._viewportMap[t]}},{key:"unproject",value:function(t,e){for(var n=this.getViewports(),r={x:t[0],y:t[1]},i=n.length-1;i>=0;--i){var o=n[i];if(o.containsPixel(r)){var a=t.slice();return a[0]-=o.x,a[1]-=o.y,o.unproject(a,e)}}return null}},{key:"setProps",value:function(t){t.views&&this._setViews(t.views),t.viewState&&this._setViewState(t.viewState),("width"in t||"height"in t)&&this._setSize(t.width,t.height),this._isUpdating||this._update()}},{key:"_update",value:function(){this._isUpdating=!0,this._needsUpdate&&(this._needsUpdate=!1,this._rebuildViewports()),this._needsUpdate&&(this._needsUpdate=!1,this._rebuildViewports()),this._isUpdating=!1}},{key:"_setSize",value:function(t,e){t===this.width&&e===this.height||(this.width=t,this.height=e,this.setNeedsUpdate("Size changed"))}},{key:"_setViews",value:function(t){t=Object(f.b)(t,Boolean),this._diffViews(t,this.views)&&this.setNeedsUpdate("views changed"),this.views=t}},{key:"_setViewState",value:function(t){t?(!Object(l.a)(t,this.viewState)&&this.setNeedsUpdate("viewState changed"),this.viewState=t):h.a.warn("missing `viewState` or `initialViewState`")()}},{key:"_onViewStateChange",value:function(t,e){this._eventCallbacks.onViewStateChange&&this._eventCallbacks.onViewStateChange(d(d({},e),{},{viewId:t}))}},{key:"_createController",value:function(t,e){var n=this;return new(0,e.type)({timeline:this.timeline,eventManager:this._eventManager,onViewStateChange:this._onViewStateChange.bind(this,e.id),onStateChange:this._eventCallbacks.onInteractionStateChange,makeViewport:function(e){var r;return null===(r=n.getView(t.id))||void 0===r?void 0:r.makeViewport({viewState:e,width:n.width,height:n.height})}})}},{key:"_updateController",value:function(t,e,n,r){var i=t.controller;if(i){var o=d(d(d({},e),i),{},{id:t.id,x:n.x,y:n.y,width:n.width,height:n.height});return r||(r=this._createController(t,o)),r&&r.setProps(o),r}return null}},{key:"_rebuildViewports",value:function(){var t=this.views,e=this.controllers;this._viewports=[],this.controllers={};for(var n=!1,r=t.length;r--;){var i=t[r],o=this.getViewState(i),a=i.makeViewport({viewState:o,width:this.width,height:this.height}),s=e[i.id],u=Boolean(i.controller);u&&!s&&(n=!0),!n&&u||!s||(s.finalize(),s=null),this.controllers[i.id]=this._updateController(i,o,a,s),this._viewports.unshift(a)}for(var c in e){var l=e[c];l&&!this.controllers[c]&&l.finalize()}this._buildViewportMap()}},{key:"_buildViewportMap",value:function(){var t=this;this._viewportMap={},this._viewports.forEach((function(e){e.id&&(t._viewportMap[e.id]=t._viewportMap[e.id]||e)}))}},{key:"_diffViews",value:function(t,e){return t.length!==e.length||t.some((function(n,r){return!t[r].equals(e[r])}))}}]),t}(),g=n(153),m=n(139),y=n(107),v=n(13),_=n(8),b=n.n(_),x=n(5),w=n.n(x),E=n(6),O=n.n(E),S=n(1),T=n.n(S),C=n(74),P=n(7),M=n(12);function I(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function B(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?I(Object(n),!0).forEach((function(e){u()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):I(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function R(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=T()(t);if(e){var i=T()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return O()(this,n)}}var k=function(t){w()(n,t);var e=R(n);function n(t,r){var o,a;i()(this,n),a=e.call(this,t,r);var s=r.mapSize,c=void 0===s?2048:s;return a.maskMap=new y.a(t,{width:c,height:c,parameters:(o={},u()(o,10241,9729),u()(o,10240,9729),u()(o,10242,33071),u()(o,10243,33071),o)}),a.fbo=new C.a(t,{id:"maskmap",width:c,height:c,attachments:u()({},36064,a.maskMap)}),a}return a()(n,[{key:"render",value:function(t){var e=this,r=this.gl,i=[!1,!1,!1,!1];return i[t.channel]=!0,Object(P.o)(r,{clearColor:[255,255,255,255],blend:!0,blendFunc:[0,1],blendEquation:32778,colorMask:i,depthTest:!1},(function(){return b()(T()(n.prototype),"render",e).call(e,B(B({},t),{},{target:e.fbo,pass:"mask"}))}))}},{key:"shouldDrawLayer",value:function(t){return t.props.operation===M.c.MASK}},{key:"delete",value:function(){this.fbo.delete(),this.maskMap.delete()}}]),n}(n(73).a),D=n(158),L=n(86),j=n(19);function F(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return z(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return z(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function z(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function U(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return N(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return N(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function N(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var G=function(){function t(){i()(this,t),u()(this,"id","mask-effect"),u()(this,"props",null),u()(this,"useInPicking",!0),u()(this,"channels",[]),u()(this,"masks",null)}return a()(t,[{key:"preRender",value:function(t,e){var n=e.layers,r=e.layerFilter,i=e.viewports,o=e.onViewportActive,a=e.views;this.dummyMaskMap||(this.dummyMaskMap=new y.a(t,{width:1,height:1}));var s=n.filter((function(t){return t.props.visible&&t.props.operation===M.c.MASK}));if(0===s.length)return this.masks=null,void(this.channels.length=0);this.masks={},this.maskPass||(this.maskPass=new k(t,{id:"default-mask"}),this.maskMap=this.maskPass.maskMap);var u=this._sortMaskChannels(s),c=i[0],l=!this.lastViewport||!this.lastViewport.equals(c);for(var h in u)this._renderChannel(u[h],{layerFilter:r,onViewportActive:o,views:a,viewport:c,viewportChanged:l})}},{key:"_renderChannel",value:function(t,e){var n=e.layerFilter,r=e.onViewportActive,i=e.views,o=e.viewport,a=e.viewportChanged,s=this.channels[t.index];if(s){var u=t===s||s.layers.length!==t.layers.length||t.layerBounds.some((function(t,e){return t!==s.layerBounds[e]}));if(t.bounds=s.bounds,t.maskBounds=s.maskBounds,this.channels[t.index]=t,(u||a)&&(this.lastViewport=o,t.bounds=function(t){var e,n=t.layers,r=t.viewport,i=null,o=F(n);try{for(o.s();!(e=o.n()).done;){var a=e.value.getBounds();a&&(i?(i[0]=Math.min(i[0],a[0][0]),i[1]=Math.min(i[1],a[0][1]),i[2]=Math.max(i[2],a[1][0]),i[3]=Math.max(i[3],a[1][1])):i=[a[0][0],a[0][1],a[1][0],a[1][1]])}}catch(t){o.e(t)}finally{o.f()}var s=r.getBounds();if(!i)return s;var u=function(t){var e={x:t[2]-t[0],y:t[3]-t[1]},n={x:t[0]+.5*e.x,y:t[1]+.5*e.y};return[n.x-e.x,n.y-e.y,n.x+e.x,n.y+e.y]}(s);return i[2]-i[0]<u[2]-u[0]||i[3]-i[1]<u[3]-u[1]||(i[0]=Math.max(i[0],u[0]),i[1]=Math.max(i[1],u[1]),i[2]=Math.min(i[2],u[2]),i[3]=Math.min(i[3],u[3])),i}({layers:t.layers,viewport:o}),u||!Object(v.d)(t.bounds,s.bounds))){var c=this.maskPass,l=this.maskMap,f=function(t){var e=t.bounds,n=t.viewport,r=t.width,i=t.height;if(e[2]<=e[0]||e[3]<=e[1])return null;if(void 0!==n.resolution)return h.a.warn("MaskExtension is not supported in GlobeView")(),null;if(r-=2,i-=2,n.isGeospatial){var o=Object(j.c)({width:r,height:i,bounds:[[e[0],e[1]],[e[2],e[3]]],maxZoom:20}),a=o.longitude,s=o.latitude,u=o.zoom;return new L.a({longitude:a,latitude:s,zoom:u,x:1,y:1,width:r,height:i})}var c=[(e[0]+e[2])/2,(e[1]+e[3])/2,0],l=Math.min(1048576,r/(e[2]-e[0]),i/(e[3]-e[1]));return new D.a({x:1,y:1}).makeViewport({width:r,height:i,viewState:{target:c,zoom:Math.log2(l)}})}({bounds:t.bounds,viewport:o,width:l.width,height:l.height});t.maskBounds=f?f.getBounds():[0,0,1,1],c.render({pass:"mask",channel:t.index,layers:t.layers,layerFilter:n,viewports:f?[f]:[],onViewportActive:r,views:i,moduleParameters:{devicePixelRatio:1}})}this.masks[t.id]={index:t.index,bounds:t.maskBounds,coordinateOrigin:t.coordinateOrigin,coordinateSystem:t.coordinateSystem}}}},{key:"_sortMaskChannels",value:function(t){var e,n=this,r={},i=0,o=U(t);try{var a=function(){var t=e.value,o=t.root.id,a=r[o];if(!a){if(++i>4)return h.a.warn("Too many mask layers. The max supported is 4")(),"continue";a={id:o,index:n.channels.findIndex((function(t){return(null==t?void 0:t.id)===o})),layers:[],layerBounds:[],coordinateOrigin:t.root.props.coordinateOrigin,coordinateSystem:t.root.props.coordinateSystem},r[o]=a}a.layers.push(t),a.layerBounds.push(t.getBounds())};for(o.s();!(e=o.n()).done;)a()}catch(t){o.e(t)}finally{o.f()}for(var s=0;s<4;s++){var u=this.channels[s];u&&u.id in r||(this.channels[s]=null)}for(var c in r){var l=r[c];l.index<0&&(l.index=this.channels.findIndex((function(t){return!t})),this.channels[l.index]=l)}return r}},{key:"getModuleParameters",value:function(){return{maskMap:this.masks?this.maskMap:this.dummyMaskMap,maskChannels:this.masks}}},{key:"cleanup",value:function(){this.dummyMaskMap&&(this.dummyMaskMap.delete(),this.dummyMaskMap=void 0),this.maskPass&&(this.maskPass.delete(),this.maskPass=void 0,this.maskMap=void 0),this.lastViewport=void 0,this.masks=null,this.channels.length=0}}]),t}();function V(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return H(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return H(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function H(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var W=new m.a,q=function(){function t(){i()(this,t),this.effects=[],this._internalEffects=[],this._needsRedraw="Initial render",this.setEffects()}return a()(t,[{key:"setProps",value:function(t){"effects"in t&&(t.effects.length===this.effects.length&&Object(l.a)(t.effects,this.effects)||(this.setEffects(t.effects),this._needsRedraw="effects changed"))}},{key:"needsRedraw",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{clearRedrawFlags:!1},e=this._needsRedraw;return t.clearRedrawFlags&&(this._needsRedraw=!1),e}},{key:"getEffects",value:function(){return this._internalEffects}},{key:"finalize",value:function(){this.cleanup()}},{key:"setEffects",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:[];this.cleanup(),this.effects=t,this._internalEffects=t.slice(),this._internalEffects.push(new G),t.some((function(t){return t instanceof m.a}))||this._internalEffects.push(W)}},{key:"cleanup",value:function(){var t,e=V(this.effects);try{for(e.s();!(t=e.n()).done;){t.value.cleanup()}}catch(t){e.e(t)}finally{e.f()}var n,r=V(this._internalEffects);try{for(r.s();!(n=r.n()).done;){n.value.cleanup()}}catch(t){r.e(t)}finally{r.f()}this.effects.length=0,this._internalEffects.length=0}}]),t}(),X=n(172),Z=n(206),J=n(180);function Q(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function K(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Q(Object(n),!0).forEach((function(e){u()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Q(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var Y={pickedColor:null,pickedObjectIndex:-1};function $(t){for(var e=t.pickedColors,n=t.decodePickingColor,r=t.deviceX,i=t.deviceY,o=t.deviceRadius,a=t.deviceRect,s=a.x,u=a.y,c=a.width,l=a.height,f=o*o,p=-1,d=0,A=0;A<l;A++){var g=A+u-i,m=g*g;if(m>f)d+=4*c;else for(var y=0;y<c;y++){if(e[d+3]-1>=0){var v=y+s-r,_=v*v+m;_<=f&&(f=_,p=d)}d+=4}}if(p>=0){var b=e.slice(p,p+4),x=n(b);if(x){var w=Math.floor(p/4/c),E=p/4-w*c;return K(K({},x),{},{pickedColor:b,pickedX:s+E,pickedY:u+w})}h.a.error("Picked non-existent layer. Is picking buffer corrupt?")()}return Y}function tt(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function et(t){var e,n=t.pickInfo,r=t.viewports,i=t.pixelRatio,o=t.x,a=t.y,s=t.z,u=r[0];if(r.length>1&&(u=function(t,e){for(var n=t.length-1;n>=0;n--){var r=t[n];if(r.containsPixel(e))return r}return t[0]}((null==n?void 0:n.pickedViewports)||r,{x:o,y:a})),u){var c=[o-u.x,a-u.y];void 0!==s&&(c[2]=s),e=u.unproject(c)}return{color:null,layer:null,viewport:u,index:-1,picked:!1,x:o,y:a,pixel:[o,a],coordinate:e,devicePixel:n&&"pickedX"in n?[n.pickedX,n.pickedY]:void 0,pixelRatio:i}}function nt(t){var e=t.pickInfo,n=t.lastPickedInfo,r=t.mode,i=t.layers,o=e.pickedColor,a=e.pickedLayer,s=e.pickedObjectIndex,c=a?[a]:[];if("hover"===r){var l=n.index,h=n.layerId,f=a?a.props.id:null;if(f!==h||s!==l){if(f!==h){var p=i.find((function(t){return t.props.id===h}));p&&c.unshift(p)}n.layerId=f,n.index=s,n.info=null}}var d=et(t),A=new Map;return A.set(null,d),c.forEach((function(t){var e=function(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?tt(Object(n),!0).forEach((function(e){u()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):tt(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}({},d);t===a&&(e.color=o,e.index=s,e.picked=!0);var i=(e=rt({layer:t,info:e,mode:r})).layer;t===a&&"hover"===r&&(n.info=e),A.set(i.id,e),"hover"===r&&i.updateAutoHighlight(e)})),A}function rt(t){for(var e=t.layer,n=t.info,r=t.mode;e&&n;){var i=n.layer||null;n.sourceLayer=i,n.layer=e,n=e.getPickingInfo({info:n,mode:r,sourceLayer:i}),e=e.parent}return n}function it(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return ot(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return ot(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function ot(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function at(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function st(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?at(Object(n),!0).forEach((function(e){u()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):at(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var ut=function(){function t(e){i()(this,t),u()(this,"_pickable",!0),this.gl=e,this.pickLayersPass=new J.a(e),this.lastPickedInfo={index:-1,layerId:null,info:null}}return a()(t,[{key:"setProps",value:function(t){"layerFilter"in t&&(this.layerFilter=t.layerFilter),"_pickable"in t&&(this._pickable=t._pickable)}},{key:"finalize",value:function(){this.pickingFBO&&this.pickingFBO.delete(),this.depthFBO&&(this.depthFBO.color.delete(),this.depthFBO.delete())}},{key:"pickObject",value:function(t){return this._pickClosestObject(t)}},{key:"pickObjects",value:function(t){return this._pickVisibleObjects(t)}},{key:"getLastPickedObject",value:function(t){var e=t.x,n=t.y,r=t.layers,i=t.viewports,o=arguments.length>1&&void 0!==arguments[1]?arguments[1]:this.lastPickedInfo.info,a=o&&o.layer&&o.layer.id,s=o&&o.viewport&&o.viewport.id,u=a?r.find((function(t){return t.id===a})):null,c=s&&i.find((function(t){return t.id===s}))||i[0],l=c&&c.unproject([e-c.x,n-c.y]),h={x:e,y:n,viewport:c,coordinate:l,layer:u};return st(st({},o),h)}},{key:"_resizeBuffer",value:function(){var t,e,n=this.gl;if(!this.pickingFBO&&(this.pickingFBO=new C.a(n),C.a.isSupported(n,{colorBufferFloat:!0}))){var r=new C.a(n);r.attach(u()({},36064,new y.a(n,{format:Object(P.j)(n)?34836:6408,type:5126}))),this.depthFBO=r}null===(t=this.pickingFBO)||void 0===t||t.resize({width:n.canvas.width,height:n.canvas.height}),null===(e=this.depthFBO)||void 0===e||e.resize({width:n.canvas.width,height:n.canvas.height})}},{key:"_getPickable",value:function(t){if(!1===this._pickable)return null;var e=t.filter((function(t){return t.isPickable()&&!t.isComposite}));return e.length?e:null}},{key:"_pickClosestObject",value:function(t){var e=t.layers,n=t.views,r=t.viewports,i=t.x,o=t.y,a=t.radius,s=void 0===a?0:a,u=t.depth,c=void 0===u?1:u,l=t.mode,h=void 0===l?"query":l,f=t.unproject3D,p=t.onViewportActive,d=t.effects,A=this._getPickable(e),g=Object(P.e)(this.gl);if(!A)return{result:[],emptyInfo:et({viewports:r,x:i,y:o,pixelRatio:g})};this._resizeBuffer();for(var m,y=Object(P.d)(this.gl,[i,o],!0),v=[y.x+Math.floor(y.width/2),y.y+Math.floor(y.height/2)],_=Math.round(s*g),b=this.pickingFBO,x=b.width,w=b.height,E=this._getPickingRect({deviceX:v[0],deviceY:v[1],deviceRadius:_,deviceWidth:x,deviceHeight:w}),O={x:i-s,y:o-s,width:2*s+1,height:2*s+1},S=[],T=new Set,C=0;C<c;C++){var M=void 0;if(E)M=$(st(st({},this._drawAndSample({layers:A,views:n,viewports:r,onViewportActive:p,deviceRect:E,cullRect:O,effects:d,pass:"picking:".concat(h)})),{},{deviceX:v[0],deviceY:v[1],deviceRadius:_,deviceRect:E}));else M={pickedColor:null,pickedObjectIndex:-1};var I=void 0;if(M.pickedLayer&&f&&this.depthFBO)I=this._drawAndSample({layers:[M.pickedLayer],views:n,viewports:r,onViewportActive:p,deviceRect:{x:M.pickedX,y:M.pickedY,width:1,height:1},cullRect:O,effects:d,pass:"picking:".concat(h,":z")},!0).pickedColors[0];M.pickedLayer&&C+1<c&&(T.add(M.pickedLayer),M.pickedLayer.disablePickingIndex(M.pickedObjectIndex));var B,R=it((m=nt({pickInfo:M,lastPickedInfo:this.lastPickedInfo,mode:h,layers:A,viewports:r,x:i,y:o,z:I,pixelRatio:g})).values());try{for(R.s();!(B=R.n()).done;){var k=B.value;k.layer&&S.push(k)}}catch(t){R.e(t)}finally{R.f()}if(!M.pickedColor)break}var D,L=it(T);try{for(L.s();!(D=L.n()).done;){D.value.restorePickingColors()}}catch(t){L.e(t)}finally{L.f()}return{result:S,emptyInfo:m.get(null)}}},{key:"_pickVisibleObjects",value:function(t){var e=t.layers,n=t.views,r=t.viewports,i=t.x,o=t.y,a=t.width,s=void 0===a?1:a,u=t.height,c=void 0===u?1:u,l=t.mode,f=void 0===l?"query":l,p=t.maxObjects,d=void 0===p?null:p,A=t.onViewportActive,g=t.effects,m=this._getPickable(e);if(!m)return[];this._resizeBuffer();for(var y=Object(P.e)(this.gl),v=Object(P.d)(this.gl,[i,o],!0),_=v.x,b=v.y+v.height,x=Object(P.d)(this.gl,[i+s,o+c],!0),w=x.x+x.width,E=x.y,O={x:_,y:E,width:w-_,height:b-E},S=function(t){var e=t.pickedColors,n=t.decodePickingColor,r=new Map;if(e)for(var i=0;i<e.length;i+=4){if(e[i+3]-1>=0){var o=e.slice(i,i+4),a=o.join(",");if(!r.has(a)){var s=n(o);s?r.set(a,K(K({},s),{},{color:o})):h.a.error("Picked non-existent layer. Is picking buffer corrupt?")()}}}return Array.from(r.values())}(this._drawAndSample({layers:m,views:n,viewports:r,onViewportActive:A,deviceRect:O,cullRect:{x:i,y:o,width:s,height:c},effects:g,pass:"picking:".concat(f)})),T=new Map,C=Number.isFinite(d),M=0;M<S.length&&!(C&&d&&T.size>=d);M++){var I=S[M],B={color:I.pickedColor,layer:null,index:I.pickedObjectIndex,picked:!0,x:i,y:o,pixelRatio:y};B=rt({layer:I.pickedLayer,info:B,mode:f}),T.has(B.object)||T.set(B.object,B)}return Array.from(T.values())}},{key:"_drawAndSample",value:function(t){var e=t.layers,n=t.views,r=t.viewports,i=t.onViewportActive,o=t.deviceRect,a=t.cullRect,s=t.effects,u=t.pass,c=arguments.length>1&&void 0!==arguments[1]&&arguments[1],l=c?this.depthFBO:this.pickingFBO,h=this.pickLayersPass.render({layers:e,layerFilter:this.layerFilter,views:n,viewports:r,onViewportActive:i,pickingFBO:l,deviceRect:o,cullRect:a,effects:s,pass:u,pickZ:c}),f=h.decodePickingColor,p=o.x,d=o.y,A=o.width,g=o.height,m=new(c?Float32Array:Uint8Array)(A*g*4);return Object(Z.c)(l,{sourceX:p,sourceY:d,sourceWidth:A,sourceHeight:g,target:m}),{pickedColors:m,decodePickingColor:f}}},{key:"_getPickingRect",value:function(t){var e=t.deviceX,n=t.deviceY,r=t.deviceRadius,i=t.deviceWidth,o=t.deviceHeight,a=Math.max(0,e-r),s=Math.max(0,n-r),u=Math.min(i,e+r+1)-a,c=Math.min(o,n+r+1)-s;return u<=0||c<=0?null:{x:a,y:s,width:u,height:c}}}]),t}(),ct={zIndex:"1",position:"absolute",pointerEvents:"none",color:"#a0a7b4",backgroundColor:"#29323c",padding:"10px",top:"0",left:"0",display:"none"},lt=function(){function t(e){i()(this,t),u()(this,"el",null),u()(this,"isVisible",!1);var n=e.parentElement;n&&(this.el=document.createElement("div"),this.el.className="deck-tooltip",Object.assign(this.el.style,ct),n.appendChild(this.el))}return a()(t,[{key:"setTooltip",value:function(t,e,n){var r=this.el;if(r){if("string"==typeof t)r.innerText=t;else{if(!t)return this.isVisible=!1,void(r.style.display="none");t.text&&(r.innerText=t.text),t.html&&(r.innerHTML=t.html),t.className&&(r.className=t.className),Object.assign(r.style,t.style)}this.isVisible=!0,r.style.display="block",r.style.transform="translate(".concat(e,"px, ").concat(n,"px)")}}},{key:"remove",value:function(){this.el&&(this.el.remove(),this.el=null)}}]),t}(),ht=n(68),ft=n(200),pt=n(313),dt=n(132),At=n(10),gt=n(38),mt=n(251),yt=n(189);class vt extends gt.a{get[Symbol.toStringTag](){return"Query"}static isSupported(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:[];const n=Object(P.j)(t),r=Object(mt.c)(t,yt.a.TIMER_QUERY);let i=n||r;for(const t of e)switch(t){case"queries":i=i&&n;break;case"timers":i=i&&r;break;default:Object(At.a)(!1)}return i}constructor(t){super(t,arguments.length>1&&void 0!==arguments[1]?arguments[1]:{}),this.target=null,this._queryPending=!1,this._pollingPromise=null,Object.seal(this)}beginTimeElapsedQuery(){return this.begin(35007)}beginOcclusionQuery(){let{conservative:t=!1}=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return this.begin(t?36202:35887)}beginTransformFeedbackQuery(){return this.begin(35976)}begin(t){return this._queryPending||(this.target=t,this.gl2.beginQuery(this.target,this.handle)),this}end(){return this._queryPending||this.target&&(this.gl2.endQuery(this.target),this.target=null,this._queryPending=!0),this}isResultAvailable(){if(!this._queryPending)return!1;const t=this.gl2.getQueryParameter(this.handle,34919);return t&&(this._queryPending=!1),t}isTimerDisjoint(){return this.gl2.getParameter(36795)}getResult(){return this.gl2.getQueryParameter(this.handle,34918)}getTimerMilliseconds(){return this.getResult()/1e6}createPoll(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:Number.POSITIVE_INFINITY;if(this._pollingPromise)return this._pollingPromise;let e=0;return this._pollingPromise=new Promise((n,r)=>{const i=()=>{this.isResultAvailable()?(n(this.getResult()),this._pollingPromise=null):e++>t?(r("Timed out"),this._pollingPromise=null):requestAnimationFrame(i)};requestAnimationFrame(i)}),this._pollingPromise}_createHandle(){return vt.isSupported(this.gl)?this.gl2.createQuery():null}_deleteHandle(){this.gl2.deleteQuery(this.handle)}}var _t=n(142);const bt=Object(_t.a)()&&"undefined"!=typeof document;let xt=0;class wt{constructor(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{onCreateContext:e=(t=>Object(P.c)(t)),onAddHTML:n=null,onInitialize:r=(()=>{}),onRender:i=(()=>{}),onFinalize:o=(()=>{}),onError:a,gl:s=null,glOptions:u={},debug:c=!1,createFramebuffer:l=!1,autoResizeViewport:h=!0,autoResizeDrawingBuffer:f=!0,stats:p=dt.b.get("animation-loop-".concat(xt++))}=t;let{useDevicePixels:d=!0}=t;"useDevicePixelRatio"in t&&(P.k.deprecated("useDevicePixelRatio","useDevicePixels")(),d=t.useDevicePixelRatio),this.props={onCreateContext:e,onAddHTML:n,onInitialize:r,onRender:i,onFinalize:o,onError:a,gl:s,glOptions:u,debug:c,createFramebuffer:l},this.gl=s,this.needsRedraw=null,this.timeline=null,this.stats=p,this.cpuTime=this.stats.get("CPU Time"),this.gpuTime=this.stats.get("GPU Time"),this.frameRate=this.stats.get("Frame Rate"),this._initialized=!1,this._running=!1,this._animationFrameId=null,this._nextFramePromise=null,this._resolveNextFrame=null,this._cpuStartTime=0,this.setProps({autoResizeViewport:h,autoResizeDrawingBuffer:f,useDevicePixels:d}),this.start=this.start.bind(this),this.stop=this.stop.bind(this),this._pageLoadPromise=null,this._onMousemove=this._onMousemove.bind(this),this._onMouseleave=this._onMouseleave.bind(this)}delete(){this.stop(),this._setDisplay(null)}setNeedsRedraw(t){return Object(At.a)("string"==typeof t),this.needsRedraw=this.needsRedraw||t,this}setProps(t){return"autoResizeViewport"in t&&(this.autoResizeViewport=t.autoResizeViewport),"autoResizeDrawingBuffer"in t&&(this.autoResizeDrawingBuffer=t.autoResizeDrawingBuffer),"useDevicePixels"in t&&(this.useDevicePixels=t.useDevicePixels),this}start(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};if(this._running)return this;this._running=!0;const e=this._getPageLoadPromise().then(()=>!this._running||this._initialized?null:(this._createWebGLContext(t),this._createFramebuffer(),this._startEventHandling(),this._initializeCallbackData(),this._updateCallbackData(),this._resizeCanvasDrawingBuffer(),this._resizeViewport(),this._gpuTimeQuery=vt.isSupported(this.gl,["timers"])?new vt(this.gl):null,this._initialized=!0,this.onInitialize(this.animationProps))).then(t=>{this._running&&(this._addCallbackData(t||{}),!1!==t&&this._startLoop())});return this.props.onError&&e.catch(this.props.onError),this}redraw(){return this.isContextLost()||(this._beginTimers(),this._setupFrame(),this._updateCallbackData(),this._renderFrame(this.animationProps),this._clearNeedsRedraw(),this.offScreen&&this.gl.commit&&this.gl.commit(),this._resolveNextFrame&&(this._resolveNextFrame(this),this._nextFramePromise=null,this._resolveNextFrame=null),this._endTimers()),this}stop(){return this._running&&(this._finalizeCallbackData(),this._cancelAnimationFrame(this._animationFrameId),this._nextFramePromise=null,this._resolveNextFrame=null,this._animationFrameId=null,this._running=!1),this}attachTimeline(t){return this.timeline=t,this.timeline}detachTimeline(){this.timeline=null}waitForRender(){return this.setNeedsRedraw("waitForRender"),this._nextFramePromise||(this._nextFramePromise=new Promise(t=>{this._resolveNextFrame=t})),this._nextFramePromise}async toDataURL(){return this.setNeedsRedraw("toDataURL"),await this.waitForRender(),this.gl.canvas.toDataURL()}isContextLost(){return this.gl.isContextLost()}onCreateContext(){return this.props.onCreateContext(...arguments)}onInitialize(){return this.props.onInitialize(...arguments)}onRender(){return this.props.onRender(...arguments)}onFinalize(){return this.props.onFinalize(...arguments)}getHTMLControlValue(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:1;const n=document.getElementById(t);return n?Number(n.value):e}setViewParameters(){return P.k.removed("AnimationLoop.setViewParameters","AnimationLoop.setProps")(),this}_startLoop(){const t=()=>{this._running&&(this.redraw(),this._animationFrameId=this._requestAnimationFrame(t))};this._cancelAnimationFrame(this._animationFrameId),this._animationFrameId=this._requestAnimationFrame(t)}_getPageLoadPromise(){return this._pageLoadPromise||(this._pageLoadPromise=bt?new Promise((t,e)=>{bt&&"complete"===document.readyState?t(document):window.addEventListener("load",()=>{t(document)})}):Promise.resolve({})),this._pageLoadPromise}_setDisplay(t){this.display&&(this.display.delete(),this.display.animationLoop=null),t&&(t.animationLoop=this),this.display=t}_cancelAnimationFrame(t){return this.display&&this.display.cancelAnimationFrame?this.display.cancelAnimationFrame(t):(e=t,"undefined"!=typeof window&&window.cancelAnimationFrame?window.cancelAnimationFrame(e):clearTimeout(e));var e}_requestAnimationFrame(t){if(this._running)return this.display&&this.display.requestAnimationFrame?this.display.requestAnimationFrame(t):(e=t,"undefined"!=typeof window&&window.requestAnimationFrame?window.requestAnimationFrame(e):setTimeout(e,1e3/60));var e}_renderFrame(){this.display?this.display._renderFrame(...arguments):this.onRender(...arguments)}_clearNeedsRedraw(){this.needsRedraw=null}_setupFrame(){this._resizeCanvasDrawingBuffer(),this._resizeViewport(),this._resizeFramebuffer()}_initializeCallbackData(){this.animationProps={gl:this.gl,stop:this.stop,canvas:this.gl.canvas,framebuffer:this.framebuffer,useDevicePixels:this.useDevicePixels,needsRedraw:null,startTime:Date.now(),engineTime:0,tick:0,tock:0,time:0,_timeline:this.timeline,_loop:this,_animationLoop:this,_mousePosition:null}}_updateCallbackData(){const{width:t,height:e,aspect:n}=this._getSizeAndAspect();t===this.animationProps.width&&e===this.animationProps.height||this.setNeedsRedraw("drawing buffer resized"),n!==this.animationProps.aspect&&this.setNeedsRedraw("drawing buffer aspect changed"),this.animationProps.width=t,this.animationProps.height=e,this.animationProps.aspect=n,this.animationProps.needsRedraw=this.needsRedraw,this.animationProps.engineTime=Date.now()-this.animationProps.startTime,this.timeline&&this.timeline.update(this.animationProps.engineTime),this.animationProps.tick=Math.floor(this.animationProps.time/1e3*60),this.animationProps.tock++,this.animationProps.time=this.timeline?this.timeline.getTime():this.animationProps.engineTime,this.animationProps._offScreen=this.offScreen}_finalizeCallbackData(){this.onFinalize(this.animationProps)}_addCallbackData(t){"object"==typeof t&&null!==t&&(this.animationProps=Object.assign({},this.animationProps,t))}_createWebGLContext(t){if(this.offScreen=t.canvas&&"undefined"!=typeof OffscreenCanvas&&t.canvas instanceof OffscreenCanvas,t=Object.assign({},t,this.props.glOptions),this.gl=this.props.gl?Object(P.h)(this.props.gl,t):this.onCreateContext(t),!Object(P.i)(this.gl))throw new Error("AnimationLoop.onCreateContext - illegal context returned");Object(P.l)(this.gl),this._createInfoDiv()}_createInfoDiv(){if(this.gl.canvas&&this.props.onAddHTML){const t=document.createElement("div");document.body.appendChild(t),t.style.position="relative";const e=document.createElement("div");e.style.position="absolute",e.style.left="10px",e.style.bottom="10px",e.style.width="300px",e.style.background="white",t.appendChild(this.gl.canvas),t.appendChild(e);const n=this.props.onAddHTML(e);n&&(e.innerHTML=n)}}_getSizeAndAspect(){const t=this.gl.drawingBufferWidth,e=this.gl.drawingBufferHeight;let n=1;const{canvas:r}=this.gl;return r&&r.clientHeight?n=r.clientWidth/r.clientHeight:t>0&&e>0&&(n=t/e),{width:t,height:e,aspect:n}}_resizeViewport(){this.autoResizeViewport&&this.gl.viewport(0,0,this.gl.drawingBufferWidth,this.gl.drawingBufferHeight)}_resizeCanvasDrawingBuffer(){this.autoResizeDrawingBuffer&&Object(P.m)(this.gl,{useDevicePixels:this.useDevicePixels})}_createFramebuffer(){this.props.createFramebuffer&&(this.framebuffer=new C.a(this.gl))}_resizeFramebuffer(){this.framebuffer&&this.framebuffer.resize({width:this.gl.drawingBufferWidth,height:this.gl.drawingBufferHeight})}_beginTimers(){this.frameRate.timeEnd(),this.frameRate.timeStart(),this._gpuTimeQuery&&this._gpuTimeQuery.isResultAvailable()&&!this._gpuTimeQuery.isTimerDisjoint()&&this.stats.get("GPU Time").addTime(this._gpuTimeQuery.getTimerMilliseconds()),this._gpuTimeQuery&&this._gpuTimeQuery.beginTimeElapsedQuery(),this.cpuTime.timeStart()}_endTimers(){this.cpuTime.timeEnd(),this._gpuTimeQuery&&this._gpuTimeQuery.end()}_startEventHandling(){const{canvas:t}=this.gl;t&&(t.addEventListener("mousemove",this._onMousemove),t.addEventListener("mouseleave",this._onMouseleave))}_onMousemove(t){this.animationProps._mousePosition=[t.offsetX,t.offsetY]}_onMouseleave(t){this.animationProps._mousePosition=null}}var Et=n(315),Ot=n(76),St=n(147),Tt=n.n(St);const Ct={mousedown:1,mousemove:2,mouseup:4};!function(t){const e=t.prototype.handler;t.prototype.handler=function(t){const n=this.store;t.button>0&&"pointerdown"===t.type&&(function(t,e){for(let n=0;n<t.length;n++)if(e(t[n]))return!0;return!1}(n,e=>e.pointerId===t.pointerId)||n.push(t)),e.call(this,t)}}(Tt.a.PointerEventInput),Tt.a.MouseInput.prototype.handler=function(t){let e=Ct[t.type];1&e&&t.button>=0&&(this.pressed=!0),2&e&&0===t.which&&(e=4),this.pressed&&(4&e&&(this.pressed=!1),this.callback(this.manager,e,{pointers:[t],changedPointers:[t],pointerType:"mouse",srcEvent:t}))};const Pt=Tt.a.Manager;var Mt=Tt.a;class It{constructor(t,e,n){this.element=t,this.callback=e,this.options={enable:!0,...n}}}const Bt=Mt?[[Mt.Pan,{event:"tripan",pointers:3,threshold:0,enable:!1}],[Mt.Rotate,{enable:!1}],[Mt.Pinch,{enable:!1}],[Mt.Swipe,{enable:!1}],[Mt.Pan,{threshold:0,enable:!1}],[Mt.Press,{enable:!1}],[Mt.Tap,{event:"doubletap",taps:2,enable:!1}],[Mt.Tap,{event:"anytap",enable:!1}],[Mt.Tap,{enable:!1}]]:null,Rt={tripan:["rotate","pinch","pan"],rotate:["pinch"],pinch:["pan"],pan:["press","doubletap","anytap","tap"],doubletap:["anytap"],anytap:["tap"]},kt={doubletap:["tap"]},Dt={pointerdown:"pointerdown",pointermove:"pointermove",pointerup:"pointerup",touchstart:"pointerdown",touchmove:"pointermove",touchend:"pointerup",mousedown:"pointerdown",mousemove:"pointermove",mouseup:"pointerup"},Lt={KEY_EVENTS:["keydown","keyup"],MOUSE_EVENTS:["mousedown","mousemove","mouseup","mouseover","mouseout","mouseleave"],WHEEL_EVENTS:["wheel","mousewheel"]},jt={tap:"tap",anytap:"anytap",doubletap:"doubletap",press:"press",pinch:"pinch",pinchin:"pinch",pinchout:"pinch",pinchstart:"pinch",pinchmove:"pinch",pinchend:"pinch",pinchcancel:"pinch",rotate:"rotate",rotatestart:"rotate",rotatemove:"rotate",rotateend:"rotate",rotatecancel:"rotate",tripan:"tripan",tripanstart:"tripan",tripanmove:"tripan",tripanup:"tripan",tripandown:"tripan",tripanleft:"tripan",tripanright:"tripan",tripanend:"tripan",tripancancel:"tripan",pan:"pan",panstart:"pan",panmove:"pan",panup:"pan",pandown:"pan",panleft:"pan",panright:"pan",panend:"pan",pancancel:"pan",swipe:"swipe",swipeleft:"swipe",swiperight:"swipe",swipeup:"swipe",swipedown:"swipe"},Ft={click:"tap",anyclick:"anytap",dblclick:"doubletap",mousedown:"pointerdown",mousemove:"pointermove",mouseup:"pointerup",mouseover:"pointerover",mouseout:"pointerout",mouseleave:"pointerleave"};var zt=n(110);const Ut=-1!==zt.b.indexOf("firefox"),{WHEEL_EVENTS:Nt}=Lt;class Gt extends It{constructor(t,e,n){super(t,e,n),this.handleEvent=t=>{if(!this.options.enable)return;let e=t.deltaY;zt.c.WheelEvent&&(Ut&&t.deltaMode===zt.c.WheelEvent.DOM_DELTA_PIXEL&&(e/=zt.c.devicePixelRatio),t.deltaMode===zt.c.WheelEvent.DOM_DELTA_LINE&&(e*=40)),0!==e&&e%4.000244140625==0&&(e=Math.floor(e/4.000244140625)),t.shiftKey&&e&&(e*=.25),this.callback({type:"wheel",center:{x:t.clientX,y:t.clientY},delta:-e,srcEvent:t,pointerType:"mouse",target:t.target})},this.events=(this.options.events||[]).concat(Nt),this.events.forEach(e=>t.addEventListener(e,this.handleEvent,!!zt.a&&{passive:!1}))}destroy(){this.events.forEach(t=>this.element.removeEventListener(t,this.handleEvent))}enableEventType(t,e){"wheel"===t&&(this.options.enable=e)}}const{MOUSE_EVENTS:Vt}=Lt;class Ht extends It{constructor(t,e,n){super(t,e,n),this.handleEvent=t=>{this.handleOverEvent(t),this.handleOutEvent(t),this.handleEnterEvent(t),this.handleLeaveEvent(t),this.handleMoveEvent(t)},this.pressed=!1;const{enable:r}=this.options;this.enableMoveEvent=r,this.enableLeaveEvent=r,this.enableEnterEvent=r,this.enableOutEvent=r,this.enableOverEvent=r,this.events=(this.options.events||[]).concat(Vt),this.events.forEach(e=>t.addEventListener(e,this.handleEvent))}destroy(){this.events.forEach(t=>this.element.removeEventListener(t,this.handleEvent))}enableEventType(t,e){"pointermove"===t&&(this.enableMoveEvent=e),"pointerover"===t&&(this.enableOverEvent=e),"pointerout"===t&&(this.enableOutEvent=e),"pointerenter"===t&&(this.enableEnterEvent=e),"pointerleave"===t&&(this.enableLeaveEvent=e)}handleOverEvent(t){this.enableOverEvent&&"mouseover"===t.type&&this._emit("pointerover",t)}handleOutEvent(t){this.enableOutEvent&&"mouseout"===t.type&&this._emit("pointerout",t)}handleEnterEvent(t){this.enableEnterEvent&&"mouseenter"===t.type&&this._emit("pointerenter",t)}handleLeaveEvent(t){this.enableLeaveEvent&&"mouseleave"===t.type&&this._emit("pointerleave",t)}handleMoveEvent(t){if(this.enableMoveEvent)switch(t.type){case"mousedown":t.button>=0&&(this.pressed=!0);break;case"mousemove":0===t.which&&(this.pressed=!1),this.pressed||this._emit("pointermove",t);break;case"mouseup":this.pressed=!1}}_emit(t,e){this.callback({type:t,center:{x:e.clientX,y:e.clientY},srcEvent:e,pointerType:"mouse",target:e.target})}}const{KEY_EVENTS:Wt}=Lt;class qt extends It{constructor(t,e,n){super(t,e,n),this.handleEvent=t=>{const e=t.target||t.srcElement;"INPUT"===e.tagName&&"text"===e.type||"TEXTAREA"===e.tagName||(this.enableDownEvent&&"keydown"===t.type&&this.callback({type:"keydown",srcEvent:t,key:t.key,target:t.target}),this.enableUpEvent&&"keyup"===t.type&&this.callback({type:"keyup",srcEvent:t,key:t.key,target:t.target}))},this.enableDownEvent=this.options.enable,this.enableUpEvent=this.options.enable,this.events=(this.options.events||[]).concat(Wt),t.tabIndex=this.options.tabIndex||0,t.style.outline="none",this.events.forEach(e=>t.addEventListener(e,this.handleEvent))}destroy(){this.events.forEach(t=>this.element.removeEventListener(t,this.handleEvent))}enableEventType(t,e){"keydown"===t&&(this.enableDownEvent=e),"keyup"===t&&(this.enableUpEvent=e)}}class Xt extends It{constructor(t,e,n){super(t,e,n),this.handleEvent=t=>{this.options.enable&&this.callback({type:"contextmenu",center:{x:t.clientX,y:t.clientY},srcEvent:t,pointerType:"mouse",target:t.target})},t.addEventListener("contextmenu",this.handleEvent)}destroy(){this.element.removeEventListener("contextmenu",this.handleEvent)}enableEventType(t,e){"contextmenu"===t&&(this.options.enable=e)}}const Zt={pointerdown:1,pointermove:2,pointerup:4,mousedown:1,mousemove:2,mouseup:4};function Jt(t){const e=Zt[t.srcEvent.type];if(!e)return null;const{buttons:n,button:r,which:i}=t.srcEvent;let o=!1,a=!1,s=!1;return 4===e||2===e&&!Number.isFinite(n)?(o=1===i,a=2===i,s=3===i):2===e?(o=Boolean(1&n),a=Boolean(4&n),s=Boolean(2&n)):1===e&&(o=0===r,a=1===r,s=2===r),{leftButton:o,middleButton:a,rightButton:s}}function Qt(t,e){const n=t.center;if(!n)return null;const r=e.getBoundingClientRect(),i=r.width/e.offsetWidth||1,o=r.height/e.offsetHeight||1;return{center:n,offsetCenter:{x:(n.x-r.left-e.clientLeft)/i,y:(n.y-r.top-e.clientTop)/o}}}const Kt={srcElement:"root",priority:0};class Yt{constructor(t){this.handleEvent=t=>{if(this.isEmpty())return;const e=this._normalizeEvent(t);let n=t.srcEvent.target;for(;n&&n!==e.rootElement;){if(this._emit(e,n),e.handled)return;n=n.parentNode}this._emit(e,"root")},this.eventManager=t,this.handlers=[],this.handlersByElement=new Map,this._active=!1}isEmpty(){return!this._active}add(t,e,n,r=!1,i=!1){const{handlers:o,handlersByElement:a}=this;let s=Kt;"string"==typeof n||n&&n.addEventListener?s={...Kt,srcElement:n}:n&&(s={...Kt,...n});let u=a.get(s.srcElement);u||(u=[],a.set(s.srcElement,u));const c={type:t,handler:e,srcElement:s.srcElement,priority:s.priority};r&&(c.once=!0),i&&(c.passive=!0),o.push(c),this._active=this._active||!c.passive;let l=u.length-1;for(;l>=0&&!(u[l].priority>=c.priority);)l--;u.splice(l+1,0,c)}remove(t,e){const{handlers:n,handlersByElement:r}=this;for(let i=n.length-1;i>=0;i--){const o=n[i];if(o.type===t&&o.handler===e){n.splice(i,1);const t=r.get(o.srcElement);t.splice(t.indexOf(o),1),0===t.length&&r.delete(o.srcElement)}}this._active=n.some(t=>!t.passive)}_emit(t,e){const n=this.handlersByElement.get(e);if(n){let e=!1;const r=()=>{t.handled=!0},i=()=>{t.handled=!0,e=!0},o=[];for(let a=0;a<n.length;a++){const{type:s,handler:u,once:c}=n[a];if(u({...t,type:s,stopPropagation:r,stopImmediatePropagation:i}),c&&o.push(n[a]),e)break}for(let t=0;t<o.length;t++){const{type:e,handler:n}=o[t];this.remove(e,n)}}}_normalizeEvent(t){const e=this.eventManager.getElement();return{...t,...Jt(t),...Qt(t,e),preventDefault:()=>{t.srcEvent.preventDefault()},stopImmediatePropagation:null,stopPropagation:null,handled:!1,rootElement:e}}}const $t={events:null,recognizers:null,recognizerOptions:{},Manager:Pt,touchAction:"none",tabIndex:0};class te{constructor(t=null,e){this._onBasicInput=t=>{const{srcEvent:e}=t,n=Dt[e.type];n&&this.manager.emit(n,t)},this._onOtherEvent=t=>{this.manager.emit(t.type,t)},this.options={...$t,...e},this.events=new Map,this.setElement(t);const{events:n}=this.options;n&&this.on(n)}getElement(){return this.element}setElement(t){if(this.element&&this.destroy(),this.element=t,!t)return;const{options:e}=this,n=e.Manager;this.manager=new n(t,{touchAction:e.touchAction,recognizers:e.recognizers||Bt}).on("hammer.input",this._onBasicInput),e.recognizers||Object.keys(Rt).forEach(t=>{const e=this.manager.get(t);e&&Rt[t].forEach(t=>{e.recognizeWith(t)})});for(const t in e.recognizerOptions){const n=this.manager.get(t);if(n){const r=e.recognizerOptions[t];delete r.enable,n.set(r)}}this.wheelInput=new Gt(t,this._onOtherEvent,{enable:!1}),this.moveInput=new Ht(t,this._onOtherEvent,{enable:!1}),this.keyInput=new qt(t,this._onOtherEvent,{enable:!1,tabIndex:e.tabIndex}),this.contextmenuInput=new Xt(t,this._onOtherEvent,{enable:!1});for(const[t,e]of this.events)e.isEmpty()||(this._toggleRecognizer(e.recognizerName,!0),this.manager.on(t,e.handleEvent))}destroy(){this.element&&(this.wheelInput.destroy(),this.moveInput.destroy(),this.keyInput.destroy(),this.contextmenuInput.destroy(),this.manager.destroy(),this.wheelInput=null,this.moveInput=null,this.keyInput=null,this.contextmenuInput=null,this.manager=null,this.element=null)}on(t,e,n){this._addEventHandler(t,e,n,!1)}once(t,e,n){this._addEventHandler(t,e,n,!0)}watch(t,e,n){this._addEventHandler(t,e,n,!1,!0)}off(t,e){this._removeEventHandler(t,e)}_toggleRecognizer(t,e){const{manager:n}=this;if(!n)return;const r=n.get(t);if(r&&r.options.enable!==e){r.set({enable:e});const i=kt[t];i&&!this.options.recognizers&&i.forEach(i=>{const o=n.get(i);e?(o.requireFailure(t),r.dropRequireFailure(i)):o.dropRequireFailure(t)})}this.wheelInput.enableEventType(t,e),this.moveInput.enableEventType(t,e),this.keyInput.enableEventType(t,e),this.contextmenuInput.enableEventType(t,e)}_addEventHandler(t,e,n,r,i){if("string"!=typeof t){n=e;for(const e in t)this._addEventHandler(e,t[e],n,r,i);return}const{manager:o,events:a}=this,s=Ft[t]||t;let u=a.get(s);u||(u=new Yt(this),a.set(s,u),u.recognizerName=jt[s]||s,o&&o.on(s,u.handleEvent)),u.add(t,e,n,r,i),u.isEmpty()||this._toggleRecognizer(u.recognizerName,!0)}_removeEventHandler(t,e){if("string"!=typeof t){for(const e in t)this._removeEventHandler(e,t[e]);return}const{events:n}=this,r=Ft[t]||t,i=n.get(r);if(i&&(i.remove(t,e),i.isEmpty())){const{recognizerName:t}=i;let e=!1;for(const r of n.values())if(r.recognizerName===t&&!r.isEmpty()){e=!0;break}e||this._toggleRecognizer(t,!1)}}}var ee=n(29);function ne(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return re(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return re(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function re(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function ie(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function oe(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?ie(Object(n),!0).forEach((function(e){u()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):ie(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function ae(){}n.d(e,"a",(function(){return ue}));var se={id:"",width:"100%",height:"100%",style:null,viewState:null,initialViewState:null,pickingRadius:0,layerFilter:null,glOptions:{},parameters:{},parent:null,gl:null,canvas:null,layers:[],effects:[],views:null,controller:null,useDevicePixels:!0,touchAction:"none",eventRecognizerOptions:{},_framebuffer:null,_animate:!1,_pickable:!0,_typedArrayManagerProps:{},_customRender:null,onWebGLInitialized:ae,onResize:ae,onViewStateChange:ae,onInteractionStateChange:ae,onBeforeRender:ae,onAfterRender:ae,onLoad:ae,onError:function(t){return h.a.error(t.message)()},onHover:null,onClick:null,onDragStart:null,onDrag:null,onDragEnd:null,_onMetrics:null,getCursor:function(t){return t.isDragging?"grabbing":"grab"},getTooltip:null,debug:!1,drawPickingColors:!1},ue=function(){function t(e){var n=this;i()(this,t),u()(this,"width",0),u()(this,"height",0),u()(this,"userData",{}),u()(this,"canvas",null),u()(this,"viewManager",null),u()(this,"layerManager",null),u()(this,"effectManager",null),u()(this,"deckRenderer",null),u()(this,"deckPicker",null),u()(this,"eventManager",null),u()(this,"tooltip",null),u()(this,"_lastPointerDownInfo",null),u()(this,"_onPointerMove",(function(t){var e=n._pickRequest;if("pointerleave"===t.type)e.x=-1,e.y=-1,e.radius=0;else{if(t.leftButton||t.rightButton)return;var r=t.offsetCenter;if(!r)return;e.x=r.x,e.y=r.y,e.radius=n.props.pickingRadius}n.layerManager&&(n.layerManager.context.mousePosition={x:e.x,y:e.y}),e.event=t})),u()(this,"_onEvent",(function(t){var e=M.b[t.type],r=t.offsetCenter;if(e&&r&&n.layerManager){var i=n.layerManager.getLayers(),o=n.deckPicker.getLastPickedObject({x:r.x,y:r.y,layers:i,viewports:n.getViewports(r)},n._lastPointerDownInfo),a=o.layer,s=a&&(a[e.handler]||a.props[e.handler]),u=n.props[e.handler],c=!1;s&&(c=s.call(a,o,t)),!c&&u&&u(o,t)}})),u()(this,"_onPointerDown",(function(t){var e=t.offsetCenter,r=n._pick("pickObject","pickObject Time",{x:e.x,y:e.y,radius:n.props.pickingRadius});n._lastPointerDownInfo=r.result[0]||r.emptyInfo})),this.props=oe(oe({},se),e),e=this.props,this._needsRedraw="Initial render",this._pickRequest={mode:"hover",x:-1,y:-1,radius:0,event:null},this.cursorState={isHovering:!1,isDragging:!1},e.viewState&&e.initialViewState&&h.a.warn("View state tracking is disabled. Use either `initialViewState` for auto update or `viewState` for manual update.")(),"IE"===Object(pt.a)()&&h.a.warn("IE 11 is not supported")(),this.viewState=e.initialViewState,e.gl||"undefined"!=typeof document&&(this.canvas=this._createCanvas(e)),this.animationLoop=this._createAnimationLoop(e),this.stats=new Ot.a({id:"deck.gl"}),this.metrics={fps:0,setPropsTime:0,updateAttributesTime:0,framesRedrawn:0,pickTime:0,pickCount:0,gpuTime:0,gpuTimePerFrame:0,cpuTime:0,cpuTimePerFrame:0,bufferMemory:0,textureMemory:0,renderbufferMemory:0,gpuMemory:0},this._metricsCounter=0,this.setProps(e),e._typedArrayManagerProps&&ht.a.setOptions(e._typedArrayManagerProps),this.animationLoop.start()}return a()(t,[{key:"finalize",value:function(){var t,e,n,r,i,o,a,s;(this.animationLoop.stop(),this.animationLoop=null,this._lastPointerDownInfo=null,null===(t=this.layerManager)||void 0===t||t.finalize(),this.layerManager=null,null===(e=this.viewManager)||void 0===e||e.finalize(),this.viewManager=null,null===(n=this.effectManager)||void 0===n||n.finalize(),this.effectManager=null,null===(r=this.deckRenderer)||void 0===r||r.finalize(),this.deckRenderer=null,null===(i=this.deckPicker)||void 0===i||i.finalize(),this.deckPicker=null,null===(o=this.eventManager)||void 0===o||o.destroy(),this.eventManager=null,null===(a=this.tooltip)||void 0===a||a.remove(),this.tooltip=null,this.props.canvas||this.props.gl||!this.canvas)||(null===(s=this.canvas.parentElement)||void 0===s||s.removeChild(this.canvas),this.canvas=null)}},{key:"setProps",value:function(t){this.stats.get("setProps Time").timeStart(),"onLayerHover"in t&&h.a.removed("onLayerHover","onHover")(),"onLayerClick"in t&&h.a.removed("onLayerClick","onClick")(),t.initialViewState&&!Object(l.a)(this.props.initialViewState,t.initialViewState)&&(this.viewState=t.initialViewState),Object.assign(this.props,t),this._setCanvasSize(this.props);var e=Object.create(this.props);Object.assign(e,{views:this._getViews(),width:this.width,height:this.height,viewState:this._getViewState()}),this.animationLoop.setProps(e),this.layerManager&&(this.viewManager.setProps(e),this.layerManager.activateViewport(this.getViewports()[0]),this.layerManager.setProps(e),this.effectManager.setProps(e),this.deckRenderer.setProps(e),this.deckPicker.setProps(e)),this.stats.get("setProps Time").timeEnd()}},{key:"needsRedraw",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{clearRedrawFlags:!1};if(!this.layerManager)return!1;if(this.props._animate)return"Deck._animate";var e=this._needsRedraw;t.clearRedrawFlags&&(this._needsRedraw=!1);var n=this.viewManager.needsRedraw(t),r=this.layerManager.needsRedraw(t),i=this.effectManager.needsRedraw(t),o=this.deckRenderer.needsRedraw(t);return e=e||n||r||i||o}},{key:"redraw",value:function(t){if(this.layerManager){var e=this.needsRedraw({clearRedrawFlags:!0});(e=t||e)&&(this.stats.get("Redraw Count").incrementCount(),this.props._customRender?this.props._customRender(e):this._drawLayers(e))}}},{key:"isInitialized",get:function(){return null!==this.viewManager}},{key:"getViews",value:function(){return Object(ee.a)(this.viewManager),this.viewManager.views}},{key:"getViewports",value:function(t){return Object(ee.a)(this.viewManager),this.viewManager.getViewports(t)}},{key:"pickObject",value:function(t){var e=this._pick("pickObject","pickObject Time",t).result;return e.length?e[0]:null}},{key:"pickMultipleObjects",value:function(t){return t.depth=t.depth||10,this._pick("pickObject","pickMultipleObjects Time",t).result}},{key:"pickObjects",value:function(t){return this._pick("pickObjects","pickObjects Time",t)}},{key:"_addResources",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]&&arguments[1];for(var n in t)this.layerManager.resourceManager.add({resourceId:n,data:t[n],forceUpdate:e})}},{key:"_removeResources",value:function(t){var e,n=ne(t);try{for(n.s();!(e=n.n()).done;){var r=e.value;this.layerManager.resourceManager.remove(r)}}catch(t){n.e(t)}finally{n.f()}}},{key:"_pick",value:function(t,e,n){Object(ee.a)(this.deckPicker);var r=this.stats;r.get("Pick Count").incrementCount(),r.get(e).timeStart();var i=this.deckPicker[t](oe({layers:this.layerManager.getLayers(n),views:this.viewManager.getViews(),viewports:this.getViewports(n),onViewportActive:this.layerManager.activateViewport,effects:this.effectManager.getEffects()},n));return r.get(e).timeEnd(),i}},{key:"_createCanvas",value:function(t){var e=t.canvas;("string"==typeof e&&(e=document.getElementById(e),Object(ee.a)(e)),e)||((e=document.createElement("canvas")).id=t.id||"deckgl-overlay",(t.parent||document.body).appendChild(e));return Object.assign(e.style,t.style),e}},{key:"_setCanvasSize",value:function(t){if(this.canvas){var e=t.width,n=t.height;if(e||0===e){var r=Number.isFinite(e)?"".concat(e,"px"):e;this.canvas.style.width=r}if(n||0===n){var i,o=Number.isFinite(n)?"".concat(n,"px"):n;this.canvas.style.position=(null===(i=t.style)||void 0===i?void 0:i.position)||"absolute",this.canvas.style.height=o}}}},{key:"_updateCanvasSize",value:function(){var t=this.canvas;if(t){var e,n=t.clientWidth||t.width,r=t.clientHeight||t.height;if(n!==this.width||r!==this.height)this.width=n,this.height=r,null===(e=this.viewManager)||void 0===e||e.setProps({width:n,height:r}),this.props.onResize({width:n,height:r})}}},{key:"_createAnimationLoop",value:function(t){var e=this,n=t.width,r=t.height,i=t.gl,o=t.glOptions,a=t.debug,s=t.onError,u=t.onBeforeRender,c=t.onAfterRender,l=t.useDevicePixels;return new wt({width:n,height:r,useDevicePixels:l,autoResizeViewport:!1,gl:i,onCreateContext:function(t){return Object(P.c)(oe(oe(oe({},o),t),{},{canvas:e.canvas,debug:a,onContextLost:function(){return e._onContextLost()}}))},onInitialize:function(t){return e._setGLContext(t.gl)},onRender:this._onRenderFrame.bind(this),onBeforeRender:u,onAfterRender:c,onError:s})}},{key:"_getViewState",value:function(){return this.props.viewState||this.viewState}},{key:"_getViews",value:function(){var t=this.props.views||[new g.a({id:"default-view"})];return(t=Array.isArray(t)?t:[t]).length&&this.props.controller&&(t[0].props.controller=this.props.controller),t}},{key:"_onContextLost",value:function(){var t=this.props.onError;this.animationLoop&&t&&t(new Error("WebGL context is lost"))}},{key:"_pickAndCallback",value:function(){var t=this._pickRequest;if(t.event){var e=this._pick("pickObject","pickObject Time",t),n=e.result,r=e.emptyInfo;this.cursorState.isHovering=n.length>0;var i,o=r,a=!1,s=ne(n);try{for(s.s();!(i=s.n()).done;){var u,c=i.value;o=c,a=(null===(u=c.layer)||void 0===u?void 0:u.onHover(c,t.event))||a}}catch(t){s.e(t)}finally{s.f()}if(!a&&this.props.onHover&&this.props.onHover(o,t.event),this.props.getTooltip&&this.tooltip){var l=this.props.getTooltip(o);this.tooltip.setTooltip(l,o.x,o.y)}t.event=null}}},{key:"_updateCursor",value:function(){var t=this.props.parent||this.canvas;t&&(t.style.cursor=this.props.getCursor(this.cursorState))}},{key:"_setGLContext",value:function(t){if(!this.layerManager){this.canvas||(this.canvas=t.canvas,Object(P.h)(t,{enable:!0,copyState:!0})),this.tooltip=new lt(this.canvas),Object(P.n)(t,{blend:!0,blendFunc:[770,771,1,771],polygonOffsetFill:!0,depthTest:!0,depthFunc:515}),this.props.onWebGLInitialized(t);var e=new Et.a;for(var n in e.play(),this.animationLoop.attachTimeline(e),this.eventManager=new te(this.props.parent||t.canvas,{touchAction:this.props.touchAction,recognizerOptions:this.props.eventRecognizerOptions,events:{pointerdown:this._onPointerDown,pointermove:this._onPointerMove,pointerleave:this._onPointerMove}}),M.b)this.eventManager.on(n,this._onEvent);this.viewManager=new A({timeline:e,eventManager:this.eventManager,onViewStateChange:this._onViewStateChange.bind(this),onInteractionStateChange:this._onInteractionStateChange.bind(this),views:this._getViews(),viewState:this._getViewState(),width:this.width,height:this.height});var r=this.viewManager.getViewports()[0];this.layerManager=new c.a(t,{deck:this,stats:this.stats,viewport:r,timeline:e}),this.effectManager=new q,this.deckRenderer=new X.a(t),this.deckPicker=new ut(t),this.setProps(this.props),this._updateCanvasSize(),this.props.onLoad()}}},{key:"_drawLayers",value:function(t,e){var n=this.layerManager.context.gl;Object(P.n)(n,this.props.parameters),this.props.onBeforeRender({gl:n}),this.deckRenderer.renderLayers(oe({target:this.props._framebuffer,layers:this.layerManager.getLayers(),viewports:this.viewManager.getViewports(),onViewportActive:this.layerManager.activateViewport,views:this.viewManager.getViews(),pass:"screen",redrawReason:t,effects:this.effectManager.getEffects()},e)),this.props.onAfterRender({gl:n})}},{key:"_onRenderFrame",value:function(t){this._getFrameStats(),this._metricsCounter++%60==0&&(this._getMetrics(),this.stats.reset(),h.a.table(4,this.metrics)(),this.props._onMetrics&&this.props._onMetrics(this.metrics)),this._updateCanvasSize(),this._updateCursor(),this.tooltip.isVisible&&this.viewManager.needsRedraw()&&this.tooltip.setTooltip(null),this.layerManager.updateLayers(),this._pickAndCallback(),this.redraw(),this.viewManager&&this.viewManager.updateViewStates()}},{key:"_onViewStateChange",value:function(t){var e=this.props.onViewStateChange(t)||t.viewState;this.viewState&&(this.viewState=oe(oe({},this.viewState),{},u()({},t.viewId,e)),this.props.viewState||this.viewManager&&this.viewManager.setProps({viewState:this.viewState}))}},{key:"_onInteractionStateChange",value:function(t){this.cursorState.isDragging=t.isDragging||!1,this.props.onInteractionStateChange(t)}},{key:"_getFrameStats",value:function(){var t=this.stats;t.get("frameRate").timeEnd(),t.get("frameRate").timeStart();var e=this.animationLoop.stats;t.get("GPU Time").addTime(e.get("GPU Time").lastTiming),t.get("CPU Time").addTime(e.get("CPU Time").lastTiming)}},{key:"_getMetrics",value:function(){var t=this.metrics,e=this.stats;t.fps=e.get("frameRate").getHz(),t.setPropsTime=e.get("setProps Time").time,t.updateAttributesTime=e.get("Update Attributes").time,t.framesRedrawn=e.get("Redraw Count").count,t.pickTime=e.get("pickObject Time").time+e.get("pickMultipleObjects Time").time+e.get("pickObjects Time").time,t.pickCount=e.get("Pick Count").count,t.gpuTime=e.get("GPU Time").time,t.cpuTime=e.get("CPU Time").time,t.gpuTimePerFrame=e.get("GPU Time").getAverageTime(),t.cpuTimePerFrame=e.get("CPU Time").getAverageTime();var n=dt.b.get("Memory Usage");t.bufferMemory=n.get("Buffer Memory").count,t.textureMemory=n.get("Texture Memory").count,t.renderbufferMemory=n.get("Renderbuffer Memory").count,t.gpuMemory=n.get("GPU Memory").count}}]),t}();u()(ue,"defaultProps",se),u()(ue,"VERSION",ft.a.VERSION)},function(t,e,n){"use strict";var r=n(0),i=n.n(r),o=n(112),a=n(320),s=n(21),u=n(32);var c={id:"JSON",name:"JSON",module:"",version:"",options:{},extensions:["json","geojson"],mimeTypes:["application/json","application/geo+json"],testText:function(t){var e=t[0],n=t[t.length-1];return"{"===e&&"}"===n||"["===e&&"]"===n},parseTextSync:JSON.parse};function l(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function h(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?l(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):l(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var f=globalThis.deck&&globalThis.deck.VERSION;if(f&&"8.9.7"!==f)throw new Error("deck.gl - multiple versions detected: ".concat(f," vs ").concat("8.9.7"));f||(s.a.log(1,"deck.gl ".concat("8.9.7"))(),globalThis.deck=h(h({},globalThis.deck),{},{VERSION:"8.9.7",version:"8.9.7",log:s.a,_registerLoggers:u.b}),Object(o.c)([c,[a.a,{imagebitmap:{premultiplyAlpha:"none"}}]]));e.a=globalThis.deck},function(t,e){},function(t,e,n){"use strict";t.exports=i;var r=n(226);function i(t){this.buf=ArrayBuffer.isView&&ArrayBuffer.isView(t)?t:new Uint8Array(t||0),this.pos=0,this.type=0,this.length=this.buf.length}i.Varint=0,i.Fixed64=1,i.Bytes=2,i.Fixed32=5;var o="undefined"==typeof TextDecoder?null:new TextDecoder("utf8");function a(t){return t.type===i.Bytes?t.readVarint()+t.pos:t.pos+1}function s(t,e,n){return n?4294967296*e+(t>>>0):4294967296*(e>>>0)+(t>>>0)}function u(t,e,n){var r=e<=16383?1:e<=2097151?2:e<=268435455?3:Math.floor(Math.log(e)/(7*Math.LN2));n.realloc(r);for(var i=n.pos-1;i>=t;i--)n.buf[i+r]=n.buf[i]}function c(t,e){for(var n=0;n<t.length;n++)e.writeVarint(t[n])}function l(t,e){for(var n=0;n<t.length;n++)e.writeSVarint(t[n])}function h(t,e){for(var n=0;n<t.length;n++)e.writeFloat(t[n])}function f(t,e){for(var n=0;n<t.length;n++)e.writeDouble(t[n])}function p(t,e){for(var n=0;n<t.length;n++)e.writeBoolean(t[n])}function d(t,e){for(var n=0;n<t.length;n++)e.writeFixed32(t[n])}function A(t,e){for(var n=0;n<t.length;n++)e.writeSFixed32(t[n])}function g(t,e){for(var n=0;n<t.length;n++)e.writeFixed64(t[n])}function m(t,e){for(var n=0;n<t.length;n++)e.writeSFixed64(t[n])}function y(t,e){return(t[e]|t[e+1]<<8|t[e+2]<<16)+16777216*t[e+3]}function v(t,e,n){t[n]=e,t[n+1]=e>>>8,t[n+2]=e>>>16,t[n+3]=e>>>24}function _(t,e){return(t[e]|t[e+1]<<8|t[e+2]<<16)+(t[e+3]<<24)}i.prototype={destroy:function(){this.buf=null},readFields:function(t,e,n){for(n=n||this.length;this.pos<n;){var r=this.readVarint(),i=r>>3,o=this.pos;this.type=7&r,t(i,e,this),this.pos===o&&this.skip(r)}return e},readMessage:function(t,e){return this.readFields(t,e,this.readVarint()+this.pos)},readFixed32:function(){var t=y(this.buf,this.pos);return this.pos+=4,t},readSFixed32:function(){var t=_(this.buf,this.pos);return this.pos+=4,t},readFixed64:function(){var t=y(this.buf,this.pos)+4294967296*y(this.buf,this.pos+4);return this.pos+=8,t},readSFixed64:function(){var t=y(this.buf,this.pos)+4294967296*_(this.buf,this.pos+4);return this.pos+=8,t},readFloat:function(){var t=r.read(this.buf,this.pos,!0,23,4);return this.pos+=4,t},readDouble:function(){var t=r.read(this.buf,this.pos,!0,52,8);return this.pos+=8,t},readVarint:function(t){var e,n,r=this.buf;return e=127&(n=r[this.pos++]),n<128?e:(e|=(127&(n=r[this.pos++]))<<7,n<128?e:(e|=(127&(n=r[this.pos++]))<<14,n<128?e:(e|=(127&(n=r[this.pos++]))<<21,n<128?e:function(t,e,n){var r,i,o=n.buf;if(i=o[n.pos++],r=(112&i)>>4,i<128)return s(t,r,e);if(i=o[n.pos++],r|=(127&i)<<3,i<128)return s(t,r,e);if(i=o[n.pos++],r|=(127&i)<<10,i<128)return s(t,r,e);if(i=o[n.pos++],r|=(127&i)<<17,i<128)return s(t,r,e);if(i=o[n.pos++],r|=(127&i)<<24,i<128)return s(t,r,e);if(i=o[n.pos++],r|=(1&i)<<31,i<128)return s(t,r,e);throw new Error("Expected varint not more than 10 bytes")}(e|=(15&(n=r[this.pos]))<<28,t,this))))},readVarint64:function(){return this.readVarint(!0)},readSVarint:function(){var t=this.readVarint();return t%2==1?(t+1)/-2:t/2},readBoolean:function(){return Boolean(this.readVarint())},readString:function(){var t=this.readVarint()+this.pos,e=this.pos;return this.pos=t,t-e>=12&&o?function(t,e,n){return o.decode(t.subarray(e,n))}(this.buf,e,t):function(t,e,n){var r="",i=e;for(;i<n;){var o,a,s,u=t[i],c=null,l=u>239?4:u>223?3:u>191?2:1;if(i+l>n)break;1===l?u<128&&(c=u):2===l?128==(192&(o=t[i+1]))&&(c=(31&u)<<6|63&o)<=127&&(c=null):3===l?(o=t[i+1],a=t[i+2],128==(192&o)&&128==(192&a)&&((c=(15&u)<<12|(63&o)<<6|63&a)<=2047||c>=55296&&c<=57343)&&(c=null)):4===l&&(o=t[i+1],a=t[i+2],s=t[i+3],128==(192&o)&&128==(192&a)&&128==(192&s)&&((c=(15&u)<<18|(63&o)<<12|(63&a)<<6|63&s)<=65535||c>=1114112)&&(c=null)),null===c?(c=65533,l=1):c>65535&&(c-=65536,r+=String.fromCharCode(c>>>10&1023|55296),c=56320|1023&c),r+=String.fromCharCode(c),i+=l}return r}(this.buf,e,t)},readBytes:function(){var t=this.readVarint()+this.pos,e=this.buf.subarray(this.pos,t);return this.pos=t,e},readPackedVarint:function(t,e){if(this.type!==i.Bytes)return t.push(this.readVarint(e));var n=a(this);for(t=t||[];this.pos<n;)t.push(this.readVarint(e));return t},readPackedSVarint:function(t){if(this.type!==i.Bytes)return t.push(this.readSVarint());var e=a(this);for(t=t||[];this.pos<e;)t.push(this.readSVarint());return t},readPackedBoolean:function(t){if(this.type!==i.Bytes)return t.push(this.readBoolean());var e=a(this);for(t=t||[];this.pos<e;)t.push(this.readBoolean());return t},readPackedFloat:function(t){if(this.type!==i.Bytes)return t.push(this.readFloat());var e=a(this);for(t=t||[];this.pos<e;)t.push(this.readFloat());return t},readPackedDouble:function(t){if(this.type!==i.Bytes)return t.push(this.readDouble());var e=a(this);for(t=t||[];this.pos<e;)t.push(this.readDouble());return t},readPackedFixed32:function(t){if(this.type!==i.Bytes)return t.push(this.readFixed32());var e=a(this);for(t=t||[];this.pos<e;)t.push(this.readFixed32());return t},readPackedSFixed32:function(t){if(this.type!==i.Bytes)return t.push(this.readSFixed32());var e=a(this);for(t=t||[];this.pos<e;)t.push(this.readSFixed32());return t},readPackedFixed64:function(t){if(this.type!==i.Bytes)return t.push(this.readFixed64());var e=a(this);for(t=t||[];this.pos<e;)t.push(this.readFixed64());return t},readPackedSFixed64:function(t){if(this.type!==i.Bytes)return t.push(this.readSFixed64());var e=a(this);for(t=t||[];this.pos<e;)t.push(this.readSFixed64());return t},skip:function(t){var e=7&t;if(e===i.Varint)for(;this.buf[this.pos++]>127;);else if(e===i.Bytes)this.pos=this.readVarint()+this.pos;else if(e===i.Fixed32)this.pos+=4;else{if(e!==i.Fixed64)throw new Error("Unimplemented type: "+e);this.pos+=8}},writeTag:function(t,e){this.writeVarint(t<<3|e)},realloc:function(t){for(var e=this.length||16;e<this.pos+t;)e*=2;if(e!==this.length){var n=new Uint8Array(e);n.set(this.buf),this.buf=n,this.length=e}},finish:function(){return this.length=this.pos,this.pos=0,this.buf.subarray(0,this.length)},writeFixed32:function(t){this.realloc(4),v(this.buf,t,this.pos),this.pos+=4},writeSFixed32:function(t){this.realloc(4),v(this.buf,t,this.pos),this.pos+=4},writeFixed64:function(t){this.realloc(8),v(this.buf,-1&t,this.pos),v(this.buf,Math.floor(t*(1/4294967296)),this.pos+4),this.pos+=8},writeSFixed64:function(t){this.realloc(8),v(this.buf,-1&t,this.pos),v(this.buf,Math.floor(t*(1/4294967296)),this.pos+4),this.pos+=8},writeVarint:function(t){(t=+t||0)>268435455||t<0?function(t,e){var n,r;t>=0?(n=t%4294967296|0,r=t/4294967296|0):(r=~(-t/4294967296),4294967295^(n=~(-t%4294967296))?n=n+1|0:(n=0,r=r+1|0));if(t>=0x10000000000000000||t<-0x10000000000000000)throw new Error("Given varint doesn't fit into 10 bytes");e.realloc(10),function(t,e,n){n.buf[n.pos++]=127&t|128,t>>>=7,n.buf[n.pos++]=127&t|128,t>>>=7,n.buf[n.pos++]=127&t|128,t>>>=7,n.buf[n.pos++]=127&t|128,t>>>=7,n.buf[n.pos]=127&t}(n,0,e),function(t,e){var n=(7&t)<<4;if(e.buf[e.pos++]|=n|((t>>>=3)?128:0),!t)return;if(e.buf[e.pos++]=127&t|((t>>>=7)?128:0),!t)return;if(e.buf[e.pos++]=127&t|((t>>>=7)?128:0),!t)return;if(e.buf[e.pos++]=127&t|((t>>>=7)?128:0),!t)return;if(e.buf[e.pos++]=127&t|((t>>>=7)?128:0),!t)return;e.buf[e.pos++]=127&t}(r,e)}(t,this):(this.realloc(4),this.buf[this.pos++]=127&t|(t>127?128:0),t<=127||(this.buf[this.pos++]=127&(t>>>=7)|(t>127?128:0),t<=127||(this.buf[this.pos++]=127&(t>>>=7)|(t>127?128:0),t<=127||(this.buf[this.pos++]=t>>>7&127))))},writeSVarint:function(t){this.writeVarint(t<0?2*-t-1:2*t)},writeBoolean:function(t){this.writeVarint(Boolean(t))},writeString:function(t){t=String(t),this.realloc(4*t.length),this.pos++;var e=this.pos;this.pos=function(t,e,n){for(var r,i,o=0;o<e.length;o++){if((r=e.charCodeAt(o))>55295&&r<57344){if(!i){r>56319||o+1===e.length?(t[n++]=239,t[n++]=191,t[n++]=189):i=r;continue}if(r<56320){t[n++]=239,t[n++]=191,t[n++]=189,i=r;continue}r=i-55296<<10|r-56320|65536,i=null}else i&&(t[n++]=239,t[n++]=191,t[n++]=189,i=null);r<128?t[n++]=r:(r<2048?t[n++]=r>>6|192:(r<65536?t[n++]=r>>12|224:(t[n++]=r>>18|240,t[n++]=r>>12&63|128),t[n++]=r>>6&63|128),t[n++]=63&r|128)}return n}(this.buf,t,this.pos);var n=this.pos-e;n>=128&&u(e,n,this),this.pos=e-1,this.writeVarint(n),this.pos+=n},writeFloat:function(t){this.realloc(4),r.write(this.buf,t,this.pos,!0,23,4),this.pos+=4},writeDouble:function(t){this.realloc(8),r.write(this.buf,t,this.pos,!0,52,8),this.pos+=8},writeBytes:function(t){var e=t.length;this.writeVarint(e),this.realloc(e);for(var n=0;n<e;n++)this.buf[this.pos++]=t[n]},writeRawMessage:function(t,e){this.pos++;var n=this.pos;t(e,this);var r=this.pos-n;r>=128&&u(n,r,this),this.pos=n-1,this.writeVarint(r),this.pos+=r},writeMessage:function(t,e,n){this.writeTag(t,i.Bytes),this.writeRawMessage(e,n)},writePackedVarint:function(t,e){e.length&&this.writeMessage(t,c,e)},writePackedSVarint:function(t,e){e.length&&this.writeMessage(t,l,e)},writePackedBoolean:function(t,e){e.length&&this.writeMessage(t,p,e)},writePackedFloat:function(t,e){e.length&&this.writeMessage(t,h,e)},writePackedDouble:function(t,e){e.length&&this.writeMessage(t,f,e)},writePackedFixed32:function(t,e){e.length&&this.writeMessage(t,d,e)},writePackedSFixed32:function(t,e){e.length&&this.writeMessage(t,A,e)},writePackedFixed64:function(t,e){e.length&&this.writeMessage(t,g,e)},writePackedSFixed64:function(t,e){e.length&&this.writeMessage(t,m,e)},writeBytesField:function(t,e){this.writeTag(t,i.Bytes),this.writeBytes(e)},writeFixed32Field:function(t,e){this.writeTag(t,i.Fixed32),this.writeFixed32(e)},writeSFixed32Field:function(t,e){this.writeTag(t,i.Fixed32),this.writeSFixed32(e)},writeFixed64Field:function(t,e){this.writeTag(t,i.Fixed64),this.writeFixed64(e)},writeSFixed64Field:function(t,e){this.writeTag(t,i.Fixed64),this.writeSFixed64(e)},writeVarintField:function(t,e){this.writeTag(t,i.Varint),this.writeVarint(e)},writeSVarintField:function(t,e){this.writeTag(t,i.Varint),this.writeSVarint(e)},writeStringField:function(t,e){this.writeTag(t,i.Bytes),this.writeString(e)},writeFloatField:function(t,e){this.writeTag(t,i.Fixed32),this.writeFloat(e)},writeDoubleField:function(t,e){this.writeTag(t,i.Fixed64),this.writeDouble(e)},writeBooleanField:function(t,e){this.writeVarintField(t,Boolean(e))}}},function(t,e,n){const r=n(285),i={"||":function(t,e){return t||e},"&&":function(t,e){return t&&e},"|":function(t,e){return t|e},"^":function(t,e){return t^e},"&":function(t,e){return t&e},"==":function(t,e){return t==e},"!=":function(t,e){return t!=e},"===":function(t,e){return t===e},"!==":function(t,e){return t!==e},"<":function(t,e){return t<e},">":function(t,e){return t>e},"<=":function(t,e){return t<=e},">=":function(t,e){return t>=e},"<<":function(t,e){return t<<e},">>":function(t,e){return t>>e},">>>":function(t,e){return t>>>e},"+":function(t,e){return t+e},"-":function(t,e){return t-e},"*":function(t,e){return t*e},"/":function(t,e){return t/e},"%":function(t,e){return t%e}},o={"-":function(t){return-t},"+":function(t){return+t},"~":function(t){return~t},"!":function(t){return!t}};function a(t,e){return t.map((function(t){return l(t,e)}))}async function s(t,e){return await Promise.all(t.map(t=>h(t,e)))}function u(t,e){const n=l(t.object,e);return t.computed?[n,n[l(t.property,e)]]:[n,n[t.property.name]]}async function c(t,e){const n=await h(t.object,e);return t.computed?[n,n[await h(t.property,e)]]:[n,n[t.property.name]]}function l(t,e){switch(t.type){case"ArrayExpression":return a(t.elements,e);case"BinaryExpression":return i[t.operator](l(t.left,e),l(t.right,e));case"CallExpression":let n,r,s;if("MemberExpression"===t.callee.type?(s=u(t.callee,e),n=s[0],r=s[1]):r=l(t.callee,e),"function"!=typeof r)return;return r.apply(n,a(t.arguments,e));case"ConditionalExpression":return l(t.test,e)?l(t.consequent,e):l(t.alternate,e);case"Identifier":return e[t.name];case"Literal":return t.value;case"LogicalExpression":return"||"===t.operator?l(t.left,e)||l(t.right,e):"&&"===t.operator?l(t.left,e)&&l(t.right,e):i[t.operator](l(t.left,e),l(t.right,e));case"MemberExpression":return u(t,e)[1];case"ThisExpression":return e;case"UnaryExpression":return o[t.operator](l(t.argument,e));default:return}}async function h(t,e){switch(t.type){case"ArrayExpression":return await s(t.elements,e);case"BinaryExpression":{const[n,r]=await Promise.all([h(t.left,e),h(t.right,e)]);return i[t.operator](n,r)}case"CallExpression":let n,r,a;if("MemberExpression"===t.callee.type?(a=await c(t.callee,e),n=a[0],r=a[1]):r=await h(t.callee,e),"function"!=typeof r)return;return await r.apply(n,await s(t.arguments,e));case"ConditionalExpression":return await h(t.test,e)?await h(t.consequent,e):await h(t.alternate,e);case"Identifier":return e[t.name];case"Literal":return t.value;case"LogicalExpression":{if("||"===t.operator)return await h(t.left,e)||await h(t.right,e);if("&&"===t.operator)return await h(t.left,e)&&await h(t.right,e);const[n,r]=await Promise.all([h(t.left,e),h(t.right,e)]);return i[t.operator](n,r)}case"MemberExpression":return(await c(t,e))[1];case"ThisExpression":return e;case"UnaryExpression":return o[t.operator](await h(t.argument,e));default:return}}t.exports={parse:r,eval:l,evalAsync:h,compile:function(t){return l.bind(null,r(t))},compileAsync:function(t){return h.bind(null,r(t))}}},function(t,e,n){"use strict";var r=n(77),i=n(205),o=n(187);function a(t){return s(function t(e,n){return e.map(e=>(e instanceof i.a||(Object(o.a)("string"!=typeof e,"Shader module use by name is deprecated. Import shader module '".concat(e,"' and use it directly.")),Object(o.a)(e.name,"shader module has no name"),(e=new i.a(e)).dependencies=t(e.dependencies)),e))}(t))}function s(t){const e={},n={};return u({modules:t,level:0,moduleMap:e,moduleDepth:n}),Object.keys(n).sort((t,e)=>n[e]-n[t]).map(t=>e[t])}function u(t){let{modules:e,level:n,moduleMap:r,moduleDepth:i}=t;if(n>=5)throw new Error("Possible loop in shader dependency graph");for(const t of e)r[t.name]=t,(void 0===i[t.name]||i[t.name]<n)&&(i[t.name]=n);for(const t of e)t.dependencies&&u({modules:t.dependencies,level:n+1,moduleMap:r,moduleDepth:i})}function c(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const e="undefined"!=typeof window&&window.navigator||{},n=t.userAgent||e.userAgent||"",r=-1!==n.indexOf("MSIE "),i=-1!==n.indexOf("Trident/");return r||i}const l={GLSL_FRAG_DATA:["WEBGL_draw_buffers",!0],GLSL_FRAG_DEPTH:["EXT_frag_depth",!0],GLSL_DERIVATIVES:["OES_standard_derivatives",!0],GLSL_TEXTURE_LOD:["EXT_shader_texture_lod",!0]},h={};Object.keys(l).forEach(t=>{h[t]=t});const f={};function p(t,e){let n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{};const r=l[e];if(Object(o.a)(r,e),!c(n))return!0;if(e in f)return f[e];const i=r[0],a=n.behavior||"enable",s="#extension GL_".concat(i," : ").concat(a,"\nvoid main(void) {}"),u=t.createShader(35633);t.shaderSource(u,s),t.compileShader(u);const h=t.getShaderParameter(u,35713);return t.deleteShader(u),f[e]=h,h}function d(t,e){const n=l[e];Object(o.a)(n,e);const r=function(t){return"undefined"!=typeof WebGL2RenderingContext&&t instanceof WebGL2RenderingContext||Boolean(t&&2===t._version)}(t)&&n[1]||n[0],i="string"==typeof r?Boolean(t.getExtension(r)):r;return Object(o.a)(!1===i||!0===i),i}function A(t,e){return(e=Array.isArray(e)?e:[e]).every(e=>d(t,e))}var g=n(191);function m(t){return new RegExp("\\b".concat(t,"[ \\t]+(\\w+[ \\t]+\\w+(\\[\\w+\\])?;)"),"g")}const y=[[/^(#version[ \t]+(100|300[ \t]+es))?[ \t]*\n/,"#version 300 es\n"],[/\btexture(2D|2DProj|Cube)Lod(EXT)?\(/g,"textureLod("],[/\btexture(2D|2DProj|Cube)(EXT)?\(/g,"texture("]],v=[...y,[m("attribute"),"in $1"],[m("varying"),"out $1"]],_=[...y,[m("varying"),"in $1"]],b=[[/^#version[ \t]+300[ \t]+es/,"#version 100"],[/\btexture(2D|2DProj|Cube)Lod\(/g,"texture$1LodEXT("],[/\btexture\(/g,"texture2D("],[/\btextureLod\(/g,"texture2DLodEXT("]],x=[...b,[m("in"),"attribute $1"],[m("out"),"varying $1"]],w=[...b,[m("in"),"varying $1"]],E=/\bout[ \t]+vec4[ \t]+(\w+)[ \t]*;\n?/,O=/void\s+main\s*\([^)]*\)\s*\{\n?/;function S(t,e,n){switch(e){case 300:return n?T(t,v):function(t){const e=(t=T(t,_)).match(E);if(e){const n=e[1];t=t.replace(new RegExp("\\b".concat("gl_FragColor","\\b"),"g"),n)}else{const e="fragmentColor";t=t.replace(O,t=>"out vec4 ".concat(e,";\n").concat(t)).replace(new RegExp("\\b".concat("gl_FragColor","\\b"),"g"),e)}return t}(t);case 100:return n?T(t,x):function(t){const e=(t=T(t,w)).match(E);if(e){const n=e[1];t=t.replace(E,"").replace(new RegExp("\\b".concat(n,"\\b"),"g"),"gl_FragColor")}return t}(t);default:throw new Error("unknown GLSL version ".concat(e))}}function T(t,e){for(const[n,r]of e)t=t.replace(n,r);return t}const C="\n\n".concat(g.a,"\n\n"),P={[r.b]:"vertex",[r.a]:"fragment"};function M(t,e){let{id:n,source:i,type:a,modules:s,defines:u={},hookFunctions:c=[],inject:l={},transpileToGLSL100:f=!1,prologue:d=!0,log:m}=e;Object(o.a)("string"==typeof i,"shader source must be a string");const y=a===r.b,v=i.split("\n");let _=100,b="",x=i;0===v[0].indexOf("#version ")?(_=300,b=v[0],x=v.slice(1).join("\n")):b="#version ".concat(_);const w={};s.forEach(t=>{Object.assign(w,t.getDefines())}),Object.assign(w,u);let E=d?"".concat(b,"\n").concat(function(t){let{id:e,source:n,type:r}=t;return e&&"string"==typeof e&&-1===n.indexOf("SHADER_NAME")?"\n#define SHADER_NAME ".concat(e,"_").concat(P[r],"\n\n"):""}({id:n,source:i,type:a}),"\n").concat(function(t){let{type:e}=t;return"\n#define SHADER_TYPE_".concat(P[e].toUpperCase(),"\n")}({type:a}),"\n").concat(function(t){switch(function(t){const e=t.getExtension("WEBGL_debug_renderer_info"),n=t.getParameter(e&&e.UNMASKED_VENDOR_WEBGL||7936),r=t.getParameter(e&&e.UNMASKED_RENDERER_WEBGL||7937);return{gpuVendor:function(t,e){if(t.match(/NVIDIA/i)||e.match(/NVIDIA/i))return"NVIDIA";if(t.match(/INTEL/i)||e.match(/INTEL/i))return"INTEL";if(t.match(/AMD/i)||e.match(/AMD/i)||t.match(/ATI/i)||e.match(/ATI/i))return"AMD";return"UNKNOWN GPU"}(n,r),vendor:n,renderer:r,version:t.getParameter(7938),shadingLanguageVersion:t.getParameter(35724)}}(t).gpuVendor.toLowerCase()){case"nvidia":return"#define NVIDIA_GPU\n// Nvidia optimizes away the calculation necessary for emulated fp64\n#define LUMA_FP64_CODE_ELIMINATION_WORKAROUND 1\n";case"intel":return"#define INTEL_GPU\n// Intel optimizes away the calculation necessary for emulated fp64\n#define LUMA_FP64_CODE_ELIMINATION_WORKAROUND 1\n// Intel's built-in 'tan' function doesn't have acceptable precision\n#define LUMA_FP32_TAN_PRECISION_WORKAROUND 1\n// Intel GPU doesn't have full 32 bits precision in same cases, causes overflow\n#define LUMA_FP64_HIGH_BITS_OVERFLOW_WORKAROUND 1\n";case"amd":return"#define AMD_GPU\n";default:return"#define DEFAULT_GPU\n// Prevent driver from optimizing away the calculation necessary for emulated fp64\n#define LUMA_FP64_CODE_ELIMINATION_WORKAROUND 1\n// Intel's built-in 'tan' function doesn't have acceptable precision\n#define LUMA_FP32_TAN_PRECISION_WORKAROUND 1\n// Intel GPU doesn't have full 32 bits precision in same cases, causes overflow\n#define LUMA_FP64_HIGH_BITS_OVERFLOW_WORKAROUND 1\n"}}(t),"\n").concat(function(t,e,n){let r="#if (__VERSION__ > 120)\n\n# define FEATURE_GLSL_DERIVATIVES\n# define FEATURE_GLSL_DRAW_BUFFERS\n# define FEATURE_GLSL_FRAG_DEPTH\n# define FEATURE_GLSL_TEXTURE_LOD\n\n// DEPRECATED FLAGS, remove in v9\n# define FRAG_DEPTH\n# define DERIVATIVES\n# define DRAW_BUFFERS\n# define TEXTURE_LOD\n\n#endif // __VERSION\n";return A(t,h.GLSL_FRAG_DEPTH)&&(r+="\n// FRAG_DEPTH => gl_FragDepth is available\n#ifdef GL_EXT_frag_depth\n#extension GL_EXT_frag_depth : enable\n# define FEATURE_GLSL_FRAG_DEPTH\n# define FRAG_DEPTH\n# define gl_FragDepth gl_FragDepthEXT\n#endif\n"),A(t,h.GLSL_DERIVATIVES)&&p(t,h.GLSL_DERIVATIVES)&&(r+="\n// DERIVATIVES => dxdF, dxdY and fwidth are available\n#ifdef GL_OES_standard_derivatives\n#extension GL_OES_standard_derivatives : enable\n# define FEATURE_GLSL_DERIVATIVES\n# define DERIVATIVES\n#endif\n"),A(t,h.GLSL_FRAG_DATA)&&p(t,h.GLSL_FRAG_DATA,{behavior:"require"})&&(r+="\n// DRAW_BUFFERS => gl_FragData[] is available\n#ifdef GL_EXT_draw_buffers\n#extension GL_EXT_draw_buffers : require\n#define FEATURE_GLSL_DRAW_BUFFERS\n#define DRAW_BUFFERS\n#endif\n"),A(t,h.GLSL_TEXTURE_LOD)&&(r+="// TEXTURE_LOD => texture2DLod etc are available\n#ifdef GL_EXT_shader_texture_lod\n#extension GL_EXT_shader_texture_lod : enable\n\n# define FEATURE_GLSL_TEXTURE_LOD\n# define TEXTURE_LOD\n\n#endif\n"),r}(t),"\n").concat(function(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},e=0,n="";for(const r in t){0===e&&(n+="\n// APPLICATION DEFINES\n"),e++;const i=t[r];(i||Number.isFinite(i))&&(n+="#define ".concat(r.toUpperCase()," ").concat(t[r],"\n"))}0===e&&(n+="\n");return n}(w),"\n").concat(y?"":"precision highp float;\n\n","\n"):"".concat(b,"\n");const O=function(t){const e={vs:{},fs:{}};return t.forEach(t=>{let n;"string"!=typeof t?(n=t,t=n.hook):n={},t=t.trim();const[r,i]=t.split(":"),o=t.replace(/\(.+/,"");e[r][o]=Object.assign(n,{signature:i})}),e}(c),T={},M={},I={};for(const t in l){const e="string"==typeof l[t]?{injection:l[t],order:0}:l[t],n=t.match(/^(v|f)s:(#)?([\w-]+)$/);if(n){const r=n[2],i=n[3];r?"decl"===i?M[t]=[e]:I[t]=[e]:T[t]=[e]}else I[t]=[e]}for(const t of s){m&&t.checkDeprecations(x,m);E+=t.getModuleSource(a,_);const e=t.injections[a];for(const t in e){const n=t.match(/^(v|f)s:#([\w-]+)$/);if(n){const r="decl"===n[2]?M:I;r[t]=r[t]||[],r[t].push(e[t])}else T[t]=T[t]||[],T[t].push(e[t])}}return E+=C,E=Object(g.c)(E,a,M),E+=function(t,e){let n="";for(const r in t){const i=t[r];if(n+="void ".concat(i.signature," {\n"),i.header&&(n+="  ".concat(i.header)),e[r]){const t=e[r];t.sort((t,e)=>t.order-e.order);for(const e of t)n+="  ".concat(e.injection,"\n")}i.footer&&(n+="  ".concat(i.footer)),n+="}\n"}return n}(O[a],T),E+=x,E=Object(g.c)(E,a,I),E=S(E,f?100:_,y),E}function I(t){return function(e){const n={};for(const r of t){const t=r.getUniforms(e,n);Object.assign(n,t)}return n}}var B=n(321);n.d(e,"a",(function(){return R}));class R{static getDefaultProgramManager(t){return t.luma=t.luma||{},t.luma.defaultProgramManager=t.luma.defaultProgramManager||new R(t),t.luma.defaultProgramManager}constructor(t){this.gl=t,this._programCache={},this._getUniforms={},this._registeredModules={},this._hookFunctions=[],this._defaultModules=[],this._hashes={},this._hashCounter=0,this.stateHash=0,this._useCounts={}}addDefaultModule(t){this._defaultModules.find(e=>e.name===t.name)||this._defaultModules.push(t),this.stateHash++}removeDefaultModule(t){const e="string"==typeof t?t:t.name;this._defaultModules=this._defaultModules.filter(t=>t.name!==e),this.stateHash++}addShaderHook(t,e){e&&(t=Object.assign(e,{hook:t})),this._hookFunctions.push(t),this.stateHash++}get(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{vs:e="",fs:n="",defines:i={},inject:o={},varyings:s=[],bufferMode:u=35981,transpileToGLSL100:c=!1}=t,l=this._getModuleList(t.modules),h=this._getHash(e),f=this._getHash(n),p=l.map(t=>this._getHash(t.name)).sort(),d=s.map(t=>this._getHash(t)),A=Object.keys(i).sort(),g=Object.keys(o).sort(),m=[],y=[];for(const t of A)m.push(this._getHash(t)),m.push(this._getHash(i[t]));for(const t of g)y.push(this._getHash(t)),y.push(this._getHash(o[t]));const v="".concat(h,"/").concat(f,"D").concat(m.join("/"),"M").concat(p.join("/"),"I").concat(y.join("/"),"V").concat(d.join("/"),"H").concat(this.stateHash,"B").concat(u).concat(c?"T":"");if(!this._programCache[v]){const t=function(t,e){const{vs:n,fs:i}=e,o=a(e.modules||[]);return{gl:t,vs:M(t,Object.assign({},e,{source:n,type:r.b,modules:o})),fs:M(t,Object.assign({},e,{source:i,type:r.a,modules:o})),getUniforms:I(o)}}(this.gl,{vs:e,fs:n,modules:l,inject:o,defines:i,hookFunctions:this._hookFunctions,transpileToGLSL100:c});this._programCache[v]=new B.a(this.gl,{hash:v,vs:t.vs,fs:t.fs,varyings:s,bufferMode:u}),this._getUniforms[v]=t.getUniforms||(t=>{}),this._useCounts[v]=0}return this._useCounts[v]++,this._programCache[v]}getUniforms(t){return this._getUniforms[t.hash]||null}release(t){const e=t.hash;this._useCounts[e]--,0===this._useCounts[e]&&(this._programCache[e].delete(),delete this._programCache[e],delete this._getUniforms[e],delete this._useCounts[e])}_getHash(t){return void 0===this._hashes[t]&&(this._hashes[t]=this._hashCounter++),this._hashes[t]}_getModuleList(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:[];const e=new Array(this._defaultModules.length+t.length),n={};let r=0;for(let t=0,i=this._defaultModules.length;t<i;++t){const i=this._defaultModules[t],o=i.name;e[r++]=i,n[o]=!0}for(let i=0,o=t.length;i<o;++i){const o=t[i],a=o.name;n[a]||(e[r++]=o,n[a]=!0)}return e.length=r,e}}},function(t,e,n){"use strict";var r=n(187);const i={number:{validate:(t,e)=>Number.isFinite(t)&&(!("max"in e)||t<=e.max)&&(!("min"in e)||t>=e.min)},array:{validate:(t,e)=>Array.isArray(t)||ArrayBuffer.isView(t)}};function o(t){let e=a(t);return"object"===e?t?"type"in t?Object.assign({},t,i[t.type]):"value"in t?(e=a(t.value),Object.assign({type:e},t,i[e])):{type:"object",value:t}:{type:"object",value:null}:Object.assign({type:e,value:t},i[e])}function a(t){return Array.isArray(t)||ArrayBuffer.isView(t)?"array":typeof t}n.d(e,"a",(function(){return s})),n.d(e,"b",(function(){return u}));class s{constructor(t){let{name:e,vs:n,fs:i,dependencies:a=[],uniforms:s,getUniforms:u,deprecations:c=[],defines:l={},inject:h={},vertexShader:f,fragmentShader:p}=t;Object(r.a)("string"==typeof e),this.name=e,this.vs=n||f,this.fs=i||p,this.getModuleUniforms=u,this.dependencies=a,this.deprecations=this._parseDeprecationDefinitions(c),this.defines=l,this.injections=function(t){const e={vs:{},fs:{}};for(const n in t){let r=t[n];const i=n.slice(0,2);"string"==typeof r&&(r={order:0,injection:r}),e[i][n]=r}return e}(h),s&&(this.uniforms=function(t){const e={};for(const n in t){const r=o(t[n]);e[n]=r}return e}(s))}getModuleSource(t){let e;switch(t){case"vs":e=this.vs||"";break;case"fs":e=this.fs||"";break;default:Object(r.a)(!1)}return"#define MODULE_".concat(this.name.toUpperCase().replace(/[^0-9a-z]/gi,"_"),"\n").concat(e,"// END MODULE_").concat(this.name,"\n\n")}getUniforms(t,e){return this.getModuleUniforms?this.getModuleUniforms(t,e):this.uniforms?this._defaultGetUniforms(t):{}}getDefines(){return this.defines}checkDeprecations(t,e){this.deprecations.forEach(n=>{n.regex.test(t)&&(n.deprecated?e.deprecated(n.old,n.new)():e.removed(n.old,n.new)())})}_parseDeprecationDefinitions(t){return t.forEach(t=>{switch(t.type){case"function":t.regex=new RegExp("\\b".concat(t.old,"\\("));break;default:t.regex=new RegExp("".concat(t.type," ").concat(t.old,";"))}}),t}_defaultGetUniforms(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const e={},n=this.uniforms;for(const i in n){const o=n[i];i in t&&!o.private?(o.validate&&Object(r.a)(o.validate(t[i],o),"".concat(this.name,": invalid ").concat(i)),e[i]=t[i]):e[i]=o.value}return e}}function u(t){if(!t.normalized&&(t.normalized=!0,t.uniforms&&!t.getUniforms)){const e=new s(t);t.getUniforms=e.getUniforms.bind(e)}return t}},function(t,e,n){"use strict";var r=n(33),i=n(74),o=n(54),a=n(7),s=n(53),u=n(10);function c(t){switch(t){case 6406:case 33326:case 6403:return 1;case 33328:case 33319:return 2;case 6407:case 34837:return 3;case 6408:case 34836:return 4;default:return Object(u.a)(!1),0}}var l=n(236);function h(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};const{sourceX:n=0,sourceY:r=0,sourceFormat:i=6408}=e;let{sourceAttachment:o=36064,target:a=null,sourceWidth:c,sourceHeight:l,sourceType:h}=e;const{framebuffer:f,deleteFramebuffer:p}=A(t);Object(u.a)(f);const{gl:d,handle:m,attachments:y}=f;c=c||f.width,l=l||f.height,36064===o&&null===m&&(o=1028),Object(u.a)(y[o]),h=h||y[o].type,a=g(a,h,i,c,l),h=h||Object(s.b)(a);const v=d.bindFramebuffer(36160,m);return d.readPixels(n,r,c,l,i,h,a),d.bindFramebuffer(36160,v||null),p&&f.delete(),a}function f(t,e){let{sourceX:n=0,sourceY:i=0,sourceFormat:o=6408,target:s=null,targetByteOffset:l=0,sourceWidth:h,sourceHeight:f,sourceType:p}=e;const{framebuffer:d,deleteFramebuffer:g}=A(t);Object(u.a)(d),h=h||d.width,f=f||d.height;const m=Object(a.a)(d.gl);if(p=p||(s?s.type:5121),!s){const t=c(o),e=function(t){switch(t){case 5121:return 1;case 33635:case 32819:case 32820:return 2;case 5126:return 4;default:return Object(u.a)(!1),0}}(p),n=l+h*f*t*e;s=new r.a(m,{byteLength:n,accessor:{type:p,size:t}})}return s.bind({target:35051}),Object(a.o)(m,{framebuffer:d},()=>{m.readPixels(n,i,h,f,o,p,l)}),s.unbind({target:35051}),g&&d.delete(),s}function p(t){let{sourceAttachment:e=36064,targetMaxHeight:n=Number.MAX_SAFE_INTEGER}=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},r=h(t,{sourceAttachment:e}),{width:i,height:o}=t;for(;o>n;)({data:r,width:i,height:o}=Object(s.d)({data:r,width:i,height:o}));Object(s.a)({data:r,width:i,height:o});const a=document.createElement("canvas");a.width=i,a.height=o;const u=a.getContext("2d"),c=u.createImageData(i,o);return c.data.set(r),u.putImageData(c,0,0),a.toDataURL()}function d(t,e){let n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{};const{sourceX:r=0,sourceY:i=0,targetMipmaplevel:s=0,targetInternalFormat:c=6408}=n;let{targetX:l,targetY:h,targetZ:f,width:p,height:d}=n;const{framebuffer:g,deleteFramebuffer:m}=A(t);Object(u.a)(g);const{gl:y,handle:v}=g,_=void 0!==l||void 0!==h||void 0!==f;l=l||0,h=h||0,f=f||0;const b=y.bindFramebuffer(36160,v);Object(u.a)(e);let x=null;if(e instanceof o.a&&(x=e,p=Number.isFinite(p)?p:x.width,d=Number.isFinite(d)?d:x.height,x.bind(0),e=x.target),_)switch(e){case 3553:case 34067:y.copyTexSubImage2D(e,s,l,h,r,i,p,d);break;case 35866:case 32879:Object(a.a)(y).copyTexSubImage3D(e,s,l,h,f,r,i,p,d)}else y.copyTexImage2D(e,s,c,r,i,p,d,0);return x&&x.unbind(),y.bindFramebuffer(36160,b||null),m&&g.delete(),x}function A(t){return t instanceof i.a?{framebuffer:t,deleteFramebuffer:!1}:{framebuffer:Object(l.b)(t),deleteFramebuffer:!0}}function g(t,e,n,r,i){if(t)return t;e=e||5121;return new(Object(s.c)(e,{clamped:!1}))(r*i*c(n))}n.d(e,"c",(function(){return h})),n.d(e,"d",(function(){return f})),n.d(e,"a",(function(){return p})),n.d(e,"b",(function(){return d}))},,,,,,,,function(t,e,n){var r=n(194).default,i=n(261);t.exports=function(t){var e=i(t,"string");return"symbol"===r(e)?e:String(e)},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){"use strict";n.d(e,"a",(function(){return s}));var r=n(22),i=n(45),o=n(46),a=n(105);async function s(t,e,n,s){Array.isArray(e)||Object(i.a)(e)||(void 0,n=e,e=void 0);const u=Object(o.a)(n);let c=t;return"string"==typeof t&&(c=await u(t)),Object(r.b)(t)&&(c=await u(t)),await Object(a.a)(c,e,n)}},function(t,e){},function(t,e,n){"use strict";var r=n(104);e.a={name:"project32",dependencies:[r.a],vs:"\nvec4 project_position_to_clipspace(\n  vec3 position, vec3 position64Low, vec3 offset, out vec4 commonPosition\n) {\n  vec3 projectedPosition = project_position(position, position64Low);\n  mat3 rotation;\n  if (project_needs_rotation(projectedPosition, rotation)) {\n    // offset is specified as ENU\n    // when in globe projection, rotate offset so that the ground alighs with the surface of the globe\n    offset = rotation * offset;\n  }\n  commonPosition = vec4(projectedPosition + offset, 1.0);\n  return project_common_position_to_clipspace(commonPosition);\n}\n\nvec4 project_position_to_clipspace(\n  vec3 position, vec3 position64Low, vec3 offset\n) {\n  vec4 commonPosition;\n  return project_position_to_clipspace(position, position64Low, offset, commonPosition);\n}\n"}},function(t,e,n){"use strict";n.d(e,"a",(function(){return l}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(0),u=n.n(s),c=n(61),l=function(){function t(e){i()(this,t),e&&(this.opts=e)}return a()(t,[{key:"equals",value:function(t){return this===t||this.constructor===t.constructor&&Object(c.a)(this.opts,t.opts)}},{key:"getShaders",value:function(t){return null}},{key:"getSubLayerProps",value:function(t){var e=t.constructor.defaultProps,n={updateTriggers:{}};for(var r in e)if(r in this.props){var i=e[r],o=this.props[r];n[r]=o,i&&"accessor"===i.type&&(n.updateTriggers[r]=this.props.updateTriggers[r],"function"==typeof o&&(n[r]=this.getSubLayerAccessor(o)))}return n}},{key:"initializeState",value:function(t,e){}},{key:"updateState",value:function(t,e){}},{key:"draw",value:function(t,e){}},{key:"finalizeState",value:function(t,e){}}]),t}();u()(l,"defaultProps",{})},function(t,e,n){"use strict";n.d(e,"a",(function(){return A}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(0),u=n.n(s),c=n(52),l=n(68),h=n(29),f=n(33);function p(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return d(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return d(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function d(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var A=function(){function t(e){i()(this,t),u()(this,"indexStarts",[0]),u()(this,"vertexStarts",[0]),u()(this,"vertexCount",0),u()(this,"instanceCount",0);var n=e.attributes,r=void 0===n?{}:n;this.typedArrayManager=l.a,this.attributes={},this._attributeDefs=r,this.opts=e,this.updateGeometry(e)}return a()(t,[{key:"updateGeometry",value:function(t){Object.assign(this.opts,t);var e=this.opts,n=e.data,r=e.buffers,i=void 0===r?{}:r,o=e.getGeometry,a=e.geometryBuffer,s=e.positionFormat,u=e.dataChanged,c=e.normalize,l=void 0===c||c;if(this.data=n,this.getGeometry=o,this.positionSize=a&&a.size||("XY"===s?2:3),this.buffers=i,this.normalize=l,a&&(Object(h.a)(n.startIndices),this.getGeometry=this.getGeometryFromBuffer(a),l||(i.positions=a)),this.geometryBuffer=i.positions,Array.isArray(u)){var f,d=p(u);try{for(d.s();!(f=d.n()).done;){var A=f.value;this._rebuildGeometry(A)}}catch(t){d.e(t)}finally{d.f()}}else this._rebuildGeometry()}},{key:"updatePartialGeometry",value:function(t){var e=t.startRow,n=t.endRow;this._rebuildGeometry({startRow:e,endRow:n})}},{key:"getGeometryFromBuffer",value:function(t){var e=t.value||t;return ArrayBuffer.isView(e)?Object(c.b)(e,{size:this.positionSize,offset:t.offset,stride:t.stride,startIndices:this.data.startIndices}):null}},{key:"_allocate",value:function(t,e){var n=this.attributes,r=this.buffers,i=this._attributeDefs,o=this.typedArrayManager;for(var a in i)if(a in r)o.release(n[a]),n[a]=null;else{var s=i[a];s.copy=e,n[a]=o.allocate(n[a],t,s)}}},{key:"_forEachGeometry",value:function(t,e,n){var r,i=this.data,o=this.getGeometry,a=Object(c.a)(i,e,n),s=a.iterable,u=a.objectInfo,l=p(s);try{for(l.s();!(r=l.n()).done;){var h=r.value;u.index++,t(o?o(h,u):null,u.index)}}catch(t){l.e(t)}finally{l.f()}}},{key:"_rebuildGeometry",value:function(t){var e=this;if(this.data){var n=this.indexStarts,r=this.vertexStarts,i=this.instanceCount,o=this.data,a=this.geometryBuffer,s=t||{},u=s.startRow,c=void 0===u?0:u,l=s.endRow,h=void 0===l?1/0:l,p={};if(t||(n=[0],r=[0]),this.normalize||!a)this._forEachGeometry((function(t,n){var i=t&&e.normalizeGeometry(t);p[n]=i,r[n+1]=r[n]+(i?e.getGeometrySize(i):0)}),c,h),i=r[r.length-1];else if(r=o.startIndices,i=r[o.length]||0,ArrayBuffer.isView(a))i=i||a.length/this.positionSize;else if(a instanceof f.a){var d=a.accessor.stride||4*this.positionSize;i=i||a.byteLength/d}else if(a.buffer){var A=a.stride||4*this.positionSize;i=i||a.buffer.byteLength/A}else if(a.value){var g=a.value,m=a.stride/g.BYTES_PER_ELEMENT||this.positionSize;i=i||g.length/m}this._allocate(i,Boolean(t)),this.indexStarts=n,this.vertexStarts=r,this.instanceCount=i;var y={};this._forEachGeometry((function(t,o){var a=p[o]||t;y.vertexStart=r[o],y.indexStart=n[o];var s=o<r.length-1?r[o+1]:i;y.geometrySize=s-r[o],y.geometryIndex=o,e.updateGeometryAttributes(a,y)}),c,h),this.vertexCount=n[n.length-1]}}}]),t}()},function(t,e,n){"use strict";n.d(e,"a",(function(){return o}));var r=n(134),i=n(72);function o(t,e){return!!r.a.isSupported()&&(!!(i.c||null!=e&&e._nodeWorkers)&&(t.worker&&(null==e?void 0:e.worker)))}},function(t,e,n){"use strict";n.d(e,"a",(function(){return a}));var r=n(2),i=n(76);const o={id:"request-scheduler",throttleRequests:!0,maxRequests:6};class a{constructor(t={}){Object(r.a)(this,"props",void 0),Object(r.a)(this,"stats",void 0),Object(r.a)(this,"activeRequestCount",0),Object(r.a)(this,"requestQueue",[]),Object(r.a)(this,"requestMap",new Map),Object(r.a)(this,"deferredUpdate",null),this.props={...o,...t},this.stats=new i.a({id:this.props.id}),this.stats.get("Queued Requests"),this.stats.get("Active Requests"),this.stats.get("Cancelled Requests"),this.stats.get("Queued Requests Ever"),this.stats.get("Active Requests Ever")}scheduleRequest(t,e=(()=>0)){if(!this.props.throttleRequests)return Promise.resolve({done:()=>{}});if(this.requestMap.has(t))return this.requestMap.get(t);const n={handle:t,priority:0,getPriority:e},r=new Promise(t=>(n.resolve=t,n));return this.requestQueue.push(n),this.requestMap.set(t,r),this._issueNewRequests(),r}_issueRequest(t){const{handle:e,resolve:n}=t;let r=!1;const i=()=>{r||(r=!0,this.requestMap.delete(e),this.activeRequestCount--,this._issueNewRequests())};return this.activeRequestCount++,n?n({done:i}):Promise.resolve({done:i})}_issueNewRequests(){this.deferredUpdate||(this.deferredUpdate=setTimeout(()=>this._issueNewRequestsAsync(),0))}_issueNewRequestsAsync(){this.deferredUpdate=null;const t=Math.max(this.props.maxRequests-this.activeRequestCount,0);if(0!==t){this._updateAllRequests();for(let e=0;e<t;++e){const t=this.requestQueue.shift();t&&this._issueRequest(t)}}}_updateAllRequests(){const t=this.requestQueue;for(let e=0;e<t.length;++e){const n=t[e];this._updateRequest(n)||(t.splice(e,1),this.requestMap.delete(n.handle),e--)}t.sort((t,e)=>t.priority-e.priority)}_updateRequest(t){return t.priority=t.getPriority(t.handle),!(t.priority<0)||(t.resolve(null),!1)}}},function(t,e,n){"use strict";n.d(e,"a",(function(){return r}));const r={name:"JSON",id:"json",module:"json",version:"3.2.10",extensions:["json","geojson"],mimeTypes:["application/json"],category:"json",text:!0,parseTextSync:i,parse:async t=>i((new TextDecoder).decode(t)),options:{}};function i(t){return JSON.parse(t)}},function(t,e,n){"use strict";n.d(e,"a",(function(){return y}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(5),u=n.n(s),c=n(6),l=n.n(c),h=n(1),f=n.n(h),p=n(0),d=n.n(p),A=n(297),g=n(12);function m(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=f()(t);if(e){var i=f()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return l()(this,n)}}var y=function(t){u()(n,t);var e=m(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getGeometry",value:function(t){return new A.a}},{key:"draw",value:function(t){var e=t.uniforms,n=this.props,r=n.elevationScale,i=n.extruded,o=n.offset,a=n.coverage,s=n.cellSize,u=n.angle,c=n.radiusUnits;this.state.model.setUniforms(e).setUniforms({radius:s/2,radiusUnits:g.e[c],angle:u,offset:o,extruded:i,coverage:a,elevationScale:r,edgeDistance:1,isWireframe:!1}).draw()}}]),n}(n(167).a);d()(y,"layerName","GridCellLayer"),d()(y,"defaultProps",{cellSize:{type:"number",min:0,value:1e3},offset:{type:"array",value:[1,1]}})},function(t,e,n){"use strict";n.d(e,"a",(function(){return T}));var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(5),u=n.n(s),c=n(6),l=n.n(c),h=n(1),f=n.n(h),p=n(0),d=n.n(p),A=n(21),g=n(52),m=n(198),y=n(116),v=n(117),_=n(64),b=n(182);function x(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return w(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return w(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function w(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function E(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=f()(t);if(e){var i=f()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return l()(this,n)}}var O=[0,0,0,255],S={stroked:!0,filled:!0,extruded:!1,elevationScale:1,wireframe:!1,_normalize:!0,_windingOrder:"CW",lineWidthUnits:"meters",lineWidthScale:1,lineWidthMinPixels:0,lineWidthMaxPixels:Number.MAX_SAFE_INTEGER,lineJointRounded:!1,lineMiterLimit:4,getPolygon:{type:"accessor",value:function(t){return t.polygon}},getFillColor:{type:"accessor",value:[0,0,0,255]},getLineColor:{type:"accessor",value:O},getLineWidth:{type:"accessor",value:1},getElevation:{type:"accessor",value:1e3},material:!0},T=function(t){u()(n,t);var e=E(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"initializeState",value:function(){this.state={paths:[]},this.props.getLineDashArray&&A.a.removed("getLineDashArray","PathStyleExtension")()}},{key:"updateState",value:function(t){var e=this,n=t.changeFlags,r=n.dataChanged||n.updateTriggersChanged&&(n.updateTriggersChanged.all||n.updateTriggersChanged.getPolygon);if(r&&Array.isArray(n.dataChanged)){var i=this.state.paths.slice(),o=n.dataChanged.map((function(t){return Object(b.a)({data:i,getIndex:function(t){return t.__source.index},dataRange:t,replace:e._getPaths(t)})}));this.setState({paths:i,pathsDiff:o})}else r&&this.setState({paths:this._getPaths(),pathsDiff:null})}},{key:"_getPaths",value:function(){var t,e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},n=this.props,r=n.data,i=n.getPolygon,o=n.positionFormat,a=n._normalize,s=[],u="XY"===o?2:3,c=e.startRow,l=e.endRow,h=Object(g.a)(r,c,l),f=h.iterable,p=h.objectInfo,d=x(f);try{for(d.s();!(t=d.n()).done;){var A=t.value;p.index++;var m=i(A,p);a&&(m=_.d(m,u));var y=m,v=y.holeIndices,b=m.positions||m;if(v)for(var w=0;w<=v.length;w++){var E=b.slice(v[w-1]||0,v[w]||b.length);s.push(this.getSubLayerRow({path:E},A,p.index))}else s.push(this.getSubLayerRow({path:b},A,p.index))}}catch(t){d.e(t)}finally{d.f()}return s}},{key:"renderLayers",value:function(){var t=this.props,e=t.data,n=t._dataDiff,r=t.stroked,i=t.filled,o=t.extruded,a=t.wireframe,s=t._normalize,u=t._windingOrder,c=t.elevationScale,l=t.transitions,h=t.positionFormat,f=this.props,p=f.lineWidthUnits,d=f.lineWidthScale,A=f.lineWidthMinPixels,g=f.lineWidthMaxPixels,m=f.lineJointRounded,_=f.lineMiterLimit,b=f.lineDashJustified,x=this.props,w=x.getFillColor,E=x.getLineColor,S=x.getLineWidth,T=x.getLineDashArray,C=x.getElevation,P=x.getPolygon,M=x.updateTriggers,I=x.material,B=this.state,R=B.paths,k=B.pathsDiff,D=this.getSubLayerClass("fill",y.a),L=this.getSubLayerClass("stroke",v.a),j=this.shouldRenderSubLayer("fill",R)&&new D({_dataDiff:n,extruded:o,elevationScale:c,filled:i,wireframe:a,_normalize:s,_windingOrder:u,getElevation:C,getFillColor:w,getLineColor:o&&a?E:O,material:I,transitions:l},this.getSubLayerProps({id:"fill",updateTriggers:M&&{getPolygon:M.getPolygon,getElevation:M.getElevation,getFillColor:M.getFillColor,lineColors:o&&a,getLineColor:M.getLineColor}}),{data:e,positionFormat:h,getPolygon:P});return[!o&&j,!o&&r&&this.shouldRenderSubLayer("stroke",R)&&new L({_dataDiff:k&&function(){return k},widthUnits:p,widthScale:d,widthMinPixels:A,widthMaxPixels:g,jointRounded:m,miterLimit:_,dashJustified:b,_pathType:"loop",transitions:l&&{getWidth:l.getLineWidth,getColor:l.getLineColor,getPath:l.getPolygon},getColor:this.getSubLayerAccessor(E),getWidth:this.getSubLayerAccessor(S),getDashArray:this.getSubLayerAccessor(T)},this.getSubLayerProps({id:"stroke",updateTriggers:M&&{getWidth:M.getLineWidth,getColor:M.getLineColor,getDashArray:M.getLineDashArray}}),{data:R,positionFormat:h,getPath:function(t){return t.path}}),o&&j]}}]),n}(m.a);d()(T,"layerName","PolygonLayer"),d()(T,"defaultProps",S)},function(t,e,n){"use strict";n.d(e,"a",(function(){return i}));var r=n(136);function i(t){try{return JSON.parse(t)}catch(e){throw new Error('Failed to parse JSON from data starting with "'.concat(Object(r.a)(t),'"'))}}},function(t,e){e.read=function(t,e,n,r,i){var o,a,s=8*i-r-1,u=(1<<s)-1,c=u>>1,l=-7,h=n?i-1:0,f=n?-1:1,p=t[e+h];for(h+=f,o=p&(1<<-l)-1,p>>=-l,l+=s;l>0;o=256*o+t[e+h],h+=f,l-=8);for(a=o&(1<<-l)-1,o>>=-l,l+=r;l>0;a=256*a+t[e+h],h+=f,l-=8);if(0===o)o=1-c;else{if(o===u)return a?NaN:1/0*(p?-1:1);a+=Math.pow(2,r),o-=c}return(p?-1:1)*a*Math.pow(2,o-r)},e.write=function(t,e,n,r,i,o){var a,s,u,c=8*o-i-1,l=(1<<c)-1,h=l>>1,f=23===i?Math.pow(2,-24)-Math.pow(2,-77):0,p=r?0:o-1,d=r?1:-1,A=e<0||0===e&&1/e<0?1:0;for(e=Math.abs(e),isNaN(e)||e===1/0?(s=isNaN(e)?1:0,a=l):(a=Math.floor(Math.log(e)/Math.LN2),e*(u=Math.pow(2,-a))<1&&(a--,u*=2),(e+=a+h>=1?f/u:f*Math.pow(2,1-h))*u>=2&&(a++,u/=2),a+h>=l?(s=0,a=l):a+h>=1?(s=(e*u-1)*Math.pow(2,i),a+=h):(s=e*Math.pow(2,h-1)*Math.pow(2,i),a=0));i>=8;t[n+p]=255&s,p+=d,s/=256,i-=8);for(a=a<<i|s,c+=i;c>0;t[n+p]=255&a,p+=d,a/=256,c-=8);t[n+p-d]|=128*A}},function(t,e){t.exports=function(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(8),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(28),y=n.n(m),v=n(217),_=n(234),b=n(21),x=n(164),w=n(7),E=n(324),O=n(84),S=n(78),T=n(47),C=n(10);class P{constructor(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{id:e}=t;this.id=e||Object(T.c)(this.constructor.name),this.display=!0,this.position=new O.a,this.rotation=new O.a,this.scale=new O.a(1,1,1),this.matrix=new S.a,this.userData={},this.props={},this._setScenegraphNodeProps(t)}delete(){}setProps(t){return this._setScenegraphNodeProps(t),this}toString(){return"{type: ScenegraphNode, id: ".concat(this.id,")}")}setPosition(t){return Object(C.a)(3===t.length,"setPosition requires vector argument"),this.position=t,this}setRotation(t){return Object(C.a)(3===t.length,"setRotation requires vector argument"),this.rotation=t,this}setScale(t){return Object(C.a)(3===t.length,"setScale requires vector argument"),this.scale=t,this}setMatrix(t){!(arguments.length>1&&void 0!==arguments[1])||arguments[1]?this.matrix.copy(t):this.matrix=t}setMatrixComponents(t){let{position:e,rotation:n,scale:r,update:i=!0}=t;return e&&this.setPosition(e),n&&this.setRotation(n),r&&this.setScale(r),i&&this.updateMatrix(),this}updateMatrix(){const t=this.position,e=this.rotation,n=this.scale;return this.matrix.identity(),this.matrix.translate(t),this.matrix.rotateXYZ(e),this.matrix.scale(n),this}update(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{position:e,rotation:n,scale:r}=t;return e&&this.setPosition(e),n&&this.setRotation(n),r&&this.setScale(r),this.updateMatrix(),this}getCoordinateUniforms(t,e){Object(C.a)(t),e=e||this.matrix;const n=new S.a(t).multiplyRight(e),r=n.invert(),i=r.transpose();return{viewMatrix:t,modelMatrix:e,objectMatrix:e,worldMatrix:n,worldInverseMatrix:r,worldInverseTransposeMatrix:i}}_setScenegraphNodeProps(t){"display"in t&&(this.display=t.display),"position"in t&&this.setPosition(t.position),"rotation"in t&&this.setRotation(t.rotation),"scale"in t&&this.setScale(t.scale),"matrix"in t&&this.setMatrix(t.matrix),Object.assign(this.props,t)}}var M=n(33),I=n(63);class B extends P{constructor(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};t=Array.isArray(t)?{children:t}:t;const{children:e=[]}=t;w.k.assert(e.every(t=>t instanceof P),"every child must an instance of ScenegraphNode"),super(t),this.children=e}add(){for(var t=arguments.length,e=new Array(t),n=0;n<t;n++)e[n]=arguments[n];for(const t of e)Array.isArray(t)?this.add(...t):this.children.push(t);return this}remove(t){const e=this.children,n=e.indexOf(t);return n>-1&&e.splice(n,1),this}removeAll(){return this.children=[],this}delete(){this.children.forEach(t=>t.delete()),this.removeAll(),super.delete()}traverse(t){let{worldMatrix:e=new S.a}=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};const n=new S.a(e).multiplyRight(this.matrix);for(const e of this.children)e instanceof B?e.traverse(t,{worldMatrix:n}):t(e,{worldMatrix:n})}}var R=n(323);const k={SCALAR:1,VEC2:2,VEC3:3,VEC4:4,MAT2:4,MAT3:9,MAT4:16},D={5120:Int8Array,5121:Uint8Array,5122:Int16Array,5123:Uint16Array,5125:Uint32Array,5126:Float32Array};function L(t){if(!t._animation){const e=D[t.componentType],n=k[t.type],r=n*t.count,{buffer:i,byteOffset:o}=t.bufferView.data,a=new e(i,o+(t.byteOffset||0),r);if(1===n)t._animation=Array.from(a);else{const e=[];for(let t=0;t<a.length;t+=n)e.push(Array.from(a.slice(t,t+n)));t._animation=e}}return t._animation}const j=new S.a;const F=new R.a;function z(t,e,n,r){let{input:i,interpolation:o,output:a}=e;const s=t%i[i.length-1],u=i.findIndex(t=>t>=s),c=Math.max(0,u-1);if(!Array.isArray(n[r]))switch(r){case"translation":n[r]=[0,0,0];break;case"rotation":n[r]=[0,0,0,1];break;case"scale":n[r]=[1,1,1];break;default:w.k.warn("Bad animation path ".concat(r))()}Object(C.a)(n[r].length===a[c].length);const l=i[c],h=i[u];switch(o){case"STEP":!function(t,e,n){for(let r=0;r<n.length;r++)t[e][r]=n[r]}(n,r,a[c]);break;case"LINEAR":if(h>l){const t=(s-l)/(h-l);!function(t,e,n,r,i){if("rotation"===e){F.slerp({start:n,target:r,ratio:i});for(let n=0;n<F.length;n++)t[e][n]=F[n]}else for(let o=0;o<n.length;o++)t[e][o]=i*r[o]+(1-i)*n[o]}(n,r,a[c],a[u],t)}break;case"CUBICSPLINE":if(h>l){const t=(s-l)/(h-l),e=h-l;!function(t,e,n){let{p0:r,outTangent0:i,inTangent1:o,p1:a,tDiff:s,ratio:u}=n;for(let n=0;n<t[e].length;n++){const c=i[n]*s,l=o[n]*s;t[e][n]=(2*Math.pow(u,3)-3*Math.pow(u,2)+1)*r[n]+(Math.pow(u,3)-2*Math.pow(u,2)+u)*c+(-2*Math.pow(u,3)+3*Math.pow(u,2))*a[n]+(Math.pow(u,3)-Math.pow(u,2))*l}}(n,r,{p0:a[3*c+1],outTangent0:a[3*c+2],inTangent1:a[3*u+0],p1:a[3*u+1],tDiff:e,ratio:t})}break;default:w.k.warn("Interpolation ".concat(o," not supported"))()}}class U{constructor(t){this.startTime=0,this.playing=!0,this.speed=1,this.channels=[],Object.assign(this,t)}animate(t){if(!this.playing)return;const e=(t/1e3-this.startTime)*this.speed;this.channels.forEach(t=>{let{sampler:n,target:r,path:i}=t;z(e,n,r,i),function(t,e){if(e.matrix.identity(),t.translation&&e.matrix.translate(t.translation),t.rotation){const n=j.fromQuaternion(t.rotation);e.matrix.multiplyRight(n)}t.scale&&e.matrix.scale(t.scale)}(r,r._node)})}}class N{constructor(t){this.animations=t.animations.map((e,n)=>{const r=e.name||"Animation-".concat(n),i=e.samplers.map(e=>{let{input:n,interpolation:r="LINEAR",output:i}=e;return{input:L(t.accessors[n]),interpolation:r,output:L(t.accessors[i])}}),o=e.channels.map(e=>{let{sampler:n,target:r}=e;return{sampler:i[n],target:t.nodes[r.node],path:r.path}});return new U({name:r,channels:o})})}animate(t){this.setTime(t)}setTime(t){this.animations.forEach(e=>e.animate(t))}getAnimations(){return this.animations}}var G=n(186);class V extends P{constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};super(e),this.onBeforeRender=null,this.AfterRender=null,t instanceof G.a?(this.model=t,this._setModelNodeProps(e)):this.model=new G.a(t,e),this.managedResources=e.managedResources||[]}setProps(t){return super.setProps(t),this._setModelNodeProps(t),this}delete(){this.model&&(this.model.delete(),this.model=null),this.managedResources.forEach(t=>t.delete()),this.managedResources=[]}draw(){return this.model.draw(...arguments)}setUniforms(){return this.model.setUniforms(...arguments),this}setAttributes(){return this.model.setAttributes(...arguments),this}updateModuleSettings(){return this.model.updateModuleSettings(...arguments),this}_setModelNodeProps(t){this.model.setProps(t)}}var H=n(247);function W(t,e){return Object(w.j)(t)?"#version 300 es\n".concat(e):e}const q={SCALAR:1,VEC2:2,VEC3:3,VEC4:4,MAT2:4,MAT3:9,MAT4:16},X={modelOptions:{},pbrDebug:!1,imageBasedLightingEnvironment:null,lights:!0,useTangents:!1};class Z{constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};this.gl=t,this.options=Object.assign({},X,e)}instantiate(t){this.gltf=t;return(t.scenes||[]).map(t=>this.createScene(t))}createAnimator(){return Array.isArray(this.gltf.animations)?new N(this.gltf):null}createScene(t){const e=(t.nodes||[]).map(t=>this.createNode(t));return new B({id:t.name||t.id,children:e})}createNode(t){if(!t._node){const e=(t.children||[]).map(t=>this.createNode(t));t.mesh&&e.push(this.createMesh(t.mesh));const n=new B({id:t.name||t.id,children:e});if(t.matrix)n.setMatrix(t.matrix);else{if(n.matrix.identity(),t.translation&&n.matrix.translate(t.translation),t.rotation){const e=(new S.a).fromQuaternion(t.rotation);n.matrix.multiplyRight(e)}t.scale&&n.matrix.scale(t.scale)}t._node=n}return t._node}createMesh(t){if(!t._mesh){const e=(t.primitives||[]).map((e,n)=>this.createPrimitive(e,n,t)),n=new B({id:t.name||t.id,children:e});t._mesh=n}return t._mesh}getVertexCount(t){w.k.warn("getVertexCount() not found")()}createPrimitive(t,e,n){return function(t,e){const{id:n,drawMode:r,vertexCount:i,attributes:o,modelOptions:a}=e,s=new H.a(t,e);w.k.info(4,"createGLTFModel defines: ",s.defines)();const u=[];u.push(...s.generatedTextures),u.push(...Object.values(o).map(t=>t.buffer));const c=new V(t,Object.assign({id:n,drawMode:r,vertexCount:i,modules:[E.a],defines:s.defines,parameters:s.parameters,vs:W(t,"\n#if (__VERSION__ < 300)\n  #define _attr attribute\n#else\n  #define _attr in\n#endif\n\n  _attr vec4 POSITION;\n\n  #ifdef HAS_NORMALS\n    _attr vec4 NORMAL;\n  #endif\n\n  #ifdef HAS_TANGENTS\n    _attr vec4 TANGENT;\n  #endif\n\n  #ifdef HAS_UV\n    _attr vec2 TEXCOORD_0;\n  #endif\n\n  void main(void) {\n    vec4 _NORMAL = vec4(0.);\n    vec4 _TANGENT = vec4(0.);\n    vec2 _TEXCOORD_0 = vec2(0.);\n\n    #ifdef HAS_NORMALS\n      _NORMAL = NORMAL;\n    #endif\n\n    #ifdef HAS_TANGENTS\n      _TANGENT = TANGENT;\n    #endif\n\n    #ifdef HAS_UV\n      _TEXCOORD_0 = TEXCOORD_0;\n    #endif\n\n    pbr_setPositionNormalTangentUV(POSITION, _NORMAL, _TANGENT, _TEXCOORD_0);\n    gl_Position = u_MVPMatrix * POSITION;\n  }\n"),fs:W(t,"\n#if (__VERSION__ < 300)\n  #define fragmentColor gl_FragColor\n#else\n  out vec4 fragmentColor;\n#endif\n\n  void main(void) {\n    fragmentColor = pbr_filterColor(vec4(0));\n  }\n"),managedResources:u},a));return c.setProps({attributes:o}),c.setUniforms(s.uniforms),c}(this.gl,Object.assign({id:t.name||"".concat(n.name||n.id,"-primitive-").concat(e),drawMode:t.mode||4,vertexCount:t.indices?t.indices.count:this.getVertexCount(t.attributes),attributes:this.createAttributes(t.attributes,t.indices),material:t.material},this.options))}createAttributes(t,e){const n={};return Object.keys(t).forEach(e=>{n[e]=this.createAccessor(t[e],this.createBuffer(t[e],this.gl.ARRAY_BUFFER))}),e&&(n.indices=this.createAccessor(e,this.createBuffer(e,this.gl.ELEMENT_ARRAY_BUFFER))),w.k.info(4,"glTF Attributes",{attributes:t,indices:e,generated:n})(),n}createBuffer(t,e){t.bufferView||(t.bufferView={});const{bufferView:n}=t;return n.lumaBuffers||(n.lumaBuffers={}),n.lumaBuffers[e]||(n.lumaBuffers[e]=new M.a(this.gl,{id:"from-".concat(n.id),data:n.data||t.value,target:e})),n.lumaBuffers[e]}createAccessor(t,e){return new I.a({buffer:e,offset:t.byteOffset||0,stride:t.bufferView.byteStride||0,type:t.componentType,size:q[t.type]})}createSampler(t){return t}needsPOT(){return!1}}var J=n(319),Q=n(69),K=n.n(Q),Y=n(39),$=n.n(Y);function tt(){return(tt=K()($.a.mark((function t(e){var n;return $.a.wrap((function(t){for(;;)switch(t.prev=t.next){case 0:return n=[],e.scenes.forEach((function(t){t.traverse((function(t){Object.values(t.model.getUniforms()).forEach((function(t){!1===t.loaded&&n.push(t)}))}))})),t.next=4,et((function(){return n.some((function(t){return!t.loaded}))}));case 4:return t.abrupt("return",t.sent);case 5:case"end":return t.stop()}}),t)})))).apply(this,arguments)}function et(t){return nt.apply(this,arguments)}function nt(){return(nt=K()($.a.mark((function t(e){return $.a.wrap((function(t){for(;;)switch(t.prev=t.next){case 0:if(!e()){t.next=5;break}return t.next=3,new Promise((function(t){return requestAnimationFrame(t)}));case 3:t.next=0;break;case 5:case"end":return t.stop()}}),t)})))).apply(this,arguments)}var rt=n(130);function it(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function ot(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?it(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):it(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function at(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}n.d(e,"a",(function(){return ct}));var st=[255,255,255,255],ut={scenegraph:{type:"object",value:null,async:!0},getScene:function(t){return t&&t.scenes?"object"===y()(t.scene)?t.scene:t.scenes[t.scene||0]:t},getAnimator:function(t){return t&&t.animator},_animations:null,sizeScale:{type:"number",value:1,min:0},sizeMinPixels:{type:"number",min:0,value:0},sizeMaxPixels:{type:"number",min:0,value:Number.MAX_SAFE_INTEGER},getPosition:{type:"accessor",value:function(t){return t.position}},getColor:{type:"accessor",value:st},_lighting:"flat",_imageBasedLightingEnvironment:null,getOrientation:{type:"accessor",value:[0,0,0]},getScale:{type:"accessor",value:[1,1,1]},getTranslation:{type:"accessor",value:[0,0,0]},getTransformMatrix:{type:"accessor",value:[]},loaders:[J.a]},ct=function(t){l()(n,t);var e=at(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(){var t=[v.a,_.a];return"pbr"===this.props._lighting&&t.push(E.a),{vs:"#version 300 es\n\n// Instance attributes\nin vec3 instancePositions;\nin vec3 instancePositions64Low;\nin vec4 instanceColors;\nin vec3 instancePickingColors;\nin mat3 instanceModelMatrix;\nin vec3 instanceTranslation;\n\n// Uniforms\nuniform float sizeScale;\nuniform float sizeMinPixels;\nuniform float sizeMaxPixels;\nuniform mat4 sceneModelMatrix;\nuniform bool composeModelMatrix;\n\n// Attributes\nin vec4 POSITION;\n\n#ifdef HAS_UV\n  in vec2 TEXCOORD_0;\n#endif\n\n#ifdef MODULE_PBR\n  #ifdef HAS_NORMALS\n    in vec4 NORMAL;\n  #endif\n#endif\n\n// Varying\nout vec4 vColor;\n\n// MODULE_PBR contains all the varying definitions needed\n#ifndef MODULE_PBR\n  #ifdef HAS_UV\n    out vec2 vTEXCOORD_0;\n  #endif\n#endif\n\n// Main\nvoid main(void) {\n  #if defined(HAS_UV) && !defined(MODULE_PBR)\n    vTEXCOORD_0 = TEXCOORD_0;\n    geometry.uv = vTEXCOORD_0;\n  #endif\n\n  geometry.worldPosition = instancePositions;\n  geometry.pickingColor = instancePickingColors;\n\n  vec3 normal = vec3(0.0, 0.0, 1.0);\n  #ifdef MODULE_PBR\n    #ifdef HAS_NORMALS\n      normal = instanceModelMatrix * (sceneModelMatrix * vec4(NORMAL.xyz, 0.0)).xyz;\n    #endif\n  #endif\n\n  float originalSize = project_size_to_pixel(sizeScale);\n  float clampedSize = clamp(originalSize, sizeMinPixels, sizeMaxPixels);\n\n  vec3 pos = (instanceModelMatrix * (sceneModelMatrix * POSITION).xyz) * sizeScale * (clampedSize / originalSize) + instanceTranslation;\n  if(composeModelMatrix) {\n    DECKGL_FILTER_SIZE(pos, geometry);\n    // using instancePositions as world coordinates\n    // when using globe mode, this branch does not re-orient the model to align with the surface of the earth\n    // call project_normal before setting position to avoid rotation\n    geometry.normal = project_normal(normal);\n    gl_Position = project_position_to_clipspace(pos + instancePositions, instancePositions64Low, vec3(0.0), geometry.position);\n  }\n  else {\n    pos = project_size(pos);\n    DECKGL_FILTER_SIZE(pos, geometry);\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, pos, geometry.position);\n    geometry.normal = project_normal(normal);\n  }\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  #ifdef MODULE_PBR\n    // set PBR data\n    pbr_vPosition = geometry.position.xyz;\n    #ifdef HAS_NORMALS\n      pbr_vNormal = geometry.normal;\n    #endif\n\n    #ifdef HAS_UV\n      pbr_vUV = TEXCOORD_0;\n    #else\n      pbr_vUV = vec2(0., 0.);\n    #endif\n    geometry.uv = pbr_vUV;\n  #endif\n\n  vColor = instanceColors;\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n",fs:"#version 300 es\n\n// Uniforms\nuniform float opacity;\n\n// Varying\nin vec4 vColor;\n\nout vec4 fragmentColor;\n\n// MODULE_PBR contains all the varying definitions needed\n#ifndef MODULE_PBR\n  #if defined(HAS_UV) && defined(HAS_BASECOLORMAP)\n    in vec2 vTEXCOORD_0;\n    uniform sampler2D u_BaseColorSampler;\n  #endif\n#endif\n\nvoid main(void) {\n  #ifdef MODULE_PBR\n    fragmentColor = vColor * pbr_filterColor(vec4(0));\n    geometry.uv = pbr_vUV;\n  #else\n    #if defined(HAS_UV) && defined(HAS_BASECOLORMAP)\n      fragmentColor = vColor * texture2D(u_BaseColorSampler, vTEXCOORD_0);\n      geometry.uv = vTEXCOORD_0;\n    #else\n      fragmentColor = vColor;\n    #endif\n  #endif\n\n  fragmentColor.a *= opacity;\n  DECKGL_FILTER_COLOR(fragmentColor, geometry);\n}\n",modules:t}}},{key:"initializeState",value:function(){this.getAttributeManager().addInstanced({instancePositions:{size:3,type:5130,fp64:this.use64bitPositions(),accessor:"getPosition",transition:!0},instanceColors:{type:5121,size:this.props.colorFormat.length,accessor:"getColor",normalized:!0,defaultValue:st,transition:!0},instanceModelMatrix:rt.a})}},{key:"updateState",value:function(t){u()(d()(n.prototype),"updateState",this).call(this,t);var e=t.props,r=t.oldProps;e.scenegraph!==r.scenegraph?this._updateScenegraph():e._animations!==r._animations&&this._applyAnimationsProp(this.state.scenegraph,this.state.animator,e._animations)}},{key:"finalizeState",value:function(t){u()(d()(n.prototype),"finalizeState",this).call(this,t),this._deleteScenegraph()}},{key:"_updateScenegraph",value:function(){var t=this,e=this.props,n=this.context.gl,r=null;if(e.scenegraph instanceof P)r={scenes:[e.scenegraph]};else if(e.scenegraph&&!e.scenegraph.gltf){var i=e.scenegraph,o=function(t,e,n){const r=new Z(t,n);return{scenes:r.instantiate(e),animator:r.createAnimator()}}(n,i,this._getModelOptions());r=ot({gltf:i},o),function(t){return tt.apply(this,arguments)}(o).then((function(){return t.setNeedsRedraw()}))}else e.scenegraph&&(b.a.deprecated("ScenegraphLayer.props.scenegraph","Use GLTFLoader instead of GLTFScenegraphLoader")(),r=e.scenegraph);var a={layer:this,gl:n},s=e.getScene(r,a),u=e.getAnimator(r,a);s instanceof P?(this._deleteScenegraph(),this._applyAllAttributes(s),this._applyAnimationsProp(s,u,e._animations),this.setState({scenegraph:s,animator:u})):null!==s&&b.a.warn("invalid scenegraph:",s)()}},{key:"_applyAllAttributes",value:function(t){var e=this;if(this.state.attributesAvailable){var n=this.getAttributeManager().getAttributes();t.traverse((function(t){e._setModelAttributes(t.model,n)}))}}},{key:"_applyAnimationsProp",value:function(t,e,n){if(t&&e&&n){var r=e.getAnimations();Object.keys(n).sort().forEach((function(t){var e=n[t];if("*"===t)r.forEach((function(t){Object.assign(t,e)}));else if(Number.isFinite(Number(t))){var i=Number(t);i>=0&&i<r.length?Object.assign(r[i],e):b.a.warn("animation ".concat(t," not found"))()}else{var o=r.find((function(e){return e.name===t}));o?Object.assign(o,e):b.a.warn("animation ".concat(t," not found"))()}}))}}},{key:"_deleteScenegraph",value:function(){var t=this.state.scenegraph;t instanceof P&&t.delete()}},{key:"_getModelOptions",value:function(){var t=this.props._imageBasedLightingEnvironment,e=null;return t&&(e="function"==typeof t?t({gl:this.context.gl,layer:this}):t),{gl:this.context.gl,waitForFullLoad:!0,imageBasedLightingEnvironment:e,modelOptions:ot({isInstanced:!0,transpileToGLSL100:!Object(w.j)(this.context.gl)},this.getShaders()),useTangents:!1}}},{key:"updateAttributes",value:function(t){var e=this;this.setState({attributesAvailable:!0}),this.state.scenegraph&&this.state.scenegraph.traverse((function(n){e._setModelAttributes(n.model,t)}))}},{key:"draw",value:function(t){var e=t.moduleParameters,n=void 0===e?null:e,r=t.parameters,i=void 0===r?{}:r,o=t.context;if(this.state.scenegraph){this.props._animations&&this.state.animator&&(this.state.animator.animate(o.timeline.getTime()),this.setNeedsRedraw());var a=this.context.viewport,s=this.props,u=s.sizeScale,c=s.sizeMinPixels,l=s.sizeMaxPixels,h=s.opacity,f=s.coordinateSystem,p=this.getNumInstances();this.state.scenegraph.traverse((function(t,e){var r=e.worldMatrix;t.model.setInstanceCount(p),t.updateModuleSettings(n),t.draw({parameters:i,uniforms:{sizeScale:u,opacity:h,sizeMinPixels:c,sizeMaxPixels:l,composeModelMatrix:Object(rt.b)(a,f),sceneModelMatrix:r,u_Camera:t.model.getUniforms().project_uCameraPosition}})}))}}}]),n}(x.a);g()(ct,"defaultProps",ut),g()(ct,"layerName","ScenegraphLayer")},function(t,e,n){"use strict";var r=n(183),i=n.n(r),o=n(3),a=n.n(o),s=n(4),u=n.n(s),c=n(8),l=n.n(c),h=n(5),f=n.n(h),p=n(6),d=n.n(p),A=n(1),g=n.n(A),m=n(0),y=n.n(m),v=n(198),_=n(182);function b(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function x(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?b(Object(n),!0).forEach((function(e){y()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):b(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function w(t,e){if(!t)return null;var n="startIndices"in t?t.startIndices[e]:e,r=t.featureIds.value[n];return-1!==n?function(t,e,n){var r={properties:x({},t.properties[e])};for(var i in t.numericProps)r.properties[i]=t.numericProps[i].value[n];return r}(t,r,n):null}var E=n(118),O=n(168),S=n(166),T=n(117),C=n(116),P={circle:{type:O.a,props:{filled:"filled",stroked:"stroked",lineWidthMaxPixels:"lineWidthMaxPixels",lineWidthMinPixels:"lineWidthMinPixels",lineWidthScale:"lineWidthScale",lineWidthUnits:"lineWidthUnits",pointRadiusMaxPixels:"radiusMaxPixels",pointRadiusMinPixels:"radiusMinPixels",pointRadiusScale:"radiusScale",pointRadiusUnits:"radiusUnits",pointAntialiasing:"antialiasing",pointBillboard:"billboard",getFillColor:"getFillColor",getLineColor:"getLineColor",getLineWidth:"getLineWidth",getPointRadius:"getRadius"}},icon:{type:E.a,props:{iconAtlas:"iconAtlas",iconMapping:"iconMapping",iconSizeMaxPixels:"sizeMaxPixels",iconSizeMinPixels:"sizeMinPixels",iconSizeScale:"sizeScale",iconSizeUnits:"sizeUnits",iconAlphaCutoff:"alphaCutoff",iconBillboard:"billboard",getIcon:"getIcon",getIconAngle:"getAngle",getIconColor:"getColor",getIconPixelOffset:"getPixelOffset",getIconSize:"getSize"}},text:{type:S.a,props:{textSizeMaxPixels:"sizeMaxPixels",textSizeMinPixels:"sizeMinPixels",textSizeScale:"sizeScale",textSizeUnits:"sizeUnits",textBackground:"background",textBackgroundPadding:"backgroundPadding",textFontFamily:"fontFamily",textFontWeight:"fontWeight",textLineHeight:"lineHeight",textMaxWidth:"maxWidth",textOutlineColor:"outlineColor",textOutlineWidth:"outlineWidth",textWordBreak:"wordBreak",textCharacterSet:"characterSet",textBillboard:"billboard",textFontSettings:"fontSettings",getText:"getText",getTextAngle:"getAngle",getTextColor:"getColor",getTextPixelOffset:"getPixelOffset",getTextSize:"getSize",getTextAnchor:"getTextAnchor",getTextAlignmentBaseline:"getAlignmentBaseline",getTextBackgroundColor:"getBackgroundColor",getTextBorderColor:"getBorderColor",getTextBorderWidth:"getBorderWidth"}}},M={type:T.a,props:{lineWidthUnits:"widthUnits",lineWidthScale:"widthScale",lineWidthMinPixels:"widthMinPixels",lineWidthMaxPixels:"widthMaxPixels",lineJointRounded:"jointRounded",lineCapRounded:"capRounded",lineMiterLimit:"miterLimit",lineBillboard:"billboard",getLineColor:"getColor",getLineWidth:"getWidth"}},I={type:C.a,props:{extruded:"extruded",filled:"filled",wireframe:"wireframe",elevationScale:"elevationScale",material:"material",_full3d:"_full3d",getElevation:"getElevation",getFillColor:"getFillColor",getLineColor:"getLineColor"}};function B(t){var e=t.type,n=t.props,r={};for(var i in n)r[i]=e.defaultProps[n[i]];return r}function R(t,e){var n=t.props,r=n.transitions,i=n.updateTriggers,o={updateTriggers:{},transitions:r&&{getPosition:r.geometry}};for(var a in e){var s=e[a],u=t.props[a];a.startsWith("get")&&(u=t.getSubLayerAccessor(u),o.updateTriggers[s]=i[a],r&&(o.transitions[s]=r[a])),o[s]=u}return o}var k=n(21);function D(t,e){for(var n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{},r={pointFeatures:[],lineFeatures:[],polygonFeatures:[],polygonOutlineFeatures:[]},i=n.startRow,o=void 0===i?0:i,a=n.endRow,s=void 0===a?t.length:a,u=o;u<s;u++){var c=t[u],l=c.geometry;if(l)if("GeometryCollection"===l.type){k.a.assert(Array.isArray(l.geometries),"GeoJSON does not have geometries array");for(var h=l.geometries,f=0;f<h.length;f++){var p=h[f];L(p,r,e,c,u)}}else L(l,r,e,c,u)}return r}function L(t,e,n,r,i){var o=t.type,a=t.coordinates,s=e.pointFeatures,u=e.lineFeatures,c=e.polygonFeatures,l=e.polygonOutlineFeatures;if(function(t,e){var n=j[t];k.a.assert(n,"Unknown GeoJSON type ".concat(t));for(;e&&--n>0;)e=e[0];return e&&Number.isFinite(e[0])}(o,a))switch(o){case"Point":s.push(n({geometry:t},r,i));break;case"MultiPoint":a.forEach((function(t){s.push(n({geometry:{type:"Point",coordinates:t}},r,i))}));break;case"LineString":u.push(n({geometry:t},r,i));break;case"MultiLineString":a.forEach((function(t){u.push(n({geometry:{type:"LineString",coordinates:t}},r,i))}));break;case"Polygon":c.push(n({geometry:t},r,i)),a.forEach((function(t){l.push(n({geometry:{type:"LineString",coordinates:t}},r,i))}));break;case"MultiPolygon":a.forEach((function(t){c.push(n({geometry:{type:"Polygon",coordinates:t}},r,i)),t.forEach((function(t){l.push(n({geometry:{type:"LineString",coordinates:t}},r,i))}))}))}else k.a.warn("".concat(o," coordinates are malformed"))()}var j={Point:1,MultiPoint:2,LineString:2,MultiLineString:3,Polygon:3,MultiPolygon:4};function F(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function z(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?F(Object(n),!0).forEach((function(e){y()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):F(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function U(t){return t.geometry.coordinates}function N(t,e){var n={points:{},lines:{},polygons:{},polygonsOutline:{}},r=t.points,i=t.lines,o=t.polygons,a=function(t,e){var n={points:null,lines:null,polygons:null};for(var r in n){var i=t[r].globalFeatureIds.value;n[r]=new Uint8ClampedArray(3*i.length);for(var o=[],a=0;a<i.length;a++)e(i[a],o),n[r][3*a+0]=o[0],n[r][3*a+1]=o[1],n[r][3*a+2]=o[2]}return n}(t,e);return n.points.data={length:r.positions.value.length/r.positions.size,attributes:z(z({},r.attributes),{},{getPosition:r.positions,instancePickingColors:{size:3,value:a.points}}),properties:r.properties,numericProps:r.numericProps,featureIds:r.featureIds},n.lines.data={length:i.pathIndices.value.length-1,startIndices:i.pathIndices.value,attributes:z(z({},i.attributes),{},{getPath:i.positions,instancePickingColors:{size:3,value:a.lines}}),properties:i.properties,numericProps:i.numericProps,featureIds:i.featureIds},n.lines._pathType="open",n.polygons.data={length:o.polygonIndices.value.length-1,startIndices:o.polygonIndices.value,attributes:z(z({},o.attributes),{},{getPolygon:o.positions,pickingColors:{size:3,value:a.polygons}}),properties:o.properties,numericProps:o.numericProps,featureIds:o.featureIds},n.polygons._normalize=!1,o.triangles&&(n.polygons.data.attributes.indices=o.triangles.value),n.polygonsOutline.data={length:o.primitivePolygonIndices.value.length-1,startIndices:o.primitivePolygonIndices.value,attributes:z(z({},o.attributes),{},{getPath:o.positions,instancePickingColors:{size:3,value:a.polygons}}),properties:o.properties,numericProps:o.numericProps,featureIds:o.featureIds},n.polygonsOutline._pathType="open",n}n.d(e,"a",(function(){return Q}));var G=["instancePickingColors"];function V(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return H(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return H(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function H(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function W(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=g()(t);if(e){var i=g()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return d()(this,n)}}function q(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function X(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?q(Object(n),!0).forEach((function(e){y()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):q(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var Z=["points","linestrings","polygons"],J=X(X(X(X(X(X({},B(P.circle)),B(P.icon)),B(P.text)),B(M)),B(I)),{},{stroked:!0,filled:!0,extruded:!1,wireframe:!1,_full3d:!1,iconAtlas:{type:"object",value:null},iconMapping:{type:"object",value:{}},getIcon:{type:"accessor",value:function(t){return t.properties.icon}},getText:{type:"accessor",value:function(t){return t.properties.text}},pointType:"circle",getRadius:{deprecatedFor:"getPointRadius"}}),Q=function(t){f()(n,t);var e=W(n);function n(){return a()(this,n),e.apply(this,arguments)}return u()(n,[{key:"initializeState",value:function(){this.state={layerProps:{},features:{}}}},{key:"updateState",value:function(t){var e=t.props,n=t.changeFlags;if(n.dataChanged){var r=this.props.data,i=r&&"points"in r&&"polygons"in r&&"lines"in r;this.setState({binary:i}),i?this._updateStateBinary({props:e,changeFlags:n}):this._updateStateJSON({props:e,changeFlags:n})}}},{key:"_updateStateBinary",value:function(t){var e=t.props,n=(t.changeFlags,N(e.data,this.encodePickingColor));this.setState({layerProps:n})}},{key:"_updateStateJSON",value:function(t){var e=t.props,n=t.changeFlags,r=function(t){if(Array.isArray(t))return t;switch(k.a.assert(t.type,"GeoJSON does not have type"),t.type){case"Feature":return[t];case"FeatureCollection":return k.a.assert(Array.isArray(t.features),"GeoJSON does not have features array"),t.features;default:return[{geometry:t}]}}(e.data),i=this.getSubLayerRow.bind(this),o={},a={};if(Array.isArray(n.dataChanged)){var s=this.state.features;for(var u in s)o[u]=s[u].slice(),a[u]=[];var c,l=V(n.dataChanged);try{for(l.s();!(c=l.n()).done;){var h=c.value,f=D(r,i,h);for(var p in s)a[p].push(Object(_.a)({data:o[p],getIndex:function(t){return t.__source.index},dataRange:h,replace:f[p]}))}}catch(t){l.e(t)}finally{l.f()}}else o=D(r,i);var d=function(t,e){var n={points:{},lines:{},polygons:{},polygonsOutline:{}},r=t.pointFeatures,i=t.lineFeatures,o=t.polygonFeatures,a=t.polygonOutlineFeatures;return n.points.data=r,n.points._dataDiff=e.pointFeatures&&function(){return e.pointFeatures},n.points.getPosition=U,n.lines.data=i,n.lines._dataDiff=e.lineFeatures&&function(){return e.lineFeatures},n.lines.getPath=U,n.polygons.data=o,n.polygons._dataDiff=e.polygonFeatures&&function(){return e.polygonFeatures},n.polygons.getPolygon=U,n.polygonsOutline.data=a,n.polygonsOutline._dataDiff=e.polygonOutlineFeatures&&function(){return e.polygonOutlineFeatures},n.polygonsOutline.getPath=U,n}(o,a);this.setState({features:o,featuresDiff:a,layerProps:d})}},{key:"getPickingInfo",value:function(t){var e=this,r=l()(g()(n.prototype),"getPickingInfo",this).call(this,t),i=r.index,o=r.sourceLayer;return r.featureType=Z.find((function(t){return o.id.startsWith("".concat(e.id,"-").concat(t,"-"))})),i>=0&&o.id.startsWith("".concat(this.id,"-points-text"))&&this.state.binary&&(r.index=this.props.data.points.globalFeatureIds.value[i]),r}},{key:"_updateAutoHighlight",value:function(t){var e,n="".concat(this.id,"-points-"),r="points"===t.featureType,i=V(this.getSubLayers());try{for(i.s();!(e=i.n()).done;){var o=e.value;o.id.startsWith(n)===r&&o.updateAutoHighlight(t)}}catch(t){i.e(t)}finally{i.f()}}},{key:"_renderPolygonLayer",value:function(){var t=this.props,e=t.extruded,n=t.wireframe,r=this.state.layerProps,i="polygons-fill",o=this.shouldRenderSubLayer(i,r.polygons.data)&&this.getSubLayerClass(i,I.type);if(o){var a=R(this,I.props),s=e&&n;return s||delete a.getLineColor,a.updateTriggers.lineColors=s,new o(a,this.getSubLayerProps({id:i,updateTriggers:a.updateTriggers}),r.polygons)}return null}},{key:"_renderLineLayers",value:function(){var t=this.props,e=t.extruded,n=t.stroked,r=this.state.layerProps,i=!e&&n&&this.shouldRenderSubLayer("polygons-stroke",r.polygonsOutline.data)&&this.getSubLayerClass("polygons-stroke",M.type),o=this.shouldRenderSubLayer("linestrings",r.lines.data)&&this.getSubLayerClass("linestrings",M.type);if(i||o){var a=R(this,M.props);return[i&&new i(a,this.getSubLayerProps({id:"polygons-stroke",updateTriggers:a.updateTriggers}),r.polygonsOutline),o&&new o(a,this.getSubLayerProps({id:"linestrings",updateTriggers:a.updateTriggers}),r.lines)]}return null}},{key:"_renderPointLayers",value:function(){var t=this.props.pointType,e=this.state,n=e.layerProps,r=e.binary,o=this.props.highlightedObjectIndex;!r&&Number.isFinite(o)&&(o=n.points.data.findIndex((function(t){return t.__source.index===o})));var a,s=[],u=V(new Set(t.split("+")));try{for(u.s();!(a=u.n()).done;){var c=a.value,l="points-".concat(c),h=P[c],f=h&&this.shouldRenderSubLayer(l,n.points.data)&&this.getSubLayerClass(l,h.type);if(f){var p=R(this,h.props),d=n.points;if("text"===c&&r){var A=d.data.attributes,g=(A.instancePickingColors,i()(A,G));d=X(X({},d),{},{data:X(X({},d.data),{},{attributes:g})})}s.push(new f(p,this.getSubLayerProps({id:l,updateTriggers:p.updateTriggers,highlightedObjectIndex:o}),d))}}}catch(t){u.e(t)}finally{u.f()}return s}},{key:"renderLayers",value:function(){var t=this.props.extruded,e=this._renderPolygonLayer();return[!t&&e,this._renderLineLayers(),this._renderPointLayers(),t&&e]}},{key:"getSubLayerAccessor",value:function(t){return this.state.binary&&"function"==typeof t?function(e,n){var r=w(n.data,n.index);return t(r,n)}:l()(g()(n.prototype),"getSubLayerAccessor",this).call(this,t)}}]),n}(v.a);y()(Q,"layerName","GeoJsonLayer"),y()(Q,"defaultProps",J)},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(8),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(217),y=n(234),v=n(12),_=n(164),b=n(186),x=n(60);function w(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function E(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?w(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):w(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function O(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}n.d(e,"a",(function(){return C}));var S=[0,0,0,255],T={getSourcePosition:{type:"accessor",value:function(t){return t.sourcePosition}},getTargetPosition:{type:"accessor",value:function(t){return t.targetPosition}},getSourceColor:{type:"accessor",value:S},getTargetColor:{type:"accessor",value:S},getWidth:{type:"accessor",value:1},getHeight:{type:"accessor",value:1},getTilt:{type:"accessor",value:0},greatCircle:!1,widthUnits:"pixels",widthScale:{type:"number",value:1,min:0},widthMinPixels:{type:"number",value:0,min:0},widthMaxPixels:{type:"number",value:Number.MAX_SAFE_INTEGER,min:0}},C=function(t){l()(n,t);var e=O(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(){return u()(d()(n.prototype),"getShaders",this).call(this,{vs:"#define SHADER_NAME arc-layer-vertex-shader\n\nattribute vec3 positions;\nattribute vec4 instanceSourceColors;\nattribute vec4 instanceTargetColors;\nattribute vec3 instanceSourcePositions;\nattribute vec3 instanceSourcePositions64Low;\nattribute vec3 instanceTargetPositions;\nattribute vec3 instanceTargetPositions64Low;\nattribute vec3 instancePickingColors;\nattribute float instanceWidths;\nattribute float instanceHeights;\nattribute float instanceTilts;\n\nuniform bool greatCircle;\nuniform bool useShortestPath;\nuniform float numSegments;\nuniform float opacity;\nuniform float widthScale;\nuniform float widthMinPixels;\nuniform float widthMaxPixels;\nuniform int widthUnits;\n\nvarying vec4 vColor;\nvarying vec2 uv;\nvarying float isValid;\n\nfloat paraboloid(float distance, float sourceZ, float targetZ, float ratio) {\n  // d: distance on the xy plane\n  // r: ratio of the current point\n  // p: ratio of the peak of the arc\n  // h: height multiplier\n  // z = f(r) = sqrt(r * (p * 2 - r)) * d * h\n  // f(0) = 0\n  // f(1) = dz\n\n  float deltaZ = targetZ - sourceZ;\n  float dh = distance * instanceHeights;\n  if (dh == 0.0) {\n    return sourceZ + deltaZ * ratio;\n  }\n  float unitZ = deltaZ / dh;\n  float p2 = unitZ * unitZ + 1.0;\n\n  // sqrt does not deal with negative values, manually flip source and target if delta.z < 0\n  float dir = step(deltaZ, 0.0);\n  float z0 = mix(sourceZ, targetZ, dir);\n  float r = mix(ratio, 1.0 - ratio, dir);\n  return sqrt(r * (p2 - r)) * dh + z0;\n}\n\n// offset vector by strokeWidth pixels\n// offset_direction is -1 (left) or 1 (right)\nvec2 getExtrusionOffset(vec2 line_clipspace, float offset_direction, float width) {\n  // normalized direction of the line\n  vec2 dir_screenspace = normalize(line_clipspace * project_uViewportSize);\n  // rotate by 90 degrees\n  dir_screenspace = vec2(-dir_screenspace.y, dir_screenspace.x);\n\n  return dir_screenspace * offset_direction * width / 2.0;\n}\n\nfloat getSegmentRatio(float index) {\n  return smoothstep(0.0, 1.0, index / (numSegments - 1.0));\n}\n\nvec3 interpolateFlat(vec3 source, vec3 target, float segmentRatio) {\n  float distance = length(source.xy - target.xy);\n  float z = paraboloid(distance, source.z, target.z, segmentRatio);\n\n  float tiltAngle = radians(instanceTilts);\n  vec2 tiltDirection = normalize(target.xy - source.xy);\n  vec2 tilt = vec2(-tiltDirection.y, tiltDirection.x) * z * sin(tiltAngle);\n\n  return vec3(\n    mix(source.xy, target.xy, segmentRatio) + tilt,\n    z * cos(tiltAngle)\n  );\n}\n\n/* Great circle interpolation\n * http://www.movable-type.co.uk/scripts/latlong.html\n */\nfloat getAngularDist (vec2 source, vec2 target) {\n  vec2 sourceRadians = radians(source);\n  vec2 targetRadians = radians(target);\n  vec2 sin_half_delta = sin((sourceRadians - targetRadians) / 2.0);\n  vec2 shd_sq = sin_half_delta * sin_half_delta;\n\n  float a = shd_sq.y + cos(sourceRadians.y) * cos(targetRadians.y) * shd_sq.x;\n  return 2.0 * asin(sqrt(a));\n}\n\nvec3 interpolateGreatCircle(vec3 source, vec3 target, vec3 source3D, vec3 target3D, float angularDist, float t) {\n  vec2 lngLat;\n\n  // if the angularDist is PI, linear interpolation is applied. otherwise, use spherical interpolation\n  if(abs(angularDist - PI) < 0.001) {\n    lngLat = (1.0 - t) * source.xy + t * target.xy;\n  } else {\n    float a = sin((1.0 - t) * angularDist);\n    float b = sin(t * angularDist);\n    vec3 p = source3D.yxz * a + target3D.yxz * b;\n    lngLat = degrees(vec2(atan(p.y, -p.x), atan(p.z, length(p.xy))));\n  }\n\n  float z = paraboloid(angularDist * EARTH_RADIUS, source.z, target.z, t);\n\n  return vec3(lngLat, z);\n}\n\n/* END GREAT CIRCLE */\n\nvoid main(void) {\n  geometry.worldPosition = instanceSourcePositions;\n  geometry.worldPositionAlt = instanceTargetPositions;\n\n  float segmentIndex = positions.x;\n  float segmentRatio = getSegmentRatio(segmentIndex);\n  float prevSegmentRatio = getSegmentRatio(max(0.0, segmentIndex - 1.0));\n  float nextSegmentRatio = getSegmentRatio(min(numSegments - 1.0, segmentIndex + 1.0));\n\n  // if it's the first point, use next - current as direction\n  // otherwise use current - prev\n  float indexDir = mix(-1.0, 1.0, step(segmentIndex, 0.0));\n  isValid = 1.0;\n\n  uv = vec2(segmentRatio, positions.y);\n  geometry.uv = uv;\n  geometry.pickingColor = instancePickingColors;\n\n  vec4 curr;\n  vec4 next;\n  vec3 source;\n  vec3 target;\n\n  if ((greatCircle || project_uProjectionMode == PROJECTION_MODE_GLOBE) && project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT) {\n    source = project_globe_(vec3(instanceSourcePositions.xy, 0.0));\n    target = project_globe_(vec3(instanceTargetPositions.xy, 0.0));\n    float angularDist = getAngularDist(instanceSourcePositions.xy, instanceTargetPositions.xy);\n\n    vec3 prevPos = interpolateGreatCircle(instanceSourcePositions, instanceTargetPositions, source, target, angularDist, prevSegmentRatio);\n    vec3 currPos = interpolateGreatCircle(instanceSourcePositions, instanceTargetPositions, source, target, angularDist, segmentRatio);\n    vec3 nextPos = interpolateGreatCircle(instanceSourcePositions, instanceTargetPositions, source, target, angularDist, nextSegmentRatio);\n\n    if (abs(currPos.x - prevPos.x) > 180.0) {\n      indexDir = -1.0;\n      isValid = 0.0;\n    } else if (abs(currPos.x - nextPos.x) > 180.0) {\n      indexDir = 1.0;\n      isValid = 0.0;\n    }\n    nextPos = indexDir < 0.0 ? prevPos : nextPos;\n    nextSegmentRatio = indexDir < 0.0 ? prevSegmentRatio : nextSegmentRatio;\n\n    if (isValid == 0.0) {\n      // split at the 180th meridian\n      nextPos.x += nextPos.x > 0.0 ? -360.0 : 360.0;\n      float t = ((currPos.x > 0.0 ? 180.0 : -180.0) - currPos.x) / (nextPos.x - currPos.x);\n      currPos = mix(currPos, nextPos, t);\n      segmentRatio = mix(segmentRatio, nextSegmentRatio, t);\n    }\n\n    vec3 currPos64Low = mix(instanceSourcePositions64Low, instanceTargetPositions64Low, segmentRatio);\n    vec3 nextPos64Low = mix(instanceSourcePositions64Low, instanceTargetPositions64Low, nextSegmentRatio);\n  \n    curr = project_position_to_clipspace(currPos, currPos64Low, vec3(0.0), geometry.position);\n    next = project_position_to_clipspace(nextPos, nextPos64Low, vec3(0.0));\n  \n  } else {\n    vec3 source_world = instanceSourcePositions;\n    vec3 target_world = instanceTargetPositions;\n    if (useShortestPath) {\n      source_world.x = mod(source_world.x + 180., 360.0) - 180.;\n      target_world.x = mod(target_world.x + 180., 360.0) - 180.;\n\n      float deltaLng = target_world.x - source_world.x;\n      if (deltaLng > 180.) target_world.x -= 360.;\n      if (deltaLng < -180.) source_world.x -= 360.;\n    }\n    source = project_position(source_world, instanceSourcePositions64Low);\n    target = project_position(target_world, instanceTargetPositions64Low);\n\n    // common x at longitude=-180\n    float antiMeridianX = 0.0;\n\n    if (useShortestPath) {\n      if (project_uProjectionMode == PROJECTION_MODE_WEB_MERCATOR_AUTO_OFFSET) {\n        antiMeridianX = -(project_uCoordinateOrigin.x + 180.) / 360. * TILE_SIZE;\n      }\n      float thresholdRatio = (antiMeridianX - source.x) / (target.x - source.x);\n\n      if (prevSegmentRatio <= thresholdRatio && nextSegmentRatio > thresholdRatio) {\n        isValid = 0.0;\n        indexDir = sign(segmentRatio - thresholdRatio);\n        segmentRatio = thresholdRatio;\n      }\n    }\n\n    nextSegmentRatio = indexDir < 0.0 ? prevSegmentRatio : nextSegmentRatio;\n    vec3 currPos = interpolateFlat(source, target, segmentRatio);\n    vec3 nextPos = interpolateFlat(source, target, nextSegmentRatio);\n\n    if (useShortestPath) {\n      if (nextPos.x < antiMeridianX) {\n        currPos.x += TILE_SIZE;\n        nextPos.x += TILE_SIZE;\n      }\n    }\n\n    curr = project_common_position_to_clipspace(vec4(currPos, 1.0));\n    next = project_common_position_to_clipspace(vec4(nextPos, 1.0));\n    geometry.position = vec4(currPos, 1.0);\n  }\n\n  // Multiply out width and clamp to limits\n  // mercator pixels are interpreted as screen pixels\n  float widthPixels = clamp(\n    project_size_to_pixel(instanceWidths * widthScale, widthUnits),\n    widthMinPixels, widthMaxPixels\n  );\n\n  // extrude\n  vec3 offset = vec3(\n    getExtrusionOffset((next.xy - curr.xy) * indexDir, positions.y, widthPixels),\n    0.0);\n  DECKGL_FILTER_SIZE(offset, geometry);\n  gl_Position = curr + vec4(project_pixel_size_to_clipspace(offset.xy), 0.0, 0.0);\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  vec4 color = mix(instanceSourceColors, instanceTargetColors, segmentRatio);\n  vColor = vec4(color.rgb, color.a * opacity);\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n",fs:"#define SHADER_NAME arc-layer-fragment-shader\n\nprecision highp float;\n\nvarying vec4 vColor;\nvarying vec2 uv;\nvarying float isValid;\n\nvoid main(void) {\n  if (isValid == 0.0) {\n    discard;\n  }\n\n  gl_FragColor = vColor;\n  geometry.uv = uv;\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n",modules:[m.a,y.a]})}},{key:"wrapLongitude",get:function(){return!1}},{key:"initializeState",value:function(){this.getAttributeManager().addInstanced({instanceSourcePositions:{size:3,type:5130,fp64:this.use64bitPositions(),transition:!0,accessor:"getSourcePosition"},instanceTargetPositions:{size:3,type:5130,fp64:this.use64bitPositions(),transition:!0,accessor:"getTargetPosition"},instanceSourceColors:{size:this.props.colorFormat.length,type:5121,normalized:!0,transition:!0,accessor:"getSourceColor",defaultValue:S},instanceTargetColors:{size:this.props.colorFormat.length,type:5121,normalized:!0,transition:!0,accessor:"getTargetColor",defaultValue:S},instanceWidths:{size:1,transition:!0,accessor:"getWidth",defaultValue:1},instanceHeights:{size:1,transition:!0,accessor:"getHeight",defaultValue:1},instanceTilts:{size:1,transition:!0,accessor:"getTilt",defaultValue:0}})}},{key:"updateState",value:function(t){if(u()(d()(n.prototype),"updateState",this).call(this,t),t.changeFlags.extensionsChanged){var e,r=this.context.gl;null===(e=this.state.model)||void 0===e||e.delete(),this.state.model=this._getModel(r),this.getAttributeManager().invalidateAll()}}},{key:"draw",value:function(t){var e=t.uniforms,n=this.props,r=n.widthUnits,i=n.widthScale,o=n.widthMinPixels,a=n.widthMaxPixels,s=n.greatCircle,u=n.wrapLongitude;this.state.model.setUniforms(e).setUniforms({greatCircle:s,widthUnits:v.e[r],widthScale:i,widthMinPixels:o,widthMaxPixels:a,useShortestPath:u}).draw()}},{key:"_getModel",value:function(t){for(var e=[],n=0;n<50;n++)e=e.concat([n,1,0,n,-1,0]);var r=new b.a(t,E(E({},this.getShaders()),{},{id:this.props.id,geometry:new x.a({drawMode:5,attributes:{positions:new Float32Array(e)}}),isInstanced:!0}));return r.setUniforms({numSegments:50}),r}}]),n}(_.a);g()(C,"layerName","ArcLayer"),g()(C,"defaultProps",T)},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(8),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(217),y=n(234),v=n(12),_=n(164),b=n(186),x=n(60);function w(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function E(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?w(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):w(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function O(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}n.d(e,"a",(function(){return T}));var S={getSourcePosition:{type:"accessor",value:function(t){return t.sourcePosition}},getTargetPosition:{type:"accessor",value:function(t){return t.targetPosition}},getColor:{type:"accessor",value:[0,0,0,255]},getWidth:{type:"accessor",value:1},widthUnits:"pixels",widthScale:{type:"number",value:1,min:0},widthMinPixels:{type:"number",value:0,min:0},widthMaxPixels:{type:"number",value:Number.MAX_SAFE_INTEGER,min:0}},T=function(t){l()(n,t);var e=O(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(){return u()(d()(n.prototype),"getShaders",this).call(this,{vs:"#define SHADER_NAME line-layer-vertex-shader\n\nattribute vec3 positions;\nattribute vec3 instanceSourcePositions;\nattribute vec3 instanceTargetPositions;\nattribute vec3 instanceSourcePositions64Low;\nattribute vec3 instanceTargetPositions64Low;\nattribute vec4 instanceColors;\nattribute vec3 instancePickingColors;\nattribute float instanceWidths;\n\nuniform float opacity;\nuniform float widthScale;\nuniform float widthMinPixels;\nuniform float widthMaxPixels;\nuniform float useShortestPath;\nuniform int widthUnits;\n\nvarying vec4 vColor;\nvarying vec2 uv;\n\n// offset vector by strokeWidth pixels\n// offset_direction is -1 (left) or 1 (right)\nvec2 getExtrusionOffset(vec2 line_clipspace, float offset_direction, float width) {\n  // normalized direction of the line\n  vec2 dir_screenspace = normalize(line_clipspace * project_uViewportSize);\n  // rotate by 90 degrees\n  dir_screenspace = vec2(-dir_screenspace.y, dir_screenspace.x);\n\n  return dir_screenspace * offset_direction * width / 2.0;\n}\n\nvec3 splitLine(vec3 a, vec3 b, float x) {\n  float t = (x - a.x) / (b.x - a.x);\n  return vec3(x, mix(a.yz, b.yz, t));\n}\n\nvoid main(void) {\n  geometry.worldPosition = instanceSourcePositions;\n  geometry.worldPositionAlt = instanceTargetPositions;\n\n  vec3 source_world = instanceSourcePositions;\n  vec3 target_world = instanceTargetPositions;\n  vec3 source_world_64low = instanceSourcePositions64Low;\n  vec3 target_world_64low = instanceTargetPositions64Low;\n\n  if (useShortestPath > 0.5 || useShortestPath < -0.5) {\n    source_world.x = mod(source_world.x + 180., 360.0) - 180.;\n    target_world.x = mod(target_world.x + 180., 360.0) - 180.;\n    float deltaLng = target_world.x - source_world.x;\n\n    if (deltaLng * useShortestPath > 180.) {\n      source_world.x += 360. * useShortestPath;\n      source_world = splitLine(source_world, target_world, 180. * useShortestPath);\n      source_world_64low = vec3(0.0);\n    } else if (deltaLng * useShortestPath < -180.) {\n      target_world.x += 360. * useShortestPath;\n      target_world = splitLine(source_world, target_world, 180. * useShortestPath);\n      target_world_64low = vec3(0.0);\n    } else if (useShortestPath < 0.) {\n      // Line is not split, abort\n      gl_Position = vec4(0.);\n      return;\n    }\n  }\n\n  // Position\n  vec4 source_commonspace;\n  vec4 target_commonspace;\n  vec4 source = project_position_to_clipspace(source_world, source_world_64low, vec3(0.), source_commonspace);\n  vec4 target = project_position_to_clipspace(target_world, target_world_64low, vec3(0.), target_commonspace);\n  \n  // linear interpolation of source & target to pick right coord\n  float segmentIndex = positions.x;\n  vec4 p = mix(source, target, segmentIndex);\n  geometry.position = mix(source_commonspace, target_commonspace, segmentIndex);\n  uv = positions.xy;\n  geometry.uv = uv;\n  geometry.pickingColor = instancePickingColors;\n\n  // Multiply out width and clamp to limits\n  float widthPixels = clamp(\n    project_size_to_pixel(instanceWidths * widthScale, widthUnits),\n    widthMinPixels, widthMaxPixels\n  );\n\n  // extrude\n  vec3 offset = vec3(\n    getExtrusionOffset(target.xy - source.xy, positions.y, widthPixels),\n    0.0);\n  DECKGL_FILTER_SIZE(offset, geometry);\n  gl_Position = p + vec4(project_pixel_size_to_clipspace(offset.xy), 0.0, 0.0);\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  // Color\n  vColor = vec4(instanceColors.rgb, instanceColors.a * opacity);\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n",fs:"#define SHADER_NAME line-layer-fragment-shader\n\nprecision highp float;\n\nvarying vec4 vColor;\nvarying vec2 uv;\n\nvoid main(void) {\n  geometry.uv = uv;\n\n  gl_FragColor = vColor;\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n",modules:[m.a,y.a]})}},{key:"wrapLongitude",get:function(){return!1}},{key:"initializeState",value:function(){this.getAttributeManager().addInstanced({instanceSourcePositions:{size:3,type:5130,fp64:this.use64bitPositions(),transition:!0,accessor:"getSourcePosition"},instanceTargetPositions:{size:3,type:5130,fp64:this.use64bitPositions(),transition:!0,accessor:"getTargetPosition"},instanceColors:{size:this.props.colorFormat.length,type:5121,normalized:!0,transition:!0,accessor:"getColor",defaultValue:[0,0,0,255]},instanceWidths:{size:1,transition:!0,accessor:"getWidth",defaultValue:1}})}},{key:"updateState",value:function(t){if(u()(d()(n.prototype),"updateState",this).call(this,t),t.changeFlags.extensionsChanged){var e,r=this.context.gl;null===(e=this.state.model)||void 0===e||e.delete(),this.state.model=this._getModel(r),this.getAttributeManager().invalidateAll()}}},{key:"draw",value:function(t){var e=t.uniforms,n=this.props,r=n.widthUnits,i=n.widthScale,o=n.widthMinPixels,a=n.widthMaxPixels,s=n.wrapLongitude;this.state.model.setUniforms(e).setUniforms({widthUnits:v.e[r],widthScale:i,widthMinPixels:o,widthMaxPixels:a,useShortestPath:s?1:0}).draw(),s&&this.state.model.setUniforms({useShortestPath:-1}).draw()}},{key:"_getModel",value:function(t){return new b.a(t,E(E({},this.getShaders()),{},{id:this.props.id,geometry:new x.a({drawMode:5,attributes:{positions:new Float32Array([0,-1,0,0,1,0,1,-1,0,1,1,0])}}),isInstanced:!0}))}}]),n}(_.a);g()(T,"layerName","LineLayer"),g()(T,"defaultProps",S)},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(8),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(217),y=n(235),v=n(234),_=n(12),b=n(164),x=n(186),w=n(60);function E(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function O(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?E(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):E(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function S(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}n.d(e,"a",(function(){return M}));var T=[0,0,0,255],C=[0,0,1],P={sizeUnits:"pixels",pointSize:{type:"number",min:0,value:10},getPosition:{type:"accessor",value:function(t){return t.position}},getNormal:{type:"accessor",value:C},getColor:{type:"accessor",value:T},material:!0,radiusPixels:{deprecatedFor:"pointSize"}};var M=function(t){l()(n,t);var e=S(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(){return u()(d()(n.prototype),"getShaders",this).call(this,{vs:"#define SHADER_NAME point-cloud-layer-vertex-shader\n\nattribute vec3 positions;\nattribute vec3 instanceNormals;\nattribute vec4 instanceColors;\nattribute vec3 instancePositions;\nattribute vec3 instancePositions64Low;\nattribute vec3 instancePickingColors;\n\nuniform float opacity;\nuniform float radiusPixels;\nuniform int sizeUnits;\n\nvarying vec4 vColor;\nvarying vec2 unitPosition;\n\nvoid main(void) {\n  geometry.worldPosition = instancePositions;\n  geometry.normal = project_normal(instanceNormals);\n\n  // position on the containing square in [-1, 1] space\n  unitPosition = positions.xy;\n  geometry.uv = unitPosition;\n  geometry.pickingColor = instancePickingColors;\n\n  // Find the center of the point and add the current vertex\n  vec3 offset = vec3(positions.xy * project_size_to_pixel(radiusPixels, sizeUnits), 0.0);\n  DECKGL_FILTER_SIZE(offset, geometry);\n\n  gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, vec3(0.), geometry.position);\n  gl_Position.xy += project_pixel_size_to_clipspace(offset.xy);\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  // Apply lighting\n  vec3 lightColor = lighting_getLightColor(instanceColors.rgb, project_uCameraPosition, geometry.position.xyz, geometry.normal);\n\n  // Apply opacity to instance color, or return instance picking color\n  vColor = vec4(lightColor, instanceColors.a * opacity);\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n",fs:"#define SHADER_NAME point-cloud-layer-fragment-shader\n\nprecision highp float;\n\nvarying vec4 vColor;\nvarying vec2 unitPosition;\n\nvoid main(void) {\n  geometry.uv = unitPosition;\n\n  float distToCenter = length(unitPosition);\n\n  if (distToCenter > 1.0) {\n    discard;\n  }\n\n  gl_FragColor = vColor;\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n",modules:[m.a,y.a,v.a]})}},{key:"initializeState",value:function(){this.getAttributeManager().addInstanced({instancePositions:{size:3,type:5130,fp64:this.use64bitPositions(),transition:!0,accessor:"getPosition"},instanceNormals:{size:3,transition:!0,accessor:"getNormal",defaultValue:C},instanceColors:{size:this.props.colorFormat.length,type:5121,normalized:!0,transition:!0,accessor:"getColor",defaultValue:T}})}},{key:"updateState",value:function(t){var e,r,i,o=t.changeFlags,a=t.props;if(u()(d()(n.prototype),"updateState",this).call(this,t),o.extensionsChanged){var s,c=this.context.gl;null===(s=this.state.model)||void 0===s||s.delete(),this.state.model=this._getModel(c),this.getAttributeManager().invalidateAll()}o.dataChanged&&(e=a.data,r=e.header,i=e.attributes,r&&i&&(e.length=r.vertexCount,i.POSITION&&(i.instancePositions=i.POSITION),i.NORMAL&&(i.instanceNormals=i.NORMAL),i.COLOR_0&&(i.instanceColors=i.COLOR_0)))}},{key:"draw",value:function(t){var e=t.uniforms,n=this.props,r=n.pointSize,i=n.sizeUnits;this.state.model.setUniforms(e).setUniforms({sizeUnits:_.e[i],radiusPixels:r}).draw()}},{key:"_getModel",value:function(t){for(var e=[],n=0;n<3;n++){var r=n/3*Math.PI*2;e.push(2*Math.cos(r),2*Math.sin(r),0)}return new x.a(t,O(O({},this.getShaders()),{},{id:this.props.id,geometry:new w.a({drawMode:4,attributes:{positions:new Float32Array(e)}}),isInstanced:!0}))}}]),n}(b.a);g()(M,"layerName","PointCloudLayer"),g()(M,"defaultProps",P)},function(t,e,n){"use strict";var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(8),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(21),y=n(217),v=n(235),_=n(234),b=n(164),x=n(60),w=n(7),E=n(107),O=n(186),S=n(251),T=n(189),C=n(130);function P(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function M(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?P(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):P(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function I(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}function B(t,e){(t.COLOR_0||t.colors)&&e||(t.colors={constant:!0,value:new Float32Array([1,1,1])}),m.a.assert(t.positions||t.POSITION,'no "postions" or "POSITION" attribute in mesh')}function R(t,e){if(t.attributes)return B(t.attributes,e),t instanceof x.a?t:new x.a(t);if(t.positions||t.POSITION)return B(t,e),new x.a({attributes:t});throw Error("Invalid mesh")}n.d(e,"a",(function(){return D}));var k={mesh:{type:"object",value:null,async:!0},texture:{type:"image",value:null,async:!0},sizeScale:{type:"number",value:1,min:0},_useMeshColors:{type:"boolean",value:!1},_instanced:!0,wireframe:!1,material:!0,getPosition:{type:"accessor",value:function(t){return t.position}},getColor:{type:"accessor",value:[0,0,0,255]},getOrientation:{type:"accessor",value:[0,0,0]},getScale:{type:"accessor",value:[1,1,1]},getTranslation:{type:"accessor",value:[0,0,0]},getTransformMatrix:{type:"accessor",value:[]}},D=function(t){l()(n,t);var e=I(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(){var t=!Object(w.j)(this.context.gl),e={};return Object(S.b)(this.context.gl,T.a.GLSL_DERIVATIVES)&&(e.DERIVATIVES_AVAILABLE=1),u()(d()(n.prototype),"getShaders",this).call(this,{vs:"#version 300 es\n#define SHADER_NAME simple-mesh-layer-vs\n\n// Scale the model\nuniform float sizeScale;\nuniform bool composeModelMatrix;\n\n// Primitive attributes\nin vec3 positions;\nin vec3 normals;\nin vec3 colors;\nin vec2 texCoords;\n\n// Instance attributes\nin vec3 instancePositions;\nin vec3 instancePositions64Low;\nin vec4 instanceColors;\nin vec3 instancePickingColors;\nin mat3 instanceModelMatrix;\nin vec3 instanceTranslation;\n\n// Outputs to fragment shader\nout vec2 vTexCoord;\nout vec3 cameraPosition;\nout vec3 normals_commonspace;\nout vec4 position_commonspace;\nout vec4 vColor;\n\nvoid main(void) {\n  geometry.worldPosition = instancePositions;\n  geometry.uv = texCoords;\n  geometry.pickingColor = instancePickingColors;\n\n  vTexCoord = texCoords;\n  cameraPosition = project_uCameraPosition;\n  vColor = vec4(colors * instanceColors.rgb, instanceColors.a);\n\n  vec3 pos = (instanceModelMatrix * positions) * sizeScale + instanceTranslation;\n\n  if (composeModelMatrix) {\n    DECKGL_FILTER_SIZE(pos, geometry);\n    // using instancePositions as world coordinates\n    // when using globe mode, this branch does not re-orient the model to align with the surface of the earth\n    // call project_normal before setting position to avoid rotation\n    normals_commonspace = project_normal(instanceModelMatrix * normals);\n    gl_Position = project_position_to_clipspace(pos + instancePositions, instancePositions64Low, vec3(0.0), position_commonspace);\n    geometry.position = position_commonspace;\n  }\n  else {\n    pos = project_size(pos);\n    DECKGL_FILTER_SIZE(pos, geometry);\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, pos, position_commonspace);\n    geometry.position = position_commonspace;\n    normals_commonspace = project_normal(instanceModelMatrix * normals);\n  }\n\n  geometry.normal = normals_commonspace;\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n",fs:"#version 300 es\n#define SHADER_NAME simple-mesh-layer-fs\n\nprecision highp float;\n\nuniform bool hasTexture;\nuniform sampler2D sampler;\nuniform bool flatShading;\nuniform float opacity;\n\nin vec2 vTexCoord;\nin vec3 cameraPosition;\nin vec3 normals_commonspace;\nin vec4 position_commonspace;\nin vec4 vColor;\n\nout vec4 fragColor;\n\nvoid main(void) {\n  geometry.uv = vTexCoord;\n\n  vec3 normal;\n  if (flatShading) {\n\n// NOTE(Tarek): This is necessary because\n// headless.gl reports the extension as\n// available but does not support it in\n// the shader.\n#ifdef DERIVATIVES_AVAILABLE\n    normal = normalize(cross(dFdx(position_commonspace.xyz), dFdy(position_commonspace.xyz)));\n#else\n    normal = vec3(0.0, 0.0, 1.0);\n#endif\n  } else {\n    normal = normals_commonspace;\n  }\n\n  vec4 color = hasTexture ? texture(sampler, vTexCoord) : vColor;\n  vec3 lightColor = lighting_getLightColor(color.rgb, cameraPosition, position_commonspace.xyz, normal);\n  fragColor = vec4(lightColor, color.a * opacity);\n\n  DECKGL_FILTER_COLOR(fragColor, geometry);\n}\n",modules:[y.a,v.b,_.a],transpileToGLSL100:t,defines:e})}},{key:"initializeState",value:function(){this.getAttributeManager().addInstanced({instancePositions:{transition:!0,type:5130,fp64:this.use64bitPositions(),size:3,accessor:"getPosition"},instanceColors:{type:5121,transition:!0,size:this.props.colorFormat.length,normalized:!0,accessor:"getColor",defaultValue:[0,0,0,255]},instanceModelMatrix:C.a}),this.setState({emptyTexture:new E.a(this.context.gl,{data:new Uint8Array(4),width:1,height:1})})}},{key:"updateState",value:function(t){u()(d()(n.prototype),"updateState",this).call(this,t);var e=t.props,r=t.oldProps,i=t.changeFlags;if(e.mesh!==r.mesh||i.extensionsChanged){var o;if(null===(o=this.state.model)||void 0===o||o.delete(),e.mesh){this.state.model=this.getModel(e.mesh);var a=e.mesh.attributes||e.mesh;this.setState({hasNormals:Boolean(a.NORMAL||a.normals)})}this.getAttributeManager().invalidateAll()}e.texture!==r.texture&&this.setTexture(e.texture),this.state.model&&this.state.model.setDrawMode(this.props.wireframe?3:4)}},{key:"finalizeState",value:function(t){u()(d()(n.prototype),"finalizeState",this).call(this,t),this.state.emptyTexture.delete()}},{key:"draw",value:function(t){var e=t.uniforms;if(this.state.model){var n=this.context.viewport,r=this.props,i=r.sizeScale,o=r.coordinateSystem,a=r._instanced;this.state.model.setUniforms(e).setUniforms({sizeScale:i,composeModelMatrix:!a||Object(C.b)(n,o),flatShading:!this.state.hasNormals}).draw()}}},{key:"getModel",value:function(t){var e=new O.a(this.context.gl,M(M({},this.getShaders()),{},{id:this.props.id,geometry:R(t,this.props._useMeshColors),isInstanced:!0})),n=this.props.texture,r=this.state.emptyTexture;return e.setUniforms({sampler:n||r,hasTexture:Boolean(n)}),e}},{key:"setTexture",value:function(t){var e=this.state,n=e.emptyTexture,r=e.model;r&&r.setUniforms({sampler:t||n,hasTexture:Boolean(t)})}}]),n}(b.a);g()(D,"defaultProps",k),g()(D,"layerName","SimpleMeshLayer")},function(t,e,n){"use strict";var r=n(0),i=n.n(r);const o={pickingSelectedColor:null,pickingHighlightColor:new Uint8Array([0,255,255,255]),pickingActive:!1,pickingAttribute:!1};const a={name:"picking",vs:"uniform bool picking_uActive;\nuniform bool picking_uAttribute;\nuniform vec3 picking_uSelectedColor;\nuniform bool picking_uSelectedColorValid;\n\nout vec4 picking_vRGBcolor_Avalid;\n\nconst float COLOR_SCALE = 1. / 255.;\n\nbool picking_isColorValid(vec3 color) {\n  return dot(color, vec3(1.0)) > 0.001;\n}\n\nbool isVertexPicked(vec3 vertexColor) {\n  return\n    picking_uSelectedColorValid &&\n    !picking_isColorValid(abs(vertexColor - picking_uSelectedColor));\n}\n\nvoid picking_setPickingColor(vec3 pickingColor) {\n  if (picking_uActive) {\n    picking_vRGBcolor_Avalid.a = float(picking_isColorValid(pickingColor));\n\n    if (!picking_uAttribute) {\n      picking_vRGBcolor_Avalid.rgb = pickingColor * COLOR_SCALE;\n    }\n  } else {\n    picking_vRGBcolor_Avalid.a = float(isVertexPicked(pickingColor));\n  }\n}\n\nvoid picking_setPickingAttribute(float value) {\n  if (picking_uAttribute) {\n    picking_vRGBcolor_Avalid.r = value;\n  }\n}\nvoid picking_setPickingAttribute(vec2 value) {\n  if (picking_uAttribute) {\n    picking_vRGBcolor_Avalid.rg = value;\n  }\n}\nvoid picking_setPickingAttribute(vec3 value) {\n  if (picking_uAttribute) {\n    picking_vRGBcolor_Avalid.rgb = value;\n  }\n}\n",fs:"uniform bool picking_uActive;\nuniform vec3 picking_uSelectedColor;\nuniform vec4 picking_uHighlightColor;\n\nin vec4 picking_vRGBcolor_Avalid;\nvec4 picking_filterHighlightColor(vec4 color) {\n  if (picking_uActive) {\n    return color;\n  }\n  bool selected = bool(picking_vRGBcolor_Avalid.a);\n\n  if (selected) {\n    float highLightAlpha = picking_uHighlightColor.a;\n    float blendedAlpha = highLightAlpha + color.a * (1.0 - highLightAlpha);\n    float highLightRatio = highLightAlpha / blendedAlpha;\n\n    vec3 blendedRGB = mix(color.rgb, picking_uHighlightColor.rgb, highLightRatio);\n    return vec4(blendedRGB, blendedAlpha);\n  } else {\n    return color;\n  }\n}\nvec4 picking_filterPickingColor(vec4 color) {\n  if (picking_uActive) {\n    if (picking_vRGBcolor_Avalid.a == 0.0) {\n      discard;\n    }\n    return picking_vRGBcolor_Avalid;\n  }\n  return color;\n}\nvec4 picking_filterColor(vec4 color) {\n  vec4 highightColor = picking_filterHighlightColor(color);\n  return picking_filterPickingColor(highightColor);\n}\n\n",getUniforms:function(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:o;const e={};if(void 0!==t.pickingSelectedColor)if(t.pickingSelectedColor){const n=t.pickingSelectedColor.slice(0,3);e.picking_uSelectedColorValid=1,e.picking_uSelectedColor=n}else e.picking_uSelectedColorValid=0;if(t.pickingHighlightColor){const n=Array.from(t.pickingHighlightColor,t=>t/255);Number.isFinite(n[3])||(n[3]=1),e.picking_uHighlightColor=n}return void 0!==t.pickingActive&&(e.picking_uActive=Boolean(t.pickingActive),e.picking_uAttribute=Boolean(t.pickingAttribute)),e}};function s(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}e.a=function(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?s(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):s(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}({inject:{"vs:DECKGL_FILTER_GL_POSITION":"\n    // for picking depth values\n    picking_setPickingAttribute(position.z / position.w);\n  ","vs:DECKGL_FILTER_COLOR":"\n  picking_setPickingColor(geometry.pickingColor);\n  ","fs:DECKGL_FILTER_COLOR":{order:99,injection:"\n  // use highlight color if this fragment belongs to the selected object.\n  color = picking_filterHighlightColor(color);\n\n  // use picking color if rendering to picking FBO.\n  color = picking_filterPickingColor(color);\n    "}}},a)},function(t,e,n){"use strict";var r=n(146),i="\nuniform float lighting_uAmbient;\nuniform float lighting_uDiffuse;\nuniform float lighting_uShininess;\nuniform vec3  lighting_uSpecularColor;\n\nvec3 lighting_getLightColor(vec3 surfaceColor, vec3 light_direction, vec3 view_direction, vec3 normal_worldspace, vec3 color) {\n    vec3 halfway_direction = normalize(light_direction + view_direction);\n    float lambertian = dot(light_direction, normal_worldspace);\n    float specular = 0.0;\n    if (lambertian > 0.0) {\n      float specular_angle = max(dot(normal_worldspace, halfway_direction), 0.0);\n      specular = pow(specular_angle, lighting_uShininess);\n    }\n    lambertian = max(lambertian, 0.0);\n    return (lambertian * lighting_uDiffuse * surfaceColor + specular * lighting_uSpecularColor) * color;\n}\n\nvec3 lighting_getLightColor(vec3 surfaceColor, vec3 cameraPosition, vec3 position_worldspace, vec3 normal_worldspace) {\n  vec3 lightColor = surfaceColor;\n\n  if (lighting_uEnabled) {\n    vec3 view_direction = normalize(cameraPosition - position_worldspace);\n    lightColor = lighting_uAmbient * surfaceColor * lighting_uAmbientLight.color;\n\n    for (int i = 0; i < MAX_LIGHTS; i++) {\n      if (i >= lighting_uPointLightCount) {\n        break;\n      }\n      PointLight pointLight = lighting_uPointLight[i];\n      vec3 light_position_worldspace = pointLight.position;\n      vec3 light_direction = normalize(light_position_worldspace - position_worldspace);\n      lightColor += lighting_getLightColor(surfaceColor, light_direction, view_direction, normal_worldspace, pointLight.color);\n    }\n\n    for (int i = 0; i < MAX_LIGHTS; i++) {\n      if (i >= lighting_uDirectionalLightCount) {\n        break;\n      }\n      DirectionalLight directionalLight = lighting_uDirectionalLight[i];\n      lightColor += lighting_getLightColor(surfaceColor, -directionalLight.direction, view_direction, normal_worldspace, directionalLight.color);\n    }\n  }\n  return lightColor;\n}\n\nvec3 lighting_getSpecularLightColor(vec3 cameraPosition, vec3 position_worldspace, vec3 normal_worldspace) {\n  vec3 lightColor = vec3(0, 0, 0);\n  vec3 surfaceColor = vec3(0, 0, 0);\n\n  if (lighting_uEnabled) {\n    vec3 view_direction = normalize(cameraPosition - position_worldspace);\n\n    for (int i = 0; i < MAX_LIGHTS; i++) {\n      if (i >= lighting_uPointLightCount) {\n        break;\n      }\n      PointLight pointLight = lighting_uPointLight[i];\n      vec3 light_position_worldspace = pointLight.position;\n      vec3 light_direction = normalize(light_position_worldspace - position_worldspace);\n      lightColor += lighting_getLightColor(surfaceColor, light_direction, view_direction, normal_worldspace, pointLight.color);\n    }\n\n    for (int i = 0; i < MAX_LIGHTS; i++) {\n      if (i >= lighting_uDirectionalLightCount) {\n        break;\n      }\n      DirectionalLight directionalLight = lighting_uDirectionalLight[i];\n      lightColor += lighting_getLightColor(surfaceColor, -directionalLight.direction, view_direction, normal_worldspace, directionalLight.color);\n    }\n  }\n  return lightColor;\n}\n";n.d(e,"a",(function(){return u})),n.d(e,"b",(function(){return c}));const o={};function a(t){const{ambient:e=.35,diffuse:n=.6,shininess:r=32,specularColor:i=[30,30,30]}=t;return{lighting_uAmbient:e,lighting_uDiffuse:n,lighting_uShininess:r,lighting_uSpecularColor:i.map(t=>t/255)}}function s(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:o;if(!("material"in t))return{};const{material:e}=t;return e?a(e):{lighting_uEnabled:!1}}const u={name:"gouraud-lighting",dependencies:[r.a],vs:i,defines:{LIGHTING_VERTEX:1},getUniforms:s},c={name:"phong-lighting",dependencies:[r.a],fs:i,defines:{LIGHTING_FRAGMENT:1},getUniforms:s}},function(t,e,n){"use strict";n.d(e,"a",(function(){return u})),n.d(e,"b",(function(){return c}));var r=n(107),i=n(237),o=n(238),a=n(74),s=n(10);function u(t,e){Object(s.a)(t instanceof r.a||t instanceof i.a||t instanceof o.a);const n=t.constructor,{gl:a,width:u,height:c,format:l,type:h,dataFormat:f,border:p,mipmaps:d}=t;return new n(a,Object.assign({width:u,height:c,format:l,type:h,dataFormat:f,border:p,mipmaps:d},e))}function c(t,e){const{gl:n,width:r,height:i,id:o}=t;return new a.a(n,Object.assign({},e,{id:"framebuffer-for-".concat(o),width:r,height:i,attachments:{36064:t}}))}},function(t,e,n){"use strict";n.d(e,"a",(function(){return a}));var r=n(7),i=n(54);const o=[34069,34070,34071,34072,34073,34074];class a extends i.a{get[Symbol.toStringTag](){return"TextureCube"}constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};Object(r.b)(t),super(t,Object.assign({},e,{target:34067})),this.initialize(e),Object.seal(this)}initialize(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{mipmaps:e=!0,parameters:n={}}=t;return this.opts=t,this.setCubeMapImageData(t).then(()=>{this.loaded=!0,e&&this.generateMipmap(t),this.setParameters(n)}),this}subImage(t){let{face:e,data:n,x:r=0,y:i=0,mipmapLevel:o=0}=t;return this._subImage({target:e,data:n,x:r,y:i,mipmapLevel:o})}async setCubeMapImageData(t){let{width:e,height:n,pixels:i,data:a,border:s=0,format:u=6408,type:c=5121}=t;const{gl:l}=this,h=i||a,f=await Promise.all(o.map(t=>{const e=h[t];return Promise.all(Array.isArray(e)?e:[e])}));this.bind(),o.forEach((t,i)=>{f[i].length>1&&!1!==this.opts.mipmaps&&r.k.warn("".concat(this.id," has mipmap and multiple LODs."))(),f[i].forEach((r,i)=>{e&&n?l.texImage2D(t,i,u,e,n,s,u,c,r):l.texImage2D(t,i,u,u,c,r)})}),this.unbind()}setImageDataForFace(t){const{face:e,width:n,height:r,pixels:i,data:o,border:a=0,format:s=6408,type:u=5121}=t,{gl:c}=this,l=i||o;return this.bind(),l instanceof Promise?l.then(n=>this.setImageDataForFace(Object.assign({},t,{face:e,data:n,pixels:n}))):this.width||this.height?c.texImage2D(e,0,s,n,r,a,s,u,l):c.texImage2D(e,0,s,s,u,l),this}}a.FACES=o},function(t,e,n){"use strict";n.d(e,"a",(function(){return s}));var r=n(7),i=n(54),o=n(82),a=n(33);class s extends i.a{get[Symbol.toStringTag](){return"Texture3D"}static isSupported(t){return Object(r.j)(t)}constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};Object(r.a)(t),e=Object.assign({depth:1},e,{target:32879,unpackFlipY:!1}),super(t,e),this.initialize(e),Object.seal(this)}setImageData(t){let{level:e=0,dataFormat:n=6408,width:i,height:s,depth:u=1,border:c=0,format:l,type:h=5121,offset:f=0,data:p,parameters:d={}}=t;if(this._trackDeallocatedMemory("Texture"),this.gl.bindTexture(this.target,this.handle),Object(r.o)(this.gl,d,()=>{ArrayBuffer.isView(p)&&this.gl.texImage3D(this.target,e,n,i,s,u,c,l,h,p),p instanceof a.a&&(this.gl.bindBuffer(35052,p.handle),this.gl.texImage3D(this.target,e,n,i,s,u,c,l,h,f))}),p&&p.byteLength)this._trackAllocatedMemory(p.byteLength,"Texture");else{const t=o.a[this.dataFormat]||4,e=o.c[this.type]||1;this._trackAllocatedMemory(this.width*this.height*this.depth*t*e,"Texture")}return this.loaded=!0,this}}},function(t,e,n){"use strict";(function(t){n.d(e,"a",(function(){return i}));var r=n(240);function i(){return!("object"==typeof t&&"[object process]"===String(t)&&!t.browser)||Object(r.a)()}}).call(this,n(44))},function(t,e,n){"use strict";(function(t){function r(e){if("undefined"!=typeof window&&"object"==typeof window.process&&"renderer"===window.process.type)return!0;if(void 0!==t&&"object"==typeof t.versions&&Boolean(t.versions.electron))return!0;const n="object"==typeof navigator&&"string"==typeof navigator.userAgent&&navigator.userAgent,r=e||n;return!!(r&&r.indexOf("Electron")>=0)}n.d(e,"a",(function(){return r}))}).call(this,n(44))},function(t,e){t.exports=function(t){var e;if("undefined"!=typeof Symbol){if(Symbol.asyncIterator&&null!=(e=t[Symbol.asyncIterator]))return e.call(t);if(Symbol.iterator&&null!=(e=t[Symbol.iterator]))return e.call(t)}throw new TypeError("Object is not async iterable")}},function(t,e,n){"use strict";(function(t){n.d(e,"a",(function(){return f}));var r=n(243),i=n(244),o=n(2),a=n(30),s=n.n(a),u=n(111);var c={container:s.a.object,gl:s.a.object,mapboxApiAccessToken:s.a.string,mapboxApiUrl:s.a.string,attributionControl:s.a.bool,preserveDrawingBuffer:s.a.bool,reuseMaps:s.a.bool,transformRequest:s.a.func,mapOptions:s.a.object,mapStyle:s.a.oneOfType([s.a.string,s.a.object]),visible:s.a.bool,asyncRender:s.a.bool,onLoad:s.a.func,onError:s.a.func,width:s.a.number,height:s.a.number,viewState:s.a.object,longitude:s.a.number,latitude:s.a.number,zoom:s.a.number,bearing:s.a.number,pitch:s.a.number,altitude:s.a.number},l={container:u.a.body,mapboxApiAccessToken:function(){var e=null;if("undefined"!=typeof window&&window.location){var n=window.location.search.match(/access_token=([^&\/]*)/);e=n&&n[1]}e||void 0===t||(e=e||t.env.MapboxAccessToken||t.env.REACT_APP_MAPBOX_ACCESS_TOKEN);return e||"no-token"}(),mapboxApiUrl:"https://api.mapbox.com",preserveDrawingBuffer:!1,attributionControl:!0,reuseMaps:!1,mapOptions:{},mapStyle:"mapbox://styles/mapbox/light-v8",visible:!0,asyncRender:!1,onLoad:function(){},onError:function(t){t&&console.error(t.error)},width:0,height:0,longitude:0,latitude:0,zoom:0,bearing:0,pitch:0,altitude:1.5};function h(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:"component";t.debug&&s.a.checkPropTypes(c,t,"prop",e)}var f=function(){function t(e){var n=this;if(Object(r.a)(this,t),Object(o.a)(this,"mapboxgl",void 0),Object(o.a)(this,"props",l),Object(o.a)(this,"_map",null),Object(o.a)(this,"width",0),Object(o.a)(this,"height",0),Object(o.a)(this,"_fireLoadEvent",(function(){n.props.onLoad({type:"load",target:n._map})})),!e.mapboxgl)throw new Error("Mapbox not available");this.mapboxgl=e.mapboxgl,t.initialized||(t.initialized=!0,this._checkStyleSheet(this.mapboxgl.version)),this._initialize(e)}return Object(i.a)(t,[{key:"finalize",value:function(){return this._destroy(),this}},{key:"setProps",value:function(t){return this._update(this.props,t),this}},{key:"resize",value:function(){return this._map.resize(),this}},{key:"redraw",value:function(){var t=this._map;t.style&&(t._frame&&(t._frame.cancel(),t._frame=null),t._render())}},{key:"getMap",value:function(){return this._map}},{key:"_reuse",value:function(e){this._map=t.savedMap;var n=this._map.getContainer(),r=e.container;for(r.classList.add("mapboxgl-map");n.childNodes.length>0;)r.appendChild(n.childNodes[0]);this._map._container=r,t.savedMap=null,e.mapStyle&&this._map.setStyle(e.mapStyle,{diff:!1}),this._map.isStyleLoaded()?this._fireLoadEvent():this._map.once("styledata",this._fireLoadEvent)}},{key:"_create",value:function(e){if(e.reuseMaps&&t.savedMap)this._reuse(e);else{if(e.gl){var n=HTMLCanvasElement.prototype.getContext;HTMLCanvasElement.prototype.getContext=function(){return HTMLCanvasElement.prototype.getContext=n,e.gl}}var r={container:e.container,center:[0,0],zoom:8,pitch:0,bearing:0,maxZoom:24,style:e.mapStyle,interactive:!1,trackResize:!1,attributionControl:e.attributionControl,preserveDrawingBuffer:e.preserveDrawingBuffer};e.transformRequest&&(r.transformRequest=e.transformRequest),this._map=new this.mapboxgl.Map(Object.assign({},r,e.mapOptions)),this._map.once("load",e.onLoad),this._map.on("error",e.onError)}return this}},{key:"_destroy",value:function(){this._map&&(t.savedMap?this._map.remove():(t.savedMap=this._map,this._map.off("load",this.props.onLoad),this._map.off("error",this.props.onError),this._map.off("styledata",this._fireLoadEvent)),this._map=null)}},{key:"_initialize",value:function(t){var e=this;h(t=Object.assign({},l,t),"Mapbox"),this.mapboxgl.accessToken=t.mapboxApiAccessToken||l.mapboxApiAccessToken,this.mapboxgl.baseApiUrl=t.mapboxApiUrl,this._create(t);var n=t.container;Object.defineProperty(n,"offsetWidth",{get:function(){return e.width}}),Object.defineProperty(n,"clientWidth",{get:function(){return e.width}}),Object.defineProperty(n,"offsetHeight",{get:function(){return e.height}}),Object.defineProperty(n,"clientHeight",{get:function(){return e.height}});var r=this._map.getCanvas();r&&(r.style.outline="none"),this._updateMapViewport({},t),this._updateMapSize({},t),this.props=t}},{key:"_update",value:function(t,e){if(this._map){h(e=Object.assign({},this.props,e),"Mapbox");var n=this._updateMapViewport(t,e),r=this._updateMapSize(t,e);e.asyncRender||!n&&!r||this.redraw(),this.props=e}}},{key:"_updateMapSize",value:function(t,e){var n=t.width!==e.width||t.height!==e.height;return n&&(this.width=e.width,this.height=e.height,this.resize()),n}},{key:"_updateMapViewport",value:function(t,e){var n=this._getViewState(t),r=this._getViewState(e),i=r.latitude!==n.latitude||r.longitude!==n.longitude||r.zoom!==n.zoom||r.pitch!==n.pitch||r.bearing!==n.bearing||r.altitude!==n.altitude;return i&&(this._map.jumpTo(this._viewStateToMapboxProps(r)),r.altitude!==n.altitude&&(this._map.transform.altitude=r.altitude)),i}},{key:"_getViewState",value:function(t){var e=t.viewState||t,n=e.longitude,r=e.latitude,i=e.zoom,o=e.pitch,a=void 0===o?0:o,s=e.bearing,u=void 0===s?0:s,c=e.altitude;return{longitude:n,latitude:r,zoom:i,pitch:a,bearing:u,altitude:void 0===c?1.5:c}}},{key:"_checkStyleSheet",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:"0.47.0";if(void 0!==u.a)try{var e=u.a.createElement("div");e.className="mapboxgl-map",e.style.display="none",u.a.body.append(e);var n="static"!==window.getComputedStyle(e).position;if(!n){var r=u.a.createElement("link");r.setAttribute("rel","stylesheet"),r.setAttribute("type","text/css"),r.setAttribute("href","https://api.tiles.mapbox.com/mapbox-gl-js/v".concat(t,"/mapbox-gl.css")),u.a.head.append(r)}}catch(t){}}},{key:"_viewStateToMapboxProps",value:function(t){return{center:[t.longitude,t.latitude],zoom:t.zoom,bearing:t.bearing,pitch:t.pitch}}}]),t}();Object(o.a)(f,"initialized",!1),Object(o.a)(f,"propTypes",c),Object(o.a)(f,"defaultProps",l),Object(o.a)(f,"savedMap",null)}).call(this,n(44))},function(t,e,n){"use strict";function r(t,e){if(!(t instanceof e))throw new TypeError("Cannot call a class as a function")}n.d(e,"a",(function(){return r}))},function(t,e,n){"use strict";function r(t,e){for(var n=0;n<e.length;n++){var r=e[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(t,r.key,r)}}function i(t,e,n){return e&&r(t.prototype,e),n&&r(t,n),t}n.d(e,"a",(function(){return i}))},function(t,e,n){"use strict";function r(t,e,n){n=n||2;var r,o,s,u,c,l,p,d=e&&e.length,g=d?e[0]*n:t.length,m=i(t,0,g,n,!0),y=[];if(!m||m.next===m.prev)return y;if(d&&(m=function(t,e,n,r){var o,a,s,u,c,l=[];for(o=0,a=e.length;o<a;o++)s=e[o]*r,u=o<a-1?e[o+1]*r:t.length,(c=i(t,s,u,r,!1))===c.next&&(c.steiner=!0),l.push(A(c));for(l.sort(h),o=0;o<l.length;o++)n=f(l[o],n);return n}(t,e,m,n)),t.length>80*n){r=s=t[0],o=u=t[1];for(var v=n;v<g;v+=n)(c=t[v])<r&&(r=c),(l=t[v+1])<o&&(o=l),c>s&&(s=c),l>u&&(u=l);p=0!==(p=Math.max(s-r,u-o))?32767/p:0}return a(m,y,n,r,o,p,0),y}function i(t,e,n,r,i){var o,a;if(i===C(t,e,n,r)>0)for(o=e;o<n;o+=r)a=O(o,t[o],t[o+1],a);else for(o=n-r;o>=e;o-=r)a=O(o,t[o],t[o+1],a);return a&&v(a,a.next)&&(S(a),a=a.next),a}function o(t,e){if(!t)return t;e||(e=t);var n,r=t;do{if(n=!1,r.steiner||!v(r,r.next)&&0!==y(r.prev,r,r.next))r=r.next;else{if(S(r),(r=e=r.prev)===r.next)break;n=!0}}while(n||r!==e);return e}function a(t,e,n,r,i,h,f){if(t){!f&&h&&function(t,e,n,r){var i=t;do{0===i.z&&(i.z=d(i.x,i.y,e,n,r)),i.prevZ=i.prev,i.nextZ=i.next,i=i.next}while(i!==t);i.prevZ.nextZ=null,i.prevZ=null,function(t){var e,n,r,i,o,a,s,u,c=1;do{for(n=t,t=null,o=null,a=0;n;){for(a++,r=n,s=0,e=0;e<c&&(s++,r=r.nextZ);e++);for(u=c;s>0||u>0&&r;)0!==s&&(0===u||!r||n.z<=r.z)?(i=n,n=n.nextZ,s--):(i=r,r=r.nextZ,u--),o?o.nextZ=i:t=i,i.prevZ=o,o=i;n=r}o.nextZ=null,c*=2}while(a>1)}(i)}(t,r,i,h);for(var p,A,g=t;t.prev!==t.next;)if(p=t.prev,A=t.next,h?u(t,r,i,h):s(t))e.push(p.i/n|0),e.push(t.i/n|0),e.push(A.i/n|0),S(t),t=A.next,g=A.next;else if((t=A)===g){f?1===f?a(t=c(o(t),e,n),e,n,r,i,h,2):2===f&&l(t,e,n,r,i,h):a(o(t),e,n,r,i,h,1);break}}}function s(t){var e=t.prev,n=t,r=t.next;if(y(e,n,r)>=0)return!1;for(var i=e.x,o=n.x,a=r.x,s=e.y,u=n.y,c=r.y,l=i<o?i<a?i:a:o<a?o:a,h=s<u?s<c?s:c:u<c?u:c,f=i>o?i>a?i:a:o>a?o:a,p=s>u?s>c?s:c:u>c?u:c,d=r.next;d!==e;){if(d.x>=l&&d.x<=f&&d.y>=h&&d.y<=p&&g(i,s,o,u,a,c,d.x,d.y)&&y(d.prev,d,d.next)>=0)return!1;d=d.next}return!0}function u(t,e,n,r){var i=t.prev,o=t,a=t.next;if(y(i,o,a)>=0)return!1;for(var s=i.x,u=o.x,c=a.x,l=i.y,h=o.y,f=a.y,p=s<u?s<c?s:c:u<c?u:c,A=l<h?l<f?l:f:h<f?h:f,m=s>u?s>c?s:c:u>c?u:c,v=l>h?l>f?l:f:h>f?h:f,_=d(p,A,e,n,r),b=d(m,v,e,n,r),x=t.prevZ,w=t.nextZ;x&&x.z>=_&&w&&w.z<=b;){if(x.x>=p&&x.x<=m&&x.y>=A&&x.y<=v&&x!==i&&x!==a&&g(s,l,u,h,c,f,x.x,x.y)&&y(x.prev,x,x.next)>=0)return!1;if(x=x.prevZ,w.x>=p&&w.x<=m&&w.y>=A&&w.y<=v&&w!==i&&w!==a&&g(s,l,u,h,c,f,w.x,w.y)&&y(w.prev,w,w.next)>=0)return!1;w=w.nextZ}for(;x&&x.z>=_;){if(x.x>=p&&x.x<=m&&x.y>=A&&x.y<=v&&x!==i&&x!==a&&g(s,l,u,h,c,f,x.x,x.y)&&y(x.prev,x,x.next)>=0)return!1;x=x.prevZ}for(;w&&w.z<=b;){if(w.x>=p&&w.x<=m&&w.y>=A&&w.y<=v&&w!==i&&w!==a&&g(s,l,u,h,c,f,w.x,w.y)&&y(w.prev,w,w.next)>=0)return!1;w=w.nextZ}return!0}function c(t,e,n){var r=t;do{var i=r.prev,a=r.next.next;!v(i,a)&&_(i,r,r.next,a)&&w(i,a)&&w(a,i)&&(e.push(i.i/n|0),e.push(r.i/n|0),e.push(a.i/n|0),S(r),S(r.next),r=t=a),r=r.next}while(r!==t);return o(r)}function l(t,e,n,r,i,s){var u=t;do{for(var c=u.next.next;c!==u.prev;){if(u.i!==c.i&&m(u,c)){var l=E(u,c);return u=o(u,u.next),l=o(l,l.next),a(u,e,n,r,i,s,0),void a(l,e,n,r,i,s,0)}c=c.next}u=u.next}while(u!==t)}function h(t,e){return t.x-e.x}function f(t,e){var n=function(t,e){var n,r=e,i=t.x,o=t.y,a=-1/0;do{if(o<=r.y&&o>=r.next.y&&r.next.y!==r.y){var s=r.x+(o-r.y)*(r.next.x-r.x)/(r.next.y-r.y);if(s<=i&&s>a&&(a=s,n=r.x<r.next.x?r:r.next,s===i))return n}r=r.next}while(r!==e);if(!n)return null;var u,c=n,l=n.x,h=n.y,f=1/0;r=n;do{i>=r.x&&r.x>=l&&i!==r.x&&g(o<h?i:a,o,l,h,o<h?a:i,o,r.x,r.y)&&(u=Math.abs(o-r.y)/(i-r.x),w(r,t)&&(u<f||u===f&&(r.x>n.x||r.x===n.x&&p(n,r)))&&(n=r,f=u)),r=r.next}while(r!==c);return n}(t,e);if(!n)return e;var r=E(n,t);return o(r,r.next),o(n,n.next)}function p(t,e){return y(t.prev,t,e.prev)<0&&y(e.next,t,t.next)<0}function d(t,e,n,r,i){return(t=1431655765&((t=858993459&((t=252645135&((t=16711935&((t=(t-n)*i|0)|t<<8))|t<<4))|t<<2))|t<<1))|(e=1431655765&((e=858993459&((e=252645135&((e=16711935&((e=(e-r)*i|0)|e<<8))|e<<4))|e<<2))|e<<1))<<1}function A(t){var e=t,n=t;do{(e.x<n.x||e.x===n.x&&e.y<n.y)&&(n=e),e=e.next}while(e!==t);return n}function g(t,e,n,r,i,o,a,s){return(i-a)*(e-s)>=(t-a)*(o-s)&&(t-a)*(r-s)>=(n-a)*(e-s)&&(n-a)*(o-s)>=(i-a)*(r-s)}function m(t,e){return t.next.i!==e.i&&t.prev.i!==e.i&&!function(t,e){var n=t;do{if(n.i!==t.i&&n.next.i!==t.i&&n.i!==e.i&&n.next.i!==e.i&&_(n,n.next,t,e))return!0;n=n.next}while(n!==t);return!1}(t,e)&&(w(t,e)&&w(e,t)&&function(t,e){var n=t,r=!1,i=(t.x+e.x)/2,o=(t.y+e.y)/2;do{n.y>o!=n.next.y>o&&n.next.y!==n.y&&i<(n.next.x-n.x)*(o-n.y)/(n.next.y-n.y)+n.x&&(r=!r),n=n.next}while(n!==t);return r}(t,e)&&(y(t.prev,t,e.prev)||y(t,e.prev,e))||v(t,e)&&y(t.prev,t,t.next)>0&&y(e.prev,e,e.next)>0)}function y(t,e,n){return(e.y-t.y)*(n.x-e.x)-(e.x-t.x)*(n.y-e.y)}function v(t,e){return t.x===e.x&&t.y===e.y}function _(t,e,n,r){var i=x(y(t,e,n)),o=x(y(t,e,r)),a=x(y(n,r,t)),s=x(y(n,r,e));return i!==o&&a!==s||(!(0!==i||!b(t,n,e))||(!(0!==o||!b(t,r,e))||(!(0!==a||!b(n,t,r))||!(0!==s||!b(n,e,r)))))}function b(t,e,n){return e.x<=Math.max(t.x,n.x)&&e.x>=Math.min(t.x,n.x)&&e.y<=Math.max(t.y,n.y)&&e.y>=Math.min(t.y,n.y)}function x(t){return t>0?1:t<0?-1:0}function w(t,e){return y(t.prev,t,t.next)<0?y(t,e,t.next)>=0&&y(t,t.prev,e)>=0:y(t,e,t.prev)<0||y(t,t.next,e)<0}function E(t,e){var n=new T(t.i,t.x,t.y),r=new T(e.i,e.x,e.y),i=t.next,o=e.prev;return t.next=e,e.prev=t,n.next=i,i.prev=n,r.next=n,n.prev=r,o.next=r,r.prev=o,r}function O(t,e,n,r){var i=new T(t,e,n);return r?(i.next=r.next,i.prev=r,r.next.prev=i,r.next=i):(i.prev=i,i.next=i),i}function S(t){t.next.prev=t.prev,t.prev.next=t.next,t.prevZ&&(t.prevZ.nextZ=t.nextZ),t.nextZ&&(t.nextZ.prevZ=t.prevZ)}function T(t,e,n){this.i=t,this.x=e,this.y=n,this.prev=null,this.next=null,this.z=0,this.prevZ=null,this.nextZ=null,this.steiner=!1}function C(t,e,n,r){for(var i=0,o=e,a=n-r;o<n;o+=r)i+=(t[a]-t[o])*(t[o+1]+t[a+1]),a=o;return i}t.exports=r,t.exports.default=r,r.deviation=function(t,e,n,r){var i=e&&e.length,o=i?e[0]*n:t.length,a=Math.abs(C(t,0,o,n));if(i)for(var s=0,u=e.length;s<u;s++){var c=e[s]*n,l=s<u-1?e[s+1]*n:t.length;a-=Math.abs(C(t,c,l,n))}var h=0;for(s=0;s<r.length;s+=3){var f=r[s]*n,p=r[s+1]*n,d=r[s+2]*n;h+=Math.abs((t[f]-t[d])*(t[p+1]-t[f+1])-(t[f]-t[p])*(t[d+1]-t[f+1]))}return 0===a&&0===h?0:Math.abs((h-a)/a)},r.flatten=function(t){for(var e=t[0][0].length,n={vertices:[],holes:[],dimensions:e},r=0,i=0;i<t.length;i++){for(var o=0;o<t[i].length;o++)for(var a=0;a<e;a++)n.vertices.push(t[i][o][a]);i>0&&(r+=t[i-1].length,n.holes.push(r))}return n}},function(t,e,n){"use strict";(function(t){n.d(e,"a",(function(){return A}));new Uint8Array([0]);const r=[171,75,84,88,32,50,48,187,13,10,26,10];var i,o,a,s,u,c,l,h;!function(t){t[t.NONE=0]="NONE",t[t.BASISLZ=1]="BASISLZ",t[t.ZSTD=2]="ZSTD",t[t.ZLIB=3]="ZLIB"}(i||(i={})),function(t){t[t.BASICFORMAT=0]="BASICFORMAT"}(o||(o={})),function(t){t[t.UNSPECIFIED=0]="UNSPECIFIED",t[t.ETC1S=163]="ETC1S",t[t.UASTC=166]="UASTC"}(a||(a={})),function(t){t[t.UNSPECIFIED=0]="UNSPECIFIED",t[t.SRGB=1]="SRGB"}(s||(s={})),function(t){t[t.UNSPECIFIED=0]="UNSPECIFIED",t[t.LINEAR=1]="LINEAR",t[t.SRGB=2]="SRGB",t[t.ITU=3]="ITU",t[t.NTSC=4]="NTSC",t[t.SLOG=5]="SLOG",t[t.SLOG2=6]="SLOG2"}(u||(u={})),function(t){t[t.ALPHA_STRAIGHT=0]="ALPHA_STRAIGHT",t[t.ALPHA_PREMULTIPLIED=1]="ALPHA_PREMULTIPLIED"}(c||(c={})),function(t){t[t.RGB=0]="RGB",t[t.RRR=3]="RRR",t[t.GGG=4]="GGG",t[t.AAA=15]="AAA"}(l||(l={})),function(t){t[t.RGB=0]="RGB",t[t.RGBA=3]="RGBA",t[t.RRR=4]="RRR",t[t.RRRG=5]="RRRG"}(h||(h={}));class f{constructor(){this.vkFormat=0,this.typeSize=1,this.pixelWidth=0,this.pixelHeight=0,this.pixelDepth=0,this.layerCount=0,this.faceCount=1,this.supercompressionScheme=i.NONE,this.levels=[],this.dataFormatDescriptor=[{vendorId:0,descriptorType:o.BASICFORMAT,versionNumber:2,descriptorBlockSize:40,colorModel:a.UNSPECIFIED,colorPrimaries:s.SRGB,transferFunction:s.SRGB,flags:c.ALPHA_STRAIGHT,texelBlockDimension:{x:4,y:4,z:1,w:1},bytesPlane:[],samples:[]}],this.keyValue={},this.globalData=null}}class p{constructor(t,e,n,r){this._dataView=new DataView(t.buffer,t.byteOffset+e,n),this._littleEndian=r,this._offset=0}_nextUint8(){const t=this._dataView.getUint8(this._offset);return this._offset+=1,t}_nextUint16(){const t=this._dataView.getUint16(this._offset,this._littleEndian);return this._offset+=2,t}_nextUint32(){const t=this._dataView.getUint32(this._offset,this._littleEndian);return this._offset+=4,t}_nextUint64(){const t=this._dataView.getUint32(this._offset,this._littleEndian)+2**32*this._dataView.getUint32(this._offset+4,this._littleEndian);return this._offset+=8,t}_skip(t){return this._offset+=t,this}_scan(t,e=0){const n=this._offset;let r=0;for(;this._dataView.getUint8(this._offset)!==e&&r<t;)r++,this._offset++;return r<t&&this._offset++,new Uint8Array(this._dataView.buffer,this._dataView.byteOffset+n,r)}}function d(e){return"undefined"!=typeof TextDecoder?(new TextDecoder).decode(e):t.from(e).toString("utf8")}function A(t){const e=new Uint8Array(t.buffer,t.byteOffset,r.length);if(e[0]!==r[0]||e[1]!==r[1]||e[2]!==r[2]||e[3]!==r[3]||e[4]!==r[4]||e[5]!==r[5]||e[6]!==r[6]||e[7]!==r[7]||e[8]!==r[8]||e[9]!==r[9]||e[10]!==r[10]||e[11]!==r[11])throw new Error("Missing KTX 2.0 identifier.");const n=new f,i=17*Uint32Array.BYTES_PER_ELEMENT,o=new p(t,r.length,i,!0);n.vkFormat=o._nextUint32(),n.typeSize=o._nextUint32(),n.pixelWidth=o._nextUint32(),n.pixelHeight=o._nextUint32(),n.pixelDepth=o._nextUint32(),n.layerCount=o._nextUint32(),n.faceCount=o._nextUint32();const a=o._nextUint32();n.supercompressionScheme=o._nextUint32();const s=o._nextUint32(),u=o._nextUint32(),c=o._nextUint32(),l=o._nextUint32(),h=o._nextUint64(),A=o._nextUint64(),g=new p(t,r.length+i,3*a*8,!0);for(let e=0;e<a;e++)n.levels.push({levelData:new Uint8Array(t.buffer,t.byteOffset+g._nextUint64(),g._nextUint64()),uncompressedByteLength:g._nextUint64()});const m=new p(t,s,u,!0),y={vendorId:m._skip(4)._nextUint16(),descriptorType:m._nextUint16(),versionNumber:m._nextUint16(),descriptorBlockSize:m._nextUint16(),colorModel:m._nextUint8(),colorPrimaries:m._nextUint8(),transferFunction:m._nextUint8(),flags:m._nextUint8(),texelBlockDimension:{x:m._nextUint8()+1,y:m._nextUint8()+1,z:m._nextUint8()+1,w:m._nextUint8()+1},bytesPlane:[m._nextUint8(),m._nextUint8(),m._nextUint8(),m._nextUint8(),m._nextUint8(),m._nextUint8(),m._nextUint8(),m._nextUint8()],samples:[]},v=(y.descriptorBlockSize/4-6)/4;for(let t=0;t<v;t++)y.samples[t]={bitOffset:m._nextUint16(),bitLength:m._nextUint8(),channelID:m._nextUint8(),samplePosition:[m._nextUint8(),m._nextUint8(),m._nextUint8(),m._nextUint8()],sampleLower:m._nextUint32(),sampleUpper:m._nextUint32()};n.dataFormatDescriptor.length=0,n.dataFormatDescriptor.push(y);const _=new p(t,c,l,!0);for(;_._offset<l;){const t=_._nextUint32(),e=_._scan(t),r=d(e),i=_._scan(t-e.byteLength);n.keyValue[r]=r.match(/^ktx/i)?d(i):i,t%4&&_._skip(4-t%4)}if(A<=0)return n;const b=new p(t,h,A,!0),x=b._nextUint16(),w=b._nextUint16(),E=b._nextUint32(),O=b._nextUint32(),S=b._nextUint32(),T=b._nextUint32(),C=[];for(let t=0;t<a;t++)C.push({imageFlags:b._nextUint32(),rgbSliceByteOffset:b._nextUint32(),rgbSliceByteLength:b._nextUint32(),alphaSliceByteOffset:b._nextUint32(),alphaSliceByteLength:b._nextUint32()});const P=h+b._offset,M=P+E,I=M+O,B=I+S,R=new Uint8Array(t.buffer,t.byteOffset+P,E),k=new Uint8Array(t.buffer,t.byteOffset+M,O),D=new Uint8Array(t.buffer,t.byteOffset+I,S),L=new Uint8Array(t.buffer,t.byteOffset+B,T);return n.globalData={endpointCount:x,selectorCount:w,imageDescs:C,endpointsData:R,selectorsData:k,tablesData:D,extendedData:L},n}}).call(this,n(282).Buffer)},function(t,e,n){"use strict";n.d(e,"a",(function(){return s}));var r=n(251),i=n(189),o=n(107),a=n(7);class s{constructor(t,e){let{attributes:n,material:o,pbrDebug:a,imageBasedLightingEnvironment:s,lights:u,useTangents:c}=e;this.gl=t,this.defines={MANUAL_SRGB:1,SRGB_FAST_APPROXIMATION:1},Object(r.b)(t,i.a.GLSL_TEXTURE_LOD)&&(this.defines.USE_TEX_LOD=1),this.uniforms={u_Camera:[0,0,0],u_MetallicRoughnessValues:[1,1]},this.parameters={},this.generatedTextures=[],s&&(this.uniforms.u_DiffuseEnvSampler=s.getDiffuseEnvSampler(),this.uniforms.u_SpecularEnvSampler=s.getSpecularEnvSampler(),this.uniforms.u_brdfLUT=s.getBrdfTexture(),this.uniforms.u_ScaleIBLAmbient=[1,1]),a&&(this.uniforms.u_ScaleDiffBaseMR=[0,0,0,0],this.uniforms.u_ScaleFGDSpec=[0,0,0,0]),this.defineIfPresent(n.NORMAL,"HAS_NORMALS"),this.defineIfPresent(n.TANGENT&&c,"HAS_TANGENTS"),this.defineIfPresent(n.TEXCOORD_0,"HAS_UV"),this.defineIfPresent(s,"USE_IBL"),this.defineIfPresent(u,"USE_LIGHTS"),this.defineIfPresent(a,"PBR_DEBUG"),o&&this.parseMaterial(o)}defineIfPresent(t,e){t&&(this.defines[e]=1)}parseTexture(t,e){let n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:null;const r=t.texture&&t.texture.sampler&&t.texture.sampler.parameters||{},i=t.texture.source.image;let a,s={};i.compressed?(a=i,s={[this.gl.TEXTURE_MIN_FILTER]:i.data.length>1?this.gl.LINEAR_MIPMAP_NEAREST:this.gl.LINEAR}):a={data:i};const u=new o.a(this.gl,{id:t.name||t.id,parameters:{...r,...s},pixelStore:{[this.gl.UNPACK_FLIP_Y_WEBGL]:!1},...a});this.uniforms[e]=u,this.defineIfPresent(n,n),this.generatedTextures.push(u)}parsePbrMetallicRoughness(t){t.baseColorTexture&&this.parseTexture(t.baseColorTexture,"u_BaseColorSampler","HAS_BASECOLORMAP"),this.uniforms.u_BaseColorFactor=t.baseColorFactor||[1,1,1,1],t.metallicRoughnessTexture&&this.parseTexture(t.metallicRoughnessTexture,"u_MetallicRoughnessSampler","HAS_METALROUGHNESSMAP");const{metallicFactor:e=1,roughnessFactor:n=1}=t;this.uniforms.u_MetallicRoughnessValues=[e,n]}parseMaterial(t){if(this.uniforms.pbr_uUnlit=Boolean(t.unlit),t.pbrMetallicRoughness&&this.parsePbrMetallicRoughness(t.pbrMetallicRoughness),t.normalTexture){this.parseTexture(t.normalTexture,"u_NormalSampler","HAS_NORMALMAP");const{scale:e=1}=t.normalTexture;this.uniforms.u_NormalScale=e}if(t.occlusionTexture){this.parseTexture(t.occlusionTexture,"u_OcclusionSampler","HAS_OCCLUSIONMAP");const{strength:e=1}=t.occlusionTexture;this.uniforms.u_OcclusionStrength=e}if(t.emissiveTexture&&(this.parseTexture(t.emissiveTexture,"u_EmissiveSampler","HAS_EMISSIVEMAP"),this.uniforms.u_EmissiveFactor=t.emissiveFactor||[0,0,0]),"MASK"===t.alphaMode){const{alphaCutoff:e=.5}=t;this.defines.ALPHA_CUTOFF=1,this.uniforms.u_AlphaCutoff=e}else"BLEND"===t.alphaMode&&(a.k.warn("BLEND alphaMode might not work well because it requires mesh sorting")(),Object.assign(this.parameters,{blend:!0,blendEquation:this.gl.FUNC_ADD,blendFunc:[this.gl.SRC_ALPHA,this.gl.ONE_MINUS_SRC_ALPHA,this.gl.ONE,this.gl.ONE_MINUS_SRC_ALPHA]}))}delete(){this.generatedTextures.forEach(t=>t.delete())}}},function(t,e,n){"use strict";(function(t){n.d(e,"a",(function(){return i}));var r=n(249);function i(){return!("object"==typeof t&&"[object process]"===String(t)&&!t.browser)||Object(r.a)()}}).call(this,n(44))},function(t,e,n){"use strict";(function(t){function r(e){if("undefined"!=typeof window&&"object"==typeof window.process&&"renderer"===window.process.type)return!0;if(void 0!==t&&"object"==typeof t.versions&&Boolean(t.versions.electron))return!0;const n="object"==typeof navigator&&"string"==typeof navigator.userAgent&&navigator.userAgent,r=e||n;return!!(r&&r.indexOf("Electron")>=0)}n.d(e,"a",(function(){return r}))}).call(this,n(44))},function(t,e,n){var r=n(287),i=n(288),o=n(289),a=n(290);t.exports=function(t){return r(t)||i(t)||o(t)||a()},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){"use strict";n.d(e,"b",(function(){return a})),n.d(e,"c",(function(){return s})),n.d(e,"a",(function(){return u}));var r=n(189),i=n(7),o=n(10);function a(t,e){return s(t,e)}function s(t,e){return(e=Array.isArray(e)?e:[e]).every(e=>c(t,e))}function u(t){t.luma=t.luma||{},t.luma.caps=t.luma.caps||{};for(const e in r.b)void 0===t.luma.caps[e]&&(t.luma.caps[e]=c(t,e));return t.luma.caps}function c(t,e){return t.luma=t.luma||{},t.luma.caps=t.luma.caps||{},void 0===t.luma.caps[e]&&(t.luma.caps[e]=function(t,e){const n=r.b[e];let a;Object(o.a)(n,e);const s=Object(i.j)(t)&&n[1]||n[0];if("function"==typeof s)a=s(t);else if(Array.isArray(s)){a=!0;for(const e of s)a=a&&Boolean(t.getExtension(e))}else"string"==typeof s?a=Boolean(t.getExtension(s)):"boolean"==typeof s?a=s:Object(o.a)(!1);return a}(t,e)),t.luma.caps[e]||i.k.log(2,"Feature: ".concat(e," not supported"))(),t.luma.caps[e]}},,,,,,,,,function(t,e,n){var r=document.body&&document.body.getAttribute("data-base-url");r&&(window.__webpack_public_path__="".concat(r,"nbextensions/pydeck/nb_extension"));var i=n(197).default.jupyterTransport,o=null,a=null;try{o=n(295).default,a=n(265).default}catch(t){}var s=n(128),u=s.MODULE_VERSION,c=s.MODULE_NAME,l=n(87),h=l.createDeck,f=l.updateDeck,p=n(296).initPlayground;p(),t.exports={jupyterTransport:i,MODULE_VERSION:u,MODULE_NAME:c,JupyterTransportModel:o,JupyterTransportView:a,initPlayground:p,createDeck:h,updateDeck:f}},function(t,e,n){var r=n(194).default;t.exports=function(t,e){if("object"!==r(t)||null===t)return t;var n=t[Symbol.toPrimitive];if(void 0!==n){var i=n.call(t,e||"default");if("object"!==r(i))return i;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===e?String:Number)(t)},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e){function n(e,r){return t.exports=n=Object.setPrototypeOf?Object.setPrototypeOf.bind():function(t,e){return t.__proto__=e,t},t.exports.__esModule=!0,t.exports.default=t.exports,n(e,r)}t.exports=n,t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e){t.exports=function(t){if(void 0===t)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return t},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){var r=n(56);t.exports=function(t,e){for(;!Object.prototype.hasOwnProperty.call(t,e)&&null!==(t=r(t)););return t},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){"use strict";n.r(e),n.d(e,"default",(function(){return y}));var r=n(88),i=n.n(r),o=n(89),a=n.n(o),s=n(140),u=n.n(s),c=n(119),l=n.n(c),h=n(120),f=n.n(h),p=n(56),d=n.n(p),A=n(141),g=n(197);function m(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}var y=function(t){l()(n,t);var e=m(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"initialize",value:function(){this.listenTo(this.model,"destroy",this.remove),this.transport=new g.default,this.transport.jupyterModel=this.model,this.transport.jupyterView=this,this.transport._initialize(),u()(d()(n.prototype),"initialize",this).apply(this,arguments)}},{key:"remove",value:function(){this.transport&&(this.transport._finalize(),this.transport.jupyterModel=null,this.transport.jupyterView=null,this.transport=null)}},{key:"render",value:function(){u()(d()(n.prototype),"render",this).call(this),this.model.on("change:json_input",this.onJsonChanged.bind(this)),this.model.on("change:data_buffer",this.onDataBufferChanged.bind(this)),this.onDataBufferChanged()}},{key:"onJsonChanged",value:function(){var t=JSON.parse(this.model.get("json_input"));this.transport._messageReceived({type:"json",json:t})}},{key:"onDataBufferChanged",value:function(){var t=this.model.get("json_input"),e=this.model.get("data_buffer");t&&e?this.transport._messageReceived({type:"json-with-binary",json:t,binary:e}):this.transport._messageReceived({type:"json",json:t})}}]),n}(A.DOMWidgetView)},function(t,e,n){(function(e){const r=n(293),i=n(16),o=n(278).default,{registerLoaders:a,load:s,parse:u,fetchFile:c}=n(65),l="undefined"==typeof window?e:window;l.deck=l.deck||{},l.luma=l.luma||{},l.loaders=l.loaders||{},Object.assign(l.deck,i,{DeckGL:o}),Object.assign(l.luma,r),Object.assign(l.loaders,{registerLoaders:a,load:s,parse:u,fetchFile:c}),t.exports=l.deck}).call(this,n(71))},function(t,e){},function(t,e){t.exports=function(t){if(Array.isArray(t)){for(var e=0,n=new Array(t.length);e<t.length;e++)n[e]=t[e];return n}}},function(t,e){t.exports=function(t){if(Symbol.iterator in Object(t)||"[object Arguments]"===Object.prototype.toString.call(t))return Array.from(t)}},function(t,e){t.exports=function(){throw new TypeError("Invalid attempt to spread non-iterable instance")}},function(t,e){t.exports=function(t){if(Array.isArray(t))return t}},function(t,e){t.exports=function(t,e){if(Symbol.iterator in Object(t)||"[object Arguments]"===Object.prototype.toString.call(t)){var n=[],r=!0,i=!1,o=void 0;try{for(var a,s=t[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!e||n.length!==e);r=!0);}catch(t){i=!0,o=t}finally{try{r||null==s.return||s.return()}finally{if(i)throw o}}return n}}},function(t,e){t.exports=function(){throw new TypeError("Invalid attempt to destructure non-iterable instance")}},function(t,e,n){var r=n(1);t.exports=function(t,e){for(;!Object.prototype.hasOwnProperty.call(t,e)&&null!==(t=r(t)););return t}},function(t,e){function n(e,r){return t.exports=n=Object.setPrototypeOf||function(t,e){return t.__proto__=e,t},n(e,r)}t.exports=n},function(t,e){},function(t,e,n){var r=function(t){"use strict";var e=Object.prototype,n=e.hasOwnProperty,r="function"==typeof Symbol?Symbol:{},i=r.iterator||"@@iterator",o=r.asyncIterator||"@@asyncIterator",a=r.toStringTag||"@@toStringTag";function s(t,e,n,r){var i=e&&e.prototype instanceof l?e:l,o=Object.create(i.prototype),a=new x(r||[]);return o._invoke=function(t,e,n){var r="suspendedStart";return function(i,o){if("executing"===r)throw new Error("Generator is already running");if("completed"===r){if("throw"===i)throw o;return E()}for(n.method=i,n.arg=o;;){var a=n.delegate;if(a){var s=v(a,n);if(s){if(s===c)continue;return s}}if("next"===n.method)n.sent=n._sent=n.arg;else if("throw"===n.method){if("suspendedStart"===r)throw r="completed",n.arg;n.dispatchException(n.arg)}else"return"===n.method&&n.abrupt("return",n.arg);r="executing";var l=u(t,e,n);if("normal"===l.type){if(r=n.done?"completed":"suspendedYield",l.arg===c)continue;return{value:l.arg,done:n.done}}"throw"===l.type&&(r="completed",n.method="throw",n.arg=l.arg)}}}(t,n,a),o}function u(t,e,n){try{return{type:"normal",arg:t.call(e,n)}}catch(t){return{type:"throw",arg:t}}}t.wrap=s;var c={};function l(){}function h(){}function f(){}var p={};p[i]=function(){return this};var d=Object.getPrototypeOf,A=d&&d(d(w([])));A&&A!==e&&n.call(A,i)&&(p=A);var g=f.prototype=l.prototype=Object.create(p);function m(t){["next","throw","return"].forEach((function(e){t[e]=function(t){return this._invoke(e,t)}}))}function y(t){var e;this._invoke=function(r,i){function o(){return new Promise((function(e,o){!function e(r,i,o,a){var s=u(t[r],t,i);if("throw"!==s.type){var c=s.arg,l=c.value;return l&&"object"==typeof l&&n.call(l,"__await")?Promise.resolve(l.__await).then((function(t){e("next",t,o,a)}),(function(t){e("throw",t,o,a)})):Promise.resolve(l).then((function(t){c.value=t,o(c)}),(function(t){return e("throw",t,o,a)}))}a(s.arg)}(r,i,e,o)}))}return e=e?e.then(o,o):o()}}function v(t,e){var n=t.iterator[e.method];if(void 0===n){if(e.delegate=null,"throw"===e.method){if(t.iterator.return&&(e.method="return",e.arg=void 0,v(t,e),"throw"===e.method))return c;e.method="throw",e.arg=new TypeError("The iterator does not provide a 'throw' method")}return c}var r=u(n,t.iterator,e.arg);if("throw"===r.type)return e.method="throw",e.arg=r.arg,e.delegate=null,c;var i=r.arg;return i?i.done?(e[t.resultName]=i.value,e.next=t.nextLoc,"return"!==e.method&&(e.method="next",e.arg=void 0),e.delegate=null,c):i:(e.method="throw",e.arg=new TypeError("iterator result is not an object"),e.delegate=null,c)}function _(t){var e={tryLoc:t[0]};1 in t&&(e.catchLoc=t[1]),2 in t&&(e.finallyLoc=t[2],e.afterLoc=t[3]),this.tryEntries.push(e)}function b(t){var e=t.completion||{};e.type="normal",delete e.arg,t.completion=e}function x(t){this.tryEntries=[{tryLoc:"root"}],t.forEach(_,this),this.reset(!0)}function w(t){if(t){var e=t[i];if(e)return e.call(t);if("function"==typeof t.next)return t;if(!isNaN(t.length)){var r=-1,o=function e(){for(;++r<t.length;)if(n.call(t,r))return e.value=t[r],e.done=!1,e;return e.value=void 0,e.done=!0,e};return o.next=o}}return{next:E}}function E(){return{value:void 0,done:!0}}return h.prototype=g.constructor=f,f.constructor=h,f[a]=h.displayName="GeneratorFunction",t.isGeneratorFunction=function(t){var e="function"==typeof t&&t.constructor;return!!e&&(e===h||"GeneratorFunction"===(e.displayName||e.name))},t.mark=function(t){return Object.setPrototypeOf?Object.setPrototypeOf(t,f):(t.__proto__=f,a in t||(t[a]="GeneratorFunction")),t.prototype=Object.create(g),t},t.awrap=function(t){return{__await:t}},m(y.prototype),y.prototype[o]=function(){return this},t.AsyncIterator=y,t.async=function(e,n,r,i){var o=new y(s(e,n,r,i));return t.isGeneratorFunction(n)?o:o.next().then((function(t){return t.done?t.value:o.next()}))},m(g),g[a]="Generator",g[i]=function(){return this},g.toString=function(){return"[object Generator]"},t.keys=function(t){var e=[];for(var n in t)e.push(n);return e.reverse(),function n(){for(;e.length;){var r=e.pop();if(r in t)return n.value=r,n.done=!1,n}return n.done=!0,n}},t.values=w,x.prototype={constructor:x,reset:function(t){if(this.prev=0,this.next=0,this.sent=this._sent=void 0,this.done=!1,this.delegate=null,this.method="next",this.arg=void 0,this.tryEntries.forEach(b),!t)for(var e in this)"t"===e.charAt(0)&&n.call(this,e)&&!isNaN(+e.slice(1))&&(this[e]=void 0)},stop:function(){this.done=!0;var t=this.tryEntries[0].completion;if("throw"===t.type)throw t.arg;return this.rval},dispatchException:function(t){if(this.done)throw t;var e=this;function r(n,r){return a.type="throw",a.arg=t,e.next=n,r&&(e.method="next",e.arg=void 0),!!r}for(var i=this.tryEntries.length-1;i>=0;--i){var o=this.tryEntries[i],a=o.completion;if("root"===o.tryLoc)return r("end");if(o.tryLoc<=this.prev){var s=n.call(o,"catchLoc"),u=n.call(o,"finallyLoc");if(s&&u){if(this.prev<o.catchLoc)return r(o.catchLoc,!0);if(this.prev<o.finallyLoc)return r(o.finallyLoc)}else if(s){if(this.prev<o.catchLoc)return r(o.catchLoc,!0)}else{if(!u)throw new Error("try statement without catch or finally");if(this.prev<o.finallyLoc)return r(o.finallyLoc)}}}},abrupt:function(t,e){for(var r=this.tryEntries.length-1;r>=0;--r){var i=this.tryEntries[r];if(i.tryLoc<=this.prev&&n.call(i,"finallyLoc")&&this.prev<i.finallyLoc){var o=i;break}}o&&("break"===t||"continue"===t)&&o.tryLoc<=e&&e<=o.finallyLoc&&(o=null);var a=o?o.completion:{};return a.type=t,a.arg=e,o?(this.method="next",this.next=o.finallyLoc,c):this.complete(a)},complete:function(t,e){if("throw"===t.type)throw t.arg;return"break"===t.type||"continue"===t.type?this.next=t.arg:"return"===t.type?(this.rval=this.arg=t.arg,this.method="return",this.next="end"):"normal"===t.type&&e&&(this.next=e),c},finish:function(t){for(var e=this.tryEntries.length-1;e>=0;--e){var n=this.tryEntries[e];if(n.finallyLoc===t)return this.complete(n.completion,n.afterLoc),b(n),c}},catch:function(t){for(var e=this.tryEntries.length-1;e>=0;--e){var n=this.tryEntries[e];if(n.tryLoc===t){var r=n.completion;if("throw"===r.type){var i=r.arg;b(n)}return i}}throw new Error("illegal catch attempt")},delegateYield:function(t,e,n){return this.delegate={iterator:w(t),resultName:e,nextLoc:n},"next"===this.method&&(this.arg=void 0),c}},t}(t.exports);try{regeneratorRuntime=r}catch(t){Function("r","regeneratorRuntime = r")(r)}},function(t,e,n){"use strict";n.r(e),n.d(e,"default",(function(){return a}));var r=n(242),i=n(199);const o={position:"absolute",left:0,top:0,width:"100%",height:"100%"};class a extends i.a{constructor(t={}){if("undefined"==typeof document)throw Error("Deck can only be used in the browser");const{mapCanvas:e,deckCanvas:n}=function(t){let{container:e=document.body}=t;if("string"==typeof e&&(e=document.getElementById(e)),!e)throw Error("Deck: container not found");"static"===window.getComputedStyle(e).position&&(e.style.position="relative");const n=document.createElement("div");e.appendChild(n),Object.assign(n.style,o);const r=document.createElement("canvas");return e.appendChild(r),Object.assign(r.style,o),{container:e,mapCanvas:n,deckCanvas:r}}(t),i=t.viewState||t.initialViewState,a=Number.isFinite(i&&i.latitude),{map:s=window.mapboxgl}=t;super({canvas:n,...t}),s&&s.Map?this._map=a&&new r.a({...t,viewState:i,container:e,mapboxgl:s}):this._map=s,this._onBeforeRender=t=>{if(this.onBeforeRender(t),this._map){const t=this.getViewports()[0];this._map.setProps({width:t.width,height:t.height,viewState:t})}}}getMapboxMap(){return this._map&&this._map.getMap()}finalize(){this._map&&this._map.finalize(),super.finalize()}setProps(t){"onBeforeRender"in t&&this._onBeforeRender&&t.onBeforeRender!==this._onBeforeRender&&(this.onBeforeRender=t.onBeforeRender,t.onBeforeRender=this._onBeforeRender),"mapStyle"in t&&this._map&&this._map._map.setStyle(t.mapStyle),super.setProps(t)}}},function(t,e,n){"use strict";var r=n(280);function i(){}function o(){}o.resetWarningCache=i,t.exports=function(){function t(t,e,n,i,o,a){if(a!==r){var s=new Error("Calling PropTypes validators directly is not supported by the `prop-types` package. Use PropTypes.checkPropTypes() to call them. Read more at http://fb.me/use-check-prop-types");throw s.name="Invariant Violation",s}}function e(){return t}t.isRequired=t;var n={array:t,bool:t,func:t,number:t,object:t,string:t,symbol:t,any:t,arrayOf:e,element:t,elementType:t,instanceOf:e,node:t,objectOf:e,oneOf:e,oneOfType:e,shape:e,exact:e,checkPropTypes:o,resetWarningCache:i};return n.PropTypes=n,n}},function(t,e,n){"use strict";t.exports="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED"},function(t,e){t.exports=function(t,e){if(null==t)return{};var n,r,i={},o=Object.keys(t);for(r=0;r<o.length;r++)n=o[r],e.indexOf(n)>=0||(i[n]=t[n]);return i}},function(t,e,n){"use strict";(function(t){
+/*!
+ * The buffer module from node.js, for the browser.
+ *
+ * @author   Feross Aboukhadijeh <http://feross.org>
+ * @license  MIT
+ */
+var r=n(283),i=n(226),o=n(284);function a(){return u.TYPED_ARRAY_SUPPORT?2147483647:1073741823}function s(t,e){if(a()<e)throw new RangeError("Invalid typed array length");return u.TYPED_ARRAY_SUPPORT?(t=new Uint8Array(e)).__proto__=u.prototype:(null===t&&(t=new u(e)),t.length=e),t}function u(t,e,n){if(!(u.TYPED_ARRAY_SUPPORT||this instanceof u))return new u(t,e,n);if("number"==typeof t){if("string"==typeof e)throw new Error("If encoding is specified then the first argument must be a string");return h(this,t)}return c(this,t,e,n)}function c(t,e,n,r){if("number"==typeof e)throw new TypeError('"value" argument must not be a number');return"undefined"!=typeof ArrayBuffer&&e instanceof ArrayBuffer?function(t,e,n,r){if(e.byteLength,n<0||e.byteLength<n)throw new RangeError("'offset' is out of bounds");if(e.byteLength<n+(r||0))throw new RangeError("'length' is out of bounds");e=void 0===n&&void 0===r?new Uint8Array(e):void 0===r?new Uint8Array(e,n):new Uint8Array(e,n,r);u.TYPED_ARRAY_SUPPORT?(t=e).__proto__=u.prototype:t=f(t,e);return t}(t,e,n,r):"string"==typeof e?function(t,e,n){"string"==typeof n&&""!==n||(n="utf8");if(!u.isEncoding(n))throw new TypeError('"encoding" must be a valid string encoding');var r=0|d(e,n),i=(t=s(t,r)).write(e,n);i!==r&&(t=t.slice(0,i));return t}(t,e,n):function(t,e){if(u.isBuffer(e)){var n=0|p(e.length);return 0===(t=s(t,n)).length||e.copy(t,0,0,n),t}if(e){if("undefined"!=typeof ArrayBuffer&&e.buffer instanceof ArrayBuffer||"length"in e)return"number"!=typeof e.length||(r=e.length)!=r?s(t,0):f(t,e);if("Buffer"===e.type&&o(e.data))return f(t,e.data)}var r;throw new TypeError("First argument must be a string, Buffer, ArrayBuffer, Array, or array-like object.")}(t,e)}function l(t){if("number"!=typeof t)throw new TypeError('"size" argument must be a number');if(t<0)throw new RangeError('"size" argument must not be negative')}function h(t,e){if(l(e),t=s(t,e<0?0:0|p(e)),!u.TYPED_ARRAY_SUPPORT)for(var n=0;n<e;++n)t[n]=0;return t}function f(t,e){var n=e.length<0?0:0|p(e.length);t=s(t,n);for(var r=0;r<n;r+=1)t[r]=255&e[r];return t}function p(t){if(t>=a())throw new RangeError("Attempt to allocate Buffer larger than maximum size: 0x"+a().toString(16)+" bytes");return 0|t}function d(t,e){if(u.isBuffer(t))return t.length;if("undefined"!=typeof ArrayBuffer&&"function"==typeof ArrayBuffer.isView&&(ArrayBuffer.isView(t)||t instanceof ArrayBuffer))return t.byteLength;"string"!=typeof t&&(t=""+t);var n=t.length;if(0===n)return 0;for(var r=!1;;)switch(e){case"ascii":case"latin1":case"binary":return n;case"utf8":case"utf-8":case void 0:return U(t).length;case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return 2*n;case"hex":return n>>>1;case"base64":return N(t).length;default:if(r)return U(t).length;e=(""+e).toLowerCase(),r=!0}}function A(t,e,n){var r=!1;if((void 0===e||e<0)&&(e=0),e>this.length)return"";if((void 0===n||n>this.length)&&(n=this.length),n<=0)return"";if((n>>>=0)<=(e>>>=0))return"";for(t||(t="utf8");;)switch(t){case"hex":return P(this,e,n);case"utf8":case"utf-8":return S(this,e,n);case"ascii":return T(this,e,n);case"latin1":case"binary":return C(this,e,n);case"base64":return O(this,e,n);case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return M(this,e,n);default:if(r)throw new TypeError("Unknown encoding: "+t);t=(t+"").toLowerCase(),r=!0}}function g(t,e,n){var r=t[e];t[e]=t[n],t[n]=r}function m(t,e,n,r,i){if(0===t.length)return-1;if("string"==typeof n?(r=n,n=0):n>2147483647?n=2147483647:n<-2147483648&&(n=-2147483648),n=+n,isNaN(n)&&(n=i?0:t.length-1),n<0&&(n=t.length+n),n>=t.length){if(i)return-1;n=t.length-1}else if(n<0){if(!i)return-1;n=0}if("string"==typeof e&&(e=u.from(e,r)),u.isBuffer(e))return 0===e.length?-1:y(t,e,n,r,i);if("number"==typeof e)return e&=255,u.TYPED_ARRAY_SUPPORT&&"function"==typeof Uint8Array.prototype.indexOf?i?Uint8Array.prototype.indexOf.call(t,e,n):Uint8Array.prototype.lastIndexOf.call(t,e,n):y(t,[e],n,r,i);throw new TypeError("val must be string, number or Buffer")}function y(t,e,n,r,i){var o,a=1,s=t.length,u=e.length;if(void 0!==r&&("ucs2"===(r=String(r).toLowerCase())||"ucs-2"===r||"utf16le"===r||"utf-16le"===r)){if(t.length<2||e.length<2)return-1;a=2,s/=2,u/=2,n/=2}function c(t,e){return 1===a?t[e]:t.readUInt16BE(e*a)}if(i){var l=-1;for(o=n;o<s;o++)if(c(t,o)===c(e,-1===l?0:o-l)){if(-1===l&&(l=o),o-l+1===u)return l*a}else-1!==l&&(o-=o-l),l=-1}else for(n+u>s&&(n=s-u),o=n;o>=0;o--){for(var h=!0,f=0;f<u;f++)if(c(t,o+f)!==c(e,f)){h=!1;break}if(h)return o}return-1}function v(t,e,n,r){n=Number(n)||0;var i=t.length-n;r?(r=Number(r))>i&&(r=i):r=i;var o=e.length;if(o%2!=0)throw new TypeError("Invalid hex string");r>o/2&&(r=o/2);for(var a=0;a<r;++a){var s=parseInt(e.substr(2*a,2),16);if(isNaN(s))return a;t[n+a]=s}return a}function _(t,e,n,r){return G(U(e,t.length-n),t,n,r)}function b(t,e,n,r){return G(function(t){for(var e=[],n=0;n<t.length;++n)e.push(255&t.charCodeAt(n));return e}(e),t,n,r)}function x(t,e,n,r){return b(t,e,n,r)}function w(t,e,n,r){return G(N(e),t,n,r)}function E(t,e,n,r){return G(function(t,e){for(var n,r,i,o=[],a=0;a<t.length&&!((e-=2)<0);++a)n=t.charCodeAt(a),r=n>>8,i=n%256,o.push(i),o.push(r);return o}(e,t.length-n),t,n,r)}function O(t,e,n){return 0===e&&n===t.length?r.fromByteArray(t):r.fromByteArray(t.slice(e,n))}function S(t,e,n){n=Math.min(t.length,n);for(var r=[],i=e;i<n;){var o,a,s,u,c=t[i],l=null,h=c>239?4:c>223?3:c>191?2:1;if(i+h<=n)switch(h){case 1:c<128&&(l=c);break;case 2:128==(192&(o=t[i+1]))&&(u=(31&c)<<6|63&o)>127&&(l=u);break;case 3:o=t[i+1],a=t[i+2],128==(192&o)&&128==(192&a)&&(u=(15&c)<<12|(63&o)<<6|63&a)>2047&&(u<55296||u>57343)&&(l=u);break;case 4:o=t[i+1],a=t[i+2],s=t[i+3],128==(192&o)&&128==(192&a)&&128==(192&s)&&(u=(15&c)<<18|(63&o)<<12|(63&a)<<6|63&s)>65535&&u<1114112&&(l=u)}null===l?(l=65533,h=1):l>65535&&(l-=65536,r.push(l>>>10&1023|55296),l=56320|1023&l),r.push(l),i+=h}return function(t){var e=t.length;if(e<=4096)return String.fromCharCode.apply(String,t);var n="",r=0;for(;r<e;)n+=String.fromCharCode.apply(String,t.slice(r,r+=4096));return n}(r)}e.Buffer=u,e.SlowBuffer=function(t){+t!=t&&(t=0);return u.alloc(+t)},e.INSPECT_MAX_BYTES=50,u.TYPED_ARRAY_SUPPORT=void 0!==t.TYPED_ARRAY_SUPPORT?t.TYPED_ARRAY_SUPPORT:function(){try{var t=new Uint8Array(1);return t.__proto__={__proto__:Uint8Array.prototype,foo:function(){return 42}},42===t.foo()&&"function"==typeof t.subarray&&0===t.subarray(1,1).byteLength}catch(t){return!1}}(),e.kMaxLength=a(),u.poolSize=8192,u._augment=function(t){return t.__proto__=u.prototype,t},u.from=function(t,e,n){return c(null,t,e,n)},u.TYPED_ARRAY_SUPPORT&&(u.prototype.__proto__=Uint8Array.prototype,u.__proto__=Uint8Array,"undefined"!=typeof Symbol&&Symbol.species&&u[Symbol.species]===u&&Object.defineProperty(u,Symbol.species,{value:null,configurable:!0})),u.alloc=function(t,e,n){return function(t,e,n,r){return l(e),e<=0?s(t,e):void 0!==n?"string"==typeof r?s(t,e).fill(n,r):s(t,e).fill(n):s(t,e)}(null,t,e,n)},u.allocUnsafe=function(t){return h(null,t)},u.allocUnsafeSlow=function(t){return h(null,t)},u.isBuffer=function(t){return!(null==t||!t._isBuffer)},u.compare=function(t,e){if(!u.isBuffer(t)||!u.isBuffer(e))throw new TypeError("Arguments must be Buffers");if(t===e)return 0;for(var n=t.length,r=e.length,i=0,o=Math.min(n,r);i<o;++i)if(t[i]!==e[i]){n=t[i],r=e[i];break}return n<r?-1:r<n?1:0},u.isEncoding=function(t){switch(String(t).toLowerCase()){case"hex":case"utf8":case"utf-8":case"ascii":case"latin1":case"binary":case"base64":case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return!0;default:return!1}},u.concat=function(t,e){if(!o(t))throw new TypeError('"list" argument must be an Array of Buffers');if(0===t.length)return u.alloc(0);var n;if(void 0===e)for(e=0,n=0;n<t.length;++n)e+=t[n].length;var r=u.allocUnsafe(e),i=0;for(n=0;n<t.length;++n){var a=t[n];if(!u.isBuffer(a))throw new TypeError('"list" argument must be an Array of Buffers');a.copy(r,i),i+=a.length}return r},u.byteLength=d,u.prototype._isBuffer=!0,u.prototype.swap16=function(){var t=this.length;if(t%2!=0)throw new RangeError("Buffer size must be a multiple of 16-bits");for(var e=0;e<t;e+=2)g(this,e,e+1);return this},u.prototype.swap32=function(){var t=this.length;if(t%4!=0)throw new RangeError("Buffer size must be a multiple of 32-bits");for(var e=0;e<t;e+=4)g(this,e,e+3),g(this,e+1,e+2);return this},u.prototype.swap64=function(){var t=this.length;if(t%8!=0)throw new RangeError("Buffer size must be a multiple of 64-bits");for(var e=0;e<t;e+=8)g(this,e,e+7),g(this,e+1,e+6),g(this,e+2,e+5),g(this,e+3,e+4);return this},u.prototype.toString=function(){var t=0|this.length;return 0===t?"":0===arguments.length?S(this,0,t):A.apply(this,arguments)},u.prototype.equals=function(t){if(!u.isBuffer(t))throw new TypeError("Argument must be a Buffer");return this===t||0===u.compare(this,t)},u.prototype.inspect=function(){var t="",n=e.INSPECT_MAX_BYTES;return this.length>0&&(t=this.toString("hex",0,n).match(/.{2}/g).join(" "),this.length>n&&(t+=" ... ")),"<Buffer "+t+">"},u.prototype.compare=function(t,e,n,r,i){if(!u.isBuffer(t))throw new TypeError("Argument must be a Buffer");if(void 0===e&&(e=0),void 0===n&&(n=t?t.length:0),void 0===r&&(r=0),void 0===i&&(i=this.length),e<0||n>t.length||r<0||i>this.length)throw new RangeError("out of range index");if(r>=i&&e>=n)return 0;if(r>=i)return-1;if(e>=n)return 1;if(this===t)return 0;for(var o=(i>>>=0)-(r>>>=0),a=(n>>>=0)-(e>>>=0),s=Math.min(o,a),c=this.slice(r,i),l=t.slice(e,n),h=0;h<s;++h)if(c[h]!==l[h]){o=c[h],a=l[h];break}return o<a?-1:a<o?1:0},u.prototype.includes=function(t,e,n){return-1!==this.indexOf(t,e,n)},u.prototype.indexOf=function(t,e,n){return m(this,t,e,n,!0)},u.prototype.lastIndexOf=function(t,e,n){return m(this,t,e,n,!1)},u.prototype.write=function(t,e,n,r){if(void 0===e)r="utf8",n=this.length,e=0;else if(void 0===n&&"string"==typeof e)r=e,n=this.length,e=0;else{if(!isFinite(e))throw new Error("Buffer.write(string, encoding, offset[, length]) is no longer supported");e|=0,isFinite(n)?(n|=0,void 0===r&&(r="utf8")):(r=n,n=void 0)}var i=this.length-e;if((void 0===n||n>i)&&(n=i),t.length>0&&(n<0||e<0)||e>this.length)throw new RangeError("Attempt to write outside buffer bounds");r||(r="utf8");for(var o=!1;;)switch(r){case"hex":return v(this,t,e,n);case"utf8":case"utf-8":return _(this,t,e,n);case"ascii":return b(this,t,e,n);case"latin1":case"binary":return x(this,t,e,n);case"base64":return w(this,t,e,n);case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return E(this,t,e,n);default:if(o)throw new TypeError("Unknown encoding: "+r);r=(""+r).toLowerCase(),o=!0}},u.prototype.toJSON=function(){return{type:"Buffer",data:Array.prototype.slice.call(this._arr||this,0)}};function T(t,e,n){var r="";n=Math.min(t.length,n);for(var i=e;i<n;++i)r+=String.fromCharCode(127&t[i]);return r}function C(t,e,n){var r="";n=Math.min(t.length,n);for(var i=e;i<n;++i)r+=String.fromCharCode(t[i]);return r}function P(t,e,n){var r=t.length;(!e||e<0)&&(e=0),(!n||n<0||n>r)&&(n=r);for(var i="",o=e;o<n;++o)i+=z(t[o]);return i}function M(t,e,n){for(var r=t.slice(e,n),i="",o=0;o<r.length;o+=2)i+=String.fromCharCode(r[o]+256*r[o+1]);return i}function I(t,e,n){if(t%1!=0||t<0)throw new RangeError("offset is not uint");if(t+e>n)throw new RangeError("Trying to access beyond buffer length")}function B(t,e,n,r,i,o){if(!u.isBuffer(t))throw new TypeError('"buffer" argument must be a Buffer instance');if(e>i||e<o)throw new RangeError('"value" argument is out of bounds');if(n+r>t.length)throw new RangeError("Index out of range")}function R(t,e,n,r){e<0&&(e=65535+e+1);for(var i=0,o=Math.min(t.length-n,2);i<o;++i)t[n+i]=(e&255<<8*(r?i:1-i))>>>8*(r?i:1-i)}function k(t,e,n,r){e<0&&(e=4294967295+e+1);for(var i=0,o=Math.min(t.length-n,4);i<o;++i)t[n+i]=e>>>8*(r?i:3-i)&255}function D(t,e,n,r,i,o){if(n+r>t.length)throw new RangeError("Index out of range");if(n<0)throw new RangeError("Index out of range")}function L(t,e,n,r,o){return o||D(t,0,n,4),i.write(t,e,n,r,23,4),n+4}function j(t,e,n,r,o){return o||D(t,0,n,8),i.write(t,e,n,r,52,8),n+8}u.prototype.slice=function(t,e){var n,r=this.length;if((t=~~t)<0?(t+=r)<0&&(t=0):t>r&&(t=r),(e=void 0===e?r:~~e)<0?(e+=r)<0&&(e=0):e>r&&(e=r),e<t&&(e=t),u.TYPED_ARRAY_SUPPORT)(n=this.subarray(t,e)).__proto__=u.prototype;else{var i=e-t;n=new u(i,void 0);for(var o=0;o<i;++o)n[o]=this[o+t]}return n},u.prototype.readUIntLE=function(t,e,n){t|=0,e|=0,n||I(t,e,this.length);for(var r=this[t],i=1,o=0;++o<e&&(i*=256);)r+=this[t+o]*i;return r},u.prototype.readUIntBE=function(t,e,n){t|=0,e|=0,n||I(t,e,this.length);for(var r=this[t+--e],i=1;e>0&&(i*=256);)r+=this[t+--e]*i;return r},u.prototype.readUInt8=function(t,e){return e||I(t,1,this.length),this[t]},u.prototype.readUInt16LE=function(t,e){return e||I(t,2,this.length),this[t]|this[t+1]<<8},u.prototype.readUInt16BE=function(t,e){return e||I(t,2,this.length),this[t]<<8|this[t+1]},u.prototype.readUInt32LE=function(t,e){return e||I(t,4,this.length),(this[t]|this[t+1]<<8|this[t+2]<<16)+16777216*this[t+3]},u.prototype.readUInt32BE=function(t,e){return e||I(t,4,this.length),16777216*this[t]+(this[t+1]<<16|this[t+2]<<8|this[t+3])},u.prototype.readIntLE=function(t,e,n){t|=0,e|=0,n||I(t,e,this.length);for(var r=this[t],i=1,o=0;++o<e&&(i*=256);)r+=this[t+o]*i;return r>=(i*=128)&&(r-=Math.pow(2,8*e)),r},u.prototype.readIntBE=function(t,e,n){t|=0,e|=0,n||I(t,e,this.length);for(var r=e,i=1,o=this[t+--r];r>0&&(i*=256);)o+=this[t+--r]*i;return o>=(i*=128)&&(o-=Math.pow(2,8*e)),o},u.prototype.readInt8=function(t,e){return e||I(t,1,this.length),128&this[t]?-1*(255-this[t]+1):this[t]},u.prototype.readInt16LE=function(t,e){e||I(t,2,this.length);var n=this[t]|this[t+1]<<8;return 32768&n?4294901760|n:n},u.prototype.readInt16BE=function(t,e){e||I(t,2,this.length);var n=this[t+1]|this[t]<<8;return 32768&n?4294901760|n:n},u.prototype.readInt32LE=function(t,e){return e||I(t,4,this.length),this[t]|this[t+1]<<8|this[t+2]<<16|this[t+3]<<24},u.prototype.readInt32BE=function(t,e){return e||I(t,4,this.length),this[t]<<24|this[t+1]<<16|this[t+2]<<8|this[t+3]},u.prototype.readFloatLE=function(t,e){return e||I(t,4,this.length),i.read(this,t,!0,23,4)},u.prototype.readFloatBE=function(t,e){return e||I(t,4,this.length),i.read(this,t,!1,23,4)},u.prototype.readDoubleLE=function(t,e){return e||I(t,8,this.length),i.read(this,t,!0,52,8)},u.prototype.readDoubleBE=function(t,e){return e||I(t,8,this.length),i.read(this,t,!1,52,8)},u.prototype.writeUIntLE=function(t,e,n,r){(t=+t,e|=0,n|=0,r)||B(this,t,e,n,Math.pow(2,8*n)-1,0);var i=1,o=0;for(this[e]=255&t;++o<n&&(i*=256);)this[e+o]=t/i&255;return e+n},u.prototype.writeUIntBE=function(t,e,n,r){(t=+t,e|=0,n|=0,r)||B(this,t,e,n,Math.pow(2,8*n)-1,0);var i=n-1,o=1;for(this[e+i]=255&t;--i>=0&&(o*=256);)this[e+i]=t/o&255;return e+n},u.prototype.writeUInt8=function(t,e,n){return t=+t,e|=0,n||B(this,t,e,1,255,0),u.TYPED_ARRAY_SUPPORT||(t=Math.floor(t)),this[e]=255&t,e+1},u.prototype.writeUInt16LE=function(t,e,n){return t=+t,e|=0,n||B(this,t,e,2,65535,0),u.TYPED_ARRAY_SUPPORT?(this[e]=255&t,this[e+1]=t>>>8):R(this,t,e,!0),e+2},u.prototype.writeUInt16BE=function(t,e,n){return t=+t,e|=0,n||B(this,t,e,2,65535,0),u.TYPED_ARRAY_SUPPORT?(this[e]=t>>>8,this[e+1]=255&t):R(this,t,e,!1),e+2},u.prototype.writeUInt32LE=function(t,e,n){return t=+t,e|=0,n||B(this,t,e,4,4294967295,0),u.TYPED_ARRAY_SUPPORT?(this[e+3]=t>>>24,this[e+2]=t>>>16,this[e+1]=t>>>8,this[e]=255&t):k(this,t,e,!0),e+4},u.prototype.writeUInt32BE=function(t,e,n){return t=+t,e|=0,n||B(this,t,e,4,4294967295,0),u.TYPED_ARRAY_SUPPORT?(this[e]=t>>>24,this[e+1]=t>>>16,this[e+2]=t>>>8,this[e+3]=255&t):k(this,t,e,!1),e+4},u.prototype.writeIntLE=function(t,e,n,r){if(t=+t,e|=0,!r){var i=Math.pow(2,8*n-1);B(this,t,e,n,i-1,-i)}var o=0,a=1,s=0;for(this[e]=255&t;++o<n&&(a*=256);)t<0&&0===s&&0!==this[e+o-1]&&(s=1),this[e+o]=(t/a>>0)-s&255;return e+n},u.prototype.writeIntBE=function(t,e,n,r){if(t=+t,e|=0,!r){var i=Math.pow(2,8*n-1);B(this,t,e,n,i-1,-i)}var o=n-1,a=1,s=0;for(this[e+o]=255&t;--o>=0&&(a*=256);)t<0&&0===s&&0!==this[e+o+1]&&(s=1),this[e+o]=(t/a>>0)-s&255;return e+n},u.prototype.writeInt8=function(t,e,n){return t=+t,e|=0,n||B(this,t,e,1,127,-128),u.TYPED_ARRAY_SUPPORT||(t=Math.floor(t)),t<0&&(t=255+t+1),this[e]=255&t,e+1},u.prototype.writeInt16LE=function(t,e,n){return t=+t,e|=0,n||B(this,t,e,2,32767,-32768),u.TYPED_ARRAY_SUPPORT?(this[e]=255&t,this[e+1]=t>>>8):R(this,t,e,!0),e+2},u.prototype.writeInt16BE=function(t,e,n){return t=+t,e|=0,n||B(this,t,e,2,32767,-32768),u.TYPED_ARRAY_SUPPORT?(this[e]=t>>>8,this[e+1]=255&t):R(this,t,e,!1),e+2},u.prototype.writeInt32LE=function(t,e,n){return t=+t,e|=0,n||B(this,t,e,4,2147483647,-2147483648),u.TYPED_ARRAY_SUPPORT?(this[e]=255&t,this[e+1]=t>>>8,this[e+2]=t>>>16,this[e+3]=t>>>24):k(this,t,e,!0),e+4},u.prototype.writeInt32BE=function(t,e,n){return t=+t,e|=0,n||B(this,t,e,4,2147483647,-2147483648),t<0&&(t=4294967295+t+1),u.TYPED_ARRAY_SUPPORT?(this[e]=t>>>24,this[e+1]=t>>>16,this[e+2]=t>>>8,this[e+3]=255&t):k(this,t,e,!1),e+4},u.prototype.writeFloatLE=function(t,e,n){return L(this,t,e,!0,n)},u.prototype.writeFloatBE=function(t,e,n){return L(this,t,e,!1,n)},u.prototype.writeDoubleLE=function(t,e,n){return j(this,t,e,!0,n)},u.prototype.writeDoubleBE=function(t,e,n){return j(this,t,e,!1,n)},u.prototype.copy=function(t,e,n,r){if(n||(n=0),r||0===r||(r=this.length),e>=t.length&&(e=t.length),e||(e=0),r>0&&r<n&&(r=n),r===n)return 0;if(0===t.length||0===this.length)return 0;if(e<0)throw new RangeError("targetStart out of bounds");if(n<0||n>=this.length)throw new RangeError("sourceStart out of bounds");if(r<0)throw new RangeError("sourceEnd out of bounds");r>this.length&&(r=this.length),t.length-e<r-n&&(r=t.length-e+n);var i,o=r-n;if(this===t&&n<e&&e<r)for(i=o-1;i>=0;--i)t[i+e]=this[i+n];else if(o<1e3||!u.TYPED_ARRAY_SUPPORT)for(i=0;i<o;++i)t[i+e]=this[i+n];else Uint8Array.prototype.set.call(t,this.subarray(n,n+o),e);return o},u.prototype.fill=function(t,e,n,r){if("string"==typeof t){if("string"==typeof e?(r=e,e=0,n=this.length):"string"==typeof n&&(r=n,n=this.length),1===t.length){var i=t.charCodeAt(0);i<256&&(t=i)}if(void 0!==r&&"string"!=typeof r)throw new TypeError("encoding must be a string");if("string"==typeof r&&!u.isEncoding(r))throw new TypeError("Unknown encoding: "+r)}else"number"==typeof t&&(t&=255);if(e<0||this.length<e||this.length<n)throw new RangeError("Out of range index");if(n<=e)return this;var o;if(e>>>=0,n=void 0===n?this.length:n>>>0,t||(t=0),"number"==typeof t)for(o=e;o<n;++o)this[o]=t;else{var a=u.isBuffer(t)?t:U(new u(t,r).toString()),s=a.length;for(o=0;o<n-e;++o)this[o+e]=a[o%s]}return this};var F=/[^+\/0-9A-Za-z-_]/g;function z(t){return t<16?"0"+t.toString(16):t.toString(16)}function U(t,e){var n;e=e||1/0;for(var r=t.length,i=null,o=[],a=0;a<r;++a){if((n=t.charCodeAt(a))>55295&&n<57344){if(!i){if(n>56319){(e-=3)>-1&&o.push(239,191,189);continue}if(a+1===r){(e-=3)>-1&&o.push(239,191,189);continue}i=n;continue}if(n<56320){(e-=3)>-1&&o.push(239,191,189),i=n;continue}n=65536+(i-55296<<10|n-56320)}else i&&(e-=3)>-1&&o.push(239,191,189);if(i=null,n<128){if((e-=1)<0)break;o.push(n)}else if(n<2048){if((e-=2)<0)break;o.push(n>>6|192,63&n|128)}else if(n<65536){if((e-=3)<0)break;o.push(n>>12|224,n>>6&63|128,63&n|128)}else{if(!(n<1114112))throw new Error("Invalid code point");if((e-=4)<0)break;o.push(n>>18|240,n>>12&63|128,n>>6&63|128,63&n|128)}}return o}function N(t){return r.toByteArray(function(t){if((t=function(t){return t.trim?t.trim():t.replace(/^\s+|\s+$/g,"")}(t).replace(F,"")).length<2)return"";for(;t.length%4!=0;)t+="=";return t}(t))}function G(t,e,n,r){for(var i=0;i<r&&!(i+n>=e.length||i>=t.length);++i)e[i+n]=t[i];return i}}).call(this,n(71))},function(t,e,n){"use strict";e.byteLength=function(t){var e=c(t),n=e[0],r=e[1];return 3*(n+r)/4-r},e.toByteArray=function(t){var e,n,r=c(t),a=r[0],s=r[1],u=new o(function(t,e,n){return 3*(e+n)/4-n}(0,a,s)),l=0,h=s>0?a-4:a;for(n=0;n<h;n+=4)e=i[t.charCodeAt(n)]<<18|i[t.charCodeAt(n+1)]<<12|i[t.charCodeAt(n+2)]<<6|i[t.charCodeAt(n+3)],u[l++]=e>>16&255,u[l++]=e>>8&255,u[l++]=255&e;2===s&&(e=i[t.charCodeAt(n)]<<2|i[t.charCodeAt(n+1)]>>4,u[l++]=255&e);1===s&&(e=i[t.charCodeAt(n)]<<10|i[t.charCodeAt(n+1)]<<4|i[t.charCodeAt(n+2)]>>2,u[l++]=e>>8&255,u[l++]=255&e);return u},e.fromByteArray=function(t){for(var e,n=t.length,i=n%3,o=[],a=0,s=n-i;a<s;a+=16383)o.push(l(t,a,a+16383>s?s:a+16383));1===i?(e=t[n-1],o.push(r[e>>2]+r[e<<4&63]+"==")):2===i&&(e=(t[n-2]<<8)+t[n-1],o.push(r[e>>10]+r[e>>4&63]+r[e<<2&63]+"="));return o.join("")};for(var r=[],i=[],o="undefined"!=typeof Uint8Array?Uint8Array:Array,a="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/",s=0,u=a.length;s<u;++s)r[s]=a[s],i[a.charCodeAt(s)]=s;function c(t){var e=t.length;if(e%4>0)throw new Error("Invalid string. Length must be a multiple of 4");var n=t.indexOf("=");return-1===n&&(n=e),[n,n===e?0:4-n%4]}function l(t,e,n){for(var i,o,a=[],s=e;s<n;s+=3)i=(t[s]<<16&16711680)+(t[s+1]<<8&65280)+(255&t[s+2]),a.push(r[(o=i)>>18&63]+r[o>>12&63]+r[o>>6&63]+r[63&o]);return a.join("")}i["-".charCodeAt(0)]=62,i["_".charCodeAt(0)]=63},function(t,e){var n={}.toString;t.exports=Array.isArray||function(t){return"[object Array]"==n.call(t)}},function(t,e,n){!function(n){"use strict";var r=function(t,e){var n=new Error(t+" at character "+e);throw n.index=e,n.description=t,n},i={"-":!0,"!":!0,"~":!0,"+":!0},o={"||":1,"&&":2,"|":3,"^":4,"&":5,"==":6,"!=":6,"===":6,"!==":6,"<":7,">":7,"<=":7,">=":7,"<<":8,">>":8,">>>":8,"+":9,"-":9,"*":10,"/":10,"%":10},a=function(t){var e,n=0;for(var r in t)(e=r.length)>n&&t.hasOwnProperty(r)&&(n=e);return n},s=a(i),u=a(o),c={true:!0,false:!1,null:null},l=function(t){return o[t]||0},h=function(t,e,n){return{type:"||"===t||"&&"===t?"LogicalExpression":"BinaryExpression",operator:t,left:e,right:n}},f=function(t){return t>=48&&t<=57},p=function(t){return 36===t||95===t||t>=65&&t<=90||t>=97&&t<=122||t>=128&&!o[String.fromCharCode(t)]},d=function(t){return 36===t||95===t||t>=65&&t<=90||t>=97&&t<=122||t>=48&&t<=57||t>=128&&!o[String.fromCharCode(t)]},A=function(t){for(var e,n,a=0,A=t.charAt,g=t.charCodeAt,m=function(e){return A.call(t,e)},y=function(e){return g.call(t,e)},v=t.length,_=function(){for(var t=y(a);32===t||9===t||10===t||13===t;)t=y(++a)},b=function(){var t,e,n=w();return _(),63!==y(a)?n:(a++,(t=b())||r("Expected expression",a),_(),58===y(a)?(a++,(e=b())||r("Expected expression",a),{type:"ConditionalExpression",test:n,consequent:t,alternate:e}):void r("Expected :",a))},x=function(){_();for(var e=t.substr(a,u),n=e.length;n>0;){if(o.hasOwnProperty(e)&&(!p(y(a))||a+e.length<t.length&&!d(y(a+e.length))))return a+=n,e;e=e.substr(0,--n)}return!1},w=function(){var t,e,n,i,o,s,u,c;if(s=E(),!(e=x()))return s;for(o={value:e,prec:l(e)},(u=E())||r("Expected expression after "+e,a),i=[s,o,u];(e=x())&&0!==(n=l(e));){for(o={value:e,prec:n};i.length>2&&n<=i[i.length-2].prec;)u=i.pop(),e=i.pop().value,s=i.pop(),t=h(e,s,u),i.push(t);(t=E())||r("Expected expression after "+e,a),i.push(o,t)}for(t=i[c=i.length-1];c>1;)t=h(i[c-1].value,i[c-2],t),c-=2;return t},E=function(){var e,n,r;if(_(),e=y(a),f(e)||46===e)return O();if(39===e||34===e)return S();if(91===e)return I();for(r=(n=t.substr(a,s)).length;r>0;){if(i.hasOwnProperty(n)&&(!p(y(a))||a+n.length<t.length&&!d(y(a+n.length))))return a+=r,{type:"UnaryExpression",operator:n,argument:E(),prefix:!0};n=n.substr(0,--r)}return!(!p(e)&&40!==e)&&P()},O=function(){for(var t,e,n="";f(y(a));)n+=m(a++);if(46===y(a))for(n+=m(a++);f(y(a));)n+=m(a++);if("e"===(t=m(a))||"E"===t){for(n+=m(a++),"+"!==(t=m(a))&&"-"!==t||(n+=m(a++));f(y(a));)n+=m(a++);f(y(a-1))||r("Expected exponent ("+n+m(a)+")",a)}return e=y(a),p(e)?r("Variable names cannot start with a number ("+n+m(a)+")",a):46===e&&r("Unexpected period",a),{type:"Literal",value:parseFloat(n),raw:n}},S=function(){for(var t,e="",n=m(a++),i=!1;a<v;){if((t=m(a++))===n){i=!0;break}if("\\"===t)switch(t=m(a++)){case"n":e+="\n";break;case"r":e+="\r";break;case"t":e+="\t";break;case"b":e+="\b";break;case"f":e+="\f";break;case"v":e+="\v";break;default:e+=t}else e+=t}return i||r('Unclosed quote after "'+e+'"',a),{type:"Literal",value:e,raw:n+e+n}},T=function(){var e,n=y(a),i=a;for(p(n)?a++:r("Unexpected "+m(a),a);a<v&&(n=y(a),d(n));)a++;return e=t.slice(i,a),c.hasOwnProperty(e)?{type:"Literal",value:c[e],raw:e}:"this"===e?{type:"ThisExpression"}:{type:"Identifier",name:e}},C=function(t){for(var e,n,i=[],o=!1;a<v;){if(_(),(e=y(a))===t){o=!0,a++;break}44===e?a++:((n=b())&&"Compound"!==n.type||r("Expected comma",a),i.push(n))}return o||r("Expected "+String.fromCharCode(t),a),i},P=function(){var t,e;for(e=40===(t=y(a))?M():T(),_(),t=y(a);46===t||91===t||40===t;)a++,46===t?(_(),e={type:"MemberExpression",computed:!1,object:e,property:T()}):91===t?(e={type:"MemberExpression",computed:!0,object:e,property:b()},_(),93!==(t=y(a))&&r("Unclosed [",a),a++):40===t&&(e={type:"CallExpression",arguments:C(41),callee:e}),_(),t=y(a);return e},M=function(){a++;var t=b();if(_(),41===y(a))return a++,t;r("Unclosed (",a)},I=function(){return a++,{type:"ArrayExpression",elements:C(93)}},B=[];a<v;)59===(e=y(a))||44===e?a++:(n=b())?B.push(n):a<v&&r('Unexpected "'+m(a)+'"',a);return 1===B.length?B[0]:{type:"Compound",body:B}};A.version="0.3.4",A.toString=function(){return"JavaScript Expression Parser (JSEP) v"+A.version},A.addUnaryOp=function(t){return s=Math.max(t.length,s),i[t]=!0,this},A.addBinaryOp=function(t,e){return u=Math.max(t.length,u),o[t]=e,this},A.addLiteral=function(t,e){return c[t]=e,this},A.removeUnaryOp=function(t){return delete i[t],t.length===s&&(s=a(i)),this},A.removeAllUnaryOps=function(){return i={},s=0,this},A.removeBinaryOp=function(t){return delete o[t],t.length===u&&(u=a(o)),this},A.removeAllBinaryOps=function(){return o={},u=0,this},A.removeLiteral=function(t){return delete c[t],this},A.removeAllLiterals=function(){return c={},this},t.exports?e=t.exports=A:e.parse=A}()},function(t,e,n){t.exports=function(){"use strict";var t,e,n;function r(r,i){if(t)if(e){var o="var sharedChunk = {}; ("+t+")(sharedChunk); ("+e+")(sharedChunk);",a={};t(a),n=i(a),"undefined"!=typeof window&&(n.workerUrl=window.URL.createObjectURL(new Blob([o],{type:"text/javascript"})))}else e=i;else t=i}return r(0,(function(t){function e(t,e){return t(e={exports:{}},e.exports),e.exports}var n=r;function r(t,e,n,r){this.cx=3*t,this.bx=3*(n-t)-this.cx,this.ax=1-this.cx-this.bx,this.cy=3*e,this.by=3*(r-e)-this.cy,this.ay=1-this.cy-this.by,this.p1x=t,this.p1y=r,this.p2x=n,this.p2y=r}r.prototype.sampleCurveX=function(t){return((this.ax*t+this.bx)*t+this.cx)*t},r.prototype.sampleCurveY=function(t){return((this.ay*t+this.by)*t+this.cy)*t},r.prototype.sampleCurveDerivativeX=function(t){return(3*this.ax*t+2*this.bx)*t+this.cx},r.prototype.solveCurveX=function(t,e){var n,r,i,o,a;for(void 0===e&&(e=1e-6),i=t,a=0;a<8;a++){if(o=this.sampleCurveX(i)-t,Math.abs(o)<e)return i;var s=this.sampleCurveDerivativeX(i);if(Math.abs(s)<1e-6)break;i-=o/s}if((i=t)<(n=0))return n;if(i>(r=1))return r;for(;n<r;){if(o=this.sampleCurveX(i),Math.abs(o-t)<e)return i;t>o?n=i:r=i,i=.5*(r-n)+n}return i},r.prototype.solve=function(t,e){return this.sampleCurveY(this.solveCurveX(t,e))};var i=o;function o(t,e){this.x=t,this.y=e}o.prototype={clone:function(){return new o(this.x,this.y)},add:function(t){return this.clone()._add(t)},sub:function(t){return this.clone()._sub(t)},multByPoint:function(t){return this.clone()._multByPoint(t)},divByPoint:function(t){return this.clone()._divByPoint(t)},mult:function(t){return this.clone()._mult(t)},div:function(t){return this.clone()._div(t)},rotate:function(t){return this.clone()._rotate(t)},rotateAround:function(t,e){return this.clone()._rotateAround(t,e)},matMult:function(t){return this.clone()._matMult(t)},unit:function(){return this.clone()._unit()},perp:function(){return this.clone()._perp()},round:function(){return this.clone()._round()},mag:function(){return Math.sqrt(this.x*this.x+this.y*this.y)},equals:function(t){return this.x===t.x&&this.y===t.y},dist:function(t){return Math.sqrt(this.distSqr(t))},distSqr:function(t){var e=t.x-this.x,n=t.y-this.y;return e*e+n*n},angle:function(){return Math.atan2(this.y,this.x)},angleTo:function(t){return Math.atan2(this.y-t.y,this.x-t.x)},angleWith:function(t){return this.angleWithSep(t.x,t.y)},angleWithSep:function(t,e){return Math.atan2(this.x*e-this.y*t,this.x*t+this.y*e)},_matMult:function(t){var e=t[2]*this.x+t[3]*this.y;return this.x=t[0]*this.x+t[1]*this.y,this.y=e,this},_add:function(t){return this.x+=t.x,this.y+=t.y,this},_sub:function(t){return this.x-=t.x,this.y-=t.y,this},_mult:function(t){return this.x*=t,this.y*=t,this},_div:function(t){return this.x/=t,this.y/=t,this},_multByPoint:function(t){return this.x*=t.x,this.y*=t.y,this},_divByPoint:function(t){return this.x/=t.x,this.y/=t.y,this},_unit:function(){return this._div(this.mag()),this},_perp:function(){var t=this.y;return this.y=this.x,this.x=-t,this},_rotate:function(t){var e=Math.cos(t),n=Math.sin(t),r=n*this.x+e*this.y;return this.x=e*this.x-n*this.y,this.y=r,this},_rotateAround:function(t,e){var n=Math.cos(t),r=Math.sin(t),i=e.y+r*(this.x-e.x)+n*(this.y-e.y);return this.x=e.x+n*(this.x-e.x)-r*(this.y-e.y),this.y=i,this},_round:function(){return this.x=Math.round(this.x),this.y=Math.round(this.y),this}},o.convert=function(t){return t instanceof o?t:Array.isArray(t)?new o(t[0],t[1]):t};var a="undefined"!=typeof self?self:{},s=Math.pow(2,53)-1;function u(t,e,r,i){var o=new n(t,e,r,i);return function(t){return o.solve(t)}}var c=u(.25,.1,.25,1);function l(t,e,n){return Math.min(n,Math.max(e,t))}function h(t,e,n){var r=n-e,i=((t-e)%r+r)%r+e;return i===e?n:i}function f(t){for(var e=[],n=arguments.length-1;n-- >0;)e[n]=arguments[n+1];for(var r=0,i=e;r<i.length;r+=1){var o=i[r];for(var a in o)t[a]=o[a]}return t}var p=1;function d(){return p++}function A(){return function t(e){return e?(e^16*Math.random()>>e/4).toString(16):([1e7]+-[1e3]+-4e3+-8e3+-1e11).replace(/[018]/g,t)}()}function g(t){return!!t&&/^[0-9a-f]{8}-[0-9a-f]{4}-[4][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(t)}function m(t,e){t.forEach((function(t){e[t]&&(e[t]=e[t].bind(e))}))}function y(t,e){return-1!==t.indexOf(e,t.length-e.length)}function v(t,e,n){var r={};for(var i in t)r[i]=e.call(n||this,t[i],i,t);return r}function _(t,e,n){var r={};for(var i in t)e.call(n||this,t[i],i,t)&&(r[i]=t[i]);return r}function b(t){return Array.isArray(t)?t.map(b):"object"==typeof t&&t?v(t,b):t}var x={};function w(t){x[t]||("undefined"!=typeof console&&console.warn(t),x[t]=!0)}function E(t,e,n){return(n.y-t.y)*(e.x-t.x)>(e.y-t.y)*(n.x-t.x)}function O(t){for(var e=0,n=0,r=t.length,i=r-1,o=void 0,a=void 0;n<r;i=n++)e+=((a=t[i]).x-(o=t[n]).x)*(o.y+a.y);return e}function S(){return"undefined"!=typeof WorkerGlobalScope&&"undefined"!=typeof self&&self instanceof WorkerGlobalScope}function T(t){var e={};if(t.replace(/(?:^|(?:\s*\,\s*))([^\x00-\x20\(\)<>@\,;\:\\"\/\[\]\?\=\{\}\x7F]+)(?:\=(?:([^\x00-\x20\(\)<>@\,;\:\\"\/\[\]\?\=\{\}\x7F]+)|(?:\"((?:[^"\\]|\\.)*)\")))?/g,(function(t,n,r,i){var o=r||i;return e[n]=!o||o.toLowerCase(),""})),e["max-age"]){var n=parseInt(e["max-age"],10);isNaN(n)?delete e["max-age"]:e["max-age"]=n}return e}var C=null;function P(t){if(null==C){var e=t.navigator?t.navigator.userAgent:null;C=!!t.safari||!(!e||!(/\b(iPad|iPhone|iPod)\b/.test(e)||e.match("Safari")&&!e.match("Chrome")))}return C}function M(t){try{var e=a[t];return e.setItem("_mapbox_test_",1),e.removeItem("_mapbox_test_"),!0}catch(t){return!1}}var I,B,R,k,D=a.performance&&a.performance.now?a.performance.now.bind(a.performance):Date.now.bind(Date),L=a.requestAnimationFrame||a.mozRequestAnimationFrame||a.webkitRequestAnimationFrame||a.msRequestAnimationFrame,j=a.cancelAnimationFrame||a.mozCancelAnimationFrame||a.webkitCancelAnimationFrame||a.msCancelAnimationFrame,F={now:D,frame:function(t){var e=L(t);return{cancel:function(){return j(e)}}},getImageData:function(t,e){void 0===e&&(e=0);var n=a.document.createElement("canvas"),r=n.getContext("2d");if(!r)throw new Error("failed to create canvas 2d context");return n.width=t.width,n.height=t.height,r.drawImage(t,0,0,t.width,t.height),r.getImageData(-e,-e,t.width+2*e,t.height+2*e)},resolveURL:function(t){return I||(I=a.document.createElement("a")),I.href=t,I.href},hardwareConcurrency:a.navigator&&a.navigator.hardwareConcurrency||4,get devicePixelRatio(){return a.devicePixelRatio},get prefersReducedMotion(){return!!a.matchMedia&&(null==B&&(B=a.matchMedia("(prefers-reduced-motion: reduce)")),B.matches)}},z={API_URL:"https://api.mapbox.com",get EVENTS_URL(){return this.API_URL?0===this.API_URL.indexOf("https://api.mapbox.cn")?"https://events.mapbox.cn/events/v2":0===this.API_URL.indexOf("https://api.mapbox.com")?"https://events.mapbox.com/events/v2":null:null},FEEDBACK_URL:"https://apps.mapbox.com/feedback",REQUIRE_ACCESS_TOKEN:!0,ACCESS_TOKEN:null,MAX_PARALLEL_IMAGE_REQUESTS:16},U={supported:!1,testSupport:function(t){!N&&k&&(G?V(t):R=t)}},N=!1,G=!1;function V(t){var e=t.createTexture();t.bindTexture(t.TEXTURE_2D,e);try{if(t.texImage2D(t.TEXTURE_2D,0,t.RGBA,t.RGBA,t.UNSIGNED_BYTE,k),t.isContextLost())return;U.supported=!0}catch(t){}t.deleteTexture(e),N=!0}a.document&&((k=a.document.createElement("img")).onload=function(){R&&V(R),R=null,G=!0},k.onerror=function(){N=!0,R=null},k.src="data:image/webp;base64,UklGRh4AAABXRUJQVlA4TBEAAAAvAQAAAAfQ//73v/+BiOh/AAA=");var H="01",W=function(t,e){this._transformRequestFn=t,this._customAccessToken=e,this._createSkuToken()};function q(t){return 0===t.indexOf("mapbox:")}W.prototype._createSkuToken=function(){var t=function(){for(var t="",e=0;e<10;e++)t+="0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"[Math.floor(62*Math.random())];return{token:["1",H,t].join(""),tokenExpiresAt:Date.now()+432e5}}();this._skuToken=t.token,this._skuTokenExpiresAt=t.tokenExpiresAt},W.prototype._isSkuTokenExpired=function(){return Date.now()>this._skuTokenExpiresAt},W.prototype.transformRequest=function(t,e){return this._transformRequestFn&&this._transformRequestFn(t,e)||{url:t}},W.prototype.normalizeStyleURL=function(t,e){if(!q(t))return t;var n=Q(t);return n.path="/styles/v1"+n.path,this._makeAPIURL(n,this._customAccessToken||e)},W.prototype.normalizeGlyphsURL=function(t,e){if(!q(t))return t;var n=Q(t);return n.path="/fonts/v1"+n.path,this._makeAPIURL(n,this._customAccessToken||e)},W.prototype.normalizeSourceURL=function(t,e){if(!q(t))return t;var n=Q(t);return n.path="/v4/"+n.authority+".json",n.params.push("secure"),this._makeAPIURL(n,this._customAccessToken||e)},W.prototype.normalizeSpriteURL=function(t,e,n,r){var i=Q(t);return q(t)?(i.path="/styles/v1"+i.path+"/sprite"+e+n,this._makeAPIURL(i,this._customAccessToken||r)):(i.path+=""+e+n,K(i))},W.prototype.normalizeTileURL=function(t,e){if(this._isSkuTokenExpired()&&this._createSkuToken(),t&&!q(t))return t;var n=Q(t);n.path=n.path.replace(/(\.(png|jpg)\d*)(?=$)/,(F.devicePixelRatio>=2||512===e?"@2x":"")+(U.supported?".webp":"$1")),n.path=n.path.replace(/^.+\/v4\//,"/"),n.path="/v4"+n.path;var r=this._customAccessToken||function(t){for(var e=0,n=t;e<n.length;e+=1){var r=n[e].match(/^access_token=(.*)$/);if(r)return r[1]}return null}(n.params)||z.ACCESS_TOKEN;return z.REQUIRE_ACCESS_TOKEN&&r&&this._skuToken&&n.params.push("sku="+this._skuToken),this._makeAPIURL(n,r)},W.prototype.canonicalizeTileURL=function(t,e){var n=Q(t);if(!n.path.match(/(^\/v4\/)/)||!n.path.match(/\.[\w]+$/))return t;var r="mapbox://tiles/";r+=n.path.replace("/v4/","");var i=n.params;return e&&(i=i.filter((function(t){return!t.match(/^access_token=/)}))),i.length&&(r+="?"+i.join("&")),r},W.prototype.canonicalizeTileset=function(t,e){for(var n=!!e&&q(e),r=[],i=0,o=t.tiles||[];i<o.length;i+=1){var a=o[i];Z(a)?r.push(this.canonicalizeTileURL(a,n)):r.push(a)}return r},W.prototype._makeAPIURL=function(t,e){var n="See https://www.mapbox.com/api-documentation/#access-tokens-and-token-scopes",r=Q(z.API_URL);if(t.protocol=r.protocol,t.authority=r.authority,"http"===t.protocol){var i=t.params.indexOf("secure");i>=0&&t.params.splice(i,1)}if("/"!==r.path&&(t.path=""+r.path+t.path),!z.REQUIRE_ACCESS_TOKEN)return K(t);if(!(e=e||z.ACCESS_TOKEN))throw new Error("An API access token is required to use Mapbox GL. "+n);if("s"===e[0])throw new Error("Use a public access token (pk.*) with Mapbox GL, not a secret access token (sk.*). "+n);return t.params=t.params.filter((function(t){return-1===t.indexOf("access_token")})),t.params.push("access_token="+e),K(t)};var X=/^((https?:)?\/\/)?([^\/]+\.)?mapbox\.c(n|om)(\/|\?|$)/i;function Z(t){return X.test(t)}var J=/^(\w+):\/\/([^/?]*)(\/[^?]+)?\??(.+)?/;function Q(t){var e=t.match(J);if(!e)throw new Error("Unable to parse URL object");return{protocol:e[1],authority:e[2],path:e[3]||"/",params:e[4]?e[4].split("&"):[]}}function K(t){var e=t.params.length?"?"+t.params.join("&"):"";return t.protocol+"://"+t.authority+t.path+e}function Y(t){if(!t)return null;var e=t.split(".");if(!e||3!==e.length)return null;try{return JSON.parse(decodeURIComponent(a.atob(e[1]).split("").map((function(t){return"%"+("00"+t.charCodeAt(0).toString(16)).slice(-2)})).join("")))}catch(t){return null}}var $=function(t){this.type=t,this.anonId=null,this.eventData={},this.queue=[],this.pendingRequest=null};$.prototype.getStorageKey=function(t){var e,n=Y(z.ACCESS_TOKEN);return e=n&&n.u?a.btoa(encodeURIComponent(n.u).replace(/%([0-9A-F]{2})/g,(function(t,e){return String.fromCharCode(Number("0x"+e))}))):z.ACCESS_TOKEN||"",t?"mapbox.eventData."+t+":"+e:"mapbox.eventData:"+e},$.prototype.fetchEventData=function(){var t=M("localStorage"),e=this.getStorageKey(),n=this.getStorageKey("uuid");if(t)try{var r=a.localStorage.getItem(e);r&&(this.eventData=JSON.parse(r));var i=a.localStorage.getItem(n);i&&(this.anonId=i)}catch(t){w("Unable to read from LocalStorage")}},$.prototype.saveEventData=function(){var t=M("localStorage"),e=this.getStorageKey(),n=this.getStorageKey("uuid");if(t)try{a.localStorage.setItem(n,this.anonId),Object.keys(this.eventData).length>=1&&a.localStorage.setItem(e,JSON.stringify(this.eventData))}catch(t){w("Unable to write to LocalStorage")}},$.prototype.processRequests=function(t){},$.prototype.postEvent=function(t,e,n,r){var i=this;if(z.EVENTS_URL){var o=Q(z.EVENTS_URL);o.params.push("access_token="+(r||z.ACCESS_TOKEN||""));var a={event:this.type,created:new Date(t).toISOString(),sdkIdentifier:"mapbox-gl-js",sdkVersion:"1.13.3",skuId:H,userId:this.anonId},s=e?f(a,e):a,u={url:K(o),headers:{"Content-Type":"text/plain"},body:JSON.stringify([s])};this.pendingRequest=bt(u,(function(t){i.pendingRequest=null,n(t),i.saveEventData(),i.processRequests(r)}))}},$.prototype.queueRequest=function(t,e){this.queue.push(t),this.processRequests(e)};var tt,et,nt=function(t){function e(){t.call(this,"map.load"),this.success={},this.skuToken=""}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.postMapLoadEvent=function(t,e,n,r){this.skuToken=n;var i=!(!r&&!z.ACCESS_TOKEN),o=Array.isArray(t)&&t.some((function(t){return q(t)||Z(t)}));z.EVENTS_URL&&i&&o&&this.queueRequest({id:e,timestamp:Date.now()},r)},e.prototype.processRequests=function(t){var e=this;if(!this.pendingRequest&&0!==this.queue.length){var n=this.queue.shift(),r=n.id,i=n.timestamp;r&&this.success[r]||(this.anonId||this.fetchEventData(),g(this.anonId)||(this.anonId=A()),this.postEvent(i,{skuToken:this.skuToken},(function(t){t||r&&(e.success[r]=!0)}),t))}},e}($),rt=new(function(t){function e(e){t.call(this,"appUserTurnstile"),this._customAccessToken=e}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.postTurnstileEvent=function(t,e){z.EVENTS_URL&&z.ACCESS_TOKEN&&Array.isArray(t)&&t.some((function(t){return q(t)||Z(t)}))&&this.queueRequest(Date.now(),e)},e.prototype.processRequests=function(t){var e=this;if(!this.pendingRequest&&0!==this.queue.length){this.anonId&&this.eventData.lastSuccess&&this.eventData.tokenU||this.fetchEventData();var n=Y(z.ACCESS_TOKEN),r=n?n.u:z.ACCESS_TOKEN,i=r!==this.eventData.tokenU;g(this.anonId)||(this.anonId=A(),i=!0);var o=this.queue.shift();if(this.eventData.lastSuccess){var a=new Date(this.eventData.lastSuccess),s=new Date(o),u=(o-this.eventData.lastSuccess)/864e5;i=i||u>=1||u<-1||a.getDate()!==s.getDate()}else i=!0;if(!i)return this.processRequests();this.postEvent(o,{"enabled.telemetry":!1},(function(t){t||(e.eventData.lastSuccess=o,e.eventData.tokenU=r)}),t)}},e}($)),it=rt.postTurnstileEvent.bind(rt),ot=new nt,at=ot.postMapLoadEvent.bind(ot),st=500,ut=50;function ct(){a.caches&&!tt&&(tt=a.caches.open("mapbox-tiles"))}function lt(t){var e=t.indexOf("?");return e<0?t:t.slice(0,e)}var ht,ft=1/0;function pt(){return null==ht&&(ht=a.OffscreenCanvas&&new a.OffscreenCanvas(1,1).getContext("2d")&&"function"==typeof a.createImageBitmap),ht}var dt={Unknown:"Unknown",Style:"Style",Source:"Source",Tile:"Tile",Glyphs:"Glyphs",SpriteImage:"SpriteImage",SpriteJSON:"SpriteJSON",Image:"Image"};"function"==typeof Object.freeze&&Object.freeze(dt);var At,gt,mt=function(t){function e(e,n,r){401===n&&Z(r)&&(e+=": you may have provided an invalid Mapbox access token. See https://www.mapbox.com/api-documentation/#access-tokens-and-token-scopes"),t.call(this,e),this.status=n,this.url=r,this.name=this.constructor.name,this.message=e}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.toString=function(){return this.name+": "+this.message+" ("+this.status+"): "+this.url},e}(Error),yt=S()?function(){return self.worker&&self.worker.referrer}:function(){return("blob:"===a.location.protocol?a.parent:a).location.href},vt=function(t,e){if(!(/^file:/.test(n=t.url)||/^file:/.test(yt())&&!/^\w+:/.test(n))){if(a.fetch&&a.Request&&a.AbortController&&a.Request.prototype.hasOwnProperty("signal"))return function(t,e){var n,r=new a.AbortController,i=new a.Request(t.url,{method:t.method||"GET",body:t.body,credentials:t.credentials,headers:t.headers,referrer:yt(),signal:r.signal}),o=!1,s=!1,u=(n=i.url).indexOf("sku=")>0&&Z(n);"json"===t.type&&i.headers.set("Accept","application/json");var c=function(n,r,o){if(!s){if(n&&"SecurityError"!==n.message&&w(n),r&&o)return l(r);var c=Date.now();a.fetch(i).then((function(n){if(n.ok){var r=u?n.clone():null;return l(n,r,c)}return e(new mt(n.statusText,n.status,t.url))})).catch((function(t){20!==t.code&&e(new Error(t.message))}))}},l=function(n,r,u){("arrayBuffer"===t.type?n.arrayBuffer():"json"===t.type?n.json():n.text()).then((function(t){s||(r&&u&&function(t,e,n){if(ct(),tt){var r={status:e.status,statusText:e.statusText,headers:new a.Headers};e.headers.forEach((function(t,e){return r.headers.set(e,t)}));var i=T(e.headers.get("Cache-Control")||"");i["no-store"]||(i["max-age"]&&r.headers.set("Expires",new Date(n+1e3*i["max-age"]).toUTCString()),new Date(r.headers.get("Expires")).getTime()-n<42e4||function(t,e){if(void 0===et)try{new Response(new ReadableStream),et=!0}catch(t){et=!1}et?e(t.body):t.blob().then(e)}(e,(function(e){var n=new a.Response(e,r);ct(),tt&&tt.then((function(e){return e.put(lt(t.url),n)})).catch((function(t){return w(t.message)}))})))}}(i,r,u),o=!0,e(null,t,n.headers.get("Cache-Control"),n.headers.get("Expires")))})).catch((function(t){s||e(new Error(t.message))}))};return u?function(t,e){if(ct(),!tt)return e(null);var n=lt(t.url);tt.then((function(t){t.match(n).then((function(r){var i=function(t){if(!t)return!1;var e=new Date(t.headers.get("Expires")||0),n=T(t.headers.get("Cache-Control")||"");return e>Date.now()&&!n["no-cache"]}(r);t.delete(n),i&&t.put(n,r.clone()),e(null,r,i)})).catch(e)})).catch(e)}(i,c):c(null,null),{cancel:function(){s=!0,o||r.abort()}}}(t,e);if(S()&&self.worker&&self.worker.actor)return self.worker.actor.send("getResource",t,e,void 0,!0)}var n;return function(t,e){var n=new a.XMLHttpRequest;for(var r in n.open(t.method||"GET",t.url,!0),"arrayBuffer"===t.type&&(n.responseType="arraybuffer"),t.headers)n.setRequestHeader(r,t.headers[r]);return"json"===t.type&&(n.responseType="text",n.setRequestHeader("Accept","application/json")),n.withCredentials="include"===t.credentials,n.onerror=function(){e(new Error(n.statusText))},n.onload=function(){if((n.status>=200&&n.status<300||0===n.status)&&null!==n.response){var r=n.response;if("json"===t.type)try{r=JSON.parse(n.response)}catch(t){return e(t)}e(null,r,n.getResponseHeader("Cache-Control"),n.getResponseHeader("Expires"))}else e(new mt(n.statusText,n.status,t.url))},n.send(t.body),{cancel:function(){return n.abort()}}}(t,e)},_t=function(t,e){return vt(f(t,{type:"arrayBuffer"}),e)},bt=function(t,e){return vt(f(t,{method:"POST"}),e)},xt="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAC0lEQVQYV2NgAAIAAAUAAarVyFEAAAAASUVORK5CYII=";At=[],gt=0;var wt=function(t,e){if(U.supported&&(t.headers||(t.headers={}),t.headers.accept="image/webp,*/*"),gt>=z.MAX_PARALLEL_IMAGE_REQUESTS){var n={requestParameters:t,callback:e,cancelled:!1,cancel:function(){this.cancelled=!0}};return At.push(n),n}gt++;var r=!1,i=function(){if(!r)for(r=!0,gt--;At.length&&gt<z.MAX_PARALLEL_IMAGE_REQUESTS;){var t=At.shift();t.cancelled||(t.cancel=wt(t.requestParameters,t.callback).cancel)}},o=_t(t,(function(t,n,r,o){i(),t?e(t):n&&(pt()?function(t,e){var n=new a.Blob([new Uint8Array(t)],{type:"image/png"});a.createImageBitmap(n).then((function(t){e(null,t)})).catch((function(t){e(new Error("Could not load image because of "+t.message+". Please make sure to use a supported image type such as PNG or JPEG. Note that SVGs are not supported."))}))}(n,e):function(t,e,n,r){var i=new a.Image,o=a.URL;i.onload=function(){e(null,i),o.revokeObjectURL(i.src),i.onload=null,a.requestAnimationFrame((function(){i.src=xt}))},i.onerror=function(){return e(new Error("Could not load image. Please make sure to use a supported image type such as PNG or JPEG. Note that SVGs are not supported."))};var s=new a.Blob([new Uint8Array(t)],{type:"image/png"});i.cacheControl=n,i.expires=r,i.src=t.byteLength?o.createObjectURL(s):xt}(n,e,r,o))}));return{cancel:function(){o.cancel(),i()}}};function Et(t,e,n){n[t]&&-1!==n[t].indexOf(e)||(n[t]=n[t]||[],n[t].push(e))}function Ot(t,e,n){if(n&&n[t]){var r=n[t].indexOf(e);-1!==r&&n[t].splice(r,1)}}var St=function(t,e){void 0===e&&(e={}),f(this,e),this.type=t},Tt=function(t){function e(e,n){void 0===n&&(n={}),t.call(this,"error",f({error:e},n))}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e}(St),Ct=function(){};Ct.prototype.on=function(t,e){return this._listeners=this._listeners||{},Et(t,e,this._listeners),this},Ct.prototype.off=function(t,e){return Ot(t,e,this._listeners),Ot(t,e,this._oneTimeListeners),this},Ct.prototype.once=function(t,e){return this._oneTimeListeners=this._oneTimeListeners||{},Et(t,e,this._oneTimeListeners),this},Ct.prototype.fire=function(t,e){"string"==typeof t&&(t=new St(t,e||{}));var n=t.type;if(this.listens(n)){t.target=this;for(var r=0,i=this._listeners&&this._listeners[n]?this._listeners[n].slice():[];r<i.length;r+=1)i[r].call(this,t);for(var o=0,a=this._oneTimeListeners&&this._oneTimeListeners[n]?this._oneTimeListeners[n].slice():[];o<a.length;o+=1){var s=a[o];Ot(n,s,this._oneTimeListeners),s.call(this,t)}var u=this._eventedParent;u&&(f(t,"function"==typeof this._eventedParentData?this._eventedParentData():this._eventedParentData),u.fire(t))}else t instanceof Tt&&console.error(t.error);return this},Ct.prototype.listens=function(t){return this._listeners&&this._listeners[t]&&this._listeners[t].length>0||this._oneTimeListeners&&this._oneTimeListeners[t]&&this._oneTimeListeners[t].length>0||this._eventedParent&&this._eventedParent.listens(t)},Ct.prototype.setEventedParent=function(t,e){return this._eventedParent=t,this._eventedParentData=e,this};var Pt={$version:8,$root:{version:{required:!0,type:"enum",values:[8]},name:{type:"string"},metadata:{type:"*"},center:{type:"array",value:"number"},zoom:{type:"number"},bearing:{type:"number",default:0,period:360,units:"degrees"},pitch:{type:"number",default:0,units:"degrees"},light:{type:"light"},sources:{required:!0,type:"sources"},sprite:{type:"string"},glyphs:{type:"string"},transition:{type:"transition"},layers:{required:!0,type:"array",value:"layer"}},sources:{"*":{type:"source"}},source:["source_vector","source_raster","source_raster_dem","source_geojson","source_video","source_image"],source_vector:{type:{required:!0,type:"enum",values:{vector:{}}},url:{type:"string"},tiles:{type:"array",value:"string"},bounds:{type:"array",value:"number",length:4,default:[-180,-85.051129,180,85.051129]},scheme:{type:"enum",values:{xyz:{},tms:{}},default:"xyz"},minzoom:{type:"number",default:0},maxzoom:{type:"number",default:22},attribution:{type:"string"},promoteId:{type:"promoteId"},volatile:{type:"boolean",default:!1},"*":{type:"*"}},source_raster:{type:{required:!0,type:"enum",values:{raster:{}}},url:{type:"string"},tiles:{type:"array",value:"string"},bounds:{type:"array",value:"number",length:4,default:[-180,-85.051129,180,85.051129]},minzoom:{type:"number",default:0},maxzoom:{type:"number",default:22},tileSize:{type:"number",default:512,units:"pixels"},scheme:{type:"enum",values:{xyz:{},tms:{}},default:"xyz"},attribution:{type:"string"},volatile:{type:"boolean",default:!1},"*":{type:"*"}},source_raster_dem:{type:{required:!0,type:"enum",values:{"raster-dem":{}}},url:{type:"string"},tiles:{type:"array",value:"string"},bounds:{type:"array",value:"number",length:4,default:[-180,-85.051129,180,85.051129]},minzoom:{type:"number",default:0},maxzoom:{type:"number",default:22},tileSize:{type:"number",default:512,units:"pixels"},attribution:{type:"string"},encoding:{type:"enum",values:{terrarium:{},mapbox:{}},default:"mapbox"},volatile:{type:"boolean",default:!1},"*":{type:"*"}},source_geojson:{type:{required:!0,type:"enum",values:{geojson:{}}},data:{type:"*"},maxzoom:{type:"number",default:18},attribution:{type:"string"},buffer:{type:"number",default:128,maximum:512,minimum:0},filter:{type:"*"},tolerance:{type:"number",default:.375},cluster:{type:"boolean",default:!1},clusterRadius:{type:"number",default:50,minimum:0},clusterMaxZoom:{type:"number"},clusterMinPoints:{type:"number"},clusterProperties:{type:"*"},lineMetrics:{type:"boolean",default:!1},generateId:{type:"boolean",default:!1},promoteId:{type:"promoteId"}},source_video:{type:{required:!0,type:"enum",values:{video:{}}},urls:{required:!0,type:"array",value:"string"},coordinates:{required:!0,type:"array",length:4,value:{type:"array",length:2,value:"number"}}},source_image:{type:{required:!0,type:"enum",values:{image:{}}},url:{required:!0,type:"string"},coordinates:{required:!0,type:"array",length:4,value:{type:"array",length:2,value:"number"}}},layer:{id:{type:"string",required:!0},type:{type:"enum",values:{fill:{},line:{},symbol:{},circle:{},heatmap:{},"fill-extrusion":{},raster:{},hillshade:{},background:{}},required:!0},metadata:{type:"*"},source:{type:"string"},"source-layer":{type:"string"},minzoom:{type:"number",minimum:0,maximum:24},maxzoom:{type:"number",minimum:0,maximum:24},filter:{type:"filter"},layout:{type:"layout"},paint:{type:"paint"}},layout:["layout_fill","layout_line","layout_circle","layout_heatmap","layout_fill-extrusion","layout_symbol","layout_raster","layout_hillshade","layout_background"],layout_background:{visibility:{type:"enum",values:{visible:{},none:{}},default:"visible","property-type":"constant"}},layout_fill:{"fill-sort-key":{type:"number",expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"data-driven"},visibility:{type:"enum",values:{visible:{},none:{}},default:"visible","property-type":"constant"}},layout_circle:{"circle-sort-key":{type:"number",expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"data-driven"},visibility:{type:"enum",values:{visible:{},none:{}},default:"visible","property-type":"constant"}},layout_heatmap:{visibility:{type:"enum",values:{visible:{},none:{}},default:"visible","property-type":"constant"}},"layout_fill-extrusion":{visibility:{type:"enum",values:{visible:{},none:{}},default:"visible","property-type":"constant"}},layout_line:{"line-cap":{type:"enum",values:{butt:{},round:{},square:{}},default:"butt",expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"line-join":{type:"enum",values:{bevel:{},round:{},miter:{}},default:"miter",expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"data-driven"},"line-miter-limit":{type:"number",default:2,requires:[{"line-join":"miter"}],expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"line-round-limit":{type:"number",default:1.05,requires:[{"line-join":"round"}],expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"line-sort-key":{type:"number",expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"data-driven"},visibility:{type:"enum",values:{visible:{},none:{}},default:"visible","property-type":"constant"}},layout_symbol:{"symbol-placement":{type:"enum",values:{point:{},line:{},"line-center":{}},default:"point",expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"symbol-spacing":{type:"number",default:250,minimum:1,units:"pixels",requires:[{"symbol-placement":"line"}],expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"symbol-avoid-edges":{type:"boolean",default:!1,expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"symbol-sort-key":{type:"number",expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"data-driven"},"symbol-z-order":{type:"enum",values:{auto:{},"viewport-y":{},source:{}},default:"auto",expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"icon-allow-overlap":{type:"boolean",default:!1,requires:["icon-image"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"icon-ignore-placement":{type:"boolean",default:!1,requires:["icon-image"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"icon-optional":{type:"boolean",default:!1,requires:["icon-image","text-field"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"icon-rotation-alignment":{type:"enum",values:{map:{},viewport:{},auto:{}},default:"auto",requires:["icon-image"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"icon-size":{type:"number",default:1,minimum:0,units:"factor of the original icon size",requires:["icon-image"],expression:{interpolated:!0,parameters:["zoom","feature"]},"property-type":"data-driven"},"icon-text-fit":{type:"enum",values:{none:{},width:{},height:{},both:{}},default:"none",requires:["icon-image","text-field"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"icon-text-fit-padding":{type:"array",value:"number",length:4,default:[0,0,0,0],units:"pixels",requires:["icon-image","text-field",{"icon-text-fit":["both","width","height"]}],expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"icon-image":{type:"resolvedImage",tokens:!0,expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"data-driven"},"icon-rotate":{type:"number",default:0,period:360,units:"degrees",requires:["icon-image"],expression:{interpolated:!0,parameters:["zoom","feature"]},"property-type":"data-driven"},"icon-padding":{type:"number",default:2,minimum:0,units:"pixels",requires:["icon-image"],expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"icon-keep-upright":{type:"boolean",default:!1,requires:["icon-image",{"icon-rotation-alignment":"map"},{"symbol-placement":["line","line-center"]}],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"icon-offset":{type:"array",value:"number",length:2,default:[0,0],requires:["icon-image"],expression:{interpolated:!0,parameters:["zoom","feature"]},"property-type":"data-driven"},"icon-anchor":{type:"enum",values:{center:{},left:{},right:{},top:{},bottom:{},"top-left":{},"top-right":{},"bottom-left":{},"bottom-right":{}},default:"center",requires:["icon-image"],expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"data-driven"},"icon-pitch-alignment":{type:"enum",values:{map:{},viewport:{},auto:{}},default:"auto",requires:["icon-image"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"text-pitch-alignment":{type:"enum",values:{map:{},viewport:{},auto:{}},default:"auto",requires:["text-field"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"text-rotation-alignment":{type:"enum",values:{map:{},viewport:{},auto:{}},default:"auto",requires:["text-field"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"text-field":{type:"formatted",default:"",tokens:!0,expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"data-driven"},"text-font":{type:"array",value:"string",default:["Open Sans Regular","Arial Unicode MS Regular"],requires:["text-field"],expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"data-driven"},"text-size":{type:"number",default:16,minimum:0,units:"pixels",requires:["text-field"],expression:{interpolated:!0,parameters:["zoom","feature"]},"property-type":"data-driven"},"text-max-width":{type:"number",default:10,minimum:0,units:"ems",requires:["text-field"],expression:{interpolated:!0,parameters:["zoom","feature"]},"property-type":"data-driven"},"text-line-height":{type:"number",default:1.2,units:"ems",requires:["text-field"],expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"text-letter-spacing":{type:"number",default:0,units:"ems",requires:["text-field"],expression:{interpolated:!0,parameters:["zoom","feature"]},"property-type":"data-driven"},"text-justify":{type:"enum",values:{auto:{},left:{},center:{},right:{}},default:"center",requires:["text-field"],expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"data-driven"},"text-radial-offset":{type:"number",units:"ems",default:0,requires:["text-field"],"property-type":"data-driven",expression:{interpolated:!0,parameters:["zoom","feature"]}},"text-variable-anchor":{type:"array",value:"enum",values:{center:{},left:{},right:{},top:{},bottom:{},"top-left":{},"top-right":{},"bottom-left":{},"bottom-right":{}},requires:["text-field",{"symbol-placement":["point"]}],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"text-anchor":{type:"enum",values:{center:{},left:{},right:{},top:{},bottom:{},"top-left":{},"top-right":{},"bottom-left":{},"bottom-right":{}},default:"center",requires:["text-field",{"!":"text-variable-anchor"}],expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"data-driven"},"text-max-angle":{type:"number",default:45,units:"degrees",requires:["text-field",{"symbol-placement":["line","line-center"]}],expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"text-writing-mode":{type:"array",value:"enum",values:{horizontal:{},vertical:{}},requires:["text-field",{"symbol-placement":["point"]}],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"text-rotate":{type:"number",default:0,period:360,units:"degrees",requires:["text-field"],expression:{interpolated:!0,parameters:["zoom","feature"]},"property-type":"data-driven"},"text-padding":{type:"number",default:2,minimum:0,units:"pixels",requires:["text-field"],expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"text-keep-upright":{type:"boolean",default:!0,requires:["text-field",{"text-rotation-alignment":"map"},{"symbol-placement":["line","line-center"]}],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"text-transform":{type:"enum",values:{none:{},uppercase:{},lowercase:{}},default:"none",requires:["text-field"],expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"data-driven"},"text-offset":{type:"array",value:"number",units:"ems",length:2,default:[0,0],requires:["text-field",{"!":"text-radial-offset"}],expression:{interpolated:!0,parameters:["zoom","feature"]},"property-type":"data-driven"},"text-allow-overlap":{type:"boolean",default:!1,requires:["text-field"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"text-ignore-placement":{type:"boolean",default:!1,requires:["text-field"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"text-optional":{type:"boolean",default:!1,requires:["text-field","icon-image"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},visibility:{type:"enum",values:{visible:{},none:{}},default:"visible","property-type":"constant"}},layout_raster:{visibility:{type:"enum",values:{visible:{},none:{}},default:"visible","property-type":"constant"}},layout_hillshade:{visibility:{type:"enum",values:{visible:{},none:{}},default:"visible","property-type":"constant"}},filter:{type:"array",value:"*"},filter_operator:{type:"enum",values:{"==":{},"!=":{},">":{},">=":{},"<":{},"<=":{},in:{},"!in":{},all:{},any:{},none:{},has:{},"!has":{},within:{}}},geometry_type:{type:"enum",values:{Point:{},LineString:{},Polygon:{}}},function:{expression:{type:"expression"},stops:{type:"array",value:"function_stop"},base:{type:"number",default:1,minimum:0},property:{type:"string",default:"$zoom"},type:{type:"enum",values:{identity:{},exponential:{},interval:{},categorical:{}},default:"exponential"},colorSpace:{type:"enum",values:{rgb:{},lab:{},hcl:{}},default:"rgb"},default:{type:"*",required:!1}},function_stop:{type:"array",minimum:0,maximum:24,value:["number","color"],length:2},expression:{type:"array",value:"*",minimum:1},light:{anchor:{type:"enum",default:"viewport",values:{map:{},viewport:{}},"property-type":"data-constant",transition:!1,expression:{interpolated:!1,parameters:["zoom"]}},position:{type:"array",default:[1.15,210,30],length:3,value:"number","property-type":"data-constant",transition:!0,expression:{interpolated:!0,parameters:["zoom"]}},color:{type:"color","property-type":"data-constant",default:"#ffffff",expression:{interpolated:!0,parameters:["zoom"]},transition:!0},intensity:{type:"number","property-type":"data-constant",default:.5,minimum:0,maximum:1,expression:{interpolated:!0,parameters:["zoom"]},transition:!0}},paint:["paint_fill","paint_line","paint_circle","paint_heatmap","paint_fill-extrusion","paint_symbol","paint_raster","paint_hillshade","paint_background"],paint_fill:{"fill-antialias":{type:"boolean",default:!0,expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"fill-opacity":{type:"number",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"fill-color":{type:"color",default:"#000000",transition:!0,requires:[{"!":"fill-pattern"}],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"fill-outline-color":{type:"color",transition:!0,requires:[{"!":"fill-pattern"},{"fill-antialias":!0}],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"fill-translate":{type:"array",value:"number",length:2,default:[0,0],transition:!0,units:"pixels",expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"fill-translate-anchor":{type:"enum",values:{map:{},viewport:{}},default:"map",requires:["fill-translate"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"fill-pattern":{type:"resolvedImage",transition:!0,expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"cross-faded-data-driven"}},"paint_fill-extrusion":{"fill-extrusion-opacity":{type:"number",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"fill-extrusion-color":{type:"color",default:"#000000",transition:!0,requires:[{"!":"fill-extrusion-pattern"}],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"fill-extrusion-translate":{type:"array",value:"number",length:2,default:[0,0],transition:!0,units:"pixels",expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"fill-extrusion-translate-anchor":{type:"enum",values:{map:{},viewport:{}},default:"map",requires:["fill-extrusion-translate"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"fill-extrusion-pattern":{type:"resolvedImage",transition:!0,expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"cross-faded-data-driven"},"fill-extrusion-height":{type:"number",default:0,minimum:0,units:"meters",transition:!0,expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"fill-extrusion-base":{type:"number",default:0,minimum:0,units:"meters",transition:!0,requires:["fill-extrusion-height"],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"fill-extrusion-vertical-gradient":{type:"boolean",default:!0,transition:!1,expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"}},paint_line:{"line-opacity":{type:"number",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"line-color":{type:"color",default:"#000000",transition:!0,requires:[{"!":"line-pattern"}],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"line-translate":{type:"array",value:"number",length:2,default:[0,0],transition:!0,units:"pixels",expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"line-translate-anchor":{type:"enum",values:{map:{},viewport:{}},default:"map",requires:["line-translate"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"line-width":{type:"number",default:1,minimum:0,transition:!0,units:"pixels",expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"line-gap-width":{type:"number",default:0,minimum:0,transition:!0,units:"pixels",expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"line-offset":{type:"number",default:0,transition:!0,units:"pixels",expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"line-blur":{type:"number",default:0,minimum:0,transition:!0,units:"pixels",expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"line-dasharray":{type:"array",value:"number",minimum:0,transition:!0,units:"line widths",requires:[{"!":"line-pattern"}],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"cross-faded"},"line-pattern":{type:"resolvedImage",transition:!0,expression:{interpolated:!1,parameters:["zoom","feature"]},"property-type":"cross-faded-data-driven"},"line-gradient":{type:"color",transition:!1,requires:[{"!":"line-dasharray"},{"!":"line-pattern"},{source:"geojson",has:{lineMetrics:!0}}],expression:{interpolated:!0,parameters:["line-progress"]},"property-type":"color-ramp"}},paint_circle:{"circle-radius":{type:"number",default:5,minimum:0,transition:!0,units:"pixels",expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"circle-color":{type:"color",default:"#000000",transition:!0,expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"circle-blur":{type:"number",default:0,transition:!0,expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"circle-opacity":{type:"number",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"circle-translate":{type:"array",value:"number",length:2,default:[0,0],transition:!0,units:"pixels",expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"circle-translate-anchor":{type:"enum",values:{map:{},viewport:{}},default:"map",requires:["circle-translate"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"circle-pitch-scale":{type:"enum",values:{map:{},viewport:{}},default:"map",expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"circle-pitch-alignment":{type:"enum",values:{map:{},viewport:{}},default:"viewport",expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"circle-stroke-width":{type:"number",default:0,minimum:0,transition:!0,units:"pixels",expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"circle-stroke-color":{type:"color",default:"#000000",transition:!0,expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"circle-stroke-opacity":{type:"number",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"}},paint_heatmap:{"heatmap-radius":{type:"number",default:30,minimum:1,transition:!0,units:"pixels",expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"heatmap-weight":{type:"number",default:1,minimum:0,transition:!1,expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"heatmap-intensity":{type:"number",default:1,minimum:0,transition:!0,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"heatmap-color":{type:"color",default:["interpolate",["linear"],["heatmap-density"],0,"rgba(0, 0, 255, 0)",.1,"royalblue",.3,"cyan",.5,"lime",.7,"yellow",1,"red"],transition:!1,expression:{interpolated:!0,parameters:["heatmap-density"]},"property-type":"color-ramp"},"heatmap-opacity":{type:"number",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"}},paint_symbol:{"icon-opacity":{type:"number",default:1,minimum:0,maximum:1,transition:!0,requires:["icon-image"],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"icon-color":{type:"color",default:"#000000",transition:!0,requires:["icon-image"],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"icon-halo-color":{type:"color",default:"rgba(0, 0, 0, 0)",transition:!0,requires:["icon-image"],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"icon-halo-width":{type:"number",default:0,minimum:0,transition:!0,units:"pixels",requires:["icon-image"],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"icon-halo-blur":{type:"number",default:0,minimum:0,transition:!0,units:"pixels",requires:["icon-image"],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"icon-translate":{type:"array",value:"number",length:2,default:[0,0],transition:!0,units:"pixels",requires:["icon-image"],expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"icon-translate-anchor":{type:"enum",values:{map:{},viewport:{}},default:"map",requires:["icon-image","icon-translate"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"text-opacity":{type:"number",default:1,minimum:0,maximum:1,transition:!0,requires:["text-field"],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"text-color":{type:"color",default:"#000000",transition:!0,overridable:!0,requires:["text-field"],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"text-halo-color":{type:"color",default:"rgba(0, 0, 0, 0)",transition:!0,requires:["text-field"],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"text-halo-width":{type:"number",default:0,minimum:0,transition:!0,units:"pixels",requires:["text-field"],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"text-halo-blur":{type:"number",default:0,minimum:0,transition:!0,units:"pixels",requires:["text-field"],expression:{interpolated:!0,parameters:["zoom","feature","feature-state"]},"property-type":"data-driven"},"text-translate":{type:"array",value:"number",length:2,default:[0,0],transition:!0,units:"pixels",requires:["text-field"],expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"text-translate-anchor":{type:"enum",values:{map:{},viewport:{}},default:"map",requires:["text-field","text-translate"],expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"}},paint_raster:{"raster-opacity":{type:"number",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"raster-hue-rotate":{type:"number",default:0,period:360,transition:!0,units:"degrees",expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"raster-brightness-min":{type:"number",default:0,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"raster-brightness-max":{type:"number",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"raster-saturation":{type:"number",default:0,minimum:-1,maximum:1,transition:!0,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"raster-contrast":{type:"number",default:0,minimum:-1,maximum:1,transition:!0,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"raster-resampling":{type:"enum",values:{linear:{},nearest:{}},default:"linear",expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"raster-fade-duration":{type:"number",default:300,minimum:0,transition:!1,units:"milliseconds",expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"}},paint_hillshade:{"hillshade-illumination-direction":{type:"number",default:335,minimum:0,maximum:359,transition:!1,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"hillshade-illumination-anchor":{type:"enum",values:{map:{},viewport:{}},default:"viewport",expression:{interpolated:!1,parameters:["zoom"]},"property-type":"data-constant"},"hillshade-exaggeration":{type:"number",default:.5,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"hillshade-shadow-color":{type:"color",default:"#000000",transition:!0,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"hillshade-highlight-color":{type:"color",default:"#FFFFFF",transition:!0,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"hillshade-accent-color":{type:"color",default:"#000000",transition:!0,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"}},paint_background:{"background-color":{type:"color",default:"#000000",transition:!0,requires:[{"!":"background-pattern"}],expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"},"background-pattern":{type:"resolvedImage",transition:!0,expression:{interpolated:!1,parameters:["zoom"]},"property-type":"cross-faded"},"background-opacity":{type:"number",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:["zoom"]},"property-type":"data-constant"}},transition:{duration:{type:"number",default:300,minimum:0,units:"milliseconds"},delay:{type:"number",default:0,minimum:0,units:"milliseconds"}},"property-type":{"data-driven":{type:"property-type"},"cross-faded":{type:"property-type"},"cross-faded-data-driven":{type:"property-type"},"color-ramp":{type:"property-type"},"data-constant":{type:"property-type"},constant:{type:"property-type"}},promoteId:{"*":{type:"string"}}},Mt=function(t,e,n,r){this.message=(t?t+": ":"")+n,r&&(this.identifier=r),null!=e&&e.__line__&&(this.line=e.__line__)};function It(t){var e=t.value;return e?[new Mt(t.key,e,"constants have been deprecated as of v8")]:[]}function Bt(t){for(var e=[],n=arguments.length-1;n-- >0;)e[n]=arguments[n+1];for(var r=0,i=e;r<i.length;r+=1){var o=i[r];for(var a in o)t[a]=o[a]}return t}function Rt(t){return t instanceof Number||t instanceof String||t instanceof Boolean?t.valueOf():t}function kt(t){if(Array.isArray(t))return t.map(kt);if(t instanceof Object&&!(t instanceof Number||t instanceof String||t instanceof Boolean)){var e={};for(var n in t)e[n]=kt(t[n]);return e}return Rt(t)}var Dt=function(t){function e(e,n){t.call(this,n),this.message=n,this.key=e}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e}(Error),Lt=function(t,e){void 0===e&&(e=[]),this.parent=t,this.bindings={};for(var n=0,r=e;n<r.length;n+=1){var i=r[n];this.bindings[i[0]]=i[1]}};Lt.prototype.concat=function(t){return new Lt(this,t)},Lt.prototype.get=function(t){if(this.bindings[t])return this.bindings[t];if(this.parent)return this.parent.get(t);throw new Error(t+" not found in scope.")},Lt.prototype.has=function(t){return!!this.bindings[t]||!!this.parent&&this.parent.has(t)};var jt={kind:"null"},Ft={kind:"number"},zt={kind:"string"},Ut={kind:"boolean"},Nt={kind:"color"},Gt={kind:"object"},Vt={kind:"value"},Ht={kind:"collator"},Wt={kind:"formatted"},qt={kind:"resolvedImage"};function Xt(t,e){return{kind:"array",itemType:t,N:e}}function Zt(t){if("array"===t.kind){var e=Zt(t.itemType);return"number"==typeof t.N?"array<"+e+", "+t.N+">":"value"===t.itemType.kind?"array":"array<"+e+">"}return t.kind}var Jt=[jt,Ft,zt,Ut,Nt,Wt,Gt,Xt(Vt),qt];function Qt(t,e){if("error"===e.kind)return null;if("array"===t.kind){if("array"===e.kind&&(0===e.N&&"value"===e.itemType.kind||!Qt(t.itemType,e.itemType))&&("number"!=typeof t.N||t.N===e.N))return null}else{if(t.kind===e.kind)return null;if("value"===t.kind)for(var n=0,r=Jt;n<r.length;n+=1)if(!Qt(r[n],e))return null}return"Expected "+Zt(t)+" but found "+Zt(e)+" instead."}function Kt(t,e){return e.some((function(e){return e.kind===t.kind}))}function Yt(t,e){return e.some((function(e){return"null"===e?null===t:"array"===e?Array.isArray(t):"object"===e?t&&!Array.isArray(t)&&"object"==typeof t:e===typeof t}))}var $t=e((function(t,e){var n={transparent:[0,0,0,0],aliceblue:[240,248,255,1],antiquewhite:[250,235,215,1],aqua:[0,255,255,1],aquamarine:[127,255,212,1],azure:[240,255,255,1],beige:[245,245,220,1],bisque:[255,228,196,1],black:[0,0,0,1],blanchedalmond:[255,235,205,1],blue:[0,0,255,1],blueviolet:[138,43,226,1],brown:[165,42,42,1],burlywood:[222,184,135,1],cadetblue:[95,158,160,1],chartreuse:[127,255,0,1],chocolate:[210,105,30,1],coral:[255,127,80,1],cornflowerblue:[100,149,237,1],cornsilk:[255,248,220,1],crimson:[220,20,60,1],cyan:[0,255,255,1],darkblue:[0,0,139,1],darkcyan:[0,139,139,1],darkgoldenrod:[184,134,11,1],darkgray:[169,169,169,1],darkgreen:[0,100,0,1],darkgrey:[169,169,169,1],darkkhaki:[189,183,107,1],darkmagenta:[139,0,139,1],darkolivegreen:[85,107,47,1],darkorange:[255,140,0,1],darkorchid:[153,50,204,1],darkred:[139,0,0,1],darksalmon:[233,150,122,1],darkseagreen:[143,188,143,1],darkslateblue:[72,61,139,1],darkslategray:[47,79,79,1],darkslategrey:[47,79,79,1],darkturquoise:[0,206,209,1],darkviolet:[148,0,211,1],deeppink:[255,20,147,1],deepskyblue:[0,191,255,1],dimgray:[105,105,105,1],dimgrey:[105,105,105,1],dodgerblue:[30,144,255,1],firebrick:[178,34,34,1],floralwhite:[255,250,240,1],forestgreen:[34,139,34,1],fuchsia:[255,0,255,1],gainsboro:[220,220,220,1],ghostwhite:[248,248,255,1],gold:[255,215,0,1],goldenrod:[218,165,32,1],gray:[128,128,128,1],green:[0,128,0,1],greenyellow:[173,255,47,1],grey:[128,128,128,1],honeydew:[240,255,240,1],hotpink:[255,105,180,1],indianred:[205,92,92,1],indigo:[75,0,130,1],ivory:[255,255,240,1],khaki:[240,230,140,1],lavender:[230,230,250,1],lavenderblush:[255,240,245,1],lawngreen:[124,252,0,1],lemonchiffon:[255,250,205,1],lightblue:[173,216,230,1],lightcoral:[240,128,128,1],lightcyan:[224,255,255,1],lightgoldenrodyellow:[250,250,210,1],lightgray:[211,211,211,1],lightgreen:[144,238,144,1],lightgrey:[211,211,211,1],lightpink:[255,182,193,1],lightsalmon:[255,160,122,1],lightseagreen:[32,178,170,1],lightskyblue:[135,206,250,1],lightslategray:[119,136,153,1],lightslategrey:[119,136,153,1],lightsteelblue:[176,196,222,1],lightyellow:[255,255,224,1],lime:[0,255,0,1],limegreen:[50,205,50,1],linen:[250,240,230,1],magenta:[255,0,255,1],maroon:[128,0,0,1],mediumaquamarine:[102,205,170,1],mediumblue:[0,0,205,1],mediumorchid:[186,85,211,1],mediumpurple:[147,112,219,1],mediumseagreen:[60,179,113,1],mediumslateblue:[123,104,238,1],mediumspringgreen:[0,250,154,1],mediumturquoise:[72,209,204,1],mediumvioletred:[199,21,133,1],midnightblue:[25,25,112,1],mintcream:[245,255,250,1],mistyrose:[255,228,225,1],moccasin:[255,228,181,1],navajowhite:[255,222,173,1],navy:[0,0,128,1],oldlace:[253,245,230,1],olive:[128,128,0,1],olivedrab:[107,142,35,1],orange:[255,165,0,1],orangered:[255,69,0,1],orchid:[218,112,214,1],palegoldenrod:[238,232,170,1],palegreen:[152,251,152,1],paleturquoise:[175,238,238,1],palevioletred:[219,112,147,1],papayawhip:[255,239,213,1],peachpuff:[255,218,185,1],peru:[205,133,63,1],pink:[255,192,203,1],plum:[221,160,221,1],powderblue:[176,224,230,1],purple:[128,0,128,1],rebeccapurple:[102,51,153,1],red:[255,0,0,1],rosybrown:[188,143,143,1],royalblue:[65,105,225,1],saddlebrown:[139,69,19,1],salmon:[250,128,114,1],sandybrown:[244,164,96,1],seagreen:[46,139,87,1],seashell:[255,245,238,1],sienna:[160,82,45,1],silver:[192,192,192,1],skyblue:[135,206,235,1],slateblue:[106,90,205,1],slategray:[112,128,144,1],slategrey:[112,128,144,1],snow:[255,250,250,1],springgreen:[0,255,127,1],steelblue:[70,130,180,1],tan:[210,180,140,1],teal:[0,128,128,1],thistle:[216,191,216,1],tomato:[255,99,71,1],turquoise:[64,224,208,1],violet:[238,130,238,1],wheat:[245,222,179,1],white:[255,255,255,1],whitesmoke:[245,245,245,1],yellow:[255,255,0,1],yellowgreen:[154,205,50,1]};function r(t){return(t=Math.round(t))<0?0:t>255?255:t}function i(t){return r("%"===t[t.length-1]?parseFloat(t)/100*255:parseInt(t))}function o(t){return(e="%"===t[t.length-1]?parseFloat(t)/100:parseFloat(t))<0?0:e>1?1:e;var e}function a(t,e,n){return n<0?n+=1:n>1&&(n-=1),6*n<1?t+(e-t)*n*6:2*n<1?e:3*n<2?t+(e-t)*(2/3-n)*6:t}try{e.parseCSSColor=function(t){var e,s=t.replace(/ /g,"").toLowerCase();if(s in n)return n[s].slice();if("#"===s[0])return 4===s.length?(e=parseInt(s.substr(1),16))>=0&&e<=4095?[(3840&e)>>4|(3840&e)>>8,240&e|(240&e)>>4,15&e|(15&e)<<4,1]:null:7===s.length&&(e=parseInt(s.substr(1),16))>=0&&e<=16777215?[(16711680&e)>>16,(65280&e)>>8,255&e,1]:null;var u=s.indexOf("("),c=s.indexOf(")");if(-1!==u&&c+1===s.length){var l=s.substr(0,u),h=s.substr(u+1,c-(u+1)).split(","),f=1;switch(l){case"rgba":if(4!==h.length)return null;f=o(h.pop());case"rgb":return 3!==h.length?null:[i(h[0]),i(h[1]),i(h[2]),f];case"hsla":if(4!==h.length)return null;f=o(h.pop());case"hsl":if(3!==h.length)return null;var p=(parseFloat(h[0])%360+360)%360/360,d=o(h[1]),A=o(h[2]),g=A<=.5?A*(d+1):A+d-A*d,m=2*A-g;return[r(255*a(m,g,p+1/3)),r(255*a(m,g,p)),r(255*a(m,g,p-1/3)),f];default:return null}}return null}}catch(t){}})).parseCSSColor,te=function(t,e,n,r){void 0===r&&(r=1),this.r=t,this.g=e,this.b=n,this.a=r};te.parse=function(t){if(t){if(t instanceof te)return t;if("string"==typeof t){var e=$t(t);if(e)return new te(e[0]/255*e[3],e[1]/255*e[3],e[2]/255*e[3],e[3])}}},te.prototype.toString=function(){var t=this.toArray(),e=t[1],n=t[2],r=t[3];return"rgba("+Math.round(t[0])+","+Math.round(e)+","+Math.round(n)+","+r+")"},te.prototype.toArray=function(){var t=this.a;return 0===t?[0,0,0,0]:[255*this.r/t,255*this.g/t,255*this.b/t,t]},te.black=new te(0,0,0,1),te.white=new te(1,1,1,1),te.transparent=new te(0,0,0,0),te.red=new te(1,0,0,1);var ee=function(t,e,n){this.sensitivity=t?e?"variant":"case":e?"accent":"base",this.locale=n,this.collator=new Intl.Collator(this.locale?this.locale:[],{sensitivity:this.sensitivity,usage:"search"})};ee.prototype.compare=function(t,e){return this.collator.compare(t,e)},ee.prototype.resolvedLocale=function(){return new Intl.Collator(this.locale?this.locale:[]).resolvedOptions().locale};var ne=function(t,e,n,r,i){this.text=t,this.image=e,this.scale=n,this.fontStack=r,this.textColor=i},re=function(t){this.sections=t};re.fromString=function(t){return new re([new ne(t,null,null,null,null)])},re.prototype.isEmpty=function(){return 0===this.sections.length||!this.sections.some((function(t){return 0!==t.text.length||t.image&&0!==t.image.name.length}))},re.factory=function(t){return t instanceof re?t:re.fromString(t)},re.prototype.toString=function(){return 0===this.sections.length?"":this.sections.map((function(t){return t.text})).join("")},re.prototype.serialize=function(){for(var t=["format"],e=0,n=this.sections;e<n.length;e+=1){var r=n[e];if(r.image)t.push(["image",r.image.name]);else{t.push(r.text);var i={};r.fontStack&&(i["text-font"]=["literal",r.fontStack.split(",")]),r.scale&&(i["font-scale"]=r.scale),r.textColor&&(i["text-color"]=["rgba"].concat(r.textColor.toArray())),t.push(i)}}return t};var ie=function(t){this.name=t.name,this.available=t.available};function oe(t,e,n,r){return"number"==typeof t&&t>=0&&t<=255&&"number"==typeof e&&e>=0&&e<=255&&"number"==typeof n&&n>=0&&n<=255?void 0===r||"number"==typeof r&&r>=0&&r<=1?null:"Invalid rgba value ["+[t,e,n,r].join(", ")+"]: 'a' must be between 0 and 1.":"Invalid rgba value ["+("number"==typeof r?[t,e,n,r]:[t,e,n]).join(", ")+"]: 'r', 'g', and 'b' must be between 0 and 255."}function ae(t){if(null===t)return!0;if("string"==typeof t)return!0;if("boolean"==typeof t)return!0;if("number"==typeof t)return!0;if(t instanceof te)return!0;if(t instanceof ee)return!0;if(t instanceof re)return!0;if(t instanceof ie)return!0;if(Array.isArray(t)){for(var e=0,n=t;e<n.length;e+=1)if(!ae(n[e]))return!1;return!0}if("object"==typeof t){for(var r in t)if(!ae(t[r]))return!1;return!0}return!1}function se(t){if(null===t)return jt;if("string"==typeof t)return zt;if("boolean"==typeof t)return Ut;if("number"==typeof t)return Ft;if(t instanceof te)return Nt;if(t instanceof ee)return Ht;if(t instanceof re)return Wt;if(t instanceof ie)return qt;if(Array.isArray(t)){for(var e,n=t.length,r=0,i=t;r<i.length;r+=1){var o=se(i[r]);if(e){if(e===o)continue;e=Vt;break}e=o}return Xt(e||Vt,n)}return Gt}function ue(t){var e=typeof t;return null===t?"":"string"===e||"number"===e||"boolean"===e?String(t):t instanceof te||t instanceof re||t instanceof ie?t.toString():JSON.stringify(t)}ie.prototype.toString=function(){return this.name},ie.fromString=function(t){return t?new ie({name:t,available:!1}):null},ie.prototype.serialize=function(){return["image",this.name]};var ce=function(t,e){this.type=t,this.value=e};ce.parse=function(t,e){if(2!==t.length)return e.error("'literal' expression requires exactly one argument, but found "+(t.length-1)+" instead.");if(!ae(t[1]))return e.error("invalid value");var n=t[1],r=se(n),i=e.expectedType;return"array"!==r.kind||0!==r.N||!i||"array"!==i.kind||"number"==typeof i.N&&0!==i.N||(r=i),new ce(r,n)},ce.prototype.evaluate=function(){return this.value},ce.prototype.eachChild=function(){},ce.prototype.outputDefined=function(){return!0},ce.prototype.serialize=function(){return"array"===this.type.kind||"object"===this.type.kind?["literal",this.value]:this.value instanceof te?["rgba"].concat(this.value.toArray()):this.value instanceof re?this.value.serialize():this.value};var le=function(t){this.name="ExpressionEvaluationError",this.message=t};le.prototype.toJSON=function(){return this.message};var he={string:zt,number:Ft,boolean:Ut,object:Gt},fe=function(t,e){this.type=t,this.args=e};fe.parse=function(t,e){if(t.length<2)return e.error("Expected at least one argument.");var n,r=1,i=t[0];if("array"===i){var o,a;if(t.length>2){var s=t[1];if("string"!=typeof s||!(s in he)||"object"===s)return e.error('The item type argument of "array" must be one of string, number, boolean',1);o=he[s],r++}else o=Vt;if(t.length>3){if(null!==t[2]&&("number"!=typeof t[2]||t[2]<0||t[2]!==Math.floor(t[2])))return e.error('The length argument to "array" must be a positive integer literal',2);a=t[2],r++}n=Xt(o,a)}else n=he[i];for(var u=[];r<t.length;r++){var c=e.parse(t[r],r,Vt);if(!c)return null;u.push(c)}return new fe(n,u)},fe.prototype.evaluate=function(t){for(var e=0;e<this.args.length;e++){var n=this.args[e].evaluate(t);if(!Qt(this.type,se(n)))return n;if(e===this.args.length-1)throw new le("Expected value to be of type "+Zt(this.type)+", but found "+Zt(se(n))+" instead.")}return null},fe.prototype.eachChild=function(t){this.args.forEach(t)},fe.prototype.outputDefined=function(){return this.args.every((function(t){return t.outputDefined()}))},fe.prototype.serialize=function(){var t=this.type,e=[t.kind];if("array"===t.kind){var n=t.itemType;if("string"===n.kind||"number"===n.kind||"boolean"===n.kind){e.push(n.kind);var r=t.N;("number"==typeof r||this.args.length>1)&&e.push(r)}}return e.concat(this.args.map((function(t){return t.serialize()})))};var pe=function(t){this.type=Wt,this.sections=t};pe.parse=function(t,e){if(t.length<2)return e.error("Expected at least one argument.");var n=t[1];if(!Array.isArray(n)&&"object"==typeof n)return e.error("First argument must be an image or text section.");for(var r=[],i=!1,o=1;o<=t.length-1;++o){var a=t[o];if(i&&"object"==typeof a&&!Array.isArray(a)){i=!1;var s=null;if(a["font-scale"]&&!(s=e.parse(a["font-scale"],1,Ft)))return null;var u=null;if(a["text-font"]&&!(u=e.parse(a["text-font"],1,Xt(zt))))return null;var c=null;if(a["text-color"]&&!(c=e.parse(a["text-color"],1,Nt)))return null;var l=r[r.length-1];l.scale=s,l.font=u,l.textColor=c}else{var h=e.parse(t[o],1,Vt);if(!h)return null;var f=h.type.kind;if("string"!==f&&"value"!==f&&"null"!==f&&"resolvedImage"!==f)return e.error("Formatted text type must be 'string', 'value', 'image' or 'null'.");i=!0,r.push({content:h,scale:null,font:null,textColor:null})}}return new pe(r)},pe.prototype.evaluate=function(t){return new re(this.sections.map((function(e){var n=e.content.evaluate(t);return se(n)===qt?new ne("",n,null,null,null):new ne(ue(n),null,e.scale?e.scale.evaluate(t):null,e.font?e.font.evaluate(t).join(","):null,e.textColor?e.textColor.evaluate(t):null)})))},pe.prototype.eachChild=function(t){for(var e=0,n=this.sections;e<n.length;e+=1){var r=n[e];t(r.content),r.scale&&t(r.scale),r.font&&t(r.font),r.textColor&&t(r.textColor)}},pe.prototype.outputDefined=function(){return!1},pe.prototype.serialize=function(){for(var t=["format"],e=0,n=this.sections;e<n.length;e+=1){var r=n[e];t.push(r.content.serialize());var i={};r.scale&&(i["font-scale"]=r.scale.serialize()),r.font&&(i["text-font"]=r.font.serialize()),r.textColor&&(i["text-color"]=r.textColor.serialize()),t.push(i)}return t};var de=function(t){this.type=qt,this.input=t};de.parse=function(t,e){if(2!==t.length)return e.error("Expected two arguments.");var n=e.parse(t[1],1,zt);return n?new de(n):e.error("No image name provided.")},de.prototype.evaluate=function(t){var e=this.input.evaluate(t),n=ie.fromString(e);return n&&t.availableImages&&(n.available=t.availableImages.indexOf(e)>-1),n},de.prototype.eachChild=function(t){t(this.input)},de.prototype.outputDefined=function(){return!1},de.prototype.serialize=function(){return["image",this.input.serialize()]};var Ae={"to-boolean":Ut,"to-color":Nt,"to-number":Ft,"to-string":zt},ge=function(t,e){this.type=t,this.args=e};ge.parse=function(t,e){if(t.length<2)return e.error("Expected at least one argument.");var n=t[0];if(("to-boolean"===n||"to-string"===n)&&2!==t.length)return e.error("Expected one argument.");for(var r=Ae[n],i=[],o=1;o<t.length;o++){var a=e.parse(t[o],o,Vt);if(!a)return null;i.push(a)}return new ge(r,i)},ge.prototype.evaluate=function(t){if("boolean"===this.type.kind)return Boolean(this.args[0].evaluate(t));if("color"===this.type.kind){for(var e,n,r=0,i=this.args;r<i.length;r+=1){if(n=null,(e=i[r].evaluate(t))instanceof te)return e;if("string"==typeof e){var o=t.parseColor(e);if(o)return o}else if(Array.isArray(e)&&!(n=e.length<3||e.length>4?"Invalid rbga value "+JSON.stringify(e)+": expected an array containing either three or four numeric values.":oe(e[0],e[1],e[2],e[3])))return new te(e[0]/255,e[1]/255,e[2]/255,e[3])}throw new le(n||"Could not parse color from value '"+("string"==typeof e?e:String(JSON.stringify(e)))+"'")}if("number"===this.type.kind){for(var a=null,s=0,u=this.args;s<u.length;s+=1){if(null===(a=u[s].evaluate(t)))return 0;var c=Number(a);if(!isNaN(c))return c}throw new le("Could not convert "+JSON.stringify(a)+" to number.")}return"formatted"===this.type.kind?re.fromString(ue(this.args[0].evaluate(t))):"resolvedImage"===this.type.kind?ie.fromString(ue(this.args[0].evaluate(t))):ue(this.args[0].evaluate(t))},ge.prototype.eachChild=function(t){this.args.forEach(t)},ge.prototype.outputDefined=function(){return this.args.every((function(t){return t.outputDefined()}))},ge.prototype.serialize=function(){if("formatted"===this.type.kind)return new pe([{content:this.args[0],scale:null,font:null,textColor:null}]).serialize();if("resolvedImage"===this.type.kind)return new de(this.args[0]).serialize();var t=["to-"+this.type.kind];return this.eachChild((function(e){t.push(e.serialize())})),t};var me=["Unknown","Point","LineString","Polygon"],ye=function(){this.globals=null,this.feature=null,this.featureState=null,this.formattedSection=null,this._parseColorCache={},this.availableImages=null,this.canonical=null};ye.prototype.id=function(){return this.feature&&"id"in this.feature?this.feature.id:null},ye.prototype.geometryType=function(){return this.feature?"number"==typeof this.feature.type?me[this.feature.type]:this.feature.type:null},ye.prototype.geometry=function(){return this.feature&&"geometry"in this.feature?this.feature.geometry:null},ye.prototype.canonicalID=function(){return this.canonical},ye.prototype.properties=function(){return this.feature&&this.feature.properties||{}},ye.prototype.parseColor=function(t){var e=this._parseColorCache[t];return e||(e=this._parseColorCache[t]=te.parse(t)),e};var ve=function(t,e,n,r){this.name=t,this.type=e,this._evaluate=n,this.args=r};ve.prototype.evaluate=function(t){return this._evaluate(t,this.args)},ve.prototype.eachChild=function(t){this.args.forEach(t)},ve.prototype.outputDefined=function(){return!1},ve.prototype.serialize=function(){return[this.name].concat(this.args.map((function(t){return t.serialize()})))},ve.parse=function(t,e){var n,r=t[0],i=ve.definitions[r];if(!i)return e.error('Unknown expression "'+r+'". If you wanted a literal array, use ["literal", [...]].',0);for(var o=Array.isArray(i)?i[0]:i.type,a=Array.isArray(i)?[[i[1],i[2]]]:i.overloads,s=a.filter((function(e){var n=e[0];return!Array.isArray(n)||n.length===t.length-1})),u=null,c=0,l=s;c<l.length;c+=1){var h=l[c],f=h[0],p=h[1];u=new Ne(e.registry,e.path,null,e.scope);for(var d=[],A=!1,g=1;g<t.length;g++){var m=t[g],y=Array.isArray(f)?f[g-1]:f.type,v=u.parse(m,1+d.length,y);if(!v){A=!0;break}d.push(v)}if(!A)if(Array.isArray(f)&&f.length!==d.length)u.error("Expected "+f.length+" arguments, but found "+d.length+" instead.");else{for(var _=0;_<d.length;_++){var b=Array.isArray(f)?f[_]:f.type,x=d[_];u.concat(_+1).checkSubtype(b,x.type)}if(0===u.errors.length)return new ve(r,o,p,d)}}if(1===s.length)(n=e.errors).push.apply(n,u.errors);else{for(var w=(s.length?s:a).map((function(t){var e;return e=t[0],Array.isArray(e)?"("+e.map(Zt).join(", ")+")":"("+Zt(e.type)+"...)"})).join(" | "),E=[],O=1;O<t.length;O++){var S=e.parse(t[O],1+E.length);if(!S)return null;E.push(Zt(S.type))}e.error("Expected arguments of type "+w+", but found ("+E.join(", ")+") instead.")}return null},ve.register=function(t,e){for(var n in ve.definitions=e,e)t[n]=ve};var _e=function(t,e,n){this.type=Ht,this.locale=n,this.caseSensitive=t,this.diacriticSensitive=e};function be(t,e){t[0]=Math.min(t[0],e[0]),t[1]=Math.min(t[1],e[1]),t[2]=Math.max(t[2],e[0]),t[3]=Math.max(t[3],e[1])}function xe(t,e){return!(t[0]<=e[0]||t[2]>=e[2]||t[1]<=e[1]||t[3]>=e[3])}function we(t,e){var n=(180+t[0])/360,r=(180-180/Math.PI*Math.log(Math.tan(Math.PI/4+t[1]*Math.PI/360)))/360,i=Math.pow(2,e.z);return[Math.round(n*i*8192),Math.round(r*i*8192)]}function Ee(t,e,n){return e[1]>t[1]!=n[1]>t[1]&&t[0]<(n[0]-e[0])*(t[1]-e[1])/(n[1]-e[1])+e[0]}function Oe(t,e){for(var n,r,i,o,a,s,u,c=!1,l=0,h=e.length;l<h;l++)for(var f=e[l],p=0,d=f.length;p<d-1;p++){if((o=(n=t)[0]-(r=f[p])[0])*(u=n[1]-(i=f[p+1])[1])-(s=n[0]-i[0])*(a=n[1]-r[1])==0&&o*s<=0&&a*u<=0)return!1;Ee(t,f[p],f[p+1])&&(c=!c)}return c}function Se(t,e){for(var n=0;n<e.length;n++)if(Oe(t,e[n]))return!0;return!1}function Te(t,e,n,r){var i=r[0]-n[0],o=r[1]-n[1],a=(t[0]-n[0])*o-i*(t[1]-n[1]),s=(e[0]-n[0])*o-i*(e[1]-n[1]);return a>0&&s<0||a<0&&s>0}function Ce(t,e,n){for(var r=0,i=n;r<i.length;r+=1)for(var o=i[r],a=0;a<o.length-1;++a)if(0!=(h=[(l=o[a+1])[0]-(c=o[a])[0],l[1]-c[1]])[0]*(f=[(u=e)[0]-(s=t)[0],u[1]-s[1]])[1]-h[1]*f[0]&&Te(s,u,c,l)&&Te(c,l,s,u))return!0;var s,u,c,l,h,f;return!1}function Pe(t,e){for(var n=0;n<t.length;++n)if(!Oe(t[n],e))return!1;for(var r=0;r<t.length-1;++r)if(Ce(t[r],t[r+1],e))return!1;return!0}function Me(t,e){for(var n=0;n<e.length;n++)if(Pe(t,e[n]))return!0;return!1}function Ie(t,e,n){for(var r=[],i=0;i<t.length;i++){for(var o=[],a=0;a<t[i].length;a++){var s=we(t[i][a],n);be(e,s),o.push(s)}r.push(o)}return r}function Be(t,e,n){for(var r=[],i=0;i<t.length;i++){var o=Ie(t[i],e,n);r.push(o)}return r}function Re(t,e,n,r){if(t[0]<n[0]||t[0]>n[2]){var i=.5*r,o=t[0]-n[0]>i?-r:n[0]-t[0]>i?r:0;0===o&&(o=t[0]-n[2]>i?-r:n[2]-t[0]>i?r:0),t[0]+=o}be(e,t)}function ke(t,e,n,r){for(var i=8192*Math.pow(2,r.z),o=[8192*r.x,8192*r.y],a=[],s=0,u=t;s<u.length;s+=1)for(var c=0,l=u[s];c<l.length;c+=1){var h=l[c],f=[h.x+o[0],h.y+o[1]];Re(f,e,n,i),a.push(f)}return a}function De(t,e,n,r){for(var i,o=8192*Math.pow(2,r.z),a=[8192*r.x,8192*r.y],s=[],u=0,c=t;u<c.length;u+=1){for(var l=[],h=0,f=c[u];h<f.length;h+=1){var p=f[h],d=[p.x+a[0],p.y+a[1]];be(e,d),l.push(d)}s.push(l)}if(e[2]-e[0]<=o/2){(i=e)[0]=i[1]=1/0,i[2]=i[3]=-1/0;for(var A=0,g=s;A<g.length;A+=1)for(var m=0,y=g[A];m<y.length;m+=1)Re(y[m],e,n,o)}return s}_e.parse=function(t,e){if(2!==t.length)return e.error("Expected one argument.");var n=t[1];if("object"!=typeof n||Array.isArray(n))return e.error("Collator options argument must be an object.");var r=e.parse(void 0!==n["case-sensitive"]&&n["case-sensitive"],1,Ut);if(!r)return null;var i=e.parse(void 0!==n["diacritic-sensitive"]&&n["diacritic-sensitive"],1,Ut);if(!i)return null;var o=null;return n.locale&&!(o=e.parse(n.locale,1,zt))?null:new _e(r,i,o)},_e.prototype.evaluate=function(t){return new ee(this.caseSensitive.evaluate(t),this.diacriticSensitive.evaluate(t),this.locale?this.locale.evaluate(t):null)},_e.prototype.eachChild=function(t){t(this.caseSensitive),t(this.diacriticSensitive),this.locale&&t(this.locale)},_e.prototype.outputDefined=function(){return!1},_e.prototype.serialize=function(){var t={};return t["case-sensitive"]=this.caseSensitive.serialize(),t["diacritic-sensitive"]=this.diacriticSensitive.serialize(),this.locale&&(t.locale=this.locale.serialize()),["collator",t]};var Le=function(t,e){this.type=Ut,this.geojson=t,this.geometries=e};function je(t){if(t instanceof ve){if("get"===t.name&&1===t.args.length)return!1;if("feature-state"===t.name)return!1;if("has"===t.name&&1===t.args.length)return!1;if("properties"===t.name||"geometry-type"===t.name||"id"===t.name)return!1;if(/^filter-/.test(t.name))return!1}if(t instanceof Le)return!1;var e=!0;return t.eachChild((function(t){e&&!je(t)&&(e=!1)})),e}function Fe(t){if(t instanceof ve&&"feature-state"===t.name)return!1;var e=!0;return t.eachChild((function(t){e&&!Fe(t)&&(e=!1)})),e}function ze(t,e){if(t instanceof ve&&e.indexOf(t.name)>=0)return!1;var n=!0;return t.eachChild((function(t){n&&!ze(t,e)&&(n=!1)})),n}Le.parse=function(t,e){if(2!==t.length)return e.error("'within' expression requires exactly one argument, but found "+(t.length-1)+" instead.");if(ae(t[1])){var n=t[1];if("FeatureCollection"===n.type)for(var r=0;r<n.features.length;++r){var i=n.features[r].geometry.type;if("Polygon"===i||"MultiPolygon"===i)return new Le(n,n.features[r].geometry)}else if("Feature"===n.type){var o=n.geometry.type;if("Polygon"===o||"MultiPolygon"===o)return new Le(n,n.geometry)}else if("Polygon"===n.type||"MultiPolygon"===n.type)return new Le(n,n)}return e.error("'within' expression requires valid geojson object that contains polygon geometry type.")},Le.prototype.evaluate=function(t){if(null!=t.geometry()&&null!=t.canonicalID()){if("Point"===t.geometryType())return function(t,e){var n=[1/0,1/0,-1/0,-1/0],r=[1/0,1/0,-1/0,-1/0],i=t.canonicalID();if("Polygon"===e.type){var o=Ie(e.coordinates,r,i),a=ke(t.geometry(),n,r,i);if(!xe(n,r))return!1;for(var s=0,u=a;s<u.length;s+=1)if(!Oe(u[s],o))return!1}if("MultiPolygon"===e.type){var c=Be(e.coordinates,r,i),l=ke(t.geometry(),n,r,i);if(!xe(n,r))return!1;for(var h=0,f=l;h<f.length;h+=1)if(!Se(f[h],c))return!1}return!0}(t,this.geometries);if("LineString"===t.geometryType())return function(t,e){var n=[1/0,1/0,-1/0,-1/0],r=[1/0,1/0,-1/0,-1/0],i=t.canonicalID();if("Polygon"===e.type){var o=Ie(e.coordinates,r,i),a=De(t.geometry(),n,r,i);if(!xe(n,r))return!1;for(var s=0,u=a;s<u.length;s+=1)if(!Pe(u[s],o))return!1}if("MultiPolygon"===e.type){var c=Be(e.coordinates,r,i),l=De(t.geometry(),n,r,i);if(!xe(n,r))return!1;for(var h=0,f=l;h<f.length;h+=1)if(!Me(f[h],c))return!1}return!0}(t,this.geometries)}return!1},Le.prototype.eachChild=function(){},Le.prototype.outputDefined=function(){return!0},Le.prototype.serialize=function(){return["within",this.geojson]};var Ue=function(t,e){this.type=e.type,this.name=t,this.boundExpression=e};Ue.parse=function(t,e){if(2!==t.length||"string"!=typeof t[1])return e.error("'var' expression requires exactly one string literal argument.");var n=t[1];return e.scope.has(n)?new Ue(n,e.scope.get(n)):e.error('Unknown variable "'+n+'". Make sure "'+n+'" has been bound in an enclosing "let" expression before using it.',1)},Ue.prototype.evaluate=function(t){return this.boundExpression.evaluate(t)},Ue.prototype.eachChild=function(){},Ue.prototype.outputDefined=function(){return!1},Ue.prototype.serialize=function(){return["var",this.name]};var Ne=function(t,e,n,r,i){void 0===e&&(e=[]),void 0===r&&(r=new Lt),void 0===i&&(i=[]),this.registry=t,this.path=e,this.key=e.map((function(t){return"["+t+"]"})).join(""),this.scope=r,this.errors=i,this.expectedType=n};function Ge(t,e){for(var n,r=t.length-1,i=0,o=r,a=0;i<=o;)if((n=t[a=Math.floor((i+o)/2)])<=e){if(a===r||e<t[a+1])return a;i=a+1}else{if(!(n>e))throw new le("Input is not a number.");o=a-1}return 0}Ne.prototype.parse=function(t,e,n,r,i){return void 0===i&&(i={}),e?this.concat(e,n,r)._parse(t,i):this._parse(t,i)},Ne.prototype._parse=function(t,e){function n(t,e,n){return"assert"===n?new fe(e,[t]):"coerce"===n?new ge(e,[t]):t}if(null!==t&&"string"!=typeof t&&"boolean"!=typeof t&&"number"!=typeof t||(t=["literal",t]),Array.isArray(t)){if(0===t.length)return this.error('Expected an array with at least one element. If you wanted a literal array, use ["literal", []].');var r=t[0];if("string"!=typeof r)return this.error("Expression name must be a string, but found "+typeof r+' instead. If you wanted a literal array, use ["literal", [...]].',0),null;var i=this.registry[r];if(i){var o=i.parse(t,this);if(!o)return null;if(this.expectedType){var a=this.expectedType,s=o.type;if("string"!==a.kind&&"number"!==a.kind&&"boolean"!==a.kind&&"object"!==a.kind&&"array"!==a.kind||"value"!==s.kind)if("color"!==a.kind&&"formatted"!==a.kind&&"resolvedImage"!==a.kind||"value"!==s.kind&&"string"!==s.kind){if(this.checkSubtype(a,s))return null}else o=n(o,a,e.typeAnnotation||"coerce");else o=n(o,a,e.typeAnnotation||"assert")}if(!(o instanceof ce)&&"resolvedImage"!==o.type.kind&&function t(e){if(e instanceof Ue)return t(e.boundExpression);if(e instanceof ve&&"error"===e.name)return!1;if(e instanceof _e)return!1;if(e instanceof Le)return!1;var n=e instanceof ge||e instanceof fe,r=!0;return e.eachChild((function(e){r=n?r&&t(e):r&&e instanceof ce})),!!r&&je(e)&&ze(e,["zoom","heatmap-density","line-progress","accumulated","is-supported-script"])}(o)){var u=new ye;try{o=new ce(o.type,o.evaluate(u))}catch(t){return this.error(t.message),null}}return o}return this.error('Unknown expression "'+r+'". If you wanted a literal array, use ["literal", [...]].',0)}return this.error(void 0===t?"'undefined' value invalid. Use null instead.":"object"==typeof t?'Bare objects invalid. Use ["literal", {...}] instead.':"Expected an array, but found "+typeof t+" instead.")},Ne.prototype.concat=function(t,e,n){var r="number"==typeof t?this.path.concat(t):this.path,i=n?this.scope.concat(n):this.scope;return new Ne(this.registry,r,e||null,i,this.errors)},Ne.prototype.error=function(t){for(var e=[],n=arguments.length-1;n-- >0;)e[n]=arguments[n+1];var r=""+this.key+e.map((function(t){return"["+t+"]"})).join("");this.errors.push(new Dt(r,t))},Ne.prototype.checkSubtype=function(t,e){var n=Qt(t,e);return n&&this.error(n),n};var Ve=function(t,e,n){this.type=t,this.input=e,this.labels=[],this.outputs=[];for(var r=0,i=n;r<i.length;r+=1){var o=i[r],a=o[1];this.labels.push(o[0]),this.outputs.push(a)}};function He(t,e,n){return t*(1-n)+e*n}Ve.parse=function(t,e){if(t.length-1<4)return e.error("Expected at least 4 arguments, but found only "+(t.length-1)+".");if((t.length-1)%2!=0)return e.error("Expected an even number of arguments.");var n=e.parse(t[1],1,Ft);if(!n)return null;var r=[],i=null;e.expectedType&&"value"!==e.expectedType.kind&&(i=e.expectedType);for(var o=1;o<t.length;o+=2){var a=1===o?-1/0:t[o],s=t[o+1],u=o,c=o+1;if("number"!=typeof a)return e.error('Input/output pairs for "step" expressions must be defined using literal numeric values (not computed expressions) for the input values.',u);if(r.length&&r[r.length-1][0]>=a)return e.error('Input/output pairs for "step" expressions must be arranged with input values in strictly ascending order.',u);var l=e.parse(s,c,i);if(!l)return null;i=i||l.type,r.push([a,l])}return new Ve(i,n,r)},Ve.prototype.evaluate=function(t){var e=this.labels,n=this.outputs;if(1===e.length)return n[0].evaluate(t);var r=this.input.evaluate(t);if(r<=e[0])return n[0].evaluate(t);var i=e.length;return r>=e[i-1]?n[i-1].evaluate(t):n[Ge(e,r)].evaluate(t)},Ve.prototype.eachChild=function(t){t(this.input);for(var e=0,n=this.outputs;e<n.length;e+=1)t(n[e])},Ve.prototype.outputDefined=function(){return this.outputs.every((function(t){return t.outputDefined()}))},Ve.prototype.serialize=function(){for(var t=["step",this.input.serialize()],e=0;e<this.labels.length;e++)e>0&&t.push(this.labels[e]),t.push(this.outputs[e].serialize());return t};var We=Object.freeze({__proto__:null,number:He,color:function(t,e,n){return new te(He(t.r,e.r,n),He(t.g,e.g,n),He(t.b,e.b,n),He(t.a,e.a,n))},array:function(t,e,n){return t.map((function(t,r){return He(t,e[r],n)}))}}),qe=6/29*3*(6/29),Xe=Math.PI/180,Ze=180/Math.PI;function Je(t){return t>.008856451679035631?Math.pow(t,1/3):t/qe+4/29}function Qe(t){return t>6/29?t*t*t:qe*(t-4/29)}function Ke(t){return 255*(t<=.0031308?12.92*t:1.055*Math.pow(t,1/2.4)-.055)}function Ye(t){return(t/=255)<=.04045?t/12.92:Math.pow((t+.055)/1.055,2.4)}function $e(t){var e=Ye(t.r),n=Ye(t.g),r=Ye(t.b),i=Je((.4124564*e+.3575761*n+.1804375*r)/.95047),o=Je((.2126729*e+.7151522*n+.072175*r)/1);return{l:116*o-16,a:500*(i-o),b:200*(o-Je((.0193339*e+.119192*n+.9503041*r)/1.08883)),alpha:t.a}}function tn(t){var e=(t.l+16)/116,n=isNaN(t.a)?e:e+t.a/500,r=isNaN(t.b)?e:e-t.b/200;return e=1*Qe(e),n=.95047*Qe(n),r=1.08883*Qe(r),new te(Ke(3.2404542*n-1.5371385*e-.4985314*r),Ke(-.969266*n+1.8760108*e+.041556*r),Ke(.0556434*n-.2040259*e+1.0572252*r),t.alpha)}function en(t,e,n){var r=e-t;return t+n*(r>180||r<-180?r-360*Math.round(r/360):r)}var nn={forward:$e,reverse:tn,interpolate:function(t,e,n){return{l:He(t.l,e.l,n),a:He(t.a,e.a,n),b:He(t.b,e.b,n),alpha:He(t.alpha,e.alpha,n)}}},rn={forward:function(t){var e=$e(t),n=e.l,r=e.a,i=e.b,o=Math.atan2(i,r)*Ze;return{h:o<0?o+360:o,c:Math.sqrt(r*r+i*i),l:n,alpha:t.a}},reverse:function(t){var e=t.h*Xe,n=t.c;return tn({l:t.l,a:Math.cos(e)*n,b:Math.sin(e)*n,alpha:t.alpha})},interpolate:function(t,e,n){return{h:en(t.h,e.h,n),c:He(t.c,e.c,n),l:He(t.l,e.l,n),alpha:He(t.alpha,e.alpha,n)}}},on=Object.freeze({__proto__:null,lab:nn,hcl:rn}),an=function(t,e,n,r,i){this.type=t,this.operator=e,this.interpolation=n,this.input=r,this.labels=[],this.outputs=[];for(var o=0,a=i;o<a.length;o+=1){var s=a[o],u=s[1];this.labels.push(s[0]),this.outputs.push(u)}};function sn(t,e,n,r){var i=r-n,o=t-n;return 0===i?0:1===e?o/i:(Math.pow(e,o)-1)/(Math.pow(e,i)-1)}an.interpolationFactor=function(t,e,r,i){var o=0;if("exponential"===t.name)o=sn(e,t.base,r,i);else if("linear"===t.name)o=sn(e,1,r,i);else if("cubic-bezier"===t.name){var a=t.controlPoints;o=new n(a[0],a[1],a[2],a[3]).solve(sn(e,1,r,i))}return o},an.parse=function(t,e){var n=t[0],r=t[1],i=t[2],o=t.slice(3);if(!Array.isArray(r)||0===r.length)return e.error("Expected an interpolation type expression.",1);if("linear"===r[0])r={name:"linear"};else if("exponential"===r[0]){var a=r[1];if("number"!=typeof a)return e.error("Exponential interpolation requires a numeric base.",1,1);r={name:"exponential",base:a}}else{if("cubic-bezier"!==r[0])return e.error("Unknown interpolation type "+String(r[0]),1,0);var s=r.slice(1);if(4!==s.length||s.some((function(t){return"number"!=typeof t||t<0||t>1})))return e.error("Cubic bezier interpolation requires four numeric arguments with values between 0 and 1.",1);r={name:"cubic-bezier",controlPoints:s}}if(t.length-1<4)return e.error("Expected at least 4 arguments, but found only "+(t.length-1)+".");if((t.length-1)%2!=0)return e.error("Expected an even number of arguments.");if(!(i=e.parse(i,2,Ft)))return null;var u=[],c=null;"interpolate-hcl"===n||"interpolate-lab"===n?c=Nt:e.expectedType&&"value"!==e.expectedType.kind&&(c=e.expectedType);for(var l=0;l<o.length;l+=2){var h=o[l],f=o[l+1],p=l+3,d=l+4;if("number"!=typeof h)return e.error('Input/output pairs for "interpolate" expressions must be defined using literal numeric values (not computed expressions) for the input values.',p);if(u.length&&u[u.length-1][0]>=h)return e.error('Input/output pairs for "interpolate" expressions must be arranged with input values in strictly ascending order.',p);var A=e.parse(f,d,c);if(!A)return null;c=c||A.type,u.push([h,A])}return"number"===c.kind||"color"===c.kind||"array"===c.kind&&"number"===c.itemType.kind&&"number"==typeof c.N?new an(c,n,r,i,u):e.error("Type "+Zt(c)+" is not interpolatable.")},an.prototype.evaluate=function(t){var e=this.labels,n=this.outputs;if(1===e.length)return n[0].evaluate(t);var r=this.input.evaluate(t);if(r<=e[0])return n[0].evaluate(t);var i=e.length;if(r>=e[i-1])return n[i-1].evaluate(t);var o=Ge(e,r),a=an.interpolationFactor(this.interpolation,r,e[o],e[o+1]),s=n[o].evaluate(t),u=n[o+1].evaluate(t);return"interpolate"===this.operator?We[this.type.kind.toLowerCase()](s,u,a):"interpolate-hcl"===this.operator?rn.reverse(rn.interpolate(rn.forward(s),rn.forward(u),a)):nn.reverse(nn.interpolate(nn.forward(s),nn.forward(u),a))},an.prototype.eachChild=function(t){t(this.input);for(var e=0,n=this.outputs;e<n.length;e+=1)t(n[e])},an.prototype.outputDefined=function(){return this.outputs.every((function(t){return t.outputDefined()}))},an.prototype.serialize=function(){var t;t="linear"===this.interpolation.name?["linear"]:"exponential"===this.interpolation.name?1===this.interpolation.base?["linear"]:["exponential",this.interpolation.base]:["cubic-bezier"].concat(this.interpolation.controlPoints);for(var e=[this.operator,t,this.input.serialize()],n=0;n<this.labels.length;n++)e.push(this.labels[n],this.outputs[n].serialize());return e};var un=function(t,e){this.type=t,this.args=e};un.parse=function(t,e){if(t.length<2)return e.error("Expectected at least one argument.");var n=null,r=e.expectedType;r&&"value"!==r.kind&&(n=r);for(var i=[],o=0,a=t.slice(1);o<a.length;o+=1){var s=e.parse(a[o],1+i.length,n,void 0,{typeAnnotation:"omit"});if(!s)return null;n=n||s.type,i.push(s)}var u=r&&i.some((function(t){return Qt(r,t.type)}));return new un(u?Vt:n,i)},un.prototype.evaluate=function(t){for(var e,n=null,r=0,i=0,o=this.args;i<o.length&&(r++,(n=o[i].evaluate(t))&&n instanceof ie&&!n.available&&(e||(e=n.name),n=null,r===this.args.length&&(n=e)),null===n);i+=1);return n},un.prototype.eachChild=function(t){this.args.forEach(t)},un.prototype.outputDefined=function(){return this.args.every((function(t){return t.outputDefined()}))},un.prototype.serialize=function(){var t=["coalesce"];return this.eachChild((function(e){t.push(e.serialize())})),t};var cn=function(t,e){this.type=e.type,this.bindings=[].concat(t),this.result=e};cn.prototype.evaluate=function(t){return this.result.evaluate(t)},cn.prototype.eachChild=function(t){for(var e=0,n=this.bindings;e<n.length;e+=1)t(n[e][1]);t(this.result)},cn.parse=function(t,e){if(t.length<4)return e.error("Expected at least 3 arguments, but found "+(t.length-1)+" instead.");for(var n=[],r=1;r<t.length-1;r+=2){var i=t[r];if("string"!=typeof i)return e.error("Expected string, but found "+typeof i+" instead.",r);if(/[^a-zA-Z0-9_]/.test(i))return e.error("Variable names must contain only alphanumeric characters or '_'.",r);var o=e.parse(t[r+1],r+1);if(!o)return null;n.push([i,o])}var a=e.parse(t[t.length-1],t.length-1,e.expectedType,n);return a?new cn(n,a):null},cn.prototype.outputDefined=function(){return this.result.outputDefined()},cn.prototype.serialize=function(){for(var t=["let"],e=0,n=this.bindings;e<n.length;e+=1){var r=n[e];t.push(r[0],r[1].serialize())}return t.push(this.result.serialize()),t};var ln=function(t,e,n){this.type=t,this.index=e,this.input=n};ln.parse=function(t,e){if(3!==t.length)return e.error("Expected 2 arguments, but found "+(t.length-1)+" instead.");var n=e.parse(t[1],1,Ft),r=e.parse(t[2],2,Xt(e.expectedType||Vt));return n&&r?new ln(r.type.itemType,n,r):null},ln.prototype.evaluate=function(t){var e=this.index.evaluate(t),n=this.input.evaluate(t);if(e<0)throw new le("Array index out of bounds: "+e+" < 0.");if(e>=n.length)throw new le("Array index out of bounds: "+e+" > "+(n.length-1)+".");if(e!==Math.floor(e))throw new le("Array index must be an integer, but found "+e+" instead.");return n[e]},ln.prototype.eachChild=function(t){t(this.index),t(this.input)},ln.prototype.outputDefined=function(){return!1},ln.prototype.serialize=function(){return["at",this.index.serialize(),this.input.serialize()]};var hn=function(t,e){this.type=Ut,this.needle=t,this.haystack=e};hn.parse=function(t,e){if(3!==t.length)return e.error("Expected 2 arguments, but found "+(t.length-1)+" instead.");var n=e.parse(t[1],1,Vt),r=e.parse(t[2],2,Vt);return n&&r?Kt(n.type,[Ut,zt,Ft,jt,Vt])?new hn(n,r):e.error("Expected first argument to be of type boolean, string, number or null, but found "+Zt(n.type)+" instead"):null},hn.prototype.evaluate=function(t){var e=this.needle.evaluate(t),n=this.haystack.evaluate(t);if(!n)return!1;if(!Yt(e,["boolean","string","number","null"]))throw new le("Expected first argument to be of type boolean, string, number or null, but found "+Zt(se(e))+" instead.");if(!Yt(n,["string","array"]))throw new le("Expected second argument to be of type array or string, but found "+Zt(se(n))+" instead.");return n.indexOf(e)>=0},hn.prototype.eachChild=function(t){t(this.needle),t(this.haystack)},hn.prototype.outputDefined=function(){return!0},hn.prototype.serialize=function(){return["in",this.needle.serialize(),this.haystack.serialize()]};var fn=function(t,e,n){this.type=Ft,this.needle=t,this.haystack=e,this.fromIndex=n};fn.parse=function(t,e){if(t.length<=2||t.length>=5)return e.error("Expected 3 or 4 arguments, but found "+(t.length-1)+" instead.");var n=e.parse(t[1],1,Vt),r=e.parse(t[2],2,Vt);if(!n||!r)return null;if(!Kt(n.type,[Ut,zt,Ft,jt,Vt]))return e.error("Expected first argument to be of type boolean, string, number or null, but found "+Zt(n.type)+" instead");if(4===t.length){var i=e.parse(t[3],3,Ft);return i?new fn(n,r,i):null}return new fn(n,r)},fn.prototype.evaluate=function(t){var e=this.needle.evaluate(t),n=this.haystack.evaluate(t);if(!Yt(e,["boolean","string","number","null"]))throw new le("Expected first argument to be of type boolean, string, number or null, but found "+Zt(se(e))+" instead.");if(!Yt(n,["string","array"]))throw new le("Expected second argument to be of type array or string, but found "+Zt(se(n))+" instead.");if(this.fromIndex){var r=this.fromIndex.evaluate(t);return n.indexOf(e,r)}return n.indexOf(e)},fn.prototype.eachChild=function(t){t(this.needle),t(this.haystack),this.fromIndex&&t(this.fromIndex)},fn.prototype.outputDefined=function(){return!1},fn.prototype.serialize=function(){if(null!=this.fromIndex&&void 0!==this.fromIndex){var t=this.fromIndex.serialize();return["index-of",this.needle.serialize(),this.haystack.serialize(),t]}return["index-of",this.needle.serialize(),this.haystack.serialize()]};var pn=function(t,e,n,r,i,o){this.inputType=t,this.type=e,this.input=n,this.cases=r,this.outputs=i,this.otherwise=o};pn.parse=function(t,e){if(t.length<5)return e.error("Expected at least 4 arguments, but found only "+(t.length-1)+".");if(t.length%2!=1)return e.error("Expected an even number of arguments.");var n,r;e.expectedType&&"value"!==e.expectedType.kind&&(r=e.expectedType);for(var i={},o=[],a=2;a<t.length-1;a+=2){var s=t[a],u=t[a+1];Array.isArray(s)||(s=[s]);var c=e.concat(a);if(0===s.length)return c.error("Expected at least one branch label.");for(var l=0,h=s;l<h.length;l+=1){var f=h[l];if("number"!=typeof f&&"string"!=typeof f)return c.error("Branch labels must be numbers or strings.");if("number"==typeof f&&Math.abs(f)>Number.MAX_SAFE_INTEGER)return c.error("Branch labels must be integers no larger than "+Number.MAX_SAFE_INTEGER+".");if("number"==typeof f&&Math.floor(f)!==f)return c.error("Numeric branch labels must be integer values.");if(n){if(c.checkSubtype(n,se(f)))return null}else n=se(f);if(void 0!==i[String(f)])return c.error("Branch labels must be unique.");i[String(f)]=o.length}var p=e.parse(u,a,r);if(!p)return null;r=r||p.type,o.push(p)}var d=e.parse(t[1],1,Vt);if(!d)return null;var A=e.parse(t[t.length-1],t.length-1,r);return A?"value"!==d.type.kind&&e.concat(1).checkSubtype(n,d.type)?null:new pn(n,r,d,i,o,A):null},pn.prototype.evaluate=function(t){var e=this.input.evaluate(t);return(se(e)===this.inputType&&this.outputs[this.cases[e]]||this.otherwise).evaluate(t)},pn.prototype.eachChild=function(t){t(this.input),this.outputs.forEach(t),t(this.otherwise)},pn.prototype.outputDefined=function(){return this.outputs.every((function(t){return t.outputDefined()}))&&this.otherwise.outputDefined()},pn.prototype.serialize=function(){for(var t=this,e=["match",this.input.serialize()],n=[],r={},i=0,o=Object.keys(this.cases).sort();i<o.length;i+=1){var a=o[i];void 0===(h=r[this.cases[a]])?(r[this.cases[a]]=n.length,n.push([this.cases[a],[a]])):n[h][1].push(a)}for(var s=function(e){return"number"===t.inputType.kind?Number(e):e},u=0,c=n;u<c.length;u+=1){var l=c[u],h=l[0],f=l[1];e.push(1===f.length?s(f[0]):f.map(s)),e.push(this.outputs[outputIndex$1].serialize())}return e.push(this.otherwise.serialize()),e};var dn=function(t,e,n){this.type=t,this.branches=e,this.otherwise=n};dn.parse=function(t,e){if(t.length<4)return e.error("Expected at least 3 arguments, but found only "+(t.length-1)+".");if(t.length%2!=0)return e.error("Expected an odd number of arguments.");var n;e.expectedType&&"value"!==e.expectedType.kind&&(n=e.expectedType);for(var r=[],i=1;i<t.length-1;i+=2){var o=e.parse(t[i],i,Ut);if(!o)return null;var a=e.parse(t[i+1],i+1,n);if(!a)return null;r.push([o,a]),n=n||a.type}var s=e.parse(t[t.length-1],t.length-1,n);return s?new dn(n,r,s):null},dn.prototype.evaluate=function(t){for(var e=0,n=this.branches;e<n.length;e+=1){var r=n[e],i=r[1];if(r[0].evaluate(t))return i.evaluate(t)}return this.otherwise.evaluate(t)},dn.prototype.eachChild=function(t){for(var e=0,n=this.branches;e<n.length;e+=1){var r=n[e],i=r[1];t(r[0]),t(i)}t(this.otherwise)},dn.prototype.outputDefined=function(){return this.branches.every((function(t){return t[1].outputDefined()}))&&this.otherwise.outputDefined()},dn.prototype.serialize=function(){var t=["case"];return this.eachChild((function(e){t.push(e.serialize())})),t};var An=function(t,e,n,r){this.type=t,this.input=e,this.beginIndex=n,this.endIndex=r};function gn(t,e){return"=="===t||"!="===t?"boolean"===e.kind||"string"===e.kind||"number"===e.kind||"null"===e.kind||"value"===e.kind:"string"===e.kind||"number"===e.kind||"value"===e.kind}function mn(t,e,n,r){return 0===r.compare(e,n)}function yn(t,e,n){var r="=="!==t&&"!="!==t;return function(){function i(t,e,n){this.type=Ut,this.lhs=t,this.rhs=e,this.collator=n,this.hasUntypedArgument="value"===t.type.kind||"value"===e.type.kind}return i.parse=function(t,e){if(3!==t.length&&4!==t.length)return e.error("Expected two or three arguments.");var n=t[0],o=e.parse(t[1],1,Vt);if(!o)return null;if(!gn(n,o.type))return e.concat(1).error('"'+n+"\" comparisons are not supported for type '"+Zt(o.type)+"'.");var a=e.parse(t[2],2,Vt);if(!a)return null;if(!gn(n,a.type))return e.concat(2).error('"'+n+"\" comparisons are not supported for type '"+Zt(a.type)+"'.");if(o.type.kind!==a.type.kind&&"value"!==o.type.kind&&"value"!==a.type.kind)return e.error("Cannot compare types '"+Zt(o.type)+"' and '"+Zt(a.type)+"'.");r&&("value"===o.type.kind&&"value"!==a.type.kind?o=new fe(a.type,[o]):"value"!==o.type.kind&&"value"===a.type.kind&&(a=new fe(o.type,[a])));var s=null;if(4===t.length){if("string"!==o.type.kind&&"string"!==a.type.kind&&"value"!==o.type.kind&&"value"!==a.type.kind)return e.error("Cannot use collator to compare non-string types.");if(!(s=e.parse(t[3],3,Ht)))return null}return new i(o,a,s)},i.prototype.evaluate=function(i){var o=this.lhs.evaluate(i),a=this.rhs.evaluate(i);if(r&&this.hasUntypedArgument){var s=se(o),u=se(a);if(s.kind!==u.kind||"string"!==s.kind&&"number"!==s.kind)throw new le('Expected arguments for "'+t+'" to be (string, string) or (number, number), but found ('+s.kind+", "+u.kind+") instead.")}if(this.collator&&!r&&this.hasUntypedArgument){var c=se(o),l=se(a);if("string"!==c.kind||"string"!==l.kind)return e(i,o,a)}return this.collator?n(i,o,a,this.collator.evaluate(i)):e(i,o,a)},i.prototype.eachChild=function(t){t(this.lhs),t(this.rhs),this.collator&&t(this.collator)},i.prototype.outputDefined=function(){return!0},i.prototype.serialize=function(){var e=[t];return this.eachChild((function(t){e.push(t.serialize())})),e},i}()}An.parse=function(t,e){if(t.length<=2||t.length>=5)return e.error("Expected 3 or 4 arguments, but found "+(t.length-1)+" instead.");var n=e.parse(t[1],1,Vt),r=e.parse(t[2],2,Ft);if(!n||!r)return null;if(!Kt(n.type,[Xt(Vt),zt,Vt]))return e.error("Expected first argument to be of type array or string, but found "+Zt(n.type)+" instead");if(4===t.length){var i=e.parse(t[3],3,Ft);return i?new An(n.type,n,r,i):null}return new An(n.type,n,r)},An.prototype.evaluate=function(t){var e=this.input.evaluate(t),n=this.beginIndex.evaluate(t);if(!Yt(e,["string","array"]))throw new le("Expected first argument to be of type array or string, but found "+Zt(se(e))+" instead.");if(this.endIndex){var r=this.endIndex.evaluate(t);return e.slice(n,r)}return e.slice(n)},An.prototype.eachChild=function(t){t(this.input),t(this.beginIndex),this.endIndex&&t(this.endIndex)},An.prototype.outputDefined=function(){return!1},An.prototype.serialize=function(){if(null!=this.endIndex&&void 0!==this.endIndex){var t=this.endIndex.serialize();return["slice",this.input.serialize(),this.beginIndex.serialize(),t]}return["slice",this.input.serialize(),this.beginIndex.serialize()]};var vn=yn("==",(function(t,e,n){return e===n}),mn),_n=yn("!=",(function(t,e,n){return e!==n}),(function(t,e,n,r){return!mn(0,e,n,r)})),bn=yn("<",(function(t,e,n){return e<n}),(function(t,e,n,r){return r.compare(e,n)<0})),xn=yn(">",(function(t,e,n){return e>n}),(function(t,e,n,r){return r.compare(e,n)>0})),wn=yn("<=",(function(t,e,n){return e<=n}),(function(t,e,n,r){return r.compare(e,n)<=0})),En=yn(">=",(function(t,e,n){return e>=n}),(function(t,e,n,r){return r.compare(e,n)>=0})),On=function(t,e,n,r,i){this.type=zt,this.number=t,this.locale=e,this.currency=n,this.minFractionDigits=r,this.maxFractionDigits=i};On.parse=function(t,e){if(3!==t.length)return e.error("Expected two arguments.");var n=e.parse(t[1],1,Ft);if(!n)return null;var r=t[2];if("object"!=typeof r||Array.isArray(r))return e.error("NumberFormat options argument must be an object.");var i=null;if(r.locale&&!(i=e.parse(r.locale,1,zt)))return null;var o=null;if(r.currency&&!(o=e.parse(r.currency,1,zt)))return null;var a=null;if(r["min-fraction-digits"]&&!(a=e.parse(r["min-fraction-digits"],1,Ft)))return null;var s=null;return r["max-fraction-digits"]&&!(s=e.parse(r["max-fraction-digits"],1,Ft))?null:new On(n,i,o,a,s)},On.prototype.evaluate=function(t){return new Intl.NumberFormat(this.locale?this.locale.evaluate(t):[],{style:this.currency?"currency":"decimal",currency:this.currency?this.currency.evaluate(t):void 0,minimumFractionDigits:this.minFractionDigits?this.minFractionDigits.evaluate(t):void 0,maximumFractionDigits:this.maxFractionDigits?this.maxFractionDigits.evaluate(t):void 0}).format(this.number.evaluate(t))},On.prototype.eachChild=function(t){t(this.number),this.locale&&t(this.locale),this.currency&&t(this.currency),this.minFractionDigits&&t(this.minFractionDigits),this.maxFractionDigits&&t(this.maxFractionDigits)},On.prototype.outputDefined=function(){return!1},On.prototype.serialize=function(){var t={};return this.locale&&(t.locale=this.locale.serialize()),this.currency&&(t.currency=this.currency.serialize()),this.minFractionDigits&&(t["min-fraction-digits"]=this.minFractionDigits.serialize()),this.maxFractionDigits&&(t["max-fraction-digits"]=this.maxFractionDigits.serialize()),["number-format",this.number.serialize(),t]};var Sn=function(t){this.type=Ft,this.input=t};Sn.parse=function(t,e){if(2!==t.length)return e.error("Expected 1 argument, but found "+(t.length-1)+" instead.");var n=e.parse(t[1],1);return n?"array"!==n.type.kind&&"string"!==n.type.kind&&"value"!==n.type.kind?e.error("Expected argument of type string or array, but found "+Zt(n.type)+" instead."):new Sn(n):null},Sn.prototype.evaluate=function(t){var e=this.input.evaluate(t);if("string"==typeof e)return e.length;if(Array.isArray(e))return e.length;throw new le("Expected value to be of type string or array, but found "+Zt(se(e))+" instead.")},Sn.prototype.eachChild=function(t){t(this.input)},Sn.prototype.outputDefined=function(){return!1},Sn.prototype.serialize=function(){var t=["length"];return this.eachChild((function(e){t.push(e.serialize())})),t};var Tn={"==":vn,"!=":_n,">":xn,"<":bn,">=":En,"<=":wn,array:fe,at:ln,boolean:fe,case:dn,coalesce:un,collator:_e,format:pe,image:de,in:hn,"index-of":fn,interpolate:an,"interpolate-hcl":an,"interpolate-lab":an,length:Sn,let:cn,literal:ce,match:pn,number:fe,"number-format":On,object:fe,slice:An,step:Ve,string:fe,"to-boolean":ge,"to-color":ge,"to-number":ge,"to-string":ge,var:Ue,within:Le};function Cn(t,e){var n=e[0],r=e[1],i=e[2],o=e[3];n=n.evaluate(t),r=r.evaluate(t),i=i.evaluate(t);var a=o?o.evaluate(t):1,s=oe(n,r,i,a);if(s)throw new le(s);return new te(n/255*a,r/255*a,i/255*a,a)}function Pn(t,e){return t in e}function Mn(t,e){var n=e[t];return void 0===n?null:n}function In(t){return{type:t}}function Bn(t){return{result:"success",value:t}}function Rn(t){return{result:"error",value:t}}function kn(t){return"data-driven"===t["property-type"]||"cross-faded-data-driven"===t["property-type"]}function Dn(t){return!!t.expression&&t.expression.parameters.indexOf("zoom")>-1}function Ln(t){return!!t.expression&&t.expression.interpolated}function jn(t){return t instanceof Number?"number":t instanceof String?"string":t instanceof Boolean?"boolean":Array.isArray(t)?"array":null===t?"null":typeof t}function Fn(t){return"object"==typeof t&&null!==t&&!Array.isArray(t)}function zn(t){return t}function Un(t,e,n){return void 0!==t?t:void 0!==e?e:void 0!==n?n:void 0}function Nn(t,e,n,r,i){return Un(typeof n===i?r[n]:void 0,t.default,e.default)}function Gn(t,e,n){if("number"!==jn(n))return Un(t.default,e.default);var r=t.stops.length;if(1===r)return t.stops[0][1];if(n<=t.stops[0][0])return t.stops[0][1];if(n>=t.stops[r-1][0])return t.stops[r-1][1];var i=Ge(t.stops.map((function(t){return t[0]})),n);return t.stops[i][1]}function Vn(t,e,n){var r=void 0!==t.base?t.base:1;if("number"!==jn(n))return Un(t.default,e.default);var i=t.stops.length;if(1===i)return t.stops[0][1];if(n<=t.stops[0][0])return t.stops[0][1];if(n>=t.stops[i-1][0])return t.stops[i-1][1];var o=Ge(t.stops.map((function(t){return t[0]})),n),a=function(t,e,n,r){var i=r-n,o=t-n;return 0===i?0:1===e?o/i:(Math.pow(e,o)-1)/(Math.pow(e,i)-1)}(n,r,t.stops[o][0],t.stops[o+1][0]),s=t.stops[o][1],u=t.stops[o+1][1],c=We[e.type]||zn;if(t.colorSpace&&"rgb"!==t.colorSpace){var l=on[t.colorSpace];c=function(t,e){return l.reverse(l.interpolate(l.forward(t),l.forward(e),a))}}return"function"==typeof s.evaluate?{evaluate:function(){for(var t=[],e=arguments.length;e--;)t[e]=arguments[e];var n=s.evaluate.apply(void 0,t),r=u.evaluate.apply(void 0,t);if(void 0!==n&&void 0!==r)return c(n,r,a)}}:c(s,u,a)}function Hn(t,e,n){return"color"===e.type?n=te.parse(n):"formatted"===e.type?n=re.fromString(n.toString()):"resolvedImage"===e.type?n=ie.fromString(n.toString()):jn(n)===e.type||"enum"===e.type&&e.values[n]||(n=void 0),Un(n,t.default,e.default)}ve.register(Tn,{error:[{kind:"error"},[zt],function(t,e){throw new le(e[0].evaluate(t))}],typeof:[zt,[Vt],function(t,e){return Zt(se(e[0].evaluate(t)))}],"to-rgba":[Xt(Ft,4),[Nt],function(t,e){return e[0].evaluate(t).toArray()}],rgb:[Nt,[Ft,Ft,Ft],Cn],rgba:[Nt,[Ft,Ft,Ft,Ft],Cn],has:{type:Ut,overloads:[[[zt],function(t,e){return Pn(e[0].evaluate(t),t.properties())}],[[zt,Gt],function(t,e){var n=e[1];return Pn(e[0].evaluate(t),n.evaluate(t))}]]},get:{type:Vt,overloads:[[[zt],function(t,e){return Mn(e[0].evaluate(t),t.properties())}],[[zt,Gt],function(t,e){var n=e[1];return Mn(e[0].evaluate(t),n.evaluate(t))}]]},"feature-state":[Vt,[zt],function(t,e){return Mn(e[0].evaluate(t),t.featureState||{})}],properties:[Gt,[],function(t){return t.properties()}],"geometry-type":[zt,[],function(t){return t.geometryType()}],id:[Vt,[],function(t){return t.id()}],zoom:[Ft,[],function(t){return t.globals.zoom}],"heatmap-density":[Ft,[],function(t){return t.globals.heatmapDensity||0}],"line-progress":[Ft,[],function(t){return t.globals.lineProgress||0}],accumulated:[Vt,[],function(t){return void 0===t.globals.accumulated?null:t.globals.accumulated}],"+":[Ft,In(Ft),function(t,e){for(var n=0,r=0,i=e;r<i.length;r+=1)n+=i[r].evaluate(t);return n}],"*":[Ft,In(Ft),function(t,e){for(var n=1,r=0,i=e;r<i.length;r+=1)n*=i[r].evaluate(t);return n}],"-":{type:Ft,overloads:[[[Ft,Ft],function(t,e){var n=e[1];return e[0].evaluate(t)-n.evaluate(t)}],[[Ft],function(t,e){return-e[0].evaluate(t)}]]},"/":[Ft,[Ft,Ft],function(t,e){var n=e[1];return e[0].evaluate(t)/n.evaluate(t)}],"%":[Ft,[Ft,Ft],function(t,e){var n=e[1];return e[0].evaluate(t)%n.evaluate(t)}],ln2:[Ft,[],function(){return Math.LN2}],pi:[Ft,[],function(){return Math.PI}],e:[Ft,[],function(){return Math.E}],"^":[Ft,[Ft,Ft],function(t,e){var n=e[1];return Math.pow(e[0].evaluate(t),n.evaluate(t))}],sqrt:[Ft,[Ft],function(t,e){return Math.sqrt(e[0].evaluate(t))}],log10:[Ft,[Ft],function(t,e){return Math.log(e[0].evaluate(t))/Math.LN10}],ln:[Ft,[Ft],function(t,e){return Math.log(e[0].evaluate(t))}],log2:[Ft,[Ft],function(t,e){return Math.log(e[0].evaluate(t))/Math.LN2}],sin:[Ft,[Ft],function(t,e){return Math.sin(e[0].evaluate(t))}],cos:[Ft,[Ft],function(t,e){return Math.cos(e[0].evaluate(t))}],tan:[Ft,[Ft],function(t,e){return Math.tan(e[0].evaluate(t))}],asin:[Ft,[Ft],function(t,e){return Math.asin(e[0].evaluate(t))}],acos:[Ft,[Ft],function(t,e){return Math.acos(e[0].evaluate(t))}],atan:[Ft,[Ft],function(t,e){return Math.atan(e[0].evaluate(t))}],min:[Ft,In(Ft),function(t,e){return Math.min.apply(Math,e.map((function(e){return e.evaluate(t)})))}],max:[Ft,In(Ft),function(t,e){return Math.max.apply(Math,e.map((function(e){return e.evaluate(t)})))}],abs:[Ft,[Ft],function(t,e){return Math.abs(e[0].evaluate(t))}],round:[Ft,[Ft],function(t,e){var n=e[0].evaluate(t);return n<0?-Math.round(-n):Math.round(n)}],floor:[Ft,[Ft],function(t,e){return Math.floor(e[0].evaluate(t))}],ceil:[Ft,[Ft],function(t,e){return Math.ceil(e[0].evaluate(t))}],"filter-==":[Ut,[zt,Vt],function(t,e){var n=e[0],r=e[1];return t.properties()[n.value]===r.value}],"filter-id-==":[Ut,[Vt],function(t,e){var n=e[0];return t.id()===n.value}],"filter-type-==":[Ut,[zt],function(t,e){var n=e[0];return t.geometryType()===n.value}],"filter-<":[Ut,[zt,Vt],function(t,e){var n=e[0],r=e[1],i=t.properties()[n.value],o=r.value;return typeof i==typeof o&&i<o}],"filter-id-<":[Ut,[Vt],function(t,e){var n=e[0],r=t.id(),i=n.value;return typeof r==typeof i&&r<i}],"filter->":[Ut,[zt,Vt],function(t,e){var n=e[0],r=e[1],i=t.properties()[n.value],o=r.value;return typeof i==typeof o&&i>o}],"filter-id->":[Ut,[Vt],function(t,e){var n=e[0],r=t.id(),i=n.value;return typeof r==typeof i&&r>i}],"filter-<=":[Ut,[zt,Vt],function(t,e){var n=e[0],r=e[1],i=t.properties()[n.value],o=r.value;return typeof i==typeof o&&i<=o}],"filter-id-<=":[Ut,[Vt],function(t,e){var n=e[0],r=t.id(),i=n.value;return typeof r==typeof i&&r<=i}],"filter->=":[Ut,[zt,Vt],function(t,e){var n=e[0],r=e[1],i=t.properties()[n.value],o=r.value;return typeof i==typeof o&&i>=o}],"filter-id->=":[Ut,[Vt],function(t,e){var n=e[0],r=t.id(),i=n.value;return typeof r==typeof i&&r>=i}],"filter-has":[Ut,[Vt],function(t,e){return e[0].value in t.properties()}],"filter-has-id":[Ut,[],function(t){return null!==t.id()&&void 0!==t.id()}],"filter-type-in":[Ut,[Xt(zt)],function(t,e){return e[0].value.indexOf(t.geometryType())>=0}],"filter-id-in":[Ut,[Xt(Vt)],function(t,e){return e[0].value.indexOf(t.id())>=0}],"filter-in-small":[Ut,[zt,Xt(Vt)],function(t,e){var n=e[0];return e[1].value.indexOf(t.properties()[n.value])>=0}],"filter-in-large":[Ut,[zt,Xt(Vt)],function(t,e){var n=e[0],r=e[1];return function(t,e,n,r){for(;n<=r;){var i=n+r>>1;if(e[i]===t)return!0;e[i]>t?r=i-1:n=i+1}return!1}(t.properties()[n.value],r.value,0,r.value.length-1)}],all:{type:Ut,overloads:[[[Ut,Ut],function(t,e){var n=e[1];return e[0].evaluate(t)&&n.evaluate(t)}],[In(Ut),function(t,e){for(var n=0,r=e;n<r.length;n+=1)if(!r[n].evaluate(t))return!1;return!0}]]},any:{type:Ut,overloads:[[[Ut,Ut],function(t,e){var n=e[1];return e[0].evaluate(t)||n.evaluate(t)}],[In(Ut),function(t,e){for(var n=0,r=e;n<r.length;n+=1)if(r[n].evaluate(t))return!0;return!1}]]},"!":[Ut,[Ut],function(t,e){return!e[0].evaluate(t)}],"is-supported-script":[Ut,[zt],function(t,e){var n=t.globals&&t.globals.isSupportedScript;return!n||n(e[0].evaluate(t))}],upcase:[zt,[zt],function(t,e){return e[0].evaluate(t).toUpperCase()}],downcase:[zt,[zt],function(t,e){return e[0].evaluate(t).toLowerCase()}],concat:[zt,In(Vt),function(t,e){return e.map((function(e){return ue(e.evaluate(t))})).join("")}],"resolved-locale":[zt,[Ht],function(t,e){return e[0].evaluate(t).resolvedLocale()}]});var Wn=function(t,e){this.expression=t,this._warningHistory={},this._evaluator=new ye,this._defaultValue=e?function(t){return"color"===t.type&&Fn(t.default)?new te(0,0,0,0):"color"===t.type?te.parse(t.default)||null:void 0===t.default?null:t.default}(e):null,this._enumValues=e&&"enum"===e.type?e.values:null};function qn(t){return Array.isArray(t)&&t.length>0&&"string"==typeof t[0]&&t[0]in Tn}function Xn(t,e){var n=new Ne(Tn,[],e?function(t){var e={color:Nt,string:zt,number:Ft,enum:zt,boolean:Ut,formatted:Wt,resolvedImage:qt};return"array"===t.type?Xt(e[t.value]||Vt,t.length):e[t.type]}(e):void 0),r=n.parse(t,void 0,void 0,void 0,e&&"string"===e.type?{typeAnnotation:"coerce"}:void 0);return r?Bn(new Wn(r,e)):Rn(n.errors)}Wn.prototype.evaluateWithoutErrorHandling=function(t,e,n,r,i,o){return this._evaluator.globals=t,this._evaluator.feature=e,this._evaluator.featureState=n,this._evaluator.canonical=r,this._evaluator.availableImages=i||null,this._evaluator.formattedSection=o,this.expression.evaluate(this._evaluator)},Wn.prototype.evaluate=function(t,e,n,r,i,o){this._evaluator.globals=t,this._evaluator.feature=e||null,this._evaluator.featureState=n||null,this._evaluator.canonical=r,this._evaluator.availableImages=i||null,this._evaluator.formattedSection=o||null;try{var a=this.expression.evaluate(this._evaluator);if(null==a||"number"==typeof a&&a!=a)return this._defaultValue;if(this._enumValues&&!(a in this._enumValues))throw new le("Expected value to be one of "+Object.keys(this._enumValues).map((function(t){return JSON.stringify(t)})).join(", ")+", but found "+JSON.stringify(a)+" instead.");return a}catch(t){return this._warningHistory[t.message]||(this._warningHistory[t.message]=!0,"undefined"!=typeof console&&console.warn(t.message)),this._defaultValue}};var Zn=function(t,e){this.kind=t,this._styleExpression=e,this.isStateDependent="constant"!==t&&!Fe(e.expression)};Zn.prototype.evaluateWithoutErrorHandling=function(t,e,n,r,i,o){return this._styleExpression.evaluateWithoutErrorHandling(t,e,n,r,i,o)},Zn.prototype.evaluate=function(t,e,n,r,i,o){return this._styleExpression.evaluate(t,e,n,r,i,o)};var Jn=function(t,e,n,r){this.kind=t,this.zoomStops=n,this._styleExpression=e,this.isStateDependent="camera"!==t&&!Fe(e.expression),this.interpolationType=r};function Qn(t,e){if("error"===(t=Xn(t,e)).result)return t;var n=t.value.expression,r=je(n);if(!r&&!kn(e))return Rn([new Dt("","data expressions not supported")]);var i=ze(n,["zoom"]);if(!i&&!Dn(e))return Rn([new Dt("","zoom expressions not supported")]);var o=function t(e){var n=null;if(e instanceof cn)n=t(e.result);else if(e instanceof un)for(var r=0,i=e.args;r<i.length&&!(n=t(i[r]));r+=1);else(e instanceof Ve||e instanceof an)&&e.input instanceof ve&&"zoom"===e.input.name&&(n=e);return n instanceof Dt||e.eachChild((function(e){var r=t(e);r instanceof Dt?n=r:!n&&r?n=new Dt("",'"zoom" expression may only be used as input to a top-level "step" or "interpolate" expression.'):n&&r&&n!==r&&(n=new Dt("",'Only one zoom-based "step" or "interpolate" subexpression may be used in an expression.'))})),n}(n);return o||i?o instanceof Dt?Rn([o]):o instanceof an&&!Ln(e)?Rn([new Dt("",'"interpolate" expressions cannot be used with this property')]):Bn(o?new Jn(r?"camera":"composite",t.value,o.labels,o instanceof an?o.interpolation:void 0):new Zn(r?"constant":"source",t.value)):Rn([new Dt("",'"zoom" expression may only be used as input to a top-level "step" or "interpolate" expression.')])}Jn.prototype.evaluateWithoutErrorHandling=function(t,e,n,r,i,o){return this._styleExpression.evaluateWithoutErrorHandling(t,e,n,r,i,o)},Jn.prototype.evaluate=function(t,e,n,r,i,o){return this._styleExpression.evaluate(t,e,n,r,i,o)},Jn.prototype.interpolationFactor=function(t,e,n){return this.interpolationType?an.interpolationFactor(this.interpolationType,t,e,n):0};var Kn=function(t,e){this._parameters=t,this._specification=e,Bt(this,function t(e,n){var r,i,o,a="color"===n.type,s=e.stops&&"object"==typeof e.stops[0][0],u=s||!(s||void 0!==e.property),c=e.type||(Ln(n)?"exponential":"interval");if(a&&((e=Bt({},e)).stops&&(e.stops=e.stops.map((function(t){return[t[0],te.parse(t[1])]}))),e.default=te.parse(e.default?e.default:n.default)),e.colorSpace&&"rgb"!==e.colorSpace&&!on[e.colorSpace])throw new Error("Unknown color space: "+e.colorSpace);if("exponential"===c)r=Vn;else if("interval"===c)r=Gn;else if("categorical"===c){r=Nn,i=Object.create(null);for(var l=0,h=e.stops;l<h.length;l+=1){var f=h[l];i[f[0]]=f[1]}o=typeof e.stops[0][0]}else{if("identity"!==c)throw new Error('Unknown function type "'+c+'"');r=Hn}if(s){for(var p={},d=[],A=0;A<e.stops.length;A++){var g=e.stops[A],m=g[0].zoom;void 0===p[m]&&(p[m]={zoom:m,type:e.type,property:e.property,default:e.default,stops:[]},d.push(m)),p[m].stops.push([g[0].value,g[1]])}for(var y=[],v=0,_=d;v<_.length;v+=1){var b=_[v];y.push([p[b].zoom,t(p[b],n)])}var x={name:"linear"};return{kind:"composite",interpolationType:x,interpolationFactor:an.interpolationFactor.bind(void 0,x),zoomStops:y.map((function(t){return t[0]})),evaluate:function(t,r){var i=t.zoom;return Vn({stops:y,base:e.base},n,i).evaluate(i,r)}}}if(u){var w="exponential"===c?{name:"exponential",base:void 0!==e.base?e.base:1}:null;return{kind:"camera",interpolationType:w,interpolationFactor:an.interpolationFactor.bind(void 0,w),zoomStops:e.stops.map((function(t){return t[0]})),evaluate:function(t){return r(e,n,t.zoom,i,o)}}}return{kind:"source",evaluate:function(t,a){var s=a&&a.properties?a.properties[e.property]:void 0;return void 0===s?Un(e.default,n.default):r(e,n,s,i,o)}}}(this._parameters,this._specification))};function Yn(t){var e=t.key,n=t.value,r=t.valueSpec||{},i=t.objectElementValidators||{},o=t.style,a=t.styleSpec,s=[],u=jn(n);if("object"!==u)return[new Mt(e,n,"object expected, "+u+" found")];for(var c in n){var l=c.split(".")[0],h=r[l]||r["*"],f=void 0;if(i[l])f=i[l];else if(r[l])f=wr;else if(i["*"])f=i["*"];else{if(!r["*"]){s.push(new Mt(e,n[c],'unknown property "'+c+'"'));continue}f=wr}s=s.concat(f({key:(e?e+".":e)+c,value:n[c],valueSpec:h,style:o,styleSpec:a,object:n,objectKey:c},n))}for(var p in r)i[p]||r[p].required&&void 0===r[p].default&&void 0===n[p]&&s.push(new Mt(e,n,'missing required property "'+p+'"'));return s}function $n(t){var e=t.value,n=t.valueSpec,r=t.style,i=t.styleSpec,o=t.key,a=t.arrayElementValidator||wr;if("array"!==jn(e))return[new Mt(o,e,"array expected, "+jn(e)+" found")];if(n.length&&e.length!==n.length)return[new Mt(o,e,"array length "+n.length+" expected, length "+e.length+" found")];if(n["min-length"]&&e.length<n["min-length"])return[new Mt(o,e,"array length at least "+n["min-length"]+" expected, length "+e.length+" found")];var s={type:n.value,values:n.values};i.$version<7&&(s.function=n.function),"object"===jn(n.value)&&(s=n.value);for(var u=[],c=0;c<e.length;c++)u=u.concat(a({array:e,arrayIndex:c,value:e[c],valueSpec:s,style:r,styleSpec:i,key:o+"["+c+"]"}));return u}function tr(t){var e=t.key,n=t.value,r=t.valueSpec,i=jn(n);return"number"===i&&n!=n&&(i="NaN"),"number"!==i?[new Mt(e,n,"number expected, "+i+" found")]:"minimum"in r&&n<r.minimum?[new Mt(e,n,n+" is less than the minimum value "+r.minimum)]:"maximum"in r&&n>r.maximum?[new Mt(e,n,n+" is greater than the maximum value "+r.maximum)]:[]}function er(t){var e,n,r,i=t.valueSpec,o=Rt(t.value.type),a={},s="categorical"!==o&&void 0===t.value.property,u=!s,c="array"===jn(t.value.stops)&&"array"===jn(t.value.stops[0])&&"object"===jn(t.value.stops[0][0]),l=Yn({key:t.key,value:t.value,valueSpec:t.styleSpec.function,style:t.style,styleSpec:t.styleSpec,objectElementValidators:{stops:function(t){if("identity"===o)return[new Mt(t.key,t.value,'identity function may not have a "stops" property')];var e=[],n=t.value;return e=e.concat($n({key:t.key,value:n,valueSpec:t.valueSpec,style:t.style,styleSpec:t.styleSpec,arrayElementValidator:h})),"array"===jn(n)&&0===n.length&&e.push(new Mt(t.key,n,"array must have at least one stop")),e},default:function(t){return wr({key:t.key,value:t.value,valueSpec:i,style:t.style,styleSpec:t.styleSpec})}}});return"identity"===o&&s&&l.push(new Mt(t.key,t.value,'missing required property "property"')),"identity"===o||t.value.stops||l.push(new Mt(t.key,t.value,'missing required property "stops"')),"exponential"===o&&t.valueSpec.expression&&!Ln(t.valueSpec)&&l.push(new Mt(t.key,t.value,"exponential functions not supported")),t.styleSpec.$version>=8&&(u&&!kn(t.valueSpec)?l.push(new Mt(t.key,t.value,"property functions not supported")):s&&!Dn(t.valueSpec)&&l.push(new Mt(t.key,t.value,"zoom functions not supported"))),"categorical"!==o&&!c||void 0!==t.value.property||l.push(new Mt(t.key,t.value,'"property" property is required')),l;function h(t){var e=[],o=t.value,s=t.key;if("array"!==jn(o))return[new Mt(s,o,"array expected, "+jn(o)+" found")];if(2!==o.length)return[new Mt(s,o,"array length 2 expected, length "+o.length+" found")];if(c){if("object"!==jn(o[0]))return[new Mt(s,o,"object expected, "+jn(o[0])+" found")];if(void 0===o[0].zoom)return[new Mt(s,o,"object stop key must have zoom")];if(void 0===o[0].value)return[new Mt(s,o,"object stop key must have value")];if(r&&r>Rt(o[0].zoom))return[new Mt(s,o[0].zoom,"stop zoom values must appear in ascending order")];Rt(o[0].zoom)!==r&&(r=Rt(o[0].zoom),n=void 0,a={}),e=e.concat(Yn({key:s+"[0]",value:o[0],valueSpec:{zoom:{}},style:t.style,styleSpec:t.styleSpec,objectElementValidators:{zoom:tr,value:f}}))}else e=e.concat(f({key:s+"[0]",value:o[0],valueSpec:{},style:t.style,styleSpec:t.styleSpec},o));return qn(kt(o[1]))?e.concat([new Mt(s+"[1]",o[1],"expressions are not allowed in function stops.")]):e.concat(wr({key:s+"[1]",value:o[1],valueSpec:i,style:t.style,styleSpec:t.styleSpec}))}function f(t,r){var s=jn(t.value),u=Rt(t.value),c=null!==t.value?t.value:r;if(e){if(s!==e)return[new Mt(t.key,c,s+" stop domain type must match previous stop domain type "+e)]}else e=s;if("number"!==s&&"string"!==s&&"boolean"!==s)return[new Mt(t.key,c,"stop domain value must be a number, string, or boolean")];if("number"!==s&&"categorical"!==o){var l="number expected, "+s+" found";return kn(i)&&void 0===o&&(l+='\nIf you intended to use a categorical function, specify `"type": "categorical"`.'),[new Mt(t.key,c,l)]}return"categorical"!==o||"number"!==s||isFinite(u)&&Math.floor(u)===u?"categorical"!==o&&"number"===s&&void 0!==n&&u<n?[new Mt(t.key,c,"stop domain values must appear in ascending order")]:(n=u,"categorical"===o&&u in a?[new Mt(t.key,c,"stop domain values must be unique")]:(a[u]=!0,[])):[new Mt(t.key,c,"integer expected, found "+u)]}}function nr(t){var e=("property"===t.expressionContext?Qn:Xn)(kt(t.value),t.valueSpec);if("error"===e.result)return e.value.map((function(e){return new Mt(""+t.key+e.key,t.value,e.message)}));var n=e.value.expression||e.value._styleExpression.expression;if("property"===t.expressionContext&&"text-font"===t.propertyKey&&!n.outputDefined())return[new Mt(t.key,t.value,'Invalid data expression for "'+t.propertyKey+'". Output values must be contained as literals within the expression.')];if("property"===t.expressionContext&&"layout"===t.propertyType&&!Fe(n))return[new Mt(t.key,t.value,'"feature-state" data expressions are not supported with layout properties.')];if("filter"===t.expressionContext&&!Fe(n))return[new Mt(t.key,t.value,'"feature-state" data expressions are not supported with filters.')];if(t.expressionContext&&0===t.expressionContext.indexOf("cluster")){if(!ze(n,["zoom","feature-state"]))return[new Mt(t.key,t.value,'"zoom" and "feature-state" expressions are not supported with cluster properties.')];if("cluster-initial"===t.expressionContext&&!je(n))return[new Mt(t.key,t.value,"Feature data expressions are not supported with initial expression part of cluster properties.")]}return[]}function rr(t){var e=t.key,n=t.value,r=t.valueSpec,i=[];return Array.isArray(r.values)?-1===r.values.indexOf(Rt(n))&&i.push(new Mt(e,n,"expected one of ["+r.values.join(", ")+"], "+JSON.stringify(n)+" found")):-1===Object.keys(r.values).indexOf(Rt(n))&&i.push(new Mt(e,n,"expected one of ["+Object.keys(r.values).join(", ")+"], "+JSON.stringify(n)+" found")),i}function ir(t){if(!0===t||!1===t)return!0;if(!Array.isArray(t)||0===t.length)return!1;switch(t[0]){case"has":return t.length>=2&&"$id"!==t[1]&&"$type"!==t[1];case"in":return t.length>=3&&("string"!=typeof t[1]||Array.isArray(t[2]));case"!in":case"!has":case"none":return!1;case"==":case"!=":case">":case">=":case"<":case"<=":return 3!==t.length||Array.isArray(t[1])||Array.isArray(t[2]);case"any":case"all":for(var e=0,n=t.slice(1);e<n.length;e+=1){var r=n[e];if(!ir(r)&&"boolean"!=typeof r)return!1}return!0;default:return!0}}Kn.deserialize=function(t){return new Kn(t._parameters,t._specification)},Kn.serialize=function(t){return{_parameters:t._parameters,_specification:t._specification}};var or={type:"boolean",default:!1,transition:!1,"property-type":"data-driven",expression:{interpolated:!1,parameters:["zoom","feature"]}};function ar(t){if(null==t)return{filter:function(){return!0},needGeometry:!1};ir(t)||(t=ur(t));var e=Xn(t,or);if("error"===e.result)throw new Error(e.value.map((function(t){return t.key+": "+t.message})).join(", "));return{filter:function(t,n,r){return e.value.evaluate(t,n,{},r)},needGeometry:function t(e){if(!Array.isArray(e))return!1;if("within"===e[0])return!0;for(var n=1;n<e.length;n++)if(t(e[n]))return!0;return!1}(t)}}function sr(t,e){return t<e?-1:t>e?1:0}function ur(t){if(!t)return!0;var e,n=t[0];return t.length<=1?"any"!==n:"=="===n?cr(t[1],t[2],"=="):"!="===n?fr(cr(t[1],t[2],"==")):"<"===n||">"===n||"<="===n||">="===n?cr(t[1],t[2],n):"any"===n?(e=t.slice(1),["any"].concat(e.map(ur))):"all"===n?["all"].concat(t.slice(1).map(ur)):"none"===n?["all"].concat(t.slice(1).map(ur).map(fr)):"in"===n?lr(t[1],t.slice(2)):"!in"===n?fr(lr(t[1],t.slice(2))):"has"===n?hr(t[1]):"!has"===n?fr(hr(t[1])):"within"!==n||t}function cr(t,e,n){switch(t){case"$type":return["filter-type-"+n,e];case"$id":return["filter-id-"+n,e];default:return["filter-"+n,t,e]}}function lr(t,e){if(0===e.length)return!1;switch(t){case"$type":return["filter-type-in",["literal",e]];case"$id":return["filter-id-in",["literal",e]];default:return e.length>200&&!e.some((function(t){return typeof t!=typeof e[0]}))?["filter-in-large",t,["literal",e.sort(sr)]]:["filter-in-small",t,["literal",e]]}}function hr(t){switch(t){case"$type":return!0;case"$id":return["filter-has-id"];default:return["filter-has",t]}}function fr(t){return["!",t]}function pr(t){return ir(kt(t.value))?nr(Bt({},t,{expressionContext:"filter",valueSpec:{value:"boolean"}})):function t(e){var n=e.value,r=e.key;if("array"!==jn(n))return[new Mt(r,n,"array expected, "+jn(n)+" found")];var i,o=e.styleSpec,a=[];if(n.length<1)return[new Mt(r,n,"filter array must have at least 1 element")];switch(a=a.concat(rr({key:r+"[0]",value:n[0],valueSpec:o.filter_operator,style:e.style,styleSpec:e.styleSpec})),Rt(n[0])){case"<":case"<=":case">":case">=":n.length>=2&&"$type"===Rt(n[1])&&a.push(new Mt(r,n,'"$type" cannot be use with operator "'+n[0]+'"'));case"==":case"!=":3!==n.length&&a.push(new Mt(r,n,'filter array for operator "'+n[0]+'" must have 3 elements'));case"in":case"!in":n.length>=2&&"string"!==(i=jn(n[1]))&&a.push(new Mt(r+"[1]",n[1],"string expected, "+i+" found"));for(var s=2;s<n.length;s++)i=jn(n[s]),"$type"===Rt(n[1])?a=a.concat(rr({key:r+"["+s+"]",value:n[s],valueSpec:o.geometry_type,style:e.style,styleSpec:e.styleSpec})):"string"!==i&&"number"!==i&&"boolean"!==i&&a.push(new Mt(r+"["+s+"]",n[s],"string, number, or boolean expected, "+i+" found"));break;case"any":case"all":case"none":for(var u=1;u<n.length;u++)a=a.concat(t({key:r+"["+u+"]",value:n[u],style:e.style,styleSpec:e.styleSpec}));break;case"has":case"!has":i=jn(n[1]),2!==n.length?a.push(new Mt(r,n,'filter array for "'+n[0]+'" operator must have 2 elements')):"string"!==i&&a.push(new Mt(r+"[1]",n[1],"string expected, "+i+" found"));break;case"within":i=jn(n[1]),2!==n.length?a.push(new Mt(r,n,'filter array for "'+n[0]+'" operator must have 2 elements')):"object"!==i&&a.push(new Mt(r+"[1]",n[1],"object expected, "+i+" found"))}return a}(t)}function dr(t,e){var n=t.key,r=t.style,i=t.styleSpec,o=t.value,a=t.objectKey,s=i[e+"_"+t.layerType];if(!s)return[];var u=a.match(/^(.*)-transition$/);if("paint"===e&&u&&s[u[1]]&&s[u[1]].transition)return wr({key:n,value:o,valueSpec:i.transition,style:r,styleSpec:i});var c,l=t.valueSpec||s[a];if(!l)return[new Mt(n,o,'unknown property "'+a+'"')];if("string"===jn(o)&&kn(l)&&!l.tokens&&(c=/^{([^}]+)}$/.exec(o)))return[new Mt(n,o,'"'+a+'" does not support interpolation syntax\nUse an identity property function instead: `{ "type": "identity", "property": '+JSON.stringify(c[1])+" }`.")];var h=[];return"symbol"===t.layerType&&("text-field"===a&&r&&!r.glyphs&&h.push(new Mt(n,o,'use of "text-field" requires a style "glyphs" property')),"text-font"===a&&Fn(kt(o))&&"identity"===Rt(o.type)&&h.push(new Mt(n,o,'"text-font" does not support identity functions'))),h.concat(wr({key:t.key,value:o,valueSpec:l,style:r,styleSpec:i,expressionContext:"property",propertyType:e,propertyKey:a}))}function Ar(t){return dr(t,"paint")}function gr(t){return dr(t,"layout")}function mr(t){var e=[],n=t.value,r=t.key,i=t.style,o=t.styleSpec;n.type||n.ref||e.push(new Mt(r,n,'either "type" or "ref" is required'));var a,s=Rt(n.type),u=Rt(n.ref);if(n.id)for(var c=Rt(n.id),l=0;l<t.arrayIndex;l++){var h=i.layers[l];Rt(h.id)===c&&e.push(new Mt(r,n.id,'duplicate layer id "'+n.id+'", previously used at line '+h.id.__line__))}if("ref"in n)["type","source","source-layer","filter","layout"].forEach((function(t){t in n&&e.push(new Mt(r,n[t],'"'+t+'" is prohibited for ref layers'))})),i.layers.forEach((function(t){Rt(t.id)===u&&(a=t)})),a?a.ref?e.push(new Mt(r,n.ref,"ref cannot reference another ref layer")):s=Rt(a.type):e.push(new Mt(r,n.ref,'ref layer "'+u+'" not found'));else if("background"!==s)if(n.source){var f=i.sources&&i.sources[n.source],p=f&&Rt(f.type);f?"vector"===p&&"raster"===s?e.push(new Mt(r,n.source,'layer "'+n.id+'" requires a raster source')):"raster"===p&&"raster"!==s?e.push(new Mt(r,n.source,'layer "'+n.id+'" requires a vector source')):"vector"!==p||n["source-layer"]?"raster-dem"===p&&"hillshade"!==s?e.push(new Mt(r,n.source,"raster-dem source can only be used with layer type 'hillshade'.")):"line"!==s||!n.paint||!n.paint["line-gradient"]||"geojson"===p&&f.lineMetrics||e.push(new Mt(r,n,'layer "'+n.id+'" specifies a line-gradient, which requires a GeoJSON source with `lineMetrics` enabled.')):e.push(new Mt(r,n,'layer "'+n.id+'" must specify a "source-layer"')):e.push(new Mt(r,n.source,'source "'+n.source+'" not found'))}else e.push(new Mt(r,n,'missing required property "source"'));return e=e.concat(Yn({key:r,value:n,valueSpec:o.layer,style:t.style,styleSpec:t.styleSpec,objectElementValidators:{"*":function(){return[]},type:function(){return wr({key:r+".type",value:n.type,valueSpec:o.layer.type,style:t.style,styleSpec:t.styleSpec,object:n,objectKey:"type"})},filter:pr,layout:function(t){return Yn({layer:n,key:t.key,value:t.value,style:t.style,styleSpec:t.styleSpec,objectElementValidators:{"*":function(t){return gr(Bt({layerType:s},t))}}})},paint:function(t){return Yn({layer:n,key:t.key,value:t.value,style:t.style,styleSpec:t.styleSpec,objectElementValidators:{"*":function(t){return Ar(Bt({layerType:s},t))}}})}}}))}function yr(t){var e=t.value,n=t.key,r=jn(e);return"string"!==r?[new Mt(n,e,"string expected, "+r+" found")]:[]}var vr={promoteId:function(t){var e=t.key,n=t.value;if("string"===jn(n))return yr({key:e,value:n});var r=[];for(var i in n)r.push.apply(r,yr({key:e+"."+i,value:n[i]}));return r}};function _r(t){var e=t.value,n=t.key,r=t.styleSpec,i=t.style;if(!e.type)return[new Mt(n,e,'"type" is required')];var o,a=Rt(e.type);switch(a){case"vector":case"raster":case"raster-dem":return Yn({key:n,value:e,valueSpec:r["source_"+a.replace("-","_")],style:t.style,styleSpec:r,objectElementValidators:vr});case"geojson":if(o=Yn({key:n,value:e,valueSpec:r.source_geojson,style:i,styleSpec:r,objectElementValidators:vr}),e.cluster)for(var s in e.clusterProperties){var u=e.clusterProperties[s],c=u[0],l="string"==typeof c?[c,["accumulated"],["get",s]]:c;o.push.apply(o,nr({key:n+"."+s+".map",value:u[1],expressionContext:"cluster-map"})),o.push.apply(o,nr({key:n+"."+s+".reduce",value:l,expressionContext:"cluster-reduce"}))}return o;case"video":return Yn({key:n,value:e,valueSpec:r.source_video,style:i,styleSpec:r});case"image":return Yn({key:n,value:e,valueSpec:r.source_image,style:i,styleSpec:r});case"canvas":return[new Mt(n,null,"Please use runtime APIs to add canvas sources, rather than including them in stylesheets.","source.canvas")];default:return rr({key:n+".type",value:e.type,valueSpec:{values:["vector","raster","raster-dem","geojson","video","image"]},style:i,styleSpec:r})}}function br(t){var e=t.value,n=t.styleSpec,r=n.light,i=t.style,o=[],a=jn(e);if(void 0===e)return o;if("object"!==a)return o.concat([new Mt("light",e,"object expected, "+a+" found")]);for(var s in e){var u=s.match(/^(.*)-transition$/);o=o.concat(u&&r[u[1]]&&r[u[1]].transition?wr({key:s,value:e[s],valueSpec:n.transition,style:i,styleSpec:n}):r[s]?wr({key:s,value:e[s],valueSpec:r[s],style:i,styleSpec:n}):[new Mt(s,e[s],'unknown property "'+s+'"')])}return o}var xr={"*":function(){return[]},array:$n,boolean:function(t){var e=t.value,n=t.key,r=jn(e);return"boolean"!==r?[new Mt(n,e,"boolean expected, "+r+" found")]:[]},number:tr,color:function(t){var e=t.key,n=t.value,r=jn(n);return"string"!==r?[new Mt(e,n,"color expected, "+r+" found")]:null===$t(n)?[new Mt(e,n,'color expected, "'+n+'" found')]:[]},constants:It,enum:rr,filter:pr,function:er,layer:mr,object:Yn,source:_r,light:br,string:yr,formatted:function(t){return 0===yr(t).length?[]:nr(t)},resolvedImage:function(t){return 0===yr(t).length?[]:nr(t)}};function wr(t){var e=t.value,n=t.valueSpec,r=t.styleSpec;return n.expression&&Fn(Rt(e))?er(t):n.expression&&qn(kt(e))?nr(t):n.type&&xr[n.type]?xr[n.type](t):Yn(Bt({},t,{valueSpec:n.type?r[n.type]:n}))}function Er(t){var e=t.value,n=t.key,r=yr(t);return r.length||(-1===e.indexOf("{fontstack}")&&r.push(new Mt(n,e,'"glyphs" url must include a "{fontstack}" token')),-1===e.indexOf("{range}")&&r.push(new Mt(n,e,'"glyphs" url must include a "{range}" token'))),r}function Or(t,e){void 0===e&&(e=Pt);var n=[];return n=n.concat(wr({key:"",value:t,valueSpec:e.$root,styleSpec:e,style:t,objectElementValidators:{glyphs:Er,"*":function(){return[]}}})),t.constants&&(n=n.concat(It({key:"constants",value:t.constants,style:t,styleSpec:e}))),Sr(n)}function Sr(t){return[].concat(t).sort((function(t,e){return t.line-e.line}))}function Tr(t){return function(){for(var e=[],n=arguments.length;n--;)e[n]=arguments[n];return Sr(t.apply(this,e))}}Or.source=Tr(_r),Or.light=Tr(br),Or.layer=Tr(mr),Or.filter=Tr(pr),Or.paintProperty=Tr(Ar),Or.layoutProperty=Tr(gr);var Cr=Or,Pr=Cr.light,Mr=Cr.paintProperty,Ir=Cr.layoutProperty;function Br(t,e){var n=!1;if(e&&e.length)for(var r=0,i=e;r<i.length;r+=1)t.fire(new Tt(new Error(i[r].message))),n=!0;return n}var Rr=kr;function kr(t,e,n){var r=this.cells=[];if(t instanceof ArrayBuffer){this.arrayBuffer=t;var i=new Int32Array(this.arrayBuffer);t=i[0],this.d=(e=i[1])+2*(n=i[2]);for(var o=0;o<this.d*this.d;o++){var a=i[3+o],s=i[3+o+1];r.push(a===s?null:i.subarray(a,s))}var u=i[3+r.length+1];this.keys=i.subarray(i[3+r.length],u),this.bboxes=i.subarray(u),this.insert=this._insertReadonly}else{this.d=e+2*n;for(var c=0;c<this.d*this.d;c++)r.push([]);this.keys=[],this.bboxes=[]}this.n=e,this.extent=t,this.padding=n,this.scale=e/t,this.uid=0;var l=n/e*t;this.min=-l,this.max=t+l}kr.prototype.insert=function(t,e,n,r,i){this._forEachCell(e,n,r,i,this._insertCell,this.uid++),this.keys.push(t),this.bboxes.push(e),this.bboxes.push(n),this.bboxes.push(r),this.bboxes.push(i)},kr.prototype._insertReadonly=function(){throw"Cannot insert into a GridIndex created from an ArrayBuffer."},kr.prototype._insertCell=function(t,e,n,r,i,o){this.cells[i].push(o)},kr.prototype.query=function(t,e,n,r,i){var o=this.min,a=this.max;if(t<=o&&e<=o&&a<=n&&a<=r&&!i)return Array.prototype.slice.call(this.keys);var s=[];return this._forEachCell(t,e,n,r,this._queryCell,s,{},i),s},kr.prototype._queryCell=function(t,e,n,r,i,o,a,s){var u=this.cells[i];if(null!==u)for(var c=this.keys,l=this.bboxes,h=0;h<u.length;h++){var f=u[h];if(void 0===a[f]){var p=4*f;(s?s(l[p+0],l[p+1],l[p+2],l[p+3]):t<=l[p+2]&&e<=l[p+3]&&n>=l[p+0]&&r>=l[p+1])?(a[f]=!0,o.push(c[f])):a[f]=!1}}},kr.prototype._forEachCell=function(t,e,n,r,i,o,a,s){for(var u=this._convertToCellCoord(t),c=this._convertToCellCoord(e),l=this._convertToCellCoord(n),h=this._convertToCellCoord(r),f=u;f<=l;f++)for(var p=c;p<=h;p++){var d=this.d*p+f;if((!s||s(this._convertFromCellCoord(f),this._convertFromCellCoord(p),this._convertFromCellCoord(f+1),this._convertFromCellCoord(p+1)))&&i.call(this,t,e,n,r,d,o,a,s))return}},kr.prototype._convertFromCellCoord=function(t){return(t-this.padding)/this.scale},kr.prototype._convertToCellCoord=function(t){return Math.max(0,Math.min(this.d-1,Math.floor(t*this.scale)+this.padding))},kr.prototype.toArrayBuffer=function(){if(this.arrayBuffer)return this.arrayBuffer;for(var t=this.cells,e=3+this.cells.length+1+1,n=0,r=0;r<this.cells.length;r++)n+=this.cells[r].length;var i=new Int32Array(e+n+this.keys.length+this.bboxes.length);i[0]=this.extent,i[1]=this.n,i[2]=this.padding;for(var o=e,a=0;a<t.length;a++){var s=t[a];i[3+a]=o,i.set(s,o),o+=s.length}return i[3+t.length]=o,i.set(this.keys,o),i[3+t.length+1]=o+=this.keys.length,i.set(this.bboxes,o),o+=this.bboxes.length,i.buffer};var Dr=a.ImageData,Lr=a.ImageBitmap,jr={};function Fr(t,e,n){void 0===n&&(n={}),Object.defineProperty(e,"_classRegistryKey",{value:t,writeable:!1}),jr[t]={klass:e,omit:n.omit||[],shallow:n.shallow||[]}}for(var zr in Fr("Object",Object),Rr.serialize=function(t,e){var n=t.toArrayBuffer();return e&&e.push(n),{buffer:n}},Rr.deserialize=function(t){return new Rr(t.buffer)},Fr("Grid",Rr),Fr("Color",te),Fr("Error",Error),Fr("ResolvedImage",ie),Fr("StylePropertyFunction",Kn),Fr("StyleExpression",Wn,{omit:["_evaluator"]}),Fr("ZoomDependentExpression",Jn),Fr("ZoomConstantExpression",Zn),Fr("CompoundExpression",ve,{omit:["_evaluate"]}),Tn)Tn[zr]._classRegistryKey||Fr("Expression_"+zr,Tn[zr]);function Ur(t){return t&&"undefined"!=typeof ArrayBuffer&&(t instanceof ArrayBuffer||t.constructor&&"ArrayBuffer"===t.constructor.name)}function Nr(t){return Lr&&t instanceof Lr}function Gr(t,e){if(null==t||"boolean"==typeof t||"number"==typeof t||"string"==typeof t||t instanceof Boolean||t instanceof Number||t instanceof String||t instanceof Date||t instanceof RegExp)return t;if(Ur(t)||Nr(t))return e&&e.push(t),t;if(ArrayBuffer.isView(t)){var n=t;return e&&e.push(n.buffer),n}if(t instanceof Dr)return e&&e.push(t.data.buffer),t;if(Array.isArray(t)){for(var r=[],i=0,o=t;i<o.length;i+=1)r.push(Gr(o[i],e));return r}if("object"==typeof t){var a=t.constructor,s=a._classRegistryKey;if(!s)throw new Error("can't serialize object of unregistered class");var u=a.serialize?a.serialize(t,e):{};if(!a.serialize){for(var c in t)if(t.hasOwnProperty(c)&&!(jr[s].omit.indexOf(c)>=0)){var l=t[c];u[c]=jr[s].shallow.indexOf(c)>=0?l:Gr(l,e)}t instanceof Error&&(u.message=t.message)}if(u.$name)throw new Error("$name property is reserved for worker serialization logic.");return"Object"!==s&&(u.$name=s),u}throw new Error("can't serialize object of type "+typeof t)}function Vr(t){if(null==t||"boolean"==typeof t||"number"==typeof t||"string"==typeof t||t instanceof Boolean||t instanceof Number||t instanceof String||t instanceof Date||t instanceof RegExp||Ur(t)||Nr(t)||ArrayBuffer.isView(t)||t instanceof Dr)return t;if(Array.isArray(t))return t.map(Vr);if("object"==typeof t){var e=t.$name||"Object",n=jr[e].klass;if(!n)throw new Error("can't deserialize unregistered class "+e);if(n.deserialize)return n.deserialize(t);for(var r=Object.create(n.prototype),i=0,o=Object.keys(t);i<o.length;i+=1){var a=o[i];if("$name"!==a){var s=t[a];r[a]=jr[e].shallow.indexOf(a)>=0?s:Vr(s)}}return r}throw new Error("can't deserialize object of type "+typeof t)}var Hr=function(){this.first=!0};Hr.prototype.update=function(t,e){var n=Math.floor(t);return this.first?(this.first=!1,this.lastIntegerZoom=n,this.lastIntegerZoomTime=0,this.lastZoom=t,this.lastFloorZoom=n,!0):(this.lastFloorZoom>n?(this.lastIntegerZoom=n+1,this.lastIntegerZoomTime=e):this.lastFloorZoom<n&&(this.lastIntegerZoom=n,this.lastIntegerZoomTime=e),t!==this.lastZoom&&(this.lastZoom=t,this.lastFloorZoom=n,!0))};var Wr={"Latin-1 Supplement":function(t){return t>=128&&t<=255},Arabic:function(t){return t>=1536&&t<=1791},"Arabic Supplement":function(t){return t>=1872&&t<=1919},"Arabic Extended-A":function(t){return t>=2208&&t<=2303},"Hangul Jamo":function(t){return t>=4352&&t<=4607},"Unified Canadian Aboriginal Syllabics":function(t){return t>=5120&&t<=5759},Khmer:function(t){return t>=6016&&t<=6143},"Unified Canadian Aboriginal Syllabics Extended":function(t){return t>=6320&&t<=6399},"General Punctuation":function(t){return t>=8192&&t<=8303},"Letterlike Symbols":function(t){return t>=8448&&t<=8527},"Number Forms":function(t){return t>=8528&&t<=8591},"Miscellaneous Technical":function(t){return t>=8960&&t<=9215},"Control Pictures":function(t){return t>=9216&&t<=9279},"Optical Character Recognition":function(t){return t>=9280&&t<=9311},"Enclosed Alphanumerics":function(t){return t>=9312&&t<=9471},"Geometric Shapes":function(t){return t>=9632&&t<=9727},"Miscellaneous Symbols":function(t){return t>=9728&&t<=9983},"Miscellaneous Symbols and Arrows":function(t){return t>=11008&&t<=11263},"CJK Radicals Supplement":function(t){return t>=11904&&t<=12031},"Kangxi Radicals":function(t){return t>=12032&&t<=12255},"Ideographic Description Characters":function(t){return t>=12272&&t<=12287},"CJK Symbols and Punctuation":function(t){return t>=12288&&t<=12351},Hiragana:function(t){return t>=12352&&t<=12447},Katakana:function(t){return t>=12448&&t<=12543},Bopomofo:function(t){return t>=12544&&t<=12591},"Hangul Compatibility Jamo":function(t){return t>=12592&&t<=12687},Kanbun:function(t){return t>=12688&&t<=12703},"Bopomofo Extended":function(t){return t>=12704&&t<=12735},"CJK Strokes":function(t){return t>=12736&&t<=12783},"Katakana Phonetic Extensions":function(t){return t>=12784&&t<=12799},"Enclosed CJK Letters and Months":function(t){return t>=12800&&t<=13055},"CJK Compatibility":function(t){return t>=13056&&t<=13311},"CJK Unified Ideographs Extension A":function(t){return t>=13312&&t<=19903},"Yijing Hexagram Symbols":function(t){return t>=19904&&t<=19967},"CJK Unified Ideographs":function(t){return t>=19968&&t<=40959},"Yi Syllables":function(t){return t>=40960&&t<=42127},"Yi Radicals":function(t){return t>=42128&&t<=42191},"Hangul Jamo Extended-A":function(t){return t>=43360&&t<=43391},"Hangul Syllables":function(t){return t>=44032&&t<=55215},"Hangul Jamo Extended-B":function(t){return t>=55216&&t<=55295},"Private Use Area":function(t){return t>=57344&&t<=63743},"CJK Compatibility Ideographs":function(t){return t>=63744&&t<=64255},"Arabic Presentation Forms-A":function(t){return t>=64336&&t<=65023},"Vertical Forms":function(t){return t>=65040&&t<=65055},"CJK Compatibility Forms":function(t){return t>=65072&&t<=65103},"Small Form Variants":function(t){return t>=65104&&t<=65135},"Arabic Presentation Forms-B":function(t){return t>=65136&&t<=65279},"Halfwidth and Fullwidth Forms":function(t){return t>=65280&&t<=65519}};function qr(t){for(var e=0,n=t;e<n.length;e+=1)if(Xr(n[e].charCodeAt(0)))return!0;return!1}function Xr(t){return!(746!==t&&747!==t&&(t<4352||!(Wr["Bopomofo Extended"](t)||Wr.Bopomofo(t)||Wr["CJK Compatibility Forms"](t)&&!(t>=65097&&t<=65103)||Wr["CJK Compatibility Ideographs"](t)||Wr["CJK Compatibility"](t)||Wr["CJK Radicals Supplement"](t)||Wr["CJK Strokes"](t)||!(!Wr["CJK Symbols and Punctuation"](t)||t>=12296&&t<=12305||t>=12308&&t<=12319||12336===t)||Wr["CJK Unified Ideographs Extension A"](t)||Wr["CJK Unified Ideographs"](t)||Wr["Enclosed CJK Letters and Months"](t)||Wr["Hangul Compatibility Jamo"](t)||Wr["Hangul Jamo Extended-A"](t)||Wr["Hangul Jamo Extended-B"](t)||Wr["Hangul Jamo"](t)||Wr["Hangul Syllables"](t)||Wr.Hiragana(t)||Wr["Ideographic Description Characters"](t)||Wr.Kanbun(t)||Wr["Kangxi Radicals"](t)||Wr["Katakana Phonetic Extensions"](t)||Wr.Katakana(t)&&12540!==t||!(!Wr["Halfwidth and Fullwidth Forms"](t)||65288===t||65289===t||65293===t||t>=65306&&t<=65310||65339===t||65341===t||65343===t||t>=65371&&t<=65503||65507===t||t>=65512&&t<=65519)||!(!Wr["Small Form Variants"](t)||t>=65112&&t<=65118||t>=65123&&t<=65126)||Wr["Unified Canadian Aboriginal Syllabics"](t)||Wr["Unified Canadian Aboriginal Syllabics Extended"](t)||Wr["Vertical Forms"](t)||Wr["Yijing Hexagram Symbols"](t)||Wr["Yi Syllables"](t)||Wr["Yi Radicals"](t))))}function Zr(t){return!(Xr(t)||function(t){return!!(Wr["Latin-1 Supplement"](t)&&(167===t||169===t||174===t||177===t||188===t||189===t||190===t||215===t||247===t)||Wr["General Punctuation"](t)&&(8214===t||8224===t||8225===t||8240===t||8241===t||8251===t||8252===t||8258===t||8263===t||8264===t||8265===t||8273===t)||Wr["Letterlike Symbols"](t)||Wr["Number Forms"](t)||Wr["Miscellaneous Technical"](t)&&(t>=8960&&t<=8967||t>=8972&&t<=8991||t>=8996&&t<=9e3||9003===t||t>=9085&&t<=9114||t>=9150&&t<=9165||9167===t||t>=9169&&t<=9179||t>=9186&&t<=9215)||Wr["Control Pictures"](t)&&9251!==t||Wr["Optical Character Recognition"](t)||Wr["Enclosed Alphanumerics"](t)||Wr["Geometric Shapes"](t)||Wr["Miscellaneous Symbols"](t)&&!(t>=9754&&t<=9759)||Wr["Miscellaneous Symbols and Arrows"](t)&&(t>=11026&&t<=11055||t>=11088&&t<=11097||t>=11192&&t<=11243)||Wr["CJK Symbols and Punctuation"](t)||Wr.Katakana(t)||Wr["Private Use Area"](t)||Wr["CJK Compatibility Forms"](t)||Wr["Small Form Variants"](t)||Wr["Halfwidth and Fullwidth Forms"](t)||8734===t||8756===t||8757===t||t>=9984&&t<=10087||t>=10102&&t<=10131||65532===t||65533===t)}(t))}function Jr(t){return t>=1424&&t<=2303||Wr["Arabic Presentation Forms-A"](t)||Wr["Arabic Presentation Forms-B"](t)}function Qr(t,e){return!(!e&&Jr(t)||t>=2304&&t<=3583||t>=3840&&t<=4255||Wr.Khmer(t))}function Kr(t){for(var e=0,n=t;e<n.length;e+=1)if(Jr(n[e].charCodeAt(0)))return!0;return!1}var Yr=null,$r="unavailable",ti=null,ei=function(t){t&&"string"==typeof t&&t.indexOf("NetworkError")>-1&&($r="error"),Yr&&Yr(t)};function ni(){ri.fire(new St("pluginStateChange",{pluginStatus:$r,pluginURL:ti}))}var ri=new Ct,ii=function(){return $r},oi=function(){if("deferred"!==$r||!ti)throw new Error("rtl-text-plugin cannot be downloaded unless a pluginURL is specified");$r="loading",ni(),ti&&_t({url:ti},(function(t){t?ei(t):($r="loaded",ni())}))},ai={applyArabicShaping:null,processBidirectionalText:null,processStyledBidirectionalText:null,isLoaded:function(){return"loaded"===$r||null!=ai.applyArabicShaping},isLoading:function(){return"loading"===$r},setState:function(t){$r=t.pluginStatus,ti=t.pluginURL},isParsed:function(){return null!=ai.applyArabicShaping&&null!=ai.processBidirectionalText&&null!=ai.processStyledBidirectionalText},getPluginURL:function(){return ti}},si=function(t,e){this.zoom=t,e?(this.now=e.now,this.fadeDuration=e.fadeDuration,this.zoomHistory=e.zoomHistory,this.transition=e.transition):(this.now=0,this.fadeDuration=0,this.zoomHistory=new Hr,this.transition={})};si.prototype.isSupportedScript=function(t){return function(t,e){for(var n=0,r=t;n<r.length;n+=1)if(!Qr(r[n].charCodeAt(0),e))return!1;return!0}(t,ai.isLoaded())},si.prototype.crossFadingFactor=function(){return 0===this.fadeDuration?1:Math.min((this.now-this.zoomHistory.lastIntegerZoomTime)/this.fadeDuration,1)},si.prototype.getCrossfadeParameters=function(){var t=this.zoom,e=t-Math.floor(t),n=this.crossFadingFactor();return t>this.zoomHistory.lastIntegerZoom?{fromScale:2,toScale:1,t:e+(1-e)*n}:{fromScale:.5,toScale:1,t:1-(1-n)*e}};var ui=function(t,e){this.property=t,this.value=e,this.expression=function(t,e){if(Fn(t))return new Kn(t,e);if(qn(t)){var n=Qn(t,e);if("error"===n.result)throw new Error(n.value.map((function(t){return t.key+": "+t.message})).join(", "));return n.value}var r=t;return"string"==typeof t&&"color"===e.type&&(r=te.parse(t)),{kind:"constant",evaluate:function(){return r}}}(void 0===e?t.specification.default:e,t.specification)};ui.prototype.isDataDriven=function(){return"source"===this.expression.kind||"composite"===this.expression.kind},ui.prototype.possiblyEvaluate=function(t,e,n){return this.property.possiblyEvaluate(this,t,e,n)};var ci=function(t){this.property=t,this.value=new ui(t,void 0)};ci.prototype.transitioned=function(t,e){return new hi(this.property,this.value,e,f({},t.transition,this.transition),t.now)},ci.prototype.untransitioned=function(){return new hi(this.property,this.value,null,{},0)};var li=function(t){this._properties=t,this._values=Object.create(t.defaultTransitionablePropertyValues)};li.prototype.getValue=function(t){return b(this._values[t].value.value)},li.prototype.setValue=function(t,e){this._values.hasOwnProperty(t)||(this._values[t]=new ci(this._values[t].property)),this._values[t].value=new ui(this._values[t].property,null===e?void 0:b(e))},li.prototype.getTransition=function(t){return b(this._values[t].transition)},li.prototype.setTransition=function(t,e){this._values.hasOwnProperty(t)||(this._values[t]=new ci(this._values[t].property)),this._values[t].transition=b(e)||void 0},li.prototype.serialize=function(){for(var t={},e=0,n=Object.keys(this._values);e<n.length;e+=1){var r=n[e],i=this.getValue(r);void 0!==i&&(t[r]=i);var o=this.getTransition(r);void 0!==o&&(t[r+"-transition"]=o)}return t},li.prototype.transitioned=function(t,e){for(var n=new fi(this._properties),r=0,i=Object.keys(this._values);r<i.length;r+=1){var o=i[r];n._values[o]=this._values[o].transitioned(t,e._values[o])}return n},li.prototype.untransitioned=function(){for(var t=new fi(this._properties),e=0,n=Object.keys(this._values);e<n.length;e+=1){var r=n[e];t._values[r]=this._values[r].untransitioned()}return t};var hi=function(t,e,n,r,i){this.property=t,this.value=e,this.begin=i+r.delay||0,this.end=this.begin+r.duration||0,t.specification.transition&&(r.delay||r.duration)&&(this.prior=n)};hi.prototype.possiblyEvaluate=function(t,e,n){var r=t.now||0,i=this.value.possiblyEvaluate(t,e,n),o=this.prior;if(o){if(r>this.end)return this.prior=null,i;if(this.value.isDataDriven())return this.prior=null,i;if(r<this.begin)return o.possiblyEvaluate(t,e,n);var a=(r-this.begin)/(this.end-this.begin);return this.property.interpolate(o.possiblyEvaluate(t,e,n),i,function(t){if(t<=0)return 0;if(t>=1)return 1;var e=t*t,n=e*t;return 4*(t<.5?n:3*(t-e)+n-.75)}(a))}return i};var fi=function(t){this._properties=t,this._values=Object.create(t.defaultTransitioningPropertyValues)};fi.prototype.possiblyEvaluate=function(t,e,n){for(var r=new Ai(this._properties),i=0,o=Object.keys(this._values);i<o.length;i+=1){var a=o[i];r._values[a]=this._values[a].possiblyEvaluate(t,e,n)}return r},fi.prototype.hasTransition=function(){for(var t=0,e=Object.keys(this._values);t<e.length;t+=1)if(this._values[e[t]].prior)return!0;return!1};var pi=function(t){this._properties=t,this._values=Object.create(t.defaultPropertyValues)};pi.prototype.getValue=function(t){return b(this._values[t].value)},pi.prototype.setValue=function(t,e){this._values[t]=new ui(this._values[t].property,null===e?void 0:b(e))},pi.prototype.serialize=function(){for(var t={},e=0,n=Object.keys(this._values);e<n.length;e+=1){var r=n[e],i=this.getValue(r);void 0!==i&&(t[r]=i)}return t},pi.prototype.possiblyEvaluate=function(t,e,n){for(var r=new Ai(this._properties),i=0,o=Object.keys(this._values);i<o.length;i+=1){var a=o[i];r._values[a]=this._values[a].possiblyEvaluate(t,e,n)}return r};var di=function(t,e,n){this.property=t,this.value=e,this.parameters=n};di.prototype.isConstant=function(){return"constant"===this.value.kind},di.prototype.constantOr=function(t){return"constant"===this.value.kind?this.value.value:t},di.prototype.evaluate=function(t,e,n,r){return this.property.evaluate(this.value,this.parameters,t,e,n,r)};var Ai=function(t){this._properties=t,this._values=Object.create(t.defaultPossiblyEvaluatedValues)};Ai.prototype.get=function(t){return this._values[t]};var gi=function(t){this.specification=t};gi.prototype.possiblyEvaluate=function(t,e){return t.expression.evaluate(e)},gi.prototype.interpolate=function(t,e,n){var r=We[this.specification.type];return r?r(t,e,n):t};var mi=function(t,e){this.specification=t,this.overrides=e};mi.prototype.possiblyEvaluate=function(t,e,n,r){return new di(this,"constant"===t.expression.kind||"camera"===t.expression.kind?{kind:"constant",value:t.expression.evaluate(e,null,{},n,r)}:t.expression,e)},mi.prototype.interpolate=function(t,e,n){if("constant"!==t.value.kind||"constant"!==e.value.kind)return t;if(void 0===t.value.value||void 0===e.value.value)return new di(this,{kind:"constant",value:void 0},t.parameters);var r=We[this.specification.type];return r?new di(this,{kind:"constant",value:r(t.value.value,e.value.value,n)},t.parameters):t},mi.prototype.evaluate=function(t,e,n,r,i,o){return"constant"===t.kind?t.value:t.evaluate(e,n,r,i,o)};var yi=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.possiblyEvaluate=function(t,e,n,r){if(void 0===t.value)return new di(this,{kind:"constant",value:void 0},e);if("constant"===t.expression.kind){var i=t.expression.evaluate(e,null,{},n,r),o="resolvedImage"===t.property.specification.type&&"string"!=typeof i?i.name:i,a=this._calculate(o,o,o,e);return new di(this,{kind:"constant",value:a},e)}if("camera"===t.expression.kind){var s=this._calculate(t.expression.evaluate({zoom:e.zoom-1}),t.expression.evaluate({zoom:e.zoom}),t.expression.evaluate({zoom:e.zoom+1}),e);return new di(this,{kind:"constant",value:s},e)}return new di(this,t.expression,e)},e.prototype.evaluate=function(t,e,n,r,i,o){if("source"===t.kind){var a=t.evaluate(e,n,r,i,o);return this._calculate(a,a,a,e)}return"composite"===t.kind?this._calculate(t.evaluate({zoom:Math.floor(e.zoom)-1},n,r),t.evaluate({zoom:Math.floor(e.zoom)},n,r),t.evaluate({zoom:Math.floor(e.zoom)+1},n,r),e):t.value},e.prototype._calculate=function(t,e,n,r){return r.zoom>r.zoomHistory.lastIntegerZoom?{from:t,to:e}:{from:n,to:e}},e.prototype.interpolate=function(t){return t},e}(mi),vi=function(t){this.specification=t};vi.prototype.possiblyEvaluate=function(t,e,n,r){if(void 0!==t.value){if("constant"===t.expression.kind){var i=t.expression.evaluate(e,null,{},n,r);return this._calculate(i,i,i,e)}return this._calculate(t.expression.evaluate(new si(Math.floor(e.zoom-1),e)),t.expression.evaluate(new si(Math.floor(e.zoom),e)),t.expression.evaluate(new si(Math.floor(e.zoom+1),e)),e)}},vi.prototype._calculate=function(t,e,n,r){return r.zoom>r.zoomHistory.lastIntegerZoom?{from:t,to:e}:{from:n,to:e}},vi.prototype.interpolate=function(t){return t};var _i=function(t){this.specification=t};_i.prototype.possiblyEvaluate=function(t,e,n,r){return!!t.expression.evaluate(e,null,{},n,r)},_i.prototype.interpolate=function(){return!1};var bi=function(t){for(var e in this.properties=t,this.defaultPropertyValues={},this.defaultTransitionablePropertyValues={},this.defaultTransitioningPropertyValues={},this.defaultPossiblyEvaluatedValues={},this.overridableProperties=[],t){var n=t[e];n.specification.overridable&&this.overridableProperties.push(e);var r=this.defaultPropertyValues[e]=new ui(n,void 0),i=this.defaultTransitionablePropertyValues[e]=new ci(n);this.defaultTransitioningPropertyValues[e]=i.untransitioned(),this.defaultPossiblyEvaluatedValues[e]=r.possiblyEvaluate({})}};Fr("DataDrivenProperty",mi),Fr("DataConstantProperty",gi),Fr("CrossFadedDataDrivenProperty",yi),Fr("CrossFadedProperty",vi),Fr("ColorRampProperty",_i);var xi=function(t){function e(e,n){if(t.call(this),this.id=e.id,this.type=e.type,this._featureFilter={filter:function(){return!0},needGeometry:!1},"custom"!==e.type&&(this.metadata=(e=e).metadata,this.minzoom=e.minzoom,this.maxzoom=e.maxzoom,"background"!==e.type&&(this.source=e.source,this.sourceLayer=e["source-layer"],this.filter=e.filter),n.layout&&(this._unevaluatedLayout=new pi(n.layout)),n.paint)){for(var r in this._transitionablePaint=new li(n.paint),e.paint)this.setPaintProperty(r,e.paint[r],{validate:!1});for(var i in e.layout)this.setLayoutProperty(i,e.layout[i],{validate:!1});this._transitioningPaint=this._transitionablePaint.untransitioned(),this.paint=new Ai(n.paint)}}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getCrossfadeParameters=function(){return this._crossfadeParameters},e.prototype.getLayoutProperty=function(t){return"visibility"===t?this.visibility:this._unevaluatedLayout.getValue(t)},e.prototype.setLayoutProperty=function(t,e,n){void 0===n&&(n={}),null!=e&&this._validate(Ir,"layers."+this.id+".layout."+t,t,e,n)||("visibility"!==t?this._unevaluatedLayout.setValue(t,e):this.visibility=e)},e.prototype.getPaintProperty=function(t){return y(t,"-transition")?this._transitionablePaint.getTransition(t.slice(0,-"-transition".length)):this._transitionablePaint.getValue(t)},e.prototype.setPaintProperty=function(t,e,n){if(void 0===n&&(n={}),null!=e&&this._validate(Mr,"layers."+this.id+".paint."+t,t,e,n))return!1;if(y(t,"-transition"))return this._transitionablePaint.setTransition(t.slice(0,-"-transition".length),e||void 0),!1;var r=this._transitionablePaint._values[t],i="cross-faded-data-driven"===r.property.specification["property-type"],o=r.value.isDataDriven(),a=r.value;this._transitionablePaint.setValue(t,e),this._handleSpecialPaintPropertyUpdate(t);var s=this._transitionablePaint._values[t].value;return s.isDataDriven()||o||i||this._handleOverridablePaintPropertyUpdate(t,a,s)},e.prototype._handleSpecialPaintPropertyUpdate=function(t){},e.prototype._handleOverridablePaintPropertyUpdate=function(t,e,n){return!1},e.prototype.isHidden=function(t){return!!(this.minzoom&&t<this.minzoom)||!!(this.maxzoom&&t>=this.maxzoom)||"none"===this.visibility},e.prototype.updateTransitions=function(t){this._transitioningPaint=this._transitionablePaint.transitioned(t,this._transitioningPaint)},e.prototype.hasTransition=function(){return this._transitioningPaint.hasTransition()},e.prototype.recalculate=function(t,e){t.getCrossfadeParameters&&(this._crossfadeParameters=t.getCrossfadeParameters()),this._unevaluatedLayout&&(this.layout=this._unevaluatedLayout.possiblyEvaluate(t,void 0,e)),this.paint=this._transitioningPaint.possiblyEvaluate(t,void 0,e)},e.prototype.serialize=function(){var t={id:this.id,type:this.type,source:this.source,"source-layer":this.sourceLayer,metadata:this.metadata,minzoom:this.minzoom,maxzoom:this.maxzoom,filter:this.filter,layout:this._unevaluatedLayout&&this._unevaluatedLayout.serialize(),paint:this._transitionablePaint&&this._transitionablePaint.serialize()};return this.visibility&&(t.layout=t.layout||{},t.layout.visibility=this.visibility),_(t,(function(t,e){return!(void 0===t||"layout"===e&&!Object.keys(t).length||"paint"===e&&!Object.keys(t).length)}))},e.prototype._validate=function(t,e,n,r,i){return void 0===i&&(i={}),(!i||!1!==i.validate)&&Br(this,t.call(Cr,{key:e,layerType:this.type,objectKey:n,value:r,styleSpec:Pt,style:{glyphs:!0,sprite:!0}}))},e.prototype.is3D=function(){return!1},e.prototype.isTileClipped=function(){return!1},e.prototype.hasOffscreenPass=function(){return!1},e.prototype.resize=function(){},e.prototype.isStateDependent=function(){for(var t in this.paint._values){var e=this.paint.get(t);if(e instanceof di&&kn(e.property.specification)&&("source"===e.value.kind||"composite"===e.value.kind)&&e.value.isStateDependent)return!0}return!1},e}(Ct),wi={Int8:Int8Array,Uint8:Uint8Array,Int16:Int16Array,Uint16:Uint16Array,Int32:Int32Array,Uint32:Uint32Array,Float32:Float32Array},Ei=function(t,e){this._structArray=t,this._pos1=e*this.size,this._pos2=this._pos1/2,this._pos4=this._pos1/4,this._pos8=this._pos1/8},Oi=function(){this.isTransferred=!1,this.capacity=-1,this.resize(0)};function Si(t,e){void 0===e&&(e=1);var n=0,r=0;return{members:t.map((function(t){var i=wi[t.type].BYTES_PER_ELEMENT,o=n=Ti(n,Math.max(e,i)),a=t.components||1;return r=Math.max(r,i),n+=i*a,{name:t.name,type:t.type,components:a,offset:o}})),size:Ti(n,Math.max(r,e)),alignment:e}}function Ti(t,e){return Math.ceil(t/e)*e}Oi.serialize=function(t,e){return t._trim(),e&&(t.isTransferred=!0,e.push(t.arrayBuffer)),{length:t.length,arrayBuffer:t.arrayBuffer}},Oi.deserialize=function(t){var e=Object.create(this.prototype);return e.arrayBuffer=t.arrayBuffer,e.length=t.length,e.capacity=t.arrayBuffer.byteLength/e.bytesPerElement,e._refreshViews(),e},Oi.prototype._trim=function(){this.length!==this.capacity&&(this.capacity=this.length,this.arrayBuffer=this.arrayBuffer.slice(0,this.length*this.bytesPerElement),this._refreshViews())},Oi.prototype.clear=function(){this.length=0},Oi.prototype.resize=function(t){this.reserve(t),this.length=t},Oi.prototype.reserve=function(t){if(t>this.capacity){this.capacity=Math.max(t,Math.floor(5*this.capacity),128),this.arrayBuffer=new ArrayBuffer(this.capacity*this.bytesPerElement);var e=this.uint8;this._refreshViews(),e&&this.uint8.set(e)}},Oi.prototype._refreshViews=function(){throw new Error("_refreshViews() must be implemented by each concrete StructArray layout")};var Ci=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e){var n=this.length;return this.resize(n+1),this.emplace(n,t,e)},e.prototype.emplace=function(t,e,n){var r=2*t;return this.int16[r+0]=e,this.int16[r+1]=n,t},e}(Oi);Ci.prototype.bytesPerElement=4,Fr("StructArrayLayout2i4",Ci);var Pi=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n,r){var i=this.length;return this.resize(i+1),this.emplace(i,t,e,n,r)},e.prototype.emplace=function(t,e,n,r,i){var o=4*t;return this.int16[o+0]=e,this.int16[o+1]=n,this.int16[o+2]=r,this.int16[o+3]=i,t},e}(Oi);Pi.prototype.bytesPerElement=8,Fr("StructArrayLayout4i8",Pi);var Mi=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n,r,i,o){var a=this.length;return this.resize(a+1),this.emplace(a,t,e,n,r,i,o)},e.prototype.emplace=function(t,e,n,r,i,o,a){var s=6*t;return this.int16[s+0]=e,this.int16[s+1]=n,this.int16[s+2]=r,this.int16[s+3]=i,this.int16[s+4]=o,this.int16[s+5]=a,t},e}(Oi);Mi.prototype.bytesPerElement=12,Fr("StructArrayLayout2i4i12",Mi);var Ii=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n,r,i,o){var a=this.length;return this.resize(a+1),this.emplace(a,t,e,n,r,i,o)},e.prototype.emplace=function(t,e,n,r,i,o,a){var s=4*t,u=8*t;return this.int16[s+0]=e,this.int16[s+1]=n,this.uint8[u+4]=r,this.uint8[u+5]=i,this.uint8[u+6]=o,this.uint8[u+7]=a,t},e}(Oi);Ii.prototype.bytesPerElement=8,Fr("StructArrayLayout2i4ub8",Ii);var Bi=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e){var n=this.length;return this.resize(n+1),this.emplace(n,t,e)},e.prototype.emplace=function(t,e,n){var r=2*t;return this.float32[r+0]=e,this.float32[r+1]=n,t},e}(Oi);Bi.prototype.bytesPerElement=8,Fr("StructArrayLayout2f8",Bi);var Ri=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n,r,i,o,a,s,u,c){var l=this.length;return this.resize(l+1),this.emplace(l,t,e,n,r,i,o,a,s,u,c)},e.prototype.emplace=function(t,e,n,r,i,o,a,s,u,c,l){var h=10*t;return this.uint16[h+0]=e,this.uint16[h+1]=n,this.uint16[h+2]=r,this.uint16[h+3]=i,this.uint16[h+4]=o,this.uint16[h+5]=a,this.uint16[h+6]=s,this.uint16[h+7]=u,this.uint16[h+8]=c,this.uint16[h+9]=l,t},e}(Oi);Ri.prototype.bytesPerElement=20,Fr("StructArrayLayout10ui20",Ri);var ki=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n,r,i,o,a,s,u,c,l,h){var f=this.length;return this.resize(f+1),this.emplace(f,t,e,n,r,i,o,a,s,u,c,l,h)},e.prototype.emplace=function(t,e,n,r,i,o,a,s,u,c,l,h,f){var p=12*t;return this.int16[p+0]=e,this.int16[p+1]=n,this.int16[p+2]=r,this.int16[p+3]=i,this.uint16[p+4]=o,this.uint16[p+5]=a,this.uint16[p+6]=s,this.uint16[p+7]=u,this.int16[p+8]=c,this.int16[p+9]=l,this.int16[p+10]=h,this.int16[p+11]=f,t},e}(Oi);ki.prototype.bytesPerElement=24,Fr("StructArrayLayout4i4ui4i24",ki);var Di=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n){var r=this.length;return this.resize(r+1),this.emplace(r,t,e,n)},e.prototype.emplace=function(t,e,n,r){var i=3*t;return this.float32[i+0]=e,this.float32[i+1]=n,this.float32[i+2]=r,t},e}(Oi);Di.prototype.bytesPerElement=12,Fr("StructArrayLayout3f12",Di);var Li=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.uint32=new Uint32Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t){var e=this.length;return this.resize(e+1),this.emplace(e,t)},e.prototype.emplace=function(t,e){return this.uint32[1*t+0]=e,t},e}(Oi);Li.prototype.bytesPerElement=4,Fr("StructArrayLayout1ul4",Li);var ji=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer),this.uint32=new Uint32Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n,r,i,o,a,s,u){var c=this.length;return this.resize(c+1),this.emplace(c,t,e,n,r,i,o,a,s,u)},e.prototype.emplace=function(t,e,n,r,i,o,a,s,u,c){var l=10*t,h=5*t;return this.int16[l+0]=e,this.int16[l+1]=n,this.int16[l+2]=r,this.int16[l+3]=i,this.int16[l+4]=o,this.int16[l+5]=a,this.uint32[h+3]=s,this.uint16[l+8]=u,this.uint16[l+9]=c,t},e}(Oi);ji.prototype.bytesPerElement=20,Fr("StructArrayLayout6i1ul2ui20",ji);var Fi=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n,r,i,o){var a=this.length;return this.resize(a+1),this.emplace(a,t,e,n,r,i,o)},e.prototype.emplace=function(t,e,n,r,i,o,a){var s=6*t;return this.int16[s+0]=e,this.int16[s+1]=n,this.int16[s+2]=r,this.int16[s+3]=i,this.int16[s+4]=o,this.int16[s+5]=a,t},e}(Oi);Fi.prototype.bytesPerElement=12,Fr("StructArrayLayout2i2i2i12",Fi);var zi=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n,r,i){var o=this.length;return this.resize(o+1),this.emplace(o,t,e,n,r,i)},e.prototype.emplace=function(t,e,n,r,i,o){var a=4*t,s=8*t;return this.float32[a+0]=e,this.float32[a+1]=n,this.float32[a+2]=r,this.int16[s+6]=i,this.int16[s+7]=o,t},e}(Oi);zi.prototype.bytesPerElement=16,Fr("StructArrayLayout2f1f2i16",zi);var Ui=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n,r){var i=this.length;return this.resize(i+1),this.emplace(i,t,e,n,r)},e.prototype.emplace=function(t,e,n,r,i){var o=12*t,a=3*t;return this.uint8[o+0]=e,this.uint8[o+1]=n,this.float32[a+1]=r,this.float32[a+2]=i,t},e}(Oi);Ui.prototype.bytesPerElement=12,Fr("StructArrayLayout2ub2f12",Ui);var Ni=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n){var r=this.length;return this.resize(r+1),this.emplace(r,t,e,n)},e.prototype.emplace=function(t,e,n,r){var i=3*t;return this.uint16[i+0]=e,this.uint16[i+1]=n,this.uint16[i+2]=r,t},e}(Oi);Ni.prototype.bytesPerElement=6,Fr("StructArrayLayout3ui6",Ni);var Gi=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer),this.uint32=new Uint32Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n,r,i,o,a,s,u,c,l,h,f,p,d,A,g){var m=this.length;return this.resize(m+1),this.emplace(m,t,e,n,r,i,o,a,s,u,c,l,h,f,p,d,A,g)},e.prototype.emplace=function(t,e,n,r,i,o,a,s,u,c,l,h,f,p,d,A,g,m){var y=24*t,v=12*t,_=48*t;return this.int16[y+0]=e,this.int16[y+1]=n,this.uint16[y+2]=r,this.uint16[y+3]=i,this.uint32[v+2]=o,this.uint32[v+3]=a,this.uint32[v+4]=s,this.uint16[y+10]=u,this.uint16[y+11]=c,this.uint16[y+12]=l,this.float32[v+7]=h,this.float32[v+8]=f,this.uint8[_+36]=p,this.uint8[_+37]=d,this.uint8[_+38]=A,this.uint32[v+10]=g,this.int16[y+22]=m,t},e}(Oi);Gi.prototype.bytesPerElement=48,Fr("StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48",Gi);var Vi=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer),this.uint32=new Uint32Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n,r,i,o,a,s,u,c,l,h,f,p,d,A,g,m,y,v,_,b,x,w,E,O,S,T){var C=this.length;return this.resize(C+1),this.emplace(C,t,e,n,r,i,o,a,s,u,c,l,h,f,p,d,A,g,m,y,v,_,b,x,w,E,O,S,T)},e.prototype.emplace=function(t,e,n,r,i,o,a,s,u,c,l,h,f,p,d,A,g,m,y,v,_,b,x,w,E,O,S,T,C){var P=34*t,M=17*t;return this.int16[P+0]=e,this.int16[P+1]=n,this.int16[P+2]=r,this.int16[P+3]=i,this.int16[P+4]=o,this.int16[P+5]=a,this.int16[P+6]=s,this.int16[P+7]=u,this.uint16[P+8]=c,this.uint16[P+9]=l,this.uint16[P+10]=h,this.uint16[P+11]=f,this.uint16[P+12]=p,this.uint16[P+13]=d,this.uint16[P+14]=A,this.uint16[P+15]=g,this.uint16[P+16]=m,this.uint16[P+17]=y,this.uint16[P+18]=v,this.uint16[P+19]=_,this.uint16[P+20]=b,this.uint16[P+21]=x,this.uint16[P+22]=w,this.uint32[M+12]=E,this.float32[M+13]=O,this.float32[M+14]=S,this.float32[M+15]=T,this.float32[M+16]=C,t},e}(Oi);Vi.prototype.bytesPerElement=68,Fr("StructArrayLayout8i15ui1ul4f68",Vi);var Hi=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t){var e=this.length;return this.resize(e+1),this.emplace(e,t)},e.prototype.emplace=function(t,e){return this.float32[1*t+0]=e,t},e}(Oi);Hi.prototype.bytesPerElement=4,Fr("StructArrayLayout1f4",Hi);var Wi=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n){var r=this.length;return this.resize(r+1),this.emplace(r,t,e,n)},e.prototype.emplace=function(t,e,n,r){var i=3*t;return this.int16[i+0]=e,this.int16[i+1]=n,this.int16[i+2]=r,t},e}(Oi);Wi.prototype.bytesPerElement=6,Fr("StructArrayLayout3i6",Wi);var qi=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.uint32=new Uint32Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n){var r=this.length;return this.resize(r+1),this.emplace(r,t,e,n)},e.prototype.emplace=function(t,e,n,r){var i=4*t;return this.uint32[2*t+0]=e,this.uint16[i+2]=n,this.uint16[i+3]=r,t},e}(Oi);qi.prototype.bytesPerElement=8,Fr("StructArrayLayout1ul2ui8",qi);var Xi=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e){var n=this.length;return this.resize(n+1),this.emplace(n,t,e)},e.prototype.emplace=function(t,e,n){var r=2*t;return this.uint16[r+0]=e,this.uint16[r+1]=n,t},e}(Oi);Xi.prototype.bytesPerElement=4,Fr("StructArrayLayout2ui4",Xi);var Zi=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t){var e=this.length;return this.resize(e+1),this.emplace(e,t)},e.prototype.emplace=function(t,e){return this.uint16[1*t+0]=e,t},e}(Oi);Zi.prototype.bytesPerElement=2,Fr("StructArrayLayout1ui2",Zi);var Ji=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer)},e.prototype.emplaceBack=function(t,e,n,r){var i=this.length;return this.resize(i+1),this.emplace(i,t,e,n,r)},e.prototype.emplace=function(t,e,n,r,i){var o=4*t;return this.float32[o+0]=e,this.float32[o+1]=n,this.float32[o+2]=r,this.float32[o+3]=i,t},e}(Oi);Ji.prototype.bytesPerElement=16,Fr("StructArrayLayout4f16",Ji);var Qi=function(t){function e(){t.apply(this,arguments)}t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e;var n={anchorPointX:{configurable:!0},anchorPointY:{configurable:!0},x1:{configurable:!0},y1:{configurable:!0},x2:{configurable:!0},y2:{configurable:!0},featureIndex:{configurable:!0},sourceLayerIndex:{configurable:!0},bucketIndex:{configurable:!0},anchorPoint:{configurable:!0}};return n.anchorPointX.get=function(){return this._structArray.int16[this._pos2+0]},n.anchorPointY.get=function(){return this._structArray.int16[this._pos2+1]},n.x1.get=function(){return this._structArray.int16[this._pos2+2]},n.y1.get=function(){return this._structArray.int16[this._pos2+3]},n.x2.get=function(){return this._structArray.int16[this._pos2+4]},n.y2.get=function(){return this._structArray.int16[this._pos2+5]},n.featureIndex.get=function(){return this._structArray.uint32[this._pos4+3]},n.sourceLayerIndex.get=function(){return this._structArray.uint16[this._pos2+8]},n.bucketIndex.get=function(){return this._structArray.uint16[this._pos2+9]},n.anchorPoint.get=function(){return new i(this.anchorPointX,this.anchorPointY)},Object.defineProperties(e.prototype,n),e}(Ei);Qi.prototype.size=20;var Ki=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.get=function(t){return new Qi(this,t)},e}(ji);Fr("CollisionBoxArray",Ki);var Yi=function(t){function e(){t.apply(this,arguments)}t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e;var n={anchorX:{configurable:!0},anchorY:{configurable:!0},glyphStartIndex:{configurable:!0},numGlyphs:{configurable:!0},vertexStartIndex:{configurable:!0},lineStartIndex:{configurable:!0},lineLength:{configurable:!0},segment:{configurable:!0},lowerSize:{configurable:!0},upperSize:{configurable:!0},lineOffsetX:{configurable:!0},lineOffsetY:{configurable:!0},writingMode:{configurable:!0},placedOrientation:{configurable:!0},hidden:{configurable:!0},crossTileID:{configurable:!0},associatedIconIndex:{configurable:!0}};return n.anchorX.get=function(){return this._structArray.int16[this._pos2+0]},n.anchorY.get=function(){return this._structArray.int16[this._pos2+1]},n.glyphStartIndex.get=function(){return this._structArray.uint16[this._pos2+2]},n.numGlyphs.get=function(){return this._structArray.uint16[this._pos2+3]},n.vertexStartIndex.get=function(){return this._structArray.uint32[this._pos4+2]},n.lineStartIndex.get=function(){return this._structArray.uint32[this._pos4+3]},n.lineLength.get=function(){return this._structArray.uint32[this._pos4+4]},n.segment.get=function(){return this._structArray.uint16[this._pos2+10]},n.lowerSize.get=function(){return this._structArray.uint16[this._pos2+11]},n.upperSize.get=function(){return this._structArray.uint16[this._pos2+12]},n.lineOffsetX.get=function(){return this._structArray.float32[this._pos4+7]},n.lineOffsetY.get=function(){return this._structArray.float32[this._pos4+8]},n.writingMode.get=function(){return this._structArray.uint8[this._pos1+36]},n.placedOrientation.get=function(){return this._structArray.uint8[this._pos1+37]},n.placedOrientation.set=function(t){this._structArray.uint8[this._pos1+37]=t},n.hidden.get=function(){return this._structArray.uint8[this._pos1+38]},n.hidden.set=function(t){this._structArray.uint8[this._pos1+38]=t},n.crossTileID.get=function(){return this._structArray.uint32[this._pos4+10]},n.crossTileID.set=function(t){this._structArray.uint32[this._pos4+10]=t},n.associatedIconIndex.get=function(){return this._structArray.int16[this._pos2+22]},Object.defineProperties(e.prototype,n),e}(Ei);Yi.prototype.size=48;var $i=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.get=function(t){return new Yi(this,t)},e}(Gi);Fr("PlacedSymbolArray",$i);var to=function(t){function e(){t.apply(this,arguments)}t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e;var n={anchorX:{configurable:!0},anchorY:{configurable:!0},rightJustifiedTextSymbolIndex:{configurable:!0},centerJustifiedTextSymbolIndex:{configurable:!0},leftJustifiedTextSymbolIndex:{configurable:!0},verticalPlacedTextSymbolIndex:{configurable:!0},placedIconSymbolIndex:{configurable:!0},verticalPlacedIconSymbolIndex:{configurable:!0},key:{configurable:!0},textBoxStartIndex:{configurable:!0},textBoxEndIndex:{configurable:!0},verticalTextBoxStartIndex:{configurable:!0},verticalTextBoxEndIndex:{configurable:!0},iconBoxStartIndex:{configurable:!0},iconBoxEndIndex:{configurable:!0},verticalIconBoxStartIndex:{configurable:!0},verticalIconBoxEndIndex:{configurable:!0},featureIndex:{configurable:!0},numHorizontalGlyphVertices:{configurable:!0},numVerticalGlyphVertices:{configurable:!0},numIconVertices:{configurable:!0},numVerticalIconVertices:{configurable:!0},useRuntimeCollisionCircles:{configurable:!0},crossTileID:{configurable:!0},textBoxScale:{configurable:!0},textOffset0:{configurable:!0},textOffset1:{configurable:!0},collisionCircleDiameter:{configurable:!0}};return n.anchorX.get=function(){return this._structArray.int16[this._pos2+0]},n.anchorY.get=function(){return this._structArray.int16[this._pos2+1]},n.rightJustifiedTextSymbolIndex.get=function(){return this._structArray.int16[this._pos2+2]},n.centerJustifiedTextSymbolIndex.get=function(){return this._structArray.int16[this._pos2+3]},n.leftJustifiedTextSymbolIndex.get=function(){return this._structArray.int16[this._pos2+4]},n.verticalPlacedTextSymbolIndex.get=function(){return this._structArray.int16[this._pos2+5]},n.placedIconSymbolIndex.get=function(){return this._structArray.int16[this._pos2+6]},n.verticalPlacedIconSymbolIndex.get=function(){return this._structArray.int16[this._pos2+7]},n.key.get=function(){return this._structArray.uint16[this._pos2+8]},n.textBoxStartIndex.get=function(){return this._structArray.uint16[this._pos2+9]},n.textBoxEndIndex.get=function(){return this._structArray.uint16[this._pos2+10]},n.verticalTextBoxStartIndex.get=function(){return this._structArray.uint16[this._pos2+11]},n.verticalTextBoxEndIndex.get=function(){return this._structArray.uint16[this._pos2+12]},n.iconBoxStartIndex.get=function(){return this._structArray.uint16[this._pos2+13]},n.iconBoxEndIndex.get=function(){return this._structArray.uint16[this._pos2+14]},n.verticalIconBoxStartIndex.get=function(){return this._structArray.uint16[this._pos2+15]},n.verticalIconBoxEndIndex.get=function(){return this._structArray.uint16[this._pos2+16]},n.featureIndex.get=function(){return this._structArray.uint16[this._pos2+17]},n.numHorizontalGlyphVertices.get=function(){return this._structArray.uint16[this._pos2+18]},n.numVerticalGlyphVertices.get=function(){return this._structArray.uint16[this._pos2+19]},n.numIconVertices.get=function(){return this._structArray.uint16[this._pos2+20]},n.numVerticalIconVertices.get=function(){return this._structArray.uint16[this._pos2+21]},n.useRuntimeCollisionCircles.get=function(){return this._structArray.uint16[this._pos2+22]},n.crossTileID.get=function(){return this._structArray.uint32[this._pos4+12]},n.crossTileID.set=function(t){this._structArray.uint32[this._pos4+12]=t},n.textBoxScale.get=function(){return this._structArray.float32[this._pos4+13]},n.textOffset0.get=function(){return this._structArray.float32[this._pos4+14]},n.textOffset1.get=function(){return this._structArray.float32[this._pos4+15]},n.collisionCircleDiameter.get=function(){return this._structArray.float32[this._pos4+16]},Object.defineProperties(e.prototype,n),e}(Ei);to.prototype.size=68;var eo=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.get=function(t){return new to(this,t)},e}(Vi);Fr("SymbolInstanceArray",eo);var no=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getoffsetX=function(t){return this.float32[1*t+0]},e}(Hi);Fr("GlyphOffsetArray",no);var ro=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getx=function(t){return this.int16[3*t+0]},e.prototype.gety=function(t){return this.int16[3*t+1]},e.prototype.gettileUnitDistanceFromAnchor=function(t){return this.int16[3*t+2]},e}(Wi);Fr("SymbolLineVertexArray",ro);var io=function(t){function e(){t.apply(this,arguments)}t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e;var n={featureIndex:{configurable:!0},sourceLayerIndex:{configurable:!0},bucketIndex:{configurable:!0}};return n.featureIndex.get=function(){return this._structArray.uint32[this._pos4+0]},n.sourceLayerIndex.get=function(){return this._structArray.uint16[this._pos2+2]},n.bucketIndex.get=function(){return this._structArray.uint16[this._pos2+3]},Object.defineProperties(e.prototype,n),e}(Ei);io.prototype.size=8;var oo=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.get=function(t){return new io(this,t)},e}(qi);Fr("FeatureIndexArray",oo);var ao=Si([{name:"a_pos",components:2,type:"Int16"}],4).members,so=function(t){void 0===t&&(t=[]),this.segments=t};function uo(t,e){return 256*(t=l(Math.floor(t),0,255))+l(Math.floor(e),0,255)}so.prototype.prepareSegment=function(t,e,n,r){var i=this.segments[this.segments.length-1];return t>so.MAX_VERTEX_ARRAY_LENGTH&&w("Max vertices per segment is "+so.MAX_VERTEX_ARRAY_LENGTH+": bucket requested "+t),(!i||i.vertexLength+t>so.MAX_VERTEX_ARRAY_LENGTH||i.sortKey!==r)&&(i={vertexOffset:e.length,primitiveOffset:n.length,vertexLength:0,primitiveLength:0},void 0!==r&&(i.sortKey=r),this.segments.push(i)),i},so.prototype.get=function(){return this.segments},so.prototype.destroy=function(){for(var t=0,e=this.segments;t<e.length;t+=1){var n=e[t];for(var r in n.vaos)n.vaos[r].destroy()}},so.simpleSegment=function(t,e,n,r){return new so([{vertexOffset:t,primitiveOffset:e,vertexLength:n,primitiveLength:r,vaos:{},sortKey:0}])},so.MAX_VERTEX_ARRAY_LENGTH=Math.pow(2,16)-1,Fr("SegmentVector",so);var co=Si([{name:"a_pattern_from",components:4,type:"Uint16"},{name:"a_pattern_to",components:4,type:"Uint16"},{name:"a_pixel_ratio_from",components:1,type:"Uint16"},{name:"a_pixel_ratio_to",components:1,type:"Uint16"}]),lo=e((function(t){t.exports=function(t,e){var n,r,i,o,a,s,u,c;for(r=t.length-(n=3&t.length),i=e,a=3432918353,s=461845907,c=0;c<r;)u=255&t.charCodeAt(c)|(255&t.charCodeAt(++c))<<8|(255&t.charCodeAt(++c))<<16|(255&t.charCodeAt(++c))<<24,++c,i=27492+(65535&(o=5*(65535&(i=(i^=u=(65535&(u=(u=(65535&u)*a+(((u>>>16)*a&65535)<<16)&4294967295)<<15|u>>>17))*s+(((u>>>16)*s&65535)<<16)&4294967295)<<13|i>>>19))+((5*(i>>>16)&65535)<<16)&4294967295))+((58964+(o>>>16)&65535)<<16);switch(u=0,n){case 3:u^=(255&t.charCodeAt(c+2))<<16;case 2:u^=(255&t.charCodeAt(c+1))<<8;case 1:i^=u=(65535&(u=(u=(65535&(u^=255&t.charCodeAt(c)))*a+(((u>>>16)*a&65535)<<16)&4294967295)<<15|u>>>17))*s+(((u>>>16)*s&65535)<<16)&4294967295}return i^=t.length,i=2246822507*(65535&(i^=i>>>16))+((2246822507*(i>>>16)&65535)<<16)&4294967295,i=3266489909*(65535&(i^=i>>>13))+((3266489909*(i>>>16)&65535)<<16)&4294967295,(i^=i>>>16)>>>0}})),ho=e((function(t){t.exports=function(t,e){for(var n,r=t.length,i=e^r,o=0;r>=4;)n=1540483477*(65535&(n=255&t.charCodeAt(o)|(255&t.charCodeAt(++o))<<8|(255&t.charCodeAt(++o))<<16|(255&t.charCodeAt(++o))<<24))+((1540483477*(n>>>16)&65535)<<16),i=1540483477*(65535&i)+((1540483477*(i>>>16)&65535)<<16)^(n=1540483477*(65535&(n^=n>>>24))+((1540483477*(n>>>16)&65535)<<16)),r-=4,++o;switch(r){case 3:i^=(255&t.charCodeAt(o+2))<<16;case 2:i^=(255&t.charCodeAt(o+1))<<8;case 1:i=1540483477*(65535&(i^=255&t.charCodeAt(o)))+((1540483477*(i>>>16)&65535)<<16)}return i=1540483477*(65535&(i^=i>>>13))+((1540483477*(i>>>16)&65535)<<16),(i^=i>>>15)>>>0}})),fo=lo,po=ho;fo.murmur3=lo,fo.murmur2=po;var Ao=function(){this.ids=[],this.positions=[],this.indexed=!1};Ao.prototype.add=function(t,e,n,r){this.ids.push(mo(t)),this.positions.push(e,n,r)},Ao.prototype.getPositions=function(t){for(var e=mo(t),n=0,r=this.ids.length-1;n<r;){var i=n+r>>1;this.ids[i]>=e?r=i:n=i+1}for(var o=[];this.ids[n]===e;)o.push({index:this.positions[3*n],start:this.positions[3*n+1],end:this.positions[3*n+2]}),n++;return o},Ao.serialize=function(t,e){var n=new Float64Array(t.ids),r=new Uint32Array(t.positions);return function t(e,n,r,i){for(;r<i;){for(var o=e[r+i>>1],a=r-1,s=i+1;;){do{a++}while(e[a]<o);do{s--}while(e[s]>o);if(a>=s)break;yo(e,a,s),yo(n,3*a,3*s),yo(n,3*a+1,3*s+1),yo(n,3*a+2,3*s+2)}s-r<i-s?(t(e,n,r,s),r=s+1):(t(e,n,s+1,i),i=s)}}(n,r,0,n.length-1),e&&e.push(n.buffer,r.buffer),{ids:n,positions:r}},Ao.deserialize=function(t){var e=new Ao;return e.ids=t.ids,e.positions=t.positions,e.indexed=!0,e};var go=Math.pow(2,53)-1;function mo(t){var e=+t;return!isNaN(e)&&e<=go?e:fo(String(t))}function yo(t,e,n){var r=t[e];t[e]=t[n],t[n]=r}Fr("FeaturePositionMap",Ao);var vo=function(t,e){this.gl=t.gl,this.location=e},_o=function(t){function e(e,n){t.call(this,e,n),this.current=0}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){this.current!==t&&(this.current=t,this.gl.uniform1i(this.location,t))},e}(vo),bo=function(t){function e(e,n){t.call(this,e,n),this.current=0}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){this.current!==t&&(this.current=t,this.gl.uniform1f(this.location,t))},e}(vo),xo=function(t){function e(e,n){t.call(this,e,n),this.current=[0,0]}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){t[0]===this.current[0]&&t[1]===this.current[1]||(this.current=t,this.gl.uniform2f(this.location,t[0],t[1]))},e}(vo),wo=function(t){function e(e,n){t.call(this,e,n),this.current=[0,0,0]}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){t[0]===this.current[0]&&t[1]===this.current[1]&&t[2]===this.current[2]||(this.current=t,this.gl.uniform3f(this.location,t[0],t[1],t[2]))},e}(vo),Eo=function(t){function e(e,n){t.call(this,e,n),this.current=[0,0,0,0]}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){t[0]===this.current[0]&&t[1]===this.current[1]&&t[2]===this.current[2]&&t[3]===this.current[3]||(this.current=t,this.gl.uniform4f(this.location,t[0],t[1],t[2],t[3]))},e}(vo),Oo=function(t){function e(e,n){t.call(this,e,n),this.current=te.transparent}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){t.r===this.current.r&&t.g===this.current.g&&t.b===this.current.b&&t.a===this.current.a||(this.current=t,this.gl.uniform4f(this.location,t.r,t.g,t.b,t.a))},e}(vo),So=new Float32Array(16),To=function(t){function e(e,n){t.call(this,e,n),this.current=So}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){if(t[12]!==this.current[12]||t[0]!==this.current[0])return this.current=t,void this.gl.uniformMatrix4fv(this.location,!1,t);for(var e=1;e<16;e++)if(t[e]!==this.current[e]){this.current=t,this.gl.uniformMatrix4fv(this.location,!1,t);break}},e}(vo);function Co(t){return[uo(255*t.r,255*t.g),uo(255*t.b,255*t.a)]}var Po=function(t,e,n){this.value=t,this.uniformNames=e.map((function(t){return"u_"+t})),this.type=n};Po.prototype.setUniform=function(t,e,n){t.set(n.constantOr(this.value))},Po.prototype.getBinding=function(t,e,n){return"color"===this.type?new Oo(t,e):new bo(t,e)};var Mo=function(t,e){this.uniformNames=e.map((function(t){return"u_"+t})),this.patternFrom=null,this.patternTo=null,this.pixelRatioFrom=1,this.pixelRatioTo=1};Mo.prototype.setConstantPatternPositions=function(t,e){this.pixelRatioFrom=e.pixelRatio,this.pixelRatioTo=t.pixelRatio,this.patternFrom=e.tlbr,this.patternTo=t.tlbr},Mo.prototype.setUniform=function(t,e,n,r){var i="u_pattern_to"===r?this.patternTo:"u_pattern_from"===r?this.patternFrom:"u_pixel_ratio_to"===r?this.pixelRatioTo:"u_pixel_ratio_from"===r?this.pixelRatioFrom:null;i&&t.set(i)},Mo.prototype.getBinding=function(t,e,n){return"u_pattern"===n.substr(0,9)?new Eo(t,e):new bo(t,e)};var Io=function(t,e,n,r){this.expression=t,this.type=n,this.maxValue=0,this.paintVertexAttributes=e.map((function(t){return{name:"a_"+t,type:"Float32",components:"color"===n?2:1,offset:0}})),this.paintVertexArray=new r};Io.prototype.populatePaintArray=function(t,e,n,r,i){var o=this.paintVertexArray.length,a=this.expression.evaluate(new si(0),e,{},r,[],i);this.paintVertexArray.resize(t),this._setPaintValue(o,t,a)},Io.prototype.updatePaintArray=function(t,e,n,r){var i=this.expression.evaluate({zoom:0},n,r);this._setPaintValue(t,e,i)},Io.prototype._setPaintValue=function(t,e,n){if("color"===this.type)for(var r=Co(n),i=t;i<e;i++)this.paintVertexArray.emplace(i,r[0],r[1]);else{for(var o=t;o<e;o++)this.paintVertexArray.emplace(o,n);this.maxValue=Math.max(this.maxValue,Math.abs(n))}},Io.prototype.upload=function(t){this.paintVertexArray&&this.paintVertexArray.arrayBuffer&&(this.paintVertexBuffer&&this.paintVertexBuffer.buffer?this.paintVertexBuffer.updateData(this.paintVertexArray):this.paintVertexBuffer=t.createVertexBuffer(this.paintVertexArray,this.paintVertexAttributes,this.expression.isStateDependent))},Io.prototype.destroy=function(){this.paintVertexBuffer&&this.paintVertexBuffer.destroy()};var Bo=function(t,e,n,r,i,o){this.expression=t,this.uniformNames=e.map((function(t){return"u_"+t+"_t"})),this.type=n,this.useIntegerZoom=r,this.zoom=i,this.maxValue=0,this.paintVertexAttributes=e.map((function(t){return{name:"a_"+t,type:"Float32",components:"color"===n?4:2,offset:0}})),this.paintVertexArray=new o};Bo.prototype.populatePaintArray=function(t,e,n,r,i){var o=this.expression.evaluate(new si(this.zoom),e,{},r,[],i),a=this.expression.evaluate(new si(this.zoom+1),e,{},r,[],i),s=this.paintVertexArray.length;this.paintVertexArray.resize(t),this._setPaintValue(s,t,o,a)},Bo.prototype.updatePaintArray=function(t,e,n,r){var i=this.expression.evaluate({zoom:this.zoom},n,r),o=this.expression.evaluate({zoom:this.zoom+1},n,r);this._setPaintValue(t,e,i,o)},Bo.prototype._setPaintValue=function(t,e,n,r){if("color"===this.type)for(var i=Co(n),o=Co(r),a=t;a<e;a++)this.paintVertexArray.emplace(a,i[0],i[1],o[0],o[1]);else{for(var s=t;s<e;s++)this.paintVertexArray.emplace(s,n,r);this.maxValue=Math.max(this.maxValue,Math.abs(n),Math.abs(r))}},Bo.prototype.upload=function(t){this.paintVertexArray&&this.paintVertexArray.arrayBuffer&&(this.paintVertexBuffer&&this.paintVertexBuffer.buffer?this.paintVertexBuffer.updateData(this.paintVertexArray):this.paintVertexBuffer=t.createVertexBuffer(this.paintVertexArray,this.paintVertexAttributes,this.expression.isStateDependent))},Bo.prototype.destroy=function(){this.paintVertexBuffer&&this.paintVertexBuffer.destroy()},Bo.prototype.setUniform=function(t,e){var n=this.useIntegerZoom?Math.floor(e.zoom):e.zoom,r=l(this.expression.interpolationFactor(n,this.zoom,this.zoom+1),0,1);t.set(r)},Bo.prototype.getBinding=function(t,e,n){return new bo(t,e)};var Ro=function(t,e,n,r,i,o){this.expression=t,this.type=e,this.useIntegerZoom=n,this.zoom=r,this.layerId=o,this.zoomInPaintVertexArray=new i,this.zoomOutPaintVertexArray=new i};Ro.prototype.populatePaintArray=function(t,e,n){var r=this.zoomInPaintVertexArray.length;this.zoomInPaintVertexArray.resize(t),this.zoomOutPaintVertexArray.resize(t),this._setPaintValues(r,t,e.patterns&&e.patterns[this.layerId],n)},Ro.prototype.updatePaintArray=function(t,e,n,r,i){this._setPaintValues(t,e,n.patterns&&n.patterns[this.layerId],i)},Ro.prototype._setPaintValues=function(t,e,n,r){if(r&&n){var i=r[n.min],o=r[n.mid],a=r[n.max];if(i&&o&&a)for(var s=t;s<e;s++)this.zoomInPaintVertexArray.emplace(s,o.tl[0],o.tl[1],o.br[0],o.br[1],i.tl[0],i.tl[1],i.br[0],i.br[1],o.pixelRatio,i.pixelRatio),this.zoomOutPaintVertexArray.emplace(s,o.tl[0],o.tl[1],o.br[0],o.br[1],a.tl[0],a.tl[1],a.br[0],a.br[1],o.pixelRatio,a.pixelRatio)}},Ro.prototype.upload=function(t){this.zoomInPaintVertexArray&&this.zoomInPaintVertexArray.arrayBuffer&&this.zoomOutPaintVertexArray&&this.zoomOutPaintVertexArray.arrayBuffer&&(this.zoomInPaintVertexBuffer=t.createVertexBuffer(this.zoomInPaintVertexArray,co.members,this.expression.isStateDependent),this.zoomOutPaintVertexBuffer=t.createVertexBuffer(this.zoomOutPaintVertexArray,co.members,this.expression.isStateDependent))},Ro.prototype.destroy=function(){this.zoomOutPaintVertexBuffer&&this.zoomOutPaintVertexBuffer.destroy(),this.zoomInPaintVertexBuffer&&this.zoomInPaintVertexBuffer.destroy()};var ko=function(t,e,n){this.binders={},this._buffers=[];var r=[];for(var i in t.paint._values)if(n(i)){var o=t.paint.get(i);if(o instanceof di&&kn(o.property.specification)){var a=Lo(i,t.type),s=o.value,u=o.property.specification.type,c=o.property.useIntegerZoom,l=o.property.specification["property-type"],h="cross-faded"===l||"cross-faded-data-driven"===l;if("constant"===s.kind)this.binders[i]=h?new Mo(s.value,a):new Po(s.value,a,u),r.push("/u_"+i);else if("source"===s.kind||h){var f=jo(i,u,"source");this.binders[i]=h?new Ro(s,u,c,e,f,t.id):new Io(s,a,u,f),r.push("/a_"+i)}else{var p=jo(i,u,"composite");this.binders[i]=new Bo(s,a,u,c,e,p),r.push("/z_"+i)}}}this.cacheKey=r.sort().join("")};ko.prototype.getMaxValue=function(t){var e=this.binders[t];return e instanceof Io||e instanceof Bo?e.maxValue:0},ko.prototype.populatePaintArrays=function(t,e,n,r,i){for(var o in this.binders){var a=this.binders[o];(a instanceof Io||a instanceof Bo||a instanceof Ro)&&a.populatePaintArray(t,e,n,r,i)}},ko.prototype.setConstantPatternPositions=function(t,e){for(var n in this.binders){var r=this.binders[n];r instanceof Mo&&r.setConstantPatternPositions(t,e)}},ko.prototype.updatePaintArrays=function(t,e,n,r,i){var o=!1;for(var a in t)for(var s=0,u=e.getPositions(a);s<u.length;s+=1){var c=u[s],l=n.feature(c.index);for(var h in this.binders){var f=this.binders[h];if((f instanceof Io||f instanceof Bo||f instanceof Ro)&&!0===f.expression.isStateDependent){var p=r.paint.get(h);f.expression=p.value,f.updatePaintArray(c.start,c.end,l,t[a],i),o=!0}}}return o},ko.prototype.defines=function(){var t=[];for(var e in this.binders){var n=this.binders[e];(n instanceof Po||n instanceof Mo)&&t.push.apply(t,n.uniformNames.map((function(t){return"#define HAS_UNIFORM_"+t})))}return t},ko.prototype.getBinderAttributes=function(){var t=[];for(var e in this.binders){var n=this.binders[e];if(n instanceof Io||n instanceof Bo)for(var r=0;r<n.paintVertexAttributes.length;r++)t.push(n.paintVertexAttributes[r].name);else if(n instanceof Ro)for(var i=0;i<co.members.length;i++)t.push(co.members[i].name)}return t},ko.prototype.getBinderUniforms=function(){var t=[];for(var e in this.binders){var n=this.binders[e];if(n instanceof Po||n instanceof Mo||n instanceof Bo)for(var r=0,i=n.uniformNames;r<i.length;r+=1)t.push(i[r])}return t},ko.prototype.getPaintVertexBuffers=function(){return this._buffers},ko.prototype.getUniforms=function(t,e){var n=[];for(var r in this.binders){var i=this.binders[r];if(i instanceof Po||i instanceof Mo||i instanceof Bo)for(var o=0,a=i.uniformNames;o<a.length;o+=1){var s=a[o];if(e[s]){var u=i.getBinding(t,e[s],s);n.push({name:s,property:r,binding:u})}}}return n},ko.prototype.setUniforms=function(t,e,n,r){for(var i=0,o=e;i<o.length;i+=1){var a=o[i],s=a.name,u=a.property;this.binders[u].setUniform(a.binding,r,n.get(u),s)}},ko.prototype.updatePaintBuffers=function(t){for(var e in this._buffers=[],this.binders){var n=this.binders[e];if(t&&n instanceof Ro){var r=2===t.fromScale?n.zoomInPaintVertexBuffer:n.zoomOutPaintVertexBuffer;r&&this._buffers.push(r)}else(n instanceof Io||n instanceof Bo)&&n.paintVertexBuffer&&this._buffers.push(n.paintVertexBuffer)}},ko.prototype.upload=function(t){for(var e in this.binders){var n=this.binders[e];(n instanceof Io||n instanceof Bo||n instanceof Ro)&&n.upload(t)}this.updatePaintBuffers()},ko.prototype.destroy=function(){for(var t in this.binders){var e=this.binders[t];(e instanceof Io||e instanceof Bo||e instanceof Ro)&&e.destroy()}};var Do=function(t,e,n){void 0===n&&(n=function(){return!0}),this.programConfigurations={};for(var r=0,i=t;r<i.length;r+=1){var o=i[r];this.programConfigurations[o.id]=new ko(o,e,n)}this.needsUpload=!1,this._featureMap=new Ao,this._bufferOffset=0};function Lo(t,e){return{"text-opacity":["opacity"],"icon-opacity":["opacity"],"text-color":["fill_color"],"icon-color":["fill_color"],"text-halo-color":["halo_color"],"icon-halo-color":["halo_color"],"text-halo-blur":["halo_blur"],"icon-halo-blur":["halo_blur"],"text-halo-width":["halo_width"],"icon-halo-width":["halo_width"],"line-gap-width":["gapwidth"],"line-pattern":["pattern_to","pattern_from","pixel_ratio_to","pixel_ratio_from"],"fill-pattern":["pattern_to","pattern_from","pixel_ratio_to","pixel_ratio_from"],"fill-extrusion-pattern":["pattern_to","pattern_from","pixel_ratio_to","pixel_ratio_from"]}[t]||[t.replace(e+"-","").replace(/-/g,"_")]}function jo(t,e,n){var r={color:{source:Bi,composite:Ji},number:{source:Hi,composite:Bi}},i=function(t){return{"line-pattern":{source:Ri,composite:Ri},"fill-pattern":{source:Ri,composite:Ri},"fill-extrusion-pattern":{source:Ri,composite:Ri}}[t]}(t);return i&&i[n]||r[e][n]}Do.prototype.populatePaintArrays=function(t,e,n,r,i,o){for(var a in this.programConfigurations)this.programConfigurations[a].populatePaintArrays(t,e,r,i,o);void 0!==e.id&&this._featureMap.add(e.id,n,this._bufferOffset,t),this._bufferOffset=t,this.needsUpload=!0},Do.prototype.updatePaintArrays=function(t,e,n,r){for(var i=0,o=n;i<o.length;i+=1){var a=o[i];this.needsUpload=this.programConfigurations[a.id].updatePaintArrays(t,this._featureMap,e,a,r)||this.needsUpload}},Do.prototype.get=function(t){return this.programConfigurations[t]},Do.prototype.upload=function(t){if(this.needsUpload){for(var e in this.programConfigurations)this.programConfigurations[e].upload(t);this.needsUpload=!1}},Do.prototype.destroy=function(){for(var t in this.programConfigurations)this.programConfigurations[t].destroy()},Fr("ConstantBinder",Po),Fr("CrossFadedConstantBinder",Mo),Fr("SourceExpressionBinder",Io),Fr("CrossFadedCompositeBinder",Ro),Fr("CompositeExpressionBinder",Bo),Fr("ProgramConfiguration",ko,{omit:["_buffers"]}),Fr("ProgramConfigurationSet",Do);var Fo=Math.pow(2,14)-1,zo=-Fo-1;function Uo(t){for(var e=8192/t.extent,n=t.loadGeometry(),r=0;r<n.length;r++)for(var i=n[r],o=0;o<i.length;o++){var a=i[o],s=Math.round(a.x*e),u=Math.round(a.y*e);a.x=l(s,zo,Fo),a.y=l(u,zo,Fo),(s<a.x||s>a.x+1||u<a.y||u>a.y+1)&&w("Geometry exceeds allowed extent, reduce your vector tile buffer size")}return n}function No(t,e){return{type:t.type,id:t.id,properties:t.properties,geometry:e?Uo(t):[]}}function Go(t,e,n,r,i){t.emplaceBack(2*e+(r+1)/2,2*n+(i+1)/2)}var Vo=function(t){this.zoom=t.zoom,this.overscaling=t.overscaling,this.layers=t.layers,this.layerIds=this.layers.map((function(t){return t.id})),this.index=t.index,this.hasPattern=!1,this.layoutVertexArray=new Ci,this.indexArray=new Ni,this.segments=new so,this.programConfigurations=new Do(t.layers,t.zoom),this.stateDependentLayerIds=this.layers.filter((function(t){return t.isStateDependent()})).map((function(t){return t.id}))};function Ho(t,e){for(var n=0;n<t.length;n++)if($o(e,t[n]))return!0;for(var r=0;r<e.length;r++)if($o(t,e[r]))return!0;return!!Zo(t,e)}function Wo(t,e,n){return!!$o(t,e)||!!Qo(e,t,n)}function qo(t,e){if(1===t.length)return Yo(e,t[0]);for(var n=0;n<e.length;n++)for(var r=e[n],i=0;i<r.length;i++)if($o(t,r[i]))return!0;for(var o=0;o<t.length;o++)if(Yo(e,t[o]))return!0;for(var a=0;a<e.length;a++)if(Zo(t,e[a]))return!0;return!1}function Xo(t,e,n){if(t.length>1){if(Zo(t,e))return!0;for(var r=0;r<e.length;r++)if(Qo(e[r],t,n))return!0}for(var i=0;i<t.length;i++)if(Qo(t[i],e,n))return!0;return!1}function Zo(t,e){if(0===t.length||0===e.length)return!1;for(var n=0;n<t.length-1;n++)for(var r=t[n],i=t[n+1],o=0;o<e.length-1;o++)if(Jo(r,i,e[o],e[o+1]))return!0;return!1}function Jo(t,e,n,r){return E(t,n,r)!==E(e,n,r)&&E(t,e,n)!==E(t,e,r)}function Qo(t,e,n){var r=n*n;if(1===e.length)return t.distSqr(e[0])<r;for(var i=1;i<e.length;i++)if(Ko(t,e[i-1],e[i])<r)return!0;return!1}function Ko(t,e,n){var r=e.distSqr(n);if(0===r)return t.distSqr(e);var i=((t.x-e.x)*(n.x-e.x)+(t.y-e.y)*(n.y-e.y))/r;return t.distSqr(i<0?e:i>1?n:n.sub(e)._mult(i)._add(e))}function Yo(t,e){for(var n,r,i,o=!1,a=0;a<t.length;a++)for(var s=0,u=(n=t[a]).length-1;s<n.length;u=s++)(r=n[s]).y>e.y!=(i=n[u]).y>e.y&&e.x<(i.x-r.x)*(e.y-r.y)/(i.y-r.y)+r.x&&(o=!o);return o}function $o(t,e){for(var n=!1,r=0,i=t.length-1;r<t.length;i=r++){var o=t[r],a=t[i];o.y>e.y!=a.y>e.y&&e.x<(a.x-o.x)*(e.y-o.y)/(a.y-o.y)+o.x&&(n=!n)}return n}function ta(t,e,n){var r=n[0],i=n[2];if(t.x<r.x&&e.x<r.x||t.x>i.x&&e.x>i.x||t.y<r.y&&e.y<r.y||t.y>i.y&&e.y>i.y)return!1;var o=E(t,e,n[0]);return o!==E(t,e,n[1])||o!==E(t,e,n[2])||o!==E(t,e,n[3])}function ea(t,e,n){var r=e.paint.get(t).value;return"constant"===r.kind?r.value:n.programConfigurations.get(e.id).getMaxValue(t)}function na(t){return Math.sqrt(t[0]*t[0]+t[1]*t[1])}function ra(t,e,n,r,o){if(!e[0]&&!e[1])return t;var a=i.convert(e)._mult(o);"viewport"===n&&a._rotate(-r);for(var s=[],u=0;u<t.length;u++)s.push(t[u].sub(a));return s}Vo.prototype.populate=function(t,e,n){var r=this.layers[0],i=[],o=null;"circle"===r.type&&(o=r.layout.get("circle-sort-key"));for(var a=0,s=t;a<s.length;a+=1){var u=s[a],c=u.feature,l=u.id,h=u.index,f=u.sourceLayerIndex,p=this.layers[0]._featureFilter.needGeometry,d=No(c,p);if(this.layers[0]._featureFilter.filter(new si(this.zoom),d,n)){var A=o?o.evaluate(d,{},n):void 0,g={id:l,properties:c.properties,type:c.type,sourceLayerIndex:f,index:h,geometry:p?d.geometry:Uo(c),patterns:{},sortKey:A};i.push(g)}}o&&i.sort((function(t,e){return t.sortKey-e.sortKey}));for(var m=0,y=i;m<y.length;m+=1){var v=y[m],_=v.geometry,b=v.index,x=v.sourceLayerIndex,w=t[b].feature;this.addFeature(v,_,b,n),e.featureIndex.insert(w,_,b,x,this.index)}},Vo.prototype.update=function(t,e,n){this.stateDependentLayers.length&&this.programConfigurations.updatePaintArrays(t,e,this.stateDependentLayers,n)},Vo.prototype.isEmpty=function(){return 0===this.layoutVertexArray.length},Vo.prototype.uploadPending=function(){return!this.uploaded||this.programConfigurations.needsUpload},Vo.prototype.upload=function(t){this.uploaded||(this.layoutVertexBuffer=t.createVertexBuffer(this.layoutVertexArray,ao),this.indexBuffer=t.createIndexBuffer(this.indexArray)),this.programConfigurations.upload(t),this.uploaded=!0},Vo.prototype.destroy=function(){this.layoutVertexBuffer&&(this.layoutVertexBuffer.destroy(),this.indexBuffer.destroy(),this.programConfigurations.destroy(),this.segments.destroy())},Vo.prototype.addFeature=function(t,e,n,r){for(var i=0,o=e;i<o.length;i+=1)for(var a=0,s=o[i];a<s.length;a+=1){var u=s[a],c=u.x,l=u.y;if(!(c<0||c>=8192||l<0||l>=8192)){var h=this.segments.prepareSegment(4,this.layoutVertexArray,this.indexArray,t.sortKey),f=h.vertexLength;Go(this.layoutVertexArray,c,l,-1,-1),Go(this.layoutVertexArray,c,l,1,-1),Go(this.layoutVertexArray,c,l,1,1),Go(this.layoutVertexArray,c,l,-1,1),this.indexArray.emplaceBack(f,f+1,f+2),this.indexArray.emplaceBack(f,f+3,f+2),h.vertexLength+=4,h.primitiveLength+=2}}this.programConfigurations.populatePaintArrays(this.layoutVertexArray.length,t,n,{},r)},Fr("CircleBucket",Vo,{omit:["layers"]});var ia=new bi({"circle-sort-key":new mi(Pt.layout_circle["circle-sort-key"])}),oa={paint:new bi({"circle-radius":new mi(Pt.paint_circle["circle-radius"]),"circle-color":new mi(Pt.paint_circle["circle-color"]),"circle-blur":new mi(Pt.paint_circle["circle-blur"]),"circle-opacity":new mi(Pt.paint_circle["circle-opacity"]),"circle-translate":new gi(Pt.paint_circle["circle-translate"]),"circle-translate-anchor":new gi(Pt.paint_circle["circle-translate-anchor"]),"circle-pitch-scale":new gi(Pt.paint_circle["circle-pitch-scale"]),"circle-pitch-alignment":new gi(Pt.paint_circle["circle-pitch-alignment"]),"circle-stroke-width":new mi(Pt.paint_circle["circle-stroke-width"]),"circle-stroke-color":new mi(Pt.paint_circle["circle-stroke-color"]),"circle-stroke-opacity":new mi(Pt.paint_circle["circle-stroke-opacity"])}),layout:ia},aa="undefined"!=typeof Float32Array?Float32Array:Array;function sa(t){return t[0]=1,t[1]=0,t[2]=0,t[3]=0,t[4]=0,t[5]=1,t[6]=0,t[7]=0,t[8]=0,t[9]=0,t[10]=1,t[11]=0,t[12]=0,t[13]=0,t[14]=0,t[15]=1,t}function ua(t,e,n){var r=e[0],i=e[1],o=e[2],a=e[3],s=e[4],u=e[5],c=e[6],l=e[7],h=e[8],f=e[9],p=e[10],d=e[11],A=e[12],g=e[13],m=e[14],y=e[15],v=n[0],_=n[1],b=n[2],x=n[3];return t[0]=v*r+_*s+b*h+x*A,t[1]=v*i+_*u+b*f+x*g,t[2]=v*o+_*c+b*p+x*m,t[3]=v*a+_*l+b*d+x*y,t[4]=(v=n[4])*r+(_=n[5])*s+(b=n[6])*h+(x=n[7])*A,t[5]=v*i+_*u+b*f+x*g,t[6]=v*o+_*c+b*p+x*m,t[7]=v*a+_*l+b*d+x*y,t[8]=(v=n[8])*r+(_=n[9])*s+(b=n[10])*h+(x=n[11])*A,t[9]=v*i+_*u+b*f+x*g,t[10]=v*o+_*c+b*p+x*m,t[11]=v*a+_*l+b*d+x*y,t[12]=(v=n[12])*r+(_=n[13])*s+(b=n[14])*h+(x=n[15])*A,t[13]=v*i+_*u+b*f+x*g,t[14]=v*o+_*c+b*p+x*m,t[15]=v*a+_*l+b*d+x*y,t}Math.hypot||(Math.hypot=function(){for(var t=arguments,e=0,n=arguments.length;n--;)e+=t[n]*t[n];return Math.sqrt(e)});var ca,la=ua;function ha(t,e,n){var r=e[0],i=e[1],o=e[2],a=e[3];return t[0]=n[0]*r+n[4]*i+n[8]*o+n[12]*a,t[1]=n[1]*r+n[5]*i+n[9]*o+n[13]*a,t[2]=n[2]*r+n[6]*i+n[10]*o+n[14]*a,t[3]=n[3]*r+n[7]*i+n[11]*o+n[15]*a,t}ca=new aa(3),aa!=Float32Array&&(ca[0]=0,ca[1]=0,ca[2]=0),function(){var t=new aa(4);aa!=Float32Array&&(t[0]=0,t[1]=0,t[2]=0,t[3]=0)}();var fa=(function(){var t=new aa(2);aa!=Float32Array&&(t[0]=0,t[1]=0)}(),function(t){function e(e){t.call(this,e,oa)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.createBucket=function(t){return new Vo(t)},e.prototype.queryRadius=function(t){var e=t;return ea("circle-radius",this,e)+ea("circle-stroke-width",this,e)+na(this.paint.get("circle-translate"))},e.prototype.queryIntersectsFeature=function(t,e,n,r,i,o,a,s){for(var u=ra(t,this.paint.get("circle-translate"),this.paint.get("circle-translate-anchor"),o.angle,a),c=this.paint.get("circle-radius").evaluate(e,n)+this.paint.get("circle-stroke-width").evaluate(e,n),l="map"===this.paint.get("circle-pitch-alignment"),h=l?u:function(t,e){return t.map((function(t){return pa(t,e)}))}(u,s),f=l?c*a:c,p=0,d=r;p<d.length;p+=1)for(var A=0,g=d[p];A<g.length;A+=1){var m=g[A],y=l?m:pa(m,s),v=f,_=ha([],[m.x,m.y,0,1],s);if("viewport"===this.paint.get("circle-pitch-scale")&&"map"===this.paint.get("circle-pitch-alignment")?v*=_[3]/o.cameraToCenterDistance:"map"===this.paint.get("circle-pitch-scale")&&"viewport"===this.paint.get("circle-pitch-alignment")&&(v*=o.cameraToCenterDistance/_[3]),Wo(h,y,v))return!0}return!1},e}(xi));function pa(t,e){var n=ha([],[t.x,t.y,0,1],e);return new i(n[0]/n[3],n[1]/n[3])}var da=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e}(Vo);function Aa(t,e,n,r){var i=e.width,o=e.height;if(r){if(r instanceof Uint8ClampedArray)r=new Uint8Array(r.buffer);else if(r.length!==i*o*n)throw new RangeError("mismatched image size")}else r=new Uint8Array(i*o*n);return t.width=i,t.height=o,t.data=r,t}function ga(t,e,n){var r=e.width,i=e.height;if(r!==t.width||i!==t.height){var o=Aa({},{width:r,height:i},n);ma(t,o,{x:0,y:0},{x:0,y:0},{width:Math.min(t.width,r),height:Math.min(t.height,i)},n),t.width=r,t.height=i,t.data=o.data}}function ma(t,e,n,r,i,o){if(0===i.width||0===i.height)return e;if(i.width>t.width||i.height>t.height||n.x>t.width-i.width||n.y>t.height-i.height)throw new RangeError("out of range source coordinates for image copy");if(i.width>e.width||i.height>e.height||r.x>e.width-i.width||r.y>e.height-i.height)throw new RangeError("out of range destination coordinates for image copy");for(var a=t.data,s=e.data,u=0;u<i.height;u++)for(var c=((n.y+u)*t.width+n.x)*o,l=((r.y+u)*e.width+r.x)*o,h=0;h<i.width*o;h++)s[l+h]=a[c+h];return e}Fr("HeatmapBucket",da,{omit:["layers"]});var ya=function(t,e){Aa(this,t,1,e)};ya.prototype.resize=function(t){ga(this,t,1)},ya.prototype.clone=function(){return new ya({width:this.width,height:this.height},new Uint8Array(this.data))},ya.copy=function(t,e,n,r,i){ma(t,e,n,r,i,1)};var va=function(t,e){Aa(this,t,4,e)};va.prototype.resize=function(t){ga(this,t,4)},va.prototype.replace=function(t,e){e?this.data.set(t):this.data=t instanceof Uint8ClampedArray?new Uint8Array(t.buffer):t},va.prototype.clone=function(){return new va({width:this.width,height:this.height},new Uint8Array(this.data))},va.copy=function(t,e,n,r,i){ma(t,e,n,r,i,4)},Fr("AlphaImage",ya),Fr("RGBAImage",va);var _a={paint:new bi({"heatmap-radius":new mi(Pt.paint_heatmap["heatmap-radius"]),"heatmap-weight":new mi(Pt.paint_heatmap["heatmap-weight"]),"heatmap-intensity":new gi(Pt.paint_heatmap["heatmap-intensity"]),"heatmap-color":new _i(Pt.paint_heatmap["heatmap-color"]),"heatmap-opacity":new gi(Pt.paint_heatmap["heatmap-opacity"])})};function ba(t){var e={},n=t.resolution||256,r=t.clips?t.clips.length:1,i=t.image||new va({width:n,height:r}),o=function(n,r,o){e[t.evaluationKey]=o;var a=t.expression.evaluate(e);i.data[n+r+0]=Math.floor(255*a.r/a.a),i.data[n+r+1]=Math.floor(255*a.g/a.a),i.data[n+r+2]=Math.floor(255*a.b/a.a),i.data[n+r+3]=Math.floor(255*a.a)};if(t.clips)for(var a=0,s=0;a<r;++a,s+=4*n)for(var u=0,c=0;u<n;u++,c+=4){var l=u/(n-1),h=t.clips[a];o(s,c,h.start*(1-l)+h.end*l)}else for(var f=0,p=0;f<n;f++,p+=4)o(0,p,f/(n-1));return i}var xa=function(t){function e(e){t.call(this,e,_a),this._updateColorRamp()}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.createBucket=function(t){return new da(t)},e.prototype._handleSpecialPaintPropertyUpdate=function(t){"heatmap-color"===t&&this._updateColorRamp()},e.prototype._updateColorRamp=function(){this.colorRamp=ba({expression:this._transitionablePaint._values["heatmap-color"].value.expression,evaluationKey:"heatmapDensity",image:this.colorRamp}),this.colorRampTexture=null},e.prototype.resize=function(){this.heatmapFbo&&(this.heatmapFbo.destroy(),this.heatmapFbo=null)},e.prototype.queryRadius=function(){return 0},e.prototype.queryIntersectsFeature=function(){return!1},e.prototype.hasOffscreenPass=function(){return 0!==this.paint.get("heatmap-opacity")&&"none"!==this.visibility},e}(xi),wa={paint:new bi({"hillshade-illumination-direction":new gi(Pt.paint_hillshade["hillshade-illumination-direction"]),"hillshade-illumination-anchor":new gi(Pt.paint_hillshade["hillshade-illumination-anchor"]),"hillshade-exaggeration":new gi(Pt.paint_hillshade["hillshade-exaggeration"]),"hillshade-shadow-color":new gi(Pt.paint_hillshade["hillshade-shadow-color"]),"hillshade-highlight-color":new gi(Pt.paint_hillshade["hillshade-highlight-color"]),"hillshade-accent-color":new gi(Pt.paint_hillshade["hillshade-accent-color"])})},Ea=function(t){function e(e){t.call(this,e,wa)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.hasOffscreenPass=function(){return 0!==this.paint.get("hillshade-exaggeration")&&"none"!==this.visibility},e}(xi),Oa=Si([{name:"a_pos",components:2,type:"Int16"}],4).members,Sa=Ca,Ta=Ca;function Ca(t,e,n){n=n||2;var r,i,o,a,s,u,c,l=e&&e.length,h=l?e[0]*n:t.length,f=Pa(t,0,h,n,!0),p=[];if(!f||f.next===f.prev)return p;if(l&&(f=function(t,e,n,r){var i,o,a,s=[];for(i=0,o=e.length;i<o;i++)(a=Pa(t,e[i]*r,i<o-1?e[i+1]*r:t.length,r,!1))===a.next&&(a.steiner=!0),s.push(Ua(a));for(s.sort(La),i=0;i<s.length;i++)ja(s[i],n),n=Ma(n,n.next);return n}(t,e,f,n)),t.length>80*n){r=o=t[0],i=a=t[1];for(var d=n;d<h;d+=n)(s=t[d])<r&&(r=s),(u=t[d+1])<i&&(i=u),s>o&&(o=s),u>a&&(a=u);c=0!==(c=Math.max(o-r,a-i))?1/c:0}return Ia(f,p,n,r,i,c),p}function Pa(t,e,n,r,i){var o,a;if(i===$a(t,e,n,r)>0)for(o=e;o<n;o+=r)a=Qa(o,t[o],t[o+1],a);else for(o=n-r;o>=e;o-=r)a=Qa(o,t[o],t[o+1],a);return a&&Ha(a,a.next)&&(Ka(a),a=a.next),a}function Ma(t,e){if(!t)return t;e||(e=t);var n,r=t;do{if(n=!1,r.steiner||!Ha(r,r.next)&&0!==Va(r.prev,r,r.next))r=r.next;else{if(Ka(r),(r=e=r.prev)===r.next)break;n=!0}}while(n||r!==e);return e}function Ia(t,e,n,r,i,o,a){if(t){!a&&o&&function(t,e,n,r){var i=t;do{null===i.z&&(i.z=za(i.x,i.y,e,n,r)),i.prevZ=i.prev,i.nextZ=i.next,i=i.next}while(i!==t);i.prevZ.nextZ=null,i.prevZ=null,function(t){var e,n,r,i,o,a,s,u,c=1;do{for(n=t,t=null,o=null,a=0;n;){for(a++,r=n,s=0,e=0;e<c&&(s++,r=r.nextZ);e++);for(u=c;s>0||u>0&&r;)0!==s&&(0===u||!r||n.z<=r.z)?(i=n,n=n.nextZ,s--):(i=r,r=r.nextZ,u--),o?o.nextZ=i:t=i,i.prevZ=o,o=i;n=r}o.nextZ=null,c*=2}while(a>1)}(i)}(t,r,i,o);for(var s,u,c=t;t.prev!==t.next;)if(s=t.prev,u=t.next,o?Ra(t,r,i,o):Ba(t))e.push(s.i/n),e.push(t.i/n),e.push(u.i/n),Ka(t),t=u.next,c=u.next;else if((t=u)===c){a?1===a?Ia(t=ka(Ma(t),e,n),e,n,r,i,o,2):2===a&&Da(t,e,n,r,i,o):Ia(Ma(t),e,n,r,i,o,1);break}}}function Ba(t){var e=t.prev,n=t,r=t.next;if(Va(e,n,r)>=0)return!1;for(var i=t.next.next;i!==t.prev;){if(Na(e.x,e.y,n.x,n.y,r.x,r.y,i.x,i.y)&&Va(i.prev,i,i.next)>=0)return!1;i=i.next}return!0}function Ra(t,e,n,r){var i=t.prev,o=t,a=t.next;if(Va(i,o,a)>=0)return!1;for(var s=i.x>o.x?i.x>a.x?i.x:a.x:o.x>a.x?o.x:a.x,u=i.y>o.y?i.y>a.y?i.y:a.y:o.y>a.y?o.y:a.y,c=za(i.x<o.x?i.x<a.x?i.x:a.x:o.x<a.x?o.x:a.x,i.y<o.y?i.y<a.y?i.y:a.y:o.y<a.y?o.y:a.y,e,n,r),l=za(s,u,e,n,r),h=t.prevZ,f=t.nextZ;h&&h.z>=c&&f&&f.z<=l;){if(h!==t.prev&&h!==t.next&&Na(i.x,i.y,o.x,o.y,a.x,a.y,h.x,h.y)&&Va(h.prev,h,h.next)>=0)return!1;if(h=h.prevZ,f!==t.prev&&f!==t.next&&Na(i.x,i.y,o.x,o.y,a.x,a.y,f.x,f.y)&&Va(f.prev,f,f.next)>=0)return!1;f=f.nextZ}for(;h&&h.z>=c;){if(h!==t.prev&&h!==t.next&&Na(i.x,i.y,o.x,o.y,a.x,a.y,h.x,h.y)&&Va(h.prev,h,h.next)>=0)return!1;h=h.prevZ}for(;f&&f.z<=l;){if(f!==t.prev&&f!==t.next&&Na(i.x,i.y,o.x,o.y,a.x,a.y,f.x,f.y)&&Va(f.prev,f,f.next)>=0)return!1;f=f.nextZ}return!0}function ka(t,e,n){var r=t;do{var i=r.prev,o=r.next.next;!Ha(i,o)&&Wa(i,r,r.next,o)&&Za(i,o)&&Za(o,i)&&(e.push(i.i/n),e.push(r.i/n),e.push(o.i/n),Ka(r),Ka(r.next),r=t=o),r=r.next}while(r!==t);return Ma(r)}function Da(t,e,n,r,i,o){var a=t;do{for(var s=a.next.next;s!==a.prev;){if(a.i!==s.i&&Ga(a,s)){var u=Ja(a,s);return a=Ma(a,a.next),u=Ma(u,u.next),Ia(a,e,n,r,i,o),void Ia(u,e,n,r,i,o)}s=s.next}a=a.next}while(a!==t)}function La(t,e){return t.x-e.x}function ja(t,e){if(e=function(t,e){var n,r=e,i=t.x,o=t.y,a=-1/0;do{if(o<=r.y&&o>=r.next.y&&r.next.y!==r.y){var s=r.x+(o-r.y)*(r.next.x-r.x)/(r.next.y-r.y);if(s<=i&&s>a){if(a=s,s===i){if(o===r.y)return r;if(o===r.next.y)return r.next}n=r.x<r.next.x?r:r.next}}r=r.next}while(r!==e);if(!n)return null;if(i===a)return n;var u,c=n,l=n.x,h=n.y,f=1/0;r=n;do{i>=r.x&&r.x>=l&&i!==r.x&&Na(o<h?i:a,o,l,h,o<h?a:i,o,r.x,r.y)&&(u=Math.abs(o-r.y)/(i-r.x),Za(r,t)&&(u<f||u===f&&(r.x>n.x||r.x===n.x&&Fa(n,r)))&&(n=r,f=u)),r=r.next}while(r!==c);return n}(t,e)){var n=Ja(e,t);Ma(e,e.next),Ma(n,n.next)}}function Fa(t,e){return Va(t.prev,t,e.prev)<0&&Va(e.next,t,t.next)<0}function za(t,e,n,r,i){return(t=1431655765&((t=858993459&((t=252645135&((t=16711935&((t=32767*(t-n)*i)|t<<8))|t<<4))|t<<2))|t<<1))|(e=1431655765&((e=858993459&((e=252645135&((e=16711935&((e=32767*(e-r)*i)|e<<8))|e<<4))|e<<2))|e<<1))<<1}function Ua(t){var e=t,n=t;do{(e.x<n.x||e.x===n.x&&e.y<n.y)&&(n=e),e=e.next}while(e!==t);return n}function Na(t,e,n,r,i,o,a,s){return(i-a)*(e-s)-(t-a)*(o-s)>=0&&(t-a)*(r-s)-(n-a)*(e-s)>=0&&(n-a)*(o-s)-(i-a)*(r-s)>=0}function Ga(t,e){return t.next.i!==e.i&&t.prev.i!==e.i&&!function(t,e){var n=t;do{if(n.i!==t.i&&n.next.i!==t.i&&n.i!==e.i&&n.next.i!==e.i&&Wa(n,n.next,t,e))return!0;n=n.next}while(n!==t);return!1}(t,e)&&(Za(t,e)&&Za(e,t)&&function(t,e){var n=t,r=!1,i=(t.x+e.x)/2,o=(t.y+e.y)/2;do{n.y>o!=n.next.y>o&&n.next.y!==n.y&&i<(n.next.x-n.x)*(o-n.y)/(n.next.y-n.y)+n.x&&(r=!r),n=n.next}while(n!==t);return r}(t,e)&&(Va(t.prev,t,e.prev)||Va(t,e.prev,e))||Ha(t,e)&&Va(t.prev,t,t.next)>0&&Va(e.prev,e,e.next)>0)}function Va(t,e,n){return(e.y-t.y)*(n.x-e.x)-(e.x-t.x)*(n.y-e.y)}function Ha(t,e){return t.x===e.x&&t.y===e.y}function Wa(t,e,n,r){var i=Xa(Va(t,e,n)),o=Xa(Va(t,e,r)),a=Xa(Va(n,r,t)),s=Xa(Va(n,r,e));return i!==o&&a!==s||!(0!==i||!qa(t,n,e))||!(0!==o||!qa(t,r,e))||!(0!==a||!qa(n,t,r))||!(0!==s||!qa(n,e,r))}function qa(t,e,n){return e.x<=Math.max(t.x,n.x)&&e.x>=Math.min(t.x,n.x)&&e.y<=Math.max(t.y,n.y)&&e.y>=Math.min(t.y,n.y)}function Xa(t){return t>0?1:t<0?-1:0}function Za(t,e){return Va(t.prev,t,t.next)<0?Va(t,e,t.next)>=0&&Va(t,t.prev,e)>=0:Va(t,e,t.prev)<0||Va(t,t.next,e)<0}function Ja(t,e){var n=new Ya(t.i,t.x,t.y),r=new Ya(e.i,e.x,e.y),i=t.next,o=e.prev;return t.next=e,e.prev=t,n.next=i,i.prev=n,r.next=n,n.prev=r,o.next=r,r.prev=o,r}function Qa(t,e,n,r){var i=new Ya(t,e,n);return r?(i.next=r.next,i.prev=r,r.next.prev=i,r.next=i):(i.prev=i,i.next=i),i}function Ka(t){t.next.prev=t.prev,t.prev.next=t.next,t.prevZ&&(t.prevZ.nextZ=t.nextZ),t.nextZ&&(t.nextZ.prevZ=t.prevZ)}function Ya(t,e,n){this.i=t,this.x=e,this.y=n,this.prev=null,this.next=null,this.z=null,this.prevZ=null,this.nextZ=null,this.steiner=!1}function $a(t,e,n,r){for(var i=0,o=e,a=n-r;o<n;o+=r)i+=(t[a]-t[o])*(t[o+1]+t[a+1]),a=o;return i}function ts(t,e,n,r,i){!function t(e,n,r,i,o){for(;i>r;){if(i-r>600){var a=i-r+1,s=n-r+1,u=Math.log(a),c=.5*Math.exp(2*u/3),l=.5*Math.sqrt(u*c*(a-c)/a)*(s-a/2<0?-1:1);t(e,n,Math.max(r,Math.floor(n-s*c/a+l)),Math.min(i,Math.floor(n+(a-s)*c/a+l)),o)}var h=e[n],f=r,p=i;for(es(e,r,n),o(e[i],h)>0&&es(e,r,i);f<p;){for(es(e,f,p),f++,p--;o(e[f],h)<0;)f++;for(;o(e[p],h)>0;)p--}0===o(e[r],h)?es(e,r,p):es(e,++p,i),p<=n&&(r=p+1),n<=p&&(i=p-1)}}(t,e,n||0,r||t.length-1,i||ns)}function es(t,e,n){var r=t[e];t[e]=t[n],t[n]=r}function ns(t,e){return t<e?-1:t>e?1:0}function rs(t,e){var n=t.length;if(n<=1)return[t];for(var r,i,o=[],a=0;a<n;a++){var s=O(t[a]);0!==s&&(t[a].area=Math.abs(s),void 0===i&&(i=s<0),i===s<0?(r&&o.push(r),r=[t[a]]):r.push(t[a]))}if(r&&o.push(r),e>1)for(var u=0;u<o.length;u++)o[u].length<=e||(ts(o[u],e,1,o[u].length-1,is),o[u]=o[u].slice(0,e));return o}function is(t,e){return e.area-t.area}function os(t,e,n){for(var r=n.patternDependencies,i=!1,o=0,a=e;o<a.length;o+=1){var s=a[o].paint.get(t+"-pattern");s.isConstant()||(i=!0);var u=s.constantOr(null);u&&(i=!0,r[u.to]=!0,r[u.from]=!0)}return i}function as(t,e,n,r,i){for(var o=i.patternDependencies,a=0,s=e;a<s.length;a+=1){var u=s[a],c=u.paint.get(t+"-pattern").value;if("constant"!==c.kind){var l=c.evaluate({zoom:r-1},n,{},i.availableImages),h=c.evaluate({zoom:r},n,{},i.availableImages),f=c.evaluate({zoom:r+1},n,{},i.availableImages);h=h&&h.name?h.name:h,f=f&&f.name?f.name:f,o[l=l&&l.name?l.name:l]=!0,o[h]=!0,o[f]=!0,n.patterns[u.id]={min:l,mid:h,max:f}}}return n}Ca.deviation=function(t,e,n,r){var i=e&&e.length,o=Math.abs($a(t,0,i?e[0]*n:t.length,n));if(i)for(var a=0,s=e.length;a<s;a++)o-=Math.abs($a(t,e[a]*n,a<s-1?e[a+1]*n:t.length,n));var u=0;for(a=0;a<r.length;a+=3){var c=r[a]*n,l=r[a+1]*n,h=r[a+2]*n;u+=Math.abs((t[c]-t[h])*(t[l+1]-t[c+1])-(t[c]-t[l])*(t[h+1]-t[c+1]))}return 0===o&&0===u?0:Math.abs((u-o)/o)},Ca.flatten=function(t){for(var e=t[0][0].length,n={vertices:[],holes:[],dimensions:e},r=0,i=0;i<t.length;i++){for(var o=0;o<t[i].length;o++)for(var a=0;a<e;a++)n.vertices.push(t[i][o][a]);i>0&&n.holes.push(r+=t[i-1].length)}return n},Sa.default=Ta;var ss=function(t){this.zoom=t.zoom,this.overscaling=t.overscaling,this.layers=t.layers,this.layerIds=this.layers.map((function(t){return t.id})),this.index=t.index,this.hasPattern=!1,this.patternFeatures=[],this.layoutVertexArray=new Ci,this.indexArray=new Ni,this.indexArray2=new Xi,this.programConfigurations=new Do(t.layers,t.zoom),this.segments=new so,this.segments2=new so,this.stateDependentLayerIds=this.layers.filter((function(t){return t.isStateDependent()})).map((function(t){return t.id}))};ss.prototype.populate=function(t,e,n){this.hasPattern=os("fill",this.layers,e);for(var r=this.layers[0].layout.get("fill-sort-key"),i=[],o=0,a=t;o<a.length;o+=1){var s=a[o],u=s.feature,c=s.id,l=s.index,h=s.sourceLayerIndex,f=this.layers[0]._featureFilter.needGeometry,p=No(u,f);if(this.layers[0]._featureFilter.filter(new si(this.zoom),p,n)){var d=r?r.evaluate(p,{},n,e.availableImages):void 0,A={id:c,properties:u.properties,type:u.type,sourceLayerIndex:h,index:l,geometry:f?p.geometry:Uo(u),patterns:{},sortKey:d};i.push(A)}}r&&i.sort((function(t,e){return t.sortKey-e.sortKey}));for(var g=0,m=i;g<m.length;g+=1){var y=m[g],v=y.geometry,_=y.index,b=y.sourceLayerIndex;if(this.hasPattern){var x=as("fill",this.layers,y,this.zoom,e);this.patternFeatures.push(x)}else this.addFeature(y,v,_,n,{});e.featureIndex.insert(t[_].feature,v,_,b,this.index)}},ss.prototype.update=function(t,e,n){this.stateDependentLayers.length&&this.programConfigurations.updatePaintArrays(t,e,this.stateDependentLayers,n)},ss.prototype.addFeatures=function(t,e,n){for(var r=0,i=this.patternFeatures;r<i.length;r+=1){var o=i[r];this.addFeature(o,o.geometry,o.index,e,n)}},ss.prototype.isEmpty=function(){return 0===this.layoutVertexArray.length},ss.prototype.uploadPending=function(){return!this.uploaded||this.programConfigurations.needsUpload},ss.prototype.upload=function(t){this.uploaded||(this.layoutVertexBuffer=t.createVertexBuffer(this.layoutVertexArray,Oa),this.indexBuffer=t.createIndexBuffer(this.indexArray),this.indexBuffer2=t.createIndexBuffer(this.indexArray2)),this.programConfigurations.upload(t),this.uploaded=!0},ss.prototype.destroy=function(){this.layoutVertexBuffer&&(this.layoutVertexBuffer.destroy(),this.indexBuffer.destroy(),this.indexBuffer2.destroy(),this.programConfigurations.destroy(),this.segments.destroy(),this.segments2.destroy())},ss.prototype.addFeature=function(t,e,n,r,i){for(var o=0,a=rs(e,500);o<a.length;o+=1){for(var s=a[o],u=0,c=0,l=s;c<l.length;c+=1)u+=l[c].length;for(var h=this.segments.prepareSegment(u,this.layoutVertexArray,this.indexArray),f=h.vertexLength,p=[],d=[],A=0,g=s;A<g.length;A+=1){var m=g[A];if(0!==m.length){m!==s[0]&&d.push(p.length/2);var y=this.segments2.prepareSegment(m.length,this.layoutVertexArray,this.indexArray2),v=y.vertexLength;this.layoutVertexArray.emplaceBack(m[0].x,m[0].y),this.indexArray2.emplaceBack(v+m.length-1,v),p.push(m[0].x),p.push(m[0].y);for(var _=1;_<m.length;_++)this.layoutVertexArray.emplaceBack(m[_].x,m[_].y),this.indexArray2.emplaceBack(v+_-1,v+_),p.push(m[_].x),p.push(m[_].y);y.vertexLength+=m.length,y.primitiveLength+=m.length}}for(var b=Sa(p,d),x=0;x<b.length;x+=3)this.indexArray.emplaceBack(f+b[x],f+b[x+1],f+b[x+2]);h.vertexLength+=u,h.primitiveLength+=b.length/3}this.programConfigurations.populatePaintArrays(this.layoutVertexArray.length,t,n,i,r)},Fr("FillBucket",ss,{omit:["layers","patternFeatures"]});var us=new bi({"fill-sort-key":new mi(Pt.layout_fill["fill-sort-key"])}),cs={paint:new bi({"fill-antialias":new gi(Pt.paint_fill["fill-antialias"]),"fill-opacity":new mi(Pt.paint_fill["fill-opacity"]),"fill-color":new mi(Pt.paint_fill["fill-color"]),"fill-outline-color":new mi(Pt.paint_fill["fill-outline-color"]),"fill-translate":new gi(Pt.paint_fill["fill-translate"]),"fill-translate-anchor":new gi(Pt.paint_fill["fill-translate-anchor"]),"fill-pattern":new yi(Pt.paint_fill["fill-pattern"])}),layout:us},ls=function(t){function e(e){t.call(this,e,cs)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.recalculate=function(e,n){t.prototype.recalculate.call(this,e,n);var r=this.paint._values["fill-outline-color"];"constant"===r.value.kind&&void 0===r.value.value&&(this.paint._values["fill-outline-color"]=this.paint._values["fill-color"])},e.prototype.createBucket=function(t){return new ss(t)},e.prototype.queryRadius=function(){return na(this.paint.get("fill-translate"))},e.prototype.queryIntersectsFeature=function(t,e,n,r,i,o,a){return qo(ra(t,this.paint.get("fill-translate"),this.paint.get("fill-translate-anchor"),o.angle,a),r)},e.prototype.isTileClipped=function(){return!0},e}(xi),hs=Si([{name:"a_pos",components:2,type:"Int16"},{name:"a_normal_ed",components:4,type:"Int16"}],4).members,fs=ps;function ps(t,e,n,r,i){this.properties={},this.extent=n,this.type=0,this._pbf=t,this._geometry=-1,this._keys=r,this._values=i,t.readFields(ds,this,e)}function ds(t,e,n){1==t?e.id=n.readVarint():2==t?function(t,e){for(var n=t.readVarint()+t.pos;t.pos<n;){var r=e._keys[t.readVarint()],i=e._values[t.readVarint()];e.properties[r]=i}}(n,e):3==t?e.type=n.readVarint():4==t&&(e._geometry=n.pos)}function As(t){for(var e,n,r=0,i=0,o=t.length,a=o-1;i<o;a=i++)r+=((n=t[a]).x-(e=t[i]).x)*(e.y+n.y);return r}ps.types=["Unknown","Point","LineString","Polygon"],ps.prototype.loadGeometry=function(){var t=this._pbf;t.pos=this._geometry;for(var e,n=t.readVarint()+t.pos,r=1,o=0,a=0,s=0,u=[];t.pos<n;){if(o<=0){var c=t.readVarint();r=7&c,o=c>>3}if(o--,1===r||2===r)a+=t.readSVarint(),s+=t.readSVarint(),1===r&&(e&&u.push(e),e=[]),e.push(new i(a,s));else{if(7!==r)throw new Error("unknown command "+r);e&&e.push(e[0].clone())}}return e&&u.push(e),u},ps.prototype.bbox=function(){var t=this._pbf;t.pos=this._geometry;for(var e=t.readVarint()+t.pos,n=1,r=0,i=0,o=0,a=1/0,s=-1/0,u=1/0,c=-1/0;t.pos<e;){if(r<=0){var l=t.readVarint();n=7&l,r=l>>3}if(r--,1===n||2===n)(i+=t.readSVarint())<a&&(a=i),i>s&&(s=i),(o+=t.readSVarint())<u&&(u=o),o>c&&(c=o);else if(7!==n)throw new Error("unknown command "+n)}return[a,u,s,c]},ps.prototype.toGeoJSON=function(t,e,n){var r,i,o=this.extent*Math.pow(2,n),a=this.extent*t,s=this.extent*e,u=this.loadGeometry(),c=ps.types[this.type];function l(t){for(var e=0;e<t.length;e++){var n=t[e];t[e]=[360*(n.x+a)/o-180,360/Math.PI*Math.atan(Math.exp((180-360*(n.y+s)/o)*Math.PI/180))-90]}}switch(this.type){case 1:var h=[];for(r=0;r<u.length;r++)h[r]=u[r][0];l(u=h);break;case 2:for(r=0;r<u.length;r++)l(u[r]);break;case 3:for(u=function(t){var e=t.length;if(e<=1)return[t];for(var n,r,i=[],o=0;o<e;o++){var a=As(t[o]);0!==a&&(void 0===r&&(r=a<0),r===a<0?(n&&i.push(n),n=[t[o]]):n.push(t[o]))}return n&&i.push(n),i}(u),r=0;r<u.length;r++)for(i=0;i<u[r].length;i++)l(u[r][i])}1===u.length?u=u[0]:c="Multi"+c;var f={type:"Feature",geometry:{type:c,coordinates:u},properties:this.properties};return"id"in this&&(f.id=this.id),f};var gs=ms;function ms(t,e){this.version=1,this.name=null,this.extent=4096,this.length=0,this._pbf=t,this._keys=[],this._values=[],this._features=[],t.readFields(ys,this,e),this.length=this._features.length}function ys(t,e,n){15===t?e.version=n.readVarint():1===t?e.name=n.readString():5===t?e.extent=n.readVarint():2===t?e._features.push(n.pos):3===t?e._keys.push(n.readString()):4===t&&e._values.push(function(t){for(var e=null,n=t.readVarint()+t.pos;t.pos<n;){var r=t.readVarint()>>3;e=1===r?t.readString():2===r?t.readFloat():3===r?t.readDouble():4===r?t.readVarint64():5===r?t.readVarint():6===r?t.readSVarint():7===r?t.readBoolean():null}return e}(n))}function vs(t,e,n){if(3===t){var r=new gs(n,n.readVarint()+n.pos);r.length&&(e[r.name]=r)}}ms.prototype.feature=function(t){if(t<0||t>=this._features.length)throw new Error("feature index out of bounds");this._pbf.pos=this._features[t];var e=this._pbf.readVarint()+this._pbf.pos;return new fs(this._pbf,e,this.extent,this._keys,this._values)};var _s={VectorTile:function(t,e){this.layers=t.readFields(vs,{},e)},VectorTileFeature:fs,VectorTileLayer:gs},bs=_s.VectorTileFeature.types,xs=Math.pow(2,13);function ws(t,e,n,r,i,o,a,s){t.emplaceBack(e,n,2*Math.floor(r*xs)+a,i*xs*2,o*xs*2,Math.round(s))}var Es=function(t){this.zoom=t.zoom,this.overscaling=t.overscaling,this.layers=t.layers,this.layerIds=this.layers.map((function(t){return t.id})),this.index=t.index,this.hasPattern=!1,this.layoutVertexArray=new Mi,this.indexArray=new Ni,this.programConfigurations=new Do(t.layers,t.zoom),this.segments=new so,this.stateDependentLayerIds=this.layers.filter((function(t){return t.isStateDependent()})).map((function(t){return t.id}))};function Os(t,e){return t.x===e.x&&(t.x<0||t.x>8192)||t.y===e.y&&(t.y<0||t.y>8192)}Es.prototype.populate=function(t,e,n){this.features=[],this.hasPattern=os("fill-extrusion",this.layers,e);for(var r=0,i=t;r<i.length;r+=1){var o=i[r],a=o.feature,s=o.id,u=o.index,c=o.sourceLayerIndex,l=this.layers[0]._featureFilter.needGeometry,h=No(a,l);if(this.layers[0]._featureFilter.filter(new si(this.zoom),h,n)){var f={id:s,sourceLayerIndex:c,index:u,geometry:l?h.geometry:Uo(a),properties:a.properties,type:a.type,patterns:{}};this.hasPattern?this.features.push(as("fill-extrusion",this.layers,f,this.zoom,e)):this.addFeature(f,f.geometry,u,n,{}),e.featureIndex.insert(a,f.geometry,u,c,this.index,!0)}}},Es.prototype.addFeatures=function(t,e,n){for(var r=0,i=this.features;r<i.length;r+=1){var o=i[r];this.addFeature(o,o.geometry,o.index,e,n)}},Es.prototype.update=function(t,e,n){this.stateDependentLayers.length&&this.programConfigurations.updatePaintArrays(t,e,this.stateDependentLayers,n)},Es.prototype.isEmpty=function(){return 0===this.layoutVertexArray.length},Es.prototype.uploadPending=function(){return!this.uploaded||this.programConfigurations.needsUpload},Es.prototype.upload=function(t){this.uploaded||(this.layoutVertexBuffer=t.createVertexBuffer(this.layoutVertexArray,hs),this.indexBuffer=t.createIndexBuffer(this.indexArray)),this.programConfigurations.upload(t),this.uploaded=!0},Es.prototype.destroy=function(){this.layoutVertexBuffer&&(this.layoutVertexBuffer.destroy(),this.indexBuffer.destroy(),this.programConfigurations.destroy(),this.segments.destroy())},Es.prototype.addFeature=function(t,e,n,r,i){for(var o=0,a=rs(e,500);o<a.length;o+=1){for(var s=a[o],u=0,c=0,l=s;c<l.length;c+=1)u+=l[c].length;for(var h=this.segments.prepareSegment(4,this.layoutVertexArray,this.indexArray),f=0,p=s;f<p.length;f+=1){var d=p[f];if(0!==d.length&&!((B=d).every((function(t){return t.x<0}))||B.every((function(t){return t.x>8192}))||B.every((function(t){return t.y<0}))||B.every((function(t){return t.y>8192}))))for(var A=0,g=0;g<d.length;g++){var m=d[g];if(g>=1){var y=d[g-1];if(!Os(m,y)){h.vertexLength+4>so.MAX_VERTEX_ARRAY_LENGTH&&(h=this.segments.prepareSegment(4,this.layoutVertexArray,this.indexArray));var v=m.sub(y)._perp()._unit(),_=y.dist(m);A+_>32768&&(A=0),ws(this.layoutVertexArray,m.x,m.y,v.x,v.y,0,0,A),ws(this.layoutVertexArray,m.x,m.y,v.x,v.y,0,1,A),ws(this.layoutVertexArray,y.x,y.y,v.x,v.y,0,0,A+=_),ws(this.layoutVertexArray,y.x,y.y,v.x,v.y,0,1,A);var b=h.vertexLength;this.indexArray.emplaceBack(b,b+2,b+1),this.indexArray.emplaceBack(b+1,b+2,b+3),h.vertexLength+=4,h.primitiveLength+=2}}}}if(h.vertexLength+u>so.MAX_VERTEX_ARRAY_LENGTH&&(h=this.segments.prepareSegment(u,this.layoutVertexArray,this.indexArray)),"Polygon"===bs[t.type]){for(var x=[],w=[],E=h.vertexLength,O=0,S=s;O<S.length;O+=1){var T=S[O];if(0!==T.length){T!==s[0]&&w.push(x.length/2);for(var C=0;C<T.length;C++){var P=T[C];ws(this.layoutVertexArray,P.x,P.y,0,0,1,1,0),x.push(P.x),x.push(P.y)}}}for(var M=Sa(x,w),I=0;I<M.length;I+=3)this.indexArray.emplaceBack(E+M[I],E+M[I+2],E+M[I+1]);h.primitiveLength+=M.length/3,h.vertexLength+=u}}var B;this.programConfigurations.populatePaintArrays(this.layoutVertexArray.length,t,n,i,r)},Fr("FillExtrusionBucket",Es,{omit:["layers","features"]});var Ss={paint:new bi({"fill-extrusion-opacity":new gi(Pt["paint_fill-extrusion"]["fill-extrusion-opacity"]),"fill-extrusion-color":new mi(Pt["paint_fill-extrusion"]["fill-extrusion-color"]),"fill-extrusion-translate":new gi(Pt["paint_fill-extrusion"]["fill-extrusion-translate"]),"fill-extrusion-translate-anchor":new gi(Pt["paint_fill-extrusion"]["fill-extrusion-translate-anchor"]),"fill-extrusion-pattern":new yi(Pt["paint_fill-extrusion"]["fill-extrusion-pattern"]),"fill-extrusion-height":new mi(Pt["paint_fill-extrusion"]["fill-extrusion-height"]),"fill-extrusion-base":new mi(Pt["paint_fill-extrusion"]["fill-extrusion-base"]),"fill-extrusion-vertical-gradient":new gi(Pt["paint_fill-extrusion"]["fill-extrusion-vertical-gradient"])})},Ts=function(t){function e(e){t.call(this,e,Ss)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.createBucket=function(t){return new Es(t)},e.prototype.queryRadius=function(){return na(this.paint.get("fill-extrusion-translate"))},e.prototype.is3D=function(){return!0},e.prototype.queryIntersectsFeature=function(t,e,n,r,o,a,s,u){var c=ra(t,this.paint.get("fill-extrusion-translate"),this.paint.get("fill-extrusion-translate-anchor"),a.angle,s),l=this.paint.get("fill-extrusion-height").evaluate(e,n),h=this.paint.get("fill-extrusion-base").evaluate(e,n),f=function(t,e,n,r){for(var o=[],a=0,s=t;a<s.length;a+=1){var u=s[a],c=[u.x,u.y,0,1];ha(c,c,e),o.push(new i(c[0]/c[3],c[1]/c[3]))}return o}(c,u),p=function(t,e,n,r){for(var o=[],a=[],s=r[8]*e,u=r[9]*e,c=r[10]*e,l=r[11]*e,h=r[8]*n,f=r[9]*n,p=r[10]*n,d=r[11]*n,A=0,g=t;A<g.length;A+=1){for(var m=[],y=[],v=0,_=g[A];v<_.length;v+=1){var b=_[v],x=b.x,w=b.y,E=r[0]*x+r[4]*w+r[12],O=r[1]*x+r[5]*w+r[13],S=r[2]*x+r[6]*w+r[14],T=r[3]*x+r[7]*w+r[15],C=S+c,P=T+l,M=E+h,I=O+f,B=S+p,R=T+d,k=new i((E+s)/P,(O+u)/P);k.z=C/P,m.push(k);var D=new i(M/R,I/R);D.z=B/R,y.push(D)}o.push(m),a.push(y)}return[o,a]}(r,h,l,u);return function(t,e,n){var r=1/0;qo(n,e)&&(r=Ps(n,e[0]));for(var i=0;i<e.length;i++)for(var o=e[i],a=t[i],s=0;s<o.length-1;s++){var u=o[s],c=[u,o[s+1],a[s+1],a[s],u];Ho(n,c)&&(r=Math.min(r,Ps(n,c)))}return r!==1/0&&r}(p[0],p[1],f)},e}(xi);function Cs(t,e){return t.x*e.x+t.y*e.y}function Ps(t,e){if(1===t.length){for(var n,r=0,i=e[r++];!n||i.equals(n);)if(!(n=e[r++]))return 1/0;for(;r<e.length;r++){var o=e[r],a=t[0],s=n.sub(i),u=o.sub(i),c=a.sub(i),l=Cs(s,s),h=Cs(s,u),f=Cs(u,u),p=Cs(c,s),d=Cs(c,u),A=l*f-h*h,g=(f*p-h*d)/A,m=(l*d-h*p)/A,y=i.z*(1-g-m)+n.z*g+o.z*m;if(isFinite(y))return y}return 1/0}for(var v=1/0,_=0,b=e;_<b.length;_+=1)v=Math.min(v,b[_].z);return v}var Ms=Si([{name:"a_pos_normal",components:2,type:"Int16"},{name:"a_data",components:4,type:"Uint8"}],4).members,Is=Si([{name:"a_uv_x",components:1,type:"Float32"},{name:"a_split_index",components:1,type:"Float32"}]).members,Bs=_s.VectorTileFeature.types,Rs=Math.cos(Math.PI/180*37.5),ks=Math.pow(2,14)/.5,Ds=function(t){var e=this;this.zoom=t.zoom,this.overscaling=t.overscaling,this.layers=t.layers,this.layerIds=this.layers.map((function(t){return t.id})),this.index=t.index,this.hasPattern=!1,this.patternFeatures=[],this.lineClipsArray=[],this.gradients={},this.layers.forEach((function(t){e.gradients[t.id]={}})),this.layoutVertexArray=new Ii,this.layoutVertexArray2=new Bi,this.indexArray=new Ni,this.programConfigurations=new Do(t.layers,t.zoom),this.segments=new so,this.maxLineLength=0,this.stateDependentLayerIds=this.layers.filter((function(t){return t.isStateDependent()})).map((function(t){return t.id}))};Ds.prototype.populate=function(t,e,n){this.hasPattern=os("line",this.layers,e);for(var r=this.layers[0].layout.get("line-sort-key"),i=[],o=0,a=t;o<a.length;o+=1){var s=a[o],u=s.feature,c=s.id,l=s.index,h=s.sourceLayerIndex,f=this.layers[0]._featureFilter.needGeometry,p=No(u,f);if(this.layers[0]._featureFilter.filter(new si(this.zoom),p,n)){var d=r?r.evaluate(p,{},n):void 0,A={id:c,properties:u.properties,type:u.type,sourceLayerIndex:h,index:l,geometry:f?p.geometry:Uo(u),patterns:{},sortKey:d};i.push(A)}}r&&i.sort((function(t,e){return t.sortKey-e.sortKey}));for(var g=0,m=i;g<m.length;g+=1){var y=m[g],v=y.geometry,_=y.index,b=y.sourceLayerIndex;if(this.hasPattern){var x=as("line",this.layers,y,this.zoom,e);this.patternFeatures.push(x)}else this.addFeature(y,v,_,n,{});e.featureIndex.insert(t[_].feature,v,_,b,this.index)}},Ds.prototype.update=function(t,e,n){this.stateDependentLayers.length&&this.programConfigurations.updatePaintArrays(t,e,this.stateDependentLayers,n)},Ds.prototype.addFeatures=function(t,e,n){for(var r=0,i=this.patternFeatures;r<i.length;r+=1){var o=i[r];this.addFeature(o,o.geometry,o.index,e,n)}},Ds.prototype.isEmpty=function(){return 0===this.layoutVertexArray.length},Ds.prototype.uploadPending=function(){return!this.uploaded||this.programConfigurations.needsUpload},Ds.prototype.upload=function(t){this.uploaded||(0!==this.layoutVertexArray2.length&&(this.layoutVertexBuffer2=t.createVertexBuffer(this.layoutVertexArray2,Is)),this.layoutVertexBuffer=t.createVertexBuffer(this.layoutVertexArray,Ms),this.indexBuffer=t.createIndexBuffer(this.indexArray)),this.programConfigurations.upload(t),this.uploaded=!0},Ds.prototype.destroy=function(){this.layoutVertexBuffer&&(this.layoutVertexBuffer.destroy(),this.indexBuffer.destroy(),this.programConfigurations.destroy(),this.segments.destroy())},Ds.prototype.lineFeatureClips=function(t){if(t.properties&&t.properties.hasOwnProperty("mapbox_clip_start")&&t.properties.hasOwnProperty("mapbox_clip_end"))return{start:+t.properties.mapbox_clip_start,end:+t.properties.mapbox_clip_end}},Ds.prototype.addFeature=function(t,e,n,r,i){var o=this.layers[0].layout,a=o.get("line-join").evaluate(t,{}),s=o.get("line-cap"),u=o.get("line-miter-limit"),c=o.get("line-round-limit");this.lineClips=this.lineFeatureClips(t);for(var l=0,h=e;l<h.length;l+=1)this.addLine(h[l],t,a,s,u,c);this.programConfigurations.populatePaintArrays(this.layoutVertexArray.length,t,n,i,r)},Ds.prototype.addLine=function(t,e,n,r,i,o){if(this.distance=0,this.scaledDistance=0,this.totalDistance=0,this.lineClips){this.lineClipsArray.push(this.lineClips);for(var a=0;a<t.length-1;a++)this.totalDistance+=t[a].dist(t[a+1]);this.updateScaledDistance(),this.maxLineLength=Math.max(this.maxLineLength,this.totalDistance)}for(var s="Polygon"===Bs[e.type],u=t.length;u>=2&&t[u-1].equals(t[u-2]);)u--;for(var c=0;c<u-1&&t[c].equals(t[c+1]);)c++;if(!(u<(s?3:2))){"bevel"===n&&(i=1.05);var l,h=this.overscaling<=16?122880/(512*this.overscaling):0,f=this.segments.prepareSegment(10*u,this.layoutVertexArray,this.indexArray),p=void 0,d=void 0,A=void 0,g=void 0;this.e1=this.e2=-1,s&&(g=t[c].sub(l=t[u-2])._unit()._perp());for(var m=c;m<u;m++)if(!(d=m===u-1?s?t[c+1]:void 0:t[m+1])||!t[m].equals(d)){g&&(A=g),l&&(p=l),l=t[m],g=d?d.sub(l)._unit()._perp():A;var y=(A=A||g).add(g);0===y.x&&0===y.y||y._unit();var v=A.x*g.x+A.y*g.y,_=y.x*g.x+y.y*g.y,b=0!==_?1/_:1/0,x=2*Math.sqrt(2-2*_),w=_<Rs&&p&&d,E=A.x*g.y-A.y*g.x>0;if(w&&m>c){var O=l.dist(p);if(O>2*h){var S=l.sub(l.sub(p)._mult(h/O)._round());this.updateDistance(p,S),this.addCurrentVertex(S,A,0,0,f),p=S}}var T=p&&d,C=T?n:s?"butt":r;if(T&&"round"===C&&(b<o?C="miter":b<=2&&(C="fakeround")),"miter"===C&&b>i&&(C="bevel"),"bevel"===C&&(b>2&&(C="flipbevel"),b<i&&(C="miter")),p&&this.updateDistance(p,l),"miter"===C)y._mult(b),this.addCurrentVertex(l,y,0,0,f);else if("flipbevel"===C){if(b>100)y=g.mult(-1);else{var P=b*A.add(g).mag()/A.sub(g).mag();y._perp()._mult(P*(E?-1:1))}this.addCurrentVertex(l,y,0,0,f),this.addCurrentVertex(l,y.mult(-1),0,0,f)}else if("bevel"===C||"fakeround"===C){var M=-Math.sqrt(b*b-1),I=E?M:0,B=E?0:M;if(p&&this.addCurrentVertex(l,A,I,B,f),"fakeround"===C)for(var R=Math.round(180*x/Math.PI/20),k=1;k<R;k++){var D=k/R;if(.5!==D){var L=D-.5;D+=D*L*(D-1)*((1.0904+v*(v*(3.55645-1.43519*v)-3.2452))*L*L+(.848013+v*(.215638*v-1.06021)))}var j=g.sub(A)._mult(D)._add(A)._unit()._mult(E?-1:1);this.addHalfVertex(l,j.x,j.y,!1,E,0,f)}d&&this.addCurrentVertex(l,g,-I,-B,f)}else if("butt"===C)this.addCurrentVertex(l,y,0,0,f);else if("square"===C){var F=p?1:-1;this.addCurrentVertex(l,y,F,F,f)}else"round"===C&&(p&&(this.addCurrentVertex(l,A,0,0,f),this.addCurrentVertex(l,A,1,1,f,!0)),d&&(this.addCurrentVertex(l,g,-1,-1,f,!0),this.addCurrentVertex(l,g,0,0,f)));if(w&&m<u-1){var z=l.dist(d);if(z>2*h){var U=l.add(d.sub(l)._mult(h/z)._round());this.updateDistance(l,U),this.addCurrentVertex(U,g,0,0,f),l=U}}}}},Ds.prototype.addCurrentVertex=function(t,e,n,r,i,o){void 0===o&&(o=!1);var a=e.y*r-e.x,s=-e.y-e.x*r;this.addHalfVertex(t,e.x+e.y*n,e.y-e.x*n,o,!1,n,i),this.addHalfVertex(t,a,s,o,!0,-r,i),this.distance>ks/2&&0===this.totalDistance&&(this.distance=0,this.addCurrentVertex(t,e,n,r,i,o))},Ds.prototype.addHalfVertex=function(t,e,n,r,i,o,a){var s=.5*(this.lineClips?this.scaledDistance*(ks-1):this.scaledDistance);this.layoutVertexArray.emplaceBack((t.x<<1)+(r?1:0),(t.y<<1)+(i?1:0),Math.round(63*e)+128,Math.round(63*n)+128,1+(0===o?0:o<0?-1:1)|(63&s)<<2,s>>6),this.lineClips&&this.layoutVertexArray2.emplaceBack((this.scaledDistance-this.lineClips.start)/(this.lineClips.end-this.lineClips.start),this.lineClipsArray.length);var u=a.vertexLength++;this.e1>=0&&this.e2>=0&&(this.indexArray.emplaceBack(this.e1,this.e2,u),a.primitiveLength++),i?this.e2=u:this.e1=u},Ds.prototype.updateScaledDistance=function(){this.scaledDistance=this.lineClips?this.lineClips.start+(this.lineClips.end-this.lineClips.start)*this.distance/this.totalDistance:this.distance},Ds.prototype.updateDistance=function(t,e){this.distance+=t.dist(e),this.updateScaledDistance()},Fr("LineBucket",Ds,{omit:["layers","patternFeatures"]});var Ls=new bi({"line-cap":new gi(Pt.layout_line["line-cap"]),"line-join":new mi(Pt.layout_line["line-join"]),"line-miter-limit":new gi(Pt.layout_line["line-miter-limit"]),"line-round-limit":new gi(Pt.layout_line["line-round-limit"]),"line-sort-key":new mi(Pt.layout_line["line-sort-key"])}),js={paint:new bi({"line-opacity":new mi(Pt.paint_line["line-opacity"]),"line-color":new mi(Pt.paint_line["line-color"]),"line-translate":new gi(Pt.paint_line["line-translate"]),"line-translate-anchor":new gi(Pt.paint_line["line-translate-anchor"]),"line-width":new mi(Pt.paint_line["line-width"]),"line-gap-width":new mi(Pt.paint_line["line-gap-width"]),"line-offset":new mi(Pt.paint_line["line-offset"]),"line-blur":new mi(Pt.paint_line["line-blur"]),"line-dasharray":new vi(Pt.paint_line["line-dasharray"]),"line-pattern":new yi(Pt.paint_line["line-pattern"]),"line-gradient":new _i(Pt.paint_line["line-gradient"])}),layout:Ls},Fs=new(function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.possiblyEvaluate=function(e,n){return n=new si(Math.floor(n.zoom),{now:n.now,fadeDuration:n.fadeDuration,zoomHistory:n.zoomHistory,transition:n.transition}),t.prototype.possiblyEvaluate.call(this,e,n)},e.prototype.evaluate=function(e,n,r,i){return n=f({},n,{zoom:Math.floor(n.zoom)}),t.prototype.evaluate.call(this,e,n,r,i)},e}(mi))(js.paint.properties["line-width"].specification);Fs.useIntegerZoom=!0;var zs=function(t){function e(e){t.call(this,e,js),this.gradientVersion=0}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._handleSpecialPaintPropertyUpdate=function(t){"line-gradient"===t&&(this.stepInterpolant=this._transitionablePaint._values["line-gradient"].value.expression._styleExpression.expression instanceof Ve,this.gradientVersion=(this.gradientVersion+1)%s)},e.prototype.gradientExpression=function(){return this._transitionablePaint._values["line-gradient"].value.expression},e.prototype.recalculate=function(e,n){t.prototype.recalculate.call(this,e,n),this.paint._values["line-floorwidth"]=Fs.possiblyEvaluate(this._transitioningPaint._values["line-width"].value,e)},e.prototype.createBucket=function(t){return new Ds(t)},e.prototype.queryRadius=function(t){var e=t,n=Us(ea("line-width",this,e),ea("line-gap-width",this,e)),r=ea("line-offset",this,e);return n/2+Math.abs(r)+na(this.paint.get("line-translate"))},e.prototype.queryIntersectsFeature=function(t,e,n,r,o,a,s){var u=ra(t,this.paint.get("line-translate"),this.paint.get("line-translate-anchor"),a.angle,s),c=s/2*Us(this.paint.get("line-width").evaluate(e,n),this.paint.get("line-gap-width").evaluate(e,n)),l=this.paint.get("line-offset").evaluate(e,n);return l&&(r=function(t,e){for(var n=[],r=new i(0,0),o=0;o<t.length;o++){for(var a=t[o],s=[],u=0;u<a.length;u++){var c=a[u],l=a[u+1],h=0===u?r:c.sub(a[u-1])._unit()._perp(),f=u===a.length-1?r:l.sub(c)._unit()._perp(),p=h._add(f)._unit();p._mult(1/(p.x*f.x+p.y*f.y)),s.push(p._mult(e)._add(c))}n.push(s)}return n}(r,l*s)),function(t,e,n){for(var r=0;r<e.length;r++){var i=e[r];if(t.length>=3)for(var o=0;o<i.length;o++)if($o(t,i[o]))return!0;if(Xo(t,i,n))return!0}return!1}(u,r,c)},e.prototype.isTileClipped=function(){return!0},e}(xi);function Us(t,e){return e>0?e+2*t:t}var Ns=Si([{name:"a_pos_offset",components:4,type:"Int16"},{name:"a_data",components:4,type:"Uint16"},{name:"a_pixeloffset",components:4,type:"Int16"}],4),Gs=Si([{name:"a_projected_pos",components:3,type:"Float32"}],4),Vs=(Si([{name:"a_fade_opacity",components:1,type:"Uint32"}],4),Si([{name:"a_placed",components:2,type:"Uint8"},{name:"a_shift",components:2,type:"Float32"}])),Hs=(Si([{type:"Int16",name:"anchorPointX"},{type:"Int16",name:"anchorPointY"},{type:"Int16",name:"x1"},{type:"Int16",name:"y1"},{type:"Int16",name:"x2"},{type:"Int16",name:"y2"},{type:"Uint32",name:"featureIndex"},{type:"Uint16",name:"sourceLayerIndex"},{type:"Uint16",name:"bucketIndex"}]),Si([{name:"a_pos",components:2,type:"Int16"},{name:"a_anchor_pos",components:2,type:"Int16"},{name:"a_extrude",components:2,type:"Int16"}],4)),Ws=Si([{name:"a_pos",components:2,type:"Float32"},{name:"a_radius",components:1,type:"Float32"},{name:"a_flags",components:2,type:"Int16"}],4);function qs(t,e,n){return t.sections.forEach((function(t){t.text=function(t,e,n){var r=e.layout.get("text-transform").evaluate(n,{});return"uppercase"===r?t=t.toLocaleUpperCase():"lowercase"===r&&(t=t.toLocaleLowerCase()),ai.applyArabicShaping&&(t=ai.applyArabicShaping(t)),t}(t.text,e,n)})),t}Si([{name:"triangle",components:3,type:"Uint16"}]),Si([{type:"Int16",name:"anchorX"},{type:"Int16",name:"anchorY"},{type:"Uint16",name:"glyphStartIndex"},{type:"Uint16",name:"numGlyphs"},{type:"Uint32",name:"vertexStartIndex"},{type:"Uint32",name:"lineStartIndex"},{type:"Uint32",name:"lineLength"},{type:"Uint16",name:"segment"},{type:"Uint16",name:"lowerSize"},{type:"Uint16",name:"upperSize"},{type:"Float32",name:"lineOffsetX"},{type:"Float32",name:"lineOffsetY"},{type:"Uint8",name:"writingMode"},{type:"Uint8",name:"placedOrientation"},{type:"Uint8",name:"hidden"},{type:"Uint32",name:"crossTileID"},{type:"Int16",name:"associatedIconIndex"}]),Si([{type:"Int16",name:"anchorX"},{type:"Int16",name:"anchorY"},{type:"Int16",name:"rightJustifiedTextSymbolIndex"},{type:"Int16",name:"centerJustifiedTextSymbolIndex"},{type:"Int16",name:"leftJustifiedTextSymbolIndex"},{type:"Int16",name:"verticalPlacedTextSymbolIndex"},{type:"Int16",name:"placedIconSymbolIndex"},{type:"Int16",name:"verticalPlacedIconSymbolIndex"},{type:"Uint16",name:"key"},{type:"Uint16",name:"textBoxStartIndex"},{type:"Uint16",name:"textBoxEndIndex"},{type:"Uint16",name:"verticalTextBoxStartIndex"},{type:"Uint16",name:"verticalTextBoxEndIndex"},{type:"Uint16",name:"iconBoxStartIndex"},{type:"Uint16",name:"iconBoxEndIndex"},{type:"Uint16",name:"verticalIconBoxStartIndex"},{type:"Uint16",name:"verticalIconBoxEndIndex"},{type:"Uint16",name:"featureIndex"},{type:"Uint16",name:"numHorizontalGlyphVertices"},{type:"Uint16",name:"numVerticalGlyphVertices"},{type:"Uint16",name:"numIconVertices"},{type:"Uint16",name:"numVerticalIconVertices"},{type:"Uint16",name:"useRuntimeCollisionCircles"},{type:"Uint32",name:"crossTileID"},{type:"Float32",name:"textBoxScale"},{type:"Float32",components:2,name:"textOffset"},{type:"Float32",name:"collisionCircleDiameter"}]),Si([{type:"Float32",name:"offsetX"}]),Si([{type:"Int16",name:"x"},{type:"Int16",name:"y"},{type:"Int16",name:"tileUnitDistanceFromAnchor"}]);var Xs={"!":"︕","#":"＃",$:"＄","%":"％","&":"＆","(":"︵",")":"︶","*":"＊","+":"＋",",":"︐","-":"︲",".":"・","/":"／",":":"︓",";":"︔","<":"︿","=":"＝",">":"﹀","?":"︖","@":"＠","[":"﹇","\\":"＼","]":"﹈","^":"＾",_:"︳","`":"｀","{":"︷","|":"―","}":"︸","~":"～","¢":"￠","£":"￡","¥":"￥","¦":"￤","¬":"￢","¯":"￣","–":"︲","—":"︱","‘":"﹃","’":"﹄","“":"﹁","”":"﹂","…":"︙","‧":"・","₩":"￦","、":"︑","。":"︒","〈":"︿","〉":"﹀","《":"︽","》":"︾","「":"﹁","」":"﹂","『":"﹃","』":"﹄","【":"︻","】":"︼","〔":"︹","〕":"︺","〖":"︗","〗":"︘","！":"︕","（":"︵","）":"︶","，":"︐","－":"︲","．":"・","：":"︓","；":"︔","＜":"︿","＞":"﹀","？":"︖","［":"﹇","］":"﹈","＿":"︳","｛":"︷","｜":"―","｝":"︸","｟":"︵","｠":"︶","｡":"︒","｢":"﹁","｣":"﹂"},Zs=function(t,e,n,r,i){var o,a,s=8*i-r-1,u=(1<<s)-1,c=u>>1,l=-7,h=n?i-1:0,f=n?-1:1,p=t[e+h];for(h+=f,o=p&(1<<-l)-1,p>>=-l,l+=s;l>0;o=256*o+t[e+h],h+=f,l-=8);for(a=o&(1<<-l)-1,o>>=-l,l+=r;l>0;a=256*a+t[e+h],h+=f,l-=8);if(0===o)o=1-c;else{if(o===u)return a?NaN:1/0*(p?-1:1);a+=Math.pow(2,r),o-=c}return(p?-1:1)*a*Math.pow(2,o-r)},Js=function(t,e,n,r,i,o){var a,s,u,c=8*o-i-1,l=(1<<c)-1,h=l>>1,f=23===i?Math.pow(2,-24)-Math.pow(2,-77):0,p=r?0:o-1,d=r?1:-1,A=e<0||0===e&&1/e<0?1:0;for(e=Math.abs(e),isNaN(e)||e===1/0?(s=isNaN(e)?1:0,a=l):(a=Math.floor(Math.log(e)/Math.LN2),e*(u=Math.pow(2,-a))<1&&(a--,u*=2),(e+=a+h>=1?f/u:f*Math.pow(2,1-h))*u>=2&&(a++,u/=2),a+h>=l?(s=0,a=l):a+h>=1?(s=(e*u-1)*Math.pow(2,i),a+=h):(s=e*Math.pow(2,h-1)*Math.pow(2,i),a=0));i>=8;t[n+p]=255&s,p+=d,s/=256,i-=8);for(a=a<<i|s,c+=i;c>0;t[n+p]=255&a,p+=d,a/=256,c-=8);t[n+p-d]|=128*A},Qs=Ks;function Ks(t){this.buf=ArrayBuffer.isView&&ArrayBuffer.isView(t)?t:new Uint8Array(t||0),this.pos=0,this.type=0,this.length=this.buf.length}Ks.Varint=0,Ks.Fixed64=1,Ks.Bytes=2,Ks.Fixed32=5;var Ys="undefined"==typeof TextDecoder?null:new TextDecoder("utf8");function $s(t){return t.type===Ks.Bytes?t.readVarint()+t.pos:t.pos+1}function tu(t,e,n){return n?4294967296*e+(t>>>0):4294967296*(e>>>0)+(t>>>0)}function eu(t,e,n){var r=e<=16383?1:e<=2097151?2:e<=268435455?3:Math.floor(Math.log(e)/(7*Math.LN2));n.realloc(r);for(var i=n.pos-1;i>=t;i--)n.buf[i+r]=n.buf[i]}function nu(t,e){for(var n=0;n<t.length;n++)e.writeVarint(t[n])}function ru(t,e){for(var n=0;n<t.length;n++)e.writeSVarint(t[n])}function iu(t,e){for(var n=0;n<t.length;n++)e.writeFloat(t[n])}function ou(t,e){for(var n=0;n<t.length;n++)e.writeDouble(t[n])}function au(t,e){for(var n=0;n<t.length;n++)e.writeBoolean(t[n])}function su(t,e){for(var n=0;n<t.length;n++)e.writeFixed32(t[n])}function uu(t,e){for(var n=0;n<t.length;n++)e.writeSFixed32(t[n])}function cu(t,e){for(var n=0;n<t.length;n++)e.writeFixed64(t[n])}function lu(t,e){for(var n=0;n<t.length;n++)e.writeSFixed64(t[n])}function hu(t,e){return(t[e]|t[e+1]<<8|t[e+2]<<16)+16777216*t[e+3]}function fu(t,e,n){t[n]=e,t[n+1]=e>>>8,t[n+2]=e>>>16,t[n+3]=e>>>24}function pu(t,e){return(t[e]|t[e+1]<<8|t[e+2]<<16)+(t[e+3]<<24)}function du(t,e,n){1===t&&n.readMessage(Au,e)}function Au(t,e,n){if(3===t){var r=n.readMessage(gu,{}),i=r.width,o=r.height,a=r.left,s=r.top,u=r.advance;e.push({id:r.id,bitmap:new ya({width:i+6,height:o+6},r.bitmap),metrics:{width:i,height:o,left:a,top:s,advance:u}})}}function gu(t,e,n){1===t?e.id=n.readVarint():2===t?e.bitmap=n.readBytes():3===t?e.width=n.readVarint():4===t?e.height=n.readVarint():5===t?e.left=n.readSVarint():6===t?e.top=n.readSVarint():7===t&&(e.advance=n.readVarint())}function mu(t){for(var e=0,n=0,r=0,i=t;r<i.length;r+=1){var o=i[r];e+=o.w*o.h,n=Math.max(n,o.w)}t.sort((function(t,e){return e.h-t.h}));for(var a=[{x:0,y:0,w:Math.max(Math.ceil(Math.sqrt(e/.95)),n),h:1/0}],s=0,u=0,c=0,l=t;c<l.length;c+=1)for(var h=l[c],f=a.length-1;f>=0;f--){var p=a[f];if(!(h.w>p.w||h.h>p.h)){if(h.x=p.x,h.y=p.y,u=Math.max(u,h.y+h.h),s=Math.max(s,h.x+h.w),h.w===p.w&&h.h===p.h){var d=a.pop();f<a.length&&(a[f]=d)}else h.h===p.h?(p.x+=h.w,p.w-=h.w):h.w===p.w?(p.y+=h.h,p.h-=h.h):(a.push({x:p.x+h.w,y:p.y,w:p.w-h.w,h:h.h}),p.y+=h.h,p.h-=h.h);break}}return{w:s,h:u,fill:e/(s*u)||0}}Ks.prototype={destroy:function(){this.buf=null},readFields:function(t,e,n){for(n=n||this.length;this.pos<n;){var r=this.readVarint(),i=r>>3,o=this.pos;this.type=7&r,t(i,e,this),this.pos===o&&this.skip(r)}return e},readMessage:function(t,e){return this.readFields(t,e,this.readVarint()+this.pos)},readFixed32:function(){var t=hu(this.buf,this.pos);return this.pos+=4,t},readSFixed32:function(){var t=pu(this.buf,this.pos);return this.pos+=4,t},readFixed64:function(){var t=hu(this.buf,this.pos)+4294967296*hu(this.buf,this.pos+4);return this.pos+=8,t},readSFixed64:function(){var t=hu(this.buf,this.pos)+4294967296*pu(this.buf,this.pos+4);return this.pos+=8,t},readFloat:function(){var t=Zs(this.buf,this.pos,!0,23,4);return this.pos+=4,t},readDouble:function(){var t=Zs(this.buf,this.pos,!0,52,8);return this.pos+=8,t},readVarint:function(t){var e,n,r=this.buf;return e=127&(n=r[this.pos++]),n<128?e:(e|=(127&(n=r[this.pos++]))<<7,n<128?e:(e|=(127&(n=r[this.pos++]))<<14,n<128?e:(e|=(127&(n=r[this.pos++]))<<21,n<128?e:function(t,e,n){var r,i,o=n.buf;if(r=(112&(i=o[n.pos++]))>>4,i<128)return tu(t,r,e);if(r|=(127&(i=o[n.pos++]))<<3,i<128)return tu(t,r,e);if(r|=(127&(i=o[n.pos++]))<<10,i<128)return tu(t,r,e);if(r|=(127&(i=o[n.pos++]))<<17,i<128)return tu(t,r,e);if(r|=(127&(i=o[n.pos++]))<<24,i<128)return tu(t,r,e);if(r|=(1&(i=o[n.pos++]))<<31,i<128)return tu(t,r,e);throw new Error("Expected varint not more than 10 bytes")}(e|=(15&(n=r[this.pos]))<<28,t,this))))},readVarint64:function(){return this.readVarint(!0)},readSVarint:function(){var t=this.readVarint();return t%2==1?(t+1)/-2:t/2},readBoolean:function(){return Boolean(this.readVarint())},readString:function(){var t=this.readVarint()+this.pos,e=this.pos;return this.pos=t,t-e>=12&&Ys?function(t,e,n){return Ys.decode(t.subarray(e,n))}(this.buf,e,t):function(t,e,n){for(var r="",i=e;i<n;){var o,a,s,u=t[i],c=null,l=u>239?4:u>223?3:u>191?2:1;if(i+l>n)break;1===l?u<128&&(c=u):2===l?128==(192&(o=t[i+1]))&&(c=(31&u)<<6|63&o)<=127&&(c=null):3===l?(a=t[i+2],128==(192&(o=t[i+1]))&&128==(192&a)&&((c=(15&u)<<12|(63&o)<<6|63&a)<=2047||c>=55296&&c<=57343)&&(c=null)):4===l&&(a=t[i+2],s=t[i+3],128==(192&(o=t[i+1]))&&128==(192&a)&&128==(192&s)&&((c=(15&u)<<18|(63&o)<<12|(63&a)<<6|63&s)<=65535||c>=1114112)&&(c=null)),null===c?(c=65533,l=1):c>65535&&(c-=65536,r+=String.fromCharCode(c>>>10&1023|55296),c=56320|1023&c),r+=String.fromCharCode(c),i+=l}return r}(this.buf,e,t)},readBytes:function(){var t=this.readVarint()+this.pos,e=this.buf.subarray(this.pos,t);return this.pos=t,e},readPackedVarint:function(t,e){if(this.type!==Ks.Bytes)return t.push(this.readVarint(e));var n=$s(this);for(t=t||[];this.pos<n;)t.push(this.readVarint(e));return t},readPackedSVarint:function(t){if(this.type!==Ks.Bytes)return t.push(this.readSVarint());var e=$s(this);for(t=t||[];this.pos<e;)t.push(this.readSVarint());return t},readPackedBoolean:function(t){if(this.type!==Ks.Bytes)return t.push(this.readBoolean());var e=$s(this);for(t=t||[];this.pos<e;)t.push(this.readBoolean());return t},readPackedFloat:function(t){if(this.type!==Ks.Bytes)return t.push(this.readFloat());var e=$s(this);for(t=t||[];this.pos<e;)t.push(this.readFloat());return t},readPackedDouble:function(t){if(this.type!==Ks.Bytes)return t.push(this.readDouble());var e=$s(this);for(t=t||[];this.pos<e;)t.push(this.readDouble());return t},readPackedFixed32:function(t){if(this.type!==Ks.Bytes)return t.push(this.readFixed32());var e=$s(this);for(t=t||[];this.pos<e;)t.push(this.readFixed32());return t},readPackedSFixed32:function(t){if(this.type!==Ks.Bytes)return t.push(this.readSFixed32());var e=$s(this);for(t=t||[];this.pos<e;)t.push(this.readSFixed32());return t},readPackedFixed64:function(t){if(this.type!==Ks.Bytes)return t.push(this.readFixed64());var e=$s(this);for(t=t||[];this.pos<e;)t.push(this.readFixed64());return t},readPackedSFixed64:function(t){if(this.type!==Ks.Bytes)return t.push(this.readSFixed64());var e=$s(this);for(t=t||[];this.pos<e;)t.push(this.readSFixed64());return t},skip:function(t){var e=7&t;if(e===Ks.Varint)for(;this.buf[this.pos++]>127;);else if(e===Ks.Bytes)this.pos=this.readVarint()+this.pos;else if(e===Ks.Fixed32)this.pos+=4;else{if(e!==Ks.Fixed64)throw new Error("Unimplemented type: "+e);this.pos+=8}},writeTag:function(t,e){this.writeVarint(t<<3|e)},realloc:function(t){for(var e=this.length||16;e<this.pos+t;)e*=2;if(e!==this.length){var n=new Uint8Array(e);n.set(this.buf),this.buf=n,this.length=e}},finish:function(){return this.length=this.pos,this.pos=0,this.buf.subarray(0,this.length)},writeFixed32:function(t){this.realloc(4),fu(this.buf,t,this.pos),this.pos+=4},writeSFixed32:function(t){this.realloc(4),fu(this.buf,t,this.pos),this.pos+=4},writeFixed64:function(t){this.realloc(8),fu(this.buf,-1&t,this.pos),fu(this.buf,Math.floor(t*(1/4294967296)),this.pos+4),this.pos+=8},writeSFixed64:function(t){this.realloc(8),fu(this.buf,-1&t,this.pos),fu(this.buf,Math.floor(t*(1/4294967296)),this.pos+4),this.pos+=8},writeVarint:function(t){(t=+t||0)>268435455||t<0?function(t,e){var n,r;if(t>=0?(n=t%4294967296|0,r=t/4294967296|0):(r=~(-t/4294967296),4294967295^(n=~(-t%4294967296))?n=n+1|0:(n=0,r=r+1|0)),t>=0x10000000000000000||t<-0x10000000000000000)throw new Error("Given varint doesn't fit into 10 bytes");e.realloc(10),function(t,e,n){n.buf[n.pos++]=127&t|128,t>>>=7,n.buf[n.pos++]=127&t|128,t>>>=7,n.buf[n.pos++]=127&t|128,t>>>=7,n.buf[n.pos++]=127&t|128,n.buf[n.pos]=127&(t>>>=7)}(n,0,e),function(t,e){var n=(7&t)<<4;e.buf[e.pos++]|=n|((t>>>=3)?128:0),t&&(e.buf[e.pos++]=127&t|((t>>>=7)?128:0),t&&(e.buf[e.pos++]=127&t|((t>>>=7)?128:0),t&&(e.buf[e.pos++]=127&t|((t>>>=7)?128:0),t&&(e.buf[e.pos++]=127&t|((t>>>=7)?128:0),t&&(e.buf[e.pos++]=127&t)))))}(r,e)}(t,this):(this.realloc(4),this.buf[this.pos++]=127&t|(t>127?128:0),t<=127||(this.buf[this.pos++]=127&(t>>>=7)|(t>127?128:0),t<=127||(this.buf[this.pos++]=127&(t>>>=7)|(t>127?128:0),t<=127||(this.buf[this.pos++]=t>>>7&127))))},writeSVarint:function(t){this.writeVarint(t<0?2*-t-1:2*t)},writeBoolean:function(t){this.writeVarint(Boolean(t))},writeString:function(t){t=String(t),this.realloc(4*t.length),this.pos++;var e=this.pos;this.pos=function(t,e,n){for(var r,i,o=0;o<e.length;o++){if((r=e.charCodeAt(o))>55295&&r<57344){if(!i){r>56319||o+1===e.length?(t[n++]=239,t[n++]=191,t[n++]=189):i=r;continue}if(r<56320){t[n++]=239,t[n++]=191,t[n++]=189,i=r;continue}r=i-55296<<10|r-56320|65536,i=null}else i&&(t[n++]=239,t[n++]=191,t[n++]=189,i=null);r<128?t[n++]=r:(r<2048?t[n++]=r>>6|192:(r<65536?t[n++]=r>>12|224:(t[n++]=r>>18|240,t[n++]=r>>12&63|128),t[n++]=r>>6&63|128),t[n++]=63&r|128)}return n}(this.buf,t,this.pos);var n=this.pos-e;n>=128&&eu(e,n,this),this.pos=e-1,this.writeVarint(n),this.pos+=n},writeFloat:function(t){this.realloc(4),Js(this.buf,t,this.pos,!0,23,4),this.pos+=4},writeDouble:function(t){this.realloc(8),Js(this.buf,t,this.pos,!0,52,8),this.pos+=8},writeBytes:function(t){var e=t.length;this.writeVarint(e),this.realloc(e);for(var n=0;n<e;n++)this.buf[this.pos++]=t[n]},writeRawMessage:function(t,e){this.pos++;var n=this.pos;t(e,this);var r=this.pos-n;r>=128&&eu(n,r,this),this.pos=n-1,this.writeVarint(r),this.pos+=r},writeMessage:function(t,e,n){this.writeTag(t,Ks.Bytes),this.writeRawMessage(e,n)},writePackedVarint:function(t,e){e.length&&this.writeMessage(t,nu,e)},writePackedSVarint:function(t,e){e.length&&this.writeMessage(t,ru,e)},writePackedBoolean:function(t,e){e.length&&this.writeMessage(t,au,e)},writePackedFloat:function(t,e){e.length&&this.writeMessage(t,iu,e)},writePackedDouble:function(t,e){e.length&&this.writeMessage(t,ou,e)},writePackedFixed32:function(t,e){e.length&&this.writeMessage(t,su,e)},writePackedSFixed32:function(t,e){e.length&&this.writeMessage(t,uu,e)},writePackedFixed64:function(t,e){e.length&&this.writeMessage(t,cu,e)},writePackedSFixed64:function(t,e){e.length&&this.writeMessage(t,lu,e)},writeBytesField:function(t,e){this.writeTag(t,Ks.Bytes),this.writeBytes(e)},writeFixed32Field:function(t,e){this.writeTag(t,Ks.Fixed32),this.writeFixed32(e)},writeSFixed32Field:function(t,e){this.writeTag(t,Ks.Fixed32),this.writeSFixed32(e)},writeFixed64Field:function(t,e){this.writeTag(t,Ks.Fixed64),this.writeFixed64(e)},writeSFixed64Field:function(t,e){this.writeTag(t,Ks.Fixed64),this.writeSFixed64(e)},writeVarintField:function(t,e){this.writeTag(t,Ks.Varint),this.writeVarint(e)},writeSVarintField:function(t,e){this.writeTag(t,Ks.Varint),this.writeSVarint(e)},writeStringField:function(t,e){this.writeTag(t,Ks.Bytes),this.writeString(e)},writeFloatField:function(t,e){this.writeTag(t,Ks.Fixed32),this.writeFloat(e)},writeDoubleField:function(t,e){this.writeTag(t,Ks.Fixed64),this.writeDouble(e)},writeBooleanField:function(t,e){this.writeVarintField(t,Boolean(e))}};var yu=function(t,e){var n=e.pixelRatio,r=e.version,i=e.stretchX,o=e.stretchY,a=e.content;this.paddedRect=t,this.pixelRatio=n,this.stretchX=i,this.stretchY=o,this.content=a,this.version=r},vu={tl:{configurable:!0},br:{configurable:!0},tlbr:{configurable:!0},displaySize:{configurable:!0}};vu.tl.get=function(){return[this.paddedRect.x+1,this.paddedRect.y+1]},vu.br.get=function(){return[this.paddedRect.x+this.paddedRect.w-1,this.paddedRect.y+this.paddedRect.h-1]},vu.tlbr.get=function(){return this.tl.concat(this.br)},vu.displaySize.get=function(){return[(this.paddedRect.w-2)/this.pixelRatio,(this.paddedRect.h-2)/this.pixelRatio]},Object.defineProperties(yu.prototype,vu);var _u=function(t,e){var n={},r={};this.haveRenderCallbacks=[];var i=[];this.addImages(t,n,i),this.addImages(e,r,i);var o=mu(i),a=new va({width:o.w||1,height:o.h||1});for(var s in t){var u=t[s],c=n[s].paddedRect;va.copy(u.data,a,{x:0,y:0},{x:c.x+1,y:c.y+1},u.data)}for(var l in e){var h=e[l],f=r[l].paddedRect,p=f.x+1,d=f.y+1,A=h.data.width,g=h.data.height;va.copy(h.data,a,{x:0,y:0},{x:p,y:d},h.data),va.copy(h.data,a,{x:0,y:g-1},{x:p,y:d-1},{width:A,height:1}),va.copy(h.data,a,{x:0,y:0},{x:p,y:d+g},{width:A,height:1}),va.copy(h.data,a,{x:A-1,y:0},{x:p-1,y:d},{width:1,height:g}),va.copy(h.data,a,{x:0,y:0},{x:p+A,y:d},{width:1,height:g})}this.image=a,this.iconPositions=n,this.patternPositions=r};_u.prototype.addImages=function(t,e,n){for(var r in t){var i=t[r],o={x:0,y:0,w:i.data.width+2,h:i.data.height+2};n.push(o),e[r]=new yu(o,i),i.hasRenderCallback&&this.haveRenderCallbacks.push(r)}},_u.prototype.patchUpdatedImages=function(t,e){for(var n in t.dispatchRenderCallbacks(this.haveRenderCallbacks),t.updatedImages)this.patchUpdatedImage(this.iconPositions[n],t.getImage(n),e),this.patchUpdatedImage(this.patternPositions[n],t.getImage(n),e)},_u.prototype.patchUpdatedImage=function(t,e,n){if(t&&e&&t.version!==e.version){t.version=e.version;var r=t.tl;n.update(e.data,void 0,{x:r[0],y:r[1]})}},Fr("ImagePosition",yu),Fr("ImageAtlas",_u);var bu={horizontal:1,vertical:2,horizontalOnly:3},xu=function(){this.scale=1,this.fontStack="",this.imageName=null};xu.forText=function(t,e){var n=new xu;return n.scale=t||1,n.fontStack=e,n},xu.forImage=function(t){var e=new xu;return e.imageName=t,e};var wu=function(){this.text="",this.sectionIndex=[],this.sections=[],this.imageSectionID=null};function Eu(t,e,n,r,i,o,a,s,u,c,l,h,f,p,d,A){var g,m=wu.fromFeature(t,i);h===bu.vertical&&m.verticalizePunctuation();var y=ai.processBidirectionalText,v=ai.processStyledBidirectionalText;if(y&&1===m.sections.length){g=[];for(var _=0,b=y(m.toString(),Iu(m,c,o,e,r,p,d));_<b.length;_+=1){var x=b[_],w=new wu;w.text=x,w.sections=m.sections;for(var E=0;E<x.length;E++)w.sectionIndex.push(0);g.push(w)}}else if(v){g=[];for(var O=0,S=v(m.text,m.sectionIndex,Iu(m,c,o,e,r,p,d));O<S.length;O+=1){var T=S[O],C=new wu;C.text=T[0],C.sectionIndex=T[1],C.sections=m.sections,g.push(C)}}else g=function(t,e){for(var n=[],r=t.text,i=0,o=0,a=e;o<a.length;o+=1){var s=a[o];n.push(t.substring(i,s)),i=s}return i<r.length&&n.push(t.substring(i,r.length)),n}(m,Iu(m,c,o,e,r,p,d));var P=[],M={positionedLines:P,text:m.toString(),top:l[1],bottom:l[1],left:l[0],right:l[0],writingMode:h,iconsInText:!1,verticalizable:!1};return function(t,e,n,r,i,o,a,s,u,c,l,h){for(var f=0,p=-17,d=0,A=0,g="right"===s?1:"left"===s?0:.5,m=0,y=0,v=i;y<v.length;y+=1){var _=v[y];_.trim();var b=_.getMaxScale(),x=24*(b-1),w={positionedGlyphs:[],lineOffset:0};t.positionedLines[m]=w;var E=w.positionedGlyphs,O=0;if(_.length()){for(var S=0;S<_.length();S++){var T=_.getSection(S),C=_.getSectionIndex(S),P=_.getCharCode(S),M=0,I=null,B=null,R=null,k=24,D=!(u===bu.horizontal||!l&&!Xr(P)||l&&(Ou[P]||(H=P,Wr.Arabic(H)||Wr["Arabic Supplement"](H)||Wr["Arabic Extended-A"](H)||Wr["Arabic Presentation Forms-A"](H)||Wr["Arabic Presentation Forms-B"](H))));if(T.imageName){var L=r[T.imageName];if(!L)continue;R=T.imageName,t.iconsInText=t.iconsInText||!0,B=L.paddedRect;var j=L.displaySize;T.scale=24*T.scale/h,M=x+(24-j[1]*T.scale),k=(I={width:j[0],height:j[1],left:1,top:-3,advance:D?j[1]:j[0]}).advance;var F=D?j[0]*T.scale-24*b:j[1]*T.scale-24*b;F>0&&F>O&&(O=F)}else{var z=n[T.fontStack],U=z&&z[P];if(U&&U.rect)B=U.rect,I=U.metrics;else{var N=e[T.fontStack],G=N&&N[P];if(!G)continue;I=G.metrics}M=24*(b-T.scale)}D?(t.verticalizable=!0,E.push({glyph:P,imageName:R,x:f,y:p+M,vertical:D,scale:T.scale,fontStack:T.fontStack,sectionIndex:C,metrics:I,rect:B}),f+=k*T.scale+c):(E.push({glyph:P,imageName:R,x:f,y:p+M,vertical:D,scale:T.scale,fontStack:T.fontStack,sectionIndex:C,metrics:I,rect:B}),f+=I.advance*T.scale+c)}0!==E.length&&(d=Math.max(f-c,d),Ru(E,0,E.length-1,g,O)),f=0;var V=o*b+O;w.lineOffset=Math.max(O,x),p+=V,A=Math.max(V,A),++m}else p+=o,++m}var H,W=p- -17,q=Bu(a),X=q.horizontalAlign,Z=q.verticalAlign;(function(t,e,n,r,i,o,a,s,u){var c,l=(e-n)*i;c=o!==a?-s*r- -17:(-r*u+.5)*a;for(var h=0,f=t;h<f.length;h+=1)for(var p=0,d=f[h].positionedGlyphs;p<d.length;p+=1){var A=d[p];A.x+=l,A.y+=c}})(t.positionedLines,g,X,Z,d,A,o,W,i.length),t.top+=-Z*W,t.bottom=t.top+W,t.left+=-X*d,t.right=t.left+d}(M,e,n,r,g,a,s,u,h,c,f,A),!function(t){for(var e=0,n=t;e<n.length;e+=1)if(0!==n[e].positionedGlyphs.length)return!1;return!0}(P)&&M}wu.fromFeature=function(t,e){for(var n=new wu,r=0;r<t.sections.length;r++){var i=t.sections[r];i.image?n.addImageSection(i):n.addTextSection(i,e)}return n},wu.prototype.length=function(){return this.text.length},wu.prototype.getSection=function(t){return this.sections[this.sectionIndex[t]]},wu.prototype.getSectionIndex=function(t){return this.sectionIndex[t]},wu.prototype.getCharCode=function(t){return this.text.charCodeAt(t)},wu.prototype.verticalizePunctuation=function(){this.text=function(t){for(var e="",n=0;n<t.length;n++){var r=t.charCodeAt(n+1)||null,i=t.charCodeAt(n-1)||null;e+=r&&Zr(r)&&!Xs[t[n+1]]||i&&Zr(i)&&!Xs[t[n-1]]||!Xs[t[n]]?t[n]:Xs[t[n]]}return e}(this.text)},wu.prototype.trim=function(){for(var t=0,e=0;e<this.text.length&&Ou[this.text.charCodeAt(e)];e++)t++;for(var n=this.text.length,r=this.text.length-1;r>=0&&r>=t&&Ou[this.text.charCodeAt(r)];r--)n--;this.text=this.text.substring(t,n),this.sectionIndex=this.sectionIndex.slice(t,n)},wu.prototype.substring=function(t,e){var n=new wu;return n.text=this.text.substring(t,e),n.sectionIndex=this.sectionIndex.slice(t,e),n.sections=this.sections,n},wu.prototype.toString=function(){return this.text},wu.prototype.getMaxScale=function(){var t=this;return this.sectionIndex.reduce((function(e,n){return Math.max(e,t.sections[n].scale)}),0)},wu.prototype.addTextSection=function(t,e){this.text+=t.text,this.sections.push(xu.forText(t.scale,t.fontStack||e));for(var n=this.sections.length-1,r=0;r<t.text.length;++r)this.sectionIndex.push(n)},wu.prototype.addImageSection=function(t){var e=t.image?t.image.name:"";if(0!==e.length){var n=this.getNextImageSectionCharCode();n?(this.text+=String.fromCharCode(n),this.sections.push(xu.forImage(e)),this.sectionIndex.push(this.sections.length-1)):w("Reached maximum number of images 6401")}else w("Can't add FormattedSection with an empty image.")},wu.prototype.getNextImageSectionCharCode=function(){return this.imageSectionID?this.imageSectionID>=63743?null:++this.imageSectionID:(this.imageSectionID=57344,this.imageSectionID)};var Ou={9:!0,10:!0,11:!0,12:!0,13:!0,32:!0},Su={};function Tu(t,e,n,r,i,o){if(e.imageName){var a=r[e.imageName];return a?a.displaySize[0]*e.scale*24/o+i:0}var s=n[e.fontStack],u=s&&s[t];return u?u.metrics.advance*e.scale+i:0}function Cu(t,e,n,r){var i=Math.pow(t-e,2);return r?t<e?i/2:2*i:i+Math.abs(n)*n}function Pu(t,e,n){var r=0;return 10===t&&(r-=1e4),n&&(r+=150),40!==t&&65288!==t||(r+=50),41!==e&&65289!==e||(r+=50),r}function Mu(t,e,n,r,i,o){for(var a=null,s=Cu(e,n,i,o),u=0,c=r;u<c.length;u+=1){var l=c[u],h=Cu(e-l.x,n,i,o)+l.badness;h<=s&&(a=l,s=h)}return{index:t,x:e,priorBreak:a,badness:s}}function Iu(t,e,n,r,i,o,a){if("point"!==o)return[];if(!t)return[];for(var s,u=[],c=function(t,e,n,r,i,o){for(var a=0,s=0;s<t.length();s++){var u=t.getSection(s);a+=Tu(t.getCharCode(s),u,r,i,e,o)}return a/Math.max(1,Math.ceil(a/n))}(t,e,n,r,i,a),l=t.text.indexOf("​")>=0,h=0,f=0;f<t.length();f++){var p=t.getSection(f),d=t.getCharCode(f);if(Ou[d]||(h+=Tu(d,p,r,i,e,a)),f<t.length()-1){var A=!((s=d)<11904||!(Wr["Bopomofo Extended"](s)||Wr.Bopomofo(s)||Wr["CJK Compatibility Forms"](s)||Wr["CJK Compatibility Ideographs"](s)||Wr["CJK Compatibility"](s)||Wr["CJK Radicals Supplement"](s)||Wr["CJK Strokes"](s)||Wr["CJK Symbols and Punctuation"](s)||Wr["CJK Unified Ideographs Extension A"](s)||Wr["CJK Unified Ideographs"](s)||Wr["Enclosed CJK Letters and Months"](s)||Wr["Halfwidth and Fullwidth Forms"](s)||Wr.Hiragana(s)||Wr["Ideographic Description Characters"](s)||Wr["Kangxi Radicals"](s)||Wr["Katakana Phonetic Extensions"](s)||Wr.Katakana(s)||Wr["Vertical Forms"](s)||Wr["Yi Radicals"](s)||Wr["Yi Syllables"](s)));(Su[d]||A||p.imageName)&&u.push(Mu(f+1,h,c,u,Pu(d,t.getCharCode(f+1),A&&l),!1))}}return function t(e){return e?t(e.priorBreak).concat(e.index):[]}(Mu(t.length(),h,c,u,0,!0))}function Bu(t){var e=.5,n=.5;switch(t){case"right":case"top-right":case"bottom-right":e=1;break;case"left":case"top-left":case"bottom-left":e=0}switch(t){case"bottom":case"bottom-right":case"bottom-left":n=1;break;case"top":case"top-right":case"top-left":n=0}return{horizontalAlign:e,verticalAlign:n}}function Ru(t,e,n,r,i){if(r||i)for(var o=t[n],a=(t[n].x+o.metrics.advance*o.scale)*r,s=e;s<=n;s++)t[s].x-=a,t[s].y+=i}function ku(t,e,n,r,i,o){var a,s=t.image;if(s.content){var u=s.content,c=s.pixelRatio||1;a=[u[0]/c,u[1]/c,s.displaySize[0]-u[2]/c,s.displaySize[1]-u[3]/c]}var l,h,f,p,d=e.left*o,A=e.right*o;"width"===n||"both"===n?(p=i[0]+d-r[3],h=i[0]+A+r[1]):h=(p=i[0]+(d+A-s.displaySize[0])/2)+s.displaySize[0];var g=e.top*o,m=e.bottom*o;return"height"===n||"both"===n?(l=i[1]+g-r[0],f=i[1]+m+r[2]):f=(l=i[1]+(g+m-s.displaySize[1])/2)+s.displaySize[1],{image:s,top:l,right:h,bottom:f,left:p,collisionPadding:a}}Su[10]=!0,Su[32]=!0,Su[38]=!0,Su[40]=!0,Su[41]=!0,Su[43]=!0,Su[45]=!0,Su[47]=!0,Su[173]=!0,Su[183]=!0,Su[8203]=!0,Su[8208]=!0,Su[8211]=!0,Su[8231]=!0;var Du=function(t){function e(e,n,r,i){t.call(this,e,n),this.angle=r,void 0!==i&&(this.segment=i)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.clone=function(){return new e(this.x,this.y,this.angle,this.segment)},e}(i);function Lu(t,e){var n=e.expression;if("constant"===n.kind)return{kind:"constant",layoutSize:n.evaluate(new si(t+1))};if("source"===n.kind)return{kind:"source"};for(var r=n.zoomStops,i=n.interpolationType,o=0;o<r.length&&r[o]<=t;)o++;for(var a=o=Math.max(0,o-1);a<r.length&&r[a]<t+1;)a++;a=Math.min(r.length-1,a);var s=r[o],u=r[a];return"composite"===n.kind?{kind:"composite",minZoom:s,maxZoom:u,interpolationType:i}:{kind:"camera",minZoom:s,maxZoom:u,minSize:n.evaluate(new si(s)),maxSize:n.evaluate(new si(u)),interpolationType:i}}function ju(t,e,n){var r=e.uSize,i=n.lowerSize;return"source"===t.kind?i/128:"composite"===t.kind?He(i/128,n.upperSize/128,e.uSizeT):r}function Fu(t,e){var n=0,r=0;if("constant"===t.kind)r=t.layoutSize;else if("source"!==t.kind){var i=t.interpolationType,o=i?l(an.interpolationFactor(i,e,t.minZoom,t.maxZoom),0,1):0;"camera"===t.kind?r=He(t.minSize,t.maxSize,o):n=o}return{uSizeT:n,uSize:r}}Fr("Anchor",Du);var zu=Object.freeze({__proto__:null,getSizeData:Lu,evaluateSizeForFeature:ju,evaluateSizeForZoom:Fu,SIZE_PACK_FACTOR:128});function Uu(t,e,n,r,i){if(void 0===e.segment)return!0;for(var o=e,a=e.segment+1,s=0;s>-n/2;){if(--a<0)return!1;s-=t[a].dist(o),o=t[a]}s+=t[a].dist(t[a+1]),a++;for(var u=[],c=0;s<n/2;){var l=t[a],h=t[a+1];if(!h)return!1;var f=t[a-1].angleTo(l)-l.angleTo(h);for(f=Math.abs((f+3*Math.PI)%(2*Math.PI)-Math.PI),u.push({distance:s,angleDelta:f}),c+=f;s-u[0].distance>r;)c-=u.shift().angleDelta;if(c>i)return!1;a++,s+=l.dist(h)}return!0}function Nu(t){for(var e=0,n=0;n<t.length-1;n++)e+=t[n].dist(t[n+1]);return e}function Gu(t,e,n){return t?.6*e*n:0}function Vu(t,e){return Math.max(t?t.right-t.left:0,e?e.right-e.left:0)}function Hu(t,e,n,r,i,o){for(var a=Gu(n,i,o),s=Vu(n,r)*o,u=0,c=Nu(t)/2,l=0;l<t.length-1;l++){var h=t[l],f=t[l+1],p=h.dist(f);if(u+p>c){var d=(c-u)/p,A=He(h.x,f.x,d),g=He(h.y,f.y,d),m=new Du(A,g,f.angleTo(h),l);return m._round(),!a||Uu(t,m,s,a,e)?m:void 0}u+=p}}function Wu(t,e,n,r,i,o,a,s,u){var c=Gu(r,o,a),l=Vu(r,i),h=l*a,f=0===t[0].x||t[0].x===u||0===t[0].y||t[0].y===u;return e-h<e/4&&(e=h+e/4),function t(e,n,r,i,o,a,s,u,c){for(var l=a/2,h=Nu(e),f=0,p=n-r,d=[],A=0;A<e.length-1;A++){for(var g=e[A],m=e[A+1],y=g.dist(m),v=m.angleTo(g);p+r<f+y;){var _=((p+=r)-f)/y,b=He(g.x,m.x,_),x=He(g.y,m.y,_);if(b>=0&&b<c&&x>=0&&x<c&&p-l>=0&&p+l<=h){var w=new Du(b,x,v,A);w._round(),i&&!Uu(e,w,a,i,o)||d.push(w)}}f+=y}return u||d.length||s||(d=t(e,f/2,r,i,o,a,s,!0,c)),d}(t,f?e/2*s%e:(l/2+2*o)*a*s%e,e,c,n,h,f,!1,u)}function qu(t,e,n,r,o){for(var a=[],s=0;s<t.length;s++)for(var u=t[s],c=void 0,l=0;l<u.length-1;l++){var h=u[l],f=u[l+1];h.x<e&&f.x<e||(h.x<e?h=new i(e,h.y+(e-h.x)/(f.x-h.x)*(f.y-h.y))._round():f.x<e&&(f=new i(e,h.y+(e-h.x)/(f.x-h.x)*(f.y-h.y))._round()),h.y<n&&f.y<n||(h.y<n?h=new i(h.x+(n-h.y)/(f.y-h.y)*(f.x-h.x),n)._round():f.y<n&&(f=new i(h.x+(n-h.y)/(f.y-h.y)*(f.x-h.x),n)._round()),h.x>=r&&f.x>=r||(h.x>=r?h=new i(r,h.y+(r-h.x)/(f.x-h.x)*(f.y-h.y))._round():f.x>=r&&(f=new i(r,h.y+(r-h.x)/(f.x-h.x)*(f.y-h.y))._round()),h.y>=o&&f.y>=o||(h.y>=o?h=new i(h.x+(o-h.y)/(f.y-h.y)*(f.x-h.x),o)._round():f.y>=o&&(f=new i(h.x+(o-h.y)/(f.y-h.y)*(f.x-h.x),o)._round()),c&&h.equals(c[c.length-1])||a.push(c=[h]),c.push(f)))))}return a}function Xu(t,e,n,r){var o=[],a=t.image,s=a.pixelRatio,u=a.paddedRect.w-2,c=a.paddedRect.h-2,l=t.right-t.left,h=t.bottom-t.top,f=a.stretchX||[[0,u]],p=a.stretchY||[[0,c]],d=function(t,e){return t+e[1]-e[0]},A=f.reduce(d,0),g=p.reduce(d,0),m=u-A,y=c-g,v=0,_=A,b=0,x=g,w=0,E=m,O=0,S=y;if(a.content&&r){var T=a.content;v=Zu(f,0,T[0]),b=Zu(p,0,T[1]),_=Zu(f,T[0],T[2]),x=Zu(p,T[1],T[3]),w=T[0]-v,O=T[1]-b,E=T[2]-T[0]-_,S=T[3]-T[1]-x}var C=function(r,o,u,c){var f=Qu(r.stretch-v,_,l,t.left),p=Ku(r.fixed-w,E,r.stretch,A),d=Qu(o.stretch-b,x,h,t.top),m=Ku(o.fixed-O,S,o.stretch,g),y=Qu(u.stretch-v,_,l,t.left),T=Ku(u.fixed-w,E,u.stretch,A),C=Qu(c.stretch-b,x,h,t.top),P=Ku(c.fixed-O,S,c.stretch,g),M=new i(f,d),I=new i(y,d),B=new i(y,C),R=new i(f,C),k=new i(p/s,m/s),D=new i(T/s,P/s),L=e*Math.PI/180;if(L){var j=Math.sin(L),F=Math.cos(L),z=[F,-j,j,F];M._matMult(z),I._matMult(z),R._matMult(z),B._matMult(z)}var U=r.stretch+r.fixed,N=o.stretch+o.fixed;return{tl:M,tr:I,bl:R,br:B,tex:{x:a.paddedRect.x+1+U,y:a.paddedRect.y+1+N,w:u.stretch+u.fixed-U,h:c.stretch+c.fixed-N},writingMode:void 0,glyphOffset:[0,0],sectionIndex:0,pixelOffsetTL:k,pixelOffsetBR:D,minFontScaleX:E/s/l,minFontScaleY:S/s/h,isSDF:n}};if(r&&(a.stretchX||a.stretchY))for(var P=Ju(f,m,A),M=Ju(p,y,g),I=0;I<P.length-1;I++)for(var B=P[I],R=P[I+1],k=0;k<M.length-1;k++)o.push(C(B,M[k],R,M[k+1]));else o.push(C({fixed:0,stretch:-1},{fixed:0,stretch:-1},{fixed:0,stretch:u+1},{fixed:0,stretch:c+1}));return o}function Zu(t,e,n){for(var r=0,i=0,o=t;i<o.length;i+=1){var a=o[i];r+=Math.max(e,Math.min(n,a[1]))-Math.max(e,Math.min(n,a[0]))}return r}function Ju(t,e,n){for(var r=[{fixed:-1,stretch:0}],i=0,o=t;i<o.length;i+=1){var a=o[i],s=a[0],u=a[1],c=r[r.length-1];r.push({fixed:s-c.stretch,stretch:c.stretch}),r.push({fixed:s-c.stretch,stretch:c.stretch+(u-s)})}return r.push({fixed:e+1,stretch:n}),r}function Qu(t,e,n,r){return t/e*n+r}function Ku(t,e,n,r){return t-e*n/r}var Yu=function(t,e,n,r,o,a,s,u,c,l){if(this.boxStartIndex=t.length,c){var h=a.top,f=a.bottom,p=a.collisionPadding;p&&(h-=p[1],f+=p[3]);var d=f-h;d>0&&(d=Math.max(10,d),this.circleDiameter=d)}else{var A=a.top*s-u,g=a.bottom*s+u,m=a.left*s-u,y=a.right*s+u,v=a.collisionPadding;if(v&&(m-=v[0]*s,A-=v[1]*s,y+=v[2]*s,g+=v[3]*s),l){var _=new i(m,A),b=new i(y,A),x=new i(m,g),w=new i(y,g),E=l*Math.PI/180;_._rotate(E),b._rotate(E),x._rotate(E),w._rotate(E),m=Math.min(_.x,b.x,x.x,w.x),y=Math.max(_.x,b.x,x.x,w.x),A=Math.min(_.y,b.y,x.y,w.y),g=Math.max(_.y,b.y,x.y,w.y)}t.emplaceBack(e.x,e.y,m,A,y,g,n,r,o)}this.boxEndIndex=t.length},$u=function(t,e){if(void 0===t&&(t=[]),void 0===e&&(e=tc),this.data=t,this.length=this.data.length,this.compare=e,this.length>0)for(var n=(this.length>>1)-1;n>=0;n--)this._down(n)};function tc(t,e){return t<e?-1:t>e?1:0}function ec(t,e,n){void 0===e&&(e=1),void 0===n&&(n=!1);for(var r=1/0,o=1/0,a=-1/0,s=-1/0,u=t[0],c=0;c<u.length;c++){var l=u[c];(!c||l.x<r)&&(r=l.x),(!c||l.y<o)&&(o=l.y),(!c||l.x>a)&&(a=l.x),(!c||l.y>s)&&(s=l.y)}var h=Math.min(a-r,s-o),f=h/2,p=new $u([],nc);if(0===h)return new i(r,o);for(var d=r;d<a;d+=h)for(var A=o;A<s;A+=h)p.push(new rc(d+f,A+f,f,t));for(var g=function(t){for(var e=0,n=0,r=0,i=t[0],o=0,a=i.length,s=a-1;o<a;s=o++){var u=i[o],c=i[s],l=u.x*c.y-c.x*u.y;n+=(u.x+c.x)*l,r+=(u.y+c.y)*l,e+=3*l}return new rc(n/e,r/e,0,t)}(t),m=p.length;p.length;){var y=p.pop();(y.d>g.d||!g.d)&&(g=y,n&&console.log("found best %d after %d probes",Math.round(1e4*y.d)/1e4,m)),y.max-g.d<=e||(p.push(new rc(y.p.x-(f=y.h/2),y.p.y-f,f,t)),p.push(new rc(y.p.x+f,y.p.y-f,f,t)),p.push(new rc(y.p.x-f,y.p.y+f,f,t)),p.push(new rc(y.p.x+f,y.p.y+f,f,t)),m+=4)}return n&&(console.log("num probes: "+m),console.log("best distance: "+g.d)),g.p}function nc(t,e){return e.max-t.max}function rc(t,e,n,r){this.p=new i(t,e),this.h=n,this.d=function(t,e){for(var n=!1,r=1/0,i=0;i<e.length;i++)for(var o=e[i],a=0,s=o.length,u=s-1;a<s;u=a++){var c=o[a],l=o[u];c.y>t.y!=l.y>t.y&&t.x<(l.x-c.x)*(t.y-c.y)/(l.y-c.y)+c.x&&(n=!n),r=Math.min(r,Ko(t,c,l))}return(n?1:-1)*Math.sqrt(r)}(this.p,r),this.max=this.d+this.h*Math.SQRT2}$u.prototype.push=function(t){this.data.push(t),this.length++,this._up(this.length-1)},$u.prototype.pop=function(){if(0!==this.length){var t=this.data[0],e=this.data.pop();return this.length--,this.length>0&&(this.data[0]=e,this._down(0)),t}},$u.prototype.peek=function(){return this.data[0]},$u.prototype._up=function(t){for(var e=this.data,n=this.compare,r=e[t];t>0;){var i=t-1>>1,o=e[i];if(n(r,o)>=0)break;e[t]=o,t=i}e[t]=r},$u.prototype._down=function(t){for(var e=this.data,n=this.compare,r=this.length>>1,i=e[t];t<r;){var o=1+(t<<1),a=e[o],s=o+1;if(s<this.length&&n(e[s],a)<0&&(o=s,a=e[s]),n(a,i)>=0)break;e[t]=a,t=o}e[t]=i};var ic=Number.POSITIVE_INFINITY;function oc(t,e){return e[1]!==ic?function(t,e,n){var r=0,i=0;switch(e=Math.abs(e),n=Math.abs(n),t){case"top-right":case"top-left":case"top":i=n-7;break;case"bottom-right":case"bottom-left":case"bottom":i=7-n}switch(t){case"top-right":case"bottom-right":case"right":r=-e;break;case"top-left":case"bottom-left":case"left":r=e}return[r,i]}(t,e[0],e[1]):function(t,e){var n=0,r=0;e<0&&(e=0);var i=e/Math.sqrt(2);switch(t){case"top-right":case"top-left":r=i-7;break;case"bottom-right":case"bottom-left":r=7-i;break;case"bottom":r=7-e;break;case"top":r=e-7}switch(t){case"top-right":case"bottom-right":n=-i;break;case"top-left":case"bottom-left":n=i;break;case"left":n=e;break;case"right":n=-e}return[n,r]}(t,e[0])}function ac(t){switch(t){case"right":case"top-right":case"bottom-right":return"right";case"left":case"top-left":case"bottom-left":return"left"}return"center"}function sc(t,e,n,r,o,a,s,u,c,l,h,f,p,d,A){var g=function(t,e,n,r,o,a,s,u){for(var c=r.layout.get("text-rotate").evaluate(a,{})*Math.PI/180,l=[],h=0,f=e.positionedLines;h<f.length;h+=1)for(var p=f[h],d=0,A=p.positionedGlyphs;d<A.length;d+=1){var g=A[d];if(g.rect){var m=g.rect||{},y=4,v=!0,_=1,b=0,x=(o||u)&&g.vertical,w=g.metrics.advance*g.scale/2;if(u&&e.verticalizable&&(b=p.lineOffset/2-(g.imageName?-(24-g.metrics.width*g.scale)/2:24*(g.scale-1))),g.imageName){var E=s[g.imageName];v=E.sdf,y=1/(_=E.pixelRatio)}var O=o?[g.x+w,g.y]:[0,0],S=o?[0,0]:[g.x+w+n[0],g.y+n[1]-b],T=[0,0];x&&(T=S,S=[0,0]);var C=(g.metrics.left-y)*g.scale-w+S[0],P=(-g.metrics.top-y)*g.scale+S[1],M=C+m.w*g.scale/_,I=P+m.h*g.scale/_,B=new i(C,P),R=new i(M,P),k=new i(C,I),D=new i(M,I);if(x){var L=new i(-w,w- -17),j=-Math.PI/2,F=12-w,z=new i(22-F,-(g.imageName?F:0)),U=new(Function.prototype.bind.apply(i,[null].concat(T)));B._rotateAround(j,L)._add(z)._add(U),R._rotateAround(j,L)._add(z)._add(U),k._rotateAround(j,L)._add(z)._add(U),D._rotateAround(j,L)._add(z)._add(U)}if(c){var N=Math.sin(c),G=Math.cos(c),V=[G,-N,N,G];B._matMult(V),R._matMult(V),k._matMult(V),D._matMult(V)}var H=new i(0,0),W=new i(0,0);l.push({tl:B,tr:R,bl:k,br:D,tex:m,writingMode:e.writingMode,glyphOffset:O,sectionIndex:g.sectionIndex,isSDF:v,pixelOffsetTL:H,pixelOffsetBR:W,minFontScaleX:0,minFontScaleY:0})}}return l}(0,n,u,o,a,s,r,t.allowVerticalPlacement),m=t.textSizeData,y=null;"source"===m.kind?(y=[128*o.layout.get("text-size").evaluate(s,{})])[0]>32640&&w(t.layerIds[0]+': Value for "text-size" is >= 255. Reduce your "text-size".'):"composite"===m.kind&&((y=[128*d.compositeTextSizes[0].evaluate(s,{},A),128*d.compositeTextSizes[1].evaluate(s,{},A)])[0]>32640||y[1]>32640)&&w(t.layerIds[0]+': Value for "text-size" is >= 255. Reduce your "text-size".'),t.addSymbols(t.text,g,y,u,a,s,l,e,c.lineStartIndex,c.lineLength,p,A);for(var v=0,_=h;v<_.length;v+=1)f[_[v]]=t.text.placedSymbolArray.length-1;return 4*g.length}function uc(t){for(var e in t)return t[e];return null}function cc(t,e,n,r){var i=t.compareText;if(e in i){for(var o=i[e],a=o.length-1;a>=0;a--)if(r.dist(o[a])<n)return!0}else i[e]=[];return i[e].push(r),!1}var lc=_s.VectorTileFeature.types,hc=[{name:"a_fade_opacity",components:1,type:"Uint8",offset:0}];function fc(t,e,n,r,i,o,a,s,u,c,l,h,f){var p=s?Math.min(32640,Math.round(s[0])):0,d=s?Math.min(32640,Math.round(s[1])):0;t.emplaceBack(e,n,Math.round(32*r),Math.round(32*i),o,a,(p<<1)+(u?1:0),d,16*c,16*l,256*h,256*f)}function pc(t,e,n){t.emplaceBack(e.x,e.y,n),t.emplaceBack(e.x,e.y,n),t.emplaceBack(e.x,e.y,n),t.emplaceBack(e.x,e.y,n)}function dc(t){for(var e=0,n=t.sections;e<n.length;e+=1)if(Kr(n[e].text))return!0;return!1}var Ac=function(t){this.layoutVertexArray=new ki,this.indexArray=new Ni,this.programConfigurations=t,this.segments=new so,this.dynamicLayoutVertexArray=new Di,this.opacityVertexArray=new Li,this.placedSymbolArray=new $i};Ac.prototype.isEmpty=function(){return 0===this.layoutVertexArray.length&&0===this.indexArray.length&&0===this.dynamicLayoutVertexArray.length&&0===this.opacityVertexArray.length},Ac.prototype.upload=function(t,e,n,r){this.isEmpty()||(n&&(this.layoutVertexBuffer=t.createVertexBuffer(this.layoutVertexArray,Ns.members),this.indexBuffer=t.createIndexBuffer(this.indexArray,e),this.dynamicLayoutVertexBuffer=t.createVertexBuffer(this.dynamicLayoutVertexArray,Gs.members,!0),this.opacityVertexBuffer=t.createVertexBuffer(this.opacityVertexArray,hc,!0),this.opacityVertexBuffer.itemSize=1),(n||r)&&this.programConfigurations.upload(t))},Ac.prototype.destroy=function(){this.layoutVertexBuffer&&(this.layoutVertexBuffer.destroy(),this.indexBuffer.destroy(),this.programConfigurations.destroy(),this.segments.destroy(),this.dynamicLayoutVertexBuffer.destroy(),this.opacityVertexBuffer.destroy())},Fr("SymbolBuffers",Ac);var gc=function(t,e,n){this.layoutVertexArray=new t,this.layoutAttributes=e,this.indexArray=new n,this.segments=new so,this.collisionVertexArray=new Ui};gc.prototype.upload=function(t){this.layoutVertexBuffer=t.createVertexBuffer(this.layoutVertexArray,this.layoutAttributes),this.indexBuffer=t.createIndexBuffer(this.indexArray),this.collisionVertexBuffer=t.createVertexBuffer(this.collisionVertexArray,Vs.members,!0)},gc.prototype.destroy=function(){this.layoutVertexBuffer&&(this.layoutVertexBuffer.destroy(),this.indexBuffer.destroy(),this.segments.destroy(),this.collisionVertexBuffer.destroy())},Fr("CollisionBuffers",gc);var mc=function(t){this.collisionBoxArray=t.collisionBoxArray,this.zoom=t.zoom,this.overscaling=t.overscaling,this.layers=t.layers,this.layerIds=this.layers.map((function(t){return t.id})),this.index=t.index,this.pixelRatio=t.pixelRatio,this.sourceLayerIndex=t.sourceLayerIndex,this.hasPattern=!1,this.hasRTLText=!1,this.sortKeyRanges=[],this.collisionCircleArray=[],this.placementInvProjMatrix=sa([]),this.placementViewportMatrix=sa([]);var e=this.layers[0]._unevaluatedLayout._values;this.textSizeData=Lu(this.zoom,e["text-size"]),this.iconSizeData=Lu(this.zoom,e["icon-size"]);var n=this.layers[0].layout,r=n.get("symbol-sort-key"),i=n.get("symbol-z-order");this.canOverlap=n.get("text-allow-overlap")||n.get("icon-allow-overlap")||n.get("text-ignore-placement")||n.get("icon-ignore-placement"),this.sortFeaturesByKey="viewport-y"!==i&&void 0!==r.constantOr(1),this.sortFeaturesByY=("viewport-y"===i||"auto"===i&&!this.sortFeaturesByKey)&&this.canOverlap,"point"===n.get("symbol-placement")&&(this.writingModes=n.get("text-writing-mode").map((function(t){return bu[t]}))),this.stateDependentLayerIds=this.layers.filter((function(t){return t.isStateDependent()})).map((function(t){return t.id})),this.sourceID=t.sourceID};mc.prototype.createArrays=function(){this.text=new Ac(new Do(this.layers,this.zoom,(function(t){return/^text/.test(t)}))),this.icon=new Ac(new Do(this.layers,this.zoom,(function(t){return/^icon/.test(t)}))),this.glyphOffsetArray=new no,this.lineVertexArray=new ro,this.symbolInstances=new eo},mc.prototype.calculateGlyphDependencies=function(t,e,n,r,i){for(var o=0;o<t.length;o++)if(e[t.charCodeAt(o)]=!0,(n||r)&&i){var a=Xs[t.charAt(o)];a&&(e[a.charCodeAt(0)]=!0)}},mc.prototype.populate=function(t,e,n){var r=this.layers[0],i=r.layout,o=i.get("text-font"),a=i.get("text-field"),s=i.get("icon-image"),u=("constant"!==a.value.kind||a.value.value instanceof re&&!a.value.value.isEmpty()||a.value.value.toString().length>0)&&("constant"!==o.value.kind||o.value.value.length>0),c="constant"!==s.value.kind||!!s.value.value||Object.keys(s.parameters).length>0,l=i.get("symbol-sort-key");if(this.features=[],u||c){for(var h=e.iconDependencies,f=e.glyphDependencies,p=e.availableImages,d=new si(this.zoom),A=0,g=t;A<g.length;A+=1){var m=g[A],y=m.feature,v=m.id,_=m.index,b=m.sourceLayerIndex,x=r._featureFilter.needGeometry,w=No(y,x);if(r._featureFilter.filter(d,w,n)){x||(w.geometry=Uo(y));var E=void 0;if(u){var O=r.getValueAndResolveTokens("text-field",w,n,p),S=re.factory(O);dc(S)&&(this.hasRTLText=!0),(!this.hasRTLText||"unavailable"===ii()||this.hasRTLText&&ai.isParsed())&&(E=qs(S,r,w))}var T=void 0;if(c){var C=r.getValueAndResolveTokens("icon-image",w,n,p);T=C instanceof ie?C:ie.fromString(C)}if(E||T){var P=this.sortFeaturesByKey?l.evaluate(w,{},n):void 0;if(this.features.push({id:v,text:E,icon:T,index:_,sourceLayerIndex:b,geometry:w.geometry,properties:y.properties,type:lc[y.type],sortKey:P}),T&&(h[T.name]=!0),E){var M=o.evaluate(w,{},n).join(","),I="map"===i.get("text-rotation-alignment")&&"point"!==i.get("symbol-placement");this.allowVerticalPlacement=this.writingModes&&this.writingModes.indexOf(bu.vertical)>=0;for(var B=0,R=E.sections;B<R.length;B+=1){var k=R[B];if(k.image)h[k.image.name]=!0;else{var D=qr(E.toString()),L=k.fontStack||M,j=f[L]=f[L]||{};this.calculateGlyphDependencies(k.text,j,I,this.allowVerticalPlacement,D)}}}}}}"line"===i.get("symbol-placement")&&(this.features=function(t){var e={},n={},r=[],i=0;function o(e){r.push(t[e]),i++}function a(t,e,i){var o=n[t];return delete n[t],n[e]=o,r[o].geometry[0].pop(),r[o].geometry[0]=r[o].geometry[0].concat(i[0]),o}function s(t,n,i){var o=e[n];return delete e[n],e[t]=o,r[o].geometry[0].shift(),r[o].geometry[0]=i[0].concat(r[o].geometry[0]),o}function u(t,e,n){var r=n?e[0][e[0].length-1]:e[0][0];return t+":"+r.x+":"+r.y}for(var c=0;c<t.length;c++){var l=t[c],h=l.geometry,f=l.text?l.text.toString():null;if(f){var p=u(f,h),d=u(f,h,!0);if(p in n&&d in e&&n[p]!==e[d]){var A=s(p,d,h),g=a(p,d,r[A].geometry);delete e[p],delete n[d],n[u(f,r[g].geometry,!0)]=g,r[A].geometry=null}else p in n?a(p,d,h):d in e?s(p,d,h):(o(c),e[p]=i-1,n[d]=i-1)}else o(c)}return r.filter((function(t){return t.geometry}))}(this.features)),this.sortFeaturesByKey&&this.features.sort((function(t,e){return t.sortKey-e.sortKey}))}},mc.prototype.update=function(t,e,n){this.stateDependentLayers.length&&(this.text.programConfigurations.updatePaintArrays(t,e,this.layers,n),this.icon.programConfigurations.updatePaintArrays(t,e,this.layers,n))},mc.prototype.isEmpty=function(){return 0===this.symbolInstances.length&&!this.hasRTLText},mc.prototype.uploadPending=function(){return!this.uploaded||this.text.programConfigurations.needsUpload||this.icon.programConfigurations.needsUpload},mc.prototype.upload=function(t){!this.uploaded&&this.hasDebugData()&&(this.textCollisionBox.upload(t),this.iconCollisionBox.upload(t)),this.text.upload(t,this.sortFeaturesByY,!this.uploaded,this.text.programConfigurations.needsUpload),this.icon.upload(t,this.sortFeaturesByY,!this.uploaded,this.icon.programConfigurations.needsUpload),this.uploaded=!0},mc.prototype.destroyDebugData=function(){this.textCollisionBox.destroy(),this.iconCollisionBox.destroy()},mc.prototype.destroy=function(){this.text.destroy(),this.icon.destroy(),this.hasDebugData()&&this.destroyDebugData()},mc.prototype.addToLineVertexArray=function(t,e){var n=this.lineVertexArray.length;if(void 0!==t.segment){for(var r=t.dist(e[t.segment+1]),i=t.dist(e[t.segment]),o={},a=t.segment+1;a<e.length;a++)o[a]={x:e[a].x,y:e[a].y,tileUnitDistanceFromAnchor:r},a<e.length-1&&(r+=e[a+1].dist(e[a]));for(var s=t.segment||0;s>=0;s--)o[s]={x:e[s].x,y:e[s].y,tileUnitDistanceFromAnchor:i},s>0&&(i+=e[s-1].dist(e[s]));for(var u=0;u<e.length;u++){var c=o[u];this.lineVertexArray.emplaceBack(c.x,c.y,c.tileUnitDistanceFromAnchor)}}return{lineStartIndex:n,lineLength:this.lineVertexArray.length-n}},mc.prototype.addSymbols=function(t,e,n,r,i,o,a,s,u,c,l,h){for(var f=t.indexArray,p=t.layoutVertexArray,d=t.segments.prepareSegment(4*e.length,p,f,this.canOverlap?o.sortKey:void 0),A=this.glyphOffsetArray.length,g=d.vertexLength,m=this.allowVerticalPlacement&&a===bu.vertical?Math.PI/2:0,y=o.text&&o.text.sections,v=0;v<e.length;v++){var _=e[v],b=_.tl,x=_.tr,w=_.bl,E=_.br,O=_.tex,S=_.pixelOffsetTL,T=_.pixelOffsetBR,C=_.minFontScaleX,P=_.minFontScaleY,M=_.glyphOffset,I=_.isSDF,B=_.sectionIndex,R=d.vertexLength,k=M[1];fc(p,s.x,s.y,b.x,k+b.y,O.x,O.y,n,I,S.x,S.y,C,P),fc(p,s.x,s.y,x.x,k+x.y,O.x+O.w,O.y,n,I,T.x,S.y,C,P),fc(p,s.x,s.y,w.x,k+w.y,O.x,O.y+O.h,n,I,S.x,T.y,C,P),fc(p,s.x,s.y,E.x,k+E.y,O.x+O.w,O.y+O.h,n,I,T.x,T.y,C,P),pc(t.dynamicLayoutVertexArray,s,m),f.emplaceBack(R,R+1,R+2),f.emplaceBack(R+1,R+2,R+3),d.vertexLength+=4,d.primitiveLength+=2,this.glyphOffsetArray.emplaceBack(M[0]),v!==e.length-1&&B===e[v+1].sectionIndex||t.programConfigurations.populatePaintArrays(p.length,o,o.index,{},h,y&&y[B])}t.placedSymbolArray.emplaceBack(s.x,s.y,A,this.glyphOffsetArray.length-A,g,u,c,s.segment,n?n[0]:0,n?n[1]:0,r[0],r[1],a,0,!1,0,l)},mc.prototype._addCollisionDebugVertex=function(t,e,n,r,i,o){return e.emplaceBack(0,0),t.emplaceBack(n.x,n.y,r,i,Math.round(o.x),Math.round(o.y))},mc.prototype.addCollisionDebugVertices=function(t,e,n,r,o,a,s){var u=o.segments.prepareSegment(4,o.layoutVertexArray,o.indexArray),c=u.vertexLength,l=o.layoutVertexArray,h=o.collisionVertexArray,f=s.anchorX,p=s.anchorY;this._addCollisionDebugVertex(l,h,a,f,p,new i(t,e)),this._addCollisionDebugVertex(l,h,a,f,p,new i(n,e)),this._addCollisionDebugVertex(l,h,a,f,p,new i(n,r)),this._addCollisionDebugVertex(l,h,a,f,p,new i(t,r)),u.vertexLength+=4;var d=o.indexArray;d.emplaceBack(c,c+1),d.emplaceBack(c+1,c+2),d.emplaceBack(c+2,c+3),d.emplaceBack(c+3,c),u.primitiveLength+=4},mc.prototype.addDebugCollisionBoxes=function(t,e,n,r){for(var i=t;i<e;i++){var o=this.collisionBoxArray.get(i);this.addCollisionDebugVertices(o.x1,o.y1,o.x2,o.y2,r?this.textCollisionBox:this.iconCollisionBox,o.anchorPoint,n)}},mc.prototype.generateCollisionDebugBuffers=function(){this.hasDebugData()&&this.destroyDebugData(),this.textCollisionBox=new gc(Fi,Hs.members,Xi),this.iconCollisionBox=new gc(Fi,Hs.members,Xi);for(var t=0;t<this.symbolInstances.length;t++){var e=this.symbolInstances.get(t);this.addDebugCollisionBoxes(e.textBoxStartIndex,e.textBoxEndIndex,e,!0),this.addDebugCollisionBoxes(e.verticalTextBoxStartIndex,e.verticalTextBoxEndIndex,e,!0),this.addDebugCollisionBoxes(e.iconBoxStartIndex,e.iconBoxEndIndex,e,!1),this.addDebugCollisionBoxes(e.verticalIconBoxStartIndex,e.verticalIconBoxEndIndex,e,!1)}},mc.prototype._deserializeCollisionBoxesForSymbol=function(t,e,n,r,i,o,a,s,u){for(var c={},l=e;l<n;l++){var h=t.get(l);c.textBox={x1:h.x1,y1:h.y1,x2:h.x2,y2:h.y2,anchorPointX:h.anchorPointX,anchorPointY:h.anchorPointY},c.textFeatureIndex=h.featureIndex;break}for(var f=r;f<i;f++){var p=t.get(f);c.verticalTextBox={x1:p.x1,y1:p.y1,x2:p.x2,y2:p.y2,anchorPointX:p.anchorPointX,anchorPointY:p.anchorPointY},c.verticalTextFeatureIndex=p.featureIndex;break}for(var d=o;d<a;d++){var A=t.get(d);c.iconBox={x1:A.x1,y1:A.y1,x2:A.x2,y2:A.y2,anchorPointX:A.anchorPointX,anchorPointY:A.anchorPointY},c.iconFeatureIndex=A.featureIndex;break}for(var g=s;g<u;g++){var m=t.get(g);c.verticalIconBox={x1:m.x1,y1:m.y1,x2:m.x2,y2:m.y2,anchorPointX:m.anchorPointX,anchorPointY:m.anchorPointY},c.verticalIconFeatureIndex=m.featureIndex;break}return c},mc.prototype.deserializeCollisionBoxes=function(t){this.collisionArrays=[];for(var e=0;e<this.symbolInstances.length;e++){var n=this.symbolInstances.get(e);this.collisionArrays.push(this._deserializeCollisionBoxesForSymbol(t,n.textBoxStartIndex,n.textBoxEndIndex,n.verticalTextBoxStartIndex,n.verticalTextBoxEndIndex,n.iconBoxStartIndex,n.iconBoxEndIndex,n.verticalIconBoxStartIndex,n.verticalIconBoxEndIndex))}},mc.prototype.hasTextData=function(){return this.text.segments.get().length>0},mc.prototype.hasIconData=function(){return this.icon.segments.get().length>0},mc.prototype.hasDebugData=function(){return this.textCollisionBox&&this.iconCollisionBox},mc.prototype.hasTextCollisionBoxData=function(){return this.hasDebugData()&&this.textCollisionBox.segments.get().length>0},mc.prototype.hasIconCollisionBoxData=function(){return this.hasDebugData()&&this.iconCollisionBox.segments.get().length>0},mc.prototype.addIndicesForPlacedSymbol=function(t,e){for(var n=t.placedSymbolArray.get(e),r=n.vertexStartIndex+4*n.numGlyphs,i=n.vertexStartIndex;i<r;i+=4)t.indexArray.emplaceBack(i,i+1,i+2),t.indexArray.emplaceBack(i+1,i+2,i+3)},mc.prototype.getSortedSymbolIndexes=function(t){if(this.sortedAngle===t&&void 0!==this.symbolInstanceIndexes)return this.symbolInstanceIndexes;for(var e=Math.sin(t),n=Math.cos(t),r=[],i=[],o=[],a=0;a<this.symbolInstances.length;++a){o.push(a);var s=this.symbolInstances.get(a);r.push(0|Math.round(e*s.anchorX+n*s.anchorY)),i.push(s.featureIndex)}return o.sort((function(t,e){return r[t]-r[e]||i[e]-i[t]})),o},mc.prototype.addToSortKeyRanges=function(t,e){var n=this.sortKeyRanges[this.sortKeyRanges.length-1];n&&n.sortKey===e?n.symbolInstanceEnd=t+1:this.sortKeyRanges.push({sortKey:e,symbolInstanceStart:t,symbolInstanceEnd:t+1})},mc.prototype.sortFeatures=function(t){var e=this;if(this.sortFeaturesByY&&this.sortedAngle!==t&&!(this.text.segments.get().length>1||this.icon.segments.get().length>1)){this.symbolInstanceIndexes=this.getSortedSymbolIndexes(t),this.sortedAngle=t,this.text.indexArray.clear(),this.icon.indexArray.clear(),this.featureSortOrder=[];for(var n=0,r=this.symbolInstanceIndexes;n<r.length;n+=1){var i=this.symbolInstances.get(r[n]);this.featureSortOrder.push(i.featureIndex),[i.rightJustifiedTextSymbolIndex,i.centerJustifiedTextSymbolIndex,i.leftJustifiedTextSymbolIndex].forEach((function(t,n,r){t>=0&&r.indexOf(t)===n&&e.addIndicesForPlacedSymbol(e.text,t)})),i.verticalPlacedTextSymbolIndex>=0&&this.addIndicesForPlacedSymbol(this.text,i.verticalPlacedTextSymbolIndex),i.placedIconSymbolIndex>=0&&this.addIndicesForPlacedSymbol(this.icon,i.placedIconSymbolIndex),i.verticalPlacedIconSymbolIndex>=0&&this.addIndicesForPlacedSymbol(this.icon,i.verticalPlacedIconSymbolIndex)}this.text.indexBuffer&&this.text.indexBuffer.updateData(this.text.indexArray),this.icon.indexBuffer&&this.icon.indexBuffer.updateData(this.icon.indexArray)}},Fr("SymbolBucket",mc,{omit:["layers","collisionBoxArray","features","compareText"]}),mc.MAX_GLYPHS=65535,mc.addDynamicAttributes=pc;var yc=new bi({"symbol-placement":new gi(Pt.layout_symbol["symbol-placement"]),"symbol-spacing":new gi(Pt.layout_symbol["symbol-spacing"]),"symbol-avoid-edges":new gi(Pt.layout_symbol["symbol-avoid-edges"]),"symbol-sort-key":new mi(Pt.layout_symbol["symbol-sort-key"]),"symbol-z-order":new gi(Pt.layout_symbol["symbol-z-order"]),"icon-allow-overlap":new gi(Pt.layout_symbol["icon-allow-overlap"]),"icon-ignore-placement":new gi(Pt.layout_symbol["icon-ignore-placement"]),"icon-optional":new gi(Pt.layout_symbol["icon-optional"]),"icon-rotation-alignment":new gi(Pt.layout_symbol["icon-rotation-alignment"]),"icon-size":new mi(Pt.layout_symbol["icon-size"]),"icon-text-fit":new gi(Pt.layout_symbol["icon-text-fit"]),"icon-text-fit-padding":new gi(Pt.layout_symbol["icon-text-fit-padding"]),"icon-image":new mi(Pt.layout_symbol["icon-image"]),"icon-rotate":new mi(Pt.layout_symbol["icon-rotate"]),"icon-padding":new gi(Pt.layout_symbol["icon-padding"]),"icon-keep-upright":new gi(Pt.layout_symbol["icon-keep-upright"]),"icon-offset":new mi(Pt.layout_symbol["icon-offset"]),"icon-anchor":new mi(Pt.layout_symbol["icon-anchor"]),"icon-pitch-alignment":new gi(Pt.layout_symbol["icon-pitch-alignment"]),"text-pitch-alignment":new gi(Pt.layout_symbol["text-pitch-alignment"]),"text-rotation-alignment":new gi(Pt.layout_symbol["text-rotation-alignment"]),"text-field":new mi(Pt.layout_symbol["text-field"]),"text-font":new mi(Pt.layout_symbol["text-font"]),"text-size":new mi(Pt.layout_symbol["text-size"]),"text-max-width":new mi(Pt.layout_symbol["text-max-width"]),"text-line-height":new gi(Pt.layout_symbol["text-line-height"]),"text-letter-spacing":new mi(Pt.layout_symbol["text-letter-spacing"]),"text-justify":new mi(Pt.layout_symbol["text-justify"]),"text-radial-offset":new mi(Pt.layout_symbol["text-radial-offset"]),"text-variable-anchor":new gi(Pt.layout_symbol["text-variable-anchor"]),"text-anchor":new mi(Pt.layout_symbol["text-anchor"]),"text-max-angle":new gi(Pt.layout_symbol["text-max-angle"]),"text-writing-mode":new gi(Pt.layout_symbol["text-writing-mode"]),"text-rotate":new mi(Pt.layout_symbol["text-rotate"]),"text-padding":new gi(Pt.layout_symbol["text-padding"]),"text-keep-upright":new gi(Pt.layout_symbol["text-keep-upright"]),"text-transform":new mi(Pt.layout_symbol["text-transform"]),"text-offset":new mi(Pt.layout_symbol["text-offset"]),"text-allow-overlap":new gi(Pt.layout_symbol["text-allow-overlap"]),"text-ignore-placement":new gi(Pt.layout_symbol["text-ignore-placement"]),"text-optional":new gi(Pt.layout_symbol["text-optional"])}),vc={paint:new bi({"icon-opacity":new mi(Pt.paint_symbol["icon-opacity"]),"icon-color":new mi(Pt.paint_symbol["icon-color"]),"icon-halo-color":new mi(Pt.paint_symbol["icon-halo-color"]),"icon-halo-width":new mi(Pt.paint_symbol["icon-halo-width"]),"icon-halo-blur":new mi(Pt.paint_symbol["icon-halo-blur"]),"icon-translate":new gi(Pt.paint_symbol["icon-translate"]),"icon-translate-anchor":new gi(Pt.paint_symbol["icon-translate-anchor"]),"text-opacity":new mi(Pt.paint_symbol["text-opacity"]),"text-color":new mi(Pt.paint_symbol["text-color"],{runtimeType:Nt,getOverride:function(t){return t.textColor},hasOverride:function(t){return!!t.textColor}}),"text-halo-color":new mi(Pt.paint_symbol["text-halo-color"]),"text-halo-width":new mi(Pt.paint_symbol["text-halo-width"]),"text-halo-blur":new mi(Pt.paint_symbol["text-halo-blur"]),"text-translate":new gi(Pt.paint_symbol["text-translate"]),"text-translate-anchor":new gi(Pt.paint_symbol["text-translate-anchor"])}),layout:yc},_c=function(t){this.type=t.property.overrides?t.property.overrides.runtimeType:jt,this.defaultValue=t};_c.prototype.evaluate=function(t){if(t.formattedSection){var e=this.defaultValue.property.overrides;if(e&&e.hasOverride(t.formattedSection))return e.getOverride(t.formattedSection)}return t.feature&&t.featureState?this.defaultValue.evaluate(t.feature,t.featureState):this.defaultValue.property.specification.default},_c.prototype.eachChild=function(t){this.defaultValue.isConstant()||t(this.defaultValue.value._styleExpression.expression)},_c.prototype.outputDefined=function(){return!1},_c.prototype.serialize=function(){return null},Fr("FormatSectionOverride",_c,{omit:["defaultValue"]});var bc=function(t){function e(e){t.call(this,e,vc)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.recalculate=function(e,n){if(t.prototype.recalculate.call(this,e,n),"auto"===this.layout.get("icon-rotation-alignment")&&(this.layout._values["icon-rotation-alignment"]="point"!==this.layout.get("symbol-placement")?"map":"viewport"),"auto"===this.layout.get("text-rotation-alignment")&&(this.layout._values["text-rotation-alignment"]="point"!==this.layout.get("symbol-placement")?"map":"viewport"),"auto"===this.layout.get("text-pitch-alignment")&&(this.layout._values["text-pitch-alignment"]=this.layout.get("text-rotation-alignment")),"auto"===this.layout.get("icon-pitch-alignment")&&(this.layout._values["icon-pitch-alignment"]=this.layout.get("icon-rotation-alignment")),"point"===this.layout.get("symbol-placement")){var r=this.layout.get("text-writing-mode");if(r){for(var i=[],o=0,a=r;o<a.length;o+=1){var s=a[o];i.indexOf(s)<0&&i.push(s)}this.layout._values["text-writing-mode"]=i}else this.layout._values["text-writing-mode"]=["horizontal"]}this._setPaintOverrides()},e.prototype.getValueAndResolveTokens=function(t,e,n,r){var i=this.layout.get(t).evaluate(e,{},n,r),o=this._unevaluatedLayout._values[t];return o.isDataDriven()||qn(o.value)||!i?i:function(t,e){return e.replace(/{([^{}]+)}/g,(function(e,n){return n in t?String(t[n]):""}))}(e.properties,i)},e.prototype.createBucket=function(t){return new mc(t)},e.prototype.queryRadius=function(){return 0},e.prototype.queryIntersectsFeature=function(){return!1},e.prototype._setPaintOverrides=function(){for(var t=0,n=vc.paint.overridableProperties;t<n.length;t+=1){var r=n[t];if(e.hasPaintOverride(this.layout,r)){var i,o=this.paint.get(r),a=new _c(o),s=new Wn(a,o.property.specification);i="constant"===o.value.kind||"source"===o.value.kind?new Zn("source",s):new Jn("composite",s,o.value.zoomStops,o.value._interpolationType),this.paint._values[r]=new di(o.property,i,o.parameters)}}},e.prototype._handleOverridablePaintPropertyUpdate=function(t,n,r){return!(!this.layout||n.isDataDriven()||r.isDataDriven())&&e.hasPaintOverride(this.layout,t)},e.hasPaintOverride=function(t,e){var n=t.get("text-field"),r=vc.paint.properties[e],i=!1,o=function(t){for(var e=0,n=t;e<n.length;e+=1)if(r.overrides&&r.overrides.hasOverride(n[e]))return void(i=!0)};if("constant"===n.value.kind&&n.value.value instanceof re)o(n.value.value.sections);else if("source"===n.value.kind){var a=function(t){i||(t instanceof ce&&se(t.value)===Wt?o(t.value.sections):t instanceof pe?o(t.sections):t.eachChild(a))},s=n.value;s._styleExpression&&a(s._styleExpression.expression)}return i},e}(xi),xc={paint:new bi({"background-color":new gi(Pt.paint_background["background-color"]),"background-pattern":new vi(Pt.paint_background["background-pattern"]),"background-opacity":new gi(Pt.paint_background["background-opacity"])})},wc=function(t){function e(e){t.call(this,e,xc)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e}(xi),Ec={paint:new bi({"raster-opacity":new gi(Pt.paint_raster["raster-opacity"]),"raster-hue-rotate":new gi(Pt.paint_raster["raster-hue-rotate"]),"raster-brightness-min":new gi(Pt.paint_raster["raster-brightness-min"]),"raster-brightness-max":new gi(Pt.paint_raster["raster-brightness-max"]),"raster-saturation":new gi(Pt.paint_raster["raster-saturation"]),"raster-contrast":new gi(Pt.paint_raster["raster-contrast"]),"raster-resampling":new gi(Pt.paint_raster["raster-resampling"]),"raster-fade-duration":new gi(Pt.paint_raster["raster-fade-duration"])})},Oc=function(t){function e(e){t.call(this,e,Ec)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e}(xi),Sc=function(t){function e(e){t.call(this,e,{}),this.implementation=e}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.is3D=function(){return"3d"===this.implementation.renderingMode},e.prototype.hasOffscreenPass=function(){return void 0!==this.implementation.prerender},e.prototype.recalculate=function(){},e.prototype.updateTransitions=function(){},e.prototype.hasTransition=function(){},e.prototype.serialize=function(){},e.prototype.onAdd=function(t){this.implementation.onAdd&&this.implementation.onAdd(t,t.painter.context.gl)},e.prototype.onRemove=function(t){this.implementation.onRemove&&this.implementation.onRemove(t,t.painter.context.gl)},e}(xi),Tc={circle:fa,heatmap:xa,hillshade:Ea,fill:ls,"fill-extrusion":Ts,line:zs,symbol:bc,background:wc,raster:Oc},Cc=a.HTMLImageElement,Pc=a.HTMLCanvasElement,Mc=a.HTMLVideoElement,Ic=a.ImageData,Bc=a.ImageBitmap,Rc=function(t,e,n,r){this.context=t,this.format=n,this.texture=t.gl.createTexture(),this.update(e,r)};Rc.prototype.update=function(t,e,n){var r=t.width,i=t.height,o=!(this.size&&this.size[0]===r&&this.size[1]===i||n),a=this.context,s=a.gl;if(this.useMipmap=Boolean(e&&e.useMipmap),s.bindTexture(s.TEXTURE_2D,this.texture),a.pixelStoreUnpackFlipY.set(!1),a.pixelStoreUnpack.set(1),a.pixelStoreUnpackPremultiplyAlpha.set(this.format===s.RGBA&&(!e||!1!==e.premultiply)),o)this.size=[r,i],t instanceof Cc||t instanceof Pc||t instanceof Mc||t instanceof Ic||Bc&&t instanceof Bc?s.texImage2D(s.TEXTURE_2D,0,this.format,this.format,s.UNSIGNED_BYTE,t):s.texImage2D(s.TEXTURE_2D,0,this.format,r,i,0,this.format,s.UNSIGNED_BYTE,t.data);else{var u=n||{x:0,y:0},c=u.x,l=u.y;t instanceof Cc||t instanceof Pc||t instanceof Mc||t instanceof Ic||Bc&&t instanceof Bc?s.texSubImage2D(s.TEXTURE_2D,0,c,l,s.RGBA,s.UNSIGNED_BYTE,t):s.texSubImage2D(s.TEXTURE_2D,0,c,l,r,i,s.RGBA,s.UNSIGNED_BYTE,t.data)}this.useMipmap&&this.isSizePowerOfTwo()&&s.generateMipmap(s.TEXTURE_2D)},Rc.prototype.bind=function(t,e,n){var r=this.context.gl;r.bindTexture(r.TEXTURE_2D,this.texture),n!==r.LINEAR_MIPMAP_NEAREST||this.isSizePowerOfTwo()||(n=r.LINEAR),t!==this.filter&&(r.texParameteri(r.TEXTURE_2D,r.TEXTURE_MAG_FILTER,t),r.texParameteri(r.TEXTURE_2D,r.TEXTURE_MIN_FILTER,n||t),this.filter=t),e!==this.wrap&&(r.texParameteri(r.TEXTURE_2D,r.TEXTURE_WRAP_S,e),r.texParameteri(r.TEXTURE_2D,r.TEXTURE_WRAP_T,e),this.wrap=e)},Rc.prototype.isSizePowerOfTwo=function(){return this.size[0]===this.size[1]&&Math.log(this.size[0])/Math.LN2%1==0},Rc.prototype.destroy=function(){this.context.gl.deleteTexture(this.texture),this.texture=null};var kc=function(t){var e=this;this._callback=t,this._triggered=!1,"undefined"!=typeof MessageChannel&&(this._channel=new MessageChannel,this._channel.port2.onmessage=function(){e._triggered=!1,e._callback()})};kc.prototype.trigger=function(){var t=this;this._triggered||(this._triggered=!0,this._channel?this._channel.port1.postMessage(!0):setTimeout((function(){t._triggered=!1,t._callback()}),0))},kc.prototype.remove=function(){delete this._channel,this._callback=function(){}};var Dc=function(t,e,n){this.target=t,this.parent=e,this.mapId=n,this.callbacks={},this.tasks={},this.taskQueue=[],this.cancelCallbacks={},m(["receive","process"],this),this.invoker=new kc(this.process),this.target.addEventListener("message",this.receive,!1),this.globalScope=S()?t:a};function Lc(t,e,n){var r=2*Math.PI*6378137/256/Math.pow(2,n);return[t*r-2*Math.PI*6378137/2,e*r-2*Math.PI*6378137/2]}Dc.prototype.send=function(t,e,n,r,i){var o=this;void 0===i&&(i=!1);var a=Math.round(1e18*Math.random()).toString(36).substring(0,10);n&&(this.callbacks[a]=n);var s=P(this.globalScope)?void 0:[];return this.target.postMessage({id:a,type:t,hasCallback:!!n,targetMapId:r,mustQueue:i,sourceMapId:this.mapId,data:Gr(e,s)},s),{cancel:function(){n&&delete o.callbacks[a],o.target.postMessage({id:a,type:"<cancel>",targetMapId:r,sourceMapId:o.mapId})}}},Dc.prototype.receive=function(t){var e=t.data,n=e.id;if(n&&(!e.targetMapId||this.mapId===e.targetMapId))if("<cancel>"===e.type){delete this.tasks[n];var r=this.cancelCallbacks[n];delete this.cancelCallbacks[n],r&&r()}else S()||e.mustQueue?(this.tasks[n]=e,this.taskQueue.push(n),this.invoker.trigger()):this.processTask(n,e)},Dc.prototype.process=function(){if(this.taskQueue.length){var t=this.taskQueue.shift(),e=this.tasks[t];delete this.tasks[t],this.taskQueue.length&&this.invoker.trigger(),e&&this.processTask(t,e)}},Dc.prototype.processTask=function(t,e){var n=this;if("<response>"===e.type){var r=this.callbacks[t];delete this.callbacks[t],r&&(e.error?r(Vr(e.error)):r(null,Vr(e.data)))}else{var i=!1,o=P(this.globalScope)?void 0:[],a=e.hasCallback?function(e,r){i=!0,delete n.cancelCallbacks[t],n.target.postMessage({id:t,type:"<response>",sourceMapId:n.mapId,error:e?Gr(e):null,data:Gr(r,o)},o)}:function(t){i=!0},s=null,u=Vr(e.data);if(this.parent[e.type])s=this.parent[e.type](e.sourceMapId,u,a);else if(this.parent.getWorkerSource){var c=e.type.split(".");s=this.parent.getWorkerSource(e.sourceMapId,c[0],u.source)[c[1]](u,a)}else a(new Error("Could not find function "+e.type));!i&&s&&s.cancel&&(this.cancelCallbacks[t]=s.cancel)}},Dc.prototype.remove=function(){this.invoker.remove(),this.target.removeEventListener("message",this.receive,!1)};var jc=function(t,e){t&&(e?this.setSouthWest(t).setNorthEast(e):4===t.length?this.setSouthWest([t[0],t[1]]).setNorthEast([t[2],t[3]]):this.setSouthWest(t[0]).setNorthEast(t[1]))};jc.prototype.setNorthEast=function(t){return this._ne=t instanceof Fc?new Fc(t.lng,t.lat):Fc.convert(t),this},jc.prototype.setSouthWest=function(t){return this._sw=t instanceof Fc?new Fc(t.lng,t.lat):Fc.convert(t),this},jc.prototype.extend=function(t){var e,n,r=this._sw,i=this._ne;if(t instanceof Fc)e=t,n=t;else{if(!(t instanceof jc))return Array.isArray(t)?4===t.length||t.every(Array.isArray)?this.extend(jc.convert(t)):this.extend(Fc.convert(t)):this;if(n=t._ne,!(e=t._sw)||!n)return this}return r||i?(r.lng=Math.min(e.lng,r.lng),r.lat=Math.min(e.lat,r.lat),i.lng=Math.max(n.lng,i.lng),i.lat=Math.max(n.lat,i.lat)):(this._sw=new Fc(e.lng,e.lat),this._ne=new Fc(n.lng,n.lat)),this},jc.prototype.getCenter=function(){return new Fc((this._sw.lng+this._ne.lng)/2,(this._sw.lat+this._ne.lat)/2)},jc.prototype.getSouthWest=function(){return this._sw},jc.prototype.getNorthEast=function(){return this._ne},jc.prototype.getNorthWest=function(){return new Fc(this.getWest(),this.getNorth())},jc.prototype.getSouthEast=function(){return new Fc(this.getEast(),this.getSouth())},jc.prototype.getWest=function(){return this._sw.lng},jc.prototype.getSouth=function(){return this._sw.lat},jc.prototype.getEast=function(){return this._ne.lng},jc.prototype.getNorth=function(){return this._ne.lat},jc.prototype.toArray=function(){return[this._sw.toArray(),this._ne.toArray()]},jc.prototype.toString=function(){return"LngLatBounds("+this._sw.toString()+", "+this._ne.toString()+")"},jc.prototype.isEmpty=function(){return!(this._sw&&this._ne)},jc.prototype.contains=function(t){var e=Fc.convert(t),n=e.lng,r=e.lat,i=this._sw.lng<=n&&n<=this._ne.lng;return this._sw.lng>this._ne.lng&&(i=this._sw.lng>=n&&n>=this._ne.lng),this._sw.lat<=r&&r<=this._ne.lat&&i},jc.convert=function(t){return!t||t instanceof jc?t:new jc(t)};var Fc=function(t,e){if(isNaN(t)||isNaN(e))throw new Error("Invalid LngLat object: ("+t+", "+e+")");if(this.lng=+t,this.lat=+e,this.lat>90||this.lat<-90)throw new Error("Invalid LngLat latitude value: must be between -90 and 90")};Fc.prototype.wrap=function(){return new Fc(h(this.lng,-180,180),this.lat)},Fc.prototype.toArray=function(){return[this.lng,this.lat]},Fc.prototype.toString=function(){return"LngLat("+this.lng+", "+this.lat+")"},Fc.prototype.distanceTo=function(t){var e=Math.PI/180,n=this.lat*e,r=t.lat*e,i=Math.sin(n)*Math.sin(r)+Math.cos(n)*Math.cos(r)*Math.cos((t.lng-this.lng)*e);return 6371008.8*Math.acos(Math.min(i,1))},Fc.prototype.toBounds=function(t){void 0===t&&(t=0);var e=360*t/40075017,n=e/Math.cos(Math.PI/180*this.lat);return new jc(new Fc(this.lng-n,this.lat-e),new Fc(this.lng+n,this.lat+e))},Fc.convert=function(t){if(t instanceof Fc)return t;if(Array.isArray(t)&&(2===t.length||3===t.length))return new Fc(Number(t[0]),Number(t[1]));if(!Array.isArray(t)&&"object"==typeof t&&null!==t)return new Fc(Number("lng"in t?t.lng:t.lon),Number(t.lat));throw new Error("`LngLatLike` argument must be specified as a LngLat instance, an object {lng: <lng>, lat: <lat>}, an object {lon: <lng>, lat: <lat>}, or an array of [<lng>, <lat>]")};var zc=2*Math.PI*6371008.8;function Uc(t){return zc*Math.cos(t*Math.PI/180)}function Nc(t){return(180+t)/360}function Gc(t){return(180-180/Math.PI*Math.log(Math.tan(Math.PI/4+t*Math.PI/360)))/360}function Vc(t,e){return t/Uc(e)}function Hc(t){return 360/Math.PI*Math.atan(Math.exp((180-360*t)*Math.PI/180))-90}var Wc=function(t,e,n){void 0===n&&(n=0),this.x=+t,this.y=+e,this.z=+n};Wc.fromLngLat=function(t,e){void 0===e&&(e=0);var n=Fc.convert(t);return new Wc(Nc(n.lng),Gc(n.lat),Vc(e,n.lat))},Wc.prototype.toLngLat=function(){return new Fc(360*this.x-180,Hc(this.y))},Wc.prototype.toAltitude=function(){return this.z*Uc(Hc(this.y))},Wc.prototype.meterInMercatorCoordinateUnits=function(){return 1/zc*(t=Hc(this.y),1/Math.cos(t*Math.PI/180));var t};var qc=function(t,e,n){this.z=t,this.x=e,this.y=n,this.key=Jc(0,t,t,e,n)};qc.prototype.equals=function(t){return this.z===t.z&&this.x===t.x&&this.y===t.y},qc.prototype.url=function(t,e){var n,r,i,o,a,s=(r=this.y,i=this.z,o=Lc(256*(n=this.x),256*(r=Math.pow(2,i)-r-1),i),a=Lc(256*(n+1),256*(r+1),i),o[0]+","+o[1]+","+a[0]+","+a[1]),u=function(t,e,n){for(var r,i="",o=t;o>0;o--)i+=(e&(r=1<<o-1)?1:0)+(n&r?2:0);return i}(this.z,this.x,this.y);return t[(this.x+this.y)%t.length].replace("{prefix}",(this.x%16).toString(16)+(this.y%16).toString(16)).replace("{z}",String(this.z)).replace("{x}",String(this.x)).replace("{y}",String("tms"===e?Math.pow(2,this.z)-this.y-1:this.y)).replace("{quadkey}",u).replace("{bbox-epsg-3857}",s)},qc.prototype.getTilePoint=function(t){var e=Math.pow(2,this.z);return new i(8192*(t.x*e-this.x),8192*(t.y*e-this.y))},qc.prototype.toString=function(){return this.z+"/"+this.x+"/"+this.y};var Xc=function(t,e){this.wrap=t,this.canonical=e,this.key=Jc(t,e.z,e.z,e.x,e.y)},Zc=function(t,e,n,r,i){this.overscaledZ=t,this.wrap=e,this.canonical=new qc(n,+r,+i),this.key=Jc(e,t,n,r,i)};function Jc(t,e,n,r,i){(t*=2)<0&&(t=-1*t-1);var o=1<<n;return(o*o*t+o*i+r).toString(36)+n.toString(36)+e.toString(36)}Zc.prototype.equals=function(t){return this.overscaledZ===t.overscaledZ&&this.wrap===t.wrap&&this.canonical.equals(t.canonical)},Zc.prototype.scaledTo=function(t){var e=this.canonical.z-t;return t>this.canonical.z?new Zc(t,this.wrap,this.canonical.z,this.canonical.x,this.canonical.y):new Zc(t,this.wrap,t,this.canonical.x>>e,this.canonical.y>>e)},Zc.prototype.calculateScaledKey=function(t,e){var n=this.canonical.z-t;return t>this.canonical.z?Jc(this.wrap*+e,t,this.canonical.z,this.canonical.x,this.canonical.y):Jc(this.wrap*+e,t,t,this.canonical.x>>n,this.canonical.y>>n)},Zc.prototype.isChildOf=function(t){if(t.wrap!==this.wrap)return!1;var e=this.canonical.z-t.canonical.z;return 0===t.overscaledZ||t.overscaledZ<this.overscaledZ&&t.canonical.x===this.canonical.x>>e&&t.canonical.y===this.canonical.y>>e},Zc.prototype.children=function(t){if(this.overscaledZ>=t)return[new Zc(this.overscaledZ+1,this.wrap,this.canonical.z,this.canonical.x,this.canonical.y)];var e=this.canonical.z+1,n=2*this.canonical.x,r=2*this.canonical.y;return[new Zc(e,this.wrap,e,n,r),new Zc(e,this.wrap,e,n+1,r),new Zc(e,this.wrap,e,n,r+1),new Zc(e,this.wrap,e,n+1,r+1)]},Zc.prototype.isLessThan=function(t){return this.wrap<t.wrap||!(this.wrap>t.wrap)&&(this.overscaledZ<t.overscaledZ||!(this.overscaledZ>t.overscaledZ)&&(this.canonical.x<t.canonical.x||!(this.canonical.x>t.canonical.x)&&this.canonical.y<t.canonical.y))},Zc.prototype.wrapped=function(){return new Zc(this.overscaledZ,0,this.canonical.z,this.canonical.x,this.canonical.y)},Zc.prototype.unwrapTo=function(t){return new Zc(this.overscaledZ,t,this.canonical.z,this.canonical.x,this.canonical.y)},Zc.prototype.overscaleFactor=function(){return Math.pow(2,this.overscaledZ-this.canonical.z)},Zc.prototype.toUnwrapped=function(){return new Xc(this.wrap,this.canonical)},Zc.prototype.toString=function(){return this.overscaledZ+"/"+this.canonical.x+"/"+this.canonical.y},Zc.prototype.getTilePoint=function(t){return this.canonical.getTilePoint(new Wc(t.x-this.wrap,t.y))},Fr("CanonicalTileID",qc),Fr("OverscaledTileID",Zc,{omit:["posMatrix"]});var Qc=function(t,e,n){if(this.uid=t,e.height!==e.width)throw new RangeError("DEM tiles must be square");if(n&&"mapbox"!==n&&"terrarium"!==n)return w('"'+n+'" is not a valid encoding type. Valid types include "mapbox" and "terrarium".');this.stride=e.height;var r=this.dim=e.height-2;this.data=new Uint32Array(e.data.buffer),this.encoding=n||"mapbox";for(var i=0;i<r;i++)this.data[this._idx(-1,i)]=this.data[this._idx(0,i)],this.data[this._idx(r,i)]=this.data[this._idx(r-1,i)],this.data[this._idx(i,-1)]=this.data[this._idx(i,0)],this.data[this._idx(i,r)]=this.data[this._idx(i,r-1)];this.data[this._idx(-1,-1)]=this.data[this._idx(0,0)],this.data[this._idx(r,-1)]=this.data[this._idx(r-1,0)],this.data[this._idx(-1,r)]=this.data[this._idx(0,r-1)],this.data[this._idx(r,r)]=this.data[this._idx(r-1,r-1)]};Qc.prototype.get=function(t,e){var n=new Uint8Array(this.data.buffer),r=4*this._idx(t,e);return("terrarium"===this.encoding?this._unpackTerrarium:this._unpackMapbox)(n[r],n[r+1],n[r+2])},Qc.prototype.getUnpackVector=function(){return"terrarium"===this.encoding?[256,1,1/256,32768]:[6553.6,25.6,.1,1e4]},Qc.prototype._idx=function(t,e){if(t<-1||t>=this.dim+1||e<-1||e>=this.dim+1)throw new RangeError("out of range source coordinates for DEM data");return(e+1)*this.stride+(t+1)},Qc.prototype._unpackMapbox=function(t,e,n){return(256*t*256+256*e+n)/10-1e4},Qc.prototype._unpackTerrarium=function(t,e,n){return 256*t+e+n/256-32768},Qc.prototype.getPixels=function(){return new va({width:this.stride,height:this.stride},new Uint8Array(this.data.buffer))},Qc.prototype.backfillBorder=function(t,e,n){if(this.dim!==t.dim)throw new Error("dem dimension mismatch");var r=e*this.dim,i=e*this.dim+this.dim,o=n*this.dim,a=n*this.dim+this.dim;switch(e){case-1:r=i-1;break;case 1:i=r+1}switch(n){case-1:o=a-1;break;case 1:a=o+1}for(var s=-e*this.dim,u=-n*this.dim,c=o;c<a;c++)for(var l=r;l<i;l++)this.data[this._idx(l,c)]=t.data[this._idx(l+s,c+u)]},Fr("DEMData",Qc);var Kc=function(t){this._stringToNumber={},this._numberToString=[];for(var e=0;e<t.length;e++){var n=t[e];this._stringToNumber[n]=e,this._numberToString[e]=n}};Kc.prototype.encode=function(t){return this._stringToNumber[t]},Kc.prototype.decode=function(t){return this._numberToString[t]};var Yc=function(t,e,n,r,i){this.type="Feature",this._vectorTileFeature=t,t._z=e,t._x=n,t._y=r,this.properties=t.properties,this.id=i},$c={geometry:{configurable:!0}};$c.geometry.get=function(){return void 0===this._geometry&&(this._geometry=this._vectorTileFeature.toGeoJSON(this._vectorTileFeature._x,this._vectorTileFeature._y,this._vectorTileFeature._z).geometry),this._geometry},$c.geometry.set=function(t){this._geometry=t},Yc.prototype.toJSON=function(){var t={geometry:this.geometry};for(var e in this)"_geometry"!==e&&"_vectorTileFeature"!==e&&(t[e]=this[e]);return t},Object.defineProperties(Yc.prototype,$c);var tl=function(){this.state={},this.stateChanges={},this.deletedStates={}};tl.prototype.updateState=function(t,e,n){var r=String(e);if(this.stateChanges[t]=this.stateChanges[t]||{},this.stateChanges[t][r]=this.stateChanges[t][r]||{},f(this.stateChanges[t][r],n),null===this.deletedStates[t])for(var i in this.deletedStates[t]={},this.state[t])i!==r&&(this.deletedStates[t][i]=null);else if(this.deletedStates[t]&&null===this.deletedStates[t][r])for(var o in this.deletedStates[t][r]={},this.state[t][r])n[o]||(this.deletedStates[t][r][o]=null);else for(var a in n)this.deletedStates[t]&&this.deletedStates[t][r]&&null===this.deletedStates[t][r][a]&&delete this.deletedStates[t][r][a]},tl.prototype.removeFeatureState=function(t,e,n){if(null!==this.deletedStates[t]){var r=String(e);if(this.deletedStates[t]=this.deletedStates[t]||{},n&&void 0!==e)null!==this.deletedStates[t][r]&&(this.deletedStates[t][r]=this.deletedStates[t][r]||{},this.deletedStates[t][r][n]=null);else if(void 0!==e)if(this.stateChanges[t]&&this.stateChanges[t][r])for(n in this.deletedStates[t][r]={},this.stateChanges[t][r])this.deletedStates[t][r][n]=null;else this.deletedStates[t][r]=null;else this.deletedStates[t]=null}},tl.prototype.getState=function(t,e){var n=String(e),r=f({},(this.state[t]||{})[n],(this.stateChanges[t]||{})[n]);if(null===this.deletedStates[t])return{};if(this.deletedStates[t]){var i=this.deletedStates[t][e];if(null===i)return{};for(var o in i)delete r[o]}return r},tl.prototype.initializeTileState=function(t,e){t.setFeatureState(this.state,e)},tl.prototype.coalesceChanges=function(t,e){var n={};for(var r in this.stateChanges){this.state[r]=this.state[r]||{};var i={};for(var o in this.stateChanges[r])this.state[r][o]||(this.state[r][o]={}),f(this.state[r][o],this.stateChanges[r][o]),i[o]=this.state[r][o];n[r]=i}for(var a in this.deletedStates){this.state[a]=this.state[a]||{};var s={};if(null===this.deletedStates[a])for(var u in this.state[a])s[u]={},this.state[a][u]={};else for(var c in this.deletedStates[a]){if(null===this.deletedStates[a][c])this.state[a][c]={};else for(var l=0,h=Object.keys(this.deletedStates[a][c]);l<h.length;l+=1)delete this.state[a][c][h[l]];s[c]=this.state[a][c]}n[a]=n[a]||{},f(n[a],s)}if(this.stateChanges={},this.deletedStates={},0!==Object.keys(n).length)for(var p in t)t[p].setFeatureState(n,e)};var el=function(t,e){this.tileID=t,this.x=t.canonical.x,this.y=t.canonical.y,this.z=t.canonical.z,this.grid=new Rr(8192,16,0),this.grid3D=new Rr(8192,16,0),this.featureIndexArray=new oo,this.promoteId=e};function nl(t,e,n,r,i){return v(t,(function(t,o){var a=e instanceof Ai?e.get(o):null;return a&&a.evaluate?a.evaluate(n,r,i):a}))}function rl(t){for(var e=1/0,n=1/0,r=-1/0,i=-1/0,o=0,a=t;o<a.length;o+=1){var s=a[o];e=Math.min(e,s.x),n=Math.min(n,s.y),r=Math.max(r,s.x),i=Math.max(i,s.y)}return{minX:e,minY:n,maxX:r,maxY:i}}function il(t,e){return e-t}el.prototype.insert=function(t,e,n,r,i,o){var a=this.featureIndexArray.length;this.featureIndexArray.emplaceBack(n,r,i);for(var s=o?this.grid3D:this.grid,u=0;u<e.length;u++){for(var c=e[u],l=[1/0,1/0,-1/0,-1/0],h=0;h<c.length;h++){var f=c[h];l[0]=Math.min(l[0],f.x),l[1]=Math.min(l[1],f.y),l[2]=Math.max(l[2],f.x),l[3]=Math.max(l[3],f.y)}l[0]<8192&&l[1]<8192&&l[2]>=0&&l[3]>=0&&s.insert(a,l[0],l[1],l[2],l[3])}},el.prototype.loadVTLayers=function(){return this.vtLayers||(this.vtLayers=new _s.VectorTile(new Qs(this.rawTileData)).layers,this.sourceLayerCoder=new Kc(this.vtLayers?Object.keys(this.vtLayers).sort():["_geojsonTileLayer"])),this.vtLayers},el.prototype.query=function(t,e,n,r){var o=this;this.loadVTLayers();for(var a=t.params||{},s=8192/t.tileSize/t.scale,u=ar(a.filter),c=t.queryGeometry,l=t.queryPadding*s,h=rl(c),f=this.grid.query(h.minX-l,h.minY-l,h.maxX+l,h.maxY+l),p=rl(t.cameraQueryGeometry),d=0,A=this.grid3D.query(p.minX-l,p.minY-l,p.maxX+l,p.maxY+l,(function(e,n,r,o){return function(t,e,n,r,o){for(var a=0,s=t;a<s.length;a+=1){var u=s[a];if(e<=u.x&&n<=u.y&&r>=u.x&&o>=u.y)return!0}var c=[new i(e,n),new i(e,o),new i(r,o),new i(r,n)];if(t.length>2)for(var l=0,h=c;l<h.length;l+=1)if($o(t,h[l]))return!0;for(var f=0;f<t.length-1;f++)if(ta(t[f],t[f+1],c))return!0;return!1}(t.cameraQueryGeometry,e-l,n-l,r+l,o+l)}));d<A.length;d+=1)f.push(A[d]);f.sort(il);for(var g,m={},y=function(i){var l=f[i];if(l!==g){g=l;var h=o.featureIndexArray.get(l),p=null;o.loadMatchingFeature(m,h.bucketIndex,h.sourceLayerIndex,h.featureIndex,u,a.layers,a.availableImages,e,n,r,(function(e,n,r){return p||(p=Uo(e)),n.queryIntersectsFeature(c,e,r,p,o.z,t.transform,s,t.pixelPosMatrix)}))}},v=0;v<f.length;v++)y(v);return m},el.prototype.loadMatchingFeature=function(t,e,n,r,i,o,a,s,u,c,l){var h=this.bucketLayerIDs[e];if(!o||function(t,e){for(var n=0;n<t.length;n++)if(e.indexOf(t[n])>=0)return!0;return!1}(o,h)){var p=this.sourceLayerCoder.decode(n),d=this.vtLayers[p].feature(r);if(i.needGeometry){var A=No(d,!0);if(!i.filter(new si(this.tileID.overscaledZ),A,this.tileID.canonical))return}else if(!i.filter(new si(this.tileID.overscaledZ),d))return;for(var g=this.getId(d,p),m=0;m<h.length;m++){var y=h[m];if(!(o&&o.indexOf(y)<0)){var v=s[y];if(v){var _={};void 0!==g&&c&&(_=c.getState(v.sourceLayer||"_geojsonTileLayer",g));var b=f({},u[y]);b.paint=nl(b.paint,v.paint,d,_,a),b.layout=nl(b.layout,v.layout,d,_,a);var x=!l||l(d,v,_);if(x){var w=new Yc(d,this.z,this.x,this.y,g);w.layer=b;var E=t[y];void 0===E&&(E=t[y]=[]),E.push({featureIndex:r,feature:w,intersectionZ:x})}}}}}},el.prototype.lookupSymbolFeatures=function(t,e,n,r,i,o,a,s){var u={};this.loadVTLayers();for(var c=ar(i),l=0,h=t;l<h.length;l+=1)this.loadMatchingFeature(u,n,r,h[l],c,o,a,s,e);return u},el.prototype.hasLayer=function(t){for(var e=0,n=this.bucketLayerIDs;e<n.length;e+=1)for(var r=0,i=n[e];r<i.length;r+=1)if(t===i[r])return!0;return!1},el.prototype.getId=function(t,e){var n=t.id;return this.promoteId&&"boolean"==typeof(n=t.properties["string"==typeof this.promoteId?this.promoteId:this.promoteId[e]])&&(n=Number(n)),n},Fr("FeatureIndex",el,{omit:["rawTileData","sourceLayerCoder"]});var ol=function(t,e){this.tileID=t,this.uid=d(),this.uses=0,this.tileSize=e,this.buckets={},this.expirationTime=null,this.queryPadding=0,this.hasSymbolBuckets=!1,this.hasRTLText=!1,this.dependencies={},this.expiredRequestCount=0,this.state="loading"};ol.prototype.registerFadeDuration=function(t){var e=t+this.timeAdded;e<F.now()||this.fadeEndTime&&e<this.fadeEndTime||(this.fadeEndTime=e)},ol.prototype.wasRequested=function(){return"errored"===this.state||"loaded"===this.state||"reloading"===this.state},ol.prototype.loadVectorData=function(t,e,n){if(this.hasData()&&this.unloadVectorData(),this.state="loaded",t){for(var r in t.featureIndex&&(this.latestFeatureIndex=t.featureIndex,t.rawTileData?(this.latestRawTileData=t.rawTileData,this.latestFeatureIndex.rawTileData=t.rawTileData):this.latestRawTileData&&(this.latestFeatureIndex.rawTileData=this.latestRawTileData)),this.collisionBoxArray=t.collisionBoxArray,this.buckets=function(t,e){var n={};if(!e)return n;for(var r=function(){var t=o[i],r=t.layerIds.map((function(t){return e.getLayer(t)})).filter(Boolean);if(0!==r.length){t.layers=r,t.stateDependentLayerIds&&(t.stateDependentLayers=t.stateDependentLayerIds.map((function(t){return r.filter((function(e){return e.id===t}))[0]})));for(var a=0,s=r;a<s.length;a+=1)n[s[a].id]=t}},i=0,o=t;i<o.length;i+=1)r();return n}(t.buckets,e.style),this.hasSymbolBuckets=!1,this.buckets){var i=this.buckets[r];if(i instanceof mc){if(this.hasSymbolBuckets=!0,!n)break;i.justReloaded=!0}}if(this.hasRTLText=!1,this.hasSymbolBuckets)for(var o in this.buckets){var a=this.buckets[o];if(a instanceof mc&&a.hasRTLText){this.hasRTLText=!0,ai.isLoading()||ai.isLoaded()||"deferred"!==ii()||oi();break}}for(var s in this.queryPadding=0,this.buckets){var u=this.buckets[s];this.queryPadding=Math.max(this.queryPadding,e.style.getLayer(s).queryRadius(u))}t.imageAtlas&&(this.imageAtlas=t.imageAtlas),t.glyphAtlasImage&&(this.glyphAtlasImage=t.glyphAtlasImage)}else this.collisionBoxArray=new Ki},ol.prototype.unloadVectorData=function(){for(var t in this.buckets)this.buckets[t].destroy();this.buckets={},this.imageAtlasTexture&&this.imageAtlasTexture.destroy(),this.imageAtlas&&(this.imageAtlas=null),this.glyphAtlasTexture&&this.glyphAtlasTexture.destroy(),this.latestFeatureIndex=null,this.state="unloaded"},ol.prototype.getBucket=function(t){return this.buckets[t.id]},ol.prototype.upload=function(t){for(var e in this.buckets){var n=this.buckets[e];n.uploadPending()&&n.upload(t)}var r=t.gl;this.imageAtlas&&!this.imageAtlas.uploaded&&(this.imageAtlasTexture=new Rc(t,this.imageAtlas.image,r.RGBA),this.imageAtlas.uploaded=!0),this.glyphAtlasImage&&(this.glyphAtlasTexture=new Rc(t,this.glyphAtlasImage,r.ALPHA),this.glyphAtlasImage=null)},ol.prototype.prepare=function(t){this.imageAtlas&&this.imageAtlas.patchUpdatedImages(t,this.imageAtlasTexture)},ol.prototype.queryRenderedFeatures=function(t,e,n,r,i,o,a,s,u,c){return this.latestFeatureIndex&&this.latestFeatureIndex.rawTileData?this.latestFeatureIndex.query({queryGeometry:r,cameraQueryGeometry:i,scale:o,tileSize:this.tileSize,pixelPosMatrix:c,transform:s,params:a,queryPadding:this.queryPadding*u},t,e,n):{}},ol.prototype.querySourceFeatures=function(t,e){var n=this.latestFeatureIndex;if(n&&n.rawTileData){var r=n.loadVTLayers(),i=e?e.sourceLayer:"",o=r._geojsonTileLayer||r[i];if(o)for(var a=ar(e&&e.filter),s=this.tileID.canonical,u=s.z,c=s.x,l=s.y,h={z:u,x:c,y:l},f=0;f<o.length;f++){var p=o.feature(f);if(a.needGeometry){var d=No(p,!0);if(!a.filter(new si(this.tileID.overscaledZ),d,this.tileID.canonical))continue}else if(!a.filter(new si(this.tileID.overscaledZ),p))continue;var A=n.getId(p,i),g=new Yc(p,u,c,l,A);g.tile=h,t.push(g)}}},ol.prototype.hasData=function(){return"loaded"===this.state||"reloading"===this.state||"expired"===this.state},ol.prototype.patternsLoaded=function(){return this.imageAtlas&&!!Object.keys(this.imageAtlas.patternPositions).length},ol.prototype.setExpiryData=function(t){var e=this.expirationTime;if(t.cacheControl){var n=T(t.cacheControl);n["max-age"]&&(this.expirationTime=Date.now()+1e3*n["max-age"])}else t.expires&&(this.expirationTime=new Date(t.expires).getTime());if(this.expirationTime){var r=Date.now(),i=!1;if(this.expirationTime>r)i=!1;else if(e)if(this.expirationTime<e)i=!0;else{var o=this.expirationTime-e;o?this.expirationTime=r+Math.max(o,3e4):i=!0}else i=!0;i?(this.expiredRequestCount++,this.state="expired"):this.expiredRequestCount=0}},ol.prototype.getExpiryTimeout=function(){if(this.expirationTime)return this.expiredRequestCount?1e3*(1<<Math.min(this.expiredRequestCount-1,31)):Math.min(this.expirationTime-(new Date).getTime(),Math.pow(2,31)-1)},ol.prototype.setFeatureState=function(t,e){if(this.latestFeatureIndex&&this.latestFeatureIndex.rawTileData&&0!==Object.keys(t).length){var n=this.latestFeatureIndex.loadVTLayers();for(var r in this.buckets)if(e.style.hasLayer(r)){var i=this.buckets[r],o=i.layers[0].sourceLayer||"_geojsonTileLayer",a=n[o],s=t[o];if(a&&s&&0!==Object.keys(s).length){i.update(s,a,this.imageAtlas&&this.imageAtlas.patternPositions||{});var u=e&&e.style&&e.style.getLayer(r);u&&(this.queryPadding=Math.max(this.queryPadding,u.queryRadius(i)))}}}},ol.prototype.holdingForFade=function(){return void 0!==this.symbolFadeHoldUntil},ol.prototype.symbolFadeFinished=function(){return!this.symbolFadeHoldUntil||this.symbolFadeHoldUntil<F.now()},ol.prototype.clearFadeHold=function(){this.symbolFadeHoldUntil=void 0},ol.prototype.setHoldDuration=function(t){this.symbolFadeHoldUntil=F.now()+t},ol.prototype.setDependencies=function(t,e){for(var n={},r=0,i=e;r<i.length;r+=1)n[i[r]]=!0;this.dependencies[t]=n},ol.prototype.hasDependency=function(t,e){for(var n=0,r=t;n<r.length;n+=1){var i=this.dependencies[r[n]];if(i)for(var o=0,a=e;o<a.length;o+=1)if(i[a[o]])return!0}return!1};var al=a.performance,sl=function(t){this._marks={start:[t.url,"start"].join("#"),end:[t.url,"end"].join("#"),measure:t.url.toString()},al.mark(this._marks.start)};sl.prototype.finish=function(){al.mark(this._marks.end);var t=al.getEntriesByName(this._marks.measure);return 0===t.length&&(al.measure(this._marks.measure,this._marks.start,this._marks.end),t=al.getEntriesByName(this._marks.measure),al.clearMarks(this._marks.start),al.clearMarks(this._marks.end),al.clearMeasures(this._marks.measure)),t},t.Actor=Dc,t.AlphaImage=ya,t.CanonicalTileID=qc,t.CollisionBoxArray=Ki,t.Color=te,t.DEMData=Qc,t.DataConstantProperty=gi,t.DictionaryCoder=Kc,t.EXTENT=8192,t.ErrorEvent=Tt,t.EvaluationParameters=si,t.Event=St,t.Evented=Ct,t.FeatureIndex=el,t.FillBucket=ss,t.FillExtrusionBucket=Es,t.ImageAtlas=_u,t.ImagePosition=yu,t.LineBucket=Ds,t.LngLat=Fc,t.LngLatBounds=jc,t.MercatorCoordinate=Wc,t.ONE_EM=24,t.OverscaledTileID=Zc,t.Point=i,t.Point$1=i,t.Properties=bi,t.Protobuf=Qs,t.RGBAImage=va,t.RequestManager=W,t.RequestPerformance=sl,t.ResourceType=dt,t.SegmentVector=so,t.SourceFeatureState=tl,t.StructArrayLayout1ui2=Zi,t.StructArrayLayout2f1f2i16=zi,t.StructArrayLayout2i4=Ci,t.StructArrayLayout3ui6=Ni,t.StructArrayLayout4i8=Pi,t.SymbolBucket=mc,t.Texture=Rc,t.Tile=ol,t.Transitionable=li,t.Uniform1f=bo,t.Uniform1i=_o,t.Uniform2f=xo,t.Uniform3f=wo,t.Uniform4f=Eo,t.UniformColor=Oo,t.UniformMatrix4f=To,t.UnwrappedTileID=Xc,t.ValidationError=Mt,t.WritingMode=bu,t.ZoomHistory=Hr,t.add=function(t,e,n){return t[0]=e[0]+n[0],t[1]=e[1]+n[1],t[2]=e[2]+n[2],t},t.addDynamicAttributes=pc,t.asyncAll=function(t,e,n){if(!t.length)return n(null,[]);var r=t.length,i=new Array(t.length),o=null;t.forEach((function(t,a){e(t,(function(t,e){t&&(o=t),i[a]=e,0==--r&&n(o,i)}))}))},t.bezier=u,t.bindAll=m,t.browser=F,t.cacheEntryPossiblyAdded=function(t){++ft>ut&&(t.getActor().send("enforceCacheSizeLimit",st),ft=0)},t.clamp=l,t.clearTileCache=function(t){var e=a.caches.delete("mapbox-tiles");t&&e.catch(t).then((function(){return t()}))},t.clipLine=qu,t.clone=function(t){var e=new aa(16);return e[0]=t[0],e[1]=t[1],e[2]=t[2],e[3]=t[3],e[4]=t[4],e[5]=t[5],e[6]=t[6],e[7]=t[7],e[8]=t[8],e[9]=t[9],e[10]=t[10],e[11]=t[11],e[12]=t[12],e[13]=t[13],e[14]=t[14],e[15]=t[15],e},t.clone$1=b,t.clone$2=function(t){var e=new aa(3);return e[0]=t[0],e[1]=t[1],e[2]=t[2],e},t.collisionCircleLayout=Ws,t.config=z,t.create=function(){var t=new aa(16);return aa!=Float32Array&&(t[1]=0,t[2]=0,t[3]=0,t[4]=0,t[6]=0,t[7]=0,t[8]=0,t[9]=0,t[11]=0,t[12]=0,t[13]=0,t[14]=0),t[0]=1,t[5]=1,t[10]=1,t[15]=1,t},t.create$1=function(){var t=new aa(9);return aa!=Float32Array&&(t[1]=0,t[2]=0,t[3]=0,t[5]=0,t[6]=0,t[7]=0),t[0]=1,t[4]=1,t[8]=1,t},t.create$2=function(){var t=new aa(4);return aa!=Float32Array&&(t[1]=0,t[2]=0),t[0]=1,t[3]=1,t},t.createCommonjsModule=e,t.createExpression=Xn,t.createLayout=Si,t.createStyleLayer=function(t){return"custom"===t.type?new Sc(t):new Tc[t.type](t)},t.cross=function(t,e,n){var r=e[0],i=e[1],o=e[2],a=n[0],s=n[1],u=n[2];return t[0]=i*u-o*s,t[1]=o*a-r*u,t[2]=r*s-i*a,t},t.deepEqual=function t(e,n){if(Array.isArray(e)){if(!Array.isArray(n)||e.length!==n.length)return!1;for(var r=0;r<e.length;r++)if(!t(e[r],n[r]))return!1;return!0}if("object"==typeof e&&null!==e&&null!==n){if("object"!=typeof n)return!1;if(Object.keys(e).length!==Object.keys(n).length)return!1;for(var i in e)if(!t(e[i],n[i]))return!1;return!0}return e===n},t.dot=function(t,e){return t[0]*e[0]+t[1]*e[1]+t[2]*e[2]},t.dot$1=function(t,e){return t[0]*e[0]+t[1]*e[1]+t[2]*e[2]+t[3]*e[3]},t.ease=c,t.emitValidationErrors=Br,t.endsWith=y,t.enforceCacheSizeLimit=function(t){ct(),tt&&tt.then((function(e){e.keys().then((function(n){for(var r=0;r<n.length-t;r++)e.delete(n[r])}))}))},t.evaluateSizeForFeature=ju,t.evaluateSizeForZoom=Fu,t.evaluateVariableOffset=oc,t.evented=ri,t.extend=f,t.featureFilter=ar,t.filterObject=_,t.fromRotation=function(t,e){var n=Math.sin(e),r=Math.cos(e);return t[0]=r,t[1]=n,t[2]=0,t[3]=-n,t[4]=r,t[5]=0,t[6]=0,t[7]=0,t[8]=1,t},t.getAnchorAlignment=Bu,t.getAnchorJustification=ac,t.getArrayBuffer=_t,t.getImage=wt,t.getJSON=function(t,e){return vt(f(t,{type:"json"}),e)},t.getRTLTextPluginStatus=ii,t.getReferrer=yt,t.getVideo=function(t,e){var n,r,i=a.document.createElement("video");i.muted=!0,i.onloadstart=function(){e(null,i)};for(var o=0;o<t.length;o++){var s=a.document.createElement("source");n=t[o],r=void 0,(r=a.document.createElement("a")).href=n,(r.protocol!==a.document.location.protocol||r.host!==a.document.location.host)&&(i.crossOrigin="Anonymous"),s.src=t[o],i.appendChild(s)}return{cancel:function(){}}},t.identity=sa,t.invert=function(t,e){var n=e[0],r=e[1],i=e[2],o=e[3],a=e[4],s=e[5],u=e[6],c=e[7],l=e[8],h=e[9],f=e[10],p=e[11],d=e[12],A=e[13],g=e[14],m=e[15],y=n*s-r*a,v=n*u-i*a,_=n*c-o*a,b=r*u-i*s,x=r*c-o*s,w=i*c-o*u,E=l*A-h*d,O=l*g-f*d,S=l*m-p*d,T=h*g-f*A,C=h*m-p*A,P=f*m-p*g,M=y*P-v*C+_*T+b*S-x*O+w*E;return M?(t[0]=(s*P-u*C+c*T)*(M=1/M),t[1]=(i*C-r*P-o*T)*M,t[2]=(A*w-g*x+m*b)*M,t[3]=(f*x-h*w-p*b)*M,t[4]=(u*S-a*P-c*O)*M,t[5]=(n*P-i*S+o*O)*M,t[6]=(g*_-d*w-m*v)*M,t[7]=(l*w-f*_+p*v)*M,t[8]=(a*C-s*S+c*E)*M,t[9]=(r*S-n*C-o*E)*M,t[10]=(d*x-A*_+m*y)*M,t[11]=(h*_-l*x-p*y)*M,t[12]=(s*O-a*T-u*E)*M,t[13]=(n*T-r*O+i*E)*M,t[14]=(A*v-d*b-g*y)*M,t[15]=(l*b-h*v+f*y)*M,t):null},t.isChar=Wr,t.isMapboxURL=q,t.keysDifference=function(t,e){var n=[];for(var r in t)r in e||n.push(r);return n},t.makeRequest=vt,t.mapObject=v,t.mercatorXfromLng=Nc,t.mercatorYfromLat=Gc,t.mercatorZfromAltitude=Vc,t.mul=la,t.multiply=ua,t.mvt=_s,t.nextPowerOfTwo=function(t){return t<=1?1:Math.pow(2,Math.ceil(Math.log(t)/Math.LN2))},t.normalize=function(t,e){var n=e[0],r=e[1],i=e[2],o=n*n+r*r+i*i;return o>0&&(o=1/Math.sqrt(o)),t[0]=e[0]*o,t[1]=e[1]*o,t[2]=e[2]*o,t},t.number=He,t.offscreenCanvasSupported=pt,t.ortho=function(t,e,n,r,i,o,a){var s=1/(e-n),u=1/(r-i),c=1/(o-a);return t[0]=-2*s,t[1]=0,t[2]=0,t[3]=0,t[4]=0,t[5]=-2*u,t[6]=0,t[7]=0,t[8]=0,t[9]=0,t[10]=2*c,t[11]=0,t[12]=(e+n)*s,t[13]=(i+r)*u,t[14]=(a+o)*c,t[15]=1,t},t.parseGlyphPBF=function(t){return new Qs(t).readFields(du,[])},t.pbf=Qs,t.performSymbolLayout=function(t,e,n,r,i,o,a){t.createArrays(),t.tilePixelRatio=8192/(512*t.overscaling),t.compareText={},t.iconsNeedLinear=!1;var s=t.layers[0].layout,u=t.layers[0]._unevaluatedLayout._values,c={};if("composite"===t.textSizeData.kind){var l=t.textSizeData,h=l.maxZoom;c.compositeTextSizes=[u["text-size"].possiblyEvaluate(new si(l.minZoom),a),u["text-size"].possiblyEvaluate(new si(h),a)]}if("composite"===t.iconSizeData.kind){var f=t.iconSizeData,p=f.maxZoom;c.compositeIconSizes=[u["icon-size"].possiblyEvaluate(new si(f.minZoom),a),u["icon-size"].possiblyEvaluate(new si(p),a)]}c.layoutTextSize=u["text-size"].possiblyEvaluate(new si(t.zoom+1),a),c.layoutIconSize=u["icon-size"].possiblyEvaluate(new si(t.zoom+1),a),c.textMaxSize=u["text-size"].possiblyEvaluate(new si(18));for(var d=24*s.get("text-line-height"),A="map"===s.get("text-rotation-alignment")&&"point"!==s.get("symbol-placement"),g=s.get("text-keep-upright"),m=s.get("text-size"),y=function(){var o=_[v],u=s.get("text-font").evaluate(o,{},a).join(","),l=m.evaluate(o,{},a),h=c.layoutTextSize.evaluate(o,{},a),f=c.layoutIconSize.evaluate(o,{},a),p={horizontal:{},vertical:void 0},y=o.text,b=[0,0];if(y){var x=y.toString(),E=24*s.get("text-letter-spacing").evaluate(o,{},a),O=function(t){for(var e=0,n=t;e<n.length;e+=1)if(r=n[e].charCodeAt(0),Wr.Arabic(r)||Wr["Arabic Supplement"](r)||Wr["Arabic Extended-A"](r)||Wr["Arabic Presentation Forms-A"](r)||Wr["Arabic Presentation Forms-B"](r))return!1;var r;return!0}(x)?E:0,S=s.get("text-anchor").evaluate(o,{},a),T=s.get("text-variable-anchor");if(!T){var C=s.get("text-radial-offset").evaluate(o,{},a);b=C?oc(S,[24*C,ic]):s.get("text-offset").evaluate(o,{},a).map((function(t){return 24*t}))}var P=A?"center":s.get("text-justify").evaluate(o,{},a),M=s.get("symbol-placement"),I="point"===M?24*s.get("text-max-width").evaluate(o,{},a):0,B=function(){t.allowVerticalPlacement&&qr(x)&&(p.vertical=Eu(y,e,n,i,u,I,d,S,"left",O,b,bu.vertical,!0,M,h,l))};if(!A&&T){for(var R="auto"===P?T.map((function(t){return ac(t)})):[P],k=!1,D=0;D<R.length;D++){var L=R[D];if(!p.horizontal[L])if(k)p.horizontal[L]=p.horizontal[0];else{var j=Eu(y,e,n,i,u,I,d,"center",L,O,b,bu.horizontal,!1,M,h,l);j&&(p.horizontal[L]=j,k=1===j.positionedLines.length)}}B()}else{"auto"===P&&(P=ac(S));var F=Eu(y,e,n,i,u,I,d,S,P,O,b,bu.horizontal,!1,M,h,l);F&&(p.horizontal[P]=F),B(),qr(x)&&A&&g&&(p.vertical=Eu(y,e,n,i,u,I,d,S,P,O,b,bu.vertical,!1,M,h,l))}}var z=void 0,U=!1;if(o.icon&&o.icon.name){var N=r[o.icon.name];N&&(z=function(t,e,n){var r=Bu(n),i=e[0]-t.displaySize[0]*r.horizontalAlign,o=e[1]-t.displaySize[1]*r.verticalAlign;return{image:t,top:o,bottom:o+t.displaySize[1],left:i,right:i+t.displaySize[0]}}(i[o.icon.name],s.get("icon-offset").evaluate(o,{},a),s.get("icon-anchor").evaluate(o,{},a)),U=N.sdf,void 0===t.sdfIcons?t.sdfIcons=N.sdf:t.sdfIcons!==N.sdf&&w("Style sheet warning: Cannot mix SDF and non-SDF icons in one buffer"),(N.pixelRatio!==t.pixelRatio||0!==s.get("icon-rotate").constantOr(1))&&(t.iconsNeedLinear=!0))}var G=uc(p.horizontal)||p.vertical;t.iconsInText=!!G&&G.iconsInText,(G||z)&&function(t,e,n,r,i,o,a,s,u,c,l){var h=o.textMaxSize.evaluate(e,{});void 0===h&&(h=a);var f,p=t.layers[0].layout,d=p.get("icon-offset").evaluate(e,{},l),A=uc(n.horizontal),g=a/24,m=t.tilePixelRatio*g,y=t.tilePixelRatio*h/24,v=t.tilePixelRatio*s,_=t.tilePixelRatio*p.get("symbol-spacing"),b=p.get("text-padding")*t.tilePixelRatio,x=p.get("icon-padding")*t.tilePixelRatio,E=p.get("text-max-angle")/180*Math.PI,O="map"===p.get("text-rotation-alignment")&&"point"!==p.get("symbol-placement"),S="map"===p.get("icon-rotation-alignment")&&"point"!==p.get("symbol-placement"),T=p.get("symbol-placement"),C=_/2,P=p.get("icon-text-fit");r&&"none"!==P&&(t.allowVerticalPlacement&&n.vertical&&(f=ku(r,n.vertical,P,p.get("icon-text-fit-padding"),d,g)),A&&(r=ku(r,A,P,p.get("icon-text-fit-padding"),d,g)));var M=function(s,h){h.x<0||h.x>=8192||h.y<0||h.y>=8192||function(t,e,n,r,i,o,a,s,u,c,l,h,f,p,d,A,g,m,y,v,_,b,x,E,O){var S,T,C,P,M,I=t.addToLineVertexArray(e,n),B=0,R=0,k=0,D=0,L=-1,j=-1,F={},z=fo(""),U=0,N=0;if(void 0===s._unevaluatedLayout.getValue("text-radial-offset")?(U=(S=s.layout.get("text-offset").evaluate(_,{},E).map((function(t){return 24*t})))[0],N=S[1]):(U=24*s.layout.get("text-radial-offset").evaluate(_,{},E),N=ic),t.allowVerticalPlacement&&r.vertical){var G=s.layout.get("text-rotate").evaluate(_,{},E)+90;P=new Yu(u,e,c,l,h,r.vertical,f,p,d,G),a&&(M=new Yu(u,e,c,l,h,a,g,m,d,G))}if(i){var V=s.layout.get("icon-rotate").evaluate(_,{}),H="none"!==s.layout.get("icon-text-fit"),W=Xu(i,V,x,H),q=a?Xu(a,V,x,H):void 0;C=new Yu(u,e,c,l,h,i,g,m,!1,V),B=4*W.length;var X=t.iconSizeData,Z=null;"source"===X.kind?(Z=[128*s.layout.get("icon-size").evaluate(_,{})])[0]>32640&&w(t.layerIds[0]+': Value for "icon-size" is >= 255. Reduce your "icon-size".'):"composite"===X.kind&&((Z=[128*b.compositeIconSizes[0].evaluate(_,{},E),128*b.compositeIconSizes[1].evaluate(_,{},E)])[0]>32640||Z[1]>32640)&&w(t.layerIds[0]+': Value for "icon-size" is >= 255. Reduce your "icon-size".'),t.addSymbols(t.icon,W,Z,v,y,_,!1,e,I.lineStartIndex,I.lineLength,-1,E),L=t.icon.placedSymbolArray.length-1,q&&(R=4*q.length,t.addSymbols(t.icon,q,Z,v,y,_,bu.vertical,e,I.lineStartIndex,I.lineLength,-1,E),j=t.icon.placedSymbolArray.length-1)}for(var J in r.horizontal){var Q=r.horizontal[J];if(!T){z=fo(Q.text);var K=s.layout.get("text-rotate").evaluate(_,{},E);T=new Yu(u,e,c,l,h,Q,f,p,d,K)}var Y=1===Q.positionedLines.length;if(k+=sc(t,e,Q,o,s,d,_,A,I,r.vertical?bu.horizontal:bu.horizontalOnly,Y?Object.keys(r.horizontal):[J],F,L,b,E),Y)break}r.vertical&&(D+=sc(t,e,r.vertical,o,s,d,_,A,I,bu.vertical,["vertical"],F,j,b,E));var $=T?T.boxStartIndex:t.collisionBoxArray.length,tt=T?T.boxEndIndex:t.collisionBoxArray.length,et=P?P.boxStartIndex:t.collisionBoxArray.length,nt=P?P.boxEndIndex:t.collisionBoxArray.length,rt=C?C.boxStartIndex:t.collisionBoxArray.length,it=C?C.boxEndIndex:t.collisionBoxArray.length,ot=M?M.boxStartIndex:t.collisionBoxArray.length,at=M?M.boxEndIndex:t.collisionBoxArray.length,st=-1,ut=function(t,e){return t&&t.circleDiameter?Math.max(t.circleDiameter,e):e};st=ut(T,st),st=ut(P,st),st=ut(C,st);var ct=(st=ut(M,st))>-1?1:0;ct&&(st*=O/24),t.glyphOffsetArray.length>=mc.MAX_GLYPHS&&w("Too many glyphs being rendered in a tile. See https://github.com/mapbox/mapbox-gl-js/issues/2907"),void 0!==_.sortKey&&t.addToSortKeyRanges(t.symbolInstances.length,_.sortKey),t.symbolInstances.emplaceBack(e.x,e.y,F.right>=0?F.right:-1,F.center>=0?F.center:-1,F.left>=0?F.left:-1,F.vertical||-1,L,j,z,$,tt,et,nt,rt,it,ot,at,c,k,D,B,R,ct,0,f,U,N,st)}(t,h,s,n,r,i,f,t.layers[0],t.collisionBoxArray,e.index,e.sourceLayerIndex,t.index,m,b,O,u,v,x,S,d,e,o,c,l,a)};if("line"===T)for(var I=0,B=qu(e.geometry,0,0,8192,8192);I<B.length;I+=1)for(var R=B[I],k=0,D=Wu(R,_,E,n.vertical||A,r,24,y,t.overscaling,8192);k<D.length;k+=1){var L=D[k];A&&cc(t,A.text,C,L)||M(R,L)}else if("line-center"===T)for(var j=0,F=e.geometry;j<F.length;j+=1){var z=F[j];if(z.length>1){var U=Hu(z,E,n.vertical||A,r,24,y);U&&M(z,U)}}else if("Polygon"===e.type)for(var N=0,G=rs(e.geometry,0);N<G.length;N+=1){var V=G[N],H=ec(V,16);M(V[0],new Du(H.x,H.y,0))}else if("LineString"===e.type)for(var W=0,q=e.geometry;W<q.length;W+=1){var X=q[W];M(X,new Du(X[0].x,X[0].y,0))}else if("Point"===e.type)for(var Z=0,J=e.geometry;Z<J.length;Z+=1)for(var Q=0,K=J[Z];Q<K.length;Q+=1){var Y=K[Q];M([Y],new Du(Y.x,Y.y,0))}}(t,o,p,z,r,c,h,f,b,U,a)},v=0,_=t.features;v<_.length;v+=1)y();o&&t.generateCollisionDebugBuffers()},t.perspective=function(t,e,n,r,i){var o,a=1/Math.tan(e/2);return t[0]=a/n,t[1]=0,t[2]=0,t[3]=0,t[4]=0,t[5]=a,t[6]=0,t[7]=0,t[8]=0,t[9]=0,t[11]=-1,t[12]=0,t[13]=0,t[15]=0,null!=i&&i!==1/0?(t[10]=(i+r)*(o=1/(r-i)),t[14]=2*i*r*o):(t[10]=-1,t[14]=-2*r),t},t.pick=function(t,e){for(var n={},r=0;r<e.length;r++){var i=e[r];i in t&&(n[i]=t[i])}return n},t.plugin=ai,t.polygonIntersectsPolygon=Ho,t.postMapLoadEvent=at,t.postTurnstileEvent=it,t.potpack=mu,t.refProperties=["type","source","source-layer","minzoom","maxzoom","filter","layout"],t.register=Fr,t.registerForPluginStateChange=function(t){return t({pluginStatus:$r,pluginURL:ti}),ri.on("pluginStateChange",t),t},t.renderColorRamp=ba,t.rotate=function(t,e,n){var r=e[0],i=e[1],o=e[2],a=e[3],s=Math.sin(n),u=Math.cos(n);return t[0]=r*u+o*s,t[1]=i*u+a*s,t[2]=r*-s+o*u,t[3]=i*-s+a*u,t},t.rotateX=function(t,e,n){var r=Math.sin(n),i=Math.cos(n),o=e[4],a=e[5],s=e[6],u=e[7],c=e[8],l=e[9],h=e[10],f=e[11];return e!==t&&(t[0]=e[0],t[1]=e[1],t[2]=e[2],t[3]=e[3],t[12]=e[12],t[13]=e[13],t[14]=e[14],t[15]=e[15]),t[4]=o*i+c*r,t[5]=a*i+l*r,t[6]=s*i+h*r,t[7]=u*i+f*r,t[8]=c*i-o*r,t[9]=l*i-a*r,t[10]=h*i-s*r,t[11]=f*i-u*r,t},t.rotateZ=function(t,e,n){var r=Math.sin(n),i=Math.cos(n),o=e[0],a=e[1],s=e[2],u=e[3],c=e[4],l=e[5],h=e[6],f=e[7];return e!==t&&(t[8]=e[8],t[9]=e[9],t[10]=e[10],t[11]=e[11],t[12]=e[12],t[13]=e[13],t[14]=e[14],t[15]=e[15]),t[0]=o*i+c*r,t[1]=a*i+l*r,t[2]=s*i+h*r,t[3]=u*i+f*r,t[4]=c*i-o*r,t[5]=l*i-a*r,t[6]=h*i-s*r,t[7]=f*i-u*r,t},t.scale=function(t,e,n){var r=n[0],i=n[1],o=n[2];return t[0]=e[0]*r,t[1]=e[1]*r,t[2]=e[2]*r,t[3]=e[3]*r,t[4]=e[4]*i,t[5]=e[5]*i,t[6]=e[6]*i,t[7]=e[7]*i,t[8]=e[8]*o,t[9]=e[9]*o,t[10]=e[10]*o,t[11]=e[11]*o,t[12]=e[12],t[13]=e[13],t[14]=e[14],t[15]=e[15],t},t.scale$1=function(t,e,n){return t[0]=e[0]*n,t[1]=e[1]*n,t[2]=e[2]*n,t[3]=e[3]*n,t},t.scale$2=function(t,e,n){return t[0]=e[0]*n,t[1]=e[1]*n,t[2]=e[2]*n,t},t.setCacheLimits=function(t,e){st=t,ut=e},t.setRTLTextPlugin=function(t,e,n){if(void 0===n&&(n=!1),"deferred"===$r||"loading"===$r||"loaded"===$r)throw new Error("setRTLTextPlugin cannot be called multiple times.");ti=F.resolveURL(t),$r="deferred",Yr=e,ni(),n||oi()},t.sphericalToCartesian=function(t){var e=t[0],n=t[1],r=t[2];return n+=90,n*=Math.PI/180,r*=Math.PI/180,{x:e*Math.cos(n)*Math.sin(r),y:e*Math.sin(n)*Math.sin(r),z:e*Math.cos(r)}},t.sqrLen=function(t){var e=t[0],n=t[1];return e*e+n*n},t.styleSpec=Pt,t.sub=function(t,e,n){return t[0]=e[0]-n[0],t[1]=e[1]-n[1],t[2]=e[2]-n[2],t},t.symbolSize=zu,t.transformMat3=function(t,e,n){var r=e[0],i=e[1],o=e[2];return t[0]=r*n[0]+i*n[3]+o*n[6],t[1]=r*n[1]+i*n[4]+o*n[7],t[2]=r*n[2]+i*n[5]+o*n[8],t},t.transformMat4=ha,t.translate=function(t,e,n){var r,i,o,a,s,u,c,l,h,f,p,d,A=n[0],g=n[1],m=n[2];return e===t?(t[12]=e[0]*A+e[4]*g+e[8]*m+e[12],t[13]=e[1]*A+e[5]*g+e[9]*m+e[13],t[14]=e[2]*A+e[6]*g+e[10]*m+e[14],t[15]=e[3]*A+e[7]*g+e[11]*m+e[15]):(i=e[1],o=e[2],a=e[3],s=e[4],u=e[5],c=e[6],l=e[7],h=e[8],f=e[9],p=e[10],d=e[11],t[0]=r=e[0],t[1]=i,t[2]=o,t[3]=a,t[4]=s,t[5]=u,t[6]=c,t[7]=l,t[8]=h,t[9]=f,t[10]=p,t[11]=d,t[12]=r*A+s*g+h*m+e[12],t[13]=i*A+u*g+f*m+e[13],t[14]=o*A+c*g+p*m+e[14],t[15]=a*A+l*g+d*m+e[15]),t},t.triggerPluginCompletionEvent=ei,t.uniqueId=d,t.validateCustomStyleLayer=function(t){var e=[],n=t.id;return void 0===n&&e.push({message:"layers."+n+': missing required property "id"'}),void 0===t.render&&e.push({message:"layers."+n+': missing required method "render"'}),t.renderingMode&&"2d"!==t.renderingMode&&"3d"!==t.renderingMode&&e.push({message:"layers."+n+': property "renderingMode" must be either "2d" or "3d"'}),e},t.validateLight=Pr,t.validateStyle=Cr,t.values=function(t){var e=[];for(var n in t)e.push(t[n]);return e},t.vectorTile=_s,t.version="1.13.3",t.warnOnce=w,t.webpSupported=U,t.window=a,t.wrap=h})),r(0,(function(t){function e(t){var n=typeof t;if("number"===n||"boolean"===n||"string"===n||null==t)return JSON.stringify(t);if(Array.isArray(t)){for(var r="[",i=0,o=t;i<o.length;i+=1)r+=e(o[i])+",";return r+"]"}for(var a=Object.keys(t).sort(),s="{",u=0;u<a.length;u++)s+=JSON.stringify(a[u])+":"+e(t[a[u]])+",";return s+"}"}function n(n){for(var r="",i=0,o=t.refProperties;i<o.length;i+=1)r+="/"+e(n[o[i]]);return r}var r=function(t){this.keyCache={},t&&this.replace(t)};r.prototype.replace=function(t){this._layerConfigs={},this._layers={},this.update(t,[])},r.prototype.update=function(e,r){for(var i=this,o=0,a=e;o<a.length;o+=1){var s=a[o];this._layerConfigs[s.id]=s;var u=this._layers[s.id]=t.createStyleLayer(s);u._featureFilter=t.featureFilter(u.filter),this.keyCache[s.id]&&delete this.keyCache[s.id]}for(var c=0,l=r;c<l.length;c+=1){var h=l[c];delete this.keyCache[h],delete this._layerConfigs[h],delete this._layers[h]}this.familiesBySource={};for(var f=0,p=function(t,e){for(var r={},i=0;i<t.length;i++){var o=e&&e[t[i].id]||n(t[i]);e&&(e[t[i].id]=o);var a=r[o];a||(a=r[o]=[]),a.push(t[i])}var s=[];for(var u in r)s.push(r[u]);return s}(t.values(this._layerConfigs),this.keyCache);f<p.length;f+=1){var d=p[f].map((function(t){return i._layers[t.id]})),A=d[0];if("none"!==A.visibility){var g=A.source||"",m=this.familiesBySource[g];m||(m=this.familiesBySource[g]={});var y=A.sourceLayer||"_geojsonTileLayer",v=m[y];v||(v=m[y]=[]),v.push(d)}}};var i=function(e){var n={},r=[];for(var i in e){var o=e[i],a=n[i]={};for(var s in o){var u=o[+s];if(u&&0!==u.bitmap.width&&0!==u.bitmap.height){var c={x:0,y:0,w:u.bitmap.width+2,h:u.bitmap.height+2};r.push(c),a[s]={rect:c,metrics:u.metrics}}}}var l=t.potpack(r),h=new t.AlphaImage({width:l.w||1,height:l.h||1});for(var f in e){var p=e[f];for(var d in p){var A=p[+d];if(A&&0!==A.bitmap.width&&0!==A.bitmap.height){var g=n[f][d].rect;t.AlphaImage.copy(A.bitmap,h,{x:0,y:0},{x:g.x+1,y:g.y+1},A.bitmap)}}}this.image=h,this.positions=n};t.register("GlyphAtlas",i);var o=function(e){this.tileID=new t.OverscaledTileID(e.tileID.overscaledZ,e.tileID.wrap,e.tileID.canonical.z,e.tileID.canonical.x,e.tileID.canonical.y),this.uid=e.uid,this.zoom=e.zoom,this.pixelRatio=e.pixelRatio,this.tileSize=e.tileSize,this.source=e.source,this.overscaling=this.tileID.overscaleFactor(),this.showCollisionBoxes=e.showCollisionBoxes,this.collectResourceTiming=!!e.collectResourceTiming,this.returnDependencies=!!e.returnDependencies,this.promoteId=e.promoteId};function a(e,n,r){for(var i=new t.EvaluationParameters(n),o=0,a=e;o<a.length;o+=1)a[o].recalculate(i,r)}function s(e,n){var r=t.getArrayBuffer(e.request,(function(e,r,i,o){e?n(e):r&&n(null,{vectorTile:new t.vectorTile.VectorTile(new t.pbf(r)),rawData:r,cacheControl:i,expires:o})}));return function(){r.cancel(),n()}}o.prototype.parse=function(e,n,r,o,s){var u=this;this.status="parsing",this.data=e,this.collisionBoxArray=new t.CollisionBoxArray;var c=new t.DictionaryCoder(Object.keys(e.layers).sort()),l=new t.FeatureIndex(this.tileID,this.promoteId);l.bucketLayerIDs=[];var h,f,p,d,A={},g={featureIndex:l,iconDependencies:{},patternDependencies:{},glyphDependencies:{},availableImages:r},m=n.familiesBySource[this.source];for(var y in m){var v=e.layers[y];if(v){1===v.version&&t.warnOnce('Vector tile source "'+this.source+'" layer "'+y+'" does not use vector tile spec v2 and therefore may have some rendering errors.');for(var _=c.encode(y),b=[],x=0;x<v.length;x++){var w=v.feature(x),E=l.getId(w,y);b.push({feature:w,id:E,index:x,sourceLayerIndex:_})}for(var O=0,S=m[y];O<S.length;O+=1){var T=S[O],C=T[0];C.minzoom&&this.zoom<Math.floor(C.minzoom)||C.maxzoom&&this.zoom>=C.maxzoom||"none"!==C.visibility&&(a(T,this.zoom,r),(A[C.id]=C.createBucket({index:l.bucketLayerIDs.length,layers:T,zoom:this.zoom,pixelRatio:this.pixelRatio,overscaling:this.overscaling,collisionBoxArray:this.collisionBoxArray,sourceLayerIndex:_,sourceID:this.source})).populate(b,g,this.tileID.canonical),l.bucketLayerIDs.push(T.map((function(t){return t.id}))))}}}var P=t.mapObject(g.glyphDependencies,(function(t){return Object.keys(t).map(Number)}));Object.keys(P).length?o.send("getGlyphs",{uid:this.uid,stacks:P},(function(t,e){h||(h=t,f=e,B.call(u))})):f={};var M=Object.keys(g.iconDependencies);M.length?o.send("getImages",{icons:M,source:this.source,tileID:this.tileID,type:"icons"},(function(t,e){h||(h=t,p=e,B.call(u))})):p={};var I=Object.keys(g.patternDependencies);function B(){if(h)return s(h);if(f&&p&&d){var e=new i(f),n=new t.ImageAtlas(p,d);for(var o in A){var u=A[o];u instanceof t.SymbolBucket?(a(u.layers,this.zoom,r),t.performSymbolLayout(u,f,e.positions,p,n.iconPositions,this.showCollisionBoxes,this.tileID.canonical)):u.hasPattern&&(u instanceof t.LineBucket||u instanceof t.FillBucket||u instanceof t.FillExtrusionBucket)&&(a(u.layers,this.zoom,r),u.addFeatures(g,this.tileID.canonical,n.patternPositions))}this.status="done",s(null,{buckets:t.values(A).filter((function(t){return!t.isEmpty()})),featureIndex:l,collisionBoxArray:this.collisionBoxArray,glyphAtlasImage:e.image,imageAtlas:n,glyphMap:this.returnDependencies?f:null,iconMap:this.returnDependencies?p:null,glyphPositions:this.returnDependencies?e.positions:null})}}I.length?o.send("getImages",{icons:I,source:this.source,tileID:this.tileID,type:"patterns"},(function(t,e){h||(h=t,d=e,B.call(u))})):d={},B.call(this)};var u=function(t,e,n,r){this.actor=t,this.layerIndex=e,this.availableImages=n,this.loadVectorData=r||s,this.loading={},this.loaded={}};u.prototype.loadTile=function(e,n){var r=this,i=e.uid;this.loading||(this.loading={});var a=!!(e&&e.request&&e.request.collectResourceTiming)&&new t.RequestPerformance(e.request),s=this.loading[i]=new o(e);s.abort=this.loadVectorData(e,(function(e,o){if(delete r.loading[i],e||!o)return s.status="done",r.loaded[i]=s,n(e);var u=o.rawData,c={};o.expires&&(c.expires=o.expires),o.cacheControl&&(c.cacheControl=o.cacheControl);var l={};if(a){var h=a.finish();h&&(l.resourceTiming=JSON.parse(JSON.stringify(h)))}s.vectorTile=o.vectorTile,s.parse(o.vectorTile,r.layerIndex,r.availableImages,r.actor,(function(e,r){if(e||!r)return n(e);n(null,t.extend({rawTileData:u.slice(0)},r,c,l))})),r.loaded=r.loaded||{},r.loaded[i]=s}))},u.prototype.reloadTile=function(t,e){var n=this,r=this.loaded,i=t.uid,o=this;if(r&&r[i]){var a=r[i];a.showCollisionBoxes=t.showCollisionBoxes;var s=function(t,r){var i=a.reloadCallback;i&&(delete a.reloadCallback,a.parse(a.vectorTile,o.layerIndex,n.availableImages,o.actor,i)),e(t,r)};"parsing"===a.status?a.reloadCallback=s:"done"===a.status&&(a.vectorTile?a.parse(a.vectorTile,this.layerIndex,this.availableImages,this.actor,s):s())}},u.prototype.abortTile=function(t,e){var n=this.loading,r=t.uid;n&&n[r]&&n[r].abort&&(n[r].abort(),delete n[r]),e()},u.prototype.removeTile=function(t,e){var n=this.loaded,r=t.uid;n&&n[r]&&delete n[r],e()};var c=t.window.ImageBitmap,l=function(){this.loaded={}};function h(t,e){if(0!==t.length){f(t[0],e);for(var n=1;n<t.length;n++)f(t[n],!e)}}function f(t,e){for(var n=0,r=0,i=0,o=t.length,a=o-1;i<o;a=i++){var s=(t[i][0]-t[a][0])*(t[a][1]+t[i][1]),u=n+s;r+=Math.abs(n)>=Math.abs(s)?n-u+s:s-u+n,n=u}n+r>=0!=!!e&&t.reverse()}l.prototype.loadTile=function(e,n){var r=e.uid,i=e.encoding,o=e.rawImageData,a=c&&o instanceof c?this.getImageData(o):o,s=new t.DEMData(r,a,i);this.loaded=this.loaded||{},this.loaded[r]=s,n(null,s)},l.prototype.getImageData=function(e){this.offscreenCanvas&&this.offscreenCanvasContext||(this.offscreenCanvas=new OffscreenCanvas(e.width,e.height),this.offscreenCanvasContext=this.offscreenCanvas.getContext("2d")),this.offscreenCanvas.width=e.width,this.offscreenCanvas.height=e.height,this.offscreenCanvasContext.drawImage(e,0,0,e.width,e.height);var n=this.offscreenCanvasContext.getImageData(-1,-1,e.width+2,e.height+2);return this.offscreenCanvasContext.clearRect(0,0,this.offscreenCanvas.width,this.offscreenCanvas.height),new t.RGBAImage({width:n.width,height:n.height},n.data)},l.prototype.removeTile=function(t){var e=this.loaded,n=t.uid;e&&e[n]&&delete e[n]};var p=t.vectorTile.VectorTileFeature.prototype.toGeoJSON,d=function(e){this._feature=e,this.extent=t.EXTENT,this.type=e.type,this.properties=e.tags,"id"in e&&!isNaN(e.id)&&(this.id=parseInt(e.id,10))};d.prototype.loadGeometry=function(){if(1===this._feature.type){for(var e=[],n=0,r=this._feature.geometry;n<r.length;n+=1){var i=r[n];e.push([new t.Point$1(i[0],i[1])])}return e}for(var o=[],a=0,s=this._feature.geometry;a<s.length;a+=1){for(var u=[],c=0,l=s[a];c<l.length;c+=1){var h=l[c];u.push(new t.Point$1(h[0],h[1]))}o.push(u)}return o},d.prototype.toGeoJSON=function(t,e,n){return p.call(this,t,e,n)};var A=function(e){this.layers={_geojsonTileLayer:this},this.name="_geojsonTileLayer",this.extent=t.EXTENT,this.length=e.length,this._features=e};A.prototype.feature=function(t){return new d(this._features[t])};var g=t.vectorTile.VectorTileFeature,m=y;function y(t,e){this.options=e||{},this.features=t,this.length=t.length}function v(t,e){this.id="number"==typeof t.id?t.id:void 0,this.type=t.type,this.rawGeometry=1===t.type?[t.geometry]:t.geometry,this.properties=t.tags,this.extent=e||4096}y.prototype.feature=function(t){return new v(this.features[t],this.options.extent)},v.prototype.loadGeometry=function(){var e=this.rawGeometry;this.geometry=[];for(var n=0;n<e.length;n++){for(var r=e[n],i=[],o=0;o<r.length;o++)i.push(new t.Point$1(r[o][0],r[o][1]));this.geometry.push(i)}return this.geometry},v.prototype.bbox=function(){this.geometry||this.loadGeometry();for(var t=this.geometry,e=1/0,n=-1/0,r=1/0,i=-1/0,o=0;o<t.length;o++)for(var a=t[o],s=0;s<a.length;s++){var u=a[s];e=Math.min(e,u.x),n=Math.max(n,u.x),r=Math.min(r,u.y),i=Math.max(i,u.y)}return[e,r,n,i]},v.prototype.toGeoJSON=g.prototype.toGeoJSON;var _=x,b=m;function x(e){var n=new t.pbf;return function(t,e){for(var n in t.layers)e.writeMessage(3,w,t.layers[n])}(e,n),n.finish()}function w(t,e){var n;e.writeVarintField(15,t.version||1),e.writeStringField(1,t.name||""),e.writeVarintField(5,t.extent||4096);var r={keys:[],values:[],keycache:{},valuecache:{}};for(n=0;n<t.length;n++)r.feature=t.feature(n),e.writeMessage(2,E,r);var i=r.keys;for(n=0;n<i.length;n++)e.writeStringField(3,i[n]);var o=r.values;for(n=0;n<o.length;n++)e.writeMessage(4,P,o[n])}function E(t,e){var n=t.feature;void 0!==n.id&&e.writeVarintField(1,n.id),e.writeMessage(2,O,t),e.writeVarintField(3,n.type),e.writeMessage(4,C,n)}function O(t,e){var n=t.feature,r=t.keys,i=t.values,o=t.keycache,a=t.valuecache;for(var s in n.properties){var u=o[s];void 0===u&&(r.push(s),o[s]=u=r.length-1),e.writeVarint(u);var c=n.properties[s],l=typeof c;"string"!==l&&"boolean"!==l&&"number"!==l&&(c=JSON.stringify(c));var h=l+":"+c,f=a[h];void 0===f&&(i.push(c),a[h]=f=i.length-1),e.writeVarint(f)}}function S(t,e){return(e<<3)+(7&t)}function T(t){return t<<1^t>>31}function C(t,e){for(var n=t.loadGeometry(),r=t.type,i=0,o=0,a=n.length,s=0;s<a;s++){var u=n[s],c=1;1===r&&(c=u.length),e.writeVarint(S(1,c));for(var l=3===r?u.length-1:u.length,h=0;h<l;h++){1===h&&1!==r&&e.writeVarint(S(2,l-1));var f=u[h].x-i,p=u[h].y-o;e.writeVarint(T(f)),e.writeVarint(T(p)),i+=f,o+=p}3===r&&e.writeVarint(S(7,1))}}function P(t,e){var n=typeof t;"string"===n?e.writeStringField(1,t):"boolean"===n?e.writeBooleanField(7,t):"number"===n&&(t%1!=0?e.writeDoubleField(3,t):t<0?e.writeSVarintField(6,t):e.writeVarintField(5,t))}function M(t,e,n,r){I(t,n,r),I(e,2*n,2*r),I(e,2*n+1,2*r+1)}function I(t,e,n){var r=t[e];t[e]=t[n],t[n]=r}function B(t,e,n,r){var i=t-n,o=e-r;return i*i+o*o}_.fromVectorTileJs=x,_.fromGeojsonVt=function(t,e){e=e||{};var n={};for(var r in t)n[r]=new m(t[r].features,e),n[r].name=r,n[r].version=e.version,n[r].extent=e.extent;return x({layers:n})},_.GeoJSONWrapper=b;var R=function(t){return t[0]},k=function(t){return t[1]},D=function(t,e,n,r,i){void 0===e&&(e=R),void 0===n&&(n=k),void 0===r&&(r=64),void 0===i&&(i=Float64Array),this.nodeSize=r,this.points=t;for(var o=t.length<65536?Uint16Array:Uint32Array,a=this.ids=new o(t.length),s=this.coords=new i(2*t.length),u=0;u<t.length;u++)a[u]=u,s[2*u]=e(t[u]),s[2*u+1]=n(t[u]);!function t(e,n,r,i,o,a){if(!(o-i<=r)){var s=i+o>>1;!function t(e,n,r,i,o,a){for(;o>i;){if(o-i>600){var s=o-i+1,u=r-i+1,c=Math.log(s),l=.5*Math.exp(2*c/3),h=.5*Math.sqrt(c*l*(s-l)/s)*(u-s/2<0?-1:1);t(e,n,r,Math.max(i,Math.floor(r-u*l/s+h)),Math.min(o,Math.floor(r+(s-u)*l/s+h)),a)}var f=n[2*r+a],p=i,d=o;for(M(e,n,i,r),n[2*o+a]>f&&M(e,n,i,o);p<d;){for(M(e,n,p,d),p++,d--;n[2*p+a]<f;)p++;for(;n[2*d+a]>f;)d--}n[2*i+a]===f?M(e,n,i,d):M(e,n,++d,o),d<=r&&(i=d+1),r<=d&&(o=d-1)}}(e,n,s,i,o,a%2),t(e,n,r,i,s-1,a+1),t(e,n,r,s+1,o,a+1)}}(a,s,r,0,a.length-1,0)};D.prototype.range=function(t,e,n,r){return function(t,e,n,r,i,o,a){for(var s,u,c=[0,t.length-1,0],l=[];c.length;){var h=c.pop(),f=c.pop(),p=c.pop();if(f-p<=a)for(var d=p;d<=f;d++)u=e[2*d+1],(s=e[2*d])>=n&&s<=i&&u>=r&&u<=o&&l.push(t[d]);else{var A=Math.floor((p+f)/2);u=e[2*A+1],(s=e[2*A])>=n&&s<=i&&u>=r&&u<=o&&l.push(t[A]);var g=(h+1)%2;(0===h?n<=s:r<=u)&&(c.push(p),c.push(A-1),c.push(g)),(0===h?i>=s:o>=u)&&(c.push(A+1),c.push(f),c.push(g))}}return l}(this.ids,this.coords,t,e,n,r,this.nodeSize)},D.prototype.within=function(t,e,n){return function(t,e,n,r,i,o){for(var a=[0,t.length-1,0],s=[],u=i*i;a.length;){var c=a.pop(),l=a.pop(),h=a.pop();if(l-h<=o)for(var f=h;f<=l;f++)B(e[2*f],e[2*f+1],n,r)<=u&&s.push(t[f]);else{var p=Math.floor((h+l)/2),d=e[2*p],A=e[2*p+1];B(d,A,n,r)<=u&&s.push(t[p]);var g=(c+1)%2;(0===c?n-i<=d:r-i<=A)&&(a.push(h),a.push(p-1),a.push(g)),(0===c?n+i>=d:r+i>=A)&&(a.push(p+1),a.push(l),a.push(g))}}return s}(this.ids,this.coords,t,e,n,this.nodeSize)};var L={minZoom:0,maxZoom:16,minPoints:2,radius:40,extent:512,nodeSize:64,log:!1,generateId:!1,reduce:null,map:function(t){return t}},j=function(t){this.options=H(Object.create(L),t),this.trees=new Array(this.options.maxZoom+1)};function F(t,e,n,r,i){return{x:t,y:e,zoom:1/0,id:n,parentId:-1,numPoints:r,properties:i}}function z(t,e){var n=t.geometry.coordinates,r=n[1];return{x:G(n[0]),y:V(r),zoom:1/0,index:e,parentId:-1}}function U(t){return{type:"Feature",id:t.id,properties:N(t),geometry:{type:"Point",coordinates:[(r=t.x,360*(r-.5)),(e=t.y,n=(180-360*e)*Math.PI/180,360*Math.atan(Math.exp(n))/Math.PI-90)]}};var e,n,r}function N(t){var e=t.numPoints,n=e>=1e4?Math.round(e/1e3)+"k":e>=1e3?Math.round(e/100)/10+"k":e;return H(H({},t.properties),{cluster:!0,cluster_id:t.id,point_count:e,point_count_abbreviated:n})}function G(t){return t/360+.5}function V(t){var e=Math.sin(t*Math.PI/180),n=.5-.25*Math.log((1+e)/(1-e))/Math.PI;return n<0?0:n>1?1:n}function H(t,e){for(var n in e)t[n]=e[n];return t}function W(t){return t.x}function q(t){return t.y}function X(t,e,n,r,i,o){var a=i-n,s=o-r;if(0!==a||0!==s){var u=((t-n)*a+(e-r)*s)/(a*a+s*s);u>1?(n=i,r=o):u>0&&(n+=a*u,r+=s*u)}return(a=t-n)*a+(s=e-r)*s}function Z(t,e,n,r){var i={id:void 0===t?null:t,type:e,geometry:n,tags:r,minX:1/0,minY:1/0,maxX:-1/0,maxY:-1/0};return function(t){var e=t.geometry,n=t.type;if("Point"===n||"MultiPoint"===n||"LineString"===n)J(t,e);else if("Polygon"===n||"MultiLineString"===n)for(var r=0;r<e.length;r++)J(t,e[r]);else if("MultiPolygon"===n)for(r=0;r<e.length;r++)for(var i=0;i<e[r].length;i++)J(t,e[r][i])}(i),i}function J(t,e){for(var n=0;n<e.length;n+=3)t.minX=Math.min(t.minX,e[n]),t.minY=Math.min(t.minY,e[n+1]),t.maxX=Math.max(t.maxX,e[n]),t.maxY=Math.max(t.maxY,e[n+1])}function Q(t,e,n,r){if(e.geometry){var i=e.geometry.coordinates,o=e.geometry.type,a=Math.pow(n.tolerance/((1<<n.maxZoom)*n.extent),2),s=[],u=e.id;if(n.promoteId?u=e.properties[n.promoteId]:n.generateId&&(u=r||0),"Point"===o)K(i,s);else if("MultiPoint"===o)for(var c=0;c<i.length;c++)K(i[c],s);else if("LineString"===o)Y(i,s,a,!1);else if("MultiLineString"===o){if(n.lineMetrics){for(c=0;c<i.length;c++)Y(i[c],s=[],a,!1),t.push(Z(u,"LineString",s,e.properties));return}$(i,s,a,!1)}else if("Polygon"===o)$(i,s,a,!0);else{if("MultiPolygon"!==o){if("GeometryCollection"===o){for(c=0;c<e.geometry.geometries.length;c++)Q(t,{id:u,geometry:e.geometry.geometries[c],properties:e.properties},n,r);return}throw new Error("Input data is not a valid GeoJSON object.")}for(c=0;c<i.length;c++){var l=[];$(i[c],l,a,!0),s.push(l)}}t.push(Z(u,o,s,e.properties))}}function K(t,e){e.push(tt(t[0])),e.push(et(t[1])),e.push(0)}function Y(t,e,n,r){for(var i,o,a=0,s=0;s<t.length;s++){var u=tt(t[s][0]),c=et(t[s][1]);e.push(u),e.push(c),e.push(0),s>0&&(a+=r?(i*c-u*o)/2:Math.sqrt(Math.pow(u-i,2)+Math.pow(c-o,2))),i=u,o=c}var l=e.length-3;e[2]=1,function t(e,n,r,i){for(var o,a=i,s=r-n>>1,u=r-n,c=e[n],l=e[n+1],h=e[r],f=e[r+1],p=n+3;p<r;p+=3){var d=X(e[p],e[p+1],c,l,h,f);if(d>a)o=p,a=d;else if(d===a){var A=Math.abs(p-s);A<u&&(o=p,u=A)}}a>i&&(o-n>3&&t(e,n,o,i),e[o+2]=a,r-o>3&&t(e,o,r,i))}(e,0,l,n),e[l+2]=1,e.size=Math.abs(a),e.start=0,e.end=e.size}function $(t,e,n,r){for(var i=0;i<t.length;i++){var o=[];Y(t[i],o,n,r),e.push(o)}}function tt(t){return t/360+.5}function et(t){var e=Math.sin(t*Math.PI/180),n=.5-.25*Math.log((1+e)/(1-e))/Math.PI;return n<0?0:n>1?1:n}function nt(t,e,n,r,i,o,a,s){if(r/=e,o>=(n/=e)&&a<r)return t;if(a<n||o>=r)return null;for(var u=[],c=0;c<t.length;c++){var l=t[c],h=l.geometry,f=l.type,p=0===i?l.minX:l.minY,d=0===i?l.maxX:l.maxY;if(p>=n&&d<r)u.push(l);else if(!(d<n||p>=r)){var A=[];if("Point"===f||"MultiPoint"===f)rt(h,A,n,r,i);else if("LineString"===f)it(h,A,n,r,i,!1,s.lineMetrics);else if("MultiLineString"===f)at(h,A,n,r,i,!1);else if("Polygon"===f)at(h,A,n,r,i,!0);else if("MultiPolygon"===f)for(var g=0;g<h.length;g++){var m=[];at(h[g],m,n,r,i,!0),m.length&&A.push(m)}if(A.length){if(s.lineMetrics&&"LineString"===f){for(g=0;g<A.length;g++)u.push(Z(l.id,f,A[g],l.tags));continue}"LineString"!==f&&"MultiLineString"!==f||(1===A.length?(f="LineString",A=A[0]):f="MultiLineString"),"Point"!==f&&"MultiPoint"!==f||(f=3===A.length?"Point":"MultiPoint"),u.push(Z(l.id,f,A,l.tags))}}}return u.length?u:null}function rt(t,e,n,r,i){for(var o=0;o<t.length;o+=3){var a=t[o+i];a>=n&&a<=r&&(e.push(t[o]),e.push(t[o+1]),e.push(t[o+2]))}}function it(t,e,n,r,i,o,a){for(var s,u,c=ot(t),l=0===i?ut:ct,h=t.start,f=0;f<t.length-3;f+=3){var p=t[f],d=t[f+1],A=t[f+2],g=t[f+3],m=t[f+4],y=0===i?p:d,v=0===i?g:m,_=!1;a&&(s=Math.sqrt(Math.pow(p-g,2)+Math.pow(d-m,2))),y<n?v>n&&(u=l(c,p,d,g,m,n),a&&(c.start=h+s*u)):y>r?v<r&&(u=l(c,p,d,g,m,r),a&&(c.start=h+s*u)):st(c,p,d,A),v<n&&y>=n&&(u=l(c,p,d,g,m,n),_=!0),v>r&&y<=r&&(u=l(c,p,d,g,m,r),_=!0),!o&&_&&(a&&(c.end=h+s*u),e.push(c),c=ot(t)),a&&(h+=s)}var b=t.length-3;p=t[b],d=t[b+1],A=t[b+2],(y=0===i?p:d)>=n&&y<=r&&st(c,p,d,A),b=c.length-3,o&&b>=3&&(c[b]!==c[0]||c[b+1]!==c[1])&&st(c,c[0],c[1],c[2]),c.length&&e.push(c)}function ot(t){var e=[];return e.size=t.size,e.start=t.start,e.end=t.end,e}function at(t,e,n,r,i,o){for(var a=0;a<t.length;a++)it(t[a],e,n,r,i,o,!1)}function st(t,e,n,r){t.push(e),t.push(n),t.push(r)}function ut(t,e,n,r,i,o){var a=(o-e)/(r-e);return t.push(o),t.push(n+(i-n)*a),t.push(1),a}function ct(t,e,n,r,i,o){var a=(o-n)/(i-n);return t.push(e+(r-e)*a),t.push(o),t.push(1),a}function lt(t,e){for(var n=[],r=0;r<t.length;r++){var i,o=t[r],a=o.type;if("Point"===a||"MultiPoint"===a||"LineString"===a)i=ht(o.geometry,e);else if("MultiLineString"===a||"Polygon"===a){i=[];for(var s=0;s<o.geometry.length;s++)i.push(ht(o.geometry[s],e))}else if("MultiPolygon"===a)for(i=[],s=0;s<o.geometry.length;s++){for(var u=[],c=0;c<o.geometry[s].length;c++)u.push(ht(o.geometry[s][c],e));i.push(u)}n.push(Z(o.id,a,i,o.tags))}return n}function ht(t,e){var n=[];n.size=t.size,void 0!==t.start&&(n.start=t.start,n.end=t.end);for(var r=0;r<t.length;r+=3)n.push(t[r]+e,t[r+1],t[r+2]);return n}function ft(t,e){if(t.transformed)return t;var n,r,i,o=1<<t.z,a=t.x,s=t.y;for(n=0;n<t.features.length;n++){var u=t.features[n],c=u.geometry,l=u.type;if(u.geometry=[],1===l)for(r=0;r<c.length;r+=2)u.geometry.push(pt(c[r],c[r+1],e,o,a,s));else for(r=0;r<c.length;r++){var h=[];for(i=0;i<c[r].length;i+=2)h.push(pt(c[r][i],c[r][i+1],e,o,a,s));u.geometry.push(h)}}return t.transformed=!0,t}function pt(t,e,n,r,i,o){return[Math.round(n*(t*r-i)),Math.round(n*(e*r-o))]}function dt(t,e,n,r,i){for(var o=e===i.maxZoom?0:i.tolerance/((1<<e)*i.extent),a={features:[],numPoints:0,numSimplified:0,numFeatures:0,source:null,x:n,y:r,z:e,transformed:!1,minX:2,minY:1,maxX:-1,maxY:0},s=0;s<t.length;s++){a.numFeatures++,At(a,t[s],o,i);var u=t[s].minX,c=t[s].minY,l=t[s].maxX,h=t[s].maxY;u<a.minX&&(a.minX=u),c<a.minY&&(a.minY=c),l>a.maxX&&(a.maxX=l),h>a.maxY&&(a.maxY=h)}return a}function At(t,e,n,r){var i=e.geometry,o=e.type,a=[];if("Point"===o||"MultiPoint"===o)for(var s=0;s<i.length;s+=3)a.push(i[s]),a.push(i[s+1]),t.numPoints++,t.numSimplified++;else if("LineString"===o)gt(a,i,t,n,!1,!1);else if("MultiLineString"===o||"Polygon"===o)for(s=0;s<i.length;s++)gt(a,i[s],t,n,"Polygon"===o,0===s);else if("MultiPolygon"===o)for(var u=0;u<i.length;u++){var c=i[u];for(s=0;s<c.length;s++)gt(a,c[s],t,n,!0,0===s)}if(a.length){var l=e.tags||null;if("LineString"===o&&r.lineMetrics){for(var h in l={},e.tags)l[h]=e.tags[h];l.mapbox_clip_start=i.start/i.size,l.mapbox_clip_end=i.end/i.size}var f={geometry:a,type:"Polygon"===o||"MultiPolygon"===o?3:"LineString"===o||"MultiLineString"===o?2:1,tags:l};null!==e.id&&(f.id=e.id),t.features.push(f)}}function gt(t,e,n,r,i,o){var a=r*r;if(r>0&&e.size<(i?a:r))n.numPoints+=e.length/3;else{for(var s=[],u=0;u<e.length;u+=3)(0===r||e[u+2]>a)&&(n.numSimplified++,s.push(e[u]),s.push(e[u+1])),n.numPoints++;i&&function(t,e){for(var n=0,r=0,i=t.length,o=i-2;r<i;o=r,r+=2)n+=(t[r]-t[o])*(t[r+1]+t[o+1]);if(n>0===e)for(r=0,i=t.length;r<i/2;r+=2){var a=t[r],s=t[r+1];t[r]=t[i-2-r],t[r+1]=t[i-1-r],t[i-2-r]=a,t[i-1-r]=s}}(s,o),t.push(s)}}function mt(t,e){var n=(e=this.options=function(t,e){for(var n in e)t[n]=e[n];return t}(Object.create(this.options),e)).debug;if(n&&console.time("preprocess data"),e.maxZoom<0||e.maxZoom>24)throw new Error("maxZoom should be in the 0-24 range");if(e.promoteId&&e.generateId)throw new Error("promoteId and generateId cannot be used together.");var r=function(t,e){var n=[];if("FeatureCollection"===t.type)for(var r=0;r<t.features.length;r++)Q(n,t.features[r],e,r);else Q(n,"Feature"===t.type?t:{geometry:t},e);return n}(t,e);this.tiles={},this.tileCoords=[],n&&(console.timeEnd("preprocess data"),console.log("index: maxZoom: %d, maxPoints: %d",e.indexMaxZoom,e.indexMaxPoints),console.time("generate tiles"),this.stats={},this.total=0),(r=function(t,e){var n=e.buffer/e.extent,r=t,i=nt(t,1,-1-n,n,0,-1,2,e),o=nt(t,1,1-n,2+n,0,-1,2,e);return(i||o)&&(r=nt(t,1,-n,1+n,0,-1,2,e)||[],i&&(r=lt(i,1).concat(r)),o&&(r=r.concat(lt(o,-1)))),r}(r,e)).length&&this.splitTile(r,0,0,0),n&&(r.length&&console.log("features: %d, points: %d",this.tiles[0].numFeatures,this.tiles[0].numPoints),console.timeEnd("generate tiles"),console.log("tiles generated:",this.total,JSON.stringify(this.stats)))}function yt(t,e,n){return 32*((1<<t)*n+e)+t}function vt(t,e){var n=t.tileID.canonical;if(!this._geoJSONIndex)return e(null,null);var r=this._geoJSONIndex.getTile(n.z,n.x,n.y);if(!r)return e(null,null);var i=new A(r.features),o=_(i);0===o.byteOffset&&o.byteLength===o.buffer.byteLength||(o=new Uint8Array(o)),e(null,{vectorTile:i,rawData:o.buffer})}j.prototype.load=function(t){var e=this.options,n=e.log,r=e.minZoom,i=e.maxZoom,o=e.nodeSize;n&&console.time("total time");var a="prepare "+t.length+" points";n&&console.time(a),this.points=t;for(var s=[],u=0;u<t.length;u++)t[u].geometry&&s.push(z(t[u],u));this.trees[i+1]=new D(s,W,q,o,Float32Array),n&&console.timeEnd(a);for(var c=i;c>=r;c--){var l=+Date.now();s=this._cluster(s,c),this.trees[c]=new D(s,W,q,o,Float32Array),n&&console.log("z%d: %d clusters in %dms",c,s.length,+Date.now()-l)}return n&&console.timeEnd("total time"),this},j.prototype.getClusters=function(t,e){var n=((t[0]+180)%360+360)%360-180,r=Math.max(-90,Math.min(90,t[1])),i=180===t[2]?180:((t[2]+180)%360+360)%360-180,o=Math.max(-90,Math.min(90,t[3]));if(t[2]-t[0]>=360)n=-180,i=180;else if(n>i){var a=this.getClusters([n,r,180,o],e),s=this.getClusters([-180,r,i,o],e);return a.concat(s)}for(var u=this.trees[this._limitZoom(e)],c=[],l=0,h=u.range(G(n),V(o),G(i),V(r));l<h.length;l+=1){var f=u.points[h[l]];c.push(f.numPoints?U(f):this.points[f.index])}return c},j.prototype.getChildren=function(t){var e=this._getOriginId(t),n=this._getOriginZoom(t),r="No cluster with the specified id.",i=this.trees[n];if(!i)throw new Error(r);var o=i.points[e];if(!o)throw new Error(r);for(var a=this.options.radius/(this.options.extent*Math.pow(2,n-1)),s=[],u=0,c=i.within(o.x,o.y,a);u<c.length;u+=1){var l=i.points[c[u]];l.parentId===t&&s.push(l.numPoints?U(l):this.points[l.index])}if(0===s.length)throw new Error(r);return s},j.prototype.getLeaves=function(t,e,n){var r=[];return this._appendLeaves(r,t,e=e||10,n=n||0,0),r},j.prototype.getTile=function(t,e,n){var r=this.trees[this._limitZoom(t)],i=Math.pow(2,t),o=this.options,a=o.radius/o.extent,s=(n-a)/i,u=(n+1+a)/i,c={features:[]};return this._addTileFeatures(r.range((e-a)/i,s,(e+1+a)/i,u),r.points,e,n,i,c),0===e&&this._addTileFeatures(r.range(1-a/i,s,1,u),r.points,i,n,i,c),e===i-1&&this._addTileFeatures(r.range(0,s,a/i,u),r.points,-1,n,i,c),c.features.length?c:null},j.prototype.getClusterExpansionZoom=function(t){for(var e=this._getOriginZoom(t)-1;e<=this.options.maxZoom;){var n=this.getChildren(t);if(e++,1!==n.length)break;t=n[0].properties.cluster_id}return e},j.prototype._appendLeaves=function(t,e,n,r,i){for(var o=0,a=this.getChildren(e);o<a.length;o+=1){var s=a[o],u=s.properties;if(u&&u.cluster?i+u.point_count<=r?i+=u.point_count:i=this._appendLeaves(t,u.cluster_id,n,r,i):i<r?i++:t.push(s),t.length===n)break}return i},j.prototype._addTileFeatures=function(t,e,n,r,i,o){for(var a=0,s=t;a<s.length;a+=1){var u=e[s[a]],c=u.numPoints,l={type:1,geometry:[[Math.round(this.options.extent*(u.x*i-n)),Math.round(this.options.extent*(u.y*i-r))]],tags:c?N(u):this.points[u.index].properties},h=void 0;c?h=u.id:this.options.generateId?h=u.index:this.points[u.index].id&&(h=this.points[u.index].id),void 0!==h&&(l.id=h),o.features.push(l)}},j.prototype._limitZoom=function(t){return Math.max(this.options.minZoom,Math.min(+t,this.options.maxZoom+1))},j.prototype._cluster=function(t,e){for(var n=[],r=this.options,i=r.reduce,o=r.minPoints,a=r.radius/(r.extent*Math.pow(2,e)),s=0;s<t.length;s++){var u=t[s];if(!(u.zoom<=e)){u.zoom=e;for(var c=this.trees[e+1],l=c.within(u.x,u.y,a),h=u.numPoints||1,f=h,p=0,d=l;p<d.length;p+=1){var A=c.points[d[p]];A.zoom>e&&(f+=A.numPoints||1)}if(f>=o){for(var g=u.x*h,m=u.y*h,y=i&&h>1?this._map(u,!0):null,v=(s<<5)+(e+1)+this.points.length,_=0,b=l;_<b.length;_+=1){var x=c.points[b[_]];if(!(x.zoom<=e)){x.zoom=e;var w=x.numPoints||1;g+=x.x*w,m+=x.y*w,x.parentId=v,i&&(y||(y=this._map(u,!0)),i(y,this._map(x)))}}u.parentId=v,n.push(F(g/f,m/f,v,f,y))}else if(n.push(u),f>1)for(var E=0,O=l;E<O.length;E+=1){var S=c.points[O[E]];S.zoom<=e||(S.zoom=e,n.push(S))}}}return n},j.prototype._getOriginId=function(t){return t-this.points.length>>5},j.prototype._getOriginZoom=function(t){return(t-this.points.length)%32},j.prototype._map=function(t,e){if(t.numPoints)return e?H({},t.properties):t.properties;var n=this.points[t.index].properties,r=this.options.map(n);return e&&r===n?H({},r):r},mt.prototype.options={maxZoom:14,indexMaxZoom:5,indexMaxPoints:1e5,tolerance:3,extent:4096,buffer:64,lineMetrics:!1,promoteId:null,generateId:!1,debug:0},mt.prototype.splitTile=function(t,e,n,r,i,o,a){for(var s=[t,e,n,r],u=this.options,c=u.debug;s.length;){r=s.pop(),n=s.pop(),e=s.pop(),t=s.pop();var l=1<<e,h=yt(e,n,r),f=this.tiles[h];if(!f&&(c>1&&console.time("creation"),f=this.tiles[h]=dt(t,e,n,r,u),this.tileCoords.push({z:e,x:n,y:r}),c)){c>1&&(console.log("tile z%d-%d-%d (features: %d, points: %d, simplified: %d)",e,n,r,f.numFeatures,f.numPoints,f.numSimplified),console.timeEnd("creation"));var p="z"+e;this.stats[p]=(this.stats[p]||0)+1,this.total++}if(f.source=t,i){if(e===u.maxZoom||e===i)continue;var d=1<<i-e;if(n!==Math.floor(o/d)||r!==Math.floor(a/d))continue}else if(e===u.indexMaxZoom||f.numPoints<=u.indexMaxPoints)continue;if(f.source=null,0!==t.length){c>1&&console.time("clipping");var A,g,m,y,v,_,b=.5*u.buffer/u.extent,x=.5-b,w=.5+b,E=1+b;A=g=m=y=null,v=nt(t,l,n-b,n+w,0,f.minX,f.maxX,u),_=nt(t,l,n+x,n+E,0,f.minX,f.maxX,u),t=null,v&&(A=nt(v,l,r-b,r+w,1,f.minY,f.maxY,u),g=nt(v,l,r+x,r+E,1,f.minY,f.maxY,u),v=null),_&&(m=nt(_,l,r-b,r+w,1,f.minY,f.maxY,u),y=nt(_,l,r+x,r+E,1,f.minY,f.maxY,u),_=null),c>1&&console.timeEnd("clipping"),s.push(A||[],e+1,2*n,2*r),s.push(g||[],e+1,2*n,2*r+1),s.push(m||[],e+1,2*n+1,2*r),s.push(y||[],e+1,2*n+1,2*r+1)}}},mt.prototype.getTile=function(t,e,n){var r=this.options,i=r.extent,o=r.debug;if(t<0||t>24)return null;var a=1<<t,s=yt(t,e=(e%a+a)%a,n);if(this.tiles[s])return ft(this.tiles[s],i);o>1&&console.log("drilling down to z%d-%d-%d",t,e,n);for(var u,c=t,l=e,h=n;!u&&c>0;)c--,l=Math.floor(l/2),h=Math.floor(h/2),u=this.tiles[yt(c,l,h)];return u&&u.source?(o>1&&console.log("found parent tile z%d-%d-%d",c,l,h),o>1&&console.time("drilling down"),this.splitTile(u.source,c,l,h,t,e,n),o>1&&console.timeEnd("drilling down"),this.tiles[s]?ft(this.tiles[s],i):null):null};var _t=function(e){function n(t,n,r,i){e.call(this,t,n,r,vt),i&&(this.loadGeoJSON=i)}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.loadData=function(t,e){this._pendingCallback&&this._pendingCallback(null,{abandoned:!0}),this._pendingCallback=e,this._pendingLoadDataParams=t,this._state&&"Idle"!==this._state?this._state="NeedsLoadData":(this._state="Coalescing",this._loadData())},n.prototype._loadData=function(){var e=this;if(this._pendingCallback&&this._pendingLoadDataParams){var n=this._pendingCallback,r=this._pendingLoadDataParams;delete this._pendingCallback,delete this._pendingLoadDataParams;var i=!!(r&&r.request&&r.request.collectResourceTiming)&&new t.RequestPerformance(r.request);this.loadGeoJSON(r,(function(o,a){if(o||!a)return n(o);if("object"!=typeof a)return n(new Error("Input data given to '"+r.source+"' is not a valid GeoJSON object."));!function t(e,n){var r,i=e&&e.type;if("FeatureCollection"===i)for(r=0;r<e.features.length;r++)t(e.features[r],n);else if("GeometryCollection"===i)for(r=0;r<e.geometries.length;r++)t(e.geometries[r],n);else if("Feature"===i)t(e.geometry,n);else if("Polygon"===i)h(e.coordinates,n);else if("MultiPolygon"===i)for(r=0;r<e.coordinates.length;r++)h(e.coordinates[r],n);return e}(a,!0);try{if(r.filter){var s=t.createExpression(r.filter,{type:"boolean","property-type":"data-driven",overridable:!1,transition:!1});if("error"===s.result)throw new Error(s.value.map((function(t){return t.key+": "+t.message})).join(", "));var u=a.features.filter((function(t){return s.value.evaluate({zoom:0},t)}));a={type:"FeatureCollection",features:u}}e._geoJSONIndex=r.cluster?new j(function(e){var n=e.superclusterOptions,r=e.clusterProperties;if(!r||!n)return n;for(var i={},o={},a={accumulated:null,zoom:0},s={properties:null},u=Object.keys(r),c=0,l=u;c<l.length;c+=1){var h=l[c],f=r[h],p=f[0],d=t.createExpression(f[1]),A=t.createExpression("string"==typeof p?[p,["accumulated"],["get",h]]:p);i[h]=d.value,o[h]=A.value}return n.map=function(t){s.properties=t;for(var e={},n=0,r=u;n<r.length;n+=1){var o=r[n];e[o]=i[o].evaluate(a,s)}return e},n.reduce=function(t,e){s.properties=e;for(var n=0,r=u;n<r.length;n+=1){var i=r[n];a.accumulated=t[i],t[i]=o[i].evaluate(a,s)}},n}(r)).load(a.features):function(t,e){return new mt(t,e)}(a,r.geojsonVtOptions)}catch(o){return n(o)}e.loaded={};var c={};if(i){var l=i.finish();l&&(c.resourceTiming={},c.resourceTiming[r.source]=JSON.parse(JSON.stringify(l)))}n(null,c)}))}},n.prototype.coalesce=function(){"Coalescing"===this._state?this._state="Idle":"NeedsLoadData"===this._state&&(this._state="Coalescing",this._loadData())},n.prototype.reloadTile=function(t,n){var r=this.loaded;return r&&r[t.uid]?e.prototype.reloadTile.call(this,t,n):this.loadTile(t,n)},n.prototype.loadGeoJSON=function(e,n){if(e.request)t.getJSON(e.request,n);else{if("string"!=typeof e.data)return n(new Error("Input data given to '"+e.source+"' is not a valid GeoJSON object."));try{return n(null,JSON.parse(e.data))}catch(t){return n(new Error("Input data given to '"+e.source+"' is not a valid GeoJSON object."))}}},n.prototype.removeSource=function(t,e){this._pendingCallback&&this._pendingCallback(null,{abandoned:!0}),e()},n.prototype.getClusterExpansionZoom=function(t,e){try{e(null,this._geoJSONIndex.getClusterExpansionZoom(t.clusterId))}catch(t){e(t)}},n.prototype.getClusterChildren=function(t,e){try{e(null,this._geoJSONIndex.getChildren(t.clusterId))}catch(t){e(t)}},n.prototype.getClusterLeaves=function(t,e){try{e(null,this._geoJSONIndex.getLeaves(t.clusterId,t.limit,t.offset))}catch(t){e(t)}},n}(u),bt=function(e){var n=this;this.self=e,this.actor=new t.Actor(e,this),this.layerIndexes={},this.availableImages={},this.workerSourceTypes={vector:u,geojson:_t},this.workerSources={},this.demWorkerSources={},this.self.registerWorkerSource=function(t,e){if(n.workerSourceTypes[t])throw new Error('Worker source with name "'+t+'" already registered.');n.workerSourceTypes[t]=e},this.self.registerRTLTextPlugin=function(e){if(t.plugin.isParsed())throw new Error("RTL text plugin already registered.");t.plugin.applyArabicShaping=e.applyArabicShaping,t.plugin.processBidirectionalText=e.processBidirectionalText,t.plugin.processStyledBidirectionalText=e.processStyledBidirectionalText}};return bt.prototype.setReferrer=function(t,e){this.referrer=e},bt.prototype.setImages=function(t,e,n){for(var r in this.availableImages[t]=e,this.workerSources[t]){var i=this.workerSources[t][r];for(var o in i)i[o].availableImages=e}n()},bt.prototype.setLayers=function(t,e,n){this.getLayerIndex(t).replace(e),n()},bt.prototype.updateLayers=function(t,e,n){this.getLayerIndex(t).update(e.layers,e.removedIds),n()},bt.prototype.loadTile=function(t,e,n){this.getWorkerSource(t,e.type,e.source).loadTile(e,n)},bt.prototype.loadDEMTile=function(t,e,n){this.getDEMWorkerSource(t,e.source).loadTile(e,n)},bt.prototype.reloadTile=function(t,e,n){this.getWorkerSource(t,e.type,e.source).reloadTile(e,n)},bt.prototype.abortTile=function(t,e,n){this.getWorkerSource(t,e.type,e.source).abortTile(e,n)},bt.prototype.removeTile=function(t,e,n){this.getWorkerSource(t,e.type,e.source).removeTile(e,n)},bt.prototype.removeDEMTile=function(t,e){this.getDEMWorkerSource(t,e.source).removeTile(e)},bt.prototype.removeSource=function(t,e,n){if(this.workerSources[t]&&this.workerSources[t][e.type]&&this.workerSources[t][e.type][e.source]){var r=this.workerSources[t][e.type][e.source];delete this.workerSources[t][e.type][e.source],void 0!==r.removeSource?r.removeSource(e,n):n()}},bt.prototype.loadWorkerSource=function(t,e,n){try{this.self.importScripts(e.url),n()}catch(t){n(t.toString())}},bt.prototype.syncRTLPluginState=function(e,n,r){try{t.plugin.setState(n);var i=t.plugin.getPluginURL();if(t.plugin.isLoaded()&&!t.plugin.isParsed()&&null!=i){this.self.importScripts(i);var o=t.plugin.isParsed();r(o?void 0:new Error("RTL Text Plugin failed to import scripts from "+i),o)}}catch(t){r(t.toString())}},bt.prototype.getAvailableImages=function(t){var e=this.availableImages[t];return e||(e=[]),e},bt.prototype.getLayerIndex=function(t){var e=this.layerIndexes[t];return e||(e=this.layerIndexes[t]=new r),e},bt.prototype.getWorkerSource=function(t,e,n){var r=this;return this.workerSources[t]||(this.workerSources[t]={}),this.workerSources[t][e]||(this.workerSources[t][e]={}),this.workerSources[t][e][n]||(this.workerSources[t][e][n]=new this.workerSourceTypes[e]({send:function(e,n,i){r.actor.send(e,n,i,t)}},this.getLayerIndex(t),this.getAvailableImages(t))),this.workerSources[t][e][n]},bt.prototype.getDEMWorkerSource=function(t,e){return this.demWorkerSources[t]||(this.demWorkerSources[t]={}),this.demWorkerSources[t][e]||(this.demWorkerSources[t][e]=new l),this.demWorkerSources[t][e]},bt.prototype.enforceCacheSizeLimit=function(e,n){t.enforceCacheSizeLimit(n)},"undefined"!=typeof WorkerGlobalScope&&"undefined"!=typeof self&&self instanceof WorkerGlobalScope&&(self.worker=new bt(self)),bt})),r(0,(function(t){var e=t.createCommonjsModule((function(t){function e(t){return!n(t)}function n(t){return"undefined"==typeof window||"undefined"==typeof document?"not a browser":Array.prototype&&Array.prototype.every&&Array.prototype.filter&&Array.prototype.forEach&&Array.prototype.indexOf&&Array.prototype.lastIndexOf&&Array.prototype.map&&Array.prototype.some&&Array.prototype.reduce&&Array.prototype.reduceRight&&Array.isArray?Function.prototype&&Function.prototype.bind?Object.keys&&Object.create&&Object.getPrototypeOf&&Object.getOwnPropertyNames&&Object.isSealed&&Object.isFrozen&&Object.isExtensible&&Object.getOwnPropertyDescriptor&&Object.defineProperty&&Object.defineProperties&&Object.seal&&Object.freeze&&Object.preventExtensions?"JSON"in window&&"parse"in JSON&&"stringify"in JSON?function(){if(!("Worker"in window&&"Blob"in window&&"URL"in window))return!1;var t,e,n=new Blob([""],{type:"text/javascript"}),r=URL.createObjectURL(n);try{e=new Worker(r),t=!0}catch(e){t=!1}return e&&e.terminate(),URL.revokeObjectURL(r),t}()?"Uint8ClampedArray"in window?ArrayBuffer.isView?function(){var t=document.createElement("canvas");t.width=t.height=1;var e=t.getContext("2d");if(!e)return!1;var n=e.getImageData(0,0,1,1);return n&&n.width===t.width}()?(void 0===r[n=t&&t.failIfMajorPerformanceCaveat]&&(r[n]=function(t){var n=function(t){var n=document.createElement("canvas"),r=Object.create(e.webGLContextAttributes);return r.failIfMajorPerformanceCaveat=t,n.probablySupportsContext?n.probablySupportsContext("webgl",r)||n.probablySupportsContext("experimental-webgl",r):n.supportsContext?n.supportsContext("webgl",r)||n.supportsContext("experimental-webgl",r):n.getContext("webgl",r)||n.getContext("experimental-webgl",r)}(t);if(!n)return!1;var r=n.createShader(n.VERTEX_SHADER);return!(!r||n.isContextLost())&&(n.shaderSource(r,"void main() {}"),n.compileShader(r),!0===n.getShaderParameter(r,n.COMPILE_STATUS))}(n)),r[n]?void 0:"insufficient WebGL support"):"insufficient Canvas/getImageData support":"insufficient ArrayBuffer support":"insufficient Uint8ClampedArray support":"insufficient worker support":"insufficient JSON support":"insufficient Object support":"insufficient Function support":"insufficent Array support";var n}t.exports?t.exports=e:window&&(window.mapboxgl=window.mapboxgl||{},window.mapboxgl.supported=e,window.mapboxgl.notSupportedReason=n);var r={};e.webGLContextAttributes={antialias:!1,alpha:!0,stencil:!0,depth:!0}})),n={create:function(e,n,r){var i=t.window.document.createElement(e);return void 0!==n&&(i.className=n),r&&r.appendChild(i),i},createNS:function(e,n){return t.window.document.createElementNS(e,n)}},r=t.window.document&&t.window.document.documentElement.style;function i(t){if(!r)return t[0];for(var e=0;e<t.length;e++)if(t[e]in r)return t[e];return t[0]}var o,a=i(["userSelect","MozUserSelect","WebkitUserSelect","msUserSelect"]);n.disableDrag=function(){r&&a&&(o=r[a],r[a]="none")},n.enableDrag=function(){r&&a&&(r[a]=o)};var s=i(["transform","WebkitTransform"]);n.setTransform=function(t,e){t.style[s]=e};var u=!1;try{var c=Object.defineProperty({},"passive",{get:function(){u=!0}});t.window.addEventListener("test",c,c),t.window.removeEventListener("test",c,c)}catch(t){u=!1}n.addEventListener=function(t,e,n,r){void 0===r&&(r={}),t.addEventListener(e,n,"passive"in r&&u?r:r.capture)},n.removeEventListener=function(t,e,n,r){void 0===r&&(r={}),t.removeEventListener(e,n,"passive"in r&&u?r:r.capture)};var l=function(e){e.preventDefault(),e.stopPropagation(),t.window.removeEventListener("click",l,!0)};function h(t){var e=t.userImage;return!!(e&&e.render&&e.render())&&(t.data.replace(new Uint8Array(e.data.buffer)),!0)}n.suppressClick=function(){t.window.addEventListener("click",l,!0),t.window.setTimeout((function(){t.window.removeEventListener("click",l,!0)}),0)},n.mousePos=function(e,n){var r=e.getBoundingClientRect();return new t.Point(n.clientX-r.left-e.clientLeft,n.clientY-r.top-e.clientTop)},n.touchPos=function(e,n){for(var r=e.getBoundingClientRect(),i=[],o=0;o<n.length;o++)i.push(new t.Point(n[o].clientX-r.left-e.clientLeft,n[o].clientY-r.top-e.clientTop));return i},n.mouseButton=function(e){return void 0!==t.window.InstallTrigger&&2===e.button&&e.ctrlKey&&t.window.navigator.platform.toUpperCase().indexOf("MAC")>=0?0:e.button},n.remove=function(t){t.parentNode&&t.parentNode.removeChild(t)};var f=function(e){function n(){e.call(this),this.images={},this.updatedImages={},this.callbackDispatchedThisFrame={},this.loaded=!1,this.requestors=[],this.patterns={},this.atlasImage=new t.RGBAImage({width:1,height:1}),this.dirty=!0}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.isLoaded=function(){return this.loaded},n.prototype.setLoaded=function(t){if(this.loaded!==t&&(this.loaded=t,t)){for(var e=0,n=this.requestors;e<n.length;e+=1){var r=n[e];this._notify(r.ids,r.callback)}this.requestors=[]}},n.prototype.getImage=function(t){return this.images[t]},n.prototype.addImage=function(t,e){this._validate(t,e)&&(this.images[t]=e)},n.prototype._validate=function(e,n){var r=!0;return this._validateStretch(n.stretchX,n.data&&n.data.width)||(this.fire(new t.ErrorEvent(new Error('Image "'+e+'" has invalid "stretchX" value'))),r=!1),this._validateStretch(n.stretchY,n.data&&n.data.height)||(this.fire(new t.ErrorEvent(new Error('Image "'+e+'" has invalid "stretchY" value'))),r=!1),this._validateContent(n.content,n)||(this.fire(new t.ErrorEvent(new Error('Image "'+e+'" has invalid "content" value'))),r=!1),r},n.prototype._validateStretch=function(t,e){if(!t)return!0;for(var n=0,r=0,i=t;r<i.length;r+=1){var o=i[r];if(o[0]<n||o[1]<o[0]||e<o[1])return!1;n=o[1]}return!0},n.prototype._validateContent=function(t,e){return!(t&&(4!==t.length||t[0]<0||e.data.width<t[0]||t[1]<0||e.data.height<t[1]||t[2]<0||e.data.width<t[2]||t[3]<0||e.data.height<t[3]||t[2]<t[0]||t[3]<t[1]))},n.prototype.updateImage=function(t,e){e.version=this.images[t].version+1,this.images[t]=e,this.updatedImages[t]=!0},n.prototype.removeImage=function(t){var e=this.images[t];delete this.images[t],delete this.patterns[t],e.userImage&&e.userImage.onRemove&&e.userImage.onRemove()},n.prototype.listImages=function(){return Object.keys(this.images)},n.prototype.getImages=function(t,e){var n=!0;if(!this.isLoaded())for(var r=0,i=t;r<i.length;r+=1)this.images[i[r]]||(n=!1);this.isLoaded()||n?this._notify(t,e):this.requestors.push({ids:t,callback:e})},n.prototype._notify=function(e,n){for(var r={},i=0,o=e;i<o.length;i+=1){var a=o[i];this.images[a]||this.fire(new t.Event("styleimagemissing",{id:a}));var s=this.images[a];s?r[a]={data:s.data.clone(),pixelRatio:s.pixelRatio,sdf:s.sdf,version:s.version,stretchX:s.stretchX,stretchY:s.stretchY,content:s.content,hasRenderCallback:Boolean(s.userImage&&s.userImage.render)}:t.warnOnce('Image "'+a+'" could not be loaded. Please make sure you have added the image with map.addImage() or a "sprite" property in your style. You can provide missing images by listening for the "styleimagemissing" map event.')}n(null,r)},n.prototype.getPixelSize=function(){var t=this.atlasImage;return{width:t.width,height:t.height}},n.prototype.getPattern=function(e){var n=this.patterns[e],r=this.getImage(e);if(!r)return null;if(n&&n.position.version===r.version)return n.position;if(n)n.position.version=r.version;else{var i={w:r.data.width+2,h:r.data.height+2,x:0,y:0},o=new t.ImagePosition(i,r);this.patterns[e]={bin:i,position:o}}return this._updatePatternAtlas(),this.patterns[e].position},n.prototype.bind=function(e){var n=e.gl;this.atlasTexture?this.dirty&&(this.atlasTexture.update(this.atlasImage),this.dirty=!1):this.atlasTexture=new t.Texture(e,this.atlasImage,n.RGBA),this.atlasTexture.bind(n.LINEAR,n.CLAMP_TO_EDGE)},n.prototype._updatePatternAtlas=function(){var e=[];for(var n in this.patterns)e.push(this.patterns[n].bin);var r=t.potpack(e),i=r.w,o=r.h,a=this.atlasImage;for(var s in a.resize({width:i||1,height:o||1}),this.patterns){var u=this.patterns[s].bin,c=u.x+1,l=u.y+1,h=this.images[s].data,f=h.width,p=h.height;t.RGBAImage.copy(h,a,{x:0,y:0},{x:c,y:l},{width:f,height:p}),t.RGBAImage.copy(h,a,{x:0,y:p-1},{x:c,y:l-1},{width:f,height:1}),t.RGBAImage.copy(h,a,{x:0,y:0},{x:c,y:l+p},{width:f,height:1}),t.RGBAImage.copy(h,a,{x:f-1,y:0},{x:c-1,y:l},{width:1,height:p}),t.RGBAImage.copy(h,a,{x:0,y:0},{x:c+f,y:l},{width:1,height:p})}this.dirty=!0},n.prototype.beginFrame=function(){this.callbackDispatchedThisFrame={}},n.prototype.dispatchRenderCallbacks=function(t){for(var e=0,n=t;e<n.length;e+=1){var r=n[e];if(!this.callbackDispatchedThisFrame[r]){this.callbackDispatchedThisFrame[r]=!0;var i=this.images[r];h(i)&&this.updateImage(r,i)}}},n}(t.Evented),p=g,d=g,A=1e20;function g(t,e,n,r,i,o){this.fontSize=t||24,this.buffer=void 0===e?3:e,this.cutoff=r||.25,this.fontFamily=i||"sans-serif",this.fontWeight=o||"normal",this.radius=n||8;var a=this.size=this.fontSize+2*this.buffer;this.canvas=document.createElement("canvas"),this.canvas.width=this.canvas.height=a,this.ctx=this.canvas.getContext("2d"),this.ctx.font=this.fontWeight+" "+this.fontSize+"px "+this.fontFamily,this.ctx.textBaseline="middle",this.ctx.fillStyle="black",this.gridOuter=new Float64Array(a*a),this.gridInner=new Float64Array(a*a),this.f=new Float64Array(a),this.d=new Float64Array(a),this.z=new Float64Array(a+1),this.v=new Int16Array(a),this.middle=Math.round(a/2*(navigator.userAgent.indexOf("Gecko/")>=0?1.2:1))}function m(t,e,n,r,i,o,a){for(var s=0;s<e;s++){for(var u=0;u<n;u++)r[u]=t[u*e+s];for(y(r,i,o,a,n),u=0;u<n;u++)t[u*e+s]=i[u]}for(u=0;u<n;u++){for(s=0;s<e;s++)r[s]=t[u*e+s];for(y(r,i,o,a,e),s=0;s<e;s++)t[u*e+s]=Math.sqrt(i[s])}}function y(t,e,n,r,i){n[0]=0,r[0]=-A,r[1]=+A;for(var o=1,a=0;o<i;o++){for(var s=(t[o]+o*o-(t[n[a]]+n[a]*n[a]))/(2*o-2*n[a]);s<=r[a];)a--,s=(t[o]+o*o-(t[n[a]]+n[a]*n[a]))/(2*o-2*n[a]);n[++a]=o,r[a]=s,r[a+1]=+A}for(o=0,a=0;o<i;o++){for(;r[a+1]<o;)a++;e[o]=(o-n[a])*(o-n[a])+t[n[a]]}}g.prototype.draw=function(t){this.ctx.clearRect(0,0,this.size,this.size),this.ctx.fillText(t,this.buffer,this.middle);for(var e=this.ctx.getImageData(0,0,this.size,this.size),n=new Uint8ClampedArray(this.size*this.size),r=0;r<this.size*this.size;r++){var i=e.data[4*r+3]/255;this.gridOuter[r]=1===i?0:0===i?A:Math.pow(Math.max(0,.5-i),2),this.gridInner[r]=1===i?A:0===i?0:Math.pow(Math.max(0,i-.5),2)}for(m(this.gridOuter,this.size,this.size,this.f,this.d,this.v,this.z),m(this.gridInner,this.size,this.size,this.f,this.d,this.v,this.z),r=0;r<this.size*this.size;r++)n[r]=Math.max(0,Math.min(255,Math.round(255-255*((this.gridOuter[r]-this.gridInner[r])/this.radius+this.cutoff))));return n},p.default=d;var v=function(t,e){this.requestManager=t,this.localIdeographFontFamily=e,this.entries={}};v.prototype.setURL=function(t){this.url=t},v.prototype.getGlyphs=function(e,n){var r=this,i=[];for(var o in e)for(var a=0,s=e[o];a<s.length;a+=1)i.push({stack:o,id:s[a]});t.asyncAll(i,(function(t,e){var n=t.stack,i=t.id,o=r.entries[n];o||(o=r.entries[n]={glyphs:{},requests:{},ranges:{}});var a=o.glyphs[i];if(void 0===a){if(a=r._tinySDF(o,n,i))return o.glyphs[i]=a,void e(null,{stack:n,id:i,glyph:a});var s=Math.floor(i/256);if(256*s>65535)e(new Error("glyphs > 65535 not supported"));else if(o.ranges[s])e(null,{stack:n,id:i,glyph:a});else{var u=o.requests[s];u||(u=o.requests[s]=[],v.loadGlyphRange(n,s,r.url,r.requestManager,(function(t,e){if(e){for(var n in e)r._doesCharSupportLocalGlyph(+n)||(o.glyphs[+n]=e[+n]);o.ranges[s]=!0}for(var i=0,a=u;i<a.length;i+=1)(0,a[i])(t,e);delete o.requests[s]}))),u.push((function(t,r){t?e(t):r&&e(null,{stack:n,id:i,glyph:r[i]||null})}))}}else e(null,{stack:n,id:i,glyph:a})}),(function(t,e){if(t)n(t);else if(e){for(var r={},i=0,o=e;i<o.length;i+=1){var a=o[i],s=a.stack,u=a.id,c=a.glyph;(r[s]||(r[s]={}))[u]=c&&{id:c.id,bitmap:c.bitmap.clone(),metrics:c.metrics}}n(null,r)}}))},v.prototype._doesCharSupportLocalGlyph=function(e){return!!this.localIdeographFontFamily&&(t.isChar["CJK Unified Ideographs"](e)||t.isChar["Hangul Syllables"](e)||t.isChar.Hiragana(e)||t.isChar.Katakana(e))},v.prototype._tinySDF=function(e,n,r){var i=this.localIdeographFontFamily;if(i&&this._doesCharSupportLocalGlyph(r)){var o=e.tinySDF;if(!o){var a="400";/bold/i.test(n)?a="900":/medium/i.test(n)?a="500":/light/i.test(n)&&(a="200"),o=e.tinySDF=new v.TinySDF(24,3,8,.25,i,a)}return{id:r,bitmap:new t.AlphaImage({width:30,height:30},o.draw(String.fromCharCode(r))),metrics:{width:24,height:24,left:0,top:-8,advance:24}}}},v.loadGlyphRange=function(e,n,r,i,o){var a=256*n,s=a+255,u=i.transformRequest(i.normalizeGlyphsURL(r).replace("{fontstack}",e).replace("{range}",a+"-"+s),t.ResourceType.Glyphs);t.getArrayBuffer(u,(function(e,n){if(e)o(e);else if(n){for(var r={},i=0,a=t.parseGlyphPBF(n);i<a.length;i+=1){var s=a[i];r[s.id]=s}o(null,r)}}))},v.TinySDF=p;var _=function(){this.specification=t.styleSpec.light.position};_.prototype.possiblyEvaluate=function(e,n){return t.sphericalToCartesian(e.expression.evaluate(n))},_.prototype.interpolate=function(e,n,r){return{x:t.number(e.x,n.x,r),y:t.number(e.y,n.y,r),z:t.number(e.z,n.z,r)}};var b=new t.Properties({anchor:new t.DataConstantProperty(t.styleSpec.light.anchor),position:new _,color:new t.DataConstantProperty(t.styleSpec.light.color),intensity:new t.DataConstantProperty(t.styleSpec.light.intensity)}),x=function(e){function n(n){e.call(this),this._transitionable=new t.Transitionable(b),this.setLight(n),this._transitioning=this._transitionable.untransitioned()}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.getLight=function(){return this._transitionable.serialize()},n.prototype.setLight=function(e,n){if(void 0===n&&(n={}),!this._validate(t.validateLight,e,n))for(var r in e){var i=e[r];t.endsWith(r,"-transition")?this._transitionable.setTransition(r.slice(0,-"-transition".length),i):this._transitionable.setValue(r,i)}},n.prototype.updateTransitions=function(t){this._transitioning=this._transitionable.transitioned(t,this._transitioning)},n.prototype.hasTransition=function(){return this._transitioning.hasTransition()},n.prototype.recalculate=function(t){this.properties=this._transitioning.possiblyEvaluate(t)},n.prototype._validate=function(e,n,r){return(!r||!1!==r.validate)&&t.emitValidationErrors(this,e.call(t.validateStyle,t.extend({value:n,style:{glyphs:!0,sprite:!0},styleSpec:t.styleSpec})))},n}(t.Evented),w=function(t,e){this.width=t,this.height=e,this.nextRow=0,this.data=new Uint8Array(this.width*this.height),this.dashEntry={}};w.prototype.getDash=function(t,e){var n=t.join(",")+String(e);return this.dashEntry[n]||(this.dashEntry[n]=this.addDash(t,e)),this.dashEntry[n]},w.prototype.getDashRanges=function(t,e,n){var r=[],i=t.length%2==1?-t[t.length-1]*n:0,o=t[0]*n,a=!0;r.push({left:i,right:o,isDash:a,zeroLength:0===t[0]});for(var s=t[0],u=1;u<t.length;u++){var c=t[u];r.push({left:i=s*n,right:o=(s+=c)*n,isDash:a=!a,zeroLength:0===c})}return r},w.prototype.addRoundDash=function(t,e,n){for(var r=e/2,i=-n;i<=n;i++)for(var o=this.width*(this.nextRow+n+i),a=0,s=t[a],u=0;u<this.width;u++){u/s.right>1&&(s=t[++a]);var c=Math.abs(u-s.left),l=Math.abs(u-s.right),h=Math.min(c,l),f=void 0,p=i/n*(r+1);if(s.isDash){var d=r-Math.abs(p);f=Math.sqrt(h*h+d*d)}else f=r-Math.sqrt(h*h+p*p);this.data[o+u]=Math.max(0,Math.min(255,f+128))}},w.prototype.addRegularDash=function(t){for(var e=t.length-1;e>=0;--e){var n=t[e],r=t[e+1];n.zeroLength?t.splice(e,1):r&&r.isDash===n.isDash&&(r.left=n.left,t.splice(e,1))}var i=t[0],o=t[t.length-1];i.isDash===o.isDash&&(i.left=o.left-this.width,o.right=i.right+this.width);for(var a=this.width*this.nextRow,s=0,u=t[s],c=0;c<this.width;c++){c/u.right>1&&(u=t[++s]);var l=Math.abs(c-u.left),h=Math.abs(c-u.right),f=Math.min(l,h);this.data[a+c]=Math.max(0,Math.min(255,(u.isDash?f:-f)+128))}},w.prototype.addDash=function(e,n){var r=n?7:0,i=2*r+1;if(this.nextRow+i>this.height)return t.warnOnce("LineAtlas out of space"),null;for(var o=0,a=0;a<e.length;a++)o+=e[a];if(0!==o){var s=this.width/o,u=this.getDashRanges(e,this.width,s);n?this.addRoundDash(u,s,r):this.addRegularDash(u)}var c={y:(this.nextRow+r+.5)/this.height,height:2*r/this.height,width:o};return this.nextRow+=i,this.dirty=!0,c},w.prototype.bind=function(t){var e=t.gl;this.texture?(e.bindTexture(e.TEXTURE_2D,this.texture),this.dirty&&(this.dirty=!1,e.texSubImage2D(e.TEXTURE_2D,0,0,0,this.width,this.height,e.ALPHA,e.UNSIGNED_BYTE,this.data))):(this.texture=e.createTexture(),e.bindTexture(e.TEXTURE_2D,this.texture),e.texParameteri(e.TEXTURE_2D,e.TEXTURE_WRAP_S,e.REPEAT),e.texParameteri(e.TEXTURE_2D,e.TEXTURE_WRAP_T,e.REPEAT),e.texParameteri(e.TEXTURE_2D,e.TEXTURE_MIN_FILTER,e.LINEAR),e.texParameteri(e.TEXTURE_2D,e.TEXTURE_MAG_FILTER,e.LINEAR),e.texImage2D(e.TEXTURE_2D,0,e.ALPHA,this.width,this.height,0,e.ALPHA,e.UNSIGNED_BYTE,this.data))};var E=function e(n,r){this.workerPool=n,this.actors=[],this.currentActor=0,this.id=t.uniqueId();for(var i=this.workerPool.acquire(this.id),o=0;o<i.length;o++){var a=new e.Actor(i[o],r,this.id);a.name="Worker "+o,this.actors.push(a)}};function O(e,n,r){var i=function(i,o){if(i)return r(i);if(o){var a=t.pick(t.extend(o,e),["tiles","minzoom","maxzoom","attribution","mapbox_logo","bounds","scheme","tileSize","encoding"]);o.vector_layers&&(a.vectorLayers=o.vector_layers,a.vectorLayerIds=a.vectorLayers.map((function(t){return t.id}))),a.tiles=n.canonicalizeTileset(a,e.url),r(null,a)}};return e.url?t.getJSON(n.transformRequest(n.normalizeSourceURL(e.url),t.ResourceType.Source),i):t.browser.frame((function(){return i(null,e)}))}E.prototype.broadcast=function(e,n,r){t.asyncAll(this.actors,(function(t,r){t.send(e,n,r)}),r=r||function(){})},E.prototype.getActor=function(){return this.currentActor=(this.currentActor+1)%this.actors.length,this.actors[this.currentActor]},E.prototype.remove=function(){this.actors.forEach((function(t){t.remove()})),this.actors=[],this.workerPool.release(this.id)},E.Actor=t.Actor;var S=function(e,n,r){this.bounds=t.LngLatBounds.convert(this.validateBounds(e)),this.minzoom=n||0,this.maxzoom=r||24};S.prototype.validateBounds=function(t){return Array.isArray(t)&&4===t.length?[Math.max(-180,t[0]),Math.max(-90,t[1]),Math.min(180,t[2]),Math.min(90,t[3])]:[-180,-90,180,90]},S.prototype.contains=function(e){var n=Math.pow(2,e.z),r=Math.floor(t.mercatorXfromLng(this.bounds.getWest())*n),i=Math.floor(t.mercatorYfromLat(this.bounds.getNorth())*n),o=Math.ceil(t.mercatorXfromLng(this.bounds.getEast())*n),a=Math.ceil(t.mercatorYfromLat(this.bounds.getSouth())*n);return e.x>=r&&e.x<o&&e.y>=i&&e.y<a};var T=function(e){function n(n,r,i,o){if(e.call(this),this.id=n,this.dispatcher=i,this.type="vector",this.minzoom=0,this.maxzoom=22,this.scheme="xyz",this.tileSize=512,this.reparseOverscaled=!0,this.isTileClipped=!0,this._loaded=!1,t.extend(this,t.pick(r,["url","scheme","tileSize","promoteId"])),this._options=t.extend({type:"vector"},r),this._collectResourceTiming=r.collectResourceTiming,512!==this.tileSize)throw new Error("vector tile sources must have a tileSize of 512");this.setEventedParent(o)}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.load=function(){var e=this;this._loaded=!1,this.fire(new t.Event("dataloading",{dataType:"source"})),this._tileJSONRequest=O(this._options,this.map._requestManager,(function(n,r){e._tileJSONRequest=null,e._loaded=!0,n?e.fire(new t.ErrorEvent(n)):r&&(t.extend(e,r),r.bounds&&(e.tileBounds=new S(r.bounds,e.minzoom,e.maxzoom)),t.postTurnstileEvent(r.tiles,e.map._requestManager._customAccessToken),t.postMapLoadEvent(r.tiles,e.map._getMapId(),e.map._requestManager._skuToken,e.map._requestManager._customAccessToken),e.fire(new t.Event("data",{dataType:"source",sourceDataType:"metadata"})),e.fire(new t.Event("data",{dataType:"source",sourceDataType:"content"})))}))},n.prototype.loaded=function(){return this._loaded},n.prototype.hasTile=function(t){return!this.tileBounds||this.tileBounds.contains(t.canonical)},n.prototype.onAdd=function(t){this.map=t,this.load()},n.prototype.setSourceProperty=function(t){this._tileJSONRequest&&this._tileJSONRequest.cancel(),t(),this.map.style.sourceCaches[this.id].clearTiles(),this.load()},n.prototype.setTiles=function(t){var e=this;return this.setSourceProperty((function(){e._options.tiles=t})),this},n.prototype.setUrl=function(t){var e=this;return this.setSourceProperty((function(){e.url=t,e._options.url=t})),this},n.prototype.onRemove=function(){this._tileJSONRequest&&(this._tileJSONRequest.cancel(),this._tileJSONRequest=null)},n.prototype.serialize=function(){return t.extend({},this._options)},n.prototype.loadTile=function(e,n){var r=this.map._requestManager.normalizeTileURL(e.tileID.canonical.url(this.tiles,this.scheme)),i={request:this.map._requestManager.transformRequest(r,t.ResourceType.Tile),uid:e.uid,tileID:e.tileID,zoom:e.tileID.overscaledZ,tileSize:this.tileSize*e.tileID.overscaleFactor(),type:this.type,source:this.id,pixelRatio:t.browser.devicePixelRatio,showCollisionBoxes:this.map.showCollisionBoxes,promoteId:this.promoteId};function o(r,i){return delete e.request,e.aborted?n(null):r&&404!==r.status?n(r):(i&&i.resourceTiming&&(e.resourceTiming=i.resourceTiming),this.map._refreshExpiredTiles&&i&&e.setExpiryData(i),e.loadVectorData(i,this.map.painter),t.cacheEntryPossiblyAdded(this.dispatcher),n(null),void(e.reloadCallback&&(this.loadTile(e,e.reloadCallback),e.reloadCallback=null)))}i.request.collectResourceTiming=this._collectResourceTiming,e.actor&&"expired"!==e.state?"loading"===e.state?e.reloadCallback=n:e.request=e.actor.send("reloadTile",i,o.bind(this)):(e.actor=this.dispatcher.getActor(),e.request=e.actor.send("loadTile",i,o.bind(this)))},n.prototype.abortTile=function(t){t.request&&(t.request.cancel(),delete t.request),t.actor&&t.actor.send("abortTile",{uid:t.uid,type:this.type,source:this.id},void 0)},n.prototype.unloadTile=function(t){t.unloadVectorData(),t.actor&&t.actor.send("removeTile",{uid:t.uid,type:this.type,source:this.id},void 0)},n.prototype.hasTransition=function(){return!1},n}(t.Evented),C=function(e){function n(n,r,i,o){e.call(this),this.id=n,this.dispatcher=i,this.setEventedParent(o),this.type="raster",this.minzoom=0,this.maxzoom=22,this.roundZoom=!0,this.scheme="xyz",this.tileSize=512,this._loaded=!1,this._options=t.extend({type:"raster"},r),t.extend(this,t.pick(r,["url","scheme","tileSize"]))}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.load=function(){var e=this;this._loaded=!1,this.fire(new t.Event("dataloading",{dataType:"source"})),this._tileJSONRequest=O(this._options,this.map._requestManager,(function(n,r){e._tileJSONRequest=null,e._loaded=!0,n?e.fire(new t.ErrorEvent(n)):r&&(t.extend(e,r),r.bounds&&(e.tileBounds=new S(r.bounds,e.minzoom,e.maxzoom)),t.postTurnstileEvent(r.tiles),t.postMapLoadEvent(r.tiles,e.map._getMapId(),e.map._requestManager._skuToken),e.fire(new t.Event("data",{dataType:"source",sourceDataType:"metadata"})),e.fire(new t.Event("data",{dataType:"source",sourceDataType:"content"})))}))},n.prototype.loaded=function(){return this._loaded},n.prototype.onAdd=function(t){this.map=t,this.load()},n.prototype.onRemove=function(){this._tileJSONRequest&&(this._tileJSONRequest.cancel(),this._tileJSONRequest=null)},n.prototype.serialize=function(){return t.extend({},this._options)},n.prototype.hasTile=function(t){return!this.tileBounds||this.tileBounds.contains(t.canonical)},n.prototype.loadTile=function(e,n){var r=this,i=this.map._requestManager.normalizeTileURL(e.tileID.canonical.url(this.tiles,this.scheme),this.tileSize);e.request=t.getImage(this.map._requestManager.transformRequest(i,t.ResourceType.Tile),(function(i,o){if(delete e.request,e.aborted)e.state="unloaded",n(null);else if(i)e.state="errored",n(i);else if(o){r.map._refreshExpiredTiles&&e.setExpiryData(o),delete o.cacheControl,delete o.expires;var a=r.map.painter.context,s=a.gl;e.texture=r.map.painter.getTileTexture(o.width),e.texture?e.texture.update(o,{useMipmap:!0}):(e.texture=new t.Texture(a,o,s.RGBA,{useMipmap:!0}),e.texture.bind(s.LINEAR,s.CLAMP_TO_EDGE,s.LINEAR_MIPMAP_NEAREST),a.extTextureFilterAnisotropic&&s.texParameterf(s.TEXTURE_2D,a.extTextureFilterAnisotropic.TEXTURE_MAX_ANISOTROPY_EXT,a.extTextureFilterAnisotropicMax)),e.state="loaded",t.cacheEntryPossiblyAdded(r.dispatcher),n(null)}}))},n.prototype.abortTile=function(t,e){t.request&&(t.request.cancel(),delete t.request),e()},n.prototype.unloadTile=function(t,e){t.texture&&this.map.painter.saveTileTexture(t.texture),e()},n.prototype.hasTransition=function(){return!1},n}(t.Evented),P=function(e){function n(n,r,i,o){e.call(this,n,r,i,o),this.type="raster-dem",this.maxzoom=22,this._options=t.extend({type:"raster-dem"},r),this.encoding=r.encoding||"mapbox"}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.serialize=function(){return{type:"raster-dem",url:this.url,tileSize:this.tileSize,tiles:this.tiles,bounds:this.bounds,encoding:this.encoding}},n.prototype.loadTile=function(e,n){var r=this.map._requestManager.normalizeTileURL(e.tileID.canonical.url(this.tiles,this.scheme),this.tileSize);function i(t,r){t&&(e.state="errored",n(t)),r&&(e.dem=r,e.needsHillshadePrepare=!0,e.state="loaded",n(null))}e.request=t.getImage(this.map._requestManager.transformRequest(r,t.ResourceType.Tile),function(r,o){if(delete e.request,e.aborted)e.state="unloaded",n(null);else if(r)e.state="errored",n(r);else if(o){this.map._refreshExpiredTiles&&e.setExpiryData(o),delete o.cacheControl,delete o.expires;var a=t.window.ImageBitmap&&o instanceof t.window.ImageBitmap&&t.offscreenCanvasSupported()?o:t.browser.getImageData(o,1),s={uid:e.uid,coord:e.tileID,source:this.id,rawImageData:a,encoding:this.encoding};e.actor&&"expired"!==e.state||(e.actor=this.dispatcher.getActor(),e.actor.send("loadDEMTile",s,i.bind(this)))}}.bind(this)),e.neighboringTiles=this._getNeighboringTiles(e.tileID)},n.prototype._getNeighboringTiles=function(e){var n=e.canonical,r=Math.pow(2,n.z),i=(n.x-1+r)%r,o=0===n.x?e.wrap-1:e.wrap,a=(n.x+1+r)%r,s=n.x+1===r?e.wrap+1:e.wrap,u={};return u[new t.OverscaledTileID(e.overscaledZ,o,n.z,i,n.y).key]={backfilled:!1},u[new t.OverscaledTileID(e.overscaledZ,s,n.z,a,n.y).key]={backfilled:!1},n.y>0&&(u[new t.OverscaledTileID(e.overscaledZ,o,n.z,i,n.y-1).key]={backfilled:!1},u[new t.OverscaledTileID(e.overscaledZ,e.wrap,n.z,n.x,n.y-1).key]={backfilled:!1},u[new t.OverscaledTileID(e.overscaledZ,s,n.z,a,n.y-1).key]={backfilled:!1}),n.y+1<r&&(u[new t.OverscaledTileID(e.overscaledZ,o,n.z,i,n.y+1).key]={backfilled:!1},u[new t.OverscaledTileID(e.overscaledZ,e.wrap,n.z,n.x,n.y+1).key]={backfilled:!1},u[new t.OverscaledTileID(e.overscaledZ,s,n.z,a,n.y+1).key]={backfilled:!1}),u},n.prototype.unloadTile=function(t){t.demTexture&&this.map.painter.saveTileTexture(t.demTexture),t.fbo&&(t.fbo.destroy(),delete t.fbo),t.dem&&delete t.dem,delete t.neighboringTiles,t.state="unloaded",t.actor&&t.actor.send("removeDEMTile",{uid:t.uid,source:this.id})},n}(C),M=function(e){function n(n,r,i,o){e.call(this),this.id=n,this.type="geojson",this.minzoom=0,this.maxzoom=18,this.tileSize=512,this.isTileClipped=!0,this.reparseOverscaled=!0,this._removed=!1,this._loaded=!1,this.actor=i.getActor(),this.setEventedParent(o),this._data=r.data,this._options=t.extend({},r),this._collectResourceTiming=r.collectResourceTiming,this._resourceTiming=[],void 0!==r.maxzoom&&(this.maxzoom=r.maxzoom),r.type&&(this.type=r.type),r.attribution&&(this.attribution=r.attribution),this.promoteId=r.promoteId;var a=t.EXTENT/this.tileSize;this.workerOptions=t.extend({source:this.id,cluster:r.cluster||!1,geojsonVtOptions:{buffer:(void 0!==r.buffer?r.buffer:128)*a,tolerance:(void 0!==r.tolerance?r.tolerance:.375)*a,extent:t.EXTENT,maxZoom:this.maxzoom,lineMetrics:r.lineMetrics||!1,generateId:r.generateId||!1},superclusterOptions:{maxZoom:void 0!==r.clusterMaxZoom?Math.min(r.clusterMaxZoom,this.maxzoom-1):this.maxzoom-1,minPoints:Math.max(2,r.clusterMinPoints||2),extent:t.EXTENT,radius:(r.clusterRadius||50)*a,log:!1,generateId:r.generateId||!1},clusterProperties:r.clusterProperties,filter:r.filter},r.workerOptions)}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.load=function(){var e=this;this.fire(new t.Event("dataloading",{dataType:"source"})),this._updateWorkerData((function(n){if(n)e.fire(new t.ErrorEvent(n));else{var r={dataType:"source",sourceDataType:"metadata"};e._collectResourceTiming&&e._resourceTiming&&e._resourceTiming.length>0&&(r.resourceTiming=e._resourceTiming,e._resourceTiming=[]),e.fire(new t.Event("data",r))}}))},n.prototype.onAdd=function(t){this.map=t,this.load()},n.prototype.setData=function(e){var n=this;return this._data=e,this.fire(new t.Event("dataloading",{dataType:"source"})),this._updateWorkerData((function(e){if(e)n.fire(new t.ErrorEvent(e));else{var r={dataType:"source",sourceDataType:"content"};n._collectResourceTiming&&n._resourceTiming&&n._resourceTiming.length>0&&(r.resourceTiming=n._resourceTiming,n._resourceTiming=[]),n.fire(new t.Event("data",r))}})),this},n.prototype.getClusterExpansionZoom=function(t,e){return this.actor.send("geojson.getClusterExpansionZoom",{clusterId:t,source:this.id},e),this},n.prototype.getClusterChildren=function(t,e){return this.actor.send("geojson.getClusterChildren",{clusterId:t,source:this.id},e),this},n.prototype.getClusterLeaves=function(t,e,n,r){return this.actor.send("geojson.getClusterLeaves",{source:this.id,clusterId:t,limit:e,offset:n},r),this},n.prototype._updateWorkerData=function(e){var n=this;this._loaded=!1;var r=t.extend({},this.workerOptions),i=this._data;"string"==typeof i?(r.request=this.map._requestManager.transformRequest(t.browser.resolveURL(i),t.ResourceType.Source),r.request.collectResourceTiming=this._collectResourceTiming):r.data=JSON.stringify(i),this.actor.send(this.type+".loadData",r,(function(t,i){n._removed||i&&i.abandoned||(n._loaded=!0,i&&i.resourceTiming&&i.resourceTiming[n.id]&&(n._resourceTiming=i.resourceTiming[n.id].slice(0)),n.actor.send(n.type+".coalesce",{source:r.source},null),e(t))}))},n.prototype.loaded=function(){return this._loaded},n.prototype.loadTile=function(e,n){var r=this,i=e.actor?"reloadTile":"loadTile";e.actor=this.actor,e.request=this.actor.send(i,{type:this.type,uid:e.uid,tileID:e.tileID,zoom:e.tileID.overscaledZ,maxZoom:this.maxzoom,tileSize:this.tileSize,source:this.id,pixelRatio:t.browser.devicePixelRatio,showCollisionBoxes:this.map.showCollisionBoxes,promoteId:this.promoteId},(function(t,o){return delete e.request,e.unloadVectorData(),e.aborted?n(null):t?n(t):(e.loadVectorData(o,r.map.painter,"reloadTile"===i),n(null))}))},n.prototype.abortTile=function(t){t.request&&(t.request.cancel(),delete t.request),t.aborted=!0},n.prototype.unloadTile=function(t){t.unloadVectorData(),this.actor.send("removeTile",{uid:t.uid,type:this.type,source:this.id})},n.prototype.onRemove=function(){this._removed=!0,this.actor.send("removeSource",{type:this.type,source:this.id})},n.prototype.serialize=function(){return t.extend({},this._options,{type:this.type,data:this._data})},n.prototype.hasTransition=function(){return!1},n}(t.Evented),I=t.createLayout([{name:"a_pos",type:"Int16",components:2},{name:"a_texture_pos",type:"Int16",components:2}]),B=function(e){function n(t,n,r,i){e.call(this),this.id=t,this.dispatcher=r,this.coordinates=n.coordinates,this.type="image",this.minzoom=0,this.maxzoom=22,this.tileSize=512,this.tiles={},this._loaded=!1,this.setEventedParent(i),this.options=n}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.load=function(e,n){var r=this;this._loaded=!1,this.fire(new t.Event("dataloading",{dataType:"source"})),this.url=this.options.url,t.getImage(this.map._requestManager.transformRequest(this.url,t.ResourceType.Image),(function(i,o){r._loaded=!0,i?r.fire(new t.ErrorEvent(i)):o&&(r.image=o,e&&(r.coordinates=e),n&&n(),r._finishLoading())}))},n.prototype.loaded=function(){return this._loaded},n.prototype.updateImage=function(t){var e=this;return this.image&&t.url?(this.options.url=t.url,this.load(t.coordinates,(function(){e.texture=null})),this):this},n.prototype._finishLoading=function(){this.map&&(this.setCoordinates(this.coordinates),this.fire(new t.Event("data",{dataType:"source",sourceDataType:"metadata"})))},n.prototype.onAdd=function(t){this.map=t,this.load()},n.prototype.setCoordinates=function(e){var n=this;this.coordinates=e;var r=e.map(t.MercatorCoordinate.fromLngLat);this.tileID=function(e){for(var n=1/0,r=1/0,i=-1/0,o=-1/0,a=0,s=e;a<s.length;a+=1){var u=s[a];n=Math.min(n,u.x),r=Math.min(r,u.y),i=Math.max(i,u.x),o=Math.max(o,u.y)}var c=Math.max(i-n,o-r),l=Math.max(0,Math.floor(-Math.log(c)/Math.LN2)),h=Math.pow(2,l);return new t.CanonicalTileID(l,Math.floor((n+i)/2*h),Math.floor((r+o)/2*h))}(r),this.minzoom=this.maxzoom=this.tileID.z;var i=r.map((function(t){return n.tileID.getTilePoint(t)._round()}));return this._boundsArray=new t.StructArrayLayout4i8,this._boundsArray.emplaceBack(i[0].x,i[0].y,0,0),this._boundsArray.emplaceBack(i[1].x,i[1].y,t.EXTENT,0),this._boundsArray.emplaceBack(i[3].x,i[3].y,0,t.EXTENT),this._boundsArray.emplaceBack(i[2].x,i[2].y,t.EXTENT,t.EXTENT),this.boundsBuffer&&(this.boundsBuffer.destroy(),delete this.boundsBuffer),this.fire(new t.Event("data",{dataType:"source",sourceDataType:"content"})),this},n.prototype.prepare=function(){if(0!==Object.keys(this.tiles).length&&this.image){var e=this.map.painter.context,n=e.gl;for(var r in this.boundsBuffer||(this.boundsBuffer=e.createVertexBuffer(this._boundsArray,I.members)),this.boundsSegments||(this.boundsSegments=t.SegmentVector.simpleSegment(0,0,4,2)),this.texture||(this.texture=new t.Texture(e,this.image,n.RGBA),this.texture.bind(n.LINEAR,n.CLAMP_TO_EDGE)),this.tiles){var i=this.tiles[r];"loaded"!==i.state&&(i.state="loaded",i.texture=this.texture)}}},n.prototype.loadTile=function(t,e){this.tileID&&this.tileID.equals(t.tileID.canonical)?(this.tiles[String(t.tileID.wrap)]=t,t.buckets={},e(null)):(t.state="errored",e(null))},n.prototype.serialize=function(){return{type:"image",url:this.options.url,coordinates:this.coordinates}},n.prototype.hasTransition=function(){return!1},n}(t.Evented),R=function(e){function n(t,n,r,i){e.call(this,t,n,r,i),this.roundZoom=!0,this.type="video",this.options=n}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.load=function(){var e=this;this._loaded=!1;var n=this.options;this.urls=[];for(var r=0,i=n.urls;r<i.length;r+=1)this.urls.push(this.map._requestManager.transformRequest(i[r],t.ResourceType.Source).url);t.getVideo(this.urls,(function(n,r){e._loaded=!0,n?e.fire(new t.ErrorEvent(n)):r&&(e.video=r,e.video.loop=!0,e.video.setAttribute("playsinline",""),e.video.addEventListener("playing",(function(){e.map.triggerRepaint()})),e.map&&e.video.play(),e._finishLoading())}))},n.prototype.pause=function(){this.video&&this.video.pause()},n.prototype.play=function(){this.video&&this.video.play()},n.prototype.seek=function(e){if(this.video){var n=this.video.seekable;e<n.start(0)||e>n.end(0)?this.fire(new t.ErrorEvent(new t.ValidationError("sources."+this.id,null,"Playback for this video can be set only between the "+n.start(0)+" and "+n.end(0)+"-second mark."))):this.video.currentTime=e}},n.prototype.getVideo=function(){return this.video},n.prototype.onAdd=function(t){this.map||(this.map=t,this.load(),this.video&&(this.video.play(),this.setCoordinates(this.coordinates)))},n.prototype.prepare=function(){if(!(0===Object.keys(this.tiles).length||this.video.readyState<2)){var e=this.map.painter.context,n=e.gl;for(var r in this.boundsBuffer||(this.boundsBuffer=e.createVertexBuffer(this._boundsArray,I.members)),this.boundsSegments||(this.boundsSegments=t.SegmentVector.simpleSegment(0,0,4,2)),this.texture?this.video.paused||(this.texture.bind(n.LINEAR,n.CLAMP_TO_EDGE),n.texSubImage2D(n.TEXTURE_2D,0,0,0,n.RGBA,n.UNSIGNED_BYTE,this.video)):(this.texture=new t.Texture(e,this.video,n.RGBA),this.texture.bind(n.LINEAR,n.CLAMP_TO_EDGE)),this.tiles){var i=this.tiles[r];"loaded"!==i.state&&(i.state="loaded",i.texture=this.texture)}}},n.prototype.serialize=function(){return{type:"video",urls:this.urls,coordinates:this.coordinates}},n.prototype.hasTransition=function(){return this.video&&!this.video.paused},n}(B),k=function(e){function n(n,r,i,o){e.call(this,n,r,i,o),r.coordinates?Array.isArray(r.coordinates)&&4===r.coordinates.length&&!r.coordinates.some((function(t){return!Array.isArray(t)||2!==t.length||t.some((function(t){return"number"!=typeof t}))}))||this.fire(new t.ErrorEvent(new t.ValidationError("sources."+n,null,'"coordinates" property must be an array of 4 longitude/latitude array pairs'))):this.fire(new t.ErrorEvent(new t.ValidationError("sources."+n,null,'missing required property "coordinates"'))),r.animate&&"boolean"!=typeof r.animate&&this.fire(new t.ErrorEvent(new t.ValidationError("sources."+n,null,'optional "animate" property must be a boolean value'))),r.canvas?"string"==typeof r.canvas||r.canvas instanceof t.window.HTMLCanvasElement||this.fire(new t.ErrorEvent(new t.ValidationError("sources."+n,null,'"canvas" must be either a string representing the ID of the canvas element from which to read, or an HTMLCanvasElement instance'))):this.fire(new t.ErrorEvent(new t.ValidationError("sources."+n,null,'missing required property "canvas"'))),this.options=r,this.animate=void 0===r.animate||r.animate}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.load=function(){this._loaded=!0,this.canvas||(this.canvas=this.options.canvas instanceof t.window.HTMLCanvasElement?this.options.canvas:t.window.document.getElementById(this.options.canvas)),this.width=this.canvas.width,this.height=this.canvas.height,this._hasInvalidDimensions()?this.fire(new t.ErrorEvent(new Error("Canvas dimensions cannot be less than or equal to zero."))):(this.play=function(){this._playing=!0,this.map.triggerRepaint()},this.pause=function(){this._playing&&(this.prepare(),this._playing=!1)},this._finishLoading())},n.prototype.getCanvas=function(){return this.canvas},n.prototype.onAdd=function(t){this.map=t,this.load(),this.canvas&&this.animate&&this.play()},n.prototype.onRemove=function(){this.pause()},n.prototype.prepare=function(){var e=!1;if(this.canvas.width!==this.width&&(this.width=this.canvas.width,e=!0),this.canvas.height!==this.height&&(this.height=this.canvas.height,e=!0),!this._hasInvalidDimensions()&&0!==Object.keys(this.tiles).length){var n=this.map.painter.context,r=n.gl;for(var i in this.boundsBuffer||(this.boundsBuffer=n.createVertexBuffer(this._boundsArray,I.members)),this.boundsSegments||(this.boundsSegments=t.SegmentVector.simpleSegment(0,0,4,2)),this.texture?(e||this._playing)&&this.texture.update(this.canvas,{premultiply:!0}):this.texture=new t.Texture(n,this.canvas,r.RGBA,{premultiply:!0}),this.tiles){var o=this.tiles[i];"loaded"!==o.state&&(o.state="loaded",o.texture=this.texture)}}},n.prototype.serialize=function(){return{type:"canvas",coordinates:this.coordinates}},n.prototype.hasTransition=function(){return this._playing},n.prototype._hasInvalidDimensions=function(){for(var t=0,e=[this.canvas.width,this.canvas.height];t<e.length;t+=1){var n=e[t];if(isNaN(n)||n<=0)return!0}return!1},n}(B),D={vector:T,raster:C,"raster-dem":P,geojson:M,video:R,image:B,canvas:k};function L(e,n){var r=t.identity([]);return t.translate(r,r,[1,1,0]),t.scale(r,r,[.5*e.width,.5*e.height,1]),t.multiply(r,r,e.calculatePosMatrix(n.toUnwrapped()))}function j(t,e,n,r,i,o){var a=function(t,e,n){if(t)for(var r=0,i=t;r<i.length;r+=1){var o=e[i[r]];if(o&&o.source===n&&"fill-extrusion"===o.type)return!0}else for(var a in e){var s=e[a];if(s.source===n&&"fill-extrusion"===s.type)return!0}return!1}(i&&i.layers,e,t.id),s=o.maxPitchScaleFactor(),u=t.tilesIn(r,s,a);u.sort(F);for(var c=[],l=0,h=u;l<h.length;l+=1){var f=h[l];c.push({wrappedTileID:f.tileID.wrapped().key,queryResults:f.tile.queryRenderedFeatures(e,n,t._state,f.queryGeometry,f.cameraQueryGeometry,f.scale,i,o,s,L(t.transform,f.tileID))})}var p=function(t){for(var e={},n={},r=0,i=t;r<i.length;r+=1){var o=i[r],a=o.queryResults,s=o.wrappedTileID,u=n[s]=n[s]||{};for(var c in a)for(var l=a[c],h=u[c]=u[c]||{},f=e[c]=e[c]||[],p=0,d=l;p<d.length;p+=1){var A=d[p];h[A.featureIndex]||(h[A.featureIndex]=!0,f.push(A))}}return e}(c);for(var d in p)p[d].forEach((function(e){var n=e.feature,r=t.getFeatureState(n.layer["source-layer"],n.id);n.source=n.layer.source,n.layer["source-layer"]&&(n.sourceLayer=n.layer["source-layer"]),n.state=r}));return p}function F(t,e){var n=t.tileID,r=e.tileID;return n.overscaledZ-r.overscaledZ||n.canonical.y-r.canonical.y||n.wrap-r.wrap||n.canonical.x-r.canonical.x}var z=function(t,e){this.max=t,this.onRemove=e,this.reset()};z.prototype.reset=function(){for(var t in this.data)for(var e=0,n=this.data[t];e<n.length;e+=1){var r=n[e];r.timeout&&clearTimeout(r.timeout),this.onRemove(r.value)}return this.data={},this.order=[],this},z.prototype.add=function(t,e,n){var r=this,i=t.wrapped().key;void 0===this.data[i]&&(this.data[i]=[]);var o={value:e,timeout:void 0};if(void 0!==n&&(o.timeout=setTimeout((function(){r.remove(t,o)}),n)),this.data[i].push(o),this.order.push(i),this.order.length>this.max){var a=this._getAndRemoveByKey(this.order[0]);a&&this.onRemove(a)}return this},z.prototype.has=function(t){return t.wrapped().key in this.data},z.prototype.getAndRemove=function(t){return this.has(t)?this._getAndRemoveByKey(t.wrapped().key):null},z.prototype._getAndRemoveByKey=function(t){var e=this.data[t].shift();return e.timeout&&clearTimeout(e.timeout),0===this.data[t].length&&delete this.data[t],this.order.splice(this.order.indexOf(t),1),e.value},z.prototype.getByKey=function(t){var e=this.data[t];return e?e[0].value:null},z.prototype.get=function(t){return this.has(t)?this.data[t.wrapped().key][0].value:null},z.prototype.remove=function(t,e){if(!this.has(t))return this;var n=t.wrapped().key,r=void 0===e?0:this.data[n].indexOf(e),i=this.data[n][r];return this.data[n].splice(r,1),i.timeout&&clearTimeout(i.timeout),0===this.data[n].length&&delete this.data[n],this.onRemove(i.value),this.order.splice(this.order.indexOf(n),1),this},z.prototype.setMaxSize=function(t){for(this.max=t;this.order.length>this.max;){var e=this._getAndRemoveByKey(this.order[0]);e&&this.onRemove(e)}return this},z.prototype.filter=function(t){var e=[];for(var n in this.data)for(var r=0,i=this.data[n];r<i.length;r+=1){var o=i[r];t(o.value)||e.push(o)}for(var a=0,s=e;a<s.length;a+=1){var u=s[a];this.remove(u.value.tileID,u)}};var U=function(t,e,n){this.context=t;var r=t.gl;this.buffer=r.createBuffer(),this.dynamicDraw=Boolean(n),this.context.unbindVAO(),t.bindElementBuffer.set(this.buffer),r.bufferData(r.ELEMENT_ARRAY_BUFFER,e.arrayBuffer,this.dynamicDraw?r.DYNAMIC_DRAW:r.STATIC_DRAW),this.dynamicDraw||delete e.arrayBuffer};U.prototype.bind=function(){this.context.bindElementBuffer.set(this.buffer)},U.prototype.updateData=function(t){var e=this.context.gl;this.context.unbindVAO(),this.bind(),e.bufferSubData(e.ELEMENT_ARRAY_BUFFER,0,t.arrayBuffer)},U.prototype.destroy=function(){this.buffer&&(this.context.gl.deleteBuffer(this.buffer),delete this.buffer)};var N={Int8:"BYTE",Uint8:"UNSIGNED_BYTE",Int16:"SHORT",Uint16:"UNSIGNED_SHORT",Int32:"INT",Uint32:"UNSIGNED_INT",Float32:"FLOAT"},G=function(t,e,n,r){this.length=e.length,this.attributes=n,this.itemSize=e.bytesPerElement,this.dynamicDraw=r,this.context=t;var i=t.gl;this.buffer=i.createBuffer(),t.bindVertexBuffer.set(this.buffer),i.bufferData(i.ARRAY_BUFFER,e.arrayBuffer,this.dynamicDraw?i.DYNAMIC_DRAW:i.STATIC_DRAW),this.dynamicDraw||delete e.arrayBuffer};G.prototype.bind=function(){this.context.bindVertexBuffer.set(this.buffer)},G.prototype.updateData=function(t){var e=this.context.gl;this.bind(),e.bufferSubData(e.ARRAY_BUFFER,0,t.arrayBuffer)},G.prototype.enableAttributes=function(t,e){for(var n=0;n<this.attributes.length;n++){var r=e.attributes[this.attributes[n].name];void 0!==r&&t.enableVertexAttribArray(r)}},G.prototype.setVertexAttribPointers=function(t,e,n){for(var r=0;r<this.attributes.length;r++){var i=this.attributes[r],o=e.attributes[i.name];void 0!==o&&t.vertexAttribPointer(o,i.components,t[N[i.type]],!1,this.itemSize,i.offset+this.itemSize*(n||0))}},G.prototype.destroy=function(){this.buffer&&(this.context.gl.deleteBuffer(this.buffer),delete this.buffer)};var V=function(t){this.gl=t.gl,this.default=this.getDefault(),this.current=this.default,this.dirty=!1};V.prototype.get=function(){return this.current},V.prototype.set=function(t){},V.prototype.getDefault=function(){return this.default},V.prototype.setDefault=function(){this.set(this.default)};var H=function(e){function n(){e.apply(this,arguments)}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.getDefault=function(){return t.Color.transparent},n.prototype.set=function(t){var e=this.current;(t.r!==e.r||t.g!==e.g||t.b!==e.b||t.a!==e.a||this.dirty)&&(this.gl.clearColor(t.r,t.g,t.b,t.a),this.current=t,this.dirty=!1)},n}(V),W=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return 1},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.clearDepth(t),this.current=t,this.dirty=!1)},e}(V),q=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return 0},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.clearStencil(t),this.current=t,this.dirty=!1)},e}(V),X=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return[!0,!0,!0,!0]},e.prototype.set=function(t){var e=this.current;(t[0]!==e[0]||t[1]!==e[1]||t[2]!==e[2]||t[3]!==e[3]||this.dirty)&&(this.gl.colorMask(t[0],t[1],t[2],t[3]),this.current=t,this.dirty=!1)},e}(V),Z=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return!0},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.depthMask(t),this.current=t,this.dirty=!1)},e}(V),J=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return 255},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.stencilMask(t),this.current=t,this.dirty=!1)},e}(V),Q=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return{func:this.gl.ALWAYS,ref:0,mask:255}},e.prototype.set=function(t){var e=this.current;(t.func!==e.func||t.ref!==e.ref||t.mask!==e.mask||this.dirty)&&(this.gl.stencilFunc(t.func,t.ref,t.mask),this.current=t,this.dirty=!1)},e}(V),K=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){var t=this.gl;return[t.KEEP,t.KEEP,t.KEEP]},e.prototype.set=function(t){var e=this.current;(t[0]!==e[0]||t[1]!==e[1]||t[2]!==e[2]||this.dirty)&&(this.gl.stencilOp(t[0],t[1],t[2]),this.current=t,this.dirty=!1)},e}(V),Y=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return!1},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;t?e.enable(e.STENCIL_TEST):e.disable(e.STENCIL_TEST),this.current=t,this.dirty=!1}},e}(V),$=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return[0,1]},e.prototype.set=function(t){var e=this.current;(t[0]!==e[0]||t[1]!==e[1]||this.dirty)&&(this.gl.depthRange(t[0],t[1]),this.current=t,this.dirty=!1)},e}(V),tt=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return!1},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;t?e.enable(e.DEPTH_TEST):e.disable(e.DEPTH_TEST),this.current=t,this.dirty=!1}},e}(V),et=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return this.gl.LESS},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.depthFunc(t),this.current=t,this.dirty=!1)},e}(V),nt=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return!1},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;t?e.enable(e.BLEND):e.disable(e.BLEND),this.current=t,this.dirty=!1}},e}(V),rt=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){var t=this.gl;return[t.ONE,t.ZERO]},e.prototype.set=function(t){var e=this.current;(t[0]!==e[0]||t[1]!==e[1]||this.dirty)&&(this.gl.blendFunc(t[0],t[1]),this.current=t,this.dirty=!1)},e}(V),it=function(e){function n(){e.apply(this,arguments)}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.getDefault=function(){return t.Color.transparent},n.prototype.set=function(t){var e=this.current;(t.r!==e.r||t.g!==e.g||t.b!==e.b||t.a!==e.a||this.dirty)&&(this.gl.blendColor(t.r,t.g,t.b,t.a),this.current=t,this.dirty=!1)},n}(V),ot=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return this.gl.FUNC_ADD},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.blendEquation(t),this.current=t,this.dirty=!1)},e}(V),at=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return!1},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;t?e.enable(e.CULL_FACE):e.disable(e.CULL_FACE),this.current=t,this.dirty=!1}},e}(V),st=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return this.gl.BACK},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.cullFace(t),this.current=t,this.dirty=!1)},e}(V),ut=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return this.gl.CCW},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.frontFace(t),this.current=t,this.dirty=!1)},e}(V),ct=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.useProgram(t),this.current=t,this.dirty=!1)},e}(V),lt=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return this.gl.TEXTURE0},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.activeTexture(t),this.current=t,this.dirty=!1)},e}(V),ht=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){var t=this.gl;return[0,0,t.drawingBufferWidth,t.drawingBufferHeight]},e.prototype.set=function(t){var e=this.current;(t[0]!==e[0]||t[1]!==e[1]||t[2]!==e[2]||t[3]!==e[3]||this.dirty)&&(this.gl.viewport(t[0],t[1],t[2],t[3]),this.current=t,this.dirty=!1)},e}(V),ft=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.bindFramebuffer(e.FRAMEBUFFER,t),this.current=t,this.dirty=!1}},e}(V),pt=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.bindRenderbuffer(e.RENDERBUFFER,t),this.current=t,this.dirty=!1}},e}(V),dt=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.bindTexture(e.TEXTURE_2D,t),this.current=t,this.dirty=!1}},e}(V),At=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.bindBuffer(e.ARRAY_BUFFER,t),this.current=t,this.dirty=!1}},e}(V),gt=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){var e=this.gl;e.bindBuffer(e.ELEMENT_ARRAY_BUFFER,t),this.current=t,this.dirty=!1},e}(V),mt=function(t){function e(e){t.call(this,e),this.vao=e.extVertexArrayObject}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){this.vao&&(t!==this.current||this.dirty)&&(this.vao.bindVertexArrayOES(t),this.current=t,this.dirty=!1)},e}(V),yt=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return 4},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.pixelStorei(e.UNPACK_ALIGNMENT,t),this.current=t,this.dirty=!1}},e}(V),vt=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return!1},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.pixelStorei(e.UNPACK_PREMULTIPLY_ALPHA_WEBGL,t),this.current=t,this.dirty=!1}},e}(V),_t=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return!1},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.pixelStorei(e.UNPACK_FLIP_Y_WEBGL,t),this.current=t,this.dirty=!1}},e}(V),bt=function(t){function e(e,n){t.call(this,e),this.context=e,this.parent=n}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e}(V),xt=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.setDirty=function(){this.dirty=!0},e.prototype.set=function(t){if(t!==this.current||this.dirty){this.context.bindFramebuffer.set(this.parent);var e=this.gl;e.framebufferTexture2D(e.FRAMEBUFFER,e.COLOR_ATTACHMENT0,e.TEXTURE_2D,t,0),this.current=t,this.dirty=!1}},e}(bt),wt=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){if(t!==this.current||this.dirty){this.context.bindFramebuffer.set(this.parent);var e=this.gl;e.framebufferRenderbuffer(e.FRAMEBUFFER,e.DEPTH_ATTACHMENT,e.RENDERBUFFER,t),this.current=t,this.dirty=!1}},e}(bt),Et=function(t,e,n,r){this.context=t,this.width=e,this.height=n;var i=this.framebuffer=t.gl.createFramebuffer();this.colorAttachment=new xt(t,i),r&&(this.depthAttachment=new wt(t,i))};Et.prototype.destroy=function(){var t=this.context.gl,e=this.colorAttachment.get();if(e&&t.deleteTexture(e),this.depthAttachment){var n=this.depthAttachment.get();n&&t.deleteRenderbuffer(n)}t.deleteFramebuffer(this.framebuffer)};var Ot=function(t,e,n){this.func=t,this.mask=e,this.range=n};Ot.ReadOnly=!1,Ot.ReadWrite=!0,Ot.disabled=new Ot(519,Ot.ReadOnly,[0,1]);var St=function(t,e,n,r,i,o){this.test=t,this.ref=e,this.mask=n,this.fail=r,this.depthFail=i,this.pass=o};St.disabled=new St({func:519,mask:0},0,0,7680,7680,7680);var Tt=function(t,e,n){this.blendFunction=t,this.blendColor=e,this.mask=n};Tt.disabled=new Tt(Tt.Replace=[1,0],t.Color.transparent,[!1,!1,!1,!1]),Tt.unblended=new Tt(Tt.Replace,t.Color.transparent,[!0,!0,!0,!0]),Tt.alphaBlended=new Tt([1,771],t.Color.transparent,[!0,!0,!0,!0]);var Ct=function(t,e,n){this.enable=t,this.mode=e,this.frontFace=n};Ct.disabled=new Ct(!1,1029,2305),Ct.backCCW=new Ct(!0,1029,2305);var Pt=function(t){this.gl=t,this.extVertexArrayObject=this.gl.getExtension("OES_vertex_array_object"),this.clearColor=new H(this),this.clearDepth=new W(this),this.clearStencil=new q(this),this.colorMask=new X(this),this.depthMask=new Z(this),this.stencilMask=new J(this),this.stencilFunc=new Q(this),this.stencilOp=new K(this),this.stencilTest=new Y(this),this.depthRange=new $(this),this.depthTest=new tt(this),this.depthFunc=new et(this),this.blend=new nt(this),this.blendFunc=new rt(this),this.blendColor=new it(this),this.blendEquation=new ot(this),this.cullFace=new at(this),this.cullFaceSide=new st(this),this.frontFace=new ut(this),this.program=new ct(this),this.activeTexture=new lt(this),this.viewport=new ht(this),this.bindFramebuffer=new ft(this),this.bindRenderbuffer=new pt(this),this.bindTexture=new dt(this),this.bindVertexBuffer=new At(this),this.bindElementBuffer=new gt(this),this.bindVertexArrayOES=this.extVertexArrayObject&&new mt(this),this.pixelStoreUnpack=new yt(this),this.pixelStoreUnpackPremultiplyAlpha=new vt(this),this.pixelStoreUnpackFlipY=new _t(this),this.extTextureFilterAnisotropic=t.getExtension("EXT_texture_filter_anisotropic")||t.getExtension("MOZ_EXT_texture_filter_anisotropic")||t.getExtension("WEBKIT_EXT_texture_filter_anisotropic"),this.extTextureFilterAnisotropic&&(this.extTextureFilterAnisotropicMax=t.getParameter(this.extTextureFilterAnisotropic.MAX_TEXTURE_MAX_ANISOTROPY_EXT)),this.extTextureHalfFloat=t.getExtension("OES_texture_half_float"),this.extTextureHalfFloat&&(t.getExtension("OES_texture_half_float_linear"),this.extRenderToTextureHalfFloat=t.getExtension("EXT_color_buffer_half_float")),this.extTimerQuery=t.getExtension("EXT_disjoint_timer_query"),this.maxTextureSize=t.getParameter(t.MAX_TEXTURE_SIZE)};Pt.prototype.setDefault=function(){this.unbindVAO(),this.clearColor.setDefault(),this.clearDepth.setDefault(),this.clearStencil.setDefault(),this.colorMask.setDefault(),this.depthMask.setDefault(),this.stencilMask.setDefault(),this.stencilFunc.setDefault(),this.stencilOp.setDefault(),this.stencilTest.setDefault(),this.depthRange.setDefault(),this.depthTest.setDefault(),this.depthFunc.setDefault(),this.blend.setDefault(),this.blendFunc.setDefault(),this.blendColor.setDefault(),this.blendEquation.setDefault(),this.cullFace.setDefault(),this.cullFaceSide.setDefault(),this.frontFace.setDefault(),this.program.setDefault(),this.activeTexture.setDefault(),this.bindFramebuffer.setDefault(),this.pixelStoreUnpack.setDefault(),this.pixelStoreUnpackPremultiplyAlpha.setDefault(),this.pixelStoreUnpackFlipY.setDefault()},Pt.prototype.setDirty=function(){this.clearColor.dirty=!0,this.clearDepth.dirty=!0,this.clearStencil.dirty=!0,this.colorMask.dirty=!0,this.depthMask.dirty=!0,this.stencilMask.dirty=!0,this.stencilFunc.dirty=!0,this.stencilOp.dirty=!0,this.stencilTest.dirty=!0,this.depthRange.dirty=!0,this.depthTest.dirty=!0,this.depthFunc.dirty=!0,this.blend.dirty=!0,this.blendFunc.dirty=!0,this.blendColor.dirty=!0,this.blendEquation.dirty=!0,this.cullFace.dirty=!0,this.cullFaceSide.dirty=!0,this.frontFace.dirty=!0,this.program.dirty=!0,this.activeTexture.dirty=!0,this.viewport.dirty=!0,this.bindFramebuffer.dirty=!0,this.bindRenderbuffer.dirty=!0,this.bindTexture.dirty=!0,this.bindVertexBuffer.dirty=!0,this.bindElementBuffer.dirty=!0,this.extVertexArrayObject&&(this.bindVertexArrayOES.dirty=!0),this.pixelStoreUnpack.dirty=!0,this.pixelStoreUnpackPremultiplyAlpha.dirty=!0,this.pixelStoreUnpackFlipY.dirty=!0},Pt.prototype.createIndexBuffer=function(t,e){return new U(this,t,e)},Pt.prototype.createVertexBuffer=function(t,e,n){return new G(this,t,e,n)},Pt.prototype.createRenderbuffer=function(t,e,n){var r=this.gl,i=r.createRenderbuffer();return this.bindRenderbuffer.set(i),r.renderbufferStorage(r.RENDERBUFFER,t,e,n),this.bindRenderbuffer.set(null),i},Pt.prototype.createFramebuffer=function(t,e,n){return new Et(this,t,e,n)},Pt.prototype.clear=function(t){var e=t.color,n=t.depth,r=this.gl,i=0;e&&(i|=r.COLOR_BUFFER_BIT,this.clearColor.set(e),this.colorMask.set([!0,!0,!0,!0])),void 0!==n&&(i|=r.DEPTH_BUFFER_BIT,this.depthRange.set([0,1]),this.clearDepth.set(n),this.depthMask.set(!0)),r.clear(i)},Pt.prototype.setCullFace=function(t){!1===t.enable?this.cullFace.set(!1):(this.cullFace.set(!0),this.cullFaceSide.set(t.mode),this.frontFace.set(t.frontFace))},Pt.prototype.setDepthMode=function(t){t.func!==this.gl.ALWAYS||t.mask?(this.depthTest.set(!0),this.depthFunc.set(t.func),this.depthMask.set(t.mask),this.depthRange.set(t.range)):this.depthTest.set(!1)},Pt.prototype.setStencilMode=function(t){t.test.func!==this.gl.ALWAYS||t.mask?(this.stencilTest.set(!0),this.stencilMask.set(t.mask),this.stencilOp.set([t.fail,t.depthFail,t.pass]),this.stencilFunc.set({func:t.test.func,ref:t.ref,mask:t.test.mask})):this.stencilTest.set(!1)},Pt.prototype.setColorMode=function(e){t.deepEqual(e.blendFunction,Tt.Replace)?this.blend.set(!1):(this.blend.set(!0),this.blendFunc.set(e.blendFunction),this.blendColor.set(e.blendColor)),this.colorMask.set(e.mask)},Pt.prototype.unbindVAO=function(){this.extVertexArrayObject&&this.bindVertexArrayOES.set(null)};var Mt=function(e){function n(n,r,i){var o=this;e.call(this),this.id=n,this.dispatcher=i,this.on("data",(function(t){"source"===t.dataType&&"metadata"===t.sourceDataType&&(o._sourceLoaded=!0),o._sourceLoaded&&!o._paused&&"source"===t.dataType&&"content"===t.sourceDataType&&(o.reload(),o.transform&&o.update(o.transform))})),this.on("error",(function(){o._sourceErrored=!0})),this._source=function(e,n,r,i){var o=new D[n.type](e,n,r,i);if(o.id!==e)throw new Error("Expected Source id to be "+e+" instead of "+o.id);return t.bindAll(["load","abort","unload","serialize","prepare"],o),o}(n,r,i,this),this._tiles={},this._cache=new z(0,this._unloadTile.bind(this)),this._timers={},this._cacheTimers={},this._maxTileCacheSize=null,this._loadedParentTiles={},this._coveredTiles={},this._state=new t.SourceFeatureState}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.onAdd=function(t){this.map=t,this._maxTileCacheSize=t?t._maxTileCacheSize:null,this._source&&this._source.onAdd&&this._source.onAdd(t)},n.prototype.onRemove=function(t){this._source&&this._source.onRemove&&this._source.onRemove(t)},n.prototype.loaded=function(){if(this._sourceErrored)return!0;if(!this._sourceLoaded)return!1;if(!this._source.loaded())return!1;for(var t in this._tiles){var e=this._tiles[t];if("loaded"!==e.state&&"errored"!==e.state)return!1}return!0},n.prototype.getSource=function(){return this._source},n.prototype.pause=function(){this._paused=!0},n.prototype.resume=function(){if(this._paused){var t=this._shouldReloadOnResume;this._paused=!1,this._shouldReloadOnResume=!1,t&&this.reload(),this.transform&&this.update(this.transform)}},n.prototype._loadTile=function(t,e){return this._source.loadTile(t,e)},n.prototype._unloadTile=function(t){if(this._source.unloadTile)return this._source.unloadTile(t,(function(){}))},n.prototype._abortTile=function(t){if(this._source.abortTile)return this._source.abortTile(t,(function(){}))},n.prototype.serialize=function(){return this._source.serialize()},n.prototype.prepare=function(t){for(var e in this._source.prepare&&this._source.prepare(),this._state.coalesceChanges(this._tiles,this.map?this.map.painter:null),this._tiles){var n=this._tiles[e];n.upload(t),n.prepare(this.map.style.imageManager)}},n.prototype.getIds=function(){return t.values(this._tiles).map((function(t){return t.tileID})).sort(It).map((function(t){return t.key}))},n.prototype.getRenderableIds=function(e){var n=this,r=[];for(var i in this._tiles)this._isIdRenderable(i,e)&&r.push(this._tiles[i]);return e?r.sort((function(e,r){var i=e.tileID,o=r.tileID,a=new t.Point(i.canonical.x,i.canonical.y)._rotate(n.transform.angle),s=new t.Point(o.canonical.x,o.canonical.y)._rotate(n.transform.angle);return i.overscaledZ-o.overscaledZ||s.y-a.y||s.x-a.x})).map((function(t){return t.tileID.key})):r.map((function(t){return t.tileID})).sort(It).map((function(t){return t.key}))},n.prototype.hasRenderableParent=function(t){var e=this.findLoadedParent(t,0);return!!e&&this._isIdRenderable(e.tileID.key)},n.prototype._isIdRenderable=function(t,e){return this._tiles[t]&&this._tiles[t].hasData()&&!this._coveredTiles[t]&&(e||!this._tiles[t].holdingForFade())},n.prototype.reload=function(){if(this._paused)this._shouldReloadOnResume=!0;else for(var t in this._cache.reset(),this._tiles)"errored"!==this._tiles[t].state&&this._reloadTile(t,"reloading")},n.prototype._reloadTile=function(t,e){var n=this._tiles[t];n&&("loading"!==n.state&&(n.state=e),this._loadTile(n,this._tileLoaded.bind(this,n,t,e)))},n.prototype._tileLoaded=function(e,n,r,i){if(i)return e.state="errored",void(404!==i.status?this._source.fire(new t.ErrorEvent(i,{tile:e})):this.update(this.transform));e.timeAdded=t.browser.now(),"expired"===r&&(e.refreshedUponExpiration=!0),this._setTileReloadTimer(n,e),"raster-dem"===this.getSource().type&&e.dem&&this._backfillDEM(e),this._state.initializeTileState(e,this.map?this.map.painter:null),this._source.fire(new t.Event("data",{dataType:"source",tile:e,coord:e.tileID}))},n.prototype._backfillDEM=function(t){for(var e=this.getRenderableIds(),n=0;n<e.length;n++){var r=e[n];if(t.neighboringTiles&&t.neighboringTiles[r]){var i=this.getTileByID(r);o(t,i),o(i,t)}}function o(t,e){t.needsHillshadePrepare=!0;var n=e.tileID.canonical.x-t.tileID.canonical.x,r=e.tileID.canonical.y-t.tileID.canonical.y,i=Math.pow(2,t.tileID.canonical.z),o=e.tileID.key;0===n&&0===r||Math.abs(r)>1||(Math.abs(n)>1&&(1===Math.abs(n+i)?n+=i:1===Math.abs(n-i)&&(n-=i)),e.dem&&t.dem&&(t.dem.backfillBorder(e.dem,n,r),t.neighboringTiles&&t.neighboringTiles[o]&&(t.neighboringTiles[o].backfilled=!0)))}},n.prototype.getTile=function(t){return this.getTileByID(t.key)},n.prototype.getTileByID=function(t){return this._tiles[t]},n.prototype._retainLoadedChildren=function(t,e,n,r){for(var i in this._tiles){var o=this._tiles[i];if(!(r[i]||!o.hasData()||o.tileID.overscaledZ<=e||o.tileID.overscaledZ>n)){for(var a=o.tileID;o&&o.tileID.overscaledZ>e+1;){var s=o.tileID.scaledTo(o.tileID.overscaledZ-1);(o=this._tiles[s.key])&&o.hasData()&&(a=s)}for(var u=a;u.overscaledZ>e;)if(t[(u=u.scaledTo(u.overscaledZ-1)).key]){r[a.key]=a;break}}}},n.prototype.findLoadedParent=function(t,e){if(t.key in this._loadedParentTiles){var n=this._loadedParentTiles[t.key];return n&&n.tileID.overscaledZ>=e?n:null}for(var r=t.overscaledZ-1;r>=e;r--){var i=t.scaledTo(r),o=this._getLoadedTile(i);if(o)return o}},n.prototype._getLoadedTile=function(t){var e=this._tiles[t.key];return e&&e.hasData()?e:this._cache.getByKey(t.wrapped().key)},n.prototype.updateCacheSize=function(t){var e=Math.ceil(t.width/this._source.tileSize)+1,n=Math.ceil(t.height/this._source.tileSize)+1,r=Math.floor(e*n*5),i="number"==typeof this._maxTileCacheSize?Math.min(this._maxTileCacheSize,r):r;this._cache.setMaxSize(i)},n.prototype.handleWrapJump=function(t){var e=Math.round((t-(void 0===this._prevLng?t:this._prevLng))/360);if(this._prevLng=t,e){var n={};for(var r in this._tiles){var i=this._tiles[r];i.tileID=i.tileID.unwrapTo(i.tileID.wrap+e),n[i.tileID.key]=i}for(var o in this._tiles=n,this._timers)clearTimeout(this._timers[o]),delete this._timers[o];for(var a in this._tiles)this._setTileReloadTimer(a,this._tiles[a])}},n.prototype.update=function(e){var r=this;if(this.transform=e,this._sourceLoaded&&!this._paused){var i;this.updateCacheSize(e),this.handleWrapJump(this.transform.center.lng),this._coveredTiles={},this.used?this._source.tileID?i=e.getVisibleUnwrappedCoordinates(this._source.tileID).map((function(e){return new t.OverscaledTileID(e.canonical.z,e.wrap,e.canonical.z,e.canonical.x,e.canonical.y)})):(i=e.coveringTiles({tileSize:this._source.tileSize,minzoom:this._source.minzoom,maxzoom:this._source.maxzoom,roundZoom:this._source.roundZoom,reparseOverscaled:this._source.reparseOverscaled}),this._source.hasTile&&(i=i.filter((function(t){return r._source.hasTile(t)})))):i=[];var o=e.coveringZoomLevel(this._source),a=Math.max(o-n.maxOverzooming,this._source.minzoom),s=Math.max(o+n.maxUnderzooming,this._source.minzoom),u=this._updateRetainedTiles(i,o);if(Bt(this._source.type)){for(var c={},l={},h=0,f=Object.keys(u);h<f.length;h+=1){var p=f[h],d=u[p],A=this._tiles[p];if(A&&!(A.fadeEndTime&&A.fadeEndTime<=t.browser.now())){var g=this.findLoadedParent(d,a);g&&(this._addTile(g.tileID),c[g.tileID.key]=g.tileID),l[p]=d}}for(var m in this._retainLoadedChildren(l,o,s,u),c)u[m]||(this._coveredTiles[m]=!0,u[m]=c[m])}for(var y in u)this._tiles[y].clearFadeHold();for(var v=0,_=t.keysDifference(this._tiles,u);v<_.length;v+=1){var b=_[v],x=this._tiles[b];x.hasSymbolBuckets&&!x.holdingForFade()?x.setHoldDuration(this.map._fadeDuration):x.hasSymbolBuckets&&!x.symbolFadeFinished()||this._removeTile(b)}this._updateLoadedParentTileCache()}},n.prototype.releaseSymbolFadeTiles=function(){for(var t in this._tiles)this._tiles[t].holdingForFade()&&this._removeTile(t)},n.prototype._updateRetainedTiles=function(t,e){for(var r={},i={},o=Math.max(e-n.maxOverzooming,this._source.minzoom),a=Math.max(e+n.maxUnderzooming,this._source.minzoom),s={},u=0,c=t;u<c.length;u+=1){var l=c[u],h=this._addTile(l);r[l.key]=l,h.hasData()||e<this._source.maxzoom&&(s[l.key]=l)}this._retainLoadedChildren(s,e,a,r);for(var f=0,p=t;f<p.length;f+=1){var d=p[f],A=this._tiles[d.key];if(!A.hasData()){if(e+1>this._source.maxzoom){var g=d.children(this._source.maxzoom)[0],m=this.getTile(g);if(m&&m.hasData()){r[g.key]=g;continue}}else{var y=d.children(this._source.maxzoom);if(r[y[0].key]&&r[y[1].key]&&r[y[2].key]&&r[y[3].key])continue}for(var v=A.wasRequested(),_=d.overscaledZ-1;_>=o;--_){var b=d.scaledTo(_);if(i[b.key])break;if(i[b.key]=!0,!(A=this.getTile(b))&&v&&(A=this._addTile(b)),A&&(r[b.key]=b,v=A.wasRequested(),A.hasData()))break}}}return r},n.prototype._updateLoadedParentTileCache=function(){for(var t in this._loadedParentTiles={},this._tiles){for(var e=[],n=void 0,r=this._tiles[t].tileID;r.overscaledZ>0;){if(r.key in this._loadedParentTiles){n=this._loadedParentTiles[r.key];break}e.push(r.key);var i=r.scaledTo(r.overscaledZ-1);if(n=this._getLoadedTile(i))break;r=i}for(var o=0,a=e;o<a.length;o+=1)this._loadedParentTiles[a[o]]=n}},n.prototype._addTile=function(e){var n=this._tiles[e.key];if(n)return n;(n=this._cache.getAndRemove(e))&&(this._setTileReloadTimer(e.key,n),n.tileID=e,this._state.initializeTileState(n,this.map?this.map.painter:null),this._cacheTimers[e.key]&&(clearTimeout(this._cacheTimers[e.key]),delete this._cacheTimers[e.key],this._setTileReloadTimer(e.key,n)));var r=Boolean(n);return r||(n=new t.Tile(e,this._source.tileSize*e.overscaleFactor()),this._loadTile(n,this._tileLoaded.bind(this,n,e.key,n.state))),n?(n.uses++,this._tiles[e.key]=n,r||this._source.fire(new t.Event("dataloading",{tile:n,coord:n.tileID,dataType:"source"})),n):null},n.prototype._setTileReloadTimer=function(t,e){var n=this;t in this._timers&&(clearTimeout(this._timers[t]),delete this._timers[t]);var r=e.getExpiryTimeout();r&&(this._timers[t]=setTimeout((function(){n._reloadTile(t,"expired"),delete n._timers[t]}),r))},n.prototype._removeTile=function(t){var e=this._tiles[t];e&&(e.uses--,delete this._tiles[t],this._timers[t]&&(clearTimeout(this._timers[t]),delete this._timers[t]),e.uses>0||(e.hasData()&&"reloading"!==e.state?this._cache.add(e.tileID,e,e.getExpiryTimeout()):(e.aborted=!0,this._abortTile(e),this._unloadTile(e))))},n.prototype.clearTiles=function(){for(var t in this._shouldReloadOnResume=!1,this._paused=!1,this._tiles)this._removeTile(t);this._cache.reset()},n.prototype.tilesIn=function(e,n,r){var i=this,o=[],a=this.transform;if(!a)return o;for(var s=r?a.getCameraQueryGeometry(e):e,u=e.map((function(t){return a.pointCoordinate(t)})),c=s.map((function(t){return a.pointCoordinate(t)})),l=this.getIds(),h=1/0,f=1/0,p=-1/0,d=-1/0,A=0,g=c;A<g.length;A+=1){var m=g[A];h=Math.min(h,m.x),f=Math.min(f,m.y),p=Math.max(p,m.x),d=Math.max(d,m.y)}for(var y=function(e){var r=i._tiles[l[e]];if(!r.holdingForFade()){var s=r.tileID,A=Math.pow(2,a.zoom-r.tileID.overscaledZ),g=n*r.queryPadding*t.EXTENT/r.tileSize/A,m=[s.getTilePoint(new t.MercatorCoordinate(h,f)),s.getTilePoint(new t.MercatorCoordinate(p,d))];if(m[0].x-g<t.EXTENT&&m[0].y-g<t.EXTENT&&m[1].x+g>=0&&m[1].y+g>=0){var y=u.map((function(t){return s.getTilePoint(t)})),v=c.map((function(t){return s.getTilePoint(t)}));o.push({tile:r,tileID:s,queryGeometry:y,cameraQueryGeometry:v,scale:A})}}},v=0;v<l.length;v++)y(v);return o},n.prototype.getVisibleCoordinates=function(t){for(var e=this,n=this.getRenderableIds(t).map((function(t){return e._tiles[t].tileID})),r=0,i=n;r<i.length;r+=1){var o=i[r];o.posMatrix=this.transform.calculatePosMatrix(o.toUnwrapped())}return n},n.prototype.hasTransition=function(){if(this._source.hasTransition())return!0;if(Bt(this._source.type))for(var e in this._tiles){var n=this._tiles[e];if(void 0!==n.fadeEndTime&&n.fadeEndTime>=t.browser.now())return!0}return!1},n.prototype.setFeatureState=function(t,e,n){this._state.updateState(t=t||"_geojsonTileLayer",e,n)},n.prototype.removeFeatureState=function(t,e,n){this._state.removeFeatureState(t=t||"_geojsonTileLayer",e,n)},n.prototype.getFeatureState=function(t,e){return this._state.getState(t=t||"_geojsonTileLayer",e)},n.prototype.setDependencies=function(t,e,n){var r=this._tiles[t];r&&r.setDependencies(e,n)},n.prototype.reloadTilesForDependencies=function(t,e){for(var n in this._tiles)this._tiles[n].hasDependency(t,e)&&this._reloadTile(n,"reloading");this._cache.filter((function(n){return!n.hasDependency(t,e)}))},n}(t.Evented);function It(t,e){var n=Math.abs(2*t.wrap)-+(t.wrap<0),r=Math.abs(2*e.wrap)-+(e.wrap<0);return t.overscaledZ-e.overscaledZ||r-n||e.canonical.y-t.canonical.y||e.canonical.x-t.canonical.x}function Bt(t){return"raster"===t||"image"===t||"video"===t}function Rt(){return new t.window.Worker(Ji.workerUrl)}Mt.maxOverzooming=10,Mt.maxUnderzooming=3;var kt="mapboxgl_preloaded_worker_pool",Dt=function(){this.active={}};Dt.prototype.acquire=function(t){if(!this.workers)for(this.workers=[];this.workers.length<Dt.workerCount;)this.workers.push(new Rt);return this.active[t]=!0,this.workers.slice()},Dt.prototype.release=function(t){delete this.active[t],0===this.numActive()&&(this.workers.forEach((function(t){t.terminate()})),this.workers=null)},Dt.prototype.isPreloaded=function(){return!!this.active[kt]},Dt.prototype.numActive=function(){return Object.keys(this.active).length};var Lt,jt=Math.floor(t.browser.hardwareConcurrency/2);function Ft(){return Lt||(Lt=new Dt),Lt}function zt(e,n){var r={};for(var i in e)"ref"!==i&&(r[i]=e[i]);return t.refProperties.forEach((function(t){t in n&&(r[t]=n[t])})),r}function Ut(t){t=t.slice();for(var e=Object.create(null),n=0;n<t.length;n++)e[t[n].id]=t[n];for(var r=0;r<t.length;r++)"ref"in t[r]&&(t[r]=zt(t[r],e[t[r].ref]));return t}Dt.workerCount=Math.max(Math.min(jt,6),1);var Nt={setStyle:"setStyle",addLayer:"addLayer",removeLayer:"removeLayer",setPaintProperty:"setPaintProperty",setLayoutProperty:"setLayoutProperty",setFilter:"setFilter",addSource:"addSource",removeSource:"removeSource",setGeoJSONSourceData:"setGeoJSONSourceData",setLayerZoomRange:"setLayerZoomRange",setLayerProperty:"setLayerProperty",setCenter:"setCenter",setZoom:"setZoom",setBearing:"setBearing",setPitch:"setPitch",setSprite:"setSprite",setGlyphs:"setGlyphs",setTransition:"setTransition",setLight:"setLight"};function Gt(t,e,n){n.push({command:Nt.addSource,args:[t,e[t]]})}function Vt(t,e,n){e.push({command:Nt.removeSource,args:[t]}),n[t]=!0}function Ht(t,e,n,r){Vt(t,n,r),Gt(t,e,n)}function Wt(e,n,r){var i;for(i in e[r])if(e[r].hasOwnProperty(i)&&"data"!==i&&!t.deepEqual(e[r][i],n[r][i]))return!1;for(i in n[r])if(n[r].hasOwnProperty(i)&&"data"!==i&&!t.deepEqual(e[r][i],n[r][i]))return!1;return!0}function qt(e,n,r,i,o,a){var s;for(s in n=n||{},e=e||{})e.hasOwnProperty(s)&&(t.deepEqual(e[s],n[s])||r.push({command:a,args:[i,s,n[s],o]}));for(s in n)n.hasOwnProperty(s)&&!e.hasOwnProperty(s)&&(t.deepEqual(e[s],n[s])||r.push({command:a,args:[i,s,n[s],o]}))}function Xt(t){return t.id}function Zt(t,e){return t[e.id]=e,t}var Jt=function(t,e){this.reset(t,e)};Jt.prototype.reset=function(t,e){this.points=t||[],this._distances=[0];for(var n=1;n<this.points.length;n++)this._distances[n]=this._distances[n-1]+this.points[n].dist(this.points[n-1]);this.length=this._distances[this._distances.length-1],this.padding=Math.min(e||0,.5*this.length),this.paddedLength=this.length-2*this.padding},Jt.prototype.lerp=function(e){if(1===this.points.length)return this.points[0];e=t.clamp(e,0,1);for(var n=1,r=this._distances[n],i=e*this.paddedLength+this.padding;r<i&&n<this._distances.length;)r=this._distances[++n];var o=n-1,a=this._distances[o],s=r-a,u=s>0?(i-a)/s:0;return this.points[o].mult(1-u).add(this.points[n].mult(u))};var Qt=function(t,e,n){var r=this.boxCells=[],i=this.circleCells=[];this.xCellCount=Math.ceil(t/n),this.yCellCount=Math.ceil(e/n);for(var o=0;o<this.xCellCount*this.yCellCount;o++)r.push([]),i.push([]);this.circleKeys=[],this.boxKeys=[],this.bboxes=[],this.circles=[],this.width=t,this.height=e,this.xScale=this.xCellCount/t,this.yScale=this.yCellCount/e,this.boxUid=0,this.circleUid=0};function Kt(e,n,r,i,o){var a=t.create();return n?(t.scale(a,a,[1/o,1/o,1]),r||t.rotateZ(a,a,i.angle)):t.multiply(a,i.labelPlaneMatrix,e),a}function Yt(e,n,r,i,o){if(n){var a=t.clone(e);return t.scale(a,a,[o,o,1]),r||t.rotateZ(a,a,-i.angle),a}return i.glCoordMatrix}function $t(e,n){var r=[e.x,e.y,0,1];le(r,r,n);var i=r[3];return{point:new t.Point(r[0]/i,r[1]/i),signedDistanceFromCamera:i}}function te(t,e){return.5+t/e*.5}function ee(t,e){var n=t[0]/t[3],r=t[1]/t[3];return n>=-e[0]&&n<=e[0]&&r>=-e[1]&&r<=e[1]}function ne(e,n,r,i,o,a,s,u){var c=i?e.textSizeData:e.iconSizeData,l=t.evaluateSizeForZoom(c,r.transform.zoom),h=[256/r.width*2+1,256/r.height*2+1],f=i?e.text.dynamicLayoutVertexArray:e.icon.dynamicLayoutVertexArray;f.clear();for(var p=e.lineVertexArray,d=i?e.text.placedSymbolArray:e.icon.placedSymbolArray,A=r.transform.width/r.transform.height,g=!1,m=0;m<d.length;m++){var y=d.get(m);if(y.hidden||y.writingMode===t.WritingMode.vertical&&!g)ce(y.numGlyphs,f);else{g=!1;var v=[y.anchorX,y.anchorY,0,1];if(t.transformMat4(v,v,n),ee(v,h)){var _=te(r.transform.cameraToCenterDistance,v[3]),b=t.evaluateSizeForFeature(c,l,y),x=s?b/_:b*_,w=new t.Point(y.anchorX,y.anchorY),E=$t(w,o).point,O={},S=oe(y,x,!1,u,n,o,a,e.glyphOffsetArray,p,f,E,w,O,A);g=S.useVertical,(S.notEnoughRoom||g||S.needsFlipping&&oe(y,x,!0,u,n,o,a,e.glyphOffsetArray,p,f,E,w,O,A).notEnoughRoom)&&ce(y.numGlyphs,f)}else ce(y.numGlyphs,f)}}i?e.text.dynamicLayoutVertexBuffer.updateData(f):e.icon.dynamicLayoutVertexBuffer.updateData(f)}function re(t,e,n,r,i,o,a,s,u,c,l){var h=s.glyphStartIndex+s.numGlyphs,f=s.lineStartIndex,p=s.lineStartIndex+s.lineLength,d=e.getoffsetX(s.glyphStartIndex),A=e.getoffsetX(h-1),g=se(t*d,n,r,i,o,a,s.segment,f,p,u,c,l);if(!g)return null;var m=se(t*A,n,r,i,o,a,s.segment,f,p,u,c,l);return m?{first:g,last:m}:null}function ie(e,n,r,i){return e===t.WritingMode.horizontal&&Math.abs(r.y-n.y)>Math.abs(r.x-n.x)*i?{useVertical:!0}:(e===t.WritingMode.vertical?n.y<r.y:n.x>r.x)?{needsFlipping:!0}:null}function oe(e,n,r,i,o,a,s,u,c,l,h,f,p,d){var A,g=n/24,m=e.lineOffsetX*g,y=e.lineOffsetY*g;if(e.numGlyphs>1){var v=e.glyphStartIndex+e.numGlyphs,_=e.lineStartIndex,b=e.lineStartIndex+e.lineLength,x=re(g,u,m,y,r,h,f,e,c,a,p);if(!x)return{notEnoughRoom:!0};var w=$t(x.first.point,s).point,E=$t(x.last.point,s).point;if(i&&!r){var O=ie(e.writingMode,w,E,d);if(O)return O}A=[x.first];for(var S=e.glyphStartIndex+1;S<v-1;S++)A.push(se(g*u.getoffsetX(S),m,y,r,h,f,e.segment,_,b,c,a,p));A.push(x.last)}else{if(i&&!r){var T=$t(f,o).point,C=e.lineStartIndex+e.segment+1,P=new t.Point(c.getx(C),c.gety(C)),M=$t(P,o),I=M.signedDistanceFromCamera>0?M.point:ae(f,P,T,1,o),B=ie(e.writingMode,T,I,d);if(B)return B}var R=se(g*u.getoffsetX(e.glyphStartIndex),m,y,r,h,f,e.segment,e.lineStartIndex,e.lineStartIndex+e.lineLength,c,a,p);if(!R)return{notEnoughRoom:!0};A=[R]}for(var k=0,D=A;k<D.length;k+=1){var L=D[k];t.addDynamicAttributes(l,L.point,L.angle)}return{}}function ae(t,e,n,r,i){var o=$t(t.add(t.sub(e)._unit()),i).point,a=n.sub(o);return n.add(a._mult(r/a.mag()))}function se(e,n,r,i,o,a,s,u,c,l,h,f){var p=i?e-n:e+n,d=p>0?1:-1,A=0;i&&(d*=-1,A=Math.PI),d<0&&(A+=Math.PI);for(var g=d>0?u+s:u+s+1,m=o,y=o,v=0,_=0,b=Math.abs(p),x=[];v+_<=b;){if((g+=d)<u||g>=c)return null;if(y=m,x.push(m),void 0===(m=f[g])){var w=new t.Point(l.getx(g),l.gety(g)),E=$t(w,h);if(E.signedDistanceFromCamera>0)m=f[g]=E.point;else{var O=g-d;m=ae(0===v?a:new t.Point(l.getx(O),l.gety(O)),w,y,b-v+1,h)}}v+=_,_=y.dist(m)}var S=(b-v)/_,T=m.sub(y),C=T.mult(S)._add(y);C._add(T._unit()._perp()._mult(r*d));var P=A+Math.atan2(m.y-y.y,m.x-y.x);return x.push(C),{point:C,angle:P,path:x}}Qt.prototype.keysLength=function(){return this.boxKeys.length+this.circleKeys.length},Qt.prototype.insert=function(t,e,n,r,i){this._forEachCell(e,n,r,i,this._insertBoxCell,this.boxUid++),this.boxKeys.push(t),this.bboxes.push(e),this.bboxes.push(n),this.bboxes.push(r),this.bboxes.push(i)},Qt.prototype.insertCircle=function(t,e,n,r){this._forEachCell(e-r,n-r,e+r,n+r,this._insertCircleCell,this.circleUid++),this.circleKeys.push(t),this.circles.push(e),this.circles.push(n),this.circles.push(r)},Qt.prototype._insertBoxCell=function(t,e,n,r,i,o){this.boxCells[i].push(o)},Qt.prototype._insertCircleCell=function(t,e,n,r,i,o){this.circleCells[i].push(o)},Qt.prototype._query=function(t,e,n,r,i,o){if(n<0||t>this.width||r<0||e>this.height)return!i&&[];var a=[];if(t<=0&&e<=0&&this.width<=n&&this.height<=r){if(i)return!0;for(var s=0;s<this.boxKeys.length;s++)a.push({key:this.boxKeys[s],x1:this.bboxes[4*s],y1:this.bboxes[4*s+1],x2:this.bboxes[4*s+2],y2:this.bboxes[4*s+3]});for(var u=0;u<this.circleKeys.length;u++){var c=this.circles[3*u],l=this.circles[3*u+1],h=this.circles[3*u+2];a.push({key:this.circleKeys[u],x1:c-h,y1:l-h,x2:c+h,y2:l+h})}return o?a.filter(o):a}return this._forEachCell(t,e,n,r,this._queryCell,a,{hitTest:i,seenUids:{box:{},circle:{}}},o),i?a.length>0:a},Qt.prototype._queryCircle=function(t,e,n,r,i){var o=t-n,a=t+n,s=e-n,u=e+n;if(a<0||o>this.width||u<0||s>this.height)return!r&&[];var c=[];return this._forEachCell(o,s,a,u,this._queryCellCircle,c,{hitTest:r,circle:{x:t,y:e,radius:n},seenUids:{box:{},circle:{}}},i),r?c.length>0:c},Qt.prototype.query=function(t,e,n,r,i){return this._query(t,e,n,r,!1,i)},Qt.prototype.hitTest=function(t,e,n,r,i){return this._query(t,e,n,r,!0,i)},Qt.prototype.hitTestCircle=function(t,e,n,r){return this._queryCircle(t,e,n,!0,r)},Qt.prototype._queryCell=function(t,e,n,r,i,o,a,s){var u=a.seenUids,c=this.boxCells[i];if(null!==c)for(var l=this.bboxes,h=0,f=c;h<f.length;h+=1){var p=f[h];if(!u.box[p]){u.box[p]=!0;var d=4*p;if(t<=l[d+2]&&e<=l[d+3]&&n>=l[d+0]&&r>=l[d+1]&&(!s||s(this.boxKeys[p]))){if(a.hitTest)return o.push(!0),!0;o.push({key:this.boxKeys[p],x1:l[d],y1:l[d+1],x2:l[d+2],y2:l[d+3]})}}}var A=this.circleCells[i];if(null!==A)for(var g=this.circles,m=0,y=A;m<y.length;m+=1){var v=y[m];if(!u.circle[v]){u.circle[v]=!0;var _=3*v;if(this._circleAndRectCollide(g[_],g[_+1],g[_+2],t,e,n,r)&&(!s||s(this.circleKeys[v]))){if(a.hitTest)return o.push(!0),!0;var b=g[_],x=g[_+1],w=g[_+2];o.push({key:this.circleKeys[v],x1:b-w,y1:x-w,x2:b+w,y2:x+w})}}}},Qt.prototype._queryCellCircle=function(t,e,n,r,i,o,a,s){var u=a.circle,c=a.seenUids,l=this.boxCells[i];if(null!==l)for(var h=this.bboxes,f=0,p=l;f<p.length;f+=1){var d=p[f];if(!c.box[d]){c.box[d]=!0;var A=4*d;if(this._circleAndRectCollide(u.x,u.y,u.radius,h[A+0],h[A+1],h[A+2],h[A+3])&&(!s||s(this.boxKeys[d])))return o.push(!0),!0}}var g=this.circleCells[i];if(null!==g)for(var m=this.circles,y=0,v=g;y<v.length;y+=1){var _=v[y];if(!c.circle[_]){c.circle[_]=!0;var b=3*_;if(this._circlesCollide(m[b],m[b+1],m[b+2],u.x,u.y,u.radius)&&(!s||s(this.circleKeys[_])))return o.push(!0),!0}}},Qt.prototype._forEachCell=function(t,e,n,r,i,o,a,s){for(var u=this._convertToXCellCoord(t),c=this._convertToYCellCoord(e),l=this._convertToXCellCoord(n),h=this._convertToYCellCoord(r),f=u;f<=l;f++)for(var p=c;p<=h;p++)if(i.call(this,t,e,n,r,this.xCellCount*p+f,o,a,s))return},Qt.prototype._convertToXCellCoord=function(t){return Math.max(0,Math.min(this.xCellCount-1,Math.floor(t*this.xScale)))},Qt.prototype._convertToYCellCoord=function(t){return Math.max(0,Math.min(this.yCellCount-1,Math.floor(t*this.yScale)))},Qt.prototype._circlesCollide=function(t,e,n,r,i,o){var a=r-t,s=i-e,u=n+o;return u*u>a*a+s*s},Qt.prototype._circleAndRectCollide=function(t,e,n,r,i,o,a){var s=(o-r)/2,u=Math.abs(t-(r+s));if(u>s+n)return!1;var c=(a-i)/2,l=Math.abs(e-(i+c));if(l>c+n)return!1;if(u<=s||l<=c)return!0;var h=u-s,f=l-c;return h*h+f*f<=n*n};var ue=new Float32Array([-1/0,-1/0,0,-1/0,-1/0,0,-1/0,-1/0,0,-1/0,-1/0,0]);function ce(t,e){for(var n=0;n<t;n++){var r=e.length;e.resize(r+4),e.float32.set(ue,3*r)}}function le(t,e,n){var r=e[0],i=e[1];return t[0]=n[0]*r+n[4]*i+n[12],t[1]=n[1]*r+n[5]*i+n[13],t[3]=n[3]*r+n[7]*i+n[15],t}var he=function(t,e,n){void 0===e&&(e=new Qt(t.width+200,t.height+200,25)),void 0===n&&(n=new Qt(t.width+200,t.height+200,25)),this.transform=t,this.grid=e,this.ignoredGrid=n,this.pitchfactor=Math.cos(t._pitch)*t.cameraToCenterDistance,this.screenRightBoundary=t.width+100,this.screenBottomBoundary=t.height+100,this.gridRightBoundary=t.width+200,this.gridBottomBoundary=t.height+200};function fe(e,n,r){return n*(t.EXTENT/(e.tileSize*Math.pow(2,r-e.tileID.overscaledZ)))}he.prototype.placeCollisionBox=function(t,e,n,r,i){var o=this.projectAndGetPerspectiveRatio(r,t.anchorPointX,t.anchorPointY),a=n*o.perspectiveRatio,s=t.x1*a+o.point.x,u=t.y1*a+o.point.y,c=t.x2*a+o.point.x,l=t.y2*a+o.point.y;return!this.isInsideGrid(s,u,c,l)||!e&&this.grid.hitTest(s,u,c,l,i)?{box:[],offscreen:!1}:{box:[s,u,c,l],offscreen:this.isOffscreen(s,u,c,l)}},he.prototype.placeCollisionCircles=function(e,n,r,i,o,a,s,u,c,l,h,f,p){var d=[],A=new t.Point(n.anchorX,n.anchorY),g=$t(A,a),m=te(this.transform.cameraToCenterDistance,g.signedDistanceFromCamera),y=(l?o/m:o*m)/t.ONE_EM,v=$t(A,s).point,_=re(y,i,n.lineOffsetX*y,n.lineOffsetY*y,!1,v,A,n,r,s,{}),b=!1,x=!1,w=!0;if(_){for(var E=.5*f*m+p,O=new t.Point(-100,-100),S=new t.Point(this.screenRightBoundary,this.screenBottomBoundary),T=new Jt,C=_.first,P=_.last,M=[],I=C.path.length-1;I>=1;I--)M.push(C.path[I]);for(var B=1;B<P.path.length;B++)M.push(P.path[B]);var R=2.5*E;if(u){var k=M.map((function(t){return $t(t,u)}));M=k.some((function(t){return t.signedDistanceFromCamera<=0}))?[]:k.map((function(t){return t.point}))}var D=[];if(M.length>0){for(var L=M[0].clone(),j=M[0].clone(),F=1;F<M.length;F++)L.x=Math.min(L.x,M[F].x),L.y=Math.min(L.y,M[F].y),j.x=Math.max(j.x,M[F].x),j.y=Math.max(j.y,M[F].y);D=L.x>=O.x&&j.x<=S.x&&L.y>=O.y&&j.y<=S.y?[M]:j.x<O.x||L.x>S.x||j.y<O.y||L.y>S.y?[]:t.clipLine([M],O.x,O.y,S.x,S.y)}for(var z=0,U=D;z<U.length;z+=1){var N;T.reset(U[z],.25*E),N=T.length<=.5*E?1:Math.ceil(T.paddedLength/R)+1;for(var G=0;G<N;G++){var V=G/Math.max(N-1,1),H=T.lerp(V),W=H.x+100,q=H.y+100;d.push(W,q,E,0);var X=W-E,Z=q-E,J=W+E,Q=q+E;if(w=w&&this.isOffscreen(X,Z,J,Q),x=x||this.isInsideGrid(X,Z,J,Q),!e&&this.grid.hitTestCircle(W,q,E,h)&&(b=!0,!c))return{circles:[],offscreen:!1,collisionDetected:b}}}}return{circles:!c&&b||!x?[]:d,offscreen:w,collisionDetected:b}},he.prototype.queryRenderedSymbols=function(e){if(0===e.length||0===this.grid.keysLength()&&0===this.ignoredGrid.keysLength())return{};for(var n=[],r=1/0,i=1/0,o=-1/0,a=-1/0,s=0,u=e;s<u.length;s+=1){var c=u[s],l=new t.Point(c.x+100,c.y+100);r=Math.min(r,l.x),i=Math.min(i,l.y),o=Math.max(o,l.x),a=Math.max(a,l.y),n.push(l)}for(var h={},f={},p=0,d=this.grid.query(r,i,o,a).concat(this.ignoredGrid.query(r,i,o,a));p<d.length;p+=1){var A=d[p],g=A.key;if(void 0===h[g.bucketInstanceId]&&(h[g.bucketInstanceId]={}),!h[g.bucketInstanceId][g.featureIndex]){var m=[new t.Point(A.x1,A.y1),new t.Point(A.x2,A.y1),new t.Point(A.x2,A.y2),new t.Point(A.x1,A.y2)];t.polygonIntersectsPolygon(n,m)&&(h[g.bucketInstanceId][g.featureIndex]=!0,void 0===f[g.bucketInstanceId]&&(f[g.bucketInstanceId]=[]),f[g.bucketInstanceId].push(g.featureIndex))}}return f},he.prototype.insertCollisionBox=function(t,e,n,r,i){(e?this.ignoredGrid:this.grid).insert({bucketInstanceId:n,featureIndex:r,collisionGroupID:i},t[0],t[1],t[2],t[3])},he.prototype.insertCollisionCircles=function(t,e,n,r,i){for(var o=e?this.ignoredGrid:this.grid,a={bucketInstanceId:n,featureIndex:r,collisionGroupID:i},s=0;s<t.length;s+=4)o.insertCircle(a,t[s],t[s+1],t[s+2])},he.prototype.projectAndGetPerspectiveRatio=function(e,n,r){var i=[n,r,0,1];return le(i,i,e),{point:new t.Point((i[0]/i[3]+1)/2*this.transform.width+100,(-i[1]/i[3]+1)/2*this.transform.height+100),perspectiveRatio:.5+this.transform.cameraToCenterDistance/i[3]*.5}},he.prototype.isOffscreen=function(t,e,n,r){return n<100||t>=this.screenRightBoundary||r<100||e>this.screenBottomBoundary},he.prototype.isInsideGrid=function(t,e,n,r){return n>=0&&t<this.gridRightBoundary&&r>=0&&e<this.gridBottomBoundary},he.prototype.getViewportMatrix=function(){var e=t.identity([]);return t.translate(e,e,[-100,-100,0]),e};var pe=function(t,e,n,r){this.opacity=t?Math.max(0,Math.min(1,t.opacity+(t.placed?e:-e))):r&&n?1:0,this.placed=n};pe.prototype.isHidden=function(){return 0===this.opacity&&!this.placed};var de=function(t,e,n,r,i){this.text=new pe(t?t.text:null,e,n,i),this.icon=new pe(t?t.icon:null,e,r,i)};de.prototype.isHidden=function(){return this.text.isHidden()&&this.icon.isHidden()};var Ae=function(t,e,n){this.text=t,this.icon=e,this.skipFade=n},ge=function(){this.invProjMatrix=t.create(),this.viewportMatrix=t.create(),this.circles=[]},me=function(t,e,n,r,i){this.bucketInstanceId=t,this.featureIndex=e,this.sourceLayerIndex=n,this.bucketIndex=r,this.tileID=i},ye=function(t){this.crossSourceCollisions=t,this.maxGroupID=0,this.collisionGroups={}};function ve(e,n,r,i,o){var a=t.getAnchorAlignment(e),s=-(a.horizontalAlign-.5)*n,u=-(a.verticalAlign-.5)*r,c=t.evaluateVariableOffset(e,i);return new t.Point(s+c[0]*o,u+c[1]*o)}function _e(e,n,r,i,o,a){var s=e.x1,u=e.x2,c=e.y1,l=e.y2,h=e.anchorPointX,f=e.anchorPointY,p=new t.Point(n,r);return i&&p._rotate(o?a:-a),{x1:s+p.x,y1:c+p.y,x2:u+p.x,y2:l+p.y,anchorPointX:h,anchorPointY:f}}ye.prototype.get=function(t){if(this.crossSourceCollisions)return{ID:0,predicate:null};if(!this.collisionGroups[t]){var e=++this.maxGroupID;this.collisionGroups[t]={ID:e,predicate:function(t){return t.collisionGroupID===e}}}return this.collisionGroups[t]};var be=function(t,e,n,r){this.transform=t.clone(),this.collisionIndex=new he(this.transform),this.placements={},this.opacities={},this.variableOffsets={},this.stale=!1,this.commitTime=0,this.fadeDuration=e,this.retainedQueryData={},this.collisionGroups=new ye(n),this.collisionCircleArrays={},this.prevPlacement=r,r&&(r.prevPlacement=void 0),this.placedOrientations={}};function xe(t,e,n,r,i){t.emplaceBack(e?1:0,n?1:0,r||0,i||0),t.emplaceBack(e?1:0,n?1:0,r||0,i||0),t.emplaceBack(e?1:0,n?1:0,r||0,i||0),t.emplaceBack(e?1:0,n?1:0,r||0,i||0)}be.prototype.getBucketParts=function(e,n,r,i){var o=r.getBucket(n),a=r.latestFeatureIndex;if(o&&a&&n.id===o.layerIds[0]){var s=r.collisionBoxArray,u=o.layers[0].layout,c=Math.pow(2,this.transform.zoom-r.tileID.overscaledZ),l=r.tileSize/t.EXTENT,h=this.transform.calculatePosMatrix(r.tileID.toUnwrapped()),f="map"===u.get("text-pitch-alignment"),p="map"===u.get("text-rotation-alignment"),d=fe(r,1,this.transform.zoom),A=Kt(h,f,p,this.transform,d),g=null;if(f){var m=Yt(h,f,p,this.transform,d);g=t.multiply([],this.transform.labelPlaneMatrix,m)}this.retainedQueryData[o.bucketInstanceId]=new me(o.bucketInstanceId,a,o.sourceLayerIndex,o.index,r.tileID);var y={bucket:o,layout:u,posMatrix:h,textLabelPlaneMatrix:A,labelToScreenMatrix:g,scale:c,textPixelRatio:l,holdingForFade:r.holdingForFade(),collisionBoxArray:s,partiallyEvaluatedTextSize:t.evaluateSizeForZoom(o.textSizeData,this.transform.zoom),collisionGroup:this.collisionGroups.get(o.sourceID)};if(i)for(var v=0,_=o.sortKeyRanges;v<_.length;v+=1){var b=_[v];e.push({sortKey:b.sortKey,symbolInstanceStart:b.symbolInstanceStart,symbolInstanceEnd:b.symbolInstanceEnd,parameters:y})}else e.push({symbolInstanceStart:0,symbolInstanceEnd:o.symbolInstances.length,parameters:y})}},be.prototype.attemptAnchorPlacement=function(t,e,n,r,i,o,a,s,u,c,l,h,f,p,d){var A,g=[h.textOffset0,h.textOffset1],m=ve(t,n,r,g,i),y=this.collisionIndex.placeCollisionBox(_e(e,m.x,m.y,o,a,this.transform.angle),l,s,u,c.predicate);if(!d||0!==this.collisionIndex.placeCollisionBox(_e(d,m.x,m.y,o,a,this.transform.angle),l,s,u,c.predicate).box.length)return y.box.length>0?(this.prevPlacement&&this.prevPlacement.variableOffsets[h.crossTileID]&&this.prevPlacement.placements[h.crossTileID]&&this.prevPlacement.placements[h.crossTileID].text&&(A=this.prevPlacement.variableOffsets[h.crossTileID].anchor),this.variableOffsets[h.crossTileID]={textOffset:g,width:n,height:r,anchor:t,textBoxScale:i,prevAnchor:A},this.markUsedJustification(f,t,h,p),f.allowVerticalPlacement&&(this.markUsedOrientation(f,p,h),this.placedOrientations[h.crossTileID]=p),{shift:m,placedGlyphBoxes:y}):void 0},be.prototype.placeLayerBucketPart=function(e,n,r){var i=this,o=e.parameters,a=o.bucket,s=o.layout,u=o.posMatrix,c=o.textLabelPlaneMatrix,l=o.labelToScreenMatrix,h=o.textPixelRatio,f=o.holdingForFade,p=o.collisionBoxArray,d=o.partiallyEvaluatedTextSize,A=o.collisionGroup,g=s.get("text-optional"),m=s.get("icon-optional"),y=s.get("text-allow-overlap"),v=s.get("icon-allow-overlap"),_="map"===s.get("text-rotation-alignment"),b="map"===s.get("text-pitch-alignment"),x="none"!==s.get("icon-text-fit"),w="viewport-y"===s.get("symbol-z-order"),E=y&&(v||!a.hasIconData()||m),O=v&&(y||!a.hasTextData()||g);!a.collisionArrays&&p&&a.deserializeCollisionBoxes(p);var S=function(e,o){if(!n[e.crossTileID])if(f)i.placements[e.crossTileID]=new Ae(!1,!1,!1);else{var p,w=!1,S=!1,T=!0,C=null,P={box:null,offscreen:null},M={box:null,offscreen:null},I=null,B=null,R=0,k=0,D=0;o.textFeatureIndex?R=o.textFeatureIndex:e.useRuntimeCollisionCircles&&(R=e.featureIndex),o.verticalTextFeatureIndex&&(k=o.verticalTextFeatureIndex);var L=o.textBox;if(L){var j=function(n){var r=t.WritingMode.horizontal;if(a.allowVerticalPlacement&&!n&&i.prevPlacement){var o=i.prevPlacement.placedOrientations[e.crossTileID];o&&(i.placedOrientations[e.crossTileID]=o,i.markUsedOrientation(a,r=o,e))}return r},F=function(n,r){if(a.allowVerticalPlacement&&e.numVerticalGlyphVertices>0&&o.verticalTextBox)for(var i=0,s=a.writingModes;i<s.length&&(s[i]===t.WritingMode.vertical?(P=r(),M=P):P=n(),!(P&&P.box&&P.box.length));i+=1);else P=n()};if(s.get("text-variable-anchor")){var z=s.get("text-variable-anchor");if(i.prevPlacement&&i.prevPlacement.variableOffsets[e.crossTileID]){var U=i.prevPlacement.variableOffsets[e.crossTileID];z.indexOf(U.anchor)>0&&(z=z.filter((function(t){return t!==U.anchor}))).unshift(U.anchor)}var N=function(t,n,r){for(var o=t.x2-t.x1,s=t.y2-t.y1,c=e.textBoxScale,l=x&&!v?n:null,f={box:[],offscreen:!1},p=y?2*z.length:z.length,d=0;d<p;++d){var g=i.attemptAnchorPlacement(z[d%z.length],t,o,s,c,_,b,h,u,A,d>=z.length,e,a,r,l);if(g&&(f=g.placedGlyphBoxes)&&f.box&&f.box.length){w=!0,C=g.shift;break}}return f};F((function(){return N(L,o.iconBox,t.WritingMode.horizontal)}),(function(){var n=o.verticalTextBox;return a.allowVerticalPlacement&&!(P&&P.box&&P.box.length)&&e.numVerticalGlyphVertices>0&&n?N(n,o.verticalIconBox,t.WritingMode.vertical):{box:null,offscreen:null}})),P&&(w=P.box,T=P.offscreen);var G=j(P&&P.box);if(!w&&i.prevPlacement){var V=i.prevPlacement.variableOffsets[e.crossTileID];V&&(i.variableOffsets[e.crossTileID]=V,i.markUsedJustification(a,V.anchor,e,G))}}else{var H=function(t,n){var r=i.collisionIndex.placeCollisionBox(t,y,h,u,A.predicate);return r&&r.box&&r.box.length&&(i.markUsedOrientation(a,n,e),i.placedOrientations[e.crossTileID]=n),r};F((function(){return H(L,t.WritingMode.horizontal)}),(function(){var n=o.verticalTextBox;return a.allowVerticalPlacement&&e.numVerticalGlyphVertices>0&&n?H(n,t.WritingMode.vertical):{box:null,offscreen:null}})),j(P&&P.box&&P.box.length)}}if(w=(p=P)&&p.box&&p.box.length>0,T=p&&p.offscreen,e.useRuntimeCollisionCircles){var W=a.text.placedSymbolArray.get(e.centerJustifiedTextSymbolIndex),q=t.evaluateSizeForFeature(a.textSizeData,d,W),X=s.get("text-padding");I=i.collisionIndex.placeCollisionCircles(y,W,a.lineVertexArray,a.glyphOffsetArray,q,u,c,l,r,b,A.predicate,e.collisionCircleDiameter,X),w=y||I.circles.length>0&&!I.collisionDetected,T=T&&I.offscreen}if(o.iconFeatureIndex&&(D=o.iconFeatureIndex),o.iconBox){var Z=function(t){var e=x&&C?_e(t,C.x,C.y,_,b,i.transform.angle):t;return i.collisionIndex.placeCollisionBox(e,v,h,u,A.predicate)};S=M&&M.box&&M.box.length&&o.verticalIconBox?(B=Z(o.verticalIconBox)).box.length>0:(B=Z(o.iconBox)).box.length>0,T=T&&B.offscreen}var J=g||0===e.numHorizontalGlyphVertices&&0===e.numVerticalGlyphVertices,Q=m||0===e.numIconVertices;if(J||Q?Q?J||(S=S&&w):w=S&&w:S=w=S&&w,w&&p&&p.box&&i.collisionIndex.insertCollisionBox(p.box,s.get("text-ignore-placement"),a.bucketInstanceId,M&&M.box&&k?k:R,A.ID),S&&B&&i.collisionIndex.insertCollisionBox(B.box,s.get("icon-ignore-placement"),a.bucketInstanceId,D,A.ID),I&&(w&&i.collisionIndex.insertCollisionCircles(I.circles,s.get("text-ignore-placement"),a.bucketInstanceId,R,A.ID),r)){var K=a.bucketInstanceId,Y=i.collisionCircleArrays[K];void 0===Y&&(Y=i.collisionCircleArrays[K]=new ge);for(var $=0;$<I.circles.length;$+=4)Y.circles.push(I.circles[$+0]),Y.circles.push(I.circles[$+1]),Y.circles.push(I.circles[$+2]),Y.circles.push(I.collisionDetected?1:0)}i.placements[e.crossTileID]=new Ae(w||E,S||O,T||a.justReloaded),n[e.crossTileID]=!0}};if(w)for(var T=a.getSortedSymbolIndexes(this.transform.angle),C=T.length-1;C>=0;--C){var P=T[C];S(a.symbolInstances.get(P),a.collisionArrays[P])}else for(var M=e.symbolInstanceStart;M<e.symbolInstanceEnd;M++)S(a.symbolInstances.get(M),a.collisionArrays[M]);if(r&&a.bucketInstanceId in this.collisionCircleArrays){var I=this.collisionCircleArrays[a.bucketInstanceId];t.invert(I.invProjMatrix,u),I.viewportMatrix=this.collisionIndex.getViewportMatrix()}a.justReloaded=!1},be.prototype.markUsedJustification=function(e,n,r,i){var o;o=i===t.WritingMode.vertical?r.verticalPlacedTextSymbolIndex:{left:r.leftJustifiedTextSymbolIndex,center:r.centerJustifiedTextSymbolIndex,right:r.rightJustifiedTextSymbolIndex}[t.getAnchorJustification(n)];for(var a=0,s=[r.leftJustifiedTextSymbolIndex,r.centerJustifiedTextSymbolIndex,r.rightJustifiedTextSymbolIndex,r.verticalPlacedTextSymbolIndex];a<s.length;a+=1){var u=s[a];u>=0&&(e.text.placedSymbolArray.get(u).crossTileID=o>=0&&u!==o?0:r.crossTileID)}},be.prototype.markUsedOrientation=function(e,n,r){for(var i=n===t.WritingMode.horizontal||n===t.WritingMode.horizontalOnly?n:0,o=n===t.WritingMode.vertical?n:0,a=0,s=[r.leftJustifiedTextSymbolIndex,r.centerJustifiedTextSymbolIndex,r.rightJustifiedTextSymbolIndex];a<s.length;a+=1)e.text.placedSymbolArray.get(s[a]).placedOrientation=i;r.verticalPlacedTextSymbolIndex&&(e.text.placedSymbolArray.get(r.verticalPlacedTextSymbolIndex).placedOrientation=o)},be.prototype.commit=function(t){this.commitTime=t,this.zoomAtLastRecencyCheck=this.transform.zoom;var e=this.prevPlacement,n=!1;this.prevZoomAdjustment=e?e.zoomAdjustment(this.transform.zoom):0;var r=e?e.symbolFadeChange(t):1,i=e?e.opacities:{},o=e?e.variableOffsets:{},a=e?e.placedOrientations:{};for(var s in this.placements){var u=this.placements[s],c=i[s];c?(this.opacities[s]=new de(c,r,u.text,u.icon),n=n||u.text!==c.text.placed||u.icon!==c.icon.placed):(this.opacities[s]=new de(null,r,u.text,u.icon,u.skipFade),n=n||u.text||u.icon)}for(var l in i){var h=i[l];if(!this.opacities[l]){var f=new de(h,r,!1,!1);f.isHidden()||(this.opacities[l]=f,n=n||h.text.placed||h.icon.placed)}}for(var p in o)this.variableOffsets[p]||!this.opacities[p]||this.opacities[p].isHidden()||(this.variableOffsets[p]=o[p]);for(var d in a)this.placedOrientations[d]||!this.opacities[d]||this.opacities[d].isHidden()||(this.placedOrientations[d]=a[d]);n?this.lastPlacementChangeTime=t:"number"!=typeof this.lastPlacementChangeTime&&(this.lastPlacementChangeTime=e?e.lastPlacementChangeTime:t)},be.prototype.updateLayerOpacities=function(t,e){for(var n={},r=0,i=e;r<i.length;r+=1){var o=i[r],a=o.getBucket(t);a&&o.latestFeatureIndex&&t.id===a.layerIds[0]&&this.updateBucketOpacities(a,n,o.collisionBoxArray)}},be.prototype.updateBucketOpacities=function(e,n,r){var i=this;e.hasTextData()&&e.text.opacityVertexArray.clear(),e.hasIconData()&&e.icon.opacityVertexArray.clear(),e.hasIconCollisionBoxData()&&e.iconCollisionBox.collisionVertexArray.clear(),e.hasTextCollisionBoxData()&&e.textCollisionBox.collisionVertexArray.clear();var o=e.layers[0].layout,a=new de(null,0,!1,!1,!0),s=o.get("text-allow-overlap"),u=o.get("icon-allow-overlap"),c=o.get("text-variable-anchor"),l="map"===o.get("text-rotation-alignment"),h="map"===o.get("text-pitch-alignment"),f="none"!==o.get("icon-text-fit"),p=new de(null,0,s&&(u||!e.hasIconData()||o.get("icon-optional")),u&&(s||!e.hasTextData()||o.get("text-optional")),!0);!e.collisionArrays&&r&&(e.hasIconCollisionBoxData()||e.hasTextCollisionBoxData())&&e.deserializeCollisionBoxes(r);for(var d=function(t,e,n){for(var r=0;r<e/4;r++)t.opacityVertexArray.emplaceBack(n)},A=function(r){var o=e.symbolInstances.get(r),s=o.numHorizontalGlyphVertices,u=o.numVerticalGlyphVertices,A=o.crossTileID,g=i.opacities[A];n[A]?g=a:g||(i.opacities[A]=g=p),n[A]=!0;var m=o.numIconVertices>0,y=i.placedOrientations[o.crossTileID],v=y===t.WritingMode.vertical,_=y===t.WritingMode.horizontal||y===t.WritingMode.horizontalOnly;if(s>0||u>0){var b=Me(g.text);d(e.text,s,v?Ie:b),d(e.text,u,_?Ie:b);var x=g.text.isHidden();[o.rightJustifiedTextSymbolIndex,o.centerJustifiedTextSymbolIndex,o.leftJustifiedTextSymbolIndex].forEach((function(t){t>=0&&(e.text.placedSymbolArray.get(t).hidden=x||v?1:0)})),o.verticalPlacedTextSymbolIndex>=0&&(e.text.placedSymbolArray.get(o.verticalPlacedTextSymbolIndex).hidden=x||_?1:0);var w=i.variableOffsets[o.crossTileID];w&&i.markUsedJustification(e,w.anchor,o,y);var E=i.placedOrientations[o.crossTileID];E&&(i.markUsedJustification(e,"left",o,E),i.markUsedOrientation(e,E,o))}if(m){var O=Me(g.icon),S=!(f&&o.verticalPlacedIconSymbolIndex&&v);o.placedIconSymbolIndex>=0&&(d(e.icon,o.numIconVertices,S?O:Ie),e.icon.placedSymbolArray.get(o.placedIconSymbolIndex).hidden=g.icon.isHidden()),o.verticalPlacedIconSymbolIndex>=0&&(d(e.icon,o.numVerticalIconVertices,S?Ie:O),e.icon.placedSymbolArray.get(o.verticalPlacedIconSymbolIndex).hidden=g.icon.isHidden())}if(e.hasIconCollisionBoxData()||e.hasTextCollisionBoxData()){var T=e.collisionArrays[r];if(T){var C=new t.Point(0,0);if(T.textBox||T.verticalTextBox){var P=!0;if(c){var M=i.variableOffsets[A];M?(C=ve(M.anchor,M.width,M.height,M.textOffset,M.textBoxScale),l&&C._rotate(h?i.transform.angle:-i.transform.angle)):P=!1}T.textBox&&xe(e.textCollisionBox.collisionVertexArray,g.text.placed,!P||v,C.x,C.y),T.verticalTextBox&&xe(e.textCollisionBox.collisionVertexArray,g.text.placed,!P||_,C.x,C.y)}var I=Boolean(!_&&T.verticalIconBox);T.iconBox&&xe(e.iconCollisionBox.collisionVertexArray,g.icon.placed,I,f?C.x:0,f?C.y:0),T.verticalIconBox&&xe(e.iconCollisionBox.collisionVertexArray,g.icon.placed,!I,f?C.x:0,f?C.y:0)}}},g=0;g<e.symbolInstances.length;g++)A(g);if(e.sortFeatures(this.transform.angle),this.retainedQueryData[e.bucketInstanceId]&&(this.retainedQueryData[e.bucketInstanceId].featureSortOrder=e.featureSortOrder),e.hasTextData()&&e.text.opacityVertexBuffer&&e.text.opacityVertexBuffer.updateData(e.text.opacityVertexArray),e.hasIconData()&&e.icon.opacityVertexBuffer&&e.icon.opacityVertexBuffer.updateData(e.icon.opacityVertexArray),e.hasIconCollisionBoxData()&&e.iconCollisionBox.collisionVertexBuffer&&e.iconCollisionBox.collisionVertexBuffer.updateData(e.iconCollisionBox.collisionVertexArray),e.hasTextCollisionBoxData()&&e.textCollisionBox.collisionVertexBuffer&&e.textCollisionBox.collisionVertexBuffer.updateData(e.textCollisionBox.collisionVertexArray),e.bucketInstanceId in this.collisionCircleArrays){var m=this.collisionCircleArrays[e.bucketInstanceId];e.placementInvProjMatrix=m.invProjMatrix,e.placementViewportMatrix=m.viewportMatrix,e.collisionCircleArray=m.circles,delete this.collisionCircleArrays[e.bucketInstanceId]}},be.prototype.symbolFadeChange=function(t){return 0===this.fadeDuration?1:(t-this.commitTime)/this.fadeDuration+this.prevZoomAdjustment},be.prototype.zoomAdjustment=function(t){return Math.max(0,(this.transform.zoom-t)/1.5)},be.prototype.hasTransitions=function(t){return this.stale||t-this.lastPlacementChangeTime<this.fadeDuration},be.prototype.stillRecent=function(t,e){var n=this.zoomAtLastRecencyCheck===e?1-this.zoomAdjustment(e):1;return this.zoomAtLastRecencyCheck=e,this.commitTime+this.fadeDuration*n>t},be.prototype.setStale=function(){this.stale=!0};var we=Math.pow(2,25),Ee=Math.pow(2,24),Oe=Math.pow(2,17),Se=Math.pow(2,16),Te=Math.pow(2,9),Ce=Math.pow(2,8),Pe=Math.pow(2,1);function Me(t){if(0===t.opacity&&!t.placed)return 0;if(1===t.opacity&&t.placed)return 4294967295;var e=t.placed?1:0,n=Math.floor(127*t.opacity);return n*we+e*Ee+n*Oe+e*Se+n*Te+e*Ce+n*Pe+e}var Ie=0,Be=function(t){this._sortAcrossTiles="viewport-y"!==t.layout.get("symbol-z-order")&&void 0!==t.layout.get("symbol-sort-key").constantOr(1),this._currentTileIndex=0,this._currentPartIndex=0,this._seenCrossTileIDs={},this._bucketParts=[]};Be.prototype.continuePlacement=function(t,e,n,r,i){for(var o=this._bucketParts;this._currentTileIndex<t.length;)if(e.getBucketParts(o,r,t[this._currentTileIndex],this._sortAcrossTiles),this._currentTileIndex++,i())return!0;for(this._sortAcrossTiles&&(this._sortAcrossTiles=!1,o.sort((function(t,e){return t.sortKey-e.sortKey})));this._currentPartIndex<o.length;)if(e.placeLayerBucketPart(o[this._currentPartIndex],this._seenCrossTileIDs,n),this._currentPartIndex++,i())return!0;return!1};var Re=function(t,e,n,r,i,o,a){this.placement=new be(t,i,o,a),this._currentPlacementIndex=e.length-1,this._forceFullPlacement=n,this._showCollisionBoxes=r,this._done=!1};Re.prototype.isDone=function(){return this._done},Re.prototype.continuePlacement=function(e,n,r){for(var i=this,o=t.browser.now(),a=function(){var e=t.browser.now()-o;return!i._forceFullPlacement&&e>2};this._currentPlacementIndex>=0;){var s=n[e[this._currentPlacementIndex]],u=this.placement.collisionIndex.transform.zoom;if("symbol"===s.type&&(!s.minzoom||s.minzoom<=u)&&(!s.maxzoom||s.maxzoom>u)){if(this._inProgressLayer||(this._inProgressLayer=new Be(s)),this._inProgressLayer.continuePlacement(r[s.source],this.placement,this._showCollisionBoxes,s,a))return;delete this._inProgressLayer}this._currentPlacementIndex--}this._done=!0},Re.prototype.commit=function(t){return this.placement.commit(t),this.placement};var ke=512/t.EXTENT/2,De=function(t,e,n){this.tileID=t,this.indexedSymbolInstances={},this.bucketInstanceId=n;for(var r=0;r<e.length;r++){var i=e.get(r),o=i.key;this.indexedSymbolInstances[o]||(this.indexedSymbolInstances[o]=[]),this.indexedSymbolInstances[o].push({crossTileID:i.crossTileID,coord:this.getScaledCoordinates(i,t)})}};De.prototype.getScaledCoordinates=function(e,n){var r=ke/Math.pow(2,n.canonical.z-this.tileID.canonical.z);return{x:Math.floor((n.canonical.x*t.EXTENT+e.anchorX)*r),y:Math.floor((n.canonical.y*t.EXTENT+e.anchorY)*r)}},De.prototype.findMatches=function(t,e,n){for(var r=this.tileID.canonical.z<e.canonical.z?1:Math.pow(2,this.tileID.canonical.z-e.canonical.z),i=0;i<t.length;i++){var o=t.get(i);if(!o.crossTileID){var a=this.indexedSymbolInstances[o.key];if(a)for(var s=this.getScaledCoordinates(o,e),u=0,c=a;u<c.length;u+=1){var l=c[u];if(Math.abs(l.coord.x-s.x)<=r&&Math.abs(l.coord.y-s.y)<=r&&!n[l.crossTileID]){n[l.crossTileID]=!0,o.crossTileID=l.crossTileID;break}}}}};var Le=function(){this.maxCrossTileID=0};Le.prototype.generate=function(){return++this.maxCrossTileID};var je=function(){this.indexes={},this.usedCrossTileIDs={},this.lng=0};je.prototype.handleWrapJump=function(t){var e=Math.round((t-this.lng)/360);if(0!==e)for(var n in this.indexes){var r=this.indexes[n],i={};for(var o in r){var a=r[o];a.tileID=a.tileID.unwrapTo(a.tileID.wrap+e),i[a.tileID.key]=a}this.indexes[n]=i}this.lng=t},je.prototype.addBucket=function(t,e,n){if(this.indexes[t.overscaledZ]&&this.indexes[t.overscaledZ][t.key]){if(this.indexes[t.overscaledZ][t.key].bucketInstanceId===e.bucketInstanceId)return!1;this.removeBucketCrossTileIDs(t.overscaledZ,this.indexes[t.overscaledZ][t.key])}for(var r=0;r<e.symbolInstances.length;r++)e.symbolInstances.get(r).crossTileID=0;this.usedCrossTileIDs[t.overscaledZ]||(this.usedCrossTileIDs[t.overscaledZ]={});var i=this.usedCrossTileIDs[t.overscaledZ];for(var o in this.indexes){var a=this.indexes[o];if(Number(o)>t.overscaledZ)for(var s in a){var u=a[s];u.tileID.isChildOf(t)&&u.findMatches(e.symbolInstances,t,i)}else{var c=a[t.scaledTo(Number(o)).key];c&&c.findMatches(e.symbolInstances,t,i)}}for(var l=0;l<e.symbolInstances.length;l++){var h=e.symbolInstances.get(l);h.crossTileID||(h.crossTileID=n.generate(),i[h.crossTileID]=!0)}return void 0===this.indexes[t.overscaledZ]&&(this.indexes[t.overscaledZ]={}),this.indexes[t.overscaledZ][t.key]=new De(t,e.symbolInstances,e.bucketInstanceId),!0},je.prototype.removeBucketCrossTileIDs=function(t,e){for(var n in e.indexedSymbolInstances)for(var r=0,i=e.indexedSymbolInstances[n];r<i.length;r+=1)delete this.usedCrossTileIDs[t][i[r].crossTileID]},je.prototype.removeStaleBuckets=function(t){var e=!1;for(var n in this.indexes){var r=this.indexes[n];for(var i in r)t[r[i].bucketInstanceId]||(this.removeBucketCrossTileIDs(n,r[i]),delete r[i],e=!0)}return e};var Fe=function(){this.layerIndexes={},this.crossTileIDs=new Le,this.maxBucketInstanceId=0,this.bucketsInCurrentPlacement={}};Fe.prototype.addLayer=function(t,e,n){var r=this.layerIndexes[t.id];void 0===r&&(r=this.layerIndexes[t.id]=new je);var i=!1,o={};r.handleWrapJump(n);for(var a=0,s=e;a<s.length;a+=1){var u=s[a],c=u.getBucket(t);c&&t.id===c.layerIds[0]&&(c.bucketInstanceId||(c.bucketInstanceId=++this.maxBucketInstanceId),r.addBucket(u.tileID,c,this.crossTileIDs)&&(i=!0),o[c.bucketInstanceId]=!0)}return r.removeStaleBuckets(o)&&(i=!0),i},Fe.prototype.pruneUnusedLayers=function(t){var e={};for(var n in t.forEach((function(t){e[t]=!0})),this.layerIndexes)e[n]||delete this.layerIndexes[n]};var ze=function(e,n){return t.emitValidationErrors(e,n&&n.filter((function(t){return"source.canvas"!==t.identifier})))},Ue=t.pick(Nt,["addLayer","removeLayer","setPaintProperty","setLayoutProperty","setFilter","addSource","removeSource","setLayerZoomRange","setLight","setTransition","setGeoJSONSourceData"]),Ne=t.pick(Nt,["setCenter","setZoom","setBearing","setPitch"]),Ge=function(){var e={},n=t.styleSpec.$version;for(var r in t.styleSpec.$root){var i,o=t.styleSpec.$root[r];o.required&&null!=(i="version"===r?n:"array"===o.type?[]:{})&&(e[r]=i)}return e}(),Ve=function(e){function n(r,i){var o=this;void 0===i&&(i={}),e.call(this),this.map=r,this.dispatcher=new E(Ft(),this),this.imageManager=new f,this.imageManager.setEventedParent(this),this.glyphManager=new v(r._requestManager,i.localIdeographFontFamily),this.lineAtlas=new w(256,512),this.crossTileSymbolIndex=new Fe,this._layers={},this._serializedLayers={},this._order=[],this.sourceCaches={},this.zoomHistory=new t.ZoomHistory,this._loaded=!1,this._availableImages=[],this._resetUpdates(),this.dispatcher.broadcast("setReferrer",t.getReferrer());var a=this;this._rtlTextPluginCallback=n.registerForPluginStateChange((function(e){a.dispatcher.broadcast("syncRTLPluginState",{pluginStatus:e.pluginStatus,pluginURL:e.pluginURL},(function(e,n){if(t.triggerPluginCompletionEvent(e),n&&n.every((function(t){return t})))for(var r in a.sourceCaches)a.sourceCaches[r].reload()}))})),this.on("data",(function(t){if("source"===t.dataType&&"metadata"===t.sourceDataType){var e=o.sourceCaches[t.sourceId];if(e){var n=e.getSource();if(n&&n.vectorLayerIds)for(var r in o._layers){var i=o._layers[r];i.source===n.id&&o._validateLayer(i)}}}}))}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.loadURL=function(e,n){var r=this;void 0===n&&(n={}),this.fire(new t.Event("dataloading",{dataType:"style"}));var i="boolean"==typeof n.validate?n.validate:!t.isMapboxURL(e);e=this.map._requestManager.normalizeStyleURL(e,n.accessToken);var o=this.map._requestManager.transformRequest(e,t.ResourceType.Style);this._request=t.getJSON(o,(function(e,n){r._request=null,e?r.fire(new t.ErrorEvent(e)):n&&r._load(n,i)}))},n.prototype.loadJSON=function(e,n){var r=this;void 0===n&&(n={}),this.fire(new t.Event("dataloading",{dataType:"style"})),this._request=t.browser.frame((function(){r._request=null,r._load(e,!1!==n.validate)}))},n.prototype.loadEmpty=function(){this.fire(new t.Event("dataloading",{dataType:"style"})),this._load(Ge,!1)},n.prototype._load=function(e,n){if(!n||!ze(this,t.validateStyle(e))){for(var r in this._loaded=!0,this.stylesheet=e,e.sources)this.addSource(r,e.sources[r],{validate:!1});e.sprite?this._loadSprite(e.sprite):this.imageManager.setLoaded(!0),this.glyphManager.setURL(e.glyphs);var i=Ut(this.stylesheet.layers);this._order=i.map((function(t){return t.id})),this._layers={},this._serializedLayers={};for(var o=0,a=i;o<a.length;o+=1){var s=a[o];(s=t.createStyleLayer(s)).setEventedParent(this,{layer:{id:s.id}}),this._layers[s.id]=s,this._serializedLayers[s.id]=s.serialize()}this.dispatcher.broadcast("setLayers",this._serializeLayers(this._order)),this.light=new x(this.stylesheet.light),this.fire(new t.Event("data",{dataType:"style"})),this.fire(new t.Event("style.load"))}},n.prototype._loadSprite=function(e){var n=this;this._spriteRequest=function(e,n,r){var i,o,a,s=t.browser.devicePixelRatio>1?"@2x":"",u=t.getJSON(n.transformRequest(n.normalizeSpriteURL(e,s,".json"),t.ResourceType.SpriteJSON),(function(t,e){u=null,a||(a=t,i=e,l())})),c=t.getImage(n.transformRequest(n.normalizeSpriteURL(e,s,".png"),t.ResourceType.SpriteImage),(function(t,e){c=null,a||(a=t,o=e,l())}));function l(){if(a)r(a);else if(i&&o){var e=t.browser.getImageData(o),n={};for(var s in i){var u=i[s],c=u.width,l=u.height,h=u.x,f=u.y,p=u.sdf,d=u.pixelRatio,A=u.stretchX,g=u.stretchY,m=u.content,y=new t.RGBAImage({width:c,height:l});t.RGBAImage.copy(e,y,{x:h,y:f},{x:0,y:0},{width:c,height:l}),n[s]={data:y,pixelRatio:d,sdf:p,stretchX:A,stretchY:g,content:m}}r(null,n)}}return{cancel:function(){u&&(u.cancel(),u=null),c&&(c.cancel(),c=null)}}}(e,this.map._requestManager,(function(e,r){if(n._spriteRequest=null,e)n.fire(new t.ErrorEvent(e));else if(r)for(var i in r)n.imageManager.addImage(i,r[i]);n.imageManager.setLoaded(!0),n._availableImages=n.imageManager.listImages(),n.dispatcher.broadcast("setImages",n._availableImages),n.fire(new t.Event("data",{dataType:"style"}))}))},n.prototype._validateLayer=function(e){var n=this.sourceCaches[e.source];if(n){var r=e.sourceLayer;if(r){var i=n.getSource();("geojson"===i.type||i.vectorLayerIds&&-1===i.vectorLayerIds.indexOf(r))&&this.fire(new t.ErrorEvent(new Error('Source layer "'+r+'" does not exist on source "'+i.id+'" as specified by style layer "'+e.id+'"')))}}},n.prototype.loaded=function(){if(!this._loaded)return!1;if(Object.keys(this._updatedSources).length)return!1;for(var t in this.sourceCaches)if(!this.sourceCaches[t].loaded())return!1;return!!this.imageManager.isLoaded()},n.prototype._serializeLayers=function(t){for(var e=[],n=0,r=t;n<r.length;n+=1){var i=this._layers[r[n]];"custom"!==i.type&&e.push(i.serialize())}return e},n.prototype.hasTransitions=function(){if(this.light&&this.light.hasTransition())return!0;for(var t in this.sourceCaches)if(this.sourceCaches[t].hasTransition())return!0;for(var e in this._layers)if(this._layers[e].hasTransition())return!0;return!1},n.prototype._checkLoaded=function(){if(!this._loaded)throw new Error("Style is not done loading")},n.prototype.update=function(e){if(this._loaded){var n=this._changed;if(this._changed){var r=Object.keys(this._updatedLayers),i=Object.keys(this._removedLayers);for(var o in(r.length||i.length)&&this._updateWorkerLayers(r,i),this._updatedSources){var a=this._updatedSources[o];"reload"===a?this._reloadSource(o):"clear"===a&&this._clearSource(o)}for(var s in this._updateTilesForChangedImages(),this._updatedPaintProps)this._layers[s].updateTransitions(e);this.light.updateTransitions(e),this._resetUpdates()}var u={};for(var c in this.sourceCaches){var l=this.sourceCaches[c];u[c]=l.used,l.used=!1}for(var h=0,f=this._order;h<f.length;h+=1){var p=this._layers[f[h]];p.recalculate(e,this._availableImages),!p.isHidden(e.zoom)&&p.source&&(this.sourceCaches[p.source].used=!0)}for(var d in u){var A=this.sourceCaches[d];u[d]!==A.used&&A.fire(new t.Event("data",{sourceDataType:"visibility",dataType:"source",sourceId:d}))}this.light.recalculate(e),this.z=e.zoom,n&&this.fire(new t.Event("data",{dataType:"style"}))}},n.prototype._updateTilesForChangedImages=function(){var t=Object.keys(this._changedImages);if(t.length){for(var e in this.sourceCaches)this.sourceCaches[e].reloadTilesForDependencies(["icons","patterns"],t);this._changedImages={}}},n.prototype._updateWorkerLayers=function(t,e){this.dispatcher.broadcast("updateLayers",{layers:this._serializeLayers(t),removedIds:e})},n.prototype._resetUpdates=function(){this._changed=!1,this._updatedLayers={},this._removedLayers={},this._updatedSources={},this._updatedPaintProps={},this._changedImages={}},n.prototype.setState=function(e){var n=this;if(this._checkLoaded(),ze(this,t.validateStyle(e)))return!1;(e=t.clone$1(e)).layers=Ut(e.layers);var r=function(e,n){if(!e)return[{command:Nt.setStyle,args:[n]}];var r=[];try{if(!t.deepEqual(e.version,n.version))return[{command:Nt.setStyle,args:[n]}];t.deepEqual(e.center,n.center)||r.push({command:Nt.setCenter,args:[n.center]}),t.deepEqual(e.zoom,n.zoom)||r.push({command:Nt.setZoom,args:[n.zoom]}),t.deepEqual(e.bearing,n.bearing)||r.push({command:Nt.setBearing,args:[n.bearing]}),t.deepEqual(e.pitch,n.pitch)||r.push({command:Nt.setPitch,args:[n.pitch]}),t.deepEqual(e.sprite,n.sprite)||r.push({command:Nt.setSprite,args:[n.sprite]}),t.deepEqual(e.glyphs,n.glyphs)||r.push({command:Nt.setGlyphs,args:[n.glyphs]}),t.deepEqual(e.transition,n.transition)||r.push({command:Nt.setTransition,args:[n.transition]}),t.deepEqual(e.light,n.light)||r.push({command:Nt.setLight,args:[n.light]});var i={},o=[];!function(e,n,r,i){var o;for(o in n=n||{},e=e||{})e.hasOwnProperty(o)&&(n.hasOwnProperty(o)||Vt(o,r,i));for(o in n)n.hasOwnProperty(o)&&(e.hasOwnProperty(o)?t.deepEqual(e[o],n[o])||("geojson"===e[o].type&&"geojson"===n[o].type&&Wt(e,n,o)?r.push({command:Nt.setGeoJSONSourceData,args:[o,n[o].data]}):Ht(o,n,r,i)):Gt(o,n,r))}(e.sources,n.sources,o,i);var a=[];e.layers&&e.layers.forEach((function(t){i[t.source]?r.push({command:Nt.removeLayer,args:[t.id]}):a.push(t)})),r=r.concat(o),function(e,n,r){n=n||[];var i,o,a,s,u,c,l,h=(e=e||[]).map(Xt),f=n.map(Xt),p=e.reduce(Zt,{}),d=n.reduce(Zt,{}),A=h.slice(),g=Object.create(null);for(i=0,o=0;i<h.length;i++)d.hasOwnProperty(a=h[i])?o++:(r.push({command:Nt.removeLayer,args:[a]}),A.splice(A.indexOf(a,o),1));for(i=0,o=0;i<f.length;i++)A[A.length-1-i]!==(a=f[f.length-1-i])&&(p.hasOwnProperty(a)?(r.push({command:Nt.removeLayer,args:[a]}),A.splice(A.lastIndexOf(a,A.length-o),1)):o++,r.push({command:Nt.addLayer,args:[d[a],c=A[A.length-i]]}),A.splice(A.length-i,0,a),g[a]=!0);for(i=0;i<f.length;i++)if(s=p[a=f[i]],u=d[a],!g[a]&&!t.deepEqual(s,u))if(t.deepEqual(s.source,u.source)&&t.deepEqual(s["source-layer"],u["source-layer"])&&t.deepEqual(s.type,u.type)){for(l in qt(s.layout,u.layout,r,a,null,Nt.setLayoutProperty),qt(s.paint,u.paint,r,a,null,Nt.setPaintProperty),t.deepEqual(s.filter,u.filter)||r.push({command:Nt.setFilter,args:[a,u.filter]}),t.deepEqual(s.minzoom,u.minzoom)&&t.deepEqual(s.maxzoom,u.maxzoom)||r.push({command:Nt.setLayerZoomRange,args:[a,u.minzoom,u.maxzoom]}),s)s.hasOwnProperty(l)&&"layout"!==l&&"paint"!==l&&"filter"!==l&&"metadata"!==l&&"minzoom"!==l&&"maxzoom"!==l&&(0===l.indexOf("paint.")?qt(s[l],u[l],r,a,l.slice(6),Nt.setPaintProperty):t.deepEqual(s[l],u[l])||r.push({command:Nt.setLayerProperty,args:[a,l,u[l]]}));for(l in u)u.hasOwnProperty(l)&&!s.hasOwnProperty(l)&&"layout"!==l&&"paint"!==l&&"filter"!==l&&"metadata"!==l&&"minzoom"!==l&&"maxzoom"!==l&&(0===l.indexOf("paint.")?qt(s[l],u[l],r,a,l.slice(6),Nt.setPaintProperty):t.deepEqual(s[l],u[l])||r.push({command:Nt.setLayerProperty,args:[a,l,u[l]]}))}else r.push({command:Nt.removeLayer,args:[a]}),c=A[A.lastIndexOf(a)+1],r.push({command:Nt.addLayer,args:[u,c]})}(a,n.layers,r)}catch(t){console.warn("Unable to compute style diff:",t),r=[{command:Nt.setStyle,args:[n]}]}return r}(this.serialize(),e).filter((function(t){return!(t.command in Ne)}));if(0===r.length)return!1;var i=r.filter((function(t){return!(t.command in Ue)}));if(i.length>0)throw new Error("Unimplemented: "+i.map((function(t){return t.command})).join(", ")+".");return r.forEach((function(t){"setTransition"!==t.command&&n[t.command].apply(n,t.args)})),this.stylesheet=e,!0},n.prototype.addImage=function(e,n){if(this.getImage(e))return this.fire(new t.ErrorEvent(new Error("An image with this name already exists.")));this.imageManager.addImage(e,n),this._afterImageUpdated(e)},n.prototype.updateImage=function(t,e){this.imageManager.updateImage(t,e)},n.prototype.getImage=function(t){return this.imageManager.getImage(t)},n.prototype.removeImage=function(e){if(!this.getImage(e))return this.fire(new t.ErrorEvent(new Error("No image with this name exists.")));this.imageManager.removeImage(e),this._afterImageUpdated(e)},n.prototype._afterImageUpdated=function(e){this._availableImages=this.imageManager.listImages(),this._changedImages[e]=!0,this._changed=!0,this.dispatcher.broadcast("setImages",this._availableImages),this.fire(new t.Event("data",{dataType:"style"}))},n.prototype.listImages=function(){return this._checkLoaded(),this.imageManager.listImages()},n.prototype.addSource=function(e,n,r){var i=this;if(void 0===r&&(r={}),this._checkLoaded(),void 0!==this.sourceCaches[e])throw new Error("There is already a source with this ID");if(!n.type)throw new Error("The type property must be defined, but only the following properties were given: "+Object.keys(n).join(", ")+".");if(!(["vector","raster","geojson","video","image"].indexOf(n.type)>=0&&this._validate(t.validateStyle.source,"sources."+e,n,null,r))){this.map&&this.map._collectResourceTiming&&(n.collectResourceTiming=!0);var o=this.sourceCaches[e]=new Mt(e,n,this.dispatcher);o.style=this,o.setEventedParent(this,(function(){return{isSourceLoaded:i.loaded(),source:o.serialize(),sourceId:e}})),o.onAdd(this.map),this._changed=!0}},n.prototype.removeSource=function(e){if(this._checkLoaded(),void 0===this.sourceCaches[e])throw new Error("There is no source with this ID");for(var n in this._layers)if(this._layers[n].source===e)return this.fire(new t.ErrorEvent(new Error('Source "'+e+'" cannot be removed while layer "'+n+'" is using it.')));var r=this.sourceCaches[e];delete this.sourceCaches[e],delete this._updatedSources[e],r.fire(new t.Event("data",{sourceDataType:"metadata",dataType:"source",sourceId:e})),r.setEventedParent(null),r.clearTiles(),r.onRemove&&r.onRemove(this.map),this._changed=!0},n.prototype.setGeoJSONSourceData=function(t,e){this._checkLoaded(),this.sourceCaches[t].getSource().setData(e),this._changed=!0},n.prototype.getSource=function(t){return this.sourceCaches[t]&&this.sourceCaches[t].getSource()},n.prototype.addLayer=function(e,n,r){void 0===r&&(r={}),this._checkLoaded();var i=e.id;if(this.getLayer(i))this.fire(new t.ErrorEvent(new Error('Layer with id "'+i+'" already exists on this map')));else{var o;if("custom"===e.type){if(ze(this,t.validateCustomStyleLayer(e)))return;o=t.createStyleLayer(e)}else{if("object"==typeof e.source&&(this.addSource(i,e.source),e=t.clone$1(e),e=t.extend(e,{source:i})),this._validate(t.validateStyle.layer,"layers."+i,e,{arrayIndex:-1},r))return;o=t.createStyleLayer(e),this._validateLayer(o),o.setEventedParent(this,{layer:{id:i}}),this._serializedLayers[o.id]=o.serialize()}var a=n?this._order.indexOf(n):this._order.length;if(n&&-1===a)this.fire(new t.ErrorEvent(new Error('Layer with id "'+n+'" does not exist on this map.')));else{if(this._order.splice(a,0,i),this._layerOrderChanged=!0,this._layers[i]=o,this._removedLayers[i]&&o.source&&"custom"!==o.type){var s=this._removedLayers[i];delete this._removedLayers[i],s.type!==o.type?this._updatedSources[o.source]="clear":(this._updatedSources[o.source]="reload",this.sourceCaches[o.source].pause())}this._updateLayer(o),o.onAdd&&o.onAdd(this.map)}}},n.prototype.moveLayer=function(e,n){if(this._checkLoaded(),this._changed=!0,this._layers[e]){if(e!==n){var r=this._order.indexOf(e);this._order.splice(r,1);var i=n?this._order.indexOf(n):this._order.length;n&&-1===i?this.fire(new t.ErrorEvent(new Error('Layer with id "'+n+'" does not exist on this map.'))):(this._order.splice(i,0,e),this._layerOrderChanged=!0)}}else this.fire(new t.ErrorEvent(new Error("The layer '"+e+"' does not exist in the map's style and cannot be moved.")))},n.prototype.removeLayer=function(e){this._checkLoaded();var n=this._layers[e];if(n){n.setEventedParent(null);var r=this._order.indexOf(e);this._order.splice(r,1),this._layerOrderChanged=!0,this._changed=!0,this._removedLayers[e]=n,delete this._layers[e],delete this._serializedLayers[e],delete this._updatedLayers[e],delete this._updatedPaintProps[e],n.onRemove&&n.onRemove(this.map)}else this.fire(new t.ErrorEvent(new Error("The layer '"+e+"' does not exist in the map's style and cannot be removed.")))},n.prototype.getLayer=function(t){return this._layers[t]},n.prototype.hasLayer=function(t){return t in this._layers},n.prototype.setLayerZoomRange=function(e,n,r){this._checkLoaded();var i=this.getLayer(e);i?i.minzoom===n&&i.maxzoom===r||(null!=n&&(i.minzoom=n),null!=r&&(i.maxzoom=r),this._updateLayer(i)):this.fire(new t.ErrorEvent(new Error("The layer '"+e+"' does not exist in the map's style and cannot have zoom extent.")))},n.prototype.setFilter=function(e,n,r){void 0===r&&(r={}),this._checkLoaded();var i=this.getLayer(e);if(i){if(!t.deepEqual(i.filter,n))return null==n?(i.filter=void 0,void this._updateLayer(i)):void(this._validate(t.validateStyle.filter,"layers."+i.id+".filter",n,null,r)||(i.filter=t.clone$1(n),this._updateLayer(i)))}else this.fire(new t.ErrorEvent(new Error("The layer '"+e+"' does not exist in the map's style and cannot be filtered.")))},n.prototype.getFilter=function(e){return t.clone$1(this.getLayer(e).filter)},n.prototype.setLayoutProperty=function(e,n,r,i){void 0===i&&(i={}),this._checkLoaded();var o=this.getLayer(e);o?t.deepEqual(o.getLayoutProperty(n),r)||(o.setLayoutProperty(n,r,i),this._updateLayer(o)):this.fire(new t.ErrorEvent(new Error("The layer '"+e+"' does not exist in the map's style and cannot be styled.")))},n.prototype.getLayoutProperty=function(e,n){var r=this.getLayer(e);if(r)return r.getLayoutProperty(n);this.fire(new t.ErrorEvent(new Error("The layer '"+e+"' does not exist in the map's style.")))},n.prototype.setPaintProperty=function(e,n,r,i){void 0===i&&(i={}),this._checkLoaded();var o=this.getLayer(e);o?t.deepEqual(o.getPaintProperty(n),r)||(o.setPaintProperty(n,r,i)&&this._updateLayer(o),this._changed=!0,this._updatedPaintProps[e]=!0):this.fire(new t.ErrorEvent(new Error("The layer '"+e+"' does not exist in the map's style and cannot be styled.")))},n.prototype.getPaintProperty=function(t,e){return this.getLayer(t).getPaintProperty(e)},n.prototype.setFeatureState=function(e,n){this._checkLoaded();var r=e.source,i=e.sourceLayer,o=this.sourceCaches[r];if(void 0!==o){var a=o.getSource().type;"geojson"===a&&i?this.fire(new t.ErrorEvent(new Error("GeoJSON sources cannot have a sourceLayer parameter."))):"vector"!==a||i?(void 0===e.id&&this.fire(new t.ErrorEvent(new Error("The feature id parameter must be provided."))),o.setFeatureState(i,e.id,n)):this.fire(new t.ErrorEvent(new Error("The sourceLayer parameter must be provided for vector source types.")))}else this.fire(new t.ErrorEvent(new Error("The source '"+r+"' does not exist in the map's style.")))},n.prototype.removeFeatureState=function(e,n){this._checkLoaded();var r=e.source,i=this.sourceCaches[r];if(void 0!==i){var o=i.getSource().type,a="vector"===o?e.sourceLayer:void 0;"vector"!==o||a?n&&"string"!=typeof e.id&&"number"!=typeof e.id?this.fire(new t.ErrorEvent(new Error("A feature id is required to remove its specific state property."))):i.removeFeatureState(a,e.id,n):this.fire(new t.ErrorEvent(new Error("The sourceLayer parameter must be provided for vector source types.")))}else this.fire(new t.ErrorEvent(new Error("The source '"+r+"' does not exist in the map's style.")))},n.prototype.getFeatureState=function(e){this._checkLoaded();var n=e.source,r=e.sourceLayer,i=this.sourceCaches[n];if(void 0!==i){if("vector"!==i.getSource().type||r)return void 0===e.id&&this.fire(new t.ErrorEvent(new Error("The feature id parameter must be provided."))),i.getFeatureState(r,e.id);this.fire(new t.ErrorEvent(new Error("The sourceLayer parameter must be provided for vector source types.")))}else this.fire(new t.ErrorEvent(new Error("The source '"+n+"' does not exist in the map's style.")))},n.prototype.getTransition=function(){return t.extend({duration:300,delay:0},this.stylesheet&&this.stylesheet.transition)},n.prototype.serialize=function(){return t.filterObject({version:this.stylesheet.version,name:this.stylesheet.name,metadata:this.stylesheet.metadata,light:this.stylesheet.light,center:this.stylesheet.center,zoom:this.stylesheet.zoom,bearing:this.stylesheet.bearing,pitch:this.stylesheet.pitch,sprite:this.stylesheet.sprite,glyphs:this.stylesheet.glyphs,transition:this.stylesheet.transition,sources:t.mapObject(this.sourceCaches,(function(t){return t.serialize()})),layers:this._serializeLayers(this._order)},(function(t){return void 0!==t}))},n.prototype._updateLayer=function(t){this._updatedLayers[t.id]=!0,t.source&&!this._updatedSources[t.source]&&"raster"!==this.sourceCaches[t.source].getSource().type&&(this._updatedSources[t.source]="reload",this.sourceCaches[t.source].pause()),this._changed=!0},n.prototype._flattenAndSortRenderedFeatures=function(t){for(var e=this,n=function(t){return"fill-extrusion"===e._layers[t].type},r={},i=[],o=this._order.length-1;o>=0;o--){var a=this._order[o];if(n(a)){r[a]=o;for(var s=0,u=t;s<u.length;s+=1){var c=u[s][a];if(c)for(var l=0,h=c;l<h.length;l+=1)i.push(h[l])}}}i.sort((function(t,e){return e.intersectionZ-t.intersectionZ}));for(var f=[],p=this._order.length-1;p>=0;p--){var d=this._order[p];if(n(d))for(var A=i.length-1;A>=0;A--){var g=i[A].feature;if(r[g.layer.id]<p)break;f.push(g),i.pop()}else for(var m=0,y=t;m<y.length;m+=1){var v=y[m][d];if(v)for(var _=0,b=v;_<b.length;_+=1)f.push(b[_].feature)}}return f},n.prototype.queryRenderedFeatures=function(e,n,r){n&&n.filter&&this._validate(t.validateStyle.filter,"queryRenderedFeatures.filter",n.filter,null,n);var i={};if(n&&n.layers){if(!Array.isArray(n.layers))return this.fire(new t.ErrorEvent(new Error("parameters.layers must be an Array."))),[];for(var o=0,a=n.layers;o<a.length;o+=1){var s=a[o],u=this._layers[s];if(!u)return this.fire(new t.ErrorEvent(new Error("The layer '"+s+"' does not exist in the map's style and cannot be queried for features."))),[];i[u.source]=!0}}var c=[];for(var l in n.availableImages=this._availableImages,this.sourceCaches)n.layers&&!i[l]||c.push(j(this.sourceCaches[l],this._layers,this._serializedLayers,e,n,r));return this.placement&&c.push(function(t,e,n,r,i,o,a){for(var s={},u=o.queryRenderedSymbols(r),c=[],l=0,h=Object.keys(u).map(Number);l<h.length;l+=1)c.push(a[h[l]]);c.sort(F);for(var f=function(){var n=d[p],r=n.featureIndex.lookupSymbolFeatures(u[n.bucketInstanceId],e,n.bucketIndex,n.sourceLayerIndex,i.filter,i.layers,i.availableImages,t);for(var o in r){var a=s[o]=s[o]||[],c=r[o];c.sort((function(t,e){var r=n.featureSortOrder;if(r){var i=r.indexOf(t.featureIndex);return r.indexOf(e.featureIndex)-i}return e.featureIndex-t.featureIndex}));for(var l=0,h=c;l<h.length;l+=1)a.push(h[l])}},p=0,d=c;p<d.length;p+=1)f();var A=function(e){s[e].forEach((function(r){var i=r.feature,o=n[t[e].source].getFeatureState(i.layer["source-layer"],i.id);i.source=i.layer.source,i.layer["source-layer"]&&(i.sourceLayer=i.layer["source-layer"]),i.state=o}))};for(var g in s)A(g);return s}(this._layers,this._serializedLayers,this.sourceCaches,e,n,this.placement.collisionIndex,this.placement.retainedQueryData)),this._flattenAndSortRenderedFeatures(c)},n.prototype.querySourceFeatures=function(e,n){n&&n.filter&&this._validate(t.validateStyle.filter,"querySourceFeatures.filter",n.filter,null,n);var r=this.sourceCaches[e];return r?function(t,e){for(var n=t.getRenderableIds().map((function(e){return t.getTileByID(e)})),r=[],i={},o=0;o<n.length;o++){var a=n[o],s=a.tileID.canonical.key;i[s]||(i[s]=!0,a.querySourceFeatures(r,e))}return r}(r,n):[]},n.prototype.addSourceType=function(t,e,r){return n.getSourceType(t)?r(new Error('A source type called "'+t+'" already exists.')):(n.setSourceType(t,e),e.workerSourceURL?void this.dispatcher.broadcast("loadWorkerSource",{name:t,url:e.workerSourceURL},r):r(null,null))},n.prototype.getLight=function(){return this.light.getLight()},n.prototype.setLight=function(e,n){void 0===n&&(n={}),this._checkLoaded();var r=this.light.getLight(),i=!1;for(var o in e)if(!t.deepEqual(e[o],r[o])){i=!0;break}if(i){var a={now:t.browser.now(),transition:t.extend({duration:300,delay:0},this.stylesheet.transition)};this.light.setLight(e,n),this.light.updateTransitions(a)}},n.prototype._validate=function(e,n,r,i,o){return void 0===o&&(o={}),(!o||!1!==o.validate)&&ze(this,e.call(t.validateStyle,t.extend({key:n,style:this.serialize(),value:r,styleSpec:t.styleSpec},i)))},n.prototype._remove=function(){for(var e in this._request&&(this._request.cancel(),this._request=null),this._spriteRequest&&(this._spriteRequest.cancel(),this._spriteRequest=null),t.evented.off("pluginStateChange",this._rtlTextPluginCallback),this._layers)this._layers[e].setEventedParent(null);for(var n in this.sourceCaches)this.sourceCaches[n].clearTiles(),this.sourceCaches[n].setEventedParent(null);this.imageManager.setEventedParent(null),this.setEventedParent(null),this.dispatcher.remove()},n.prototype._clearSource=function(t){this.sourceCaches[t].clearTiles()},n.prototype._reloadSource=function(t){this.sourceCaches[t].resume(),this.sourceCaches[t].reload()},n.prototype._updateSources=function(t){for(var e in this.sourceCaches)this.sourceCaches[e].update(t)},n.prototype._generateCollisionBoxes=function(){for(var t in this.sourceCaches)this._reloadSource(t)},n.prototype._updatePlacement=function(e,n,r,i,o){void 0===o&&(o=!1);for(var a=!1,s=!1,u={},c=0,l=this._order;c<l.length;c+=1){var h=this._layers[l[c]];if("symbol"===h.type){if(!u[h.source]){var f=this.sourceCaches[h.source];u[h.source]=f.getRenderableIds(!0).map((function(t){return f.getTileByID(t)})).sort((function(t,e){return e.tileID.overscaledZ-t.tileID.overscaledZ||(t.tileID.isLessThan(e.tileID)?-1:1)}))}var p=this.crossTileSymbolIndex.addLayer(h,u[h.source],e.center.lng);a=a||p}}if(this.crossTileSymbolIndex.pruneUnusedLayers(this._order),((o=o||this._layerOrderChanged||0===r)||!this.pauseablePlacement||this.pauseablePlacement.isDone()&&!this.placement.stillRecent(t.browser.now(),e.zoom))&&(this.pauseablePlacement=new Re(e,this._order,o,n,r,i,this.placement),this._layerOrderChanged=!1),this.pauseablePlacement.isDone()?this.placement.setStale():(this.pauseablePlacement.continuePlacement(this._order,this._layers,u),this.pauseablePlacement.isDone()&&(this.placement=this.pauseablePlacement.commit(t.browser.now()),s=!0),a&&this.pauseablePlacement.placement.setStale()),s||a)for(var d=0,A=this._order;d<A.length;d+=1){var g=this._layers[A[d]];"symbol"===g.type&&this.placement.updateLayerOpacities(g,u[g.source])}return!this.pauseablePlacement.isDone()||this.placement.hasTransitions(t.browser.now())},n.prototype._releaseSymbolFadeTiles=function(){for(var t in this.sourceCaches)this.sourceCaches[t].releaseSymbolFadeTiles()},n.prototype.getImages=function(t,e,n){this.imageManager.getImages(e.icons,n),this._updateTilesForChangedImages();var r=this.sourceCaches[e.source];r&&r.setDependencies(e.tileID.key,e.type,e.icons)},n.prototype.getGlyphs=function(t,e,n){this.glyphManager.getGlyphs(e.stacks,n)},n.prototype.getResource=function(e,n,r){return t.makeRequest(n,r)},n}(t.Evented);Ve.getSourceType=function(t){return D[t]},Ve.setSourceType=function(t,e){D[t]=e},Ve.registerForPluginStateChange=t.registerForPluginStateChange;var He=t.createLayout([{name:"a_pos",type:"Int16",components:2}]),We=yn("#ifdef GL_ES\nprecision mediump float;\n#else\n#if !defined(lowp)\n#define lowp\n#endif\n#if !defined(mediump)\n#define mediump\n#endif\n#if !defined(highp)\n#define highp\n#endif\n#endif","#ifdef GL_ES\nprecision highp float;\n#else\n#if !defined(lowp)\n#define lowp\n#endif\n#if !defined(mediump)\n#define mediump\n#endif\n#if !defined(highp)\n#define highp\n#endif\n#endif\nvec2 unpack_float(const float packedValue) {int packedIntValue=int(packedValue);int v0=packedIntValue/256;return vec2(v0,packedIntValue-v0*256);}vec2 unpack_opacity(const float packedOpacity) {int intOpacity=int(packedOpacity)/2;return vec2(float(intOpacity)/127.0,mod(packedOpacity,2.0));}vec4 decode_color(const vec2 encodedColor) {return vec4(unpack_float(encodedColor[0])/255.0,unpack_float(encodedColor[1])/255.0\n);}float unpack_mix_vec2(const vec2 packedValue,const float t) {return mix(packedValue[0],packedValue[1],t);}vec4 unpack_mix_color(const vec4 packedColors,const float t) {vec4 minColor=decode_color(vec2(packedColors[0],packedColors[1]));vec4 maxColor=decode_color(vec2(packedColors[2],packedColors[3]));return mix(minColor,maxColor,t);}vec2 get_pattern_pos(const vec2 pixel_coord_upper,const vec2 pixel_coord_lower,const vec2 pattern_size,const float tile_units_to_pixels,const vec2 pos) {vec2 offset=mod(mod(mod(pixel_coord_upper,pattern_size)*256.0,pattern_size)*256.0+pixel_coord_lower,pattern_size);return (tile_units_to_pixels*pos+offset)/pattern_size;}"),qe=yn("uniform vec4 u_color;uniform float u_opacity;void main() {gl_FragColor=u_color*u_opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","attribute vec2 a_pos;uniform mat4 u_matrix;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);}"),Xe=yn("uniform vec2 u_pattern_tl_a;uniform vec2 u_pattern_br_a;uniform vec2 u_pattern_tl_b;uniform vec2 u_pattern_br_b;uniform vec2 u_texsize;uniform float u_mix;uniform float u_opacity;uniform sampler2D u_image;varying vec2 v_pos_a;varying vec2 v_pos_b;void main() {vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(u_pattern_tl_a/u_texsize,u_pattern_br_a/u_texsize,imagecoord);vec4 color1=texture2D(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(u_pattern_tl_b/u_texsize,u_pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture2D(u_image,pos2);gl_FragColor=mix(color1,color2,u_mix)*u_opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","uniform mat4 u_matrix;uniform vec2 u_pattern_size_a;uniform vec2 u_pattern_size_b;uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform float u_scale_a;uniform float u_scale_b;uniform float u_tile_units_to_pixels;attribute vec2 a_pos;varying vec2 v_pos_a;varying vec2 v_pos_b;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,u_scale_a*u_pattern_size_a,u_tile_units_to_pixels,a_pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,u_scale_b*u_pattern_size_b,u_tile_units_to_pixels,a_pos);}"),Ze=yn("varying vec3 v_data;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define mediump float radius\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define highp vec4 stroke_color\n#pragma mapbox: define mediump float stroke_width\n#pragma mapbox: define lowp float stroke_opacity\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize mediump float radius\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize highp vec4 stroke_color\n#pragma mapbox: initialize mediump float stroke_width\n#pragma mapbox: initialize lowp float stroke_opacity\nvec2 extrude=v_data.xy;float extrude_length=length(extrude);lowp float antialiasblur=v_data.z;float antialiased_blur=-max(blur,antialiasblur);float opacity_t=smoothstep(0.0,antialiased_blur,extrude_length-1.0);float color_t=stroke_width < 0.01 ? 0.0 : smoothstep(antialiased_blur,0.0,extrude_length-radius/(radius+stroke_width));gl_FragColor=opacity_t*mix(color*opacity,stroke_color*stroke_opacity,color_t);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","uniform mat4 u_matrix;uniform bool u_scale_with_map;uniform bool u_pitch_with_map;uniform vec2 u_extrude_scale;uniform lowp float u_device_pixel_ratio;uniform highp float u_camera_to_center_distance;attribute vec2 a_pos;varying vec3 v_data;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define mediump float radius\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define highp vec4 stroke_color\n#pragma mapbox: define mediump float stroke_width\n#pragma mapbox: define lowp float stroke_opacity\nvoid main(void) {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize mediump float radius\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize highp vec4 stroke_color\n#pragma mapbox: initialize mediump float stroke_width\n#pragma mapbox: initialize lowp float stroke_opacity\nvec2 extrude=vec2(mod(a_pos,2.0)*2.0-1.0);vec2 circle_center=floor(a_pos*0.5);if (u_pitch_with_map) {vec2 corner_position=circle_center;if (u_scale_with_map) {corner_position+=extrude*(radius+stroke_width)*u_extrude_scale;} else {vec4 projected_center=u_matrix*vec4(circle_center,0,1);corner_position+=extrude*(radius+stroke_width)*u_extrude_scale*(projected_center.w/u_camera_to_center_distance);}gl_Position=u_matrix*vec4(corner_position,0,1);} else {gl_Position=u_matrix*vec4(circle_center,0,1);if (u_scale_with_map) {gl_Position.xy+=extrude*(radius+stroke_width)*u_extrude_scale*u_camera_to_center_distance;} else {gl_Position.xy+=extrude*(radius+stroke_width)*u_extrude_scale*gl_Position.w;}}lowp float antialiasblur=1.0/u_device_pixel_ratio/(radius+stroke_width);v_data=vec3(extrude.x,extrude.y,antialiasblur);}"),Je=yn("void main() {gl_FragColor=vec4(1.0);}","attribute vec2 a_pos;uniform mat4 u_matrix;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);}"),Qe=yn("uniform highp float u_intensity;varying vec2 v_extrude;\n#pragma mapbox: define highp float weight\n#define GAUSS_COEF 0.3989422804014327\nvoid main() {\n#pragma mapbox: initialize highp float weight\nfloat d=-0.5*3.0*3.0*dot(v_extrude,v_extrude);float val=weight*u_intensity*GAUSS_COEF*exp(d);gl_FragColor=vec4(val,1.0,1.0,1.0);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","uniform mat4 u_matrix;uniform float u_extrude_scale;uniform float u_opacity;uniform float u_intensity;attribute vec2 a_pos;varying vec2 v_extrude;\n#pragma mapbox: define highp float weight\n#pragma mapbox: define mediump float radius\nconst highp float ZERO=1.0/255.0/16.0;\n#define GAUSS_COEF 0.3989422804014327\nvoid main(void) {\n#pragma mapbox: initialize highp float weight\n#pragma mapbox: initialize mediump float radius\nvec2 unscaled_extrude=vec2(mod(a_pos,2.0)*2.0-1.0);float S=sqrt(-2.0*log(ZERO/weight/u_intensity/GAUSS_COEF))/3.0;v_extrude=S*unscaled_extrude;vec2 extrude=v_extrude*radius*u_extrude_scale;vec4 pos=vec4(floor(a_pos*0.5)+extrude,0,1);gl_Position=u_matrix*pos;}"),Ke=yn("uniform sampler2D u_image;uniform sampler2D u_color_ramp;uniform float u_opacity;varying vec2 v_pos;void main() {float t=texture2D(u_image,v_pos).r;vec4 color=texture2D(u_color_ramp,vec2(t,0.5));gl_FragColor=color*u_opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(0.0);\n#endif\n}","uniform mat4 u_matrix;uniform vec2 u_world;attribute vec2 a_pos;varying vec2 v_pos;void main() {gl_Position=u_matrix*vec4(a_pos*u_world,0,1);v_pos.x=a_pos.x;v_pos.y=1.0-a_pos.y;}"),Ye=yn("varying float v_placed;varying float v_notUsed;void main() {float alpha=0.5;gl_FragColor=vec4(1.0,0.0,0.0,1.0)*alpha;if (v_placed > 0.5) {gl_FragColor=vec4(0.0,0.0,1.0,0.5)*alpha;}if (v_notUsed > 0.5) {gl_FragColor*=.1;}}","attribute vec2 a_pos;attribute vec2 a_anchor_pos;attribute vec2 a_extrude;attribute vec2 a_placed;attribute vec2 a_shift;uniform mat4 u_matrix;uniform vec2 u_extrude_scale;uniform float u_camera_to_center_distance;varying float v_placed;varying float v_notUsed;void main() {vec4 projectedPoint=u_matrix*vec4(a_anchor_pos,0,1);highp float camera_to_anchor_distance=projectedPoint.w;highp float collision_perspective_ratio=clamp(0.5+0.5*(u_camera_to_center_distance/camera_to_anchor_distance),0.0,4.0);gl_Position=u_matrix*vec4(a_pos,0.0,1.0);gl_Position.xy+=(a_extrude+a_shift)*u_extrude_scale*gl_Position.w*collision_perspective_ratio;v_placed=a_placed.x;v_notUsed=a_placed.y;}"),$e=yn("varying float v_radius;varying vec2 v_extrude;varying float v_perspective_ratio;varying float v_collision;void main() {float alpha=0.5*min(v_perspective_ratio,1.0);float stroke_radius=0.9*max(v_perspective_ratio,1.0);float distance_to_center=length(v_extrude);float distance_to_edge=abs(distance_to_center-v_radius);float opacity_t=smoothstep(-stroke_radius,0.0,-distance_to_edge);vec4 color=mix(vec4(0.0,0.0,1.0,0.5),vec4(1.0,0.0,0.0,1.0),v_collision);gl_FragColor=color*alpha*opacity_t;}","attribute vec2 a_pos;attribute float a_radius;attribute vec2 a_flags;uniform mat4 u_matrix;uniform mat4 u_inv_matrix;uniform vec2 u_viewport_size;uniform float u_camera_to_center_distance;varying float v_radius;varying vec2 v_extrude;varying float v_perspective_ratio;varying float v_collision;vec3 toTilePosition(vec2 screenPos) {vec4 rayStart=u_inv_matrix*vec4(screenPos,-1.0,1.0);vec4 rayEnd  =u_inv_matrix*vec4(screenPos, 1.0,1.0);rayStart.xyz/=rayStart.w;rayEnd.xyz  /=rayEnd.w;highp float t=(0.0-rayStart.z)/(rayEnd.z-rayStart.z);return mix(rayStart.xyz,rayEnd.xyz,t);}void main() {vec2 quadCenterPos=a_pos;float radius=a_radius;float collision=a_flags.x;float vertexIdx=a_flags.y;vec2 quadVertexOffset=vec2(mix(-1.0,1.0,float(vertexIdx >=2.0)),mix(-1.0,1.0,float(vertexIdx >=1.0 && vertexIdx <=2.0)));vec2 quadVertexExtent=quadVertexOffset*radius;vec3 tilePos=toTilePosition(quadCenterPos);vec4 clipPos=u_matrix*vec4(tilePos,1.0);highp float camera_to_anchor_distance=clipPos.w;highp float collision_perspective_ratio=clamp(0.5+0.5*(u_camera_to_center_distance/camera_to_anchor_distance),0.0,4.0);float padding_factor=1.2;v_radius=radius;v_extrude=quadVertexExtent*padding_factor;v_perspective_ratio=collision_perspective_ratio;v_collision=collision;gl_Position=vec4(clipPos.xyz/clipPos.w,1.0)+vec4(quadVertexExtent*padding_factor/u_viewport_size*2.0,0.0,0.0);}"),tn=yn("uniform highp vec4 u_color;uniform sampler2D u_overlay;varying vec2 v_uv;void main() {vec4 overlay_color=texture2D(u_overlay,v_uv);gl_FragColor=mix(u_color,overlay_color,overlay_color.a);}","attribute vec2 a_pos;varying vec2 v_uv;uniform mat4 u_matrix;uniform float u_overlay_scale;void main() {v_uv=a_pos/8192.0;gl_Position=u_matrix*vec4(a_pos*u_overlay_scale,0,1);}"),en=yn("#pragma mapbox: define highp vec4 color\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize lowp float opacity\ngl_FragColor=color*opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","attribute vec2 a_pos;uniform mat4 u_matrix;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize lowp float opacity\ngl_Position=u_matrix*vec4(a_pos,0,1);}"),nn=yn("varying vec2 v_pos;\n#pragma mapbox: define highp vec4 outline_color\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize highp vec4 outline_color\n#pragma mapbox: initialize lowp float opacity\nfloat dist=length(v_pos-gl_FragCoord.xy);float alpha=1.0-smoothstep(0.0,1.0,dist);gl_FragColor=outline_color*(alpha*opacity);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","attribute vec2 a_pos;uniform mat4 u_matrix;uniform vec2 u_world;varying vec2 v_pos;\n#pragma mapbox: define highp vec4 outline_color\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize highp vec4 outline_color\n#pragma mapbox: initialize lowp float opacity\ngl_Position=u_matrix*vec4(a_pos,0,1);v_pos=(gl_Position.xy/gl_Position.w+1.0)/2.0*u_world;}"),rn=yn("uniform vec2 u_texsize;uniform sampler2D u_image;uniform float u_fade;varying vec2 v_pos_a;varying vec2 v_pos_b;varying vec2 v_pos;\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\nvoid main() {\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(pattern_tl_a/u_texsize,pattern_br_a/u_texsize,imagecoord);vec4 color1=texture2D(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(pattern_tl_b/u_texsize,pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture2D(u_image,pos2);float dist=length(v_pos-gl_FragCoord.xy);float alpha=1.0-smoothstep(0.0,1.0,dist);gl_FragColor=mix(color1,color2,u_fade)*alpha*opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","uniform mat4 u_matrix;uniform vec2 u_world;uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform vec3 u_scale;attribute vec2 a_pos;varying vec2 v_pos_a;varying vec2 v_pos_b;varying vec2 v_pos;\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\n#pragma mapbox: define lowp float pixel_ratio_from\n#pragma mapbox: define lowp float pixel_ratio_to\nvoid main() {\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\n#pragma mapbox: initialize lowp float pixel_ratio_from\n#pragma mapbox: initialize lowp float pixel_ratio_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;gl_Position=u_matrix*vec4(a_pos,0,1);vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,fromScale*display_size_a,tileRatio,a_pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,toScale*display_size_b,tileRatio,a_pos);v_pos=(gl_Position.xy/gl_Position.w+1.0)/2.0*u_world;}"),on=yn("uniform vec2 u_texsize;uniform float u_fade;uniform sampler2D u_image;varying vec2 v_pos_a;varying vec2 v_pos_b;\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\nvoid main() {\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(pattern_tl_a/u_texsize,pattern_br_a/u_texsize,imagecoord);vec4 color1=texture2D(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(pattern_tl_b/u_texsize,pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture2D(u_image,pos2);gl_FragColor=mix(color1,color2,u_fade)*opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","uniform mat4 u_matrix;uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform vec3 u_scale;attribute vec2 a_pos;varying vec2 v_pos_a;varying vec2 v_pos_b;\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\n#pragma mapbox: define lowp float pixel_ratio_from\n#pragma mapbox: define lowp float pixel_ratio_to\nvoid main() {\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\n#pragma mapbox: initialize lowp float pixel_ratio_from\n#pragma mapbox: initialize lowp float pixel_ratio_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileZoomRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;gl_Position=u_matrix*vec4(a_pos,0,1);v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,fromScale*display_size_a,tileZoomRatio,a_pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,toScale*display_size_b,tileZoomRatio,a_pos);}"),an=yn("varying vec4 v_color;void main() {gl_FragColor=v_color;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","uniform mat4 u_matrix;uniform vec3 u_lightcolor;uniform lowp vec3 u_lightpos;uniform lowp float u_lightintensity;uniform float u_vertical_gradient;uniform lowp float u_opacity;attribute vec2 a_pos;attribute vec4 a_normal_ed;varying vec4 v_color;\n#pragma mapbox: define highp float base\n#pragma mapbox: define highp float height\n#pragma mapbox: define highp vec4 color\nvoid main() {\n#pragma mapbox: initialize highp float base\n#pragma mapbox: initialize highp float height\n#pragma mapbox: initialize highp vec4 color\nvec3 normal=a_normal_ed.xyz;base=max(0.0,base);height=max(0.0,height);float t=mod(normal.x,2.0);gl_Position=u_matrix*vec4(a_pos,t > 0.0 ? height : base,1);float colorvalue=color.r*0.2126+color.g*0.7152+color.b*0.0722;v_color=vec4(0.0,0.0,0.0,1.0);vec4 ambientlight=vec4(0.03,0.03,0.03,1.0);color+=ambientlight;float directional=clamp(dot(normal/16384.0,u_lightpos),0.0,1.0);directional=mix((1.0-u_lightintensity),max((1.0-colorvalue+u_lightintensity),1.0),directional);if (normal.y !=0.0) {directional*=((1.0-u_vertical_gradient)+(u_vertical_gradient*clamp((t+base)*pow(height/150.0,0.5),mix(0.7,0.98,1.0-u_lightintensity),1.0)));}v_color.r+=clamp(color.r*directional*u_lightcolor.r,mix(0.0,0.3,1.0-u_lightcolor.r),1.0);v_color.g+=clamp(color.g*directional*u_lightcolor.g,mix(0.0,0.3,1.0-u_lightcolor.g),1.0);v_color.b+=clamp(color.b*directional*u_lightcolor.b,mix(0.0,0.3,1.0-u_lightcolor.b),1.0);v_color*=u_opacity;}"),sn=yn("uniform vec2 u_texsize;uniform float u_fade;uniform sampler2D u_image;varying vec2 v_pos_a;varying vec2 v_pos_b;varying vec4 v_lighting;\n#pragma mapbox: define lowp float base\n#pragma mapbox: define lowp float height\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\n#pragma mapbox: define lowp float pixel_ratio_from\n#pragma mapbox: define lowp float pixel_ratio_to\nvoid main() {\n#pragma mapbox: initialize lowp float base\n#pragma mapbox: initialize lowp float height\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\n#pragma mapbox: initialize lowp float pixel_ratio_from\n#pragma mapbox: initialize lowp float pixel_ratio_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(pattern_tl_a/u_texsize,pattern_br_a/u_texsize,imagecoord);vec4 color1=texture2D(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(pattern_tl_b/u_texsize,pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture2D(u_image,pos2);vec4 mixedColor=mix(color1,color2,u_fade);gl_FragColor=mixedColor*v_lighting;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","uniform mat4 u_matrix;uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform float u_height_factor;uniform vec3 u_scale;uniform float u_vertical_gradient;uniform lowp float u_opacity;uniform vec3 u_lightcolor;uniform lowp vec3 u_lightpos;uniform lowp float u_lightintensity;attribute vec2 a_pos;attribute vec4 a_normal_ed;varying vec2 v_pos_a;varying vec2 v_pos_b;varying vec4 v_lighting;\n#pragma mapbox: define lowp float base\n#pragma mapbox: define lowp float height\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\n#pragma mapbox: define lowp float pixel_ratio_from\n#pragma mapbox: define lowp float pixel_ratio_to\nvoid main() {\n#pragma mapbox: initialize lowp float base\n#pragma mapbox: initialize lowp float height\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\n#pragma mapbox: initialize lowp float pixel_ratio_from\n#pragma mapbox: initialize lowp float pixel_ratio_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;vec3 normal=a_normal_ed.xyz;float edgedistance=a_normal_ed.w;vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;base=max(0.0,base);height=max(0.0,height);float t=mod(normal.x,2.0);float z=t > 0.0 ? height : base;gl_Position=u_matrix*vec4(a_pos,z,1);vec2 pos=normal.x==1.0 && normal.y==0.0 && normal.z==16384.0\n? a_pos\n: vec2(edgedistance,z*u_height_factor);v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,fromScale*display_size_a,tileRatio,pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,toScale*display_size_b,tileRatio,pos);v_lighting=vec4(0.0,0.0,0.0,1.0);float directional=clamp(dot(normal/16383.0,u_lightpos),0.0,1.0);directional=mix((1.0-u_lightintensity),max((0.5+u_lightintensity),1.0),directional);if (normal.y !=0.0) {directional*=((1.0-u_vertical_gradient)+(u_vertical_gradient*clamp((t+base)*pow(height/150.0,0.5),mix(0.7,0.98,1.0-u_lightintensity),1.0)));}v_lighting.rgb+=clamp(directional*u_lightcolor,mix(vec3(0.0),vec3(0.3),1.0-u_lightcolor),vec3(1.0));v_lighting*=u_opacity;}"),un=yn("#ifdef GL_ES\nprecision highp float;\n#endif\nuniform sampler2D u_image;varying vec2 v_pos;uniform vec2 u_dimension;uniform float u_zoom;uniform vec4 u_unpack;float getElevation(vec2 coord,float bias) {vec4 data=texture2D(u_image,coord)*255.0;data.a=-1.0;return dot(data,u_unpack)/4.0;}void main() {vec2 epsilon=1.0/u_dimension;float a=getElevation(v_pos+vec2(-epsilon.x,-epsilon.y),0.0);float b=getElevation(v_pos+vec2(0,-epsilon.y),0.0);float c=getElevation(v_pos+vec2(epsilon.x,-epsilon.y),0.0);float d=getElevation(v_pos+vec2(-epsilon.x,0),0.0);float e=getElevation(v_pos,0.0);float f=getElevation(v_pos+vec2(epsilon.x,0),0.0);float g=getElevation(v_pos+vec2(-epsilon.x,epsilon.y),0.0);float h=getElevation(v_pos+vec2(0,epsilon.y),0.0);float i=getElevation(v_pos+vec2(epsilon.x,epsilon.y),0.0);float exaggerationFactor=u_zoom < 2.0 ? 0.4 : u_zoom < 4.5 ? 0.35 : 0.3;float exaggeration=u_zoom < 15.0 ? (u_zoom-15.0)*exaggerationFactor : 0.0;vec2 deriv=vec2((c+f+f+i)-(a+d+d+g),(g+h+h+i)-(a+b+b+c))/pow(2.0,exaggeration+(19.2562-u_zoom));gl_FragColor=clamp(vec4(deriv.x/2.0+0.5,deriv.y/2.0+0.5,1.0,1.0),0.0,1.0);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","uniform mat4 u_matrix;uniform vec2 u_dimension;attribute vec2 a_pos;attribute vec2 a_texture_pos;varying vec2 v_pos;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);highp vec2 epsilon=1.0/u_dimension;float scale=(u_dimension.x-2.0)/u_dimension.x;v_pos=(a_texture_pos/8192.0)*scale+epsilon;}"),cn=yn("uniform sampler2D u_image;varying vec2 v_pos;uniform vec2 u_latrange;uniform vec2 u_light;uniform vec4 u_shadow;uniform vec4 u_highlight;uniform vec4 u_accent;\n#define PI 3.141592653589793\nvoid main() {vec4 pixel=texture2D(u_image,v_pos);vec2 deriv=((pixel.rg*2.0)-1.0);float scaleFactor=cos(radians((u_latrange[0]-u_latrange[1])*(1.0-v_pos.y)+u_latrange[1]));float slope=atan(1.25*length(deriv)/scaleFactor);float aspect=deriv.x !=0.0 ? atan(deriv.y,-deriv.x) : PI/2.0*(deriv.y > 0.0 ? 1.0 :-1.0);float intensity=u_light.x;float azimuth=u_light.y+PI;float base=1.875-intensity*1.75;float maxValue=0.5*PI;float scaledSlope=intensity !=0.5 ? ((pow(base,slope)-1.0)/(pow(base,maxValue)-1.0))*maxValue : slope;float accent=cos(scaledSlope);vec4 accent_color=(1.0-accent)*u_accent*clamp(intensity*2.0,0.0,1.0);float shade=abs(mod((aspect+azimuth)/PI+0.5,2.0)-1.0);vec4 shade_color=mix(u_shadow,u_highlight,shade)*sin(scaledSlope)*clamp(intensity*2.0,0.0,1.0);gl_FragColor=accent_color*(1.0-shade_color.a)+shade_color;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","uniform mat4 u_matrix;attribute vec2 a_pos;attribute vec2 a_texture_pos;varying vec2 v_pos;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);v_pos=a_texture_pos/8192.0;}"),ln=yn("uniform lowp float u_device_pixel_ratio;varying vec2 v_width2;varying vec2 v_normal;varying float v_gamma_scale;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\nfloat dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);gl_FragColor=color*(alpha*opacity);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","\n#define scale 0.015873016\nattribute vec2 a_pos_normal;attribute vec4 a_data;uniform mat4 u_matrix;uniform mediump float u_ratio;uniform vec2 u_units_to_pixels;uniform lowp float u_device_pixel_ratio;varying vec2 v_normal;varying vec2 v_width2;varying float v_gamma_scale;varying highp float v_linesofar;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define mediump float gapwidth\n#pragma mapbox: define lowp float offset\n#pragma mapbox: define mediump float width\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump float gapwidth\n#pragma mapbox: initialize lowp float offset\n#pragma mapbox: initialize mediump float width\nfloat ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=a_data.xy-128.0;float a_direction=mod(a_data.z,4.0)-1.0;v_linesofar=(floor(a_data.z/4.0)+a_data.w*64.0)*2.0;vec2 pos=floor(a_pos_normal*0.5);mediump vec2 normal=a_pos_normal-2.0*pos;normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);vec4 projected_extrude=u_matrix*vec4(dist/u_ratio,0.0,0.0);gl_Position=u_matrix*vec4(pos+offset2/u_ratio,0.0,1.0)+projected_extrude;float extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length(projected_extrude.xy/gl_Position.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;v_width2=vec2(outset,inset);}"),hn=yn("uniform lowp float u_device_pixel_ratio;uniform sampler2D u_image;varying vec2 v_width2;varying vec2 v_normal;varying float v_gamma_scale;varying highp vec2 v_uv;\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\nfloat dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);vec4 color=texture2D(u_image,v_uv);gl_FragColor=color*(alpha*opacity);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","\n#define scale 0.015873016\nattribute vec2 a_pos_normal;attribute vec4 a_data;attribute float a_uv_x;attribute float a_split_index;uniform mat4 u_matrix;uniform mediump float u_ratio;uniform lowp float u_device_pixel_ratio;uniform vec2 u_units_to_pixels;uniform float u_image_height;varying vec2 v_normal;varying vec2 v_width2;varying float v_gamma_scale;varying highp vec2 v_uv;\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define mediump float gapwidth\n#pragma mapbox: define lowp float offset\n#pragma mapbox: define mediump float width\nvoid main() {\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump float gapwidth\n#pragma mapbox: initialize lowp float offset\n#pragma mapbox: initialize mediump float width\nfloat ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=a_data.xy-128.0;float a_direction=mod(a_data.z,4.0)-1.0;highp float texel_height=1.0/u_image_height;highp float half_texel_height=0.5*texel_height;v_uv=vec2(a_uv_x,a_split_index*texel_height-half_texel_height);vec2 pos=floor(a_pos_normal*0.5);mediump vec2 normal=a_pos_normal-2.0*pos;normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);vec4 projected_extrude=u_matrix*vec4(dist/u_ratio,0.0,0.0);gl_Position=u_matrix*vec4(pos+offset2/u_ratio,0.0,1.0)+projected_extrude;float extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length(projected_extrude.xy/gl_Position.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;v_width2=vec2(outset,inset);}"),fn=yn("uniform lowp float u_device_pixel_ratio;uniform vec2 u_texsize;uniform float u_fade;uniform mediump vec3 u_scale;uniform sampler2D u_image;varying vec2 v_normal;varying vec2 v_width2;varying float v_linesofar;varying float v_gamma_scale;varying float v_width;\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\n#pragma mapbox: define lowp float pixel_ratio_from\n#pragma mapbox: define lowp float pixel_ratio_to\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\n#pragma mapbox: initialize lowp float pixel_ratio_from\n#pragma mapbox: initialize lowp float pixel_ratio_to\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileZoomRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;vec2 pattern_size_a=vec2(display_size_a.x*fromScale/tileZoomRatio,display_size_a.y);vec2 pattern_size_b=vec2(display_size_b.x*toScale/tileZoomRatio,display_size_b.y);float aspect_a=display_size_a.y/v_width;float aspect_b=display_size_b.y/v_width;float dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);float x_a=mod(v_linesofar/pattern_size_a.x*aspect_a,1.0);float x_b=mod(v_linesofar/pattern_size_b.x*aspect_b,1.0);float y=0.5*v_normal.y+0.5;vec2 texel_size=1.0/u_texsize;vec2 pos_a=mix(pattern_tl_a*texel_size-texel_size,pattern_br_a*texel_size+texel_size,vec2(x_a,y));vec2 pos_b=mix(pattern_tl_b*texel_size-texel_size,pattern_br_b*texel_size+texel_size,vec2(x_b,y));vec4 color=mix(texture2D(u_image,pos_a),texture2D(u_image,pos_b),u_fade);gl_FragColor=color*alpha*opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","\n#define scale 0.015873016\n#define LINE_DISTANCE_SCALE 2.0\nattribute vec2 a_pos_normal;attribute vec4 a_data;uniform mat4 u_matrix;uniform vec2 u_units_to_pixels;uniform mediump float u_ratio;uniform lowp float u_device_pixel_ratio;varying vec2 v_normal;varying vec2 v_width2;varying float v_linesofar;varying float v_gamma_scale;varying float v_width;\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp float offset\n#pragma mapbox: define mediump float gapwidth\n#pragma mapbox: define mediump float width\n#pragma mapbox: define lowp float floorwidth\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\n#pragma mapbox: define lowp float pixel_ratio_from\n#pragma mapbox: define lowp float pixel_ratio_to\nvoid main() {\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize lowp float offset\n#pragma mapbox: initialize mediump float gapwidth\n#pragma mapbox: initialize mediump float width\n#pragma mapbox: initialize lowp float floorwidth\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\n#pragma mapbox: initialize lowp float pixel_ratio_from\n#pragma mapbox: initialize lowp float pixel_ratio_to\nfloat ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=a_data.xy-128.0;float a_direction=mod(a_data.z,4.0)-1.0;float a_linesofar=(floor(a_data.z/4.0)+a_data.w*64.0)*LINE_DISTANCE_SCALE;vec2 pos=floor(a_pos_normal*0.5);mediump vec2 normal=a_pos_normal-2.0*pos;normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);vec4 projected_extrude=u_matrix*vec4(dist/u_ratio,0.0,0.0);gl_Position=u_matrix*vec4(pos+offset2/u_ratio,0.0,1.0)+projected_extrude;float extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length(projected_extrude.xy/gl_Position.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;v_linesofar=a_linesofar;v_width2=vec2(outset,inset);v_width=floorwidth;}"),pn=yn("uniform lowp float u_device_pixel_ratio;uniform sampler2D u_image;uniform float u_sdfgamma;uniform float u_mix;varying vec2 v_normal;varying vec2 v_width2;varying vec2 v_tex_a;varying vec2 v_tex_b;varying float v_gamma_scale;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define mediump float width\n#pragma mapbox: define lowp float floorwidth\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump float width\n#pragma mapbox: initialize lowp float floorwidth\nfloat dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);float sdfdist_a=texture2D(u_image,v_tex_a).a;float sdfdist_b=texture2D(u_image,v_tex_b).a;float sdfdist=mix(sdfdist_a,sdfdist_b,u_mix);alpha*=smoothstep(0.5-u_sdfgamma/floorwidth,0.5+u_sdfgamma/floorwidth,sdfdist);gl_FragColor=color*(alpha*opacity);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","\n#define scale 0.015873016\n#define LINE_DISTANCE_SCALE 2.0\nattribute vec2 a_pos_normal;attribute vec4 a_data;uniform mat4 u_matrix;uniform mediump float u_ratio;uniform lowp float u_device_pixel_ratio;uniform vec2 u_patternscale_a;uniform float u_tex_y_a;uniform vec2 u_patternscale_b;uniform float u_tex_y_b;uniform vec2 u_units_to_pixels;varying vec2 v_normal;varying vec2 v_width2;varying vec2 v_tex_a;varying vec2 v_tex_b;varying float v_gamma_scale;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define mediump float gapwidth\n#pragma mapbox: define lowp float offset\n#pragma mapbox: define mediump float width\n#pragma mapbox: define lowp float floorwidth\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump float gapwidth\n#pragma mapbox: initialize lowp float offset\n#pragma mapbox: initialize mediump float width\n#pragma mapbox: initialize lowp float floorwidth\nfloat ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=a_data.xy-128.0;float a_direction=mod(a_data.z,4.0)-1.0;float a_linesofar=(floor(a_data.z/4.0)+a_data.w*64.0)*LINE_DISTANCE_SCALE;vec2 pos=floor(a_pos_normal*0.5);mediump vec2 normal=a_pos_normal-2.0*pos;normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);vec4 projected_extrude=u_matrix*vec4(dist/u_ratio,0.0,0.0);gl_Position=u_matrix*vec4(pos+offset2/u_ratio,0.0,1.0)+projected_extrude;float extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length(projected_extrude.xy/gl_Position.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;v_tex_a=vec2(a_linesofar*u_patternscale_a.x/floorwidth,normal.y*u_patternscale_a.y+u_tex_y_a);v_tex_b=vec2(a_linesofar*u_patternscale_b.x/floorwidth,normal.y*u_patternscale_b.y+u_tex_y_b);v_width2=vec2(outset,inset);}"),dn=yn("uniform float u_fade_t;uniform float u_opacity;uniform sampler2D u_image0;uniform sampler2D u_image1;varying vec2 v_pos0;varying vec2 v_pos1;uniform float u_brightness_low;uniform float u_brightness_high;uniform float u_saturation_factor;uniform float u_contrast_factor;uniform vec3 u_spin_weights;void main() {vec4 color0=texture2D(u_image0,v_pos0);vec4 color1=texture2D(u_image1,v_pos1);if (color0.a > 0.0) {color0.rgb=color0.rgb/color0.a;}if (color1.a > 0.0) {color1.rgb=color1.rgb/color1.a;}vec4 color=mix(color0,color1,u_fade_t);color.a*=u_opacity;vec3 rgb=color.rgb;rgb=vec3(dot(rgb,u_spin_weights.xyz),dot(rgb,u_spin_weights.zxy),dot(rgb,u_spin_weights.yzx));float average=(color.r+color.g+color.b)/3.0;rgb+=(average-rgb)*u_saturation_factor;rgb=(rgb-0.5)*u_contrast_factor+0.5;vec3 u_high_vec=vec3(u_brightness_low,u_brightness_low,u_brightness_low);vec3 u_low_vec=vec3(u_brightness_high,u_brightness_high,u_brightness_high);gl_FragColor=vec4(mix(u_high_vec,u_low_vec,rgb)*color.a,color.a);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","uniform mat4 u_matrix;uniform vec2 u_tl_parent;uniform float u_scale_parent;uniform float u_buffer_scale;attribute vec2 a_pos;attribute vec2 a_texture_pos;varying vec2 v_pos0;varying vec2 v_pos1;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);v_pos0=(((a_texture_pos/8192.0)-0.5)/u_buffer_scale )+0.5;v_pos1=(v_pos0*u_scale_parent)+u_tl_parent;}"),An=yn("uniform sampler2D u_texture;varying vec2 v_tex;varying float v_fade_opacity;\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize lowp float opacity\nlowp float alpha=opacity*v_fade_opacity;gl_FragColor=texture2D(u_texture,v_tex)*alpha;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","const float PI=3.141592653589793;attribute vec4 a_pos_offset;attribute vec4 a_data;attribute vec4 a_pixeloffset;attribute vec3 a_projected_pos;attribute float a_fade_opacity;uniform bool u_is_size_zoom_constant;uniform bool u_is_size_feature_constant;uniform highp float u_size_t;uniform highp float u_size;uniform highp float u_camera_to_center_distance;uniform highp float u_pitch;uniform bool u_rotate_symbol;uniform highp float u_aspect_ratio;uniform float u_fade_change;uniform mat4 u_matrix;uniform mat4 u_label_plane_matrix;uniform mat4 u_coord_matrix;uniform bool u_is_text;uniform bool u_pitch_with_map;uniform vec2 u_texsize;varying vec2 v_tex;varying float v_fade_opacity;\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize lowp float opacity\nvec2 a_pos=a_pos_offset.xy;vec2 a_offset=a_pos_offset.zw;vec2 a_tex=a_data.xy;vec2 a_size=a_data.zw;float a_size_min=floor(a_size[0]*0.5);vec2 a_pxoffset=a_pixeloffset.xy;vec2 a_minFontScale=a_pixeloffset.zw/256.0;highp float segment_angle=-a_projected_pos[2];float size;if (!u_is_size_zoom_constant && !u_is_size_feature_constant) {size=mix(a_size_min,a_size[1],u_size_t)/128.0;} else if (u_is_size_zoom_constant && !u_is_size_feature_constant) {size=a_size_min/128.0;} else {size=u_size;}vec4 projectedPoint=u_matrix*vec4(a_pos,0,1);highp float camera_to_anchor_distance=projectedPoint.w;highp float distance_ratio=u_pitch_with_map ?\ncamera_to_anchor_distance/u_camera_to_center_distance :\nu_camera_to_center_distance/camera_to_anchor_distance;highp float perspective_ratio=clamp(0.5+0.5*distance_ratio,0.0,4.0);size*=perspective_ratio;float fontScale=u_is_text ? size/24.0 : size;highp float symbol_rotation=0.0;if (u_rotate_symbol) {vec4 offsetProjectedPoint=u_matrix*vec4(a_pos+vec2(1,0),0,1);vec2 a=projectedPoint.xy/projectedPoint.w;vec2 b=offsetProjectedPoint.xy/offsetProjectedPoint.w;symbol_rotation=atan((b.y-a.y)/u_aspect_ratio,b.x-a.x);}highp float angle_sin=sin(segment_angle+symbol_rotation);highp float angle_cos=cos(segment_angle+symbol_rotation);mat2 rotation_matrix=mat2(angle_cos,-1.0*angle_sin,angle_sin,angle_cos);vec4 projected_pos=u_label_plane_matrix*vec4(a_projected_pos.xy,0.0,1.0);gl_Position=u_coord_matrix*vec4(projected_pos.xy/projected_pos.w+rotation_matrix*(a_offset/32.0*max(a_minFontScale,fontScale)+a_pxoffset/16.0),0.0,1.0);v_tex=a_tex/u_texsize;vec2 fade_opacity=unpack_opacity(a_fade_opacity);float fade_change=fade_opacity[1] > 0.5 ? u_fade_change :-u_fade_change;v_fade_opacity=max(0.0,min(1.0,fade_opacity[0]+fade_change));}"),gn=yn("#define SDF_PX 8.0\nuniform bool u_is_halo;uniform sampler2D u_texture;uniform highp float u_gamma_scale;uniform lowp float u_device_pixel_ratio;uniform bool u_is_text;varying vec2 v_data0;varying vec3 v_data1;\n#pragma mapbox: define highp vec4 fill_color\n#pragma mapbox: define highp vec4 halo_color\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp float halo_width\n#pragma mapbox: define lowp float halo_blur\nvoid main() {\n#pragma mapbox: initialize highp vec4 fill_color\n#pragma mapbox: initialize highp vec4 halo_color\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize lowp float halo_width\n#pragma mapbox: initialize lowp float halo_blur\nfloat EDGE_GAMMA=0.105/u_device_pixel_ratio;vec2 tex=v_data0.xy;float gamma_scale=v_data1.x;float size=v_data1.y;float fade_opacity=v_data1[2];float fontScale=u_is_text ? size/24.0 : size;lowp vec4 color=fill_color;highp float gamma=EDGE_GAMMA/(fontScale*u_gamma_scale);lowp float buff=(256.0-64.0)/256.0;if (u_is_halo) {color=halo_color;gamma=(halo_blur*1.19/SDF_PX+EDGE_GAMMA)/(fontScale*u_gamma_scale);buff=(6.0-halo_width/fontScale)/SDF_PX;}lowp float dist=texture2D(u_texture,tex).a;highp float gamma_scaled=gamma*gamma_scale;highp float alpha=smoothstep(buff-gamma_scaled,buff+gamma_scaled,dist);gl_FragColor=color*(alpha*opacity*fade_opacity);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","const float PI=3.141592653589793;attribute vec4 a_pos_offset;attribute vec4 a_data;attribute vec4 a_pixeloffset;attribute vec3 a_projected_pos;attribute float a_fade_opacity;uniform bool u_is_size_zoom_constant;uniform bool u_is_size_feature_constant;uniform highp float u_size_t;uniform highp float u_size;uniform mat4 u_matrix;uniform mat4 u_label_plane_matrix;uniform mat4 u_coord_matrix;uniform bool u_is_text;uniform bool u_pitch_with_map;uniform highp float u_pitch;uniform bool u_rotate_symbol;uniform highp float u_aspect_ratio;uniform highp float u_camera_to_center_distance;uniform float u_fade_change;uniform vec2 u_texsize;varying vec2 v_data0;varying vec3 v_data1;\n#pragma mapbox: define highp vec4 fill_color\n#pragma mapbox: define highp vec4 halo_color\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp float halo_width\n#pragma mapbox: define lowp float halo_blur\nvoid main() {\n#pragma mapbox: initialize highp vec4 fill_color\n#pragma mapbox: initialize highp vec4 halo_color\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize lowp float halo_width\n#pragma mapbox: initialize lowp float halo_blur\nvec2 a_pos=a_pos_offset.xy;vec2 a_offset=a_pos_offset.zw;vec2 a_tex=a_data.xy;vec2 a_size=a_data.zw;float a_size_min=floor(a_size[0]*0.5);vec2 a_pxoffset=a_pixeloffset.xy;highp float segment_angle=-a_projected_pos[2];float size;if (!u_is_size_zoom_constant && !u_is_size_feature_constant) {size=mix(a_size_min,a_size[1],u_size_t)/128.0;} else if (u_is_size_zoom_constant && !u_is_size_feature_constant) {size=a_size_min/128.0;} else {size=u_size;}vec4 projectedPoint=u_matrix*vec4(a_pos,0,1);highp float camera_to_anchor_distance=projectedPoint.w;highp float distance_ratio=u_pitch_with_map ?\ncamera_to_anchor_distance/u_camera_to_center_distance :\nu_camera_to_center_distance/camera_to_anchor_distance;highp float perspective_ratio=clamp(0.5+0.5*distance_ratio,0.0,4.0);size*=perspective_ratio;float fontScale=u_is_text ? size/24.0 : size;highp float symbol_rotation=0.0;if (u_rotate_symbol) {vec4 offsetProjectedPoint=u_matrix*vec4(a_pos+vec2(1,0),0,1);vec2 a=projectedPoint.xy/projectedPoint.w;vec2 b=offsetProjectedPoint.xy/offsetProjectedPoint.w;symbol_rotation=atan((b.y-a.y)/u_aspect_ratio,b.x-a.x);}highp float angle_sin=sin(segment_angle+symbol_rotation);highp float angle_cos=cos(segment_angle+symbol_rotation);mat2 rotation_matrix=mat2(angle_cos,-1.0*angle_sin,angle_sin,angle_cos);vec4 projected_pos=u_label_plane_matrix*vec4(a_projected_pos.xy,0.0,1.0);gl_Position=u_coord_matrix*vec4(projected_pos.xy/projected_pos.w+rotation_matrix*(a_offset/32.0*fontScale+a_pxoffset),0.0,1.0);float gamma_scale=gl_Position.w;vec2 fade_opacity=unpack_opacity(a_fade_opacity);float fade_change=fade_opacity[1] > 0.5 ? u_fade_change :-u_fade_change;float interpolated_fade_opacity=max(0.0,min(1.0,fade_opacity[0]+fade_change));v_data0=a_tex/u_texsize;v_data1=vec3(gamma_scale,size,interpolated_fade_opacity);}"),mn=yn("#define SDF_PX 8.0\n#define SDF 1.0\n#define ICON 0.0\nuniform bool u_is_halo;uniform sampler2D u_texture;uniform sampler2D u_texture_icon;uniform highp float u_gamma_scale;uniform lowp float u_device_pixel_ratio;varying vec4 v_data0;varying vec4 v_data1;\n#pragma mapbox: define highp vec4 fill_color\n#pragma mapbox: define highp vec4 halo_color\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp float halo_width\n#pragma mapbox: define lowp float halo_blur\nvoid main() {\n#pragma mapbox: initialize highp vec4 fill_color\n#pragma mapbox: initialize highp vec4 halo_color\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize lowp float halo_width\n#pragma mapbox: initialize lowp float halo_blur\nfloat fade_opacity=v_data1[2];if (v_data1.w==ICON) {vec2 tex_icon=v_data0.zw;lowp float alpha=opacity*fade_opacity;gl_FragColor=texture2D(u_texture_icon,tex_icon)*alpha;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\nreturn;}vec2 tex=v_data0.xy;float EDGE_GAMMA=0.105/u_device_pixel_ratio;float gamma_scale=v_data1.x;float size=v_data1.y;float fontScale=size/24.0;lowp vec4 color=fill_color;highp float gamma=EDGE_GAMMA/(fontScale*u_gamma_scale);lowp float buff=(256.0-64.0)/256.0;if (u_is_halo) {color=halo_color;gamma=(halo_blur*1.19/SDF_PX+EDGE_GAMMA)/(fontScale*u_gamma_scale);buff=(6.0-halo_width/fontScale)/SDF_PX;}lowp float dist=texture2D(u_texture,tex).a;highp float gamma_scaled=gamma*gamma_scale;highp float alpha=smoothstep(buff-gamma_scaled,buff+gamma_scaled,dist);gl_FragColor=color*(alpha*opacity*fade_opacity);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}","const float PI=3.141592653589793;attribute vec4 a_pos_offset;attribute vec4 a_data;attribute vec3 a_projected_pos;attribute float a_fade_opacity;uniform bool u_is_size_zoom_constant;uniform bool u_is_size_feature_constant;uniform highp float u_size_t;uniform highp float u_size;uniform mat4 u_matrix;uniform mat4 u_label_plane_matrix;uniform mat4 u_coord_matrix;uniform bool u_is_text;uniform bool u_pitch_with_map;uniform highp float u_pitch;uniform bool u_rotate_symbol;uniform highp float u_aspect_ratio;uniform highp float u_camera_to_center_distance;uniform float u_fade_change;uniform vec2 u_texsize;uniform vec2 u_texsize_icon;varying vec4 v_data0;varying vec4 v_data1;\n#pragma mapbox: define highp vec4 fill_color\n#pragma mapbox: define highp vec4 halo_color\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp float halo_width\n#pragma mapbox: define lowp float halo_blur\nvoid main() {\n#pragma mapbox: initialize highp vec4 fill_color\n#pragma mapbox: initialize highp vec4 halo_color\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize lowp float halo_width\n#pragma mapbox: initialize lowp float halo_blur\nvec2 a_pos=a_pos_offset.xy;vec2 a_offset=a_pos_offset.zw;vec2 a_tex=a_data.xy;vec2 a_size=a_data.zw;float a_size_min=floor(a_size[0]*0.5);float is_sdf=a_size[0]-2.0*a_size_min;highp float segment_angle=-a_projected_pos[2];float size;if (!u_is_size_zoom_constant && !u_is_size_feature_constant) {size=mix(a_size_min,a_size[1],u_size_t)/128.0;} else if (u_is_size_zoom_constant && !u_is_size_feature_constant) {size=a_size_min/128.0;} else {size=u_size;}vec4 projectedPoint=u_matrix*vec4(a_pos,0,1);highp float camera_to_anchor_distance=projectedPoint.w;highp float distance_ratio=u_pitch_with_map ?\ncamera_to_anchor_distance/u_camera_to_center_distance :\nu_camera_to_center_distance/camera_to_anchor_distance;highp float perspective_ratio=clamp(0.5+0.5*distance_ratio,0.0,4.0);size*=perspective_ratio;float fontScale=size/24.0;highp float symbol_rotation=0.0;if (u_rotate_symbol) {vec4 offsetProjectedPoint=u_matrix*vec4(a_pos+vec2(1,0),0,1);vec2 a=projectedPoint.xy/projectedPoint.w;vec2 b=offsetProjectedPoint.xy/offsetProjectedPoint.w;symbol_rotation=atan((b.y-a.y)/u_aspect_ratio,b.x-a.x);}highp float angle_sin=sin(segment_angle+symbol_rotation);highp float angle_cos=cos(segment_angle+symbol_rotation);mat2 rotation_matrix=mat2(angle_cos,-1.0*angle_sin,angle_sin,angle_cos);vec4 projected_pos=u_label_plane_matrix*vec4(a_projected_pos.xy,0.0,1.0);gl_Position=u_coord_matrix*vec4(projected_pos.xy/projected_pos.w+rotation_matrix*(a_offset/32.0*fontScale),0.0,1.0);float gamma_scale=gl_Position.w;vec2 fade_opacity=unpack_opacity(a_fade_opacity);float fade_change=fade_opacity[1] > 0.5 ? u_fade_change :-u_fade_change;float interpolated_fade_opacity=max(0.0,min(1.0,fade_opacity[0]+fade_change));v_data0.xy=a_tex/u_texsize;v_data0.zw=a_tex/u_texsize_icon;v_data1=vec4(gamma_scale,size,interpolated_fade_opacity,is_sdf);}");function yn(t,e){var n=/#pragma mapbox: ([\w]+) ([\w]+) ([\w]+) ([\w]+)/g,r=e.match(/attribute ([\w]+) ([\w]+)/g),i=t.match(/uniform ([\w]+) ([\w]+)([\s]*)([\w]*)/g),o=e.match(/uniform ([\w]+) ([\w]+)([\s]*)([\w]*)/g),a=o?o.concat(i):i,s={};return{fragmentSource:t=t.replace(n,(function(t,e,n,r,i){return s[i]=!0,"define"===e?"\n#ifndef HAS_UNIFORM_u_"+i+"\nvarying "+n+" "+r+" "+i+";\n#else\nuniform "+n+" "+r+" u_"+i+";\n#endif\n":"\n#ifdef HAS_UNIFORM_u_"+i+"\n    "+n+" "+r+" "+i+" = u_"+i+";\n#endif\n"})),vertexSource:e=e.replace(n,(function(t,e,n,r,i){var o="float"===r?"vec2":"vec4",a=i.match(/color/)?"color":o;return s[i]?"define"===e?"\n#ifndef HAS_UNIFORM_u_"+i+"\nuniform lowp float u_"+i+"_t;\nattribute "+n+" "+o+" a_"+i+";\nvarying "+n+" "+r+" "+i+";\n#else\nuniform "+n+" "+r+" u_"+i+";\n#endif\n":"vec4"===a?"\n#ifndef HAS_UNIFORM_u_"+i+"\n    "+i+" = a_"+i+";\n#else\n    "+n+" "+r+" "+i+" = u_"+i+";\n#endif\n":"\n#ifndef HAS_UNIFORM_u_"+i+"\n    "+i+" = unpack_mix_"+a+"(a_"+i+", u_"+i+"_t);\n#else\n    "+n+" "+r+" "+i+" = u_"+i+";\n#endif\n":"define"===e?"\n#ifndef HAS_UNIFORM_u_"+i+"\nuniform lowp float u_"+i+"_t;\nattribute "+n+" "+o+" a_"+i+";\n#else\nuniform "+n+" "+r+" u_"+i+";\n#endif\n":"vec4"===a?"\n#ifndef HAS_UNIFORM_u_"+i+"\n    "+n+" "+r+" "+i+" = a_"+i+";\n#else\n    "+n+" "+r+" "+i+" = u_"+i+";\n#endif\n":"\n#ifndef HAS_UNIFORM_u_"+i+"\n    "+n+" "+r+" "+i+" = unpack_mix_"+a+"(a_"+i+", u_"+i+"_t);\n#else\n    "+n+" "+r+" "+i+" = u_"+i+";\n#endif\n"})),staticAttributes:r,staticUniforms:a}}var vn=Object.freeze({__proto__:null,prelude:We,background:qe,backgroundPattern:Xe,circle:Ze,clippingMask:Je,heatmap:Qe,heatmapTexture:Ke,collisionBox:Ye,collisionCircle:$e,debug:tn,fill:en,fillOutline:nn,fillOutlinePattern:rn,fillPattern:on,fillExtrusion:an,fillExtrusionPattern:sn,hillshadePrepare:un,hillshade:cn,line:ln,lineGradient:hn,linePattern:fn,lineSDF:pn,raster:dn,symbolIcon:An,symbolSDF:gn,symbolTextAndIcon:mn}),_n=function(){this.boundProgram=null,this.boundLayoutVertexBuffer=null,this.boundPaintVertexBuffers=[],this.boundIndexBuffer=null,this.boundVertexOffset=null,this.boundDynamicVertexBuffer=null,this.vao=null};function bn(t){for(var e=[],n=0;n<t.length;n++)if(null!==t[n]){var r=t[n].split(" ");e.push(r.pop())}return e}_n.prototype.bind=function(t,e,n,r,i,o,a,s){this.context=t;for(var u=this.boundPaintVertexBuffers.length!==r.length,c=0;!u&&c<r.length;c++)this.boundPaintVertexBuffers[c]!==r[c]&&(u=!0);t.extVertexArrayObject&&this.vao&&this.boundProgram===e&&this.boundLayoutVertexBuffer===n&&!u&&this.boundIndexBuffer===i&&this.boundVertexOffset===o&&this.boundDynamicVertexBuffer===a&&this.boundDynamicVertexBuffer2===s?(t.bindVertexArrayOES.set(this.vao),a&&a.bind(),i&&i.dynamicDraw&&i.bind(),s&&s.bind()):this.freshBind(e,n,r,i,o,a,s)},_n.prototype.freshBind=function(t,e,n,r,i,o,a){var s,u=t.numAttributes,c=this.context,l=c.gl;if(c.extVertexArrayObject)this.vao&&this.destroy(),this.vao=c.extVertexArrayObject.createVertexArrayOES(),c.bindVertexArrayOES.set(this.vao),s=0,this.boundProgram=t,this.boundLayoutVertexBuffer=e,this.boundPaintVertexBuffers=n,this.boundIndexBuffer=r,this.boundVertexOffset=i,this.boundDynamicVertexBuffer=o,this.boundDynamicVertexBuffer2=a;else{s=c.currentNumAttributes||0;for(var h=u;h<s;h++)l.disableVertexAttribArray(h)}e.enableAttributes(l,t);for(var f=0,p=n;f<p.length;f+=1)p[f].enableAttributes(l,t);o&&o.enableAttributes(l,t),a&&a.enableAttributes(l,t),e.bind(),e.setVertexAttribPointers(l,t,i);for(var d=0,A=n;d<A.length;d+=1){var g=A[d];g.bind(),g.setVertexAttribPointers(l,t,i)}o&&(o.bind(),o.setVertexAttribPointers(l,t,i)),r&&r.bind(),a&&(a.bind(),a.setVertexAttribPointers(l,t,i)),c.currentNumAttributes=u},_n.prototype.destroy=function(){this.vao&&(this.context.extVertexArrayObject.deleteVertexArrayOES(this.vao),this.vao=null)};var xn=function(t,e,n,r,i,o){var a=t.gl;this.program=a.createProgram();for(var s=bn(n.staticAttributes),u=r?r.getBinderAttributes():[],c=s.concat(u),l=n.staticUniforms?bn(n.staticUniforms):[],h=r?r.getBinderUniforms():[],f=[],p=0,d=l.concat(h);p<d.length;p+=1){var A=d[p];f.indexOf(A)<0&&f.push(A)}var g=r?r.defines():[];o&&g.push("#define OVERDRAW_INSPECTOR;");var m=g.concat(We.fragmentSource,n.fragmentSource).join("\n"),y=g.concat(We.vertexSource,n.vertexSource).join("\n"),v=a.createShader(a.FRAGMENT_SHADER);if(a.isContextLost())this.failedToCreate=!0;else{a.shaderSource(v,m),a.compileShader(v),a.attachShader(this.program,v);var _=a.createShader(a.VERTEX_SHADER);if(a.isContextLost())this.failedToCreate=!0;else{a.shaderSource(_,y),a.compileShader(_),a.attachShader(this.program,_),this.attributes={};var b={};this.numAttributes=c.length;for(var x=0;x<this.numAttributes;x++)c[x]&&(a.bindAttribLocation(this.program,x,c[x]),this.attributes[c[x]]=x);a.linkProgram(this.program),a.deleteShader(_),a.deleteShader(v);for(var w=0;w<f.length;w++){var E=f[w];if(E&&!b[E]){var O=a.getUniformLocation(this.program,E);O&&(b[E]=O)}}this.fixedUniforms=i(t,b),this.binderUniforms=r?r.getUniforms(t,b):[]}}};function wn(t,e,n){var r=1/fe(n,1,e.transform.tileZoom),i=Math.pow(2,n.tileID.overscaledZ),o=n.tileSize*Math.pow(2,e.transform.tileZoom)/i,a=o*(n.tileID.canonical.x+n.tileID.wrap*i),s=o*n.tileID.canonical.y;return{u_image:0,u_texsize:n.imageAtlasTexture.size,u_scale:[r,t.fromScale,t.toScale],u_fade:t.t,u_pixel_coord_upper:[a>>16,s>>16],u_pixel_coord_lower:[65535&a,65535&s]}}xn.prototype.draw=function(t,e,n,r,i,o,a,s,u,c,l,h,f,p,d,A){var g,m=t.gl;if(!this.failedToCreate){for(var y in t.program.set(this.program),t.setDepthMode(n),t.setStencilMode(r),t.setColorMode(i),t.setCullFace(o),this.fixedUniforms)this.fixedUniforms[y].set(a[y]);p&&p.setUniforms(t,this.binderUniforms,h,{zoom:f});for(var v=(g={},g[m.LINES]=2,g[m.TRIANGLES]=3,g[m.LINE_STRIP]=1,g)[e],_=0,b=l.get();_<b.length;_+=1){var x=b[_],w=x.vaos||(x.vaos={});(w[s]||(w[s]=new _n)).bind(t,this,u,p?p.getPaintVertexBuffers():[],c,x.vertexOffset,d,A),m.drawElements(e,x.primitiveLength*v,m.UNSIGNED_SHORT,x.primitiveOffset*v*2)}}};var En=function(e,n,r,i){var o=n.style.light,a=o.properties.get("position"),s=[a.x,a.y,a.z],u=t.create$1();"viewport"===o.properties.get("anchor")&&t.fromRotation(u,-n.transform.angle),t.transformMat3(s,s,u);var c=o.properties.get("color");return{u_matrix:e,u_lightpos:s,u_lightintensity:o.properties.get("intensity"),u_lightcolor:[c.r,c.g,c.b],u_vertical_gradient:+r,u_opacity:i}},On=function(e,n,r,i,o,a,s){return t.extend(En(e,n,r,i),wn(a,n,s),{u_height_factor:-Math.pow(2,o.overscaledZ)/s.tileSize/8})},Sn=function(t){return{u_matrix:t}},Tn=function(e,n,r,i){return t.extend(Sn(e),wn(r,n,i))},Cn=function(t,e){return{u_matrix:t,u_world:e}},Pn=function(e,n,r,i,o){return t.extend(Tn(e,n,r,i),{u_world:o})},Mn=function(e,n,r,i){var o,a,s=e.transform;if("map"===i.paint.get("circle-pitch-alignment")){var u=fe(r,1,s.zoom);o=!0,a=[u,u]}else o=!1,a=s.pixelsToGLUnits;return{u_camera_to_center_distance:s.cameraToCenterDistance,u_scale_with_map:+("map"===i.paint.get("circle-pitch-scale")),u_matrix:e.translatePosMatrix(n.posMatrix,r,i.paint.get("circle-translate"),i.paint.get("circle-translate-anchor")),u_pitch_with_map:+o,u_device_pixel_ratio:t.browser.devicePixelRatio,u_extrude_scale:a}},In=function(t,e,n){var r=fe(n,1,e.zoom),i=Math.pow(2,e.zoom-n.tileID.overscaledZ),o=n.tileID.overscaleFactor();return{u_matrix:t,u_camera_to_center_distance:e.cameraToCenterDistance,u_pixels_to_tile_units:r,u_extrude_scale:[e.pixelsToGLUnits[0]/(r*i),e.pixelsToGLUnits[1]/(r*i)],u_overscale_factor:o}},Bn=function(t,e,n){return{u_matrix:t,u_inv_matrix:e,u_camera_to_center_distance:n.cameraToCenterDistance,u_viewport_size:[n.width,n.height]}},Rn=function(t,e,n){return void 0===n&&(n=1),{u_matrix:t,u_color:e,u_overlay:0,u_overlay_scale:n}},kn=function(t){return{u_matrix:t}},Dn=function(t,e,n,r){return{u_matrix:t,u_extrude_scale:fe(e,1,n),u_intensity:r}},Ln=function(e,n,r){var i=e.transform;return{u_matrix:Nn(e,n,r),u_ratio:1/fe(n,1,i.zoom),u_device_pixel_ratio:t.browser.devicePixelRatio,u_units_to_pixels:[1/i.pixelsToGLUnits[0],1/i.pixelsToGLUnits[1]]}},jn=function(e,n,r,i){return t.extend(Ln(e,n,r),{u_image:0,u_image_height:i})},Fn=function(e,n,r,i){var o=e.transform,a=Un(n,o);return{u_matrix:Nn(e,n,r),u_texsize:n.imageAtlasTexture.size,u_ratio:1/fe(n,1,o.zoom),u_device_pixel_ratio:t.browser.devicePixelRatio,u_image:0,u_scale:[a,i.fromScale,i.toScale],u_fade:i.t,u_units_to_pixels:[1/o.pixelsToGLUnits[0],1/o.pixelsToGLUnits[1]]}},zn=function(e,n,r,i,o){var a=e.lineAtlas,s=Un(n,e.transform),u="round"===r.layout.get("line-cap"),c=a.getDash(i.from,u),l=a.getDash(i.to,u),h=c.width*o.fromScale,f=l.width*o.toScale;return t.extend(Ln(e,n,r),{u_patternscale_a:[s/h,-c.height/2],u_patternscale_b:[s/f,-l.height/2],u_sdfgamma:a.width/(256*Math.min(h,f)*t.browser.devicePixelRatio)/2,u_image:0,u_tex_y_a:c.y,u_tex_y_b:l.y,u_mix:o.t})};function Un(t,e){return 1/fe(t,1,e.tileZoom)}function Nn(t,e,n){return t.translatePosMatrix(e.tileID.posMatrix,e,n.paint.get("line-translate"),n.paint.get("line-translate-anchor"))}var Gn=function(t,e,n,r,i){return{u_matrix:t,u_tl_parent:e,u_scale_parent:n,u_buffer_scale:1,u_fade_t:r.mix,u_opacity:r.opacity*i.paint.get("raster-opacity"),u_image0:0,u_image1:1,u_brightness_low:i.paint.get("raster-brightness-min"),u_brightness_high:i.paint.get("raster-brightness-max"),u_saturation_factor:(a=i.paint.get("raster-saturation"),a>0?1-1/(1.001-a):-a),u_contrast_factor:(o=i.paint.get("raster-contrast"),o>0?1/(1-o):1+o),u_spin_weights:Vn(i.paint.get("raster-hue-rotate"))};var o,a};function Vn(t){t*=Math.PI/180;var e=Math.sin(t),n=Math.cos(t);return[(2*n+1)/3,(-Math.sqrt(3)*e-n+1)/3,(Math.sqrt(3)*e-n+1)/3]}var Hn,Wn=function(t,e,n,r,i,o,a,s,u,c){var l=i.transform;return{u_is_size_zoom_constant:+("constant"===t||"source"===t),u_is_size_feature_constant:+("constant"===t||"camera"===t),u_size_t:e?e.uSizeT:0,u_size:e?e.uSize:0,u_camera_to_center_distance:l.cameraToCenterDistance,u_pitch:l.pitch/360*2*Math.PI,u_rotate_symbol:+n,u_aspect_ratio:l.width/l.height,u_fade_change:i.options.fadeDuration?i.symbolFadeChange:1,u_matrix:o,u_label_plane_matrix:a,u_coord_matrix:s,u_is_text:+u,u_pitch_with_map:+r,u_texsize:c,u_texture:0}},qn=function(e,n,r,i,o,a,s,u,c,l,h){var f=o.transform;return t.extend(Wn(e,n,r,i,o,a,s,u,c,l),{u_gamma_scale:i?Math.cos(f._pitch)*f.cameraToCenterDistance:1,u_device_pixel_ratio:t.browser.devicePixelRatio,u_is_halo:+h})},Xn=function(e,n,r,i,o,a,s,u,c,l){return t.extend(qn(e,n,r,i,o,a,s,u,!0,c,!0),{u_texsize_icon:l,u_texture_icon:1})},Zn=function(t,e,n){return{u_matrix:t,u_opacity:e,u_color:n}},Jn=function(e,n,r,i,o,a){return t.extend(function(t,e,n,r){var i=n.imageManager.getPattern(t.from.toString()),o=n.imageManager.getPattern(t.to.toString()),a=n.imageManager.getPixelSize(),s=a.width,u=a.height,c=Math.pow(2,r.tileID.overscaledZ),l=r.tileSize*Math.pow(2,n.transform.tileZoom)/c,h=l*(r.tileID.canonical.x+r.tileID.wrap*c),f=l*r.tileID.canonical.y;return{u_image:0,u_pattern_tl_a:i.tl,u_pattern_br_a:i.br,u_pattern_tl_b:o.tl,u_pattern_br_b:o.br,u_texsize:[s,u],u_mix:e.t,u_pattern_size_a:i.displaySize,u_pattern_size_b:o.displaySize,u_scale_a:e.fromScale,u_scale_b:e.toScale,u_tile_units_to_pixels:1/fe(r,1,n.transform.tileZoom),u_pixel_coord_upper:[h>>16,f>>16],u_pixel_coord_lower:[65535&h,65535&f]}}(i,a,r,o),{u_matrix:e,u_opacity:n})},Qn={fillExtrusion:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_lightpos:new t.Uniform3f(e,n.u_lightpos),u_lightintensity:new t.Uniform1f(e,n.u_lightintensity),u_lightcolor:new t.Uniform3f(e,n.u_lightcolor),u_vertical_gradient:new t.Uniform1f(e,n.u_vertical_gradient),u_opacity:new t.Uniform1f(e,n.u_opacity)}},fillExtrusionPattern:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_lightpos:new t.Uniform3f(e,n.u_lightpos),u_lightintensity:new t.Uniform1f(e,n.u_lightintensity),u_lightcolor:new t.Uniform3f(e,n.u_lightcolor),u_vertical_gradient:new t.Uniform1f(e,n.u_vertical_gradient),u_height_factor:new t.Uniform1f(e,n.u_height_factor),u_image:new t.Uniform1i(e,n.u_image),u_texsize:new t.Uniform2f(e,n.u_texsize),u_pixel_coord_upper:new t.Uniform2f(e,n.u_pixel_coord_upper),u_pixel_coord_lower:new t.Uniform2f(e,n.u_pixel_coord_lower),u_scale:new t.Uniform3f(e,n.u_scale),u_fade:new t.Uniform1f(e,n.u_fade),u_opacity:new t.Uniform1f(e,n.u_opacity)}},fill:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix)}},fillPattern:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_image:new t.Uniform1i(e,n.u_image),u_texsize:new t.Uniform2f(e,n.u_texsize),u_pixel_coord_upper:new t.Uniform2f(e,n.u_pixel_coord_upper),u_pixel_coord_lower:new t.Uniform2f(e,n.u_pixel_coord_lower),u_scale:new t.Uniform3f(e,n.u_scale),u_fade:new t.Uniform1f(e,n.u_fade)}},fillOutline:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_world:new t.Uniform2f(e,n.u_world)}},fillOutlinePattern:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_world:new t.Uniform2f(e,n.u_world),u_image:new t.Uniform1i(e,n.u_image),u_texsize:new t.Uniform2f(e,n.u_texsize),u_pixel_coord_upper:new t.Uniform2f(e,n.u_pixel_coord_upper),u_pixel_coord_lower:new t.Uniform2f(e,n.u_pixel_coord_lower),u_scale:new t.Uniform3f(e,n.u_scale),u_fade:new t.Uniform1f(e,n.u_fade)}},circle:function(e,n){return{u_camera_to_center_distance:new t.Uniform1f(e,n.u_camera_to_center_distance),u_scale_with_map:new t.Uniform1i(e,n.u_scale_with_map),u_pitch_with_map:new t.Uniform1i(e,n.u_pitch_with_map),u_extrude_scale:new t.Uniform2f(e,n.u_extrude_scale),u_device_pixel_ratio:new t.Uniform1f(e,n.u_device_pixel_ratio),u_matrix:new t.UniformMatrix4f(e,n.u_matrix)}},collisionBox:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_camera_to_center_distance:new t.Uniform1f(e,n.u_camera_to_center_distance),u_pixels_to_tile_units:new t.Uniform1f(e,n.u_pixels_to_tile_units),u_extrude_scale:new t.Uniform2f(e,n.u_extrude_scale),u_overscale_factor:new t.Uniform1f(e,n.u_overscale_factor)}},collisionCircle:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_inv_matrix:new t.UniformMatrix4f(e,n.u_inv_matrix),u_camera_to_center_distance:new t.Uniform1f(e,n.u_camera_to_center_distance),u_viewport_size:new t.Uniform2f(e,n.u_viewport_size)}},debug:function(e,n){return{u_color:new t.UniformColor(e,n.u_color),u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_overlay:new t.Uniform1i(e,n.u_overlay),u_overlay_scale:new t.Uniform1f(e,n.u_overlay_scale)}},clippingMask:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix)}},heatmap:function(e,n){return{u_extrude_scale:new t.Uniform1f(e,n.u_extrude_scale),u_intensity:new t.Uniform1f(e,n.u_intensity),u_matrix:new t.UniformMatrix4f(e,n.u_matrix)}},heatmapTexture:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_world:new t.Uniform2f(e,n.u_world),u_image:new t.Uniform1i(e,n.u_image),u_color_ramp:new t.Uniform1i(e,n.u_color_ramp),u_opacity:new t.Uniform1f(e,n.u_opacity)}},hillshade:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_image:new t.Uniform1i(e,n.u_image),u_latrange:new t.Uniform2f(e,n.u_latrange),u_light:new t.Uniform2f(e,n.u_light),u_shadow:new t.UniformColor(e,n.u_shadow),u_highlight:new t.UniformColor(e,n.u_highlight),u_accent:new t.UniformColor(e,n.u_accent)}},hillshadePrepare:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_image:new t.Uniform1i(e,n.u_image),u_dimension:new t.Uniform2f(e,n.u_dimension),u_zoom:new t.Uniform1f(e,n.u_zoom),u_unpack:new t.Uniform4f(e,n.u_unpack)}},line:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_ratio:new t.Uniform1f(e,n.u_ratio),u_device_pixel_ratio:new t.Uniform1f(e,n.u_device_pixel_ratio),u_units_to_pixels:new t.Uniform2f(e,n.u_units_to_pixels)}},lineGradient:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_ratio:new t.Uniform1f(e,n.u_ratio),u_device_pixel_ratio:new t.Uniform1f(e,n.u_device_pixel_ratio),u_units_to_pixels:new t.Uniform2f(e,n.u_units_to_pixels),u_image:new t.Uniform1i(e,n.u_image),u_image_height:new t.Uniform1f(e,n.u_image_height)}},linePattern:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_texsize:new t.Uniform2f(e,n.u_texsize),u_ratio:new t.Uniform1f(e,n.u_ratio),u_device_pixel_ratio:new t.Uniform1f(e,n.u_device_pixel_ratio),u_image:new t.Uniform1i(e,n.u_image),u_units_to_pixels:new t.Uniform2f(e,n.u_units_to_pixels),u_scale:new t.Uniform3f(e,n.u_scale),u_fade:new t.Uniform1f(e,n.u_fade)}},lineSDF:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_ratio:new t.Uniform1f(e,n.u_ratio),u_device_pixel_ratio:new t.Uniform1f(e,n.u_device_pixel_ratio),u_units_to_pixels:new t.Uniform2f(e,n.u_units_to_pixels),u_patternscale_a:new t.Uniform2f(e,n.u_patternscale_a),u_patternscale_b:new t.Uniform2f(e,n.u_patternscale_b),u_sdfgamma:new t.Uniform1f(e,n.u_sdfgamma),u_image:new t.Uniform1i(e,n.u_image),u_tex_y_a:new t.Uniform1f(e,n.u_tex_y_a),u_tex_y_b:new t.Uniform1f(e,n.u_tex_y_b),u_mix:new t.Uniform1f(e,n.u_mix)}},raster:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_tl_parent:new t.Uniform2f(e,n.u_tl_parent),u_scale_parent:new t.Uniform1f(e,n.u_scale_parent),u_buffer_scale:new t.Uniform1f(e,n.u_buffer_scale),u_fade_t:new t.Uniform1f(e,n.u_fade_t),u_opacity:new t.Uniform1f(e,n.u_opacity),u_image0:new t.Uniform1i(e,n.u_image0),u_image1:new t.Uniform1i(e,n.u_image1),u_brightness_low:new t.Uniform1f(e,n.u_brightness_low),u_brightness_high:new t.Uniform1f(e,n.u_brightness_high),u_saturation_factor:new t.Uniform1f(e,n.u_saturation_factor),u_contrast_factor:new t.Uniform1f(e,n.u_contrast_factor),u_spin_weights:new t.Uniform3f(e,n.u_spin_weights)}},symbolIcon:function(e,n){return{u_is_size_zoom_constant:new t.Uniform1i(e,n.u_is_size_zoom_constant),u_is_size_feature_constant:new t.Uniform1i(e,n.u_is_size_feature_constant),u_size_t:new t.Uniform1f(e,n.u_size_t),u_size:new t.Uniform1f(e,n.u_size),u_camera_to_center_distance:new t.Uniform1f(e,n.u_camera_to_center_distance),u_pitch:new t.Uniform1f(e,n.u_pitch),u_rotate_symbol:new t.Uniform1i(e,n.u_rotate_symbol),u_aspect_ratio:new t.Uniform1f(e,n.u_aspect_ratio),u_fade_change:new t.Uniform1f(e,n.u_fade_change),u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_label_plane_matrix:new t.UniformMatrix4f(e,n.u_label_plane_matrix),u_coord_matrix:new t.UniformMatrix4f(e,n.u_coord_matrix),u_is_text:new t.Uniform1i(e,n.u_is_text),u_pitch_with_map:new t.Uniform1i(e,n.u_pitch_with_map),u_texsize:new t.Uniform2f(e,n.u_texsize),u_texture:new t.Uniform1i(e,n.u_texture)}},symbolSDF:function(e,n){return{u_is_size_zoom_constant:new t.Uniform1i(e,n.u_is_size_zoom_constant),u_is_size_feature_constant:new t.Uniform1i(e,n.u_is_size_feature_constant),u_size_t:new t.Uniform1f(e,n.u_size_t),u_size:new t.Uniform1f(e,n.u_size),u_camera_to_center_distance:new t.Uniform1f(e,n.u_camera_to_center_distance),u_pitch:new t.Uniform1f(e,n.u_pitch),u_rotate_symbol:new t.Uniform1i(e,n.u_rotate_symbol),u_aspect_ratio:new t.Uniform1f(e,n.u_aspect_ratio),u_fade_change:new t.Uniform1f(e,n.u_fade_change),u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_label_plane_matrix:new t.UniformMatrix4f(e,n.u_label_plane_matrix),u_coord_matrix:new t.UniformMatrix4f(e,n.u_coord_matrix),u_is_text:new t.Uniform1i(e,n.u_is_text),u_pitch_with_map:new t.Uniform1i(e,n.u_pitch_with_map),u_texsize:new t.Uniform2f(e,n.u_texsize),u_texture:new t.Uniform1i(e,n.u_texture),u_gamma_scale:new t.Uniform1f(e,n.u_gamma_scale),u_device_pixel_ratio:new t.Uniform1f(e,n.u_device_pixel_ratio),u_is_halo:new t.Uniform1i(e,n.u_is_halo)}},symbolTextAndIcon:function(e,n){return{u_is_size_zoom_constant:new t.Uniform1i(e,n.u_is_size_zoom_constant),u_is_size_feature_constant:new t.Uniform1i(e,n.u_is_size_feature_constant),u_size_t:new t.Uniform1f(e,n.u_size_t),u_size:new t.Uniform1f(e,n.u_size),u_camera_to_center_distance:new t.Uniform1f(e,n.u_camera_to_center_distance),u_pitch:new t.Uniform1f(e,n.u_pitch),u_rotate_symbol:new t.Uniform1i(e,n.u_rotate_symbol),u_aspect_ratio:new t.Uniform1f(e,n.u_aspect_ratio),u_fade_change:new t.Uniform1f(e,n.u_fade_change),u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_label_plane_matrix:new t.UniformMatrix4f(e,n.u_label_plane_matrix),u_coord_matrix:new t.UniformMatrix4f(e,n.u_coord_matrix),u_is_text:new t.Uniform1i(e,n.u_is_text),u_pitch_with_map:new t.Uniform1i(e,n.u_pitch_with_map),u_texsize:new t.Uniform2f(e,n.u_texsize),u_texsize_icon:new t.Uniform2f(e,n.u_texsize_icon),u_texture:new t.Uniform1i(e,n.u_texture),u_texture_icon:new t.Uniform1i(e,n.u_texture_icon),u_gamma_scale:new t.Uniform1f(e,n.u_gamma_scale),u_device_pixel_ratio:new t.Uniform1f(e,n.u_device_pixel_ratio),u_is_halo:new t.Uniform1i(e,n.u_is_halo)}},background:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_opacity:new t.Uniform1f(e,n.u_opacity),u_color:new t.UniformColor(e,n.u_color)}},backgroundPattern:function(e,n){return{u_matrix:new t.UniformMatrix4f(e,n.u_matrix),u_opacity:new t.Uniform1f(e,n.u_opacity),u_image:new t.Uniform1i(e,n.u_image),u_pattern_tl_a:new t.Uniform2f(e,n.u_pattern_tl_a),u_pattern_br_a:new t.Uniform2f(e,n.u_pattern_br_a),u_pattern_tl_b:new t.Uniform2f(e,n.u_pattern_tl_b),u_pattern_br_b:new t.Uniform2f(e,n.u_pattern_br_b),u_texsize:new t.Uniform2f(e,n.u_texsize),u_mix:new t.Uniform1f(e,n.u_mix),u_pattern_size_a:new t.Uniform2f(e,n.u_pattern_size_a),u_pattern_size_b:new t.Uniform2f(e,n.u_pattern_size_b),u_scale_a:new t.Uniform1f(e,n.u_scale_a),u_scale_b:new t.Uniform1f(e,n.u_scale_b),u_pixel_coord_upper:new t.Uniform2f(e,n.u_pixel_coord_upper),u_pixel_coord_lower:new t.Uniform2f(e,n.u_pixel_coord_lower),u_tile_units_to_pixels:new t.Uniform1f(e,n.u_tile_units_to_pixels)}}};function Kn(e,n,r,i,o,a,s){for(var u=e.context,c=u.gl,l=e.useProgram("collisionBox"),h=[],f=0,p=0,d=0;d<i.length;d++){var A=i[d],g=n.getTile(A),m=g.getBucket(r);if(m){var y=A.posMatrix;0===o[0]&&0===o[1]||(y=e.translatePosMatrix(A.posMatrix,g,o,a));var v=s?m.textCollisionBox:m.iconCollisionBox,_=m.collisionCircleArray;if(_.length>0){var b=t.create(),x=y;t.mul(b,m.placementInvProjMatrix,e.transform.glCoordMatrix),t.mul(b,b,m.placementViewportMatrix),h.push({circleArray:_,circleOffset:p,transform:x,invTransform:b}),p=f+=_.length/4}v&&l.draw(u,c.LINES,Ot.disabled,St.disabled,e.colorModeForRenderPass(),Ct.disabled,In(y,e.transform,g),r.id,v.layoutVertexBuffer,v.indexBuffer,v.segments,null,e.transform.zoom,null,null,v.collisionVertexBuffer)}}if(s&&h.length){var w=e.useProgram("collisionCircle"),E=new t.StructArrayLayout2f1f2i16;E.resize(4*f),E._trim();for(var O=0,S=0,T=h;S<T.length;S+=1)for(var C=T[S],P=0;P<C.circleArray.length/4;P++){var M=4*P,I=C.circleArray[M+0],B=C.circleArray[M+1],R=C.circleArray[M+2],k=C.circleArray[M+3];E.emplace(O++,I,B,R,k,0),E.emplace(O++,I,B,R,k,1),E.emplace(O++,I,B,R,k,2),E.emplace(O++,I,B,R,k,3)}(!Hn||Hn.length<2*f)&&(Hn=function(e){var n=2*e,r=new t.StructArrayLayout3ui6;r.resize(n),r._trim();for(var i=0;i<n;i++){var o=6*i;r.uint16[o+0]=4*i+0,r.uint16[o+1]=4*i+1,r.uint16[o+2]=4*i+2,r.uint16[o+3]=4*i+2,r.uint16[o+4]=4*i+3,r.uint16[o+5]=4*i+0}return r}(f));for(var D=u.createIndexBuffer(Hn,!0),L=u.createVertexBuffer(E,t.collisionCircleLayout.members,!0),j=0,F=h;j<F.length;j+=1){var z=F[j],U=Bn(z.transform,z.invTransform,e.transform);w.draw(u,c.TRIANGLES,Ot.disabled,St.disabled,e.colorModeForRenderPass(),Ct.disabled,U,r.id,L,D,t.SegmentVector.simpleSegment(0,2*z.circleOffset,z.circleArray.length,z.circleArray.length/2),null,e.transform.zoom,null,null,null)}L.destroy(),D.destroy()}}var Yn=t.identity(new Float32Array(16));function $n(e,n,r,i,o,a){var s=t.getAnchorAlignment(e),u=-(s.horizontalAlign-.5)*n,c=-(s.verticalAlign-.5)*r,l=t.evaluateVariableOffset(e,i);return new t.Point((u/o+l[0])*a,(c/o+l[1])*a)}function tr(e,n,r,i,o,a,s,u,c,l,h){var f=e.text.placedSymbolArray,p=e.text.dynamicLayoutVertexArray,d=e.icon.dynamicLayoutVertexArray,A={};p.clear();for(var g=0;g<f.length;g++){var m=f.get(g),y=m.hidden||!m.crossTileID||e.allowVerticalPlacement&&!m.placedOrientation?null:i[m.crossTileID];if(y){var v=new t.Point(m.anchorX,m.anchorY),_=$t(v,r?u:s),b=te(a.cameraToCenterDistance,_.signedDistanceFromCamera),x=o.evaluateSizeForFeature(e.textSizeData,l,m)*b/t.ONE_EM;r&&(x*=e.tilePixelRatio/c);for(var w=$n(y.anchor,y.width,y.height,y.textOffset,y.textBoxScale,x),E=r?$t(v.add(w),s).point:_.point.add(n?w.rotate(-a.angle):w),O=e.allowVerticalPlacement&&m.placedOrientation===t.WritingMode.vertical?Math.PI/2:0,S=0;S<m.numGlyphs;S++)t.addDynamicAttributes(p,E,O);h&&m.associatedIconIndex>=0&&(A[m.associatedIconIndex]={shiftedAnchor:E,angle:O})}else ce(m.numGlyphs,p)}if(h){d.clear();for(var T=e.icon.placedSymbolArray,C=0;C<T.length;C++){var P=T.get(C);if(P.hidden)ce(P.numGlyphs,d);else{var M=A[C];if(M)for(var I=0;I<P.numGlyphs;I++)t.addDynamicAttributes(d,M.shiftedAnchor,M.angle);else ce(P.numGlyphs,d)}}e.icon.dynamicLayoutVertexBuffer.updateData(d)}e.text.dynamicLayoutVertexBuffer.updateData(p)}function er(t,e,n){return n.iconsInText&&e?"symbolTextAndIcon":t?"symbolSDF":"symbolIcon"}function nr(e,n,r,i,o,a,s,u,c,l,h,f){for(var p=e.context,d=p.gl,A=e.transform,g="map"===u,m="map"===c,y=g&&"point"!==r.layout.get("symbol-placement"),v=g&&!m&&!y,_=void 0!==r.layout.get("symbol-sort-key").constantOr(1),b=!1,x=e.depthModeForSublayer(0,Ot.ReadOnly),w=r.layout.get("text-variable-anchor"),E=[],O=0,S=i;O<S.length;O+=1){var T=S[O],C=n.getTile(T),P=C.getBucket(r);if(P){var M=o?P.text:P.icon;if(M&&M.segments.get().length){var I=M.programConfigurations.get(r.id),B=o||P.sdfIcons,R=o?P.textSizeData:P.iconSizeData,k=m||0!==A.pitch,D=e.useProgram(er(B,o,P),I),L=t.evaluateSizeForZoom(R,A.zoom),j=void 0,F=[0,0],z=void 0,U=void 0,N=null,G=void 0;if(o)z=C.glyphAtlasTexture,U=d.LINEAR,j=C.glyphAtlasTexture.size,P.iconsInText&&(F=C.imageAtlasTexture.size,N=C.imageAtlasTexture,G=k||e.options.rotating||e.options.zooming||"composite"===R.kind||"camera"===R.kind?d.LINEAR:d.NEAREST);else{var V=1!==r.layout.get("icon-size").constantOr(0)||P.iconsNeedLinear;z=C.imageAtlasTexture,U=B||e.options.rotating||e.options.zooming||V||k?d.LINEAR:d.NEAREST,j=C.imageAtlasTexture.size}var H=fe(C,1,e.transform.zoom),W=Kt(T.posMatrix,m,g,e.transform,H),q=Yt(T.posMatrix,m,g,e.transform,H),X=w&&P.hasTextData(),Z="none"!==r.layout.get("icon-text-fit")&&X&&P.hasIconData();y&&ne(P,T.posMatrix,e,o,W,q,m,l);var J=e.translatePosMatrix(T.posMatrix,C,a,s),Q=y||o&&w||Z?Yn:W,K=e.translatePosMatrix(q,C,a,s,!0),Y=B&&0!==r.paint.get(o?"text-halo-width":"icon-halo-width").constantOr(1),$={program:D,buffers:M,uniformValues:B?P.iconsInText?Xn(R.kind,L,v,m,e,J,Q,K,j,F):qn(R.kind,L,v,m,e,J,Q,K,o,j,!0):Wn(R.kind,L,v,m,e,J,Q,K,o,j),atlasTexture:z,atlasTextureIcon:N,atlasInterpolation:U,atlasInterpolationIcon:G,isSDF:B,hasHalo:Y};if(_&&P.canOverlap){b=!0;for(var tt=0,et=M.segments.get();tt<et.length;tt+=1){var nt=et[tt];E.push({segments:new t.SegmentVector([nt]),sortKey:nt.sortKey,state:$})}}else E.push({segments:M.segments,sortKey:0,state:$})}}}b&&E.sort((function(t,e){return t.sortKey-e.sortKey}));for(var rt=0,it=E;rt<it.length;rt+=1){var ot=it[rt],at=ot.state;if(p.activeTexture.set(d.TEXTURE0),at.atlasTexture.bind(at.atlasInterpolation,d.CLAMP_TO_EDGE),at.atlasTextureIcon&&(p.activeTexture.set(d.TEXTURE1),at.atlasTextureIcon&&at.atlasTextureIcon.bind(at.atlasInterpolationIcon,d.CLAMP_TO_EDGE)),at.isSDF){var st=at.uniformValues;at.hasHalo&&(st.u_is_halo=1,rr(at.buffers,ot.segments,r,e,at.program,x,h,f,st)),st.u_is_halo=0}rr(at.buffers,ot.segments,r,e,at.program,x,h,f,at.uniformValues)}}function rr(t,e,n,r,i,o,a,s,u){var c=r.context;i.draw(c,c.gl.TRIANGLES,o,a,s,Ct.disabled,u,n.id,t.layoutVertexBuffer,t.indexBuffer,e,n.paint,r.transform.zoom,t.programConfigurations.get(n.id),t.dynamicLayoutVertexBuffer,t.opacityVertexBuffer)}function ir(t,e,n,r,i,o,a){var s,u,c,l,h,f=t.context.gl,p=n.paint.get("fill-pattern"),d=p&&p.constantOr(1),A=n.getCrossfadeParameters();a?(u=d&&!n.getPaintProperty("fill-outline-color")?"fillOutlinePattern":"fillOutline",s=f.LINES):(u=d?"fillPattern":"fill",s=f.TRIANGLES);for(var g=0,m=r;g<m.length;g+=1){var y=m[g],v=e.getTile(y);if(!d||v.patternsLoaded()){var _=v.getBucket(n);if(_){var b=_.programConfigurations.get(n.id),x=t.useProgram(u,b);d&&(t.context.activeTexture.set(f.TEXTURE0),v.imageAtlasTexture.bind(f.LINEAR,f.CLAMP_TO_EDGE),b.updatePaintBuffers(A));var w=p.constantOr(null);if(w&&v.imageAtlas){var E=v.imageAtlas,O=E.patternPositions[w.to.toString()],S=E.patternPositions[w.from.toString()];O&&S&&b.setConstantPatternPositions(O,S)}var T=t.translatePosMatrix(y.posMatrix,v,n.paint.get("fill-translate"),n.paint.get("fill-translate-anchor"));if(a){l=_.indexBuffer2,h=_.segments2;var C=[f.drawingBufferWidth,f.drawingBufferHeight];c="fillOutlinePattern"===u&&d?Pn(T,t,A,v,C):Cn(T,C)}else l=_.indexBuffer,h=_.segments,c=d?Tn(T,t,A,v):Sn(T);x.draw(t.context,s,i,t.stencilModeForClipping(y),o,Ct.disabled,c,n.id,_.layoutVertexBuffer,l,h,n.paint,t.transform.zoom,b)}}}}function or(t,e,n,r,i,o,a){for(var s=t.context,u=s.gl,c=n.paint.get("fill-extrusion-pattern"),l=c.constantOr(1),h=n.getCrossfadeParameters(),f=n.paint.get("fill-extrusion-opacity"),p=0,d=r;p<d.length;p+=1){var A=d[p],g=e.getTile(A),m=g.getBucket(n);if(m){var y=m.programConfigurations.get(n.id),v=t.useProgram(l?"fillExtrusionPattern":"fillExtrusion",y);l&&(t.context.activeTexture.set(u.TEXTURE0),g.imageAtlasTexture.bind(u.LINEAR,u.CLAMP_TO_EDGE),y.updatePaintBuffers(h));var _=c.constantOr(null);if(_&&g.imageAtlas){var b=g.imageAtlas,x=b.patternPositions[_.to.toString()],w=b.patternPositions[_.from.toString()];x&&w&&y.setConstantPatternPositions(x,w)}var E=t.translatePosMatrix(A.posMatrix,g,n.paint.get("fill-extrusion-translate"),n.paint.get("fill-extrusion-translate-anchor")),O=n.paint.get("fill-extrusion-vertical-gradient"),S=l?On(E,t,O,f,A,h,g):En(E,t,O,f);v.draw(s,s.gl.TRIANGLES,i,o,a,Ct.backCCW,S,n.id,m.layoutVertexBuffer,m.indexBuffer,m.segments,n.paint,t.transform.zoom,y)}}}function ar(e,n,r,i,o,a){var s=e.context,u=s.gl,c=n.fbo;if(c){var l=e.useProgram("hillshade");s.activeTexture.set(u.TEXTURE0),u.bindTexture(u.TEXTURE_2D,c.colorAttachment.get());var h=function(e,n,r){var i=r.paint.get("hillshade-shadow-color"),o=r.paint.get("hillshade-highlight-color"),a=r.paint.get("hillshade-accent-color"),s=r.paint.get("hillshade-illumination-direction")*(Math.PI/180);"viewport"===r.paint.get("hillshade-illumination-anchor")&&(s-=e.transform.angle);var u,c,l,h=!e.options.moving;return{u_matrix:e.transform.calculatePosMatrix(n.tileID.toUnwrapped(),h),u_image:0,u_latrange:(u=n.tileID,c=Math.pow(2,u.canonical.z),l=u.canonical.y,[new t.MercatorCoordinate(0,l/c).toLngLat().lat,new t.MercatorCoordinate(0,(l+1)/c).toLngLat().lat]),u_light:[r.paint.get("hillshade-exaggeration"),s],u_shadow:i,u_highlight:o,u_accent:a}}(e,n,r);l.draw(s,u.TRIANGLES,i,o,a,Ct.disabled,h,r.id,e.rasterBoundsBuffer,e.quadTriangleIndexBuffer,e.rasterBoundsSegments)}}function sr(e,n,r,i,o,a){var s=e.context,u=s.gl,c=n.dem;if(c&&c.data){var l=c.dim,h=c.stride,f=c.getPixels();if(s.activeTexture.set(u.TEXTURE1),s.pixelStoreUnpackPremultiplyAlpha.set(!1),n.demTexture=n.demTexture||e.getTileTexture(h),n.demTexture){var p=n.demTexture;p.update(f,{premultiply:!1}),p.bind(u.NEAREST,u.CLAMP_TO_EDGE)}else n.demTexture=new t.Texture(s,f,u.RGBA,{premultiply:!1}),n.demTexture.bind(u.NEAREST,u.CLAMP_TO_EDGE);s.activeTexture.set(u.TEXTURE0);var d=n.fbo;if(!d){var A=new t.Texture(s,{width:l,height:l,data:null},u.RGBA);A.bind(u.LINEAR,u.CLAMP_TO_EDGE),(d=n.fbo=s.createFramebuffer(l,l,!0)).colorAttachment.set(A.texture)}s.bindFramebuffer.set(d.framebuffer),s.viewport.set([0,0,l,l]),e.useProgram("hillshadePrepare").draw(s,u.TRIANGLES,i,o,a,Ct.disabled,function(e,n){var r=n.stride,i=t.create();return t.ortho(i,0,t.EXTENT,-t.EXTENT,0,0,1),t.translate(i,i,[0,-t.EXTENT,0]),{u_matrix:i,u_image:1,u_dimension:[r,r],u_zoom:e.overscaledZ,u_unpack:n.getUnpackVector()}}(n.tileID,c),r.id,e.rasterBoundsBuffer,e.quadTriangleIndexBuffer,e.rasterBoundsSegments),n.needsHillshadePrepare=!1}}function ur(e,n,r,i,o){var a=i.paint.get("raster-fade-duration");if(a>0){var s=t.browser.now(),u=(s-e.timeAdded)/a,c=n?(s-n.timeAdded)/a:-1,l=r.getSource(),h=o.coveringZoomLevel({tileSize:l.tileSize,roundZoom:l.roundZoom}),f=!n||Math.abs(n.tileID.overscaledZ-h)>Math.abs(e.tileID.overscaledZ-h),p=f&&e.refreshedUponExpiration?1:t.clamp(f?u:1-c,0,1);return e.refreshedUponExpiration&&u>=1&&(e.refreshedUponExpiration=!1),n?{opacity:1,mix:1-p}:{opacity:p,mix:0}}return{opacity:1,mix:0}}var cr=new t.Color(1,0,0,1),lr=new t.Color(0,1,0,1),hr=new t.Color(0,0,1,1),fr=new t.Color(1,0,1,1),pr=new t.Color(0,1,1,1);function dr(t,e,n,r){gr(t,0,e+n/2,t.transform.width,n,r)}function Ar(t,e,n,r){gr(t,e-n/2,0,n,t.transform.height,r)}function gr(e,n,r,i,o,a){var s=e.context,u=s.gl;u.enable(u.SCISSOR_TEST),u.scissor(n*t.browser.devicePixelRatio,r*t.browser.devicePixelRatio,i*t.browser.devicePixelRatio,o*t.browser.devicePixelRatio),s.clear({color:a}),u.disable(u.SCISSOR_TEST)}function mr(e,n,r){var i=e.context,o=i.gl,a=r.posMatrix,s=e.useProgram("debug"),u=Ot.disabled,c=St.disabled,l=e.colorModeForRenderPass();i.activeTexture.set(o.TEXTURE0),e.emptyTexture.bind(o.LINEAR,o.CLAMP_TO_EDGE),s.draw(i,o.LINE_STRIP,u,c,l,Ct.disabled,Rn(a,t.Color.red),"$debug",e.debugBuffer,e.tileBorderIndexBuffer,e.debugSegments);var h=n.getTileByID(r.key).latestRawTileData,f=Math.floor((h&&h.byteLength||0)/1024),p=n.getTile(r).tileSize,d=512/Math.min(p,512)*(r.overscaledZ/e.transform.zoom)*.5,A=r.canonical.toString();r.overscaledZ!==r.canonical.z&&(A+=" => "+r.overscaledZ),function(t,e){t.initDebugOverlayCanvas();var n=t.debugOverlayCanvas,r=t.context.gl,i=t.debugOverlayCanvas.getContext("2d");i.clearRect(0,0,n.width,n.height),i.shadowColor="white",i.shadowBlur=2,i.lineWidth=1.5,i.strokeStyle="white",i.textBaseline="top",i.font="bold 36px Open Sans, sans-serif",i.fillText(e,5,5),i.strokeText(e,5,5),t.debugOverlayTexture.update(n),t.debugOverlayTexture.bind(r.LINEAR,r.CLAMP_TO_EDGE)}(e,A+" "+f+"kb"),s.draw(i,o.TRIANGLES,u,c,Tt.alphaBlended,Ct.disabled,Rn(a,t.Color.transparent,d),"$debug",e.debugBuffer,e.quadTriangleIndexBuffer,e.debugSegments)}var yr={symbol:function(e,n,r,i,o){if("translucent"===e.renderPass){var a=St.disabled,s=e.colorModeForRenderPass();r.layout.get("text-variable-anchor")&&function(e,n,r,i,o,a,s){for(var u=n.transform,c="map"===o,l="map"===a,h=0,f=e;h<f.length;h+=1){var p=f[h],d=i.getTile(p),A=d.getBucket(r);if(A&&A.text&&A.text.segments.get().length){var g=t.evaluateSizeForZoom(A.textSizeData,u.zoom),m=fe(d,1,n.transform.zoom),y=Kt(p.posMatrix,l,c,n.transform,m),v="none"!==r.layout.get("icon-text-fit")&&A.hasIconData();if(g){var _=Math.pow(2,u.zoom-d.tileID.overscaledZ);tr(A,c,l,s,t.symbolSize,u,y,p.posMatrix,_,g,v)}}}}(i,e,r,n,r.layout.get("text-rotation-alignment"),r.layout.get("text-pitch-alignment"),o),0!==r.paint.get("icon-opacity").constantOr(1)&&nr(e,n,r,i,!1,r.paint.get("icon-translate"),r.paint.get("icon-translate-anchor"),r.layout.get("icon-rotation-alignment"),r.layout.get("icon-pitch-alignment"),r.layout.get("icon-keep-upright"),a,s),0!==r.paint.get("text-opacity").constantOr(1)&&nr(e,n,r,i,!0,r.paint.get("text-translate"),r.paint.get("text-translate-anchor"),r.layout.get("text-rotation-alignment"),r.layout.get("text-pitch-alignment"),r.layout.get("text-keep-upright"),a,s),n.map.showCollisionBoxes&&(Kn(e,n,r,i,r.paint.get("text-translate"),r.paint.get("text-translate-anchor"),!0),Kn(e,n,r,i,r.paint.get("icon-translate"),r.paint.get("icon-translate-anchor"),!1))}},circle:function(e,n,r,i){if("translucent"===e.renderPass){var o=r.paint.get("circle-opacity"),a=r.paint.get("circle-stroke-width"),s=r.paint.get("circle-stroke-opacity"),u=void 0!==r.layout.get("circle-sort-key").constantOr(1);if(0!==o.constantOr(1)||0!==a.constantOr(1)&&0!==s.constantOr(1)){for(var c=e.context,l=c.gl,h=e.depthModeForSublayer(0,Ot.ReadOnly),f=St.disabled,p=e.colorModeForRenderPass(),d=[],A=0;A<i.length;A++){var g=i[A],m=n.getTile(g),y=m.getBucket(r);if(y){var v=y.programConfigurations.get(r.id),_={programConfiguration:v,program:e.useProgram("circle",v),layoutVertexBuffer:y.layoutVertexBuffer,indexBuffer:y.indexBuffer,uniformValues:Mn(e,g,m,r)};if(u)for(var b=0,x=y.segments.get();b<x.length;b+=1){var w=x[b];d.push({segments:new t.SegmentVector([w]),sortKey:w.sortKey,state:_})}else d.push({segments:y.segments,sortKey:0,state:_})}}u&&d.sort((function(t,e){return t.sortKey-e.sortKey}));for(var E=0,O=d;E<O.length;E+=1){var S=O[E],T=S.state;T.program.draw(c,l.TRIANGLES,h,f,p,Ct.disabled,T.uniformValues,r.id,T.layoutVertexBuffer,T.indexBuffer,S.segments,r.paint,e.transform.zoom,T.programConfiguration)}}}},heatmap:function(e,n,r,i){if(0!==r.paint.get("heatmap-opacity"))if("offscreen"===e.renderPass){var o=e.context,a=o.gl,s=St.disabled,u=new Tt([a.ONE,a.ONE],t.Color.transparent,[!0,!0,!0,!0]);!function(t,e,n){var r=t.gl;t.activeTexture.set(r.TEXTURE1),t.viewport.set([0,0,e.width/4,e.height/4]);var i=n.heatmapFbo;if(i)r.bindTexture(r.TEXTURE_2D,i.colorAttachment.get()),t.bindFramebuffer.set(i.framebuffer);else{var o=r.createTexture();r.bindTexture(r.TEXTURE_2D,o),r.texParameteri(r.TEXTURE_2D,r.TEXTURE_WRAP_S,r.CLAMP_TO_EDGE),r.texParameteri(r.TEXTURE_2D,r.TEXTURE_WRAP_T,r.CLAMP_TO_EDGE),r.texParameteri(r.TEXTURE_2D,r.TEXTURE_MIN_FILTER,r.LINEAR),r.texParameteri(r.TEXTURE_2D,r.TEXTURE_MAG_FILTER,r.LINEAR),i=n.heatmapFbo=t.createFramebuffer(e.width/4,e.height/4,!1),function(t,e,n,r){var i=t.gl;i.texImage2D(i.TEXTURE_2D,0,i.RGBA,e.width/4,e.height/4,0,i.RGBA,t.extRenderToTextureHalfFloat?t.extTextureHalfFloat.HALF_FLOAT_OES:i.UNSIGNED_BYTE,null),r.colorAttachment.set(n)}(t,e,o,i)}}(o,e,r),o.clear({color:t.Color.transparent});for(var c=0;c<i.length;c++){var l=i[c];if(!n.hasRenderableParent(l)){var h=n.getTile(l),f=h.getBucket(r);if(f){var p=f.programConfigurations.get(r.id);e.useProgram("heatmap",p).draw(o,a.TRIANGLES,Ot.disabled,s,u,Ct.disabled,Dn(l.posMatrix,h,e.transform.zoom,r.paint.get("heatmap-intensity")),r.id,f.layoutVertexBuffer,f.indexBuffer,f.segments,r.paint,e.transform.zoom,p)}}}o.viewport.set([0,0,e.width,e.height])}else"translucent"===e.renderPass&&(e.context.setColorMode(e.colorModeForRenderPass()),function(e,n){var r=e.context,i=r.gl,o=n.heatmapFbo;if(o){r.activeTexture.set(i.TEXTURE0),i.bindTexture(i.TEXTURE_2D,o.colorAttachment.get()),r.activeTexture.set(i.TEXTURE1);var a=n.colorRampTexture;a||(a=n.colorRampTexture=new t.Texture(r,n.colorRamp,i.RGBA)),a.bind(i.LINEAR,i.CLAMP_TO_EDGE),e.useProgram("heatmapTexture").draw(r,i.TRIANGLES,Ot.disabled,St.disabled,e.colorModeForRenderPass(),Ct.disabled,function(e,n,r,i){var o=t.create();t.ortho(o,0,e.width,e.height,0,0,1);var a=e.context.gl;return{u_matrix:o,u_world:[a.drawingBufferWidth,a.drawingBufferHeight],u_image:0,u_color_ramp:1,u_opacity:n.paint.get("heatmap-opacity")}}(e,n),n.id,e.viewportBuffer,e.quadTriangleIndexBuffer,e.viewportSegments,n.paint,e.transform.zoom)}}(e,r))},line:function(e,n,r,i){if("translucent"===e.renderPass){var o=r.paint.get("line-opacity"),a=r.paint.get("line-width");if(0!==o.constantOr(1)&&0!==a.constantOr(1))for(var s=e.depthModeForSublayer(0,Ot.ReadOnly),u=e.colorModeForRenderPass(),c=r.paint.get("line-dasharray"),l=r.paint.get("line-pattern"),h=l.constantOr(1),f=r.paint.get("line-gradient"),p=r.getCrossfadeParameters(),d=h?"linePattern":c?"lineSDF":f?"lineGradient":"line",A=e.context,g=A.gl,m=!0,y=0,v=i;y<v.length;y+=1){var _=v[y],b=n.getTile(_);if(!h||b.patternsLoaded()){var x=b.getBucket(r);if(x){var w=x.programConfigurations.get(r.id),E=e.context.program.get(),O=e.useProgram(d,w),S=m||O.program!==E,T=l.constantOr(null);if(T&&b.imageAtlas){var C=b.imageAtlas,P=C.patternPositions[T.to.toString()],M=C.patternPositions[T.from.toString()];P&&M&&w.setConstantPatternPositions(P,M)}var I=h?Fn(e,b,r,p):c?zn(e,b,r,c,p):f?jn(e,b,r,x.lineClipsArray.length):Ln(e,b,r);if(h)A.activeTexture.set(g.TEXTURE0),b.imageAtlasTexture.bind(g.LINEAR,g.CLAMP_TO_EDGE),w.updatePaintBuffers(p);else if(c&&(S||e.lineAtlas.dirty))A.activeTexture.set(g.TEXTURE0),e.lineAtlas.bind(A);else if(f){var B=x.gradients[r.id],R=B.texture;if(r.gradientVersion!==B.version){var k=256;if(r.stepInterpolant){var D=n.getSource().maxzoom,L=_.canonical.z===D?Math.ceil(1<<e.transform.maxZoom-_.canonical.z):1;k=t.clamp(t.nextPowerOfTwo(x.maxLineLength/t.EXTENT*1024*L),256,A.maxTextureSize)}B.gradient=t.renderColorRamp({expression:r.gradientExpression(),evaluationKey:"lineProgress",resolution:k,image:B.gradient||void 0,clips:x.lineClipsArray}),B.texture?B.texture.update(B.gradient):B.texture=new t.Texture(A,B.gradient,g.RGBA),B.version=r.gradientVersion,R=B.texture}A.activeTexture.set(g.TEXTURE0),R.bind(r.stepInterpolant?g.NEAREST:g.LINEAR,g.CLAMP_TO_EDGE)}O.draw(A,g.TRIANGLES,s,e.stencilModeForClipping(_),u,Ct.disabled,I,r.id,x.layoutVertexBuffer,x.indexBuffer,x.segments,r.paint,e.transform.zoom,w,x.layoutVertexBuffer2),m=!1}}}}},fill:function(e,n,r,i){var o=r.paint.get("fill-color"),a=r.paint.get("fill-opacity");if(0!==a.constantOr(1)){var s=e.colorModeForRenderPass(),u=r.paint.get("fill-pattern"),c=e.opaquePassEnabledForLayer()&&!u.constantOr(1)&&1===o.constantOr(t.Color.transparent).a&&1===a.constantOr(0)?"opaque":"translucent";if(e.renderPass===c){var l=e.depthModeForSublayer(1,"opaque"===e.renderPass?Ot.ReadWrite:Ot.ReadOnly);ir(e,n,r,i,l,s,!1)}if("translucent"===e.renderPass&&r.paint.get("fill-antialias")){var h=e.depthModeForSublayer(r.getPaintProperty("fill-outline-color")?2:0,Ot.ReadOnly);ir(e,n,r,i,h,s,!0)}}},"fill-extrusion":function(t,e,n,r){var i=n.paint.get("fill-extrusion-opacity");if(0!==i&&"translucent"===t.renderPass){var o=new Ot(t.context.gl.LEQUAL,Ot.ReadWrite,t.depthRangeFor3D);if(1!==i||n.paint.get("fill-extrusion-pattern").constantOr(1))or(t,e,n,r,o,St.disabled,Tt.disabled),or(t,e,n,r,o,t.stencilModeFor3D(),t.colorModeForRenderPass());else{var a=t.colorModeForRenderPass();or(t,e,n,r,o,St.disabled,a)}}},hillshade:function(t,e,n,r){if("offscreen"===t.renderPass||"translucent"===t.renderPass){for(var i=t.context,o=t.depthModeForSublayer(0,Ot.ReadOnly),a=t.colorModeForRenderPass(),s="translucent"===t.renderPass?t.stencilConfigForOverlap(r):[{},r],u=s[0],c=0,l=s[1];c<l.length;c+=1){var h=l[c],f=e.getTile(h);f.needsHillshadePrepare&&"offscreen"===t.renderPass?sr(t,f,n,o,St.disabled,a):"translucent"===t.renderPass&&ar(t,f,n,o,u[h.overscaledZ],a)}i.viewport.set([0,0,t.width,t.height])}},raster:function(t,e,n,r){if("translucent"===t.renderPass&&0!==n.paint.get("raster-opacity")&&r.length)for(var i=t.context,o=i.gl,a=e.getSource(),s=t.useProgram("raster"),u=t.colorModeForRenderPass(),c=a instanceof B?[{},r]:t.stencilConfigForOverlap(r),l=c[0],h=c[1],f=h[h.length-1].overscaledZ,p=!t.options.moving,d=0,A=h;d<A.length;d+=1){var g=A[d],m=t.depthModeForSublayer(g.overscaledZ-f,1===n.paint.get("raster-opacity")?Ot.ReadWrite:Ot.ReadOnly,o.LESS),y=e.getTile(g),v=t.transform.calculatePosMatrix(g.toUnwrapped(),p);y.registerFadeDuration(n.paint.get("raster-fade-duration"));var _=e.findLoadedParent(g,0),b=ur(y,_,e,n,t.transform),x=void 0,w=void 0,E="nearest"===n.paint.get("raster-resampling")?o.NEAREST:o.LINEAR;i.activeTexture.set(o.TEXTURE0),y.texture.bind(E,o.CLAMP_TO_EDGE,o.LINEAR_MIPMAP_NEAREST),i.activeTexture.set(o.TEXTURE1),_?(_.texture.bind(E,o.CLAMP_TO_EDGE,o.LINEAR_MIPMAP_NEAREST),x=Math.pow(2,_.tileID.overscaledZ-y.tileID.overscaledZ),w=[y.tileID.canonical.x*x%1,y.tileID.canonical.y*x%1]):y.texture.bind(E,o.CLAMP_TO_EDGE,o.LINEAR_MIPMAP_NEAREST);var O=Gn(v,w||[0,0],x||1,b,n);a instanceof B?s.draw(i,o.TRIANGLES,m,St.disabled,u,Ct.disabled,O,n.id,a.boundsBuffer,t.quadTriangleIndexBuffer,a.boundsSegments):s.draw(i,o.TRIANGLES,m,l[g.overscaledZ],u,Ct.disabled,O,n.id,t.rasterBoundsBuffer,t.quadTriangleIndexBuffer,t.rasterBoundsSegments)}},background:function(t,e,n){var r=n.paint.get("background-color"),i=n.paint.get("background-opacity");if(0!==i){var o=t.context,a=o.gl,s=t.transform,u=s.tileSize,c=n.paint.get("background-pattern");if(!t.isPatternMissing(c)){var l=!c&&1===r.a&&1===i&&t.opaquePassEnabledForLayer()?"opaque":"translucent";if(t.renderPass===l){var h=St.disabled,f=t.depthModeForSublayer(0,"opaque"===l?Ot.ReadWrite:Ot.ReadOnly),p=t.colorModeForRenderPass(),d=t.useProgram(c?"backgroundPattern":"background"),A=s.coveringTiles({tileSize:u});c&&(o.activeTexture.set(a.TEXTURE0),t.imageManager.bind(t.context));for(var g=n.getCrossfadeParameters(),m=0,y=A;m<y.length;m+=1){var v=y[m],_=t.transform.calculatePosMatrix(v.toUnwrapped()),b=c?Jn(_,i,t,c,{tileID:v,tileSize:u},g):Zn(_,i,r);d.draw(o,a.TRIANGLES,f,h,p,Ct.disabled,b,n.id,t.tileExtentBuffer,t.quadTriangleIndexBuffer,t.tileExtentSegments)}}}}},debug:function(t,e,n){for(var r=0;r<n.length;r++)mr(t,e,n[r])},custom:function(t,e,n){var r=t.context,i=n.implementation;if("offscreen"===t.renderPass){var o=i.prerender;o&&(t.setCustomLayerDefaults(),r.setColorMode(t.colorModeForRenderPass()),o.call(i,r.gl,t.transform.customLayerMatrix()),r.setDirty(),t.setBaseState())}else if("translucent"===t.renderPass){t.setCustomLayerDefaults(),r.setColorMode(t.colorModeForRenderPass()),r.setStencilMode(St.disabled);var a="3d"===i.renderingMode?new Ot(t.context.gl.LEQUAL,Ot.ReadWrite,t.depthRangeFor3D):t.depthModeForSublayer(0,Ot.ReadOnly);r.setDepthMode(a),i.render(r.gl,t.transform.customLayerMatrix()),r.setDirty(),t.setBaseState(),r.bindFramebuffer.set(null)}}},vr=function(t,e){this.context=new Pt(t),this.transform=e,this._tileTextures={},this.setup(),this.numSublayers=Mt.maxUnderzooming+Mt.maxOverzooming+1,this.depthEpsilon=1/Math.pow(2,16),this.crossTileSymbolIndex=new Fe,this.gpuTimers={}};vr.prototype.resize=function(e,n){if(this.width=e*t.browser.devicePixelRatio,this.height=n*t.browser.devicePixelRatio,this.context.viewport.set([0,0,this.width,this.height]),this.style)for(var r=0,i=this.style._order;r<i.length;r+=1)this.style._layers[i[r]].resize()},vr.prototype.setup=function(){var e=this.context,n=new t.StructArrayLayout2i4;n.emplaceBack(0,0),n.emplaceBack(t.EXTENT,0),n.emplaceBack(0,t.EXTENT),n.emplaceBack(t.EXTENT,t.EXTENT),this.tileExtentBuffer=e.createVertexBuffer(n,He.members),this.tileExtentSegments=t.SegmentVector.simpleSegment(0,0,4,2);var r=new t.StructArrayLayout2i4;r.emplaceBack(0,0),r.emplaceBack(t.EXTENT,0),r.emplaceBack(0,t.EXTENT),r.emplaceBack(t.EXTENT,t.EXTENT),this.debugBuffer=e.createVertexBuffer(r,He.members),this.debugSegments=t.SegmentVector.simpleSegment(0,0,4,5);var i=new t.StructArrayLayout4i8;i.emplaceBack(0,0,0,0),i.emplaceBack(t.EXTENT,0,t.EXTENT,0),i.emplaceBack(0,t.EXTENT,0,t.EXTENT),i.emplaceBack(t.EXTENT,t.EXTENT,t.EXTENT,t.EXTENT),this.rasterBoundsBuffer=e.createVertexBuffer(i,I.members),this.rasterBoundsSegments=t.SegmentVector.simpleSegment(0,0,4,2);var o=new t.StructArrayLayout2i4;o.emplaceBack(0,0),o.emplaceBack(1,0),o.emplaceBack(0,1),o.emplaceBack(1,1),this.viewportBuffer=e.createVertexBuffer(o,He.members),this.viewportSegments=t.SegmentVector.simpleSegment(0,0,4,2);var a=new t.StructArrayLayout1ui2;a.emplaceBack(0),a.emplaceBack(1),a.emplaceBack(3),a.emplaceBack(2),a.emplaceBack(0),this.tileBorderIndexBuffer=e.createIndexBuffer(a);var s=new t.StructArrayLayout3ui6;s.emplaceBack(0,1,2),s.emplaceBack(2,1,3),this.quadTriangleIndexBuffer=e.createIndexBuffer(s),this.emptyTexture=new t.Texture(e,{width:1,height:1,data:new Uint8Array([0,0,0,0])},e.gl.RGBA);var u=this.context.gl;this.stencilClearMode=new St({func:u.ALWAYS,mask:0},0,255,u.ZERO,u.ZERO,u.ZERO)},vr.prototype.clearStencil=function(){var e=this.context,n=e.gl;this.nextStencilID=1,this.currentStencilSource=void 0;var r=t.create();t.ortho(r,0,this.width,this.height,0,0,1),t.scale(r,r,[n.drawingBufferWidth,n.drawingBufferHeight,0]),this.useProgram("clippingMask").draw(e,n.TRIANGLES,Ot.disabled,this.stencilClearMode,Tt.disabled,Ct.disabled,kn(r),"$clipping",this.viewportBuffer,this.quadTriangleIndexBuffer,this.viewportSegments)},vr.prototype._renderTileClippingMasks=function(t,e){if(this.currentStencilSource!==t.source&&t.isTileClipped()&&e&&e.length){this.currentStencilSource=t.source;var n=this.context,r=n.gl;this.nextStencilID+e.length>256&&this.clearStencil(),n.setColorMode(Tt.disabled),n.setDepthMode(Ot.disabled);var i=this.useProgram("clippingMask");this._tileClippingMaskIDs={};for(var o=0,a=e;o<a.length;o+=1){var s=a[o],u=this._tileClippingMaskIDs[s.key]=this.nextStencilID++;i.draw(n,r.TRIANGLES,Ot.disabled,new St({func:r.ALWAYS,mask:0},u,255,r.KEEP,r.KEEP,r.REPLACE),Tt.disabled,Ct.disabled,kn(s.posMatrix),"$clipping",this.tileExtentBuffer,this.quadTriangleIndexBuffer,this.tileExtentSegments)}}},vr.prototype.stencilModeFor3D=function(){this.currentStencilSource=void 0,this.nextStencilID+1>256&&this.clearStencil();var t=this.nextStencilID++,e=this.context.gl;return new St({func:e.NOTEQUAL,mask:255},t,255,e.KEEP,e.KEEP,e.REPLACE)},vr.prototype.stencilModeForClipping=function(t){var e=this.context.gl;return new St({func:e.EQUAL,mask:255},this._tileClippingMaskIDs[t.key],0,e.KEEP,e.KEEP,e.REPLACE)},vr.prototype.stencilConfigForOverlap=function(t){var e,n=this.context.gl,r=t.sort((function(t,e){return e.overscaledZ-t.overscaledZ})),i=r[r.length-1].overscaledZ,o=r[0].overscaledZ-i+1;if(o>1){this.currentStencilSource=void 0,this.nextStencilID+o>256&&this.clearStencil();for(var a={},s=0;s<o;s++)a[s+i]=new St({func:n.GEQUAL,mask:255},s+this.nextStencilID,255,n.KEEP,n.KEEP,n.REPLACE);return this.nextStencilID+=o,[a,r]}return[(e={},e[i]=St.disabled,e),r]},vr.prototype.colorModeForRenderPass=function(){var e=this.context.gl;return this._showOverdrawInspector?new Tt([e.CONSTANT_COLOR,e.ONE],new t.Color(1/8,1/8,1/8,0),[!0,!0,!0,!0]):"opaque"===this.renderPass?Tt.unblended:Tt.alphaBlended},vr.prototype.depthModeForSublayer=function(t,e,n){if(!this.opaquePassEnabledForLayer())return Ot.disabled;var r=1-((1+this.currentLayer)*this.numSublayers+t)*this.depthEpsilon;return new Ot(n||this.context.gl.LEQUAL,e,[r,r])},vr.prototype.opaquePassEnabledForLayer=function(){return this.currentLayer<this.opaquePassCutoff},vr.prototype.render=function(e,n){var r=this;this.style=e,this.options=n,this.lineAtlas=e.lineAtlas,this.imageManager=e.imageManager,this.glyphManager=e.glyphManager,this.symbolFadeChange=e.placement.symbolFadeChange(t.browser.now()),this.imageManager.beginFrame();var i=this.style._order,o=this.style.sourceCaches;for(var a in o){var s=o[a];s.used&&s.prepare(this.context)}var u,c,l={},h={},f={};for(var p in o){var d=o[p];l[p]=d.getVisibleCoordinates(),h[p]=l[p].slice().reverse(),f[p]=d.getVisibleCoordinates(!0).reverse()}this.opaquePassCutoff=1/0;for(var A=0;A<i.length;A++)if(this.style._layers[i[A]].is3D()){this.opaquePassCutoff=A;break}this.renderPass="offscreen";for(var g=0,m=i;g<m.length;g+=1){var y=this.style._layers[m[g]];if(y.hasOffscreenPass()&&!y.isHidden(this.transform.zoom)){var v=h[y.source];("custom"===y.type||v.length)&&this.renderLayer(this,o[y.source],y,v)}}for(this.context.bindFramebuffer.set(null),this.context.clear({color:n.showOverdrawInspector?t.Color.black:t.Color.transparent,depth:1}),this.clearStencil(),this._showOverdrawInspector=n.showOverdrawInspector,this.depthRangeFor3D=[0,1-(e._order.length+2)*this.numSublayers*this.depthEpsilon],this.renderPass="opaque",this.currentLayer=i.length-1;this.currentLayer>=0;this.currentLayer--){var _=this.style._layers[i[this.currentLayer]],b=o[_.source],x=l[_.source];this._renderTileClippingMasks(_,x),this.renderLayer(this,b,_,x)}for(this.renderPass="translucent",this.currentLayer=0;this.currentLayer<i.length;this.currentLayer++){var w=this.style._layers[i[this.currentLayer]],E=o[w.source],O=("symbol"===w.type?f:h)[w.source];this._renderTileClippingMasks(w,l[w.source]),this.renderLayer(this,E,w,O)}this.options.showTileBoundaries&&(t.values(this.style._layers).forEach((function(t){t.source&&!t.isHidden(r.transform.zoom)&&(t.source!==(c&&c.id)&&(c=r.style.sourceCaches[t.source]),(!u||u.getSource().maxzoom<c.getSource().maxzoom)&&(u=c))})),u&&yr.debug(this,u,u.getVisibleCoordinates())),this.options.showPadding&&function(t){var e=t.transform.padding;dr(t,t.transform.height-(e.top||0),3,cr),dr(t,e.bottom||0,3,lr),Ar(t,e.left||0,3,hr),Ar(t,t.transform.width-(e.right||0),3,fr);var n=t.transform.centerPoint;!function(t,e,n,r){gr(t,e-1,n-10,2,20,r),gr(t,e-10,n-1,20,2,r)}(t,n.x,t.transform.height-n.y,pr)}(this),this.context.setDefault()},vr.prototype.renderLayer=function(t,e,n,r){n.isHidden(this.transform.zoom)||("background"===n.type||"custom"===n.type||r.length)&&(this.id=n.id,this.gpuTimingStart(n),yr[n.type](t,e,n,r,this.style.placement.variableOffsets),this.gpuTimingEnd())},vr.prototype.gpuTimingStart=function(t){if(this.options.gpuTiming){var e=this.context.extTimerQuery,n=this.gpuTimers[t.id];n||(n=this.gpuTimers[t.id]={calls:0,cpuTime:0,query:e.createQueryEXT()}),n.calls++,e.beginQueryEXT(e.TIME_ELAPSED_EXT,n.query)}},vr.prototype.gpuTimingEnd=function(){if(this.options.gpuTiming){var t=this.context.extTimerQuery;t.endQueryEXT(t.TIME_ELAPSED_EXT)}},vr.prototype.collectGpuTimers=function(){var t=this.gpuTimers;return this.gpuTimers={},t},vr.prototype.queryGpuTimers=function(t){var e={};for(var n in t){var r=t[n],i=this.context.extTimerQuery,o=i.getQueryObjectEXT(r.query,i.QUERY_RESULT_EXT)/1e6;i.deleteQueryEXT(r.query),e[n]=o}return e},vr.prototype.translatePosMatrix=function(e,n,r,i,o){if(!r[0]&&!r[1])return e;var a=o?"map"===i?this.transform.angle:0:"viewport"===i?-this.transform.angle:0;if(a){var s=Math.sin(a),u=Math.cos(a);r=[r[0]*u-r[1]*s,r[0]*s+r[1]*u]}var c=[o?r[0]:fe(n,r[0],this.transform.zoom),o?r[1]:fe(n,r[1],this.transform.zoom),0],l=new Float32Array(16);return t.translate(l,e,c),l},vr.prototype.saveTileTexture=function(t){var e=this._tileTextures[t.size[0]];e?e.push(t):this._tileTextures[t.size[0]]=[t]},vr.prototype.getTileTexture=function(t){var e=this._tileTextures[t];return e&&e.length>0?e.pop():null},vr.prototype.isPatternMissing=function(t){if(!t)return!1;if(!t.from||!t.to)return!0;var e=this.imageManager.getPattern(t.from.toString()),n=this.imageManager.getPattern(t.to.toString());return!e||!n},vr.prototype.useProgram=function(t,e){this.cache=this.cache||{};var n=""+t+(e?e.cacheKey:"")+(this._showOverdrawInspector?"/overdraw":"");return this.cache[n]||(this.cache[n]=new xn(this.context,t,vn[t],e,Qn[t],this._showOverdrawInspector)),this.cache[n]},vr.prototype.setCustomLayerDefaults=function(){this.context.unbindVAO(),this.context.cullFace.setDefault(),this.context.activeTexture.setDefault(),this.context.pixelStoreUnpack.setDefault(),this.context.pixelStoreUnpackPremultiplyAlpha.setDefault(),this.context.pixelStoreUnpackFlipY.setDefault()},vr.prototype.setBaseState=function(){var t=this.context.gl;this.context.cullFace.set(!1),this.context.viewport.set([0,0,this.width,this.height]),this.context.blendEquation.set(t.FUNC_ADD)},vr.prototype.initDebugOverlayCanvas=function(){null==this.debugOverlayCanvas&&(this.debugOverlayCanvas=t.window.document.createElement("canvas"),this.debugOverlayCanvas.width=512,this.debugOverlayCanvas.height=512,this.debugOverlayTexture=new t.Texture(this.context,this.debugOverlayCanvas,this.context.gl.RGBA))},vr.prototype.destroy=function(){this.emptyTexture.destroy(),this.debugOverlayTexture&&this.debugOverlayTexture.destroy()};var _r=function(t,e){this.points=t,this.planes=e};_r.fromInvProjectionMatrix=function(e,n,r){var i=Math.pow(2,r),o=[[-1,1,-1,1],[1,1,-1,1],[1,-1,-1,1],[-1,-1,-1,1],[-1,1,1,1],[1,1,1,1],[1,-1,1,1],[-1,-1,1,1]].map((function(n){return t.transformMat4([],n,e)})).map((function(e){return t.scale$1([],e,1/e[3]/n*i)})),a=[[0,1,2],[6,5,4],[0,3,7],[2,1,5],[3,2,6],[0,4,5]].map((function(e){var n=t.sub([],o[e[0]],o[e[1]]),r=t.sub([],o[e[2]],o[e[1]]),i=t.normalize([],t.cross([],n,r)),a=-t.dot(i,o[e[1]]);return i.concat(a)}));return new _r(o,a)};var br=function(e,n){this.min=e,this.max=n,this.center=t.scale$2([],t.add([],this.min,this.max),.5)};br.prototype.quadrant=function(e){for(var n=[e%2==0,e<2],r=t.clone$2(this.min),i=t.clone$2(this.max),o=0;o<n.length;o++)r[o]=n[o]?this.min[o]:this.center[o],i[o]=n[o]?this.center[o]:this.max[o];return i[2]=this.max[2],new br(r,i)},br.prototype.distanceX=function(t){return Math.max(Math.min(this.max[0],t[0]),this.min[0])-t[0]},br.prototype.distanceY=function(t){return Math.max(Math.min(this.max[1],t[1]),this.min[1])-t[1]},br.prototype.intersects=function(e){for(var n=[[this.min[0],this.min[1],0,1],[this.max[0],this.min[1],0,1],[this.max[0],this.max[1],0,1],[this.min[0],this.max[1],0,1]],r=!0,i=0;i<e.planes.length;i++){for(var o=e.planes[i],a=0,s=0;s<n.length;s++)a+=t.dot$1(o,n[s])>=0;if(0===a)return 0;a!==n.length&&(r=!1)}if(r)return 2;for(var u=0;u<3;u++){for(var c=Number.MAX_VALUE,l=-Number.MAX_VALUE,h=0;h<e.points.length;h++){var f=e.points[h][u]-this.min[u];c=Math.min(c,f),l=Math.max(l,f)}if(l<0||c>this.max[u]-this.min[u])return 0}return 1};var xr=function(t,e,n,r){if(void 0===t&&(t=0),void 0===e&&(e=0),void 0===n&&(n=0),void 0===r&&(r=0),isNaN(t)||t<0||isNaN(e)||e<0||isNaN(n)||n<0||isNaN(r)||r<0)throw new Error("Invalid value for edge-insets, top, bottom, left and right must all be numbers");this.top=t,this.bottom=e,this.left=n,this.right=r};xr.prototype.interpolate=function(e,n,r){return null!=n.top&&null!=e.top&&(this.top=t.number(e.top,n.top,r)),null!=n.bottom&&null!=e.bottom&&(this.bottom=t.number(e.bottom,n.bottom,r)),null!=n.left&&null!=e.left&&(this.left=t.number(e.left,n.left,r)),null!=n.right&&null!=e.right&&(this.right=t.number(e.right,n.right,r)),this},xr.prototype.getCenter=function(e,n){var r=t.clamp((this.left+e-this.right)/2,0,e),i=t.clamp((this.top+n-this.bottom)/2,0,n);return new t.Point(r,i)},xr.prototype.equals=function(t){return this.top===t.top&&this.bottom===t.bottom&&this.left===t.left&&this.right===t.right},xr.prototype.clone=function(){return new xr(this.top,this.bottom,this.left,this.right)},xr.prototype.toJSON=function(){return{top:this.top,bottom:this.bottom,left:this.left,right:this.right}};var wr=function(e,n,r,i,o){this.tileSize=512,this.maxValidLatitude=85.051129,this._renderWorldCopies=void 0===o||o,this._minZoom=e||0,this._maxZoom=n||22,this._minPitch=null==r?0:r,this._maxPitch=null==i?60:i,this.setMaxBounds(),this.width=0,this.height=0,this._center=new t.LngLat(0,0),this.zoom=0,this.angle=0,this._fov=.6435011087932844,this._pitch=0,this._unmodified=!0,this._edgeInsets=new xr,this._posMatrixCache={},this._alignedPosMatrixCache={}},Er={minZoom:{configurable:!0},maxZoom:{configurable:!0},minPitch:{configurable:!0},maxPitch:{configurable:!0},renderWorldCopies:{configurable:!0},worldSize:{configurable:!0},centerOffset:{configurable:!0},size:{configurable:!0},bearing:{configurable:!0},pitch:{configurable:!0},fov:{configurable:!0},zoom:{configurable:!0},center:{configurable:!0},padding:{configurable:!0},centerPoint:{configurable:!0},unmodified:{configurable:!0},point:{configurable:!0}};wr.prototype.clone=function(){var t=new wr(this._minZoom,this._maxZoom,this._minPitch,this.maxPitch,this._renderWorldCopies);return t.tileSize=this.tileSize,t.latRange=this.latRange,t.width=this.width,t.height=this.height,t._center=this._center,t.zoom=this.zoom,t.angle=this.angle,t._fov=this._fov,t._pitch=this._pitch,t._unmodified=this._unmodified,t._edgeInsets=this._edgeInsets.clone(),t._calcMatrices(),t},Er.minZoom.get=function(){return this._minZoom},Er.minZoom.set=function(t){this._minZoom!==t&&(this._minZoom=t,this.zoom=Math.max(this.zoom,t))},Er.maxZoom.get=function(){return this._maxZoom},Er.maxZoom.set=function(t){this._maxZoom!==t&&(this._maxZoom=t,this.zoom=Math.min(this.zoom,t))},Er.minPitch.get=function(){return this._minPitch},Er.minPitch.set=function(t){this._minPitch!==t&&(this._minPitch=t,this.pitch=Math.max(this.pitch,t))},Er.maxPitch.get=function(){return this._maxPitch},Er.maxPitch.set=function(t){this._maxPitch!==t&&(this._maxPitch=t,this.pitch=Math.min(this.pitch,t))},Er.renderWorldCopies.get=function(){return this._renderWorldCopies},Er.renderWorldCopies.set=function(t){void 0===t?t=!0:null===t&&(t=!1),this._renderWorldCopies=t},Er.worldSize.get=function(){return this.tileSize*this.scale},Er.centerOffset.get=function(){return this.centerPoint._sub(this.size._div(2))},Er.size.get=function(){return new t.Point(this.width,this.height)},Er.bearing.get=function(){return-this.angle/Math.PI*180},Er.bearing.set=function(e){var n=-t.wrap(e,-180,180)*Math.PI/180;this.angle!==n&&(this._unmodified=!1,this.angle=n,this._calcMatrices(),this.rotationMatrix=t.create$2(),t.rotate(this.rotationMatrix,this.rotationMatrix,this.angle))},Er.pitch.get=function(){return this._pitch/Math.PI*180},Er.pitch.set=function(e){var n=t.clamp(e,this.minPitch,this.maxPitch)/180*Math.PI;this._pitch!==n&&(this._unmodified=!1,this._pitch=n,this._calcMatrices())},Er.fov.get=function(){return this._fov/Math.PI*180},Er.fov.set=function(t){t=Math.max(.01,Math.min(60,t)),this._fov!==t&&(this._unmodified=!1,this._fov=t/180*Math.PI,this._calcMatrices())},Er.zoom.get=function(){return this._zoom},Er.zoom.set=function(t){var e=Math.min(Math.max(t,this.minZoom),this.maxZoom);this._zoom!==e&&(this._unmodified=!1,this._zoom=e,this.scale=this.zoomScale(e),this.tileZoom=Math.floor(e),this.zoomFraction=e-this.tileZoom,this._constrain(),this._calcMatrices())},Er.center.get=function(){return this._center},Er.center.set=function(t){t.lat===this._center.lat&&t.lng===this._center.lng||(this._unmodified=!1,this._center=t,this._constrain(),this._calcMatrices())},Er.padding.get=function(){return this._edgeInsets.toJSON()},Er.padding.set=function(t){this._edgeInsets.equals(t)||(this._unmodified=!1,this._edgeInsets.interpolate(this._edgeInsets,t,1),this._calcMatrices())},Er.centerPoint.get=function(){return this._edgeInsets.getCenter(this.width,this.height)},wr.prototype.isPaddingEqual=function(t){return this._edgeInsets.equals(t)},wr.prototype.interpolatePadding=function(t,e,n){this._unmodified=!1,this._edgeInsets.interpolate(t,e,n),this._constrain(),this._calcMatrices()},wr.prototype.coveringZoomLevel=function(t){var e=(t.roundZoom?Math.round:Math.floor)(this.zoom+this.scaleZoom(this.tileSize/t.tileSize));return Math.max(0,e)},wr.prototype.getVisibleUnwrappedCoordinates=function(e){var n=[new t.UnwrappedTileID(0,e)];if(this._renderWorldCopies)for(var r=this.pointCoordinate(new t.Point(0,0)),i=this.pointCoordinate(new t.Point(this.width,0)),o=this.pointCoordinate(new t.Point(this.width,this.height)),a=this.pointCoordinate(new t.Point(0,this.height)),s=Math.floor(Math.min(r.x,i.x,o.x,a.x)),u=Math.floor(Math.max(r.x,i.x,o.x,a.x)),c=s-1;c<=u+1;c++)0!==c&&n.push(new t.UnwrappedTileID(c,e));return n},wr.prototype.coveringTiles=function(e){var n=this.coveringZoomLevel(e),r=n;if(void 0!==e.minzoom&&n<e.minzoom)return[];void 0!==e.maxzoom&&n>e.maxzoom&&(n=e.maxzoom);var i=t.MercatorCoordinate.fromLngLat(this.center),o=Math.pow(2,n),a=[o*i.x,o*i.y,0],s=_r.fromInvProjectionMatrix(this.invProjMatrix,this.worldSize,n),u=e.minzoom||0;this.pitch<=60&&this._edgeInsets.top<.1&&(u=n);var c=function(t){return{aabb:new br([t*o,0,0],[(t+1)*o,o,0]),zoom:0,x:0,y:0,wrap:t,fullyVisible:!1}},l=[],h=[],f=n,p=e.reparseOverscaled?r:n;if(this._renderWorldCopies)for(var d=1;d<=3;d++)l.push(c(-d)),l.push(c(d));for(l.push(c(0));l.length>0;){var A=l.pop(),g=A.x,m=A.y,y=A.fullyVisible;if(!y){var v=A.aabb.intersects(s);if(0===v)continue;y=2===v}var _=A.aabb.distanceX(a),b=A.aabb.distanceY(a),x=Math.max(Math.abs(_),Math.abs(b));if(A.zoom===f||x>3+(1<<f-A.zoom)-2&&A.zoom>=u)h.push({tileID:new t.OverscaledTileID(A.zoom===f?p:A.zoom,A.wrap,A.zoom,g,m),distanceSq:t.sqrLen([a[0]-.5-g,a[1]-.5-m])});else for(var w=0;w<4;w++){var E=(g<<1)+w%2,O=(m<<1)+(w>>1);l.push({aabb:A.aabb.quadrant(w),zoom:A.zoom+1,x:E,y:O,wrap:A.wrap,fullyVisible:y})}}return h.sort((function(t,e){return t.distanceSq-e.distanceSq})).map((function(t){return t.tileID}))},wr.prototype.resize=function(t,e){this.width=t,this.height=e,this.pixelsToGLUnits=[2/t,-2/e],this._constrain(),this._calcMatrices()},Er.unmodified.get=function(){return this._unmodified},wr.prototype.zoomScale=function(t){return Math.pow(2,t)},wr.prototype.scaleZoom=function(t){return Math.log(t)/Math.LN2},wr.prototype.project=function(e){var n=t.clamp(e.lat,-this.maxValidLatitude,this.maxValidLatitude);return new t.Point(t.mercatorXfromLng(e.lng)*this.worldSize,t.mercatorYfromLat(n)*this.worldSize)},wr.prototype.unproject=function(e){return new t.MercatorCoordinate(e.x/this.worldSize,e.y/this.worldSize).toLngLat()},Er.point.get=function(){return this.project(this.center)},wr.prototype.setLocationAtPoint=function(e,n){var r=this.pointCoordinate(n),i=this.pointCoordinate(this.centerPoint),o=this.locationCoordinate(e),a=new t.MercatorCoordinate(o.x-(r.x-i.x),o.y-(r.y-i.y));this.center=this.coordinateLocation(a),this._renderWorldCopies&&(this.center=this.center.wrap())},wr.prototype.locationPoint=function(t){return this.coordinatePoint(this.locationCoordinate(t))},wr.prototype.pointLocation=function(t){return this.coordinateLocation(this.pointCoordinate(t))},wr.prototype.locationCoordinate=function(e){return t.MercatorCoordinate.fromLngLat(e)},wr.prototype.coordinateLocation=function(t){return t.toLngLat()},wr.prototype.pointCoordinate=function(e){var n=[e.x,e.y,0,1],r=[e.x,e.y,1,1];t.transformMat4(n,n,this.pixelMatrixInverse),t.transformMat4(r,r,this.pixelMatrixInverse);var i=n[3],o=r[3],a=n[1]/i,s=r[1]/o,u=n[2]/i,c=r[2]/o,l=u===c?0:(0-u)/(c-u);return new t.MercatorCoordinate(t.number(n[0]/i,r[0]/o,l)/this.worldSize,t.number(a,s,l)/this.worldSize)},wr.prototype.coordinatePoint=function(e){var n=[e.x*this.worldSize,e.y*this.worldSize,0,1];return t.transformMat4(n,n,this.pixelMatrix),new t.Point(n[0]/n[3],n[1]/n[3])},wr.prototype.getBounds=function(){return(new t.LngLatBounds).extend(this.pointLocation(new t.Point(0,0))).extend(this.pointLocation(new t.Point(this.width,0))).extend(this.pointLocation(new t.Point(this.width,this.height))).extend(this.pointLocation(new t.Point(0,this.height)))},wr.prototype.getMaxBounds=function(){return this.latRange&&2===this.latRange.length&&this.lngRange&&2===this.lngRange.length?new t.LngLatBounds([this.lngRange[0],this.latRange[0]],[this.lngRange[1],this.latRange[1]]):null},wr.prototype.setMaxBounds=function(t){t?(this.lngRange=[t.getWest(),t.getEast()],this.latRange=[t.getSouth(),t.getNorth()],this._constrain()):(this.lngRange=null,this.latRange=[-this.maxValidLatitude,this.maxValidLatitude])},wr.prototype.calculatePosMatrix=function(e,n){void 0===n&&(n=!1);var r=e.key,i=n?this._alignedPosMatrixCache:this._posMatrixCache;if(i[r])return i[r];var o=e.canonical,a=this.worldSize/this.zoomScale(o.z),s=o.x+Math.pow(2,o.z)*e.wrap,u=t.identity(new Float64Array(16));return t.translate(u,u,[s*a,o.y*a,0]),t.scale(u,u,[a/t.EXTENT,a/t.EXTENT,1]),t.multiply(u,n?this.alignedProjMatrix:this.projMatrix,u),i[r]=new Float32Array(u),i[r]},wr.prototype.customLayerMatrix=function(){return this.mercatorMatrix.slice()},wr.prototype._constrain=function(){if(this.center&&this.width&&this.height&&!this._constraining){this._constraining=!0;var e,n,r,i,o=-90,a=90,s=-180,u=180,c=this.size,l=this._unmodified;if(this.latRange){var h=this.latRange;o=t.mercatorYfromLat(h[1])*this.worldSize,e=(a=t.mercatorYfromLat(h[0])*this.worldSize)-o<c.y?c.y/(a-o):0}if(this.lngRange){var f=this.lngRange;s=t.mercatorXfromLng(f[0])*this.worldSize,n=(u=t.mercatorXfromLng(f[1])*this.worldSize)-s<c.x?c.x/(u-s):0}var p=this.point,d=Math.max(n||0,e||0);if(d)return this.center=this.unproject(new t.Point(n?(u+s)/2:p.x,e?(a+o)/2:p.y)),this.zoom+=this.scaleZoom(d),this._unmodified=l,void(this._constraining=!1);if(this.latRange){var A=p.y,g=c.y/2;A-g<o&&(i=o+g),A+g>a&&(i=a-g)}if(this.lngRange){var m=p.x,y=c.x/2;m-y<s&&(r=s+y),m+y>u&&(r=u-y)}void 0===r&&void 0===i||(this.center=this.unproject(new t.Point(void 0!==r?r:p.x,void 0!==i?i:p.y))),this._unmodified=l,this._constraining=!1}},wr.prototype._calcMatrices=function(){if(this.height){var e=this.centerOffset;this.cameraToCenterDistance=.5/Math.tan(this._fov/2)*this.height;var n=Math.PI/2+this._pitch,r=this._fov*(.5+e.y/this.height),i=Math.sin(r)*this.cameraToCenterDistance/Math.sin(t.clamp(Math.PI-n-r,.01,Math.PI-.01)),o=this.point,a=o.x,s=o.y,u=1.01*(Math.cos(Math.PI/2-this._pitch)*i+this.cameraToCenterDistance),c=this.height/50,l=new Float64Array(16);t.perspective(l,this._fov,this.width/this.height,c,u),l[8]=2*-e.x/this.width,l[9]=2*e.y/this.height,t.scale(l,l,[1,-1,1]),t.translate(l,l,[0,0,-this.cameraToCenterDistance]),t.rotateX(l,l,this._pitch),t.rotateZ(l,l,this.angle),t.translate(l,l,[-a,-s,0]),this.mercatorMatrix=t.scale([],l,[this.worldSize,this.worldSize,this.worldSize]),t.scale(l,l,[1,1,t.mercatorZfromAltitude(1,this.center.lat)*this.worldSize,1]),this.projMatrix=l,this.invProjMatrix=t.invert([],this.projMatrix);var h=this.width%2/2,f=this.height%2/2,p=Math.cos(this.angle),d=Math.sin(this.angle),A=a-Math.round(a)+p*h+d*f,g=s-Math.round(s)+p*f+d*h,m=new Float64Array(l);if(t.translate(m,m,[A>.5?A-1:A,g>.5?g-1:g,0]),this.alignedProjMatrix=m,l=t.create(),t.scale(l,l,[this.width/2,-this.height/2,1]),t.translate(l,l,[1,-1,0]),this.labelPlaneMatrix=l,l=t.create(),t.scale(l,l,[1,-1,1]),t.translate(l,l,[-1,-1,0]),t.scale(l,l,[2/this.width,2/this.height,1]),this.glCoordMatrix=l,this.pixelMatrix=t.multiply(new Float64Array(16),this.labelPlaneMatrix,this.projMatrix),!(l=t.invert(new Float64Array(16),this.pixelMatrix)))throw new Error("failed to invert matrix");this.pixelMatrixInverse=l,this._posMatrixCache={},this._alignedPosMatrixCache={}}},wr.prototype.maxPitchScaleFactor=function(){if(!this.pixelMatrixInverse)return 1;var e=this.pointCoordinate(new t.Point(0,0)),n=[e.x*this.worldSize,e.y*this.worldSize,0,1];return t.transformMat4(n,n,this.pixelMatrix)[3]/this.cameraToCenterDistance},wr.prototype.getCameraPoint=function(){var e=Math.tan(this._pitch)*(this.cameraToCenterDistance||1);return this.centerPoint.add(new t.Point(0,e))},wr.prototype.getCameraQueryGeometry=function(e){var n=this.getCameraPoint();if(1===e.length)return[e[0],n];for(var r=n.x,i=n.y,o=n.x,a=n.y,s=0,u=e;s<u.length;s+=1){var c=u[s];r=Math.min(r,c.x),i=Math.min(i,c.y),o=Math.max(o,c.x),a=Math.max(a,c.y)}return[new t.Point(r,i),new t.Point(o,i),new t.Point(o,a),new t.Point(r,a),new t.Point(r,i)]},Object.defineProperties(wr.prototype,Er);var Or=function(e){var n,r,i,o;this._hashName=e&&encodeURIComponent(e),t.bindAll(["_getCurrentHash","_onHashChange","_updateHash"],this),this._updateHash=(n=this._updateHashUnthrottled.bind(this),r=!1,i=null,o=function(){i=null,r&&(n(),i=setTimeout(o,300),r=!1)},function(){return r=!0,i||o(),i})};Or.prototype.addTo=function(e){return this._map=e,t.window.addEventListener("hashchange",this._onHashChange,!1),this._map.on("moveend",this._updateHash),this},Or.prototype.remove=function(){return t.window.removeEventListener("hashchange",this._onHashChange,!1),this._map.off("moveend",this._updateHash),clearTimeout(this._updateHash()),delete this._map,this},Or.prototype.getHashString=function(e){var n=this._map.getCenter(),r=Math.round(100*this._map.getZoom())/100,i=Math.ceil((r*Math.LN2+Math.log(512/360/.5))/Math.LN10),o=Math.pow(10,i),a=Math.round(n.lng*o)/o,s=Math.round(n.lat*o)/o,u=this._map.getBearing(),c=this._map.getPitch(),l="";if(l+=e?"/"+a+"/"+s+"/"+r:r+"/"+s+"/"+a,(u||c)&&(l+="/"+Math.round(10*u)/10),c&&(l+="/"+Math.round(c)),this._hashName){var h=this._hashName,f=!1,p=t.window.location.hash.slice(1).split("&").map((function(t){var e=t.split("=")[0];return e===h?(f=!0,e+"="+l):t})).filter((function(t){return t}));return f||p.push(h+"="+l),"#"+p.join("&")}return"#"+l},Or.prototype._getCurrentHash=function(){var e,n=this,r=t.window.location.hash.replace("#","");return this._hashName?(r.split("&").map((function(t){return t.split("=")})).forEach((function(t){t[0]===n._hashName&&(e=t)})),(e&&e[1]||"").split("/")):r.split("/")},Or.prototype._onHashChange=function(){var t=this._getCurrentHash();if(t.length>=3&&!t.some((function(t){return isNaN(t)}))){var e=this._map.dragRotate.isEnabled()&&this._map.touchZoomRotate.isEnabled()?+(t[3]||0):this._map.getBearing();return this._map.jumpTo({center:[+t[2],+t[1]],zoom:+t[0],bearing:e,pitch:+(t[4]||0)}),!0}return!1},Or.prototype._updateHashUnthrottled=function(){var e=t.window.location.href.replace(/(#.+)?$/,this.getHashString());try{t.window.history.replaceState(t.window.history.state,null,e)}catch(t){}};var Sr={linearity:.3,easing:t.bezier(0,0,.3,1)},Tr=t.extend({deceleration:2500,maxSpeed:1400},Sr),Cr=t.extend({deceleration:20,maxSpeed:1400},Sr),Pr=t.extend({deceleration:1e3,maxSpeed:360},Sr),Mr=t.extend({deceleration:1e3,maxSpeed:90},Sr),Ir=function(t){this._map=t,this.clear()};function Br(t,e){(!t.duration||t.duration<e.duration)&&(t.duration=e.duration,t.easing=e.easing)}function Rr(e,n,r){var i=r.maxSpeed,o=r.linearity,a=r.deceleration,s=t.clamp(e*o/(n/1e3),-i,i),u=Math.abs(s)/(a*o);return{easing:r.easing,duration:1e3*u,amount:s*(u/2)}}Ir.prototype.clear=function(){this._inertiaBuffer=[]},Ir.prototype.record=function(e){this._drainInertiaBuffer(),this._inertiaBuffer.push({time:t.browser.now(),settings:e})},Ir.prototype._drainInertiaBuffer=function(){for(var e=this._inertiaBuffer,n=t.browser.now();e.length>0&&n-e[0].time>160;)e.shift()},Ir.prototype._onMoveEnd=function(e){if(this._drainInertiaBuffer(),!(this._inertiaBuffer.length<2)){for(var n={zoom:0,bearing:0,pitch:0,pan:new t.Point(0,0),pinchAround:void 0,around:void 0},r=0,i=this._inertiaBuffer;r<i.length;r+=1){var o=i[r].settings;n.zoom+=o.zoomDelta||0,n.bearing+=o.bearingDelta||0,n.pitch+=o.pitchDelta||0,o.panDelta&&n.pan._add(o.panDelta),o.around&&(n.around=o.around),o.pinchAround&&(n.pinchAround=o.pinchAround)}var a=this._inertiaBuffer[this._inertiaBuffer.length-1].time-this._inertiaBuffer[0].time,s={};if(n.pan.mag()){var u=Rr(n.pan.mag(),a,t.extend({},Tr,e||{}));s.offset=n.pan.mult(u.amount/n.pan.mag()),s.center=this._map.transform.center,Br(s,u)}if(n.zoom){var c=Rr(n.zoom,a,Cr);s.zoom=this._map.transform.zoom+c.amount,Br(s,c)}if(n.bearing){var l=Rr(n.bearing,a,Pr);s.bearing=this._map.transform.bearing+t.clamp(l.amount,-179,179),Br(s,l)}if(n.pitch){var h=Rr(n.pitch,a,Mr);s.pitch=this._map.transform.pitch+h.amount,Br(s,h)}if(s.zoom||s.bearing){var f=void 0===n.pinchAround?n.around:n.pinchAround;s.around=f?this._map.unproject(f):this._map.getCenter()}return this.clear(),t.extend(s,{noMoveStart:!0})}};var kr=function(e){function r(r,i,o,a){void 0===a&&(a={});var s=n.mousePos(i.getCanvasContainer(),o),u=i.unproject(s);e.call(this,r,t.extend({point:s,lngLat:u,originalEvent:o},a)),this._defaultPrevented=!1,this.target=i}e&&(r.__proto__=e),(r.prototype=Object.create(e&&e.prototype)).constructor=r;var i={defaultPrevented:{configurable:!0}};return r.prototype.preventDefault=function(){this._defaultPrevented=!0},i.defaultPrevented.get=function(){return this._defaultPrevented},Object.defineProperties(r.prototype,i),r}(t.Event),Dr=function(e){function r(r,i,o){var a="touchend"===r?o.changedTouches:o.touches,s=n.touchPos(i.getCanvasContainer(),a),u=s.map((function(t){return i.unproject(t)})),c=s.reduce((function(t,e,n,r){return t.add(e.div(r.length))}),new t.Point(0,0)),l=i.unproject(c);e.call(this,r,{points:s,point:c,lngLats:u,lngLat:l,originalEvent:o}),this._defaultPrevented=!1}e&&(r.__proto__=e),(r.prototype=Object.create(e&&e.prototype)).constructor=r;var i={defaultPrevented:{configurable:!0}};return r.prototype.preventDefault=function(){this._defaultPrevented=!0},i.defaultPrevented.get=function(){return this._defaultPrevented},Object.defineProperties(r.prototype,i),r}(t.Event),Lr=function(t){function e(e,n,r){t.call(this,e,{originalEvent:r}),this._defaultPrevented=!1}t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e;var n={defaultPrevented:{configurable:!0}};return e.prototype.preventDefault=function(){this._defaultPrevented=!0},n.defaultPrevented.get=function(){return this._defaultPrevented},Object.defineProperties(e.prototype,n),e}(t.Event),jr=function(t,e){this._map=t,this._clickTolerance=e.clickTolerance};jr.prototype.reset=function(){delete this._mousedownPos},jr.prototype.wheel=function(t){return this._firePreventable(new Lr(t.type,this._map,t))},jr.prototype.mousedown=function(t,e){return this._mousedownPos=e,this._firePreventable(new kr(t.type,this._map,t))},jr.prototype.mouseup=function(t){this._map.fire(new kr(t.type,this._map,t))},jr.prototype.click=function(t,e){this._mousedownPos&&this._mousedownPos.dist(e)>=this._clickTolerance||this._map.fire(new kr(t.type,this._map,t))},jr.prototype.dblclick=function(t){return this._firePreventable(new kr(t.type,this._map,t))},jr.prototype.mouseover=function(t){this._map.fire(new kr(t.type,this._map,t))},jr.prototype.mouseout=function(t){this._map.fire(new kr(t.type,this._map,t))},jr.prototype.touchstart=function(t){return this._firePreventable(new Dr(t.type,this._map,t))},jr.prototype.touchmove=function(t){this._map.fire(new Dr(t.type,this._map,t))},jr.prototype.touchend=function(t){this._map.fire(new Dr(t.type,this._map,t))},jr.prototype.touchcancel=function(t){this._map.fire(new Dr(t.type,this._map,t))},jr.prototype._firePreventable=function(t){if(this._map.fire(t),t.defaultPrevented)return{}},jr.prototype.isEnabled=function(){return!0},jr.prototype.isActive=function(){return!1},jr.prototype.enable=function(){},jr.prototype.disable=function(){};var Fr=function(t){this._map=t};Fr.prototype.reset=function(){this._delayContextMenu=!1,delete this._contextMenuEvent},Fr.prototype.mousemove=function(t){this._map.fire(new kr(t.type,this._map,t))},Fr.prototype.mousedown=function(){this._delayContextMenu=!0},Fr.prototype.mouseup=function(){this._delayContextMenu=!1,this._contextMenuEvent&&(this._map.fire(new kr("contextmenu",this._map,this._contextMenuEvent)),delete this._contextMenuEvent)},Fr.prototype.contextmenu=function(t){this._delayContextMenu?this._contextMenuEvent=t:this._map.fire(new kr(t.type,this._map,t)),this._map.listens("contextmenu")&&t.preventDefault()},Fr.prototype.isEnabled=function(){return!0},Fr.prototype.isActive=function(){return!1},Fr.prototype.enable=function(){},Fr.prototype.disable=function(){};var zr=function(t,e){this._map=t,this._el=t.getCanvasContainer(),this._container=t.getContainer(),this._clickTolerance=e.clickTolerance||1};function Ur(t,e){for(var n={},r=0;r<t.length;r++)n[t[r].identifier]=e[r];return n}zr.prototype.isEnabled=function(){return!!this._enabled},zr.prototype.isActive=function(){return!!this._active},zr.prototype.enable=function(){this.isEnabled()||(this._enabled=!0)},zr.prototype.disable=function(){this.isEnabled()&&(this._enabled=!1)},zr.prototype.mousedown=function(t,e){this.isEnabled()&&t.shiftKey&&0===t.button&&(n.disableDrag(),this._startPos=this._lastPos=e,this._active=!0)},zr.prototype.mousemoveWindow=function(t,e){if(this._active){var r=e;if(!(this._lastPos.equals(r)||!this._box&&r.dist(this._startPos)<this._clickTolerance)){var i=this._startPos;this._lastPos=r,this._box||(this._box=n.create("div","mapboxgl-boxzoom",this._container),this._container.classList.add("mapboxgl-crosshair"),this._fireEvent("boxzoomstart",t));var o=Math.min(i.x,r.x),a=Math.max(i.x,r.x),s=Math.min(i.y,r.y),u=Math.max(i.y,r.y);n.setTransform(this._box,"translate("+o+"px,"+s+"px)"),this._box.style.width=a-o+"px",this._box.style.height=u-s+"px"}}},zr.prototype.mouseupWindow=function(e,r){var i=this;if(this._active&&0===e.button){var o=this._startPos,a=r;if(this.reset(),n.suppressClick(),o.x!==a.x||o.y!==a.y)return this._map.fire(new t.Event("boxzoomend",{originalEvent:e})),{cameraAnimation:function(t){return t.fitScreenCoordinates(o,a,i._map.getBearing(),{linear:!0})}};this._fireEvent("boxzoomcancel",e)}},zr.prototype.keydown=function(t){this._active&&27===t.keyCode&&(this.reset(),this._fireEvent("boxzoomcancel",t))},zr.prototype.blur=function(){this.reset()},zr.prototype.reset=function(){this._active=!1,this._container.classList.remove("mapboxgl-crosshair"),this._box&&(n.remove(this._box),this._box=null),n.enableDrag(),delete this._startPos,delete this._lastPos},zr.prototype._fireEvent=function(e,n){return this._map.fire(new t.Event(e,{originalEvent:n}))};var Nr=function(t){this.reset(),this.numTouches=t.numTouches};Nr.prototype.reset=function(){delete this.centroid,delete this.startTime,delete this.touches,this.aborted=!1},Nr.prototype.touchstart=function(e,n,r){(this.centroid||r.length>this.numTouches)&&(this.aborted=!0),this.aborted||(void 0===this.startTime&&(this.startTime=e.timeStamp),r.length===this.numTouches&&(this.centroid=function(e){for(var n=new t.Point(0,0),r=0,i=e;r<i.length;r+=1)n._add(i[r]);return n.div(e.length)}(n),this.touches=Ur(r,n)))},Nr.prototype.touchmove=function(t,e,n){if(!this.aborted&&this.centroid){var r=Ur(n,e);for(var i in this.touches){var o=r[i];(!o||o.dist(this.touches[i])>30)&&(this.aborted=!0)}}},Nr.prototype.touchend=function(t,e,n){if((!this.centroid||t.timeStamp-this.startTime>500)&&(this.aborted=!0),0===n.length){var r=!this.aborted&&this.centroid;if(this.reset(),r)return r}};var Gr=function(t){this.singleTap=new Nr(t),this.numTaps=t.numTaps,this.reset()};Gr.prototype.reset=function(){this.lastTime=1/0,delete this.lastTap,this.count=0,this.singleTap.reset()},Gr.prototype.touchstart=function(t,e,n){this.singleTap.touchstart(t,e,n)},Gr.prototype.touchmove=function(t,e,n){this.singleTap.touchmove(t,e,n)},Gr.prototype.touchend=function(t,e,n){var r=this.singleTap.touchend(t,e,n);if(r){var i=t.timeStamp-this.lastTime<500,o=!this.lastTap||this.lastTap.dist(r)<30;if(i&&o||this.reset(),this.count++,this.lastTime=t.timeStamp,this.lastTap=r,this.count===this.numTaps)return this.reset(),r}};var Vr=function(){this._zoomIn=new Gr({numTouches:1,numTaps:2}),this._zoomOut=new Gr({numTouches:2,numTaps:1}),this.reset()};Vr.prototype.reset=function(){this._active=!1,this._zoomIn.reset(),this._zoomOut.reset()},Vr.prototype.touchstart=function(t,e,n){this._zoomIn.touchstart(t,e,n),this._zoomOut.touchstart(t,e,n)},Vr.prototype.touchmove=function(t,e,n){this._zoomIn.touchmove(t,e,n),this._zoomOut.touchmove(t,e,n)},Vr.prototype.touchend=function(t,e,n){var r=this,i=this._zoomIn.touchend(t,e,n),o=this._zoomOut.touchend(t,e,n);return i?(this._active=!0,t.preventDefault(),setTimeout((function(){return r.reset()}),0),{cameraAnimation:function(e){return e.easeTo({duration:300,zoom:e.getZoom()+1,around:e.unproject(i)},{originalEvent:t})}}):o?(this._active=!0,t.preventDefault(),setTimeout((function(){return r.reset()}),0),{cameraAnimation:function(e){return e.easeTo({duration:300,zoom:e.getZoom()-1,around:e.unproject(o)},{originalEvent:t})}}):void 0},Vr.prototype.touchcancel=function(){this.reset()},Vr.prototype.enable=function(){this._enabled=!0},Vr.prototype.disable=function(){this._enabled=!1,this.reset()},Vr.prototype.isEnabled=function(){return this._enabled},Vr.prototype.isActive=function(){return this._active};var Hr={0:1,2:2},Wr=function(t){this.reset(),this._clickTolerance=t.clickTolerance||1};Wr.prototype.blur=function(){this.reset()},Wr.prototype.reset=function(){this._active=!1,this._moved=!1,delete this._lastPoint,delete this._eventButton},Wr.prototype._correctButton=function(t,e){return!1},Wr.prototype._move=function(t,e){return{}},Wr.prototype.mousedown=function(t,e){if(!this._lastPoint){var r=n.mouseButton(t);this._correctButton(t,r)&&(this._lastPoint=e,this._eventButton=r)}},Wr.prototype.mousemoveWindow=function(t,e){var n=this._lastPoint;if(n)if(t.preventDefault(),function(t,e){var n=Hr[e];return void 0===t.buttons||(t.buttons&n)!==n}(t,this._eventButton))this.reset();else if(this._moved||!(e.dist(n)<this._clickTolerance))return this._moved=!0,this._lastPoint=e,this._move(n,e)},Wr.prototype.mouseupWindow=function(t){this._lastPoint&&n.mouseButton(t)===this._eventButton&&(this._moved&&n.suppressClick(),this.reset())},Wr.prototype.enable=function(){this._enabled=!0},Wr.prototype.disable=function(){this._enabled=!1,this.reset()},Wr.prototype.isEnabled=function(){return this._enabled},Wr.prototype.isActive=function(){return this._active};var qr=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.mousedown=function(e,n){t.prototype.mousedown.call(this,e,n),this._lastPoint&&(this._active=!0)},e.prototype._correctButton=function(t,e){return 0===e&&!t.ctrlKey},e.prototype._move=function(t,e){return{around:e,panDelta:e.sub(t)}},e}(Wr),Xr=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._correctButton=function(t,e){return 0===e&&t.ctrlKey||2===e},e.prototype._move=function(t,e){var n=.8*(e.x-t.x);if(n)return this._active=!0,{bearingDelta:n}},e.prototype.contextmenu=function(t){t.preventDefault()},e}(Wr),Zr=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._correctButton=function(t,e){return 0===e&&t.ctrlKey||2===e},e.prototype._move=function(t,e){var n=-.5*(e.y-t.y);if(n)return this._active=!0,{pitchDelta:n}},e.prototype.contextmenu=function(t){t.preventDefault()},e}(Wr),Jr=function(t){this._minTouches=1,this._clickTolerance=t.clickTolerance||1,this.reset()};Jr.prototype.reset=function(){this._active=!1,this._touches={},this._sum=new t.Point(0,0)},Jr.prototype.touchstart=function(t,e,n){return this._calculateTransform(t,e,n)},Jr.prototype.touchmove=function(t,e,n){if(this._active&&!(n.length<this._minTouches))return t.preventDefault(),this._calculateTransform(t,e,n)},Jr.prototype.touchend=function(t,e,n){this._calculateTransform(t,e,n),this._active&&n.length<this._minTouches&&this.reset()},Jr.prototype.touchcancel=function(){this.reset()},Jr.prototype._calculateTransform=function(e,n,r){r.length>0&&(this._active=!0);var i=Ur(r,n),o=new t.Point(0,0),a=new t.Point(0,0),s=0;for(var u in i){var c=i[u],l=this._touches[u];l&&(o._add(c),a._add(c.sub(l)),s++,i[u]=c)}if(this._touches=i,!(s<this._minTouches)&&a.mag()){var h=a.div(s);if(this._sum._add(h),!(this._sum.mag()<this._clickTolerance))return{around:o.div(s),panDelta:h}}},Jr.prototype.enable=function(){this._enabled=!0},Jr.prototype.disable=function(){this._enabled=!1,this.reset()},Jr.prototype.isEnabled=function(){return this._enabled},Jr.prototype.isActive=function(){return this._active};var Qr=function(){this.reset()};function Kr(t,e,n){for(var r=0;r<t.length;r++)if(t[r].identifier===n)return e[r]}function Yr(t,e){return Math.log(t/e)/Math.LN2}Qr.prototype.reset=function(){this._active=!1,delete this._firstTwoTouches},Qr.prototype._start=function(t){},Qr.prototype._move=function(t,e,n){return{}},Qr.prototype.touchstart=function(t,e,n){this._firstTwoTouches||n.length<2||(this._firstTwoTouches=[n[0].identifier,n[1].identifier],this._start([e[0],e[1]]))},Qr.prototype.touchmove=function(t,e,n){if(this._firstTwoTouches){t.preventDefault();var r=this._firstTwoTouches,i=r[1],o=Kr(n,e,r[0]),a=Kr(n,e,i);if(o&&a){var s=this._aroundCenter?null:o.add(a).div(2);return this._move([o,a],s,t)}}},Qr.prototype.touchend=function(t,e,r){if(this._firstTwoTouches){var i=this._firstTwoTouches,o=i[1],a=Kr(r,e,i[0]),s=Kr(r,e,o);a&&s||(this._active&&n.suppressClick(),this.reset())}},Qr.prototype.touchcancel=function(){this.reset()},Qr.prototype.enable=function(t){this._enabled=!0,this._aroundCenter=!!t&&"center"===t.around},Qr.prototype.disable=function(){this._enabled=!1,this.reset()},Qr.prototype.isEnabled=function(){return this._enabled},Qr.prototype.isActive=function(){return this._active};var $r=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.reset=function(){t.prototype.reset.call(this),delete this._distance,delete this._startDistance},e.prototype._start=function(t){this._startDistance=this._distance=t[0].dist(t[1])},e.prototype._move=function(t,e){var n=this._distance;if(this._distance=t[0].dist(t[1]),this._active||!(Math.abs(Yr(this._distance,this._startDistance))<.1))return this._active=!0,{zoomDelta:Yr(this._distance,n),pinchAround:e}},e}(Qr);function ti(t,e){return 180*t.angleWith(e)/Math.PI}var ei=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.reset=function(){t.prototype.reset.call(this),delete this._minDiameter,delete this._startVector,delete this._vector},e.prototype._start=function(t){this._startVector=this._vector=t[0].sub(t[1]),this._minDiameter=t[0].dist(t[1])},e.prototype._move=function(t,e){var n=this._vector;if(this._vector=t[0].sub(t[1]),this._active||!this._isBelowThreshold(this._vector))return this._active=!0,{bearingDelta:ti(this._vector,n),pinchAround:e}},e.prototype._isBelowThreshold=function(t){this._minDiameter=Math.min(this._minDiameter,t.mag());var e=25/(Math.PI*this._minDiameter)*360,n=ti(t,this._startVector);return Math.abs(n)<e},e}(Qr);function ni(t){return Math.abs(t.y)>Math.abs(t.x)}var ri=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.reset=function(){t.prototype.reset.call(this),this._valid=void 0,delete this._firstMove,delete this._lastPoints},e.prototype._start=function(t){this._lastPoints=t,ni(t[0].sub(t[1]))&&(this._valid=!1)},e.prototype._move=function(t,e,n){var r=t[0].sub(this._lastPoints[0]),i=t[1].sub(this._lastPoints[1]);if(this._valid=this.gestureBeginsVertically(r,i,n.timeStamp),this._valid)return this._lastPoints=t,this._active=!0,{pitchDelta:(r.y+i.y)/2*-.5}},e.prototype.gestureBeginsVertically=function(t,e,n){if(void 0!==this._valid)return this._valid;var r=t.mag()>=2,i=e.mag()>=2;if(r||i){if(!r||!i)return void 0===this._firstMove&&(this._firstMove=n),n-this._firstMove<100&&void 0;var o=t.y>0==e.y>0;return ni(t)&&ni(e)&&o}},e}(Qr),ii={panStep:100,bearingStep:15,pitchStep:10},oi=function(){var t=ii;this._panStep=t.panStep,this._bearingStep=t.bearingStep,this._pitchStep=t.pitchStep,this._rotationDisabled=!1};function ai(t){return t*(2-t)}oi.prototype.blur=function(){this.reset()},oi.prototype.reset=function(){this._active=!1},oi.prototype.keydown=function(t){var e=this;if(!(t.altKey||t.ctrlKey||t.metaKey)){var n=0,r=0,i=0,o=0,a=0;switch(t.keyCode){case 61:case 107:case 171:case 187:n=1;break;case 189:case 109:case 173:n=-1;break;case 37:t.shiftKey?r=-1:(t.preventDefault(),o=-1);break;case 39:t.shiftKey?r=1:(t.preventDefault(),o=1);break;case 38:t.shiftKey?i=1:(t.preventDefault(),a=-1);break;case 40:t.shiftKey?i=-1:(t.preventDefault(),a=1);break;default:return}return this._rotationDisabled&&(r=0,i=0),{cameraAnimation:function(s){var u=s.getZoom();s.easeTo({duration:300,easeId:"keyboardHandler",easing:ai,zoom:n?Math.round(u)+n*(t.shiftKey?2:1):u,bearing:s.getBearing()+r*e._bearingStep,pitch:s.getPitch()+i*e._pitchStep,offset:[-o*e._panStep,-a*e._panStep],center:s.getCenter()},{originalEvent:t})}}}},oi.prototype.enable=function(){this._enabled=!0},oi.prototype.disable=function(){this._enabled=!1,this.reset()},oi.prototype.isEnabled=function(){return this._enabled},oi.prototype.isActive=function(){return this._active},oi.prototype.disableRotation=function(){this._rotationDisabled=!0},oi.prototype.enableRotation=function(){this._rotationDisabled=!1};var si=function(e,n){this._map=e,this._el=e.getCanvasContainer(),this._handler=n,this._delta=0,this._defaultZoomRate=.01,this._wheelZoomRate=1/450,t.bindAll(["_onTimeout"],this)};si.prototype.setZoomRate=function(t){this._defaultZoomRate=t},si.prototype.setWheelZoomRate=function(t){this._wheelZoomRate=t},si.prototype.isEnabled=function(){return!!this._enabled},si.prototype.isActive=function(){return!!this._active||void 0!==this._finishTimeout},si.prototype.isZooming=function(){return!!this._zooming},si.prototype.enable=function(t){this.isEnabled()||(this._enabled=!0,this._aroundCenter=t&&"center"===t.around)},si.prototype.disable=function(){this.isEnabled()&&(this._enabled=!1)},si.prototype.wheel=function(e){if(this.isEnabled()){var n=e.deltaMode===t.window.WheelEvent.DOM_DELTA_LINE?40*e.deltaY:e.deltaY,r=t.browser.now(),i=r-(this._lastWheelEventTime||0);this._lastWheelEventTime=r,0!==n&&n%4.000244140625==0?this._type="wheel":0!==n&&Math.abs(n)<4?this._type="trackpad":i>400?(this._type=null,this._lastValue=n,this._timeout=setTimeout(this._onTimeout,40,e)):this._type||(this._type=Math.abs(i*n)<200?"trackpad":"wheel",this._timeout&&(clearTimeout(this._timeout),this._timeout=null,n+=this._lastValue)),e.shiftKey&&n&&(n/=4),this._type&&(this._lastWheelEvent=e,this._delta-=n,this._active||this._start(e)),e.preventDefault()}},si.prototype._onTimeout=function(t){this._type="wheel",this._delta-=this._lastValue,this._active||this._start(t)},si.prototype._start=function(e){if(this._delta){this._frameId&&(this._frameId=null),this._active=!0,this.isZooming()||(this._zooming=!0),this._finishTimeout&&(clearTimeout(this._finishTimeout),delete this._finishTimeout);var r=n.mousePos(this._el,e);this._around=t.LngLat.convert(this._aroundCenter?this._map.getCenter():this._map.unproject(r)),this._aroundPoint=this._map.transform.locationPoint(this._around),this._frameId||(this._frameId=!0,this._handler._triggerRenderFrame())}},si.prototype.renderFrame=function(){var e=this;if(this._frameId&&(this._frameId=null,this.isActive())){var n=this._map.transform;if(0!==this._delta){var r="wheel"===this._type&&Math.abs(this._delta)>4.000244140625?this._wheelZoomRate:this._defaultZoomRate,i=2/(1+Math.exp(-Math.abs(this._delta*r)));this._delta<0&&0!==i&&(i=1/i);var o="number"==typeof this._targetZoom?n.zoomScale(this._targetZoom):n.scale;this._targetZoom=Math.min(n.maxZoom,Math.max(n.minZoom,n.scaleZoom(o*i))),"wheel"===this._type&&(this._startZoom=n.zoom,this._easing=this._smoothOutEasing(200)),this._delta=0}var a,s="number"==typeof this._targetZoom?this._targetZoom:n.zoom,u=this._startZoom,c=this._easing,l=!1;if("wheel"===this._type&&u&&c){var h=Math.min((t.browser.now()-this._lastWheelEventTime)/200,1),f=c(h);a=t.number(u,s,f),h<1?this._frameId||(this._frameId=!0):l=!0}else a=s,l=!0;return this._active=!0,l&&(this._active=!1,this._finishTimeout=setTimeout((function(){e._zooming=!1,e._handler._triggerRenderFrame(),delete e._targetZoom,delete e._finishTimeout}),200)),{noInertia:!0,needsRenderFrame:!l,zoomDelta:a-n.zoom,around:this._aroundPoint,originalEvent:this._lastWheelEvent}}},si.prototype._smoothOutEasing=function(e){var n=t.ease;if(this._prevEase){var r=this._prevEase,i=(t.browser.now()-r.start)/r.duration,o=r.easing(i+.01)-r.easing(i),a=.27/Math.sqrt(o*o+1e-4)*.01,s=Math.sqrt(.0729-a*a);n=t.bezier(a,s,.25,1)}return this._prevEase={start:t.browser.now(),duration:e,easing:n},n},si.prototype.blur=function(){this.reset()},si.prototype.reset=function(){this._active=!1};var ui=function(t,e){this._clickZoom=t,this._tapZoom=e};ui.prototype.enable=function(){this._clickZoom.enable(),this._tapZoom.enable()},ui.prototype.disable=function(){this._clickZoom.disable(),this._tapZoom.disable()},ui.prototype.isEnabled=function(){return this._clickZoom.isEnabled()&&this._tapZoom.isEnabled()},ui.prototype.isActive=function(){return this._clickZoom.isActive()||this._tapZoom.isActive()};var ci=function(){this.reset()};ci.prototype.reset=function(){this._active=!1},ci.prototype.blur=function(){this.reset()},ci.prototype.dblclick=function(t,e){return t.preventDefault(),{cameraAnimation:function(n){n.easeTo({duration:300,zoom:n.getZoom()+(t.shiftKey?-1:1),around:n.unproject(e)},{originalEvent:t})}}},ci.prototype.enable=function(){this._enabled=!0},ci.prototype.disable=function(){this._enabled=!1,this.reset()},ci.prototype.isEnabled=function(){return this._enabled},ci.prototype.isActive=function(){return this._active};var li=function(){this._tap=new Gr({numTouches:1,numTaps:1}),this.reset()};li.prototype.reset=function(){this._active=!1,delete this._swipePoint,delete this._swipeTouch,delete this._tapTime,this._tap.reset()},li.prototype.touchstart=function(t,e,n){this._swipePoint||(this._tapTime&&t.timeStamp-this._tapTime>500&&this.reset(),this._tapTime?n.length>0&&(this._swipePoint=e[0],this._swipeTouch=n[0].identifier):this._tap.touchstart(t,e,n))},li.prototype.touchmove=function(t,e,n){if(this._tapTime){if(this._swipePoint){if(n[0].identifier!==this._swipeTouch)return;var r=e[0],i=r.y-this._swipePoint.y;return this._swipePoint=r,t.preventDefault(),this._active=!0,{zoomDelta:i/128}}}else this._tap.touchmove(t,e,n)},li.prototype.touchend=function(t,e,n){this._tapTime?this._swipePoint&&0===n.length&&this.reset():this._tap.touchend(t,e,n)&&(this._tapTime=t.timeStamp)},li.prototype.touchcancel=function(){this.reset()},li.prototype.enable=function(){this._enabled=!0},li.prototype.disable=function(){this._enabled=!1,this.reset()},li.prototype.isEnabled=function(){return this._enabled},li.prototype.isActive=function(){return this._active};var hi=function(t,e,n){this._el=t,this._mousePan=e,this._touchPan=n};hi.prototype.enable=function(t){this._inertiaOptions=t||{},this._mousePan.enable(),this._touchPan.enable(),this._el.classList.add("mapboxgl-touch-drag-pan")},hi.prototype.disable=function(){this._mousePan.disable(),this._touchPan.disable(),this._el.classList.remove("mapboxgl-touch-drag-pan")},hi.prototype.isEnabled=function(){return this._mousePan.isEnabled()&&this._touchPan.isEnabled()},hi.prototype.isActive=function(){return this._mousePan.isActive()||this._touchPan.isActive()};var fi=function(t,e,n){this._pitchWithRotate=t.pitchWithRotate,this._mouseRotate=e,this._mousePitch=n};fi.prototype.enable=function(){this._mouseRotate.enable(),this._pitchWithRotate&&this._mousePitch.enable()},fi.prototype.disable=function(){this._mouseRotate.disable(),this._mousePitch.disable()},fi.prototype.isEnabled=function(){return this._mouseRotate.isEnabled()&&(!this._pitchWithRotate||this._mousePitch.isEnabled())},fi.prototype.isActive=function(){return this._mouseRotate.isActive()||this._mousePitch.isActive()};var pi=function(t,e,n,r){this._el=t,this._touchZoom=e,this._touchRotate=n,this._tapDragZoom=r,this._rotationDisabled=!1,this._enabled=!0};pi.prototype.enable=function(t){this._touchZoom.enable(t),this._rotationDisabled||this._touchRotate.enable(t),this._tapDragZoom.enable(),this._el.classList.add("mapboxgl-touch-zoom-rotate")},pi.prototype.disable=function(){this._touchZoom.disable(),this._touchRotate.disable(),this._tapDragZoom.disable(),this._el.classList.remove("mapboxgl-touch-zoom-rotate")},pi.prototype.isEnabled=function(){return this._touchZoom.isEnabled()&&(this._rotationDisabled||this._touchRotate.isEnabled())&&this._tapDragZoom.isEnabled()},pi.prototype.isActive=function(){return this._touchZoom.isActive()||this._touchRotate.isActive()||this._tapDragZoom.isActive()},pi.prototype.disableRotation=function(){this._rotationDisabled=!0,this._touchRotate.disable()},pi.prototype.enableRotation=function(){this._rotationDisabled=!1,this._touchZoom.isEnabled()&&this._touchRotate.enable()};var di=function(t){return t.zoom||t.drag||t.pitch||t.rotate},Ai=function(t){function e(){t.apply(this,arguments)}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e}(t.Event);function gi(t){return t.panDelta&&t.panDelta.mag()||t.zoomDelta||t.bearingDelta||t.pitchDelta}var mi=function(e,r){this._map=e,this._el=this._map.getCanvasContainer(),this._handlers=[],this._handlersById={},this._changes=[],this._inertia=new Ir(e),this._bearingSnap=r.bearingSnap,this._previousActiveHandlers={},this._eventsInProgress={},this._addDefaultHandlers(r),t.bindAll(["handleEvent","handleWindowEvent"],this);var i=this._el;this._listeners=[[i,"touchstart",{passive:!0}],[i,"touchmove",{passive:!1}],[i,"touchend",void 0],[i,"touchcancel",void 0],[i,"mousedown",void 0],[i,"mousemove",void 0],[i,"mouseup",void 0],[t.window.document,"mousemove",{capture:!0}],[t.window.document,"mouseup",void 0],[i,"mouseover",void 0],[i,"mouseout",void 0],[i,"dblclick",void 0],[i,"click",void 0],[i,"keydown",{capture:!1}],[i,"keyup",void 0],[i,"wheel",{passive:!1}],[i,"contextmenu",void 0],[t.window,"blur",void 0]];for(var o=0,a=this._listeners;o<a.length;o+=1){var s=a[o],u=s[0];n.addEventListener(u,s[1],u===t.window.document?this.handleWindowEvent:this.handleEvent,s[2])}};mi.prototype.destroy=function(){for(var e=0,r=this._listeners;e<r.length;e+=1){var i=r[e],o=i[0];n.removeEventListener(o,i[1],o===t.window.document?this.handleWindowEvent:this.handleEvent,i[2])}},mi.prototype._addDefaultHandlers=function(t){var e=this._map,n=e.getCanvasContainer();this._add("mapEvent",new jr(e,t));var r=e.boxZoom=new zr(e,t);this._add("boxZoom",r);var i=new Vr,o=new ci;e.doubleClickZoom=new ui(o,i),this._add("tapZoom",i),this._add("clickZoom",o);var a=new li;this._add("tapDragZoom",a);var s=e.touchPitch=new ri;this._add("touchPitch",s);var u=new Xr(t),c=new Zr(t);e.dragRotate=new fi(t,u,c),this._add("mouseRotate",u,["mousePitch"]),this._add("mousePitch",c,["mouseRotate"]);var l=new qr(t),h=new Jr(t);e.dragPan=new hi(n,l,h),this._add("mousePan",l),this._add("touchPan",h,["touchZoom","touchRotate"]);var f=new ei,p=new $r;e.touchZoomRotate=new pi(n,p,f,a),this._add("touchRotate",f,["touchPan","touchZoom"]),this._add("touchZoom",p,["touchPan","touchRotate"]);var d=e.scrollZoom=new si(e,this);this._add("scrollZoom",d,["mousePan"]);var A=e.keyboard=new oi;this._add("keyboard",A),this._add("blockableMapEvent",new Fr(e));for(var g=0,m=["boxZoom","doubleClickZoom","tapDragZoom","touchPitch","dragRotate","dragPan","touchZoomRotate","scrollZoom","keyboard"];g<m.length;g+=1){var y=m[g];t.interactive&&t[y]&&e[y].enable(t[y])}},mi.prototype._add=function(t,e,n){this._handlers.push({handlerName:t,handler:e,allowed:n}),this._handlersById[t]=e},mi.prototype.stop=function(t){if(!this._updatingCamera){for(var e=0,n=this._handlers;e<n.length;e+=1)n[e].handler.reset();this._inertia.clear(),this._fireEvents({},{},t),this._changes=[]}},mi.prototype.isActive=function(){for(var t=0,e=this._handlers;t<e.length;t+=1)if(e[t].handler.isActive())return!0;return!1},mi.prototype.isZooming=function(){return!!this._eventsInProgress.zoom||this._map.scrollZoom.isZooming()},mi.prototype.isRotating=function(){return!!this._eventsInProgress.rotate},mi.prototype.isMoving=function(){return Boolean(di(this._eventsInProgress))||this.isZooming()},mi.prototype._blockedByActive=function(t,e,n){for(var r in t)if(r!==n&&(!e||e.indexOf(r)<0))return!0;return!1},mi.prototype.handleWindowEvent=function(t){this.handleEvent(t,t.type+"Window")},mi.prototype._getMapTouches=function(t){for(var e=[],n=0,r=t;n<r.length;n+=1){var i=r[n];this._el.contains(i.target)&&e.push(i)}return e},mi.prototype.handleEvent=function(t,e){this._updatingCamera=!0;for(var r="renderFrame"===t.type?void 0:t,i={needsRenderFrame:!1},o={},a={},s=t.touches?this._getMapTouches(t.touches):void 0,u=s?n.touchPos(this._el,s):n.mousePos(this._el,t),c=0,l=this._handlers;c<l.length;c+=1){var h=l[c],f=h.handlerName,p=h.handler,d=h.allowed;if(p.isEnabled()){var A=void 0;this._blockedByActive(a,d,f)?p.reset():p[e||t.type]&&(A=p[e||t.type](t,u,s),this.mergeHandlerResult(i,o,A,f,r),A&&A.needsRenderFrame&&this._triggerRenderFrame()),(A||p.isActive())&&(a[f]=p)}}var g={};for(var m in this._previousActiveHandlers)a[m]||(g[m]=r);this._previousActiveHandlers=a,(Object.keys(g).length||gi(i))&&(this._changes.push([i,o,g]),this._triggerRenderFrame()),(Object.keys(a).length||gi(i))&&this._map._stop(!0),this._updatingCamera=!1;var y=i.cameraAnimation;y&&(this._inertia.clear(),this._fireEvents({},{},!0),this._changes=[],y(this._map))},mi.prototype.mergeHandlerResult=function(e,n,r,i,o){if(r){t.extend(e,r);var a={handlerName:i,originalEvent:r.originalEvent||o};void 0!==r.zoomDelta&&(n.zoom=a),void 0!==r.panDelta&&(n.drag=a),void 0!==r.pitchDelta&&(n.pitch=a),void 0!==r.bearingDelta&&(n.rotate=a)}},mi.prototype._applyChanges=function(){for(var e={},n={},r={},i=0,o=this._changes;i<o.length;i+=1){var a=o[i],s=a[0],u=a[1],c=a[2];s.panDelta&&(e.panDelta=(e.panDelta||new t.Point(0,0))._add(s.panDelta)),s.zoomDelta&&(e.zoomDelta=(e.zoomDelta||0)+s.zoomDelta),s.bearingDelta&&(e.bearingDelta=(e.bearingDelta||0)+s.bearingDelta),s.pitchDelta&&(e.pitchDelta=(e.pitchDelta||0)+s.pitchDelta),void 0!==s.around&&(e.around=s.around),void 0!==s.pinchAround&&(e.pinchAround=s.pinchAround),s.noInertia&&(e.noInertia=s.noInertia),t.extend(n,u),t.extend(r,c)}this._updateMapTransform(e,n,r),this._changes=[]},mi.prototype._updateMapTransform=function(t,e,n){var r=this._map,i=r.transform;if(!gi(t))return this._fireEvents(e,n,!0);var o=t.panDelta,a=t.zoomDelta,s=t.bearingDelta,u=t.pitchDelta,c=t.around,l=t.pinchAround;void 0!==l&&(c=l),r._stop(!0),c=c||r.transform.centerPoint;var h=i.pointLocation(o?c.sub(o):c);s&&(i.bearing+=s),u&&(i.pitch+=u),a&&(i.zoom+=a),i.setLocationAtPoint(h,c),this._map._update(),t.noInertia||this._inertia.record(t),this._fireEvents(e,n,!0)},mi.prototype._fireEvents=function(e,n,r){var i=this,o=di(this._eventsInProgress),a=di(e),s={};for(var u in e)this._eventsInProgress[u]||(s[u+"start"]=e[u].originalEvent),this._eventsInProgress[u]=e[u];for(var c in!o&&a&&this._fireEvent("movestart",a.originalEvent),s)this._fireEvent(c,s[c]);for(var l in a&&this._fireEvent("move",a.originalEvent),e)this._fireEvent(l,e[l].originalEvent);var h,f={};for(var p in this._eventsInProgress){var d=this._eventsInProgress[p],A=d.handlerName,g=d.originalEvent;this._handlersById[A].isActive()||(delete this._eventsInProgress[p],f[p+"end"]=h=n[A]||g)}for(var m in f)this._fireEvent(m,f[m]);var y=di(this._eventsInProgress);if(r&&(o||a)&&!y){this._updatingCamera=!0;var v=this._inertia._onMoveEnd(this._map.dragPan._inertiaOptions),_=function(t){return 0!==t&&-i._bearingSnap<t&&t<i._bearingSnap};v?(_(v.bearing||this._map.getBearing())&&(v.bearing=0),this._map.easeTo(v,{originalEvent:h})):(this._map.fire(new t.Event("moveend",{originalEvent:h})),_(this._map.getBearing())&&this._map.resetNorth()),this._updatingCamera=!1}},mi.prototype._fireEvent=function(e,n){this._map.fire(new t.Event(e,n?{originalEvent:n}:{}))},mi.prototype._requestFrame=function(){var t=this;return this._map.triggerRepaint(),this._map._renderTaskQueue.add((function(e){delete t._frameId,t.handleEvent(new Ai("renderFrame",{timeStamp:e})),t._applyChanges()}))},mi.prototype._triggerRenderFrame=function(){void 0===this._frameId&&(this._frameId=this._requestFrame())};var yi=function(e){function n(n,r){e.call(this),this._moving=!1,this._zooming=!1,this.transform=n,this._bearingSnap=r.bearingSnap,t.bindAll(["_renderFrameCallback"],this)}return e&&(n.__proto__=e),(n.prototype=Object.create(e&&e.prototype)).constructor=n,n.prototype.getCenter=function(){return new t.LngLat(this.transform.center.lng,this.transform.center.lat)},n.prototype.setCenter=function(t,e){return this.jumpTo({center:t},e)},n.prototype.panBy=function(e,n,r){return e=t.Point.convert(e).mult(-1),this.panTo(this.transform.center,t.extend({offset:e},n),r)},n.prototype.panTo=function(e,n,r){return this.easeTo(t.extend({center:e},n),r)},n.prototype.getZoom=function(){return this.transform.zoom},n.prototype.setZoom=function(t,e){return this.jumpTo({zoom:t},e),this},n.prototype.zoomTo=function(e,n,r){return this.easeTo(t.extend({zoom:e},n),r)},n.prototype.zoomIn=function(t,e){return this.zoomTo(this.getZoom()+1,t,e),this},n.prototype.zoomOut=function(t,e){return this.zoomTo(this.getZoom()-1,t,e),this},n.prototype.getBearing=function(){return this.transform.bearing},n.prototype.setBearing=function(t,e){return this.jumpTo({bearing:t},e),this},n.prototype.getPadding=function(){return this.transform.padding},n.prototype.setPadding=function(t,e){return this.jumpTo({padding:t},e),this},n.prototype.rotateTo=function(e,n,r){return this.easeTo(t.extend({bearing:e},n),r)},n.prototype.resetNorth=function(e,n){return this.rotateTo(0,t.extend({duration:1e3},e),n),this},n.prototype.resetNorthPitch=function(e,n){return this.easeTo(t.extend({bearing:0,pitch:0,duration:1e3},e),n),this},n.prototype.snapToNorth=function(t,e){return Math.abs(this.getBearing())<this._bearingSnap?this.resetNorth(t,e):this},n.prototype.getPitch=function(){return this.transform.pitch},n.prototype.setPitch=function(t,e){return this.jumpTo({pitch:t},e),this},n.prototype.cameraForBounds=function(e,n){e=t.LngLatBounds.convert(e);var r=n&&n.bearing||0;return this._cameraForBoxAndBearing(e.getNorthWest(),e.getSouthEast(),r,n)},n.prototype._cameraForBoxAndBearing=function(e,n,r,i){var o={top:0,bottom:0,right:0,left:0};if("number"==typeof(i=t.extend({padding:o,offset:[0,0],maxZoom:this.transform.maxZoom},i)).padding){var a=i.padding;i.padding={top:a,bottom:a,right:a,left:a}}i.padding=t.extend(o,i.padding);var s=this.transform,u=s.padding,c=s.project(t.LngLat.convert(e)),l=s.project(t.LngLat.convert(n)),h=c.rotate(-r*Math.PI/180),f=l.rotate(-r*Math.PI/180),p=new t.Point(Math.max(h.x,f.x),Math.max(h.y,f.y)),d=new t.Point(Math.min(h.x,f.x),Math.min(h.y,f.y)),A=p.sub(d),g=(s.width-(u.left+u.right+i.padding.left+i.padding.right))/A.x,m=(s.height-(u.top+u.bottom+i.padding.top+i.padding.bottom))/A.y;if(!(m<0||g<0)){var y=Math.min(s.scaleZoom(s.scale*Math.min(g,m)),i.maxZoom),v="number"==typeof i.offset.x?new t.Point(i.offset.x,i.offset.y):t.Point.convert(i.offset),_=new t.Point((i.padding.left-i.padding.right)/2,(i.padding.top-i.padding.bottom)/2).rotate(r*Math.PI/180),b=v.add(_).mult(s.scale/s.zoomScale(y));return{center:s.unproject(c.add(l).div(2).sub(b)),zoom:y,bearing:r}}t.warnOnce("Map cannot fit within canvas with the given bounds, padding, and/or offset.")},n.prototype.fitBounds=function(t,e,n){return this._fitInternal(this.cameraForBounds(t,e),e,n)},n.prototype.fitScreenCoordinates=function(e,n,r,i,o){return this._fitInternal(this._cameraForBoxAndBearing(this.transform.pointLocation(t.Point.convert(e)),this.transform.pointLocation(t.Point.convert(n)),r,i),i,o)},n.prototype._fitInternal=function(e,n,r){return e?(delete(n=t.extend(e,n)).padding,n.linear?this.easeTo(n,r):this.flyTo(n,r)):this},n.prototype.jumpTo=function(e,n){this.stop();var r=this.transform,i=!1,o=!1,a=!1;return"zoom"in e&&r.zoom!==+e.zoom&&(i=!0,r.zoom=+e.zoom),void 0!==e.center&&(r.center=t.LngLat.convert(e.center)),"bearing"in e&&r.bearing!==+e.bearing&&(o=!0,r.bearing=+e.bearing),"pitch"in e&&r.pitch!==+e.pitch&&(a=!0,r.pitch=+e.pitch),null==e.padding||r.isPaddingEqual(e.padding)||(r.padding=e.padding),this.fire(new t.Event("movestart",n)).fire(new t.Event("move",n)),i&&this.fire(new t.Event("zoomstart",n)).fire(new t.Event("zoom",n)).fire(new t.Event("zoomend",n)),o&&this.fire(new t.Event("rotatestart",n)).fire(new t.Event("rotate",n)).fire(new t.Event("rotateend",n)),a&&this.fire(new t.Event("pitchstart",n)).fire(new t.Event("pitch",n)).fire(new t.Event("pitchend",n)),this.fire(new t.Event("moveend",n))},n.prototype.easeTo=function(e,n){var r=this;this._stop(!1,e.easeId),(!1===(e=t.extend({offset:[0,0],duration:500,easing:t.ease},e)).animate||!e.essential&&t.browser.prefersReducedMotion)&&(e.duration=0);var i=this.transform,o=this.getZoom(),a=this.getBearing(),s=this.getPitch(),u=this.getPadding(),c="zoom"in e?+e.zoom:o,l="bearing"in e?this._normalizeBearing(e.bearing,a):a,h="pitch"in e?+e.pitch:s,f="padding"in e?e.padding:i.padding,p=t.Point.convert(e.offset),d=i.centerPoint.add(p),A=i.pointLocation(d),g=t.LngLat.convert(e.center||A);this._normalizeCenter(g);var m,y,v=i.project(A),_=i.project(g).sub(v),b=i.zoomScale(c-o);e.around&&(m=t.LngLat.convert(e.around),y=i.locationPoint(m));var x={moving:this._moving,zooming:this._zooming,rotating:this._rotating,pitching:this._pitching};return this._zooming=this._zooming||c!==o,this._rotating=this._rotating||a!==l,this._pitching=this._pitching||h!==s,this._padding=!i.isPaddingEqual(f),this._easeId=e.easeId,this._prepareEase(n,e.noMoveStart,x),this._ease((function(e){if(r._zooming&&(i.zoom=t.number(o,c,e)),r._rotating&&(i.bearing=t.number(a,l,e)),r._pitching&&(i.pitch=t.number(s,h,e)),r._padding&&(i.interpolatePadding(u,f,e),d=i.centerPoint.add(p)),m)i.setLocationAtPoint(m,y);else{var A=i.zoomScale(i.zoom-o),g=c>o?Math.min(2,b):Math.max(.5,b),x=Math.pow(g,1-e),w=i.unproject(v.add(_.mult(e*x)).mult(A));i.setLocationAtPoint(i.renderWorldCopies?w.wrap():w,d)}r._fireMoveEvents(n)}),(function(t){r._afterEase(n,t)}),e),this},n.prototype._prepareEase=function(e,n,r){void 0===r&&(r={}),this._moving=!0,n||r.moving||this.fire(new t.Event("movestart",e)),this._zooming&&!r.zooming&&this.fire(new t.Event("zoomstart",e)),this._rotating&&!r.rotating&&this.fire(new t.Event("rotatestart",e)),this._pitching&&!r.pitching&&this.fire(new t.Event("pitchstart",e))},n.prototype._fireMoveEvents=function(e){this.fire(new t.Event("move",e)),this._zooming&&this.fire(new t.Event("zoom",e)),this._rotating&&this.fire(new t.Event("rotate",e)),this._pitching&&this.fire(new t.Event("pitch",e))},n.prototype._afterEase=function(e,n){if(!this._easeId||!n||this._easeId!==n){delete this._easeId;var r=this._zooming,i=this._rotating,o=this._pitching;this._moving=!1,this._zooming=!1,this._rotating=!1,this._pitching=!1,this._padding=!1,r&&this.fire(new t.Event("zoomend",e)),i&&this.fire(new t.Event("rotateend",e)),o&&this.fire(new t.Event("pitchend",e)),this.fire(new t.Event("moveend",e))}},n.prototype.flyTo=function(e,n){var r=this;if(!e.essential&&t.browser.prefersReducedMotion){var i=t.pick(e,["center","zoom","bearing","pitch","around"]);return this.jumpTo(i,n)}this.stop(),e=t.extend({offset:[0,0],speed:1.2,curve:1.42,easing:t.ease},e);var o=this.transform,a=this.getZoom(),s=this.getBearing(),u=this.getPitch(),c=this.getPadding(),l="zoom"in e?t.clamp(+e.zoom,o.minZoom,o.maxZoom):a,h="bearing"in e?this._normalizeBearing(e.bearing,s):s,f="pitch"in e?+e.pitch:u,p="padding"in e?e.padding:o.padding,d=o.zoomScale(l-a),A=t.Point.convert(e.offset),g=o.centerPoint.add(A),m=o.pointLocation(g),y=t.LngLat.convert(e.center||m);this._normalizeCenter(y);var v=o.project(m),_=o.project(y).sub(v),b=e.curve,x=Math.max(o.width,o.height),w=x/d,E=_.mag();if("minZoom"in e){var O=t.clamp(Math.min(e.minZoom,a,l),o.minZoom,o.maxZoom),S=x/o.zoomScale(O-a);b=Math.sqrt(S/E*2)}var T=b*b;function C(t){var e=(w*w-x*x+(t?-1:1)*T*T*E*E)/(2*(t?w:x)*T*E);return Math.log(Math.sqrt(e*e+1)-e)}function P(t){return(Math.exp(t)-Math.exp(-t))/2}function M(t){return(Math.exp(t)+Math.exp(-t))/2}var I=C(0),B=function(t){return M(I)/M(I+b*t)},R=function(t){return x*((M(I)*(P(e=I+b*t)/M(e))-P(I))/T)/E;var e},k=(C(1)-I)/b;if(Math.abs(E)<1e-6||!isFinite(k)){if(Math.abs(x-w)<1e-6)return this.easeTo(e,n);var D=w<x?-1:1;k=Math.abs(Math.log(w/x))/b,R=function(){return 0},B=function(t){return Math.exp(D*b*t)}}return e.duration="duration"in e?+e.duration:1e3*k/("screenSpeed"in e?+e.screenSpeed/b:+e.speed),e.maxDuration&&e.duration>e.maxDuration&&(e.duration=0),this._zooming=!0,this._rotating=s!==h,this._pitching=f!==u,this._padding=!o.isPaddingEqual(p),this._prepareEase(n,!1),this._ease((function(e){var i=e*k,d=1/B(i);o.zoom=1===e?l:a+o.scaleZoom(d),r._rotating&&(o.bearing=t.number(s,h,e)),r._pitching&&(o.pitch=t.number(u,f,e)),r._padding&&(o.interpolatePadding(c,p,e),g=o.centerPoint.add(A));var m=1===e?y:o.unproject(v.add(_.mult(R(i))).mult(d));o.setLocationAtPoint(o.renderWorldCopies?m.wrap():m,g),r._fireMoveEvents(n)}),(function(){return r._afterEase(n)}),e),this},n.prototype.isEasing=function(){return!!this._easeFrameId},n.prototype.stop=function(){return this._stop()},n.prototype._stop=function(t,e){if(this._easeFrameId&&(this._cancelRenderFrame(this._easeFrameId),delete this._easeFrameId,delete this._onEaseFrame),this._onEaseEnd){var n=this._onEaseEnd;delete this._onEaseEnd,n.call(this,e)}if(!t){var r=this.handlers;r&&r.stop(!1)}return this},n.prototype._ease=function(e,n,r){!1===r.animate||0===r.duration?(e(1),n()):(this._easeStart=t.browser.now(),this._easeOptions=r,this._onEaseFrame=e,this._onEaseEnd=n,this._easeFrameId=this._requestRenderFrame(this._renderFrameCallback))},n.prototype._renderFrameCallback=function(){var e=Math.min((t.browser.now()-this._easeStart)/this._easeOptions.duration,1);this._onEaseFrame(this._easeOptions.easing(e)),e<1?this._easeFrameId=this._requestRenderFrame(this._renderFrameCallback):this.stop()},n.prototype._normalizeBearing=function(e,n){e=t.wrap(e,-180,180);var r=Math.abs(e-n);return Math.abs(e-360-n)<r&&(e-=360),Math.abs(e+360-n)<r&&(e+=360),e},n.prototype._normalizeCenter=function(t){var e=this.transform;if(e.renderWorldCopies&&!e.lngRange){var n=t.lng-e.center.lng;t.lng+=n>180?-360:n<-180?360:0}},n}(t.Evented),vi=function(e){void 0===e&&(e={}),this.options=e,t.bindAll(["_toggleAttribution","_updateEditLink","_updateData","_updateCompact"],this)};vi.prototype.getDefaultPosition=function(){return"bottom-right"},vi.prototype.onAdd=function(t){var e=this.options&&this.options.compact;return this._map=t,this._container=n.create("div","mapboxgl-ctrl mapboxgl-ctrl-attrib"),this._compactButton=n.create("button","mapboxgl-ctrl-attrib-button",this._container),this._compactButton.addEventListener("click",this._toggleAttribution),this._setElementTitle(this._compactButton,"ToggleAttribution"),this._innerContainer=n.create("div","mapboxgl-ctrl-attrib-inner",this._container),this._innerContainer.setAttribute("role","list"),e&&this._container.classList.add("mapboxgl-compact"),this._updateAttributions(),this._updateEditLink(),this._map.on("styledata",this._updateData),this._map.on("sourcedata",this._updateData),this._map.on("moveend",this._updateEditLink),void 0===e&&(this._map.on("resize",this._updateCompact),this._updateCompact()),this._container},vi.prototype.onRemove=function(){n.remove(this._container),this._map.off("styledata",this._updateData),this._map.off("sourcedata",this._updateData),this._map.off("moveend",this._updateEditLink),this._map.off("resize",this._updateCompact),this._map=void 0,this._attribHTML=void 0},vi.prototype._setElementTitle=function(t,e){var n=this._map._getUIString("AttributionControl."+e);t.title=n,t.setAttribute("aria-label",n)},vi.prototype._toggleAttribution=function(){this._container.classList.contains("mapboxgl-compact-show")?(this._container.classList.remove("mapboxgl-compact-show"),this._compactButton.setAttribute("aria-pressed","false")):(this._container.classList.add("mapboxgl-compact-show"),this._compactButton.setAttribute("aria-pressed","true"))},vi.prototype._updateEditLink=function(){var e=this._editLink;e||(e=this._editLink=this._container.querySelector(".mapbox-improve-map"));var n=[{key:"owner",value:this.styleOwner},{key:"id",value:this.styleId},{key:"access_token",value:this._map._requestManager._customAccessToken||t.config.ACCESS_TOKEN}];if(e){var r=n.reduce((function(t,e,r){return e.value&&(t+=e.key+"="+e.value+(r<n.length-1?"&":"")),t}),"?");e.href=t.config.FEEDBACK_URL+"/"+r+(this._map._hash?this._map._hash.getHashString(!0):""),e.rel="noopener nofollow",this._setElementTitle(e,"MapFeedback")}},vi.prototype._updateData=function(t){!t||"metadata"!==t.sourceDataType&&"visibility"!==t.sourceDataType&&"style"!==t.dataType||(this._updateAttributions(),this._updateEditLink())},vi.prototype._updateAttributions=function(){if(this._map.style){var t=[];if(this.options.customAttribution&&(Array.isArray(this.options.customAttribution)?t=t.concat(this.options.customAttribution.map((function(t){return"string"!=typeof t?"":t}))):"string"==typeof this.options.customAttribution&&t.push(this.options.customAttribution)),this._map.style.stylesheet){var e=this._map.style.stylesheet;this.styleOwner=e.owner,this.styleId=e.id}var n=this._map.style.sourceCaches;for(var r in n){var i=n[r];if(i.used){var o=i.getSource();o.attribution&&t.indexOf(o.attribution)<0&&t.push(o.attribution)}}t.sort((function(t,e){return t.length-e.length}));var a=(t=t.filter((function(e,n){for(var r=n+1;r<t.length;r++)if(t[r].indexOf(e)>=0)return!1;return!0}))).join(" | ");a!==this._attribHTML&&(this._attribHTML=a,t.length?(this._innerContainer.innerHTML=a,this._container.classList.remove("mapboxgl-attrib-empty")):this._container.classList.add("mapboxgl-attrib-empty"),this._editLink=null)}},vi.prototype._updateCompact=function(){this._map.getCanvasContainer().offsetWidth<=640?this._container.classList.add("mapboxgl-compact"):this._container.classList.remove("mapboxgl-compact","mapboxgl-compact-show")};var _i=function(){t.bindAll(["_updateLogo"],this),t.bindAll(["_updateCompact"],this)};_i.prototype.onAdd=function(t){this._map=t,this._container=n.create("div","mapboxgl-ctrl");var e=n.create("a","mapboxgl-ctrl-logo");return e.target="_blank",e.rel="noopener nofollow",e.href="https://www.mapbox.com/",e.setAttribute("aria-label",this._map._getUIString("LogoControl.Title")),e.setAttribute("rel","noopener nofollow"),this._container.appendChild(e),this._container.style.display="none",this._map.on("sourcedata",this._updateLogo),this._updateLogo(),this._map.on("resize",this._updateCompact),this._updateCompact(),this._container},_i.prototype.onRemove=function(){n.remove(this._container),this._map.off("sourcedata",this._updateLogo),this._map.off("resize",this._updateCompact)},_i.prototype.getDefaultPosition=function(){return"bottom-left"},_i.prototype._updateLogo=function(t){t&&"metadata"!==t.sourceDataType||(this._container.style.display=this._logoRequired()?"block":"none")},_i.prototype._logoRequired=function(){if(this._map.style){var t=this._map.style.sourceCaches;for(var e in t)if(t[e].getSource().mapbox_logo)return!0;return!1}},_i.prototype._updateCompact=function(){var t=this._container.children;if(t.length){var e=t[0];this._map.getCanvasContainer().offsetWidth<250?e.classList.add("mapboxgl-compact"):e.classList.remove("mapboxgl-compact")}};var bi=function(){this._queue=[],this._id=0,this._cleared=!1,this._currentlyRunning=!1};bi.prototype.add=function(t){var e=++this._id;return this._queue.push({callback:t,id:e,cancelled:!1}),e},bi.prototype.remove=function(t){for(var e=this._currentlyRunning,n=0,r=e?this._queue.concat(e):this._queue;n<r.length;n+=1){var i=r[n];if(i.id===t)return void(i.cancelled=!0)}},bi.prototype.run=function(t){void 0===t&&(t=0);var e=this._currentlyRunning=this._queue;this._queue=[];for(var n=0,r=e;n<r.length;n+=1){var i=r[n];if(!i.cancelled&&(i.callback(t),this._cleared))break}this._cleared=!1,this._currentlyRunning=!1},bi.prototype.clear=function(){this._currentlyRunning&&(this._cleared=!0),this._queue=[]};var xi={"AttributionControl.ToggleAttribution":"Toggle attribution","AttributionControl.MapFeedback":"Map feedback","FullscreenControl.Enter":"Enter fullscreen","FullscreenControl.Exit":"Exit fullscreen","GeolocateControl.FindMyLocation":"Find my location","GeolocateControl.LocationNotAvailable":"Location not available","LogoControl.Title":"Mapbox logo","NavigationControl.ResetBearing":"Reset bearing to north","NavigationControl.ZoomIn":"Zoom in","NavigationControl.ZoomOut":"Zoom out","ScaleControl.Feet":"ft","ScaleControl.Meters":"m","ScaleControl.Kilometers":"km","ScaleControl.Miles":"mi","ScaleControl.NauticalMiles":"nm"},wi=t.window.HTMLImageElement,Ei=t.window.HTMLElement,Oi=t.window.ImageBitmap,Si={center:[0,0],zoom:0,bearing:0,pitch:0,minZoom:-2,maxZoom:22,minPitch:0,maxPitch:60,interactive:!0,scrollZoom:!0,boxZoom:!0,dragRotate:!0,dragPan:!0,keyboard:!0,doubleClickZoom:!0,touchZoomRotate:!0,touchPitch:!0,bearingSnap:7,clickTolerance:3,pitchWithRotate:!0,hash:!1,attributionControl:!0,failIfMajorPerformanceCaveat:!1,preserveDrawingBuffer:!1,trackResize:!0,renderWorldCopies:!0,refreshExpiredTiles:!0,maxTileCacheSize:null,localIdeographFontFamily:"sans-serif",transformRequest:null,accessToken:null,fadeDuration:300,crossSourceCollisions:!0},Ti=function(r){function i(e){var n=this;if(null!=(e=t.extend({},Si,e)).minZoom&&null!=e.maxZoom&&e.minZoom>e.maxZoom)throw new Error("maxZoom must be greater than or equal to minZoom");if(null!=e.minPitch&&null!=e.maxPitch&&e.minPitch>e.maxPitch)throw new Error("maxPitch must be greater than or equal to minPitch");if(null!=e.minPitch&&e.minPitch<0)throw new Error("minPitch must be greater than or equal to 0");if(null!=e.maxPitch&&e.maxPitch>60)throw new Error("maxPitch must be less than or equal to 60");var i=new wr(e.minZoom,e.maxZoom,e.minPitch,e.maxPitch,e.renderWorldCopies);if(r.call(this,i,e),this._interactive=e.interactive,this._maxTileCacheSize=e.maxTileCacheSize,this._failIfMajorPerformanceCaveat=e.failIfMajorPerformanceCaveat,this._preserveDrawingBuffer=e.preserveDrawingBuffer,this._antialias=e.antialias,this._trackResize=e.trackResize,this._bearingSnap=e.bearingSnap,this._refreshExpiredTiles=e.refreshExpiredTiles,this._fadeDuration=e.fadeDuration,this._crossSourceCollisions=e.crossSourceCollisions,this._crossFadingFactor=1,this._collectResourceTiming=e.collectResourceTiming,this._renderTaskQueue=new bi,this._controls=[],this._mapId=t.uniqueId(),this._locale=t.extend({},xi,e.locale),this._clickTolerance=e.clickTolerance,this._requestManager=new t.RequestManager(e.transformRequest,e.accessToken),"string"==typeof e.container){if(this._container=t.window.document.getElementById(e.container),!this._container)throw new Error("Container '"+e.container+"' not found.")}else{if(!(e.container instanceof Ei))throw new Error("Invalid type: 'container' must be a String or HTMLElement.");this._container=e.container}if(e.maxBounds&&this.setMaxBounds(e.maxBounds),t.bindAll(["_onWindowOnline","_onWindowResize","_onMapScroll","_contextLost","_contextRestored"],this),this._setupContainer(),this._setupPainter(),void 0===this.painter)throw new Error("Failed to initialize WebGL.");this.on("move",(function(){return n._update(!1)})),this.on("moveend",(function(){return n._update(!1)})),this.on("zoom",(function(){return n._update(!0)})),void 0!==t.window&&(t.window.addEventListener("online",this._onWindowOnline,!1),t.window.addEventListener("resize",this._onWindowResize,!1),t.window.addEventListener("orientationchange",this._onWindowResize,!1)),this.handlers=new mi(this,e),this._hash=e.hash&&new Or("string"==typeof e.hash&&e.hash||void 0).addTo(this),this._hash&&this._hash._onHashChange()||(this.jumpTo({center:e.center,zoom:e.zoom,bearing:e.bearing,pitch:e.pitch}),e.bounds&&(this.resize(),this.fitBounds(e.bounds,t.extend({},e.fitBoundsOptions,{duration:0})))),this.resize(),this._localIdeographFontFamily=e.localIdeographFontFamily,e.style&&this.setStyle(e.style,{localIdeographFontFamily:e.localIdeographFontFamily}),e.attributionControl&&this.addControl(new vi({customAttribution:e.customAttribution})),this.addControl(new _i,e.logoPosition),this.on("style.load",(function(){n.transform.unmodified&&n.jumpTo(n.style.stylesheet)})),this.on("data",(function(e){n._update("style"===e.dataType),n.fire(new t.Event(e.dataType+"data",e))})),this.on("dataloading",(function(e){n.fire(new t.Event(e.dataType+"dataloading",e))}))}r&&(i.__proto__=r),(i.prototype=Object.create(r&&r.prototype)).constructor=i;var o={showTileBoundaries:{configurable:!0},showPadding:{configurable:!0},showCollisionBoxes:{configurable:!0},showOverdrawInspector:{configurable:!0},repaint:{configurable:!0},vertices:{configurable:!0},version:{configurable:!0}};return i.prototype._getMapId=function(){return this._mapId},i.prototype.addControl=function(e,n){if(void 0===n&&(n=e.getDefaultPosition?e.getDefaultPosition():"top-right"),!e||!e.onAdd)return this.fire(new t.ErrorEvent(new Error("Invalid argument to map.addControl(). Argument must be a control with onAdd and onRemove methods.")));var r=e.onAdd(this);this._controls.push(e);var i=this._controlPositions[n];return-1!==n.indexOf("bottom")?i.insertBefore(r,i.firstChild):i.appendChild(r),this},i.prototype.removeControl=function(e){if(!e||!e.onRemove)return this.fire(new t.ErrorEvent(new Error("Invalid argument to map.removeControl(). Argument must be a control with onAdd and onRemove methods.")));var n=this._controls.indexOf(e);return n>-1&&this._controls.splice(n,1),e.onRemove(this),this},i.prototype.hasControl=function(t){return this._controls.indexOf(t)>-1},i.prototype.resize=function(e){var n=this._containerDimensions(),r=n[0],i=n[1];if(r===this.transform.width&&i===this.transform.height)return this;this._resizeCanvas(r,i),this.transform.resize(r,i),this.painter.resize(r,i);var o=!this._moving;return o&&this.fire(new t.Event("movestart",e)).fire(new t.Event("move",e)),this.fire(new t.Event("resize",e)),o&&this.fire(new t.Event("moveend",e)),this},i.prototype.getBounds=function(){return this.transform.getBounds()},i.prototype.getMaxBounds=function(){return this.transform.getMaxBounds()},i.prototype.setMaxBounds=function(e){return this.transform.setMaxBounds(t.LngLatBounds.convert(e)),this._update()},i.prototype.setMinZoom=function(t){if((t=null==t?-2:t)>=-2&&t<=this.transform.maxZoom)return this.transform.minZoom=t,this._update(),this.getZoom()<t&&this.setZoom(t),this;throw new Error("minZoom must be between -2 and the current maxZoom, inclusive")},i.prototype.getMinZoom=function(){return this.transform.minZoom},i.prototype.setMaxZoom=function(t){if((t=null==t?22:t)>=this.transform.minZoom)return this.transform.maxZoom=t,this._update(),this.getZoom()>t&&this.setZoom(t),this;throw new Error("maxZoom must be greater than the current minZoom")},i.prototype.getMaxZoom=function(){return this.transform.maxZoom},i.prototype.setMinPitch=function(t){if((t=null==t?0:t)<0)throw new Error("minPitch must be greater than or equal to 0");if(t>=0&&t<=this.transform.maxPitch)return this.transform.minPitch=t,this._update(),this.getPitch()<t&&this.setPitch(t),this;throw new Error("minPitch must be between 0 and the current maxPitch, inclusive")},i.prototype.getMinPitch=function(){return this.transform.minPitch},i.prototype.setMaxPitch=function(t){if((t=null==t?60:t)>60)throw new Error("maxPitch must be less than or equal to 60");if(t>=this.transform.minPitch)return this.transform.maxPitch=t,this._update(),this.getPitch()>t&&this.setPitch(t),this;throw new Error("maxPitch must be greater than the current minPitch")},i.prototype.getMaxPitch=function(){return this.transform.maxPitch},i.prototype.getRenderWorldCopies=function(){return this.transform.renderWorldCopies},i.prototype.setRenderWorldCopies=function(t){return this.transform.renderWorldCopies=t,this._update()},i.prototype.project=function(e){return this.transform.locationPoint(t.LngLat.convert(e))},i.prototype.unproject=function(e){return this.transform.pointLocation(t.Point.convert(e))},i.prototype.isMoving=function(){return this._moving||this.handlers.isMoving()},i.prototype.isZooming=function(){return this._zooming||this.handlers.isZooming()},i.prototype.isRotating=function(){return this._rotating||this.handlers.isRotating()},i.prototype._createDelegatedListener=function(t,e,n){var r,i=this;if("mouseenter"===t||"mouseover"===t){var o=!1;return{layer:e,listener:n,delegates:{mousemove:function(r){var a=i.getLayer(e)?i.queryRenderedFeatures(r.point,{layers:[e]}):[];a.length?o||(o=!0,n.call(i,new kr(t,i,r.originalEvent,{features:a}))):o=!1},mouseout:function(){o=!1}}}}if("mouseleave"===t||"mouseout"===t){var a=!1;return{layer:e,listener:n,delegates:{mousemove:function(r){(i.getLayer(e)?i.queryRenderedFeatures(r.point,{layers:[e]}):[]).length?a=!0:a&&(a=!1,n.call(i,new kr(t,i,r.originalEvent)))},mouseout:function(e){a&&(a=!1,n.call(i,new kr(t,i,e.originalEvent)))}}}}return{layer:e,listener:n,delegates:(r={},r[t]=function(t){var r=i.getLayer(e)?i.queryRenderedFeatures(t.point,{layers:[e]}):[];r.length&&(t.features=r,n.call(i,t),delete t.features)},r)}},i.prototype.on=function(t,e,n){if(void 0===n)return r.prototype.on.call(this,t,e);var i=this._createDelegatedListener(t,e,n);for(var o in this._delegatedListeners=this._delegatedListeners||{},this._delegatedListeners[t]=this._delegatedListeners[t]||[],this._delegatedListeners[t].push(i),i.delegates)this.on(o,i.delegates[o]);return this},i.prototype.once=function(t,e,n){if(void 0===n)return r.prototype.once.call(this,t,e);var i=this._createDelegatedListener(t,e,n);for(var o in i.delegates)this.once(o,i.delegates[o]);return this},i.prototype.off=function(t,e,n){var i=this;return void 0===n?r.prototype.off.call(this,t,e):(this._delegatedListeners&&this._delegatedListeners[t]&&function(r){for(var o=r[t],a=0;a<o.length;a++){var s=o[a];if(s.layer===e&&s.listener===n){for(var u in s.delegates)i.off(u,s.delegates[u]);return o.splice(a,1),i}}}(this._delegatedListeners),this)},i.prototype.queryRenderedFeatures=function(e,n){if(!this.style)return[];var r;if(void 0!==n||void 0===e||e instanceof t.Point||Array.isArray(e)||(n=e,e=void 0),n=n||{},(e=e||[[0,0],[this.transform.width,this.transform.height]])instanceof t.Point||"number"==typeof e[0])r=[t.Point.convert(e)];else{var i=t.Point.convert(e[0]),o=t.Point.convert(e[1]);r=[i,new t.Point(o.x,i.y),o,new t.Point(i.x,o.y),i]}return this.style.queryRenderedFeatures(r,n,this.transform)},i.prototype.querySourceFeatures=function(t,e){return this.style.querySourceFeatures(t,e)},i.prototype.setStyle=function(e,n){return!1!==(n=t.extend({},{localIdeographFontFamily:this._localIdeographFontFamily},n)).diff&&n.localIdeographFontFamily===this._localIdeographFontFamily&&this.style&&e?(this._diffStyle(e,n),this):(this._localIdeographFontFamily=n.localIdeographFontFamily,this._updateStyle(e,n))},i.prototype._getUIString=function(t){var e=this._locale[t];if(null==e)throw new Error("Missing UI string '"+t+"'");return e},i.prototype._updateStyle=function(t,e){return this.style&&(this.style.setEventedParent(null),this.style._remove()),t?(this.style=new Ve(this,e||{}),this.style.setEventedParent(this,{style:this.style}),"string"==typeof t?this.style.loadURL(t):this.style.loadJSON(t),this):(delete this.style,this)},i.prototype._lazyInitEmptyStyle=function(){this.style||(this.style=new Ve(this,{}),this.style.setEventedParent(this,{style:this.style}),this.style.loadEmpty())},i.prototype._diffStyle=function(e,n){var r=this;if("string"==typeof e){var i=this._requestManager.normalizeStyleURL(e),o=this._requestManager.transformRequest(i,t.ResourceType.Style);t.getJSON(o,(function(e,i){e?r.fire(new t.ErrorEvent(e)):i&&r._updateDiff(i,n)}))}else"object"==typeof e&&this._updateDiff(e,n)},i.prototype._updateDiff=function(e,n){try{this.style.setState(e)&&this._update(!0)}catch(r){t.warnOnce("Unable to perform style diff: "+(r.message||r.error||r)+".  Rebuilding the style from scratch."),this._updateStyle(e,n)}},i.prototype.getStyle=function(){if(this.style)return this.style.serialize()},i.prototype.isStyleLoaded=function(){return this.style?this.style.loaded():t.warnOnce("There is no style added to the map.")},i.prototype.addSource=function(t,e){return this._lazyInitEmptyStyle(),this.style.addSource(t,e),this._update(!0)},i.prototype.isSourceLoaded=function(e){var n=this.style&&this.style.sourceCaches[e];if(void 0!==n)return n.loaded();this.fire(new t.ErrorEvent(new Error("There is no source with ID '"+e+"'")))},i.prototype.areTilesLoaded=function(){var t=this.style&&this.style.sourceCaches;for(var e in t){var n=t[e]._tiles;for(var r in n){var i=n[r];if("loaded"!==i.state&&"errored"!==i.state)return!1}}return!0},i.prototype.addSourceType=function(t,e,n){return this._lazyInitEmptyStyle(),this.style.addSourceType(t,e,n)},i.prototype.removeSource=function(t){return this.style.removeSource(t),this._update(!0)},i.prototype.getSource=function(t){return this.style.getSource(t)},i.prototype.addImage=function(e,n,r){void 0===r&&(r={});var i=r.pixelRatio;void 0===i&&(i=1);var o=r.sdf;void 0===o&&(o=!1);var a=r.stretchX,s=r.stretchY,u=r.content;if(this._lazyInitEmptyStyle(),n instanceof wi||Oi&&n instanceof Oi){var c=t.browser.getImageData(n);this.style.addImage(e,{data:new t.RGBAImage({width:c.width,height:c.height},c.data),pixelRatio:i,stretchX:a,stretchY:s,content:u,sdf:o,version:0})}else{if(void 0===n.width||void 0===n.height)return this.fire(new t.ErrorEvent(new Error("Invalid arguments to map.addImage(). The second argument must be an `HTMLImageElement`, `ImageData`, `ImageBitmap`, or object with `width`, `height`, and `data` properties with the same format as `ImageData`")));var l=n;this.style.addImage(e,{data:new t.RGBAImage({width:n.width,height:n.height},new Uint8Array(n.data)),pixelRatio:i,stretchX:a,stretchY:s,content:u,sdf:o,version:0,userImage:l}),l.onAdd&&l.onAdd(this,e)}},i.prototype.updateImage=function(e,n){var r=this.style.getImage(e);if(!r)return this.fire(new t.ErrorEvent(new Error("The map has no image with that id. If you are adding a new image use `map.addImage(...)` instead.")));var i=n instanceof wi||Oi&&n instanceof Oi?t.browser.getImageData(n):n,o=i.width,a=i.height,s=i.data;return void 0===o||void 0===a?this.fire(new t.ErrorEvent(new Error("Invalid arguments to map.updateImage(). The second argument must be an `HTMLImageElement`, `ImageData`, `ImageBitmap`, or object with `width`, `height`, and `data` properties with the same format as `ImageData`"))):o!==r.data.width||a!==r.data.height?this.fire(new t.ErrorEvent(new Error("The width and height of the updated image must be that same as the previous version of the image"))):(r.data.replace(s,!(n instanceof wi||Oi&&n instanceof Oi)),void this.style.updateImage(e,r))},i.prototype.hasImage=function(e){return e?!!this.style.getImage(e):(this.fire(new t.ErrorEvent(new Error("Missing required image id"))),!1)},i.prototype.removeImage=function(t){this.style.removeImage(t)},i.prototype.loadImage=function(e,n){t.getImage(this._requestManager.transformRequest(e,t.ResourceType.Image),n)},i.prototype.listImages=function(){return this.style.listImages()},i.prototype.addLayer=function(t,e){return this._lazyInitEmptyStyle(),this.style.addLayer(t,e),this._update(!0)},i.prototype.moveLayer=function(t,e){return this.style.moveLayer(t,e),this._update(!0)},i.prototype.removeLayer=function(t){return this.style.removeLayer(t),this._update(!0)},i.prototype.getLayer=function(t){return this.style.getLayer(t)},i.prototype.setLayerZoomRange=function(t,e,n){return this.style.setLayerZoomRange(t,e,n),this._update(!0)},i.prototype.setFilter=function(t,e,n){return void 0===n&&(n={}),this.style.setFilter(t,e,n),this._update(!0)},i.prototype.getFilter=function(t){return this.style.getFilter(t)},i.prototype.setPaintProperty=function(t,e,n,r){return void 0===r&&(r={}),this.style.setPaintProperty(t,e,n,r),this._update(!0)},i.prototype.getPaintProperty=function(t,e){return this.style.getPaintProperty(t,e)},i.prototype.setLayoutProperty=function(t,e,n,r){return void 0===r&&(r={}),this.style.setLayoutProperty(t,e,n,r),this._update(!0)},i.prototype.getLayoutProperty=function(t,e){return this.style.getLayoutProperty(t,e)},i.prototype.setLight=function(t,e){return void 0===e&&(e={}),this._lazyInitEmptyStyle(),this.style.setLight(t,e),this._update(!0)},i.prototype.getLight=function(){return this.style.getLight()},i.prototype.setFeatureState=function(t,e){return this.style.setFeatureState(t,e),this._update()},i.prototype.removeFeatureState=function(t,e){return this.style.removeFeatureState(t,e),this._update()},i.prototype.getFeatureState=function(t){return this.style.getFeatureState(t)},i.prototype.getContainer=function(){return this._container},i.prototype.getCanvasContainer=function(){return this._canvasContainer},i.prototype.getCanvas=function(){return this._canvas},i.prototype._containerDimensions=function(){var t=0,e=0;return this._container&&(t=this._container.clientWidth||400,e=this._container.clientHeight||300),[t,e]},i.prototype._detectMissingCSS=function(){"rgb(250, 128, 114)"!==t.window.getComputedStyle(this._missingCSSCanary).getPropertyValue("background-color")&&t.warnOnce("This page appears to be missing CSS declarations for Mapbox GL JS, which may cause the map to display incorrectly. Please ensure your page includes mapbox-gl.css, as described in https://www.mapbox.com/mapbox-gl-js/api/.")},i.prototype._setupContainer=function(){var t=this._container;t.classList.add("mapboxgl-map"),(this._missingCSSCanary=n.create("div","mapboxgl-canary",t)).style.visibility="hidden",this._detectMissingCSS();var e=this._canvasContainer=n.create("div","mapboxgl-canvas-container",t);this._interactive&&e.classList.add("mapboxgl-interactive"),this._canvas=n.create("canvas","mapboxgl-canvas",e),this._canvas.addEventListener("webglcontextlost",this._contextLost,!1),this._canvas.addEventListener("webglcontextrestored",this._contextRestored,!1),this._canvas.setAttribute("tabindex","0"),this._canvas.setAttribute("aria-label","Map"),this._canvas.setAttribute("role","region");var r=this._containerDimensions();this._resizeCanvas(r[0],r[1]);var i=this._controlContainer=n.create("div","mapboxgl-control-container",t),o=this._controlPositions={};["top-left","top-right","bottom-left","bottom-right"].forEach((function(t){o[t]=n.create("div","mapboxgl-ctrl-"+t,i)})),this._container.addEventListener("scroll",this._onMapScroll,!1)},i.prototype._resizeCanvas=function(e,n){var r=t.browser.devicePixelRatio||1;this._canvas.width=r*e,this._canvas.height=r*n,this._canvas.style.width=e+"px",this._canvas.style.height=n+"px"},i.prototype._setupPainter=function(){var n=t.extend({},e.webGLContextAttributes,{failIfMajorPerformanceCaveat:this._failIfMajorPerformanceCaveat,preserveDrawingBuffer:this._preserveDrawingBuffer,antialias:this._antialias||!1}),r=this._canvas.getContext("webgl",n)||this._canvas.getContext("experimental-webgl",n);r?(this.painter=new vr(r,this.transform),t.webpSupported.testSupport(r)):this.fire(new t.ErrorEvent(new Error("Failed to initialize WebGL")))},i.prototype._contextLost=function(e){e.preventDefault(),this._frame&&(this._frame.cancel(),this._frame=null),this.fire(new t.Event("webglcontextlost",{originalEvent:e}))},i.prototype._contextRestored=function(e){this._setupPainter(),this.resize(),this._update(),this.fire(new t.Event("webglcontextrestored",{originalEvent:e}))},i.prototype._onMapScroll=function(t){if(t.target===this._container)return this._container.scrollTop=0,this._container.scrollLeft=0,!1},i.prototype.loaded=function(){return!this._styleDirty&&!this._sourcesDirty&&!!this.style&&this.style.loaded()},i.prototype._update=function(t){return this.style?(this._styleDirty=this._styleDirty||t,this._sourcesDirty=!0,this.triggerRepaint(),this):this},i.prototype._requestRenderFrame=function(t){return this._update(),this._renderTaskQueue.add(t)},i.prototype._cancelRenderFrame=function(t){this._renderTaskQueue.remove(t)},i.prototype._render=function(e){var n,r=this,i=0,o=this.painter.context.extTimerQuery;if(this.listens("gpu-timing-frame")&&(n=o.createQueryEXT(),o.beginQueryEXT(o.TIME_ELAPSED_EXT,n),i=t.browser.now()),this.painter.context.setDirty(),this.painter.setBaseState(),this._renderTaskQueue.run(e),!this._removed){var a=!1;if(this.style&&this._styleDirty){this._styleDirty=!1;var s=this.transform.zoom,u=t.browser.now();this.style.zoomHistory.update(s,u);var c=new t.EvaluationParameters(s,{now:u,fadeDuration:this._fadeDuration,zoomHistory:this.style.zoomHistory,transition:this.style.getTransition()}),l=c.crossFadingFactor();1===l&&l===this._crossFadingFactor||(a=!0,this._crossFadingFactor=l),this.style.update(c)}if(this.style&&this._sourcesDirty&&(this._sourcesDirty=!1,this.style._updateSources(this.transform)),this._placementDirty=this.style&&this.style._updatePlacement(this.painter.transform,this.showCollisionBoxes,this._fadeDuration,this._crossSourceCollisions),this.painter.render(this.style,{showTileBoundaries:this.showTileBoundaries,showOverdrawInspector:this._showOverdrawInspector,rotating:this.isRotating(),zooming:this.isZooming(),moving:this.isMoving(),fadeDuration:this._fadeDuration,showPadding:this.showPadding,gpuTiming:!!this.listens("gpu-timing-layer")}),this.fire(new t.Event("render")),this.loaded()&&!this._loaded&&(this._loaded=!0,this.fire(new t.Event("load"))),this.style&&(this.style.hasTransitions()||a)&&(this._styleDirty=!0),this.style&&!this._placementDirty&&this.style._releaseSymbolFadeTiles(),this.listens("gpu-timing-frame")){var h=t.browser.now()-i;o.endQueryEXT(o.TIME_ELAPSED_EXT,n),setTimeout((function(){var e=o.getQueryObjectEXT(n,o.QUERY_RESULT_EXT)/1e6;o.deleteQueryEXT(n),r.fire(new t.Event("gpu-timing-frame",{cpuTime:h,gpuTime:e}))}),50)}if(this.listens("gpu-timing-layer")){var f=this.painter.collectGpuTimers();setTimeout((function(){var e=r.painter.queryGpuTimers(f);r.fire(new t.Event("gpu-timing-layer",{layerTimes:e}))}),50)}var p=this._sourcesDirty||this._styleDirty||this._placementDirty;return p||this._repaint?this.triggerRepaint():!this.isMoving()&&this.loaded()&&this.fire(new t.Event("idle")),!this._loaded||this._fullyLoaded||p||(this._fullyLoaded=!0),this}},i.prototype.remove=function(){this._hash&&this._hash.remove();for(var e=0,n=this._controls;e<n.length;e+=1)n[e].onRemove(this);this._controls=[],this._frame&&(this._frame.cancel(),this._frame=null),this._renderTaskQueue.clear(),this.painter.destroy(),this.handlers.destroy(),delete this.handlers,this.setStyle(null),void 0!==t.window&&(t.window.removeEventListener("resize",this._onWindowResize,!1),t.window.removeEventListener("orientationchange",this._onWindowResize,!1),t.window.removeEventListener("online",this._onWindowOnline,!1));var r=this.painter.context.gl.getExtension("WEBGL_lose_context");r&&r.loseContext(),Ci(this._canvasContainer),Ci(this._controlContainer),Ci(this._missingCSSCanary),this._container.classList.remove("mapboxgl-map"),this._removed=!0,this.fire(new t.Event("remove"))},i.prototype.triggerRepaint=function(){var e=this;this.style&&!this._frame&&(this._frame=t.browser.frame((function(t){e._frame=null,e._render(t)})))},i.prototype._onWindowOnline=function(){this._update()},i.prototype._onWindowResize=function(t){this._trackResize&&this.resize({originalEvent:t})._update()},o.showTileBoundaries.get=function(){return!!this._showTileBoundaries},o.showTileBoundaries.set=function(t){this._showTileBoundaries!==t&&(this._showTileBoundaries=t,this._update())},o.showPadding.get=function(){return!!this._showPadding},o.showPadding.set=function(t){this._showPadding!==t&&(this._showPadding=t,this._update())},o.showCollisionBoxes.get=function(){return!!this._showCollisionBoxes},o.showCollisionBoxes.set=function(t){this._showCollisionBoxes!==t&&(this._showCollisionBoxes=t,t?this.style._generateCollisionBoxes():this._update())},o.showOverdrawInspector.get=function(){return!!this._showOverdrawInspector},o.showOverdrawInspector.set=function(t){this._showOverdrawInspector!==t&&(this._showOverdrawInspector=t,this._update())},o.repaint.get=function(){return!!this._repaint},o.repaint.set=function(t){this._repaint!==t&&(this._repaint=t,this.triggerRepaint())},o.vertices.get=function(){return!!this._vertices},o.vertices.set=function(t){this._vertices=t,this._update()},i.prototype._setCacheLimits=function(e,n){t.setCacheLimits(e,n)},o.version.get=function(){return t.version},Object.defineProperties(i.prototype,o),i}(yi);function Ci(t){t.parentNode&&t.parentNode.removeChild(t)}var Pi={showCompass:!0,showZoom:!0,visualizePitch:!1},Mi=function(e){var r=this;this.options=t.extend({},Pi,e),this._container=n.create("div","mapboxgl-ctrl mapboxgl-ctrl-group"),this._container.addEventListener("contextmenu",(function(t){return t.preventDefault()})),this.options.showZoom&&(t.bindAll(["_setButtonTitle","_updateZoomButtons"],this),this._zoomInButton=this._createButton("mapboxgl-ctrl-zoom-in",(function(t){return r._map.zoomIn({},{originalEvent:t})})),n.create("span","mapboxgl-ctrl-icon",this._zoomInButton).setAttribute("aria-hidden",!0),this._zoomOutButton=this._createButton("mapboxgl-ctrl-zoom-out",(function(t){return r._map.zoomOut({},{originalEvent:t})})),n.create("span","mapboxgl-ctrl-icon",this._zoomOutButton).setAttribute("aria-hidden",!0)),this.options.showCompass&&(t.bindAll(["_rotateCompassArrow"],this),this._compass=this._createButton("mapboxgl-ctrl-compass",(function(t){r.options.visualizePitch?r._map.resetNorthPitch({},{originalEvent:t}):r._map.resetNorth({},{originalEvent:t})})),this._compassIcon=n.create("span","mapboxgl-ctrl-icon",this._compass),this._compassIcon.setAttribute("aria-hidden",!0))};Mi.prototype._updateZoomButtons=function(){var t=this._map.getZoom(),e=t===this._map.getMaxZoom(),n=t===this._map.getMinZoom();this._zoomInButton.disabled=e,this._zoomOutButton.disabled=n,this._zoomInButton.setAttribute("aria-disabled",e.toString()),this._zoomOutButton.setAttribute("aria-disabled",n.toString())},Mi.prototype._rotateCompassArrow=function(){var t=this.options.visualizePitch?"scale("+1/Math.pow(Math.cos(this._map.transform.pitch*(Math.PI/180)),.5)+") rotateX("+this._map.transform.pitch+"deg) rotateZ("+this._map.transform.angle*(180/Math.PI)+"deg)":"rotate("+this._map.transform.angle*(180/Math.PI)+"deg)";this._compassIcon.style.transform=t},Mi.prototype.onAdd=function(t){return this._map=t,this.options.showZoom&&(this._setButtonTitle(this._zoomInButton,"ZoomIn"),this._setButtonTitle(this._zoomOutButton,"ZoomOut"),this._map.on("zoom",this._updateZoomButtons),this._updateZoomButtons()),this.options.showCompass&&(this._setButtonTitle(this._compass,"ResetBearing"),this.options.visualizePitch&&this._map.on("pitch",this._rotateCompassArrow),this._map.on("rotate",this._rotateCompassArrow),this._rotateCompassArrow(),this._handler=new Ii(this._map,this._compass,this.options.visualizePitch)),this._container},Mi.prototype.onRemove=function(){n.remove(this._container),this.options.showZoom&&this._map.off("zoom",this._updateZoomButtons),this.options.showCompass&&(this.options.visualizePitch&&this._map.off("pitch",this._rotateCompassArrow),this._map.off("rotate",this._rotateCompassArrow),this._handler.off(),delete this._handler),delete this._map},Mi.prototype._createButton=function(t,e){var r=n.create("button",t,this._container);return r.type="button",r.addEventListener("click",e),r},Mi.prototype._setButtonTitle=function(t,e){var n=this._map._getUIString("NavigationControl."+e);t.title=n,t.setAttribute("aria-label",n)};var Ii=function(e,r,i){void 0===i&&(i=!1),this._clickTolerance=10,this.element=r,this.mouseRotate=new Xr({clickTolerance:e.dragRotate._mouseRotate._clickTolerance}),this.map=e,i&&(this.mousePitch=new Zr({clickTolerance:e.dragRotate._mousePitch._clickTolerance})),t.bindAll(["mousedown","mousemove","mouseup","touchstart","touchmove","touchend","reset"],this),n.addEventListener(r,"mousedown",this.mousedown),n.addEventListener(r,"touchstart",this.touchstart,{passive:!1}),n.addEventListener(r,"touchmove",this.touchmove),n.addEventListener(r,"touchend",this.touchend),n.addEventListener(r,"touchcancel",this.reset)};function Bi(e,n,r){if(e=new t.LngLat(e.lng,e.lat),n){var i=new t.LngLat(e.lng-360,e.lat),o=new t.LngLat(e.lng+360,e.lat),a=r.locationPoint(e).distSqr(n);r.locationPoint(i).distSqr(n)<a?e=i:r.locationPoint(o).distSqr(n)<a&&(e=o)}for(;Math.abs(e.lng-r.center.lng)>180;){var s=r.locationPoint(e);if(s.x>=0&&s.y>=0&&s.x<=r.width&&s.y<=r.height)break;e.lng>r.center.lng?e.lng-=360:e.lng+=360}return e}Ii.prototype.down=function(t,e){this.mouseRotate.mousedown(t,e),this.mousePitch&&this.mousePitch.mousedown(t,e),n.disableDrag()},Ii.prototype.move=function(t,e){var n=this.map,r=this.mouseRotate.mousemoveWindow(t,e);if(r&&r.bearingDelta&&n.setBearing(n.getBearing()+r.bearingDelta),this.mousePitch){var i=this.mousePitch.mousemoveWindow(t,e);i&&i.pitchDelta&&n.setPitch(n.getPitch()+i.pitchDelta)}},Ii.prototype.off=function(){var t=this.element;n.removeEventListener(t,"mousedown",this.mousedown),n.removeEventListener(t,"touchstart",this.touchstart,{passive:!1}),n.removeEventListener(t,"touchmove",this.touchmove),n.removeEventListener(t,"touchend",this.touchend),n.removeEventListener(t,"touchcancel",this.reset),this.offTemp()},Ii.prototype.offTemp=function(){n.enableDrag(),n.removeEventListener(t.window,"mousemove",this.mousemove),n.removeEventListener(t.window,"mouseup",this.mouseup)},Ii.prototype.mousedown=function(e){this.down(t.extend({},e,{ctrlKey:!0,preventDefault:function(){return e.preventDefault()}}),n.mousePos(this.element,e)),n.addEventListener(t.window,"mousemove",this.mousemove),n.addEventListener(t.window,"mouseup",this.mouseup)},Ii.prototype.mousemove=function(t){this.move(t,n.mousePos(this.element,t))},Ii.prototype.mouseup=function(t){this.mouseRotate.mouseupWindow(t),this.mousePitch&&this.mousePitch.mouseupWindow(t),this.offTemp()},Ii.prototype.touchstart=function(t){1!==t.targetTouches.length?this.reset():(this._startPos=this._lastPos=n.touchPos(this.element,t.targetTouches)[0],this.down({type:"mousedown",button:0,ctrlKey:!0,preventDefault:function(){return t.preventDefault()}},this._startPos))},Ii.prototype.touchmove=function(t){1!==t.targetTouches.length?this.reset():(this._lastPos=n.touchPos(this.element,t.targetTouches)[0],this.move({preventDefault:function(){return t.preventDefault()}},this._lastPos))},Ii.prototype.touchend=function(t){0===t.targetTouches.length&&this._startPos&&this._lastPos&&this._startPos.dist(this._lastPos)<this._clickTolerance&&this.element.click(),this.reset()},Ii.prototype.reset=function(){this.mouseRotate.reset(),this.mousePitch&&this.mousePitch.reset(),delete this._startPos,delete this._lastPos,this.offTemp()};var Ri={center:"translate(-50%,-50%)",top:"translate(-50%,0)","top-left":"translate(0,0)","top-right":"translate(-100%,0)",bottom:"translate(-50%,-100%)","bottom-left":"translate(0,-100%)","bottom-right":"translate(-100%,-100%)",left:"translate(0,-50%)",right:"translate(-100%,-50%)"};function ki(t,e,n){var r=t.classList;for(var i in Ri)r.remove("mapboxgl-"+n+"-anchor-"+i);r.add("mapboxgl-"+n+"-anchor-"+e)}var Di,Li=function(e){function r(r,i){if(e.call(this),(r instanceof t.window.HTMLElement||i)&&(r=t.extend({element:r},i)),t.bindAll(["_update","_onMove","_onUp","_addDragHandler","_onMapClick","_onKeyPress"],this),this._anchor=r&&r.anchor||"center",this._color=r&&r.color||"#3FB1CE",this._scale=r&&r.scale||1,this._draggable=r&&r.draggable||!1,this._clickTolerance=r&&r.clickTolerance||0,this._isDragging=!1,this._state="inactive",this._rotation=r&&r.rotation||0,this._rotationAlignment=r&&r.rotationAlignment||"auto",this._pitchAlignment=r&&r.pitchAlignment&&"auto"!==r.pitchAlignment?r.pitchAlignment:this._rotationAlignment,r&&r.element)this._element=r.element,this._offset=t.Point.convert(r&&r.offset||[0,0]);else{this._defaultMarker=!0,this._element=n.create("div"),this._element.setAttribute("aria-label","Map marker");var o=n.createNS("http://www.w3.org/2000/svg","svg");o.setAttributeNS(null,"display","block"),o.setAttributeNS(null,"height","41px"),o.setAttributeNS(null,"width","27px"),o.setAttributeNS(null,"viewBox","0 0 27 41");var a=n.createNS("http://www.w3.org/2000/svg","g");a.setAttributeNS(null,"stroke","none"),a.setAttributeNS(null,"stroke-width","1"),a.setAttributeNS(null,"fill","none"),a.setAttributeNS(null,"fill-rule","evenodd");var s=n.createNS("http://www.w3.org/2000/svg","g");s.setAttributeNS(null,"fill-rule","nonzero");var u=n.createNS("http://www.w3.org/2000/svg","g");u.setAttributeNS(null,"transform","translate(3.0, 29.0)"),u.setAttributeNS(null,"fill","#000000");for(var c=0,l=[{rx:"10.5",ry:"5.25002273"},{rx:"10.5",ry:"5.25002273"},{rx:"9.5",ry:"4.77275007"},{rx:"8.5",ry:"4.29549936"},{rx:"7.5",ry:"3.81822308"},{rx:"6.5",ry:"3.34094679"},{rx:"5.5",ry:"2.86367051"},{rx:"4.5",ry:"2.38636864"}];c<l.length;c+=1){var h=l[c],f=n.createNS("http://www.w3.org/2000/svg","ellipse");f.setAttributeNS(null,"opacity","0.04"),f.setAttributeNS(null,"cx","10.5"),f.setAttributeNS(null,"cy","5.80029008"),f.setAttributeNS(null,"rx",h.rx),f.setAttributeNS(null,"ry",h.ry),u.appendChild(f)}var p=n.createNS("http://www.w3.org/2000/svg","g");p.setAttributeNS(null,"fill",this._color);var d=n.createNS("http://www.w3.org/2000/svg","path");d.setAttributeNS(null,"d","M27,13.5 C27,19.074644 20.250001,27.000002 14.75,34.500002 C14.016665,35.500004 12.983335,35.500004 12.25,34.500002 C6.7499993,27.000002 0,19.222562 0,13.5 C0,6.0441559 6.0441559,0 13.5,0 C20.955844,0 27,6.0441559 27,13.5 Z"),p.appendChild(d);var A=n.createNS("http://www.w3.org/2000/svg","g");A.setAttributeNS(null,"opacity","0.25"),A.setAttributeNS(null,"fill","#000000");var g=n.createNS("http://www.w3.org/2000/svg","path");g.setAttributeNS(null,"d","M13.5,0 C6.0441559,0 0,6.0441559 0,13.5 C0,19.222562 6.7499993,27 12.25,34.5 C13,35.522727 14.016664,35.500004 14.75,34.5 C20.250001,27 27,19.074644 27,13.5 C27,6.0441559 20.955844,0 13.5,0 Z M13.5,1 C20.415404,1 26,6.584596 26,13.5 C26,15.898657 24.495584,19.181431 22.220703,22.738281 C19.945823,26.295132 16.705119,30.142167 13.943359,33.908203 C13.743445,34.180814 13.612715,34.322738 13.5,34.441406 C13.387285,34.322738 13.256555,34.180814 13.056641,33.908203 C10.284481,30.127985 7.4148684,26.314159 5.015625,22.773438 C2.6163816,19.232715 1,15.953538 1,13.5 C1,6.584596 6.584596,1 13.5,1 Z"),A.appendChild(g);var m=n.createNS("http://www.w3.org/2000/svg","g");m.setAttributeNS(null,"transform","translate(6.0, 7.0)"),m.setAttributeNS(null,"fill","#FFFFFF");var y=n.createNS("http://www.w3.org/2000/svg","g");y.setAttributeNS(null,"transform","translate(8.0, 8.0)");var v=n.createNS("http://www.w3.org/2000/svg","circle");v.setAttributeNS(null,"fill","#000000"),v.setAttributeNS(null,"opacity","0.25"),v.setAttributeNS(null,"cx","5.5"),v.setAttributeNS(null,"cy","5.5"),v.setAttributeNS(null,"r","5.4999962");var _=n.createNS("http://www.w3.org/2000/svg","circle");_.setAttributeNS(null,"fill","#FFFFFF"),_.setAttributeNS(null,"cx","5.5"),_.setAttributeNS(null,"cy","5.5"),_.setAttributeNS(null,"r","5.4999962"),y.appendChild(v),y.appendChild(_),s.appendChild(u),s.appendChild(p),s.appendChild(A),s.appendChild(m),s.appendChild(y),o.appendChild(s),o.setAttributeNS(null,"height",41*this._scale+"px"),o.setAttributeNS(null,"width",27*this._scale+"px"),this._element.appendChild(o),this._offset=t.Point.convert(r&&r.offset||[0,-14])}this._element.classList.add("mapboxgl-marker"),this._element.addEventListener("dragstart",(function(t){t.preventDefault()})),this._element.addEventListener("mousedown",(function(t){t.preventDefault()})),ki(this._element,this._anchor,"marker"),this._popup=null}return e&&(r.__proto__=e),(r.prototype=Object.create(e&&e.prototype)).constructor=r,r.prototype.addTo=function(t){return this.remove(),this._map=t,t.getCanvasContainer().appendChild(this._element),t.on("move",this._update),t.on("moveend",this._update),this.setDraggable(this._draggable),this._update(),this._map.on("click",this._onMapClick),this},r.prototype.remove=function(){return this._map&&(this._map.off("click",this._onMapClick),this._map.off("move",this._update),this._map.off("moveend",this._update),this._map.off("mousedown",this._addDragHandler),this._map.off("touchstart",this._addDragHandler),this._map.off("mouseup",this._onUp),this._map.off("touchend",this._onUp),this._map.off("mousemove",this._onMove),this._map.off("touchmove",this._onMove),delete this._map),n.remove(this._element),this._popup&&this._popup.remove(),this},r.prototype.getLngLat=function(){return this._lngLat},r.prototype.setLngLat=function(e){return this._lngLat=t.LngLat.convert(e),this._pos=null,this._popup&&this._popup.setLngLat(this._lngLat),this._update(),this},r.prototype.getElement=function(){return this._element},r.prototype.setPopup=function(t){if(this._popup&&(this._popup.remove(),this._popup=null,this._element.removeEventListener("keypress",this._onKeyPress),this._originalTabIndex||this._element.removeAttribute("tabindex")),t){if(!("offset"in t.options)){var e=Math.sqrt(Math.pow(13.5,2)/2);t.options.offset=this._defaultMarker?{top:[0,0],"top-left":[0,0],"top-right":[0,0],bottom:[0,-38.1],"bottom-left":[e,-1*(24.6+e)],"bottom-right":[-e,-1*(24.6+e)],left:[13.5,-24.6],right:[-13.5,-24.6]}:this._offset}this._popup=t,this._lngLat&&this._popup.setLngLat(this._lngLat),this._originalTabIndex=this._element.getAttribute("tabindex"),this._originalTabIndex||this._element.setAttribute("tabindex","0"),this._element.addEventListener("keypress",this._onKeyPress)}return this},r.prototype._onKeyPress=function(t){var e=t.code,n=t.charCode||t.keyCode;"Space"!==e&&"Enter"!==e&&32!==n&&13!==n||this.togglePopup()},r.prototype._onMapClick=function(t){var e=t.originalEvent.target,n=this._element;this._popup&&(e===n||n.contains(e))&&this.togglePopup()},r.prototype.getPopup=function(){return this._popup},r.prototype.togglePopup=function(){var t=this._popup;return t?(t.isOpen()?t.remove():t.addTo(this._map),this):this},r.prototype._update=function(t){if(this._map){this._map.transform.renderWorldCopies&&(this._lngLat=Bi(this._lngLat,this._pos,this._map.transform)),this._pos=this._map.project(this._lngLat)._add(this._offset);var e="";"viewport"===this._rotationAlignment||"auto"===this._rotationAlignment?e="rotateZ("+this._rotation+"deg)":"map"===this._rotationAlignment&&(e="rotateZ("+(this._rotation-this._map.getBearing())+"deg)");var r="";"viewport"===this._pitchAlignment||"auto"===this._pitchAlignment?r="rotateX(0deg)":"map"===this._pitchAlignment&&(r="rotateX("+this._map.getPitch()+"deg)"),t&&"moveend"!==t.type||(this._pos=this._pos.round()),n.setTransform(this._element,Ri[this._anchor]+" translate("+this._pos.x+"px, "+this._pos.y+"px) "+r+" "+e)}},r.prototype.getOffset=function(){return this._offset},r.prototype.setOffset=function(e){return this._offset=t.Point.convert(e),this._update(),this},r.prototype._onMove=function(e){if(!this._isDragging){var n=this._clickTolerance||this._map._clickTolerance;this._isDragging=e.point.dist(this._pointerdownPos)>=n}this._isDragging&&(this._pos=e.point.sub(this._positionDelta),this._lngLat=this._map.unproject(this._pos),this.setLngLat(this._lngLat),this._element.style.pointerEvents="none","pending"===this._state&&(this._state="active",this.fire(new t.Event("dragstart"))),this.fire(new t.Event("drag")))},r.prototype._onUp=function(){this._element.style.pointerEvents="auto",this._positionDelta=null,this._pointerdownPos=null,this._isDragging=!1,this._map.off("mousemove",this._onMove),this._map.off("touchmove",this._onMove),"active"===this._state&&this.fire(new t.Event("dragend")),this._state="inactive"},r.prototype._addDragHandler=function(t){this._element.contains(t.originalEvent.target)&&(t.preventDefault(),this._positionDelta=t.point.sub(this._pos).add(this._offset),this._pointerdownPos=t.point,this._state="pending",this._map.on("mousemove",this._onMove),this._map.on("touchmove",this._onMove),this._map.once("mouseup",this._onUp),this._map.once("touchend",this._onUp))},r.prototype.setDraggable=function(t){return this._draggable=!!t,this._map&&(t?(this._map.on("mousedown",this._addDragHandler),this._map.on("touchstart",this._addDragHandler)):(this._map.off("mousedown",this._addDragHandler),this._map.off("touchstart",this._addDragHandler))),this},r.prototype.isDraggable=function(){return this._draggable},r.prototype.setRotation=function(t){return this._rotation=t||0,this._update(),this},r.prototype.getRotation=function(){return this._rotation},r.prototype.setRotationAlignment=function(t){return this._rotationAlignment=t||"auto",this._update(),this},r.prototype.getRotationAlignment=function(){return this._rotationAlignment},r.prototype.setPitchAlignment=function(t){return this._pitchAlignment=t&&"auto"!==t?t:this._rotationAlignment,this._update(),this},r.prototype.getPitchAlignment=function(){return this._pitchAlignment},r}(t.Evented),ji={positionOptions:{enableHighAccuracy:!1,maximumAge:0,timeout:6e3},fitBoundsOptions:{maxZoom:15},trackUserLocation:!1,showAccuracyCircle:!0,showUserLocation:!0},Fi=0,zi=!1,Ui=function(e){function r(n){e.call(this),this.options=t.extend({},ji,n),t.bindAll(["_onSuccess","_onError","_onZoom","_finish","_setupUI","_updateCamera","_updateMarker"],this)}return e&&(r.__proto__=e),(r.prototype=Object.create(e&&e.prototype)).constructor=r,r.prototype.onAdd=function(e){var r;return this._map=e,this._container=n.create("div","mapboxgl-ctrl mapboxgl-ctrl-group"),r=this._setupUI,void 0!==Di?r(Di):void 0!==t.window.navigator.permissions?t.window.navigator.permissions.query({name:"geolocation"}).then((function(t){r(Di="denied"!==t.state)})):r(Di=!!t.window.navigator.geolocation),this._container},r.prototype.onRemove=function(){void 0!==this._geolocationWatchID&&(t.window.navigator.geolocation.clearWatch(this._geolocationWatchID),this._geolocationWatchID=void 0),this.options.showUserLocation&&this._userLocationDotMarker&&this._userLocationDotMarker.remove(),this.options.showAccuracyCircle&&this._accuracyCircleMarker&&this._accuracyCircleMarker.remove(),n.remove(this._container),this._map.off("zoom",this._onZoom),this._map=void 0,Fi=0,zi=!1},r.prototype._isOutOfMapMaxBounds=function(t){var e=this._map.getMaxBounds(),n=t.coords;return e&&(n.longitude<e.getWest()||n.longitude>e.getEast()||n.latitude<e.getSouth()||n.latitude>e.getNorth())},r.prototype._setErrorState=function(){switch(this._watchState){case"WAITING_ACTIVE":this._watchState="ACTIVE_ERROR",this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-active"),this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-active-error");break;case"ACTIVE_LOCK":this._watchState="ACTIVE_ERROR",this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-active"),this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-active-error"),this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-waiting");break;case"BACKGROUND":this._watchState="BACKGROUND_ERROR",this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-background"),this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-background-error"),this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-waiting")}},r.prototype._onSuccess=function(e){if(this._map){if(this._isOutOfMapMaxBounds(e))return this._setErrorState(),this.fire(new t.Event("outofmaxbounds",e)),this._updateMarker(),void this._finish();if(this.options.trackUserLocation)switch(this._lastKnownPosition=e,this._watchState){case"WAITING_ACTIVE":case"ACTIVE_LOCK":case"ACTIVE_ERROR":this._watchState="ACTIVE_LOCK",this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-waiting"),this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-active-error"),this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-active");break;case"BACKGROUND":case"BACKGROUND_ERROR":this._watchState="BACKGROUND",this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-waiting"),this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-background-error"),this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-background")}this.options.showUserLocation&&"OFF"!==this._watchState&&this._updateMarker(e),this.options.trackUserLocation&&"ACTIVE_LOCK"!==this._watchState||this._updateCamera(e),this.options.showUserLocation&&this._dotElement.classList.remove("mapboxgl-user-location-dot-stale"),this.fire(new t.Event("geolocate",e)),this._finish()}},r.prototype._updateCamera=function(e){var n=new t.LngLat(e.coords.longitude,e.coords.latitude),r=e.coords.accuracy,i=this._map.getBearing(),o=t.extend({bearing:i},this.options.fitBoundsOptions);this._map.fitBounds(n.toBounds(r),o,{geolocateSource:!0})},r.prototype._updateMarker=function(e){if(e){var n=new t.LngLat(e.coords.longitude,e.coords.latitude);this._accuracyCircleMarker.setLngLat(n).addTo(this._map),this._userLocationDotMarker.setLngLat(n).addTo(this._map),this._accuracy=e.coords.accuracy,this.options.showUserLocation&&this.options.showAccuracyCircle&&this._updateCircleRadius()}else this._userLocationDotMarker.remove(),this._accuracyCircleMarker.remove()},r.prototype._updateCircleRadius=function(){var t=this._map._container.clientHeight/2,e=this._map.unproject([0,t]),n=this._map.unproject([1,t]),r=e.distanceTo(n),i=Math.ceil(2*this._accuracy/r);this._circleElement.style.width=i+"px",this._circleElement.style.height=i+"px"},r.prototype._onZoom=function(){this.options.showUserLocation&&this.options.showAccuracyCircle&&this._updateCircleRadius()},r.prototype._onError=function(e){if(this._map){if(this.options.trackUserLocation)if(1===e.code){this._watchState="OFF",this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-waiting"),this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-active"),this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-active-error"),this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-background"),this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-background-error"),this._geolocateButton.disabled=!0;var n=this._map._getUIString("GeolocateControl.LocationNotAvailable");this._geolocateButton.title=n,this._geolocateButton.setAttribute("aria-label",n),void 0!==this._geolocationWatchID&&this._clearWatch()}else{if(3===e.code&&zi)return;this._setErrorState()}"OFF"!==this._watchState&&this.options.showUserLocation&&this._dotElement.classList.add("mapboxgl-user-location-dot-stale"),this.fire(new t.Event("error",e)),this._finish()}},r.prototype._finish=function(){this._timeoutId&&clearTimeout(this._timeoutId),this._timeoutId=void 0},r.prototype._setupUI=function(e){var r=this;if(this._container.addEventListener("contextmenu",(function(t){return t.preventDefault()})),this._geolocateButton=n.create("button","mapboxgl-ctrl-geolocate",this._container),n.create("span","mapboxgl-ctrl-icon",this._geolocateButton).setAttribute("aria-hidden",!0),this._geolocateButton.type="button",!1===e){t.warnOnce("Geolocation support is not available so the GeolocateControl will be disabled.");var i=this._map._getUIString("GeolocateControl.LocationNotAvailable");this._geolocateButton.disabled=!0,this._geolocateButton.title=i,this._geolocateButton.setAttribute("aria-label",i)}else{var o=this._map._getUIString("GeolocateControl.FindMyLocation");this._geolocateButton.title=o,this._geolocateButton.setAttribute("aria-label",o)}this.options.trackUserLocation&&(this._geolocateButton.setAttribute("aria-pressed","false"),this._watchState="OFF"),this.options.showUserLocation&&(this._dotElement=n.create("div","mapboxgl-user-location-dot"),this._userLocationDotMarker=new Li(this._dotElement),this._circleElement=n.create("div","mapboxgl-user-location-accuracy-circle"),this._accuracyCircleMarker=new Li({element:this._circleElement,pitchAlignment:"map"}),this.options.trackUserLocation&&(this._watchState="OFF"),this._map.on("zoom",this._onZoom)),this._geolocateButton.addEventListener("click",this.trigger.bind(this)),this._setup=!0,this.options.trackUserLocation&&this._map.on("movestart",(function(e){e.geolocateSource||"ACTIVE_LOCK"!==r._watchState||e.originalEvent&&"resize"===e.originalEvent.type||(r._watchState="BACKGROUND",r._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-background"),r._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-active"),r.fire(new t.Event("trackuserlocationend")))}))},r.prototype.trigger=function(){if(!this._setup)return t.warnOnce("Geolocate control triggered before added to a map"),!1;if(this.options.trackUserLocation){switch(this._watchState){case"OFF":this._watchState="WAITING_ACTIVE",this.fire(new t.Event("trackuserlocationstart"));break;case"WAITING_ACTIVE":case"ACTIVE_LOCK":case"ACTIVE_ERROR":case"BACKGROUND_ERROR":Fi--,zi=!1,this._watchState="OFF",this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-waiting"),this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-active"),this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-active-error"),this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-background"),this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-background-error"),this.fire(new t.Event("trackuserlocationend"));break;case"BACKGROUND":this._watchState="ACTIVE_LOCK",this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-background"),this._lastKnownPosition&&this._updateCamera(this._lastKnownPosition),this.fire(new t.Event("trackuserlocationstart"))}switch(this._watchState){case"WAITING_ACTIVE":this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-waiting"),this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-active");break;case"ACTIVE_LOCK":this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-active");break;case"ACTIVE_ERROR":this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-waiting"),this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-active-error");break;case"BACKGROUND":this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-background");break;case"BACKGROUND_ERROR":this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-waiting"),this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-background-error")}if("OFF"===this._watchState&&void 0!==this._geolocationWatchID)this._clearWatch();else if(void 0===this._geolocationWatchID){var e;this._geolocateButton.classList.add("mapboxgl-ctrl-geolocate-waiting"),this._geolocateButton.setAttribute("aria-pressed","true"),++Fi>1?(e={maximumAge:6e5,timeout:0},zi=!0):(e=this.options.positionOptions,zi=!1),this._geolocationWatchID=t.window.navigator.geolocation.watchPosition(this._onSuccess,this._onError,e)}}else t.window.navigator.geolocation.getCurrentPosition(this._onSuccess,this._onError,this.options.positionOptions),this._timeoutId=setTimeout(this._finish,1e4);return!0},r.prototype._clearWatch=function(){t.window.navigator.geolocation.clearWatch(this._geolocationWatchID),this._geolocationWatchID=void 0,this._geolocateButton.classList.remove("mapboxgl-ctrl-geolocate-waiting"),this._geolocateButton.setAttribute("aria-pressed","false"),this.options.showUserLocation&&this._updateMarker(null)},r}(t.Evented),Ni={maxWidth:100,unit:"metric"},Gi=function(e){this.options=t.extend({},Ni,e),t.bindAll(["_onMove","setUnit"],this)};function Vi(t,e,n){var r=n&&n.maxWidth||100,i=t._container.clientHeight/2,o=t.unproject([0,i]),a=t.unproject([r,i]),s=o.distanceTo(a);if(n&&"imperial"===n.unit){var u=3.2808*s;u>5280?Hi(e,r,u/5280,t._getUIString("ScaleControl.Miles")):Hi(e,r,u,t._getUIString("ScaleControl.Feet"))}else n&&"nautical"===n.unit?Hi(e,r,s/1852,t._getUIString("ScaleControl.NauticalMiles")):s>=1e3?Hi(e,r,s/1e3,t._getUIString("ScaleControl.Kilometers")):Hi(e,r,s,t._getUIString("ScaleControl.Meters"))}function Hi(t,e,n,r){var i,o,a,s=(i=n,(o=Math.pow(10,(""+Math.floor(i)).length-1))*(a=(a=i/o)>=10?10:a>=5?5:a>=3?3:a>=2?2:a>=1?1:function(t){var e=Math.pow(10,Math.ceil(-Math.log(t)/Math.LN10));return Math.round(t*e)/e}(a)));t.style.width=e*(s/n)+"px",t.innerHTML=s+"&nbsp;"+r}Gi.prototype.getDefaultPosition=function(){return"bottom-left"},Gi.prototype._onMove=function(){Vi(this._map,this._container,this.options)},Gi.prototype.onAdd=function(t){return this._map=t,this._container=n.create("div","mapboxgl-ctrl mapboxgl-ctrl-scale",t.getContainer()),this._map.on("move",this._onMove),this._onMove(),this._container},Gi.prototype.onRemove=function(){n.remove(this._container),this._map.off("move",this._onMove),this._map=void 0},Gi.prototype.setUnit=function(t){this.options.unit=t,Vi(this._map,this._container,this.options)};var Wi=function(e){this._fullscreen=!1,e&&e.container&&(e.container instanceof t.window.HTMLElement?this._container=e.container:t.warnOnce("Full screen control 'container' must be a DOM element.")),t.bindAll(["_onClickFullscreen","_changeIcon"],this),"onfullscreenchange"in t.window.document?this._fullscreenchange="fullscreenchange":"onmozfullscreenchange"in t.window.document?this._fullscreenchange="mozfullscreenchange":"onwebkitfullscreenchange"in t.window.document?this._fullscreenchange="webkitfullscreenchange":"onmsfullscreenchange"in t.window.document&&(this._fullscreenchange="MSFullscreenChange")};Wi.prototype.onAdd=function(e){return this._map=e,this._container||(this._container=this._map.getContainer()),this._controlContainer=n.create("div","mapboxgl-ctrl mapboxgl-ctrl-group"),this._checkFullscreenSupport()?this._setupUI():(this._controlContainer.style.display="none",t.warnOnce("This device does not support fullscreen mode.")),this._controlContainer},Wi.prototype.onRemove=function(){n.remove(this._controlContainer),this._map=null,t.window.document.removeEventListener(this._fullscreenchange,this._changeIcon)},Wi.prototype._checkFullscreenSupport=function(){return!!(t.window.document.fullscreenEnabled||t.window.document.mozFullScreenEnabled||t.window.document.msFullscreenEnabled||t.window.document.webkitFullscreenEnabled)},Wi.prototype._setupUI=function(){var e=this._fullscreenButton=n.create("button","mapboxgl-ctrl-fullscreen",this._controlContainer);n.create("span","mapboxgl-ctrl-icon",e).setAttribute("aria-hidden",!0),e.type="button",this._updateTitle(),this._fullscreenButton.addEventListener("click",this._onClickFullscreen),t.window.document.addEventListener(this._fullscreenchange,this._changeIcon)},Wi.prototype._updateTitle=function(){var t=this._getTitle();this._fullscreenButton.setAttribute("aria-label",t),this._fullscreenButton.title=t},Wi.prototype._getTitle=function(){return this._map._getUIString(this._isFullscreen()?"FullscreenControl.Exit":"FullscreenControl.Enter")},Wi.prototype._isFullscreen=function(){return this._fullscreen},Wi.prototype._changeIcon=function(){(t.window.document.fullscreenElement||t.window.document.mozFullScreenElement||t.window.document.webkitFullscreenElement||t.window.document.msFullscreenElement)===this._container!==this._fullscreen&&(this._fullscreen=!this._fullscreen,this._fullscreenButton.classList.toggle("mapboxgl-ctrl-shrink"),this._fullscreenButton.classList.toggle("mapboxgl-ctrl-fullscreen"),this._updateTitle())},Wi.prototype._onClickFullscreen=function(){this._isFullscreen()?t.window.document.exitFullscreen?t.window.document.exitFullscreen():t.window.document.mozCancelFullScreen?t.window.document.mozCancelFullScreen():t.window.document.msExitFullscreen?t.window.document.msExitFullscreen():t.window.document.webkitCancelFullScreen&&t.window.document.webkitCancelFullScreen():this._container.requestFullscreen?this._container.requestFullscreen():this._container.mozRequestFullScreen?this._container.mozRequestFullScreen():this._container.msRequestFullscreen?this._container.msRequestFullscreen():this._container.webkitRequestFullscreen&&this._container.webkitRequestFullscreen()};var qi={closeButton:!0,closeOnClick:!0,focusAfterOpen:!0,className:"",maxWidth:"240px"},Xi=["a[href]","[tabindex]:not([tabindex='-1'])","[contenteditable]:not([contenteditable='false'])","button:not([disabled])","input:not([disabled])","select:not([disabled])","textarea:not([disabled])"].join(", "),Zi=function(e){function r(n){e.call(this),this.options=t.extend(Object.create(qi),n),t.bindAll(["_update","_onClose","remove","_onMouseMove","_onMouseUp","_onDrag"],this)}return e&&(r.__proto__=e),(r.prototype=Object.create(e&&e.prototype)).constructor=r,r.prototype.addTo=function(e){return this._map&&this.remove(),this._map=e,this.options.closeOnClick&&this._map.on("click",this._onClose),this.options.closeOnMove&&this._map.on("move",this._onClose),this._map.on("remove",this.remove),this._update(),this._focusFirstElement(),this._trackPointer?(this._map.on("mousemove",this._onMouseMove),this._map.on("mouseup",this._onMouseUp),this._container&&this._container.classList.add("mapboxgl-popup-track-pointer"),this._map._canvasContainer.classList.add("mapboxgl-track-pointer")):this._map.on("move",this._update),this.fire(new t.Event("open")),this},r.prototype.isOpen=function(){return!!this._map},r.prototype.remove=function(){return this._content&&n.remove(this._content),this._container&&(n.remove(this._container),delete this._container),this._map&&(this._map.off("move",this._update),this._map.off("move",this._onClose),this._map.off("click",this._onClose),this._map.off("remove",this.remove),this._map.off("mousemove",this._onMouseMove),this._map.off("mouseup",this._onMouseUp),this._map.off("drag",this._onDrag),delete this._map),this.fire(new t.Event("close")),this},r.prototype.getLngLat=function(){return this._lngLat},r.prototype.setLngLat=function(e){return this._lngLat=t.LngLat.convert(e),this._pos=null,this._trackPointer=!1,this._update(),this._map&&(this._map.on("move",this._update),this._map.off("mousemove",this._onMouseMove),this._container&&this._container.classList.remove("mapboxgl-popup-track-pointer"),this._map._canvasContainer.classList.remove("mapboxgl-track-pointer")),this},r.prototype.trackPointer=function(){return this._trackPointer=!0,this._pos=null,this._update(),this._map&&(this._map.off("move",this._update),this._map.on("mousemove",this._onMouseMove),this._map.on("drag",this._onDrag),this._container&&this._container.classList.add("mapboxgl-popup-track-pointer"),this._map._canvasContainer.classList.add("mapboxgl-track-pointer")),this},r.prototype.getElement=function(){return this._container},r.prototype.setText=function(e){return this.setDOMContent(t.window.document.createTextNode(e))},r.prototype.setHTML=function(e){var n,r=t.window.document.createDocumentFragment(),i=t.window.document.createElement("body");for(i.innerHTML=e;n=i.firstChild;)r.appendChild(n);return this.setDOMContent(r)},r.prototype.getMaxWidth=function(){return this._container&&this._container.style.maxWidth},r.prototype.setMaxWidth=function(t){return this.options.maxWidth=t,this._update(),this},r.prototype.setDOMContent=function(t){if(this._content)for(;this._content.hasChildNodes();)this._content.firstChild&&this._content.removeChild(this._content.firstChild);else this._content=n.create("div","mapboxgl-popup-content",this._container);return this._content.appendChild(t),this._createCloseButton(),this._update(),this._focusFirstElement(),this},r.prototype.addClassName=function(t){this._container&&this._container.classList.add(t)},r.prototype.removeClassName=function(t){this._container&&this._container.classList.remove(t)},r.prototype.setOffset=function(t){return this.options.offset=t,this._update(),this},r.prototype.toggleClassName=function(t){if(this._container)return this._container.classList.toggle(t)},r.prototype._createCloseButton=function(){this.options.closeButton&&(this._closeButton=n.create("button","mapboxgl-popup-close-button",this._content),this._closeButton.type="button",this._closeButton.setAttribute("aria-label","Close popup"),this._closeButton.innerHTML="&#215;",this._closeButton.addEventListener("click",this._onClose))},r.prototype._onMouseUp=function(t){this._update(t.point)},r.prototype._onMouseMove=function(t){this._update(t.point)},r.prototype._onDrag=function(t){this._update(t.point)},r.prototype._update=function(e){var r=this;if(this._map&&(this._lngLat||this._trackPointer)&&this._content&&(this._container||(this._container=n.create("div","mapboxgl-popup",this._map.getContainer()),this._tip=n.create("div","mapboxgl-popup-tip",this._container),this._container.appendChild(this._content),this.options.className&&this.options.className.split(" ").forEach((function(t){return r._container.classList.add(t)})),this._trackPointer&&this._container.classList.add("mapboxgl-popup-track-pointer")),this.options.maxWidth&&this._container.style.maxWidth!==this.options.maxWidth&&(this._container.style.maxWidth=this.options.maxWidth),this._map.transform.renderWorldCopies&&!this._trackPointer&&(this._lngLat=Bi(this._lngLat,this._pos,this._map.transform)),!this._trackPointer||e)){var i=this._pos=this._trackPointer&&e?e:this._map.project(this._lngLat),o=this.options.anchor,a=function e(n){if(n){if("number"==typeof n){var r=Math.round(Math.sqrt(.5*Math.pow(n,2)));return{center:new t.Point(0,0),top:new t.Point(0,n),"top-left":new t.Point(r,r),"top-right":new t.Point(-r,r),bottom:new t.Point(0,-n),"bottom-left":new t.Point(r,-r),"bottom-right":new t.Point(-r,-r),left:new t.Point(n,0),right:new t.Point(-n,0)}}if(n instanceof t.Point||Array.isArray(n)){var i=t.Point.convert(n);return{center:i,top:i,"top-left":i,"top-right":i,bottom:i,"bottom-left":i,"bottom-right":i,left:i,right:i}}return{center:t.Point.convert(n.center||[0,0]),top:t.Point.convert(n.top||[0,0]),"top-left":t.Point.convert(n["top-left"]||[0,0]),"top-right":t.Point.convert(n["top-right"]||[0,0]),bottom:t.Point.convert(n.bottom||[0,0]),"bottom-left":t.Point.convert(n["bottom-left"]||[0,0]),"bottom-right":t.Point.convert(n["bottom-right"]||[0,0]),left:t.Point.convert(n.left||[0,0]),right:t.Point.convert(n.right||[0,0])}}return e(new t.Point(0,0))}(this.options.offset);if(!o){var s,u=this._container.offsetWidth,c=this._container.offsetHeight;s=i.y+a.bottom.y<c?["top"]:i.y>this._map.transform.height-c?["bottom"]:[],i.x<u/2?s.push("left"):i.x>this._map.transform.width-u/2&&s.push("right"),o=0===s.length?"bottom":s.join("-")}var l=i.add(a[o]).round();n.setTransform(this._container,Ri[o]+" translate("+l.x+"px,"+l.y+"px)"),ki(this._container,o,"popup")}},r.prototype._focusFirstElement=function(){if(this.options.focusAfterOpen&&this._container){var t=this._container.querySelector(Xi);t&&t.focus()}},r.prototype._onClose=function(){this.remove()},r}(t.Evented),Ji={version:t.version,supported:e,setRTLTextPlugin:t.setRTLTextPlugin,getRTLTextPluginStatus:t.getRTLTextPluginStatus,Map:Ti,NavigationControl:Mi,GeolocateControl:Ui,AttributionControl:vi,ScaleControl:Gi,FullscreenControl:Wi,Popup:Zi,Marker:Li,Style:Ve,LngLat:t.LngLat,LngLatBounds:t.LngLatBounds,Point:t.Point,MercatorCoordinate:t.MercatorCoordinate,Evented:t.Evented,config:t.config,prewarm:function(){Ft().acquire(kt)},clearPrewarmedResources:function(){var t=Lt;t&&(t.isPreloaded()&&1===t.numActive()?(t.release(kt),Lt=null):console.warn("Could not clear WebWorkers since there are active Map instances that still reference it. The pre-warmed WebWorker pool can only be cleared when all map instances have been removed with map.remove()"))},get accessToken(){return t.config.ACCESS_TOKEN},set accessToken(e){t.config.ACCESS_TOKEN=e},get baseApiUrl(){return t.config.API_URL},set baseApiUrl(e){t.config.API_URL=e},get workerCount(){return Dt.workerCount},set workerCount(t){Dt.workerCount=t},get maxParallelImageRequests(){return t.config.MAX_PARALLEL_IMAGE_REQUESTS},set maxParallelImageRequests(e){t.config.MAX_PARALLEL_IMAGE_REQUESTS=e},clearStorage:function(e){t.clearTileCache(e)},workerUrl:""};return Ji})),n}()},function(t,e,n){var r=n(227);t.exports=function(t){if(Array.isArray(t))return r(t)},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e){t.exports=function(t){if("undefined"!=typeof Symbol&&null!=t[Symbol.iterator]||null!=t["@@iterator"])return Array.from(t)},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){var r=n(227);t.exports=function(t,e){if(t){if("string"==typeof t)return r(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);return"Object"===n&&t.constructor&&(n=t.constructor.name),"Map"===n||"Set"===n?Array.from(t):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?r(t,e):void 0}},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e){t.exports=function(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")},t.exports.__esModule=!0,t.exports.default=t.exports},function(t,e,n){"use strict";n.r(e);var r=n(3),i=n.n(r),o=n(5),a=n.n(o),s=n(6),u=n.n(s),c=n(1),l=n.n(c),h=n(0),f=n.n(h);function p(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}var d=function(t){a()(n,t);var e=p(n);function n(){return i()(this,n),e.apply(this,arguments)}return n}(n(230).a);f()(d,"layerName","GreatCircleLayer"),f()(d,"defaultProps",{getHeight:{type:"accessor",value:0},greatCircle:!0});var A=n(4),g=n.n(A),m=n(198),y=n(224);function v(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}function _(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}var b=function(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?_(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):_(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}({},y.a.defaultProps),x=function(t){a()(n,t);var e=v(n);function n(){return i()(this,n),e.apply(this,arguments)}return g()(n,[{key:"indexToBounds",value:function(){return null}},{key:"renderLayers",value:function(){var t=this.props,e=t.elevationScale,n=t.extruded,r=t.wireframe,i=t.filled,o=t.stroked,a=t.lineWidthUnits,s=t.lineWidthScale,u=t.lineWidthMinPixels,c=t.lineWidthMaxPixels,l=t.lineJointRounded,h=t.lineMiterLimit,f=t.lineDashJustified,p=t.getElevation,d=t.getFillColor,A=t.getLineColor,g=t.getLineWidth,m=this.props,v=m.updateTriggers,_=m.material,b=m.transitions;return new(this.getSubLayerClass("cell",y.a))({filled:i,wireframe:r,extruded:n,elevationScale:e,stroked:o,lineWidthUnits:a,lineWidthScale:s,lineWidthMinPixels:u,lineWidthMaxPixels:c,lineJointRounded:l,lineMiterLimit:h,lineDashJustified:f,material:_,transitions:b,getElevation:p,getFillColor:d,getLineColor:A,getLineWidth:g},this.getSubLayerProps({id:"cell",updateTriggers:v&&{getElevation:v.getElevation,getFillColor:v.getFillColor,getLineColor:v.getLineColor,getLineWidth:v.getLineWidth}}),this.indexToBounds())}}]),n}(m.a);f()(x,"layerName","GeoCellLayer"),f()(x,"defaultProps",b);var w=n(9),E=n.n(w),O=n(129),S=n.n(O),T=180/Math.PI;function C(t,e,n){var r=1<<e;return[(t[0]+n[0])/r,(t[1]+n[1])/r]}function P(t){return t>=.5?1/3*(4*t*t-1):1/3*(1-4*(1-t)*(1-t))}function M(t){return[P(t[0]),P(t[1])]}function I(t,e){var n=E()(e,2),r=n[0],i=n[1];switch(t){case 0:return[1,r,i];case 1:return[-r,1,i];case 2:return[-r,-i,1];case 3:return[-1,-i,-r];case 4:return[i,-1,-r];case 5:return[i,r,-1];default:throw new Error("Invalid face")}}function B(t,e,n,r){if(0===r){1===n&&(e[0]=t-1-e[0],e[1]=t-1-e[1]);var i=e[0];e[0]=e[1],e[1]=i}}function R(t){if("string"==typeof t){if(t.indexOf("/")>0)return t;t=function(t){var e=t.padEnd(16,"0");return S.a.fromString(e,16)}(t)}return function(t){for(var e=S.a.fromString(t,!0,10).toString(2);e.length<64;)e="0"+e;for(var n=e.lastIndexOf("1"),r=e.substring(0,3),i=e.substring(3,n),o=i.length/2,a=S.a.fromString(r,!0,2).toString(10),s=S.a.fromString(i,!0,2).toString(4);s.length<o;)s="0"+s;return"".concat(a,"/").concat(s)}(t.toString())}function k(t){return function(t){for(var e,n,r,i,o,a,s=t.face,u=t.ij,c=t.level,l=[[0,0],[0,1],[1,1],[1,0],[0,0]],h=Math.max(1,Math.ceil(100*Math.pow(2,-c))),f=new Float64Array(4*h*2+2),p=0,d=0,A=0;A<4;A++)for(var g=l[A].slice(0),m=l[A+1],y=(m[0]-g[0])/h,v=(m[1]-g[1])/h,_=0;_<h;_++){g[0]+=y,g[1]+=v;var b=I(s,M(C(u,c,g))),x=(e=b,n=void 0,r=void 0,i=void 0,o=void 0,a=void 0,n=E()(e,3),r=n[0],i=n[1],o=n[2],a=Math.atan2(o,Math.sqrt(r*r+i*i)),[Math.atan2(i,r)*T,a*T]);Math.abs(x[1])>89.999&&(x[0]=d);var w=x[0]-d;x[0]+=w>180?-360:w<-180?360:0,f[p++]=x[0],f[p++]=x[1],d=x[0]}return f[p++]=f[0],f[p++]=f[1],f}(function(t){for(var e,n=t.split("/"),r=parseInt(n[0],10),i=n[1],o=i.length,a=[0,0],s=o-1;s>=0;s--){e=o-s;var u=i[s],c=0,l=0;"1"===u?l=1:"2"===u?(c=1,l=1):"3"===u&&(c=1);var h=Math.pow(2,e-1);B(h,a,c,l),a[0]+=h*c,a[1]+=h*l}if(r%2==1){var f=a[0];a[0]=a[1],a[1]=f}return{face:r,ij:a,level:e}}(R(t)))}function D(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}var L=function(t){a()(n,t);var e=D(n);function n(){return i()(this,n),e.apply(this,arguments)}return g()(n,[{key:"indexToBounds",value:function(){var t=this.props,e=t.data,n=t.getS2Token;return{data:e,_normalize:!1,positionFormat:"XY",getPolygon:function(t,e){return k(n(t,e))}}}}]),n}(x);f()(L,"layerName","S2Layer"),f()(L,"defaultProps",{getS2Token:{type:"accessor",value:function(t){return t.token}}});var j=n(19);function F(t){var e=function(t){for(var e=0,n=0,r=1<<t.length,i=r/512,o=0;o<t.length;o++){r>>=1;var a=parseInt(t[o]);a%2&&(e|=r),a>1&&(n|=r)}return[[e/i,512-n/i],[(e+.99)/i,512-(n+.99)/i]]}(t),n=E()(e,2),r=n[0],i=n[1],o=Object(j.p)(r),a=E()(o,2),s=a[0],u=a[1],c=Object(j.p)(i),l=E()(c,2),h=l[0],f=l[1];return[h,u,h,f,s,f,s,u,h,u]}function z(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}var U=function(t){a()(n,t);var e=z(n);function n(){return i()(this,n),e.apply(this,arguments)}return g()(n,[{key:"indexToBounds",value:function(){var t=this.props,e=t.data,n=t.getQuadkey;return{data:e,_normalize:!1,positionFormat:"XY",getPolygon:function(t,e){return F(n(t,e))}}}}]),n}(x);f()(U,"layerName","QuadkeyLayer"),f()(U,"defaultProps",{getQuadkey:{type:"accessor",value:function(t){return t.quadkey}}});var N=n(67),G=n(229),V=n(69),H=n.n(V),W=n(39),q=n.n(W),X=n(21),Z=function(){function t(e){i()(this,t),this.index=e,this.isVisible=!1,this.isSelected=!1,this.parent=null,this.children=[],this.content=null,this._loader=void 0,this._abortController=null,this._loaderId=0,this._isLoaded=!1,this._isCancelled=!1,this._needsReload=!1}var e;return g()(t,[{key:"data",get:function(){var t=this;return this.isLoading&&this._loader?this._loader.then((function(){return t.data})):this.content}},{key:"isLoaded",get:function(){return this._isLoaded&&!this._needsReload}},{key:"isLoading",get:function(){return Boolean(this._loader)&&!this._isCancelled}},{key:"needsReload",get:function(){return this._needsReload||this._isCancelled}},{key:"byteLength",get:function(){var t=this.content?this.content.byteLength:0;return Number.isFinite(t)||X.a.error("byteLength not defined in tile data")(),t}},{key:"_loadData",value:(e=H()(q.a.mark((function t(e){var n,r,i,o,a,s,u,c,l,h,f,p,d,A;return q.a.wrap((function(t){for(;;)switch(t.prev=t.next){case 0:return n=e.getData,r=e.requestScheduler,i=e.onLoad,o=e.onError,a=this.index,s=this.id,u=this.bbox,c=this.userData,l=this.zoom,h=this._loaderId,this._abortController=new AbortController,f=this._abortController.signal,t.next=7,r.scheduleRequest(this,(function(t){return t.isSelected?1:-1}));case 7:if(p=t.sent){t.next=11;break}return this._isCancelled=!0,t.abrupt("return");case 11:if(!this._isCancelled){t.next=14;break}return p.done(),t.abrupt("return");case 14:return d=null,t.prev=15,t.next=18,n({index:a,id:s,bbox:u,userData:c,zoom:l,signal:f});case 18:d=t.sent,t.next=24;break;case 21:t.prev=21,t.t0=t.catch(15),A=t.t0||!0;case 24:return t.prev=24,p.done(),t.finish(24);case 27:if(h===this._loaderId){t.next=29;break}return t.abrupt("return");case 29:if(this._loader=void 0,this.content=d,!this._isCancelled||d){t.next=34;break}return this._isLoaded=!1,t.abrupt("return");case 34:this._isLoaded=!0,this._isCancelled=!1,A?o(A,this):i(this);case 37:case"end":return t.stop()}}),t,this,[[15,21,24,27]])}))),function(t){return e.apply(this,arguments)})},{key:"loadData",value:function(t){return this._isLoaded=!1,this._isCancelled=!1,this._needsReload=!1,this._loaderId++,this._loader=this._loadData(t),this._loader}},{key:"setNeedsReload",value:function(){this.isLoading&&(this.abort(),this._loader=void 0),this._needsReload=!0}},{key:"abort",value:function(){var t;this.isLoaded||(this._isCancelled=!0,null===(t=this._abortController)||void 0===t||t.abort())}}]),t}(),J=n(40),Q=n.n(J),K=n(163),Y=n(86);const $=-1,tt=0,et=1;function nt(t,e,n){return e in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t}var rt=n(84);const it=new rt.a,ot=new rt.a;class at{constructor(t=[0,0,0],e=[0,0,0],n){nt(this,"center",void 0),nt(this,"halfDiagonal",void 0),nt(this,"minimum",void 0),nt(this,"maximum",void 0),n=n||it.copy(t).add(e).scale(.5),this.center=new rt.a(n),this.halfDiagonal=new rt.a(e).subtract(this.center),this.minimum=new rt.a(t),this.maximum=new rt.a(e)}clone(){return new at(this.minimum,this.maximum,this.center)}equals(t){return this===t||Boolean(t)&&this.minimum.equals(t.minimum)&&this.maximum.equals(t.maximum)}transform(t){return this.center.transformAsPoint(t),this.halfDiagonal.transform(t),this.minimum.transform(t),this.maximum.transform(t),this}intersectPlane(t){const{halfDiagonal:e}=this,n=ot.from(t.normal),r=e.x*Math.abs(n.x)+e.y*Math.abs(n.y)+e.z*Math.abs(n.z),i=this.center.dot(n)+t.distance;return i-r>0?et:i+r<0?$:tt}distanceTo(t){return Math.sqrt(this.distanceSquaredTo(t))}distanceSquaredTo(t){const e=it.from(t).subtract(this.center),{halfDiagonal:n}=this;let r,i=0;return r=Math.abs(e.x)-n.x,r>0&&(i+=r*r),r=Math.abs(e.y)-n.y,r>0&&(i+=r*r),r=Math.abs(e.z)-n.z,r>0&&(i+=r*r),i}}var st=n(26);const ut=new rt.a,ct=new rt.a;class lt{constructor(t=[0,0,0],e=0){nt(this,"center",void 0),nt(this,"radius",void 0),this.radius=-0,this.center=new rt.a,this.fromCenterRadius(t,e)}fromCenterRadius(t,e){return this.center.from(t),this.radius=e,this}fromCornerPoints(t,e){return e=ut.from(e),this.center=(new rt.a).from(t).add(e).scale(.5),this.radius=this.center.distance(e),this}equals(t){return this===t||Boolean(t)&&this.center.equals(t.center)&&this.radius===t.radius}clone(){return new lt(this.center,this.radius)}union(t){const e=this.center,n=this.radius,r=t.center,i=t.radius,o=ut.copy(r).subtract(e),a=o.magnitude();if(n>=a+i)return this.clone();if(i>=a+n)return t.clone();const s=.5*(n+a+i);return ct.copy(o).scale((-n+s)/a).add(e),this.center.copy(ct),this.radius=s,this}expand(t){const e=ut.from(t).subtract(this.center).magnitude();return e>this.radius&&(this.radius=e),this}transform(t){this.center.transform(t);const e=st.e(ut,t);return this.radius=Math.max(e[0],Math.max(e[1],e[2]))*this.radius,this}distanceSquaredTo(t){const e=this.distanceTo(t);return e*e}distanceTo(t){const e=ut.from(t).subtract(this.center);return Math.max(0,e.len()-this.radius)}intersectPlane(t){const e=this.center,n=this.radius,r=t.normal.dot(e)+t.distance;return r<-n?$:r<n?tt:et}}var ht,ft=n(177),pt=n(23),dt=n(55),At=n(57),gt=n(34),mt=n(25);!function(t){t[t.COL0ROW0=0]="COL0ROW0",t[t.COL0ROW1=1]="COL0ROW1",t[t.COL0ROW2=2]="COL0ROW2",t[t.COL1ROW0=3]="COL1ROW0",t[t.COL1ROW1=4]="COL1ROW1",t[t.COL1ROW2=5]="COL1ROW2",t[t.COL2ROW0=6]="COL2ROW0",t[t.COL2ROW1=7]="COL2ROW1",t[t.COL2ROW2=8]="COL2ROW2"}(ht||(ht={}));const yt=Object.freeze([1,0,0,0,1,0,0,0,1]);class vt extends ft.a{static get IDENTITY(){return function(){bt||(bt=new vt,Object.freeze(bt));return bt}()}static get ZERO(){return function(){_t||(_t=new vt([0,0,0,0,0,0,0,0,0]),Object.freeze(_t));return _t}()}get ELEMENTS(){return 9}get RANK(){return 3}get INDICES(){return ht}constructor(t,...e){super(-0,-0,-0,-0,-0,-0,-0,-0,-0),1===arguments.length&&Array.isArray(t)?this.copy(t):e.length>0?this.copy([t,...e]):this.identity()}copy(t){return this[0]=t[0],this[1]=t[1],this[2]=t[2],this[3]=t[3],this[4]=t[4],this[5]=t[5],this[6]=t[6],this[7]=t[7],this[8]=t[8],this.check()}identity(){return this.copy(yt)}fromObject(t){return this.check()}fromQuaternion(t){return At.c(this,t),this.check()}set(t,e,n,r,i,o,a,s,u){return this[0]=t,this[1]=e,this[2]=n,this[3]=r,this[4]=i,this[5]=o,this[6]=a,this[7]=s,this[8]=u,this.check()}setRowMajor(t,e,n,r,i,o,a,s,u){return this[0]=t,this[1]=r,this[2]=a,this[3]=e,this[4]=i,this[5]=s,this[6]=n,this[7]=o,this[8]=u,this.check()}determinant(){return At.b(this)}transpose(){return At.i(this,this),this.check()}invert(){return At.d(this,this),this.check()}multiplyLeft(t){return At.e(this,t,this),this.check()}multiplyRight(t){return At.e(this,this,t),this.check()}rotate(t){return At.f(this,this,t),this.check()}scale(t){return Array.isArray(t)?At.g(this,this,t):At.g(this,this,[t,t]),this.check()}translate(t){return At.h(this,this,t),this.check()}transform(t,e){let n;switch(t.length){case 2:n=gt.i(e||[-0,-0],t,this);break;case 3:n=mt.o(e||[-0,-0,-0],t,this);break;case 4:n=Object(dt.e)(e||[-0,-0,-0,-0],t,this);break;default:throw new Error("Illegal vector")}return Object(pt.b)(n,t.length),n}transformVector(t,e){return this.transform(t,e)}transformVector2(t,e){return this.transform(t,e)}transformVector3(t,e){return this.transform(t,e)}}let _t,bt;var xt=n(323);const wt=new rt.a,Et=new rt.a,Ot=new rt.a,St=new rt.a,Tt=new rt.a,Ct=new rt.a,Pt=new rt.a,Mt=0,It=1,Bt=2,Rt=3,kt=4,Dt=5,Lt=6,jt=7,Ft=8;class zt{constructor(t=[0,0,0],e=[0,0,0,0,0,0,0,0,0]){nt(this,"center",void 0),nt(this,"halfAxes",void 0),this.center=(new rt.a).from(t),this.halfAxes=new vt(e)}get halfSize(){const t=this.halfAxes.getColumn(0),e=this.halfAxes.getColumn(1),n=this.halfAxes.getColumn(2);return[new rt.a(t).len(),new rt.a(e).len(),new rt.a(n).len()]}get quaternion(){const t=this.halfAxes.getColumn(0),e=this.halfAxes.getColumn(1),n=this.halfAxes.getColumn(2),r=new rt.a(t).normalize(),i=new rt.a(e).normalize(),o=new rt.a(n).normalize();return(new xt.a).fromMatrix3(new vt([...r,...i,...o]))}fromCenterHalfSizeQuaternion(t,e,n){const r=new xt.a(n),i=(new vt).fromQuaternion(r);return i[0]=i[0]*e[0],i[1]=i[1]*e[0],i[2]=i[2]*e[0],i[3]=i[3]*e[1],i[4]=i[4]*e[1],i[5]=i[5]*e[1],i[6]=i[6]*e[2],i[7]=i[7]*e[2],i[8]=i[8]*e[2],this.center=(new rt.a).from(t),this.halfAxes=i,this}clone(){return new zt(this.center,this.halfAxes)}equals(t){return this===t||Boolean(t)&&this.center.equals(t.center)&&this.halfAxes.equals(t.halfAxes)}getBoundingSphere(t=new lt){const e=this.halfAxes,n=e.getColumn(0,Ot),r=e.getColumn(1,St),i=e.getColumn(2,Tt),o=wt.copy(n).add(r).add(i);return t.center.copy(this.center),t.radius=o.magnitude(),t}intersectPlane(t){const e=this.center,n=t.normal,r=this.halfAxes,i=n.x,o=n.y,a=n.z,s=Math.abs(i*r[Mt]+o*r[It]+a*r[Bt])+Math.abs(i*r[Rt]+o*r[kt]+a*r[Dt])+Math.abs(i*r[Lt]+o*r[jt]+a*r[Ft]),u=n.dot(e)+t.distance;return u<=-s?$:u>=s?et:tt}distanceTo(t){return Math.sqrt(this.distanceSquaredTo(t))}distanceSquaredTo(t){const e=Et.from(t).subtract(this.center),n=this.halfAxes,r=n.getColumn(0,Ot),i=n.getColumn(1,St),o=n.getColumn(2,Tt),a=r.magnitude(),s=i.magnitude(),u=o.magnitude();r.normalize(),i.normalize(),o.normalize();let c,l=0;return c=Math.abs(e.dot(r))-a,c>0&&(l+=c*c),c=Math.abs(e.dot(i))-s,c>0&&(l+=c*c),c=Math.abs(e.dot(o))-u,c>0&&(l+=c*c),l}computePlaneDistances(t,e,n=[-0,-0]){let r=Number.POSITIVE_INFINITY,i=Number.NEGATIVE_INFINITY;const o=this.center,a=this.halfAxes,s=a.getColumn(0,Ot),u=a.getColumn(1,St),c=a.getColumn(2,Tt),l=Ct.copy(s).add(u).add(c).add(o),h=Pt.copy(l).subtract(t);let f=e.dot(h);return r=Math.min(f,r),i=Math.max(f,i),l.copy(o).add(s).add(u).subtract(c),h.copy(l).subtract(t),f=e.dot(h),r=Math.min(f,r),i=Math.max(f,i),l.copy(o).add(s).subtract(u).add(c),h.copy(l).subtract(t),f=e.dot(h),r=Math.min(f,r),i=Math.max(f,i),l.copy(o).add(s).subtract(u).subtract(c),h.copy(l).subtract(t),f=e.dot(h),r=Math.min(f,r),i=Math.max(f,i),o.copy(l).subtract(s).add(u).add(c),h.copy(l).subtract(t),f=e.dot(h),r=Math.min(f,r),i=Math.max(f,i),o.copy(l).subtract(s).add(u).subtract(c),h.copy(l).subtract(t),f=e.dot(h),r=Math.min(f,r),i=Math.max(f,i),o.copy(l).subtract(s).subtract(u).add(c),h.copy(l).subtract(t),f=e.dot(h),r=Math.min(f,r),i=Math.max(f,i),o.copy(l).subtract(s).subtract(u).subtract(c),h.copy(l).subtract(t),f=e.dot(h),r=Math.min(f,r),i=Math.max(f,i),n[0]=r,n[1]=i,n}transform(t){this.center.transformAsPoint(t);const e=this.halfAxes.getColumn(0,Ot);e.transformAsPoint(t);const n=this.halfAxes.getColumn(1,St);n.transformAsPoint(t);const r=this.halfAxes.getColumn(2,Tt);return r.transformAsPoint(t),this.halfAxes=new vt([...e,...n,...r]),this}getTransform(){throw new Error("not implemented")}}var Ut=n(144),Nt=n(13);const Gt=new rt.a,Vt=new rt.a;class Ht{constructor(t=[0,0,1],e=0){nt(this,"normal",void 0),nt(this,"distance",void 0),this.normal=new rt.a,this.distance=-0,this.fromNormalDistance(t,e)}fromNormalDistance(t,e){return Object(Ut.a)(Number.isFinite(e)),this.normal.from(t).normalize(),this.distance=e,this}fromPointNormal(t,e){t=Gt.from(t),this.normal.from(e).normalize();const n=-this.normal.dot(t);return this.distance=n,this}fromCoefficients(t,e,n,r){return this.normal.set(t,e,n),Object(Ut.a)(Object(Nt.d)(this.normal.len(),1)),this.distance=r,this}clone(){return new Ht(this.normal,this.distance)}equals(t){return Object(Nt.d)(this.distance,t.distance)&&Object(Nt.d)(this.normal,t.normal)}getPointDistance(t){return this.normal.dot(t)+this.distance}transform(t){const e=Vt.copy(this.normal).transformAsVector(t).normalize(),n=this.normal.scale(-this.distance).transform(t);return this.fromPointNormal(n,e)}projectPointOntoPlane(t,e=[0,0,0]){t=Gt.from(t);const n=this.getPointDistance(t),r=Vt.copy(this.normal).scale(n);return t.subtract(r).to(e)}}const Wt=[new rt.a([1,0,0]),new rt.a([0,1,0]),new rt.a([0,0,1])],qt=new rt.a,Xt=new rt.a;new Ht(new rt.a(1,0,0),0);class Zt{constructor(t=[]){nt(this,"planes",void 0),this.planes=t}fromBoundingSphere(t){this.planes.length=2*Wt.length;const e=t.center,n=t.radius;let r=0;for(const t of Wt){let i=this.planes[r],o=this.planes[r+1];i||(i=this.planes[r]=new Ht),o||(o=this.planes[r+1]=new Ht);const a=qt.copy(t).scale(-n).add(e);t.dot(a);i.fromPointNormal(a,t);const s=qt.copy(t).scale(n).add(e),u=Xt.copy(t).negate();u.dot(s);o.fromPointNormal(s,u),r+=2}return this}computeVisibility(t){let e=et;for(const n of this.planes){switch(t.intersectPlane(n)){case $:return $;case tt:e=tt}}return e}computeVisibilityWithPlaneMask(t,e){if(Object(Ut.a)(Number.isFinite(e),"parentPlaneMask is required."),e===Zt.MASK_OUTSIDE||e===Zt.MASK_INSIDE)return e;let n=Zt.MASK_INSIDE;const r=this.planes;for(let i=0;i<this.planes.length;++i){const o=i<31?1<<i:0;if(i<31&&0==(e&o))continue;const a=r[i],s=t.intersectPlane(a);if(s===$)return Zt.MASK_OUTSIDE;s===tt&&(n|=o)}return n}}nt(Zt,"MASK_OUTSIDE",4294967295),nt(Zt,"MASK_INSIDE",0),nt(Zt,"MASK_INDETERMINATE",2147483647);var Jt=n(78);new rt.a,new rt.a,new rt.a,new rt.a,new rt.a;var Qt=n(316);new rt.a,new rt.a,new rt.a,new rt.a,new rt.a,new rt.a,new rt.a,new rt.a,new rt.a,new rt.a,new rt.a,new rt.a,Math.PI;var Kt=.1,Yt=1e-12,$t=1e-15,te=1e-20;Math.PI,Math.PI,Math.PI,Math.PI;const ee=new vt,ne=new vt,re=new vt,ie=new vt,oe=new vt;function ae(t,e={}){const n=te;let r=0,i=0;const o=ne,a=re;o.identity(),a.copy(t);const s=n*function(t){let e=0;for(let n=0;n<9;++n){const r=t[n];e+=r*r}return Math.sqrt(e)}(a);for(;i<10&&ce(a)>s;)le(a,ie),oe.copy(ie).transpose(),a.multiplyRight(ie),a.multiplyLeft(oe),o.multiplyRight(ie),++r>2&&(++i,r=0);return e.unitary=o.toTarget(e.unitary),e.diagonal=a.toTarget(e.diagonal),e}const se=[1,0,0],ue=[2,2,1];function ce(t){let e=0;for(let n=0;n<3;++n){const r=t[ee.getElementIndex(ue[n],se[n])];e+=2*r*r}return Math.sqrt(e)}function le(t,e){const n=$t;let r=0,i=1;for(let e=0;e<3;++e){const n=Math.abs(t[ee.getElementIndex(ue[e],se[e])]);n>r&&(i=e,r=n)}const o=se[i],a=ue[i];let s=1,u=0;if(Math.abs(t[ee.getElementIndex(a,o)])>n){const e=(t[ee.getElementIndex(a,a)]-t[ee.getElementIndex(o,o)])/2/t[ee.getElementIndex(a,o)];let n;n=e<0?-1/(-e+Math.sqrt(1+e*e)):1/(e+Math.sqrt(1+e*e)),s=1/Math.sqrt(1+n*n),u=n*s}return vt.IDENTITY.to(e),e[ee.getElementIndex(o,o)]=e[ee.getElementIndex(a,a)]=s,e[ee.getElementIndex(a,o)]=u,e[ee.getElementIndex(o,a)]=-u,e}const he=new rt.a,fe=new rt.a,pe=new rt.a,de=new rt.a,Ae=new rt.a,ge=new vt,me={diagonal:new vt,unitary:new vt};function ye(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return ve(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return ve(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function ve(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var _e=[[.5,.5],[0,0],[0,1],[1,0],[1,1]],be=_e.concat([[0,.5],[.5,0],[1,.5],[.5,1]]),xe=be.concat([[.25,.5],[.75,.5]]),we=function(){function t(e,n,r){i()(this,t),this.x=e,this.y=n,this.z=r}return g()(t,[{key:"children",get:function(){if(!this._children){var e=2*this.x,n=2*this.y,r=this.z+1;this._children=[new t(e,n,r),new t(e,n+1,r),new t(e+1,n,r),new t(e+1,n+1,r)]}return this._children}},{key:"update",value:function(t){var e=t.viewport,n=t.cullingVolume,r=t.elevationBounds,i=t.minZ,o=t.maxZ,a=t.bounds,s=t.offset,u=t.project,c=this.getBoundingVolume(r,s,u);if(a&&!this.insideBounds(a))return!1;if(n.computeVisibility(c)<0)return!1;if(!this.childVisible){var l=this.z;if(l<o&&l>=i){var h=c.distanceTo(e.cameraPosition)*e.scale/e.height;l+=Math.floor(Math.log2(h))}if(l>=o)return this.selected=!0,!0}this.selected=!1,this.childVisible=!0;var f,p=ye(this.children);try{for(p.s();!(f=p.n()).done;){f.value.update(t)}}catch(t){p.e(t)}finally{p.f()}return!0}},{key:"getSelected",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:[];if(this.selected&&t.push(this),this._children){var e,n=ye(this._children);try{for(n.s();!(e=n.n()).done;){var r=e.value;r.getSelected(t)}}catch(t){n.e(t)}finally{n.f()}}return t}},{key:"insideBounds",value:function(t){var e=E()(t,4),n=e[0],r=e[1],i=e[2],o=e[3],a=512/Math.pow(2,this.z);return this.x*a<i&&this.y*a<o&&(this.x+1)*a>n&&(this.y+1)*a>r}},{key:"getBoundingVolume",value:function(t,e,n){if(n){var r,i=[],o=ye(this.z<1?xe:this.z<2?be:_e);try{for(o.s();!(r=o.n()).done;){var a=r.value,s=Me(this.x+a[0],this.y+a[1],this.z);s[2]=t[0],i.push(n(s)),t[0]!==t[1]&&(s[2]=t[1],i.push(n(s)))}}catch(t){o.e(t)}finally{o.f()}return function(t,e=new zt){if(!t||0===t.length)return e.halfAxes=new vt([0,0,0,0,0,0,0,0,0]),e.center=new rt.a,e;const n=t.length,r=new rt.a(0,0,0);for(const e of t)r.add(e);const i=1/n;r.multiplyByScalar(i);let o=0,a=0,s=0,u=0,c=0,l=0;for(const e of t){const t=he.copy(e).subtract(r);o+=t.x*t.x,a+=t.x*t.y,s+=t.x*t.z,u+=t.y*t.y,c+=t.y*t.z,l+=t.z*t.z}o*=i,a*=i,s*=i,u*=i,c*=i,l*=i;const h=ge;h[0]=o,h[1]=a,h[2]=s,h[3]=a,h[4]=u,h[5]=c,h[6]=s,h[7]=c,h[8]=l;const{unitary:f}=ae(h,me),p=e.halfAxes.copy(f);let d=p.getColumn(0,pe),A=p.getColumn(1,de),g=p.getColumn(2,Ae),m=-Number.MAX_VALUE,y=-Number.MAX_VALUE,v=-Number.MAX_VALUE,_=Number.MAX_VALUE,b=Number.MAX_VALUE,x=Number.MAX_VALUE;for(const e of t)he.copy(e),m=Math.max(he.dot(d),m),y=Math.max(he.dot(A),y),v=Math.max(he.dot(g),v),_=Math.min(he.dot(d),_),b=Math.min(he.dot(A),b),x=Math.min(he.dot(g),x);d=d.multiplyByScalar(.5*(_+m)),A=A.multiplyByScalar(.5*(b+y)),g=g.multiplyByScalar(.5*(x+v)),e.center.copy(d).add(A).add(g);const w=fe.set(m-_,y-b,v-x).multiplyByScalar(.5),E=new vt([w[0],0,0,0,w[1],0,0,0,w[2]]);return e.halfAxes.multiplyRight(E),e}(i)}var u=512/Math.pow(2,this.z),c=this.x*u+512*e,l=512-(this.y+1)*u;return new at([c,l,t[0]],[c+u,l+u,t[1]])}}]),t}();var Ee=[-1/0,-1/0,1/0,1/0],Oe={type:"url",value:null,validate:function(t,e){return e.optional&&null===t||"string"==typeof t||Array.isArray(t)&&t.every((function(t){return"string"==typeof t}))},equals:function(t,e){if(t===e)return!0;if(!Array.isArray(t)||!Array.isArray(e))return!1;var n=t.length;if(n!==e.length)return!1;for(var r=0;r<n;r++)if(t[r]!==e[r])return!1;return!0}};function Se(t,e){var n=[e.transformAsPoint([t[0],t[1]]),e.transformAsPoint([t[2],t[1]]),e.transformAsPoint([t[0],t[3]]),e.transformAsPoint([t[2],t[3]])];return[Math.min.apply(Math,Q()(n.map((function(t){return t[0]})))),Math.min.apply(Math,Q()(n.map((function(t){return t[1]})))),Math.max.apply(Math,Q()(n.map((function(t){return t[0]})))),Math.max.apply(Math,Q()(n.map((function(t){return t[1]}))))]}function Te(t,e){if(!t||!t.length)return null;var n,r=e.index,i=e.id;Array.isArray(t)&&(t=t[(n=i,Math.abs(n.split("").reduce((function(t,e){return(t<<5)-t+e.charCodeAt(0)|0}),0))%t.length)]);for(var o=t,a=0,s=Object.keys(r);a<s.length;a++){var u=s[a],c=new RegExp("{".concat(u,"}"),"g");o=o.replace(c,String(r[u]))}return Number.isInteger(r.y)&&Number.isInteger(r.z)&&(o=o.replace(/\{-y\}/g,String(Math.pow(2,r.z)-r.y-1))),o}function Ce(t){var e=t.viewport,n=t.z,r=t.cullRect,i=r.x-e.x,o=r.y-e.y,a=r.width,s=r.height;if(!Array.isArray(n)){var u={targetZ:n||0},c=e.unproject([i,o],u),l=e.unproject([i+a,o],u),h=e.unproject([i,o+s],u),f=e.unproject([i+a,o+s],u);return[Math.min(c[0],l[0],h[0],f[0]),Math.min(c[1],l[1],h[1],f[1]),Math.max(c[0],l[0],h[0],f[0]),Math.max(c[1],l[1],h[1],f[1])]}var p=Ce({viewport:e,z:n[0],cullRect:r}),d=Ce({viewport:e,z:n[1],cullRect:r});return[Math.min(p[0],d[0]),Math.min(p[1],d[1]),Math.max(p[2],d[2]),Math.max(p[3],d[3])]}function Pe(t,e){return 512*Math.pow(2,t)/e}function Me(t,e,n){var r=Pe(n,512),i=t/r*360-180,o=Math.PI-2*Math.PI*e/r;return[i,180/Math.PI*Math.atan(.5*(Math.exp(o)-Math.exp(-o)))]}function Ie(t,e,n,r){var i=Pe(n,r);return[t/i*512,e/i*512]}function Be(t,e,n,r){var i=arguments.length>4&&void 0!==arguments[4]?arguments[4]:512;if(t.isGeospatial){var o=Me(e,n,r),a=E()(o,2),s=a[0],u=a[1],c=Me(e+1,n+1,r),l=E()(c,2),h=l[0],f=l[1];return{west:s,north:u,east:h,south:f}}var p=Ie(e,n,r,i),d=E()(p,2),A=d[0],g=d[1],m=Ie(e+1,n+1,r,i),y=E()(m,2),v=y[0],_=y[1];return{left:A,top:g,right:v,bottom:_}}function Re(t,e,n,r,i){for(var o=function(t,e,n){return n?Se(t,n).map((function(t){return t*e/512})):t.map((function(t){return t*e/512}))}(function(t,e,n){var r;if(e&&2===e.length){var i=E()(e,2),o=i[0],a=i[1],s=t.getBounds({z:o}),u=t.getBounds({z:a});r=[Math.min(s[0],u[0]),Math.min(s[1],u[1]),Math.max(s[2],u[2]),Math.max(s[3],u[3])]}else r=t.getBounds();return t.isGeospatial?[Math.max(r[0],n[0]),Math.max(r[1],n[1]),Math.min(r[2],n[2]),Math.min(r[3],n[3])]:[Math.max(Math.min(r[0],n[2]),n[0]),Math.max(Math.min(r[1],n[3]),n[1]),Math.min(Math.max(r[2],n[0]),n[2]),Math.min(Math.max(r[3],n[1]),n[3])]}(t,null,r),Pe(e,n),i),a=E()(o,4),s=a[0],u=a[1],c=a[2],l=a[3],h=[],f=Math.floor(s);f<c;f++)for(var p=Math.floor(u);p<l;p++)h.push({x:f,y:p,z:e});return h}function ke(t){var e=t.viewport,n=t.maxZoom,r=t.minZoom,i=t.zRange,o=t.extent,a=t.tileSize,s=void 0===a?512:a,u=t.modelMatrix,c=t.modelMatrixInverse,l=t.zoomOffset,h=void 0===l?0:l,f=e.isGeospatial?Math.round(e.zoom+Math.log2(512/s))+h:Math.ceil(e.zoom)+h;if("number"==typeof r&&Number.isFinite(r)&&f<r){if(!o)return[];f=r}"number"==typeof n&&Number.isFinite(n)&&f>n&&(f=n);var p=o;return u&&c&&o&&!e.isGeospatial&&(p=Se(o,u)),e.isGeospatial?function(t,e,n,r){var i=t instanceof K.a&&t.resolution?t.projectPosition:null,o=Object.values(t.getFrustumPlanes()).map((function(t){var e=t.normal,n=t.distance;return new Ht(e.clone().negate(),n)})),a=new Zt(o),s=t.distanceScales.unitsPerMeter[2],u=n&&n[0]*s||0,c=n&&n[1]*s||0,l=t instanceof Y.a&&t.pitch<=60?e:0;if(r){var h=r,f=E()(h,4),p=f[0],d=f[1],A=f[2],g=f[3],m=Object(j.l)([p,g]),y=Object(j.l)([A,d]);r=[m[0],512-m[1],y[0],512-y[1]]}var v=new we(0,0,0),_={viewport:t,project:i,cullingVolume:a,elevationBounds:[u,c],minZ:l,maxZ:e,bounds:r,offset:0};if(v.update(_),t instanceof Y.a&&t.subViewports&&t.subViewports.length>1){for(_.offset=-1;v.update(_)&&!(--_.offset<-3););for(_.offset=1;v.update(_)&&!(++_.offset>3););}return v.getSelected()}(e,f,i,o):Re(e,f,s,p||Ee,c)}var De,Le=n(221),je=n(80);function Fe(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return ze(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return ze(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function ze(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var Ue=(De={},f()(De,"best-available",(function(t){var e,n=Fe(t);try{for(n.s();!(e=n.n()).done;){e.value.state=0}}catch(t){n.e(t)}finally{n.f()}var r,i=Fe(t);try{for(i.s();!(r=i.n()).done;){var o=r.value;o.isSelected&&!Ge(o)&&Ve(o)}}catch(t){i.e(t)}finally{i.f()}var a,s=Fe(t);try{for(s.s();!(a=s.n()).done;){var u=a.value;u.isVisible=Boolean(2&u.state)}}catch(t){s.e(t)}finally{s.f()}})),f()(De,"no-overlap",(function(t){var e,n=Fe(t);try{for(n.s();!(e=n.n()).done;){e.value.state=0}}catch(t){n.e(t)}finally{n.f()}var r,i=Fe(t);try{for(i.s();!(r=i.n()).done;){var o=r.value;o.isSelected&&Ge(o)}}catch(t){i.e(t)}finally{i.f()}var a,s=Fe(Array.from(t).sort((function(t,e){return t.zoom-e.zoom})));try{for(s.s();!(a=s.n()).done;){var u=a.value;if(u.isVisible=Boolean(2&u.state),u.children&&(u.isVisible||1&u.state)){var c,l=Fe(u.children);try{for(l.s();!(c=l.n()).done;){c.value.state=1}}catch(t){l.e(t)}finally{l.f()}}else u.isSelected&&Ve(u)}}catch(t){s.e(t)}finally{s.f()}})),f()(De,"never",(function(){})),De),Ne=function(){function t(e){var n=this;i()(this,t),f()(this,"_getCullBounds",Object(je.a)(Ce)),this.opts=e,this.onTileLoad=function(t){n.opts.onTileLoad(t),n.opts.maxCacheByteSize&&(n._cacheByteSize+=t.byteLength,n._resizeCache())},this._requestScheduler=new Le.a({maxRequests:e.maxRequests,throttleRequests:e.maxRequests>0}),this._cache=new Map,this._tiles=[],this._dirty=!1,this._cacheByteSize=0,this._viewport=null,this._selectedTiles=null,this._frameNumber=0,this._modelMatrix=new Jt.a,this._modelMatrixInverse=new Jt.a,this.setOptions(e)}return g()(t,[{key:"tiles",get:function(){return this._tiles}},{key:"selectedTiles",get:function(){return this._selectedTiles}},{key:"isLoaded",get:function(){return null!==this._selectedTiles&&this._selectedTiles.every((function(t){return t.isLoaded}))}},{key:"needsReload",get:function(){return null!==this._selectedTiles&&this._selectedTiles.some((function(t){return t.needsReload}))}},{key:"setOptions",value:function(t){Object.assign(this.opts,t),Number.isFinite(t.maxZoom)&&(this._maxZoom=Math.floor(t.maxZoom)),Number.isFinite(t.minZoom)&&(this._minZoom=Math.ceil(t.minZoom))}},{key:"finalize",value:function(){var t,e=Fe(this._cache.values());try{for(e.s();!(t=e.n()).done;){var n=t.value;n.isLoading&&n.abort()}}catch(t){e.e(t)}finally{e.f()}this._cache.clear(),this._tiles=[],this._selectedTiles=null}},{key:"reloadAll",value:function(){var t,e=Fe(this._cache.keys());try{for(e.s();!(t=e.n()).done;){var n=t.value,r=this._cache.get(n);this._selectedTiles&&this._selectedTiles.includes(r)?r.setNeedsReload():this._cache.delete(n)}}catch(t){e.e(t)}finally{e.f()}}},{key:"update",value:function(t){var e=this,n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},r=n.zRange,i=n.modelMatrix,o=new Jt.a(i),a=!o.equals(this._modelMatrix);if(this._viewport&&t.equals(this._viewport)&&Object(Nt.d)(this._zRange,r)&&!a)this.needsReload&&(this._selectedTiles=this._selectedTiles.map((function(t){return e._getTile(t.index,!0)})));else{a&&(this._modelMatrixInverse=o.clone().invert(),this._modelMatrix=o),this._viewport=t,this._zRange=r;var s=this.getTileIndices({viewport:t,maxZoom:this._maxZoom,minZoom:this._minZoom,zRange:r,modelMatrix:this._modelMatrix,modelMatrixInverse:this._modelMatrixInverse});this._selectedTiles=s.map((function(t){return e._getTile(t,!0)})),this._dirty&&this._rebuildTree()}var u=this.updateTileStates();return this._pruneRequests(),this._dirty&&this._resizeCache(),u&&this._frameNumber++,this._frameNumber}},{key:"isTileVisible",value:function(t,e){if(!t.isVisible)return!1;if(e&&this._viewport){var n=Ce({viewport:this._viewport,z:this._zRange,cullRect:e}),r=E()(n,4),i=r[0],o=r[1],a=r[2],s=r[3],u=t.bbox;if("west"in u)return u.west<a&&u.east>i&&u.south<s&&u.north>o;var c=Math.min(u.top,u.bottom),l=Math.max(u.top,u.bottom);return u.left<a&&u.right>i&&c<s&&l>o}return!0}},{key:"getTileIndices",value:function(t){var e=t.viewport,n=t.maxZoom,r=t.minZoom,i=t.zRange,o=t.modelMatrix,a=t.modelMatrixInverse,s=this.opts;return ke({viewport:e,maxZoom:n,minZoom:r,zRange:i,tileSize:s.tileSize,extent:s.extent,modelMatrix:o,modelMatrixInverse:a,zoomOffset:s.zoomOffset})}},{key:"getTileId",value:function(t){return"".concat(t.x,"-").concat(t.y,"-").concat(t.z)}},{key:"getTileZoom",value:function(t){return t.z}},{key:"getTileMetadata",value:function(t){var e=this.opts.tileSize;return{bbox:Be(this._viewport,t.x,t.y,t.z,e)}}},{key:"getParentIndex",value:function(t){return{x:Math.floor(t.x/2),y:Math.floor(t.y/2),z:t.z-1}}},{key:"updateTileStates",value:function(){var t,e=this.opts.refinementStrategy||"best-available",n=new Array(this._cache.size),r=0,i=Fe(this._cache.values());try{for(i.s();!(t=i.n()).done;){var o=t.value;n[r++]=o.isVisible,o.isSelected=!1,o.isVisible=!1}}catch(t){i.e(t)}finally{i.f()}var a,s=Fe(this._selectedTiles);try{for(s.s();!(a=s.n()).done;){var u=a.value;u.isSelected=!0,u.isVisible=!0}}catch(t){s.e(t)}finally{s.f()}("function"==typeof e?e:Ue[e])(Array.from(this._cache.values())),r=0;var c,l=Fe(this._cache.values());try{for(l.s();!(c=l.n()).done;){var h=c.value;if(n[r++]!==h.isVisible)return!0}}catch(t){l.e(t)}finally{l.f()}return!1}},{key:"_pruneRequests",value:function(){var t,e=this.opts.maxRequests,n=[],r=0,i=Fe(this._cache.values());try{for(i.s();!(t=i.n()).done;){var o=t.value;o.isLoading&&(r++,o.isSelected||o.isVisible||n.push(o))}}catch(t){i.e(t)}finally{i.f()}for(;e>0&&r>e&&n.length>0;){n.shift().abort(),r--}}},{key:"_rebuildTree",value:function(){var t,e=this._cache,n=Fe(e.values());try{for(n.s();!(t=n.n()).done;){var r=t.value;r.parent=null,r.children&&(r.children.length=0)}}catch(t){n.e(t)}finally{n.f()}var i,o=Fe(e.values());try{for(o.s();!(i=o.n()).done;){var a=i.value,s=this._getNearestAncestor(a);a.parent=s,null!=s&&s.children&&s.children.push(a)}}catch(t){o.e(t)}finally{o.f()}}},{key:"_resizeCache",value:function(){var t=this._cache,e=this.opts,n=e.maxCacheSize||(e.maxCacheByteSize?1/0:5*this.selectedTiles.length),r=e.maxCacheByteSize||1/0;if(t.size>n||this._cacheByteSize>r){var i,o=Fe(t);try{for(o.s();!(i=o.n()).done;){var a=E()(i.value,2),s=a[0],u=a[1];if(u.isVisible||u.isSelected||(this._cacheByteSize-=e.maxCacheByteSize?u.byteLength:0,t.delete(s),this.opts.onTileUnload(u)),t.size<=n&&this._cacheByteSize<=r)break}}catch(t){o.e(t)}finally{o.f()}this._rebuildTree(),this._dirty=!0}this._dirty&&(this._tiles=Array.from(this._cache.values()).sort((function(t,e){return t.zoom-e.zoom})),this._dirty=!1)}},{key:"_getTile",value:function(t,e){var n=this.getTileId(t),r=this._cache.get(n),i=!1;return!r&&e?(r=new Z(t),Object.assign(r,this.getTileMetadata(r.index)),Object.assign(r,{id:n,zoom:this.getTileZoom(r.index)}),i=!0,this._cache.set(n,r),this._dirty=!0):r&&r.needsReload&&(i=!0),r&&i&&r.loadData({getData:this.opts.getTileData,requestScheduler:this._requestScheduler,onLoad:this.onTileLoad,onError:this.opts.onTileError}),r}},{key:"_getNearestAncestor",value:function(t){for(var e=this._minZoom,n=void 0===e?0:e,r=t.index;this.getTileZoom(r)>n;){r=this.getParentIndex(r);var i=this._getTile(r);if(i)return i}return null}}]),t}();function Ge(t){for(var e=t;e;){if(e.isLoaded||e.content)return e.state|=2,!0;e=e.parent}return!1}function Ve(t){var e,n=Fe(t.children);try{for(n.s();!(e=n.n()).done;){var r=e.value;r.isLoaded||r.content?r.state|=2:Ve(r)}}catch(t){n.e(t)}finally{n.f()}}function He(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function We(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?He(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):He(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function qe(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}var Xe={TilesetClass:Ne,data:{type:"data",value:[]},dataComparator:Oe.equals,renderSubLayers:{type:"function",value:function(t){return new G.a(t)},compare:!1},getTileData:{type:"function",optional:!0,value:null,compare:!1},onViewportLoad:{type:"function",optional:!0,value:null,compare:!1},onTileLoad:{type:"function",value:function(t){},compare:!1},onTileUnload:{type:"function",value:function(t){},compare:!1},onTileError:{type:"function",value:function(t){return console.error(t)},compare:!1},extent:{type:"array",optional:!0,value:null,compare:!0},tileSize:512,maxZoom:null,minZoom:0,maxCacheSize:null,maxCacheByteSize:null,refinementStrategy:"best-available",zRange:null,maxRequests:6,zoomOffset:0},Ze=function(t){a()(n,t);var e=qe(n);function n(){return i()(this,n),e.apply(this,arguments)}return g()(n,[{key:"initializeState",value:function(){this.state={tileset:null,isLoaded:!1}}},{key:"finalizeState",value:function(){var t,e;null===(t=this.state)||void 0===t||null===(e=t.tileset)||void 0===e||e.finalize()}},{key:"isLoaded",get:function(){var t,e;return null===(t=this.state)||void 0===t||null===(e=t.tileset)||void 0===e?void 0:e.selectedTiles.every((function(t){return t.isLoaded&&t.layers&&t.layers.every((function(t){return t.isLoaded}))}))}},{key:"shouldUpdateState",value:function(t){return t.changeFlags.somethingChanged}},{key:"updateState",value:function(t){var e=t.changeFlags,n=this.state.tileset,r=e.propsOrDataChanged||e.updateTriggersChanged,i=e.dataChanged||e.updateTriggersChanged&&(e.updateTriggersChanged.all||e.updateTriggersChanged.getTileData);n?r&&(n.setOptions(this._getTilesetOptions()),i?n.reloadAll():this.state.tileset.tiles.forEach((function(t){t.layers=null}))):(n=new this.props.TilesetClass(this._getTilesetOptions()),this.setState({tileset:n})),this._updateTileset()}},{key:"_getTilesetOptions",value:function(){var t=this.props,e=t.tileSize,n=t.maxCacheSize,r=t.maxCacheByteSize,i=t.refinementStrategy,o=t.extent;return{maxCacheSize:n,maxCacheByteSize:r,maxZoom:t.maxZoom,minZoom:t.minZoom,tileSize:e,refinementStrategy:i,extent:o,maxRequests:t.maxRequests,zoomOffset:t.zoomOffset,getTileData:this.getTileData.bind(this),onTileLoad:this._onTileLoad.bind(this),onTileError:this._onTileError.bind(this),onTileUnload:this._onTileUnload.bind(this)}}},{key:"_updateTileset",value:function(){var t=this.state.tileset,e=this.props,n=e.zRange,r=e.modelMatrix,i=t.update(this.context.viewport,{zRange:n,modelMatrix:r}),o=t.isLoaded,a=this.state.isLoaded!==o,s=this.state.frameNumber!==i;o&&(a||s)&&this._onViewportLoad(),s&&this.setState({frameNumber:i}),this.state.isLoaded=o}},{key:"_onViewportLoad",value:function(){var t=this.state.tileset,e=this.props.onViewportLoad;e&&e(t.selectedTiles)}},{key:"_onTileLoad",value:function(t){this.props.onTileLoad(t),t.layers=null,this.setNeedsUpdate()}},{key:"_onTileError",value:function(t,e){this.props.onTileError(t),e.layers=null,this.setNeedsUpdate()}},{key:"_onTileUnload",value:function(t){this.props.onTileUnload(t)}},{key:"getTileData",value:function(t){var e=this.props,n=e.data,r=e.getTileData,i=e.fetch,o=t.signal;return t.url="string"==typeof n||Array.isArray(n)?Te(n,t):null,r?r(t):i&&t.url?i(t.url,{propName:"data",layer:this,signal:o}):null}},{key:"renderSubLayers",value:function(t){return this.props.renderSubLayers(t)}},{key:"getSubLayerPropsByTile",value:function(t){return null}},{key:"getPickingInfo",value:function(t){var e=t.info,n=t.sourceLayer;return e.picked&&(e.tile=n.props.tile),e}},{key:"_updateAutoHighlight",value:function(t){t.sourceLayer&&t.sourceLayer.updateAutoHighlight(t)}},{key:"renderLayers",value:function(){var t=this;return this.state.tileset.tiles.map((function(e){var n=t.getSubLayerPropsByTile(e);if(e.isLoaded||e.content)if(e.layers)n&&e.layers[0]&&Object.keys(n).some((function(t){return e.layers[0].props[t]!==n[t]}))&&(e.layers=e.layers.map((function(t){return t.clone(n)})));else{var r=t.renderSubLayers(We(We({},t.props),{},{id:"".concat(t.id,"-").concat(e.id),data:e.content,_offset:0,tile:e}));e.layers=Object(N.b)(r,Boolean).map((function(t){return t.clone(We({tile:e},n))}))}else;return e.layers}))}},{key:"filterSubLayer",value:function(t){var e=t.layer,n=t.cullRect,r=e.props.tile;return this.state.tileset.isTileVisible(r,n)}}]),n}(m.a);f()(Ze,"defaultProps",Xe),f()(Ze,"layerName","TileLayer");var Je=n(8),Qe=n.n(Je);function Ke(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function Ye(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Ke(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Ke(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function $e(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}var tn=function(t){a()(n,t);var e=$e(n);function n(){return i()(this,n),e.apply(this,arguments)}return g()(n,[{key:"getShaders",value:function(){var t=Qe()(l()(n.prototype),"getShaders",this).call(this);return t.inject={"vs:#decl":"uniform float trailLength;\nattribute float instanceTimestamps;\nattribute float instanceNextTimestamps;\nvarying float vTime;\n","vs:#main-end":"vTime = instanceTimestamps + (instanceNextTimestamps - instanceTimestamps) * vPathPosition.y / vPathLength;\n","fs:#decl":"uniform bool fadeTrail;\nuniform float trailLength;\nuniform float currentTime;\nvarying float vTime;\n","fs:#main-start":"if(vTime > currentTime || (fadeTrail && (vTime < currentTime - trailLength))) {\n  discard;\n}\n","fs:DECKGL_FILTER_COLOR":"if(fadeTrail) {\n  color.a *= 1.0 - (currentTime - vTime) / trailLength;\n}\n"},t}},{key:"initializeState",value:function(){Qe()(l()(n.prototype),"initializeState",this).call(this),this.getAttributeManager().addInstanced({timestamps:{size:1,accessor:"getTimestamps",shaderAttributes:{instanceTimestamps:{vertexOffset:0},instanceNextTimestamps:{vertexOffset:1}}}})}},{key:"draw",value:function(t){var e=this.props,r=e.fadeTrail,i=e.trailLength,o=e.currentTime;t.uniforms=Ye(Ye({},t.uniforms),{},{fadeTrail:r,trailLength:i,currentTime:o}),Qe()(l()(n.prototype),"draw",this).call(this,t)}}]),n}(n(117).a);f()(tn,"layerName","TripsLayer"),f()(tn,"defaultProps",{fadeTrail:!0,trailLength:{type:"number",value:120,min:0},currentTime:{type:"number",value:0,min:0},getTimestamps:{type:"accessor",value:function(t){return t.timestamps}}});var en=function(t){var e,n=void 0!==(t=t||{})?t:{},r={};for(e in n)n.hasOwnProperty(e)&&(r[e]=n[e]);var i,o=[],a="";document.currentScript&&(a=document.currentScript.src),a=0!==a.indexOf("blob:")?a.substr(0,a.lastIndexOf("/")+1):"",i=function(t,e,n){var r=new XMLHttpRequest;r.open("GET",t,!0),r.responseType="arraybuffer",r.onload=function(){if(200==r.status||0==r.status&&r.response)e(r.response);else{var i=J(t);i?e(i.buffer):n()}},r.onerror=n,r.send(null)};var s=n.print||console.log.bind(console),u=n.printErr||console.warn.bind(console);for(e in r)r.hasOwnProperty(e)&&(n[e]=r[e]);r=null,n.arguments&&(o=n.arguments);var c=0,l=function(){return c};var h=!1;function f(t){var e,r=n["_"+t];return e="Cannot call unknown function "+t+", make sure it is exported",r||ut("Assertion failed: "+e),r}function p(t,e,n,r,i){var o={string:function(t){var e=0;if(null!=t&&0!==t){var n=1+(t.length<<2);(function(t,e,n){(function(t,e,n,r){if(!(r>0))return 0;for(var i=n,o=n+r-1,a=0;a<t.length;++a){var s=t.charCodeAt(a);if(s>=55296&&s<=57343){var u=t.charCodeAt(++a);s=65536+((1023&s)<<10)|1023&u}if(s<=127){if(n>=o)break;e[n++]=s}else if(s<=2047){if(n+1>=o)break;e[n++]=192|s>>6,e[n++]=128|63&s}else if(s<=65535){if(n+2>=o)break;e[n++]=224|s>>12,e[n++]=128|s>>6&63,e[n++]=128|63&s}else{if(n+3>=o)break;e[n++]=240|s>>18,e[n++]=128|s>>12&63,e[n++]=128|s>>6&63,e[n++]=128|63&s}}e[n]=0})(t,y,e,n)})(t,e=tt(n),n)}return e},array:function(t){var e=tt(t.length);return function(t,e){m.set(t,e)}(t,e),e}};var a=f(t),s=[],u=0;if(r)for(var c=0;c<r.length;c++){var l=o[n[c]];l?(0===u&&(u=nt()),s[c]=l(r[c])):s[c]=r[c]}var h=a.apply(null,s);return h=function(t){return"string"===e?A(t):"boolean"===e?Boolean(t):t}(h),0!==u&&et(u),h}var d="undefined"!=typeof TextDecoder?new TextDecoder("utf8"):void 0;function A(t,e){return t?function(t,e,n){for(var r=e+n,i=e;t[i]&&!(i>=r);)++i;if(i-e>16&&t.subarray&&d)return d.decode(t.subarray(e,i));for(var o="";e<i;){var a=t[e++];if(128&a){var s=63&t[e++];if(192!=(224&a)){var u=63&t[e++];if((a=224==(240&a)?(15&a)<<12|s<<6|u:(7&a)<<18|s<<12|u<<6|63&t[e++])<65536)o+=String.fromCharCode(a);else{var c=a-65536;o+=String.fromCharCode(55296|c>>10,56320|1023&c)}}else o+=String.fromCharCode((31&a)<<6|s)}else o+=String.fromCharCode(a)}return o}(y,t,e):""}var g,m,y,v,_,b,x;"undefined"!=typeof TextDecoder&&new TextDecoder("utf-16le");function w(t,e){return t%e>0&&(t+=e-t%e),t}function E(t){g=t,n.HEAP8=m=new Int8Array(t),n.HEAP16=v=new Int16Array(t),n.HEAP32=_=new Int32Array(t),n.HEAPU8=y=new Uint8Array(t),n.HEAPU16=new Uint16Array(t),n.HEAPU32=new Uint32Array(t),n.HEAPF32=b=new Float32Array(t),n.HEAPF64=x=new Float64Array(t)}var O=n.TOTAL_MEMORY||33554432;function S(t){for(;t.length>0;){var e=t.shift();if("function"!=typeof e){var r=e.func;"number"==typeof r?void 0===e.arg?n.dynCall_v(r):n.dynCall_vi(r,e.arg):r(void 0===e.arg?null:e.arg)}else e()}}O=(g=n.buffer?n.buffer:new ArrayBuffer(O)).byteLength,E(g),_[6004]=5266928;var T=[],C=[],P=[],M=[];var I=Math.abs,B=Math.ceil,R=Math.floor,k=Math.min,D=0,L=null,j=null;n.preloadedImages={},n.preloadedAudios={};var F,z,U=null,N="data:application/octet-stream;base64,";function G(t){return String.prototype.startsWith?t.startsWith(N):0===t.indexOf(N)}U="data:application/octet-stream;base64,AAAAAAAAAAACAAAAAwAAAAEAAAAFAAAABAAAAAYAAAAAAAAAAAAAAAAAAAABAAAAAgAAAAMAAAAEAAAABQAAAAYAAAABAAAABAAAAAMAAAAGAAAABQAAAAIAAAAAAAAAAgAAAAMAAAABAAAABAAAAAYAAAAAAAAABQAAAAMAAAAGAAAABAAAAAUAAAAAAAAAAQAAAAIAAAAEAAAABQAAAAYAAAAAAAAAAgAAAAMAAAABAAAABQAAAAIAAAAAAAAAAQAAAAMAAAAGAAAABAAAAAYAAAAAAAAABQAAAAIAAAABAAAABAAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAAAAgAAAAMAAAAAAAAAAAAAAAIAAAAAAAAAAQAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAEAAAABgAAAAAAAAAFAAAAAAAAAAAAAAAEAAAABQAAAAAAAAAAAAAAAAAAAAIAAAAAAAAABgAAAAAAAAAGAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAACAAAAAwAAAAQAAAAFAAAABgAAAAEAAAACAAAAAwAAAAQAAAAFAAAABgAAAAAAAAACAAAAAwAAAAQAAAAFAAAABgAAAAAAAAABAAAAAwAAAAQAAAAFAAAABgAAAAAAAAABAAAAAgAAAAQAAAAFAAAABgAAAAAAAAABAAAAAgAAAAMAAAAFAAAABgAAAAAAAAABAAAAAgAAAAMAAAAEAAAABgAAAAAAAAABAAAAAgAAAAMAAAAEAAAABQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAADAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAACAAAAAgAAAAAAAAAAAAAABgAAAAAAAAADAAAAAgAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAUAAAAEAAAAAAAAAAEAAAAAAAAAAAAAAAUAAAAFAAAAAAAAAAAAAAAAAAAABgAAAAAAAAAEAAAAAAAAAAYAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAUAAAACAAAABAAAAAMAAAAIAAAA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AAAAAAAAAAAAAAAABQAAAAAAAAAAAAAABQAAAAAAAAAAAAAAAAAAAAUAAAABAAAAAAAAAAAAAAABAAAAAwAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAQAAAAMAAAAAAAAAAAAAAAEAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAMAAAAFAAAAAQAAAAAAAAAAAAAAAQAAAAAAAAABAAAAAAAAAAEAAAAAAAAA/////wMAAAAAAAAABQAAAAIAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAQAAAAFAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABQAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAwAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAUAAAAFAAAAAAAAAAAAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAUAAAAFAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAABAAAAAAAAAAEAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAMAAAAAAAAAAAAAAP////8DAAAAAAAAAAUAAAACAAAAAAAAAAAAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAADAAAAAwAAAAAAAAAAAAAAAQAAAAAAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAEAAAADAAAAAAAAAAAAAAABAAAAAAAAAAMAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABQAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAwAAAAAAAAADAAAAAAAAAAAAAAABAAAAAwAAAAAAAAAAAAAAAQAAAAAAAAADAAAAAwAAAAMAAAADAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAMAAAAAAAAA/////wMAAAAAAAAABQAAAAIAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAADAAAAAAAAAAAAAAADAAAAAAAAAAAAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAADAAAABQAAAAUAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAUAAAAFAAAAAAAAAAAAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAADAAAAAAAAAAAAAAABAAAAAAAAAAAAAAADAAAAAAAAAAAAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAMAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAADAAAAAwAAAAAAAAADAAAAAAAAAAAAAAD/////AwAAAAAAAAAFAAAAAgAAAAAAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAAAAAADAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAADAAAAAwAAAAAAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAMAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAMAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAMAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAAAAAD/////AwAAAAAAAAAFAAAAAgAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAMAAAADAAAAAwAAAAMAAAADAAAAAAAAAAAAAAADAAAAAwAAAAMAAAADAAAAAAAAAAMAAAAAAAAAAwAAAAMAAAADAAAAAwAAAAAAAAADAAAAAAAAAP////8DAAAAAAAAAAUAAAACAAAAAAAAAAAAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAADAAAAAwAAAAAAAAADAAAAAAAAAAAAAAADAAAAAwAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAMAAAAAAAAAAAAAAP////8DAAAAAAAAAAUAAAACAAAAAAAAAAAAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAMAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAUAAAAAAAAAAAAAAAMAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAMAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAEAAAADAAAAAQAAAAAAAAABAAAAAAAAAAAAAAADAAAAAAAAAAMAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAMAAAAAAAAA/////wMAAAAAAAAABQAAAAIAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAAAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAMAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAMAAAAAAAAAAAAAAAMAAAADAAAAAwAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAMAAAAAAAAABQAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAUAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAUAAAAFAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAAAAAD/////AwAAAAAAAAAFAAAAAgAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAADAAAAAAAAAAUAAAAAAAAAAAAAAAUAAAAFAAAAAAAAAAAAAAAAAAAAAQAAAAMAAAABAAAAAAAAAAEAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAADAAAAAAAAAAMAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAMAAAABAAAAAAAAAAEAAAAAAAAAAwAAAAMAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAQAAAAAAAAADAAAABQAAAAEAAAAAAAAA/////wMAAAAAAAAABQAAAAIAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAUAAAAFAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAEAAAABQAAAAEAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAFAAAAAAAAAAAAAAAAAAAAAAAAAAMAAAAAAAAABQAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAgAAAAUAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAQAAAAMAAAABAAAAAAAAAAEAAAAAAAAABQAAAAAAAAAAAAAABQAAAAUAAAAAAAAAAAAAAP////8BAAAAAAAAAAMAAAAEAAAAAgAAAAAAAAAAAAAAAQAAAAAAAAAAAAAABQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAUAAAAAAAAAAAAAAAUAAAAFAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAABAAAABQAAAAEAAAAAAAAAAAAAAAEAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAAAAAAAAAAAAAAQAAAP//////////AQAAAAEAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAACAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAABAAAAAQAAAAAAAAAAAAAAAAAAAAMAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAACwAAAAIAAAAAAAAAAAAAAAEAAAACAAAABgAAAAQAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABgAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAACAAAAAAAAAAEAAAABAAAAAAAAAAAAAAAAAAAABwAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAIAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAABgAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAoAAAACAAAAAAAAAAAAAAABAAAAAQAAAAUAAAAGAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAsAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABQAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAHAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAACwAAAAEAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAAAAAIAAAAAAAAAAAAAAAEAAAADAAAABwAAAAYAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAHAAAAAQAAAAAAAAABAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAEAAAABAAAAAAAAAAAAAAAAAAAABAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAYAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAOAAAAAgAAAAAAAAAAAAAAAQAAAAAAAAAJAAAABQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAABAAAAAQAAAAAAAAAAAAAAAAAAAAwAAAABAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAHAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACwAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAoAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAANAAAAAgAAAAAAAAAAAAAAAQAAAAQAAAAIAAAACgAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAsAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAJAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAYAAAACAAAAAAAAAAAAAAABAAAACwAAAA8AAAAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACQAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAA4AAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFAAAAAQAAAAAAAAABAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAABAAAAAQAAAAAAAAAAAAAAAAAAAAgAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAFAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAcAAAACAAAAAAAAAAAAAAABAAAADAAAABAAAAAMAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAACgAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAkAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAANAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAA8AAAAAAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAPAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAA4AAAABAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAANAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAABQAAAAIAAAAAAAAAAAAAAAEAAAAKAAAAEwAAAAgAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAOAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACQAAAAEAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAA4AAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAARAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAARAAAAAAAAAAEAAAABAAAAAAAAAAAAAAAAAAAADwAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAABAAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAJAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA0AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIAAAAAgAAAAAAAAAAAAAAAQAAAA0AAAARAAAADQAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAABEAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAATAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAADgAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAABMAAAAAAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAARAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAADQAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAABEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACQAAAAIAAAAAAAAAAAAAAAEAAAAOAAAAEgAAAA8AAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAPAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEgAAAAAAAAABAAAAAQAAAAAAAAAAAAAAAAAAABIAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAATAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAEQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAASAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAEgAAAAEAAAAAAAAAAQAAAAAAAAAAAAAAAAAAABMAAAACAAAAAAAAAAAAAAABAAAA//////////8TAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABMAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAASAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAABIAAAAAAAAAGAAAAAAAAAAhAAAAAAAAAB4AAAAAAAAAIAAAAAMAAAAxAAAAAQAAADAAAAADAAAAMgAAAAMAAAAIAAAAAAAAAAUAAAAFAAAACgAAAAUAAAAWAAAAAAAAABAAAAAAAAAAEgAAAAAAAAApAAAAAQAAACEAAAAAAAAAHgAAAAAAAAAEAAAAAAAAAAAAAAAFAAAAAgAAAAUAAAAPAAAAAQAAAAgAAAAAAAAABQAAAAUAAAAfAAAAAQAAABYAAAAAAAAAEAAAAAAAAAACAAAAAAAAAAYAAAAAAAAADgAAAAAAAAAKAAAAAAAAAAsAAAAAAAAAEQAAAAMAAAAYAAAAAQAAABcAAAADAAAAGQAAAAMAAAAAAAAAAAAAAAEAAAAFAAAACQAAAAUAAAAFAAAAAAAAAAIAAAAAAAAABgAAAAAAAAASAAAAAQAAAAoAAAAAAAAACwAAAAAAAAAEAAAAAQAAAAMAAAAFAAAABwAAAAUAAAAIAAAAAQAAAAAAAAAAAAAAAQAAAAUAAAAQAAAAAQAAAAUAAAAAAAAAAgAAAAAAAAAHAAAAAAAAABUAAAAAAAAAJgAAAAAAAAAJAAAAAAAAABMAAAAAAAAAIgAAAAMAAAAOAAAAAQAAABQAAAADAAAAJAAAAAMAAAADAAAAAAAAAA0AAAAFAAAAHQAAAAUAAAABAAAAAAAAAAcAAAAAAAAAFQAAAAAAAAAGAAAA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74auECWhw7+cjSACjzniv8CZ+wUhN9I/1uGEKzup6z+/GYr/04bavwmkNHp7xee/F2NMZVAA1z+82s+x2BLivwr2ytbJ9em/KwEH1sMS1r8yp/2LhTfev81i5RexJsy/BlIKPVwR5b95Wyu0/Qjnv5DjoT7YYcs/nBhKZ6zrwr8wRYS7Nebuv3OW6geh+Lu/SLrixebL3j+pcyymN9Xrv8rHIFfWehZAMBwUdlo0DECTUc17EOb2PxpVB1SWChdAzjbhb9pTDUDQhmdvECX5P9FlMKCC9+g/IIAzjELgE0DajDngMv8GQFhWDmDPjNs/y1guLh96EkAxPi8k7DIEQJCc4URlhRhA3eLKKLwkEECqpNAyTBD/P6xpjXcDiwVAFtl//cQm4z+Ibt3XKiYTQM7mCLUb3QdAoM1t8yVv7D8aLZv2Nk8UQEAJPV5nQwxAtSsfTCoE9z9TPjXLXIIWQBVanC5W9AtAYM3d7Adm9j++5mQz1FoWQBUThyaVBghAwH5muQsV7T89Q1qv82MUQJoWGOfNuBdAzrkClkmwDkDQjKq77t37Py+g0dtitsE/ZwAMTwVPEUBojepluNwBQGYbtuW+t9w/HNWIJs6MEkDTNuQUSlgEQKxktPP5TcQ/ixbLB8JjEUCwuWjXMQYCQAS/R09FkRdAowpiZjhhDkB7LmlczD/7P01iQmhhsAVAnrtTwDy84z/Z6jfQ2TgTQChOCXMnWwpAhrW3daoz8z/HYJvVPI4VQLT3ik5FcA5Angi7LOZd+z+NNVzDy5gXQBXdvVTFUA1AYNMgOeYe+T8+qHXGCwkXQKQTOKwa5AJA8gFVoEMW0T+FwzJyttIRQAEAAAD/////BwAAAP////8xAAAA/////1cBAAD/////YQkAAP////+nQQAA/////5HLAQD/////95AMAP/////B9lcAAAAAAAAAAAAAAAAAAgAAAP////8OAAAA/////2IAAAD/////rgIAAP/////CEgAA/////06DAAD/////IpcDAP/////uIRkA/////4LtrwAAAAAAAAAAAAAAAAAAAAAAAgAAAP//////////AQAAAAMAAAD//////////////////////////////////////////////////////////////////////////wEAAAAAAAAAAgAAAP///////////////wMAAAD//////////////////////////////////////////////////////////////////////////wEAAAAAAAAAAgAAAP///////////////wMAAAD//////////////////////////////////////////////////////////////////////////wEAAAAAAAAAAgAAAP///////////////wMAAAD//////////////////////////////////////////////////////////wIAAAD//////////wEAAAAAAAAA/////////////////////wMAAAD/////////////////////////////////////////////////////AwAAAP////////////////////8AAAAA/////////////////////wEAAAD///////////////8CAAAA////////////////////////////////AwAAAP////////////////////8AAAAA////////////////AgAAAAEAAAD/////////////////////////////////////////////////////AwAAAP////////////////////8AAAAA////////////////AgAAAAEAAAD/////////////////////////////////////////////////////AwAAAP////////////////////8AAAAA////////////////AgAAAAEAAAD/////////////////////////////////////////////////////AwAAAP////////////////////8AAAAA////////////////AgAAAAEAAAD/////////////////////////////////////////////////////AQAAAAIAAAD///////////////8AAAAA/////////////////////wMAAAD/////////////////////////////////////////////////////AQAAAAIAAAD///////////////8AAAAA/////////////////////wMAAAD/////////////////////////////////////////////////////AQAAAAIAAAD///////////////8AAAAA/////////////////////wMAAAD/////////////////////////////////////////////////////AQAAAAIAAAD///////////////8AAAAA/////////////////////wMAAAD///////////////////////////////8CAAAA////////////////AQAAAP////////////////////8AAAAA/////////////////////wMAAAD/////////////////////////////////////////////////////AwAAAP////////////////////8AAAAAAQAAAP//////////AgAAAP//////////////////////////////////////////////////////////AwAAAP///////////////wIAAAAAAAAAAQAAAP//////////////////////////////////////////////////////////////////////////AwAAAP///////////////wIAAAAAAAAAAQAAAP//////////////////////////////////////////////////////////////////////////AwAAAP///////////////wIAAAAAAAAAAQAAAP//////////////////////////////////////////////////////////////////////////AwAAAAEAAAD//////////wIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAgAAAAAAAAACAAAAAQAAAAEAAAACAAAAAgAAAAAAAAAFAAAABQAAAAAAAAACAAAAAgAAAAMAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAAAAAAIAAAABAAAAAgAAAAIAAAACAAAAAAAAAAUAAAAGAAAAAAAAAAIAAAACAAAAAwAAAAIAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAIAAAAAAAAAAgAAAAEAAAADAAAAAgAAAAIAAAAAAAAABQAAAAcAAAAAAAAAAgAAAAIAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAgAAAAAAAAACAAAAAQAAAAQAAAACAAAAAgAAAAAAAAAFAAAACAAAAAAAAAACAAAAAgAAAAMAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAMAAAACAAAAAAAAAAIAAAABAAAAAAAAAAIAAAACAAAAAAAAAAUAAAAJAAAAAAAAAAIAAAACAAAAAwAAAAUAAAAAAAAAAAAAAAAAAAAAAAAACgAAAAIAAAACAAAAAAAAAAMAAAAOAAAAAgAAAAAAAAACAAAAAwAAAAAAAAAAAAAAAgAAAAIAAAADAAAABgAAAAAAAAAAAAAAAAAAAAAAAAALAAAAAgAAAAIAAAAAAAAAAwAAAAoAAAACAAAAAAAAAAIAAAADAAAAAQAAAAAAAAACAAAAAgAAAAMAAAAHAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAACAAAAAgAAAAAAAAADAAAACwAAAAIAAAAAAAAAAgAAAAMAAAACAAAAAAAAAAIAAAACAAAAAwAAAAgAAAAAAAAAAAAAAAAAAAAAAAAADQAAAAIAAAACAAAAAAAAAAMAAAAMAAAAAgAAAAAAAAACAAAAAwAAAAMAAAAAAAAAAgAAAAIAAAADAAAACQAAAAAAAAAAAAAAAAAAAAAAAAAOAAAAAgAAAAIAAAAAAAAAAwAAAA0AAAACAAAAAAAAAAIAAAADAAAABAAAAAAAAAACAAAAAgAAAAMAAAAKAAAAAAAAAAAAAAAAAAAAAAAAAAUAAAACAAAAAgAAAAAAAAADAAAABgAAAAIAAAAAAAAAAgAAAAMAAAAPAAAAAAAAAAIAAAACAAAAAwAAAAsAAAAAAAAAAAAAAAAAAAAAAAAABgAAAAIAAAACAAAAAAAAAAMAAAAHAAAAAgAAAAAAAAACAAAAAwAAABAAAAAAAAAAAgAAAAIAAAADAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAHAAAAAgAAAAIAAAAAAAAAAwAAAAgAAAACAAAAAAAAAAIAAAADAAAAEQAAAAAAAAACAAAAAgAAAAMAAAANAAAAAAAAAAAAAAAAAAAAAAAAAAgAAAACAAAAAgAAAAAAAAADAAAACQAAAAIAAAAAAAAAAgAAAAMAAAASAAAAAAAAAAIAAAACAAAAAwAAAA4AAAAAAAAAAAAAAAAAAAAAAAAACQAAAAIAAAACAAAAAAAAAAMAAAAFAAAAAgAAAAAAAAACAAAAAwAAABMAAAAAAAAAAgAAAAIAAAADAAAA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AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/////////////////////////////////////wAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAUAAAABAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP////////////////////////////////////8AAAAAAQAAAAEAAAABAAAAAQAAAAEAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAABAAAAAAAAAAAAAAABAAAAAQAAAAEAAAAAAAAAAQAAAAAAAAAFAAAAAQAAAAEAAAAAAAAAAAAAAAEAAAABAAAAAAAAAAEAAAABAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEBAAAAAAABAAEAAAEBAAAAAAABAAAAAQAAAAEAAQAAAAAAAAAAAAAAAAAAAAAEAAAABAAAAAAAAAACAAAAAQAAAAMAAAAOAAAABgAAAAsAAAACAAAABwAAAAEAAAAYAAAABQAAAAoAAAABAAAABgAAAAAAAAAmAAAABwAAAAwAAAADAAAACAAAAAIAAAAxAAAACQAAAA4AAAAAAAAABQAAAAQAAAA6AAAACAAAAA0AAAAEAAAACQAAAAMAAAA/AAAACwAAAAYAAAAPAAAACgAAABAAAABIAAAADAAAAAcAAAAQAAAACwAAABEAAABTAAAACgAAAAUAAAATAAAADgAAAA8AAABhAAAADQAAAAgAAAARAAAADAAAABIAAABrAAAADgAAAAkAAAASAAAADQAAABMAAAB1AAAADwAAABMAAAARAAAAEgAAABAAAAAHAAAABwAAAAEAAAACAAAABAAAAAMAAAAAAAAAAAAAAAcAAAADAAAAAQAAAAIAAAAFAAAABAAAAAAAAAAAAAAAYWxnb3MuYwBfcG9seWZpbGxJbnRlcm5hbABhZGphY2VudEZhY2VEaXJbdG1wRmlqay5mYWNlXVtmaWprLmZhY2VdID09IEtJAGZhY2VpamsuYwBfZmFjZUlqa1BlbnRUb0dlb0JvdW5kYXJ5AGFkamFjZW50RmFjZURpcltjZW50ZXJJSksuZmFjZV1bZmFjZTJdID09IEtJAF9mYWNlSWprVG9HZW9Cb3VuZGFyeQBwb2x5Z29uLT5uZXh0ID09IE5VTEwAbGlua2VkR2VvLmMAYWRkTmV3TGlua2VkUG9seWdvbgBuZXh0ICE9IE5VTEwAbG9vcCAhPSBOVUxMAGFkZE5ld0xpbmtlZExvb3AAcG9seWdvbi0+Zmlyc3QgPT0gTlVMTABhZGRMaW5rZWRMb29wAGNvb3JkICE9IE5VTEwAYWRkTGlua2VkQ29vcmQAbG9vcC0+Zmlyc3QgPT0gTlVMTABpbm5lckxvb3BzICE9IE5VTEwAbm9ybWFsaXplTXVsdGlQb2x5Z29uAGJib3hlcyAhPSBOVUxMAGNhbmRpZGF0ZXMgIT0gTlVMTABmaW5kUG9seWdvbkZvckhvbGUAY2FuZGlkYXRlQkJveGVzICE9IE5VTEwAcmV2RGlyICE9IElOVkFMSURfRElHSVQAbG9jYWxpai5jAGgzVG9Mb2NhbElqawBiYXNlQ2VsbCAhPSBvcmlnaW5CYXNlQ2VsbAAhKG9yaWdpbk9uUGVudCAmJiBpbmRleE9uUGVudCkAcGVudGFnb25Sb3RhdGlvbnMgPj0gMABkaXJlY3Rpb25Sb3RhdGlvbnMgPj0gMABiYXNlQ2VsbCA9PSBvcmlnaW5CYXNlQ2VsbABiYXNlQ2VsbCAhPSBJTlZBTElEX0JBU0VfQ0VMTABsb2NhbElqa1RvSDMAIV9pc0Jhc2VDZWxsUGVudGFnb24oYmFzZUNlbGwpAGJhc2VDZWxsUm90YXRpb25zID49IDAAd2l0aGluUGVudGFnb25Sb3RhdGlvbnMgPj0gMABncmFwaC0+YnVja2V0cyAhPSBOVUxMAHZlcnRleEdyYXBoLmMAaW5pdFZlcnRleEdyYXBoAG5vZGUgIT0gTlVMTABhZGRWZXJ0ZXhOb2Rl";function V(t){return t}function H(t){return t.replace(/\b__Z[\w\d_]+/g,(function(t){return t===t?t:t+" ["+t+"]"}))}function W(){var t=new Error;if(!t.stack){try{throw new Error(0)}catch(e){t=e}if(!t.stack)return"(no stack trace available)"}return t.stack.toString()}function q(){return m.length}function X(t){try{var e=new ArrayBuffer(t);if(e.byteLength!=t)return;return new Int8Array(e).set(m),$(e),E(e),1}catch(t){}}var Z="function"==typeof atob?atob:function(t){var e,n,r,i,o,a,s="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=",u="",c=0;t=t.replace(/[^A-Za-z0-9\+\/\=]/g,"");do{e=s.indexOf(t.charAt(c++))<<2|(i=s.indexOf(t.charAt(c++)))>>4,n=(15&i)<<4|(o=s.indexOf(t.charAt(c++)))>>2,r=(3&o)<<6|(a=s.indexOf(t.charAt(c++))),u+=String.fromCharCode(e),64!==o&&(u+=String.fromCharCode(n)),64!==a&&(u+=String.fromCharCode(r))}while(c<t.length);return u};function J(t){if(G(t))return function(t){try{for(var e=Z(t),n=new Uint8Array(e.length),r=0;r<e.length;++r)n[r]=e.charCodeAt(r);return n}catch(t){throw new Error("Converting base64 string to bytes failed.")}}(t.slice(N.length))}var Q,K,Y=function(t,e,n){var r=new t.Int8Array(n),i=new t.Int32Array(n),o=(new t.Uint8Array(n),new t.Float32Array(n),new t.Float64Array(n)),a=0|e.p,s=t.Math.floor,u=t.Math.abs,c=t.Math.sqrt,l=t.Math.pow,h=t.Math.cos,f=t.Math.sin,p=t.Math.tan,d=t.Math.acos,A=t.Math.asin,g=t.Math.atan,m=t.Math.atan2,y=t.Math.ceil,v=t.Math.imul,_=t.Math.min,b=t.Math.clz32,x=e.b,w=e.c,E=e.d,O=e.e,S=e.f,T=e.g,C=e.h,P=e.i,M=24048;function I(t,e,n,r){var i,o;0|B(t|=0,e|=0,n|=0,r|=0,0)&&(Pe(0|r,0,(o=1+(0|v(3*n|0,n+1|0))|0)<<3|0),(i=0|ve(o,4))&&(R(t,e,n,r,i,o,0),ye(i)))}function B(t,e,n,r,o){t|=0,e|=0,n|=0,o|=0;var a,s=0,u=0,c=0,l=0,h=0,f=0,p=0,d=0;if(a=M,M=M+16|0,d=a,i[(s=r|=0)>>2]=t,i[s+4>>2]=e,(s=0!=(0|o))&&(i[o>>2]=0),0|kt(t,e))return M=a,0|(d=1);i[d>>2]=0;t:do{if((0|n)>=1)if(s)for(h=0,f=1,p=1,u=0,s=t;;){if(!(u|h)){if(0==(0|(s=0|k(s,e,4,d)))&0==(0|(e=0|w()))){s=2;break t}if(0|kt(s,e)){s=1;break t}}if(0==(0|(s=0|k(s,e,0|i[16+(h<<2)>>2],d)))&0==(0|(e=0|w()))){s=2;break t}if(i[(t=r+(p<<3)|0)>>2]=s,i[t+4>>2]=e,i[o+(p<<2)>>2]=f,t=(0|(u=u+1|0))==(0|f),l=6==(0|(c=h+1|0)),0|kt(s,e)){s=1;break t}if((0|(f=f+(l&t&1)|0))>(0|n)){s=0;break}h=t?l?0:c:h,p=p+1|0,u=t?0:u}else for(h=0,f=1,p=1,u=0,s=t;;){if(!(u|h)){if(0==(0|(s=0|k(s,e,4,d)))&0==(0|(e=0|w()))){s=2;break t}if(0|kt(s,e)){s=1;break t}}if(0==(0|(s=0|k(s,e,0|i[16+(h<<2)>>2],d)))&0==(0|(e=0|w()))){s=2;break t}if(i[(t=r+(p<<3)|0)>>2]=s,i[t+4>>2]=e,t=(0|(u=u+1|0))==(0|f),l=6==(0|(c=h+1|0)),0|kt(s,e)){s=1;break t}if((0|(f=f+(l&t&1)|0))>(0|n)){s=0;break}h=t?l?0:c:h,p=p+1|0,u=t?0:u}else s=0}while(0);return M=a,0|(d=s)}function R(t,e,n,r,o,a,s){n|=0,r|=0,o|=0,a|=0,s|=0;var u,c,l=0,h=0,f=0,p=0,d=0;if(c=M,M=M+16|0,u=c,0==(0|(t|=0))&0==(0|(e|=0)))M=c;else{if(l=0|we(0|t,0|e,0|a,((0|a)<0)<<31>>31|0),w(),!(0==(0|(d=0|i[(p=h=r+(l<<3)|0)>>2]))&0==(0|(p=0|i[p+4>>2]))|(f=(0|d)==(0|t)&(0|p)==(0|e))))do{f=(0|(p=0|i[(d=h=r+((l=(l+1|0)%(0|a)|0)<<3)|0)>>2]))==(0|t)&(0|(d=0|i[d+4>>2]))==(0|e)}while(!(0==(0|p)&0==(0|d)|f));l=o+(l<<2)|0,f&&(0|i[l>>2])<=(0|s)||(i[(d=h)>>2]=t,i[d+4>>2]=e,i[l>>2]=s,(0|s)>=(0|n)||(d=s+1|0,i[u>>2]=0,R(p=0|k(t,e,2,u),0|w(),n,r,o,a,d),i[u>>2]=0,R(p=0|k(t,e,3,u),0|w(),n,r,o,a,d),i[u>>2]=0,R(p=0|k(t,e,1,u),0|w(),n,r,o,a,d),i[u>>2]=0,R(p=0|k(t,e,5,u),0|w(),n,r,o,a,d),i[u>>2]=0,R(p=0|k(t,e,4,u),0|w(),n,r,o,a,d),i[u>>2]=0,R(p=0|k(t,e,6,u),0|w(),n,r,o,a,d))),M=c}}function k(t,e,n,r){t|=0,e|=0,n|=0;var o,a,s=0,u=0,c=0,l=0,h=0,f=0,p=0;if((0|i[(r|=0)>>2])>0){s=0;do{n=0|ut(n),s=s+1|0}while((0|s)<(0|i[r>>2]))}o=0|Ee(0|t,0|e,45),w(),a=127&o,u=0|Dt(t,e),s=0|Ee(0|t,0|e,52),w(),s&=15;t:do{if(s)for(;;){if(f=0|Ee(0|t,0|e,0|(h=3*(15-s|0)|0)),w(),f&=7,p=0==(0|Ut(s)),s=s+-1|0,l=0|Oe(7,0,0|h),e&=~(0|w()),t=(h=0|Oe(0|i[(p?464:48)+(28*f|0)+(n<<2)>>2],0,0|h))|t&~l,e|=0|w(),!(n=0|i[(p?672:256)+(28*f|0)+(n<<2)>>2])){n=0;break t}if(!s){c=6;break}}else c=6}while(0);6==(0|c)&&(t|=f=0|Oe(0|(p=0|i[880+(28*a|0)+(n<<2)>>2]),0,45),e=0|w()|-1040385&e,n=0|i[4304+(28*a|0)+(n<<2)>>2],127==(127&p|0)&&(p=0|Oe(0|i[880+(28*a|0)+20>>2],0,45),e=0|w()|-1040385&e,n=0|i[4304+(28*a|0)+20>>2],t=0|jt(p|t,e),e=0|w(),i[r>>2]=1+(0|i[r>>2]))),c=0|Ee(0|t,0|e,45),w(),c&=127;t:do{if(0|L(c)){e:do{if(1==(0|Dt(t,e))){if((0|a)!=(0|c)){if(0|U(c,0|i[7728+(28*a|0)>>2])){t=0|zt(t,e),u=1,e=0|w();break}t=0|jt(t,e),u=1,e=0|w();break}switch(0|u){case 5:t=0|zt(t,e),e=0|w(),i[r>>2]=5+(0|i[r>>2]),u=0;break e;case 3:t=0|jt(t,e),e=0|w(),i[r>>2]=1+(0|i[r>>2]),u=0;break e;default:return p=0,x(0|(f=0)),0|p}}else u=0}while(0);if((0|n)>0){s=0;do{t=0|Lt(t,e),e=0|w(),s=s+1|0}while((0|s)!=(0|n))}if((0|a)!=(0|c)){if(!(0|j(c))){if(0!=(0|u)|5!=(0|Dt(t,e)))break;i[r>>2]=1+(0|i[r>>2]);break}switch(127&o){case 8:case 118:break t}3!=(0|Dt(t,e))&&(i[r>>2]=1+(0|i[r>>2]))}}else if((0|n)>0){s=0;do{t=0|jt(t,e),e=0|w(),s=s+1|0}while((0|s)!=(0|n))}}while(0);return i[r>>2]=((0|i[r>>2])+n|0)%6|0,p=t,x(0|(f=e)),0|p}function D(t,e,n,r,a,s){e|=0,n|=0,r|=0,a|=0,s|=0;var u,c,l,h,f,p,d,A,g,m=0,y=0,v=0,_=0,b=0,x=0,E=0,O=0,S=0,T=0,C=0,P=0,I=0,B=0;if(g=M,M=M+48|0,p=g+32|0,d=g+16|0,A=g,(0|(m=0|i[(t|=0)>>2]))<=0)return M=g,0|(P=0);u=t+4|0,c=p+8|0,l=d+8|0,h=A+8|0,f=((0|e)<0)<<31>>31,C=0;t:for(;;){S=(y=0|i[u>>2])+(C<<4)|0,i[p>>2]=i[S>>2],i[p+4>>2]=i[S+4>>2],i[p+8>>2]=i[S+8>>2],i[p+12>>2]=i[S+12>>2],(0|C)==(m+-1|0)?(i[d>>2]=i[y>>2],i[d+4>>2]=i[y+4>>2],i[d+8>>2]=i[y+8>>2],i[d+12>>2]=i[y+12>>2]):(S=y+(C+1<<4)|0,i[d>>2]=i[S>>2],i[d+4>>2]=i[S+4>>2],i[d+8>>2]=i[S+8>>2],i[d+12>>2]=i[S+12>>2]),S=0|q(p,d,n);e:do{if((0|S)>0){T=+(0|S),O=0;n:for(;;){B=+(S-O|0),I=+(0|O),o[A>>3]=+o[p>>3]*B/T+ +o[d>>3]*I/T,o[h>>3]=+o[c>>3]*B/T+ +o[l>>3]*I/T,y=0|we(0|(x=0|Nt(A,n)),0|(E=0|w()),0|e,0|f),w(),_=0|i[(v=m=s+(y<<3)|0)>>2],v=0|i[v+4>>2];r:do{if(0==(0|_)&0==(0|v))P=14;else for(b=0;;){if((0|b)>(0|e)){m=1;break r}if((0|_)==(0|x)&(0|v)==(0|E)){m=7;break r}if(0==(0|(_=0|i[(v=m=s+((y=(y+1|0)%(0|e)|0)<<3)|0)>>2]))&0==(0|(v=0|i[v+4>>2]))){P=14;break}b=b+1|0}}while(0);switch(14==(0|P)&&(P=0,0==(0|x)&0==(0|E)?m=7:(i[m>>2]=x,i[m+4>>2]=E,m=0|i[r>>2],i[(b=a+(m<<3)|0)>>2]=x,i[b+4>>2]=E,i[r>>2]=m+1,m=0)),7&m){case 7:case 0:break;default:break n}if((0|S)<=(0|(O=O+1|0))){P=8;break e}}if(0|m){m=-1,P=20;break t}}else P=8}while(0);if(8==(0|P)&&(P=0),(0|(C=C+1|0))>=(0|(m=0|i[t>>2]))){m=0,P=20;break}}return 20==(0|P)?(M=g,0|m):0}function L(t){return 0|i[7728+(28*(t|=0)|0)+16>>2]}function j(t){return 4==(0|(t|=0))|117==(0|t)|0}function F(t){return 0|i[11152+(216*(0|i[(t|=0)>>2])|0)+(72*(0|i[t+4>>2])|0)+(24*(0|i[t+8>>2])|0)+(i[t+12>>2]<<3)>>2]}function z(t){return 0|i[11152+(216*(0|i[(t|=0)>>2])|0)+(72*(0|i[t+4>>2])|0)+(24*(0|i[t+8>>2])|0)+(i[t+12>>2]<<3)+4>>2]}function U(t,e){return e|=0,(0|i[7728+(28*(t|=0)|0)+20>>2])==(0|e)?0|(e=1):0|(e=(0|i[7728+(28*t|0)+24>>2])==(0|e))}function N(t,e){return 0|i[880+(28*(t|=0)|0)+((e|=0)<<2)>>2]}function G(t,e){return e|=0,(0|i[880+(28*(t|=0)|0)>>2])==(0|e)?0|(e=0):(0|i[880+(28*t|0)+4>>2])==(0|e)?0|(e=1):(0|i[880+(28*t|0)+8>>2])==(0|e)?0|(e=2):(0|i[880+(28*t|0)+12>>2])==(0|e)?0|(e=3):(0|i[880+(28*t|0)+16>>2])==(0|e)?0|(e=4):(0|i[880+(28*t|0)+20>>2])==(0|e)?0|(e=5):0|((0|i[880+(28*t|0)+24>>2])==(0|e)?6:7)}function V(t){return+o[(t|=0)+16>>3]<+o[t+24>>3]|0}function H(t,e){t|=0;var n,r,i=0;return(i=+o[(e|=0)>>3])>=+o[t+8>>3]&&i<=+o[t>>3]?(n=+o[t+16>>3],i=+o[t+24>>3],e=(r=+o[e+8>>3])>=i,t=r<=n&1,n<i?e&&(t=1):e||(t=0),0|(e=0!=(0|t))):0|(e=0)}function W(t,e){t|=0,e|=0;var n,r,a,s,c,l,h=0,f=0;s=M,M=M+288|0,n=s+264|0,r=s+96|0,f=(h=a=s)+96|0;do{i[h>>2]=0,h=h+4|0}while((0|h)<(0|f));return qt(e,a),Ht(f=0|i[(h=a)>>2],h=0|i[h+4>>2],n),Wt(f,h,r),c=+Ct(n,r+8|0),o[n>>3]=+o[t>>3],o[(h=n+8|0)>>3]=+o[t+16>>3],o[r>>3]=+o[t+8>>3],o[(f=r+8|0)>>3]=+o[t+24>>3],l=+Ct(n,r),f=~~+y(+l*l/+Se(+ +u(+(+o[h>>3]-+o[f>>3])/(+o[n>>3]-+o[r>>3])),3)/(c*(2.59807621135*c)*.8)),M=s,0|(0==(0|f)?1:f)}function q(t,e,n){t|=0,e|=0,n|=0;var r,o,a,s,u,c=0,l=0;s=M,M=M+288|0,r=s+264|0,o=s+96|0,l=(c=a=s)+96|0;do{i[c>>2]=0,c=c+4|0}while((0|c)<(0|l));return qt(n,a),Ht(c=0|i[(l=a)>>2],l=0|i[l+4>>2],r),Wt(c,l,o),u=+Ct(r,o+8|0),l=~~+y(+ +Ct(t,e)/(2*u)),M=s,0|(0==(0|l)?1:l)}function X(t,e,n,r){e|=0,n|=0,r|=0,i[(t|=0)>>2]=e,i[t+4>>2]=n,i[t+8>>2]=r}function Z(t,e){t|=0;var n,r,a,s,c=0,l=0,h=0,f=0,p=0,d=0,A=0;i[(s=(e|=0)+8|0)>>2]=0,r=+o[t>>3],f=+u(+r),a=+o[t+8>>3],f+=.5*(p=+u(+a)/.8660254037844386),f-=+(0|(c=~~f)),p-=+(0|(t=~~p));do{if(f<.5){if(f<.3333333333333333){if(i[e>>2]=c,p<.5*(f+1)){i[e+4>>2]=t;break}t=t+1|0,i[e+4>>2]=t;break}if(t=(1&!(p<(A=1-f)))+t|0,i[e+4>>2]=t,A<=p&p<2*f){c=c+1|0,i[e>>2]=c;break}i[e>>2]=c;break}if(!(f<.6666666666666666)){if(c=c+1|0,i[e>>2]=c,p<.5*f){i[e+4>>2]=t;break}t=t+1|0,i[e+4>>2]=t;break}if(p<1-f){if(i[e+4>>2]=t,2*f-1<p){i[e>>2]=c;break}}else t=t+1|0,i[e+4>>2]=t;c=c+1|0,i[e>>2]=c}while(0);do{if(r<0){if(1&t){c=~~(+(0|c)-(2*(+((d=0|_e(0|c,((0|c)<0)<<31>>31|0,0|(d=(t+1|0)/2|0),((0|d)<0)<<31>>31|0))>>>0)+4294967296*+(0|w()))+1)),i[e>>2]=c;break}c=~~(+(0|c)-2*(+((d=0|_e(0|c,((0|c)<0)<<31>>31|0,0|(d=(0|t)/2|0),((0|d)<0)<<31>>31|0))>>>0)+4294967296*+(0|w()))),i[e>>2]=c;break}}while(0);d=e+4|0,a<0&&(c=c-((1|t<<1)/2|0)|0,i[e>>2]=c,t=0-t|0,i[d>>2]=t),l=t-c|0,(0|c)<0?(h=0-c|0,i[d>>2]=l,i[s>>2]=h,i[e>>2]=0,t=l,c=0):h=0,(0|t)<0&&(c=c-t|0,i[e>>2]=c,h=h-t|0,i[s>>2]=h,i[d>>2]=0,t=0),n=c-h|0,l=t-h|0,(0|h)<0&&(i[e>>2]=n,i[d>>2]=l,i[s>>2]=0,t=l,c=n,h=0),(0|(l=(0|h)<(0|(l=(0|t)<(0|c)?t:c))?h:l))<=0||(i[e>>2]=c-l,i[d>>2]=t-l,i[s>>2]=h-l)}function J(t){var e,n=0,r=0,o=0,a=0,s=0;n=0|i[(t|=0)>>2],r=0|i[(e=t+4|0)>>2],(0|n)<0&&(r=r-n|0,i[e>>2]=r,i[(s=t+8|0)>>2]=(0|i[s>>2])-n,i[t>>2]=0,n=0),(0|r)<0?(n=n-r|0,i[t>>2]=n,a=(0|i[(s=t+8|0)>>2])-r|0,i[s>>2]=a,i[e>>2]=0,r=0):(s=a=t+8|0,a=0|i[a>>2]),(0|a)<0&&(n=n-a|0,i[t>>2]=n,r=r-a|0,i[e>>2]=r,i[s>>2]=0,a=0),(0|(o=(0|a)<(0|(o=(0|r)<(0|n)?r:n))?a:o))<=0||(i[t>>2]=n-o,i[e>>2]=r-o,i[s>>2]=a-o)}function Q(t,e){e|=0;var n,r;r=0|i[(t|=0)+8>>2],n=+((0|i[t+4>>2])-r|0),o[e>>3]=+((0|i[t>>2])-r|0)-.5*n,o[e+8>>3]=.8660254037844386*n}function K(t,e,n){t|=0,e|=0,i[(n|=0)>>2]=(0|i[e>>2])+(0|i[t>>2]),i[n+4>>2]=(0|i[e+4>>2])+(0|i[t+4>>2]),i[n+8>>2]=(0|i[e+8>>2])+(0|i[t+8>>2])}function Y(t,e,n){t|=0,e|=0,i[(n|=0)>>2]=(0|i[t>>2])-(0|i[e>>2]),i[n+4>>2]=(0|i[t+4>>2])-(0|i[e+4>>2]),i[n+8>>2]=(0|i[t+8>>2])-(0|i[e+8>>2])}function $(t,e){e|=0;var n,r=0;r=0|v(0|i[(t|=0)>>2],e),i[t>>2]=r,n=0|v(0|i[(r=t+4|0)>>2],e),i[r>>2]=n,e=0|v(0|i[(t=t+8|0)>>2],e),i[t>>2]=e}function tt(t){var e,n,r=0,o=0,a=0,s=0,u=0;u=(0|(n=0|i[(t|=0)>>2]))<0,t=(t=(o=(0|(s=((e=(0|(a=(0|i[t+4>>2])-(u?n:0)|0))<0)?0-a|0:0)+((0|i[t+8>>2])-(u?n:0))|0))<0)?0:s)-((a=(0|(o=(0|t)<(0|(o=(0|(r=(e?0:a)-(o?s:0)|0))<(0|(s=(u?0:n)-(e?a:0)-(o?s:0)|0))?r:s))?t:o))>0)?o:0)|0,r=r-(a?o:0)|0;t:do{switch(s-(a?o:0)|0){case 0:switch(0|r){case 0:return 0|(u=0==(0|t)?0:1==(0|t)?1:7);case 1:return 0|(u=0==(0|t)?2:1==(0|t)?3:7);default:break t}case 1:switch(0|r){case 0:return 0|(u=0==(0|t)?4:1==(0|t)?5:7);case 1:if(t)break t;return 0|(t=6);default:break t}}}while(0);return 0|(u=7)}function et(t){var e,n,r=0,o=0,a=0,s=0,u=0;o=0|i[(e=(t|=0)+8|0)>>2],a=0|ge(+((3*(r=(0|i[t>>2])-o|0)|0)-(o=(0|i[(n=t+4|0)>>2])-o|0)|0)/7),i[t>>2]=a,r=0|ge(+((o<<1)+r|0)/7),i[n>>2]=r,i[e>>2]=0,o=r-a|0,(0|a)<0?(u=0-a|0,i[n>>2]=o,i[e>>2]=u,i[t>>2]=0,r=o,a=0,o=u):o=0,(0|r)<0&&(a=a-r|0,i[t>>2]=a,o=o-r|0,i[e>>2]=o,i[n>>2]=0,r=0),u=a-o|0,s=r-o|0,(0|o)<0?(i[t>>2]=u,i[n>>2]=s,i[e>>2]=0,r=s,s=u,o=0):s=a,(0|(a=(0|o)<(0|(a=(0|r)<(0|s)?r:s))?o:a))<=0||(i[t>>2]=s-a,i[n>>2]=r-a,i[e>>2]=o-a)}function nt(t){var e,n,r=0,o=0,a=0,s=0,u=0;o=0|i[(e=(t|=0)+8|0)>>2],a=0|ge(+(((r=(0|i[t>>2])-o|0)<<1)+(o=(0|i[(n=t+4|0)>>2])-o|0)|0)/7),i[t>>2]=a,r=0|ge(+((3*o|0)-r|0)/7),i[n>>2]=r,i[e>>2]=0,o=r-a|0,(0|a)<0?(u=0-a|0,i[n>>2]=o,i[e>>2]=u,i[t>>2]=0,r=o,a=0,o=u):o=0,(0|r)<0&&(a=a-r|0,i[t>>2]=a,o=o-r|0,i[e>>2]=o,i[n>>2]=0,r=0),u=a-o|0,s=r-o|0,(0|o)<0?(i[t>>2]=u,i[n>>2]=s,i[e>>2]=0,r=s,s=u,o=0):s=a,(0|(a=(0|o)<(0|(a=(0|r)<(0|s)?r:s))?o:a))<=0||(i[t>>2]=s-a,i[n>>2]=r-a,i[e>>2]=o-a)}function rt(t){var e,n,r,o=0,a=0,s=0,u=0;o=0|i[(t|=0)>>2],a=0|i[(n=t+4|0)>>2],s=0|i[(r=t+8|0)>>2],u=a+(3*o|0)|0,i[t>>2]=u,a=s+(3*a|0)|0,i[n>>2]=a,o=(3*s|0)+o|0,i[r>>2]=o,s=a-u|0,(0|u)<0?(o=o-u|0,i[n>>2]=s,i[r>>2]=o,i[t>>2]=0,a=s,s=0):s=u,(0|a)<0&&(s=s-a|0,i[t>>2]=s,o=o-a|0,i[r>>2]=o,i[n>>2]=0,a=0),e=s-o|0,u=a-o|0,(0|o)<0?(i[t>>2]=e,i[n>>2]=u,i[r>>2]=0,s=e,o=0):u=a,(0|(a=(0|o)<(0|(a=(0|u)<(0|s)?u:s))?o:a))<=0||(i[t>>2]=s-a,i[n>>2]=u-a,i[r>>2]=o-a)}function it(t){var e,n,r,o=0,a=0,s=0,u=0;u=0|i[(t|=0)>>2],s=(3*(o=0|i[(n=t+4|0)>>2])|0)+u|0,u=(a=0|i[(r=t+8|0)>>2])+(3*u|0)|0,i[t>>2]=u,i[n>>2]=s,o=(3*a|0)+o|0,i[r>>2]=o,a=s-u|0,(0|u)<0?(o=o-u|0,i[n>>2]=a,i[r>>2]=o,i[t>>2]=0,u=0):a=s,(0|a)<0&&(u=u-a|0,i[t>>2]=u,o=o-a|0,i[r>>2]=o,i[n>>2]=0,a=0),e=u-o|0,s=a-o|0,(0|o)<0?(i[t>>2]=e,i[n>>2]=s,i[r>>2]=0,u=e,o=0):s=a,(0|(a=(0|o)<(0|(a=(0|s)<(0|u)?s:u))?o:a))<=0||(i[t>>2]=u-a,i[n>>2]=s-a,i[r>>2]=o-a)}function ot(t,e){t|=0;var n,r,o,a=0,s=0,u=0;((e|=0)+-1|0)>>>0>=6||(u=(0|i[15472+(12*e|0)>>2])+(0|i[t>>2])|0,i[t>>2]=u,o=t+4|0,s=(0|i[15472+(12*e|0)+4>>2])+(0|i[o>>2])|0,i[o>>2]=s,r=t+8|0,e=(0|i[15472+(12*e|0)+8>>2])+(0|i[r>>2])|0,i[r>>2]=e,a=s-u|0,(0|u)<0?(e=e-u|0,i[o>>2]=a,i[r>>2]=e,i[t>>2]=0,s=0):(a=s,s=u),(0|a)<0&&(s=s-a|0,i[t>>2]=s,e=e-a|0,i[r>>2]=e,i[o>>2]=0,a=0),n=s-e|0,u=a-e|0,(0|e)<0?(i[t>>2]=n,i[o>>2]=u,i[r>>2]=0,s=n,e=0):u=a,(0|(a=(0|e)<(0|(a=(0|u)<(0|s)?u:s))?e:a))<=0||(i[t>>2]=s-a,i[o>>2]=u-a,i[r>>2]=e-a))}function at(t){var e,n,r,o=0,a=0,s=0,u=0;u=0|i[(t|=0)>>2],s=(o=0|i[(n=t+4|0)>>2])+u|0,u=(a=0|i[(r=t+8|0)>>2])+u|0,i[t>>2]=u,i[n>>2]=s,o=a+o|0,i[r>>2]=o,a=s-u|0,(0|u)<0?(o=o-u|0,i[n>>2]=a,i[r>>2]=o,i[t>>2]=0,s=0):(a=s,s=u),(0|a)<0&&(s=s-a|0,i[t>>2]=s,o=o-a|0,i[r>>2]=o,i[n>>2]=0,a=0),e=s-o|0,u=a-o|0,(0|o)<0?(i[t>>2]=e,i[n>>2]=u,i[r>>2]=0,s=e,o=0):u=a,(0|(a=(0|o)<(0|(a=(0|u)<(0|s)?u:s))?o:a))<=0||(i[t>>2]=s-a,i[n>>2]=u-a,i[r>>2]=o-a)}function st(t){var e,n,r,o=0,a=0,s=0,u=0;o=0|i[(t|=0)>>2],s=0|i[(n=t+4|0)>>2],a=0|i[(r=t+8|0)>>2],u=s+o|0,i[t>>2]=u,s=a+s|0,i[n>>2]=s,o=a+o|0,i[r>>2]=o,a=s-u|0,(0|u)<0?(o=o-u|0,i[n>>2]=a,i[r>>2]=o,i[t>>2]=0,s=0):(a=s,s=u),(0|a)<0&&(s=s-a|0,i[t>>2]=s,o=o-a|0,i[r>>2]=o,i[n>>2]=0,a=0),e=s-o|0,u=a-o|0,(0|o)<0?(i[t>>2]=e,i[n>>2]=u,i[r>>2]=0,s=e,o=0):u=a,(0|(a=(0|o)<(0|(a=(0|u)<(0|s)?u:s))?o:a))<=0||(i[t>>2]=s-a,i[n>>2]=u-a,i[r>>2]=o-a)}function ut(t){switch(0|(t|=0)){case 1:t=5;break;case 5:t=4;break;case 4:t=6;break;case 6:t=2;break;case 2:t=3;break;case 3:t=1}return 0|t}function ct(t){switch(0|(t|=0)){case 1:t=3;break;case 3:t=2;break;case 2:t=6;break;case 6:t=4;break;case 4:t=5;break;case 5:t=1}return 0|t}function lt(t){var e,n,r,o=0,a=0,s=0,u=0;o=0|i[(t|=0)>>2],a=0|i[(n=t+4|0)>>2],s=0|i[(r=t+8|0)>>2],u=a+(o<<1)|0,i[t>>2]=u,a=s+(a<<1)|0,i[n>>2]=a,o=(s<<1)+o|0,i[r>>2]=o,s=a-u|0,(0|u)<0?(o=o-u|0,i[n>>2]=s,i[r>>2]=o,i[t>>2]=0,a=s,s=0):s=u,(0|a)<0&&(s=s-a|0,i[t>>2]=s,o=o-a|0,i[r>>2]=o,i[n>>2]=0,a=0),e=s-o|0,u=a-o|0,(0|o)<0?(i[t>>2]=e,i[n>>2]=u,i[r>>2]=0,s=e,o=0):u=a,(0|(a=(0|o)<(0|(a=(0|u)<(0|s)?u:s))?o:a))<=0||(i[t>>2]=s-a,i[n>>2]=u-a,i[r>>2]=o-a)}function ht(t){var e,n,r,o=0,a=0,s=0,u=0;u=0|i[(t|=0)>>2],s=((o=0|i[(n=t+4|0)>>2])<<1)+u|0,u=(a=0|i[(r=t+8|0)>>2])+(u<<1)|0,i[t>>2]=u,i[n>>2]=s,o=(a<<1)+o|0,i[r>>2]=o,a=s-u|0,(0|u)<0?(o=o-u|0,i[n>>2]=a,i[r>>2]=o,i[t>>2]=0,u=0):a=s,(0|a)<0&&(u=u-a|0,i[t>>2]=u,o=o-a|0,i[r>>2]=o,i[n>>2]=0,a=0),e=u-o|0,s=a-o|0,(0|o)<0?(i[t>>2]=e,i[n>>2]=s,i[r>>2]=0,u=e,o=0):s=a,(0|(a=(0|o)<(0|(a=(0|s)<(0|u)?s:u))?o:a))<=0||(i[t>>2]=u-a,i[n>>2]=s-a,i[r>>2]=o-a)}function ft(t,e){e|=0;var n,r,o,a=0,s=0,u=0;return o=(0|(r=(0|i[(t|=0)>>2])-(0|i[e>>2])|0))<0,n=(0|(s=(0|i[t+4>>2])-(0|i[e+4>>2])-(o?r:0)|0))<0,e=(e=(t=(0|(u=(o?0-r|0:0)+(0|i[t+8>>2])-(0|i[e+8>>2])+(n?0-s|0:0)|0))<0)?0:u)-((s=(0|(t=(0|e)<(0|(t=(0|(a=(n?0:s)-(t?u:0)|0))<(0|(u=(o?0:r)-(n?s:0)-(t?u:0)|0))?a:u))?e:t))>0)?t:0)|0,a=a-(s?t:0)|0,0|((0|(t=(0|(t=u-(s?t:0)|0))>-1?t:0-t|0))>(0|(e=(0|(a=(0|a)>-1?a:0-a|0))>(0|(e=(0|e)>-1?e:0-e|0))?a:e))?t:e)}function pt(t,e){e|=0;var n;n=0|i[(t|=0)+8>>2],i[e>>2]=(0|i[t>>2])-n,i[e+4>>2]=(0|i[t+4>>2])-n}function dt(t,e){e|=0;var n,r,o,a=0,s=0,u=0;s=0|i[(t|=0)>>2],i[e>>2]=s,t=0|i[t+4>>2],i[(r=e+4|0)>>2]=t,i[(o=e+8|0)>>2]=0,a=t-s|0,(0|s)<0?(t=0-s|0,i[r>>2]=a,i[o>>2]=t,i[e>>2]=0,s=0):(a=t,t=0),(0|a)<0&&(s=s-a|0,i[e>>2]=s,t=t-a|0,i[o>>2]=t,i[r>>2]=0,a=0),n=s-t|0,u=a-t|0,(0|t)<0?(i[e>>2]=n,i[r>>2]=u,i[o>>2]=0,a=u,u=n,t=0):u=s,(0|(s=(0|t)<(0|(s=(0|a)<(0|u)?a:u))?t:s))<=0||(i[e>>2]=u-s,i[r>>2]=a-s,i[o>>2]=t-s)}function At(t){var e,n,r,o;n=(o=0|i[(e=(t|=0)+8|0)>>2])-(0|i[t>>2])|0,i[t>>2]=n,t=(0|i[(r=t+4|0)>>2])-o|0,i[r>>2]=t,i[e>>2]=0-(t+n)}function gt(t){var e,n,r=0,o=0,a=0,s=0,u=0;r=0-(o=0|i[(t|=0)>>2])|0,i[t>>2]=r,i[(e=t+8|0)>>2]=0,s=(a=0|i[(n=t+4|0)>>2])+o|0,(0|o)>0?(i[n>>2]=s,i[e>>2]=o,i[t>>2]=0,r=0,a=s):o=0,(0|a)<0?(u=r-a|0,i[t>>2]=u,o=o-a|0,i[e>>2]=o,i[n>>2]=0,s=u-o|0,r=0-o|0,(0|o)<0?(i[t>>2]=s,i[n>>2]=r,i[e>>2]=0,a=r,o=0):(a=0,s=u)):s=r,(0|(r=(0|o)<(0|(r=(0|a)<(0|s)?a:s))?o:r))<=0||(i[t>>2]=s-r,i[n>>2]=a-r,i[e>>2]=o-r)}function mt(t,e,n,r){e|=0,n|=0,r|=0;var a,s=0,u=0,c=0,l=0;if(a=M,M=M+32|0,function(t,e){e|=0;var n,r,i=0;i=+o[(t=t|0)>>3],n=+h(+i),i=+f(+i),o[e+16>>3]=i,i=+o[t+8>>3],r=n*+h(+i),o[e>>3]=r,i=n*+f(+i),o[e+8>>3]=i}(t|=0,u=a),i[n>>2]=0,s=+ue(15888,u),(c=+ue(15912,u))<s&&(i[n>>2]=1,s=c),(c=+ue(15936,u))<s&&(i[n>>2]=2,s=c),(c=+ue(15960,u))<s&&(i[n>>2]=3,s=c),(c=+ue(15984,u))<s&&(i[n>>2]=4,s=c),(c=+ue(16008,u))<s&&(i[n>>2]=5,s=c),(c=+ue(16032,u))<s&&(i[n>>2]=6,s=c),(c=+ue(16056,u))<s&&(i[n>>2]=7,s=c),(c=+ue(16080,u))<s&&(i[n>>2]=8,s=c),(c=+ue(16104,u))<s&&(i[n>>2]=9,s=c),(c=+ue(16128,u))<s&&(i[n>>2]=10,s=c),(c=+ue(16152,u))<s&&(i[n>>2]=11,s=c),(c=+ue(16176,u))<s&&(i[n>>2]=12,s=c),(c=+ue(16200,u))<s&&(i[n>>2]=13,s=c),(c=+ue(16224,u))<s&&(i[n>>2]=14,s=c),(c=+ue(16248,u))<s&&(i[n>>2]=15,s=c),(c=+ue(16272,u))<s&&(i[n>>2]=16,s=c),(c=+ue(16296,u))<s&&(i[n>>2]=17,s=c),(c=+ue(16320,u))<s&&(i[n>>2]=18,s=c),(c=+ue(16344,u))<s&&(i[n>>2]=19,s=c),(c=+d(+(1-.5*s)))<1e-16)return i[r>>2]=0,i[r+4>>2]=0,i[r+8>>2]=0,i[r+12>>2]=0,void(M=a);if(n=0|i[n>>2],s=+St((s=+o[16368+(24*n|0)>>3])-+St(+function(t,e){t|=0;var n,r,i,a,s;return a=+o[(e=e|0)>>3],r=+h(+a),i=+o[e+8>>3]-+o[t+8>>3],s=r*+f(+i),n=+o[t>>3],+ +m(+s,+(+f(+a)*+h(+n)-+h(+i)*(r*+f(+n))))}(15568+(n<<4)|0,t))),l=0|Ut(e)?+St(s+-.3334731722518321):s,s=+p(+c)/.381966011250105,(0|e)>0){u=0;do{s*=2.6457513110645907,u=u+1|0}while((0|u)!=(0|e))}c=+h(+l)*s,o[r>>3]=c,l=+f(+l)*s,o[r+8>>3]=l,M=a}function yt(t,e,n,r,a){e|=0,n|=0,r|=0,a|=0;var s=0,l=0;if((s=+function(t){var e,n;return n=+o[(t=t|0)>>3],e=+o[t+8>>3],+ +c(+(n*n+e*e))}(t|=0))<1e-16)return e=15568+(e<<4)|0,i[a>>2]=i[e>>2],i[a+4>>2]=i[e+4>>2],i[a+8>>2]=i[e+8>>2],void(i[a+12>>2]=i[e+12>>2]);if(l=+m(+ +o[t+8>>3],+ +o[t>>3]),(0|n)>0){t=0;do{s/=2.6457513110645907,t=t+1|0}while((0|t)!=(0|n))}r?(s/=3,n=0==(0|Ut(n)),s=+g(.381966011250105*(n?s:s/2.6457513110645907))):(s=+g(.381966011250105*s),0|Ut(n)&&(l=+St(l+.3334731722518321))),function(t,e,n,r){t|=0,e=+e,r|=0;var a=0,s=0,c=0,l=0;if((n=+n)<1e-16)return i[r>>2]=i[t>>2],i[r+4>>2]=i[t+4>>2],i[r+8>>2]=i[t+8>>2],void(i[r+12>>2]=i[t+12>>2]);s=e<0?e+6.283185307179586:e,s=e>=6.283185307179586?s+-6.283185307179586:s;do{if(!(s<1e-16)){if(a=+u(+(s+-3.141592653589793))<1e-16,e=+o[t>>3],a){e-=n,o[r>>3]=e,a=r;break}if(c=+h(+n),n=+f(+n),e=c*+f(+e)+ +h(+s)*(n*+h(+e)),e=+A(+((e=e>1?1:e)<-1?-1:e)),o[r>>3]=e,+u(+(e+-1.5707963267948966))<1e-16)return o[r>>3]=1.5707963267948966,void(o[r+8>>3]=0);if(+u(+(e+1.5707963267948966))<1e-16)return o[r>>3]=-1.5707963267948966,void(o[r+8>>3]=0);if(l=+h(+e),s=n*+f(+s)/l,n=+o[t>>3],e=(c-+f(+e)*+f(+n))/+h(+n)/l,c=s>1?1:s,e=e>1?1:e,(e=+o[t+8>>3]+ +m(+(c<-1?-1:c),+(e<-1?-1:e)))>3.141592653589793)do{e+=-6.283185307179586}while(e>3.141592653589793);if(e<-3.141592653589793)do{e+=6.283185307179586}while(e<-3.141592653589793);return void(o[r+8>>3]=e)}e=+o[t>>3]+n,o[r>>3]=e,a=r}while(0);if(+u(+(e+-1.5707963267948966))<1e-16)return o[a>>3]=1.5707963267948966,void(o[r+8>>3]=0);if(+u(+(e+1.5707963267948966))<1e-16)return o[a>>3]=-1.5707963267948966,void(o[r+8>>3]=0);if((e=+o[t+8>>3])>3.141592653589793)do{e+=-6.283185307179586}while(e>3.141592653589793);if(e<-3.141592653589793)do{e+=6.283185307179586}while(e<-3.141592653589793);o[r+8>>3]=e}(15568+(e<<4)|0,+St(+o[16368+(24*e|0)>>3]-l),s,a)}function vt(t,e,n){e|=0,n|=0;var r,o;r=M,M=M+16|0,Q((t|=0)+4|0,o=r),yt(o,0|i[t>>2],e,0,n),M=r}function _t(t,e,n,r,a){t|=0,e|=0,n|=0,r|=0,a|=0;var s,u,c,l,h,f,p,d,A,g,m,y,v,_,b,x,w,O,S,T,C,P,I=0,B=0,R=0,k=0,D=0,L=0;if(P=M,M=M+272|0,k=P+240|0,S=P,T=P+224|0,C=P+208|0,m=P+176|0,y=P+160|0,v=P+192|0,_=P+144|0,b=P+128|0,x=P+112|0,w=P+96|0,O=P+80|0,i[(I=P+256|0)>>2]=e,i[k>>2]=i[t>>2],i[k+4>>2]=i[t+4>>2],i[k+8>>2]=i[t+8>>2],i[k+12>>2]=i[t+12>>2],bt(k,I,S),i[a>>2]=0,(0|(k=r+n+(5==(0|r)&1)|0))<=(0|n))M=P;else{u=T+4|0,c=m+4|0,l=n+5|0,h=16848+((s=0|i[I>>2])<<2)|0,f=16928+(s<<2)|0,p=b+8|0,d=x+8|0,A=w+8|0,g=C+4|0,R=n;t:for(;;){B=S+(((0|R)%5|0)<<4)|0,i[C>>2]=i[B>>2],i[C+4>>2]=i[B+4>>2],i[C+8>>2]=i[B+8>>2],i[C+12>>2]=i[B+12>>2];do{}while(2==(0|xt(C,s,0,1)));if((0|R)>(0|n)&0!=(0|Ut(e))){if(i[m>>2]=i[C>>2],i[m+4>>2]=i[C+4>>2],i[m+8>>2]=i[C+8>>2],i[m+12>>2]=i[C+12>>2],Q(u,y),r=0|i[m>>2],I=0|i[17008+(80*r|0)+(i[T>>2]<<2)>>2],i[m>>2]=i[18608+(80*r|0)+(20*I|0)>>2],(0|(B=0|i[18608+(80*r|0)+(20*I|0)+16>>2]))>0){t=0;do{at(c),t=t+1|0}while((0|t)<(0|B))}switch(B=18608+(80*r|0)+(20*I|0)+4|0,i[v>>2]=i[B>>2],i[v+4>>2]=i[B+4>>2],i[v+8>>2]=i[B+8>>2],$(v,3*(0|i[h>>2])|0),K(c,v,c),J(c),Q(c,_),D=+(0|i[f>>2]),o[b>>3]=3*D,o[p>>3]=0,L=-1.5*D,o[x>>3]=L,o[d>>3]=2.598076211353316*D,o[w>>3]=L,o[A>>3]=-2.598076211353316*D,0|i[17008+(80*(0|i[m>>2])|0)+(i[C>>2]<<2)>>2]){case 1:t=x,r=b;break;case 3:t=w,r=x;break;case 2:t=b,r=w;break;default:t=12;break t}ae(y,_,r,t,O),yt(O,0|i[m>>2],s,1,a+8+(i[a>>2]<<4)|0),i[a>>2]=1+(0|i[a>>2])}if((0|R)<(0|l)&&(Q(g,m),yt(m,0|i[C>>2],s,1,a+8+(i[a>>2]<<4)|0),i[a>>2]=1+(0|i[a>>2])),i[T>>2]=i[C>>2],i[T+4>>2]=i[C+4>>2],i[T+8>>2]=i[C+8>>2],i[T+12>>2]=i[C+12>>2],(0|(R=R+1|0))>=(0|k)){t=3;break}}3!=(0|t)?12==(0|t)&&E(22474,22521,581,22531):M=P}}function bt(t,e,n){t|=0,e|=0,n|=0;var r,o=0,a=0,s=0,u=0,c=0;r=M,M=M+128|0,a=r,u=20208,c=(s=o=r+64|0)+60|0;do{i[s>>2]=i[u>>2],s=s+4|0,u=u+4|0}while((0|s)<(0|c));u=20272,c=(s=a)+60|0;do{i[s>>2]=i[u>>2],s=s+4|0,u=u+4|0}while((0|s)<(0|c));o=(c=0==(0|Ut(0|i[e>>2])))?o:a,lt(a=t+4|0),ht(a),0|Ut(0|i[e>>2])&&(it(a),i[e>>2]=1+(0|i[e>>2])),i[n>>2]=i[t>>2],K(a,o,e=n+4|0),J(e),i[n+16>>2]=i[t>>2],K(a,o+12|0,e=n+20|0),J(e),i[n+32>>2]=i[t>>2],K(a,o+24|0,e=n+36|0),J(e),i[n+48>>2]=i[t>>2],K(a,o+36|0,e=n+52|0),J(e),i[n+64>>2]=i[t>>2],K(a,o+48|0,n=n+68|0),J(n),M=r}function xt(t,e,n,r){n|=0,r|=0;var o,a,s,u,c,l,h=0,f=0,p=0,d=0,A=0;if(l=M,M=M+32|0,c=l+12|0,a=l,A=(t|=0)+4|0,d=0|i[16928+((e|=0)<<2)>>2],d=(u=0!=(0|r))?3*d|0:d,h=0|i[A>>2],o=0|i[(s=t+8|0)>>2],u){if((0|(h=o+h+(r=0|i[(f=t+12|0)>>2])|0))==(0|d))return M=l,0|(A=1);p=f}else h=o+h+(r=0|i[(p=t+12|0)>>2])|0;if((0|h)<=(0|d))return M=l,0|(A=0);do{if((0|r)>0){if(r=0|i[t>>2],(0|o)>0){f=18608+(80*r|0)+60|0,r=t;break}r=18608+(80*r|0)+40|0,n?(X(c,d,0,0),Y(A,c,a),st(a),K(a,c,A),f=r,r=t):(f=r,r=t)}else f=18608+(80*(0|i[t>>2])|0)+20|0,r=t}while(0);if(i[r>>2]=i[f>>2],(0|i[(h=f+16|0)>>2])>0){r=0;do{at(A),r=r+1|0}while((0|r)<(0|i[h>>2]))}return t=f+4|0,i[c>>2]=i[t>>2],i[c+4>>2]=i[t+4>>2],i[c+8>>2]=i[t+8>>2],e=0|i[16848+(e<<2)>>2],$(c,u?3*e|0:e),K(A,c,A),J(A),r=u&&((0|i[s>>2])+(0|i[A>>2])+(0|i[p>>2])|0)==(0|d)?1:2,M=l,0|(A=r)}function wt(t,e){t|=0,e|=0;var n=0;do{n=0|xt(t,e,0,1)}while(2==(0|n));return 0|n}function Et(t,e,n,r,a){t|=0,e|=0,n|=0,r|=0,a|=0;var s,u,c,l,h,f,p,d,A,g,m,y,v,_,b,x,w,O,S=0,T=0,C=0,P=0,I=0;if(O=M,M=M+240|0,_=O+208|0,b=O,x=O+192|0,w=O+176|0,A=O+160|0,g=O+144|0,m=O+128|0,y=O+112|0,v=O+96|0,i[(S=O+224|0)>>2]=e,i[_>>2]=i[t>>2],i[_+4>>2]=i[t+4>>2],i[_+8>>2]=i[t+8>>2],i[_+12>>2]=i[t+12>>2],Ot(_,S,b),i[a>>2]=0,(0|(d=r+n+(6==(0|r)&1)|0))<=(0|n))M=O;else{u=n+6|0,c=16928+((s=0|i[S>>2])<<2)|0,l=g+8|0,h=m+8|0,f=y+8|0,p=x+4|0,T=0,C=n,r=-1;t:for(;;){if(t=b+((S=(0|C)%6|0)<<4)|0,i[x>>2]=i[t>>2],i[x+4>>2]=i[t+4>>2],i[x+8>>2]=i[t+8>>2],i[x+12>>2]=i[t+12>>2],t=T,T=0|xt(x,s,0,1),(0|C)>(0|n)&0!=(0|Ut(e))&&(1!=(0|t)&&(0|i[x>>2])!=(0|r))){switch(Q(b+(((S+5|0)%6|0)<<4)+4|0,w),Q(b+(S<<4)+4|0,A),P=+(0|i[c>>2]),o[g>>3]=3*P,o[l>>3]=0,I=-1.5*P,o[m>>3]=I,o[h>>3]=2.598076211353316*P,o[y>>3]=I,o[f>>3]=-2.598076211353316*P,S=0|i[_>>2],0|i[17008+(80*S|0)+(((0|r)==(0|S)?0|i[x>>2]:r)<<2)>>2]){case 1:t=m,r=g;break;case 3:t=y,r=m;break;case 2:t=g,r=y;break;default:t=8;break t}ae(w,A,r,t,v),0|se(w,v)||0|se(A,v)||(yt(v,0|i[_>>2],s,1,a+8+(i[a>>2]<<4)|0),i[a>>2]=1+(0|i[a>>2]))}if((0|C)<(0|u)&&(Q(p,w),yt(w,0|i[x>>2],s,1,a+8+(i[a>>2]<<4)|0),i[a>>2]=1+(0|i[a>>2])),(0|(C=C+1|0))>=(0|d)){t=3;break}r=0|i[x>>2]}3!=(0|t)?8==(0|t)&&E(22557,22521,746,22602):M=O}}function Ot(t,e,n){t|=0,e|=0,n|=0;var r,o=0,a=0,s=0,u=0,c=0;r=M,M=M+160|0,a=r,u=20336,c=(s=o=r+80|0)+72|0;do{i[s>>2]=i[u>>2],s=s+4|0,u=u+4|0}while((0|s)<(0|c));u=20416,c=(s=a)+72|0;do{i[s>>2]=i[u>>2],s=s+4|0,u=u+4|0}while((0|s)<(0|c));o=(c=0==(0|Ut(0|i[e>>2])))?o:a,lt(a=t+4|0),ht(a),0|Ut(0|i[e>>2])&&(it(a),i[e>>2]=1+(0|i[e>>2])),i[n>>2]=i[t>>2],K(a,o,e=n+4|0),J(e),i[n+16>>2]=i[t>>2],K(a,o+12|0,e=n+20|0),J(e),i[n+32>>2]=i[t>>2],K(a,o+24|0,e=n+36|0),J(e),i[n+48>>2]=i[t>>2],K(a,o+36|0,e=n+52|0),J(e),i[n+64>>2]=i[t>>2],K(a,o+48|0,e=n+68|0),J(e),i[n+80>>2]=i[t>>2],K(a,o+60|0,n=n+84|0),J(n),M=r}function St(t){var e;return e=(t=+t)<0?t+6.283185307179586:t,+(t>=6.283185307179586?e+-6.283185307179586:e)}function Tt(t,e){return e|=0,+u(+(+o[(t|=0)>>3]-+o[e>>3]))<17453292519943298e-27?0|(e=+u(+(+o[t+8>>3]-+o[e+8>>3]))<17453292519943298e-27):0|(e=0)}function Ct(t,e){t|=0;var n,r,i,a=0;return r=+o[(e|=0)>>3],n=+o[t>>3],a=(i=+f(.5*(r-n)))*i+(a=+f(.5*(+o[e+8>>3]-+o[t+8>>3])))*(+h(+r)*+h(+n)*a),2*+m(+ +c(+a),+ +c(+(1-a)))*6371.007180918475}function Pt(t,e,n){t|=0,n|=0;var r,i,a,s,u=0,l=0,d=0,A=0,y=0,v=0;return v=+o[(e|=0)>>3],a=+o[t>>3],y=+f(.5*(v-a)),d=+o[e+8>>3],i=+o[t+8>>3],A=+f(.5*(d-i)),r=+h(+a),s=+h(+v),A=2*+m(+ +c(+(A=y*y+A*(s*r*A))),+ +c(+(1-A))),y=+o[n>>3],v=+f(.5*(y-v)),u=+o[n+8>>3],d=+f(.5*(u-d)),l=+h(+y),d=2*+m(+ +c(+(d=v*v+d*(s*l*d))),+ +c(+(1-d))),y=+f(.5*(a-y)),u=+f(.5*(i-u)),u=2*+m(+ +c(+(u=y*y+u*(r*l*u))),+ +c(+(1-u))),4*+g(+ +c(+ +p(.5*(l=.5*(A+d+u)))*+p(.5*(l-A))*+p(.5*(l-d))*+p(.5*(l-u))))}function Mt(t,e){return e=0|Ee(0|(t|=0),0|(e|=0),45),w(),127&e|0}function It(t,e){var n=0,r=0,i=0,o=0,a=0,s=0;if(!(!0&134217728==(-16777216&(e|=0)|0)))return 0|(e=0);if(a=0|Ee(0|(t|=0),0|e,45),w(),(a&=127)>>>0>121)return 0|(e=0);n=0|Ee(0|t,0|e,52),w(),n&=15;do{if(0|n){for(i=1,r=0;;){if(o=0|Ee(0|t,0|e,3*(15-i|0)|0),w(),0!=(0|(o&=7))&(1^r)){if(1==(0|o)&0!=(0|L(a))){s=0,r=13;break}r=1}if(7==(0|o)){s=0,r=13;break}if(!(i>>>0<n>>>0)){r=9;break}i=i+1|0}if(9==(0|r)){if(15!=(0|n))break;return 0|(s=1)}if(13==(0|r))return 0|s}}while(0);for(;;){if(s=0|Ee(0|t,0|e,3*(14-n|0)|0),w(),!(7==(7&s|0)&!0)){s=0,r=13;break}if(!(n>>>0<14)){s=1,r=13;break}n=n+1|0}return 13==(0|r)?0|s:0}function Bt(t,e,n){n|=0;var r=0,i=0;if(r=0|Ee(0|(t|=0),0|(e|=0),52),w(),(0|(r&=15))>=(0|n)){if((0|r)!=(0|n))if(n>>>0<=15){if(t|=i=0|Oe(0|n,0,52),e=0|w()|-15728641&e,(0|r)>(0|n))do{i=0|Oe(7,0,3*(14-n|0)|0),n=n+1|0,t|=i,e=0|w()|e}while((0|n)<(0|r))}else e=0,t=0}else e=0,t=0;return x(0|e),0|t}function Rt(t,e,n,r){n|=0,r|=0;var o,a=0,s=0,u=0,c=0,l=0,h=0;if(u=0|Ee(0|(t|=0),0|(e|=0),52),w(),(0|n)<16&(0|(u&=15))<=(0|n)){if((0|u)==(0|n))return i[(n=r)>>2]=t,void(i[n+4>>2]=e);if(o=(0|(l=0|ee(7,n-u|0)))/7|0,c=0|Ee(0|t,0|e,45),w(),0|L(127&c)){t:do{if(u)for(s=1;;){if(a=0|Ee(0|t,0|e,3*(15-s|0)|0),w(),0|(a&=7))break t;if(!(s>>>0<u>>>0)){a=0;break}s=s+1|0}else a=0}while(0);s=0==(0|a)}else s=0;if(h=0|Oe(u+1|0,0,52),a=0|w()|-15728641&e,Rt(e=(h|t)&~(e=0|Oe(7,0,0|(c=3*(14-u|0)|0))),u=a&~(0|w()),n,r),a=r+(o<<3)|0,!s)return Rt((h=0|Oe(1,0,0|c))|e,0|w()|u,n,a),h=a+(o<<3)|0,Rt((l=0|Oe(2,0,0|c))|e,0|w()|u,n,h),h=h+(o<<3)|0,Rt((l=0|Oe(3,0,0|c))|e,0|w()|u,n,h),h=h+(o<<3)|0,Rt((l=0|Oe(4,0,0|c))|e,0|w()|u,n,h),h=h+(o<<3)|0,Rt((l=0|Oe(5,0,0|c))|e,0|w()|u,n,h),void Rt((l=0|Oe(6,0,0|c))|e,0|w()|u,n,h+(o<<3)|0);s=a+(o<<3)|0,(0|l)>6&&(Pe(0|a,0,(h=(s>>>0>(l=a+8|0)>>>0?s:l)+-1+(0-a)|0)+8&-8|0),a=l+(h>>>3<<3)|0),Rt((h=0|Oe(2,0,0|c))|e,0|w()|u,n,a),h=a+(o<<3)|0,Rt((l=0|Oe(3,0,0|c))|e,0|w()|u,n,h),h=h+(o<<3)|0,Rt((l=0|Oe(4,0,0|c))|e,0|w()|u,n,h),h=h+(o<<3)|0,Rt((l=0|Oe(5,0,0|c))|e,0|w()|u,n,h),Rt((l=0|Oe(6,0,0|c))|e,0|w()|u,n,h+(o<<3)|0)}}function kt(t,e){var n=0,r=0,i=0;if(i=0|Ee(0|(t|=0),0|(e|=0),45),w(),!(0|L(127&i)))return 0|(i=0);i=0|Ee(0|t,0|e,52),w(),i&=15;t:do{if(i)for(r=1;;){if(n=0|Ee(0|t,0|e,3*(15-r|0)|0),w(),0|(n&=7))break t;if(!(r>>>0<i>>>0)){n=0;break}r=r+1|0}else n=0}while(0);return 0|(i=0==(0|n)&1)}function Dt(t,e){var n=0,r=0,i=0;if(i=0|Ee(0|(t|=0),0|(e|=0),52),w(),!(i&=15))return 0|(i=0);for(r=1;;){if(n=0|Ee(0|t,0|e,3*(15-r|0)|0),w(),0|(n&=7)){r=5;break}if(!(r>>>0<i>>>0)){n=0,r=5;break}r=r+1|0}return 5==(0|r)?0|n:0}function Lt(t,e){var n=0,r=0,i=0,o=0,a=0,s=0,u=0;if(u=0|Ee(0|(t|=0),0|(e|=0),52),w(),!(u&=15))return u=t,x(0|(s=e)),0|u;for(s=1,n=0;;){r=0|Oe(7,0,0|(o=3*(15-s|0)|0)),i=0|w(),a=0|Ee(0|t,0|e,0|o),w(),t=(o=0|Oe(0|ut(7&a),0,0|o))|t&~r,e=(a=0|w())|e&~i;t:do{if(!n)if(0==(o&r|0)&0==(a&i|0))n=0;else if(r=0|Ee(0|t,0|e,52),w(),r&=15){n=1;e:for(;;){switch(a=0|Ee(0|t,0|e,3*(15-n|0)|0),w(),7&a){case 1:break e;case 0:break;default:n=1;break t}if(!(n>>>0<r>>>0)){n=1;break t}n=n+1|0}for(n=1;;){if(i=0|Ee(0|t,0|e,0|(a=3*(15-n|0)|0)),w(),o=0|Oe(7,0,0|a),e&=~(0|w()),t=t&~o|(a=0|Oe(0|ut(7&i),0,0|a)),e=0|e|w(),!(n>>>0<r>>>0)){n=1;break}n=n+1|0}}else n=1}while(0);if(!(s>>>0<u>>>0))break;s=s+1|0}return x(0|e),0|t}function jt(t,e){var n=0,r=0,i=0,o=0,a=0;if(r=0|Ee(0|(t|=0),0|(e|=0),52),w(),!(r&=15))return r=t,x(0|(n=e)),0|r;for(n=1;a=0|Ee(0|t,0|e,0|(o=3*(15-n|0)|0)),w(),i=0|Oe(7,0,0|o),e&=~(0|w()),t=(o=0|Oe(0|ut(7&a),0,0|o))|t&~i,e=0|w()|e,n>>>0<r>>>0;)n=n+1|0;return x(0|e),0|t}function Ft(t,e){var n=0,r=0,i=0,o=0,a=0,s=0,u=0;if(u=0|Ee(0|(t|=0),0|(e|=0),52),w(),!(u&=15))return u=t,x(0|(s=e)),0|u;for(s=1,n=0;;){r=0|Oe(7,0,0|(o=3*(15-s|0)|0)),i=0|w(),a=0|Ee(0|t,0|e,0|o),w(),t=(o=0|Oe(0|ct(7&a),0,0|o))|t&~r,e=(a=0|w())|e&~i;t:do{if(!n)if(0==(o&r|0)&0==(a&i|0))n=0;else if(r=0|Ee(0|t,0|e,52),w(),r&=15){n=1;e:for(;;){switch(a=0|Ee(0|t,0|e,3*(15-n|0)|0),w(),7&a){case 1:break e;case 0:break;default:n=1;break t}if(!(n>>>0<r>>>0)){n=1;break t}n=n+1|0}for(n=1;;){if(o=0|Oe(7,0,0|(i=3*(15-n|0)|0)),a=e&~(0|w()),e=0|Ee(0|t,0|e,0|i),w(),t=t&~o|(e=0|Oe(0|ct(7&e),0,0|i)),e=0|a|w(),!(n>>>0<r>>>0)){n=1;break}n=n+1|0}}else n=1}while(0);if(!(s>>>0<u>>>0))break;s=s+1|0}return x(0|e),0|t}function zt(t,e){var n=0,r=0,i=0,o=0,a=0;if(r=0|Ee(0|(t|=0),0|(e|=0),52),w(),!(r&=15))return r=t,x(0|(n=e)),0|r;for(n=1;o=0|Oe(7,0,0|(a=3*(15-n|0)|0)),i=e&~(0|w()),e=0|Ee(0|t,0|e,0|a),w(),t=(e=0|Oe(0|ct(7&e),0,0|a))|t&~o,e=0|w()|i,n>>>0<r>>>0;)n=n+1|0;return x(0|e),0|t}function Ut(t){return 0|(0|(t|=0))%2}function Nt(t,e){t|=0;var n,r;return r=M,M=M+16|0,n=r,(e|=0)>>>0<=15&&2146435072!=(2146435072&i[t+4>>2]|0)&&2146435072!=(2146435072&i[t+8+4>>2]|0)?(!function(t,e,n){var r,i;r=M,M=M+16|0,mt(t|=0,e|=0,n|=0,i=r),Z(i,n+4|0),M=r}(t,e,n),e=0|function(t,e){t|=0;var n,r=0,o=0,a=0,s=0,u=0,c=0,l=0,h=0;if(n=M,M=M+64|0,c=n+40|0,o=n+24|0,a=n+12|0,s=n,Oe(0|(e|=0),0,52),r=134225919|w(),!e)return(0|i[t+4>>2])>2||(0|i[t+8>>2])>2||(0|i[t+12>>2])>2?(c=0,x(0|(u=0)),M=n,0|c):(Oe(0|F(t),0,45),u=0|w()|r,c=-1,x(0|u),M=n,0|c);if(i[c>>2]=i[t>>2],i[c+4>>2]=i[t+4>>2],i[c+8>>2]=i[t+8>>2],i[c+12>>2]=i[t+12>>2],u=c+4|0,(0|e)>0)for(t=-1;i[o>>2]=i[u>>2],i[o+4>>2]=i[u+4>>2],i[o+8>>2]=i[u+8>>2],1&e?(et(u),i[a>>2]=i[u>>2],i[a+4>>2]=i[u+4>>2],i[a+8>>2]=i[u+8>>2],rt(a)):(nt(u),i[a>>2]=i[u>>2],i[a+4>>2]=i[u+4>>2],i[a+8>>2]=i[u+8>>2],it(a)),Y(o,a,s),J(s),l=0|Oe(7,0,0|(h=3*(15-e|0)|0)),r&=~(0|w()),t=(h=0|Oe(0|tt(s),0,0|h))|t&~l,r=0|w()|r,(0|e)>1;)e=e+-1|0;else t=-1;t:do{if((0|i[u>>2])<=2&&(0|i[c+8>>2])<=2&&(0|i[c+12>>2])<=2){if(e=0|Oe(0|(o=0|F(c)),0,45),e|=t,t=0|w()|-1040385&r,s=0|z(c),!(0|L(o))){if((0|s)<=0)break;for(a=0;;){if(o=0|Ee(0|e,0|t,52),w(),o&=15)for(r=1;c=0|Ee(0|e,0|t,0|(h=3*(15-r|0)|0)),w(),l=0|Oe(7,0,0|h),t&=~(0|w()),e=e&~l|(h=0|Oe(0|ut(7&c),0,0|h)),t=0|t|w(),r>>>0<o>>>0;)r=r+1|0;if((0|(a=a+1|0))==(0|s))break t}}a=0|Ee(0|e,0|t,52),w(),a&=15;e:do{if(a){r=1;n:for(;;){switch(h=0|Ee(0|e,0|t,3*(15-r|0)|0),w(),7&h){case 1:break n;case 0:break;default:break e}if(!(r>>>0<a>>>0))break e;r=r+1|0}if(0|U(o,0|i[c>>2]))for(r=1;l=0|Oe(7,0,0|(c=3*(15-r|0)|0)),h=t&~(0|w()),t=0|Ee(0|e,0|t,0|c),w(),e=e&~l|(t=0|Oe(0|ct(7&t),0,0|c)),t=0|h|w(),r>>>0<a>>>0;)r=r+1|0;else for(r=1;c=0|Ee(0|e,0|t,0|(h=3*(15-r|0)|0)),w(),l=0|Oe(7,0,0|h),t&=~(0|w()),e=e&~l|(h=0|Oe(0|ut(7&c),0,0|h)),t=0|t|w(),r>>>0<a>>>0;)r=r+1|0}}while(0);if((0|s)>0){r=0;do{e=0|Lt(e,t),t=0|w(),r=r+1|0}while((0|r)!=(0|s))}}else e=0,t=0}while(0);return h=e,x(0|(l=t)),M=n,0|h}(n,e),t=0|w()):(t=0,e=0),x(0|t),M=r,0|e}function Gt(t,e,n){var r,o=0,a=0,s=0;if(r=(n|=0)+4|0,a=0|Ee(0|(t|=0),0|(e|=0),52),w(),a&=15,s=0|Ee(0|t,0|e,45),w(),o=0==(0|a),0|L(127&s)){if(o)return 0|(s=1);o=1}else{if(o)return 0|(s=0);o=0==(0|i[r>>2])&&0==(0|i[n+8>>2])?0!=(0|i[n+12>>2])&1:1}for(n=1;1&n?rt(r):it(r),s=0|Ee(0|t,0|e,3*(15-n|0)|0),w(),ot(r,7&s),n>>>0<a>>>0;)n=n+1|0;return 0|o}function Vt(t,e,n){n|=0;var r,o,a=0,s=0,u=0,c=0,l=0,h=0;o=M,M=M+16|0,r=o,h=0|Ee(0|(t|=0),0|(e|=0),45),w(),h&=127;t:do{if(0!=(0|L(h))&&(u=0|Ee(0|t,0|e,52),w(),0!=(0|(u&=15)))){a=1;e:for(;;){switch(l=0|Ee(0|t,0|e,3*(15-a|0)|0),w(),7&l){case 5:break e;case 0:break;default:a=e;break t}if(!(a>>>0<u>>>0)){a=e;break t}a=a+1|0}for(s=1,a=e;c=0|Oe(7,0,0|(e=3*(15-s|0)|0)),l=a&~(0|w()),a=0|Ee(0|t,0|a,0|e),w(),t=t&~c|(a=0|Oe(0|ct(7&a),0,0|e)),a=0|l|w(),s>>>0<u>>>0;)s=s+1|0}else a=e}while(0);if(l=7728+(28*h|0)|0,i[n>>2]=i[l>>2],i[n+4>>2]=i[l+4>>2],i[n+8>>2]=i[l+8>>2],i[n+12>>2]=i[l+12>>2],0|Gt(t,a,n)){if(c=n+4|0,i[r>>2]=i[c>>2],i[r+4>>2]=i[c+4>>2],i[r+8>>2]=i[c+8>>2],u=0|Ee(0|t,0|a,52),w(),l=15&u,1&u?(it(c),u=l+1|0):u=l,0|L(h)){t:do{if(l)for(e=1;;){if(s=0|Ee(0|t,0|a,3*(15-e|0)|0),w(),0|(s&=7)){a=s;break t}if(!(e>>>0<l>>>0)){a=0;break}e=e+1|0}else a=0}while(0);a=4==(0|a)&1}else a=0;if(0|xt(n,u,a,0)){if(0|L(h))do{}while(0!=(0|xt(n,u,0,0)));(0|u)!=(0|l)&&nt(c)}else(0|u)!=(0|l)&&(i[c>>2]=i[r>>2],i[c+4>>2]=i[r+4>>2],i[c+8>>2]=i[r+8>>2]);M=o}else M=o}function Ht(t,e,n){n|=0;var r,i;r=M,M=M+16|0,Vt(t|=0,e|=0,i=r),e=0|Ee(0|t,0|e,52),w(),vt(i,15&e,n),M=r}function Wt(t,e,n){n|=0;var r,i,o=0,a=0;i=M,M=M+16|0,Vt(t|=0,e|=0,r=i),o=0|Ee(0|t,0|e,45),w(),o=0==(0|L(127&o)),a=0|Ee(0|t,0|e,52),w(),a&=15;t:do{if(!o){if(0|a)for(o=1;;){if(!(0==((0|Oe(7,0,3*(15-o|0)|0))&t|0)&0==((0|w())&e|0)))break t;if(!(o>>>0<a>>>0))break;o=o+1|0}return _t(r,a,0,5,n),void(M=i)}}while(0);Et(r,a,0,6,n),M=i}function qt(t,e){e|=0;var n,r=0,o=0,a=0,s=0,u=0,c=0;if(Oe(0|(t|=0),0,52),n=134225919|w(),(0|t)<1){o=0,r=0;do{0|L(o)&&(Oe(0|o,0,45),u=0|n|w(),i[(t=e+(r<<3)|0)>>2]=-1,i[t+4>>2]=u,r=r+1|0),o=o+1|0}while(122!=(0|o))}else{u=0,r=0;do{if(0|L(u)){for(Oe(0|u,0,45),o=1,a=-1,s=0|n|w();a&=~(c=0|Oe(7,0,3*(15-o|0)|0)),s&=~(0|w()),(0|o)!=(0|t);)o=o+1|0;i[(c=e+(r<<3)|0)>>2]=a,i[c+4>>2]=s,r=r+1|0}u=u+1|0}while(122!=(0|u))}}function Xt(t,e,n,r){var o,a=0,s=0,u=0,c=0,l=0;if(o=M,M=M+64|0,u=o,(0|(t|=0))==(0|(n|=0))&(0|(e|=0))==(0|(r|=0))|!1|134217728!=(2013265920&e|0)|!1|134217728!=(2013265920&r|0))return M=o,0|(u=0);if(a=0|Ee(0|t,0|e,52),w(),a&=15,s=0|Ee(0|n,0|r,52),w(),(0|a)!=(15&s|0))return M=o,0|(u=0);if(s=a+-1|0,a>>>0>1&&(l=0|Bt(t,e,s),c=0|w(),(0|l)==(0|(s=0|Bt(n,r,s)))&(0|c)==(0|w()))){if(a=0|Ee(0|t,0|e,0|(s=3*(15^a)|0)),w(),a&=7,s=0|Ee(0|n,0|r,0|s),w(),0==(0|a)|0==(0|(s&=7)))return M=o,0|(l=1);if((0|i[21136+(a<<2)>>2])==(0|s))return M=o,0|(l=1);if((0|i[21168+(a<<2)>>2])==(0|s))return M=o,0|(l=1)}s=(a=u)+56|0;do{i[a>>2]=0,a=a+4|0}while((0|a)<(0|s));return I(t,e,1,u),a=(0|i[(l=u)>>2])==(0|n)&&(0|i[l+4>>2])==(0|r)||(0|i[(l=u+8|0)>>2])==(0|n)&&(0|i[l+4>>2])==(0|r)||(0|i[(l=u+16|0)>>2])==(0|n)&&(0|i[l+4>>2])==(0|r)||(0|i[(l=u+24|0)>>2])==(0|n)&&(0|i[l+4>>2])==(0|r)||(0|i[(l=u+32|0)>>2])==(0|n)&&(0|i[l+4>>2])==(0|r)||(0|i[(l=u+40|0)>>2])==(0|n)&&(0|i[l+4>>2])==(0|r)?1:1&((0|i[(a=u+48|0)>>2])==(0|n)?(0|i[a+4>>2])==(0|r):0),M=o,0|(l=a)}function Zt(t,e,n){n|=0;var r,o,a,s,u=0;if(a=M,M=M+16|0,o=a,u=0|Ee(0|(t|=0),0|(e|=0),56),w(),-1==(0|(e=0|function(t,e,n){n|=0;var r,o=0;if(o=0|kt(t=t|0,e=e|0),(n+-1|0)>>>0>5)return 0|(n=-1);if(1==(0|n)&(r=0!=(0|o)))return 0|(n=-1);return o=0|function(t,e){var n,r,o,a=0,s=0,u=0,c=0,l=0;if(o=M,M=M+32|0,r=o,Vt(t=t|0,e=e|0,n=o+16|0),u=0|Mt(t,e),l=0|Dt(t,e),function(t,e){t=7728+(28*(t|=0)|0)|0,i[(e|=0)>>2]=i[t>>2],i[e+4>>2]=i[t+4>>2],i[e+8>>2]=i[t+8>>2],i[e+12>>2]=i[t+12>>2]}(u,r),e=0|function(t,e){t|=0;var n=0,r=0;if((e|=0)>>>0>20)return 0|(e=-1);do{if((0|i[11152+(216*e|0)>>2])!=(0|t))if((0|i[11152+(216*e|0)+8>>2])!=(0|t))if((0|i[11152+(216*e|0)+16>>2])!=(0|t))if((0|i[11152+(216*e|0)+24>>2])!=(0|t))if((0|i[11152+(216*e|0)+32>>2])!=(0|t))if((0|i[11152+(216*e|0)+40>>2])!=(0|t))if((0|i[11152+(216*e|0)+48>>2])!=(0|t))if((0|i[11152+(216*e|0)+56>>2])!=(0|t))if((0|i[11152+(216*e|0)+64>>2])!=(0|t))if((0|i[11152+(216*e|0)+72>>2])!=(0|t))if((0|i[11152+(216*e|0)+80>>2])!=(0|t))if((0|i[11152+(216*e|0)+88>>2])!=(0|t))if((0|i[11152+(216*e|0)+96>>2])!=(0|t))if((0|i[11152+(216*e|0)+104>>2])!=(0|t))if((0|i[11152+(216*e|0)+112>>2])!=(0|t))if((0|i[11152+(216*e|0)+120>>2])!=(0|t))if((0|i[11152+(216*e|0)+128>>2])!=(0|t)){if((0|i[11152+(216*e|0)+136>>2])!=(0|t)){if((0|i[11152+(216*e|0)+144>>2])==(0|t)){t=0,n=2,r=0;break}if((0|i[11152+(216*e|0)+152>>2])==(0|t)){t=0,n=2,r=1;break}if((0|i[11152+(216*e|0)+160>>2])==(0|t)){t=0,n=2,r=2;break}if((0|i[11152+(216*e|0)+168>>2])==(0|t)){t=1,n=2,r=0;break}if((0|i[11152+(216*e|0)+176>>2])==(0|t)){t=1,n=2,r=1;break}if((0|i[11152+(216*e|0)+184>>2])==(0|t)){t=1,n=2,r=2;break}if((0|i[11152+(216*e|0)+192>>2])==(0|t)){t=2,n=2,r=0;break}if((0|i[11152+(216*e|0)+200>>2])==(0|t)){t=2,n=2,r=1;break}if((0|i[11152+(216*e|0)+208>>2])==(0|t)){t=2,n=2,r=2;break}return 0|(t=-1)}t=2,n=1,r=2}else t=2,n=1,r=1;else t=2,n=1,r=0;else t=1,n=1,r=2;else t=1,n=1,r=1;else t=1,n=1,r=0;else t=0,n=1,r=2;else t=0,n=1,r=1;else t=0,n=1,r=0;else t=2,n=0,r=2;else t=2,n=0,r=1;else t=2,n=0,r=0;else t=1,n=0,r=2;else t=1,n=0,r=1;else t=1,n=0,r=0;else t=0,n=0,r=2;else t=0,n=0,r=1;else t=0,n=0,r=0}while(0);return 0|(e=0|i[11152+(216*e|0)+(72*n|0)+(24*t|0)+(r<<3)+4>>2])}(u,0|i[n>>2]),!(0|L(u)))return M=o,0|(l=e);switch(0|u){case 4:t=0,a=14;break;case 14:t=1,a=14;break;case 24:t=2,a=14;break;case 38:t=3,a=14;break;case 49:t=4,a=14;break;case 58:t=5,a=14;break;case 63:t=6,a=14;break;case 72:t=7,a=14;break;case 83:t=8,a=14;break;case 97:t=9,a=14;break;case 107:t=10,a=14;break;case 117:t=11,a=14;break;default:c=0,s=0}14==(0|a)&&(c=0|i[22096+(24*t|0)+8>>2],s=0|i[22096+(24*t|0)+16>>2]);(0|(t=0|i[n>>2]))!=(0|i[r>>2])&&(u=0|j(u),t=0|i[n>>2],u|(0|t)==(0|s)&&(e=(e+1|0)%6|0));if(3==(0|l)&(0|t)==(0|s))return M=o,0|(l=(e+5|0)%6|0);if(!(5==(0|l)&(0|t)==(0|c)))return M=o,0|(l=e);return M=o,0|(l=(e+1|0)%6|0)}(t,e),r?0|(n=(5-o+(0|i[22384+(n<<2)>>2])|0)%5|0):0|(n=(6-o+(0|i[22416+(n<<2)>>2])|0)%6|0)}(r=(s=!0&268435456==(2013265920&e|0))?t:0,t=s?-2130706433&e|134217728:0,7&u))))return i[n>>2]=0,void(M=a);Vt(r,t,o),u=0|Ee(0|r,0|t,52),w(),u&=15,0|kt(r,t)?_t(o,u,e,2,n):Et(o,u,e,2,n),M=a}function Jt(t){t|=0;var e,n,r=0;return(e=0|ve(1,12))||E(22691,22646,49,22704),0|(r=0|i[(n=t+4|0)>>2])?(i[(r=r+8|0)>>2]=e,i[n>>2]=e,0|e):(0|i[t>>2]&&E(22721,22646,61,22744),i[(r=t)>>2]=e,i[n>>2]=e,0|e)}function Qt(t,e){t|=0,e|=0;var n,r;return(r=0|me(24))||E(22758,22646,78,22772),i[r>>2]=i[e>>2],i[r+4>>2]=i[e+4>>2],i[r+8>>2]=i[e+8>>2],i[r+12>>2]=i[e+12>>2],i[r+16>>2]=0,0|(n=0|i[(e=t+4|0)>>2])?(i[n+16>>2]=r,i[e>>2]=r,0|r):(0|i[t>>2]&&E(22787,22646,82,22772),i[t>>2]=r,i[e>>2]=r,0|r)}function Kt(t){var e,n,r=0,a=0,s=0,c=0,l=0,h=0,f=0,p=0,d=0,A=0,g=0,m=0,y=0,v=0,_=0,b=0,x=0,w=0,O=0,S=0,T=0,C=0,P=0,M=0,I=0,B=0,R=0,k=0,D=0,L=0;if(0|i[(c=(t|=0)+8|0)>>2])return 0|(L=1);if(!(s=0|i[t>>2]))return 0|(L=0);r=s,a=0;do{a=a+1|0,r=0|i[r+8>>2]}while(0!=(0|r));if(a>>>0<2)return 0|(L=0);(n=0|me(a<<2))||E(22807,22646,317,22826),(e=0|me(a<<5))||E(22848,22646,321,22826),i[t>>2]=0,i[(C=t+4|0)>>2]=0,i[c>>2]=0,a=0,k=0,T=0,g=0;t:for(;;){if(A=0|i[s>>2]){l=0,h=A;do{if(p=+o[h+8>>3],r=h,h=0|i[h+16>>2],f=+o[(c=(d=0==(0|h))?A:h)+8>>3],+u(+(p-f))>3.141592653589793){L=14;break}l+=(f-p)*(+o[r>>3]+ +o[c>>3])}while(!d);if(14==(0|L)){L=0,l=0,r=A;do{S=+o[r+8>>3],B=0|i[(R=r+16|0)>>2],O=+o[(B=0==(0|B)?A:B)+8>>3],l+=(+o[r>>3]+ +o[B>>3])*((O<0?O+6.283185307179586:O)-(S<0?S+6.283185307179586:S)),r=0|i[(0==(0|r)?s:R)>>2]}while(0!=(0|r))}l>0?(i[n+(k<<2)>>2]=s,k=k+1|0,c=T,r=g):L=19}else L=19;if(19==(0|L)){L=0;do{if(!a){if(g){c=C,h=g+8|0,r=s,a=t;break}if(0|i[t>>2]){L=27;break t}c=C,h=t,r=s,a=t;break}if(0|i[(r=a+8|0)>>2]){L=21;break t}if(!(a=0|ve(1,12))){L=23;break t}i[r>>2]=a,c=a+4|0,h=a,r=g}while(0);if(i[h>>2]=s,i[c>>2]=s,h=e+(T<<5)|0,d=0|i[s>>2]){for(o[(A=e+(T<<5)+8|0)>>3]=17976931348623157e292,o[(g=e+(T<<5)+24|0)>>3]=17976931348623157e292,o[h>>3]=-17976931348623157e292,o[(m=e+(T<<5)+16|0)>>3]=-17976931348623157e292,x=17976931348623157e292,w=-17976931348623157e292,c=0,y=d,p=17976931348623157e292,_=17976931348623157e292,b=-17976931348623157e292,f=-17976931348623157e292;l=+o[y>>3],S=+o[y+8>>3],y=0|i[y+16>>2],O=+o[((v=0==(0|y))?d:y)+8>>3],l<p&&(o[A>>3]=l,p=l),S<_&&(o[g>>3]=S,_=S),l>b?o[h>>3]=l:l=b,S>f&&(o[m>>3]=S,f=S),x=S>0&S<x?S:x,w=S<0&S>w?S:w,c|=+u(+(S-O))>3.141592653589793,!v;)b=l;c&&(o[m>>3]=w,o[g>>3]=x)}else i[h>>2]=0,i[h+4>>2]=0,i[h+8>>2]=0,i[h+12>>2]=0,i[h+16>>2]=0,i[h+20>>2]=0,i[h+24>>2]=0,i[h+28>>2]=0;c=T+1|0}if(s=0|i[(R=s+8|0)>>2],i[R>>2]=0,!s){L=45;break}T=c,g=r}if(21==(0|L))E(22624,22646,35,22658);else if(23==(0|L))E(22678,22646,37,22658);else if(27==(0|L))E(22721,22646,61,22744);else if(45==(0|L)){t:do{if((0|k)>0){for(R=0==(0|c),I=c<<2,B=0==(0|t),M=0,r=0;;){if(P=0|i[n+(M<<2)>>2],R)L=73;else{if(!(T=0|me(I))){L=50;break}if(!(C=0|me(I))){L=52;break}e:do{if(B)a=0;else{for(c=0,a=0,h=t;s=e+(c<<5)|0,0|Yt(0|i[h>>2],s,0|i[P>>2])?(i[T+(a<<2)>>2]=h,i[C+(a<<2)>>2]=s,v=a+1|0):v=a,h=0|i[h+8>>2];)c=c+1|0,a=v;if((0|v)>0)if(s=0|i[T>>2],1==(0|v))a=s;else for(m=0,y=-1,a=s,g=s;;){for(d=0|i[g>>2],s=0,h=0;A=(0|(c=0|i[i[T+(h<<2)>>2]>>2]))==(0|d)?s:s+(1&(0|Yt(c,0|i[C+(h<<2)>>2],0|i[d>>2])))|0,(0|(h=h+1|0))!=(0|v);)s=A;if(a=(c=(0|A)>(0|y))?g:a,(0|(s=m+1|0))==(0|v))break e;m=s,y=c?A:y,g=0|i[T+(s<<2)>>2]}else a=0}}while(0);if(ye(T),ye(C),a){if(s=0|i[(c=a+4|0)>>2])a=s+8|0;else if(0|i[a>>2]){L=70;break}i[a>>2]=P,i[c>>2]=P}else L=73}if(73==(0|L)){if(L=0,0|(r=0|i[P>>2]))do{C=r,r=0|i[r+16>>2],ye(C)}while(0!=(0|r));ye(P),r=2}if((0|(M=M+1|0))>=(0|k)){D=r;break t}}50==(0|L)?E(22863,22646,249,22882):52==(0|L)?E(22901,22646,252,22882):70==(0|L)&&E(22721,22646,61,22744)}else D=0}while(0);return ye(n),ye(e),0|(L=D)}return 0}function Yt(t,e,n){t|=0;var r,a=0,s=0,u=0,c=0,l=0,h=0,f=0;if(!(0|H(e|=0,n|=0)))return 0|(t=0);if(e=0|V(e),r=+o[n>>3],a=e&(a=+o[n+8>>3])<0?a+6.283185307179586:a,!(t=0|i[t>>2]))return 0|(t=0);if(e){e=0,n=t;t:for(;;){for(;c=+o[n>>3],h=+o[n+8>>3],f=0|i[(n=n+16|0)>>2],u=+o[(f=0==(0|f)?t:f)>>3],s=+o[f+8>>3],c>u?(l=c,c=h):(l=u,u=c,c=s,s=h),r<u|r>l;)if(!(n=0|i[n>>2])){n=22;break t}if(a=(c=c<0?c+6.283185307179586:c)==a|(h=s<0?s+6.283185307179586:s)==a?a+-2220446049250313e-31:a,((h+=(r-u)/(l-u)*(c-h))<0?h+6.283185307179586:h)>a&&(e^=1),!(n=0|i[n>>2])){n=22;break}}if(22==(0|n))return 0|e}else{e=0,n=t;t:for(;;){for(;c=+o[n>>3],h=+o[n+8>>3],f=0|i[(n=n+16|0)>>2],u=+o[(f=0==(0|f)?t:f)>>3],s=+o[f+8>>3],c>u?(l=c,c=h):(l=u,u=c,c=s,s=h),r<u|r>l;)if(!(n=0|i[n>>2])){n=22;break t}if(s+(r-u)/(l-u)*(c-s)>(a=c==a|s==a?a+-2220446049250313e-31:a)&&(e^=1),!(n=0|i[n>>2])){n=22;break}}if(22==(0|n))return 0|e}return 0}function $t(t,e,n,o,a){n|=0,o|=0,a|=0;var s,u,c,l,h=0,f=0,p=0,d=0,A=0,g=0,m=0,y=0,v=0,_=0;if(l=M,M=M+32|0,_=l+16|0,c=l,h=0|Ee(0|(t|=0),0|(e|=0),52),w(),h&=15,m=0|Ee(0|n,0|o,52),w(),(0|h)!=(15&m|0))return M=l,0|(_=1);if(A=0|Ee(0|t,0|e,45),w(),A&=127,g=0|Ee(0|n,0|o,45),w(),m=(0|A)!=(0|(g&=127))){if(7==(0|(p=0|G(A,g))))return M=l,0|(_=2);7==(0|(d=0|G(g,A)))?E(22925,22949,151,22959):(y=p,f=d)}else y=0,f=0;s=0|L(A),u=0|L(g),i[_>>2]=0,i[_+4>>2]=0,i[_+8>>2]=0,i[_+12>>2]=0;do{if(y){if(p=(0|(g=0|i[4304+(28*A|0)+(y<<2)>>2]))>0,u)if(p){A=0,d=n,p=o;do{d=0|Ft(d,p),p=0|w(),1==(0|(f=0|ct(f)))&&(f=0|ct(1)),A=A+1|0}while((0|A)!=(0|g));g=f,A=d,d=p}else g=f,A=n,d=o;else if(p){A=0,d=n,p=o;do{d=0|zt(d,p),p=0|w(),f=0|ct(f),A=A+1|0}while((0|A)!=(0|g));g=f,A=d,d=p}else g=f,A=n,d=o;if(Gt(A,d,_),m||E(22972,22949,181,22959),(p=0!=(0|s))&(f=0!=(0|u))&&E(22999,22949,182,22959),p){if(f=0|Dt(t,e),0|r[22032+(7*f|0)+y>>0]){h=3;break}A=d=0|i[21200+(28*f|0)+(y<<2)>>2],v=26}else if(f){if(f=0|Dt(A,d),0|r[22032+(7*f|0)+g>>0]){h=4;break}A=0,d=0|i[21200+(28*g|0)+(f<<2)>>2],v=26}else f=0;if(26==(0|v))if((0|d)<=-1&&E(23030,22949,212,22959),(0|A)<=-1&&E(23053,22949,213,22959),(0|d)>0){p=_+4|0,f=0;do{st(p),f=f+1|0}while((0|f)!=(0|d));f=A}else f=A;if(i[c>>2]=0,i[c+4>>2]=0,i[c+8>>2]=0,ot(c,y),0|h)for(;0|Ut(h)?rt(c):it(c),(0|h)>1;)h=h+-1|0;if((0|f)>0){h=0;do{st(c),h=h+1|0}while((0|h)!=(0|f))}K(v=_+4|0,c,v),J(v),v=50}else if(Gt(n,o,_),0!=(0|s)&0!=(0|u))if((0|g)!=(0|A)&&E(23077,22949,243,22959),f=0|Dt(t,e),h=0|Dt(n,o),0|r[22032+(7*f|0)+h>>0])h=5;else if((0|(f=0|i[21200+(28*f|0)+(h<<2)>>2]))>0){p=_+4|0,h=0;do{st(p),h=h+1|0}while((0|h)!=(0|f));v=50}else v=50;else v=50}while(0);return 50==(0|v)&&(h=_+4|0,i[a>>2]=i[h>>2],i[a+4>>2]=i[h+4>>2],i[a+8>>2]=i[h+8>>2],h=0),M=l,0|(_=h)}function te(t,e,n,r){n|=0,r|=0;var o,a,s=0,u=0,c=0,l=0,h=0,f=0,p=0,d=0,A=0,g=0,m=0,y=0,v=0;if(a=M,M=M+48|0,c=a+36|0,l=a+24|0,h=a+12|0,f=a,u=0|Ee(0|(t|=0),0|(e|=0),52),w(),u&=15,d=0|Ee(0|t,0|e,45),w(),o=0|L(d&=127),Oe(0|u,0,52),m=134225919|w(),i[(g=r)>>2]=-1,i[g+4>>2]=m,!u)return(0|i[n>>2])>1||(0|i[n+4>>2])>1||(0|i[n+8>>2])>1||127==(0|(s=0|N(d,0|tt(n))))?(M=a,0|(m=1)):(A=0|Oe(0|s,0,45),g=0|w(),g=-1040385&i[(d=r)+4>>2]|g,i[(m=r)>>2]=i[d>>2]|A,i[m+4>>2]=g,M=a,0|(m=0));for(i[c>>2]=i[n>>2],i[c+4>>2]=i[n+4>>2],i[c+8>>2]=i[n+8>>2];i[l>>2]=i[c>>2],i[l+4>>2]=i[c+4>>2],i[l+8>>2]=i[c+8>>2],0|Ut(u)?(et(c),i[h>>2]=i[c>>2],i[h+4>>2]=i[c+4>>2],i[h+8>>2]=i[c+8>>2],rt(h)):(nt(c),i[h>>2]=i[c>>2],i[h+4>>2]=i[c+4>>2],i[h+8>>2]=i[c+8>>2],it(h)),Y(l,h,f),J(f),y=0|i[(g=r)>>2],g=0|i[g+4>>2],n=0|Oe(7,0,0|(v=3*(15-u|0)|0)),g&=~(0|w()),v=0|Oe(0|tt(f),0,0|v),g=0|w()|g,i[(m=r)>>2]=v|y&~n,i[m+4>>2]=g,(0|u)>1;)u=u+-1|0;t:do{if((0|i[c>>2])<=1&&(0|i[c+4>>2])<=1&&(0|i[c+8>>2])<=1){f=127==(0|(l=0|N(d,u=0|tt(c))))?0:0|L(l);e:do{if(u){if(o){if(c=21408+(28*(0|Dt(t,e))|0)+(u<<2)|0,(0|(c=0|i[c>>2]))>0){n=0;do{u=0|ut(u),n=n+1|0}while((0|n)!=(0|c))}if(1==(0|u)){s=3;break t}127==(0|(n=0|N(d,u)))&&E(23104,22949,376,23134),0|L(n)?E(23147,22949,377,23134):(A=c,p=u,s=n)}else A=0,p=u,s=l;if((0|(h=0|i[4304+(28*d|0)+(p<<2)>>2]))<=-1&&E(23178,22949,384,23134),!f){if((0|A)<=-1&&E(23030,22949,417,23134),0|A){u=0,n=0|i[(c=r)>>2],c=0|i[c+4>>2];do{n=0|jt(n,c),c=0|w(),i[(v=r)>>2]=n,i[v+4>>2]=c,u=u+1|0}while((0|u)<(0|A))}if((0|h)<=0){u=54;break}for(u=0,n=0|i[(c=r)>>2],c=0|i[c+4>>2];;)if(n=0|jt(n,c),c=0|w(),i[(v=r)>>2]=n,i[v+4>>2]=c,(0|(u=u+1|0))==(0|h)){u=54;break e}}if(7==(0|(l=0|G(s,d)))&&E(22925,22949,393,23134),n=0|i[(u=r)>>2],u=0|i[u+4>>2],(0|h)>0){c=0;do{n=0|jt(n,u),u=0|w(),i[(v=r)>>2]=n,i[v+4>>2]=u,c=c+1|0}while((0|c)!=(0|h))}if(n=0|Dt(n,u),v=0|j(s),(0|(n=0|i[(v?21824:21616)+(28*l|0)+(n<<2)>>2]))<=-1&&E(23030,22949,412,23134),n){u=0,c=0|i[(l=r)>>2],l=0|i[l+4>>2];do{c=0|Lt(c,l),l=0|w(),i[(v=r)>>2]=c,i[v+4>>2]=l,u=u+1|0}while((0|u)<(0|n));u=54}else u=54}else if(0!=(0|o)&0!=(0|f))if(u=21408+(28*(v=0|Dt(t,e))|0)+((0|Dt(0|i[(u=r)>>2],0|i[u+4>>2]))<<2)|0,(0|(u=0|i[u>>2]))<=-1&&E(23201,22949,433,23134),u){s=0,n=0|i[(c=r)>>2],c=0|i[c+4>>2];do{n=0|jt(n,c),c=0|w(),i[(v=r)>>2]=n,i[v+4>>2]=c,s=s+1|0}while((0|s)<(0|u));s=l,u=54}else s=l,u=55;else s=l,u=54}while(0);if(54==(0|u)&&f&&(u=55),55==(0|u)&&1==(0|Dt(0|i[(v=r)>>2],0|i[v+4>>2]))){s=4;break}m=0|i[(v=r)>>2],v=-1040385&i[v+4>>2],y=0|Oe(0|s,0,45),v=0|v|w(),i[(s=r)>>2]=m|y,i[s+4>>2]=v,s=0}else s=2}while(0);return M=a,0|(v=s)}function ee(t,e){var n=0;if(!(e|=0))return 0|(n=1);n=t|=0,t=1;do{t=0|v(0==(1&e|0)?1:n,t),e>>=1,n=0|v(n,n)}while(0!=(0|e));return 0|t}function ne(t,e,n){t|=0;var r,a,s=0,u=0,c=0,l=0,h=0,f=0,p=0,d=0;if(!(0|H(e|=0,n|=0)))return 0|(d=0);if(e=0|V(e),a=+o[n>>3],s=e&(s=+o[n+8>>3])<0?s+6.283185307179586:s,(0|(d=0|i[t>>2]))<=0)return 0|(d=0);if(r=0|i[t+4>>2],e){e=0,n=-1,t=0;t:for(;;){for(p=t;l=+o[r+(p<<4)>>3],f=+o[r+(p<<4)+8>>3],c=+o[r+((t=(n+2|0)%(0|d)|0)<<4)>>3],u=+o[r+(t<<4)+8>>3],l>c?(h=l,l=f):(h=c,c=l,l=u,u=f),a<c|a>h;){if(!((0|(n=p+1|0))<(0|d))){n=22;break t}t=p,p=n,n=t}if(s=(l=l<0?l+6.283185307179586:l)==s|(f=u<0?u+6.283185307179586:u)==s?s+-2220446049250313e-31:s,((f+=(a-c)/(h-c)*(l-f))<0?f+6.283185307179586:f)>s&&(e^=1),(0|(t=p+1|0))>=(0|d)){n=22;break}n=p}if(22==(0|n))return 0|e}else{e=0,n=-1,t=0;t:for(;;){for(p=t;l=+o[r+(p<<4)>>3],f=+o[r+(p<<4)+8>>3],c=+o[r+((t=(n+2|0)%(0|d)|0)<<4)>>3],u=+o[r+(t<<4)+8>>3],l>c?(h=l,l=f):(h=c,c=l,l=u,u=f),a<c|a>h;){if(!((0|(n=p+1|0))<(0|d))){n=22;break t}t=p,p=n,n=t}if(u+(a-c)/(h-c)*(l-u)>(s=l==s|u==s?s+-2220446049250313e-31:s)&&(e^=1),(0|(t=p+1|0))>=(0|d)){n=22;break}n=p}if(22==(0|n))return 0|e}return 0}function re(t,e){e|=0;var n,r,a,s,c,l=0,h=0,f=0,p=0,d=0,A=0,g=0,m=0,y=0,v=0,_=0,b=0;if(!(r=0|i[(t|=0)>>2]))return i[e>>2]=0,i[e+4>>2]=0,i[e+8>>2]=0,i[e+12>>2]=0,i[e+16>>2]=0,i[e+20>>2]=0,i[e+24>>2]=0,void(i[e+28>>2]=0);if(o[(a=e+8|0)>>3]=17976931348623157e292,o[(s=e+24|0)>>3]=17976931348623157e292,o[e>>3]=-17976931348623157e292,o[(c=e+16|0)>>3]=-17976931348623157e292,!((0|r)<=0)){for(n=0|i[t+4>>2],m=17976931348623157e292,y=-17976931348623157e292,v=0,t=-1,p=17976931348623157e292,d=17976931348623157e292,g=-17976931348623157e292,h=-17976931348623157e292,_=0;l=+o[n+(_<<4)>>3],A=+o[n+(_<<4)+8>>3],f=+o[n+(((0|(t=t+2|0))==(0|r)?0:t)<<4)+8>>3],l<p&&(o[a>>3]=l,p=l),A<d&&(o[s>>3]=A,d=A),l>g?o[e>>3]=l:l=g,A>h&&(o[c>>3]=A,h=A),m=A>0&A<m?A:m,y=A<0&A>y?A:y,v|=+u(+(A-f))>3.141592653589793,(0|(t=_+1|0))!=(0|r);)b=_,g=l,_=t,t=b;v&&(o[c>>3]=y,o[s>>3]=m)}}function ie(t,e){e|=0;var n,r=0,a=0,s=0,c=0,l=0,h=0,f=0,p=0,d=0,A=0,g=0,m=0,y=0,v=0,_=0,b=0,x=0,w=0,E=0,O=0,S=0;if(y=0|i[(t|=0)>>2]){if(o[(v=e+8|0)>>3]=17976931348623157e292,o[(_=e+24|0)>>3]=17976931348623157e292,o[e>>3]=-17976931348623157e292,o[(b=e+16|0)>>3]=-17976931348623157e292,(0|y)>0){for(s=0|i[t+4>>2],g=17976931348623157e292,m=-17976931348623157e292,a=0,r=-1,f=17976931348623157e292,p=17976931348623157e292,A=-17976931348623157e292,l=-17976931348623157e292,x=0;c=+o[s+(x<<4)>>3],d=+o[s+(x<<4)+8>>3],h=+o[s+(((0|(O=r+2|0))==(0|y)?0:O)<<4)+8>>3],c<f&&(o[v>>3]=c,f=c),d<p&&(o[_>>3]=d,p=d),c>A?o[e>>3]=c:c=A,d>l&&(o[b>>3]=d,l=d),g=d>0&d<g?d:g,m=d<0&d>m?d:m,a|=+u(+(d-h))>3.141592653589793,(0|(r=x+1|0))!=(0|y);)O=x,A=c,x=r,r=O;a&&(o[b>>3]=m,o[_>>3]=g)}}else i[e>>2]=0,i[e+4>>2]=0,i[e+8>>2]=0,i[e+12>>2]=0,i[e+16>>2]=0,i[e+20>>2]=0,i[e+24>>2]=0,i[e+28>>2]=0;if(!((0|(r=0|i[(O=t+8|0)>>2]))<=0)){n=t+12|0,E=0;do{if(s=0|i[n>>2],a=E,_=e+((E=E+1|0)<<5)|0,b=0|i[s+(a<<3)>>2]){if(o[(x=e+(E<<5)+8|0)>>3]=17976931348623157e292,o[(t=e+(E<<5)+24|0)>>3]=17976931348623157e292,o[_>>3]=-17976931348623157e292,o[(w=e+(E<<5)+16|0)>>3]=-17976931348623157e292,(0|b)>0){for(y=0|i[s+(a<<3)+4>>2],g=17976931348623157e292,m=-17976931348623157e292,s=0,a=-1,v=0,f=17976931348623157e292,p=17976931348623157e292,d=-17976931348623157e292,l=-17976931348623157e292;c=+o[y+(v<<4)>>3],A=+o[y+(v<<4)+8>>3],h=+o[y+(((0|(a=a+2|0))==(0|b)?0:a)<<4)+8>>3],c<f&&(o[x>>3]=c,f=c),A<p&&(o[t>>3]=A,p=A),c>d?o[_>>3]=c:c=d,A>l&&(o[w>>3]=A,l=A),g=A>0&A<g?A:g,m=A<0&A>m?A:m,s|=+u(+(A-h))>3.141592653589793,(0|(a=v+1|0))!=(0|b);)S=v,v=a,d=c,a=S;s&&(o[w>>3]=m,o[t>>3]=g)}}else i[_>>2]=0,i[_+4>>2]=0,i[_+8>>2]=0,i[_+12>>2]=0,i[_+16>>2]=0,i[_+20>>2]=0,i[_+24>>2]=0,i[_+28>>2]=0,r=0|i[O>>2]}while((0|E)<(0|r))}}function oe(t,e,n){var r=0,o=0,a=0;if(!(0|ne(t|=0,e|=0,n|=0)))return 0|(o=0);if((0|i[(o=t+8|0)>>2])<=0)return 0|(o=1);for(r=t+12|0,t=0;;){if(a=t,t=t+1|0,0|ne((0|i[r>>2])+(a<<3)|0,e+(t<<5)|0,n)){t=0,r=6;break}if((0|t)>=(0|i[o>>2])){t=1,r=6;break}}return 6==(0|r)?0|t:0}function ae(t,e,n,r,i){e|=0,n|=0,r|=0,i|=0;var a,s,u,c,l,h,f,p=0;c=+o[(t|=0)>>3],u=+o[e>>3]-c,s=+o[t+8>>3],a=+o[e+8>>3]-s,h=+o[n>>3],p=((p=+o[r>>3]-h)*(s-(f=+o[n+8>>3]))-(c-h)*(l=+o[r+8>>3]-f))/(u*l-a*p),o[i>>3]=c+u*p,o[i+8>>3]=s+a*p}function se(t,e){return e|=0,+o[(t|=0)>>3]!=+o[e>>3]?0|(e=0):0|(e=+o[t+8>>3]==+o[e+8>>3])}function ue(t,e){e|=0;var n,r,i;return+((i=+o[(t|=0)>>3]-+o[e>>3])*i+(r=+o[t+8>>3]-+o[e+8>>3])*r+(n=+o[t+16>>3]-+o[e+16>>3])*n)}function ce(t,e,n){t|=0,n|=0;var r=0;(0|(e|=0))>0?(r=0|ve(e,4),i[t>>2]=r,r||E(23230,23253,40,23267)):i[t>>2]=0,i[t+4>>2]=e,i[t+8>>2]=0,i[t+12>>2]=n}function le(t){var e,n,r,a=0,s=0,c=0,h=0;e=(t|=0)+4|0,n=t+12|0,r=t+8|0;t:for(;;){for(s=0|i[e>>2],a=0;;){if((0|a)>=(0|s))break t;if(c=0|i[t>>2],h=0|i[c+(a<<2)>>2])break;a=a+1|0}a=c+(~~(+u(+ +l(10,+ +(15-(0|i[n>>2])|0))*(+o[h>>3]+ +o[h+8>>3]))%+(0|s))>>>0<<2)|0,s=0|i[a>>2];e:do{if(0|s){if(c=h+32|0,(0|s)==(0|h))i[a>>2]=i[c>>2];else{if(!(a=0|i[(s=s+32|0)>>2]))break;for(;(0|a)!=(0|h);)if(!(a=0|i[(s=a+32|0)>>2]))break e;i[s>>2]=i[c>>2]}ye(h),i[r>>2]=(0|i[r>>2])-1}}while(0)}ye(0|i[t>>2])}function he(t){var e,n=0,r=0;for(e=0|i[(t|=0)+4>>2],r=0;;){if((0|r)>=(0|e)){n=0,r=4;break}if(n=0|i[(0|i[t>>2])+(r<<2)>>2]){r=4;break}r=r+1|0}return 4==(0|r)?0|n:0}function fe(t,e){e|=0;var n=0,r=0,a=0,s=0;if(n=~~(+u(+ +l(10,+ +(15-(0|i[(t|=0)+12>>2])|0))*(+o[e>>3]+ +o[e+8>>3]))%+(0|i[t+4>>2]))>>>0,n=(0|i[t>>2])+(n<<2)|0,!(r=0|i[n>>2]))return 0|(s=1);s=e+32|0;do{if((0|r)!=(0|e)){if(!(n=0|i[r+32>>2]))return 0|(s=1);for(a=n;;){if((0|a)==(0|e)){a=8;break}if(!(n=0|i[a+32>>2])){n=1,a=10;break}r=a,a=n}if(8==(0|a)){i[r+32>>2]=i[s>>2];break}if(10==(0|a))return 0|n}else i[n>>2]=i[s>>2]}while(0);return ye(e),i[(s=t+8|0)>>2]=(0|i[s>>2])-1,0|(s=0)}function pe(t,e,n){t|=0,e|=0,n|=0;var r,a=0,s=0,c=0;(r=0|me(40))||E(23283,23253,98,23296),i[r>>2]=i[e>>2],i[r+4>>2]=i[e+4>>2],i[r+8>>2]=i[e+8>>2],i[r+12>>2]=i[e+12>>2],i[(s=r+16|0)>>2]=i[n>>2],i[s+4>>2]=i[n+4>>2],i[s+8>>2]=i[n+8>>2],i[s+12>>2]=i[n+12>>2],i[r+32>>2]=0,s=~~(+u(+ +l(10,+ +(15-(0|i[t+12>>2])|0))*(+o[e>>3]+ +o[e+8>>3]))%+(0|i[t+4>>2]))>>>0,s=(0|i[t>>2])+(s<<2)|0,a=0|i[s>>2];do{if(a){for(;!(0|Tt(a,e)&&0|Tt(a+16|0,n));)if(s=0|i[a+32>>2],!(0|i[(a=0==(0|s)?a:s)+32>>2])){c=10;break}if(10==(0|c)){i[a+32>>2]=r;break}return ye(r),0|(c=a)}i[s>>2]=r}while(0);return i[(c=t+8|0)>>2]=1+(0|i[c>>2]),0|(c=r)}function de(t,e,n){e|=0,n|=0;var r=0,a=0;if(a=~~(+u(+ +l(10,+ +(15-(0|i[(t|=0)+12>>2])|0))*(+o[e>>3]+ +o[e+8>>3]))%+(0|i[t+4>>2]))>>>0,!(a=0|i[(0|i[t>>2])+(a<<2)>>2]))return 0|(n=0);if(!n){for(t=a;;){if(0|Tt(t,e)){r=10;break}if(!(t=0|i[t+32>>2])){t=0,r=10;break}}if(10==(0|r))return 0|t}for(t=a;;){if(0|Tt(t,e)&&0|Tt(t+16|0,n)){r=10;break}if(!(t=0|i[t+32>>2])){t=0,r=10;break}}return 10==(0|r)?0|t:0}function Ae(t,e){e|=0;var n=0;if(n=~~(+u(+ +l(10,+ +(15-(0|i[(t|=0)+12>>2])|0))*(+o[e>>3]+ +o[e+8>>3]))%+(0|i[t+4>>2]))>>>0,!(t=0|i[(0|i[t>>2])+(n<<2)>>2]))return 0|(n=0);for(;;){if(0|Tt(t,e)){e=5;break}if(!(t=0|i[t+32>>2])){t=0,e=5;break}}return 5==(0|e)?0|t:0}function ge(t){return 0|~~+function(t){return+ +Me(+(t=+t))}(t=+t)}function me(t){t|=0;var e,n=0,r=0,o=0,a=0,s=0,u=0,c=0,l=0,h=0,f=0,p=0,d=0,A=0,g=0,m=0,y=0,v=0,_=0,b=0,x=0;e=M,M=M+16|0,d=e;do{if(t>>>0<245){if(t=(h=t>>>0<11?16:t+11&-8)>>>3,3&(r=(p=0|i[5829])>>>t)|0)return o=0|i[(r=(t=23356+((n=(1&r^1)+t|0)<<1<<2)|0)+8|0)>>2],(0|(s=0|i[(a=o+8|0)>>2]))==(0|t)?i[5829]=p&~(1<<n):(i[s+12>>2]=t,i[r>>2]=s),x=n<<3,i[o+4>>2]=3|x,i[(x=o+x+4|0)>>2]=1|i[x>>2],M=e,0|(x=a);if(h>>>0>(f=0|i[5831])>>>0){if(0|r)return n=((n=r<<t&((n=2<<t)|0-n))&0-n)-1|0,s=0|i[(t=(n=23356+((o=((r=(n>>>=c=n>>>12&16)>>>5&8)|c|(s=(n>>>=r)>>>2&4)|(t=(n>>>=s)>>>1&2)|(o=(n>>>=t)>>>1&1))+(n>>>o)|0)<<1<<2)|0)+8|0)>>2],(0|(r=0|i[(c=s+8|0)>>2]))==(0|n)?(t=p&~(1<<o),i[5829]=t):(i[r+12>>2]=n,i[t>>2]=r,t=p),u=(x=o<<3)-h|0,i[s+4>>2]=3|h,i[(a=s+h|0)+4>>2]=1|u,i[s+x>>2]=u,0|f&&(o=0|i[5834],r=23356+((n=f>>>3)<<1<<2)|0,t&(n=1<<n)?n=0|i[(t=r+8|0)>>2]:(i[5829]=t|n,n=r,t=r+8|0),i[t>>2]=o,i[n+12>>2]=o,i[o+8>>2]=n,i[o+12>>2]=r),i[5831]=u,i[5834]=a,M=e,0|(x=c);if(s=0|i[5830]){for(r=(s&0-s)-1|0,r=l=0|i[23620+(((o=(r>>>=a=r>>>12&16)>>>5&8)|a|(u=(r>>>=o)>>>2&4)|(c=(r>>>=u)>>>1&2)|(l=(r>>>=c)>>>1&1))+(r>>>l)<<2)>>2],c=l,l=(-8&i[l+4>>2])-h|0;(t=0|i[r+16>>2])||(t=0|i[r+20>>2]);)r=t,c=(a=(u=(-8&i[t+4>>2])-h|0)>>>0<l>>>0)?t:c,l=a?u:l;if((u=c+h|0)>>>0>c>>>0){a=0|i[c+24>>2],n=0|i[c+12>>2];do{if((0|n)==(0|c)){if(!(n=0|i[(t=c+20|0)>>2])&&!(n=0|i[(t=c+16|0)>>2])){r=0;break}for(;;)if(r=0|i[(o=n+20|0)>>2])n=r,t=o;else{if(!(r=0|i[(o=n+16|0)>>2]))break;n=r,t=o}i[t>>2]=0,r=n}else r=0|i[c+8>>2],i[r+12>>2]=n,i[n+8>>2]=r,r=n}while(0);do{if(0|a){if(n=0|i[c+28>>2],(0|c)==(0|i[(t=23620+(n<<2)|0)>>2])){if(i[t>>2]=r,!r){i[5830]=s&~(1<<n);break}}else if(i[((0|i[(x=a+16|0)>>2])==(0|c)?x:a+20|0)>>2]=r,!r)break;i[r+24>>2]=a,0|(n=0|i[c+16>>2])&&(i[r+16>>2]=n,i[n+24>>2]=r),0|(n=0|i[c+20>>2])&&(i[r+20>>2]=n,i[n+24>>2]=r)}}while(0);return l>>>0<16?(x=l+h|0,i[c+4>>2]=3|x,i[(x=c+x+4|0)>>2]=1|i[x>>2]):(i[c+4>>2]=3|h,i[u+4>>2]=1|l,i[u+l>>2]=l,0|f&&(o=0|i[5834],r=23356+((n=f>>>3)<<1<<2)|0,(n=1<<n)&p?n=0|i[(t=r+8|0)>>2]:(i[5829]=n|p,n=r,t=r+8|0),i[t>>2]=o,i[n+12>>2]=o,i[o+8>>2]=n,i[o+12>>2]=r),i[5831]=l,i[5834]=u),M=e,0|(x=c+8|0)}p=h}else p=h}else p=h}else if(t>>>0<=4294967231)if(h=-8&(t=t+11|0),o=0|i[5830]){a=0-h|0,l=(t>>>=8)?h>>>0>16777215?31:h>>>((l=14-((c=((m=t<<(p=(t+1048320|0)>>>16&8))+520192|0)>>>16&4)|p|(l=((m<<=c)+245760|0)>>>16&2))+(m<<l>>>15)|0)+7|0)&1|l<<1:0,r=0|i[23620+(l<<2)>>2];t:do{if(r)for(t=0,c=h<<(31==(0|l)?0:25-(l>>>1)|0),s=0;;){if((u=(-8&i[r+4>>2])-h|0)>>>0<a>>>0){if(!u){t=r,a=0,m=65;break t}t=r,a=u}if(s=0==(0|(m=0|i[r+20>>2]))|(0|m)==(0|(r=0|i[r+16+(c>>>31<<2)>>2]))?s:m,!r){r=s,m=61;break}c<<=1}else r=0,t=0,m=61}while(0);if(61==(0|m)){if(0==(0|r)&0==(0|t)){if(!(t=((t=2<<l)|0-t)&o)){p=h;break}p=(t&0-t)-1|0,t=0,r=0|i[23620+(((s=(p>>>=u=p>>>12&16)>>>5&8)|u|(c=(p>>>=s)>>>2&4)|(l=(p>>>=c)>>>1&2)|(r=(p>>>=l)>>>1&1))+(p>>>r)<<2)>>2]}r?m=65:(c=t,u=a)}if(65==(0|m))for(s=r;;){if(a=(r=(p=(-8&i[s+4>>2])-h|0)>>>0<a>>>0)?p:a,t=r?s:t,(r=0|i[s+16>>2])||(r=0|i[s+20>>2]),!r){c=t,u=a;break}s=r}if(0!=(0|c)&&u>>>0<((0|i[5831])-h|0)>>>0&&(f=c+h|0)>>>0>c>>>0){s=0|i[c+24>>2],n=0|i[c+12>>2];do{if((0|n)==(0|c)){if(!(n=0|i[(t=c+20|0)>>2])&&!(n=0|i[(t=c+16|0)>>2])){n=0;break}for(;;)if(r=0|i[(a=n+20|0)>>2])n=r,t=a;else{if(!(r=0|i[(a=n+16|0)>>2]))break;n=r,t=a}i[t>>2]=0}else x=0|i[c+8>>2],i[x+12>>2]=n,i[n+8>>2]=x}while(0);do{if(s){if(t=0|i[c+28>>2],(0|c)==(0|i[(r=23620+(t<<2)|0)>>2])){if(i[r>>2]=n,!n){o&=~(1<<t),i[5830]=o;break}}else if(i[((0|i[(x=s+16|0)>>2])==(0|c)?x:s+20|0)>>2]=n,!n)break;i[n+24>>2]=s,0|(t=0|i[c+16>>2])&&(i[n+16>>2]=t,i[t+24>>2]=n),(t=0|i[c+20>>2])&&(i[n+20>>2]=t,i[t+24>>2]=n)}}while(0);t:do{if(u>>>0<16)x=u+h|0,i[c+4>>2]=3|x,i[(x=c+x+4|0)>>2]=1|i[x>>2];else{if(i[c+4>>2]=3|h,i[f+4>>2]=1|u,i[f+u>>2]=u,n=u>>>3,u>>>0<256){r=23356+(n<<1<<2)|0,(t=0|i[5829])&(n=1<<n)?n=0|i[(t=r+8|0)>>2]:(i[5829]=t|n,n=r,t=r+8|0),i[t>>2]=f,i[n+12>>2]=f,i[f+8>>2]=n,i[f+12>>2]=r;break}if(n=23620+((r=(n=u>>>8)?u>>>0>16777215?31:u>>>((r=14-((_=((x=n<<(b=(n+1048320|0)>>>16&8))+520192|0)>>>16&4)|b|(r=((x<<=_)+245760|0)>>>16&2))+(x<<r>>>15)|0)+7|0)&1|r<<1:0)<<2)|0,i[f+28>>2]=r,i[(t=f+16|0)+4>>2]=0,i[t>>2]=0,!(o&(t=1<<r))){i[5830]=o|t,i[n>>2]=f,i[f+24>>2]=n,i[f+12>>2]=f,i[f+8>>2]=f;break}n=0|i[n>>2];e:do{if((-8&i[n+4>>2]|0)!=(0|u)){for(o=u<<(31==(0|r)?0:25-(r>>>1)|0);t=0|i[(r=n+16+(o>>>31<<2)|0)>>2];){if((-8&i[t+4>>2]|0)==(0|u)){n=t;break e}o<<=1,n=t}i[r>>2]=f,i[f+24>>2]=n,i[f+12>>2]=f,i[f+8>>2]=f;break t}}while(0);x=0|i[(b=n+8|0)>>2],i[x+12>>2]=f,i[b>>2]=f,i[f+8>>2]=x,i[f+12>>2]=n,i[f+24>>2]=0}}while(0);return M=e,0|(x=c+8|0)}p=h}else p=h;else p=-1}while(0);if((r=0|i[5831])>>>0>=p>>>0)return n=r-p|0,t=0|i[5834],n>>>0>15?(x=t+p|0,i[5834]=x,i[5831]=n,i[x+4>>2]=1|n,i[t+r>>2]=n,i[t+4>>2]=3|p):(i[5831]=0,i[5834]=0,i[t+4>>2]=3|r,i[(x=t+r+4|0)>>2]=1|i[x>>2]),M=e,0|(x=t+8|0);if((u=0|i[5832])>>>0>p>>>0)return _=u-p|0,i[5832]=_,b=(x=0|i[5835])+p|0,i[5835]=b,i[b+4>>2]=1|_,i[x+4>>2]=3|p,M=e,0|(x=x+8|0);if(0|i[5947]?t=0|i[5949]:(i[5949]=4096,i[5948]=4096,i[5950]=-1,i[5951]=-1,i[5952]=0,i[5940]=0,i[5947]=-16&d^1431655768,t=4096),c=p+48|0,(h=(s=t+(l=p+47|0)|0)&(a=0-t|0))>>>0<=p>>>0)return M=e,0|(x=0);if(0|(t=0|i[5939])&&(d=(f=0|i[5937])+h|0)>>>0<=f>>>0|d>>>0>t>>>0)return M=e,0|(x=0);t:do{if(4&i[5940])n=0,m=143;else{r=0|i[5835];e:do{if(r){for(o=23764;!((d=0|i[o>>2])>>>0<=r>>>0&&(d+(0|i[o+4>>2])|0)>>>0>r>>>0);){if(!(t=0|i[o+8>>2])){m=128;break e}o=t}if((n=s-u&a)>>>0<2147483647)if((0|(t=0|Ie(0|n)))==((0|i[o>>2])+(0|i[o+4>>2])|0)){if(-1!=(0|t)){u=n,s=t,m=145;break t}}else o=t,m=136;else n=0}else m=128}while(0);do{if(128==(0|m))if(-1!=(0|(r=0|Ie(0)))&&(n=r,g=(n=(0==((g=(A=0|i[5948])+-1|0)&n|0)?0:(g+n&0-A)-n|0)+h|0)+(A=0|i[5937])|0,n>>>0>p>>>0&n>>>0<2147483647)){if(0|(d=0|i[5939])&&g>>>0<=A>>>0|g>>>0>d>>>0){n=0;break}if((0|(t=0|Ie(0|n)))==(0|r)){u=n,s=r,m=145;break t}o=t,m=136}else n=0}while(0);do{if(136==(0|m)){if(r=0-n|0,!(c>>>0>n>>>0&n>>>0<2147483647&-1!=(0|o))){if(-1==(0|o)){n=0;break}u=n,s=o,m=145;break t}if((t=l-n+(t=0|i[5949])&0-t)>>>0>=2147483647){u=n,s=o,m=145;break t}if(-1==(0|Ie(0|t))){Ie(0|r),n=0;break}u=t+n|0,s=o,m=145;break t}}while(0);i[5940]=4|i[5940],m=143}}while(0);if(143==(0|m)&&h>>>0<2147483647&&!(-1==(0|(_=0|Ie(0|h)))|1^(v=(y=(g=0|Ie(0))-_|0)>>>0>(p+40|0)>>>0)|_>>>0<g>>>0&-1!=(0|_)&-1!=(0|g)^1)&&(u=v?y:n,s=_,m=145),145==(0|m)){n=(0|i[5937])+u|0,i[5937]=n,n>>>0>(0|i[5938])>>>0&&(i[5938]=n),l=0|i[5835];t:do{if(l){for(n=23764;;){if((0|s)==((t=0|i[n>>2])+(r=0|i[n+4>>2])|0)){m=154;break}if(!(o=0|i[n+8>>2]))break;n=o}if(154==(0|m)&&(b=n+4|0,0==(8&i[n+12>>2]|0))&&s>>>0>l>>>0&t>>>0<=l>>>0){i[b>>2]=r+u,b=l+(_=0==(7&(_=l+8|0)|0)?0:0-_&7)|0,_=(x=(0|i[5832])+u|0)-_|0,i[5835]=b,i[5832]=_,i[b+4>>2]=1|_,i[l+x+4>>2]=40,i[5836]=i[5951];break}for(s>>>0<(0|i[5833])>>>0&&(i[5833]=s),r=s+u|0,n=23764;;){if((0|i[n>>2])==(0|r)){m=162;break}if(!(t=0|i[n+8>>2]))break;n=t}if(162==(0|m)&&0==(8&i[n+12>>2]|0)){i[n>>2]=s,i[(f=n+4|0)>>2]=(0|i[f>>2])+u,h=(f=s+(0==(7&(f=s+8|0)|0)?0:0-f&7)|0)+p|0,c=(n=r+(0==(7&(n=r+8|0)|0)?0:0-n&7)|0)-f-p|0,i[f+4>>2]=3|p;e:do{if((0|l)==(0|n))x=(0|i[5832])+c|0,i[5832]=x,i[5835]=h,i[h+4>>2]=1|x;else{if((0|i[5834])==(0|n)){x=(0|i[5831])+c|0,i[5831]=x,i[5834]=h,i[h+4>>2]=1|x,i[h+x>>2]=x;break}if(1==(3&(t=0|i[n+4>>2])|0)){u=-8&t,o=t>>>3;n:do{if(t>>>0<256){if(t=0|i[n+8>>2],(0|(r=0|i[n+12>>2]))==(0|t)){i[5829]=i[5829]&~(1<<o);break}i[t+12>>2]=r,i[r+8>>2]=t;break}s=0|i[n+24>>2],t=0|i[n+12>>2];do{if((0|t)==(0|n)){if(t=0|i[(o=(r=n+16|0)+4|0)>>2])r=o;else if(!(t=0|i[r>>2])){t=0;break}for(;;)if(o=0|i[(a=t+20|0)>>2])t=o,r=a;else{if(!(o=0|i[(a=t+16|0)>>2]))break;t=o,r=a}i[r>>2]=0}else x=0|i[n+8>>2],i[x+12>>2]=t,i[t+8>>2]=x}while(0);if(!s)break;o=23620+((r=0|i[n+28>>2])<<2)|0;do{if((0|i[o>>2])==(0|n)){if(i[o>>2]=t,0|t)break;i[5830]=i[5830]&~(1<<r);break n}if(i[((0|i[(x=s+16|0)>>2])==(0|n)?x:s+20|0)>>2]=t,!t)break n}while(0);if(i[t+24>>2]=s,0|(o=0|i[(r=n+16|0)>>2])&&(i[t+16>>2]=o,i[o+24>>2]=t),!(r=0|i[r+4>>2]))break;i[t+20>>2]=r,i[r+24>>2]=t}while(0);n=n+u|0,a=u+c|0}else a=c;if(i[(n=n+4|0)>>2]=-2&i[n>>2],i[h+4>>2]=1|a,i[h+a>>2]=a,n=a>>>3,a>>>0<256){r=23356+(n<<1<<2)|0,(t=0|i[5829])&(n=1<<n)?n=0|i[(t=r+8|0)>>2]:(i[5829]=t|n,n=r,t=r+8|0),i[t>>2]=h,i[n+12>>2]=h,i[h+8>>2]=n,i[h+12>>2]=r;break}n=a>>>8;do{if(n){if(a>>>0>16777215){o=31;break}o=a>>>((o=14-((_=((x=n<<(b=(n+1048320|0)>>>16&8))+520192|0)>>>16&4)|b|(o=((x<<=_)+245760|0)>>>16&2))+(x<<o>>>15)|0)+7|0)&1|o<<1}else o=0}while(0);if(n=23620+(o<<2)|0,i[h+28>>2]=o,i[(t=h+16|0)+4>>2]=0,i[t>>2]=0,!((t=0|i[5830])&(r=1<<o))){i[5830]=t|r,i[n>>2]=h,i[h+24>>2]=n,i[h+12>>2]=h,i[h+8>>2]=h;break}n=0|i[n>>2];n:do{if((-8&i[n+4>>2]|0)!=(0|a)){for(o=a<<(31==(0|o)?0:25-(o>>>1)|0);t=0|i[(r=n+16+(o>>>31<<2)|0)>>2];){if((-8&i[t+4>>2]|0)==(0|a)){n=t;break n}o<<=1,n=t}i[r>>2]=h,i[h+24>>2]=n,i[h+12>>2]=h,i[h+8>>2]=h;break e}}while(0);x=0|i[(b=n+8|0)>>2],i[x+12>>2]=h,i[b>>2]=h,i[h+8>>2]=x,i[h+12>>2]=n,i[h+24>>2]=0}}while(0);return M=e,0|(x=f+8|0)}for(n=23764;!((t=0|i[n>>2])>>>0<=l>>>0&&(x=t+(0|i[n+4>>2])|0)>>>0>l>>>0);)n=0|i[n+8>>2];n=(t=(t=(a=x+-47|0)+(0==(7&(t=a+8|0)|0)?0:0-t&7)|0)>>>0<(a=l+16|0)>>>0?l:t)+8|0,b=s+(_=0==(7&(_=s+8|0)|0)?0:0-_&7)|0,_=(r=u+-40|0)-_|0,i[5835]=b,i[5832]=_,i[b+4>>2]=1|_,i[s+r+4>>2]=40,i[5836]=i[5951],i[(r=t+4|0)>>2]=27,i[n>>2]=i[5941],i[n+4>>2]=i[5942],i[n+8>>2]=i[5943],i[n+12>>2]=i[5944],i[5941]=s,i[5942]=u,i[5944]=0,i[5943]=n,n=t+24|0;do{b=n,i[(n=n+4|0)>>2]=7}while((b+8|0)>>>0<x>>>0);if((0|t)!=(0|l)){if(s=t-l|0,i[r>>2]=-2&i[r>>2],i[l+4>>2]=1|s,i[t>>2]=s,n=s>>>3,s>>>0<256){r=23356+(n<<1<<2)|0,(t=0|i[5829])&(n=1<<n)?n=0|i[(t=r+8|0)>>2]:(i[5829]=t|n,n=r,t=r+8|0),i[t>>2]=l,i[n+12>>2]=l,i[l+8>>2]=n,i[l+12>>2]=r;break}if(r=23620+((o=(n=s>>>8)?s>>>0>16777215?31:s>>>((o=14-((_=((x=n<<(b=(n+1048320|0)>>>16&8))+520192|0)>>>16&4)|b|(o=((x<<=_)+245760|0)>>>16&2))+(x<<o>>>15)|0)+7|0)&1|o<<1:0)<<2)|0,i[l+28>>2]=o,i[l+20>>2]=0,i[a>>2]=0,!((n=0|i[5830])&(t=1<<o))){i[5830]=n|t,i[r>>2]=l,i[l+24>>2]=r,i[l+12>>2]=l,i[l+8>>2]=l;break}n=0|i[r>>2];e:do{if((-8&i[n+4>>2]|0)!=(0|s)){for(o=s<<(31==(0|o)?0:25-(o>>>1)|0);t=0|i[(r=n+16+(o>>>31<<2)|0)>>2];){if((-8&i[t+4>>2]|0)==(0|s)){n=t;break e}o<<=1,n=t}i[r>>2]=l,i[l+24>>2]=n,i[l+12>>2]=l,i[l+8>>2]=l;break t}}while(0);x=0|i[(b=n+8|0)>>2],i[x+12>>2]=l,i[b>>2]=l,i[l+8>>2]=x,i[l+12>>2]=n,i[l+24>>2]=0}}else 0==(0|(x=0|i[5833]))|s>>>0<x>>>0&&(i[5833]=s),i[5941]=s,i[5942]=u,i[5944]=0,i[5838]=i[5947],i[5837]=-1,i[5842]=23356,i[5841]=23356,i[5844]=23364,i[5843]=23364,i[5846]=23372,i[5845]=23372,i[5848]=23380,i[5847]=23380,i[5850]=23388,i[5849]=23388,i[5852]=23396,i[5851]=23396,i[5854]=23404,i[5853]=23404,i[5856]=23412,i[5855]=23412,i[5858]=23420,i[5857]=23420,i[5860]=23428,i[5859]=23428,i[5862]=23436,i[5861]=23436,i[5864]=23444,i[5863]=23444,i[5866]=23452,i[5865]=23452,i[5868]=23460,i[5867]=23460,i[5870]=23468,i[5869]=23468,i[5872]=23476,i[5871]=23476,i[5874]=23484,i[5873]=23484,i[5876]=23492,i[5875]=23492,i[5878]=23500,i[5877]=23500,i[5880]=23508,i[5879]=23508,i[5882]=23516,i[5881]=23516,i[5884]=23524,i[5883]=23524,i[5886]=23532,i[5885]=23532,i[5888]=23540,i[5887]=23540,i[5890]=23548,i[5889]=23548,i[5892]=23556,i[5891]=23556,i[5894]=23564,i[5893]=23564,i[5896]=23572,i[5895]=23572,i[5898]=23580,i[5897]=23580,i[5900]=23588,i[5899]=23588,i[5902]=23596,i[5901]=23596,i[5904]=23604,i[5903]=23604,b=s+(_=0==(7&(_=s+8|0)|0)?0:0-_&7)|0,_=(x=u+-40|0)-_|0,i[5835]=b,i[5832]=_,i[b+4>>2]=1|_,i[s+x+4>>2]=40,i[5836]=i[5951]}while(0);if((n=0|i[5832])>>>0>p>>>0)return _=n-p|0,i[5832]=_,b=(x=0|i[5835])+p|0,i[5835]=b,i[b+4>>2]=1|_,i[x+4>>2]=3|p,M=e,0|(x=x+8|0)}return i[(x=23312)>>2]=12,M=e,0|(x=0)}function ye(t){var e=0,n=0,r=0,o=0,a=0,s=0,u=0,c=0;if(t|=0){n=t+-8|0,o=0|i[5833],c=n+(e=-8&(t=0|i[t+-4>>2]))|0;do{if(1&t)u=n,s=n;else{if(r=0|i[n>>2],!(3&t))return;if(a=r+e|0,(s=n+(0-r)|0)>>>0<o>>>0)return;if((0|i[5834])==(0|s)){if(3!=(3&(e=0|i[(t=c+4|0)>>2])|0)){u=s,e=a;break}return i[5831]=a,i[t>>2]=-2&e,i[s+4>>2]=1|a,void(i[s+a>>2]=a)}if(n=r>>>3,r>>>0<256){if(t=0|i[s+8>>2],(0|(e=0|i[s+12>>2]))==(0|t)){i[5829]=i[5829]&~(1<<n),u=s,e=a;break}i[t+12>>2]=e,i[e+8>>2]=t,u=s,e=a;break}o=0|i[s+24>>2],t=0|i[s+12>>2];do{if((0|t)==(0|s)){if(t=0|i[(n=(e=s+16|0)+4|0)>>2])e=n;else if(!(t=0|i[e>>2])){t=0;break}for(;;)if(n=0|i[(r=t+20|0)>>2])t=n,e=r;else{if(!(n=0|i[(r=t+16|0)>>2]))break;t=n,e=r}i[e>>2]=0}else u=0|i[s+8>>2],i[u+12>>2]=t,i[t+8>>2]=u}while(0);if(o){if(e=0|i[s+28>>2],(0|i[(n=23620+(e<<2)|0)>>2])==(0|s)){if(i[n>>2]=t,!t){i[5830]=i[5830]&~(1<<e),u=s,e=a;break}}else if(i[((0|i[(u=o+16|0)>>2])==(0|s)?u:o+20|0)>>2]=t,!t){u=s,e=a;break}i[t+24>>2]=o,0|(n=0|i[(e=s+16|0)>>2])&&(i[t+16>>2]=n,i[n+24>>2]=t),(e=0|i[e+4>>2])?(i[t+20>>2]=e,i[e+24>>2]=t,u=s,e=a):(u=s,e=a)}else u=s,e=a}}while(0);if(!(s>>>0>=c>>>0)&&1&(r=0|i[(t=c+4|0)>>2])){if(2&r)i[t>>2]=-2&r,i[u+4>>2]=1|e,i[s+e>>2]=e,o=e;else{if((0|i[5835])==(0|c)){if(c=(0|i[5832])+e|0,i[5832]=c,i[5835]=u,i[u+4>>2]=1|c,(0|u)!=(0|i[5834]))return;return i[5834]=0,void(i[5831]=0)}if((0|i[5834])==(0|c))return c=(0|i[5831])+e|0,i[5831]=c,i[5834]=s,i[u+4>>2]=1|c,void(i[s+c>>2]=c);o=(-8&r)+e|0,n=r>>>3;do{if(r>>>0<256){if(e=0|i[c+8>>2],(0|(t=0|i[c+12>>2]))==(0|e)){i[5829]=i[5829]&~(1<<n);break}i[e+12>>2]=t,i[t+8>>2]=e;break}a=0|i[c+24>>2],t=0|i[c+12>>2];do{if((0|t)==(0|c)){if(t=0|i[(n=(e=c+16|0)+4|0)>>2])e=n;else if(!(t=0|i[e>>2])){n=0;break}for(;;)if(n=0|i[(r=t+20|0)>>2])t=n,e=r;else{if(!(n=0|i[(r=t+16|0)>>2]))break;t=n,e=r}i[e>>2]=0,n=t}else n=0|i[c+8>>2],i[n+12>>2]=t,i[t+8>>2]=n,n=t}while(0);if(0|a){if(t=0|i[c+28>>2],(0|i[(e=23620+(t<<2)|0)>>2])==(0|c)){if(i[e>>2]=n,!n){i[5830]=i[5830]&~(1<<t);break}}else if(i[((0|i[(r=a+16|0)>>2])==(0|c)?r:a+20|0)>>2]=n,!n)break;i[n+24>>2]=a,0|(e=0|i[(t=c+16|0)>>2])&&(i[n+16>>2]=e,i[e+24>>2]=n),0|(t=0|i[t+4>>2])&&(i[n+20>>2]=t,i[t+24>>2]=n)}}while(0);if(i[u+4>>2]=1|o,i[s+o>>2]=o,(0|u)==(0|i[5834]))return void(i[5831]=o)}if(t=o>>>3,o>>>0<256)return n=23356+(t<<1<<2)|0,(e=0|i[5829])&(t=1<<t)?t=0|i[(e=n+8|0)>>2]:(i[5829]=e|t,t=n,e=n+8|0),i[e>>2]=u,i[t+12>>2]=u,i[u+8>>2]=t,void(i[u+12>>2]=n);t=23620+((r=(t=o>>>8)?o>>>0>16777215?31:o>>>((r=14-((a=((c=t<<(s=(t+1048320|0)>>>16&8))+520192|0)>>>16&4)|s|(r=((c<<=a)+245760|0)>>>16&2))+(c<<r>>>15)|0)+7|0)&1|r<<1:0)<<2)|0,i[u+28>>2]=r,i[u+20>>2]=0,i[u+16>>2]=0,e=0|i[5830],n=1<<r;t:do{if(e&n){t=0|i[t>>2];e:do{if((-8&i[t+4>>2]|0)!=(0|o)){for(r=o<<(31==(0|r)?0:25-(r>>>1)|0);e=0|i[(n=t+16+(r>>>31<<2)|0)>>2];){if((-8&i[e+4>>2]|0)==(0|o)){t=e;break e}r<<=1,t=e}i[n>>2]=u,i[u+24>>2]=t,i[u+12>>2]=u,i[u+8>>2]=u;break t}}while(0);c=0|i[(s=t+8|0)>>2],i[c+12>>2]=u,i[s>>2]=u,i[u+8>>2]=c,i[u+12>>2]=t,i[u+24>>2]=0}else i[5830]=e|n,i[t>>2]=u,i[u+24>>2]=t,i[u+12>>2]=u,i[u+8>>2]=u}while(0);if(c=(0|i[5837])-1|0,i[5837]=c,!(0|c)){for(t=23772;t=0|i[t>>2];)t=t+8|0;i[5837]=-1}}}}function ve(t,e){e|=0;var n=0;return(t|=0)?(n=0|v(e,t),(e|t)>>>0>65535&&(n=(0|(n>>>0)/(t>>>0))==(0|e)?n:-1)):n=0,(t=0|me(n))&&3&i[t+-4>>2]?(Pe(0|t,0,0|n),0|t):0|t}function _e(t,e,n,r){return 0|(x(0|(r=(e|=0)-(r|=0)-((n|=0)>>>0>(t|=0)>>>0|0)>>>0)),t-n>>>0|0)}function be(t){return 0|((t|=0)?31-(0|b(t^t-1))|0:32)}function xe(t,e,n,r,o){o|=0;var a=0,s=0,u=0,c=0,l=0,h=0,f=0,p=0,d=0,A=0;if(h=t|=0,s=n|=0,u=p=r|=0,!(l=c=e|=0))return a=0!=(0|o),u?a?(i[o>>2]=0|t,i[o+4>>2]=0&e,o=0,0|(x(0|(p=0)),o)):(o=0,0|(x(0|(p=0)),o)):(a&&(i[o>>2]=(h>>>0)%(s>>>0),i[o+4>>2]=0),o=(h>>>0)/(s>>>0)>>>0,0|(x(0|(p=0)),o));a=0==(0|u);do{if(s){if(!a){if((a=(0|b(0|u))-(0|b(0|l))|0)>>>0<=31){s=f=a+1|0,t=h>>>(f>>>0)&(e=a-31>>31)|l<<(u=31-a|0),e&=l>>>(f>>>0),a=0,u=h<<u;break}return o?(i[o>>2]=0|t,i[o+4>>2]=c|0&e,o=0,0|(x(0|(p=0)),o)):(o=0,0|(x(0|(p=0)),o))}if((a=s-1|0)&s|0){s=u=33+(0|b(0|s))-(0|b(0|l))|0,t=(f=32-u|0)-1>>31&l>>>((d=u-32|0)>>>0)|(l<<f|h>>>(u>>>0))&(e=d>>31),e&=l>>>(u>>>0),a=h<<(A=64-u|0)&(c=f>>31),u=(l<<A|h>>>(d>>>0))&c|h<<f&u-33>>31;break}return 0|o&&(i[o>>2]=a&h,i[o+4>>2]=0),1==(0|s)?(A=0|t,0|(x(0|(d=c|0&e)),A)):(d=l>>>((A=0|be(0|s))>>>0)|0,A=l<<32-A|h>>>(A>>>0)|0,0|(x(0|d),A))}if(a)return 0|o&&(i[o>>2]=(l>>>0)%(s>>>0),i[o+4>>2]=0),A=(l>>>0)/(s>>>0)>>>0,0|(x(0|(d=0)),A);if(!h)return 0|o&&(i[o>>2]=0,i[o+4>>2]=(l>>>0)%(u>>>0)),A=(l>>>0)/(u>>>0)>>>0,0|(x(0|(d=0)),A);if(!((a=u-1|0)&u))return 0|o&&(i[o>>2]=0|t,i[o+4>>2]=a&l|0&e),d=0,A=l>>>((0|be(0|u))>>>0),0|(x(0|d),A);if((a=(0|b(0|u))-(0|b(0|l))|0)>>>0<=30){s=e=a+1|0,t=l<<(u=31-a|0)|h>>>(e>>>0),e=l>>>(e>>>0),a=0,u=h<<u;break}return o?(i[o>>2]=0|t,i[o+4>>2]=c|0&e,A=0,0|(x(0|(d=0)),A)):(A=0,0|(x(0|(d=0)),A))}while(0);if(s){l=0|function(t,e,n,r){return 0|(x((e|=0)+(r|=0)+((n=(t|=0)+(n|=0)>>>0)>>>0<t>>>0|0)>>>0|0),0|n)}(0|(f=0|n),0|(h=p|0&r),-1,-1),n=0|w(),c=u,u=0;do{r=c,c=a>>>31|c<<1,a=u|a<<1,_e(0|l,0|n,0|(r=t<<1|r>>>31|0),0|(p=t>>>31|e<<1|0)),u=1&(d=(A=0|w())>>31|((0|A)<0?-1:0)<<1),t=0|_e(0|r,0|p,d&f|0,(((0|A)<0?-1:0)>>31|((0|A)<0?-1:0)<<1)&h|0),e=0|w(),s=s-1|0}while(0!=(0|s));l=c,c=0}else l=u,c=0,u=0;return s=0,0|o&&(i[o>>2]=t,i[o+4>>2]=e),A=-2&(a<<1|0)|u,0|(x(0|(d=(0|a)>>>31|(l|s)<<1|0&(s<<1|a>>>31)|c)),A)}function we(t,e,n,r){var o,a;return a=M,M=M+16|0,xe(t|=0,e|=0,n|=0,r|=0,o=0|a),M=a,0|(x(0|i[o+4>>2]),0|i[o>>2])}function Ee(t,e,n){return t|=0,e|=0,(0|(n|=0))<32?(x(e>>>n|0),t>>>n|(e&(1<<n)-1)<<32-n):(x(0),e>>>n-32|0)}function Oe(t,e,n){return t|=0,e|=0,(0|(n|=0))<32?(x(e<<n|(t&(1<<n)-1<<32-n)>>>32-n|0),t<<n):(x(t<<n-32|0),0)}function Se(t,e){return e=+e,(t=+t)!=t?+e:e!=e?+t:+_(+t,+e)}function Te(t){return(t=+t)>=0?+s(t+.5):+y(t-.5)}function Ce(t,e,n){t|=0,e|=0;var o,a,s=0;if((0|(n|=0))>=8192)return T(0|t,0|e,0|n),0|t;if(a=0|t,o=t+n|0,(3&t)==(3&e)){for(;3&t;){if(!n)return 0|a;r[t>>0]=0|r[e>>0],t=t+1|0,e=e+1|0,n=n-1|0}for(s=(n=-4&o|0)-64|0;(0|t)<=(0|s);)i[t>>2]=i[e>>2],i[t+4>>2]=i[e+4>>2],i[t+8>>2]=i[e+8>>2],i[t+12>>2]=i[e+12>>2],i[t+16>>2]=i[e+16>>2],i[t+20>>2]=i[e+20>>2],i[t+24>>2]=i[e+24>>2],i[t+28>>2]=i[e+28>>2],i[t+32>>2]=i[e+32>>2],i[t+36>>2]=i[e+36>>2],i[t+40>>2]=i[e+40>>2],i[t+44>>2]=i[e+44>>2],i[t+48>>2]=i[e+48>>2],i[t+52>>2]=i[e+52>>2],i[t+56>>2]=i[e+56>>2],i[t+60>>2]=i[e+60>>2],t=t+64|0,e=e+64|0;for(;(0|t)<(0|n);)i[t>>2]=i[e>>2],t=t+4|0,e=e+4|0}else for(n=o-4|0;(0|t)<(0|n);)r[t>>0]=0|r[e>>0],r[t+1>>0]=0|r[e+1>>0],r[t+2>>0]=0|r[e+2>>0],r[t+3>>0]=0|r[e+3>>0],t=t+4|0,e=e+4|0;for(;(0|t)<(0|o);)r[t>>0]=0|r[e>>0],t=t+1|0,e=e+1|0;return 0|a}function Pe(t,e,n){e|=0;var o,a=0,s=0,u=0;if(o=(t|=0)+(n|=0)|0,e&=255,(0|n)>=67){for(;3&t;)r[t>>0]=e,t=t+1|0;for(u=e|e<<8|e<<16|e<<24,s=(a=-4&o|0)-64|0;(0|t)<=(0|s);)i[t>>2]=u,i[t+4>>2]=u,i[t+8>>2]=u,i[t+12>>2]=u,i[t+16>>2]=u,i[t+20>>2]=u,i[t+24>>2]=u,i[t+28>>2]=u,i[t+32>>2]=u,i[t+36>>2]=u,i[t+40>>2]=u,i[t+44>>2]=u,i[t+48>>2]=u,i[t+52>>2]=u,i[t+56>>2]=u,i[t+60>>2]=u,t=t+64|0;for(;(0|t)<(0|a);)i[t>>2]=u,t=t+4|0}for(;(0|t)<(0|o);)r[t>>0]=e,t=t+1|0;return o-n|0}function Me(t){return(t=+t)>=0?+s(t+.5):+y(t-.5)}function Ie(t){t|=0;var e,n,r;return r=0|S(),(0|t)>0&(0|(e=(n=0|i[a>>2])+t|0))<(0|n)|(0|e)<0?(P(0|e),O(12),-1):(0|e)>(0|r)&&!(0|C(0|e))?(O(12),-1):(i[a>>2]=e,0|n)}return{___uremdi3:we,_bitshift64Lshr:Ee,_bitshift64Shl:Oe,_calloc:ve,_cellAreaKm2:function(t,e){var n,r,o,a=0;if(o=M,M=M+192|0,r=o,Ht(t|=0,e|=0,n=o+168|0),Wt(t,e,r),(0|(e=0|i[r>>2]))>0){if(a=+Pt(r+8|0,r+8+((1!=(0|e)&1)<<4)|0,n)+0,1!=(0|e)){t=1;do{a+=+Pt(r+8+(t<<4)|0,r+8+(((0|(t=t+1|0))%(0|e)|0)<<4)|0,n)}while((0|t)<(0|e))}}else a=0;return M=o,6371.007180918475*a*6371.007180918475},_cellAreaM2:function(t,e){var n,r,o,a=0;if(o=M,M=M+192|0,r=o,Ht(t|=0,e|=0,n=o+168|0),Wt(t,e,r),(0|(e=0|i[r>>2]))>0){if(a=+Pt(r+8|0,r+8+((1!=(0|e)&1)<<4)|0,n)+0,1!=(0|e)){t=1;do{a+=+Pt(r+8+(t<<4)|0,r+8+(((0|(t=t+1|0))%(0|e)|0)<<4)|0,n)}while((0|t)<(0|e))}}else a=0;return M=o,6371.007180918475*a*6371.007180918475*1e3*1e3},_cellAreaRads2:function(t,e){var n,r,o,a=0;if(o=M,M=M+192|0,r=o,Ht(t|=0,e|=0,n=o+168|0),Wt(t,e,r),(0|(e=0|i[r>>2]))<=0)return M=o,+(a=0);if(a=+Pt(r+8|0,r+8+((1!=(0|e)&1)<<4)|0,n)+0,1==(0|e))return M=o,+a;t=1;do{a+=+Pt(r+8+(t<<4)|0,r+8+(((0|(t=t+1|0))%(0|e)|0)<<4)|0,n)}while((0|t)<(0|e));return M=o,+a},_compact:function(t,e,n){e|=0;var r,o=0,a=0,s=0,u=0,c=0,l=0,h=0,f=0,p=0,d=0,A=0,g=0,m=0,y=0,v=0,_=0,b=0,x=0,E=0,O=0,S=0;if(!(n|=0))return 0|(O=0);if(o=0|i[(a=t|=0)>>2],!0&0==(15728640&(a=0|i[a+4>>2])|0)){if((0|n)<=0)return 0|(O=0);if(i[(O=e)>>2]=o,i[O+4>>2]=a,1==(0|n))return 0|(O=0);o=1;do{E=0|i[(x=t+(o<<3)|0)+4>>2],i[(O=e+(o<<3)|0)>>2]=i[x>>2],i[O+4>>2]=E,o=o+1|0}while((0|o)!=(0|n));return 0|(o=0)}if(!(E=0|me(x=n<<3)))return 0|(O=-3);if(Ce(0|E,0|t,0|x),!(r=0|ve(n,8)))return ye(E),0|(O=-3);o=n;t:for(;;){_=0|Ee(0|(f=0|i[(u=E)>>2]),0|(u=0|i[u+4>>2]),52),w(),b=(_&=15)+-1|0,v=(0|o)>0;e:do{if(v){if(y=((0|o)<0)<<31>>31,g=0|Oe(0|b,0,52),m=0|w(),b>>>0>15)for(a=0,t=f,n=u;;){if(!(0==(0|t)&0==(0|n))){if(s=0|Ee(0|t,0|n,52),w(),c=(0|(s&=15))<(0|b),s=(0|s)==(0|b),n=0|we(0|(h=c?0:s?t:0),0|(t=c?0:s?n:0),0|o,0|y),w(),0==(0|(l=0|i[(c=s=r+(n<<3)|0)>>2]))&0==(0|(c=0|i[c+4>>2])))n=h;else for(g=0,A=n,d=c,n=h;;){if((0|g)>(0|o)){O=41;break t}if((0|l)==(0|n)&(-117440513&d|0)==(0|t)){h=0|Ee(0|l,0|d,56),w(),p=(h&=7)+1|0,m=0|Ee(0|l,0|d,45),w();n:do{if(0|L(127&m)){if(l=0|Ee(0|l,0|d,52),w(),!(l&=15)){c=6;break}for(c=1;;){if(!(0==((m=0|Oe(7,0,3*(15-c|0)|0))&n|0)&0==((0|w())&t|0))){c=7;break n}if(!(c>>>0<l>>>0)){c=6;break}c=c+1|0}}else c=7}while(0);if((h+2|0)>>>0>c>>>0){O=51;break t}m=0|Oe(0|p,0,56),t=0|w()|-117440513&t,i[(c=s)>>2]=0,i[c+4>>2]=0,c=A,n|=m}else c=(A+1|0)%(0|o)|0;if(0==(0|(l=0|i[(d=s=r+(c<<3)|0)>>2]))&0==(0|(d=0|i[d+4>>2])))break;g=g+1|0,A=c}i[(m=s)>>2]=n,i[m+4>>2]=t}if((0|(a=a+1|0))>=(0|o))break e;t=0|i[(n=E+(a<<3)|0)>>2],n=0|i[n+4>>2]}for(a=0,t=f,n=u;;){if(!(0==(0|t)&0==(0|n))){if(c=0|Ee(0|t,0|n,52),w(),(0|(c&=15))>=(0|b)){if((0|c)!=(0|b)&&(t|=g,n=-15728641&n|m,c>>>0>=_>>>0)){s=b;do{A=0|Oe(7,0,3*(14-s|0)|0),s=s+1|0,t|=A,n=0|w()|n}while(s>>>0<c>>>0)}}else t=0,n=0;if(c=0|we(0|t,0|n,0|o,0|y),w(),!(0==(0|(h=0|i[(l=s=r+(c<<3)|0)>>2]))&0==(0|(l=0|i[l+4>>2]))))for(A=0;;){if((0|A)>(0|o)){O=41;break t}if((0|h)==(0|t)&(-117440513&l|0)==(0|n)){p=0|Ee(0|h,0|l,56),w(),d=(p&=7)+1|0,S=0|Ee(0|h,0|l,45),w();n:do{if(0|L(127&S)){if(h=0|Ee(0|h,0|l,52),w(),!(h&=15)){l=6;break}for(l=1;;){if(!(0==((S=0|Oe(7,0,3*(15-l|0)|0))&t|0)&0==((0|w())&n|0))){l=7;break n}if(!(l>>>0<h>>>0)){l=6;break}l=l+1|0}}else l=7}while(0);if((p+2|0)>>>0>l>>>0){O=51;break t}S=0|Oe(0|d,0,56),n=0|w()|-117440513&n,i[(d=s)>>2]=0,i[d+4>>2]=0,t|=S}else c=(c+1|0)%(0|o)|0;if(0==(0|(h=0|i[(l=s=r+(c<<3)|0)>>2]))&0==(0|(l=0|i[l+4>>2])))break;A=A+1|0}i[(S=s)>>2]=t,i[S+4>>2]=n}if((0|(a=a+1|0))>=(0|o))break e;t=0|i[(n=E+(a<<3)|0)>>2],n=0|i[n+4>>2]}}}while(0);if((o+5|0)>>>0<11){O=99;break}if(!(m=0|ve((0|o)/6|0,8))){O=58;break}e:do{if(v){A=0,d=0;do{if(!(0==(0|(a=0|i[(t=c=r+(A<<3)|0)>>2]))&0==(0|(t=0|i[t+4>>2])))){l=0|Ee(0|a,0|t,56),w(),n=(l&=7)+1|0,h=-117440513&t,S=0|Ee(0|a,0|t,45),w();n:do{if(0|L(127&S)){if(p=0|Ee(0|a,0|t,52),w(),0|(p&=15))for(s=1;;){if(!(0==(a&(S=0|Oe(7,0,3*(15-s|0)|0))|0)&0==(h&(0|w())|0)))break n;if(!(s>>>0<p>>>0))break;s=s+1|0}a|=t=0|Oe(0|n,0,56),t=0|w()|h,i[(n=c)>>2]=a,i[n+4>>2]=t,n=l+2|0}}while(0);7==(0|n)&&(i[(S=m+(d<<3)|0)>>2]=a,i[S+4>>2]=-117440513&t,d=d+1|0)}A=A+1|0}while((0|A)!=(0|o));if(v){if(g=((0|o)<0)<<31>>31,p=0|Oe(0|b,0,52),A=0|w(),b>>>0>15)for(t=0,a=0;;){do{if(!(0==(0|f)&0==(0|u))){for(l=0|Ee(0|f,0|u,52),w(),s=(0|(l&=15))<(0|b),l=(0|l)==(0|b),s=0|we(0|(c=s?0:l?f:0),0|(l=s?0:l?u:0),0|o,0|g),w(),n=0;;){if((0|n)>(0|o)){O=98;break t}if((-117440513&(h=0|i[(S=r+(s<<3)|0)+4>>2])|0)==(0|l)&&(0|i[S>>2])==(0|c)){O=70;break}if((0|i[(S=r+((s=(s+1|0)%(0|o)|0)<<3)|0)>>2])==(0|c)&&(0|i[S+4>>2])==(0|l))break;n=n+1|0}if(70==(0|O)&&(O=0,!0&100663296==(117440512&h|0)))break;i[(S=e+(a<<3)|0)>>2]=f,i[S+4>>2]=u,a=a+1|0}}while(0);if((0|(t=t+1|0))>=(0|o)){o=d;break e}f=0|i[(u=E+(t<<3)|0)>>2],u=0|i[u+4>>2]}for(t=0,a=0;;){do{if(!(0==(0|f)&0==(0|u))){if(l=0|Ee(0|f,0|u,52),w(),(0|(l&=15))>=(0|b))if((0|l)!=(0|b))if(n=f|p,s=-15728641&u|A,l>>>0<_>>>0)l=s;else{c=b;do{S=0|Oe(7,0,3*(14-c|0)|0),c=c+1|0,n|=S,s=0|w()|s}while(c>>>0<l>>>0);l=s}else n=f,l=u;else n=0,l=0;for(c=0|we(0|n,0|l,0|o,0|g),w(),s=0;;){if((0|s)>(0|o)){O=98;break t}if((-117440513&(h=0|i[(S=r+(c<<3)|0)+4>>2])|0)==(0|l)&&(0|i[S>>2])==(0|n)){O=93;break}if((0|i[(S=r+((c=(c+1|0)%(0|o)|0)<<3)|0)>>2])==(0|n)&&(0|i[S+4>>2])==(0|l))break;s=s+1|0}if(93==(0|O)&&(O=0,!0&100663296==(117440512&h|0)))break;i[(S=e+(a<<3)|0)>>2]=f,i[S+4>>2]=u,a=a+1|0}}while(0);if((0|(t=t+1|0))>=(0|o)){o=d;break e}f=0|i[(u=E+(t<<3)|0)>>2],u=0|i[u+4>>2]}}else a=0,o=d}else a=0,o=0}while(0);if(Pe(0|r,0,0|x),Ce(0|E,0|m,o<<3|0),ye(m),!o)break;e=e+(a<<3)|0}return 41==(0|O)?(ye(E),ye(r),0|(S=-1)):51==(0|O)?(ye(E),ye(r),0|(S=-2)):58==(0|O)?(ye(E),ye(r),0|(S=-3)):98==(0|O)?(ye(m),ye(E),ye(r),0|(S=-1)):(99==(0|O)&&Ce(0|e,0|E,o<<3|0),ye(E),ye(r),0|(S=0))},_destroyLinkedPolygon:function(t){var e=0,n=0,r=0,o=0;if(t|=0)for(r=1;;){if(0|(e=0|i[t>>2]))do{if(0|(n=0|i[e>>2]))do{o=n,n=0|i[n+16>>2],ye(o)}while(0!=(0|n));o=e,e=0|i[e+8>>2],ye(o)}while(0!=(0|e));if(e=t,t=0|i[t+8>>2],r||ye(e),!t)break;r=0}},_edgeLengthKm:function(t){return+ +o[20752+((t|=0)<<3)>>3]},_edgeLengthM:function(t){return+ +o[20880+((t|=0)<<3)>>3]},_emscripten_replace_memory:function(t){return r=new Int8Array(t),new Uint8Array(t),i=new Int32Array(t),new Float32Array(t),o=new Float64Array(t),n=t,!0},_exactEdgeLengthKm:function(t,e){var n,r,a=0,s=0,u=0,l=0,p=0,d=0;if(r=M,M=M+176|0,Zt(t|=0,e|=0,n=r),(0|(t=0|i[n>>2]))<=1)return M=r,+(u=0);e=t+-1|0,t=0,a=0,s=+o[n+8>>3],u=+o[n+16>>3];do{p=s,s=+o[n+8+((t=t+1|0)<<4)>>3],d=+f(.5*(s-p)),l=u,u=+o[n+8+(t<<4)+8>>3],l=d*d+(l=+f(.5*(u-l)))*(+h(+p)*+h(+s)*l),a+=2*+m(+ +c(+l),+ +c(+(1-l)))}while((0|t)!=(0|e));return M=r,+(d=6371.007180918475*a)},_exactEdgeLengthM:function(t,e){var n,r,a=0,s=0,u=0,l=0,p=0,d=0;if(r=M,M=M+176|0,Zt(t|=0,e|=0,n=r),(0|(t=0|i[n>>2]))<=1)return M=r,+(u=0);e=t+-1|0,t=0,a=0,s=+o[n+8>>3],u=+o[n+16>>3];do{p=s,s=+o[n+8+((t=t+1|0)<<4)>>3],d=+f(.5*(s-p)),l=u,u=+o[n+8+(t<<4)+8>>3],l=d*d+(l=+f(.5*(u-l)))*(+h(+p)*+h(+s)*l),a+=2*+m(+ +c(+l),+ +c(+(1-l)))}while((0|t)!=(0|e));return M=r,+(d=6371.007180918475*a*1e3)},_exactEdgeLengthRads:function(t,e){var n,r,a=0,s=0,u=0,l=0,p=0,d=0;if(r=M,M=M+176|0,Zt(t|=0,e|=0,n=r),(0|(t=0|i[n>>2]))<=1)return M=r,+(u=0);e=t+-1|0,t=0,a=0,s=+o[n+8>>3],u=+o[n+16>>3];do{p=s,s=+o[n+8+((t=t+1|0)<<4)>>3],d=+f(.5*(s-p)),l=u,u=+o[n+8+(t<<4)+8>>3],l=d*d+(l=+f(.5*(u-l)))*(+h(+s)*+h(+p)*l),a+=2*+m(+ +c(+l),+ +c(+(1-l)))}while((0|t)<(0|e));return M=r,+a},_experimentalH3ToLocalIj:function(t,e,n,r,i){var o,a;return i|=0,a=M,M=M+16|0,(t=0|$t(t|=0,e|=0,n|=0,r|=0,o=a))||(pt(o,i),t=0),M=a,0|t},_experimentalLocalIjToH3:function(t,e,n,r){var i,o;return t|=0,e|=0,r|=0,i=M,M=M+16|0,dt(n|=0,o=i),r=0|te(t,e,o,r),M=i,0|r},_free:ye,_geoToH3:Nt,_getDestinationH3IndexFromUnidirectionalEdge:function(t,e){t|=0;var n,r,o=0;return n=M,M=M+16|0,o=n,!0&268435456==(2013265920&(e|=0)|0)?(r=0|Ee(0|t,0|e,56),w(),i[o>>2]=0,o=0|k(t,-2130706433&e|134217728,7&r,o),e=0|w(),x(0|e),M=n,0|o):(o=0,x(0|(e=0)),M=n,0|o)},_getH3IndexesFromUnidirectionalEdge:function(t,e,n){t|=0;var r,o,a,s,u=0;a=M,M=M+16|0,r=a,s=!0&268435456==(2013265920&(e|=0)|0),o=-2130706433&e|134217728,i[(u=n|=0)>>2]=s?t:0,i[u+4>>2]=s?o:0,s?(e=0|Ee(0|t,0|e,56),w(),i[r>>2]=0,t=0|k(t,o,7&e,r),e=0|w()):(t=0,e=0),i[(u=n+8|0)>>2]=t,i[u+4>>2]=e,M=a},_getH3UnidirectionalEdge:function(t,e,n,r){var o,a,s=0,u=0,c=0,l=0,h=0;if(a=M,M=M+16|0,o=a,!(0|Xt(t|=0,e|=0,n|=0,r|=0)))return l=0,x(0|(c=0)),M=a,0|l;for(c=-2130706433&e,s=(s=0==(0|kt(t,e)))?1:2;i[o>>2]=0,u=s+1|0,!((0|(h=0|k(t,e,s,o)))==(0|n)&(0|w())==(0|r));){if(!(u>>>0<7)){s=0,t=0,l=6;break}s=u}return 6==(0|l)?(x(0|s),M=a,0|t):(h=0|Oe(0|s,0,56),l=0|c|w()|268435456,h|=t,x(0|l),M=a,0|h)},_getH3UnidirectionalEdgeBoundary:Zt,_getH3UnidirectionalEdgesFromHexagon:function(t,e,n){n|=0;var r,o=0;r=0==(0|kt(t|=0,e|=0)),e&=-2130706433,i[(o=n)>>2]=r?t:0,i[o+4>>2]=r?285212672|e:0,i[(o=n+8|0)>>2]=t,i[o+4>>2]=301989888|e,i[(o=n+16|0)>>2]=t,i[o+4>>2]=318767104|e,i[(o=n+24|0)>>2]=t,i[o+4>>2]=335544320|e,i[(o=n+32|0)>>2]=t,i[o+4>>2]=352321536|e,i[(n=n+40|0)>>2]=t,i[n+4>>2]=369098752|e},_getOriginH3IndexFromUnidirectionalEdge:function(t,e){var n;return t|=0,x(0|((n=!0&268435456==(2013265920&(e|=0)|0))?-2130706433&e|134217728:0)),0|(n?t:0)},_getPentagonIndexes:qt,_getRes0Indexes:function(t){t|=0;var e=0,n=0,r=0;e=0;do{Oe(0|e,0,45),r=134225919|w(),i[(n=t+(e<<3)|0)>>2]=-1,i[n+4>>2]=r,e=e+1|0}while(122!=(0|e))},_h3Distance:function(t,e,n,r){var i,o,a;return n|=0,r|=0,a=M,M=M+32|0,o=a,t=0==(0|$t(t|=0,e|=0,t,e,i=a+12|0))&&0==(0|$t(t,e,n,r,o))?0|ft(i,o):-1,M=a,0|t},_h3GetBaseCell:Mt,_h3GetFaces:function t(e,n,r){r|=0;var o,a=0,s=0,u=0,c=0,l=0,h=0,f=0,p=0;o=M,M=M+128|0,f=o+112|0,u=o+96|0,p=o,s=0|Ee(0|(e|=0),0|(n|=0),52),w(),l=15&s,i[f>>2]=l,c=0|Ee(0|e,0|n,45),w(),c&=127;t:do{if(0|L(c)){if(0|l)for(a=1;;){if(!(0==((h=0|Oe(7,0,3*(15-a|0)|0))&e|0)&0==((0|w())&n|0))){s=0;break t}if(!(a>>>0<l>>>0))break;a=a+1|0}if(!(1&s))return h=0|Oe(l+1|0,0,52),p=0|w()|-15728641&n,t((h|e)&~(f=0|Oe(7,0,3*(14-l|0)|0)),p&~(0|w()),r),void(M=o);s=1}else s=0}while(0);Vt(e,n,u),s?(bt(u,f,p),h=5):(Ot(u,f,p),h=6);t:do{if(0|L(c))if(l)for(a=1;;){if(!(0==((c=0|Oe(7,0,3*(15-a|0)|0))&e|0)&0==((0|w())&n|0))){a=8;break t}if(!(a>>>0<l>>>0)){a=20;break}a=a+1|0}else a=20;else a=8}while(0);if(Pe(0|r,-1,0|a),s){s=0;do{for(wt(u=p+(s<<4)|0,0|i[f>>2]),u=0|i[u>>2],a=0;!(-1==(0|(l=0|i[(c=r+(a<<2)|0)>>2]))|(0|l)==(0|u));)a=a+1|0;i[c>>2]=u,s=s+1|0}while((0|s)!=(0|h))}else{s=0;do{for(xt(u=p+(s<<4)|0,0|i[f>>2],0,1),u=0|i[u>>2],a=0;!(-1==(0|(l=0|i[(c=r+(a<<2)|0)>>2]))|(0|l)==(0|u));)a=a+1|0;i[c>>2]=u,s=s+1|0}while((0|s)!=(0|h))}M=o},_h3GetResolution:function(t,e){return e=0|Ee(0|(t|=0),0|(e|=0),52),w(),15&e|0},_h3IndexesAreNeighbors:Xt,_h3IsPentagon:kt,_h3IsResClassIII:function(t,e){return e=0|Ee(0|(t|=0),0|(e|=0),52),w(),1&e|0},_h3IsValid:It,_h3Line:function(t,e,n,r,o){n|=0,r|=0,o|=0;var a,s=0,c=0,l=0,h=0,f=0,p=0,d=0,A=0,g=0,m=0,y=0,v=0,_=0,b=0,x=0,w=0,E=0;if(a=M,M=M+48|0,c=a+12|0,w=a,0==(0|$t(t|=0,e|=0,t,e,s=a+24|0))&&0==(0|$t(t,e,n,r,c))){if((0|(x=0|ft(s,c)))<0)return M=a,0|(w=x);for(i[s>>2]=0,i[s+4>>2]=0,i[s+8>>2]=0,i[c>>2]=0,i[c+4>>2]=0,i[c+8>>2]=0,$t(t,e,t,e,s),$t(t,e,n,r,c),At(s),At(c),x?(g=+(0|x),b=s,n=p=0|i[s>>2],r=d=0|i[(v=s+4|0)>>2],s=A=0|i[(_=s+8|0)>>2],m=+((0|i[c>>2])-p|0)/g,y=+((0|i[c+4>>2])-d|0)/g,g=+((0|i[c+8>>2])-A|0)/g):(v=r=s+4|0,_=A=s+8|0,b=s,n=0|i[s>>2],r=0|i[r>>2],s=0|i[A>>2],m=0,y=0,g=0),i[w>>2]=n,i[(A=w+4|0)>>2]=r,i[(d=w+8|0)>>2]=s,p=0;;){E=m*(h=+(0|p))+ +(0|n),l=y*h+ +(0|i[v>>2]),h=g*h+ +(0|i[_>>2]),r=~~+Te(+E),c=~~+Te(+l),n=~~+Te(+h),E=+u(+(+(0|r)-E)),l=+u(+(+(0|c)-l)),h=+u(+(+(0|n)-h));do{if(!(E>l&E>h)){if(f=0-r|0,l>h){s=f-n|0;break}s=c,n=f-c|0;break}r=0-(c+n)|0,s=c}while(0);if(i[w>>2]=r,i[A>>2]=s,i[d>>2]=n,gt(w),te(t,e,w,o+(p<<3)|0),(0|p)==(0|x))break;p=p+1|0,n=0|i[b>>2]}return M=a,0|(w=0)}return M=a,0|(w=-1)},_h3LineSize:function(t,e,n,r){var i,o,a;return n|=0,r|=0,a=M,M=M+32|0,o=a,t=0==(0|$t(t|=0,e|=0,t,e,i=a+12|0))&&0==(0|$t(t,e,n,r,o))?0|ft(i,o):-1,M=a,(t>>>31^1)+t|0},_h3SetToLinkedGeo:function(t,e,n){n|=0;var r,o,a,s=0;if(a=M,M=M+32|0,r=a,function(t,e,n){t|=0,n|=0;var r,o,a=0,s=0,u=0,c=0,l=0;if(o=M,M=M+176|0,r=o,(0|(e|=0))<1)return ce(n,0,0),void(M=o);c=0|Ee(0|i[(c=t)>>2],0|i[c+4>>2],52),w(),ce(n,(0|e)>6?e:6,15&c),c=0;do{if(Wt(0|i[(a=t+(c<<3)|0)>>2],0|i[a+4>>2],r),(0|(a=0|i[r>>2]))>0){l=0;do{u=r+8+(l<<4)|0,(s=0|de(n,a=r+8+(((0|(l=l+1|0))%(0|a)|0)<<4)|0,u))?fe(n,s):pe(n,u,a),a=0|i[r>>2]}while((0|l)<(0|a))}c=c+1|0}while((0|c)!=(0|e));M=o}(t|=0,e|=0,o=a+16|0),i[n>>2]=0,i[n+4>>2]=0,i[n+8>>2]=0,!(t=0|he(o)))return Kt(n),le(o),void(M=a);do{e=0|Jt(n);do{Qt(e,t),s=t+16|0,i[r>>2]=i[s>>2],i[r+4>>2]=i[s+4>>2],i[r+8>>2]=i[s+8>>2],i[r+12>>2]=i[s+12>>2],fe(o,t),t=0|Ae(o,r)}while(0!=(0|t));t=0|he(o)}while(0!=(0|t));Kt(n),le(o),M=a},_h3ToCenterChild:function(t,e,n){n|=0;var r=0,i=0;if(r=0|Ee(0|(t|=0),0|(e|=0),52),w(),(0|n)<16&(0|(r&=15))<=(0|n)){if((0|r)!=(0|n)&&(t|=i=0|Oe(0|n,0,52),e=0|w()|-15728641&e,(0|r)<(0|n)))do{i=0|Oe(7,0,3*(14-r|0)|0),r=r+1|0,t&=~i,e&=~(0|w())}while((0|r)<(0|n))}else e=0,t=0;return x(0|e),0|t},_h3ToChildren:Rt,_h3ToGeo:Ht,_h3ToGeoBoundary:Wt,_h3ToParent:Bt,_h3UnidirectionalEdgeIsValid:function(t,e){var n=0;if(!(!0&268435456==(2013265920&(e|=0)|0)))return 0|(n=0);switch(n=0|Ee(0|(t|=0),0|e,56),w(),7&n){case 0:case 7:return 0|(n=0)}return!0&16777216==(117440512&e|0)&0!=(0|kt(t,n=-2130706433&e|134217728))?0|(n=0):0|(n=0|It(t,n))},_hexAreaKm2:function(t){return+ +o[20496+((t|=0)<<3)>>3]},_hexAreaM2:function(t){return+ +o[20624+((t|=0)<<3)>>3]},_hexRing:function(t,e,n,r){t|=0,e|=0,r|=0;var o,a=0,s=0,u=0,c=0,l=0,h=0,f=0;if(o=M,M=M+16|0,f=o,!(n|=0))return i[(f=r)>>2]=t,i[f+4>>2]=e,M=o,0|(f=0);i[f>>2]=0;t:do{if(0|kt(t,e))t=1;else{if(s=(0|n)>0){a=0,h=t;do{if(0==(0|(h=0|k(h,e,4,f)))&0==(0|(e=0|w()))){t=2;break t}if(a=a+1|0,0|kt(h,e)){t=1;break t}}while((0|a)<(0|n));if(i[(l=r)>>2]=h,i[l+4>>2]=e,l=n+-1|0,s){s=0,u=1,a=h,t=e;do{if(0==(0|(a=0|k(a,t,2,f)))&0==(0|(t=0|w()))){t=2;break t}if(i[(c=r+(u<<3)|0)>>2]=a,i[c+4>>2]=t,u=u+1|0,0|kt(a,t)){t=1;break t}s=s+1|0}while((0|s)<(0|n));c=0,s=u;do{if(0==(0|(a=0|k(a,t,3,f)))&0==(0|(t=0|w()))){t=2;break t}if(i[(u=r+(s<<3)|0)>>2]=a,i[u+4>>2]=t,s=s+1|0,0|kt(a,t)){t=1;break t}c=c+1|0}while((0|c)<(0|n));u=0;do{if(0==(0|(a=0|k(a,t,1,f)))&0==(0|(t=0|w()))){t=2;break t}if(i[(c=r+(s<<3)|0)>>2]=a,i[c+4>>2]=t,s=s+1|0,0|kt(a,t)){t=1;break t}u=u+1|0}while((0|u)<(0|n));u=0;do{if(0==(0|(a=0|k(a,t,5,f)))&0==(0|(t=0|w()))){t=2;break t}if(i[(c=r+(s<<3)|0)>>2]=a,i[c+4>>2]=t,s=s+1|0,0|kt(a,t)){t=1;break t}u=u+1|0}while((0|u)<(0|n));u=0;do{if(0==(0|(a=0|k(a,t,4,f)))&0==(0|(t=0|w()))){t=2;break t}if(i[(c=r+(s<<3)|0)>>2]=a,i[c+4>>2]=t,s=s+1|0,0|kt(a,t)){t=1;break t}u=u+1|0}while((0|u)<(0|n));for(u=0;;){if(0==(0|(a=0|k(a,t,6,f)))&0==(0|(t=0|w()))){t=2;break t}if((0|u)!=(0|l)){if(i[(c=r+(s<<3)|0)>>2]=a,i[c+4>>2]=t,0|kt(a,t)){t=1;break t}s=s+1|0}if((0|(u=u+1|0))>=(0|n)){u=h,s=e;break}}}else u=h,a=h,s=e,t=e}else i[(u=r)>>2]=t,i[u+4>>2]=e,u=t,a=t,s=e,t=e;t=1&((0|u)!=(0|a)|(0|s)!=(0|t))}}while(0);return M=o,0|(f=t)},_i64Subtract:_e,_kRing:I,_kRingDistances:function(t,e,n,r,i){var o;if(0|B(t|=0,e|=0,n|=0,r|=0,i|=0)){if(Pe(0|r,0,(o=1+(0|v(3*n|0,n+1|0))|0)<<3|0),0|i)return Pe(0|i,0,o<<2|0),void R(t,e,n,r,i,o,0);(i=0|ve(o,4))&&(R(t,e,n,r,i,o,0),ye(i))}},_llvm_minnum_f64:Se,_llvm_round_f64:Te,_malloc:me,_maxFaceCount:function(t,e){var n=0,r=0;if(r=0|Ee(0|(t|=0),0|(e|=0),45),w(),!(0|L(127&r)))return 0|(r=2);if(r=0|Ee(0|t,0|e,52),w(),!(r&=15))return 0|(r=5);for(n=1;;){if(!(0==((0|Oe(7,0,3*(15-n|0)|0))&t|0)&0==((0|w())&e|0))){n=2,t=6;break}if(!(n>>>0<r>>>0)){n=5,t=6;break}n=n+1|0}return 6==(0|t)?0|n:0},_maxH3ToChildrenSize:function(t,e,n){return n|=0,t=0|Ee(0|(t|=0),0|(e|=0),52),w(),(0|n)<16&(0|(t&=15))<=(0|n)?0|(n=0|ee(7,n-t|0)):0|(n=0)},_maxKringSize:function(t){return 1+(0|v(3*(t|=0)|0,t+1|0))|0},_maxPolyfillSize:function(t,e){e|=0;var n,r=0,o=0,a=0,s=0,u=0;if(n=M,M=M+48|0,a=n+8|0,o=n,s=0|i[(u=t|=0)+4>>2],i[(r=o)>>2]=i[u>>2],i[r+4>>2]=s,re(o,a),a=0|W(a,e),e=0|i[o>>2],(0|(o=0|i[t+8>>2]))<=0)return M=n,0|(u=(u=(s=(0|a)<(0|(u=e)))?u:a)+12|0);r=0|i[t+12>>2],t=0;do{e=(0|i[r+(t<<3)>>2])+e|0,t=t+1|0}while((0|t)<(0|o));return M=n,0|(u=(u=(u=(0|a)<(0|e))?e:a)+12|0)},_maxUncompactSize:function(t,e,n){t|=0,n|=0;var r=0,o=0,a=0,s=0;if((0|(e|=0))<=0)return 0|(n=0);if((0|n)>=16){for(r=0;;){if(!(0==(0|i[(s=t+(r<<3)|0)>>2])&0==(0|i[s+4>>2]))){r=-1,o=13;break}if((0|(r=r+1|0))>=(0|e)){r=0,o=13;break}}if(13==(0|o))return 0|r}r=0,s=0;t:for(;;){a=0|i[(o=t+(s<<3)|0)>>2],o=0|i[o+4>>2];do{if(!(0==(0|a)&0==(0|o))){if(o=0|Ee(0|a,0|o,52),w(),(0|(o&=15))>(0|n)){r=-1,o=13;break t}if((0|o)==(0|n)){r=r+1|0;break}r=(0|ee(7,n-o|0))+r|0;break}}while(0);if((0|(s=s+1|0))>=(0|e)){o=13;break}}return 13==(0|o)?0|r:0},_memcpy:Ce,_memset:Pe,_numHexagons:function(t){var e;return t=0|i[(e=21008+((t|=0)<<3)|0)>>2],x(0|i[e+4>>2]),0|t},_pentagonIndexCount:function(){return 12},_pointDistKm:Ct,_pointDistM:function(t,e){t|=0;var n,r,i,a=0;return r=+o[(e|=0)>>3],n=+o[t>>3],a=(i=+f(.5*(r-n)))*i+(a=+f(.5*(+o[e+8>>3]-+o[t+8>>3])))*(+h(+r)*+h(+n)*a),2*+m(+ +c(+a),+ +c(+(1-a)))*6371.007180918475*1e3},_pointDistRads:function(t,e){t|=0;var n,r,i,a=0;return r=+o[(e|=0)>>3],n=+o[t>>3],a=(i=+f(.5*(r-n)))*i+(a=+f(.5*(+o[e+8>>3]-+o[t+8>>3])))*(+h(+r)*+h(+n)*a),2*+m(+ +c(+a),+ +c(+(1-a)))},_polyfill:function(t,e,n){var r,o=0,a=0,s=0,u=0,c=0;if(r=M,M=M+48|0,o=r+8|0,a=r,0|function(t,e,n){e|=0,n|=0;var r,o,a,s,u,c=0,l=0,h=0,f=0,p=0,d=0,A=0,g=0,m=0,y=0,v=0,_=0,b=0,x=0,O=0,S=0,T=0,C=0,P=0,I=0,k=0,L=0,j=0,F=0,z=0;u=M,M=M+112|0,o=u+80|0,d=u+72|0,a=u,s=u+56|0,(z=0|me(32+(i[(A=(t=t|0)+8|0)>>2]<<5)|0))||E(22848,22448,800,22456);if(ie(t,z),c=0|i[(h=t)+4>>2],i[(p=d)>>2]=i[h>>2],i[p+4>>2]=c,re(d,o),p=0|W(o,e),c=0|i[d>>2],(0|(h=0|i[A>>2]))>0){f=0|i[t+12>>2],l=0;do{c=(0|i[f+(l<<3)>>2])+c|0,l=l+1|0}while((0|l)!=(0|h))}if(l=0|ve(r=(p=(0|p)<(0|c)?c:p)+12|0,8),g=0|ve(r,8),i[o>>2]=0,F=0|i[(j=t)+4>>2],i[(c=d)>>2]=i[j>>2],i[c+4>>2]=F,0|(c=0|D(d,r,e,o,l,g)))return ye(l),ye(g),ye(z),M=u,0|(z=c);t:do{if((0|i[A>>2])>0){for(h=t+12|0,c=0;f=0|D((0|i[h>>2])+(c<<3)|0,r,e,o,l,g),c=c+1|0,!(0|f);)if((0|c)>=(0|i[A>>2]))break t;return ye(l),ye(g),ye(z),M=u,0|(z=f)}}while(0);(0|p)>-12&&Pe(0|g,0,((0|r)>1?r:1)<<3|0);t:do{if((0|i[o>>2])>0){F=((0|r)<0)<<31>>31,C=l,P=g,I=l,k=l,L=g,j=l,c=l,x=l,O=g,S=g,T=g,l=g;e:for(;;){for(b=0|i[o>>2],v=0,_=0,h=0;;){p=(f=a)+56|0;do{i[f>>2]=0,f=f+4|0}while((0|f)<(0|p));if(d=0|i[(e=C+(v<<3)|0)>>2],e=0|i[e+4>>2],0|B(d,e,1,a,0)){p=(f=a)+56|0;do{i[f>>2]=0,f=f+4|0}while((0|f)<(0|p));0|(f=0|ve(7,4))&&(R(d,e,1,a,f,7,0),ye(f))}y=0;do{g=0|i[(m=a+(y<<3)|0)>>2],m=0|i[m+4>>2];n:do{if(!(0==(0|g)&0==(0|m))){if(d=0|we(0|g,0|m,0|r,0|F),w(),e=0|i[(p=f=n+(d<<3)|0)>>2],p=0|i[p+4>>2],!(0==(0|e)&0==(0|p)))for(A=0;;){if((0|A)>(0|r))break e;if((0|e)==(0|g)&(0|p)==(0|m))break n;if(e=0|i[(p=f=n+((d=(d+1|0)%(0|r)|0)<<3)|0)>>2],p=0|i[p+4>>2],0==(0|e)&0==(0|p))break;A=A+1|0}0==(0|g)&0==(0|m)||(Ht(g,m,s),0|oe(t,z,s)&&(i[(A=f)>>2]=g,i[A+4>>2]=m,i[(A=P+(h<<3)|0)>>2]=g,i[A+4>>2]=m,h=h+1|0))}}while(0);y=y+1|0}while(y>>>0<7);if((0|(_=_+1|0))>=(0|b))break;v=v+1|0}if((0|b)>0&&Pe(0|I,0,b<<3|0),i[o>>2]=h,!((0|h)>0))break t;g=l,m=T,y=j,v=S,_=O,b=P,l=x,T=c,S=k,O=I,x=g,c=m,j=L,L=y,k=v,I=_,P=C,C=b}return ye(k),ye(L),ye(z),M=u,0|(z=-1)}c=g}while(0);return ye(z),ye(l),ye(c),M=u,0|(z=0)}(t|=0,e|=0,n|=0)){if(s=0|i[(c=t)+4>>2],i[(u=a)>>2]=i[c>>2],i[u+4>>2]=s,re(a,o),u=0|W(o,e),e=0|i[a>>2],(0|(s=0|i[t+8>>2]))>0){a=0|i[t+12>>2],o=0;do{e=(0|i[a+(o<<3)>>2])+e|0,o=o+1|0}while((0|o)!=(0|s))}(0|(e=(0|u)<(0|e)?e:u))<=-12||Pe(0|n,0,8+(((0|(c=e+11|0))>0?c:0)<<3)|0),M=r}else M=r},_res0IndexCount:function(){return 122},_round:Me,_sbrk:Ie,_sizeOfCoordIJ:function(){return 8},_sizeOfGeoBoundary:function(){return 168},_sizeOfGeoCoord:function(){return 16},_sizeOfGeoPolygon:function(){return 16},_sizeOfGeofence:function(){return 8},_sizeOfH3Index:function(){return 8},_sizeOfLinkedGeoPolygon:function(){return 12},_uncompact:function(t,e,n,r,o){t|=0,n|=0,r|=0,o|=0;var a=0,s=0,u=0,c=0,l=0,h=0;if((0|(e|=0))<=0)return 0|(o=0);if((0|o)>=16){for(a=0;;){if(!(0==(0|i[(h=t+(a<<3)|0)>>2])&0==(0|i[h+4>>2]))){a=14;break}if((0|(a=a+1|0))>=(0|e)){s=0,a=16;break}}if(14==(0|a))return 0|((0|r)>0?-2:-1);if(16==(0|a))return 0|s}a=0,h=0;t:for(;;){s=0|i[(u=l=t+(h<<3)|0)>>2],u=0|i[u+4>>2];do{if(!(0==(0|s)&0==(0|u))){if((0|a)>=(0|r)){s=-1,a=16;break t}if(c=0|Ee(0|s,0|u,52),w(),(0|(c&=15))>(0|o)){s=-2,a=16;break t}if((0|c)==(0|o)){i[(l=n+(a<<3)|0)>>2]=s,i[l+4>>2]=u,a=a+1|0;break}if((0|(s=(0|ee(7,o-c|0))+a|0))>(0|r)){s=-1,a=16;break t}Rt(0|i[l>>2],0|i[l+4>>2],o,n+(a<<3)|0),a=s}}while(0);if((0|(h=h+1|0))>=(0|e)){s=0,a=16;break}}return 16==(0|a)?0|s:0},establishStackSpace:function(t,e){M=t|=0},stackAlloc:function(t){var e;return e=M,M=(M=M+(t|=0)|0)+15&-16,0|e},stackRestore:function(t){M=t|=0},stackSave:function(){return 0|M}}}({Math:Math,Int8Array:Int8Array,Int32Array:Int32Array,Uint8Array:Uint8Array,Float32Array:Float32Array,Float64Array:Float64Array},{a:ut,b:function(t){c=t},c:l,d:function(t,e,n,r){ut("Assertion failed: "+A(t)+", at: "+[e?A(e):"unknown filename",n,r?A(r):"unknown function"])},e:function(t){return n.___errno_location&&(_[n.___errno_location()>>2]=t),t},f:q,g:function(t,e,n){y.set(y.subarray(e,e+n),t)},h:function(t){var e=q();if(t>2130706432)return!1;for(var n=Math.max(e,16777216);n<t;)n=n<=536870912?w(2*n,16777216):Math.min(w((3*n+2147483648)/4,16777216),2130706432);return!!X(n)},i:function(t){ut("OOM")},j:V,k:H,l:X,m:W,n:function(){var t=W();return n.extraStackTrace&&(t+="\n"+n.extraStackTrace()),H(t)},o:24032,p:24016},g),$=(n.___uremdi3=Y.___uremdi3,n._bitshift64Lshr=Y._bitshift64Lshr,n._bitshift64Shl=Y._bitshift64Shl,n._calloc=Y._calloc,n._cellAreaKm2=Y._cellAreaKm2,n._cellAreaM2=Y._cellAreaM2,n._cellAreaRads2=Y._cellAreaRads2,n._compact=Y._compact,n._destroyLinkedPolygon=Y._destroyLinkedPolygon,n._edgeLengthKm=Y._edgeLengthKm,n._edgeLengthM=Y._edgeLengthM,n._emscripten_replace_memory=Y._emscripten_replace_memory),tt=(n._exactEdgeLengthKm=Y._exactEdgeLengthKm,n._exactEdgeLengthM=Y._exactEdgeLengthM,n._exactEdgeLengthRads=Y._exactEdgeLengthRads,n._experimentalH3ToLocalIj=Y._experimentalH3ToLocalIj,n._experimentalLocalIjToH3=Y._experimentalLocalIjToH3,n._free=Y._free,n._geoToH3=Y._geoToH3,n._getDestinationH3IndexFromUnidirectionalEdge=Y._getDestinationH3IndexFromUnidirectionalEdge,n._getH3IndexesFromUnidirectionalEdge=Y._getH3IndexesFromUnidirectionalEdge,n._getH3UnidirectionalEdge=Y._getH3UnidirectionalEdge,n._getH3UnidirectionalEdgeBoundary=Y._getH3UnidirectionalEdgeBoundary,n._getH3UnidirectionalEdgesFromHexagon=Y._getH3UnidirectionalEdgesFromHexagon,n._getOriginH3IndexFromUnidirectionalEdge=Y._getOriginH3IndexFromUnidirectionalEdge,n._getPentagonIndexes=Y._getPentagonIndexes,n._getRes0Indexes=Y._getRes0Indexes,n._h3Distance=Y._h3Distance,n._h3GetBaseCell=Y._h3GetBaseCell,n._h3GetFaces=Y._h3GetFaces,n._h3GetResolution=Y._h3GetResolution,n._h3IndexesAreNeighbors=Y._h3IndexesAreNeighbors,n._h3IsPentagon=Y._h3IsPentagon,n._h3IsResClassIII=Y._h3IsResClassIII,n._h3IsValid=Y._h3IsValid,n._h3Line=Y._h3Line,n._h3LineSize=Y._h3LineSize,n._h3SetToLinkedGeo=Y._h3SetToLinkedGeo,n._h3ToCenterChild=Y._h3ToCenterChild,n._h3ToChildren=Y._h3ToChildren,n._h3ToGeo=Y._h3ToGeo,n._h3ToGeoBoundary=Y._h3ToGeoBoundary,n._h3ToParent=Y._h3ToParent,n._h3UnidirectionalEdgeIsValid=Y._h3UnidirectionalEdgeIsValid,n._hexAreaKm2=Y._hexAreaKm2,n._hexAreaM2=Y._hexAreaM2,n._hexRing=Y._hexRing,n._i64Subtract=Y._i64Subtract,n._kRing=Y._kRing,n._kRingDistances=Y._kRingDistances,n._llvm_minnum_f64=Y._llvm_minnum_f64,n._llvm_round_f64=Y._llvm_round_f64,n._malloc=Y._malloc,n._maxFaceCount=Y._maxFaceCount,n._maxH3ToChildrenSize=Y._maxH3ToChildrenSize,n._maxKringSize=Y._maxKringSize,n._maxPolyfillSize=Y._maxPolyfillSize,n._maxUncompactSize=Y._maxUncompactSize,n._memcpy=Y._memcpy,n._memset=Y._memset,n._numHexagons=Y._numHexagons,n._pentagonIndexCount=Y._pentagonIndexCount,n._pointDistKm=Y._pointDistKm,n._pointDistM=Y._pointDistM,n._pointDistRads=Y._pointDistRads,n._polyfill=Y._polyfill,n._res0IndexCount=Y._res0IndexCount,n._round=Y._round,n._sbrk=Y._sbrk,n._sizeOfCoordIJ=Y._sizeOfCoordIJ,n._sizeOfGeoBoundary=Y._sizeOfGeoBoundary,n._sizeOfGeoCoord=Y._sizeOfGeoCoord,n._sizeOfGeoPolygon=Y._sizeOfGeoPolygon,n._sizeOfGeofence=Y._sizeOfGeofence,n._sizeOfH3Index=Y._sizeOfH3Index,n._sizeOfLinkedGeoPolygon=Y._sizeOfLinkedGeoPolygon,n._uncompact=Y._uncompact,n.establishStackSpace=Y.establishStackSpace,n.stackAlloc=Y.stackAlloc),et=n.stackRestore=Y.stackRestore,nt=n.stackSave=Y.stackSave;if(n.asm=Y,n.cwrap=function(t,e,n,r){var i=(n=n||[]).every((function(t){return"number"===t}));return"string"!==e&&i&&!r?f(t):function(){return p(t,e,n,arguments)}},n.setValue=function(t,e,n,r){switch("*"===(n=n||"i8").charAt(n.length-1)&&(n="i32"),n){case"i1":case"i8":m[t>>0]=e;break;case"i16":v[t>>1]=e;break;case"i32":_[t>>2]=e;break;case"i64":z=[e>>>0,(F=e,+I(F)>=1?F>0?(0|k(+R(F/4294967296),4294967295))>>>0:~~+B((F-+(~~F>>>0))/4294967296)>>>0:0)],_[t>>2]=z[0],_[t+4>>2]=z[1];break;case"float":b[t>>2]=e;break;case"double":x[t>>3]=e;break;default:ut("invalid type for setValue: "+n)}},n.getValue=function(t,e,n){switch("*"===(e=e||"i8").charAt(e.length-1)&&(e="i32"),e){case"i1":case"i8":return m[t>>0];case"i16":return v[t>>1];case"i32":case"i64":return _[t>>2];case"float":return b[t>>2];case"double":return x[t>>3];default:ut("invalid type for getValue: "+e)}return null},n.getTempRet0=l,U){G(U)||(Q=U,U=n.locateFile?n.locateFile(Q,a):a+Q),D++,n.monitorRunDependencies&&n.monitorRunDependencies(D);var rt=function(t){t.byteLength&&(t=new Uint8Array(t)),y.set(t,8),n.memoryInitializerRequest&&delete n.memoryInitializerRequest.response,function(t){if(D--,n.monitorRunDependencies&&n.monitorRunDependencies(D),0==D&&(null!==L&&(clearInterval(L),L=null),j)){var e=j;j=null,e()}}()},it=function(){i(U,rt,(function(){throw"could not load memory initializer "+U}))},ot=J(U);if(ot)rt(ot.buffer);else if(n.memoryInitializerRequest){var at=function(){var t=n.memoryInitializerRequest,e=t.response;if(200!==t.status&&0!==t.status){var r=J(n.memoryInitializerRequestURL);if(!r)return console.warn("a problem seems to have happened with Module.memoryInitializerRequest, status: "+t.status+", retrying "+U),void it();e=r.buffer}rt(e)};n.memoryInitializerRequest.response?setTimeout(at,0):n.memoryInitializerRequest.addEventListener("load",at)}else it()}function st(t){function e(){K||(K=!0,h||(S(C),S(P),n.onRuntimeInitialized&&n.onRuntimeInitialized(),function(){if(n.postRun)for("function"==typeof n.postRun&&(n.postRun=[n.postRun]);n.postRun.length;)t=n.postRun.shift(),M.unshift(t);var t;S(M)}()))}t=t||o,D>0||(!function(){if(n.preRun)for("function"==typeof n.preRun&&(n.preRun=[n.preRun]);n.preRun.length;)t=n.preRun.shift(),T.unshift(t);var t;S(T)}(),D>0||(n.setStatus?(n.setStatus("Running..."),setTimeout((function(){setTimeout((function(){n.setStatus("")}),1),e()}),1)):e()))}function ut(t){throw n.onAbort&&n.onAbort(t),s(t+=""),u(t),h=!0,"abort("+t+"). Build with -s ASSERTIONS=1 for more info."}if(j=function t(){K||st(),K||(j=t)},n.run=st,n.abort=ut,n.preInit)for("function"==typeof n.preInit&&(n.preInit=[n.preInit]);n.preInit.length>0;)n.preInit.pop()();return st(),t}("object"==typeof en?en:{}),nn="number",rn={};[["sizeOfH3Index",nn],["sizeOfGeoCoord",nn],["sizeOfGeoBoundary",nn],["sizeOfGeoPolygon",nn],["sizeOfGeofence",nn],["sizeOfLinkedGeoPolygon",nn],["sizeOfCoordIJ",nn],["h3IsValid","number",["number","number"]],["geoToH3","number",[nn,nn,"number"]],["h3ToGeo",null,["number","number",nn]],["h3ToGeoBoundary",null,["number","number",nn]],["maxKringSize",nn,[nn]],["kRing",null,["number","number",nn,nn]],["kRingDistances",null,["number","number",nn,nn,nn]],["hexRing",null,["number","number",nn,nn]],["maxPolyfillSize",nn,[nn,"number"]],["polyfill",null,[nn,"number",nn]],["h3SetToLinkedGeo",null,[nn,nn,nn]],["destroyLinkedPolygon",null,[nn]],["compact",nn,[nn,nn,nn]],["uncompact",nn,[nn,nn,nn,nn,"number"]],["maxUncompactSize",nn,[nn,nn,"number"]],["h3IsPentagon","number",["number","number"]],["h3IsResClassIII","number",["number","number"]],["h3GetBaseCell",nn,["number","number"]],["h3GetResolution",nn,["number","number"]],["maxFaceCount",nn,["number","number"]],["h3GetFaces",null,["number","number",nn]],["h3ToParent","number",["number","number","number"]],["h3ToChildren",null,["number","number","number",nn]],["h3ToCenterChild","number",["number","number","number"]],["maxH3ToChildrenSize",nn,["number","number","number"]],["h3IndexesAreNeighbors","number",["number","number","number","number"]],["getH3UnidirectionalEdge","number",["number","number","number","number"]],["getOriginH3IndexFromUnidirectionalEdge","number",["number","number"]],["getDestinationH3IndexFromUnidirectionalEdge","number",["number","number"]],["h3UnidirectionalEdgeIsValid","number",["number","number"]],["getH3IndexesFromUnidirectionalEdge",null,["number","number",nn]],["getH3UnidirectionalEdgesFromHexagon",null,["number","number",nn]],["getH3UnidirectionalEdgeBoundary",null,["number","number",nn]],["h3Distance",nn,["number","number","number","number"]],["h3Line",nn,["number","number","number","number",nn]],["h3LineSize",nn,["number","number","number","number"]],["experimentalH3ToLocalIj",nn,["number","number","number","number",nn]],["experimentalLocalIjToH3",nn,["number","number",nn,nn]],["hexAreaM2",nn,["number"]],["hexAreaKm2",nn,["number"]],["edgeLengthM",nn,["number"]],["edgeLengthKm",nn,["number"]],["pointDistM",nn,[nn,nn]],["pointDistKm",nn,[nn,nn]],["pointDistRads",nn,[nn,nn]],["cellAreaM2",nn,["number","number"]],["cellAreaKm2",nn,["number","number"]],["cellAreaRads2",nn,["number","number"]],["exactEdgeLengthM",nn,["number","number"]],["exactEdgeLengthKm",nn,["number","number"]],["exactEdgeLengthRads",nn,["number","number"]],["numHexagons",nn,["number"]],["getRes0Indexes",null,[nn]],["res0IndexCount",nn],["getPentagonIndexes",null,[nn,nn]],["pentagonIndexCount",nn]].forEach((function(t){rn[t[0]]=en.cwrap.apply(en,t)}));var on=rn.sizeOfH3Index(),an=rn.sizeOfGeoCoord(),sn=rn.sizeOfGeoBoundary(),un=(rn.sizeOfGeoPolygon(),rn.sizeOfGeofence(),rn.sizeOfLinkedGeoPolygon()),cn=(rn.sizeOfCoordIJ(),"m"),ln="km";function hn(t){if("number"!=typeof t||t<0||t>15||Math.floor(t)!==t)throw new Error("Invalid resolution: "+t)}var fn=/[^0-9a-fA-F]/;function pn(t){if(Array.isArray(t)&&2===t.length&&Number.isInteger(t[0])&&Number.isInteger(t[1]))return t;if("string"!=typeof t||fn.test(t))return[0,0];var e=parseInt(t.substring(0,t.length-8),16);return[parseInt(t.substring(t.length-8),16),e]}function dn(t){if(t>=0)return t.toString(16);var e=gn(8,(t&=2147483647).toString(16));return e=(parseInt(e[0],16)+8).toString(16)+e.substring(1)}function An(t,e){return dn(e)+gn(8,dn(t))}function gn(t,e){for(var n=t-e.length,r="",i=0;i<n;i++)r+="0";return r+=e}function mn(t){return[t,en.getTempRet0()]}function yn(t){var e=mn(t),n=e[0],r=e[1];return r?An(n,r):null}function vn(t,e,n){en.HEAPU32.set(pn(t),e/4+2*n)}function _n(t,e){for(var n=e.length,r=0;r<n;r++)vn(e[r],t,r)}function bn(t){return 180*en.getValue(t,"double")/Math.PI}function xn(t){return[bn(t),bn(t+8)]}function wn(t){return[bn(t+8),bn(t)]}function En(t,e,n){for(var r=en.getValue(t,"i32"),i=t+8,o=[],a=e?wn:xn,s=0;s<2*r;s+=2)o.push(a(i+8*s));return n&&o.push(o[0]),o}function On(t){var e=pn(t),n=e[0],r=e[1];return Boolean(rn.h3IsPentagon(n,r))}function Sn(t){var e=en._malloc(an),n=pn(t),r=n[0],i=n[1];rn.h3ToGeo(r,i,e);var o=xn(e);return en._free(e),o}function Tn(t,e){var n=en._malloc(sn),r=pn(t),i=r[0],o=r[1];rn.h3ToGeoBoundary(i,o,n);var a=En(n,e,e);return en._free(n),a}function Cn(t,e){if(!t||!t.length)return[];var n=t.length,r=en._calloc(n,on);_n(r,t);var i=en._calloc(un),o=i;rn.h3SetToLinkedGeo(r,n,i);var a=function(t,e){for(var n,r,i,o,a=[],s=e?wn:xn;t;){for(a.push(n=[]),r=en.getValue(t,"i8*");r;){for(n.push(i=[]),o=en.getValue(r,"i8*");o;)i.push(s(o)),o=en.getValue(o+16,"i8*");e&&i.push(i[0]),r=en.getValue(r+8,"i8*")}t=en.getValue(t+8,"i8*")}return a}(i,e);return rn.destroyLinkedPolygon(o),en._free(o),en._free(r),a}function Pn(t,e){switch(hn(t),e){case cn:return rn.edgeLengthM(t);case ln:return rn.edgeLengthKm(t);default:throw new Error("Unknown unit: "+e)}}function Mn(t){return t*Math.PI/180}var In=n(52),Bn=n(28),Rn=n.n(Bn),kn=n(167);function Dn(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}function Ln(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function jn(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Ln(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Ln(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function Fn(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return zn(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return zn(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function zn(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function Un(t,e){e=void 0===e?t[0][0]:e;var n,r=Fn(t);try{for(r.s();!(n=r.n()).done;){var i=n.value,o=i[0]-e;o>180?i[0]-=360:o<-180&&(i[0]+=360)}}catch(t){r.e(t)}finally{r.f()}}function Nn(t,e,n){var r=Sn(t),i=E()(r,2),o=i[0],a=i[1],s=e.length;Un(e,a);for(var u=e[0]===e[s-1]?s-1:s,c=0;c<u;c++)e[c][0]=Object(Nt.g)(a,e[c][0],n),e[c][1]=Object(Nt.g)(o,e[c][1],n)}function Gn(t,e,n){var r=Sn(t(e,n)),i=E()(r,2),o=i[0];return[i[1],o]}function Vn(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:1,n=Tn(t,!0);return 1!==e?Nn(t,n,e):Un(n),n}var Hn=jn(jn({},y.a.defaultProps),{},{highPrecision:"auto",coverage:{type:"number",min:0,max:1,value:1},centerHexagon:null,getHexagon:{type:"accessor",value:function(t){return t.hexagon}},extruded:!0}),Wn=function(t){a()(n,t);var e=Dn(n);function n(){return i()(this,n),e.apply(this,arguments)}return g()(n,[{key:"initializeState",value:function(){n._checkH3Lib(),this.state={edgeLengthKM:0,resolution:-1}}},{key:"shouldUpdateState",value:function(t){var e=t.changeFlags;return this._shouldUseHighPrecision()?e.propsOrDataChanged:e.somethingChanged}},{key:"updateState",value:function(t){var e=t.props,n=t.changeFlags;if(!0!==e.highPrecision&&(n.dataChanged||n.updateTriggersChanged&&n.updateTriggersChanged.getHexagon)){var r=this._calculateH3DataProps();this.setState(r)}this._updateVertices(this.context.viewport)}},{key:"_calculateH3DataProps",value:function(){var t,e,n,r,i=-1,o=!1,a=!1,s=Object(In.a)(this.props.data),u=s.iterable,c=s.objectInfo,l=Fn(u);try{for(l.s();!(t=l.n()).done;){var h=t.value;c.index++;var f=this.props.getHexagon(h,c),p=(e=void 0,n=void 0,r=void 0,e=pn(f),n=e[0],r=e[1],rn.h3IsValid(n,r)?rn.h3GetResolution(n,r):-1);if(i<0){if(i=p,!this.props.highPrecision)break}else if(i!==p){a=!0;break}if(On(f)){o=!0;break}}}catch(t){l.e(t)}finally{l.f()}return{resolution:i,edgeLengthKM:i>=0?Pn(i,"km"):0,hasMultipleRes:a,hasPentagon:o}}},{key:"_shouldUseHighPrecision",value:function(){if("auto"===this.props.highPrecision){var t=this.state,e=t.resolution,n=t.hasPentagon,r=t.hasMultipleRes,i=this.context.viewport;return Boolean(null==i?void 0:i.resolution)||r||n||e>=0&&e<=5}return this.props.highPrecision}},{key:"_updateVertices",value:function(t){if(!this._shouldUseHighPrecision()){var e=this.state,n=e.resolution,r=e.edgeLengthKM,i=e.centerHex;if(!(n<0)){var o=this.props.centerHexagon||function(t,e,n){var r=en._malloc(an);en.HEAPF64.set([t,e].map(Mn),r/8);var i=yn(rn.geoToH3(r,n));return en._free(r),i}(t.latitude,t.longitude,n);if(i!==o){if(i){var a=(s=o,u=pn(i),c=u[0],l=u[1],h=pn(s),f=h[0],p=h[1],rn.h3Distance(c,l,f,p));if(a>=0&&a*r<10)return}var s,u,c,l,h,f,p,d=t.distanceScales.unitsPerMeter,A=Vn(o),g=Sn(o),m=E()(g,2),y=m[0],v=m[1],_=t.projectFlat([v,y]),b=E()(_,2),x=b[0],w=b[1];A=A.map((function(e){var n=t.projectFlat(e);return[(n[0]-x)/d[0],(n[1]-w)/d[1]]})),this.setState({centerHex:o,vertices:A})}}}}},{key:"renderLayers",value:function(){return this._shouldUseHighPrecision()?this._renderPolygonLayer():this._renderColumnLayer()}},{key:"_getForwardProps",value:function(){var t=this.props,e=t.elevationScale,n=t.material,r=t.coverage,i=t.extruded,o=t.wireframe,a=t.stroked,s=t.filled,u=t.lineWidthUnits,c=t.lineWidthScale,l=t.lineWidthMinPixels,h=t.lineWidthMaxPixels,f=t.getFillColor,p=t.getElevation,d=t.getLineColor,A=t.getLineWidth,g=t.transitions,m=t.updateTriggers;return{elevationScale:e,extruded:i,coverage:r,wireframe:o,stroked:a,filled:s,lineWidthUnits:u,lineWidthScale:c,lineWidthMinPixels:l,lineWidthMaxPixels:h,material:n,getElevation:p,getFillColor:f,getLineColor:d,getLineWidth:A,transitions:g,updateTriggers:{getFillColor:m.getFillColor,getElevation:m.getElevation,getLineColor:m.getLineColor,getLineWidth:m.getLineWidth}}}},{key:"_renderPolygonLayer",value:function(){var t=this.props,e=t.data,n=t.getHexagon,r=t.updateTriggers,i=t.coverage,o=this.getSubLayerClass("hexagon-cell-hifi",y.a),a=this._getForwardProps();return a.updateTriggers.getPolygon=function(t,e){return null==t?e:"object"===Rn()(t)?jn(jn({},t),{},{coverage:e}):{getHexagon:t,coverage:e}}(r.getHexagon,i),new o(a,this.getSubLayerProps({id:"hexagon-cell-hifi",updateTriggers:a.updateTriggers}),{data:e,_normalize:!1,_windingOrder:"CCW",positionFormat:"XY",getPolygon:function(t,e){return function(t){var e,n=new Float64Array(2*t.length),r=0,i=Fn(t);try{for(i.s();!(e=i.n()).done;){var o=e.value;n[r++]=o[0],n[r++]=o[1]}}catch(t){i.e(t)}finally{i.f()}return n}(Vn(n(t,e),i))}})}},{key:"_renderColumnLayer",value:function(){var t=this.props,e=t.data,n=t.getHexagon,r=t.updateTriggers,i=this.getSubLayerClass("hexagon-cell",kn.a),o=this._getForwardProps();return o.updateTriggers.getPosition=r.getHexagon,new i(o,this.getSubLayerProps({id:"hexagon-cell",flatShading:!0,updateTriggers:o.updateTriggers}),{data:e,diskResolution:6,radius:1,vertices:this.state.vertices,getPosition:Gn.bind(null,n)})}}]),n}(m.a);function qn(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return Xn(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return Xn(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function Xn(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function Zn(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}f()(Wn,"defaultProps",Hn),f()(Wn,"layerName","H3HexagonLayer"),f()(Wn,"_checkH3Lib",(function(){}));var Jn=function(t){a()(n,t);var e=Zn(n);function n(){return i()(this,n),e.apply(this,arguments)}return g()(n,[{key:"initializeState",value:function(){Wn._checkH3Lib()}},{key:"updateState",value:function(t){var e=t.props,n=t.changeFlags;if(n.dataChanged||n.updateTriggersChanged&&n.updateTriggersChanged.getHexagons){var r,i=e.data,o=e.getHexagons,a=[],s=Object(In.a)(i),u=s.iterable,c=s.objectInfo,l=qn(u);try{for(l.s();!(r=l.n()).done;){var h=r.value;c.index++;var f,p=qn(Cn(o(h,c),!0));try{for(p.s();!(f=p.n()).done;){var d=f.value;a.push(this.getSubLayerRow({polygon:d},h,c.index))}}catch(t){p.e(t)}finally{p.f()}}}catch(t){l.e(t)}finally{l.f()}this.setState({polygons:a})}}},{key:"indexToBounds",value:function(){return{data:this.state.polygons,getPolygon:function(t){return t.polygon}}}}]),n}(x);f()(Jn,"layerName","H3ClusterLayer"),f()(Jn,"defaultProps",{getHexagons:{type:"accessor",value:function(t){return t.hexagons}}});var Qn=n(60),Kn=n(12),Yn=n(232),$n=n(228),tr=n(247),er=n(324),nr=n(186),rr=n(233);function ir(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function or(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?ir(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):ir(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function ar(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}var sr=function(t){a()(n,t);var e=ar(n);function n(){return i()(this,n),e.apply(this,arguments)}return g()(n,[{key:"getShaders",value:function(){var t=Qe()(l()(n.prototype),"getShaders",this).call(this);return t.modules.push(er.a),or(or({},t),{},{vs:"#version 300 es\n#define SHADER_NAME simple-mesh-layer-vs\n\n// Scale the model\nuniform float sizeScale;\nuniform bool composeModelMatrix;\nuniform bool pickFeatureIds;\n\n// Primitive attributes\nin vec3 positions;\nin vec3 normals;\nin vec3 colors;\nin vec2 texCoords;\nin vec4 uvRegions;\nin vec3 featureIdsPickingColors;\n\n// Instance attributes\nin vec4 instanceColors;\nin vec3 instancePickingColors;\nin mat3 instanceModelMatrix;\n\n// Outputs to fragment shader\nout vec2 vTexCoord;\nout vec3 cameraPosition;\nout vec3 normals_commonspace;\nout vec4 position_commonspace;\nout vec4 vColor;\n\nvec2 applyUVRegion(vec2 uv) {\n  #ifdef HAS_UV_REGIONS\n    // https://github.com/Esri/i3s-spec/blob/master/docs/1.7/geometryUVRegion.cmn.md\n    return fract(uv) * (uvRegions.zw - uvRegions.xy) + uvRegions.xy;\n  #else\n    return uv;\n  #endif\n}\n\nvoid main(void) {\n  vec2 uv = applyUVRegion(texCoords);\n  geometry.uv = uv;\n\n  if (pickFeatureIds) {\n    geometry.pickingColor = featureIdsPickingColors;\n  } else {\n    geometry.pickingColor = instancePickingColors;\n  }\n\n  vTexCoord = uv;\n  cameraPosition = project_uCameraPosition;\n  vColor = vec4(colors * instanceColors.rgb, instanceColors.a);\n\n  vec3 pos = (instanceModelMatrix * positions) * sizeScale;\n  vec3 projectedPosition = project_position(positions);\n  position_commonspace = vec4(projectedPosition, 1.0);\n  gl_Position = project_common_position_to_clipspace(position_commonspace);\n\n  geometry.position = position_commonspace;\n  normals_commonspace = project_normal(instanceModelMatrix * normals);\n  geometry.normal = normals_commonspace;\n\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  #ifdef MODULE_PBR\n    // set PBR data\n    pbr_vPosition = geometry.position.xyz;\n    #ifdef HAS_NORMALS\n      pbr_vNormal = geometry.normal;\n    #endif\n\n    #ifdef HAS_UV\n      pbr_vUV = uv;\n    #else\n      pbr_vUV = vec2(0., 0.);\n    #endif\n    geometry.uv = pbr_vUV;\n  #endif\n\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n",fs:"#version 300 es\n#define SHADER_NAME simple-mesh-layer-fs\n\nprecision highp float;\n\nuniform bool hasTexture;\nuniform sampler2D sampler;\nuniform bool flatShading;\nuniform float opacity;\n\nin vec2 vTexCoord;\nin vec3 cameraPosition;\nin vec3 normals_commonspace;\nin vec4 position_commonspace;\nin vec4 vColor;\n\nout vec4 fragColor;\n\nvoid main(void) {\n  \n#ifdef MODULE_PBR\n\n  fragColor = vColor * pbr_filterColor(vec4(0));\n  geometry.uv = pbr_vUV;\n  fragColor.a *= opacity;\n\n#else\n\n  geometry.uv = vTexCoord;\n\n  vec3 normal;\n  if (flatShading) {\n\n// NOTE(Tarek): This is necessary because\n// headless.gl reports the extension as\n// available but does not support it in\n// the shader.\n#ifdef DERIVATIVES_AVAILABLE\n    normal = normalize(cross(dFdx(position_commonspace.xyz), dFdy(position_commonspace.xyz)));\n#else\n    normal = vec3(0.0, 0.0, 1.0);\n#endif\n  } else {\n    normal = normals_commonspace;\n  }\n\n  vec4 color = hasTexture ? texture(sampler, vTexCoord) : vColor;\n  vec3 lightColor = lighting_getLightColor(color.rgb, cameraPosition, position_commonspace.xyz, normal);\n  fragColor = vec4(lightColor, color.a * opacity);\n\n#endif\n\n  DECKGL_FILTER_COLOR(fragColor, geometry);\n}\n"})}},{key:"initializeState",value:function(){var t=this.props.featureIds;Qe()(l()(n.prototype),"initializeState",this).call(this);var e=this.getAttributeManager();t&&e.add({featureIdsPickingColors:{type:5121,size:3,noAlloc:!0,update:this.calculateFeatureIdsPickingColors}})}},{key:"updateState",value:function(t){Qe()(l()(n.prototype),"updateState",this).call(this,t);var e=t.props,r=t.oldProps;e.pbrMaterial!==r.pbrMaterial&&this.updatePbrMaterialUniforms(e.pbrMaterial)}},{key:"draw",value:function(t){var e=this.props.featureIds;this.state.model&&(this.state.model.setUniforms({u_Camera:this.state.model.getUniforms().project_uCameraPosition,pickFeatureIds:Boolean(e)}),Qe()(l()(n.prototype),"draw",this).call(this,t))}},{key:"getModel",value:function(t){var e=this.props,n=e.id,r=e.pbrMaterial,i=this.parseMaterial(r,t);this.setState({materialParser:i});var o,a=this.getShaders();return(o=t.attributes).COLOR_0||o.colors||(o.colors={constant:!0,value:new Float32Array([1,1,1])}),new nr.a(this.context.gl,or(or({},this.getShaders()),{},{id:n,geometry:t,defines:or(or(or({},a.defines),null==i?void 0:i.defines),{},{HAS_UV_REGIONS:t.attributes.uvRegions}),parameters:null==i?void 0:i.parameters,isInstanced:!0}))}},{key:"updatePbrMaterialUniforms",value:function(t){var e=this.state.model;if(e){var n=this.props.mesh,r=this.parseMaterial(t,n);this.setState({materialParser:r}),e.setUniforms(r.uniforms)}}},{key:"parseMaterial",value:function(t,e){var n,r=Boolean(t.pbrMetallicRoughness&&t.pbrMetallicRoughness.baseColorTexture);return null===(n=this.state.materialParser)||void 0===n||n.delete(),new tr.a(this.context.gl,{attributes:{NORMAL:e.attributes.normals,TEXCOORD_0:e.attributes.texCoords},material:or({unlit:r},t),pbrDebug:!1,imageBasedLightingEnvironment:null,lights:!0,useTangents:!1})}},{key:"calculateFeatureIdsPickingColors",value:function(t){for(var e=this.props.featureIds,n=new Uint8ClampedArray(e.length*t.size),r=[],i=0;i<e.length;i++)this.encodePickingColor(e[i],r),n[3*i]=r[0],n[3*i+1]=r[1],n[3*i+2]=r[2];t.value=n}},{key:"finalizeState",value:function(t){var e;Qe()(l()(n.prototype),"finalizeState",this).call(this,t),null===(e=this.state.materialParser)||void 0===e||e.delete(),this.setState({materialParser:null})}}]),n}(rr.a);f()(sr,"layerName","MeshLayer"),f()(sr,"defaultProps",{pbrMaterial:{type:"object",value:null},featureIds:{type:"array",value:null,optional:!0}});var ur=n(215),cr=n(2);function lr(t,e,n){return e in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t}Math.max(6378137,6378137,6356752.314245179);function hr(t){return t}new rt.a;function fr(t,e=[],n=hr){return"longitude"in t?(e[0]=n(t.longitude),e[1]=n(t.latitude),e[2]=t.height):"x"in t?(e[0]=n(t.x),e[1]=n(t.y),e[2]=t.z):(e[0]=n(t[0]),e[1]=n(t[1]),e[2]=t[2]),e}function pr(t,e,n=hr){return"longitude"in e?(e.longitude=n(t[0]),e.latitude=n(t[1]),e.height=t[2]):"x"in e?(e.x=n(t[0]),e.y=n(t[1]),e.z=t[2]):(e[0]=n(t[0]),e[1]=n(t[1]),e[2]=t[2]),e}const dr=new rt.a,Ar=new rt.a,gr=new rt.a;const mr=new rt.a,yr={up:{south:"east",north:"west",west:"south",east:"north"},down:{south:"west",north:"east",west:"north",east:"south"},south:{up:"west",down:"east",west:"down",east:"up"},north:{up:"east",down:"west",west:"up",east:"down"},west:{up:"north",down:"south",north:"down",south:"up"},east:{up:"south",down:"north",north:"up",south:"down"}},vr={north:[-1,0,0],east:[0,1,0],up:[0,0,1],south:[1,0,0],west:[0,-1,0],down:[0,0,-1]},_r={east:new rt.a,north:new rt.a,up:new rt.a,west:new rt.a,south:new rt.a,down:new rt.a},br=new rt.a,xr=new rt.a,wr=new rt.a;function Er(t,e,n,r,i,o){const a=yr[e]&&yr[e][n];let s,u,c;Object(Ut.a)(a&&(!r||r===a));const l=mr.copy(i);if(Object(Nt.d)(l.x,0,1e-14)&&Object(Nt.d)(l.y,0,1e-14)){const t=Math.sign(l.z);s=br.fromArray(vr[e]),"east"!==e&&"west"!==e&&s.scale(t),u=xr.fromArray(vr[n]),"east"!==n&&"west"!==n&&u.scale(t),c=wr.fromArray(vr[r]),"east"!==r&&"west"!==r&&c.scale(t)}else{const{up:i,east:o,north:a}=_r;o.set(-l.y,l.x,0).normalize(),t.geodeticSurfaceNormal(l,i),a.copy(i).cross(o);const{down:h,west:f,south:p}=_r;h.copy(i).scale(-1),f.copy(o).scale(-1),p.copy(a).scale(-1),s=_r[e],u=_r[n],c=_r[r]}return o[0]=s.x,o[1]=s.y,o[2]=s.z,o[3]=0,o[4]=u.x,o[5]=u.y,o[6]=u.z,o[7]=0,o[8]=c.x,o[9]=c.y,o[10]=c.z,o[11]=0,o[12]=l.x,o[13]=l.y,o[14]=l.z,o[15]=1,o}const Or=new rt.a,Sr=new rt.a,Tr=new rt.a,Cr=new rt.a,Pr=new rt.a,Mr=new rt.a;class Ir{constructor(t=0,e=0,n=0){lr(this,"radii",void 0),lr(this,"radiiSquared",void 0),lr(this,"radiiToTheFourth",void 0),lr(this,"oneOverRadii",void 0),lr(this,"oneOverRadiiSquared",void 0),lr(this,"minimumRadius",void 0),lr(this,"maximumRadius",void 0),lr(this,"centerToleranceSquared",Kt),lr(this,"squaredXOverSquaredZ",void 0),Object(Ut.a)(t>=0),Object(Ut.a)(e>=0),Object(Ut.a)(n>=0),this.radii=new rt.a(t,e,n),this.radiiSquared=new rt.a(t*t,e*e,n*n),this.radiiToTheFourth=new rt.a(t*t*t*t,e*e*e*e,n*n*n*n),this.oneOverRadii=new rt.a(0===t?0:1/t,0===e?0:1/e,0===n?0:1/n),this.oneOverRadiiSquared=new rt.a(0===t?0:1/(t*t),0===e?0:1/(e*e),0===n?0:1/(n*n)),this.minimumRadius=Math.min(t,e,n),this.maximumRadius=Math.max(t,e,n),0!==this.radiiSquared.z&&(this.squaredXOverSquaredZ=this.radiiSquared.x/this.radiiSquared.z),Object.freeze(this)}equals(t){return this===t||Boolean(t&&this.radii.equals(t.radii))}toString(){return this.radii.toString()}cartographicToCartesian(t,e=[0,0,0]){const n=Sr,r=Tr,[,,i]=t;this.geodeticSurfaceNormalCartographic(t,n),r.copy(this.radiiSquared).scale(n);const o=Math.sqrt(n.dot(r));return r.scale(1/o),n.scale(i),r.add(n),r.to(e)}cartesianToCartographic(t,e=[0,0,0]){Mr.from(t);const n=this.scaleToGeodeticSurface(Mr,Cr);if(!n)return;const r=this.geodeticSurfaceNormal(n,Sr),i=Pr;i.copy(Mr).subtract(n);const o=Math.atan2(r.y,r.x),a=Math.asin(r.z),s=Math.sign(mt.e(i,Mr))*mt.h(i);return pr([o,a,s],e,Nt.b._cartographicRadians?hr:Nt.i)}eastNorthUpToFixedFrame(t,e=new Jt.a){return Er(this,"east","north","up",t,e)}localFrameToFixedFrame(t,e,n,r,i=new Jt.a){return Er(this,t,e,n,r,i)}geocentricSurfaceNormal(t,e=[0,0,0]){return Or.from(t).normalize().to(e)}geodeticSurfaceNormalCartographic(t,e=[0,0,0]){const n=function(t,e=[]){return fr(t,e,Nt.b._cartographicRadians?hr:Nt.j)}(t),r=n[0],i=n[1],o=Math.cos(i);return Or.set(o*Math.cos(r),o*Math.sin(r),Math.sin(i)).normalize(),Or.to(e)}geodeticSurfaceNormal(t,e=[0,0,0]){return Or.from(t).scale(this.oneOverRadiiSquared).normalize().to(e)}scaleToGeodeticSurface(t,e){return function(t,e,n=[]){const{oneOverRadii:r,oneOverRadiiSquared:i,centerToleranceSquared:o}=e;dr.from(t);const a=dr.x,s=dr.y,u=dr.z,c=r.x,l=r.y,h=r.z,f=a*a*c*c,p=s*s*l*l,d=u*u*h*h,A=f+p+d,g=Math.sqrt(1/A);if(!Number.isFinite(g))return;const m=Ar;if(m.copy(t).scale(g),A<o)return m.to(n);const y=i.x,v=i.y,_=i.z,b=gr;b.set(m.x*y*2,m.y*v*2,m.z*_*2);let x,w,E,O,S=(1-g)*dr.len()/(.5*b.len()),T=0;do{S-=T,x=1/(1+S*y),w=1/(1+S*v),E=1/(1+S*_);const t=x*x,e=w*w,n=E*E;O=f*t+p*e+d*n-1;T=O/(-2*(f*(t*x)*y+p*(e*w)*v+d*(n*E)*_))}while(Math.abs(O)>Yt);return dr.scale([x,w,E]).to(n)}(t,this,e)}scaleToGeocentricSurface(t,e=[0,0,0]){Cr.from(t);const n=Cr.x,r=Cr.y,i=Cr.z,o=this.oneOverRadiiSquared,a=1/Math.sqrt(n*n*o.x+r*r*o.y+i*i*o.z);return Cr.multiplyScalar(a).to(e)}transformPositionToScaledSpace(t,e=[0,0,0]){return Cr.from(t).scale(this.oneOverRadii).to(e)}transformPositionFromScaledSpace(t,e=[0,0,0]){return Cr.from(t).scale(this.radii).to(e)}getSurfaceNormalIntersectionWithZAxis(t,e=0,n=[0,0,0]){Object(Ut.a)(Object(Nt.d)(this.radii.x,this.radii.y,$t)),Object(Ut.a)(this.radii.z>0),Cr.from(t);const r=Cr.z*(1-this.squaredXOverSquaredZ);if(!(Math.abs(r)>=this.radii.z-e))return Cr.set(0,0,r).to(n)}}lr(Ir,"WGS84",new Ir(6378137,6378137,6356752.314245179));var Br=n(76),Rr=n(106),kr=n(20);class Dr{constructor(t,e,n){Object(cr.a)(this,"item",void 0),Object(cr.a)(this,"previous",void 0),Object(cr.a)(this,"next",void 0),this.item=t,this.previous=e,this.next=n}}class Lr{constructor(){Object(cr.a)(this,"head",null),Object(cr.a)(this,"tail",null),Object(cr.a)(this,"_length",0)}get length(){return this._length}add(t){const e=new Dr(t,this.tail,null);return this.tail?(this.tail.next=e,this.tail=e):(this.head=e,this.tail=e),++this._length,e}remove(t){t&&(t.previous&&t.next?(t.previous.next=t.next,t.next.previous=t.previous):t.previous?(t.previous.next=null,this.tail=t.previous):t.next?(t.next.previous=null,this.head=t.next):(this.head=null,this.tail=null),t.next=null,t.previous=null,--this._length)}splice(t,e){t!==e&&(this.remove(e),this._insert(t,e))}_insert(t,e){const n=t.next;t.next=e,this.tail===t?this.tail=e:n.previous=e,e.next=n,e.previous=t,++this._length}}function jr(t){return null!=t}class Fr{constructor(){Object(cr.a)(this,"_list",void 0),Object(cr.a)(this,"_sentinel",void 0),Object(cr.a)(this,"_trimTiles",void 0),this._list=new Lr,this._sentinel=this._list.add("sentinel"),this._trimTiles=!1}reset(){this._list.splice(this._list.tail,this._sentinel)}touch(t){const e=t._cacheNode;jr(e)&&this._list.splice(this._sentinel,e)}add(t,e,n){jr(e._cacheNode)||(e._cacheNode=this._list.add(e),n&&n(t,e))}unloadTile(t,e,n){const r=e._cacheNode;jr(r)&&(this._list.remove(r),e._cacheNode=void 0,n&&n(t,e))}unloadTiles(t,e){const n=this._trimTiles;this._trimTiles=!1;const r=this._list,i=1024*t.maximumMemoryUsage*1024,o=this._sentinel;let a=r.head;for(;a!==o&&(t.gpuMemoryUsageInBytes>i||n);){const n=a.item;a=a.next,this.unloadTile(t,n,e)}}trim(){this._trimTiles=!0}}const zr=new rt.a,Ur=new rt.a,Nr=new Zt([new Ht,new Ht,new Ht,new Ht,new Ht,new Ht]);function Gr(t,e){const{cameraDirection:n,cameraUp:r,height:i}=t,{metersPerUnit:o}=t.distanceScales,a=Hr(t,t.center),s=Ir.WGS84.eastNorthUpToFixedFrame(a),u=t.unprojectPosition(t.cameraPosition),c=Ir.WGS84.cartographicToCartesian(u,new rt.a),l=new rt.a(s.transformAsVector(new rt.a(n).scale(o))).normalize(),h=new rt.a(s.transformAsVector(new rt.a(r).scale(o))).normalize();!function(t){const e=t.getFrustumPlanes(),n=Vr(e.near,t.cameraPosition),r=Hr(t,n),i=Hr(t,t.cameraPosition,Ur);let o=0;Nr.planes[o++].fromPointNormal(r,zr.copy(r).subtract(i));for(const i in e){if("near"===i)continue;const a=Vr(e[i],n,Ur),s=Hr(t,a,Ur);Nr.planes[o++].fromPointNormal(s,zr.copy(r).subtract(s))}}(t);const f=t.constructor,{longitude:p,latitude:d,width:A,bearing:g,zoom:m}=t;return{camera:{position:c,direction:l,up:h},viewport:t,topDownViewport:new f({longitude:p,latitude:d,height:i,width:A,bearing:g,zoom:m,pitch:0}),height:i,cullingVolume:Nr,frameNumber:e,sseDenominator:1.15}}function Vr(t,e,n=new rt.a){const r=t.normal.dot(e);return n.copy(t.normal).scale(t.distance-r).add(e),n}function Hr(t,e,n=new rt.a){const r=t.unprojectPosition(e);return Ir.WGS84.cartographicToCartesian(r,n)}const Wr=new rt.a;function qr(t,e){if(t instanceof zt){const{halfAxes:n}=t,r=function(t){t.getColumn(0,Wr);const e=t.getColumn(1),n=t.getColumn(2),r=Wr.add(e).add(n);return r.len()}(n);return Math.log2(6356752.314245179/(r+e[2]))}if(t instanceof lt){const{radius:n}=t;return Math.log2(6356752.314245179/(n+e[2]))}if(t.width&&t.height){const{width:e,height:n}=t;return(Math.log2(6378137/e)+Math.log2(6378137/n))/2}return 1}function Xr(t,e,n){const r=Ir.WGS84.cartographicToCartesian([t.xmax,t.ymax,t.zmax],new rt.a),i=Math.sqrt(Math.pow(r[0]-n[0],2)+Math.pow(r[1]-n[1],2)+Math.pow(r[2]-n[2],2));return Math.log2(6356752.314245179/(i+e[2]))}const Zr=0,Jr=1,Qr=3,Kr=4,Yr=5,$r=1,ti=2,ei="empty",ni="scenegraph",ri="pointcloud",ii="mesh",oi="I3S",ai="TILES3D",si="geometricError",ui=1;function ci(t){return null!=t}const li=new rt.a,hi=new rt.a,fi=new rt.a;function pi(t,e,n){if(Object(Rr.a)(t,"3D Tile: boundingVolume must be defined"),t.box)return function(t,e,n){const r=new rt.a(t[0],t[1],t[2]);e.transform(r,r);let i=[];if(10===t.length){const e=t.slice(3,6),n=new xt.a;n.fromArray(t,6);const r=new rt.a([1,0,0]),o=new rt.a([0,1,0]),a=new rt.a([0,0,1]);r.transformByQuaternion(n),r.scale(e[0]),o.transformByQuaternion(n),o.scale(e[1]),a.transformByQuaternion(n),a.scale(e[2]),i=[...r.toArray(),...o.toArray(),...a.toArray()]}else i=[...t.slice(3,6),...t.slice(6,9),...t.slice(9,12)];const o=e.transformAsVector(i.slice(0,3)),a=e.transformAsVector(i.slice(3,6)),s=e.transformAsVector(i.slice(6,9)),u=new vt([o[0],o[1],o[2],a[0],a[1],a[2],s[0],s[1],s[2]]);if(ci(n))return n.center=r,n.halfAxes=u,n;return new zt(r,u)}(t.box,e,n);if(t.region){const[e,n,r,i,o,a]=t.region,s=Ir.WGS84.cartographicToCartesian([Object(Nt.c)(e),Object(Nt.c)(i),o],hi),u=Ir.WGS84.cartographicToCartesian([Object(Nt.c)(r),Object(Nt.c)(n),a],fi),c=(new rt.a).addVectors(s,u).multiplyScalar(.5),l=(new rt.a).subVectors(s,u).len()/2;return di([c[0],c[1],c[2],l],new Jt.a)}if(t.sphere)return di(t.sphere,e,n);throw new Error("3D Tile: boundingVolume must contain a sphere, region, or box")}function di(t,e,n){const r=new rt.a(t[0],t[1],t[2]);e.transform(r,r);const i=e.getScale(li),o=Math.max(Math.max(i[0],i[1]),i[2]),a=t[3]*o;return ci(n)?(n.center=r,n.radius=a,n):new lt(r,a)}new rt.a,new rt.a,new Jt.a,new rt.a,new rt.a,new rt.a;function Ai(t,e){if(t.dynamicScreenSpaceError&&t.dynamicScreenSpaceErrorComputedDensity){const n=t.dynamicScreenSpaceErrorComputedDensity,r=t.dynamicScreenSpaceErrorFactor;return function(t,e){const n=t*e;return 1-Math.exp(-n*n)}(e,n)*r}return 0}const gi=new rt.a,mi=new rt.a,yi=new rt.a,vi=new rt.a,_i=new rt.a,bi=new Jt.a,xi=new Jt.a;function wi(t,e){const{topDownViewport:n}=e,r=t.header.mbs[1],i=t.header.mbs[0],o=t.header.mbs[2],a=t.header.mbs[3],s=[...t.boundingVolume.center],u=n.unprojectPosition(n.cameraPosition);Ir.WGS84.cartographicToCartesian(u,gi),mi.copy(gi).subtract(s).normalize(),Ir.WGS84.eastNorthUpToFixedFrame(s,bi),xi.copy(bi).invert(),yi.copy(gi).transform(xi);const c=Math.sqrt(yi[0]*yi[0]+yi[1]*yi[1]),l=c*c/yi[2];vi.copy([yi[0],yi[1],l]);const h=vi.transform(bi).subtract(s).normalize(),f=mi.cross(h).normalize().scale(a).add(s),p=Ir.WGS84.cartesianToCartographic(f),d=n.project([i,r,o]),A=n.project(p);return _i.copy(d).subtract(A).magnitude()}class Ei{constructor(t=0){Object(cr.a)(this,"_map",new Map),Object(cr.a)(this,"_array",void 0),Object(cr.a)(this,"_length",void 0),this._array=new Array(t),this._length=t}get length(){return this._length}set length(t){this._length=t,t>this._array.length&&(this._array.length=t)}get values(){return this._array}get(t){return Object(Rr.a)(t<this._array.length),this._array[t]}set(t,e){Object(Rr.a)(t>=0),t>=this.length&&(this.length=t+1),this._map.has(this._array[t])&&this._map.delete(this._array[t]),this._array[t]=e,this._map.set(e,t)}delete(t){const e=this._map.get(t);e>=0&&(this._array.splice(e,1),this._map.delete(t),this.length--)}peek(){return this._array[this._length-1]}push(t){if(!this._map.has(t)){const e=this.length++;this._array[e]=t,this._map.set(t,e)}}pop(){const t=this._array[--this.length];return this._map.delete(t),t}reserve(t){Object(Rr.a)(t>=0),t>this._array.length&&(this._array.length=t)}resize(t){Object(Rr.a)(t>=0),this.length=t}trim(t){null==t&&(t=this.length),this._array.length=t}reset(){this._array=[],this._map=new Map,this._length=0}find(t){return this._map.has(t)}}const Oi={loadSiblings:!1,skipLevelOfDetail:!1,maximumScreenSpaceError:2,updateTransforms:!0,onTraversalEnd:()=>{},viewportTraversersMap:{},basePath:""};class Si{traversalFinished(t){return!0}constructor(t){Object(cr.a)(this,"options",void 0),Object(cr.a)(this,"root",void 0),Object(cr.a)(this,"requestedTiles",void 0),Object(cr.a)(this,"selectedTiles",void 0),Object(cr.a)(this,"emptyTiles",void 0),Object(cr.a)(this,"lastUpdate",(new Date).getTime()),Object(cr.a)(this,"updateDebounceTime",1e3),Object(cr.a)(this,"_traversalStack",void 0),Object(cr.a)(this,"_emptyTraversalStack",void 0),Object(cr.a)(this,"_frameNumber",void 0),this.options={...Oi,...t},this._traversalStack=new Ei,this._emptyTraversalStack=new Ei,this._frameNumber=null,this.root=null,this.selectedTiles={},this.requestedTiles={},this.emptyTiles={}}traverse(t,e,n){this.root=t,this.options={...this.options,...n},this.reset(),this.updateTile(t,e),this._frameNumber=e.frameNumber,this.executeTraversal(t,e)}reset(){this.requestedTiles={},this.selectedTiles={},this.emptyTiles={},this._traversalStack.reset(),this._emptyTraversalStack.reset()}executeTraversal(t,e){const n=this._traversalStack;for(t._selectionDepth=1,n.push(t);n.length>0;){const t=n.pop();let r=!1;this.canTraverse(t,e)&&(this.updateChildTiles(t,e),r=this.updateAndPushChildren(t,e,n,t.hasRenderContent?t._selectionDepth+1:t._selectionDepth));const i=t.parent,o=Boolean(!i||i._shouldRefine),a=!r;t.hasRenderContent?t.refine===$r?(this.loadTile(t,e),this.selectTile(t,e)):t.refine===ti&&(this.loadTile(t,e),a&&this.selectTile(t,e)):(this.emptyTiles[t.id]=t,this.loadTile(t,e),a&&this.selectTile(t,e)),this.touchTile(t,e),t._shouldRefine=r&&o}const r=(new Date).getTime();(this.traversalFinished(e)||r-this.lastUpdate>this.updateDebounceTime)&&(this.lastUpdate=r,this.options.onTraversalEnd(e))}updateChildTiles(t,e){const n=t.children;for(const t of n)this.updateTile(t,e);return!0}updateAndPushChildren(t,e,n,r){const{loadSiblings:i,skipLevelOfDetail:o}=this.options,a=t.children;a.sort(this.compareDistanceToCamera.bind(this));const s=t.refine===ti&&t.hasRenderContent&&!o;let u=!1,c=!0;for(const t of a)if(t._selectionDepth=r,t.isVisibleAndInRequestVolume?(n.find(t)&&n.delete(t),n.push(t),u=!0):(s||i)&&(this.loadTile(t,e),this.touchTile(t,e)),s){let n;if(n=!!t._inRequestVolume&&(t.hasRenderContent?t.contentAvailable:this.executeEmptyTraversal(t,e)),c=c&&n,!c)return!1}return u||(c=!1),c}updateTile(t,e){this.updateTileVisibility(t,e)}selectTile(t,e){this.shouldSelectTile(t)&&(t._selectedFrame=e.frameNumber,this.selectedTiles[t.id]=t)}loadTile(t,e){this.shouldLoadTile(t)&&(t._requestedFrame=e.frameNumber,t._priority=t._getPriority(),this.requestedTiles[t.id]=t)}touchTile(t,e){t.tileset._cache.touch(t),t._touchedFrame=e.frameNumber}canTraverse(t,e,n=!1,r=!1){return!!t.hasChildren&&(t.hasTilesetContent?!t.contentExpired:!(!r&&!t.isVisibleAndInRequestVolume)&&this.shouldRefine(t,e,n))}shouldLoadTile(t){return t.hasUnloadedContent||t.contentExpired}shouldSelectTile(t){return t.contentAvailable&&!this.options.skipLevelOfDetail}shouldRefine(t,e,n){let r=t._screenSpaceError;return n&&(r=t.getScreenSpaceError(e,!0)),r>this.options.maximumScreenSpaceError}updateTileVisibility(t,e){const n=[];if(this.options.viewportTraversersMap)for(const t in this.options.viewportTraversersMap){this.options.viewportTraversersMap[t]===e.viewport.id&&n.push(t)}else n.push(e.viewport.id);t.updateVisibility(e,n)}compareDistanceToCamera(t,e){return t._distanceToCamera-e._distanceToCamera}anyChildrenVisible(t,e){let n=!1;for(const r of t.children)r.updateVisibility(e),n=n||r.isVisibleAndInRequestVolume;return n}executeEmptyTraversal(t,e){let n=!0;const r=this._emptyTraversalStack;for(r.push(t);r.length>0&&n;){const t=r.pop();this.updateTile(t,e),t.isVisibleAndInRequestVolume||this.loadTile(t,e),this.touchTile(t,e);if(!t.hasRenderContent&&this.canTraverse(t,e,!1,!0)){const e=t.children;for(const t of e)r.find(t)&&r.delete(t),r.push(t)}else t.contentAvailable||(n=!1)}return n}}const Ti=new rt.a;class Ci{constructor(t,e,n,r=""){Object(cr.a)(this,"tileset",void 0),Object(cr.a)(this,"header",void 0),Object(cr.a)(this,"id",void 0),Object(cr.a)(this,"url",void 0),Object(cr.a)(this,"parent",void 0),Object(cr.a)(this,"refine",void 0),Object(cr.a)(this,"type",void 0),Object(cr.a)(this,"contentUrl",void 0),Object(cr.a)(this,"lodMetricType",void 0),Object(cr.a)(this,"lodMetricValue",void 0),Object(cr.a)(this,"boundingVolume",void 0),Object(cr.a)(this,"content",void 0),Object(cr.a)(this,"contentState",void 0),Object(cr.a)(this,"gpuMemoryUsageInBytes",void 0),Object(cr.a)(this,"children",void 0),Object(cr.a)(this,"depth",void 0),Object(cr.a)(this,"viewportIds",void 0),Object(cr.a)(this,"transform",void 0),Object(cr.a)(this,"extensions",void 0),Object(cr.a)(this,"userData",void 0),Object(cr.a)(this,"computedTransform",void 0),Object(cr.a)(this,"hasEmptyContent",void 0),Object(cr.a)(this,"hasTilesetContent",void 0),Object(cr.a)(this,"traverser",void 0),Object(cr.a)(this,"_cacheNode",void 0),Object(cr.a)(this,"_frameNumber",void 0),Object(cr.a)(this,"_lodJudge",void 0),Object(cr.a)(this,"_expireDate",void 0),Object(cr.a)(this,"_expiredContent",void 0),Object(cr.a)(this,"_shouldRefine",void 0),Object(cr.a)(this,"_distanceToCamera",void 0),Object(cr.a)(this,"_centerZDepth",void 0),Object(cr.a)(this,"_screenSpaceError",void 0),Object(cr.a)(this,"_visibilityPlaneMask",void 0),Object(cr.a)(this,"_visible",void 0),Object(cr.a)(this,"_inRequestVolume",void 0),Object(cr.a)(this,"_stackLength",void 0),Object(cr.a)(this,"_selectionDepth",void 0),Object(cr.a)(this,"_touchedFrame",void 0),Object(cr.a)(this,"_visitedFrame",void 0),Object(cr.a)(this,"_selectedFrame",void 0),Object(cr.a)(this,"_requestedFrame",void 0),Object(cr.a)(this,"_priority",void 0),Object(cr.a)(this,"_contentBoundingVolume",void 0),Object(cr.a)(this,"_viewerRequestVolume",void 0),Object(cr.a)(this,"_initialTransform",void 0),this.header=e,this.tileset=t,this.id=r||e.id,this.url=e.url,this.parent=n,this.refine=this._getRefine(e.refine),this.type=e.type,this.contentUrl=e.contentUrl,this.lodMetricType="geometricError",this.lodMetricValue=0,this.boundingVolume=null,this.content=null,this.contentState=Zr,this.gpuMemoryUsageInBytes=0,this.children=[],this.hasEmptyContent=!1,this.hasTilesetContent=!1,this.depth=0,this.viewportIds=[],this.userData={},this.extensions=null,this._priority=0,this._touchedFrame=0,this._visitedFrame=0,this._selectedFrame=0,this._requestedFrame=0,this._screenSpaceError=0,this._cacheNode=null,this._frameNumber=null,this._cacheNode=null,this.traverser=new Si({}),this._shouldRefine=!1,this._distanceToCamera=0,this._centerZDepth=0,this._visible=void 0,this._inRequestVolume=!1,this._stackLength=0,this._selectionDepth=0,this._initialTransform=new Jt.a,this.transform=new Jt.a,this._initializeLodMetric(e),this._initializeTransforms(e),this._initializeBoundingVolumes(e),this._initializeContent(e),this._initializeRenderingState(e),this._lodJudge=null,this._expireDate=null,this._expiredContent=null,Object.seal(this)}destroy(){this.header=null}isDestroyed(){return null===this.header}get selected(){return this._selectedFrame===this.tileset._frameNumber}get isVisible(){return this._visible}get isVisibleAndInRequestVolume(){return this._visible&&this._inRequestVolume}get hasRenderContent(){return!this.hasEmptyContent&&!this.hasTilesetContent}get hasChildren(){return this.children.length>0||this.header.children&&this.header.children.length>0}get contentReady(){return this.contentState===Qr||this.hasEmptyContent}get contentAvailable(){return Boolean(this.contentReady&&this.hasRenderContent||this._expiredContent&&!this.contentFailed)}get hasUnloadedContent(){return this.hasRenderContent&&this.contentUnloaded}get contentUnloaded(){return this.contentState===Zr}get contentExpired(){return this.contentState===Kr}get contentFailed(){return this.contentState===Yr}getScreenSpaceError(t,e){switch(this.tileset.type){case oi:return wi(this,t);case ai:return function(t,e,n){const r=t.tileset,i=t.parent&&t.parent.lodMetricValue||t.lodMetricValue,o=n?i:t.lodMetricValue;if(0===o)return 0;const a=Math.max(t._distanceToCamera,1e-7),{height:s,sseDenominator:u}=e,{viewDistanceScale:c}=r.options;let l=o*s*(c||1)/(a*u);return l-=Ai(r,a),l}(this,t,e);default:throw new Error("Unsupported tileset type")}}unselect(){this._selectedFrame=0}_getPriority(){const t=this.tileset._traverser,{skipLevelOfDetail:e}=t.options,n=this.refine===$r||e;if(n&&!this.isVisible&&void 0!==this._visible)return-1;if(this.tileset._frameNumber-this._touchedFrame>=1)return-1;if(this.contentState===Zr)return-1;const r=this.parent,i=r&&(!n||0===this._screenSpaceError||r.hasTilesetContent)?r._screenSpaceError:this._screenSpaceError,o=t.root?t.root._screenSpaceError:0;return Math.max(o-i,0)}async loadContent(){if(this.hasEmptyContent)return!1;if(this.content)return!0;this.contentExpired&&(this._expireDate=null),this.contentState=Jr;const t=await this.tileset._requestScheduler.scheduleRequest(this.id,this._getPriority.bind(this));if(!t)return this.contentState=Zr,!1;try{const e=this.tileset.getTileUrl(this.contentUrl),n=this.tileset.loader,r={...this.tileset.loadOptions,[n.id]:{...this.tileset.loadOptions[n.id],isTileset:"json"===this.type,...this._getLoaderSpecificOptions(n.id)}};return this.content=await Object(ur.a)(e,n,r),this.tileset.options.contentLoader&&await this.tileset.options.contentLoader(this),this._isTileset()&&this.tileset._initializeTileHeaders(this.content,this),this.contentState=Qr,this._onContentLoaded(),!0}catch(t){throw this.contentState=Yr,t}finally{t.done()}}unloadContent(){return this.content&&this.content.destroy&&this.content.destroy(),this.content=null,this.header.content&&this.header.content.destroy&&this.header.content.destroy(),this.header.content=null,this.contentState=Zr,!0}updateVisibility(t,e){if(this._frameNumber===t.frameNumber)return;const n=this.parent,r=n?n._visibilityPlaneMask:Zt.MASK_INDETERMINATE;if(this.tileset._traverser.options.updateTransforms){const t=n?n.computedTransform:this.tileset.modelMatrix;this._updateTransform(t)}this._distanceToCamera=this.distanceToTile(t),this._screenSpaceError=this.getScreenSpaceError(t,!1),this._visibilityPlaneMask=this.visibility(t,r),this._visible=this._visibilityPlaneMask!==Zt.MASK_OUTSIDE,this._inRequestVolume=this.insideViewerRequestVolume(t),this._frameNumber=t.frameNumber,this.viewportIds=e}visibility(t,e){const{cullingVolume:n}=t,{boundingVolume:r}=this;return n.computeVisibilityWithPlaneMask(r,e)}contentVisibility(){return!0}distanceToTile(t){const e=this.boundingVolume;return Math.sqrt(Math.max(e.distanceSquaredTo(t.camera.position),0))}cameraSpaceZDepth({camera:t}){const e=this.boundingVolume;return Ti.subVectors(e.center,t.position),t.direction.dot(Ti)}insideViewerRequestVolume(t){const e=this._viewerRequestVolume;return!e||e.distanceSquaredTo(t.camera.position)<=0}updateExpiration(){if(null!=this._expireDate&&this.contentReady&&!this.hasEmptyContent){const t=Date.now();Date.lessThan(this._expireDate,t)&&(this.contentState=Kr,this._expiredContent=this.content)}}get extras(){return this.header.extras}_initializeLodMetric(t){"lodMetricType"in t?this.lodMetricType=t.lodMetricType:(this.lodMetricType=this.parent&&this.parent.lodMetricType||this.tileset.lodMetricType,console.warn("3D Tile: Required prop lodMetricType is undefined. Using parent lodMetricType")),"lodMetricValue"in t?this.lodMetricValue=t.lodMetricValue:(this.lodMetricValue=this.parent&&this.parent.lodMetricValue||this.tileset.lodMetricValue,console.warn("3D Tile: Required prop lodMetricValue is undefined. Using parent lodMetricValue"))}_initializeTransforms(t){this.transform=t.transform?new Jt.a(t.transform):new Jt.a;const e=this.parent,n=this.tileset,r=e&&e.computedTransform?e.computedTransform.clone():n.modelMatrix.clone();this.computedTransform=new Jt.a(r).multiplyRight(this.transform);const i=e&&e._initialTransform?e._initialTransform.clone():new Jt.a;this._initialTransform=new Jt.a(i).multiplyRight(this.transform)}_initializeBoundingVolumes(t){this._contentBoundingVolume=null,this._viewerRequestVolume=null,this._updateBoundingVolume(t)}_initializeContent(t){this.content={_tileset:this.tileset,_tile:this},this.hasEmptyContent=!0,this.contentState=Zr,this.hasTilesetContent=!1,t.contentUrl&&(this.content=null,this.hasEmptyContent=!1)}_initializeRenderingState(t){this.depth=t.level||(this.parent?this.parent.depth+1:0),this._shouldRefine=!1,this._distanceToCamera=0,this._centerZDepth=0,this._screenSpaceError=0,this._visibilityPlaneMask=Zt.MASK_INDETERMINATE,this._visible=void 0,this._inRequestVolume=!1,this._stackLength=0,this._selectionDepth=0,this._frameNumber=0,this._touchedFrame=0,this._visitedFrame=0,this._selectedFrame=0,this._requestedFrame=0,this._priority=0}_getRefine(t){return t||this.parent&&this.parent.refine||ti}_isTileset(){return-1!==this.contentUrl.indexOf(".json")}_onContentLoaded(){switch(this.content&&this.content.type){case"vctr":case"geom":this.tileset._traverser.disableSkipLevelOfDetail=!0}this._isTileset()&&(this.hasTilesetContent=!0)}_updateBoundingVolume(t){this.boundingVolume=pi(t.boundingVolume,this.computedTransform,this.boundingVolume);const e=t.content;e&&(e.boundingVolume&&(this._contentBoundingVolume=pi(e.boundingVolume,this.computedTransform,this._contentBoundingVolume)),t.viewerRequestVolume&&(this._viewerRequestVolume=pi(t.viewerRequestVolume,this.computedTransform,this._viewerRequestVolume)))}_updateTransform(t=new Jt.a){const e=t.clone().multiplyRight(this.transform);!e.equals(this.computedTransform)&&(this.computedTransform=e,this._updateBoundingVolume(this.header))}_getLoaderSpecificOptions(t){switch(t){case"i3s":return{...this.tileset.options.i3s,tile:this.header,tileset:this.tileset.tileset,isTileHeader:!1};case"3d-tiles":case"cesium-ion":default:return{assetGltfUpAxis:(e=this.tileset.tileset).asset&&e.asset.gltfUpAxis||"Y"}}var e}}class Pi extends Si{compareDistanceToCamera(t,e){return 0===e._distanceToCamera&&0===t._distanceToCamera?e._centerZDepth-t._centerZDepth:e._distanceToCamera-t._distanceToCamera}updateTileVisibility(t,e){if(super.updateTileVisibility(t,e),!t.isVisibleAndInRequestVolume)return;const n=t.children.length>0;if(t.hasTilesetContent&&n){const n=t.children[0];return this.updateTileVisibility(n,e),void(t._visible=n._visible)}if(this.meetsScreenSpaceErrorEarly(t,e))return void(t._visible=!1);const r=t.refine===ti,i=t._optimChildrenWithinParent===ui;r&&i&&n&&!this.anyChildrenVisible(t,e)&&(t._visible=!1)}meetsScreenSpaceErrorEarly(t,e){const{parent:n}=t;return!(!n||n.hasTilesetContent||n.refine!==$r)&&!this.shouldRefine(t,e,!0)}}class Mi{constructor(){Object(cr.a)(this,"frameNumberMap",new Map)}register(t,e){const n=this.frameNumberMap.get(t)||new Map,r=n.get(e)||0;n.set(e,r+1),this.frameNumberMap.set(t,n)}deregister(t,e){const n=this.frameNumberMap.get(t);if(!n)return;const r=n.get(e)||1;n.set(e,r-1)}isZero(t,e){var n;return 0===((null===(n=this.frameNumberMap.get(t))||void 0===n?void 0:n.get(e))||0)}}const Ii="REQUESTED",Bi="COMPLETED",Ri="ERROR";class ki{constructor(){Object(cr.a)(this,"_statusMap",void 0),Object(cr.a)(this,"pendingTilesRegister",new Mi),this._statusMap={}}add(t,e,n,r){if(!this._statusMap[e]){const{frameNumber:i,viewport:{id:o}}=r;this._statusMap[e]={request:t,callback:n,key:e,frameState:r,status:Ii},this.pendingTilesRegister.register(o,i),t().then(t=>{this._statusMap[e].status=Bi;const{frameNumber:n,viewport:{id:i}}=this._statusMap[e].frameState;this.pendingTilesRegister.deregister(i,n),this._statusMap[e].callback(t,r)}).catch(t=>{this._statusMap[e].status=Ri;const{frameNumber:r,viewport:{id:i}}=this._statusMap[e].frameState;this.pendingTilesRegister.deregister(i,r),n(t)})}}update(t,e){if(this._statusMap[t]){const{frameNumber:n,viewport:{id:r}}=this._statusMap[t].frameState;this.pendingTilesRegister.deregister(r,n);const{frameNumber:i,viewport:{id:o}}=e;this.pendingTilesRegister.register(o,i),this._statusMap[t].frameState=e}}find(t){return this._statusMap[t]}hasPendingTiles(t,e){return!this.pendingTilesRegister.isZero(t,e)}}class Di extends Si{traversalFinished(t){return!this._tileManager.hasPendingTiles(t.viewport.id,this._frameNumber||0)}constructor(t){super(t),Object(cr.a)(this,"_tileManager",void 0),this._tileManager=new ki}shouldRefine(t,e){return t._lodJudge=function(t,e){if(0===t.lodMetricValue||isNaN(t.lodMetricValue))return"DIG";const n=2*wi(t,e);return n<2?"OUT":!t.header.children||n<=t.lodMetricValue?"DRAW":t.header.children?"DIG":"OUT"}(t,e),"DIG"===t._lodJudge}updateChildTiles(t,e){const n=t.header.children||[],r=t.children,i=t.tileset;for(const o of n){const n="".concat(o.id,"-").concat(e.viewport.id),a=r&&r.find(t=>t.id===n);if(a)a&&this.updateTile(a,e);else{let r=()=>this._loadTile(o.id,i);this._tileManager.find(n)?this._tileManager.update(n,e):(i.tileset.nodePages&&(r=()=>i.tileset.nodePagesTile.formTileFromNodePages(o.id)),this._tileManager.add(r,n,e=>this._onTileLoad(e,t,n),e))}}return!1}async _loadTile(t,e){const{loader:n}=e,r=e.getTileUrl("".concat(e.url,"/nodes/").concat(t)),i={...e.loadOptions,i3s:{...e.loadOptions.i3s,isTileHeader:!0,loadContent:!1}};return await Object(ur.a)(r,n,i)}_onTileLoad(t,e,n){const r=new Ci(e.tileset,t,e,n);e.children.push(r);const i=this._tileManager.find(r.id).frameState;this.updateTile(r,i),this._frameNumber===i.frameNumber&&(this.traversalFinished(i)||(new Date).getTime()-this.lastUpdate>this.updateDebounceTime)&&this.executeTraversal(r,i)}}const Li={description:"",ellipsoid:Ir.WGS84,modelMatrix:new Jt.a,throttleRequests:!0,maxRequests:64,maximumMemoryUsage:32,maximumTilesSelected:0,debounceTime:0,onTileLoad:()=>{},onTileUnload:()=>{},onTileError:()=>{},onTraversalComplete:t=>t,contentLoader:void 0,viewDistanceScale:1,maximumScreenSpaceError:8,loadTiles:!0,updateTransforms:!0,viewportTraversersMap:null,loadOptions:{fetch:{}},attributions:[],basePath:"",i3s:{}},ji="Tiles In Tileset(s)";class Fi{constructor(t,e){Object(cr.a)(this,"options",void 0),Object(cr.a)(this,"loadOptions",void 0),Object(cr.a)(this,"type",void 0),Object(cr.a)(this,"tileset",void 0),Object(cr.a)(this,"loader",void 0),Object(cr.a)(this,"url",void 0),Object(cr.a)(this,"basePath",void 0),Object(cr.a)(this,"modelMatrix",void 0),Object(cr.a)(this,"ellipsoid",void 0),Object(cr.a)(this,"lodMetricType",void 0),Object(cr.a)(this,"lodMetricValue",void 0),Object(cr.a)(this,"refine",void 0),Object(cr.a)(this,"root",void 0),Object(cr.a)(this,"roots",void 0),Object(cr.a)(this,"asset",void 0),Object(cr.a)(this,"description",void 0),Object(cr.a)(this,"properties",void 0),Object(cr.a)(this,"extras",void 0),Object(cr.a)(this,"attributions",void 0),Object(cr.a)(this,"credits",void 0),Object(cr.a)(this,"stats",void 0),Object(cr.a)(this,"traverseCounter",void 0),Object(cr.a)(this,"geometricError",void 0),Object(cr.a)(this,"selectedTiles",void 0),Object(cr.a)(this,"updatePromise",null),Object(cr.a)(this,"tilesetInitializationPromise",void 0),Object(cr.a)(this,"cartographicCenter",void 0),Object(cr.a)(this,"cartesianCenter",void 0),Object(cr.a)(this,"zoom",void 0),Object(cr.a)(this,"boundingVolume",void 0),Object(cr.a)(this,"gpuMemoryUsageInBytes",void 0),Object(cr.a)(this,"dynamicScreenSpaceErrorComputedDensity",void 0),Object(cr.a)(this,"_traverser",void 0),Object(cr.a)(this,"_cache",void 0),Object(cr.a)(this,"_requestScheduler",void 0),Object(cr.a)(this,"_frameNumber",void 0),Object(cr.a)(this,"_queryParamsString",void 0),Object(cr.a)(this,"_queryParams",void 0),Object(cr.a)(this,"_extensionsUsed",void 0),Object(cr.a)(this,"_tiles",void 0),Object(cr.a)(this,"_pendingCount",void 0),Object(cr.a)(this,"lastUpdatedVieports",void 0),Object(cr.a)(this,"_requestedTiles",void 0),Object(cr.a)(this,"_emptyTiles",void 0),Object(cr.a)(this,"frameStateData",void 0),Object(cr.a)(this,"maximumMemoryUsage",void 0),Object(Rr.a)(t),this.options={...Li,...e},this.tileset=t,this.loader=t.loader,this.type=t.type,this.url=t.url,this.basePath=t.basePath||kr.b.dirname(this.url),this.modelMatrix=this.options.modelMatrix,this.ellipsoid=this.options.ellipsoid,this.lodMetricType=t.lodMetricType,this.lodMetricValue=t.lodMetricValue,this.refine=t.root.refine,this.loadOptions=this.options.loadOptions||{},this.root=null,this.roots={},this.cartographicCenter=null,this.cartesianCenter=null,this.zoom=1,this.boundingVolume=null,this.traverseCounter=0,this.geometricError=0,this._traverser=this._initializeTraverser(),this._cache=new Fr,this._requestScheduler=new Le.a({throttleRequests:this.options.throttleRequests,maxRequests:this.options.maxRequests}),this._frameNumber=0,this._pendingCount=0,this._tiles={},this.selectedTiles=[],this._emptyTiles=[],this._requestedTiles=[],this.frameStateData={},this.lastUpdatedVieports=null,this._queryParams={},this._queryParamsString="",this.maximumMemoryUsage=this.options.maximumMemoryUsage||32,this.gpuMemoryUsageInBytes=0,this.stats=new Br.a({id:this.url}),this._initializeStats(),this._extensionsUsed=void 0,this.dynamicScreenSpaceErrorComputedDensity=0,this.extras=null,this.asset={},this.credits={},this.description=this.options.description||"",this.tilesetInitializationPromise=this._initializeTileSet(t)}destroy(){this._destroy()}isLoaded(){return 0===this._pendingCount&&0!==this._frameNumber&&0===this._requestedTiles.length}get tiles(){return Object.values(this._tiles)}get frameNumber(){return this._frameNumber}get queryParams(){return this._queryParamsString||(this._queryParamsString=function(t){const e=[];for(const n of Object.keys(t))e.push("".concat(n,"=").concat(t[n]));switch(e.length){case 0:return"";case 1:return"?".concat(e[0]);default:return"?".concat(e.join("&"))}}(this._queryParams)),this._queryParamsString}setProps(t){this.options={...this.options,...t}}setOptions(t){this.options={...this.options,...t}}getTileUrl(t){return t.startsWith("data:")?t:"".concat(t).concat(this.queryParams)}hasExtension(t){return Boolean(this._extensionsUsed&&this._extensionsUsed.indexOf(t)>-1)}update(t=null){this.tilesetInitializationPromise.then(()=>{!t&&this.lastUpdatedVieports?t=this.lastUpdatedVieports:this.lastUpdatedVieports=t,t&&this.doUpdate(t)})}async selectTiles(t=null){return await this.tilesetInitializationPromise,t&&(this.lastUpdatedVieports=t),this.updatePromise||(this.updatePromise=new Promise(t=>{setTimeout(()=>{this.lastUpdatedVieports&&this.doUpdate(this.lastUpdatedVieports),t(this._frameNumber),this.updatePromise=null},this.options.debounceTime)})),this.updatePromise}doUpdate(t){if("loadTiles"in this.options&&!this.options.loadTiles)return;if(this.traverseCounter>0)return;const e=t instanceof Array?t:[t];this._cache.reset(),this._frameNumber++,this.traverseCounter=e.length;const n=[];for(const t of e){const e=t.id;this._needTraverse(e)?n.push(e):this.traverseCounter--}for(const t of e){const e=t.id;if(this.roots[e]||(this.roots[e]=this._initializeTileHeaders(this.tileset,null)),!n.includes(e))continue;const r=Gr(t,this._frameNumber);this._traverser.traverse(this.roots[e],r,this.options)}}_needTraverse(t){let e=t;return this.options.viewportTraversersMap&&(e=this.options.viewportTraversersMap[t]),e===t}_onTraversalEnd(t){const e=t.viewport.id;this.frameStateData[e]||(this.frameStateData[e]={selectedTiles:[],_requestedTiles:[],_emptyTiles:[]});const n=this.frameStateData[e],r=Object.values(this._traverser.selectedTiles),[i,o]=function(t,e,n){if(0===n||t.length<=n)return[t,[]];const r=[],{longitude:i,latitude:o}=e.viewport;for(const[e,n]of t.entries()){const[t,a]=n.header.mbs,s=Math.abs(i-t),u=Math.abs(o-a),c=Math.sqrt(u*u+s*s);r.push([e,c])}const a=r.sort((t,e)=>t[1]-e[1]),s=[];for(let e=0;e<n;e++)s.push(t[a[e][0]]);const u=[];for(let e=n;e<a.length;e++)u.push(t[a[e][0]]);return[s,u]}(r,t,this.options.maximumTilesSelected);n.selectedTiles=i;for(const t of o)t.unselect();n._requestedTiles=Object.values(this._traverser.requestedTiles),n._emptyTiles=Object.values(this._traverser.emptyTiles),this.traverseCounter--,this.traverseCounter>0||this._updateTiles()}_updateTiles(){this.selectedTiles=[],this._requestedTiles=[],this._emptyTiles=[];for(const t in this.frameStateData){const e=this.frameStateData[t];this.selectedTiles=this.selectedTiles.concat(e.selectedTiles),this._requestedTiles=this._requestedTiles.concat(e._requestedTiles),this._emptyTiles=this._emptyTiles.concat(e._emptyTiles)}this.selectedTiles=this.options.onTraversalComplete(this.selectedTiles);for(const t of this.selectedTiles)this._tiles[t.id]=t;this._loadTiles(),this._unloadTiles(),this._updateStats()}_tilesChanged(t,e){if(t.length!==e.length)return!0;const n=new Set(t.map(t=>t.id)),r=new Set(e.map(t=>t.id));let i=t.filter(t=>!r.has(t.id)).length>0;return i=i||e.filter(t=>!n.has(t.id)).length>0,i}_loadTiles(){for(const t of this._requestedTiles)t.contentUnloaded&&this._loadTile(t)}_unloadTiles(){this._cache.unloadTiles(this,(t,e)=>t._unloadTile(e))}_updateStats(){let t=0,e=0;for(const n of this.selectedTiles)n.contentAvailable&&n.content&&(t++,n.content.pointCount?e+=n.content.pointCount:e+=n.content.vertexCount);this.stats.get("Tiles In View").count=this.selectedTiles.length,this.stats.get("Tiles To Render").count=t,this.stats.get("Points/Vertices").count=e}async _initializeTileSet(t){this.type===oi&&(this.calculateViewPropsI3S(),t.root=await t.root),this.root=this._initializeTileHeaders(t,null),this.type===ai&&(this._initializeTiles3DTileset(t),this.calculateViewPropsTiles3D()),this.type===oi&&this._initializeI3STileset()}calculateViewPropsI3S(){var t;const e=this.tileset.fullExtent;if(e){const{xmin:t,xmax:n,ymin:r,ymax:i,zmin:o,zmax:a}=e;return this.cartographicCenter=new rt.a(t+(n-t)/2,r+(i-r)/2,o+(a-o)/2),this.cartesianCenter=Ir.WGS84.cartographicToCartesian(this.cartographicCenter,new rt.a),void(this.zoom=Xr(e,this.cartographicCenter,this.cartesianCenter))}const n=null===(t=this.tileset.store)||void 0===t?void 0:t.extent;if(n){const[t,e,r,i]=n;return this.cartographicCenter=new rt.a(t+(r-t)/2,e+(i-e)/2,0),this.cartesianCenter=Ir.WGS84.cartographicToCartesian(this.cartographicCenter,new rt.a),void(this.zoom=function(t,e,n){const[r,i,o,a]=t;return Xr({xmin:r,xmax:o,ymin:i,ymax:a,zmin:0,zmax:0},e,n)}(n,this.cartographicCenter,this.cartesianCenter))}console.warn("Extent is not defined in the tileset header"),this.cartographicCenter=new rt.a,this.zoom=1}calculateViewPropsTiles3D(){const t=this.root;Object(Rr.a)(t);const{center:e}=t.boundingVolume;if(!e)return console.warn("center was not pre-calculated for the root tile"),this.cartographicCenter=new rt.a,void(this.zoom=1);0!==e[0]||0!==e[1]||0!==e[2]?this.cartographicCenter=Ir.WGS84.cartesianToCartographic(e,new rt.a):this.cartographicCenter=new rt.a(0,0,-Ir.WGS84.radii[0]),this.cartesianCenter=e,this.zoom=qr(t.boundingVolume,this.cartographicCenter)}_initializeStats(){this.stats.get(ji),this.stats.get("Tiles Loading"),this.stats.get("Tiles In Memory"),this.stats.get("Tiles In View"),this.stats.get("Tiles To Render"),this.stats.get("Tiles Loaded"),this.stats.get("Tiles Unloaded"),this.stats.get("Failed Tile Loads"),this.stats.get("Points/Vertices","memory"),this.stats.get("Tile Memory Use","memory")}_initializeTileHeaders(t,e){const n=new Ci(this,t.root,e);if(e&&(e.children.push(n),n.depth=e.depth+1),this.type===ai){const t=[];for(t.push(n);t.length>0;){const e=t.pop();this.stats.get(ji).incrementCount();const n=e.header.children||[];for(const r of n){const n=new Ci(this,r,e);e.children.push(n),n.depth=e.depth+1,t.push(n)}}}return n}_initializeTraverser(){let t;switch(this.type){case ai:t=Pi;break;case oi:t=Di;break;default:t=Si}return new t({basePath:this.basePath,onTraversalEnd:this._onTraversalEnd.bind(this)})}_destroyTileHeaders(t){this._destroySubtree(t)}async _loadTile(t){let e;try{this._onStartTileLoading(),e=await t.loadContent()}catch(e){this._onTileLoadError(t,e)}finally{this._onEndTileLoading(),this._onTileLoad(t,e)}}_onTileLoadError(t,e){this.stats.get("Failed Tile Loads").incrementCount();const n=e.message||e.toString(),r=t.url;console.error("A 3D tile failed to load: ".concat(t.url," ").concat(n)),this.options.onTileError(t,n,r)}_onTileLoad(t,e){if(e){if(this.type===oi){var n,r;const t=(null===(n=this.tileset)||void 0===n||null===(r=n.nodePagesTile)||void 0===r?void 0:r.nodesInNodePages)||0;this.stats.get(ji).reset(),this.stats.get(ji).addCount(t)}t&&t.content&&function(t,e){Object(Rr.a)(t),Object(Rr.a)(e);const{rtcCenter:n,gltfUpAxis:r}=e,{computedTransform:i,boundingVolume:{center:o}}=t;let a=new Jt.a(i);switch(n&&a.translate(n),r){case"Z":break;case"Y":const t=(new Jt.a).rotateX(Math.PI/2);a=a.multiplyRight(t);break;case"X":const e=(new Jt.a).rotateY(-Math.PI/2);a=a.multiplyRight(e)}e.isQuantized&&a.translate(e.quantizedVolumeOffset).scale(e.quantizedVolumeScale);const s=new rt.a(o);e.cartesianModelMatrix=a,e.cartesianOrigin=s;const u=Ir.WGS84.cartesianToCartographic(s,new rt.a),c=Ir.WGS84.eastNorthUpToFixedFrame(s).invert();e.cartographicModelMatrix=c.multiplyRight(a),e.cartographicOrigin=u,e.coordinateSystem||(e.modelMatrix=e.cartographicModelMatrix)}(t,t.content),this._addTileToCache(t),this.options.onTileLoad(t)}}_onStartTileLoading(){this._pendingCount++,this.stats.get("Tiles Loading").incrementCount()}_onEndTileLoading(){this._pendingCount--,this.stats.get("Tiles Loading").decrementCount()}_addTileToCache(t){this._cache.add(this,t,e=>e._updateCacheStats(t))}_updateCacheStats(t){this.stats.get("Tiles Loaded").incrementCount(),this.stats.get("Tiles In Memory").incrementCount(),this.gpuMemoryUsageInBytes+=t.content.byteLength||0,this.stats.get("Tile Memory Use").count=this.gpuMemoryUsageInBytes}_unloadTile(t){this.gpuMemoryUsageInBytes-=t.content&&t.content.byteLength||0,this.stats.get("Tiles In Memory").decrementCount(),this.stats.get("Tiles Unloaded").incrementCount(),this.stats.get("Tile Memory Use").count=this.gpuMemoryUsageInBytes,this.options.onTileUnload(t),t.unloadContent()}_destroy(){const t=[];for(this.root&&t.push(this.root);t.length>0;){const e=t.pop();for(const n of e.children)t.push(n);this._destroyTile(e)}this.root=null}_destroySubtree(t){const e=t,n=[];for(n.push(e);n.length>0;){t=n.pop();for(const e of t.children)n.push(e);t!==e&&this._destroyTile(t)}e.children=[]}_destroyTile(t){this._cache.unloadTile(this,t),this._unloadTile(t),t.destroy()}_initializeTiles3DTileset(t){if(this.asset=t.asset,!this.asset)throw new Error("Tileset must have an asset property.");if("0.0"!==this.asset.version&&"1.0"!==this.asset.version)throw new Error("The tileset must be 3D Tiles version 0.0 or 1.0.");"tilesetVersion"in this.asset&&(this._queryParams.v=this.asset.tilesetVersion),this.credits={attributions:this.options.attributions||[]},this.description=this.options.description||"",this.properties=t.properties,this.geometricError=t.geometricError,this._extensionsUsed=t.extensionsUsed,this.extras=t.extras}_initializeI3STileset(){this.loadOptions.i3s&&"token"in this.loadOptions.i3s&&(this._queryParams.token=this.loadOptions.i3s.token)}}const zi={COMPOSITE:"cmpt",POINT_CLOUD:"pnts",BATCHED_3D_MODEL:"b3dm",INSTANCED_3D_MODEL:"i3dm",GEOMETRY:"geom",VECTOR:"vect",GLTF:"glTF"};Object.keys(zi);function Ui(t,e,n){Object(Rr.a)(t instanceof ArrayBuffer);const r=new TextDecoder("utf8"),i=new Uint8Array(t,e,n);return r.decode(i)}var Ni=n(185);const Gi={BYTE:5120,UNSIGNED_BYTE:5121,SHORT:5122,UNSIGNED_SHORT:5123,INT:5124,UNSIGNED_INT:5125,FLOAT:5126,DOUBLE:5130},Vi={POINTS:0,LINES:1,LINE_LOOP:2,LINE_STRIP:3,TRIANGLES:4,TRIANGLE_STRIP:5,TRIANGLE_FAN:6,...Gi},Hi={[Gi.DOUBLE]:Float64Array,[Gi.FLOAT]:Float32Array,[Gi.UNSIGNED_SHORT]:Uint16Array,[Gi.UNSIGNED_INT]:Uint32Array,[Gi.UNSIGNED_BYTE]:Uint8Array,[Gi.BYTE]:Int8Array,[Gi.SHORT]:Int16Array,[Gi.INT]:Int32Array},Wi={DOUBLE:Gi.DOUBLE,FLOAT:Gi.FLOAT,UNSIGNED_SHORT:Gi.UNSIGNED_SHORT,UNSIGNED_INT:Gi.UNSIGNED_INT,UNSIGNED_BYTE:Gi.UNSIGNED_BYTE,BYTE:Gi.BYTE,SHORT:Gi.SHORT,INT:Gi.INT};class qi{static fromTypedArray(t){t=ArrayBuffer.isView(t)?t.constructor:t;for(const e in Hi){if(Hi[e]===t)return e}throw new Error("Failed to convert GL type")}static fromName(t){const e=Wi[t];if(!e)throw new Error("Failed to convert GL type");return e}static getArrayType(t){switch(t){case Gi.UNSIGNED_SHORT_5_6_5:case Gi.UNSIGNED_SHORT_4_4_4_4:case Gi.UNSIGNED_SHORT_5_5_5_1:return Uint16Array;default:const e=Hi[t];if(!e)throw new Error("Failed to convert GL type");return e}}static getByteSize(t){return qi.getArrayType(t).BYTES_PER_ELEMENT}static validate(t){return Boolean(qi.getArrayType(t))}static createTypedArray(t,e,n=0,r){void 0===r&&(r=(e.byteLength-n)/qi.getByteSize(t));return new(qi.getArrayType(t))(e,n,r)}}class Xi{constructor(t,e){Object(cr.a)(this,"json",void 0),Object(cr.a)(this,"buffer",void 0),Object(cr.a)(this,"featuresLength",0),Object(cr.a)(this,"_cachedTypedArrays",{}),this.json=t,this.buffer=e}getExtension(t){return this.json.extensions&&this.json.extensions[t]}hasProperty(t){return Boolean(this.json[t])}getGlobalProperty(t,e=Vi.UNSIGNED_INT,n=1){const r=this.json[t];return r&&Number.isFinite(r.byteOffset)?this._getTypedArrayFromBinary(t,e,n,1,r.byteOffset):r}getPropertyArray(t,e,n){const r=this.json[t];return r&&Number.isFinite(r.byteOffset)?("componentType"in r&&(e=qi.fromName(r.componentType)),this._getTypedArrayFromBinary(t,e,n,this.featuresLength,r.byteOffset)):this._getTypedArrayFromArray(t,e,r)}getProperty(t,e,n,r,i){const o=this.json[t];if(!o)return o;const a=this.getPropertyArray(t,e,n);if(1===n)return a[r];for(let t=0;t<n;++t)i[t]=a[n*r+t];return i}_getTypedArrayFromBinary(t,e,n,r,i){const o=this._cachedTypedArrays;let a=o[t];return a||(a=qi.createTypedArray(e,this.buffer.buffer,this.buffer.byteOffset+i,r*n),o[t]=a),a}_getTypedArrayFromArray(t,e,n){const r=this._cachedTypedArrays;let i=r[t];return i||(i=qi.createTypedArray(e,n),r[t]=i),i}}const Zi={SCALAR:1,VEC2:2,VEC3:3,VEC4:4,MAT2:4,MAT3:9,MAT4:16},Ji={SCALAR:(t,e)=>t[e],VEC2:(t,e)=>[t[2*e+0],t[2*e+1]],VEC3:(t,e)=>[t[3*e+0],t[3*e+1],t[3*e+2]],VEC4:(t,e)=>[t[4*e+0],t[4*e+1],t[4*e+2],t[4*e+3]],MAT2:(t,e)=>[t[4*e+0],t[4*e+1],t[4*e+2],t[4*e+3]],MAT3:(t,e)=>[t[9*e+0],t[9*e+1],t[9*e+2],t[9*e+3],t[9*e+4],t[9*e+5],t[9*e+6],t[9*e+7],t[9*e+8]],MAT4:(t,e)=>[t[16*e+0],t[16*e+1],t[16*e+2],t[16*e+3],t[16*e+4],t[16*e+5],t[16*e+6],t[16*e+7],t[16*e+8],t[16*e+9],t[16*e+10],t[16*e+11],t[16*e+12],t[16*e+13],t[16*e+14],t[16*e+15]]},Qi={SCALAR:(t,e,n)=>{e[n]=t},VEC2:(t,e,n)=>{e[2*n+0]=t[0],e[2*n+1]=t[1]},VEC3:(t,e,n)=>{e[3*n+0]=t[0],e[3*n+1]=t[1],e[3*n+2]=t[2]},VEC4:(t,e,n)=>{e[4*n+0]=t[0],e[4*n+1]=t[1],e[4*n+2]=t[2],e[4*n+3]=t[3]},MAT2:(t,e,n)=>{e[4*n+0]=t[0],e[4*n+1]=t[1],e[4*n+2]=t[2],e[4*n+3]=t[3]},MAT3:(t,e,n)=>{e[9*n+0]=t[0],e[9*n+1]=t[1],e[9*n+2]=t[2],e[9*n+3]=t[3],e[9*n+4]=t[4],e[9*n+5]=t[5],e[9*n+6]=t[6],e[9*n+7]=t[7],e[9*n+8]=t[8],e[9*n+9]=t[9]},MAT4:(t,e,n)=>{e[16*n+0]=t[0],e[16*n+1]=t[1],e[16*n+2]=t[2],e[16*n+3]=t[3],e[16*n+4]=t[4],e[16*n+5]=t[5],e[16*n+6]=t[6],e[16*n+7]=t[7],e[16*n+8]=t[8],e[16*n+9]=t[9],e[16*n+10]=t[10],e[16*n+11]=t[11],e[16*n+12]=t[12],e[16*n+13]=t[13],e[16*n+14]=t[14],e[16*n+15]=t[15]}};const Ki=t=>void 0!==t;function Yi(t,e,n){if(!e)return null;let r=t.getExtension("3DTILES_batch_table_hierarchy");const i=e.HIERARCHY;return i&&(console.warn("3D Tile Parser: HIERARCHY is deprecated. Use 3DTILES_batch_table_hierarchy."),e.extensions=e.extensions||{},e.extensions["3DTILES_batch_table_hierarchy"]=i,r=i),r?function(t,e){let n,r,i;const o=t.instancesLength,a=t.classes;let s,u=t.classIds,c=t.parentCounts,l=t.parentIds,h=o;Ki(u.byteOffset)&&(u.componentType=defaultValue(u.componentType,GL.UNSIGNED_SHORT),u.type=AttributeType.SCALAR,i=getBinaryAccessor(u),u=i.createArrayBufferView(e.buffer,e.byteOffset+u.byteOffset,o));if(Ki(c))for(Ki(c.byteOffset)&&(c.componentType=defaultValue(c.componentType,GL.UNSIGNED_SHORT),c.type=AttributeType.SCALAR,i=getBinaryAccessor(c),c=i.createArrayBufferView(e.buffer,e.byteOffset+c.byteOffset,o)),s=new Uint16Array(o),h=0,n=0;n<o;++n)s[n]=h,h+=c[n];Ki(l)&&Ki(l.byteOffset)&&(l.componentType=defaultValue(l.componentType,GL.UNSIGNED_SHORT),l.type=AttributeType.SCALAR,i=getBinaryAccessor(l),l=i.createArrayBufferView(e.buffer,e.byteOffset+l.byteOffset,h));const f=a.length;for(n=0;n<f;++n){const t=a[n].length,r=a[n].instances,i=getBinaryProperties(t,r,e);a[n].instances=combine(i,r)}const p=new Array(f).fill(0),d=new Uint16Array(o);for(n=0;n<o;++n)r=u[n],d[n]=p[r],++p[r];const A={classes:a,classIds:u,classIndexes:d,parentCounts:c,parentIndexes:s,parentIds:l};return function(t){const e=t.classIds.length;for(let n=0;n<e;++n)to(t,n,stack)}(A),A}(r,n):null}function $i(t,e,n){if(!t)return;const r=t.parentCounts;return t.parentIds?n(t,e):r>0?function(t,e,n){const r=t.classIds,i=t.parentCounts,o=t.parentIds,a=t.parentIndexes,s=r.length,u=scratchVisited;u.length=Math.max(u.length,s);const c=++marker,l=scratchStack;l.length=0,l.push(e);for(;l.length>0;){if(e=l.pop(),u[e]===c)continue;u[e]=c;const r=n(t,e);if(Ki(r))return r;const s=i[e],h=a[e];for(let t=0;t<s;++t){const n=o[h+t];n!==e&&l.push(n)}}return null}(t,e,n):function(t,e,n){let r=!0;for(;r;){const i=n(t,e);if(Ki(i))return i;const o=t.parentIds[e];r=o!==e,e=o}throw new Error("traverseHierarchySingleParent")}(t,e,n)}function to(t,e,n){const r=t.parentCounts,i=t.parentIds,o=t.parentIndexes,a=t.classIds.length;if(!Ki(i))return;assert(e<a,"Parent index ".concat(e," exceeds the total number of instances: ").concat(a)),assert(-1===n.indexOf(e),"Circular dependency detected in the batch table hierarchy."),n.push(e);const s=Ki(r)?r[e]:1,u=Ki(r)?o[e]:e;for(let r=0;r<s;++r){const o=i[u+r];o!==e&&to(t,o,n)}n.pop(e)}function eo(t){return null!=t}const no=(t,e)=>t,ro={HIERARCHY:!0,extensions:!0,extras:!0};class io{constructor(t,e,n,r={}){var i;Object(cr.a)(this,"json",void 0),Object(cr.a)(this,"binary",void 0),Object(cr.a)(this,"featureCount",void 0),Object(cr.a)(this,"_extensions",void 0),Object(cr.a)(this,"_properties",void 0),Object(cr.a)(this,"_binaryProperties",void 0),Object(cr.a)(this,"_hierarchy",void 0),Object(Rr.a)(n>=0),this.json=t||{},this.binary=e,this.featureCount=n,this._extensions=(null===(i=this.json)||void 0===i?void 0:i.extensions)||{},this._properties={};for(const t in this.json)ro[t]||(this._properties[t]=this.json[t]);this._binaryProperties=this._initializeBinaryProperties(),r["3DTILES_batch_table_hierarchy"]&&(this._hierarchy=Yi(this,this.json,this.binary))}getExtension(t){return this.json&&this.json.extensions&&this.json.extensions[t]}memorySizeInBytes(){return 0}isClass(t,e){if(this._checkBatchId(t),Object(Rr.a)("string"==typeof e,e),this._hierarchy){return eo($i(this._hierarchy,t,(t,n)=>{const r=t.classIds[n];return t.classes[r].name===e}))}return!1}isExactClass(t,e){return Object(Rr.a)("string"==typeof e,e),this.getExactClassName(t)===e}getExactClassName(t){if(this._checkBatchId(t),this._hierarchy){const e=this._hierarchy.classIds[t];return this._hierarchy.classes[e].name}}hasProperty(t,e){return this._checkBatchId(t),Object(Rr.a)("string"==typeof e,e),eo(this._properties[e])||this._hasPropertyInHierarchy(t,e)}getPropertyNames(t,e){this._checkBatchId(t),(e=eo(e)?e:[]).length=0;const n=Object.keys(this._properties);return e.push(...n),this._hierarchy&&this._getPropertyNamesInHierarchy(t,e),e}getProperty(t,e){if(this._checkBatchId(t),Object(Rr.a)("string"==typeof e,e),this._binaryProperties){const n=this._binaryProperties[e];if(eo(n))return this._getBinaryProperty(n,t)}const n=this._properties[e];if(eo(n))return no(n[t]);if(this._hierarchy){const n=this._getHierarchyProperty(t,e);if(eo(n))return n}}setProperty(t,e,n){const r=this.featureCount;if(this._checkBatchId(t),Object(Rr.a)("string"==typeof e,e),this._binaryProperties){const r=this._binaryProperties[e];if(r)return void this._setBinaryProperty(r,t,n)}if(this._hierarchy&&this._setHierarchyProperty(this,t,e,n))return;let i=this._properties[e];eo(i)||(this._properties[e]=new Array(r),i=this._properties[e]),i[t]=no(n)}_checkBatchId(t){if(!(t>=0&&t<this.featureCount))throw new Error("batchId not in range [0, featureCount - 1].")}_getBinaryProperty(t,e){return t.unpack(t.typedArray,e)}_setBinaryProperty(t,e,n){t.pack(n,t.typedArray,e)}_initializeBinaryProperties(){let t=null;for(const e in this._properties){const n=this._properties[e],r=this._initializeBinaryProperty(e,n);r&&(t=t||{},t[e]=r)}return t}_initializeBinaryProperty(t,e){if("byteOffset"in e){const n=e;Object(Rr.a)(this.binary,"Property ".concat(t," requires a batch table binary.")),Object(Rr.a)(n.type,"Property ".concat(t," requires a type."));const r=function(t,e,n,r){const{componentType:i}=t;Object(Rr.a)(t.componentType);const o="string"==typeof i?qi.fromName(i):i,a=Zi[t.type],s=Ji[t.type],u=Qi[t.type];return n+=t.byteOffset,{values:qi.createTypedArray(o,e,n,a*r),type:o,size:a,unpacker:s,packer:u}}(n,this.binary.buffer,0|this.binary.byteOffset,this.featureCount);return{typedArray:r.values,componentCount:r.size,unpack:r.unpacker,pack:r.packer}}return null}_hasPropertyInHierarchy(t,e){if(!this._hierarchy)return!1;const n=$i(this._hierarchy,t,(t,n)=>{const r=t.classIds[n];return eo(t.classes[r].instances[e])});return eo(n)}_getPropertyNamesInHierarchy(t,e){$i(this._hierarchy,t,(t,n)=>{const r=t.classIds[n],i=t.classes[r].instances;for(const t in i)i.hasOwnProperty(t)&&-1===e.indexOf(t)&&e.push(t)})}_getHierarchyProperty(t,e){return $i(this._hierarchy,t,(t,n)=>{const r=t.classIds[n],i=t.classes[r],o=t.classIndexes[n],a=i.instances[e];return eo(a)?eo(a.typedArray)?this._getBinaryProperty(a,o):no(a[o]):null})}_setHierarchyProperty(t,e,n,r){const i=$i(this._hierarchy,e,(t,i)=>{const o=t.classIds[i],a=t.classes[o],s=t.classIndexes[i],u=a.instances[n];return!!eo(u)&&(Object(Rr.a)(i===e,'Inherited property "'.concat(n,'" is read-only.')),eo(u.typedArray)?this._setBinaryProperty(u,s,r):u[s]=no(r),!0)});return eo(i)}}function oo(t,e,n=0){const r=new DataView(e);if(t.magic=r.getUint32(n,!0),n+=4,t.version=r.getUint32(n,!0),n+=4,t.byteLength=r.getUint32(n,!0),n+=4,1!==t.version)throw new Error("3D Tile Version ".concat(t.version," not supported"));return n}function ao(t,e,n){const r=new DataView(e);let i;t.header=t.header||{};let o=r.getUint32(n,!0);n+=4;let a=r.getUint32(n,!0);n+=4;let s=r.getUint32(n,!0);n+=4;let u=r.getUint32(n,!0);return n+=4,s>=570425344?(n-=8,i=o,s=a,u=0,o=0,a=0,console.warn("b3dm tile in legacy format.")):u>=570425344&&(n-=4,i=s,s=o,u=a,o=0,a=0,console.warn("b3dm tile in legacy format.")),t.header.featureTableJsonByteLength=o,t.header.featureTableBinaryByteLength=a,t.header.batchTableJsonByteLength=s,t.header.batchTableBinaryByteLength=u,t.header.batchLength=i,n}function so(t,e,n,r){return n=function(t,e,n,r){const{featureTableJsonByteLength:i,featureTableBinaryByteLength:o,batchLength:a}=t.header;if(t.featureTableJson={BATCH_LENGTH:a||0},i>0){const r=Ui(e,n,i);t.featureTableJson=JSON.parse(r)}return n+=i,t.featureTableBinary=new Uint8Array(e,n,o),n+=o}(t,e,n),n=function(t,e,n,r){const{batchTableJsonByteLength:i,batchTableBinaryByteLength:o}=t.header;if(i>0){const r=Ui(e,n,i);t.batchTableJson=JSON.parse(r),n+=i,o>0&&(t.batchTableBinary=new Uint8Array(e,n,o),t.batchTableBinary=new Uint8Array(t.batchTableBinary),n+=o)}return n}(t,e,n)}function uo(t,e=[0,0,0]){const n=t>>11&31,r=t>>5&63,i=31&t;return e[0]=n<<3,e[1]=r<<2,e[2]=i<<3,e}function co(t,e,n){if(!(e||t&&t.batchIds&&n))return null;const{batchIds:r,isRGB565:i,pointCount:o}=t;if(r&&n){const t=new Uint8ClampedArray(3*o);for(let e=0;e<o;e++){const i=r[e],o=n.getProperty(i,"dimensions").map(t=>255*t);t[3*e]=o[0],t[3*e+1]=o[1],t[3*e+2]=o[2]}return{type:Vi.UNSIGNED_BYTE,value:t,size:3,normalized:!0}}if(i){const t=new Uint8ClampedArray(3*o);for(let n=0;n<o;n++){const r=uo(e[n]);t[3*n]=r[0],t[3*n+1]=r[1],t[3*n+2]=r[2]}return{type:Vi.UNSIGNED_BYTE,value:t,size:3,normalized:!0}}return e&&e.length===3*o?{type:Vi.UNSIGNED_BYTE,value:e,size:3,normalized:!0}:{type:Vi.UNSIGNED_BYTE,value:e,size:4,normalized:!0}}function lo(t,e){if(!t)throw new Error("math.gl assertion failed. ".concat(e))}new Qt.a,new rt.a,new Qt.a,new Qt.a,new Uint8Array(1);function ho(t,e=255){return Object(Nt.a)(t,0,e)/e*2-1}function fo(t){return t<0?-1:1}function po(t,e,n,r){if(lo(r),t<0||t>n||e<0||e>n)throw new Error("x and y must be unsigned normalized integers between 0 and ".concat(n));if(r.x=ho(t,n),r.y=ho(e,n),r.z=1-(Math.abs(r.x)+Math.abs(r.y)),r.z<0){const t=r.x;r.x=(1-Math.abs(r.y))*fo(t),r.y=(1-Math.abs(t))*fo(r.y)}return r.normalize()}function Ao(t,e,n){return po(t,e,255,n)}const go=new rt.a;function mo(t,e,n){return t.isQuantized?n["3d-tiles"]&&n["3d-tiles"].decodeQuantizedPositions?(t.isQuantized=!1,function(t,e){const n=new rt.a,r=new Float32Array(3*t.pointCount);for(let i=0;i<t.pointCount;i++)n.set(e[3*i],e[3*i+1],e[3*i+2]).scale(1/t.quantizedRange).multiply(t.quantizedVolumeScale).add(t.quantizedVolumeOffset).toArray(r,3*i);return r}(t,e)):{type:Vi.UNSIGNED_SHORT,value:e,size:3,normalized:!0}:e}async function yo(t,e,n,r,i){n=so(t,e,n=ao(t,e,n=oo(t,e,n))),function(t){t.attributes={positions:null,colors:null,normals:null,batchIds:null},t.isQuantized=!1,t.isTranslucent=!1,t.isRGB565=!1,t.isOctEncoded16P=!1}(t);const{featureTable:o,batchTable:a}=function(t){const e=new Xi(t.featureTableJson,t.featureTableBinary),n=e.getGlobalProperty("POINTS_LENGTH");if(!Number.isFinite(n))throw new Error("POINTS_LENGTH must be defined");e.featuresLength=n,t.featuresLength=n,t.pointsLength=n,t.pointCount=n,t.rtcCenter=e.getGlobalProperty("RTC_CENTER",Vi.FLOAT,3);const r=function(t,e){let n=null;if(!t.batchIds&&e.hasProperty("BATCH_ID")&&(t.batchIds=e.getPropertyArray("BATCH_ID",Vi.UNSIGNED_SHORT,1),t.batchIds)){const r=e.getGlobalProperty("BATCH_LENGTH");if(!r)throw new Error("Global property: BATCH_LENGTH must be defined when BATCH_ID is defined.");const{batchTableJson:i,batchTableBinary:o}=t;n=new io(i,o,r)}return n}(t,e);return{featureTable:e,batchTable:r}}(t);return await async function(t,e,n,r,i){let o,a,s;const u=t.batchTableJson&&t.batchTableJson.extensions&&t.batchTableJson.extensions["3DTILES_draco_point_compression"];u&&(s=u.properties);const c=e.getExtension("3DTILES_draco_point_compression");if(c){a=c.properties;const e=c.byteOffset,n=c.byteLength;if(!a||!Number.isFinite(e)||!n)throw new Error("Draco properties, byteOffset, and byteLength must be defined");o=t.featureTableBinary.slice(e,e+n),t.hasPositions=Number.isFinite(a.POSITION),t.hasColors=Number.isFinite(a.RGB)||Number.isFinite(a.RGBA),t.hasNormals=Number.isFinite(a.NORMAL),t.hasBatchIds=Number.isFinite(a.BATCH_ID),t.isTranslucent=Number.isFinite(a.RGBA)}if(!o)return!0;const l={buffer:o,properties:{...a,...s},featureTableProperties:a,batchTableProperties:s,dequantizeInShader:!1};return await async function(t,e,n,r){const{parse:i}=r,o={...n,draco:{...n.draco,extraAttributes:e.batchTableProperties||{}}};delete o["3d-tiles"];const a=await i(e.buffer,Ni.a,o),s=a.attributes.POSITION&&a.attributes.POSITION.value,u=a.attributes.COLOR_0&&a.attributes.COLOR_0.value,c=a.attributes.NORMAL&&a.attributes.NORMAL.value,l=a.attributes.BATCH_ID&&a.attributes.BATCH_ID.value,h=s&&a.attributes.POSITION.value.quantization,f=c&&a.attributes.NORMAL.value.quantization;if(h){const e=a.POSITION.data.quantization,n=e.range;t.quantizedVolumeScale=new rt.a(n,n,n),t.quantizedVolumeOffset=new rt.a(e.minValues),t.quantizedRange=(1<<e.quantizationBits)-1,t.isQuantizedDraco=!0}f&&(t.octEncodedRange=(1<<a.NORMAL.data.quantization.quantizationBits)-1,t.isOctEncodedDraco=!0);const p={};if(e.batchTableProperties)for(const t of Object.keys(e.batchTableProperties))a.attributes[t]&&a.attributes[t].value&&(p[t.toLowerCase()]=a.attributes[t].value);t.attributes={positions:s,colors:co(t,u,void 0),normals:c,batchIds:l,...p}}(t,l,r,i)}(t,o,0,r,i),function(t,e,n){if(!t.attributes.positions)if(e.hasProperty("POSITION"))t.attributes.positions=e.getPropertyArray("POSITION",Vi.FLOAT,3);else if(e.hasProperty("POSITION_QUANTIZED")){const r=e.getPropertyArray("POSITION_QUANTIZED",Vi.UNSIGNED_SHORT,3);if(t.isQuantized=!0,t.quantizedRange=65535,t.quantizedVolumeScale=e.getGlobalProperty("QUANTIZED_VOLUME_SCALE",Vi.FLOAT,3),!t.quantizedVolumeScale)throw new Error("QUANTIZED_VOLUME_SCALE must be defined for quantized positions.");if(t.quantizedVolumeOffset=e.getGlobalProperty("QUANTIZED_VOLUME_OFFSET",Vi.FLOAT,3),!t.quantizedVolumeOffset)throw new Error("QUANTIZED_VOLUME_OFFSET must be defined for quantized positions.");t.attributes.positions=mo(t,r,n)}if(!t.attributes.positions)throw new Error("Either POSITION or POSITION_QUANTIZED must be defined.")}(t,o,r),function(t,e,n){if(!t.attributes.colors){let r=null;e.hasProperty("RGBA")?(r=e.getPropertyArray("RGBA",Vi.UNSIGNED_BYTE,4),t.isTranslucent=!0):e.hasProperty("RGB")?r=e.getPropertyArray("RGB",Vi.UNSIGNED_BYTE,3):e.hasProperty("RGB565")&&(r=e.getPropertyArray("RGB565",Vi.UNSIGNED_SHORT,1),t.isRGB565=!0),t.attributes.colors=co(t,r,n)}e.hasProperty("CONSTANT_RGBA")&&(t.constantRGBA=e.getGlobalProperty("CONSTANT_RGBA",Vi.UNSIGNED_BYTE,4))}(t,o,a),function(t,e){if(!t.attributes.normals){let n=null;e.hasProperty("NORMAL")?n=e.getPropertyArray("NORMAL",Vi.FLOAT,3):e.hasProperty("NORMAL_OCT16P")&&(n=e.getPropertyArray("NORMAL_OCT16P",Vi.UNSIGNED_BYTE,2),t.isOctEncoded16P=!0),t.attributes.normals=function(t,e){if(!e)return null;if(t.isOctEncoded16P){const n=new Float32Array(3*t.pointsLength);for(let r=0;r<t.pointsLength;r++)Ao(e[2*r],e[2*r+1],go),go.toArray(n,3*r);return{type:Vi.FLOAT,size:2,value:n}}return{type:Vi.FLOAT,size:2,value:e}}(t,n)}}(t,o),n}var vo=n(319),_o=n(85);const bo=0,xo=1;function wo(t,e,n,r){t.rotateYtoZ=!0;const i=t.byteOffset+t.byteLength-n;if(0===i)throw new Error("glTF byte length must be greater than 0.");return t.gltfUpAxis=r["3d-tiles"]&&r["3d-tiles"].assetGltfUpAxis?r["3d-tiles"].assetGltfUpAxis:"Y",t.gltfArrayBuffer=Object(_o.c)(e,n,i),t.gltfByteOffset=0,t.gltfByteLength=i,n%4==0||console.warn("".concat(t.type,": embedded glb is not aligned to a 4-byte boundary.")),t.byteOffset+t.byteLength}async function Eo(t,e,n,r){const i=n["3d-tiles"]||{};if(function(t,e,n){switch(e){case bo:const e=new Uint8Array(t.gltfArrayBuffer,t.gltfByteOffset),n=(new TextDecoder).decode(e);t.gltfUrl=n.replace(/[\s\0]+$/,""),delete t.gltfArrayBuffer,delete t.gltfByteOffset,delete t.gltfByteLength;break;case xo:break;default:throw new Error("b3dm: Illegal glTF format field")}}(t,e),i.loadGLTF){const{parse:e,fetch:i}=r;t.gltfUrl&&(t.gltfArrayBuffer=await i(t.gltfUrl,n),t.gltfByteOffset=0),t.gltfArrayBuffer&&(t.gltf=await e(t.gltfArrayBuffer,vo.a,n,r),delete t.gltfArrayBuffer,delete t.gltfByteOffset,delete t.gltfByteLength)}}async function Oo(t,e,n,r,i){var o;n=function(t,e,n,r,i){n=oo(t,e,n),n=ao(t,e,n),n=so(t,e,n),n=wo(t,e,n,r);const o=new Xi(t.featureTableJson,t.featureTableBinary);return t.rtcCenter=o.getGlobalProperty("RTC_CENTER",Vi.FLOAT,3),n}(t,e,n,r),await Eo(t,xo,r,i);const a=null==t||null===(o=t.gltf)||void 0===o?void 0:o.extensions;return a&&a.CESIUM_RTC&&(t.rtcCenter=a.CESIUM_RTC.center),n}async function So(t,e,n,r,i){return n=function(t,e,n,r,i){if(n=oo(t,e,n),1!==t.version)throw new Error("Instanced 3D Model version ".concat(t.version," is not supported"));n=ao(t,e,n);const o=new DataView(e);if(t.gltfFormat=o.getUint32(n,!0),n=so(t,e,n+=4),n=wo(t,e,n,r),0===t.featureTableJsonByteLength)throw new Error("i3dm parser: featureTableJsonByteLength is zero.");const a=new Xi(t.featureTableJson,t.featureTableBinary),s=a.getGlobalProperty("INSTANCES_LENGTH");if(a.featuresLength=s,!Number.isFinite(s))throw new Error("i3dm parser: INSTANCES_LENGTH must be defined");t.eastNorthUp=a.getGlobalProperty("EAST_NORTH_UP"),t.rtcCenter=a.getGlobalProperty("RTC_CENTER",Vi.FLOAT,3);new io(t.batchTableJson,t.batchTableBinary,s);return function(t,e,n,r){const i=[new Array(r),t._batchTable][0],o=new rt.a,a=new rt.a,s=new rt.a,u=new rt.a,c=new vt,l=new xt.a,h=new rt.a,f={},p=new Jt.a,d=[],A=[],g=new rt.a,m=new rt.a;for(let n=0;n<r;n++){let r;if(e.hasProperty("POSITION"))r=e.getProperty("POSITION",Vi.FLOAT,3,n,o);else if(e.hasProperty("POSITION_QUANTIZED")){r=e.getProperty("POSITION_QUANTIZED",Vi.UNSIGNED_SHORT,3,n,o);const t=e.getGlobalProperty("QUANTIZED_VOLUME_OFFSET",Vi.FLOAT,3,g);if(!t)throw new Error("i3dm parser: QUANTIZED_VOLUME_OFFSET must be defined for quantized positions.");const i=e.getGlobalProperty("QUANTIZED_VOLUME_SCALE",Vi.FLOAT,3,m);if(!i)throw new Error("i3dm parser: QUANTIZED_VOLUME_SCALE must be defined for quantized positions.");const a=65535;for(let e=0;e<3;e++)r[e]=r[e]/a*i[e]+t[e]}if(!r)throw new Error("i3dm: POSITION or POSITION_QUANTIZED must be defined for each instance.");o.copy(r),f.translation=o,t.normalUp=e.getProperty("NORMAL_UP",Vi.FLOAT,3,n,d),t.normalRight=e.getProperty("NORMAL_RIGHT",Vi.FLOAT,3,n,A);const y=!1;if(t.normalUp){if(!t.normalRight)throw new Error("i3dm: Custom orientation requires both NORMAL_UP and NORMAL_RIGHT.");t.hasCustomOrientation=!0}else{if(t.octNormalUp=e.getProperty("NORMAL_UP_OCT32P",Vi.UNSIGNED_SHORT,2,d),t.octNormalRight=e.getProperty("NORMAL_RIGHT_OCT32P",Vi.UNSIGNED_SHORT,2,A),t.octNormalUp){if(!t.octNormalRight)throw new Error("i3dm: oct-encoded orientation requires NORMAL_UP_OCT32P and NORMAL_RIGHT_OCT32P");throw new Error("i3dm: oct-encoded orientation not implemented")}t.eastNorthUp?(Ir.WGS84.eastNorthUpToFixedFrame(o,p),p.getRotationMatrix3(c)):c.identity()}y&&(u.copy(a).cross(s).normalize(),c.setColumn(0,a),c.setColumn(1,s),c.setColumn(2,u)),l.fromMatrix3(c),f.rotation=l,h.set(1,1,1);const v=e.getProperty("SCALE",Vi.FLOAT,1,n);Number.isFinite(v)&&h.multiplyByScalar(v);const _=e.getProperty("SCALE_NON_UNIFORM",Vi.FLOAT,3,n,d);_&&h.scale(_),f.scale=h;let b=e.getProperty("BATCH_ID",Vi.UNSIGNED_SHORT,1,n);void 0===b&&(b=n);const x=(new Jt.a).fromQuaternion(f.rotation);p.identity(),p.translate(f.translation),p.multiplyRight(x),p.scale(f.scale);const w=p.clone();i[n]={modelMatrix:w,batchId:b}}t.instances=i}(t,a,0,s),n}(t,e,n,r),await Eo(t,t.gltfFormat,r,i),n}async function To(t,e=0,n,r,i={}){switch(i.byteOffset=e,i.type=function(t,e=0){const n=new DataView(t);return"".concat(String.fromCharCode(n.getUint8(e+0))).concat(String.fromCharCode(n.getUint8(e+1))).concat(String.fromCharCode(n.getUint8(e+2))).concat(String.fromCharCode(n.getUint8(e+3)))}(t,e),i.type){case zi.COMPOSITE:return await async function(t,e,n,r,i,o){n=oo(t,e,n);const a=new DataView(e);for(t.tilesLength=a.getUint32(n,!0),n+=4,t.tiles=[];t.tiles.length<t.tilesLength&&t.byteLength-n>12;){const a={};t.tiles.push(a),n=await o(e,n,r,i,a)}return n}(i,t,e,n,r,To);case zi.BATCHED_3D_MODEL:return await Oo(i,t,e,n,r);case zi.GLTF:return await async function(t,e,n,r){t.rotateYtoZ=!0,t.gltfUpAxis=n["3d-tiles"]&&n["3d-tiles"].assetGltfUpAxis?n["3d-tiles"].assetGltfUpAxis:"Y";const{parse:i}=r;t.gltf=await i(e,vo.a,n,r)}(i,t,n,r);case zi.INSTANCED_3D_MODEL:return await So(i,t,e,n,r);case zi.POINT_CLOUD:return await yo(i,t,e,n,r);default:throw new Error("3DTileLoader: unknown type ".concat(i.type))}}var Co=n(103);async function Po(t,e,n){const r=t[e].bufferView,i=t.bufferViews[r],o=t.buffers[i.buffer];if(o.uri){const t=await Object(Co.a)(o.uri),e=await t.arrayBuffer();return new Uint8Array(e,i.byteOffset,i.byteLength)}return new Uint8Array(n,i.byteOffset,i.byteLength)}function Mo(t){const e=new DataView(t);return e.getUint32(0,!0)+2**32*e.getUint32(4,!0)}const Io={id:"3d-tiles-subtree",name:"3D Tiles Subtree",module:"3d-tiles",version:"3.2.10",extensions:["subtree"],mimeTypes:["application/octet-stream"],tests:["subtree"],parse:async function(t){if(1952609651!==new Uint32Array(t.slice(0,4))[0])throw new Error("Wrong subtree file magic number");if(1!==new Uint32Array(t.slice(4,8))[0])throw new Error("Wrong subtree file verson, must be 1");const e=Mo(t.slice(8,16)),n=new Uint8Array(t,24,e),r=new TextDecoder("utf8").decode(n),i=JSON.parse(r),o=Mo(t.slice(16,24));let a=new ArrayBuffer(0);return o&&(a=t.slice(24+e)),"bufferView"in i.tileAvailability&&(i.tileAvailability.explicitBitstream=await Po(i,"tileAvailability",a)),"bufferView"in i.contentAvailability&&(i.contentAvailability.explicitBitstream=await Po(i,"contentAvailability",a)),"bufferView"in i.childSubtreeAvailability&&(i.childSubtreeAvailability.explicitBitstream=await Po(i,"childSubtreeAvailability",a)),i},options:{}},Bo={QUADTREE:4,OCTREE:8};function Ro(t,e){return"constant"in t?Boolean(t.constant):!!t.explicitBitstream&&function(t,e){const n=Math.floor(t/8),r=t%8;return 1==(e[n]>>r&1)}(e,t.explicitBitstream)}function ko(t,e,n,r){const{basePath:i,refine:o,getRefine:a,lodMetricType:s,getTileType:u,rootLodMetricValue:c,rootBoundingVolume:l}=r,h=t.contentUrl&&t.contentUrl.replace("".concat(i,"/"),""),f=c/2**e,p=function(t,e,n){if(e.region){const{childTileX:r,childTileY:i,childTileZ:o}=n,[a,s,u,c,l,h]=e.region,f=2**t,p=(u-a)/f,d=(c-s)/f,A=(h-l)/f,[g,m]=[a+p*r,a+p*(r+1)],[y,v]=[s+d*i,s+d*(i+1)],[_,b]=[l+A*o,l+A*(o+1)];return{region:[g,y,m,v,_,b]}}return console.warn("Unsupported bounding volume type: ",e),null}(e,l,n);return{children:t.children,contentUrl:t.contentUrl,content:{uri:h},id:t.contentUrl,refine:a(o),type:u(t),lodMetricType:s,lodMetricValue:f,boundingVolume:p}}function Do(t,e){return parseInt(t.toString(2)+e.toString(2),2)}function Lo(t,e,n,r,i){const o=function(t){const e={};for(const n in t)e["{".concat(n,"}")]=t[n];return e}({level:e,x:n,y:r,z:i});return t.replace(/{level}|{x}|{y}|{z}/gi,t=>o[t])}function jo(t){if(!t.contentUrl)return ei;const e=t.contentUrl.split(".").pop();switch(e){case"pnts":return ri;case"i3dm":case"b3dm":case"glb":case"gltf":return ni;default:return e}}function Fo(t){switch(t){case"REPLACE":case"replace":return ti;case"ADD":case"add":return $r;default:return t}}function zo(t,e){if(/^[a-z][0-9a-z+.-]*:/i.test(e)){const n=new URL(t,"".concat(e,"/"));return decodeURI(n.toString())}return t.startsWith("/")?t:"".concat(e,"/").concat(t)}function Uo(t,e){if(!t)return null;if(t.content){const n=t.content.uri||t.content.url;t.contentUrl=zo(n,e.basePath)}return t.id=t.contentUrl,t.lodMetricType=si,t.lodMetricValue=t.geometricError,t.transformMatrix=t.transform,t.type=jo(t),t.refine=Fo(t.refine),t}async function No(t){if(!t.root)return null;const e=t.basePath,n=t.root.extensions["3DTILES_implicit_tiling"],{subdivisionScheme:r,maximumLevel:i,subtreeLevels:o,subtrees:{uri:a}}=n,s=zo(Lo(a,0,0,0,0),e),u=await Object(ur.a)(s,Io),c=zo(t.root.content.uri,e),l=t.root.refine,h=t.root.geometricError,f=t.root.boundingVolume,p={contentUrlTemplate:c,subtreesUriTemplate:a,subdivisionScheme:r,subtreeLevels:o,maximumLevel:i,refine:l,basePath:e,lodMetricType:si,rootLodMetricValue:h,rootBoundingVolume:f,getTileType:jo,getRefine:Fo};return await async function(t,e,n){if(!t)return null;t.lodMetricType=si,t.lodMetricValue=t.geometricError,t.transformMatrix=t.transform;const{children:r,contentUrl:i}=await async function t(e){const{options:n,parentData:r={mortonIndex:0,x:0,y:0,z:0},childIndex:i=0,globalData:o={level:0,mortonIndex:0,x:0,y:0,z:0}}=e;let{subtree:a,level:s=0}=e;const{subdivisionScheme:u,subtreeLevels:c,maximumLevel:l,contentUrlTemplate:h,subtreesUriTemplate:f,basePath:p}=n,d={children:[],lodMetricValue:0,contentUrl:""},A=Bo[u],g=1&i,m=i>>1&1,y=i>>2&1,v=(A**s-1)/(A-1);let _=Do(r.mortonIndex,i),b=v+_,x=Do(r.x,g),w=Do(r.y,m),E=Do(r.z,y),O=!1;s+1>c&&(O=Ro(a.childSubtreeAvailability,_));const S=Do(o.x,x),T=Do(o.y,w),C=Do(o.z,E),P=s+o.level;if(O){const t=Lo("".concat(p,"/").concat(f),P,S,T,C);a=await Object(ur.a)(t,Io),o.mortonIndex=_,o.x=x,o.y=w,o.z=E,o.level=s,_=0,b=0,x=0,w=0,E=0,s=0}if(!Ro(a.tileAvailability,b)||s>l)return d;Ro(a.contentAvailability,b)&&(d.contentUrl=Lo(h,P,S,T,C));const M=s+1,I={mortonIndex:_,x:x,y:w,z:E};for(let e=0;e<A;e++){const r=await t({subtree:a,options:n,parentData:I,childIndex:e,level:M,globalData:o});if(r.contentUrl||r.children.length){const t=ko(r,P+1,{childTileX:x,childTileY:w,childTileZ:E},n);d.children.push(t)}}return d}({subtree:e,options:n});i&&(t.contentUrl=i,t.content={uri:i.replace("".concat(n.basePath,"/"),"")});return t.refine=Fo(t.refine),t.type=jo(t),t.children=r,t.id=t.contentUrl,t}(t.root,u,p)}const Go={id:"3d-tiles",name:"3D Tiles",module:"3d-tiles",version:"3.2.10",extensions:["cmpt","pnts","b3dm","i3dm"],mimeTypes:["application/octet-stream"],tests:["cmpt","pnts","b3dm","i3dm"],parse:async function(t,e,n){const r=e["3d-tiles"]||{};let i;i="auto"===r.isTileset?n.url&&-1!==n.url.indexOf(".json"):r.isTileset;t=i?await async function(t,e,n){var r;const i=JSON.parse((new TextDecoder).decode(t));return i.loader=e.loader||Go,i.url=n.url,i.basePath=function(t){return kr.b.dirname(t.url)}(i),i.root=function(t){var e,n;return(null==t||null===(e=t.extensionsRequired)||void 0===e?void 0:e.includes("3DTILES_implicit_tiling"))&&(null==t||null===(n=t.extensionsUsed)||void 0===n?void 0:n.includes("3DTILES_implicit_tiling"))}(i)?await No(i):function(t){const e=t.basePath,n=Uo(t.root,t),r=[];for(r.push(n);r.length>0;){const t=(r.pop()||{}).children||[];for(const n of t)Uo(n,{basePath:e}),r.push(n)}return n}(i),i.type=ai,i.lodMetricType=si,i.lodMetricValue=(null===(r=i.root)||void 0===r?void 0:r.lodMetricValue)||0,i}(t,e,n):await async function(t,e,n){const r={content:{featureIds:null}};return await To(t,0,e,n,r.content),r.content}(t,e,n);return t},options:{"3d-tiles":{loadGLTF:!0,decodeQuantizedPositions:!1,isTileset:"auto",assetGltfUpAxis:null}}};function Vo(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function Ho(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Vo(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Vo(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function Wo(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}var qo=[0],Xo={getPointColor:{type:"accessor",value:[0,0,0,255]},pointSize:1,data:null,loader:Go,onTilesetLoad:{type:"function",value:function(t){},compare:!1},onTileLoad:{type:"function",value:function(t){},compare:!1},onTileUnload:{type:"function",value:function(t){},compare:!1},onTileError:{type:"function",value:function(t,e,n){},compare:!1},_getMeshColor:{type:"function",value:function(t){return[255,255,255]},compare:!1}},Zo=function(t){a()(r,t);var e,n=Wo(r);function r(){return i()(this,r),n.apply(this,arguments)}return g()(r,[{key:"initializeState",value:function(){"onTileLoadFail"in this.props&&X.a.removed("onTileLoadFail","onTileError")(),this.state={layerMap:{},tileset3d:null,activeViewports:{},lastUpdatedViewports:null}}},{key:"isLoaded",get:function(){var t=this.state.tileset3d;return null!==t&&t.isLoaded()}},{key:"shouldUpdateState",value:function(t){return t.changeFlags.somethingChanged}},{key:"updateState",value:function(t){var e=t.props,n=t.oldProps,r=t.changeFlags;if(e.data&&e.data!==n.data&&this._loadTileset(e.data),r.viewportChanged){var i=this.state.activeViewports;Object.keys(i).length&&(this._updateTileset(i),this.state.lastUpdatedViewports=i,this.state.activeViewports={})}if(r.propsChanged){var o=this.state.layerMap;for(var a in o)o[a].needsUpdate=!0}}},{key:"activateViewport",value:function(t){var e=this.state,n=e.activeViewports,r=e.lastUpdatedViewports;this.internalState.viewport=t,n[t.id]=t;var i=null==r?void 0:r[t.id];i&&t.equals(i)||(this.setChangeFlags({viewportChanged:!0}),this.setNeedsUpdate())}},{key:"getPickingInfo",value:function(t){var e=t.info,n=t.sourceLayer,r=this.state.layerMap,i=n&&n.id;if(i){var o=i.substring(this.id.length+1),a=o.substring(o.indexOf("-")+1);e.object=r[a]&&r[a].tile}return e}},{key:"filterSubLayer",value:function(t){var e=t.layer,n=t.viewport,r=e.props.tile,i=n.id;return r.selected&&r.viewportIds.includes(i)}},{key:"_updateAutoHighlight",value:function(t){t.sourceLayer&&t.sourceLayer.updateAutoHighlight(t)}},{key:"_loadTileset",value:(e=H()(q.a.mark((function t(e){var n,r,i,o,a,s,u;return q.a.wrap((function(t){for(;;)switch(t.prev=t.next){case 0:if(n=this.props.loadOptions,r=void 0===n?{}:n,i=this.props.loader||this.props.loaders,Array.isArray(i)&&(i=i[0]),o={loadOptions:Ho({},r)},!i.preload){t.next=10;break}return t.next=7,i.preload(e,r);case 7:(a=t.sent).headers&&(o.loadOptions.fetch=Ho(Ho({},o.loadOptions.fetch),{},{headers:a.headers})),Object.assign(o,a);case 10:return t.next=12,Object(ur.a)(e,i,o.loadOptions);case 12:s=t.sent,u=new Fi(s,Ho({onTileLoad:this._onTileLoad.bind(this),onTileUnload:this._onTileUnload.bind(this),onTileError:this.props.onTileError},o)),this.setState({tileset3d:u,layerMap:{}}),this._updateTileset(this.state.activeViewports),this.props.onTilesetLoad(u);case 17:case"end":return t.stop()}}),t,this)}))),function(t){return e.apply(this,arguments)})},{key:"_onTileLoad",value:function(t){var e=this.state.lastUpdatedViewports;this.props.onTileLoad(t),this._updateTileset(e),this.setNeedsUpdate()}},{key:"_onTileUnload",value:function(t){delete this.state.layerMap[t.id],this.props.onTileUnload(t)}},{key:"_updateTileset",value:function(t){var e=this;if(t){var n=this.state.tileset3d,r=this.context.timeline,i=Object.keys(t).length;r&&i&&n&&n.selectTiles(Object.values(t)).then((function(t){e.state.frameNumber!==t&&e.setState({frameNumber:t})}))}}},{key:"_getSubLayer",value:function(t,e){if(!t.content)return null;switch(t.type){case ri:return this._makePointCloudLayer(t,e);case ni:return this._make3DModelLayer(t);case ii:return this._makeSimpleMeshLayer(t,e);default:throw new Error("Tile3DLayer: Failed to render layer of type ".concat(t.content.type))}}},{key:"_makePointCloudLayer",value:function(t,e){var n=t.content,r=n.attributes,i=n.pointCount,o=n.constantRGBA,a=n.cartographicOrigin,s=n.modelMatrix,u=r.positions,c=r.normals,l=r.colors;if(!u)return null;var h=e&&e.props.data||{header:{vertexCount:i},attributes:{POSITION:u,NORMAL:c,COLOR_0:l}},f=this.props,p=f.pointSize,d=f.getPointColor;return new(this.getSubLayerClass("pointcloud",Yn.a))({pointSize:p},this.getSubLayerProps({id:"pointcloud"}),{id:"".concat(this.id,"-pointcloud-").concat(t.id),tile:t,data:h,coordinateSystem:Kn.a.METER_OFFSETS,coordinateOrigin:a,modelMatrix:s,getColor:o||d,_offset:0})}},{key:"_make3DModelLayer",value:function(t){var e=t.content,n=e.gltf,r=e.instances,i=e.cartographicOrigin,o=e.modelMatrix;return new(this.getSubLayerClass("scenegraph",$n.a))({_lighting:"pbr"},this.getSubLayerProps({id:"scenegraph"}),{id:"".concat(this.id,"-scenegraph-").concat(t.id),tile:t,data:r||qo,scenegraph:n,coordinateSystem:Kn.a.METER_OFFSETS,coordinateOrigin:i,modelMatrix:o,getTransformMatrix:function(t){return t.modelMatrix},getPosition:[0,0,0],_offset:0})}},{key:"_makeSimpleMeshLayer",value:function(t,e){var n=t.content,r=n.attributes,i=n.indices,o=n.modelMatrix,a=n.cartographicOrigin,s=n.coordinateSystem,u=void 0===s?Kn.a.METER_OFFSETS:s,c=n.material,l=n.featureIds,h=this.props._getMeshColor,f=e&&e.props.mesh||new Qn.a({drawMode:4,attributes:Jo(r),indices:i});return new(this.getSubLayerClass("mesh",sr))(this.getSubLayerProps({id:"mesh"}),{id:"".concat(this.id,"-mesh-").concat(t.id),tile:t,mesh:f,data:qo,getColor:h(t),pbrMaterial:c,modelMatrix:o,coordinateOrigin:a,coordinateSystem:u,featureIds:l,_offset:0})}},{key:"renderLayers",value:function(){var t=this,e=this.state,n=e.tileset3d,r=e.layerMap;return n?n.tiles.map((function(e){var n=r[e.id]=r[e.id]||{tile:e},i=n.layer;return e.selected&&(i?n.needsUpdate&&(i=t._getSubLayer(e,i),n.needsUpdate=!1):i=t._getSubLayer(e)),n.layer=i,i})).filter(Boolean):null}}]),r}(m.a);function Jo(t){var e={};return e.positions=Ho(Ho({},t.positions),{},{value:new Float32Array(t.positions.value)}),t.normals&&(e.normals=t.normals),t.texCoords&&(e.texCoords=t.texCoords),t.colors&&(e.colors=t.colors),t.uvRegions&&(e.uvRegions=t.uvRegions),e}f()(Zo,"defaultProps",Xo),f()(Zo,"layerName","Tile3DLayer");const Qo={name:"Terrain",id:"terrain",module:"terrain",version:"3.2.10",worker:!0,extensions:["png","pngraw","jpg","jpeg","gif","webp","bmp"],mimeTypes:["image/png","image/jpeg","image/gif","image/webp","image/bmp"],options:{terrain:{tesselator:"auto",bounds:null,meshMaxError:10,elevationDecoder:{rScaler:1,gScaler:0,bScaler:0,offset:0},skirtHeight:null}}};function Ko(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}function Yo(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function $o(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Yo(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Yo(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var ta=[1],ea=$o($o({},Ze.defaultProps),{},{elevationData:Oe,texture:$o($o({},Oe),{},{optional:!0}),meshMaxError:{type:"number",value:4},bounds:{type:"array",value:null,optional:!0,compare:!0},color:{type:"color",value:[255,255,255]},elevationDecoder:{type:"object",value:{rScaler:1,gScaler:0,bScaler:0,offset:0}},workerUrl:{type:"string",value:null},wireframe:!1,material:!0,loaders:[Qo]});function na(t){return Array.isArray(t)?t.join(";"):t||""}var ra=function(t){a()(n,t);var e=Ko(n);function n(){return i()(this,n),e.apply(this,arguments)}return g()(n,[{key:"updateState",value:function(t){var e=t.props,n=t.oldProps,r=e.elevationData!==n.elevationData;if(r){var i=e.elevationData,o=i&&(Array.isArray(i)||i.includes("{x}")&&i.includes("{y}"));this.setState({isTiled:o})}var a=r||e.meshMaxError!==n.meshMaxError||e.elevationDecoder!==n.elevationDecoder||e.bounds!==n.bounds;if(!this.state.isTiled&&a){var s=this.loadTerrain(e);this.setState({terrain:s})}e.workerUrl&&X.a.removed("workerUrl","loadOptions.terrain.workerUrl")()}},{key:"loadTerrain",value:function(t){var e,n=t.elevationData,r=t.bounds,i=t.elevationDecoder,o=t.meshMaxError,a=t.signal;if(!n)return null;var s=this.getLoadOptions();return s=$o($o({},s),{},{terrain:$o($o({skirtHeight:this.state.isTiled?2*o:0},null===(e=s)||void 0===e?void 0:e.terrain),{},{bounds:r,meshMaxError:o,elevationDecoder:i})}),(0,this.props.fetch)(n,{propName:"elevationData",layer:this,loadOptions:s,signal:a})}},{key:"getTiledTerrainData",value:function(t){var e=this.props,n=e.elevationData,r=e.fetch,i=e.texture,o=e.elevationDecoder,a=e.meshMaxError,s=this.context.viewport,u=Te(n,t),c=i&&Te(i,t),l=t.signal,h=[0,0],f=[0,0];if(s.isGeospatial){var p=t.bbox;h=s.projectFlat([p.west,p.south]),f=s.projectFlat([p.east,p.north])}else{var d=t.bbox;h=[d.left,d.bottom],f=[d.right,d.top]}var A=[h[0],h[1],f[0],f[1]],g=this.loadTerrain({elevationData:u,bounds:A,elevationDecoder:o,meshMaxError:a,signal:l}),m=c?r(c,{propName:"texture",layer:this,loaders:[],signal:l}).catch((function(t){return null})):Promise.resolve(null);return Promise.all([g,m])}},{key:"renderSubLayers",value:function(t){var e=this.getSubLayerClass("mesh",rr.a),n=this.props,r=n.color,i=n.wireframe,o=n.material,a=t.data;if(!a)return null;var s=E()(a,2),u=s[0],c=s[1];return new e(t,{data:ta,mesh:u,texture:c,_instanced:!1,coordinateSystem:Kn.a.CARTESIAN,getPosition:function(t){return[0,0,0]},getColor:r,wireframe:i,material:o})}},{key:"onViewportLoad",value:function(t){if(t){var e=this.state.zRange,n=t.map((function(t){return t.content})).filter(Boolean).map((function(t){return t[0].header.boundingBox.map((function(t){return t[2]}))}));if(0!==n.length){var r=Math.min.apply(Math,Q()(n.map((function(t){return t[0]})))),i=Math.max.apply(Math,Q()(n.map((function(t){return t[1]}))));(!e||r<e[0]||i>e[1])&&this.setState({zRange:[r,i]})}}}},{key:"renderLayers",value:function(){var t=this.props,e=t.color,n=t.material,r=t.elevationData,i=t.texture,o=t.wireframe,a=t.meshMaxError,s=t.elevationDecoder,u=t.tileSize,c=t.maxZoom,l=t.minZoom,h=t.extent,f=t.maxRequests,p=t.onTileLoad,d=t.onTileUnload,A=t.onTileError,g=t.maxCacheSize,m=t.maxCacheByteSize,y=t.refinementStrategy;return this.state.isTiled?new Ze(this.getSubLayerProps({id:"tiles"}),{getTileData:this.getTiledTerrainData.bind(this),renderSubLayers:this.renderSubLayers.bind(this),updateTriggers:{getTileData:{elevationData:na(r),texture:na(i),meshMaxError:a,elevationDecoder:s}},onViewportLoad:this.onViewportLoad.bind(this),zRange:this.state.zRange||null,tileSize:u,maxZoom:c,minZoom:l,extent:h,maxRequests:f,onTileLoad:p,onTileUnload:d,onTileError:A,maxCacheSize:g,maxCacheByteSize:m,refinementStrategy:y}):new(this.getSubLayerClass("mesh",rr.a))(this.getSubLayerProps({id:"mesh"}),{data:ta,mesh:this.state.terrain,texture:i,_instanced:!1,getPosition:function(t){return[0,0,0]},getColor:e,material:n,wireframe:o})}}]),n}(m.a);f()(ra,"defaultProps",ea),f()(ra,"layerName","TerrainLayer");var ia=n(37);function oa(t,e,n){const r=aa(t),i=Object.keys(r).filter(t=>r[t]!==Array);return function(t,e,n){const{pointPositionsCount:r,pointFeaturesCount:i,linePositionsCount:o,linePathsCount:a,lineFeaturesCount:s,polygonPositionsCount:u,polygonObjectsCount:c,polygonRingsCount:l,polygonFeaturesCount:h,propArrayTypes:f,coordLength:p}=e,{numericPropKeys:d=[],PositionDataType:A=Float32Array}=n,g=t[0]&&"id"in t[0],m=t.length>65535?Uint32Array:Uint16Array,y={type:"Point",positions:new A(r*p),globalFeatureIds:new m(r),featureIds:i>65535?new Uint32Array(r):new Uint16Array(r),numericProps:{},properties:[],fields:[]},v={type:"LineString",pathIndices:o>65535?new Uint32Array(a+1):new Uint16Array(a+1),positions:new A(o*p),globalFeatureIds:new m(o),featureIds:s>65535?new Uint32Array(o):new Uint16Array(o),numericProps:{},properties:[],fields:[]},_={type:"Polygon",polygonIndices:u>65535?new Uint32Array(c+1):new Uint16Array(c+1),primitivePolygonIndices:u>65535?new Uint32Array(l+1):new Uint16Array(l+1),positions:new A(u*p),triangles:[],globalFeatureIds:new m(u),featureIds:h>65535?new Uint32Array(u):new Uint16Array(u),numericProps:{},properties:[],fields:[]};for(const t of[y,v,_])for(const e of d){const n=f[e];t.numericProps[e]=new n(t.positions.length/p)}v.pathIndices[a]=o,_.polygonIndices[c]=u,_.primitivePolygonIndices[l]=u;const b={pointPosition:0,pointFeature:0,linePosition:0,linePath:0,lineFeature:0,polygonPosition:0,polygonObject:0,polygonRing:0,polygonFeature:0,feature:0};for(const e of t){const t=e.geometry,n=e.properties||{};switch(t.type){case"Point":sa(t,y,b,p,n),y.properties.push(pa(n,d)),g&&y.fields.push({id:e.id}),b.pointFeature++;break;case"LineString":ua(t,v,b,p,n),v.properties.push(pa(n,d)),g&&v.fields.push({id:e.id}),b.lineFeature++;break;case"Polygon":ca(t,_,b,p,n),_.properties.push(pa(n,d)),g&&_.fields.push({id:e.id}),b.polygonFeature++;break;default:throw new Error("Invalid geometry type")}b.feature++}return function(t,e,n,r){return{points:{...t,positions:{value:t.positions,size:r},globalFeatureIds:{value:t.globalFeatureIds,size:1},featureIds:{value:t.featureIds,size:1},numericProps:ha(t.numericProps,1)},lines:{...e,positions:{value:e.positions,size:r},pathIndices:{value:e.pathIndices,size:1},globalFeatureIds:{value:e.globalFeatureIds,size:1},featureIds:{value:e.featureIds,size:1},numericProps:ha(e.numericProps,1)},polygons:{...n,positions:{value:n.positions,size:r},polygonIndices:{value:n.polygonIndices,size:1},primitivePolygonIndices:{value:n.primitivePolygonIndices,size:1},triangles:{value:new Uint32Array(n.triangles),size:1},globalFeatureIds:{value:n.globalFeatureIds,size:1},featureIds:{value:n.featureIds,size:1},numericProps:ha(n.numericProps,1)}}}(y,v,_,p)}(t,{propArrayTypes:r,...e},{numericPropKeys:n&&n.numericPropKeys||i,PositionDataType:n?n.PositionDataType:Float32Array})}function aa(t){const e={};for(const n of t)if(n.properties)for(const t in n.properties){const r=n.properties[t];e[t]=da(r,e[t])}return e}function sa(t,e,n,r,i){e.positions.set(t.data,n.pointPosition*r);const o=t.data.length/r;fa(e,i,n.pointPosition,o),e.globalFeatureIds.fill(n.feature,n.pointPosition,n.pointPosition+o),e.featureIds.fill(n.pointFeature,n.pointPosition,n.pointPosition+o),n.pointPosition+=o}function ua(t,e,n,r,i){e.positions.set(t.data,n.linePosition*r);const o=t.data.length/r;fa(e,i,n.linePosition,o),e.globalFeatureIds.fill(n.feature,n.linePosition,n.linePosition+o),e.featureIds.fill(n.lineFeature,n.linePosition,n.linePosition+o);for(let i=0,o=t.indices.length;i<o;++i){const a=t.indices[i],s=i===o-1?t.data.length:t.indices[i+1];e.pathIndices[n.linePath++]=n.linePosition,n.linePosition+=(s-a)/r}}function ca(t,e,n,r,i){e.positions.set(t.data,n.polygonPosition*r);const o=t.data.length/r;fa(e,i,n.polygonPosition,o),e.globalFeatureIds.fill(n.feature,n.polygonPosition,n.polygonPosition+o),e.featureIds.fill(n.polygonFeature,n.polygonPosition,n.polygonPosition+o);for(let i=0,o=t.indices.length;i<o;++i){const o=n.polygonPosition;e.polygonIndices[n.polygonObject++]=o;const a=t.areas[i],s=t.indices[i],u=t.indices[i+1];for(let i=0,o=s.length;i<o;++i){const a=s[i],c=i===o-1?void 0===u?t.data.length:u[0]:s[i+1];e.primitivePolygonIndices[n.polygonRing++]=n.polygonPosition,n.polygonPosition+=(c-a)/r}la(e,a,s,{startPosition:o,endPosition:n.polygonPosition,coordLength:r})}}function la(t,e,n,{startPosition:r,endPosition:i,coordLength:o}){const a=r*o,s=i*o,u=t.positions.subarray(a,s),c=n[0],l=n.slice(1).map(t=>(t-c)/o),h=Object(ia.f)(u,l,o,e);for(let e=0,n=h.length;e<n;++e)t.triangles.push(r+h[e])}function ha(t,e){const n={};for(const r in t)n[r]={value:t[r],size:e};return n}function fa(t,e,n,r){for(const i in t.numericProps)if(i in e){const o=e[i];t.numericProps[i].fill(o,n,n+r)}}function pa(t,e){const n={};for(const r in t)e.includes(r)||(n[r]=t[r]);return n}function da(t,e){return e!==Array&&Number.isFinite(t)?e===Float64Array||Math.fround(t)!==t?Float64Array:Float32Array:Array}var Aa=n(202),ga=n.n(Aa);function ma(t){let e=0;for(let e,n,r=0,i=t.length-1;r<t.length;r++)t[r],t[i],(n[0]-e[0])*(e[1]+n[1]);return e}function ya(t,e,n){e&&n&&(1===t?e.id=n.readVarint():2===t?function(t,e){const n=t.readVarint()+t.pos;for(;t.pos<n;){const n=e._keys[t.readVarint()],r=e._values[t.readVarint()];e.properties[n]=r}}(n,e):3===t?e.type=n.readVarint():4===t&&(e._geometry=n.pos))}class va{static get types(){return["Unknown","Point","LineString","Polygon"]}constructor(t,e,n,r,i){Object(cr.a)(this,"properties",void 0),Object(cr.a)(this,"extent",void 0),Object(cr.a)(this,"type",void 0),Object(cr.a)(this,"id",void 0),Object(cr.a)(this,"_pbf",void 0),Object(cr.a)(this,"_geometry",void 0),Object(cr.a)(this,"_keys",void 0),Object(cr.a)(this,"_values",void 0),this.properties={},this.extent=n,this.type=0,this.id=null,this._pbf=t,this._geometry=-1,this._keys=r,this._values=i,t.readFields(ya,this,e)}loadGeometry(){const t=this._pbf;t.pos=this._geometry;const e=t.readVarint()+t.pos;let n=1,r=0,i=0,o=0;const a=[];let s;for(;t.pos<e;){if(r<=0){const e=t.readVarint();7&e,e>>3}if(1===n||2===n)t.readSVarint(),t.readSVarint(),1===n&&(s&&a.push(s),[]),s&&s.push([i,o]);else{if(7!==n)throw new Error("unknown command ".concat(n));s&&s.push(s[0].slice())}}return s&&a.push(s),a}bbox(){const t=this._pbf;t.pos=this._geometry;const e=t.readVarint()+t.pos;let n=1,r=0,i=0,o=0,a=1/0,s=-1/0,u=1/0,c=-1/0;for(;t.pos<e;){if(r<=0){const e=t.readVarint();7&e,e>>3}if(1===n||2===n)t.readSVarint(),t.readSVarint(),i<a&&i,i>s&&i,o<u&&o,o>c&&o;else if(7!==n)throw new Error("unknown command ".concat(n))}return[a,u,s,c]}_toGeoJSON(t){let e,n,r=this.loadGeometry(),i=va.types[this.type];switch(this.type){case 1:const i=[];for(0;e<r.length;e++)i[e]=r[e][0];i,t(r,this);break;case 2:for(0;e<r.length;e++)t(r[e],this);break;case 3:for(function(t){const e=t.length;if(e<=1)return[t];const n=[];let r,i;for(let o=0;o<e;o++){const e=ma(t[o]);0!==e&&(void 0===i&&e<0,i===e<0?(r&&n.push(r),[t[o]]):r&&r.push(t[o]))}return r&&n.push(r),n}(r),0;e<r.length;e++)for(0;n<r[e].length;n++)t(r[e][n],this)}1===r.length?r[0]:"Multi".concat(i);const o={type:"Feature",geometry:{type:i,coordinates:r},properties:this.properties};return null!==this.id&&(o.id=this.id),o}toGeoJSON(t){if("function"==typeof t)return this._toGeoJSON(t);const{x:e,y:n,z:r}=t,i=this.extent*Math.pow(2,r),o=this.extent*e,a=this.extent*n;return this._toGeoJSON((function(t){for(let e=0;e<t.length;e++){const n=t[e];n[0]=360*(n[0]+o)/i-180;const r=180-360*(n[1]+a)/i;n[1]=360/Math.PI*Math.atan(Math.exp(r*Math.PI/180))-90}}))}}class _a{constructor(t,e){Object(cr.a)(this,"version",void 0),Object(cr.a)(this,"name",void 0),Object(cr.a)(this,"extent",void 0),Object(cr.a)(this,"length",void 0),Object(cr.a)(this,"_pbf",void 0),Object(cr.a)(this,"_keys",void 0),Object(cr.a)(this,"_values",void 0),Object(cr.a)(this,"_features",void 0),this.version=1,this.name="",this.extent=4096,this.length=0,this._pbf=t,this._keys=[],this._values=[],this._features=[],t.readFields(ba,this,e),this.length=this._features.length}feature(t){if(t<0||t>=this._features.length)throw new Error("feature index out of bounds");this._pbf.pos=this._features[t];const e=this._pbf.readVarint()+this._pbf.pos;return new va(this._pbf,e,this.extent,this._keys,this._values)}}function ba(t,e,n){e&&n&&(15===t?e.version=n.readVarint():1===t?e.name=n.readString():5===t?e.extent=n.readVarint():2===t?e._features.push(n.pos):3===t?e._keys.push(n.readString()):4===t&&e._values.push(function(t){let e=null;const n=t.readVarint()+t.pos;for(;t.pos<n;){const e=t.readVarint()>>3;1===e?t.readString():2===e?t.readFloat():3===e?t.readDouble():4===e?t.readVarint64():5===e?t.readVarint():6===e?t.readSVarint():7===e?t.readBoolean():null}return e}(n)))}class xa{constructor(t,e){Object(cr.a)(this,"layers",void 0),this.layers=t.readFields(wa,{},e)}}function wa(t,e,n){if(3===t&&n){const t=new _a(n,n.readVarint()+n.pos);t.length&&e&&(e[t.name]=t)}}function Ea(t){const e=t.indices.length;if(e<=1)return{type:"Polygon",data:t.data,areas:[[Object(ia.g)(t.data)]],indices:[t.indices]};const n=[],r=[];let i,o=[],a=[],s=0;for(let u,c,l=0;l<e;l++){t.indices[l]-s,t.indices[l+1]-s||t.data.length;const e=t.data.slice(c,u),h=Object(ia.g)(e);if(0!==h)void 0===i&&h<0,i===h<0?(a.length&&(n.push(o),r.push(a)),[c],[h]):(o.push(h),a.push(c));else{const e=t.data.slice(0,c),n=t.data.slice(u);t.data=e.concat(n),u-c}}return o&&n.push(o),a.length&&r.push(a),{type:"Polygon",areas:n,indices:r,data:t.data}}function Oa(t,e,n){e&&n&&(1===t?e.id=n.readVarint():2===t?function(t,e){const n=t.readVarint()+t.pos;for(;t.pos<n;){const n=e._keys[t.readVarint()],r=e._values[t.readVarint()];e.properties[n]=r}}(n,e):3===t?e.type=n.readVarint():4===t&&(e._geometry=n.pos))}let Sa,Ta,Ca,Pa,Ma,Ia,Ba;class Ra{constructor(t,e,n,r,i,o){Object(cr.a)(this,"properties",void 0),Object(cr.a)(this,"extent",void 0),Object(cr.a)(this,"type",void 0),Object(cr.a)(this,"id",void 0),Object(cr.a)(this,"_pbf",void 0),Object(cr.a)(this,"_geometry",void 0),Object(cr.a)(this,"_keys",void 0),Object(cr.a)(this,"_values",void 0),Object(cr.a)(this,"_geometryInfo",void 0),this.properties={},this.extent=n,this.type=0,this.id=null,this._pbf=t,this._geometry=-1,this._keys=r,this._values=i,this._geometryInfo=o,t.readFields(Oa,this,e)}loadGeometry(){const t=this._pbf;t.pos=this._geometry,t.readVarint()+t.pos,1,0,0,0,0;const e=[],n=[];for(;t.pos<Sa;)if(Pa<=0&&(t.readVarint(),7&Ca,Ca>>3),1===Ta||2===Ta)t.readSVarint(),t.readSVarint(),1===Ta&&e.push(Ba),n.push(Ma,Ia),2;else{if(7!==Ta)throw new Error("unknown command ".concat(Ta));if(Ba>0){const t=e[e.length-1];n.push(n[t],n[t+1]),2}}return{data:n,indices:e}}_toBinaryCoordinates(t){const e=this.loadGeometry();let n;t(e.data,this);switch(this.type){case 1:this._geometryInfo.pointFeaturesCount++,this._geometryInfo.pointPositionsCount+=e.indices.length,{type:"Point",...e};break;case 2:this._geometryInfo.lineFeaturesCount++,this._geometryInfo.linePathsCount+=e.indices.length,this._geometryInfo.linePositionsCount+=e.data.length/2,{type:"LineString",...e};break;case 3:Ea(e),this._geometryInfo.polygonFeaturesCount++,this._geometryInfo.polygonObjectsCount+=n.indices.length;for(const t of n.indices)this._geometryInfo.polygonRingsCount+=t.length;this._geometryInfo.polygonPositionsCount+=n.data.length/2;break;default:throw new Error("Invalid geometry type: ".concat(this.type))}const r={type:"Feature",geometry:n,properties:this.properties};return null!==this.id&&(r.id=this.id),r}toBinaryCoordinates(t){if("function"==typeof t)return this._toBinaryCoordinates(t);const{x:e,y:n,z:r}=t,i=this.extent*Math.pow(2,r),o=this.extent*e,a=this.extent*n;return this._toBinaryCoordinates(t=>function(t,e,n,r){for(let i=0,o=t.length;i<o;i+=2){t[i]=360*(t[i]+e)/r-180;const o=180-360*(t[i+1]+n)/r;t[i+1]=360/Math.PI*Math.atan(Math.exp(o*Math.PI/180))-90}}(t,o,a,i))}}class ka{constructor(t,e){Object(cr.a)(this,"version",void 0),Object(cr.a)(this,"name",void 0),Object(cr.a)(this,"extent",void 0),Object(cr.a)(this,"length",void 0),Object(cr.a)(this,"_pbf",void 0),Object(cr.a)(this,"_keys",void 0),Object(cr.a)(this,"_values",void 0),Object(cr.a)(this,"_features",void 0),this.version=1,this.name="",this.extent=4096,this.length=0,this._pbf=t,this._keys=[],this._values=[],this._features=[],t.readFields(Da,this,e),this.length=this._features.length}feature(t,e){if(t<0||t>=this._features.length)throw new Error("feature index out of bounds");this._pbf.pos=this._features[t];const n=this._pbf.readVarint()+this._pbf.pos;return new Ra(this._pbf,n,this.extent,this._keys,this._values,e)}}function Da(t,e,n){e&&n&&(15===t?e.version=n.readVarint():1===t?e.name=n.readString():5===t?e.extent=n.readVarint():2===t?e._features.push(n.pos):3===t?e._keys.push(n.readString()):4===t&&e._values.push(function(t){let e=null;const n=t.readVarint()+t.pos;for(;t.pos<n;){const e=t.readVarint()>>3;1===e?t.readString():2===e?t.readFloat():3===e?t.readDouble():4===e?t.readVarint64():5===e?t.readVarint():6===e?t.readSVarint():7===e?t.readBoolean():null}return e}(n)))}class La{constructor(t,e){Object(cr.a)(this,"layers",void 0),this.layers=t.readFields(ja,{},e)}}function ja(t,e,n){if(3===t&&n){const t=new ka(n,n.readVarint()+n.pos);t.length&&e&&(e[t.name]=t)}}function Fa(t,e){var n,r;const i=function(t){var e;if(null==t||!t.mvt)throw new Error("mvt options required");const n="wgs84"===(null===t.mvt||void 0===e?void 0:e.coordinates),{tileIndex:r}=t.mvt,i=r&&Number.isFinite(r.x)&&Number.isFinite(r.y)&&Number.isFinite(r.z);if(n&&!i)throw new Error("MVT Loader: WGS84 coordinates need tileIndex property");return t.mvt}(e),o=(null==e||null===e.gis||void 0===n?void 0:n.format)||(null==e||null===e.mvt||void 0===r?void 0:r.shape);switch(o){case"columnar-table":return{shape:"columnar-table",data:za(t,i)};case"geojson-row-table":return{shape:"geojson-row-table",data:Ua(t,i)};case"geojson":return Ua(t,i);case"binary-geometry":case"binary":return za(t,i);default:throw new Error(o)}}function za(t,e){const[n,r]=function(t,e){const n=[],r={coordLength:2,pointPositionsCount:0,pointFeaturesCount:0,linePositionsCount:0,linePathsCount:0,lineFeaturesCount:0,polygonPositionsCount:0,polygonObjectsCount:0,polygonRingsCount:0,polygonFeaturesCount:0};if(t.byteLength<=0)return[n,r];const i=new La(new ga.a(t));return(e&&Array.isArray(e.layers)?e.layers:Object.keys(i.layers)).forEach(t=>{const o=i.layers[t];if(o)for(let i=0;i<o.length;i++){const a=Ga(o.feature(i,r),e,t);n.push(a)}}),[n,r]}(t,e),i=oa(n,r);return i.byteLength=t.byteLength,i}function Ua(t,e){if(t.byteLength<=0)return[];const n=[],r=new xa(new ga.a(t));return(Array.isArray(e.layers)?e.layers:Object.keys(r.layers)).forEach(t=>{const i=r.layers[t];if(i)for(let r=0;r<i.length;r++){const o=Na(i.feature(r),e,t);n.push(o)}}),n}function Na(t,e,n){const r=t.toGeoJSON("wgs84"===e.coordinates?e.tileIndex:Va);return e.layerProperty&&(r.properties[e.layerProperty]=n),r}function Ga(t,e,n){const r=t.toBinaryCoordinates("wgs84"===e.coordinates?e.tileIndex:Ha);return e.layerProperty&&r.properties&&(r.properties[e.layerProperty]=n),r}function Va(t,e){const{extent:n}=e;for(let e=0;e<t.length;e++){const r=t[e];r[0]/=n,r[1]/=n}}function Ha(t,e){const{extent:n}=e;for(let e=0,r=t.length;e<r;++e)t[e]/=n}const Wa={name:"Mapbox Vector Tile",id:"mvt",module:"mvt",version:"3.2.10",extensions:["mvt","pbf"],mimeTypes:["application/vnd.mapbox-vector-tile","application/x-protobuf"],worker:!0,category:"geometry",options:{mvt:{shape:"geojson",coordinates:"local",layerProperty:"layerName",layers:void 0,tileIndex:null}}};function qa(t,e){const n=null==e?void 0:e.globalFeatureId;return void 0!==n?function(t,e){const n=Ja(t);for(const t of n){let n=0,r=t.featureIds.value[0];for(let i=0;i<t.featureIds.value.length;i++){const o=t.featureIds.value[i];if(o!==r){if(e===t.globalFeatureIds.value[n])return Qa(t,n,i);n=i,r=o}}if(e===t.globalFeatureIds.value[n])return Qa(t,n,t.featureIds.value.length)}throw new Error("featureId:".concat(e," not found"))}(t,n):Xa(t,null==e?void 0:e.type)}function Xa(t,e){return function(t){const e=[];for(const n of t){if(0===n.featureIds.value.length)continue;let t=0,r=n.featureIds.value[0];for(let i=0;i<n.featureIds.value.length;i++){const o=n.featureIds.value[i];o!==r&&(e.push(Qa(n,t,i)),t=i,r=o)}e.push(Qa(n,t,n.featureIds.value.length))}return e}(Ja(t,e))}function Za(t,e,n){switch(t.type){case"Point":return function(t,e,n){const{positions:r}=t,i=Ka(r,e,n);if(i.length>1)return{type:"MultiPoint",coordinates:i};return{type:"Point",coordinates:i[0]}}(t,e,n);case"LineString":return function(t,e=-1/0,n=1/0){const{positions:r}=t,i=t.pathIndices.value.filter(t=>t>=e&&t<=n);if(!(i.length>2)){return{type:"LineString",coordinates:Ka(r,i[0],i[1])}}const o=[];for(let t=0;t<i.length-1;t++){const e=Ka(r,i[t],i[t+1]);o.push(e)}return{type:"MultiLineString",coordinates:o}}(t,e,n);case"Polygon":return function t(e,n=-1/0,r=1/0){const{positions:i}=e,o=e.polygonIndices.value.filter(t=>t>=n&&t<=r),a=e.primitivePolygonIndices.value.filter(t=>t>=n&&t<=r);if(!(o.length>2)){const t=[];for(let e=0;e<a.length-1;e++){const n=a[e],r=a[e+1],o=Ka(i,n,r);t.push(o)}return{type:"Polygon",coordinates:t}}const s=[];for(let n=0;n<o.length-1;n++){const r=o[n],i=o[n+1],a=t(e,r,i).coordinates;s.push(a)}return{type:"MultiPolygon",coordinates:s}}(t,e,n);default:const r=t;throw new Error("Unsupported geometry type: ".concat(null==r?void 0:r.type))}}function Ja(t,e){if(!Boolean(t.points||t.lines||t.polygons))return t.type=e||function(t){if(t.pathIndices)return"LineString";if(t.polygonIndices)return"Polygon";return"Point"}(t),[t];const n=[];return t.points&&(t.points.type="Point",n.push(t.points)),t.lines&&(t.lines.type="LineString",n.push(t.lines)),t.polygons&&(t.polygons.type="Polygon",n.push(t.polygons)),n}function Qa(t,e,n){return{type:"Feature",geometry:Za(t,e,n),properties:function(t,e=0,n){const r=Object.assign({},t.properties[t.featureIds.value[e]]);for(const n in t.numericProps)r[n]=t.numericProps[n].value[e];return r}(t,e),...function(t,e=0,n){return t.fields&&t.fields[t.featureIds.value[e]]}(t,e)}}function Ka(t,e,n){e=e||0,n=n||t.value.length/t.size;const r=[];for(let i=e;i<n;i++){const e=Array();for(let n=i*t.size;n<(i+1)*t.size;n++)e.push(Number(t.value[n]));r.push(e)}return r}var Ya=n(218);function $a(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}var ts={clipBounds:[0,0,1,1],clipByInstance:void 0},es="\nuniform vec4 clip_bounds;\n\nbool clip_isInBounds(vec2 position) {\n  return position.x >= clip_bounds[0] && position.y >= clip_bounds[1] && position.x < clip_bounds[2] && position.y < clip_bounds[3];\n}\n",ns={name:"clip-vs",vs:es},rs={"vs:#decl":"\nvarying float clip_isVisible;\n","vs:DECKGL_FILTER_GL_POSITION":"\n  clip_isVisible = float(clip_isInBounds(geometry.worldPosition.xy));\n","fs:#decl":"\nvarying float clip_isVisible;\n","fs:DECKGL_FILTER_COLOR":"\n  if (clip_isVisible < 0.5) discard;\n"},is={name:"clip-fs",fs:es},os={"vs:#decl":"\nvarying vec2 clip_commonPosition;\n","vs:DECKGL_FILTER_GL_POSITION":"\n  clip_commonPosition = geometry.position.xy;\n","fs:#decl":"\nvarying vec2 clip_commonPosition;\n","fs:DECKGL_FILTER_COLOR":"\n  if (!clip_isInBounds(clip_commonPosition)) discard;\n"},as=function(t){a()(n,t);var e=$a(n);function n(){return i()(this,n),e.apply(this,arguments)}return g()(n,[{key:"getShaders",value:function(){var t="instancePositions"in this.getAttributeManager().attributes;return void 0!==this.props.clipByInstance&&(t=Boolean(this.props.clipByInstance)),this.state.clipByInstance=t,t?{modules:[ns],inject:rs}:{modules:[is],inject:os}}},{key:"draw",value:function(t){var e=t.uniforms,n=this.props.clipBounds,r=void 0===n?ts.clipBounds:n;if(this.state.clipByInstance)e.clip_bounds=r;else{var i=this.projectPosition([r[0],r[1],0]),o=this.projectPosition([r[2],r[3],0]);e.clip_bounds=[Math.min(i[0],o[0]),Math.min(i[1],o[1]),Math.max(i[0],o[0]),Math.max(i[1],o[1])]}}}]),n}(Ya.a);function ss(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function us(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?ss(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):ss(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}f()(as,"defaultProps",ts),f()(as,"extensionName","ClipExtension");var cs={Point:ls,MultiPoint:function(t,e,n){return hs(t,e,n)},LineString:fs,MultiLineString:function(t,e,n){return t.map((function(t){return fs(t,e,n)}))},Polygon:ps,MultiPolygon:function(t,e,n){return t.map((function(t){return ps(t,e,n)}))}};function ls(t,e,n){var r=E()(t,2),i=r[0],o=r[1],a=E()(e,2),s=a[0],u=a[1],c=Object(Nt.g)(s[0],u[0],i),l=Object(Nt.g)(s[1],u[1],o);return n.unprojectFlat([c,l])}function hs(t,e,n){return t.map((function(t){return ls(t,e,n)}))}function fs(t,e,n){return hs(t,e,n)}function ps(t,e,n){return t.map((function(t){return hs(t,e,n)}))}function ds(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return As(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return As(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function As(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var gs=["points","lines","polygons"];function ms(t,e,n,r){var i=t.featureIds.value;if(!i.length)return-1;var o=0,a=i[i.length-1]+1;if(r){var s=function(t,e){if(!t.__layers){for(var n={},r=t.properties,i=0;i<r.length;i++){var o=r[i].layerName;o&&(n[o]?n[o][1]=i:n[o]=[i,i])}t.__layers=n}return t.__layers[e]}(t,r);if(!s)return-1;o=s[0],a=s[1]+1}var u=-1;if(e in t.numericProps){var c=t.numericProps[e].value.findIndex((function(t,e){return t===n&&i[e]>=o&&i[e]<a}));return c>=0?t.globalFeatureIds.value[c]:-1}return e?u=ys(t.properties,(function(t){return t[e]===n}),o,a):t.fields&&(u=ys(t.fields,(function(t){return t.id===n}),o,a)),u>=0?function(t,e){if(!t.__ids){for(var n=[],r=t.featureIds.value,i=t.globalFeatureIds.value,o=0;o<r.length;o++)n[r[o]]=i[o];t.__ids=n}return t.__ids[e]}(t,u):-1}function ys(t,e,n,r){for(var i=n;i<r;i++)if(e(t[i],i))return i;return-1}function vs(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return _s(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return _s(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function _s(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function bs(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}function xs(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function ws(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?xs(Object(n),!0).forEach((function(e){f()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):xs(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var Es=ws(ws({},G.a.defaultProps),{},{onDataLoad:{type:"function",value:null,optional:!0,compare:!1},uniqueIdProperty:"",highlightedFeatureId:null,loaders:[Wa],binary:!0}),Os=function(t){a()(r,t);var e,n=bs(r);function r(){return i()(this,r),n.apply(this,arguments)}return g()(r,[{key:"initializeState",value:function(){Qe()(l()(r.prototype),"initializeState",this).call(this);var t=void 0===this.context.viewport.resolution&&this.props.binary;this.setState({binary:t,data:null,tileJSON:null})}},{key:"isLoaded",get:function(){return this.state&&this.state.data&&this.state.tileset&&Qe()(l()(r.prototype),"isLoaded",this)}},{key:"updateState",value:function(t){var e,n=t.props,i=t.oldProps,o=t.context,a=t.changeFlags;a.dataChanged&&this._updateTileData(),null!==(e=this.state)&&void 0!==e&&e.data&&(Qe()(l()(r.prototype),"updateState",this).call(this,{props:n,oldProps:i,context:o,changeFlags:a}),this._setWGS84PropertyForTiles());var s=n.highlightColor;s!==i.highlightColor&&Array.isArray(s)&&this.setState({highlightColor:s})}},{key:"_updateTileData",value:(e=H()(q.a.mark((function t(){var e,n,r,i,o;return q.a.wrap((function(t){for(;;)switch(t.prev=t.next){case 0:if(e=this.props.data,n=null,"string"!=typeof e||/(?=.*{z})(?=.*{x})(?=.*({y}|{-y}))/.test(e)){t.next=18;break}return r=this.props,i=r.onDataLoad,o=r.fetch,this.setState({data:null,tileJSON:null}),t.prev=5,t.next=8,o(e,{propName:"data",layer:this,loaders:[]});case 8:n=t.sent,t.next=15;break;case 11:t.prev=11,t.t0=t.catch(5),this.raiseError(t.t0,"loading TileJSON"),e=null;case 15:i&&i(n,{propName:"data",layer:this}),t.next=19;break;case 18:e.tilejson&&(n=e);case 19:n&&(e=n.tiles),this.setState({data:e,tileJSON:n});case 21:case"end":return t.stop()}}),t,this,[[5,11]])}))),function(){return e.apply(this,arguments)})},{key:"_getTilesetOptions",value:function(){var t=Qe()(l()(r.prototype),"_getTilesetOptions",this).call(this),e=this.state.tileJSON,n=this.props,i=n.minZoom,o=n.maxZoom;return e&&(Number.isFinite(e.minzoom)&&e.minzoom>i&&(t.minZoom=e.minzoom),Number.isFinite(e.maxzoom)&&(!Number.isFinite(o)||e.maxzoom<o)&&(t.maxZoom=e.maxzoom)),t}},{key:"renderLayers",value:function(){var t;return null!==(t=this.state)&&void 0!==t&&t.data?Qe()(l()(r.prototype),"renderLayers",this).call(this):null}},{key:"getTileData",value:function(t){var e,n=this.state,r=n.data,i=n.binary,o=t.index,a=t.signal,s=Te(r,t);if(!s)return Promise.reject("Invalid URL");var u=this.getLoadOptions();return(0,this.props.fetch)(s,{propName:"data",layer:this,loadOptions:u=ws(ws({},u),{},{mimeType:"application/x-protobuf",mvt:ws(ws({},null===(e=u)||void 0===e?void 0:e.mvt),{},{coordinates:this.context.viewport.resolution?"wgs84":"local",tileIndex:o}),gis:i?{format:"binary"}:{}}),signal:a})}},{key:"renderSubLayers",value:function(t){var e=t.tile.index,n=e.x,i=e.y,o=e.z,a=Math.pow(2,o),s=512/a,u=-s,c=512*n/a,h=512*(1-i/a),f=(new Jt.a).scale([s,u,1]);t.autoHighlight=!1,this.context.viewport.resolution||(t.modelMatrix=f,t.coordinateOrigin=[c,h,0],t.coordinateSystem=Kn.a.CARTESIAN,t.extensions=[].concat(Q()(t.extensions||[]),[new as]));var p=Qe()(l()(r.prototype),"renderSubLayers",this).call(this,t);return!this.state.binary||p instanceof G.a||X.a.warn("renderSubLayers() must return GeoJsonLayer when using binary:true")(),p}},{key:"_updateAutoHighlight",value:function(t){var e,n,r=this.props.uniqueIdProperty,i=this.state,o=i.hoveredFeatureId,a=i.hoveredFeatureLayerName,s=t.object;s&&(e=Ss(s,r),n=Ts(s));var u=this.props.highlightColor;"function"==typeof u&&(u=u(t)),o===e&&a===n||this.setState({highlightColor:u,hoveredFeatureId:e,hoveredFeatureLayerName:n})}},{key:"getPickingInfo",value:function(t){var e=Qe()(l()(r.prototype),"getPickingInfo",this).call(this,t),n=Boolean(this.context.viewport.resolution);if(this.state.binary&&-1!==e.index){var i=t.sourceLayer.props.data;e.object=qa(i,{globalFeatureId:e.index})}return e.object&&!n&&(e.object=Ps(e.object,e.tile.bbox,this.context.viewport)),e}},{key:"getSubLayerPropsByTile",value:function(t){return{highlightedObjectIndex:this.getHighlightedObjectIndex(t),highlightColor:this.state.highlightColor}}},{key:"getHighlightedObjectIndex",value:function(t){var e=this.state,n=e.hoveredFeatureId,r=e.hoveredFeatureLayerName,i=e.binary,o=this.props,a=o.uniqueIdProperty,s=o.highlightedFeatureId,u=t.content,c=Cs(s);if(!(Cs(n)||c))return-1;var l=c?s:n;return Array.isArray(u)?u.findIndex((function(t){var e=Ss(t,a)===l,n=c||Ts(t)===r;return e&&n})):u&&i?function(t,e,n,r){var i,o=ds(gs);try{for(o.s();!(i=o.n()).done;){var a=i.value,s=t[a]&&ms(t[a],e,n,r);if(s>=0)return s}}catch(t){o.e(t)}finally{o.f()}return-1}(u,a,l,c?"":r):-1}},{key:"_pickObjects",value:function(t){var e=this.context,n=e.deck,r=e.viewport,i=r.width,o=r.height,a=r.x,s=r.y,u=[this.id];return n.pickObjects({x:a,y:s,width:i,height:o,layerIds:u,maxObjects:t})}},{key:"getRenderedFeatures",value:function(){var t,e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:null,n=this._pickObjects(e),r=new Set,i=[],o=vs(n);try{for(o.s();!(t=o.n()).done;){var a=t.value,s=Ss(a.object,this.props.uniqueIdProperty);void 0===s?i.push(a.object):r.has(s)||(r.add(s),i.push(a.object))}}catch(t){o.e(t)}finally{o.f()}return i}},{key:"_setWGS84PropertyForTiles",value:function(){var t=this;this.state.tileset.selectedTiles.forEach((function(e){e.hasOwnProperty("dataInWGS84")||Object.defineProperty(e,"dataInWGS84",{get:function(){if(!e.content)return null;if(t.state.binary&&Array.isArray(e.content)&&!e.content.length)return[];var n,r=e.bbox;if(void 0===e._contentWGS84&&(n=r,Number.isFinite(n.west)&&Number.isFinite(n.north)&&Number.isFinite(n.east)&&Number.isFinite(n.south))){var i=t.state.binary?qa(e.content):e.content;e._contentWGS84=i.map((function(e){return Ps(e,r,t.context.viewport)}))}return e._contentWGS84}})}))}}]),r}(Ze);function Ss(t,e){return t.properties&&e?t.properties[e]:"id"in t?t.id:void 0}function Ts(t){var e;return(null===(e=t.properties)||void 0===e?void 0:e.layerName)||null}function Cs(t){return null!=t&&""!==t}function Ps(t,e,n){var r=ws(ws({},t),{},{geometry:{type:t.geometry.type}});return Object.defineProperty(r.geometry,"coordinates",{get:function(){return function(t,e,n){var r=[n.projectFlat([e.west,e.north]),n.projectFlat([e.east,e.south])];return us(us({},t),{},{coordinates:cs[t.type](t.coordinates,r,n)})}(t.geometry,e,n).coordinates}}),r}f()(Os,"layerName","MVTLayer"),f()(Os,"defaultProps",Es);for(var Ms={},Is=0;Is<"0123456789bcdefghjkmnpqrstuvwxyz".length;Is++)Ms["0123456789bcdefghjkmnpqrstuvwxyz".charAt(Is)]=Is;function Bs(t){var e=function(t){for(var e,n=!0,r=90,i=-90,o=180,a=-180,s=0,u=0,c=t.length;u<c;u++){var l=t[u].toLowerCase();s=Ms[l];for(var h=4;h>=0;h--){var f=s>>h&1;n?(e=(o+a)/2,1===f?a=e:o=e):(e=(r+i)/2,1===f?i=e:r=e),n=!n}}return[i,a,r,o]}(t),n=E()(e,4),r=n[0],i=n[1],o=n[2],a=n[3];return[a,o,a,r,i,r,i,o,a,o]}function Rs(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=l()(t);if(e){var i=l()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return u()(this,n)}}var ks=function(t){a()(n,t);var e=Rs(n);function n(){return i()(this,n),e.apply(this,arguments)}return g()(n,[{key:"indexToBounds",value:function(){var t=this.props,e=t.data,n=t.getGeohash;return{data:e,_normalize:!1,positionFormat:"XY",getPolygon:function(t,e){return Bs(n(t,e))}}}}]),n}(x);f()(ks,"layerName","GeohashLayer"),f()(ks,"defaultProps",{getGeohash:{type:"accessor",value:function(t){return t.geohash}}}),n.d(e,"GreatCircleLayer",(function(){return d})),n.d(e,"S2Layer",(function(){return L})),n.d(e,"QuadkeyLayer",(function(){return U})),n.d(e,"TileLayer",(function(){return Ze})),n.d(e,"TripsLayer",(function(){return tn})),n.d(e,"H3ClusterLayer",(function(){return Jn})),n.d(e,"H3HexagonLayer",(function(){return Wn})),n.d(e,"Tile3DLayer",(function(){return Zo})),n.d(e,"TerrainLayer",(function(){return ra})),n.d(e,"MVTLayer",(function(){return Os})),n.d(e,"GeohashLayer",(function(){return ks})),n.d(e,"_GeoCellLayer",(function(){return x})),n.d(e,"_getURLFromTemplate",(function(){return Te})),n.d(e,"_Tileset2D",(function(){return Ne})),n.d(e,"_Tile2DHeader",(function(){return Z}))},function(t,e,n){"use strict";n.r(e);var r=n(3),i=n.n(r),o=n(4),a=n.n(o),s=n(8),u=n.n(s),c=n(5),l=n.n(c),h=n(6),f=n.n(h),p=n(1),d=n.n(p),A=n(0),g=n.n(A),m=n(21),y=n(189),v=n(7),_=n(251),b=n(206),x=n(186),w=n(322);function E(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:[],n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:0;const r=Math.fround(t),i=t-r;return e[n]=r,e[n+1]=i,e}function O(t){return t-Math.fround(t)}function S(t){const e=new Float32Array(32);for(let n=0;n<4;++n)for(let r=0;r<4;++r){const i=4*n+r;E(t[4*r+n],e,2*i)}return e}const T={ONE:1};const C={name:"fp64-arithmetic",vs:"uniform float ONE;\nvec2 split(float a) {\n  const float SPLIT = 4097.0;\n  float t = a * SPLIT;\n#if defined(LUMA_FP64_CODE_ELIMINATION_WORKAROUND)\n  float a_hi = t * ONE - (t - a);\n  float a_lo = a * ONE - a_hi;\n#else\n  float a_hi = t - (t - a);\n  float a_lo = a - a_hi;\n#endif\n  return vec2(a_hi, a_lo);\n}\nvec2 split2(vec2 a) {\n  vec2 b = split(a.x);\n  b.y += a.y;\n  return b;\n}\nvec2 quickTwoSum(float a, float b) {\n#if defined(LUMA_FP64_CODE_ELIMINATION_WORKAROUND)\n  float sum = (a + b) * ONE;\n  float err = b - (sum - a) * ONE;\n#else\n  float sum = a + b;\n  float err = b - (sum - a);\n#endif\n  return vec2(sum, err);\n}\nvec2 twoSum(float a, float b) {\n  float s = (a + b);\n#if defined(LUMA_FP64_CODE_ELIMINATION_WORKAROUND)\n  float v = (s * ONE - a) * ONE;\n  float err = (a - (s - v) * ONE) * ONE * ONE * ONE + (b - v);\n#else\n  float v = s - a;\n  float err = (a - (s - v)) + (b - v);\n#endif\n  return vec2(s, err);\n}\n\nvec2 twoSub(float a, float b) {\n  float s = (a - b);\n#if defined(LUMA_FP64_CODE_ELIMINATION_WORKAROUND)\n  float v = (s * ONE - a) * ONE;\n  float err = (a - (s - v) * ONE) * ONE * ONE * ONE - (b + v);\n#else\n  float v = s - a;\n  float err = (a - (s - v)) - (b + v);\n#endif\n  return vec2(s, err);\n}\n\nvec2 twoSqr(float a) {\n  float prod = a * a;\n  vec2 a_fp64 = split(a);\n#if defined(LUMA_FP64_CODE_ELIMINATION_WORKAROUND)\n  float err = ((a_fp64.x * a_fp64.x - prod) * ONE + 2.0 * a_fp64.x *\n    a_fp64.y * ONE * ONE) + a_fp64.y * a_fp64.y * ONE * ONE * ONE;\n#else\n  float err = ((a_fp64.x * a_fp64.x - prod) + 2.0 * a_fp64.x * a_fp64.y) + a_fp64.y * a_fp64.y;\n#endif\n  return vec2(prod, err);\n}\n\nvec2 twoProd(float a, float b) {\n  float prod = a * b;\n  vec2 a_fp64 = split(a);\n  vec2 b_fp64 = split(b);\n  float err = ((a_fp64.x * b_fp64.x - prod) + a_fp64.x * b_fp64.y +\n    a_fp64.y * b_fp64.x) + a_fp64.y * b_fp64.y;\n  return vec2(prod, err);\n}\n\nvec2 sum_fp64(vec2 a, vec2 b) {\n  vec2 s, t;\n  s = twoSum(a.x, b.x);\n  t = twoSum(a.y, b.y);\n  s.y += t.x;\n  s = quickTwoSum(s.x, s.y);\n  s.y += t.y;\n  s = quickTwoSum(s.x, s.y);\n  return s;\n}\n\nvec2 sub_fp64(vec2 a, vec2 b) {\n  vec2 s, t;\n  s = twoSub(a.x, b.x);\n  t = twoSub(a.y, b.y);\n  s.y += t.x;\n  s = quickTwoSum(s.x, s.y);\n  s.y += t.y;\n  s = quickTwoSum(s.x, s.y);\n  return s;\n}\n\nvec2 mul_fp64(vec2 a, vec2 b) {\n  vec2 prod = twoProd(a.x, b.x);\n  prod.y += a.x * b.y;\n#if defined(LUMA_FP64_HIGH_BITS_OVERFLOW_WORKAROUND)\n  prod = split2(prod);\n#endif\n  prod = quickTwoSum(prod.x, prod.y);\n  prod.y += a.y * b.x;\n#if defined(LUMA_FP64_HIGH_BITS_OVERFLOW_WORKAROUND)\n  prod = split2(prod);\n#endif\n  prod = quickTwoSum(prod.x, prod.y);\n  return prod;\n}\n\nvec2 div_fp64(vec2 a, vec2 b) {\n  float xn = 1.0 / b.x;\n#if defined(LUMA_FP64_HIGH_BITS_OVERFLOW_WORKAROUND)\n  vec2 yn = mul_fp64(a, vec2(xn, 0));\n#else\n  vec2 yn = a * xn;\n#endif\n  float diff = (sub_fp64(a, mul_fp64(b, yn))).x;\n  vec2 prod = twoProd(xn, diff);\n  return sum_fp64(yn, prod);\n}\n\nvec2 sqrt_fp64(vec2 a) {\n  if (a.x == 0.0 && a.y == 0.0) return vec2(0.0, 0.0);\n  if (a.x < 0.0) return vec2(0.0 / 0.0, 0.0 / 0.0);\n\n  float x = 1.0 / sqrt(a.x);\n  float yn = a.x * x;\n#if defined(LUMA_FP64_CODE_ELIMINATION_WORKAROUND)\n  vec2 yn_sqr = twoSqr(yn) * ONE;\n#else\n  vec2 yn_sqr = twoSqr(yn);\n#endif\n  float diff = sub_fp64(a, yn_sqr).x;\n  vec2 prod = twoProd(x * 0.5, diff);\n#if defined(LUMA_FP64_HIGH_BITS_OVERFLOW_WORKAROUND)\n  return sum_fp64(split(yn), prod);\n#else\n  return sum_fp64(vec2(yn, 0.0), prod);\n#endif\n}\n",fs:null,getUniforms:function(){return T},fp64ify:E,fp64LowPart:O,fp64ifyMatrix4:S};var P,M,I=n(162),B=n(217),R={SUM:1,MEAN:2,MIN:3,MAX:4};function k(t,e){return t+e}function D(t,e){return e>t?e:t}function L(t,e){return e<t?e:t}function j(t,e,n){var r=R[t]||R.SUM;switch(e=function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};if(Number.isFinite(t))return t;return function(n){return e.index=n.index,t(n.source,e)}}(e,n),r){case R.MIN:return function(t){return function(t,e){if(Number.isFinite(e))return t.length?e:null;var n=t.map(e).filter(Number.isFinite);return n.length?n.reduce(L,1/0):null}(t,e)};case R.SUM:return function(t){return function(t,e){if(Number.isFinite(e))return t.length?t.length*e:null;var n=t.map(e).filter(Number.isFinite);return n.length?n.reduce(k,0):null}(t,e)};case R.MEAN:return function(t){return function(t,e){if(Number.isFinite(e))return t.length?e:null;var n=t.map(e).filter(Number.isFinite);return n.length?n.reduce(k,0)/n.length:null}(t,e)};case R.MAX:return function(t){return function(t,e){if(Number.isFinite(e))return t.length?e:null;var n=t.map(e).filter(Number.isFinite);return n.length?n.reduce(D,-1/0):null}(t,e)};default:return null}}function F(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};return function(n){return e.indices=n.map((function(t){return t.index})),t(n.map((function(t){return t.source})),e)}}var z,U={projectPoints:!1,viewport:null,createBufferObjects:!0,moduleSettings:{}},N=3402823466e29,G=[32775,32774],V=[32776,32774],H=[32776,32775],W=(P={},g()(P,R.SUM,32774),g()(P,R.MEAN,32774),g()(P,R.MIN,G),g()(P,R.MAX,V),P),q={size:1,operation:R.SUM,needMin:!1,needMax:!1,combineMaxMin:!1},X=(M={},g()(M,10240,9728),g()(M,10241,9728),n(107)),Z=n(74),J=(z={},g()(z,10240,9728),g()(z,10241,9728),z);function Q(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},n=e.width,r=void 0===n?1:n,i=e.height,o=void 0===i?1:i,a=e.data,s=void 0===a?null:a,u=e.unpackFlipY,c=void 0===u||u,l=e.parameters,h=void 0===l?J:l,f=new X.a(t,{data:s,format:Object(v.j)(t)?34836:6408,type:5126,border:0,mipmaps:!1,parameters:h,dataFormat:6408,width:r,height:o,unpackFlipY:c});return f}function K(t,e){var n=e.id,r=e.width,i=void 0===r?1:r,o=e.height,a=void 0===o?1:o,s=e.texture;return new Z.a(t,{id:n,width:i,height:a,attachments:g()({},36064,s)})}function Y(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return $(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return $(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function $(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function tt(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function et(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?tt(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):tt(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var nt=["aggregationBuffer","maxMinBuffer","minBuffer","maxBuffer"],rt={maxData:"maxBuffer",minData:"minBuffer",maxMinData:"maxMinBuffer"},it=[y.a.WEBGL2,y.a.COLOR_ATTACHMENT_RGBA32F,y.a.BLEND_EQUATION_MINMAX,y.a.FLOAT_BLEND,y.a.TEXTURE_FLOAT],ot=function(){function t(e){var n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};i()(this,t),this.id=n.id||"gpu-grid-aggregator",this.gl=e,this.state={weightAttributes:{},textures:{},meanTextures:{},buffers:{},framebuffers:{},maxMinFramebuffers:{},minFramebuffers:{},maxFramebuffers:{},equations:{},resources:{},results:{}},this._hasGPUSupport=Object(v.j)(e)&&Object(_.c)(this.gl,y.a.BLEND_EQUATION_MINMAX,y.a.COLOR_ATTACHMENT_RGBA32F,y.a.TEXTURE_FLOAT),this._hasGPUSupport&&this._setupModels()}return a()(t,[{key:"delete",value:function(){var t=this.gridAggregationModel,e=this.allAggregationModel,n=this.meanTransform,r=this.state,i=r.textures,o=r.framebuffers,a=r.maxMinFramebuffers,s=r.minFramebuffers,u=r.maxFramebuffers,c=r.meanTextures,l=r.resources;null==t||t.delete(),null==e||e.delete(),null==n||n.delete(),function(t){(t=Array.isArray(t)?t:[t]).forEach((function(t){for(var e in t)t[e].delete()}))}([o,i,a,s,u,c,l])}},{key:"run",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};this.setState({results:{}});var e=this._normalizeAggregationParams(t);return this._hasGPUSupport||m.a.log(1,"GPUGridAggregator: not supported")(),this._runAggregation(e)}},{key:"getData",value:function(t){var e={},n=this.state.results;for(var r in n[t].aggregationData||(n[t].aggregationData=n[t].aggregationBuffer.getData()),e.aggregationData=n[t].aggregationData,rt){var i=rt[r];(n[t][r]||n[t][i])&&(n[t][r]=n[t][r]||n[t][i].getData(),e[r]=n[t][r])}return e}},{key:"updateShaders",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};this.setState({shaderOptions:t,modelDirty:!0})}},{key:"_normalizeAggregationParams",value:function(t){var e=et(et({},U),t),n=e.weights;return n&&(e.weights=function(t){var e={};for(var n in t)e[n]=et(et({},q),t[n]);return e}(n)),e}},{key:"setState",value:function(t){Object.assign(this.state,t)}},{key:"_getAggregateData",value:function(t){var e={},n=this.state,r=n.textures,i=n.framebuffers,o=n.maxMinFramebuffers,a=n.minFramebuffers,s=n.maxFramebuffers,u=n.resources,c=t.weights;for(var l in c){e[l]={};var h=c[l],f=h.needMin,p=h.needMax,d=h.combineMaxMin;e[l].aggregationTexture=r[l],e[l].aggregationBuffer=Object(b.d)(i[l],{target:c[l].aggregationBuffer,sourceType:5126}),f&&p&&d?(e[l].maxMinBuffer=Object(b.d)(o[l],{target:c[l].maxMinBuffer,sourceType:5126}),e[l].maxMinTexture=u["".concat(l,"-maxMinTexture")]):(f&&(e[l].minBuffer=Object(b.d)(a[l],{target:c[l].minBuffer,sourceType:5126}),e[l].minTexture=u["".concat(l,"-minTexture")]),p&&(e[l].maxBuffer=Object(b.d)(s[l],{target:c[l].maxBuffer,sourceType:5126}),e[l].maxTexture=u["".concat(l,"-maxTexture")]))}return this._trackGPUResultBuffers(e,c),e}},{key:"_renderAggregateData",value:function(t){var e=t.cellSize,n=t.projectPoints,r=t.attributes,i=t.moduleSettings,o=t.numCol,a=t.numRow,s=t.weights,u=t.translation,c=t.scaling,l=this.state,h=l.maxMinFramebuffers,f=l.minFramebuffers,p=l.maxFramebuffers,d=[o,a],A={blend:!0,depthTest:!1,blendFunc:[1,1]},g={cellSize:e,gridSize:d,projectPoints:n,translation:u,scaling:c};for(var m in s){var y=s[m],v=y.needMin,_=y.needMax,b=v&&_&&s[m].combineMaxMin;this._renderToWeightsTexture({id:m,parameters:A,moduleSettings:i,uniforms:g,gridSize:d,attributes:r,weights:s}),b?this._renderToMaxMinTexture({id:m,parameters:et(et({},A),{},{blendEquation:H}),gridSize:d,minOrMaxFb:h[m],clearParams:{clearColor:[0,0,0,N]},combineMaxMin:b}):(v&&this._renderToMaxMinTexture({id:m,parameters:et(et({},A),{},{blendEquation:G}),gridSize:d,minOrMaxFb:f[m],clearParams:{clearColor:[N,N,N,0]},combineMaxMin:b}),_&&this._renderToMaxMinTexture({id:m,parameters:et(et({},A),{},{blendEquation:V}),gridSize:d,minOrMaxFb:p[m],clearParams:{clearColor:[0,0,0,0]},combineMaxMin:b}))}}},{key:"_renderToMaxMinTexture",value:function(t){var e=t.id,n=t.parameters,r=t.gridSize,i=t.minOrMaxFb,o=t.combineMaxMin,a=t.clearParams,s=void 0===a?{}:a,u=this.state.framebuffers,c=this.gl,l=this.allAggregationModel;Object(v.o)(c,et(et({},s),{},{framebuffer:i,viewport:[0,0,r[0],r[1]]}),(function(){c.clear(16384),l.draw({parameters:n,uniforms:{uSampler:u[e].texture,gridSize:r,combineMaxMin:o}})}))}},{key:"_renderToWeightsTexture",value:function(t){var e=t.id,n=t.parameters,r=t.moduleSettings,i=t.uniforms,o=t.gridSize,a=t.weights,s=this.state,u=s.framebuffers,c=s.equations,l=s.weightAttributes,h=this.gl,f=this.gridAggregationModel,p=a[e].operation,d=p===R.MIN?[N,N,N,0]:[0,0,0,0];if(Object(v.o)(h,{framebuffer:u[e],viewport:[0,0,o[0],o[1]],clearColor:d},(function(){h.clear(16384);var t={weights:l[e]};f.draw({parameters:et(et({},n),{},{blendEquation:c[e]}),moduleSettings:r,uniforms:i,attributes:t})})),p===R.MEAN){var A=this.state,m=A.meanTextures,y=A.textures,_={_sourceTextures:{aggregationValues:m[e]},_targetTexture:y[e],elementCount:y[e].width*y[e].height};this.meanTransform?this.meanTransform.update(_):this.meanTransform=function(t,e){return new w.a(t,et({vs:"#define SHADER_NAME gpu-aggregation-transform-mean-vs\nattribute vec4 aggregationValues;\nvarying vec4 meanValues;\n\nvoid main()\n{\n  bool isCellValid = bool(aggregationValues.w > 0.);\n  meanValues.xyz = isCellValid ? aggregationValues.xyz/aggregationValues.w : vec3(0, 0, 0);\n  meanValues.w = aggregationValues.w;\n  gl_PointSize = 1.0;\n}\n",_targetTextureVarying:"meanValues"},e))}(h,_),this.meanTransform.run({parameters:{blend:!1,depthTest:!1}}),u[e].attach(g()({},36064,y[e]))}}},{key:"_runAggregation",value:function(t){this._updateModels(t),this._setupFramebuffers(t),this._renderAggregateData(t);var e=this._getAggregateData(t);return this.setState({results:e}),e}},{key:"_setupFramebuffers",value:function(t){var e=this.state,n=e.textures,r=e.framebuffers,i=e.maxMinFramebuffers,o=e.minFramebuffers,a=e.maxFramebuffers,s=e.meanTextures,u=e.equations,c=t.weights,l=t.numCol,h=t.numRow,f={width:l,height:h};for(var p in c){var d=c[p],A=d.needMin,m=d.needMax,y=d.combineMaxMin,v=d.operation;n[p]=c[p].aggregationTexture||n[p]||Q(this.gl,{id:"".concat(p,"-texture"),width:l,height:h}),n[p].resize(f);var _=n[p];v===R.MEAN&&(s[p]=s[p]||Q(this.gl,{id:"".concat(p,"-mean-texture"),width:l,height:h}),s[p].resize(f),_=s[p]),r[p]?r[p].attach(g()({},36064,_)):r[p]=K(this.gl,{id:"".concat(p,"-fb"),width:l,height:h,texture:_}),r[p].resize(f),u[p]=W[v]||W.SUM,(A||m)&&(A&&m&&y?i[p]||(_=c[p].maxMinTexture||this._getMinMaxTexture("".concat(p,"-maxMinTexture")),i[p]=K(this.gl,{id:"".concat(p,"-maxMinFb"),texture:_})):(A&&(o[p]||(_=c[p].minTexture||this._getMinMaxTexture("".concat(p,"-minTexture")),o[p]=K(this.gl,{id:"".concat(p,"-minFb"),texture:_}))),m&&(a[p]||(_=c[p].maxTexture||this._getMinMaxTexture("".concat(p,"-maxTexture")),a[p]=K(this.gl,{id:"".concat(p,"-maxFb"),texture:_})))))}}},{key:"_getMinMaxTexture",value:function(t){var e=this.state.resources;return e[t]||(e[t]=Q(this.gl,{id:"resourceName"})),e[t]}},{key:"_setupModels",value:function(){var t,e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},n=e.numCol,r=void 0===n?0:n,i=e.numRow,o=void 0===i?0:i,a=this.gl,s=this.state.shaderOptions;if(null===(t=this.gridAggregationModel)||void 0===t||t.delete(),this.gridAggregationModel=at(a,s),!this.allAggregationModel){var u=r*o;this.allAggregationModel=st(a,u)}}},{key:"_setupWeightAttributes",value:function(t){var e=this.state.weightAttributes,n=t.weights;for(var r in n)e[r]=t.attributes[r]}},{key:"_trackGPUResultBuffers",value:function(t,e){var n=this.state.resources;for(var r in t)if(t[r]){var i,o=Y(nt);try{for(o.s();!(i=o.n()).done;){var a=i.value;if(t[r][a]&&e[r][a]!==t[r][a]){var s="gpu-result-".concat(r,"-").concat(a);n[s]&&n[s].delete(),n[s]=t[r][a]}}}catch(t){o.e(t)}finally{o.f()}}}},{key:"_updateModels",value:function(t){var e=t.vertexCount,n=t.attributes,r=t.numCol,i=t.numRow;this.state.modelDirty&&(this._setupModels(t),this.setState({modelDirty:!1})),this._setupWeightAttributes(t),this.gridAggregationModel.setVertexCount(e),this.gridAggregationModel.setAttributes(n),this.allAggregationModel.setInstanceCount(r*i)}}],[{key:"getAggregationData",value:function(t){var e=t.aggregationData,n=t.maxData,r=t.minData,i=t.maxMinData,o=4*t.pixelIndex,a={};return e&&(a.cellCount=e[o+3],a.cellWeight=e[o]),i?(a.maxCellWieght=i[0],a.minCellWeight=i[3]):(n&&(a.maxCellWieght=n[0],a.totalCount=n[3]),r&&(a.minCellWeight=r[0],a.totalCount=n[3])),a}},{key:"getCellData",value:function(t){for(var e=t.countsData,n=t.size,r=void 0===n?1:n,i=e.length/4,o=new Float32Array(i*r),a=new Uint32Array(i),s=0;s<i;s++){for(var u=0;u<r;u++)o[s*r+u]=e[4*s+u];a[s]=e[4*s+3]}return{cellCounts:a,cellWeights:o}}},{key:"isSupported",value:function(t){return Object(_.c)(t,it)}}]),t}();function at(t,e){var n=Object(I.a)({vs:"#define SHADER_NAME gpu-aggregation-to-grid-vs\n\nattribute vec3 positions;\nattribute vec3 positions64Low;\nattribute vec3 weights;\nuniform vec2 cellSize;\nuniform vec2 gridSize;\nuniform bool projectPoints;\nuniform vec2 translation;\nuniform vec3 scaling;\n\nvarying vec3 vWeights;\n\nvec2 project_to_pixel(vec4 pos) {\n  vec4 result;\n  pos.xy = pos.xy/pos.w;\n  result = pos + vec4(translation, 0., 0.);\n  result.xy = scaling.z > 0. ? result.xy * scaling.xy : result.xy;\n  return result.xy;\n}\n\nvoid main(void) {\n\n  vWeights = weights;\n\n  vec4 windowPos = vec4(positions, 1.);\n  if (projectPoints) {\n    windowPos = project_position_to_clipspace(positions, positions64Low, vec3(0));\n  }\n\n  vec2 pos = project_to_pixel(windowPos);\n\n  vec2 pixelXY64[2];\n  pixelXY64[0] = vec2(pos.x, 0.);\n  pixelXY64[1] = vec2(pos.y, 0.);\n  vec2 gridXY64[2];\n  gridXY64[0] = div_fp64(pixelXY64[0], vec2(cellSize.x, 0));\n  gridXY64[1] = div_fp64(pixelXY64[1], vec2(cellSize.y, 0));\n  float x = floor(gridXY64[0].x);\n  float y = floor(gridXY64[1].x);\n  pos = vec2(x, y);\n  pos = (pos * (2., 2.) / (gridSize)) - (1., 1.);\n  vec2 offset = 1.0 / gridSize;\n  pos = pos + offset;\n\n  gl_Position = vec4(pos, 0.0, 1.0);\n  gl_PointSize = 1.0;\n}\n",fs:"#define SHADER_NAME gpu-aggregation-to-grid-fs\n\nprecision highp float;\n\nvarying vec3 vWeights;\n\nvoid main(void) {\n  gl_FragColor = vec4(vWeights, 1.0);\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n",modules:[C,B.a]},e);return new x.a(t,et({id:"Gird-Aggregation-Model",vertexCount:1,drawMode:0},n))}function st(t,e){return new x.a(t,{id:"All-Aggregation-Model",vs:"#version 300 es\n#define SHADER_NAME gpu-aggregation-all-vs-64\n\nin vec2 position;\nuniform ivec2 gridSize;\nout vec2 vTextureCoord;\n\nvoid main(void) {\n  vec2 pos = vec2(-1.0, -1.0);\n  vec2 offset = 1.0 / vec2(gridSize);\n  pos = pos + offset;\n\n  gl_Position = vec4(pos, 0.0, 1.0);\n\n  int yIndex = gl_InstanceID / gridSize[0];\n  int xIndex = gl_InstanceID - (yIndex * gridSize[0]);\n\n  vec2 yIndexFP64 = vec2(float(yIndex), 0.);\n  vec2 xIndexFP64 = vec2(float(xIndex), 0.);\n  vec2 gridSizeYFP64 = vec2(gridSize[1], 0.);\n  vec2 gridSizeXFP64 = vec2(gridSize[0], 0.);\n\n  vec2 texCoordXFP64 = div_fp64(yIndexFP64, gridSizeYFP64);\n  vec2 texCoordYFP64 = div_fp64(xIndexFP64, gridSizeXFP64);\n\n  vTextureCoord = vec2(texCoordYFP64.x, texCoordXFP64.x);\n  gl_PointSize = 1.0;\n}\n",fs:"#version 300 es\n#define SHADER_NAME gpu-aggregation-all-fs\n\nprecision highp float;\n\nin vec2 vTextureCoord;\nuniform sampler2D uSampler;\nuniform bool combineMaxMin;\nout vec4 fragColor;\nvoid main(void) {\n  vec4 textureColor = texture(uSampler, vec2(vTextureCoord.s, vTextureCoord.t));\n  if (textureColor.a == 0.) {\n    discard;\n  }\n  fragColor.rgb = textureColor.rgb;\n  fragColor.a = combineMaxMin ? textureColor.r : textureColor.a;\n}\n",modules:[C],vertexCount:1,drawMode:0,isInstanced:!0,instanceCount:e,attributes:{position:[0,0]}})}var ut=n(60),ct=n(234),lt=n(164),ht=[[255,255,178],[254,217,118],[254,178,76],[253,141,60],[240,59,32],[189,0,38]];function ft(t){var e,n=arguments.length>1&&void 0!==arguments[1]&&arguments[1],r=arguments.length>2&&void 0!==arguments[2]?arguments[2]:Float32Array;if(Number.isFinite(t[0]))e=new r(t);else{e=new r(4*t.length);for(var i=0,o=0;o<t.length;o++){var a=t[o];e[i++]=a[0],e[i++]=a[1],e[i++]=a[2],e[i++]=Number.isFinite(a[3])?a[3]:255}}if(n)for(var s=0;s<e.length;s++)e[s]/=255;return e}function pt(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function dt(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?pt(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):pt(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function At(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}var gt=[0,0,0,0],mt=[0,255,0,255],yt=["minColor","maxColor","colorRange","colorDomain"],vt={cellSizePixels:{value:100,min:1},cellMarginPixels:{value:2,min:0,max:5},colorDomain:null,colorRange:ht},_t=function(t){l()(n,t);var e=At(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(){return{vs:"#define SHADER_NAME screen-grid-layer-vertex-shader\n#define RANGE_COUNT 6\n\nattribute vec3 positions;\nattribute vec3 instancePositions;\nattribute vec4 instanceCounts;\nattribute vec3 instancePickingColors;\n\nuniform float opacity;\nuniform vec3 cellScale;\nuniform vec4 minColor;\nuniform vec4 maxColor;\nuniform vec4 colorRange[RANGE_COUNT];\nuniform vec2 colorDomain;\nuniform bool shouldUseMinMax;\nuniform sampler2D maxTexture;\n\nvarying vec4 vColor;\nvarying float vSampleCount;\n\nvec4 quantizeScale(vec2 domain, vec4 range[RANGE_COUNT], float value) {\n  vec4 outColor = vec4(0., 0., 0., 0.);\n  if (value >= domain.x && value <= domain.y) {\n    float domainRange = domain.y - domain.x;\n    if (domainRange <= 0.) {\n      outColor = colorRange[0];\n    } else {\n      float rangeCount = float(RANGE_COUNT);\n      float rangeStep = domainRange / rangeCount;\n      float idx = floor((value - domain.x) / rangeStep);\n      idx = clamp(idx, 0., rangeCount - 1.);\n      int intIdx = int(idx);\n      outColor = colorRange[intIdx];\n    }\n  }\n  outColor = outColor / 255.;\n  return outColor;\n}\n\nvoid main(void) {\n  vSampleCount = instanceCounts.a;\n\n  float weight = instanceCounts.r;\n  float maxWeight = texture2D(maxTexture, vec2(0.5)).r;\n\n  float step = weight / maxWeight;\n  vec4 minMaxColor = mix(minColor, maxColor, step) / 255.;\n\n  vec2 domain = colorDomain;\n  float domainMaxValid = float(colorDomain.y != 0.);\n  domain.y = mix(maxWeight, colorDomain.y, domainMaxValid);\n  vec4 rangeColor = quantizeScale(domain, colorRange, weight);\n\n  float rangeMinMax = float(shouldUseMinMax);\n  vec4 color = mix(rangeColor, minMaxColor, rangeMinMax);\n  vColor = vec4(color.rgb, color.a * opacity);\n\n  // Set color to be rendered to picking fbo (also used to check for selection highlight).\n  picking_setPickingColor(instancePickingColors);\n\n  gl_Position = vec4(instancePositions + positions * cellScale, 1.);\n}\n",fs:"#define SHADER_NAME screen-grid-layer-fragment-shader\n\nprecision highp float;\n\nvarying vec4 vColor;\nvarying float vSampleCount;\n\nvoid main(void) {\n  if (vSampleCount <= 0.0) {\n    discard;\n  }\n  gl_FragColor = vColor;\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n",modules:[ct.a]}}},{key:"initializeState",value:function(){var t=this.context.gl;this.getAttributeManager().addInstanced({instancePositions:{size:3,update:this.calculateInstancePositions},instanceCounts:{size:4,noAlloc:!0}}),this.setState({model:this._getModel(t)})}},{key:"shouldUpdateState",value:function(t){return t.changeFlags.somethingChanged}},{key:"updateState",value:function(t){u()(d()(n.prototype),"updateState",this).call(this,t);var e=t.oldProps,r=t.props,i=t.changeFlags,o=this.getAttributeManager();r.numInstances!==e.numInstances?o.invalidateAll():e.cellSizePixels!==r.cellSizePixels&&o.invalidate("instancePositions"),this._updateUniforms(e,r,i)}},{key:"draw",value:function(t){var e=t.uniforms,n=this.props,r=n.parameters,i=n.maxTexture,o=this.props.minColor||gt,a=this.props.maxColor||mt,s=this.props.colorDomain||[1,0];this.state.model.setUniforms(e).setUniforms({minColor:o,maxColor:a,maxTexture:i,colorDomain:s}).draw({parameters:dt({depthTest:!1,depthMask:!1},r)})}},{key:"calculateInstancePositions",value:function(t,e){for(var n=e.numInstances,r=this.context.viewport,i=r.width,o=r.height,a=this.props.cellSizePixels,s=Math.ceil(i/a),u=t.value,c=t.size,l=0;l<n;l++){var h=l%s,f=Math.floor(l/s);u[l*c+0]=h*a/i*2-1,u[l*c+1]=1-f*a/o*2,u[l*c+2]=0}}},{key:"_getModel",value:function(t){return new x.a(t,dt(dt({},this.getShaders()),{},{id:this.props.id,geometry:new ut.a({drawMode:6,attributes:{positions:new Float32Array([0,0,0,1,0,0,1,1,0,0,1,0])}}),isInstanced:!0}))}},{key:"_shouldUseMinMax",value:function(){var t=this.props,e=t.minColor,n=t.maxColor,r=t.colorDomain,i=t.colorRange;return e||n?(m.a.deprecated("ScreenGridLayer props: minColor and maxColor","colorRange, colorDomain")(),!0):!r&&!i}},{key:"_updateUniforms",value:function(t,e,n){var r=this.state.model;if(yt.some((function(n){return t[n]!==e[n]}))&&r.setUniforms({shouldUseMinMax:this._shouldUseMinMax()}),t.colorRange!==e.colorRange&&r.setUniforms({colorRange:ft(e.colorRange)}),t.cellMarginPixels!==e.cellMarginPixels||t.cellSizePixels!==e.cellSizePixels||n.viewportChanged){var i=this.context.viewport,o=i.width,a=i.height,s=this.props,u=s.cellSizePixels,c=s.cellMarginPixels,l=u>c?c:0,h=new Float32Array([(u-l)/o*2,-(u-l)/a*2,1]);r.setUniforms({cellScale:h})}}}],[{key:"isSupported",value:function(t){return Object(_.c)(t,[y.a.TEXTURE_FLOAT])}}]),n}(lt.a);g()(_t,"layerName","ScreenGridCellLayer"),g()(_t,"defaultProps",vt);var bt=n(138),xt=n(165),wt=n(198);function Et(t,e){var n={};for(var r in t)e.includes(r)||(n[r]=t[r]);return n}function Ot(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return St(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return St(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function St(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function Tt(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}var Ct=function(t){l()(n,t);var e=Tt(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"initializeAggregationLayer",value:function(t){u()(d()(n.prototype),"initializeState",this).call(this,this.context),this.setState({ignoreProps:Et(this.constructor._propTypes,t.data.props),dimensions:t})}},{key:"updateState",value:function(t){if(u()(d()(n.prototype),"updateState",this).call(this,t),t.changeFlags.extensionsChanged){var e=this.getShaders({});e&&e.defines&&(e.defines.NON_INSTANCED_MODEL=1),this.updateShaders(e)}this._updateAttributes()}},{key:"updateAttributes",value:function(t){this.setState({changedAttributes:t})}},{key:"getAttributes",value:function(){return this.getAttributeManager().getShaderAttributes()}},{key:"getModuleSettings",value:function(){var t=this.context,e=t.viewport,n=t.mousePosition,r=t.gl;return Object.assign(Object.create(this.props),{viewport:e,mousePosition:n,pickingActive:0,devicePixelRatio:Object(v.e)(r)})}},{key:"updateShaders",value:function(t){}},{key:"isAggregationDirty",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},n=t.props,r=t.oldProps,i=t.changeFlags,o=e.compareAll,a=void 0!==o&&o,s=e.dimension,u=this.state.ignoreProps,c=s.props,l=s.accessors,h=void 0===l?[]:l,f=i.updateTriggersChanged;if(i.dataChanged)return!0;if(f){if(f.all)return!0;var p,d=Ot(h);try{for(d.s();!(p=d.n()).done;){var A=p.value;if(f[A])return!0}}catch(t){d.e(t)}finally{d.f()}}if(a)return!!i.extensionsChanged||Object(bt.a)({oldProps:r,newProps:n,ignoreProps:u,propTypes:this.constructor._propTypes});var g,m=Ot(c);try{for(m.s();!(g=m.n()).done;){var y=g.value;if(n[y]!==r[y])return!0}}catch(t){m.e(t)}finally{m.f()}return!1}},{key:"isAttributeChanged",value:function(t){var e=this.state.changedAttributes;return t?e&&void 0!==e[t]:!function(t){var e=!0;for(var n in t){e=!1;break}return e}(e)}},{key:"_getAttributeManager",value:function(){return new xt.a(this.context.gl,{id:this.props.id,stats:this.context.stats})}}]),n}(wt.a);g()(Ct,"layerName","AggregationLayer");var Pt=n(33),Mt=n(9),It=n.n(Mt);function Bt(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return Rt(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return Rt(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function Rt(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function kt(t,e,n){var r=n;return r.domain=function(){return t},r.range=function(){return e},r}function Dt(t,e){return kt(t,e,(function(n){return function(t,e,n){var r=t[1]-t[0];if(r<=0)return m.a.warn("quantizeScale: invalid domain, returning range[0]")(),e[0];var i=r/e.length,o=Math.floor((n-t[0])/i),a=Math.max(Math.min(o,e.length-1),0);return e[a]}(t,e,n)}))}function Lt(t,e){return kt(t,e,(function(n){return function(t,e,n){return(n-t[0])/(t[1]-t[0])*(e[1]-e[0])+e[0]}(t,e,n)}))}function jt(t,e){for(var n=t.sort(Ft),r=0,i=Math.max(1,e.length),o=new Array(i-1);++r<i;)o[r-1]=zt(n,r/i);var a=function(t){return function(t,e,n){return e[function(t,e){var n=0,r=t.length;for(;n<r;){var i=n+r>>>1;Ft(t[i],e)>0?r=i:n=i+1}return n}(t,n)]}(o,e,t)};return a.thresholds=function(){return o},kt(t,e,a)}function Ft(t,e){return t-e}function zt(t,e){var n=t.length;if(e<=0||n<2)return t[0];if(e>=1)return t[n-1];var r=(n-1)*e,i=Math.floor(r),o=t[i];return o+(t[i+1]-o)*(r-i)}function Ut(t,e){var n,r=new Map,i=[],o=Bt(t);try{for(o.s();!(n=o.n()).done;){var a=n.value,s="".concat(a);r.has(s)||r.set(s,i.push(a))}}catch(t){o.e(t)}finally{o.f()}return kt(t,e,(function(t){return function(t,e,n,r){var i="".concat(r),o=e.get(i);return void 0===o&&(o=t.push(r),e.set(i,o)),n[(o-1)%n.length]}(i,r,e,t)}))}function Nt(t){return null!=t}function Gt(t,e){return("function"==typeof e?t.map(e):t).filter(Nt)}function Vt(t,e){return Gt(t,e)}function Ht(t,e){return n=Gt(t,e),r=[],n.forEach((function(t){!r.includes(t)&&Nt(t)&&r.push(t)})),r;var n,r}function Wt(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return qt(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return qt(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function qt(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}var Xt=function(t){return t.length},Zt=function(t){return t.points},Jt=function(t){return t.index},Qt=function(t,e){return t<e?-1:t>e?1:t>=e?0:NaN},Kt={getValue:Xt,getPoints:Zt,getIndex:Jt,filterData:null},Yt=function(){function t(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:[],n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:Kt;i()(this,t),this.aggregatedBins=this.getAggregatedBins(e,n),this._updateMinMaxValues(),this.binMap=this.getBinMap()}return a()(t,[{key:"getAggregatedBins",value:function(t,e){for(var n=e.getValue,r=void 0===n?Xt:n,i=e.getPoints,o=void 0===i?Zt:i,a=e.getIndex,s=void 0===a?Jt:a,u=e.filterData,c="function"==typeof u,l=t.length,h=[],f=0,p=0;p<l;p++){var d=t[p],A=o(d),g=s(d),m=c?A.filter(u):A;d.filteredPoints=c?m:null;var y=m.length?r(m):null;null!=y&&(h[f]={i:Number.isFinite(g)?g:p,value:y,counts:m.length},f++)}return h}},{key:"_percentileToIndex",value:function(t){var e=this.sortedBins.length;if(e<2)return[0,0];var n=t.map((function(t){return e=t,n=0,r=100,Math.max(n,Math.min(r,e));var e,n,r})),r=It()(n,2),i=r[0],o=r[1];return[Math.ceil(i/100*(e-1)),Math.floor(o/100*(e-1))]}},{key:"getBinMap",value:function(){var t,e={},n=Wt(this.aggregatedBins);try{for(n.s();!(t=n.n()).done;){var r=t.value;e[r.i]=r}}catch(t){n.e(t)}finally{n.f()}return e}},{key:"_updateMinMaxValues",value:function(){var t,e=0,n=0,r=3402823466e29,i=0,o=Wt(this.aggregatedBins);try{for(o.s();!(t=o.n()).done;){var a=t.value;e=e>a.counts?e:a.counts,n=n>a.value?n:a.value,r=r<a.value?r:a.value,i+=a.counts}}catch(t){o.e(t)}finally{o.f()}this.maxCount=e,this.maxValue=n,this.minValue=r,this.totalCount=i}},{key:"getValueRange",value:function(t){if(this.sortedBins||(this.sortedBins=this.aggregatedBins.sort((function(t,e){return Qt(t.value,e.value)}))),!this.sortedBins.length)return[];var e=0,n=this.sortedBins.length-1;if(Array.isArray(t)){var r=this._percentileToIndex(t);e=r[0],n=r[1]}return[this.sortedBins[e].value,this.sortedBins[n].value]}},{key:"getValueDomainByScale",value:function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:[],n=It()(e,2),r=n[0],i=void 0===r?0:r,o=n[1],a=void 0===o?100:o;if(this.sortedBins||(this.sortedBins=this.aggregatedBins.sort((function(t,e){return Qt(t.value,e.value)}))),!this.sortedBins.length)return[];var s=this._percentileToIndex([i,a]);return this._getScaleDomain(t,s)}},{key:"_getScaleDomain",value:function(t,e){var n=It()(e,2),r=n[0],i=n[1],o=this.sortedBins;switch(t){case"quantize":case"linear":return[o[r].value,o[i].value];case"quantile":return Vt(o.slice(r,i+1),(function(t){return t.value}));case"ordinal":return Ht(o,(function(t){return t.value}));default:return[o[r].value,o[i].value]}}}]),t}(),$t=n(52),te=n(12);function ee(t){return Number.isFinite(t)?t:0}function ne(t,e){for(var n,r,i=t.positions.value,o=1/0,a=-1/0,s=1/0,u=-1/0,c=0;c<e;c++)r=i[3*c],o=(n=i[3*c+1])<o?n:o,a=n>a?n:a,s=r<s?r:s,u=r>u?r:u;return{xMin:ee(s),xMax:ee(u),yMin:ee(o),yMax:ee(a)}}function re(t,e){var n=t<0?-1:1,r=n<0?Math.abs(t)+e:Math.abs(t);return(r=Math.floor(r/e)*e)*n}function ie(t,e){var n=!(arguments.length>2&&void 0!==arguments[2])||arguments[2];if(!n)return{xOffset:e,yOffset:e};var r=t.yMin,i=t.yMax,o=(r+i)/2;return ae(e,o)}function oe(t,e,n,r){var i=ie(t,e,r!==te.a.CARTESIAN),o=function(t,e,n,r){var i=r.width,o=r.height,a=n===te.a.CARTESIAN?[-i/2,-o/2]:[-180,-90];m.a.assert(n===te.a.CARTESIAN||n===te.a.LNGLAT||n===te.a.DEFAULT);var s=t.xMin,u=t.yMin;return[-1*(re(s-a[0],e.xOffset)+a[0]),-1*(re(u-a[1],e.yOffset)+a[1])]}(t,i,r,n),a=t.xMin,s=t.yMin,u=t.xMax,c=t.yMax,l=u-a+i.xOffset,h=c-s+i.yOffset;return{gridOffset:i,translation:o,width:l,height:h,numCol:Math.ceil(l/i.xOffset),numRow:Math.ceil(h/i.yOffset)}}function ae(t,e){var n;return{yOffset:t/6378e3*(180/Math.PI),xOffset:(n=e,t/6378e3*(180/Math.PI)/Math.cos(n*Math.PI/180))}}function se(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function ue(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?se(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):se(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function ce(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return le(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return le(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function le(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function he(t,e){var n=function(t,e){var n=t.data,r=void 0===n?[]:n,i=t.cellSize,o=e.attributes,a=e.viewport,s=e.projectPoints,u=e.numInstances,c=o.positions.value,l=o.positions.getAccessor().size,h=e.boundingBox||function(t,e){for(var n,r,i=t.value,o=t.getAccessor().size,a=1/0,s=-1/0,u=1/0,c=-1/0,l=0;l<e;l++)r=i[l*o],n=i[l*o+1],Number.isFinite(r)&&Number.isFinite(n)&&(a=n<a?n:a,s=n>s?n:s,u=r<u?r:u,c=r>c?r:c);return{xMin:u,xMax:c,yMin:a,yMax:s}}(o.positions,u),f=e.posOffset||[180,90],p=e.gridOffset||ie(h,i);if(p.xOffset<=0||p.yOffset<=0)return{gridHash:{},gridOffset:p};var d,A=a.width,g=a.height,m=Math.ceil(A/p.xOffset),y=Math.ceil(g/p.yOffset),v={},_=Object($t.a)(r),b=_.iterable,x=_.objectInfo,w=new Array(3),E=ce(b);try{for(E.s();!(d=E.n()).done;){var O=d.value;x.index++,w[0]=c[x.index*l],w[1]=c[x.index*l+1],w[2]=l>=3?c[x.index*l+2]:0;var S=s?a.project(w):w,T=It()(S,2),C=T[0],P=T[1];if(Number.isFinite(C)&&Number.isFinite(P)){var M=Math.floor((P+f[1])/p.yOffset),I=Math.floor((C+f[0])/p.xOffset);if(!s||I>=0&&I<m&&M>=0&&M<y){var B="".concat(M,"-").concat(I);v[B]=v[B]||{count:0,points:[],lonIdx:I,latIdx:M},v[B].count+=1,v[B].points.push({source:O,index:x.index})}}}}catch(t){E.e(t)}finally{E.f()}return{gridHash:v,gridOffset:p,offsets:[-1*f[0],-1*f[1]]}}(t,e),r=function(t){var e=t.gridHash,n=t.gridOffset,r=t.offsets,i=new Array(Object.keys(e).length),o=0;for(var a in e){var s=a.split("-"),u=parseInt(s[0],10),c=parseInt(s[1],10),l=o++;i[l]=ue({index:l,position:[r[0]+n.xOffset*c,r[1]+n.yOffset*u]},e[a])}return i}(n);return{gridHash:n.gridHash,gridOffset:n.gridOffset,data:r}}function fe(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return pe(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return pe(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function pe(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function de(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}var Ae=function(t){l()(n,t);var e=de(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"initializeAggregationLayer",value:function(t){var e=t.dimensions,r=this.context.gl;u()(d()(n.prototype),"initializeAggregationLayer",this).call(this,e),this.setState({layerData:{},gpuGridAggregator:new ot(r,{id:"".concat(this.id,"-gpu-aggregator")}),cpuGridAggregator:he})}},{key:"updateState",value:function(t){u()(d()(n.prototype),"updateState",this).call(this,t),this.updateAggregationState(t);var e=this.state,r=e.aggregationDataDirty,i=e.aggregationWeightsDirty,o=e.gpuAggregation;if(!(this.getNumInstances()<=0)){var a=!1;(r||o&&i)&&(this._updateAggregation(t),a=!0),o||!r&&!i||(this._updateWeightBins(),this._uploadAggregationResults(),a=!0),this.setState({aggregationDirty:a})}}},{key:"finalizeState",value:function(t){var e,r=this.state.weights.count;r&&r.aggregationBuffer&&r.aggregationBuffer.delete(),null===(e=this.state.gpuGridAggregator)||void 0===e||e.delete(),u()(d()(n.prototype),"finalizeState",this).call(this,t)}},{key:"updateShaders",value:function(t){this.state.gpuAggregation&&this.state.gpuGridAggregator.updateShaders(t)}},{key:"updateAggregationState",value:function(t){m.a.assert(!1)}},{key:"allocateResources",value:function(t,e){if(this.state.numRow!==t||this.state.numCol!==e){var n=e*t*4*4,r=this.context.gl,i=this.state.weights;for(var o in i){var a=i[o];a.aggregationBuffer&&a.aggregationBuffer.delete(),a.aggregationBuffer=new Pt.a(r,{byteLength:n,accessor:{size:4,type:5126,divisor:1}})}}}},{key:"updateResults",value:function(t){var e=t.aggregationData,n=t.maxMinData,r=t.maxData,i=t.minData,o=this.state.weights.count;o&&(o.aggregationData=e,o.maxMinData=n,o.maxData=r,o.minData=i)}},{key:"_updateAggregation",value:function(t){var e=this.state,n=e.cpuGridAggregator,r=e.gpuGridAggregator,i=e.gridOffset,o=e.posOffset,a=e.translation,s=void 0===a?[0,0]:a,u=e.scaling,c=void 0===u?[0,0,0]:u,l=e.boundingBox,h=e.projectPoints,f=e.gpuAggregation,p=e.numCol,d=e.numRow,A=t.props,g=this.context.viewport,m=this.getAttributes(),y=this.getNumInstances();if(f){var v=this.state.weights;r.run({weights:v,cellSize:[i.xOffset,i.yOffset],numCol:p,numRow:d,translation:s,scaling:c,vertexCount:y,projectPoints:h,attributes:m,moduleSettings:this.getModuleSettings()})}else{var _=n(A,{gridOffset:i,projectPoints:h,attributes:m,viewport:g,posOffset:o,boundingBox:l});this.setState({layerData:_})}}},{key:"_updateWeightBins",value:function(){var t=this.state.getValue,e=new Yt(this.state.layerData.data||[],{getValue:t});this.setState({sortedBins:e})}},{key:"_uploadAggregationResults",value:function(){var t,e=this.state,n=e.numCol,r=e.numRow,i=this.state.layerData.data,o=this.state.sortedBins,a=o.aggregatedBins,s=o.minValue,u=o.maxValue,c=o.totalCount,l=new Float32Array(n*r*4).fill(0),h=fe(a);try{for(h.s();!(t=h.n()).done;){var f=t.value,p=i[f.i],d=p.lonIdx,A=p.latIdx,g=f.value,m=f.counts,y=4*(d+A*n);l[y]=g,l[y+4-1]=m}}catch(t){h.e(t)}finally{h.f()}var v=new Float32Array([u,0,0,s]),_=new Float32Array([u,0,0,c]),b=new Float32Array([s,0,0,c]);this.updateResults({aggregationData:l,maxMinData:v,maxData:_,minData:b})}}]),n}(Ct);function ge(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}function me(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function ye(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?me(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):me(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}g()(Ae,"layerName","GridAggregationLayer");var ve=ye(ye({},_t.defaultProps),{},{getPosition:{type:"accessor",value:function(t){return t.position}},getWeight:{type:"accessor",value:1},gpuAggregation:!0,aggregation:"SUM"}),_e={data:{props:["cellSizePixels"]},weights:{props:["aggregation"],accessors:["getWeight"]}},be=function(t){l()(n,t);var e=ge(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"initializeState",value:function(){var t,e=this.context.gl;if(!_t.isSupported(e))return this.setState({supported:!1}),void m.a.error("ScreenGridLayer: ".concat(this.id," is not supported on this browser"))();u()(d()(n.prototype),"initializeAggregationLayer",this).call(this,{dimensions:_e,getCellSize:function(t){return t.cellSizePixels}});var r={count:{size:1,operation:R.SUM,needMax:!0,maxTexture:Q(e,{id:"".concat(this.id,"-max-texture")})}};this.setState({supported:!0,projectPoints:!0,weights:r,subLayerData:{attributes:{}},maxTexture:r.count.maxTexture,positionAttributeName:"positions",posOffset:[0,0],translation:[1,-1]}),this.getAttributeManager().add((t={},g()(t,"positions",{size:3,accessor:"getPosition",type:5130,fp64:this.use64bitPositions()}),g()(t,"count",{size:3,accessor:"getWeight"}),t))}},{key:"shouldUpdateState",value:function(t){var e=t.changeFlags;return this.state.supported&&e.somethingChanged}},{key:"updateState",value:function(t){u()(d()(n.prototype),"updateState",this).call(this,t)}},{key:"renderLayers",value:function(){if(!this.state.supported)return[];var t=this.state,e=t.maxTexture,n=t.numRow,r=t.numCol,i=t.weights,o=this.props.updateTriggers,a=i.count.aggregationBuffer;return new(this.getSubLayerClass("cells",_t))(this.props,this.getSubLayerProps({id:"cell-layer",updateTriggers:o}),{data:{attributes:{instanceCounts:a}},maxTexture:e,numInstances:n*r})}},{key:"finalizeState",value:function(t){u()(d()(n.prototype),"finalizeState",this).call(this,t);var e=this.state,r=e.aggregationBuffer,i=e.maxBuffer,o=e.maxTexture;null==r||r.delete(),null==i||i.delete(),null==o||o.delete()}},{key:"getPickingInfo",value:function(t){var e=t.info,n=e.index;if(n>=0){var r=this.state,i=r.gpuGridAggregator,o=r.gpuAggregation,a=r.weights,s=o?i.getData("count"):a.count;e.object=ot.getAggregationData(ye({pixelIndex:n},s))}return e}},{key:"updateResults",value:function(t){var e=t.aggregationData,n=t.maxData,r=this.state.weights.count;r.aggregationData=e,r.aggregationBuffer.setData({data:e}),r.maxData=n,r.maxTexture.setImageData({data:n})}},{key:"updateAggregationState",value:function(t){var e=t.props.cellSizePixels,n=t.oldProps.cellSizePixels!==e,r=t.changeFlags.viewportChanged,i=t.props.gpuAggregation;this.state.gpuAggregation!==t.props.gpuAggregation&&i&&!ot.isSupported(this.context.gl)&&(m.a.warn("GPU Grid Aggregation not supported, falling back to CPU")(),i=!1);var o=i!==this.state.gpuAggregation;this.setState({gpuAggregation:i});var a=this.isAttributeChanged("positions"),s=this.state.dimensions,u=s.data,c=s.weights,l=a||o||r||this.isAggregationDirty(t,{compareAll:i,dimension:u}),h=this.isAggregationDirty(t,{dimension:c});this.setState({aggregationDataDirty:l,aggregationWeightsDirty:h});var f=this.context.viewport;if(r||n){var p=f.width,d=f.height,A=Math.ceil(p/e),g=Math.ceil(d/e);this.allocateResources(g,A),this.setState({scaling:[p/2,-d/2,1],gridOffset:{xOffset:e,yOffset:e},width:p,height:d,numCol:A,numRow:g})}h&&this._updateAccessors(t),(l||h)&&this._resetResults()}},{key:"_updateAccessors",value:function(t){var e=t.props,n=e.getWeight,r=e.aggregation,i=e.data,o=this.state.weights.count;o&&(o.getWeight=n,o.operation=R[r]),this.setState({getValue:j(r,n,{data:i})})}},{key:"_resetResults",value:function(){var t=this.state.weights.count;t&&(t.aggregationData=null)}}]),n}(Ae);g()(be,"layerName","ScreenGridLayer"),g()(be,"defaultProps",ve);var xe=n(223),we=n(28),Ee=n.n(we);function Oe(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function Se(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Oe(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Oe(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function Te(){}var Ce=["getBins","getDomain","getScaleFunc"],Pe=[{key:"fillColor",accessor:"getFillColor",pickingInfo:"colorValue",getBins:{triggers:{value:{prop:"getColorValue",updateTrigger:"getColorValue"},weight:{prop:"getColorWeight",updateTrigger:"getColorWeight"},aggregation:{prop:"colorAggregation"},filterData:{prop:"_filterData",updateTrigger:"_filterData"}}},getDomain:{triggers:{lowerPercentile:{prop:"lowerPercentile"},upperPercentile:{prop:"upperPercentile"},scaleType:{prop:"colorScaleType"}}},getScaleFunc:{triggers:{domain:{prop:"colorDomain"},range:{prop:"colorRange"}},onSet:{props:"onSetColorDomain"}},nullValue:[0,0,0,0]},{key:"elevation",accessor:"getElevation",pickingInfo:"elevationValue",getBins:{triggers:{value:{prop:"getElevationValue",updateTrigger:"getElevationValue"},weight:{prop:"getElevationWeight",updateTrigger:"getElevationWeight"},aggregation:{prop:"elevationAggregation"},filterData:{prop:"_filterData",updateTrigger:"_filterData"}}},getDomain:{triggers:{lowerPercentile:{prop:"elevationLowerPercentile"},upperPercentile:{prop:"elevationUpperPercentile"},scaleType:{prop:"elevationScaleType"}}},getScaleFunc:{triggers:{domain:{prop:"elevationDomain"},range:{prop:"elevationRange"}},onSet:{props:"onSetElevationDomain"}},nullValue:-1}],Me=function(t){return t.cellSize},Ie=function(){function t(e){i()(this,t),this.state={layerData:{},dimensions:{}},this.changeFlags={},this.dimensionUpdaters={},this._getCellSize=e.getCellSize||Me,this._getAggregator=e.getAggregator,this._addDimension(e.dimensions||Pe)}return a()(t,[{key:"updateState",value:function(t,e){var n=t.oldProps,r=t.props,i=t.changeFlags;this.updateGetValueFuncs(n,r,i);var o=this.needsReProjectPoints(n,r,i),a=!1;i.dataChanged||o?(this.getAggregatedData(r,e),a=!0):((this.getDimensionChanges(n,r,i)||[]).forEach((function(t){return"function"==typeof t&&t()})),a=!0);return this.setState({aggregationDirty:a}),this.state}},{key:"setState",value:function(t){this.state=Se(Se({},this.state),t)}},{key:"setDimensionState",value:function(t,e){this.setState({dimensions:Se(Se({},this.state.dimensions),{},g()({},t,Se(Se({},this.state.dimensions[t]),e)))})}},{key:"normalizeResult",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return t.hexagons?Se({data:t.hexagons},t):t.layerData?Se({data:t.layerData},t):t}},{key:"getAggregatedData",value:function(t,e){var n=this._getAggregator(t)(t,e);this.setState({layerData:this.normalizeResult(n)}),this.changeFlags={layerData:!0},this.getSortedBins(t)}},{key:"updateGetValueFuncs",value:function(t,e,n){for(var r in this.dimensionUpdaters){var i=this.dimensionUpdaters[r].getBins.triggers,o=i.value,a=i.weight,s=i.aggregation,u=e[o.prop];this.needUpdateDimensionStep(this.dimensionUpdaters[r].getBins,t,e,n)&&(u=u?F(u,{data:e.data}):j(e[s.prop],e[a.prop],{data:e.data})),u&&this.setDimensionState(r,{getValue:u})}}},{key:"needsReProjectPoints",value:function(t,e,n){return this._getCellSize(t)!==this._getCellSize(e)||this._getAggregator(t)!==this._getAggregator(e)||n.updateTriggersChanged&&(n.updateTriggersChanged.all||n.updateTriggersChanged.getPosition)}},{key:"addDimension",value:function(t){this._addDimension(t)}},{key:"_addDimension",value:function(){var t=this,e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:[];e.forEach((function(e){var n=e.key;t.dimensionUpdaters[n]=t.getDimensionUpdaters(e),t.state.dimensions[n]={getValue:null,domain:null,sortedBins:null,scaleFunc:Te}}))}},{key:"getDimensionUpdaters",value:function(t){var e=t.key,n=t.accessor,r=t.pickingInfo,i=t.getBins,o=t.getDomain,a=t.getScaleFunc,s=t.nullValue;return{key:e,accessor:n,pickingInfo:r,getBins:Se({updater:this.getDimensionSortedBins},i),getDomain:Se({updater:this.getDimensionValueDomain},o),getScaleFunc:Se({updater:this.getDimensionScale},a),attributeAccessor:this.getSubLayerDimensionAttribute(e,s)}}},{key:"needUpdateDimensionStep",value:function(t,e,n,r){return Object.values(t.triggers).some((function(t){return t.updateTrigger?r.dataChanged||r.updateTriggersChanged&&(r.updateTriggersChanged.all||r.updateTriggersChanged[t.updateTrigger]):e[t.prop]!==n[t.prop]}))}},{key:"getDimensionChanges",value:function(t,e,n){var r=this,i=[],o=function(o){var a=Ce.find((function(i){return r.needUpdateDimensionStep(r.dimensionUpdaters[o][i],t,e,n)}));a&&i.push(r.dimensionUpdaters[o][a].updater.bind(r,e,r.dimensionUpdaters[o]))};for(var a in this.dimensionUpdaters)o(a);return i.length?i:null}},{key:"getUpdateTriggers",value:function(t){var e=this,n=t.updateTriggers||{},r={},i=function(i){var o=e.dimensionUpdaters[i].accessor;r[o]={},Ce.forEach((function(a){Object.values(e.dimensionUpdaters[i][a].triggers).forEach((function(e){var i=e.prop,a=e.updateTrigger;if(a){var s=n[a];"object"!==Ee()(s)||Array.isArray(s)?void 0!==s&&(r[o][i]=s):Object.assign(r[o],s)}else r[o][i]=t[i]}))}))};for(var o in this.dimensionUpdaters)i(o);return r}},{key:"getSortedBins",value:function(t){for(var e in this.dimensionUpdaters)this.getDimensionSortedBins(t,this.dimensionUpdaters[e])}},{key:"getDimensionSortedBins",value:function(t,e){var n=e.key,r=this.state.dimensions[n].getValue,i=new Yt(this.state.layerData.data||[],{getValue:r,filterData:t._filterData});this.setDimensionState(n,{sortedBins:i}),this.getDimensionValueDomain(t,e)}},{key:"getDimensionValueDomain",value:function(t,e){var n=e.getDomain,r=e.key,i=n.triggers,o=i.lowerPercentile,a=i.upperPercentile,s=i.scaleType,u=this.state.dimensions[r].sortedBins.getValueDomainByScale(t[s.prop],[t[o.prop],t[a.prop]]);this.setDimensionState(r,{valueDomain:u}),this.getDimensionScale(t,e)}},{key:"getDimensionScale",value:function(t,e){var n=e.key,r=e.getScaleFunc,i=e.getDomain,o=r.triggers,a=o.domain,s=o.range,u=i.triggers.scaleType,c=r.onSet,l=t[s.prop],h=t[a.prop]||this.state.dimensions[n].valueDomain,f=function(t){switch(t){case"quantize":return Dt;case"linear":return Lt;case"quantile":return jt;case"ordinal":return Ut;default:return Dt}}(u&&t[u.prop])(h,l);"object"===Ee()(c)&&"function"==typeof t[c.props]&&t[c.props](f.domain()),this.setDimensionState(n,{scaleFunc:f})}},{key:"getSubLayerDimensionAttribute",value:function(t,e){var n=this;return function(r){var i=n.state.dimensions[t],o=i.sortedBins,a=i.scaleFunc,s=o.binMap[r.index];if(s&&0===s.counts)return e;var u=s&&s.value,c=a.domain();return u>=c[0]&&u<=c[c.length-1]?a(u):e}}},{key:"getSubLayerAccessors",value:function(t){var e={};for(var n in this.dimensionUpdaters){e[this.dimensionUpdaters[n].accessor]=this.getSubLayerDimensionAttribute(t,n)}return e}},{key:"getPickingInfo",value:function(t){var e=t.info,n=null;if(e.picked&&e.index>-1){var r=this.state.layerData.data[e.index],i={};for(var o in this.dimensionUpdaters){var a=this.dimensionUpdaters[o].pickingInfo,s=this.state.dimensions[o].sortedBins,u=s.binMap[r.index]&&s.binMap[r.index].value;i[a]=u}n=Object.assign(i,r,{points:r.filteredPoints||r.points})}return e.picked=Boolean(n),e.object=n,e}},{key:"getAccessor",value:function(t){return this.dimensionUpdaters.hasOwnProperty(t)?this.dimensionUpdaters[t].attributeAccessor:Te}}],[{key:"defaultDimensions",value:function(){return Pe}}]),t}();function Be(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}function Re(){}var ke={colorDomain:null,colorRange:ht,getColorValue:{type:"accessor",value:null},getColorWeight:{type:"accessor",value:1},colorAggregation:"SUM",lowerPercentile:{type:"number",min:0,max:100,value:0},upperPercentile:{type:"number",min:0,max:100,value:100},colorScaleType:"quantize",onSetColorDomain:Re,elevationDomain:null,elevationRange:[0,1e3],getElevationValue:{type:"accessor",value:null},getElevationWeight:{type:"accessor",value:1},elevationAggregation:"SUM",elevationLowerPercentile:{type:"number",min:0,max:100,value:0},elevationUpperPercentile:{type:"number",min:0,max:100,value:100},elevationScale:{type:"number",min:0,value:1},elevationScaleType:"linear",onSetElevationDomain:Re,gridAggregator:he,cellSize:{type:"number",min:0,max:1e3,value:1e3},coverage:{type:"number",min:0,max:1,value:1},getPosition:{type:"accessor",value:function(t){return t.position}},extruded:!1,material:!0,_filterData:{type:"function",value:null,optional:!0}},De=function(t){l()(n,t);var e=Be(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"initializeState",value:function(){var t=new Ie({getAggregator:function(t){return t.gridAggregator},getCellSize:function(t){return t.cellSize}});this.state={cpuAggregator:t,aggregatorState:t.state},this.getAttributeManager().add({positions:{size:3,type:5130,accessor:"getPosition"}})}},{key:"updateState",value:function(t){u()(d()(n.prototype),"updateState",this).call(this,t),this.setState({aggregatorState:this.state.cpuAggregator.updateState(t,{viewport:this.context.viewport,attributes:this.getAttributes(),numInstances:this.getNumInstances()})})}},{key:"getPickingInfo",value:function(t){var e=t.info;return this.state.cpuAggregator.getPickingInfo({info:e})}},{key:"_onGetSublayerColor",value:function(t){return this.state.cpuAggregator.getAccessor("fillColor")(t)}},{key:"_onGetSublayerElevation",value:function(t){return this.state.cpuAggregator.getAccessor("elevation")(t)}},{key:"_getSublayerUpdateTriggers",value:function(){return this.state.cpuAggregator.getUpdateTriggers(this.props)}},{key:"renderLayers",value:function(){var t=this.props,e=t.elevationScale,n=t.extruded,r=t.cellSize,i=t.coverage,o=t.material,a=t.transitions,s=this.state.cpuAggregator,u=this.getSubLayerClass("grid-cell",xe.a),c=this._getSublayerUpdateTriggers();return new u({cellSize:r,coverage:i,material:o,elevationScale:e,extruded:n,getFillColor:this._onGetSublayerColor.bind(this),getElevation:this._onGetSublayerElevation.bind(this),transitions:a&&{getFillColor:a.getColorValue||a.getColorWeight,getElevation:a.getElevationValue||a.getElevationWeight}},this.getSubLayerProps({id:"grid-cell",updateTriggers:c}),{data:s.state.layerData.data})}}]),n}(Ct);g()(De,"layerName","CPUGridLayer"),g()(De,"defaultProps",ke);var Le=n(167),je=Math.PI/3,Fe=[0,je,2*je,3*je,4*je,5*je];function ze(t){return t[0]}function Ue(t){return t[1]}function Ne(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return Ge(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return Ge(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function Ge(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function Ve(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function He(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Ve(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Ve(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function We(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}function qe(){}var Xe={colorDomain:null,colorRange:ht,getColorValue:{type:"accessor",value:null},getColorWeight:{type:"accessor",value:1},colorAggregation:"SUM",lowerPercentile:{type:"number",value:0,min:0,max:100},upperPercentile:{type:"number",value:100,min:0,max:100},colorScaleType:"quantize",onSetColorDomain:qe,elevationDomain:null,elevationRange:[0,1e3],getElevationValue:{type:"accessor",value:null},getElevationWeight:{type:"accessor",value:1},elevationAggregation:"SUM",elevationLowerPercentile:{type:"number",value:0,min:0,max:100},elevationUpperPercentile:{type:"number",value:100,min:0,max:100},elevationScale:{type:"number",min:0,value:1},elevationScaleType:"linear",onSetElevationDomain:qe,radius:{type:"number",value:1e3,min:1},coverage:{type:"number",min:0,max:1,value:1},extruded:!1,hexagonAggregator:function(t,e){var n,r=t.data,i=t.radius,o=e.viewport,a=e.attributes,s=r.length?function(t,e){var n,r=e.attributes,i=r.positions.value,o=r.positions.getAccessor().size,a=1/0,s=1/0,u=-1/0,c=-1/0;for(n=0;n<o*t.length;n+=o){var l=i[n],h=i[n+1];Number.isFinite(l)&&Number.isFinite(h)&&(a=Math.min(l,a),u=Math.max(l,u),s=Math.min(h,s),c=Math.max(h,c))}return[a,s,u,c].every(Number.isFinite)?[(a+u)/2,(s+c)/2]:null}(r,e):null,u=function(t,e,n){var r=e.getDistanceScales(n).unitsPerMeter;return t*r[0]}(i,o,s),c=[],l=Object($t.a)(r),h=l.iterable,f=l.objectInfo,p=a.positions.value,d=a.positions.getAccessor().size,A=Ne(h);try{for(A.s();!(n=A.n()).done;){var g=n.value;f.index++;var y=f.index*d,v=[p[y],p[y+1]];Number.isFinite(v[0])&&Number.isFinite(v[1])?c.push({screenCoord:o.projectFlat(v),source:g,index:f.index}):m.a.warn("HexagonLayer: invalid position")()}}catch(t){A.e(t)}finally{A.f()}return{hexagons:function(){var t,e,n,r=0,i=0,o=1,a=1,s=ze,u=Ue;function c(t){var r,i={},o=[],a=t.length;for(r=0;r<a;++r)if(!isNaN(l=+s.call(null,c=t[r],r,t))&&!isNaN(h=+u.call(null,c,r,t))){var c,l,h,f=Math.round(h/=n),p=Math.round(l=l/e-(1&f)/2),d=h-f;if(3*Math.abs(d)>1){var A=l-p,g=p+(l<p?-1:1)/2,m=f+(h<f?-1:1),y=l-g,v=h-m;A*A+d*d>y*y+v*v&&(p=g+(1&f?1:-1)/2,f=m)}var _=p+"-"+f,b=i[_];b?b.push(c):(o.push(b=i[_]=[c]),b.x=(p+(1&f)/2)*e,b.y=f*n)}return o}function l(t){var e=0,n=0;return Fe.map((function(r){var i=Math.sin(r)*t,o=-Math.cos(r)*t,a=i-e,s=o-n;return e=i,n=o,[a,s]}))}return c.hexagon=function(e){return"m"+l(null==e?t:+e).join("l")+"z"},c.centers=function(){for(var s=[],u=Math.round(i/n),c=Math.round(r/e),l=u*n;l<a+t;l+=n,++u)for(var h=c*e+(1&u)*e/2;h<o+e/2;h+=e)s.push([h,l]);return s},c.mesh=function(){var e=l(t).slice(0,4).join("l");return c.centers().map((function(t){return"M"+t+"m"+e})).join("")},c.x=function(t){return arguments.length?(s=t,c):s},c.y=function(t){return arguments.length?(u=t,c):u},c.radius=function(r){return arguments.length?(e=2*(t=+r)*Math.sin(je),n=1.5*t,c):t},c.size=function(t){return arguments.length?(r=i=0,o=+t[0],a=+t[1],c):[o-r,a-i]},c.extent=function(t){return arguments.length?(r=+t[0][0],i=+t[0][1],o=+t[1][0],a=+t[1][1],c):[[r,i],[o,a]]},c.radius(1)}().radius(u).x((function(t){return t.screenCoord[0]})).y((function(t){return t.screenCoord[1]}))(c).map((function(t,e){return{position:o.unprojectFlat([t.x,t.y]),points:t,index:e}})),radiusCommon:u}},getPosition:{type:"accessor",value:function(t){return t.position}},material:!0,_filterData:{type:"function",value:null,optional:!0}},Ze=function(t){l()(n,t);var e=We(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"initializeState",value:function(){var t=new Ie({getAggregator:function(t){return t.hexagonAggregator},getCellSize:function(t){return t.radius}});this.state={cpuAggregator:t,aggregatorState:t.state,vertices:null},this.getAttributeManager().add({positions:{size:3,type:5130,accessor:"getPosition"}})}},{key:"updateState",value:function(t){if(u()(d()(n.prototype),"updateState",this).call(this,t),t.changeFlags.propsOrDataChanged){var e=this.state.cpuAggregator.updateState(t,{viewport:this.context.viewport,attributes:this.getAttributes()});if(this.state.aggregatorState.layerData!==e.layerData){var r=(e.layerData||{}).hexagonVertices;this.setState({vertices:r&&this.convertLatLngToMeterOffset(r)})}this.setState({aggregatorState:e})}}},{key:"convertLatLngToMeterOffset",value:function(t){var e=this.context.viewport;if(Array.isArray(t)&&6===t.length){var n=t[0],r=t[3],i=[(n[0]+r[0])/2,(n[1]+r[1])/2],o=e.projectFlat(i),a=e.getDistanceScales(i).metersPerUnit;return t.map((function(t){var n=e.projectFlat(t);return[(n[0]-o[0])*a[0],(n[1]-o[1])*a[1]]}))}return m.a.error("HexagonLayer: hexagonVertices needs to be an array of 6 points")(),null}},{key:"getPickingInfo",value:function(t){var e=t.info;return this.state.cpuAggregator.getPickingInfo({info:e})}},{key:"_onGetSublayerColor",value:function(t){return this.state.cpuAggregator.getAccessor("fillColor")(t)}},{key:"_onGetSublayerElevation",value:function(t){return this.state.cpuAggregator.getAccessor("elevation")(t)}},{key:"_getSublayerUpdateTriggers",value:function(){return this.state.cpuAggregator.getUpdateTriggers(this.props)}},{key:"renderLayers",value:function(){var t=this.props,e=t.elevationScale,n=t.extruded,r=t.coverage,i=t.material,o=t.transitions,a=this.state,s=a.aggregatorState,u=a.vertices,c=this.getSubLayerClass("hexagon-cell",Le.a),l=this._getSublayerUpdateTriggers();return new c(He(He({},u?{vertices:u,radius:1}:{radius:s.layerData.radiusCommon||1,radiusUnits:"common",angle:90}),{},{diskResolution:6,elevationScale:e,extruded:n,coverage:r,material:i,getFillColor:this._onGetSublayerColor.bind(this),getElevation:this._onGetSublayerElevation.bind(this),transitions:o&&{getFillColor:o.getColorValue||o.getColorWeight,getElevation:o.getElevationValue||o.getElevationWeight}}),this.getSubLayerProps({id:"hexagon-cell",updateTriggers:l}),{data:s.layerData.data})}}]),n}(Ct);g()(Ze,"layerName","HexagonLayer"),g()(Ze,"defaultProps",Xe);var Je,Qe=n(231),Ke=n(116),Ye={N:[0,.5],E:[.5,0],S:[0,-.5],W:[-.5,0],NE:[.5,.5],NW:[-.5,.5],SE:[.5,-.5],SW:[-.5,-.5]},$e=[Ye.W,Ye.SW,Ye.S],tn=[Ye.S,Ye.SE,Ye.E],en=[Ye.E,Ye.NE,Ye.N],nn=[Ye.NW,Ye.W,Ye.N],rn=[[-.5,1/6],[-.5,-1/6],[-1/6,-.5],[1/6,-.5]],on=[[-1/6,-.5],[1/6,-.5],[.5,-1/6],[.5,1/6]],an=[[.5,-1/6],[.5,1/6],[1/6,.5],[-1/6,.5]],sn=[[-.5,1/6],[-.5,-1/6],[1/6,.5],[-1/6,.5]],un=[Ye.W,Ye.SW,Ye.SE,Ye.E],cn=[Ye.S,Ye.SE,Ye.NE,Ye.N],ln=[Ye.NW,Ye.W,Ye.E,Ye.NE],hn=[Ye.NW,Ye.SW,Ye.S,Ye.N],fn=[[-.5,1/6],[-.5,-1/6],[.5,-1/6],[.5,1/6]],pn=[[-1/6,-.5],[1/6,-.5],[1/6,.5],[-1/6,.5]],dn=[Ye.NW,Ye.SW,Ye.SE,Ye.NE],An=[Ye.NW,Ye.SW,Ye.SE,Ye.E,Ye.N],gn=[Ye.W,Ye.SW,Ye.SE,Ye.NE,Ye.N],mn=[Ye.NW,Ye.W,Ye.S,Ye.SE,Ye.NE],yn=[Ye.NW,Ye.SW,Ye.S,Ye.E,Ye.NE],vn=[Ye.NW,Ye.W,[.5,-1/6],[.5,1/6],Ye.N],_n=[[-1/6,-.5],[1/6,-.5],Ye.E,Ye.NE,Ye.N],bn=[[-.5,1/6],[-.5,-1/6],Ye.S,Ye.SE,Ye.E],xn=[Ye.W,Ye.SW,Ye.S,[1/6,.5],[-1/6,.5]],wn=[Ye.NW,Ye.W,[-1/6,-.5],[1/6,-.5],Ye.N],En=[[-.5,1/6],[-.5,-1/6],Ye.E,Ye.NE,Ye.N],On=[Ye.S,Ye.SE,Ye.E,[1/6,.5],[-1/6,.5]],Sn=[Ye.W,Ye.SW,Ye.S,[.5,-1/6],[.5,1/6]],Tn=[Ye.W,Ye.SW,Ye.SE,Ye.E,[1/6,.5],[-1/6,.5]],Cn=[[-.5,1/6],[-.5,-1/6],Ye.S,Ye.SE,Ye.NE,Ye.N],Pn=[Ye.NW,Ye.W,[-1/6,-.5],[1/6,-.5],Ye.E,Ye.NE],Mn=[Ye.NW,Ye.SW,Ye.S,[.5,-1/6],[.5,1/6],Ye.N],In=[Ye.W,Ye.SW,Ye.S,Ye.E,Ye.NE,Ye.N],Bn=[Ye.NW,Ye.W,Ye.S,Ye.SE,Ye.E,Ye.N],Rn=[[-.5,1/6],[-.5,-1/6],[-1/6,-.5],[1/6,-.5],Ye.E,Ye.NE,Ye.N],kn=[Ye.W,Ye.SW,Ye.S,[.5,-1/6],[.5,1/6],[1/6,.5],[-1/6,.5]],Dn=[Ye.NW,Ye.W,[-1/6,-.5],[1/6,-.5],[.5,-1/6],[.5,1/6],Ye.N],Ln=[[-.5,1/6],[-.5,-1/6],Ye.S,Ye.SE,Ye.E,[1/6,.5],[-1/6,.5]],jn=[[-.5,1/6],[-.5,-1/6],[-1/6,-.5],[1/6,-.5],[.5,-1/6],[.5,1/6],[1/6,.5],[-1/6,.5]],Fn={0:[],1:[[Ye.W,Ye.S]],2:[[Ye.S,Ye.E]],3:[[Ye.W,Ye.E]],4:[[Ye.N,Ye.E]],5:{0:[[Ye.W,Ye.S],[Ye.N,Ye.E]],1:[[Ye.W,Ye.N],[Ye.S,Ye.E]]},6:[[Ye.N,Ye.S]],7:[[Ye.W,Ye.N]],8:[[Ye.W,Ye.N]],9:[[Ye.N,Ye.S]],10:{0:[[Ye.W,Ye.N],[Ye.S,Ye.E]],1:[[Ye.W,Ye.S],[Ye.N,Ye.E]]},11:[[Ye.N,Ye.E]],12:[[Ye.W,Ye.E]],13:[[Ye.S,Ye.E]],14:[[Ye.W,Ye.S]],15:[]};function zn(t){return parseInt(t,4)}var Un=(Je={},g()(Je,zn("0000"),[]),g()(Je,zn("2222"),[]),g()(Je,zn("2221"),[$e]),g()(Je,zn("2212"),[tn]),g()(Je,zn("2122"),[en]),g()(Je,zn("1222"),[nn]),g()(Je,zn("0001"),[$e]),g()(Je,zn("0010"),[tn]),g()(Je,zn("0100"),[en]),g()(Je,zn("1000"),[nn]),g()(Je,zn("2220"),[rn]),g()(Je,zn("2202"),[on]),g()(Je,zn("2022"),[an]),g()(Je,zn("0222"),[sn]),g()(Je,zn("0002"),[rn]),g()(Je,zn("0020"),[on]),g()(Je,zn("0200"),[an]),g()(Je,zn("2000"),[sn]),g()(Je,zn("0011"),[un]),g()(Je,zn("0110"),[cn]),g()(Je,zn("1100"),[ln]),g()(Je,zn("1001"),[hn]),g()(Je,zn("2211"),[un]),g()(Je,zn("2112"),[cn]),g()(Je,zn("1122"),[ln]),g()(Je,zn("1221"),[hn]),g()(Je,zn("2200"),[fn]),g()(Je,zn("2002"),[pn]),g()(Je,zn("0022"),[fn]),g()(Je,zn("0220"),[pn]),g()(Je,zn("1111"),[dn]),g()(Je,zn("1211"),[An]),g()(Je,zn("2111"),[gn]),g()(Je,zn("1112"),[mn]),g()(Je,zn("1121"),[yn]),g()(Je,zn("1011"),[An]),g()(Je,zn("0111"),[gn]),g()(Je,zn("1110"),[mn]),g()(Je,zn("1101"),[yn]),g()(Je,zn("1200"),[vn]),g()(Je,zn("0120"),[_n]),g()(Je,zn("0012"),[bn]),g()(Je,zn("2001"),[xn]),g()(Je,zn("1022"),[vn]),g()(Je,zn("2102"),[_n]),g()(Je,zn("2210"),[bn]),g()(Je,zn("0221"),[xn]),g()(Je,zn("1002"),[wn]),g()(Je,zn("2100"),[En]),g()(Je,zn("0210"),[On]),g()(Je,zn("0021"),[Sn]),g()(Je,zn("1220"),[wn]),g()(Je,zn("0122"),[En]),g()(Je,zn("2012"),[On]),g()(Je,zn("2201"),[Sn]),g()(Je,zn("0211"),[Tn]),g()(Je,zn("2110"),[Cn]),g()(Je,zn("1102"),[Pn]),g()(Je,zn("1021"),[Mn]),g()(Je,zn("2011"),[Tn]),g()(Je,zn("0112"),[Cn]),g()(Je,zn("1120"),[Pn]),g()(Je,zn("1201"),[Mn]),g()(Je,zn("2101"),[In]),g()(Je,zn("0121"),[In]),g()(Je,zn("1012"),[Bn]),g()(Je,zn("1210"),[Bn]),g()(Je,zn("0101"),{0:[$e,en],1:[In],2:[In]}),g()(Je,zn("1010"),{0:[nn,tn],1:[Bn],2:[Bn]}),g()(Je,zn("2121"),{0:[In],1:[In],2:[$e,en]}),g()(Je,zn("1212"),{0:[Bn],1:[Bn],2:[nn,tn]}),g()(Je,zn("2120"),{0:[Rn],1:[Rn],2:[rn,en]}),g()(Je,zn("2021"),{0:[kn],1:[kn],2:[$e,an]}),g()(Je,zn("1202"),{0:[Dn],1:[Dn],2:[nn,on]}),g()(Je,zn("0212"),{0:[Ln],1:[Ln],2:[tn,sn]}),g()(Je,zn("0102"),{0:[rn,en],1:[Rn],2:[Rn]}),g()(Je,zn("0201"),{0:[$e,an],1:[kn],2:[kn]}),g()(Je,zn("1020"),{0:[nn,on],1:[Dn],2:[Dn]}),g()(Je,zn("2010"),{0:[tn,sn],1:[Ln],2:[Ln]}),g()(Je,zn("2020"),{0:[sn,on],1:[jn],2:[rn,an]}),g()(Je,zn("0202"),{0:[an,rn],1:[jn],2:[sn,on]}),Je);function Nn(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function Gn(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Nn(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Nn(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var Vn=1,Hn=2,Wn={zIndex:0,zOffset:.005};function qn(t,e){return Array.isArray(e)?t<e[0]?0:t<e[1]?1:2:t>=e?1:0}function Xn(t){var e=t.cellWeights,n=t.x,r=t.y,i=t.width,o=t.height,a=t.threshold;t.thresholdValue&&(m.a.deprecated("thresholdValue","threshold")(),a=t.thresholdValue);var s=n<0,u=n>=i-1,c=r<0,l=r>=o-1,h=s||u||c||l,f={},p={};s||l?p.top=0:(f.top=e[(r+1)*i+n],p.top=qn(f.top,a)),u||l?p.topRight=0:(f.topRight=e[(r+1)*i+n+1],p.topRight=qn(f.topRight,a)),u||c?p.right=0:(f.right=e[r*i+n+1],p.right=qn(f.right,a)),s||c?p.current=0:(f.current=e[r*i+n],p.current=qn(f.current,a));var d=p.top,A=p.topRight,g=p.right,y=p.current,v=-1;Number.isFinite(a)&&(v=d<<3|A<<2|g<<1|y),Array.isArray(a)&&(v=d<<6|A<<4|g<<2|y);var _=0;return h||(_=qn((f.top+f.topRight+f.right+f.current)/4,a)),{code:v,meanCode:_}}function Zn(t){var e=t.gridOrigin,n=t.cellSize,r=t.x,i=t.y,o=t.code,a=t.meanCode,s=t.type,u=void 0===s?Vn:s,c=Gn(Gn({},Wn),t.thresholdData),l=u===Hn?Un[o]:Fn[o];Array.isArray(l)||(l=l[a]);var h=c.zIndex*c.zOffset,f=(r+1)*n[0],p=(i+1)*n[1],d=e[0]+f,A=e[1]+p;if(u===Hn){var g=[];return l.forEach((function(t){var e=[];t.forEach((function(t){var r=d+t[0]*n[0],i=A+t[1]*n[1];e.push([r,i,h])})),g.push(e)})),g}var m=[];return l.forEach((function(t){t.forEach((function(t){var e=d+t[0]*n[0],r=A+t[1]*n[1];m.push([e,r,h])}))})),m}function Jn(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return Qn(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return Qn(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function Qn(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function Kn(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}var Yn=[255,255,255,255],$n={cellSize:{type:"number",min:1,max:1e3,value:1e3},getPosition:{type:"accessor",value:function(t){return t.position}},getWeight:{type:"accessor",value:1},gpuAggregation:!0,aggregation:"SUM",contours:[{threshold:1}],zOffset:.005},tr={data:{props:["cellSize"]},weights:{props:["aggregation"],accessors:["getWeight"]}},er=function(t){l()(n,t);var e=Kn(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"initializeState",value:function(){var t;u()(d()(n.prototype),"initializeAggregationLayer",this).call(this,{dimensions:tr}),this.setState({contourData:{},projectPoints:!1,weights:{count:{size:1,operation:R.SUM}}}),this.getAttributeManager().add((t={},g()(t,"positions",{size:3,accessor:"getPosition",type:5130,fp64:this.use64bitPositions()}),g()(t,"count",{size:3,accessor:"getWeight"}),t))}},{key:"updateState",value:function(t){u()(d()(n.prototype),"updateState",this).call(this,t);var e=!1,r=t.oldProps,i=t.props,o=this.state.aggregationDirty;r.contours===i.contours&&r.zOffset===i.zOffset||(e=!0,this._updateThresholdData(t.props)),this.getNumInstances()>0&&(o||e)&&this._generateContours()}},{key:"renderLayers",value:function(){var t=this.state.contourData,e=t.contourSegments,n=t.contourPolygons,r=this.getSubLayerClass("lines",Qe.a),i=this.getSubLayerClass("bands",Ke.a);return[e&&e.length>0&&new r(this.getSubLayerProps({id:"lines"}),{data:this.state.contourData.contourSegments,getSourcePosition:function(t){return t.start},getTargetPosition:function(t){return t.end},getColor:function(t){return t.contour.color||Yn},getWidth:function(t){return t.contour.strokeWidth||1}}),n&&n.length>0&&new i(this.getSubLayerProps({id:"bands"}),{data:this.state.contourData.contourPolygons,getPolygon:function(t){return t.vertices},getFillColor:function(t){return t.contour.color||Yn}})]}},{key:"updateAggregationState",value:function(t){var e=t.props,n=t.oldProps,r=e.cellSize,i=e.coordinateSystem,o=this.context.viewport,a=n.cellSize!==r,s=e.gpuAggregation;this.state.gpuAggregation!==e.gpuAggregation&&s&&!ot.isSupported(this.context.gl)&&(m.a.warn("GPU Grid Aggregation not supported, falling back to CPU")(),s=!1);var u=s!==this.state.gpuAggregation;this.setState({gpuAggregation:s});var c=this.state.dimensions,l=this.isAttributeChanged("positions"),h=c.data,f=c.weights,p=this.state.boundingBox;if(l&&(p=ne(this.getAttributes(),this.getNumInstances()),this.setState({boundingBox:p})),l||a){var d=oe(p,r,o,i),A=d.gridOffset,g=d.translation,y=d.width,v=d.height,_=d.numCol,b=d.numRow;this.allocateResources(b,_),this.setState({gridOffset:A,boundingBox:p,translation:g,posOffset:g.slice(),gridOrigin:[-1*g[0],-1*g[1]],width:y,height:v,numCol:_,numRow:b})}var x=l||u||this.isAggregationDirty(t,{dimension:h,compareAll:s}),w=this.isAggregationDirty(t,{dimension:f});w&&this._updateAccessors(t),(x||w)&&this._resetResults(),this.setState({aggregationDataDirty:x,aggregationWeightsDirty:w})}},{key:"_updateAccessors",value:function(t){var e=t.props,n=e.getWeight,r=e.aggregation,i=e.data,o=this.state.weights.count;o&&(o.getWeight=n,o.operation=R[r]),this.setState({getValue:j(r,n,{data:i})})}},{key:"_resetResults",value:function(){var t=this.state.weights.count;t&&(t.aggregationData=null)}},{key:"_generateContours",value:function(){var t=this.state,e=t.numCol,n=t.numRow,r=t.gridOrigin,i=t.gridOffset,o=t.thresholdData,a=this.state.weights.count,s=a.aggregationData;s||(s=a.aggregationBuffer.getData(),a.aggregationData=s);var u=function(t){var e,n=t.thresholdData,r=t.cellWeights,i=t.gridSize,o=t.gridOrigin,a=t.cellSize,s=[],u=[],c=i[0],l=i[1],h=0,f=0,p=Jn(n);try{for(p.s();!(e=p.n()).done;)for(var d=e.value,A=d.contour,g=A.threshold,m=-1;m<c;m++)for(var y=-1;y<l;y++){var v=Xn({cellWeights:r,threshold:g,x:m,y:y,width:c,height:l}),_=v.code,b=v.meanCode,x={type:Hn,gridOrigin:o,cellSize:a,x:m,y:y,width:c,height:l,code:_,meanCode:b,thresholdData:d};if(Array.isArray(g)){x.type=Hn;var w,E=Jn(Zn(x));try{for(E.s();!(w=E.n()).done;){var O=w.value;u[f++]={vertices:O,contour:A}}}catch(t){E.e(t)}finally{E.f()}}else{x.type=Vn;for(var S=Zn(x),T=0;T<S.length;T+=2)s[h++]={start:S[T],end:S[T+1],contour:A}}}}catch(t){p.e(t)}finally{p.f()}return{contourSegments:s,contourPolygons:u}}({thresholdData:o,cellWeights:ot.getCellData({countsData:s}).cellWeights,gridSize:[e,n],gridOrigin:r,cellSize:[i.xOffset,i.yOffset]});this.setState({contourData:u})}},{key:"_updateThresholdData",value:function(t){for(var e=t.contours,n=t.zOffset,r=e.length,i=new Array(r),o=0;o<r;o++){var a=e[o];i[o]={contour:a,zIndex:a.zIndex||o,zOffset:n}}this.setState({thresholdData:i})}}]),n}(Ae);g()(er,"layerName","ContourLayer"),g()(er,"defaultProps",$n);var nr=n(235),rr=n(35),ir=n(297);function or(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function ar(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?or(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):or(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function sr(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}var ur={colorDomain:null,colorRange:ht,elevationDomain:null,elevationRange:[0,1e3],elevationScale:{type:"number",min:0,value:1},gridSize:{type:"array",value:[1,1]},gridOrigin:{type:"array",value:[0,0]},gridOffset:{type:"array",value:[0,0]},cellSize:{type:"number",min:0,max:1e3,value:1e3},offset:{type:"array",value:[1,1]},coverage:{type:"number",min:0,max:1,value:1},extruded:!0,material:!0},cr=function(t){l()(n,t);var e=sr(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(){return u()(d()(n.prototype),"getShaders",this).call(this,{vs:"#version 300 es\n#define SHADER_NAME gpu-grid-cell-layer-vertex-shader\n#define RANGE_COUNT 6\n\nin vec3 positions;\nin vec3 normals;\n\nin vec4 colors;\nin vec4 elevations;\nin vec3 instancePickingColors;\n\n// Custom uniforms\nuniform vec2 offset;\nuniform bool extruded;\nuniform float cellSize;\nuniform float coverage;\nuniform float opacity;\nuniform float elevationScale;\n\nuniform ivec2 gridSize;\nuniform vec2 gridOrigin;\nuniform vec2 gridOriginLow;\nuniform vec2 gridOffset;\nuniform vec2 gridOffsetLow;\nuniform vec4 colorRange[RANGE_COUNT];\nuniform vec2 elevationRange;\n\n// Domain uniforms\nuniform vec2 colorDomain;\nuniform bool colorDomainValid;\nuniform vec2 elevationDomain;\nuniform bool elevationDomainValid;\n\nlayout(std140) uniform;\nuniform ColorData\n{\n  vec4 maxMinCount;\n} colorData;\nuniform ElevationData\n{\n  vec4 maxMinCount;\n} elevationData;\n\n#define EPSILON 0.00001\n\n// Result\nout vec4 vColor;\n\nvec4 quantizeScale(vec2 domain, vec4 range[RANGE_COUNT], float value) {\n  vec4 outColor = vec4(0., 0., 0., 0.);\n  if (value >= (domain.x - EPSILON) && value <= (domain.y + EPSILON)) {\n    float domainRange = domain.y - domain.x;\n    if (domainRange <= 0.) {\n      outColor = colorRange[0];\n    } else {\n      float rangeCount = float(RANGE_COUNT);\n      float rangeStep = domainRange / rangeCount;\n      float idx = floor((value - domain.x) / rangeStep);\n      idx = clamp(idx, 0., rangeCount - 1.);\n      int intIdx = int(idx);\n      outColor = colorRange[intIdx];\n    }\n  }\n  return outColor;\n}\n\nfloat linearScale(vec2 domain, vec2 range, float value) {\n  if (value >= (domain.x - EPSILON) && value <= (domain.y + EPSILON)) {\n    return ((value - domain.x) / (domain.y - domain.x)) * (range.y - range.x) + range.x;\n  }\n  return -1.;\n}\n\nvoid main(void) {\n  vec2 clrDomain = colorDomainValid ? colorDomain : vec2(colorData.maxMinCount.a, colorData.maxMinCount.r);\n  vec4 color = quantizeScale(clrDomain, colorRange, colors.r);\n\n  float elevation = 0.0;\n\n  if (extruded) {\n    vec2 elvDomain = elevationDomainValid ? elevationDomain : vec2(elevationData.maxMinCount.a, elevationData.maxMinCount.r);\n    elevation = linearScale(elvDomain, elevationRange, elevations.r);\n    elevation = elevation  * (positions.z + 1.0) / 2.0 * elevationScale;\n  }\n\n  // if aggregated color or elevation is 0 do not render\n  float shouldRender = float(color.r > 0.0 && elevations.r >= 0.0);\n  float dotRadius = cellSize / 2. * coverage * shouldRender;\n\n  int yIndex = (gl_InstanceID / gridSize[0]);\n  int xIndex = gl_InstanceID - (yIndex * gridSize[0]);\n\n  vec2 instancePositionXFP64 = mul_fp64(vec2(gridOffset[0], gridOffsetLow[0]), vec2(float(xIndex), 0.));\n  instancePositionXFP64 = sum_fp64(instancePositionXFP64, vec2(gridOrigin[0], gridOriginLow[0]));\n  vec2 instancePositionYFP64 = mul_fp64(vec2(gridOffset[1], gridOffsetLow[1]), vec2(float(yIndex), 0.));\n  instancePositionYFP64 = sum_fp64(instancePositionYFP64, vec2(gridOrigin[1], gridOriginLow[1]));\n\n  vec3 centroidPosition = vec3(instancePositionXFP64[0], instancePositionYFP64[0], elevation);\n  vec3 centroidPosition64Low = vec3(instancePositionXFP64[1], instancePositionYFP64[1], 0.0);\n  geometry.worldPosition = centroidPosition;\n  vec3 pos = vec3(project_size(positions.xy + offset) * dotRadius, 0.);\n\n  // Set color to be rendered to picking fbo (also used to check for selection highlight).\n  picking_setPickingColor(instancePickingColors);\n\n  gl_Position = project_position_to_clipspace(centroidPosition, centroidPosition64Low, pos, geometry.position);\n\n  // Light calculations\n  // Worldspace is the linear space after Mercator projection\n\n  vec3 normals_commonspace = project_normal(normals);\n\n   if (extruded) {\n    vec3 lightColor = lighting_getLightColor(color.rgb, project_uCameraPosition, geometry.position.xyz, normals_commonspace);\n    vColor = vec4(lightColor, color.a * opacity) / 255.;\n  } else {\n    vColor = vec4(color.rgb, color.a * opacity) / 255.;\n  }\n}\n",fs:"#version 300 es\n#define SHADER_NAME gpu-grid-cell-layer-fragment-shader\n\nprecision highp float;\n\nin vec4 vColor;\n\nout vec4 fragColor;\n\nvoid main(void) {\n  fragColor = vColor;\n  fragColor = picking_filterColor(fragColor);\n}\n",modules:[B.a,nr.a,ct.a,C]})}},{key:"initializeState",value:function(t){var e=t.gl;this.getAttributeManager().addInstanced({colors:{size:4,noAlloc:!0},elevations:{size:4,noAlloc:!0}});var n=this._getModel(e);this._setupUniformBuffer(n),this.setState({model:n})}},{key:"_getModel",value:function(t){return new x.a(t,ar(ar({},this.getShaders()),{},{id:this.props.id,geometry:new ir.a,isInstanced:!0}))}},{key:"draw",value:function(t){var e=t.uniforms,n=this.props,r=n.cellSize,i=n.offset,o=n.extruded,a=n.elevationScale,s=n.coverage,u=n.gridSize,c=n.gridOrigin,l=n.gridOffset,h=n.elevationRange,f=n.colorMaxMinBuffer,p=n.elevationMaxMinBuffer,d=[Object(rr.b)(c[0]),Object(rr.b)(c[1])],A=[Object(rr.b)(l[0]),Object(rr.b)(l[1])],g=this.getDomainUniforms(),m=ft(this.props.colorRange);this.bindUniformBuffers(f,p),this.state.model.setUniforms(e).setUniforms(g).setUniforms({cellSize:r,offset:i,extruded:o,elevationScale:a,coverage:s,gridSize:u,gridOrigin:c,gridOriginLow:d,gridOffset:l,gridOffsetLow:A,colorRange:m,elevationRange:h}).draw(),this.unbindUniformBuffers(f,p)}},{key:"bindUniformBuffers",value:function(t,e){t.bind({target:35345,index:0}),e.bind({target:35345,index:1})}},{key:"unbindUniformBuffers",value:function(t,e){t.unbind({target:35345,index:0}),e.unbind({target:35345,index:1})}},{key:"getDomainUniforms",value:function(){var t=this.props,e=t.colorDomain,n=t.elevationDomain,r={};return null!==e?(r.colorDomainValid=!0,r.colorDomain=e):r.colorDomainValid=!1,null!==n?(r.elevationDomainValid=!0,r.elevationDomain=n):r.elevationDomainValid=!1,r}},{key:"_setupUniformBuffer",value:function(t){var e=this.context.gl,n=t.program.handle,r=e.getUniformBlockIndex(n,"ColorData"),i=e.getUniformBlockIndex(n,"ElevationData");e.uniformBlockBinding(n,r,0),e.uniformBlockBinding(n,i,1)}}]),n}(lt.a);function lr(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function hr(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?lr(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):lr(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function fr(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}g()(cr,"layerName","GPUGridCellLayer"),g()(cr,"defaultProps",ur);var pr={colorDomain:null,colorRange:ht,getColorWeight:{type:"accessor",value:1},colorAggregation:"SUM",elevationDomain:null,elevationRange:[0,1e3],getElevationWeight:{type:"accessor",value:1},elevationAggregation:"SUM",elevationScale:{type:"number",min:0,value:1},cellSize:{type:"number",min:1,max:1e3,value:1e3},coverage:{type:"number",min:0,max:1,value:1},getPosition:{type:"accessor",value:function(t){return t.position}},extruded:!1,material:!0},dr={data:{props:["cellSize","colorAggregation","elevationAggregation"]}},Ar=function(t){l()(n,t);var e=fr(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"initializeState",value:function(t){var e,r=t.gl,i=ot.isSupported(r);i||m.a.error("GPUGridLayer is not supported on this browser, use GridLayer instead")(),u()(d()(n.prototype),"initializeAggregationLayer",this).call(this,{dimensions:dr}),this.setState({gpuAggregation:!0,projectPoints:!1,isSupported:i,weights:{color:{needMin:!0,needMax:!0,combineMaxMin:!0,maxMinBuffer:new Pt.a(r,{byteLength:16,accessor:{size:4,type:5126,divisor:1}})},elevation:{needMin:!0,needMax:!0,combineMaxMin:!0,maxMinBuffer:new Pt.a(r,{byteLength:16,accessor:{size:4,type:5126,divisor:1}})}},positionAttributeName:"positions"}),this.getAttributeManager().add((e={},g()(e,"positions",{size:3,accessor:"getPosition",type:5130,fp64:this.use64bitPositions()}),g()(e,"color",{size:3,accessor:"getColorWeight"}),g()(e,"elevation",{size:3,accessor:"getElevationWeight"}),e))}},{key:"updateState",value:function(t){!1!==this.state.isSupported&&(u()(d()(n.prototype),"updateState",this).call(this,t),this.state.aggregationDirty&&this.setState({gridHash:null}))}},{key:"getHashKeyForIndex",value:function(t){var e=this.state,n=e.numRow,r=e.numCol,i=e.boundingBox,o=e.gridOffset,a=[r,n],s=[i.xMin,i.yMin],u=[o.xOffset,o.yOffset],c=Math.floor(t/a[0]),l=t-c*a[0],h=Math.floor((c*u[1]+s[1]+90+u[1]/2)/u[1]),f=Math.floor((l*u[0]+s[0]+180+u[0]/2)/u[0]);return"".concat(h,"-").concat(f)}},{key:"getPositionForIndex",value:function(t){var e=this.state,n=e.numRow,r=e.numCol,i=e.boundingBox,o=e.gridOffset,a=[r,n],s=[i.xMin,i.yMin],u=[o.xOffset,o.yOffset],c=Math.floor(t/a[0]);return[(t-c*a[0])*u[0]+s[0],c*u[1]+s[1]]}},{key:"getPickingInfo",value:function(t){var e=t.info,n=t.mode,r=e.index,i=null;if(r>=0){var o=this.state.gpuGridAggregator,a=this.getPositionForIndex(r),s=ot.getAggregationData(hr({pixelIndex:r},o.getData("color"))),u=ot.getAggregationData(hr({pixelIndex:r},o.getData("elevation")));if(i={colorValue:s.cellWeight,elevationValue:u.cellWeight,count:s.cellCount||u.cellCount,position:a,totalCount:s.totalCount||u.totalCount},"hover"!==n){var c=this.props,l=this.state.gridHash;if(!l){var h=this.state,f=h.gridOffset,p=h.translation,d=h.boundingBox,A=this.context.viewport;l=he(c,{gridOffset:f,attributes:this.getAttributes(),viewport:A,translation:p,boundingBox:d}).gridHash,this.setState({gridHash:l})}var g=l[this.getHashKeyForIndex(r)];Object.assign(i,g)}}return e.picked=Boolean(i),e.object=i,e}},{key:"renderLayers",value:function(){if(!this.state.isSupported)return null;var t=this.props,e=t.elevationScale,n=t.extruded,r=t.cellSize,i=t.coverage,o=t.material,a=t.elevationRange,s=t.colorDomain,u=t.elevationDomain,c=this.state,l=c.weights,h=c.numRow,f=c.numCol,p=c.gridOrigin,d=c.gridOffset,A=l.color,g=l.elevation,m=ft(this.props.colorRange);return new(this.getSubLayerClass("gpu-grid-cell",cr))({gridSize:[f,h],gridOrigin:p,gridOffset:[d.xOffset,d.yOffset],colorRange:m,elevationRange:a,colorDomain:s,elevationDomain:u,cellSize:r,coverage:i,material:o,elevationScale:e,extruded:n},this.getSubLayerProps({id:"gpu-grid-cell"}),{data:{attributes:{colors:A.aggregationBuffer,elevations:g.aggregationBuffer}},colorMaxMinBuffer:A.maxMinBuffer,elevationMaxMinBuffer:g.maxMinBuffer,numInstances:f*h})}},{key:"finalizeState",value:function(t){var e=this.state.weights;[e.color,e.elevation].forEach((function(t){var e=t.aggregationBuffer;t.maxMinBuffer.delete(),null==e||e.delete()})),u()(d()(n.prototype),"finalizeState",this).call(this,t)}},{key:"updateAggregationState",value:function(t){var e=t.props,n=t.oldProps,r=e.cellSize,i=e.coordinateSystem,o=this.context.viewport,a=n.cellSize!==r,s=this.state.dimensions,u=this.isAttributeChanged("positions"),c=u||this.isAttributeChanged(),l=this.state.boundingBox;if(u&&(l=ne(this.getAttributes(),this.getNumInstances()),this.setState({boundingBox:l})),u||a){var h=oe(l,r,o,i),f=h.gridOffset,p=h.translation,d=h.width,A=h.height,g=h.numCol,m=h.numRow;this.allocateResources(m,g),this.setState({gridOffset:f,translation:p,gridOrigin:[-1*p[0],-1*p[1]],width:d,height:A,numCol:g,numRow:m})}var y=c||this.isAggregationDirty(t,{dimension:s.data,compareAll:!0});y&&this._updateAccessors(t),this.setState({aggregationDataDirty:y})}},{key:"_updateAccessors",value:function(t){var e=t.props,n=e.colorAggregation,r=e.elevationAggregation,i=this.state.weights,o=i.color,a=i.elevation;o.operation=R[n],a.operation=R[r]}}]),n}(Ae);function gr(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}function mr(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function yr(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?mr(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):mr(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}g()(Ar,"layerName","GPUGridLayer"),g()(Ar,"defaultProps",pr);var vr=yr(yr(yr({},Ar.defaultProps),De.defaultProps),{},{gpuAggregation:!1}),_r=function(t){l()(n,t);var e=gr(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"initializeState",value:function(){this.state={useGPUAggregation:!0}}},{key:"updateState",value:function(t){var e=t.props;this.setState({useGPUAggregation:this.canUseGPUAggregation(e)})}},{key:"renderLayers",value:function(){var t=this.props,e=t.data,n=t.updateTriggers,r=this.state.useGPUAggregation?"GPU":"CPU";return new(this.state.useGPUAggregation?this.getSubLayerClass("GPU",Ar):this.getSubLayerClass("CPU",De))(this.props,this.getSubLayerProps({id:r,updateTriggers:n}),{data:e})}},{key:"canUseGPUAggregation",value:function(t){var e=t.gpuAggregation,n=t.lowerPercentile,r=t.upperPercentile,i=t.getColorValue,o=t.getElevationValue,a=t.colorScaleType;return!!e&&(!!ot.isSupported(this.context.gl)&&(0===n&&100===r&&(null===i&&null===o&&("quantile"!==a&&"ordinal"!==a))))}}]),n}(wt.a);function br(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,e){if(!t)return;if("string"==typeof t)return xr(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return xr(t,e)}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var r=0,i=function(){};return{s:i,n:function(){return r>=t.length?{done:!0}:{done:!1,value:t[r++]}},e:function(t){throw t},f:i}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var o,a=!0,s=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return a=t.done,t},e:function(t){s=!0,o=t},f:function(){try{a||null==n.return||n.return()}finally{if(s)throw o}}}}function xr(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,r=new Array(e);n<e;n++)r[n]=t[n];return r}function wr(t){var e=t.map((function(t){return t[0]})),n=t.map((function(t){return t[1]})),r=Math.min.apply(null,e),i=Math.max.apply(null,e);return[r,Math.min.apply(null,n),i,Math.max.apply(null,n)]}function Er(t,e){return e[0]>=t[0]&&e[2]<=t[2]&&e[1]>=t[1]&&e[3]<=t[3]}g()(_r,"layerName","GridLayer"),g()(_r,"defaultProps",vr);var Or=new Float32Array(12);function Sr(t){var e,n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:2,r=0,i=br(t);try{for(i.s();!(e=i.n()).done;)for(var o=e.value,a=0;a<n;a++)Or[r++]=o[a]||0}catch(t){i.e(t)}finally{i.f()}return Or}function Tr(t,e,n){var r=It()(t,4),i=r[0],o=r[1],a=r[2],s=r[3],u=a-i,c=s-o,l=u,h=c;u/c<e/n?l=e/n*c:h=n/e*u,l<e&&(l=e,h=n);var f=(a+i)/2,p=(s+o)/2;return[f-l/2,p-h/2,f+l/2,p+h/2]}function Cr(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function Pr(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Cr(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Cr(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function Mr(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}var Ir=function(t){l()(n,t);var e=Mr(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"getShaders",value:function(){return{vs:"#define SHADER_NAME heatp-map-layer-vertex-shader\n\nuniform sampler2D maxTexture;\nuniform float intensity;\nuniform vec2 colorDomain;\nuniform float threshold;\nuniform float aggregationMode;\n\nattribute vec3 positions;\nattribute vec2 texCoords;\n\nvarying vec2 vTexCoords;\nvarying float vIntensityMin;\nvarying float vIntensityMax;\n\nvoid main(void) {\n  gl_Position = project_position_to_clipspace(positions, vec3(0.0), vec3(0.0));\n  vTexCoords = texCoords;\n  vec4 maxTexture = texture2D(maxTexture, vec2(0.5));\n  float maxValue = aggregationMode < 0.5 ? maxTexture.r : maxTexture.g;\n  float minValue = maxValue * threshold;\n  if (colorDomain[1] > 0.) {\n    // if user specified custom domain use it.\n    maxValue = colorDomain[1];\n    minValue = colorDomain[0];\n  }\n  vIntensityMax = intensity / maxValue;\n  vIntensityMin = intensity / minValue;\n}\n",fs:"#define SHADER_NAME triangle-layer-fragment-shader\n\nprecision highp float;\n\nuniform float opacity;\nuniform sampler2D texture;\nuniform sampler2D colorTexture;\nuniform float aggregationMode;\n\nvarying vec2 vTexCoords;\nvarying float vIntensityMin;\nvarying float vIntensityMax;\n\nvec4 getLinearColor(float value) {\n  float factor = clamp(value * vIntensityMax, 0., 1.);\n  vec4 color = texture2D(colorTexture, vec2(factor, 0.5));\n  color.a *= min(value * vIntensityMin, 1.0);\n  return color;\n}\n\nvoid main(void) {\n  vec4 weights = texture2D(texture, vTexCoords);\n  float weight = weights.r;\n\n  if (aggregationMode > 0.5) {\n    weight /= max(1.0, weights.a);\n  }\n\n  // discard pixels with 0 weight.\n  if (weight <= 0.) {\n     discard;\n  }\n\n  vec4 linearColor = getLinearColor(weight);\n  linearColor.a *= opacity;\n  gl_FragColor =linearColor;\n}\n",modules:[B.a]}}},{key:"initializeState",value:function(t){var e=t.gl;this.getAttributeManager().add({positions:{size:3,noAlloc:!0},texCoords:{size:2,noAlloc:!0}}),this.setState({model:this._getModel(e)})}},{key:"_getModel",value:function(t){var e=this.props.vertexCount;return new x.a(t,Pr(Pr({},this.getShaders()),{},{id:this.props.id,geometry:new ut.a({drawMode:6,vertexCount:e})}))}},{key:"draw",value:function(t){var e=t.uniforms,n=this.state.model,r=this.props,i=r.texture,o=r.maxTexture,a=r.colorTexture,s=r.intensity,u=r.threshold,c=r.aggregationMode,l=r.colorDomain;n.setUniforms(Pr(Pr({},e),{},{texture:i,maxTexture:o,colorTexture:a,intensity:s,threshold:u,aggregationMode:c,colorDomain:l})).draw()}}]),n}(lt.a);g()(Ir,"layerName","TriangleLayer");var Br;function Rr(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function kr(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?Rr(Object(n),!0).forEach((function(e){g()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):Rr(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function Dr(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=d()(t);if(e){var i=d()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return f()(this,n)}}var Lr={mipmaps:!1,parameters:(Br={},g()(Br,10240,9729),g()(Br,10241,9729),g()(Br,10242,33071),g()(Br,10243,33071),Br),dataFormat:6408},jr=[0,0],Fr={SUM:0,MEAN:1},zr={getPosition:{type:"accessor",value:function(t){return t.position}},getWeight:{type:"accessor",value:1},intensity:{type:"number",min:0,value:1},radiusPixels:{type:"number",min:1,max:100,value:50},colorRange:ht,threshold:{type:"number",min:0,max:1,value:.05},colorDomain:{type:"array",value:null,optional:!0},aggregation:"SUM",weightsTextureSize:{type:"number",min:128,max:2048,value:2048},debounceTimeout:{type:"number",min:0,max:1e3,value:500}},Ur=[y.a.BLEND_EQUATION_MINMAX,y.a.TEXTURE_FLOAT],Nr=[y.a.COLOR_ATTACHMENT_RGBA32F,y.a.FLOAT_BLEND],Gr={data:{props:["radiusPixels"]}},Vr=function(t){l()(n,t);var e=Dr(n);function n(){return i()(this,n),e.apply(this,arguments)}return a()(n,[{key:"initializeState",value:function(){var t=this.context.gl;if(!Object(_.c)(t,Ur))return this.setState({supported:!1}),void m.a.error("HeatmapLayer: ".concat(this.id," is not supported on this browser"))();u()(d()(n.prototype),"initializeAggregationLayer",this).call(this,Gr),this.setState({supported:!0,colorDomain:jr}),this._setupTextureParams(),this._setupAttributes(),this._setupResources()}},{key:"shouldUpdateState",value:function(t){return t.changeFlags.somethingChanged}},{key:"updateState",value:function(t){this.state.supported&&(u()(d()(n.prototype),"updateState",this).call(this,t),this._updateHeatmapState(t))}},{key:"_updateHeatmapState",value:function(t){var e=t.props,n=t.oldProps,r=this._getChangeFlags(t);(r.dataChanged||r.viewportChanged)&&(r.boundsChanged=this._updateBounds(r.dataChanged),this._updateTextureRenderingBounds()),r.dataChanged||r.boundsChanged?(clearTimeout(this.state.updateTimer),this.setState({isWeightMapDirty:!0})):r.viewportZoomChanged&&this._debouncedUpdateWeightmap(),e.colorRange!==n.colorRange&&this._updateColorTexture(t),this.state.isWeightMapDirty&&this._updateWeightmap(),this.setState({zoom:t.context.viewport.zoom})}},{key:"renderLayers",value:function(){if(!this.state.supported)return[];var t=this.state,e=t.weightsTexture,n=t.triPositionBuffer,r=t.triTexCoordBuffer,i=t.maxWeightsTexture,o=t.colorTexture,a=t.colorDomain,s=this.props,u=s.updateTriggers,c=s.intensity,l=s.threshold,h=s.aggregation;return new(this.getSubLayerClass("triangle",Ir))(this.getSubLayerProps({id:"triangle-layer",updateTriggers:u}),{coordinateSystem:te.a.DEFAULT,data:{attributes:{positions:n,texCoords:r}},vertexCount:4,maxTexture:i,colorTexture:o,aggregationMode:Fr[h]||0,texture:e,intensity:c,threshold:l,colorDomain:a})}},{key:"finalizeState",value:function(t){u()(d()(n.prototype),"finalizeState",this).call(this,t);var e=this.state,r=e.weightsTransform,i=e.weightsTexture,o=e.maxWeightTransform,a=e.maxWeightsTexture,s=e.triPositionBuffer,c=e.triTexCoordBuffer,l=e.colorTexture,h=e.updateTimer;null==r||r.delete(),null==i||i.delete(),null==o||o.delete(),null==a||a.delete(),null==s||s.delete(),null==c||c.delete(),null==l||l.delete(),h&&clearTimeout(h)}},{key:"_getAttributeManager",value:function(){return new xt.a(this.context.gl,{id:this.props.id,stats:this.context.stats})}},{key:"_getChangeFlags",value:function(t){var e={},n=this.state.dimensions;e.dataChanged=this.isAttributeChanged()||this.isAggregationDirty(t,{compareAll:!0,dimension:n.data}),e.viewportChanged=t.changeFlags.viewportChanged;var r=this.state.zoom;return t.context.viewport&&t.context.viewport.zoom===r||(e.viewportZoomChanged=!0),e}},{key:"_createTextures",value:function(){var t=this.context.gl,e=this.state,n=e.textureSize,r=e.format,i=e.type;this.setState({weightsTexture:new X.a(t,kr({width:n,height:n,format:r,type:i},Lr)),maxWeightsTexture:new X.a(t,kr({format:r,type:i},Lr))})}},{key:"_setupAttributes",value:function(){this.getAttributeManager().add({positions:{size:3,type:5130,accessor:"getPosition"},weights:{size:1,accessor:"getWeight"}}),this.setState({positionAttributeName:"positions"})}},{key:"_setupTextureParams",value:function(){var t=this.context.gl,e=this.props.weightsTextureSize,n=Math.min(e,Object(v.f)(t,3379)),r=Object(_.c)(t,Nr),i=function(t){var e=t.gl;return t.floatTargetSupport?{format:Object(v.j)(e)?34836:6408,type:5126}:{format:6408,type:5121}}({gl:t,floatTargetSupport:r}),o=i.format,a=i.type,s=r?1:1/255;this.setState({textureSize:n,format:o,type:a,weightsScale:s}),r||m.a.warn("HeatmapLayer: ".concat(this.id," rendering to float texture not supported, fallingback to low precession format"))()}},{key:"getShaders",value:function(t){return u()(d()(n.prototype),"getShaders",this).call(this,"max-weights-transform"===t?{vs:"attribute vec4 inTexture;\nvarying vec4 outTexture;\n\nvoid main()\n{\noutTexture = inTexture;\ngl_Position = vec4(0, 0, 0, 1.);\n// Enforce default value for ANGLE issue (https://bugs.chromium.org/p/angleproject/issues/detail?id=3941)\ngl_PointSize = 1.0;\n}\n",_fs:"varying vec4 outTexture;\nvoid main() {\n  gl_FragColor = outTexture;\n  gl_FragColor.g = outTexture.r / max(1.0, outTexture.a);\n}\n"}:{vs:"attribute vec3 positions;\nattribute vec3 positions64Low;\nattribute float weights;\nvarying vec4 weightsTexture;\nuniform float radiusPixels;\nuniform float textureWidth;\nuniform vec4 commonBounds;\nuniform float weightsScale;\nvoid main()\n{\n  weightsTexture = vec4(weights * weightsScale, 0., 0., 1.);\n\n  float radiusTexels  = project_pixel_size(radiusPixels) * textureWidth / (commonBounds.z - commonBounds.x);\n  gl_PointSize = radiusTexels * 2.;\n\n  vec3 commonPosition = project_position(positions, positions64Low);\n\n  // map xy from commonBounds to [-1, 1]\n  gl_Position.xy = (commonPosition.xy - commonBounds.xy) / (commonBounds.zw - commonBounds.xy) ;\n  gl_Position.xy = (gl_Position.xy * 2.) - (1.);\n}\n",_fs:"varying vec4 weightsTexture;\n// Epanechnikov function, keeping for reference\n// float epanechnikovKDE(float u) {\n//   return 0.75 * (1.0 - u * u);\n// }\nfloat gaussianKDE(float u){\n  return pow(2.71828, -u*u/0.05555)/(1.77245385*0.166666);\n}\nvoid main()\n{\n  float dist = length(gl_PointCoord - vec2(0.5, 0.5));\n  if (dist > 0.5) {\n    discard;\n  }\n  gl_FragColor = weightsTexture * gaussianKDE(2. * dist);\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n"})}},{key:"_createWeightsTransform",value:function(){var t,e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},n=this.context.gl,r=this.state.weightsTransform,i=this.state.weightsTexture;null===(t=r)||void 0===t||t.delete(),r=new w.a(n,kr({id:"".concat(this.id,"-weights-transform"),elementCount:1,_targetTexture:i,_targetTextureVarying:"weightsTexture"},e)),this.setState({weightsTransform:r})}},{key:"_setupResources",value:function(){var t=this.context.gl;this._createTextures();var e=this.state,n=e.textureSize,r=e.weightsTexture,i=e.maxWeightsTexture,o=this.getShaders("weights-transform");this._createWeightsTransform(o);var a=this.getShaders("max-weights-transform"),s=new w.a(t,kr(kr({id:"".concat(this.id,"-max-weights-transform"),_sourceTextures:{inTexture:r},_targetTexture:i,_targetTextureVarying:"outTexture"},a),{},{elementCount:n*n}));this.setState({weightsTexture:r,maxWeightsTexture:i,maxWeightTransform:s,zoom:null,triPositionBuffer:new Pt.a(t,{byteLength:48,accessor:{size:3}}),triTexCoordBuffer:new Pt.a(t,{byteLength:48,accessor:{size:2}})})}},{key:"updateShaders",value:function(t){this._createWeightsTransform(t)}},{key:"_updateMaxWeightValue",value:function(){this.state.maxWeightTransform.run({parameters:{blend:!0,depthTest:!1,blendFunc:[1,1],blendEquation:32776}})}},{key:"_updateBounds",value:function(){var t=arguments.length>0&&void 0!==arguments[0]&&arguments[0],e=this.context.viewport,n=[e.unproject([0,0]),e.unproject([e.width,0]),e.unproject([e.width,e.height]),e.unproject([0,e.height])].map((function(t){return t.map(Math.fround)})),r=wr(n),i={visibleWorldBounds:r,viewportCorners:n},o=!1;if(t||!this.state.worldBounds||!Er(this.state.worldBounds,r)){var a=this._worldToCommonBounds(r),s=this._commonToWorldBounds(a);this.props.coordinateSystem===te.a.LNGLAT&&(s[1]=Math.max(s[1],-85.051129),s[3]=Math.min(s[3],85.051129),s[0]=Math.max(s[0],-360),s[2]=Math.min(s[2],360));var u=this._worldToCommonBounds(s);i.worldBounds=s,i.normalizedCommonBounds=u,o=!0}return this.setState(i),o}},{key:"_updateTextureRenderingBounds",value:function(){var t=this.state,e=t.triPositionBuffer,n=t.triTexCoordBuffer,r=t.normalizedCommonBounds,i=t.viewportCorners,o=this.context.viewport;e.subData(Sr(i,3));var a=i.map((function(t){return e=o.projectPosition(t),n=r,i=It()(n,4),a=i[0],s=i[1],u=i[2],c=i[3],[(e[0]-a)/(u-a),(e[1]-s)/(c-s)];var e,n,i,a,s,u,c}));n.subData(Sr(a,2))}},{key:"_updateColorTexture",value:function(t){var e=t.props.colorRange,n=this.state.colorTexture,r=ft(e,!1,Uint8Array);n?n.setImageData({data:r,width:e.length}):n=new X.a(this.context.gl,kr({data:r,width:e.length,height:1},Lr)),this.setState({colorTexture:n})}},{key:"_updateWeightmap",value:function(){var t,e=this,n=this.props,r=n.radiusPixels,i=n.colorDomain,o=n.aggregation,a=this.state,s=a.weightsTransform,u=a.worldBounds,c=a.textureSize,l=a.weightsTexture,h=a.weightsScale;this.state.isWeightMapDirty=!1;var f=this._worldToCommonBounds(u,{useLayerCoordinateSystem:!0});if(i&&"SUM"===o){var p=this.context.viewport.distanceScales.metersPerUnit[2]*(f[2]-f[0])/c;this.state.colorDomain=i.map((function(t){return t*p*h}))}else this.state.colorDomain=i||jr;var d={radiusPixels:r,commonBounds:f,textureWidth:c,weightsScale:h};s.update({elementCount:this.getNumInstances()}),Object(v.o)(this.context.gl,{clearColor:[0,0,0,0]},(function(){s.run({uniforms:d,parameters:{blend:!0,depthTest:!1,blendFunc:[1,1],blendEquation:32774},clearRenderTarget:!0,attributes:e.getAttributes(),moduleSettings:e.getModuleSettings()})})),this._updateMaxWeightValue(),l.setParameters((t={},g()(t,10240,9729),g()(t,10241,9729),t))}},{key:"_debouncedUpdateWeightmap",value:function(){var t=arguments.length>0&&void 0!==arguments[0]&&arguments[0],e=this.state.updateTimer,n=this.props.debounceTimeout;t?(e=null,this._updateBounds(!0),this._updateTextureRenderingBounds(),this.setState({isWeightMapDirty:!0})):(this.setState({isWeightMapDirty:!1}),clearTimeout(e),e=setTimeout(this._debouncedUpdateWeightmap.bind(this,!0),n)),this.setState({updateTimer:e})}},{key:"_worldToCommonBounds",value:function(t){var e,n,r=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},i=r.useLayerCoordinateSystem,o=void 0!==i&&i,a=It()(t,4),s=a[0],u=a[1],c=a[2],l=a[3],h=this.context.viewport,f=this.state.textureSize,p=this.props.coordinateSystem,d=o&&(p===te.a.LNGLAT_OFFSETS||p===te.a.METER_OFFSETS),A=d?h.projectPosition(this.props.coordinateOrigin):[0,0],g=2*f/h.scale;return o&&!d?(e=this.projectPosition([s,u,0]),n=this.projectPosition([c,l,0])):(e=h.projectPosition([s,u,0]),n=h.projectPosition([c,l,0])),Tr([e[0]-A[0],e[1]-A[1],n[0]-A[0],n[1]-A[1]],g,g)}},{key:"_commonToWorldBounds",value:function(t){var e=It()(t,4),n=e[0],r=e[1],i=e[2],o=e[3],a=this.context.viewport,s=a.unprojectPosition([n,r]),u=a.unprojectPosition([i,o]);return s.slice(0,2).concat(u.slice(0,2))}}]),n}(Ct);g()(Vr,"layerName","HeatmapLayer"),g()(Vr,"defaultProps",zr),n.d(e,"ScreenGridLayer",(function(){return be})),n.d(e,"CPUGridLayer",(function(){return De})),n.d(e,"HexagonLayer",(function(){return Ze})),n.d(e,"ContourLayer",(function(){return er})),n.d(e,"GridLayer",(function(){return _r})),n.d(e,"GPUGridLayer",(function(){return Ar})),n.d(e,"AGGREGATION_OPERATION",(function(){return R})),n.d(e,"HeatmapLayer",(function(){return Vr})),n.d(e,"_GPUGridAggregator",(function(){return ot})),n.d(e,"_CPUAggregator",(function(){return Ie})),n.d(e,"_AggregationLayer",(function(){return Ct})),n.d(e,"_BinSorter",(function(){return Yt}))},function(t,e,n){"use strict";n.r(e);var r=n(186),i=n(322),o=n(204),a=n(315),s=n(7),u=n(189),c=n(251),l=n(206),h=n(236),f=n(33),p=n(321),d=n(74),A=n(109),g=n(107),m=n(237),y=n(238),v=n(314),_=n(60),b=n(47);const x={x:[2,0,1],y:[0,1,2],z:[1,2,0]};class w extends _.a{constructor(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{id:e=Object(b.c)("truncated-code-geometry")}=t,{indices:n,attributes:r}=function(t){const{bottomRadius:e=0,topRadius:n=0,height:r=1,nradial:i=10,nvertical:o=10,verticalAxis:a="y",topCap:s=!1,bottomCap:u=!1}=t,c=(s?2:0)+(u?2:0),l=(i+1)*(o+1+c),h=Math.atan2(e-n,r),f=Math.sin,p=Math.cos,d=Math.PI,A=p(h),g=f(h),m=s?-2:0,y=o+(u?2:0),v=i+1,_=new Uint16Array(i*(o+c)*6),b=x[a],w=new Float32Array(3*l),E=new Float32Array(3*l),O=new Float32Array(2*l);let S=0,T=0;for(let t=m;t<=y;t++){let a,s=t/o,u=r*s;t<0?(u=0,s=1,a=e):t>o?(u=r,s=1,a=n):a=e+t/o*(n-e),-2!==t&&t!==o+2||(a=0,s=0),u-=r/2;for(let e=0;e<v;e++){const n=f(e*d*2/i),r=p(e*d*2/i);w[S+b[0]]=n*a,w[S+b[1]]=u,w[S+b[2]]=r*a,E[S+b[0]]=t<0||t>o?0:n*A,E[S+b[1]]=t<0?-1:t>o?1:g,E[S+b[2]]=t<0||t>o?0:r*A,O[T+0]=e/i,O[T+1]=s,T+=2,S+=3}}for(let t=0;t<o+c;t++)for(let e=0;e<i;e++){const n=6*(t*i+e);_[n+0]=v*(t+0)+0+e,_[n+1]=v*(t+0)+1+e,_[n+2]=v*(t+1)+1+e,_[n+3]=v*(t+0)+0+e,_[n+4]=v*(t+1)+1+e,_[n+5]=v*(t+1)+0+e}return{indices:_,attributes:{POSITION:{size:3,value:w},NORMAL:{size:3,value:E},TEXCOORD_0:{size:2,value:O}}}}(t);super({...t,id:e,indices:n,attributes:{...r,...t.attributes}})}}class E extends w{constructor(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{id:e=Object(b.c)("cone-geometry"),radius:n=1,cap:r=!0}=t;super({...t,id:e,topRadius:0,topCap:Boolean(r),bottomCap:Boolean(r),bottomRadius:n})}}var O=n(297);class S extends w{constructor(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{id:e=Object(b.c)("cylinder-geometry"),radius:n=1}=t;super({...t,id:e,bottomRadius:n,topRadius:n})}}var T=n(84);const C=[-1,0,0,0,1,0,0,0,-1,0,0,1,0,-1,0,1,0,0],P=[3,4,5,3,5,1,3,1,0,3,0,4,4,0,2,4,2,5,2,0,1,5,2,1];class M extends _.a{constructor(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{id:e=Object(b.c)("ico-sphere-geometry")}=t,{indices:n,attributes:r}=function(t){const{iterations:e=0}=t,n=Math.PI,r=2*n,i=[...C];let o=[...P];i.push(),o.push();const a=(()=>{const t={};return(e,n)=>{const r=(e*=3)>(n*=3)?e:n,o="".concat(e<n?e:n,"|").concat(r);if(o in t)return t[o];const a=i[e],s=i[e+1],u=i[e+2];let c=(a+i[n])/2,l=(s+i[n+1])/2,h=(u+i[n+2])/2;const f=Math.sqrt(c*c+l*l+h*h);return c/=f,l/=f,h/=f,i.push(c,l,h),t[o]=i.length/3-1}})();for(let t=0;t<e;t++){const t=[];for(let e=0;e<o.length;e+=3){const n=a(o[e+0],o[e+1]),r=a(o[e+1],o[e+2]),i=a(o[e+2],o[e+0]);t.push(i,o[e+0],n,n,o[e+1],r,r,o[e+2],i,n,r,i)}o=t}const s=new Array(i.length),u=new Array(i.length/3*2);for(let t=o.length-3;t>=0;t-=3){const e=o[t+0],a=o[t+1],c=o[t+2],l=3*e,h=3*a,f=3*c,p=2*e,d=2*a,A=2*c,g=i[l+0],m=i[l+1],y=i[l+2],v=Math.acos(y/Math.sqrt(g*g+m*m+y*y)),_=Math.atan2(m,g)+n,b=v/n,x=1-_/r,w=i[h+0],E=i[h+1],O=i[h+2],S=Math.acos(O/Math.sqrt(w*w+E*E+O*O)),C=Math.atan2(E,w)+n,P=S/n,M=1-C/r,I=i[f+0],B=i[f+1],R=i[f+2],k=Math.acos(R/Math.sqrt(I*I+B*B+R*R)),D=Math.atan2(B,I)+n,L=k/n,j=1-D/r,F=[I-w,B-E,R-O],z=[g-w,m-E,y-O],U=new T.a(F).cross(z).normalize();let N;(0===x||0===M||0===j)&&(0===x||x>.5)&&(0===M||M>.5)&&(0===j||j>.5)&&(i.push(i[l+0],i[l+1],i[l+2]),N=i.length/3-1,o.push(N),u[2*N+0]=1,u[2*N+1]=b,s[3*N+0]=U.x,s[3*N+1]=U.y,s[3*N+2]=U.z,i.push(i[h+0],i[h+1],i[h+2]),N=i.length/3-1,o.push(N),u[2*N+0]=1,u[2*N+1]=P,s[3*N+0]=U.x,s[3*N+1]=U.y,s[3*N+2]=U.z,i.push(i[f+0],i[f+1],i[f+2]),N=i.length/3-1,o.push(N),u[2*N+0]=1,u[2*N+1]=L,s[3*N+0]=U.x,s[3*N+1]=U.y,s[3*N+2]=U.z),s[l+0]=s[h+0]=s[f+0]=U.x,s[l+1]=s[h+1]=s[f+1]=U.y,s[l+2]=s[h+2]=s[f+2]=U.z,u[p+0]=x,u[p+1]=b,u[d+0]=M,u[d+1]=P,u[A+0]=j,u[A+1]=L}return{indices:{size:1,value:new Uint16Array(o)},attributes:{POSITION:{size:3,value:new Float32Array(i)},NORMAL:{size:3,value:new Float32Array(s)},TEXCOORD_0:{size:2,value:new Float32Array(u)}}}}(t);super({...t,id:e,indices:n,attributes:{...r,...t.attributes}})}}class I extends _.a{constructor(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{id:e=Object(b.c)("plane-geometry")}=t,{indices:n,attributes:r}=function(t){const{type:e="x,y",offset:n=0,flipCull:r=!1,unpack:i=!1}=t,o=e.split(",");let a=t["".concat(o[0],"len")]||1;const s=t["".concat(o[1],"len")]||1,u=t["n".concat(o[0])]||1,c=t["n".concat(o[1])]||1,l=(u+1)*(c+1),h=new Float32Array(3*l),f=new Float32Array(3*l),p=new Float32Array(2*l);r&&(a=-a);let d=0,A=0;for(let t=0;t<=c;t++)for(let i=0;i<=u;i++){const o=i/u,l=t/c;switch(p[d+0]=r?1-o:o,p[d+1]=l,e){case"x,y":h[A+0]=a*o-.5*a,h[A+1]=s*l-.5*s,h[A+2]=n,f[A+0]=0,f[A+1]=0,f[A+2]=r?1:-1;break;case"x,z":h[A+0]=a*o-.5*a,h[A+1]=n,h[A+2]=s*l-.5*s,f[A+0]=0,f[A+1]=r?1:-1,f[A+2]=0;break;case"y,z":h[A+0]=n,h[A+1]=a*o-.5*a,h[A+2]=s*l-.5*s,f[A+0]=r?1:-1,f[A+1]=0,f[A+2]=0;break;default:throw new Error("PlaneGeometry: unknown type")}d+=2,A+=3}const g=u+1,m=new Uint16Array(u*c*6);for(let t=0;t<c;t++)for(let e=0;e<u;e++){const n=6*(t*u+e);m[n+0]=(t+0)*g+e,m[n+1]=(t+1)*g+e,m[n+2]=(t+0)*g+e+1,m[n+3]=(t+1)*g+e,m[n+4]=(t+1)*g+e+1,m[n+5]=(t+0)*g+e+1}const y={indices:{size:1,value:m},attributes:{POSITION:{size:3,value:h},NORMAL:{size:3,value:f},TEXCOORD_0:{size:2,value:p}}};return i?function(t){const{indices:e,attributes:n}=t;if(!e)return t;const r=e.value.length,i={};for(const t in n){const o=n[t],{constant:a,value:s,size:u}=o;if(a||!u)continue;const c=new s.constructor(r*u);for(let t=0;t<r;++t){const n=e.value[t];for(let e=0;e<u;e++)c[t*u+e]=s[n*u+e]}i[t]={size:u,value:c}}return{attributes:Object.assign({},n,i)}}(y):y}(t);super({...t,id:e,indices:n,attributes:{...r,...t.attributes}})}}class B extends _.a{constructor(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{id:e=Object(b.c)("sphere-geometry")}=t,{indices:n,attributes:r}=function(t){const{nlat:e=10,nlong:n=10}=t;let{radius:r=1}=t;const i=Math.PI-0,o=2*Math.PI-0,a=(e+1)*(n+1);if("number"==typeof r){const t=r;r=(e,n,r,i,o)=>t}const s=new Float32Array(3*a),u=new Float32Array(3*a),c=new Float32Array(2*a),l=new(a>65535?Uint32Array:Uint16Array)(e*n*6);for(let t=0;t<=e;t++)for(let a=0;a<=n;a++){const l=a/n,h=t/e,f=a+t*(n+1),p=2*f,d=3*f,A=o*l,g=i*h,m=Math.sin(A),y=Math.cos(A),v=Math.sin(g),_=Math.cos(g),b=y*v,x=_,w=m*v,E=r(b,x,w,l,h);s[d+0]=E*b,s[d+1]=E*x,s[d+2]=E*w,u[d+0]=b,u[d+1]=x,u[d+2]=w,c[p+0]=l,c[p+1]=1-h}const h=n+1;for(let t=0;t<n;t++)for(let n=0;n<e;n++){const r=6*(t*e+n);l[r+0]=n*h+t,l[r+1]=n*h+t+1,l[r+2]=(n+1)*h+t,l[r+3]=(n+1)*h+t,l[r+4]=n*h+t+1,l[r+5]=(n+1)*h+t+1}return{indices:{size:1,value:l},attributes:{POSITION:{size:3,value:s},NORMAL:{size:3,value:u},TEXCOORD_0:{size:2,value:c}}}}(t);super({...t,id:e,indices:n,attributes:{...r,...t.attributes}})}}n.d(e,"Model",(function(){return r.a})),n.d(e,"Transform",(function(){return i.a})),n.d(e,"ProgramManager",(function(){return o.a})),n.d(e,"Timeline",(function(){return a.a})),n.d(e,"instrumentGLContext",(function(){return s.h})),n.d(e,"isWebGL2",(function(){return s.j})),n.d(e,"FEATURES",(function(){return u.a})),n.d(e,"hasFeatures",(function(){return c.c})),n.d(e,"getParameters",(function(){return s.f})),n.d(e,"setParameters",(function(){return s.n})),n.d(e,"withParameters",(function(){return s.o})),n.d(e,"cssToDeviceRatio",(function(){return s.e})),n.d(e,"readPixelsToBuffer",(function(){return l.d})),n.d(e,"copyToTexture",(function(){return l.b})),n.d(e,"cloneTextureFrom",(function(){return h.a})),n.d(e,"Buffer",(function(){return f.a})),n.d(e,"Program",(function(){return p.a})),n.d(e,"Framebuffer",(function(){return d.a})),n.d(e,"Renderbuffer",(function(){return A.a})),n.d(e,"Texture2D",(function(){return g.a})),n.d(e,"TextureCube",(function(){return m.a})),n.d(e,"Texture3D",(function(){return y.a})),n.d(e,"TransformFeedback",(function(){return v.a})),n.d(e,"Geometry",(function(){return _.a})),n.d(e,"ConeGeometry",(function(){return E})),n.d(e,"CubeGeometry",(function(){return O.a})),n.d(e,"CylinderGeometry",(function(){return S})),n.d(e,"IcoSphereGeometry",(function(){return M})),n.d(e,"PlaneGeometry",(function(){return I})),n.d(e,"SphereGeometry",(function(){return B})),n.d(e,"TruncatedConeGeometry",(function(){return w}))},function(t,e,n){"use strict";n.r(e);var r=n(183),i=n.n(r),o=n(3),a=n.n(o),s=n(4),u=n.n(s),c=n(0),l=n.n(c),h=n(7),f=n(199),p=n(316),d=n(78);function A(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function g(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?A(Object(n),!0).forEach((function(e){l()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):A(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function m(t,e,n,r){if(n){if(n.userData._googleMap===t)return n;v(n)}var i={click:null,dblclick:null,mousemove:null,mouseout:null},o=new f.a(g(g({},r),{},{useDevicePixels:!!r.interleaved||r.useDevicePixels,style:r.interleaved?null:{pointerEvents:"none"},parent:y(e,r.style),initialViewState:{longitude:0,latitude:0,zoom:1},controller:!1})),a=function(e){i[e]=t.addListener(e,(function(t){return function(t,e,n){var r={type:e,offsetCenter:w(n,t),srcEvent:n};switch(e){case"click":r.tapCount=1,t._onPointerDown(r),t._onEvent(r);break;case"dblclick":r.type="click",r.tapCount=2,t._onEvent(r);break;case"mousemove":r.type="pointermove",t._onPointerMove(r);break;case"mouseout":r.type="pointerleave",t._onPointerMove(r);break;default:return}}(o,e,t)}))};for(var s in i)a(s);return o.userData._googleMap=t,o.userData._eventListeners=i,o}function y(t,e){var n,r,i=document.createElement("div");(i.style.position="absolute",Object.assign(i.style,e),"getPanes"in t)?null===(n=t.getPanes())||void 0===n||n.overlayLayer.appendChild(i):null===(r=t.getMap())||void 0===r||r.getDiv().appendChild(i);return i}function v(t){var e=t.userData._eventListeners;for(var n in e)e[n]&&e[n].remove();t.finalize()}function _(t,e){var n=b(t),r=n.width,i=n.height,o=e.getCameraParams(),a=o.center,s=o.heading,u=o.tilt,c=o.zoom,l=i?r/i:1,h=(new d.a).perspective({fovy:25*Math.PI/180,aspect:l,near:.75,far:3e14});return{width:r,height:i,viewState:{altitude:.5*h[5],bearing:s,latitude:a.lat(),longitude:a.lng(),pitch:u,projectionMatrix:h,repeat:!0,zoom:c-1}}}function b(t){var e=t.getDiv().firstChild;return{width:e.offsetWidth,height:e.offsetHeight}}function x(t,e,n){var r=new google.maps.Point(e,n),i=t.fromContainerPixelToLatLng(r);return[i.lng(),i.lat()]}function w(t,e){if(t.pixel)return t.pixel;var n=e.getViewports()[0].project([t.latLng.lng(),t.latLng.lat()]);return{x:n[0],y:n[1]}}var E=["width","height","left","top"];function O(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function S(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?O(Object(n),!0).forEach((function(e){l()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):O(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}var T=function(){return!1},C={depthMask:!0,depthTest:!0,blend:!0,blendFunc:[770,771,1,771],blendEquation:32774};function P(){}var M={interleaved:!0},I=function(){function t(e){a()(this,t),l()(this,"props",{}),l()(this,"_map",null),l()(this,"_deck",null),l()(this,"_overlay",null),this.setProps(S(S({},M),e))}return u()(t,[{key:"setMap",value:function(t){var e=this;if(t!==this._map){var n;if(this._map)null===(n=this._overlay)||void 0===n||n.setMap(null),this._map=null;if(t){this._map=t;var r=google.maps.RenderingType.UNINITIALIZED;t.getRenderingType()!==r?this._createOverlay(t):t.addListener("renderingtype_changed",(function(){e._createOverlay(t)}))}}}},{key:"setProps",value:function(t){if(Object.assign(this.props,t),this._deck){if(t.style){var e=this._deck.canvas.parentElement.style;Object.assign(e,t.style),t.style=null}this._deck.setProps(t)}}},{key:"pickObject",value:function(t){return this._deck&&this._deck.pickObject(t)}},{key:"pickMultipleObjects",value:function(t){return this._deck&&this._deck.pickMultipleObjects(t)}},{key:"pickObjects",value:function(t){return this._deck&&this._deck.pickObjects(t)}},{key:"finalize",value:function(){this.setMap(null),this._deck&&(v(this._deck),this._deck=null)}},{key:"_createOverlay",value:function(t){var e=this.props.interleaved,n=google.maps.RenderingType,r=n.VECTOR,i=n.UNINITIALIZED,o=t.getRenderingType();if(o!==i){var a=new(o===r&&google.maps.WebGLOverlayView?google.maps.WebGLOverlayView:google.maps.OverlayView);a instanceof google.maps.WebGLOverlayView?(e?(a.onAdd=P,a.onContextRestored=this._onContextRestored.bind(this),a.onDraw=this._onDrawVectorInterleaved.bind(this)):(a.onAdd=this._onAdd.bind(this),a.onContextRestored=P,a.onDraw=this._onDrawVectorOverlay.bind(this)),a.onContextLost=this._onContextLost.bind(this)):(a.onAdd=this._onAdd.bind(this),a.draw=this._onDrawRaster.bind(this)),a.onRemove=this._onRemove.bind(this),this._overlay=a,this._overlay.setMap(t)}}},{key:"_onAdd",value:function(){this._deck=m(this._map,this._overlay,this._deck,this.props)}},{key:"_onContextRestored",value:function(t){var e=this,n=t.gl;if(this._map&&this._overlay){var r=m(this._map,this._overlay,this._deck,S({gl:n,_customRender:function(){e._overlay&&e._overlay.requestRedraw()}},this.props));this._deck=r;var i=r.animationLoop;i._renderFrame=function(){var t=n.getParameter(34964);Object(h.o)(n,{},(function(){i.onRender()})),n.bindBuffer(34962,t)}}}},{key:"_onContextLost",value:function(){this._deck&&(v(this._deck),this._deck=null)}},{key:"_onRemove",value:function(){var t;null===(t=this._deck)||void 0===t||t.setProps({layerFilter:T})}},{key:"_onDrawRaster",value:function(){if(this._deck&&this._map){var t=this._deck,e=function(t,e){var n=b(t),r=n.width,i=n.height,o=e.getProjection(),a=t.getBounds();if(!a)return{width:r,height:i,left:0,top:0};var s=a.getNorthEast(),u=a.getSouthWest(),c=o.fromLatLngToDivPixel(s),l=o.fromLatLngToDivPixel(u),h=x(o,r/2,i/2),f=new google.maps.LatLng(0,h[0]),d=o.fromLatLngToContainerPixel(f),A=o.fromLatLngToDivPixel(f);if(!(c&&l&&A&&d))return{width:r,height:i,left:0,top:0};var g=Math.round(A.x-d.x),m=A.y-d.y,y=x(o,r/2,0),v=x(o,r/2,i),_=h[1],w=h[0];if(Math.abs(_)>85.05113){_=_>0?85.05113:-85.05113;var E=new google.maps.LatLng(_,w);m+=o.fromLatLngToContainerPixel(E).y-i/2}m=Math.round(m);var O=180*new p.a(y).sub(v).verticalAngle()/Math.PI;O<0&&(O+=360);var S,T=t.getHeading()||0,C=t.getZoom()-1;if(0===O)S=i?(l.y-c.y)/i:1;else if(O===T){var P=new p.a([c.x,c.y]).sub([l.x,l.y]).len(),M=new p.a([r,-i]).len();S=M?P/M:1}return{width:r,height:i,left:g,top:m,zoom:C+=Math.log2(S||1),bearing:O,pitch:t.getTilt(),latitude:_,longitude:w}}(this._map,this._overlay),n=e.width,r=e.height,o=e.left,a=e.top,s=i()(e,E),u=t.canvas.parentElement.style;u.left="".concat(o,"px"),u.top="".concat(a,"px");t.setProps({width:n,height:r,viewState:S({altitude:1e4,repeat:!0},s)}),t.redraw()}}},{key:"_onDrawVectorInterleaved",value:function(t){var e=t.gl,n=t.transformer;if(this._deck&&this._map){var r=this._deck;if(r.setProps(S(S({},_(this._map,n)),{},{width:null,height:null})),r.isInitialized){var i=Object(h.f)(e,36006);r.setProps({_framebuffer:i}),r.needsRedraw({clearRedrawFlags:!0}),Object(h.n)(e,{viewport:[0,0,e.canvas.width,e.canvas.height],scissor:[0,0,e.canvas.width,e.canvas.height],stencilFunc:[519,0,255,519,0,255]}),Object(h.o)(e,C,(function(){r._drawLayers("google-vector",{clearCanvas:!1})}))}}}},{key:"_onDrawVectorOverlay",value:function(t){var e=t.transformer;if(this._deck&&this._map){var n=this._deck;n.setProps(S({},_(this._map,e))),n.redraw()}}}]),t}();n.d(e,"GoogleMapsOverlay",(function(){return I}))},function(t,e,n){"use strict";n.r(e);var r=n(174),i=n.n(r),o=n(88),a=n.n(o),s=n(89),u=n.n(s),c=n(140),l=n.n(c),h=n(119),f=n.n(h),p=n(120),d=n.n(p),A=n(56),g=n.n(A),m=n(141),y=n(128);function v(t){switch(t){case"int8":return Int8Array;case"uint8":return Uint8Array;case"int16":return Int16Array;case"uint16":return Uint16Array;case"float32":return Float32Array;case"float64":return Float64Array;case"int32":return Int32Array;case"uint32":return Uint32Array;case"int64":return BigInt64Array;case"uint64":return BigUint64Array;default:throw new Error("Unrecognized dtype ".concat(t))}}function _(t,e){if(!t)return null;for(var n in t){var r=t[n].attributes;for(var i in r){var o=r[i],a=o.dtype,s=o.value,u=v(a);r[i].value=new u(s.buffer)}}return t}function b(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function x(t){for(var e=1;e<arguments.length;e++){var n=null!=arguments[e]?arguments[e]:{};e%2?b(Object(n),!0).forEach((function(e){i()(t,e,n[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(n)):b(Object(n)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(n,e))}))}return t}function w(t){var e=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(t){return!1}}();return function(){var n,r=g()(t);if(e){var i=g()(this).constructor;n=Reflect.construct(r,arguments,i)}else n=r.apply(this,arguments);return d()(this,n)}}n.d(e,"default",(function(){return E}));var E=function(t){f()(n,t);var e=w(n);function n(){return a()(this,n),e.apply(this,arguments)}return u()(n,[{key:"defaults",value:function(){return x(x({},l()(g()(n.prototype),"defaults",this).call(this)),{},{_model_name:n.model_name,_model_module:n.model_module,_model_module_version:n.model_module_version,_view_name:n.view_name,_view_module:n.view_module,_view_module_version:n.view_module_version,custom_libraries:[],json_input:null,mapbox_key:null,selected_data:[],data_buffer:null,tooltip:null,width:"100%",height:500,js_warning:!1})}}],[{key:"serializers",get:function(){return x(x({},m.DOMWidgetModel.serializers),{},{data_buffer:{deserialize:_}})}},{key:"model_name",get:function(){return"JupyterTransportModel"}},{key:"model_module",get:function(){return y.MODULE_NAME}},{key:"model_module_version",get:function(){return y.MODULE_VERSION}},{key:"view_name",get:function(){return"JupyterTransportView"}},{key:"view_module",get:function(){return y.MODULE_NAME}},{key:"view_module_version",get:function(){return y.MODULE_VERSION}}]),n}(m.DOMWidgetModel)},function(t,e,n){"use strict";n.r(e);var r=n(41),i=n(173),o=n(184),a=n(131),s=n(87);function u(){i.a.setCallbacks({onInitialize:function(t){var e=t.transport,n=function(t){var e=t.jupyterModel;if(!e)throw new Error("deck.gl playground currently only works with the Jupyter Widget Transport");return{width:e.get("width"),height:e.get("height"),customLibraries:e.get("custom_libraries"),mapboxApiKey:e.get("mapbox_key"),jsonInput:e.get("json_input"),tooltip:e.get("tooltip")}}(e),r=n.width,i=n.height,u=n.customLibraries,l=n.mapboxApiKey,h=n.jsonInput,f=n.tooltip;Object(a.b)();var p=e.getRootDOMElement(),d=Object(o.a)(r,i);p.appendChild(d);var A=JSON.parse(h),g=Object(s.createDeck)({mapboxApiKey:l,container:d,jsonInput:A,tooltip:f,handleEvent:function(t,n){return function(t,e,n){if("hover"===e&&!n.picked&&-1===n.index)return;var r=JSON.parse(JSON.stringify(n,c));t.sendJSONMessage(e,r)}(e,t,n)},customLibraries:u});e.userData.deck=g},onFinalize:function(t){t.transport.userData.deck.finalize()},onMessage:function(t){var e,n=t.transport,r=t.type,i=t.json,o=(t.binary,n.userData.deck);switch(r){case"json":e=s.jsonConverter.convert(i),o.setProps(e);break;case"json-with-binary":e=s.jsonConverter.convert(i);var a=function(t){for(var e=t.binary,n=t.convertedJson,r=0;r<n.layers.length;r++){var i=n.layers[r].id,o=n.layers[r];n.layers[r]=o.clone({data:e[i]})}return n}({binary:n.jupyterModel.get("data_buffer"),convertedJson:e});o.setProps(a)}}})}function c(t,e){return e instanceof r.Layer?e.id:e}n.d(e,"initPlayground",(function(){return u})),n.d(e,"createDeck",(function(){return s.createDeck})),n.d(e,"updateDeck",(function(){return s.updateDeck}))},function(t,e,n){"use strict";n.d(e,"a",(function(){return l}));var r=n(60),i=n(47);const o=new Uint16Array([0,1,2,0,2,3,4,5,6,4,6,7,8,9,10,8,10,11,12,13,14,12,14,15,16,17,18,16,18,19,20,21,22,20,22,23]),a=new Float32Array([-1,-1,1,1,-1,1,1,1,1,-1,1,1,-1,-1,-1,-1,1,-1,1,1,-1,1,-1,-1,-1,1,-1,-1,1,1,1,1,1,1,1,-1,-1,-1,-1,1,-1,-1,1,-1,1,-1,-1,1,1,-1,-1,1,1,-1,1,1,1,1,-1,1,-1,-1,-1,-1,-1,1,-1,1,1,-1,1,-1]),s=new Float32Array([0,0,1,0,0,1,0,0,1,0,0,1,0,0,-1,0,0,-1,0,0,-1,0,0,-1,0,1,0,0,1,0,0,1,0,0,1,0,0,-1,0,0,-1,0,0,-1,0,0,-1,0,1,0,0,1,0,0,1,0,0,1,0,0,-1,0,0,-1,0,0,-1,0,0,-1,0,0]),u=new Float32Array([0,0,1,0,1,1,0,1,1,0,1,1,0,1,0,0,0,1,0,0,1,0,1,1,1,1,0,1,0,0,1,0,1,0,1,1,0,1,0,0,0,0,1,0,1,1,0,1]),c={POSITION:{size:3,value:new Float32Array(a)},NORMAL:{size:3,value:new Float32Array(s)},TEXCOORD_0:{size:2,value:new Float32Array(u)}};class l extends r.a{constructor(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{id:e=Object(i.c)("cube-geometry")}=t;super({...t,id:e,indices:{size:1,value:new Uint16Array(o)},attributes:{...c,...t.attributes}})}}},function(t,e,n){"use strict";var r=n(2),i=n(142);Object(i.a)();class o{constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:"sessionStorage";Object(r.a)(this,"storage",void 0),Object(r.a)(this,"id",void 0),Object(r.a)(this,"config",{}),this.storage=function(t){try{const e=window[t],n="__storage_test__";return e.setItem(n,n),e.removeItem(n),e}catch(t){return null}}(n),this.id=t,this.config={},Object.assign(this.config,e),this._loadConfiguration()}getConfiguration(){return this.config}setConfiguration(t){return this.config={},this.updateConfiguration(t)}updateConfiguration(t){if(Object.assign(this.config,t),this.storage){const t=JSON.stringify(this.config);this.storage.setItem(this.id,t)}return this}_loadConfiguration(){let t={};if(this.storage){const e=this.storage.getItem(this.id);t=e?JSON.parse(e):{}}return Object.assign(this.config,t),this}}function a(t,e,n){let r=arguments.length>3&&void 0!==arguments[3]?arguments[3]:600;const i=t.src.replace(/\(/g,"%28").replace(/\)/g,"%29");t.width>r&&(n=Math.min(n,r/t.width));const o=t.width*n,a=t.height*n,s=["font-size:1px;","padding:".concat(Math.floor(a/2),"px ").concat(Math.floor(o/2),"px;"),"line-height:".concat(a,"px;"),"background:url(".concat(i,");"),"background-size:".concat(o,"px ").concat(a,"px;"),"color:transparent;"].join("");return["".concat(e," %c+"),s]}let s;function u(t){return"string"==typeof t?s[t.toUpperCase()]||s.WHITE:t}function c(t,e){if(!t)throw new Error(e||"Assertion failed")}!function(t){t[t.BLACK=30]="BLACK",t[t.RED=31]="RED",t[t.GREEN=32]="GREEN",t[t.YELLOW=33]="YELLOW",t[t.BLUE=34]="BLUE",t[t.MAGENTA=35]="MAGENTA",t[t.CYAN=36]="CYAN",t[t.WHITE=37]="WHITE",t[t.BRIGHT_BLACK=90]="BRIGHT_BLACK",t[t.BRIGHT_RED=91]="BRIGHT_RED",t[t.BRIGHT_GREEN=92]="BRIGHT_GREEN",t[t.BRIGHT_YELLOW=93]="BRIGHT_YELLOW",t[t.BRIGHT_BLUE=94]="BRIGHT_BLUE",t[t.BRIGHT_MAGENTA=95]="BRIGHT_MAGENTA",t[t.BRIGHT_CYAN=96]="BRIGHT_CYAN",t[t.BRIGHT_WHITE=97]="BRIGHT_WHITE"}(s||(s={}));var l=n(97);function h(){let t;var e,n;if(i.a&&"performance"in l.b)t=null===l.b||void 0===l.b||null===(e=l.b.performance)||void 0===e||null===(n=e.now)||void 0===n?void 0:n.call(e);else if("hrtime"in l.a){var r;const e=null===l.a||void 0===l.a||null===(r=l.a.hrtime)||void 0===r?void 0:r.call(l.a);t=1e3*e[0]+e[1]/1e6}else t=Date.now();return t}n.d(e,"a",(function(){return m}));const f={debug:i.a&&console.debug||console.log,log:console.log,info:console.info,warn:console.warn,error:console.error},p={enabled:!0,level:0};function d(){}const A={},g={once:!0};class m{constructor(){let{id:t}=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{id:""};Object(r.a)(this,"id",void 0),Object(r.a)(this,"VERSION","8.9.7"),Object(r.a)(this,"_startTs",h()),Object(r.a)(this,"_deltaTs",h()),Object(r.a)(this,"_storage",void 0),Object(r.a)(this,"userData",{}),Object(r.a)(this,"LOG_THROTTLE_TIMEOUT",0),this.id=t,this._storage=new o("__probe-".concat(this.id,"__"),p),this.userData={},this.timeStamp("".concat(this.id," started")),function(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:["constructor"];const n=Object.getPrototypeOf(t),r=Object.getOwnPropertyNames(n);for(const n of r)"function"==typeof t[n]&&(e.find(t=>n===t)||(t[n]=t[n].bind(t)))}(this),Object.seal(this)}set level(t){this.setLevel(t)}get level(){return this.getLevel()}isEnabled(){return this._storage.config.enabled}getLevel(){return this._storage.config.level}getTotal(){return Number((h()-this._startTs).toPrecision(10))}getDelta(){return Number((h()-this._deltaTs).toPrecision(10))}set priority(t){this.level=t}get priority(){return this.level}getPriority(){return this.level}enable(){let t=!(arguments.length>0&&void 0!==arguments[0])||arguments[0];return this._storage.updateConfiguration({enabled:t}),this}setLevel(t){return this._storage.updateConfiguration({level:t}),this}get(t){return this._storage.config[t]}set(t,e){this._storage.updateConfiguration({[t]:e})}settings(){console.table?console.table(this._storage.config):console.log(this._storage.config)}assert(t,e){c(t,e)}warn(t){return this._getLogFunction(0,t,f.warn,arguments,g)}error(t){return this._getLogFunction(0,t,f.error,arguments)}deprecated(t,e){return this.warn("`".concat(t,"` is deprecated and will be removed in a later version. Use `").concat(e,"` instead"))}removed(t,e){return this.error("`".concat(t,"` has been removed. Use `").concat(e,"` instead"))}probe(t,e){return this._getLogFunction(t,e,f.log,arguments,{time:!0,once:!0})}log(t,e){return this._getLogFunction(t,e,f.debug,arguments)}info(t,e){return this._getLogFunction(t,e,console.info,arguments)}once(t,e){for(var n=arguments.length,r=new Array(n>2?n-2:0),i=2;i<n;i++)r[i-2]=arguments[i];return this._getLogFunction(t,e,f.debug||f.info,arguments,g)}table(t,e,n){return e?this._getLogFunction(t,e,console.table||d,n&&[n],{tag:_(e)}):d}image(t){let{logLevel:e,priority:r,image:o,message:s="",scale:u=1}=t;return this._shouldLog(e||r)?i.a?function(t){let{image:e,message:n="",scale:r=1}=t;if("string"==typeof e){const t=new Image;return t.onload=()=>{const e=a(t,n,r);console.log(...e)},t.src=e,d}const i=e.nodeName||"";if("img"===i.toLowerCase())return console.log(...a(e,n,r)),d;if("canvas"===i.toLowerCase()){const t=new Image;return t.onload=()=>console.log(...a(t,n,r)),t.src=e.toDataURL(),d}return d}({image:o,message:s,scale:u}):function(t){let{image:e,message:r="",scale:i=1}=t,o=null;try{o=n(267)}catch(t){}if(o)return()=>o(e,{fit:"box",width:"".concat(Math.round(80*i),"%")}).then(t=>console.log(t));return d}({image:o,message:s,scale:u}):d}time(t,e){return this._getLogFunction(t,e,console.time?console.time:console.info)}timeEnd(t,e){return this._getLogFunction(t,e,console.timeEnd?console.timeEnd:console.info)}timeStamp(t,e){return this._getLogFunction(t,e,console.timeStamp||d)}group(t,e){let n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{collapsed:!1};const r=v({logLevel:t,message:e,opts:n}),{collapsed:i}=n;return r.method=(i?console.groupCollapsed:console.group)||console.info,this._getLogFunction(r)}groupCollapsed(t,e){let n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{};return this.group(t,e,Object.assign({},n,{collapsed:!0}))}groupEnd(t){return this._getLogFunction(t,"",console.groupEnd||d)}withGroup(t,e,n){this.group(t,e)();try{n()}finally{this.groupEnd(t)()}}trace(){console.trace&&console.trace()}_shouldLog(t){return this.isEnabled()&&this.getLevel()>=y(t)}_getLogFunction(t,e,n,r,o){if(this._shouldLog(t)){o=v({logLevel:t,message:e,args:r,opts:o}),c(n=n||o.method),o.total=this.getTotal(),o.delta=this.getDelta(),this._deltaTs=h();const a=o.tag||o.message;if(o.once){if(A[a])return d;A[a]=h()}return e=function(t,e,n){if("string"==typeof e){const s=n.time?function(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:8;const n=Math.max(e-t.length,0);return"".concat(" ".repeat(n)).concat(t)}(function(t){let e;return e=t<10?"".concat(t.toFixed(2),"ms"):t<100?"".concat(t.toFixed(1),"ms"):t<1e3?"".concat(t.toFixed(0),"ms"):"".concat((t/1e3).toFixed(2),"s"),e}(n.total)):"";e=n.time?"".concat(t,": ").concat(s,"  ").concat(e):"".concat(t,": ").concat(e),r=e,o=n.color,a=n.background,i.a||"string"!=typeof r||(o&&(o=u(o),r="[".concat(o,"m").concat(r,"")),a&&(o=u(a),r="[".concat(a+10,"m").concat(r,""))),e=r}var r,o,a;return e}(this.id,o.message,o),n.bind(console,e,...o.args)}return d}}function y(t){if(!t)return 0;let e;switch(typeof t){case"number":e=t;break;case"object":e=t.logLevel||t.priority||0;break;default:return 0}return c(Number.isFinite(e)&&e>=0),e}function v(t){const{logLevel:e,message:n}=t;t.logLevel=y(e);const r=t.args?Array.from(t.args):[];for(;r.length&&r.shift()!==n;);switch(typeof e){case"string":case"function":void 0!==n&&r.unshift(n),t.message=e;break;case"object":Object.assign(t,e)}"function"==typeof t.message&&(t.message=t.message());const i=typeof t.message;return c("string"===i||"object"===i),Object.assign(t,{args:r},t.opts)}function _(t){for(const e in t)for(const n in t[e])return n||"untitled";return"empty"}Object(r.a)(m,"VERSION","8.9.7")},,,,,,,,,,,,,,,function(t,e,n){"use strict";n.d(e,"a",(function(){return a}));var r=n(142),i=n(175);const o=globalThis;function a(t){if(!t&&!Object(r.a)())return"Node";if(Object(i.a)(t))return"Electron";const e="undefined"!=typeof navigator?navigator:{},n=t||e.userAgent||"";if(n.indexOf("Edge")>-1)return"Edge";const a=-1!==n.indexOf("MSIE "),s=-1!==n.indexOf("Trident/");return a||s?"IE":o.chrome?"Chrome":o.safari?"Safari":o.mozInnerScreenX?"Firefox":"Unknown"}},function(t,e,n){"use strict";n.d(e,"a",(function(){return s}));var r=n(7),i=n(38),o=n(33),a=n(47);class s extends i.a{get[Symbol.toStringTag](){return"TransformFeedback"}static isSupported(t){return Object(r.j)(t)}constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};Object(r.a)(t),super(t,e),this.initialize(e),this.stubRemovedMethods("TransformFeedback","v6.0",["pause","resume"]),Object.seal(this)}initialize(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return this.buffers={},this.unused={},this.configuration=null,this.bindOnUse=!0,Object(a.a)(this.buffers)||this.bind(()=>this._unbindBuffers()),this.setProps(t),this}setProps(t){"program"in t&&(this.configuration=t.program&&t.program.configuration),"configuration"in t&&(this.configuration=t.configuration),"bindOnUse"in t&&(t=t.bindOnUse),"buffers"in t&&this.setBuffers(t.buffers)}setBuffers(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return this.bind(()=>{for(const e in t)this.setBuffer(e,t[e])}),this}setBuffer(t,e){const n=this._getVaryingIndex(t),{buffer:i,byteSize:o,byteOffset:a}=this._getBufferParams(e);return n<0?(this.unused[t]=i,r.k.warn("".concat(this.id," unused varying buffer ").concat(t))(),this):(this.buffers[n]=e,this.bindOnUse||this._bindBuffer(n,i,a,o),this)}begin(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:0;return this.gl.bindTransformFeedback(36386,this.handle),this._bindBuffers(),this.gl.beginTransformFeedback(t),this}end(){return this.gl.endTransformFeedback(),this._unbindBuffers(),this.gl.bindTransformFeedback(36386,null),this}_getBufferParams(t){let e,n,r;return t instanceof o.a==!1?(r=t.buffer,n=t.byteSize,e=t.byteOffset):r=t,void 0===e&&void 0===n||(e=e||0,n=n||r.byteLength-e),{buffer:r,byteOffset:e,byteSize:n}}_getVaryingInfo(t){return this.configuration&&this.configuration.getVaryingInfo(t)}_getVaryingIndex(t){if(this.configuration)return this.configuration.getVaryingInfo(t).location;const e=Number(t);return Number.isFinite(e)?e:-1}_bindBuffers(){if(this.bindOnUse)for(const t in this.buffers){const{buffer:e,byteSize:n,byteOffset:r}=this._getBufferParams(this.buffers[t]);this._bindBuffer(t,e,r,n)}}_unbindBuffers(){if(this.bindOnUse)for(const t in this.buffers)this._bindBuffer(t,null)}_bindBuffer(t,e){let n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:0,r=arguments.length>3?arguments[3]:void 0;const i=e&&e.handle;return i&&void 0!==r?this.gl.bindBufferRange(35982,t,i,n,r):this.gl.bindBufferBase(35982,t,i),this}_createHandle(){return this.gl.createTransformFeedback()}_deleteHandle(){this.gl.deleteTransformFeedback(this.handle)}_bindHandle(t){this.gl.bindTransformFeedback(36386,this.handle)}}},function(t,e,n){"use strict";n.d(e,"a",(function(){return o}));let r=1,i=1;class o{constructor(){this.time=0,this.channels=new Map,this.animations=new Map,this.playing=!1,this.lastEngineTime=-1}addChannel(t){const{delay:e=0,duration:n=Number.POSITIVE_INFINITY,rate:i=1,repeat:o=1}=t,a=r++,s={time:0,delay:e,duration:n,rate:i,repeat:o};return this._setChannelTime(s,this.time),this.channels.set(a,s),a}removeChannel(t){this.channels.delete(t);for(const[e,n]of this.animations)n.channel===t&&this.detachAnimation(e)}isFinished(t){const e=this.channels.get(t);return void 0!==e&&this.time>=e.delay+e.duration*e.repeat}getTime(t){if(void 0===t)return this.time;const e=this.channels.get(t);return void 0===e?-1:e.time}setTime(t){this.time=Math.max(0,t);const e=this.channels.values();for(const t of e)this._setChannelTime(t,this.time);const n=this.animations.values();for(const t of n){const{animation:e,channel:n}=t;e.setTime(this.getTime(n))}}play(){this.playing=!0}pause(){this.playing=!1,this.lastEngineTime=-1}reset(){this.setTime(0)}attachAnimation(t,e){const n=i++;return this.animations.set(n,{animation:t,channel:e}),t.setTime(this.getTime(e)),n}detachAnimation(t){this.animations.delete(t)}update(t){this.playing&&(-1===this.lastEngineTime&&(this.lastEngineTime=t),this.setTime(this.time+(t-this.lastEngineTime)),this.lastEngineTime=t)}_setChannelTime(t,e){const n=e-t.delay;n>=t.duration*t.repeat?t.time=t.duration*t.rate:(t.time=Math.max(0,n)%t.duration,t.time*=t.rate)}}},function(t,e,n){"use strict";n.d(e,"a",(function(){return u}));var r=n(121),i=n(13),o=n(23),a=n(34),s=n(55);class u extends r.a{constructor(t=0,e=0){super(2),Object(i.f)(t)&&1===arguments.length?this.copy(t):(i.b.debug&&(Object(o.a)(t),Object(o.a)(e)),this[0]=t,this[1]=e)}set(t,e){return this[0]=t,this[1]=e,this.check()}copy(t){return this[0]=t[0],this[1]=t[1],this.check()}fromObject(t){return i.b.debug&&(Object(o.a)(t.x),Object(o.a)(t.y)),this[0]=t.x,this[1]=t.y,this.check()}toObject(t){return t.x=this[0],t.y=this[1],t}get ELEMENTS(){return 2}horizontalAngle(){return Math.atan2(this.y,this.x)}verticalAngle(){return Math.atan2(this.x,this.y)}transform(t){return this.transformAsPoint(t)}transformAsPoint(t){return a.j(this,this,t),this.check()}transformAsVector(t){return Object(s.a)(this,this,t),this.check()}transformByMatrix3(t){return a.i(this,this,t),this.check()}transformByMatrix2x3(t){return a.h(this,this,t),this.check()}transformByMatrix2(t){return a.g(this,this,t),this.check()}}},function(t,e,n){"use strict";n.d(e,"a",(function(){return s}));var r=n(49),i=n(133),o=n(51);const a={};async function s(t,e=null,n={}){return e&&(t=function(t,e,n){if(t.startsWith("http"))return t;const i=n.modules||{};if(i[t])return i[t];if(!r.b)return"modules/".concat(e,"/dist/libs/").concat(t);if(n.CDN)return Object(o.a)(n.CDN.startsWith("http")),"".concat(n.CDN,"/").concat(e,"@").concat("3.2.10","/dist/libs/").concat(t);if(r.d)return"../src/libs/".concat(t);return"modules/".concat(e,"/src/libs/").concat(t)}(t,e,n)),a[t]=a[t]||async function(t){if(t.endsWith("wasm")){const e=await fetch(t);return await e.arrayBuffer()}if(!r.b)try{return i&&i.requireFromFile&&await i.requireFromFile(t)}catch{return null}if(r.d)return importScripts(t);const e=await fetch(t);return function(t,e){if(!r.b)return i.requireFromString&&i.requireFromString(t,e);if(r.d)return eval.call(r.a,t),null;const n=document.createElement("script");n.id=e;try{n.appendChild(document.createTextNode(t))}catch(e){n.text=t}return document.body.appendChild(n),null}(await e.text(),t)}(t),await a[t]}},function(t,e,n){"use strict";(function(t,r){n.d(e,"a",(function(){return i}));"undefined"!=typeof self&&self,"undefined"!=typeof window&&window,"undefined"!=typeof document&&document;const i=Boolean("object"!=typeof r||"[object process]"!==String(r)||r.browser),o=void 0!==r&&r.version&&/v([0-9]*)/.exec(r.version);o&&parseFloat(o[1])}).call(this,n(71),n(44))},function(t,e,n){"use strict";var r={};n.r(r),n.d(r,"name",(function(){return ot})),n.d(r,"decode",(function(){return at}));var i={};n.r(i),n.d(i,"name",(function(){return ft})),n.d(i,"preprocess",(function(){return pt}));var o={};n.r(o),n.d(o,"name",(function(){return dt})),n.d(o,"preprocess",(function(){return At}));var a={};n.r(a),n.d(a,"name",(function(){return yt})),n.d(a,"preprocess",(function(){return vt})),n.d(a,"decode",(function(){return _t})),n.d(a,"encode",(function(){return bt}));var s={};n.r(s),n.d(s,"name",(function(){return Ot})),n.d(s,"decode",(function(){return St})),n.d(s,"encode",(function(){return Tt}));var u={};n.r(u),n.d(u,"name",(function(){return Ct})),n.d(u,"decode",(function(){return Pt})),n.d(u,"encode",(function(){return Mt}));var c={};n.r(c),n.d(c,"name",(function(){return It})),n.d(c,"decode",(function(){return Bt})),n.d(c,"encode",(function(){return Rt}));var l=n(317);const h="https://unpkg.com/@loaders.gl/textures@".concat("3.2.10","/dist/libs/basis_encoder.wasm"),f="https://unpkg.com/@loaders.gl/textures@".concat("3.2.10","/dist/libs/basis_encoder.js");let p,d;async function A(t){const e=t.modules||{};return e.basis?e.basis:(p=p||async function(t){let e=null,n=null;return[e,n]=await Promise.all([await Object(l.a)("basis_transcoder.js","textures",t),await Object(l.a)("basis_transcoder.wasm","textures",t)]),e=e||globalThis.BASIS,await function(t,e){const n={};e&&(n.wasmBinary=e);return new Promise(e=>{t(n).then(t=>{const{BasisFile:n,initializeBasis:r}=t;r(),e({BasisFile:n})})})}(e,n)}(t),await p)}async function g(t){const e=t.modules||{};return e.basisEncoder?e.basisEncoder:(d=d||async function(t){let e=null,n=null;return[e,n]=await Promise.all([await Object(l.a)(f,"textures",t),await Object(l.a)(h,"textures",t)]),e=e||globalThis.BASIS,await function(t,e){const n={};e&&(n.wasmBinary=e);return new Promise(e=>{t(n).then(t=>{const{BasisFile:n,KTX2File:r,initializeBasis:i,BasisEncoder:o}=t;i(),e({BasisFile:n,KTX2File:r,BasisEncoder:o})})})}(e,n)}(t),await d)}const m={COMPRESSED_RGB_S3TC_DXT1_EXT:33776,COMPRESSED_RGBA_S3TC_DXT1_EXT:33777,COMPRESSED_RGBA_S3TC_DXT3_EXT:33778,COMPRESSED_RGBA_S3TC_DXT5_EXT:33779,COMPRESSED_R11_EAC:37488,COMPRESSED_SIGNED_R11_EAC:37489,COMPRESSED_RG11_EAC:37490,COMPRESSED_SIGNED_RG11_EAC:37491,COMPRESSED_RGB8_ETC2:37492,COMPRESSED_RGBA8_ETC2_EAC:37493,COMPRESSED_SRGB8_ETC2:37494,COMPRESSED_SRGB8_ALPHA8_ETC2_EAC:37495,COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2:37496,COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2:37497,COMPRESSED_RGB_PVRTC_4BPPV1_IMG:35840,COMPRESSED_RGBA_PVRTC_4BPPV1_IMG:35842,COMPRESSED_RGB_PVRTC_2BPPV1_IMG:35841,COMPRESSED_RGBA_PVRTC_2BPPV1_IMG:35843,COMPRESSED_RGB_ETC1_WEBGL:36196,COMPRESSED_RGB_ATC_WEBGL:35986,COMPRESSED_RGBA_ATC_EXPLICIT_ALPHA_WEBGL:35987,COMPRESSED_RGBA_ATC_INTERPOLATED_ALPHA_WEBGL:34798,COMPRESSED_RGBA_ASTC_4X4_KHR:37808,COMPRESSED_RGBA_ASTC_5X4_KHR:37809,COMPRESSED_RGBA_ASTC_5X5_KHR:37810,COMPRESSED_RGBA_ASTC_6X5_KHR:37811,COMPRESSED_RGBA_ASTC_6X6_KHR:37812,COMPRESSED_RGBA_ASTC_8X5_KHR:37813,COMPRESSED_RGBA_ASTC_8X6_KHR:37814,COMPRESSED_RGBA_ASTC_8X8_KHR:37815,COMPRESSED_RGBA_ASTC_10X5_KHR:37816,COMPRESSED_RGBA_ASTC_10X6_KHR:37817,COMPRESSED_RGBA_ASTC_10X8_KHR:37818,COMPRESSED_RGBA_ASTC_10X10_KHR:37819,COMPRESSED_RGBA_ASTC_12X10_KHR:37820,COMPRESSED_RGBA_ASTC_12X12_KHR:37821,COMPRESSED_SRGB8_ALPHA8_ASTC_4X4_KHR:37840,COMPRESSED_SRGB8_ALPHA8_ASTC_5X4_KHR:37841,COMPRESSED_SRGB8_ALPHA8_ASTC_5X5_KHR:37842,COMPRESSED_SRGB8_ALPHA8_ASTC_6X5_KHR:37843,COMPRESSED_SRGB8_ALPHA8_ASTC_6X6_KHR:37844,COMPRESSED_SRGB8_ALPHA8_ASTC_8X5_KHR:37845,COMPRESSED_SRGB8_ALPHA8_ASTC_8X6_KHR:37846,COMPRESSED_SRGB8_ALPHA8_ASTC_8X8_KHR:37847,COMPRESSED_SRGB8_ALPHA8_ASTC_10X5_KHR:37848,COMPRESSED_SRGB8_ALPHA8_ASTC_10X6_KHR:37849,COMPRESSED_SRGB8_ALPHA8_ASTC_10X8_KHR:37850,COMPRESSED_SRGB8_ALPHA8_ASTC_10X10_KHR:37851,COMPRESSED_SRGB8_ALPHA8_ASTC_12X10_KHR:37852,COMPRESSED_SRGB8_ALPHA8_ASTC_12X12_KHR:37853,COMPRESSED_RED_RGTC1_EXT:36283,COMPRESSED_SIGNED_RED_RGTC1_EXT:36284,COMPRESSED_RED_GREEN_RGTC2_EXT:36285,COMPRESSED_SIGNED_RED_GREEN_RGTC2_EXT:36286,COMPRESSED_SRGB_S3TC_DXT1_EXT:35916,COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT:35917,COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT:35918,COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT:35919},y=["","WEBKIT_","MOZ_"],v={WEBGL_compressed_texture_s3tc:"dxt",WEBGL_compressed_texture_s3tc_srgb:"dxt-srgb",WEBGL_compressed_texture_etc1:"etc1",WEBGL_compressed_texture_etc:"etc2",WEBGL_compressed_texture_pvrtc:"pvrtc",WEBGL_compressed_texture_atc:"atc",WEBGL_compressed_texture_astc:"astc",EXT_texture_compression_rgtc:"rgtc"};let _=null;function b(t){if(!_){t=t||function(){try{return document.createElement("canvas").getContext("webgl")}catch(t){return null}}()||void 0,_=new Set;for(const e of y)for(const n in v)if(t&&t.getExtension("".concat(e).concat(n))){const t=v[n];_.add(t)}}return _}n(246);const x=[171,75,84,88,32,50,48,187,13,10,26,10];const w={etc1:{basisFormat:0,compressed:!0,format:m.COMPRESSED_RGB_ETC1_WEBGL},etc2:{basisFormat:1,compressed:!0},bc1:{basisFormat:2,compressed:!0,format:m.COMPRESSED_RGB_S3TC_DXT1_EXT},bc3:{basisFormat:3,compressed:!0,format:m.COMPRESSED_RGBA_S3TC_DXT5_EXT},bc4:{basisFormat:4,compressed:!0},bc5:{basisFormat:5,compressed:!0},"bc7-m6-opaque-only":{basisFormat:6,compressed:!0},"bc7-m5":{basisFormat:7,compressed:!0},"pvrtc1-4-rgb":{basisFormat:8,compressed:!0,format:m.COMPRESSED_RGB_PVRTC_4BPPV1_IMG},"pvrtc1-4-rgba":{basisFormat:9,compressed:!0,format:m.COMPRESSED_RGBA_PVRTC_4BPPV1_IMG},"astc-4x4":{basisFormat:10,compressed:!0,format:m.COMPRESSED_RGBA_ASTC_4X4_KHR},"atc-rgb":{basisFormat:11,compressed:!0},"atc-rgba-interpolated-alpha":{basisFormat:12,compressed:!0},rgba32:{basisFormat:13,compressed:!1},rgb565:{basisFormat:14,compressed:!1},bgr565:{basisFormat:15,compressed:!1},rgba4444:{basisFormat:16,compressed:!1}};function E(t,e,n){const r=new t(new Uint8Array(e));try{if(!r.startTranscoding())throw new Error("Failed to start basis transcoding");const t=r.getNumImages(),e=[];for(let i=0;i<t;i++){const t=r.getNumLevels(i),o=[];for(let e=0;e<t;e++)o.push(O(r,i,e,n));e.push(o)}return e}finally{r.close(),r.delete()}}function O(t,e,n,r){const i=t.getImageWidth(e,n),o=t.getImageHeight(e,n),a=t.getHasAlpha(),{compressed:s,format:u,basisFormat:c}=C(r,a),l=t.getImageTranscodedSizeInBytes(e,n,c),h=new Uint8Array(l);if(!t.transcodeImage(h,e,n,c,0,0))throw new Error("failed to start Basis transcoding");return{width:i,height:o,data:h,compressed:s,format:u,hasAlpha:a}}function S(t,e,n){const r=new t(new Uint8Array(e));try{if(!r.startTranscoding())throw new Error("failed to start KTX2 transcoding");const t=r.getLevels(),e=[];for(let i=0;i<t;i++){e.push(T(r,i,n));break}return[e]}finally{r.close(),r.delete()}}function T(t,e,n){const{alphaFlag:r,height:i,width:o}=t.getImageLevelInfo(e,0,0),{compressed:a,format:s,basisFormat:u}=C(n,r),c=t.getImageTranscodedSizeInBytes(e,0,0,u),l=new Uint8Array(c);if(!t.transcodeImage(l,e,0,0,u,0,-1,-1))throw new Error("Failed to transcode KTX2 image");return{width:o,height:i,data:l,compressed:a,hasAlpha:r,format:s}}function C(t,e){let n=t&&t.basis&&t.basis.format;return"auto"===n&&(n=P()),"object"==typeof n&&(n=e?n.alpha:n.noAlpha),n=n.toLowerCase(),w[n]}function P(){const t=b();return t.has("astc")?"astc-4x4":t.has("dxt")?{alpha:"bc3",noAlpha:"bc1"}:t.has("pvrtc")?{alpha:"pvrtc1-4-rgba",noAlpha:"pvrtc1-4-rgb"}:t.has("etc1")?"etc1":t.has("etc2")?"etc2":"rgb565"}const M={name:"Basis",id:"basis",module:"textures",version:"3.2.10",worker:!0,extensions:["basis","ktx2"],mimeTypes:["application/octet-stream","image/ktx2"],tests:["sB"],binary:!0,options:{basis:{format:"auto",libraryPath:"libs/",containerFormat:"auto",module:"transcoder"}}},I={...M,parse:async function(t,e){if("auto"===e.basis.containerFormat){if(function(t){const e=new Uint8Array(t);return!(e.byteLength<x.length||e[0]!==x[0]||e[1]!==x[1]||e[2]!==x[2]||e[3]!==x[3]||e[4]!==x[4]||e[5]!==x[5]||e[6]!==x[6]||e[7]!==x[7]||e[8]!==x[8]||e[9]!==x[9]||e[10]!==x[10]||e[11]!==x[11])}(t)){return S((await g(e)).KTX2File,t,e)}const{BasisFile:n}=await A(e);return E(n,t,e)}switch(e.basis.module){case"encoder":const n=await g(e);switch(e.basis.containerFormat){case"ktx2":return S(n.KTX2File,t,e);case"basis":default:return E(n.BasisFile,t,e)}case"transcoder":default:const{BasisFile:r}=await A(e);return E(r,t,e)}}};var B=n(320),R=n(225),k=n(85);function D(t,e){if(!t)throw new Error(e||"assert failed: gltf")}function L(t,e){if(t.startsWith("data:")||t.startsWith("http:")||t.startsWith("https:"))return t;const n=e.baseUri||e.uri;if(!n)throw new Error("'baseUri' must be provided to resolve relative url ".concat(t));return n.substr(0,n.lastIndexOf("/")+1)+t}function j(t,e,n){const r=t.bufferViews[n];D(r);const i=e[r.buffer];D(i);const o=(r.byteOffset||0)+i.byteOffset;return new Uint8Array(i.arrayBuffer,o,r.byteLength)}var F=n(2),z=n(181),U=n(150);const N=["SCALAR","VEC2","VEC3","VEC4"],G=[[Int8Array,5120],[Uint8Array,5121],[Int16Array,5122],[Uint16Array,5123],[Uint32Array,5125],[Float32Array,5126],[Float64Array,5130]],V=new Map(G),H={SCALAR:1,VEC2:2,VEC3:3,VEC4:4,MAT2:4,MAT3:9,MAT4:16},W={5120:1,5121:1,5122:2,5123:2,5125:4,5126:4},q={5120:Int8Array,5121:Uint8Array,5122:Int16Array,5123:Uint16Array,5125:Uint32Array,5126:Float32Array};function X(t){return N[t-1]||N[0]}function Z(t){const e=V.get(t.constructor);if(!e)throw new Error("Illegal typed array");return e}function J(t,e){const n=q[t.componentType],r=H[t.type],i=W[t.componentType],o=t.count*r,a=t.count*r*i;return D(a>=0&&a<=e.byteLength),{ArrayType:n,length:o,byteLength:a}}const Q={asset:{version:"2.0",generator:"loaders.gl"},buffers:[]};class K{constructor(t){Object(F.a)(this,"gltf",void 0),Object(F.a)(this,"sourceBuffers",void 0),Object(F.a)(this,"byteLength",void 0),this.gltf=t||{json:{...Q},buffers:[]},this.sourceBuffers=[],this.byteLength=0,this.gltf.buffers&&this.gltf.buffers[0]&&(this.byteLength=this.gltf.buffers[0].byteLength,this.sourceBuffers=[this.gltf.buffers[0]])}get json(){return this.gltf.json}getApplicationData(t){return this.json[t]}getExtraData(t){return(this.json.extras||{})[t]}getExtension(t){const e=this.getUsedExtensions().find(e=>e===t),n=this.json.extensions||{};return e?n[t]||!0:null}getRequiredExtension(t){return this.getRequiredExtensions().find(e=>e===t)?this.getExtension(t):null}getRequiredExtensions(){return this.json.extensionsRequired||[]}getUsedExtensions(){return this.json.extensionsUsed||[]}getObjectExtension(t,e){return(t.extensions||{})[e]}getScene(t){return this.getObject("scenes",t)}getNode(t){return this.getObject("nodes",t)}getSkin(t){return this.getObject("skins",t)}getMesh(t){return this.getObject("meshes",t)}getMaterial(t){return this.getObject("materials",t)}getAccessor(t){return this.getObject("accessors",t)}getTexture(t){return this.getObject("textures",t)}getSampler(t){return this.getObject("samplers",t)}getImage(t){return this.getObject("images",t)}getBufferView(t){return this.getObject("bufferViews",t)}getBuffer(t){return this.getObject("buffers",t)}getObject(t,e){if("object"==typeof e)return e;const n=this.json[t]&&this.json[t][e];if(!n)throw new Error("glTF file error: Could not find ".concat(t,"[").concat(e,"]"));return n}getTypedArrayForBufferView(t){const e=(t=this.getBufferView(t)).buffer,n=this.gltf.buffers[e];D(n);const r=(t.byteOffset||0)+n.byteOffset;return new Uint8Array(n.arrayBuffer,r,t.byteLength)}getTypedArrayForAccessor(t){t=this.getAccessor(t);const e=this.getBufferView(t.bufferView),n=this.getBuffer(e.buffer).data,{ArrayType:r,length:i}=J(t,e);return new r(n,e.byteOffset+t.byteOffset,i)}getTypedArrayForImageData(t){t=this.getAccessor(t);const e=this.getBufferView(t.bufferView),n=this.getBuffer(e.buffer).data,r=e.byteOffset||0;return new Uint8Array(n,r,e.byteLength)}addApplicationData(t,e){return this.json[t]=e,this}addExtraData(t,e){return this.json.extras=this.json.extras||{},this.json.extras[t]=e,this}addObjectExtension(t,e,n){return t.extensions=t.extensions||{},t.extensions[e]=n,this.registerUsedExtension(e),this}setObjectExtension(t,e,n){(t.extensions||{})[e]=n}removeObjectExtension(t,e){const n=t.extensions||{},r=n[e];return delete n[e],r}addExtension(t,e={}){return D(e),this.json.extensions=this.json.extensions||{},this.json.extensions[t]=e,this.registerUsedExtension(t),e}addRequiredExtension(t,e={}){return D(e),this.addExtension(t,e),this.registerRequiredExtension(t),e}registerUsedExtension(t){this.json.extensionsUsed=this.json.extensionsUsed||[],this.json.extensionsUsed.find(e=>e===t)||this.json.extensionsUsed.push(t)}registerRequiredExtension(t){this.registerUsedExtension(t),this.json.extensionsRequired=this.json.extensionsRequired||[],this.json.extensionsRequired.find(e=>e===t)||this.json.extensionsRequired.push(t)}removeExtension(t){this.json.extensionsRequired&&this._removeStringFromArray(this.json.extensionsRequired,t),this.json.extensionsUsed&&this._removeStringFromArray(this.json.extensionsUsed,t),this.json.extensions&&delete this.json.extensions[t]}setDefaultScene(t){this.json.scene=t}addScene(t){const{nodeIndices:e}=t;return this.json.scenes=this.json.scenes||[],this.json.scenes.push({nodes:e}),this.json.scenes.length-1}addNode(t){const{meshIndex:e,matrix:n}=t;this.json.nodes=this.json.nodes||[];const r={mesh:e};return n&&(r.matrix=n),this.json.nodes.push(r),this.json.nodes.length-1}addMesh(t){const{attributes:e,indices:n,material:r,mode:i=4}=t,o={primitives:[{attributes:this._addAttributes(e),mode:i}]};if(n){const t=this._addIndices(n);o.primitives[0].indices=t}return Number.isFinite(r)&&(o.primitives[0].material=r),this.json.meshes=this.json.meshes||[],this.json.meshes.push(o),this.json.meshes.length-1}addPointCloud(t){const e={primitives:[{attributes:this._addAttributes(t),mode:0}]};return this.json.meshes=this.json.meshes||[],this.json.meshes.push(e),this.json.meshes.length-1}addImage(t,e){const n=Object(z.a)(t),r=e||(null==n?void 0:n.mimeType),i={bufferView:this.addBufferView(t),mimeType:r};return this.json.images=this.json.images||[],this.json.images.push(i),this.json.images.length-1}addBufferView(t){const e=t.byteLength;D(Number.isFinite(e)),this.sourceBuffers=this.sourceBuffers||[],this.sourceBuffers.push(t);const n={buffer:0,byteOffset:this.byteLength,byteLength:e};return this.byteLength+=Object(U.b)(e,4),this.json.bufferViews=this.json.bufferViews||[],this.json.bufferViews.push(n),this.json.bufferViews.length-1}addAccessor(t,e){const n={bufferView:t,type:X(e.size),componentType:e.componentType,count:e.count,max:e.max,min:e.min};return this.json.accessors=this.json.accessors||[],this.json.accessors.push(n),this.json.accessors.length-1}addBinaryBuffer(t,e={size:3}){const n=this.addBufferView(t);let r={min:e.min,max:e.max};r.min&&r.max||(r=this._getAccessorMinMax(t,e.size));const i={size:e.size,componentType:Z(t),count:Math.round(t.length/e.size),min:r.min,max:r.max};return this.addAccessor(n,Object.assign(i,e))}addTexture(t){const{imageIndex:e}=t,n={source:e};return this.json.textures=this.json.textures||[],this.json.textures.push(n),this.json.textures.length-1}addMaterial(t){return this.json.materials=this.json.materials||[],this.json.materials.push(t),this.json.materials.length-1}createBinaryChunk(){var t,e;this.gltf.buffers=[];const n=this.byteLength,r=new ArrayBuffer(n),i=new Uint8Array(r);let o=0;for(const t of this.sourceBuffers||[])o=Object(U.a)(t,i,o);null!==(t=this.json)&&void 0!==t&&null!==(e=t.buffers)&&void 0!==e&&e[0]?this.json.buffers[0].byteLength=n:this.json.buffers=[{byteLength:n}],this.gltf.binary=r,this.sourceBuffers=[r]}_removeStringFromArray(t,e){let n=!0;for(;n;){const r=t.indexOf(e);r>-1?t.splice(r,1):n=!1}}_addAttributes(t={}){const e={};for(const n in t){const r=t[n],i=this._getGltfAttributeName(n),o=this.addBinaryBuffer(r.value,r);e[i]=o}return e}_addIndices(t){return this.addBinaryBuffer(t,{size:1})}_getGltfAttributeName(t){switch(t.toLowerCase()){case"position":case"positions":case"vertices":return"POSITION";case"normal":case"normals":return"NORMAL";case"color":case"colors":return"COLOR_0";case"texcoord":case"texcoords":return"TEXCOORD_0";default:return t}}_getAccessorMinMax(t,e){const n={min:null,max:null};if(t.length<e)return n;n.min=[],n.max=[];const r=t.subarray(0,e);for(const t of r)n.min.push(t),n.max.push(t);for(let r=e;r<t.length;r+=e)for(let i=0;i<e;i++)n.min[0+i]=Math.min(n.min[0+i],t[r+i]),n.max[0+i]=Math.max(n.max[0+i],t[r+i]);return n}}const Y=new Uint8Array([0,97,115,109,1,0,0,0,1,4,1,96,0,0,3,3,2,0,0,5,3,1,0,1,12,1,0,10,22,2,12,0,65,0,65,0,65,0,252,10,0,0,11,7,0,65,0,253,15,26,11]),$=new Uint8Array([32,0,65,253,3,1,2,34,4,106,6,5,11,8,7,20,13,33,12,16,128,9,116,64,19,113,127,15,10,21,22,14,255,66,24,54,136,107,18,23,192,26,114,118,132,17,77,101,130,144,27,87,131,44,45,74,156,154,70,167]),tt={0:"",1:"meshopt_decodeFilterOct",2:"meshopt_decodeFilterQuat",3:"meshopt_decodeFilterExp",NONE:"",OCTAHEDRAL:"meshopt_decodeFilterOct",QUATERNION:"meshopt_decodeFilterQuat",EXPONENTIAL:"meshopt_decodeFilterExp"},et={0:"meshopt_decodeVertexBuffer",1:"meshopt_decodeIndexBuffer",2:"meshopt_decodeIndexSequence",ATTRIBUTES:"meshopt_decodeVertexBuffer",TRIANGLES:"meshopt_decodeIndexBuffer",INDICES:"meshopt_decodeIndexSequence"};let nt;async function rt(){return nt||(nt=async function(){let t="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";WebAssembly.validate(Y)&&(t="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",console.log("Warning: meshopt_decoder is using experimental SIMD support"));const e=await WebAssembly.instantiate(function(t){const e=new Uint8Array(t.length);for(let n=0;n<t.length;++n){const r=t.charCodeAt(n);e[n]=r>96?r-71:r>64?r-65:r>47?r+4:r>46?63:62}let n=0;for(let r=0;r<t.length;++r)e[n++]=e[r]<60?$[e[r]]:64*(e[r]-60)+e[++r];return e.buffer.slice(0,n)}(t),{});return await e.instance.exports.__wasm_call_ctors(),e.instance}()),nt}function it(t,e,n,r,i,o,a){const s=t.exports.sbrk,u=r+3&-4,c=s(u*i),l=s(o.length),h=new Uint8Array(t.exports.memory.buffer);h.set(o,l);const f=e(c,r,i,l,o.length);if(0===f&&a&&a(c,u,i),n.set(h.subarray(c,c+r*i)),s(c-s(0)),0!==f)throw new Error("Malformed buffer data: ".concat(f))}const ot="EXT_meshopt_compression";async function at(t,e){var n;const r=new K(t);if(null==e||null===(n=e.gltf)||void 0===n||!n.decompressMeshes)return;const i=[];for(const e of t.json.bufferViews||[])i.push(st(r,e));await Promise.all(i),r.removeExtension("EXT_meshopt_compression")}async function st(t,e){const n=t.getObjectExtension(e,"EXT_meshopt_compression");if(n){const{byteOffset:r=0,byteLength:i=0,byteStride:o,count:a,mode:s,filter:u="NONE",buffer:c}=n,l=t.gltf.buffers[c],h=new Uint8Array(l.arrayBuffer,l.byteOffset+r,i),f=new Uint8Array(t.gltf.buffers[e.buffer].arrayBuffer,e.byteOffset,e.byteLength);return await async function(t,e,n,r,i,o="NONE"){const a=await rt();it(a,a.exports[et[i]],t,e,n,r,a.exports[tt[o||"NONE"]])}(f,a,o,h,s,u),f}return null}var ut=n(72);const ct=["image/png","image/jpeg","image/gif"],lt={};function ht(t){return void 0===lt[t]&&(lt[t]=function(t){switch(t){case"image/webp":return function(){if(!ut.c)return!1;try{return 0===document.createElement("canvas").toDataURL("image/webp").indexOf("data:image/webp")}catch{return!1}}();case"image/svg":return ut.c;default:if(!ut.c){const{_parseImageNode:e}=globalThis;return Boolean(e)&&ct.includes(t)}return!0}}(t)),lt[t]}const ft="EXT_texture_webp";function pt(t,e){const n=new K(t);if(!ht("image/webp")){if(n.getRequiredExtensions().includes("EXT_texture_webp"))throw new Error("gltf: Required extension ".concat("EXT_texture_webp"," not supported by browser"));return}const{json:r}=n;for(const t of r.textures||[]){const e=n.getObjectExtension(t,"EXT_texture_webp");e&&(t.source=e.source),n.removeObjectExtension(t,"EXT_texture_webp")}n.removeExtension("EXT_texture_webp")}const dt="KHR_texture_basisu";function At(t,e){const n=new K(t),{json:r}=n;for(const t of r.textures||[]){const e=n.getObjectExtension(t,"KHR_texture_basisu");e&&(t.source=e.source),n.removeObjectExtension(t,"KHR_texture_basisu")}n.removeExtension("KHR_texture_basisu")}var gt=n(185);function mt(t){const{buffer:e,size:n,count:r}=function(t){let e=t,n=1,r=0;t&&t.value&&(e=t.value,n=t.size||1);e&&(ArrayBuffer.isView(e)||(e=function(t,e,n=!1){if(!t)return null;if(Array.isArray(t))return new e(t);if(n&&!(t instanceof e))return new e(t);return t}(e,Float32Array)),r=e.length/n);return{buffer:e,size:n,count:r}}(t);return{value:e,size:n,byteOffset:0,count:r,type:X(n),componentType:Z(e)}}const yt="KHR_draco_mesh_compression";function vt(t,e,n){const r=new K(t);for(const t of Et(r))r.getObjectExtension(t,"KHR_draco_mesh_compression")}async function _t(t,e,n){var r;if(null==e||null===(r=e.gltf)||void 0===r||!r.decompressMeshes)return;const i=new K(t),o=[];for(const t of Et(i))i.getObjectExtension(t,"KHR_draco_mesh_compression")&&o.push(xt(i,t,e,n));await Promise.all(o),i.removeExtension("KHR_draco_mesh_compression")}function bt(t,e={}){const n=new K(t);for(const t of n.json.meshes||[])wt(t,e),n.addRequiredExtension("KHR_draco_mesh_compression")}async function xt(t,e,n,r){const i=t.getObjectExtension(e,"KHR_draco_mesh_compression");if(!i)return;const o=t.getTypedArrayForBufferView(i.bufferView),a=Object(k.c)(o.buffer,o.byteOffset),{parse:s}=r,u={...n};delete u["3d-tiles"];const c=await s(a,gt.a,u,r),l=function(t){const e={};for(const n in t){const r=t[n];if("indices"!==n){const t=mt(r);e[n]=t}}return e}(c.attributes);for(const[n,r]of Object.entries(l))if(n in e.attributes){const i=e.attributes[n],o=t.getAccessor(i);null!=o&&o.min&&null!=o&&o.max&&(r.min=o.min,r.max=o.max)}e.attributes=l,c.indices&&(e.indices=mt(c.indices)),function(t){if(!t.attributes&&Object.keys(t.attributes).length>0)throw new Error("glTF: Empty primitive detected: Draco decompression failure?")}(e)}function wt(t,e,n=4,r,i){var o;if(!r.DracoWriter)throw new Error("options.gltf.DracoWriter not provided");const a=r.DracoWriter.encodeSync({attributes:t}),s=null==i||null===(o=i.parseSync)||void 0===o?void 0:o.call(i,{attributes:t}),u=r._addFauxAttributes(s.attributes);return{primitives:[{attributes:u,mode:n,extensions:{KHR_draco_mesh_compression:{bufferView:r.addBufferView(a),attributes:u}}}]}}function*Et(t){for(const e of t.json.meshes||[])for(const t of e.primitives)yield t}const Ot="KHR_lights_punctual";async function St(t){const e=new K(t),{json:n}=e,r=e.getExtension("KHR_lights_punctual");r&&(e.json.lights=r.lights,e.removeExtension("KHR_lights_punctual"));for(const t of n.nodes||[]){const n=e.getObjectExtension(t,"KHR_lights_punctual");n&&(t.light=n.light),e.removeObjectExtension(t,"KHR_lights_punctual")}}async function Tt(t){const e=new K(t),{json:n}=e;if(n.lights){const t=e.addExtension("KHR_lights_punctual");D(!t.lights),t.lights=n.lights,delete n.lights}if(e.json.lights){for(const t of e.json.lights){const n=t.node;e.addObjectExtension(n,"KHR_lights_punctual",t)}delete e.json.lights}}const Ct="KHR_materials_unlit";async function Pt(t){const e=new K(t),{json:n}=e;e.removeExtension("KHR_materials_unlit");for(const t of n.materials||[]){t.extensions&&t.extensions.KHR_materials_unlit&&(t.unlit=!0),e.removeObjectExtension(t,"KHR_materials_unlit")}}function Mt(t){const e=new K(t),{json:n}=e;if(e.materials)for(const t of n.materials||[])t.unlit&&(delete t.unlit,e.addObjectExtension(t,"KHR_materials_unlit",{}),e.addExtension("KHR_materials_unlit"))}const It="KHR_techniques_webgl";async function Bt(t){const e=new K(t),{json:n}=e,r=e.getExtension("KHR_techniques_webgl");if(r){const t=function(t,e){const{programs:n=[],shaders:r=[],techniques:i=[]}=t,o=new TextDecoder;return r.forEach(t=>{if(!Number.isFinite(t.bufferView))throw new Error("KHR_techniques_webgl: no shader code");t.code=o.decode(e.getTypedArrayForBufferView(t.bufferView))}),n.forEach(t=>{t.fragmentShader=r[t.fragmentShader],t.vertexShader=r[t.vertexShader]}),i.forEach(t=>{t.program=n[t.program]}),i}(r,e);for(const r of n.materials||[]){const n=e.getObjectExtension(r,"KHR_techniques_webgl");n&&(r.technique=Object.assign({},n,t[n.technique]),r.technique.values=kt(r.technique,e)),e.removeObjectExtension(r,"KHR_techniques_webgl")}e.removeExtension("KHR_techniques_webgl")}}async function Rt(t,e){}function kt(t,e){const n=Object.assign({},t.values);return Object.keys(t.uniforms||{}).forEach(e=>{t.uniforms[e].value&&!(e in n)&&(n[e]=t.uniforms[e].value)}),Object.keys(n).forEach(t=>{"object"==typeof n[t]&&void 0!==n[t].index&&(n[t].texture=e.getTexture(n[t].index))}),n}const Dt=[r,i,o,a,s,u,c];function Lt(t,e){var n;const r=(null==e||null===(n=e.gltf)||void 0===n?void 0:n.excludeExtensions)||{};return!(t in r&&!r[t])}const jt={accessors:"accessor",animations:"animation",buffers:"buffer",bufferViews:"bufferView",images:"image",materials:"material",meshes:"mesh",nodes:"node",samplers:"sampler",scenes:"scene",skins:"skin",textures:"texture"},Ft={accessor:"accessors",animations:"animation",buffer:"buffers",bufferView:"bufferViews",image:"images",material:"materials",mesh:"meshes",node:"nodes",sampler:"samplers",scene:"scenes",skin:"skins",texture:"textures"};class zt{constructor(){Object(F.a)(this,"idToIndexMap",{animations:{},accessors:{},buffers:{},bufferViews:{},images:{},materials:{},meshes:{},nodes:{},samplers:{},scenes:{},skins:{},textures:{}}),Object(F.a)(this,"json",void 0)}normalize(t,e){this.json=t.json;const n=t.json;switch(n.asset&&n.asset.version){case"2.0":return;case void 0:case"1.0":break;default:return void console.warn("glTF: Unknown version ".concat(n.asset.version))}if(!e.normalize)throw new Error("glTF v1 is not supported.");console.warn("Converting glTF v1 to glTF v2 format. This is experimental and may fail."),this._addAsset(n),this._convertTopLevelObjectsToArrays(n),function(t){const e=new K(t),{json:n}=e;for(const t of n.images||[]){const n=e.getObjectExtension(t,"KHR_binary_glTF");n&&Object.assign(t,n),e.removeObjectExtension(t,"KHR_binary_glTF")}n.buffers&&n.buffers[0]&&delete n.buffers[0].uri,e.removeExtension("KHR_binary_glTF")}(t),this._convertObjectIdsToArrayIndices(n),this._updateObjects(n),this._updateMaterial(n)}_addAsset(t){t.asset=t.asset||{},t.asset.version="2.0",t.asset.generator=t.asset.generator||"Normalized to glTF 2.0 by loaders.gl"}_convertTopLevelObjectsToArrays(t){for(const e in jt)this._convertTopLevelObjectToArray(t,e)}_convertTopLevelObjectToArray(t,e){const n=t[e];if(n&&!Array.isArray(n)){t[e]=[];for(const r in n){const i=n[r];i.id=i.id||r;const o=t[e].length;t[e].push(i),this.idToIndexMap[e][r]=o}}}_convertObjectIdsToArrayIndices(t){for(const e in jt)this._convertIdsToIndices(t,e);"scene"in t&&(t.scene=this._convertIdToIndex(t.scene,"scene"));for(const e of t.textures)this._convertTextureIds(e);for(const e of t.meshes)this._convertMeshIds(e);for(const e of t.nodes)this._convertNodeIds(e);for(const e of t.scenes)this._convertSceneIds(e)}_convertTextureIds(t){t.source&&(t.source=this._convertIdToIndex(t.source,"image"))}_convertMeshIds(t){for(const e of t.primitives){const{attributes:t,indices:n,material:r}=e;for(const e in t)t[e]=this._convertIdToIndex(t[e],"accessor");n&&(e.indices=this._convertIdToIndex(n,"accessor")),r&&(e.material=this._convertIdToIndex(r,"material"))}}_convertNodeIds(t){t.children&&(t.children=t.children.map(t=>this._convertIdToIndex(t,"node"))),t.meshes&&(t.meshes=t.meshes.map(t=>this._convertIdToIndex(t,"mesh")))}_convertSceneIds(t){t.nodes&&(t.nodes=t.nodes.map(t=>this._convertIdToIndex(t,"node")))}_convertIdsToIndices(t,e){t[e]||(console.warn("gltf v1: json doesn't contain attribute ".concat(e)),t[e]=[]);for(const n of t[e])for(const t in n){const e=n[t],r=this._convertIdToIndex(e,t);n[t]=r}}_convertIdToIndex(t,e){const n=Ft[e];if(n in this.idToIndexMap){const r=this.idToIndexMap[n][t];if(!Number.isFinite(r))throw new Error("gltf v1: failed to resolve ".concat(e," with id ").concat(t));return r}return t}_updateObjects(t){for(const t of this.json.buffers)delete t.type}_updateMaterial(t){for(const i of t.materials){var e,n,r;i.pbrMetallicRoughness={baseColorFactor:[1,1,1,1],metallicFactor:1,roughnessFactor:1};const o=(null===(e=i.values)||void 0===e?void 0:e.tex)||(null===(n=i.values)||void 0===n?void 0:n.texture2d_0)||(null===(r=i.values)||void 0===r?void 0:r.diffuseTex),a=t.textures.findIndex(t=>t.id===o);-1!==a&&(i.pbrMetallicRoughness.baseColorTexture={index:a})}}}const Ut={SCALAR:1,VEC2:2,VEC3:3,VEC4:4,MAT2:4,MAT3:9,MAT4:16},Nt={5120:1,5121:1,5122:2,5123:2,5125:4,5126:4},Gt=10240,Vt=10241,Ht=10242,Wt=10243,qt=10497,Xt={magFilter:Gt,minFilter:Vt,wrapS:Ht,wrapT:Wt},Zt={[Gt]:9729,[Vt]:9986,[Ht]:qt,[Wt]:qt};class Jt{constructor(){Object(F.a)(this,"baseUri",""),Object(F.a)(this,"json",{}),Object(F.a)(this,"buffers",[]),Object(F.a)(this,"images",[])}postProcess(t,e={}){const{json:n,buffers:r=[],images:i=[],baseUri:o=""}=t;return D(n),this.baseUri=o,this.json=n,this.buffers=r,this.images=i,this._resolveTree(this.json,e),this.json}_resolveTree(t,e={}){t.bufferViews&&(t.bufferViews=t.bufferViews.map((t,e)=>this._resolveBufferView(t,e))),t.images&&(t.images=t.images.map((t,e)=>this._resolveImage(t,e))),t.samplers&&(t.samplers=t.samplers.map((t,e)=>this._resolveSampler(t,e))),t.textures&&(t.textures=t.textures.map((t,e)=>this._resolveTexture(t,e))),t.accessors&&(t.accessors=t.accessors.map((t,e)=>this._resolveAccessor(t,e))),t.materials&&(t.materials=t.materials.map((t,e)=>this._resolveMaterial(t,e))),t.meshes&&(t.meshes=t.meshes.map((t,e)=>this._resolveMesh(t,e))),t.nodes&&(t.nodes=t.nodes.map((t,e)=>this._resolveNode(t,e))),t.skins&&(t.skins=t.skins.map((t,e)=>this._resolveSkin(t,e))),t.scenes&&(t.scenes=t.scenes.map((t,e)=>this._resolveScene(t,e))),void 0!==t.scene&&(t.scene=t.scenes[this.json.scene])}getScene(t){return this._get("scenes",t)}getNode(t){return this._get("nodes",t)}getSkin(t){return this._get("skins",t)}getMesh(t){return this._get("meshes",t)}getMaterial(t){return this._get("materials",t)}getAccessor(t){return this._get("accessors",t)}getCamera(t){return null}getTexture(t){return this._get("textures",t)}getSampler(t){return this._get("samplers",t)}getImage(t){return this._get("images",t)}getBufferView(t){return this._get("bufferViews",t)}getBuffer(t){return this._get("buffers",t)}_get(t,e){if("object"==typeof e)return e;const n=this.json[t]&&this.json[t][e];return n||console.warn("glTF file error: Could not find ".concat(t,"[").concat(e,"]")),n}_resolveScene(t,e){return t.id=t.id||"scene-".concat(e),t.nodes=(t.nodes||[]).map(t=>this.getNode(t)),t}_resolveNode(t,e){return t.id=t.id||"node-".concat(e),t.children&&(t.children=t.children.map(t=>this.getNode(t))),void 0!==t.mesh?t.mesh=this.getMesh(t.mesh):void 0!==t.meshes&&t.meshes.length&&(t.mesh=t.meshes.reduce((t,e)=>{const n=this.getMesh(e);return t.id=n.id,t.primitives=t.primitives.concat(n.primitives),t},{primitives:[]})),void 0!==t.camera&&(t.camera=this.getCamera(t.camera)),void 0!==t.skin&&(t.skin=this.getSkin(t.skin)),t}_resolveSkin(t,e){return t.id=t.id||"skin-".concat(e),t.inverseBindMatrices=this.getAccessor(t.inverseBindMatrices),t}_resolveMesh(t,e){return t.id=t.id||"mesh-".concat(e),t.primitives&&(t.primitives=t.primitives.map(t=>{const e=(t={...t}).attributes;t.attributes={};for(const n in e)t.attributes[n]=this.getAccessor(e[n]);return void 0!==t.indices&&(t.indices=this.getAccessor(t.indices)),void 0!==t.material&&(t.material=this.getMaterial(t.material)),t})),t}_resolveMaterial(t,e){if(t.id=t.id||"material-".concat(e),t.normalTexture&&(t.normalTexture={...t.normalTexture},t.normalTexture.texture=this.getTexture(t.normalTexture.index)),t.occlusionTexture&&(t.occlustionTexture={...t.occlustionTexture},t.occlusionTexture.texture=this.getTexture(t.occlusionTexture.index)),t.emissiveTexture&&(t.emmisiveTexture={...t.emmisiveTexture},t.emissiveTexture.texture=this.getTexture(t.emissiveTexture.index)),t.emissiveFactor||(t.emissiveFactor=t.emmisiveTexture?[1,1,1]:[0,0,0]),t.pbrMetallicRoughness){t.pbrMetallicRoughness={...t.pbrMetallicRoughness};const e=t.pbrMetallicRoughness;e.baseColorTexture&&(e.baseColorTexture={...e.baseColorTexture},e.baseColorTexture.texture=this.getTexture(e.baseColorTexture.index)),e.metallicRoughnessTexture&&(e.metallicRoughnessTexture={...e.metallicRoughnessTexture},e.metallicRoughnessTexture.texture=this.getTexture(e.metallicRoughnessTexture.index))}return t}_resolveAccessor(t,e){var n,r;if(t.id=t.id||"accessor-".concat(e),void 0!==t.bufferView&&(t.bufferView=this.getBufferView(t.bufferView)),t.bytesPerComponent=(n=t.componentType,Nt[n]),t.components=(r=t.type,Ut[r]),t.bytesPerElement=t.bytesPerComponent*t.components,t.bufferView){const e=t.bufferView.buffer,{ArrayType:n,byteLength:r}=J(t,t.bufferView),i=(t.bufferView.byteOffset||0)+(t.byteOffset||0)+e.byteOffset;let o=e.arrayBuffer.slice(i,i+r);t.bufferView.byteStride&&(o=this._getValueFromInterleavedBuffer(e,i,t.bufferView.byteStride,t.bytesPerElement,t.count)),t.value=new n(o)}return t}_getValueFromInterleavedBuffer(t,e,n,r,i){const o=new Uint8Array(i*r);for(let a=0;a<i;a++){const i=e+a*n;o.set(new Uint8Array(t.arrayBuffer.slice(i,i+r)),a*r)}return o.buffer}_resolveTexture(t,e){return t.id=t.id||"texture-".concat(e),t.sampler="sampler"in t?this.getSampler(t.sampler):Zt,t.source=this.getImage(t.source),t}_resolveSampler(t,e){t.id=t.id||"sampler-".concat(e),t.parameters={};for(const e in t){const n=this._enumSamplerParameter(e);void 0!==n&&(t.parameters[n]=t[e])}return t}_enumSamplerParameter(t){return Xt[t]}_resolveImage(t,e){t.id=t.id||"image-".concat(e),void 0!==t.bufferView&&(t.bufferView=this.getBufferView(t.bufferView));const n=this.images[e];return n&&(t.image=n),t}_resolveBufferView(t,e){const n=t.buffer,r={id:"bufferView-".concat(e),...t,buffer:this.buffers[n]},i=this.buffers[n].arrayBuffer;let o=this.buffers[n].byteOffset||0;return"byteOffset"in t&&(o+=t.byteOffset),r.data=new Uint8Array(i,o,t.byteLength),r}_resolveCamera(t,e){return t.id=t.id||"camera-".concat(e),t.perspective,t.orthographic,t}}var Qt=n(106);const Kt=1735152710;function Yt(t,e=0,n={}){const r=new DataView(t),{magic:i=Kt}=n,o=r.getUint32(e,!1);return o===i||o===Kt}function $t(t,e,n=0,r={}){const i=new DataView(e),o=function(t,e=0){return"".concat(String.fromCharCode(t.getUint8(e+0))).concat(String.fromCharCode(t.getUint8(e+1))).concat(String.fromCharCode(t.getUint8(e+2))).concat(String.fromCharCode(t.getUint8(e+3)))}(i,n+0),a=i.getUint32(n+4,!0),s=i.getUint32(n+8,!0);switch(Object.assign(t,{header:{byteOffset:n,byteLength:s,hasBinChunk:!1},type:o,version:a,json:{},binChunks:[]}),n+=12,t.version){case 1:return function(t,e,n){Object(Qt.a)(t.header.byteLength>20);const r=e.getUint32(n+0,!0),i=e.getUint32(n+4,!0);return n+=8,Object(Qt.a)(0===i),te(t,e,n,r),n+=r,n+=ee(t,e,n,t.header.byteLength)}(t,i,n);case 2:return function(t,e,n,r){return Object(Qt.a)(t.header.byteLength>20),function(t,e,n,r){for(;n+8<=t.header.byteLength;){const i=e.getUint32(n+0,!0),o=e.getUint32(n+4,!0);switch(n+=8,o){case 1313821514:te(t,e,n,i);break;case 5130562:ee(t,e,n,i);break;case 0:r.strict||te(t,e,n,i);break;case 1:r.strict||ee(t,e,n,i)}n+=Object(U.b)(i,4)}}(t,e,n,r),n+t.header.byteLength}(t,i,n,{});default:throw new Error("Invalid GLB version ".concat(t.version,". Only supports v1 and v2."))}}function te(t,e,n,r){const i=new Uint8Array(e.buffer,n,r),o=new TextDecoder("utf8").decode(i);return t.json=JSON.parse(o),Object(U.b)(r,4)}function ee(t,e,n,r){return t.header.hasBinChunk=!0,t.binChunks.push({byteOffset:n,byteLength:r,arrayBuffer:e.buffer}),Object(U.b)(r,4)}async function ne(t,e,n=0,r,i){var o,a,s,u;!function(t,e,n,r){r.uri&&(t.baseUri=r.uri);if(e instanceof ArrayBuffer&&!Yt(e,n,r)){const t=new TextDecoder;e=t.decode(e)}if("string"==typeof e)t.json=Object(R.a)(e);else if(e instanceof ArrayBuffer){const i={};n=$t(i,e,n,r.glb),D("glTF"===i.type,"Invalid GLB magic string ".concat(i.type)),t._glb=i,t.json=i.json}else D(!1,"GLTF: must be ArrayBuffer or string");const i=t.json.buffers||[];if(t.buffers=new Array(i.length).fill(null),t._glb&&t._glb.header.hasBinChunk){const{binChunks:e}=t._glb;t.buffers[0]={arrayBuffer:e[0].arrayBuffer,byteOffset:e[0].byteOffset,byteLength:e[0].byteLength}}const o=t.json.images||[];t.images=new Array(o.length).fill({})}(t,e,n,r),function(t,e={}){(new zt).normalize(t,e)}(t,{normalize:null==r||null===(o=r.gltf)||void 0===o?void 0:o.normalize}),function(t,e={},n){const r=Dt.filter(t=>Lt(t.name,e));for(const o of r){var i;null===(i=o.preprocess)||void 0===i||i.call(o,t,e,n)}}(t,r,i);const c=[];if(null!=r&&null!==(a=r.gltf)&&void 0!==a&&a.loadBuffers&&t.json.buffers&&await async function(t,e,n){const r=t.json.buffers||[];for(let a=0;a<r.length;++a){const s=r[a];if(s.uri){var i,o;const{fetch:r}=n;D(r);const u=L(s.uri,e),c=await(null==n||null===(i=n.fetch)||void 0===i?void 0:i.call(n,u)),l=await(null==c||null===(o=c.arrayBuffer)||void 0===o?void 0:o.call(c));t.buffers[a]={arrayBuffer:l,byteOffset:0,byteLength:l.byteLength},delete s.uri}else null===t.buffers[a]&&(t.buffers[a]={arrayBuffer:new ArrayBuffer(s.byteLength),byteOffset:0,byteLength:s.byteLength})}}(t,r,i),null!=r&&null!==(s=r.gltf)&&void 0!==s&&s.loadImages){const e=async function(t,e,n){const r=function(t){const e=new Set,n=t.json.textures||[];for(const t of n)void 0!==t.source&&e.add(t.source);return Array.from(e).sort()}(t),i=t.json.images||[],o=[];for(const a of r)o.push(re(t,i[a],a,e,n));return await Promise.all(o)}(t,r,i);c.push(e)}const l=async function(t,e={},n){const r=Dt.filter(t=>Lt(t.name,e));for(const o of r){var i;await(null===(i=o.decode)||void 0===i?void 0:i.call(o,t,e,n))}}(t,r,i);return c.push(l),await Promise.all(c),null!=r&&null!==(u=r.gltf)&&void 0!==u&&u.postProcess?function(t,e){return(new Jt).postProcess(t,e)}(t,r):t}async function re(t,e,n,r,i){const{fetch:o,parse:a}=i;let s;if(e.uri&&!e.hasOwnProperty("bufferView")){const t=L(e.uri,r),n=await o(t);s=await n.arrayBuffer()}if(Number.isFinite(e.bufferView)){const n=j(t.json,t.buffers,e.bufferView);s=Object(k.c)(n.buffer,n.byteOffset,n.byteLength)}D(s,"glTF image has no data");let u=await a(s,[B.a,I],{mimeType:e.mimeType,basis:r.basis||{format:P()}},i);u&&u[0]&&(u={compressed:!0,mipmaps:!1,width:u[0].width,height:u[0].height,data:u[0]}),t.images=t.images||[],t.images[n]=u}n.d(e,"a",(function(){return ie}));const ie={name:"glTF",id:"gltf",module:"gltf",version:"3.2.10",extensions:["gltf","glb"],mimeTypes:["model/gltf+json","model/gltf-binary"],text:!0,binary:!0,tests:["glTF"],parse:async function(t,e={},n){(e={...ie.options,...e}).gltf={...ie.options.gltf,...e.gltf};const{byteOffset:r=0}=e;return await ne({},t,r,e,n)},options:{gltf:{normalize:!0,loadBuffers:!0,loadImages:!0,decompressMeshes:!0,postProcess:!0},log:console},deprecatedOptions:{fetchImages:"gltf.loadImages",createImages:"gltf.loadImages",decompress:"gltf.decompressMeshes",postProcess:"gltf.postProcess",gltf:{decompress:"gltf.decompressMeshes"}}}},function(t,e,n){"use strict";var r=n(106),i=n(72);const{_parseImageNode:o}=globalThis,a="undefined"!=typeof Image,s="undefined"!=typeof ImageBitmap,u=Boolean(o),c=!!i.c||u;function l(t){const e=f(t);if(!e)throw new Error("Not an image");return e}function h(t){switch(l(t)){case"data":return t;case"image":case"imagebitmap":const e=document.createElement("canvas"),n=e.getContext("2d");if(!n)throw new Error("getImageData");return e.width=t.width,e.height=t.height,n.drawImage(t,0,0),n.getImageData(0,0,t.width,t.height);default:throw new Error("getImageData")}}function f(t){return"undefined"!=typeof ImageBitmap&&t instanceof ImageBitmap?"imagebitmap":"undefined"!=typeof Image&&t instanceof Image?"image":t&&"object"==typeof t&&t.data&&t.width&&t.height?"data":null}const p=/^data:image\/svg\+xml/,d=/\.svg((\?|#).*)?$/;function A(t){return t&&(p.test(t)||d.test(t))}function g(t,e){if(A(e))throw new Error("SVG cannot be parsed directly to imagebitmap");return new Blob([new Uint8Array(t)])}async function m(t,e,n){const r=function(t,e){if(A(e)){let e=(new TextDecoder).decode(t);try{"function"==typeof unescape&&"function"==typeof encodeURIComponent&&(e=unescape(encodeURIComponent(e)))}catch(t){throw new Error(t.message)}return"data:image/svg+xml;base64,".concat(btoa(e))}return g(t,e)}(t,n),i=self.URL||self.webkitURL,o="string"!=typeof r&&i.createObjectURL(r);try{return await async function(t,e){const n=new Image;if(n.src=t,e.image&&e.image.decode&&n.decode)return await n.decode(),n;return await new Promise((e,r)=>{try{n.onload=()=>e(n),n.onerror=e=>r(new Error("Could not load image ".concat(t,": ").concat(e)))}catch(t){r(t)}})}(o||r,e)}finally{o&&i.revokeObjectURL(o)}}const y={};let v=!0;async function _(t,e,n){let r;if(A(n)){r=await m(t,e,n)}else r=g(t,n);const i=e&&e.imagebitmap;return await async function(t,e=null){!function(t){for(const e in t||y)return!1;return!0}(e)&&v||(e=null);if(e)try{return await createImageBitmap(t,e)}catch(t){console.warn(t),v=!1}return await createImageBitmap(t)}(r,i)}var b=n(181);n.d(e,"a",(function(){return x}));const x={id:"image",module:"images",name:"Images",version:"3.2.10",mimeTypes:["image/png","image/jpeg","image/gif","image/webp","image/bmp","image/vnd.microsoft.icon","image/svg+xml"],extensions:["png","jpg","jpeg","gif","webp","bmp","ico","svg"],parse:async function(t,e,n){const i=((e=e||{}).image||{}).type||"auto",{url:o}=n||{};let u;switch(function(t){switch(t){case"auto":case"data":return function(){if(s)return"imagebitmap";if(a)return"image";if(c)return"data";throw new Error("Install '@loaders.gl/polyfills' to parse images under Node.js")}();default:return function(t){switch(t){case"auto":return s||a||c;case"imagebitmap":return s;case"image":return a;case"data":return c;default:throw new Error("@loaders.gl/images: image ".concat(t," not supported in this environment"))}}(t),t}}(i)){case"imagebitmap":u=await _(t,e,o);break;case"image":u=await m(t,e,o);break;case"data":u=await async function(t,e){const{mimeType:n}=Object(b.a)(t)||{},i=globalThis._parseImageNode;return Object(r.a)(i),await i(t,n)}(t);break;default:Object(r.a)(!1)}return"data"===i&&(u=h(u)),u},tests:[t=>Boolean(Object(b.a)(new DataView(t)))],options:{image:{type:"auto",decode:!0}}}},function(t,e,n){"use strict";var r=n(38),i=n(54),o=n(74),a=n(7),s=n(109),u=n(10);const c={5126:w.bind(null,"uniform1fv",A,1,E),35664:w.bind(null,"uniform2fv",A,2,E),35665:w.bind(null,"uniform3fv",A,3,E),35666:w.bind(null,"uniform4fv",A,4,E),5124:w.bind(null,"uniform1iv",g,1,E),35667:w.bind(null,"uniform2iv",g,2,E),35668:w.bind(null,"uniform3iv",g,3,E),35669:w.bind(null,"uniform4iv",g,4,E),35670:w.bind(null,"uniform1iv",g,1,E),35671:w.bind(null,"uniform2iv",g,2,E),35672:w.bind(null,"uniform3iv",g,3,E),35673:w.bind(null,"uniform4iv",g,4,E),35674:w.bind(null,"uniformMatrix2fv",A,4,O),35675:w.bind(null,"uniformMatrix3fv",A,9,O),35676:w.bind(null,"uniformMatrix4fv",A,16,O),35678:x,35680:x,5125:w.bind(null,"uniform1uiv",m,1,E),36294:w.bind(null,"uniform2uiv",m,2,E),36295:w.bind(null,"uniform3uiv",m,3,E),36296:w.bind(null,"uniform4uiv",m,4,E),35685:w.bind(null,"uniformMatrix2x3fv",A,6,O),35686:w.bind(null,"uniformMatrix2x4fv",A,8,O),35687:w.bind(null,"uniformMatrix3x2fv",A,6,O),35688:w.bind(null,"uniformMatrix3x4fv",A,12,O),35689:w.bind(null,"uniformMatrix4x2fv",A,8,O),35690:w.bind(null,"uniformMatrix4x3fv",A,12,O),35678:x,35680:x,35679:x,35682:x,36289:x,36292:x,36293:x,36298:x,36299:x,36300:x,36303:x,36306:x,36307:x,36308:x,36311:x},l={},h={},f={},p=[0];function d(t,e,n,r){1===e&&"boolean"==typeof t&&(t=t?1:0),Number.isFinite(t)&&(p[0]=t,t=p);const i=t.length;if(i%e&&a.k.warn("Uniform size should be multiples of ".concat(e),t)(),t instanceof n)return t;let o=r[i];o||(o=new n(i),r[i]=o);for(let e=0;e<i;e++)o[e]=t[e];return o}function A(t,e){return d(t,e,Float32Array,l)}function g(t,e){return d(t,e,Int32Array,h)}function m(t,e){return d(t,e,Uint32Array,f)}function y(t,e,n){const r=c[n.type];if(!r)throw new Error("Unknown GLSL uniform type ".concat(n.type));return r().bind(null,t,e)}function v(t){if("]"!==t[t.length-1])return{name:t,length:1,isArray:!1};const e=t.match(/([^[]*)(\[[0-9]+\])?/);if(!e||e.length<2)throw new Error("Failed to parse GLSL uniform name ".concat(t));return{name:e[1],length:e[2]||1,isArray:Boolean(e[2])}}function _(t){return Array.isArray(t)||ArrayBuffer.isView(t)?function(t){if(0===t.length)return!1;const e=Math.min(t.length,16);for(let n=0;n<e;++n)if(!Number.isFinite(t[n]))return!1;return!0}(t):!!isFinite(t)||(!0===t||!1===t||(t instanceof i.a||(t instanceof s.a||t instanceof o.a&&Boolean(t.texture))))}function b(t,e,n){if(Array.isArray(n)||ArrayBuffer.isView(n))if(t[e]){const r=t[e];for(let t=0,e=n.length;t<e;++t)r[t]=n[t]}else t[e]=n.slice();else t[e]=n}function x(){let t=null;return(e,n,r)=>{const i=t!==r;return i&&(e.uniform1i(n,r),t=r),i}}function w(t,e,n,r){let i=null,o=null;return(a,s,c)=>{const l=e(c,n),h=l.length;let f=!1;if(null===i)i=new Float32Array(h),o=h,f=!0;else{Object(u.a)(o===h,"Uniform length cannot change.");for(let t=0;t<h;++t)if(l[t]!==i[t]){f=!0;break}}return f&&(r(a,t,s,l),i.set(l)),f}}function E(t,e,n,r){t[e](n,r)}function O(t,e,n,r){t[e](n,!1,r)}function S(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:"unnamed";const n=/#define[\s*]SHADER_NAME[\s*]([A-Za-z0-9_-]+)[\s*]/,r=t.match(n);return r?r[1]:e}function T(t,e,n,r){const i=t.split(/\r?\n/),o={},a={},s=r||S(e)||"(unnamed)",u="".concat(function(t){switch(t){case 35632:return"fragment";case 35633:return"vertex";default:return"unknown type"}}(n)," shader ").concat(s);for(let e=0;e<i.length;e++){const n=i[e];if(n.length<=1)continue;const r=n.split(":"),s=r[0],c=parseInt(r[2],10);if(isNaN(c))throw new Error("GLSL compilation error in ".concat(u,": ").concat(t));"WARNING"!==s?o[c]=n:a[c]=n}const c=function(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:1,n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:": ";const r=t.split(/\r?\n/),i=String(r.length+e-1).length;return r.map((t,r)=>{const o=String(r+e),a=o.length;return P(o,i-a)+n+t})}(e);return{shaderName:u,errors:C(o,c),warnings:C(a,c)}}function C(t,e){let n="";for(let r=0;r<e.length;r++){const i=e[r];if((t[r+3]||t[r+2]||t[r+1])&&(n+="".concat(i,"\n"),t[r+1])){const e=t[r+1],i=e.split(":",3),o=i[0],a=parseInt(i[1],10)||0,s=e.substring(i.join(":").length+1).trim();n+=P("^^^ ".concat(o,": ").concat(s,"\n\n"),a)}}return n}function P(t,e){let n="";for(let t=0;t<e;++t)n+=" ";return"".concat(n).concat(t)}var M=n(47);class I extends r.a{get[Symbol.toStringTag](){return"Shader"}static getTypeName(t){switch(t){case 35633:return"vertex-shader";case 35632:return"fragment-shader";default:return Object(u.a)(!1),"unknown"}}constructor(t,e){Object(a.b)(t),Object(u.a)("string"==typeof e.source,"Shader: GLSL source code must be a JavaScript string");super(t,{id:S(e.source,null)||e.id||Object(M.c)("unnamed ".concat(I.getTypeName(e.shaderType)))}),this.shaderType=e.shaderType,this.source=e.source,this.initialize(e)}initialize(t){let{source:e}=t;const n=S(e,null);n&&(this.id=Object(M.c)(n)),this._compile(e)}getParameter(t){return this.gl.getShaderParameter(this.handle,t)}toString(){return"".concat(I.getTypeName(this.shaderType),":").concat(this.id)}getName(){return S(this.source)||"unnamed-shader"}getSource(){return this.gl.getShaderSource(this.handle)}getTranslatedSource(){const t=this.gl.getExtension("WEBGL_debug_shaders");return t?t.getTranslatedShaderSource(this.handle):"No translated source available. WEBGL_debug_shaders not implemented"}_compile(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:this.source;t.startsWith("#version ")||(t="#version 100\n".concat(t)),this.source=t,this.gl.shaderSource(this.handle,this.source),this.gl.compileShader(this.handle);if(!this.getParameter(35713)){const t=this.gl.getShaderInfoLog(this.handle),{shaderName:e,errors:n,warnings:r}=T(t,this.source,this.shaderType,this.id);throw a.k.error("GLSL compilation errors in ".concat(e,"\n").concat(n))(),a.k.warn("GLSL compilation warnings in ".concat(e,"\n").concat(r))(),new Error("GLSL compilation errors in ".concat(e))}}_deleteHandle(){this.gl.deleteShader(this.handle)}_getOptsFromHandle(){return{type:this.getParameter(35663),source:this.getSource()}}}class B extends I{get[Symbol.toStringTag](){return"VertexShader"}constructor(t,e){"string"==typeof e&&(e={source:e}),super(t,Object.assign({},e,{shaderType:35633}))}_createHandle(){return this.gl.createShader(35633)}}class R extends I{get[Symbol.toStringTag](){return"FragmentShader"}constructor(t,e){"string"==typeof e&&(e={source:e}),super(t,Object.assign({},e,{shaderType:35632}))}_createHandle(){return this.gl.createShader(35632)}}var k=n(63),D=n(81);class L{constructor(t){this.id=t.id,this.attributeInfos=[],this.attributeInfosByName={},this.attributeInfosByLocation=[],this.varyingInfos=[],this.varyingInfosByName={},Object.seal(this),this._readAttributesFromProgram(t),this._readVaryingsFromProgram(t)}getAttributeInfo(t){const e=Number(t);return Number.isFinite(e)?this.attributeInfosByLocation[e]:this.attributeInfosByName[t]||null}getAttributeLocation(t){const e=this.getAttributeInfo(t);return e?e.location:-1}getAttributeAccessor(t){const e=this.getAttributeInfo(t);return e?e.accessor:null}getVaryingInfo(t){const e=Number(t);return Number.isFinite(e)?this.varyingInfos[e]:this.varyingInfosByName[t]||null}getVaryingIndex(t){const e=this.getVaryingInfo();return e?e.location:-1}getVaryingAccessor(t){const e=this.getVaryingInfo();return e?e.accessor:null}_readAttributesFromProgram(t){const{gl:e}=t,n=e.getProgramParameter(t.handle,35721);for(let r=0;r<n;r++){const{name:n,type:i,size:o}=e.getActiveAttrib(t.handle,r),a=e.getAttribLocation(t.handle,n);a>=0&&this._addAttribute(a,n,i,o)}this.attributeInfos.sort((t,e)=>t.location-e.location)}_readVaryingsFromProgram(t){const{gl:e}=t;if(!Object(a.j)(e))return;const n=e.getProgramParameter(t.handle,35971);for(let r=0;r<n;r++){const{name:n,type:i,size:o}=e.getTransformFeedbackVarying(t.handle,r);this._addVarying(r,n,i,o)}this.varyingInfos.sort((t,e)=>t.location-e.location)}_addAttribute(t,e,n,r){const{type:i,components:o}=Object(D.a)(n),a={type:i,size:r*o};this._inferProperties(t,e,a);const s={location:t,name:e,accessor:new k.a(a)};this.attributeInfos.push(s),this.attributeInfosByLocation[t]=s,this.attributeInfosByName[s.name]=s}_inferProperties(t,e,n){/instance/i.test(e)&&(n.divisor=1)}_addVarying(t,e,n,r){const{type:i,components:o}=Object(D.a)(n),a={location:t,name:e,accessor:new k.a({type:i,size:r*o})};this.varyingInfos.push(a),this.varyingInfosByName[a.name]=a}}var j=n(48);n.d(e,"a",(function(){return U}));const F=35981,z=["setVertexArray","setAttributes","setBuffers","unsetBuffers","use","getUniformCount","getUniformInfo","getUniformLocation","getUniformValue","getVarying","getFragDataLocation","getAttachedShaders","getAttributeCount","getAttributeLocation","getAttributeInfo"];class U extends r.a{get[Symbol.toStringTag](){return"Program"}constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};super(t,e),this.stubRemovedMethods("Program","v6.0",z),this._isCached=!1,this.initialize(e),Object.seal(this),this._setId(e.id)}initialize(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{hash:e,vs:n,fs:r,varyings:i,bufferMode:o=F}=t;return this.hash=e||"",this.vs="string"==typeof n?new B(this.gl,{id:"".concat(t.id,"-vs"),source:n}):n,this.fs="string"==typeof r?new R(this.gl,{id:"".concat(t.id,"-fs"),source:r}):r,Object(u.a)(this.vs instanceof B),Object(u.a)(this.fs instanceof R),this.uniforms={},this._textureUniforms={},i&&i.length>0&&(Object(a.a)(this.gl),this.varyings=i,this.gl2.transformFeedbackVaryings(this.handle,i,o)),this._compileAndLink(),this._readUniformLocationsFromLinkedProgram(),this.configuration=new L(this),this.setProps(t)}delete(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};return this._isCached?this:super.delete(t)}setProps(t){return"uniforms"in t&&this.setUniforms(t.uniforms),this}draw(t){let{logPriority:e,drawMode:n=4,vertexCount:r,offset:i=0,start:o,end:s,isIndexed:c=!1,indexType:l=5123,instanceCount:h=0,isInstanced:f=h>0,vertexArray:p=null,transformFeedback:d,framebuffer:A,parameters:g={},uniforms:m,samplers:y}=t;if((m||y)&&(a.k.deprecated("Program.draw({uniforms})","Program.setUniforms(uniforms)")(),this.setUniforms(m||{})),a.k.priority>=e){const t=A?A.id:"default",i="mode=".concat(Object(j.a)(this.gl,n)," verts=").concat(r," ")+"instances=".concat(h," indexType=").concat(Object(j.a)(this.gl,l)," ")+"isInstanced=".concat(f," isIndexed=").concat(c," ")+"Framebuffer=".concat(t);a.k.log(e,i)()}return Object(u.a)(p),this.gl.useProgram(this.handle),!(!this._areTexturesRenderable()||0===r||f&&0===h)&&(p.bindForDraw(r,h,()=>{if(void 0!==A&&(g=Object.assign({},g,{framebuffer:A})),d){const t=Object(D.c)(n);d.begin(t)}this._bindTextures(),Object(a.o)(this.gl,g,()=>{c&&f?this.gl2.drawElementsInstanced(n,r,l,i,h):c&&Object(a.j)(this.gl)&&!isNaN(o)&&!isNaN(s)?this.gl2.drawRangeElements(n,o,s,r,l,i):c?this.gl.drawElements(n,r,l,i):f?this.gl2.drawArraysInstanced(n,i,r,h):this.gl.drawArrays(n,i,r)}),d&&d.end()}),!0)}setUniforms(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};a.k.priority>=2&&function(t,e,n){for(const r in t){const i=t[r];if((!n||Boolean(n[r]))&&!_(i))throw e=e?"".concat(e," "):"",console.error("".concat(e," Bad uniform ").concat(r),i),new Error("".concat(e," Bad uniform ").concat(r))}}(t,this.id,this._uniformSetters),this.gl.useProgram(this.handle);for(const e in t){const n=t[e],r=this._uniformSetters[e];if(r){let t=n,a=!1;if(t instanceof o.a&&(t=t.texture),t instanceof i.a)if(a=this.uniforms[e]!==n,a){void 0===r.textureIndex&&(r.textureIndex=this._textureIndexCounter++);const n=t,{textureIndex:i}=r;n.bind(i),t=i,this._textureUniforms[e]=n}else t=r.textureIndex;else this._textureUniforms[e]&&delete this._textureUniforms[e];(r(t)||a)&&b(this.uniforms,e,n)}}return this}_areTexturesRenderable(){let t=!0;for(const e in this._textureUniforms){const n=this._textureUniforms[e];n.update(),t=t&&n.loaded}return t}_bindTextures(){for(const t in this._textureUniforms){const e=this._uniformSetters[t].textureIndex;this._textureUniforms[t].bind(e)}}_createHandle(){return this.gl.createProgram()}_deleteHandle(){this.gl.deleteProgram(this.handle)}_getOptionsFromHandle(t){const e=this.gl.getAttachedShaders(t),n={};for(const t of e){switch(this.gl.getShaderParameter(this.handle,35663)){case 35633:n.vs=new B({handle:t});break;case 35632:n.fs=new R({handle:t})}}return n}_getParameter(t){return this.gl.getProgramParameter(this.handle,t)}_setId(t){if(!t){const t=this._getName();this.id=Object(M.c)(t)}}_getName(){let t=this.vs.getName()||this.fs.getName();return t=t.replace(/shader/i,""),t=t?"".concat(t,"-program"):"program",t}_compileAndLink(){const{gl:t}=this;if(t.attachShader(this.handle,this.vs.handle),t.attachShader(this.handle,this.fs.handle),a.k.time(4,"linkProgram for ".concat(this._getName()))(),t.linkProgram(this.handle),a.k.timeEnd(4,"linkProgram for ".concat(this._getName()))(),t.debug||a.k.level>0){if(!t.getProgramParameter(this.handle,35714))throw new Error("Error linking: ".concat(t.getProgramInfoLog(this.handle)));t.validateProgram(this.handle);if(!t.getProgramParameter(this.handle,35715))throw new Error("Error validating: ".concat(t.getProgramInfoLog(this.handle)))}}_readUniformLocationsFromLinkedProgram(){const{gl:t}=this;this._uniformSetters={},this._uniformCount=this._getParameter(35718);for(let e=0;e<this._uniformCount;e++){const n=this.gl.getActiveUniform(this.handle,e),{name:r}=v(n.name);let i=t.getUniformLocation(this.handle,r);if(this._uniformSetters[r]=y(t,i,n),n.size>1)for(let e=0;e<n.size;e++)i=t.getUniformLocation(this.handle,"".concat(r,"[").concat(e,"]")),this._uniformSetters["".concat(r,"[").concat(e,"]")]=y(t,i,n)}this._textureIndexCounter=0}getActiveUniforms(t,e){return this.gl2.getActiveUniforms(this.handle,t,e)}getUniformBlockIndex(t){return this.gl2.getUniformBlockIndex(this.handle,t)}getActiveUniformBlockParameter(t,e){return this.gl2.getActiveUniformBlockParameter(this.handle,t,e)}uniformBlockBinding(t,e){this.gl2.uniformBlockBinding(this.handle,t,e)}}},function(t,e,n){"use strict";var r=n(187);const i="void main() {gl_FragColor = vec4(0);}",o="out vec4 transform_output;\nvoid main() {\n  transform_output = vec4(0);\n}",a="#version 300 es\n".concat(o);function s(t,e){e=Array.isArray(e)?e:[e];const n=t.replace(/^\s+/,"").split(/\s+/),[r,i,o]=n;if(!e.includes(r)||!i||!o)return null;return{qualifier:r,type:i,name:o.split(";")[0]}}function u(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{version:e=100,input:n,inputType:r,output:s}=t;if(!n)return 300===e?a:e>300?"#version ".concat(e,"\n").concat(o):i;const u=c(n,r);return e>=300?"#version ".concat(e," ").concat(300===e?"es":"","\nin ").concat(r," ").concat(n,";\nout vec4 ").concat(s,";\nvoid main() {\n  ").concat(s," = ").concat(u,";\n}"):"varying ".concat(r," ").concat(n,";\nvoid main() {\n  gl_FragColor = ").concat(u,";\n}")}function c(t,e){switch(e){case"float":return"vec4(".concat(t,", 0.0, 0.0, 1.0)");case"vec2":return"vec4(".concat(t,", 0.0, 1.0)");case"vec3":return"vec4(".concat(t,", 1.0)");case"vec4":return t;default:return Object(r.a)(!1),null}}var l=n(7),h=n(33),f=n(314),p=n(10);class d{constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};this.gl=t,this.currentIndex=0,this.feedbackMap={},this.varyings=null,this.bindings=[],this.resources={},this._initialize(e),Object.seal(this)}setupResources(t){for(const e of this.bindings)this._setupTransformFeedback(e,t)}updateModelProps(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{varyings:e}=this;return e.length>0&&(t=Object.assign({},t,{varyings:e})),t}getDrawOptions(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const e=this.bindings[this.currentIndex],{sourceBuffers:n,transformFeedback:r}=e;return{attributes:Object.assign({},n,t.attributes),transformFeedback:r}}swap(){return!!this.feedbackMap&&(this.currentIndex=this._getNextIndex(),!0)}update(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};this._setupBuffers(t)}getBuffer(t){const{feedbackBuffers:e}=this.bindings[this.currentIndex],n=t?e[t]:null;return n?n instanceof h.a?n:n.buffer:null}getData(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{varyingName:e}=t,n=this.getBuffer(e);return n?n.getData():null}delete(){for(const t in this.resources)this.resources[t].delete()}_initialize(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};this._setupBuffers(t),this.varyings=t.varyings||Object.keys(this.bindings[this.currentIndex].feedbackBuffers),this.varyings.length>0&&Object(p.a)(Object(l.j)(this.gl))}_getFeedbackBuffers(t){const{sourceBuffers:e={}}=t,n={};if(this.bindings[this.currentIndex]&&Object.assign(n,this.bindings[this.currentIndex].feedbackBuffers),this.feedbackMap)for(const t in this.feedbackMap){const r=this.feedbackMap[t];t in e&&(n[r]=t)}Object.assign(n,t.feedbackBuffers);for(const t in n){const r=n[t];if("string"==typeof r){const i=e[r],{byteLength:o,usage:a,accessor:s}=i;n[t]=this._createNewBuffer(t,{byteLength:o,usage:a,accessor:s})}}return n}_setupBuffers(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{sourceBuffers:e=null}=t;Object.assign(this.feedbackMap,t.feedbackMap);const n=this._getFeedbackBuffers(t);this._updateBindings({sourceBuffers:e,feedbackBuffers:n})}_setupTransformFeedback(t,e){let{model:n}=e;const{program:r}=n;t.transformFeedback=new f.a(this.gl,{program:r,buffers:t.feedbackBuffers})}_updateBindings(t){if(this.bindings[this.currentIndex]=this._updateBinding(this.bindings[this.currentIndex],t),this.feedbackMap){const{sourceBuffers:t,feedbackBuffers:e}=this._swapBuffers(this.bindings[this.currentIndex]),n=this._getNextIndex();this.bindings[n]=this._updateBinding(this.bindings[n],{sourceBuffers:t,feedbackBuffers:e})}}_updateBinding(t,e){return t?(Object.assign(t.sourceBuffers,e.sourceBuffers),Object.assign(t.feedbackBuffers,e.feedbackBuffers),t.transformFeedback&&t.transformFeedback.setBuffers(t.feedbackBuffers),t):{sourceBuffers:Object.assign({},e.sourceBuffers),feedbackBuffers:Object.assign({},e.feedbackBuffers)}}_swapBuffers(t){if(!this.feedbackMap)return null;const e=Object.assign({},t.sourceBuffers),n=Object.assign({},t.feedbackBuffers);for(const r in this.feedbackMap){const i=this.feedbackMap[r];e[r]=t.feedbackBuffers[i],n[i]=t.sourceBuffers[r],Object(p.a)(n[i]instanceof h.a)}return{sourceBuffers:e,feedbackBuffers:n}}_createNewBuffer(t,e){const n=new h.a(this.gl,e);return this.resources[t]&&this.resources[t].delete(),this.resources[t]=n,n}_getNextIndex(){return(this.currentIndex+1)%2}}var A=n(206),g=n(107),m=n(74),y=n(236);function v(t){let e=100;const n=t.match(/[^\s]+/g);if(n.length>=2&&"#version"===n[0]){const t=parseInt(n[1],10);Number.isFinite(t)&&(e=t)}return e}var _=n(191);const b={name:"transform",vs:"attribute float transform_elementID;\nvec2 transform_getPixelSizeHalf(vec2 size) {\n  return vec2(1.) / (2. * size);\n}\n\nvec2 transform_getPixelIndices(vec2 texSize, vec2 pixelSizeHalf) {\n  float yIndex = floor((transform_elementID / texSize[0]) + pixelSizeHalf[1]);\n  float xIndex = transform_elementID - (yIndex * texSize[0]);\n  return vec2(xIndex, yIndex);\n}\nvec2 transform_getTexCoord(vec2 size) {\n  vec2 pixelSizeHalf = transform_getPixelSizeHalf(size);\n  vec2 indices = transform_getPixelIndices(size, pixelSizeHalf);\n  vec2 coord = indices / size + pixelSizeHalf;\n  return coord;\n}\nvec2 transform_getPos(vec2 size) {\n  vec2 texCoord = transform_getTexCoord(size);\n  vec2 pos = (texCoord * (2.0, 2.0)) - (1., 1.);\n  return pos;\n}\nvec4 transform_getInput(sampler2D texSampler, vec2 size) {\n  vec2 texCoord = transform_getTexCoord(size);\n  vec4 textureColor = texture2D(texSampler, texCoord);\n  return textureColor;\n}\n",fs:null};function x(t){let{vs:e,sourceTextureMap:n,targetTextureVarying:i,targetTexture:o}=t;let a=Object.keys(n).length,u=null;const c={};let l=e,h={};if(a>0||i){const t=l.split("\n"),e=t.slice();if(t.forEach((t,o,l)=>{if(a>0){const i=function(t,e){const n={},i=function(t){return s(t,["attribute","in"])}(t);if(!i)return null;const{type:o,name:a}=i;if(a&&e[a]){const e="// ".concat(t," => Replaced by Transform with a sampler"),{samplerName:i,sizeName:s,uniformDeclerations:u}=function(t){const e="".concat("transform_uSampler_").concat(t),n="".concat("transform_uSize_").concat(t),r="  uniform sampler2D ".concat(e,";\n  uniform vec2 ").concat(n,";");return{samplerName:e,sizeName:n,uniformDeclerations:r}}(a),c=function(t){switch(t){case"float":return"x";case"vec2":return"xy";case"vec3":return"xyz";case"vec4":return"xyzw";default:return Object(r.a)(!1),null}}(o),l="  ".concat(o," ").concat(a," = transform_getInput(").concat(i,", ").concat(s,").").concat(c,";\n");n[i]=a;return{updatedLine:e,inject:{"vs:#decl":u,"vs:#main-start":l},samplerTextureMap:n}}return null}(t,n);if(i){const{updatedLine:t,inject:n}=i;e[o]=t,h=Object(_.b)([h,n]),Object.assign(c,i.samplerTextureMap),a--}}i&&!u&&(u=function(t,e){const n=s(t,["varying","out"]);if(!n)return null;return n.name===e?n.type:null}(t,i))}),i){Object(p.a)(o);const t="".concat("transform_uSize_").concat(i),e={"vs:#decl":"uniform vec2 ".concat(t,";\n"),"vs:#main-start":"     vec2 ".concat("transform_position"," = transform_getPos(").concat(t,");\n     gl_Position = vec4(").concat("transform_position",", 0, 1.);\n")};h=Object(_.b)([h,e])}l=e.join("\n")}return{vs:l,targetTextureType:u,inject:h,samplerTextureMap:c}}const w={10241:9728,10240:9728,10242:33071,10243:33071};class E{constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};this.gl=t,this.id=this.currentIndex=0,this._swapTexture=null,this.targetTextureVarying=null,this.targetTextureType=null,this.samplerTextureMap=null,this.bindings=[],this.resources={},this._initialize(e),Object.seal(this)}updateModelProps(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const e=this._processVertexShader(t);return Object.assign({},t,e)}getDrawOptions(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{sourceBuffers:e,sourceTextures:n,framebuffer:r,targetTexture:i}=this.bindings[this.currentIndex],o=Object.assign({},e,t.attributes),a=Object.assign({},t.uniforms),s=Object.assign({},t.parameters);let u=t.discard;if(this.hasSourceTextures||this.hasTargetTexture){o.transform_elementID=this.elementIDBuffer;for(const t in this.samplerTextureMap){const e=this.samplerTextureMap[t];a[t]=n[e]}this._setSourceTextureParameters();const t=function(t){let{sourceTextureMap:e,targetTextureVarying:n,targetTexture:r}=t;const i={};let o,a;n&&(({width:o,height:a}=r),i["".concat("transform_uSize_").concat(n)]=[o,a]);for(const t in e)({width:o,height:a}=e[t]),i["".concat("transform_uSize_").concat(t)]=[o,a];return i}({sourceTextureMap:n,targetTextureVarying:this.targetTextureVarying,targetTexture:i});Object.assign(a,t)}return this.hasTargetTexture&&(u=!1,s.viewport=[0,0,r.width,r.height]),{attributes:o,framebuffer:r,uniforms:a,discard:u,parameters:s}}swap(){return!!this._swapTexture&&(this.currentIndex=this._getNextIndex(),!0)}update(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};this._setupTextures(t)}getTargetTexture(){const{targetTexture:t}=this.bindings[this.currentIndex];return t}getData(){let{packed:t=!1}=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{framebuffer:e}=this.bindings[this.currentIndex],n=Object(A.c)(e);if(!t)return n;const i=n.constructor,o=function(t){switch(t){case"float":return 1;case"vec2":return 2;case"vec3":return 3;case"vec4":return 4;default:return Object(r.a)(!1),null}}(this.targetTextureType),a=new i(n.length*o/4);let s=0;for(let t=0;t<n.length;t+=4)for(let e=0;e<o;e++)a[s++]=n[t+e];return a}getFramebuffer(){return this.bindings[this.currentIndex].framebuffer}delete(){this.ownTexture&&this.ownTexture.delete(),this.elementIDBuffer&&this.elementIDBuffer.delete()}_initialize(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{_targetTextureVarying:e,_swapTexture:n}=t;this._swapTexture=n,this.targetTextureVarying=e,this.hasTargetTexture=e,this._setupTextures(t)}_createTargetTexture(t){const{sourceTextures:e,textureOrReference:n}=t;if(n instanceof g.a)return n;const r=e[n];return r?(this._targetRefTexName=n,this._createNewTexture(r)):null}_setupTextures(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{sourceBuffers:e,_sourceTextures:n={},_targetTexture:r}=t,i=this._createTargetTexture({sourceTextures:n,textureOrReference:r});this.hasSourceTextures=this.hasSourceTextures||n&&Object.keys(n).length>0,this._updateBindings({sourceBuffers:e,sourceTextures:n,targetTexture:i}),"elementCount"in t&&this._updateElementIDBuffer(t.elementCount)}_updateElementIDBuffer(t){if("number"!=typeof t||this.elementCount>=t)return;const e=new Float32Array(t);e.forEach((t,e,n)=>{n[e]=e}),this.elementIDBuffer?this.elementIDBuffer.setData({data:e}):this.elementIDBuffer=new h.a(this.gl,{data:e,accessor:{size:1}}),this.elementCount=t}_updateBindings(t){if(this.bindings[this.currentIndex]=this._updateBinding(this.bindings[this.currentIndex],t),this._swapTexture){const{sourceTextures:t,targetTexture:e}=this._swapTextures(this.bindings[this.currentIndex]),n=this._getNextIndex();this.bindings[n]=this._updateBinding(this.bindings[n],{sourceTextures:t,targetTexture:e})}}_updateBinding(t,e){const{sourceBuffers:n,sourceTextures:r,targetTexture:i}=e;if(t||(t={sourceBuffers:{},sourceTextures:{},targetTexture:null}),Object.assign(t.sourceTextures,r),Object.assign(t.sourceBuffers,n),i){t.targetTexture=i;const{width:e,height:n}=i,{framebuffer:r}=t;r?(r.update({attachments:{36064:i},resizeAttachments:!1}),r.resize({width:e,height:n})):t.framebuffer=new m.a(this.gl,{id:"transform-framebuffer",width:e,height:n,attachments:{36064:i}})}return t}_setSourceTextureParameters(){const t=this.currentIndex,{sourceTextures:e}=this.bindings[t];for(const t in e)e[t].setParameters(w)}_swapTextures(t){if(!this._swapTexture)return null;const e=Object.assign({},t.sourceTextures);e[this._swapTexture]=t.targetTexture;return{sourceTextures:e,targetTexture:t.sourceTextures[this._swapTexture]}}_createNewTexture(t){const e=Object(y.a)(t,{parameters:{10241:9728,10240:9728,10242:33071,10243:33071},pixelStore:{37440:!1}});return this.ownTexture&&this.ownTexture.delete(),this.ownTexture=e,e}_getNextIndex(){return(this.currentIndex+1)%2}_processVertexShader(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{sourceTextures:e,targetTexture:n}=this.bindings[this.currentIndex],{vs:r,uniforms:i,targetTextureType:o,inject:a,samplerTextureMap:s}=x({vs:t.vs,sourceTextureMap:e,targetTextureVarying:this.targetTextureVarying,targetTexture:n}),c=Object(_.b)([t.inject||{},a]);this.targetTextureType=o,this.samplerTextureMap=s;return{vs:r,fs:t._fs||u({version:v(r),input:this.targetTextureVarying,inputType:o,output:"transform_output"}),modules:this.hasSourceTextures||this.targetTextureVarying?[b].concat(t.modules||[]):t.modules,uniforms:i,inject:c}}}var O=n(47),S=n(186);n.d(e,"a",(function(){return T}));class T{static isSupported(t){return Object(l.j)(t)}constructor(t){let e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};this.gl=t,this.model=null,this.elementCount=0,this.bufferTransform=null,this.textureTransform=null,this.elementIDBuffer=null,this._initialize(e),Object.seal(this)}delete(){const{model:t,bufferTransform:e,textureTransform:n}=this;t&&t.delete(),e&&e.delete(),n&&n.delete()}run(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{clearRenderTarget:e=!0}=t,n=this._updateDrawOptions(t);e&&n.framebuffer&&n.framebuffer.clear({color:!0}),this.model.transform(n)}swap(){let t=!1;const e=[this.bufferTransform,this.textureTransform].filter(Boolean);for(const n of e)t=t||n.swap();Object(p.a)(t,"Nothing to swap")}getBuffer(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:null;return this.bufferTransform&&this.bufferTransform.getBuffer(t)}getData(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const e=[this.bufferTransform,this.textureTransform].filter(Boolean);for(const n of e){const e=n.getData(t);if(e)return e}return null}getFramebuffer(){return this.textureTransform&&this.textureTransform.getFramebuffer()}update(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};"elementCount"in t&&this.model.setVertexCount(t.elementCount);const e=[this.bufferTransform,this.textureTransform].filter(Boolean);for(const n of e)n.update(t)}_initialize(){let t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};const{gl:e}=this;this._buildResourceTransforms(e,t),t=this._updateModelProps(t),this.model=new S.a(e,Object.assign({},t,{fs:t.fs||u({version:v(t.vs)}),id:t.id||"transform-model",drawMode:t.drawMode||0,vertexCount:t.elementCount})),this.bufferTransform&&this.bufferTransform.setupResources({model:this.model})}_updateModelProps(t){let e=Object.assign({},t);const n=[this.bufferTransform,this.textureTransform].filter(Boolean);for(const t of n)e=t.updateModelProps(e);return e}_buildResourceTransforms(t,e){(function(t){if(!Object(O.a)(t.feedbackBuffers)||!Object(O.a)(t.feedbackMap)||t.varyings&&t.varyings.length>0)return!0;return!1})(e)&&(this.bufferTransform=new d(t,e)),function(t){if(!Object(O.a)(t._sourceTextures)||t._targetTexture||t._targetTextureVarying)return!0;return!1}(e)&&(this.textureTransform=new E(t,e)),Object(p.a)(this.bufferTransform||this.textureTransform,"must provide source/feedback buffers or source/target textures")}_updateDrawOptions(t){let e=Object.assign({},t);const n=[this.bufferTransform,this.textureTransform].filter(Boolean);for(const t of n)e=Object.assign(e,t.getDrawOptions(e));return e}}},function(t,e,n){"use strict";var r=n(122),i=n(23),o=n(121),a=n(13),s=n(25),u=n(55);let c;class l extends o.a{static get ZERO(){return c||(c=new l(0,0,0,0),Object.freeze(c)),c}constructor(t=0,e=0,n=0,r=0){super(-0,-0,-0,-0),Object(a.f)(t)&&1===arguments.length?this.copy(t):(a.b.debug&&(Object(i.a)(t),Object(i.a)(e),Object(i.a)(n),Object(i.a)(r)),this[0]=t,this[1]=e,this[2]=n,this[3]=r)}set(t,e,n,r){return this[0]=t,this[1]=e,this[2]=n,this[3]=r,this.check()}copy(t){return this[0]=t[0],this[1]=t[1],this[2]=t[2],this[3]=t[3],this.check()}fromObject(t){return a.b.debug&&(Object(i.a)(t.x),Object(i.a)(t.y),Object(i.a)(t.z),Object(i.a)(t.w)),this[0]=t.x,this[1]=t.y,this[2]=t.z,this[3]=t.w,this}toObject(t){return t.x=this[0],t.y=this[1],t.z=this[2],t.w=this[3],t}get ELEMENTS(){return 4}get z(){return this[2]}set z(t){this[2]=Object(i.a)(t)}get w(){return this[3]}set w(t){this[3]=Object(i.a)(t)}transform(t){return s.p(this,this,t),this.check()}transformByMatrix3(t){return Object(u.e)(this,this,t),this.check()}transformByMatrix2(t){return Object(u.d)(this,this,t),this.check()}transformByQuaternion(t){return s.q(this,this,t),this.check()}applyMatrix4(t){return t.transform(this,this),this}}var h=n(11),f=n(57),p=n(36);function d(){var t=new h.a(4);return h.a!=Float32Array&&(t[0]=0,t[1]=0,t[2]=0),t[3]=1,t}function A(t,e,n){n*=.5;var r=Math.sin(n);return t[0]=r*e[0],t[1]=r*e[1],t[2]=r*e[2],t[3]=Math.cos(n),t}function g(t,e,n){var r=e[0],i=e[1],o=e[2],a=e[3],s=n[0],u=n[1],c=n[2],l=n[3];return t[0]=r*l+a*s+i*c-o*u,t[1]=i*l+a*u+o*s-r*c,t[2]=o*l+a*c+r*u-i*s,t[3]=a*l-r*s-i*u-o*c,t}function m(t,e,n,r){var i,o,a,s,u,c=e[0],l=e[1],f=e[2],p=e[3],d=n[0],A=n[1],g=n[2],m=n[3];return(o=c*d+l*A+f*g+p*m)<0&&(o=-o,d=-d,A=-A,g=-g,m=-m),1-o>h.b?(i=Math.acos(o),a=Math.sin(i),s=Math.sin((1-r)*i)/a,u=Math.sin(r*i)/a):(s=1-r,u=r),t[0]=s*c+u*d,t[1]=s*l+u*A,t[2]=s*f+u*g,t[3]=s*p+u*m,t}function y(t,e){var n,r=e[0]+e[4]+e[8];if(r>0)n=Math.sqrt(r+1),t[3]=.5*n,n=.5/n,t[0]=(e[5]-e[7])*n,t[1]=(e[6]-e[2])*n,t[2]=(e[1]-e[3])*n;else{var i=0;e[4]>e[0]&&(i=1),e[8]>e[3*i+i]&&(i=2);var o=(i+1)%3,a=(i+2)%3;n=Math.sqrt(e[3*i+i]-e[3*o+o]-e[3*a+a]+1),t[i]=.5*n,n=.5/n,t[3]=(e[3*o+a]-e[3*a+o])*n,t[o]=(e[3*o+i]+e[3*i+o])*n,t[a]=(e[3*a+i]+e[3*i+a])*n}return t}p.b,p.g,p.c,p.l;var v,_,b,x,w,E,O=p.a,S=p.k,T=p.d,C=p.i,P=p.h,M=p.m,I=p.j,B=(p.f,p.e,v=s.c(),_=s.f(1,0,0),b=s.f(0,1,0),function(t,e,n){var r=s.e(e,n);return r<-.999999?(s.d(v,_,e),s.g(v)<1e-6&&s.d(v,b,e),s.k(v,v),A(t,v,Math.PI),t):r>.999999?(t[0]=0,t[1]=0,t[2]=0,t[3]=1,t):(s.d(v,e,n),t[0]=v[0],t[1]=v[1],t[2]=v[2],t[3]=1+r,I(t,t))});x=d(),w=d(),E=f.a();n.d(e,"a",(function(){return k}));const R=[0,0,0,1];class k extends r.a{constructor(t=0,e=0,n=0,r=1){super(-0,-0,-0,-0),Array.isArray(t)&&1===arguments.length?this.copy(t):this.set(t,e,n,r)}copy(t){return this[0]=t[0],this[1]=t[1],this[2]=t[2],this[3]=t[3],this.check()}set(t,e,n,r){return this[0]=t,this[1]=e,this[2]=n,this[3]=r,this.check()}fromObject(t){return this[0]=t.x,this[1]=t.y,this[2]=t.z,this[3]=t.w,this.check()}fromMatrix3(t){return y(this,t),this.check()}fromAxisRotation(t,e){return A(this,t,e),this.check()}identity(){var t;return(t=this)[0]=0,t[1]=0,t[2]=0,t[3]=1,this.check()}setAxisAngle(t,e){return this.fromAxisRotation(t,e)}get ELEMENTS(){return 4}get x(){return this[0]}set x(t){this[0]=Object(i.a)(t)}get y(){return this[1]}set y(t){this[1]=Object(i.a)(t)}get z(){return this[2]}set z(t){this[2]=Object(i.a)(t)}get w(){return this[3]}set w(t){this[3]=Object(i.a)(t)}len(){return P(this)}lengthSquared(){return M(this)}dot(t){return T(this,t)}rotationTo(t,e){return B(this,t,e),this.check()}add(t){return O(this,this,t),this.check()}calculateW(){var t,e,n,r,i;return t=this,n=(e=this)[0],r=e[1],i=e[2],t[0]=n,t[1]=r,t[2]=i,t[3]=Math.sqrt(Math.abs(1-n*n-r*r-i*i)),this.check()}conjugate(){var t,e;return e=this,(t=this)[0]=-e[0],t[1]=-e[1],t[2]=-e[2],t[3]=e[3],this.check()}invert(){var t,e,n,r,i,o,a,s;return t=this,n=(e=this)[0],r=e[1],i=e[2],o=e[3],s=(a=n*n+r*r+i*i+o*o)?1/a:0,t[0]=-n*s,t[1]=-r*s,t[2]=-i*s,t[3]=o*s,this.check()}lerp(t,e,n){return void 0===n?this.lerp(this,t,e):(C(this,t,e,n),this.check())}multiplyRight(t){return g(this,this,t),this.check()}multiplyLeft(t){return g(this,t,this),this.check()}normalize(){const t=this.len(),e=t>0?1/t:0;return this[0]=this[0]*e,this[1]=this[1]*e,this[2]=this[2]*e,this[3]=this[3]*e,0===t&&(this[3]=1),this.check()}rotateX(t){return function(t,e,n){n*=.5;var r=e[0],i=e[1],o=e[2],a=e[3],s=Math.sin(n),u=Math.cos(n);t[0]=r*u+a*s,t[1]=i*u+o*s,t[2]=o*u-i*s,t[3]=a*u-r*s}(this,this,t),this.check()}rotateY(t){return function(t,e,n){n*=.5;var r=e[0],i=e[1],o=e[2],a=e[3],s=Math.sin(n),u=Math.cos(n);t[0]=r*u-o*s,t[1]=i*u+a*s,t[2]=o*u+r*s,t[3]=a*u-i*s}(this,this,t),this.check()}rotateZ(t){return function(t,e,n){n*=.5;var r=e[0],i=e[1],o=e[2],a=e[3],s=Math.sin(n),u=Math.cos(n);t[0]=r*u+i*s,t[1]=i*u-r*s,t[2]=o*u+a*s,t[3]=a*u-o*s}(this,this,t),this.check()}scale(t){return S(this,this,t),this.check()}slerp(t,e,n){let r,i,o;switch(arguments.length){case 1:({start:r=R,target:i,ratio:o}=t);break;case 2:r=this,i=t,o=e;break;default:r=t,i=e,o=n}return m(this,r,i,o),this.check()}transformVector4(t,e=new l){return p.o(e,t,this),Object(i.b)(e,4)}lengthSq(){return this.lengthSquared()}setFromAxisAngle(t,e){return this.setAxisAngle(t,e)}premultiply(t){return this.multiplyLeft(t)}multiply(t){return this.multiplyRight(t)}}},function(t,e,n){"use strict";var r=n(146);n.d(e,"a",(function(){return i}));const i={name:"pbr",vs:"uniform mat4 u_MVPMatrix;\nuniform mat4 u_ModelMatrix;\nuniform mat4 u_NormalMatrix;\n\nvarying vec3 pbr_vPosition;\nvarying vec2 pbr_vUV;\n\n#ifdef HAS_NORMALS\n# ifdef HAS_TANGENTS\nvarying mat3 pbr_vTBN;\n# else\nvarying vec3 pbr_vNormal;\n# endif\n#endif\n\nvoid pbr_setPositionNormalTangentUV(vec4 position, vec4 normal, vec4 tangent, vec2 uv)\n{\n  vec4 pos = u_ModelMatrix * position;\n  pbr_vPosition = vec3(pos.xyz) / pos.w;\n\n#ifdef HAS_NORMALS\n#ifdef HAS_TANGENTS\n  vec3 normalW = normalize(vec3(u_NormalMatrix * vec4(normal.xyz, 0.0)));\n  vec3 tangentW = normalize(vec3(u_ModelMatrix * vec4(tangent.xyz, 0.0)));\n  vec3 bitangentW = cross(normalW, tangentW) * tangent.w;\n  pbr_vTBN = mat3(tangentW, bitangentW, normalW);\n#else\n  pbr_vNormal = normalize(vec3(u_ModelMatrix * vec4(normal.xyz, 0.0)));\n#endif\n#endif\n\n#ifdef HAS_UV\n  pbr_vUV = uv;\n#else\n  pbr_vUV = vec2(0.,0.);\n#endif\n}\n",fs:"#if defined(USE_TEX_LOD) && !defined(FEATURE_GLSL_TEXTURE_LOD)\n# error PBR fragment shader: Texture LOD is not available\n#endif\n\n#if !defined(HAS_TANGENTS) && !defined(FEATURE_GLSL_DERIVATIVES)\n# error PBR fragment shader: Derivatives are not available\n#endif\n\n\n#if (__VERSION__ < 300)\n  #define SMART_FOR(INIT, WEBGL1COND, WEBGL2COND, INCR) for (INIT; WEBGL1COND; INCR)\n#else\n  #define SMART_FOR(INIT, WEBGL1COND, WEBGL2COND, INCR) for (INIT; WEBGL2COND; INCR)\n#endif\n\nprecision highp float;\n\nuniform bool pbr_uUnlit;\n\n#ifdef USE_IBL\nuniform samplerCube u_DiffuseEnvSampler;\nuniform samplerCube u_SpecularEnvSampler;\nuniform sampler2D u_brdfLUT;\nuniform vec2 u_ScaleIBLAmbient;\n#endif\n\n#ifdef HAS_BASECOLORMAP\nuniform sampler2D u_BaseColorSampler;\n#endif\n#ifdef HAS_NORMALMAP\nuniform sampler2D u_NormalSampler;\nuniform float u_NormalScale;\n#endif\n#ifdef HAS_EMISSIVEMAP\nuniform sampler2D u_EmissiveSampler;\nuniform vec3 u_EmissiveFactor;\n#endif\n#ifdef HAS_METALROUGHNESSMAP\nuniform sampler2D u_MetallicRoughnessSampler;\n#endif\n#ifdef HAS_OCCLUSIONMAP\nuniform sampler2D u_OcclusionSampler;\nuniform float u_OcclusionStrength;\n#endif\n\n#ifdef ALPHA_CUTOFF\nuniform float u_AlphaCutoff;\n#endif\n\nuniform vec2 u_MetallicRoughnessValues;\nuniform vec4 u_BaseColorFactor;\n\nuniform vec3 u_Camera;\n#ifdef PBR_DEBUG\nuniform vec4 u_ScaleDiffBaseMR;\nuniform vec4 u_ScaleFGDSpec;\n#endif\n\nvarying vec3 pbr_vPosition;\n\nvarying vec2 pbr_vUV;\n\n#ifdef HAS_NORMALS\n#ifdef HAS_TANGENTS\nvarying mat3 pbr_vTBN;\n#else\nvarying vec3 pbr_vNormal;\n#endif\n#endif\n\n\nstruct PBRInfo\n{\n  float NdotL;\n  float NdotV;\n  float NdotH;\n  float LdotH;\n  float VdotH;\n  float perceptualRoughness;\n  float metalness;\n  vec3 reflectance0;\n  vec3 reflectance90;\n  float alphaRoughness;\n  vec3 diffuseColor;\n  vec3 specularColor;\n  vec3 n;\n  vec3 v;\n};\n\nconst float M_PI = 3.141592653589793;\nconst float c_MinRoughness = 0.04;\n\nvec4 SRGBtoLINEAR(vec4 srgbIn)\n{\n#ifdef MANUAL_SRGB\n#ifdef SRGB_FAST_APPROXIMATION\n  vec3 linOut = pow(srgbIn.xyz,vec3(2.2));\n#else\n  vec3 bLess = step(vec3(0.04045),srgbIn.xyz);\n  vec3 linOut = mix( srgbIn.xyz/vec3(12.92), pow((srgbIn.xyz+vec3(0.055))/vec3(1.055),vec3(2.4)), bLess );\n#endif\n  return vec4(linOut,srgbIn.w);;\n#else\n  return srgbIn;\n#endif\n}\n\nvec3 getNormal()\n{\n#ifndef HAS_TANGENTS\n  vec3 pos_dx = dFdx(pbr_vPosition);\n  vec3 pos_dy = dFdy(pbr_vPosition);\n  vec3 tex_dx = dFdx(vec3(pbr_vUV, 0.0));\n  vec3 tex_dy = dFdy(vec3(pbr_vUV, 0.0));\n  vec3 t = (tex_dy.t * pos_dx - tex_dx.t * pos_dy) / (tex_dx.s * tex_dy.t - tex_dy.s * tex_dx.t);\n\n#ifdef HAS_NORMALS\n  vec3 ng = normalize(pbr_vNormal);\n#else\n  vec3 ng = cross(pos_dx, pos_dy);\n#endif\n\n  t = normalize(t - ng * dot(ng, t));\n  vec3 b = normalize(cross(ng, t));\n  mat3 tbn = mat3(t, b, ng);\n#else\n  mat3 tbn = pbr_vTBN;\n#endif\n\n#ifdef HAS_NORMALMAP\n  vec3 n = texture2D(u_NormalSampler, pbr_vUV).rgb;\n  n = normalize(tbn * ((2.0 * n - 1.0) * vec3(u_NormalScale, u_NormalScale, 1.0)));\n#else\n  vec3 n = normalize(tbn[2].xyz);\n#endif\n\n  return n;\n}\n\n\n#ifdef USE_IBL\nvec3 getIBLContribution(PBRInfo pbrInputs, vec3 n, vec3 reflection)\n{\n  float mipCount = 9.0;\n  float lod = (pbrInputs.perceptualRoughness * mipCount);\n  vec3 brdf = SRGBtoLINEAR(texture2D(u_brdfLUT,\n    vec2(pbrInputs.NdotV, 1.0 - pbrInputs.perceptualRoughness))).rgb;\n  vec3 diffuseLight = SRGBtoLINEAR(textureCube(u_DiffuseEnvSampler, n)).rgb;\n\n#ifdef USE_TEX_LOD\n  vec3 specularLight = SRGBtoLINEAR(textureCubeLod(u_SpecularEnvSampler, reflection, lod)).rgb;\n#else\n  vec3 specularLight = SRGBtoLINEAR(textureCube(u_SpecularEnvSampler, reflection)).rgb;\n#endif\n\n  vec3 diffuse = diffuseLight * pbrInputs.diffuseColor;\n  vec3 specular = specularLight * (pbrInputs.specularColor * brdf.x + brdf.y);\n  diffuse *= u_ScaleIBLAmbient.x;\n  specular *= u_ScaleIBLAmbient.y;\n\n  return diffuse + specular;\n}\n#endif\n\n\nvec3 diffuse(PBRInfo pbrInputs)\n{\n  return pbrInputs.diffuseColor / M_PI;\n}\n\nvec3 specularReflection(PBRInfo pbrInputs)\n{\n  return pbrInputs.reflectance0 +\n    (pbrInputs.reflectance90 - pbrInputs.reflectance0) *\n    pow(clamp(1.0 - pbrInputs.VdotH, 0.0, 1.0), 5.0);\n}\n\n\n\nfloat geometricOcclusion(PBRInfo pbrInputs)\n{\n  float NdotL = pbrInputs.NdotL;\n  float NdotV = pbrInputs.NdotV;\n  float r = pbrInputs.alphaRoughness;\n\n  float attenuationL = 2.0 * NdotL / (NdotL + sqrt(r * r + (1.0 - r * r) * (NdotL * NdotL)));\n  float attenuationV = 2.0 * NdotV / (NdotV + sqrt(r * r + (1.0 - r * r) * (NdotV * NdotV)));\n  return attenuationL * attenuationV;\n}\n\n\n\n\n\nfloat microfacetDistribution(PBRInfo pbrInputs)\n{\n  float roughnessSq = pbrInputs.alphaRoughness * pbrInputs.alphaRoughness;\n  float f = (pbrInputs.NdotH * roughnessSq - pbrInputs.NdotH) * pbrInputs.NdotH + 1.0;\n  return roughnessSq / (M_PI * f * f);\n}\n\nvoid PBRInfo_setAmbientLight(inout PBRInfo pbrInputs) {\n  pbrInputs.NdotL = 1.0;\n  pbrInputs.NdotH = 0.0;\n  pbrInputs.LdotH = 0.0;\n  pbrInputs.VdotH = 1.0;\n}\n\nvoid PBRInfo_setDirectionalLight(inout PBRInfo pbrInputs, vec3 lightDirection) {\n  vec3 n = pbrInputs.n;\n  vec3 v = pbrInputs.v;\n  vec3 l = normalize(lightDirection);\n  vec3 h = normalize(l+v);\n\n  pbrInputs.NdotL = clamp(dot(n, l), 0.001, 1.0);\n  pbrInputs.NdotH = clamp(dot(n, h), 0.0, 1.0);\n  pbrInputs.LdotH = clamp(dot(l, h), 0.0, 1.0);\n  pbrInputs.VdotH = clamp(dot(v, h), 0.0, 1.0);\n}\n\nvoid PBRInfo_setPointLight(inout PBRInfo pbrInputs, PointLight pointLight) {\n  vec3 light_direction = normalize(pointLight.position - pbr_vPosition);\n  PBRInfo_setDirectionalLight(pbrInputs, light_direction);\n}\n\nvec3 calculateFinalColor(PBRInfo pbrInputs, vec3 lightColor) {\n  vec3 F = specularReflection(pbrInputs);\n  float G = geometricOcclusion(pbrInputs);\n  float D = microfacetDistribution(pbrInputs);\n  vec3 diffuseContrib = (1.0 - F) * diffuse(pbrInputs);\n  vec3 specContrib = F * G * D / (4.0 * pbrInputs.NdotL * pbrInputs.NdotV);\n  return pbrInputs.NdotL * lightColor * (diffuseContrib + specContrib);\n}\n\nvec4 pbr_filterColor(vec4 colorUnused)\n{\n#ifdef HAS_BASECOLORMAP\n  vec4 baseColor = SRGBtoLINEAR(texture2D(u_BaseColorSampler, pbr_vUV)) * u_BaseColorFactor;\n#else\n  vec4 baseColor = u_BaseColorFactor;\n#endif\n\n#ifdef ALPHA_CUTOFF\n  if (baseColor.a < u_AlphaCutoff) {\n    discard;\n  }\n#endif\n\n  vec3 color = vec3(0, 0, 0);\n\n  if(pbr_uUnlit){\n    color.rgb = baseColor.rgb;\n  }\n  else{\n\n\n    float perceptualRoughness = u_MetallicRoughnessValues.y;\n    float metallic = u_MetallicRoughnessValues.x;\n#ifdef HAS_METALROUGHNESSMAP\n\n    vec4 mrSample = texture2D(u_MetallicRoughnessSampler, pbr_vUV);\n    perceptualRoughness = mrSample.g * perceptualRoughness;\n    metallic = mrSample.b * metallic;\n#endif\n    perceptualRoughness = clamp(perceptualRoughness, c_MinRoughness, 1.0);\n    metallic = clamp(metallic, 0.0, 1.0);\n\n    float alphaRoughness = perceptualRoughness * perceptualRoughness;\n\n    vec3 f0 = vec3(0.04);\n    vec3 diffuseColor = baseColor.rgb * (vec3(1.0) - f0);\n    diffuseColor *= 1.0 - metallic;\n    vec3 specularColor = mix(f0, baseColor.rgb, metallic);\n    float reflectance = max(max(specularColor.r, specularColor.g), specularColor.b);\n\n\n\n    float reflectance90 = clamp(reflectance * 25.0, 0.0, 1.0);\n    vec3 specularEnvironmentR0 = specularColor.rgb;\n    vec3 specularEnvironmentR90 = vec3(1.0, 1.0, 1.0) * reflectance90;\n\n    vec3 n = getNormal();\n    vec3 v = normalize(u_Camera - pbr_vPosition);\n\n    float NdotV = clamp(abs(dot(n, v)), 0.001, 1.0);\n    vec3 reflection = -normalize(reflect(v, n));\n\n    PBRInfo pbrInputs = PBRInfo(\n      0.0,\n      NdotV,\n      0.0,\n      0.0,\n      0.0,\n      perceptualRoughness,\n      metallic,\n      specularEnvironmentR0,\n      specularEnvironmentR90,\n      alphaRoughness,\n      diffuseColor,\n      specularColor,\n      n,\n      v\n    );\n\n#ifdef USE_LIGHTS\n    PBRInfo_setAmbientLight(pbrInputs);\n    color += calculateFinalColor(pbrInputs, lighting_uAmbientLight.color);\n    SMART_FOR(int i = 0, i < MAX_LIGHTS, i < lighting_uDirectionalLightCount, i++) {\n      if (i < lighting_uDirectionalLightCount) {\n        PBRInfo_setDirectionalLight(pbrInputs, lighting_uDirectionalLight[i].direction);\n        color += calculateFinalColor(pbrInputs, lighting_uDirectionalLight[i].color);\n      }\n    }\n    SMART_FOR(int i = 0, i < MAX_LIGHTS, i < lighting_uPointLightCount, i++) {\n      if (i < lighting_uPointLightCount) {\n        PBRInfo_setPointLight(pbrInputs, lighting_uPointLight[i]);\n        float attenuation = getPointLightAttenuation(lighting_uPointLight[i], distance(lighting_uPointLight[i].position, pbr_vPosition));\n        color += calculateFinalColor(pbrInputs, lighting_uPointLight[i].color / attenuation);\n      }\n    }\n#endif\n#ifdef USE_IBL\n    color += getIBLContribution(pbrInputs, n, reflection);\n#endif\n#ifdef HAS_OCCLUSIONMAP\n    float ao = texture2D(u_OcclusionSampler, pbr_vUV).r;\n    color = mix(color, color * ao, u_OcclusionStrength);\n#endif\n\n#ifdef HAS_EMISSIVEMAP\n    vec3 emissive = SRGBtoLINEAR(texture2D(u_EmissiveSampler, pbr_vUV)).rgb * u_EmissiveFactor;\n    color += emissive;\n#endif\n\n#ifdef PBR_DEBUG\n\n\n\n\n\n    color = mix(color, baseColor.rgb, u_ScaleDiffBaseMR.y);\n    color = mix(color, vec3(metallic), u_ScaleDiffBaseMR.z);\n    color = mix(color, vec3(perceptualRoughness), u_ScaleDiffBaseMR.w);\n#endif\n\n  }\n\n  return vec4(pow(color,vec3(1.0/2.2)), baseColor.a);\n}\n",defines:{LIGHTING_FRAGMENT:1},dependencies:[r.a]}}])}));
+//# sourceMappingURL=index.js.map
\ No newline at end of file
diff --git a/llm/share/jupyter/nbextensions/pydeck/index.js.map b/llm/share/jupyter/nbextensions/pydeck/index.js.map
new file mode 100644
index 0000000000000000000000000000000000000000..09aac7675cef96989af708fc4676b3daf87d9f6c
--- /dev/null
+++ b/llm/share/jupyter/nbextensions/pydeck/index.js.map
@@ -0,0 +1 @@
+{"version":3,"sources":["webpack:///webpack/universalModuleDefinition","webpack:///webpack/bootstrap","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/defineProperty.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/getPrototypeOf.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/esm/defineProperty.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/classCallCheck.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/createClass.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/inherits.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/possibleConstructorReturn.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/utils/log.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/utils/assert.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/utils/webgl-checks.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/polyfill/polyfill-vertex-array-object.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/polyfill/get-parameter-polyfill.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/polyfill/polyfill-table.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/polyfill/polyfill-context.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/state-tracker/webgl-parameter-tables.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/utils/utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/state-tracker/track-context-state.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/state-tracker/unified-parameter-api.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/utils/device-pixels.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/context/context.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/gltools/dist/esm/index.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/get.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/slicedToArray.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/utils/assert.js","webpack:////home/jesus/code/deck.gl/node_modules/gl-matrix/esm/common.js","webpack:///../core/src/lib/constants.ts","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/lib/common.js","webpack:///../core/node_modules/gl-matrix/esm/common.js","webpack:///../core/src/effects/lighting/point-light.ts","webpack:///../core/src/effects/lighting/camera-light.ts","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/sun/dist/esm/suncalc.js","webpack:///../core/src/effects/lighting/sun-light.ts","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/utils/clip-space.js","webpack:///../core/src/passes/screen-pass.ts","webpack:///../core/src/effects/post-process-effect.ts","webpack:///../core/src/viewports/orbit-viewport.ts","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/node_modules/@babel/runtime/helpers/esm/defineProperty.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/classes/spherical-coordinates.js","webpack:///../core/src/viewports/first-person-viewport.ts","webpack:///../core/src/controllers/first-person-controller.ts","webpack:///../core/src/views/first-person-view.ts","webpack:///../core/src/views/orbit-view.ts","webpack:///../core/src/controllers/globe-controller.ts","webpack:///../core/src/views/globe-view.ts","webpack:///../core/src/transitions/fly-to-interpolator.ts","webpack:///../core/src/index.ts","webpack:///./node_modules/@babel/runtime/helpers/esm/typeof.js","webpack:///./node_modules/@babel/runtime/helpers/esm/toPropertyKey.js","webpack:///./node_modules/@babel/runtime/helpers/esm/toPrimitive.js","webpack:///./node_modules/@babel/runtime/helpers/esm/defineProperty.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/web-mercator/dist/esm/math-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/web-mercator/dist/esm/assert.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/web-mercator/dist/esm/web-mercator-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/web-mercator/dist/esm/fit-bounds.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/web-mercator/dist/esm/get-bounds.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/web-mercator/dist/esm/normalize-viewport-props.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/web-mercator/dist/esm/fly-to-viewport.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/web-mercator/dist/esm/index.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/path-utils/path.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/index.js","webpack:///../core/src/utils/log.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/javascript-utils/is-type.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/lib/validators.js","webpack:///../core/src/lifecycle/constants.ts","webpack:////home/jesus/code/deck.gl/node_modules/gl-matrix/esm/vec3.js","webpack:////home/jesus/code/deck.gl/node_modules/gl-matrix/esm/mat4.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/assertThisInitialized.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/typeof.js","webpack:///../core/src/utils/assert.ts","webpack:////home/jesus/code/deck.gl/node_modules/prop-types/index.js","webpack:///../core/src/debug/index.ts","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/buffer.js","webpack:////home/jesus/code/deck.gl/node_modules/gl-matrix/esm/vec2.js","webpack:///../core/src/utils/math-utils.ts","webpack:////home/jesus/code/deck.gl/node_modules/gl-matrix/esm/vec4.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/polygon/dist/esm/polygon-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/polygon/dist/esm/earcut.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/polygon/dist/esm/utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/polygon/dist/esm/lineclip.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/polygon/dist/esm/cut-by-grid.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/polygon/dist/esm/cut-by-mercator-bounds.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/polygon/dist/esm/index.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/resource.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/regenerator/index.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/toConsumableArray.js","webpack:///./src/deck-bundle.js","webpack:///../core/src/viewports/viewport.ts","webpack:///../core/src/utils/array-utils.ts","webpack:///../core/src/lib/attribute/attribute-transition-utils.ts","webpack:////home/jesus/code/deck.gl/node_modules/node-libs-browser/node_modules/process/browser.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/loader-utils/normalize-loader.js","webpack:////home/jesus/code/deck.gl/node_modules/probe.gl/dist/esm/utils/globals.js","webpack:////home/jesus/code/deck.gl/node_modules/probe.gl/dist/esm/utils/local-storage.js","webpack:////home/jesus/code/deck.gl/node_modules/probe.gl/dist/esm/utils/formatters.js","webpack:////home/jesus/code/deck.gl/node_modules/probe.gl/dist/esm/utils/color.js","webpack:////home/jesus/code/deck.gl/node_modules/probe.gl/dist/esm/utils/assert.js","webpack:////home/jesus/code/deck.gl/node_modules/probe.gl/dist/esm/utils/hi-res-timestamp.js","webpack:////home/jesus/code/deck.gl/node_modules/probe.gl/dist/esm/lib/log.js","webpack:////home/jesus/code/deck.gl/node_modules/probe.gl/dist/esm/utils/autobind.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/loader-utils/loggers.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/loader-utils/option-defaults.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/loader-utils/option-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/utils/utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/webgl-utils/constants-to-keys.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/env-utils/globals.js","webpack:///../core/src/transitions/linear-interpolator.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/env-utils/assert.js","webpack:///../core/src/utils/iterable-utils.ts","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/webgl-utils/typed-array-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/texture.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/lib/gl-matrix-extras.js","webpack:///./node_modules/@babel/runtime/helpers/getPrototypeOf.js","webpack:////home/jesus/code/deck.gl/node_modules/gl-matrix/esm/mat3.js","webpack:///../core/src/controllers/controller.ts","webpack:///../core/src/utils/positions.ts","webpack:///../core/src/views/view.ts","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/geometry/geometry.js","webpack:///../core/src/utils/deep-equal.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/utils/mime-type-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/utils/resource-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/accessor.js","webpack:///../layers/src/solid-polygon-layer/polygon.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/fetch/read-array-buffer.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/fetch/read-file.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/fetch/write-file.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/api/parse-sync.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/api/parse-in-batches.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/api/load-in-batches.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/worker-api/process-on-worker.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/api/encode.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/api/save.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/iterators/make-stream/make-dom-stream.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/null-loader.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/progress/fetch-progress.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/filesystems/browser-filesystem.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/index.js","webpack:///../layers/src/bitmap-layer/create-mesh.ts","webpack:///../layers/src/bitmap-layer/bitmap-layer-vertex.ts","webpack:///../layers/src/bitmap-layer/bitmap-layer-fragment.ts","webpack:///../layers/src/bitmap-layer/bitmap-layer.ts","webpack:///../layers/src/index.ts","webpack:///../core/src/utils/flatten.ts","webpack:///../core/src/utils/typed-array-manager.ts","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/asyncToGenerator.js","webpack:///../core/node_modules/gl-matrix/esm/mat4.js","webpack:///(webpack)/buildin/global.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/env-utils/globals.js","webpack:///../core/src/passes/layers-pass.ts","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/framebuffer.js","webpack:///../core/src/transitions/transition.ts","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/stats/dist/esm/lib/stat.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/stats/dist/esm/lib/stats.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/stats/dist/esm/index.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/lib/constants.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/classes/matrix4.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/utils/log.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/api/select-loader.js","webpack:///../core/src/utils/memoize.ts","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/webgl-utils/attribute-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/texture-formats.js","webpack:///../core/node_modules/gl-matrix/esm/vec3.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/classes/vector3.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/binary-utils/array-buffer-utils.js","webpack:///../core/src/viewports/web-mercator-viewport.ts","webpack:///./node_modules/@loaders.gl/schema/dist/esm/lib/utils/row-utils.js","webpack:///./node_modules/@loaders.gl/schema/dist/esm/lib/utils/async-queue.js","webpack:///./node_modules/@loaders.gl/schema/dist/esm/lib/batches/base-table-batch-aggregator.js","webpack:///./node_modules/@loaders.gl/schema/dist/esm/lib/batches/row-table-batch-aggregator.js","webpack:///./node_modules/@loaders.gl/schema/dist/esm/lib/batches/columnar-table-batch-aggregator.js","webpack:///./node_modules/@loaders.gl/schema/dist/esm/lib/batches/table-batch-builder.js","webpack:///./node_modules/@loaders.gl/csv/dist/esm/papaparse/papaparse.js","webpack:///./node_modules/@loaders.gl/csv/dist/esm/papaparse/async-iterator-streamer.js","webpack:///./node_modules/@loaders.gl/csv/dist/esm/csv-loader.js","webpack:///./node_modules/@loaders.gl/loader-utils/dist/esm/lib/env-utils/assert.js","webpack:///./node_modules/@loaders.gl/core/dist/esm/lib/loader-utils/normalize-loader.js","webpack:///./node_modules/@probe.gl/env/dist/esm/utils/globals.js","webpack:///./node_modules/@probe.gl/log/dist/esm/utils/local-storage.js","webpack:///./node_modules/@probe.gl/log/dist/esm/utils/formatters.js","webpack:///./node_modules/@probe.gl/log/dist/esm/utils/color.js","webpack:///./node_modules/@probe.gl/log/dist/esm/utils/assert.js","webpack:///./node_modules/@probe.gl/log/dist/esm/utils/hi-res-timestamp.js","webpack:///./node_modules/@probe.gl/log/dist/esm/log.js","webpack:///./node_modules/@probe.gl/log/dist/esm/utils/autobind.js","webpack:///./node_modules/@loaders.gl/core/dist/esm/lib/loader-utils/loggers.js","webpack:///./node_modules/@loaders.gl/core/dist/esm/lib/loader-utils/option-defaults.js","webpack:///./node_modules/@loaders.gl/core/dist/esm/lib/loader-utils/option-utils.js","webpack:///./node_modules/@loaders.gl/core/dist/esm/lib/api/register-loaders.js","webpack:///./node_modules/@luma.gl/constants/dist/esm/index.js","webpack:///./src/playground/widget-tooltip.js","webpack:///./src/playground/utils/script-utils.js","webpack:///./src/lib/components/component-css.js","webpack:///./src/lib/components/description-card.js","webpack:///./src/playground/create-deck.js","webpack:///./src/playground/utils/google-maps-utils.js","webpack:///./src/lib/components/add-support-components.js","webpack:///./node_modules/@babel/runtime/helpers/classCallCheck.js","webpack:///./node_modules/@babel/runtime/helpers/createClass.js","webpack:///../core/node_modules/gl-matrix/esm/vec4.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/loader-utils/loader-context.js","webpack:///../core/node_modules/gl-matrix/esm/vec2.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/env/dist/esm/lib/globals.js","webpack:////home/jesus/code/deck.gl/node_modules/probe.gl/dist/esm/env/globals.js","webpack:///./node_modules/@probe.gl/env/dist/esm/lib/globals.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/path-utils/file-aliases.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/binary-utils/buffer-utils.js","webpack:///../core/src/effects/lighting/directional-light.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/fetch/fetch-file.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/fp32/fp32.js","webpack:///../core/src/shaderlib/misc/geometry.ts","webpack:///../core/src/shaderlib/project/project.glsl.ts","webpack:///../core/src/shaderlib/project/project.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/api/parse.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/worker-api/validate-worker-version.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/env-utils/assert.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/utils/load-file.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/texture-2d.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/utils/response-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/renderbuffer-formats.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/renderbuffer.js","webpack:///../core/node_modules/mjolnir.js/dist/esm/utils/globals.js","webpack:////home/jesus/code/deck.gl/node_modules/react-map-gl/dist/esm/utils/globals.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/api/register-loaders.js","webpack:///../core/src/controllers/map-controller.ts","webpack:///../core/src/transitions/transition-interpolator.ts","webpack:///../core/src/controllers/orbit-controller.ts","webpack:///../layers/src/solid-polygon-layer/polygon-tesselator.ts","webpack:///../layers/src/solid-polygon-layer/solid-polygon-layer-vertex-main.glsl.ts","webpack:///../layers/src/solid-polygon-layer/solid-polygon-layer-vertex-top.glsl.ts","webpack:///../layers/src/solid-polygon-layer/solid-polygon-layer-vertex-side.glsl.ts","webpack:///../layers/src/solid-polygon-layer/solid-polygon-layer.ts","webpack:///../layers/src/solid-polygon-layer/solid-polygon-layer-fragment.glsl.ts","webpack:///../layers/src/path-layer/path-tesselator.ts","webpack:///../layers/src/path-layer/path.ts","webpack:///../layers/src/path-layer/path-layer.ts","webpack:///../layers/src/path-layer/path-layer-vertex.glsl.ts","webpack:///../layers/src/path-layer/path-layer-fragment.glsl.ts","webpack:///../layers/src/icon-layer/icon-manager.ts","webpack:///../layers/src/icon-layer/icon-layer.ts","webpack:///../layers/src/icon-layer/icon-layer-vertex.glsl.ts","webpack:///../layers/src/icon-layer/icon-layer-fragment.glsl.ts","webpack:///./node_modules/@babel/runtime/helpers/inherits.js","webpack:///./node_modules/@babel/runtime/helpers/possibleConstructorReturn.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/classes/base/vector.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/classes/base/math-array.js","webpack:///../core/src/shaderlib/shadow/shadow.ts","webpack:///../core/src/shaderlib/project/viewport-uniforms.ts","webpack:///../core/src/controllers/view-state.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/loader-utils/get-data.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/iterators/make-iterator/make-array-buffer-iterator.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/iterators/make-iterator/make-stream-iterator.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/iterators/make-iterator/make-iterator.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/iterators/make-iterator/make-string-iterator.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/iterators/make-iterator/make-blob-iterator.js","webpack:///./src/version.js","webpack:////home/jesus/code/deck.gl/node_modules/long/dist/long.js","webpack:///../mesh-layers/src/utils/matrix.ts","webpack:///./src/playground/utils/mapbox-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/init.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/node/worker_threads-browser.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/worker-utils/get-loadable-worker-url.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/worker-farm/worker-thread.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/worker-farm/worker-job.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/worker-farm/worker-pool.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/worker-farm/worker-farm.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/iterators/text-iterators.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/binary-utils/get-first-characters.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/stats/dist/esm/utils/hi-res-timestamp.js","webpack:///../core/src/lifecycle/props.ts","webpack:///../core/src/passes/shadow-pass.ts","webpack:///../core/src/effects/lighting/lighting-effect.ts","webpack:///./node_modules/@babel/runtime/helpers/get.js","webpack:///external \"@jupyter-widgets/base\"","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/env/dist/esm/lib/is-browser.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/utils/check-props.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/lib/assert.js","webpack:///../core/src/shaderlib/project/project-functions.ts","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/lights/lights.glsl.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/lights/lights.js","webpack:////home/jesus/code/deck.gl/node_modules/hammerjs/hammer.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/binary-utils/memory-copy-utils.js","webpack:///../mesh-layers/src/index.ts","webpack:///../core/src/effects/lighting/ambient-light.ts","webpack:///../core/src/views/map-view.ts","webpack:///../core/src/controllers/transition-manager.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/env-utils/version.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/iterators/async-iteration.js","webpack:///../core/src/shaderlib/index.ts","webpack:///../core/src/views/orthographic-view.ts","webpack:///../core/src/viewports/orthographic-viewport.ts","webpack:///../core/src/controllers/orthographic-controller.ts","webpack:///../core/src/utils/count.ts","webpack:///../core/src/utils/shader.ts","webpack:///../core/src/viewports/globe-viewport.ts","webpack:///../core/src/transitions/cpu-interpolation-transition.js","webpack:///../core/src/transitions/cpu-spring-transition.js","webpack:///../core/src/lib/uniform-transition-manager.js","webpack:///../core/src/utils/texture.ts","webpack:///../core/src/lifecycle/prop-types.ts","webpack:///../core/src/lifecycle/create-props.ts","webpack:///../core/src/lifecycle/component.ts","webpack:///../core/src/lifecycle/component-state.ts","webpack:///../core/src/lib/layer-state.ts","webpack:///../core/src/lib/layer.ts","webpack:///../core/src/lib/attribute/shader-attribute.ts","webpack:///../core/src/lib/attribute/data-column.ts","webpack:///../core/src/lib/attribute/gl-utils.ts","webpack:///../core/src/utils/range.ts","webpack:///../core/src/lib/attribute/attribute.ts","webpack:///../core/src/transitions/gpu-interpolation-transition.ts","webpack:///../core/src/lib/attribute/attribute-transition-manager.ts","webpack:///../core/src/transitions/gpu-spring-transition.ts","webpack:///../core/src/lib/attribute/attribute-manager.ts","webpack:////home/jesus/code/deck.gl/node_modules/@mapbox/tiny-sdf/index.js","webpack:///../layers/src/text-layer/utils.ts","webpack:///../layers/src/text-layer/lru-cache.ts","webpack:///../layers/src/text-layer/font-atlas-manager.ts","webpack:///../layers/src/text-layer/text-layer.ts","webpack:///../layers/src/column-layer/column-geometry.ts","webpack:///../layers/src/column-layer/column-layer.ts","webpack:///../layers/src/column-layer/column-layer-vertex.glsl.ts","webpack:///../layers/src/column-layer/column-layer-fragment.glsl.ts","webpack:///../layers/src/scatterplot-layer/scatterplot-layer.ts","webpack:///../layers/src/scatterplot-layer/scatterplot-layer-vertex.glsl.ts","webpack:///../layers/src/scatterplot-layer/scatterplot-layer-fragment.glsl.ts","webpack:///../layers/src/text-layer/text-background-layer/text-background-layer.ts","webpack:///../layers/src/text-layer/text-background-layer/text-background-layer-vertex.glsl.ts","webpack:///../layers/src/text-layer/text-background-layer/text-background-layer-fragment.glsl.ts","webpack:///../core/src/lib/resource/resource.ts","webpack:///../core/src/lib/resource/resource-manager.ts","webpack:///../core/src/lib/layer-manager.ts","webpack:///../layers/src/text-layer/multi-icon-layer/multi-icon-layer.ts","webpack:///../layers/src/text-layer/multi-icon-layer/multi-icon-layer-fragment.glsl.ts","webpack:///../core/src/passes/draw-layers-pass.ts","webpack:///../core/src/lib/deck-renderer.js","webpack:///../json/src/transports/transport.js","webpack:///./node_modules/@babel/runtime/helpers/defineProperty.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/env/dist/esm/lib/is-electron.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/utils/stub-methods.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/classes/base/matrix.js","webpack:///../core/src/passes/pass.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/worker-utils/get-transfer-list.js","webpack:///../core/src/passes/pick-layers-pass.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/images/dist/esm/lib/category-api/binary-image-api.js","webpack:///../layers/src/utils.ts","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/objectWithoutProperties.js","webpack:///./src/playground/utils/css-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/draco/dist/esm/lib/utils/version.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/draco/dist/esm/draco-loader.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/schema/dist/esm/lib/schema/impl/schema.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/schema/dist/esm/lib/utils/assert.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/schema/dist/esm/lib/schema/impl/field.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/schema/dist/esm/lib/schema/impl/enum.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/schema/dist/esm/lib/schema/impl/type.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/schema/dist/esm/category/mesh/deduce-mesh-schema.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/schema/dist/esm/lib/arrow/arrow-like-type-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/draco/dist/esm/lib/utils/get-draco-schema.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/draco/dist/esm/lib/draco-parser.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/schema/dist/esm/category/mesh/mesh-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/draco/dist/esm/lib/draco-module-loader.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/draco/dist/esm/index.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/utils/array-utils-flat.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/vertex-array-object.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/vertex-array.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/utils/format-value.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/debug/debug-vertex-array.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/debug/debug-uniforms.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/debug/debug-program-configuration.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/lib/model-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/lib/model.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/utils/assert.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/clear.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/features/webgl-features-table.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/worker-api/get-worker-url.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/lib/inject-shader.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/module-injectors.js","webpack:///./node_modules/@babel/runtime/helpers/typeof.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/worker-loader-utils/parse-with-worker.js","webpack:///../json/src/utils/assert.js","webpack:///../json/src/utils/get.js","webpack:///../json/src/helpers/parse-expression-string.js","webpack:///../json/src/syntactic-sugar.js","webpack:///../json/src/json-configuration.js","webpack:///../json/src/helpers/convert-functions.js","webpack:///../json/src/helpers/instantiate-class.js","webpack:///../json/src/json-converter.js","webpack:///../json/src/helpers/parse-json.js","webpack:///../json/src/helpers/execute-function.js","webpack:///../json/src/utils/shallow-equal-objects.js","webpack:///../json/src/index.js","webpack:///./src/lib/jupyter-transport.js","webpack:///../core/src/lib/composite-layer.ts","webpack:///../core/src/lib/view-manager.ts","webpack:///../core/src/passes/mask-pass.ts","webpack:///../core/src/effects/mask/mask-effect.ts","webpack:///../core/src/effects/mask/utils.ts","webpack:///../core/src/lib/effect-manager.ts","webpack:///../core/src/lib/picking/query-object.ts","webpack:///../core/src/lib/picking/pick-info.ts","webpack:///../core/src/lib/deck-picker.ts","webpack:///../core/src/lib/tooltip.ts","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/query.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/lib/animation-loop.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/webgl-utils/request-animation-frame.js","webpack:///../core/node_modules/mjolnir.js/dist/esm/utils/hammer-overrides.js","webpack:///../core/node_modules/mjolnir.js/dist/esm/utils/hammer.browser.js","webpack:///../core/node_modules/mjolnir.js/dist/esm/inputs/input.js","webpack:///../core/node_modules/mjolnir.js/dist/esm/constants.js","webpack:///../core/node_modules/mjolnir.js/dist/esm/inputs/wheel-input.js","webpack:///../core/node_modules/mjolnir.js/dist/esm/inputs/move-input.js","webpack:///../core/node_modules/mjolnir.js/dist/esm/inputs/key-input.js","webpack:///../core/node_modules/mjolnir.js/dist/esm/inputs/contextmenu-input.js","webpack:///../core/node_modules/mjolnir.js/dist/esm/utils/event-utils.js","webpack:///../core/node_modules/mjolnir.js/dist/esm/utils/event-registrar.js","webpack:///../core/node_modules/mjolnir.js/dist/esm/event-manager.js","webpack:///../core/src/lib/deck.ts","webpack:///../core/src/utils/json-loader.ts","webpack:///../core/src/lib/init.ts","webpack:////home/jesus/code/deck.gl/node_modules/pbf/index.js","webpack:////home/jesus/code/deck.gl/node_modules/expression-eval/index.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/lib/resolve-modules.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/utils/is-old-ie.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/utils/webgl-info.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/lib/transpile-shader.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/lib/assemble-shaders.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/lib/platform-defines.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/lib/program-manager.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/lib/filters/prop-types.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/lib/shader-module.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/webgl-utils/format-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/copy-and-blit.js","webpack:///./node_modules/@babel/runtime/helpers/toPropertyKey.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/core/dist/esm/lib/api/load.js","webpack:///../core/src/shaderlib/project32/project32.ts","webpack:///../core/src/lib/layer-extension.ts","webpack:///../core/src/utils/tesselator.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/worker-loader-utils/encode-with-worker.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/request-utils/request-scheduler.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/json-loader.js","webpack:///../layers/src/column-layer/grid-cell-layer.ts","webpack:///../layers/src/polygon-layer/polygon-layer.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/loader-utils/dist/esm/lib/parser-utils/parse-json.js","webpack:////home/jesus/code/deck.gl/node_modules/ieee754/index.js","webpack:///./node_modules/@babel/runtime/helpers/arrayLikeToArray.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/experimental/dist/esm/scenegraph/scenegraph-node.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/experimental/dist/esm/scenegraph/group-node.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/experimental/dist/esm/gltf/gltf-animator.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/experimental/dist/esm/scenegraph/model-node.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/experimental/dist/esm/gltf/create-gltf-model.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/experimental/dist/esm/gltf/gltf-instantiator.js","webpack:///../mesh-layers/src/scenegraph-layer/gltf-utils.ts","webpack:///../mesh-layers/src/scenegraph-layer/scenegraph-layer.ts","webpack:///../mesh-layers/src/scenegraph-layer/scenegraph-layer-vertex.glsl.ts","webpack:///../mesh-layers/src/scenegraph-layer/scenegraph-layer-fragment.glsl.ts","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/experimental/dist/esm/gltf/create-gltf-objects.js","webpack:///../layers/src/geojson-layer/geojson-binary.ts","webpack:///../layers/src/geojson-layer/sub-layer-map.ts","webpack:///../layers/src/geojson-layer/geojson.ts","webpack:///../layers/src/geojson-layer/geojson-layer-props.ts","webpack:///../layers/src/geojson-layer/geojson-layer.ts","webpack:///../layers/src/arc-layer/arc-layer.ts","webpack:///../layers/src/arc-layer/arc-layer-vertex.glsl.ts","webpack:///../layers/src/arc-layer/arc-layer-fragment.glsl.ts","webpack:///../layers/src/line-layer/line-layer.ts","webpack:///../layers/src/line-layer/line-layer-vertex.glsl.ts","webpack:///../layers/src/line-layer/line-layer-fragment.glsl.ts","webpack:///../layers/src/point-cloud-layer/point-cloud-layer.ts","webpack:///../layers/src/point-cloud-layer/point-cloud-layer-vertex.glsl.ts","webpack:///../layers/src/point-cloud-layer/point-cloud-layer-fragment.glsl.ts","webpack:///../mesh-layers/src/simple-mesh-layer/simple-mesh-layer.ts","webpack:///../mesh-layers/src/simple-mesh-layer/simple-mesh-layer-vertex.glsl.ts","webpack:///../mesh-layers/src/simple-mesh-layer/simple-mesh-layer-fragment.glsl.ts","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/picking/picking.js","webpack:///../core/src/shaderlib/picking/picking.ts","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/phong-lighting/phong-lighting.glsl.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/phong-lighting/phong-lighting.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/webgl-utils/texture-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/texture-cube.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/texture-3d.js","webpack:////home/jesus/code/deck.gl/node_modules/probe.gl/dist/esm/env/is-browser.js","webpack:////home/jesus/code/deck.gl/node_modules/probe.gl/dist/esm/env/is-electron.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/asyncIterator.js","webpack:////home/jesus/code/deck.gl/node_modules/react-map-gl/dist/esm/mapbox/mapbox.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/esm/classCallCheck.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/esm/createClass.js","webpack:///../layers/node_modules/earcut/src/earcut.js","webpack:////home/jesus/code/deck.gl/node_modules/ktx-parse/dist/ktx-parse.modern.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/experimental/dist/esm/gltf/gltf-material-parser.js","webpack:///./node_modules/@probe.gl/env/dist/esm/lib/is-browser.js","webpack:///./node_modules/@probe.gl/env/dist/esm/lib/is-electron.js","webpack:///./node_modules/@babel/runtime/helpers/toConsumableArray.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/features/features.js","webpack:///./src/index.js","webpack:///./node_modules/@babel/runtime/helpers/toPrimitive.js","webpack:///./node_modules/@babel/runtime/helpers/setPrototypeOf.js","webpack:///./node_modules/@babel/runtime/helpers/assertThisInitialized.js","webpack:///./node_modules/@babel/runtime/helpers/superPropBase.js","webpack:///./src/lib/jupyter-transport-view.js","webpack:///../core/bundle/index.ts","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/arrayWithoutHoles.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/iterableToArray.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/nonIterableSpread.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/arrayWithHoles.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/iterableToArrayLimit.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/nonIterableRest.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/superPropBase.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/setPrototypeOf.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/node_modules/regenerator-runtime/runtime.js","webpack:///../core/bundle/deckgl.js","webpack:////home/jesus/code/deck.gl/node_modules/prop-types/factoryWithThrowingShims.js","webpack:////home/jesus/code/deck.gl/node_modules/prop-types/lib/ReactPropTypesSecret.js","webpack:////home/jesus/code/deck.gl/node_modules/@babel/runtime/helpers/objectWithoutPropertiesLoose.js","webpack:////home/jesus/code/deck.gl/node_modules/node-libs-browser/node_modules/buffer/index.js","webpack:////home/jesus/code/deck.gl/node_modules/base64-js/index.js","webpack:////home/jesus/code/deck.gl/node_modules/isarray/index.js","webpack:////home/jesus/code/deck.gl/node_modules/jsep/build/jsep.js","webpack:///./node_modules/mapbox-gl/dist/mapbox-gl.js","webpack:///./node_modules/@babel/runtime/helpers/arrayWithoutHoles.js","webpack:///./node_modules/@babel/runtime/helpers/iterableToArray.js","webpack:///./node_modules/@babel/runtime/helpers/unsupportedIterableToArray.js","webpack:///./node_modules/@babel/runtime/helpers/nonIterableSpread.js","webpack:///../geo-layers/src/great-circle-layer/great-circle-layer.ts","webpack:///../geo-layers/src/geo-cell-layer/GeoCellLayer.ts","webpack:///../geo-layers/src/s2-layer/s2-geometry.ts","webpack:///../geo-layers/src/s2-layer/s2-utils.ts","webpack:///../geo-layers/src/s2-layer/s2-layer.ts","webpack:///../geo-layers/src/quadkey-layer/quadkey-utils.ts","webpack:///../geo-layers/src/quadkey-layer/quadkey-layer.ts","webpack:///../geo-layers/src/tile-layer/tile-2d-header.ts","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/culling/dist/esm/constants.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/culling/node_modules/@babel/runtime/helpers/esm/defineProperty.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/culling/dist/esm/lib/bounding-volumes/axis-aligned-bounding-box.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/culling/dist/esm/lib/bounding-volumes/bounding-sphere.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/classes/matrix3.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/culling/dist/esm/lib/bounding-volumes/oriented-bounding-box.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/culling/dist/esm/lib/plane.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/culling/dist/esm/lib/culling-volume.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/culling/dist/esm/lib/perspective-off-center-frustum.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/culling/dist/esm/lib/algorithms/bounding-sphere-from-points.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/lib/math-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/culling/dist/esm/lib/algorithms/compute-eigen-decomposition.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/culling/dist/esm/lib/algorithms/bounding-box-from-points.js","webpack:///../geo-layers/src/tile-layer/tile-2d-traversal.ts","webpack:///../geo-layers/src/tile-layer/utils.ts","webpack:///../geo-layers/src/tile-layer/tileset-2d.ts","webpack:///../geo-layers/src/tile-layer/tile-layer.ts","webpack:///../geo-layers/src/trips-layer/trips-layer.ts","webpack:////home/jesus/code/deck.gl/node_modules/h3-js/dist/browser/h3-js.es.js","webpack:///../geo-layers/src/h3-layers/h3-hexagon-layer.ts","webpack:///../geo-layers/src/h3-layers/h3-cluster-layer.ts","webpack:///../geo-layers/src/mesh-layer/mesh-layer.ts","webpack:///../geo-layers/src/mesh-layer/mesh-layer-vertex.glsl.ts","webpack:///../geo-layers/src/mesh-layer/mesh-layer-fragment.glsl.ts","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/geospatial/node_modules/@babel/runtime/helpers/esm/defineProperty.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/geospatial/dist/esm/constants.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/geospatial/dist/esm/type-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/geospatial/dist/esm/ellipsoid/helpers/scale-to-geodetic-surface.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/geospatial/dist/esm/ellipsoid/helpers/ellipsoid-transform.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/geospatial/dist/esm/ellipsoid/ellipsoid.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/utils/doubly-linked-list-node.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/utils/doubly-linked-list.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/tileset-cache.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/helpers/frame-state.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/helpers/zoom.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/constants.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/helpers/bounding-volume.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/helpers/tiles-3d-lod.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/helpers/i3s-lod.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/utils/managed-array.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/traversers/tileset-traverser.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/tile-3d.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/helpers/3d-tiles-options.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/traversers/tileset-3d-traverser.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/traversers/i3s-pending-tiles-register.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/traversers/i3s-tile-manager.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/traversers/i3s-tileset-traverser.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/tileset-3d.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/tiles/dist/esm/tileset/helpers/transform-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/utils/version.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/constants.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/helpers/parse-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/math/dist/esm/geometry/constants.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/math/dist/esm/geometry/gl/gl-type.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/classes/tile-3d-feature-table.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/classes/helpers/tile-3d-accessor-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/classes/tile-3d-batch-table-hierarchy.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/classes/tile-3d-batch-table.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/helpers/parse-3d-tile-header.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/helpers/parse-3d-tile-tables.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/math/dist/esm/geometry/colors/rgb565.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/helpers/normalize-3d-tile-colors.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/math/dist/esm/geometry/utils/assert.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/math/dist/esm/geometry/compression/attribute-compression.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/helpers/normalize-3d-tile-normals.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/helpers/normalize-3d-tile-positions.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/parse-3d-tile-point-cloud.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/helpers/parse-3d-tile-gltf-view.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/parse-3d-tile-batched-model.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/parse-3d-tile-instanced-model.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/parse-3d-tile.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/parse-3d-tile-composite.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/parse-3d-tile-gltf.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/helpers/parse-3d-tile-subtree.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/tile-3d-subtree-loader.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/helpers/parse-3d-implicit-tiles.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/lib/parsers/parse-3d-tile-header.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/3d-tiles/dist/esm/tiles-3d-loader.js","webpack:///../geo-layers/src/tile-3d-layer/tile-3d-layer.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/terrain/dist/esm/lib/utils/version.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/terrain/dist/esm/terrain-loader.js","webpack:///../geo-layers/src/terrain-layer/terrain-layer.ts","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gis/dist/esm/lib/flat-geojson-to-binary.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/mvt/dist/esm/helpers/mapbox-util-functions.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/mvt/dist/esm/lib/mapbox-vector-tile/vector-tile-feature.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/mvt/dist/esm/lib/mapbox-vector-tile/vector-tile-layer.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/mvt/dist/esm/lib/mapbox-vector-tile/vector-tile.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/mvt/dist/esm/helpers/binary-util-functions.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/mvt/dist/esm/lib/binary-vector-tile/vector-tile-feature.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/mvt/dist/esm/lib/binary-vector-tile/vector-tile-layer.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/mvt/dist/esm/lib/binary-vector-tile/vector-tile.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/mvt/dist/esm/lib/parse-mvt.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/mvt/dist/esm/mvt-loader.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gis/dist/esm/lib/binary-to-geojson.js","webpack:///../extensions/src/clip/clip.ts","webpack:///../geo-layers/src/mvt-layer/coordinate-transform.ts","webpack:///../geo-layers/src/mvt-layer/find-index-binary.ts","webpack:///../geo-layers/src/mvt-layer/mvt-layer.ts","webpack:///../geo-layers/src/geohash-layer/geohash-utils.ts","webpack:///../geo-layers/src/geohash-layer/geohash-layer.ts","webpack:///../geo-layers/src/index.ts","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/fp64/fp64-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/fp64/fp64.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/fp64/fp64-arithmetic.glsl.js","webpack:///../aggregation-layers/src/utils/aggregation-operation-utils.js","webpack:///../aggregation-layers/src/utils/gpu-grid-aggregation/gpu-grid-aggregator-constants.js","webpack:///../aggregation-layers/src/utils/resource-utils.js","webpack:///../aggregation-layers/src/utils/gpu-grid-aggregation/gpu-grid-aggregator.js","webpack:///../aggregation-layers/src/utils/gpu-grid-aggregation/transform-mean-vs.glsl.js","webpack:///../aggregation-layers/src/utils/gpu-grid-aggregation/aggregate-to-grid-vs.glsl.js","webpack:///../aggregation-layers/src/utils/gpu-grid-aggregation/aggregate-to-grid-fs.glsl.js","webpack:///../aggregation-layers/src/utils/gpu-grid-aggregation/aggregate-all-vs.glsl.js","webpack:///../aggregation-layers/src/utils/gpu-grid-aggregation/aggregate-all-fs.glsl.js","webpack:///../aggregation-layers/src/utils/color-utils.ts","webpack:///../aggregation-layers/src/screen-grid-layer/screen-grid-cell-layer.ts","webpack:///../aggregation-layers/src/screen-grid-layer/screen-grid-layer-vertex.glsl.ts","webpack:///../aggregation-layers/src/screen-grid-layer/screen-grid-layer-fragment.glsl.ts","webpack:///../aggregation-layers/src/utils/prop-utils.js","webpack:///../aggregation-layers/src/aggregation-layer.ts","webpack:///../aggregation-layers/src/utils/scale-utils.js","webpack:///../aggregation-layers/src/utils/bin-sorter.ts","webpack:///../aggregation-layers/src/utils/grid-aggregation-utils.js","webpack:///../aggregation-layers/src/cpu-grid-layer/grid-aggregator.js","webpack:///../aggregation-layers/src/grid-aggregation-layer.ts","webpack:///../aggregation-layers/src/screen-grid-layer/screen-grid-layer.ts","webpack:///../aggregation-layers/src/utils/cpu-aggregator.js","webpack:///../aggregation-layers/src/cpu-grid-layer/cpu-grid-layer.ts","webpack:////home/jesus/code/deck.gl/node_modules/d3-hexbin/src/hexbin.js","webpack:///../aggregation-layers/src/hexagon-layer/hexagon-layer.ts","webpack:///../aggregation-layers/src/hexagon-layer/hexagon-aggregator.js","webpack:///../aggregation-layers/src/contour-layer/marching-squares-codes.ts","webpack:///../aggregation-layers/src/contour-layer/marching-squares.ts","webpack:///../aggregation-layers/src/contour-layer/contour-layer.ts","webpack:///../aggregation-layers/src/contour-layer/contour-utils.ts","webpack:///../aggregation-layers/src/gpu-grid-layer/gpu-grid-cell-layer.ts","webpack:///../aggregation-layers/src/gpu-grid-layer/gpu-grid-cell-layer-vertex.glsl.ts","webpack:///../aggregation-layers/src/gpu-grid-layer/gpu-grid-cell-layer-fragment.glsl.ts","webpack:///../aggregation-layers/src/gpu-grid-layer/gpu-grid-layer.ts","webpack:///../aggregation-layers/src/grid-layer/grid-layer.ts","webpack:///../aggregation-layers/src/heatmap-layer/heatmap-layer-utils.ts","webpack:///../aggregation-layers/src/heatmap-layer/triangle-layer.ts","webpack:///../aggregation-layers/src/heatmap-layer/triangle-layer-vertex.glsl.ts","webpack:///../aggregation-layers/src/heatmap-layer/triangle-layer-fragment.glsl.ts","webpack:///../aggregation-layers/src/heatmap-layer/weights-vs.glsl.ts","webpack:///../aggregation-layers/src/heatmap-layer/heatmap-layer.ts","webpack:///../aggregation-layers/src/heatmap-layer/max-vs.glsl.ts","webpack:///../aggregation-layers/src/heatmap-layer/max-fs.glsl.ts","webpack:///../aggregation-layers/src/heatmap-layer/weights-fs.glsl.ts","webpack:///../aggregation-layers/src/index.ts","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/geometries/truncated-cone-geometry.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/geometries/cone-geometry.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/geometries/cylinder-geometry.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/geometries/ico-sphere-geometry.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/geometries/plane-geometry.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/geometry/geometry-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/geometries/sphere-geometry.js","webpack:///../core/bundle/lumagl.js","webpack:///../google-maps/src/utils.ts","webpack:///../google-maps/src/google-maps-overlay.ts","webpack:///../google-maps/src/index.ts","webpack:///./src/lib/utils/deserialize-matrix.js","webpack:///./src/lib/jupyter-transport-model.js","webpack:///./src/playground/playground.js","webpack:///./src/playground/index.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/geometries/cube-geometry.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/env/dist/esm/utils/globals.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/log/dist/esm/utils/local-storage.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/log/dist/esm/utils/formatters.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/log/dist/esm/utils/color.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/log/dist/esm/utils/assert.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/log/dist/esm/utils/hi-res-timestamp.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/log/dist/esm/log.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/log/dist/esm/utils/autobind.js","webpack:////home/jesus/code/deck.gl/node_modules/@probe.gl/env/dist/esm/lib/get-browser.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/transform-feedback.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/animation/timeline.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/classes/vector2.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/worker-utils/dist/esm/lib/library-utils/library-utils.js","webpack:///./node_modules/@loaders.gl/loader-utils/dist/esm/lib/env-utils/globals.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/textures/dist/esm/lib/parsers/basis-module-loader.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/textures/dist/esm/lib/gl-extensions.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/textures/dist/esm/lib/utils/texture-formats.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/textures/dist/esm/lib/parsers/parse-ktx.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/textures/dist/esm/lib/parsers/parse-basis.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/textures/dist/esm/basis-loader.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/textures/dist/esm/lib/utils/version.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/utils/assert.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/gltf-utils/resolve-url.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/gltf-utils/get-typed-array.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/gltf-utils/gltf-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/api/gltf-scenegraph.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/meshopt/meshopt-decoder.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/extensions/EXT_meshopt_compression.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/images/dist/esm/lib/category-api/image-format.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/extensions/EXT_texture_webp.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/extensions/KHR_texture_basisu.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/gltf-utils/gltf-attribute-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/extensions/KHR_draco_mesh_compression.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/extensions/deprecated/KHR_lights_punctual.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/extensions/deprecated/KHR_materials_unlit.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/extensions/deprecated/KHR_techniques_webgl.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/api/gltf-extensions.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/api/normalize-gltf-v1.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/extensions/KHR_binary_gltf.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/api/post-process-gltf.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/parsers/parse-glb.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/parsers/parse-gltf.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/gltf-loader.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/gltf/dist/esm/lib/utils/version.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/images/dist/esm/lib/category-api/image-type.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/images/dist/esm/lib/category-api/parsed-image-api.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/images/dist/esm/lib/parsers/svg-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/images/dist/esm/lib/parsers/parse-to-image.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/images/dist/esm/lib/parsers/parse-to-image-bitmap.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/images/dist/esm/image-loader.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/images/dist/esm/lib/utils/version.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/images/dist/esm/lib/parsers/parse-image.js","webpack:////home/jesus/code/deck.gl/node_modules/@loaders.gl/images/dist/esm/lib/parsers/parse-to-node-image.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/uniforms.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/glsl-utils/get-shader-name.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/glsl-utils/format-glsl-error.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/glsl-utils/get-shader-type-name.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/shader.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/program-configuration.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/classes/program.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/utils/shader-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/transform/buffer-transform.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/webgl/dist/esm/glsl-utils/get-shader-version.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/transform/transform.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/transform/transform-shader-utils.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/transform/texture-transform.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/engine/dist/esm/transform/transform.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/classes/vector4.js","webpack:////home/jesus/code/deck.gl/node_modules/gl-matrix/esm/quat.js","webpack:////home/jesus/code/deck.gl/node_modules/@math.gl/core/dist/esm/classes/quaternion.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/pbr/pbr.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/pbr/pbr-vertex.glsl.js","webpack:////home/jesus/code/deck.gl/node_modules/@luma.gl/shadertools/dist/esm/modules/pbr/pbr-fragment.glsl.js"],"names":["root","factory","exports","module","require","define","amd","a","i","window","__WEBPACK_EXTERNAL_MODULE__141__","installedModules","__webpack_require__","moduleId","l","modules","call","m","c","d","name","getter","o","Object","defineProperty","enumerable","get","r","Symbol","toStringTag","value","t","mode","__esModule","ns","create","key","bind","n","object","property","prototype","hasOwnProperty","p","s","obj","configurable","writable","_getPrototypeOf","setPrototypeOf","getPrototypeOf","__proto__","_defineProperty","instance","Constructor","TypeError","_defineProperties","target","props","length","descriptor","protoProps","staticProps","subClass","superClass","constructor","_typeof","assertThisInitialized","self","id","assert","condition","message","Error","isWebGL","gl","WebGLRenderingContext","WebGL2RenderingContext","Boolean","Number","isFinite","_version","isWebGL2","getWebGL2Context","assertWebGLContext","assertWebGL2Context","glErrorShadow","synthesizeGLError","err","opt_msg","msg","undefined","globalThis","console","error","WebGLVertexArrayObjectOES","ext","this","isAlive","hasBeenBound","elementArrayBuffer","attribs","Array","maxVertexAttribs","attrib","VertexAttrib","maxAttrib","enabled","buffer","size","type","normalized","stride","offset","cached","recache","join","OESVertexArrayObject","f","getError","apply","parseInt","wrapGLError","original","getParameter","enableVertexAttribArray","disableVertexAttribArray","bindBuffer","getVertexAttrib","vertexAttribPointer","pname","VERTEX_ARRAY_BINDING_OES","currentVertexArrayObject","defaultVertexArrayObject","arguments","index","vao","Math","max","currentArrayBuffer","indx","instrumentExtension","canvas","addEventListener","log","reset_","vertexArrayObjects","ii","bindVertexArrayOES","createVertexArrayOES","arrayObject","push","deleteVertexArrayOES","splice","indexOf","isVertexArrayOES","oldVAO","newVAO","currentBinding","oldAttrib","bufferChanged","getWebGL2ValueOrZero","WEBGL_PARAMETERS","getExtension","GPU_DISJOINT_EXT","UNMASKED_VENDOR_WEBGL","UNMASKED_RENDERER_WEBGL","luma","extensions","MAX_TEXTURE_MAX_ANISOTROPY_EXT","MAX_COLOR_ATTACHMENTS_WEBGL","MAX_DRAW_BUFFERS_WEBGL","WEBGL2_CONTEXT_POLYFILLS","meta","suffix","createVertexArray","deleteVertexArray","bindVertexArray","isVertexArray","location","divisor","drawElementsInstanced","drawArraysInstanced","drawBuffers","createQuery","deleteQuery","beginQuery","endQuery","handle","getQueryObject","WEBGL2_CONTEXT_OVERRIDES","readBuffer","originalFunc","attachment","webgl2","extension","getExtensionData","result","getProgramParameter","program","getInternalformatParameter","format","Int32Array","TEXTURE_MAX_ANISOTROPY_EXT","originalGetParameter","limit","hint","polyfillExtension","_ref2","target2","defaults","keys","extKey","concat","polyfill","polyfillContext","polyfilled","original_getSupportedExtensions","getSupportedExtensions","list","original_getExtension","__OESVertexArrayObject","polyfillVertexArrayObject","EXTENSIONS","initializeExtensions","polyfills","getOwnPropertyNames","installPolyfills","_ref","forEach","installOverrides","GL_PARAMETER_DEFAULTS","Float32Array","enable","disable","pixelStorei","isArray","array","ArrayBuffer","isView","GL_PARAMETER_SETTERS","blendColor","clearColor","colorMask","cullFace","clearDepth","depthFunc","depthRange","depthMask","bindFramebuffer","frontFace","lineWidth","scissor","clearStencil","stencilMaskSeparate","viewport","framebuffer","blend","blendEquation","args","blendEquationSeparate","blendFunc","blendFuncSeparate","cull","depthTest","dither","derivativeHint","mipmapHint","polygonOffsetFill","polygonOffset","sampleCoverage","scissorTest","stencilTest","stencilMask","mask","backMask","stencilFunc","func","ref","backFunc","backRef","stencilFuncSeparate","stencilOp","sfail","dpfail","dppass","backSfail","backDpfail","backDppass","stencilOpSeparate","getValue","glEnum","values","cache","GL_COMPOSITE_PARAMETER_SETTERS","stencilFuncFront","stencilFuncBack","stencilOpFront","stencilOpBack","GL_HOOKED_SETTERS","update","capability","g","b","modeRGB","modeAlpha","src","dst","srcRGB","dstRGB","srcAlpha","dstAlpha","depth","zNear","zFar","face","width","factor","units","invert","x","y","height","fail","zfail","zpass","isEnabled","GL_PARAMETER_GETTERS","isObjectEmpty","deepArrayEqual","isArrayX","isArrayY","installGetterOverride","functionName","originalGetterFunc","state","installSetterSpy","setter","originalSetterFunc","_len","params","_key","valueChanged","oldValue","_updateCache","installProgramSpy","originalUseProgram","useProgram","copyState","stateStack","getParameters","assign","seal","oldValues","setParameters","pop","trackContextState","options","popContextState","compositeSetters","glConstant","compositeSetter","parameters","parameterKeys","resetParameters","withParameters","nocatch","pushContextState","cssToDeviceRatio","clientWidth","canvasSizeInfo","drawingBufferWidth","cssToDevicePixels","cssPixel","yInvert","ratio","drawingBufferHeight","scalePixels","getDevicePixelRatio","useDevicePixels","windowRatio","devicePixelRatio","pixel","scaleX","scaleY","xHigh","yHigh","min","round","isBrowser","isPage","document","CONTEXT_DEFAULTS","webgl1","throwOnError","manageState","debug","createGLContext","onError","targetCanvas","getCanvas","createBrowserContext","instrumentGLContext","logInfo","_instrumented","getVersion","makeDebugContext","level","warn","resizeGLContext","setDevicePixelRatio","resize","errorMessage","onCreateError","statusMessage","getContext","removeEventListener","onContextLost","onContextRestored","readyState","getElementById","createElement","style","body","insertBefore","firstChild","webGL","info","vendorMasked","rendererMasked","vendor","renderer","version","shadingLanguageVersion","getContextDebugInfo","driver","clientHeight","cachedSize","clampedPixelRatio","canvasWidth","floor","canvasHeight","superPropBase","_get","receiver","Reflect","base","desc","getOwnPropertyDescriptor","arrayWithHoles","iterableToArrayLimit","nonIterableRest","arr","EPSILON","ARRAY_TYPE","RANDOM","random","PI","hypot","sqrt","COORDINATE_SYSTEM","DEFAULT","LNGLAT","METER_OFFSETS","LNGLAT_OFFSETS","CARTESIAN","deprecated","PROJECTION_MODE","WEB_MERCATOR","GLOBE","WEB_MERCATOR_AUTO_OFFSET","IDENTITY","UNIT","common","meters","pixels","EVENTS","click","handler","panstart","panmove","panend","OPERATION","DRAW","MASK","RADIANS_TO_DEGREES","DEGREES_TO_RADIANS","config","precision","printTypes","printDegrees","printRowMajor","formatValue","parseFloat","toPrecision","DataView","toRadians","degrees","radians","toDegrees","map","clamp","lerp","ai","equals","epsilon","oldEpsilon","abs","clone","duplicateArray","DEFAULT_LIGHT_COLOR","DEFAULT_ATTENUATION","DEFAULT_LIGHT_POSITION","idCount","PointLight","color","intensity","position","attenuation","getAttenuation","projectedLight","layer","context","coordinateSystem","coordinateOrigin","projectPosition","fromCoordinateSystem","isGeospatial","fromCoordinateOrigin","CameraLight","modelMatrix","project_uCameraPosition","getUniformsFromViewport","e","getSunPosition","timestamp","latitude","longitude","longitudeWestInRadians","phi","getTime","toJulianDay","toDays","dates","L","meanAnomaly","M","C","sin","getEclipticLongitude","days","declination","getDeclination","rightAscension","getRightAscension","getSunCoords","H","getSiderealTime","azimuth","getAzimuth","altitude","getAltitude","getSunDirection","cos","eclipticLongitude","lambda","atan2","tan","asin","hourAngle","latitudeInRadians","delta","SunLight","opts","resolution","z","direction","DirectionalLight","POSITIONS","TEX_COORDS","coord","super","vs","geometry","drawMode","vertexCount","attributes","aClipSpacePosition","aTexCoord","aCoordinate","setVertexCount","ScreenPass","fs","model","ClipSpace","outputBuffer","_renderPass","delete","inputBuffer","clear","draw","moduleSettings","uniforms","texture","texSize","depthWrite","Pass","PostProcessEffect","normalizeShaderModule","passes","getFragmentShaderForRenderPass","pass","idn","createPasses","swapBuffer","render","switchBuffer","FILTER_FS_TEMPLATE","SAMPLER_FS_TEMPLATE","filter","sampler","getViewMatrix","focalDistance","orbitAxis","rotationX","rotationOrbit","zoom","up","eye","viewMatrix","Matrix4","lookAt","rotateX","rotateZ","rotateY","projectionScale","pow","scale","OrbitViewport","projectionMatrix","fovy","fovyToAltitude","projectedCenter","project","center","xyz","topLeft","y2","pixelsToWorld","pixelUnprojectionMatrix","X","Y","Z","coords","p0","nextCenter","unproject","Viewport","theta","radius","bearing","pitch","radiusScale","check","formatString","other","v","copy","lng","lat","vec3","acos","FirstPersonViewport","dir","SphericalCoordinates","toVector3","normalize","transformAsVector","getMeterZoom","FirstPersonState","maxPitch","minPitch","startRotatePos","startBearing","startPitch","startZoomPosition","pos","_getUpdatedState","getViewportProps","newRotation","deltaAngleX","deltaAngleY","getState","getDirection","_move","log2","speed","negate","viewState","fromProps","fromPosition","Vector3","add","use2D","spherical","newProps","mod","ViewState","FirstPersonController","transitionDuration","transitionInterpolator","LinearInterpolator","Controller","FirstPersonView","View","OrbitView","OrbitController","GlobeState","maxZoom","minZoom","MapState","GlobeController","dragRotate","touchRotate","GlobeView","GlobeViewport","LINEARLY_INTERPOLATED_PROPS","DEFAULT_OPTS","curve","FlyToInterpolator","compare","extract","required","startProps","endProps","flyToViewport","getFlyToDuration","TransitionInterpolator","iterator","_toPropertyKey","arg","input","prim","toPrimitive","res","String","transformVector","matrix","vector","modulus","LOG2E","PI_4","DEFAULT_ALTITUDE","zoomToScale","scaleToZoom","lngLatToWorld","lngLat","phi2","worldToLngLat","xy","lambda2","atan","exp","unitsPerMeter","getDistanceScales","highPrecision","latCosine","unitsPerDegreeY","altUnitsPerMeter","metersPerUnit","unitsPerDegree","degreesPerUnit","latCosine2","unitsPerDegreeY2","altUnitsPerDegree2","altUnitsPerMeter2","unitsPerDegree2","unitsPerMeter2","addMetersToLngLat","lngLatZ","z0","worldspace","newLngLat","newZ","vm","mat4","relativeScale","getProjectionParameters","nearZMultiplier","farZMultiplier","altitudeToFovy","fovRadians","pitchRadians","cameraToSeaLevelDistance","fovAboveCenter","topHalfSurfaceDistance","furthestDistance","horizonDistance","fov","aspect","near","far","worldToPixels","pixelProjectionMatrix","targetZ","coord0","coord1","z1","vec2","fitBounds","bounds","minExtent","west","south","east","north","padding","top","bottom","left","right","getPaddingObject","nw","se","targetSize","offsetX","offsetY","centerLngLat","getBounds","unprojectOps","bottomLeft","bottomRight","topRight","unprojectOnFarPlane","distanceScales","normalizeViewportProps","halfHeightPixels","minLatitude","maxLatitude","VIEWPORT_TRANSITION_PROPS","startZoom","startCenterXY","uDelta","w0","u1","S","rho","rho2","r0","getFlyToTransitionParams","startValue","endValue","step","w","cosh","u","tanh","sinh","newZoom","newCenterWorld","newCenter","screenSpeed","maxDuration","duration","startCenter","startScale","endZoom","endCenter","endCenterXY","w1","_u1","b0","b1","r1","filename","url","slashIndex","lastIndexOf","substr","dirname","parts","part","replace","RegExp","Log","isBoolean","isFunction","isObject","isPureObject","isPromise","then","isIterable","isAsyncIterable","asyncIterator","isIterator","next","isResponse","Response","arrayBuffer","text","json","isBlob","Blob","isBuffer","isReadableStream","ReadableStream","tee","cancel","getReader","isReadableDOMStream","read","pipe","readable","isReadableNodeStream","isWritableStream","abort","getWriter","isWritableDOMStream","end","write","isWritableNodeStream","checkNumber","checkVector","callerName","validateVector","LIFECYCLE","NO_STATE","MATCHED","INITIALIZED","AWAITING_GC","AWAITING_FINALIZATION","FINALIZED","COMPONENT_SYMBOL","for","ASYNC_DEFAULTS_SYMBOL","ASYNC_ORIGINAL_SYMBOL","ASYNC_RESOLVED_SYMBOL","out","fromValues","len","dot","cross","ax","ay","az","bx","by","bz","transformMat4","transformMat3","transformQuat","q","qx","qy","qz","qw","uvx","uvy","uvz","uuvx","uuvy","uuvz","w2","rad","angle","mag","cosine","vec","mul","transpose","a01","a02","a03","a12","a13","a23","a00","a10","a11","a20","a21","a22","a30","a31","a32","a33","b00","b01","b02","b03","b04","b05","b06","b07","b08","b09","b10","b11","det","determinant","multiply","b2","b3","translate","rotate","axis","b12","b20","b21","b22","getScaling","mat","m11","m12","m13","m21","m22","m23","m31","m32","m33","fromQuat","x2","z2","xx","yx","yy","zx","zy","zz","wx","wy","wz","frustum","rl","tb","nf","perspective","Infinity","ortho","lr","bt","x0","x1","y0","y1","eyex","eyey","eyez","upx","upy","upz","centerx","centery","centerz","identity","a0","a1","a2","a3","a4","a5","a6","a7","a8","a9","a14","a15","b4","b5","b6","b7","b8","b9","b13","b14","b15","ReferenceError","loggers","register","handlers","eventType","arg1","arg2","arg3","deckLog","DEPRECATED_PROPS","integer","instanced","isInstanced","PROP_CHECKS_INITIALIZE","removedProps","replacedProps","bytes","deprecatedProps","PROP_CHECKS_SET_PROPS","Buffer","stubRemovedMethods","initialize","accessor","byteLength","getBytesPerElement","getBytesPerVertex","data","usage","debugData","setAccessor","_setData","_setByteLength","bytesUsed","srcOffset","bufferSubData","_inferType","sourceBuffer","readOffset","writeOffset","copyBufferSubData","dstData","srcByteOffset","dstOffset","ArrayType","clamped","sourceAvailableElementCount","_getAvailableElementCount","dstElementOffset","dstAvailableElementCount","dstElementCount","copyElementCount","getBufferSubData","bindBufferRange","bindBufferBase","changed","getData","_trackDeallocatedMemory","_getTarget","bufferData","slice","_trackAllocatedMemory","sourceElementOffset","BYTES_PER_ELEMENT","getElementCount","createBuffer","deleteBuffer","getBufferParameter","reallocate","transformMat2","transformMat2d","sub","createMat4","getCameraPosition","viewMatrixInverse","getFrustumPlanes","viewProjectionMatrix","getFrustumPlane","scratchArray","scratchVector","set","distance","normal","fp64LowPart","fround","toDoublePrecisionArray","typedArray","startIndex","endIndex","count","typedArrayManager","allocate","sourceIndex","targetIndex","j","subarray","squaredLength","aw","ix","iy","iz","iw","exactEquals","WINDING","CLOCKWISE","COUNTER_CLOCKWISE","modifyPolygonWindingDirection","points","sign","getPolygonSignedArea","getPolygonWindingDirection","start","numPoints","numSwaps","tmp","reversePolygon","dim","area","earcut","positions","holeIndices","areas","hasHoles","outerLen","outerNode","linkedList","triangles","prev","invSize","maxX","maxY","minX","minY","queue","steiner","getLeftmost","sort","compareX","eliminateHole","filterPoints","eliminateHoles","earcutLinked","clockwise","last","insertNode","removeNode","again","ear","zOrder","prevZ","nextZ","numMerges","pSize","qSize","tail","inSize","sortLinked","indexCurve","stop","isEarHashed","isEar","cureLocalIntersections","splitEarcut","pointInTriangle","minTX","minTY","maxTX","maxTY","minZ","maxZ","intersects","locallyInside","isValidDiagonal","splitPolygon","hole","hx","hy","mx","my","tanMin","sectorContainsSector","findHoleBridge","leftmost","cx","cy","px","py","intersectsPolygon","inside","middleInside","p1","p2","q1","q2","o1","o2","o3","o4","onSegment","num","Node","an","bp","source","isDuplicate","getPointAtIndex","startI","intersect","edge","bbox","snap","bitCode","code","cutPolylineByGrid","broken","gridResolution","gridOffset","codeB","cell","getGridCell","scratchPoint","codeAlt","moveToNeighborCell","concatInPlace","arr1","arr2","cutPolygonByGrid","edgeTypes","types","fill","holes","shift","getBoundingBox","bisectPolygon","polygonLow","polygonHigh","polygon","resultLow","resultHigh","typesLow","typesHigh","side","prevSide","prevType","lowPointCount","highPointCount","cutPolylineByMercatorBounds","newPositions","wrapLongitudesForShortestPath","shiftLongitudesIntoRange","cutPolygonByMercatorBounds","newHoleIndices","srcStartIndex","ringIndex","srcEndIndex","targetStartIndex","splitIndex","findSplitIndex","insertPoleVertices","maxLat","pointIndex","firstLng","lastLng","prevLng","refLng","pointCount","ERR_RESOURCE_METHOD_UNDEFINED","Resource","userData","gl2","_bound","_handle","_createHandle","_initStats","_addStats","deleteChildren","children","_deleteHandle","_removeStats","child","funcOrHandle","_bindHandle","parameter","PARAMETERS","isWebgl2","webgl1Default","webgl2Default","_getParameter","_setParameter","setParameter","className","methodNames","stats","incrementCount","decrementCount","_doTrackAllocatedMemory","addCount","_doTrackDeallocatedMemory","subtractCount","arrayWithoutHoles","iterableToArray","nonIterableSpread","deck","ZERO_VECTOR","DEFAULT_DISTANCE_SCALES","displayName","_initProps","_initMatrices","unprojectPosition","projectFlat","unprojectFlat","worldPosition","targetZWorld","unprojectOption","_frustumPlanes","meterOffset","orthographic","fovyRadians","viewMatrixUncentered","multiplyRight","createProjectionMatrix","vpm","cameraPosition","viewportMatrix","padArrayChunk","sourceLength","targetLength","datum","DEFAULT_TRANSITION_SETTINGS","interpolation","easing","spring","stiffness","damping","normalizeTransitionSettings","userSettings","layerSettings","getSourceBufferAttribute","attribute","getBuffer","settings","getAttributeTypeFromSize","cycleBuffers","buffers","getAttributeBufferLength","numInstances","doublePrecision","multiplier","Float64Array","noAlloc","padBuffer","fromLength","fromStartIndices","precisionMultiplier","byteOffset","toStartIndices","startIndices","hasStartIndices","toLength","isConstant","toData","chunk","normalizeConstant","getMissingData","sourceStartIndices","targetStartIndices","getChunkData","nextSourceIndex","nextTargetIndex","padArray","subData","cachedSetTimeout","cachedClearTimeout","process","defaultSetTimout","defaultClearTimeout","runTimeout","fun","setTimeout","clearTimeout","currentQueue","draining","queueIndex","cleanUpNextTick","drainQueue","timeout","run","marker","runClearTimeout","Item","noop","nextTick","title","browser","env","argv","versions","on","addListener","once","off","removeListener","removeAllListeners","emit","prependListener","prependOnceListener","listeners","binding","cwd","chdir","umask","isLoaderObject","loader","_loader","normalizeLoader","_loader2","_loader3","parseTextSync","parseText","binary","LocalStorage","defaultSettings","storage","setItem","removeItem","getStorage","_loadConfiguration","configuration","updateConfiguration","serialized","JSON","stringify","serializedConfiguration","getItem","parse","formatImage","image","maxWidth","imageUrl","COLOR","BLACK","RED","GREEN","YELLOW","BLUE","MAGENTA","CYAN","WHITE","BRIGHT_BLACK","BRIGHT_RED","BRIGHT_GREEN","BRIGHT_YELLOW","BRIGHT_BLUE","BRIGHT_MAGENTA","BRIGHT_CYAN","BRIGHT_WHITE","getColor","toUpperCase","getHiResTimestamp","performance","now","hrtime","timeParts","Date","originalConsole","DEFAULT_SETTINGS","ONCE","getTableHeader","table","VERSION","_startTs","_deltaTs","LOG_THROTTLE_TIMEOUT","_storage","timeStamp","predefined","proto","propNames","find","autobind","newLevel","setLevel","getLevel","newPriority","_getLogFunction","oldUsage","newUsage","logLevel","time","columns","tag","priority","_shouldLog","img","Image","onload","element","nodeName","toLowerCase","toDataURL","logImageInBrowser","asciify","fit","logImageInNode","setting","timeEnd","collapsed","normalizeArguments","method","groupCollapsed","group","groupEnd","trace","normalizeLogLevel","total","getTotal","getDelta","string","padLength","repeat","leftPad","ms","formatted","toFixed","formatTime","background","decorateMessage","resolvedLevel","from","unshift","messageType","probeLog","NullLog","DEFAULT_LOADER_OPTIONS","fetch","mimeType","nothrow","CDN","worker","maxConcurrency","maxMobileConcurrency","reuseWorkers","_nodeWorkers","_workerType","_limitMB","batchSize","batchDebounceMs","metadata","transforms","REMOVED_LOADER_OPTIONS","throws","dataType","uri","headers","credentials","redirect","referrer","referrerPolicy","integrity","keepalive","signal","getGlobalLoaderState","loaders","_state","getGlobalLoaderOptions","globalOptions","setGlobalOptions","normalizeOptionsInternal","normalizeOptions","validateOptionsObject","idOptions","loaderOptions","deprecatedOptions","validateOptions","getFetchFunction","fetchOptions","defaultOptions","loaderName","prefix","isSubOptions","isBaseUriOption","isWorkerUrlOption","suggestion","findSimilarOption","optionKey","lowerCaseOptionKey","bestSuggestion","lowerCaseKey","startsWith","mergedOptions","baseUri","addUrlOptions","mergeNestedFields","uidCounters","uid","isPowerOfTwo","isEmpty","getKeyValue","number","isNaN","getKey","globals","global","global_","isWorker","importScripts","isMobile","orientation","matches","exec","DEFAULT_PROPS","DEFAULT_REQUIRED_PROPS","transitionProps","normalizedOpts","makeViewport","around","startViewport","endViewport","aroundPosition","propsInTransition","_propsToExtract","panByPosition","EMPTY_ARRAY","placeholderArray","createIterable","startRow","endRow","iterable","objectInfo","getAccessorFromBuffer","nested","bytesPerElement","elementStride","elementOffset","_","getGLTypeFromTypedArray","arrayOrType","Uint16Array","Uint32Array","Uint8Array","Uint8ClampedArray","Int8Array","Int16Array","getTypedArrayFromGLType","glType","flipRows","bytesPerPixel","temp","bytesPerRow","topOffset","bottomOffset","copyWithin","newWidth","newHeight","newData","NPOT_MIN_FILTERS","WebGLBuffer","Texture","linearFiltering","supported","textureUnit","loaded","dataFormat","border","mipmaps","Promise","resolvedImageData","isVideo","HTMLVideoElement","HAVE_METADATA","_video","recreate","pixelStore","compressed","_deduceParameters","activeTexture","bindTexture","_isNPOT","_updateForNPOT","setImageData","generateMipmap","video","lastTime","HAVE_CURRENT_DATA","currentTime","setSubImageData","_getDataType","compressedTextureSize","texImage2D","levelIndex","levelData","entries","compressedTexImage2D","levelSize","channels","channelSize","ndarray","shape","compressedTexSubImage2D","texSubImage2D","_ref3","textureFormat","_deduceImageSize","ImageData","HTMLImageElement","naturalWidth","naturalHeight","HTMLCanvasElement","ImageBitmap","videoWidth","videoHeight","createTexture","deleteTexture","getTexParameter","param","_getNPOTParam","texParameterf","texParameteri","TEXTURE_MIN_FILTER","LINEAR","TEXTURE_WRAP_S","CLAMP_TO_EDGE","TEXTURE_WRAP_T","vec2_transformMat4AsVector","vec3_transformMat4AsVector","vec3_transformMat2","vec4_transformMat2","vec4_transformMat3","NO_TRANSITION_PROPS","INERTIA_EASING","EVENT_TYPES","pinchEventWorkaround","isDragging","transitionManager","TransitionManager","getControllerState","ControllerState","onViewStateChange","_onTransition","onStateChange","_setInteractionState","handleEvent","eventManager","customEvents","toggleEvents","_customEvents","setProps","eventName","_events","finalize","event","_controllerState","eventStartBlocked","_eventStartBlocked","_onPanStart","_onPan","_onPanEnd","_onPinchStart","_onPinch","_onPinchEnd","_onTriplePanStart","_onTriplePan","_onTriplePanEnd","_onDoubleTap","_onWheel","_onKeyDown","offsetCenter","handled","stopPropagation","srcEvent","metaKey","altKey","ctrlKey","shiftKey","_interactionState","timer","dragMode","_getTransitionProps","processViewStateChange","inertia","scrollZoom","dragPan","doubleClickZoom","touchZoom","keyboard","isInteractive","updateTransition","eventNames","newControllerState","extraProps","interactionState","controllerState","oldViewState","newStates","getCenter","isPointInBounds","alternateMode","isFunctionKeyPressed","rightButton","invertPan","_panMove","updateViewport","_onPanMove","_onPanRotate","_onPanMoveEnd","_onPanRotateEnd","pan","isPanning","velocity","endPos","velocityX","velocityY","panEnd","transitionEasing","isRotating","rotateEnd","preventDefault","smooth","isZooming","rotateStart","deltaX","blockEvents","zoomStart","_startPinchRotation","rotation","_lastPinchEvent","velocityZ","deltaTime","endScale","zoomEnd","isZoomOut","funcKey","zoomSpeed","moveSpeed","rotateSpeedX","rotateSpeedY","zoomOut","zoomIn","rotateLeft","moveLeft","rotateRight","moveRight","rotateUp","moveUp","rotateDown","moveDown","transition","PERCENT_OR_PIXELS_REGEX","parsePosition","relative","match","getPosition","extent","viewportInstance","_x","_y","_width","_height","_padding","view","ViewportType","deepEqual","filterViewState","viewportDimensions","getDimensions","newViewState","dimensions","controller","ControllerType","DRAW_MODE","POINTS","LINES","LINE_LOOP","LINE_STRIP","TRIANGLES","TRIANGLE_STRIP","TRIANGLE_FAN","Geometry","indices","_setAttributes","_calculateVertexCount","attributeName","_print","isIndexed","constant","aValue","bValue","DATA_URL_PATTERN","MIME_TYPE_PATTERN","parseMIMEType","mimeString","parseMIMETypeFromURL","QUERY_STRING_PATTERN","getResourceUrlAndType","resource","stripQueryString","getResourceContentLength","DEFAULT_ACCESSOR_VALUES","PROP_CHECKS","Accessor","accessors","_len2","_key2","_assign","freeze","OUTER_POLYGON_WINDING","HOLE_POLYGON_WINDING","windingOptions","isClosed","getPositions","getHoleIndices","isFlatRingClosed","copyNestedRing","simplePolygon","windingDirection","isNestedRingClosed","copyFlatRing","srcLength","positionSize","validate","srcPositions","srcHoleIndices","isNested","isSimple","polygonIndex","getPlaneArea","xIndex","yIndex","numVerts","permutePositions","zIndex","getSurfaceIndices","preproject","full3d","positionIndex","is3d","xyArea","xzArea","yzArea","async","readArrayBuffer","file","_readToArrayBuffer","blob","resolve","reject","fileReader","FileReader","_event$target","onerror","readAsArrayBuffer","readBlob","readFileSync","writeFile","filePath","arrayBufferOrString","flag","writeFileSync","parseSync","typedLoaders","candidateLoaders","parseWithLoaderSync","parseInBatches","outputIterator","inputIterator","transformedIterator","iteratorChain","transformBatches","applyInputTransforms","parsedData","mimeTypes","batch","batchType","parseChunkInBatches","parseToOutputIterator","metadataBatch","_context","makeMetadataBatchIterator","parseWithLoaderInBatches","loadInBatches","files","loadOneFileInBatches","response","processOnWorker","workerFarm","getWorkerFarm","workerPoolProps","workerPool","getWorkerPool","jobName","job","startJob","onMessage","transferableOptions","postMessage","payload","done","encode","writer","encodeSync","encodeText","TextEncoder","encodeInBatches","batches","chunks","encodeURLtoURL","tmpInputFilename","getTemporaryFilename","tmpOutputFilename","outputFilename","TextDecoder","decode","dataIterator","getIterator","inputUrl","outputUrl","save","encodedData","saveSync","makeStream","close","enqueue","_iterator$return","return","highWaterMark","NullWorkerLoader","tests","null","echoParameters","NullLoader","fetchProgress","onProgress","onDone","ok","contentLength","totalBytes","progressStream","reader","loadedBytes","percent","_fetch","lowerCaseFiles","usedFiles","path","includes","status","statusText","range","Headers","pathname","flags","fd","bytesRead","used","DEFAULT_INDICES","DEFAULT_TEX_COORDS","createMesh","texCoords","createQuad","maxXSpan","maxYSpan","uCount","ceil","vCount","vertex","ut","vt","interpolateQuad","quad","defaultProps","_imageCoordinateSystem","desaturate","transparentColor","tintColor","BitmapLayer","project32","picking","attributeManager","getAttributeManager","remove","mesh","fp64","use64bitPositions","oldProps","changeFlags","extensionsChanged","_getModel","invalidateAll","oldMesh","_createMesh","invalidate","setState","_getCoordinateUniforms","bitmap","fracUV","uv","disablePicking","encodePickingColor","normalizedBounds","isRectangularBounds","Model","getShaders","moduleParameters","coordinateConversion","pickingActive","setUniforms","bitmapTexture","imageCoordinateSystem","defaultImageCoordinateSystem","Layer","flatten","flattenArray","fillArray","copied","TypedArrayManager","overAlloc","poolSize","setOptions","maxCount","Type","newSize","maxSize","newArray","_allocate","_release","sizeToAllocate","pool","_pool","findIndex","asyncGeneratorStep","gen","_next","_throw","fn","Function","self_","window_","document_","LayersPass","_drawLayers","viewports","views","onViewportActive","clearStack","clearCanvas","clearGLCanvas","_lastRenderIndex","renderStats","drawLayerParams","_getDrawLayerParams","subViewports","subViewport","_drawLayersInViewport","layers","layerFilter","cullRect","effects","indexResolver","layerIndexResolver","layerIndices","resolvers","resolveLayerIndex","isDrawn","indexOverride","_offset","layerId","parentId","parent","resolver","drawContext","isPicking","renderPass","layerFilterCache","layerIndex","shouldDrawLayer","_shouldDrawLayer","layerParam","layerRenderIndex","_getModuleParameters","layerParameters","getLayerParameters","globalModuleParameters","glViewport","useTarget","pixelRatio","getGLViewport","clearOpts","renderStatus","totalCount","visibleCount","compositeCount","pickableCount","pickable","isComposite","_drawLayer","raiseError","visible","filterSubLayer","rootLayerId","activateViewport","overrides","internalState","autoWrapLongitude","wrapLongitude","mousePosition","effect","getModuleParameters","Framebuffer","colorBufferFloat","colorBufferHalfFloat","defaultFramebuffer","attachments","MAX_COLOR_ATTACHMENTS","MAX_DRAW_BUFFERS","ownResources","stencil","_createDefaultAttachments","clearAttachments","checkStatus","resizeAttachments","attach","prevHandle","_setReadBuffer","_setDrawBuffers","attachmentPoint","newAttachments","_attachRenderbuffer","renderbuffer","_attachTexture","_unattach","getStatus","STATUS","_getFrameBufferStatus","checkFramebufferStatus","drawBuffer","invalidateFramebuffer","_getAttachmentParameterFallback","getFramebufferAttachmentParameter","ATTACHMENT_PARAMETERS","getAttachmentParameter","attachmentName","getAttachmentParameters","open","targetMaxHeight","defaultAttachments","oldAttachment","framebufferRenderbuffer","framebufferTexture2D","_ref4","_ref5","framebufferTextureLayer","mapIndexToCubeMapFace","drawBuffersWEBGL","caps","WEBGL2","EXT_sRGB","createFramebuffer","deleteFramebuffer","Transition","timeline","_inProgress","_timeline","onStart","removeChannel","onEnd","onInterrupt","addChannel","delay","_onUpdate","onUpdate","isFinished","reset","samples","sampleSize","_count","_samples","_checkSampling","_time","lastTiming","_startTime","_timerPending","addTime","lastSampleCount","lastSampleTime","_initializeStats","_getOrCreate","stat","average","getAverageTime","hz","getHz","VERTEX_SHADER","FRAGMENT_SHADER","INDICES","DEFAULT_FOVY","DEFAULT_ASPECT","DEFAULT_NEAR","DEFAULT_FAR","IDENTITY_MATRIX","getIdentityMatrix","ZERO","getZeroMatrix","m00","m10","m20","m30","m01","m02","m03","quaternion","column0Row0","column1Row1","column2Row0","column2Row1","column3Row2","computeInfinitePerspectiveOffCenter","checkRadians","halfY","scaleResult","getScale","inverseScale0","inverseScale1","inverseScale2","angleXYZ","transformAsPoint","possiblyDegrees","EXT_PATTERN","selectLoader","validHTTPResponse","selectLoaderSync","getNoValidLoaderMessage","ignoreRegisteredLoaders","normalizeLoaders","testUrl","reason","findLoaderByMIMEType","loaderExtension","findLoaderByExtension","findLoaderByUrl","testDataAgainstText","testDataAgainstBinary","findLoaderByInitialBytes","getFirstCharacters","fallbackMimeType","selectLoaderInternal","firstCharacters","testText","some","test","magic","getMagicString","testBinary","dataView","fromCharCode","getUint8","isEqual","memoize","compute","cachedResult","cachedArgs","COMPOSITE_GL_TYPES","getPrimitiveDrawMode","decomposeCompositeGLType","compositeGLType","typeAndSize","components","getCompositeGLType","compType","compComponents","TEXTURE_FORMATS","DATA_FORMAT_CHANNELS","TYPE_SIZES","isFormatSupported","gl1","isLinearFilteringSupported","sqrLen","ORIGIN","origin","matrix4","matrix3","matrix2","toArrayBuffer","_toArrayBuffer","compareArrayBuffers","arrayBuffer1","arrayBuffer2","array1","array2","concatenateArrayBuffers","sources","sourceArrays","source2","reduce","sourceArray","sliceArrayBuffer","subArray","WebMercatorViewport","worldOffset","legacyMeterSizes","projectionParameters","viewOffset","multiplyLeft","_subViewports","_pseudoMeters","minOffset","maxOffset","offsetViewport","fromLocation","toLocation","corners","convertToObjectRow","arrayRow","objectRow","convertToArrayRow","_Symbol$asyncIterator","ArrayQueue","_values","_settlers","_closed","dequeue","settler","schema","_headers","row","cursor","rows","rowObject","addObjectRow","arrayRows","rowArray","addArrayRow","objectRows","_reallocateColumns","fieldName","_pruneColumns","field","allocated","oldColumn","columnName","column","DEFAULT_OPTIONS","_this$options","_this$options2","totalLength","limitReached","rowBytes","_estimateRowMB","aggregator","TableBatchType","_getTableBatchType","isChunkComplete","_isFull","_getBatch","rowCount","lastBatchEmittedMs","normalizedBatch","getBatch","batchCount","ArrowBatch","Papa","_input","_config","UserDefinedStreamer","dynamicTyping","dynamicTypingFunction","transform","WORKERS_SUPPORTED","newWorker","userStep","userChunk","userComplete","complete","userError","workerId","streamer","StringStreamer","stream","unparse","_quotes","_writeHeader","_delimiter","_newline","_quoteChar","_escapedQuote","_skipEmptyLines","_columns","delimiter","BAD_DELIMITERS","quotes","skipEmptyLines","newline","quoteChar","header","escapeChar","unpackConfig","quoteCharRegex","escapeRegExp","serialize","objectKeys","fields","csv","hasHeader","dataKeyedByField","safe","maxCol","emptyLine","nullLine","trim","line","col","colIdx","str","toString","substrings","hasAny","charAt","RECORD_SEP","UNIT_SEP","BYTE_ORDER_MARK","NODE_STREAM_INPUT","LocalChunkSize","RemoteChunkSize","DefaultDelimiter","Parser","ParserHandle","ChunkStreamer","_finished","_completed","_baseIndex","_partialLine","_rowCount","_start","_nextChunk","isFirstChunk","_completeResults","errors","configCopy","chunkSize","parseChunk","isFakeChunk","beforeFirstChunk","modifiedChunk","aggregate","results","paused","aborted","lastIndex","substring","finishedIncludingPreview","preview","_sendError","remaining","_parser","_delimiterError","FLOAT","ISO_DATE","_stepCounter","_rowCounter","_paused","_aborted","_fields","_results","needsHeaderRow","processResults","testEmptyLine","addError","addHeder","transformHeader","fillHeaderFields","processRow","rowSource","parseDynamic","incrementBy","applyHeaderAndDynamicTypingAndTransformation","shouldApplyDynamicTyping","baseIndex","ignoreLastRow","re","split","nAppearsFirst","numWithN","guessLineEndings","delimGuess","comments","delimitersToGuess","bestDelim","bestDelta","fieldCountPrevRow","delim","avgFieldCount","emptyLinesCount","fieldCount","successful","bestDelimiter","guessDelimiter","parserConfig","pause","getCharIndex","resume","fastMode","inputLen","delimLen","newlineLen","commentsLen","stepIsFunction","lastCursor","returnable","pushRow","doStep","quoteSearch","nextDelim","nextNewline","saveRow","finish","spacesBetweenQuoteAndDelimiter","extraSpaces","spacesBetweenQuoteAndNewLine","spaceLength","textBetweenClosingQuoteAndIndex","newCursor","stopped","linebreak","truncated","cpy","AsyncIteratorStreamer","textDecoder","encoding","getStringChunk","DEFAULT_CSV_LOADER_OPTIONS","optimizeMemoryUsage","columnPrefix","CSVLoader","category","parseCSV","_options","csvOptions","asyncQueue","isFirstRow","headerRow","tableBatchBuilder","download","flat","isHeaderRow","duplicateColumnTransformer","generateHeader","deduceSchema","addRow","getFullBatch","getFinalBatch","csvText","firstRow","readFirstRow","parseWithHeader","papaparseConfig","every","observedColumns","Set","colName","counter","has","defaultConfig","_window$performance","_window$performance$n","_process$hrtime","setConfiguration","_len3","_key3","_len4","_key4","getGlobalLoaderRegistry","loaderRegistry","lastPickedObject","lastTooltip","DEFAULT_STYLE","fontFamily","display","flex","flexDirection","getDiv","getTooltipDefault","pickedInfo","picked","tooltip","html","tabularize","EXCLUDES","dataTable","textContent","valueElement","toText","setStyles","appendChild","innerHTML","fontWeight","marginRight","overflow","whiteSpace","textOverflow","justifyContent","alignItems","jsonValue","substituteIn","template","output","k","subkey","replaceAll","scriptLoadPromises","BOX_STYLE","margin","overflowX","overflowY","outline","maxHeight","boxSizing","backgroundColor","DescriptionCard","container","description","div","el","textContainer","append","classesFilter","functionsFilter","extractElements","library","dict","elements","jsonConverterConfiguration","classes","enumerations","GL","DEPTH_BUFFER_BIT","STENCIL_BUFFER_BIT","COLOR_BUFFER_BIT","ONE","SRC_COLOR","ONE_MINUS_SRC_COLOR","SRC_ALPHA","ONE_MINUS_SRC_ALPHA","DST_ALPHA","ONE_MINUS_DST_ALPHA","DST_COLOR","ONE_MINUS_DST_COLOR","SRC_ALPHA_SATURATE","CONSTANT_COLOR","ONE_MINUS_CONSTANT_COLOR","CONSTANT_ALPHA","ONE_MINUS_CONSTANT_ALPHA","FUNC_ADD","FUNC_SUBTRACT","FUNC_REVERSE_SUBTRACT","BLEND_EQUATION","BLEND_EQUATION_RGB","BLEND_EQUATION_ALPHA","BLEND_DST_RGB","BLEND_SRC_RGB","BLEND_DST_ALPHA","BLEND_SRC_ALPHA","BLEND_COLOR","ARRAY_BUFFER_BINDING","ELEMENT_ARRAY_BUFFER_BINDING","LINE_WIDTH","ALIASED_POINT_SIZE_RANGE","ALIASED_LINE_WIDTH_RANGE","CULL_FACE_MODE","FRONT_FACE","DEPTH_RANGE","DEPTH_WRITEMASK","DEPTH_CLEAR_VALUE","DEPTH_FUNC","STENCIL_CLEAR_VALUE","STENCIL_FUNC","STENCIL_FAIL","STENCIL_PASS_DEPTH_FAIL","STENCIL_PASS_DEPTH_PASS","STENCIL_REF","STENCIL_VALUE_MASK","STENCIL_WRITEMASK","STENCIL_BACK_FUNC","STENCIL_BACK_FAIL","STENCIL_BACK_PASS_DEPTH_FAIL","STENCIL_BACK_PASS_DEPTH_PASS","STENCIL_BACK_REF","STENCIL_BACK_VALUE_MASK","STENCIL_BACK_WRITEMASK","VIEWPORT","SCISSOR_BOX","COLOR_CLEAR_VALUE","COLOR_WRITEMASK","UNPACK_ALIGNMENT","PACK_ALIGNMENT","MAX_TEXTURE_SIZE","MAX_VIEWPORT_DIMS","SUBPIXEL_BITS","RED_BITS","GREEN_BITS","BLUE_BITS","ALPHA_BITS","DEPTH_BITS","STENCIL_BITS","POLYGON_OFFSET_UNITS","POLYGON_OFFSET_FACTOR","TEXTURE_BINDING_2D","SAMPLE_BUFFERS","SAMPLES","SAMPLE_COVERAGE_VALUE","SAMPLE_COVERAGE_INVERT","COMPRESSED_TEXTURE_FORMATS","VENDOR","RENDERER","IMPLEMENTATION_COLOR_READ_TYPE","IMPLEMENTATION_COLOR_READ_FORMAT","BROWSER_DEFAULT_WEBGL","STATIC_DRAW","STREAM_DRAW","DYNAMIC_DRAW","ARRAY_BUFFER","ELEMENT_ARRAY_BUFFER","BUFFER_SIZE","BUFFER_USAGE","CURRENT_VERTEX_ATTRIB","VERTEX_ATTRIB_ARRAY_ENABLED","VERTEX_ATTRIB_ARRAY_SIZE","VERTEX_ATTRIB_ARRAY_STRIDE","VERTEX_ATTRIB_ARRAY_TYPE","VERTEX_ATTRIB_ARRAY_NORMALIZED","VERTEX_ATTRIB_ARRAY_POINTER","VERTEX_ATTRIB_ARRAY_BUFFER_BINDING","CULL_FACE","FRONT","BACK","FRONT_AND_BACK","BLEND","DEPTH_TEST","DITHER","POLYGON_OFFSET_FILL","SAMPLE_ALPHA_TO_COVERAGE","SAMPLE_COVERAGE","SCISSOR_TEST","STENCIL_TEST","NO_ERROR","INVALID_ENUM","INVALID_VALUE","INVALID_OPERATION","OUT_OF_MEMORY","CONTEXT_LOST_WEBGL","CW","CCW","DONT_CARE","FASTEST","NICEST","GENERATE_MIPMAP_HINT","BYTE","UNSIGNED_BYTE","SHORT","UNSIGNED_SHORT","INT","UNSIGNED_INT","DOUBLE","DEPTH_COMPONENT","ALPHA","RGB","RGBA","LUMINANCE","LUMINANCE_ALPHA","UNSIGNED_SHORT_4_4_4_4","UNSIGNED_SHORT_5_5_5_1","UNSIGNED_SHORT_5_6_5","COMPILE_STATUS","DELETE_STATUS","LINK_STATUS","VALIDATE_STATUS","ATTACHED_SHADERS","ACTIVE_ATTRIBUTES","ACTIVE_UNIFORMS","MAX_VERTEX_ATTRIBS","MAX_VERTEX_UNIFORM_VECTORS","MAX_VARYING_VECTORS","MAX_COMBINED_TEXTURE_IMAGE_UNITS","MAX_VERTEX_TEXTURE_IMAGE_UNITS","MAX_TEXTURE_IMAGE_UNITS","MAX_FRAGMENT_UNIFORM_VECTORS","SHADER_TYPE","SHADING_LANGUAGE_VERSION","CURRENT_PROGRAM","NEVER","ALWAYS","LESS","EQUAL","LEQUAL","GREATER","GEQUAL","NOTEQUAL","KEEP","REPLACE","INCR","DECR","INVERT","INCR_WRAP","DECR_WRAP","NEAREST","NEAREST_MIPMAP_NEAREST","LINEAR_MIPMAP_NEAREST","NEAREST_MIPMAP_LINEAR","LINEAR_MIPMAP_LINEAR","TEXTURE_MAG_FILTER","TEXTURE_2D","TEXTURE","TEXTURE_CUBE_MAP","TEXTURE_BINDING_CUBE_MAP","TEXTURE_CUBE_MAP_POSITIVE_X","TEXTURE_CUBE_MAP_NEGATIVE_X","TEXTURE_CUBE_MAP_POSITIVE_Y","TEXTURE_CUBE_MAP_NEGATIVE_Y","TEXTURE_CUBE_MAP_POSITIVE_Z","TEXTURE_CUBE_MAP_NEGATIVE_Z","MAX_CUBE_MAP_TEXTURE_SIZE","TEXTURE0","ACTIVE_TEXTURE","REPEAT","MIRRORED_REPEAT","TEXTURE_WIDTH","TEXTURE_HEIGHT","FLOAT_VEC2","FLOAT_VEC3","FLOAT_VEC4","INT_VEC2","INT_VEC3","INT_VEC4","BOOL","BOOL_VEC2","BOOL_VEC3","BOOL_VEC4","FLOAT_MAT2","FLOAT_MAT3","FLOAT_MAT4","SAMPLER_2D","SAMPLER_CUBE","LOW_FLOAT","MEDIUM_FLOAT","HIGH_FLOAT","LOW_INT","MEDIUM_INT","HIGH_INT","FRAMEBUFFER","RENDERBUFFER","RGBA4","RGB5_A1","RGB565","DEPTH_COMPONENT16","STENCIL_INDEX","STENCIL_INDEX8","DEPTH_STENCIL","RENDERBUFFER_WIDTH","RENDERBUFFER_HEIGHT","RENDERBUFFER_INTERNAL_FORMAT","RENDERBUFFER_RED_SIZE","RENDERBUFFER_GREEN_SIZE","RENDERBUFFER_BLUE_SIZE","RENDERBUFFER_ALPHA_SIZE","RENDERBUFFER_DEPTH_SIZE","RENDERBUFFER_STENCIL_SIZE","FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE","FRAMEBUFFER_ATTACHMENT_OBJECT_NAME","FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL","FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE","COLOR_ATTACHMENT0","DEPTH_ATTACHMENT","STENCIL_ATTACHMENT","DEPTH_STENCIL_ATTACHMENT","NONE","FRAMEBUFFER_COMPLETE","FRAMEBUFFER_INCOMPLETE_ATTACHMENT","FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT","FRAMEBUFFER_INCOMPLETE_DIMENSIONS","FRAMEBUFFER_UNSUPPORTED","FRAMEBUFFER_BINDING","RENDERBUFFER_BINDING","READ_FRAMEBUFFER","DRAW_FRAMEBUFFER","MAX_RENDERBUFFER_SIZE","INVALID_FRAMEBUFFER_OPERATION","UNPACK_FLIP_Y_WEBGL","UNPACK_PREMULTIPLY_ALPHA_WEBGL","UNPACK_COLORSPACE_CONVERSION_WEBGL","READ_BUFFER","UNPACK_ROW_LENGTH","UNPACK_SKIP_ROWS","UNPACK_SKIP_PIXELS","PACK_ROW_LENGTH","PACK_SKIP_ROWS","PACK_SKIP_PIXELS","TEXTURE_BINDING_3D","UNPACK_SKIP_IMAGES","UNPACK_IMAGE_HEIGHT","MAX_3D_TEXTURE_SIZE","MAX_ELEMENTS_VERTICES","MAX_ELEMENTS_INDICES","MAX_TEXTURE_LOD_BIAS","MAX_FRAGMENT_UNIFORM_COMPONENTS","MAX_VERTEX_UNIFORM_COMPONENTS","MAX_ARRAY_TEXTURE_LAYERS","MIN_PROGRAM_TEXEL_OFFSET","MAX_PROGRAM_TEXEL_OFFSET","MAX_VARYING_COMPONENTS","FRAGMENT_SHADER_DERIVATIVE_HINT","RASTERIZER_DISCARD","VERTEX_ARRAY_BINDING","MAX_VERTEX_OUTPUT_COMPONENTS","MAX_FRAGMENT_INPUT_COMPONENTS","MAX_SERVER_WAIT_TIMEOUT","MAX_ELEMENT_INDEX","RGB8","RGBA8","RGB10_A2","TEXTURE_3D","TEXTURE_WRAP_R","TEXTURE_MIN_LOD","TEXTURE_MAX_LOD","TEXTURE_BASE_LEVEL","TEXTURE_MAX_LEVEL","TEXTURE_COMPARE_MODE","TEXTURE_COMPARE_FUNC","SRGB","SRGB8","SRGB8_ALPHA8","COMPARE_REF_TO_TEXTURE","RGBA32F","RGB32F","RGBA16F","RGB16F","TEXTURE_2D_ARRAY","TEXTURE_BINDING_2D_ARRAY","R11F_G11F_B10F","RGB9_E5","RGBA32UI","RGB32UI","RGBA16UI","RGB16UI","RGBA8UI","RGB8UI","RGBA32I","RGB32I","RGBA16I","RGB16I","RGBA8I","RGB8I","RED_INTEGER","RGB_INTEGER","RGBA_INTEGER","R8","RG8","R16F","R32F","RG16F","RG32F","R8I","R8UI","R16I","R16UI","R32I","R32UI","RG8I","RG8UI","RG16I","RG16UI","RG32I","RG32UI","R8_SNORM","RG8_SNORM","RGB8_SNORM","RGBA8_SNORM","RGB10_A2UI","TEXTURE_IMMUTABLE_FORMAT","TEXTURE_IMMUTABLE_LEVELS","UNSIGNED_INT_2_10_10_10_REV","UNSIGNED_INT_10F_11F_11F_REV","UNSIGNED_INT_5_9_9_9_REV","FLOAT_32_UNSIGNED_INT_24_8_REV","UNSIGNED_INT_24_8","HALF_FLOAT","RG","RG_INTEGER","INT_2_10_10_10_REV","CURRENT_QUERY","QUERY_RESULT","QUERY_RESULT_AVAILABLE","ANY_SAMPLES_PASSED","ANY_SAMPLES_PASSED_CONSERVATIVE","DRAW_BUFFER0","DRAW_BUFFER1","DRAW_BUFFER2","DRAW_BUFFER3","DRAW_BUFFER4","DRAW_BUFFER5","DRAW_BUFFER6","DRAW_BUFFER7","DRAW_BUFFER8","DRAW_BUFFER9","DRAW_BUFFER10","DRAW_BUFFER11","DRAW_BUFFER12","DRAW_BUFFER13","DRAW_BUFFER14","DRAW_BUFFER15","COLOR_ATTACHMENT1","COLOR_ATTACHMENT2","COLOR_ATTACHMENT3","COLOR_ATTACHMENT4","COLOR_ATTACHMENT5","COLOR_ATTACHMENT6","COLOR_ATTACHMENT7","COLOR_ATTACHMENT8","COLOR_ATTACHMENT9","COLOR_ATTACHMENT10","COLOR_ATTACHMENT11","COLOR_ATTACHMENT12","COLOR_ATTACHMENT13","COLOR_ATTACHMENT14","COLOR_ATTACHMENT15","SAMPLER_3D","SAMPLER_2D_SHADOW","SAMPLER_2D_ARRAY","SAMPLER_2D_ARRAY_SHADOW","SAMPLER_CUBE_SHADOW","INT_SAMPLER_2D","INT_SAMPLER_3D","INT_SAMPLER_CUBE","INT_SAMPLER_2D_ARRAY","UNSIGNED_INT_SAMPLER_2D","UNSIGNED_INT_SAMPLER_3D","UNSIGNED_INT_SAMPLER_CUBE","UNSIGNED_INT_SAMPLER_2D_ARRAY","MAX_SAMPLES","SAMPLER_BINDING","PIXEL_PACK_BUFFER","PIXEL_UNPACK_BUFFER","PIXEL_PACK_BUFFER_BINDING","PIXEL_UNPACK_BUFFER_BINDING","COPY_READ_BUFFER","COPY_WRITE_BUFFER","COPY_READ_BUFFER_BINDING","COPY_WRITE_BUFFER_BINDING","FLOAT_MAT2x3","FLOAT_MAT2x4","FLOAT_MAT3x2","FLOAT_MAT3x4","FLOAT_MAT4x2","FLOAT_MAT4x3","UNSIGNED_INT_VEC2","UNSIGNED_INT_VEC3","UNSIGNED_INT_VEC4","UNSIGNED_NORMALIZED","SIGNED_NORMALIZED","VERTEX_ATTRIB_ARRAY_INTEGER","VERTEX_ATTRIB_ARRAY_DIVISOR","TRANSFORM_FEEDBACK_BUFFER_MODE","MAX_TRANSFORM_FEEDBACK_SEPARATE_COMPONENTS","TRANSFORM_FEEDBACK_VARYINGS","TRANSFORM_FEEDBACK_BUFFER_START","TRANSFORM_FEEDBACK_BUFFER_SIZE","TRANSFORM_FEEDBACK_PRIMITIVES_WRITTEN","MAX_TRANSFORM_FEEDBACK_INTERLEAVED_COMPONENTS","MAX_TRANSFORM_FEEDBACK_SEPARATE_ATTRIBS","INTERLEAVED_ATTRIBS","SEPARATE_ATTRIBS","TRANSFORM_FEEDBACK_BUFFER","TRANSFORM_FEEDBACK_BUFFER_BINDING","TRANSFORM_FEEDBACK","TRANSFORM_FEEDBACK_PAUSED","TRANSFORM_FEEDBACK_ACTIVE","TRANSFORM_FEEDBACK_BINDING","FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING","FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE","FRAMEBUFFER_ATTACHMENT_RED_SIZE","FRAMEBUFFER_ATTACHMENT_GREEN_SIZE","FRAMEBUFFER_ATTACHMENT_BLUE_SIZE","FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE","FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE","FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE","FRAMEBUFFER_DEFAULT","DEPTH24_STENCIL8","DRAW_FRAMEBUFFER_BINDING","READ_FRAMEBUFFER_BINDING","RENDERBUFFER_SAMPLES","FRAMEBUFFER_ATTACHMENT_TEXTURE_LAYER","FRAMEBUFFER_INCOMPLETE_MULTISAMPLE","UNIFORM_BUFFER","UNIFORM_BUFFER_BINDING","UNIFORM_BUFFER_START","UNIFORM_BUFFER_SIZE","MAX_VERTEX_UNIFORM_BLOCKS","MAX_FRAGMENT_UNIFORM_BLOCKS","MAX_COMBINED_UNIFORM_BLOCKS","MAX_UNIFORM_BUFFER_BINDINGS","MAX_UNIFORM_BLOCK_SIZE","MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS","MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS","UNIFORM_BUFFER_OFFSET_ALIGNMENT","ACTIVE_UNIFORM_BLOCKS","UNIFORM_TYPE","UNIFORM_SIZE","UNIFORM_BLOCK_INDEX","UNIFORM_OFFSET","UNIFORM_ARRAY_STRIDE","UNIFORM_MATRIX_STRIDE","UNIFORM_IS_ROW_MAJOR","UNIFORM_BLOCK_BINDING","UNIFORM_BLOCK_DATA_SIZE","UNIFORM_BLOCK_ACTIVE_UNIFORMS","UNIFORM_BLOCK_ACTIVE_UNIFORM_INDICES","UNIFORM_BLOCK_REFERENCED_BY_VERTEX_SHADER","UNIFORM_BLOCK_REFERENCED_BY_FRAGMENT_SHADER","OBJECT_TYPE","SYNC_CONDITION","SYNC_STATUS","SYNC_FLAGS","SYNC_FENCE","SYNC_GPU_COMMANDS_COMPLETE","UNSIGNALED","SIGNALED","ALREADY_SIGNALED","TIMEOUT_EXPIRED","CONDITION_SATISFIED","WAIT_FAILED","SYNC_FLUSH_COMMANDS_BIT","DEPTH","STENCIL","MIN","MAX","DEPTH_COMPONENT24","STREAM_READ","STREAM_COPY","STATIC_READ","STATIC_COPY","DYNAMIC_READ","DYNAMIC_COPY","DEPTH_COMPONENT32F","DEPTH32F_STENCIL8","INVALID_INDEX","TIMEOUT_IGNORED","MAX_CLIENT_WAIT_TIMEOUT_WEBGL","VERTEX_ATTRIB_ARRAY_DIVISOR_ANGLE","COMPRESSED_RGB_S3TC_DXT1_EXT","COMPRESSED_RGBA_S3TC_DXT1_EXT","COMPRESSED_RGBA_S3TC_DXT3_EXT","COMPRESSED_RGBA_S3TC_DXT5_EXT","COMPRESSED_R11_EAC","COMPRESSED_SIGNED_R11_EAC","COMPRESSED_RG11_EAC","COMPRESSED_SIGNED_RG11_EAC","COMPRESSED_RGB8_ETC2","COMPRESSED_RGBA8_ETC2_EAC","COMPRESSED_SRGB8_ETC2","COMPRESSED_SRGB8_ALPHA8_ETC2_EAC","COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2","COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2","COMPRESSED_RGB_PVRTC_4BPPV1_IMG","COMPRESSED_RGBA_PVRTC_4BPPV1_IMG","COMPRESSED_RGB_PVRTC_2BPPV1_IMG","COMPRESSED_RGBA_PVRTC_2BPPV1_IMG","COMPRESSED_RGB_ETC1_WEBGL","COMPRESSED_RGB_ATC_WEBGL","COMPRESSED_RGBA_ATC_EXPLICIT_ALPHA_WEBGL","COMPRESSED_RGBA_ATC_INTERPOLATED_ALPHA_WEBGL","UNSIGNED_INT_24_8_WEBGL","HALF_FLOAT_OES","RGBA32F_EXT","RGB32F_EXT","FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE_EXT","UNSIGNED_NORMALIZED_EXT","MIN_EXT","MAX_EXT","SRGB_EXT","SRGB_ALPHA_EXT","SRGB8_ALPHA8_EXT","FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING_EXT","FRAGMENT_SHADER_DERIVATIVE_HINT_OES","COLOR_ATTACHMENT0_WEBGL","COLOR_ATTACHMENT1_WEBGL","COLOR_ATTACHMENT2_WEBGL","COLOR_ATTACHMENT3_WEBGL","COLOR_ATTACHMENT4_WEBGL","COLOR_ATTACHMENT5_WEBGL","COLOR_ATTACHMENT6_WEBGL","COLOR_ATTACHMENT7_WEBGL","COLOR_ATTACHMENT8_WEBGL","COLOR_ATTACHMENT9_WEBGL","COLOR_ATTACHMENT10_WEBGL","COLOR_ATTACHMENT11_WEBGL","COLOR_ATTACHMENT12_WEBGL","COLOR_ATTACHMENT13_WEBGL","COLOR_ATTACHMENT14_WEBGL","COLOR_ATTACHMENT15_WEBGL","DRAW_BUFFER0_WEBGL","DRAW_BUFFER1_WEBGL","DRAW_BUFFER2_WEBGL","DRAW_BUFFER3_WEBGL","DRAW_BUFFER4_WEBGL","DRAW_BUFFER5_WEBGL","DRAW_BUFFER6_WEBGL","DRAW_BUFFER7_WEBGL","DRAW_BUFFER8_WEBGL","DRAW_BUFFER9_WEBGL","DRAW_BUFFER10_WEBGL","DRAW_BUFFER11_WEBGL","DRAW_BUFFER12_WEBGL","DRAW_BUFFER13_WEBGL","DRAW_BUFFER14_WEBGL","DRAW_BUFFER15_WEBGL","QUERY_COUNTER_BITS_EXT","CURRENT_QUERY_EXT","QUERY_RESULT_EXT","QUERY_RESULT_AVAILABLE_EXT","TIME_ELAPSED_EXT","TIMESTAMP_EXT","normalizedLoader","registeredLoader","registerLoaders","jsonConverter","addCustomLibraries","customLibraries","onComplete","libraryName","resourceUri","onModuleLoaded","script","querySelector","loadScript","converter","newConfiguration","functions","mergeConfiguration","addModuleToConverter","updateDeck","inputJson","deckgl","convert","createStandaloneFromProvider","mapProvider","mapboxApiKey","googleMapsKey","getTooltip","sharedProps","onClick","onHover","onResize","onDragStart","onDrag","onDragEnd","mapboxgl","mapboxApiAccessToken","onLoad","modifyMapboxElements","mapStyle","initialViewState","deckOverlay","mapTypeId","google","maps","Map","setMap","createGoogleMapsDeckOverlay","createDeck","jsonInput","oldLayers","parentContainer","uiElementsOverlay","insertAdjacentElement","addSupportComponents","convertedLayers","layerToLoad","newLayers","ol","nl","missingLayers","formattedTooltip","makeTooltip","toPropertyKey","getLoaderContext","previousContext","resolvedContext","getLoadersFromContext","contextLoaders","process_","pathPrefix","fileAliases","setPathPrefix","getPathPrefix","resolvePath","alias","replacement","toBuffer","bufferToArrayBuffer","DEFAULT_LIGHT_DIRECTION","_shadow","toArray","shadow","fetchFile","fp32","defines","COORDINATE_SYSTEM_GLSL_CONSTANTS","PROJECTION_MODE_GLSL_CONSTANTS","UNIT_GLSL_CONSTANTS","INITIAL_MODULE_OPTIONS","dependencies","projectShader","getUniforms","coreVersion","workerVersion","validateWorkerVersion","redirected","fromEntries","parseWithLoader","isSupported","crossOrigin","makeResponse","initialDataUrl","blobSlice","readAsDataURL","base64","btoa","arrayBufferToBase64","getInitialDataUrl","checkResponse","contentType","getResponseError","EXT_FLOAT_WEBGL2","bpp","formats","bindRenderbuffer","renderbufferStorageMultisample","renderbufferStorage","createRenderbuffer","deleteRenderbuffer","getRenderbufferParameter","userAgent","navigator","passiveSupported","getRegisteredLoaders","_unregisterLoaders","startPanLngLat","startZoomLngLat","_unproject","startPos","_getNewRotation","zoomedViewport","_zoomFromCenter","_panFromCenter","deltaY","centerY","startY","deltaScaleX","deltaScaleY","MapController","_propsToCompare","_requiredProps","currentProps","nextProps","startViewStateProps","endViewStateProps","_checkRequiredProps","propName","OrbitState","minRotationX","maxRotationX","startPanPosition","startRotationX","startRotationOrbit","startPosition","_calculateNewZoom","PolygonTesselator","IndexType","vertexValid","externalIndices","getGeometry","normalizedPolygon","Polygon","isCut","subPolygon","getGeometrySize","geometrySize","updateGeometryAttributes","vertexStart","indexStart","indexStarts","geometryIndex","_updateIndices","_updatePositions","_updateVertexValid","polygonPositions","Tesselator","main","DEFAULT_COLOR","filled","extruded","wireframe","_normalize","_windingOrder","_full3d","elevationScale","getPolygon","getElevation","getFillColor","getLineColor","material","ATTRIBUTE_TRANSITION","enter","SolidPolygonLayer","vsTop","vsSide","RING_WINDING_ORDER_CW","gouraudLighting","polygonTesselator","hasFeatures","FEATURES","ELEMENT_INDEX_UINT32","calculateIndices","calculatePositions","shaderAttributes","vertexOffset","instancePositions","nextPositions","calculateVertexValid","elevations","instanceElevations","fillColors","colorFormat","defaultValue","instanceFillColors","lineColors","instanceLineColors","pickingColors","__source","instancePickingColors","objectIndex","_disablePickingIndex","topModel","sideModel","renderUniforms","setInstanceCount","instanceCount","setDrawMode","isWireframe","updateParams","updateGeometry","models","_getModels","dataChanged","updateTriggersChanged","all","geometryBuffer","positionFormat","vertexStarts","shaders","NON_INSTANCED_MODEL","vertexPositions","isSideVertex","excludeAttributes","PathTesselator","segmentTypes","flatPath","normalizePath","subPath","getPathLength","_updateSegmentTypes","isPathClosed","ptIndex","getPointOnPath","loop","lastPointIndex","widthUnits","widthScale","widthMinPixels","widthMaxPixels","MAX_SAFE_INTEGER","jointRounded","capRounded","miterLimit","billboard","_pathType","getPath","getWidth","rounded","deprecatedFor","PathLayer","addInstanced","instanceLeftPositions","instanceStartPositions","instanceEndPositions","instanceRightPositions","instanceTypes","calculateSegmentTypes","instanceStrokeWidths","instanceColors","pathTesselator","jointType","capType","DEFAULT_TEXTURE_PARAMETERS","getIconId","icon","buildRowMapping","mapping","yOffset","xOffset","IconManager","_texture","_externalTexture","_autoPacking","_mapping","loadOptions","autoPacking","iconAtlas","iconMapping","textureParameters","_loadOptions","_textureParameters","_pendingCount","getIcon","oldWidth","oldHeight","newTexture","icons","cachedIcons","getDiffIcons","rowHeight","buildMapping","_buffer","_canvasWidth","_rowHeight","_xOffset","_yOffset","_canvasHeight","Texture2D","copyToTexture","targetY","_canvas","_loadIcons","ctx","load","imageData","clearRect","drawImage","resizeImage","catch","finally","sizeScale","sizeUnits","sizeMinPixels","sizeMaxPixels","alphaCutoff","getSize","getAngle","getPixelOffset","onIconError","optional","IconLayer","iconManager","_onError","instanceSizes","instanceOffsets","getInstanceOffset","instanceIconFrames","getInstanceIconFrame","instanceColorModes","getInstanceColorMode","instanceAngles","instancePixelOffset","prePacked","isAsyncPropLoading","packIcons","isLoaded","iconsTexture","getTexture","iconsTextureDim","setNeedsRedraw","evt","getCurrentLayer","getIconMapping","anchorX","anchorY","Vector","lengthSquared","ELEMENTS","mathArray","distanceSquared","dist","product","magnitude","vectors","subtract","multiplyScalar","MathArray","cls","ExtendableBuiltin","construct","_extendableBuiltin","targetArray","arrayOrObject","fromObject","toObject","to","minVector","maxVector","scalar","valid","addScalar","multiplyByScalar","getMemoizedViewportCenterPosition","getMemoizedViewProjectionMatrices","shadowMatrices","projectionMatrices","farZ","shadowMatrix","corner","DEFAULT_SHADOW_COLOR","VECTOR_TO_POINT_MATRIX","createShadowUniforms","shadowEnabled","shadow_uDrawShadowMap","shadow_uUseShadowMap","drawToShadowMap","shadowMaps","shadow_uColor","shadowColor","shadow_uLightId","shadowLightId","shadow_uLightCount","project_uCenter","projectCenters","viewProjectionMatrices","viewProjectionMatrixCentered","project_uCoordinateSystem","project_uProjectionMode","dummyShadowMap","inject","DEFAULT_PIXELS_PER_UNIT2","DEFAULT_COORDINATE_ORIGIN","getMemoizedViewportUniforms","projectionCenter","originCommon","cameraPosCommon","getOffsetOrigin","geospatialOrigin","shaderCoordinateOrigin","offsetMode","vec4","calculateMatrixAndOffset","viewportSize","projectionMode","project_uCoordinateOrigin","project_uCommonOrigin","project_uPseudoMeters","project_uViewportSize","project_uDevicePixelRatio","project_uFocalDistance","project_uCommonUnitsPerMeter","project_uCommonUnitsPerWorldUnit","project_uCommonUnitsPerWorldUnit2","project_uScale","project_uWrapLongitude","project_uViewProjectionMatrix","project_uModelMatrix","distanceScalesAtOrigin","_viewportProps","applyConstraints","ERR_DATA","getArrayBufferOrStringFromDataSync","getArrayBufferOrStringFromData","isArrayBuffer","getAsyncIterableFromData","getIterableFromData","makeStreamIterator","nextBatchPromise","currentBatchPromise","_streamReadAhead","releaseLock","makeBrowserStreamIterator","makeNodeStreamIterator","makeIterator","textEncoder","chunkLength","makeStringIterator","chunkByteLength","makeArrayBufferIterator","makeBlobIterator","MODULE_VERSION","__VERSION__","MODULE_NAME","Long","low","high","unsigned","isLong","__isLong__","INT_CACHE","UINT_CACHE","fromInt","cachedObj","fromBits","fromNumber","UZERO","TWO_PWR_64_DBL","MAX_UNSIGNED_VALUE","TWO_PWR_63_DBL","MIN_VALUE","MAX_VALUE","neg","TWO_PWR_32_DBL","lowBits","highBits","pow_dbl","fromString","radix","RangeError","radixToPower","power","fromValue","val","TWO_PWR_16_DBL","TWO_PWR_24","UONE","NEG_ONE","LongPrototype","toInt","toNumber","isZero","isNegative","eq","radixLong","rem1","rem","remDiv","digits","getHighBits","getHighBitsUnsigned","getLowBits","getLowBitsUnsigned","getNumBitsAbs","bit","isPositive","isOdd","isEven","notEquals","neq","lessThan","comp","lt","lessThanOrEqual","lte","greaterThan","gt","greaterThanOrEqual","gte","thisNeg","otherNeg","not","addend","a48","a16","b48","b32","b16","c48","c32","c16","c00","subtrahend","divide","approx","toUnsigned","shru","shr","shl","LN2","approxRes","approxRem","modulo","and","or","xor","shiftLeft","numBits","shiftRight","shiftRightUnsigned","toSigned","toBytes","le","toBytesLE","toBytesBE","hi","lo","RADIAN_PER_DEGREE","valueArray","calculateTransformMatrix","targetMatrix","yaw","roll","sr","sp","sw","cr","cp","cw","scx","scy","scz","getExtendedMat3FromMat4","MATRIX_ATTRIBUTES","instanceModelMatrix__LOCATION_0","instanceModelMatrix__LOCATION_1","instanceModelMatrix__LOCATION_2","instanceTranslation","getOrientation","getTranslation","getTransformMatrix","arrayMatrix","constantMatrix","constantScale","constantOrientation","constantTranslation","hasMatrix","instanceModelMatrixData","shouldComposeModelMatrix","MAPBOX_CSS_URL","loadMapboxCSS","loadCSS","getElementsByClassName","StatsManager","lumaStats","nodeIO","workerURLCache","getLoadableWorkerURL","workerURL","getLoadableWorkerURLFromSource","workerUrl","getLoadableWorkerURLFromURL","workerSource","URL","createObjectURL","NOOP","Worker","_createBrowserWorker","_createNodeWorker","terminate","terminated","transferList","lineno","colno","_loadableURL","onmessage","_getErrorFromErrorEvent","onmessageerror","eval","workerThread","_resolve","_reject","isRunning","idleQueue","destroy","isDestroyed","onDebug","startPromise","jobQueue","_startQueuedJob","_getAvailableWorker","queuedJob","backlog","returnWorkerToQueue","_getMaxConcurrency","_workerFarm","workerPools","_getWorkerPoolProps","makeTextDecoderIterator","arrayBufferIterator","makeTextEncoderIterator","textIterator","makeLineIterator","previous","textChunk","eolIndex","makeNumberedLineIterator","lineIterator","validateProps","propTypes","getPropTypes","propType","diffProps","propsChangedReason","compareProps","ignoreProps","updateTriggers","transitions","dataChangedReason","dataComparator","_dataDiff","diffDataProps","updateTriggersChangedReason","diffUpdateTrigger","triggerName","diffUpdateTriggers","propsChanged","diffExtensions","transitionsChanged","diffTransitions","comparePropValues","newProp","oldProp","equal","oldExtensions","newTriggers","oldTriggers","LayerType","_propTypes","ShadowPass","shadowMap","depthBuffer","Renderbuffer","fbo","DEFAULT_AMBIENT_LIGHT_PROPS","DEFAULT_DIRECTIONAL_LIGHT_PROPS","LightingEffect","lightSource","ambientLight","directionalLights","pointLights","_applyDefaultLights","light","_calculateMatrices","shadowPasses","_createShadowPasses","programManager","ProgramManager","getDefaultProgramManager","addDefaultModule","lightSources","directionalLight","getProjectedLight","pointLight","removeDefaultModule","lightMatrices","shadowPass","AmbientLight","checkProps","propChecks","removed","replacementProp","lngLatZToWorldPosition","getWorldPosition","normalizeParameters","positionCommonSpace","convertColor","component","getLightSourceUniforms","lightSourceUniforms","lighting_uPointLightCount","lighting_uDirectionalLightCount","lights","lighting_uEnabled","MAX_LIGHTS","exportName","VENDOR_PREFIXES","TEST_ELEMENT","setTimeoutContext","bindFn","invokeArrayArg","each","deprecate","deprecationMessage","stack","nextKey","extend","dest","merge","inherit","properties","childP","baseP","_super","boolOrFn","ifUndefined","val1","val2","addEventListeners","splitStr","removeEventListeners","hasParent","node","parentNode","inStr","inArray","findByKey","uniqueArray","prefixed","prop","camelProp","_uniqueId","getWindowForElement","doc","ownerDocument","defaultView","parentWindow","SUPPORT_TOUCH","SUPPORT_POINTER_EVENTS","SUPPORT_ONLY_TOUCH","PROPS_XY","PROPS_CLIENT_XY","Input","manager","callback","inputTarget","domHandler","ev","init","inputHandler","pointersLen","pointers","changedPointersLen","changedPointers","isFirst","isFinal","session","pointersLength","firstInput","simpleCloneInputData","firstMultiple","getDistance","offsetDelta","prevDelta","prevInput","computeDeltaXY","offsetDirection","overallVelocity","getVelocity","overallVelocityX","overallVelocityY","getRotation","maxPointers","lastInterval","computeIntervalInputData","computeInputData","recognize","clientX","clientY","evEl","evTarget","evWin","MOUSE_INPUT_MAP","mousedown","mousemove","mouseup","MouseInput","pressed","button","which","pointerType","POINTER_INPUT_MAP","pointerdown","pointermove","pointerup","pointercancel","pointerout","IE10_POINTER_TYPE_ENUM","2","3","4","5","POINTER_ELEMENT_EVENTS","POINTER_WINDOW_EVENTS","PointerEventInput","store","pointerEvents","MSPointerEvent","PointerEvent","removePointer","eventTypeNormalized","isTouch","storeIndex","pointerId","SINGLE_TOUCH_INPUT_MAP","touchstart","touchmove","touchend","touchcancel","SingleTouchInput","started","normalizeSingleTouches","touches","changedTouches","TOUCH_INPUT_MAP","TouchInput","targetIds","getTouches","allTouches","identifier","targetTouches","changedTargetTouches","touch","TouchMouseInput","mouse","primaryTouch","lastTouches","recordTouches","eventData","setLastTouch","lastTouch","lts","isSyntheticEvent","dx","dy","inputEvent","inputData","isMouse","sourceCapabilities","firesTouchEvents","PREFIXED_TOUCH_ACTION","NATIVE_TOUCH_ACTION","TOUCH_ACTION_MAP","touchMap","cssSupports","CSS","supports","getTouchActionProps","TouchAction","actions","touchAction","recognizers","recognizer","getTouchAction","hasPanX","hasPanY","cleanTouchActions","preventDefaults","prevented","hasNone","isTapPointer","isTapMovement","isTapTouchTime","DIRECTION_LEFT","DIRECTION_UP","preventSrc","Recognizer","simultaneous","requireFail","stateStr","directionStr","getRecognizerByNameIfManager","otherRecognizer","AttrRecognizer","PanRecognizer","pX","pY","PinchRecognizer","PressRecognizer","_timer","RotateRecognizer","SwipeRecognizer","TapRecognizer","pTime","pCenter","Hammer","preset","Manager","recognizeWith","dropRecognizeWith","requireFailure","dropRequireFailure","hasRequireFailures","canRecognizeWith","additionalEvent","tryEmit","canEmit","inputDataClone","attrTest","optionPointers","isRecognized","isValid","threshold","DIRECTION_HORIZONTAL","directionTest","hasMoved","inOut","validPointers","validMovement","validTime","taps","interval","posThreshold","validTouchTime","failTimeout","validInterval","validMultiTap","tapCount","domEvents","inputClass","cssProps","userSelect","touchSelect","touchCallout","contentZooming","userDrag","tapHighlightColor","oldCssProps","toggleCssProps","item","force","curRecognizer","existing","events","gestureEvent","createEvent","initEvent","gesture","dispatchEvent","triggerDomEvent","INPUT_START","INPUT_MOVE","INPUT_END","INPUT_CANCEL","STATE_POSSIBLE","STATE_BEGAN","STATE_CHANGED","STATE_ENDED","STATE_RECOGNIZED","STATE_CANCELLED","STATE_FAILED","DIRECTION_NONE","DIRECTION_RIGHT","DIRECTION_DOWN","DIRECTION_VERTICAL","DIRECTION_ALL","Tap","Pan","Swipe","Pinch","Rotate","Press","padToNBytes","copyToArray","targetOffset","srcByteLength","MapView","TRANSITION_EVENTS","BREAK","SNAP_TO_END","IGNORE","DEFAULT_EASING","DEFAULT_INTERRUPTION","interpolator","interpolateProps","transitionTriggered","_shouldIgnoreViewportChange","_isTransitionEnabled","inProgress","interruption","_triggerTransition","arePropsEqual","_isUpdateDueToCurrentTransition","startViewstate","shortestPathFrom","getDuration","initialProps","initializeProps","transitionSettings","transitionInterruption","onTransitionStart","_onTransitionUpdate","_onTransitionEnd","onTransitionInterrupt","onTransitionEnd","inTransition","visitor","concatenateArrayBuffersAsync","arrayBuffers","DEFAULT_MODULES","SHADER_HOOKS","createProgramManager","shaderModule","shaderHook","addShaderHook","OrthographicView","OrthographicViewport","OrthographicController","getProjectionMatrix","flipY","zoomX","zoomY","zoom_","OrthographicState","zoomAxis","deltaZoom","newZoomX","newZoomY","isPlainObject","mergeShaders","mergedInjection","halfFov","GLOBE_RADIUS","lSqr","l0Sqr","l1Sqr","sSqr","dSqr","dr","cosPhi","D","CPUInterpolationTransition","_value","toValue","updateSpringElement","cur","value1","value2","distanceSquare","CPUSpringTransition","_currValue","_prevValue","nextValue","updateSpring","TRANSITION_TYPES","UniformTransitionManager","TransitionType","internalTextures","TYPE_DEFINITIONS","boolean","arrayEqual","valueType","getTypeOf","function","dataTransform","specialTextureParameters","release","parsePropType","propDef","normalizePropDefinition","createProps","propObjects","propsPrototype","getPropsPrototype","propsInstance","componentClass","getOwnProperty","parentClass","parentDefaultProps","componentPropDefs","propDefs","parsePropTypes","parentProps","componentName","getComponentName","defineProperties","createPropsPrototype","defaultValues","descriptors","getDescriptorForAsyncProp","addAsyncPropsToPropPrototype","_deprecatedProps","newValue","nameStr","newPropName","addDeprecatedPropsToPropPrototype","_mergedDefaultProps","createPropsPrototypeAndTypes","hasAsyncProp","getAsyncProp","Component","asyncProps","EMPTY_PROPS","LayerState","needsRedraw","needsUpdate","subLayers","usesPickingColorCache","onDataLoad","onAsyncPropUpdated","oldAsyncProps","asyncProp","resolvedValue","pendingLoadCount","resolvedLoadCount","_watchPromise","resolvedValues","originalValues","_createAsyncPropData","_updateAsyncProp","_didAsyncInputValueChange","_resolveAsyncIterable","_setPropValue","lastValue","_freezeAsyncOldProps","_postProcessValue","loadCount","promise","_setAsyncPropValue","_onResolve","MAX_PICKING_COLOR_CACHE_SIZE","areViewportsEqual","oldViewport","pickingColorCache","__diff","resourceManager","getLoadOptions","inResourceManager","contains","resourceId","persistent","subscribe","onChange","reloadAsyncProp","consumerId","requestId","opacity","operation","getPolygonOffset","highlightedObjectIndex","autoHighlight","highlightColor","layerName","partialState","setChangeFlags","stateChanged","layerManager","setNeedsUpdate","getModels","updateModuleSettings","pickingEvent","propsOrDataChanged","dataRange","neededPickingBuffer","isInteger","needPickingBuffer","pickingColorsAttribute","unsubscribe","uniformTransitions","sourceLayer","clearRedrawFlags","_getNeedsRedraw","hasUniformTransition","shouldUpdateState","_getUpdateParams","active","viewportChanged","_update","changedAttributes","_setModelAttributes","getNumInstances","getStartIndices","getChangedAttributes","clearChangedFlags","updateAttributes","cacheSize","newCacheSize","pickingColor","getShaderAttributes","setAttributes","colors","getVertexOffset","updateSubBuffer","startOffset","_getAttributeManager","calculateInstancePickingColors","_clearChangeFlags","_onAsyncPropUpdated","setAsyncProps","initializeState","oldLayer","_diffProps","getOldProps","stateNeedsUpdate","currentViewport","_updateUniformTransition","oldModels","updateState","modelChanged","_postUpdate","resetOldProps","finalizeState","_updateAttributeTransition","setModuleParameters","offsets","flagChanged","prevDataChangedReason","somethingChanged","invalidateAttribute","_updateAutoHighlight","pickingModuleParameters","pickingSelectedColor","pickingHighlightColor","AttributeManager","forceUpdate","_updateAttributes","redraw","attributeManagerNeedsRedraw","getNeedsRedraw","ShaderAttribute","dataColumn","getAccessor","constantValue","getStride","resolveShaderAttribute","baseAccessor","shaderAttributeOptions","DataColumn","bufferType","logicalType","hasFeature","defaultType","glArrayFromType","externalBuffer","bufferAccessor","allocatedValue","isBuffer64Bit","doubleShaderAttributeDefs","resolvedOptions","shaderAttributeDef","_normalizeValue","_areValuesEqual","_checkExternalBuffer","requiredBufferSize","endOffset","illegalArrayType","EMPTY","FULL","rangeList","newRangeList","insertPosition","range0","Attribute","lastExternalBuffer","binaryValue","binaryAccessor","updateRanges","_autoUpdater","_validateAttributeUpdaters","layout","supportsTransition","updated","setData","_checkAttributeArray","clearNeedsUpdate","needsNormalize","shaderAttributeDefs","shaderAttributeName","accessorFunc","objectValue","numVertices","GPUInterpolationTransition","attributeInTransition","currentStartIndices","currentLength","attributeType","Transform","ATTRIBUTE_TYPE","varyings","getTransform","bufferOpts","padBufferOpts","elementCount","sourceBuffers","aFrom","aTo","feedbackBuffers","vCurrent","getFramebuffer","aPrev","aCur","vNext","discard","clearRenderTarget","readPixelsToArray","AttributeTransitionManager","_removeTransition","getTransitionSetting","_updateAttribute","animatedAttributes","isNew","attributeTransitionManager","_add","attributeNameArray","invalidatedAttributes","_invalidateTrigger","timeStart","accessorName","setExternalBuffer","setBinaryValue","setConstantValue","transitionUpdated","getAttributes","hasAttribute","_createAttribute","_mapUpdateTriggersToAttributes","triggers","getUpdateTriggers","updateBuffer","INF","TinySDF","fontSize","cutoff","fontStyle","_createCanvas","willReadFrequently","font","textBaseline","textAlign","fillStyle","gridOuter","gridInner","char","glyphAdvance","actualBoundingBoxAscent","actualBoundingBoxDescent","actualBoundingBoxLeft","actualBoundingBoxRight","measureText","glyphTop","glyphWidth","glyphHeight","glyph","glyphLeft","fillText","imgData","getImageData","edt","gridSize","edt1d","grid","qr","SINGLE_LINE","getTextWidth","layoutWidth","breakAll","rowStartCharIndex","rowOffsetLeft","textWidth","breakWord","groupStartCharIndex","groupEndCharIndex","groupWidth","autoWrapping","wordBreak","transformRow","leftOffsets","rowSize","character","frame","layoutHeight","codePointAt","transformParagraph","paragraph","lineHeight","characters","numCharacters","rowWidth","autoWrappingEnabled","rowOffsetTop","lineStartIndex","lineEndIndex","rowIndex","rowStart","rowEnd","layoutOffsetY","LRUCache","_cache","_deleteOrder","_appendOrder","_order","DEFAULT_FONT_SETTINGS","characterSet","charSet","getDefaultCharacterSet","sdf","smoothing","getNewChars","cacheKey","newCharSet","cachedFontAtlas","populateAlphaChannel","alphaChannel","setTextStyle","FontAtlasManager","_atlas","_getKey","fontAtlas","_generateFontAtlas","getFontWidth","fontHeight","maxCanvasWidth","putImageData","tinySDF","createImageData","TEXT_ANCHOR","middle","ALIGNMENT_BASELINE","getBackgroundColor","getBorderColor","getBorderWidth","backgroundPadding","outlineWidth","outlineColor","fontSettings","getText","getTextAnchor","getAlignmentBaseline","TextLayer","fontAtlasManager","rowOffset","styleVersion","_updateText","_updateFontAtlas","fontProps","textBuffer","autoCharacterSet","characterCount","texts","codes","codesAtIndex","fromCodePoint","charCode","getTextFromBuffer","CharactersLayerClass","getSubLayerClass","MultiIconLayer","BackgroundLayerClass","TextBackgroundLayer","getLineWidth","getSubLayerProps","getBoundingRect","getIconOffsets","setFontAtlasCacheLimit","CompositeLayer","ColumnGeometry","nradial","vertices","flatMap","isExtruded","vertsAroundEdge","stepAngle","normals","vertexIndex","POSITION","NORMAL","tesselateColumn","diskResolution","coverage","radiusUnits","lineWidthUnits","lineWidthScale","lineWidthMinPixels","lineWidthMaxPixels","stroked","ColumnLayer","transpileToGLSL100","useDerivatives","flatShading","GLSL_DERIVATIVES","FLAT_SHADING","phongLighting","regenerateModels","_updateGeometry","hasThinkness","meanVertexDistance","edgeDistance","fillVertexCount","wireframeVertexCount","isStroke","radiusMinPixels","radiusMaxPixels","antialiasing","getRadius","strokeWidth","ScatterplotLayer","instanceRadius","instanceLineWidths","instanceRects","instancePixelOffsets","consumer","_subscribers","_error","_content","_data","_loadCount","ResourceManager","protocol","_resources","_consumers","_pruneRequest","request","prune","resources","_track","_prune","consumers","oldResource","inUse","LayerManager","Stats","Timeline","_finalizeLayer","_needsRedraw","layerNeedsRedraw","_nextLayers","_lastRenderedLayers","_needsUpdate","layerIds","_debug","flatLayers","_updateLayers","setLayers","stage","oldLayerMap","generatedLayers","_updateSublayersRecursively","_finalizeOldLayers","newLayer","sublayers","_transferLayerState","_updateLayer","_initializeLayer","getSubLayers","_handleError","_initialize","lifecycle","_transferState","_finalize","outlineBuffer","gamma","DrawLayersPass","DeckRenderer","drawPickingColors","drawLayersPass","pickLayersPass","PickLayersPass","renderCount","renderBuffers","lastPostProcessEffect","layerPass","getDefaultFramebuffer","_preRender","_postRender","preRender","postRender","_resizeRenderBuffers","onIninitialize","onFinalize","Transport","_messageQueue","transport","onInitialize","_destroyed","isElectron","mockUserAgent","electron","realUserAgent","upgradeMessage","methodName","Matrix","RANK","columnIndex","firstIndex","columnVector","getTransferList","recursive","transfers","transfersSet","isTransferable","MessagePort","OffscreenCanvas","getTransferListForWriter","PICKING_PARAMETERS","pickingFBO","_drawPickingBuffer","deviceRect","pickZ","encodedColors","byLayer","byAlpha","_colors","useInPicking","decodePickingColor","decodeColor","pickingAttribute","pickParameters","encoded","entry","encodeColor","pickedColor","pickedLayer","pickedViewports","pickedObjectIndex","getBinaryImageMetadata","binaryData","toDataView","getUint32","getPngMetadata","getUint16","tableMarkers","sofMarkers","getJpegMarkers","getJpegMetadata","getGifMetadata","getBmpMetadata","replaceInRange","getIndex","replaceStart","replaceEnd","endChunk","objectWithoutPropertiesLoose","excluded","getOwnPropertySymbols","sourceSymbolKeys","propertyIsEnumerable","link","rel","href","getElementsByTagName","createContainer","DracoLoader","shapes","draco","decoderType","WebAssembly","libraryPath","extraAttributes","attributeNameEntry","usedNames","checkNames","compareTo","columnNames","nameMap","selectedFields","columnIndices","schemaOrFields","otherSchema","mergeMaps","fieldMap","mergedFields","m1","m2","nullable","typeId","_Symbol$toStringTag","_Symbol$toStringTag2","_Symbol$toStringTag3","_Symbol$toStringTag4","_Symbol$toStringTag5","_Symbol$toStringTag6","_Symbol$toStringTag7","_Symbol$toStringTag8","Null","Int","Float","Binary","Utf8","Bool","Decimal","Time","Timestamp","Interval","List","Struct","Union","FixedSizeBinary","FixedSizeList","Dictionary","isSigned","bitWidth","Int8","Int16","Int32","Uint8","Uint16","Uint32","Precision","Float32","Float64","listSize","deduceMeshField","optionalMetadata","getArrowTypeFromTypedArray","byteStride","makeMeshAttributeMetadata","getArrowFieldFromAttribute","loaderData","makeMetadata","metadataMap","DRACO_TO_GLTF_ATTRIBUTE_NAME_MAP","TEX_COORD","DRACO_DATA_TYPE_TO_TYPED_ARRAY_MAP","1","6","9","decoder","Decoder","metadataQuerier","MetadataQuerier","DecoderBuffer","Init","_disableAttributeTransforms","geometry_type","GetEncodedGeometryType","dracoGeometry","TRIANGULAR_MESH","Mesh","PointCloud","dracoStatus","DecodeBufferToMesh","POINT_CLOUD","DecodeBufferToPointCloud","ptr","error_msg","_getDracoLoaderData","_getMeshData","boundingBox","getMeshBoundingBox","namedLoaderDataAttributes","dracoAttribute","transformAttributesLoaderData","indicesField","getDracoSchema","num_points","_getTopLevelMetadata","_getDracoAttributes","num_attributes","num_faces","dracoAttributes","attributeId","GetAttribute","_getAttributeMetadata","unique_id","attribute_type","data_type","num_components","byte_offset","byte_stride","attribute_index","quantization","_getQuantizationTransform","quantization_transform","octahedron","_getOctahedronTransform","octahedron_transform","_getMeshAttributes","topology","_getTriangleStripIndices","_getTriangleListIndices","loaderAttribute","_deduceAttributeName","_getAttributeValues","numIndices","_malloc","GetTrianglesUInt32Array","HEAPF32","_free","dracoArray","DracoInt32Array","GetTriangleStripsFromMesh","numValues","intArray","GetValue","getUint32Array","TypedArrayCtor","numComponents","DT_FLOAT32","DT_INT8","DT_INT16","DT_INT32","DT_UINT8","DT_UINT16","DT_UINT32","DT_INVALID","getDracoDataType","GetAttributeDataArrayForAllPoints","uniqueId","attributeUniqueId","thisAttributeType","dracoAttributeConstant","entryName","dracoMetadata","GetMetadata","_getDracoMetadata","GetAttributeMetadata","numEntries","NumEntries","entryIndex","GetEntryName","_getDracoMetadataField","GetIntEntryArray","getInt32Array","int","GetIntEntry","GetStringEntry","double","GetDoubleEntry","quantizedAttributes","octahedronAttributes","skipAttributes","dracoAttributeName","SkipAttributeTransform","AttributeQuantizationTransform","InitFromAttribute","quantization_bits","min_values","min_value","DRACO_JS_DECODER_URL","DRACO_WASM_WRAPPER_URL","DRACO_WASM_DECODER_URL","loadDecoderPromise","loadDracoDecoderModule","draco3d","createDecoderModule","DracoDecoderModule","wasmBinary","initializeDracoDecoder","loadDracoDecoder","dracoParser","getScratchArray","constantAttributeZero","defaultVertexArray","isDefaultArray","MAX_ATTRIBUTES","_setConstantFloatArray","_setConstantIntArray","_setConstantUintArray","bufferValue","getMaxAttributes","elementBuffer","setElementBuffer","vertexAttribIPointer","vertexAttribDivisor","_normalizeConstantArrayValue","updateNeeded","_compareConstantArrayValues","arrayValue","v1","v2","vertexAttrib1fv","vertexAttrib2fv","vertexAttrib3fv","vertexAttrib4fv","vertexAttribI1iv","vertexAttribI2iv","vertexAttribI3iv","vertexAttribI4iv","vertexAttribI1uiv","vertexAttribI2uiv","vertexAttribI3uiv","vertexAttribI4uiv","getVertexAttribOffset","MULTI_LOCATION_ATTRIBUTE_REGEXP","DEPRECATIONS_V6","elementsAccessor","unused","drawParams","vertexArrayObject","bindOnUse","_updateDrawParams","locationOrName","_setAttribute","clearDrawParams","appAccessor","_resolveLocationAndAccessor","setBuffer","_setConstantAttributes","valueAccessor","INVALID_RESULT","_getAttributeIndex","accessInfo","_getAttributeInfo","currentAccessor","getAttributeInfo","multiLocation","locationOffset","getAttributeLocation","setConstant","_setConstantAttributeZero","_setConstantAttribute","getConstantBuffer","indexCount","_updateDrawParamsForLocation","indexType","indexOffset","getVertexCount","formatArrayValue","maxElts","terminator","decimal","getDebugTableRow","vertexArray","verts","getDebugData","getGLSLDeclaration","typeAndName","getDebugTableForUniforms","undefinedOnly","uniformLocations","_uniformSetters","uniformNames","uniformName","addUniformToTable","unusedCount","unusedTable","uniform","isDefined","isUniformDefined","attributeInfo","GLTF_TO_LUMA_ATTRIBUTE_MAP","COLOR_0","TEXCOORD_0","TEXCOORD_1","TEXCOORD_2","mapAttributeName","attributeMap","inferAttributeAccessor","DRAW_PARAMS","lastLogTime","animated","_programManagerState","_managedProgram","bufferMode","programProps","_programDirty","_attributes","_checkProgram","getModuleUniforms","geometryBuffers","_setModelProps","_deleteGeometryBuffers","remappedName","getBuffersFromGeometry","normalizedAttributes","transformFeedback","logPriority","_logDrawCallStart","getDrawParams","vertexArrayInstanced","onBeforeRender","onAfterRender","didDraw","getDrawMode","_logDrawCallEnd","unbindModels","_setFeedbackBuffers","unbindBuffers","bindBuffers","setGeometry","_feedbackBuffers","stateHash","animationProps","setBuffers","logDrawTimeout","attributeTable","attributeLocation","rowHeader","getDebugTableForVertexArray","uniformTable","missingTable","missingCount","configTable","attributeInfos","glslDeclaration","varyingInfo","varyingInfos","getDebugTableForProgramConfiguration","GL_COLOR","clearFlags","clearBuffer","clearBufferiv","clearBufferuiv","clearBufferfv","clearBufferfi","VERTEX_ARRAY_OBJECT","TIMER_QUERY","INSTANCED_RENDERING","MULTIPLE_RENDER_TARGETS","BLEND_EQUATION_MINMAX","FLOAT_BLEND","COLOR_ENCODING_SRGB","TEXTURE_DEPTH","TEXTURE_FLOAT","TEXTURE_HALF_FLOAT","TEXTURE_FILTER_LINEAR_FLOAT","TEXTURE_FILTER_LINEAR_HALF_FLOAT","TEXTURE_FILTER_ANISOTROPIC","COLOR_ATTACHMENT_RGBA32F","COLOR_ATTACHMENT_FLOAT","COLOR_ATTACHMENT_HALF_FLOAT","GLSL_FRAG_DATA","GLSL_FRAG_DEPTH","GLSL_TEXTURE_LOD","testTexture","testFb","getWorkerName","warning","getWorkerURL","workerOptions","workerFile","versionTag","MODULE_INJECTORS","DECLARATION_INJECT_MARKER","REGEX_START_OF_MAIN","REGEX_END_OF_MAIN","fragments","injectShader","injectStandardStubs","isVertex","fragmentData","order","injection","fragmentString","combineInjects","injects","canParseWithWorker","parseWithWorker","parseOnMainThread","compositeKey","keyList","keyMap","getKeys","cachedExpressionMap","parseExpressionString","propValue","ast","expressionEval","traverse","JSONConfiguration","typeKey","functionKey","reactComponents","constants","convertFunction","preProcessClassProps","Class","postProcessConvertedJson","configurations","trimFunctionIdentifier","convertFunctions","instantiateClass","stringProps","instantiateJavaScriptClass","React","instantiateReactComponent","JSONConverter","onJSONChange","convertedJson","convertJSONRecursively","convertJSON","parseJSON","isClassInstance","convertPlainObject","convertClassInstance","targetFunction","matchedFunction","executeFunction","convertFunctionObject","enumVarName","enumValName","convertString","shallowEqualObjects","JupyterTransport","jupyterModel","jupyterView","_stringifyJSONSafe","send","updateObject","subLayerId","DefaultLayerClass","overridingProps","_subLayerProps","sourceObject","sourceObjectIndex","sublayerProps","overridingSublayerProps","overridingSublayerTriggers","sublayerId","subLayerPropTypes","getSubLayerAccessor","passThroughProps","updateAutoHighlight","shouldUpdate","subLayersList","renderLayers","ViewManager","controllers","_viewports","_viewportMap","_isUpdating","_eventManager","_eventCallbacks","onInteractionStateChange","viewId","rect","containsPixel","viewMap","viewOrViewId","getView","getViewStateId","getViewports","_setViews","_setViewState","_setSize","_rebuildViewports","_diffViews","_onViewStateChange","controllerProps","resolvedProps","_createController","oldControllers","invalidateControllers","getViewState","oldController","hasController","_updateController","_buildViewportMap","newViews","oldViews","MaskPass","mapSize","maskMap","channel","MaskEffect","dummyMaskMap","maskLayers","masks","maskPass","channelMap","_sortMaskChannels","lastViewport","maskId","_renderChannel","channelInfo","oldChannelInfo","maskChanged","layerBounds","maskBounds","subLayerBounds","viewportBounds","paddedBounds","_doubleBounds","getMaskBounds","maskViewport","getMaskViewport","channelCount","maskChannels","DEFAULT_LIGHTING_EFFECT","EffectManager","_internalEffects","setEffects","cleanup","NO_PICKED_OBJECT","getClosestObject","pickedColors","deviceX","deviceY","deviceRadius","minSquareDistanceToCenter","closestPixelIndex","dy2","d2","pickedObject","pickedX","pickedY","getEmptyPickingInfo","coordinate","pickInfo","pickedViewport","getViewportFromCoordinates","point","devicePixel","processPickInfo","lastPickedInfo","affectedLayers","lastPickedPixelIndex","lastPickedLayerId","pickedLayerId","lastPickedLayer","baseInfo","infos","rootLayer","getLayerPickingInfo","getPickingInfo","DeckPicker","_pickable","depthFBO","_pickClosestObject","_pickVisibleObjects","lastPickedViewportId","pickableLayers","isPickable","unproject3D","_getPickable","emptyInfo","_resizeBuffer","devicePixelRange","_getPickingRect","deviceWidth","deviceHeight","_drawAndSample","disablePickingIndex","restorePickingColors","maxObjects","leftTop","deviceLeft","deviceTop","rightBottom","deviceRight","deviceBottom","pickInfos","uniqueColors","colorKey","getUniqueObjects","uniqueInfos","isMaxObjects","sourceX","sourceY","sourceWidth","sourceHeight","defaultStyle","Tooltip","canvasParent","parentElement","displayInfo","innerText","isVisible","hasTimerQuery","_queryPending","_pollingPromise","begin","conservative","resultAvailable","getQueryParameter","getResult","POSITIVE_INFINITY","poll","isResultAvailable","requestAnimationFrame","statIdCounter","onCreateContext","onAddHTML","onRender","glOptions","autoResizeViewport","autoResizeDrawingBuffer","useDevicePixelRatio","cpuTime","gpuTime","frameRate","_initialized","_running","_animationFrameId","_nextFramePromise","_resolveNextFrame","_cpuStartTime","_pageLoadPromise","_onMousemove","_onMouseleave","_setDisplay","_getPageLoadPromise","_createWebGLContext","_createFramebuffer","_startEventHandling","_initializeCallbackData","_updateCallbackData","_resizeCanvasDrawingBuffer","_resizeViewport","_gpuTimeQuery","appContext","_addCallbackData","_startLoop","isContextLost","_beginTimers","_setupFrame","_renderFrame","_clearNeedsRedraw","offScreen","commit","_endTimers","_finalizeCallbackData","_cancelAnimationFrame","waitForRender","renderFrame","_requestAnimationFrame","animationLoop","animationFrameId","cancelAnimationFrame","timerId","renderFrameCallback","_resizeFramebuffer","startTime","engineTime","tick","tock","_loop","_animationLoop","_mousePosition","_getSizeAndAspect","_offScreen","_createInfoDiv","wrapperDiv","isTimerDisjoint","getTimerMilliseconds","beginTimeElapsedQuery","oldHandler","predict","enhancePointerEventInput","RECOGNIZERS","RECOGNIZER_COMPATIBLE_MAP","tripan","pinch","doubletap","anytap","RECOGNIZER_FALLBACK_MAP","BASIC_EVENT_ALIASES","INPUT_EVENT_TYPES","KEY_EVENTS","MOUSE_EVENTS","WHEEL_EVENTS","EVENT_RECOGNIZER_MAP","tap","press","pinchin","pinchout","pinchstart","pinchmove","pinchend","pinchcancel","rotatestart","rotatemove","rotateend","rotatecancel","tripanstart","tripanmove","tripanup","tripandown","tripanleft","tripanright","tripanend","tripancancel","panup","pandown","panleft","panright","pancancel","swipe","swipeleft","swiperight","swipeup","swipedown","GESTURE_EVENT_ALIASES","anyclick","dblclick","mouseover","mouseout","mouseleave","firefox","WheelEvent","deltaMode","DOM_DELTA_PIXEL","DOM_DELTA_LINE","passive","handleOverEvent","handleOutEvent","handleEnterEvent","handleLeaveEvent","handleMoveEvent","enableMoveEvent","enableLeaveEvent","enableEnterEvent","enableOutEvent","enableOverEvent","_emit","targetElement","srcElement","tagName","enableDownEvent","enableUpEvent","tabIndex","whichButtons","buttons","leftButton","middleButton","getOffsetPosition","rootElement","getBoundingClientRect","offsetWidth","offsetHeight","clientLeft","clientTop","mjolnirEvent","_normalizeEvent","handlersByElement","_active","immediatePropagationStopped","stopImmediatePropagation","entriesToRemove","getElement","recognizerOptions","_onBasicInput","_onOtherEvent","setElement","ManagerClass","otherName","recognizerName","recognizerOption","wheelInput","moveInput","keyInput","contextmenuInput","eventAlias","eventRegistrar","_toggleRecognizer","_addEventHandler","_removeEventHandler","fallbackRecognizers","enableEventType","isRecognizerUsed","eh","pickingRadius","eventRecognizerOptions","_framebuffer","_animate","_typedArrayManagerProps","_customRender","onWebGLInitialized","_onMetrics","getCursor","Deck","_pickRequest","eventOptions","getLayers","deckPicker","getLastPickedObject","_lastPointerDownInfo","layerHandler","rootHandler","_pick","cursorState","isHovering","getBrowser","_createAnimationLoop","metrics","fps","setPropsTime","updateAttributesTime","framesRedrawn","pickTime","pickCount","gpuTimePerFrame","cpuTimePerFrame","bufferMemory","textureMemory","renderbufferMemory","gpuMemory","_metricsCounter","viewManager","effectManager","deckRenderer","removeChild","_setCanvasSize","_getViews","_getViewState","viewManagerNeedsRedraw","layerManagerNeedsRedraw","effectManagerNeedsRedraw","deckRendererNeedsRedraw","redrawReason","resourceIds","statKey","getViews","getEffects","cssWidth","cssHeight","AnimationLoop","_onContextLost","_setGLContext","_onRenderFrame","setTooltip","play","attachTimeline","EventManager","_onPointerDown","_onPointerMove","pointerleave","_onEvent","_onInteractionStateChange","_updateCanvasSize","renderOptions","_getFrameStats","_getMetrics","_updateCursor","updateLayers","_pickAndCallback","updateViewStates","animationLoopStats","memoryStats","deckGlobal","firstChar","lastChar","existingVersion","_registerLoggers","jsonLoader","ImageLoader","imagebitmap","premultiplyAlpha","Pbf","ieee754","buf","Varint","Fixed64","Bytes","Fixed32","utf8TextDecoder","readPackedEnd","pbf","readVarint","toNum","makeRoomForExtraLength","extraLen","realloc","writePackedVarint","writeVarint","writePackedSVarint","writeSVarint","writePackedFloat","writeFloat","writePackedDouble","writeDouble","writePackedBoolean","writeBoolean","writePackedFixed32","writeFixed32","writePackedSFixed32","writeSFixed32","writePackedFixed64","writeFixed64","writePackedSFixed64","writeSFixed64","readUInt32","writeInt32","readInt32","readFields","readField","skip","readMessage","readFixed32","readSFixed32","readFixed64","readSFixed64","readFloat","readDouble","h","readVarintRemainder","readVarint64","readSVarint","readBoolean","readString","readUtf8TextDecoder","bytesPerSequence","readUtf8","readBytes","readPackedVarint","readPackedSVarint","readPackedBoolean","readPackedFloat","readPackedDouble","readPackedFixed32","readPackedSFixed32","readPackedFixed64","readPackedSFixed64","writeTag","writeBigVarintLow","lsb","writeBigVarintHigh","writeBigVarint","writeString","lead","charCodeAt","writeUtf8","writeBytes","writeRawMessage","writeMessage","writeBytesField","writeFixed32Field","writeSFixed32Field","writeFixed64Field","writeSFixed64Field","writeVarintField","writeSVarintField","writeStringField","writeFloatField","writeDoubleField","writeBooleanField","jsep","binops","unops","evaluateArray","evaluate","evaluateArrayAsync","evaluateAsync","evaluateMember","computed","evaluateMemberAsync","operator","caller","callee","consequent","alternate","argument","evalAsync","compile","expression","compileAsync","resolveModules","getShaderDependencies","instantiateModules","seen","moduleMap","moduleDepth","getDependencyGraph","isOldIE","isMSIE","isTrident","WEBGL_FEATURES","compiledGlslExtensions","canCompileGLGSExtension","cap","feature","extensionName","behavior","shader","createShader","shaderSource","compileShader","canCompile","getShaderParameter","deleteShader","getFeature","features","testVariable","qualifier","ES300_REPLACEMENTS","ES300_VERTEX_REPLACEMENTS","ES300_FRAGMENT_REPLACEMENTS","ES100_REPLACEMENTS","ES100_VERTEX_REPLACEMENTS","ES100_FRAGMENT_REPLACEMENTS","ES300_FRAGMENT_OUTPUT_REGEX","transpileShader","targetGLSLVersion","convertShader","outputMatch","outputName","convertFragmentShaderTo300","convertFragmentShaderTo100","replacements","pattern","INJECT_SHADER_DECLARATIONS","assembleShader","hookFunctions","prologue","sourceLines","glslVersion","versionLine","coreSource","allDefines","getDefines","assembledSource","getShaderName","getShaderType","gpuVendor","identifyGPUVendor","getContextInfo","getPlatformShaderDefines","isFragment","versionDefines","getVersionDefines","sourceText","getApplicationDefines","hookFunctionMap","hook","signature","normalizeHookFunctions","hookInjections","declInjections","mainInjections","hash","checkDeprecations","getModuleSource","injections","injectionType","hookName","hookFunction","footer","getHookFunctions","assembleGetUniforms","moduleUniforms","defaultProgramManager","_programCache","_getUniforms","_registeredModules","_hookFunctions","_defaultModules","_hashes","_hashCounter","_useCounts","moduleName","_getModuleList","vsHash","_getHash","fsHash","moduleHashes","varyingHashes","defineKeys","injectKeys","defineHashes","injectHashes","assembled","assembleShaders","appModules","deprecations","vertexShader","fragmentShader","_parseDeprecationDefinitions","normalizeInjections","moduleSource","_defaultGetUniforms","def","regex","old","new","private","glFormatToComponents","sourceFormat","sourceAttachment","sourceType","getPixelArray","readPixels","readPixelsToBuffer","targetByteOffset","byteCount","glTypeToBytes","unbind","copyToDataUrl","targetMipmaplevel","targetInternalFormat","targetX","isSubCopy","copyTexSubImage2D","copyTexSubImage3D","copyTexImage2D","pixelArray","LayerExtension","defaultTypedArrayManager","_attributeDefs","getGeometryFromBuffer","_rebuildGeometry","normalizedData","_forEachGeometry","dataIndex","normalizedGeometry","normalizeGeometry","vertexEnd","canEncodeWithWorker","throttleRequests","maxRequests","RequestScheduler","getPriority","requestMap","requestQueue","_issueNewRequests","isDone","activeRequestCount","deferredUpdate","_issueNewRequestsAsync","freeSlots","_updateAllRequests","_issueRequest","_updateRequest","JSONLoader","GridCellLayer","CubeGeometry","cellSize","defaultLineColor","lineJointRounded","lineMiterLimit","PolygonLayer","paths","getLineDashArray","geometryChanged","pathsDiff","_getPaths","getSubLayerRow","lineDashJustified","FillLayer","StrokeLayer","polygonLayer","shouldRenderSubLayer","dashJustified","getDashArray","isLE","mLen","nBytes","eLen","eMax","eBias","nBits","NaN","rt","_setScenegraphNodeProps","setPosition","setRotation","setScale","updateMatrix","rot","rotateXYZ","worldMatrix","worldInverse","worldInverseTranspose","objectMatrix","worldInverseMatrix","worldInverseTransposeMatrix","setMatrix","removeAll","ATTRIBUTE_TYPE_TO_COMPONENTS","SCALAR","VEC2","VEC3","VEC4","MAT2","MAT3","MAT4","ATTRIBUTE_COMPONENT_TYPE_TO_ARRAY","5120","5121","5122","5123","5125","5126","accessorToJsArray","_animation","componentType","bufferView","slicedArray","helperMatrix","interpolate","animationTime","nextIndex","previousIndex","previousTime","nextTime","stepInterpolate","slerp","linearInterpolate","tDiff","outTangent0","inTangent1","m0","cubicsplineInterpolate","GLTFAnimation","playing","timeMs","gltfNode","translation","rotationMatrix","fromQuaternion","applyTranslationRotationScale","_node","GLTFAnimator","gltf","animations","animation","samplers","nodes","setTime","animate","AfterRender","_setModelNodeProps","managedResources","addVersionToShader","modelOptions","pbrDebug","imageBasedLightingEnvironment","useTangents","scenes","scene","createScene","gltfScene","createNode","gltfMesh","_mesh","primitives","gltfPrimitive","createPrimitive","materialParser","generatedTextures","pbr","createGLTFModel","createAttributes","loadedAttributes","attrName","createAccessor","generated","lumaBuffers","gltfSampler","gltfObjects","waitWhileCondition","scenegraph","getScene","getAnimator","animator","_animations","_lighting","_imageBasedLightingEnvironment","GLTFLoader","ScenegraphLayer","instanceModelMatrix","_updateScenegraph","_applyAnimationsProp","_deleteScenegraph","scenegraphData","ScenegraphNode","instantiator","instantiate","createAnimator","createGLTFObjects","_getModelOptions","waitForGLTFAssets","_applyAllAttributes","attributesAvailable","allAttributes","animationsProp","getAnimations","findResult","waitForFullLoad","composeModelMatrix","sceneModelMatrix","u_Camera","binaryToFeatureForAccesor","featureIndex","featureIds","propertiesIndex","numericPropsIndex","numericProps","getPropertiesForIndex","POINT_LAYER","circle","pointRadiusMaxPixels","pointRadiusMinPixels","pointRadiusScale","pointRadiusUnits","pointAntialiasing","pointBillboard","getPointRadius","iconSizeMaxPixels","iconSizeMinPixels","iconSizeScale","iconSizeUnits","iconAlphaCutoff","iconBillboard","getIconAngle","getIconColor","getIconPixelOffset","getIconSize","textSizeMaxPixels","textSizeMinPixels","textSizeScale","textSizeUnits","textBackground","textBackgroundPadding","textFontFamily","textFontWeight","textLineHeight","textMaxWidth","textOutlineColor","textOutlineWidth","textWordBreak","textCharacterSet","textBillboard","textFontSettings","getTextAngle","getTextColor","getTextPixelOffset","getTextSize","getTextAlignmentBaseline","getTextBackgroundColor","getTextBorderColor","getTextBorderWidth","LINE_LAYER","lineCapRounded","lineBillboard","POLYGON_LAYER","getDefaultProps","forwardProps","sourceKey","targetKey","separateGeojsonFeatures","wrapFeature","separated","pointFeatures","lineFeatures","polygonFeatures","polygonOutlineFeatures","geometries","subGeometry","separateGeometry","sourceFeature","sourceFeatureIndex","coordinates","nestLevel","COORDINATE_NEST_LEVEL","validateGeometry","Point","MultiPoint","LineString","MultiLineString","MultiPolygon","getCoordinates","createLayerPropsFromBinary","geojsonBinary","layerProps","lines","polygons","polygonsOutline","customPickingColors","globalFeatureIds","calculatePickingColors","pathIndices","polygonIndices","primitivePolygonIndices","FEATURE_TYPES","pointType","GeoJsonLayer","_updateStateBinary","_updateStateJSON","geojson","getGeojsonFeatures","newFeatures","featuresDiff","oldFeatures","partialFeatures","createLayerPropsFromFeatures","featureType","ft","pointLayerIdPrefix","sourceIsPoints","PolygonFillLayer","forwardedProps","useLineColor","PolygonStrokeLayer","LineStringsLayer","pointLayers","PointLayerMapping","PointsLayer","pointsLayerProps","rest","polygonFillLayer","_renderPolygonLayer","_renderLineLayers","_renderPointLayers","getSourcePosition","sourcePosition","getTargetPosition","targetPosition","getSourceColor","getTargetColor","getHeight","getTilt","greatCircle","ArcLayer","instanceSourcePositions","instanceTargetPositions","instanceSourceColors","instanceTargetColors","instanceWidths","instanceHeights","instanceTilts","useShortestPath","numSegments","LineLayer","DEFAULT_NORMAL","pointSize","getNormal","radiusPixels","PointCloudLayer","instanceNormals","validateGeometryAttributes","useMeshColors","_useMeshColors","_instanced","SimpleMeshLayer","DERIVATIVES_AVAILABLE","emptyTexture","getModel","hasNormals","setTexture","hasTexture","DEFAULT_MODULE_OPTIONS","selectedColor","picking_uSelectedColorValid","picking_uSelectedColor","picking_uHighlightColor","picking_uActive","picking_uAttribute","getMaterialUniforms","ambient","diffuse","shininess","specularColor","lighting_uAmbient","lighting_uDiffuse","lighting_uShininess","lighting_uSpecularColor","LIGHTING_VERTEX","LIGHTING_FRAGMENT","cloneTextureFrom","refTexture","TextureType","toFramebuffer","FACES","TextureCube","setCubeMapImageData","mipmapLevel","_subImage","imageDataMap","resolvedFaces","facePixels","lodLevel","setImageDataForFace","Texture3D","unpackFlipY","texImage3D","mapboxApiUrl","attributionControl","bool","preserveDrawingBuffer","reuseMaps","transformRequest","mapOptions","oneOfType","asyncRender","accessToken","search","MapboxAccessToken","REACT_APP_MAPBOX_ACCESS_TOKEN","getAccessToken","checkPropTypes","Mapbox","_this","_map","initialized","_checkStyleSheet","_destroy","_frame","_render","savedMap","oldContainer","getContainer","newContainer","classList","childNodes","_container","setStyle","diff","isStyleLoaded","_fireLoadEvent","_reuse","interactive","trackResize","_this2","baseApiUrl","_create","_updateMapViewport","_updateMapSize","sizeChanged","jumpTo","_viewStateToMapboxProps","_ref$pitch","_ref$bearing","_ref$altitude","mapboxVersion","testElement","isCssLoaded","getComputedStyle","setAttribute","head","_classCallCheck","_createClass","signedArea","bridge","bridgeReverse","sum","default","deviation","polygonArea","trianglesArea","holeIndex","BASISLZ","ZSTD","ZLIB","BASICFORMAT","UNSPECIFIED","ETC1S","UASTC","ITU","NTSC","SLOG","SLOG2","ALPHA_STRAIGHT","ALPHA_PREMULTIPLIED","RRR","GGG","AAA","RRRG","U","vkFormat","typeSize","pixelWidth","pixelHeight","pixelDepth","layerCount","faceCount","supercompressionScheme","levels","dataFormatDescriptor","vendorId","descriptorType","versionNumber","descriptorBlockSize","colorModel","colorPrimaries","transferFunction","texelBlockDimension","bytesPlane","keyValue","globalData","_dataView","_littleEndian","_nextUint32","_nextUint64","uncompressedByteLength","_skip","_nextUint16","_nextUint8","bitOffset","bitLength","channelID","samplePosition","sampleLower","sampleUpper","_scan","B","A","I","imageFlags","rgbSliceByteOffset","rgbSliceByteLength","alphaSliceByteOffset","alphaSliceByteLength","R","E","T","O","P","F","G","endpointCount","selectorCount","imageDescs","endpointsData","selectorsData","tablesData","extendedData","GLTFMaterialParser","MANUAL_SRGB","SRGB_FAST_APPROXIMATION","USE_TEX_LOD","u_MetallicRoughnessValues","u_DiffuseEnvSampler","getDiffuseEnvSampler","u_SpecularEnvSampler","getSpecularEnvSampler","u_brdfLUT","getBrdfTexture","u_ScaleIBLAmbient","u_ScaleDiffBaseMR","u_ScaleFGDSpec","defineIfPresent","TANGENT","parseMaterial","gltfTexture","textureOptions","pbrMetallicRoughness","baseColorTexture","parseTexture","u_BaseColorFactor","baseColorFactor","metallicRoughnessTexture","metallicFactor","roughnessFactor","pbr_uUnlit","unlit","parsePbrMetallicRoughness","normalTexture","u_NormalScale","occlusionTexture","strength","u_OcclusionStrength","emissiveTexture","u_EmissiveFactor","emissiveFactor","alphaMode","ALPHA_CUTOFF","u_AlphaCutoff","unsupportedIterableToArray","isFeatureSupported","getFeatures","featureDefinition","queryFeature","dataBaseUrl","getAttribute","__webpack_public_path__","jupyterTransport","JupyterTransportModel","JupyterTransportView","initPlayground","_setPrototypeOf","listenTo","onJsonChanged","onDataBufferChanged","_messageReceived","dataBuffer","DOMWidgetView","LumaGL","deckGLCore","DeckGL","_global","iter","_arr","_n","_d","_e","_s","_i","runtime","Op","hasOwn","$Symbol","iteratorSymbol","asyncIteratorSymbol","toStringTagSymbol","wrap","innerFn","outerFn","tryLocsList","protoGenerator","Generator","generator","Context","_invoke","doneResult","delegate","delegateResult","maybeInvokeDelegate","ContinueSentinel","sent","_sent","dispatchException","abrupt","record","tryCatch","makeInvokeMethod","GeneratorFunction","GeneratorFunctionPrototype","IteratorPrototype","getProto","NativeIteratorPrototype","Gp","defineIteratorMethods","AsyncIterator","previousPromise","callInvokeWithMethodAndArg","invoke","__await","unwrapped","resultName","nextLoc","pushTryEntry","locs","tryLoc","catchLoc","finallyLoc","afterLoc","tryEntries","resetTryEntry","completion","iteratorMethod","isGeneratorFunction","genFun","ctor","mark","awrap","reverse","skipTempReset","rootRecord","rval","exception","loc","caught","hasCatch","hasFinally","finallyEntry","thrown","delegateYield","regeneratorRuntime","accidentalStrictMode","CANVAS_STYLE","mapCanvas","deckCanvas","createCanvas","isMap","_onBeforeRender","getMap","ReactPropTypesSecret","emptyFunction","emptyFunctionWithReset","resetWarningCache","shim","propFullName","secret","getShim","isRequired","ReactPropTypes","symbol","any","arrayOf","elementType","instanceOf","objectOf","oneOf","exact","PropTypes","sourceKeys","kMaxLength","TYPED_ARRAY_SUPPORT","that","encodingOrOffset","allocUnsafe","fromArrayLike","fromArrayBuffer","isEncoding","actual","checked","assertSize","loweredCase","utf8ToBytes","base64ToBytes","slowToString","hexSlice","utf8Slice","asciiSlice","latin1Slice","base64Slice","utf16leSlice","swap","bidirectionalIndexOf","arrayIndexOf","indexSize","arrLength","valLength","readUInt16BE","foundIndex","found","hexWrite","strLen","parsed","utf8Write","blitBuffer","asciiWrite","byteArray","asciiToBytes","latin1Write","base64Write","ucs2Write","utf16leToBytes","fromByteArray","secondByte","thirdByte","fourthByte","tempCodePoint","firstByte","codePoint","codePoints","decodeCodePointsArray","SlowBuffer","alloc","INSPECT_MAX_BYTES","foo","typedArraySupport","_augment","species","allocUnsafeSlow","_isBuffer","swap16","swap32","swap64","inspect","thisStart","thisEnd","thisCopy","targetCopy","toJSON","ret","toHex","checkOffset","checkInt","objectWriteUInt16","littleEndian","objectWriteUInt32","checkIEEE754","noAssert","newBuf","sliceLen","readUIntLE","readUIntBE","readUInt8","readUInt16LE","readUInt32LE","readUInt32BE","readIntLE","readIntBE","readInt8","readInt16LE","readInt16BE","readInt32LE","readInt32BE","readFloatLE","readFloatBE","readDoubleLE","readDoubleBE","writeUIntLE","writeUIntBE","writeUInt8","writeUInt16LE","writeUInt16BE","writeUInt32LE","writeUInt32BE","writeIntLE","writeIntBE","writeInt8","writeInt16LE","writeInt16BE","writeInt32LE","writeInt32BE","writeFloatLE","writeFloatBE","writeDoubleLE","writeDoubleBE","targetStart","INVALID_BASE64_RE","leadSurrogate","toByteArray","stringtrim","base64clean","b64","lens","getLens","validLen","placeHoldersLen","Arr","_byteLength","curByte","revLookup","uint8","extraBytes","len2","encodeChunk","lookup","throwError","unary_ops","binary_ops","getMaxKeyLen","max_len","max_unop_len","max_binop_len","literals","binaryPrecedence","op_val","createBinaryExpression","isDecimalDigit","ch","isIdentifierStart","isIdentifierPart","expr","ch_i","charAtFunc","charCodeAtFunc","exprI","exprICode","gobbleSpaces","gobbleExpression","gobbleBinaryExpression","gobbleBinaryOp","to_check","tc_len","biop","prec","biop_info","gobbleToken","gobbleNumericLiteral","gobbleStringLiteral","gobbleArray","gobbleVariable","chCode","raw","quote","closed","gobbleIdentifier","gobbleArguments","termination","gobbleGroup","addUnaryOp","op_name","addBinaryOp","precedence","addLiteral","literal_name","literal_value","removeUnaryOp","removeAllUnaryOps","removeBinaryOp","removeAllBinaryOps","removeLiteral","removeAllLiterals","shared","workerBundleString","sharedChunk","p1x","p1y","p2x","p2y","sampleCurveX","sampleCurveY","sampleCurveDerivativeX","solveCurveX","solve","_sub","multByPoint","_multByPoint","divByPoint","_divByPoint","mult","_mult","_div","_rotate","rotateAround","_rotateAround","matMult","_matMult","unit","_unit","perp","_perp","_round","distSqr","angleTo","angleWith","angleWithSep","WorkerGlobalScope","safari","V","mozRequestAnimationFrame","webkitRequestAnimationFrame","msRequestAnimationFrame","mozCancelAnimationFrame","webkitCancelAnimationFrame","msCancelAnimationFrame","resolveURL","hardwareConcurrency","matchMedia","API_URL","FEEDBACK_URL","REQUIRE_ACCESS_TOKEN","ACCESS_TOKEN","MAX_PARALLEL_IMAGE_REQUESTS","testSupport","N","K","_transformRequestFn","_customAccessToken","_createSkuToken","token","tokenExpiresAt","_skuToken","_skuTokenExpiresAt","_isSkuTokenExpired","normalizeStyleURL","_makeAPIURL","normalizeGlyphsURL","normalizeSourceURL","authority","normalizeSpriteURL","$","normalizeTileURL","canonicalizeTileURL","canonicalizeTileset","tiles","J","W","decodeURIComponent","atob","Q","anonId","pendingRequest","getStorageKey","encodeURIComponent","fetchEventData","localStorage","saveEventData","processRequests","postEvent","EVENTS_URL","created","toISOString","sdkIdentifier","sdkVersion","skuId","userId","wt","queueRequest","tt","et","success","skuToken","postMapLoadEvent","nt","postTurnstileEvent","lastSuccess","tokenU","getDate","it","at","ot","st","caches","pt","ct","ht","createImageBitmap","yt","Unknown","Style","Source","Tile","Glyphs","SpriteImage","SpriteJSON","dt","mt","xt","Request","AbortController","toUTCString","put","actor","XMLHttpRequest","responseType","setRequestHeader","withCredentials","getResponseHeader","_t","At","accept","requestParameters","cancelled","revokeObjectURL","cacheControl","expires","St","kt","It","zt","Ct","_listeners","_oneTimeListeners","fire","listens","_eventedParent","_eventedParentData","setEventedParent","Et","$version","$root","period","sprite","glyphs","source_vector","scheme","tms","minzoom","maxzoom","attribution","promoteId","volatile","source_raster","raster","tileSize","source_raster_dem","terrarium","mapbox","source_geojson","maximum","minimum","tolerance","cluster","clusterRadius","clusterMaxZoom","clusterMinPoints","clusterProperties","lineMetrics","generateId","source_video","urls","source_image","heatmap","hillshade","paint","layout_background","visibility","none","layout_fill","interpolated","layout_circle","layout_heatmap","layout_line","butt","square","bevel","miter","requires","layout_symbol","auto","both","tokens","horizontal","vertical","uppercase","lowercase","layout_raster","layout_hillshade","filter_operator","in","within","stops","exponential","categorical","colorSpace","rgb","lab","hcl","function_stop","anchor","paint_fill","paint_line","paint_circle","paint_heatmap","paint_symbol","overridable","paint_raster","linear","nearest","paint_hillshade","paint_background","Pt","__line__","Mt","Bt","Tt","valueOf","Vt","Ft","Dt","bindings","Lt","kind","Ot","Rt","Ut","jt","qt","Nt","Kt","Gt","Zt","Xt","itemType","Jt","Ht","Yt","$t","Wt","Qt","transparent","aliceblue","antiquewhite","aqua","aquamarine","azure","beige","bisque","black","blanchedalmond","blue","blueviolet","brown","burlywood","cadetblue","chartreuse","chocolate","coral","cornflowerblue","cornsilk","crimson","cyan","darkblue","darkcyan","darkgoldenrod","darkgray","darkgreen","darkgrey","darkkhaki","darkmagenta","darkolivegreen","darkorange","darkorchid","darkred","darksalmon","darkseagreen","darkslateblue","darkslategray","darkslategrey","darkturquoise","darkviolet","deeppink","deepskyblue","dimgray","dimgrey","dodgerblue","firebrick","floralwhite","forestgreen","fuchsia","gainsboro","ghostwhite","gold","goldenrod","gray","green","greenyellow","grey","honeydew","hotpink","indianred","indigo","ivory","khaki","lavender","lavenderblush","lawngreen","lemonchiffon","lightblue","lightcoral","lightcyan","lightgoldenrodyellow","lightgray","lightgreen","lightgrey","lightpink","lightsalmon","lightseagreen","lightskyblue","lightslategray","lightslategrey","lightsteelblue","lightyellow","lime","limegreen","linen","magenta","maroon","mediumaquamarine","mediumblue","mediumorchid","mediumpurple","mediumseagreen","mediumslateblue","mediumspringgreen","mediumturquoise","mediumvioletred","midnightblue","mintcream","mistyrose","moccasin","navajowhite","navy","oldlace","olive","olivedrab","orange","orangered","orchid","palegoldenrod","palegreen","paleturquoise","palevioletred","papayawhip","peachpuff","peru","pink","plum","powderblue","purple","rebeccapurple","red","rosybrown","royalblue","saddlebrown","salmon","sandybrown","seagreen","seashell","sienna","silver","skyblue","slateblue","slategray","slategrey","snow","springgreen","steelblue","teal","thistle","tomato","turquoise","violet","wheat","white","whitesmoke","yellow","yellowgreen","parseCSSColor","te","ee","sensitivity","locale","collator","Intl","Collator","resolvedLocale","fontStack","textColor","ne","sections","ie","available","ae","oe","ue","expectedType","eachChild","outputDefined","pe","ce","he","fe","content","ye","availableImages","de","me","parseColor","ve","ge","featureState","formattedSection","_parseColorCache","canonical","geometryType","canonicalID","xe","_evaluate","definitions","overloads","je","registry","scope","checkSubtype","be","caseSensitive","diacriticSensitive","we","Ae","Se","ke","Ie","ze","Ce","Ee","Pe","Me","Be","Te","Ve","Fe","De","Le","Oe","Re","Ue","boundExpression","qe","_parse","typeAnnotation","Ne","labels","outputs","Ke","Ge","Ze","Xe","Je","He","Ye","$e","We","Qe","alpha","tr","er","rr","forward","nr","ir","ar","interpolationFactor","controlPoints","ur","pr","needle","haystack","fromIndex","hr","inputType","cases","otherwise","outputIndex$1","fr","branches","yr","beginIndex","mr","vr","lhs","rhs","hasUntypedArgument","gr","xr","br","wr","_r","Ar","Sr","currency","minFractionDigits","maxFractionDigits","NumberFormat","minimumFractionDigits","maximumFractionDigits","kr","Ir","case","coalesce","let","literal","var","zr","Cr","Er","Pr","Mr","Br","Tr","Vr","Fr","Dr","Lr","Or","Rr","Ur","jr","Nr","typeof","rgba","heatmapDensity","lineProgress","accumulated","ln2","pi","log10","LN10","ln","isSupportedScript","upcase","downcase","Kr","_warningHistory","_evaluator","_defaultValue","_enumValues","Gr","Zr","enum","resolvedImage","evaluateWithoutErrorHandling","Xr","_styleExpression","isStateDependent","Jr","zoomStops","interpolationType","Hr","Yr","_parameters","_specification","$r","valueSpec","objectElementValidators","styleSpec","An","objectKey","Wr","arrayElementValidator","arrayIndex","Qr","tn","en","expressionContext","propertyKey","propertyType","rn","nn","deserialize","needGeometry","un","sn","hn","pn","cn","yn","layerType","dn","mn","vn","gn","xn","bn","wn","Sn","kn","In","zn","paintProperty","layoutProperty","Cn","En","Pn","Mn","Bn","Tn","Vn","cells","bboxes","insert","_insertReadonly","_forEachCell","_insertCell","query","_queryCell","_convertToCellCoord","_convertFromCellCoord","Fn","Dn","Ln","On","writeable","klass","omit","shallow","Rn","_classRegistryKey","Un","jn","qn","$name","Nn","Kn","first","lastIntegerZoom","lastIntegerZoomTime","lastZoom","lastFloorZoom","Gn","Arabic","Khmer","Hiragana","Katakana","Bopomofo","Kanbun","Zn","Xn","Jn","Hn","Yn","$n","Wn","Qn","ti","ei","ri","ni","pluginStatus","pluginURL","oi","applyArabicShaping","processBidirectionalText","processStyledBidirectionalText","isLoading","isParsed","getPluginURL","si","fadeDuration","zoomHistory","crossFadingFactor","getCrossfadeParameters","fromScale","toScale","ui","specification","isDataDriven","possiblyEvaluate","li","transitioned","ci","untransitioned","_properties","defaultTransitionablePropertyValues","setValue","getTransition","setTransition","prior","defaultTransitioningPropertyValues","di","hasTransition","fi","defaultPropertyValues","yi","constantOr","defaultPossiblyEvaluatedValues","mi","vi","gi","_calculate","xi","bi","wi","overridableProperties","_featureFilter","_unevaluatedLayout","_transitionablePaint","setPaintProperty","setLayoutProperty","_transitioningPaint","_crossfadeParameters","getLayoutProperty","_validate","getPaintProperty","_handleSpecialPaintPropertyUpdate","_handleOverridablePaintPropertyUpdate","isHidden","updateTransitions","recalculate","is3D","isTileClipped","hasOffscreenPass","Ai","Si","_structArray","_pos1","_pos2","_pos4","_pos8","ki","isTransferred","capacity","Ii","members","zi","alignment","_trim","_refreshViews","reserve","Ci","int16","emplaceBack","emplace","Ei","Pi","Mi","Bi","float32","Ti","uint16","Vi","Fi","Di","uint32","Li","Oi","Ri","Ui","ji","qi","Ni","Ki","Gi","Zi","Xi","Ji","Hi","Yi","anchorPointX","anchorPointY","sourceLayerIndex","bucketIndex","anchorPoint","$i","Wi","glyphStartIndex","numGlyphs","vertexStartIndex","lineLength","segment","lowerSize","upperSize","lineOffsetX","lineOffsetY","writingMode","placedOrientation","hidden","crossTileID","associatedIconIndex","Qi","ta","rightJustifiedTextSymbolIndex","centerJustifiedTextSymbolIndex","leftJustifiedTextSymbolIndex","verticalPlacedTextSymbolIndex","placedIconSymbolIndex","verticalPlacedIconSymbolIndex","textBoxStartIndex","textBoxEndIndex","verticalTextBoxStartIndex","verticalTextBoxEndIndex","iconBoxStartIndex","iconBoxEndIndex","verticalIconBoxStartIndex","verticalIconBoxEndIndex","numHorizontalGlyphVertices","numVerticalGlyphVertices","numIconVertices","numVerticalIconVertices","useRuntimeCollisionCircles","textBoxScale","textOffset0","textOffset1","collisionCircleDiameter","ea","ra","getoffsetX","na","getx","gety","gettileUnitDistanceFromAnchor","ia","aa","oa","sa","segments","ua","prepareSegment","MAX_VERTEX_ARRAY_LENGTH","vertexLength","sortKey","primitiveOffset","primitiveLength","vaos","simpleSegment","la","pa","ca","ha","fa","murmur3","murmur2","ya","ids","indexed","ma","va","da","ga","xa","current","uniform1i","ba","uniform1f","wa","uniform2f","_a","uniform3f","Aa","uniform4f","Sa","ka","Ia","uniformMatrix4fv","za","Ca","setUniform","getBinding","Ea","patternFrom","patternTo","pixelRatioFrom","pixelRatioTo","setConstantPatternPositions","tlbr","Pa","maxValue","paintVertexAttributes","paintVertexArray","populatePaintArray","_setPaintValue","updatePaintArray","upload","paintVertexBuffer","updateData","createVertexBuffer","Ma","useIntegerZoom","Ba","zoomInPaintVertexArray","zoomOutPaintVertexArray","_setPaintValues","patterns","mid","tl","zoomInPaintVertexBuffer","zoomOutPaintVertexBuffer","Ta","binders","_buffers","Fa","Da","getMaxValue","populatePaintArrays","updatePaintArrays","getBinderAttributes","getBinderUniforms","getPaintVertexBuffers","updatePaintBuffers","Va","programConfigurations","needsUpload","_featureMap","_bufferOffset","composite","La","Oa","Ra","loadGeometry","Ua","ja","qa","overscaling","hasPattern","layoutVertexArray","indexArray","stateDependentLayerIds","Na","Wa","Xa","Ka","Ha","Ga","$a","Za","Ja","Ya","Qa","eo","ro","populate","addFeature","stateDependentLayers","uploadPending","uploaded","layoutVertexBuffer","indexBuffer","createIndexBuffer","no","io","ao","oo","so","uo","po","co","createBucket","queryRadius","queryIntersectsFeature","ho","cameraToCenterDistance","fo","yo","mo","vo","go","xo","bo","wo","clips","evaluationKey","_o","_updateColorRamp","colorRamp","colorRampTexture","heatmapFbo","Ao","So","ko","Io","Co","zo","Eo","Uo","Do","Lo","Po","Mo","Qo","Yo","Ko","$o","No","Ro","To","Bo","Vo","Fo","jo","Go","Jo","qo","Ho","Oo","Xo","Zo","Wo","ts","es","rs","is","as","patternDependencies","os","ss","patternFeatures","indexArray2","segments2","addFeatures","indexBuffer2","us","ls","ps","cs","hs","_pbf","_geometry","_keys","ys","ds","toGeoJSON","_features","gs","xs","bs","VectorTile","VectorTileFeature","VectorTileLayer","ws","As","Ss","ks","Is","zs","Es","Cs","Ps","Ms","Bs","Ts","Vs","Fs","lineClipsArray","gradients","layoutVertexArray2","maxLineLength","layoutVertexBuffer2","lineFeatureClips","mapbox_clip_start","mapbox_clip_end","lineClips","addLine","scaledDistance","totalDistance","updateScaledDistance","e1","e2","updateDistance","addCurrentVertex","addHalfVertex","Ds","Ls","Os","Rs","gradientVersion","stepInterpolant","gradientExpression","Us","js","qs","Ns","Ks","Gs","Zs","toLocaleUpperCase","toLocaleLowerCase","Xs","Js","Hs","Ys","$s","Ws","Qs","tu","eu","ru","nu","iu","au","ou","su","uu","lu","pu","cu","hu","fu","yu","du","mu","advance","vu","gu","stretchX","stretchY","paddedRect","xu","displaySize","bu","haveRenderCallbacks","addImages","iconPositions","patternPositions","hasRenderCallback","patchUpdatedImages","dispatchRenderCallbacks","updatedImages","patchUpdatedImage","getImage","wu","horizontalOnly","_u","imageName","forText","forImage","Au","sectionIndex","imageSectionID","Su","fromFeature","verticalizePunctuation","Mu","positionedLines","iconsInText","verticalizable","getMaxScale","positionedGlyphs","lineOffset","getSection","getSectionIndex","getCharCode","ku","Tu","Bu","horizontalAlign","verticalAlign","addImageSection","addTextSection","getNextImageSectionCharCode","10","11","12","13","32","Iu","zu","Cu","Eu","Pu","badness","priorBreak","Vu","collisionPadding","Fu","Du","layoutSize","minSize","Lu","uSize","uSizeT","Ou","Ru","getSizeData","evaluateSizeForFeature","evaluateSizeForZoom","SIZE_PACK_FACTOR","Uu","angleDelta","ju","qu","Nu","Ku","Gu","Zu","Xu","Ju","Yu","stretch","$u","fixed","bl","tex","glyphOffset","pixelOffsetTL","pixelOffsetBR","minFontScaleX","minFontScaleY","isSDF","Hu","Wu","boxStartIndex","circleDiameter","boxEndIndex","Qu","_down","SQRT2","_up","peek","il","al","sl","allowVerticalPlacement","textSizeData","compositeTextSizes","addSymbols","placedSymbolArray","ul","ll","compareText","pl","cl","hl","fl","yl","dl","dynamicLayoutVertexArray","opacityVertexArray","dynamicLayoutVertexBuffer","opacityVertexBuffer","itemSize","ml","layoutAttributes","collisionVertexArray","collisionVertexBuffer","vl","collisionBoxArray","hasRTLText","sortKeyRanges","collisionCircleArray","placementInvProjMatrix","placementViewportMatrix","iconSizeData","canOverlap","sortFeaturesByKey","sortFeaturesByY","writingModes","sourceID","createArrays","glyphOffsetArray","lineVertexArray","symbolInstances","calculateGlyphDependencies","iconDependencies","glyphDependencies","getValueAndResolveTokens","hasDebugData","textCollisionBox","iconCollisionBox","destroyDebugData","addToLineVertexArray","tileUnitDistanceFromAnchor","_addCollisionDebugVertex","addCollisionDebugVertices","addDebugCollisionBoxes","generateCollisionDebugBuffers","_deserializeCollisionBoxesForSymbol","textBox","textFeatureIndex","verticalTextBox","verticalTextFeatureIndex","iconBox","iconFeatureIndex","verticalIconBox","verticalIconFeatureIndex","deserializeCollisionBoxes","collisionArrays","hasTextData","hasIconData","hasTextCollisionBoxData","hasIconCollisionBoxData","addIndicesForPlacedSymbol","getSortedSymbolIndexes","sortedAngle","symbolInstanceIndexes","addToSortKeyRanges","symbolInstanceEnd","symbolInstanceStart","sortFeatures","featureSortOrder","MAX_GLYPHS","addDynamicAttributes","xl","runtimeType","getOverride","hasOverride","wl","_setPaintOverrides","hasPaintOverride","_interpolationType","_l","Al","Sl","kl","Il","implementation","renderingMode","prerender","onAdd","painter","onRemove","zl","Cl","El","Pl","Ml","Bl","Tl","useMipmap","pixelStoreUnpackFlipY","pixelStoreUnpack","pixelStoreUnpackPremultiplyAlpha","premultiply","isSizePowerOfTwo","Vl","_callback","_triggered","MessageChannel","_channel","port2","trigger","port1","Fl","mapId","callbacks","tasks","taskQueue","cancelCallbacks","invoker","receive","globalScope","Dl","hasCallback","targetMapId","mustQueue","sourceMapId","processTask","getWorkerSource","Ll","setSouthWest","setNorthEast","_ne","Ol","_sw","getSouthWest","getNorthEast","getNorthWest","getWest","getNorth","getSouthEast","getEast","getSouth","distanceTo","toBounds","lon","Rl","Ul","jl","ql","Nl","Kl","Gl","fromLngLat","toLngLat","toAltitude","meterInMercatorCoordinateUnits","Zl","Hl","getTilePoint","Xl","Jl","overscaledZ","scaledTo","calculateScaledKey","isChildOf","isLessThan","wrapped","unwrapTo","overscaleFactor","toUnwrapped","Yl","_idx","_unpackTerrarium","_unpackMapbox","getUnpackVector","getPixels","backfillBorder","$l","_stringToNumber","_numberToString","Wl","_vectorTileFeature","_z","Ql","tp","stateChanges","deletedStates","removeFeatureState","initializeTileState","setFeatureState","coalesceChanges","ep","tileID","grid3D","featureIndexArray","rp","np","ip","loadVTLayers","vtLayers","rawTileData","sourceLayerCoder","queryGeometry","queryPadding","cameraQueryGeometry","loadMatchingFeature","pixelPosMatrix","bucketLayerIDs","getId","intersectionZ","lookupSymbolFeatures","hasLayer","ap","uses","buckets","expirationTime","hasSymbolBuckets","expiredRequestCount","registerFadeDuration","timeAdded","fadeEndTime","wasRequested","loadVectorData","hasData","unloadVectorData","latestFeatureIndex","latestRawTileData","getLayer","justReloaded","imageAtlas","glyphAtlasImage","imageAtlasTexture","glyphAtlasTexture","getBucket","prepare","queryRenderedFeatures","querySourceFeatures","_geojsonTileLayer","tile","patternsLoaded","setExpiryData","getExpiryTimeout","holdingForFade","symbolFadeHoldUntil","symbolFadeFinished","clearFadeHold","setHoldDuration","setDependencies","hasDependency","op","_marks","measure","getEntriesByName","clearMarks","clearMeasures","Actor","AlphaImage","CanonicalTileID","CollisionBoxArray","Color","DEMData","DataConstantProperty","DictionaryCoder","EXTENT","ErrorEvent","EvaluationParameters","Event","Evented","FeatureIndex","FillBucket","FillExtrusionBucket","ImageAtlas","ImagePosition","LineBucket","LngLat","LngLatBounds","MercatorCoordinate","ONE_EM","OverscaledTileID","Point$1","Properties","Protobuf","RGBAImage","RequestManager","RequestPerformance","ResourceType","SegmentVector","SourceFeatureState","StructArrayLayout1ui2","StructArrayLayout2f1f2i16","StructArrayLayout2i4","StructArrayLayout3ui6","StructArrayLayout4i8","SymbolBucket","Transitionable","Uniform1f","Uniform1i","Uniform2f","Uniform3f","Uniform4f","UniformColor","UniformMatrix4f","UnwrappedTileID","ValidationError","WritingMode","ZoomHistory","asyncAll","bezier","bindAll","cacheEntryPossiblyAdded","getActor","clearTileCache","clipLine","clone$1","clone$2","collisionCircleLayout","create$1","create$2","createCommonjsModule","createExpression","createLayout","createStyleLayer","dot$1","ease","emitValidationErrors","endsWith","enforceCacheSizeLimit","evaluateVariableOffset","evented","featureFilter","filterObject","fromRotation","getAnchorAlignment","getAnchorJustification","getArrayBuffer","getJSON","getRTLTextPluginStatus","getReferrer","getVideo","muted","onloadstart","host","isChar","isMapboxURL","keysDifference","makeRequest","mapObject","mercatorXfromLng","mercatorYfromLat","mercatorZfromAltitude","mvt","nextPowerOfTwo","offscreenCanvasSupported","parseGlyphPBF","performSymbolLayout","tilePixelRatio","iconsNeedLinear","compositeIconSizes","layoutTextSize","layoutIconSize","textMaxSize","sdfIcons","pick","plugin","polygonIntersectsPolygon","potpack","refProperties","registerForPluginStateChange","renderColorRamp","scale$1","scale$2","setCacheLimits","setRTLTextPlugin","sphericalToCartesian","symbolSize","triggerPluginCompletionEvent","validateCustomStyleLayer","validateLight","validateStyle","vectorTile","warnOnce","webpSupported","keyCache","_layerConfigs","_layers","familiesBySource","showCollisionBoxes","collectResourceTiming","returnDependencies","rawData","stacks","glyphMap","iconMap","glyphPositions","loading","loadTile","resourceTiming","reloadTile","reloadCallback","abortTile","removeTile","rawImageData","offscreenCanvas","offscreenCanvasContext","_feature","tags","rawGeometry","keycache","valuecache","fromVectorTileJs","fromGeojsonVt","GeoJSONWrapper","nodeSize","minPoints","trees","cluster_id","point_count","point_count_abbreviated","transformed","numSimplified","numFeatures","tileCoords","indexMaxZoom","indexMaxPoints","splitTile","_geoJSONIndex","getTile","_cluster","getClusters","_limitZoom","getChildren","_getOriginId","_getOriginZoom","getLeaves","_appendLeaves","_addTileFeatures","getClusterExpansionZoom","loadGeoJSON","loadData","_pendingCallback","abandoned","_pendingLoadDataParams","_loadData","superclusterOptions","geojsonVtOptions","removeSource","clusterId","getClusterChildren","getClusterLeaves","layerIndexes","workerSourceTypes","workerSources","demWorkerSources","registerWorkerSource","registerRTLTextPlugin","setReferrer","setImages","getLayerIndex","removedIds","loadDEMTile","getDEMWorkerSource","removeDEMTile","loadWorkerSource","syncRTLPluginState","getAvailableImages","reduceRight","isSealed","isFrozen","isExtensible","preventExtensions","failIfMajorPerformanceCaveat","webGLContextAttributes","probablySupportsContext","supportsContext","notSupportedReason","antialias","createNS","createElementNS","documentElement","disableDrag","enableDrag","setTransform","capture","userImage","suppressClick","mousePos","touchPos","mouseButton","InstallTrigger","platform","images","callbackDispatchedThisFrame","requestors","atlasImage","dirty","setLoaded","_notify","addImage","_validateStretch","_validateContent","updateImage","removeImage","listImages","getImages","getPixelSize","getPattern","bin","_updatePatternAtlas","atlasTexture","beginFrame","requestManager","localIdeographFontFamily","setURL","getGlyphs","requests","ranges","_tinySDF","loadGlyphRange","_doesCharSupportLocalGlyph","_transitionable","setLight","_transitioning","getLight","nextRow","dashEntry","getDash","addDash","getDashRanges","isDash","zeroLength","addRoundDash","addRegularDash","actors","currentActor","acquire","vector_layers","vectorLayers","vectorLayerIds","broadcast","validateBounds","dispatcher","reparseOverscaled","_loaded","_collectResourceTiming","_tileJSONRequest","_requestManager","tileBounds","_getMapId","sourceDataType","hasTile","setSourceProperty","sourceCaches","clearTiles","setTiles","setUrl","_refreshExpiredTiles","unloadTile","roundZoom","getTileTexture","extTextureFilterAnisotropic","extTextureFilterAnisotropicMax","saveTileTexture","dem","needsHillshadePrepare","neighboringTiles","_getNeighboringTiles","backfilled","demTexture","_removed","_resourceTiming","_updateWorkerData","_finishLoading","setCoordinates","_boundsArray","boundsBuffer","boundsSegments","triggerRepaint","seek","seekable","_hasInvalidDimensions","_playing","calculatePosMatrix","maxPitchScaleFactor","tilesIn","wrappedTileID","queryResults","getFeatureState","_getAndRemoveByKey","getAndRemove","getByKey","setMaxSize","dynamicDraw","unbindVAO","bindElementBuffer","bindVertexBuffer","enableAttributes","setVertexAttribPointers","getDefault","setDefault","extVertexArrayObject","setDirty","colorAttachment","depthAttachment","ReadOnly","ReadWrite","disabled","depthFail","blendFunction","Replace","unblended","alphaBlended","backCCW","cullFaceSide","extTextureHalfFloat","extRenderToTextureHalfFloat","extTimerQuery","maxTextureSize","setCullFace","setDepthMode","setStencilMode","setColorMode","_sourceLoaded","reload","_sourceErrored","_source","_tiles","_unloadTile","_timers","_cacheTimers","_maxTileCacheSize","_loadedParentTiles","_coveredTiles","getSource","_shouldReloadOnResume","_loadTile","_abortTile","imageManager","getIds","getRenderableIds","_isIdRenderable","hasRenderableParent","findLoadedParent","_reloadTile","_tileLoaded","refreshedUponExpiration","_setTileReloadTimer","_backfillDEM","getTileByID","_retainLoadedChildren","_getLoadedTile","updateCacheSize","handleWrapJump","_prevLng","getVisibleUnwrappedCoordinates","coveringTiles","coveringZoomLevel","maxOverzooming","maxUnderzooming","_updateRetainedTiles","_addTile","_fadeDuration","_removeTile","_updateLoadedParentTileCache","releaseSymbolFadeTiles","getCameraQueryGeometry","pointCoordinate","getVisibleCoordinates","posMatrix","reloadTilesForDependencies","workers","workerCount","numActive","isPreloaded","addLayer","removeLayer","setFilter","addSource","setGeoJSONSourceData","setLayerZoomRange","setLayerProperty","setCenter","setZoom","setBearing","setPitch","setSprite","setGlyphs","command","_distances","paddedLength","boxCells","circleCells","xCellCount","yCellCount","circleKeys","boxKeys","circles","xScale","yScale","boxUid","circleUid","labelPlaneMatrix","glCoordMatrix","signedDistanceFromCamera","useVertical","notEnoughRoom","needsFlipping","keysLength","_insertBoxCell","insertCircle","_insertCircleCell","_query","hitTest","seenUids","box","_queryCircle","_queryCellCircle","hitTestCircle","_circleAndRectCollide","_circlesCollide","_convertToXCellCoord","_convertToYCellCoord","ignoredGrid","pitchfactor","_pitch","screenRightBoundary","screenBottomBoundary","gridRightBoundary","gridBottomBoundary","placeCollisionBox","projectAndGetPerspectiveRatio","perspectiveRatio","isInsideGrid","offscreen","isOffscreen","placeCollisionCircles","collisionDetected","queryRenderedSymbols","bucketInstanceId","insertCollisionBox","collisionGroupID","insertCollisionCircles","getViewportMatrix","placed","skipFade","invProjMatrix","crossSourceCollisions","maxGroupID","collisionGroups","ID","predicate","collisionIndex","placements","opacities","variableOffsets","stale","commitTime","retainedQueryData","collisionCircleArrays","prevPlacement","placedOrientations","getBucketParts","bucket","textLabelPlaneMatrix","labelToScreenMatrix","textPixelRatio","partiallyEvaluatedTextSize","collisionGroup","attemptAnchorPlacement","textOffset","prevAnchor","markUsedJustification","markUsedOrientation","placedGlyphBoxes","placeLayerBucketPart","zoomAtLastRecencyCheck","prevZoomAdjustment","zoomAdjustment","symbolFadeChange","lastPlacementChangeTime","updateLayerOpacities","updateBucketOpacities","hasTransitions","stillRecent","setStale","_sortAcrossTiles","_currentTileIndex","_currentPartIndex","_seenCrossTileIDs","_bucketParts","continuePlacement","placement","_currentPlacementIndex","_forceFullPlacement","_showCollisionBoxes","_done","_inProgressLayer","indexedSymbolInstances","getScaledCoordinates","findMatches","maxCrossTileID","generate","indexes","usedCrossTileIDs","addBucket","removeBucketCrossTileIDs","removeStaleBuckets","crossTileIDs","maxBucketInstanceId","bucketsInCurrentPlacement","pruneUnusedLayers","glyphManager","lineAtlas","crossTileSymbolIndex","_serializedLayers","_availableImages","_resetUpdates","_rtlTextPluginCallback","sourceId","_validateLayer","loadURL","_request","_load","loadJSON","loadEmpty","stylesheet","_loadSprite","_serializeLayers","_spriteRequest","_updatedSources","_checkLoaded","_changed","_updatedLayers","_removedLayers","_updateWorkerLayers","_reloadSource","_clearSource","_updateTilesForChangedImages","_updatedPaintProps","_changedImages","_afterImageUpdated","isSourceLoaded","_layerOrderChanged","moveLayer","getFilter","_flattenAndSortRenderedFeatures","addSourceType","getSourceType","setSourceType","workerSourceURL","_remove","_updateSources","_generateCollisionBoxes","_updatePlacement","pauseablePlacement","_releaseSymbolFadeTiles","getResource","fragmentSource","vertexSource","staticAttributes","staticUniforms","prelude","backgroundPattern","clippingMask","heatmapTexture","collisionBox","collisionCircle","fillOutline","fillOutlinePattern","fillPattern","fillExtrusion","fillExtrusionPattern","hillshadePrepare","lineGradient","linePattern","lineSDF","symbolIcon","symbolSDF","symbolTextAndIcon","boundProgram","boundLayoutVertexBuffer","boundPaintVertexBuffers","boundIndexBuffer","boundVertexOffset","boundDynamicVertexBuffer","boundDynamicVertexBuffer2","freshBind","numAttributes","currentNumAttributes","createProgram","failedToCreate","attachShader","bindAttribLocation","linkProgram","getUniformLocation","fixedUniforms","binderUniforms","tileZoom","u_image","u_texsize","u_scale","u_fade","u_pixel_coord_upper","u_pixel_coord_lower","drawElements","u_matrix","u_lightpos","u_lightintensity","u_lightcolor","u_vertical_gradient","u_opacity","u_height_factor","u_world","pixelsToGLUnits","u_camera_to_center_distance","u_scale_with_map","translatePosMatrix","u_pitch_with_map","u_device_pixel_ratio","u_extrude_scale","u_pixels_to_tile_units","u_overscale_factor","u_inv_matrix","u_viewport_size","u_color","u_overlay","u_overlay_scale","u_intensity","u_ratio","u_units_to_pixels","u_image_height","u_patternscale_a","u_patternscale_b","u_sdfgamma","u_tex_y_a","u_tex_y_b","u_mix","u_tl_parent","u_scale_parent","u_buffer_scale","u_fade_t","mix","u_image0","u_image1","u_brightness_low","u_brightness_high","u_saturation_factor","u_contrast_factor","u_spin_weights","u_is_size_zoom_constant","u_is_size_feature_constant","u_size_t","u_size","u_pitch","u_rotate_symbol","u_aspect_ratio","u_fade_change","u_label_plane_matrix","u_coord_matrix","u_is_text","u_texture","u_gamma_scale","u_is_halo","u_texsize_icon","u_texture_icon","u_pattern_tl_a","u_pattern_br_a","u_pattern_tl_b","u_pattern_br_b","u_pattern_size_a","u_pattern_size_b","u_scale_a","u_scale_b","u_tile_units_to_pixels","u_color_ramp","u_latrange","u_light","u_shadow","u_highlight","u_accent","u_dimension","u_zoom","u_unpack","circleArray","circleOffset","invTransform","colorModeForRenderPass","shiftedAnchor","depthModeForSublayer","rotating","zooming","uniformValues","atlasTextureIcon","atlasInterpolation","atlasInterpolationIcon","hasHalo","TEXTURE1","stencilModeForClipping","moving","rasterBoundsBuffer","quadTriangleIndexBuffer","rasterBoundsSegments","debugBuffer","tileBorderIndexBuffer","debugSegments","initDebugOverlayCanvas","debugOverlayCanvas","shadowBlur","strokeStyle","strokeText","debugOverlayTexture","programConfiguration","viewportBuffer","viewportSegments","gradient","opaquePassEnabledForLayer","depthRangeFor3D","stencilModeFor3D","stencilConfigForOverlap","isPatternMissing","tileExtentBuffer","tileExtentSegments","custom","setCustomLayerDefaults","customLayerMatrix","setBaseState","_tileTextures","setup","numSublayers","depthEpsilon","gpuTimers","stencilClearMode","nextStencilID","currentStencilSource","_renderTileClippingMasks","_tileClippingMaskIDs","_showOverdrawInspector","currentLayer","opaquePassCutoff","renderLayer","showOverdrawInspector","showTileBoundaries","showPadding","centerPoint","gpuTimingStart","gpuTimingEnd","gpuTiming","calls","createQueryEXT","beginQueryEXT","endQueryEXT","collectGpuTimers","queryGpuTimers","getQueryObjectEXT","deleteQueryEXT","planes","fromInvProjectionMatrix","quadrant","distanceX","distanceY","maxValidLatitude","_renderWorldCopies","_minZoom","_maxZoom","_minPitch","_maxPitch","setMaxBounds","_center","_fov","_unmodified","_edgeInsets","_posMatrixCache","_alignedPosMatrixCache","renderWorldCopies","worldSize","centerOffset","unmodified","latRange","_calcMatrices","_zoom","zoomScale","zoomFraction","_constrain","isPaddingEqual","interpolatePadding","scaleZoom","aabb","fullyVisible","distanceSq","setLocationAtPoint","locationCoordinate","coordinateLocation","locationPoint","coordinatePoint","pointLocation","pixelMatrixInverse","pixelMatrix","getMaxBounds","lngRange","alignedProjMatrix","projMatrix","mercatorMatrix","_constraining","getCameraPoint","_hashName","_updateHash","_updateHashUnthrottled","addTo","_onHashChange","getHashString","getZoom","getBearing","getPitch","_getCurrentHash","touchZoomRotate","history","replaceState","linearity","deceleration","maxSpeed","amount","_inertiaBuffer","_drainInertiaBuffer","_onMoveEnd","pinchAround","zoomDelta","bearingDelta","pitchDelta","panDelta","noMoveStart","getCanvasContainer","originalEvent","_defaultPrevented","defaultPrevented","lngLats","_clickTolerance","clickTolerance","_mousedownPos","wheel","_firePreventable","isActive","_delayContextMenu","_contextMenuEvent","contextmenu","_el","_enabled","_startPos","_lastPos","mousemoveWindow","_box","_fireEvent","mouseupWindow","cameraAnimation","fitScreenCoordinates","keydown","keyCode","blur","numTouches","centroid","singleTap","numTaps","lastTap","_zoomIn","_zoomOut","easeTo","0","_moved","_lastPoint","_eventButton","_correctButton","_minTouches","_touches","_sum","_calculateTransform","_firstTwoTouches","_aroundCenter","_distance","_startDistance","_minDiameter","_startVector","_vector","_isBelowThreshold","_valid","_firstMove","_lastPoints","gestureBeginsVertically","panStep","bearingStep","pitchStep","_panStep","_bearingStep","_pitchStep","_rotationDisabled","easeId","disableRotation","enableRotation","_handler","_delta","_defaultZoomRate","_wheelZoomRate","setZoomRate","setWheelZoomRate","_finishTimeout","_zooming","_lastWheelEventTime","_type","_lastValue","_timeout","_onTimeout","_lastWheelEvent","_frameId","_around","_aroundPoint","_triggerRenderFrame","_targetZoom","_startZoom","_easing","_smoothOutEasing","noInertia","needsRenderFrame","_prevEase","_clickZoom","_tapZoom","_tap","_swipePoint","_swipeTouch","_tapTime","_mousePan","_touchPan","_inertiaOptions","_pitchWithRotate","pitchWithRotate","_mouseRotate","_mousePitch","_touchZoom","_touchRotate","_tapDragZoom","drag","_handlers","_handlersById","_changes","_inertia","_bearingSnap","bearingSnap","_previousActiveHandlers","_eventsInProgress","_addDefaultHandlers","handleWindowEvent","boxZoom","touchPitch","handlerName","allowed","_updatingCamera","_fireEvents","isMoving","_blockedByActive","_getMapTouches","mergeHandlerResult","_stop","_applyChanges","_updateMapTransform","resetNorth","_requestFrame","_renderTaskQueue","_moving","panBy","panTo","zoomTo","getPadding","setPadding","rotateTo","resetNorthPitch","snapToNorth","cameraForBounds","_cameraForBoxAndBearing","_fitInternal","flyTo","essential","prefersReducedMotion","_normalizeBearing","_normalizeCenter","_rotating","pitching","_pitching","_easeId","_prepareEase","_ease","_fireMoveEvents","_afterEase","isEasing","_easeFrameId","_cancelRenderFrame","_onEaseFrame","_onEaseEnd","_easeStart","_easeOptions","_requestRenderFrame","_renderFrameCallback","getDefaultPosition","compact","_compactButton","_toggleAttribution","_setElementTitle","_innerContainer","_updateAttributions","_updateEditLink","_updateData","_updateCompact","_attribHTML","_getUIString","_editLink","styleOwner","styleId","_hash","customAttribution","owner","_updateLogo","_logoRequired","mapbox_logo","_queue","_id","_cleared","_currentlyRunning","HTMLElement","refreshExpiredTiles","maxTileCacheSize","_interactive","_failIfMajorPerformanceCaveat","_preserveDrawingBuffer","_antialias","_trackResize","_crossSourceCollisions","_crossFadingFactor","_controls","_mapId","_locale","maxBounds","_setupContainer","_setupPainter","_onWindowOnline","_onWindowResize","fitBoundsOptions","_localIdeographFontFamily","addControl","logoPosition","repaint","_controlPositions","removeControl","hasControl","_containerDimensions","_resizeCanvas","setMinZoom","getMinZoom","setMaxZoom","getMaxZoom","setMinPitch","getMinPitch","setMaxPitch","getMaxPitch","getRenderWorldCopies","setRenderWorldCopies","_createDelegatedListener","listener","delegates","_delegatedListeners","_diffStyle","_updateStyle","_lazyInitEmptyStyle","_updateDiff","getStyle","areTilesLoaded","hasImage","loadImage","_canvasContainer","_detectMissingCSS","_missingCSSCanary","getPropertyValue","_contextLost","_contextRestored","_controlContainer","_onMapScroll","scrollTop","scrollLeft","_styleDirty","_sourcesDirty","_placementDirty","layerTimes","_repaint","_fullyLoaded","loseContext","_showTileBoundaries","_showPadding","_vertices","_setCacheLimits","showCompass","showZoom","visualizePitch","_zoomInButton","_createButton","_zoomOutButton","_compass","_compassIcon","_updateZoomButtons","_rotateCompassArrow","_setButtonTitle","mouseRotate","mousePitch","down","move","offTemp","_anchor","_color","_scale","_draggable","draggable","_isDragging","_rotation","_rotationAlignment","rotationAlignment","_pitchAlignment","pitchAlignment","_element","_defaultMarker","setAttributeNS","rx","ry","_popup","setDraggable","_onMapClick","_addDragHandler","_onUp","_onMove","getLngLat","_lngLat","setLngLat","_pos","setPopup","_onKeyPress","_originalTabIndex","removeAttribute","togglePopup","getPopup","isOpen","getOffset","setOffset","_pointerdownPos","_positionDelta","isDraggable","setRotationAlignment","getRotationAlignment","setPitchAlignment","getPitchAlignment","positionOptions","enableHighAccuracy","maximumAge","trackUserLocation","showAccuracyCircle","showUserLocation","_setupUI","permissions","geolocation","_geolocationWatchID","clearWatch","_userLocationDotMarker","_accuracyCircleMarker","_onZoom","_isOutOfMapMaxBounds","_setErrorState","_watchState","_geolocateButton","_onSuccess","_updateMarker","_finish","_lastKnownPosition","_updateCamera","_dotElement","accuracy","geolocateSource","_accuracy","_updateCircleRadius","_circleElement","_clearWatch","_timeoutId","_setup","watchPosition","getCurrentPosition","setUnit","_fullscreen","_fullscreenchange","_checkFullscreenSupport","_changeIcon","fullscreenEnabled","mozFullScreenEnabled","msFullscreenEnabled","webkitFullscreenEnabled","_fullscreenButton","_updateTitle","_onClickFullscreen","_getTitle","_isFullscreen","fullscreenElement","mozFullScreenElement","webkitFullscreenElement","msFullscreenElement","toggle","exitFullscreen","mozCancelFullScreen","msExitFullscreen","webkitCancelFullScreen","requestFullscreen","mozRequestFullScreen","msRequestFullscreen","webkitRequestFullscreen","closeButton","closeOnClick","focusAfterOpen","_onClose","closeOnMove","_focusFirstElement","_trackPointer","_onMouseMove","_onMouseUp","_onDrag","trackPointer","setText","setDOMContent","createTextNode","setHTML","createDocumentFragment","getMaxWidth","setMaxWidth","hasChildNodes","_createCloseButton","addClassName","removeClassName","toggleClassName","_closeButton","_tip","focus","NavigationControl","GeolocateControl","AttributionControl","ScaleControl","FullscreenControl","Popup","Marker","prewarm","clearPrewarmedResources","clearStorage","arrayLikeToArray","minLen","GreatCircleLayer","GeoCellLayer","indexToBounds","RADIAN_TO_DEGREE","IJToST","ij","singleSTtoUV","STToUV","FaceUVToXYZ","rotateAndFlipQuadrant","getS2QuadKey","paddedToken","padEnd","getIdFromToken","idS","FACE_BITS","lsbIndex","faceB","posB","levelN","faceS","posS","toHilbertQuadkey","getS2Polygon","nextOffset","stepI","stepJ","deltaLng","getGeoBounds","hilbertQuadkey","maxLevel","FromHilbertQuadKey","S2Layer","getS2Token","getQuadkeyPolygon","quadkey","quadkeyToWorldBounds","QuadkeyLayer","getQuadkey","Tile2DHeader","isSelected","_abortController","_loaderId","_isLoaded","_isCancelled","_needsReload","requestScheduler","loaderId","scheduleRequest","requestToken","tileData","INTERSECTION","scratchNormal","halfDiagonal","plane","distanceSquaredTo","fromCenterRadius","oppositeCorner","boundingSphere","leftCenter","leftRadius","rightCenter","rightRadius","toRightCenter","centerSeparation","halfDistanceBetweenTangentPoints","distanceToPlane","IDENTITY_MATRIX3","ZERO_MATRIX3","mat3","scratchVector3","scratchOffset","scratchVectorU","scratchVectorV","scratchVectorW","scratchCorner","scratchToCenter","MATRIX3","halfAxes","xAxis","getColumn","yAxis","zAxis","normXAxis","normYAxis","normZAxis","fromMatrix3","halfSize","quaternionObject","directionsMatrix","cornerVector","normalX","normalY","normalZ","radEffective","uHalf","vHalf","wHalf","minDist","maxDist","NEGATIVE_INFINITY","toCenter","transformation","fromNormalDistance","fromPointNormal","pointDistance","getPointDistance","scaledNormal","faces","scratchPlaneCenter","scratchPlaneNormal","planeIndex","faceNormal","plane0","plane1","plane0Center","plane1Center","negatedFaceNormal","boundingVolume","intersectPlane","parentPlaneMask","MASK_OUTSIDE","MASK_INSIDE","scratchMatrix","scratchUnitary","scratchDiagonal","jMatrix","jMatrixTranspose","computeEigenDecomposition","EIGEN_TOLERANCE","sweep","unitaryMatrix","diagonalMatrix","norm","computeFrobeniusNorm","offDiagonalFrobeniusNorm","shurDecomposition","unitary","toTarget","diagonal","rowVal","colVal","getElementIndex","maxDiagonal","rotAxis","tau","scratchVector4","scratchVector5","scratchVector6","scratchCovarianceResult","scratchEigenResult","REF_POINTS_5","REF_POINTS_9","REF_POINTS_11","OSMNode","_children","cullingVolume","elevationBounds","getBoundingVolume","insideBounds","computeVisibility","childVisible","selected","getSelected","zRange","refPointPositions","osmTile2lngLat","meanPoint","invLength","exx","exy","exz","eyy","eyz","ezz","covarianceMatrix","v3","u2","u3","l1","l2","l3","scaleMatrix","makeOrientedBoundingBoxFromPoints","originX","originY","AxisAlignedBoundingBox","DEFAULT_EXTENT","urlType","transformBox","transformedCoords","getURLFromTemplate","getCullBounds","bounds0","bounds1","tile2XY","tileToBoundingBox","getIdentityTileIndices","modelMatrixInverse","getIndexingCoords","getTileIndices","zoomOffset","transformedExtent","_GlobeViewport","Plane","CullingVolume","elevationMin","elevationMax","minLng","minLat","maxLng","traversalParams","getOSMTileIndices","STRATEGIES","allTiles","getPlaceholderInAncestors","getPlaceholderInChildren","t1","t2","Tileset2D","onTileLoad","maxCacheByteSize","_cacheByteSize","_resizeCache","_requestScheduler","_dirty","_viewport","_selectedTiles","_frameNumber","_modelMatrix","_modelMatrixInverse","needsReload","setNeedsReload","modelMatrixAsMatrix4","isModelMatrixNew","_zRange","_getTile","tileIndices","_rebuildTree","updateTileStates","_pruneRequests","refinementStrategy","visibilities","abortCandidates","ongoingRequestCount","_getNearestAncestor","maxCacheSize","selectedTiles","onTileUnload","getTileId","getTileMetadata","getTileZoom","getTileData","onTileError","getParentIndex","startTile","TilesetClass","renderSubLayers","onViewportLoad","TileLayer","tileset","_getTilesetOptions","reloadAll","_updateTileset","_onTileLoad","_onTileError","_onTileUnload","frameNumber","loadingStateChanged","tilesetChanged","_onViewportLoad","subLayerProps","getSubLayerPropsByTile","isTileVisible","TripsLayer","timestamps","instanceTimestamps","instanceNextTimestamps","fadeTrail","trailLength","getTimestamps","libh3","Module","moduleOverrides","readAsync","arguments_","scriptDirectory","currentScript","xhr","tryParseAsDataURI","tempRet0","getTempRet0","ABORT","getCFunc","ident","ccall","returnType","argTypes","toC","outPtr","maxBytesToWrite","outU8Array","outIdx","startIdx","endIdx","stringToUTF8Array","HEAPU8","stringToUTF8","stackAlloc","HEAP8","writeArrayToMemory","cArgs","stackSave","UTF8ToString","convertReturnValue","stackRestore","UTF8Decoder","maxBytesToRead","u8Array","idx","endPtr","u0","UTF8ArrayToString","HEAP16","HEAP32","HEAPF64","alignUp","multiple","updateGlobalBufferAndViews","INITIAL_TOTAL_MEMORY","callRuntimeCallbacks","DYNAMICTOP_PTR","__ATPRERUN__","__ATINIT__","__ATMAIN__","__ATPOSTRUN__","Math_abs","Math_ceil","Math_floor","Math_min","runDependencies","runDependencyWatcher","dependenciesFulfilled","tempDouble","tempI64","memoryInitializer","dataURIPrefix","isDataURI","demangle","demangleAll","jsStackTrace","_emscripten_get_heap_size","emscripten_realloc_buffer","newBuffer","_emscripten_replace_memory","decodeBase64","chr1","chr2","chr3","enc2","enc3","enc4","keyStr","decoded","intArrayFromBase64","calledRun","asm","imul","clz32","hd","Yc","Xc","Fb","bd","cd","Lb","Rb","dd","Nb","Pb","Mb","Sb","_b","Vb","Wb","jb","ed","_c","Vc","Jc","Ic","gb","lb","Fc","mb","ab","bb","cb","Gc","db","eb","fb","Hc","hb","sb","Ab","Bb","Cb","Eb","tc","Ob","Qb","Tb","Ub","$b","gc","Kc","Lc","hc","ic","Wc","kc","lc","mc","nc","uc","vc","wc","xc","Mc","Nc","Oc","Pc","Qc","Rc","Sc","Uc","jd","Tc","$c","ad","Zc","gd","___uremdi3","_bitshift64Lshr","_bitshift64Shl","_calloc","_cellAreaKm2","_cellAreaM2","_cellAreaRads2","_compact","_destroyLinkedPolygon","_edgeLengthKm","_edgeLengthM","_exactEdgeLengthKm","_exactEdgeLengthM","_exactEdgeLengthRads","_experimentalH3ToLocalIj","_experimentalLocalIjToH3","_geoToH3","_getDestinationH3IndexFromUnidirectionalEdge","_getH3IndexesFromUnidirectionalEdge","_getH3UnidirectionalEdge","_getH3UnidirectionalEdgeBoundary","_getH3UnidirectionalEdgesFromHexagon","_getOriginH3IndexFromUnidirectionalEdge","_getPentagonIndexes","_getRes0Indexes","_h3Distance","_h3GetBaseCell","_h3GetFaces","Yb","_h3GetResolution","_h3IndexesAreNeighbors","_h3IsPentagon","_h3IsResClassIII","_h3IsValid","_h3Line","_h3LineSize","_h3SetToLinkedGeo","_h3ToCenterChild","_h3ToChildren","_h3ToGeo","_h3ToGeoBoundary","_h3ToParent","_h3UnidirectionalEdgeIsValid","_hexAreaKm2","_hexAreaM2","_hexRing","_i64Subtract","_kRing","_kRingDistances","_llvm_minnum_f64","_llvm_round_f64","_maxFaceCount","_maxH3ToChildrenSize","_maxKringSize","_maxPolyfillSize","_maxUncompactSize","_memcpy","_memset","_numHexagons","_pentagonIndexCount","_pointDistKm","_pointDistM","_pointDistRads","_polyfill","_res0IndexCount","_sbrk","_sizeOfCoordIJ","_sizeOfGeoBoundary","_sizeOfGeoCoord","_sizeOfGeoPolygon","_sizeOfGeofence","_sizeOfH3Index","_sizeOfLinkedGeoPolygon","_uncompact","establishStackSpace","requestedSize","oldSize","numericArgs","noSafe","applyMemoryInitializer","clearInterval","removeRunDependency","doBrowserLoad","memoryInitializerBytes","useRequest","doRun","postRun","preRun","what","runCaller","NUMBER","H3","cwrap","SZ_H3INDEX","sizeOfH3Index","SZ_GEOCOORD","sizeOfGeoCoord","SZ_GEOBOUNDARY","sizeOfGeoBoundary","SZ_LINKED_GEOPOLYGON","sizeOfGeoPolygon","sizeOfGeofence","sizeOfLinkedGeoPolygon","UNITS","sizeOfCoordIJ","validateRes","INVALID_HEXIDECIMAL_CHAR","h3IndexToSplitLong","h3Index","upper","hexFrom32Bit","tempStr","zeroPad","splitLongToh3Index","lower","fullLen","numStr","numZeroes","outStr","readLong","invocation","readH3Index","storeH3Index","cAddress","HEAPU32","storeArrayOfHexagons","hexagons","readSingleCoord","readGeoCoord","readGeoCoordGeoJson","readGeoBoundary","geoBoundary","geoJsonCoords","closedLoop","vertsPos","readCoord","h3IsPentagon","h3ToGeo","latlng","h3ToGeoBoundary","formatAsGeoJson","h3SetToMultiPolygon","h3Indexes","originalPolygon","h3SetToLinkedGeo","multiPolygon","loops","SZ_DBL","SZ_PTR","readMultiPolygon","destroyLinkedPolygon","edgeLength","edgeLengthM","edgeLengthKm","degsToRads","deg","normalizeLongitudes","scalePolygon","hexId","actualCount","getHexagonCentroid","getHexagon","h3ToPolygon","centerHexagon","hexagon","H3HexagonLayer","_checkH3Lib","edgeLengthKM","_shouldUseHighPrecision","dataProps","_calculateH3DataProps","_updateVertices","hasPentagon","hasMultipleRes","hexResolution","h3IsValid","h3GetResolution","centerHex","hex","geoToH3","destination","oLower","oUpper","ref$1","dLower","dUpper","h3Distance","centerLat","centerLng","centerX","_renderColumnLayer","SubLayerClass","_getForwardProps","mergeTriggers","flattenPolygon","H3ClusterLayer","getHexagons","MeshLayer","featureIdsPickingColors","calculateFeatureIdsPickingColors","pbrMaterial","updatePbrMaterialUniforms","pickFeatureIds","HAS_UV_REGIONS","uvRegions","fromCartographic","cartographic","toCartographic","scaleToGeodeticSurfaceIntersection","scaleToGeodeticSurfaceGradient","scratchOrigin","VECTOR_PRODUCT_LOCAL_FRAME","degeneratePositionLocalFrame","scratchAxisVectors","localFrameToFixedFrame","ellipsoid","firstAxis","secondAxis","thirdAxis","cartesianOrigin","thirdAxisInferred","firstAxisVector","secondAxisVector","thirdAxisVector","fromArray","geodeticSurfaceNormal","scratchK","scratchHeight","scratchCartesian","radii","radiiSquared","radiiToTheFourth","oneOverRadii","oneOverRadiiSquared","minimumRadius","maximumRadius","squaredXOverSquaredZ","geodeticSurfaceNormalCartographic","cartesian","scaleToGeodeticSurface","_cartographicRadians","cartographicVectorRadians","fromCartographicToRadians","cosLatitude","centerToleranceSquared","positionX","positionY","positionZ","oneOverRadiiX","oneOverRadiiY","oneOverRadiiZ","squaredNorm","intersection","oneOverRadiiSquaredX","oneOverRadiiSquaredY","oneOverRadiiSquaredZ","xMultiplier","yMultiplier","zMultiplier","correction","xMultiplier2","yMultiplier2","zMultiplier2","beta","_length","nextNode","_insert","oldNodeNext","_list","_sentinel","_trimTiles","_cacheNode","addCallback","unloadCallback","trimTiles","maximumMemoryUsageInBytes","maximumMemoryUsage","sentinel","gpuMemoryUsageInBytes","getFrameState","cameraDirection","cameraUp","viewportCenterCartesian","worldToCartesian","enuToFixedTransform","WGS84","eastNorthUpToFixedFrame","cameraPositionCartographic","cameraPositionCartesian","cartographicToCartesian","cameraDirectionCartesian","cameraUpCartesian","frustumPlanes","nearCenterCommon","closestPointOnPlane","nearCenterCartesian","cameraCartesian","posCommon","cartesianPos","commonSpacePlanesToWGS84","ViewportClass","camera","topDownViewport","sseDenominator","refPoint","distanceToRef","cartographicPos","getZoomFromBoundingVolume","cartorgraphicCenter","obbSize","axeY","axeZ","farthestVertex","getObbSize","getZoomFromFullExtent","fullExtent","cartesianCenter","extentVertex","xmax","ymax","zmax","extentSize","TILE_CONTENT_STATE","TILE_REFINEMENT","TILE_TYPE","TILESET_TYPE","LOD_METRIC_TYPE","TILE3D_OPTIMIZATION_HINT","scratchScale","scratchNorthWest","scratchSouthEast","createBoundingVolume","boundingVolumeHeader","transformByQuaternion","createBox","region","minHeight","northWest","southEast","centerInCartesian","addVectors","subVectors","createSphere","sphere","uniformScale","getDynamicScreenSpaceError","distanceToCamera","dynamicScreenSpaceError","dynamicScreenSpaceErrorComputedDensity","density","dynamicScreenSpaceErrorFactor","fog","toEye","cameraPositionEnu","extraVertexEnu","projectedOriginVector","enuToCartesianMatrix","cartesianToEnuMatrix","getProjectedRadius","frameState","mbsLat","mbs","mbsLon","mbsZ","mbsR","mbsCenterCartesian","projection","extraZ","extraVectorCartesian","sphereMbsBorderVertexCartesian","sphereMbsBorderVertexCartographic","cartesianToCartographic","projectedOrigin","projectedMbsBorderVertex","_array","loadSiblings","skipLevelOfDetail","maximumScreenSpaceError","updateTransforms","onTraversalEnd","viewportTraversersMap","basePath","_traversalStack","_emptyTraversalStack","requestedTiles","emptyTiles","updateTile","executeTraversal","_selectionDepth","shouldRefine","canTraverse","updateChildTiles","updateAndPushChildren","hasRenderContent","parentRefines","_shouldRefine","stoppedRefining","refine","selectTile","touchTile","newTime","traversalFinished","lastUpdate","updateDebounceTime","compareDistanceToCamera","checkRefines","hasVisibleChild","refines","isVisibleAndInRequestVolume","childRefines","_inRequestVolume","contentAvailable","executeEmptyTraversal","updateTileVisibility","shouldSelectTile","_selectedFrame","shouldLoadTile","_requestedFrame","_priority","_getPriority","_touchedFrame","useParentMetric","ignoreVisibility","hasChildren","hasTilesetContent","contentExpired","hasUnloadedContent","screenSpaceError","_screenSpaceError","getScreenSpaceError","viewportIds","updateVisibility","_distanceToCamera","anyVisible","allDescendantsLoaded","parentHeader","extendedId","_getRefine","contentUrl","lodMetricType","lodMetricValue","contentState","hasEmptyContent","_visitedFrame","traverser","_centerZDepth","_visible","_stackLength","_initialTransform","_initializeLodMetric","_initializeTransforms","_initializeBoundingVolumes","_initializeContent","_initializeRenderingState","_lodJudge","_expireDate","_expiredContent","contentReady","contentFailed","contentUnloaded","useParentLodMetric","parentLodMetricValue","viewDistanceScale","getTiles3DScreenSpaceError","_traverser","maySkipTile","rootScreenSpaceError","getTileUrl","isTileset","_getLoaderSpecificOptions","contentLoader","_isTileset","_initializeTileHeaders","_onContentLoaded","parentVisibilityPlaneMask","_visibilityPlaneMask","MASK_INDETERMINATE","parentTransform","computedTransform","_updateTransform","distanceToTile","insideViewerRequestVolume","computeVisibilityWithPlaneMask","viewerRequestVolume","_viewerRequestVolume","extras","tileHeader","parentInitialTransform","_contentBoundingVolume","_updateBoundingVolume","_tileset","_tile","disableSkipLevelOfDetail","i3s","isTileHeader","assetGltfUpAxis","asset","gltfUpAxis","meetsScreenSpaceErrorEarly","useOptimization","_optimChildrenWithinParent","anyChildrenVisible","viewportId","viewportMap","frameNumberMap","oldCount","_this$frameNumberMap$","_statusMap","pendingTilesRegister","actualFrameNumber","deregister","newFrameNumber","newViewportId","_tileManager","hasPendingTiles","screenSize","getLodStatus","childTiles","childTile","nodePages","nodePagesTile","formTileFromNodePages","nodeId","nodeUrl","loadContent","maximumTilesSelected","debounceTime","onTraversalComplete","loadTiles","attributions","TILES_TOTAL","roots","cartographicCenter","traverseCounter","geometricError","_initializeTraverser","_emptyTiles","_requestedTiles","frameStateData","lastUpdatedVieports","_queryParams","_queryParamsString","_extensionsUsed","credits","tilesetInitializationPromise","_initializeTileSet","queryParams","queryParamStrings","getQueryParamString","tilePath","doUpdate","updatePromise","preparedViewports","viewportsToTraverse","_needTraverse","traverserId","currentFrameStateData","filteredSelectedTiles","unselectedTiles","tuples","viewportLongitude","viewportLatitude","deltaLon","deltaLat","tuplesSorted","limitSelectedTiles","unselect","_updateTiles","frameStateKey","frameStateDataValue","_loadTiles","_unloadTiles","_updateStats","oldSelectedTiles","set1","set2","unloadTiles","tilesRenderable","pointsRenderable","tilesetJson","calculateViewPropsI3S","_initializeTiles3DTileset","calculateViewPropsTiles3D","_initializeI3STileset","_this$tileset$store","xmin","ymin","zmin","getZoomFromExtent","parentTileHeader","rootTile","childHeader","TraverserClass","_onTraversalEnd","parentTile","_destroySubtree","_onStartTileLoading","_onTileLoadError","_onEndTileLoading","_this$tileset","_this$tileset$nodePag","nodesInNodePages","rtcCenter","rotationY","isQuantized","quantizedVolumeOffset","quantizedVolumeScale","cartesianModelMatrix","cartographicOrigin","toFixedFrameMatrix","cartographicModelMatrix","calculateTransformProps","_addTileToCache","_updateCacheStats","unloadContent","_destroyTile","tilesetVersion","extensionsUsed","TILE3D_TYPE","COMPOSITE","BATCHED_3D_MODEL","INSTANCED_3D_MODEL","GEOMETRY","VECTOR","GLTF","getStringFromArrayBuffer","GL_TYPE","GL_TYPE_TO_ARRAY_TYPE","NAME_TO_GL_TYPE","getArrayType","getByteSize","featureTableJson","featureTableBinary","propertyName","componentLength","_getTypedArrayFromBinary","fromName","featuresLength","_getTypedArrayFromArray","featureId","getPropertyArray","cachedTypedArrays","_cachedTypedArrays","createTypedArray","COMPONENTS_PER_ATTRIBUTE","UNPACKER","PACKER","initializeHierarchy","batchTable","jsonHeader","binaryBody","hierarchy","legacyHierarchy","HIERARCHY","hierarchyJson","classId","instancesLength","parentIndexes","classIds","parentCounts","parentIds","parentIdsLength","AttributeType","getBinaryAccessor","createArrayBufferView","classesLength","classInstancesLength","instances","binaryProperties","getBinaryProperties","combine","classCounts","classIndexes","validateInstance","validateHierarchy","initializeHierarchyValues","traverseHierarchy","instanceIndex","endConditionCallback","visited","scratchVisited","visitedMarker","scratchStack","parentCount","parentIndex","traverseHierarchyMultipleParents","traverseHierarchySingleParent","IGNORED_PROPERTY_FIELDS","featureCount","_this$json","_extensions","_binaryProperties","_initializeBinaryProperties","_hierarchy","batchId","_checkBatchId","getExactClassName","_hasPropertyInHierarchy","propertyNames","_getPropertyNamesInHierarchy","binaryProperty","_getBinaryProperty","propertyValues","hierarchyProperty","_getHierarchyProperty","_setBinaryProperty","_setHierarchyProperty","unpack","pack","_initializeBinaryProperty","tile3DAccessor","unpacker","packer","createTypedArrayFromAccessor","componentCount","instanceClass","indexInClass","parse3DTileHeaderSync","parse3DTileTablesHeaderSync","batchLength","featureTableJsonByteLength","featureTableBinaryByteLength","batchTableJsonByteLength","batchTableBinaryByteLength","parse3DTileTablesSync","BATCH_LENGTH","featureTableString","parse3DTileFeatureTable","batchTableString","batchTableJson","batchTableBinary","parse3DTileBatchTable","decodeRGB565","rgb565","r5","g6","normalize3DTileColorAttribute","batchIds","isRGB565","colorArray","getProperty","fromSNorm","rangeMaximum","signNotZero","octDecodeInRange","rangeMax","oldVX","octDecode","normalize3DTilePositionAttribute","decodeQuantizedPositions","scratchPosition","decodedArray","quantizedRange","parsePointCloud3DTile","isTranslucent","isOctEncoded16P","initializeTile","featureTable","pointsLength","getGlobalProperty","hasProperty","batchFeatureLength","parseBatchIds","parsePointCloudTables","dracoBuffer","dracoFeatureTableProperties","dracoBatchTableProperties","batchTableDraco","featureTableDraco","dracoByteOffset","dracoByteLength","hasPositions","hasColors","hasBatchIds","BATCH_ID","dracoData","featureTableProperties","batchTableProperties","dequantizeInShader","dracoOptions","decodedPositions","decodedColors","decodedNormals","decodedBatchIds","isQuantizedDraco","isOctEncodedDraco","minValues","quantizationBits","octEncodedRange","batchTableAttributes","loadDraco","parseDraco","parsePositions","constantRGBA","parseColors","normalize3DTileNormalAttribute","parseNormals","GLTF_FORMAT","parse3DTileGLTFViewSync","rotateYtoZ","gltfByteLength","gltfArrayBuffer","gltfByteOffset","extractGLTF","gltfFormat","tile3DOptions","gltfUrlBytes","gltfUrl","extractGLTFBufferOrURL","loadGLTF","parseBatchedModel3DTile","_tile$gltf","parseBatchedModel","CESIUM_RTC","parseInstancedModel3DTile","eastNorthUp","_batchTable","collectionOptions","instancePosition","instanceNormalRight","instanceNormalUp","instanceNormalForward","instanceRotation","instanceQuaternion","instanceScale","instanceTranslationRotationScale","instanceTransform","scratch1","scratch2","scratchVector1","scratchVector2","MAX_UNSIGNED_SHORT","normalUp","normalRight","hasCustomOrientation","octNormalUp","octNormalRight","getRotationMatrix3","setColumn","nonUniformScale","extractInstancedAttributes","parseInstancedModel","parse3DTile","tilesLength","subtile","parseComposite3DTile","parseGltf3DTile","getExplicitBitstream","subtree","internalBinaryBuffer","bufferViewIndex","bufferViews","parseUint64Value","Tile3DSubtreeLoader","jsonByteLength","stringAttribute","binaryByteLength","tileAvailability","explicitBitstream","contentAvailability","childSubtreeAvailability","SUBDIVISION_COUNT_MAP","QUADTREE","OCTREE","getAvailabilityResult","availabilityData","availabilityIndex","availabilityBuffer","byteIndex","bitIndex","getBooleanValueFromBitstream","formatTileData","childCoordinates","getRefine","getTileType","rootLodMetricValue","rootBoundingVolume","childTileX","childTileY","childTileZ","minimumHeight","maximumHeight","boundingVolumesCount","sizeX","sizeY","sizeZ","childWest","childEast","childSouth","childNorth","childMinimumHeight","childMaximumHeight","calculateBoundingVolumeForChildTile","concatBits","second","replaceContentUrlTemplate","templateUrl","mapUrl","items","generateMapUrl","matched","fileExtension","resolveUri","decodeURI","normalizeTileData","contentUri","transformMatrix","normalizeImplicitTileHeaders","implicitTilingExtension","subdivisionScheme","maximumLevel","subtreeLevels","subtrees","subtreesUriTemplate","rootSubtreeUrl","rootSubtree","contentUrlTemplate","parseImplicitTiles","parentData","mortonIndex","childIndex","childrenPerTile","childX","childY","childZ","levelOffset","childTileMortonIndex","tileAvailabilityIndex","isChildSubtreeAvailable","lev","childSubtreeUrl","childTileLevel","pData","currentTile","formattedTile","normalizeImplicitTileData","Tiles3DLoader","_tilesetJson$root","getBaseUri","_tilesetJson$extensio","_tilesetJson$extensio2","extensionsRequired","hasImplicitTilingExtension","normalizeTileHeaders","parseTileset","parseTile","SINGLE_DATA","getPointColor","onTilesetLoad","tileset3d","_getMeshColor","Tile3DLayer","layerMap","activeViewports","lastUpdatedViewports","_loadTileset","tileId","tilesetUrl","preload","preloadOptions","Tileset3D","viewportsNumber","selectTiles","_makePointCloudLayer","_make3DModelLayer","_makeSimpleMeshLayer","getMeshGeometry","layerCache","_getSubLayer","contentAttributes","TerrainLoader","terrain","tesselator","meshMaxError","elevationDecoder","rScaler","gScaler","bScaler","skirtHeight","DUMMY_DATA","elevationData","TerrainWorkerLoader","urlTemplateToUpdateTrigger","TerrainLayer","elevationDataChanged","isTiled","shouldReload","loadTerrain","dataUrl","textureUrl","surface","bound","getTiledTerrainData","flatGeojsonToBinary","geometryInfo","propArrayTypes","extractNumericPropTypes","numericPropKeys","pointPositionsCount","pointFeaturesCount","linePositionsCount","linePathsCount","lineFeaturesCount","polygonPositionsCount","polygonObjectsCount","polygonRingsCount","polygonFeaturesCount","coordLength","PositionDataType","hasGlobalId","GlobalFeatureIdsDataType","indexMap","pointPosition","pointFeature","linePosition","linePath","lineFeature","polygonPosition","polygonObject","polygonRing","polygonFeature","handlePoint","keepStringProperties","handleLineString","handlePolygon","wrapProps","makeAccessorObjects","fillArrays","deduceArrayType","nPositions","fillNumericProperties","nextIndices","triangulatePolygon","endPosition","returnObj","numericPropName","numericKeys","ring","readFeature","readTag","cmd","cmdLen","rings","ccw","classifyRings","_toGeoJSON","readLayer","readValueMessage","readTile","geom","ringAreas","before","after","_geometryInfo","_toBinaryCoordinates","parseMVT","_options$gis","_options$mvt","mvtOptions","_options$mvt2","wgs84Coordinates","tileIndex","hasTileIndex","gis","parseToBinary","parseToGeojson","flatGeoJsonFeatures","vectorTileLayer","decodedFeature","getDecodedFeatureBinary","parseToFlatGeoJson","getDecodedFeature","transformToLocalCoordinates","layerProperty","toBinaryCoordinates","transformToLocalCoordinatesBinary","MVTWorkerLoader","binaryToGeojson","globalFeatureId","dataArray","normalizeInput","currValue","parseFeature","getSingleFeature","parseFeatures","parseFeatureCollection","binaryToGeometry","ringToGeoJson","pointToGeoJson","ringCoordinates","lineStringToGeoJson","polygonToGeoJson","startRingIndex","endRingIndex","startPolygonIndex","endPolygonIndex","polygonCoordinates","unexpectedInput","parseType","parseProperties","parseFields","clipBounds","clipByInstance","shaderFunction","shaderModuleVs","injectionVs","shaderModuleFs","injectionFs","ClipExtension","clip_bounds","corner0","corner1","availableTransformations","multiPoint","getPoints","multiLineString","lineString","pointX","pointY","GEOM_TYPES","findIndexByType","geomData","uniqueIdProperty","startFeatureIndex","endFeatureIndex","layerRange","__layers","layerNames","getLayerRange","elem","__ids","getGlobalFeatureId","highlightedFeatureId","MVTLayer","tileJSON","_updateTileData","_setWGS84PropertyForTiles","tilejson","loadProps","worldScale","newHoveredFeatureId","newHoveredFeatureLayerName","hoveredFeatureId","hoveredFeatureLayerName","hoveredFeature","getFeatureUniqueId","getFeatureLayerName","isWGS84","transformTileCoordsToWGS84","getHighlightedObjectIndex","isHighlighted","isFeatureIdDefined","featureIdToHighlight","isMatchingId","isMatchingLayer","findIndexBinary","pickObjects","maxFeatures","_pickObjects","featureCache","renderedFeatures","_contentWGS84","projectedBbox","BASE32_CODES_DICT","getGeohashPolygon","geohash","isLon","maxLon","minLon","hashValue","bits","getGeohashBounds","GeohashLayer","getGeohash","fp64ify","hiPart","loPart","fp64ifyMatrix4","matrixFP64","CONST_UNIFORMS","fp64arithmetic","AGGREGATION_OPERATION","SUM","MEAN","sumReducer","accu","maxReducer","minReducer","getValueFunc","aggregation","wrapAccessor","pts","filtered","getMin","getSum","getMean","getMax","wrapGetValueFunc","DEFAULT_RUN_PARAMS","projectPoints","createBufferObjects","MAX_32_BIT_FLOAT","MIN_BLEND_EQUATION","MAX_BLEND_EQUATION","MAX_MIN_BLEND_EQUATION","EQUATION_MAP","DEFAULT_WEIGHT_PARAMS","needMin","needMax","combineMaxMin","DEFAULT_PARAMETERS","getFloatTexture","BUFFER_NAMES","ARRAY_BUFFER_MAP","maxData","minData","maxMinData","REQUIRED_FEATURES","GPUGridAggregator","weightAttributes","textures","meanTextures","framebuffers","maxMinFramebuffers","minFramebuffers","maxFramebuffers","equations","_hasGPUSupport","_setupModels","gridAggregationModel","allAggregationModel","meanTransform","deleteResources","aggregationParams","_normalizeAggregationParams","_runAggregation","weightId","arrayName","aggregationData","aggregationBuffer","bufferName","shaderOptions","modelDirty","weights","normalizeWeightParams","aggregationTexture","maxMinBuffer","maxMinTexture","minBuffer","minTexture","maxBuffer","maxTexture","_trackGPUResultBuffers","numCol","numRow","scaling","_renderToWeightsTexture","_renderToMaxMinTexture","minOrMaxFb","clearParams","uSampler","transformOptions","_sourceTextures","aggregationValues","_targetTexture","_targetTextureVarying","getMeanTransform","_updateModels","_setupFramebuffers","_renderAggregateData","_getAggregateData","framebufferSize","_getMinMaxTexture","getAggregationModel","getAllAggregationModel","_setupWeightAttributes","pixelIndex","cellCount","cellWeight","maxCellWieght","minCellWeight","countsData","numCells","cellWeights","cellCounts","sizeIndex","defaultColorRange","colorRangeToFlatArray","colorRange","flatArray","DEFAULT_MINCOLOR","DEFAULT_MAXCOLOR","COLOR_PROPS","cellSizePixels","cellMarginPixels","colorDomain","ScreenGridCellLayer","calculateInstancePositions","instanceCounts","_updateUniforms","minColor","maxColor","shouldUseMinMax","_shouldUseMinMax","cellScale","filterProps","filterKeys","filteredProps","AggregationLayer","updateShaders","updateOpts","compareAll","dimension","domain","scaleFunction","getQuantizeScale","domainRange","clampIdx","quantizeScale","getLinearScale","linearScale","getQuantileScale","sortedDomain","ascending","thresholds","bisectRight","thresholdsScale","fraction","domainLength","domainFraction","lowIndex","getOrdinalScale","domainMap","uniqueDomain","ordinalScale","notNullOrUndefined","getTruthyValues","getQuantileDomain","getOrdinalDomain","defaultGetValue","defaultGetPoints","defaultGetIndex","filterData","BinSorter","bins","aggregatedBins","getAggregatedBins","_updateMinMaxValues","binMap","getBinMap","hasFilter","binCount","binIndex","filteredPoints","counts","percentileRange","sortedBins","minValue","lowerIdx","upperIdx","idxRange","_percentileToIndex","indexEdge","_getScaleDomain","scaleType","toFinite","yMin","yMax","xMin","xMax","alignToCell","inValue","getGridOffset","convertToMeters","calculateGridLatLonOffset","getGridParams","worldOrigin","pointToDensityGridDataCPU","hashInfo","positionAttribute","numInstance","getPositionBoundingBox","posOffset","gridHash","lonIdx","latIdx","pointsToGridHashing","idxs","getGridLayerDataFromGridHash","GridAggregationLayer","layerData","gpuGridAggregator","cpuGridAggregator","updateAggregationState","aggregationDataDirty","aggregationWeightsDirty","gpuAggregation","aggregationDirty","_updateAggregation","_updateWeightBins","_uploadAggregationResults","dataBytes","weight","getModuleSettings","cellIndex","updateResults","getWeight","DIMENSIONS","ScreenGridLayer","getCellSize","subLayerData","positionAttributeName","aggregationResults","getAggregationData","cellSizeChanged","gpuAggregationChanged","positionsChanged","isAttributeChanged","isAggregationDirty","allocateResources","_updateAccessors","_resetResults","nop","dimensionSteps","defaultDimensions","pickingInfo","getBins","updateTrigger","getDomain","lowerPercentile","upperPercentile","getScaleFunc","onSet","nullValue","defaultGetCellSize","CPUAggregator","dimensionUpdaters","_getCellSize","_getAggregator","getAggregator","_addDimension","updateGetValueFuncs","reprojectNeeded","needsReProjectPoints","getAggregatedData","getDimensionChanges","normalizeResult","getSortedBins","needUpdateDimensionStep","setDimensionState","getDimensionUpdaters","scaleFunc","updater","getDimensionSortedBins","getDimensionValueDomain","getDimensionScale","attributeAccessor","getSubLayerDimensionAttribute","dimensionStep","updaters","needUpdate","_updateTriggers","fromProp","dimensionUpdater","_filterData","valueDomain","getValueDomainByScale","dimensionRange","dimensionDomain","getScaleFunctionByScaleType","getScaleFunction","cv","binInfo","dimensionKey","getColorValue","getColorWeight","colorAggregation","colorScaleType","onSetColorDomain","elevationDomain","elevationRange","getElevationValue","getElevationWeight","elevationAggregation","elevationLowerPercentile","elevationUpperPercentile","elevationScaleType","onSetElevationDomain","gridAggregator","CPUGridLayer","cpuAggregator","aggregatorState","_getSublayerUpdateTriggers","_onGetSublayerColor","_onGetSublayerElevation","thirdPi","angles","hexagonAggregator","getPointsCenter","radiusCommon","getRadiusInCommon","screenPoints","posIndex","screenCoord","hexbin","binsById","pj","py1","px1","pi2","pj2","px2","py2","centers","fragment","newHexbin","HexagonLayer","hexagonVertices","convertLatLngToMeterOffset","vertex0","vertex3","centroidFlat","vtFlat","OFFSET","NE","NW","SE","SW","SW_TRIANGLE","SE_TRIANGLE","NE_TRIANGLE","NW_TRIANGLE","SW_TRAPEZOID","SE_TRAPEZOID","NE_TRAPEZOID","NW_TRAPEZOID","S_RECTANGLE","E_RECTANGLE","N_RECTANGLE","W_RECTANGLE","EW_RECTANGEL","SN_RECTANGEL","SQUARE","SW_PENTAGON","SE_PENTAGON","NE_PENTAGON","NW_PENTAGON","NW_N_PENTAGON","NE_E_PENTAGON","SE_S_PENTAGON","SW_W_PENTAGON","NW_W_PENTAGON","NE_N_PENTAGON","SE_E_PENTAGON","SW_S_PENTAGON","S_HEXAGON","E_HEXAGON","N_HEXAGON","W_HEXAGON","SW_NE_HEXAGON","NW_SE_HEXAGON","NE_HEPTAGON","SW_HEPTAGON","NW_HEPTAGON","SE_HEPTAGON","OCTAGON","ISOLINES_CODE_OFFSET_MAP","7","8","14","15","ternaryToIndex","ternary","ISOBANDS_CODE_OFFSET_MAP","CONTOUR_TYPE","DEFAULT_THRESHOLD_DATA","zOffset","getVertexCode","getCode","thresholdValue","isLeftBoundary","isRightBoundary","isBottomBoundary","isTopBoundary","isBoundary","meanCode","getVertices","gridOrigin","thresholdData","vZ","rX","rY","refVertexX","refVertexY","polygonOffsets","xyOffset","vX","vY","xyOffsets","contours","ContourLayer","contourData","contoursChanged","_updateThresholdData","_generateContours","contourSegments","contourPolygons","LinesSubLayerClass","BandsSubLayerClass","contour","segmentIndex","generateContours","getCellData","GPUGridCellLayer","_setupUniformBuffer","colorMaxMinBuffer","elevationMaxMinBuffer","gridOriginLow","gridOffsetLow","domainUniforms","getDomainUniforms","bindUniformBuffers","unbindUniformBuffers","colorDomainValid","elevationDomainValid","programHandle","colorIndex","getUniformBlockIndex","elevationIndex","uniformBlockBinding","GPUGridLayer","elevation","getPositionForIndex","colorInfo","elevationInfo","colorValue","elevationValue","cpuAggregationData","getHashKeyForIndex","cellSizeMeters","attributesChanged","GridLayer","useGPUAggregation","canUseGPUAggregation","boundsContain","currentBounds","targetBounds","packVertices","scaleToAspectRatio","currentWidth","currentHeight","xCenter","yCenter","TriangleLayer","colorTexture","aggregationMode","TEXTURE_OPTIONS","DEFAULT_COLOR_DOMAIN","AGGREGATION_MODE","weightsTextureSize","debounceTimeout","FLOAT_TARGET_FEATURES","HeatmapLayer","_setupTextureParams","_setupAttributes","_setupResources","_updateHeatmapState","_getChangeFlags","boundsChanged","_updateBounds","_updateTextureRenderingBounds","updateTimer","isWeightMapDirty","viewportZoomChanged","_debouncedUpdateWeightmap","_updateColorTexture","_updateWeightmap","weightsTexture","triPositionBuffer","triTexCoordBuffer","maxWeightsTexture","weightsTransform","maxWeightTransform","textureSize","floatTargetSupport","getTextureParams","weightsScale","_fs","_createTextures","weightsTransformShaders","_createWeightsTransform","maxWeightsTransformShaders","inTexture","viewportCorners","visibleWorldBounds","newState","worldBounds","scaledCommonBounds","_worldToCommonBounds","_commonToWorldBounds","normalizedCommonBounds","textureBounds","commonBounds","useLayerCoordinateSystem","metersPerPixel","textureWidth","_updateMaxWeightValue","fromTimer","bottomLeftCommon","topRightCommon","minLong","maxLong","offsetOriginCommon","bottomLeftWorld","topRightWorld","INDEX_OFFSETS","bottomRadius","topRadius","nvertical","verticalAxis","topCap","bottomCap","extra","slant","msin","mcos","mpi","cosSlant","sinSlant","i3","i2","ringRadius","tesselateTruncatedCone","ICO_POSITIONS","ICO_INDICES","iterations","PI2","getMiddlePoint","pointMemo","i1","maxi","xm","ym","zm","indices2","in1","in2","in3","iu1","iu2","iu3","theta1","phi1","theta2","x3","y3","z3","theta3","phi3","vec1","newIndex","tesselateIcosaHedron","flipCull","c1len","c2len","subdivisions1","subdivisions2","numVertsAcross","unpackedAttributes","unpackedValue","unpackIndexedGeometry","tesselatePlane","nlat","nlong","longRange","n1","n2","n3","sinTheta","cosTheta","sinPhi","ux","uy","uz","numVertsAround","tesselateSphere","createDeckInstance","overlay","_googleMap","destroyDeckInstance","eventListeners","newDeck","interleaved","mockEvent","getEventPixel","handleMouseEvent","_eventListeners","getPanes","overlayLayer","getViewPropsFromCoordinateTransformer","transformer","getMapSize","getCameraParams","heading","tilt","pixelToLngLat","latLng","fromContainerPixelToLatLng","HIDE_ALL_LAYERS","GL_STATE","GoogleMapsOverlay","_overlay","UNINITIALIZED","RenderingType","getRenderingType","_createOverlay","_deck","parentStyle","pickObject","pickMultipleObjects","renderingType","WebGLOverlayView","OverlayView","_onContextRestored","onDraw","_onDrawVectorInterleaved","_onAdd","_onDrawVectorOverlay","_onDrawRaster","_onRemove","requestRedraw","getProjection","fromLatLngToDivPixel","centerH","LatLng","centerContainerPx","fromLatLngToContainerPixel","centerDivPx","leftOffset","topLngLat","bottomLngLat","Vector2","verticalAngle","getHeading","viewDiagonal","mapDiagonal","getViewPropsFromOverlay","isInitialized","dtypeToTypedArray","dtype","BigInt64Array","BigUint64Array","deserializeMatrix","_model_name","model_name","_model_module","model_module","_model_module_version","model_module_version","_view_name","view_name","_view_module","view_module","_view_module_version","view_module_version","custom_libraries","json_input","mapbox_key","selected_data","data_buffer","js_warning","DOMWidgetModel","serializers","setCallbacks","getPlaygroundProps","transportRootElement","getRootDOMElement","deckContainer","jsonProps","deckEvent","filterJsonValue","sendJSONMessage","sendEventViaTransport","propsWithBinary","processDataBuffer","deckBundle","CUBE_INDICES","CUBE_POSITIONS","CUBE_NORMALS","CUBE_TEX_COORDS","ATTRIBUTES","navigator_","chrome","mozInnerScreenX","TransformFeedback","_unbindBuffers","bufferOrParams","_getVaryingIndex","byteSize","_getBufferParams","_bindBuffer","primitiveMode","bindTransformFeedback","_bindBuffers","beginTransformFeedback","endTransformFeedback","getVaryingInfo","bufferIndex","createTransformFeedback","deleteTransformFeedback","channelHandles","animationHandles","lastEngineTime","rate","_setChannelTime","animationHandle","detachAnimation","animationData","channelHandle","offsetTime","matrix2x3","loadLibraryPromises","loadLibrary","libraryUrl","getLibraryUrl","scriptSource","loadLibraryFromString","loadLibraryFromFile","BASIS_CDN_ENCODER_WASM","BASIS_CDN_ENCODER_JS","loadBasisTranscoderPromise","loadBasisEncoderPromise","loadBasisTrascoderModule","basis","BASIS","BasisModule","BasisFile","initializeBasis","initializeBasisTrascoderModule","loadBasisTrascoder","loadBasisEncoderModule","basisEncoder","BASIS_ENCODER","BasisEncoderModule","KTX2File","BasisEncoder","initializeBasisEncoderModule","loadBasisEncoder","GL_EXTENSIONS_CONSTANTS","COMPRESSED_RGBA_ASTC_4X4_KHR","COMPRESSED_RGBA_ASTC_5X4_KHR","COMPRESSED_RGBA_ASTC_5X5_KHR","COMPRESSED_RGBA_ASTC_6X5_KHR","COMPRESSED_RGBA_ASTC_6X6_KHR","COMPRESSED_RGBA_ASTC_8X5_KHR","COMPRESSED_RGBA_ASTC_8X6_KHR","COMPRESSED_RGBA_ASTC_8X8_KHR","COMPRESSED_RGBA_ASTC_10X5_KHR","COMPRESSED_RGBA_ASTC_10X6_KHR","COMPRESSED_RGBA_ASTC_10X8_KHR","COMPRESSED_RGBA_ASTC_10X10_KHR","COMPRESSED_RGBA_ASTC_12X10_KHR","COMPRESSED_RGBA_ASTC_12X12_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_4X4_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_5X4_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_5X5_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_6X5_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_6X6_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_8X5_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_8X6_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_8X8_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_10X5_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_10X6_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_10X8_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_10X10_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_12X10_KHR","COMPRESSED_SRGB8_ALPHA8_ASTC_12X12_KHR","COMPRESSED_RED_RGTC1_EXT","COMPRESSED_SIGNED_RED_RGTC1_EXT","COMPRESSED_RED_GREEN_RGTC2_EXT","COMPRESSED_SIGNED_RED_GREEN_RGTC2_EXT","COMPRESSED_SRGB_S3TC_DXT1_EXT","COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT","COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT","COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT","BROWSER_PREFIXES","WEBGL_EXTENSIONS","WEBGL_compressed_texture_s3tc","WEBGL_compressed_texture_s3tc_srgb","WEBGL_compressed_texture_etc1","WEBGL_compressed_texture_etc","WEBGL_compressed_texture_pvrtc","WEBGL_compressed_texture_atc","WEBGL_compressed_texture_astc","EXT_texture_compression_rgtc","getSupportedGPUTextureFormats","getWebGLContext","gpuTextureFormat","KTX2_ID","OutputFormat","etc1","basisFormat","etc2","bc1","bc3","bc4","bc5","rgba32","bgr565","rgba4444","parseBasisFile","basisFile","startTranscoding","imageCount","getNumImages","imageIndex","levelsCount","getNumLevels","transcodeImage","getImageWidth","getImageHeight","hasAlpha","getHasAlpha","getBasisOptions","decodedSize","getImageTranscodedSizeInBytes","decodedData","parseKTX2File","ktx2File","getLevels","transcodeKTX2Image","alphaFlag","getImageLevelInfo","selectSupportedBasisFormat","noAlpha","supportedFormats","BasisWorkerLoader","containerFormat","BasisLoader","isKTX","fileConstructors","resolveUrl","baseUrl","getTypedArrayForBufferView","binChunk","TYPES","ARRAY_CONSTRUCTOR_TO_WEBGL_CONSTANT","ARRAY_TO_COMPONENT_TYPE","ATTRIBUTE_COMPONENT_TYPE_TO_BYTE_SIZE","getAccessorTypeFromSize","getComponentTypeFromArray","getAccessorArrayTypeAndLength","bytesPerComponent","DEFAULT_GLTF_JSON","isExtension","getUsedExtensions","getRequiredExtensions","getObject","getBufferView","registerUsedExtension","extensionData","addExtension","registerRequiredExtension","_removeStringFromArray","sceneIndex","nodeIndices","meshIndex","nodeData","glTFMesh","_addAttributes","indicesAccessor","_addIndices","meshes","mimeTypeOpt","glTFImage","addBufferView","glTFBufferView","glTFAccessor","minMax","_getAccessorMinMax","accessorDefaults","addAccessor","glTFTexture","pbrMaterialInfo","materials","_this$json$buffers","totalByteLength","dstByteOffset","attributeKey","attributeData","_getGltfAttributeName","addBinaryBuffer","initValues","componentIndex","detector","wasmpack","FILTERS","OCTAHEDRAL","QUATERNION","EXPONENTIAL","DECODERS","wasmPromise","loadWasmInstance","wasm","__wasm_call_ctors","loadWasmModule","sbrk","count4","heap","memory","gltfData","_options$gltf","decompressMeshes","promises","decodeMeshoptBufferView","removeExtension","meshoptExtension","getObjectExtension","meshoptDecodeGltfBuffer","NODE_FORMAT_SUPPORT","mimeTypeSupported","_isImageFormatSupported","checkWebPSupport","_parseImageNode","checkFormatSupport","preprocess","removeObjectExtension","getGLTFAccessor","convertTypedArrays","toTypedArray","getAccessorData","primitive","makeMeshPrimitiveIterator","decompressPrimitive","compressMesh","addRequiredExtension","dracoExtension","bufferCopy","decodedAttributes","getGLTFAccessors","decodedAttribute","accessorIndex","checkPrimitive","_context$parseSync","DracoWriter","compressedData","fauxAccessors","_addFauxAttributes","gltfScenegraph","nodeExtension","addObjectExtension","KHR_materials_unlit","techniques","techniquesExtension","programs","technique","resolveTechniques","materialExtension","resolveValues","useExtension","excludes","excludeExtensions","GLTF_ARRAYS","skins","GLTF_KEYS","skin","_addAsset","_convertTopLevelObjectsToArrays","_convertObjectIdsToArrayIndices","_updateObjects","_updateMaterial","_convertTopLevelObjectToArray","mapName","objectMap","idToIndexMap","_convertIdsToIndices","_convertIdToIndex","_convertTextureIds","_convertMeshIds","_convertNodeIds","_convertSceneIds","topLevelArrayName","_material$values","_material$values2","_material$values3","textureId","texture2d_0","diffuseTex","textureIndex","COMPONENTS","BYTES","GL_SAMPLER","SAMPLER_PARAMETER_GLTF_TO_GL","magFilter","minFilter","wrapS","wrapT","DEFAULT_SAMPLER","_resolveTree","bufView","_resolveBufferView","_resolveImage","_resolveSampler","_resolveTexture","_resolveAccessor","_resolveMaterial","_resolveMesh","_resolveNode","_resolveSkin","_resolveScene","getNode","getMesh","accum","getCamera","getSkin","inverseBindMatrices","getMaterial","occlustionTexture","emmisiveTexture","cutBuffer","_getValueFromInterleavedBuffer","getSampler","_enumSamplerParameter","preloadedImage","MAGIC_glTF","isGLB","magic1","parseGLBSync","glb","hasBinChunk","binChunks","GLB_FILE_HEADER_SIZE","contentFormat","parseJSONChunk","parseBINChunk","parseGLBV1","chunkFormat","strict","parseGLBChunksSync","parseGLBV2","jsonChunk","jsonText","parseGLTF","_options$gltf2","_options$gltf3","_options$gltf4","_glb","parseGLTFContainerSync","normalizeGLTFV1","_extension$preprocess","preprocessExtensions","loadBuffers","_context$fetch","_response$arrayBuffer","loadImages","imageIndices","getReferencesImageIndices","_extension$decode","decodeExtensions","postProcess","postProcessGLTF","parsedImage","fetchImages","createImages","decompress","IMAGE_SUPPORTED","IMAGE_BITMAP_SUPPORTED","NODE_IMAGE_SUPPORTED","DATA_SUPPORTED","getImageType","getImageTypeOrNull","SVG_DATA_URL_PATTERN","SVG_URL_PATTERN","isSVG","getBlob","parseToImage","blobOrDataUrl","xmlText","unescape","getBlobOrSVGDataUrl","webkitURL","objectUrl","loadToImage","EMPTY_OBJECT","imagebitmapOptionsSupported","parseToImageBitmap","imagebitmapOptions","isEmptyObject","safeCreateImageBitmap","imageType","getDefaultImageType","isImageTypeSupported","getLoadableImageType","parseToNodeImage","UNIFORM_SETTERS","getArraySetter","toFloatArray","setVectorUniform","toIntArray","setMatrixUniform","getSamplerSetter","toUIntArray","FLOAT_ARRAY","INT_ARRAY","UINT_ARRAY","uniformLength","getUniformSetter","parseUniformName","checkUniformValue","checkLength","checkUniformArray","copyUniform","uniformSetter","cacheLength","defaultName","SHADER_NAME_REGEXP","parseGLSLCompilerError","errLog","shaderType","shaderName","errorStrings","warnings","shaderDescription","getShaderTypeName","errorString","maxDigits","lineNumber","padLeft","addLineNumbers","formatErrors","getTypeName","_compile","getShaderSource","getTranslatedShaderSource","infoLog","getShaderInfoLog","VertexShader","FragmentShader","attributeInfosByName","attributeInfosByLocation","varyingInfosByName","_readAttributesFromProgram","_readVaryingsFromProgram","varying","getActiveAttrib","getAttribLocation","_addAttribute","getTransformFeedbackVarying","_addVarying","compositeType","_inferProperties","GL_SEPARATE_ATTRIBS","V6_DEPRECATED_METHODS","_isCached","_setId","_textureUniforms","transformFeedbackVaryings","_compileAndLink","_readUniformLocationsFromLinkedProgram","_areTexturesRenderable","bindForDraw","_bindTextures","drawRangeElements","drawArrays","uniformMap","checkUniformValues","textureUpdate","_textureIndexCounter","texturesRenderable","deleteProgram","shaderHandles","getAttachedShaders","shaderHandle","programName","_getName","getName","getProgramInfoLog","validateProgram","_uniformCount","getActiveUniform","uniformIndices","getActiveUniforms","blockName","blockIndex","getActiveUniformBlockParameter","blockBinding","FS100","FS_GLES","FS300","getQualifierDetails","qualifiers","words","definition","getPassthroughFS","outputValue","convertToVec4","variable","currentIndex","feedbackMap","_setupTransformFeedback","_getNextIndex","_setupBuffers","varyingName","sourceName","feedbackName","bufferOrRef","_createNewBuffer","_getFeedbackBuffers","_updateBindings","_updateBinding","_swapBuffers","srcName","dstName","getShaderVersion","updateForTextures","sourceTextureMap","targetTextureVarying","targetTexture","sourceCount","targetTextureType","samplerTextureMap","updatedVs","finalInject","vsLines","updateVsLines","textureMap","getAttributeDefinition","updatedLine","samplerName","sizeName","uniformDeclerations","textureName","getSamplerDeclerations","typeToChannelSuffix","sampleInstruction","processAttributeDefinition","qualaiferDetails","getVaryingType","SRC_TEX_PARAMETER_OVERRIDES","_swapTexture","updatedModelProps","_processVertexShader","sourceTextures","hasSourceTextures","hasTargetTexture","transform_elementID","elementIDBuffer","_setSourceTextureParameters","sizeUniforms","getSizeUniforms","_setupTextures","packed","typeToChannelCount","packedPixels","packCount","ownTexture","textureOrReference","_targetRefTexName","_createNewTexture","_createTargetTexture","_updateElementIDBuffer","elementIds","_swapTextures","combinedInject","bufferTransform","textureTransform","updatedOpts","_updateDrawOptions","swapped","resourceTransforms","resourceTransform","_buildResourceTransforms","_updateModelProps","setupResources","updatedProps","updateModelProps","canCreateBufferTransform","canCreateTextureTransform","getDrawOptions","setAxisAngle","bw","omega","cosom","sinom","scale0","scale1","fromMat3","fRoot","fTrace","tmpvec3","xUnitVec3","yUnitVec3","temp1","temp2","matr","rotationTo","IDENTITY_QUATERNION","fromAxisRotation","vectorA","vectorB","invDot","arg0"],"mappings":"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","file":"index.js","sourcesContent":["(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory(require(\"@jupyter-widgets/base\"));\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([\"@jupyter-widgets/base\"], factory);\n\telse {\n\t\tvar a = typeof exports === 'object' ? factory(require(\"@jupyter-widgets/base\")) : factory(root[\"@jupyter-widgets/base\"]);\n\t\tfor(var i in a) (typeof exports === 'object' ? exports : root)[i] = a[i];\n\t}\n})(window, function(__WEBPACK_EXTERNAL_MODULE__141__) {\nreturn "," \t// The module cache\n \tvar installedModules = {};\n\n \t// The require function\n \tfunction __webpack_require__(moduleId) {\n\n \t\t// Check if module is in cache\n \t\tif(installedModules[moduleId]) {\n \t\t\treturn installedModules[moduleId].exports;\n \t\t}\n \t\t// Create a new module (and put it into the cache)\n \t\tvar module = installedModules[moduleId] = {\n \t\t\ti: moduleId,\n \t\t\tl: false,\n \t\t\texports: {}\n \t\t};\n\n \t\t// Execute the module function\n \t\tmodules[moduleId].call(module.exports, module, module.exports, __webpack_require__);\n\n \t\t// Flag the module as loaded\n \t\tmodule.l = true;\n\n \t\t// Return the exports of the module\n \t\treturn module.exports;\n \t}\n\n\n \t// expose the modules object (__webpack_modules__)\n \t__webpack_require__.m = modules;\n\n \t// expose the module cache\n \t__webpack_require__.c = installedModules;\n\n \t// define getter function for harmony exports\n \t__webpack_require__.d = function(exports, name, getter) {\n \t\tif(!__webpack_require__.o(exports, name)) {\n \t\t\tObject.defineProperty(exports, name, { enumerable: true, get: getter });\n \t\t}\n \t};\n\n \t// define __esModule on exports\n \t__webpack_require__.r = function(exports) {\n \t\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n \t\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n \t\t}\n \t\tObject.defineProperty(exports, '__esModule', { value: true });\n \t};\n\n \t// create a fake namespace object\n \t// mode & 1: value is a module id, require it\n \t// mode & 2: merge all properties of value into the ns\n \t// mode & 4: return value when already ns object\n \t// mode & 8|1: behave like require\n \t__webpack_require__.t = function(value, mode) {\n \t\tif(mode & 1) value = __webpack_require__(value);\n \t\tif(mode & 8) return value;\n \t\tif((mode & 4) && typeof value === 'object' && value && value.__esModule) return value;\n \t\tvar ns = Object.create(null);\n \t\t__webpack_require__.r(ns);\n \t\tObject.defineProperty(ns, 'default', { enumerable: true, value: value });\n \t\tif(mode & 2 && typeof value != 'string') for(var key in value) __webpack_require__.d(ns, key, function(key) { return value[key]; }.bind(null, key));\n \t\treturn ns;\n \t};\n\n \t// getDefaultExport function for compatibility with non-harmony modules\n \t__webpack_require__.n = function(module) {\n \t\tvar getter = module && module.__esModule ?\n \t\t\tfunction getDefault() { return module['default']; } :\n \t\t\tfunction getModuleExports() { return module; };\n \t\t__webpack_require__.d(getter, 'a', getter);\n \t\treturn getter;\n \t};\n\n \t// Object.prototype.hasOwnProperty.call\n \t__webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); };\n\n \t// __webpack_public_path__\n \t__webpack_require__.p = \"\";\n\n\n \t// Load entry module and return exports\n \treturn __webpack_require__(__webpack_require__.s = 260);\n","function _defineProperty(obj, key, value) {\n  if (key in obj) {\n    Object.defineProperty(obj, key, {\n      value: value,\n      enumerable: true,\n      configurable: true,\n      writable: true\n    });\n  } else {\n    obj[key] = value;\n  }\n\n  return obj;\n}\n\nmodule.exports = _defineProperty;","function _getPrototypeOf(o) {\n  module.exports = _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) {\n    return o.__proto__ || Object.getPrototypeOf(o);\n  };\n  return _getPrototypeOf(o);\n}\n\nmodule.exports = _getPrototypeOf;","export default function _defineProperty(obj, key, value) {\n  if (key in obj) {\n    Object.defineProperty(obj, key, {\n      value: value,\n      enumerable: true,\n      configurable: true,\n      writable: true\n    });\n  } else {\n    obj[key] = value;\n  }\n\n  return obj;\n}","function _classCallCheck(instance, Constructor) {\n  if (!(instance instanceof Constructor)) {\n    throw new TypeError(\"Cannot call a class as a function\");\n  }\n}\n\nmodule.exports = _classCallCheck;","function _defineProperties(target, props) {\n  for (var i = 0; i < props.length; i++) {\n    var descriptor = props[i];\n    descriptor.enumerable = descriptor.enumerable || false;\n    descriptor.configurable = true;\n    if (\"value\" in descriptor) descriptor.writable = true;\n    Object.defineProperty(target, descriptor.key, descriptor);\n  }\n}\n\nfunction _createClass(Constructor, protoProps, staticProps) {\n  if (protoProps) _defineProperties(Constructor.prototype, protoProps);\n  if (staticProps) _defineProperties(Constructor, staticProps);\n  return Constructor;\n}\n\nmodule.exports = _createClass;","var setPrototypeOf = require(\"./setPrototypeOf\");\n\nfunction _inherits(subClass, superClass) {\n  if (typeof superClass !== \"function\" && superClass !== null) {\n    throw new TypeError(\"Super expression must either be null or a function\");\n  }\n\n  subClass.prototype = Object.create(superClass && superClass.prototype, {\n    constructor: {\n      value: subClass,\n      writable: true,\n      configurable: true\n    }\n  });\n  if (superClass) setPrototypeOf(subClass, superClass);\n}\n\nmodule.exports = _inherits;","var _typeof = require(\"../helpers/typeof\");\n\nvar assertThisInitialized = require(\"./assertThisInitialized\");\n\nfunction _possibleConstructorReturn(self, call) {\n  if (call && (_typeof(call) === \"object\" || typeof call === \"function\")) {\n    return call;\n  }\n\n  return assertThisInitialized(self);\n}\n\nmodule.exports = _possibleConstructorReturn;","import { Log } from '@probe.gl/log';\nexport const log = new Log({\n  id: 'luma.gl'\n});\n//# sourceMappingURL=log.js.map","export function assert(condition, message) {\n  if (!condition) {\n    throw new Error(message || 'luma.gl: assertion failed.');\n  }\n}\n//# sourceMappingURL=assert.js.map","import { assert } from './assert';\nconst ERR_CONTEXT = 'Invalid WebGLRenderingContext';\nexport const ERR_WEBGL = ERR_CONTEXT;\nexport const ERR_WEBGL2 = 'Requires WebGL2';\nexport function isWebGL(gl) {\n  if (typeof WebGLRenderingContext !== 'undefined' && gl instanceof WebGLRenderingContext) {\n    return true;\n  }\n\n  if (typeof WebGL2RenderingContext !== 'undefined' && gl instanceof WebGL2RenderingContext) {\n    return true;\n  }\n\n  return Boolean(gl && Number.isFinite(gl._version));\n}\nexport function isWebGL2(gl) {\n  if (typeof WebGL2RenderingContext !== 'undefined' && gl instanceof WebGL2RenderingContext) {\n    return true;\n  }\n\n  return Boolean(gl && gl._version === 2);\n}\nexport function getWebGL2Context(gl) {\n  return isWebGL2(gl) ? gl : null;\n}\nexport function assertWebGLContext(gl) {\n  assert(isWebGL(gl), ERR_CONTEXT);\n  return gl;\n}\nexport function assertWebGL2Context(gl) {\n  assert(isWebGL2(gl), ERR_WEBGL2);\n  return gl;\n}\n//# sourceMappingURL=webgl-checks.js.map","const glErrorShadow = {};\n\nfunction error(msg) {\n  if (globalThis.console && globalThis.console.error) {\n    globalThis.console.error(msg);\n  }\n}\n\nfunction log(msg) {\n  if (globalThis.console && globalThis.console.log) {\n    globalThis.console.log(msg);\n  }\n}\n\nfunction synthesizeGLError(err, opt_msg) {\n  glErrorShadow[err] = true;\n\n  if (opt_msg !== undefined) {\n    error(opt_msg);\n  }\n}\n\nfunction wrapGLError(gl) {\n  const f = gl.getError;\n\n  gl.getError = function getError() {\n    let err;\n\n    do {\n      err = f.apply(gl);\n\n      if (err !== 0) {\n        glErrorShadow[err] = true;\n      }\n    } while (err !== 0);\n\n    for (err in glErrorShadow) {\n      if (glErrorShadow[err]) {\n        delete glErrorShadow[err];\n        return parseInt(err, 10);\n      }\n    }\n\n    return 0;\n  };\n}\n\nconst WebGLVertexArrayObjectOES = function WebGLVertexArrayObjectOES(ext) {\n  const gl = ext.gl;\n  this.ext = ext;\n  this.isAlive = true;\n  this.hasBeenBound = false;\n  this.elementArrayBuffer = null;\n  this.attribs = new Array(ext.maxVertexAttribs);\n\n  for (let n = 0; n < this.attribs.length; n++) {\n    const attrib = new WebGLVertexArrayObjectOES.VertexAttrib(gl);\n    this.attribs[n] = attrib;\n  }\n\n  this.maxAttrib = 0;\n};\n\nWebGLVertexArrayObjectOES.VertexAttrib = function VertexAttrib(gl) {\n  this.enabled = false;\n  this.buffer = null;\n  this.size = 4;\n  this.type = 5126;\n  this.normalized = false;\n  this.stride = 16;\n  this.offset = 0;\n  this.cached = '';\n  this.recache();\n};\n\nWebGLVertexArrayObjectOES.VertexAttrib.prototype.recache = function recache() {\n  this.cached = [this.size, this.type, this.normalized, this.stride, this.offset].join(':');\n};\n\nconst OESVertexArrayObject = function OESVertexArrayObject(gl) {\n  const self = this;\n  this.gl = gl;\n  wrapGLError(gl);\n  const original = this.original = {\n    getParameter: gl.getParameter,\n    enableVertexAttribArray: gl.enableVertexAttribArray,\n    disableVertexAttribArray: gl.disableVertexAttribArray,\n    bindBuffer: gl.bindBuffer,\n    getVertexAttrib: gl.getVertexAttrib,\n    vertexAttribPointer: gl.vertexAttribPointer\n  };\n\n  gl.getParameter = function getParameter(pname) {\n    if (pname === self.VERTEX_ARRAY_BINDING_OES) {\n      if (self.currentVertexArrayObject === self.defaultVertexArrayObject) {\n        return null;\n      }\n\n      return self.currentVertexArrayObject;\n    }\n\n    return original.getParameter.apply(this, arguments);\n  };\n\n  gl.enableVertexAttribArray = function enableVertexAttribArray(index) {\n    const vao = self.currentVertexArrayObject;\n    vao.maxAttrib = Math.max(vao.maxAttrib, index);\n    const attrib = vao.attribs[index];\n    attrib.enabled = true;\n    return original.enableVertexAttribArray.apply(this, arguments);\n  };\n\n  gl.disableVertexAttribArray = function disableVertexAttribArray(index) {\n    const vao = self.currentVertexArrayObject;\n    vao.maxAttrib = Math.max(vao.maxAttrib, index);\n    const attrib = vao.attribs[index];\n    attrib.enabled = false;\n    return original.disableVertexAttribArray.apply(this, arguments);\n  };\n\n  gl.bindBuffer = function bindBuffer(target, buffer) {\n    switch (target) {\n      case 34962:\n        self.currentArrayBuffer = buffer;\n        break;\n\n      case 34963:\n        self.currentVertexArrayObject.elementArrayBuffer = buffer;\n        break;\n\n      default:\n    }\n\n    return original.bindBuffer.apply(this, arguments);\n  };\n\n  gl.getVertexAttrib = function getVertexAttrib(index, pname) {\n    const vao = self.currentVertexArrayObject;\n    const attrib = vao.attribs[index];\n\n    switch (pname) {\n      case 34975:\n        return attrib.buffer;\n\n      case 34338:\n        return attrib.enabled;\n\n      case 34339:\n        return attrib.size;\n\n      case 34340:\n        return attrib.stride;\n\n      case 34341:\n        return attrib.type;\n\n      case 34922:\n        return attrib.normalized;\n\n      default:\n        return original.getVertexAttrib.apply(this, arguments);\n    }\n  };\n\n  gl.vertexAttribPointer = function vertexAttribPointer(indx, size, type, normalized, stride, offset) {\n    const vao = self.currentVertexArrayObject;\n    vao.maxAttrib = Math.max(vao.maxAttrib, indx);\n    const attrib = vao.attribs[indx];\n    attrib.buffer = self.currentArrayBuffer;\n    attrib.size = size;\n    attrib.type = type;\n    attrib.normalized = normalized;\n    attrib.stride = stride;\n    attrib.offset = offset;\n    attrib.recache();\n    return original.vertexAttribPointer.apply(this, arguments);\n  };\n\n  if (gl.instrumentExtension) {\n    gl.instrumentExtension(this, 'OES_vertex_array_object');\n  }\n\n  if (gl.canvas) {\n    gl.canvas.addEventListener('webglcontextrestored', () => {\n      log('OESVertexArrayObject emulation library context restored');\n      self.reset_();\n    }, true);\n  }\n\n  this.reset_();\n};\n\nOESVertexArrayObject.prototype.VERTEX_ARRAY_BINDING_OES = 0x85b5;\n\nOESVertexArrayObject.prototype.reset_ = function reset_() {\n  const contextWasLost = this.vertexArrayObjects !== undefined;\n\n  if (contextWasLost) {\n    for (let ii = 0; ii < this.vertexArrayObjects.length; ++ii) {\n      this.vertexArrayObjects.isAlive = false;\n    }\n  }\n\n  const gl = this.gl;\n  this.maxVertexAttribs = gl.getParameter(34921);\n  this.defaultVertexArrayObject = new WebGLVertexArrayObjectOES(this);\n  this.currentVertexArrayObject = null;\n  this.currentArrayBuffer = null;\n  this.vertexArrayObjects = [this.defaultVertexArrayObject];\n  this.bindVertexArrayOES(null);\n};\n\nOESVertexArrayObject.prototype.createVertexArrayOES = function createVertexArrayOES() {\n  const arrayObject = new WebGLVertexArrayObjectOES(this);\n  this.vertexArrayObjects.push(arrayObject);\n  return arrayObject;\n};\n\nOESVertexArrayObject.prototype.deleteVertexArrayOES = function deleteVertexArrayOES(arrayObject) {\n  arrayObject.isAlive = false;\n  this.vertexArrayObjects.splice(this.vertexArrayObjects.indexOf(arrayObject), 1);\n\n  if (this.currentVertexArrayObject === arrayObject) {\n    this.bindVertexArrayOES(null);\n  }\n};\n\nOESVertexArrayObject.prototype.isVertexArrayOES = function isVertexArrayOES(arrayObject) {\n  if (arrayObject && arrayObject instanceof WebGLVertexArrayObjectOES) {\n    if (arrayObject.hasBeenBound && arrayObject.ext === this) {\n      return true;\n    }\n  }\n\n  return false;\n};\n\nOESVertexArrayObject.prototype.bindVertexArrayOES = function bindVertexArrayOES(arrayObject) {\n  const gl = this.gl;\n\n  if (arrayObject && !arrayObject.isAlive) {\n    synthesizeGLError(1282, 'bindVertexArrayOES: attempt to bind deleted arrayObject');\n    return;\n  }\n\n  const original = this.original;\n  const oldVAO = this.currentVertexArrayObject;\n  this.currentVertexArrayObject = arrayObject || this.defaultVertexArrayObject;\n  this.currentVertexArrayObject.hasBeenBound = true;\n  const newVAO = this.currentVertexArrayObject;\n\n  if (oldVAO === newVAO) {\n    return;\n  }\n\n  if (!oldVAO || newVAO.elementArrayBuffer !== oldVAO.elementArrayBuffer) {\n    original.bindBuffer.call(gl, 34963, newVAO.elementArrayBuffer);\n  }\n\n  let currentBinding = this.currentArrayBuffer;\n  const maxAttrib = Math.max(oldVAO ? oldVAO.maxAttrib : 0, newVAO.maxAttrib);\n\n  for (let n = 0; n <= maxAttrib; n++) {\n    const attrib = newVAO.attribs[n];\n    const oldAttrib = oldVAO ? oldVAO.attribs[n] : null;\n\n    if (!oldVAO || attrib.enabled !== oldAttrib.enabled) {\n      if (attrib.enabled) {\n        original.enableVertexAttribArray.call(gl, n);\n      } else {\n        original.disableVertexAttribArray.call(gl, n);\n      }\n    }\n\n    if (attrib.enabled) {\n      let bufferChanged = false;\n\n      if (!oldVAO || attrib.buffer !== oldAttrib.buffer) {\n        if (currentBinding !== attrib.buffer) {\n          original.bindBuffer.call(gl, 34962, attrib.buffer);\n          currentBinding = attrib.buffer;\n        }\n\n        bufferChanged = true;\n      }\n\n      if (bufferChanged || attrib.cached !== oldAttrib.cached) {\n        original.vertexAttribPointer.call(gl, n, attrib.size, attrib.type, attrib.normalized, attrib.stride, attrib.offset);\n      }\n    }\n  }\n\n  if (this.currentArrayBuffer !== currentBinding) {\n    original.bindBuffer.call(gl, 34962, this.currentArrayBuffer);\n  }\n};\n\nexport function polyfillVertexArrayObject(gl) {\n  if (typeof gl.createVertexArray === 'function') {\n    return;\n  }\n\n  const original_getSupportedExtensions = gl.getSupportedExtensions;\n\n  gl.getSupportedExtensions = function getSupportedExtensions() {\n    const list = original_getSupportedExtensions.call(this) || [];\n\n    if (list.indexOf('OES_vertex_array_object') < 0) {\n      list.push('OES_vertex_array_object');\n    }\n\n    return list;\n  };\n\n  const original_getExtension = gl.getExtension;\n\n  gl.getExtension = function getExtension(name) {\n    const ext = original_getExtension.call(this, name);\n\n    if (ext) {\n      return ext;\n    }\n\n    if (name !== 'OES_vertex_array_object') {\n      return null;\n    }\n\n    if (!gl.__OESVertexArrayObject) {\n      this.__OESVertexArrayObject = new OESVertexArrayObject(this);\n    }\n\n    return this.__OESVertexArrayObject;\n  };\n}\n//# sourceMappingURL=polyfill-vertex-array-object.js.map","import { isWebGL2 } from '../utils/webgl-checks';\nconst OES_element_index = 'OES_element_index';\nconst WEBGL_draw_buffers = 'WEBGL_draw_buffers';\nconst EXT_disjoint_timer_query = 'EXT_disjoint_timer_query';\nconst EXT_disjoint_timer_query_webgl2 = 'EXT_disjoint_timer_query_webgl2';\nconst EXT_texture_filter_anisotropic = 'EXT_texture_filter_anisotropic';\nconst WEBGL_debug_renderer_info = 'WEBGL_debug_renderer_info';\nconst GL_FRAGMENT_SHADER_DERIVATIVE_HINT = 0x8b8b;\nconst GL_DONT_CARE = 0x1100;\nconst GL_GPU_DISJOINT_EXT = 0x8fbb;\nconst GL_MAX_TEXTURE_MAX_ANISOTROPY_EXT = 0x84ff;\nconst GL_UNMASKED_VENDOR_WEBGL = 0x9245;\nconst GL_UNMASKED_RENDERER_WEBGL = 0x9246;\n\nconst getWebGL2ValueOrZero = gl => !isWebGL2(gl) ? 0 : undefined;\n\nconst WEBGL_PARAMETERS = {\n  [3074]: gl => !isWebGL2(gl) ? 36064 : undefined,\n  [GL_FRAGMENT_SHADER_DERIVATIVE_HINT]: gl => !isWebGL2(gl) ? GL_DONT_CARE : undefined,\n  [35977]: getWebGL2ValueOrZero,\n  [32937]: getWebGL2ValueOrZero,\n  [GL_GPU_DISJOINT_EXT]: (gl, getParameter) => {\n    const ext = isWebGL2(gl) ? gl.getExtension(EXT_disjoint_timer_query_webgl2) : gl.getExtension(EXT_disjoint_timer_query);\n    return ext && ext.GPU_DISJOINT_EXT ? getParameter(ext.GPU_DISJOINT_EXT) : 0;\n  },\n  [GL_UNMASKED_VENDOR_WEBGL]: (gl, getParameter) => {\n    const ext = gl.getExtension(WEBGL_debug_renderer_info);\n    return getParameter(ext && ext.UNMASKED_VENDOR_WEBGL || 7936);\n  },\n  [GL_UNMASKED_RENDERER_WEBGL]: (gl, getParameter) => {\n    const ext = gl.getExtension(WEBGL_debug_renderer_info);\n    return getParameter(ext && ext.UNMASKED_RENDERER_WEBGL || 7937);\n  },\n  [GL_MAX_TEXTURE_MAX_ANISOTROPY_EXT]: (gl, getParameter) => {\n    const ext = gl.luma.extensions[EXT_texture_filter_anisotropic];\n    return ext ? getParameter(ext.MAX_TEXTURE_MAX_ANISOTROPY_EXT) : 1.0;\n  },\n  [32883]: getWebGL2ValueOrZero,\n  [35071]: getWebGL2ValueOrZero,\n  [37447]: getWebGL2ValueOrZero,\n  [36063]: (gl, getParameter) => {\n    if (!isWebGL2(gl)) {\n      const ext = gl.getExtension(WEBGL_draw_buffers);\n      return ext ? getParameter(ext.MAX_COLOR_ATTACHMENTS_WEBGL) : 0;\n    }\n\n    return undefined;\n  },\n  [35379]: getWebGL2ValueOrZero,\n  [35374]: getWebGL2ValueOrZero,\n  [35377]: getWebGL2ValueOrZero,\n  [34852]: gl => {\n    if (!isWebGL2(gl)) {\n      const ext = gl.getExtension(WEBGL_draw_buffers);\n      return ext ? ext.MAX_DRAW_BUFFERS_WEBGL : 0;\n    }\n\n    return undefined;\n  },\n  [36203]: gl => gl.getExtension(OES_element_index) ? 2147483647 : 65535,\n  [33001]: gl => gl.getExtension(OES_element_index) ? 16777216 : 65535,\n  [33000]: gl => 16777216,\n  [37157]: getWebGL2ValueOrZero,\n  [35373]: getWebGL2ValueOrZero,\n  [35657]: getWebGL2ValueOrZero,\n  [36183]: getWebGL2ValueOrZero,\n  [37137]: getWebGL2ValueOrZero,\n  [34045]: getWebGL2ValueOrZero,\n  [35978]: getWebGL2ValueOrZero,\n  [35979]: getWebGL2ValueOrZero,\n  [35968]: getWebGL2ValueOrZero,\n  [35376]: getWebGL2ValueOrZero,\n  [35375]: getWebGL2ValueOrZero,\n  [35659]: getWebGL2ValueOrZero,\n  [37154]: getWebGL2ValueOrZero,\n  [35371]: getWebGL2ValueOrZero,\n  [35658]: getWebGL2ValueOrZero,\n  [35076]: getWebGL2ValueOrZero,\n  [35077]: getWebGL2ValueOrZero,\n  [35380]: getWebGL2ValueOrZero\n};\nexport function getParameterPolyfill(gl, originalGetParameter, pname) {\n  const limit = WEBGL_PARAMETERS[pname];\n  const value = typeof limit === 'function' ? limit(gl, originalGetParameter, pname) : limit;\n  const result = value !== undefined ? value : originalGetParameter(pname);\n  return result;\n}\n//# sourceMappingURL=get-parameter-polyfill.js.map","import { assert } from '../utils/assert';\nimport { isWebGL2 } from '../utils/webgl-checks';\nimport { getParameterPolyfill } from './get-parameter-polyfill';\nconst OES_vertex_array_object = 'OES_vertex_array_object';\nconst ANGLE_instanced_arrays = 'ANGLE_instanced_arrays';\nconst WEBGL_draw_buffers = 'WEBGL_draw_buffers';\nconst EXT_disjoint_timer_query = 'EXT_disjoint_timer_query';\nconst EXT_texture_filter_anisotropic = 'EXT_texture_filter_anisotropic';\nconst ERR_VAO_NOT_SUPPORTED = 'VertexArray requires WebGL2 or OES_vertex_array_object extension';\n\nfunction getExtensionData(gl, extension) {\n  return {\n    webgl2: isWebGL2(gl),\n    ext: gl.getExtension(extension)\n  };\n}\n\nexport const WEBGL2_CONTEXT_POLYFILLS = {\n  [OES_vertex_array_object]: {\n    meta: {\n      suffix: 'OES'\n    },\n    createVertexArray: () => {\n      assert(false, ERR_VAO_NOT_SUPPORTED);\n    },\n    deleteVertexArray: () => {},\n    bindVertexArray: () => {},\n    isVertexArray: () => false\n  },\n  [ANGLE_instanced_arrays]: {\n    meta: {\n      suffix: 'ANGLE'\n    },\n\n    vertexAttribDivisor(location, divisor) {\n      assert(divisor === 0, 'WebGL instanced rendering not supported');\n    },\n\n    drawElementsInstanced: () => {},\n    drawArraysInstanced: () => {}\n  },\n  [WEBGL_draw_buffers]: {\n    meta: {\n      suffix: 'WEBGL'\n    },\n    drawBuffers: () => {\n      assert(false);\n    }\n  },\n  [EXT_disjoint_timer_query]: {\n    meta: {\n      suffix: 'EXT'\n    },\n    createQuery: () => {\n      assert(false);\n    },\n    deleteQuery: () => {\n      assert(false);\n    },\n    beginQuery: () => {\n      assert(false);\n    },\n    endQuery: () => {},\n\n    getQuery(handle, pname) {\n      return this.getQueryObject(handle, pname);\n    },\n\n    getQueryParameter(handle, pname) {\n      return this.getQueryObject(handle, pname);\n    },\n\n    getQueryObject: () => {}\n  }\n};\nexport const WEBGL2_CONTEXT_OVERRIDES = {\n  readBuffer: (gl, originalFunc, attachment) => {\n    if (isWebGL2(gl)) {\n      originalFunc(attachment);\n    } else {}\n  },\n  getVertexAttrib: (gl, originalFunc, location, pname) => {\n    const {\n      webgl2,\n      ext\n    } = getExtensionData(gl, ANGLE_instanced_arrays);\n    let result;\n\n    switch (pname) {\n      case 35069:\n        result = !webgl2 ? false : undefined;\n        break;\n\n      case 35070:\n        result = !webgl2 && !ext ? 0 : undefined;\n        break;\n\n      default:\n    }\n\n    return result !== undefined ? result : originalFunc(location, pname);\n  },\n  getProgramParameter: (gl, originalFunc, program, pname) => {\n    if (!isWebGL2(gl)) {\n      switch (pname) {\n        case 35967:\n          return 35981;\n\n        case 35971:\n          return 0;\n\n        case 35382:\n          return 0;\n\n        default:\n      }\n    }\n\n    return originalFunc(program, pname);\n  },\n  getInternalformatParameter: (gl, originalFunc, target, format, pname) => {\n    if (!isWebGL2(gl)) {\n      switch (pname) {\n        case 32937:\n          return new Int32Array([0]);\n\n        default:\n      }\n    }\n\n    return gl.getInternalformatParameter(target, format, pname);\n  },\n\n  getTexParameter(gl, originalFunc, target, pname) {\n    switch (pname) {\n      case 34046:\n        const {\n          extensions\n        } = gl.luma;\n        const ext = extensions[EXT_texture_filter_anisotropic];\n        pname = ext && ext.TEXTURE_MAX_ANISOTROPY_EXT || 34046;\n        break;\n\n      default:\n    }\n\n    return originalFunc(target, pname);\n  },\n\n  getParameter: getParameterPolyfill,\n\n  hint(gl, originalFunc, pname, value) {\n    return originalFunc(pname, value);\n  }\n\n};\n//# sourceMappingURL=polyfill-table.js.map","import { polyfillVertexArrayObject } from './polyfill-vertex-array-object';\nimport { assert } from '../utils/assert';\nimport { WEBGL2_CONTEXT_POLYFILLS, WEBGL2_CONTEXT_OVERRIDES } from './polyfill-table';\nexport function polyfillContext(gl) {\n  gl.luma = gl.luma || {};\n  const {\n    luma\n  } = gl;\n\n  if (!luma.polyfilled) {\n    polyfillVertexArrayObject(gl);\n    initializeExtensions(gl);\n    installPolyfills(gl, WEBGL2_CONTEXT_POLYFILLS);\n    installOverrides(gl, {\n      target: luma,\n      target2: gl\n    });\n    luma.polyfilled = true;\n  }\n\n  return gl;\n}\nglobalThis.polyfillContext = polyfillContext;\n\nfunction initializeExtensions(gl) {\n  gl.luma.extensions = {};\n  const EXTENSIONS = gl.getSupportedExtensions() || [];\n\n  for (const extension of EXTENSIONS) {\n    gl.luma[extension] = gl.getExtension(extension);\n  }\n}\n\nfunction installOverrides(gl, _ref) {\n  let {\n    target,\n    target2\n  } = _ref;\n  Object.keys(WEBGL2_CONTEXT_OVERRIDES).forEach(key => {\n    if (typeof WEBGL2_CONTEXT_OVERRIDES[key] === 'function') {\n      const originalFunc = gl[key] ? gl[key].bind(gl) : () => {};\n      const polyfill = WEBGL2_CONTEXT_OVERRIDES[key].bind(null, gl, originalFunc);\n      target[key] = polyfill;\n      target2[key] = polyfill;\n    }\n  });\n}\n\nfunction installPolyfills(gl, polyfills) {\n  for (const extension of Object.getOwnPropertyNames(polyfills)) {\n    if (extension !== 'overrides') {\n      polyfillExtension(gl, {\n        extension,\n        target: gl.luma,\n        target2: gl\n      });\n    }\n  }\n}\n\nfunction polyfillExtension(gl, _ref2) {\n  let {\n    extension,\n    target,\n    target2\n  } = _ref2;\n  const defaults = WEBGL2_CONTEXT_POLYFILLS[extension];\n  assert(defaults);\n  const {\n    meta = {}\n  } = defaults;\n  const {\n    suffix = ''\n  } = meta;\n  const ext = gl.getExtension(extension);\n\n  for (const key of Object.keys(defaults)) {\n    const extKey = \"\".concat(key).concat(suffix);\n    let polyfill = null;\n\n    if (key === 'meta') {} else if (typeof gl[key] === 'function') {} else if (ext && typeof ext[extKey] === 'function') {\n      polyfill = function () {\n        return ext[extKey](...arguments);\n      };\n    } else if (typeof defaults[key] === 'function') {\n      polyfill = defaults[key].bind(target);\n    }\n\n    if (polyfill) {\n      target[key] = polyfill;\n      target2[key] = polyfill;\n    }\n  }\n}\n//# sourceMappingURL=polyfill-context.js.map","import { isWebGL2 } from '../utils/webgl-checks';\nexport const GL_PARAMETER_DEFAULTS = {\n  [3042]: false,\n  [32773]: new Float32Array([0, 0, 0, 0]),\n  [32777]: 32774,\n  [34877]: 32774,\n  [32969]: 1,\n  [32968]: 0,\n  [32971]: 1,\n  [32970]: 0,\n  [3106]: new Float32Array([0, 0, 0, 0]),\n  [3107]: [true, true, true, true],\n  [2884]: false,\n  [2885]: 1029,\n  [2929]: false,\n  [2931]: 1,\n  [2932]: 513,\n  [2928]: new Float32Array([0, 1]),\n  [2930]: true,\n  [3024]: true,\n  [36006]: null,\n  [2886]: 2305,\n  [33170]: 4352,\n  [2849]: 1,\n  [32823]: false,\n  [32824]: 0,\n  [10752]: 0,\n  [32938]: 1.0,\n  [32939]: false,\n  [3089]: false,\n  [3088]: new Int32Array([0, 0, 1024, 1024]),\n  [2960]: false,\n  [2961]: 0,\n  [2968]: 0xffffffff,\n  [36005]: 0xffffffff,\n  [2962]: 519,\n  [2967]: 0,\n  [2963]: 0xffffffff,\n  [34816]: 519,\n  [36003]: 0,\n  [36004]: 0xffffffff,\n  [2964]: 7680,\n  [2965]: 7680,\n  [2966]: 7680,\n  [34817]: 7680,\n  [34818]: 7680,\n  [34819]: 7680,\n  [2978]: [0, 0, 1024, 1024],\n  [3333]: 4,\n  [3317]: 4,\n  [37440]: false,\n  [37441]: false,\n  [37443]: 37444,\n  [35723]: 4352,\n  [36010]: null,\n  [35977]: false,\n  [3330]: 0,\n  [3332]: 0,\n  [3331]: 0,\n  [3314]: 0,\n  [32878]: 0,\n  [3316]: 0,\n  [3315]: 0,\n  [32877]: 0\n};\n\nconst enable = (gl, value, key) => value ? gl.enable(key) : gl.disable(key);\n\nconst hint = (gl, value, key) => gl.hint(key, value);\n\nconst pixelStorei = (gl, value, key) => gl.pixelStorei(key, value);\n\nconst drawFramebuffer = (gl, value) => {\n  const target = isWebGL2(gl) ? 36009 : 36160;\n  return gl.bindFramebuffer(target, value);\n};\n\nconst readFramebuffer = (gl, value) => {\n  return gl.bindFramebuffer(36008, value);\n};\n\nfunction isArray(array) {\n  return Array.isArray(array) || ArrayBuffer.isView(array);\n}\n\nexport const GL_PARAMETER_SETTERS = {\n  [3042]: enable,\n  [32773]: (gl, value) => gl.blendColor(...value),\n  [32777]: 'blendEquation',\n  [34877]: 'blendEquation',\n  [32969]: 'blendFunc',\n  [32968]: 'blendFunc',\n  [32971]: 'blendFunc',\n  [32970]: 'blendFunc',\n  [3106]: (gl, value) => gl.clearColor(...value),\n  [3107]: (gl, value) => gl.colorMask(...value),\n  [2884]: enable,\n  [2885]: (gl, value) => gl.cullFace(value),\n  [2929]: enable,\n  [2931]: (gl, value) => gl.clearDepth(value),\n  [2932]: (gl, value) => gl.depthFunc(value),\n  [2928]: (gl, value) => gl.depthRange(...value),\n  [2930]: (gl, value) => gl.depthMask(value),\n  [3024]: enable,\n  [35723]: hint,\n  [36006]: drawFramebuffer,\n  [2886]: (gl, value) => gl.frontFace(value),\n  [33170]: hint,\n  [2849]: (gl, value) => gl.lineWidth(value),\n  [32823]: enable,\n  [32824]: 'polygonOffset',\n  [10752]: 'polygonOffset',\n  [35977]: enable,\n  [32938]: 'sampleCoverage',\n  [32939]: 'sampleCoverage',\n  [3089]: enable,\n  [3088]: (gl, value) => gl.scissor(...value),\n  [2960]: enable,\n  [2961]: (gl, value) => gl.clearStencil(value),\n  [2968]: (gl, value) => gl.stencilMaskSeparate(1028, value),\n  [36005]: (gl, value) => gl.stencilMaskSeparate(1029, value),\n  [2962]: 'stencilFuncFront',\n  [2967]: 'stencilFuncFront',\n  [2963]: 'stencilFuncFront',\n  [34816]: 'stencilFuncBack',\n  [36003]: 'stencilFuncBack',\n  [36004]: 'stencilFuncBack',\n  [2964]: 'stencilOpFront',\n  [2965]: 'stencilOpFront',\n  [2966]: 'stencilOpFront',\n  [34817]: 'stencilOpBack',\n  [34818]: 'stencilOpBack',\n  [34819]: 'stencilOpBack',\n  [2978]: (gl, value) => gl.viewport(...value),\n  [3333]: pixelStorei,\n  [3317]: pixelStorei,\n  [37440]: pixelStorei,\n  [37441]: pixelStorei,\n  [37443]: pixelStorei,\n  [3330]: pixelStorei,\n  [3332]: pixelStorei,\n  [3331]: pixelStorei,\n  [36010]: readFramebuffer,\n  [3314]: pixelStorei,\n  [32878]: pixelStorei,\n  [3316]: pixelStorei,\n  [3315]: pixelStorei,\n  [32877]: pixelStorei,\n  framebuffer: (gl, framebuffer) => {\n    const handle = framebuffer && 'handle' in framebuffer ? framebuffer.handle : framebuffer;\n    return gl.bindFramebuffer(36160, handle);\n  },\n  blend: (gl, value) => value ? gl.enable(3042) : gl.disable(3042),\n  blendColor: (gl, value) => gl.blendColor(...value),\n  blendEquation: (gl, args) => {\n    args = isArray(args) ? args : [args, args];\n    gl.blendEquationSeparate(...args);\n  },\n  blendFunc: (gl, args) => {\n    args = isArray(args) && args.length === 2 ? [...args, ...args] : args;\n    gl.blendFuncSeparate(...args);\n  },\n  clearColor: (gl, value) => gl.clearColor(...value),\n  clearDepth: (gl, value) => gl.clearDepth(value),\n  clearStencil: (gl, value) => gl.clearStencil(value),\n  colorMask: (gl, value) => gl.colorMask(...value),\n  cull: (gl, value) => value ? gl.enable(2884) : gl.disable(2884),\n  cullFace: (gl, value) => gl.cullFace(value),\n  depthTest: (gl, value) => value ? gl.enable(2929) : gl.disable(2929),\n  depthFunc: (gl, value) => gl.depthFunc(value),\n  depthMask: (gl, value) => gl.depthMask(value),\n  depthRange: (gl, value) => gl.depthRange(...value),\n  dither: (gl, value) => value ? gl.enable(3024) : gl.disable(3024),\n  derivativeHint: (gl, value) => {\n    gl.hint(35723, value);\n  },\n  frontFace: (gl, value) => gl.frontFace(value),\n  mipmapHint: (gl, value) => gl.hint(33170, value),\n  lineWidth: (gl, value) => gl.lineWidth(value),\n  polygonOffsetFill: (gl, value) => value ? gl.enable(32823) : gl.disable(32823),\n  polygonOffset: (gl, value) => gl.polygonOffset(...value),\n  sampleCoverage: (gl, value) => gl.sampleCoverage(...value),\n  scissorTest: (gl, value) => value ? gl.enable(3089) : gl.disable(3089),\n  scissor: (gl, value) => gl.scissor(...value),\n  stencilTest: (gl, value) => value ? gl.enable(2960) : gl.disable(2960),\n  stencilMask: (gl, value) => {\n    value = isArray(value) ? value : [value, value];\n    const [mask, backMask] = value;\n    gl.stencilMaskSeparate(1028, mask);\n    gl.stencilMaskSeparate(1029, backMask);\n  },\n  stencilFunc: (gl, args) => {\n    args = isArray(args) && args.length === 3 ? [...args, ...args] : args;\n    const [func, ref, mask, backFunc, backRef, backMask] = args;\n    gl.stencilFuncSeparate(1028, func, ref, mask);\n    gl.stencilFuncSeparate(1029, backFunc, backRef, backMask);\n  },\n  stencilOp: (gl, args) => {\n    args = isArray(args) && args.length === 3 ? [...args, ...args] : args;\n    const [sfail, dpfail, dppass, backSfail, backDpfail, backDppass] = args;\n    gl.stencilOpSeparate(1028, sfail, dpfail, dppass);\n    gl.stencilOpSeparate(1029, backSfail, backDpfail, backDppass);\n  },\n  viewport: (gl, value) => gl.viewport(...value)\n};\n\nfunction getValue(glEnum, values, cache) {\n  return values[glEnum] !== undefined ? values[glEnum] : cache[glEnum];\n}\n\nexport const GL_COMPOSITE_PARAMETER_SETTERS = {\n  blendEquation: (gl, values, cache) => gl.blendEquationSeparate(getValue(32777, values, cache), getValue(34877, values, cache)),\n  blendFunc: (gl, values, cache) => gl.blendFuncSeparate(getValue(32969, values, cache), getValue(32968, values, cache), getValue(32971, values, cache), getValue(32970, values, cache)),\n  polygonOffset: (gl, values, cache) => gl.polygonOffset(getValue(32824, values, cache), getValue(10752, values, cache)),\n  sampleCoverage: (gl, values, cache) => gl.sampleCoverage(getValue(32938, values, cache), getValue(32939, values, cache)),\n  stencilFuncFront: (gl, values, cache) => gl.stencilFuncSeparate(1028, getValue(2962, values, cache), getValue(2967, values, cache), getValue(2963, values, cache)),\n  stencilFuncBack: (gl, values, cache) => gl.stencilFuncSeparate(1029, getValue(34816, values, cache), getValue(36003, values, cache), getValue(36004, values, cache)),\n  stencilOpFront: (gl, values, cache) => gl.stencilOpSeparate(1028, getValue(2964, values, cache), getValue(2965, values, cache), getValue(2966, values, cache)),\n  stencilOpBack: (gl, values, cache) => gl.stencilOpSeparate(1029, getValue(34817, values, cache), getValue(34818, values, cache), getValue(34819, values, cache))\n};\nexport const GL_HOOKED_SETTERS = {\n  enable: (update, capability) => update({\n    [capability]: true\n  }),\n  disable: (update, capability) => update({\n    [capability]: false\n  }),\n  pixelStorei: (update, pname, value) => update({\n    [pname]: value\n  }),\n  hint: (update, pname, hint) => update({\n    [pname]: hint\n  }),\n  bindFramebuffer: (update, target, framebuffer) => {\n    switch (target) {\n      case 36160:\n        return update({\n          [36006]: framebuffer,\n          [36010]: framebuffer\n        });\n\n      case 36009:\n        return update({\n          [36006]: framebuffer\n        });\n\n      case 36008:\n        return update({\n          [36010]: framebuffer\n        });\n\n      default:\n        return null;\n    }\n  },\n  blendColor: (update, r, g, b, a) => update({\n    [32773]: new Float32Array([r, g, b, a])\n  }),\n  blendEquation: (update, mode) => update({\n    [32777]: mode,\n    [34877]: mode\n  }),\n  blendEquationSeparate: (update, modeRGB, modeAlpha) => update({\n    [32777]: modeRGB,\n    [34877]: modeAlpha\n  }),\n  blendFunc: (update, src, dst) => update({\n    [32969]: src,\n    [32968]: dst,\n    [32971]: src,\n    [32970]: dst\n  }),\n  blendFuncSeparate: (update, srcRGB, dstRGB, srcAlpha, dstAlpha) => update({\n    [32969]: srcRGB,\n    [32968]: dstRGB,\n    [32971]: srcAlpha,\n    [32970]: dstAlpha\n  }),\n  clearColor: (update, r, g, b, a) => update({\n    [3106]: new Float32Array([r, g, b, a])\n  }),\n  clearDepth: (update, depth) => update({\n    [2931]: depth\n  }),\n  clearStencil: (update, s) => update({\n    [2961]: s\n  }),\n  colorMask: (update, r, g, b, a) => update({\n    [3107]: [r, g, b, a]\n  }),\n  cullFace: (update, mode) => update({\n    [2885]: mode\n  }),\n  depthFunc: (update, func) => update({\n    [2932]: func\n  }),\n  depthRange: (update, zNear, zFar) => update({\n    [2928]: new Float32Array([zNear, zFar])\n  }),\n  depthMask: (update, mask) => update({\n    [2930]: mask\n  }),\n  frontFace: (update, face) => update({\n    [2886]: face\n  }),\n  lineWidth: (update, width) => update({\n    [2849]: width\n  }),\n  polygonOffset: (update, factor, units) => update({\n    [32824]: factor,\n    [10752]: units\n  }),\n  sampleCoverage: (update, value, invert) => update({\n    [32938]: value,\n    [32939]: invert\n  }),\n  scissor: (update, x, y, width, height) => update({\n    [3088]: new Int32Array([x, y, width, height])\n  }),\n  stencilMask: (update, mask) => update({\n    [2968]: mask,\n    [36005]: mask\n  }),\n  stencilMaskSeparate: (update, face, mask) => update({\n    [face === 1028 ? 2968 : 36005]: mask\n  }),\n  stencilFunc: (update, func, ref, mask) => update({\n    [2962]: func,\n    [2967]: ref,\n    [2963]: mask,\n    [34816]: func,\n    [36003]: ref,\n    [36004]: mask\n  }),\n  stencilFuncSeparate: (update, face, func, ref, mask) => update({\n    [face === 1028 ? 2962 : 34816]: func,\n    [face === 1028 ? 2967 : 36003]: ref,\n    [face === 1028 ? 2963 : 36004]: mask\n  }),\n  stencilOp: (update, fail, zfail, zpass) => update({\n    [2964]: fail,\n    [2965]: zfail,\n    [2966]: zpass,\n    [34817]: fail,\n    [34818]: zfail,\n    [34819]: zpass\n  }),\n  stencilOpSeparate: (update, face, fail, zfail, zpass) => update({\n    [face === 1028 ? 2964 : 34817]: fail,\n    [face === 1028 ? 2965 : 34818]: zfail,\n    [face === 1028 ? 2966 : 34819]: zpass\n  }),\n  viewport: (update, x, y, width, height) => update({\n    [2978]: [x, y, width, height]\n  })\n};\n\nconst isEnabled = (gl, key) => gl.isEnabled(key);\n\nexport const GL_PARAMETER_GETTERS = {\n  [3042]: isEnabled,\n  [2884]: isEnabled,\n  [2929]: isEnabled,\n  [3024]: isEnabled,\n  [32823]: isEnabled,\n  [32926]: isEnabled,\n  [32928]: isEnabled,\n  [3089]: isEnabled,\n  [2960]: isEnabled,\n  [35977]: isEnabled\n};\n//# sourceMappingURL=webgl-parameter-tables.js.map","export function isObjectEmpty(object) {\n  for (const key in object) {\n    return false;\n  }\n\n  return true;\n}\nexport function deepArrayEqual(x, y) {\n  if (x === y) {\n    return true;\n  }\n\n  const isArrayX = Array.isArray(x) || ArrayBuffer.isView(x);\n  const isArrayY = Array.isArray(y) || ArrayBuffer.isView(y);\n\n  if (isArrayX && isArrayY && x.length === y.length) {\n    for (let i = 0; i < x.length; ++i) {\n      if (x[i] !== y[i]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  return false;\n}\n//# sourceMappingURL=utils.js.map","import { GL_PARAMETER_DEFAULTS, GL_HOOKED_SETTERS } from './webgl-parameter-tables';\nimport { setParameters, getParameters } from './unified-parameter-api';\nimport { assert } from '../utils/assert';\nimport { deepArrayEqual } from '../utils/utils';\n\nfunction installGetterOverride(gl, functionName) {\n  const originalGetterFunc = gl[functionName].bind(gl);\n\n  gl[functionName] = function get() {\n    const pname = arguments.length <= 0 ? undefined : arguments[0];\n\n    if (!(pname in gl.state.cache)) {\n      return originalGetterFunc(...arguments);\n    }\n\n    return gl.state.enable ? gl.state.cache[pname] : originalGetterFunc(...arguments);\n  };\n\n  Object.defineProperty(gl[functionName], 'name', {\n    value: \"\".concat(functionName, \"-from-cache\"),\n    configurable: false\n  });\n}\n\nfunction installSetterSpy(gl, functionName, setter) {\n  const originalSetterFunc = gl[functionName].bind(gl);\n\n  gl[functionName] = function set() {\n    for (var _len = arguments.length, params = new Array(_len), _key = 0; _key < _len; _key++) {\n      params[_key] = arguments[_key];\n    }\n\n    const {\n      valueChanged,\n      oldValue\n    } = setter(gl.state._updateCache, ...params);\n\n    if (valueChanged) {\n      originalSetterFunc(...params);\n    }\n\n    return oldValue;\n  };\n\n  Object.defineProperty(gl[functionName], 'name', {\n    value: \"\".concat(functionName, \"-to-cache\"),\n    configurable: false\n  });\n}\n\nfunction installProgramSpy(gl) {\n  const originalUseProgram = gl.useProgram.bind(gl);\n\n  gl.useProgram = function useProgramLuma(handle) {\n    if (gl.state.program !== handle) {\n      originalUseProgram(handle);\n      gl.state.program = handle;\n    }\n  };\n}\n\nclass GLState {\n  constructor(gl) {\n    let {\n      copyState = false,\n      log = () => {}\n    } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    this.gl = gl;\n    this.program = null;\n    this.stateStack = [];\n    this.enable = true;\n    this.cache = copyState ? getParameters(gl) : Object.assign({}, GL_PARAMETER_DEFAULTS);\n    this.log = log;\n    this._updateCache = this._updateCache.bind(this);\n    Object.seal(this);\n  }\n\n  push() {\n    let values = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    this.stateStack.push({});\n  }\n\n  pop() {\n    assert(this.stateStack.length > 0);\n    const oldValues = this.stateStack[this.stateStack.length - 1];\n    setParameters(this.gl, oldValues);\n    this.stateStack.pop();\n  }\n\n  _updateCache(values) {\n    let valueChanged = false;\n    let oldValue;\n    const oldValues = this.stateStack.length > 0 && this.stateStack[this.stateStack.length - 1];\n\n    for (const key in values) {\n      assert(key !== undefined);\n      const value = values[key];\n      const cached = this.cache[key];\n\n      if (!deepArrayEqual(value, cached)) {\n        valueChanged = true;\n        oldValue = cached;\n\n        if (oldValues && !(key in oldValues)) {\n          oldValues[key] = cached;\n        }\n\n        this.cache[key] = value;\n      }\n    }\n\n    return {\n      valueChanged,\n      oldValue\n    };\n  }\n\n}\n\nexport function trackContextState(gl) {\n  let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n  const {\n    enable = true,\n    copyState\n  } = options;\n  assert(copyState !== undefined);\n\n  if (!gl.state) {\n    const {\n      polyfillContext\n    } = globalThis;\n\n    if (polyfillContext) {\n      polyfillContext(gl);\n    }\n\n    gl.state = new GLState(gl, {\n      copyState\n    });\n    installProgramSpy(gl);\n\n    for (const key in GL_HOOKED_SETTERS) {\n      const setter = GL_HOOKED_SETTERS[key];\n      installSetterSpy(gl, key, setter);\n    }\n\n    installGetterOverride(gl, 'getParameter');\n    installGetterOverride(gl, 'isEnabled');\n  }\n\n  gl.state.enable = enable;\n  return gl;\n}\nexport function pushContextState(gl) {\n  if (!gl.state) {\n    trackContextState(gl, {\n      copyState: false\n    });\n  }\n\n  gl.state.push();\n}\nexport function popContextState(gl) {\n  assert(gl.state);\n  gl.state.pop();\n}\n//# sourceMappingURL=track-context-state.js.map","import { GL_PARAMETER_DEFAULTS, GL_PARAMETER_SETTERS, GL_COMPOSITE_PARAMETER_SETTERS, GL_PARAMETER_GETTERS } from './webgl-parameter-tables';\nimport { pushContextState, popContextState } from './track-context-state';\nimport { assert } from '../utils/assert';\nimport { isWebGL } from '../utils/webgl-checks';\nimport { isObjectEmpty } from '../utils/utils';\nexport function setParameters(gl, values) {\n  assert(isWebGL(gl), 'setParameters requires a WebGL context');\n\n  if (isObjectEmpty(values)) {\n    return;\n  }\n\n  const compositeSetters = {};\n\n  for (const key in values) {\n    const glConstant = Number(key);\n    const setter = GL_PARAMETER_SETTERS[key];\n\n    if (setter) {\n      if (typeof setter === 'string') {\n        compositeSetters[setter] = true;\n      } else {\n        setter(gl, values[key], glConstant);\n      }\n    }\n  }\n\n  const cache = gl.state && gl.state.cache;\n\n  if (cache) {\n    for (const key in compositeSetters) {\n      const compositeSetter = GL_COMPOSITE_PARAMETER_SETTERS[key];\n      compositeSetter(gl, values, cache);\n    }\n  }\n}\nexport function getParameters(gl, parameters) {\n  parameters = parameters || GL_PARAMETER_DEFAULTS;\n\n  if (typeof parameters === 'number') {\n    const key = parameters;\n    const getter = GL_PARAMETER_GETTERS[key];\n    return getter ? getter(gl, key) : gl.getParameter(key);\n  }\n\n  const parameterKeys = Array.isArray(parameters) ? parameters : Object.keys(parameters);\n  const state = {};\n\n  for (const key of parameterKeys) {\n    const getter = GL_PARAMETER_GETTERS[key];\n    state[key] = getter ? getter(gl, Number(key)) : gl.getParameter(Number(key));\n  }\n\n  return state;\n}\nexport function resetParameters(gl) {\n  setParameters(gl, GL_PARAMETER_DEFAULTS);\n}\nexport function withParameters(gl, parameters, func) {\n  if (isObjectEmpty(parameters)) {\n    return func(gl);\n  }\n\n  const {\n    nocatch = true\n  } = parameters;\n  pushContextState(gl);\n  setParameters(gl, parameters);\n  let value;\n\n  if (nocatch) {\n    value = func(gl);\n    popContextState(gl);\n  } else {\n    try {\n      value = func(gl);\n    } finally {\n      popContextState(gl);\n    }\n  }\n\n  return value;\n}\n//# sourceMappingURL=unified-parameter-api.js.map","export function cssToDeviceRatio(gl) {\n  const {\n    luma\n  } = gl;\n\n  if (gl.canvas && luma) {\n    const {\n      clientWidth\n    } = luma.canvasSizeInfo;\n    return clientWidth ? gl.drawingBufferWidth / clientWidth : 1;\n  }\n\n  return 1;\n}\nexport function cssToDevicePixels(gl, cssPixel) {\n  let yInvert = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;\n  const ratio = cssToDeviceRatio(gl);\n  const width = gl.drawingBufferWidth;\n  const height = gl.drawingBufferHeight;\n  return scalePixels(cssPixel, ratio, width, height, yInvert);\n}\nexport function getDevicePixelRatio(useDevicePixels) {\n  const windowRatio = typeof window === 'undefined' ? 1 : window.devicePixelRatio || 1;\n\n  if (Number.isFinite(useDevicePixels)) {\n    return useDevicePixels <= 0 ? 1 : useDevicePixels;\n  }\n\n  return useDevicePixels ? windowRatio : 1;\n}\n\nfunction scalePixels(pixel, ratio, width, height, yInvert) {\n  const x = scaleX(pixel[0], ratio, width);\n  let y = scaleY(pixel[1], ratio, height, yInvert);\n  let t = scaleX(pixel[0] + 1, ratio, width);\n  const xHigh = t === width - 1 ? t : t - 1;\n  t = scaleY(pixel[1] + 1, ratio, height, yInvert);\n  let yHigh;\n\n  if (yInvert) {\n    t = t === 0 ? t : t + 1;\n    yHigh = y;\n    y = t;\n  } else {\n    yHigh = t === height - 1 ? t : t - 1;\n  }\n\n  return {\n    x,\n    y,\n    width: Math.max(xHigh - x + 1, 1),\n    height: Math.max(yHigh - y + 1, 1)\n  };\n}\n\nfunction scaleX(x, ratio, width) {\n  const r = Math.min(Math.round(x * ratio), width - 1);\n  return r;\n}\n\nfunction scaleY(y, ratio, height, yInvert) {\n  return yInvert ? Math.max(0, height - 1 - Math.round(y * ratio)) : Math.min(Math.round(y * ratio), height - 1);\n}\n//# sourceMappingURL=device-pixels.js.map","import { isBrowser as getIsBrowser } from '@probe.gl/env';\nimport { trackContextState } from '../state-tracker/track-context-state';\nimport { log } from '../utils/log';\nimport { assert } from '../utils/assert';\nimport { getDevicePixelRatio } from '../utils/device-pixels';\nimport { isWebGL2 } from '../utils/webgl-checks';\nconst isBrowser = getIsBrowser();\nconst isPage = isBrowser && typeof document !== 'undefined';\nconst CONTEXT_DEFAULTS = {\n  webgl2: true,\n  webgl1: true,\n  throwOnError: true,\n  manageState: true,\n  canvas: null,\n  debug: false,\n  width: 800,\n  height: 600\n};\nexport function createGLContext() {\n  let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n  assert(isBrowser, \"createGLContext only available in the browser.\\nCreate your own headless context or use 'createHeadlessContext' from @luma.gl/test-utils\");\n  options = Object.assign({}, CONTEXT_DEFAULTS, options);\n  const {\n    width,\n    height\n  } = options;\n\n  function onError(message) {\n    if (options.throwOnError) {\n      throw new Error(message);\n    }\n\n    console.error(message);\n    return null;\n  }\n\n  options.onError = onError;\n  let gl;\n  const {\n    canvas\n  } = options;\n  const targetCanvas = getCanvas({\n    canvas,\n    width,\n    height,\n    onError\n  });\n  gl = createBrowserContext(targetCanvas, options);\n\n  if (!gl) {\n    return null;\n  }\n\n  gl = instrumentGLContext(gl, options);\n  logInfo(gl);\n  return gl;\n}\nexport function instrumentGLContext(gl) {\n  let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n\n  if (!gl || gl._instrumented) {\n    return gl;\n  }\n\n  gl._version = gl._version || getVersion(gl);\n  gl.luma = gl.luma || {};\n  gl.luma.canvasSizeInfo = gl.luma.canvasSizeInfo || {};\n  options = Object.assign({}, CONTEXT_DEFAULTS, options);\n  const {\n    manageState,\n    debug\n  } = options;\n\n  if (manageState) {\n    trackContextState(gl, {\n      copyState: false,\n      log: function () {\n        for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {\n          args[_key] = arguments[_key];\n        }\n\n        return log.log(1, ...args)();\n      }\n    });\n  }\n\n  if (isBrowser && debug) {\n    if (!globalThis.makeDebugContext) {\n      log.warn('WebGL debug mode not activated. import \"@luma.gl/debug\" to enable.')();\n    } else {\n      gl = globalThis.makeDebugContext(gl, options);\n      log.level = Math.max(log.level, 1);\n    }\n  }\n\n  gl._instrumented = true;\n  return gl;\n}\nexport function getContextDebugInfo(gl) {\n  const vendorMasked = gl.getParameter(7936);\n  const rendererMasked = gl.getParameter(7937);\n  const ext = gl.getExtension('WEBGL_debug_renderer_info');\n  const vendorUnmasked = ext && gl.getParameter(ext.UNMASKED_VENDOR_WEBGL || 7936);\n  const rendererUnmasked = ext && gl.getParameter(ext.UNMASKED_RENDERER_WEBGL || 7937);\n  return {\n    vendor: vendorUnmasked || vendorMasked,\n    renderer: rendererUnmasked || rendererMasked,\n    vendorMasked,\n    rendererMasked,\n    version: gl.getParameter(7938),\n    shadingLanguageVersion: gl.getParameter(35724)\n  };\n}\nexport function resizeGLContext(gl) {\n  let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n\n  if (gl.canvas) {\n    const devicePixelRatio = getDevicePixelRatio(options.useDevicePixels);\n    setDevicePixelRatio(gl, devicePixelRatio, options);\n    return;\n  }\n\n  const ext = gl.getExtension('STACKGL_resize_drawingbuffer');\n\n  if (ext && \"width\" in options && \"height\" in options) {\n    ext.resize(options.width, options.height);\n  }\n}\n\nfunction createBrowserContext(canvas, options) {\n  const {\n    onError\n  } = options;\n  let errorMessage = null;\n\n  const onCreateError = error => errorMessage = error.statusMessage || errorMessage;\n\n  canvas.addEventListener('webglcontextcreationerror', onCreateError, false);\n  const {\n    webgl1 = true,\n    webgl2 = true\n  } = options;\n  let gl = null;\n\n  if (webgl2) {\n    gl = gl || canvas.getContext('webgl2', options);\n    gl = gl || canvas.getContext('experimental-webgl2', options);\n  }\n\n  if (webgl1) {\n    gl = gl || canvas.getContext('webgl', options);\n    gl = gl || canvas.getContext('experimental-webgl', options);\n  }\n\n  canvas.removeEventListener('webglcontextcreationerror', onCreateError, false);\n\n  if (!gl) {\n    return onError(\"Failed to create \".concat(webgl2 && !webgl1 ? 'WebGL2' : 'WebGL', \" context: \").concat(errorMessage || 'Unknown error'));\n  }\n\n  if (options.onContextLost) {\n    canvas.addEventListener('webglcontextlost', options.onContextLost, false);\n  }\n\n  if (options.onContextRestored) {\n    canvas.addEventListener('webglcontextrestored', options.onContextRestored, false);\n  }\n\n  return gl;\n}\n\nfunction getCanvas(_ref) {\n  let {\n    canvas,\n    width = 800,\n    height = 600,\n    onError\n  } = _ref;\n  let targetCanvas;\n\n  if (typeof canvas === 'string') {\n    const isPageLoaded = isPage && document.readyState === 'complete';\n\n    if (!isPageLoaded) {\n      onError(\"createGLContext called on canvas '\".concat(canvas, \"' before page was loaded\"));\n    }\n\n    targetCanvas = document.getElementById(canvas);\n  } else if (canvas) {\n    targetCanvas = canvas;\n  } else {\n    targetCanvas = document.createElement('canvas');\n    targetCanvas.id = 'lumagl-canvas';\n    targetCanvas.style.width = Number.isFinite(width) ? \"\".concat(width, \"px\") : '100%';\n    targetCanvas.style.height = Number.isFinite(height) ? \"\".concat(height, \"px\") : '100%';\n    document.body.insertBefore(targetCanvas, document.body.firstChild);\n  }\n\n  return targetCanvas;\n}\n\nfunction logInfo(gl) {\n  const webGL = isWebGL2(gl) ? 'WebGL2' : 'WebGL1';\n  const info = getContextDebugInfo(gl);\n  const driver = info ? \"(\".concat(info.vendor, \",\").concat(info.renderer, \")\") : '';\n  const debug = gl.debug ? ' debug' : '';\n  log.info(1, \"\".concat(webGL).concat(debug, \" context \").concat(driver))();\n}\n\nfunction getVersion(gl) {\n  if (typeof WebGL2RenderingContext !== 'undefined' && gl instanceof WebGL2RenderingContext) {\n    return 2;\n  }\n\n  return 1;\n}\n\nfunction setDevicePixelRatio(gl, devicePixelRatio, options) {\n  let clientWidth = 'width' in options ? options.width : gl.canvas.clientWidth;\n  let clientHeight = 'height' in options ? options.height : gl.canvas.clientHeight;\n\n  if (!clientWidth || !clientHeight) {\n    log.log(1, 'Canvas clientWidth/clientHeight is 0')();\n    devicePixelRatio = 1;\n    clientWidth = gl.canvas.width || 1;\n    clientHeight = gl.canvas.height || 1;\n  }\n\n  gl.luma = gl.luma || {};\n  gl.luma.canvasSizeInfo = gl.luma.canvasSizeInfo || {};\n  const cachedSize = gl.luma.canvasSizeInfo;\n\n  if (cachedSize.clientWidth !== clientWidth || cachedSize.clientHeight !== clientHeight || cachedSize.devicePixelRatio !== devicePixelRatio) {\n    let clampedPixelRatio = devicePixelRatio;\n    const canvasWidth = Math.floor(clientWidth * clampedPixelRatio);\n    const canvasHeight = Math.floor(clientHeight * clampedPixelRatio);\n    gl.canvas.width = canvasWidth;\n    gl.canvas.height = canvasHeight;\n\n    if (gl.drawingBufferWidth !== canvasWidth || gl.drawingBufferHeight !== canvasHeight) {\n      log.warn(\"Device pixel ratio clamped\")();\n      clampedPixelRatio = Math.min(gl.drawingBufferWidth / clientWidth, gl.drawingBufferHeight / clientHeight);\n      gl.canvas.width = Math.floor(clientWidth * clampedPixelRatio);\n      gl.canvas.height = Math.floor(clientHeight * clampedPixelRatio);\n    }\n\n    Object.assign(gl.luma.canvasSizeInfo, {\n      clientWidth,\n      clientHeight,\n      devicePixelRatio\n    });\n  }\n}\n//# sourceMappingURL=context.js.map","export { log } from './utils/log';\nexport { isWebGL, isWebGL2, getWebGL2Context, assertWebGLContext, assertWebGL2Context } from './utils/webgl-checks';\nexport { polyfillContext } from './polyfill/polyfill-context';\nexport { getParameters, setParameters, resetParameters, withParameters } from './state-tracker/unified-parameter-api';\nexport { trackContextState, pushContextState, popContextState } from './state-tracker/track-context-state';\nexport { createGLContext, resizeGLContext, instrumentGLContext, getContextDebugInfo } from './context/context';\nexport { cssToDeviceRatio, cssToDevicePixels } from './utils/device-pixels';\n//# sourceMappingURL=index.js.map","var superPropBase = require(\"./superPropBase\");\n\nfunction _get(target, property, receiver) {\n  if (typeof Reflect !== \"undefined\" && Reflect.get) {\n    module.exports = _get = Reflect.get;\n  } else {\n    module.exports = _get = function _get(target, property, receiver) {\n      var base = superPropBase(target, property);\n      if (!base) return;\n      var desc = Object.getOwnPropertyDescriptor(base, property);\n\n      if (desc.get) {\n        return desc.get.call(receiver);\n      }\n\n      return desc.value;\n    };\n  }\n\n  return _get(target, property, receiver || target);\n}\n\nmodule.exports = _get;","var arrayWithHoles = require(\"./arrayWithHoles\");\n\nvar iterableToArrayLimit = require(\"./iterableToArrayLimit\");\n\nvar nonIterableRest = require(\"./nonIterableRest\");\n\nfunction _slicedToArray(arr, i) {\n  return arrayWithHoles(arr) || iterableToArrayLimit(arr, i) || nonIterableRest();\n}\n\nmodule.exports = _slicedToArray;","export function assert(condition, message) {\n  if (!condition) {\n    throw new Error(message || 'luma.gl: assertion failed.');\n  }\n}\n//# sourceMappingURL=assert.js.map","/**\n * Common utilities\n * @module glMatrix\n */\n// Configuration Constants\nexport var EPSILON = 0.000001;\nexport var ARRAY_TYPE = typeof Float32Array !== 'undefined' ? Float32Array : Array;\nexport var RANDOM = Math.random;\n/**\n * Sets the type of array used when creating new vectors and matrices\n *\n * @param {Float32ArrayConstructor | ArrayConstructor} type Array type, such as Float32Array or Array\n */\n\nexport function setMatrixArrayType(type) {\n  ARRAY_TYPE = type;\n}\nvar degree = Math.PI / 180;\n/**\n * Convert Degree To Radian\n *\n * @param {Number} a Angle in Degrees\n */\n\nexport function toRadian(a) {\n  return a * degree;\n}\n/**\n * Tests whether or not the arguments have approximately the same value, within an absolute\n * or relative tolerance of glMatrix.EPSILON (an absolute tolerance is used for values less\n * than or equal to 1.0, and a relative tolerance is used for larger values)\n *\n * @param {Number} a The first number to test.\n * @param {Number} b The second number to test.\n * @returns {Boolean} True if the numbers are approximately equal, false otherwise.\n */\n\nexport function equals(a, b) {\n  return Math.abs(a - b) <= EPSILON * Math.max(1.0, Math.abs(a), Math.abs(b));\n}\nif (!Math.hypot) Math.hypot = function () {\n  var y = 0,\n      i = arguments.length;\n\n  while (i--) {\n    y += arguments[i] * arguments[i];\n  }\n\n  return Math.sqrt(y);\n};","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n// Note: The numeric values here are matched by shader code in the\n// \"project\" and \"project64\" shader modules. Both places need to be\n// updated.\nimport log from '../utils/log';\n\n/**\n * The coordinate system that positions/dimensions are defined in.\n */\nexport const COORDINATE_SYSTEM = {\n  /**\n   * `LNGLAT` if rendering into a geospatial viewport, `CARTESIAN` otherwise\n   */\n  DEFAULT: -1,\n  /**\n   * Positions are interpreted as [longitude, latitude, elevation]\n   * longitude/latitude are in degrees, elevation is in meters.\n   * Dimensions are in meters.\n   */\n  LNGLAT: 1,\n\n  /**\n   * Positions are interpreted as [x, y, z] in meter offsets from the coordinate origin.\n   * Dimensions are in meters.\n   */\n  METER_OFFSETS: 2,\n\n  /**\n   * Positions are interpreted as [deltaLng, deltaLat, elevation] from the coordinate origin.\n   * deltaLng/deltaLat are in degrees, elevation is in meters.\n   * Dimensions are in meters.\n   */\n  LNGLAT_OFFSETS: 3,\n\n  /**\n   * Positions and dimensions are in the common units of the viewport.\n   */\n  CARTESIAN: 0\n} as const;\n\n// Enums cannot be directly exported as they are not transpiled correctly into ES5, see https://github.com/visgl/deck.gl/issues/7130\nexport type CoordinateSystem = -1 | 0 | 1 | 2 | 3;\n\n// Deprecated\n/* eslint-disable accessor-pairs */\nObject.defineProperty(COORDINATE_SYSTEM, 'IDENTITY', {\n  get: () => {\n    log.deprecated('COORDINATE_SYSTEM.IDENTITY', 'COORDINATE_SYSTEM.CARTESIAN')();\n    return 0;\n  }\n});\n/* eslint-enable accessor-pairs */\n\n/**\n * How coordinates are transformed from the world space into the common space.\n */\nexport const PROJECTION_MODE = {\n  /**\n   * Render geospatial data in Web Mercator projection\n   */\n  WEB_MERCATOR: 1,\n  /**\n   * Render geospatial data as a 3D globe\n   */\n  GLOBE: 2,\n\n  /**\n   * (Internal use only) Web Mercator projection at high zoom\n   */\n  WEB_MERCATOR_AUTO_OFFSET: 4,\n\n  /**\n   * No transformation\n   */\n  IDENTITY: 0\n} as const;\n\nexport const UNIT = {\n  common: 0,\n  meters: 1,\n  pixels: 2\n} as const;\n\nexport const EVENTS = {\n  click: {handler: 'onClick'},\n  panstart: {handler: 'onDragStart'},\n  panmove: {handler: 'onDrag'},\n  panend: {handler: 'onDragEnd'}\n} as const;\n\n/**\n * The rendering operation to perform with a layer, used in the `operation` prop\n */\nexport const OPERATION = {\n  DRAW: 'draw',\n  MASK: 'mask'\n} as const;\n","import assert from './assert';\nconst RADIANS_TO_DEGREES = 1 / Math.PI * 180;\nconst DEGREES_TO_RADIANS = 1 / 180 * Math.PI;\nexport const config = {\n  EPSILON: 1e-12,\n  debug: false,\n  precision: 4,\n  printTypes: false,\n  printDegrees: false,\n  printRowMajor: true\n};\nexport function configure(options) {\n  for (const key in options) {\n    assert(key in config);\n    config[key] = options[key];\n  }\n\n  return config;\n}\nexport function formatValue(value, {\n  precision = config.precision\n} = {}) {\n  value = round(value);\n  return \"\".concat(parseFloat(value.toPrecision(precision)));\n}\nexport function isArray(value) {\n  return Array.isArray(value) || ArrayBuffer.isView(value) && !(value instanceof DataView);\n}\nexport function clone(array) {\n  return 'clone' in array ? array.clone() : array.slice();\n}\nexport function toRadians(degrees) {\n  return radians(degrees);\n}\nexport function toDegrees(radians) {\n  return degrees(radians);\n}\nexport function radians(degrees, result) {\n  return map(degrees, degrees => degrees * DEGREES_TO_RADIANS, result);\n}\nexport function degrees(radians, result) {\n  return map(radians, radians => radians * RADIANS_TO_DEGREES, result);\n}\nexport function sin(radians, result) {\n  return map(radians, angle => Math.sin(angle), result);\n}\nexport function cos(radians, result) {\n  return map(radians, angle => Math.cos(angle), result);\n}\nexport function tan(radians, result) {\n  return map(radians, angle => Math.tan(angle), result);\n}\nexport function asin(radians, result) {\n  return map(radians, angle => Math.asin(angle), result);\n}\nexport function acos(radians, result) {\n  return map(radians, angle => Math.acos(angle), result);\n}\nexport function atan(radians, result) {\n  return map(radians, angle => Math.atan(angle), result);\n}\nexport function clamp(value, min, max) {\n  return map(value, value => Math.max(min, Math.min(max, value)));\n}\nexport function lerp(a, b, t) {\n  if (isArray(a)) {\n    return a.map((ai, i) => lerp(ai, b[i], t));\n  }\n\n  return t * b + (1 - t) * a;\n}\nexport function equals(a, b, epsilon) {\n  const oldEpsilon = config.EPSILON;\n\n  if (epsilon) {\n    config.EPSILON = epsilon;\n  }\n\n  try {\n    if (a === b) {\n      return true;\n    }\n\n    if (isArray(a) && isArray(b)) {\n      if (a.length !== b.length) {\n        return false;\n      }\n\n      for (let i = 0; i < a.length; ++i) {\n        if (!equals(a[i], b[i])) {\n          return false;\n        }\n      }\n\n      return true;\n    }\n\n    if (a && a.equals) {\n      return a.equals(b);\n    }\n\n    if (b && b.equals) {\n      return b.equals(a);\n    }\n\n    if (typeof a === 'number' && typeof b === 'number') {\n      return Math.abs(a - b) <= config.EPSILON * Math.max(1, Math.abs(a), Math.abs(b));\n    }\n\n    return false;\n  } finally {\n    config.EPSILON = oldEpsilon;\n  }\n}\nexport function exactEquals(a, b) {\n  if (a === b) {\n    return true;\n  }\n\n  if (a && typeof a === 'object' && b && typeof b === 'object') {\n    if (a.constructor !== b.constructor) {\n      return false;\n    }\n\n    if (a.exactEquals) {\n      return a.exactEquals(b);\n    }\n  }\n\n  if (isArray(a) && isArray(b)) {\n    if (a.length !== b.length) {\n      return false;\n    }\n\n    for (let i = 0; i < a.length; ++i) {\n      if (!exactEquals(a[i], b[i])) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  return false;\n}\nexport function withEpsilon(epsilon, func) {\n  const oldPrecision = config.EPSILON;\n  config.EPSILON = epsilon;\n  let value;\n\n  try {\n    value = func();\n  } finally {\n    config.EPSILON = oldPrecision;\n  }\n\n  return value;\n}\n\nfunction round(value) {\n  return Math.round(value / config.EPSILON) * config.EPSILON;\n}\n\nfunction duplicateArray(array) {\n  return array.clone ? array.clone() : new Array(array.length);\n}\n\nfunction map(value, func, result) {\n  if (isArray(value)) {\n    const array = value;\n    result = result || duplicateArray(array);\n\n    for (let i = 0; i < result.length && i < array.length; ++i) {\n      result[i] = func(value[i], i, result);\n    }\n\n    return result;\n  }\n\n  return func(value);\n}\n//# sourceMappingURL=common.js.map","/**\r\n * Common utilities\r\n * @module glMatrix\r\n */\n// Configuration Constants\nexport var EPSILON = 0.000001;\nexport var ARRAY_TYPE = typeof Float32Array !== 'undefined' ? Float32Array : Array;\nexport var RANDOM = Math.random;\n/**\r\n * Sets the type of array used when creating new vectors and matrices\r\n *\r\n * @param {Float32ArrayConstructor | ArrayConstructor} type Array type, such as Float32Array or Array\r\n */\n\nexport function setMatrixArrayType(type) {\n  ARRAY_TYPE = type;\n}\nvar degree = Math.PI / 180;\n/**\r\n * Convert Degree To Radian\r\n *\r\n * @param {Number} a Angle in Degrees\r\n */\n\nexport function toRadian(a) {\n  return a * degree;\n}\n/**\r\n * Tests whether or not the arguments have approximately the same value, within an absolute\r\n * or relative tolerance of glMatrix.EPSILON (an absolute tolerance is used for values less\r\n * than or equal to 1.0, and a relative tolerance is used for larger values)\r\n *\r\n * @param {Number} a The first number to test.\r\n * @param {Number} b The second number to test.\r\n * @returns {Boolean} True if the numbers are approximately equal, false otherwise.\r\n */\n\nexport function equals(a, b) {\n  return Math.abs(a - b) <= EPSILON * Math.max(1.0, Math.abs(a), Math.abs(b));\n}\nif (!Math.hypot) Math.hypot = function () {\n  var y = 0,\n      i = arguments.length;\n\n  while (i--) {\n    y += arguments[i] * arguments[i];\n  }\n\n  return Math.sqrt(y);\n};","import {projectPosition} from '../../shaderlib/project/project-functions';\nimport {COORDINATE_SYSTEM} from '../../lib/constants';\n\nimport type Layer from '../../lib/layer';\n\nconst DEFAULT_LIGHT_COLOR = [255, 255, 255];\nconst DEFAULT_LIGHT_INTENSITY = 1.0;\nconst DEFAULT_ATTENUATION = [0, 0, 1];\nconst DEFAULT_LIGHT_POSITION = [0.0, 0.0, 1.0];\n\nlet idCount = 0;\n\nexport type PointLightOptions = {\n  id?: string;\n  /** Light color, [r, g, b] in the 0-255 range\n   * @default [255, 255, 255]\n   */\n  color?: number[];\n  /** Light intensity, higher number is brighter\n   * @default 1.0\n   */\n  intensity?: number;\n  /** Light position [x, y, z] in the common space\n   * @default [0.0, 0.0, 1.0]\n   */\n  position?: number[];\n  /** Light attenuation\n   * @default [0.0, 0.0, 1.0]\n   */\n  attenuation?: number[];\n};\n\nexport class PointLight {\n  id: string;\n  color: number[];\n  intensity: number;\n  type = 'point';\n  position: number[];\n  attenuation: number[];\n\n  protected projectedLight: PointLight;\n\n  constructor(props: PointLightOptions = {}) {\n    const {color = DEFAULT_LIGHT_COLOR} = props;\n    const {intensity = DEFAULT_LIGHT_INTENSITY} = props;\n    const {position = DEFAULT_LIGHT_POSITION} = props;\n\n    this.id = props.id || `point-${idCount++}`;\n    this.color = color;\n    this.intensity = intensity;\n    this.type = 'point';\n    this.position = position;\n    this.attenuation = getAttenuation(props);\n    this.projectedLight = {...this};\n  }\n\n  getProjectedLight({layer}: {layer: Layer}): PointLight {\n    const {projectedLight} = this;\n    const viewport = layer.context.viewport;\n    const {coordinateSystem, coordinateOrigin} = layer.props;\n    const position = projectPosition(this.position, {\n      viewport,\n      coordinateSystem,\n      coordinateOrigin,\n      fromCoordinateSystem: viewport.isGeospatial\n        ? COORDINATE_SYSTEM.LNGLAT\n        : COORDINATE_SYSTEM.CARTESIAN,\n      fromCoordinateOrigin: [0, 0, 0]\n    });\n    projectedLight.color = this.color;\n    projectedLight.intensity = this.intensity;\n    projectedLight.position = position;\n    return projectedLight;\n  }\n}\n\nfunction getAttenuation(props: PointLightOptions): number[] {\n  if (props.attenuation) {\n    return props.attenuation;\n  }\n  if ('intensity' in props) {\n    return [0, 0, props.intensity || 0];\n  }\n  return DEFAULT_ATTENUATION;\n}\n","/* eslint-disable camelcase */\nimport {PointLight} from './point-light';\nimport {getUniformsFromViewport} from '../../shaderlib/project/viewport-uniforms';\nimport type Layer from '../../lib/layer';\n\nexport default class CameraLight extends PointLight {\n  getProjectedLight({layer}: {layer: Layer}): PointLight {\n    const {projectedLight} = this;\n    const viewport = layer.context.viewport;\n    const {coordinateSystem, coordinateOrigin, modelMatrix} = layer.props;\n    const {project_uCameraPosition} = getUniformsFromViewport({\n      viewport,\n      modelMatrix,\n      coordinateSystem,\n      coordinateOrigin\n    });\n    projectedLight.color = this.color;\n    projectedLight.intensity = this.intensity;\n    projectedLight.position = project_uCameraPosition;\n    return projectedLight;\n  }\n}\n","const DEGREES_TO_RADIANS = Math.PI / 180;\nconst DAY_IN_MS = 1000 * 60 * 60 * 24;\nconst JD1970 = 2440588;\nconst JD2000 = 2451545;\nconst e = DEGREES_TO_RADIANS * 23.4397;\nconst M0 = 357.5291;\nconst M1 = 0.98560028;\nconst THETA0 = 280.147;\nconst THETA1 = 360.9856235;\nexport function getSunPosition(timestamp, latitude, longitude) {\n  const longitudeWestInRadians = DEGREES_TO_RADIANS * -longitude;\n  const phi = DEGREES_TO_RADIANS * latitude;\n  const d = toDays(timestamp);\n  const c = getSunCoords(d);\n  const H = getSiderealTime(d, longitudeWestInRadians) - c.rightAscension;\n  return {\n    azimuth: getAzimuth(H, phi, c.declination),\n    altitude: getAltitude(H, phi, c.declination)\n  };\n}\nexport function getSunDirection(timestamp, latitude, longitude) {\n  const {\n    azimuth,\n    altitude\n  } = getSunPosition(timestamp, latitude, longitude);\n  return [Math.sin(azimuth) * Math.cos(altitude), Math.cos(azimuth) * Math.cos(altitude), -Math.sin(altitude)];\n}\n\nfunction toJulianDay(timestamp) {\n  const ts = typeof timestamp === 'number' ? timestamp : timestamp.getTime();\n  return ts / DAY_IN_MS - 0.5 + JD1970;\n}\n\nfunction toDays(timestamp) {\n  return toJulianDay(timestamp) - JD2000;\n}\n\nfunction getRightAscension(eclipticLongitude, b) {\n  const lambda = eclipticLongitude;\n  return Math.atan2(Math.sin(lambda) * Math.cos(e) - Math.tan(b) * Math.sin(e), Math.cos(lambda));\n}\n\nfunction getDeclination(eclipticLongitude, b) {\n  const lambda = eclipticLongitude;\n  return Math.asin(Math.sin(b) * Math.cos(e) + Math.cos(b) * Math.sin(e) * Math.sin(lambda));\n}\n\nfunction getAzimuth(hourAngle, latitudeInRadians, declination) {\n  const H = hourAngle;\n  const phi = latitudeInRadians;\n  const delta = declination;\n  return Math.atan2(Math.sin(H), Math.cos(H) * Math.sin(phi) - Math.tan(delta) * Math.cos(phi));\n}\n\nfunction getAltitude(hourAngle, latitudeInRadians, declination) {\n  const H = hourAngle;\n  const phi = latitudeInRadians;\n  const delta = declination;\n  return Math.asin(Math.sin(phi) * Math.sin(delta) + Math.cos(phi) * Math.cos(delta) * Math.cos(H));\n}\n\nfunction getSiderealTime(dates, longitudeWestInRadians) {\n  return DEGREES_TO_RADIANS * (THETA0 + THETA1 * dates) - longitudeWestInRadians;\n}\n\nfunction getSolarMeanAnomaly(days) {\n  return DEGREES_TO_RADIANS * (M0 + M1 * days);\n}\n\nfunction getEclipticLongitude(meanAnomaly) {\n  const M = meanAnomaly;\n  const C = DEGREES_TO_RADIANS * (1.9148 * Math.sin(M) + 0.02 * Math.sin(2 * M) + 0.0003 * Math.sin(3 * M));\n  const P = DEGREES_TO_RADIANS * 102.9372;\n  return M + C + P + Math.PI;\n}\n\nfunction getSunCoords(dates) {\n  const M = getSolarMeanAnomaly(dates);\n  const L = getEclipticLongitude(M);\n  return {\n    declination: getDeclination(L, 0),\n    rightAscension: getRightAscension(L, 0)\n  };\n}\n//# sourceMappingURL=suncalc.js.map","import {DirectionalLight} from './directional-light';\nimport {getSunDirection} from '@math.gl/sun';\n\nimport type Layer from '../../lib/layer';\n\nexport type SunLightOptions = {\n  id?: string;\n  /** Light color, [r, g, b] in the 0-255 range\n   * @default [255, 255, 255]\n   */\n  color?: number[];\n  /** Light intensity, higher number is brighter\n   * @default 1.0\n   */\n  intensity?: number;\n  /**\n   * The time at which to position the sun. Either a Date object or a timestamp (milliseconds elapsed since unix time 0)\n   */\n  timestamp: number | Date;\n  /** (Experimental) render shadows casted by this light\n   * @default false\n   */\n  _shadow?: boolean;\n};\n\nexport default class SunLight extends DirectionalLight {\n  timestamp: number | Date;\n\n  constructor(opts: SunLightOptions) {\n    super(opts);\n\n    this.timestamp = opts.timestamp;\n  }\n\n  getProjectedLight({layer}: {layer: Layer}): DirectionalLight {\n    const {viewport} = layer.context;\n    const isGlobe = viewport.resolution && viewport.resolution > 0;\n\n    if (isGlobe) {\n      // Rotate vector to align with the direction of the globe projection (up at lon:0,lat:0 is [0, -1, 0])\n      const [x, y, z] = getSunDirection(this.timestamp, 0, 0);\n      this.direction = [x, -z, y];\n    } else {\n      // @ts-expect-error longitude and latitude are not defined on all viewports\n      const {latitude, longitude} = viewport;\n      this.direction = getSunDirection(this.timestamp, latitude, longitude);\n    }\n\n    return this;\n  }\n}\n","import Model from '../lib/model';\nimport Geometry from '../geometry/geometry';\nconst CLIPSPACE_VERTEX_SHADER = \"attribute vec2 aClipSpacePosition;\\nattribute vec2 aTexCoord;\\nattribute vec2 aCoordinate;\\n\\nvarying vec2 position;\\nvarying vec2 coordinate;\\nvarying vec2 uv;\\n\\nvoid main(void) {\\n  gl_Position = vec4(aClipSpacePosition, 0., 1.);\\n  position = aClipSpacePosition;\\n  coordinate = aCoordinate;\\n  uv = aTexCoord;\\n}\\n\";\nconst POSITIONS = [-1, -1, 1, -1, -1, 1, 1, 1];\nexport default class ClipSpace extends Model {\n  constructor(gl, opts) {\n    const TEX_COORDS = POSITIONS.map(coord => coord === -1 ? 0 : coord);\n    super(gl, Object.assign({}, opts, {\n      vs: CLIPSPACE_VERTEX_SHADER,\n      geometry: new Geometry({\n        drawMode: 5,\n        vertexCount: 4,\n        attributes: {\n          aClipSpacePosition: {\n            size: 2,\n            value: new Float32Array(POSITIONS)\n          },\n          aTexCoord: {\n            size: 2,\n            value: new Float32Array(TEX_COORDS)\n          },\n          aCoordinate: {\n            size: 2,\n            value: new Float32Array(TEX_COORDS)\n          }\n        }\n      })\n    }));\n    this.setVertexCount(4);\n  }\n\n}\n//# sourceMappingURL=clip-space.js.map","//\n// A base render pass.\n//\n// Attribution: This class and the multipass system were inspired by\n// the THREE.js EffectComposer and *Pass classes\n\nimport type {Framebuffer} from '@luma.gl/core';\nimport {ClipSpace, setParameters, withParameters, clear} from '@luma.gl/core';\nimport Pass from './pass';\n\nimport type {ShaderModule} from '../types/types';\n\ntype ScreenPassProps = {\n  module: ShaderModule;\n  fs: string | null;\n  id: string;\n  moduleSettings: any;\n};\n\ntype ScreenPassRenderOptions = {\n  inputBuffer: Framebuffer;\n  outputBuffer: Framebuffer;\n};\n\nexport default class ScreenPass extends Pass {\n  model: ClipSpace;\n\n  constructor(gl: WebGLRenderingContext, props: ScreenPassProps) {\n    super(gl, props);\n    const {module, fs, id} = props;\n    this.model = new ClipSpace(gl, {id, fs, modules: [module]});\n  }\n\n  render(params: ScreenPassRenderOptions): void {\n    const gl = this.gl;\n\n    setParameters(gl, {viewport: [0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight]});\n\n    withParameters(gl, {framebuffer: params.outputBuffer, clearColor: [0, 0, 0, 0]}, () =>\n      this._renderPass(gl, params)\n    );\n  }\n\n  delete() {\n    this.model.delete();\n    this.model = null;\n  }\n\n  // Private methods\n\n  /**\n   * Renders the pass.\n   * This is an abstract method that should be overridden.\n   * @param inputBuffer - Frame buffer that contains the result of the previous pass\n   * @param outputBuffer - Frame buffer that serves as the output render target\n   */\n  protected _renderPass(gl: WebGLRenderingContext, options: ScreenPassRenderOptions) {\n    const {inputBuffer} = options;\n    clear(gl, {color: true});\n    this.model.draw({\n      moduleSettings: this.props.moduleSettings,\n      uniforms: {\n        texture: inputBuffer,\n        texSize: [inputBuffer.width, inputBuffer.height]\n      },\n      parameters: {\n        depthWrite: false,\n        depthTest: false\n      }\n    });\n  }\n}\n","import ScreenPass from '../passes/screen-pass';\nimport {normalizeShaderModule} from '@luma.gl/core';\n\nimport type {Effect, PostRenderOptions} from '../lib/effect';\nimport type {Framebuffer} from '@luma.gl/webgl';\nimport type {ShaderModule} from '../types/types';\n\nexport default class PostProcessEffect implements Effect {\n  id: string;\n  props: any;\n  module: ShaderModule;\n  passes?: ScreenPass[];\n\n  constructor(module: ShaderModule, props: any = {}) {\n    this.id = `${module.name}-pass`;\n    this.props = props;\n    normalizeShaderModule(module);\n    this.module = module;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-empty-function\n  preRender(): void {}\n\n  postRender(gl: WebGLRenderingContext, params: PostRenderOptions): Framebuffer {\n    const passes = this.passes || createPasses(gl, this.module, this.id, this.props);\n    this.passes = passes;\n\n    const {target} = params;\n    let inputBuffer = params.inputBuffer;\n    let outputBuffer = params.swapBuffer;\n\n    for (let index = 0; index < this.passes.length; index++) {\n      if (target && index === this.passes.length - 1) {\n        outputBuffer = target;\n      }\n      this.passes[index].render({inputBuffer, outputBuffer});\n      const switchBuffer = outputBuffer;\n      outputBuffer = inputBuffer;\n      inputBuffer = switchBuffer;\n    }\n    return inputBuffer;\n  }\n\n  cleanup(): void {\n    if (this.passes) {\n      for (const pass of this.passes) {\n        pass.delete();\n      }\n      this.passes = undefined;\n    }\n  }\n}\n\nfunction createPasses(\n  gl: WebGLRenderingContext,\n  module: ShaderModule,\n  id: string,\n  moduleSettings: any\n): ScreenPass[] {\n  if (!module.passes) {\n    const fs = getFragmentShaderForRenderPass(module);\n    const pass = new ScreenPass(gl, {\n      id,\n      module,\n      fs,\n      moduleSettings\n    });\n    return [pass];\n  }\n\n  return module.passes.map((pass, index) => {\n    const fs = getFragmentShaderForRenderPass(module, pass);\n    const idn = `${id}-${index}`;\n\n    return new ScreenPass(gl, {\n      id: idn,\n      module,\n      fs,\n      moduleSettings\n    });\n  });\n}\n\nconst FILTER_FS_TEMPLATE = func => `\\\nuniform sampler2D texture;\nuniform vec2 texSize;\n\nvarying vec2 position;\nvarying vec2 coordinate;\nvarying vec2 uv;\n\nvoid main() {\n  vec2 texCoord = coordinate;\n\n  gl_FragColor = texture2D(texture, texCoord);\n  gl_FragColor = ${func}(gl_FragColor, texSize, texCoord);\n}\n`;\n\nconst SAMPLER_FS_TEMPLATE = func => `\\\nuniform sampler2D texture;\nuniform vec2 texSize;\n\nvarying vec2 position;\nvarying vec2 coordinate;\nvarying vec2 uv;\n\nvoid main() {\n  vec2 texCoord = coordinate;\n\n  gl_FragColor = ${func}(texture, texSize, texCoord);\n}\n`;\n\nfunction getFragmentShaderForRenderPass(module, pass = module) {\n  if (pass.filter) {\n    const func = typeof pass.filter === 'string' ? pass.filter : `${module.name}_filterColor`;\n    return FILTER_FS_TEMPLATE(func);\n  }\n\n  if (pass.sampler) {\n    const func = typeof pass.sampler === 'string' ? pass.sampler : `${module.name}_sampleColor`;\n    return SAMPLER_FS_TEMPLATE(func);\n  }\n\n  // console.error(`${module.name} no fragment shader generated`);\n  return null;\n}\n","import Viewport from '../viewports/viewport';\n\nimport {Matrix4} from '@math.gl/core';\nimport {pixelsToWorld, fovyToAltitude} from '@math.gl/web-mercator';\n\nconst DEGREES_TO_RADIANS = Math.PI / 180;\n\nfunction getViewMatrix({\n  height,\n  focalDistance,\n  orbitAxis,\n  rotationX,\n  rotationOrbit,\n  zoom\n}: {\n  height: number;\n  focalDistance: number;\n  orbitAxis: 'Y' | 'Z';\n  rotationX: number;\n  rotationOrbit: number;\n  zoom: number;\n}): Matrix4 {\n  // We position the camera so that one common space unit (world space unit scaled by zoom)\n  // at the target maps to one screen pixel.\n  // This is a similar technique to that used in web mercator projection\n  // By doing so we are able to convert between common space and screen space sizes efficiently\n  // in the vertex shader.\n  const up = orbitAxis === 'Z' ? [0, 0, 1] : [0, 1, 0];\n  const eye = orbitAxis === 'Z' ? [0, -focalDistance, 0] : [0, 0, focalDistance];\n\n  const viewMatrix = new Matrix4().lookAt({eye, up});\n\n  viewMatrix.rotateX(rotationX * DEGREES_TO_RADIANS);\n  if (orbitAxis === 'Z') {\n    viewMatrix.rotateZ(rotationOrbit * DEGREES_TO_RADIANS);\n  } else {\n    viewMatrix.rotateY(rotationOrbit * DEGREES_TO_RADIANS);\n  }\n\n  // When height increases, we need to increase the distance from the camera to the target to\n  // keep the 1:1 mapping. However, this also changes the projected depth of each position by\n  // moving them further away between the near/far plane.\n  // Without modifying the default near/far planes, we instead scale down the common space to\n  // remove the distortion to the depth field.\n  const projectionScale = Math.pow(2, zoom) / height;\n  viewMatrix.scale(projectionScale);\n\n  return viewMatrix;\n}\n\nexport type OrbitViewportOptions = {\n  /** Name of the viewport */\n  id?: string;\n  /** Left offset from the canvas edge, in pixels */\n  x?: number;\n  /** Top offset from the canvas edge, in pixels */\n  y?: number;\n  /** Viewport width in pixels */\n  width?: number;\n  /** Viewport height in pixels */\n  height?: number;\n  /** Axis with 360 degrees rotating freedom, either `'Y'` or `'Z'`, default to `'Z'`. */\n  orbitAxis?: 'Y' | 'Z';\n  /** The world position at the center of the viewport. Default `[0, 0, 0]`. */\n  target?: [number, number, number];\n  /** The zoom level of the viewport. `zoom: 0` maps one unit distance to one pixel on screen, and increasing `zoom` by `1` scales the same object to twice as large. Default `0`. */\n  zoom?: number;\n  /** Rotating angle around orbit axis. Default `0`. */\n  rotationOrbit?: number;\n  /** Rotating angle around orbit axis. Default `0`. */\n  rotationX?: number;\n  /** Custom projection matrix */\n  projectionMatrix?: number[];\n  /** Field of view covered by camera, in the perspective case. In degrees. Default `50`. */\n  fovy?: number;\n  /** Distance of near clipping plane. Default `0.1`. */\n  near?: number;\n  /** Distance of far clipping plane. Default `1000`. */\n  far?: number;\n  /** Whether to create an orthographic or perspective projection matrix. Default is `false` (perspective projection). */\n  orthographic?: boolean;\n};\n\nexport default class OrbitViewport extends Viewport {\n  projectedCenter: number[];\n\n  constructor(props: OrbitViewportOptions) {\n    const {\n      height,\n\n      projectionMatrix,\n\n      fovy = 50, // For setting camera position\n      orbitAxis = 'Z', // Orbit axis with 360 degrees rotating freedom, can only be 'Y' or 'Z'\n      target = [0, 0, 0], // Which point is camera looking at, default origin\n\n      rotationX = 0, // Rotating angle around X axis\n      rotationOrbit = 0, // Rotating angle around orbit axis\n\n      zoom = 0\n    } = props;\n\n    const focalDistance = projectionMatrix ? projectionMatrix[5] / 2 : fovyToAltitude(fovy);\n\n    super({\n      ...props,\n      // in case viewState contains longitude/latitude values,\n      // make sure that the base Viewport class does not treat this as a geospatial viewport\n      longitude: undefined,\n      viewMatrix: getViewMatrix({\n        height: height || 1,\n        focalDistance,\n        orbitAxis,\n        rotationX,\n        rotationOrbit,\n        zoom\n      }),\n      fovy,\n      focalDistance,\n      position: target,\n      zoom\n    });\n\n    this.projectedCenter = this.project(this.center);\n  }\n\n  unproject(xyz: number[], {topLeft = true}: {topLeft?: boolean} = {}): [number, number, number] {\n    const [x, y, z = this.projectedCenter[2]] = xyz;\n\n    const y2 = topLeft ? y : this.height - y;\n    const [X, Y, Z] = pixelsToWorld([x, y2, z], this.pixelUnprojectionMatrix);\n    return [X, Y, Z];\n  }\n\n  panByPosition(coords: number[], pixel: number[]): OrbitViewportOptions {\n    const p0 = this.project(coords);\n    const nextCenter = [\n      this.width / 2 + p0[0] - pixel[0],\n      this.height / 2 + p0[1] - pixel[1],\n      this.projectedCenter[2]\n    ];\n    return {\n      target: this.unproject(nextCenter)\n    };\n  }\n}\n","export default function _defineProperty(obj, key, value) {\n  if (key in obj) {\n    Object.defineProperty(obj, key, {\n      value: value,\n      enumerable: true,\n      configurable: true,\n      writable: true\n    });\n  } else {\n    obj[key] = value;\n  }\n\n  return obj;\n}","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport Vector3 from './vector3';\nimport { formatValue, equals, config } from '../lib/common';\nimport { degrees, radians, clamp } from '../lib/common';\nimport * as vec3 from 'gl-matrix/vec3';\nconst EPSILON = 0.000001;\nconst EARTH_RADIUS_METERS = 6371000;\nexport default class SphericalCoordinates {\n  constructor({\n    phi = 0,\n    theta = 0,\n    radius = 1,\n    bearing,\n    pitch,\n    altitude,\n    radiusScale = EARTH_RADIUS_METERS\n  } = {}) {\n    _defineProperty(this, \"phi\", void 0);\n\n    _defineProperty(this, \"theta\", void 0);\n\n    _defineProperty(this, \"radius\", void 0);\n\n    _defineProperty(this, \"radiusScale\", void 0);\n\n    this.phi = phi;\n    this.theta = theta;\n    this.radius = radius || altitude || 1;\n    this.radiusScale = radiusScale || 1;\n\n    if (bearing !== undefined) {\n      this.bearing = bearing;\n    }\n\n    if (pitch !== undefined) {\n      this.pitch = pitch;\n    }\n\n    this.check();\n  }\n\n  toString() {\n    return this.formatString(config);\n  }\n\n  formatString({\n    printTypes = false\n  }) {\n    const f = formatValue;\n    return \"\".concat(printTypes ? 'Spherical' : '', \"[rho:\").concat(f(this.radius), \",theta:\").concat(f(this.theta), \",phi:\").concat(f(this.phi), \"]\");\n  }\n\n  equals(other) {\n    return equals(this.radius, other.radius) && equals(this.theta, other.theta) && equals(this.phi, other.phi);\n  }\n\n  exactEquals(other) {\n    return this.radius === other.radius && this.theta === other.theta && this.phi === other.phi;\n  }\n\n  get bearing() {\n    return 180 - degrees(this.phi);\n  }\n\n  set bearing(v) {\n    this.phi = Math.PI - radians(v);\n  }\n\n  get pitch() {\n    return degrees(this.theta);\n  }\n\n  set pitch(v) {\n    this.theta = radians(v);\n  }\n\n  get longitude() {\n    return degrees(this.phi);\n  }\n\n  get latitude() {\n    return degrees(this.theta);\n  }\n\n  get lng() {\n    return degrees(this.phi);\n  }\n\n  get lat() {\n    return degrees(this.theta);\n  }\n\n  get z() {\n    return (this.radius - 1) * this.radiusScale;\n  }\n\n  set(radius, phi, theta) {\n    this.radius = radius;\n    this.phi = phi;\n    this.theta = theta;\n    return this.check();\n  }\n\n  clone() {\n    return new SphericalCoordinates().copy(this);\n  }\n\n  copy(other) {\n    this.radius = other.radius;\n    this.phi = other.phi;\n    this.theta = other.theta;\n    return this.check();\n  }\n\n  fromLngLatZ([lng, lat, z]) {\n    this.radius = 1 + z / this.radiusScale;\n    this.phi = radians(lat);\n    this.theta = radians(lng);\n    return this.check();\n  }\n\n  fromVector3(v) {\n    this.radius = vec3.length(v);\n\n    if (this.radius > 0) {\n      this.theta = Math.atan2(v[0], v[1]);\n      this.phi = Math.acos(clamp(v[2] / this.radius, -1, 1));\n    }\n\n    return this.check();\n  }\n\n  toVector3() {\n    return new Vector3(0, 0, this.radius).rotateX({\n      radians: this.theta\n    }).rotateZ({\n      radians: this.phi\n    });\n  }\n\n  makeSafe() {\n    this.phi = Math.max(EPSILON, Math.min(Math.PI - EPSILON, this.phi));\n    return this;\n  }\n\n  check() {\n    if (!Number.isFinite(this.phi) || !Number.isFinite(this.theta) || !(this.radius > 0)) {\n      throw new Error('SphericalCoordinates: some fields set to invalid numbers');\n    }\n\n    return this;\n  }\n\n}\n//# sourceMappingURL=spherical-coordinates.js.map","import Viewport from '../viewports/viewport';\nimport {getMeterZoom} from '@math.gl/web-mercator';\nimport {Matrix4, _SphericalCoordinates as SphericalCoordinates} from '@math.gl/core';\n\nexport type FirstPersonViewportOptions = {\n  /** Name of the viewport */\n  id?: string;\n  /** Left offset from the canvas edge, in pixels */\n  x?: number;\n  /** Top offset from the canvas edge, in pixels */\n  y?: number;\n  /** Viewport width in pixels */\n  width?: number;\n  /** Viewport height in pixels */\n  height?: number;\n  /** Longitude of the camera, in the geospatial case. */\n  longitude?: number;\n  /** Latitude of the camera, in the geospatial case. */\n  latitude?: number;\n  /** Meter offsets of the camera from the lng-lat anchor point. Default `[0, 0, 0]`. */\n  position?: [number, number, number];\n  /** Bearing (heading) of the camera in degrees. Default `0` (north). */\n  bearing?: number;\n  /** Pitch (tilt) of the camera in degrees. Default `0` (horizontal). */\n  pitch?: number;\n  /** Transform applied to the camera position and direction */\n  modelMatrix?: number[] | null;\n  /** Custom projection matrix */\n  projectionMatrix?: number[];\n  /** The up direction, default positive z axis. */\n  up?: [number, number, number];\n  /** Field of view covered by camera, in degrees. Default `75`. */\n  fovy?: number;\n  /** Distance of near clipping plane. Default `0.1`. */\n  near?: number;\n  /** Distance of far clipping plane. Default `1000`. */\n  far?: number;\n  /** Modifier of viewport scale. Corresponds to the number of pixels per meter. Default `1`. */\n  focalDistance?: number;\n};\n\nexport default class FirstPersonViewport extends Viewport {\n  longitude?: number;\n  latitude?: number;\n\n  constructor(props: FirstPersonViewportOptions) {\n    // TODO - push direction handling into Matrix4.lookAt\n    const {longitude, latitude, modelMatrix, bearing = 0, pitch = 0, up = [0, 0, 1]} = props;\n\n    // Always calculate direction from bearing and pitch\n    const spherical = new SphericalCoordinates({\n      bearing,\n      // Avoid \"pixel project matrix not invertible\" error\n      pitch: pitch === -90 ? 0.0001 : 90 + pitch\n    });\n    const dir = spherical.toVector3().normalize();\n\n    // Direction is relative to model coordinates, of course\n    const center = modelMatrix ? new Matrix4(modelMatrix).transformAsVector(dir) : dir;\n\n    // Just the direction. All the positioning is done in viewport.js\n    const zoom = Number.isFinite(latitude) ? getMeterZoom({latitude: latitude as number}) : 0;\n    const scale = Math.pow(2, zoom);\n    const viewMatrix = new Matrix4().lookAt({eye: [0, 0, 0], center, up}).scale(scale);\n\n    super({\n      ...props,\n      zoom,\n      viewMatrix\n    });\n\n    this.latitude = latitude;\n    this.longitude = longitude;\n  }\n}\n","import Controller from './controller';\nimport ViewState from './view-state';\nimport {mod} from '../utils/math-utils';\nimport LinearInterpolator from '../transitions/linear-interpolator';\n\nimport {Vector3, _SphericalCoordinates as SphericalCoordinates, clamp} from '@math.gl/core';\n\nconst MOVEMENT_SPEED = 20;\n\ntype FirstPersonStateProps = {\n  width: number;\n  height: number;\n\n  position?: number[];\n  bearing?: number;\n  pitch?: number;\n\n  // Geospatial anchor\n  longitude?: number | null;\n  latitude?: number | null;\n\n  maxPitch?: number;\n  minPitch?: number;\n};\n\ntype FirstPersonStateInternal = {\n  startRotatePos?: [number, number];\n  startBearing?: number;\n  startPitch?: number;\n  startZoomPosition?: number[];\n};\n\nclass FirstPersonState extends ViewState<\n  FirstPersonState,\n  FirstPersonStateProps,\n  FirstPersonStateInternal\n> {\n  constructor(options: FirstPersonStateProps & FirstPersonStateInternal) {\n    const {\n      /* Viewport arguments */\n      width, // Width of viewport\n      height, // Height of viewport\n\n      // Position and orientation\n      position = [0, 0, 0], // typically in meters from anchor point\n\n      bearing = 0, // Rotation around y axis\n      pitch = 0, // Rotation around x axis\n\n      // Geospatial anchor\n      longitude = null,\n      latitude = null,\n\n      maxPitch = 90,\n      minPitch = -90,\n\n      // Model state when the rotate operation first started\n      startRotatePos,\n      startBearing,\n      startPitch,\n      startZoomPosition\n    } = options;\n\n    super(\n      {\n        width,\n        height,\n        position,\n        bearing,\n        pitch,\n        longitude,\n        latitude,\n        maxPitch,\n        minPitch\n      },\n      {\n        startRotatePos,\n        startBearing,\n        startPitch,\n        startZoomPosition\n      }\n    );\n  }\n\n  /* Public API */\n\n  /**\n   * Start panning\n   * @param {[Number, Number]} pos - position on screen where the pointer grabs\n   */\n  panStart(): FirstPersonState {\n    return this;\n  }\n\n  /**\n   * Pan\n   * @param {[Number, Number]} pos - position on screen where the pointer is\n   */\n  pan(): FirstPersonState {\n    return this;\n  }\n\n  /**\n   * End panning\n   * Must call if `panStart()` was called\n   */\n  panEnd(): FirstPersonState {\n    return this;\n  }\n\n  /**\n   * Start rotating\n   * @param {[Number, Number]} pos - position on screen where the pointer grabs\n   */\n  rotateStart({pos}: {pos: [number, number]}): FirstPersonState {\n    return this._getUpdatedState({\n      startRotatePos: pos,\n      startBearing: this.getViewportProps().bearing,\n      startPitch: this.getViewportProps().pitch\n    });\n  }\n\n  /**\n   * Rotate\n   * @param {[Number, Number]} pos - position on screen where the pointer is\n   */\n  rotate({\n    pos,\n    deltaAngleX = 0,\n    deltaAngleY = 0\n  }: {\n    pos?: [number, number];\n    deltaAngleX?: number;\n    deltaAngleY: number;\n  }): FirstPersonState {\n    const {startRotatePos, startBearing, startPitch} = this.getState();\n    const {width, height} = this.getViewportProps();\n\n    if (!startRotatePos || startBearing === undefined || startPitch === undefined) {\n      return this;\n    }\n\n    let newRotation;\n    if (pos) {\n      const deltaScaleX = (pos[0] - startRotatePos[0]) / width;\n      const deltaScaleY = (pos[1] - startRotatePos[1]) / height;\n      newRotation = {\n        bearing: startBearing - deltaScaleX * 180,\n        pitch: startPitch - deltaScaleY * 90\n      };\n    } else {\n      newRotation = {\n        bearing: startBearing - deltaAngleX,\n        pitch: startPitch - deltaAngleY\n      };\n    }\n\n    return this._getUpdatedState(newRotation);\n  }\n\n  /**\n   * End rotating\n   * Must call if `rotateStart()` was called\n   */\n  rotateEnd(): FirstPersonState {\n    return this._getUpdatedState({\n      startRotatePos: null,\n      startBearing: null,\n      startPitch: null\n    });\n  }\n\n  /**\n   * Start zooming\n   * @param {[Number, Number]} pos - position on screen where the pointer grabs\n   */\n  zoomStart(): FirstPersonState {\n    return this._getUpdatedState({\n      startZoomPosition: this.getViewportProps().position\n    });\n  }\n\n  /**\n   * Zoom\n   * @param {[Number, Number]} pos - position on screen where the current center is\n   * @param {[Number, Number]} startPos - the center position at\n   *   the start of the operation. Must be supplied of `zoomStart()` was not called\n   * @param {Number} scale - a number between [0, 1] specifying the accumulated\n   *   relative scale.\n   */\n  zoom({scale}: {scale: number}): FirstPersonState {\n    let {startZoomPosition} = this.getState();\n    if (!startZoomPosition) {\n      startZoomPosition = this.getViewportProps().position;\n    }\n\n    const direction = this.getDirection();\n    return this._move(direction, Math.log2(scale) * MOVEMENT_SPEED, startZoomPosition);\n  }\n\n  /**\n   * End zooming\n   * Must call if `zoomStart()` was called\n   */\n  zoomEnd(): FirstPersonState {\n    return this._getUpdatedState({\n      startZoomPosition: null\n    });\n  }\n\n  moveLeft(speed: number = MOVEMENT_SPEED): FirstPersonState {\n    const direction = this.getDirection(true);\n    return this._move(direction.rotateZ({radians: Math.PI / 2}), speed);\n  }\n\n  moveRight(speed: number = MOVEMENT_SPEED): FirstPersonState {\n    const direction = this.getDirection(true);\n    return this._move(direction.rotateZ({radians: -Math.PI / 2}), speed);\n  }\n\n  // forward\n  moveUp(speed: number = MOVEMENT_SPEED): FirstPersonState {\n    const direction = this.getDirection(true);\n    return this._move(direction, speed);\n  }\n\n  // backward\n  moveDown(speed: number = MOVEMENT_SPEED): FirstPersonState {\n    const direction = this.getDirection(true);\n    return this._move(direction.negate(), speed);\n  }\n\n  rotateLeft(speed: number = 15): FirstPersonState {\n    return this._getUpdatedState({\n      bearing: this.getViewportProps().bearing - speed\n    });\n  }\n\n  rotateRight(speed: number = 15): FirstPersonState {\n    return this._getUpdatedState({\n      bearing: this.getViewportProps().bearing + speed\n    });\n  }\n\n  rotateUp(speed: number = 10): FirstPersonState {\n    return this._getUpdatedState({\n      pitch: this.getViewportProps().pitch + speed\n    });\n  }\n\n  rotateDown(speed: number = 10): FirstPersonState {\n    return this._getUpdatedState({\n      pitch: this.getViewportProps().pitch - speed\n    });\n  }\n\n  zoomIn(speed: number = 2): FirstPersonState {\n    return this.zoom({scale: speed});\n  }\n\n  zoomOut(speed: number = 2): FirstPersonState {\n    return this.zoom({scale: 1 / speed});\n  }\n\n  // shortest path between two view states\n  shortestPathFrom(viewState: FirstPersonState) {\n    const fromProps = viewState.getViewportProps();\n    const props = {...this.getViewportProps()};\n    const {bearing, longitude} = props;\n\n    if (Math.abs(bearing - fromProps.bearing) > 180) {\n      props.bearing = bearing < 0 ? bearing + 360 : bearing - 360;\n    }\n    if (\n      longitude !== null &&\n      fromProps.longitude !== null &&\n      Math.abs(longitude - fromProps.longitude) > 180\n    ) {\n      props.longitude = longitude < 0 ? longitude + 360 : longitude - 360;\n    }\n    return props;\n  }\n\n  /* Private methods */\n  _move(\n    direction: Vector3,\n    speed: number,\n    fromPosition: number[] = this.getViewportProps().position\n  ) {\n    const delta = direction.scale(speed);\n    return this._getUpdatedState({\n      position: new Vector3(fromPosition).add(delta)\n    });\n  }\n\n  getDirection(use2D: boolean = false): Vector3 {\n    const spherical = new SphericalCoordinates({\n      bearing: this.getViewportProps().bearing,\n      pitch: use2D ? 90 : 90 + this.getViewportProps().pitch\n    });\n    const direction = spherical.toVector3().normalize();\n    return direction;\n  }\n\n  _getUpdatedState(newProps: Record<string, any>): FirstPersonState {\n    // Update _viewportProps\n    return new FirstPersonState({...this.getViewportProps(), ...this.getState(), ...newProps});\n  }\n\n  // Apply any constraints (mathematical or defined by _viewportProps) to map state\n  applyConstraints(props: Required<FirstPersonStateProps>): Required<FirstPersonStateProps> {\n    // Ensure pitch and zoom are within specified range\n    const {pitch, maxPitch, minPitch, longitude, bearing} = props;\n    props.pitch = clamp(pitch, minPitch, maxPitch);\n\n    // Normalize degrees\n    if (longitude !== null && (longitude < -180 || longitude > 180)) {\n      props.longitude = mod(longitude + 180, 360) - 180;\n    }\n    if (bearing < -180 || bearing > 180) {\n      props.bearing = mod(bearing + 180, 360) - 180;\n    }\n\n    return props;\n  }\n}\n\nexport default class FirstPersonController extends Controller<FirstPersonState> {\n  ControllerState = FirstPersonState;\n\n  transition = {\n    transitionDuration: 300,\n    transitionInterpolator: new LinearInterpolator(['position', 'pitch', 'bearing'])\n  };\n}\n","import View, {CommonViewState} from './view';\nimport FirstPersonViewport from '../viewports/first-person-viewport';\nimport FirstPersonController from '../controllers/first-person-controller';\n\nexport type FirstPersonViewState = {\n  /** Longitude of the camera, in the geospatial case. */\n  longitude?: number;\n  /** Latitude of the camera, in the geospatial case. */\n  latitude?: number;\n  /** Meter offsets of the camera from the lng-lat anchor point. Default `[0, 0, 0]`. */\n  position?: [number, number, number];\n  /** Bearing (heading) of the camera in degrees. Default `0` (north). */\n  bearing?: number;\n  /** Pitch (tilt) of the camera in degrees. Default `0` (horizontal). */\n  pitch?: number;\n  /** Min pitch angle. Default `-90` (up). */\n  minPitch?: number;\n  /** Max pitch angle. Default `90` (down). */\n  maxPitch?: number;\n  /** Transform applied to the camera position and direction */\n  modelMatrix?: number[] | null;\n} & CommonViewState;\n\ntype FirstPersonViewProps = {\n  /** Custom projection matrix */\n  projectionMatrix?: number[];\n  /** Field of view covered by camera, in degrees. Default `75`. */\n  fovy?: number;\n  /** Distance of near clipping plane. Default `0.1`. */\n  near?: number;\n  /** Distance of far clipping plane. Default `1000`. */\n  far?: number;\n  /** Modifier of viewport scale. Corresponds to the number of pixels per meter. Default `1`. */\n  focalDistance?: number;\n};\n\nexport default class FirstPersonView extends View<FirstPersonViewState, FirstPersonViewProps> {\n  static displayName = 'FirstPersonView';\n\n  get ViewportType() {\n    return FirstPersonViewport;\n  }\n\n  get ControllerType() {\n    return FirstPersonController;\n  }\n}\n","import View, {CommonViewState} from './view';\nimport OrbitViewport from '../viewports/orbit-viewport';\nimport OrbitController from '../controllers/orbit-controller';\n\nexport type OrbitViewState = {\n  /** The world position at the center of the viewport. Default `[0, 0, 0]`. */\n  target: [number, number, number];\n  /** The zoom level of the viewport. `zoom: 0` maps one unit distance to one pixel on screen, and increasing `zoom` by `1` scales the same object to twice as large. Default `0`. */\n  zoom: number;\n  /** Rotating angle around orbit axis. Default `0`. */\n  rotationOrbit?: number;\n  /** Rotating angle around orbit axis. Default `0`. */\n  rotationX?: number;\n  /** The min zoom level of the viewport. Default `-Infinity`. */\n  minZoom?: number;\n  /** The max zoom level of the viewport. Default `Infinity`. */\n  maxZoom?: number;\n  /** The min rotating angle around X axis. Default `-90`. */\n  minRotationX?: number;\n  /** The max rotating angle around X axis. Default `90`. */\n  maxRotationX?: number;\n} & CommonViewState;\n\ntype OrbitViewProps = {\n  /** Axis with 360 degrees rotating freedom, either `'Y'` or `'Z'`, default to `'Z'`. */\n  orbitAxis?: 'Y' | 'Z';\n  /** Custom projection matrix */\n  projectionMatrix?: number[];\n  /** Field of view covered by camera, in the perspective case. In degrees. Default `50`. */\n  fovy?: number;\n  /** Distance of near clipping plane. Default `0.1`. */\n  near?: number;\n  /** Distance of far clipping plane. Default `1000`. */\n  far?: number;\n  /** Whether to create an orthographic or perspective projection matrix. Default is `false` (perspective projection). */\n  orthographic?: boolean;\n};\n\nexport default class OrbitView extends View<OrbitViewState, OrbitViewProps> {\n  static displayName = 'OrbitView';\n\n  constructor(props: OrbitViewProps = {}) {\n    super(props);\n    this.props.orbitAxis = props.orbitAxis || 'Z';\n  }\n\n  get ViewportType() {\n    return OrbitViewport;\n  }\n\n  get ControllerType() {\n    return OrbitController;\n  }\n}\n","import {clamp} from '@math.gl/core';\nimport Controller, {ControllerProps} from './controller';\n\nimport {MapState, MapStateProps} from './map-controller';\nimport {mod} from '../utils/math-utils';\nimport LinearInterpolator from '../transitions/linear-interpolator';\n\nclass GlobeState extends MapState {\n  // Apply any constraints (mathematical or defined by _viewportProps) to map state\n  applyConstraints(props: Required<MapStateProps>): Required<MapStateProps> {\n    // Ensure zoom is within specified range\n    const {maxZoom, minZoom, zoom} = props;\n    props.zoom = clamp(zoom, minZoom, maxZoom);\n\n    const {longitude, latitude} = props;\n    if (longitude < -180 || longitude > 180) {\n      props.longitude = mod(longitude + 180, 360) - 180;\n    }\n    props.latitude = clamp(latitude, -89, 89);\n\n    return props;\n  }\n}\n\nexport default class GlobeController extends Controller<MapState> {\n  ControllerState = GlobeState;\n\n  transition = {\n    transitionDuration: 300,\n    transitionInterpolator: new LinearInterpolator(['longitude', 'latitude', 'zoom'])\n  };\n\n  dragMode: 'pan' | 'rotate' = 'pan';\n\n  setProps(props: ControllerProps) {\n    super.setProps(props);\n\n    // TODO - support pitching?\n    this.dragRotate = false;\n    this.touchRotate = false;\n  }\n}\n","import View, {CommonViewState} from './view';\nimport GlobeViewport from '../viewports/globe-viewport';\nimport GlobeController from '../controllers/globe-controller';\n\nexport type GlobeViewState = {\n  /** Longitude of the map center */\n  longitude: number;\n  /** Latitude of the map center */\n  latitude: number;\n  /** Zoom level */\n  zoom: number;\n  /** Min zoom, default `0` */\n  minZoom?: number;\n  /** Max zoom, default `20` */\n  maxZoom?: number;\n} & CommonViewState;\n\ntype GlobeViewProps = {\n  /** The resolution at which to turn flat features into 3D meshes, in degrees. Smaller numbers will generate more detailed mesh. Default `10`. */\n  resolution?: number;\n  /** Scaler for the near plane, 1 unit equals to the height of the viewport. Default to `0.1`. Overwrites the `near` parameter. */\n  nearZMultiplier?: boolean;\n  /** Scaler for the far plane, 1 unit equals to the distance from the camera to the top edge of the screen. Default to `1.01`. Overwrites the `far` parameter. */\n  farZMultiplier?: boolean;\n  /** Distance of the camera relative to viewport height. Default `1.5`. */\n  altitude?: number;\n};\n\nexport default class GlobeView extends View<GlobeViewState, GlobeViewProps> {\n  static displayName = 'GlobeView';\n\n  get ViewportType() {\n    return GlobeViewport;\n  }\n\n  get ControllerType() {\n    return GlobeController;\n  }\n}\n","import TransitionInterpolator from './transition-interpolator';\nimport {lerp} from '@math.gl/core';\n\nimport {flyToViewport, getFlyToDuration} from '@math.gl/web-mercator';\n\nconst LINEARLY_INTERPOLATED_PROPS = ['bearing', 'pitch'];\nconst DEFAULT_OPTS = {\n  speed: 1.2,\n  curve: 1.414\n};\n\n/**\n * This class adapts mapbox-gl-js Map#flyTo animation so it can be used in\n * react/redux architecture.\n * mapbox-gl-js flyTo : https://www.mapbox.com/mapbox-gl-js/api/#map#flyto.\n * It implements “Smooth and efficient zooming and panning.” algorithm by\n * \"Jarke J. van Wijk and Wim A.A. Nuij\"\n */\nexport default class FlyToInterpolator extends TransitionInterpolator {\n  opts: {\n    curve: number;\n    speed: number;\n    screenSpeed?: number;\n    maxDuration?: number;\n  };\n\n  constructor(\n    opts: {\n      /** The zooming \"curve\" that will occur along the flight path. Default 1.414 */\n      curve?: number;\n      /** The average speed of the animation defined in relation to `options.curve`, it linearly affects the duration, higher speed returns smaller durations and vice versa. Default 1.2 */\n      speed?: number;\n      /** The average speed of the animation measured in screenfuls per second. Similar to `opts.speed` it linearly affects the duration,  when specified `opts.speed` is ignored. */\n      screenSpeed?: number;\n      /** Maximum duration in milliseconds, if calculated duration exceeds this value, `0` is returned. */\n      maxDuration?: number;\n    } = {}\n  ) {\n    super({\n      compare: ['longitude', 'latitude', 'zoom', 'bearing', 'pitch'],\n      extract: ['width', 'height', 'longitude', 'latitude', 'zoom', 'bearing', 'pitch'],\n      required: ['width', 'height', 'latitude', 'longitude', 'zoom']\n    });\n    this.opts = {...DEFAULT_OPTS, ...opts};\n  }\n\n  interpolateProps(startProps, endProps, t) {\n    const viewport = flyToViewport(startProps, endProps, t, this.opts);\n\n    // Linearly interpolate 'bearing' and 'pitch'.\n    // If pitch/bearing are not supplied, they are interpreted as zeros in viewport calculation\n    // (fallback defined in WebMercatorViewport)\n    // Because there is no guarantee that the current controller's ViewState normalizes\n    // these props, safe guard is needed to avoid generating NaNs\n    for (const key of LINEARLY_INTERPOLATED_PROPS) {\n      viewport[key] = lerp(startProps[key] || 0, endProps[key] || 0, t);\n    }\n\n    return viewport;\n  }\n\n  // computes the transition duration\n  getDuration(startProps, endProps) {\n    let {transitionDuration} = endProps;\n    if (transitionDuration === 'auto') {\n      // auto calculate duration based on start and end props\n      transitionDuration = getFlyToDuration(startProps, endProps, this.opts);\n    }\n    return transitionDuration;\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n/* eslint-disable max-len */\n\n// Intialize globals, check version\nimport './lib/init';\n\n// Import shaderlib to make sure shader modules are initialized\nimport './shaderlib';\n\n// Core Library\nexport {COORDINATE_SYSTEM, OPERATION, UNIT} from './lib/constants';\n\n// Effects\nexport {default as LightingEffect} from './effects/lighting/lighting-effect';\nexport {AmbientLight} from './effects/lighting/ambient-light';\nexport {DirectionalLight} from './effects/lighting/directional-light';\nexport {PointLight} from './effects/lighting/point-light';\nexport {default as _CameraLight} from './effects/lighting/camera-light';\nexport {default as _SunLight} from './effects/lighting/sun-light';\nexport {default as PostProcessEffect} from './effects/post-process-effect';\n\n// Passes\nexport {default as _LayersPass} from './passes/layers-pass';\n\n// Experimental Pure JS (non-React) bindings\nexport {default as Deck} from './lib/deck';\n\nexport {default as LayerManager} from './lib/layer-manager';\nexport {default as AttributeManager} from './lib/attribute/attribute-manager';\nexport {default as Layer} from './lib/layer';\nexport {default as CompositeLayer} from './lib/composite-layer';\nexport {default as DeckRenderer} from './lib/deck-renderer';\n\n// Viewports\nexport {default as Viewport} from './viewports/viewport';\nexport {default as WebMercatorViewport} from './viewports/web-mercator-viewport';\nexport {default as _GlobeViewport} from './viewports/globe-viewport';\nexport {default as OrbitViewport} from './viewports/orbit-viewport';\nexport {default as OrthographicViewport} from './viewports/orthographic-viewport';\nexport {default as FirstPersonViewport} from './viewports/first-person-viewport';\n\n// Shader modules\nexport {picking, project, project32, gouraudLighting, phongLighting, shadow} from './shaderlib';\n\nexport {default as View} from './views/view';\nexport {default as MapView} from './views/map-view';\nexport {default as FirstPersonView} from './views/first-person-view';\nexport {default as OrbitView} from './views/orbit-view';\nexport {default as OrthographicView} from './views/orthographic-view';\nexport {default as _GlobeView} from './views/globe-view';\n\n// Controllers\nexport {default as Controller} from './controllers/controller';\nexport {default as MapController} from './controllers/map-controller';\nexport {default as _GlobeController} from './controllers/globe-controller';\nexport {default as FirstPersonController} from './controllers/first-person-controller';\nexport {default as OrbitController} from './controllers/orbit-controller';\nexport {default as OrthographicController} from './controllers/orthographic-controller';\n\n// Extensions interface\nexport {default as LayerExtension} from './lib/layer-extension';\n\n// Transitions\nexport {TRANSITION_EVENTS} from './controllers/transition-manager';\nexport {default as TransitionInterpolator} from './transitions/transition-interpolator';\nexport {default as LinearInterpolator} from './transitions/linear-interpolator';\nexport {default as FlyToInterpolator} from './transitions/fly-to-interpolator';\n\n// Layer utilities\nexport {default as log} from './utils/log';\nexport {default as assert} from './utils/assert';\nexport {createIterable} from './utils/iterable-utils';\nexport {fp64LowPart} from './utils/math-utils';\nexport {default as Tesselator} from './utils/tesselator'; // Export? move to luma.gl or math.gl?\n\n// Experimental utilities\nexport {fillArray as _fillArray, flatten as _flatten} from './utils/flatten'; // Export? move to luma.gl or math.gl?\nexport {count as _count} from './utils/count';\nexport {default as _memoize} from './utils/memoize';\nexport {mergeShaders as _mergeShaders} from './utils/shader';\nexport {compareProps as _compareProps} from './lifecycle/props';\n\n// Types\nexport type {CoordinateSystem} from './lib/constants';\nexport type {MapViewState} from './views/map-view';\nexport type {FirstPersonViewState} from './views/first-person-view';\nexport type {OrbitViewState} from './views/orbit-view';\nexport type {OrthographicViewState} from './views/orthographic-view';\nexport type {GlobeViewState} from './views/globe-view';\nexport type {ChangeFlags} from './lib/layer-state';\nexport type {LayersList} from './lib/layer-manager';\nexport type {LayerContext} from './lib/layer-manager';\nexport type {UpdateParameters} from './lib/layer';\nexport type {DeckProps} from './lib/deck';\nexport type {\n  LayerProps,\n  CompositeLayerProps,\n  Accessor,\n  AccessorFunction,\n  LayerData,\n  Unit,\n  Position,\n  Color,\n  Texture,\n  Material\n} from './types/layer-props';\nexport type {FilterContext} from './passes/layers-pass';\nexport type {PickingInfo, GetPickingInfoParams} from './lib/picking/pick-info';\nexport type {ConstructorOf as _ConstructorOf, ShaderModule as _ShaderModule} from './types/types';\nexport type {BinaryAttribute} from './lib/attribute/attribute';\nexport type {Effect} from './lib/effect';\nexport type {PickingUniforms, ProjectUniforms} from './shaderlib';\nexport type {DefaultProps} from './lifecycle/prop-types';\n","export default function _typeof(obj) {\n  \"@babel/helpers - typeof\";\n\n  return _typeof = \"function\" == typeof Symbol && \"symbol\" == typeof Symbol.iterator ? function (obj) {\n    return typeof obj;\n  } : function (obj) {\n    return obj && \"function\" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj;\n  }, _typeof(obj);\n}","import _typeof from \"./typeof.js\";\nimport toPrimitive from \"./toPrimitive.js\";\nexport default function _toPropertyKey(arg) {\n  var key = toPrimitive(arg, \"string\");\n  return _typeof(key) === \"symbol\" ? key : String(key);\n}","import _typeof from \"./typeof.js\";\nexport default function _toPrimitive(input, hint) {\n  if (_typeof(input) !== \"object\" || input === null) return input;\n  var prim = input[Symbol.toPrimitive];\n  if (prim !== undefined) {\n    var res = prim.call(input, hint || \"default\");\n    if (_typeof(res) !== \"object\") return res;\n    throw new TypeError(\"@@toPrimitive must return a primitive value.\");\n  }\n  return (hint === \"string\" ? String : Number)(input);\n}","import toPropertyKey from \"./toPropertyKey.js\";\nexport default function _defineProperty(obj, key, value) {\n  key = toPropertyKey(key);\n  if (key in obj) {\n    Object.defineProperty(obj, key, {\n      value: value,\n      enumerable: true,\n      configurable: true,\n      writable: true\n    });\n  } else {\n    obj[key] = value;\n  }\n  return obj;\n}","import { transformMat4, scale } from 'gl-matrix/vec4';\nexport function createMat4() {\n  return [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];\n}\nexport function transformVector(matrix, vector) {\n  const result = transformMat4([], vector, matrix);\n  scale(result, result, 1 / result[3]);\n  return result;\n}\nexport function mod(value, divisor) {\n  const modulus = value % divisor;\n  return modulus < 0 ? divisor + modulus : modulus;\n}\nexport function lerp(start, end, step) {\n  return step * end + (1 - step) * start;\n}\nexport function clamp(x, min, max) {\n  return x < min ? min : x > max ? max : x;\n}\n\nfunction ieLog2(x) {\n  return Math.log(x) * Math.LOG2E;\n}\n\nexport const log2 = Math.log2 || ieLog2;\n//# sourceMappingURL=math-utils.js.map","export default function assert(condition, message) {\n  if (!condition) {\n    throw new Error(message || '@math.gl/web-mercator: assertion failed.');\n  }\n}\n//# sourceMappingURL=assert.js.map","import { createMat4, transformVector, clamp, log2 } from './math-utils';\nimport * as mat4 from 'gl-matrix/mat4';\nimport * as vec2 from 'gl-matrix/vec2';\nimport * as vec3 from 'gl-matrix/vec3';\nimport assert from './assert';\nconst PI = Math.PI;\nconst PI_4 = PI / 4;\nconst DEGREES_TO_RADIANS = PI / 180;\nconst RADIANS_TO_DEGREES = 180 / PI;\nconst TILE_SIZE = 512;\nconst EARTH_CIRCUMFERENCE = 40.03e6;\nexport const MAX_LATITUDE = 85.051129;\nexport const DEFAULT_ALTITUDE = 1.5;\nexport function zoomToScale(zoom) {\n  return Math.pow(2, zoom);\n}\nexport function scaleToZoom(scale) {\n  return log2(scale);\n}\nexport function lngLatToWorld(lngLat) {\n  const [lng, lat] = lngLat;\n  assert(Number.isFinite(lng));\n  assert(Number.isFinite(lat) && lat >= -90 && lat <= 90, 'invalid latitude');\n  const lambda2 = lng * DEGREES_TO_RADIANS;\n  const phi2 = lat * DEGREES_TO_RADIANS;\n  const x = TILE_SIZE * (lambda2 + PI) / (2 * PI);\n  const y = TILE_SIZE * (PI + Math.log(Math.tan(PI_4 + phi2 * 0.5))) / (2 * PI);\n  return [x, y];\n}\nexport function worldToLngLat(xy) {\n  const [x, y] = xy;\n  const lambda2 = x / TILE_SIZE * (2 * PI) - PI;\n  const phi2 = 2 * (Math.atan(Math.exp(y / TILE_SIZE * (2 * PI) - PI)) - PI_4);\n  return [lambda2 * RADIANS_TO_DEGREES, phi2 * RADIANS_TO_DEGREES];\n}\nexport function getMeterZoom(options) {\n  const {\n    latitude\n  } = options;\n  assert(Number.isFinite(latitude));\n  const latCosine = Math.cos(latitude * DEGREES_TO_RADIANS);\n  return scaleToZoom(EARTH_CIRCUMFERENCE * latCosine) - 9;\n}\nexport function unitsPerMeter(latitude) {\n  const latCosine = Math.cos(latitude * DEGREES_TO_RADIANS);\n  return TILE_SIZE / EARTH_CIRCUMFERENCE / latCosine;\n}\nexport function getDistanceScales(options) {\n  const {\n    latitude,\n    longitude,\n    highPrecision = false\n  } = options;\n  assert(Number.isFinite(latitude) && Number.isFinite(longitude));\n  const worldSize = TILE_SIZE;\n  const latCosine = Math.cos(latitude * DEGREES_TO_RADIANS);\n  const unitsPerDegreeX = worldSize / 360;\n  const unitsPerDegreeY = unitsPerDegreeX / latCosine;\n  const altUnitsPerMeter = worldSize / EARTH_CIRCUMFERENCE / latCosine;\n  const result = {\n    unitsPerMeter: [altUnitsPerMeter, altUnitsPerMeter, altUnitsPerMeter],\n    metersPerUnit: [1 / altUnitsPerMeter, 1 / altUnitsPerMeter, 1 / altUnitsPerMeter],\n    unitsPerDegree: [unitsPerDegreeX, unitsPerDegreeY, altUnitsPerMeter],\n    degreesPerUnit: [1 / unitsPerDegreeX, 1 / unitsPerDegreeY, 1 / altUnitsPerMeter]\n  };\n\n  if (highPrecision) {\n    const latCosine2 = DEGREES_TO_RADIANS * Math.tan(latitude * DEGREES_TO_RADIANS) / latCosine;\n    const unitsPerDegreeY2 = unitsPerDegreeX * latCosine2 / 2;\n    const altUnitsPerDegree2 = worldSize / EARTH_CIRCUMFERENCE * latCosine2;\n    const altUnitsPerMeter2 = altUnitsPerDegree2 / unitsPerDegreeY * altUnitsPerMeter;\n    result.unitsPerDegree2 = [0, unitsPerDegreeY2, altUnitsPerDegree2];\n    result.unitsPerMeter2 = [altUnitsPerMeter2, 0, altUnitsPerMeter2];\n  }\n\n  return result;\n}\nexport function addMetersToLngLat(lngLatZ, xyz) {\n  const [longitude, latitude, z0] = lngLatZ;\n  const [x, y, z] = xyz;\n  const {\n    unitsPerMeter,\n    unitsPerMeter2\n  } = getDistanceScales({\n    longitude,\n    latitude,\n    highPrecision: true\n  });\n  const worldspace = lngLatToWorld(lngLatZ);\n  worldspace[0] += x * (unitsPerMeter[0] + unitsPerMeter2[0] * y);\n  worldspace[1] += y * (unitsPerMeter[1] + unitsPerMeter2[1] * y);\n  const newLngLat = worldToLngLat(worldspace);\n  const newZ = (z0 || 0) + (z || 0);\n  return Number.isFinite(z0) || Number.isFinite(z) ? [newLngLat[0], newLngLat[1], newZ] : newLngLat;\n}\nexport function getViewMatrix(options) {\n  const {\n    height,\n    pitch,\n    bearing,\n    altitude,\n    scale,\n    center\n  } = options;\n  const vm = createMat4();\n  mat4.translate(vm, vm, [0, 0, -altitude]);\n  mat4.rotateX(vm, vm, -pitch * DEGREES_TO_RADIANS);\n  mat4.rotateZ(vm, vm, bearing * DEGREES_TO_RADIANS);\n  const relativeScale = scale / height;\n  mat4.scale(vm, vm, [relativeScale, relativeScale, relativeScale]);\n\n  if (center) {\n    mat4.translate(vm, vm, vec3.negate([], center));\n  }\n\n  return vm;\n}\nexport function getProjectionParameters(options) {\n  const {\n    width,\n    height,\n    altitude,\n    pitch = 0,\n    offset,\n    center,\n    scale,\n    nearZMultiplier = 1,\n    farZMultiplier = 1\n  } = options;\n  let {\n    fovy = altitudeToFovy(DEFAULT_ALTITUDE)\n  } = options;\n\n  if (altitude !== undefined) {\n    fovy = altitudeToFovy(altitude);\n  }\n\n  const fovRadians = fovy * DEGREES_TO_RADIANS;\n  const pitchRadians = pitch * DEGREES_TO_RADIANS;\n  const focalDistance = fovyToAltitude(fovy);\n  let cameraToSeaLevelDistance = focalDistance;\n\n  if (center) {\n    cameraToSeaLevelDistance += center[2] * scale / Math.cos(pitchRadians) / height;\n  }\n\n  const fovAboveCenter = fovRadians * (0.5 + (offset ? offset[1] : 0) / height);\n  const topHalfSurfaceDistance = Math.sin(fovAboveCenter) * cameraToSeaLevelDistance / Math.sin(clamp(Math.PI / 2 - pitchRadians - fovAboveCenter, 0.01, Math.PI - 0.01));\n  const furthestDistance = Math.sin(pitchRadians) * topHalfSurfaceDistance + cameraToSeaLevelDistance;\n  const horizonDistance = cameraToSeaLevelDistance * 10;\n  const farZ = Math.min(furthestDistance * farZMultiplier, horizonDistance);\n  return {\n    fov: fovRadians,\n    aspect: width / height,\n    focalDistance,\n    near: nearZMultiplier,\n    far: farZ\n  };\n}\nexport function getProjectionMatrix(options) {\n  const {\n    fov,\n    aspect,\n    near,\n    far\n  } = getProjectionParameters(options);\n  const projectionMatrix = mat4.perspective([], fov, aspect, near, far);\n  return projectionMatrix;\n}\nexport function altitudeToFovy(altitude) {\n  return 2 * Math.atan(0.5 / altitude) * RADIANS_TO_DEGREES;\n}\nexport function fovyToAltitude(fovy) {\n  return 0.5 / Math.tan(0.5 * fovy * DEGREES_TO_RADIANS);\n}\nexport function worldToPixels(xyz, pixelProjectionMatrix) {\n  const [x, y, z = 0] = xyz;\n  assert(Number.isFinite(x) && Number.isFinite(y) && Number.isFinite(z));\n  return transformVector(pixelProjectionMatrix, [x, y, z, 1]);\n}\nexport function pixelsToWorld(xyz, pixelUnprojectionMatrix, targetZ = 0) {\n  const [x, y, z] = xyz;\n  assert(Number.isFinite(x) && Number.isFinite(y), 'invalid pixel coordinate');\n\n  if (Number.isFinite(z)) {\n    const coord = transformVector(pixelUnprojectionMatrix, [x, y, z, 1]);\n    return coord;\n  }\n\n  const coord0 = transformVector(pixelUnprojectionMatrix, [x, y, 0, 1]);\n  const coord1 = transformVector(pixelUnprojectionMatrix, [x, y, 1, 1]);\n  const z0 = coord0[2];\n  const z1 = coord1[2];\n  const t = z0 === z1 ? 0 : ((targetZ || 0) - z0) / (z1 - z0);\n  return vec2.lerp([], coord0, coord1, t);\n}\n//# sourceMappingURL=web-mercator-utils.js.map","import assert from './assert';\nimport { log2, clamp } from './math-utils';\nimport { MAX_LATITUDE, lngLatToWorld, worldToLngLat } from './web-mercator-utils';\nexport default function fitBounds(options) {\n  const {\n    width,\n    height,\n    bounds,\n    minExtent = 0,\n    maxZoom = 24,\n    offset = [0, 0]\n  } = options;\n  const [[west, south], [east, north]] = bounds;\n  const padding = getPaddingObject(options.padding);\n  const nw = lngLatToWorld([west, clamp(north, -MAX_LATITUDE, MAX_LATITUDE)]);\n  const se = lngLatToWorld([east, clamp(south, -MAX_LATITUDE, MAX_LATITUDE)]);\n  const size = [Math.max(Math.abs(se[0] - nw[0]), minExtent), Math.max(Math.abs(se[1] - nw[1]), minExtent)];\n  const targetSize = [width - padding.left - padding.right - Math.abs(offset[0]) * 2, height - padding.top - padding.bottom - Math.abs(offset[1]) * 2];\n  assert(targetSize[0] > 0 && targetSize[1] > 0);\n  const scaleX = targetSize[0] / size[0];\n  const scaleY = targetSize[1] / size[1];\n  const offsetX = (padding.right - padding.left) / 2 / scaleX;\n  const offsetY = (padding.bottom - padding.top) / 2 / scaleY;\n  const center = [(se[0] + nw[0]) / 2 + offsetX, (se[1] + nw[1]) / 2 + offsetY];\n  const centerLngLat = worldToLngLat(center);\n  const zoom = Math.min(maxZoom, log2(Math.abs(Math.min(scaleX, scaleY))));\n  assert(Number.isFinite(zoom));\n  return {\n    longitude: centerLngLat[0],\n    latitude: centerLngLat[1],\n    zoom\n  };\n}\n\nfunction getPaddingObject(padding = 0) {\n  if (typeof padding === 'number') {\n    return {\n      top: padding,\n      bottom: padding,\n      left: padding,\n      right: padding\n    };\n  }\n\n  assert(Number.isFinite(padding.top) && Number.isFinite(padding.bottom) && Number.isFinite(padding.left) && Number.isFinite(padding.right));\n  return padding;\n}\n//# sourceMappingURL=fit-bounds.js.map","import { worldToLngLat } from './web-mercator-utils';\nimport * as vec2 from 'gl-matrix/vec2';\nimport { transformVector } from './math-utils';\nconst DEGREES_TO_RADIANS = Math.PI / 180;\nexport default function getBounds(viewport, z = 0) {\n  const {\n    width,\n    height,\n    unproject\n  } = viewport;\n  const unprojectOps = {\n    targetZ: z\n  };\n  const bottomLeft = unproject([0, height], unprojectOps);\n  const bottomRight = unproject([width, height], unprojectOps);\n  let topLeft;\n  let topRight;\n  const halfFov = viewport.fovy ? 0.5 * viewport.fovy * DEGREES_TO_RADIANS : Math.atan(0.5 / viewport.altitude);\n  const angleToGround = (90 - viewport.pitch) * DEGREES_TO_RADIANS;\n\n  if (halfFov > angleToGround - 0.01) {\n    topLeft = unprojectOnFarPlane(viewport, 0, z);\n    topRight = unprojectOnFarPlane(viewport, width, z);\n  } else {\n    topLeft = unproject([0, 0], unprojectOps);\n    topRight = unproject([width, 0], unprojectOps);\n  }\n\n  return [bottomLeft, bottomRight, topRight, topLeft];\n}\n\nfunction unprojectOnFarPlane(viewport, x, targetZ) {\n  const {\n    pixelUnprojectionMatrix\n  } = viewport;\n  const coord0 = transformVector(pixelUnprojectionMatrix, [x, 0, 1, 1]);\n  const coord1 = transformVector(pixelUnprojectionMatrix, [x, viewport.height, 1, 1]);\n  const z = targetZ * viewport.distanceScales.unitsPerMeter[2];\n  const t = (z - coord0[2]) / (coord1[2] - coord0[2]);\n  const coord = vec2.lerp([], coord0, coord1, t);\n  const result = worldToLngLat(coord);\n  result.push(targetZ);\n  return result;\n}\n//# sourceMappingURL=get-bounds.js.map","import { worldToLngLat } from './web-mercator-utils';\nimport { mod, log2 } from './math-utils';\nconst TILE_SIZE = 512;\nexport default function normalizeViewportProps(props) {\n  const {\n    width,\n    height,\n    pitch = 0\n  } = props;\n  let {\n    longitude,\n    latitude,\n    zoom,\n    bearing = 0\n  } = props;\n\n  if (longitude < -180 || longitude > 180) {\n    longitude = mod(longitude + 180, 360) - 180;\n  }\n\n  if (bearing < -180 || bearing > 180) {\n    bearing = mod(bearing + 180, 360) - 180;\n  }\n\n  const minZoom = log2(height / TILE_SIZE);\n\n  if (zoom <= minZoom) {\n    zoom = minZoom;\n    latitude = 0;\n  } else {\n    const halfHeightPixels = height / 2 / Math.pow(2, zoom);\n    const minLatitude = worldToLngLat([0, halfHeightPixels])[1];\n\n    if (latitude < minLatitude) {\n      latitude = minLatitude;\n    } else {\n      const maxLatitude = worldToLngLat([0, TILE_SIZE - halfHeightPixels])[1];\n\n      if (latitude > maxLatitude) {\n        latitude = maxLatitude;\n      }\n    }\n  }\n\n  return {\n    width,\n    height,\n    longitude,\n    latitude,\n    zoom,\n    pitch,\n    bearing\n  };\n}\n//# sourceMappingURL=normalize-viewport-props.js.map","import { lerp } from './math-utils';\nimport { scaleToZoom, zoomToScale, lngLatToWorld, worldToLngLat } from './web-mercator-utils';\nimport * as vec2 from 'gl-matrix/vec2';\nconst EPSILON = 0.01;\nconst VIEWPORT_TRANSITION_PROPS = ['longitude', 'latitude', 'zoom'];\nconst DEFAULT_OPTS = {\n  curve: 1.414,\n  speed: 1.2\n};\nexport default function flyToViewport(startProps, endProps, t, options) {\n  const {\n    startZoom,\n    startCenterXY,\n    uDelta,\n    w0,\n    u1,\n    S,\n    rho,\n    rho2,\n    r0\n  } = getFlyToTransitionParams(startProps, endProps, options);\n\n  if (u1 < EPSILON) {\n    const viewport = {};\n\n    for (const key of VIEWPORT_TRANSITION_PROPS) {\n      const startValue = startProps[key];\n      const endValue = endProps[key];\n      viewport[key] = lerp(startValue, endValue, t);\n    }\n\n    return viewport;\n  }\n\n  const s = t * S;\n  const w = Math.cosh(r0) / Math.cosh(r0 + rho * s);\n  const u = w0 * ((Math.cosh(r0) * Math.tanh(r0 + rho * s) - Math.sinh(r0)) / rho2) / u1;\n  const scaleIncrement = 1 / w;\n  const newZoom = startZoom + scaleToZoom(scaleIncrement);\n  const newCenterWorld = vec2.scale([], uDelta, u);\n  vec2.add(newCenterWorld, newCenterWorld, startCenterXY);\n  const newCenter = worldToLngLat(newCenterWorld);\n  return {\n    longitude: newCenter[0],\n    latitude: newCenter[1],\n    zoom: newZoom\n  };\n}\nexport function getFlyToDuration(startProps, endProps, options) {\n  const opts = { ...DEFAULT_OPTS,\n    ...options\n  };\n  const {\n    screenSpeed,\n    speed,\n    maxDuration\n  } = opts;\n  const {\n    S,\n    rho\n  } = getFlyToTransitionParams(startProps, endProps, opts);\n  const length = 1000 * S;\n  let duration;\n\n  if (Number.isFinite(screenSpeed)) {\n    duration = length / (screenSpeed / rho);\n  } else {\n    duration = length / speed;\n  }\n\n  return Number.isFinite(maxDuration) && duration > maxDuration ? 0 : duration;\n}\n\nfunction getFlyToTransitionParams(startProps, endProps, opts) {\n  opts = Object.assign({}, DEFAULT_OPTS, opts);\n  const rho = opts.curve;\n  const startZoom = startProps.zoom;\n  const startCenter = [startProps.longitude, startProps.latitude];\n  const startScale = zoomToScale(startZoom);\n  const endZoom = endProps.zoom;\n  const endCenter = [endProps.longitude, endProps.latitude];\n  const scale = zoomToScale(endZoom - startZoom);\n  const startCenterXY = lngLatToWorld(startCenter);\n  const endCenterXY = lngLatToWorld(endCenter);\n  const uDelta = vec2.sub([], endCenterXY, startCenterXY);\n  const w0 = Math.max(startProps.width, startProps.height);\n  const w1 = w0 / scale;\n  const u1 = vec2.length(uDelta) * startScale;\n\n  const _u1 = Math.max(u1, EPSILON);\n\n  const rho2 = rho * rho;\n  const b0 = (w1 * w1 - w0 * w0 + rho2 * rho2 * _u1 * _u1) / (2 * w0 * rho2 * _u1);\n  const b1 = (w1 * w1 - w0 * w0 - rho2 * rho2 * _u1 * _u1) / (2 * w1 * rho2 * _u1);\n  const r0 = Math.log(Math.sqrt(b0 * b0 + 1) - b0);\n  const r1 = Math.log(Math.sqrt(b1 * b1 + 1) - b1);\n  const S = (r1 - r0) / rho;\n  return {\n    startZoom,\n    startCenterXY,\n    uDelta,\n    w0,\n    u1,\n    S,\n    rho,\n    rho2,\n    r0,\n    r1\n  };\n}\n//# sourceMappingURL=fly-to-viewport.js.map","export { default } from './web-mercator-viewport';\nexport { default as WebMercatorViewport } from './web-mercator-viewport';\nexport { default as getBounds } from './get-bounds';\nexport { default as fitBounds } from './fit-bounds';\nexport { default as normalizeViewportProps } from './normalize-viewport-props';\nexport { default as flyToViewport, getFlyToDuration } from './fly-to-viewport';\nexport { MAX_LATITUDE, lngLatToWorld, worldToLngLat, worldToPixels, pixelsToWorld, zoomToScale, scaleToZoom, altitudeToFovy, fovyToAltitude, getMeterZoom, unitsPerMeter, getDistanceScales, addMetersToLngLat, getViewMatrix, getProjectionMatrix, getProjectionParameters } from './web-mercator-utils';\n//# sourceMappingURL=index.js.map","export function filename(url) {\n  const slashIndex = url && url.lastIndexOf('/');\n  return slashIndex >= 0 ? url.substr(slashIndex + 1) : '';\n}\nexport function dirname(url) {\n  const slashIndex = url && url.lastIndexOf('/');\n  return slashIndex >= 0 ? url.substr(0, slashIndex) : '';\n}\nexport function join(...parts) {\n  const separator = '/';\n  parts = parts.map((part, index) => {\n    if (index) {\n      part = part.replace(new RegExp(\"^\".concat(separator)), '');\n    }\n\n    if (index !== parts.length - 1) {\n      part = part.replace(new RegExp(\"\".concat(separator, \"$\")), '');\n    }\n\n    return part;\n  });\n  return parts.join(separator);\n}\n//# sourceMappingURL=path.js.map","export { assert } from './lib/env-utils/assert';\nexport { isBrowser, isWorker, nodeVersion, self, window, global, document } from './lib/env-utils/globals';\nexport { createLoaderWorker } from './lib/worker-loader-utils/create-loader-worker';\nexport { parseWithWorker, canParseWithWorker } from './lib/worker-loader-utils/parse-with-worker';\nexport { canEncodeWithWorker } from './lib/worker-loader-utils/encode-with-worker';\nexport { parseJSON } from './lib/parser-utils/parse-json';\nexport { toArrayBuffer, sliceArrayBuffer, concatenateArrayBuffers, concatenateTypedArrays, compareArrayBuffers } from './lib/binary-utils/array-buffer-utils';\nexport { padToNBytes, copyToArray, copyArrayBuffer } from './lib/binary-utils/memory-copy-utils';\nexport { copyPaddedArrayBufferToDataView, copyPaddedStringToDataView } from './lib/binary-utils/binary-copy-utils';\nexport { padStringToByteAlignment, copyStringToDataView, copyBinaryToDataView } from './lib/binary-utils/encode-utils';\nexport { getFirstCharacters, getMagicString } from './lib/binary-utils/get-first-characters';\nexport { makeTextEncoderIterator, makeTextDecoderIterator, makeLineIterator, makeNumberedLineIterator } from './lib/iterators/text-iterators';\nexport { forEach, concatenateArrayBuffersAsync } from './lib/iterators/async-iteration';\nexport { default as RequestScheduler } from './lib/request-utils/request-scheduler';\nexport { setPathPrefix, getPathPrefix, resolvePath } from './lib/path-utils/file-aliases';\nexport { addAliases as _addAliases } from './lib/path-utils/file-aliases';\nexport { JSONLoader } from './json-loader';\nimport * as path from './lib/path-utils/path';\nexport { path };\nexport { isBuffer, toBuffer, bufferToArrayBuffer } from './lib/binary-utils/buffer-utils';\nimport * as util from './lib/node/util';\nexport { util };\nexport { promisify } from './lib/node/util';\nimport * as fs from './lib/node/fs';\nexport { fs };\nexport { default as _NodeFileSystem } from './lib/filesystems/node-filesystem';\n//# sourceMappingURL=index.js.map","import {Log} from '@probe.gl/log';\n\nexport default new Log({id: 'deck'});\n","const isBoolean = x => typeof x === 'boolean';\n\nconst isFunction = x => typeof x === 'function';\n\nexport const isObject = x => x !== null && typeof x === 'object';\nexport const isPureObject = x => isObject(x) && x.constructor === {}.constructor;\nexport const isPromise = x => isObject(x) && isFunction(x.then);\nexport const isIterable = x => x && typeof x[Symbol.iterator] === 'function';\nexport const isAsyncIterable = x => x && typeof x[Symbol.asyncIterator] === 'function';\nexport const isIterator = x => x && isFunction(x.next);\nexport const isResponse = x => typeof Response !== 'undefined' && x instanceof Response || x && x.arrayBuffer && x.text && x.json;\nexport const isFile = x => typeof File !== 'undefined' && x instanceof File;\nexport const isBlob = x => typeof Blob !== 'undefined' && x instanceof Blob;\nexport const isBuffer = x => x && typeof x === 'object' && x.isBuffer;\nexport const isWritableDOMStream = x => isObject(x) && isFunction(x.abort) && isFunction(x.getWriter);\nexport const isReadableDOMStream = x => typeof ReadableStream !== 'undefined' && x instanceof ReadableStream || isObject(x) && isFunction(x.tee) && isFunction(x.cancel) && isFunction(x.getReader);\nexport const isWritableNodeStream = x => isObject(x) && isFunction(x.end) && isFunction(x.write) && isBoolean(x.writable);\nexport const isReadableNodeStream = x => isObject(x) && isFunction(x.read) && isFunction(x.pipe) && isBoolean(x.readable);\nexport const isReadableStream = x => isReadableDOMStream(x) || isReadableNodeStream(x);\nexport const isWritableStream = x => isWritableDOMStream(x) || isWritableNodeStream(x);\n//# sourceMappingURL=is-type.js.map","import { config } from './common';\nexport function validateVector(v, length) {\n  if (v.length !== length) {\n    return false;\n  }\n\n  for (let i = 0; i < v.length; ++i) {\n    if (!Number.isFinite(v[i])) {\n      return false;\n    }\n  }\n\n  return true;\n}\nexport function checkNumber(value) {\n  if (!Number.isFinite(value)) {\n    throw new Error(\"Invalid number \".concat(value));\n  }\n\n  return value;\n}\nexport function checkVector(v, length, callerName = '') {\n  if (config.debug && !validateVector(v, length)) {\n    throw new Error(\"math.gl: \".concat(callerName, \" some fields set to invalid numbers'\"));\n  }\n\n  return v;\n}\nconst map = {};\nexport function deprecated(method, version) {\n  if (!map[method]) {\n    map[method] = true;\n    console.warn(\"\".concat(method, \" has been removed in version \").concat(version, \", see upgrade guide for more information\"));\n  }\n}\n//# sourceMappingURL=validators.js.map","export const LIFECYCLE = {\n  NO_STATE: 'Awaiting state',\n  MATCHED: 'Matched. State transferred from previous layer',\n  INITIALIZED: 'Initialized',\n  AWAITING_GC: 'Discarded. Awaiting garbage collection',\n  AWAITING_FINALIZATION: 'No longer matched. Awaiting garbage collection',\n  FINALIZED: 'Finalized! Awaiting garbage collection'\n} as const;\n\nexport type Lifecycle = typeof LIFECYCLE[keyof typeof LIFECYCLE];\n\n/* Secret props keys */\n// Symbols are non-enumerable by default, does not show in for...in or Object.keys\n// but are copied with Object.assign ¯\\_(ツ)_/¯\n// Supported everywhere except IE11, can be polyfilled with core-js\nexport const COMPONENT_SYMBOL: unique symbol = Symbol.for('component');\nexport const ASYNC_DEFAULTS_SYMBOL: unique symbol = Symbol.for('asyncPropDefaults');\nexport const ASYNC_ORIGINAL_SYMBOL: unique symbol = Symbol.for('asyncPropOriginal');\nexport const ASYNC_RESOLVED_SYMBOL: unique symbol = Symbol.for('asyncPropResolved');\n","import * as glMatrix from \"./common.js\";\n/**\n * 3 Dimensional Vector\n * @module vec3\n */\n\n/**\n * Creates a new, empty vec3\n *\n * @returns {vec3} a new 3D vector\n */\n\nexport function create() {\n  var out = new glMatrix.ARRAY_TYPE(3);\n\n  if (glMatrix.ARRAY_TYPE != Float32Array) {\n    out[0] = 0;\n    out[1] = 0;\n    out[2] = 0;\n  }\n\n  return out;\n}\n/**\n * Creates a new vec3 initialized with values from an existing vector\n *\n * @param {ReadonlyVec3} a vector to clone\n * @returns {vec3} a new 3D vector\n */\n\nexport function clone(a) {\n  var out = new glMatrix.ARRAY_TYPE(3);\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  return out;\n}\n/**\n * Calculates the length of a vec3\n *\n * @param {ReadonlyVec3} a vector to calculate length of\n * @returns {Number} length of a\n */\n\nexport function length(a) {\n  var x = a[0];\n  var y = a[1];\n  var z = a[2];\n  return Math.hypot(x, y, z);\n}\n/**\n * Creates a new vec3 initialized with the given values\n *\n * @param {Number} x X component\n * @param {Number} y Y component\n * @param {Number} z Z component\n * @returns {vec3} a new 3D vector\n */\n\nexport function fromValues(x, y, z) {\n  var out = new glMatrix.ARRAY_TYPE(3);\n  out[0] = x;\n  out[1] = y;\n  out[2] = z;\n  return out;\n}\n/**\n * Copy the values from one vec3 to another\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the source vector\n * @returns {vec3} out\n */\n\nexport function copy(out, a) {\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  return out;\n}\n/**\n * Set the components of a vec3 to the given values\n *\n * @param {vec3} out the receiving vector\n * @param {Number} x X component\n * @param {Number} y Y component\n * @param {Number} z Z component\n * @returns {vec3} out\n */\n\nexport function set(out, x, y, z) {\n  out[0] = x;\n  out[1] = y;\n  out[2] = z;\n  return out;\n}\n/**\n * Adds two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\n\nexport function add(out, a, b) {\n  out[0] = a[0] + b[0];\n  out[1] = a[1] + b[1];\n  out[2] = a[2] + b[2];\n  return out;\n}\n/**\n * Subtracts vector b from vector a\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\n\nexport function subtract(out, a, b) {\n  out[0] = a[0] - b[0];\n  out[1] = a[1] - b[1];\n  out[2] = a[2] - b[2];\n  return out;\n}\n/**\n * Multiplies two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\n\nexport function multiply(out, a, b) {\n  out[0] = a[0] * b[0];\n  out[1] = a[1] * b[1];\n  out[2] = a[2] * b[2];\n  return out;\n}\n/**\n * Divides two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\n\nexport function divide(out, a, b) {\n  out[0] = a[0] / b[0];\n  out[1] = a[1] / b[1];\n  out[2] = a[2] / b[2];\n  return out;\n}\n/**\n * Math.ceil the components of a vec3\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a vector to ceil\n * @returns {vec3} out\n */\n\nexport function ceil(out, a) {\n  out[0] = Math.ceil(a[0]);\n  out[1] = Math.ceil(a[1]);\n  out[2] = Math.ceil(a[2]);\n  return out;\n}\n/**\n * Math.floor the components of a vec3\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a vector to floor\n * @returns {vec3} out\n */\n\nexport function floor(out, a) {\n  out[0] = Math.floor(a[0]);\n  out[1] = Math.floor(a[1]);\n  out[2] = Math.floor(a[2]);\n  return out;\n}\n/**\n * Returns the minimum of two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\n\nexport function min(out, a, b) {\n  out[0] = Math.min(a[0], b[0]);\n  out[1] = Math.min(a[1], b[1]);\n  out[2] = Math.min(a[2], b[2]);\n  return out;\n}\n/**\n * Returns the maximum of two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\n\nexport function max(out, a, b) {\n  out[0] = Math.max(a[0], b[0]);\n  out[1] = Math.max(a[1], b[1]);\n  out[2] = Math.max(a[2], b[2]);\n  return out;\n}\n/**\n * Math.round the components of a vec3\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a vector to round\n * @returns {vec3} out\n */\n\nexport function round(out, a) {\n  out[0] = Math.round(a[0]);\n  out[1] = Math.round(a[1]);\n  out[2] = Math.round(a[2]);\n  return out;\n}\n/**\n * Scales a vec3 by a scalar number\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the vector to scale\n * @param {Number} b amount to scale the vector by\n * @returns {vec3} out\n */\n\nexport function scale(out, a, b) {\n  out[0] = a[0] * b;\n  out[1] = a[1] * b;\n  out[2] = a[2] * b;\n  return out;\n}\n/**\n * Adds two vec3's after scaling the second operand by a scalar value\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @param {Number} scale the amount to scale b by before adding\n * @returns {vec3} out\n */\n\nexport function scaleAndAdd(out, a, b, scale) {\n  out[0] = a[0] + b[0] * scale;\n  out[1] = a[1] + b[1] * scale;\n  out[2] = a[2] + b[2] * scale;\n  return out;\n}\n/**\n * Calculates the euclidian distance between two vec3's\n *\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {Number} distance between a and b\n */\n\nexport function distance(a, b) {\n  var x = b[0] - a[0];\n  var y = b[1] - a[1];\n  var z = b[2] - a[2];\n  return Math.hypot(x, y, z);\n}\n/**\n * Calculates the squared euclidian distance between two vec3's\n *\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {Number} squared distance between a and b\n */\n\nexport function squaredDistance(a, b) {\n  var x = b[0] - a[0];\n  var y = b[1] - a[1];\n  var z = b[2] - a[2];\n  return x * x + y * y + z * z;\n}\n/**\n * Calculates the squared length of a vec3\n *\n * @param {ReadonlyVec3} a vector to calculate squared length of\n * @returns {Number} squared length of a\n */\n\nexport function squaredLength(a) {\n  var x = a[0];\n  var y = a[1];\n  var z = a[2];\n  return x * x + y * y + z * z;\n}\n/**\n * Negates the components of a vec3\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a vector to negate\n * @returns {vec3} out\n */\n\nexport function negate(out, a) {\n  out[0] = -a[0];\n  out[1] = -a[1];\n  out[2] = -a[2];\n  return out;\n}\n/**\n * Returns the inverse of the components of a vec3\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a vector to invert\n * @returns {vec3} out\n */\n\nexport function inverse(out, a) {\n  out[0] = 1.0 / a[0];\n  out[1] = 1.0 / a[1];\n  out[2] = 1.0 / a[2];\n  return out;\n}\n/**\n * Normalize a vec3\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a vector to normalize\n * @returns {vec3} out\n */\n\nexport function normalize(out, a) {\n  var x = a[0];\n  var y = a[1];\n  var z = a[2];\n  var len = x * x + y * y + z * z;\n\n  if (len > 0) {\n    //TODO: evaluate use of glm_invsqrt here?\n    len = 1 / Math.sqrt(len);\n  }\n\n  out[0] = a[0] * len;\n  out[1] = a[1] * len;\n  out[2] = a[2] * len;\n  return out;\n}\n/**\n * Calculates the dot product of two vec3's\n *\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {Number} dot product of a and b\n */\n\nexport function dot(a, b) {\n  return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];\n}\n/**\n * Computes the cross product of two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\n\nexport function cross(out, a, b) {\n  var ax = a[0],\n      ay = a[1],\n      az = a[2];\n  var bx = b[0],\n      by = b[1],\n      bz = b[2];\n  out[0] = ay * bz - az * by;\n  out[1] = az * bx - ax * bz;\n  out[2] = ax * by - ay * bx;\n  return out;\n}\n/**\n * Performs a linear interpolation between two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {vec3} out\n */\n\nexport function lerp(out, a, b, t) {\n  var ax = a[0];\n  var ay = a[1];\n  var az = a[2];\n  out[0] = ax + t * (b[0] - ax);\n  out[1] = ay + t * (b[1] - ay);\n  out[2] = az + t * (b[2] - az);\n  return out;\n}\n/**\n * Performs a hermite interpolation with two control points\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @param {ReadonlyVec3} c the third operand\n * @param {ReadonlyVec3} d the fourth operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {vec3} out\n */\n\nexport function hermite(out, a, b, c, d, t) {\n  var factorTimes2 = t * t;\n  var factor1 = factorTimes2 * (2 * t - 3) + 1;\n  var factor2 = factorTimes2 * (t - 2) + t;\n  var factor3 = factorTimes2 * (t - 1);\n  var factor4 = factorTimes2 * (3 - 2 * t);\n  out[0] = a[0] * factor1 + b[0] * factor2 + c[0] * factor3 + d[0] * factor4;\n  out[1] = a[1] * factor1 + b[1] * factor2 + c[1] * factor3 + d[1] * factor4;\n  out[2] = a[2] * factor1 + b[2] * factor2 + c[2] * factor3 + d[2] * factor4;\n  return out;\n}\n/**\n * Performs a bezier interpolation with two control points\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @param {ReadonlyVec3} c the third operand\n * @param {ReadonlyVec3} d the fourth operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {vec3} out\n */\n\nexport function bezier(out, a, b, c, d, t) {\n  var inverseFactor = 1 - t;\n  var inverseFactorTimesTwo = inverseFactor * inverseFactor;\n  var factorTimes2 = t * t;\n  var factor1 = inverseFactorTimesTwo * inverseFactor;\n  var factor2 = 3 * t * inverseFactorTimesTwo;\n  var factor3 = 3 * factorTimes2 * inverseFactor;\n  var factor4 = factorTimes2 * t;\n  out[0] = a[0] * factor1 + b[0] * factor2 + c[0] * factor3 + d[0] * factor4;\n  out[1] = a[1] * factor1 + b[1] * factor2 + c[1] * factor3 + d[1] * factor4;\n  out[2] = a[2] * factor1 + b[2] * factor2 + c[2] * factor3 + d[2] * factor4;\n  return out;\n}\n/**\n * Generates a random vector with the given scale\n *\n * @param {vec3} out the receiving vector\n * @param {Number} [scale] Length of the resulting vector. If ommitted, a unit vector will be returned\n * @returns {vec3} out\n */\n\nexport function random(out, scale) {\n  scale = scale || 1.0;\n  var r = glMatrix.RANDOM() * 2.0 * Math.PI;\n  var z = glMatrix.RANDOM() * 2.0 - 1.0;\n  var zScale = Math.sqrt(1.0 - z * z) * scale;\n  out[0] = Math.cos(r) * zScale;\n  out[1] = Math.sin(r) * zScale;\n  out[2] = z * scale;\n  return out;\n}\n/**\n * Transforms the vec3 with a mat4.\n * 4th vector component is implicitly '1'\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the vector to transform\n * @param {ReadonlyMat4} m matrix to transform with\n * @returns {vec3} out\n */\n\nexport function transformMat4(out, a, m) {\n  var x = a[0],\n      y = a[1],\n      z = a[2];\n  var w = m[3] * x + m[7] * y + m[11] * z + m[15];\n  w = w || 1.0;\n  out[0] = (m[0] * x + m[4] * y + m[8] * z + m[12]) / w;\n  out[1] = (m[1] * x + m[5] * y + m[9] * z + m[13]) / w;\n  out[2] = (m[2] * x + m[6] * y + m[10] * z + m[14]) / w;\n  return out;\n}\n/**\n * Transforms the vec3 with a mat3.\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the vector to transform\n * @param {ReadonlyMat3} m the 3x3 matrix to transform with\n * @returns {vec3} out\n */\n\nexport function transformMat3(out, a, m) {\n  var x = a[0],\n      y = a[1],\n      z = a[2];\n  out[0] = x * m[0] + y * m[3] + z * m[6];\n  out[1] = x * m[1] + y * m[4] + z * m[7];\n  out[2] = x * m[2] + y * m[5] + z * m[8];\n  return out;\n}\n/**\n * Transforms the vec3 with a quat\n * Can also be used for dual quaternions. (Multiply it with the real part)\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the vector to transform\n * @param {ReadonlyQuat} q quaternion to transform with\n * @returns {vec3} out\n */\n\nexport function transformQuat(out, a, q) {\n  // benchmarks: https://jsperf.com/quaternion-transform-vec3-implementations-fixed\n  var qx = q[0],\n      qy = q[1],\n      qz = q[2],\n      qw = q[3];\n  var x = a[0],\n      y = a[1],\n      z = a[2]; // var qvec = [qx, qy, qz];\n  // var uv = vec3.cross([], qvec, a);\n\n  var uvx = qy * z - qz * y,\n      uvy = qz * x - qx * z,\n      uvz = qx * y - qy * x; // var uuv = vec3.cross([], qvec, uv);\n\n  var uuvx = qy * uvz - qz * uvy,\n      uuvy = qz * uvx - qx * uvz,\n      uuvz = qx * uvy - qy * uvx; // vec3.scale(uv, uv, 2 * w);\n\n  var w2 = qw * 2;\n  uvx *= w2;\n  uvy *= w2;\n  uvz *= w2; // vec3.scale(uuv, uuv, 2);\n\n  uuvx *= 2;\n  uuvy *= 2;\n  uuvz *= 2; // return vec3.add(out, a, vec3.add(out, uv, uuv));\n\n  out[0] = x + uvx + uuvx;\n  out[1] = y + uvy + uuvy;\n  out[2] = z + uvz + uuvz;\n  return out;\n}\n/**\n * Rotate a 3D vector around the x-axis\n * @param {vec3} out The receiving vec3\n * @param {ReadonlyVec3} a The vec3 point to rotate\n * @param {ReadonlyVec3} b The origin of the rotation\n * @param {Number} rad The angle of rotation in radians\n * @returns {vec3} out\n */\n\nexport function rotateX(out, a, b, rad) {\n  var p = [],\n      r = []; //Translate point to the origin\n\n  p[0] = a[0] - b[0];\n  p[1] = a[1] - b[1];\n  p[2] = a[2] - b[2]; //perform rotation\n\n  r[0] = p[0];\n  r[1] = p[1] * Math.cos(rad) - p[2] * Math.sin(rad);\n  r[2] = p[1] * Math.sin(rad) + p[2] * Math.cos(rad); //translate to correct position\n\n  out[0] = r[0] + b[0];\n  out[1] = r[1] + b[1];\n  out[2] = r[2] + b[2];\n  return out;\n}\n/**\n * Rotate a 3D vector around the y-axis\n * @param {vec3} out The receiving vec3\n * @param {ReadonlyVec3} a The vec3 point to rotate\n * @param {ReadonlyVec3} b The origin of the rotation\n * @param {Number} rad The angle of rotation in radians\n * @returns {vec3} out\n */\n\nexport function rotateY(out, a, b, rad) {\n  var p = [],\n      r = []; //Translate point to the origin\n\n  p[0] = a[0] - b[0];\n  p[1] = a[1] - b[1];\n  p[2] = a[2] - b[2]; //perform rotation\n\n  r[0] = p[2] * Math.sin(rad) + p[0] * Math.cos(rad);\n  r[1] = p[1];\n  r[2] = p[2] * Math.cos(rad) - p[0] * Math.sin(rad); //translate to correct position\n\n  out[0] = r[0] + b[0];\n  out[1] = r[1] + b[1];\n  out[2] = r[2] + b[2];\n  return out;\n}\n/**\n * Rotate a 3D vector around the z-axis\n * @param {vec3} out The receiving vec3\n * @param {ReadonlyVec3} a The vec3 point to rotate\n * @param {ReadonlyVec3} b The origin of the rotation\n * @param {Number} rad The angle of rotation in radians\n * @returns {vec3} out\n */\n\nexport function rotateZ(out, a, b, rad) {\n  var p = [],\n      r = []; //Translate point to the origin\n\n  p[0] = a[0] - b[0];\n  p[1] = a[1] - b[1];\n  p[2] = a[2] - b[2]; //perform rotation\n\n  r[0] = p[0] * Math.cos(rad) - p[1] * Math.sin(rad);\n  r[1] = p[0] * Math.sin(rad) + p[1] * Math.cos(rad);\n  r[2] = p[2]; //translate to correct position\n\n  out[0] = r[0] + b[0];\n  out[1] = r[1] + b[1];\n  out[2] = r[2] + b[2];\n  return out;\n}\n/**\n * Get the angle between two 3D vectors\n * @param {ReadonlyVec3} a The first operand\n * @param {ReadonlyVec3} b The second operand\n * @returns {Number} The angle in radians\n */\n\nexport function angle(a, b) {\n  var ax = a[0],\n      ay = a[1],\n      az = a[2],\n      bx = b[0],\n      by = b[1],\n      bz = b[2],\n      mag1 = Math.sqrt(ax * ax + ay * ay + az * az),\n      mag2 = Math.sqrt(bx * bx + by * by + bz * bz),\n      mag = mag1 * mag2,\n      cosine = mag && dot(a, b) / mag;\n  return Math.acos(Math.min(Math.max(cosine, -1), 1));\n}\n/**\n * Set the components of a vec3 to zero\n *\n * @param {vec3} out the receiving vector\n * @returns {vec3} out\n */\n\nexport function zero(out) {\n  out[0] = 0.0;\n  out[1] = 0.0;\n  out[2] = 0.0;\n  return out;\n}\n/**\n * Returns a string representation of a vector\n *\n * @param {ReadonlyVec3} a vector to represent as a string\n * @returns {String} string representation of the vector\n */\n\nexport function str(a) {\n  return \"vec3(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \")\";\n}\n/**\n * Returns whether or not the vectors have exactly the same elements in the same position (when compared with ===)\n *\n * @param {ReadonlyVec3} a The first vector.\n * @param {ReadonlyVec3} b The second vector.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\n\nexport function exactEquals(a, b) {\n  return a[0] === b[0] && a[1] === b[1] && a[2] === b[2];\n}\n/**\n * Returns whether or not the vectors have approximately the same elements in the same position.\n *\n * @param {ReadonlyVec3} a The first vector.\n * @param {ReadonlyVec3} b The second vector.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\n\nexport function equals(a, b) {\n  var a0 = a[0],\n      a1 = a[1],\n      a2 = a[2];\n  var b0 = b[0],\n      b1 = b[1],\n      b2 = b[2];\n  return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2));\n}\n/**\n * Alias for {@link vec3.subtract}\n * @function\n */\n\nexport var sub = subtract;\n/**\n * Alias for {@link vec3.multiply}\n * @function\n */\n\nexport var mul = multiply;\n/**\n * Alias for {@link vec3.divide}\n * @function\n */\n\nexport var div = divide;\n/**\n * Alias for {@link vec3.distance}\n * @function\n */\n\nexport var dist = distance;\n/**\n * Alias for {@link vec3.squaredDistance}\n * @function\n */\n\nexport var sqrDist = squaredDistance;\n/**\n * Alias for {@link vec3.length}\n * @function\n */\n\nexport var len = length;\n/**\n * Alias for {@link vec3.squaredLength}\n * @function\n */\n\nexport var sqrLen = squaredLength;\n/**\n * Perform some operation over an array of vec3s.\n *\n * @param {Array} a the array of vectors to iterate over\n * @param {Number} stride Number of elements between the start of each vec3. If 0 assumes tightly packed\n * @param {Number} offset Number of elements to skip at the beginning of the array\n * @param {Number} count Number of vec3s to iterate over. If 0 iterates over entire array\n * @param {Function} fn Function to call for each vector in the array\n * @param {Object} [arg] additional argument to pass to fn\n * @returns {Array} a\n * @function\n */\n\nexport var forEach = function () {\n  var vec = create();\n  return function (a, stride, offset, count, fn, arg) {\n    var i, l;\n\n    if (!stride) {\n      stride = 3;\n    }\n\n    if (!offset) {\n      offset = 0;\n    }\n\n    if (count) {\n      l = Math.min(count * stride + offset, a.length);\n    } else {\n      l = a.length;\n    }\n\n    for (i = offset; i < l; i += stride) {\n      vec[0] = a[i];\n      vec[1] = a[i + 1];\n      vec[2] = a[i + 2];\n      fn(vec, vec, arg);\n      a[i] = vec[0];\n      a[i + 1] = vec[1];\n      a[i + 2] = vec[2];\n    }\n\n    return a;\n  };\n}();","import * as glMatrix from \"./common.js\";\n/**\n * 4x4 Matrix<br>Format: column-major, when typed out it looks like row-major<br>The matrices are being post multiplied.\n * @module mat4\n */\n\n/**\n * Creates a new identity mat4\n *\n * @returns {mat4} a new 4x4 matrix\n */\n\nexport function create() {\n  var out = new glMatrix.ARRAY_TYPE(16);\n\n  if (glMatrix.ARRAY_TYPE != Float32Array) {\n    out[1] = 0;\n    out[2] = 0;\n    out[3] = 0;\n    out[4] = 0;\n    out[6] = 0;\n    out[7] = 0;\n    out[8] = 0;\n    out[9] = 0;\n    out[11] = 0;\n    out[12] = 0;\n    out[13] = 0;\n    out[14] = 0;\n  }\n\n  out[0] = 1;\n  out[5] = 1;\n  out[10] = 1;\n  out[15] = 1;\n  return out;\n}\n/**\n * Creates a new mat4 initialized with values from an existing matrix\n *\n * @param {ReadonlyMat4} a matrix to clone\n * @returns {mat4} a new 4x4 matrix\n */\n\nexport function clone(a) {\n  var out = new glMatrix.ARRAY_TYPE(16);\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  out[3] = a[3];\n  out[4] = a[4];\n  out[5] = a[5];\n  out[6] = a[6];\n  out[7] = a[7];\n  out[8] = a[8];\n  out[9] = a[9];\n  out[10] = a[10];\n  out[11] = a[11];\n  out[12] = a[12];\n  out[13] = a[13];\n  out[14] = a[14];\n  out[15] = a[15];\n  return out;\n}\n/**\n * Copy the values from one mat4 to another\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the source matrix\n * @returns {mat4} out\n */\n\nexport function copy(out, a) {\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  out[3] = a[3];\n  out[4] = a[4];\n  out[5] = a[5];\n  out[6] = a[6];\n  out[7] = a[7];\n  out[8] = a[8];\n  out[9] = a[9];\n  out[10] = a[10];\n  out[11] = a[11];\n  out[12] = a[12];\n  out[13] = a[13];\n  out[14] = a[14];\n  out[15] = a[15];\n  return out;\n}\n/**\n * Create a new mat4 with the given values\n *\n * @param {Number} m00 Component in column 0, row 0 position (index 0)\n * @param {Number} m01 Component in column 0, row 1 position (index 1)\n * @param {Number} m02 Component in column 0, row 2 position (index 2)\n * @param {Number} m03 Component in column 0, row 3 position (index 3)\n * @param {Number} m10 Component in column 1, row 0 position (index 4)\n * @param {Number} m11 Component in column 1, row 1 position (index 5)\n * @param {Number} m12 Component in column 1, row 2 position (index 6)\n * @param {Number} m13 Component in column 1, row 3 position (index 7)\n * @param {Number} m20 Component in column 2, row 0 position (index 8)\n * @param {Number} m21 Component in column 2, row 1 position (index 9)\n * @param {Number} m22 Component in column 2, row 2 position (index 10)\n * @param {Number} m23 Component in column 2, row 3 position (index 11)\n * @param {Number} m30 Component in column 3, row 0 position (index 12)\n * @param {Number} m31 Component in column 3, row 1 position (index 13)\n * @param {Number} m32 Component in column 3, row 2 position (index 14)\n * @param {Number} m33 Component in column 3, row 3 position (index 15)\n * @returns {mat4} A new mat4\n */\n\nexport function fromValues(m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33) {\n  var out = new glMatrix.ARRAY_TYPE(16);\n  out[0] = m00;\n  out[1] = m01;\n  out[2] = m02;\n  out[3] = m03;\n  out[4] = m10;\n  out[5] = m11;\n  out[6] = m12;\n  out[7] = m13;\n  out[8] = m20;\n  out[9] = m21;\n  out[10] = m22;\n  out[11] = m23;\n  out[12] = m30;\n  out[13] = m31;\n  out[14] = m32;\n  out[15] = m33;\n  return out;\n}\n/**\n * Set the components of a mat4 to the given values\n *\n * @param {mat4} out the receiving matrix\n * @param {Number} m00 Component in column 0, row 0 position (index 0)\n * @param {Number} m01 Component in column 0, row 1 position (index 1)\n * @param {Number} m02 Component in column 0, row 2 position (index 2)\n * @param {Number} m03 Component in column 0, row 3 position (index 3)\n * @param {Number} m10 Component in column 1, row 0 position (index 4)\n * @param {Number} m11 Component in column 1, row 1 position (index 5)\n * @param {Number} m12 Component in column 1, row 2 position (index 6)\n * @param {Number} m13 Component in column 1, row 3 position (index 7)\n * @param {Number} m20 Component in column 2, row 0 position (index 8)\n * @param {Number} m21 Component in column 2, row 1 position (index 9)\n * @param {Number} m22 Component in column 2, row 2 position (index 10)\n * @param {Number} m23 Component in column 2, row 3 position (index 11)\n * @param {Number} m30 Component in column 3, row 0 position (index 12)\n * @param {Number} m31 Component in column 3, row 1 position (index 13)\n * @param {Number} m32 Component in column 3, row 2 position (index 14)\n * @param {Number} m33 Component in column 3, row 3 position (index 15)\n * @returns {mat4} out\n */\n\nexport function set(out, m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33) {\n  out[0] = m00;\n  out[1] = m01;\n  out[2] = m02;\n  out[3] = m03;\n  out[4] = m10;\n  out[5] = m11;\n  out[6] = m12;\n  out[7] = m13;\n  out[8] = m20;\n  out[9] = m21;\n  out[10] = m22;\n  out[11] = m23;\n  out[12] = m30;\n  out[13] = m31;\n  out[14] = m32;\n  out[15] = m33;\n  return out;\n}\n/**\n * Set a mat4 to the identity matrix\n *\n * @param {mat4} out the receiving matrix\n * @returns {mat4} out\n */\n\nexport function identity(out) {\n  out[0] = 1;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = 1;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[10] = 1;\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\n * Transpose the values of a mat4\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the source matrix\n * @returns {mat4} out\n */\n\nexport function transpose(out, a) {\n  // If we are transposing ourselves we can skip a few steps but have to cache some values\n  if (out === a) {\n    var a01 = a[1],\n        a02 = a[2],\n        a03 = a[3];\n    var a12 = a[6],\n        a13 = a[7];\n    var a23 = a[11];\n    out[1] = a[4];\n    out[2] = a[8];\n    out[3] = a[12];\n    out[4] = a01;\n    out[6] = a[9];\n    out[7] = a[13];\n    out[8] = a02;\n    out[9] = a12;\n    out[11] = a[14];\n    out[12] = a03;\n    out[13] = a13;\n    out[14] = a23;\n  } else {\n    out[0] = a[0];\n    out[1] = a[4];\n    out[2] = a[8];\n    out[3] = a[12];\n    out[4] = a[1];\n    out[5] = a[5];\n    out[6] = a[9];\n    out[7] = a[13];\n    out[8] = a[2];\n    out[9] = a[6];\n    out[10] = a[10];\n    out[11] = a[14];\n    out[12] = a[3];\n    out[13] = a[7];\n    out[14] = a[11];\n    out[15] = a[15];\n  }\n\n  return out;\n}\n/**\n * Inverts a mat4\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the source matrix\n * @returns {mat4} out\n */\n\nexport function invert(out, a) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2],\n      a03 = a[3];\n  var a10 = a[4],\n      a11 = a[5],\n      a12 = a[6],\n      a13 = a[7];\n  var a20 = a[8],\n      a21 = a[9],\n      a22 = a[10],\n      a23 = a[11];\n  var a30 = a[12],\n      a31 = a[13],\n      a32 = a[14],\n      a33 = a[15];\n  var b00 = a00 * a11 - a01 * a10;\n  var b01 = a00 * a12 - a02 * a10;\n  var b02 = a00 * a13 - a03 * a10;\n  var b03 = a01 * a12 - a02 * a11;\n  var b04 = a01 * a13 - a03 * a11;\n  var b05 = a02 * a13 - a03 * a12;\n  var b06 = a20 * a31 - a21 * a30;\n  var b07 = a20 * a32 - a22 * a30;\n  var b08 = a20 * a33 - a23 * a30;\n  var b09 = a21 * a32 - a22 * a31;\n  var b10 = a21 * a33 - a23 * a31;\n  var b11 = a22 * a33 - a23 * a32; // Calculate the determinant\n\n  var det = b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06;\n\n  if (!det) {\n    return null;\n  }\n\n  det = 1.0 / det;\n  out[0] = (a11 * b11 - a12 * b10 + a13 * b09) * det;\n  out[1] = (a02 * b10 - a01 * b11 - a03 * b09) * det;\n  out[2] = (a31 * b05 - a32 * b04 + a33 * b03) * det;\n  out[3] = (a22 * b04 - a21 * b05 - a23 * b03) * det;\n  out[4] = (a12 * b08 - a10 * b11 - a13 * b07) * det;\n  out[5] = (a00 * b11 - a02 * b08 + a03 * b07) * det;\n  out[6] = (a32 * b02 - a30 * b05 - a33 * b01) * det;\n  out[7] = (a20 * b05 - a22 * b02 + a23 * b01) * det;\n  out[8] = (a10 * b10 - a11 * b08 + a13 * b06) * det;\n  out[9] = (a01 * b08 - a00 * b10 - a03 * b06) * det;\n  out[10] = (a30 * b04 - a31 * b02 + a33 * b00) * det;\n  out[11] = (a21 * b02 - a20 * b04 - a23 * b00) * det;\n  out[12] = (a11 * b07 - a10 * b09 - a12 * b06) * det;\n  out[13] = (a00 * b09 - a01 * b07 + a02 * b06) * det;\n  out[14] = (a31 * b01 - a30 * b03 - a32 * b00) * det;\n  out[15] = (a20 * b03 - a21 * b01 + a22 * b00) * det;\n  return out;\n}\n/**\n * Calculates the adjugate of a mat4\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the source matrix\n * @returns {mat4} out\n */\n\nexport function adjoint(out, a) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2],\n      a03 = a[3];\n  var a10 = a[4],\n      a11 = a[5],\n      a12 = a[6],\n      a13 = a[7];\n  var a20 = a[8],\n      a21 = a[9],\n      a22 = a[10],\n      a23 = a[11];\n  var a30 = a[12],\n      a31 = a[13],\n      a32 = a[14],\n      a33 = a[15];\n  out[0] = a11 * (a22 * a33 - a23 * a32) - a21 * (a12 * a33 - a13 * a32) + a31 * (a12 * a23 - a13 * a22);\n  out[1] = -(a01 * (a22 * a33 - a23 * a32) - a21 * (a02 * a33 - a03 * a32) + a31 * (a02 * a23 - a03 * a22));\n  out[2] = a01 * (a12 * a33 - a13 * a32) - a11 * (a02 * a33 - a03 * a32) + a31 * (a02 * a13 - a03 * a12);\n  out[3] = -(a01 * (a12 * a23 - a13 * a22) - a11 * (a02 * a23 - a03 * a22) + a21 * (a02 * a13 - a03 * a12));\n  out[4] = -(a10 * (a22 * a33 - a23 * a32) - a20 * (a12 * a33 - a13 * a32) + a30 * (a12 * a23 - a13 * a22));\n  out[5] = a00 * (a22 * a33 - a23 * a32) - a20 * (a02 * a33 - a03 * a32) + a30 * (a02 * a23 - a03 * a22);\n  out[6] = -(a00 * (a12 * a33 - a13 * a32) - a10 * (a02 * a33 - a03 * a32) + a30 * (a02 * a13 - a03 * a12));\n  out[7] = a00 * (a12 * a23 - a13 * a22) - a10 * (a02 * a23 - a03 * a22) + a20 * (a02 * a13 - a03 * a12);\n  out[8] = a10 * (a21 * a33 - a23 * a31) - a20 * (a11 * a33 - a13 * a31) + a30 * (a11 * a23 - a13 * a21);\n  out[9] = -(a00 * (a21 * a33 - a23 * a31) - a20 * (a01 * a33 - a03 * a31) + a30 * (a01 * a23 - a03 * a21));\n  out[10] = a00 * (a11 * a33 - a13 * a31) - a10 * (a01 * a33 - a03 * a31) + a30 * (a01 * a13 - a03 * a11);\n  out[11] = -(a00 * (a11 * a23 - a13 * a21) - a10 * (a01 * a23 - a03 * a21) + a20 * (a01 * a13 - a03 * a11));\n  out[12] = -(a10 * (a21 * a32 - a22 * a31) - a20 * (a11 * a32 - a12 * a31) + a30 * (a11 * a22 - a12 * a21));\n  out[13] = a00 * (a21 * a32 - a22 * a31) - a20 * (a01 * a32 - a02 * a31) + a30 * (a01 * a22 - a02 * a21);\n  out[14] = -(a00 * (a11 * a32 - a12 * a31) - a10 * (a01 * a32 - a02 * a31) + a30 * (a01 * a12 - a02 * a11));\n  out[15] = a00 * (a11 * a22 - a12 * a21) - a10 * (a01 * a22 - a02 * a21) + a20 * (a01 * a12 - a02 * a11);\n  return out;\n}\n/**\n * Calculates the determinant of a mat4\n *\n * @param {ReadonlyMat4} a the source matrix\n * @returns {Number} determinant of a\n */\n\nexport function determinant(a) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2],\n      a03 = a[3];\n  var a10 = a[4],\n      a11 = a[5],\n      a12 = a[6],\n      a13 = a[7];\n  var a20 = a[8],\n      a21 = a[9],\n      a22 = a[10],\n      a23 = a[11];\n  var a30 = a[12],\n      a31 = a[13],\n      a32 = a[14],\n      a33 = a[15];\n  var b00 = a00 * a11 - a01 * a10;\n  var b01 = a00 * a12 - a02 * a10;\n  var b02 = a00 * a13 - a03 * a10;\n  var b03 = a01 * a12 - a02 * a11;\n  var b04 = a01 * a13 - a03 * a11;\n  var b05 = a02 * a13 - a03 * a12;\n  var b06 = a20 * a31 - a21 * a30;\n  var b07 = a20 * a32 - a22 * a30;\n  var b08 = a20 * a33 - a23 * a30;\n  var b09 = a21 * a32 - a22 * a31;\n  var b10 = a21 * a33 - a23 * a31;\n  var b11 = a22 * a33 - a23 * a32; // Calculate the determinant\n\n  return b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06;\n}\n/**\n * Multiplies two mat4s\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the first operand\n * @param {ReadonlyMat4} b the second operand\n * @returns {mat4} out\n */\n\nexport function multiply(out, a, b) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2],\n      a03 = a[3];\n  var a10 = a[4],\n      a11 = a[5],\n      a12 = a[6],\n      a13 = a[7];\n  var a20 = a[8],\n      a21 = a[9],\n      a22 = a[10],\n      a23 = a[11];\n  var a30 = a[12],\n      a31 = a[13],\n      a32 = a[14],\n      a33 = a[15]; // Cache only the current line of the second matrix\n\n  var b0 = b[0],\n      b1 = b[1],\n      b2 = b[2],\n      b3 = b[3];\n  out[0] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;\n  out[1] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;\n  out[2] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;\n  out[3] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;\n  b0 = b[4];\n  b1 = b[5];\n  b2 = b[6];\n  b3 = b[7];\n  out[4] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;\n  out[5] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;\n  out[6] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;\n  out[7] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;\n  b0 = b[8];\n  b1 = b[9];\n  b2 = b[10];\n  b3 = b[11];\n  out[8] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;\n  out[9] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;\n  out[10] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;\n  out[11] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;\n  b0 = b[12];\n  b1 = b[13];\n  b2 = b[14];\n  b3 = b[15];\n  out[12] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;\n  out[13] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;\n  out[14] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;\n  out[15] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;\n  return out;\n}\n/**\n * Translate a mat4 by the given vector\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to translate\n * @param {ReadonlyVec3} v vector to translate by\n * @returns {mat4} out\n */\n\nexport function translate(out, a, v) {\n  var x = v[0],\n      y = v[1],\n      z = v[2];\n  var a00, a01, a02, a03;\n  var a10, a11, a12, a13;\n  var a20, a21, a22, a23;\n\n  if (a === out) {\n    out[12] = a[0] * x + a[4] * y + a[8] * z + a[12];\n    out[13] = a[1] * x + a[5] * y + a[9] * z + a[13];\n    out[14] = a[2] * x + a[6] * y + a[10] * z + a[14];\n    out[15] = a[3] * x + a[7] * y + a[11] * z + a[15];\n  } else {\n    a00 = a[0];\n    a01 = a[1];\n    a02 = a[2];\n    a03 = a[3];\n    a10 = a[4];\n    a11 = a[5];\n    a12 = a[6];\n    a13 = a[7];\n    a20 = a[8];\n    a21 = a[9];\n    a22 = a[10];\n    a23 = a[11];\n    out[0] = a00;\n    out[1] = a01;\n    out[2] = a02;\n    out[3] = a03;\n    out[4] = a10;\n    out[5] = a11;\n    out[6] = a12;\n    out[7] = a13;\n    out[8] = a20;\n    out[9] = a21;\n    out[10] = a22;\n    out[11] = a23;\n    out[12] = a00 * x + a10 * y + a20 * z + a[12];\n    out[13] = a01 * x + a11 * y + a21 * z + a[13];\n    out[14] = a02 * x + a12 * y + a22 * z + a[14];\n    out[15] = a03 * x + a13 * y + a23 * z + a[15];\n  }\n\n  return out;\n}\n/**\n * Scales the mat4 by the dimensions in the given vec3 not using vectorization\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to scale\n * @param {ReadonlyVec3} v the vec3 to scale the matrix by\n * @returns {mat4} out\n **/\n\nexport function scale(out, a, v) {\n  var x = v[0],\n      y = v[1],\n      z = v[2];\n  out[0] = a[0] * x;\n  out[1] = a[1] * x;\n  out[2] = a[2] * x;\n  out[3] = a[3] * x;\n  out[4] = a[4] * y;\n  out[5] = a[5] * y;\n  out[6] = a[6] * y;\n  out[7] = a[7] * y;\n  out[8] = a[8] * z;\n  out[9] = a[9] * z;\n  out[10] = a[10] * z;\n  out[11] = a[11] * z;\n  out[12] = a[12];\n  out[13] = a[13];\n  out[14] = a[14];\n  out[15] = a[15];\n  return out;\n}\n/**\n * Rotates a mat4 by the given angle around the given axis\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to rotate\n * @param {Number} rad the angle to rotate the matrix by\n * @param {ReadonlyVec3} axis the axis to rotate around\n * @returns {mat4} out\n */\n\nexport function rotate(out, a, rad, axis) {\n  var x = axis[0],\n      y = axis[1],\n      z = axis[2];\n  var len = Math.hypot(x, y, z);\n  var s, c, t;\n  var a00, a01, a02, a03;\n  var a10, a11, a12, a13;\n  var a20, a21, a22, a23;\n  var b00, b01, b02;\n  var b10, b11, b12;\n  var b20, b21, b22;\n\n  if (len < glMatrix.EPSILON) {\n    return null;\n  }\n\n  len = 1 / len;\n  x *= len;\n  y *= len;\n  z *= len;\n  s = Math.sin(rad);\n  c = Math.cos(rad);\n  t = 1 - c;\n  a00 = a[0];\n  a01 = a[1];\n  a02 = a[2];\n  a03 = a[3];\n  a10 = a[4];\n  a11 = a[5];\n  a12 = a[6];\n  a13 = a[7];\n  a20 = a[8];\n  a21 = a[9];\n  a22 = a[10];\n  a23 = a[11]; // Construct the elements of the rotation matrix\n\n  b00 = x * x * t + c;\n  b01 = y * x * t + z * s;\n  b02 = z * x * t - y * s;\n  b10 = x * y * t - z * s;\n  b11 = y * y * t + c;\n  b12 = z * y * t + x * s;\n  b20 = x * z * t + y * s;\n  b21 = y * z * t - x * s;\n  b22 = z * z * t + c; // Perform rotation-specific matrix multiplication\n\n  out[0] = a00 * b00 + a10 * b01 + a20 * b02;\n  out[1] = a01 * b00 + a11 * b01 + a21 * b02;\n  out[2] = a02 * b00 + a12 * b01 + a22 * b02;\n  out[3] = a03 * b00 + a13 * b01 + a23 * b02;\n  out[4] = a00 * b10 + a10 * b11 + a20 * b12;\n  out[5] = a01 * b10 + a11 * b11 + a21 * b12;\n  out[6] = a02 * b10 + a12 * b11 + a22 * b12;\n  out[7] = a03 * b10 + a13 * b11 + a23 * b12;\n  out[8] = a00 * b20 + a10 * b21 + a20 * b22;\n  out[9] = a01 * b20 + a11 * b21 + a21 * b22;\n  out[10] = a02 * b20 + a12 * b21 + a22 * b22;\n  out[11] = a03 * b20 + a13 * b21 + a23 * b22;\n\n  if (a !== out) {\n    // If the source and destination differ, copy the unchanged last row\n    out[12] = a[12];\n    out[13] = a[13];\n    out[14] = a[14];\n    out[15] = a[15];\n  }\n\n  return out;\n}\n/**\n * Rotates a matrix by the given angle around the X axis\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to rotate\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat4} out\n */\n\nexport function rotateX(out, a, rad) {\n  var s = Math.sin(rad);\n  var c = Math.cos(rad);\n  var a10 = a[4];\n  var a11 = a[5];\n  var a12 = a[6];\n  var a13 = a[7];\n  var a20 = a[8];\n  var a21 = a[9];\n  var a22 = a[10];\n  var a23 = a[11];\n\n  if (a !== out) {\n    // If the source and destination differ, copy the unchanged rows\n    out[0] = a[0];\n    out[1] = a[1];\n    out[2] = a[2];\n    out[3] = a[3];\n    out[12] = a[12];\n    out[13] = a[13];\n    out[14] = a[14];\n    out[15] = a[15];\n  } // Perform axis-specific matrix multiplication\n\n\n  out[4] = a10 * c + a20 * s;\n  out[5] = a11 * c + a21 * s;\n  out[6] = a12 * c + a22 * s;\n  out[7] = a13 * c + a23 * s;\n  out[8] = a20 * c - a10 * s;\n  out[9] = a21 * c - a11 * s;\n  out[10] = a22 * c - a12 * s;\n  out[11] = a23 * c - a13 * s;\n  return out;\n}\n/**\n * Rotates a matrix by the given angle around the Y axis\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to rotate\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat4} out\n */\n\nexport function rotateY(out, a, rad) {\n  var s = Math.sin(rad);\n  var c = Math.cos(rad);\n  var a00 = a[0];\n  var a01 = a[1];\n  var a02 = a[2];\n  var a03 = a[3];\n  var a20 = a[8];\n  var a21 = a[9];\n  var a22 = a[10];\n  var a23 = a[11];\n\n  if (a !== out) {\n    // If the source and destination differ, copy the unchanged rows\n    out[4] = a[4];\n    out[5] = a[5];\n    out[6] = a[6];\n    out[7] = a[7];\n    out[12] = a[12];\n    out[13] = a[13];\n    out[14] = a[14];\n    out[15] = a[15];\n  } // Perform axis-specific matrix multiplication\n\n\n  out[0] = a00 * c - a20 * s;\n  out[1] = a01 * c - a21 * s;\n  out[2] = a02 * c - a22 * s;\n  out[3] = a03 * c - a23 * s;\n  out[8] = a00 * s + a20 * c;\n  out[9] = a01 * s + a21 * c;\n  out[10] = a02 * s + a22 * c;\n  out[11] = a03 * s + a23 * c;\n  return out;\n}\n/**\n * Rotates a matrix by the given angle around the Z axis\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to rotate\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat4} out\n */\n\nexport function rotateZ(out, a, rad) {\n  var s = Math.sin(rad);\n  var c = Math.cos(rad);\n  var a00 = a[0];\n  var a01 = a[1];\n  var a02 = a[2];\n  var a03 = a[3];\n  var a10 = a[4];\n  var a11 = a[5];\n  var a12 = a[6];\n  var a13 = a[7];\n\n  if (a !== out) {\n    // If the source and destination differ, copy the unchanged last row\n    out[8] = a[8];\n    out[9] = a[9];\n    out[10] = a[10];\n    out[11] = a[11];\n    out[12] = a[12];\n    out[13] = a[13];\n    out[14] = a[14];\n    out[15] = a[15];\n  } // Perform axis-specific matrix multiplication\n\n\n  out[0] = a00 * c + a10 * s;\n  out[1] = a01 * c + a11 * s;\n  out[2] = a02 * c + a12 * s;\n  out[3] = a03 * c + a13 * s;\n  out[4] = a10 * c - a00 * s;\n  out[5] = a11 * c - a01 * s;\n  out[6] = a12 * c - a02 * s;\n  out[7] = a13 * c - a03 * s;\n  return out;\n}\n/**\n * Creates a matrix from a vector translation\n * This is equivalent to (but much faster than):\n *\n *     mat4.identity(dest);\n *     mat4.translate(dest, dest, vec);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {ReadonlyVec3} v Translation vector\n * @returns {mat4} out\n */\n\nexport function fromTranslation(out, v) {\n  out[0] = 1;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = 1;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[10] = 1;\n  out[11] = 0;\n  out[12] = v[0];\n  out[13] = v[1];\n  out[14] = v[2];\n  out[15] = 1;\n  return out;\n}\n/**\n * Creates a matrix from a vector scaling\n * This is equivalent to (but much faster than):\n *\n *     mat4.identity(dest);\n *     mat4.scale(dest, dest, vec);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {ReadonlyVec3} v Scaling vector\n * @returns {mat4} out\n */\n\nexport function fromScaling(out, v) {\n  out[0] = v[0];\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = v[1];\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[10] = v[2];\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\n * Creates a matrix from a given angle around a given axis\n * This is equivalent to (but much faster than):\n *\n *     mat4.identity(dest);\n *     mat4.rotate(dest, dest, rad, axis);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {Number} rad the angle to rotate the matrix by\n * @param {ReadonlyVec3} axis the axis to rotate around\n * @returns {mat4} out\n */\n\nexport function fromRotation(out, rad, axis) {\n  var x = axis[0],\n      y = axis[1],\n      z = axis[2];\n  var len = Math.hypot(x, y, z);\n  var s, c, t;\n\n  if (len < glMatrix.EPSILON) {\n    return null;\n  }\n\n  len = 1 / len;\n  x *= len;\n  y *= len;\n  z *= len;\n  s = Math.sin(rad);\n  c = Math.cos(rad);\n  t = 1 - c; // Perform rotation-specific matrix multiplication\n\n  out[0] = x * x * t + c;\n  out[1] = y * x * t + z * s;\n  out[2] = z * x * t - y * s;\n  out[3] = 0;\n  out[4] = x * y * t - z * s;\n  out[5] = y * y * t + c;\n  out[6] = z * y * t + x * s;\n  out[7] = 0;\n  out[8] = x * z * t + y * s;\n  out[9] = y * z * t - x * s;\n  out[10] = z * z * t + c;\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\n * Creates a matrix from the given angle around the X axis\n * This is equivalent to (but much faster than):\n *\n *     mat4.identity(dest);\n *     mat4.rotateX(dest, dest, rad);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat4} out\n */\n\nexport function fromXRotation(out, rad) {\n  var s = Math.sin(rad);\n  var c = Math.cos(rad); // Perform axis-specific matrix multiplication\n\n  out[0] = 1;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = c;\n  out[6] = s;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = -s;\n  out[10] = c;\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\n * Creates a matrix from the given angle around the Y axis\n * This is equivalent to (but much faster than):\n *\n *     mat4.identity(dest);\n *     mat4.rotateY(dest, dest, rad);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat4} out\n */\n\nexport function fromYRotation(out, rad) {\n  var s = Math.sin(rad);\n  var c = Math.cos(rad); // Perform axis-specific matrix multiplication\n\n  out[0] = c;\n  out[1] = 0;\n  out[2] = -s;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = 1;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = s;\n  out[9] = 0;\n  out[10] = c;\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\n * Creates a matrix from the given angle around the Z axis\n * This is equivalent to (but much faster than):\n *\n *     mat4.identity(dest);\n *     mat4.rotateZ(dest, dest, rad);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat4} out\n */\n\nexport function fromZRotation(out, rad) {\n  var s = Math.sin(rad);\n  var c = Math.cos(rad); // Perform axis-specific matrix multiplication\n\n  out[0] = c;\n  out[1] = s;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = -s;\n  out[5] = c;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[10] = 1;\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\n * Creates a matrix from a quaternion rotation and vector translation\n * This is equivalent to (but much faster than):\n *\n *     mat4.identity(dest);\n *     mat4.translate(dest, vec);\n *     let quatMat = mat4.create();\n *     quat4.toMat4(quat, quatMat);\n *     mat4.multiply(dest, quatMat);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {quat4} q Rotation quaternion\n * @param {ReadonlyVec3} v Translation vector\n * @returns {mat4} out\n */\n\nexport function fromRotationTranslation(out, q, v) {\n  // Quaternion math\n  var x = q[0],\n      y = q[1],\n      z = q[2],\n      w = q[3];\n  var x2 = x + x;\n  var y2 = y + y;\n  var z2 = z + z;\n  var xx = x * x2;\n  var xy = x * y2;\n  var xz = x * z2;\n  var yy = y * y2;\n  var yz = y * z2;\n  var zz = z * z2;\n  var wx = w * x2;\n  var wy = w * y2;\n  var wz = w * z2;\n  out[0] = 1 - (yy + zz);\n  out[1] = xy + wz;\n  out[2] = xz - wy;\n  out[3] = 0;\n  out[4] = xy - wz;\n  out[5] = 1 - (xx + zz);\n  out[6] = yz + wx;\n  out[7] = 0;\n  out[8] = xz + wy;\n  out[9] = yz - wx;\n  out[10] = 1 - (xx + yy);\n  out[11] = 0;\n  out[12] = v[0];\n  out[13] = v[1];\n  out[14] = v[2];\n  out[15] = 1;\n  return out;\n}\n/**\n * Creates a new mat4 from a dual quat.\n *\n * @param {mat4} out Matrix\n * @param {ReadonlyQuat2} a Dual Quaternion\n * @returns {mat4} mat4 receiving operation result\n */\n\nexport function fromQuat2(out, a) {\n  var translation = new glMatrix.ARRAY_TYPE(3);\n  var bx = -a[0],\n      by = -a[1],\n      bz = -a[2],\n      bw = a[3],\n      ax = a[4],\n      ay = a[5],\n      az = a[6],\n      aw = a[7];\n  var magnitude = bx * bx + by * by + bz * bz + bw * bw; //Only scale if it makes sense\n\n  if (magnitude > 0) {\n    translation[0] = (ax * bw + aw * bx + ay * bz - az * by) * 2 / magnitude;\n    translation[1] = (ay * bw + aw * by + az * bx - ax * bz) * 2 / magnitude;\n    translation[2] = (az * bw + aw * bz + ax * by - ay * bx) * 2 / magnitude;\n  } else {\n    translation[0] = (ax * bw + aw * bx + ay * bz - az * by) * 2;\n    translation[1] = (ay * bw + aw * by + az * bx - ax * bz) * 2;\n    translation[2] = (az * bw + aw * bz + ax * by - ay * bx) * 2;\n  }\n\n  fromRotationTranslation(out, a, translation);\n  return out;\n}\n/**\n * Returns the translation vector component of a transformation\n *  matrix. If a matrix is built with fromRotationTranslation,\n *  the returned vector will be the same as the translation vector\n *  originally supplied.\n * @param  {vec3} out Vector to receive translation component\n * @param  {ReadonlyMat4} mat Matrix to be decomposed (input)\n * @return {vec3} out\n */\n\nexport function getTranslation(out, mat) {\n  out[0] = mat[12];\n  out[1] = mat[13];\n  out[2] = mat[14];\n  return out;\n}\n/**\n * Returns the scaling factor component of a transformation\n *  matrix. If a matrix is built with fromRotationTranslationScale\n *  with a normalized Quaternion paramter, the returned vector will be\n *  the same as the scaling vector\n *  originally supplied.\n * @param  {vec3} out Vector to receive scaling factor component\n * @param  {ReadonlyMat4} mat Matrix to be decomposed (input)\n * @return {vec3} out\n */\n\nexport function getScaling(out, mat) {\n  var m11 = mat[0];\n  var m12 = mat[1];\n  var m13 = mat[2];\n  var m21 = mat[4];\n  var m22 = mat[5];\n  var m23 = mat[6];\n  var m31 = mat[8];\n  var m32 = mat[9];\n  var m33 = mat[10];\n  out[0] = Math.hypot(m11, m12, m13);\n  out[1] = Math.hypot(m21, m22, m23);\n  out[2] = Math.hypot(m31, m32, m33);\n  return out;\n}\n/**\n * Returns a quaternion representing the rotational component\n *  of a transformation matrix. If a matrix is built with\n *  fromRotationTranslation, the returned quaternion will be the\n *  same as the quaternion originally supplied.\n * @param {quat} out Quaternion to receive the rotation component\n * @param {ReadonlyMat4} mat Matrix to be decomposed (input)\n * @return {quat} out\n */\n\nexport function getRotation(out, mat) {\n  var scaling = new glMatrix.ARRAY_TYPE(3);\n  getScaling(scaling, mat);\n  var is1 = 1 / scaling[0];\n  var is2 = 1 / scaling[1];\n  var is3 = 1 / scaling[2];\n  var sm11 = mat[0] * is1;\n  var sm12 = mat[1] * is2;\n  var sm13 = mat[2] * is3;\n  var sm21 = mat[4] * is1;\n  var sm22 = mat[5] * is2;\n  var sm23 = mat[6] * is3;\n  var sm31 = mat[8] * is1;\n  var sm32 = mat[9] * is2;\n  var sm33 = mat[10] * is3;\n  var trace = sm11 + sm22 + sm33;\n  var S = 0;\n\n  if (trace > 0) {\n    S = Math.sqrt(trace + 1.0) * 2;\n    out[3] = 0.25 * S;\n    out[0] = (sm23 - sm32) / S;\n    out[1] = (sm31 - sm13) / S;\n    out[2] = (sm12 - sm21) / S;\n  } else if (sm11 > sm22 && sm11 > sm33) {\n    S = Math.sqrt(1.0 + sm11 - sm22 - sm33) * 2;\n    out[3] = (sm23 - sm32) / S;\n    out[0] = 0.25 * S;\n    out[1] = (sm12 + sm21) / S;\n    out[2] = (sm31 + sm13) / S;\n  } else if (sm22 > sm33) {\n    S = Math.sqrt(1.0 + sm22 - sm11 - sm33) * 2;\n    out[3] = (sm31 - sm13) / S;\n    out[0] = (sm12 + sm21) / S;\n    out[1] = 0.25 * S;\n    out[2] = (sm23 + sm32) / S;\n  } else {\n    S = Math.sqrt(1.0 + sm33 - sm11 - sm22) * 2;\n    out[3] = (sm12 - sm21) / S;\n    out[0] = (sm31 + sm13) / S;\n    out[1] = (sm23 + sm32) / S;\n    out[2] = 0.25 * S;\n  }\n\n  return out;\n}\n/**\n * Creates a matrix from a quaternion rotation, vector translation and vector scale\n * This is equivalent to (but much faster than):\n *\n *     mat4.identity(dest);\n *     mat4.translate(dest, vec);\n *     let quatMat = mat4.create();\n *     quat4.toMat4(quat, quatMat);\n *     mat4.multiply(dest, quatMat);\n *     mat4.scale(dest, scale)\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {quat4} q Rotation quaternion\n * @param {ReadonlyVec3} v Translation vector\n * @param {ReadonlyVec3} s Scaling vector\n * @returns {mat4} out\n */\n\nexport function fromRotationTranslationScale(out, q, v, s) {\n  // Quaternion math\n  var x = q[0],\n      y = q[1],\n      z = q[2],\n      w = q[3];\n  var x2 = x + x;\n  var y2 = y + y;\n  var z2 = z + z;\n  var xx = x * x2;\n  var xy = x * y2;\n  var xz = x * z2;\n  var yy = y * y2;\n  var yz = y * z2;\n  var zz = z * z2;\n  var wx = w * x2;\n  var wy = w * y2;\n  var wz = w * z2;\n  var sx = s[0];\n  var sy = s[1];\n  var sz = s[2];\n  out[0] = (1 - (yy + zz)) * sx;\n  out[1] = (xy + wz) * sx;\n  out[2] = (xz - wy) * sx;\n  out[3] = 0;\n  out[4] = (xy - wz) * sy;\n  out[5] = (1 - (xx + zz)) * sy;\n  out[6] = (yz + wx) * sy;\n  out[7] = 0;\n  out[8] = (xz + wy) * sz;\n  out[9] = (yz - wx) * sz;\n  out[10] = (1 - (xx + yy)) * sz;\n  out[11] = 0;\n  out[12] = v[0];\n  out[13] = v[1];\n  out[14] = v[2];\n  out[15] = 1;\n  return out;\n}\n/**\n * Creates a matrix from a quaternion rotation, vector translation and vector scale, rotating and scaling around the given origin\n * This is equivalent to (but much faster than):\n *\n *     mat4.identity(dest);\n *     mat4.translate(dest, vec);\n *     mat4.translate(dest, origin);\n *     let quatMat = mat4.create();\n *     quat4.toMat4(quat, quatMat);\n *     mat4.multiply(dest, quatMat);\n *     mat4.scale(dest, scale)\n *     mat4.translate(dest, negativeOrigin);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {quat4} q Rotation quaternion\n * @param {ReadonlyVec3} v Translation vector\n * @param {ReadonlyVec3} s Scaling vector\n * @param {ReadonlyVec3} o The origin vector around which to scale and rotate\n * @returns {mat4} out\n */\n\nexport function fromRotationTranslationScaleOrigin(out, q, v, s, o) {\n  // Quaternion math\n  var x = q[0],\n      y = q[1],\n      z = q[2],\n      w = q[3];\n  var x2 = x + x;\n  var y2 = y + y;\n  var z2 = z + z;\n  var xx = x * x2;\n  var xy = x * y2;\n  var xz = x * z2;\n  var yy = y * y2;\n  var yz = y * z2;\n  var zz = z * z2;\n  var wx = w * x2;\n  var wy = w * y2;\n  var wz = w * z2;\n  var sx = s[0];\n  var sy = s[1];\n  var sz = s[2];\n  var ox = o[0];\n  var oy = o[1];\n  var oz = o[2];\n  var out0 = (1 - (yy + zz)) * sx;\n  var out1 = (xy + wz) * sx;\n  var out2 = (xz - wy) * sx;\n  var out4 = (xy - wz) * sy;\n  var out5 = (1 - (xx + zz)) * sy;\n  var out6 = (yz + wx) * sy;\n  var out8 = (xz + wy) * sz;\n  var out9 = (yz - wx) * sz;\n  var out10 = (1 - (xx + yy)) * sz;\n  out[0] = out0;\n  out[1] = out1;\n  out[2] = out2;\n  out[3] = 0;\n  out[4] = out4;\n  out[5] = out5;\n  out[6] = out6;\n  out[7] = 0;\n  out[8] = out8;\n  out[9] = out9;\n  out[10] = out10;\n  out[11] = 0;\n  out[12] = v[0] + ox - (out0 * ox + out4 * oy + out8 * oz);\n  out[13] = v[1] + oy - (out1 * ox + out5 * oy + out9 * oz);\n  out[14] = v[2] + oz - (out2 * ox + out6 * oy + out10 * oz);\n  out[15] = 1;\n  return out;\n}\n/**\n * Calculates a 4x4 matrix from the given quaternion\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {ReadonlyQuat} q Quaternion to create matrix from\n *\n * @returns {mat4} out\n */\n\nexport function fromQuat(out, q) {\n  var x = q[0],\n      y = q[1],\n      z = q[2],\n      w = q[3];\n  var x2 = x + x;\n  var y2 = y + y;\n  var z2 = z + z;\n  var xx = x * x2;\n  var yx = y * x2;\n  var yy = y * y2;\n  var zx = z * x2;\n  var zy = z * y2;\n  var zz = z * z2;\n  var wx = w * x2;\n  var wy = w * y2;\n  var wz = w * z2;\n  out[0] = 1 - yy - zz;\n  out[1] = yx + wz;\n  out[2] = zx - wy;\n  out[3] = 0;\n  out[4] = yx - wz;\n  out[5] = 1 - xx - zz;\n  out[6] = zy + wx;\n  out[7] = 0;\n  out[8] = zx + wy;\n  out[9] = zy - wx;\n  out[10] = 1 - xx - yy;\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\n * Generates a frustum matrix with the given bounds\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {Number} left Left bound of the frustum\n * @param {Number} right Right bound of the frustum\n * @param {Number} bottom Bottom bound of the frustum\n * @param {Number} top Top bound of the frustum\n * @param {Number} near Near bound of the frustum\n * @param {Number} far Far bound of the frustum\n * @returns {mat4} out\n */\n\nexport function frustum(out, left, right, bottom, top, near, far) {\n  var rl = 1 / (right - left);\n  var tb = 1 / (top - bottom);\n  var nf = 1 / (near - far);\n  out[0] = near * 2 * rl;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = near * 2 * tb;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = (right + left) * rl;\n  out[9] = (top + bottom) * tb;\n  out[10] = (far + near) * nf;\n  out[11] = -1;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = far * near * 2 * nf;\n  out[15] = 0;\n  return out;\n}\n/**\n * Generates a perspective projection matrix with the given bounds.\n * The near/far clip planes correspond to a normalized device coordinate Z range of [-1, 1],\n * which matches WebGL/OpenGL's clip volume.\n * Passing null/undefined/no value for far will generate infinite projection matrix.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {number} fovy Vertical field of view in radians\n * @param {number} aspect Aspect ratio. typically viewport width/height\n * @param {number} near Near bound of the frustum\n * @param {number} far Far bound of the frustum, can be null or Infinity\n * @returns {mat4} out\n */\n\nexport function perspectiveNO(out, fovy, aspect, near, far) {\n  var f = 1.0 / Math.tan(fovy / 2),\n      nf;\n  out[0] = f / aspect;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = f;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[11] = -1;\n  out[12] = 0;\n  out[13] = 0;\n  out[15] = 0;\n\n  if (far != null && far !== Infinity) {\n    nf = 1 / (near - far);\n    out[10] = (far + near) * nf;\n    out[14] = 2 * far * near * nf;\n  } else {\n    out[10] = -1;\n    out[14] = -2 * near;\n  }\n\n  return out;\n}\n/**\n * Alias for {@link mat4.perspectiveNO}\n * @function\n */\n\nexport var perspective = perspectiveNO;\n/**\n * Generates a perspective projection matrix suitable for WebGPU with the given bounds.\n * The near/far clip planes correspond to a normalized device coordinate Z range of [0, 1],\n * which matches WebGPU/Vulkan/DirectX/Metal's clip volume.\n * Passing null/undefined/no value for far will generate infinite projection matrix.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {number} fovy Vertical field of view in radians\n * @param {number} aspect Aspect ratio. typically viewport width/height\n * @param {number} near Near bound of the frustum\n * @param {number} far Far bound of the frustum, can be null or Infinity\n * @returns {mat4} out\n */\n\nexport function perspectiveZO(out, fovy, aspect, near, far) {\n  var f = 1.0 / Math.tan(fovy / 2),\n      nf;\n  out[0] = f / aspect;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = f;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[11] = -1;\n  out[12] = 0;\n  out[13] = 0;\n  out[15] = 0;\n\n  if (far != null && far !== Infinity) {\n    nf = 1 / (near - far);\n    out[10] = far * nf;\n    out[14] = far * near * nf;\n  } else {\n    out[10] = -1;\n    out[14] = -near;\n  }\n\n  return out;\n}\n/**\n * Generates a perspective projection matrix with the given field of view.\n * This is primarily useful for generating projection matrices to be used\n * with the still experiemental WebVR API.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {Object} fov Object containing the following values: upDegrees, downDegrees, leftDegrees, rightDegrees\n * @param {number} near Near bound of the frustum\n * @param {number} far Far bound of the frustum\n * @returns {mat4} out\n */\n\nexport function perspectiveFromFieldOfView(out, fov, near, far) {\n  var upTan = Math.tan(fov.upDegrees * Math.PI / 180.0);\n  var downTan = Math.tan(fov.downDegrees * Math.PI / 180.0);\n  var leftTan = Math.tan(fov.leftDegrees * Math.PI / 180.0);\n  var rightTan = Math.tan(fov.rightDegrees * Math.PI / 180.0);\n  var xScale = 2.0 / (leftTan + rightTan);\n  var yScale = 2.0 / (upTan + downTan);\n  out[0] = xScale;\n  out[1] = 0.0;\n  out[2] = 0.0;\n  out[3] = 0.0;\n  out[4] = 0.0;\n  out[5] = yScale;\n  out[6] = 0.0;\n  out[7] = 0.0;\n  out[8] = -((leftTan - rightTan) * xScale * 0.5);\n  out[9] = (upTan - downTan) * yScale * 0.5;\n  out[10] = far / (near - far);\n  out[11] = -1.0;\n  out[12] = 0.0;\n  out[13] = 0.0;\n  out[14] = far * near / (near - far);\n  out[15] = 0.0;\n  return out;\n}\n/**\n * Generates a orthogonal projection matrix with the given bounds.\n * The near/far clip planes correspond to a normalized device coordinate Z range of [-1, 1],\n * which matches WebGL/OpenGL's clip volume.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {number} left Left bound of the frustum\n * @param {number} right Right bound of the frustum\n * @param {number} bottom Bottom bound of the frustum\n * @param {number} top Top bound of the frustum\n * @param {number} near Near bound of the frustum\n * @param {number} far Far bound of the frustum\n * @returns {mat4} out\n */\n\nexport function orthoNO(out, left, right, bottom, top, near, far) {\n  var lr = 1 / (left - right);\n  var bt = 1 / (bottom - top);\n  var nf = 1 / (near - far);\n  out[0] = -2 * lr;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = -2 * bt;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[10] = 2 * nf;\n  out[11] = 0;\n  out[12] = (left + right) * lr;\n  out[13] = (top + bottom) * bt;\n  out[14] = (far + near) * nf;\n  out[15] = 1;\n  return out;\n}\n/**\n * Alias for {@link mat4.orthoNO}\n * @function\n */\n\nexport var ortho = orthoNO;\n/**\n * Generates a orthogonal projection matrix with the given bounds.\n * The near/far clip planes correspond to a normalized device coordinate Z range of [0, 1],\n * which matches WebGPU/Vulkan/DirectX/Metal's clip volume.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {number} left Left bound of the frustum\n * @param {number} right Right bound of the frustum\n * @param {number} bottom Bottom bound of the frustum\n * @param {number} top Top bound of the frustum\n * @param {number} near Near bound of the frustum\n * @param {number} far Far bound of the frustum\n * @returns {mat4} out\n */\n\nexport function orthoZO(out, left, right, bottom, top, near, far) {\n  var lr = 1 / (left - right);\n  var bt = 1 / (bottom - top);\n  var nf = 1 / (near - far);\n  out[0] = -2 * lr;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = -2 * bt;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[10] = nf;\n  out[11] = 0;\n  out[12] = (left + right) * lr;\n  out[13] = (top + bottom) * bt;\n  out[14] = near * nf;\n  out[15] = 1;\n  return out;\n}\n/**\n * Generates a look-at matrix with the given eye position, focal point, and up axis.\n * If you want a matrix that actually makes an object look at another object, you should use targetTo instead.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {ReadonlyVec3} eye Position of the viewer\n * @param {ReadonlyVec3} center Point the viewer is looking at\n * @param {ReadonlyVec3} up vec3 pointing up\n * @returns {mat4} out\n */\n\nexport function lookAt(out, eye, center, up) {\n  var x0, x1, x2, y0, y1, y2, z0, z1, z2, len;\n  var eyex = eye[0];\n  var eyey = eye[1];\n  var eyez = eye[2];\n  var upx = up[0];\n  var upy = up[1];\n  var upz = up[2];\n  var centerx = center[0];\n  var centery = center[1];\n  var centerz = center[2];\n\n  if (Math.abs(eyex - centerx) < glMatrix.EPSILON && Math.abs(eyey - centery) < glMatrix.EPSILON && Math.abs(eyez - centerz) < glMatrix.EPSILON) {\n    return identity(out);\n  }\n\n  z0 = eyex - centerx;\n  z1 = eyey - centery;\n  z2 = eyez - centerz;\n  len = 1 / Math.hypot(z0, z1, z2);\n  z0 *= len;\n  z1 *= len;\n  z2 *= len;\n  x0 = upy * z2 - upz * z1;\n  x1 = upz * z0 - upx * z2;\n  x2 = upx * z1 - upy * z0;\n  len = Math.hypot(x0, x1, x2);\n\n  if (!len) {\n    x0 = 0;\n    x1 = 0;\n    x2 = 0;\n  } else {\n    len = 1 / len;\n    x0 *= len;\n    x1 *= len;\n    x2 *= len;\n  }\n\n  y0 = z1 * x2 - z2 * x1;\n  y1 = z2 * x0 - z0 * x2;\n  y2 = z0 * x1 - z1 * x0;\n  len = Math.hypot(y0, y1, y2);\n\n  if (!len) {\n    y0 = 0;\n    y1 = 0;\n    y2 = 0;\n  } else {\n    len = 1 / len;\n    y0 *= len;\n    y1 *= len;\n    y2 *= len;\n  }\n\n  out[0] = x0;\n  out[1] = y0;\n  out[2] = z0;\n  out[3] = 0;\n  out[4] = x1;\n  out[5] = y1;\n  out[6] = z1;\n  out[7] = 0;\n  out[8] = x2;\n  out[9] = y2;\n  out[10] = z2;\n  out[11] = 0;\n  out[12] = -(x0 * eyex + x1 * eyey + x2 * eyez);\n  out[13] = -(y0 * eyex + y1 * eyey + y2 * eyez);\n  out[14] = -(z0 * eyex + z1 * eyey + z2 * eyez);\n  out[15] = 1;\n  return out;\n}\n/**\n * Generates a matrix that makes something look at something else.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {ReadonlyVec3} eye Position of the viewer\n * @param {ReadonlyVec3} center Point the viewer is looking at\n * @param {ReadonlyVec3} up vec3 pointing up\n * @returns {mat4} out\n */\n\nexport function targetTo(out, eye, target, up) {\n  var eyex = eye[0],\n      eyey = eye[1],\n      eyez = eye[2],\n      upx = up[0],\n      upy = up[1],\n      upz = up[2];\n  var z0 = eyex - target[0],\n      z1 = eyey - target[1],\n      z2 = eyez - target[2];\n  var len = z0 * z0 + z1 * z1 + z2 * z2;\n\n  if (len > 0) {\n    len = 1 / Math.sqrt(len);\n    z0 *= len;\n    z1 *= len;\n    z2 *= len;\n  }\n\n  var x0 = upy * z2 - upz * z1,\n      x1 = upz * z0 - upx * z2,\n      x2 = upx * z1 - upy * z0;\n  len = x0 * x0 + x1 * x1 + x2 * x2;\n\n  if (len > 0) {\n    len = 1 / Math.sqrt(len);\n    x0 *= len;\n    x1 *= len;\n    x2 *= len;\n  }\n\n  out[0] = x0;\n  out[1] = x1;\n  out[2] = x2;\n  out[3] = 0;\n  out[4] = z1 * x2 - z2 * x1;\n  out[5] = z2 * x0 - z0 * x2;\n  out[6] = z0 * x1 - z1 * x0;\n  out[7] = 0;\n  out[8] = z0;\n  out[9] = z1;\n  out[10] = z2;\n  out[11] = 0;\n  out[12] = eyex;\n  out[13] = eyey;\n  out[14] = eyez;\n  out[15] = 1;\n  return out;\n}\n/**\n * Returns a string representation of a mat4\n *\n * @param {ReadonlyMat4} a matrix to represent as a string\n * @returns {String} string representation of the matrix\n */\n\nexport function str(a) {\n  return \"mat4(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \", \" + a[3] + \", \" + a[4] + \", \" + a[5] + \", \" + a[6] + \", \" + a[7] + \", \" + a[8] + \", \" + a[9] + \", \" + a[10] + \", \" + a[11] + \", \" + a[12] + \", \" + a[13] + \", \" + a[14] + \", \" + a[15] + \")\";\n}\n/**\n * Returns Frobenius norm of a mat4\n *\n * @param {ReadonlyMat4} a the matrix to calculate Frobenius norm of\n * @returns {Number} Frobenius norm\n */\n\nexport function frob(a) {\n  return Math.hypot(a[0], a[1], a[2], a[3], a[4], a[5], a[6], a[7], a[8], a[9], a[10], a[11], a[12], a[13], a[14], a[15]);\n}\n/**\n * Adds two mat4's\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the first operand\n * @param {ReadonlyMat4} b the second operand\n * @returns {mat4} out\n */\n\nexport function add(out, a, b) {\n  out[0] = a[0] + b[0];\n  out[1] = a[1] + b[1];\n  out[2] = a[2] + b[2];\n  out[3] = a[3] + b[3];\n  out[4] = a[4] + b[4];\n  out[5] = a[5] + b[5];\n  out[6] = a[6] + b[6];\n  out[7] = a[7] + b[7];\n  out[8] = a[8] + b[8];\n  out[9] = a[9] + b[9];\n  out[10] = a[10] + b[10];\n  out[11] = a[11] + b[11];\n  out[12] = a[12] + b[12];\n  out[13] = a[13] + b[13];\n  out[14] = a[14] + b[14];\n  out[15] = a[15] + b[15];\n  return out;\n}\n/**\n * Subtracts matrix b from matrix a\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the first operand\n * @param {ReadonlyMat4} b the second operand\n * @returns {mat4} out\n */\n\nexport function subtract(out, a, b) {\n  out[0] = a[0] - b[0];\n  out[1] = a[1] - b[1];\n  out[2] = a[2] - b[2];\n  out[3] = a[3] - b[3];\n  out[4] = a[4] - b[4];\n  out[5] = a[5] - b[5];\n  out[6] = a[6] - b[6];\n  out[7] = a[7] - b[7];\n  out[8] = a[8] - b[8];\n  out[9] = a[9] - b[9];\n  out[10] = a[10] - b[10];\n  out[11] = a[11] - b[11];\n  out[12] = a[12] - b[12];\n  out[13] = a[13] - b[13];\n  out[14] = a[14] - b[14];\n  out[15] = a[15] - b[15];\n  return out;\n}\n/**\n * Multiply each element of the matrix by a scalar.\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to scale\n * @param {Number} b amount to scale the matrix's elements by\n * @returns {mat4} out\n */\n\nexport function multiplyScalar(out, a, b) {\n  out[0] = a[0] * b;\n  out[1] = a[1] * b;\n  out[2] = a[2] * b;\n  out[3] = a[3] * b;\n  out[4] = a[4] * b;\n  out[5] = a[5] * b;\n  out[6] = a[6] * b;\n  out[7] = a[7] * b;\n  out[8] = a[8] * b;\n  out[9] = a[9] * b;\n  out[10] = a[10] * b;\n  out[11] = a[11] * b;\n  out[12] = a[12] * b;\n  out[13] = a[13] * b;\n  out[14] = a[14] * b;\n  out[15] = a[15] * b;\n  return out;\n}\n/**\n * Adds two mat4's after multiplying each element of the second operand by a scalar value.\n *\n * @param {mat4} out the receiving vector\n * @param {ReadonlyMat4} a the first operand\n * @param {ReadonlyMat4} b the second operand\n * @param {Number} scale the amount to scale b's elements by before adding\n * @returns {mat4} out\n */\n\nexport function multiplyScalarAndAdd(out, a, b, scale) {\n  out[0] = a[0] + b[0] * scale;\n  out[1] = a[1] + b[1] * scale;\n  out[2] = a[2] + b[2] * scale;\n  out[3] = a[3] + b[3] * scale;\n  out[4] = a[4] + b[4] * scale;\n  out[5] = a[5] + b[5] * scale;\n  out[6] = a[6] + b[6] * scale;\n  out[7] = a[7] + b[7] * scale;\n  out[8] = a[8] + b[8] * scale;\n  out[9] = a[9] + b[9] * scale;\n  out[10] = a[10] + b[10] * scale;\n  out[11] = a[11] + b[11] * scale;\n  out[12] = a[12] + b[12] * scale;\n  out[13] = a[13] + b[13] * scale;\n  out[14] = a[14] + b[14] * scale;\n  out[15] = a[15] + b[15] * scale;\n  return out;\n}\n/**\n * Returns whether or not the matrices have exactly the same elements in the same position (when compared with ===)\n *\n * @param {ReadonlyMat4} a The first matrix.\n * @param {ReadonlyMat4} b The second matrix.\n * @returns {Boolean} True if the matrices are equal, false otherwise.\n */\n\nexport function exactEquals(a, b) {\n  return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3] && a[4] === b[4] && a[5] === b[5] && a[6] === b[6] && a[7] === b[7] && a[8] === b[8] && a[9] === b[9] && a[10] === b[10] && a[11] === b[11] && a[12] === b[12] && a[13] === b[13] && a[14] === b[14] && a[15] === b[15];\n}\n/**\n * Returns whether or not the matrices have approximately the same elements in the same position.\n *\n * @param {ReadonlyMat4} a The first matrix.\n * @param {ReadonlyMat4} b The second matrix.\n * @returns {Boolean} True if the matrices are equal, false otherwise.\n */\n\nexport function equals(a, b) {\n  var a0 = a[0],\n      a1 = a[1],\n      a2 = a[2],\n      a3 = a[3];\n  var a4 = a[4],\n      a5 = a[5],\n      a6 = a[6],\n      a7 = a[7];\n  var a8 = a[8],\n      a9 = a[9],\n      a10 = a[10],\n      a11 = a[11];\n  var a12 = a[12],\n      a13 = a[13],\n      a14 = a[14],\n      a15 = a[15];\n  var b0 = b[0],\n      b1 = b[1],\n      b2 = b[2],\n      b3 = b[3];\n  var b4 = b[4],\n      b5 = b[5],\n      b6 = b[6],\n      b7 = b[7];\n  var b8 = b[8],\n      b9 = b[9],\n      b10 = b[10],\n      b11 = b[11];\n  var b12 = b[12],\n      b13 = b[13],\n      b14 = b[14],\n      b15 = b[15];\n  return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3)) && Math.abs(a4 - b4) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a4), Math.abs(b4)) && Math.abs(a5 - b5) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a5), Math.abs(b5)) && Math.abs(a6 - b6) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a6), Math.abs(b6)) && Math.abs(a7 - b7) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a7), Math.abs(b7)) && Math.abs(a8 - b8) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a8), Math.abs(b8)) && Math.abs(a9 - b9) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a9), Math.abs(b9)) && Math.abs(a10 - b10) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a10), Math.abs(b10)) && Math.abs(a11 - b11) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a11), Math.abs(b11)) && Math.abs(a12 - b12) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a12), Math.abs(b12)) && Math.abs(a13 - b13) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a13), Math.abs(b13)) && Math.abs(a14 - b14) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a14), Math.abs(b14)) && Math.abs(a15 - b15) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a15), Math.abs(b15));\n}\n/**\n * Alias for {@link mat4.multiply}\n * @function\n */\n\nexport var mul = multiply;\n/**\n * Alias for {@link mat4.subtract}\n * @function\n */\n\nexport var sub = subtract;","function _assertThisInitialized(self) {\n  if (self === void 0) {\n    throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\");\n  }\n\n  return self;\n}\n\nmodule.exports = _assertThisInitialized;","function _typeof(obj) {\n  if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") {\n    module.exports = _typeof = function _typeof(obj) {\n      return typeof obj;\n    };\n  } else {\n    module.exports = _typeof = function _typeof(obj) {\n      return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj;\n    };\n  }\n\n  return _typeof(obj);\n}\n\nmodule.exports = _typeof;","// Replacement for the external assert method to reduce bundle size\n// Note: We don't use the second \"message\" argument in calling code,\n// so no need to support it here\nexport default function assert(condition: any, message?: string): asserts condition {\n  if (!condition) {\n    throw new Error(message || 'deck.gl: assertion failed.');\n  }\n}\n","/**\n * Copyright (c) 2013-present, Facebook, Inc.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\nif (process.env.NODE_ENV !== 'production') {\n  var ReactIs = require('react-is');\n\n  // By explicitly using `prop-types` you are opting into new development behavior.\n  // http://fb.me/prop-types-in-prod\n  var throwOnDirectAccess = true;\n  module.exports = require('./factoryWithTypeCheckers')(ReactIs.isElement, throwOnDirectAccess);\n} else {\n  // By explicitly using `prop-types` you are opting into new production behavior.\n  // http://fb.me/prop-types-in-prod\n  module.exports = require('./factoryWithThrowingShims')();\n}\n","import deckLog from '../utils/log';\nimport {getLoggers} from './loggers';\n\n/* debug utility */\n\nlet loggers: Record<string, Function> = {};\n\n// Conditionally load default loggers in development mode\n// eslint-disable-next-line\nif (process.env.NODE_ENV !== 'production') {\n  loggers = getLoggers(deckLog);\n}\n\nexport function register(handlers: Record<string, Function>): void {\n  loggers = handlers;\n}\n\nexport default function debug(eventType: string, arg1?: any, arg2?: any, arg3?: any): void {\n  if (deckLog.level > 0 && loggers[eventType]) {\n    // Not using rest parameters to defeat perf hit from array construction\n    loggers[eventType].call(null, arg1, arg2, arg3);\n  }\n}\n","import Resource from './resource';\nimport Accessor from './accessor';\nimport { getGLTypeFromTypedArray, getTypedArrayFromGLType } from '../webgl-utils/typed-array-utils';\nimport { assertWebGL2Context, log } from '@luma.gl/gltools';\nimport { assert } from '../utils/assert';\nimport { checkProps } from '../utils/check-props';\nconst DEBUG_DATA_LENGTH = 10;\nconst DEPRECATED_PROPS = {\n  offset: 'accessor.offset',\n  stride: 'accessor.stride',\n  type: 'accessor.type',\n  size: 'accessor.size',\n  divisor: 'accessor.divisor',\n  normalized: 'accessor.normalized',\n  integer: 'accessor.integer',\n  instanced: 'accessor.divisor',\n  isInstanced: 'accessor.divisor'\n};\nconst PROP_CHECKS_INITIALIZE = {\n  removedProps: {},\n  replacedProps: {\n    bytes: 'byteLength'\n  },\n  deprecatedProps: DEPRECATED_PROPS\n};\nconst PROP_CHECKS_SET_PROPS = {\n  removedProps: DEPRECATED_PROPS\n};\nexport default class Buffer extends Resource {\n  get [Symbol.toStringTag]() {\n    return 'Buffer';\n  }\n\n  constructor(gl) {\n    let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    super(gl, props);\n    this.stubRemovedMethods('Buffer', 'v6.0', ['layout', 'setLayout', 'getIndexedParameter']);\n    this.target = props.target || (this.gl.webgl2 ? 36662 : 34962);\n    this.initialize(props);\n    Object.seal(this);\n  }\n\n  getElementCount() {\n    let accessor = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.accessor;\n    return Math.round(this.byteLength / Accessor.getBytesPerElement(accessor));\n  }\n\n  getVertexCount() {\n    let accessor = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.accessor;\n    return Math.round(this.byteLength / Accessor.getBytesPerVertex(accessor));\n  }\n\n  initialize() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    if (ArrayBuffer.isView(props)) {\n      props = {\n        data: props\n      };\n    }\n\n    if (Number.isFinite(props)) {\n      props = {\n        byteLength: props\n      };\n    }\n\n    props = checkProps('Buffer', props, PROP_CHECKS_INITIALIZE);\n    this.usage = props.usage || 35044;\n    this.debugData = null;\n    this.setAccessor(Object.assign({}, props, props.accessor));\n\n    if (props.data) {\n      this._setData(props.data, props.offset, props.byteLength);\n    } else {\n      this._setByteLength(props.byteLength || 0);\n    }\n\n    return this;\n  }\n\n  setProps(props) {\n    props = checkProps('Buffer', props, PROP_CHECKS_SET_PROPS);\n\n    if ('accessor' in props) {\n      this.setAccessor(props.accessor);\n    }\n\n    return this;\n  }\n\n  setAccessor(accessor) {\n    accessor = Object.assign({}, accessor);\n    delete accessor.buffer;\n    this.accessor = new Accessor(accessor);\n    return this;\n  }\n\n  reallocate(byteLength) {\n    if (byteLength > this.byteLength) {\n      this._setByteLength(byteLength);\n\n      return true;\n    }\n\n    this.bytesUsed = byteLength;\n    return false;\n  }\n\n  setData(props) {\n    return this.initialize(props);\n  }\n\n  subData(props) {\n    if (ArrayBuffer.isView(props)) {\n      props = {\n        data: props\n      };\n    }\n\n    const {\n      data,\n      offset = 0,\n      srcOffset = 0\n    } = props;\n    const byteLength = props.byteLength || props.length;\n    assert(data);\n    const target = this.gl.webgl2 ? 36663 : this.target;\n    this.gl.bindBuffer(target, this.handle);\n\n    if (srcOffset !== 0 || byteLength !== undefined) {\n      assertWebGL2Context(this.gl);\n      this.gl.bufferSubData(this.target, offset, data, srcOffset, byteLength);\n    } else {\n      this.gl.bufferSubData(target, offset, data);\n    }\n\n    this.gl.bindBuffer(target, null);\n    this.debugData = null;\n\n    this._inferType(data);\n\n    return this;\n  }\n\n  copyData(_ref) {\n    let {\n      sourceBuffer,\n      readOffset = 0,\n      writeOffset = 0,\n      size\n    } = _ref;\n    const {\n      gl\n    } = this;\n    assertWebGL2Context(gl);\n    gl.bindBuffer(36662, sourceBuffer.handle);\n    gl.bindBuffer(36663, this.handle);\n    gl.copyBufferSubData(36662, 36663, readOffset, writeOffset, size);\n    gl.bindBuffer(36662, null);\n    gl.bindBuffer(36663, null);\n    this.debugData = null;\n    return this;\n  }\n\n  getData() {\n    let {\n      dstData = null,\n      srcByteOffset = 0,\n      dstOffset = 0,\n      length = 0\n    } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    assertWebGL2Context(this.gl);\n    const ArrayType = getTypedArrayFromGLType(this.accessor.type || 5126, {\n      clamped: false\n    });\n\n    const sourceAvailableElementCount = this._getAvailableElementCount(srcByteOffset);\n\n    const dstElementOffset = dstOffset;\n    let dstAvailableElementCount;\n    let dstElementCount;\n\n    if (dstData) {\n      dstElementCount = dstData.length;\n      dstAvailableElementCount = dstElementCount - dstElementOffset;\n    } else {\n      dstAvailableElementCount = Math.min(sourceAvailableElementCount, length || sourceAvailableElementCount);\n      dstElementCount = dstElementOffset + dstAvailableElementCount;\n    }\n\n    const copyElementCount = Math.min(sourceAvailableElementCount, dstAvailableElementCount);\n    length = length || copyElementCount;\n    assert(length <= copyElementCount);\n    dstData = dstData || new ArrayType(dstElementCount);\n    this.gl.bindBuffer(36662, this.handle);\n    this.gl.getBufferSubData(36662, srcByteOffset, dstData, dstOffset, length);\n    this.gl.bindBuffer(36662, null);\n    return dstData;\n  }\n\n  bind() {\n    let {\n      target = this.target,\n      index = this.accessor && this.accessor.index,\n      offset = 0,\n      size\n    } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    if (target === 35345 || target === 35982) {\n      if (size !== undefined) {\n        this.gl.bindBufferRange(target, index, this.handle, offset, size);\n      } else {\n        assert(offset === 0);\n        this.gl.bindBufferBase(target, index, this.handle);\n      }\n    } else {\n      this.gl.bindBuffer(target, this.handle);\n    }\n\n    return this;\n  }\n\n  unbind() {\n    let {\n      target = this.target,\n      index = this.accessor && this.accessor.index\n    } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const isIndexedBuffer = target === 35345 || target === 35982;\n\n    if (isIndexedBuffer) {\n      this.gl.bindBufferBase(target, index, null);\n    } else {\n      this.gl.bindBuffer(target, null);\n    }\n\n    return this;\n  }\n\n  getDebugData() {\n    if (!this.debugData) {\n      this.debugData = this.getData({\n        length: Math.min(DEBUG_DATA_LENGTH, this.byteLength)\n      });\n      return {\n        data: this.debugData,\n        changed: true\n      };\n    }\n\n    return {\n      data: this.debugData,\n      changed: false\n    };\n  }\n\n  invalidateDebugData() {\n    this.debugData = null;\n  }\n\n  _setData(data) {\n    let offset = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;\n    let byteLength = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : data.byteLength + offset;\n    assert(ArrayBuffer.isView(data));\n\n    this._trackDeallocatedMemory();\n\n    const target = this._getTarget();\n\n    this.gl.bindBuffer(target, this.handle);\n    this.gl.bufferData(target, byteLength, this.usage);\n    this.gl.bufferSubData(target, offset, data);\n    this.gl.bindBuffer(target, null);\n    this.debugData = data.slice(0, DEBUG_DATA_LENGTH);\n    this.bytesUsed = byteLength;\n\n    this._trackAllocatedMemory(byteLength);\n\n    const type = getGLTypeFromTypedArray(data);\n    assert(type);\n    this.setAccessor(new Accessor(this.accessor, {\n      type\n    }));\n    return this;\n  }\n\n  _setByteLength(byteLength) {\n    let usage = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this.usage;\n    assert(byteLength >= 0);\n\n    this._trackDeallocatedMemory();\n\n    let data = byteLength;\n\n    if (byteLength === 0) {\n      data = new Float32Array(0);\n    }\n\n    const target = this._getTarget();\n\n    this.gl.bindBuffer(target, this.handle);\n    this.gl.bufferData(target, data, usage);\n    this.gl.bindBuffer(target, null);\n    this.usage = usage;\n    this.debugData = null;\n    this.bytesUsed = byteLength;\n\n    this._trackAllocatedMemory(byteLength);\n\n    return this;\n  }\n\n  _getTarget() {\n    return this.gl.webgl2 ? 36663 : this.target;\n  }\n\n  _getAvailableElementCount(srcByteOffset) {\n    const ArrayType = getTypedArrayFromGLType(this.accessor.type || 5126, {\n      clamped: false\n    });\n    const sourceElementOffset = srcByteOffset / ArrayType.BYTES_PER_ELEMENT;\n    return this.getElementCount() - sourceElementOffset;\n  }\n\n  _inferType(data) {\n    if (!this.accessor.type) {\n      this.setAccessor(new Accessor(this.accessor, {\n        type: getGLTypeFromTypedArray(data)\n      }));\n    }\n  }\n\n  _createHandle() {\n    return this.gl.createBuffer();\n  }\n\n  _deleteHandle() {\n    this.gl.deleteBuffer(this.handle);\n\n    this._trackDeallocatedMemory();\n  }\n\n  _getParameter(pname) {\n    this.gl.bindBuffer(this.target, this.handle);\n    const value = this.gl.getBufferParameter(this.target, pname);\n    this.gl.bindBuffer(this.target, null);\n    return value;\n  }\n\n  get type() {\n    log.deprecated('Buffer.type', 'Buffer.accessor.type')();\n    return this.accessor.type;\n  }\n\n  get bytes() {\n    log.deprecated('Buffer.bytes', 'Buffer.byteLength')();\n    return this.byteLength;\n  }\n\n  setByteLength(byteLength) {\n    log.deprecated('setByteLength', 'reallocate')();\n    return this.reallocate(byteLength);\n  }\n\n  updateAccessor(opts) {\n    log.deprecated('updateAccessor(...)', 'setAccessor(new Accessor(buffer.accessor, ...)')();\n    this.accessor = new Accessor(this.accessor, opts);\n    return this;\n  }\n\n}\n//# sourceMappingURL=buffer.js.map","import * as glMatrix from \"./common.js\";\n/**\n * 2 Dimensional Vector\n * @module vec2\n */\n\n/**\n * Creates a new, empty vec2\n *\n * @returns {vec2} a new 2D vector\n */\n\nexport function create() {\n  var out = new glMatrix.ARRAY_TYPE(2);\n\n  if (glMatrix.ARRAY_TYPE != Float32Array) {\n    out[0] = 0;\n    out[1] = 0;\n  }\n\n  return out;\n}\n/**\n * Creates a new vec2 initialized with values from an existing vector\n *\n * @param {ReadonlyVec2} a vector to clone\n * @returns {vec2} a new 2D vector\n */\n\nexport function clone(a) {\n  var out = new glMatrix.ARRAY_TYPE(2);\n  out[0] = a[0];\n  out[1] = a[1];\n  return out;\n}\n/**\n * Creates a new vec2 initialized with the given values\n *\n * @param {Number} x X component\n * @param {Number} y Y component\n * @returns {vec2} a new 2D vector\n */\n\nexport function fromValues(x, y) {\n  var out = new glMatrix.ARRAY_TYPE(2);\n  out[0] = x;\n  out[1] = y;\n  return out;\n}\n/**\n * Copy the values from one vec2 to another\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the source vector\n * @returns {vec2} out\n */\n\nexport function copy(out, a) {\n  out[0] = a[0];\n  out[1] = a[1];\n  return out;\n}\n/**\n * Set the components of a vec2 to the given values\n *\n * @param {vec2} out the receiving vector\n * @param {Number} x X component\n * @param {Number} y Y component\n * @returns {vec2} out\n */\n\nexport function set(out, x, y) {\n  out[0] = x;\n  out[1] = y;\n  return out;\n}\n/**\n * Adds two vec2's\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec2} out\n */\n\nexport function add(out, a, b) {\n  out[0] = a[0] + b[0];\n  out[1] = a[1] + b[1];\n  return out;\n}\n/**\n * Subtracts vector b from vector a\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec2} out\n */\n\nexport function subtract(out, a, b) {\n  out[0] = a[0] - b[0];\n  out[1] = a[1] - b[1];\n  return out;\n}\n/**\n * Multiplies two vec2's\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec2} out\n */\n\nexport function multiply(out, a, b) {\n  out[0] = a[0] * b[0];\n  out[1] = a[1] * b[1];\n  return out;\n}\n/**\n * Divides two vec2's\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec2} out\n */\n\nexport function divide(out, a, b) {\n  out[0] = a[0] / b[0];\n  out[1] = a[1] / b[1];\n  return out;\n}\n/**\n * Math.ceil the components of a vec2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a vector to ceil\n * @returns {vec2} out\n */\n\nexport function ceil(out, a) {\n  out[0] = Math.ceil(a[0]);\n  out[1] = Math.ceil(a[1]);\n  return out;\n}\n/**\n * Math.floor the components of a vec2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a vector to floor\n * @returns {vec2} out\n */\n\nexport function floor(out, a) {\n  out[0] = Math.floor(a[0]);\n  out[1] = Math.floor(a[1]);\n  return out;\n}\n/**\n * Returns the minimum of two vec2's\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec2} out\n */\n\nexport function min(out, a, b) {\n  out[0] = Math.min(a[0], b[0]);\n  out[1] = Math.min(a[1], b[1]);\n  return out;\n}\n/**\n * Returns the maximum of two vec2's\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec2} out\n */\n\nexport function max(out, a, b) {\n  out[0] = Math.max(a[0], b[0]);\n  out[1] = Math.max(a[1], b[1]);\n  return out;\n}\n/**\n * Math.round the components of a vec2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a vector to round\n * @returns {vec2} out\n */\n\nexport function round(out, a) {\n  out[0] = Math.round(a[0]);\n  out[1] = Math.round(a[1]);\n  return out;\n}\n/**\n * Scales a vec2 by a scalar number\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the vector to scale\n * @param {Number} b amount to scale the vector by\n * @returns {vec2} out\n */\n\nexport function scale(out, a, b) {\n  out[0] = a[0] * b;\n  out[1] = a[1] * b;\n  return out;\n}\n/**\n * Adds two vec2's after scaling the second operand by a scalar value\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @param {Number} scale the amount to scale b by before adding\n * @returns {vec2} out\n */\n\nexport function scaleAndAdd(out, a, b, scale) {\n  out[0] = a[0] + b[0] * scale;\n  out[1] = a[1] + b[1] * scale;\n  return out;\n}\n/**\n * Calculates the euclidian distance between two vec2's\n *\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {Number} distance between a and b\n */\n\nexport function distance(a, b) {\n  var x = b[0] - a[0],\n      y = b[1] - a[1];\n  return Math.hypot(x, y);\n}\n/**\n * Calculates the squared euclidian distance between two vec2's\n *\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {Number} squared distance between a and b\n */\n\nexport function squaredDistance(a, b) {\n  var x = b[0] - a[0],\n      y = b[1] - a[1];\n  return x * x + y * y;\n}\n/**\n * Calculates the length of a vec2\n *\n * @param {ReadonlyVec2} a vector to calculate length of\n * @returns {Number} length of a\n */\n\nexport function length(a) {\n  var x = a[0],\n      y = a[1];\n  return Math.hypot(x, y);\n}\n/**\n * Calculates the squared length of a vec2\n *\n * @param {ReadonlyVec2} a vector to calculate squared length of\n * @returns {Number} squared length of a\n */\n\nexport function squaredLength(a) {\n  var x = a[0],\n      y = a[1];\n  return x * x + y * y;\n}\n/**\n * Negates the components of a vec2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a vector to negate\n * @returns {vec2} out\n */\n\nexport function negate(out, a) {\n  out[0] = -a[0];\n  out[1] = -a[1];\n  return out;\n}\n/**\n * Returns the inverse of the components of a vec2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a vector to invert\n * @returns {vec2} out\n */\n\nexport function inverse(out, a) {\n  out[0] = 1.0 / a[0];\n  out[1] = 1.0 / a[1];\n  return out;\n}\n/**\n * Normalize a vec2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a vector to normalize\n * @returns {vec2} out\n */\n\nexport function normalize(out, a) {\n  var x = a[0],\n      y = a[1];\n  var len = x * x + y * y;\n\n  if (len > 0) {\n    //TODO: evaluate use of glm_invsqrt here?\n    len = 1 / Math.sqrt(len);\n  }\n\n  out[0] = a[0] * len;\n  out[1] = a[1] * len;\n  return out;\n}\n/**\n * Calculates the dot product of two vec2's\n *\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {Number} dot product of a and b\n */\n\nexport function dot(a, b) {\n  return a[0] * b[0] + a[1] * b[1];\n}\n/**\n * Computes the cross product of two vec2's\n * Note that the cross product must by definition produce a 3D vector\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec3} out\n */\n\nexport function cross(out, a, b) {\n  var z = a[0] * b[1] - a[1] * b[0];\n  out[0] = out[1] = 0;\n  out[2] = z;\n  return out;\n}\n/**\n * Performs a linear interpolation between two vec2's\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {vec2} out\n */\n\nexport function lerp(out, a, b, t) {\n  var ax = a[0],\n      ay = a[1];\n  out[0] = ax + t * (b[0] - ax);\n  out[1] = ay + t * (b[1] - ay);\n  return out;\n}\n/**\n * Generates a random vector with the given scale\n *\n * @param {vec2} out the receiving vector\n * @param {Number} [scale] Length of the resulting vector. If ommitted, a unit vector will be returned\n * @returns {vec2} out\n */\n\nexport function random(out, scale) {\n  scale = scale || 1.0;\n  var r = glMatrix.RANDOM() * 2.0 * Math.PI;\n  out[0] = Math.cos(r) * scale;\n  out[1] = Math.sin(r) * scale;\n  return out;\n}\n/**\n * Transforms the vec2 with a mat2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the vector to transform\n * @param {ReadonlyMat2} m matrix to transform with\n * @returns {vec2} out\n */\n\nexport function transformMat2(out, a, m) {\n  var x = a[0],\n      y = a[1];\n  out[0] = m[0] * x + m[2] * y;\n  out[1] = m[1] * x + m[3] * y;\n  return out;\n}\n/**\n * Transforms the vec2 with a mat2d\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the vector to transform\n * @param {ReadonlyMat2d} m matrix to transform with\n * @returns {vec2} out\n */\n\nexport function transformMat2d(out, a, m) {\n  var x = a[0],\n      y = a[1];\n  out[0] = m[0] * x + m[2] * y + m[4];\n  out[1] = m[1] * x + m[3] * y + m[5];\n  return out;\n}\n/**\n * Transforms the vec2 with a mat3\n * 3rd vector component is implicitly '1'\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the vector to transform\n * @param {ReadonlyMat3} m matrix to transform with\n * @returns {vec2} out\n */\n\nexport function transformMat3(out, a, m) {\n  var x = a[0],\n      y = a[1];\n  out[0] = m[0] * x + m[3] * y + m[6];\n  out[1] = m[1] * x + m[4] * y + m[7];\n  return out;\n}\n/**\n * Transforms the vec2 with a mat4\n * 3rd vector component is implicitly '0'\n * 4th vector component is implicitly '1'\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the vector to transform\n * @param {ReadonlyMat4} m matrix to transform with\n * @returns {vec2} out\n */\n\nexport function transformMat4(out, a, m) {\n  var x = a[0];\n  var y = a[1];\n  out[0] = m[0] * x + m[4] * y + m[12];\n  out[1] = m[1] * x + m[5] * y + m[13];\n  return out;\n}\n/**\n * Rotate a 2D vector\n * @param {vec2} out The receiving vec2\n * @param {ReadonlyVec2} a The vec2 point to rotate\n * @param {ReadonlyVec2} b The origin of the rotation\n * @param {Number} rad The angle of rotation in radians\n * @returns {vec2} out\n */\n\nexport function rotate(out, a, b, rad) {\n  //Translate point to the origin\n  var p0 = a[0] - b[0],\n      p1 = a[1] - b[1],\n      sinC = Math.sin(rad),\n      cosC = Math.cos(rad); //perform rotation and translate to correct position\n\n  out[0] = p0 * cosC - p1 * sinC + b[0];\n  out[1] = p0 * sinC + p1 * cosC + b[1];\n  return out;\n}\n/**\n * Get the angle between two 2D vectors\n * @param {ReadonlyVec2} a The first operand\n * @param {ReadonlyVec2} b The second operand\n * @returns {Number} The angle in radians\n */\n\nexport function angle(a, b) {\n  var x1 = a[0],\n      y1 = a[1],\n      x2 = b[0],\n      y2 = b[1],\n      // mag is the product of the magnitudes of a and b\n  mag = Math.sqrt(x1 * x1 + y1 * y1) * Math.sqrt(x2 * x2 + y2 * y2),\n      // mag &&.. short circuits if mag == 0\n  cosine = mag && (x1 * x2 + y1 * y2) / mag; // Math.min(Math.max(cosine, -1), 1) clamps the cosine between -1 and 1\n\n  return Math.acos(Math.min(Math.max(cosine, -1), 1));\n}\n/**\n * Set the components of a vec2 to zero\n *\n * @param {vec2} out the receiving vector\n * @returns {vec2} out\n */\n\nexport function zero(out) {\n  out[0] = 0.0;\n  out[1] = 0.0;\n  return out;\n}\n/**\n * Returns a string representation of a vector\n *\n * @param {ReadonlyVec2} a vector to represent as a string\n * @returns {String} string representation of the vector\n */\n\nexport function str(a) {\n  return \"vec2(\" + a[0] + \", \" + a[1] + \")\";\n}\n/**\n * Returns whether or not the vectors exactly have the same elements in the same position (when compared with ===)\n *\n * @param {ReadonlyVec2} a The first vector.\n * @param {ReadonlyVec2} b The second vector.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\n\nexport function exactEquals(a, b) {\n  return a[0] === b[0] && a[1] === b[1];\n}\n/**\n * Returns whether or not the vectors have approximately the same elements in the same position.\n *\n * @param {ReadonlyVec2} a The first vector.\n * @param {ReadonlyVec2} b The second vector.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\n\nexport function equals(a, b) {\n  var a0 = a[0],\n      a1 = a[1];\n  var b0 = b[0],\n      b1 = b[1];\n  return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1));\n}\n/**\n * Alias for {@link vec2.length}\n * @function\n */\n\nexport var len = length;\n/**\n * Alias for {@link vec2.subtract}\n * @function\n */\n\nexport var sub = subtract;\n/**\n * Alias for {@link vec2.multiply}\n * @function\n */\n\nexport var mul = multiply;\n/**\n * Alias for {@link vec2.divide}\n * @function\n */\n\nexport var div = divide;\n/**\n * Alias for {@link vec2.distance}\n * @function\n */\n\nexport var dist = distance;\n/**\n * Alias for {@link vec2.squaredDistance}\n * @function\n */\n\nexport var sqrDist = squaredDistance;\n/**\n * Alias for {@link vec2.squaredLength}\n * @function\n */\n\nexport var sqrLen = squaredLength;\n/**\n * Perform some operation over an array of vec2s.\n *\n * @param {Array} a the array of vectors to iterate over\n * @param {Number} stride Number of elements between the start of each vec2. If 0 assumes tightly packed\n * @param {Number} offset Number of elements to skip at the beginning of the array\n * @param {Number} count Number of vec2s to iterate over. If 0 iterates over entire array\n * @param {Function} fn Function to call for each vector in the array\n * @param {Object} [arg] additional argument to pass to fn\n * @returns {Array} a\n * @function\n */\n\nexport var forEach = function () {\n  var vec = create();\n  return function (a, stride, offset, count, fn, arg) {\n    var i, l;\n\n    if (!stride) {\n      stride = 2;\n    }\n\n    if (!offset) {\n      offset = 0;\n    }\n\n    if (count) {\n      l = Math.min(count * stride + offset, a.length);\n    } else {\n      l = a.length;\n    }\n\n    for (i = offset; i < l; i += stride) {\n      vec[0] = a[i];\n      vec[1] = a[i + 1];\n      fn(vec, vec, arg);\n      a[i] = vec[0];\n      a[i + 1] = vec[1];\n    }\n\n    return a;\n  };\n}();","// Extensions to math.gl library. Intended to be folded back.\nimport typedArrayManager from './typed-array-manager';\nimport {Vector3, NumericArray} from '@math.gl/core';\n\nimport type {Matrix4} from '@math.gl/core';\n\n// Helper, avoids low-precision 32 bit matrices from gl-matrix mat4.create()\nexport function createMat4(): number[] {\n  return [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];\n}\n\nexport function mod(value: number, divisor: number): number {\n  const modulus = value % divisor;\n  return modulus < 0 ? divisor + modulus : modulus;\n}\n\n// Extract camera vectors (move to math library?)\nexport function getCameraPosition(\n  viewMatrixInverse: Matrix4 | NumericArray\n): [number, number, number] {\n  // Read the translation from the inverse view matrix\n  return [viewMatrixInverse[12], viewMatrixInverse[13], viewMatrixInverse[14]];\n}\n\nexport type FrustumPlane = {\n  distance: number;\n  normal: Vector3;\n};\n\n// https://www.gamedevs.org/uploads/fast-extraction-viewing-frustum-planes-from-world-view-projection-matrix.pdf\nexport function getFrustumPlanes(viewProjectionMatrix: Matrix4 | NumericArray): {\n  left: FrustumPlane;\n  right: FrustumPlane;\n  top: FrustumPlane;\n  bottom: FrustumPlane;\n  near: FrustumPlane;\n  far: FrustumPlane;\n} {\n  return {\n    left: getFrustumPlane(\n      viewProjectionMatrix[3] + viewProjectionMatrix[0],\n      viewProjectionMatrix[7] + viewProjectionMatrix[4],\n      viewProjectionMatrix[11] + viewProjectionMatrix[8],\n      viewProjectionMatrix[15] + viewProjectionMatrix[12]\n    ),\n    right: getFrustumPlane(\n      viewProjectionMatrix[3] - viewProjectionMatrix[0],\n      viewProjectionMatrix[7] - viewProjectionMatrix[4],\n      viewProjectionMatrix[11] - viewProjectionMatrix[8],\n      viewProjectionMatrix[15] - viewProjectionMatrix[12]\n    ),\n    bottom: getFrustumPlane(\n      viewProjectionMatrix[3] + viewProjectionMatrix[1],\n      viewProjectionMatrix[7] + viewProjectionMatrix[5],\n      viewProjectionMatrix[11] + viewProjectionMatrix[9],\n      viewProjectionMatrix[15] + viewProjectionMatrix[13]\n    ),\n    top: getFrustumPlane(\n      viewProjectionMatrix[3] - viewProjectionMatrix[1],\n      viewProjectionMatrix[7] - viewProjectionMatrix[5],\n      viewProjectionMatrix[11] - viewProjectionMatrix[9],\n      viewProjectionMatrix[15] - viewProjectionMatrix[13]\n    ),\n    near: getFrustumPlane(\n      viewProjectionMatrix[3] + viewProjectionMatrix[2],\n      viewProjectionMatrix[7] + viewProjectionMatrix[6],\n      viewProjectionMatrix[11] + viewProjectionMatrix[10],\n      viewProjectionMatrix[15] + viewProjectionMatrix[14]\n    ),\n    far: getFrustumPlane(\n      viewProjectionMatrix[3] - viewProjectionMatrix[2],\n      viewProjectionMatrix[7] - viewProjectionMatrix[6],\n      viewProjectionMatrix[11] - viewProjectionMatrix[10],\n      viewProjectionMatrix[15] - viewProjectionMatrix[14]\n    )\n  };\n}\n\nconst scratchVector = new Vector3();\n\nfunction getFrustumPlane(a: number, b: number, c: number, d: number): FrustumPlane {\n  scratchVector.set(a, b, c);\n  const L = scratchVector.len();\n  return {distance: d / L, normal: new Vector3(-a / L, -b / L, -c / L)};\n}\n\n/**\n * Calculate the low part of a WebGL 64 bit float\n * @param x {number} - the input float number\n * @returns {number} - the lower 32 bit of the number\n */\nexport function fp64LowPart(x: number): number {\n  return x - Math.fround(x);\n}\n\nlet scratchArray;\n\n/**\n * Split a Float64Array into a double-length Float32Array\n * @param typedArray\n * @param options\n * @param options.size  - per attribute size\n * @param options.startIndex - start index in the source array\n * @param options.endIndex  - end index in the source array\n * @returns {} - high part, low part for each attribute:\n    [1xHi, 1yHi, 1zHi, 1xLow, 1yLow, 1zLow, 2xHi, ...]\n */\nexport function toDoublePrecisionArray(\n  typedArray: Float64Array,\n  options: {size?: number; startIndex?: number; endIndex?: number}\n): Float32Array {\n  const {size = 1, startIndex = 0} = options;\n\n  const endIndex = options.endIndex !== undefined ? options.endIndex : typedArray.length;\n\n  const count = (endIndex - startIndex) / size;\n  scratchArray = typedArrayManager.allocate(scratchArray, count, {\n    type: Float32Array,\n    size: size * 2\n  });\n\n  let sourceIndex = startIndex;\n  let targetIndex = 0;\n  while (sourceIndex < endIndex) {\n    for (let j = 0; j < size; j++) {\n      const value = typedArray[sourceIndex++];\n      scratchArray[targetIndex + j] = value;\n      scratchArray[targetIndex + j + size] = fp64LowPart(value);\n    }\n    targetIndex += size * 2;\n  }\n\n  return scratchArray.subarray(0, count * size * 2);\n}\n","import * as glMatrix from \"./common.js\";\n/**\n * 4 Dimensional Vector\n * @module vec4\n */\n\n/**\n * Creates a new, empty vec4\n *\n * @returns {vec4} a new 4D vector\n */\n\nexport function create() {\n  var out = new glMatrix.ARRAY_TYPE(4);\n\n  if (glMatrix.ARRAY_TYPE != Float32Array) {\n    out[0] = 0;\n    out[1] = 0;\n    out[2] = 0;\n    out[3] = 0;\n  }\n\n  return out;\n}\n/**\n * Creates a new vec4 initialized with values from an existing vector\n *\n * @param {ReadonlyVec4} a vector to clone\n * @returns {vec4} a new 4D vector\n */\n\nexport function clone(a) {\n  var out = new glMatrix.ARRAY_TYPE(4);\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  out[3] = a[3];\n  return out;\n}\n/**\n * Creates a new vec4 initialized with the given values\n *\n * @param {Number} x X component\n * @param {Number} y Y component\n * @param {Number} z Z component\n * @param {Number} w W component\n * @returns {vec4} a new 4D vector\n */\n\nexport function fromValues(x, y, z, w) {\n  var out = new glMatrix.ARRAY_TYPE(4);\n  out[0] = x;\n  out[1] = y;\n  out[2] = z;\n  out[3] = w;\n  return out;\n}\n/**\n * Copy the values from one vec4 to another\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the source vector\n * @returns {vec4} out\n */\n\nexport function copy(out, a) {\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  out[3] = a[3];\n  return out;\n}\n/**\n * Set the components of a vec4 to the given values\n *\n * @param {vec4} out the receiving vector\n * @param {Number} x X component\n * @param {Number} y Y component\n * @param {Number} z Z component\n * @param {Number} w W component\n * @returns {vec4} out\n */\n\nexport function set(out, x, y, z, w) {\n  out[0] = x;\n  out[1] = y;\n  out[2] = z;\n  out[3] = w;\n  return out;\n}\n/**\n * Adds two vec4's\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {vec4} out\n */\n\nexport function add(out, a, b) {\n  out[0] = a[0] + b[0];\n  out[1] = a[1] + b[1];\n  out[2] = a[2] + b[2];\n  out[3] = a[3] + b[3];\n  return out;\n}\n/**\n * Subtracts vector b from vector a\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {vec4} out\n */\n\nexport function subtract(out, a, b) {\n  out[0] = a[0] - b[0];\n  out[1] = a[1] - b[1];\n  out[2] = a[2] - b[2];\n  out[3] = a[3] - b[3];\n  return out;\n}\n/**\n * Multiplies two vec4's\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {vec4} out\n */\n\nexport function multiply(out, a, b) {\n  out[0] = a[0] * b[0];\n  out[1] = a[1] * b[1];\n  out[2] = a[2] * b[2];\n  out[3] = a[3] * b[3];\n  return out;\n}\n/**\n * Divides two vec4's\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {vec4} out\n */\n\nexport function divide(out, a, b) {\n  out[0] = a[0] / b[0];\n  out[1] = a[1] / b[1];\n  out[2] = a[2] / b[2];\n  out[3] = a[3] / b[3];\n  return out;\n}\n/**\n * Math.ceil the components of a vec4\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a vector to ceil\n * @returns {vec4} out\n */\n\nexport function ceil(out, a) {\n  out[0] = Math.ceil(a[0]);\n  out[1] = Math.ceil(a[1]);\n  out[2] = Math.ceil(a[2]);\n  out[3] = Math.ceil(a[3]);\n  return out;\n}\n/**\n * Math.floor the components of a vec4\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a vector to floor\n * @returns {vec4} out\n */\n\nexport function floor(out, a) {\n  out[0] = Math.floor(a[0]);\n  out[1] = Math.floor(a[1]);\n  out[2] = Math.floor(a[2]);\n  out[3] = Math.floor(a[3]);\n  return out;\n}\n/**\n * Returns the minimum of two vec4's\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {vec4} out\n */\n\nexport function min(out, a, b) {\n  out[0] = Math.min(a[0], b[0]);\n  out[1] = Math.min(a[1], b[1]);\n  out[2] = Math.min(a[2], b[2]);\n  out[3] = Math.min(a[3], b[3]);\n  return out;\n}\n/**\n * Returns the maximum of two vec4's\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {vec4} out\n */\n\nexport function max(out, a, b) {\n  out[0] = Math.max(a[0], b[0]);\n  out[1] = Math.max(a[1], b[1]);\n  out[2] = Math.max(a[2], b[2]);\n  out[3] = Math.max(a[3], b[3]);\n  return out;\n}\n/**\n * Math.round the components of a vec4\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a vector to round\n * @returns {vec4} out\n */\n\nexport function round(out, a) {\n  out[0] = Math.round(a[0]);\n  out[1] = Math.round(a[1]);\n  out[2] = Math.round(a[2]);\n  out[3] = Math.round(a[3]);\n  return out;\n}\n/**\n * Scales a vec4 by a scalar number\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the vector to scale\n * @param {Number} b amount to scale the vector by\n * @returns {vec4} out\n */\n\nexport function scale(out, a, b) {\n  out[0] = a[0] * b;\n  out[1] = a[1] * b;\n  out[2] = a[2] * b;\n  out[3] = a[3] * b;\n  return out;\n}\n/**\n * Adds two vec4's after scaling the second operand by a scalar value\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @param {Number} scale the amount to scale b by before adding\n * @returns {vec4} out\n */\n\nexport function scaleAndAdd(out, a, b, scale) {\n  out[0] = a[0] + b[0] * scale;\n  out[1] = a[1] + b[1] * scale;\n  out[2] = a[2] + b[2] * scale;\n  out[3] = a[3] + b[3] * scale;\n  return out;\n}\n/**\n * Calculates the euclidian distance between two vec4's\n *\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {Number} distance between a and b\n */\n\nexport function distance(a, b) {\n  var x = b[0] - a[0];\n  var y = b[1] - a[1];\n  var z = b[2] - a[2];\n  var w = b[3] - a[3];\n  return Math.hypot(x, y, z, w);\n}\n/**\n * Calculates the squared euclidian distance between two vec4's\n *\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {Number} squared distance between a and b\n */\n\nexport function squaredDistance(a, b) {\n  var x = b[0] - a[0];\n  var y = b[1] - a[1];\n  var z = b[2] - a[2];\n  var w = b[3] - a[3];\n  return x * x + y * y + z * z + w * w;\n}\n/**\n * Calculates the length of a vec4\n *\n * @param {ReadonlyVec4} a vector to calculate length of\n * @returns {Number} length of a\n */\n\nexport function length(a) {\n  var x = a[0];\n  var y = a[1];\n  var z = a[2];\n  var w = a[3];\n  return Math.hypot(x, y, z, w);\n}\n/**\n * Calculates the squared length of a vec4\n *\n * @param {ReadonlyVec4} a vector to calculate squared length of\n * @returns {Number} squared length of a\n */\n\nexport function squaredLength(a) {\n  var x = a[0];\n  var y = a[1];\n  var z = a[2];\n  var w = a[3];\n  return x * x + y * y + z * z + w * w;\n}\n/**\n * Negates the components of a vec4\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a vector to negate\n * @returns {vec4} out\n */\n\nexport function negate(out, a) {\n  out[0] = -a[0];\n  out[1] = -a[1];\n  out[2] = -a[2];\n  out[3] = -a[3];\n  return out;\n}\n/**\n * Returns the inverse of the components of a vec4\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a vector to invert\n * @returns {vec4} out\n */\n\nexport function inverse(out, a) {\n  out[0] = 1.0 / a[0];\n  out[1] = 1.0 / a[1];\n  out[2] = 1.0 / a[2];\n  out[3] = 1.0 / a[3];\n  return out;\n}\n/**\n * Normalize a vec4\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a vector to normalize\n * @returns {vec4} out\n */\n\nexport function normalize(out, a) {\n  var x = a[0];\n  var y = a[1];\n  var z = a[2];\n  var w = a[3];\n  var len = x * x + y * y + z * z + w * w;\n\n  if (len > 0) {\n    len = 1 / Math.sqrt(len);\n  }\n\n  out[0] = x * len;\n  out[1] = y * len;\n  out[2] = z * len;\n  out[3] = w * len;\n  return out;\n}\n/**\n * Calculates the dot product of two vec4's\n *\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {Number} dot product of a and b\n */\n\nexport function dot(a, b) {\n  return a[0] * b[0] + a[1] * b[1] + a[2] * b[2] + a[3] * b[3];\n}\n/**\n * Returns the cross-product of three vectors in a 4-dimensional space\n *\n * @param {ReadonlyVec4} result the receiving vector\n * @param {ReadonlyVec4} U the first vector\n * @param {ReadonlyVec4} V the second vector\n * @param {ReadonlyVec4} W the third vector\n * @returns {vec4} result\n */\n\nexport function cross(out, u, v, w) {\n  var A = v[0] * w[1] - v[1] * w[0],\n      B = v[0] * w[2] - v[2] * w[0],\n      C = v[0] * w[3] - v[3] * w[0],\n      D = v[1] * w[2] - v[2] * w[1],\n      E = v[1] * w[3] - v[3] * w[1],\n      F = v[2] * w[3] - v[3] * w[2];\n  var G = u[0];\n  var H = u[1];\n  var I = u[2];\n  var J = u[3];\n  out[0] = H * F - I * E + J * D;\n  out[1] = -(G * F) + I * C - J * B;\n  out[2] = G * E - H * C + J * A;\n  out[3] = -(G * D) + H * B - I * A;\n  return out;\n}\n/**\n * Performs a linear interpolation between two vec4's\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {vec4} out\n */\n\nexport function lerp(out, a, b, t) {\n  var ax = a[0];\n  var ay = a[1];\n  var az = a[2];\n  var aw = a[3];\n  out[0] = ax + t * (b[0] - ax);\n  out[1] = ay + t * (b[1] - ay);\n  out[2] = az + t * (b[2] - az);\n  out[3] = aw + t * (b[3] - aw);\n  return out;\n}\n/**\n * Generates a random vector with the given scale\n *\n * @param {vec4} out the receiving vector\n * @param {Number} [scale] Length of the resulting vector. If ommitted, a unit vector will be returned\n * @returns {vec4} out\n */\n\nexport function random(out, scale) {\n  scale = scale || 1.0; // Marsaglia, George. Choosing a Point from the Surface of a\n  // Sphere. Ann. Math. Statist. 43 (1972), no. 2, 645--646.\n  // http://projecteuclid.org/euclid.aoms/1177692644;\n\n  var v1, v2, v3, v4;\n  var s1, s2;\n\n  do {\n    v1 = glMatrix.RANDOM() * 2 - 1;\n    v2 = glMatrix.RANDOM() * 2 - 1;\n    s1 = v1 * v1 + v2 * v2;\n  } while (s1 >= 1);\n\n  do {\n    v3 = glMatrix.RANDOM() * 2 - 1;\n    v4 = glMatrix.RANDOM() * 2 - 1;\n    s2 = v3 * v3 + v4 * v4;\n  } while (s2 >= 1);\n\n  var d = Math.sqrt((1 - s1) / s2);\n  out[0] = scale * v1;\n  out[1] = scale * v2;\n  out[2] = scale * v3 * d;\n  out[3] = scale * v4 * d;\n  return out;\n}\n/**\n * Transforms the vec4 with a mat4.\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the vector to transform\n * @param {ReadonlyMat4} m matrix to transform with\n * @returns {vec4} out\n */\n\nexport function transformMat4(out, a, m) {\n  var x = a[0],\n      y = a[1],\n      z = a[2],\n      w = a[3];\n  out[0] = m[0] * x + m[4] * y + m[8] * z + m[12] * w;\n  out[1] = m[1] * x + m[5] * y + m[9] * z + m[13] * w;\n  out[2] = m[2] * x + m[6] * y + m[10] * z + m[14] * w;\n  out[3] = m[3] * x + m[7] * y + m[11] * z + m[15] * w;\n  return out;\n}\n/**\n * Transforms the vec4 with a quat\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the vector to transform\n * @param {ReadonlyQuat} q quaternion to transform with\n * @returns {vec4} out\n */\n\nexport function transformQuat(out, a, q) {\n  var x = a[0],\n      y = a[1],\n      z = a[2];\n  var qx = q[0],\n      qy = q[1],\n      qz = q[2],\n      qw = q[3]; // calculate quat * vec\n\n  var ix = qw * x + qy * z - qz * y;\n  var iy = qw * y + qz * x - qx * z;\n  var iz = qw * z + qx * y - qy * x;\n  var iw = -qx * x - qy * y - qz * z; // calculate result * inverse quat\n\n  out[0] = ix * qw + iw * -qx + iy * -qz - iz * -qy;\n  out[1] = iy * qw + iw * -qy + iz * -qx - ix * -qz;\n  out[2] = iz * qw + iw * -qz + ix * -qy - iy * -qx;\n  out[3] = a[3];\n  return out;\n}\n/**\n * Set the components of a vec4 to zero\n *\n * @param {vec4} out the receiving vector\n * @returns {vec4} out\n */\n\nexport function zero(out) {\n  out[0] = 0.0;\n  out[1] = 0.0;\n  out[2] = 0.0;\n  out[3] = 0.0;\n  return out;\n}\n/**\n * Returns a string representation of a vector\n *\n * @param {ReadonlyVec4} a vector to represent as a string\n * @returns {String} string representation of the vector\n */\n\nexport function str(a) {\n  return \"vec4(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \", \" + a[3] + \")\";\n}\n/**\n * Returns whether or not the vectors have exactly the same elements in the same position (when compared with ===)\n *\n * @param {ReadonlyVec4} a The first vector.\n * @param {ReadonlyVec4} b The second vector.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\n\nexport function exactEquals(a, b) {\n  return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3];\n}\n/**\n * Returns whether or not the vectors have approximately the same elements in the same position.\n *\n * @param {ReadonlyVec4} a The first vector.\n * @param {ReadonlyVec4} b The second vector.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\n\nexport function equals(a, b) {\n  var a0 = a[0],\n      a1 = a[1],\n      a2 = a[2],\n      a3 = a[3];\n  var b0 = b[0],\n      b1 = b[1],\n      b2 = b[2],\n      b3 = b[3];\n  return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3));\n}\n/**\n * Alias for {@link vec4.subtract}\n * @function\n */\n\nexport var sub = subtract;\n/**\n * Alias for {@link vec4.multiply}\n * @function\n */\n\nexport var mul = multiply;\n/**\n * Alias for {@link vec4.divide}\n * @function\n */\n\nexport var div = divide;\n/**\n * Alias for {@link vec4.distance}\n * @function\n */\n\nexport var dist = distance;\n/**\n * Alias for {@link vec4.squaredDistance}\n * @function\n */\n\nexport var sqrDist = squaredDistance;\n/**\n * Alias for {@link vec4.length}\n * @function\n */\n\nexport var len = length;\n/**\n * Alias for {@link vec4.squaredLength}\n * @function\n */\n\nexport var sqrLen = squaredLength;\n/**\n * Perform some operation over an array of vec4s.\n *\n * @param {Array} a the array of vectors to iterate over\n * @param {Number} stride Number of elements between the start of each vec4. If 0 assumes tightly packed\n * @param {Number} offset Number of elements to skip at the beginning of the array\n * @param {Number} count Number of vec4s to iterate over. If 0 iterates over entire array\n * @param {Function} fn Function to call for each vector in the array\n * @param {Object} [arg] additional argument to pass to fn\n * @returns {Array} a\n * @function\n */\n\nexport var forEach = function () {\n  var vec = create();\n  return function (a, stride, offset, count, fn, arg) {\n    var i, l;\n\n    if (!stride) {\n      stride = 4;\n    }\n\n    if (!offset) {\n      offset = 0;\n    }\n\n    if (count) {\n      l = Math.min(count * stride + offset, a.length);\n    } else {\n      l = a.length;\n    }\n\n    for (i = offset; i < l; i += stride) {\n      vec[0] = a[i];\n      vec[1] = a[i + 1];\n      vec[2] = a[i + 2];\n      vec[3] = a[i + 3];\n      fn(vec, vec, arg);\n      a[i] = vec[0];\n      a[i + 1] = vec[1];\n      a[i + 2] = vec[2];\n      a[i + 3] = vec[3];\n    }\n\n    return a;\n  };\n}();","import { equals } from '@math.gl/core';\nexport const WINDING = {\n  CLOCKWISE: 1,\n  COUNTER_CLOCKWISE: -1\n};\nexport function modifyPolygonWindingDirection(points, direction, options = {}) {\n  const windingDirection = getPolygonWindingDirection(points, options);\n\n  if (windingDirection !== direction) {\n    reversePolygon(points, options);\n    return true;\n  }\n\n  return false;\n}\nexport function getPolygonWindingDirection(points, options = {}) {\n  return Math.sign(getPolygonSignedArea(points, options));\n}\nexport function getPolygonSignedArea(points, options = {}) {\n  const {\n    start = 0,\n    end = points.length\n  } = options;\n  const dim = options.size || 2;\n  let area = 0;\n\n  for (let i = start, j = end - dim; i < end; i += dim) {\n    area += (points[i] - points[j]) * (points[i + 1] + points[j + 1]);\n    j = i;\n  }\n\n  return area / 2;\n}\nexport function forEachSegmentInPolygon(points, visitor, options = {}) {\n  const {\n    start = 0,\n    end = points.length,\n    size = 2,\n    isClosed\n  } = options;\n  const numPoints = (end - start) / size;\n\n  for (let i = 0; i < numPoints - 1; ++i) {\n    visitor(points[start + i * size], points[start + i * size + 1], points[start + (i + 1) * size], points[start + (i + 1) * size + 1], i, i + 1);\n  }\n\n  const endPointIndex = start + (numPoints - 1) * size;\n  const isClosedEx = isClosed || equals(points[start], points[endPointIndex]) && equals(points[start + 1], points[endPointIndex + 1]);\n\n  if (!isClosedEx) {\n    visitor(points[endPointIndex], points[endPointIndex + 1], points[start], points[start + 1], numPoints - 1, 0);\n  }\n}\n\nfunction reversePolygon(points, options) {\n  const {\n    start = 0,\n    end = points.length,\n    size = 2\n  } = options;\n  const numPoints = (end - start) / size;\n  const numSwaps = Math.floor(numPoints / 2);\n\n  for (let i = 0; i < numSwaps; ++i) {\n    const b1 = start + i * size;\n    const b2 = start + (numPoints - 1 - i) * size;\n\n    for (let j = 0; j < size; ++j) {\n      const tmp = points[b1 + j];\n      points[b1 + j] = points[b2 + j];\n      points[b2 + j] = tmp;\n    }\n  }\n}\n\nexport function modifyPolygonWindingDirectionPoints(points, direction, options = {}) {\n  const currentDirection = getPolygonWindingDirectionPoints(points, options);\n\n  if (currentDirection !== direction) {\n    points.reverse();\n    return true;\n  }\n\n  return false;\n}\nexport function getPolygonWindingDirectionPoints(points, options = {}) {\n  return Math.sign(getPolygonSignedAreaPoints(points, options));\n}\nexport function getPolygonSignedAreaPoints(points, options = {}) {\n  const {\n    start = 0,\n    end = points.length\n  } = options;\n  let area = 0;\n\n  for (let i = start, j = end - 1; i < end; ++i) {\n    area += (points[i][0] - points[j][0]) * (points[i][1] + points[j][1]);\n    j = i;\n  }\n\n  return area / 2;\n}\nexport function forEachSegmentInPolygonPoints(points, visitor, options = {}) {\n  const {\n    start = 0,\n    end = points.length,\n    isClosed\n  } = options;\n\n  for (let i = start; i < end - 1; ++i) {\n    visitor(points[i], points[i + 1], i, i + 1);\n  }\n\n  const isClosedEx = isClosed || equals(points[end - 1], points[0]);\n\n  if (!isClosedEx) {\n    visitor(points[end - 1], points[0], end - 1, 0);\n  }\n}\n//# sourceMappingURL=polygon-utils.js.map","import { getPolygonSignedArea } from './polygon-utils';\nexport function earcut(positions, holeIndices, dim = 2, areas) {\n  const hasHoles = holeIndices && holeIndices.length;\n  const outerLen = hasHoles ? holeIndices[0] * dim : positions.length;\n  let outerNode = linkedList(positions, 0, outerLen, dim, true, areas && areas[0]);\n  const triangles = [];\n  if (!outerNode || outerNode.next === outerNode.prev) return triangles;\n  let invSize;\n  let maxX;\n  let maxY;\n  let minX;\n  let minY;\n  let x;\n  let y;\n  if (hasHoles) outerNode = eliminateHoles(positions, holeIndices, outerNode, dim, areas);\n\n  if (positions.length > 80 * dim) {\n    minX = maxX = positions[0];\n    minY = maxY = positions[1];\n\n    for (let i = dim; i < outerLen; i += dim) {\n      x = positions[i];\n      y = positions[i + 1];\n      if (x < minX) minX = x;\n      if (y < minY) minY = y;\n      if (x > maxX) maxX = x;\n      if (y > maxY) maxY = y;\n    }\n\n    invSize = Math.max(maxX - minX, maxY - minY);\n    invSize = invSize !== 0 ? 1 / invSize : 0;\n  }\n\n  earcutLinked(outerNode, triangles, dim, minX, minY, invSize);\n  return triangles;\n}\n\nfunction linkedList(data, start, end, dim, clockwise, area) {\n  let i;\n  let last;\n\n  if (area === undefined) {\n    area = getPolygonSignedArea(data, {\n      start,\n      end,\n      size: dim\n    });\n  }\n\n  if (clockwise === area < 0) {\n    for (i = start; i < end; i += dim) last = insertNode(i, data[i], data[i + 1], last);\n  } else {\n    for (i = end - dim; i >= start; i -= dim) last = insertNode(i, data[i], data[i + 1], last);\n  }\n\n  if (last && equals(last, last.next)) {\n    removeNode(last);\n    last = last.next;\n  }\n\n  return last;\n}\n\nfunction filterPoints(start, end) {\n  if (!start) return start;\n  if (!end) end = start;\n  let p = start;\n  let again;\n\n  do {\n    again = false;\n\n    if (!p.steiner && (equals(p, p.next) || area(p.prev, p, p.next) === 0)) {\n      removeNode(p);\n      p = end = p.prev;\n      if (p === p.next) break;\n      again = true;\n    } else {\n      p = p.next;\n    }\n  } while (again || p !== end);\n\n  return end;\n}\n\nfunction earcutLinked(ear, triangles, dim, minX, minY, invSize, pass) {\n  if (!ear) return;\n  if (!pass && invSize) indexCurve(ear, minX, minY, invSize);\n  let stop = ear;\n  let prev;\n  let next;\n\n  while (ear.prev !== ear.next) {\n    prev = ear.prev;\n    next = ear.next;\n\n    if (invSize ? isEarHashed(ear, minX, minY, invSize) : isEar(ear)) {\n      triangles.push(prev.i / dim);\n      triangles.push(ear.i / dim);\n      triangles.push(next.i / dim);\n      removeNode(ear);\n      ear = next.next;\n      stop = next.next;\n      continue;\n    }\n\n    ear = next;\n\n    if (ear === stop) {\n      if (!pass) {\n        earcutLinked(filterPoints(ear), triangles, dim, minX, minY, invSize, 1);\n      } else if (pass === 1) {\n        ear = cureLocalIntersections(filterPoints(ear), triangles, dim);\n        earcutLinked(ear, triangles, dim, minX, minY, invSize, 2);\n      } else if (pass === 2) {\n        splitEarcut(ear, triangles, dim, minX, minY, invSize);\n      }\n\n      break;\n    }\n  }\n}\n\nfunction isEar(ear) {\n  const a = ear.prev;\n  const b = ear;\n  const c = ear.next;\n  if (area(a, b, c) >= 0) return false;\n  let p = ear.next.next;\n\n  while (p !== ear.prev) {\n    if (pointInTriangle(a.x, a.y, b.x, b.y, c.x, c.y, p.x, p.y) && area(p.prev, p, p.next) >= 0) return false;\n    p = p.next;\n  }\n\n  return true;\n}\n\nfunction isEarHashed(ear, minX, minY, invSize) {\n  const a = ear.prev;\n  const b = ear;\n  const c = ear.next;\n  if (area(a, b, c) >= 0) return false;\n  const minTX = a.x < b.x ? a.x < c.x ? a.x : c.x : b.x < c.x ? b.x : c.x;\n  const minTY = a.y < b.y ? a.y < c.y ? a.y : c.y : b.y < c.y ? b.y : c.y;\n  const maxTX = a.x > b.x ? a.x > c.x ? a.x : c.x : b.x > c.x ? b.x : c.x;\n  const maxTY = a.y > b.y ? a.y > c.y ? a.y : c.y : b.y > c.y ? b.y : c.y;\n  const minZ = zOrder(minTX, minTY, minX, minY, invSize);\n  const maxZ = zOrder(maxTX, maxTY, minX, minY, invSize);\n  let p = ear.prevZ;\n  let n = ear.nextZ;\n\n  while (p && p.z >= minZ && n && n.z <= maxZ) {\n    if (p !== ear.prev && p !== ear.next && pointInTriangle(a.x, a.y, b.x, b.y, c.x, c.y, p.x, p.y) && area(p.prev, p, p.next) >= 0) return false;\n    p = p.prevZ;\n    if (n !== ear.prev && n !== ear.next && pointInTriangle(a.x, a.y, b.x, b.y, c.x, c.y, n.x, n.y) && area(n.prev, n, n.next) >= 0) return false;\n    n = n.nextZ;\n  }\n\n  while (p && p.z >= minZ) {\n    if (p !== ear.prev && p !== ear.next && pointInTriangle(a.x, a.y, b.x, b.y, c.x, c.y, p.x, p.y) && area(p.prev, p, p.next) >= 0) return false;\n    p = p.prevZ;\n  }\n\n  while (n && n.z <= maxZ) {\n    if (n !== ear.prev && n !== ear.next && pointInTriangle(a.x, a.y, b.x, b.y, c.x, c.y, n.x, n.y) && area(n.prev, n, n.next) >= 0) return false;\n    n = n.nextZ;\n  }\n\n  return true;\n}\n\nfunction cureLocalIntersections(start, triangles, dim) {\n  let p = start;\n\n  do {\n    const a = p.prev;\n    const b = p.next.next;\n\n    if (!equals(a, b) && intersects(a, p, p.next, b) && locallyInside(a, b) && locallyInside(b, a)) {\n      triangles.push(a.i / dim);\n      triangles.push(p.i / dim);\n      triangles.push(b.i / dim);\n      removeNode(p);\n      removeNode(p.next);\n      p = start = b;\n    }\n\n    p = p.next;\n  } while (p !== start);\n\n  return filterPoints(p);\n}\n\nfunction splitEarcut(start, triangles, dim, minX, minY, invSize) {\n  let a = start;\n\n  do {\n    let b = a.next.next;\n\n    while (b !== a.prev) {\n      if (a.i !== b.i && isValidDiagonal(a, b)) {\n        let c = splitPolygon(a, b);\n        a = filterPoints(a, a.next);\n        c = filterPoints(c, c.next);\n        earcutLinked(a, triangles, dim, minX, minY, invSize);\n        earcutLinked(c, triangles, dim, minX, minY, invSize);\n        return;\n      }\n\n      b = b.next;\n    }\n\n    a = a.next;\n  } while (a !== start);\n}\n\nfunction eliminateHoles(data, holeIndices, outerNode, dim, areas) {\n  const queue = [];\n  let i;\n  let len;\n  let start;\n  let end;\n  let list;\n\n  for (i = 0, len = holeIndices.length; i < len; i++) {\n    start = holeIndices[i] * dim;\n    end = i < len - 1 ? holeIndices[i + 1] * dim : data.length;\n    list = linkedList(data, start, end, dim, false, areas && areas[i + 1]);\n    if (list === list.next) list.steiner = true;\n    queue.push(getLeftmost(list));\n  }\n\n  queue.sort(compareX);\n\n  for (i = 0; i < queue.length; i++) {\n    eliminateHole(queue[i], outerNode);\n    outerNode = filterPoints(outerNode, outerNode.next);\n  }\n\n  return outerNode;\n}\n\nfunction compareX(a, b) {\n  return a.x - b.x;\n}\n\nfunction eliminateHole(hole, outerNode) {\n  outerNode = findHoleBridge(hole, outerNode);\n\n  if (outerNode) {\n    const b = splitPolygon(outerNode, hole);\n    filterPoints(outerNode, outerNode.next);\n    filterPoints(b, b.next);\n  }\n}\n\nfunction findHoleBridge(hole, outerNode) {\n  let p = outerNode;\n  const hx = hole.x;\n  const hy = hole.y;\n  let qx = -Infinity;\n  let m;\n\n  do {\n    if (hy <= p.y && hy >= p.next.y && p.next.y !== p.y) {\n      const x = p.x + (hy - p.y) * (p.next.x - p.x) / (p.next.y - p.y);\n\n      if (x <= hx && x > qx) {\n        qx = x;\n\n        if (x === hx) {\n          if (hy === p.y) return p;\n          if (hy === p.next.y) return p.next;\n        }\n\n        m = p.x < p.next.x ? p : p.next;\n      }\n    }\n\n    p = p.next;\n  } while (p !== outerNode);\n\n  if (!m) return null;\n  if (hx === qx) return m;\n  const stop = m;\n  const mx = m.x;\n  const my = m.y;\n  let tanMin = Infinity;\n  let tan;\n  p = m;\n\n  do {\n    if (hx >= p.x && p.x >= mx && hx !== p.x && pointInTriangle(hy < my ? hx : qx, hy, mx, my, hy < my ? qx : hx, hy, p.x, p.y)) {\n      tan = Math.abs(hy - p.y) / (hx - p.x);\n\n      if (locallyInside(p, hole) && (tan < tanMin || tan === tanMin && (p.x > m.x || p.x === m.x && sectorContainsSector(m, p)))) {\n        m = p;\n        tanMin = tan;\n      }\n    }\n\n    p = p.next;\n  } while (p !== stop);\n\n  return m;\n}\n\nfunction sectorContainsSector(m, p) {\n  return area(m.prev, m, p.prev) < 0 && area(p.next, m, m.next) < 0;\n}\n\nfunction indexCurve(start, minX, minY, invSize) {\n  let p = start;\n\n  do {\n    if (p.z === null) p.z = zOrder(p.x, p.y, minX, minY, invSize);\n    p.prevZ = p.prev;\n    p.nextZ = p.next;\n    p = p.next;\n  } while (p !== start);\n\n  p.prevZ.nextZ = null;\n  p.prevZ = null;\n  sortLinked(p);\n}\n\nfunction sortLinked(list) {\n  let e;\n  let i;\n  let inSize = 1;\n  let numMerges;\n  let p;\n  let pSize;\n  let q;\n  let qSize;\n  let tail;\n\n  do {\n    p = list;\n    list = null;\n    tail = null;\n    numMerges = 0;\n\n    while (p) {\n      numMerges++;\n      q = p;\n      pSize = 0;\n\n      for (i = 0; i < inSize; i++) {\n        pSize++;\n        q = q.nextZ;\n        if (!q) break;\n      }\n\n      qSize = inSize;\n\n      while (pSize > 0 || qSize > 0 && q) {\n        if (pSize !== 0 && (qSize === 0 || !q || p.z <= q.z)) {\n          e = p;\n          p = p.nextZ;\n          pSize--;\n        } else {\n          e = q;\n          q = q.nextZ;\n          qSize--;\n        }\n\n        if (tail) tail.nextZ = e;else list = e;\n        e.prevZ = tail;\n        tail = e;\n      }\n\n      p = q;\n    }\n\n    tail.nextZ = null;\n    inSize *= 2;\n  } while (numMerges > 1);\n\n  return list;\n}\n\nfunction zOrder(x, y, minX, minY, invSize) {\n  x = 32767 * (x - minX) * invSize;\n  y = 32767 * (y - minY) * invSize;\n  x = (x | x << 8) & 0x00ff00ff;\n  x = (x | x << 4) & 0x0f0f0f0f;\n  x = (x | x << 2) & 0x33333333;\n  x = (x | x << 1) & 0x55555555;\n  y = (y | y << 8) & 0x00ff00ff;\n  y = (y | y << 4) & 0x0f0f0f0f;\n  y = (y | y << 2) & 0x33333333;\n  y = (y | y << 1) & 0x55555555;\n  return x | y << 1;\n}\n\nfunction getLeftmost(start) {\n  let p = start;\n  let leftmost = start;\n\n  do {\n    if (p.x < leftmost.x || p.x === leftmost.x && p.y < leftmost.y) leftmost = p;\n    p = p.next;\n  } while (p !== start);\n\n  return leftmost;\n}\n\nfunction pointInTriangle(ax, ay, bx, by, cx, cy, px, py) {\n  return (cx - px) * (ay - py) - (ax - px) * (cy - py) >= 0 && (ax - px) * (by - py) - (bx - px) * (ay - py) >= 0 && (bx - px) * (cy - py) - (cx - px) * (by - py) >= 0;\n}\n\nfunction isValidDiagonal(a, b) {\n  return a.next.i !== b.i && a.prev.i !== b.i && !intersectsPolygon(a, b) && (locallyInside(a, b) && locallyInside(b, a) && middleInside(a, b) && (area(a.prev, a, b.prev) || area(a, b.prev, b)) || equals(a, b) && area(a.prev, a, a.next) > 0 && area(b.prev, b, b.next) > 0);\n}\n\nfunction area(p, q, r) {\n  return (q.y - p.y) * (r.x - q.x) - (q.x - p.x) * (r.y - q.y);\n}\n\nfunction equals(p1, p2) {\n  return p1.x === p2.x && p1.y === p2.y;\n}\n\nfunction intersects(p1, q1, p2, q2) {\n  const o1 = sign(area(p1, q1, p2));\n  const o2 = sign(area(p1, q1, q2));\n  const o3 = sign(area(p2, q2, p1));\n  const o4 = sign(area(p2, q2, q1));\n  if (o1 !== o2 && o3 !== o4) return true;\n  if (o1 === 0 && onSegment(p1, p2, q1)) return true;\n  if (o2 === 0 && onSegment(p1, q2, q1)) return true;\n  if (o3 === 0 && onSegment(p2, p1, q2)) return true;\n  if (o4 === 0 && onSegment(p2, q1, q2)) return true;\n  return false;\n}\n\nfunction onSegment(p, q, r) {\n  return q.x <= Math.max(p.x, r.x) && q.x >= Math.min(p.x, r.x) && q.y <= Math.max(p.y, r.y) && q.y >= Math.min(p.y, r.y);\n}\n\nfunction sign(num) {\n  return num > 0 ? 1 : num < 0 ? -1 : 0;\n}\n\nfunction intersectsPolygon(a, b) {\n  let p = a;\n\n  do {\n    if (p.i !== a.i && p.next.i !== a.i && p.i !== b.i && p.next.i !== b.i && intersects(p, p.next, a, b)) return true;\n    p = p.next;\n  } while (p !== a);\n\n  return false;\n}\n\nfunction locallyInside(a, b) {\n  return area(a.prev, a, a.next) < 0 ? area(a, b, a.next) >= 0 && area(a, a.prev, b) >= 0 : area(a, b, a.prev) < 0 || area(a, a.next, b) < 0;\n}\n\nfunction middleInside(a, b) {\n  let p = a;\n  let inside = false;\n  const px = (a.x + b.x) / 2;\n  const py = (a.y + b.y) / 2;\n\n  do {\n    if (p.y > py !== p.next.y > py && p.next.y !== p.y && px < (p.next.x - p.x) * (py - p.y) / (p.next.y - p.y) + p.x) inside = !inside;\n    p = p.next;\n  } while (p !== a);\n\n  return inside;\n}\n\nfunction splitPolygon(a, b) {\n  const a2 = new Node(a.i, a.x, a.y);\n  const b2 = new Node(b.i, b.x, b.y);\n  const an = a.next;\n  const bp = b.prev;\n  a.next = b;\n  b.prev = a;\n  a2.next = an;\n  an.prev = a2;\n  b2.next = a2;\n  a2.prev = b2;\n  bp.next = b2;\n  b2.prev = bp;\n  return b2;\n}\n\nfunction insertNode(i, x, y, last) {\n  const p = new Node(i, x, y);\n\n  if (!last) {\n    p.prev = p;\n    p.next = p;\n  } else {\n    p.next = last.next;\n    p.prev = last;\n    last.next.prev = p;\n    last.next = p;\n  }\n\n  return p;\n}\n\nfunction removeNode(p) {\n  p.next.prev = p.prev;\n  p.prev.next = p.next;\n  if (p.prevZ) p.prevZ.nextZ = p.nextZ;\n  if (p.nextZ) p.nextZ.prevZ = p.prevZ;\n}\n\nfunction Node(i, x, y) {\n  this.i = i;\n  this.x = x;\n  this.y = y;\n  this.prev = null;\n  this.next = null;\n  this.z = null;\n  this.prevZ = null;\n  this.nextZ = null;\n  this.steiner = false;\n}\n//# sourceMappingURL=earcut.js.map","export function push(target, source) {\n  const size = source.length;\n  const startIndex = target.length;\n\n  if (startIndex > 0) {\n    let isDuplicate = true;\n\n    for (let i = 0; i < size; i++) {\n      if (target[startIndex - size + i] !== source[i]) {\n        isDuplicate = false;\n        break;\n      }\n    }\n\n    if (isDuplicate) {\n      return false;\n    }\n  }\n\n  for (let i = 0; i < size; i++) {\n    target[startIndex + i] = source[i];\n  }\n\n  return true;\n}\nexport function copy(target, source) {\n  const size = source.length;\n\n  for (let i = 0; i < size; i++) {\n    target[i] = source[i];\n  }\n}\nexport function getPointAtIndex(positions, index, size, offset, out = []) {\n  const startI = offset + index * size;\n\n  for (let i = 0; i < size; i++) {\n    out[i] = positions[startI + i];\n  }\n\n  return out;\n}\n//# sourceMappingURL=utils.js.map","import { push, copy, getPointAtIndex } from './utils';\nexport function clipPolyline(positions, bbox, options) {\n  const {\n    size = 2,\n    startIndex = 0,\n    endIndex = positions.length\n  } = options || {};\n  const numPoints = (endIndex - startIndex) / size;\n  const result = [];\n  let part = [];\n  let a;\n  let b;\n  let codeA = -1;\n  let codeB;\n  let lastCode;\n\n  for (let i = 1; i < numPoints; i++) {\n    a = getPointAtIndex(positions, i - 1, size, startIndex, a);\n    b = getPointAtIndex(positions, i, size, startIndex, b);\n\n    if (codeA < 0) {\n      codeA = bitCode(a, bbox);\n    }\n\n    codeB = lastCode = bitCode(b, bbox);\n\n    while (true) {\n      if (!(codeA | codeB)) {\n        push(part, a);\n\n        if (codeB !== lastCode) {\n          push(part, b);\n\n          if (i < numPoints - 1) {\n            result.push(part);\n            part = [];\n          }\n        } else if (i === numPoints - 1) {\n          push(part, b);\n        }\n\n        break;\n      } else if (codeA & codeB) {\n        break;\n      } else if (codeA) {\n        intersect(a, b, codeA, bbox, a);\n        codeA = bitCode(a, bbox);\n      } else {\n        intersect(a, b, codeB, bbox, b);\n        codeB = bitCode(b, bbox);\n      }\n    }\n\n    codeA = lastCode;\n  }\n\n  if (part.length) result.push(part);\n  return result;\n}\nexport function clipPolygon(positions, bbox, options) {\n  const {\n    size = 2,\n    endIndex = positions.length\n  } = options || {};\n  let {\n    startIndex = 0\n  } = options || {};\n  let numPoints = (endIndex - startIndex) / size;\n  let result;\n  let p;\n  let prev;\n  let inside;\n  let prevInside;\n\n  for (let edge = 1; edge <= 8; edge *= 2) {\n    result = [];\n    prev = getPointAtIndex(positions, numPoints - 1, size, startIndex, prev);\n    prevInside = !(bitCode(prev, bbox) & edge);\n\n    for (let i = 0; i < numPoints; i++) {\n      p = getPointAtIndex(positions, i, size, startIndex, p);\n      inside = !(bitCode(p, bbox) & edge);\n      if (inside !== prevInside) push(result, intersect(prev, p, edge, bbox));\n      if (inside) push(result, p);\n      copy(prev, p);\n      prevInside = inside;\n    }\n\n    positions = result;\n    startIndex = 0;\n    numPoints = result.length / size;\n    if (!numPoints) break;\n  }\n\n  return result;\n}\nexport function intersect(a, b, edge, bbox, out = []) {\n  let t;\n  let snap;\n\n  if (edge & 8) {\n    t = (bbox[3] - a[1]) / (b[1] - a[1]);\n    snap = 3;\n  } else if (edge & 4) {\n    t = (bbox[1] - a[1]) / (b[1] - a[1]);\n    snap = 1;\n  } else if (edge & 2) {\n    t = (bbox[2] - a[0]) / (b[0] - a[0]);\n    snap = 2;\n  } else if (edge & 1) {\n    t = (bbox[0] - a[0]) / (b[0] - a[0]);\n    snap = 0;\n  } else {\n    return null;\n  }\n\n  for (let i = 0; i < a.length; i++) {\n    out[i] = (snap & 1) === i ? bbox[snap] : t * (b[i] - a[i]) + a[i];\n  }\n\n  return out;\n}\nexport function bitCode(p, bbox) {\n  let code = 0;\n  if (p[0] < bbox[0]) code |= 1;else if (p[0] > bbox[2]) code |= 2;\n  if (p[1] < bbox[1]) code |= 4;else if (p[1] > bbox[3]) code |= 8;\n  return code;\n}\n//# sourceMappingURL=lineclip.js.map","import { bitCode, intersect } from './lineclip';\nimport { getPointAtIndex, copy, push } from './utils';\nexport function cutPolylineByGrid(positions, options) {\n  const {\n    size = 2,\n    broken = false,\n    gridResolution = 10,\n    gridOffset = [0, 0],\n    startIndex = 0,\n    endIndex = positions.length\n  } = options || {};\n  const numPoints = (endIndex - startIndex) / size;\n  let part = [];\n  const result = [part];\n  const a = getPointAtIndex(positions, 0, size, startIndex);\n  let b;\n  let codeB;\n  const cell = getGridCell(a, gridResolution, gridOffset, []);\n  const scratchPoint = [];\n  push(part, a);\n\n  for (let i = 1; i < numPoints; i++) {\n    b = getPointAtIndex(positions, i, size, startIndex, b);\n    codeB = bitCode(b, cell);\n\n    while (codeB) {\n      intersect(a, b, codeB, cell, scratchPoint);\n      const codeAlt = bitCode(scratchPoint, cell);\n\n      if (codeAlt) {\n        intersect(a, scratchPoint, codeAlt, cell, scratchPoint);\n        codeB = codeAlt;\n      }\n\n      push(part, scratchPoint);\n      copy(a, scratchPoint);\n      moveToNeighborCell(cell, gridResolution, codeB);\n\n      if (broken && part.length > size) {\n        part = [];\n        result.push(part);\n        push(part, a);\n      }\n\n      codeB = bitCode(b, cell);\n    }\n\n    push(part, b);\n    copy(a, b);\n  }\n\n  return broken ? result : result[0];\n}\nconst TYPE_INSIDE = 0;\nconst TYPE_BORDER = 1;\n\nfunction concatInPlace(arr1, arr2) {\n  for (let i = 0; i < arr2.length; i++) {\n    arr1.push(arr2[i]);\n  }\n\n  return arr1;\n}\n\nexport function cutPolygonByGrid(positions, holeIndices = null, options) {\n  if (!positions.length) {\n    return [];\n  }\n\n  const {\n    size = 2,\n    gridResolution = 10,\n    gridOffset = [0, 0],\n    edgeTypes = false\n  } = options || {};\n  const result = [];\n  const queue = [{\n    pos: positions,\n    types: edgeTypes ? new Array(positions.length / size).fill(TYPE_BORDER) : null,\n    holes: holeIndices || []\n  }];\n  const bbox = [[], []];\n  let cell = [];\n\n  while (queue.length) {\n    const {\n      pos,\n      types,\n      holes\n    } = queue.shift();\n    getBoundingBox(pos, size, holes[0] || pos.length, bbox);\n    cell = getGridCell(bbox[0], gridResolution, gridOffset, cell);\n    const code = bitCode(bbox[1], cell);\n\n    if (code) {\n      let parts = bisectPolygon(pos, types, size, 0, holes[0] || pos.length, cell, code);\n      const polygonLow = {\n        pos: parts[0].pos,\n        types: parts[0].types,\n        holes: []\n      };\n      const polygonHigh = {\n        pos: parts[1].pos,\n        types: parts[1].types,\n        holes: []\n      };\n      queue.push(polygonLow, polygonHigh);\n\n      for (let i = 0; i < holes.length; i++) {\n        parts = bisectPolygon(pos, types, size, holes[i], holes[i + 1] || pos.length, cell, code);\n\n        if (parts[0]) {\n          polygonLow.holes.push(polygonLow.pos.length);\n          polygonLow.pos = concatInPlace(polygonLow.pos, parts[0].pos);\n\n          if (edgeTypes) {\n            polygonLow.types = concatInPlace(polygonLow.types, parts[0].types);\n          }\n        }\n\n        if (parts[1]) {\n          polygonHigh.holes.push(polygonHigh.pos.length);\n          polygonHigh.pos = concatInPlace(polygonHigh.pos, parts[1].pos);\n\n          if (edgeTypes) {\n            polygonHigh.types = concatInPlace(polygonHigh.types, parts[1].types);\n          }\n        }\n      }\n    } else {\n      const polygon = {\n        positions: pos\n      };\n\n      if (edgeTypes) {\n        polygon.edgeTypes = types;\n      }\n\n      if (holes.length) {\n        polygon.holeIndices = holes;\n      }\n\n      result.push(polygon);\n    }\n  }\n\n  return result;\n}\n\nfunction bisectPolygon(positions, edgeTypes, size, startIndex, endIndex, bbox, edge) {\n  const numPoints = (endIndex - startIndex) / size;\n  const resultLow = [];\n  const resultHigh = [];\n  const typesLow = [];\n  const typesHigh = [];\n  const scratchPoint = [];\n  let p;\n  let side;\n  let type;\n  const prev = getPointAtIndex(positions, numPoints - 1, size, startIndex);\n  let prevSide = Math.sign(edge & 8 ? prev[1] - bbox[3] : prev[0] - bbox[2]);\n  let prevType = edgeTypes && edgeTypes[numPoints - 1];\n  let lowPointCount = 0;\n  let highPointCount = 0;\n\n  for (let i = 0; i < numPoints; i++) {\n    p = getPointAtIndex(positions, i, size, startIndex, p);\n    side = Math.sign(edge & 8 ? p[1] - bbox[3] : p[0] - bbox[2]);\n    type = edgeTypes && edgeTypes[startIndex / size + i];\n\n    if (side && prevSide && prevSide !== side) {\n      intersect(prev, p, edge, bbox, scratchPoint);\n      push(resultLow, scratchPoint) && typesLow.push(prevType);\n      push(resultHigh, scratchPoint) && typesHigh.push(prevType);\n    }\n\n    if (side <= 0) {\n      push(resultLow, p) && typesLow.push(type);\n      lowPointCount -= side;\n    } else if (typesLow.length) {\n      typesLow[typesLow.length - 1] = TYPE_INSIDE;\n    }\n\n    if (side >= 0) {\n      push(resultHigh, p) && typesHigh.push(type);\n      highPointCount += side;\n    } else if (typesHigh.length) {\n      typesHigh[typesHigh.length - 1] = TYPE_INSIDE;\n    }\n\n    copy(prev, p);\n    prevSide = side;\n    prevType = type;\n  }\n\n  return [lowPointCount ? {\n    pos: resultLow,\n    types: edgeTypes && typesLow\n  } : null, highPointCount ? {\n    pos: resultHigh,\n    types: edgeTypes && typesHigh\n  } : null];\n}\n\nfunction getGridCell(p, gridResolution, gridOffset, out) {\n  const left = Math.floor((p[0] - gridOffset[0]) / gridResolution) * gridResolution + gridOffset[0];\n  const bottom = Math.floor((p[1] - gridOffset[1]) / gridResolution) * gridResolution + gridOffset[1];\n  out[0] = left;\n  out[1] = bottom;\n  out[2] = left + gridResolution;\n  out[3] = bottom + gridResolution;\n  return out;\n}\n\nfunction moveToNeighborCell(cell, gridResolution, edge) {\n  if (edge & 8) {\n    cell[1] += gridResolution;\n    cell[3] += gridResolution;\n  } else if (edge & 4) {\n    cell[1] -= gridResolution;\n    cell[3] -= gridResolution;\n  } else if (edge & 2) {\n    cell[0] += gridResolution;\n    cell[2] += gridResolution;\n  } else if (edge & 1) {\n    cell[0] -= gridResolution;\n    cell[2] -= gridResolution;\n  }\n}\n\nfunction getBoundingBox(positions, size, endIndex, out) {\n  let minX = Infinity;\n  let maxX = -Infinity;\n  let minY = Infinity;\n  let maxY = -Infinity;\n\n  for (let i = 0; i < endIndex; i += size) {\n    const x = positions[i];\n    const y = positions[i + 1];\n    minX = x < minX ? x : minX;\n    maxX = x > maxX ? x : maxX;\n    minY = y < minY ? y : minY;\n    maxY = y > maxY ? y : maxY;\n  }\n\n  out[0][0] = minX;\n  out[0][1] = minY;\n  out[1][0] = maxX;\n  out[1][1] = maxY;\n  return out;\n}\n//# sourceMappingURL=cut-by-grid.js.map","import { cutPolylineByGrid, cutPolygonByGrid } from './cut-by-grid';\nimport { getPointAtIndex, push } from './utils';\nconst DEFAULT_MAX_LATITUDE = 85.051129;\nexport function cutPolylineByMercatorBounds(positions, options) {\n  const {\n    size = 2,\n    startIndex = 0,\n    endIndex = positions.length,\n    normalize = true\n  } = options || {};\n  const newPositions = positions.slice(startIndex, endIndex);\n  wrapLongitudesForShortestPath(newPositions, size, 0, endIndex - startIndex);\n  const parts = cutPolylineByGrid(newPositions, {\n    size,\n    broken: true,\n    gridResolution: 360,\n    gridOffset: [-180, -180]\n  });\n\n  if (normalize) {\n    for (const part of parts) {\n      shiftLongitudesIntoRange(part, size);\n    }\n  }\n\n  return parts;\n}\nexport function cutPolygonByMercatorBounds(positions, holeIndices = null, options) {\n  const {\n    size = 2,\n    normalize = true,\n    edgeTypes = false\n  } = options || {};\n  holeIndices = holeIndices || [];\n  const newPositions = [];\n  const newHoleIndices = [];\n  let srcStartIndex = 0;\n  let targetIndex = 0;\n\n  for (let ringIndex = 0; ringIndex <= holeIndices.length; ringIndex++) {\n    const srcEndIndex = holeIndices[ringIndex] || positions.length;\n    const targetStartIndex = targetIndex;\n    const splitIndex = findSplitIndex(positions, size, srcStartIndex, srcEndIndex);\n\n    for (let i = splitIndex; i < srcEndIndex; i++) {\n      newPositions[targetIndex++] = positions[i];\n    }\n\n    for (let i = srcStartIndex; i < splitIndex; i++) {\n      newPositions[targetIndex++] = positions[i];\n    }\n\n    wrapLongitudesForShortestPath(newPositions, size, targetStartIndex, targetIndex);\n    insertPoleVertices(newPositions, size, targetStartIndex, targetIndex, options === null || options === void 0 ? void 0 : options.maxLatitude);\n    srcStartIndex = srcEndIndex;\n    newHoleIndices[ringIndex] = targetIndex;\n  }\n\n  newHoleIndices.pop();\n  const parts = cutPolygonByGrid(newPositions, newHoleIndices, {\n    size,\n    gridResolution: 360,\n    gridOffset: [-180, -180],\n    edgeTypes\n  });\n\n  if (normalize) {\n    for (const part of parts) {\n      shiftLongitudesIntoRange(part.positions, size);\n    }\n  }\n\n  return parts;\n}\n\nfunction findSplitIndex(positions, size, startIndex, endIndex) {\n  let maxLat = -1;\n  let pointIndex = -1;\n\n  for (let i = startIndex + 1; i < endIndex; i += size) {\n    const lat = Math.abs(positions[i]);\n\n    if (lat > maxLat) {\n      maxLat = lat;\n      pointIndex = i - 1;\n    }\n  }\n\n  return pointIndex;\n}\n\nfunction insertPoleVertices(positions, size, startIndex, endIndex, maxLatitude = DEFAULT_MAX_LATITUDE) {\n  const firstLng = positions[startIndex];\n  const lastLng = positions[endIndex - size];\n\n  if (Math.abs(firstLng - lastLng) > 180) {\n    const p = getPointAtIndex(positions, 0, size, startIndex);\n    p[0] += Math.round((lastLng - firstLng) / 360) * 360;\n    push(positions, p);\n    p[1] = Math.sign(p[1]) * maxLatitude;\n    push(positions, p);\n    p[0] = firstLng;\n    push(positions, p);\n  }\n}\n\nfunction wrapLongitudesForShortestPath(positions, size, startIndex, endIndex) {\n  let prevLng = positions[0];\n  let lng;\n\n  for (let i = startIndex; i < endIndex; i += size) {\n    lng = positions[i];\n    const delta = lng - prevLng;\n\n    if (delta > 180 || delta < -180) {\n      lng -= Math.round(delta / 360) * 360;\n    }\n\n    positions[i] = prevLng = lng;\n  }\n}\n\nfunction shiftLongitudesIntoRange(positions, size) {\n  let refLng;\n  const pointCount = positions.length / size;\n\n  for (let i = 0; i < pointCount; i++) {\n    refLng = positions[i * size];\n\n    if ((refLng + 180) % 360 !== 0) {\n      break;\n    }\n  }\n\n  const delta = -Math.round(refLng / 360) * 360;\n\n  if (delta === 0) {\n    return;\n  }\n\n  for (let i = 0; i < pointCount; i++) {\n    positions[i * size] += delta;\n  }\n}\n//# sourceMappingURL=cut-by-mercator-bounds.js.map","export { default as Polygon } from './polygon';\nexport { getPolygonSignedArea, getPolygonWindingDirection, forEachSegmentInPolygon, modifyPolygonWindingDirection, WINDING } from './polygon-utils';\nexport { earcut } from './earcut';\nexport { clipPolygon, clipPolyline } from './lineclip';\nexport { cutPolygonByGrid, cutPolylineByGrid } from './cut-by-grid';\nexport { cutPolylineByMercatorBounds, cutPolygonByMercatorBounds } from './cut-by-mercator-bounds';\nexport { default as _Polygon } from './polygon';\n//# sourceMappingURL=index.js.map","import { isWebGL2, assertWebGLContext } from '@luma.gl/gltools';\nimport { lumaStats, StatsManager } from '../init';\nimport { getKey, getKeyValue } from '../webgl-utils/constants-to-keys';\nimport { assert } from '../utils/assert';\nimport { uid } from '../utils/utils';\nimport { stubRemovedMethods } from '../utils/stub-methods';\nconst ERR_RESOURCE_METHOD_UNDEFINED = 'Resource subclass must define virtual methods';\nexport default class Resource {\n  get [Symbol.toStringTag]() {\n    return 'Resource';\n  }\n\n  constructor(gl) {\n    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    assertWebGLContext(gl);\n    const {\n      id,\n      userData = {}\n    } = opts;\n    this.gl = gl;\n    this.gl2 = gl;\n    this.id = id || uid(this[Symbol.toStringTag]);\n    this.userData = userData;\n    this._bound = false;\n    this._handle = opts.handle;\n\n    if (this._handle === undefined) {\n      this._handle = this._createHandle();\n    }\n\n    this.byteLength = 0;\n\n    this._initStats();\n\n    this._addStats();\n  }\n\n  toString() {\n    return \"\".concat(this[Symbol.toStringTag] || this.constructor.name, \"(\").concat(this.id, \")\");\n  }\n\n  get handle() {\n    return this._handle;\n  }\n\n  delete() {\n    let {\n      deleteChildren = false\n    } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    const children = this._handle && this._deleteHandle(this._handle);\n\n    if (this._handle) {\n      this._removeStats();\n    }\n\n    this._handle = null;\n\n    if (children && deleteChildren) {\n      children.filter(Boolean).forEach(child => child.delete());\n    }\n\n    return this;\n  }\n\n  bind() {\n    let funcOrHandle = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.handle;\n\n    if (typeof funcOrHandle !== 'function') {\n      this._bindHandle(funcOrHandle);\n\n      return this;\n    }\n\n    let value;\n\n    if (!this._bound) {\n      this._bindHandle(this.handle);\n\n      this._bound = true;\n      value = funcOrHandle();\n      this._bound = false;\n\n      this._bindHandle(null);\n    } else {\n      value = funcOrHandle();\n    }\n\n    return value;\n  }\n\n  unbind() {\n    this.bind(null);\n  }\n\n  getParameter(pname) {\n    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    pname = getKeyValue(this.gl, pname);\n    assert(pname);\n    const parameters = this.constructor.PARAMETERS || {};\n    const parameter = parameters[pname];\n\n    if (parameter) {\n      const isWebgl2 = isWebGL2(this.gl);\n      const parameterAvailable = (!('webgl2' in parameter) || isWebgl2) && (!('extension' in parameter) || this.gl.getExtension(parameter.extension));\n\n      if (!parameterAvailable) {\n        const webgl1Default = parameter.webgl1;\n        const webgl2Default = 'webgl2' in parameter ? parameter.webgl2 : parameter.webgl1;\n        const defaultValue = isWebgl2 ? webgl2Default : webgl1Default;\n        return defaultValue;\n      }\n    }\n\n    return this._getParameter(pname, opts);\n  }\n\n  getParameters() {\n    let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      parameters,\n      keys\n    } = options;\n    const PARAMETERS = this.constructor.PARAMETERS || {};\n    const isWebgl2 = isWebGL2(this.gl);\n    const values = {};\n    const parameterKeys = parameters || Object.keys(PARAMETERS);\n\n    for (const pname of parameterKeys) {\n      const parameter = PARAMETERS[pname];\n      const parameterAvailable = parameter && (!('webgl2' in parameter) || isWebgl2) && (!('extension' in parameter) || this.gl.getExtension(parameter.extension));\n\n      if (parameterAvailable) {\n        const key = keys ? getKey(this.gl, pname) : pname;\n        values[key] = this.getParameter(pname, options);\n\n        if (keys && parameter.type === 'GLenum') {\n          values[key] = getKey(this.gl, values[key]);\n        }\n      }\n    }\n\n    return values;\n  }\n\n  setParameter(pname, value) {\n    pname = getKeyValue(this.gl, pname);\n    assert(pname);\n    const parameters = this.constructor.PARAMETERS || {};\n    const parameter = parameters[pname];\n\n    if (parameter) {\n      const isWebgl2 = isWebGL2(this.gl);\n      const parameterAvailable = (!('webgl2' in parameter) || isWebgl2) && (!('extension' in parameter) || this.gl.getExtension(parameter.extension));\n\n      if (!parameterAvailable) {\n        throw new Error('Parameter not available on this platform');\n      }\n\n      if (parameter.type === 'GLenum') {\n        value = getKeyValue(value);\n      }\n    }\n\n    this._setParameter(pname, value);\n\n    return this;\n  }\n\n  setParameters(parameters) {\n    for (const pname in parameters) {\n      this.setParameter(pname, parameters[pname]);\n    }\n\n    return this;\n  }\n\n  stubRemovedMethods(className, version, methodNames) {\n    return stubRemovedMethods(this, className, version, methodNames);\n  }\n\n  initialize(opts) {}\n\n  _createHandle() {\n    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);\n  }\n\n  _deleteHandle() {\n    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);\n  }\n\n  _bindHandle(handle) {\n    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);\n  }\n\n  _getOptsFromHandle() {\n    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);\n  }\n\n  _getParameter(pname, opts) {\n    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);\n  }\n\n  _setParameter(pname, value) {\n    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);\n  }\n\n  _context() {\n    this.gl.luma = this.gl.luma || {};\n    return this.gl.luma;\n  }\n\n  _initStats() {\n    this.gl.stats = this.gl.stats || new StatsManager();\n  }\n\n  _addStats() {\n    const name = this[Symbol.toStringTag];\n    const stats = lumaStats.get('Resource Counts');\n    stats.get('Resources Created').incrementCount();\n    stats.get(\"\".concat(name, \"s Created\")).incrementCount();\n    stats.get(\"\".concat(name, \"s Active\")).incrementCount();\n  }\n\n  _removeStats() {\n    const name = this[Symbol.toStringTag];\n    const stats = lumaStats.get('Resource Counts');\n    stats.get(\"\".concat(name, \"s Active\")).decrementCount();\n  }\n\n  _trackAllocatedMemory(bytes) {\n    let name = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this[Symbol.toStringTag];\n\n    this._doTrackAllocatedMemory(bytes, name);\n\n    this._doTrackAllocatedMemory(bytes, name, this.gl.stats.get(\"Memory Usage\"));\n  }\n\n  _doTrackAllocatedMemory(bytes) {\n    let name = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this[Symbol.toStringTag];\n    let stats = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : lumaStats.get(\"Memory Usage\");\n    stats.get('GPU Memory').addCount(bytes);\n    stats.get(\"\".concat(name, \" Memory\")).addCount(bytes);\n    this.byteLength = bytes;\n  }\n\n  _trackDeallocatedMemory() {\n    let name = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this[Symbol.toStringTag];\n\n    this._doTrackDeallocatedMemory(name);\n\n    this._doTrackDeallocatedMemory(name, this.gl.stats.get(\"Memory Usage\"));\n  }\n\n  _doTrackDeallocatedMemory() {\n    let name = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this[Symbol.toStringTag];\n    let stats = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : lumaStats.get(\"Memory Usage\");\n    stats.get('GPU Memory').subtractCount(this.byteLength);\n    stats.get(\"\".concat(name, \" Memory\")).subtractCount(this.byteLength);\n    this.byteLength = 0;\n  }\n\n}\n//# sourceMappingURL=resource.js.map","module.exports = require(\"regenerator-runtime\");\n","var arrayWithoutHoles = require(\"./arrayWithoutHoles\");\n\nvar iterableToArray = require(\"./iterableToArray\");\n\nvar nonIterableSpread = require(\"./nonIterableSpread\");\n\nfunction _toConsumableArray(arr) {\n  return arrayWithoutHoles(arr) || iterableToArray(arr) || nonIterableSpread();\n}\n\nmodule.exports = _toConsumableArray;","/**\n * Pulls together all deck.gl dependencies used\n * in @deck.gl/jupyter-widget\n */\nconst deck = require('../../core/bundle');\n\nObject.assign(\n  deck,\n  require('@deck.gl/layers'),\n  require('@deck.gl/aggregation-layers'),\n  require('@deck.gl/geo-layers'),\n  require('@deck.gl/mesh-layers'),\n  require('@deck.gl/google-maps'),\n  require('@deck.gl/json')\n);\n\nmodule.exports = deck;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport log from '../utils/log';\nimport {createMat4, getCameraPosition, getFrustumPlanes, FrustumPlane} from '../utils/math-utils';\n\nimport {Matrix4, Vector3, equals, clamp} from '@math.gl/core';\nimport * as mat4 from 'gl-matrix/mat4';\n\nimport {\n  getDistanceScales,\n  getMeterZoom,\n  lngLatToWorld,\n  worldToLngLat,\n  worldToPixels,\n  pixelsToWorld\n} from '@math.gl/web-mercator';\n\nimport {PROJECTION_MODE} from '../lib/constants';\n\nexport type DistanceScales = {\n  unitsPerMeter: number[];\n  metersPerUnit: number[];\n};\n\nexport type Padding = {\n  left?: number;\n  right?: number;\n  top?: number;\n  bottom?: number;\n};\n\nexport type ViewportOptions = {\n  /** Name of the viewport */\n  id?: string;\n  /** Left offset from the canvas edge, in pixels */\n  x?: number;\n  /** Top offset from the canvas edge, in pixels */\n  y?: number;\n  /** Viewport width in pixels */\n  width?: number;\n  /** Viewport height in pixels */\n  height?: number;\n  /** Longitude in degrees (geospatial only) */\n  longitude?: number;\n  /** Latitude in degrees (geospatial only) */\n  latitude?: number;\n  /** Viewport center in world space. If geospatial, refers to meter offsets from lng, lat */\n  position?: number[];\n  /** Zoom level */\n  zoom?: number;\n  /** Padding around the viewport, in pixels. */\n  padding?: Padding | null;\n  distanceScales?: DistanceScales;\n  /** Model matrix of viewport center */\n  modelMatrix?: number[] | null;\n  /** Custom view matrix */\n  viewMatrix?: number[];\n  /** Custom projection matrix */\n  projectionMatrix?: number[];\n  /** Modifier of viewport scale. Corresponds to the number of pixels per common unit at zoom 0. */\n  focalDistance?: number;\n  /** Use orthographic projection */\n  orthographic?: boolean;\n  /** fovy in radians. If supplied, overrides fovy */\n  fovyRadians?: number;\n  /** fovy in degrees. */\n  fovy?: number;\n  /** Near plane of the projection matrix */\n  near?: number;\n  /** Far plane of the projection matrix */\n  far?: number;\n};\n\nconst DEGREES_TO_RADIANS = Math.PI / 180;\n\nconst IDENTITY = createMat4();\n\nconst ZERO_VECTOR = [0, 0, 0];\n\nconst DEFAULT_DISTANCE_SCALES: DistanceScales = {\n  unitsPerMeter: [1, 1, 1],\n  metersPerUnit: [1, 1, 1]\n};\n\n// / Helpers\nfunction createProjectionMatrix({\n  width,\n  height,\n  orthographic,\n  fovyRadians,\n  focalDistance,\n  padding,\n  near,\n  far\n}: {\n  width: number;\n  height: number;\n  orthographic: boolean;\n  fovyRadians: number;\n  focalDistance: number;\n  padding: Padding | null;\n  near: number;\n  far: number;\n}) {\n  const aspect = width / height;\n  const matrix = orthographic\n    ? new Matrix4().orthographic({fovy: fovyRadians, aspect, focalDistance, near, far})\n    : new Matrix4().perspective({fovy: fovyRadians, aspect, near, far});\n  if (padding) {\n    const {left = 0, right = 0, top = 0, bottom = 0} = padding;\n    const offsetX = clamp((left + width - right) / 2, 0, width) - width / 2;\n    const offsetY = clamp((top + height - bottom) / 2, 0, height) - height / 2;\n    // pixels to clip space\n    matrix[8] -= (offsetX * 2) / width;\n    matrix[9] += (offsetY * 2) / height;\n  }\n  return matrix;\n}\n\n/**\n * Manages coordinate system transformations.\n *\n * Note: The Viewport is immutable in the sense that it only has accessors.\n * A new viewport instance should be created if any parameters have changed.\n */\nexport default class Viewport {\n  static displayName = 'Viewport';\n\n  /** Init parameters */\n\n  id: string;\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n  padding?: Padding | null;\n  isGeospatial: boolean;\n  zoom: number;\n  focalDistance: number;\n  position: number[];\n  modelMatrix: number[] | null;\n\n  /** Derived parameters */\n\n  // `!` post-fix expression operator asserts that its operand is non-null and non-undefined in contexts\n  // where the type checker is unable to conclude that fact.\n\n  distanceScales: DistanceScales; /** scale factors between world space and common space */\n  scale!: number; /** scale factor, equals 2^zoom */\n  center!: number[]; /** viewport center in common space */\n  cameraPosition!: number[]; /** Camera position in common space */\n  projectionMatrix!: number[];\n  viewMatrix!: number[];\n  viewMatrixUncentered!: number[];\n  viewMatrixInverse!: number[];\n  viewProjectionMatrix!: number[];\n  pixelProjectionMatrix!: number[];\n  pixelUnprojectionMatrix!: number[];\n  resolution?: number;\n\n  private _frustumPlanes: {[name: string]: FrustumPlane} = {};\n\n  constructor(opts: ViewportOptions = {}) {\n    // @ts-ignore\n    this.id = opts.id || this.constructor.displayName || 'viewport';\n\n    this.x = opts.x || 0;\n    this.y = opts.y || 0;\n    // Silently allow apps to send in w,h = 0,0\n    this.width = opts.width || 1;\n    this.height = opts.height || 1;\n    this.zoom = opts.zoom || 0;\n    this.padding = opts.padding;\n    this.distanceScales = opts.distanceScales || DEFAULT_DISTANCE_SCALES;\n    this.focalDistance = opts.focalDistance || 1;\n    this.position = opts.position || ZERO_VECTOR;\n    this.modelMatrix = opts.modelMatrix || null;\n\n    const {longitude, latitude} = opts;\n    this.isGeospatial = Number.isFinite(latitude) && Number.isFinite(longitude);\n\n    this._initProps(opts);\n    this._initMatrices(opts);\n\n    // Bind methods for easy access\n    this.equals = this.equals.bind(this);\n    this.project = this.project.bind(this);\n    this.unproject = this.unproject.bind(this);\n    this.projectPosition = this.projectPosition.bind(this);\n    this.unprojectPosition = this.unprojectPosition.bind(this);\n    this.projectFlat = this.projectFlat.bind(this);\n    this.unprojectFlat = this.unprojectFlat.bind(this);\n  }\n\n  get metersPerPixel(): number {\n    return this.distanceScales.metersPerUnit[2] / this.scale;\n  }\n\n  get projectionMode(): number {\n    if (this.isGeospatial) {\n      return this.zoom < 12\n        ? PROJECTION_MODE.WEB_MERCATOR\n        : PROJECTION_MODE.WEB_MERCATOR_AUTO_OFFSET;\n    }\n    return PROJECTION_MODE.IDENTITY;\n  }\n\n  // Two viewports are equal if width and height are identical, and if\n  // their view and projection matrices are (approximately) equal.\n  equals(viewport: Viewport): boolean {\n    if (!(viewport instanceof Viewport)) {\n      return false;\n    }\n    if (this === viewport) {\n      return true;\n    }\n\n    return (\n      viewport.width === this.width &&\n      viewport.height === this.height &&\n      viewport.scale === this.scale &&\n      equals(viewport.projectionMatrix, this.projectionMatrix) &&\n      equals(viewport.viewMatrix, this.viewMatrix)\n    );\n    // TODO - check distance scales?\n  }\n\n  /**\n   * Projects xyz (possibly latitude and longitude) to pixel coordinates in window\n   * using viewport projection parameters\n   * - [longitude, latitude] to [x, y]\n   * - [longitude, latitude, Z] => [x, y, z]\n   * Note: By default, returns top-left coordinates for canvas/SVG type render\n   *\n   * @param {Array} lngLatZ - [lng, lat] or [lng, lat, Z]\n   * @param {Object} opts - options\n   * @param {Object} opts.topLeft=true - Whether projected coords are top left\n   * @return {Array} - [x, y] or [x, y, z] in top left coords\n   */\n  project(xyz: number[], {topLeft = true}: {topLeft?: boolean} = {}): number[] {\n    const worldPosition = this.projectPosition(xyz);\n    const coord = worldToPixels(worldPosition, this.pixelProjectionMatrix);\n\n    const [x, y] = coord;\n    const y2 = topLeft ? y : this.height - y;\n    return xyz.length === 2 ? [x, y2] : [x, y2, coord[2]];\n  }\n\n  /**\n   * Unproject pixel coordinates on screen onto world coordinates,\n   * (possibly [lon, lat]) on map.\n   * - [x, y] => [lng, lat]\n   * - [x, y, z] => [lng, lat, Z]\n   * @param {Array} xyz -\n   * @param {Object} opts - options\n   * @param {Object} opts.topLeft=true - Whether origin is top left\n   * @return {Array|null} - [lng, lat, Z] or [X, Y, Z]\n   */\n  unproject(\n    xyz: number[],\n    {topLeft = true, targetZ}: {topLeft?: boolean; targetZ?: number} = {}\n  ): number[] {\n    const [x, y, z] = xyz;\n\n    const y2 = topLeft ? y : this.height - y;\n    const targetZWorld = targetZ && targetZ * this.distanceScales.unitsPerMeter[2];\n    const coord = pixelsToWorld([x, y2, z], this.pixelUnprojectionMatrix, targetZWorld);\n    const [X, Y, Z] = this.unprojectPosition(coord);\n\n    if (Number.isFinite(z)) {\n      return [X, Y, Z];\n    }\n    return Number.isFinite(targetZ) ? [X, Y, targetZ as number] : [X, Y];\n  }\n\n  // NON_LINEAR PROJECTION HOOKS\n  // Used for web meractor projection\n\n  projectPosition(xyz: number[]): [number, number, number] {\n    const [X, Y] = this.projectFlat(xyz);\n    const Z = (xyz[2] || 0) * this.distanceScales.unitsPerMeter[2];\n    return [X, Y, Z];\n  }\n\n  unprojectPosition(xyz: number[]): [number, number, number] {\n    const [X, Y] = this.unprojectFlat(xyz);\n    const Z = (xyz[2] || 0) * this.distanceScales.metersPerUnit[2];\n    return [X, Y, Z];\n  }\n\n  /**\n   * Project [lng,lat] on sphere onto [x,y] on 512*512 Mercator Zoom 0 tile.\n   * Performs the nonlinear part of the web mercator projection.\n   * Remaining projection is done with 4x4 matrices which also handles\n   * perspective.\n   * @param {Array} lngLat - [lng, lat] coordinates\n   *   Specifies a point on the sphere to project onto the map.\n   * @return {Array} [x,y] coordinates.\n   */\n  projectFlat(xyz: number[]): [number, number] {\n    if (this.isGeospatial) {\n      // Shader clamps latitude to +-89.9, see /shaderlib/project/project.glsl.js\n      // lngLatToWorld([0, -89.9])[1] = -317.9934163758329\n      // lngLatToWorld([0, 89.9])[1] = 829.9934163758271\n      const result = lngLatToWorld(xyz);\n      result[1] = clamp(result[1], -318, 830);\n      return result;\n    }\n    return xyz as [number, number];\n  }\n\n  /**\n   * Unproject world point [x,y] on map onto {lat, lon} on sphere\n   * @param {object|Vector} xy - object with {x,y} members\n   *  representing point on projected map plane\n   * @return {GeoCoordinates} - object with {lat,lon} of point on sphere.\n   *   Has toArray method if you need a GeoJSON Array.\n   *   Per cartographic tradition, lat and lon are specified as degrees.\n   */\n  unprojectFlat(xyz: number[]): [number, number] {\n    if (this.isGeospatial) {\n      return worldToLngLat(xyz);\n    }\n    return xyz as [number, number];\n  }\n\n  /**\n   * Get bounds of the current viewport\n   * @return {Array} - [minX, minY, maxX, maxY]\n   */\n  getBounds(options: {z?: number} = {}): [number, number, number, number] {\n    const unprojectOption = {targetZ: options.z || 0};\n\n    const topLeft = this.unproject([0, 0], unprojectOption);\n    const topRight = this.unproject([this.width, 0], unprojectOption);\n    const bottomLeft = this.unproject([0, this.height], unprojectOption);\n    const bottomRight = this.unproject([this.width, this.height], unprojectOption);\n\n    return [\n      Math.min(topLeft[0], topRight[0], bottomLeft[0], bottomRight[0]),\n      Math.min(topLeft[1], topRight[1], bottomLeft[1], bottomRight[1]),\n      Math.max(topLeft[0], topRight[0], bottomLeft[0], bottomRight[0]),\n      Math.max(topLeft[1], topRight[1], bottomLeft[1], bottomRight[1])\n    ];\n  }\n\n  getDistanceScales(coordinateOrigin?: number[]): DistanceScales {\n    if (coordinateOrigin) {\n      return getDistanceScales({\n        longitude: coordinateOrigin[0],\n        latitude: coordinateOrigin[1],\n        highPrecision: true\n      });\n    }\n    return this.distanceScales;\n  }\n\n  containsPixel({\n    x,\n    y,\n    width = 1,\n    height = 1\n  }: {\n    x: number;\n    y: number;\n    width?: number;\n    height?: number;\n  }): boolean {\n    return (\n      x < this.x + this.width &&\n      this.x < x + width &&\n      y < this.y + this.height &&\n      this.y < y + height\n    );\n  }\n\n  // Extract frustum planes in common space\n  getFrustumPlanes(): {\n    left: FrustumPlane;\n    right: FrustumPlane;\n    bottom: FrustumPlane;\n    top: FrustumPlane;\n    near: FrustumPlane;\n    far: FrustumPlane;\n  } {\n    if (this._frustumPlanes.near) {\n      // @ts-ignore\n      return this._frustumPlanes;\n    }\n\n    Object.assign(this._frustumPlanes, getFrustumPlanes(this.viewProjectionMatrix));\n\n    // @ts-ignore\n    return this._frustumPlanes;\n  }\n\n  // EXPERIMENTAL METHODS\n\n  /**\n   * Needed by panning and linear transition\n   * Pan the viewport to place a given world coordinate at screen point [x, y]\n   *\n   * @param {Array} coords - world coordinates\n   * @param {Array} pixel - [x,y] coordinates on screen\n   * @return {Object} props of the new viewport\n   */\n  panByPosition(coords: number[], pixel: number[]): any {\n    return null;\n  }\n\n  // INTERNAL METHODS\n\n  /* eslint-disable complexity, max-statements */\n  private _initProps(opts: ViewportOptions) {\n    const longitude = opts.longitude as number;\n    const latitude = opts.latitude as number;\n\n    if (this.isGeospatial) {\n      if (!Number.isFinite(opts.zoom)) {\n        this.zoom = getMeterZoom({latitude}) + Math.log2(this.focalDistance);\n      }\n      this.distanceScales = opts.distanceScales || getDistanceScales({latitude, longitude});\n    }\n    const scale = Math.pow(2, this.zoom);\n    this.scale = scale;\n\n    const {position, modelMatrix} = opts;\n    let meterOffset: number[] = ZERO_VECTOR;\n    if (position) {\n      meterOffset = modelMatrix\n        ? (new Matrix4(modelMatrix).transformAsVector(position, []) as number[])\n        : position;\n    }\n\n    if (this.isGeospatial) {\n      // Determine camera center in common space\n      const center = this.projectPosition([longitude, latitude, 0]);\n\n      this.center = new Vector3(meterOffset)\n        // Convert to pixels in current zoom\n        .scale(this.distanceScales.unitsPerMeter)\n        .add(center);\n    } else {\n      this.center = this.projectPosition(meterOffset);\n    }\n  }\n  /* eslint-enable complexity, max-statements */\n\n  private _initMatrices(opts: ViewportOptions) {\n    const {\n      // View matrix\n      viewMatrix = IDENTITY,\n      // Projection matrix\n      projectionMatrix = null,\n\n      // Projection matrix parameters, used if projectionMatrix not supplied\n      orthographic = false,\n      fovyRadians,\n      fovy = 75,\n      near = 0.1, // Distance of near clipping plane\n      far = 1000, // Distance of far clipping plane\n      padding = null, // Center offset in pixels\n      focalDistance = 1\n    } = opts;\n\n    this.viewMatrixUncentered = viewMatrix;\n    // Make a centered version of the matrix for projection modes without an offset\n    this.viewMatrix = new Matrix4()\n      // Apply the uncentered view matrix\n      .multiplyRight(viewMatrix)\n      // And center it\n      .translate(new Vector3(this.center).negate());\n\n    this.projectionMatrix =\n      projectionMatrix ||\n      createProjectionMatrix({\n        width: this.width,\n        height: this.height,\n        orthographic,\n        fovyRadians: fovyRadians || fovy * DEGREES_TO_RADIANS,\n        focalDistance,\n        padding,\n        near,\n        far\n      });\n\n    // Note: As usual, matrix operations should be applied in \"reverse\" order\n    // since vectors will be multiplied in from the right during transformation\n    const vpm = createMat4();\n    mat4.multiply(vpm, vpm, this.projectionMatrix);\n    mat4.multiply(vpm, vpm, this.viewMatrix);\n    this.viewProjectionMatrix = vpm;\n\n    // console.log('VPM', this.viewMatrix, this.projectionMatrix, this.viewProjectionMatrix);\n\n    // Calculate inverse view matrix\n    this.viewMatrixInverse = mat4.invert([], this.viewMatrix) || this.viewMatrix;\n\n    // Decompose camera parameters\n    this.cameraPosition = getCameraPosition(this.viewMatrixInverse);\n\n    /*\n     * Builds matrices that converts preprojected lngLats to screen pixels\n     * and vice versa.\n     * Note: Currently returns bottom-left coordinates!\n     * Note: Starts with the GL projection matrix and adds steps to the\n     *       scale and translate that matrix onto the window.\n     * Note: WebGL controls clip space to screen projection with gl.viewport\n     *       and does not need this step.\n     */\n\n    // matrix for conversion from world location to screen (pixel) coordinates\n    const viewportMatrix = createMat4(); // matrix from NDC to viewport.\n    const pixelProjectionMatrix = createMat4(); // matrix from world space to viewport.\n    mat4.scale(viewportMatrix, viewportMatrix, [this.width / 2, -this.height / 2, 1]);\n    mat4.translate(viewportMatrix, viewportMatrix, [1, -1, 0]);\n    mat4.multiply(pixelProjectionMatrix, viewportMatrix, this.viewProjectionMatrix);\n    this.pixelProjectionMatrix = pixelProjectionMatrix;\n\n    this.pixelUnprojectionMatrix = mat4.invert(createMat4(), this.pixelProjectionMatrix);\n    if (!this.pixelUnprojectionMatrix) {\n      log.warn('Pixel project matrix not invertible')();\n      // throw new Error('Pixel project matrix not invertible');\n    }\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n/*\n * Helper function for padArray\n */\nfunction padArrayChunk(options: {\n  source;\n  target;\n  start?: number;\n  end?: number;\n  size: number;\n  getData;\n}): void {\n  const {source, target, start = 0, size, getData} = options;\n  const end = options.end || target.length;\n\n  const sourceLength = source.length;\n  const targetLength = end - start;\n\n  if (sourceLength > targetLength) {\n    target.set(source.subarray(0, targetLength), start);\n    return;\n  }\n\n  target.set(source, start);\n\n  if (!getData) {\n    return;\n  }\n\n  // source is not large enough to fill target space, call `getData` to get filler data\n  let i = sourceLength;\n  while (i < targetLength) {\n    const datum = getData(i, source);\n    for (let j = 0; j < size; j++) {\n      target[start + i] = datum[j] || 0;\n      i++;\n    }\n  }\n}\n\n/*\n * The padArray function stretches a source array to the size of a target array.\n   The arrays can have internal structures (like the attributes of PathLayer and\n   SolidPolygonLayer), defined by the optional sourceStartIndices and targetStartIndices parameters.\n   If the target array is larger, the getData callback is used to fill in the blanks.\n * @params {TypedArray} source - original data\n * @params {TypedArray} target - output data\n * @params {Number} size - length per datum\n * @params {Function} getData - callback to get new data when source is short\n * @params {Array<Number>} [sourceStartIndices] - subdivision of the original data in [object0StartIndex, object1StartIndex, ...]\n * @params {Array<Number>} [targetStartIndices] - subdivision of the output data in [object0StartIndex, object1StartIndex, ...]\n */\nexport function padArray({source, target, size, getData, sourceStartIndices, targetStartIndices}) {\n  if (!Array.isArray(targetStartIndices)) {\n    // Flat arrays\n    padArrayChunk({\n      source,\n      target,\n      size,\n      getData\n    });\n    return target;\n  }\n\n  // Arrays have internal structure\n  let sourceIndex = 0;\n  let targetIndex = 0;\n  const getChunkData = getData && ((i, chunk) => getData(i + targetIndex, chunk));\n\n  const n = Math.min(sourceStartIndices.length, targetStartIndices.length);\n\n  for (let i = 1; i < n; i++) {\n    const nextSourceIndex = sourceStartIndices[i] * size;\n    const nextTargetIndex = targetStartIndices[i] * size;\n\n    padArrayChunk({\n      source: source.subarray(sourceIndex, nextSourceIndex),\n      target,\n      start: targetIndex,\n      end: nextTargetIndex,\n      size,\n      getData: getChunkData\n    });\n\n    sourceIndex = nextSourceIndex;\n    targetIndex = nextTargetIndex;\n  }\n\n  if (targetIndex < target.length) {\n    padArrayChunk({\n      source: [],\n      target,\n      start: targetIndex,\n      size,\n      getData: getChunkData\n    });\n  }\n\n  return target;\n}\n","import {padArray} from '../../utils/array-utils';\nimport {NumericArray} from '../../types/types';\nimport Attribute from './attribute';\nimport type {BufferAccessor} from './data-column';\nimport type {Buffer} from '@luma.gl/webgl';\n\nexport interface TransitionSettings {\n  type: string;\n  /** Callback to get the value that the entering vertices are transitioning from. */\n  enter?: (toValue: NumericArray, chunk?: NumericArray) => NumericArray;\n  /** Callback when the transition is started */\n  onStart?: () => void;\n  /** Callback when the transition is done */\n  onEnd?: () => void;\n  /** Callback when the transition is interrupted */\n  onInterrupt?: () => void;\n}\n\nexport type InterpolationTransitionSettings = TransitionSettings & {\n  type?: 'interpolation';\n  /** Duration of the transition animation, in milliseconds */\n  duration: number;\n  /** Easing function that maps a value from [0, 1] to [0, 1], see [http://easings.net/](http://easings.net/) */\n  easing?: (t: number) => number;\n};\n\nexport type SpringTransitionSettings = TransitionSettings & {\n  type: 'spring';\n  /** \"Tension\" factor for the spring */\n  stiffness: number;\n  /** \"Friction\" factor that counteracts the spring's acceleration */\n  damping: number;\n};\n\nconst DEFAULT_TRANSITION_SETTINGS = {\n  interpolation: {\n    duration: 0,\n    easing: t => t\n  },\n  spring: {\n    stiffness: 0.05,\n    damping: 0.5\n  }\n};\n\nexport function normalizeTransitionSettings(\n  userSettings: number | InterpolationTransitionSettings | SpringTransitionSettings,\n  layerSettings?: boolean | Partial<TransitionSettings>\n): TransitionSettings | null {\n  if (!userSettings) {\n    return null;\n  }\n  if (Number.isFinite(userSettings)) {\n    userSettings = {type: 'interpolation', duration: userSettings as number};\n  }\n  const type = (userSettings as TransitionSettings).type || 'interpolation';\n  return {\n    ...DEFAULT_TRANSITION_SETTINGS[type],\n    ...(layerSettings as TransitionSettings),\n    ...(userSettings as TransitionSettings),\n    type\n  };\n}\n\n// NOTE: NOT COPYING OVER OFFSET OR STRIDE HERE BECAUSE:\n// (1) WE DON'T SUPPORT INTERLEAVED BUFFERS FOR TRANSITIONS\n// (2) BUFFERS WITH OFFSETS ALWAYS CONTAIN VALUES OF THE SAME SIZE\n// (3) THE OPERATIONS IN THE SHADER ARE PER-COMPONENT (addition and scaling)\nexport function getSourceBufferAttribute(\n  gl: WebGLRenderingContext,\n  attribute: Attribute\n): [Buffer, BufferAccessor] | NumericArray {\n  // The Attribute we pass to Transform as a sourceBuffer must have {divisor: 0}\n  // so we create a copy of the attribute (with divisor=0) to use when running\n  // transform feedback\n  const buffer = attribute.getBuffer();\n  if (buffer) {\n    return [\n      buffer,\n      {\n        divisor: 0,\n        size: attribute.size,\n        normalized: attribute.settings.normalized\n      } as BufferAccessor\n    ];\n  }\n  // constant\n  // don't pass normalized here because the `value` from a normalized attribute is\n  // already normalized\n  return attribute.value as NumericArray;\n}\n\nexport function getAttributeTypeFromSize(size: number): string {\n  switch (size) {\n    case 1:\n      return 'float';\n    case 2:\n      return 'vec2';\n    case 3:\n      return 'vec3';\n    case 4:\n      return 'vec4';\n    default:\n      throw new Error(`No defined attribute type for size \"${size}\"`);\n  }\n}\n\nexport function cycleBuffers(buffers: Buffer[]): void {\n  buffers.push(buffers.shift() as Buffer);\n}\n\nexport function getAttributeBufferLength(attribute: Attribute, numInstances: number): number {\n  const {doublePrecision, settings, value, size} = attribute;\n  const multiplier = doublePrecision && value instanceof Float64Array ? 2 : 1;\n  return (settings.noAlloc ? (value as NumericArray).length : numInstances * size) * multiplier;\n}\n\n// This helper is used when transitioning attributes from a set of values in one buffer layout\n// to a set of values in a different buffer layout. (Buffer layouts are used when attribute values\n// within a buffer should be grouped for drawElements, like the Polygon layer.) For example, a\n// buffer layout of [3, 4] might have data [A1, A2, A3, B1, B2, B3, B4]. If it needs to transition\n// to a buffer layout of [4, 2], it should produce a buffer, using the transition setting's `enter`\n// function, that looks like this: [A1, A2, A3, A4 (user `enter` fn), B1, B2, 0]. Note: the final\n// 0 in this buffer is because we never shrink buffers, only grow them, for performance reasons.\nexport function padBuffer({\n  buffer,\n  numInstances,\n  attribute,\n  fromLength,\n  fromStartIndices,\n  getData = x => x\n}: {\n  buffer: Buffer;\n  numInstances: number;\n  attribute: Attribute;\n  fromLength: number;\n  fromStartIndices?: NumericArray | null;\n  getData?: (toValue: NumericArray, chunk?: NumericArray) => NumericArray;\n}): void {\n  // TODO: move the precisionMultiplier logic to the attribute when retrieving\n  // its `size` and `elementOffset`?\n  const precisionMultiplier =\n    attribute.doublePrecision && attribute.value instanceof Float64Array ? 2 : 1;\n  const size = attribute.size * precisionMultiplier;\n  const byteOffset = attribute.byteOffset;\n  const toStartIndices = attribute.startIndices;\n  const hasStartIndices = fromStartIndices && toStartIndices;\n  const toLength = getAttributeBufferLength(attribute, numInstances);\n  const isConstant = attribute.isConstant;\n\n  // check if buffer needs to be padded\n  if (!hasStartIndices && fromLength >= toLength) {\n    return;\n  }\n\n  const toData = isConstant\n    ? attribute.value\n    : (attribute.getBuffer() as Buffer).getData({srcByteOffset: byteOffset});\n  if (attribute.settings.normalized && !isConstant) {\n    const getter = getData;\n    getData = (value, chunk) => attribute.normalizeConstant(getter(value, chunk));\n  }\n\n  const getMissingData = isConstant\n    ? (i, chunk) => getData(toData, chunk)\n    : (i, chunk) => getData(toData.subarray(i, i + size), chunk);\n\n  const source = buffer.getData({length: fromLength});\n  const data = new Float32Array(toLength);\n  padArray({\n    source,\n    target: data,\n    sourceStartIndices: fromStartIndices,\n    targetStartIndices: toStartIndices,\n    size,\n    getData: getMissingData\n  });\n\n  // TODO: support offset in buffer.setData?\n  if (buffer.byteLength < data.byteLength + byteOffset) {\n    buffer.reallocate(data.byteLength + byteOffset);\n  }\n  buffer.subData({data, offset: byteOffset});\n}\n","// shim for using process in browser\nvar process = module.exports = {};\n\n// cached from whatever global is present so that test runners that stub it\n// don't break things.  But we need to wrap it in a try catch in case it is\n// wrapped in strict mode code which doesn't define any globals.  It's inside a\n// function because try/catches deoptimize in certain engines.\n\nvar cachedSetTimeout;\nvar cachedClearTimeout;\n\nfunction defaultSetTimout() {\n    throw new Error('setTimeout has not been defined');\n}\nfunction defaultClearTimeout () {\n    throw new Error('clearTimeout has not been defined');\n}\n(function () {\n    try {\n        if (typeof setTimeout === 'function') {\n            cachedSetTimeout = setTimeout;\n        } else {\n            cachedSetTimeout = defaultSetTimout;\n        }\n    } catch (e) {\n        cachedSetTimeout = defaultSetTimout;\n    }\n    try {\n        if (typeof clearTimeout === 'function') {\n            cachedClearTimeout = clearTimeout;\n        } else {\n            cachedClearTimeout = defaultClearTimeout;\n        }\n    } catch (e) {\n        cachedClearTimeout = defaultClearTimeout;\n    }\n} ())\nfunction runTimeout(fun) {\n    if (cachedSetTimeout === setTimeout) {\n        //normal enviroments in sane situations\n        return setTimeout(fun, 0);\n    }\n    // if setTimeout wasn't available but was latter defined\n    if ((cachedSetTimeout === defaultSetTimout || !cachedSetTimeout) && setTimeout) {\n        cachedSetTimeout = setTimeout;\n        return setTimeout(fun, 0);\n    }\n    try {\n        // when when somebody has screwed with setTimeout but no I.E. maddness\n        return cachedSetTimeout(fun, 0);\n    } catch(e){\n        try {\n            // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally\n            return cachedSetTimeout.call(null, fun, 0);\n        } catch(e){\n            // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error\n            return cachedSetTimeout.call(this, fun, 0);\n        }\n    }\n\n\n}\nfunction runClearTimeout(marker) {\n    if (cachedClearTimeout === clearTimeout) {\n        //normal enviroments in sane situations\n        return clearTimeout(marker);\n    }\n    // if clearTimeout wasn't available but was latter defined\n    if ((cachedClearTimeout === defaultClearTimeout || !cachedClearTimeout) && clearTimeout) {\n        cachedClearTimeout = clearTimeout;\n        return clearTimeout(marker);\n    }\n    try {\n        // when when somebody has screwed with setTimeout but no I.E. maddness\n        return cachedClearTimeout(marker);\n    } catch (e){\n        try {\n            // When we are in I.E. but the script has been evaled so I.E. doesn't  trust the global object when called normally\n            return cachedClearTimeout.call(null, marker);\n        } catch (e){\n            // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error.\n            // Some versions of I.E. have different rules for clearTimeout vs setTimeout\n            return cachedClearTimeout.call(this, marker);\n        }\n    }\n\n\n\n}\nvar queue = [];\nvar draining = false;\nvar currentQueue;\nvar queueIndex = -1;\n\nfunction cleanUpNextTick() {\n    if (!draining || !currentQueue) {\n        return;\n    }\n    draining = false;\n    if (currentQueue.length) {\n        queue = currentQueue.concat(queue);\n    } else {\n        queueIndex = -1;\n    }\n    if (queue.length) {\n        drainQueue();\n    }\n}\n\nfunction drainQueue() {\n    if (draining) {\n        return;\n    }\n    var timeout = runTimeout(cleanUpNextTick);\n    draining = true;\n\n    var len = queue.length;\n    while(len) {\n        currentQueue = queue;\n        queue = [];\n        while (++queueIndex < len) {\n            if (currentQueue) {\n                currentQueue[queueIndex].run();\n            }\n        }\n        queueIndex = -1;\n        len = queue.length;\n    }\n    currentQueue = null;\n    draining = false;\n    runClearTimeout(timeout);\n}\n\nprocess.nextTick = function (fun) {\n    var args = new Array(arguments.length - 1);\n    if (arguments.length > 1) {\n        for (var i = 1; i < arguments.length; i++) {\n            args[i - 1] = arguments[i];\n        }\n    }\n    queue.push(new Item(fun, args));\n    if (queue.length === 1 && !draining) {\n        runTimeout(drainQueue);\n    }\n};\n\n// v8 likes predictible objects\nfunction Item(fun, array) {\n    this.fun = fun;\n    this.array = array;\n}\nItem.prototype.run = function () {\n    this.fun.apply(null, this.array);\n};\nprocess.title = 'browser';\nprocess.browser = true;\nprocess.env = {};\nprocess.argv = [];\nprocess.version = ''; // empty string to avoid regexp issues\nprocess.versions = {};\n\nfunction noop() {}\n\nprocess.on = noop;\nprocess.addListener = noop;\nprocess.once = noop;\nprocess.off = noop;\nprocess.removeListener = noop;\nprocess.removeAllListeners = noop;\nprocess.emit = noop;\nprocess.prependListener = noop;\nprocess.prependOnceListener = noop;\n\nprocess.listeners = function (name) { return [] }\n\nprocess.binding = function (name) {\n    throw new Error('process.binding is not supported');\n};\n\nprocess.cwd = function () { return '/' };\nprocess.chdir = function (dir) {\n    throw new Error('process.chdir is not supported');\n};\nprocess.umask = function() { return 0; };\n","import { assert } from '@loaders.gl/loader-utils';\nexport function isLoaderObject(loader) {\n  var _loader;\n\n  if (!loader) {\n    return false;\n  }\n\n  if (Array.isArray(loader)) {\n    loader = loader[0];\n  }\n\n  const hasExtensions = Array.isArray((_loader = loader) === null || _loader === void 0 ? void 0 : _loader.extensions);\n  return hasExtensions;\n}\nexport function normalizeLoader(loader) {\n  var _loader2, _loader3;\n\n  assert(loader, 'null loader');\n  assert(isLoaderObject(loader), 'invalid loader');\n  let options;\n\n  if (Array.isArray(loader)) {\n    options = loader[1];\n    loader = loader[0];\n    loader = { ...loader,\n      options: { ...loader.options,\n        ...options\n      }\n    };\n  }\n\n  if ((_loader2 = loader) !== null && _loader2 !== void 0 && _loader2.parseTextSync || (_loader3 = loader) !== null && _loader3 !== void 0 && _loader3.parseText) {\n    loader.text = true;\n  }\n\n  if (!loader.text) {\n    loader.binary = true;\n  }\n\n  return loader;\n}\n//# sourceMappingURL=normalize-loader.js.map","import checkIfBrowser from '../env/is-browser';\nexport { self, window, global, document, process, console } from '../env/globals';\nexport const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'untranspiled source';\nexport const isBrowser = checkIfBrowser();\n//# sourceMappingURL=globals.js.map","function getStorage(type) {\n  try {\n    const storage = window[type];\n    const x = '__storage_test__';\n    storage.setItem(x, x);\n    storage.removeItem(x);\n    return storage;\n  } catch (e) {\n    return null;\n  }\n}\n\nexport default class LocalStorage {\n  constructor(id, defaultSettings, type = 'sessionStorage') {\n    this.storage = getStorage(type);\n    this.id = id;\n    this.config = {};\n    Object.assign(this.config, defaultSettings);\n\n    this._loadConfiguration();\n  }\n\n  getConfiguration() {\n    return this.config;\n  }\n\n  setConfiguration(configuration) {\n    this.config = {};\n    return this.updateConfiguration(configuration);\n  }\n\n  updateConfiguration(configuration) {\n    Object.assign(this.config, configuration);\n\n    if (this.storage) {\n      const serialized = JSON.stringify(this.config);\n      this.storage.setItem(this.id, serialized);\n    }\n\n    return this;\n  }\n\n  _loadConfiguration() {\n    let configuration = {};\n\n    if (this.storage) {\n      const serializedConfiguration = this.storage.getItem(this.id);\n      configuration = serializedConfiguration ? JSON.parse(serializedConfiguration) : {};\n    }\n\n    Object.assign(this.config, configuration);\n    return this;\n  }\n\n}\n//# sourceMappingURL=local-storage.js.map","export function formatTime(ms) {\n  let formatted;\n\n  if (ms < 10) {\n    formatted = \"\".concat(ms.toFixed(2), \"ms\");\n  } else if (ms < 100) {\n    formatted = \"\".concat(ms.toFixed(1), \"ms\");\n  } else if (ms < 1000) {\n    formatted = \"\".concat(ms.toFixed(0), \"ms\");\n  } else {\n    formatted = \"\".concat((ms / 1000).toFixed(2), \"s\");\n  }\n\n  return formatted;\n}\nexport function leftPad(string, length = 8) {\n  const padLength = Math.max(length - string.length, 0);\n  return \"\".concat(' '.repeat(padLength)).concat(string);\n}\nexport function rightPad(string, length = 8) {\n  const padLength = Math.max(length - string.length, 0);\n  return \"\".concat(string).concat(' '.repeat(padLength));\n}\nexport function formatValue(v, opts = {}) {\n  const EPSILON = 1e-16;\n  const {\n    isInteger = false\n  } = opts;\n\n  if (Array.isArray(v) || ArrayBuffer.isView(v)) {\n    return formatArrayValue(v, opts);\n  }\n\n  if (!Number.isFinite(v)) {\n    return String(v);\n  }\n\n  if (Math.abs(v) < EPSILON) {\n    return isInteger ? '0' : '0.';\n  }\n\n  if (isInteger) {\n    return v.toFixed(0);\n  }\n\n  if (Math.abs(v) > 100 && Math.abs(v) < 10000) {\n    return v.toFixed(0);\n  }\n\n  const string = v.toPrecision(2);\n  const decimal = string.indexOf('.0');\n  return decimal === string.length - 2 ? string.slice(0, -1) : string;\n}\n\nfunction formatArrayValue(v, opts) {\n  const {\n    maxElts = 16,\n    size = 1\n  } = opts;\n  let string = '[';\n\n  for (let i = 0; i < v.length && i < maxElts; ++i) {\n    if (i > 0) {\n      string += \",\".concat(i % size === 0 ? ' ' : '');\n    }\n\n    string += formatValue(v[i], opts);\n  }\n\n  const terminator = v.length > maxElts ? '...' : ']';\n  return \"\".concat(string).concat(terminator);\n}\n\nexport function formatImage(image, message, scale, maxWidth = 600) {\n  const imageUrl = image.src.replace(/\\(/g, '%28').replace(/\\)/g, '%29');\n\n  if (image.width > maxWidth) {\n    scale = Math.min(scale, maxWidth / image.width);\n  }\n\n  const width = image.width * scale;\n  const height = image.height * scale;\n  const style = ['font-size:1px;', \"padding:\".concat(Math.floor(height / 2), \"px \").concat(Math.floor(width / 2), \"px;\"), \"line-height:\".concat(height, \"px;\"), \"background:url(\".concat(imageUrl, \");\"), \"background-size:\".concat(width, \"px \").concat(height, \"px;\"), 'color:transparent;'].join('');\n  return [\"\".concat(message, \" %c+\"), style];\n}\n//# sourceMappingURL=formatters.js.map","import { isBrowser } from './globals';\nexport const COLOR = {\n  BLACK: 30,\n  RED: 31,\n  GREEN: 32,\n  YELLOW: 33,\n  BLUE: 34,\n  MAGENTA: 35,\n  CYAN: 36,\n  WHITE: 37,\n  BRIGHT_BLACK: 90,\n  BRIGHT_RED: 91,\n  BRIGHT_GREEN: 92,\n  BRIGHT_YELLOW: 93,\n  BRIGHT_BLUE: 94,\n  BRIGHT_MAGENTA: 95,\n  BRIGHT_CYAN: 96,\n  BRIGHT_WHITE: 97\n};\n\nfunction getColor(color) {\n  return typeof color === 'string' ? COLOR[color.toUpperCase()] || COLOR.WHITE : color;\n}\n\nexport function addColor(string, color, background) {\n  if (!isBrowser && typeof string === 'string') {\n    if (color) {\n      color = getColor(color);\n      string = \"\\x1B[\".concat(color, \"m\").concat(string, \"\\x1B[39m\");\n    }\n\n    if (background) {\n      color = getColor(background);\n      string = \"\\x1B[\".concat(background + 10, \"m\").concat(string, \"\\x1B[49m\");\n    }\n  }\n\n  return string;\n}\n//# sourceMappingURL=color.js.map","export default function assert(condition, message) {\n  if (!condition) {\n    throw new Error(message || 'Assertion failed');\n  }\n}\n//# sourceMappingURL=assert.js.map","import { window, process, isBrowser } from './globals';\nexport default function getHiResTimestamp() {\n  let timestamp;\n\n  if (isBrowser && window.performance) {\n    timestamp = window.performance.now();\n  } else if (process.hrtime) {\n    const timeParts = process.hrtime();\n    timestamp = timeParts[0] * 1000 + timeParts[1] / 1e6;\n  } else {\n    timestamp = Date.now();\n  }\n\n  return timestamp;\n}\n//# sourceMappingURL=hi-res-timestamp.js.map","import { VERSION, isBrowser } from '../utils/globals';\nimport LocalStorage from '../utils/local-storage';\nimport { formatImage, formatTime, leftPad } from '../utils/formatters';\nimport { addColor } from '../utils/color';\nimport { autobind } from '../utils/autobind';\nimport assert from '../utils/assert';\nimport getHiResTimestamp from '../utils/hi-res-timestamp';\nconst originalConsole = {\n  debug: isBrowser ? console.debug || console.log : console.log,\n  log: console.log,\n  info: console.info,\n  warn: console.warn,\n  error: console.error\n};\nconst DEFAULT_SETTINGS = {\n  enabled: true,\n  level: 0\n};\n\nfunction noop() {}\n\nconst cache = {};\nconst ONCE = {\n  once: true\n};\n\nfunction getTableHeader(table) {\n  for (const key in table) {\n    for (const title in table[key]) {\n      return title || 'untitled';\n    }\n  }\n\n  return 'empty';\n}\n\nexport default class Log {\n  constructor({\n    id\n  } = {\n    id: ''\n  }) {\n    this.id = id;\n    this.VERSION = VERSION;\n    this._startTs = getHiResTimestamp();\n    this._deltaTs = getHiResTimestamp();\n    this.LOG_THROTTLE_TIMEOUT = 0;\n    this._storage = new LocalStorage(\"__probe-\".concat(this.id, \"__\"), DEFAULT_SETTINGS);\n    this.userData = {};\n    this.timeStamp(\"\".concat(this.id, \" started\"));\n    autobind(this);\n    Object.seal(this);\n  }\n\n  set level(newLevel) {\n    this.setLevel(newLevel);\n  }\n\n  get level() {\n    return this.getLevel();\n  }\n\n  isEnabled() {\n    return this._storage.config.enabled;\n  }\n\n  getLevel() {\n    return this._storage.config.level;\n  }\n\n  getTotal() {\n    return Number((getHiResTimestamp() - this._startTs).toPrecision(10));\n  }\n\n  getDelta() {\n    return Number((getHiResTimestamp() - this._deltaTs).toPrecision(10));\n  }\n\n  set priority(newPriority) {\n    this.level = newPriority;\n  }\n\n  get priority() {\n    return this.level;\n  }\n\n  getPriority() {\n    return this.level;\n  }\n\n  enable(enabled = true) {\n    this._storage.updateConfiguration({\n      enabled\n    });\n\n    return this;\n  }\n\n  setLevel(level) {\n    this._storage.updateConfiguration({\n      level\n    });\n\n    return this;\n  }\n\n  assert(condition, message) {\n    assert(condition, message);\n  }\n\n  warn(message) {\n    return this._getLogFunction(0, message, originalConsole.warn, arguments, ONCE);\n  }\n\n  error(message) {\n    return this._getLogFunction(0, message, originalConsole.error, arguments);\n  }\n\n  deprecated(oldUsage, newUsage) {\n    return this.warn(\"`\".concat(oldUsage, \"` is deprecated and will be removed in a later version. Use `\").concat(newUsage, \"` instead\"));\n  }\n\n  removed(oldUsage, newUsage) {\n    return this.error(\"`\".concat(oldUsage, \"` has been removed. Use `\").concat(newUsage, \"` instead\"));\n  }\n\n  probe(logLevel, message) {\n    return this._getLogFunction(logLevel, message, originalConsole.log, arguments, {\n      time: true,\n      once: true\n    });\n  }\n\n  log(logLevel, message) {\n    return this._getLogFunction(logLevel, message, originalConsole.debug, arguments);\n  }\n\n  info(logLevel, message) {\n    return this._getLogFunction(logLevel, message, console.info, arguments);\n  }\n\n  once(logLevel, message) {\n    return this._getLogFunction(logLevel, message, originalConsole.debug || originalConsole.info, arguments, ONCE);\n  }\n\n  table(logLevel, table, columns) {\n    if (table) {\n      return this._getLogFunction(logLevel, table, console.table || noop, columns && [columns], {\n        tag: getTableHeader(table)\n      });\n    }\n\n    return noop;\n  }\n\n  image({\n    logLevel,\n    priority,\n    image,\n    message = '',\n    scale = 1\n  }) {\n    if (!this._shouldLog(logLevel || priority)) {\n      return noop;\n    }\n\n    return isBrowser ? logImageInBrowser({\n      image,\n      message,\n      scale\n    }) : logImageInNode({\n      image,\n      message,\n      scale\n    });\n  }\n\n  settings() {\n    if (console.table) {\n      console.table(this._storage.config);\n    } else {\n      console.log(this._storage.config);\n    }\n  }\n\n  get(setting) {\n    return this._storage.config[setting];\n  }\n\n  set(setting, value) {\n    this._storage.updateConfiguration({\n      [setting]: value\n    });\n  }\n\n  time(logLevel, message) {\n    return this._getLogFunction(logLevel, message, console.time ? console.time : console.info);\n  }\n\n  timeEnd(logLevel, message) {\n    return this._getLogFunction(logLevel, message, console.timeEnd ? console.timeEnd : console.info);\n  }\n\n  timeStamp(logLevel, message) {\n    return this._getLogFunction(logLevel, message, console.timeStamp || noop);\n  }\n\n  group(logLevel, message, opts = {\n    collapsed: false\n  }) {\n    opts = normalizeArguments({\n      logLevel,\n      message,\n      opts\n    });\n    const {\n      collapsed\n    } = opts;\n    opts.method = (collapsed ? console.groupCollapsed : console.group) || console.info;\n    return this._getLogFunction(opts);\n  }\n\n  groupCollapsed(logLevel, message, opts = {}) {\n    return this.group(logLevel, message, Object.assign({}, opts, {\n      collapsed: true\n    }));\n  }\n\n  groupEnd(logLevel) {\n    return this._getLogFunction(logLevel, '', console.groupEnd || noop);\n  }\n\n  withGroup(logLevel, message, func) {\n    this.group(logLevel, message)();\n\n    try {\n      func();\n    } finally {\n      this.groupEnd(logLevel)();\n    }\n  }\n\n  trace() {\n    if (console.trace) {\n      console.trace();\n    }\n  }\n\n  _shouldLog(logLevel) {\n    return this.isEnabled() && this.getLevel() >= normalizeLogLevel(logLevel);\n  }\n\n  _getLogFunction(logLevel, message, method, args = [], opts) {\n    if (this._shouldLog(logLevel)) {\n      opts = normalizeArguments({\n        logLevel,\n        message,\n        args,\n        opts\n      });\n      method = method || opts.method;\n      assert(method);\n      opts.total = this.getTotal();\n      opts.delta = this.getDelta();\n      this._deltaTs = getHiResTimestamp();\n      const tag = opts.tag || opts.message;\n\n      if (opts.once) {\n        if (!cache[tag]) {\n          cache[tag] = getHiResTimestamp();\n        } else {\n          return noop;\n        }\n      }\n\n      message = decorateMessage(this.id, opts.message, opts);\n      return method.bind(console, message, ...opts.args);\n    }\n\n    return noop;\n  }\n\n}\nLog.VERSION = VERSION;\n\nfunction normalizeLogLevel(logLevel) {\n  if (!logLevel) {\n    return 0;\n  }\n\n  let resolvedLevel;\n\n  switch (typeof logLevel) {\n    case 'number':\n      resolvedLevel = logLevel;\n      break;\n\n    case 'object':\n      resolvedLevel = logLevel.logLevel || logLevel.priority || 0;\n      break;\n\n    default:\n      return 0;\n  }\n\n  assert(Number.isFinite(resolvedLevel) && resolvedLevel >= 0);\n  return resolvedLevel;\n}\n\nexport function normalizeArguments(opts) {\n  const {\n    logLevel,\n    message\n  } = opts;\n  opts.logLevel = normalizeLogLevel(logLevel);\n  const args = opts.args ? Array.from(opts.args) : [];\n\n  while (args.length && args.shift() !== message) {}\n\n  opts.args = args;\n\n  switch (typeof logLevel) {\n    case 'string':\n    case 'function':\n      if (message !== undefined) {\n        args.unshift(message);\n      }\n\n      opts.message = logLevel;\n      break;\n\n    case 'object':\n      Object.assign(opts, logLevel);\n      break;\n\n    default:\n  }\n\n  if (typeof opts.message === 'function') {\n    opts.message = opts.message();\n  }\n\n  const messageType = typeof opts.message;\n  assert(messageType === 'string' || messageType === 'object');\n  return Object.assign(opts, opts.opts);\n}\n\nfunction decorateMessage(id, message, opts) {\n  if (typeof message === 'string') {\n    const time = opts.time ? leftPad(formatTime(opts.total)) : '';\n    message = opts.time ? \"\".concat(id, \": \").concat(time, \"  \").concat(message) : \"\".concat(id, \": \").concat(message);\n    message = addColor(message, opts.color, opts.background);\n  }\n\n  return message;\n}\n\nfunction logImageInNode({\n  image,\n  message = '',\n  scale = 1\n}) {\n  let asciify = null;\n\n  try {\n    asciify = module.require('asciify-image');\n  } catch (error) {}\n\n  if (asciify) {\n    return () => asciify(image, {\n      fit: 'box',\n      width: \"\".concat(Math.round(80 * scale), \"%\")\n    }).then(data => console.log(data));\n  }\n\n  return noop;\n}\n\nfunction logImageInBrowser({\n  image,\n  message = '',\n  scale = 1\n}) {\n  if (typeof image === 'string') {\n    const img = new Image();\n\n    img.onload = () => {\n      const args = formatImage(img, message, scale);\n      console.log(...args);\n    };\n\n    img.src = image;\n    return noop;\n  }\n\n  const element = image.nodeName || '';\n\n  if (element.toLowerCase() === 'img') {\n    console.log(...formatImage(image, message, scale));\n    return noop;\n  }\n\n  if (element.toLowerCase() === 'canvas') {\n    const img = new Image();\n\n    img.onload = () => console.log(...formatImage(img, message, scale));\n\n    img.src = image.toDataURL();\n    return noop;\n  }\n\n  return noop;\n}\n//# sourceMappingURL=log.js.map","export function autobind(obj, predefined = ['constructor']) {\n  const proto = Object.getPrototypeOf(obj);\n  const propNames = Object.getOwnPropertyNames(proto);\n\n  for (const key of propNames) {\n    if (typeof obj[key] === 'function') {\n      if (!predefined.find(name => key === name)) {\n        obj[key] = obj[key].bind(obj);\n      }\n    }\n  }\n}\n//# sourceMappingURL=autobind.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { Log } from 'probe.gl';\nexport const probeLog = new Log({\n  id: 'loaders.gl'\n});\nexport class NullLog {\n  log() {\n    return () => {};\n  }\n\n  info() {\n    return () => {};\n  }\n\n  warn() {\n    return () => {};\n  }\n\n  error() {\n    return () => {};\n  }\n\n}\nexport class ConsoleLog {\n  constructor() {\n    _defineProperty(this, \"console\", void 0);\n\n    this.console = console;\n  }\n\n  log(...args) {\n    return this.console.log.bind(this.console, ...args);\n  }\n\n  info(...args) {\n    return this.console.info.bind(this.console, ...args);\n  }\n\n  warn(...args) {\n    return this.console.warn.bind(this.console, ...args);\n  }\n\n  error(...args) {\n    return this.console.error.bind(this.console, ...args);\n  }\n\n}\n//# sourceMappingURL=loggers.js.map","import { isBrowser } from '@loaders.gl/loader-utils';\nimport { ConsoleLog } from './loggers';\nexport const DEFAULT_LOADER_OPTIONS = {\n  fetch: null,\n  mimeType: undefined,\n  nothrow: false,\n  log: new ConsoleLog(),\n  CDN: 'https://unpkg.com/@loaders.gl',\n  worker: true,\n  maxConcurrency: 3,\n  maxMobileConcurrency: 1,\n  reuseWorkers: isBrowser,\n  _nodeWorkers: false,\n  _workerType: '',\n  limit: 0,\n  _limitMB: 0,\n  batchSize: 'auto',\n  batchDebounceMs: 0,\n  metadata: false,\n  transforms: []\n};\nexport const REMOVED_LOADER_OPTIONS = {\n  throws: 'nothrow',\n  dataType: '(no longer used)',\n  uri: 'baseUri',\n  method: 'fetch.method',\n  headers: 'fetch.headers',\n  body: 'fetch.body',\n  mode: 'fetch.mode',\n  credentials: 'fetch.credentials',\n  cache: 'fetch.cache',\n  redirect: 'fetch.redirect',\n  referrer: 'fetch.referrer',\n  referrerPolicy: 'fetch.referrerPolicy',\n  integrity: 'fetch.integrity',\n  keepalive: 'fetch.keepalive',\n  signal: 'fetch.signal'\n};\n//# sourceMappingURL=option-defaults.js.map","import { isPureObject, isObject } from '../../javascript-utils/is-type';\nimport { fetchFile } from '../fetch/fetch-file';\nimport { probeLog, NullLog } from './loggers';\nimport { DEFAULT_LOADER_OPTIONS, REMOVED_LOADER_OPTIONS } from './option-defaults';\nexport function getGlobalLoaderState() {\n  globalThis.loaders = globalThis.loaders || {};\n  const {\n    loaders\n  } = globalThis;\n  loaders._state = loaders._state || {};\n  return loaders._state;\n}\nexport const getGlobalLoaderOptions = () => {\n  const state = getGlobalLoaderState();\n  state.globalOptions = state.globalOptions || { ...DEFAULT_LOADER_OPTIONS\n  };\n  return state.globalOptions;\n};\nexport function setGlobalOptions(options) {\n  const state = getGlobalLoaderState();\n  const globalOptions = getGlobalLoaderOptions();\n  state.globalOptions = normalizeOptionsInternal(globalOptions, options);\n}\nexport function normalizeOptions(options, loader, loaders, url) {\n  loaders = loaders || [];\n  loaders = Array.isArray(loaders) ? loaders : [loaders];\n  validateOptions(options, loaders);\n  return normalizeOptionsInternal(loader, options, url);\n}\nexport function getFetchFunction(options, context) {\n  const globalOptions = getGlobalLoaderOptions();\n  const fetchOptions = options || globalOptions;\n\n  if (typeof fetchOptions.fetch === 'function') {\n    return fetchOptions.fetch;\n  }\n\n  if (isObject(fetchOptions.fetch)) {\n    return url => fetchFile(url, fetchOptions);\n  }\n\n  if (context !== null && context !== void 0 && context.fetch) {\n    return context === null || context === void 0 ? void 0 : context.fetch;\n  }\n\n  return fetchFile;\n}\n\nfunction validateOptions(options, loaders) {\n  validateOptionsObject(options, null, DEFAULT_LOADER_OPTIONS, REMOVED_LOADER_OPTIONS, loaders);\n\n  for (const loader of loaders) {\n    const idOptions = options && options[loader.id] || {};\n    const loaderOptions = loader.options && loader.options[loader.id] || {};\n    const deprecatedOptions = loader.deprecatedOptions && loader.deprecatedOptions[loader.id] || {};\n    validateOptionsObject(idOptions, loader.id, loaderOptions, deprecatedOptions, loaders);\n  }\n}\n\nfunction validateOptionsObject(options, id, defaultOptions, deprecatedOptions, loaders) {\n  const loaderName = id || 'Top level';\n  const prefix = id ? \"\".concat(id, \".\") : '';\n\n  for (const key in options) {\n    const isSubOptions = !id && isObject(options[key]);\n    const isBaseUriOption = key === 'baseUri' && !id;\n    const isWorkerUrlOption = key === 'workerUrl' && id;\n\n    if (!(key in defaultOptions) && !isBaseUriOption && !isWorkerUrlOption) {\n      if (key in deprecatedOptions) {\n        probeLog.warn(\"\".concat(loaderName, \" loader option '\").concat(prefix).concat(key, \"' no longer supported, use '\").concat(deprecatedOptions[key], \"'\"))();\n      } else if (!isSubOptions) {\n        const suggestion = findSimilarOption(key, loaders);\n        probeLog.warn(\"\".concat(loaderName, \" loader option '\").concat(prefix).concat(key, \"' not recognized. \").concat(suggestion))();\n      }\n    }\n  }\n}\n\nfunction findSimilarOption(optionKey, loaders) {\n  const lowerCaseOptionKey = optionKey.toLowerCase();\n  let bestSuggestion = '';\n\n  for (const loader of loaders) {\n    for (const key in loader.options) {\n      if (optionKey === key) {\n        return \"Did you mean '\".concat(loader.id, \".\").concat(key, \"'?\");\n      }\n\n      const lowerCaseKey = key.toLowerCase();\n      const isPartialMatch = lowerCaseOptionKey.startsWith(lowerCaseKey) || lowerCaseKey.startsWith(lowerCaseOptionKey);\n\n      if (isPartialMatch) {\n        bestSuggestion = bestSuggestion || \"Did you mean '\".concat(loader.id, \".\").concat(key, \"'?\");\n      }\n    }\n  }\n\n  return bestSuggestion;\n}\n\nfunction normalizeOptionsInternal(loader, options, url) {\n  const loaderDefaultOptions = loader.options || {};\n  const mergedOptions = { ...loaderDefaultOptions\n  };\n  addUrlOptions(mergedOptions, url);\n\n  if (mergedOptions.log === null) {\n    mergedOptions.log = new NullLog();\n  }\n\n  mergeNestedFields(mergedOptions, getGlobalLoaderOptions());\n  mergeNestedFields(mergedOptions, options);\n  return mergedOptions;\n}\n\nfunction mergeNestedFields(mergedOptions, options) {\n  for (const key in options) {\n    if (key in options) {\n      const value = options[key];\n\n      if (isPureObject(value) && isPureObject(mergedOptions[key])) {\n        mergedOptions[key] = { ...mergedOptions[key],\n          ...options[key]\n        };\n      } else {\n        mergedOptions[key] = options[key];\n      }\n    }\n  }\n}\n\nfunction addUrlOptions(options, url) {\n  if (url && !('baseUri' in options)) {\n    options.baseUri = url;\n  }\n}\n//# sourceMappingURL=option-utils.js.map","import { assert } from './assert';\nconst uidCounters = {};\nexport function uid() {\n  let id = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'id';\n  uidCounters[id] = uidCounters[id] || 1;\n  const count = uidCounters[id]++;\n  return \"\".concat(id, \"-\").concat(count);\n}\nexport function isPowerOfTwo(n) {\n  assert(typeof n === 'number', 'Input must be a number');\n  return n && (n & n - 1) === 0;\n}\nexport function isObjectEmpty(obj) {\n  let isEmpty = true;\n\n  for (const key in obj) {\n    isEmpty = false;\n    break;\n  }\n\n  return isEmpty;\n}\n//# sourceMappingURL=utils.js.map","import { assert } from '../utils/assert';\nexport function getKeyValue(gl, name) {\n  if (typeof name !== 'string') {\n    return name;\n  }\n\n  const number = Number(name);\n\n  if (!isNaN(number)) {\n    return number;\n  }\n\n  name = name.replace(/^.*\\./, '');\n  const value = gl[name];\n  assert(value !== undefined, \"Accessing undefined constant GL.\".concat(name));\n  return value;\n}\nexport function getKey(gl, value) {\n  value = Number(value);\n\n  for (const key in gl) {\n    if (gl[key] === value) {\n      return \"GL.\".concat(key);\n    }\n  }\n\n  return String(value);\n}\nexport function getKeyType(gl, value) {\n  assert(value !== undefined, 'undefined key');\n  value = Number(value);\n\n  for (const key in gl) {\n    if (gl[key] === value) {\n      return \"GL.\".concat(key);\n    }\n  }\n\n  return String(value);\n}\n//# sourceMappingURL=constants-to-keys.js.map","const globals = {\n  self: typeof self !== 'undefined' && self,\n  window: typeof window !== 'undefined' && window,\n  global: typeof global !== 'undefined' && global,\n  document: typeof document !== 'undefined' && document\n};\nconst self_ = globals.self || globals.window || globals.global || {};\nconst window_ = globals.window || globals.self || globals.global || {};\nconst global_ = globals.global || globals.self || globals.window || {};\nconst document_ = globals.document || {};\nexport { self_ as self, window_ as window, global_ as global, document_ as document };\nexport const isBrowser = typeof process !== 'object' || String(process) !== '[object process]' || process.browser;\nexport const isWorker = typeof importScripts === 'function';\nexport const isMobile = typeof window !== 'undefined' && typeof window.orientation !== 'undefined';\nconst matches = typeof process !== 'undefined' && process.version && /v([0-9]*)/.exec(process.version);\nexport const nodeVersion = matches && parseFloat(matches[1]) || 0;\n//# sourceMappingURL=globals.js.map","import TransitionInterpolator from './transition-interpolator';\nimport {lerp} from '@math.gl/core';\n\nimport type Viewport from '../viewports/viewport';\n\nconst DEFAULT_PROPS = ['longitude', 'latitude', 'zoom', 'bearing', 'pitch'];\nconst DEFAULT_REQUIRED_PROPS = ['longitude', 'latitude', 'zoom'];\n\ntype PropsWithAnchor = {\n  around?: number[];\n  aroundPosition?: number[];\n  [key: string]: any;\n};\n\n/**\n * Performs linear interpolation of two view states.\n */\nexport default class LinearInterpolator extends TransitionInterpolator {\n  opts: {\n    around?: number[];\n    makeViewport?: (props: Record<string, any>) => Viewport;\n  };\n\n  /**\n   * @param {Object} opts\n   * @param {Array} opts.transitionProps - list of props to apply linear transition to.\n   * @param {Array} opts.around - a screen point to zoom/rotate around.\n   * @param {Function} opts.makeViewport - construct a viewport instance with given props.\n   */\n  constructor(\n    opts:\n      | string[]\n      | {\n          transitionProps?:\n            | string[]\n            | {\n                compare: string[];\n                extract?: string[];\n                required?: string[];\n              };\n          around?: number[];\n          makeViewport?: (props: Record<string, any>) => Viewport;\n        } = {}\n  ) {\n    // Backward compatibility\n    const transitionProps = Array.isArray(opts) ? opts : opts.transitionProps;\n\n    const normalizedOpts = Array.isArray(opts) ? {} : opts;\n    normalizedOpts.transitionProps = Array.isArray(transitionProps)\n      ? {\n          compare: transitionProps,\n          required: transitionProps\n        }\n      : transitionProps || {\n          compare: DEFAULT_PROPS,\n          required: DEFAULT_REQUIRED_PROPS\n        };\n\n    super(normalizedOpts.transitionProps);\n    this.opts = normalizedOpts;\n  }\n\n  initializeProps(\n    startProps: Record<string, any>,\n    endProps: Record<string, any>\n  ): {\n    start: PropsWithAnchor;\n    end: PropsWithAnchor;\n  } {\n    const result = super.initializeProps(startProps, endProps);\n\n    const {makeViewport, around} = this.opts;\n    if (makeViewport && around) {\n      const startViewport = makeViewport(startProps);\n      const endViewport = makeViewport(endProps);\n      const aroundPosition = startViewport.unproject(around);\n      result.start.around = around;\n      Object.assign(result.end, {\n        around: endViewport.project(aroundPosition),\n        aroundPosition,\n        width: endProps.width,\n        height: endProps.height\n      });\n    }\n\n    return result;\n  }\n\n  interpolateProps(\n    startProps: PropsWithAnchor,\n    endProps: PropsWithAnchor,\n    t: number\n  ): Record<string, any> {\n    const propsInTransition = {};\n    for (const key of this._propsToExtract) {\n      propsInTransition[key] = lerp(startProps[key] || 0, endProps[key] || 0, t);\n    }\n\n    if (endProps.aroundPosition && this.opts.makeViewport) {\n      // Linear transition should be performed in common space\n      const viewport = this.opts.makeViewport({...endProps, ...propsInTransition});\n      Object.assign(\n        propsInTransition,\n        viewport.panByPosition(\n          endProps.aroundPosition,\n          // anchor point in current screen coordinates\n          lerp(startProps.around as number[], endProps.around as number[], t) as number[]\n        )\n      );\n    }\n    return propsInTransition;\n  }\n}\n","export function assert(condition, message) {\n  if (!condition) {\n    throw new Error(message || 'loaders.gl assertion failed.');\n  }\n}\n//# sourceMappingURL=assert.js.map","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\nimport type {NumericArray} from '../types/types';\nimport type {AccessorFunction} from '../types/layer-props';\n\nconst EMPTY_ARRAY = [];\nconst placeholderArray = [];\n\n/*\n * Create an Iterable\n * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols\n * and a \"context\" tracker from the given data\n */\nexport function createIterable(\n  data,\n  startRow = 0,\n  endRow = Infinity\n): {\n  iterable: Iterable<any>;\n  objectInfo: {\n    index: number;\n    data: any;\n    target: any[];\n  };\n} {\n  let iterable: Iterable<any> = EMPTY_ARRAY;\n\n  const objectInfo = {\n    index: -1,\n    data,\n    // visitor can optionally utilize this to avoid constructing a new array for every object\n    target: []\n  };\n\n  if (!data) {\n    iterable = EMPTY_ARRAY;\n  } else if (typeof data[Symbol.iterator] === 'function') {\n    // data is already an iterable\n    iterable = data;\n  } else if (data.length > 0) {\n    placeholderArray.length = data.length;\n    iterable = placeholderArray;\n  }\n\n  if (startRow > 0 || Number.isFinite(endRow)) {\n    iterable = (Array.isArray(iterable) ? iterable : Array.from(iterable)).slice(startRow, endRow);\n    objectInfo.index = startRow - 1;\n  }\n\n  return {iterable, objectInfo};\n}\n\n/*\n * Returns true if data is an async iterable object\n */\nexport function isAsyncIterable(data): boolean {\n  return data && data[Symbol.asyncIterator];\n}\n\n/*\n * Create an accessor function from a flat buffer that yields the value at each object index\n */\nexport function getAccessorFromBuffer(\n  typedArray,\n  options: {\n    size: number;\n    stride?: number;\n    offset?: number;\n    startIndices?: NumericArray;\n    nested?: boolean;\n  }\n): AccessorFunction<any, NumericArray> {\n  const {size, stride, offset, startIndices, nested} = options;\n  const bytesPerElement = typedArray.BYTES_PER_ELEMENT;\n  const elementStride = stride ? stride / bytesPerElement : size;\n  const elementOffset = offset ? offset / bytesPerElement : 0;\n  const vertexCount = Math.floor((typedArray.length - elementOffset) / elementStride);\n\n  return (_, {index, target}) => {\n    if (!startIndices) {\n      const sourceIndex = index * elementStride + elementOffset;\n      for (let j = 0; j < size; j++) {\n        target[j] = typedArray[sourceIndex + j];\n      }\n      return target;\n    }\n    const startIndex = startIndices[index];\n    const endIndex = startIndices[index + 1] || vertexCount;\n    let result;\n\n    if (nested) {\n      result = new Array(endIndex - startIndex);\n      for (let i = startIndex; i < endIndex; i++) {\n        const sourceIndex = i * elementStride + elementOffset;\n        target = new Array(size);\n        for (let j = 0; j < size; j++) {\n          target[j] = typedArray[sourceIndex + j];\n        }\n        result[i - startIndex] = target;\n      }\n    } else if (elementStride === size) {\n      result = typedArray.subarray(\n        startIndex * size + elementOffset,\n        endIndex * size + elementOffset\n      );\n    } else {\n      result = new typedArray.constructor((endIndex - startIndex) * size);\n      let targetIndex = 0;\n      for (let i = startIndex; i < endIndex; i++) {\n        const sourceIndex = i * elementStride + elementOffset;\n        for (let j = 0; j < size; j++) {\n          result[targetIndex++] = typedArray[sourceIndex + j];\n        }\n      }\n    }\n\n    return result;\n  };\n}\n","const ERR_TYPE_DEDUCTION = 'Failed to deduce GL constant from typed array';\nexport function getGLTypeFromTypedArray(arrayOrType) {\n  const type = ArrayBuffer.isView(arrayOrType) ? arrayOrType.constructor : arrayOrType;\n\n  switch (type) {\n    case Float32Array:\n      return 5126;\n\n    case Uint16Array:\n      return 5123;\n\n    case Uint32Array:\n      return 5125;\n\n    case Uint8Array:\n      return 5121;\n\n    case Uint8ClampedArray:\n      return 5121;\n\n    case Int8Array:\n      return 5120;\n\n    case Int16Array:\n      return 5122;\n\n    case Int32Array:\n      return 5124;\n\n    default:\n      throw new Error(ERR_TYPE_DEDUCTION);\n  }\n}\nexport function getTypedArrayFromGLType(glType) {\n  let {\n    clamped = true\n  } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n\n  switch (glType) {\n    case 5126:\n      return Float32Array;\n\n    case 5123:\n    case 33635:\n    case 32819:\n    case 32820:\n      return Uint16Array;\n\n    case 5125:\n      return Uint32Array;\n\n    case 5121:\n      return clamped ? Uint8ClampedArray : Uint8Array;\n\n    case 5120:\n      return Int8Array;\n\n    case 5122:\n      return Int16Array;\n\n    case 5124:\n      return Int32Array;\n\n    default:\n      throw new Error('Failed to deduce typed array type from GL constant');\n  }\n}\nexport function flipRows(_ref) {\n  let {\n    data,\n    width,\n    height,\n    bytesPerPixel = 4,\n    temp\n  } = _ref;\n  const bytesPerRow = width * bytesPerPixel;\n  temp = temp || new Uint8Array(bytesPerRow);\n\n  for (let y = 0; y < height / 2; ++y) {\n    const topOffset = y * bytesPerRow;\n    const bottomOffset = (height - y - 1) * bytesPerRow;\n    temp.set(data.subarray(topOffset, topOffset + bytesPerRow));\n    data.copyWithin(topOffset, bottomOffset, bottomOffset + bytesPerRow);\n    data.set(temp, bottomOffset);\n  }\n}\nexport function scalePixels(_ref2) {\n  let {\n    data,\n    width,\n    height\n  } = _ref2;\n  const newWidth = Math.round(width / 2);\n  const newHeight = Math.round(height / 2);\n  const newData = new Uint8Array(newWidth * newHeight * 4);\n\n  for (let y = 0; y < newHeight; y++) {\n    for (let x = 0; x < newWidth; x++) {\n      for (let c = 0; c < 4; c++) {\n        newData[(y * newWidth + x) * 4 + c] = data[(y * 2 * width + x * 2) * 4 + c];\n      }\n    }\n  }\n\n  return {\n    data: newData,\n    width: newWidth,\n    height: newHeight\n  };\n}\n//# sourceMappingURL=typed-array-utils.js.map","import { isWebGL2, assertWebGL2Context, withParameters, log } from '@luma.gl/gltools';\nimport Resource from './resource';\nimport Buffer from './buffer';\nimport { TEXTURE_FORMATS, DATA_FORMAT_CHANNELS, TYPE_SIZES, isFormatSupported, isLinearFilteringSupported } from './texture-formats';\nimport { assert } from '../utils/assert';\nimport { uid, isPowerOfTwo } from '../utils/utils';\nconst NPOT_MIN_FILTERS = [9729, 9728];\n\nconst WebGLBuffer = globalThis.WebGLBuffer || function WebGLBuffer() {};\n\nexport default class Texture extends Resource {\n  get [Symbol.toStringTag]() {\n    return 'Texture';\n  }\n\n  static isSupported(gl) {\n    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    const {\n      format,\n      linearFiltering\n    } = opts;\n    let supported = true;\n\n    if (format) {\n      supported = supported && isFormatSupported(gl, format);\n      supported = supported && (!linearFiltering || isLinearFilteringSupported(gl, format));\n    }\n\n    return supported;\n  }\n\n  constructor(gl, props) {\n    const {\n      id = uid('texture'),\n      handle,\n      target\n    } = props;\n    super(gl, {\n      id,\n      handle\n    });\n    this.target = target;\n    this.textureUnit = undefined;\n    this.loaded = false;\n    this.width = undefined;\n    this.height = undefined;\n    this.depth = undefined;\n    this.format = undefined;\n    this.type = undefined;\n    this.dataFormat = undefined;\n    this.border = undefined;\n    this.textureUnit = undefined;\n    this.mipmaps = undefined;\n  }\n\n  toString() {\n    return \"Texture(\".concat(this.id, \",\").concat(this.width, \"x\").concat(this.height, \")\");\n  }\n\n  initialize() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    let data = props.data;\n\n    if (data instanceof Promise) {\n      data.then(resolvedImageData => this.initialize(Object.assign({}, props, {\n        pixels: resolvedImageData,\n        data: resolvedImageData\n      })));\n      return this;\n    }\n\n    const isVideo = typeof HTMLVideoElement !== 'undefined' && data instanceof HTMLVideoElement;\n\n    if (isVideo && data.readyState < HTMLVideoElement.HAVE_METADATA) {\n      this._video = null;\n      data.addEventListener('loadeddata', () => this.initialize(props));\n      return this;\n    }\n\n    const {\n      pixels = null,\n      format = 6408,\n      border = 0,\n      recreate = false,\n      parameters = {},\n      pixelStore = {},\n      textureUnit = undefined\n    } = props;\n\n    if (!data) {\n      data = pixels;\n    }\n\n    let {\n      width,\n      height,\n      dataFormat,\n      type,\n      compressed = false,\n      mipmaps = true\n    } = props;\n    const {\n      depth = 0\n    } = props;\n    ({\n      width,\n      height,\n      compressed,\n      dataFormat,\n      type\n    } = this._deduceParameters({\n      format,\n      type,\n      dataFormat,\n      compressed,\n      data,\n      width,\n      height\n    }));\n    this.width = width;\n    this.height = height;\n    this.depth = depth;\n    this.format = format;\n    this.type = type;\n    this.dataFormat = dataFormat;\n    this.border = border;\n    this.textureUnit = textureUnit;\n\n    if (Number.isFinite(this.textureUnit)) {\n      this.gl.activeTexture(33984 + this.textureUnit);\n      this.gl.bindTexture(this.target, this.handle);\n    }\n\n    if (mipmaps && this._isNPOT()) {\n      log.warn(\"texture: \".concat(this, \" is Non-Power-Of-Two, disabling mipmaping\"))();\n      mipmaps = false;\n\n      this._updateForNPOT(parameters);\n    }\n\n    this.mipmaps = mipmaps;\n    this.setImageData({\n      data,\n      width,\n      height,\n      depth,\n      format,\n      type,\n      dataFormat,\n      border,\n      mipmaps,\n      parameters: pixelStore,\n      compressed\n    });\n\n    if (mipmaps) {\n      this.generateMipmap();\n    }\n\n    this.setParameters(parameters);\n\n    if (recreate) {\n      this.data = data;\n    }\n\n    if (isVideo) {\n      this._video = {\n        video: data,\n        parameters,\n        lastTime: data.readyState >= HTMLVideoElement.HAVE_CURRENT_DATA ? data.currentTime : -1\n      };\n    }\n\n    return this;\n  }\n\n  update() {\n    if (this._video) {\n      const {\n        video,\n        parameters,\n        lastTime\n      } = this._video;\n\n      if (lastTime === video.currentTime || video.readyState < HTMLVideoElement.HAVE_CURRENT_DATA) {\n        return;\n      }\n\n      this.setSubImageData({\n        data: video,\n        parameters\n      });\n\n      if (this.mipmaps) {\n        this.generateMipmap();\n      }\n\n      this._video.lastTime = video.currentTime;\n    }\n  }\n\n  resize(_ref) {\n    let {\n      height,\n      width,\n      mipmaps = false\n    } = _ref;\n\n    if (width !== this.width || height !== this.height) {\n      return this.initialize({\n        width,\n        height,\n        format: this.format,\n        type: this.type,\n        dataFormat: this.dataFormat,\n        border: this.border,\n        mipmaps\n      });\n    }\n\n    return this;\n  }\n\n  generateMipmap() {\n    let params = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    if (this._isNPOT()) {\n      log.warn(\"texture: \".concat(this, \" is Non-Power-Of-Two, disabling mipmaping\"))();\n      return this;\n    }\n\n    this.mipmaps = true;\n    this.gl.bindTexture(this.target, this.handle);\n    withParameters(this.gl, params, () => {\n      this.gl.generateMipmap(this.target);\n    });\n    this.gl.bindTexture(this.target, null);\n    return this;\n  }\n\n  setImageData(options) {\n    this._trackDeallocatedMemory('Texture');\n\n    const {\n      target = this.target,\n      pixels = null,\n      level = 0,\n      format = this.format,\n      border = this.border,\n      offset = 0,\n      parameters = {}\n    } = options;\n    let {\n      data = null,\n      type = this.type,\n      width = this.width,\n      height = this.height,\n      dataFormat = this.dataFormat,\n      compressed = false\n    } = options;\n\n    if (!data) {\n      data = pixels;\n    }\n\n    ({\n      type,\n      dataFormat,\n      compressed,\n      width,\n      height\n    } = this._deduceParameters({\n      format,\n      type,\n      dataFormat,\n      compressed,\n      data,\n      width,\n      height\n    }));\n    const {\n      gl\n    } = this;\n    gl.bindTexture(this.target, this.handle);\n    let dataType = null;\n    ({\n      data,\n      dataType\n    } = this._getDataType({\n      data,\n      compressed\n    }));\n    let gl2;\n    let compressedTextureSize = 0;\n    withParameters(this.gl, parameters, () => {\n      switch (dataType) {\n        case 'null':\n          gl.texImage2D(target, level, format, width, height, border, dataFormat, type, data);\n          break;\n\n        case 'typed-array':\n          gl.texImage2D(target, level, format, width, height, border, dataFormat, type, data, offset);\n          break;\n\n        case 'buffer':\n          gl2 = assertWebGL2Context(gl);\n          gl2.bindBuffer(35052, data.handle || data);\n          gl2.texImage2D(target, level, format, width, height, border, dataFormat, type, offset);\n          gl2.bindBuffer(35052, null);\n          break;\n\n        case 'browser-object':\n          if (isWebGL2(gl)) {\n            gl.texImage2D(target, level, format, width, height, border, dataFormat, type, data);\n          } else {\n            gl.texImage2D(target, level, format, dataFormat, type, data);\n          }\n\n          break;\n\n        case 'compressed':\n          for (const [levelIndex, levelData] of data.entries()) {\n            gl.compressedTexImage2D(target, levelIndex, levelData.format, levelData.width, levelData.height, border, levelData.data);\n            compressedTextureSize += levelData.levelSize;\n          }\n\n          break;\n\n        default:\n          assert(false, 'Unknown image data type');\n      }\n    });\n\n    if (dataType === 'compressed') {\n      this._trackAllocatedMemory(compressedTextureSize, 'Texture');\n    } else if (data && data.byteLength) {\n      this._trackAllocatedMemory(data.byteLength, 'Texture');\n    } else {\n      const channels = DATA_FORMAT_CHANNELS[this.dataFormat] || 4;\n      const channelSize = TYPE_SIZES[this.type] || 1;\n\n      this._trackAllocatedMemory(this.width * this.height * channels * channelSize, 'Texture');\n    }\n\n    this.loaded = true;\n    return this;\n  }\n\n  setSubImageData(_ref2) {\n    let {\n      target = this.target,\n      pixels = null,\n      data = null,\n      x = 0,\n      y = 0,\n      width = this.width,\n      height = this.height,\n      level = 0,\n      format = this.format,\n      type = this.type,\n      dataFormat = this.dataFormat,\n      compressed = false,\n      offset = 0,\n      border = this.border,\n      parameters = {}\n    } = _ref2;\n    ({\n      type,\n      dataFormat,\n      compressed,\n      width,\n      height\n    } = this._deduceParameters({\n      format,\n      type,\n      dataFormat,\n      compressed,\n      data,\n      width,\n      height\n    }));\n    assert(this.depth === 0, 'texSubImage not supported for 3D textures');\n\n    if (!data) {\n      data = pixels;\n    }\n\n    if (data && data.data) {\n      const ndarray = data;\n      data = ndarray.data;\n      width = ndarray.shape[0];\n      height = ndarray.shape[1];\n    }\n\n    if (data instanceof Buffer) {\n      data = data.handle;\n    }\n\n    this.gl.bindTexture(this.target, this.handle);\n    withParameters(this.gl, parameters, () => {\n      if (compressed) {\n        this.gl.compressedTexSubImage2D(target, level, x, y, width, height, format, data);\n      } else if (data === null) {\n        this.gl.texSubImage2D(target, level, x, y, width, height, dataFormat, type, null);\n      } else if (ArrayBuffer.isView(data)) {\n        this.gl.texSubImage2D(target, level, x, y, width, height, dataFormat, type, data, offset);\n      } else if (data instanceof WebGLBuffer) {\n        const gl2 = assertWebGL2Context(this.gl);\n        gl2.bindBuffer(35052, data);\n        gl2.texSubImage2D(target, level, x, y, width, height, dataFormat, type, offset);\n        gl2.bindBuffer(35052, null);\n      } else if (isWebGL2(this.gl)) {\n        const gl2 = assertWebGL2Context(this.gl);\n        gl2.texSubImage2D(target, level, x, y, width, height, dataFormat, type, data);\n      } else {\n        this.gl.texSubImage2D(target, level, x, y, dataFormat, type, data);\n      }\n    });\n    this.gl.bindTexture(this.target, null);\n  }\n\n  copyFramebuffer() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    log.error('Texture.copyFramebuffer({...}) is no logner supported, use copyToTexture(source, target, opts})')();\n    return null;\n  }\n\n  getActiveUnit() {\n    return this.gl.getParameter(34016) - 33984;\n  }\n\n  bind() {\n    let textureUnit = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.textureUnit;\n    const {\n      gl\n    } = this;\n\n    if (textureUnit !== undefined) {\n      this.textureUnit = textureUnit;\n      gl.activeTexture(33984 + textureUnit);\n    }\n\n    gl.bindTexture(this.target, this.handle);\n    return textureUnit;\n  }\n\n  unbind() {\n    let textureUnit = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.textureUnit;\n    const {\n      gl\n    } = this;\n\n    if (textureUnit !== undefined) {\n      this.textureUnit = textureUnit;\n      gl.activeTexture(33984 + textureUnit);\n    }\n\n    gl.bindTexture(this.target, null);\n    return textureUnit;\n  }\n\n  _getDataType(_ref3) {\n    let {\n      data,\n      compressed = false\n    } = _ref3;\n\n    if (compressed) {\n      return {\n        data,\n        dataType: 'compressed'\n      };\n    }\n\n    if (data === null) {\n      return {\n        data,\n        dataType: 'null'\n      };\n    }\n\n    if (ArrayBuffer.isView(data)) {\n      return {\n        data,\n        dataType: 'typed-array'\n      };\n    }\n\n    if (data instanceof Buffer) {\n      return {\n        data: data.handle,\n        dataType: 'buffer'\n      };\n    }\n\n    if (data instanceof WebGLBuffer) {\n      return {\n        data,\n        dataType: 'buffer'\n      };\n    }\n\n    return {\n      data,\n      dataType: 'browser-object'\n    };\n  }\n\n  _deduceParameters(opts) {\n    const {\n      format,\n      data\n    } = opts;\n    let {\n      width,\n      height,\n      dataFormat,\n      type,\n      compressed\n    } = opts;\n    const textureFormat = TEXTURE_FORMATS[format];\n    dataFormat = dataFormat || textureFormat && textureFormat.dataFormat;\n    type = type || textureFormat && textureFormat.types[0];\n    compressed = compressed || textureFormat && textureFormat.compressed;\n    ({\n      width,\n      height\n    } = this._deduceImageSize(data, width, height));\n    return {\n      dataFormat,\n      type,\n      compressed,\n      width,\n      height,\n      format,\n      data\n    };\n  }\n\n  _deduceImageSize(data, width, height) {\n    let size;\n\n    if (typeof ImageData !== 'undefined' && data instanceof ImageData) {\n      size = {\n        width: data.width,\n        height: data.height\n      };\n    } else if (typeof HTMLImageElement !== 'undefined' && data instanceof HTMLImageElement) {\n      size = {\n        width: data.naturalWidth,\n        height: data.naturalHeight\n      };\n    } else if (typeof HTMLCanvasElement !== 'undefined' && data instanceof HTMLCanvasElement) {\n      size = {\n        width: data.width,\n        height: data.height\n      };\n    } else if (typeof ImageBitmap !== 'undefined' && data instanceof ImageBitmap) {\n      size = {\n        width: data.width,\n        height: data.height\n      };\n    } else if (typeof HTMLVideoElement !== 'undefined' && data instanceof HTMLVideoElement) {\n      size = {\n        width: data.videoWidth,\n        height: data.videoHeight\n      };\n    } else if (!data) {\n      size = {\n        width: width >= 0 ? width : 1,\n        height: height >= 0 ? height : 1\n      };\n    } else {\n      size = {\n        width,\n        height\n      };\n    }\n\n    assert(size, 'Could not deduced texture size');\n    assert(width === undefined || size.width === width, 'Deduced texture width does not match supplied width');\n    assert(height === undefined || size.height === height, 'Deduced texture height does not match supplied height');\n    return size;\n  }\n\n  _createHandle() {\n    return this.gl.createTexture();\n  }\n\n  _deleteHandle() {\n    this.gl.deleteTexture(this.handle);\n\n    this._trackDeallocatedMemory('Texture');\n  }\n\n  _getParameter(pname) {\n    switch (pname) {\n      case 4096:\n        return this.width;\n\n      case 4097:\n        return this.height;\n\n      default:\n        this.gl.bindTexture(this.target, this.handle);\n        const value = this.gl.getTexParameter(this.target, pname);\n        this.gl.bindTexture(this.target, null);\n        return value;\n    }\n  }\n\n  _setParameter(pname, param) {\n    this.gl.bindTexture(this.target, this.handle);\n    param = this._getNPOTParam(pname, param);\n\n    switch (pname) {\n      case 33082:\n      case 33083:\n        this.gl.texParameterf(this.handle, pname, param);\n        break;\n\n      case 4096:\n      case 4097:\n        assert(false);\n        break;\n\n      default:\n        this.gl.texParameteri(this.target, pname, param);\n        break;\n    }\n\n    this.gl.bindTexture(this.target, null);\n    return this;\n  }\n\n  _isNPOT() {\n    if (isWebGL2(this.gl)) {\n      return false;\n    }\n\n    if (!this.width || !this.height) {\n      return false;\n    }\n\n    return !isPowerOfTwo(this.width) || !isPowerOfTwo(this.height);\n  }\n\n  _updateForNPOT(parameters) {\n    if (parameters[this.gl.TEXTURE_MIN_FILTER] === undefined) {\n      parameters[this.gl.TEXTURE_MIN_FILTER] = this.gl.LINEAR;\n    }\n\n    if (parameters[this.gl.TEXTURE_WRAP_S] === undefined) {\n      parameters[this.gl.TEXTURE_WRAP_S] = this.gl.CLAMP_TO_EDGE;\n    }\n\n    if (parameters[this.gl.TEXTURE_WRAP_T] === undefined) {\n      parameters[this.gl.TEXTURE_WRAP_T] = this.gl.CLAMP_TO_EDGE;\n    }\n  }\n\n  _getNPOTParam(pname, param) {\n    if (this._isNPOT()) {\n      switch (pname) {\n        case 10241:\n          if (NPOT_MIN_FILTERS.indexOf(param) === -1) {\n            param = 9729;\n          }\n\n          break;\n\n        case 10242:\n        case 10243:\n          if (param !== 33071) {\n            param = 33071;\n          }\n\n          break;\n\n        default:\n          break;\n      }\n    }\n\n    return param;\n  }\n\n}\n//# sourceMappingURL=texture.js.map","export function vec2_transformMat4AsVector(out, a, m) {\n  const x = a[0];\n  const y = a[1];\n  const w = m[3] * x + m[7] * y || 1.0;\n  out[0] = (m[0] * x + m[4] * y) / w;\n  out[1] = (m[1] * x + m[5] * y) / w;\n  return out;\n}\nexport function vec3_transformMat4AsVector(out, a, m) {\n  const x = a[0];\n  const y = a[1];\n  const z = a[2];\n  const w = m[3] * x + m[7] * y + m[11] * z || 1.0;\n  out[0] = (m[0] * x + m[4] * y + m[8] * z) / w;\n  out[1] = (m[1] * x + m[5] * y + m[9] * z) / w;\n  out[2] = (m[2] * x + m[6] * y + m[10] * z) / w;\n  return out;\n}\nexport function vec3_transformMat2(out, a, m) {\n  const x = a[0];\n  const y = a[1];\n  out[0] = m[0] * x + m[2] * y;\n  out[1] = m[1] * x + m[3] * y;\n  out[2] = a[2];\n  return out;\n}\nexport function vec4_transformMat2(out, a, m) {\n  const x = a[0];\n  const y = a[1];\n  out[0] = m[0] * x + m[2] * y;\n  out[1] = m[1] * x + m[3] * y;\n  out[2] = a[2];\n  out[3] = a[3];\n  return out;\n}\nexport function vec4_transformMat3(out, a, m) {\n  const x = a[0];\n  const y = a[1];\n  const z = a[2];\n  out[0] = m[0] * x + m[3] * y + m[6] * z;\n  out[1] = m[1] * x + m[4] * y + m[7] * z;\n  out[2] = m[2] * x + m[5] * y + m[8] * z;\n  out[3] = a[3];\n  return out;\n}\n//# sourceMappingURL=gl-matrix-extras.js.map","function _getPrototypeOf(o) {\n  module.exports = _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) {\n    return o.__proto__ || Object.getPrototypeOf(o);\n  }, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;\n  return _getPrototypeOf(o);\n}\nmodule.exports = _getPrototypeOf, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","import * as glMatrix from \"./common.js\";\n/**\n * 3x3 Matrix\n * @module mat3\n */\n\n/**\n * Creates a new identity mat3\n *\n * @returns {mat3} a new 3x3 matrix\n */\n\nexport function create() {\n  var out = new glMatrix.ARRAY_TYPE(9);\n\n  if (glMatrix.ARRAY_TYPE != Float32Array) {\n    out[1] = 0;\n    out[2] = 0;\n    out[3] = 0;\n    out[5] = 0;\n    out[6] = 0;\n    out[7] = 0;\n  }\n\n  out[0] = 1;\n  out[4] = 1;\n  out[8] = 1;\n  return out;\n}\n/**\n * Copies the upper-left 3x3 values into the given mat3.\n *\n * @param {mat3} out the receiving 3x3 matrix\n * @param {ReadonlyMat4} a   the source 4x4 matrix\n * @returns {mat3} out\n */\n\nexport function fromMat4(out, a) {\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  out[3] = a[4];\n  out[4] = a[5];\n  out[5] = a[6];\n  out[6] = a[8];\n  out[7] = a[9];\n  out[8] = a[10];\n  return out;\n}\n/**\n * Creates a new mat3 initialized with values from an existing matrix\n *\n * @param {ReadonlyMat3} a matrix to clone\n * @returns {mat3} a new 3x3 matrix\n */\n\nexport function clone(a) {\n  var out = new glMatrix.ARRAY_TYPE(9);\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  out[3] = a[3];\n  out[4] = a[4];\n  out[5] = a[5];\n  out[6] = a[6];\n  out[7] = a[7];\n  out[8] = a[8];\n  return out;\n}\n/**\n * Copy the values from one mat3 to another\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the source matrix\n * @returns {mat3} out\n */\n\nexport function copy(out, a) {\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  out[3] = a[3];\n  out[4] = a[4];\n  out[5] = a[5];\n  out[6] = a[6];\n  out[7] = a[7];\n  out[8] = a[8];\n  return out;\n}\n/**\n * Create a new mat3 with the given values\n *\n * @param {Number} m00 Component in column 0, row 0 position (index 0)\n * @param {Number} m01 Component in column 0, row 1 position (index 1)\n * @param {Number} m02 Component in column 0, row 2 position (index 2)\n * @param {Number} m10 Component in column 1, row 0 position (index 3)\n * @param {Number} m11 Component in column 1, row 1 position (index 4)\n * @param {Number} m12 Component in column 1, row 2 position (index 5)\n * @param {Number} m20 Component in column 2, row 0 position (index 6)\n * @param {Number} m21 Component in column 2, row 1 position (index 7)\n * @param {Number} m22 Component in column 2, row 2 position (index 8)\n * @returns {mat3} A new mat3\n */\n\nexport function fromValues(m00, m01, m02, m10, m11, m12, m20, m21, m22) {\n  var out = new glMatrix.ARRAY_TYPE(9);\n  out[0] = m00;\n  out[1] = m01;\n  out[2] = m02;\n  out[3] = m10;\n  out[4] = m11;\n  out[5] = m12;\n  out[6] = m20;\n  out[7] = m21;\n  out[8] = m22;\n  return out;\n}\n/**\n * Set the components of a mat3 to the given values\n *\n * @param {mat3} out the receiving matrix\n * @param {Number} m00 Component in column 0, row 0 position (index 0)\n * @param {Number} m01 Component in column 0, row 1 position (index 1)\n * @param {Number} m02 Component in column 0, row 2 position (index 2)\n * @param {Number} m10 Component in column 1, row 0 position (index 3)\n * @param {Number} m11 Component in column 1, row 1 position (index 4)\n * @param {Number} m12 Component in column 1, row 2 position (index 5)\n * @param {Number} m20 Component in column 2, row 0 position (index 6)\n * @param {Number} m21 Component in column 2, row 1 position (index 7)\n * @param {Number} m22 Component in column 2, row 2 position (index 8)\n * @returns {mat3} out\n */\n\nexport function set(out, m00, m01, m02, m10, m11, m12, m20, m21, m22) {\n  out[0] = m00;\n  out[1] = m01;\n  out[2] = m02;\n  out[3] = m10;\n  out[4] = m11;\n  out[5] = m12;\n  out[6] = m20;\n  out[7] = m21;\n  out[8] = m22;\n  return out;\n}\n/**\n * Set a mat3 to the identity matrix\n *\n * @param {mat3} out the receiving matrix\n * @returns {mat3} out\n */\n\nexport function identity(out) {\n  out[0] = 1;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 1;\n  out[5] = 0;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 1;\n  return out;\n}\n/**\n * Transpose the values of a mat3\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the source matrix\n * @returns {mat3} out\n */\n\nexport function transpose(out, a) {\n  // If we are transposing ourselves we can skip a few steps but have to cache some values\n  if (out === a) {\n    var a01 = a[1],\n        a02 = a[2],\n        a12 = a[5];\n    out[1] = a[3];\n    out[2] = a[6];\n    out[3] = a01;\n    out[5] = a[7];\n    out[6] = a02;\n    out[7] = a12;\n  } else {\n    out[0] = a[0];\n    out[1] = a[3];\n    out[2] = a[6];\n    out[3] = a[1];\n    out[4] = a[4];\n    out[5] = a[7];\n    out[6] = a[2];\n    out[7] = a[5];\n    out[8] = a[8];\n  }\n\n  return out;\n}\n/**\n * Inverts a mat3\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the source matrix\n * @returns {mat3} out\n */\n\nexport function invert(out, a) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2];\n  var a10 = a[3],\n      a11 = a[4],\n      a12 = a[5];\n  var a20 = a[6],\n      a21 = a[7],\n      a22 = a[8];\n  var b01 = a22 * a11 - a12 * a21;\n  var b11 = -a22 * a10 + a12 * a20;\n  var b21 = a21 * a10 - a11 * a20; // Calculate the determinant\n\n  var det = a00 * b01 + a01 * b11 + a02 * b21;\n\n  if (!det) {\n    return null;\n  }\n\n  det = 1.0 / det;\n  out[0] = b01 * det;\n  out[1] = (-a22 * a01 + a02 * a21) * det;\n  out[2] = (a12 * a01 - a02 * a11) * det;\n  out[3] = b11 * det;\n  out[4] = (a22 * a00 - a02 * a20) * det;\n  out[5] = (-a12 * a00 + a02 * a10) * det;\n  out[6] = b21 * det;\n  out[7] = (-a21 * a00 + a01 * a20) * det;\n  out[8] = (a11 * a00 - a01 * a10) * det;\n  return out;\n}\n/**\n * Calculates the adjugate of a mat3\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the source matrix\n * @returns {mat3} out\n */\n\nexport function adjoint(out, a) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2];\n  var a10 = a[3],\n      a11 = a[4],\n      a12 = a[5];\n  var a20 = a[6],\n      a21 = a[7],\n      a22 = a[8];\n  out[0] = a11 * a22 - a12 * a21;\n  out[1] = a02 * a21 - a01 * a22;\n  out[2] = a01 * a12 - a02 * a11;\n  out[3] = a12 * a20 - a10 * a22;\n  out[4] = a00 * a22 - a02 * a20;\n  out[5] = a02 * a10 - a00 * a12;\n  out[6] = a10 * a21 - a11 * a20;\n  out[7] = a01 * a20 - a00 * a21;\n  out[8] = a00 * a11 - a01 * a10;\n  return out;\n}\n/**\n * Calculates the determinant of a mat3\n *\n * @param {ReadonlyMat3} a the source matrix\n * @returns {Number} determinant of a\n */\n\nexport function determinant(a) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2];\n  var a10 = a[3],\n      a11 = a[4],\n      a12 = a[5];\n  var a20 = a[6],\n      a21 = a[7],\n      a22 = a[8];\n  return a00 * (a22 * a11 - a12 * a21) + a01 * (-a22 * a10 + a12 * a20) + a02 * (a21 * a10 - a11 * a20);\n}\n/**\n * Multiplies two mat3's\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the first operand\n * @param {ReadonlyMat3} b the second operand\n * @returns {mat3} out\n */\n\nexport function multiply(out, a, b) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2];\n  var a10 = a[3],\n      a11 = a[4],\n      a12 = a[5];\n  var a20 = a[6],\n      a21 = a[7],\n      a22 = a[8];\n  var b00 = b[0],\n      b01 = b[1],\n      b02 = b[2];\n  var b10 = b[3],\n      b11 = b[4],\n      b12 = b[5];\n  var b20 = b[6],\n      b21 = b[7],\n      b22 = b[8];\n  out[0] = b00 * a00 + b01 * a10 + b02 * a20;\n  out[1] = b00 * a01 + b01 * a11 + b02 * a21;\n  out[2] = b00 * a02 + b01 * a12 + b02 * a22;\n  out[3] = b10 * a00 + b11 * a10 + b12 * a20;\n  out[4] = b10 * a01 + b11 * a11 + b12 * a21;\n  out[5] = b10 * a02 + b11 * a12 + b12 * a22;\n  out[6] = b20 * a00 + b21 * a10 + b22 * a20;\n  out[7] = b20 * a01 + b21 * a11 + b22 * a21;\n  out[8] = b20 * a02 + b21 * a12 + b22 * a22;\n  return out;\n}\n/**\n * Translate a mat3 by the given vector\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the matrix to translate\n * @param {ReadonlyVec2} v vector to translate by\n * @returns {mat3} out\n */\n\nexport function translate(out, a, v) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2],\n      a10 = a[3],\n      a11 = a[4],\n      a12 = a[5],\n      a20 = a[6],\n      a21 = a[7],\n      a22 = a[8],\n      x = v[0],\n      y = v[1];\n  out[0] = a00;\n  out[1] = a01;\n  out[2] = a02;\n  out[3] = a10;\n  out[4] = a11;\n  out[5] = a12;\n  out[6] = x * a00 + y * a10 + a20;\n  out[7] = x * a01 + y * a11 + a21;\n  out[8] = x * a02 + y * a12 + a22;\n  return out;\n}\n/**\n * Rotates a mat3 by the given angle\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the matrix to rotate\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat3} out\n */\n\nexport function rotate(out, a, rad) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2],\n      a10 = a[3],\n      a11 = a[4],\n      a12 = a[5],\n      a20 = a[6],\n      a21 = a[7],\n      a22 = a[8],\n      s = Math.sin(rad),\n      c = Math.cos(rad);\n  out[0] = c * a00 + s * a10;\n  out[1] = c * a01 + s * a11;\n  out[2] = c * a02 + s * a12;\n  out[3] = c * a10 - s * a00;\n  out[4] = c * a11 - s * a01;\n  out[5] = c * a12 - s * a02;\n  out[6] = a20;\n  out[7] = a21;\n  out[8] = a22;\n  return out;\n}\n/**\n * Scales the mat3 by the dimensions in the given vec2\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the matrix to rotate\n * @param {ReadonlyVec2} v the vec2 to scale the matrix by\n * @returns {mat3} out\n **/\n\nexport function scale(out, a, v) {\n  var x = v[0],\n      y = v[1];\n  out[0] = x * a[0];\n  out[1] = x * a[1];\n  out[2] = x * a[2];\n  out[3] = y * a[3];\n  out[4] = y * a[4];\n  out[5] = y * a[5];\n  out[6] = a[6];\n  out[7] = a[7];\n  out[8] = a[8];\n  return out;\n}\n/**\n * Creates a matrix from a vector translation\n * This is equivalent to (but much faster than):\n *\n *     mat3.identity(dest);\n *     mat3.translate(dest, dest, vec);\n *\n * @param {mat3} out mat3 receiving operation result\n * @param {ReadonlyVec2} v Translation vector\n * @returns {mat3} out\n */\n\nexport function fromTranslation(out, v) {\n  out[0] = 1;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 1;\n  out[5] = 0;\n  out[6] = v[0];\n  out[7] = v[1];\n  out[8] = 1;\n  return out;\n}\n/**\n * Creates a matrix from a given angle\n * This is equivalent to (but much faster than):\n *\n *     mat3.identity(dest);\n *     mat3.rotate(dest, dest, rad);\n *\n * @param {mat3} out mat3 receiving operation result\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat3} out\n */\n\nexport function fromRotation(out, rad) {\n  var s = Math.sin(rad),\n      c = Math.cos(rad);\n  out[0] = c;\n  out[1] = s;\n  out[2] = 0;\n  out[3] = -s;\n  out[4] = c;\n  out[5] = 0;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 1;\n  return out;\n}\n/**\n * Creates a matrix from a vector scaling\n * This is equivalent to (but much faster than):\n *\n *     mat3.identity(dest);\n *     mat3.scale(dest, dest, vec);\n *\n * @param {mat3} out mat3 receiving operation result\n * @param {ReadonlyVec2} v Scaling vector\n * @returns {mat3} out\n */\n\nexport function fromScaling(out, v) {\n  out[0] = v[0];\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = v[1];\n  out[5] = 0;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 1;\n  return out;\n}\n/**\n * Copies the values from a mat2d into a mat3\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat2d} a the matrix to copy\n * @returns {mat3} out\n **/\n\nexport function fromMat2d(out, a) {\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = 0;\n  out[3] = a[2];\n  out[4] = a[3];\n  out[5] = 0;\n  out[6] = a[4];\n  out[7] = a[5];\n  out[8] = 1;\n  return out;\n}\n/**\n * Calculates a 3x3 matrix from the given quaternion\n *\n * @param {mat3} out mat3 receiving operation result\n * @param {ReadonlyQuat} q Quaternion to create matrix from\n *\n * @returns {mat3} out\n */\n\nexport function fromQuat(out, q) {\n  var x = q[0],\n      y = q[1],\n      z = q[2],\n      w = q[3];\n  var x2 = x + x;\n  var y2 = y + y;\n  var z2 = z + z;\n  var xx = x * x2;\n  var yx = y * x2;\n  var yy = y * y2;\n  var zx = z * x2;\n  var zy = z * y2;\n  var zz = z * z2;\n  var wx = w * x2;\n  var wy = w * y2;\n  var wz = w * z2;\n  out[0] = 1 - yy - zz;\n  out[3] = yx - wz;\n  out[6] = zx + wy;\n  out[1] = yx + wz;\n  out[4] = 1 - xx - zz;\n  out[7] = zy - wx;\n  out[2] = zx - wy;\n  out[5] = zy + wx;\n  out[8] = 1 - xx - yy;\n  return out;\n}\n/**\n * Calculates a 3x3 normal matrix (transpose inverse) from the 4x4 matrix\n *\n * @param {mat3} out mat3 receiving operation result\n * @param {ReadonlyMat4} a Mat4 to derive the normal matrix from\n *\n * @returns {mat3} out\n */\n\nexport function normalFromMat4(out, a) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2],\n      a03 = a[3];\n  var a10 = a[4],\n      a11 = a[5],\n      a12 = a[6],\n      a13 = a[7];\n  var a20 = a[8],\n      a21 = a[9],\n      a22 = a[10],\n      a23 = a[11];\n  var a30 = a[12],\n      a31 = a[13],\n      a32 = a[14],\n      a33 = a[15];\n  var b00 = a00 * a11 - a01 * a10;\n  var b01 = a00 * a12 - a02 * a10;\n  var b02 = a00 * a13 - a03 * a10;\n  var b03 = a01 * a12 - a02 * a11;\n  var b04 = a01 * a13 - a03 * a11;\n  var b05 = a02 * a13 - a03 * a12;\n  var b06 = a20 * a31 - a21 * a30;\n  var b07 = a20 * a32 - a22 * a30;\n  var b08 = a20 * a33 - a23 * a30;\n  var b09 = a21 * a32 - a22 * a31;\n  var b10 = a21 * a33 - a23 * a31;\n  var b11 = a22 * a33 - a23 * a32; // Calculate the determinant\n\n  var det = b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06;\n\n  if (!det) {\n    return null;\n  }\n\n  det = 1.0 / det;\n  out[0] = (a11 * b11 - a12 * b10 + a13 * b09) * det;\n  out[1] = (a12 * b08 - a10 * b11 - a13 * b07) * det;\n  out[2] = (a10 * b10 - a11 * b08 + a13 * b06) * det;\n  out[3] = (a02 * b10 - a01 * b11 - a03 * b09) * det;\n  out[4] = (a00 * b11 - a02 * b08 + a03 * b07) * det;\n  out[5] = (a01 * b08 - a00 * b10 - a03 * b06) * det;\n  out[6] = (a31 * b05 - a32 * b04 + a33 * b03) * det;\n  out[7] = (a32 * b02 - a30 * b05 - a33 * b01) * det;\n  out[8] = (a30 * b04 - a31 * b02 + a33 * b00) * det;\n  return out;\n}\n/**\n * Generates a 2D projection matrix with the given bounds\n *\n * @param {mat3} out mat3 frustum matrix will be written into\n * @param {number} width Width of your gl context\n * @param {number} height Height of gl context\n * @returns {mat3} out\n */\n\nexport function projection(out, width, height) {\n  out[0] = 2 / width;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = -2 / height;\n  out[5] = 0;\n  out[6] = -1;\n  out[7] = 1;\n  out[8] = 1;\n  return out;\n}\n/**\n * Returns a string representation of a mat3\n *\n * @param {ReadonlyMat3} a matrix to represent as a string\n * @returns {String} string representation of the matrix\n */\n\nexport function str(a) {\n  return \"mat3(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \", \" + a[3] + \", \" + a[4] + \", \" + a[5] + \", \" + a[6] + \", \" + a[7] + \", \" + a[8] + \")\";\n}\n/**\n * Returns Frobenius norm of a mat3\n *\n * @param {ReadonlyMat3} a the matrix to calculate Frobenius norm of\n * @returns {Number} Frobenius norm\n */\n\nexport function frob(a) {\n  return Math.hypot(a[0], a[1], a[2], a[3], a[4], a[5], a[6], a[7], a[8]);\n}\n/**\n * Adds two mat3's\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the first operand\n * @param {ReadonlyMat3} b the second operand\n * @returns {mat3} out\n */\n\nexport function add(out, a, b) {\n  out[0] = a[0] + b[0];\n  out[1] = a[1] + b[1];\n  out[2] = a[2] + b[2];\n  out[3] = a[3] + b[3];\n  out[4] = a[4] + b[4];\n  out[5] = a[5] + b[5];\n  out[6] = a[6] + b[6];\n  out[7] = a[7] + b[7];\n  out[8] = a[8] + b[8];\n  return out;\n}\n/**\n * Subtracts matrix b from matrix a\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the first operand\n * @param {ReadonlyMat3} b the second operand\n * @returns {mat3} out\n */\n\nexport function subtract(out, a, b) {\n  out[0] = a[0] - b[0];\n  out[1] = a[1] - b[1];\n  out[2] = a[2] - b[2];\n  out[3] = a[3] - b[3];\n  out[4] = a[4] - b[4];\n  out[5] = a[5] - b[5];\n  out[6] = a[6] - b[6];\n  out[7] = a[7] - b[7];\n  out[8] = a[8] - b[8];\n  return out;\n}\n/**\n * Multiply each element of the matrix by a scalar.\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the matrix to scale\n * @param {Number} b amount to scale the matrix's elements by\n * @returns {mat3} out\n */\n\nexport function multiplyScalar(out, a, b) {\n  out[0] = a[0] * b;\n  out[1] = a[1] * b;\n  out[2] = a[2] * b;\n  out[3] = a[3] * b;\n  out[4] = a[4] * b;\n  out[5] = a[5] * b;\n  out[6] = a[6] * b;\n  out[7] = a[7] * b;\n  out[8] = a[8] * b;\n  return out;\n}\n/**\n * Adds two mat3's after multiplying each element of the second operand by a scalar value.\n *\n * @param {mat3} out the receiving vector\n * @param {ReadonlyMat3} a the first operand\n * @param {ReadonlyMat3} b the second operand\n * @param {Number} scale the amount to scale b's elements by before adding\n * @returns {mat3} out\n */\n\nexport function multiplyScalarAndAdd(out, a, b, scale) {\n  out[0] = a[0] + b[0] * scale;\n  out[1] = a[1] + b[1] * scale;\n  out[2] = a[2] + b[2] * scale;\n  out[3] = a[3] + b[3] * scale;\n  out[4] = a[4] + b[4] * scale;\n  out[5] = a[5] + b[5] * scale;\n  out[6] = a[6] + b[6] * scale;\n  out[7] = a[7] + b[7] * scale;\n  out[8] = a[8] + b[8] * scale;\n  return out;\n}\n/**\n * Returns whether or not the matrices have exactly the same elements in the same position (when compared with ===)\n *\n * @param {ReadonlyMat3} a The first matrix.\n * @param {ReadonlyMat3} b The second matrix.\n * @returns {Boolean} True if the matrices are equal, false otherwise.\n */\n\nexport function exactEquals(a, b) {\n  return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3] && a[4] === b[4] && a[5] === b[5] && a[6] === b[6] && a[7] === b[7] && a[8] === b[8];\n}\n/**\n * Returns whether or not the matrices have approximately the same elements in the same position.\n *\n * @param {ReadonlyMat3} a The first matrix.\n * @param {ReadonlyMat3} b The second matrix.\n * @returns {Boolean} True if the matrices are equal, false otherwise.\n */\n\nexport function equals(a, b) {\n  var a0 = a[0],\n      a1 = a[1],\n      a2 = a[2],\n      a3 = a[3],\n      a4 = a[4],\n      a5 = a[5],\n      a6 = a[6],\n      a7 = a[7],\n      a8 = a[8];\n  var b0 = b[0],\n      b1 = b[1],\n      b2 = b[2],\n      b3 = b[3],\n      b4 = b[4],\n      b5 = b[5],\n      b6 = b[6],\n      b7 = b[7],\n      b8 = b[8];\n  return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3)) && Math.abs(a4 - b4) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a4), Math.abs(b4)) && Math.abs(a5 - b5) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a5), Math.abs(b5)) && Math.abs(a6 - b6) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a6), Math.abs(b6)) && Math.abs(a7 - b7) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a7), Math.abs(b7)) && Math.abs(a8 - b8) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a8), Math.abs(b8));\n}\n/**\n * Alias for {@link mat3.multiply}\n * @function\n */\n\nexport var mul = multiply;\n/**\n * Alias for {@link mat3.subtract}\n * @function\n */\n\nexport var sub = subtract;","// Copyright (c) 2015 Uber Technologies, Inc.\n\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n/* eslint-disable max-statements, complexity */\nimport TransitionManager, {TransitionProps} from './transition-manager';\nimport LinearInterpolator from '../transitions/linear-interpolator';\nimport {IViewState} from './view-state';\nimport {ConstructorOf} from '../types/types';\n\nimport type Viewport from '../viewports/viewport';\n\nimport type {EventManager, MjolnirEvent, MjolnirGestureEvent, MjolnirWheelEvent, MjolnirKeyEvent} from 'mjolnir.js';\nimport type {Timeline} from '@luma.gl/core';\n\nconst NO_TRANSITION_PROPS = {\n  transitionDuration: 0\n} as const;\n\nconst DEFAULT_INERTIA = 300;\nconst INERTIA_EASING = t => 1 - (1 - t) * (1 - t);\n\nconst EVENT_TYPES = {\n  WHEEL: ['wheel'],\n  PAN: ['panstart', 'panmove', 'panend'],\n  PINCH: ['pinchstart', 'pinchmove', 'pinchend'],\n  TRIPLE_PAN: ['tripanstart', 'tripanmove', 'tripanend'],\n  DOUBLE_TAP: ['doubletap'],\n  KEYBOARD: ['keydown']\n} as const;\n\n/** Configuration of how user input is handled */\nexport type ControllerOptions = {\n  /** Enable zooming with mouse wheel. Default `true`. */\n  scrollZoom?: boolean | {\n    /** Scaler that translates wheel delta to the change of viewport scale. Default `0.01`. */\n    speed?: number;\n    /** Smoothly transition to the new zoom. If enabled, will provide a slightly lagged but smoother experience. Default `false`. */\n    smooth?: boolean\n  };\n  /** Enable panning with pointer drag. Default `true` */\n  dragPan?: boolean;\n  /** Enable rotating with pointer drag. Default `true` */\n  dragRotate?: boolean;\n  /** Enable zooming with double click. Default `true` */\n  doubleClickZoom?: boolean;\n  /** Enable zooming with multi-touch. Default `true` */\n  touchZoom?: boolean;\n  /** Enable rotating with multi-touch. Use two-finger rotating gesture for horizontal and three-finger swiping gesture for vertical rotation. Default `false` */\n  touchRotate?: boolean;\n  /** Enable interaction with keyboard. Default `true`. */\n  keyboard?:\n    | boolean\n    | {\n        /** Speed of zoom using +/- keys. Default `2` */\n        zoomSpeed?: number;\n        /** Speed of movement using arrow keys, in pixels. */\n        moveSpeed?: number;\n        /** Speed of rotation using shift + left/right arrow keys, in degrees. Default 15. */\n        rotateSpeedX?: number;\n        /** Speed of rotation using shift + up/down arrow keys, in degrees. Default 10. */\n        rotateSpeedY?: number;\n      };\n  /** Drag behavior without pressing function keys, one of `pan` and `rotate`. */\n  dragMode?: 'pan' | 'rotate';\n  /** Enable inertia after panning/pinching. If a number is provided, indicates the duration of time over which the velocity reduces to zero, in milliseconds. Default `false`. */\n  inertia?: boolean | number;\n};\n\nexport type ControllerProps = {\n  /** Identifier of the controller */\n  id: string;\n  /** Viewport x position */\n  x: number;\n  /** Viewport y position */\n  y: number;\n  /** Viewport width */\n  width: number;\n  /** Viewport height */\n  height: number;\n} & ControllerOptions & TransitionProps;\n\n/** The state of a controller */\nexport type InteractionState = {\n  /** If the view state is in transition */\n  inTransition?: boolean;\n  /** If the user is dragging */\n  isDragging?: boolean;\n  /** If the view is being panned, either from user input or transition */\n  isPanning?: boolean;\n  /** If the view is being rotated, either from user input or transition */\n  isRotating?: boolean;\n  /** If the view is being zoomed, either from user input or transition */\n  isZooming?: boolean;\n}\n\n/** Parameters passed to the onViewStateChange callback */\nexport type ViewStateChangeParameters = {\n  /** The next view state, either from user input or transition */\n  viewState: Record<string, any>;\n  /** Object describing the nature of the view state change */\n  interactionState: InteractionState;\n  /** The current view state */\n  oldViewState?: Record<string, any>;\n}\n\nconst pinchEventWorkaround: any = {};\n\nexport default abstract class Controller<ControllerState extends IViewState<ControllerState>> {\n  abstract get ControllerState(): ConstructorOf<ControllerState>;\n  abstract get transition(): TransitionProps;\n\n  // @ts-expect-error (2564) - not assigned in the constructor\n  protected props: ControllerProps;\n  protected state: Record<string, any> = {};\n\n  protected transitionManager: TransitionManager<ControllerState>;\n  protected eventManager: EventManager;\n  protected onViewStateChange: (params: ViewStateChangeParameters) => void;\n  protected onStateChange: (state: InteractionState) => void;\n  protected makeViewport: (opts: Record<string, any>) => Viewport\n\n  private _controllerState?: ControllerState;\n  private _events: Record<string, boolean> = {};\n  private _interactionState: InteractionState = {\n    isDragging: false\n  };\n  private _customEvents: string[] = [];\n  private _eventStartBlocked: any = null;\n  private _panMove: boolean = false;\n\n  protected invertPan: boolean = false;\n  protected dragMode: 'pan' | 'rotate' = 'rotate';\n  protected inertia: number = 0;\n  protected scrollZoom: boolean | {speed?: number; smooth?: boolean} = true;\n  protected dragPan: boolean = true;\n  protected dragRotate: boolean = true;\n  protected doubleClickZoom: boolean = true;\n  protected touchZoom: boolean = true;\n  protected touchRotate: boolean = false;\n  protected keyboard:\n    | boolean\n    | {\n        zoomSpeed?: number; //  speed of zoom using +/- keys. Default 2.\n        moveSpeed?: number; //  speed of movement using arrow keys, in pixels.\n        rotateSpeedX?: number; //  speed of rotation using shift + left/right arrow keys, in degrees. Default 15.\n        rotateSpeedY?: number; //  speed of rotation using shift + up/down arrow keys, in degrees. Default 10.\n      } = true;\n\n  constructor(opts: {\n    timeline: Timeline,\n    eventManager: EventManager;\n    makeViewport: (opts: Record<string, any>) => Viewport;\n    onViewStateChange: (params: ViewStateChangeParameters) => void;\n    onStateChange: (state: InteractionState) => void;\n  }) {\n    this.transitionManager = new TransitionManager<ControllerState>({\n      ...opts,\n      getControllerState: props => new this.ControllerState(props),\n      onViewStateChange: this._onTransition.bind(this),\n      onStateChange: this._setInteractionState.bind(this)\n    });\n\n    this.handleEvent = this.handleEvent.bind(this);\n\n    this.eventManager = opts.eventManager;\n    this.onViewStateChange = opts.onViewStateChange || (() => {});\n    this.onStateChange = opts.onStateChange || (() => {});\n    this.makeViewport = opts.makeViewport;\n  }\n\n  set events(customEvents) {\n    this.toggleEvents(this._customEvents, false);\n    this.toggleEvents(customEvents, true);\n    this._customEvents = customEvents;\n    // Make sure default events are not overwritten\n    if (this.props) {\n      this.setProps(this.props);\n    }\n  }\n\n  finalize() {\n    for (const eventName in this._events) {\n      if (this._events[eventName]) {\n        // @ts-ignore (2345) event type string cannot be assifned to enum\n        // eslint-disable-next-line @typescript-eslint/unbound-method\n        this.eventManager?.off(eventName, this.handleEvent);\n      }\n    }\n    this.transitionManager.finalize();\n  }\n\n  /**\n   * Callback for events\n   */\n  handleEvent(event: MjolnirEvent) {\n    // Force recalculate controller state\n    this._controllerState = undefined;\n    const eventStartBlocked = this._eventStartBlocked;\n\n    switch (event.type) {\n      case 'panstart':\n        return eventStartBlocked ? false : this._onPanStart(event);\n      case 'panmove':\n        return this._onPan(event);\n      case 'panend':\n        return this._onPanEnd(event);\n      case 'pinchstart':\n        return eventStartBlocked ? false : this._onPinchStart(event);\n      case 'pinchmove':\n        return this._onPinch(event);\n      case 'pinchend':\n        return this._onPinchEnd(event);\n      case 'tripanstart':\n        return eventStartBlocked ? false : this._onTriplePanStart(event);\n      case 'tripanmove':\n        return this._onTriplePan(event);\n      case 'tripanend':\n        return this._onTriplePanEnd(event);\n      case 'doubletap':\n        return this._onDoubleTap(event);\n      case 'wheel':\n        return this._onWheel(event);\n      case 'keydown':\n        return this._onKeyDown(event);\n      default:\n        return false;\n    }\n  }\n\n  /* Event utils */\n  // Event object: http://hammerjs.github.io/api/#event-object\n  get controllerState(): ControllerState {\n    this._controllerState = this._controllerState || new this.ControllerState({\n      makeViewport: this.makeViewport,\n      ...this.props,\n      ...this.state\n    });\n    return this._controllerState ;\n  }\n\n  getCenter(event: MjolnirGestureEvent | MjolnirWheelEvent) : [number, number] {\n    const {x, y} = this.props;\n    const {offsetCenter} = event;\n    return [offsetCenter.x - x, offsetCenter.y - y];\n  }\n\n  isPointInBounds(pos: [number, number], event: MjolnirEvent): boolean {\n    const {width, height} = this.props;\n    if (event && event.handled) {\n      return false;\n    }\n\n    const inside = pos[0] >= 0 && pos[0] <= width && pos[1] >= 0 && pos[1] <= height;\n    if (inside && event) {\n      event.stopPropagation();\n    }\n    return inside;\n  }\n\n  isFunctionKeyPressed(event: MjolnirEvent): boolean {\n    const {srcEvent} = event;\n    return Boolean(srcEvent.metaKey || srcEvent.altKey || srcEvent.ctrlKey || srcEvent.shiftKey);\n  }\n\n  isDragging(): boolean {\n    return this._interactionState.isDragging || false;\n  }\n\n  // When a multi-touch event ends, e.g. pinch, not all pointers are lifted at the same time.\n  // This triggers a brief `pan` event.\n  // Calling this method will temporarily disable *start events to avoid conflicting transitions.\n  blockEvents(timeout: number): void {\n    /* global setTimeout */\n    const timer = setTimeout(() => {\n      if (this._eventStartBlocked === timer) {\n        this._eventStartBlocked = null;\n      }\n    }, timeout);\n    this._eventStartBlocked = timer;\n  }\n\n  /**\n   * Extract interactivity options\n   */\n  setProps(props: ControllerProps) {\n    if (props.dragMode) {\n      this.dragMode = props.dragMode;\n    }\n    this.props = props;\n\n    if (!('transitionInterpolator' in props)) {\n      // Add default transition interpolator\n      props.transitionInterpolator = this._getTransitionProps().transitionInterpolator;\n    }\n\n    this.transitionManager.processViewStateChange(props);\n\n    const {inertia} = props;\n    this.inertia = Number.isFinite(inertia) ? (inertia as number) : (inertia === true ? DEFAULT_INERTIA : 0);\n\n    // TODO - make sure these are not reset on every setProps\n    const {\n      scrollZoom = true,\n      dragPan = true,\n      dragRotate = true,\n      doubleClickZoom = true,\n      touchZoom = true,\n      touchRotate = false,\n      keyboard = true\n    } = props;\n\n    // Register/unregister events\n    const isInteractive = Boolean(this.onViewStateChange);\n    this.toggleEvents(EVENT_TYPES.WHEEL, isInteractive && scrollZoom);\n    this.toggleEvents(EVENT_TYPES.PAN, isInteractive && (dragPan || dragRotate));\n    this.toggleEvents(EVENT_TYPES.PINCH, isInteractive && (touchZoom || touchRotate));\n    this.toggleEvents(EVENT_TYPES.TRIPLE_PAN, isInteractive && touchRotate);\n    this.toggleEvents(EVENT_TYPES.DOUBLE_TAP, isInteractive && doubleClickZoom);\n    this.toggleEvents(EVENT_TYPES.KEYBOARD, isInteractive && keyboard);\n\n    // Interaction toggles\n    this.scrollZoom = scrollZoom;\n    this.dragPan = dragPan;\n    this.dragRotate = dragRotate;\n    this.doubleClickZoom = doubleClickZoom;\n    this.touchZoom = touchZoom;\n    this.touchRotate = touchRotate;\n    this.keyboard = keyboard;\n  }\n\n  updateTransition() {\n    this.transitionManager.updateTransition();\n  }\n\n  toggleEvents(eventNames, enabled) {\n    if (this.eventManager) {\n      eventNames.forEach(eventName => {\n        if (this._events[eventName] !== enabled) {\n          this._events[eventName] = enabled;\n          if (enabled) {\n            // eslint-disable-next-line @typescript-eslint/unbound-method\n            this.eventManager.on(eventName, this.handleEvent);\n          } else {\n            // eslint-disable-next-line @typescript-eslint/unbound-method\n            this.eventManager.off(eventName, this.handleEvent);\n          }\n        }\n      });\n    }\n  }\n\n  // Private Methods\n\n  /* Callback util */\n  // formats map state and invokes callback function\n  protected updateViewport(newControllerState: ControllerState, extraProps: Record<string, any> | null = null, interactionState: InteractionState = {}) {\n    const viewState = {...newControllerState.getViewportProps(), ...extraProps};\n\n    // TODO - to restore diffing, we need to include interactionState\n    const changed = this.controllerState !== newControllerState;\n    // const oldViewState = this.controllerState.getViewportProps();\n    // const changed = Object.keys(viewState).some(key => oldViewState[key] !== viewState[key]);\n\n    this.state = newControllerState.getState();\n    this._setInteractionState(interactionState);\n\n    if (changed) {\n      const oldViewState = this.controllerState && this.controllerState.getViewportProps();\n      if (this.onViewStateChange) {\n        this.onViewStateChange({viewState, interactionState: this._interactionState, oldViewState});\n      }\n    }\n  }\n\n  private _onTransition(params: {viewState: Record<string, any>, oldViewState: Record<string, any>}) {\n    this.onViewStateChange({...params, interactionState: this._interactionState});\n  }\n\n  private _setInteractionState(newStates: InteractionState) {\n    Object.assign(this._interactionState, newStates);\n    this.onStateChange(this._interactionState);\n  }\n\n  /* Event handlers */\n  // Default handler for the `panstart` event.\n  protected _onPanStart(event: MjolnirGestureEvent): boolean {\n    const pos = this.getCenter(event);\n    if (!this.isPointInBounds(pos, event)) {\n      return false;\n    }\n    let alternateMode = this.isFunctionKeyPressed(event) || event.rightButton || false;\n    if (this.invertPan || this.dragMode === 'pan') {\n      // invertPan is replaced by props.dragMode, keeping for backward compatibility\n      alternateMode = !alternateMode;\n    }\n    const newControllerState = this.controllerState[alternateMode ? 'panStart' : 'rotateStart']({\n      pos\n    });\n    this._panMove = alternateMode;\n    this.updateViewport(newControllerState, NO_TRANSITION_PROPS, {isDragging: true});\n    return true;\n  }\n\n  // Default handler for the `panmove` and `panend` event.\n  protected _onPan(event: MjolnirGestureEvent): boolean {\n    if (!this.isDragging()) {\n      return false;\n    }\n    return this._panMove ? this._onPanMove(event) : this._onPanRotate(event);\n  }\n\n  protected _onPanEnd(event: MjolnirGestureEvent): boolean {\n    if (!this.isDragging()) {\n      return false;\n    }\n    return this._panMove ? this._onPanMoveEnd(event) : this._onPanRotateEnd(event);\n  }\n\n  // Default handler for panning to move.\n  // Called by `_onPan` when panning without function key pressed.\n  protected _onPanMove(event: MjolnirGestureEvent): boolean {\n    if (!this.dragPan) {\n      return false;\n    }\n    const pos = this.getCenter(event);\n    const newControllerState = this.controllerState.pan({pos});\n    this.updateViewport(newControllerState, NO_TRANSITION_PROPS, {\n      isDragging: true,\n      isPanning: true\n    });\n    return true;\n  }\n\n  protected _onPanMoveEnd(event: MjolnirGestureEvent): boolean {\n    const {inertia} = this;\n    if (this.dragPan && inertia && event.velocity) {\n      const pos = this.getCenter(event);\n      const endPos: [number, number] = [\n        pos[0] + (event.velocityX * inertia) / 2,\n        pos[1] + (event.velocityY * inertia) / 2\n      ];\n      const newControllerState = this.controllerState.pan({pos: endPos}).panEnd();\n      this.updateViewport(\n        newControllerState,\n        {\n          ...this._getTransitionProps(),\n          transitionDuration: inertia,\n          transitionEasing: INERTIA_EASING\n        },\n        {\n          isDragging: false,\n          isPanning: true\n        }\n      );\n    } else {\n      const newControllerState = this.controllerState.panEnd();\n      this.updateViewport(newControllerState, null, {\n        isDragging: false,\n        isPanning: false\n      });\n    }\n    return true;\n  }\n\n  // Default handler for panning to rotate.\n  // Called by `_onPan` when panning with function key pressed.\n  protected _onPanRotate(event: MjolnirGestureEvent): boolean {\n    if (!this.dragRotate) {\n      return false;\n    }\n\n    const pos = this.getCenter(event);\n    const newControllerState = this.controllerState.rotate({pos});\n    this.updateViewport(newControllerState, NO_TRANSITION_PROPS, {\n      isDragging: true,\n      isRotating: true\n    });\n    return true;\n  }\n\n  protected _onPanRotateEnd(event): boolean {\n    const {inertia} = this;\n    if (this.dragRotate && inertia && event.velocity) {\n      const pos = this.getCenter(event);\n      const endPos: [number, number] = [\n        pos[0] + (event.velocityX * inertia) / 2,\n        pos[1] + (event.velocityY * inertia) / 2\n      ];\n      const newControllerState = this.controllerState.rotate({pos: endPos}).rotateEnd();\n      this.updateViewport(\n        newControllerState,\n        {\n          ...this._getTransitionProps(),\n          transitionDuration: inertia,\n          transitionEasing: INERTIA_EASING\n        },\n        {\n          isDragging: false,\n          isRotating: true\n        }\n      );\n    } else {\n      const newControllerState = this.controllerState.rotateEnd();\n      this.updateViewport(newControllerState, null, {\n        isDragging: false,\n        isRotating: false\n      });\n    }\n    return true;\n  }\n\n  // Default handler for the `wheel` event.\n  protected _onWheel(event: MjolnirWheelEvent): boolean {\n    if (!this.scrollZoom) {\n      return false;\n    }\n    event.srcEvent.preventDefault();\n\n    const pos = this.getCenter(event);\n    if (!this.isPointInBounds(pos, event)) {\n      return false;\n    }\n\n    const {speed = 0.01, smooth = false} = this.scrollZoom === true ? {} : this.scrollZoom;\n    const {delta} = event;\n\n    // Map wheel delta to relative scale\n    let scale = 2 / (1 + Math.exp(-Math.abs(delta * speed)));\n    if (delta < 0 && scale !== 0) {\n      scale = 1 / scale;\n    }\n\n    const newControllerState = this.controllerState.zoom({pos, scale});\n    this.updateViewport(\n      newControllerState,\n      {...this._getTransitionProps({around: pos}), transitionDuration: smooth ? 250 : 1},\n      {\n        isZooming: true,\n        isPanning: true\n      }\n    );\n    return true;\n  }\n\n  protected _onTriplePanStart(event: MjolnirGestureEvent): boolean {\n    const pos = this.getCenter(event);\n    if (!this.isPointInBounds(pos, event)) {\n      return false;\n    }\n    const newControllerState = this.controllerState.rotateStart({pos});\n    this.updateViewport(newControllerState, NO_TRANSITION_PROPS, {isDragging: true});\n    return true;\n  }\n\n  protected _onTriplePan(event: MjolnirGestureEvent): boolean {\n    if (!this.touchRotate) {\n      return false;\n    }\n    if (!this.isDragging()) {\n      return false;\n    }\n\n    const pos = this.getCenter(event);\n    pos[0] -= event.deltaX;\n\n    const newControllerState = this.controllerState.rotate({pos});\n    this.updateViewport(newControllerState, NO_TRANSITION_PROPS, {\n      isDragging: true,\n      isRotating: true\n    });\n    return true;\n  }\n\n  protected _onTriplePanEnd(event: MjolnirGestureEvent): boolean {\n    if (!this.isDragging()) {\n      return false;\n    }\n    const {inertia} = this;\n    if (this.touchRotate && inertia && event.velocityY) {\n      const pos = this.getCenter(event);\n      const endPos: [number, number] = [pos[0], (pos[1] += (event.velocityY * inertia) / 2)];\n      const newControllerState = this.controllerState.rotate({pos: endPos});\n      this.updateViewport(\n        newControllerState,\n        {\n          ...this._getTransitionProps(),\n          transitionDuration: inertia,\n          transitionEasing: INERTIA_EASING\n        },\n        {\n          isDragging: false,\n          isRotating: true\n        }\n      );\n      this.blockEvents(inertia);\n    } else {\n      const newControllerState = this.controllerState.rotateEnd();\n      this.updateViewport(newControllerState, null, {\n        isDragging: false,\n        isRotating: false\n      });\n    }\n    return true;\n  }\n\n  // Default handler for the `pinchstart` event.\n  protected _onPinchStart(event: MjolnirGestureEvent): boolean {\n    const pos = this.getCenter(event);\n    if (!this.isPointInBounds(pos, event)) {\n      return false;\n    }\n\n    const newControllerState = this.controllerState.zoomStart({pos}).rotateStart({pos});\n    // hack - hammer's `rotation` field doesn't seem to produce the correct angle\n    pinchEventWorkaround._startPinchRotation = event.rotation;\n    pinchEventWorkaround._lastPinchEvent = event;\n    this.updateViewport(newControllerState, NO_TRANSITION_PROPS, {isDragging: true});\n    return true;\n  }\n\n  // Default handler for the `pinchmove` and `pinchend` events.\n  protected _onPinch(event: MjolnirGestureEvent): boolean {\n    if (!this.touchZoom && !this.touchRotate) {\n      return false;\n    }\n    if (!this.isDragging()) {\n      return false;\n    }\n\n    let newControllerState = this.controllerState;\n    if (this.touchZoom) {\n      const {scale} = event;\n      const pos = this.getCenter(event);\n      newControllerState = newControllerState.zoom({pos, scale});\n    }\n    if (this.touchRotate) {\n      const {rotation} = event;\n      newControllerState = newControllerState.rotate({\n        deltaAngleX: pinchEventWorkaround._startPinchRotation - rotation\n      });\n    }\n\n    this.updateViewport(newControllerState, NO_TRANSITION_PROPS, {\n      isDragging: true,\n      isPanning: this.touchZoom,\n      isZooming: this.touchZoom,\n      isRotating: this.touchRotate\n    });\n    pinchEventWorkaround._lastPinchEvent = event;\n    return true;\n  }\n\n  protected _onPinchEnd(event: MjolnirGestureEvent): boolean {\n    if (!this.isDragging()) {\n      return false;\n    }\n    const {inertia} = this;\n    const {_lastPinchEvent} = pinchEventWorkaround;\n    if (this.touchZoom && inertia && _lastPinchEvent && event.scale !== _lastPinchEvent.scale) {\n      const pos = this.getCenter(event);\n      let newControllerState = this.controllerState.rotateEnd();\n      const z = Math.log2(event.scale);\n      const velocityZ =\n        (z - Math.log2(_lastPinchEvent.scale)) / (event.deltaTime - _lastPinchEvent.deltaTime);\n      const endScale = Math.pow(2, z + (velocityZ * inertia) / 2);\n      newControllerState = newControllerState.zoom({pos, scale: endScale}).zoomEnd();\n\n      this.updateViewport(\n        newControllerState,\n        {\n          ...this._getTransitionProps({around: pos}),\n          transitionDuration: inertia,\n          transitionEasing: INERTIA_EASING\n        },\n        {\n          isDragging: false,\n          isPanning: this.touchZoom,\n          isZooming: this.touchZoom,\n          isRotating: false\n        }\n      );\n      this.blockEvents(inertia);\n    } else {\n      const newControllerState = this.controllerState.zoomEnd().rotateEnd();\n      this.updateViewport(newControllerState, null, {\n        isDragging: false,\n        isPanning: false,\n        isZooming: false,\n        isRotating: false\n      });\n    }\n    pinchEventWorkaround._startPinchRotation = null;\n    pinchEventWorkaround._lastPinchEvent = null;\n    return true;\n  }\n\n  // Default handler for the `doubletap` event.\n  protected _onDoubleTap(event: MjolnirGestureEvent): boolean {\n    if (!this.doubleClickZoom) {\n      return false;\n    }\n    const pos = this.getCenter(event);\n    if (!this.isPointInBounds(pos, event)) {\n      return false;\n    }\n\n    const isZoomOut = this.isFunctionKeyPressed(event);\n\n    const newControllerState = this.controllerState.zoom({pos, scale: isZoomOut ? 0.5 : 2});\n    this.updateViewport(newControllerState, this._getTransitionProps({around: pos}), {\n      isZooming: true,\n      isPanning: true\n    });\n    this.blockEvents(100);\n    return true;\n  }\n\n  // Default handler for the `keydown` event\n  protected _onKeyDown(event: MjolnirKeyEvent): boolean {\n    if (!this.keyboard) {\n      return false;\n    }\n    const funcKey = this.isFunctionKeyPressed(event);\n    // @ts-ignore\n    const {zoomSpeed, moveSpeed, rotateSpeedX, rotateSpeedY} = this.keyboard === true ? {} : this.keyboard;\n    const {controllerState} = this;\n    let newControllerState;\n    const interactionState: InteractionState = {};\n\n    switch (event.srcEvent.code) {\n      case 'Minus':\n        newControllerState = funcKey\n          ? controllerState.zoomOut(zoomSpeed).zoomOut(zoomSpeed)\n          : controllerState.zoomOut(zoomSpeed);\n        interactionState.isZooming = true;\n        break;\n      case 'Equal':\n        newControllerState = funcKey\n          ? controllerState.zoomIn(zoomSpeed).zoomIn(zoomSpeed)\n          : controllerState.zoomIn(zoomSpeed);\n        interactionState.isZooming = true;\n        break;\n      case 'ArrowLeft':\n        if (funcKey) {\n          newControllerState = controllerState.rotateLeft(rotateSpeedX);\n          interactionState.isRotating = true;\n        } else {\n          newControllerState = controllerState.moveLeft(moveSpeed);\n          interactionState.isPanning = true;\n        }\n        break;\n      case 'ArrowRight':\n        if (funcKey) {\n          newControllerState = controllerState.rotateRight(rotateSpeedX);\n          interactionState.isRotating = true;\n        } else {\n          newControllerState = controllerState.moveRight(moveSpeed);\n          interactionState.isPanning = true;\n        }\n        break;\n      case 'ArrowUp':\n        if (funcKey) {\n          newControllerState = controllerState.rotateUp(rotateSpeedY);\n          interactionState.isRotating = true;\n        } else {\n          newControllerState = controllerState.moveUp(moveSpeed);\n          interactionState.isPanning = true;\n        }\n        break;\n      case 'ArrowDown':\n        if (funcKey) {\n          newControllerState = controllerState.rotateDown(rotateSpeedY);\n          interactionState.isRotating = true;\n        } else {\n          newControllerState = controllerState.moveDown(moveSpeed);\n          interactionState.isPanning = true;\n        }\n        break;\n      default:\n        return false;\n    }\n    this.updateViewport(newControllerState, this._getTransitionProps(), interactionState);\n    return true;\n  }\n\n  protected _getTransitionProps(opts?: any): TransitionProps {\n    const {transition} = this;\n\n    if (!transition || !transition.transitionInterpolator) {\n      return NO_TRANSITION_PROPS;\n    }\n\n    // Enables Transitions on double-tap and key-down events.\n    return opts\n      ? {\n        ...transition,\n        transitionInterpolator: new LinearInterpolator({\n          ...opts,\n          ...(transition.transitionInterpolator as LinearInterpolator).opts,\n          makeViewport: this.controllerState.makeViewport\n        })\n      }\n      : transition;\n  }\n}\n","const PERCENT_OR_PIXELS_REGEX = /([0-9]+\\.?[0-9]*)(%|px)/;\n\nexport type Position = {\n  position: number;\n  relative: boolean;\n};\n\n// Takes a number or a string of formats `50%`, `33.3%` or `200px`\nexport function parsePosition(value: number | string): Position {\n  switch (typeof value) {\n    case 'number':\n      return {\n        position: value,\n        relative: false\n      };\n\n    case 'string':\n      const match = PERCENT_OR_PIXELS_REGEX.exec(value);\n      if (match && match.length >= 3) {\n        const relative = match[2] === '%';\n        const position = parseFloat(match[1]);\n        return {\n          position: relative ? position / 100 : position,\n          relative\n        };\n      }\n    // fallthrough\n\n    default:\n      // eslint-disable-line\n      throw new Error(`Could not parse position string ${value}`);\n  }\n}\n\nexport function getPosition(position: Position, extent: number): number {\n  return position.relative ? Math.round(position.position * extent) : position.position;\n}\n","import Viewport from '../viewports/viewport';\nimport {parsePosition, getPosition, Position} from '../utils/positions';\nimport {deepEqual} from '../utils/deep-equal';\nimport assert from '../utils/assert';\nimport type Controller from '../controllers/controller';\nimport type {ControllerOptions} from '../controllers/controller';\nimport type {TransitionProps} from '../controllers/transition-manager';\nimport type {Padding} from '../viewports/viewport';\nimport type {ConstructorOf} from '../types/types';\n\nexport type CommonViewState = TransitionProps;\n\ntype CommonViewProps<ViewState> = {\n  /** A unique id of the view. In a multi-view use case, this is important for matching view states and place contents into this view. */\n  id?: string;\n  /** A relative (e.g. `'50%'`) or absolute position. Default `0`. */\n  x?: number | string;\n  /** A relative (e.g. `'50%'`) or absolute position. Default `0`. */\n  y?: number | string;\n  /** A relative (e.g. `'50%'`) or absolute extent. Default `'100%'`. */\n  width?: number | string;\n  /** A relative (e.g. `'50%'`) or absolute extent. Default `'100%'`. */\n  height?: number | string;\n  /** Padding around the view, expressed in either relative (e.g. `'50%'`) or absolute pixels. Default `null`. */\n  padding?: {\n    left?: number | string;\n    right?: number | string;\n    top?: number | string;\n    bottom?: number | string;\n  } | null;\n  /** State of the view */\n  viewState?:\n    | string\n    | ({\n        id?: string;\n      } & Partial<ViewState>);\n  /** Options for viewport interactivity. */\n  controller?:\n    | null\n    | boolean\n    | ConstructorOf<Controller<any>>\n    | (ControllerOptions & {\n        type?: ConstructorOf<Controller<any>>;\n      });\n\n  /** @deprecated Directly wrap a viewport instance */\n  viewportInstance?: Viewport;\n};\n\nexport default abstract class View<\n  ViewState extends CommonViewState = CommonViewState,\n  ViewProps = {}\n> {\n  id: string;\n  abstract get ViewportType(): ConstructorOf<Viewport>;\n  abstract get ControllerType(): ConstructorOf<Controller<any>>;\n\n  private viewportInstance?: Viewport;\n  private _x: Position;\n  private _y: Position;\n  private _width: Position;\n  private _height: Position;\n  private _padding: {\n    left: Position;\n    right: Position;\n    top: Position;\n    bottom: Position;\n  } | null;\n\n  readonly props: ViewProps & CommonViewProps<ViewState>;\n\n  constructor(props: ViewProps & CommonViewProps<ViewState>) {\n    const {\n      id,\n      x = 0,\n      y = 0,\n      width = '100%',\n      height = '100%',\n      padding = null,\n      viewportInstance\n    } = props || {};\n\n    assert(!viewportInstance || viewportInstance instanceof Viewport);\n    this.viewportInstance = viewportInstance;\n\n    // @ts-ignore\n    this.id = id || this.constructor.displayName || 'view';\n\n    this.props = {...props, id: this.id};\n\n    // Extents\n    this._x = parsePosition(x);\n    this._y = parsePosition(y);\n    this._width = parsePosition(width);\n    this._height = parsePosition(height);\n    this._padding = padding && {\n      left: parsePosition(padding.left || 0),\n      right: parsePosition(padding.right || 0),\n      top: parsePosition(padding.top || 0),\n      bottom: parsePosition(padding.bottom || 0)\n    };\n\n    // Bind methods for easy access\n    this.equals = this.equals.bind(this);\n\n    Object.seal(this);\n  }\n\n  equals(view: View<ViewState, ViewProps>): boolean {\n    if (this === view) {\n      return true;\n    }\n\n    // if `viewportInstance` is set, it is the only prop that is used\n    // Delegate to `Viewport.equals`\n    if (this.viewportInstance) {\n      return view.viewportInstance ? this.viewportInstance.equals(view.viewportInstance) : false;\n    }\n\n    return this.ViewportType === view.ViewportType && deepEqual(this.props, view.props);\n  }\n\n  /** Make viewport from canvas dimensions and view state */\n  makeViewport({width, height, viewState}: {width: number; height: number; viewState: any}) {\n    if (this.viewportInstance) {\n      return this.viewportInstance;\n    }\n\n    viewState = this.filterViewState(viewState);\n\n    // Resolve relative viewport dimensions\n    const viewportDimensions = this.getDimensions({width, height});\n    return new this.ViewportType({...viewState, ...this.props, ...viewportDimensions});\n  }\n\n  getViewStateId(): string {\n    const {viewState} = this.props;\n    if (typeof viewState === 'string') {\n      // if View.viewState is a string, return it\n      return viewState;\n    }\n    return viewState?.id || this.id;\n  }\n\n  // Allows view to override (or completely define) viewState\n  filterViewState(viewState: ViewState): ViewState {\n    if (this.props.viewState && typeof this.props.viewState === 'object') {\n      // If we have specified an id, then intent is to override,\n      // If not, completely specify the view state\n      if (!this.props.viewState.id) {\n        return this.props.viewState as ViewState;\n      }\n\n      // Merge in all props from View's viewState, except id\n      const newViewState = {...viewState};\n      for (const key in this.props.viewState) {\n        if (key !== 'id') {\n          newViewState[key] = this.props.viewState[key];\n        }\n      }\n      return newViewState;\n    }\n\n    return viewState;\n  }\n\n  /** Resolve the dimensions of the view from overall canvas dimensions */\n  getDimensions({width, height}: {width: number; height: number}): {\n    x: number;\n    y: number;\n    width: number;\n    height: number;\n    padding?: Padding;\n  } {\n    const dimensions: {\n      x: number;\n      y: number;\n      width: number;\n      height: number;\n      padding?: Padding;\n    } = {\n      x: getPosition(this._x, width),\n      y: getPosition(this._y, height),\n      width: getPosition(this._width, width),\n      height: getPosition(this._height, height)\n    };\n\n    if (this._padding) {\n      dimensions.padding = {\n        left: getPosition(this._padding.left, width),\n        top: getPosition(this._padding.top, height),\n        right: getPosition(this._padding.right, width),\n        bottom: getPosition(this._padding.bottom, height)\n      };\n    }\n    return dimensions;\n  }\n\n  // Used by sub classes to resolve controller props\n  get controller(): (ControllerOptions & {type: ConstructorOf<Controller<any>>}) | null {\n    const opts = this.props.controller;\n\n    if (!opts) {\n      return null;\n    }\n    if (opts === true) {\n      return {type: this.ControllerType};\n    }\n    if (typeof opts === 'function') {\n      return {type: opts};\n    }\n    return {type: this.ControllerType, ...opts};\n  }\n}\n","import { uid, assert } from '@luma.gl/webgl';\nexport const DRAW_MODE = {\n  POINTS: 0x0000,\n  LINES: 0x0001,\n  LINE_LOOP: 0x0002,\n  LINE_STRIP: 0x0003,\n  TRIANGLES: 0x0004,\n  TRIANGLE_STRIP: 0x0005,\n  TRIANGLE_FAN: 0x0006\n};\nexport default class Geometry {\n  static get DRAW_MODE() {\n    return DRAW_MODE;\n  }\n\n  constructor() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      id = uid('geometry'),\n      drawMode = DRAW_MODE.TRIANGLES,\n      attributes = {},\n      indices = null,\n      vertexCount = null\n    } = props;\n    this.id = id;\n    this.drawMode = drawMode | 0;\n    this.attributes = {};\n    this.userData = {};\n\n    this._setAttributes(attributes, indices);\n\n    this.vertexCount = vertexCount || this._calculateVertexCount(this.attributes, this.indices);\n  }\n\n  get mode() {\n    return this.drawMode;\n  }\n\n  getVertexCount() {\n    return this.vertexCount;\n  }\n\n  getAttributes() {\n    return this.indices ? {\n      indices: this.indices,\n      ...this.attributes\n    } : this.attributes;\n  }\n\n  _print(attributeName) {\n    return \"Geometry \".concat(this.id, \" attribute \").concat(attributeName);\n  }\n\n  _setAttributes(attributes, indices) {\n    if (indices) {\n      this.indices = ArrayBuffer.isView(indices) ? {\n        value: indices,\n        size: 1\n      } : indices;\n    }\n\n    for (const attributeName in attributes) {\n      let attribute = attributes[attributeName];\n      attribute = ArrayBuffer.isView(attribute) ? {\n        value: attribute\n      } : attribute;\n      assert(ArrayBuffer.isView(attribute.value), \"\".concat(this._print(attributeName), \": must be typed array or object with value as typed array\"));\n\n      if ((attributeName === 'POSITION' || attributeName === 'positions') && !attribute.size) {\n        attribute.size = 3;\n      }\n\n      if (attributeName === 'indices') {\n        assert(!this.indices);\n        this.indices = attribute;\n      } else {\n        this.attributes[attributeName] = attribute;\n      }\n    }\n\n    if (this.indices && this.indices.isIndexed !== undefined) {\n      this.indices = Object.assign({}, this.indices);\n      delete this.indices.isIndexed;\n    }\n\n    return this;\n  }\n\n  _calculateVertexCount(attributes, indices) {\n    if (indices) {\n      return indices.value.length;\n    }\n\n    let vertexCount = Infinity;\n\n    for (const attributeName in attributes) {\n      const attribute = attributes[attributeName];\n      const {\n        value,\n        size,\n        constant\n      } = attribute;\n\n      if (!constant && value && size >= 1) {\n        vertexCount = Math.min(vertexCount, value.length / size);\n      }\n    }\n\n    assert(Number.isFinite(vertexCount));\n    return vertexCount;\n  }\n\n}\n//# sourceMappingURL=geometry.js.map","// Partial deep equal (only recursive on arrays)\nexport function deepEqual(a: any, b: any): boolean {\n  if (a === b) {\n    return true;\n  }\n  if (!a || !b) {\n    return false;\n  }\n  for (const key in a) {\n    const aValue = a[key];\n    const bValue = b[key];\n    const equals =\n      aValue === bValue ||\n      (Array.isArray(aValue) && Array.isArray(bValue) && deepEqual(aValue, bValue));\n    if (!equals) {\n      return false;\n    }\n  }\n  return true;\n}\n","const DATA_URL_PATTERN = /^data:([-\\w.]+\\/[-\\w.+]+)(;|,)/;\nconst MIME_TYPE_PATTERN = /^([-\\w.]+\\/[-\\w.+]+)/;\nexport function parseMIMEType(mimeString) {\n  const matches = MIME_TYPE_PATTERN.exec(mimeString);\n\n  if (matches) {\n    return matches[1];\n  }\n\n  return mimeString;\n}\nexport function parseMIMETypeFromURL(url) {\n  const matches = DATA_URL_PATTERN.exec(url);\n\n  if (matches) {\n    return matches[1];\n  }\n\n  return '';\n}\n//# sourceMappingURL=mime-type-utils.js.map","import { isResponse, isBlob } from '../../javascript-utils/is-type';\nimport { parseMIMEType, parseMIMETypeFromURL } from './mime-type-utils';\nconst QUERY_STRING_PATTERN = /\\?.*/;\nexport function getResourceUrlAndType(resource) {\n  if (isResponse(resource)) {\n    const url = stripQueryString(resource.url || '');\n    const contentTypeHeader = resource.headers.get('content-type') || '';\n    return {\n      url,\n      type: parseMIMEType(contentTypeHeader) || parseMIMETypeFromURL(url)\n    };\n  }\n\n  if (isBlob(resource)) {\n    return {\n      url: stripQueryString(resource.name || ''),\n      type: resource.type || ''\n    };\n  }\n\n  if (typeof resource === 'string') {\n    return {\n      url: stripQueryString(resource),\n      type: parseMIMETypeFromURL(resource)\n    };\n  }\n\n  return {\n    url: '',\n    type: ''\n  };\n}\nexport function getResourceContentLength(resource) {\n  if (isResponse(resource)) {\n    return resource.headers['content-length'] || -1;\n  }\n\n  if (isBlob(resource)) {\n    return resource.size;\n  }\n\n  if (typeof resource === 'string') {\n    return resource.length;\n  }\n\n  if (resource instanceof ArrayBuffer) {\n    return resource.byteLength;\n  }\n\n  if (ArrayBuffer.isView(resource)) {\n    return resource.byteLength;\n  }\n\n  return -1;\n}\n\nfunction stripQueryString(url) {\n  return url.replace(QUERY_STRING_PATTERN, '');\n}\n//# sourceMappingURL=resource-utils.js.map","import { getTypedArrayFromGLType } from '../webgl-utils/typed-array-utils';\nimport { assert } from '../utils/assert';\nimport { checkProps } from '../utils/check-props';\nconst DEFAULT_ACCESSOR_VALUES = {\n  offset: 0,\n  stride: 0,\n  type: 5126,\n  size: 1,\n  divisor: 0,\n  normalized: false,\n  integer: false\n};\nconst PROP_CHECKS = {\n  deprecatedProps: {\n    instanced: 'divisor',\n    isInstanced: 'divisor'\n  }\n};\nexport default class Accessor {\n  static getBytesPerElement(accessor) {\n    const ArrayType = getTypedArrayFromGLType(accessor.type || 5126);\n    return ArrayType.BYTES_PER_ELEMENT;\n  }\n\n  static getBytesPerVertex(accessor) {\n    assert(accessor.size);\n    const ArrayType = getTypedArrayFromGLType(accessor.type || 5126);\n    return ArrayType.BYTES_PER_ELEMENT * accessor.size;\n  }\n\n  static resolve() {\n    for (var _len = arguments.length, accessors = new Array(_len), _key = 0; _key < _len; _key++) {\n      accessors[_key] = arguments[_key];\n    }\n\n    return new Accessor(...[DEFAULT_ACCESSOR_VALUES, ...accessors]);\n  }\n\n  constructor() {\n    for (var _len2 = arguments.length, accessors = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {\n      accessors[_key2] = arguments[_key2];\n    }\n\n    accessors.forEach(accessor => this._assign(accessor));\n    Object.freeze(this);\n  }\n\n  toString() {\n    return JSON.stringify(this);\n  }\n\n  get BYTES_PER_ELEMENT() {\n    return Accessor.getBytesPerElement(this);\n  }\n\n  get BYTES_PER_VERTEX() {\n    return Accessor.getBytesPerVertex(this);\n  }\n\n  _assign() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    props = checkProps('Accessor', props, PROP_CHECKS);\n\n    if (props.type !== undefined) {\n      this.type = props.type;\n\n      if (props.type === 5124 || props.type === 5125) {\n        this.integer = true;\n      }\n    }\n\n    if (props.size !== undefined) {\n      this.size = props.size;\n    }\n\n    if (props.offset !== undefined) {\n      this.offset = props.offset;\n    }\n\n    if (props.stride !== undefined) {\n      this.stride = props.stride;\n    }\n\n    if (props.normalized !== undefined) {\n      this.normalized = props.normalized;\n    }\n\n    if (props.integer !== undefined) {\n      this.integer = props.integer;\n    }\n\n    if (props.divisor !== undefined) {\n      this.divisor = props.divisor;\n    }\n\n    if (props.buffer !== undefined) {\n      this.buffer = props.buffer;\n    }\n\n    if (props.index !== undefined) {\n      if (typeof props.index === 'boolean') {\n        this.index = props.index ? 1 : 0;\n      } else {\n        this.index = props.index;\n      }\n    }\n\n    if (props.instanced !== undefined) {\n      this.divisor = props.instanced ? 1 : 0;\n    }\n\n    if (props.isInstanced !== undefined) {\n      this.divisor = props.isInstanced ? 1 : 0;\n    }\n\n    return this;\n  }\n\n}\nexport { DEFAULT_ACCESSOR_VALUES };\n//# sourceMappingURL=accessor.js.map","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n/* eslint-disable max-params */\nimport earcut from 'earcut';\nimport {modifyPolygonWindingDirection, WINDING} from '@math.gl/polygon';\n\nimport type {Position} from '@deck.gl/core';\nimport type {NumericArray} from '@math.gl/core';\n\nconst OUTER_POLYGON_WINDING = WINDING.CLOCKWISE;\nconst HOLE_POLYGON_WINDING = WINDING.COUNTER_CLOCKWISE;\n\ntype WindingOptions = {\n  start?: number;\n  end?: number;\n  size?: number;\n  isClosed?: boolean;\n};\n\n/** A scratch object for sending winding options */\nconst windingOptions: WindingOptions = {\n  isClosed: true\n};\n\n// 4 data formats are supported:\n\n/** Simple Polygon: an array of points */\nexport type NestedSimplePolygonGeometry = Position[];\n/** Complex Polygon: an array of array of points (array of rings)\n * with the first ring representing the outer hull and other rings representing holes\n */\nexport type NestedComplexPolygonGeometry = Position[][];\n/** An array of numbers (flattened \"simple polygon\") */\nexport type FlatSimplePolygonGeometry = NumericArray;\n/** Flattened \"complex polygon\" */\nexport type FlatComplexPolygonGeometry = {positions: NumericArray; holeIndices: NumericArray};\n\nexport type PolygonGeometry =\n  | NestedSimplePolygonGeometry\n  | NestedComplexPolygonGeometry\n  | FlatSimplePolygonGeometry\n  | FlatComplexPolygonGeometry;\n\nexport type NormalizedPolygonGeometry = FlatSimplePolygonGeometry | FlatComplexPolygonGeometry;\n\n/**\n * Ensure a polygon is valid format\n */\nfunction validate(polygon: PolygonGeometry): void {\n  polygon = (polygon && (polygon as FlatComplexPolygonGeometry).positions) || polygon;\n  if (!Array.isArray(polygon) && !ArrayBuffer.isView(polygon)) {\n    throw new Error('invalid polygon');\n  }\n}\n\n/** Get the positions from a normalized polygon */\nexport function getPositions(polygon: NormalizedPolygonGeometry): NumericArray {\n  return 'positions' in polygon ? polygon.positions : polygon;\n}\n\n/** Get the hole indices from a normalized polygon */\nexport function getHoleIndices(polygon: NormalizedPolygonGeometry): NumericArray | null {\n  return 'holeIndices' in polygon ? polygon.holeIndices : null;\n}\n\n/**\n * Check if a polygon is nested or flat\n * Returns true if the polygon is a flat polygon (i.e. not an array of polygons)\n */\nfunction isNested(\n  polygon: PolygonGeometry\n): polygon is NestedSimplePolygonGeometry | NestedComplexPolygonGeometry {\n  return Array.isArray(polygon[0]);\n}\n\n/**\n * Check if a polygon is simple or complex\n * Returns true if the polygon is a simple polygon (i.e. not an array of polygons)\n */\nfunction isSimple(\n  polygon: NestedSimplePolygonGeometry | NestedComplexPolygonGeometry\n): polygon is NestedSimplePolygonGeometry {\n  return polygon.length >= 1 && polygon[0].length >= 2 && Number.isFinite(polygon[0][0]);\n}\n\n/**\n * Check if a simple polygon is a closed ring\n * Returns true if the simple polygon is a closed ring\n */\nfunction isNestedRingClosed(simplePolygon: NestedSimplePolygonGeometry): boolean {\n  // check if first and last vertex are the same\n  const p0 = simplePolygon[0];\n  const p1 = simplePolygon[simplePolygon.length - 1];\n\n  return p0[0] === p1[0] && p0[1] === p1[1] && p0[2] === p1[2];\n}\n\n/**\n * Check if a simple flat array is a closed ring\n * Returns true if the simple flat array is a closed ring\n */\nfunction isFlatRingClosed(\n  positions: FlatSimplePolygonGeometry,\n  /** size of a position, 2 (xy) or 3 (xyz) */\n  size: number,\n  /** start index of the path in the positions array */\n  startIndex: number,\n  /** end index of the path in the positions array */\n  endIndex: number\n): boolean {\n  for (let i = 0; i < size; i++) {\n    if (positions[startIndex + i] !== positions[endIndex - size + i]) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/**\n * Copy a simple polygon coordinates into a flat array, closes the ring if needed.\n * Returns the index of the write head in the destination\n */\nfunction copyNestedRing(\n  /** destination */\n  target: NumericArray,\n  /** index in the destination to start copying into */\n  targetStartIndex: number,\n  /** the source polygon */\n  simplePolygon: NestedSimplePolygonGeometry,\n  /** size of a position, 2 (xy) or 3 (xyz) */\n  size: number,\n  /** modify polygon to be of the specified winding direction */\n  windingDirection: number\n): number {\n  let targetIndex = targetStartIndex;\n  const len = simplePolygon.length;\n  for (let i = 0; i < len; i++) {\n    for (let j = 0; j < size; j++) {\n      target[targetIndex++] = simplePolygon[i][j] || 0;\n    }\n  }\n\n  if (!isNestedRingClosed(simplePolygon)) {\n    for (let j = 0; j < size; j++) {\n      target[targetIndex++] = simplePolygon[0][j] || 0;\n    }\n  }\n\n  windingOptions.start = targetStartIndex;\n  windingOptions.end = targetIndex;\n  windingOptions.size = size;\n  modifyPolygonWindingDirection(target, windingDirection, windingOptions);\n\n  return targetIndex;\n}\n\n/**\n * Copy a simple flat array into another flat array, closes the ring if needed.\n * Returns the index of the write head in the destination\n */\nfunction copyFlatRing(\n  /** destination */\n  target: NumericArray,\n  /** index in the destination to start copying into */\n  targetStartIndex: number,\n  /** the source polygon */\n  positions: FlatSimplePolygonGeometry,\n  /** size of a position, 2 (xy) or 3 (xyz) */\n  size: number,\n  /** start index of the path in the positions array */\n  srcStartIndex: number = 0,\n  /** end index of the path in the positions array */\n  srcEndIndex: number,\n  windingDirection: number\n): number {\n  srcEndIndex = srcEndIndex || positions.length;\n  const srcLength = srcEndIndex - srcStartIndex;\n  if (srcLength <= 0) {\n    return targetStartIndex;\n  }\n  let targetIndex = targetStartIndex;\n\n  for (let i = 0; i < srcLength; i++) {\n    target[targetIndex++] = positions[srcStartIndex + i];\n  }\n\n  if (!isFlatRingClosed(positions, size, srcStartIndex, srcEndIndex)) {\n    for (let i = 0; i < size; i++) {\n      target[targetIndex++] = positions[srcStartIndex + i];\n    }\n  }\n\n  windingOptions.start = targetStartIndex;\n  windingOptions.end = targetIndex;\n  windingOptions.size = size;\n  modifyPolygonWindingDirection(target, windingDirection, windingOptions);\n\n  return targetIndex;\n}\n\n/**\n * Normalize any polygon representation into the \"complex flat\" format\n */\n/* eslint-disable max-statements */\nexport function normalize(\n  polygon: PolygonGeometry,\n  positionSize: number\n): NormalizedPolygonGeometry {\n  validate(polygon);\n\n  const positions: number[] = [];\n  const holeIndices: number[] = [];\n\n  if ('positions' in polygon) {\n    // complex flat\n    const {positions: srcPositions, holeIndices: srcHoleIndices} = polygon;\n\n    if (srcHoleIndices) {\n      let targetIndex = 0;\n      // split the positions array into `holeIndices.length + 1` rings\n      // holeIndices[-1] falls back to 0\n      // holeIndices[holeIndices.length] falls back to positions.length\n      for (let i = 0; i <= srcHoleIndices.length; i++) {\n        targetIndex = copyFlatRing(\n          positions,\n          targetIndex,\n          srcPositions,\n          positionSize,\n          srcHoleIndices[i - 1],\n          srcHoleIndices[i],\n          i === 0 ? OUTER_POLYGON_WINDING : HOLE_POLYGON_WINDING\n        );\n        holeIndices.push(targetIndex);\n      }\n      // The last one is not a starting index of a hole, remove\n      holeIndices.pop();\n\n      return {positions, holeIndices};\n    }\n    polygon = srcPositions;\n  }\n  if (!isNested(polygon)) {\n    // simple flat\n    copyFlatRing(positions, 0, polygon, positionSize, 0, positions.length, OUTER_POLYGON_WINDING);\n    return positions;\n  }\n  if (!isSimple(polygon)) {\n    // complex polygon\n    let targetIndex = 0;\n\n    for (const [polygonIndex, simplePolygon] of polygon.entries()) {\n      targetIndex = copyNestedRing(\n        positions,\n        targetIndex,\n        simplePolygon,\n        positionSize,\n        polygonIndex === 0 ? OUTER_POLYGON_WINDING : HOLE_POLYGON_WINDING\n      );\n      holeIndices.push(targetIndex);\n    }\n    // The last one is not a starting index of a hole, remove\n    holeIndices.pop();\n    // last index points to the end of the array, remove it\n    return {positions, holeIndices};\n  }\n  // simple polygon\n  copyNestedRing(positions, 0, polygon, positionSize, OUTER_POLYGON_WINDING);\n  return positions;\n}\n/* eslint-enable max-statements */\n\n/*\n * Calculate the area of a single plane of the polygon\n */\nfunction getPlaneArea(positions: NumericArray, xIndex: number, yIndex: number): number {\n  const numVerts = positions.length / 3;\n  let area = 0;\n  for (let i = 0; i < numVerts; i++) {\n    const j = (i + 1) % numVerts;\n    area += positions[i * 3 + xIndex] * positions[j * 3 + yIndex];\n    area -= positions[j * 3 + xIndex] * positions[i * 3 + yIndex];\n  }\n  return Math.abs(area / 2);\n}\n\nfunction permutePositions(positions: NumericArray, xIndex: number, yIndex: number, zIndex: number) {\n  const numVerts = positions.length / 3;\n  for (let i = 0; i < numVerts; i++) {\n    const o = i * 3;\n\n    const x = positions[o + 0];\n    const y = positions[o + 1];\n    const z = positions[o + 2];\n\n    positions[o + xIndex] = x;\n    positions[o + yIndex] = y;\n    positions[o + zIndex] = z;\n  }\n}\n\n/*\n * Get vertex indices for drawing polygon mesh (triangulation)\n */\nexport function getSurfaceIndices(\n  polygon: NormalizedPolygonGeometry,\n  positionSize: number,\n  preproject?: (xy: number[]) => number[],\n  full3d?: boolean\n): number[] {\n  let holeIndices = getHoleIndices(polygon);\n  if (holeIndices) {\n    holeIndices = holeIndices.map(positionIndex => positionIndex / positionSize);\n  }\n\n  let positions = getPositions(polygon);\n\n  const is3d = full3d && positionSize === 3;\n\n  if (preproject) {\n    // When tesselating lnglat coordinates, project them to the common space for accuracy\n    const n = positions.length;\n\n    // Clone the array\n    positions = positions.slice();\n\n    const p: number[] = [];\n    for (let i = 0; i < n; i += positionSize) {\n      p[0] = positions[i];\n      p[1] = positions[i + 1];\n\n      if (is3d) {\n        p[2] = positions[i + 2];\n      }\n\n      const xy = preproject(p);\n\n      positions[i] = xy[0];\n      positions[i + 1] = xy[1];\n\n      if (is3d) {\n        positions[i + 2] = xy[2];\n      }\n    }\n  }\n\n  if (is3d) {\n    // calculate plane with largest area\n    const xyArea = getPlaneArea(positions, 0, 1);\n    const xzArea = getPlaneArea(positions, 0, 2);\n    const yzArea = getPlaneArea(positions, 1, 2);\n\n    if (!xyArea && !xzArea && !yzArea) {\n      return []; // no planes have area, nothing we can do\n    }\n\n    // permute positions to make the largest plane xy for earcut\n    if (xyArea > xzArea && xyArea > yzArea) {\n      // xy plane largest, nothing to do\n    } else if (xzArea > yzArea) {\n      // xz plane largest, permute to make xyz -> xzy\n      if (!preproject) {\n        positions = positions.slice();\n      }\n      permutePositions(positions, 0, 2, 1);\n    } else {\n      // yz plane largest, permute to make xyz -> yzx\n      if (!preproject) {\n        positions = positions.slice();\n      }\n      permutePositions(positions, 1, 2, 0);\n    }\n  }\n\n  // Let earcut triangulate the polygon\n  return earcut(positions, holeIndices, positionSize);\n}\n","import { fs } from '@loaders.gl/loader-utils';\nexport async function readArrayBuffer(file, start, length) {\n  if (typeof file === 'number') {\n    return await fs._readToArrayBuffer(file, start, length);\n  }\n\n  if (!(file instanceof Blob)) {\n    file = new Blob([file]);\n  }\n\n  const slice = file.slice(start, start + length);\n  return await readBlob(slice);\n}\nexport async function readBlob(blob) {\n  return await new Promise((resolve, reject) => {\n    const fileReader = new FileReader();\n\n    fileReader.onload = event => {\n      var _event$target;\n\n      return resolve(event === null || event === void 0 ? void 0 : (_event$target = event.target) === null || _event$target === void 0 ? void 0 : _event$target.result);\n    };\n\n    fileReader.onerror = error => reject(error);\n\n    fileReader.readAsArrayBuffer(blob);\n  });\n}\n//# sourceMappingURL=read-array-buffer.js.map","import { isBrowser, resolvePath, fs, toArrayBuffer } from '@loaders.gl/loader-utils';\nimport { assert } from '@loaders.gl/loader-utils';\nexport function readFileSync(url, options = {}) {\n  url = resolvePath(url);\n\n  if (!isBrowser) {\n    const buffer = fs.readFileSync(url, options);\n    return typeof buffer !== 'string' ? toArrayBuffer(buffer) : buffer;\n  }\n\n  if (!options.nothrow) {\n    assert(false);\n  }\n\n  return null;\n}\n//# sourceMappingURL=read-file.js.map","import { isBrowser, assert, resolvePath } from '@loaders.gl/loader-utils';\nimport { fs, toBuffer } from '@loaders.gl/loader-utils';\nexport async function writeFile(filePath, arrayBufferOrString, options) {\n  filePath = resolvePath(filePath);\n\n  if (!isBrowser) {\n    await fs.writeFile(filePath, toBuffer(arrayBufferOrString), {\n      flag: 'w'\n    });\n  }\n\n  assert(false);\n}\nexport function writeFileSync(filePath, arrayBufferOrString, options) {\n  filePath = resolvePath(filePath);\n\n  if (!isBrowser) {\n    fs.writeFileSync(filePath, toBuffer(arrayBufferOrString), {\n      flag: 'w'\n    });\n  }\n\n  assert(false);\n}\n//# sourceMappingURL=write-file.js.map","import { assert } from '@loaders.gl/loader-utils';\nimport { selectLoaderSync } from './select-loader';\nimport { isLoaderObject } from '../loader-utils/normalize-loader';\nimport { normalizeOptions } from '../loader-utils/option-utils';\nimport { getArrayBufferOrStringFromDataSync } from '../loader-utils/get-data';\nimport { getLoaderContext, getLoadersFromContext } from '../loader-utils/loader-context';\nimport { getResourceUrlAndType } from '../utils/resource-utils';\nexport function parseSync(data, loaders, options, context) {\n  assert(!context || typeof context === 'object');\n\n  if (!Array.isArray(loaders) && !isLoaderObject(loaders)) {\n    context = undefined;\n    options = loaders;\n    loaders = undefined;\n  }\n\n  options = options || {};\n  const typedLoaders = loaders;\n  const candidateLoaders = getLoadersFromContext(typedLoaders, context);\n  const loader = selectLoaderSync(data, candidateLoaders, options);\n\n  if (!loader) {\n    return null;\n  }\n\n  options = normalizeOptions(options, loader, candidateLoaders);\n  const {\n    url\n  } = getResourceUrlAndType(data);\n\n  const parse = () => {\n    throw new Error('parseSync called parse');\n  };\n\n  context = getLoaderContext({\n    url,\n    parseSync,\n    parse,\n    loaders: loaders\n  }, options);\n  return parseWithLoaderSync(loader, data, options, context);\n}\n\nfunction parseWithLoaderSync(loader, data, options, context) {\n  data = getArrayBufferOrStringFromDataSync(data, loader, options);\n\n  if (loader.parseTextSync && typeof data === 'string') {\n    return loader.parseTextSync(data, options);\n  }\n\n  if (loader.parseSync && data instanceof ArrayBuffer) {\n    return loader.parseSync(data, options, context);\n  }\n\n  throw new Error(\"\".concat(loader.name, \" loader: 'parseSync' not supported by this loader, use 'parse' instead. \").concat(context.url || ''));\n}\n//# sourceMappingURL=parse-sync.js.map","import { assert, concatenateArrayBuffersAsync } from '@loaders.gl/loader-utils';\nimport { isLoaderObject } from '../loader-utils/normalize-loader';\nimport { normalizeOptions } from '../loader-utils/option-utils';\nimport { getLoaderContext } from '../loader-utils/loader-context';\nimport { getAsyncIterableFromData } from '../loader-utils/get-data';\nimport { getResourceUrlAndType } from '../utils/resource-utils';\nimport { selectLoader } from './select-loader';\nimport { parse } from './parse';\nexport async function parseInBatches(data, loaders, options, context) {\n  assert(!context || typeof context === 'object');\n\n  if (!Array.isArray(loaders) && !isLoaderObject(loaders)) {\n    context = undefined;\n    options = loaders;\n    loaders = undefined;\n  }\n\n  data = await data;\n  options = options || {};\n  const {\n    url\n  } = getResourceUrlAndType(data);\n  const loader = await selectLoader(data, loaders, options);\n\n  if (!loader) {\n    return null;\n  }\n\n  options = normalizeOptions(options, loader, loaders, url);\n  context = getLoaderContext({\n    url,\n    parseInBatches,\n    parse,\n    loaders: loaders\n  }, options, context);\n  return await parseWithLoaderInBatches(loader, data, options, context);\n}\n\nasync function parseWithLoaderInBatches(loader, data, options, context) {\n  const outputIterator = await parseToOutputIterator(loader, data, options, context);\n\n  if (!options.metadata) {\n    return outputIterator;\n  }\n\n  const metadataBatch = {\n    batchType: 'metadata',\n    metadata: {\n      _loader: loader,\n      _context: context\n    },\n    data: [],\n    bytesUsed: 0\n  };\n\n  async function* makeMetadataBatchIterator(iterator) {\n    yield metadataBatch;\n    yield* iterator;\n  }\n\n  return makeMetadataBatchIterator(outputIterator);\n}\n\nasync function parseToOutputIterator(loader, data, options, context) {\n  const inputIterator = await getAsyncIterableFromData(data, options);\n  const transformedIterator = await applyInputTransforms(inputIterator, (options === null || options === void 0 ? void 0 : options.transforms) || []);\n\n  if (loader.parseInBatches) {\n    return loader.parseInBatches(transformedIterator, options, context);\n  }\n\n  async function* parseChunkInBatches() {\n    const arrayBuffer = await concatenateArrayBuffersAsync(transformedIterator);\n    const parsedData = await parse(arrayBuffer, loader, { ...options,\n      mimeType: loader.mimeTypes[0]\n    }, context);\n    const batch = {\n      mimeType: loader.mimeTypes[0],\n      shape: Array.isArray(parsedData) ? 'row-table' : 'unknown',\n      batchType: 'data',\n      data: parsedData,\n      length: Array.isArray(parsedData) ? parsedData.length : 1\n    };\n    yield batch;\n  }\n\n  return parseChunkInBatches();\n}\n\nasync function applyInputTransforms(inputIterator, transforms = []) {\n  let iteratorChain = inputIterator;\n\n  for await (const transformBatches of transforms) {\n    iteratorChain = transformBatches(iteratorChain);\n  }\n\n  return iteratorChain;\n}\n//# sourceMappingURL=parse-in-batches.js.map","import { isLoaderObject } from '../loader-utils/normalize-loader';\nimport { getFetchFunction } from '../loader-utils/option-utils';\nimport { parseInBatches } from './parse-in-batches';\nexport function loadInBatches(files, loaders, options, context) {\n  if (!Array.isArray(loaders) && !isLoaderObject(loaders)) {\n    context = undefined;\n    options = loaders;\n    loaders = null;\n  }\n\n  const fetch = getFetchFunction(options || {});\n\n  if (!Array.isArray(files)) {\n    return loadOneFileInBatches(files, loaders, options, fetch);\n  }\n\n  const promises = files.map(file => loadOneFileInBatches(file, loaders, options, fetch));\n  return promises;\n}\n\nasync function loadOneFileInBatches(file, loaders, options, fetch) {\n  if (typeof file === 'string') {\n    const url = file;\n    const response = await fetch(url);\n    return await parseInBatches(response, loaders, options);\n  }\n\n  return await parseInBatches(file, loaders, options);\n}\n//# sourceMappingURL=load-in-batches.js.map","import WorkerFarm from '../worker-farm/worker-farm';\nimport { getWorkerURL, getWorkerName } from './get-worker-url';\nimport { getTransferListForWriter } from '../worker-utils/get-transfer-list';\nexport function canProcessOnWorker(worker, options) {\n  if (!WorkerFarm.isSupported()) {\n    return false;\n  }\n\n  return worker.worker && (options === null || options === void 0 ? void 0 : options.worker);\n}\nexport async function processOnWorker(worker, data, options = {}, context = {}) {\n  const name = getWorkerName(worker);\n  const workerFarm = WorkerFarm.getWorkerFarm(options);\n  const {\n    source\n  } = options;\n  const workerPoolProps = {\n    name,\n    source\n  };\n\n  if (!source) {\n    workerPoolProps.url = getWorkerURL(worker, options);\n  }\n\n  const workerPool = workerFarm.getWorkerPool(workerPoolProps);\n  const jobName = options.jobName || worker.name;\n  const job = await workerPool.startJob(jobName, onMessage.bind(null, context));\n  const transferableOptions = getTransferListForWriter(options);\n  job.postMessage('process', {\n    input: data,\n    options: transferableOptions\n  });\n  const result = await job.result;\n  return result.result;\n}\n\nasync function onMessage(context, job, type, payload) {\n  switch (type) {\n    case 'done':\n      job.done(payload);\n      break;\n\n    case 'error':\n      job.error(new Error(payload.error));\n      break;\n\n    case 'process':\n      const {\n        id,\n        input,\n        options\n      } = payload;\n\n      try {\n        if (!context.process) {\n          job.postMessage('error', {\n            id,\n            error: 'Worker not set up to process on main thread'\n          });\n          return;\n        }\n\n        const result = await context.process(input, options);\n        job.postMessage('done', {\n          id,\n          result\n        });\n      } catch (error) {\n        const message = error instanceof Error ? error.message : 'unknown error';\n        job.postMessage('error', {\n          id,\n          error: message\n        });\n      }\n\n      break;\n\n    default:\n      console.warn(\"process-on-worker: unknown message \".concat(type));\n  }\n}\n//# sourceMappingURL=process-on-worker.js.map","import { canEncodeWithWorker } from '@loaders.gl/loader-utils';\nimport { processOnWorker } from '@loaders.gl/worker-utils';\nimport { concatenateArrayBuffers, resolvePath } from '@loaders.gl/loader-utils';\nimport { isBrowser } from '@loaders.gl/loader-utils';\nimport { writeFile } from '../fetch/write-file';\nimport { fetchFile } from '../fetch/fetch-file';\nimport { getLoaderOptions } from './loader-options';\nexport async function encode(data, writer, options) {\n  const globalOptions = getLoaderOptions();\n  options = { ...globalOptions,\n    ...options\n  };\n\n  if (canEncodeWithWorker(writer, options)) {\n    return await processOnWorker(writer, data, options);\n  }\n\n  if (writer.encode) {\n    return await writer.encode(data, options);\n  }\n\n  if (writer.encodeSync) {\n    return writer.encodeSync(data, options);\n  }\n\n  if (writer.encodeText) {\n    return new TextEncoder().encode(await writer.encodeText(data, options));\n  }\n\n  if (writer.encodeInBatches) {\n    const batches = encodeInBatches(data, writer, options);\n    const chunks = [];\n\n    for await (const batch of batches) {\n      chunks.push(batch);\n    }\n\n    return concatenateArrayBuffers(...chunks);\n  }\n\n  if (!isBrowser && writer.encodeURLtoURL) {\n    const tmpInputFilename = getTemporaryFilename('input');\n    await writeFile(tmpInputFilename, data);\n    const tmpOutputFilename = getTemporaryFilename('output');\n    const outputFilename = await encodeURLtoURL(tmpInputFilename, tmpOutputFilename, writer, options);\n    const response = await fetchFile(outputFilename);\n    return response.arrayBuffer();\n  }\n\n  throw new Error('Writer could not encode data');\n}\nexport function encodeSync(data, writer, options) {\n  if (writer.encodeSync) {\n    return writer.encodeSync(data, options);\n  }\n\n  throw new Error('Writer could not synchronously encode data');\n}\nexport async function encodeText(data, writer, options) {\n  if (writer.text && writer.encodeText) {\n    return await writer.encodeText(data, options);\n  }\n\n  if (writer.text && (writer.encode || writer.encodeInBatches)) {\n    const arrayBuffer = await encode(data, writer, options);\n    return new TextDecoder().decode(arrayBuffer);\n  }\n\n  throw new Error('Writer could not encode data as text');\n}\nexport function encodeInBatches(data, writer, options) {\n  if (writer.encodeInBatches) {\n    const dataIterator = getIterator(data);\n    return writer.encodeInBatches(dataIterator, options);\n  }\n\n  throw new Error('Writer could not encode data in batches');\n}\nexport async function encodeURLtoURL(inputUrl, outputUrl, writer, options) {\n  inputUrl = resolvePath(inputUrl);\n  outputUrl = resolvePath(outputUrl);\n\n  if (isBrowser || !writer.encodeURLtoURL) {\n    throw new Error();\n  }\n\n  const outputFilename = await writer.encodeURLtoURL(inputUrl, outputUrl, options);\n  return outputFilename;\n}\n\nfunction getIterator(data) {\n  const dataIterator = [{\n    table: data,\n    start: 0,\n    end: data.length\n  }];\n  return dataIterator;\n}\n\nfunction getTemporaryFilename(filename) {\n  return \"/tmp/\".concat(filename);\n}\n//# sourceMappingURL=encode.js.map","import { encode, encodeSync } from './encode';\nimport { writeFile, writeFileSync } from '../fetch/write-file';\nexport async function save(data, url, writer, options) {\n  const encodedData = await encode(data, writer, options);\n  return await writeFile(url, encodedData);\n}\nexport function saveSync(data, url, writer, options) {\n  const encodedData = encodeSync(data, writer, options);\n  return writeFileSync(url, encodedData);\n}\n//# sourceMappingURL=save.js.map","export function makeStream(source, options) {\n  const iterator = source[Symbol.asyncIterator] ? source[Symbol.asyncIterator]() : source[Symbol.iterator]();\n  return new ReadableStream({\n    type: 'bytes',\n\n    async pull(controller) {\n      try {\n        const {\n          done,\n          value\n        } = await iterator.next();\n\n        if (done) {\n          controller.close();\n        } else {\n          controller.enqueue(new Uint8Array(value));\n        }\n      } catch (error) {\n        controller.error(error);\n      }\n    },\n\n    async cancel() {\n      var _iterator$return;\n\n      await (iterator === null || iterator === void 0 ? void 0 : (_iterator$return = iterator.return) === null || _iterator$return === void 0 ? void 0 : _iterator$return.call(iterator));\n    }\n\n  }, {\n    highWaterMark: 2 ** 24,\n    ...options\n  });\n}\n//# sourceMappingURL=make-dom-stream.js.map","const VERSION = typeof \"3.2.10\" !== 'undefined' ? \"3.2.10\" : 'latest';\nexport const NullWorkerLoader = {\n  name: 'Null loader',\n  id: 'null',\n  module: 'core',\n  version: VERSION,\n  worker: true,\n  mimeTypes: ['application/x.empty'],\n  extensions: ['null'],\n  tests: [() => false],\n  options: {\n    null: {}\n  }\n};\n\nfunction parseSync(arrayBuffer, options, context) {\n  if (!options.null.echoParameters) return null;\n  context = context && JSON.parse(JSON.stringify(context));\n  return {\n    arrayBuffer,\n    options,\n    context\n  };\n}\n\nexport const NullLoader = {\n  name: 'Null loader',\n  id: 'null',\n  module: 'core',\n  version: VERSION,\n  mimeTypes: ['application/x.empty'],\n  extensions: ['null'],\n  parse: async (arrayBuffer, options, context) => parseSync(arrayBuffer, options, context),\n  parseSync,\n  parseInBatches: async function* generator(asyncIterator, options, context) {\n    for await (const batch of asyncIterator) {\n      yield parseSync(batch, options, context);\n    }\n  },\n  tests: [() => false],\n  options: {\n    null: {\n      echoParameters: false\n    }\n  }\n};\n//# sourceMappingURL=null-loader.js.map","export default async function fetchProgress(response, onProgress, onDone = () => {}, onError = () => {}) {\n  response = await response;\n\n  if (!response.ok) {\n    return response;\n  }\n\n  const body = response.body;\n\n  if (!body) {\n    return response;\n  }\n\n  const contentLength = response.headers.get('content-length') || 0;\n  const totalBytes = contentLength && parseInt(contentLength);\n\n  if (!(contentLength > 0)) {\n    return response;\n  }\n\n  if (typeof ReadableStream === 'undefined' || !body.getReader) {\n    return response;\n  }\n\n  const progressStream = new ReadableStream({\n    async start(controller) {\n      const reader = body.getReader();\n      await read(controller, reader, 0, totalBytes, onProgress, onDone, onError);\n    }\n\n  });\n  return new Response(progressStream);\n}\n\nasync function read(controller, reader, loadedBytes, totalBytes, onProgress, onDone, onError) {\n  try {\n    const {\n      done,\n      value\n    } = await reader.read();\n\n    if (done) {\n      onDone();\n      controller.close();\n      return;\n    }\n\n    loadedBytes += value.byteLength;\n    const percent = Math.round(loadedBytes / totalBytes * 100);\n    onProgress(percent, {\n      loadedBytes,\n      totalBytes\n    });\n    controller.enqueue(value);\n    await read(controller, reader, loadedBytes, totalBytes, onProgress, onDone, onError);\n  } catch (error) {\n    controller.error(error);\n    onError(error);\n  }\n}\n//# sourceMappingURL=fetch-progress.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nexport default class BrowserFileSystem {\n  constructor(files, options) {\n    _defineProperty(this, \"_fetch\", void 0);\n\n    _defineProperty(this, \"files\", {});\n\n    _defineProperty(this, \"lowerCaseFiles\", {});\n\n    _defineProperty(this, \"usedFiles\", {});\n\n    this._fetch = (options === null || options === void 0 ? void 0 : options.fetch) || fetch;\n\n    for (let i = 0; i < files.length; ++i) {\n      const file = files[i];\n      this.files[file.name] = file;\n      this.lowerCaseFiles[file.name.toLowerCase()] = file;\n      this.usedFiles[file.name] = false;\n    }\n\n    this.fetch = this.fetch.bind(this);\n  }\n\n  async fetch(path, options) {\n    if (path.includes('://')) {\n      return this._fetch(path, options);\n    }\n\n    const file = this.files[path];\n\n    if (!file) {\n      return new Response(path, {\n        status: 400,\n        statusText: 'NOT FOUND'\n      });\n    }\n\n    const headers = new Headers(options === null || options === void 0 ? void 0 : options.headers);\n    const range = headers.get('Range');\n    const bytes = range && /bytes=($1)-($2)/.exec(range);\n\n    if (bytes) {\n      const start = parseInt(bytes[1]);\n      const end = parseInt(bytes[2]);\n      const data = await file.slice(start, end).arrayBuffer();\n      const response = new Response(data);\n      Object.defineProperty(response, 'url', {\n        value: path\n      });\n      return response;\n    }\n\n    const response = new Response(file);\n    Object.defineProperty(response, 'url', {\n      value: path\n    });\n    return response;\n  }\n\n  async readdir(dirname) {\n    const files = [];\n\n    for (const path in this.files) {\n      files.push(path);\n    }\n\n    return files;\n  }\n\n  async stat(path, options) {\n    const file = this.files[path];\n\n    if (!file) {\n      throw new Error(path);\n    }\n\n    return {\n      size: file.size\n    };\n  }\n\n  async unlink(path) {\n    delete this.files[path];\n    delete this.lowerCaseFiles[path];\n    this.usedFiles[path] = true;\n  }\n\n  async open(pathname, flags, mode) {\n    return this.files[pathname];\n  }\n\n  async read(fd, buffer, offset = 0, length = buffer.byteLength, position = null) {\n    const file = fd;\n    const startPosition = 0;\n    const arrayBuffer = await file.slice(startPosition, startPosition + length).arrayBuffer();\n    return {\n      bytesRead: length,\n      buffer: arrayBuffer\n    };\n  }\n\n  async close(fd) {}\n\n  _getFile(path, used) {\n    const file = this.files[path] || this.lowerCaseFiles[path];\n\n    if (file && used) {\n      this.usedFiles[path] = true;\n    }\n\n    return file;\n  }\n\n}\n//# sourceMappingURL=browser-filesystem.js.map","export { fetchFile } from './lib/fetch/fetch-file';\nexport { readArrayBuffer } from './lib/fetch/read-array-buffer';\nexport { readFileSync } from './lib/fetch/read-file';\nexport { writeFile, writeFileSync } from './lib/fetch/write-file';\nexport { setLoaderOptions, getLoaderOptions } from './lib/api/loader-options';\nexport { registerLoaders } from './lib/api/register-loaders';\nexport { selectLoader, selectLoaderSync } from './lib/api/select-loader';\nexport { parse } from './lib/api/parse';\nexport { parseSync } from './lib/api/parse-sync';\nexport { parseInBatches } from './lib/api/parse-in-batches';\nexport { load } from './lib/api/load';\nexport { loadInBatches } from './lib/api/load-in-batches';\nexport { encode, encodeSync, encodeInBatches, encodeText, encodeURLtoURL } from './lib/api/encode';\nexport { save, saveSync } from './lib/api/save';\nexport { setPathPrefix, getPathPrefix, resolvePath } from '@loaders.gl/loader-utils';\nexport { RequestScheduler } from '@loaders.gl/loader-utils';\nexport { makeIterator } from './iterators/make-iterator/make-iterator';\nexport { makeStream } from './iterators/make-stream/make-node-stream';\nexport { NullWorkerLoader, NullLoader } from './null-loader';\nexport { JSONLoader } from '@loaders.gl/loader-utils';\nexport { default as _fetchProgress } from './lib/progress/fetch-progress';\nexport { default as _BrowserFileSystem } from './lib/filesystems/browser-filesystem';\nexport { _unregisterLoaders } from './lib/api/register-loaders';\nexport { isBrowser, isWorker, self, window, global, document } from '@loaders.gl/loader-utils';\nexport { assert } from '@loaders.gl/loader-utils';\nexport { forEach, concatenateArrayBuffersAsync } from '@loaders.gl/loader-utils';\nexport { makeTextDecoderIterator, makeTextEncoderIterator, makeLineIterator, makeNumberedLineIterator } from '@loaders.gl/loader-utils';\nexport { isPureObject, isPromise, isIterable, isAsyncIterable, isIterator, isResponse, isReadableStream, isWritableStream } from './javascript-utils/is-type';\n//# sourceMappingURL=index.js.map","import {lerp} from '@math.gl/core';\n\nconst DEFAULT_INDICES = new Uint16Array([0, 2, 1, 0, 3, 2]);\nconst DEFAULT_TEX_COORDS = new Float32Array([0, 1, 0, 0, 1, 0, 1, 1]);\n\n/*\n  1 ---- 2\n  |      |\n  |      |\n  0 ---- 3\n*/\n/* eslint-disable max-statements */\nexport default function createMesh(bounds, resolution) {\n  if (!resolution) {\n    return createQuad(bounds);\n  }\n  const maxXSpan = Math.max(\n    Math.abs(bounds[0][0] - bounds[3][0]),\n    Math.abs(bounds[1][0] - bounds[2][0])\n  );\n  const maxYSpan = Math.max(\n    Math.abs(bounds[1][1] - bounds[0][1]),\n    Math.abs(bounds[2][1] - bounds[3][1])\n  );\n  const uCount = Math.ceil(maxXSpan / resolution) + 1;\n  const vCount = Math.ceil(maxYSpan / resolution) + 1;\n\n  const vertexCount = (uCount - 1) * (vCount - 1) * 6;\n  const indices = new Uint32Array(vertexCount);\n  const texCoords = new Float32Array(uCount * vCount * 2);\n  const positions = new Float64Array(uCount * vCount * 3);\n\n  // Tesselate\n  let vertex = 0;\n  let index = 0;\n  for (let u = 0; u < uCount; u++) {\n    const ut = u / (uCount - 1);\n    for (let v = 0; v < vCount; v++) {\n      const vt = v / (vCount - 1);\n      const p = interpolateQuad(bounds, ut, vt);\n\n      positions[vertex * 3 + 0] = p[0];\n      positions[vertex * 3 + 1] = p[1];\n      positions[vertex * 3 + 2] = p[2] || 0;\n\n      texCoords[vertex * 2 + 0] = ut;\n      texCoords[vertex * 2 + 1] = 1 - vt;\n\n      if (u > 0 && v > 0) {\n        indices[index++] = vertex - vCount;\n        indices[index++] = vertex - vCount - 1;\n        indices[index++] = vertex - 1;\n        indices[index++] = vertex - vCount;\n        indices[index++] = vertex - 1;\n        indices[index++] = vertex;\n      }\n\n      vertex++;\n    }\n  }\n  return {\n    vertexCount,\n    positions,\n    indices,\n    texCoords\n  };\n}\n\nfunction createQuad(bounds) {\n  const positions = new Float64Array(12);\n  // [[minX, minY], [minX, maxY], [maxX, maxY], [maxX, minY]]\n  for (let i = 0; i < bounds.length; i++) {\n    positions[i * 3 + 0] = bounds[i][0];\n    positions[i * 3 + 1] = bounds[i][1];\n    positions[i * 3 + 2] = bounds[i][2] || 0;\n  }\n\n  return {\n    vertexCount: 6,\n    positions,\n    indices: DEFAULT_INDICES,\n    texCoords: DEFAULT_TEX_COORDS\n  };\n}\n\nfunction interpolateQuad(quad, ut, vt) {\n  return lerp(lerp(quad[0], quad[1], vt), lerp(quad[3], quad[2], vt), ut);\n}\n","export default `\n#define SHADER_NAME bitmap-layer-vertex-shader\n\nattribute vec2 texCoords;\nattribute vec3 positions;\nattribute vec3 positions64Low;\n\nvarying vec2 vTexCoord;\nvarying vec2 vTexPos;\n\nuniform float coordinateConversion;\n\nconst vec3 pickingColor = vec3(1.0, 0.0, 0.0);\n\nvoid main(void) {\n  geometry.worldPosition = positions;\n  geometry.uv = texCoords;\n  geometry.pickingColor = pickingColor;\n\n  gl_Position = project_position_to_clipspace(positions, positions64Low, vec3(0.0), geometry.position);\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  vTexCoord = texCoords;\n\n  if (coordinateConversion < -0.5) {\n    vTexPos = geometry.position.xy + project_uCommonOrigin.xy;\n  } else if (coordinateConversion > 0.5) {\n    vTexPos = geometry.worldPosition.xy;\n  }\n\n  vec4 color = vec4(0.0);\n  DECKGL_FILTER_COLOR(color, geometry);\n}\n`;\n","/**\n * Pack the top 12 bits of two normalized floats into 3 8-bit (rgb) values\n * This enables addressing 4096x4096 individual pixels\n *\n * returns vec3 encoded RGB colors\n *  result.r - top 8 bits of u\n *  result.g - top 8 bits of v\n *  result.b - next 4 bits of u and v: (u + v * 16)\n */\nconst packUVsIntoRGB = `\nvec3 packUVsIntoRGB(vec2 uv) {\n  // Extract the top 8 bits. We want values to be truncated down so we can add a fraction\n  vec2 uv8bit = floor(uv * 256.);\n\n  // Calculate the normalized remainders of u and v parts that do not fit into 8 bits\n  // Scale and clamp to 0-1 range\n  vec2 uvFraction = fract(uv * 256.);\n  vec2 uvFraction4bit = floor(uvFraction * 16.);\n\n  // Remainder can be encoded in blue channel, encode as 4 bits for pixel coordinates\n  float fractions = uvFraction4bit.x + uvFraction4bit.y * 16.;\n\n  return vec3(uv8bit, fractions) / 255.;\n}\n`;\n\nexport default `\n#define SHADER_NAME bitmap-layer-fragment-shader\n\n#ifdef GL_ES\nprecision highp float;\n#endif\n\nuniform sampler2D bitmapTexture;\n\nvarying vec2 vTexCoord;\nvarying vec2 vTexPos;\n\nuniform float desaturate;\nuniform vec4 transparentColor;\nuniform vec3 tintColor;\nuniform float opacity;\n\nuniform float coordinateConversion;\nuniform vec4 bounds;\n\n/* projection utils */\nconst float TILE_SIZE = 512.0;\nconst float PI = 3.1415926536;\nconst float WORLD_SCALE = TILE_SIZE / PI / 2.0;\n\n// from degrees to Web Mercator\nvec2 lnglat_to_mercator(vec2 lnglat) {\n  float x = lnglat.x;\n  float y = clamp(lnglat.y, -89.9, 89.9);\n  return vec2(\n    radians(x) + PI,\n    PI + log(tan(PI * 0.25 + radians(y) * 0.5))\n  ) * WORLD_SCALE;\n}\n\n// from Web Mercator to degrees\nvec2 mercator_to_lnglat(vec2 xy) {\n  xy /= WORLD_SCALE;\n  return degrees(vec2(\n    xy.x - PI,\n    atan(exp(xy.y - PI)) * 2.0 - PI * 0.5\n  ));\n}\n/* End projection utils */\n\n// apply desaturation\nvec3 color_desaturate(vec3 color) {\n  float luminance = (color.r + color.g + color.b) * 0.333333333;\n  return mix(color, vec3(luminance), desaturate);\n}\n\n// apply tint\nvec3 color_tint(vec3 color) {\n  return color * tintColor;\n}\n\n// blend with background color\nvec4 apply_opacity(vec3 color, float alpha) {\n  if (transparentColor.a == 0.0) {\n    return vec4(color, alpha);\n  }\n  float blendedAlpha = alpha + transparentColor.a * (1.0 - alpha);\n  float highLightRatio = alpha / blendedAlpha;\n  vec3 blendedRGB = mix(transparentColor.rgb, color, highLightRatio);\n  return vec4(blendedRGB, blendedAlpha);\n}\n\nvec2 getUV(vec2 pos) {\n  return vec2(\n    (pos.x - bounds[0]) / (bounds[2] - bounds[0]),\n    (pos.y - bounds[3]) / (bounds[1] - bounds[3])\n  );\n}\n\n${packUVsIntoRGB}\n\nvoid main(void) {\n  vec2 uv = vTexCoord;\n  if (coordinateConversion < -0.5) {\n    vec2 lnglat = mercator_to_lnglat(vTexPos);\n    uv = getUV(lnglat);\n  } else if (coordinateConversion > 0.5) {\n    vec2 commonPos = lnglat_to_mercator(vTexPos);\n    uv = getUV(commonPos);\n  }\n  vec4 bitmapColor = texture2D(bitmapTexture, uv);\n\n  gl_FragColor = apply_opacity(color_tint(color_desaturate(bitmapColor.rgb)), bitmapColor.a * opacity);\n\n  geometry.uv = uv;\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n\n  if (picking_uActive) {\n    // Since instance information is not used, we can use picking color for pixel index\n    gl_FragColor.rgb = packUVsIntoRGB(uv);\n  }\n}\n`;\n","// Copyright (c) 2015 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport GL from '@luma.gl/constants';\nimport {\n  Layer,\n  project32,\n  picking,\n  CoordinateSystem,\n  COORDINATE_SYSTEM,\n  LayerProps,\n  PickingInfo,\n  GetPickingInfoParams,\n  UpdateParameters,\n  Color,\n  Texture,\n  Position,\n  DefaultProps\n} from '@deck.gl/core';\nimport {Model, Geometry} from '@luma.gl/core';\nimport {lngLatToWorld} from '@math.gl/web-mercator';\n\nimport createMesh from './create-mesh';\n\nimport vs from './bitmap-layer-vertex';\nimport fs from './bitmap-layer-fragment';\n\nconst defaultProps: DefaultProps<BitmapLayerProps> = {\n  image: {type: 'image', value: null, async: true},\n  bounds: {type: 'array', value: [1, 0, 0, 1], compare: true},\n  _imageCoordinateSystem: COORDINATE_SYSTEM.DEFAULT,\n\n  desaturate: {type: 'number', min: 0, max: 1, value: 0},\n  // More context: because of the blending mode we're using for ground imagery,\n  // alpha is not effective when blending the bitmap layers with the base map.\n  // Instead we need to manually dim/blend rgb values with a background color.\n  transparentColor: {type: 'color', value: [0, 0, 0, 0]},\n  tintColor: {type: 'color', value: [255, 255, 255]}\n};\n\n/** All properties supported by BitmapLayer. */\nexport type BitmapLayerProps = _BitmapLayerProps & LayerProps;\nexport type BitmapBoundingBox =\n  | [left: number, bottom: number, right: number, top: number]\n  | [Position, Position, Position, Position];\n\n/** Properties added by BitmapLayer. */\ntype _BitmapLayerProps = {\n  /**\n   * The image to display.\n   *\n   * @default null\n   */\n  image?: string | Texture | null;\n\n  /**\n   * Supported formats:\n   *  - Coordinates of the bounding box of the bitmap `[left, bottom, right, top]`\n   *  - Coordinates of four corners of the bitmap, should follow the sequence of `[[left, bottom], [left, top], [right, top], [right, bottom]]`.\n   *   Each position could optionally contain a third component `z`.\n   * @default [1, 0, 0, 1]\n   */\n  bounds?: BitmapBoundingBox;\n\n  /**\n   * > Note: this prop is experimental.\n   *\n   * Specifies how image coordinates should be geographically interpreted.\n   * @default COORDINATE_SYSTEM.DEFAULT\n   */\n  _imageCoordinateSystem?: CoordinateSystem;\n\n  /**\n   * The desaturation of the bitmap. Between `[0, 1]`.\n   * @default 0\n   */\n  desaturate?: number;\n\n  /**\n   * The color to use for transparent pixels, in `[r, g, b, a]`.\n   * @default [0, 0, 0, 0]\n   */\n  transparentColor?: Color;\n\n  /**\n   * The color to tint the bitmap by, in `[r, g, b]`.\n   * @default [255, 255, 255]\n   */\n  tintColor?: Color;\n\n  /** Customize the [texture parameters](https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/texParameter). */\n  textureParameters?: Record<number, number> | null;\n};\n\n/** Render a bitmap at specified boundaries. */\nexport default class BitmapLayer<ExtraPropsT = {}> extends Layer<\n  ExtraPropsT & Required<_BitmapLayerProps>\n> {\n  static layerName = 'BitmapLayer';\n  static defaultProps = defaultProps;\n\n  state!: Layer['state'] & {\n    disablePicking?: boolean;\n    model?: Model;\n    mesh?: any;\n    coordinateConversion?: number;\n    bounds?: number[];\n  };\n\n  getShaders() {\n    return super.getShaders({vs, fs, modules: [project32, picking]});\n  }\n\n  initializeState() {\n    const attributeManager = this.getAttributeManager()!;\n\n    attributeManager.remove(['instancePickingColors']);\n    const noAlloc = true;\n\n    attributeManager.add({\n      indices: {\n        size: 1,\n        isIndexed: true,\n        update: attribute => (attribute.value = this.state.mesh.indices),\n        noAlloc\n      },\n      positions: {\n        size: 3,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        update: attribute => (attribute.value = this.state.mesh.positions),\n        noAlloc\n      },\n      texCoords: {\n        size: 2,\n        update: attribute => (attribute.value = this.state.mesh.texCoords),\n        noAlloc\n      }\n    });\n  }\n\n  updateState({props, oldProps, changeFlags}: UpdateParameters<this>): void {\n    // setup model first\n    const attributeManager = this.getAttributeManager()!;\n\n    if (changeFlags.extensionsChanged) {\n      const {gl} = this.context;\n      this.state.model?.delete();\n      this.state.model = this._getModel(gl);\n      attributeManager.invalidateAll();\n    }\n\n    if (props.bounds !== oldProps.bounds) {\n      const oldMesh = this.state.mesh;\n      const mesh = this._createMesh();\n      this.state.model.setVertexCount(mesh.vertexCount);\n      for (const key in mesh) {\n        if (oldMesh && oldMesh[key] !== mesh[key]) {\n          attributeManager.invalidate(key);\n        }\n      }\n      this.setState({mesh, ...this._getCoordinateUniforms()});\n    } else if (props._imageCoordinateSystem !== oldProps._imageCoordinateSystem) {\n      this.setState(this._getCoordinateUniforms());\n    }\n  }\n\n  getPickingInfo(params: GetPickingInfoParams): PickingInfo {\n    const {image} = this.props;\n    const info: PickingInfo & {bitmap?: any} = params.info;\n\n    if (!info.color || !image) {\n      info.bitmap = null;\n      return info;\n    }\n\n    const {width, height} = image as Texture;\n\n    // Picking color doesn't represent object index in this layer\n    info.index = 0;\n\n    // Calculate uv and pixel in bitmap\n    const uv = unpackUVsFromRGB(info.color);\n\n    const pixel = [Math.floor(uv[0] * (width as number)), Math.floor(uv[1] * (height as number))];\n\n    info.bitmap = {\n      size: {width, height}, // Size of bitmap\n      uv, // Floating point precision in 0-1 range\n      pixel // Truncated to integer and scaled to pixel size\n    };\n\n    return info;\n  }\n\n  // Override base Layer multi-depth picking logic\n  disablePickingIndex() {\n    this.setState({disablePicking: true});\n  }\n\n  restorePickingColors() {\n    this.setState({disablePicking: false});\n  }\n\n  protected _updateAutoHighlight(info) {\n    super._updateAutoHighlight({\n      ...info,\n      color: this.encodePickingColor(0)\n    });\n  }\n\n  protected _createMesh() {\n    const {bounds} = this.props;\n\n    let normalizedBounds = bounds;\n    // bounds as [minX, minY, maxX, maxY]\n    if (isRectangularBounds(bounds)) {\n      /*\n        (minX0, maxY3) ---- (maxX2, maxY3)\n               |                  |\n               |                  |\n               |                  |\n        (minX0, minY1) ---- (maxX2, minY1)\n     */\n      normalizedBounds = [\n        [bounds[0], bounds[1]],\n        [bounds[0], bounds[3]],\n        [bounds[2], bounds[3]],\n        [bounds[2], bounds[1]]\n      ];\n    }\n\n    return createMesh(normalizedBounds, this.context.viewport.resolution);\n  }\n\n  protected _getModel(gl: WebGLRenderingContext): Model {\n    if (!gl) {\n      return null;\n    }\n\n    /*\n      0,0 --- 1,0\n       |       |\n      0,1 --- 1,1\n    */\n    return new Model(gl, {\n      ...this.getShaders(),\n      id: this.props.id,\n      geometry: new Geometry({\n        drawMode: GL.TRIANGLES,\n        vertexCount: 6\n      }),\n      isInstanced: false\n    });\n  }\n\n  draw(opts) {\n    const {uniforms, moduleParameters} = opts;\n    const {model, coordinateConversion, bounds, disablePicking} = this.state;\n    const {image, desaturate, transparentColor, tintColor} = this.props;\n\n    if (moduleParameters.pickingActive && disablePicking) {\n      return;\n    }\n\n    // // TODO fix zFighting\n    // Render the image\n    if (image && model) {\n      model\n        .setUniforms(uniforms)\n        .setUniforms({\n          bitmapTexture: image,\n          desaturate,\n          transparentColor: transparentColor.map(x => x / 255),\n          tintColor: tintColor.slice(0, 3).map(x => x / 255),\n          coordinateConversion,\n          bounds\n        })\n        .draw();\n    }\n  }\n\n  _getCoordinateUniforms() {\n    const {LNGLAT, CARTESIAN, DEFAULT} = COORDINATE_SYSTEM;\n    let {_imageCoordinateSystem: imageCoordinateSystem} = this.props;\n    if (imageCoordinateSystem !== DEFAULT) {\n      const {bounds} = this.props;\n      if (!isRectangularBounds(bounds)) {\n        throw new Error('_imageCoordinateSystem only supports rectangular bounds');\n      }\n\n      // The default behavior (linearly interpolated tex coords)\n      const defaultImageCoordinateSystem = this.context.viewport.resolution ? LNGLAT : CARTESIAN;\n      imageCoordinateSystem = imageCoordinateSystem === LNGLAT ? LNGLAT : CARTESIAN;\n\n      if (imageCoordinateSystem === LNGLAT && defaultImageCoordinateSystem === CARTESIAN) {\n        // LNGLAT in Mercator, e.g. display LNGLAT-encoded image in WebMercator projection\n        return {coordinateConversion: -1, bounds};\n      }\n      if (imageCoordinateSystem === CARTESIAN && defaultImageCoordinateSystem === LNGLAT) {\n        // Mercator in LNGLAT, e.g. display WebMercator encoded image in Globe projection\n        const bottomLeft = lngLatToWorld([bounds[0], bounds[1]]);\n        const topRight = lngLatToWorld([bounds[2], bounds[3]]);\n        return {\n          coordinateConversion: 1,\n          bounds: [bottomLeft[0], bottomLeft[1], topRight[0], topRight[1]]\n        };\n      }\n    }\n    return {\n      coordinateConversion: 0,\n      bounds: [0, 0, 0, 0]\n    };\n  }\n}\n\n/**\n * Decode uv floats from rgb bytes where b contains 4-bit fractions of uv\n * @param {number[]} color\n * @returns {number[]} uvs\n * https://stackoverflow.com/questions/30242013/glsl-compressing-packing-multiple-0-1-colours-var4-into-a-single-var4-variab\n */\nfunction unpackUVsFromRGB(color) {\n  const [u, v, fracUV] = color;\n  const vFrac = (fracUV & 0xf0) / 256;\n  const uFrac = (fracUV & 0x0f) / 16;\n  return [(u + uFrac) / 256, (v + vFrac) / 256];\n}\n\nfunction isRectangularBounds(\n  bounds: [number, number, number, number] | [Position, Position, Position, Position]\n): bounds is [number, number, number, number] {\n  return Number.isFinite(bounds[0]);\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n/* eslint-disable max-len */\n\n// Core Layers\nexport {default as ArcLayer} from './arc-layer/arc-layer';\nexport {default as BitmapLayer} from './bitmap-layer/bitmap-layer';\nexport {default as IconLayer} from './icon-layer/icon-layer';\nexport {default as LineLayer} from './line-layer/line-layer';\nexport {default as PointCloudLayer} from './point-cloud-layer/point-cloud-layer';\nexport {default as ScatterplotLayer} from './scatterplot-layer/scatterplot-layer';\nexport {default as ColumnLayer} from './column-layer/column-layer';\nexport {default as GridCellLayer} from './column-layer/grid-cell-layer';\nexport {default as PathLayer} from './path-layer/path-layer';\nexport {default as PolygonLayer} from './polygon-layer/polygon-layer';\nexport {default as GeoJsonLayer} from './geojson-layer/geojson-layer';\nexport {default as TextLayer} from './text-layer/text-layer';\nexport {default as SolidPolygonLayer} from './solid-polygon-layer/solid-polygon-layer';\n\n// Experimental layer exports\nexport {default as _MultiIconLayer} from './text-layer/multi-icon-layer/multi-icon-layer';\nexport {default as _TextBackgroundLayer} from './text-layer/text-background-layer/text-background-layer';\n\n// Types\nexport type {ArcLayerProps} from './arc-layer/arc-layer';\nexport type {BitmapLayerProps, BitmapBoundingBox} from './bitmap-layer/bitmap-layer';\nexport type {ColumnLayerProps} from './column-layer/column-layer';\nexport type {ScatterplotLayerProps} from './scatterplot-layer/scatterplot-layer';\nexport type {IconLayerProps} from './icon-layer/icon-layer';\nexport type {LineLayerProps} from './line-layer/line-layer';\nexport type {PolygonLayerProps} from './polygon-layer/polygon-layer';\nexport type {GeoJsonLayerProps} from './geojson-layer/geojson-layer';\nexport type {GridCellLayerProps} from './column-layer/grid-cell-layer';\nexport type {TextLayerProps} from './text-layer/text-layer';\nexport type {MultiIconLayerProps} from './text-layer/multi-icon-layer/multi-icon-layer';\nexport type {PointCloudLayerProps} from './point-cloud-layer/point-cloud-layer';\nexport type {TextBackgroundLayerProps} from './text-layer/text-background-layer/text-background-layer';\nexport type {PathLayerProps} from './path-layer/path-layer';\nexport type {SolidPolygonLayerProps} from './solid-polygon-layer/solid-polygon-layer';\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\ntype NestedArray<T> = (T | NestedArray<T>)[];\n\n/**\n * Flattens a nested array into a single level array,\n * or a single value into an array with one value\n * @example flatten([[1, [2]], [3], 4]) => [1, 2, 3, 4]\n * @example flatten(1) => [1]\n * @param array The array to flatten.\n * @param filter= - Optional predicate called on each `value` to\n *   determine if it should be included (pushed onto) the resulting array.\n * @return Returns the new flattened array (new array or `result` if provided)\n */\nexport function flatten<T>(\n  array: T | NestedArray<T>,\n  filter: (element: T) => boolean = () => true\n): T[] {\n  // Wrap single object in array\n  if (!Array.isArray(array)) {\n    return filter(array) ? [array] : [];\n  }\n  // Deep flatten and filter the array\n  return flattenArray(array, filter, []);\n}\n\n/** Deep flattens an array. Helper to `flatten`, see its parameters */\nfunction flattenArray<T>(array: NestedArray<T>, filter: (element: T) => boolean, result: T[]): T[] {\n  let index = -1;\n  while (++index < array.length) {\n    const value = array[index];\n    if (Array.isArray(value)) {\n      flattenArray(value, filter, result);\n    } else if (filter(value)) {\n      result.push(value);\n    }\n  }\n  return result;\n}\n\n/** Uses copyWithin to significantly speed up typed array value filling */\nexport function fillArray({target, source, start = 0, count = 1}) {\n  const length = source.length;\n  const total = count * length;\n  let copied = 0;\n  for (let i = start; copied < length; copied++) {\n    target[i++] = source[copied];\n  }\n\n  while (copied < total) {\n    // If we have copied less than half, copy everything we got\n    // else copy remaining in one operation\n    if (copied < total - copied) {\n      target.copyWithin(start + copied, start, start + copied);\n      copied *= 2;\n    } else {\n      target.copyWithin(start + copied, start, start + total - copied);\n      copied = total;\n    }\n  }\n\n  return target;\n}\n","import {TypedArray, TypedArrayConstructor} from '../types/types';\n\nexport type TypedArrayManagerOptions = {\n  overAlloc?: number;\n  poolSize?: number;\n};\n\nexport class TypedArrayManager {\n  private _pool: ArrayBuffer[] = [];\n  opts: {\n    overAlloc: number;\n    poolSize: number;\n  } = {overAlloc: 2, poolSize: 100};\n\n  constructor(options: TypedArrayManagerOptions = {}) {\n    this.setOptions(options);\n  }\n\n  setOptions(options: TypedArrayManagerOptions) {\n    Object.assign(this.opts, options);\n  }\n\n  allocate<T extends TypedArray>(\n    typedArray: T | null | undefined,\n    count: number,\n    {\n      size = 1,\n      type,\n      padding = 0,\n      copy = false,\n      initialize = false,\n      maxCount\n    }: {\n      size?: number;\n      type?: TypedArrayConstructor;\n      padding?: number;\n      copy?: boolean;\n      initialize?: boolean;\n      maxCount?: number;\n    }\n  ): T {\n    const Type =\n      type || (typedArray && (typedArray.constructor as TypedArrayConstructor)) || Float32Array;\n\n    const newSize = count * size + padding;\n    if (ArrayBuffer.isView(typedArray)) {\n      if (newSize <= typedArray.length) {\n        return typedArray;\n      }\n      if (newSize * typedArray.BYTES_PER_ELEMENT <= typedArray.buffer.byteLength) {\n        return new Type(typedArray.buffer, 0, newSize) as T;\n      }\n    }\n\n    let maxSize: number = Infinity;\n    if (maxCount) {\n      maxSize = maxCount * size + padding;\n    }\n\n    const newArray = this._allocate(Type, newSize, initialize, maxSize);\n\n    if (typedArray && copy) {\n      newArray.set(typedArray);\n    } else if (!initialize) {\n      // Hack - always initialize the first 4 elements. NaNs crash the Attribute validation\n      newArray.fill(0, 0, 4);\n    }\n\n    this._release(typedArray);\n    return newArray as T;\n  }\n\n  release(typedArray: TypedArray | null | undefined) {\n    this._release(typedArray);\n  }\n\n  private _allocate(\n    Type: TypedArrayConstructor,\n    size: number,\n    initialize: boolean,\n    maxSize: number\n  ): TypedArray {\n    // Allocate at least one element to ensure a valid buffer\n    let sizeToAllocate = Math.max(Math.ceil(size * this.opts.overAlloc), 1);\n    // Don't over allocate after certain specified number of elements\n    if (sizeToAllocate > maxSize) {\n      sizeToAllocate = maxSize;\n    }\n\n    // Check if available in pool\n    const pool = this._pool;\n    const byteLength = Type.BYTES_PER_ELEMENT * sizeToAllocate;\n    const i = pool.findIndex(b => b.byteLength >= byteLength);\n    if (i >= 0) {\n      // Create a new array using an existing buffer\n      const array = new Type(pool.splice(i, 1)[0], 0, sizeToAllocate);\n      if (initialize) {\n        // Viewing a buffer with a different type may create NaNs\n        array.fill(0);\n      }\n      return array;\n    }\n    return new Type(sizeToAllocate);\n  }\n\n  private _release(typedArray: TypedArray | null | undefined): void {\n    if (!ArrayBuffer.isView(typedArray)) {\n      return;\n    }\n    const pool = this._pool;\n    const {buffer} = typedArray;\n    // Save the buffer of the released array into the pool\n    // Sort buffers by size\n    // TODO - implement binary search?\n    const {byteLength} = buffer;\n    const i = pool.findIndex(b => b.byteLength >= byteLength);\n    if (i < 0) {\n      pool.push(buffer);\n    } else if (i > 0 || pool.length < this.opts.poolSize) {\n      pool.splice(i, 0, buffer);\n    }\n    if (pool.length > this.opts.poolSize) {\n      // Drop the smallest one\n      pool.shift();\n    }\n  }\n}\n\nexport default new TypedArrayManager();\n","function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {\n  try {\n    var info = gen[key](arg);\n    var value = info.value;\n  } catch (error) {\n    reject(error);\n    return;\n  }\n\n  if (info.done) {\n    resolve(value);\n  } else {\n    Promise.resolve(value).then(_next, _throw);\n  }\n}\n\nfunction _asyncToGenerator(fn) {\n  return function () {\n    var self = this,\n        args = arguments;\n    return new Promise(function (resolve, reject) {\n      var gen = fn.apply(self, args);\n\n      function _next(value) {\n        asyncGeneratorStep(gen, resolve, reject, _next, _throw, \"next\", value);\n      }\n\n      function _throw(err) {\n        asyncGeneratorStep(gen, resolve, reject, _next, _throw, \"throw\", err);\n      }\n\n      _next(undefined);\n    });\n  };\n}\n\nmodule.exports = _asyncToGenerator;","import * as glMatrix from \"./common.js\";\n/**\r\n * 4x4 Matrix<br>Format: column-major, when typed out it looks like row-major<br>The matrices are being post multiplied.\r\n * @module mat4\r\n */\n\n/**\r\n * Creates a new identity mat4\r\n *\r\n * @returns {mat4} a new 4x4 matrix\r\n */\n\nexport function create() {\n  var out = new glMatrix.ARRAY_TYPE(16);\n\n  if (glMatrix.ARRAY_TYPE != Float32Array) {\n    out[1] = 0;\n    out[2] = 0;\n    out[3] = 0;\n    out[4] = 0;\n    out[6] = 0;\n    out[7] = 0;\n    out[8] = 0;\n    out[9] = 0;\n    out[11] = 0;\n    out[12] = 0;\n    out[13] = 0;\n    out[14] = 0;\n  }\n\n  out[0] = 1;\n  out[5] = 1;\n  out[10] = 1;\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Creates a new mat4 initialized with values from an existing matrix\r\n *\r\n * @param {ReadonlyMat4} a matrix to clone\r\n * @returns {mat4} a new 4x4 matrix\r\n */\n\nexport function clone(a) {\n  var out = new glMatrix.ARRAY_TYPE(16);\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  out[3] = a[3];\n  out[4] = a[4];\n  out[5] = a[5];\n  out[6] = a[6];\n  out[7] = a[7];\n  out[8] = a[8];\n  out[9] = a[9];\n  out[10] = a[10];\n  out[11] = a[11];\n  out[12] = a[12];\n  out[13] = a[13];\n  out[14] = a[14];\n  out[15] = a[15];\n  return out;\n}\n/**\r\n * Copy the values from one mat4 to another\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the source matrix\r\n * @returns {mat4} out\r\n */\n\nexport function copy(out, a) {\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  out[3] = a[3];\n  out[4] = a[4];\n  out[5] = a[5];\n  out[6] = a[6];\n  out[7] = a[7];\n  out[8] = a[8];\n  out[9] = a[9];\n  out[10] = a[10];\n  out[11] = a[11];\n  out[12] = a[12];\n  out[13] = a[13];\n  out[14] = a[14];\n  out[15] = a[15];\n  return out;\n}\n/**\r\n * Create a new mat4 with the given values\r\n *\r\n * @param {Number} m00 Component in column 0, row 0 position (index 0)\r\n * @param {Number} m01 Component in column 0, row 1 position (index 1)\r\n * @param {Number} m02 Component in column 0, row 2 position (index 2)\r\n * @param {Number} m03 Component in column 0, row 3 position (index 3)\r\n * @param {Number} m10 Component in column 1, row 0 position (index 4)\r\n * @param {Number} m11 Component in column 1, row 1 position (index 5)\r\n * @param {Number} m12 Component in column 1, row 2 position (index 6)\r\n * @param {Number} m13 Component in column 1, row 3 position (index 7)\r\n * @param {Number} m20 Component in column 2, row 0 position (index 8)\r\n * @param {Number} m21 Component in column 2, row 1 position (index 9)\r\n * @param {Number} m22 Component in column 2, row 2 position (index 10)\r\n * @param {Number} m23 Component in column 2, row 3 position (index 11)\r\n * @param {Number} m30 Component in column 3, row 0 position (index 12)\r\n * @param {Number} m31 Component in column 3, row 1 position (index 13)\r\n * @param {Number} m32 Component in column 3, row 2 position (index 14)\r\n * @param {Number} m33 Component in column 3, row 3 position (index 15)\r\n * @returns {mat4} A new mat4\r\n */\n\nexport function fromValues(m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33) {\n  var out = new glMatrix.ARRAY_TYPE(16);\n  out[0] = m00;\n  out[1] = m01;\n  out[2] = m02;\n  out[3] = m03;\n  out[4] = m10;\n  out[5] = m11;\n  out[6] = m12;\n  out[7] = m13;\n  out[8] = m20;\n  out[9] = m21;\n  out[10] = m22;\n  out[11] = m23;\n  out[12] = m30;\n  out[13] = m31;\n  out[14] = m32;\n  out[15] = m33;\n  return out;\n}\n/**\r\n * Set the components of a mat4 to the given values\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {Number} m00 Component in column 0, row 0 position (index 0)\r\n * @param {Number} m01 Component in column 0, row 1 position (index 1)\r\n * @param {Number} m02 Component in column 0, row 2 position (index 2)\r\n * @param {Number} m03 Component in column 0, row 3 position (index 3)\r\n * @param {Number} m10 Component in column 1, row 0 position (index 4)\r\n * @param {Number} m11 Component in column 1, row 1 position (index 5)\r\n * @param {Number} m12 Component in column 1, row 2 position (index 6)\r\n * @param {Number} m13 Component in column 1, row 3 position (index 7)\r\n * @param {Number} m20 Component in column 2, row 0 position (index 8)\r\n * @param {Number} m21 Component in column 2, row 1 position (index 9)\r\n * @param {Number} m22 Component in column 2, row 2 position (index 10)\r\n * @param {Number} m23 Component in column 2, row 3 position (index 11)\r\n * @param {Number} m30 Component in column 3, row 0 position (index 12)\r\n * @param {Number} m31 Component in column 3, row 1 position (index 13)\r\n * @param {Number} m32 Component in column 3, row 2 position (index 14)\r\n * @param {Number} m33 Component in column 3, row 3 position (index 15)\r\n * @returns {mat4} out\r\n */\n\nexport function set(out, m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33) {\n  out[0] = m00;\n  out[1] = m01;\n  out[2] = m02;\n  out[3] = m03;\n  out[4] = m10;\n  out[5] = m11;\n  out[6] = m12;\n  out[7] = m13;\n  out[8] = m20;\n  out[9] = m21;\n  out[10] = m22;\n  out[11] = m23;\n  out[12] = m30;\n  out[13] = m31;\n  out[14] = m32;\n  out[15] = m33;\n  return out;\n}\n/**\r\n * Set a mat4 to the identity matrix\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @returns {mat4} out\r\n */\n\nexport function identity(out) {\n  out[0] = 1;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = 1;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[10] = 1;\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Transpose the values of a mat4\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the source matrix\r\n * @returns {mat4} out\r\n */\n\nexport function transpose(out, a) {\n  // If we are transposing ourselves we can skip a few steps but have to cache some values\n  if (out === a) {\n    var a01 = a[1],\n        a02 = a[2],\n        a03 = a[3];\n    var a12 = a[6],\n        a13 = a[7];\n    var a23 = a[11];\n    out[1] = a[4];\n    out[2] = a[8];\n    out[3] = a[12];\n    out[4] = a01;\n    out[6] = a[9];\n    out[7] = a[13];\n    out[8] = a02;\n    out[9] = a12;\n    out[11] = a[14];\n    out[12] = a03;\n    out[13] = a13;\n    out[14] = a23;\n  } else {\n    out[0] = a[0];\n    out[1] = a[4];\n    out[2] = a[8];\n    out[3] = a[12];\n    out[4] = a[1];\n    out[5] = a[5];\n    out[6] = a[9];\n    out[7] = a[13];\n    out[8] = a[2];\n    out[9] = a[6];\n    out[10] = a[10];\n    out[11] = a[14];\n    out[12] = a[3];\n    out[13] = a[7];\n    out[14] = a[11];\n    out[15] = a[15];\n  }\n\n  return out;\n}\n/**\r\n * Inverts a mat4\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the source matrix\r\n * @returns {mat4} out\r\n */\n\nexport function invert(out, a) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2],\n      a03 = a[3];\n  var a10 = a[4],\n      a11 = a[5],\n      a12 = a[6],\n      a13 = a[7];\n  var a20 = a[8],\n      a21 = a[9],\n      a22 = a[10],\n      a23 = a[11];\n  var a30 = a[12],\n      a31 = a[13],\n      a32 = a[14],\n      a33 = a[15];\n  var b00 = a00 * a11 - a01 * a10;\n  var b01 = a00 * a12 - a02 * a10;\n  var b02 = a00 * a13 - a03 * a10;\n  var b03 = a01 * a12 - a02 * a11;\n  var b04 = a01 * a13 - a03 * a11;\n  var b05 = a02 * a13 - a03 * a12;\n  var b06 = a20 * a31 - a21 * a30;\n  var b07 = a20 * a32 - a22 * a30;\n  var b08 = a20 * a33 - a23 * a30;\n  var b09 = a21 * a32 - a22 * a31;\n  var b10 = a21 * a33 - a23 * a31;\n  var b11 = a22 * a33 - a23 * a32; // Calculate the determinant\n\n  var det = b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06;\n\n  if (!det) {\n    return null;\n  }\n\n  det = 1.0 / det;\n  out[0] = (a11 * b11 - a12 * b10 + a13 * b09) * det;\n  out[1] = (a02 * b10 - a01 * b11 - a03 * b09) * det;\n  out[2] = (a31 * b05 - a32 * b04 + a33 * b03) * det;\n  out[3] = (a22 * b04 - a21 * b05 - a23 * b03) * det;\n  out[4] = (a12 * b08 - a10 * b11 - a13 * b07) * det;\n  out[5] = (a00 * b11 - a02 * b08 + a03 * b07) * det;\n  out[6] = (a32 * b02 - a30 * b05 - a33 * b01) * det;\n  out[7] = (a20 * b05 - a22 * b02 + a23 * b01) * det;\n  out[8] = (a10 * b10 - a11 * b08 + a13 * b06) * det;\n  out[9] = (a01 * b08 - a00 * b10 - a03 * b06) * det;\n  out[10] = (a30 * b04 - a31 * b02 + a33 * b00) * det;\n  out[11] = (a21 * b02 - a20 * b04 - a23 * b00) * det;\n  out[12] = (a11 * b07 - a10 * b09 - a12 * b06) * det;\n  out[13] = (a00 * b09 - a01 * b07 + a02 * b06) * det;\n  out[14] = (a31 * b01 - a30 * b03 - a32 * b00) * det;\n  out[15] = (a20 * b03 - a21 * b01 + a22 * b00) * det;\n  return out;\n}\n/**\r\n * Calculates the adjugate of a mat4\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the source matrix\r\n * @returns {mat4} out\r\n */\n\nexport function adjoint(out, a) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2],\n      a03 = a[3];\n  var a10 = a[4],\n      a11 = a[5],\n      a12 = a[6],\n      a13 = a[7];\n  var a20 = a[8],\n      a21 = a[9],\n      a22 = a[10],\n      a23 = a[11];\n  var a30 = a[12],\n      a31 = a[13],\n      a32 = a[14],\n      a33 = a[15];\n  out[0] = a11 * (a22 * a33 - a23 * a32) - a21 * (a12 * a33 - a13 * a32) + a31 * (a12 * a23 - a13 * a22);\n  out[1] = -(a01 * (a22 * a33 - a23 * a32) - a21 * (a02 * a33 - a03 * a32) + a31 * (a02 * a23 - a03 * a22));\n  out[2] = a01 * (a12 * a33 - a13 * a32) - a11 * (a02 * a33 - a03 * a32) + a31 * (a02 * a13 - a03 * a12);\n  out[3] = -(a01 * (a12 * a23 - a13 * a22) - a11 * (a02 * a23 - a03 * a22) + a21 * (a02 * a13 - a03 * a12));\n  out[4] = -(a10 * (a22 * a33 - a23 * a32) - a20 * (a12 * a33 - a13 * a32) + a30 * (a12 * a23 - a13 * a22));\n  out[5] = a00 * (a22 * a33 - a23 * a32) - a20 * (a02 * a33 - a03 * a32) + a30 * (a02 * a23 - a03 * a22);\n  out[6] = -(a00 * (a12 * a33 - a13 * a32) - a10 * (a02 * a33 - a03 * a32) + a30 * (a02 * a13 - a03 * a12));\n  out[7] = a00 * (a12 * a23 - a13 * a22) - a10 * (a02 * a23 - a03 * a22) + a20 * (a02 * a13 - a03 * a12);\n  out[8] = a10 * (a21 * a33 - a23 * a31) - a20 * (a11 * a33 - a13 * a31) + a30 * (a11 * a23 - a13 * a21);\n  out[9] = -(a00 * (a21 * a33 - a23 * a31) - a20 * (a01 * a33 - a03 * a31) + a30 * (a01 * a23 - a03 * a21));\n  out[10] = a00 * (a11 * a33 - a13 * a31) - a10 * (a01 * a33 - a03 * a31) + a30 * (a01 * a13 - a03 * a11);\n  out[11] = -(a00 * (a11 * a23 - a13 * a21) - a10 * (a01 * a23 - a03 * a21) + a20 * (a01 * a13 - a03 * a11));\n  out[12] = -(a10 * (a21 * a32 - a22 * a31) - a20 * (a11 * a32 - a12 * a31) + a30 * (a11 * a22 - a12 * a21));\n  out[13] = a00 * (a21 * a32 - a22 * a31) - a20 * (a01 * a32 - a02 * a31) + a30 * (a01 * a22 - a02 * a21);\n  out[14] = -(a00 * (a11 * a32 - a12 * a31) - a10 * (a01 * a32 - a02 * a31) + a30 * (a01 * a12 - a02 * a11));\n  out[15] = a00 * (a11 * a22 - a12 * a21) - a10 * (a01 * a22 - a02 * a21) + a20 * (a01 * a12 - a02 * a11);\n  return out;\n}\n/**\r\n * Calculates the determinant of a mat4\r\n *\r\n * @param {ReadonlyMat4} a the source matrix\r\n * @returns {Number} determinant of a\r\n */\n\nexport function determinant(a) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2],\n      a03 = a[3];\n  var a10 = a[4],\n      a11 = a[5],\n      a12 = a[6],\n      a13 = a[7];\n  var a20 = a[8],\n      a21 = a[9],\n      a22 = a[10],\n      a23 = a[11];\n  var a30 = a[12],\n      a31 = a[13],\n      a32 = a[14],\n      a33 = a[15];\n  var b00 = a00 * a11 - a01 * a10;\n  var b01 = a00 * a12 - a02 * a10;\n  var b02 = a00 * a13 - a03 * a10;\n  var b03 = a01 * a12 - a02 * a11;\n  var b04 = a01 * a13 - a03 * a11;\n  var b05 = a02 * a13 - a03 * a12;\n  var b06 = a20 * a31 - a21 * a30;\n  var b07 = a20 * a32 - a22 * a30;\n  var b08 = a20 * a33 - a23 * a30;\n  var b09 = a21 * a32 - a22 * a31;\n  var b10 = a21 * a33 - a23 * a31;\n  var b11 = a22 * a33 - a23 * a32; // Calculate the determinant\n\n  return b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06;\n}\n/**\r\n * Multiplies two mat4s\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the first operand\r\n * @param {ReadonlyMat4} b the second operand\r\n * @returns {mat4} out\r\n */\n\nexport function multiply(out, a, b) {\n  var a00 = a[0],\n      a01 = a[1],\n      a02 = a[2],\n      a03 = a[3];\n  var a10 = a[4],\n      a11 = a[5],\n      a12 = a[6],\n      a13 = a[7];\n  var a20 = a[8],\n      a21 = a[9],\n      a22 = a[10],\n      a23 = a[11];\n  var a30 = a[12],\n      a31 = a[13],\n      a32 = a[14],\n      a33 = a[15]; // Cache only the current line of the second matrix\n\n  var b0 = b[0],\n      b1 = b[1],\n      b2 = b[2],\n      b3 = b[3];\n  out[0] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;\n  out[1] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;\n  out[2] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;\n  out[3] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;\n  b0 = b[4];\n  b1 = b[5];\n  b2 = b[6];\n  b3 = b[7];\n  out[4] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;\n  out[5] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;\n  out[6] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;\n  out[7] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;\n  b0 = b[8];\n  b1 = b[9];\n  b2 = b[10];\n  b3 = b[11];\n  out[8] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;\n  out[9] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;\n  out[10] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;\n  out[11] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;\n  b0 = b[12];\n  b1 = b[13];\n  b2 = b[14];\n  b3 = b[15];\n  out[12] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;\n  out[13] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;\n  out[14] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;\n  out[15] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;\n  return out;\n}\n/**\r\n * Translate a mat4 by the given vector\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the matrix to translate\r\n * @param {ReadonlyVec3} v vector to translate by\r\n * @returns {mat4} out\r\n */\n\nexport function translate(out, a, v) {\n  var x = v[0],\n      y = v[1],\n      z = v[2];\n  var a00, a01, a02, a03;\n  var a10, a11, a12, a13;\n  var a20, a21, a22, a23;\n\n  if (a === out) {\n    out[12] = a[0] * x + a[4] * y + a[8] * z + a[12];\n    out[13] = a[1] * x + a[5] * y + a[9] * z + a[13];\n    out[14] = a[2] * x + a[6] * y + a[10] * z + a[14];\n    out[15] = a[3] * x + a[7] * y + a[11] * z + a[15];\n  } else {\n    a00 = a[0];\n    a01 = a[1];\n    a02 = a[2];\n    a03 = a[3];\n    a10 = a[4];\n    a11 = a[5];\n    a12 = a[6];\n    a13 = a[7];\n    a20 = a[8];\n    a21 = a[9];\n    a22 = a[10];\n    a23 = a[11];\n    out[0] = a00;\n    out[1] = a01;\n    out[2] = a02;\n    out[3] = a03;\n    out[4] = a10;\n    out[5] = a11;\n    out[6] = a12;\n    out[7] = a13;\n    out[8] = a20;\n    out[9] = a21;\n    out[10] = a22;\n    out[11] = a23;\n    out[12] = a00 * x + a10 * y + a20 * z + a[12];\n    out[13] = a01 * x + a11 * y + a21 * z + a[13];\n    out[14] = a02 * x + a12 * y + a22 * z + a[14];\n    out[15] = a03 * x + a13 * y + a23 * z + a[15];\n  }\n\n  return out;\n}\n/**\r\n * Scales the mat4 by the dimensions in the given vec3 not using vectorization\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the matrix to scale\r\n * @param {ReadonlyVec3} v the vec3 to scale the matrix by\r\n * @returns {mat4} out\r\n **/\n\nexport function scale(out, a, v) {\n  var x = v[0],\n      y = v[1],\n      z = v[2];\n  out[0] = a[0] * x;\n  out[1] = a[1] * x;\n  out[2] = a[2] * x;\n  out[3] = a[3] * x;\n  out[4] = a[4] * y;\n  out[5] = a[5] * y;\n  out[6] = a[6] * y;\n  out[7] = a[7] * y;\n  out[8] = a[8] * z;\n  out[9] = a[9] * z;\n  out[10] = a[10] * z;\n  out[11] = a[11] * z;\n  out[12] = a[12];\n  out[13] = a[13];\n  out[14] = a[14];\n  out[15] = a[15];\n  return out;\n}\n/**\r\n * Rotates a mat4 by the given angle around the given axis\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the matrix to rotate\r\n * @param {Number} rad the angle to rotate the matrix by\r\n * @param {ReadonlyVec3} axis the axis to rotate around\r\n * @returns {mat4} out\r\n */\n\nexport function rotate(out, a, rad, axis) {\n  var x = axis[0],\n      y = axis[1],\n      z = axis[2];\n  var len = Math.hypot(x, y, z);\n  var s, c, t;\n  var a00, a01, a02, a03;\n  var a10, a11, a12, a13;\n  var a20, a21, a22, a23;\n  var b00, b01, b02;\n  var b10, b11, b12;\n  var b20, b21, b22;\n\n  if (len < glMatrix.EPSILON) {\n    return null;\n  }\n\n  len = 1 / len;\n  x *= len;\n  y *= len;\n  z *= len;\n  s = Math.sin(rad);\n  c = Math.cos(rad);\n  t = 1 - c;\n  a00 = a[0];\n  a01 = a[1];\n  a02 = a[2];\n  a03 = a[3];\n  a10 = a[4];\n  a11 = a[5];\n  a12 = a[6];\n  a13 = a[7];\n  a20 = a[8];\n  a21 = a[9];\n  a22 = a[10];\n  a23 = a[11]; // Construct the elements of the rotation matrix\n\n  b00 = x * x * t + c;\n  b01 = y * x * t + z * s;\n  b02 = z * x * t - y * s;\n  b10 = x * y * t - z * s;\n  b11 = y * y * t + c;\n  b12 = z * y * t + x * s;\n  b20 = x * z * t + y * s;\n  b21 = y * z * t - x * s;\n  b22 = z * z * t + c; // Perform rotation-specific matrix multiplication\n\n  out[0] = a00 * b00 + a10 * b01 + a20 * b02;\n  out[1] = a01 * b00 + a11 * b01 + a21 * b02;\n  out[2] = a02 * b00 + a12 * b01 + a22 * b02;\n  out[3] = a03 * b00 + a13 * b01 + a23 * b02;\n  out[4] = a00 * b10 + a10 * b11 + a20 * b12;\n  out[5] = a01 * b10 + a11 * b11 + a21 * b12;\n  out[6] = a02 * b10 + a12 * b11 + a22 * b12;\n  out[7] = a03 * b10 + a13 * b11 + a23 * b12;\n  out[8] = a00 * b20 + a10 * b21 + a20 * b22;\n  out[9] = a01 * b20 + a11 * b21 + a21 * b22;\n  out[10] = a02 * b20 + a12 * b21 + a22 * b22;\n  out[11] = a03 * b20 + a13 * b21 + a23 * b22;\n\n  if (a !== out) {\n    // If the source and destination differ, copy the unchanged last row\n    out[12] = a[12];\n    out[13] = a[13];\n    out[14] = a[14];\n    out[15] = a[15];\n  }\n\n  return out;\n}\n/**\r\n * Rotates a matrix by the given angle around the X axis\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the matrix to rotate\r\n * @param {Number} rad the angle to rotate the matrix by\r\n * @returns {mat4} out\r\n */\n\nexport function rotateX(out, a, rad) {\n  var s = Math.sin(rad);\n  var c = Math.cos(rad);\n  var a10 = a[4];\n  var a11 = a[5];\n  var a12 = a[6];\n  var a13 = a[7];\n  var a20 = a[8];\n  var a21 = a[9];\n  var a22 = a[10];\n  var a23 = a[11];\n\n  if (a !== out) {\n    // If the source and destination differ, copy the unchanged rows\n    out[0] = a[0];\n    out[1] = a[1];\n    out[2] = a[2];\n    out[3] = a[3];\n    out[12] = a[12];\n    out[13] = a[13];\n    out[14] = a[14];\n    out[15] = a[15];\n  } // Perform axis-specific matrix multiplication\n\n\n  out[4] = a10 * c + a20 * s;\n  out[5] = a11 * c + a21 * s;\n  out[6] = a12 * c + a22 * s;\n  out[7] = a13 * c + a23 * s;\n  out[8] = a20 * c - a10 * s;\n  out[9] = a21 * c - a11 * s;\n  out[10] = a22 * c - a12 * s;\n  out[11] = a23 * c - a13 * s;\n  return out;\n}\n/**\r\n * Rotates a matrix by the given angle around the Y axis\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the matrix to rotate\r\n * @param {Number} rad the angle to rotate the matrix by\r\n * @returns {mat4} out\r\n */\n\nexport function rotateY(out, a, rad) {\n  var s = Math.sin(rad);\n  var c = Math.cos(rad);\n  var a00 = a[0];\n  var a01 = a[1];\n  var a02 = a[2];\n  var a03 = a[3];\n  var a20 = a[8];\n  var a21 = a[9];\n  var a22 = a[10];\n  var a23 = a[11];\n\n  if (a !== out) {\n    // If the source and destination differ, copy the unchanged rows\n    out[4] = a[4];\n    out[5] = a[5];\n    out[6] = a[6];\n    out[7] = a[7];\n    out[12] = a[12];\n    out[13] = a[13];\n    out[14] = a[14];\n    out[15] = a[15];\n  } // Perform axis-specific matrix multiplication\n\n\n  out[0] = a00 * c - a20 * s;\n  out[1] = a01 * c - a21 * s;\n  out[2] = a02 * c - a22 * s;\n  out[3] = a03 * c - a23 * s;\n  out[8] = a00 * s + a20 * c;\n  out[9] = a01 * s + a21 * c;\n  out[10] = a02 * s + a22 * c;\n  out[11] = a03 * s + a23 * c;\n  return out;\n}\n/**\r\n * Rotates a matrix by the given angle around the Z axis\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the matrix to rotate\r\n * @param {Number} rad the angle to rotate the matrix by\r\n * @returns {mat4} out\r\n */\n\nexport function rotateZ(out, a, rad) {\n  var s = Math.sin(rad);\n  var c = Math.cos(rad);\n  var a00 = a[0];\n  var a01 = a[1];\n  var a02 = a[2];\n  var a03 = a[3];\n  var a10 = a[4];\n  var a11 = a[5];\n  var a12 = a[6];\n  var a13 = a[7];\n\n  if (a !== out) {\n    // If the source and destination differ, copy the unchanged last row\n    out[8] = a[8];\n    out[9] = a[9];\n    out[10] = a[10];\n    out[11] = a[11];\n    out[12] = a[12];\n    out[13] = a[13];\n    out[14] = a[14];\n    out[15] = a[15];\n  } // Perform axis-specific matrix multiplication\n\n\n  out[0] = a00 * c + a10 * s;\n  out[1] = a01 * c + a11 * s;\n  out[2] = a02 * c + a12 * s;\n  out[3] = a03 * c + a13 * s;\n  out[4] = a10 * c - a00 * s;\n  out[5] = a11 * c - a01 * s;\n  out[6] = a12 * c - a02 * s;\n  out[7] = a13 * c - a03 * s;\n  return out;\n}\n/**\r\n * Creates a matrix from a vector translation\r\n * This is equivalent to (but much faster than):\r\n *\r\n *     mat4.identity(dest);\r\n *     mat4.translate(dest, dest, vec);\r\n *\r\n * @param {mat4} out mat4 receiving operation result\r\n * @param {ReadonlyVec3} v Translation vector\r\n * @returns {mat4} out\r\n */\n\nexport function fromTranslation(out, v) {\n  out[0] = 1;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = 1;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[10] = 1;\n  out[11] = 0;\n  out[12] = v[0];\n  out[13] = v[1];\n  out[14] = v[2];\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Creates a matrix from a vector scaling\r\n * This is equivalent to (but much faster than):\r\n *\r\n *     mat4.identity(dest);\r\n *     mat4.scale(dest, dest, vec);\r\n *\r\n * @param {mat4} out mat4 receiving operation result\r\n * @param {ReadonlyVec3} v Scaling vector\r\n * @returns {mat4} out\r\n */\n\nexport function fromScaling(out, v) {\n  out[0] = v[0];\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = v[1];\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[10] = v[2];\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Creates a matrix from a given angle around a given axis\r\n * This is equivalent to (but much faster than):\r\n *\r\n *     mat4.identity(dest);\r\n *     mat4.rotate(dest, dest, rad, axis);\r\n *\r\n * @param {mat4} out mat4 receiving operation result\r\n * @param {Number} rad the angle to rotate the matrix by\r\n * @param {ReadonlyVec3} axis the axis to rotate around\r\n * @returns {mat4} out\r\n */\n\nexport function fromRotation(out, rad, axis) {\n  var x = axis[0],\n      y = axis[1],\n      z = axis[2];\n  var len = Math.hypot(x, y, z);\n  var s, c, t;\n\n  if (len < glMatrix.EPSILON) {\n    return null;\n  }\n\n  len = 1 / len;\n  x *= len;\n  y *= len;\n  z *= len;\n  s = Math.sin(rad);\n  c = Math.cos(rad);\n  t = 1 - c; // Perform rotation-specific matrix multiplication\n\n  out[0] = x * x * t + c;\n  out[1] = y * x * t + z * s;\n  out[2] = z * x * t - y * s;\n  out[3] = 0;\n  out[4] = x * y * t - z * s;\n  out[5] = y * y * t + c;\n  out[6] = z * y * t + x * s;\n  out[7] = 0;\n  out[8] = x * z * t + y * s;\n  out[9] = y * z * t - x * s;\n  out[10] = z * z * t + c;\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Creates a matrix from the given angle around the X axis\r\n * This is equivalent to (but much faster than):\r\n *\r\n *     mat4.identity(dest);\r\n *     mat4.rotateX(dest, dest, rad);\r\n *\r\n * @param {mat4} out mat4 receiving operation result\r\n * @param {Number} rad the angle to rotate the matrix by\r\n * @returns {mat4} out\r\n */\n\nexport function fromXRotation(out, rad) {\n  var s = Math.sin(rad);\n  var c = Math.cos(rad); // Perform axis-specific matrix multiplication\n\n  out[0] = 1;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = c;\n  out[6] = s;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = -s;\n  out[10] = c;\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Creates a matrix from the given angle around the Y axis\r\n * This is equivalent to (but much faster than):\r\n *\r\n *     mat4.identity(dest);\r\n *     mat4.rotateY(dest, dest, rad);\r\n *\r\n * @param {mat4} out mat4 receiving operation result\r\n * @param {Number} rad the angle to rotate the matrix by\r\n * @returns {mat4} out\r\n */\n\nexport function fromYRotation(out, rad) {\n  var s = Math.sin(rad);\n  var c = Math.cos(rad); // Perform axis-specific matrix multiplication\n\n  out[0] = c;\n  out[1] = 0;\n  out[2] = -s;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = 1;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = s;\n  out[9] = 0;\n  out[10] = c;\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Creates a matrix from the given angle around the Z axis\r\n * This is equivalent to (but much faster than):\r\n *\r\n *     mat4.identity(dest);\r\n *     mat4.rotateZ(dest, dest, rad);\r\n *\r\n * @param {mat4} out mat4 receiving operation result\r\n * @param {Number} rad the angle to rotate the matrix by\r\n * @returns {mat4} out\r\n */\n\nexport function fromZRotation(out, rad) {\n  var s = Math.sin(rad);\n  var c = Math.cos(rad); // Perform axis-specific matrix multiplication\n\n  out[0] = c;\n  out[1] = s;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = -s;\n  out[5] = c;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[10] = 1;\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Creates a matrix from a quaternion rotation and vector translation\r\n * This is equivalent to (but much faster than):\r\n *\r\n *     mat4.identity(dest);\r\n *     mat4.translate(dest, vec);\r\n *     let quatMat = mat4.create();\r\n *     quat4.toMat4(quat, quatMat);\r\n *     mat4.multiply(dest, quatMat);\r\n *\r\n * @param {mat4} out mat4 receiving operation result\r\n * @param {quat4} q Rotation quaternion\r\n * @param {ReadonlyVec3} v Translation vector\r\n * @returns {mat4} out\r\n */\n\nexport function fromRotationTranslation(out, q, v) {\n  // Quaternion math\n  var x = q[0],\n      y = q[1],\n      z = q[2],\n      w = q[3];\n  var x2 = x + x;\n  var y2 = y + y;\n  var z2 = z + z;\n  var xx = x * x2;\n  var xy = x * y2;\n  var xz = x * z2;\n  var yy = y * y2;\n  var yz = y * z2;\n  var zz = z * z2;\n  var wx = w * x2;\n  var wy = w * y2;\n  var wz = w * z2;\n  out[0] = 1 - (yy + zz);\n  out[1] = xy + wz;\n  out[2] = xz - wy;\n  out[3] = 0;\n  out[4] = xy - wz;\n  out[5] = 1 - (xx + zz);\n  out[6] = yz + wx;\n  out[7] = 0;\n  out[8] = xz + wy;\n  out[9] = yz - wx;\n  out[10] = 1 - (xx + yy);\n  out[11] = 0;\n  out[12] = v[0];\n  out[13] = v[1];\n  out[14] = v[2];\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Creates a new mat4 from a dual quat.\r\n *\r\n * @param {mat4} out Matrix\r\n * @param {ReadonlyQuat2} a Dual Quaternion\r\n * @returns {mat4} mat4 receiving operation result\r\n */\n\nexport function fromQuat2(out, a) {\n  var translation = new glMatrix.ARRAY_TYPE(3);\n  var bx = -a[0],\n      by = -a[1],\n      bz = -a[2],\n      bw = a[3],\n      ax = a[4],\n      ay = a[5],\n      az = a[6],\n      aw = a[7];\n  var magnitude = bx * bx + by * by + bz * bz + bw * bw; //Only scale if it makes sense\n\n  if (magnitude > 0) {\n    translation[0] = (ax * bw + aw * bx + ay * bz - az * by) * 2 / magnitude;\n    translation[1] = (ay * bw + aw * by + az * bx - ax * bz) * 2 / magnitude;\n    translation[2] = (az * bw + aw * bz + ax * by - ay * bx) * 2 / magnitude;\n  } else {\n    translation[0] = (ax * bw + aw * bx + ay * bz - az * by) * 2;\n    translation[1] = (ay * bw + aw * by + az * bx - ax * bz) * 2;\n    translation[2] = (az * bw + aw * bz + ax * by - ay * bx) * 2;\n  }\n\n  fromRotationTranslation(out, a, translation);\n  return out;\n}\n/**\r\n * Returns the translation vector component of a transformation\r\n *  matrix. If a matrix is built with fromRotationTranslation,\r\n *  the returned vector will be the same as the translation vector\r\n *  originally supplied.\r\n * @param  {vec3} out Vector to receive translation component\r\n * @param  {ReadonlyMat4} mat Matrix to be decomposed (input)\r\n * @return {vec3} out\r\n */\n\nexport function getTranslation(out, mat) {\n  out[0] = mat[12];\n  out[1] = mat[13];\n  out[2] = mat[14];\n  return out;\n}\n/**\r\n * Returns the scaling factor component of a transformation\r\n *  matrix. If a matrix is built with fromRotationTranslationScale\r\n *  with a normalized Quaternion paramter, the returned vector will be\r\n *  the same as the scaling vector\r\n *  originally supplied.\r\n * @param  {vec3} out Vector to receive scaling factor component\r\n * @param  {ReadonlyMat4} mat Matrix to be decomposed (input)\r\n * @return {vec3} out\r\n */\n\nexport function getScaling(out, mat) {\n  var m11 = mat[0];\n  var m12 = mat[1];\n  var m13 = mat[2];\n  var m21 = mat[4];\n  var m22 = mat[5];\n  var m23 = mat[6];\n  var m31 = mat[8];\n  var m32 = mat[9];\n  var m33 = mat[10];\n  out[0] = Math.hypot(m11, m12, m13);\n  out[1] = Math.hypot(m21, m22, m23);\n  out[2] = Math.hypot(m31, m32, m33);\n  return out;\n}\n/**\r\n * Returns a quaternion representing the rotational component\r\n *  of a transformation matrix. If a matrix is built with\r\n *  fromRotationTranslation, the returned quaternion will be the\r\n *  same as the quaternion originally supplied.\r\n * @param {quat} out Quaternion to receive the rotation component\r\n * @param {ReadonlyMat4} mat Matrix to be decomposed (input)\r\n * @return {quat} out\r\n */\n\nexport function getRotation(out, mat) {\n  var scaling = new glMatrix.ARRAY_TYPE(3);\n  getScaling(scaling, mat);\n  var is1 = 1 / scaling[0];\n  var is2 = 1 / scaling[1];\n  var is3 = 1 / scaling[2];\n  var sm11 = mat[0] * is1;\n  var sm12 = mat[1] * is2;\n  var sm13 = mat[2] * is3;\n  var sm21 = mat[4] * is1;\n  var sm22 = mat[5] * is2;\n  var sm23 = mat[6] * is3;\n  var sm31 = mat[8] * is1;\n  var sm32 = mat[9] * is2;\n  var sm33 = mat[10] * is3;\n  var trace = sm11 + sm22 + sm33;\n  var S = 0;\n\n  if (trace > 0) {\n    S = Math.sqrt(trace + 1.0) * 2;\n    out[3] = 0.25 * S;\n    out[0] = (sm23 - sm32) / S;\n    out[1] = (sm31 - sm13) / S;\n    out[2] = (sm12 - sm21) / S;\n  } else if (sm11 > sm22 && sm11 > sm33) {\n    S = Math.sqrt(1.0 + sm11 - sm22 - sm33) * 2;\n    out[3] = (sm23 - sm32) / S;\n    out[0] = 0.25 * S;\n    out[1] = (sm12 + sm21) / S;\n    out[2] = (sm31 + sm13) / S;\n  } else if (sm22 > sm33) {\n    S = Math.sqrt(1.0 + sm22 - sm11 - sm33) * 2;\n    out[3] = (sm31 - sm13) / S;\n    out[0] = (sm12 + sm21) / S;\n    out[1] = 0.25 * S;\n    out[2] = (sm23 + sm32) / S;\n  } else {\n    S = Math.sqrt(1.0 + sm33 - sm11 - sm22) * 2;\n    out[3] = (sm12 - sm21) / S;\n    out[0] = (sm31 + sm13) / S;\n    out[1] = (sm23 + sm32) / S;\n    out[2] = 0.25 * S;\n  }\n\n  return out;\n}\n/**\r\n * Creates a matrix from a quaternion rotation, vector translation and vector scale\r\n * This is equivalent to (but much faster than):\r\n *\r\n *     mat4.identity(dest);\r\n *     mat4.translate(dest, vec);\r\n *     let quatMat = mat4.create();\r\n *     quat4.toMat4(quat, quatMat);\r\n *     mat4.multiply(dest, quatMat);\r\n *     mat4.scale(dest, scale)\r\n *\r\n * @param {mat4} out mat4 receiving operation result\r\n * @param {quat4} q Rotation quaternion\r\n * @param {ReadonlyVec3} v Translation vector\r\n * @param {ReadonlyVec3} s Scaling vector\r\n * @returns {mat4} out\r\n */\n\nexport function fromRotationTranslationScale(out, q, v, s) {\n  // Quaternion math\n  var x = q[0],\n      y = q[1],\n      z = q[2],\n      w = q[3];\n  var x2 = x + x;\n  var y2 = y + y;\n  var z2 = z + z;\n  var xx = x * x2;\n  var xy = x * y2;\n  var xz = x * z2;\n  var yy = y * y2;\n  var yz = y * z2;\n  var zz = z * z2;\n  var wx = w * x2;\n  var wy = w * y2;\n  var wz = w * z2;\n  var sx = s[0];\n  var sy = s[1];\n  var sz = s[2];\n  out[0] = (1 - (yy + zz)) * sx;\n  out[1] = (xy + wz) * sx;\n  out[2] = (xz - wy) * sx;\n  out[3] = 0;\n  out[4] = (xy - wz) * sy;\n  out[5] = (1 - (xx + zz)) * sy;\n  out[6] = (yz + wx) * sy;\n  out[7] = 0;\n  out[8] = (xz + wy) * sz;\n  out[9] = (yz - wx) * sz;\n  out[10] = (1 - (xx + yy)) * sz;\n  out[11] = 0;\n  out[12] = v[0];\n  out[13] = v[1];\n  out[14] = v[2];\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Creates a matrix from a quaternion rotation, vector translation and vector scale, rotating and scaling around the given origin\r\n * This is equivalent to (but much faster than):\r\n *\r\n *     mat4.identity(dest);\r\n *     mat4.translate(dest, vec);\r\n *     mat4.translate(dest, origin);\r\n *     let quatMat = mat4.create();\r\n *     quat4.toMat4(quat, quatMat);\r\n *     mat4.multiply(dest, quatMat);\r\n *     mat4.scale(dest, scale)\r\n *     mat4.translate(dest, negativeOrigin);\r\n *\r\n * @param {mat4} out mat4 receiving operation result\r\n * @param {quat4} q Rotation quaternion\r\n * @param {ReadonlyVec3} v Translation vector\r\n * @param {ReadonlyVec3} s Scaling vector\r\n * @param {ReadonlyVec3} o The origin vector around which to scale and rotate\r\n * @returns {mat4} out\r\n */\n\nexport function fromRotationTranslationScaleOrigin(out, q, v, s, o) {\n  // Quaternion math\n  var x = q[0],\n      y = q[1],\n      z = q[2],\n      w = q[3];\n  var x2 = x + x;\n  var y2 = y + y;\n  var z2 = z + z;\n  var xx = x * x2;\n  var xy = x * y2;\n  var xz = x * z2;\n  var yy = y * y2;\n  var yz = y * z2;\n  var zz = z * z2;\n  var wx = w * x2;\n  var wy = w * y2;\n  var wz = w * z2;\n  var sx = s[0];\n  var sy = s[1];\n  var sz = s[2];\n  var ox = o[0];\n  var oy = o[1];\n  var oz = o[2];\n  var out0 = (1 - (yy + zz)) * sx;\n  var out1 = (xy + wz) * sx;\n  var out2 = (xz - wy) * sx;\n  var out4 = (xy - wz) * sy;\n  var out5 = (1 - (xx + zz)) * sy;\n  var out6 = (yz + wx) * sy;\n  var out8 = (xz + wy) * sz;\n  var out9 = (yz - wx) * sz;\n  var out10 = (1 - (xx + yy)) * sz;\n  out[0] = out0;\n  out[1] = out1;\n  out[2] = out2;\n  out[3] = 0;\n  out[4] = out4;\n  out[5] = out5;\n  out[6] = out6;\n  out[7] = 0;\n  out[8] = out8;\n  out[9] = out9;\n  out[10] = out10;\n  out[11] = 0;\n  out[12] = v[0] + ox - (out0 * ox + out4 * oy + out8 * oz);\n  out[13] = v[1] + oy - (out1 * ox + out5 * oy + out9 * oz);\n  out[14] = v[2] + oz - (out2 * ox + out6 * oy + out10 * oz);\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Calculates a 4x4 matrix from the given quaternion\r\n *\r\n * @param {mat4} out mat4 receiving operation result\r\n * @param {ReadonlyQuat} q Quaternion to create matrix from\r\n *\r\n * @returns {mat4} out\r\n */\n\nexport function fromQuat(out, q) {\n  var x = q[0],\n      y = q[1],\n      z = q[2],\n      w = q[3];\n  var x2 = x + x;\n  var y2 = y + y;\n  var z2 = z + z;\n  var xx = x * x2;\n  var yx = y * x2;\n  var yy = y * y2;\n  var zx = z * x2;\n  var zy = z * y2;\n  var zz = z * z2;\n  var wx = w * x2;\n  var wy = w * y2;\n  var wz = w * z2;\n  out[0] = 1 - yy - zz;\n  out[1] = yx + wz;\n  out[2] = zx - wy;\n  out[3] = 0;\n  out[4] = yx - wz;\n  out[5] = 1 - xx - zz;\n  out[6] = zy + wx;\n  out[7] = 0;\n  out[8] = zx + wy;\n  out[9] = zy - wx;\n  out[10] = 1 - xx - yy;\n  out[11] = 0;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = 0;\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Generates a frustum matrix with the given bounds\r\n *\r\n * @param {mat4} out mat4 frustum matrix will be written into\r\n * @param {Number} left Left bound of the frustum\r\n * @param {Number} right Right bound of the frustum\r\n * @param {Number} bottom Bottom bound of the frustum\r\n * @param {Number} top Top bound of the frustum\r\n * @param {Number} near Near bound of the frustum\r\n * @param {Number} far Far bound of the frustum\r\n * @returns {mat4} out\r\n */\n\nexport function frustum(out, left, right, bottom, top, near, far) {\n  var rl = 1 / (right - left);\n  var tb = 1 / (top - bottom);\n  var nf = 1 / (near - far);\n  out[0] = near * 2 * rl;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = near * 2 * tb;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = (right + left) * rl;\n  out[9] = (top + bottom) * tb;\n  out[10] = (far + near) * nf;\n  out[11] = -1;\n  out[12] = 0;\n  out[13] = 0;\n  out[14] = far * near * 2 * nf;\n  out[15] = 0;\n  return out;\n}\n/**\r\n * Generates a perspective projection matrix with the given bounds.\r\n * Passing null/undefined/no value for far will generate infinite projection matrix.\r\n *\r\n * @param {mat4} out mat4 frustum matrix will be written into\r\n * @param {number} fovy Vertical field of view in radians\r\n * @param {number} aspect Aspect ratio. typically viewport width/height\r\n * @param {number} near Near bound of the frustum\r\n * @param {number} far Far bound of the frustum, can be null or Infinity\r\n * @returns {mat4} out\r\n */\n\nexport function perspective(out, fovy, aspect, near, far) {\n  var f = 1.0 / Math.tan(fovy / 2),\n      nf;\n  out[0] = f / aspect;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = f;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[11] = -1;\n  out[12] = 0;\n  out[13] = 0;\n  out[15] = 0;\n\n  if (far != null && far !== Infinity) {\n    nf = 1 / (near - far);\n    out[10] = (far + near) * nf;\n    out[14] = 2 * far * near * nf;\n  } else {\n    out[10] = -1;\n    out[14] = -2 * near;\n  }\n\n  return out;\n}\n/**\r\n * Generates a perspective projection matrix with the given field of view.\r\n * This is primarily useful for generating projection matrices to be used\r\n * with the still experiemental WebVR API.\r\n *\r\n * @param {mat4} out mat4 frustum matrix will be written into\r\n * @param {Object} fov Object containing the following values: upDegrees, downDegrees, leftDegrees, rightDegrees\r\n * @param {number} near Near bound of the frustum\r\n * @param {number} far Far bound of the frustum\r\n * @returns {mat4} out\r\n */\n\nexport function perspectiveFromFieldOfView(out, fov, near, far) {\n  var upTan = Math.tan(fov.upDegrees * Math.PI / 180.0);\n  var downTan = Math.tan(fov.downDegrees * Math.PI / 180.0);\n  var leftTan = Math.tan(fov.leftDegrees * Math.PI / 180.0);\n  var rightTan = Math.tan(fov.rightDegrees * Math.PI / 180.0);\n  var xScale = 2.0 / (leftTan + rightTan);\n  var yScale = 2.0 / (upTan + downTan);\n  out[0] = xScale;\n  out[1] = 0.0;\n  out[2] = 0.0;\n  out[3] = 0.0;\n  out[4] = 0.0;\n  out[5] = yScale;\n  out[6] = 0.0;\n  out[7] = 0.0;\n  out[8] = -((leftTan - rightTan) * xScale * 0.5);\n  out[9] = (upTan - downTan) * yScale * 0.5;\n  out[10] = far / (near - far);\n  out[11] = -1.0;\n  out[12] = 0.0;\n  out[13] = 0.0;\n  out[14] = far * near / (near - far);\n  out[15] = 0.0;\n  return out;\n}\n/**\r\n * Generates a orthogonal projection matrix with the given bounds\r\n *\r\n * @param {mat4} out mat4 frustum matrix will be written into\r\n * @param {number} left Left bound of the frustum\r\n * @param {number} right Right bound of the frustum\r\n * @param {number} bottom Bottom bound of the frustum\r\n * @param {number} top Top bound of the frustum\r\n * @param {number} near Near bound of the frustum\r\n * @param {number} far Far bound of the frustum\r\n * @returns {mat4} out\r\n */\n\nexport function ortho(out, left, right, bottom, top, near, far) {\n  var lr = 1 / (left - right);\n  var bt = 1 / (bottom - top);\n  var nf = 1 / (near - far);\n  out[0] = -2 * lr;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 0;\n  out[4] = 0;\n  out[5] = -2 * bt;\n  out[6] = 0;\n  out[7] = 0;\n  out[8] = 0;\n  out[9] = 0;\n  out[10] = 2 * nf;\n  out[11] = 0;\n  out[12] = (left + right) * lr;\n  out[13] = (top + bottom) * bt;\n  out[14] = (far + near) * nf;\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Generates a look-at matrix with the given eye position, focal point, and up axis.\r\n * If you want a matrix that actually makes an object look at another object, you should use targetTo instead.\r\n *\r\n * @param {mat4} out mat4 frustum matrix will be written into\r\n * @param {ReadonlyVec3} eye Position of the viewer\r\n * @param {ReadonlyVec3} center Point the viewer is looking at\r\n * @param {ReadonlyVec3} up vec3 pointing up\r\n * @returns {mat4} out\r\n */\n\nexport function lookAt(out, eye, center, up) {\n  var x0, x1, x2, y0, y1, y2, z0, z1, z2, len;\n  var eyex = eye[0];\n  var eyey = eye[1];\n  var eyez = eye[2];\n  var upx = up[0];\n  var upy = up[1];\n  var upz = up[2];\n  var centerx = center[0];\n  var centery = center[1];\n  var centerz = center[2];\n\n  if (Math.abs(eyex - centerx) < glMatrix.EPSILON && Math.abs(eyey - centery) < glMatrix.EPSILON && Math.abs(eyez - centerz) < glMatrix.EPSILON) {\n    return identity(out);\n  }\n\n  z0 = eyex - centerx;\n  z1 = eyey - centery;\n  z2 = eyez - centerz;\n  len = 1 / Math.hypot(z0, z1, z2);\n  z0 *= len;\n  z1 *= len;\n  z2 *= len;\n  x0 = upy * z2 - upz * z1;\n  x1 = upz * z0 - upx * z2;\n  x2 = upx * z1 - upy * z0;\n  len = Math.hypot(x0, x1, x2);\n\n  if (!len) {\n    x0 = 0;\n    x1 = 0;\n    x2 = 0;\n  } else {\n    len = 1 / len;\n    x0 *= len;\n    x1 *= len;\n    x2 *= len;\n  }\n\n  y0 = z1 * x2 - z2 * x1;\n  y1 = z2 * x0 - z0 * x2;\n  y2 = z0 * x1 - z1 * x0;\n  len = Math.hypot(y0, y1, y2);\n\n  if (!len) {\n    y0 = 0;\n    y1 = 0;\n    y2 = 0;\n  } else {\n    len = 1 / len;\n    y0 *= len;\n    y1 *= len;\n    y2 *= len;\n  }\n\n  out[0] = x0;\n  out[1] = y0;\n  out[2] = z0;\n  out[3] = 0;\n  out[4] = x1;\n  out[5] = y1;\n  out[6] = z1;\n  out[7] = 0;\n  out[8] = x2;\n  out[9] = y2;\n  out[10] = z2;\n  out[11] = 0;\n  out[12] = -(x0 * eyex + x1 * eyey + x2 * eyez);\n  out[13] = -(y0 * eyex + y1 * eyey + y2 * eyez);\n  out[14] = -(z0 * eyex + z1 * eyey + z2 * eyez);\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Generates a matrix that makes something look at something else.\r\n *\r\n * @param {mat4} out mat4 frustum matrix will be written into\r\n * @param {ReadonlyVec3} eye Position of the viewer\r\n * @param {ReadonlyVec3} center Point the viewer is looking at\r\n * @param {ReadonlyVec3} up vec3 pointing up\r\n * @returns {mat4} out\r\n */\n\nexport function targetTo(out, eye, target, up) {\n  var eyex = eye[0],\n      eyey = eye[1],\n      eyez = eye[2],\n      upx = up[0],\n      upy = up[1],\n      upz = up[2];\n  var z0 = eyex - target[0],\n      z1 = eyey - target[1],\n      z2 = eyez - target[2];\n  var len = z0 * z0 + z1 * z1 + z2 * z2;\n\n  if (len > 0) {\n    len = 1 / Math.sqrt(len);\n    z0 *= len;\n    z1 *= len;\n    z2 *= len;\n  }\n\n  var x0 = upy * z2 - upz * z1,\n      x1 = upz * z0 - upx * z2,\n      x2 = upx * z1 - upy * z0;\n  len = x0 * x0 + x1 * x1 + x2 * x2;\n\n  if (len > 0) {\n    len = 1 / Math.sqrt(len);\n    x0 *= len;\n    x1 *= len;\n    x2 *= len;\n  }\n\n  out[0] = x0;\n  out[1] = x1;\n  out[2] = x2;\n  out[3] = 0;\n  out[4] = z1 * x2 - z2 * x1;\n  out[5] = z2 * x0 - z0 * x2;\n  out[6] = z0 * x1 - z1 * x0;\n  out[7] = 0;\n  out[8] = z0;\n  out[9] = z1;\n  out[10] = z2;\n  out[11] = 0;\n  out[12] = eyex;\n  out[13] = eyey;\n  out[14] = eyez;\n  out[15] = 1;\n  return out;\n}\n/**\r\n * Returns a string representation of a mat4\r\n *\r\n * @param {ReadonlyMat4} a matrix to represent as a string\r\n * @returns {String} string representation of the matrix\r\n */\n\nexport function str(a) {\n  return \"mat4(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \", \" + a[3] + \", \" + a[4] + \", \" + a[5] + \", \" + a[6] + \", \" + a[7] + \", \" + a[8] + \", \" + a[9] + \", \" + a[10] + \", \" + a[11] + \", \" + a[12] + \", \" + a[13] + \", \" + a[14] + \", \" + a[15] + \")\";\n}\n/**\r\n * Returns Frobenius norm of a mat4\r\n *\r\n * @param {ReadonlyMat4} a the matrix to calculate Frobenius norm of\r\n * @returns {Number} Frobenius norm\r\n */\n\nexport function frob(a) {\n  return Math.hypot(a[0], a[1], a[2], a[3], a[4], a[5], a[6], a[7], a[8], a[9], a[10], a[11], a[12], a[13], a[14], a[15]);\n}\n/**\r\n * Adds two mat4's\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the first operand\r\n * @param {ReadonlyMat4} b the second operand\r\n * @returns {mat4} out\r\n */\n\nexport function add(out, a, b) {\n  out[0] = a[0] + b[0];\n  out[1] = a[1] + b[1];\n  out[2] = a[2] + b[2];\n  out[3] = a[3] + b[3];\n  out[4] = a[4] + b[4];\n  out[5] = a[5] + b[5];\n  out[6] = a[6] + b[6];\n  out[7] = a[7] + b[7];\n  out[8] = a[8] + b[8];\n  out[9] = a[9] + b[9];\n  out[10] = a[10] + b[10];\n  out[11] = a[11] + b[11];\n  out[12] = a[12] + b[12];\n  out[13] = a[13] + b[13];\n  out[14] = a[14] + b[14];\n  out[15] = a[15] + b[15];\n  return out;\n}\n/**\r\n * Subtracts matrix b from matrix a\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the first operand\r\n * @param {ReadonlyMat4} b the second operand\r\n * @returns {mat4} out\r\n */\n\nexport function subtract(out, a, b) {\n  out[0] = a[0] - b[0];\n  out[1] = a[1] - b[1];\n  out[2] = a[2] - b[2];\n  out[3] = a[3] - b[3];\n  out[4] = a[4] - b[4];\n  out[5] = a[5] - b[5];\n  out[6] = a[6] - b[6];\n  out[7] = a[7] - b[7];\n  out[8] = a[8] - b[8];\n  out[9] = a[9] - b[9];\n  out[10] = a[10] - b[10];\n  out[11] = a[11] - b[11];\n  out[12] = a[12] - b[12];\n  out[13] = a[13] - b[13];\n  out[14] = a[14] - b[14];\n  out[15] = a[15] - b[15];\n  return out;\n}\n/**\r\n * Multiply each element of the matrix by a scalar.\r\n *\r\n * @param {mat4} out the receiving matrix\r\n * @param {ReadonlyMat4} a the matrix to scale\r\n * @param {Number} b amount to scale the matrix's elements by\r\n * @returns {mat4} out\r\n */\n\nexport function multiplyScalar(out, a, b) {\n  out[0] = a[0] * b;\n  out[1] = a[1] * b;\n  out[2] = a[2] * b;\n  out[3] = a[3] * b;\n  out[4] = a[4] * b;\n  out[5] = a[5] * b;\n  out[6] = a[6] * b;\n  out[7] = a[7] * b;\n  out[8] = a[8] * b;\n  out[9] = a[9] * b;\n  out[10] = a[10] * b;\n  out[11] = a[11] * b;\n  out[12] = a[12] * b;\n  out[13] = a[13] * b;\n  out[14] = a[14] * b;\n  out[15] = a[15] * b;\n  return out;\n}\n/**\r\n * Adds two mat4's after multiplying each element of the second operand by a scalar value.\r\n *\r\n * @param {mat4} out the receiving vector\r\n * @param {ReadonlyMat4} a the first operand\r\n * @param {ReadonlyMat4} b the second operand\r\n * @param {Number} scale the amount to scale b's elements by before adding\r\n * @returns {mat4} out\r\n */\n\nexport function multiplyScalarAndAdd(out, a, b, scale) {\n  out[0] = a[0] + b[0] * scale;\n  out[1] = a[1] + b[1] * scale;\n  out[2] = a[2] + b[2] * scale;\n  out[3] = a[3] + b[3] * scale;\n  out[4] = a[4] + b[4] * scale;\n  out[5] = a[5] + b[5] * scale;\n  out[6] = a[6] + b[6] * scale;\n  out[7] = a[7] + b[7] * scale;\n  out[8] = a[8] + b[8] * scale;\n  out[9] = a[9] + b[9] * scale;\n  out[10] = a[10] + b[10] * scale;\n  out[11] = a[11] + b[11] * scale;\n  out[12] = a[12] + b[12] * scale;\n  out[13] = a[13] + b[13] * scale;\n  out[14] = a[14] + b[14] * scale;\n  out[15] = a[15] + b[15] * scale;\n  return out;\n}\n/**\r\n * Returns whether or not the matrices have exactly the same elements in the same position (when compared with ===)\r\n *\r\n * @param {ReadonlyMat4} a The first matrix.\r\n * @param {ReadonlyMat4} b The second matrix.\r\n * @returns {Boolean} True if the matrices are equal, false otherwise.\r\n */\n\nexport function exactEquals(a, b) {\n  return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3] && a[4] === b[4] && a[5] === b[5] && a[6] === b[6] && a[7] === b[7] && a[8] === b[8] && a[9] === b[9] && a[10] === b[10] && a[11] === b[11] && a[12] === b[12] && a[13] === b[13] && a[14] === b[14] && a[15] === b[15];\n}\n/**\r\n * Returns whether or not the matrices have approximately the same elements in the same position.\r\n *\r\n * @param {ReadonlyMat4} a The first matrix.\r\n * @param {ReadonlyMat4} b The second matrix.\r\n * @returns {Boolean} True if the matrices are equal, false otherwise.\r\n */\n\nexport function equals(a, b) {\n  var a0 = a[0],\n      a1 = a[1],\n      a2 = a[2],\n      a3 = a[3];\n  var a4 = a[4],\n      a5 = a[5],\n      a6 = a[6],\n      a7 = a[7];\n  var a8 = a[8],\n      a9 = a[9],\n      a10 = a[10],\n      a11 = a[11];\n  var a12 = a[12],\n      a13 = a[13],\n      a14 = a[14],\n      a15 = a[15];\n  var b0 = b[0],\n      b1 = b[1],\n      b2 = b[2],\n      b3 = b[3];\n  var b4 = b[4],\n      b5 = b[5],\n      b6 = b[6],\n      b7 = b[7];\n  var b8 = b[8],\n      b9 = b[9],\n      b10 = b[10],\n      b11 = b[11];\n  var b12 = b[12],\n      b13 = b[13],\n      b14 = b[14],\n      b15 = b[15];\n  return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3)) && Math.abs(a4 - b4) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a4), Math.abs(b4)) && Math.abs(a5 - b5) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a5), Math.abs(b5)) && Math.abs(a6 - b6) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a6), Math.abs(b6)) && Math.abs(a7 - b7) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a7), Math.abs(b7)) && Math.abs(a8 - b8) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a8), Math.abs(b8)) && Math.abs(a9 - b9) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a9), Math.abs(b9)) && Math.abs(a10 - b10) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a10), Math.abs(b10)) && Math.abs(a11 - b11) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a11), Math.abs(b11)) && Math.abs(a12 - b12) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a12), Math.abs(b12)) && Math.abs(a13 - b13) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a13), Math.abs(b13)) && Math.abs(a14 - b14) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a14), Math.abs(b14)) && Math.abs(a15 - b15) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a15), Math.abs(b15));\n}\n/**\r\n * Alias for {@link mat4.multiply}\r\n * @function\r\n */\n\nexport var mul = multiply;\n/**\r\n * Alias for {@link mat4.subtract}\r\n * @function\r\n */\n\nexport var sub = subtract;","var g;\n\n// This works in non-strict mode\ng = (function() {\n\treturn this;\n})();\n\ntry {\n\t// This works if eval is allowed (see CSP)\n\tg = g || new Function(\"return this\")();\n} catch (e) {\n\t// This works if the window reference is available\n\tif (typeof window === \"object\") g = window;\n}\n\n// g can still be undefined, but nothing to do about it...\n// We return undefined, instead of nothing here, so it's\n// easier to handle this case. if(!global) { ...}\n\nmodule.exports = g;\n","const globals = {\n  self: typeof self !== 'undefined' && self,\n  window: typeof window !== 'undefined' && window,\n  global: typeof global !== 'undefined' && global,\n  document: typeof document !== 'undefined' && document\n};\nconst self_ = globals.self || globals.window || globals.global || {};\nconst window_ = globals.window || globals.self || globals.global || {};\nconst global_ = globals.global || globals.self || globals.window || {};\nconst document_ = globals.document || {};\nexport { self_ as self, window_ as window, global_ as global, document_ as document };\nexport const isBrowser = Boolean(typeof process !== 'object' || String(process) !== '[object process]' || process.browser);\nexport const isWorker = typeof importScripts === 'function';\nconst matches = typeof process !== 'undefined' && process.version && /v([0-9]*)/.exec(process.version);\nexport const nodeVersion = matches && parseFloat(matches[1]) || 0;\n//# sourceMappingURL=globals.js.map","import GL from '@luma.gl/constants';\nimport Pass from './pass';\nimport {clear, setParameters, withParameters, cssToDeviceRatio} from '@luma.gl/core';\n\nimport type {Framebuffer} from '@luma.gl/core';\nimport type Viewport from '../viewports/viewport';\nimport type View from '../views/view';\nimport type Layer from '../lib/layer';\nimport type {Effect} from '../lib/effect';\n\nexport type Rect = {x: number; y: number; width: number; height: number};\n\nexport type LayersPassRenderOptions = {\n  target?: Framebuffer;\n  pass: string;\n  layers: Layer[];\n  viewports: Viewport[];\n  onViewportActive: (viewport: Viewport) => void;\n  cullRect?: Rect;\n  views?: Record<string, View>;\n  effects?: Effect[];\n  /** If true, recalculates render index (z) from 0. Set to false if a stack of layers are rendered in multiple passes. */\n  clearStack?: boolean;\n  clearCanvas?: boolean;\n  layerFilter?: (context: FilterContext) => boolean;\n  moduleParameters?: any;\n};\n\ntype DrawLayerParameters = {\n  shouldDrawLayer: boolean;\n  layerRenderIndex?: number;\n  moduleParameters?: any;\n  layerParameters?: any;\n};\n\nexport type FilterContext = {\n  layer: Layer;\n  viewport: Viewport;\n  isPicking: boolean;\n  renderPass: string;\n  cullRect?: Rect;\n};\n\nexport type RenderStats = {\n  totalCount: number;\n  visibleCount: number;\n  compositeCount: number;\n  pickableCount: number;\n};\n\nexport default class LayersPass extends Pass {\n  _lastRenderIndex: number = -1;\n\n  render(options: LayersPassRenderOptions): any {\n    const gl = this.gl;\n\n    setParameters(gl, {framebuffer: options.target});\n    return this._drawLayers(options);\n  }\n\n  // Draw a list of layers in a list of viewports\n  private _drawLayers(options: LayersPassRenderOptions) {\n    const {\n      target,\n      moduleParameters,\n      viewports,\n      views,\n      onViewportActive,\n      clearStack = true,\n      clearCanvas = true\n    } = options;\n    options.pass = options.pass || 'unknown';\n\n    const gl = this.gl;\n    if (clearCanvas) {\n      clearGLCanvas(gl);\n    }\n\n    if (clearStack) {\n      this._lastRenderIndex = -1;\n    }\n\n    const renderStats: RenderStats[] = [];\n\n    for (const viewport of viewports) {\n      const view = views && views[viewport.id];\n\n      // Update context to point to this viewport\n      onViewportActive(viewport);\n\n      const drawLayerParams = this._getDrawLayerParams(viewport, options);\n\n      // render this viewport\n      // @ts-expect-error\n      const subViewports = viewport.subViewports || [viewport];\n      for (const subViewport of subViewports) {\n        const stats = this._drawLayersInViewport(\n          gl,\n          {\n            target,\n            moduleParameters,\n            viewport: subViewport,\n            view,\n            pass: options.pass,\n            layers: options.layers\n          },\n          drawLayerParams\n        );\n        renderStats.push(stats);\n      }\n    }\n    return renderStats;\n  }\n\n  // Resolve the parameters needed to draw each layer\n  // When a viewport contains multiple subviewports (e.g. repeated web mercator map),\n  // this is only done once for the parent viewport\n  private _getDrawLayerParams(\n    viewport: Viewport,\n    {layers, pass, layerFilter, cullRect, effects, moduleParameters}: LayersPassRenderOptions\n  ): DrawLayerParameters[] {\n    const drawLayerParams: DrawLayerParameters[] = [];\n    const indexResolver = layerIndexResolver(this._lastRenderIndex + 1);\n    const drawContext: FilterContext = {\n      layer: layers[0],\n      viewport,\n      isPicking: pass.startsWith('picking'),\n      renderPass: pass,\n      cullRect\n    };\n    const layerFilterCache = {};\n    for (let layerIndex = 0; layerIndex < layers.length; layerIndex++) {\n      const layer = layers[layerIndex];\n      // Check if we should draw layer\n      const shouldDrawLayer = this._shouldDrawLayer(\n        layer,\n        drawContext,\n        layerFilter,\n        layerFilterCache\n      );\n\n      const layerParam: DrawLayerParameters = {\n        shouldDrawLayer\n      };\n\n      if (shouldDrawLayer) {\n        // This is the \"logical\" index for ordering this layer in the stack\n        // used to calculate polygon offsets\n        // It can be the same as another layer\n        layerParam.layerRenderIndex = indexResolver(layer, shouldDrawLayer);\n\n        layerParam.moduleParameters = this._getModuleParameters(\n          layer,\n          effects,\n          pass,\n          moduleParameters\n        );\n        layerParam.layerParameters = this.getLayerParameters(layer, layerIndex, viewport);\n      }\n      drawLayerParams[layerIndex] = layerParam;\n    }\n    return drawLayerParams;\n  }\n\n  // Draws a list of layers in one viewport\n  // TODO - when picking we could completely skip rendering viewports that dont\n  // intersect with the picking rect\n  /* eslint-disable max-depth, max-statements */\n  private _drawLayersInViewport(\n    gl,\n    {layers, moduleParameters: globalModuleParameters, pass, target, viewport, view},\n    drawLayerParams\n  ): RenderStats {\n    const glViewport = getGLViewport(gl, {\n      moduleParameters: globalModuleParameters,\n      target,\n      viewport\n    });\n\n    if (view && view.props.clear) {\n      const clearOpts = view.props.clear === true ? {color: true, depth: true} : view.props.clear;\n      withParameters(\n        gl,\n        {\n          scissorTest: true,\n          scissor: glViewport\n        },\n        () => clear(gl, clearOpts)\n      );\n    }\n\n    // render layers in normal colors\n    const renderStatus = {\n      totalCount: layers.length,\n      visibleCount: 0,\n      compositeCount: 0,\n      pickableCount: 0\n    };\n\n    setParameters(gl, {viewport: glViewport});\n\n    // render layers in normal colors\n    for (let layerIndex = 0; layerIndex < layers.length; layerIndex++) {\n      const layer = layers[layerIndex];\n      const {shouldDrawLayer, layerRenderIndex, moduleParameters, layerParameters} =\n        drawLayerParams[layerIndex];\n\n      // Calculate stats\n      if (shouldDrawLayer && layer.props.pickable) {\n        renderStatus.pickableCount++;\n      }\n      if (layer.isComposite) {\n        renderStatus.compositeCount++;\n      } else if (shouldDrawLayer) {\n        // Draw the layer\n        renderStatus.visibleCount++;\n\n        this._lastRenderIndex = Math.max(this._lastRenderIndex, layerRenderIndex);\n\n        // overwrite layer.context.viewport with the sub viewport\n        moduleParameters.viewport = viewport;\n\n        try {\n          layer._drawLayer({\n            moduleParameters,\n            uniforms: {layerIndex: layerRenderIndex},\n            parameters: layerParameters\n          });\n        } catch (err) {\n          layer.raiseError(err, `drawing ${layer} to ${pass}`);\n        }\n      }\n    }\n\n    return renderStatus;\n  }\n  /* eslint-enable max-depth, max-statements */\n\n  /* Methods for subclass overrides */\n  protected shouldDrawLayer(layer: Layer): boolean {\n    return true;\n  }\n\n  protected getModuleParameters(layer: Layer, effects?: Effect[]): any {\n    return null;\n  }\n\n  protected getLayerParameters(layer: Layer, layerIndex: number, viewport: Viewport): any {\n    return layer.props.parameters;\n  }\n\n  /* Private */\n  private _shouldDrawLayer(\n    layer: Layer,\n    drawContext: FilterContext,\n    layerFilter: ((params: FilterContext) => boolean) | undefined,\n    layerFilterCache: Record<string, boolean>\n  ) {\n    const shouldDrawLayer = layer.props.visible && this.shouldDrawLayer(layer);\n\n    if (!shouldDrawLayer) {\n      return false;\n    }\n\n    drawContext.layer = layer;\n\n    let parent = layer.parent as Layer;\n    while (parent) {\n      // @ts-ignore\n      if (!parent.props.visible || !parent.filterSubLayer(drawContext)) {\n        return false;\n      }\n      drawContext.layer = parent;\n      parent = parent.parent as Layer;\n    }\n\n    if (layerFilter) {\n      const rootLayerId = drawContext.layer.id;\n      if (!(rootLayerId in layerFilterCache)) {\n        layerFilterCache[rootLayerId] = layerFilter(drawContext);\n      }\n      if (!layerFilterCache[rootLayerId]) {\n        return false;\n      }\n    }\n\n    // If a layer is drawn, update its viewportChanged flag\n    layer.activateViewport(drawContext.viewport);\n\n    return true;\n  }\n\n  private _getModuleParameters(\n    layer: Layer,\n    effects: Effect[] | undefined,\n    pass: string,\n    overrides: any\n  ): any {\n    const moduleParameters = Object.assign(\n      Object.create(layer.internalState?.propsInTransition || layer.props),\n      {\n        autoWrapLongitude: layer.wrapLongitude,\n        // @ts-ignore\n        viewport: layer.context.viewport,\n        // @ts-ignore\n        mousePosition: layer.context.mousePosition,\n        pickingActive: 0,\n        devicePixelRatio: cssToDeviceRatio(this.gl)\n      }\n    );\n\n    if (effects) {\n      for (const effect of effects) {\n        Object.assign(moduleParameters, effect.getModuleParameters?.(layer));\n      }\n    }\n\n    return Object.assign(moduleParameters, this.getModuleParameters(layer, effects), overrides);\n  }\n}\n\n// If the _index prop is defined, return a layer index that's relative to its parent\n// Otherwise return the index of the layer among all rendered layers\n// This is done recursively, i.e. if the user overrides a layer's default index,\n// all its descendants will be resolved relative to that index.\n// This implementation assumes that parent layers always appear before its children\n// which is true if the layer array comes from the LayerManager\nexport function layerIndexResolver(\n  startIndex: number = 0,\n  layerIndices: Record<string, number> = {}\n): (layer: Layer, isDrawn: boolean) => number {\n  const resolvers = {};\n\n  const resolveLayerIndex = (layer, isDrawn) => {\n    const indexOverride = layer.props._offset;\n    const layerId = layer.id;\n    const parentId = layer.parent && layer.parent.id;\n\n    let index;\n\n    if (parentId && !(parentId in layerIndices)) {\n      // Populate layerIndices with the parent layer's index\n      resolveLayerIndex(layer.parent, false);\n    }\n\n    if (parentId in resolvers) {\n      const resolver = (resolvers[parentId] =\n        resolvers[parentId] || layerIndexResolver(layerIndices[parentId], layerIndices));\n      index = resolver(layer, isDrawn);\n      resolvers[layerId] = resolver;\n    } else if (Number.isFinite(indexOverride)) {\n      index = indexOverride + (layerIndices[parentId] || 0);\n      // Mark layer as needing its own resolver\n      // We don't actually create it until it's used for the first time\n      resolvers[layerId] = null;\n    } else {\n      index = startIndex;\n    }\n\n    if (isDrawn && index >= startIndex) {\n      startIndex = index + 1;\n    }\n\n    layerIndices[layerId] = index;\n    return index;\n  };\n  return resolveLayerIndex;\n}\n\n// Convert viewport top-left CSS coordinates to bottom up WebGL coordinates\nfunction getGLViewport(\n  gl,\n  {\n    moduleParameters,\n    target,\n    viewport\n  }: {\n    moduleParameters: any;\n    target?: Framebuffer;\n    viewport: Viewport;\n  }\n): [number, number, number, number] {\n  const useTarget = target && target.id !== 'default-framebuffer';\n  const pixelRatio =\n    (moduleParameters && moduleParameters.devicePixelRatio) || cssToDeviceRatio(gl);\n\n  // Default framebuffer is used when writing to canvas\n  const height = useTarget ? target.height : gl.drawingBufferHeight;\n\n  // Convert viewport top-left CSS coordinates to bottom up WebGL coordinates\n  const dimensions = viewport;\n  return [\n    dimensions.x * pixelRatio,\n    height - (dimensions.y + dimensions.height) * pixelRatio,\n    dimensions.width * pixelRatio,\n    dimensions.height * pixelRatio\n  ];\n}\n\nfunction clearGLCanvas(gl: WebGLRenderingContext) {\n  const width = gl.drawingBufferWidth;\n  const height = gl.drawingBufferHeight;\n  // clear depth and color buffers, restoring transparency\n  setParameters(gl, {viewport: [0, 0, width, height]});\n  gl.clear(GL.COLOR_BUFFER_BIT | GL.DEPTH_BUFFER_BIT);\n}\n","import { getWebGL2Context, assertWebGL2Context, log } from '@luma.gl/gltools';\nimport Resource from './resource';\nimport Texture2D from './texture-2d';\nimport Renderbuffer from './renderbuffer';\nimport { clear, clearBuffer } from './clear';\nimport { copyToDataUrl } from './copy-and-blit.js';\nimport { getFeatures } from '../features';\nimport { getKey } from '../webgl-utils/constants-to-keys';\nimport { assert } from '../utils/assert';\nconst ERR_MULTIPLE_RENDERTARGETS = 'Multiple render targets not supported';\nexport default class Framebuffer extends Resource {\n  get [Symbol.toStringTag]() {\n    return 'Framebuffer';\n  }\n\n  static isSupported(gl) {\n    let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    const {\n      colorBufferFloat,\n      colorBufferHalfFloat\n    } = options;\n    let supported = true;\n\n    if (colorBufferFloat) {\n      supported = Boolean(gl.getExtension('EXT_color_buffer_float') || gl.getExtension('WEBGL_color_buffer_float') || gl.getExtension('OES_texture_float'));\n    }\n\n    if (colorBufferHalfFloat) {\n      supported = supported && Boolean(gl.getExtension('EXT_color_buffer_float') || gl.getExtension('EXT_color_buffer_half_float'));\n    }\n\n    return supported;\n  }\n\n  static getDefaultFramebuffer(gl) {\n    gl.luma = gl.luma || {};\n    gl.luma.defaultFramebuffer = gl.luma.defaultFramebuffer || new Framebuffer(gl, {\n      id: 'default-framebuffer',\n      handle: null,\n      attachments: {}\n    });\n    return gl.luma.defaultFramebuffer;\n  }\n\n  get MAX_COLOR_ATTACHMENTS() {\n    const gl2 = assertWebGL2Context(this.gl);\n    return gl2.getParameter(gl2.MAX_COLOR_ATTACHMENTS);\n  }\n\n  get MAX_DRAW_BUFFERS() {\n    const gl2 = assertWebGL2Context(this.gl);\n    return gl2.getParameter(gl2.MAX_DRAW_BUFFERS);\n  }\n\n  constructor(gl) {\n    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    super(gl, opts);\n    this.width = null;\n    this.height = null;\n    this.attachments = {};\n    this.readBuffer = 36064;\n    this.drawBuffers = [36064];\n    this.ownResources = [];\n    this.initialize(opts);\n    Object.seal(this);\n  }\n\n  get color() {\n    return this.attachments[36064] || null;\n  }\n\n  get texture() {\n    return this.attachments[36064] || null;\n  }\n\n  get depth() {\n    return this.attachments[36096] || this.attachments[33306] || null;\n  }\n\n  get stencil() {\n    return this.attachments[36128] || this.attachments[33306] || null;\n  }\n\n  initialize(_ref) {\n    let {\n      width = 1,\n      height = 1,\n      attachments = null,\n      color = true,\n      depth = true,\n      stencil = false,\n      check = true,\n      readBuffer = undefined,\n      drawBuffers = undefined\n    } = _ref;\n    assert(width >= 0 && height >= 0, 'Width and height need to be integers');\n    this.width = width;\n    this.height = height;\n\n    if (attachments) {\n      for (const attachment in attachments) {\n        const target = attachments[attachment];\n        const object = Array.isArray(target) ? target[0] : target;\n        object.resize({\n          width,\n          height\n        });\n      }\n    } else {\n      attachments = this._createDefaultAttachments(color, depth, stencil, width, height);\n    }\n\n    this.update({\n      clearAttachments: true,\n      attachments,\n      readBuffer,\n      drawBuffers\n    });\n\n    if (attachments && check) {\n      this.checkStatus();\n    }\n  }\n\n  delete() {\n    for (const resource of this.ownResources) {\n      resource.delete();\n    }\n\n    super.delete();\n    return this;\n  }\n\n  update(_ref2) {\n    let {\n      attachments = {},\n      readBuffer,\n      drawBuffers,\n      clearAttachments = false,\n      resizeAttachments = true\n    } = _ref2;\n    this.attach(attachments, {\n      clearAttachments,\n      resizeAttachments\n    });\n    const {\n      gl\n    } = this;\n    const prevHandle = gl.bindFramebuffer(36160, this.handle);\n\n    if (readBuffer) {\n      this._setReadBuffer(readBuffer);\n    }\n\n    if (drawBuffers) {\n      this._setDrawBuffers(drawBuffers);\n    }\n\n    gl.bindFramebuffer(36160, prevHandle || null);\n    return this;\n  }\n\n  resize() {\n    let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    let {\n      width,\n      height\n    } = options;\n\n    if (this.handle === null) {\n      assert(width === undefined && height === undefined);\n      this.width = this.gl.drawingBufferWidth;\n      this.height = this.gl.drawingBufferHeight;\n      return this;\n    }\n\n    if (width === undefined) {\n      width = this.gl.drawingBufferWidth;\n    }\n\n    if (height === undefined) {\n      height = this.gl.drawingBufferHeight;\n    }\n\n    if (width !== this.width && height !== this.height) {\n      log.log(2, \"Resizing framebuffer \".concat(this.id, \" to \").concat(width, \"x\").concat(height))();\n    }\n\n    for (const attachmentPoint in this.attachments) {\n      this.attachments[attachmentPoint].resize({\n        width,\n        height\n      });\n    }\n\n    this.width = width;\n    this.height = height;\n    return this;\n  }\n\n  attach(attachments) {\n    let {\n      clearAttachments = false,\n      resizeAttachments = true\n    } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    const newAttachments = {};\n\n    if (clearAttachments) {\n      Object.keys(this.attachments).forEach(key => {\n        newAttachments[key] = null;\n      });\n    }\n\n    Object.assign(newAttachments, attachments);\n    const prevHandle = this.gl.bindFramebuffer(36160, this.handle);\n\n    for (const key in newAttachments) {\n      assert(key !== undefined, 'Misspelled framebuffer binding point?');\n      const attachment = Number(key);\n      const descriptor = newAttachments[attachment];\n      let object = descriptor;\n\n      if (!object) {\n        this._unattach(attachment);\n      } else if (object instanceof Renderbuffer) {\n        this._attachRenderbuffer({\n          attachment,\n          renderbuffer: object\n        });\n      } else if (Array.isArray(descriptor)) {\n        const [texture, layer = 0, level = 0] = descriptor;\n        object = texture;\n\n        this._attachTexture({\n          attachment,\n          texture,\n          layer,\n          level\n        });\n      } else {\n        this._attachTexture({\n          attachment,\n          texture: object,\n          layer: 0,\n          level: 0\n        });\n      }\n\n      if (resizeAttachments && object) {\n        object.resize({\n          width: this.width,\n          height: this.height\n        });\n      }\n    }\n\n    this.gl.bindFramebuffer(36160, prevHandle || null);\n    Object.assign(this.attachments, attachments);\n    Object.keys(this.attachments).filter(key => !this.attachments[key]).forEach(key => {\n      delete this.attachments[key];\n    });\n  }\n\n  checkStatus() {\n    const {\n      gl\n    } = this;\n    const status = this.getStatus();\n\n    if (status !== 36053) {\n      throw new Error(_getFrameBufferStatus(status));\n    }\n\n    return this;\n  }\n\n  getStatus() {\n    const {\n      gl\n    } = this;\n    const prevHandle = gl.bindFramebuffer(36160, this.handle);\n    const status = gl.checkFramebufferStatus(36160);\n    gl.bindFramebuffer(36160, prevHandle || null);\n    return status;\n  }\n\n  clear() {\n    let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      color,\n      depth,\n      stencil,\n      drawBuffers = []\n    } = options;\n    const prevHandle = this.gl.bindFramebuffer(36160, this.handle);\n\n    if (color || depth || stencil) {\n      clear(this.gl, {\n        color,\n        depth,\n        stencil\n      });\n    }\n\n    drawBuffers.forEach((value, drawBuffer) => {\n      clearBuffer(this.gl, {\n        drawBuffer,\n        value\n      });\n    });\n    this.gl.bindFramebuffer(36160, prevHandle || null);\n    return this;\n  }\n\n  readPixels() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    log.error('Framebuffer.readPixels() is no logner supported, use readPixelsToArray(framebuffer)')();\n    return null;\n  }\n\n  readPixelsToBuffer() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    log.error('Framebuffer.readPixelsToBuffer()is no logner supported, use readPixelsToBuffer(framebuffer)')();\n    return null;\n  }\n\n  copyToDataUrl() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    log.error('Framebuffer.copyToDataUrl() is no logner supported, use copyToDataUrl(framebuffer)')();\n    return null;\n  }\n\n  copyToImage() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    log.error('Framebuffer.copyToImage() is no logner supported, use copyToImage(framebuffer)')();\n    return null;\n  }\n\n  copyToTexture() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    log.error('Framebuffer.copyToTexture({...}) is no logner supported, use copyToTexture(source, target, opts})')();\n    return null;\n  }\n\n  blit() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    log.error('Framebuffer.blit({...}) is no logner supported, use blit(source, target, opts)')();\n    return null;\n  }\n\n  invalidate(_ref3) {\n    let {\n      attachments = [],\n      x = 0,\n      y = 0,\n      width,\n      height\n    } = _ref3;\n    const gl2 = assertWebGL2Context(this.gl);\n    const prevHandle = gl2.bindFramebuffer(36008, this.handle);\n    const invalidateAll = x === 0 && y === 0 && width === undefined && height === undefined;\n\n    if (invalidateAll) {\n      gl2.invalidateFramebuffer(36008, attachments);\n    } else {\n      gl2.invalidateFramebuffer(36008, attachments, x, y, width, height);\n    }\n\n    gl2.bindFramebuffer(36008, prevHandle);\n    return this;\n  }\n\n  getAttachmentParameter(attachment, pname, keys) {\n    let value = this._getAttachmentParameterFallback(pname);\n\n    if (value === null) {\n      this.gl.bindFramebuffer(36160, this.handle);\n      value = this.gl.getFramebufferAttachmentParameter(36160, attachment, pname);\n      this.gl.bindFramebuffer(36160, null);\n    }\n\n    if (keys && value > 1000) {\n      value = getKey(this.gl, value);\n    }\n\n    return value;\n  }\n\n  getAttachmentParameters() {\n    let attachment = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 36064;\n    let keys = arguments.length > 1 ? arguments[1] : undefined;\n    let parameters = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : this.constructor.ATTACHMENT_PARAMETERS || [];\n    const values = {};\n\n    for (const pname of parameters) {\n      const key = keys ? getKey(this.gl, pname) : pname;\n      values[key] = this.getAttachmentParameter(attachment, pname, keys);\n    }\n\n    return values;\n  }\n\n  getParameters() {\n    let keys = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;\n    const attachments = Object.keys(this.attachments);\n    const parameters = {};\n\n    for (const attachmentName of attachments) {\n      const attachment = Number(attachmentName);\n      const key = keys ? getKey(this.gl, attachment) : attachment;\n      parameters[key] = this.getAttachmentParameters(attachment, keys);\n    }\n\n    return parameters;\n  }\n\n  show() {\n    if (typeof window !== 'undefined') {\n      window.open(copyToDataUrl(this), 'luma-debug-texture');\n    }\n\n    return this;\n  }\n\n  log() {\n    let logLevel = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;\n    let message = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';\n\n    if (logLevel > log.level || typeof window === 'undefined') {\n      return this;\n    }\n\n    message = message || \"Framebuffer \".concat(this.id);\n    const image = copyToDataUrl(this, {\n      targetMaxHeight: 100\n    });\n    log.image({\n      logLevel,\n      message,\n      image\n    }, message)();\n    return this;\n  }\n\n  bind() {\n    let {\n      target = 36160\n    } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    this.gl.bindFramebuffer(target, this.handle);\n    return this;\n  }\n\n  unbind() {\n    let {\n      target = 36160\n    } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    this.gl.bindFramebuffer(target, null);\n    return this;\n  }\n\n  _createDefaultAttachments(color, depth, stencil, width, height) {\n    let defaultAttachments = null;\n\n    if (color) {\n      defaultAttachments = defaultAttachments || {};\n      defaultAttachments[36064] = new Texture2D(this.gl, {\n        id: \"\".concat(this.id, \"-color0\"),\n        pixels: null,\n        format: 6408,\n        type: 5121,\n        width,\n        height,\n        mipmaps: false,\n        parameters: {\n          [10241]: 9729,\n          [10240]: 9729,\n          [10242]: 33071,\n          [10243]: 33071\n        }\n      });\n      this.ownResources.push(defaultAttachments[36064]);\n    }\n\n    if (depth && stencil) {\n      defaultAttachments = defaultAttachments || {};\n      defaultAttachments[33306] = new Renderbuffer(this.gl, {\n        id: \"\".concat(this.id, \"-depth-stencil\"),\n        format: 35056,\n        width,\n        height: 111\n      });\n      this.ownResources.push(defaultAttachments[33306]);\n    } else if (depth) {\n      defaultAttachments = defaultAttachments || {};\n      defaultAttachments[36096] = new Renderbuffer(this.gl, {\n        id: \"\".concat(this.id, \"-depth\"),\n        format: 33189,\n        width,\n        height\n      });\n      this.ownResources.push(defaultAttachments[36096]);\n    } else if (stencil) {\n      assert(false);\n    }\n\n    return defaultAttachments;\n  }\n\n  _unattach(attachment) {\n    const oldAttachment = this.attachments[attachment];\n\n    if (!oldAttachment) {\n      return;\n    }\n\n    if (oldAttachment instanceof Renderbuffer) {\n      this.gl.framebufferRenderbuffer(36160, attachment, 36161, null);\n    } else {\n      this.gl.framebufferTexture2D(36160, attachment, 3553, null, 0);\n    }\n\n    delete this.attachments[attachment];\n  }\n\n  _attachRenderbuffer(_ref4) {\n    let {\n      attachment = 36064,\n      renderbuffer\n    } = _ref4;\n    const {\n      gl\n    } = this;\n    gl.framebufferRenderbuffer(36160, attachment, 36161, renderbuffer.handle);\n    this.attachments[attachment] = renderbuffer;\n  }\n\n  _attachTexture(_ref5) {\n    let {\n      attachment = 36064,\n      texture,\n      layer,\n      level\n    } = _ref5;\n    const {\n      gl\n    } = this;\n    gl.bindTexture(texture.target, texture.handle);\n\n    switch (texture.target) {\n      case 35866:\n      case 32879:\n        const gl2 = assertWebGL2Context(gl);\n        gl2.framebufferTextureLayer(36160, attachment, texture.target, level, layer);\n        break;\n\n      case 34067:\n        const face = mapIndexToCubeMapFace(layer);\n        gl.framebufferTexture2D(36160, attachment, face, texture.handle, level);\n        break;\n\n      case 3553:\n        gl.framebufferTexture2D(36160, attachment, 3553, texture.handle, level);\n        break;\n\n      default:\n        assert(false, 'Illegal texture type');\n    }\n\n    gl.bindTexture(texture.target, null);\n    this.attachments[attachment] = texture;\n  }\n\n  _setReadBuffer(readBuffer) {\n    const gl2 = getWebGL2Context(this.gl);\n\n    if (gl2) {\n      gl2.readBuffer(readBuffer);\n    } else {\n      assert(readBuffer === 36064 || readBuffer === 1029, ERR_MULTIPLE_RENDERTARGETS);\n    }\n\n    this.readBuffer = readBuffer;\n  }\n\n  _setDrawBuffers(drawBuffers) {\n    const {\n      gl\n    } = this;\n    const gl2 = assertWebGL2Context(gl);\n\n    if (gl2) {\n      gl2.drawBuffers(drawBuffers);\n    } else {\n      const ext = gl.getExtension('WEBGL_draw_buffers');\n\n      if (ext) {\n        ext.drawBuffersWEBGL(drawBuffers);\n      } else {\n        assert(drawBuffers.length === 1 && (drawBuffers[0] === 36064 || drawBuffers[0] === 1029), ERR_MULTIPLE_RENDERTARGETS);\n      }\n    }\n\n    this.drawBuffers = drawBuffers;\n  }\n\n  _getAttachmentParameterFallback(pname) {\n    const caps = getFeatures(this.gl);\n\n    switch (pname) {\n      case 36052:\n        return !caps.WEBGL2 ? 0 : null;\n\n      case 33298:\n      case 33299:\n      case 33300:\n      case 33301:\n      case 33302:\n      case 33303:\n        return !caps.WEBGL2 ? 8 : null;\n\n      case 33297:\n        return !caps.WEBGL2 ? 5125 : null;\n\n      case 33296:\n        return !caps.WEBGL2 && !caps.EXT_sRGB ? 9729 : null;\n\n      default:\n        return null;\n    }\n  }\n\n  _createHandle() {\n    return this.gl.createFramebuffer();\n  }\n\n  _deleteHandle() {\n    this.gl.deleteFramebuffer(this.handle);\n  }\n\n  _bindHandle(handle) {\n    return this.gl.bindFramebuffer(36160, handle);\n  }\n\n}\n\nfunction mapIndexToCubeMapFace(layer) {\n  return layer < 34069 ? layer + 34069 : layer;\n}\n\nfunction _getFrameBufferStatus(status) {\n  const STATUS = Framebuffer.STATUS || {};\n  return STATUS[status] || \"Framebuffer error \".concat(status);\n}\n\nexport const FRAMEBUFFER_ATTACHMENT_PARAMETERS = [36049, 36048, 33296, 33298, 33299, 33300, 33301, 33302, 33303];\nFramebuffer.ATTACHMENT_PARAMETERS = FRAMEBUFFER_ATTACHMENT_PARAMETERS;\n//# sourceMappingURL=framebuffer.js.map","import type {Timeline} from '@luma.gl/core';\n\nexport type TransitionSettings = {\n  duration: number;\n  onStart?: (transition: Transition) => void;\n  onUpdate?: (transition: Transition) => void;\n  onInterrupt?: (transition: Transition) => void;\n  onEnd?: (transition: Transition) => void;\n};\n\nexport default class Transition {\n  private _inProgress: boolean;\n  private _handle: number | null;\n  private _timeline: Timeline;\n\n  time: number;\n  settings: TransitionSettings;\n\n  /**\n   * @params timeline {Timeline}\n   */\n  constructor(timeline: Timeline) {\n    this._inProgress = false;\n    this._handle = null;\n    this._timeline = timeline;\n    this.time = 0;\n\n    // Defaults\n    this.settings = {duration: 0};\n  }\n\n  /* Public API */\n  get inProgress(): boolean {\n    return this._inProgress;\n  }\n\n  /**\n   * (re)start this transition.\n   * @params props {object} - optional overriding props. see constructor\n   */\n  start(settings: TransitionSettings) {\n    this.cancel();\n    this.settings = settings;\n    this._inProgress = true;\n    this.settings.onStart?.(this);\n  }\n\n  /**\n   * end this transition if it is in progress.\n   */\n  end() {\n    if (this._inProgress) {\n      this._timeline.removeChannel(this._handle);\n      this._handle = null;\n      this._inProgress = false;\n      this.settings.onEnd?.(this);\n    }\n  }\n\n  /**\n   * cancel this transition if it is in progress.\n   */\n  cancel() {\n    if (this._inProgress) {\n      this.settings.onInterrupt?.(this);\n      this._timeline.removeChannel(this._handle);\n      this._handle = null;\n      this._inProgress = false;\n    }\n  }\n\n  /**\n   * update this transition. Returns `true` if updated.\n   */\n  update() {\n    if (!this._inProgress) {\n      return false;\n    }\n\n    // It is important to initialize the handle during `update` instead of `start`.\n    // The CPU time that the `start` frame takes should not be counted towards the duration.\n    // On the other hand, `update` always happens during a render cycle. The clock starts when the\n    // transition is rendered for the first time.\n    if (this._handle === null) {\n      const {_timeline: timeline, settings} = this;\n      this._handle = timeline.addChannel({\n        delay: timeline.getTime(),\n        duration: settings.duration\n      });\n    }\n\n    this.time = this._timeline.getTime(this._handle);\n    // Call subclass method\n    this._onUpdate();\n    // Call user callback\n    this.settings.onUpdate?.(this);\n\n    // This only works if `settings.duration` is set\n    // Spring transition must call `end` manually\n    if (this._timeline.isFinished(this._handle)) {\n      this.end();\n    }\n    return true;\n  }\n\n  /* Private API */\n\n  protected _onUpdate() {\n    // for subclass override\n  }\n}\n","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport getHiResTimestamp from '../utils/hi-res-timestamp';\nexport default class Stat {\n  constructor(name, type) {\n    _defineProperty(this, \"name\", void 0);\n\n    _defineProperty(this, \"type\", void 0);\n\n    _defineProperty(this, \"sampleSize\", 1);\n\n    _defineProperty(this, \"time\", void 0);\n\n    _defineProperty(this, \"count\", void 0);\n\n    _defineProperty(this, \"samples\", void 0);\n\n    _defineProperty(this, \"lastTiming\", void 0);\n\n    _defineProperty(this, \"lastSampleTime\", void 0);\n\n    _defineProperty(this, \"lastSampleCount\", void 0);\n\n    _defineProperty(this, \"_count\", 0);\n\n    _defineProperty(this, \"_time\", 0);\n\n    _defineProperty(this, \"_samples\", 0);\n\n    _defineProperty(this, \"_startTime\", 0);\n\n    _defineProperty(this, \"_timerPending\", false);\n\n    this.name = name;\n    this.type = type;\n    this.reset();\n  }\n\n  setSampleSize(samples) {\n    this.sampleSize = samples;\n    return this;\n  }\n\n  incrementCount() {\n    this.addCount(1);\n    return this;\n  }\n\n  decrementCount() {\n    this.subtractCount(1);\n    return this;\n  }\n\n  addCount(value) {\n    this._count += value;\n    this._samples++;\n\n    this._checkSampling();\n\n    return this;\n  }\n\n  subtractCount(value) {\n    this._count -= value;\n    this._samples++;\n\n    this._checkSampling();\n\n    return this;\n  }\n\n  addTime(time) {\n    this._time += time;\n    this.lastTiming = time;\n    this._samples++;\n\n    this._checkSampling();\n\n    return this;\n  }\n\n  timeStart() {\n    this._startTime = getHiResTimestamp();\n    this._timerPending = true;\n    return this;\n  }\n\n  timeEnd() {\n    if (!this._timerPending) {\n      return this;\n    }\n\n    this.addTime(getHiResTimestamp() - this._startTime);\n    this._timerPending = false;\n\n    this._checkSampling();\n\n    return this;\n  }\n\n  getSampleAverageCount() {\n    return this.sampleSize > 0 ? this.lastSampleCount / this.sampleSize : 0;\n  }\n\n  getSampleAverageTime() {\n    return this.sampleSize > 0 ? this.lastSampleTime / this.sampleSize : 0;\n  }\n\n  getSampleHz() {\n    return this.lastSampleTime > 0 ? this.sampleSize / (this.lastSampleTime / 1000) : 0;\n  }\n\n  getAverageCount() {\n    return this.samples > 0 ? this.count / this.samples : 0;\n  }\n\n  getAverageTime() {\n    return this.samples > 0 ? this.time / this.samples : 0;\n  }\n\n  getHz() {\n    return this.time > 0 ? this.samples / (this.time / 1000) : 0;\n  }\n\n  reset() {\n    this.time = 0;\n    this.count = 0;\n    this.samples = 0;\n    this.lastTiming = 0;\n    this.lastSampleTime = 0;\n    this.lastSampleCount = 0;\n    this._count = 0;\n    this._time = 0;\n    this._samples = 0;\n    this._startTime = 0;\n    this._timerPending = false;\n    return this;\n  }\n\n  _checkSampling() {\n    if (this._samples === this.sampleSize) {\n      this.lastSampleTime = this._time;\n      this.lastSampleCount = this._count;\n      this.count += this._count;\n      this.time += this._time;\n      this.samples += this._samples;\n      this._time = 0;\n      this._count = 0;\n      this._samples = 0;\n    }\n  }\n\n}\n//# sourceMappingURL=stat.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport Stat from './stat';\nexport default class Stats {\n  constructor(options) {\n    _defineProperty(this, \"id\", void 0);\n\n    _defineProperty(this, \"stats\", {});\n\n    this.id = options.id;\n    this.stats = {};\n\n    this._initializeStats(options.stats);\n\n    Object.seal(this);\n  }\n\n  get(name) {\n    let type = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'count';\n    return this._getOrCreate({\n      name,\n      type\n    });\n  }\n\n  get size() {\n    return Object.keys(this.stats).length;\n  }\n\n  reset() {\n    for (const key in this.stats) {\n      this.stats[key].reset();\n    }\n\n    return this;\n  }\n\n  forEach(fn) {\n    for (const key in this.stats) {\n      fn(this.stats[key]);\n    }\n  }\n\n  getTable() {\n    const table = {};\n    this.forEach(stat => {\n      table[stat.name] = {\n        time: stat.time || 0,\n        count: stat.count || 0,\n        average: stat.getAverageTime() || 0,\n        hz: stat.getHz() || 0\n      };\n    });\n    return table;\n  }\n\n  _initializeStats() {\n    let stats = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];\n    stats.forEach(stat => this._getOrCreate(stat));\n  }\n\n  _getOrCreate(stat) {\n    if (!stat || !stat.name) {\n      return null;\n    }\n\n    const {\n      name,\n      type\n    } = stat;\n\n    if (!this.stats[name]) {\n      if (stat instanceof Stat) {\n        this.stats[name] = stat;\n      } else {\n        this.stats[name] = new Stat(name, type);\n      }\n    }\n\n    return this.stats[name];\n  }\n\n}\n//# sourceMappingURL=stats.js.map","export { default as Stats } from './lib/stats';\nexport { default as Stat } from './lib/stat';\nexport { default as _getHiResTimestamp } from './utils/hi-res-timestamp';\n//# sourceMappingURL=index.js.map","export const VERTEX_SHADER = 'vs';\nexport const FRAGMENT_SHADER = 'fs';\n//# sourceMappingURL=constants.js.map","import Matrix from './base/matrix';\nimport { checkVector } from '../lib/validators';\nimport { vec2_transformMat4AsVector, vec3_transformMat4AsVector } from '../lib/gl-matrix-extras';\nimport * as mat4 from 'gl-matrix/mat4';\nimport * as vec2 from 'gl-matrix/vec2';\nimport * as vec3 from 'gl-matrix/vec3';\nimport * as vec4 from 'gl-matrix/vec4';\nvar INDICES;\n\n(function (INDICES) {\n  INDICES[INDICES[\"COL0ROW0\"] = 0] = \"COL0ROW0\";\n  INDICES[INDICES[\"COL0ROW1\"] = 1] = \"COL0ROW1\";\n  INDICES[INDICES[\"COL0ROW2\"] = 2] = \"COL0ROW2\";\n  INDICES[INDICES[\"COL0ROW3\"] = 3] = \"COL0ROW3\";\n  INDICES[INDICES[\"COL1ROW0\"] = 4] = \"COL1ROW0\";\n  INDICES[INDICES[\"COL1ROW1\"] = 5] = \"COL1ROW1\";\n  INDICES[INDICES[\"COL1ROW2\"] = 6] = \"COL1ROW2\";\n  INDICES[INDICES[\"COL1ROW3\"] = 7] = \"COL1ROW3\";\n  INDICES[INDICES[\"COL2ROW0\"] = 8] = \"COL2ROW0\";\n  INDICES[INDICES[\"COL2ROW1\"] = 9] = \"COL2ROW1\";\n  INDICES[INDICES[\"COL2ROW2\"] = 10] = \"COL2ROW2\";\n  INDICES[INDICES[\"COL2ROW3\"] = 11] = \"COL2ROW3\";\n  INDICES[INDICES[\"COL3ROW0\"] = 12] = \"COL3ROW0\";\n  INDICES[INDICES[\"COL3ROW1\"] = 13] = \"COL3ROW1\";\n  INDICES[INDICES[\"COL3ROW2\"] = 14] = \"COL3ROW2\";\n  INDICES[INDICES[\"COL3ROW3\"] = 15] = \"COL3ROW3\";\n})(INDICES || (INDICES = {}));\n\nconst DEFAULT_FOVY = 45 * Math.PI / 180;\nconst DEFAULT_ASPECT = 1;\nconst DEFAULT_NEAR = 0.1;\nconst DEFAULT_FAR = 500;\nconst IDENTITY_MATRIX = Object.freeze([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);\nexport default class Matrix4 extends Matrix {\n  static get IDENTITY() {\n    return getIdentityMatrix();\n  }\n\n  static get ZERO() {\n    return getZeroMatrix();\n  }\n\n  get ELEMENTS() {\n    return 16;\n  }\n\n  get RANK() {\n    return 4;\n  }\n\n  get INDICES() {\n    return INDICES;\n  }\n\n  constructor(array) {\n    super(-0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0);\n\n    if (arguments.length === 1 && Array.isArray(array)) {\n      this.copy(array);\n    } else {\n      this.identity();\n    }\n  }\n\n  copy(array) {\n    this[0] = array[0];\n    this[1] = array[1];\n    this[2] = array[2];\n    this[3] = array[3];\n    this[4] = array[4];\n    this[5] = array[5];\n    this[6] = array[6];\n    this[7] = array[7];\n    this[8] = array[8];\n    this[9] = array[9];\n    this[10] = array[10];\n    this[11] = array[11];\n    this[12] = array[12];\n    this[13] = array[13];\n    this[14] = array[14];\n    this[15] = array[15];\n    return this.check();\n  }\n\n  set(m00, m10, m20, m30, m01, m11, m21, m31, m02, m12, m22, m32, m03, m13, m23, m33) {\n    this[0] = m00;\n    this[1] = m10;\n    this[2] = m20;\n    this[3] = m30;\n    this[4] = m01;\n    this[5] = m11;\n    this[6] = m21;\n    this[7] = m31;\n    this[8] = m02;\n    this[9] = m12;\n    this[10] = m22;\n    this[11] = m32;\n    this[12] = m03;\n    this[13] = m13;\n    this[14] = m23;\n    this[15] = m33;\n    return this.check();\n  }\n\n  setRowMajor(m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33) {\n    this[0] = m00;\n    this[1] = m10;\n    this[2] = m20;\n    this[3] = m30;\n    this[4] = m01;\n    this[5] = m11;\n    this[6] = m21;\n    this[7] = m31;\n    this[8] = m02;\n    this[9] = m12;\n    this[10] = m22;\n    this[11] = m32;\n    this[12] = m03;\n    this[13] = m13;\n    this[14] = m23;\n    this[15] = m33;\n    return this.check();\n  }\n\n  toRowMajor(result) {\n    result[0] = this[0];\n    result[1] = this[4];\n    result[2] = this[8];\n    result[3] = this[12];\n    result[4] = this[1];\n    result[5] = this[5];\n    result[6] = this[9];\n    result[7] = this[13];\n    result[8] = this[2];\n    result[9] = this[6];\n    result[10] = this[10];\n    result[11] = this[14];\n    result[12] = this[3];\n    result[13] = this[7];\n    result[14] = this[11];\n    result[15] = this[15];\n    return result;\n  }\n\n  identity() {\n    return this.copy(IDENTITY_MATRIX);\n  }\n\n  fromObject(object) {\n    return this.check();\n  }\n\n  fromQuaternion(quaternion) {\n    mat4.fromQuat(this, quaternion);\n    return this.check();\n  }\n\n  frustum(view) {\n    const {\n      left,\n      right,\n      bottom,\n      top,\n      near = DEFAULT_NEAR,\n      far = DEFAULT_FAR\n    } = view;\n\n    if (far === Infinity) {\n      computeInfinitePerspectiveOffCenter(this, left, right, bottom, top, near);\n    } else {\n      mat4.frustum(this, left, right, bottom, top, near, far);\n    }\n\n    return this.check();\n  }\n\n  lookAt(view) {\n    const {\n      eye,\n      center = [0, 0, 0],\n      up = [0, 1, 0]\n    } = view;\n    mat4.lookAt(this, eye, center, up);\n    return this.check();\n  }\n\n  ortho(view) {\n    const {\n      left,\n      right,\n      bottom,\n      top,\n      near = DEFAULT_NEAR,\n      far = DEFAULT_FAR\n    } = view;\n    mat4.ortho(this, left, right, bottom, top, near, far);\n    return this.check();\n  }\n\n  orthographic(view) {\n    const {\n      fovy = DEFAULT_FOVY,\n      aspect = DEFAULT_ASPECT,\n      focalDistance = 1,\n      near = DEFAULT_NEAR,\n      far = DEFAULT_FAR\n    } = view;\n    checkRadians(fovy);\n    const halfY = fovy / 2;\n    const top = focalDistance * Math.tan(halfY);\n    const right = top * aspect;\n    return this.ortho({\n      left: -right,\n      right,\n      bottom: -top,\n      top,\n      near,\n      far\n    });\n  }\n\n  perspective(view) {\n    const {\n      fovy = 45 * Math.PI / 180,\n      aspect = 1,\n      near = 0.1,\n      far = 500\n    } = view;\n    checkRadians(fovy);\n    mat4.perspective(this, fovy, aspect, near, far);\n    return this.check();\n  }\n\n  determinant() {\n    return mat4.determinant(this);\n  }\n\n  getScale(result = [-0, -0, -0]) {\n    result[0] = Math.sqrt(this[0] * this[0] + this[1] * this[1] + this[2] * this[2]);\n    result[1] = Math.sqrt(this[4] * this[4] + this[5] * this[5] + this[6] * this[6]);\n    result[2] = Math.sqrt(this[8] * this[8] + this[9] * this[9] + this[10] * this[10]);\n    return result;\n  }\n\n  getTranslation(result = [-0, -0, -0]) {\n    result[0] = this[12];\n    result[1] = this[13];\n    result[2] = this[14];\n    return result;\n  }\n\n  getRotation(result, scaleResult) {\n    result = result || [-0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0];\n    scaleResult = scaleResult || [-0, -0, -0];\n    const scale = this.getScale(scaleResult);\n    const inverseScale0 = 1 / scale[0];\n    const inverseScale1 = 1 / scale[1];\n    const inverseScale2 = 1 / scale[2];\n    result[0] = this[0] * inverseScale0;\n    result[1] = this[1] * inverseScale1;\n    result[2] = this[2] * inverseScale2;\n    result[3] = 0;\n    result[4] = this[4] * inverseScale0;\n    result[5] = this[5] * inverseScale1;\n    result[6] = this[6] * inverseScale2;\n    result[7] = 0;\n    result[8] = this[8] * inverseScale0;\n    result[9] = this[9] * inverseScale1;\n    result[10] = this[10] * inverseScale2;\n    result[11] = 0;\n    result[12] = 0;\n    result[13] = 0;\n    result[14] = 0;\n    result[15] = 1;\n    return result;\n  }\n\n  getRotationMatrix3(result, scaleResult) {\n    result = result || [-0, -0, -0, -0, -0, -0, -0, -0, -0];\n    scaleResult = scaleResult || [-0, -0, -0];\n    const scale = this.getScale(scaleResult);\n    const inverseScale0 = 1 / scale[0];\n    const inverseScale1 = 1 / scale[1];\n    const inverseScale2 = 1 / scale[2];\n    result[0] = this[0] * inverseScale0;\n    result[1] = this[1] * inverseScale1;\n    result[2] = this[2] * inverseScale2;\n    result[3] = this[4] * inverseScale0;\n    result[4] = this[5] * inverseScale1;\n    result[5] = this[6] * inverseScale2;\n    result[6] = this[8] * inverseScale0;\n    result[7] = this[9] * inverseScale1;\n    result[8] = this[10] * inverseScale2;\n    return result;\n  }\n\n  transpose() {\n    mat4.transpose(this, this);\n    return this.check();\n  }\n\n  invert() {\n    mat4.invert(this, this);\n    return this.check();\n  }\n\n  multiplyLeft(a) {\n    mat4.multiply(this, a, this);\n    return this.check();\n  }\n\n  multiplyRight(a) {\n    mat4.multiply(this, this, a);\n    return this.check();\n  }\n\n  rotateX(radians) {\n    mat4.rotateX(this, this, radians);\n    return this.check();\n  }\n\n  rotateY(radians) {\n    mat4.rotateY(this, this, radians);\n    return this.check();\n  }\n\n  rotateZ(radians) {\n    mat4.rotateZ(this, this, radians);\n    return this.check();\n  }\n\n  rotateXYZ(angleXYZ) {\n    return this.rotateX(angleXYZ[0]).rotateY(angleXYZ[1]).rotateZ(angleXYZ[2]);\n  }\n\n  rotateAxis(radians, axis) {\n    mat4.rotate(this, this, radians, axis);\n    return this.check();\n  }\n\n  scale(factor) {\n    mat4.scale(this, this, Array.isArray(factor) ? factor : [factor, factor, factor]);\n    return this.check();\n  }\n\n  translate(vector) {\n    mat4.translate(this, this, vector);\n    return this.check();\n  }\n\n  transform(vector, result) {\n    if (vector.length === 4) {\n      result = vec4.transformMat4(result || [-0, -0, -0, -0], vector, this);\n      checkVector(result, 4);\n      return result;\n    }\n\n    return this.transformAsPoint(vector, result);\n  }\n\n  transformAsPoint(vector, result) {\n    const {\n      length\n    } = vector;\n    let out;\n\n    switch (length) {\n      case 2:\n        out = vec2.transformMat4(result || [-0, -0], vector, this);\n        break;\n\n      case 3:\n        out = vec3.transformMat4(result || [-0, -0, -0], vector, this);\n        break;\n\n      default:\n        throw new Error('Illegal vector');\n    }\n\n    checkVector(out, vector.length);\n    return out;\n  }\n\n  transformAsVector(vector, result) {\n    let out;\n\n    switch (vector.length) {\n      case 2:\n        out = vec2_transformMat4AsVector(result || [-0, -0], vector, this);\n        break;\n\n      case 3:\n        out = vec3_transformMat4AsVector(result || [-0, -0, -0], vector, this);\n        break;\n\n      default:\n        throw new Error('Illegal vector');\n    }\n\n    checkVector(out, vector.length);\n    return out;\n  }\n\n  transformPoint(vector, result) {\n    return this.transformAsPoint(vector, result);\n  }\n\n  transformVector(vector, result) {\n    return this.transformAsPoint(vector, result);\n  }\n\n  transformDirection(vector, result) {\n    return this.transformAsVector(vector, result);\n  }\n\n  makeRotationX(radians) {\n    return this.identity().rotateX(radians);\n  }\n\n  makeTranslation(x, y, z) {\n    return this.identity().translate([x, y, z]);\n  }\n\n}\nlet ZERO;\nlet IDENTITY;\n\nfunction getZeroMatrix() {\n  if (!ZERO) {\n    ZERO = new Matrix4([0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]);\n    Object.freeze(ZERO);\n  }\n\n  return ZERO;\n}\n\nfunction getIdentityMatrix() {\n  if (!IDENTITY) {\n    IDENTITY = new Matrix4();\n    Object.freeze(IDENTITY);\n  }\n\n  return IDENTITY;\n}\n\nfunction checkRadians(possiblyDegrees) {\n  if (possiblyDegrees > Math.PI * 2) {\n    throw Error('expected radians');\n  }\n}\n\nfunction computeInfinitePerspectiveOffCenter(result, left, right, bottom, top, near) {\n  const column0Row0 = 2 * near / (right - left);\n  const column1Row1 = 2 * near / (top - bottom);\n  const column2Row0 = (right + left) / (right - left);\n  const column2Row1 = (top + bottom) / (top - bottom);\n  const column2Row2 = -1;\n  const column2Row3 = -1;\n  const column3Row2 = -2 * near;\n  result[0] = column0Row0;\n  result[1] = 0;\n  result[2] = 0;\n  result[3] = 0;\n  result[4] = 0;\n  result[5] = column1Row1;\n  result[6] = 0;\n  result[7] = 0;\n  result[8] = column2Row0;\n  result[9] = column2Row1;\n  result[10] = column2Row2;\n  result[11] = column2Row3;\n  result[12] = 0;\n  result[13] = 0;\n  result[14] = column3Row2;\n  result[15] = 0;\n  return result;\n}\n//# sourceMappingURL=matrix4.js.map","import { Log } from '@probe.gl/log';\nexport const log = new Log({\n  id: 'loaders.gl'\n});\n//# sourceMappingURL=log.js.map","import { compareArrayBuffers, path } from '@loaders.gl/loader-utils';\nimport { normalizeLoader } from '../loader-utils/normalize-loader';\nimport { log } from '../utils/log';\nimport { getResourceUrlAndType } from '../utils/resource-utils';\nimport { getRegisteredLoaders } from './register-loaders';\nimport { isBlob } from '../../javascript-utils/is-type';\nconst EXT_PATTERN = /\\.([^.]+)$/;\nexport async function selectLoader(data, loaders = [], options, context) {\n  if (!validHTTPResponse(data)) {\n    return null;\n  }\n\n  let loader = selectLoaderSync(data, loaders, { ...options,\n    nothrow: true\n  }, context);\n\n  if (loader) {\n    return loader;\n  }\n\n  if (isBlob(data)) {\n    data = await data.slice(0, 10).arrayBuffer();\n    loader = selectLoaderSync(data, loaders, options, context);\n  }\n\n  if (!loader && !(options !== null && options !== void 0 && options.nothrow)) {\n    throw new Error(getNoValidLoaderMessage(data));\n  }\n\n  return loader;\n}\nexport function selectLoaderSync(data, loaders = [], options, context) {\n  if (!validHTTPResponse(data)) {\n    return null;\n  }\n\n  if (loaders && !Array.isArray(loaders)) {\n    return normalizeLoader(loaders);\n  }\n\n  let candidateLoaders = [];\n\n  if (loaders) {\n    candidateLoaders = candidateLoaders.concat(loaders);\n  }\n\n  if (!(options !== null && options !== void 0 && options.ignoreRegisteredLoaders)) {\n    candidateLoaders.push(...getRegisteredLoaders());\n  }\n\n  normalizeLoaders(candidateLoaders);\n  const loader = selectLoaderInternal(data, candidateLoaders, options, context);\n\n  if (!loader && !(options !== null && options !== void 0 && options.nothrow)) {\n    throw new Error(getNoValidLoaderMessage(data));\n  }\n\n  return loader;\n}\n\nfunction selectLoaderInternal(data, loaders, options, context) {\n  const {\n    url,\n    type\n  } = getResourceUrlAndType(data);\n  const testUrl = url || (context === null || context === void 0 ? void 0 : context.url);\n  let loader = null;\n  let reason = '';\n\n  if (options !== null && options !== void 0 && options.mimeType) {\n    loader = findLoaderByMIMEType(loaders, options === null || options === void 0 ? void 0 : options.mimeType);\n    reason = \"match forced by supplied MIME type \".concat(options === null || options === void 0 ? void 0 : options.mimeType);\n  }\n\n  loader = loader || findLoaderByUrl(loaders, testUrl);\n  reason = reason || (loader ? \"matched url \".concat(testUrl) : '');\n  loader = loader || findLoaderByMIMEType(loaders, type);\n  reason = reason || (loader ? \"matched MIME type \".concat(type) : '');\n  loader = loader || findLoaderByInitialBytes(loaders, data);\n  reason = reason || (loader ? \"matched initial data \".concat(getFirstCharacters(data)) : '');\n  loader = loader || findLoaderByMIMEType(loaders, options === null || options === void 0 ? void 0 : options.fallbackMimeType);\n  reason = reason || (loader ? \"matched fallback MIME type \".concat(type) : '');\n\n  if (reason) {\n    var _loader;\n\n    log.log(1, \"selectLoader selected \".concat((_loader = loader) === null || _loader === void 0 ? void 0 : _loader.name, \": \").concat(reason, \".\"));\n  }\n\n  return loader;\n}\n\nfunction validHTTPResponse(data) {\n  if (data instanceof Response) {\n    if (data.status === 204) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nfunction getNoValidLoaderMessage(data) {\n  const {\n    url,\n    type\n  } = getResourceUrlAndType(data);\n  let message = 'No valid loader found (';\n  message += url ? \"\".concat(path.filename(url), \", \") : 'no url provided, ';\n  message += \"MIME type: \".concat(type ? \"\\\"\".concat(type, \"\\\"\") : 'not provided', \", \");\n  const firstCharacters = data ? getFirstCharacters(data) : '';\n  message += firstCharacters ? \" first bytes: \\\"\".concat(firstCharacters, \"\\\"\") : 'first bytes: not available';\n  message += ')';\n  return message;\n}\n\nfunction normalizeLoaders(loaders) {\n  for (const loader of loaders) {\n    normalizeLoader(loader);\n  }\n}\n\nfunction findLoaderByUrl(loaders, url) {\n  const match = url && EXT_PATTERN.exec(url);\n  const extension = match && match[1];\n  return extension ? findLoaderByExtension(loaders, extension) : null;\n}\n\nfunction findLoaderByExtension(loaders, extension) {\n  extension = extension.toLowerCase();\n\n  for (const loader of loaders) {\n    for (const loaderExtension of loader.extensions) {\n      if (loaderExtension.toLowerCase() === extension) {\n        return loader;\n      }\n    }\n  }\n\n  return null;\n}\n\nfunction findLoaderByMIMEType(loaders, mimeType) {\n  for (const loader of loaders) {\n    if (loader.mimeTypes && loader.mimeTypes.includes(mimeType)) {\n      return loader;\n    }\n\n    if (mimeType === \"application/x.\".concat(loader.id)) {\n      return loader;\n    }\n  }\n\n  return null;\n}\n\nfunction findLoaderByInitialBytes(loaders, data) {\n  if (!data) {\n    return null;\n  }\n\n  for (const loader of loaders) {\n    if (typeof data === 'string') {\n      if (testDataAgainstText(data, loader)) {\n        return loader;\n      }\n    } else if (ArrayBuffer.isView(data)) {\n      if (testDataAgainstBinary(data.buffer, data.byteOffset, loader)) {\n        return loader;\n      }\n    } else if (data instanceof ArrayBuffer) {\n      const byteOffset = 0;\n\n      if (testDataAgainstBinary(data, byteOffset, loader)) {\n        return loader;\n      }\n    }\n  }\n\n  return null;\n}\n\nfunction testDataAgainstText(data, loader) {\n  if (loader.testText) {\n    return loader.testText(data);\n  }\n\n  const tests = Array.isArray(loader.tests) ? loader.tests : [loader.tests];\n  return tests.some(test => data.startsWith(test));\n}\n\nfunction testDataAgainstBinary(data, byteOffset, loader) {\n  const tests = Array.isArray(loader.tests) ? loader.tests : [loader.tests];\n  return tests.some(test => testBinary(data, byteOffset, loader, test));\n}\n\nfunction testBinary(data, byteOffset, loader, test) {\n  if (test instanceof ArrayBuffer) {\n    return compareArrayBuffers(test, data, test.byteLength);\n  }\n\n  switch (typeof test) {\n    case 'function':\n      return test(data, loader);\n\n    case 'string':\n      const magic = getMagicString(data, byteOffset, test.length);\n      return test === magic;\n\n    default:\n      return false;\n  }\n}\n\nfunction getFirstCharacters(data, length = 5) {\n  if (typeof data === 'string') {\n    return data.slice(0, length);\n  } else if (ArrayBuffer.isView(data)) {\n    return getMagicString(data.buffer, data.byteOffset, length);\n  } else if (data instanceof ArrayBuffer) {\n    const byteOffset = 0;\n    return getMagicString(data, byteOffset, length);\n  }\n\n  return '';\n}\n\nfunction getMagicString(arrayBuffer, byteOffset, length) {\n  if (arrayBuffer.byteLength < byteOffset + length) {\n    return '';\n  }\n\n  const dataView = new DataView(arrayBuffer);\n  let magic = '';\n\n  for (let i = 0; i < length; i++) {\n    magic += String.fromCharCode(dataView.getUint8(byteOffset + i));\n  }\n\n  return magic;\n}\n//# sourceMappingURL=select-loader.js.map","function isEqual(a, b) {\n  if (a === b) {\n    return true;\n  }\n  if (Array.isArray(a)) {\n    // Special treatment for arrays: compare 1-level deep\n    // This is to support equality of matrix/coordinate props\n    const len = a.length;\n    if (!b || b.length !== len) {\n      return false;\n    }\n\n    for (let i = 0; i < len; i++) {\n      if (a[i] !== b[i]) {\n        return false;\n      }\n    }\n    return true;\n  }\n  return false;\n}\n\n/**\n * Speed up consecutive function calls by caching the result of calls with identical input\n * https://en.wikipedia.org/wiki/Memoization\n * @param {function} compute - the function to be memoized\n */\nexport default function memoize<In, Out>(compute: (args: In) => Out): (args: In) => Out {\n  let cachedArgs: any = {};\n  let cachedResult: Out;\n\n  return (args: In) => {\n    for (const key in args) {\n      if (!isEqual(args[key], cachedArgs[key])) {\n        cachedResult = compute(args);\n        cachedArgs = args;\n        break;\n      }\n    }\n    return cachedResult;\n  };\n}\n","import { assert } from '../utils/assert';\nconst GL_BYTE = 0x1400;\nconst GL_UNSIGNED_BYTE = 0x1401;\nconst GL_SHORT = 0x1402;\nconst GL_UNSIGNED_SHORT = 0x1403;\nconst GL_POINTS = 0x0;\nconst GL_LINES = 0x1;\nconst GL_LINE_LOOP = 0x2;\nconst GL_LINE_STRIP = 0x3;\nconst GL_TRIANGLES = 0x4;\nconst GL_TRIANGLE_STRIP = 0x5;\nconst GL_TRIANGLE_FAN = 0x6;\nconst GL_FLOAT = 0x1406;\nconst GL_FLOAT_VEC2 = 0x8b50;\nconst GL_FLOAT_VEC3 = 0x8b51;\nconst GL_FLOAT_VEC4 = 0x8b52;\nconst GL_INT = 0x1404;\nconst GL_INT_VEC2 = 0x8b53;\nconst GL_INT_VEC3 = 0x8b54;\nconst GL_INT_VEC4 = 0x8b55;\nconst GL_UNSIGNED_INT = 0x1405;\nconst GL_UNSIGNED_INT_VEC2 = 0x8dc6;\nconst GL_UNSIGNED_INT_VEC3 = 0x8dc7;\nconst GL_UNSIGNED_INT_VEC4 = 0x8dc8;\nconst GL_BOOL = 0x8b56;\nconst GL_BOOL_VEC2 = 0x8b57;\nconst GL_BOOL_VEC3 = 0x8b58;\nconst GL_BOOL_VEC4 = 0x8b59;\nconst GL_FLOAT_MAT2 = 0x8b5a;\nconst GL_FLOAT_MAT3 = 0x8b5b;\nconst GL_FLOAT_MAT4 = 0x8b5c;\nconst GL_FLOAT_MAT2x3 = 0x8b65;\nconst GL_FLOAT_MAT2x4 = 0x8b66;\nconst GL_FLOAT_MAT3x2 = 0x8b67;\nconst GL_FLOAT_MAT3x4 = 0x8b68;\nconst GL_FLOAT_MAT4x2 = 0x8b69;\nconst GL_FLOAT_MAT4x3 = 0x8b6a;\nconst COMPOSITE_GL_TYPES = {\n  [GL_FLOAT]: [GL_FLOAT, 1, 'float'],\n  [GL_FLOAT_VEC2]: [GL_FLOAT, 2, 'vec2'],\n  [GL_FLOAT_VEC3]: [GL_FLOAT, 3, 'vec3'],\n  [GL_FLOAT_VEC4]: [GL_FLOAT, 4, 'vec4'],\n  [GL_INT]: [GL_INT, 1, 'int'],\n  [GL_INT_VEC2]: [GL_INT, 2, 'ivec2'],\n  [GL_INT_VEC3]: [GL_INT, 3, 'ivec3'],\n  [GL_INT_VEC4]: [GL_INT, 4, 'ivec4'],\n  [GL_UNSIGNED_INT]: [GL_UNSIGNED_INT, 1, 'uint'],\n  [GL_UNSIGNED_INT_VEC2]: [GL_UNSIGNED_INT, 2, 'uvec2'],\n  [GL_UNSIGNED_INT_VEC3]: [GL_UNSIGNED_INT, 3, 'uvec3'],\n  [GL_UNSIGNED_INT_VEC4]: [GL_UNSIGNED_INT, 4, 'uvec4'],\n  [GL_BOOL]: [GL_FLOAT, 1, 'bool'],\n  [GL_BOOL_VEC2]: [GL_FLOAT, 2, 'bvec2'],\n  [GL_BOOL_VEC3]: [GL_FLOAT, 3, 'bvec3'],\n  [GL_BOOL_VEC4]: [GL_FLOAT, 4, 'bvec4'],\n  [GL_FLOAT_MAT2]: [GL_FLOAT, 8, 'mat2'],\n  [GL_FLOAT_MAT2x3]: [GL_FLOAT, 8, 'mat2x3'],\n  [GL_FLOAT_MAT2x4]: [GL_FLOAT, 8, 'mat2x4'],\n  [GL_FLOAT_MAT3]: [GL_FLOAT, 12, 'mat3'],\n  [GL_FLOAT_MAT3x2]: [GL_FLOAT, 12, 'mat3x2'],\n  [GL_FLOAT_MAT3x4]: [GL_FLOAT, 12, 'mat3x4'],\n  [GL_FLOAT_MAT4]: [GL_FLOAT, 16, 'mat4'],\n  [GL_FLOAT_MAT4x2]: [GL_FLOAT, 16, 'mat4x2'],\n  [GL_FLOAT_MAT4x3]: [GL_FLOAT, 16, 'mat4x3']\n};\nexport function getPrimitiveDrawMode(drawMode) {\n  switch (drawMode) {\n    case GL_POINTS:\n      return GL_POINTS;\n\n    case GL_LINES:\n      return GL_LINES;\n\n    case GL_LINE_STRIP:\n      return GL_LINES;\n\n    case GL_LINE_LOOP:\n      return GL_LINES;\n\n    case GL_TRIANGLES:\n      return GL_TRIANGLES;\n\n    case GL_TRIANGLE_STRIP:\n      return GL_TRIANGLES;\n\n    case GL_TRIANGLE_FAN:\n      return GL_TRIANGLES;\n\n    default:\n      assert(false);\n      return 0;\n  }\n}\nexport function getPrimitiveCount(_ref) {\n  let {\n    drawMode,\n    vertexCount\n  } = _ref;\n\n  switch (drawMode) {\n    case GL_POINTS:\n    case GL_LINE_LOOP:\n      return vertexCount;\n\n    case GL_LINES:\n      return vertexCount / 2;\n\n    case GL_LINE_STRIP:\n      return vertexCount - 1;\n\n    case GL_TRIANGLES:\n      return vertexCount / 3;\n\n    case GL_TRIANGLE_STRIP:\n    case GL_TRIANGLE_FAN:\n      return vertexCount - 2;\n\n    default:\n      assert(false);\n      return 0;\n  }\n}\nexport function getVertexCount(_ref2) {\n  let {\n    drawMode,\n    vertexCount\n  } = _ref2;\n  const primitiveCount = getPrimitiveCount({\n    drawMode,\n    vertexCount\n  });\n\n  switch (getPrimitiveDrawMode(drawMode)) {\n    case GL_POINTS:\n      return primitiveCount;\n\n    case GL_LINES:\n      return primitiveCount * 2;\n\n    case GL_TRIANGLES:\n      return primitiveCount * 3;\n\n    default:\n      assert(false);\n      return 0;\n  }\n}\nexport function decomposeCompositeGLType(compositeGLType) {\n  const typeAndSize = COMPOSITE_GL_TYPES[compositeGLType];\n\n  if (!typeAndSize) {\n    return null;\n  }\n\n  const [type, components] = typeAndSize;\n  return {\n    type,\n    components\n  };\n}\nexport function getCompositeGLType(type, components) {\n  switch (type) {\n    case GL_BYTE:\n    case GL_UNSIGNED_BYTE:\n    case GL_SHORT:\n    case GL_UNSIGNED_SHORT:\n      type = GL_FLOAT;\n      break;\n\n    default:\n  }\n\n  for (const glType in COMPOSITE_GL_TYPES) {\n    const [compType, compComponents, name] = COMPOSITE_GL_TYPES[glType];\n\n    if (compType === type && compComponents === components) {\n      return {\n        glType,\n        name\n      };\n    }\n  }\n\n  return null;\n}\n//# sourceMappingURL=attribute-utils.js.map","import { isWebGL2 } from '@luma.gl/gltools';\nexport const TEXTURE_FORMATS = {\n  [6407]: {\n    dataFormat: 6407,\n    types: [5121, 33635]\n  },\n  [6408]: {\n    dataFormat: 6408,\n    types: [5121, 32819, 32820]\n  },\n  [6406]: {\n    dataFormat: 6406,\n    types: [5121]\n  },\n  [6409]: {\n    dataFormat: 6409,\n    types: [5121]\n  },\n  [6410]: {\n    dataFormat: 6410,\n    types: [5121]\n  },\n  [33326]: {\n    dataFormat: 6403,\n    types: [5126],\n    gl2: true\n  },\n  [33328]: {\n    dataFormat: 33319,\n    types: [5126],\n    gl2: true\n  },\n  [34837]: {\n    dataFormat: 6407,\n    types: [5126],\n    gl2: true\n  },\n  [34836]: {\n    dataFormat: 6408,\n    types: [5126],\n    gl2: true\n  }\n};\nexport const DATA_FORMAT_CHANNELS = {\n  [6403]: 1,\n  [36244]: 1,\n  [33319]: 2,\n  [33320]: 2,\n  [6407]: 3,\n  [36248]: 3,\n  [6408]: 4,\n  [36249]: 4,\n  [6402]: 1,\n  [34041]: 1,\n  [6406]: 1,\n  [6409]: 1,\n  [6410]: 2\n};\nexport const TYPE_SIZES = {\n  [5126]: 4,\n  [5125]: 4,\n  [5124]: 4,\n  [5123]: 2,\n  [5122]: 2,\n  [5131]: 2,\n  [5120]: 1,\n  [5121]: 1\n};\nexport function isFormatSupported(gl, format) {\n  const info = TEXTURE_FORMATS[format];\n\n  if (!info) {\n    return false;\n  }\n\n  if (info.gl1 === undefined && info.gl2 === undefined) {\n    return true;\n  }\n\n  const value = isWebGL2(gl) ? info.gl2 || info.gl1 : info.gl1;\n  return typeof value === 'string' ? gl.getExtension(value) : value;\n}\nexport function isLinearFilteringSupported(gl, format) {\n  const info = TEXTURE_FORMATS[format];\n\n  switch (info && info.types[0]) {\n    case 5126:\n      return gl.getExtension('OES_texture_float_linear');\n\n    case 5131:\n      return gl.getExtension('OES_texture_half_float_linear');\n\n    default:\n      return true;\n  }\n}\n//# sourceMappingURL=texture-formats.js.map","import * as glMatrix from \"./common.js\";\n/**\r\n * 3 Dimensional Vector\r\n * @module vec3\r\n */\n\n/**\r\n * Creates a new, empty vec3\r\n *\r\n * @returns {vec3} a new 3D vector\r\n */\n\nexport function create() {\n  var out = new glMatrix.ARRAY_TYPE(3);\n\n  if (glMatrix.ARRAY_TYPE != Float32Array) {\n    out[0] = 0;\n    out[1] = 0;\n    out[2] = 0;\n  }\n\n  return out;\n}\n/**\r\n * Creates a new vec3 initialized with values from an existing vector\r\n *\r\n * @param {ReadonlyVec3} a vector to clone\r\n * @returns {vec3} a new 3D vector\r\n */\n\nexport function clone(a) {\n  var out = new glMatrix.ARRAY_TYPE(3);\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  return out;\n}\n/**\r\n * Calculates the length of a vec3\r\n *\r\n * @param {ReadonlyVec3} a vector to calculate length of\r\n * @returns {Number} length of a\r\n */\n\nexport function length(a) {\n  var x = a[0];\n  var y = a[1];\n  var z = a[2];\n  return Math.hypot(x, y, z);\n}\n/**\r\n * Creates a new vec3 initialized with the given values\r\n *\r\n * @param {Number} x X component\r\n * @param {Number} y Y component\r\n * @param {Number} z Z component\r\n * @returns {vec3} a new 3D vector\r\n */\n\nexport function fromValues(x, y, z) {\n  var out = new glMatrix.ARRAY_TYPE(3);\n  out[0] = x;\n  out[1] = y;\n  out[2] = z;\n  return out;\n}\n/**\r\n * Copy the values from one vec3 to another\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the source vector\r\n * @returns {vec3} out\r\n */\n\nexport function copy(out, a) {\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  return out;\n}\n/**\r\n * Set the components of a vec3 to the given values\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {Number} x X component\r\n * @param {Number} y Y component\r\n * @param {Number} z Z component\r\n * @returns {vec3} out\r\n */\n\nexport function set(out, x, y, z) {\n  out[0] = x;\n  out[1] = y;\n  out[2] = z;\n  return out;\n}\n/**\r\n * Adds two vec3's\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @returns {vec3} out\r\n */\n\nexport function add(out, a, b) {\n  out[0] = a[0] + b[0];\n  out[1] = a[1] + b[1];\n  out[2] = a[2] + b[2];\n  return out;\n}\n/**\r\n * Subtracts vector b from vector a\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @returns {vec3} out\r\n */\n\nexport function subtract(out, a, b) {\n  out[0] = a[0] - b[0];\n  out[1] = a[1] - b[1];\n  out[2] = a[2] - b[2];\n  return out;\n}\n/**\r\n * Multiplies two vec3's\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @returns {vec3} out\r\n */\n\nexport function multiply(out, a, b) {\n  out[0] = a[0] * b[0];\n  out[1] = a[1] * b[1];\n  out[2] = a[2] * b[2];\n  return out;\n}\n/**\r\n * Divides two vec3's\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @returns {vec3} out\r\n */\n\nexport function divide(out, a, b) {\n  out[0] = a[0] / b[0];\n  out[1] = a[1] / b[1];\n  out[2] = a[2] / b[2];\n  return out;\n}\n/**\r\n * Math.ceil the components of a vec3\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a vector to ceil\r\n * @returns {vec3} out\r\n */\n\nexport function ceil(out, a) {\n  out[0] = Math.ceil(a[0]);\n  out[1] = Math.ceil(a[1]);\n  out[2] = Math.ceil(a[2]);\n  return out;\n}\n/**\r\n * Math.floor the components of a vec3\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a vector to floor\r\n * @returns {vec3} out\r\n */\n\nexport function floor(out, a) {\n  out[0] = Math.floor(a[0]);\n  out[1] = Math.floor(a[1]);\n  out[2] = Math.floor(a[2]);\n  return out;\n}\n/**\r\n * Returns the minimum of two vec3's\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @returns {vec3} out\r\n */\n\nexport function min(out, a, b) {\n  out[0] = Math.min(a[0], b[0]);\n  out[1] = Math.min(a[1], b[1]);\n  out[2] = Math.min(a[2], b[2]);\n  return out;\n}\n/**\r\n * Returns the maximum of two vec3's\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @returns {vec3} out\r\n */\n\nexport function max(out, a, b) {\n  out[0] = Math.max(a[0], b[0]);\n  out[1] = Math.max(a[1], b[1]);\n  out[2] = Math.max(a[2], b[2]);\n  return out;\n}\n/**\r\n * Math.round the components of a vec3\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a vector to round\r\n * @returns {vec3} out\r\n */\n\nexport function round(out, a) {\n  out[0] = Math.round(a[0]);\n  out[1] = Math.round(a[1]);\n  out[2] = Math.round(a[2]);\n  return out;\n}\n/**\r\n * Scales a vec3 by a scalar number\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the vector to scale\r\n * @param {Number} b amount to scale the vector by\r\n * @returns {vec3} out\r\n */\n\nexport function scale(out, a, b) {\n  out[0] = a[0] * b;\n  out[1] = a[1] * b;\n  out[2] = a[2] * b;\n  return out;\n}\n/**\r\n * Adds two vec3's after scaling the second operand by a scalar value\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @param {Number} scale the amount to scale b by before adding\r\n * @returns {vec3} out\r\n */\n\nexport function scaleAndAdd(out, a, b, scale) {\n  out[0] = a[0] + b[0] * scale;\n  out[1] = a[1] + b[1] * scale;\n  out[2] = a[2] + b[2] * scale;\n  return out;\n}\n/**\r\n * Calculates the euclidian distance between two vec3's\r\n *\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @returns {Number} distance between a and b\r\n */\n\nexport function distance(a, b) {\n  var x = b[0] - a[0];\n  var y = b[1] - a[1];\n  var z = b[2] - a[2];\n  return Math.hypot(x, y, z);\n}\n/**\r\n * Calculates the squared euclidian distance between two vec3's\r\n *\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @returns {Number} squared distance between a and b\r\n */\n\nexport function squaredDistance(a, b) {\n  var x = b[0] - a[0];\n  var y = b[1] - a[1];\n  var z = b[2] - a[2];\n  return x * x + y * y + z * z;\n}\n/**\r\n * Calculates the squared length of a vec3\r\n *\r\n * @param {ReadonlyVec3} a vector to calculate squared length of\r\n * @returns {Number} squared length of a\r\n */\n\nexport function squaredLength(a) {\n  var x = a[0];\n  var y = a[1];\n  var z = a[2];\n  return x * x + y * y + z * z;\n}\n/**\r\n * Negates the components of a vec3\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a vector to negate\r\n * @returns {vec3} out\r\n */\n\nexport function negate(out, a) {\n  out[0] = -a[0];\n  out[1] = -a[1];\n  out[2] = -a[2];\n  return out;\n}\n/**\r\n * Returns the inverse of the components of a vec3\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a vector to invert\r\n * @returns {vec3} out\r\n */\n\nexport function inverse(out, a) {\n  out[0] = 1.0 / a[0];\n  out[1] = 1.0 / a[1];\n  out[2] = 1.0 / a[2];\n  return out;\n}\n/**\r\n * Normalize a vec3\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a vector to normalize\r\n * @returns {vec3} out\r\n */\n\nexport function normalize(out, a) {\n  var x = a[0];\n  var y = a[1];\n  var z = a[2];\n  var len = x * x + y * y + z * z;\n\n  if (len > 0) {\n    //TODO: evaluate use of glm_invsqrt here?\n    len = 1 / Math.sqrt(len);\n  }\n\n  out[0] = a[0] * len;\n  out[1] = a[1] * len;\n  out[2] = a[2] * len;\n  return out;\n}\n/**\r\n * Calculates the dot product of two vec3's\r\n *\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @returns {Number} dot product of a and b\r\n */\n\nexport function dot(a, b) {\n  return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];\n}\n/**\r\n * Computes the cross product of two vec3's\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @returns {vec3} out\r\n */\n\nexport function cross(out, a, b) {\n  var ax = a[0],\n      ay = a[1],\n      az = a[2];\n  var bx = b[0],\n      by = b[1],\n      bz = b[2];\n  out[0] = ay * bz - az * by;\n  out[1] = az * bx - ax * bz;\n  out[2] = ax * by - ay * bx;\n  return out;\n}\n/**\r\n * Performs a linear interpolation between two vec3's\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\r\n * @returns {vec3} out\r\n */\n\nexport function lerp(out, a, b, t) {\n  var ax = a[0];\n  var ay = a[1];\n  var az = a[2];\n  out[0] = ax + t * (b[0] - ax);\n  out[1] = ay + t * (b[1] - ay);\n  out[2] = az + t * (b[2] - az);\n  return out;\n}\n/**\r\n * Performs a hermite interpolation with two control points\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @param {ReadonlyVec3} c the third operand\r\n * @param {ReadonlyVec3} d the fourth operand\r\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\r\n * @returns {vec3} out\r\n */\n\nexport function hermite(out, a, b, c, d, t) {\n  var factorTimes2 = t * t;\n  var factor1 = factorTimes2 * (2 * t - 3) + 1;\n  var factor2 = factorTimes2 * (t - 2) + t;\n  var factor3 = factorTimes2 * (t - 1);\n  var factor4 = factorTimes2 * (3 - 2 * t);\n  out[0] = a[0] * factor1 + b[0] * factor2 + c[0] * factor3 + d[0] * factor4;\n  out[1] = a[1] * factor1 + b[1] * factor2 + c[1] * factor3 + d[1] * factor4;\n  out[2] = a[2] * factor1 + b[2] * factor2 + c[2] * factor3 + d[2] * factor4;\n  return out;\n}\n/**\r\n * Performs a bezier interpolation with two control points\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the first operand\r\n * @param {ReadonlyVec3} b the second operand\r\n * @param {ReadonlyVec3} c the third operand\r\n * @param {ReadonlyVec3} d the fourth operand\r\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\r\n * @returns {vec3} out\r\n */\n\nexport function bezier(out, a, b, c, d, t) {\n  var inverseFactor = 1 - t;\n  var inverseFactorTimesTwo = inverseFactor * inverseFactor;\n  var factorTimes2 = t * t;\n  var factor1 = inverseFactorTimesTwo * inverseFactor;\n  var factor2 = 3 * t * inverseFactorTimesTwo;\n  var factor3 = 3 * factorTimes2 * inverseFactor;\n  var factor4 = factorTimes2 * t;\n  out[0] = a[0] * factor1 + b[0] * factor2 + c[0] * factor3 + d[0] * factor4;\n  out[1] = a[1] * factor1 + b[1] * factor2 + c[1] * factor3 + d[1] * factor4;\n  out[2] = a[2] * factor1 + b[2] * factor2 + c[2] * factor3 + d[2] * factor4;\n  return out;\n}\n/**\r\n * Generates a random vector with the given scale\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {Number} [scale] Length of the resulting vector. If ommitted, a unit vector will be returned\r\n * @returns {vec3} out\r\n */\n\nexport function random(out, scale) {\n  scale = scale || 1.0;\n  var r = glMatrix.RANDOM() * 2.0 * Math.PI;\n  var z = glMatrix.RANDOM() * 2.0 - 1.0;\n  var zScale = Math.sqrt(1.0 - z * z) * scale;\n  out[0] = Math.cos(r) * zScale;\n  out[1] = Math.sin(r) * zScale;\n  out[2] = z * scale;\n  return out;\n}\n/**\r\n * Transforms the vec3 with a mat4.\r\n * 4th vector component is implicitly '1'\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the vector to transform\r\n * @param {ReadonlyMat4} m matrix to transform with\r\n * @returns {vec3} out\r\n */\n\nexport function transformMat4(out, a, m) {\n  var x = a[0],\n      y = a[1],\n      z = a[2];\n  var w = m[3] * x + m[7] * y + m[11] * z + m[15];\n  w = w || 1.0;\n  out[0] = (m[0] * x + m[4] * y + m[8] * z + m[12]) / w;\n  out[1] = (m[1] * x + m[5] * y + m[9] * z + m[13]) / w;\n  out[2] = (m[2] * x + m[6] * y + m[10] * z + m[14]) / w;\n  return out;\n}\n/**\r\n * Transforms the vec3 with a mat3.\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the vector to transform\r\n * @param {ReadonlyMat3} m the 3x3 matrix to transform with\r\n * @returns {vec3} out\r\n */\n\nexport function transformMat3(out, a, m) {\n  var x = a[0],\n      y = a[1],\n      z = a[2];\n  out[0] = x * m[0] + y * m[3] + z * m[6];\n  out[1] = x * m[1] + y * m[4] + z * m[7];\n  out[2] = x * m[2] + y * m[5] + z * m[8];\n  return out;\n}\n/**\r\n * Transforms the vec3 with a quat\r\n * Can also be used for dual quaternions. (Multiply it with the real part)\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec3} a the vector to transform\r\n * @param {ReadonlyQuat} q quaternion to transform with\r\n * @returns {vec3} out\r\n */\n\nexport function transformQuat(out, a, q) {\n  // benchmarks: https://jsperf.com/quaternion-transform-vec3-implementations-fixed\n  var qx = q[0],\n      qy = q[1],\n      qz = q[2],\n      qw = q[3];\n  var x = a[0],\n      y = a[1],\n      z = a[2]; // var qvec = [qx, qy, qz];\n  // var uv = vec3.cross([], qvec, a);\n\n  var uvx = qy * z - qz * y,\n      uvy = qz * x - qx * z,\n      uvz = qx * y - qy * x; // var uuv = vec3.cross([], qvec, uv);\n\n  var uuvx = qy * uvz - qz * uvy,\n      uuvy = qz * uvx - qx * uvz,\n      uuvz = qx * uvy - qy * uvx; // vec3.scale(uv, uv, 2 * w);\n\n  var w2 = qw * 2;\n  uvx *= w2;\n  uvy *= w2;\n  uvz *= w2; // vec3.scale(uuv, uuv, 2);\n\n  uuvx *= 2;\n  uuvy *= 2;\n  uuvz *= 2; // return vec3.add(out, a, vec3.add(out, uv, uuv));\n\n  out[0] = x + uvx + uuvx;\n  out[1] = y + uvy + uuvy;\n  out[2] = z + uvz + uuvz;\n  return out;\n}\n/**\r\n * Rotate a 3D vector around the x-axis\r\n * @param {vec3} out The receiving vec3\r\n * @param {ReadonlyVec3} a The vec3 point to rotate\r\n * @param {ReadonlyVec3} b The origin of the rotation\r\n * @param {Number} rad The angle of rotation in radians\r\n * @returns {vec3} out\r\n */\n\nexport function rotateX(out, a, b, rad) {\n  var p = [],\n      r = []; //Translate point to the origin\n\n  p[0] = a[0] - b[0];\n  p[1] = a[1] - b[1];\n  p[2] = a[2] - b[2]; //perform rotation\n\n  r[0] = p[0];\n  r[1] = p[1] * Math.cos(rad) - p[2] * Math.sin(rad);\n  r[2] = p[1] * Math.sin(rad) + p[2] * Math.cos(rad); //translate to correct position\n\n  out[0] = r[0] + b[0];\n  out[1] = r[1] + b[1];\n  out[2] = r[2] + b[2];\n  return out;\n}\n/**\r\n * Rotate a 3D vector around the y-axis\r\n * @param {vec3} out The receiving vec3\r\n * @param {ReadonlyVec3} a The vec3 point to rotate\r\n * @param {ReadonlyVec3} b The origin of the rotation\r\n * @param {Number} rad The angle of rotation in radians\r\n * @returns {vec3} out\r\n */\n\nexport function rotateY(out, a, b, rad) {\n  var p = [],\n      r = []; //Translate point to the origin\n\n  p[0] = a[0] - b[0];\n  p[1] = a[1] - b[1];\n  p[2] = a[2] - b[2]; //perform rotation\n\n  r[0] = p[2] * Math.sin(rad) + p[0] * Math.cos(rad);\n  r[1] = p[1];\n  r[2] = p[2] * Math.cos(rad) - p[0] * Math.sin(rad); //translate to correct position\n\n  out[0] = r[0] + b[0];\n  out[1] = r[1] + b[1];\n  out[2] = r[2] + b[2];\n  return out;\n}\n/**\r\n * Rotate a 3D vector around the z-axis\r\n * @param {vec3} out The receiving vec3\r\n * @param {ReadonlyVec3} a The vec3 point to rotate\r\n * @param {ReadonlyVec3} b The origin of the rotation\r\n * @param {Number} rad The angle of rotation in radians\r\n * @returns {vec3} out\r\n */\n\nexport function rotateZ(out, a, b, rad) {\n  var p = [],\n      r = []; //Translate point to the origin\n\n  p[0] = a[0] - b[0];\n  p[1] = a[1] - b[1];\n  p[2] = a[2] - b[2]; //perform rotation\n\n  r[0] = p[0] * Math.cos(rad) - p[1] * Math.sin(rad);\n  r[1] = p[0] * Math.sin(rad) + p[1] * Math.cos(rad);\n  r[2] = p[2]; //translate to correct position\n\n  out[0] = r[0] + b[0];\n  out[1] = r[1] + b[1];\n  out[2] = r[2] + b[2];\n  return out;\n}\n/**\r\n * Get the angle between two 3D vectors\r\n * @param {ReadonlyVec3} a The first operand\r\n * @param {ReadonlyVec3} b The second operand\r\n * @returns {Number} The angle in radians\r\n */\n\nexport function angle(a, b) {\n  var ax = a[0],\n      ay = a[1],\n      az = a[2],\n      bx = b[0],\n      by = b[1],\n      bz = b[2],\n      mag1 = Math.sqrt(ax * ax + ay * ay + az * az),\n      mag2 = Math.sqrt(bx * bx + by * by + bz * bz),\n      mag = mag1 * mag2,\n      cosine = mag && dot(a, b) / mag;\n  return Math.acos(Math.min(Math.max(cosine, -1), 1));\n}\n/**\r\n * Set the components of a vec3 to zero\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @returns {vec3} out\r\n */\n\nexport function zero(out) {\n  out[0] = 0.0;\n  out[1] = 0.0;\n  out[2] = 0.0;\n  return out;\n}\n/**\r\n * Returns a string representation of a vector\r\n *\r\n * @param {ReadonlyVec3} a vector to represent as a string\r\n * @returns {String} string representation of the vector\r\n */\n\nexport function str(a) {\n  return \"vec3(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \")\";\n}\n/**\r\n * Returns whether or not the vectors have exactly the same elements in the same position (when compared with ===)\r\n *\r\n * @param {ReadonlyVec3} a The first vector.\r\n * @param {ReadonlyVec3} b The second vector.\r\n * @returns {Boolean} True if the vectors are equal, false otherwise.\r\n */\n\nexport function exactEquals(a, b) {\n  return a[0] === b[0] && a[1] === b[1] && a[2] === b[2];\n}\n/**\r\n * Returns whether or not the vectors have approximately the same elements in the same position.\r\n *\r\n * @param {ReadonlyVec3} a The first vector.\r\n * @param {ReadonlyVec3} b The second vector.\r\n * @returns {Boolean} True if the vectors are equal, false otherwise.\r\n */\n\nexport function equals(a, b) {\n  var a0 = a[0],\n      a1 = a[1],\n      a2 = a[2];\n  var b0 = b[0],\n      b1 = b[1],\n      b2 = b[2];\n  return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2));\n}\n/**\r\n * Alias for {@link vec3.subtract}\r\n * @function\r\n */\n\nexport var sub = subtract;\n/**\r\n * Alias for {@link vec3.multiply}\r\n * @function\r\n */\n\nexport var mul = multiply;\n/**\r\n * Alias for {@link vec3.divide}\r\n * @function\r\n */\n\nexport var div = divide;\n/**\r\n * Alias for {@link vec3.distance}\r\n * @function\r\n */\n\nexport var dist = distance;\n/**\r\n * Alias for {@link vec3.squaredDistance}\r\n * @function\r\n */\n\nexport var sqrDist = squaredDistance;\n/**\r\n * Alias for {@link vec3.length}\r\n * @function\r\n */\n\nexport var len = length;\n/**\r\n * Alias for {@link vec3.squaredLength}\r\n * @function\r\n */\n\nexport var sqrLen = squaredLength;\n/**\r\n * Perform some operation over an array of vec3s.\r\n *\r\n * @param {Array} a the array of vectors to iterate over\r\n * @param {Number} stride Number of elements between the start of each vec3. If 0 assumes tightly packed\r\n * @param {Number} offset Number of elements to skip at the beginning of the array\r\n * @param {Number} count Number of vec3s to iterate over. If 0 iterates over entire array\r\n * @param {Function} fn Function to call for each vector in the array\r\n * @param {Object} [arg] additional argument to pass to fn\r\n * @returns {Array} a\r\n * @function\r\n */\n\nexport var forEach = function () {\n  var vec = create();\n  return function (a, stride, offset, count, fn, arg) {\n    var i, l;\n\n    if (!stride) {\n      stride = 3;\n    }\n\n    if (!offset) {\n      offset = 0;\n    }\n\n    if (count) {\n      l = Math.min(count * stride + offset, a.length);\n    } else {\n      l = a.length;\n    }\n\n    for (i = offset; i < l; i += stride) {\n      vec[0] = a[i];\n      vec[1] = a[i + 1];\n      vec[2] = a[i + 2];\n      fn(vec, vec, arg);\n      a[i] = vec[0];\n      a[i + 1] = vec[1];\n      a[i + 2] = vec[2];\n    }\n\n    return a;\n  };\n}();","import Vector from './base/vector';\nimport { config, isArray } from '../lib/common';\nimport { checkNumber } from '../lib/validators';\nimport * as vec3 from 'gl-matrix/vec3';\nimport { vec3_transformMat2, vec3_transformMat4AsVector } from '../lib/gl-matrix-extras';\nconst ORIGIN = [0, 0, 0];\nlet ZERO;\nexport default class Vector3 extends Vector {\n  static get ZERO() {\n    if (!ZERO) {\n      ZERO = new Vector3(0, 0, 0);\n      Object.freeze(ZERO);\n    }\n\n    return ZERO;\n  }\n\n  constructor(x = 0, y = 0, z = 0) {\n    super(-0, -0, -0);\n\n    if (arguments.length === 1 && isArray(x)) {\n      this.copy(x);\n    } else {\n      if (config.debug) {\n        checkNumber(x);\n        checkNumber(y);\n        checkNumber(z);\n      }\n\n      this[0] = x;\n      this[1] = y;\n      this[2] = z;\n    }\n  }\n\n  set(x, y, z) {\n    this[0] = x;\n    this[1] = y;\n    this[2] = z;\n    return this.check();\n  }\n\n  copy(array) {\n    this[0] = array[0];\n    this[1] = array[1];\n    this[2] = array[2];\n    return this.check();\n  }\n\n  fromObject(object) {\n    if (config.debug) {\n      checkNumber(object.x);\n      checkNumber(object.y);\n      checkNumber(object.z);\n    }\n\n    this[0] = object.x;\n    this[1] = object.y;\n    this[2] = object.z;\n    return this.check();\n  }\n\n  toObject(object) {\n    object.x = this[0];\n    object.y = this[1];\n    object.z = this[2];\n    return object;\n  }\n\n  get ELEMENTS() {\n    return 3;\n  }\n\n  get z() {\n    return this[2];\n  }\n\n  set z(value) {\n    this[2] = checkNumber(value);\n  }\n\n  angle(vector) {\n    return vec3.angle(this, vector);\n  }\n\n  cross(vector) {\n    vec3.cross(this, this, vector);\n    return this.check();\n  }\n\n  rotateX({\n    radians,\n    origin = ORIGIN\n  }) {\n    vec3.rotateX(this, this, origin, radians);\n    return this.check();\n  }\n\n  rotateY({\n    radians,\n    origin = ORIGIN\n  }) {\n    vec3.rotateY(this, this, origin, radians);\n    return this.check();\n  }\n\n  rotateZ({\n    radians,\n    origin = ORIGIN\n  }) {\n    vec3.rotateZ(this, this, origin, radians);\n    return this.check();\n  }\n\n  transform(matrix4) {\n    return this.transformAsPoint(matrix4);\n  }\n\n  transformAsPoint(matrix4) {\n    vec3.transformMat4(this, this, matrix4);\n    return this.check();\n  }\n\n  transformAsVector(matrix4) {\n    vec3_transformMat4AsVector(this, this, matrix4);\n    return this.check();\n  }\n\n  transformByMatrix3(matrix3) {\n    vec3.transformMat3(this, this, matrix3);\n    return this.check();\n  }\n\n  transformByMatrix2(matrix2) {\n    vec3_transformMat2(this, this, matrix2);\n    return this.check();\n  }\n\n  transformByQuaternion(quaternion) {\n    vec3.transformQuat(this, this, quaternion);\n    return this.check();\n  }\n\n}\n//# sourceMappingURL=vector3.js.map","import { isBuffer, bufferToArrayBuffer } from './buffer-utils';\nexport function toArrayBuffer(data) {\n  if (isBuffer(data)) {\n    return bufferToArrayBuffer(data);\n  }\n\n  if (data instanceof ArrayBuffer) {\n    return data;\n  }\n\n  if (ArrayBuffer.isView(data)) {\n    if (data.byteOffset === 0 && data.byteLength === data.buffer.byteLength) {\n      return data.buffer;\n    }\n\n    return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);\n  }\n\n  if (typeof data === 'string') {\n    const text = data;\n    const uint8Array = new TextEncoder().encode(text);\n    return uint8Array.buffer;\n  }\n\n  if (data && typeof data === 'object' && data._toArrayBuffer) {\n    return data._toArrayBuffer();\n  }\n\n  throw new Error('toArrayBuffer');\n}\nexport function compareArrayBuffers(arrayBuffer1, arrayBuffer2, byteLength) {\n  byteLength = byteLength || arrayBuffer1.byteLength;\n\n  if (arrayBuffer1.byteLength < byteLength || arrayBuffer2.byteLength < byteLength) {\n    return false;\n  }\n\n  const array1 = new Uint8Array(arrayBuffer1);\n  const array2 = new Uint8Array(arrayBuffer2);\n\n  for (let i = 0; i < array1.length; ++i) {\n    if (array1[i] !== array2[i]) {\n      return false;\n    }\n  }\n\n  return true;\n}\nexport function concatenateArrayBuffers(...sources) {\n  const sourceArrays = sources.map(source2 => source2 instanceof ArrayBuffer ? new Uint8Array(source2) : source2);\n  const byteLength = sourceArrays.reduce((length, typedArray) => length + typedArray.byteLength, 0);\n  const result = new Uint8Array(byteLength);\n  let offset = 0;\n\n  for (const sourceArray of sourceArrays) {\n    result.set(sourceArray, offset);\n    offset += sourceArray.byteLength;\n  }\n\n  return result.buffer;\n}\nexport function concatenateTypedArrays(...typedArrays) {\n  const arrays = typedArrays;\n  const TypedArrayConstructor = arrays && arrays.length > 1 && arrays[0].constructor || null;\n\n  if (!TypedArrayConstructor) {\n    throw new Error('\"concatenateTypedArrays\" - incorrect quantity of arguments or arguments have incompatible data types');\n  }\n\n  const sumLength = arrays.reduce((acc, value) => acc + value.length, 0);\n  const result = new TypedArrayConstructor(sumLength);\n  let offset = 0;\n\n  for (const array of arrays) {\n    result.set(array, offset);\n    offset += array.length;\n  }\n\n  return result;\n}\nexport function sliceArrayBuffer(arrayBuffer, byteOffset, byteLength) {\n  const subArray = byteLength !== undefined ? new Uint8Array(arrayBuffer).subarray(byteOffset, byteOffset + byteLength) : new Uint8Array(arrayBuffer).subarray(byteOffset);\n  const arrayCopy = new Uint8Array(subArray);\n  return arrayCopy.buffer;\n}\n//# sourceMappingURL=array-buffer-utils.js.map","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n// View and Projection Matrix calculations for mapbox-js style\n// map view properties\nimport Viewport from './viewport';\n\nimport {\n  pixelsToWorld,\n  getViewMatrix,\n  addMetersToLngLat,\n  unitsPerMeter,\n  getProjectionParameters,\n  altitudeToFovy,\n  fovyToAltitude,\n  fitBounds,\n  getBounds\n} from '@math.gl/web-mercator';\nimport {Padding} from './viewport';\n\n// TODO - import from math.gl\nimport * as vec2 from 'gl-matrix/vec2';\nimport {Matrix4, clamp} from '@math.gl/core';\n\nexport type WebMercatorViewportOptions = {\n  /** Name of the viewport */\n  id?: string;\n  /** Left offset from the canvas edge, in pixels */\n  x?: number;\n  /** Top offset from the canvas edge, in pixels */\n  y?: number;\n  /** Viewport width in pixels */\n  width?: number;\n  /** Viewport height in pixels */\n  height?: number;\n  /** Longitude in degrees */\n  longitude?: number;\n  /** Latitude in degrees */\n  latitude?: number;\n  /** Tilt of the camera in degrees */\n  pitch?: number;\n  /** Heading of the camera in degrees */\n  bearing?: number;\n  /** Camera altitude relative to the viewport height, legacy property used to control the FOV. Default `1.5` */\n  altitude?: number;\n  /** Camera fovy in degrees. If provided, overrides `altitude` */\n  fovy?: number;\n  /** Viewport center in world space. If geospatial, refers to meter offsets from lng, lat */\n  position?: number[];\n  /** Zoom level */\n  zoom?: number;\n  /** Padding around the viewport, in pixels. */\n  padding?: Padding | null;\n  /** Model matrix of viewport center */\n  modelMatrix?: number[] | null;\n  /** Custom projection matrix */\n  projectionMatrix?: number[];\n  /** Use orthographic projection */\n  orthographic?: boolean;\n  /** Scaler for the near plane, 1 unit equals to the height of the viewport. Default `0.1` */\n  nearZMultiplier?: number;\n  /** Scaler for the far plane, 1 unit equals to the distance from the camera to the edge of the screen. Default `1.01` */\n  farZMultiplier?: number;\n  /** Render multiple copies of the world */\n  repeat?: boolean;\n  /** Internal use */\n  worldOffset?: number;\n  /** @deprecated Revert to approximated meter size calculation prior to v8.5 */\n  legacyMeterSizes?: boolean;\n};\n\n/**\n * Manages transformations to/from WGS84 coordinates using the Web Mercator Projection.\n */\nexport default class WebMercatorViewport extends Viewport {\n  static displayName = 'WebMercatorViewport';\n\n  longitude: number;\n  latitude: number;\n  pitch: number;\n  bearing: number;\n  altitude: number;\n  fovy: number;\n  orthographic: boolean;\n\n  /** Each sub viewport renders one copy of the world if repeat:true. The list is generated and cached on first request. */\n  private _subViewports: WebMercatorViewport[] | null;\n  /** @deprecated Revert to approximated meter size calculation prior to v8.5 */\n  private _pseudoMeters: boolean;\n\n  /* eslint-disable complexity, max-statements */\n  constructor(opts: WebMercatorViewportOptions = {}) {\n    const {\n      latitude = 0,\n      longitude = 0,\n      zoom = 0,\n      pitch = 0,\n      bearing = 0,\n      nearZMultiplier = 0.1,\n      farZMultiplier = 1.01,\n      orthographic = false,\n      projectionMatrix,\n\n      repeat = false,\n      worldOffset = 0,\n      position,\n      padding,\n\n      // backward compatibility\n      // TODO: remove in v9\n      legacyMeterSizes = false\n    } = opts;\n\n    let {width, height, altitude = 1.5} = opts;\n    const scale = Math.pow(2, zoom);\n\n    // Silently allow apps to send in 0,0 to facilitate isomorphic render etc\n    width = width || 1;\n    height = height || 1;\n\n    let fovy;\n    let projectionParameters: any = null;\n    if (projectionMatrix) {\n      altitude = projectionMatrix[5] / 2;\n      fovy = altitudeToFovy(altitude);\n    } else {\n      if (opts.fovy) {\n        fovy = opts.fovy;\n        altitude = fovyToAltitude(fovy);\n      } else {\n        fovy = altitudeToFovy(altitude);\n      }\n\n      let offset: [number, number] | undefined;\n      if (padding) {\n        const {top = 0, bottom = 0} = padding;\n        offset = [0, clamp((top + height - bottom) / 2, 0, height) - height / 2];\n      }\n\n      projectionParameters = getProjectionParameters({\n        width,\n        height,\n        scale,\n        center: position && [0, 0, position[2] * unitsPerMeter(latitude)],\n        offset,\n        pitch,\n        fovy,\n        nearZMultiplier,\n        farZMultiplier\n      });\n    }\n\n    // The uncentered matrix allows us two move the center addition to the\n    // shader (cheap) which gives a coordinate system that has its center in\n    // the layer's center position. This makes rotations and other modelMatrx\n    // transforms much more useful.\n    let viewMatrixUncentered = getViewMatrix({\n      height,\n      pitch,\n      bearing,\n      scale,\n      altitude\n    });\n\n    if (worldOffset) {\n      const viewOffset = new Matrix4().translate([512 * worldOffset, 0, 0]);\n      viewMatrixUncentered = viewOffset.multiplyLeft(viewMatrixUncentered);\n    }\n\n    super({\n      ...opts,\n      // x, y,\n      width,\n      height,\n\n      // view matrix\n      viewMatrix: viewMatrixUncentered,\n      longitude,\n      latitude,\n      zoom,\n\n      // projection matrix parameters\n      ...projectionParameters,\n      fovy,\n      focalDistance: altitude\n    });\n\n    // Save parameters\n    this.latitude = latitude;\n    this.longitude = longitude;\n    this.zoom = zoom;\n    this.pitch = pitch;\n    this.bearing = bearing;\n    this.altitude = altitude;\n    this.fovy = fovy;\n\n    this.orthographic = orthographic;\n\n    this._subViewports = repeat ? [] : null;\n    this._pseudoMeters = legacyMeterSizes;\n\n    Object.freeze(this);\n  }\n  /* eslint-enable complexity, max-statements */\n\n  get subViewports(): WebMercatorViewport[] | null {\n    if (this._subViewports && !this._subViewports.length) {\n      // Cache sub viewports so that we only calculate them once\n      const bounds = this.getBounds();\n\n      const minOffset = Math.floor((bounds[0] + 180) / 360);\n      const maxOffset = Math.ceil((bounds[2] - 180) / 360);\n\n      for (let x = minOffset; x <= maxOffset; x++) {\n        const offsetViewport = x\n          ? new WebMercatorViewport({\n              ...this,\n              worldOffset: x\n            })\n          : this;\n        this._subViewports.push(offsetViewport);\n      }\n    }\n    return this._subViewports;\n  }\n\n  projectPosition(xyz: number[]): [number, number, number] {\n    if (this._pseudoMeters) {\n      // Backward compatibility\n      return super.projectPosition(xyz);\n    }\n    const [X, Y] = this.projectFlat(xyz);\n    const Z = (xyz[2] || 0) * unitsPerMeter(xyz[1]);\n    return [X, Y, Z];\n  }\n\n  unprojectPosition(xyz: number[]): [number, number, number] {\n    if (this._pseudoMeters) {\n      // Backward compatibility\n      return super.unprojectPosition(xyz);\n    }\n    const [X, Y] = this.unprojectFlat(xyz);\n    const Z = (xyz[2] || 0) / unitsPerMeter(Y);\n    return [X, Y, Z];\n  }\n\n  /**\n   * Add a meter delta to a base lnglat coordinate, returning a new lnglat array\n   *\n   * Note: Uses simple linear approximation around the viewport center\n   * Error increases with size of offset (roughly 1% per 100km)\n   *\n   * @param {[Number,Number]|[Number,Number,Number]) lngLatZ - base coordinate\n   * @param {[Number,Number]|[Number,Number,Number]) xyz - array of meter deltas\n   * @return {[Number,Number]|[Number,Number,Number]) array of [lng,lat,z] deltas\n   */\n  addMetersToLngLat(lngLatZ: number[], xyz: number[]): number[] {\n    return addMetersToLngLat(lngLatZ, xyz);\n  }\n\n  panByPosition(coords: number[], pixel: number[]): WebMercatorViewportOptions {\n    const fromLocation = pixelsToWorld(pixel, this.pixelUnprojectionMatrix);\n    const toLocation = this.projectFlat(coords);\n\n    const translate = vec2.add([], toLocation, vec2.negate([], fromLocation));\n    const newCenter = vec2.add([], this.center, translate);\n\n    const [longitude, latitude] = this.unprojectFlat(newCenter);\n    return {longitude, latitude};\n  }\n\n  getBounds(options: {z?: number} = {}): [number, number, number, number] {\n    // @ts-ignore\n    const corners = getBounds(this, options.z || 0);\n\n    return [\n      Math.min(corners[0][0], corners[1][0], corners[2][0], corners[3][0]),\n      Math.min(corners[0][1], corners[1][1], corners[2][1], corners[3][1]),\n      Math.max(corners[0][0], corners[1][0], corners[2][0], corners[3][0]),\n      Math.max(corners[0][1], corners[1][1], corners[2][1], corners[3][1])\n    ];\n  }\n\n  /**\n   * Returns a new viewport that fit around the given rectangle.\n   * Only supports non-perspective mode.\n   */\n  fitBounds(\n    /** [[lon, lat], [lon, lat]] */\n    bounds: [[number, number], [number, number]],\n    options: {\n      /** If not supplied, will use the current width of the viewport (default `1`) */\n      width?: number;\n      /** If not supplied, will use the current height of the viewport (default `1`) */\n      height?: number;\n      /** In degrees, 0.01 would be about 1000 meters */\n      minExtent?: number;\n      /** Max zoom level */\n      maxZoom?: number;\n      /** Extra padding in pixels */\n      padding?: number | Required<Padding>;\n      /** Center shift in pixels */\n      offset?: number[];\n    } = {}\n  ) {\n    const {width, height} = this;\n    const {longitude, latitude, zoom} = fitBounds({width, height, bounds, ...options});\n    return new WebMercatorViewport({width, height, longitude, latitude, zoom});\n  }\n}\n","\nexport function convertToObjectRow(arrayRow, headers) {\n  if (!arrayRow) {\n    throw new Error('null row');\n  }\n  if (!headers) {\n    throw new Error('no headers');\n  }\n  const objectRow = {};\n  for (let i = 0; i < headers.length; i++) {\n    objectRow[headers[i]] = arrayRow[i];\n  }\n  return objectRow;\n}\n\nexport function convertToArrayRow(objectRow, headers) {\n  if (!objectRow) {\n    throw new Error('null row');\n  }\n  if (!headers) {\n    throw new Error('no headers');\n  }\n  const arrayRow = new Array(headers.length);\n  for (let i = 0; i < headers.length; i++) {\n    arrayRow[i] = objectRow[headers[i]];\n  }\n  return arrayRow;\n}\n//# sourceMappingURL=row-utils.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nlet _Symbol$asyncIterator;\n\nclass ArrayQueue extends Array {\n  enqueue(value) {\n    return this.push(value);\n  }\n  dequeue() {\n    return this.shift();\n  }\n}\n_Symbol$asyncIterator = Symbol.asyncIterator;\nexport default class AsyncQueue {\n  constructor() {\n    _defineProperty(this, \"_values\", void 0);\n    _defineProperty(this, \"_settlers\", void 0);\n    _defineProperty(this, \"_closed\", void 0);\n    this._values = new ArrayQueue();\n    this._settlers = new ArrayQueue();\n    this._closed = false;\n  }\n  close() {\n    while (this._settlers.length > 0) {\n      this._settlers.dequeue().resolve({\n        done: true\n      });\n    }\n    this._closed = true;\n  }\n  [_Symbol$asyncIterator]() {\n    return this;\n  }\n  enqueue(value) {\n    if (this._closed) {\n      throw new Error('Closed');\n    }\n    if (this._settlers.length > 0) {\n      if (this._values.length > 0) {\n        throw new Error('Illegal internal state');\n      }\n      const settler = this._settlers.dequeue();\n      if (value instanceof Error) {\n        settler.reject(value);\n      } else {\n        settler.resolve({\n          value\n        });\n      }\n    } else {\n      this._values.enqueue(value);\n    }\n  }\n\n  next() {\n    if (this._values.length > 0) {\n      const value = this._values.dequeue();\n      if (value instanceof Error) {\n        return Promise.reject(value);\n      }\n      return Promise.resolve({\n        value\n      });\n    }\n    if (this._closed) {\n      if (this._settlers.length > 0) {\n        throw new Error('Illegal internal state');\n      }\n      return Promise.resolve({\n        done: true\n      });\n    }\n    return new Promise((resolve, reject) => {\n      this._settlers.enqueue({\n        resolve,\n        reject\n      });\n    });\n  }\n}\n\nexport async function takeAsync(asyncIterable) {\n  let count = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : Infinity;\n  const result = [];\n  const iterator = asyncIterable[Symbol.asyncIterator]();\n  while (result.length < count) {\n    const {\n      value,\n      done\n    } = await iterator.next();\n    if (done) {\n      break;\n    }\n    result.push(value);\n  }\n  return result;\n}\n//# sourceMappingURL=async-queue.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nconst DEFAULT_ROW_COUNT = 100;\nexport default class RowTableBatchAggregator {\n  constructor(schema, options) {\n    _defineProperty(this, \"schema\", void 0);\n    _defineProperty(this, \"options\", void 0);\n    _defineProperty(this, \"length\", 0);\n    _defineProperty(this, \"rows\", null);\n    _defineProperty(this, \"cursor\", 0);\n    _defineProperty(this, \"_headers\", []);\n    this.options = options;\n    this.schema = schema;\n\n    if (!Array.isArray(schema)) {\n      this._headers = [];\n      for (const key in schema) {\n        this._headers[schema[key].index] = schema[key].name;\n      }\n    }\n  }\n  rowCount() {\n    return this.length;\n  }\n  addArrayRow(row, cursor) {\n    if (Number.isFinite(cursor)) {\n      this.cursor = cursor;\n    }\n    this.rows = this.rows || new Array(DEFAULT_ROW_COUNT);\n    this.rows[this.length] = row;\n    this.length++;\n  }\n  addObjectRow(row, cursor) {\n    if (Number.isFinite(cursor)) {\n      this.cursor = cursor;\n    }\n    this.rows = this.rows || new Array(DEFAULT_ROW_COUNT);\n    this.rows[this.length] = row;\n    this.length++;\n  }\n  getBatch() {\n    let rows = this.rows;\n    if (!rows) {\n      return null;\n    }\n    rows = rows.slice(0, this.length);\n    this.rows = null;\n    const batch = {\n      shape: this.options.shape,\n      batchType: 'data',\n      data: rows,\n      length: this.length,\n      schema: this.schema,\n      cursor: this.cursor\n    };\n    return batch;\n  }\n}\n//# sourceMappingURL=base-table-batch-aggregator.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { convertToArrayRow, convertToObjectRow } from '../utils/row-utils';\nconst DEFAULT_ROW_COUNT = 100;\nexport default class RowTableBatchAggregator {\n  constructor(schema, options) {\n    _defineProperty(this, \"schema\", void 0);\n    _defineProperty(this, \"options\", void 0);\n    _defineProperty(this, \"length\", 0);\n    _defineProperty(this, \"objectRows\", null);\n    _defineProperty(this, \"arrayRows\", null);\n    _defineProperty(this, \"cursor\", 0);\n    _defineProperty(this, \"_headers\", []);\n    this.options = options;\n    this.schema = schema;\n\n    if (!Array.isArray(schema)) {\n      this._headers = [];\n      for (const key in schema) {\n        this._headers[schema[key].index] = schema[key].name;\n      }\n    }\n  }\n  rowCount() {\n    return this.length;\n  }\n  addArrayRow(row, cursor) {\n    if (Number.isFinite(cursor)) {\n      this.cursor = cursor;\n    }\n\n    switch (this.options.shape) {\n      case 'object-row-table':\n        const rowObject = convertToObjectRow(row, this._headers);\n        this.addObjectRow(rowObject, cursor);\n        break;\n      case 'array-row-table':\n        this.arrayRows = this.arrayRows || new Array(DEFAULT_ROW_COUNT);\n        this.arrayRows[this.length] = row;\n        this.length++;\n        break;\n    }\n  }\n  addObjectRow(row, cursor) {\n    if (Number.isFinite(cursor)) {\n      this.cursor = cursor;\n    }\n\n    switch (this.options.shape) {\n      case 'array-row-table':\n        const rowArray = convertToArrayRow(row, this._headers);\n        this.addArrayRow(rowArray, cursor);\n        break;\n      case 'object-row-table':\n        this.objectRows = this.objectRows || new Array(DEFAULT_ROW_COUNT);\n        this.objectRows[this.length] = row;\n        this.length++;\n        break;\n    }\n  }\n  getBatch() {\n    let rows = this.arrayRows || this.objectRows;\n    if (!rows) {\n      return null;\n    }\n    rows = rows.slice(0, this.length);\n    this.arrayRows = null;\n    this.objectRows = null;\n    return {\n      shape: this.options.shape,\n      batchType: 'data',\n      data: rows,\n      length: this.length,\n      schema: this.schema,\n      cursor: this.cursor\n    };\n  }\n}\n//# sourceMappingURL=row-table-batch-aggregator.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nconst DEFAULT_ROW_COUNT = 100;\nexport default class ColumnarTableBatchAggregator {\n  constructor(schema, options) {\n    _defineProperty(this, \"schema\", void 0);\n    _defineProperty(this, \"length\", 0);\n    _defineProperty(this, \"allocated\", 0);\n    _defineProperty(this, \"columns\", {});\n    this.schema = schema;\n    this._reallocateColumns();\n  }\n  rowCount() {\n    return this.length;\n  }\n  addArrayRow(row) {\n    this._reallocateColumns();\n    let i = 0;\n    for (const fieldName in this.columns) {\n      this.columns[fieldName][this.length] = row[i++];\n    }\n    this.length++;\n  }\n  addObjectRow(row) {\n    this._reallocateColumns();\n    for (const fieldName in row) {\n      this.columns[fieldName][this.length] = row[fieldName];\n    }\n    this.length++;\n  }\n  getBatch() {\n    this._pruneColumns();\n    const columns = Array.isArray(this.schema) ? this.columns : {};\n\n    if (!Array.isArray(this.schema)) {\n      for (const fieldName in this.schema) {\n        const field = this.schema[fieldName];\n        columns[field.name] = this.columns[field.index];\n      }\n    }\n    this.columns = {};\n    const batch = {\n      shape: 'columnar-table',\n      batchType: 'data',\n      data: columns,\n      schema: this.schema,\n      length: this.length\n    };\n    return batch;\n  }\n\n  _reallocateColumns() {\n    if (this.length < this.allocated) {\n      return;\n    }\n\n    this.allocated = this.allocated > 0 ? this.allocated *= 2 : DEFAULT_ROW_COUNT;\n    this.columns = {};\n    for (const fieldName in this.schema) {\n      const field = this.schema[fieldName];\n      const ArrayType = field.type || Float32Array;\n      const oldColumn = this.columns[field.index];\n      if (oldColumn && ArrayBuffer.isView(oldColumn)) {\n        const typedArray = new ArrayType(this.allocated);\n        typedArray.set(oldColumn);\n        this.columns[field.index] = typedArray;\n      } else if (oldColumn) {\n        oldColumn.length = this.allocated;\n        this.columns[field.index] = oldColumn;\n      } else {\n        this.columns[field.index] = new ArrayType(this.allocated);\n      }\n    }\n  }\n  _pruneColumns() {\n    for (const [columnName, column] of Object.entries(this.columns)) {\n      this.columns[columnName] = column.slice(0, this.length);\n    }\n  }\n}\n//# sourceMappingURL=columnar-table-batch-aggregator.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport BaseTableBatchAggregator from './base-table-batch-aggregator';\nimport RowTableBatchAggregator from './row-table-batch-aggregator';\nimport ColumnarTableBatchAggregator from './columnar-table-batch-aggregator';\n\nconst DEFAULT_OPTIONS = {\n  shape: 'array-row-table',\n  batchSize: 'auto',\n  batchDebounceMs: 0,\n  limit: 0,\n  _limitMB: 0\n};\nconst ERR_MESSAGE = 'TableBatchBuilder';\n\nexport default class TableBatchBuilder {\n  constructor(schema, options) {\n    _defineProperty(this, \"schema\", void 0);\n    _defineProperty(this, \"options\", void 0);\n    _defineProperty(this, \"aggregator\", null);\n    _defineProperty(this, \"batchCount\", 0);\n    _defineProperty(this, \"bytesUsed\", 0);\n    _defineProperty(this, \"isChunkComplete\", false);\n    _defineProperty(this, \"lastBatchEmittedMs\", Date.now());\n    _defineProperty(this, \"totalLength\", 0);\n    _defineProperty(this, \"totalBytes\", 0);\n    _defineProperty(this, \"rowBytes\", 0);\n    this.schema = schema;\n    this.options = {\n      ...DEFAULT_OPTIONS,\n      ...options\n    };\n  }\n  limitReached() {\n    var _this$options, _this$options2;\n    if (Boolean((_this$options = this.options) === null || _this$options === void 0 ? void 0 : _this$options.limit) && this.totalLength >= this.options.limit) {\n      return true;\n    }\n    if (Boolean((_this$options2 = this.options) === null || _this$options2 === void 0 ? void 0 : _this$options2._limitMB) && this.totalBytes / 1e6 >= this.options._limitMB) {\n      return true;\n    }\n    return false;\n  }\n\n  addRow(row) {\n    if (this.limitReached()) {\n      return;\n    }\n    this.totalLength++;\n    this.rowBytes = this.rowBytes || this._estimateRowMB(row);\n    this.totalBytes += this.rowBytes;\n    if (Array.isArray(row)) {\n      this.addArrayRow(row);\n    } else {\n      this.addObjectRow(row);\n    }\n  }\n\n  addArrayRow(row) {\n    if (!this.aggregator) {\n      const TableBatchType = this._getTableBatchType();\n      this.aggregator = new TableBatchType(this.schema, this.options);\n    }\n    this.aggregator.addArrayRow(row);\n  }\n\n  addObjectRow(row) {\n    if (!this.aggregator) {\n      const TableBatchType = this._getTableBatchType();\n      this.aggregator = new TableBatchType(this.schema, this.options);\n    }\n    this.aggregator.addObjectRow(row);\n  }\n\n  chunkComplete(chunk) {\n    if (chunk instanceof ArrayBuffer) {\n      this.bytesUsed += chunk.byteLength;\n    }\n    if (typeof chunk === 'string') {\n      this.bytesUsed += chunk.length;\n    }\n    this.isChunkComplete = true;\n  }\n  getFullBatch(options) {\n    return this._isFull() ? this._getBatch(options) : null;\n  }\n  getFinalBatch(options) {\n    return this._getBatch(options);\n  }\n\n  _estimateRowMB(row) {\n    return Array.isArray(row) ? row.length * 8 : Object.keys(row).length * 8;\n  }\n  _isFull() {\n    if (!this.aggregator || this.aggregator.rowCount() === 0) {\n      return false;\n    }\n\n    if (this.options.batchSize === 'auto') {\n      if (!this.isChunkComplete) {\n        return false;\n      }\n    } else if (this.options.batchSize > this.aggregator.rowCount()) {\n      return false;\n    }\n\n    if (this.options.batchDebounceMs > Date.now() - this.lastBatchEmittedMs) {\n      return false;\n    }\n\n    this.isChunkComplete = false;\n    this.lastBatchEmittedMs = Date.now();\n    return true;\n  }\n\n  _getBatch(options) {\n    if (!this.aggregator) {\n      return null;\n    }\n\n    if (options !== null && options !== void 0 && options.bytesUsed) {\n      this.bytesUsed = options.bytesUsed;\n    }\n    const normalizedBatch = this.aggregator.getBatch();\n    normalizedBatch.count = this.batchCount;\n    normalizedBatch.bytesUsed = this.bytesUsed;\n    Object.assign(normalizedBatch, options);\n    this.batchCount++;\n    this.aggregator = null;\n    return normalizedBatch;\n  }\n  _getTableBatchType() {\n    switch (this.options.shape) {\n      case 'row-table':\n        return BaseTableBatchAggregator;\n      case 'array-row-table':\n      case 'object-row-table':\n        return RowTableBatchAggregator;\n      case 'columnar-table':\n        return ColumnarTableBatchAggregator;\n      case 'arrow-table':\n        if (!TableBatchBuilder.ArrowBatch) {\n          throw new Error(ERR_MESSAGE);\n        }\n        return TableBatchBuilder.ArrowBatch;\n      default:\n        throw new Error(ERR_MESSAGE);\n    }\n  }\n}\n_defineProperty(TableBatchBuilder, \"ArrowBatch\", void 0);\n//# sourceMappingURL=table-batch-builder.js.map","\n/* @license\nPapa Parse\nv5.0.0-beta.0\nhttps://github.com/mholt/PapaParse\nLicense: MIT\n*/\n\nconst BYTE_ORDER_MARK = '\\ufeff';\nconst Papa = {\n  parse: CsvToJson,\n  unparse: JsonToCsv,\n  RECORD_SEP: String.fromCharCode(30),\n  UNIT_SEP: String.fromCharCode(31),\n  BYTE_ORDER_MARK,\n  BAD_DELIMITERS: ['\\r', '\\n', '\"', BYTE_ORDER_MARK],\n  WORKERS_SUPPORTED: false,\n  NODE_STREAM_INPUT: 1,\n  LocalChunkSize: 1024 * 1024 * 10,\n  RemoteChunkSize: 1024 * 1024 * 5,\n  DefaultDelimiter: ',',\n\n  Parser: Parser,\n  ParserHandle: ParserHandle,\n  ChunkStreamer: ChunkStreamer,\n  StringStreamer: StringStreamer\n};\nexport default Papa;\n\nfunction\n\nCsvToJson(_input, _config, UserDefinedStreamer) {\n  _config = _config || {};\n  var dynamicTyping = _config.dynamicTyping || false;\n  if (isFunction(dynamicTyping)) {\n    _config.dynamicTypingFunction = dynamicTyping;\n    dynamicTyping = {};\n  }\n  _config.dynamicTyping = dynamicTyping;\n  _config.transform = isFunction(_config.transform) ? _config.transform : false;\n  if (_config.worker && Papa.WORKERS_SUPPORTED) {\n    var w = newWorker();\n    w.userStep = _config.step;\n    w.userChunk = _config.chunk;\n    w.userComplete = _config.complete;\n    w.userError = _config.error;\n    _config.step = isFunction(_config.step);\n    _config.chunk = isFunction(_config.chunk);\n    _config.complete = isFunction(_config.complete);\n    _config.error = isFunction(_config.error);\n    delete _config.worker;\n\n    w.postMessage({\n      input: _input,\n      config: _config,\n      workerId: w.id\n    });\n    return;\n  }\n  var streamer = null;\n  if (typeof _input === 'string') {\n    streamer = new StringStreamer(_config);\n  }\n\n  if (!streamer) {\n    streamer = new UserDefinedStreamer(_config);\n  }\n\n  return streamer.stream(_input);\n}\nfunction JsonToCsv(_input, _config) {\n\n  var _quotes = false;\n\n  var _writeHeader = true;\n\n  var _delimiter = ',';\n\n  var _newline = '\\r\\n';\n\n  var _quoteChar = '\"';\n\n  var _escapedQuote = _quoteChar + _quoteChar;\n\n  var _skipEmptyLines = false;\n\n  var _columns = null;\n  unpackConfig();\n  var quoteCharRegex = new RegExp(escapeRegExp(_quoteChar), 'g');\n  if (typeof _input === 'string') _input = JSON.parse(_input);\n  if (Array.isArray(_input)) {\n    if (!_input.length || Array.isArray(_input[0])) return serialize(null, _input, _skipEmptyLines);else if (typeof _input[0] === 'object') return serialize(_columns || objectKeys(_input[0]), _input, _skipEmptyLines);\n  } else if (typeof _input === 'object') {\n    if (typeof _input.data === 'string') _input.data = JSON.parse(_input.data);\n    if (Array.isArray(_input.data)) {\n      if (!_input.fields) _input.fields = _input.meta && _input.meta.fields;\n      if (!_input.fields) _input.fields = Array.isArray(_input.data[0]) ? _input.fields : objectKeys(_input.data[0]);\n      if (!Array.isArray(_input.data[0]) && typeof _input.data[0] !== 'object') _input.data = [_input.data];\n    }\n\n    return serialize(_input.fields || [], _input.data || [], _skipEmptyLines);\n  }\n\n  throw new Error('Unable to serialize unrecognized input');\n  function unpackConfig() {\n    if (typeof _config !== 'object') return;\n    if (typeof _config.delimiter === 'string' && !Papa.BAD_DELIMITERS.filter(function (value) {\n      return _config.delimiter.indexOf(value) !== -1;\n    }).length) {\n      _delimiter = _config.delimiter;\n    }\n    if (typeof _config.quotes === 'boolean' || Array.isArray(_config.quotes)) _quotes = _config.quotes;\n    if (typeof _config.skipEmptyLines === 'boolean' || typeof _config.skipEmptyLines === 'string') _skipEmptyLines = _config.skipEmptyLines;\n    if (typeof _config.newline === 'string') _newline = _config.newline;\n    if (typeof _config.quoteChar === 'string') _quoteChar = _config.quoteChar;\n    if (typeof _config.header === 'boolean') _writeHeader = _config.header;\n    if (Array.isArray(_config.columns)) {\n      if (_config.columns.length === 0) throw new Error('Option columns is empty');\n      _columns = _config.columns;\n    }\n    if (_config.escapeChar !== undefined) {\n      _escapedQuote = _config.escapeChar + _quoteChar;\n    }\n  }\n\n  function objectKeys(obj) {\n    if (typeof obj !== 'object') return [];\n    var keys = [];\n    for (var key in obj) keys.push(key);\n    return keys;\n  }\n\n  function serialize(fields, data, skipEmptyLines) {\n    var csv = '';\n    if (typeof fields === 'string') fields = JSON.parse(fields);\n    if (typeof data === 'string') data = JSON.parse(data);\n    var hasHeader = Array.isArray(fields) && fields.length > 0;\n    var dataKeyedByField = !Array.isArray(data[0]);\n\n    if (hasHeader && _writeHeader) {\n      for (var i = 0; i < fields.length; i++) {\n        if (i > 0) csv += _delimiter;\n        csv += safe(fields[i], i);\n      }\n      if (data.length > 0) csv += _newline;\n    }\n\n    for (var row = 0; row < data.length; row++) {\n      var maxCol = hasHeader ? fields.length : data[row].length;\n      var emptyLine = false;\n      var nullLine = hasHeader ? Object.keys(data[row]).length === 0 : data[row].length === 0;\n      if (skipEmptyLines && !hasHeader) {\n        emptyLine = skipEmptyLines === 'greedy' ? data[row].join('').trim() === '' : data[row].length === 1 && data[row][0].length === 0;\n      }\n      if (skipEmptyLines === 'greedy' && hasHeader) {\n        var line = [];\n        for (var c = 0; c < maxCol; c++) {\n          var cx = dataKeyedByField ? fields[c] : c;\n          line.push(data[row][cx]);\n        }\n        emptyLine = line.join('').trim() === '';\n      }\n      if (!emptyLine) {\n        for (var col = 0; col < maxCol; col++) {\n          if (col > 0 && !nullLine) csv += _delimiter;\n          var colIdx = hasHeader && dataKeyedByField ? fields[col] : col;\n          csv += safe(data[row][colIdx], col);\n        }\n        if (row < data.length - 1 && (!skipEmptyLines || maxCol > 0 && !nullLine)) {\n          csv += _newline;\n        }\n      }\n    }\n    return csv;\n  }\n\n  function safe(str, col) {\n    if (typeof str === 'undefined' || str === null) return '';\n    if (str.constructor === Date) return JSON.stringify(str).slice(1, 25);\n    str = str.toString().replace(quoteCharRegex, _escapedQuote);\n    var needsQuotes = typeof _quotes === 'boolean' && _quotes || Array.isArray(_quotes) && _quotes[col] || hasAny(str, Papa.BAD_DELIMITERS) || str.indexOf(_delimiter) > -1 || str.charAt(0) === ' ' || str.charAt(str.length - 1) === ' ';\n    return needsQuotes ? _quoteChar + str + _quoteChar : str;\n  }\n  function hasAny(str, substrings) {\n    for (var i = 0; i < substrings.length; i++) if (str.indexOf(substrings[i]) > -1) return true;\n    return false;\n  }\n}\n\nfunction ChunkStreamer(config) {\n  this._handle = null;\n  this._finished = false;\n  this._completed = false;\n  this._input = null;\n  this._baseIndex = 0;\n  this._partialLine = '';\n  this._rowCount = 0;\n  this._start = 0;\n  this._nextChunk = null;\n  this.isFirstChunk = true;\n  this._completeResults = {\n    data: [],\n    errors: [],\n    meta: {}\n  };\n  replaceConfig.call(this, config);\n  this.parseChunk = function (chunk, isFakeChunk) {\n    if (this.isFirstChunk && isFunction(this._config.beforeFirstChunk)) {\n      var modifiedChunk = this._config.beforeFirstChunk(chunk);\n      if (modifiedChunk !== undefined) chunk = modifiedChunk;\n    }\n    this.isFirstChunk = false;\n\n    var aggregate = this._partialLine + chunk;\n    this._partialLine = '';\n    var results = this._handle.parse(aggregate, this._baseIndex, !this._finished);\n    if (this._handle.paused() || this._handle.aborted()) return;\n    var lastIndex = results.meta.cursor;\n    if (!this._finished) {\n      this._partialLine = aggregate.substring(lastIndex - this._baseIndex);\n      this._baseIndex = lastIndex;\n    }\n    if (results && results.data) this._rowCount += results.data.length;\n    var finishedIncludingPreview = this._finished || this._config.preview && this._rowCount >= this._config.preview;\n    if (isFunction(this._config.chunk) && !isFakeChunk) {\n      this._config.chunk(results, this._handle);\n      if (this._handle.paused() || this._handle.aborted()) return;\n      results = undefined;\n      this._completeResults = undefined;\n    }\n    if (!this._config.step && !this._config.chunk) {\n      this._completeResults.data = this._completeResults.data.concat(results.data);\n      this._completeResults.errors = this._completeResults.errors.concat(results.errors);\n      this._completeResults.meta = results.meta;\n    }\n    if (!this._completed && finishedIncludingPreview && isFunction(this._config.complete) && (!results || !results.meta.aborted)) {\n      this._config.complete(this._completeResults, this._input);\n      this._completed = true;\n    }\n    if (!finishedIncludingPreview && (!results || !results.meta.paused)) this._nextChunk();\n    return results;\n  };\n  this._sendError = function (error) {\n    if (isFunction(this._config.error)) this._config.error(error);\n  };\n  function replaceConfig(config) {\n    var configCopy = copy(config);\n    configCopy.chunkSize = parseInt(configCopy.chunkSize);\n    if (!config.step && !config.chunk) configCopy.chunkSize = null;\n    this._handle = new ParserHandle(configCopy);\n    this._handle.streamer = this;\n    this._config = configCopy;\n  }\n}\n\nfunction StringStreamer(config) {\n  config = config || {};\n  ChunkStreamer.call(this, config);\n  var remaining;\n  this.stream = function (s) {\n    remaining = s;\n    return this._nextChunk();\n  };\n  this._nextChunk = function () {\n    if (this._finished) return;\n    var size = this._config.chunkSize;\n    var chunk = size ? remaining.substr(0, size) : remaining;\n    remaining = size ? remaining.substr(size) : '';\n    this._finished = !remaining;\n    return this.parseChunk(chunk);\n  };\n}\nStringStreamer.prototype = Object.create(StringStreamer.prototype);\nStringStreamer.prototype.constructor = StringStreamer;\n\nfunction ParserHandle(_config) {\n  var FLOAT = /^\\s*-?(\\d*\\.?\\d+|\\d+\\.?\\d*)(e[-+]?\\d+)?\\s*$/i;\n  var ISO_DATE = /(\\d{4}-[01]\\d-[0-3]\\dT[0-2]\\d:[0-5]\\d:[0-5]\\d\\.\\d+([+-][0-2]\\d:[0-5]\\d|Z))|(\\d{4}-[01]\\d-[0-3]\\dT[0-2]\\d:[0-5]\\d:[0-5]\\d([+-][0-2]\\d:[0-5]\\d|Z))|(\\d{4}-[01]\\d-[0-3]\\dT[0-2]\\d:[0-5]\\d([+-][0-2]\\d:[0-5]\\d|Z))/;\n  var self = this;\n  var _stepCounter = 0;\n  var _rowCounter = 0;\n  var _input;\n  var _parser;\n  var _paused = false;\n  var _aborted = false;\n  var _delimiterError;\n  var _fields = [];\n  var _results = {\n    data: [],\n    errors: [],\n    meta: {}\n  };\n  if (isFunction(_config.step)) {\n    var userStep = _config.step;\n    _config.step = function (results) {\n      _results = results;\n      if (needsHeaderRow()) processResults();\n      else {\n        processResults();\n\n        if (!_results.data || _results.data.length === 0) return;\n        _stepCounter += results.data.length;\n        if (_config.preview && _stepCounter > _config.preview) _parser.abort();else userStep(_results, self);\n      }\n    };\n  }\n\n  this.parse = function (input, baseIndex, ignoreLastRow) {\n    var quoteChar = _config.quoteChar || '\"';\n    if (!_config.newline) _config.newline = guessLineEndings(input, quoteChar);\n    _delimiterError = false;\n    if (!_config.delimiter) {\n      var delimGuess = guessDelimiter(input, _config.newline, _config.skipEmptyLines, _config.comments, _config.delimitersToGuess);\n      if (delimGuess.successful) _config.delimiter = delimGuess.bestDelimiter;else {\n        _delimiterError = true;\n        _config.delimiter = Papa.DefaultDelimiter;\n      }\n      _results.meta.delimiter = _config.delimiter;\n    } else if (isFunction(_config.delimiter)) {\n      _config.delimiter = _config.delimiter(input);\n      _results.meta.delimiter = _config.delimiter;\n    }\n    var parserConfig = copy(_config);\n    if (_config.preview && _config.header) parserConfig.preview++;\n\n    _input = input;\n    _parser = new Parser(parserConfig);\n    _results = _parser.parse(_input, baseIndex, ignoreLastRow);\n    processResults();\n    return _paused ? {\n      meta: {\n        paused: true\n      }\n    } : _results || {\n      meta: {\n        paused: false\n      }\n    };\n  };\n  this.paused = function () {\n    return _paused;\n  };\n  this.pause = function () {\n    _paused = true;\n    _parser.abort();\n    _input = _input.substr(_parser.getCharIndex());\n  };\n  this.resume = function () {\n    _paused = false;\n    self.streamer.parseChunk(_input, true);\n  };\n  this.aborted = function () {\n    return _aborted;\n  };\n  this.abort = function () {\n    _aborted = true;\n    _parser.abort();\n    _results.meta.aborted = true;\n    if (isFunction(_config.complete)) _config.complete(_results);\n    _input = '';\n  };\n  function testEmptyLine(s) {\n    return _config.skipEmptyLines === 'greedy' ? s.join('').trim() === '' : s.length === 1 && s[0].length === 0;\n  }\n  function processResults() {\n    if (_results && _delimiterError) {\n      addError('Delimiter', 'UndetectableDelimiter', \"Unable to auto-detect delimiting character; defaulted to '\" + Papa.DefaultDelimiter + \"'\");\n      _delimiterError = false;\n    }\n    if (_config.skipEmptyLines) {\n      for (var i = 0; i < _results.data.length; i++) if (testEmptyLine(_results.data[i])) _results.data.splice(i--, 1);\n    }\n    if (needsHeaderRow()) fillHeaderFields();\n    return applyHeaderAndDynamicTypingAndTransformation();\n  }\n  function needsHeaderRow() {\n    return _config.header && _fields.length === 0;\n  }\n  function fillHeaderFields() {\n    if (!_results) return;\n    function addHeder(header) {\n      if (isFunction(_config.transformHeader)) header = _config.transformHeader(header);\n      _fields.push(header);\n    }\n    if (Array.isArray(_results.data[0])) {\n      for (var i = 0; needsHeaderRow() && i < _results.data.length; i++) _results.data[i].forEach(addHeder);\n      _results.data.splice(0, 1);\n    }\n    else _results.data.forEach(addHeder);\n  }\n  function shouldApplyDynamicTyping(field) {\n    if (_config.dynamicTypingFunction && _config.dynamicTyping[field] === undefined) {\n      _config.dynamicTyping[field] = _config.dynamicTypingFunction(field);\n    }\n    return (_config.dynamicTyping[field] || _config.dynamicTyping) === true;\n  }\n  function parseDynamic(field, value) {\n    if (shouldApplyDynamicTyping(field)) {\n      if (value === 'true' || value === 'TRUE') return true;else if (value === 'false' || value === 'FALSE') return false;else if (FLOAT.test(value)) return parseFloat(value);else if (ISO_DATE.test(value)) return new Date(value);else return value === '' ? null : value;\n    }\n    return value;\n  }\n  function applyHeaderAndDynamicTypingAndTransformation() {\n    if (!_results || !_results.data || !_config.header && !_config.dynamicTyping && !_config.transform) return _results;\n    function processRow(rowSource, i) {\n      var row = _config.header ? {} : [];\n      var j;\n      for (j = 0; j < rowSource.length; j++) {\n        var field = j;\n        var value = rowSource[j];\n        if (_config.header) field = j >= _fields.length ? '__parsed_extra' : _fields[j];\n        if (_config.transform) value = _config.transform(value, field);\n        value = parseDynamic(field, value);\n        if (field === '__parsed_extra') {\n          row[field] = row[field] || [];\n          row[field].push(value);\n        } else row[field] = value;\n      }\n      if (_config.header) {\n        if (j > _fields.length) addError('FieldMismatch', 'TooManyFields', 'Too many fields: expected ' + _fields.length + ' fields but parsed ' + j, _rowCounter + i);else if (j < _fields.length) addError('FieldMismatch', 'TooFewFields', 'Too few fields: expected ' + _fields.length + ' fields but parsed ' + j, _rowCounter + i);\n      }\n      return row;\n    }\n    var incrementBy = 1;\n    if (!_results.data[0] || Array.isArray(_results.data[0])) {\n      _results.data = _results.data.map(processRow);\n      incrementBy = _results.data.length;\n    } else _results.data = processRow(_results.data, 0);\n    if (_config.header && _results.meta) _results.meta.fields = _fields;\n    _rowCounter += incrementBy;\n    return _results;\n  }\n  function guessDelimiter(input, newline, skipEmptyLines, comments, delimitersToGuess) {\n    var bestDelim, bestDelta, fieldCountPrevRow;\n    delimitersToGuess = delimitersToGuess || [',', '\\t', '|', ';', Papa.RECORD_SEP, Papa.UNIT_SEP];\n    for (var i = 0; i < delimitersToGuess.length; i++) {\n      var delim = delimitersToGuess[i];\n      var delta = 0,\n        avgFieldCount = 0,\n        emptyLinesCount = 0;\n      fieldCountPrevRow = undefined;\n      var preview = new Parser({\n        comments: comments,\n        delimiter: delim,\n        newline: newline,\n        preview: 10\n      }).parse(input);\n      for (var j = 0; j < preview.data.length; j++) {\n        if (skipEmptyLines && testEmptyLine(preview.data[j])) {\n          emptyLinesCount++;\n          continue;\n        }\n        var fieldCount = preview.data[j].length;\n        avgFieldCount += fieldCount;\n        if (typeof fieldCountPrevRow === 'undefined') {\n          fieldCountPrevRow = 0;\n          continue;\n        } else if (fieldCount > 1) {\n          delta += Math.abs(fieldCount - fieldCountPrevRow);\n          fieldCountPrevRow = fieldCount;\n        }\n      }\n      if (preview.data.length > 0) avgFieldCount /= preview.data.length - emptyLinesCount;\n      if ((typeof bestDelta === 'undefined' || delta > bestDelta) && avgFieldCount > 1.99) {\n        bestDelta = delta;\n        bestDelim = delim;\n      }\n    }\n    _config.delimiter = bestDelim;\n    return {\n      successful: !!bestDelim,\n      bestDelimiter: bestDelim\n    };\n  }\n  function guessLineEndings(input, quoteChar) {\n    input = input.substr(0, 1024 * 1024);\n    var re = new RegExp(escapeRegExp(quoteChar) + '([^]*?)' + escapeRegExp(quoteChar), 'gm');\n    input = input.replace(re, '');\n    var r = input.split('\\r');\n    var n = input.split('\\n');\n    var nAppearsFirst = n.length > 1 && n[0].length < r[0].length;\n    if (r.length === 1 || nAppearsFirst) return '\\n';\n    var numWithN = 0;\n    for (var i = 0; i < r.length; i++) {\n      if (r[i][0] === '\\n') numWithN++;\n    }\n    return numWithN >= r.length / 2 ? '\\r\\n' : '\\r';\n  }\n  function addError(type, code, msg, row) {\n    _results.errors.push({\n      type: type,\n      code: code,\n      message: msg,\n      row: row\n    });\n  }\n}\n\nfunction escapeRegExp(string) {\n  return string.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\nfunction Parser(config) {\n  config = config || {};\n  var delim = config.delimiter;\n  var newline = config.newline;\n  var comments = config.comments;\n  var step = config.step;\n  var preview = config.preview;\n  var fastMode = config.fastMode;\n  var quoteChar;\n  if (config.quoteChar === undefined) {\n    quoteChar = '\"';\n  } else {\n    quoteChar = config.quoteChar;\n  }\n  var escapeChar = quoteChar;\n  if (config.escapeChar !== undefined) {\n    escapeChar = config.escapeChar;\n  }\n\n  if (typeof delim !== 'string' || Papa.BAD_DELIMITERS.indexOf(delim) > -1) delim = ',';\n\n  if (comments === delim) throw new Error('Comment character same as delimiter');else if (comments === true) comments = '#';else if (typeof comments !== 'string' || Papa.BAD_DELIMITERS.indexOf(comments) > -1) comments = false;\n\n  if (newline !== '\\n' && newline !== '\\r' && newline !== '\\r\\n') newline = '\\n';\n\n  var cursor = 0;\n  var aborted = false;\n  this.parse = function (input, baseIndex, ignoreLastRow) {\n    if (typeof input !== 'string') throw new Error('Input must be a string');\n\n    var inputLen = input.length,\n      delimLen = delim.length,\n      newlineLen = newline.length,\n      commentsLen = comments.length;\n    var stepIsFunction = isFunction(step);\n\n    cursor = 0;\n    var data = [],\n      errors = [],\n      row = [],\n      lastCursor = 0;\n    if (!input) return returnable();\n    if (fastMode || fastMode !== false && input.indexOf(quoteChar) === -1) {\n      var rows = input.split(newline);\n      for (var i = 0; i < rows.length; i++) {\n        row = rows[i];\n        cursor += row.length;\n        if (i !== rows.length - 1) cursor += newline.length;else if (ignoreLastRow) return returnable();\n        if (comments && row.substr(0, commentsLen) === comments) continue;\n        if (stepIsFunction) {\n          data = [];\n          pushRow(row.split(delim));\n          doStep();\n          if (aborted) return returnable();\n        } else pushRow(row.split(delim));\n        if (preview && i >= preview) {\n          data = data.slice(0, preview);\n          return returnable(true);\n        }\n      }\n      return returnable();\n    }\n    var nextDelim = input.indexOf(delim, cursor);\n    var nextNewline = input.indexOf(newline, cursor);\n    var quoteCharRegex = new RegExp(escapeRegExp(escapeChar) + escapeRegExp(quoteChar), 'g');\n    var quoteSearch;\n\n    for (;;) {\n      if (input[cursor] === quoteChar) {\n        quoteSearch = cursor;\n\n        cursor++;\n        for (;;) {\n          quoteSearch = input.indexOf(quoteChar, quoteSearch + 1);\n\n          if (quoteSearch === -1) {\n            if (!ignoreLastRow) {\n              errors.push({\n                type: 'Quotes',\n                code: 'MissingQuotes',\n                message: 'Quoted field unterminated',\n                row: data.length,\n                index: cursor\n              });\n            }\n            return finish();\n          }\n\n          if (quoteSearch === inputLen - 1) {\n            var value = input.substring(cursor, quoteSearch).replace(quoteCharRegex, quoteChar);\n            return finish(value);\n          }\n\n          if (quoteChar === escapeChar && input[quoteSearch + 1] === escapeChar) {\n            quoteSearch++;\n            continue;\n          }\n\n          if (quoteChar !== escapeChar && quoteSearch !== 0 && input[quoteSearch - 1] === escapeChar) {\n            continue;\n          }\n\n          var checkUpTo = nextNewline === -1 ? nextDelim : Math.min(nextDelim, nextNewline);\n          var spacesBetweenQuoteAndDelimiter = extraSpaces(checkUpTo);\n\n          if (input[quoteSearch + 1 + spacesBetweenQuoteAndDelimiter] === delim) {\n            row.push(input.substring(cursor, quoteSearch).replace(quoteCharRegex, quoteChar));\n            cursor = quoteSearch + 1 + spacesBetweenQuoteAndDelimiter + delimLen;\n            nextDelim = input.indexOf(delim, cursor);\n            nextNewline = input.indexOf(newline, cursor);\n            if (stepIsFunction) {\n              doStep();\n              if (aborted) return returnable();\n            }\n            if (preview && data.length >= preview) return returnable(true);\n            break;\n          }\n          var spacesBetweenQuoteAndNewLine = extraSpaces(nextNewline);\n\n          if (input.substr(quoteSearch + 1 + spacesBetweenQuoteAndNewLine, newlineLen) === newline) {\n            row.push(input.substring(cursor, quoteSearch).replace(quoteCharRegex, quoteChar));\n            saveRow(quoteSearch + 1 + spacesBetweenQuoteAndNewLine + newlineLen);\n            nextDelim = input.indexOf(delim, cursor);\n\n            if (stepIsFunction) {\n              doStep();\n              if (aborted) return returnable();\n            }\n            if (preview && data.length >= preview) return returnable(true);\n            break;\n          }\n\n          errors.push({\n            type: 'Quotes',\n            code: 'InvalidQuotes',\n            message: 'Trailing quote on quoted field is malformed',\n            row: data.length,\n            index: cursor\n          });\n          quoteSearch++;\n          continue;\n        }\n        if (stepIsFunction) {\n          doStep();\n          if (aborted) return returnable();\n        }\n        if (preview && data.length >= preview) return returnable(true);\n        continue;\n      }\n\n      if (comments && row.length === 0 && input.substr(cursor, commentsLen) === comments) {\n        if (nextNewline === -1)\n          return returnable();\n        cursor = nextNewline + newlineLen;\n        nextNewline = input.indexOf(newline, cursor);\n        nextDelim = input.indexOf(delim, cursor);\n        continue;\n      }\n\n      if (nextDelim !== -1 && (nextDelim < nextNewline || nextNewline === -1)) {\n        row.push(input.substring(cursor, nextDelim));\n        cursor = nextDelim + delimLen;\n        nextDelim = input.indexOf(delim, cursor);\n        continue;\n      }\n\n      if (nextNewline !== -1) {\n        row.push(input.substring(cursor, nextNewline));\n        saveRow(nextNewline + newlineLen);\n        if (stepIsFunction) {\n          doStep();\n          if (aborted) return returnable();\n        }\n        if (preview && data.length >= preview) return returnable(true);\n        continue;\n      }\n      break;\n    }\n    return finish();\n    function pushRow(row) {\n      data.push(row);\n      lastCursor = cursor;\n    }\n\n    function extraSpaces(index) {\n      var spaceLength = 0;\n      if (index !== -1) {\n        var textBetweenClosingQuoteAndIndex = input.substring(quoteSearch + 1, index);\n        if (textBetweenClosingQuoteAndIndex && textBetweenClosingQuoteAndIndex.trim() === '') {\n          spaceLength = textBetweenClosingQuoteAndIndex.length;\n        }\n      }\n      return spaceLength;\n    }\n\n    function finish(value) {\n      if (ignoreLastRow) return returnable();\n      if (typeof value === 'undefined') value = input.substr(cursor);\n      row.push(value);\n      cursor = inputLen;\n      pushRow(row);\n      if (stepIsFunction) doStep();\n      return returnable();\n    }\n\n    function saveRow(newCursor) {\n      cursor = newCursor;\n      pushRow(row);\n      row = [];\n      nextNewline = input.indexOf(newline, cursor);\n    }\n\n    function returnable(stopped, step) {\n      var isStep = step || false;\n      return {\n        data: isStep ? data[0] : data,\n        errors: errors,\n        meta: {\n          delimiter: delim,\n          linebreak: newline,\n          aborted: aborted,\n          truncated: !!stopped,\n          cursor: lastCursor + (baseIndex || 0)\n        }\n      };\n    }\n\n    function doStep() {\n      step(returnable(undefined, true));\n      data = [];\n      errors = [];\n    }\n  };\n\n  this.abort = function () {\n    aborted = true;\n  };\n\n  this.getCharIndex = function () {\n    return cursor;\n  };\n}\nfunction notImplemented() {\n  throw new Error('Not implemented.');\n}\n\nfunction copy(obj) {\n  if (typeof obj !== 'object' || obj === null) return obj;\n  var cpy = Array.isArray(obj) ? [] : {};\n  for (var key in obj) cpy[key] = copy(obj[key]);\n  return cpy;\n}\nfunction isFunction(func) {\n  return typeof func === 'function';\n}\n//# sourceMappingURL=papaparse.js.map","\n\nimport Papa from './papaparse';\nconst {\n  ChunkStreamer\n} = Papa;\nexport default function AsyncIteratorStreamer(config) {\n  config = config || {};\n  ChunkStreamer.call(this, config);\n  this.textDecoder = new TextDecoder(this._config.encoding);\n\n  this.stream = async function (asyncIterator) {\n    this._input = asyncIterator;\n    try {\n      for await (const chunk of asyncIterator) {\n        this.parseChunk(this.getStringChunk(chunk));\n      }\n\n      this._finished = true;\n      this.parseChunk('');\n    } catch (error) {\n      this._sendError(error);\n    }\n  };\n  this._nextChunk = function nextChunk() {\n  };\n\n  this.getStringChunk = function (chunk) {\n    return typeof chunk === 'string' ? chunk : this.textDecoder.decode(chunk, {\n      stream: true\n    });\n  };\n}\nAsyncIteratorStreamer.prototype = Object.create(ChunkStreamer.prototype);\nAsyncIteratorStreamer.prototype.constructor = AsyncIteratorStreamer;\n//# sourceMappingURL=async-iterator-streamer.js.map","import { AsyncQueue, TableBatchBuilder, convertToArrayRow, convertToObjectRow } from '@loaders.gl/schema';\nimport Papa from './papaparse/papaparse';\nimport AsyncIteratorStreamer from './papaparse/async-iterator-streamer';\n\nconst VERSION = typeof \"3.3.3\" !== 'undefined' ? \"3.3.3\" : 'latest';\nconst DEFAULT_CSV_LOADER_OPTIONS = {\n  csv: {\n    shape: 'object-row-table',\n    optimizeMemoryUsage: false,\n    header: 'auto',\n    columnPrefix: 'column',\n    quoteChar: '\"',\n    escapeChar: '\"',\n    dynamicTyping: true,\n    comments: false,\n    skipEmptyLines: true,\n    delimitersToGuess: [',', '\\t', '|', ';']\n  }\n};\n\nexport const CSVLoader = {\n  id: 'csv',\n  module: 'csv',\n  name: 'CSV',\n  version: VERSION,\n  extensions: ['csv', 'tsv', 'dsv'],\n  mimeTypes: ['text/csv', 'text/tab-separated-values', 'text/dsv'],\n  category: 'table',\n  parse: async (arrayBuffer, options) => parseCSV(new TextDecoder().decode(arrayBuffer), options),\n  parseText: (text, options) => parseCSV(text, options),\n  parseInBatches: parseCSVInBatches,\n  options: DEFAULT_CSV_LOADER_OPTIONS\n};\nasync function parseCSV(csvText, options) {\n  const csvOptions = {\n    ...DEFAULT_CSV_LOADER_OPTIONS.csv,\n    ...(options === null || options === void 0 ? void 0 : options.csv)\n  };\n  const firstRow = readFirstRow(csvText);\n  const header = csvOptions.header === 'auto' ? isHeaderRow(firstRow) : Boolean(csvOptions.header);\n  const parseWithHeader = header;\n  const papaparseConfig = {\n    ...csvOptions,\n    header: parseWithHeader,\n    download: false,\n    transformHeader: parseWithHeader ? duplicateColumnTransformer() : undefined,\n    error: e => {\n      throw new Error(e);\n    }\n  };\n  const result = Papa.parse(csvText, papaparseConfig);\n  let {\n    data: rows\n  } = result;\n  const headerRow = result.meta.fields || generateHeader(csvOptions.columnPrefix, firstRow.length);\n  switch (csvOptions.shape) {\n    case 'object-row-table':\n      rows = rows.map(row => Array.isArray(row) ? convertToObjectRow(row, headerRow) : row);\n      break;\n    case 'array-row-table':\n      rows = rows.map(row => Array.isArray(row) ? row : convertToArrayRow(row, headerRow));\n      break;\n    default:\n  }\n\n  return rows;\n}\n\nfunction parseCSVInBatches(asyncIterator, options) {\n  var _options;\n  options = {\n    ...options\n  };\n  if (options.batchSize === 'auto') {\n    options.batchSize = 4000;\n  }\n\n  const csvOptions = {\n    ...DEFAULT_CSV_LOADER_OPTIONS.csv,\n    ...((_options = options) === null || _options === void 0 ? void 0 : _options.csv)\n  };\n  const asyncQueue = new AsyncQueue();\n  let isFirstRow = true;\n  let headerRow = null;\n  let tableBatchBuilder = null;\n  let schema = null;\n  const config = {\n    ...csvOptions,\n    header: false,\n    download: false,\n    chunkSize: 1024 * 1024 * 5,\n    skipEmptyLines: false,\n    step(results) {\n      let row = results.data;\n      if (csvOptions.skipEmptyLines) {\n        const collapsedRow = row.flat().join('').trim();\n        if (collapsedRow === '') {\n          return;\n        }\n      }\n      const bytesUsed = results.meta.cursor;\n\n      if (isFirstRow && !headerRow) {\n        const header = csvOptions.header === 'auto' ? isHeaderRow(row) : Boolean(csvOptions.header);\n        if (header) {\n          headerRow = row.map(duplicateColumnTransformer());\n          return;\n        }\n      }\n\n      if (isFirstRow) {\n        isFirstRow = false;\n        if (!headerRow) {\n          headerRow = generateHeader(csvOptions.columnPrefix, row.length);\n        }\n        schema = deduceSchema(row, headerRow);\n      }\n      if (csvOptions.optimizeMemoryUsage) {\n        row = JSON.parse(JSON.stringify(row));\n      }\n\n      tableBatchBuilder = tableBatchBuilder || new TableBatchBuilder(schema, {\n        shape: csvOptions.shape || 'array-row-table',\n        ...options\n      });\n      try {\n        tableBatchBuilder.addRow(row);\n        const batch = tableBatchBuilder && tableBatchBuilder.getFullBatch({\n          bytesUsed\n        });\n        if (batch) {\n          asyncQueue.enqueue(batch);\n        }\n      } catch (error) {\n        asyncQueue.enqueue(error);\n      }\n    },\n    complete(results) {\n      try {\n        const bytesUsed = results.meta.cursor;\n        const batch = tableBatchBuilder && tableBatchBuilder.getFinalBatch({\n          bytesUsed\n        });\n        if (batch) {\n          asyncQueue.enqueue(batch);\n        }\n      } catch (error) {\n        asyncQueue.enqueue(error);\n      }\n      asyncQueue.close();\n    }\n  };\n  Papa.parse(asyncIterator, config, AsyncIteratorStreamer);\n\n  return asyncQueue;\n}\n\nfunction isHeaderRow(row) {\n  return row && row.every(value => typeof value === 'string');\n}\n\nfunction readFirstRow(csvText) {\n  const result = Papa.parse(csvText, {\n    download: false,\n    dynamicTyping: true,\n    preview: 1\n  });\n  return result.data[0];\n}\n\nfunction duplicateColumnTransformer() {\n  const observedColumns = new Set();\n  return col => {\n    let colName = col;\n    let counter = 1;\n    while (observedColumns.has(colName)) {\n      colName = \"\".concat(col, \".\").concat(counter);\n      counter++;\n    }\n    observedColumns.add(colName);\n    return colName;\n  };\n}\n\nfunction generateHeader(columnPrefix) {\n  let count = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;\n  const headers = [];\n  for (let i = 0; i < count; i++) {\n    headers.push(\"\".concat(columnPrefix).concat(i + 1));\n  }\n  return headers;\n}\nfunction deduceSchema(row, headerRow) {\n  const schema = headerRow ? {} : [];\n  for (let i = 0; i < row.length; i++) {\n    const columnName = headerRow && headerRow[i] || i;\n    const value = row[i];\n    switch (typeof value) {\n      case 'number':\n      case 'boolean':\n        schema[columnName] = {\n          name: String(columnName),\n          index: i,\n          type: Float32Array\n        };\n        break;\n      case 'string':\n      default:\n        schema[columnName] = {\n          name: String(columnName),\n          index: i,\n          type: Array\n        };\n    }\n  }\n\n  return schema;\n}\nexport const _typecheckCSVLoader = CSVLoader;\n//# sourceMappingURL=csv-loader.js.map","\nexport function assert(condition, message) {\n  if (!condition) {\n    throw new Error(message || 'loader assertion failed.');\n  }\n}\n//# sourceMappingURL=assert.js.map","import { assert } from '@loaders.gl/loader-utils';\nexport function isLoaderObject(loader) {\n  var _loader;\n  if (!loader) {\n    return false;\n  }\n  if (Array.isArray(loader)) {\n    loader = loader[0];\n  }\n  const hasExtensions = Array.isArray((_loader = loader) === null || _loader === void 0 ? void 0 : _loader.extensions);\n\n  return hasExtensions;\n}\nexport function normalizeLoader(loader) {\n  var _loader2, _loader3;\n  assert(loader, 'null loader');\n  assert(isLoaderObject(loader), 'invalid loader');\n\n  let options;\n  if (Array.isArray(loader)) {\n    options = loader[1];\n    loader = loader[0];\n    loader = {\n      ...loader,\n      options: {\n        ...loader.options,\n        ...options\n      }\n    };\n  }\n\n  if ((_loader2 = loader) !== null && _loader2 !== void 0 && _loader2.parseTextSync || (_loader3 = loader) !== null && _loader3 !== void 0 && _loader3.parseText) {\n    loader.text = true;\n  }\n  if (!loader.text) {\n    loader.binary = true;\n  }\n  return loader;\n}\n//# sourceMappingURL=normalize-loader.js.map","import checkIfBrowser from '../lib/is-browser';\nexport { self, window, global, document, process, console } from '../lib/globals';\nexport const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'untranspiled source';\nexport const isBrowser = checkIfBrowser();\n//# sourceMappingURL=globals.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\n\nfunction getStorage(type) {\n  try {\n    const storage = window[type];\n    const x = '__storage_test__';\n    storage.setItem(x, x);\n    storage.removeItem(x);\n    return storage;\n  } catch (e) {\n    return null;\n  }\n}\n\nexport class LocalStorage {\n  constructor(id, defaultConfig) {\n    let type = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'sessionStorage';\n\n    _defineProperty(this, \"storage\", void 0);\n\n    _defineProperty(this, \"id\", void 0);\n\n    _defineProperty(this, \"config\", void 0);\n\n    this.storage = getStorage(type);\n    this.id = id;\n    this.config = defaultConfig;\n\n    this._loadConfiguration();\n  }\n\n  getConfiguration() {\n    return this.config;\n  }\n\n  setConfiguration(configuration) {\n    Object.assign(this.config, configuration);\n\n    if (this.storage) {\n      const serialized = JSON.stringify(this.config);\n      this.storage.setItem(this.id, serialized);\n    }\n  }\n\n  _loadConfiguration() {\n    let configuration = {};\n\n    if (this.storage) {\n      const serializedConfiguration = this.storage.getItem(this.id);\n      configuration = serializedConfiguration ? JSON.parse(serializedConfiguration) : {};\n    }\n\n    Object.assign(this.config, configuration);\n    return this;\n  }\n\n}\n//# sourceMappingURL=local-storage.js.map","export function formatTime(ms) {\n  let formatted;\n\n  if (ms < 10) {\n    formatted = \"\".concat(ms.toFixed(2), \"ms\");\n  } else if (ms < 100) {\n    formatted = \"\".concat(ms.toFixed(1), \"ms\");\n  } else if (ms < 1000) {\n    formatted = \"\".concat(ms.toFixed(0), \"ms\");\n  } else {\n    formatted = \"\".concat((ms / 1000).toFixed(2), \"s\");\n  }\n\n  return formatted;\n}\nexport function leftPad(string) {\n  let length = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 8;\n  const padLength = Math.max(length - string.length, 0);\n  return \"\".concat(' '.repeat(padLength)).concat(string);\n}\nexport function rightPad(string) {\n  let length = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 8;\n  const padLength = Math.max(length - string.length, 0);\n  return \"\".concat(string).concat(' '.repeat(padLength));\n}\nexport function formatValue(v) {\n  let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n  const EPSILON = 1e-16;\n  const {\n    isInteger = false\n  } = opts;\n\n  if (Array.isArray(v) || ArrayBuffer.isView(v)) {\n    return formatArrayValue(v, opts);\n  }\n\n  if (!Number.isFinite(v)) {\n    return String(v);\n  }\n\n  if (Math.abs(v) < EPSILON) {\n    return isInteger ? '0' : '0.';\n  }\n\n  if (isInteger) {\n    return v.toFixed(0);\n  }\n\n  if (Math.abs(v) > 100 && Math.abs(v) < 10000) {\n    return v.toFixed(0);\n  }\n\n  const string = v.toPrecision(2);\n  const decimal = string.indexOf('.0');\n  return decimal === string.length - 2 ? string.slice(0, -1) : string;\n}\n\nfunction formatArrayValue(v, opts) {\n  const {\n    maxElts = 16,\n    size = 1\n  } = opts;\n  let string = '[';\n\n  for (let i = 0; i < v.length && i < maxElts; ++i) {\n    if (i > 0) {\n      string += \",\".concat(i % size === 0 ? ' ' : '');\n    }\n\n    string += formatValue(v[i], opts);\n  }\n\n  const terminator = v.length > maxElts ? '...' : ']';\n  return \"\".concat(string).concat(terminator);\n}\n\nexport function formatImage(image, message, scale) {\n  let maxWidth = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 600;\n  const imageUrl = image.src.replace(/\\(/g, '%28').replace(/\\)/g, '%29');\n\n  if (image.width > maxWidth) {\n    scale = Math.min(scale, maxWidth / image.width);\n  }\n\n  const width = image.width * scale;\n  const height = image.height * scale;\n  const style = ['font-size:1px;', \"padding:\".concat(Math.floor(height / 2), \"px \").concat(Math.floor(width / 2), \"px;\"), \"line-height:\".concat(height, \"px;\"), \"background:url(\".concat(imageUrl, \");\"), \"background-size:\".concat(width, \"px \").concat(height, \"px;\"), 'color:transparent;'].join('');\n  return [\"\".concat(message, \" %c+\"), style];\n}\n//# sourceMappingURL=formatters.js.map","import { isBrowser } from '@probe.gl/env';\nexport let COLOR;\n\n(function (COLOR) {\n  COLOR[COLOR[\"BLACK\"] = 30] = \"BLACK\";\n  COLOR[COLOR[\"RED\"] = 31] = \"RED\";\n  COLOR[COLOR[\"GREEN\"] = 32] = \"GREEN\";\n  COLOR[COLOR[\"YELLOW\"] = 33] = \"YELLOW\";\n  COLOR[COLOR[\"BLUE\"] = 34] = \"BLUE\";\n  COLOR[COLOR[\"MAGENTA\"] = 35] = \"MAGENTA\";\n  COLOR[COLOR[\"CYAN\"] = 36] = \"CYAN\";\n  COLOR[COLOR[\"WHITE\"] = 37] = \"WHITE\";\n  COLOR[COLOR[\"BRIGHT_BLACK\"] = 90] = \"BRIGHT_BLACK\";\n  COLOR[COLOR[\"BRIGHT_RED\"] = 91] = \"BRIGHT_RED\";\n  COLOR[COLOR[\"BRIGHT_GREEN\"] = 92] = \"BRIGHT_GREEN\";\n  COLOR[COLOR[\"BRIGHT_YELLOW\"] = 93] = \"BRIGHT_YELLOW\";\n  COLOR[COLOR[\"BRIGHT_BLUE\"] = 94] = \"BRIGHT_BLUE\";\n  COLOR[COLOR[\"BRIGHT_MAGENTA\"] = 95] = \"BRIGHT_MAGENTA\";\n  COLOR[COLOR[\"BRIGHT_CYAN\"] = 96] = \"BRIGHT_CYAN\";\n  COLOR[COLOR[\"BRIGHT_WHITE\"] = 97] = \"BRIGHT_WHITE\";\n})(COLOR || (COLOR = {}));\n\nfunction getColor(color) {\n  return typeof color === 'string' ? COLOR[color.toUpperCase()] || COLOR.WHITE : color;\n}\n\nexport function addColor(string, color, background) {\n  if (!isBrowser && typeof string === 'string') {\n    if (color) {\n      color = getColor(color);\n      string = \"\\x1B[\".concat(color, \"m\").concat(string, \"\\x1B[39m\");\n    }\n\n    if (background) {\n      color = getColor(background);\n      string = \"\\x1B[\".concat(background + 10, \"m\").concat(string, \"\\x1B[49m\");\n    }\n  }\n\n  return string;\n}\n//# sourceMappingURL=color.js.map","export default function assert(condition, message) {\n  if (!condition) {\n    throw new Error(message || 'Assertion failed');\n  }\n}\n//# sourceMappingURL=assert.js.map","import { window, process, isBrowser } from '@probe.gl/env';\nexport function getHiResTimestamp() {\n  let timestamp;\n\n  if (isBrowser && 'performance' in window) {\n    var _window$performance, _window$performance$n;\n\n    timestamp = window === null || window === void 0 ? void 0 : (_window$performance = window.performance) === null || _window$performance === void 0 ? void 0 : (_window$performance$n = _window$performance.now) === null || _window$performance$n === void 0 ? void 0 : _window$performance$n.call(_window$performance);\n  } else if ('hrtime' in process) {\n    var _process$hrtime;\n\n    const timeParts = process === null || process === void 0 ? void 0 : (_process$hrtime = process.hrtime) === null || _process$hrtime === void 0 ? void 0 : _process$hrtime.call(process);\n    timestamp = timeParts[0] * 1000 + timeParts[1] / 1e6;\n  } else {\n    timestamp = Date.now();\n  }\n\n  return timestamp;\n}\n//# sourceMappingURL=hi-res-timestamp.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { VERSION, isBrowser } from '@probe.gl/env';\nimport { LocalStorage } from './utils/local-storage';\nimport { formatImage, formatTime, leftPad } from './utils/formatters';\nimport { addColor } from './utils/color';\nimport { autobind } from './utils/autobind';\nimport assert from './utils/assert';\nimport { getHiResTimestamp } from './utils/hi-res-timestamp';\nconst originalConsole = {\n  debug: isBrowser ? console.debug || console.log : console.log,\n  log: console.log,\n  info: console.info,\n  warn: console.warn,\n  error: console.error\n};\nconst DEFAULT_SETTINGS = {\n  enabled: true,\n  level: 0\n};\n\nfunction noop() {}\n\nconst cache = {};\nconst ONCE = {\n  once: true\n};\nexport class Log {\n  constructor() {\n    let {\n      id\n    } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {\n      id: ''\n    };\n\n    _defineProperty(this, \"id\", void 0);\n\n    _defineProperty(this, \"VERSION\", VERSION);\n\n    _defineProperty(this, \"_startTs\", getHiResTimestamp());\n\n    _defineProperty(this, \"_deltaTs\", getHiResTimestamp());\n\n    _defineProperty(this, \"_storage\", void 0);\n\n    _defineProperty(this, \"userData\", {});\n\n    _defineProperty(this, \"LOG_THROTTLE_TIMEOUT\", 0);\n\n    this.id = id;\n    this.userData = {};\n    this._storage = new LocalStorage(\"__probe-\".concat(this.id, \"__\"), DEFAULT_SETTINGS);\n    this.timeStamp(\"\".concat(this.id, \" started\"));\n    autobind(this);\n    Object.seal(this);\n  }\n\n  set level(newLevel) {\n    this.setLevel(newLevel);\n  }\n\n  get level() {\n    return this.getLevel();\n  }\n\n  isEnabled() {\n    return this._storage.config.enabled;\n  }\n\n  getLevel() {\n    return this._storage.config.level;\n  }\n\n  getTotal() {\n    return Number((getHiResTimestamp() - this._startTs).toPrecision(10));\n  }\n\n  getDelta() {\n    return Number((getHiResTimestamp() - this._deltaTs).toPrecision(10));\n  }\n\n  set priority(newPriority) {\n    this.level = newPriority;\n  }\n\n  get priority() {\n    return this.level;\n  }\n\n  getPriority() {\n    return this.level;\n  }\n\n  enable() {\n    let enabled = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;\n\n    this._storage.setConfiguration({\n      enabled\n    });\n\n    return this;\n  }\n\n  setLevel(level) {\n    this._storage.setConfiguration({\n      level\n    });\n\n    return this;\n  }\n\n  get(setting) {\n    return this._storage.config[setting];\n  }\n\n  set(setting, value) {\n    this._storage.setConfiguration({\n      [setting]: value\n    });\n  }\n\n  settings() {\n    if (console.table) {\n      console.table(this._storage.config);\n    } else {\n      console.log(this._storage.config);\n    }\n  }\n\n  assert(condition, message) {\n    assert(condition, message);\n  }\n\n  warn(message) {\n    return this._getLogFunction(0, message, originalConsole.warn, arguments, ONCE);\n  }\n\n  error(message) {\n    return this._getLogFunction(0, message, originalConsole.error, arguments);\n  }\n\n  deprecated(oldUsage, newUsage) {\n    return this.warn(\"`\".concat(oldUsage, \"` is deprecated and will be removed in a later version. Use `\").concat(newUsage, \"` instead\"));\n  }\n\n  removed(oldUsage, newUsage) {\n    return this.error(\"`\".concat(oldUsage, \"` has been removed. Use `\").concat(newUsage, \"` instead\"));\n  }\n\n  probe(logLevel, message) {\n    return this._getLogFunction(logLevel, message, originalConsole.log, arguments, {\n      time: true,\n      once: true\n    });\n  }\n\n  log(logLevel, message) {\n    return this._getLogFunction(logLevel, message, originalConsole.debug, arguments);\n  }\n\n  info(logLevel, message) {\n    return this._getLogFunction(logLevel, message, console.info, arguments);\n  }\n\n  once(logLevel, message) {\n    for (var _len = arguments.length, args = new Array(_len > 2 ? _len - 2 : 0), _key = 2; _key < _len; _key++) {\n      args[_key - 2] = arguments[_key];\n    }\n\n    return this._getLogFunction(logLevel, message, originalConsole.debug || originalConsole.info, arguments, ONCE);\n  }\n\n  table(logLevel, table, columns) {\n    if (table) {\n      return this._getLogFunction(logLevel, table, console.table || noop, columns && [columns], {\n        tag: getTableHeader(table)\n      });\n    }\n\n    return noop;\n  }\n\n  image(_ref) {\n    let {\n      logLevel,\n      priority,\n      image,\n      message = '',\n      scale = 1\n    } = _ref;\n\n    if (!this._shouldLog(logLevel || priority)) {\n      return noop;\n    }\n\n    return isBrowser ? logImageInBrowser({\n      image,\n      message,\n      scale\n    }) : logImageInNode({\n      image,\n      message,\n      scale\n    });\n  }\n\n  time(logLevel, message) {\n    return this._getLogFunction(logLevel, message, console.time ? console.time : console.info);\n  }\n\n  timeEnd(logLevel, message) {\n    return this._getLogFunction(logLevel, message, console.timeEnd ? console.timeEnd : console.info);\n  }\n\n  timeStamp(logLevel, message) {\n    return this._getLogFunction(logLevel, message, console.timeStamp || noop);\n  }\n\n  group(logLevel, message) {\n    let opts = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {\n      collapsed: false\n    };\n    const options = normalizeArguments({\n      logLevel,\n      message,\n      opts\n    });\n    const {\n      collapsed\n    } = opts;\n    options.method = (collapsed ? console.groupCollapsed : console.group) || console.info;\n    return this._getLogFunction(options);\n  }\n\n  groupCollapsed(logLevel, message) {\n    let opts = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};\n    return this.group(logLevel, message, Object.assign({}, opts, {\n      collapsed: true\n    }));\n  }\n\n  groupEnd(logLevel) {\n    return this._getLogFunction(logLevel, '', console.groupEnd || noop);\n  }\n\n  withGroup(logLevel, message, func) {\n    this.group(logLevel, message)();\n\n    try {\n      func();\n    } finally {\n      this.groupEnd(logLevel)();\n    }\n  }\n\n  trace() {\n    if (console.trace) {\n      console.trace();\n    }\n  }\n\n  _shouldLog(logLevel) {\n    return this.isEnabled() && this.getLevel() >= normalizeLogLevel(logLevel);\n  }\n\n  _getLogFunction(logLevel, message, method, args, opts) {\n    if (this._shouldLog(logLevel)) {\n      opts = normalizeArguments({\n        logLevel,\n        message,\n        args,\n        opts\n      });\n      method = method || opts.method;\n      assert(method);\n      opts.total = this.getTotal();\n      opts.delta = this.getDelta();\n      this._deltaTs = getHiResTimestamp();\n      const tag = opts.tag || opts.message;\n\n      if (opts.once) {\n        if (!cache[tag]) {\n          cache[tag] = getHiResTimestamp();\n        } else {\n          return noop;\n        }\n      }\n\n      message = decorateMessage(this.id, opts.message, opts);\n      return method.bind(console, message, ...opts.args);\n    }\n\n    return noop;\n  }\n\n}\n\n_defineProperty(Log, \"VERSION\", VERSION);\n\nfunction normalizeLogLevel(logLevel) {\n  if (!logLevel) {\n    return 0;\n  }\n\n  let resolvedLevel;\n\n  switch (typeof logLevel) {\n    case 'number':\n      resolvedLevel = logLevel;\n      break;\n\n    case 'object':\n      resolvedLevel = logLevel.logLevel || logLevel.priority || 0;\n      break;\n\n    default:\n      return 0;\n  }\n\n  assert(Number.isFinite(resolvedLevel) && resolvedLevel >= 0);\n  return resolvedLevel;\n}\n\nexport function normalizeArguments(opts) {\n  const {\n    logLevel,\n    message\n  } = opts;\n  opts.logLevel = normalizeLogLevel(logLevel);\n  const args = opts.args ? Array.from(opts.args) : [];\n\n  while (args.length && args.shift() !== message) {}\n\n  switch (typeof logLevel) {\n    case 'string':\n    case 'function':\n      if (message !== undefined) {\n        args.unshift(message);\n      }\n\n      opts.message = logLevel;\n      break;\n\n    case 'object':\n      Object.assign(opts, logLevel);\n      break;\n\n    default:\n  }\n\n  if (typeof opts.message === 'function') {\n    opts.message = opts.message();\n  }\n\n  const messageType = typeof opts.message;\n  assert(messageType === 'string' || messageType === 'object');\n  return Object.assign(opts, {\n    args\n  }, opts.opts);\n}\n\nfunction decorateMessage(id, message, opts) {\n  if (typeof message === 'string') {\n    const time = opts.time ? leftPad(formatTime(opts.total)) : '';\n    message = opts.time ? \"\".concat(id, \": \").concat(time, \"  \").concat(message) : \"\".concat(id, \": \").concat(message);\n    message = addColor(message, opts.color, opts.background);\n  }\n\n  return message;\n}\n\nfunction logImageInNode(_ref2) {\n  let {\n    image,\n    message = '',\n    scale = 1\n  } = _ref2;\n  console.warn('removed');\n  return noop;\n}\n\nfunction logImageInBrowser(_ref3) {\n  let {\n    image,\n    message = '',\n    scale = 1\n  } = _ref3;\n\n  if (typeof image === 'string') {\n    const img = new Image();\n\n    img.onload = () => {\n      const args = formatImage(img, message, scale);\n      console.log(...args);\n    };\n\n    img.src = image;\n    return noop;\n  }\n\n  const element = image.nodeName || '';\n\n  if (element.toLowerCase() === 'img') {\n    console.log(...formatImage(image, message, scale));\n    return noop;\n  }\n\n  if (element.toLowerCase() === 'canvas') {\n    const img = new Image();\n\n    img.onload = () => console.log(...formatImage(img, message, scale));\n\n    img.src = image.toDataURL();\n    return noop;\n  }\n\n  return noop;\n}\n\nfunction getTableHeader(table) {\n  for (const key in table) {\n    for (const title in table[key]) {\n      return title || 'untitled';\n    }\n  }\n\n  return 'empty';\n}\n//# sourceMappingURL=log.js.map","export function autobind(obj) {\n  let predefined = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ['constructor'];\n  const proto = Object.getPrototypeOf(obj);\n  const propNames = Object.getOwnPropertyNames(proto);\n\n  for (const key of propNames) {\n    if (typeof obj[key] === 'function') {\n      if (!predefined.find(name => key === name)) {\n        obj[key] = obj[key].bind(obj);\n      }\n    }\n  }\n}\n//# sourceMappingURL=autobind.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { Log } from '@probe.gl/log';\nexport const probeLog = new Log({\n  id: 'loaders.gl'\n});\n\nexport class NullLog {\n  log() {\n    return () => {};\n  }\n  info() {\n    return () => {};\n  }\n  warn() {\n    return () => {};\n  }\n  error() {\n    return () => {};\n  }\n}\n\nexport class ConsoleLog {\n  constructor() {\n    _defineProperty(this, \"console\", void 0);\n    this.console = console;\n  }\n\n  log() {\n    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {\n      args[_key] = arguments[_key];\n    }\n    return this.console.log.bind(this.console, ...args);\n  }\n  info() {\n    for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {\n      args[_key2] = arguments[_key2];\n    }\n    return this.console.info.bind(this.console, ...args);\n  }\n  warn() {\n    for (var _len3 = arguments.length, args = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {\n      args[_key3] = arguments[_key3];\n    }\n    return this.console.warn.bind(this.console, ...args);\n  }\n  error() {\n    for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {\n      args[_key4] = arguments[_key4];\n    }\n    return this.console.error.bind(this.console, ...args);\n  }\n}\n//# sourceMappingURL=loggers.js.map","import { isBrowser } from '@loaders.gl/loader-utils';\nimport { ConsoleLog } from './loggers';\nexport const DEFAULT_LOADER_OPTIONS = {\n  fetch: null,\n  mimeType: undefined,\n  nothrow: false,\n  log: new ConsoleLog(),\n\n  CDN: 'https://unpkg.com/@loaders.gl',\n  worker: true,\n  maxConcurrency: 3,\n  maxMobileConcurrency: 1,\n  reuseWorkers: isBrowser,\n  _nodeWorkers: false,\n  _workerType: '',\n\n  limit: 0,\n  _limitMB: 0,\n  batchSize: 'auto',\n  batchDebounceMs: 0,\n  metadata: false,\n  transforms: []\n};\nexport const REMOVED_LOADER_OPTIONS = {\n  throws: 'nothrow',\n  dataType: '(no longer used)',\n  uri: 'baseUri',\n  method: 'fetch.method',\n  headers: 'fetch.headers',\n  body: 'fetch.body',\n  mode: 'fetch.mode',\n  credentials: 'fetch.credentials',\n  cache: 'fetch.cache',\n  redirect: 'fetch.redirect',\n  referrer: 'fetch.referrer',\n  referrerPolicy: 'fetch.referrerPolicy',\n  integrity: 'fetch.integrity',\n  keepalive: 'fetch.keepalive',\n  signal: 'fetch.signal'\n};\n//# sourceMappingURL=option-defaults.js.map","import { isPureObject, isObject } from '../../javascript-utils/is-type';\nimport { fetchFile } from '../fetch/fetch-file';\nimport { probeLog, NullLog } from './loggers';\nimport { DEFAULT_LOADER_OPTIONS, REMOVED_LOADER_OPTIONS } from './option-defaults';\n\nexport function getGlobalLoaderState() {\n  globalThis.loaders = globalThis.loaders || {};\n  const {\n    loaders\n  } = globalThis;\n\n  loaders._state = loaders._state || {};\n  return loaders._state;\n}\n\nexport const getGlobalLoaderOptions = () => {\n  const state = getGlobalLoaderState();\n  state.globalOptions = state.globalOptions || {\n    ...DEFAULT_LOADER_OPTIONS\n  };\n  return state.globalOptions;\n};\n\nexport function setGlobalOptions(options) {\n  const state = getGlobalLoaderState();\n  const globalOptions = getGlobalLoaderOptions();\n  state.globalOptions = normalizeOptionsInternal(globalOptions, options);\n}\n\nexport function normalizeOptions(options, loader, loaders, url) {\n  loaders = loaders || [];\n  loaders = Array.isArray(loaders) ? loaders : [loaders];\n  validateOptions(options, loaders);\n  return normalizeOptionsInternal(loader, options, url);\n}\n\nexport function getFetchFunction(options, context) {\n  const globalOptions = getGlobalLoaderOptions();\n  const fetchOptions = options || globalOptions;\n\n  if (typeof fetchOptions.fetch === 'function') {\n    return fetchOptions.fetch;\n  }\n\n  if (isObject(fetchOptions.fetch)) {\n    return url => fetchFile(url, fetchOptions);\n  }\n\n  if (context !== null && context !== void 0 && context.fetch) {\n    return context === null || context === void 0 ? void 0 : context.fetch;\n  }\n\n  return fetchFile;\n}\n\nfunction validateOptions(options, loaders) {\n  validateOptionsObject(options, null, DEFAULT_LOADER_OPTIONS, REMOVED_LOADER_OPTIONS, loaders);\n  for (const loader of loaders) {\n    const idOptions = options && options[loader.id] || {};\n\n    const loaderOptions = loader.options && loader.options[loader.id] || {};\n    const deprecatedOptions = loader.deprecatedOptions && loader.deprecatedOptions[loader.id] || {};\n\n    validateOptionsObject(idOptions, loader.id, loaderOptions, deprecatedOptions, loaders);\n  }\n}\n\nfunction validateOptionsObject(options, id, defaultOptions, deprecatedOptions, loaders) {\n  const loaderName = id || 'Top level';\n  const prefix = id ? \"\".concat(id, \".\") : '';\n  for (const key in options) {\n    const isSubOptions = !id && isObject(options[key]);\n    const isBaseUriOption = key === 'baseUri' && !id;\n    const isWorkerUrlOption = key === 'workerUrl' && id;\n    if (!(key in defaultOptions) && !isBaseUriOption && !isWorkerUrlOption) {\n      if (key in deprecatedOptions) {\n        probeLog.warn(\"\".concat(loaderName, \" loader option '\").concat(prefix).concat(key, \"' no longer supported, use '\").concat(deprecatedOptions[key], \"'\"))();\n      } else if (!isSubOptions) {\n        const suggestion = findSimilarOption(key, loaders);\n        probeLog.warn(\"\".concat(loaderName, \" loader option '\").concat(prefix).concat(key, \"' not recognized. \").concat(suggestion))();\n      }\n    }\n  }\n}\nfunction findSimilarOption(optionKey, loaders) {\n  const lowerCaseOptionKey = optionKey.toLowerCase();\n  let bestSuggestion = '';\n  for (const loader of loaders) {\n    for (const key in loader.options) {\n      if (optionKey === key) {\n        return \"Did you mean '\".concat(loader.id, \".\").concat(key, \"'?\");\n      }\n      const lowerCaseKey = key.toLowerCase();\n      const isPartialMatch = lowerCaseOptionKey.startsWith(lowerCaseKey) || lowerCaseKey.startsWith(lowerCaseOptionKey);\n      if (isPartialMatch) {\n        bestSuggestion = bestSuggestion || \"Did you mean '\".concat(loader.id, \".\").concat(key, \"'?\");\n      }\n    }\n  }\n  return bestSuggestion;\n}\nfunction normalizeOptionsInternal(loader, options, url) {\n  const loaderDefaultOptions = loader.options || {};\n  const mergedOptions = {\n    ...loaderDefaultOptions\n  };\n  addUrlOptions(mergedOptions, url);\n\n  if (mergedOptions.log === null) {\n    mergedOptions.log = new NullLog();\n  }\n  mergeNestedFields(mergedOptions, getGlobalLoaderOptions());\n  mergeNestedFields(mergedOptions, options);\n  return mergedOptions;\n}\n\nfunction mergeNestedFields(mergedOptions, options) {\n  for (const key in options) {\n    if (key in options) {\n      const value = options[key];\n      if (isPureObject(value) && isPureObject(mergedOptions[key])) {\n        mergedOptions[key] = {\n          ...mergedOptions[key],\n          ...options[key]\n        };\n      } else {\n        mergedOptions[key] = options[key];\n      }\n    }\n  }\n}\n\nfunction addUrlOptions(options, url) {\n  if (url && !('baseUri' in options)) {\n    options.baseUri = url;\n  }\n}\n//# sourceMappingURL=option-utils.js.map","import { normalizeLoader } from '../loader-utils/normalize-loader';\nimport { getGlobalLoaderState } from '../loader-utils/option-utils';\n\nconst getGlobalLoaderRegistry = () => {\n  const state = getGlobalLoaderState();\n  state.loaderRegistry = state.loaderRegistry || [];\n  return state.loaderRegistry;\n};\n\nexport function registerLoaders(loaders) {\n  const loaderRegistry = getGlobalLoaderRegistry();\n  loaders = Array.isArray(loaders) ? loaders : [loaders];\n  for (const loader of loaders) {\n    const normalizedLoader = normalizeLoader(loader);\n    if (!loaderRegistry.find(registeredLoader => normalizedLoader === registeredLoader)) {\n      loaderRegistry.unshift(normalizedLoader);\n    }\n  }\n}\nexport function getRegisteredLoaders() {\n  return getGlobalLoaderRegistry();\n}\n\nexport function _unregisterLoaders() {\n  const state = getGlobalLoaderState();\n  state.loaderRegistry = [];\n}\n//# sourceMappingURL=register-loaders.js.map","export default {\n  DEPTH_BUFFER_BIT: 0x00000100,\n  STENCIL_BUFFER_BIT: 0x00000400,\n  COLOR_BUFFER_BIT: 0x00004000,\n  POINTS: 0x0000,\n  LINES: 0x0001,\n  LINE_LOOP: 0x0002,\n  LINE_STRIP: 0x0003,\n  TRIANGLES: 0x0004,\n  TRIANGLE_STRIP: 0x0005,\n  TRIANGLE_FAN: 0x0006,\n  ZERO: 0,\n  ONE: 1,\n  SRC_COLOR: 0x0300,\n  ONE_MINUS_SRC_COLOR: 0x0301,\n  SRC_ALPHA: 0x0302,\n  ONE_MINUS_SRC_ALPHA: 0x0303,\n  DST_ALPHA: 0x0304,\n  ONE_MINUS_DST_ALPHA: 0x0305,\n  DST_COLOR: 0x0306,\n  ONE_MINUS_DST_COLOR: 0x0307,\n  SRC_ALPHA_SATURATE: 0x0308,\n  CONSTANT_COLOR: 0x8001,\n  ONE_MINUS_CONSTANT_COLOR: 0x8002,\n  CONSTANT_ALPHA: 0x8003,\n  ONE_MINUS_CONSTANT_ALPHA: 0x8004,\n  FUNC_ADD: 0x8006,\n  FUNC_SUBTRACT: 0x800a,\n  FUNC_REVERSE_SUBTRACT: 0x800b,\n  BLEND_EQUATION: 0x8009,\n  BLEND_EQUATION_RGB: 0x8009,\n  BLEND_EQUATION_ALPHA: 0x883d,\n  BLEND_DST_RGB: 0x80c8,\n  BLEND_SRC_RGB: 0x80c9,\n  BLEND_DST_ALPHA: 0x80ca,\n  BLEND_SRC_ALPHA: 0x80cb,\n  BLEND_COLOR: 0x8005,\n  ARRAY_BUFFER_BINDING: 0x8894,\n  ELEMENT_ARRAY_BUFFER_BINDING: 0x8895,\n  LINE_WIDTH: 0x0b21,\n  ALIASED_POINT_SIZE_RANGE: 0x846d,\n  ALIASED_LINE_WIDTH_RANGE: 0x846e,\n  CULL_FACE_MODE: 0x0b45,\n  FRONT_FACE: 0x0b46,\n  DEPTH_RANGE: 0x0b70,\n  DEPTH_WRITEMASK: 0x0b72,\n  DEPTH_CLEAR_VALUE: 0x0b73,\n  DEPTH_FUNC: 0x0b74,\n  STENCIL_CLEAR_VALUE: 0x0b91,\n  STENCIL_FUNC: 0x0b92,\n  STENCIL_FAIL: 0x0b94,\n  STENCIL_PASS_DEPTH_FAIL: 0x0b95,\n  STENCIL_PASS_DEPTH_PASS: 0x0b96,\n  STENCIL_REF: 0x0b97,\n  STENCIL_VALUE_MASK: 0x0b93,\n  STENCIL_WRITEMASK: 0x0b98,\n  STENCIL_BACK_FUNC: 0x8800,\n  STENCIL_BACK_FAIL: 0x8801,\n  STENCIL_BACK_PASS_DEPTH_FAIL: 0x8802,\n  STENCIL_BACK_PASS_DEPTH_PASS: 0x8803,\n  STENCIL_BACK_REF: 0x8ca3,\n  STENCIL_BACK_VALUE_MASK: 0x8ca4,\n  STENCIL_BACK_WRITEMASK: 0x8ca5,\n  VIEWPORT: 0x0ba2,\n  SCISSOR_BOX: 0x0c10,\n  COLOR_CLEAR_VALUE: 0x0c22,\n  COLOR_WRITEMASK: 0x0c23,\n  UNPACK_ALIGNMENT: 0x0cf5,\n  PACK_ALIGNMENT: 0x0d05,\n  MAX_TEXTURE_SIZE: 0x0d33,\n  MAX_VIEWPORT_DIMS: 0x0d3a,\n  SUBPIXEL_BITS: 0x0d50,\n  RED_BITS: 0x0d52,\n  GREEN_BITS: 0x0d53,\n  BLUE_BITS: 0x0d54,\n  ALPHA_BITS: 0x0d55,\n  DEPTH_BITS: 0x0d56,\n  STENCIL_BITS: 0x0d57,\n  POLYGON_OFFSET_UNITS: 0x2a00,\n  POLYGON_OFFSET_FACTOR: 0x8038,\n  TEXTURE_BINDING_2D: 0x8069,\n  SAMPLE_BUFFERS: 0x80a8,\n  SAMPLES: 0x80a9,\n  SAMPLE_COVERAGE_VALUE: 0x80aa,\n  SAMPLE_COVERAGE_INVERT: 0x80ab,\n  COMPRESSED_TEXTURE_FORMATS: 0x86a3,\n  VENDOR: 0x1f00,\n  RENDERER: 0x1f01,\n  VERSION: 0x1f02,\n  IMPLEMENTATION_COLOR_READ_TYPE: 0x8b9a,\n  IMPLEMENTATION_COLOR_READ_FORMAT: 0x8b9b,\n  BROWSER_DEFAULT_WEBGL: 0x9244,\n  STATIC_DRAW: 0x88e4,\n  STREAM_DRAW: 0x88e0,\n  DYNAMIC_DRAW: 0x88e8,\n  ARRAY_BUFFER: 0x8892,\n  ELEMENT_ARRAY_BUFFER: 0x8893,\n  BUFFER_SIZE: 0x8764,\n  BUFFER_USAGE: 0x8765,\n  CURRENT_VERTEX_ATTRIB: 0x8626,\n  VERTEX_ATTRIB_ARRAY_ENABLED: 0x8622,\n  VERTEX_ATTRIB_ARRAY_SIZE: 0x8623,\n  VERTEX_ATTRIB_ARRAY_STRIDE: 0x8624,\n  VERTEX_ATTRIB_ARRAY_TYPE: 0x8625,\n  VERTEX_ATTRIB_ARRAY_NORMALIZED: 0x886a,\n  VERTEX_ATTRIB_ARRAY_POINTER: 0x8645,\n  VERTEX_ATTRIB_ARRAY_BUFFER_BINDING: 0x889f,\n  CULL_FACE: 0x0b44,\n  FRONT: 0x0404,\n  BACK: 0x0405,\n  FRONT_AND_BACK: 0x0408,\n  BLEND: 0x0be2,\n  DEPTH_TEST: 0x0b71,\n  DITHER: 0x0bd0,\n  POLYGON_OFFSET_FILL: 0x8037,\n  SAMPLE_ALPHA_TO_COVERAGE: 0x809e,\n  SAMPLE_COVERAGE: 0x80a0,\n  SCISSOR_TEST: 0x0c11,\n  STENCIL_TEST: 0x0b90,\n  NO_ERROR: 0,\n  INVALID_ENUM: 0x0500,\n  INVALID_VALUE: 0x0501,\n  INVALID_OPERATION: 0x0502,\n  OUT_OF_MEMORY: 0x0505,\n  CONTEXT_LOST_WEBGL: 0x9242,\n  CW: 0x0900,\n  CCW: 0x0901,\n  DONT_CARE: 0x1100,\n  FASTEST: 0x1101,\n  NICEST: 0x1102,\n  GENERATE_MIPMAP_HINT: 0x8192,\n  BYTE: 0x1400,\n  UNSIGNED_BYTE: 0x1401,\n  SHORT: 0x1402,\n  UNSIGNED_SHORT: 0x1403,\n  INT: 0x1404,\n  UNSIGNED_INT: 0x1405,\n  FLOAT: 0x1406,\n  DOUBLE: 0x140a,\n  DEPTH_COMPONENT: 0x1902,\n  ALPHA: 0x1906,\n  RGB: 0x1907,\n  RGBA: 0x1908,\n  LUMINANCE: 0x1909,\n  LUMINANCE_ALPHA: 0x190a,\n  UNSIGNED_SHORT_4_4_4_4: 0x8033,\n  UNSIGNED_SHORT_5_5_5_1: 0x8034,\n  UNSIGNED_SHORT_5_6_5: 0x8363,\n  FRAGMENT_SHADER: 0x8b30,\n  VERTEX_SHADER: 0x8b31,\n  COMPILE_STATUS: 0x8b81,\n  DELETE_STATUS: 0x8b80,\n  LINK_STATUS: 0x8b82,\n  VALIDATE_STATUS: 0x8b83,\n  ATTACHED_SHADERS: 0x8b85,\n  ACTIVE_ATTRIBUTES: 0x8b89,\n  ACTIVE_UNIFORMS: 0x8b86,\n  MAX_VERTEX_ATTRIBS: 0x8869,\n  MAX_VERTEX_UNIFORM_VECTORS: 0x8dfb,\n  MAX_VARYING_VECTORS: 0x8dfc,\n  MAX_COMBINED_TEXTURE_IMAGE_UNITS: 0x8b4d,\n  MAX_VERTEX_TEXTURE_IMAGE_UNITS: 0x8b4c,\n  MAX_TEXTURE_IMAGE_UNITS: 0x8872,\n  MAX_FRAGMENT_UNIFORM_VECTORS: 0x8dfd,\n  SHADER_TYPE: 0x8b4f,\n  SHADING_LANGUAGE_VERSION: 0x8b8c,\n  CURRENT_PROGRAM: 0x8b8d,\n  NEVER: 0x0200,\n  ALWAYS: 0x0207,\n  LESS: 0x0201,\n  EQUAL: 0x0202,\n  LEQUAL: 0x0203,\n  GREATER: 0x0204,\n  GEQUAL: 0x0206,\n  NOTEQUAL: 0x0205,\n  KEEP: 0x1e00,\n  REPLACE: 0x1e01,\n  INCR: 0x1e02,\n  DECR: 0x1e03,\n  INVERT: 0x150a,\n  INCR_WRAP: 0x8507,\n  DECR_WRAP: 0x8508,\n  NEAREST: 0x2600,\n  LINEAR: 0x2601,\n  NEAREST_MIPMAP_NEAREST: 0x2700,\n  LINEAR_MIPMAP_NEAREST: 0x2701,\n  NEAREST_MIPMAP_LINEAR: 0x2702,\n  LINEAR_MIPMAP_LINEAR: 0x2703,\n  TEXTURE_MAG_FILTER: 0x2800,\n  TEXTURE_MIN_FILTER: 0x2801,\n  TEXTURE_WRAP_S: 0x2802,\n  TEXTURE_WRAP_T: 0x2803,\n  TEXTURE_2D: 0x0de1,\n  TEXTURE: 0x1702,\n  TEXTURE_CUBE_MAP: 0x8513,\n  TEXTURE_BINDING_CUBE_MAP: 0x8514,\n  TEXTURE_CUBE_MAP_POSITIVE_X: 0x8515,\n  TEXTURE_CUBE_MAP_NEGATIVE_X: 0x8516,\n  TEXTURE_CUBE_MAP_POSITIVE_Y: 0x8517,\n  TEXTURE_CUBE_MAP_NEGATIVE_Y: 0x8518,\n  TEXTURE_CUBE_MAP_POSITIVE_Z: 0x8519,\n  TEXTURE_CUBE_MAP_NEGATIVE_Z: 0x851a,\n  MAX_CUBE_MAP_TEXTURE_SIZE: 0x851c,\n  TEXTURE0: 0x84c0,\n  ACTIVE_TEXTURE: 0x84e0,\n  REPEAT: 0x2901,\n  CLAMP_TO_EDGE: 0x812f,\n  MIRRORED_REPEAT: 0x8370,\n  TEXTURE_WIDTH: 0x1000,\n  TEXTURE_HEIGHT: 0x1001,\n  FLOAT_VEC2: 0x8b50,\n  FLOAT_VEC3: 0x8b51,\n  FLOAT_VEC4: 0x8b52,\n  INT_VEC2: 0x8b53,\n  INT_VEC3: 0x8b54,\n  INT_VEC4: 0x8b55,\n  BOOL: 0x8b56,\n  BOOL_VEC2: 0x8b57,\n  BOOL_VEC3: 0x8b58,\n  BOOL_VEC4: 0x8b59,\n  FLOAT_MAT2: 0x8b5a,\n  FLOAT_MAT3: 0x8b5b,\n  FLOAT_MAT4: 0x8b5c,\n  SAMPLER_2D: 0x8b5e,\n  SAMPLER_CUBE: 0x8b60,\n  LOW_FLOAT: 0x8df0,\n  MEDIUM_FLOAT: 0x8df1,\n  HIGH_FLOAT: 0x8df2,\n  LOW_INT: 0x8df3,\n  MEDIUM_INT: 0x8df4,\n  HIGH_INT: 0x8df5,\n  FRAMEBUFFER: 0x8d40,\n  RENDERBUFFER: 0x8d41,\n  RGBA4: 0x8056,\n  RGB5_A1: 0x8057,\n  RGB565: 0x8d62,\n  DEPTH_COMPONENT16: 0x81a5,\n  STENCIL_INDEX: 0x1901,\n  STENCIL_INDEX8: 0x8d48,\n  DEPTH_STENCIL: 0x84f9,\n  RENDERBUFFER_WIDTH: 0x8d42,\n  RENDERBUFFER_HEIGHT: 0x8d43,\n  RENDERBUFFER_INTERNAL_FORMAT: 0x8d44,\n  RENDERBUFFER_RED_SIZE: 0x8d50,\n  RENDERBUFFER_GREEN_SIZE: 0x8d51,\n  RENDERBUFFER_BLUE_SIZE: 0x8d52,\n  RENDERBUFFER_ALPHA_SIZE: 0x8d53,\n  RENDERBUFFER_DEPTH_SIZE: 0x8d54,\n  RENDERBUFFER_STENCIL_SIZE: 0x8d55,\n  FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE: 0x8cd0,\n  FRAMEBUFFER_ATTACHMENT_OBJECT_NAME: 0x8cd1,\n  FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL: 0x8cd2,\n  FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE: 0x8cd3,\n  COLOR_ATTACHMENT0: 0x8ce0,\n  DEPTH_ATTACHMENT: 0x8d00,\n  STENCIL_ATTACHMENT: 0x8d20,\n  DEPTH_STENCIL_ATTACHMENT: 0x821a,\n  NONE: 0,\n  FRAMEBUFFER_COMPLETE: 0x8cd5,\n  FRAMEBUFFER_INCOMPLETE_ATTACHMENT: 0x8cd6,\n  FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT: 0x8cd7,\n  FRAMEBUFFER_INCOMPLETE_DIMENSIONS: 0x8cd9,\n  FRAMEBUFFER_UNSUPPORTED: 0x8cdd,\n  FRAMEBUFFER_BINDING: 0x8ca6,\n  RENDERBUFFER_BINDING: 0x8ca7,\n  READ_FRAMEBUFFER: 0x8ca8,\n  DRAW_FRAMEBUFFER: 0x8ca9,\n  MAX_RENDERBUFFER_SIZE: 0x84e8,\n  INVALID_FRAMEBUFFER_OPERATION: 0x0506,\n  UNPACK_FLIP_Y_WEBGL: 0x9240,\n  UNPACK_PREMULTIPLY_ALPHA_WEBGL: 0x9241,\n  UNPACK_COLORSPACE_CONVERSION_WEBGL: 0x9243,\n  READ_BUFFER: 0x0c02,\n  UNPACK_ROW_LENGTH: 0x0cf2,\n  UNPACK_SKIP_ROWS: 0x0cf3,\n  UNPACK_SKIP_PIXELS: 0x0cf4,\n  PACK_ROW_LENGTH: 0x0d02,\n  PACK_SKIP_ROWS: 0x0d03,\n  PACK_SKIP_PIXELS: 0x0d04,\n  TEXTURE_BINDING_3D: 0x806a,\n  UNPACK_SKIP_IMAGES: 0x806d,\n  UNPACK_IMAGE_HEIGHT: 0x806e,\n  MAX_3D_TEXTURE_SIZE: 0x8073,\n  MAX_ELEMENTS_VERTICES: 0x80e8,\n  MAX_ELEMENTS_INDICES: 0x80e9,\n  MAX_TEXTURE_LOD_BIAS: 0x84fd,\n  MAX_FRAGMENT_UNIFORM_COMPONENTS: 0x8b49,\n  MAX_VERTEX_UNIFORM_COMPONENTS: 0x8b4a,\n  MAX_ARRAY_TEXTURE_LAYERS: 0x88ff,\n  MIN_PROGRAM_TEXEL_OFFSET: 0x8904,\n  MAX_PROGRAM_TEXEL_OFFSET: 0x8905,\n  MAX_VARYING_COMPONENTS: 0x8b4b,\n  FRAGMENT_SHADER_DERIVATIVE_HINT: 0x8b8b,\n  RASTERIZER_DISCARD: 0x8c89,\n  VERTEX_ARRAY_BINDING: 0x85b5,\n  MAX_VERTEX_OUTPUT_COMPONENTS: 0x9122,\n  MAX_FRAGMENT_INPUT_COMPONENTS: 0x9125,\n  MAX_SERVER_WAIT_TIMEOUT: 0x9111,\n  MAX_ELEMENT_INDEX: 0x8d6b,\n  RED: 0x1903,\n  RGB8: 0x8051,\n  RGBA8: 0x8058,\n  RGB10_A2: 0x8059,\n  TEXTURE_3D: 0x806f,\n  TEXTURE_WRAP_R: 0x8072,\n  TEXTURE_MIN_LOD: 0x813a,\n  TEXTURE_MAX_LOD: 0x813b,\n  TEXTURE_BASE_LEVEL: 0x813c,\n  TEXTURE_MAX_LEVEL: 0x813d,\n  TEXTURE_COMPARE_MODE: 0x884c,\n  TEXTURE_COMPARE_FUNC: 0x884d,\n  SRGB: 0x8c40,\n  SRGB8: 0x8c41,\n  SRGB8_ALPHA8: 0x8c43,\n  COMPARE_REF_TO_TEXTURE: 0x884e,\n  RGBA32F: 0x8814,\n  RGB32F: 0x8815,\n  RGBA16F: 0x881a,\n  RGB16F: 0x881b,\n  TEXTURE_2D_ARRAY: 0x8c1a,\n  TEXTURE_BINDING_2D_ARRAY: 0x8c1d,\n  R11F_G11F_B10F: 0x8c3a,\n  RGB9_E5: 0x8c3d,\n  RGBA32UI: 0x8d70,\n  RGB32UI: 0x8d71,\n  RGBA16UI: 0x8d76,\n  RGB16UI: 0x8d77,\n  RGBA8UI: 0x8d7c,\n  RGB8UI: 0x8d7d,\n  RGBA32I: 0x8d82,\n  RGB32I: 0x8d83,\n  RGBA16I: 0x8d88,\n  RGB16I: 0x8d89,\n  RGBA8I: 0x8d8e,\n  RGB8I: 0x8d8f,\n  RED_INTEGER: 0x8d94,\n  RGB_INTEGER: 0x8d98,\n  RGBA_INTEGER: 0x8d99,\n  R8: 0x8229,\n  RG8: 0x822b,\n  R16F: 0x822d,\n  R32F: 0x822e,\n  RG16F: 0x822f,\n  RG32F: 0x8230,\n  R8I: 0x8231,\n  R8UI: 0x8232,\n  R16I: 0x8233,\n  R16UI: 0x8234,\n  R32I: 0x8235,\n  R32UI: 0x8236,\n  RG8I: 0x8237,\n  RG8UI: 0x8238,\n  RG16I: 0x8239,\n  RG16UI: 0x823a,\n  RG32I: 0x823b,\n  RG32UI: 0x823c,\n  R8_SNORM: 0x8f94,\n  RG8_SNORM: 0x8f95,\n  RGB8_SNORM: 0x8f96,\n  RGBA8_SNORM: 0x8f97,\n  RGB10_A2UI: 0x906f,\n  TEXTURE_IMMUTABLE_FORMAT: 0x912f,\n  TEXTURE_IMMUTABLE_LEVELS: 0x82df,\n  UNSIGNED_INT_2_10_10_10_REV: 0x8368,\n  UNSIGNED_INT_10F_11F_11F_REV: 0x8c3b,\n  UNSIGNED_INT_5_9_9_9_REV: 0x8c3e,\n  FLOAT_32_UNSIGNED_INT_24_8_REV: 0x8dad,\n  UNSIGNED_INT_24_8: 0x84fa,\n  HALF_FLOAT: 0x140b,\n  RG: 0x8227,\n  RG_INTEGER: 0x8228,\n  INT_2_10_10_10_REV: 0x8d9f,\n  CURRENT_QUERY: 0x8865,\n  QUERY_RESULT: 0x8866,\n  QUERY_RESULT_AVAILABLE: 0x8867,\n  ANY_SAMPLES_PASSED: 0x8c2f,\n  ANY_SAMPLES_PASSED_CONSERVATIVE: 0x8d6a,\n  MAX_DRAW_BUFFERS: 0x8824,\n  DRAW_BUFFER0: 0x8825,\n  DRAW_BUFFER1: 0x8826,\n  DRAW_BUFFER2: 0x8827,\n  DRAW_BUFFER3: 0x8828,\n  DRAW_BUFFER4: 0x8829,\n  DRAW_BUFFER5: 0x882a,\n  DRAW_BUFFER6: 0x882b,\n  DRAW_BUFFER7: 0x882c,\n  DRAW_BUFFER8: 0x882d,\n  DRAW_BUFFER9: 0x882e,\n  DRAW_BUFFER10: 0x882f,\n  DRAW_BUFFER11: 0x8830,\n  DRAW_BUFFER12: 0x8831,\n  DRAW_BUFFER13: 0x8832,\n  DRAW_BUFFER14: 0x8833,\n  DRAW_BUFFER15: 0x8834,\n  MAX_COLOR_ATTACHMENTS: 0x8cdf,\n  COLOR_ATTACHMENT1: 0x8ce1,\n  COLOR_ATTACHMENT2: 0x8ce2,\n  COLOR_ATTACHMENT3: 0x8ce3,\n  COLOR_ATTACHMENT4: 0x8ce4,\n  COLOR_ATTACHMENT5: 0x8ce5,\n  COLOR_ATTACHMENT6: 0x8ce6,\n  COLOR_ATTACHMENT7: 0x8ce7,\n  COLOR_ATTACHMENT8: 0x8ce8,\n  COLOR_ATTACHMENT9: 0x8ce9,\n  COLOR_ATTACHMENT10: 0x8cea,\n  COLOR_ATTACHMENT11: 0x8ceb,\n  COLOR_ATTACHMENT12: 0x8cec,\n  COLOR_ATTACHMENT13: 0x8ced,\n  COLOR_ATTACHMENT14: 0x8cee,\n  COLOR_ATTACHMENT15: 0x8cef,\n  SAMPLER_3D: 0x8b5f,\n  SAMPLER_2D_SHADOW: 0x8b62,\n  SAMPLER_2D_ARRAY: 0x8dc1,\n  SAMPLER_2D_ARRAY_SHADOW: 0x8dc4,\n  SAMPLER_CUBE_SHADOW: 0x8dc5,\n  INT_SAMPLER_2D: 0x8dca,\n  INT_SAMPLER_3D: 0x8dcb,\n  INT_SAMPLER_CUBE: 0x8dcc,\n  INT_SAMPLER_2D_ARRAY: 0x8dcf,\n  UNSIGNED_INT_SAMPLER_2D: 0x8dd2,\n  UNSIGNED_INT_SAMPLER_3D: 0x8dd3,\n  UNSIGNED_INT_SAMPLER_CUBE: 0x8dd4,\n  UNSIGNED_INT_SAMPLER_2D_ARRAY: 0x8dd7,\n  MAX_SAMPLES: 0x8d57,\n  SAMPLER_BINDING: 0x8919,\n  PIXEL_PACK_BUFFER: 0x88eb,\n  PIXEL_UNPACK_BUFFER: 0x88ec,\n  PIXEL_PACK_BUFFER_BINDING: 0x88ed,\n  PIXEL_UNPACK_BUFFER_BINDING: 0x88ef,\n  COPY_READ_BUFFER: 0x8f36,\n  COPY_WRITE_BUFFER: 0x8f37,\n  COPY_READ_BUFFER_BINDING: 0x8f36,\n  COPY_WRITE_BUFFER_BINDING: 0x8f37,\n  FLOAT_MAT2x3: 0x8b65,\n  FLOAT_MAT2x4: 0x8b66,\n  FLOAT_MAT3x2: 0x8b67,\n  FLOAT_MAT3x4: 0x8b68,\n  FLOAT_MAT4x2: 0x8b69,\n  FLOAT_MAT4x3: 0x8b6a,\n  UNSIGNED_INT_VEC2: 0x8dc6,\n  UNSIGNED_INT_VEC3: 0x8dc7,\n  UNSIGNED_INT_VEC4: 0x8dc8,\n  UNSIGNED_NORMALIZED: 0x8c17,\n  SIGNED_NORMALIZED: 0x8f9c,\n  VERTEX_ATTRIB_ARRAY_INTEGER: 0x88fd,\n  VERTEX_ATTRIB_ARRAY_DIVISOR: 0x88fe,\n  TRANSFORM_FEEDBACK_BUFFER_MODE: 0x8c7f,\n  MAX_TRANSFORM_FEEDBACK_SEPARATE_COMPONENTS: 0x8c80,\n  TRANSFORM_FEEDBACK_VARYINGS: 0x8c83,\n  TRANSFORM_FEEDBACK_BUFFER_START: 0x8c84,\n  TRANSFORM_FEEDBACK_BUFFER_SIZE: 0x8c85,\n  TRANSFORM_FEEDBACK_PRIMITIVES_WRITTEN: 0x8c88,\n  MAX_TRANSFORM_FEEDBACK_INTERLEAVED_COMPONENTS: 0x8c8a,\n  MAX_TRANSFORM_FEEDBACK_SEPARATE_ATTRIBS: 0x8c8b,\n  INTERLEAVED_ATTRIBS: 0x8c8c,\n  SEPARATE_ATTRIBS: 0x8c8d,\n  TRANSFORM_FEEDBACK_BUFFER: 0x8c8e,\n  TRANSFORM_FEEDBACK_BUFFER_BINDING: 0x8c8f,\n  TRANSFORM_FEEDBACK: 0x8e22,\n  TRANSFORM_FEEDBACK_PAUSED: 0x8e23,\n  TRANSFORM_FEEDBACK_ACTIVE: 0x8e24,\n  TRANSFORM_FEEDBACK_BINDING: 0x8e25,\n  FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING: 0x8210,\n  FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE: 0x8211,\n  FRAMEBUFFER_ATTACHMENT_RED_SIZE: 0x8212,\n  FRAMEBUFFER_ATTACHMENT_GREEN_SIZE: 0x8213,\n  FRAMEBUFFER_ATTACHMENT_BLUE_SIZE: 0x8214,\n  FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE: 0x8215,\n  FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE: 0x8216,\n  FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE: 0x8217,\n  FRAMEBUFFER_DEFAULT: 0x8218,\n  DEPTH24_STENCIL8: 0x88f0,\n  DRAW_FRAMEBUFFER_BINDING: 0x8ca6,\n  READ_FRAMEBUFFER_BINDING: 0x8caa,\n  RENDERBUFFER_SAMPLES: 0x8cab,\n  FRAMEBUFFER_ATTACHMENT_TEXTURE_LAYER: 0x8cd4,\n  FRAMEBUFFER_INCOMPLETE_MULTISAMPLE: 0x8d56,\n  UNIFORM_BUFFER: 0x8a11,\n  UNIFORM_BUFFER_BINDING: 0x8a28,\n  UNIFORM_BUFFER_START: 0x8a29,\n  UNIFORM_BUFFER_SIZE: 0x8a2a,\n  MAX_VERTEX_UNIFORM_BLOCKS: 0x8a2b,\n  MAX_FRAGMENT_UNIFORM_BLOCKS: 0x8a2d,\n  MAX_COMBINED_UNIFORM_BLOCKS: 0x8a2e,\n  MAX_UNIFORM_BUFFER_BINDINGS: 0x8a2f,\n  MAX_UNIFORM_BLOCK_SIZE: 0x8a30,\n  MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS: 0x8a31,\n  MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS: 0x8a33,\n  UNIFORM_BUFFER_OFFSET_ALIGNMENT: 0x8a34,\n  ACTIVE_UNIFORM_BLOCKS: 0x8a36,\n  UNIFORM_TYPE: 0x8a37,\n  UNIFORM_SIZE: 0x8a38,\n  UNIFORM_BLOCK_INDEX: 0x8a3a,\n  UNIFORM_OFFSET: 0x8a3b,\n  UNIFORM_ARRAY_STRIDE: 0x8a3c,\n  UNIFORM_MATRIX_STRIDE: 0x8a3d,\n  UNIFORM_IS_ROW_MAJOR: 0x8a3e,\n  UNIFORM_BLOCK_BINDING: 0x8a3f,\n  UNIFORM_BLOCK_DATA_SIZE: 0x8a40,\n  UNIFORM_BLOCK_ACTIVE_UNIFORMS: 0x8a42,\n  UNIFORM_BLOCK_ACTIVE_UNIFORM_INDICES: 0x8a43,\n  UNIFORM_BLOCK_REFERENCED_BY_VERTEX_SHADER: 0x8a44,\n  UNIFORM_BLOCK_REFERENCED_BY_FRAGMENT_SHADER: 0x8a46,\n  OBJECT_TYPE: 0x9112,\n  SYNC_CONDITION: 0x9113,\n  SYNC_STATUS: 0x9114,\n  SYNC_FLAGS: 0x9115,\n  SYNC_FENCE: 0x9116,\n  SYNC_GPU_COMMANDS_COMPLETE: 0x9117,\n  UNSIGNALED: 0x9118,\n  SIGNALED: 0x9119,\n  ALREADY_SIGNALED: 0x911a,\n  TIMEOUT_EXPIRED: 0x911b,\n  CONDITION_SATISFIED: 0x911c,\n  WAIT_FAILED: 0x911d,\n  SYNC_FLUSH_COMMANDS_BIT: 0x00000001,\n  COLOR: 0x1800,\n  DEPTH: 0x1801,\n  STENCIL: 0x1802,\n  MIN: 0x8007,\n  MAX: 0x8008,\n  DEPTH_COMPONENT24: 0x81a6,\n  STREAM_READ: 0x88e1,\n  STREAM_COPY: 0x88e2,\n  STATIC_READ: 0x88e5,\n  STATIC_COPY: 0x88e6,\n  DYNAMIC_READ: 0x88e9,\n  DYNAMIC_COPY: 0x88ea,\n  DEPTH_COMPONENT32F: 0x8cac,\n  DEPTH32F_STENCIL8: 0x8cad,\n  INVALID_INDEX: 0xffffffff,\n  TIMEOUT_IGNORED: -1,\n  MAX_CLIENT_WAIT_TIMEOUT_WEBGL: 0x9247,\n  VERTEX_ATTRIB_ARRAY_DIVISOR_ANGLE: 0x88fe,\n  UNMASKED_VENDOR_WEBGL: 0x9245,\n  UNMASKED_RENDERER_WEBGL: 0x9246,\n  MAX_TEXTURE_MAX_ANISOTROPY_EXT: 0x84ff,\n  TEXTURE_MAX_ANISOTROPY_EXT: 0x84fe,\n  COMPRESSED_RGB_S3TC_DXT1_EXT: 0x83f0,\n  COMPRESSED_RGBA_S3TC_DXT1_EXT: 0x83f1,\n  COMPRESSED_RGBA_S3TC_DXT3_EXT: 0x83f2,\n  COMPRESSED_RGBA_S3TC_DXT5_EXT: 0x83f3,\n  COMPRESSED_R11_EAC: 0x9270,\n  COMPRESSED_SIGNED_R11_EAC: 0x9271,\n  COMPRESSED_RG11_EAC: 0x9272,\n  COMPRESSED_SIGNED_RG11_EAC: 0x9273,\n  COMPRESSED_RGB8_ETC2: 0x9274,\n  COMPRESSED_RGBA8_ETC2_EAC: 0x9275,\n  COMPRESSED_SRGB8_ETC2: 0x9276,\n  COMPRESSED_SRGB8_ALPHA8_ETC2_EAC: 0x9277,\n  COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2: 0x9278,\n  COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2: 0x9279,\n  COMPRESSED_RGB_PVRTC_4BPPV1_IMG: 0x8c00,\n  COMPRESSED_RGBA_PVRTC_4BPPV1_IMG: 0x8c02,\n  COMPRESSED_RGB_PVRTC_2BPPV1_IMG: 0x8c01,\n  COMPRESSED_RGBA_PVRTC_2BPPV1_IMG: 0x8c03,\n  COMPRESSED_RGB_ETC1_WEBGL: 0x8d64,\n  COMPRESSED_RGB_ATC_WEBGL: 0x8c92,\n  COMPRESSED_RGBA_ATC_EXPLICIT_ALPHA_WEBGL: 0x8c92,\n  COMPRESSED_RGBA_ATC_INTERPOLATED_ALPHA_WEBGL: 0x87ee,\n  UNSIGNED_INT_24_8_WEBGL: 0x84fa,\n  HALF_FLOAT_OES: 0x8d61,\n  RGBA32F_EXT: 0x8814,\n  RGB32F_EXT: 0x8815,\n  FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE_EXT: 0x8211,\n  UNSIGNED_NORMALIZED_EXT: 0x8c17,\n  MIN_EXT: 0x8007,\n  MAX_EXT: 0x8008,\n  SRGB_EXT: 0x8c40,\n  SRGB_ALPHA_EXT: 0x8c42,\n  SRGB8_ALPHA8_EXT: 0x8c43,\n  FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING_EXT: 0x8210,\n  FRAGMENT_SHADER_DERIVATIVE_HINT_OES: 0x8b8b,\n  COLOR_ATTACHMENT0_WEBGL: 0x8ce0,\n  COLOR_ATTACHMENT1_WEBGL: 0x8ce1,\n  COLOR_ATTACHMENT2_WEBGL: 0x8ce2,\n  COLOR_ATTACHMENT3_WEBGL: 0x8ce3,\n  COLOR_ATTACHMENT4_WEBGL: 0x8ce4,\n  COLOR_ATTACHMENT5_WEBGL: 0x8ce5,\n  COLOR_ATTACHMENT6_WEBGL: 0x8ce6,\n  COLOR_ATTACHMENT7_WEBGL: 0x8ce7,\n  COLOR_ATTACHMENT8_WEBGL: 0x8ce8,\n  COLOR_ATTACHMENT9_WEBGL: 0x8ce9,\n  COLOR_ATTACHMENT10_WEBGL: 0x8cea,\n  COLOR_ATTACHMENT11_WEBGL: 0x8ceb,\n  COLOR_ATTACHMENT12_WEBGL: 0x8cec,\n  COLOR_ATTACHMENT13_WEBGL: 0x8ced,\n  COLOR_ATTACHMENT14_WEBGL: 0x8cee,\n  COLOR_ATTACHMENT15_WEBGL: 0x8cef,\n  DRAW_BUFFER0_WEBGL: 0x8825,\n  DRAW_BUFFER1_WEBGL: 0x8826,\n  DRAW_BUFFER2_WEBGL: 0x8827,\n  DRAW_BUFFER3_WEBGL: 0x8828,\n  DRAW_BUFFER4_WEBGL: 0x8829,\n  DRAW_BUFFER5_WEBGL: 0x882a,\n  DRAW_BUFFER6_WEBGL: 0x882b,\n  DRAW_BUFFER7_WEBGL: 0x882c,\n  DRAW_BUFFER8_WEBGL: 0x882d,\n  DRAW_BUFFER9_WEBGL: 0x882e,\n  DRAW_BUFFER10_WEBGL: 0x882f,\n  DRAW_BUFFER11_WEBGL: 0x8830,\n  DRAW_BUFFER12_WEBGL: 0x8831,\n  DRAW_BUFFER13_WEBGL: 0x8832,\n  DRAW_BUFFER14_WEBGL: 0x8833,\n  DRAW_BUFFER15_WEBGL: 0x8834,\n  MAX_COLOR_ATTACHMENTS_WEBGL: 0x8cdf,\n  MAX_DRAW_BUFFERS_WEBGL: 0x8824,\n  VERTEX_ARRAY_BINDING_OES: 0x85b5,\n  QUERY_COUNTER_BITS_EXT: 0x8864,\n  CURRENT_QUERY_EXT: 0x8865,\n  QUERY_RESULT_EXT: 0x8866,\n  QUERY_RESULT_AVAILABLE_EXT: 0x8867,\n  TIME_ELAPSED_EXT: 0x88bf,\n  TIMESTAMP_EXT: 0x8e28,\n  GPU_DISJOINT_EXT: 0x8fbb\n};\n//# sourceMappingURL=index.js.map","/* global document */\nlet lastPickedObject;\nlet lastTooltip;\n\nconst DEFAULT_STYLE = {\n  fontFamily: '\"Helvetica Neue\", Helvetica, Arial, sans-serif',\n  display: 'flex',\n  flex: 'wrap',\n  maxWidth: '500px',\n  flexDirection: 'column',\n  zIndex: 2\n};\n\nfunction getDiv() {\n  return document.createElement('div');\n}\n\nexport function getTooltipDefault(pickedInfo) {\n  if (!pickedInfo.picked) {\n    return null;\n  }\n  if (pickedInfo.object === lastPickedObject) {\n    return lastTooltip;\n  }\n  const tooltip = {\n    html: tabularize(pickedInfo.object),\n    style: DEFAULT_STYLE\n  };\n  lastTooltip = tooltip;\n  lastPickedObject = pickedInfo.object;\n  return tooltip;\n}\n\nconst EXCLUDES = new Set(['position', 'index']);\n\nexport function tabularize(json) {\n  // Turns a JSON object of picked info into HTML for a tooltip\n  const dataTable = getDiv();\n\n  // Creates rows of two columns for the tooltip\n  for (const key in json) {\n    if (EXCLUDES.has(key)) {\n      continue; // eslint-disable-line\n    }\n    const header = getDiv();\n    header.className = 'header';\n    header.textContent = key;\n\n    const valueElement = getDiv();\n    valueElement.className = 'value';\n\n    valueElement.textContent = toText(json[key]);\n\n    const row = getDiv();\n\n    setStyles(row, header, valueElement);\n\n    row.appendChild(header);\n    row.appendChild(valueElement);\n    dataTable.appendChild(row);\n  }\n\n  return dataTable.innerHTML;\n}\n\nfunction setStyles(row, header, value) {\n  // Set default tooltip style\n  Object.assign(header.style, {\n    fontWeight: 700,\n    marginRight: '10px',\n    flex: '1 1 0%'\n  });\n\n  Object.assign(value.style, {\n    flex: 'none',\n    maxWidth: '250px',\n    overflow: 'hidden',\n    whiteSpace: 'nowrap',\n    textOverflow: 'ellipsis'\n  });\n\n  Object.assign(row.style, {\n    display: 'flex',\n    flexDirection: 'row',\n    justifyContent: 'space-between',\n    alignItems: 'stretch'\n  });\n}\n\nexport function toText(jsonValue) {\n  // Set contents of table value, trimming for certain types of data\n  let text;\n  if (Array.isArray(jsonValue) && jsonValue.length > 4) {\n    text = `Array<${jsonValue.length}>`;\n  } else if (typeof jsonValue === 'string') {\n    text = jsonValue;\n  } else if (typeof jsonValue === 'number') {\n    text = String(jsonValue);\n  } else {\n    try {\n      text = JSON.stringify(jsonValue);\n    } catch (err) {\n      text = '<Non-Serializable Object>';\n    }\n  }\n  const MAX_LENGTH = 50;\n  if (text.length > MAX_LENGTH) {\n    text = text.slice(0, MAX_LENGTH);\n  }\n  return text;\n}\n\nexport function substituteIn(template, json) {\n  /*\n   * Flexible substitution of templates using a json:\n   * - if the json contains the key, use [key]\n   * - if the json does not contain the key, try ['properties'][key]\n   * - if the key contains several keys separated with dots, use them all in a row:\n   *   e.g. 'a.b.c' will read json['a']['b']['c']\n   */\n  let value;\n  let output = template;\n  const propsKey = 'properties';\n  const keyPattern = /{[^}]*}/g;\n  const cleanKey = k => k.replace(/[{}]/g, '');\n  const keys = [...new Set(template.match(keyPattern).map(cleanKey))];\n\n  for (const key of keys) {\n    if (key.includes('.')) {\n      value = json;\n      const subkeys = key.split('.');\n      for (const subkey of subkeys) {\n        if (value.hasOwnProperty(subkey)) {\n          value = value[subkey];\n        } else {\n          value = undefined;\n          break;\n        }\n      }\n    } else if (json.hasOwnProperty(key)) {\n      value = json[key];\n    } else if (json[propsKey] && json[propsKey].hasOwnProperty(key)) {\n      value = json[propsKey][key];\n    } else {\n      value = undefined;\n    }\n    output = output.replaceAll(`{${key}}`, value);\n  }\n\n  return output;\n}\n\nexport default function makeTooltip(tooltip) {\n  /*\n   * If explictly no tooltip passed by user, return null\n   * If a JSON object passed, return a tooltip based on that object\n   *   We expect the user has passed a string template that will take pickedInfo keywords\n   * If a boolean passed, return the default tooltip\n   */\n  if (!tooltip) {\n    return null;\n  }\n\n  if (tooltip.html || tooltip.text) {\n    return pickedInfo => {\n      if (!pickedInfo.picked) {\n        return null;\n      }\n\n      const formattedTooltip = {\n        style: tooltip.style || DEFAULT_STYLE\n      };\n\n      if (tooltip.html) {\n        formattedTooltip.html = substituteIn(tooltip.html, pickedInfo.object);\n      } else {\n        formattedTooltip.text = substituteIn(tooltip.text, pickedInfo.object);\n      }\n\n      return formattedTooltip;\n    };\n  }\n\n  return getTooltipDefault;\n}\n","/* global document */\n\n// Ensure we only load a script once\nconst scriptLoadPromises = {};\n\nexport function loadScript(url) {\n  if (!scriptLoadPromises[url]) {\n    const script = document.createElement('script');\n    script.type = 'text/javascript';\n    script.src = url;\n    const head = document.querySelector('head');\n    head.appendChild(script);\n\n    scriptLoadPromises[url] = new Promise(resolve => {\n      script.onload = resolve;\n    });\n  }\n  return scriptLoadPromises[url];\n}\n","export const BOX_STYLE = {\n  position: 'absolute',\n  top: '0px',\n  left: '0px',\n  width: 344,\n  padding: '12px 24px',\n  margin: 24,\n  overflowX: 'hidden',\n  overflowY: 'overlay',\n  outline: 'none',\n  maxHeight: '94%',\n  boxSizing: 'border-box',\n  backgroundColor: 'rgb(255, 255, 255)',\n  fontFamily: '\"Fira Sans\", sans-serif',\n  zIndex: 1\n};\n","/* global document */\n\nimport {BOX_STYLE} from './component-css';\n\nclass DescriptionCard {\n  constructor({container, props}) {\n    const {description} = props;\n\n    const div = document.createElement('div');\n    div.className = 'deck-json-description-box';\n    Object.assign(div.style, BOX_STYLE);\n    this.el = div;\n\n    const textContainer = document.createElement('div');\n    textContainer.innerHTML = description;\n\n    div.appendChild(textContainer);\n    container.append(div);\n  }\n\n  remove() {\n    this.el.remove();\n    this.description = null;\n  }\n\n  static get stringName() {\n    // name within JSON\n    return 'description';\n  }\n}\n\nexport default DescriptionCard;\n","/* global console, window */\n/* eslint-disable no-console */\nimport {CSVLoader} from '@loaders.gl/csv';\nimport {registerLoaders} from '@loaders.gl/core';\n// Avoid calling it GL - would be removed by babel-plugin-inline-webgl-constants\nimport GLConstants from '@luma.gl/constants';\n\nimport makeTooltip from './widget-tooltip';\n\nimport mapboxgl, {modifyMapboxElements} from './utils/mapbox-utils';\nimport {loadScript} from './utils/script-utils';\nimport {createGoogleMapsDeckOverlay} from './utils/google-maps-utils';\n\nimport {addSupportComponents} from '../lib/components/index';\n\nimport * as deck from '../deck-bundle';\n\nconst classesFilter = x => x.charAt(0) === x.charAt(0).toUpperCase();\nconst functionsFilter = x => x.charAt(0) === x.charAt(0).toLowerCase() && x.charAt(0) != '_';\n\nfunction extractElements(library = {}, filter) {\n  // Extracts exported elements as a dictionary from a library\n  const dict = {};\n  const elements = Object.keys(library).filter(filter);\n  for (const el of elements) {\n    dict[el] = library[el];\n  }\n  return dict;\n}\n\n// Handle JSONConverter and loaders configuration\nconst jsonConverterConfiguration = {\n  classes: extractElements(deck, classesFilter),\n  // Will be resolved as `<enum-name>.<enum-value>`\n  enumerations: {\n    COORDINATE_SYSTEM: deck.COORDINATE_SYSTEM,\n    GL: GLConstants\n  }\n};\n\nregisterLoaders([CSVLoader]);\n\nconst jsonConverter = new deck.JSONConverter({\n  configuration: jsonConverterConfiguration\n});\n\nfunction addModuleToConverter(module, converter) {\n  const newConfiguration = {\n    classes: extractElements(module, classesFilter),\n    functions: extractElements(module, functionsFilter)\n  };\n  converter.mergeConfiguration(newConfiguration);\n}\n\nexport function addCustomLibraries(customLibraries, onComplete) {\n  if (!customLibraries) {\n    return;\n  }\n\n  const loaded = {};\n\n  function onEachFinish() {\n    if (Object.values(loaded).every(f => f)) {\n      // when all libraries loaded\n      if (typeof onComplete === 'function') onComplete();\n    }\n  }\n\n  function onModuleLoaded(libraryName, module) {\n    addModuleToConverter(module, jsonConverter);\n    loaded[libraryName] = module;\n    onEachFinish();\n  }\n\n  customLibraries.forEach(({libraryName, resourceUri}) => {\n    // set loaded to be false, even if addCustomLibraries is called multiple times\n    // with the same parameters\n    loaded[libraryName] = false;\n\n    if (libraryName in window) {\n      // do not redefine\n      onModuleLoaded(libraryName, window[libraryName]);\n      return;\n    }\n\n    // because loadscript is async and scipt execution is untraceble\n    // the only way we can listen on its execution complete is to observe on the\n    // window.libraryName property\n    Object.defineProperty(window, libraryName, {\n      set: module => onModuleLoaded(libraryName, module),\n      get: () => {\n        return loaded[libraryName];\n      }\n    });\n\n    loadScript(resourceUri);\n  });\n}\n\nfunction updateDeck(inputJson, deckgl) {\n  const results = jsonConverter.convert(inputJson);\n  deckgl.setProps(results);\n}\n\nfunction missingLayers(oldLayers, newLayers) {\n  return oldLayers.filter(ol => ol && ol.id && !newLayers.find(nl => nl.id === ol.id));\n}\n\nfunction createStandaloneFromProvider({\n  mapProvider,\n  props,\n  mapboxApiKey,\n  googleMapsKey,\n  handleEvent,\n  getTooltip,\n  container\n}) {\n  // Common deck.gl props for all basemaos\n  const handlers = handleEvent\n    ? {\n        onClick: info => handleEvent('deck-click-event', info),\n        onHover: info => handleEvent('deck-hover-event', info),\n        onResize: size => handleEvent('deck-resize-event', size),\n        onViewStateChange: ({viewState, interactionState, oldViewState}) => {\n          const viewport = new deck.WebMercatorViewport(viewState);\n          viewState.nw = viewport.unproject([0, 0]);\n          viewState.se = viewport.unproject([viewport.width, viewport.height]);\n          handleEvent('deck-view-state-change-event', viewState);\n        },\n        onDragStart: info => handleEvent('deck-drag-start-event', info),\n        onDrag: info => handleEvent('deck-drag-event', info),\n        onDragEnd: info => handleEvent('deck-drag-end-event', info)\n      }\n    : null;\n\n  const sharedProps = {\n    ...handlers,\n    getTooltip,\n    container\n  };\n\n  switch (mapProvider) {\n    case 'mapbox':\n      deck.log.info('Using Mapbox base maps')();\n      return new deck.DeckGL({\n        ...sharedProps,\n        ...props,\n        map: mapboxgl,\n        mapboxApiAccessToken: mapboxApiKey,\n        onLoad: modifyMapboxElements\n      });\n    case 'carto':\n      deck.log.info('Using Carto base maps')();\n      return new deck.DeckGL({\n        map: mapboxgl,\n        ...sharedProps,\n        ...props\n      });\n    case 'google_maps':\n      deck.log.info('Using Google Maps base maps')();\n      return createGoogleMapsDeckOverlay({\n        ...sharedProps,\n        ...props,\n        googleMapsKey\n      });\n    default:\n      deck.log.info('No recognized map provider specified')();\n      return new deck.DeckGL({\n        ...sharedProps,\n        ...props,\n        map: null,\n        mapboxApiAccessToken: null\n      });\n  }\n}\n\nfunction createDeck({\n  mapboxApiKey,\n  googleMapsKey,\n  container,\n  jsonInput,\n  tooltip,\n  handleEvent,\n  customLibraries,\n  configuration\n}) {\n  let deckgl;\n  try {\n    if (configuration) {\n      jsonConverter.mergeConfiguration(configuration);\n    }\n\n    const oldLayers = jsonInput.layers || [];\n    const props = jsonConverter.convert(jsonInput);\n\n    addSupportComponents(container, props);\n\n    const convertedLayers = (props.layers || []).filter(l => l);\n\n    // loading custom library is async, some layers might not be convertable before custom library loads\n    const layerToLoad = missingLayers(oldLayers, convertedLayers);\n    const getTooltip = makeTooltip(tooltip);\n    const {mapProvider} = props;\n\n    deckgl = createStandaloneFromProvider({\n      mapProvider,\n      props,\n      mapboxApiKey,\n      googleMapsKey,\n      handleEvent,\n      getTooltip,\n      container\n    });\n\n    const onComplete = () => {\n      if (layerToLoad.length) {\n        // convert input layer again to presist layer order\n        const newProps = jsonConverter.convert({layers: jsonInput.layers});\n        const newLayers = (newProps.layers || []).filter(l => l);\n\n        if (newLayers.length > convertedLayers.length) {\n          // if more layers are converted\n          deckgl.setProps({layers: newLayers});\n        }\n      }\n    };\n\n    addCustomLibraries(customLibraries, onComplete);\n  } catch (err) {\n    // This will fail in node tests\n    // eslint-disable-next-line\n    console.error(err);\n  }\n  return deckgl;\n}\n\nexport {createDeck, updateDeck, jsonConverter};\n","/* global window */\nimport * as deck from '../../deck-bundle';\n\nexport function createGoogleMapsDeckOverlay({\n  container,\n  onClick,\n  onComplete,\n  getTooltip,\n  googleMapsKey,\n  layers,\n  mapStyle = 'satellite',\n  initialViewState = {latitude: 0, longitude: 0, zoom: 1}\n}) {\n  if (!googleMapsKey) {\n    deck.log.warn('No Google Maps API key set')();\n    return null;\n  }\n  const deckOverlay = new deck.GoogleMapsOverlay({layers});\n  const view = {\n    center: {lat: initialViewState.latitude, lng: initialViewState.longitude},\n    mapTypeId: mapStyle,\n    zoom: initialViewState.zoom\n  };\n\n  const map = new window.google.maps.Map(container, view);\n  deckOverlay.setMap(map);\n  return deckOverlay;\n}\n","/* global document  */\nimport DescriptionCard from './description-card';\n\nexport function addSupportComponents(parentContainer, props) {\n  const uiElementsOverlay = document.createElement('div');\n  uiElementsOverlay.className = 'deckgl-ui-elements-overlay';\n  uiElementsOverlay.style.zIndex = 1;\n  parentContainer.insertAdjacentElement('beforebegin', uiElementsOverlay);\n\n  const components = [];\n  for (const key of Object.keys(props)) {\n    switch (key) {\n      case 'description':\n        const el = new DescriptionCard({container: uiElementsOverlay, props});\n        components.push(el);\n        break;\n      default:\n        break;\n    }\n  }\n  return components;\n}\n","function _classCallCheck(instance, Constructor) {\n  if (!(instance instanceof Constructor)) {\n    throw new TypeError(\"Cannot call a class as a function\");\n  }\n}\nmodule.exports = _classCallCheck, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","var toPropertyKey = require(\"./toPropertyKey.js\");\nfunction _defineProperties(target, props) {\n  for (var i = 0; i < props.length; i++) {\n    var descriptor = props[i];\n    descriptor.enumerable = descriptor.enumerable || false;\n    descriptor.configurable = true;\n    if (\"value\" in descriptor) descriptor.writable = true;\n    Object.defineProperty(target, toPropertyKey(descriptor.key), descriptor);\n  }\n}\nfunction _createClass(Constructor, protoProps, staticProps) {\n  if (protoProps) _defineProperties(Constructor.prototype, protoProps);\n  if (staticProps) _defineProperties(Constructor, staticProps);\n  Object.defineProperty(Constructor, \"prototype\", {\n    writable: false\n  });\n  return Constructor;\n}\nmodule.exports = _createClass, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","import * as glMatrix from \"./common.js\";\n/**\r\n * 4 Dimensional Vector\r\n * @module vec4\r\n */\n\n/**\r\n * Creates a new, empty vec4\r\n *\r\n * @returns {vec4} a new 4D vector\r\n */\n\nexport function create() {\n  var out = new glMatrix.ARRAY_TYPE(4);\n\n  if (glMatrix.ARRAY_TYPE != Float32Array) {\n    out[0] = 0;\n    out[1] = 0;\n    out[2] = 0;\n    out[3] = 0;\n  }\n\n  return out;\n}\n/**\r\n * Creates a new vec4 initialized with values from an existing vector\r\n *\r\n * @param {ReadonlyVec4} a vector to clone\r\n * @returns {vec4} a new 4D vector\r\n */\n\nexport function clone(a) {\n  var out = new glMatrix.ARRAY_TYPE(4);\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  out[3] = a[3];\n  return out;\n}\n/**\r\n * Creates a new vec4 initialized with the given values\r\n *\r\n * @param {Number} x X component\r\n * @param {Number} y Y component\r\n * @param {Number} z Z component\r\n * @param {Number} w W component\r\n * @returns {vec4} a new 4D vector\r\n */\n\nexport function fromValues(x, y, z, w) {\n  var out = new glMatrix.ARRAY_TYPE(4);\n  out[0] = x;\n  out[1] = y;\n  out[2] = z;\n  out[3] = w;\n  return out;\n}\n/**\r\n * Copy the values from one vec4 to another\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a the source vector\r\n * @returns {vec4} out\r\n */\n\nexport function copy(out, a) {\n  out[0] = a[0];\n  out[1] = a[1];\n  out[2] = a[2];\n  out[3] = a[3];\n  return out;\n}\n/**\r\n * Set the components of a vec4 to the given values\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {Number} x X component\r\n * @param {Number} y Y component\r\n * @param {Number} z Z component\r\n * @param {Number} w W component\r\n * @returns {vec4} out\r\n */\n\nexport function set(out, x, y, z, w) {\n  out[0] = x;\n  out[1] = y;\n  out[2] = z;\n  out[3] = w;\n  return out;\n}\n/**\r\n * Adds two vec4's\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a the first operand\r\n * @param {ReadonlyVec4} b the second operand\r\n * @returns {vec4} out\r\n */\n\nexport function add(out, a, b) {\n  out[0] = a[0] + b[0];\n  out[1] = a[1] + b[1];\n  out[2] = a[2] + b[2];\n  out[3] = a[3] + b[3];\n  return out;\n}\n/**\r\n * Subtracts vector b from vector a\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a the first operand\r\n * @param {ReadonlyVec4} b the second operand\r\n * @returns {vec4} out\r\n */\n\nexport function subtract(out, a, b) {\n  out[0] = a[0] - b[0];\n  out[1] = a[1] - b[1];\n  out[2] = a[2] - b[2];\n  out[3] = a[3] - b[3];\n  return out;\n}\n/**\r\n * Multiplies two vec4's\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a the first operand\r\n * @param {ReadonlyVec4} b the second operand\r\n * @returns {vec4} out\r\n */\n\nexport function multiply(out, a, b) {\n  out[0] = a[0] * b[0];\n  out[1] = a[1] * b[1];\n  out[2] = a[2] * b[2];\n  out[3] = a[3] * b[3];\n  return out;\n}\n/**\r\n * Divides two vec4's\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a the first operand\r\n * @param {ReadonlyVec4} b the second operand\r\n * @returns {vec4} out\r\n */\n\nexport function divide(out, a, b) {\n  out[0] = a[0] / b[0];\n  out[1] = a[1] / b[1];\n  out[2] = a[2] / b[2];\n  out[3] = a[3] / b[3];\n  return out;\n}\n/**\r\n * Math.ceil the components of a vec4\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a vector to ceil\r\n * @returns {vec4} out\r\n */\n\nexport function ceil(out, a) {\n  out[0] = Math.ceil(a[0]);\n  out[1] = Math.ceil(a[1]);\n  out[2] = Math.ceil(a[2]);\n  out[3] = Math.ceil(a[3]);\n  return out;\n}\n/**\r\n * Math.floor the components of a vec4\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a vector to floor\r\n * @returns {vec4} out\r\n */\n\nexport function floor(out, a) {\n  out[0] = Math.floor(a[0]);\n  out[1] = Math.floor(a[1]);\n  out[2] = Math.floor(a[2]);\n  out[3] = Math.floor(a[3]);\n  return out;\n}\n/**\r\n * Returns the minimum of two vec4's\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a the first operand\r\n * @param {ReadonlyVec4} b the second operand\r\n * @returns {vec4} out\r\n */\n\nexport function min(out, a, b) {\n  out[0] = Math.min(a[0], b[0]);\n  out[1] = Math.min(a[1], b[1]);\n  out[2] = Math.min(a[2], b[2]);\n  out[3] = Math.min(a[3], b[3]);\n  return out;\n}\n/**\r\n * Returns the maximum of two vec4's\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a the first operand\r\n * @param {ReadonlyVec4} b the second operand\r\n * @returns {vec4} out\r\n */\n\nexport function max(out, a, b) {\n  out[0] = Math.max(a[0], b[0]);\n  out[1] = Math.max(a[1], b[1]);\n  out[2] = Math.max(a[2], b[2]);\n  out[3] = Math.max(a[3], b[3]);\n  return out;\n}\n/**\r\n * Math.round the components of a vec4\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a vector to round\r\n * @returns {vec4} out\r\n */\n\nexport function round(out, a) {\n  out[0] = Math.round(a[0]);\n  out[1] = Math.round(a[1]);\n  out[2] = Math.round(a[2]);\n  out[3] = Math.round(a[3]);\n  return out;\n}\n/**\r\n * Scales a vec4 by a scalar number\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a the vector to scale\r\n * @param {Number} b amount to scale the vector by\r\n * @returns {vec4} out\r\n */\n\nexport function scale(out, a, b) {\n  out[0] = a[0] * b;\n  out[1] = a[1] * b;\n  out[2] = a[2] * b;\n  out[3] = a[3] * b;\n  return out;\n}\n/**\r\n * Adds two vec4's after scaling the second operand by a scalar value\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a the first operand\r\n * @param {ReadonlyVec4} b the second operand\r\n * @param {Number} scale the amount to scale b by before adding\r\n * @returns {vec4} out\r\n */\n\nexport function scaleAndAdd(out, a, b, scale) {\n  out[0] = a[0] + b[0] * scale;\n  out[1] = a[1] + b[1] * scale;\n  out[2] = a[2] + b[2] * scale;\n  out[3] = a[3] + b[3] * scale;\n  return out;\n}\n/**\r\n * Calculates the euclidian distance between two vec4's\r\n *\r\n * @param {ReadonlyVec4} a the first operand\r\n * @param {ReadonlyVec4} b the second operand\r\n * @returns {Number} distance between a and b\r\n */\n\nexport function distance(a, b) {\n  var x = b[0] - a[0];\n  var y = b[1] - a[1];\n  var z = b[2] - a[2];\n  var w = b[3] - a[3];\n  return Math.hypot(x, y, z, w);\n}\n/**\r\n * Calculates the squared euclidian distance between two vec4's\r\n *\r\n * @param {ReadonlyVec4} a the first operand\r\n * @param {ReadonlyVec4} b the second operand\r\n * @returns {Number} squared distance between a and b\r\n */\n\nexport function squaredDistance(a, b) {\n  var x = b[0] - a[0];\n  var y = b[1] - a[1];\n  var z = b[2] - a[2];\n  var w = b[3] - a[3];\n  return x * x + y * y + z * z + w * w;\n}\n/**\r\n * Calculates the length of a vec4\r\n *\r\n * @param {ReadonlyVec4} a vector to calculate length of\r\n * @returns {Number} length of a\r\n */\n\nexport function length(a) {\n  var x = a[0];\n  var y = a[1];\n  var z = a[2];\n  var w = a[3];\n  return Math.hypot(x, y, z, w);\n}\n/**\r\n * Calculates the squared length of a vec4\r\n *\r\n * @param {ReadonlyVec4} a vector to calculate squared length of\r\n * @returns {Number} squared length of a\r\n */\n\nexport function squaredLength(a) {\n  var x = a[0];\n  var y = a[1];\n  var z = a[2];\n  var w = a[3];\n  return x * x + y * y + z * z + w * w;\n}\n/**\r\n * Negates the components of a vec4\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a vector to negate\r\n * @returns {vec4} out\r\n */\n\nexport function negate(out, a) {\n  out[0] = -a[0];\n  out[1] = -a[1];\n  out[2] = -a[2];\n  out[3] = -a[3];\n  return out;\n}\n/**\r\n * Returns the inverse of the components of a vec4\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a vector to invert\r\n * @returns {vec4} out\r\n */\n\nexport function inverse(out, a) {\n  out[0] = 1.0 / a[0];\n  out[1] = 1.0 / a[1];\n  out[2] = 1.0 / a[2];\n  out[3] = 1.0 / a[3];\n  return out;\n}\n/**\r\n * Normalize a vec4\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a vector to normalize\r\n * @returns {vec4} out\r\n */\n\nexport function normalize(out, a) {\n  var x = a[0];\n  var y = a[1];\n  var z = a[2];\n  var w = a[3];\n  var len = x * x + y * y + z * z + w * w;\n\n  if (len > 0) {\n    len = 1 / Math.sqrt(len);\n  }\n\n  out[0] = x * len;\n  out[1] = y * len;\n  out[2] = z * len;\n  out[3] = w * len;\n  return out;\n}\n/**\r\n * Calculates the dot product of two vec4's\r\n *\r\n * @param {ReadonlyVec4} a the first operand\r\n * @param {ReadonlyVec4} b the second operand\r\n * @returns {Number} dot product of a and b\r\n */\n\nexport function dot(a, b) {\n  return a[0] * b[0] + a[1] * b[1] + a[2] * b[2] + a[3] * b[3];\n}\n/**\r\n * Returns the cross-product of three vectors in a 4-dimensional space\r\n *\r\n * @param {ReadonlyVec4} result the receiving vector\r\n * @param {ReadonlyVec4} U the first vector\r\n * @param {ReadonlyVec4} V the second vector\r\n * @param {ReadonlyVec4} W the third vector\r\n * @returns {vec4} result\r\n */\n\nexport function cross(out, u, v, w) {\n  var A = v[0] * w[1] - v[1] * w[0],\n      B = v[0] * w[2] - v[2] * w[0],\n      C = v[0] * w[3] - v[3] * w[0],\n      D = v[1] * w[2] - v[2] * w[1],\n      E = v[1] * w[3] - v[3] * w[1],\n      F = v[2] * w[3] - v[3] * w[2];\n  var G = u[0];\n  var H = u[1];\n  var I = u[2];\n  var J = u[3];\n  out[0] = H * F - I * E + J * D;\n  out[1] = -(G * F) + I * C - J * B;\n  out[2] = G * E - H * C + J * A;\n  out[3] = -(G * D) + H * B - I * A;\n  return out;\n}\n/**\r\n * Performs a linear interpolation between two vec4's\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a the first operand\r\n * @param {ReadonlyVec4} b the second operand\r\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\r\n * @returns {vec4} out\r\n */\n\nexport function lerp(out, a, b, t) {\n  var ax = a[0];\n  var ay = a[1];\n  var az = a[2];\n  var aw = a[3];\n  out[0] = ax + t * (b[0] - ax);\n  out[1] = ay + t * (b[1] - ay);\n  out[2] = az + t * (b[2] - az);\n  out[3] = aw + t * (b[3] - aw);\n  return out;\n}\n/**\r\n * Generates a random vector with the given scale\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {Number} [scale] Length of the resulting vector. If ommitted, a unit vector will be returned\r\n * @returns {vec4} out\r\n */\n\nexport function random(out, scale) {\n  scale = scale || 1.0; // Marsaglia, George. Choosing a Point from the Surface of a\n  // Sphere. Ann. Math. Statist. 43 (1972), no. 2, 645--646.\n  // http://projecteuclid.org/euclid.aoms/1177692644;\n\n  var v1, v2, v3, v4;\n  var s1, s2;\n\n  do {\n    v1 = glMatrix.RANDOM() * 2 - 1;\n    v2 = glMatrix.RANDOM() * 2 - 1;\n    s1 = v1 * v1 + v2 * v2;\n  } while (s1 >= 1);\n\n  do {\n    v3 = glMatrix.RANDOM() * 2 - 1;\n    v4 = glMatrix.RANDOM() * 2 - 1;\n    s2 = v3 * v3 + v4 * v4;\n  } while (s2 >= 1);\n\n  var d = Math.sqrt((1 - s1) / s2);\n  out[0] = scale * v1;\n  out[1] = scale * v2;\n  out[2] = scale * v3 * d;\n  out[3] = scale * v4 * d;\n  return out;\n}\n/**\r\n * Transforms the vec4 with a mat4.\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a the vector to transform\r\n * @param {ReadonlyMat4} m matrix to transform with\r\n * @returns {vec4} out\r\n */\n\nexport function transformMat4(out, a, m) {\n  var x = a[0],\n      y = a[1],\n      z = a[2],\n      w = a[3];\n  out[0] = m[0] * x + m[4] * y + m[8] * z + m[12] * w;\n  out[1] = m[1] * x + m[5] * y + m[9] * z + m[13] * w;\n  out[2] = m[2] * x + m[6] * y + m[10] * z + m[14] * w;\n  out[3] = m[3] * x + m[7] * y + m[11] * z + m[15] * w;\n  return out;\n}\n/**\r\n * Transforms the vec4 with a quat\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @param {ReadonlyVec4} a the vector to transform\r\n * @param {ReadonlyQuat} q quaternion to transform with\r\n * @returns {vec4} out\r\n */\n\nexport function transformQuat(out, a, q) {\n  var x = a[0],\n      y = a[1],\n      z = a[2];\n  var qx = q[0],\n      qy = q[1],\n      qz = q[2],\n      qw = q[3]; // calculate quat * vec\n\n  var ix = qw * x + qy * z - qz * y;\n  var iy = qw * y + qz * x - qx * z;\n  var iz = qw * z + qx * y - qy * x;\n  var iw = -qx * x - qy * y - qz * z; // calculate result * inverse quat\n\n  out[0] = ix * qw + iw * -qx + iy * -qz - iz * -qy;\n  out[1] = iy * qw + iw * -qy + iz * -qx - ix * -qz;\n  out[2] = iz * qw + iw * -qz + ix * -qy - iy * -qx;\n  out[3] = a[3];\n  return out;\n}\n/**\r\n * Set the components of a vec4 to zero\r\n *\r\n * @param {vec4} out the receiving vector\r\n * @returns {vec4} out\r\n */\n\nexport function zero(out) {\n  out[0] = 0.0;\n  out[1] = 0.0;\n  out[2] = 0.0;\n  out[3] = 0.0;\n  return out;\n}\n/**\r\n * Returns a string representation of a vector\r\n *\r\n * @param {ReadonlyVec4} a vector to represent as a string\r\n * @returns {String} string representation of the vector\r\n */\n\nexport function str(a) {\n  return \"vec4(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \", \" + a[3] + \")\";\n}\n/**\r\n * Returns whether or not the vectors have exactly the same elements in the same position (when compared with ===)\r\n *\r\n * @param {ReadonlyVec4} a The first vector.\r\n * @param {ReadonlyVec4} b The second vector.\r\n * @returns {Boolean} True if the vectors are equal, false otherwise.\r\n */\n\nexport function exactEquals(a, b) {\n  return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3];\n}\n/**\r\n * Returns whether or not the vectors have approximately the same elements in the same position.\r\n *\r\n * @param {ReadonlyVec4} a The first vector.\r\n * @param {ReadonlyVec4} b The second vector.\r\n * @returns {Boolean} True if the vectors are equal, false otherwise.\r\n */\n\nexport function equals(a, b) {\n  var a0 = a[0],\n      a1 = a[1],\n      a2 = a[2],\n      a3 = a[3];\n  var b0 = b[0],\n      b1 = b[1],\n      b2 = b[2],\n      b3 = b[3];\n  return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3));\n}\n/**\r\n * Alias for {@link vec4.subtract}\r\n * @function\r\n */\n\nexport var sub = subtract;\n/**\r\n * Alias for {@link vec4.multiply}\r\n * @function\r\n */\n\nexport var mul = multiply;\n/**\r\n * Alias for {@link vec4.divide}\r\n * @function\r\n */\n\nexport var div = divide;\n/**\r\n * Alias for {@link vec4.distance}\r\n * @function\r\n */\n\nexport var dist = distance;\n/**\r\n * Alias for {@link vec4.squaredDistance}\r\n * @function\r\n */\n\nexport var sqrDist = squaredDistance;\n/**\r\n * Alias for {@link vec4.length}\r\n * @function\r\n */\n\nexport var len = length;\n/**\r\n * Alias for {@link vec4.squaredLength}\r\n * @function\r\n */\n\nexport var sqrLen = squaredLength;\n/**\r\n * Perform some operation over an array of vec4s.\r\n *\r\n * @param {Array} a the array of vectors to iterate over\r\n * @param {Number} stride Number of elements between the start of each vec4. If 0 assumes tightly packed\r\n * @param {Number} offset Number of elements to skip at the beginning of the array\r\n * @param {Number} count Number of vec4s to iterate over. If 0 iterates over entire array\r\n * @param {Function} fn Function to call for each vector in the array\r\n * @param {Object} [arg] additional argument to pass to fn\r\n * @returns {Array} a\r\n * @function\r\n */\n\nexport var forEach = function () {\n  var vec = create();\n  return function (a, stride, offset, count, fn, arg) {\n    var i, l;\n\n    if (!stride) {\n      stride = 4;\n    }\n\n    if (!offset) {\n      offset = 0;\n    }\n\n    if (count) {\n      l = Math.min(count * stride + offset, a.length);\n    } else {\n      l = a.length;\n    }\n\n    for (i = offset; i < l; i += stride) {\n      vec[0] = a[i];\n      vec[1] = a[i + 1];\n      vec[2] = a[i + 2];\n      vec[3] = a[i + 3];\n      fn(vec, vec, arg);\n      a[i] = vec[0];\n      a[i + 1] = vec[1];\n      a[i + 2] = vec[2];\n      a[i + 3] = vec[3];\n    }\n\n    return a;\n  };\n}();","import { getFetchFunction } from './option-utils';\nexport function getLoaderContext(context, options, previousContext = null) {\n  if (previousContext) {\n    return previousContext;\n  }\n\n  const resolvedContext = {\n    fetch: getFetchFunction(options, context),\n    ...context\n  };\n\n  if (!Array.isArray(resolvedContext.loaders)) {\n    resolvedContext.loaders = null;\n  }\n\n  return resolvedContext;\n}\nexport function getLoadersFromContext(loaders, context) {\n  if (!context && loaders && !Array.isArray(loaders)) {\n    return loaders;\n  }\n\n  let candidateLoaders;\n\n  if (loaders) {\n    candidateLoaders = Array.isArray(loaders) ? loaders : [loaders];\n  }\n\n  if (context && context.loaders) {\n    const contextLoaders = Array.isArray(context.loaders) ? context.loaders : [context.loaders];\n    candidateLoaders = candidateLoaders ? [...candidateLoaders, ...contextLoaders] : contextLoaders;\n  }\n\n  return candidateLoaders && candidateLoaders.length ? candidateLoaders : null;\n}\n//# sourceMappingURL=loader-context.js.map","import * as glMatrix from \"./common.js\";\n/**\r\n * 2 Dimensional Vector\r\n * @module vec2\r\n */\n\n/**\r\n * Creates a new, empty vec2\r\n *\r\n * @returns {vec2} a new 2D vector\r\n */\n\nexport function create() {\n  var out = new glMatrix.ARRAY_TYPE(2);\n\n  if (glMatrix.ARRAY_TYPE != Float32Array) {\n    out[0] = 0;\n    out[1] = 0;\n  }\n\n  return out;\n}\n/**\r\n * Creates a new vec2 initialized with values from an existing vector\r\n *\r\n * @param {ReadonlyVec2} a vector to clone\r\n * @returns {vec2} a new 2D vector\r\n */\n\nexport function clone(a) {\n  var out = new glMatrix.ARRAY_TYPE(2);\n  out[0] = a[0];\n  out[1] = a[1];\n  return out;\n}\n/**\r\n * Creates a new vec2 initialized with the given values\r\n *\r\n * @param {Number} x X component\r\n * @param {Number} y Y component\r\n * @returns {vec2} a new 2D vector\r\n */\n\nexport function fromValues(x, y) {\n  var out = new glMatrix.ARRAY_TYPE(2);\n  out[0] = x;\n  out[1] = y;\n  return out;\n}\n/**\r\n * Copy the values from one vec2 to another\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the source vector\r\n * @returns {vec2} out\r\n */\n\nexport function copy(out, a) {\n  out[0] = a[0];\n  out[1] = a[1];\n  return out;\n}\n/**\r\n * Set the components of a vec2 to the given values\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {Number} x X component\r\n * @param {Number} y Y component\r\n * @returns {vec2} out\r\n */\n\nexport function set(out, x, y) {\n  out[0] = x;\n  out[1] = y;\n  return out;\n}\n/**\r\n * Adds two vec2's\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the first operand\r\n * @param {ReadonlyVec2} b the second operand\r\n * @returns {vec2} out\r\n */\n\nexport function add(out, a, b) {\n  out[0] = a[0] + b[0];\n  out[1] = a[1] + b[1];\n  return out;\n}\n/**\r\n * Subtracts vector b from vector a\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the first operand\r\n * @param {ReadonlyVec2} b the second operand\r\n * @returns {vec2} out\r\n */\n\nexport function subtract(out, a, b) {\n  out[0] = a[0] - b[0];\n  out[1] = a[1] - b[1];\n  return out;\n}\n/**\r\n * Multiplies two vec2's\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the first operand\r\n * @param {ReadonlyVec2} b the second operand\r\n * @returns {vec2} out\r\n */\n\nexport function multiply(out, a, b) {\n  out[0] = a[0] * b[0];\n  out[1] = a[1] * b[1];\n  return out;\n}\n/**\r\n * Divides two vec2's\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the first operand\r\n * @param {ReadonlyVec2} b the second operand\r\n * @returns {vec2} out\r\n */\n\nexport function divide(out, a, b) {\n  out[0] = a[0] / b[0];\n  out[1] = a[1] / b[1];\n  return out;\n}\n/**\r\n * Math.ceil the components of a vec2\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a vector to ceil\r\n * @returns {vec2} out\r\n */\n\nexport function ceil(out, a) {\n  out[0] = Math.ceil(a[0]);\n  out[1] = Math.ceil(a[1]);\n  return out;\n}\n/**\r\n * Math.floor the components of a vec2\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a vector to floor\r\n * @returns {vec2} out\r\n */\n\nexport function floor(out, a) {\n  out[0] = Math.floor(a[0]);\n  out[1] = Math.floor(a[1]);\n  return out;\n}\n/**\r\n * Returns the minimum of two vec2's\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the first operand\r\n * @param {ReadonlyVec2} b the second operand\r\n * @returns {vec2} out\r\n */\n\nexport function min(out, a, b) {\n  out[0] = Math.min(a[0], b[0]);\n  out[1] = Math.min(a[1], b[1]);\n  return out;\n}\n/**\r\n * Returns the maximum of two vec2's\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the first operand\r\n * @param {ReadonlyVec2} b the second operand\r\n * @returns {vec2} out\r\n */\n\nexport function max(out, a, b) {\n  out[0] = Math.max(a[0], b[0]);\n  out[1] = Math.max(a[1], b[1]);\n  return out;\n}\n/**\r\n * Math.round the components of a vec2\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a vector to round\r\n * @returns {vec2} out\r\n */\n\nexport function round(out, a) {\n  out[0] = Math.round(a[0]);\n  out[1] = Math.round(a[1]);\n  return out;\n}\n/**\r\n * Scales a vec2 by a scalar number\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the vector to scale\r\n * @param {Number} b amount to scale the vector by\r\n * @returns {vec2} out\r\n */\n\nexport function scale(out, a, b) {\n  out[0] = a[0] * b;\n  out[1] = a[1] * b;\n  return out;\n}\n/**\r\n * Adds two vec2's after scaling the second operand by a scalar value\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the first operand\r\n * @param {ReadonlyVec2} b the second operand\r\n * @param {Number} scale the amount to scale b by before adding\r\n * @returns {vec2} out\r\n */\n\nexport function scaleAndAdd(out, a, b, scale) {\n  out[0] = a[0] + b[0] * scale;\n  out[1] = a[1] + b[1] * scale;\n  return out;\n}\n/**\r\n * Calculates the euclidian distance between two vec2's\r\n *\r\n * @param {ReadonlyVec2} a the first operand\r\n * @param {ReadonlyVec2} b the second operand\r\n * @returns {Number} distance between a and b\r\n */\n\nexport function distance(a, b) {\n  var x = b[0] - a[0],\n      y = b[1] - a[1];\n  return Math.hypot(x, y);\n}\n/**\r\n * Calculates the squared euclidian distance between two vec2's\r\n *\r\n * @param {ReadonlyVec2} a the first operand\r\n * @param {ReadonlyVec2} b the second operand\r\n * @returns {Number} squared distance between a and b\r\n */\n\nexport function squaredDistance(a, b) {\n  var x = b[0] - a[0],\n      y = b[1] - a[1];\n  return x * x + y * y;\n}\n/**\r\n * Calculates the length of a vec2\r\n *\r\n * @param {ReadonlyVec2} a vector to calculate length of\r\n * @returns {Number} length of a\r\n */\n\nexport function length(a) {\n  var x = a[0],\n      y = a[1];\n  return Math.hypot(x, y);\n}\n/**\r\n * Calculates the squared length of a vec2\r\n *\r\n * @param {ReadonlyVec2} a vector to calculate squared length of\r\n * @returns {Number} squared length of a\r\n */\n\nexport function squaredLength(a) {\n  var x = a[0],\n      y = a[1];\n  return x * x + y * y;\n}\n/**\r\n * Negates the components of a vec2\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a vector to negate\r\n * @returns {vec2} out\r\n */\n\nexport function negate(out, a) {\n  out[0] = -a[0];\n  out[1] = -a[1];\n  return out;\n}\n/**\r\n * Returns the inverse of the components of a vec2\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a vector to invert\r\n * @returns {vec2} out\r\n */\n\nexport function inverse(out, a) {\n  out[0] = 1.0 / a[0];\n  out[1] = 1.0 / a[1];\n  return out;\n}\n/**\r\n * Normalize a vec2\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a vector to normalize\r\n * @returns {vec2} out\r\n */\n\nexport function normalize(out, a) {\n  var x = a[0],\n      y = a[1];\n  var len = x * x + y * y;\n\n  if (len > 0) {\n    //TODO: evaluate use of glm_invsqrt here?\n    len = 1 / Math.sqrt(len);\n  }\n\n  out[0] = a[0] * len;\n  out[1] = a[1] * len;\n  return out;\n}\n/**\r\n * Calculates the dot product of two vec2's\r\n *\r\n * @param {ReadonlyVec2} a the first operand\r\n * @param {ReadonlyVec2} b the second operand\r\n * @returns {Number} dot product of a and b\r\n */\n\nexport function dot(a, b) {\n  return a[0] * b[0] + a[1] * b[1];\n}\n/**\r\n * Computes the cross product of two vec2's\r\n * Note that the cross product must by definition produce a 3D vector\r\n *\r\n * @param {vec3} out the receiving vector\r\n * @param {ReadonlyVec2} a the first operand\r\n * @param {ReadonlyVec2} b the second operand\r\n * @returns {vec3} out\r\n */\n\nexport function cross(out, a, b) {\n  var z = a[0] * b[1] - a[1] * b[0];\n  out[0] = out[1] = 0;\n  out[2] = z;\n  return out;\n}\n/**\r\n * Performs a linear interpolation between two vec2's\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the first operand\r\n * @param {ReadonlyVec2} b the second operand\r\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\r\n * @returns {vec2} out\r\n */\n\nexport function lerp(out, a, b, t) {\n  var ax = a[0],\n      ay = a[1];\n  out[0] = ax + t * (b[0] - ax);\n  out[1] = ay + t * (b[1] - ay);\n  return out;\n}\n/**\r\n * Generates a random vector with the given scale\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {Number} [scale] Length of the resulting vector. If ommitted, a unit vector will be returned\r\n * @returns {vec2} out\r\n */\n\nexport function random(out, scale) {\n  scale = scale || 1.0;\n  var r = glMatrix.RANDOM() * 2.0 * Math.PI;\n  out[0] = Math.cos(r) * scale;\n  out[1] = Math.sin(r) * scale;\n  return out;\n}\n/**\r\n * Transforms the vec2 with a mat2\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the vector to transform\r\n * @param {ReadonlyMat2} m matrix to transform with\r\n * @returns {vec2} out\r\n */\n\nexport function transformMat2(out, a, m) {\n  var x = a[0],\n      y = a[1];\n  out[0] = m[0] * x + m[2] * y;\n  out[1] = m[1] * x + m[3] * y;\n  return out;\n}\n/**\r\n * Transforms the vec2 with a mat2d\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the vector to transform\r\n * @param {ReadonlyMat2d} m matrix to transform with\r\n * @returns {vec2} out\r\n */\n\nexport function transformMat2d(out, a, m) {\n  var x = a[0],\n      y = a[1];\n  out[0] = m[0] * x + m[2] * y + m[4];\n  out[1] = m[1] * x + m[3] * y + m[5];\n  return out;\n}\n/**\r\n * Transforms the vec2 with a mat3\r\n * 3rd vector component is implicitly '1'\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the vector to transform\r\n * @param {ReadonlyMat3} m matrix to transform with\r\n * @returns {vec2} out\r\n */\n\nexport function transformMat3(out, a, m) {\n  var x = a[0],\n      y = a[1];\n  out[0] = m[0] * x + m[3] * y + m[6];\n  out[1] = m[1] * x + m[4] * y + m[7];\n  return out;\n}\n/**\r\n * Transforms the vec2 with a mat4\r\n * 3rd vector component is implicitly '0'\r\n * 4th vector component is implicitly '1'\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @param {ReadonlyVec2} a the vector to transform\r\n * @param {ReadonlyMat4} m matrix to transform with\r\n * @returns {vec2} out\r\n */\n\nexport function transformMat4(out, a, m) {\n  var x = a[0];\n  var y = a[1];\n  out[0] = m[0] * x + m[4] * y + m[12];\n  out[1] = m[1] * x + m[5] * y + m[13];\n  return out;\n}\n/**\r\n * Rotate a 2D vector\r\n * @param {vec2} out The receiving vec2\r\n * @param {ReadonlyVec2} a The vec2 point to rotate\r\n * @param {ReadonlyVec2} b The origin of the rotation\r\n * @param {Number} rad The angle of rotation in radians\r\n * @returns {vec2} out\r\n */\n\nexport function rotate(out, a, b, rad) {\n  //Translate point to the origin\n  var p0 = a[0] - b[0],\n      p1 = a[1] - b[1],\n      sinC = Math.sin(rad),\n      cosC = Math.cos(rad); //perform rotation and translate to correct position\n\n  out[0] = p0 * cosC - p1 * sinC + b[0];\n  out[1] = p0 * sinC + p1 * cosC + b[1];\n  return out;\n}\n/**\r\n * Get the angle between two 2D vectors\r\n * @param {ReadonlyVec2} a The first operand\r\n * @param {ReadonlyVec2} b The second operand\r\n * @returns {Number} The angle in radians\r\n */\n\nexport function angle(a, b) {\n  var x1 = a[0],\n      y1 = a[1],\n      x2 = b[0],\n      y2 = b[1],\n      // mag is the product of the magnitudes of a and b\n  mag = Math.sqrt(x1 * x1 + y1 * y1) * Math.sqrt(x2 * x2 + y2 * y2),\n      // mag &&.. short circuits if mag == 0\n  cosine = mag && (x1 * x2 + y1 * y2) / mag; // Math.min(Math.max(cosine, -1), 1) clamps the cosine between -1 and 1\n\n  return Math.acos(Math.min(Math.max(cosine, -1), 1));\n}\n/**\r\n * Set the components of a vec2 to zero\r\n *\r\n * @param {vec2} out the receiving vector\r\n * @returns {vec2} out\r\n */\n\nexport function zero(out) {\n  out[0] = 0.0;\n  out[1] = 0.0;\n  return out;\n}\n/**\r\n * Returns a string representation of a vector\r\n *\r\n * @param {ReadonlyVec2} a vector to represent as a string\r\n * @returns {String} string representation of the vector\r\n */\n\nexport function str(a) {\n  return \"vec2(\" + a[0] + \", \" + a[1] + \")\";\n}\n/**\r\n * Returns whether or not the vectors exactly have the same elements in the same position (when compared with ===)\r\n *\r\n * @param {ReadonlyVec2} a The first vector.\r\n * @param {ReadonlyVec2} b The second vector.\r\n * @returns {Boolean} True if the vectors are equal, false otherwise.\r\n */\n\nexport function exactEquals(a, b) {\n  return a[0] === b[0] && a[1] === b[1];\n}\n/**\r\n * Returns whether or not the vectors have approximately the same elements in the same position.\r\n *\r\n * @param {ReadonlyVec2} a The first vector.\r\n * @param {ReadonlyVec2} b The second vector.\r\n * @returns {Boolean} True if the vectors are equal, false otherwise.\r\n */\n\nexport function equals(a, b) {\n  var a0 = a[0],\n      a1 = a[1];\n  var b0 = b[0],\n      b1 = b[1];\n  return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1));\n}\n/**\r\n * Alias for {@link vec2.length}\r\n * @function\r\n */\n\nexport var len = length;\n/**\r\n * Alias for {@link vec2.subtract}\r\n * @function\r\n */\n\nexport var sub = subtract;\n/**\r\n * Alias for {@link vec2.multiply}\r\n * @function\r\n */\n\nexport var mul = multiply;\n/**\r\n * Alias for {@link vec2.divide}\r\n * @function\r\n */\n\nexport var div = divide;\n/**\r\n * Alias for {@link vec2.distance}\r\n * @function\r\n */\n\nexport var dist = distance;\n/**\r\n * Alias for {@link vec2.squaredDistance}\r\n * @function\r\n */\n\nexport var sqrDist = squaredDistance;\n/**\r\n * Alias for {@link vec2.squaredLength}\r\n * @function\r\n */\n\nexport var sqrLen = squaredLength;\n/**\r\n * Perform some operation over an array of vec2s.\r\n *\r\n * @param {Array} a the array of vectors to iterate over\r\n * @param {Number} stride Number of elements between the start of each vec2. If 0 assumes tightly packed\r\n * @param {Number} offset Number of elements to skip at the beginning of the array\r\n * @param {Number} count Number of vec2s to iterate over. If 0 iterates over entire array\r\n * @param {Function} fn Function to call for each vector in the array\r\n * @param {Object} [arg] additional argument to pass to fn\r\n * @returns {Array} a\r\n * @function\r\n */\n\nexport var forEach = function () {\n  var vec = create();\n  return function (a, stride, offset, count, fn, arg) {\n    var i, l;\n\n    if (!stride) {\n      stride = 2;\n    }\n\n    if (!offset) {\n      offset = 0;\n    }\n\n    if (count) {\n      l = Math.min(count * stride + offset, a.length);\n    } else {\n      l = a.length;\n    }\n\n    for (i = offset; i < l; i += stride) {\n      vec[0] = a[i];\n      vec[1] = a[i + 1];\n      fn(vec, vec, arg);\n      a[i] = vec[0];\n      a[i + 1] = vec[1];\n    }\n\n    return a;\n  };\n}();","const globals = {\n  self: typeof self !== 'undefined' && self,\n  window: typeof window !== 'undefined' && window,\n  global: typeof global !== 'undefined' && global,\n  document: typeof document !== 'undefined' && document,\n  process: typeof process === 'object' && process\n};\nconst global_ = globalThis;\nconst self_ = globals.self || globals.window || globals.global;\nconst window_ = globals.window || globals.self || globals.global;\nconst document_ = globals.document || {};\nconst process_ = globals.process || {};\nconst console_ = console;\nexport { self_ as self, window_ as window, global_ as global, document_ as document, process_ as process, console_ as console };\n//# sourceMappingURL=globals.js.map","const globals = {\n  self: typeof self !== 'undefined' && self,\n  window: typeof window !== 'undefined' && window,\n  global: typeof global !== 'undefined' && global,\n  document: typeof document !== 'undefined' && document,\n  process: typeof process === 'object' && process\n};\nconst self_ = globals.self || globals.window || globals.global;\nconst window_ = globals.window || globals.self || globals.global;\nconst global_ = globals.global || globals.self || globals.window;\nconst document_ = globals.document || {};\nconst process_ = globals.process || {};\nconst console_ = console;\nexport { self_ as self, window_ as window, global_ as global, document_ as document, process_ as process, console_ as console };\n//# sourceMappingURL=globals.js.map","const globals = {\n  self: typeof self !== 'undefined' && self,\n  window: typeof window !== 'undefined' && window,\n  global: typeof global !== 'undefined' && global,\n  document: typeof document !== 'undefined' && document,\n  process: typeof process === 'object' && process\n};\nconst global_ = globalThis;\nconst self_ = globals.self || globals.window || globals.global;\nconst window_ = globals.window || globals.self || globals.global;\nconst document_ = globals.document || {};\nconst process_ = globals.process || {};\nconst console_ = console;\nexport { self_ as self, window_ as window, global_ as global, document_ as document, process_ as process, console_ as console };\n//# sourceMappingURL=globals.js.map","let pathPrefix = '';\nconst fileAliases = {};\nexport function setPathPrefix(prefix) {\n  pathPrefix = prefix;\n}\nexport function getPathPrefix() {\n  return pathPrefix;\n}\nexport function addAliases(aliases) {\n  Object.assign(fileAliases, aliases);\n}\nexport function resolvePath(filename) {\n  for (const alias in fileAliases) {\n    if (filename.startsWith(alias)) {\n      const replacement = fileAliases[alias];\n      filename = filename.replace(alias, replacement);\n    }\n  }\n\n  if (!filename.startsWith('http://') && !filename.startsWith('https://')) {\n    filename = \"\".concat(pathPrefix).concat(filename);\n  }\n\n  return filename;\n}\n//# sourceMappingURL=file-aliases.js.map","import * as node from '../node/buffer';\nexport function isBuffer(value) {\n  return value && typeof value === 'object' && value.isBuffer;\n}\nexport function toBuffer(data) {\n  return node.toBuffer ? node.toBuffer(data) : data;\n}\nexport function bufferToArrayBuffer(buffer) {\n  if (isBuffer(buffer)) {\n    const typedArray = new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.length);\n    return typedArray.slice().buffer;\n  }\n\n  return buffer;\n}\n//# sourceMappingURL=buffer-utils.js.map","import {Vector3} from '@math.gl/core';\nimport type Layer from '../../lib/layer';\n\nconst DEFAULT_LIGHT_COLOR = [255, 255, 255];\nconst DEFAULT_LIGHT_INTENSITY = 1.0;\nconst DEFAULT_LIGHT_DIRECTION = [0.0, 0.0, -1.0];\n\nlet idCount = 0;\n\nexport type DirectionalLightOptions = {\n  id?: string;\n  /** Light color, [r, g, b] in the 0-255 range\n   * @default [255, 255, 255]\n   */\n  color?: number[];\n  /** Light intensity, higher number is brighter\n   * @default 1.0\n   */\n  intensity?: number;\n  /** Light direction in the common space\n   * @default [0.0, 0.0, -1.0]\n   */\n  direction?: number[];\n  /** (Experimental) render shadows cast by this light\n   * @default false\n   */\n  _shadow?: boolean;\n};\n\nexport class DirectionalLight {\n  id: string;\n  color: number[];\n  intensity: number;\n  type = 'directional';\n  direction: number[];\n  shadow: boolean;\n\n  constructor(props: DirectionalLightOptions = {}) {\n    const {color = DEFAULT_LIGHT_COLOR} = props;\n    const {intensity = DEFAULT_LIGHT_INTENSITY} = props;\n    const {direction = DEFAULT_LIGHT_DIRECTION} = props;\n    const {_shadow = false} = props;\n\n    this.id = props.id || `directional-${idCount++}`;\n    this.color = color;\n    this.intensity = intensity;\n    this.type = 'directional';\n    this.direction = new Vector3(direction).normalize().toArray() as [number, number, number];\n    this.shadow = _shadow;\n  }\n\n  getProjectedLight(opts: {layer: Layer}): DirectionalLight {\n    return this;\n  }\n}\n","import { resolvePath } from '@loaders.gl/loader-utils';\nimport { makeResponse } from '../utils/response-utils';\nexport async function fetchFile(url, options) {\n  if (typeof url === 'string') {\n    url = resolvePath(url);\n    let fetchOptions = options;\n\n    if (options !== null && options !== void 0 && options.fetch && typeof (options === null || options === void 0 ? void 0 : options.fetch) !== 'function') {\n      fetchOptions = options.fetch;\n    }\n\n    return await fetch(url, fetchOptions);\n  }\n\n  return await makeResponse(url);\n}\n//# sourceMappingURL=fetch-file.js.map","const fp32shader = \"#ifdef LUMA_FP32_TAN_PRECISION_WORKAROUND\\nconst float TWO_PI = 6.2831854820251465;\\nconst float PI_2 = 1.5707963705062866;\\nconst float PI_16 = 0.1963495463132858;\\n\\nconst float SIN_TABLE_0 = 0.19509032368659973;\\nconst float SIN_TABLE_1 = 0.3826834261417389;\\nconst float SIN_TABLE_2 = 0.5555702447891235;\\nconst float SIN_TABLE_3 = 0.7071067690849304;\\n\\nconst float COS_TABLE_0 = 0.9807852506637573;\\nconst float COS_TABLE_1 = 0.9238795042037964;\\nconst float COS_TABLE_2 = 0.8314695954322815;\\nconst float COS_TABLE_3 = 0.7071067690849304;\\n\\nconst float INVERSE_FACTORIAL_3 = 1.666666716337204e-01;\\nconst float INVERSE_FACTORIAL_5 = 8.333333767950535e-03;\\nconst float INVERSE_FACTORIAL_7 = 1.9841270113829523e-04;\\nconst float INVERSE_FACTORIAL_9 = 2.75573188446287533e-06;\\n\\nfloat sin_taylor_fp32(float a) {\\n  float r, s, t, x;\\n\\n  if (a == 0.0) {\\n    return 0.0;\\n  }\\n\\n  x = -a * a;\\n  s = a;\\n  r = a;\\n\\n  r = r * x;\\n  t = r * INVERSE_FACTORIAL_3;\\n  s = s + t;\\n\\n  r = r * x;\\n  t = r * INVERSE_FACTORIAL_5;\\n  s = s + t;\\n\\n  r = r * x;\\n  t = r * INVERSE_FACTORIAL_7;\\n  s = s + t;\\n\\n  r = r * x;\\n  t = r * INVERSE_FACTORIAL_9;\\n  s = s + t;\\n\\n  return s;\\n}\\n\\nvoid sincos_taylor_fp32(float a, out float sin_t, out float cos_t) {\\n  if (a == 0.0) {\\n    sin_t = 0.0;\\n    cos_t = 1.0;\\n  }\\n  sin_t = sin_taylor_fp32(a);\\n  cos_t = sqrt(1.0 - sin_t * sin_t);\\n}\\n\\nfloat tan_taylor_fp32(float a) {\\n    float sin_a;\\n    float cos_a;\\n\\n    if (a == 0.0) {\\n        return 0.0;\\n    }\\n    float z = floor(a / TWO_PI);\\n    float r = a - TWO_PI * z;\\n\\n    float t;\\n    float q = floor(r / PI_2 + 0.5);\\n    int j = int(q);\\n\\n    if (j < -2 || j > 2) {\\n        return 1.0 / 0.0;\\n    }\\n\\n    t = r - PI_2 * q;\\n\\n    q = floor(t / PI_16 + 0.5);\\n    int k = int(q);\\n    int abs_k = int(abs(float(k)));\\n\\n    if (abs_k > 4) {\\n        return 1.0 / 0.0;\\n    } else {\\n        t = t - PI_16 * q;\\n    }\\n\\n    float u = 0.0;\\n    float v = 0.0;\\n\\n    float sin_t, cos_t;\\n    float s, c;\\n    sincos_taylor_fp32(t, sin_t, cos_t);\\n\\n    if (k == 0) {\\n        s = sin_t;\\n        c = cos_t;\\n    } else {\\n        if (abs(float(abs_k) - 1.0) < 0.5) {\\n            u = COS_TABLE_0;\\n            v = SIN_TABLE_0;\\n        } else if (abs(float(abs_k) - 2.0) < 0.5) {\\n            u = COS_TABLE_1;\\n            v = SIN_TABLE_1;\\n        } else if (abs(float(abs_k) - 3.0) < 0.5) {\\n            u = COS_TABLE_2;\\n            v = SIN_TABLE_2;\\n        } else if (abs(float(abs_k) - 4.0) < 0.5) {\\n            u = COS_TABLE_3;\\n            v = SIN_TABLE_3;\\n        }\\n        if (k > 0) {\\n            s = u * sin_t + v * cos_t;\\n            c = u * cos_t - v * sin_t;\\n        } else {\\n            s = u * sin_t - v * cos_t;\\n            c = u * cos_t + v * sin_t;\\n        }\\n    }\\n\\n    if (j == 0) {\\n        sin_a = s;\\n        cos_a = c;\\n    } else if (j == 1) {\\n        sin_a = c;\\n        cos_a = -s;\\n    } else if (j == -1) {\\n        sin_a = -c;\\n        cos_a = s;\\n    } else {\\n        sin_a = -s;\\n        cos_a = -c;\\n    }\\n    return sin_a / cos_a;\\n}\\n#endif\\n\\nfloat tan_fp32(float a) {\\n#ifdef LUMA_FP32_TAN_PRECISION_WORKAROUND\\n  return tan_taylor_fp32(a);\\n#else\\n  return tan(a);\\n#endif\\n}\\n\";\nexport const fp32 = {\n  name: 'fp32',\n  vs: fp32shader,\n  fs: null\n};\n//# sourceMappingURL=fp32.js.map","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\nimport type {ShaderModule} from '../../types/types';\n\nconst defines = '#define SMOOTH_EDGE_RADIUS 0.5';\nconst vs = `\n${defines}\n\nstruct VertexGeometry {\n  vec4 position;\n  vec3 worldPosition;\n  vec3 worldPositionAlt;\n  vec3 normal;\n  vec2 uv;\n  vec3 pickingColor;\n} geometry = VertexGeometry(\n  vec4(0.0, 0.0, 1.0, 0.0),\n  vec3(0.0),\n  vec3(0.0),\n  vec3(0.0),\n  vec2(0.0),\n  vec3(0.0)\n);\n`;\n\nconst fs = `\n${defines}\n\nstruct FragmentGeometry {\n  vec2 uv;\n} geometry;\n\nfloat smoothedge(float edge, float x) {\n  return smoothstep(edge - SMOOTH_EDGE_RADIUS, edge + SMOOTH_EDGE_RADIUS, x);\n}\n`;\n\nexport default {name: 'geometry', vs, fs} as ShaderModule;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {COORDINATE_SYSTEM, PROJECTION_MODE, UNIT} from '../../lib/constants';\n\n// We are generating these from the js code in constants.js\nconst COORDINATE_SYSTEM_GLSL_CONSTANTS = Object.keys(COORDINATE_SYSTEM)\n  .map(key => `const int COORDINATE_SYSTEM_${key} = ${COORDINATE_SYSTEM[key]};`)\n  .join('');\nconst PROJECTION_MODE_GLSL_CONSTANTS = Object.keys(PROJECTION_MODE)\n  .map(key => `const int PROJECTION_MODE_${key} = ${PROJECTION_MODE[key]};`)\n  .join('');\nconst UNIT_GLSL_CONSTANTS = Object.keys(UNIT)\n  .map(key => `const int UNIT_${key.toUpperCase()} = ${UNIT[key]};`)\n  .join('');\n\nexport default `\\\n${COORDINATE_SYSTEM_GLSL_CONSTANTS}\n${PROJECTION_MODE_GLSL_CONSTANTS}\n${UNIT_GLSL_CONSTANTS}\n\nuniform int project_uCoordinateSystem;\nuniform int project_uProjectionMode;\nuniform float project_uScale;\nuniform bool project_uWrapLongitude;\nuniform vec3 project_uCommonUnitsPerMeter;\nuniform vec3 project_uCommonUnitsPerWorldUnit;\nuniform vec3 project_uCommonUnitsPerWorldUnit2;\nuniform vec4 project_uCenter;\nuniform mat4 project_uModelMatrix;\nuniform mat4 project_uViewProjectionMatrix;\nuniform vec2 project_uViewportSize;\nuniform float project_uDevicePixelRatio;\nuniform float project_uFocalDistance;\nuniform vec3 project_uCameraPosition;\nuniform vec3 project_uCoordinateOrigin;\nuniform vec3 project_uCommonOrigin;\nuniform bool project_uPseudoMeters;\n\nconst float TILE_SIZE = 512.0;\nconst float PI = 3.1415926536;\nconst float WORLD_SCALE = TILE_SIZE / (PI * 2.0);\nconst vec3 ZERO_64_LOW = vec3(0.0);\nconst float EARTH_RADIUS = 6370972.0; // meters\nconst float GLOBE_RADIUS = 256.0;\n\n// returns an adjustment factor for uCommonUnitsPerMeter\nfloat project_size_at_latitude(float lat) {\n  float y = clamp(lat, -89.9, 89.9);\n  return 1.0 / cos(radians(y));\n}\n\nfloat project_size() {\n  if (project_uProjectionMode == PROJECTION_MODE_WEB_MERCATOR &&\n    project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT &&\n    project_uPseudoMeters == false) {\n\n    // uCommonUnitsPerMeter in low-zoom Web Mercator is non-linear\n    // Adjust by 1 / cos(latitude)\n    // If geometry.position (vertex in common space) is populated, use it\n    // Otherwise use geometry.worldPosition (anchor in world space)\n    \n    if (geometry.position.w == 0.0) {\n      return project_size_at_latitude(geometry.worldPosition.y);\n    }\n\n    // latitude from common y: 2.0 * (atan(exp(y / TILE_SIZE * 2.0 * PI - PI)) - PI / 4.0)\n    // Taylor series of 1 / cos(latitude)\n    // Max error < 0.003\n  \n    float y = geometry.position.y / TILE_SIZE * 2.0 - 1.0;\n    float y2 = y * y;\n    float y4 = y2 * y2;\n    float y6 = y4 * y2;\n    return 1.0 + 4.9348 * y2 + 4.0587 * y4 + 1.5642 * y6;\n  }\n  return 1.0;\n}\n\nfloat project_size_at_latitude(float meters, float lat) {\n  return meters * project_uCommonUnitsPerMeter.z * project_size_at_latitude(lat);\n}\n\n//\n// Scaling offsets - scales meters to \"world distance\"\n// Note the scalar version of project_size is for scaling the z component only\n//\nfloat project_size(float meters) {\n  return meters * project_uCommonUnitsPerMeter.z * project_size();\n}\n\nvec2 project_size(vec2 meters) {\n  return meters * project_uCommonUnitsPerMeter.xy * project_size();\n}\n\nvec3 project_size(vec3 meters) {\n  return meters * project_uCommonUnitsPerMeter * project_size();\n}\n\nvec4 project_size(vec4 meters) {\n  return vec4(meters.xyz * project_uCommonUnitsPerMeter, meters.w);\n}\n\n// Get rotation matrix that aligns the z axis with the given up vector\n// Find 3 unit vectors ux, uy, uz that are perpendicular to each other and uz == up\nmat3 project_get_orientation_matrix(vec3 up) {\n  vec3 uz = normalize(up);\n  // Tangent on XY plane\n  vec3 ux = abs(uz.z) == 1.0 ? vec3(1.0, 0.0, 0.0) : normalize(vec3(uz.y, -uz.x, 0));\n  vec3 uy = cross(uz, ux);\n  return mat3(ux, uy, uz);\n}\n\nbool project_needs_rotation(vec3 commonPosition, out mat3 transform) {\n  if (project_uProjectionMode == PROJECTION_MODE_GLOBE) {\n    transform = project_get_orientation_matrix(commonPosition);\n    return true;\n  }\n  return false;\n}\n\n//\n// Projecting normal - transform deltas from current coordinate system to\n// normals in the worldspace\n//\nvec3 project_normal(vec3 vector) {\n  // Apply model matrix\n  vec4 normal_modelspace = project_uModelMatrix * vec4(vector, 0.0);\n  vec3 n = normalize(normal_modelspace.xyz * project_uCommonUnitsPerMeter);\n  mat3 rotation;\n  if (project_needs_rotation(geometry.position.xyz, rotation)) {\n    n = rotation * n;\n  }\n  return n;\n}\n\nvec4 project_offset_(vec4 offset) {\n  float dy = offset.y;\n  vec3 commonUnitsPerWorldUnit = project_uCommonUnitsPerWorldUnit + project_uCommonUnitsPerWorldUnit2 * dy;\n  return vec4(offset.xyz * commonUnitsPerWorldUnit, offset.w);\n}\n\n//\n// Projecting positions - non-linear projection: lnglats => unit tile [0-1, 0-1]\n//\nvec2 project_mercator_(vec2 lnglat) {\n  float x = lnglat.x;\n  if (project_uWrapLongitude) {\n    x = mod(x + 180., 360.0) - 180.;\n  }\n  float y = clamp(lnglat.y, -89.9, 89.9);\n  return vec2(\n    radians(x) + PI,\n    PI + log(tan_fp32(PI * 0.25 + radians(y) * 0.5))\n  ) * WORLD_SCALE;\n}\n\nvec3 project_globe_(vec3 lnglatz) {\n  float lambda = radians(lnglatz.x);\n  float phi = radians(lnglatz.y);\n  float cosPhi = cos(phi);\n  float D = (lnglatz.z / EARTH_RADIUS + 1.0) * GLOBE_RADIUS;\n\n  return vec3(\n    sin(lambda) * cosPhi,\n    -cos(lambda) * cosPhi,\n    sin(phi)\n  ) * D;\n}\n\n//\n// Projects positions (defined by project_uCoordinateSystem) to common space (defined by project_uProjectionMode)\n//\nvec4 project_position(vec4 position, vec3 position64Low) {\n  vec4 position_world = project_uModelMatrix * position;\n\n  // Work around for a Mac+NVIDIA bug https://github.com/visgl/deck.gl/issues/4145\n  if (project_uProjectionMode == PROJECTION_MODE_WEB_MERCATOR) {\n    if (project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT) {\n      return vec4(\n        project_mercator_(position_world.xy),\n        project_size_at_latitude(position_world.z, position_world.y),\n        position_world.w\n      );\n    }\n    if (project_uCoordinateSystem == COORDINATE_SYSTEM_CARTESIAN) {\n      position_world.xyz += project_uCoordinateOrigin;\n    }\n  }\n  if (project_uProjectionMode == PROJECTION_MODE_GLOBE) {\n    if (project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT) {\n      return vec4(\n        project_globe_(position_world.xyz),\n        position_world.w\n      );\n    }\n  }\n  if (project_uProjectionMode == PROJECTION_MODE_WEB_MERCATOR_AUTO_OFFSET) {\n    if (project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT) {\n      if (abs(position_world.y - project_uCoordinateOrigin.y) > 0.25) {\n        // Too far from the projection center for offset mode to be accurate\n        // Only use high parts\n        return vec4(\n          project_mercator_(position_world.xy) - project_uCommonOrigin.xy,\n          project_size(position_world.z),\n          position_world.w\n        );\n      }\n    }\n  }\n  if (project_uProjectionMode == PROJECTION_MODE_IDENTITY ||\n    (project_uProjectionMode == PROJECTION_MODE_WEB_MERCATOR_AUTO_OFFSET &&\n    (project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT ||\n     project_uCoordinateSystem == COORDINATE_SYSTEM_CARTESIAN))) {\n    // Subtract high part of 64 bit value. Convert remainder to float32, preserving precision.\n    position_world.xyz -= project_uCoordinateOrigin;\n  }\n\n  // Translation is already added to the high parts\n  return project_offset_(position_world + project_uModelMatrix * vec4(position64Low, 0.0));\n}\n\nvec4 project_position(vec4 position) {\n  return project_position(position, ZERO_64_LOW);\n}\n\nvec3 project_position(vec3 position, vec3 position64Low) {\n  vec4 projected_position = project_position(vec4(position, 1.0), position64Low);\n  return projected_position.xyz;\n}\n\nvec3 project_position(vec3 position) {\n  vec4 projected_position = project_position(vec4(position, 1.0), ZERO_64_LOW);\n  return projected_position.xyz;\n}\n\nvec2 project_position(vec2 position) {\n  vec4 projected_position = project_position(vec4(position, 0.0, 1.0), ZERO_64_LOW);\n  return projected_position.xy;\n}\n\nvec4 project_common_position_to_clipspace(vec4 position, mat4 viewProjectionMatrix, vec4 center) {\n  return viewProjectionMatrix * position + center;\n}\n\n//\n// Projects from common space coordinates to clip space.\n// Uses project_uViewProjectionMatrix\n//\nvec4 project_common_position_to_clipspace(vec4 position) {\n  return project_common_position_to_clipspace(position, project_uViewProjectionMatrix, project_uCenter);\n}\n\n// Returns a clip space offset that corresponds to a given number of screen pixels\nvec2 project_pixel_size_to_clipspace(vec2 pixels) {\n  vec2 offset = pixels / project_uViewportSize * project_uDevicePixelRatio * 2.0;\n  return offset * project_uFocalDistance;\n}\n\nfloat project_size_to_pixel(float meters) {\n  return project_size(meters) * project_uScale;\n}\nfloat project_size_to_pixel(float size, int unit) {\n  if (unit == UNIT_METERS) return project_size_to_pixel(size);\n  if (unit == UNIT_COMMON) return size * project_uScale;\n  // UNIT_PIXELS\n  return size;\n}\nfloat project_pixel_size(float pixels) {\n  return pixels / project_uScale;\n}\nvec2 project_pixel_size(vec2 pixels) {\n  return pixels / project_uScale;\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {fp32} from '@luma.gl/core';\nimport geometry from '../misc/geometry';\nimport projectShader from './project.glsl';\nimport {getUniformsFromViewport} from './viewport-uniforms';\n\nimport type {ProjectModuleSettings} from './viewport-uniforms';\nimport type {ShaderModule} from '../../types/types';\n\nconst INITIAL_MODULE_OPTIONS = {};\n\nfunction getUniforms(opts: ProjectModuleSettings | {} = INITIAL_MODULE_OPTIONS) {\n  if ('viewport' in opts) {\n    return getUniformsFromViewport(opts);\n  }\n  return {};\n}\n\nexport default {\n  name: 'project',\n  dependencies: [fp32, geometry],\n  vs: projectShader,\n  getUniforms\n} as ShaderModule<ProjectModuleSettings>;\n","import { assert, validateWorkerVersion } from '@loaders.gl/worker-utils';\nimport { parseWithWorker, canParseWithWorker } from '@loaders.gl/loader-utils';\nimport { isLoaderObject } from '../loader-utils/normalize-loader';\nimport { isResponse } from '../../javascript-utils/is-type';\nimport { normalizeOptions } from '../loader-utils/option-utils';\nimport { getArrayBufferOrStringFromData } from '../loader-utils/get-data';\nimport { getLoaderContext, getLoadersFromContext } from '../loader-utils/loader-context';\nimport { getResourceUrlAndType } from '../utils/resource-utils';\nimport { selectLoader } from './select-loader';\nexport async function parse(data, loaders, options, context) {\n  assert(!context || typeof context === 'object');\n\n  if (loaders && !Array.isArray(loaders) && !isLoaderObject(loaders)) {\n    context = undefined;\n    options = loaders;\n    loaders = undefined;\n  }\n\n  data = await data;\n  options = options || {};\n  const {\n    url\n  } = getResourceUrlAndType(data);\n  const typedLoaders = loaders;\n  const candidateLoaders = getLoadersFromContext(typedLoaders, context);\n  const loader = await selectLoader(data, candidateLoaders, options);\n\n  if (!loader) {\n    return null;\n  }\n\n  options = normalizeOptions(options, loader, candidateLoaders, url);\n  context = getLoaderContext({\n    url,\n    parse,\n    loaders: candidateLoaders\n  }, options, context);\n  return await parseWithLoader(loader, data, options, context);\n}\n\nasync function parseWithLoader(loader, data, options, context) {\n  validateWorkerVersion(loader);\n\n  if (isResponse(data)) {\n    const response = data;\n    const {\n      ok,\n      redirected,\n      status,\n      statusText,\n      type,\n      url\n    } = response;\n    const headers = Object.fromEntries(response.headers.entries());\n    context.response = {\n      headers,\n      ok,\n      redirected,\n      status,\n      statusText,\n      type,\n      url\n    };\n  }\n\n  data = await getArrayBufferOrStringFromData(data, loader, options);\n\n  if (loader.parseTextSync && typeof data === 'string') {\n    options.dataType = 'text';\n    return loader.parseTextSync(data, options, context, loader);\n  }\n\n  if (canParseWithWorker(loader, options)) {\n    return await parseWithWorker(loader, data, options, context, parse);\n  }\n\n  if (loader.parseText && typeof data === 'string') {\n    return await loader.parseText(data, options, context, loader);\n  }\n\n  if (loader.parse) {\n    return await loader.parse(data, options, context, loader);\n  }\n\n  assert(!loader.parseSync);\n  throw new Error(\"\".concat(loader.id, \" loader - no parser found and worker is disabled\"));\n}\n//# sourceMappingURL=parse.js.map","import { assert } from '../env-utils/assert';\nimport { VERSION } from '../env-utils/version';\nexport function validateWorkerVersion(worker, coreVersion = VERSION) {\n  assert(worker, 'no worker provided');\n  const workerVersion = worker.version;\n\n  if (!coreVersion || !workerVersion) {\n    return false;\n  }\n\n  return true;\n}\n\nfunction parseVersion(version) {\n  const parts = version.split('.').map(Number);\n  return {\n    major: parts[0],\n    minor: parts[1]\n  };\n}\n//# sourceMappingURL=validate-worker-version.js.map","export function assert(condition, message) {\n  if (!condition) {\n    throw new Error(message || 'loader assertion failed.');\n  }\n}\n//# sourceMappingURL=assert.js.map","import { assert } from '../utils/assert';\nlet pathPrefix = '';\nexport function setPathPrefix(prefix) {\n  pathPrefix = prefix;\n}\nexport function loadFile(url) {\n  let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n  assert(typeof url === 'string');\n  url = pathPrefix + url;\n  const dataType = options.dataType || 'text';\n  return fetch(url, options).then(res => res[dataType]());\n}\nexport function loadImage(url, opts) {\n  assert(typeof url === 'string');\n  url = pathPrefix + url;\n  return new Promise((resolve, reject) => {\n    try {\n      const image = new Image();\n\n      image.onload = () => resolve(image);\n\n      image.onerror = () => reject(new Error(\"Could not load image \".concat(url, \".\")));\n\n      image.crossOrigin = opts && opts.crossOrigin || 'anonymous';\n      image.src = url;\n    } catch (error) {\n      reject(error);\n    }\n  });\n}\n//# sourceMappingURL=load-file.js.map","import { assertWebGLContext } from '@luma.gl/gltools';\nimport Texture from './texture';\nimport { loadImage } from '../utils/load-file';\nexport default class Texture2D extends Texture {\n  get [Symbol.toStringTag]() {\n    return 'Texture2D';\n  }\n\n  static isSupported(gl, opts) {\n    return Texture.isSupported(gl, opts);\n  }\n\n  constructor(gl) {\n    let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    assertWebGLContext(gl);\n\n    if (props instanceof Promise || typeof props === 'string') {\n      props = {\n        data: props\n      };\n    }\n\n    if (typeof props.data === 'string') {\n      props = Object.assign({}, props, {\n        data: loadImage(props.data)\n      });\n    }\n\n    super(gl, Object.assign({}, props, {\n      target: 3553\n    }));\n    this.initialize(props);\n    Object.seal(this);\n  }\n\n}\n//# sourceMappingURL=texture-2d.js.map","import { isResponse } from '../../javascript-utils/is-type';\nimport { getResourceContentLength, getResourceUrlAndType } from './resource-utils';\nexport async function makeResponse(resource) {\n  if (isResponse(resource)) {\n    return resource;\n  }\n\n  const headers = {};\n  const contentLength = getResourceContentLength(resource);\n\n  if (contentLength >= 0) {\n    headers['content-length'] = String(contentLength);\n  }\n\n  const {\n    url,\n    type\n  } = getResourceUrlAndType(resource);\n\n  if (type) {\n    headers['content-type'] = type;\n  }\n\n  const initialDataUrl = await getInitialDataUrl(resource);\n\n  if (initialDataUrl) {\n    headers['x-first-bytes'] = initialDataUrl;\n  }\n\n  if (typeof resource === 'string') {\n    resource = new TextEncoder().encode(resource);\n  }\n\n  const response = new Response(resource, {\n    headers\n  });\n  Object.defineProperty(response, 'url', {\n    value: url\n  });\n  return response;\n}\nexport async function checkResponse(response) {\n  if (!response.ok) {\n    const message = await getResponseError(response);\n    throw new Error(message);\n  }\n}\nexport function checkResponseSync(response) {\n  if (!response.ok) {\n    let message = \"\".concat(response.status, \" \").concat(response.statusText);\n    message = message.length > 60 ? \"\".concat(message.slice(0, 60), \"...\") : message;\n    throw new Error(message);\n  }\n}\n\nasync function getResponseError(response) {\n  let message = \"Failed to fetch resource \".concat(response.url, \" (\").concat(response.status, \"): \");\n\n  try {\n    const contentType = response.headers.get('Content-Type');\n    let text = response.statusText;\n\n    if (contentType.includes('application/json')) {\n      text += \" \".concat(await response.text());\n    }\n\n    message += text;\n    message = message.length > 60 ? \"\".concat(message.slice(0, 60), \"...\") : message;\n  } catch (error) {}\n\n  return message;\n}\n\nasync function getInitialDataUrl(resource) {\n  const INITIAL_DATA_LENGTH = 5;\n\n  if (typeof resource === 'string') {\n    return \"data:,\".concat(resource.slice(0, INITIAL_DATA_LENGTH));\n  }\n\n  if (resource instanceof Blob) {\n    const blobSlice = resource.slice(0, 5);\n    return await new Promise(resolve => {\n      const reader = new FileReader();\n\n      reader.onload = event => {\n        var _event$target;\n\n        return resolve(event === null || event === void 0 ? void 0 : (_event$target = event.target) === null || _event$target === void 0 ? void 0 : _event$target.result);\n      };\n\n      reader.readAsDataURL(blobSlice);\n    });\n  }\n\n  if (resource instanceof ArrayBuffer) {\n    const slice = resource.slice(0, INITIAL_DATA_LENGTH);\n    const base64 = arrayBufferToBase64(slice);\n    return \"data:base64,\".concat(base64);\n  }\n\n  return null;\n}\n\nfunction arrayBufferToBase64(buffer) {\n  let binary = '';\n  const bytes = new Uint8Array(buffer);\n\n  for (let i = 0; i < bytes.byteLength; i++) {\n    binary += String.fromCharCode(bytes[i]);\n  }\n\n  return btoa(binary);\n}\n//# sourceMappingURL=response-utils.js.map","const EXT_FLOAT_WEBGL2 = 'EXT_color_buffer_float';\nexport default {\n  [33189]: {\n    bpp: 2\n  },\n  [33190]: {\n    gl2: true,\n    bpp: 3\n  },\n  [36012]: {\n    gl2: true,\n    bpp: 4\n  },\n  [36168]: {\n    bpp: 1\n  },\n  [34041]: {\n    bpp: 4\n  },\n  [35056]: {\n    gl2: true,\n    bpp: 4\n  },\n  [36013]: {\n    gl2: true,\n    bpp: 5\n  },\n  [32854]: {\n    bpp: 2\n  },\n  [36194]: {\n    bpp: 2\n  },\n  [32855]: {\n    bpp: 2\n  },\n  [33321]: {\n    gl2: true,\n    bpp: 1\n  },\n  [33330]: {\n    gl2: true,\n    bpp: 1\n  },\n  [33329]: {\n    gl2: true,\n    bpp: 1\n  },\n  [33332]: {\n    gl2: true,\n    bpp: 2\n  },\n  [33331]: {\n    gl2: true,\n    bpp: 2\n  },\n  [33334]: {\n    gl2: true,\n    bpp: 4\n  },\n  [33333]: {\n    gl2: true,\n    bpp: 4\n  },\n  [33323]: {\n    gl2: true,\n    bpp: 2\n  },\n  [33336]: {\n    gl2: true,\n    bpp: 2\n  },\n  [33335]: {\n    gl2: true,\n    bpp: 2\n  },\n  [33338]: {\n    gl2: true,\n    bpp: 4\n  },\n  [33337]: {\n    gl2: true,\n    bpp: 4\n  },\n  [33340]: {\n    gl2: true,\n    bpp: 8\n  },\n  [33339]: {\n    gl2: true,\n    bpp: 8\n  },\n  [32849]: {\n    gl2: true,\n    bpp: 3\n  },\n  [32856]: {\n    gl2: true,\n    bpp: 4\n  },\n  [32857]: {\n    gl2: true,\n    bpp: 4\n  },\n  [36220]: {\n    gl2: true,\n    bpp: 4\n  },\n  [36238]: {\n    gl2: true,\n    bpp: 4\n  },\n  [36975]: {\n    gl2: true,\n    bpp: 4\n  },\n  [36214]: {\n    gl2: true,\n    bpp: 8\n  },\n  [36232]: {\n    gl2: true,\n    bpp: 8\n  },\n  [36226]: {\n    gl2: true,\n    bpp: 16\n  },\n  [36208]: {\n    gl2: true,\n    bpp: 16\n  },\n  [33325]: {\n    gl2: EXT_FLOAT_WEBGL2,\n    bpp: 2\n  },\n  [33327]: {\n    gl2: EXT_FLOAT_WEBGL2,\n    bpp: 4\n  },\n  [34842]: {\n    gl2: EXT_FLOAT_WEBGL2,\n    bpp: 8\n  },\n  [33326]: {\n    gl2: EXT_FLOAT_WEBGL2,\n    bpp: 4\n  },\n  [33328]: {\n    gl2: EXT_FLOAT_WEBGL2,\n    bpp: 8\n  },\n  [34836]: {\n    gl2: EXT_FLOAT_WEBGL2,\n    bpp: 16\n  },\n  [35898]: {\n    gl2: EXT_FLOAT_WEBGL2,\n    bpp: 4\n  }\n};\n//# sourceMappingURL=renderbuffer-formats.js.map","import Resource from './resource';\nimport RENDERBUFFER_FORMATS from './renderbuffer-formats';\nimport { isWebGL2 } from '@luma.gl/gltools';\nimport { assert } from '../utils/assert';\n\nfunction isFormatSupported(gl, format, formats) {\n  const info = formats[format];\n\n  if (!info) {\n    return false;\n  }\n\n  const value = isWebGL2(gl) ? info.gl2 || info.gl1 : info.gl1;\n\n  if (typeof value === 'string') {\n    return gl.getExtension(value);\n  }\n\n  return value;\n}\n\nexport default class Renderbuffer extends Resource {\n  get [Symbol.toStringTag]() {\n    return 'Renderbuffer';\n  }\n\n  static isSupported(gl) {\n    let {\n      format\n    } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n      format: null\n    };\n    return !format || isFormatSupported(gl, format, RENDERBUFFER_FORMATS);\n  }\n\n  static getSamplesForFormat(gl, _ref) {\n    let {\n      format\n    } = _ref;\n    return gl.getInternalformatParameter(36161, format, 32937);\n  }\n\n  constructor(gl) {\n    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    super(gl, opts);\n    this.initialize(opts);\n    Object.seal(this);\n  }\n\n  initialize(_ref2) {\n    let {\n      format,\n      width = 1,\n      height = 1,\n      samples = 0\n    } = _ref2;\n    assert(format, 'Needs format');\n\n    this._trackDeallocatedMemory();\n\n    this.gl.bindRenderbuffer(36161, this.handle);\n\n    if (samples !== 0 && isWebGL2(this.gl)) {\n      this.gl.renderbufferStorageMultisample(36161, samples, format, width, height);\n    } else {\n      this.gl.renderbufferStorage(36161, format, width, height);\n    }\n\n    this.format = format;\n    this.width = width;\n    this.height = height;\n    this.samples = samples;\n\n    this._trackAllocatedMemory(this.width * this.height * (this.samples || 1) * RENDERBUFFER_FORMATS[this.format].bpp);\n\n    return this;\n  }\n\n  resize(_ref3) {\n    let {\n      width,\n      height\n    } = _ref3;\n\n    if (width !== this.width || height !== this.height) {\n      return this.initialize({\n        width,\n        height,\n        format: this.format,\n        samples: this.samples\n      });\n    }\n\n    return this;\n  }\n\n  _createHandle() {\n    return this.gl.createRenderbuffer();\n  }\n\n  _deleteHandle() {\n    this.gl.deleteRenderbuffer(this.handle);\n\n    this._trackDeallocatedMemory();\n  }\n\n  _bindHandle(handle) {\n    this.gl.bindRenderbuffer(36161, handle);\n  }\n\n  _syncHandle(handle) {\n    this.format = this.getParameter(36164);\n    this.width = this.getParameter(36162);\n    this.height = this.getParameter(36163);\n    this.samples = this.getParameter(36011);\n  }\n\n  _getParameter(pname) {\n    this.gl.bindRenderbuffer(36161, this.handle);\n    const value = this.gl.getRenderbufferParameter(36161, pname);\n    return value;\n  }\n\n}\n//# sourceMappingURL=renderbuffer.js.map","// Purpose: include this in your module to avoids adding dependencies on\n// micro modules like 'global'\n/* global window, global, document, navigator */\nexport const userAgent = typeof navigator !== 'undefined' && navigator.userAgent ? navigator.userAgent.toLowerCase() : '';\nconst window_ = typeof window !== 'undefined' ? window : global;\nconst global_ = typeof global !== 'undefined' ? global : window;\nconst document_ = typeof document !== 'undefined' ? document : {};\nexport { window_ as window, global_ as global, document_ as document };\n/*\n * Detect whether passive option is supported by the current browser.\n * https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener\n   #Safely_detecting_option_support\n */\nlet passiveSupported = false;\n/* eslint-disable accessor-pairs, no-empty */\ntry {\n    const options = {\n        // This function will be called when the browser\n        // attempts to access the passive property.\n        get passive() {\n            passiveSupported = true;\n            return true;\n        }\n    };\n    window_.addEventListener('test', null, options);\n    window_.removeEventListener('test', null);\n}\ncatch (err) {\n    passiveSupported = false;\n}\nexport { passiveSupported };\n//# sourceMappingURL=globals.js.map","var window_ = typeof window !== 'undefined' ? window : global;\nvar global_ = typeof global !== 'undefined' ? global : window;\nvar document_ = typeof document !== 'undefined' ? document : {};\nexport { window_ as window, global_ as global, document_ as document };\n//# sourceMappingURL=globals.js.map","import { normalizeLoader } from '../loader-utils/normalize-loader';\nimport { getGlobalLoaderState } from '../loader-utils/option-utils';\n\nconst getGlobalLoaderRegistry = () => {\n  const state = getGlobalLoaderState();\n  state.loaderRegistry = state.loaderRegistry || [];\n  return state.loaderRegistry;\n};\n\nexport function registerLoaders(loaders) {\n  const loaderRegistry = getGlobalLoaderRegistry();\n  loaders = Array.isArray(loaders) ? loaders : [loaders];\n\n  for (const loader of loaders) {\n    const normalizedLoader = normalizeLoader(loader);\n\n    if (!loaderRegistry.find(registeredLoader => normalizedLoader === registeredLoader)) {\n      loaderRegistry.unshift(normalizedLoader);\n    }\n  }\n}\nexport function getRegisteredLoaders() {\n  return getGlobalLoaderRegistry();\n}\nexport function _unregisterLoaders() {\n  const state = getGlobalLoaderState();\n  state.loaderRegistry = [];\n}\n//# sourceMappingURL=register-loaders.js.map","import {clamp} from '@math.gl/core';\nimport Controller, {ControllerProps} from './controller';\nimport ViewState from './view-state';\nimport {normalizeViewportProps} from '@math.gl/web-mercator';\nimport assert from '../utils/assert';\n\nimport LinearInterpolator from '../transitions/linear-interpolator';\nimport type Viewport from '../viewports/viewport';\n\nconst PITCH_MOUSE_THRESHOLD = 5;\nconst PITCH_ACCEL = 1.2;\n\nexport type MapStateProps = {\n  /** Mapbox viewport properties */\n  /** The width of the viewport */\n  width: number;\n  /** The height of the viewport */\n  height: number;\n  /** The latitude at the center of the viewport */\n  latitude: number;\n  /** The longitude at the center of the viewport */\n  longitude: number;\n  /** The tile zoom level of the map. */\n  zoom: number;\n  /** The bearing of the viewport in degrees */\n  bearing?: number;\n  /** The pitch of the viewport in degrees */\n  pitch?: number;\n  /**\n   * Specify the altitude of the viewport camera\n   * Unit: map heights, default 1.5\n   * Non-public API, see https://github.com/mapbox/mapbox-gl-js/issues/1137\n   */\n  altitude?: number;\n  /** Viewport position */\n  position?: [number, number, number];\n\n  /** Viewport constraints */\n  maxZoom?: number;\n  minZoom?: number;\n  maxPitch?: number;\n  minPitch?: number;\n\n  /** Normalize viewport props to fit map height into viewport. Default `true` */\n  normalize?: boolean;\n};\n\ntype MapStateInternal = {\n  /** Interaction states, required to calculate change during transform */\n  /* The point on map being grabbed when the operation first started */\n  startPanLngLat?: [number, number];\n  /* Center of the zoom when the operation first started */\n  startZoomLngLat?: [number, number];\n  /* Pointer position when rotation started */\n  startRotatePos?: [number, number];\n  /** Bearing when current perspective rotate operation started */\n  startBearing?: number;\n  /** Pitch when current perspective rotate operation started */\n  startPitch?: number;\n  /** Zoom when current zoom operation started */\n  startZoom?: number;\n};\n\n/* Utils */\n\nexport class MapState extends ViewState<MapState, MapStateProps, MapStateInternal> {\n  makeViewport: (props: Record<string, any>) => Viewport;\n\n  constructor(\n    options: MapStateProps &\n      MapStateInternal & {\n        makeViewport: (props: Record<string, any>) => Viewport;\n      }\n  ) {\n    const {\n      /** Mapbox viewport properties */\n      /** The width of the viewport */\n      width,\n      /** The height of the viewport */\n      height,\n      /** The latitude at the center of the viewport */\n      latitude,\n      /** The longitude at the center of the viewport */\n      longitude,\n      /** The tile zoom level of the map. */\n      zoom,\n      /** The bearing of the viewport in degrees */\n      bearing = 0,\n      /** The pitch of the viewport in degrees */\n      pitch = 0,\n      /**\n       * Specify the altitude of the viewport camera\n       * Unit: map heights, default 1.5\n       * Non-public API, see https://github.com/mapbox/mapbox-gl-js/issues/1137\n       */\n      altitude = 1.5,\n      /** Viewport position */\n      position = [0, 0, 0],\n\n      /** Viewport constraints */\n      maxZoom = 20,\n      minZoom = 0,\n      maxPitch = 60,\n      minPitch = 0,\n\n      /** Interaction states, required to calculate change during transform */\n      /* The point on map being grabbed when the operation first started */\n      startPanLngLat,\n      /* Center of the zoom when the operation first started */\n      startZoomLngLat,\n      /* Pointer position when rotation started */\n      startRotatePos,\n      /** Bearing when current perspective rotate operation started */\n      startBearing,\n      /** Pitch when current perspective rotate operation started */\n      startPitch,\n      /** Zoom when current zoom operation started */\n      startZoom,\n\n      /** Normalize viewport props to fit map height into viewport */\n      normalize = true\n    } = options;\n\n    assert(Number.isFinite(longitude)); // `longitude` must be supplied\n    assert(Number.isFinite(latitude)); // `latitude` must be supplied\n    assert(Number.isFinite(zoom)); // `zoom` must be supplied\n\n    super(\n      {\n        width,\n        height,\n        latitude,\n        longitude,\n        zoom,\n        bearing,\n        pitch,\n        altitude,\n        maxZoom,\n        minZoom,\n        maxPitch,\n        minPitch,\n        normalize,\n        position\n      },\n      {\n        startPanLngLat,\n        startZoomLngLat,\n        startRotatePos,\n        startBearing,\n        startPitch,\n        startZoom\n      }\n    );\n\n    this.makeViewport = options.makeViewport;\n  }\n\n  /**\n   * Start panning\n   * @param {[Number, Number]} pos - position on screen where the pointer grabs\n   */\n  panStart({pos}: {pos: [number, number]}): MapState {\n    return this._getUpdatedState({\n      startPanLngLat: this._unproject(pos)\n    });\n  }\n\n  /**\n   * Pan\n   * @param {[Number, Number]} pos - position on screen where the pointer is\n   * @param {[Number, Number], optional} startPos - where the pointer grabbed at\n   *   the start of the operation. Must be supplied of `panStart()` was not called\n   */\n  pan({pos, startPos}: {pos: [number, number]; startPos?: [number, number]}): MapState {\n    const startPanLngLat = this.getState().startPanLngLat || this._unproject(startPos);\n\n    if (!startPanLngLat) {\n      return this;\n    }\n\n    const viewport = this.makeViewport(this.getViewportProps());\n    const newProps = viewport.panByPosition(startPanLngLat, pos);\n\n    return this._getUpdatedState(newProps);\n  }\n\n  /**\n   * End panning\n   * Must call if `panStart()` was called\n   */\n  panEnd(): MapState {\n    return this._getUpdatedState({\n      startPanLngLat: null\n    });\n  }\n\n  /**\n   * Start rotating\n   * @param {[Number, Number]} pos - position on screen where the center is\n   */\n  rotateStart({pos}: {pos: [number, number]}): MapState {\n    return this._getUpdatedState({\n      startRotatePos: pos,\n      startBearing: this.getViewportProps().bearing,\n      startPitch: this.getViewportProps().pitch\n    });\n  }\n\n  /**\n   * Rotate\n   * @param {[Number, Number]} pos - position on screen where the center is\n   */\n  rotate({\n    pos,\n    deltaAngleX = 0,\n    deltaAngleY = 0\n  }: {\n    pos?: [number, number];\n    deltaAngleX?: number;\n    deltaAngleY?: number;\n  }): MapState {\n    const {startRotatePos, startBearing, startPitch} = this.getState();\n\n    if (!startRotatePos || startBearing === undefined || startPitch === undefined) {\n      return this;\n    }\n    let newRotation;\n    if (pos) {\n      newRotation = this._getNewRotation(pos, startRotatePos, startPitch, startBearing);\n    } else {\n      newRotation = {\n        bearing: startBearing + deltaAngleX,\n        pitch: startPitch + deltaAngleY\n      };\n    }\n    return this._getUpdatedState(newRotation);\n  }\n\n  /**\n   * End rotating\n   * Must call if `rotateStart()` was called\n   */\n  rotateEnd(): MapState {\n    return this._getUpdatedState({\n      startBearing: null,\n      startPitch: null\n    });\n  }\n\n  /**\n   * Start zooming\n   * @param {[Number, Number]} pos - position on screen where the center is\n   */\n  zoomStart({pos}: {pos: [number, number]}): MapState {\n    return this._getUpdatedState({\n      startZoomLngLat: this._unproject(pos),\n      startZoom: this.getViewportProps().zoom\n    });\n  }\n\n  /**\n   * Zoom\n   * @param {[Number, Number]} pos - position on screen where the current center is\n   * @param {[Number, Number]} startPos - the center position at\n   *   the start of the operation. Must be supplied of `zoomStart()` was not called\n   * @param {Number} scale - a number between [0, 1] specifying the accumulated\n   *   relative scale.\n   */\n  zoom({\n    pos,\n    startPos,\n    scale\n  }: {\n    pos: [number, number];\n    startPos?: [number, number];\n    scale: number;\n  }): MapState {\n    // Make sure we zoom around the current mouse position rather than map center\n    let {startZoom, startZoomLngLat} = this.getState();\n\n    if (!startZoomLngLat) {\n      // We have two modes of zoom:\n      // scroll zoom that are discrete events (transform from the current zoom level),\n      // and pinch zoom that are continuous events (transform from the zoom level when\n      // pinch started).\n      // If startZoom state is defined, then use the startZoom state;\n      // otherwise assume discrete zooming\n      startZoom = this.getViewportProps().zoom;\n      startZoomLngLat = this._unproject(startPos) || this._unproject(pos);\n    }\n    if (!startZoomLngLat) {\n      return this;\n    }\n\n    const {maxZoom, minZoom} = this.getViewportProps();\n    let zoom = (startZoom as number) + Math.log2(scale);\n    zoom = clamp(zoom, minZoom, maxZoom);\n\n    const zoomedViewport = this.makeViewport({...this.getViewportProps(), zoom});\n\n    return this._getUpdatedState({\n      zoom,\n      ...zoomedViewport.panByPosition(startZoomLngLat, pos)\n    });\n  }\n\n  /**\n   * End zooming\n   * Must call if `zoomStart()` was called\n   */\n  zoomEnd(): MapState {\n    return this._getUpdatedState({\n      startZoomLngLat: null,\n      startZoom: null\n    });\n  }\n\n  zoomIn(speed: number = 2): MapState {\n    return this._zoomFromCenter(speed);\n  }\n\n  zoomOut(speed: number = 2): MapState {\n    return this._zoomFromCenter(1 / speed);\n  }\n\n  moveLeft(speed: number = 100): MapState {\n    return this._panFromCenter([speed, 0]);\n  }\n\n  moveRight(speed: number = 100): MapState {\n    return this._panFromCenter([-speed, 0]);\n  }\n\n  moveUp(speed: number = 100): MapState {\n    return this._panFromCenter([0, speed]);\n  }\n\n  moveDown(speed: number = 100): MapState {\n    return this._panFromCenter([0, -speed]);\n  }\n\n  rotateLeft(speed: number = 15): MapState {\n    return this._getUpdatedState({\n      bearing: this.getViewportProps().bearing - speed\n    });\n  }\n\n  rotateRight(speed: number = 15): MapState {\n    return this._getUpdatedState({\n      bearing: this.getViewportProps().bearing + speed\n    });\n  }\n\n  rotateUp(speed: number = 10): MapState {\n    return this._getUpdatedState({\n      pitch: this.getViewportProps().pitch + speed\n    });\n  }\n\n  rotateDown(speed: number = 10): MapState {\n    return this._getUpdatedState({\n      pitch: this.getViewportProps().pitch - speed\n    });\n  }\n\n  shortestPathFrom(viewState: MapState): MapStateProps {\n    // const endViewStateProps = new this.ControllerState(endProps).shortestPathFrom(startViewstate);\n    const fromProps = viewState.getViewportProps();\n    const props = {...this.getViewportProps()};\n    const {bearing, longitude} = props;\n\n    if (Math.abs(bearing - fromProps.bearing) > 180) {\n      props.bearing = bearing < 0 ? bearing + 360 : bearing - 360;\n    }\n    if (Math.abs(longitude - fromProps.longitude) > 180) {\n      props.longitude = longitude < 0 ? longitude + 360 : longitude - 360;\n    }\n    return props;\n  }\n\n  // Apply any constraints (mathematical or defined by _viewportProps) to map state\n  applyConstraints(props: Required<MapStateProps>): Required<MapStateProps> {\n    // Ensure zoom is within specified range\n    const {maxZoom, minZoom, zoom} = props;\n    props.zoom = clamp(zoom, minZoom, maxZoom);\n\n    // Ensure pitch is within specified range\n    const {maxPitch, minPitch, pitch} = props;\n    props.pitch = clamp(pitch, minPitch, maxPitch);\n\n    // Normalize viewport props to fit map height into viewport\n    const {normalize = true} = props;\n    if (normalize) {\n      Object.assign(props, normalizeViewportProps(props));\n    }\n\n    return props;\n  }\n\n  /* Private methods */\n\n  _zoomFromCenter(scale) {\n    const {width, height} = this.getViewportProps();\n    return this.zoom({\n      pos: [width / 2, height / 2],\n      scale\n    });\n  }\n\n  _panFromCenter(offset) {\n    const {width, height} = this.getViewportProps();\n    return this.pan({\n      startPos: [width / 2, height / 2],\n      pos: [width / 2 + offset[0], height / 2 + offset[1]]\n    });\n  }\n\n  _getUpdatedState(newProps): MapState {\n    // @ts-ignore\n    return new this.constructor({\n      makeViewport: this.makeViewport,\n      ...this.getViewportProps(),\n      ...this.getState(),\n      ...newProps\n    });\n  }\n\n  _unproject(pos?: [number, number]): [number, number] | undefined {\n    const viewport = this.makeViewport(this.getViewportProps());\n    // @ts-ignore\n    return pos && viewport.unproject(pos);\n  }\n\n  _getNewRotation(\n    pos: [number, number],\n    startPos: [number, number],\n    startPitch: number,\n    startBearing: number\n  ): {\n    pitch: number;\n    bearing: number;\n  } {\n    const deltaX = pos[0] - startPos[0];\n    const deltaY = pos[1] - startPos[1];\n    const centerY = pos[1];\n    const startY = startPos[1];\n    const {width, height} = this.getViewportProps();\n\n    const deltaScaleX = deltaX / width;\n    let deltaScaleY = 0;\n\n    if (deltaY > 0) {\n      if (Math.abs(height - startY) > PITCH_MOUSE_THRESHOLD) {\n        // Move from 0 to -1 as we drag upwards\n        deltaScaleY = (deltaY / (startY - height)) * PITCH_ACCEL;\n      }\n    } else if (deltaY < 0) {\n      if (startY > PITCH_MOUSE_THRESHOLD) {\n        // Move from 0 to 1 as we drag upwards\n        deltaScaleY = 1 - centerY / startY;\n      }\n    }\n    // clamp deltaScaleY to [-1, 1] so that rotation is constrained between minPitch and maxPitch.\n    // deltaScaleX does not need to be clamped as bearing does not have constraints.\n    deltaScaleY = clamp(deltaScaleY, -1, 1);\n\n    const {minPitch, maxPitch} = this.getViewportProps();\n\n    const bearing = startBearing + 180 * deltaScaleX;\n    let pitch = startPitch;\n    if (deltaScaleY > 0) {\n      // Gradually increase pitch\n      pitch = startPitch + deltaScaleY * (maxPitch - startPitch);\n    } else if (deltaScaleY < 0) {\n      // Gradually decrease pitch\n      pitch = startPitch - deltaScaleY * (minPitch - startPitch);\n    }\n\n    return {\n      pitch,\n      bearing\n    };\n  }\n}\n\nexport default class MapController extends Controller<MapState> {\n  ControllerState = MapState;\n\n  transition = {\n    transitionDuration: 300,\n    transitionInterpolator: new LinearInterpolator({\n      transitionProps: {\n        compare: ['longitude', 'latitude', 'zoom', 'bearing', 'pitch', 'position'],\n        required: ['longitude', 'latitude', 'zoom']\n      }\n    })\n  };\n\n  dragMode: 'pan' | 'rotate' = 'pan';\n\n  setProps(props: ControllerProps & MapStateProps) {\n    props.position = props.position || [0, 0, 0];\n    const oldProps = this.props;\n\n    super.setProps(props);\n\n    const dimensionChanged = !oldProps || oldProps.height !== props.height;\n    if (dimensionChanged) {\n      // Dimensions changed, normalize the props\n      this.updateViewport(\n        new this.ControllerState({\n          makeViewport: this.makeViewport,\n          ...props,\n          ...this.state\n        })\n      );\n    }\n  }\n}\n","import {equals} from '@math.gl/core';\nimport assert from '../utils/assert';\n\nexport default abstract class TransitionInterpolator {\n  protected _propsToCompare: string[];\n  protected _propsToExtract: string[];\n  protected _requiredProps?: string[];\n\n  /**\n   * @param opts {array|object}\n   * @param opts.compare {array} - prop names used in equality check\n   * @param opts.extract {array} - prop names needed for interpolation\n   * @param opts.required {array} - prop names that must be supplied\n   * alternatively, supply one list of prop names as `opts` if all of the above are the same.\n   */\n  constructor(opts: {compare: string[]; extract?: string[]; required?: string[]}) {\n    const {compare, extract, required} = opts;\n\n    this._propsToCompare = compare;\n    this._propsToExtract = extract || compare;\n    this._requiredProps = required;\n  }\n\n  /**\n   * Checks if two sets of props need transition in between\n   * @param currentProps {object} - a list of viewport props\n   * @param nextProps {object} - a list of viewport props\n   * @returns {bool} - true if two props are equivalent\n   */\n  arePropsEqual(currentProps: Record<string, any>, nextProps: Record<string, any>): boolean {\n    for (const key of this._propsToCompare) {\n      if (\n        !(key in currentProps) ||\n        !(key in nextProps) ||\n        !equals(currentProps[key], nextProps[key])\n      ) {\n        return false;\n      }\n    }\n    return true;\n  }\n\n  /**\n   * Called before transition starts to validate/pre-process start and end props\n   * @param startProps {object} - a list of starting viewport props\n   * @param endProps {object} - a list of target viewport props\n   * @returns {Object} {start, end} - start and end props to be passed\n   *   to `interpolateProps`\n   */\n  initializeProps(\n    startProps: Record<string, any>,\n    endProps: Record<string, any>\n  ): {\n    start: Record<string, any>;\n    end: Record<string, any>;\n  } {\n    const startViewStateProps = {};\n    const endViewStateProps = {};\n\n    for (const key of this._propsToExtract) {\n      if (key in startProps || key in endProps) {\n        startViewStateProps[key] = startProps[key];\n        endViewStateProps[key] = endProps[key];\n      }\n    }\n\n    this._checkRequiredProps(startViewStateProps);\n    this._checkRequiredProps(endViewStateProps);\n\n    return {start: startViewStateProps, end: endViewStateProps};\n  }\n\n  /**\n   * Returns viewport props in transition\n   * @param startProps {object} - a list of starting viewport props\n   * @param endProps {object} - a list of target viewport props\n   * @param t {number} - a time factor between [0, 1]\n   * @returns {object} - a list of interpolated viewport props\n   */\n  abstract interpolateProps(\n    startProps: Record<string, any>,\n    endProps: Record<string, any>,\n    t: number\n  ): Record<string, any>;\n\n  /**\n   * Returns transition duration\n   * @param startProps {object} - a list of starting viewport props\n   * @param endProps {object} - a list of target viewport props\n   * @returns {Number} - transition duration in milliseconds\n   */\n  getDuration(startProps: Record<string, any>, endProps: Record<string, any>): number {\n    return endProps.transitionDuration;\n  }\n\n  _checkRequiredProps(props) {\n    if (!this._requiredProps) {\n      return;\n    }\n\n    this._requiredProps.forEach(propName => {\n      const value = props[propName];\n      assert(\n        Number.isFinite(value) || Array.isArray(value),\n        `${propName} is required for transition`\n      );\n    });\n  }\n}\n","import {clamp} from '@math.gl/core';\nimport Controller from './controller';\nimport ViewState from './view-state';\nimport {mod} from '../utils/math-utils';\n\nimport type Viewport from '../viewports/viewport';\nimport LinearInterpolator from '../transitions/linear-interpolator';\n\nexport type OrbitStateProps = {\n  width: number;\n  height: number;\n  target?: number[];\n  zoom?: number | number[];\n  rotationX?: number;\n  rotationOrbit?: number;\n\n  /** Viewport constraints */\n  maxZoom?: number;\n  minZoom?: number;\n  minRotationX?: number;\n  maxRotationX?: number;\n};\n\ntype OrbitStateInternal = {\n  startPanPosition?: number[];\n  startRotatePos?: number[];\n  startRotationX?: number;\n  startRotationOrbit?: number;\n  startZoomPosition?: number[];\n  startZoom?: number | number[];\n};\n\nexport class OrbitState extends ViewState<OrbitState, OrbitStateProps, OrbitStateInternal> {\n  makeViewport: (props: Record<string, any>) => Viewport;\n\n  constructor(\n    options: OrbitStateProps &\n      OrbitStateInternal & {\n        makeViewport: (props: Record<string, any>) => Viewport;\n      }\n  ) {\n    const {\n      /* Viewport arguments */\n      width, // Width of viewport\n      height, // Height of viewport\n      rotationX = 0, // Rotation around x axis\n      rotationOrbit = 0, // Rotation around orbit axis\n      target = [0, 0, 0],\n      zoom = 0,\n\n      /* Viewport constraints */\n      minRotationX = -90,\n      maxRotationX = 90,\n      minZoom = -Infinity,\n      maxZoom = Infinity,\n\n      /** Interaction states, required to calculate change during transform */\n      // Model state when the pan operation first started\n      startPanPosition,\n      // Model state when the rotate operation first started\n      startRotatePos,\n      startRotationX,\n      startRotationOrbit,\n      // Model state when the zoom operation first started\n      startZoomPosition,\n      startZoom\n    } = options;\n\n    super(\n      {\n        width,\n        height,\n        rotationX,\n        rotationOrbit,\n        target,\n        zoom,\n        minRotationX,\n        maxRotationX,\n        minZoom,\n        maxZoom\n      },\n      {\n        startPanPosition,\n        startRotatePos,\n        startRotationX,\n        startRotationOrbit,\n        startZoomPosition,\n        startZoom\n      }\n    );\n\n    this.makeViewport = options.makeViewport;\n  }\n\n  /**\n   * Start panning\n   * @param {[Number, Number]} pos - position on screen where the pointer grabs\n   */\n  panStart({pos}: {pos: [number, number]}): OrbitState {\n    return this._getUpdatedState({\n      startPanPosition: this._unproject(pos)\n    });\n  }\n\n  /**\n   * Pan\n   * @param {[Number, Number]} pos - position on screen where the pointer is\n   */\n  pan({pos, startPosition}: {pos: [number, number]; startPosition?: number[]}): OrbitState {\n    const startPanPosition = this.getState().startPanPosition || startPosition;\n\n    if (!startPanPosition) {\n      return this;\n    }\n\n    const viewport = this.makeViewport(this.getViewportProps());\n    const newProps = viewport.panByPosition(startPanPosition, pos);\n\n    return this._getUpdatedState(newProps);\n  }\n\n  /**\n   * End panning\n   * Must call if `panStart()` was called\n   */\n  panEnd(): OrbitState {\n    return this._getUpdatedState({\n      startPanPosition: null\n    });\n  }\n\n  /**\n   * Start rotating\n   * @param {[Number, Number]} pos - position on screen where the pointer grabs\n   */\n  rotateStart({pos}: {pos: [number, number]}): OrbitState {\n    return this._getUpdatedState({\n      startRotatePos: pos,\n      startRotationX: this.getViewportProps().rotationX,\n      startRotationOrbit: this.getViewportProps().rotationOrbit\n    });\n  }\n\n  /**\n   * Rotate\n   * @param {[Number, Number]} pos - position on screen where the pointer is\n   */\n  rotate({\n    pos,\n    deltaAngleX = 0,\n    deltaAngleY = 0\n  }: {\n    pos?: [number, number];\n    deltaAngleX?: number;\n    deltaAngleY?: number;\n  }): OrbitState {\n    const {startRotatePos, startRotationX, startRotationOrbit} = this.getState();\n    const {width, height} = this.getViewportProps();\n\n    if (!startRotatePos || startRotationX === undefined || startRotationOrbit === undefined) {\n      return this;\n    }\n\n    let newRotation;\n    if (pos) {\n      let deltaScaleX = (pos[0] - startRotatePos[0]) / width;\n      const deltaScaleY = (pos[1] - startRotatePos[1]) / height;\n\n      if (startRotationX < -90 || startRotationX > 90) {\n        // When looking at the \"back\" side of the scene, invert horizontal drag\n        // so that the camera movement follows user input\n        deltaScaleX *= -1;\n      }\n      newRotation = {\n        rotationX: startRotationX + deltaScaleY * 180,\n        rotationOrbit: startRotationOrbit + deltaScaleX * 180\n      };\n    } else {\n      newRotation = {\n        rotationX: startRotationX + deltaAngleY,\n        rotationOrbit: startRotationOrbit + deltaAngleX\n      };\n    }\n\n    return this._getUpdatedState(newRotation);\n  }\n\n  /**\n   * End rotating\n   * Must call if `rotateStart()` was called\n   */\n  rotateEnd(): OrbitState {\n    return this._getUpdatedState({\n      startRotationX: null,\n      startRotationOrbit: null\n    });\n  }\n\n  // shortest path between two view states\n  shortestPathFrom(viewState: OrbitState): OrbitStateProps {\n    const fromProps = viewState.getViewportProps();\n    const props = {...this.getViewportProps()};\n    const {rotationOrbit} = props;\n\n    if (Math.abs(rotationOrbit - fromProps.rotationOrbit) > 180) {\n      props.rotationOrbit = rotationOrbit < 0 ? rotationOrbit + 360 : rotationOrbit - 360;\n    }\n\n    return props;\n  }\n\n  /**\n   * Start zooming\n   * @param {[Number, Number]} pos - position on screen where the pointer grabs\n   */\n  zoomStart({pos}: {pos: [number, number]}): OrbitState {\n    return this._getUpdatedState({\n      startZoomPosition: this._unproject(pos),\n      startZoom: this.getViewportProps().zoom\n    });\n  }\n\n  /**\n   * Zoom\n   * @param {[Number, Number]} pos - position on screen where the current target is\n   * @param {[Number, Number]} startPos - the target position at\n   *   the start of the operation. Must be supplied of `zoomStart()` was not called\n   * @param {Number} scale - a number between [0, 1] specifying the accumulated\n   *   relative scale.\n   */\n  zoom({\n    pos,\n    startPos,\n    scale\n  }: {\n    pos: [number, number];\n    startPos?: [number, number];\n    scale: number;\n  }): OrbitState {\n    let {startZoom, startZoomPosition} = this.getState();\n    if (!startZoomPosition) {\n      // We have two modes of zoom:\n      // scroll zoom that are discrete events (transform from the current zoom level),\n      // and pinch zoom that are continuous events (transform from the zoom level when\n      // pinch started).\n      // If startZoom state is defined, then use the startZoom state;\n      // otherwise assume discrete zooming\n      startZoom = this.getViewportProps().zoom;\n      startZoomPosition = this._unproject(startPos) || this._unproject(pos);\n    }\n    if (!startZoomPosition) {\n      return this;\n    }\n    const newZoom = this._calculateNewZoom({scale, startZoom});\n    const zoomedViewport = this.makeViewport({...this.getViewportProps(), zoom: newZoom});\n\n    return this._getUpdatedState({\n      zoom: newZoom,\n      ...zoomedViewport.panByPosition(startZoomPosition, pos)\n    });\n  }\n\n  /**\n   * End zooming\n   * Must call if `zoomStart()` was called\n   */\n  zoomEnd(): OrbitState {\n    return this._getUpdatedState({\n      startZoomPosition: null,\n      startZoom: null\n    });\n  }\n\n  zoomIn(speed: number = 2): OrbitState {\n    return this._getUpdatedState({\n      zoom: this._calculateNewZoom({scale: speed})\n    });\n  }\n\n  zoomOut(speed: number = 2): OrbitState {\n    return this._getUpdatedState({\n      zoom: this._calculateNewZoom({scale: 1 / speed})\n    });\n  }\n\n  moveLeft(speed: number = 50): OrbitState {\n    return this._panFromCenter([-speed, 0]);\n  }\n\n  moveRight(speed: number = 50): OrbitState {\n    return this._panFromCenter([speed, 0]);\n  }\n\n  moveUp(speed: number = 50): OrbitState {\n    return this._panFromCenter([0, -speed]);\n  }\n\n  moveDown(speed: number = 50): OrbitState {\n    return this._panFromCenter([0, speed]);\n  }\n\n  rotateLeft(speed: number = 15): OrbitState {\n    return this._getUpdatedState({\n      rotationOrbit: this.getViewportProps().rotationOrbit - speed\n    });\n  }\n\n  rotateRight(speed: number = 15): OrbitState {\n    return this._getUpdatedState({\n      rotationOrbit: this.getViewportProps().rotationOrbit + speed\n    });\n  }\n\n  rotateUp(speed: number = 10): OrbitState {\n    return this._getUpdatedState({\n      rotationX: this.getViewportProps().rotationX - speed\n    });\n  }\n\n  rotateDown(speed: number = 10): OrbitState {\n    return this._getUpdatedState({\n      rotationX: this.getViewportProps().rotationX + speed\n    });\n  }\n\n  /* Private methods */\n\n  _unproject(pos?: number[]): number[] | undefined {\n    const viewport = this.makeViewport(this.getViewportProps());\n    // @ts-ignore\n    return pos && viewport.unproject(pos);\n  }\n\n  // Calculates new zoom\n  _calculateNewZoom({\n    scale,\n    startZoom\n  }: {\n    scale: number;\n    startZoom?: number | number[];\n  }): number | number[] {\n    const {maxZoom, minZoom} = this.getViewportProps();\n    if (startZoom === undefined) {\n      startZoom = this.getViewportProps().zoom;\n    }\n    const zoom = (startZoom as number) + Math.log2(scale);\n    return clamp(zoom, minZoom, maxZoom);\n  }\n\n  _panFromCenter(offset) {\n    const {width, height, target} = this.getViewportProps();\n    return this.pan({\n      startPosition: target,\n      pos: [width / 2 + offset[0], height / 2 + offset[1]]\n    });\n  }\n\n  _getUpdatedState(newProps): OrbitState {\n    // @ts-ignore\n    return new this.constructor({\n      makeViewport: this.makeViewport,\n      ...this.getViewportProps(),\n      ...this.getState(),\n      ...newProps\n    });\n  }\n\n  // Apply any constraints (mathematical or defined by _viewportProps) to map state\n  applyConstraints(props: Required<OrbitStateProps>): Required<OrbitStateProps> {\n    // Ensure zoom is within specified range\n    const {maxZoom, minZoom, zoom, maxRotationX, minRotationX, rotationOrbit} = props;\n\n    props.zoom = Array.isArray(zoom)\n      ? [clamp(zoom[0], minZoom, maxZoom), clamp(zoom[1], minZoom, maxZoom)]\n      : clamp(zoom, minZoom, maxZoom);\n\n    props.rotationX = clamp(props.rotationX, minRotationX, maxRotationX);\n    if (rotationOrbit < -180 || rotationOrbit > 180) {\n      props.rotationOrbit = mod(rotationOrbit + 180, 360) - 180;\n    }\n\n    return props;\n  }\n}\n\nexport default class OrbitController extends Controller<OrbitState> {\n  ControllerState = OrbitState;\n\n  transition = {\n    transitionDuration: 300,\n    transitionInterpolator: new LinearInterpolator({\n      transitionProps: {\n        compare: ['target', 'zoom', 'rotationX', 'rotationOrbit'],\n        required: ['target', 'zoom']\n      }\n    })\n  };\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n// Handles tesselation of polygons with holes\n// - 2D surfaces\n// - 2D outlines\n// - 3D surfaces (top and sides only)\n// - 3D wireframes (not yet)\nimport * as Polygon from './polygon';\nimport {Tesselator} from '@deck.gl/core';\nimport {cutPolygonByGrid, cutPolygonByMercatorBounds} from '@math.gl/polygon';\n\nimport type {\n  PolygonGeometry,\n  NormalizedPolygonGeometry,\n  FlatComplexPolygonGeometry\n} from './polygon';\nimport type {TypedArray} from '@math.gl/core';\n\ntype GeometryUpdateContext = {\n  vertexStart: number;\n  indexStart: number;\n  geometrySize: number;\n  geometryIndex: number;\n};\n\ntype CutPolygon = FlatComplexPolygonGeometry & {\n  edgeTypes: number[];\n};\n\n// This class is set up to allow querying one attribute at a time\n// the way the AttributeManager expects it\nexport default class PolygonTesselator extends Tesselator<\n  PolygonGeometry,\n  NormalizedPolygonGeometry | CutPolygon[],\n  {\n    fp64?: boolean;\n    IndexType?: Uint32ArrayConstructor | Uint16ArrayConstructor;\n    resolution?: number;\n    wrapLongitude?: boolean;\n    preproject?: (xy: number[]) => number[];\n    full3d?: boolean;\n  }\n> {\n  constructor(opts) {\n    const {fp64, IndexType = Uint32Array} = opts;\n    super({\n      ...opts,\n      attributes: {\n        positions: {size: 3, type: fp64 ? Float64Array : Float32Array},\n        vertexValid: {type: Uint8ClampedArray, size: 1},\n        indices: {type: IndexType, size: 1}\n      }\n    });\n  }\n\n  /** Get attribute by name */\n  get(attributeName: string): TypedArray | null {\n    const {attributes} = this;\n    if (attributeName === 'indices') {\n      return attributes.indices && attributes.indices.subarray(0, this.vertexCount);\n    }\n\n    return attributes[attributeName];\n  }\n\n  /** Override base Tesselator method */\n  updateGeometry(opts) {\n    super.updateGeometry(opts);\n\n    const externalIndices = this.buffers.indices;\n    if (externalIndices) {\n      // @ts-ignore (2339) value is not defined on TypedArray (fall through)\n      this.vertexCount = (externalIndices.value || externalIndices).length;\n    } else if (this.data && !this.getGeometry) {\n      throw new Error('missing indices buffer');\n    }\n  }\n\n  /** Implement base Tesselator interface */\n  protected normalizeGeometry(polygon: PolygonGeometry): NormalizedPolygonGeometry | CutPolygon[] {\n    if (this.normalize) {\n      const normalizedPolygon = Polygon.normalize(polygon, this.positionSize);\n      if (this.opts.resolution) {\n        return cutPolygonByGrid(\n          Polygon.getPositions(normalizedPolygon),\n          Polygon.getHoleIndices(normalizedPolygon),\n          {\n            size: this.positionSize,\n            gridResolution: this.opts.resolution,\n            edgeTypes: true\n          }\n        ) as CutPolygon[];\n      }\n      if (this.opts.wrapLongitude) {\n        return cutPolygonByMercatorBounds(\n          Polygon.getPositions(normalizedPolygon),\n          Polygon.getHoleIndices(normalizedPolygon),\n          {\n            size: this.positionSize,\n            maxLatitude: 86,\n            edgeTypes: true\n          }\n        ) as CutPolygon[];\n      }\n      return normalizedPolygon;\n    }\n    // normalize is explicitly set to false, assume that user passed in already normalized polygons\n    return polygon as NormalizedPolygonGeometry;\n  }\n\n  /** Implement base Tesselator interface */\n  protected getGeometrySize(polygon: NormalizedPolygonGeometry | CutPolygon[]): number {\n    if (isCut(polygon)) {\n      let size = 0;\n      for (const subPolygon of polygon) {\n        size += this.getGeometrySize(subPolygon);\n      }\n      return size;\n    }\n    return Polygon.getPositions(polygon).length / this.positionSize;\n  }\n\n  /** Override base Tesselator method */\n  protected getGeometryFromBuffer(buffer) {\n    if (this.normalize || !this.buffers.indices) {\n      return super.getGeometryFromBuffer(buffer);\n    }\n    // we don't need to read the positions if no normalization/tesselation\n    return null;\n  }\n\n  /** Implement base Tesselator interface */\n  protected updateGeometryAttributes(\n    polygon: NormalizedPolygonGeometry | CutPolygon[] | null,\n    context: GeometryUpdateContext\n  ) {\n    if (polygon && isCut(polygon)) {\n      for (const subPolygon of polygon) {\n        const geometrySize = this.getGeometrySize(subPolygon);\n        context.geometrySize = geometrySize;\n        this.updateGeometryAttributes(subPolygon, context);\n        context.vertexStart += geometrySize;\n        context.indexStart = this.indexStarts[context.geometryIndex + 1];\n      }\n    } else {\n      this._updateIndices(polygon, context);\n      this._updatePositions(polygon, context);\n      this._updateVertexValid(polygon, context);\n    }\n  }\n\n  // Flatten the indices array\n  private _updateIndices(\n    polygon: NormalizedPolygonGeometry | null,\n    {geometryIndex, vertexStart: offset, indexStart}: GeometryUpdateContext\n  ) {\n    const {attributes, indexStarts, typedArrayManager} = this;\n\n    let target = attributes.indices;\n    if (!target || !polygon) {\n      return;\n    }\n    let i = indexStart;\n\n    // 1. get triangulated indices for the internal areas\n    const indices = Polygon.getSurfaceIndices(\n      polygon,\n      this.positionSize,\n      this.opts.preproject,\n      this.opts.full3d\n    );\n\n    // make sure the buffer is large enough\n    target = typedArrayManager.allocate(target, indexStart + indices.length, {\n      copy: true\n    });\n\n    // 2. offset each index by the number of indices in previous polygons\n    for (let j = 0; j < indices.length; j++) {\n      target[i++] = indices[j] + offset;\n    }\n\n    indexStarts[geometryIndex + 1] = indexStart + indices.length;\n    attributes.indices = target;\n  }\n\n  // Flatten out all the vertices of all the sub subPolygons\n  private _updatePositions(\n    polygon: NormalizedPolygonGeometry | null,\n    {vertexStart, geometrySize}: GeometryUpdateContext\n  ) {\n    const {\n      attributes: {positions},\n      positionSize\n    } = this;\n    if (!positions || !polygon) {\n      return;\n    }\n    const polygonPositions = Polygon.getPositions(polygon);\n\n    for (let i = vertexStart, j = 0; j < geometrySize; i++, j++) {\n      const x = polygonPositions[j * positionSize];\n      const y = polygonPositions[j * positionSize + 1];\n      const z = positionSize > 2 ? polygonPositions[j * positionSize + 2] : 0;\n\n      positions[i * 3] = x;\n      positions[i * 3 + 1] = y;\n      positions[i * 3 + 2] = z;\n    }\n  }\n\n  private _updateVertexValid(\n    polygon: NormalizedPolygonGeometry | null,\n    {vertexStart, geometrySize}: GeometryUpdateContext\n  ) {\n    const {positionSize} = this;\n    const vertexValid = this.attributes.vertexValid as TypedArray;\n    const holeIndices = polygon && Polygon.getHoleIndices(polygon);\n    /* We are reusing the some buffer for `nextPositions` by offseting one vertex\n     * to the left. As a result,\n     * the last vertex of each ring overlaps with the first vertex of the next ring.\n     * `vertexValid` is used to mark the end of each ring so we don't draw these\n     * segments:\n      positions      A0 A1 A2 A3 A4 B0 B1 B2 C0 ...\n      nextPositions  A1 A2 A3 A4 B0 B1 B2 C0 C1 ...\n      vertexValid    1  1  1  1  0  1  1  0  1 ...\n     */\n    if (polygon && (polygon as CutPolygon).edgeTypes) {\n      vertexValid.set((polygon as CutPolygon).edgeTypes, vertexStart);\n    } else {\n      vertexValid.fill(1, vertexStart, vertexStart + geometrySize);\n    }\n    if (holeIndices) {\n      for (let j = 0; j < holeIndices.length; j++) {\n        vertexValid[vertexStart + holeIndices[j] / positionSize - 1] = 0;\n      }\n    }\n    vertexValid[vertexStart + geometrySize - 1] = 0;\n  }\n}\n\nfunction isCut(polygon: NormalizedPolygonGeometry | CutPolygon[]): polygon is CutPolygon[] {\n  return Array.isArray(polygon) && polygon.length > 0 && !Number.isFinite(polygon[0]);\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n\nattribute vec2 vertexPositions;\nattribute float vertexValid;\n\nuniform bool extruded;\nuniform bool isWireframe;\nuniform float elevationScale;\nuniform float opacity;\n\nvarying vec4 vColor;\n\nstruct PolygonProps {\n  vec4 fillColors;\n  vec4 lineColors;\n  vec3 positions;\n  vec3 nextPositions;\n  vec3 pickingColors;\n  vec3 positions64Low;\n  vec3 nextPositions64Low;\n  float elevations;\n};\n\nvec3 project_offset_normal(vec3 vector) {\n  if (project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT ||\n    project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT_OFFSETS) {\n    // normals generated by the polygon tesselator are in lnglat offsets instead of meters\n    return normalize(vector * project_uCommonUnitsPerWorldUnit);\n  }\n  return project_normal(vector);\n}\n\nvoid calculatePosition(PolygonProps props) {\n#ifdef IS_SIDE_VERTEX\n  if(vertexValid < 0.5){\n    gl_Position = vec4(0.);\n    return;\n  }\n#endif\n\n  vec3 pos;\n  vec3 pos64Low;\n  vec3 normal;\n  vec4 colors = isWireframe ? props.lineColors : props.fillColors;\n\n  geometry.worldPosition = props.positions;\n  geometry.worldPositionAlt = props.nextPositions;\n  geometry.pickingColor = props.pickingColors;\n\n#ifdef IS_SIDE_VERTEX\n  pos = mix(props.positions, props.nextPositions, vertexPositions.x);\n  pos64Low = mix(props.positions64Low, props.nextPositions64Low, vertexPositions.x);\n#else\n  pos = props.positions;\n  pos64Low = props.positions64Low;\n#endif\n\n  if (extruded) {\n    pos.z += props.elevations * vertexPositions.y * elevationScale;\n  }\n  gl_Position = project_position_to_clipspace(pos, pos64Low, vec3(0.), geometry.position);\n\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  if (extruded) {\n  #ifdef IS_SIDE_VERTEX\n    normal = vec3(\n      props.positions.y - props.nextPositions.y + (props.positions64Low.y - props.nextPositions64Low.y),\n      props.nextPositions.x - props.positions.x + (props.nextPositions64Low.x - props.positions64Low.x),\n      0.0);\n    normal = project_offset_normal(normal);\n  #else\n    normal = project_normal(vec3(0.0, 0.0, 1.0));\n  #endif\n    geometry.normal = normal;\n    vec3 lightColor = lighting_getLightColor(colors.rgb, project_uCameraPosition, geometry.position.xyz, normal);\n    vColor = vec4(lightColor, colors.a * opacity);\n  } else {\n    vColor = vec4(colors.rgb, colors.a * opacity);\n  }\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport main from './solid-polygon-layer-vertex-main.glsl';\n\nexport default `\\\n#define SHADER_NAME solid-polygon-layer-vertex-shader\n\nattribute vec3 positions;\nattribute vec3 positions64Low;\nattribute float elevations;\nattribute vec4 fillColors;\nattribute vec4 lineColors;\nattribute vec3 pickingColors;\n\n${main}\n\nvoid main(void) {\n  PolygonProps props;\n\n  props.positions = positions;\n  props.positions64Low = positions64Low;\n  props.elevations = elevations;\n  props.fillColors = fillColors;\n  props.lineColors = lineColors;\n  props.pickingColors = pickingColors;\n\n  calculatePosition(props);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport main from './solid-polygon-layer-vertex-main.glsl';\n\nexport default `\\\n#define SHADER_NAME solid-polygon-layer-vertex-shader-side\n#define IS_SIDE_VERTEX\n\n\nattribute vec3 instancePositions;\nattribute vec3 nextPositions;\nattribute vec3 instancePositions64Low;\nattribute vec3 nextPositions64Low;\nattribute float instanceElevations;\nattribute vec4 instanceFillColors;\nattribute vec4 instanceLineColors;\nattribute vec3 instancePickingColors;\n\n${main}\n\nvoid main(void) {\n  PolygonProps props;\n\n  #if RING_WINDING_ORDER_CW == 1\n    props.positions = instancePositions;\n    props.positions64Low = instancePositions64Low;\n    props.nextPositions = nextPositions;\n    props.nextPositions64Low = nextPositions64Low;\n  #else\n    props.positions = nextPositions;\n    props.positions64Low = nextPositions64Low;\n    props.nextPositions = instancePositions;\n    props.nextPositions64Low = instancePositions64Low;\n  #endif\n  props.elevations = instanceElevations;\n  props.fillColors = instanceFillColors;\n  props.lineColors = instanceLineColors;\n  props.pickingColors = instancePickingColors;\n\n  calculatePosition(props);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {Layer, project32, gouraudLighting, picking, COORDINATE_SYSTEM} from '@deck.gl/core';\nimport GL from '@luma.gl/constants';\nimport {Model, Geometry, hasFeatures, FEATURES} from '@luma.gl/core';\n\n// Polygon geometry generation is managed by the polygon tesselator\nimport PolygonTesselator from './polygon-tesselator';\n\nimport vsTop from './solid-polygon-layer-vertex-top.glsl';\nimport vsSide from './solid-polygon-layer-vertex-side.glsl';\nimport fs from './solid-polygon-layer-fragment.glsl';\n\nimport type {\n  LayerProps,\n  Color,\n  Material,\n  Accessor,\n  AccessorFunction,\n  UpdateParameters,\n  GetPickingInfoParams,\n  PickingInfo,\n  DefaultProps\n} from '@deck.gl/core';\nimport type {PolygonGeometry} from './polygon';\n\ntype _SolidPolygonLayerProps<DataT> = {\n  /** Whether to fill the polygons\n   * @default true\n   */\n  filled?: boolean;\n  /** Whether to extrude the polygons\n   * @default false\n   */\n  extruded?: boolean;\n  /** Whether to generate a line wireframe of the polygon.\n   * @default false\n   */\n  wireframe?: boolean;\n  /**\n   * (Experimental) If `false`, will skip normalizing the coordinates returned by `getPolygon`.\n   * @default true\n   */\n  _normalize?: boolean;\n  /**\n   * (Experimental) This prop is only effective with `_normalize: false`.\n   * It specifies the winding order of rings in the polygon data, one of 'CW' (clockwise) and 'CCW' (counter-clockwise)\n   */\n  _windingOrder?: 'CW' | 'CCW';\n\n  /**\n   * (Experimental) This prop is only effective with `XYZ` data.\n   * When true, polygon tesselation will be performed on the plane with the largest area, instead of the xy plane.\n   * @default false\n   */\n  _full3d?: boolean;\n\n  /** Elevation multiplier.\n   * @default 1\n   */\n  elevationScale?: number;\n\n  /** Polygon geometry accessor. */\n  getPolygon?: AccessorFunction<DataT, PolygonGeometry>;\n  /** Extrusion height accessor.\n   * @default 1000\n   */\n  getElevation?: Accessor<DataT, number>;\n  /** Fill color accessor.\n   * @default [0, 0, 0, 255]\n   */\n  getFillColor?: Accessor<DataT, Color>;\n  /** Stroke color accessor.\n   * @default [0, 0, 0, 255]\n   */\n  getLineColor?: Accessor<DataT, Color>;\n\n  /**\n   * Material settings for lighting effect. Applies if `extruded: true`\n   *\n   * @default true\n   * @see https://deck.gl/docs/developer-guide/using-lighting\n   */\n  material?: Material;\n};\n\n/** Render filled and/or extruded polygons. */\nexport type SolidPolygonLayerProps<DataT = any> = _SolidPolygonLayerProps<DataT> &\n  LayerProps<DataT>;\n\nconst DEFAULT_COLOR: [number, number, number, number] = [0, 0, 0, 255];\n\nconst defaultProps: DefaultProps<SolidPolygonLayerProps> = {\n  filled: true,\n  extruded: false,\n  wireframe: false,\n  _normalize: true,\n  _windingOrder: 'CW',\n  _full3d: false,\n\n  elevationScale: {type: 'number', min: 0, value: 1},\n\n  getPolygon: {type: 'accessor', value: f => f.polygon},\n  getElevation: {type: 'accessor', value: 1000},\n  getFillColor: {type: 'accessor', value: DEFAULT_COLOR},\n  getLineColor: {type: 'accessor', value: DEFAULT_COLOR},\n\n  material: true\n};\n\nconst ATTRIBUTE_TRANSITION = {\n  enter: (value, chunk) => {\n    return chunk.length ? chunk.subarray(chunk.length - value.length) : value;\n  }\n};\n\nexport default class SolidPolygonLayer<DataT = any, ExtraPropsT = {}> extends Layer<\n  ExtraPropsT & Required<_SolidPolygonLayerProps<DataT>>\n> {\n  static defaultProps = defaultProps;\n  static layerName = 'SolidPolygonLayer';\n\n  state!: {\n    topModel?: Model;\n    sideModel?: Model;\n    models?: Model[];\n    numInstances: number;\n    polygonTesselator: PolygonTesselator;\n  };\n\n  getShaders(type) {\n    return super.getShaders({\n      vs: type === 'top' ? vsTop : vsSide,\n      fs,\n      defines: {\n        RING_WINDING_ORDER_CW: !this.props._normalize && this.props._windingOrder === 'CCW' ? 0 : 1\n      },\n      modules: [project32, gouraudLighting, picking]\n    });\n  }\n\n  get wrapLongitude(): boolean {\n    return false;\n  }\n\n  initializeState() {\n    const {gl, viewport} = this.context;\n    let {coordinateSystem} = this.props;\n    const {_full3d} = this.props;\n    if (viewport.isGeospatial && coordinateSystem === COORDINATE_SYSTEM.DEFAULT) {\n      coordinateSystem = COORDINATE_SYSTEM.LNGLAT;\n    }\n\n    let preproject: ((xy: number[]) => number[]) | undefined;\n\n    if (coordinateSystem === COORDINATE_SYSTEM.LNGLAT) {\n      if (_full3d) {\n        preproject = viewport.projectPosition.bind(viewport);\n      } else {\n        preproject = viewport.projectFlat.bind(viewport);\n      }\n    }\n\n    this.setState({\n      numInstances: 0,\n      polygonTesselator: new PolygonTesselator({\n        // Lnglat coordinates are usually projected non-linearly, which affects tesselation results\n        // Provide a preproject function if the coordinates are in lnglat\n        preproject,\n        fp64: this.use64bitPositions(),\n        IndexType: !gl || hasFeatures(gl, FEATURES.ELEMENT_INDEX_UINT32) ? Uint32Array : Uint16Array\n      })\n    });\n\n    const attributeManager = this.getAttributeManager()!;\n    const noAlloc = true;\n\n    attributeManager.remove(['instancePickingColors']);\n\n    /* eslint-disable max-len */\n    attributeManager.add({\n      indices: {\n        size: 1,\n        isIndexed: true,\n        // eslint-disable-next-line @typescript-eslint/unbound-method\n        update: this.calculateIndices,\n        noAlloc\n      },\n      positions: {\n        size: 3,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        transition: ATTRIBUTE_TRANSITION,\n        accessor: 'getPolygon',\n        // eslint-disable-next-line @typescript-eslint/unbound-method\n        update: this.calculatePositions,\n        noAlloc,\n        shaderAttributes: {\n          positions: {\n            vertexOffset: 0,\n            divisor: 0\n          },\n          instancePositions: {\n            vertexOffset: 0,\n            divisor: 1\n          },\n          nextPositions: {\n            vertexOffset: 1,\n            divisor: 1\n          }\n        }\n      },\n      vertexValid: {\n        size: 1,\n        divisor: 1,\n        type: GL.UNSIGNED_BYTE,\n        // eslint-disable-next-line @typescript-eslint/unbound-method\n        update: this.calculateVertexValid,\n        noAlloc\n      },\n      elevations: {\n        size: 1,\n        transition: ATTRIBUTE_TRANSITION,\n        accessor: 'getElevation',\n        shaderAttributes: {\n          elevations: {\n            divisor: 0\n          },\n          instanceElevations: {\n            divisor: 1\n          }\n        }\n      },\n      fillColors: {\n        size: this.props.colorFormat.length,\n        type: GL.UNSIGNED_BYTE,\n        normalized: true,\n        transition: ATTRIBUTE_TRANSITION,\n        accessor: 'getFillColor',\n        defaultValue: DEFAULT_COLOR,\n        shaderAttributes: {\n          fillColors: {\n            divisor: 0\n          },\n          instanceFillColors: {\n            divisor: 1\n          }\n        }\n      },\n      lineColors: {\n        size: this.props.colorFormat.length,\n        type: GL.UNSIGNED_BYTE,\n        normalized: true,\n        transition: ATTRIBUTE_TRANSITION,\n        accessor: 'getLineColor',\n        defaultValue: DEFAULT_COLOR,\n        shaderAttributes: {\n          lineColors: {\n            divisor: 0\n          },\n          instanceLineColors: {\n            divisor: 1\n          }\n        }\n      },\n      pickingColors: {\n        size: 3,\n        type: GL.UNSIGNED_BYTE,\n        accessor: (object, {index, target: value}) =>\n          this.encodePickingColor(object && object.__source ? object.__source.index : index, value),\n        shaderAttributes: {\n          pickingColors: {\n            divisor: 0\n          },\n          instancePickingColors: {\n            divisor: 1\n          }\n        }\n      }\n    });\n    /* eslint-enable max-len */\n  }\n\n  getPickingInfo(params: GetPickingInfoParams): PickingInfo {\n    const info = super.getPickingInfo(params);\n    const {index} = info;\n    const {data} = this.props;\n\n    // Check if data comes from a composite layer, wrapped with getSubLayerRow\n    if (data[0] && data[0].__source) {\n      // index decoded from picking color refers to the source index\n      info.object = (data as any[]).find(d => d.__source.index === index);\n    }\n    return info;\n  }\n\n  disablePickingIndex(objectIndex: number) {\n    const {data} = this.props;\n\n    // Check if data comes from a composite layer, wrapped with getSubLayerRow\n    if (data[0] && data[0].__source) {\n      // index decoded from picking color refers to the source index\n      for (let i = 0; i < (data as any[]).length; i++) {\n        if (data[i].__source.index === objectIndex) {\n          this._disablePickingIndex(i);\n        }\n      }\n    } else {\n      this._disablePickingIndex(objectIndex);\n    }\n  }\n\n  draw({uniforms}) {\n    const {extruded, filled, wireframe, elevationScale} = this.props;\n    const {topModel, sideModel, polygonTesselator} = this.state;\n\n    const renderUniforms = {\n      ...uniforms,\n      extruded: Boolean(extruded),\n      elevationScale\n    };\n\n    // Note: the order is important\n    if (sideModel) {\n      sideModel.setInstanceCount(polygonTesselator.instanceCount - 1);\n      sideModel.setUniforms(renderUniforms);\n      if (wireframe) {\n        sideModel.setDrawMode(GL.LINE_STRIP);\n        sideModel.setUniforms({isWireframe: true}).draw();\n      }\n      if (filled) {\n        sideModel.setDrawMode(GL.TRIANGLE_FAN);\n        sideModel.setUniforms({isWireframe: false}).draw();\n      }\n    }\n\n    if (topModel) {\n      topModel.setVertexCount(polygonTesselator.vertexCount);\n      topModel.setUniforms(renderUniforms).draw();\n    }\n  }\n\n  updateState(updateParams: UpdateParameters<this>) {\n    super.updateState(updateParams);\n\n    this.updateGeometry(updateParams);\n\n    const {props, oldProps, changeFlags} = updateParams;\n    const attributeManager = this.getAttributeManager();\n\n    const regenerateModels =\n      changeFlags.extensionsChanged ||\n      props.filled !== oldProps.filled ||\n      props.extruded !== oldProps.extruded;\n\n    if (regenerateModels) {\n      this.state.models?.forEach(model => model.delete());\n\n      this.setState(this._getModels(this.context.gl));\n      attributeManager!.invalidateAll();\n    }\n  }\n\n  protected updateGeometry({props, oldProps, changeFlags}: UpdateParameters<this>) {\n    const geometryConfigChanged =\n      changeFlags.dataChanged ||\n      (changeFlags.updateTriggersChanged &&\n        (changeFlags.updateTriggersChanged.all || changeFlags.updateTriggersChanged.getPolygon));\n\n    // When the geometry config  or the data is changed,\n    // tessellator needs to be invoked\n    if (geometryConfigChanged) {\n      const {polygonTesselator} = this.state;\n      const buffers = (props.data as any).attributes || {};\n      polygonTesselator.updateGeometry({\n        data: props.data,\n        normalize: props._normalize,\n        geometryBuffer: buffers.getPolygon,\n        buffers,\n        getGeometry: props.getPolygon,\n        positionFormat: props.positionFormat,\n        wrapLongitude: props.wrapLongitude,\n        // TODO - move the flag out of the viewport\n        resolution: this.context.viewport.resolution,\n        fp64: this.use64bitPositions(),\n        dataChanged: changeFlags.dataChanged,\n        full3d: props._full3d\n      });\n\n      this.setState({\n        numInstances: polygonTesselator.instanceCount,\n        startIndices: polygonTesselator.vertexStarts\n      });\n\n      if (!changeFlags.dataChanged) {\n        // Base `layer.updateState` only invalidates all attributes on data change\n        // Cover the rest of the scenarios here\n        this.getAttributeManager()!.invalidateAll();\n      }\n    }\n  }\n\n  protected _getModels(gl: WebGLRenderingContext): Model {\n    const {id, filled, extruded} = this.props;\n\n    let topModel;\n    let sideModel;\n\n    if (filled) {\n      const shaders = this.getShaders('top');\n      shaders.defines.NON_INSTANCED_MODEL = 1;\n\n      topModel = new Model(gl, {\n        ...shaders,\n        id: `${id}-top`,\n        drawMode: GL.TRIANGLES,\n        attributes: {\n          vertexPositions: new Float32Array([0, 1])\n        },\n        uniforms: {\n          isWireframe: false,\n          isSideVertex: false\n        },\n        vertexCount: 0,\n        isIndexed: true\n      });\n    }\n    if (extruded) {\n      sideModel = new Model(gl, {\n        ...this.getShaders('side'),\n        id: `${id}-side`,\n        geometry: new Geometry({\n          drawMode: GL.LINES,\n          vertexCount: 4,\n          attributes: {\n            // top right - top left - bootom left - bottom right\n            vertexPositions: {\n              size: 2,\n              value: new Float32Array([1, 0, 0, 0, 0, 1, 1, 1])\n            }\n          }\n        }),\n        instanceCount: 0,\n        isInstanced: 1\n      });\n\n      sideModel.userData.excludeAttributes = {indices: true};\n    }\n\n    return {\n      models: [sideModel, topModel].filter(Boolean),\n      topModel,\n      sideModel\n    };\n  }\n\n  protected calculateIndices(attribute) {\n    const {polygonTesselator} = this.state;\n    attribute.startIndices = polygonTesselator.indexStarts;\n    attribute.value = polygonTesselator.get('indices');\n  }\n\n  protected calculatePositions(attribute) {\n    const {polygonTesselator} = this.state;\n    attribute.startIndices = polygonTesselator.vertexStarts;\n    attribute.value = polygonTesselator.get('positions');\n  }\n\n  protected calculateVertexValid(attribute) {\n    attribute.value = this.state.polygonTesselator.get('vertexValid');\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME solid-polygon-layer-fragment-shader\n\nprecision highp float;\n\nvarying vec4 vColor;\n\nvoid main(void) {\n  gl_FragColor = vColor;\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\nimport {Tesselator} from '@deck.gl/core';\nimport {normalizePath} from './path';\n\nimport type {TypedArray} from '@math.gl/core';\nimport type {PathGeometry, FlatPathGeometry, NormalizedPathGeometry} from './path';\n\nconst START_CAP = 1;\nconst END_CAP = 2;\nconst INVALID = 4;\n\n// This class is set up to allow querying one attribute at a time\n// the way the AttributeManager expects it\nexport default class PathTesselator extends Tesselator<\n  PathGeometry,\n  NormalizedPathGeometry,\n  {\n    fp64?: boolean;\n    resolution?: number;\n    wrapLongitude?: boolean;\n    loop?: boolean;\n  }\n> {\n  constructor(opts) {\n    super({\n      ...opts,\n      attributes: {\n        // Padding covers shaderAttributes for last segment in largest case fp64\n        // additional vertex + hi & low parts, 3 * 6\n        positions: {\n          size: 3,\n          padding: 18,\n          initialize: true,\n          type: opts.fp64 ? Float64Array : Float32Array\n        },\n        segmentTypes: {size: 1, type: Uint8ClampedArray}\n      }\n    });\n  }\n\n  /** Get packed attribute by name */\n  get(attributeName: string): TypedArray | null {\n    return this.attributes[attributeName];\n  }\n\n  /* Implement base Tesselator interface */\n  protected getGeometryFromBuffer(buffer) {\n    if (this.normalize) {\n      return super.getGeometryFromBuffer(buffer);\n    }\n    // we don't need to read the positions if no normalization\n    return null;\n  }\n\n  /* Implement base Tesselator interface */\n  protected normalizeGeometry(path: PathGeometry): number[][] | PathGeometry {\n    if (this.normalize) {\n      return normalizePath(path, this.positionSize, this.opts.resolution, this.opts.wrapLongitude);\n    }\n    return path;\n  }\n\n  /* Implement base Tesselator interface */\n  protected getGeometrySize(path: NormalizedPathGeometry): number {\n    if (isCut(path)) {\n      let size = 0;\n      for (const subPath of path) {\n        size += this.getGeometrySize(subPath);\n      }\n      return size;\n    }\n    const numPoints = this.getPathLength(path);\n    if (numPoints < 2) {\n      // invalid path\n      return 0;\n    }\n    if (this.isClosed(path)) {\n      // minimum 3 vertices\n      return numPoints < 3 ? 0 : numPoints + 2;\n    }\n    return numPoints;\n  }\n\n  /* Implement base Tesselator interface */\n  protected updateGeometryAttributes(\n    path: NormalizedPathGeometry | null,\n    context: {\n      vertexStart: number;\n      geometrySize: number;\n    }\n  ): void {\n    if (context.geometrySize === 0) {\n      return;\n    }\n    if (path && isCut(path)) {\n      for (const subPath of path) {\n        const geometrySize = this.getGeometrySize(subPath);\n        context.geometrySize = geometrySize;\n        this.updateGeometryAttributes(subPath, context);\n        context.vertexStart += geometrySize;\n      }\n    } else {\n      this._updateSegmentTypes(path, context);\n      this._updatePositions(path, context);\n    }\n  }\n\n  private _updateSegmentTypes(\n    path: FlatPathGeometry | null,\n    context: {\n      vertexStart: number;\n      geometrySize: number;\n    }\n  ) {\n    const segmentTypes = this.attributes.segmentTypes as TypedArray;\n    const isPathClosed = path ? this.isClosed(path) : false;\n    const {vertexStart, geometrySize} = context;\n\n    // positions   --  A0 A1 B0 B1 B2 B3 B0 B1 B2 --\n    // segmentTypes     3  4  4  0  0  0  0  4  4\n    segmentTypes.fill(0, vertexStart, vertexStart + geometrySize);\n    if (isPathClosed) {\n      segmentTypes[vertexStart] = INVALID;\n      segmentTypes[vertexStart + geometrySize - 2] = INVALID;\n    } else {\n      segmentTypes[vertexStart] += START_CAP;\n      segmentTypes[vertexStart + geometrySize - 2] += END_CAP;\n    }\n    segmentTypes[vertexStart + geometrySize - 1] = INVALID;\n  }\n\n  private _updatePositions(\n    path: FlatPathGeometry | null,\n    context: {\n      vertexStart: number;\n      geometrySize: number;\n    }\n  ) {\n    const {positions} = this.attributes;\n    if (!positions || !path) {\n      return;\n    }\n    const {vertexStart, geometrySize} = context;\n    const p = new Array(3);\n\n    // positions   --  A0 A1 B0 B1 B2 B3 B0 B1 B2 --\n    // segmentTypes     3  4  4  0  0  0  0  4  4\n    for (let i = vertexStart, ptIndex = 0; ptIndex < geometrySize; i++, ptIndex++) {\n      this.getPointOnPath(path, ptIndex, p);\n      positions[i * 3] = p[0];\n      positions[i * 3 + 1] = p[1];\n      positions[i * 3 + 2] = p[2];\n    }\n  }\n\n  // Utilities\n  /** Returns the number of points in the path */\n  private getPathLength(path: FlatPathGeometry): number {\n    return path.length / this.positionSize;\n  }\n\n  /** Returns a point on the path at the specified index */\n  private getPointOnPath(path: FlatPathGeometry, index: number, target: number[] = []): number[] {\n    const {positionSize} = this;\n    if (index * positionSize >= path.length) {\n      // loop\n      index += 1 - path.length / positionSize;\n    }\n    const i = index * positionSize;\n    target[0] = path[i];\n    target[1] = path[i + 1];\n    target[2] = (positionSize === 3 && path[i + 2]) || 0;\n    return target;\n  }\n\n  // Returns true if the first and last points are identical\n  private isClosed(path: FlatPathGeometry): boolean {\n    if (!this.normalize) {\n      return Boolean(this.opts.loop);\n    }\n    const {positionSize} = this;\n    const lastPointIndex = path.length - positionSize;\n    return (\n      path[0] === path[lastPointIndex] &&\n      path[1] === path[lastPointIndex + 1] &&\n      (positionSize === 2 || path[2] === path[lastPointIndex + 2])\n    );\n  }\n}\n\nfunction isCut(path: NormalizedPathGeometry): path is FlatPathGeometry[] {\n  return Array.isArray(path[0]);\n}\n","import {cutPolylineByGrid, cutPolylineByMercatorBounds} from '@math.gl/polygon';\n\nimport type {NumericArray} from '@math.gl/core';\nimport type {Position} from '@deck.gl/core';\n\nexport type NestedPathGeometry = Position[];\nexport type FlatPathGeometry = NumericArray;\nexport type PathGeometry = NestedPathGeometry | FlatPathGeometry;\nexport type NormalizedPathGeometry = FlatPathGeometry[] | FlatPathGeometry;\n\n/**\n * Flattens a nested path object\n * Cut the feature if needed (globe projection, wrap longitude, etc.)\n * Returns a flat array of path positions, or a list of flat arrays representing multiple paths\n */\nexport function normalizePath(\n  path: PathGeometry,\n  size: number,\n  gridResolution?: number,\n  wrapLongitude?: boolean\n): number[][] | NumericArray {\n  let flatPath: NumericArray;\n  if (Array.isArray(path[0])) {\n    const length = path.length * size;\n    flatPath = new Array(length);\n    for (let i = 0; i < path.length; i++) {\n      for (let j = 0; j < size; j++) {\n        flatPath[i * size + j] = path[i][j] || 0;\n      }\n    }\n  } else {\n    flatPath = path as NumericArray;\n  }\n  if (gridResolution) {\n    return cutPolylineByGrid(flatPath, {size, gridResolution});\n  }\n  if (wrapLongitude) {\n    return cutPolylineByMercatorBounds(flatPath, {size});\n  }\n  return flatPath;\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {Layer, project32, picking, UNIT} from '@deck.gl/core';\nimport GL from '@luma.gl/constants';\nimport {Model, Geometry} from '@luma.gl/core';\nimport PathTesselator from './path-tesselator';\n\nimport vs from './path-layer-vertex.glsl';\nimport fs from './path-layer-fragment.glsl';\n\nimport type {\n  LayerProps,\n  Color,\n  Accessor,\n  AccessorFunction,\n  Unit,\n  UpdateParameters,\n  GetPickingInfoParams,\n  PickingInfo,\n  DefaultProps\n} from '@deck.gl/core';\nimport type {PathGeometry} from './path';\n\ntype _PathLayerProps<DataT> = {\n  /** The units of the line width, one of `'meters'`, `'common'`, and `'pixels'`\n   * @default 'meters'\n   */\n  widthUnits?: Unit;\n  /**\n   * Path width multiplier.\n   * @default 1\n   */\n  widthScale?: number;\n  /**\n   * The minimum path width in pixels. This prop can be used to prevent the path from getting too thin when zoomed out.\n   * @default 0\n   */\n  widthMinPixels?: number;\n  /**\n   * The maximum path width in pixels. This prop can be used to prevent the path from getting too thick when zoomed in.\n   * @default Number.MAX_SAFE_INTEGER\n   */\n  widthMaxPixels?: number;\n  /**\n   * Type of joint. If `true`, draw round joints. Otherwise draw miter joints.\n   * @default false\n   */\n  jointRounded?: boolean;\n  /**\n   * Type of caps. If `true`, draw round caps. Otherwise draw square caps.\n   * @default false\n   */\n  capRounded?: boolean;\n  /**\n   * The maximum extent of a joint in ratio to the stroke width. Only works if `jointRounded` is `false`.\n   * @default 4\n   */\n  miterLimit?: number;\n  /**\n   * If `true`, extrude the path in screen space (width always faces the camera).\n   * If `false`, the width always faces up (z).\n   * @default false\n   */\n  billboard?: boolean;\n  /**\n   * (Experimental) If `'loop'` or `'open'`, will skip normalizing the coordinates returned by `getPath` and instead assume all paths are to be loops or open paths.\n   * When normalization is disabled, paths must be specified in the format of flat array. Open paths must contain at least 2 vertices and closed paths must contain at least 3 vertices.\n   * @default null\n   */\n  _pathType?: null | 'loop' | 'open';\n  /**\n   * Path geometry accessor.\n   */\n  getPath?: AccessorFunction<DataT, PathGeometry>;\n  /**\n   * Path color accessor.\n   * @default [0, 0, 0, 255]\n   */\n  getColor?: Accessor<DataT, Color | Color[]>;\n  /**\n   * Path width accessor.\n   * @default 1\n   */\n  getWidth?: Accessor<DataT, number | number[]>;\n  /**\n   * @deprecated Use `jointRounded` and `capRounded` instead\n   */\n  rounded?: boolean;\n};\n\nexport type PathLayerProps<DataT = any> = _PathLayerProps<DataT> & LayerProps<DataT>;\n\nconst DEFAULT_COLOR: [number, number, number, number] = [0, 0, 0, 255];\n\nconst defaultProps: DefaultProps<PathLayerProps> = {\n  widthUnits: 'meters',\n  widthScale: {type: 'number', min: 0, value: 1},\n  widthMinPixels: {type: 'number', min: 0, value: 0},\n  widthMaxPixels: {type: 'number', min: 0, value: Number.MAX_SAFE_INTEGER},\n  jointRounded: false,\n  capRounded: false,\n  miterLimit: {type: 'number', min: 0, value: 4},\n  billboard: false,\n  _pathType: null,\n\n  getPath: {type: 'accessor', value: object => object.path},\n  getColor: {type: 'accessor', value: DEFAULT_COLOR},\n  getWidth: {type: 'accessor', value: 1},\n\n  // deprecated props\n  rounded: {deprecatedFor: ['jointRounded', 'capRounded']}\n};\n\nconst ATTRIBUTE_TRANSITION = {\n  enter: (value, chunk) => {\n    return chunk.length ? chunk.subarray(chunk.length - value.length) : value;\n  }\n};\n\n/** Render lists of coordinate points as extruded polylines with mitering. */\nexport default class PathLayer<DataT = any, ExtraPropsT = {}> extends Layer<\n  ExtraPropsT & Required<_PathLayerProps<DataT>>\n> {\n  static defaultProps = defaultProps;\n  static layerName = 'PathLayer';\n\n  state!: {\n    model?: Model;\n    pathTesselator: PathTesselator;\n  };\n\n  getShaders() {\n    return super.getShaders({vs, fs, modules: [project32, picking]}); // 'project' module added by default.\n  }\n\n  get wrapLongitude(): boolean {\n    return false;\n  }\n\n  initializeState() {\n    const noAlloc = true;\n    const attributeManager = this.getAttributeManager();\n    /* eslint-disable max-len */\n    attributeManager!.addInstanced({\n      positions: {\n        size: 3,\n        // Start filling buffer from 1 vertex in\n        vertexOffset: 1,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        transition: ATTRIBUTE_TRANSITION,\n        accessor: 'getPath',\n        // eslint-disable-next-line @typescript-eslint/unbound-method\n        update: this.calculatePositions,\n        noAlloc,\n        shaderAttributes: {\n          instanceLeftPositions: {\n            vertexOffset: 0\n          },\n          instanceStartPositions: {\n            vertexOffset: 1\n          },\n          instanceEndPositions: {\n            vertexOffset: 2\n          },\n          instanceRightPositions: {\n            vertexOffset: 3\n          }\n        }\n      },\n      instanceTypes: {\n        size: 1,\n        type: GL.UNSIGNED_BYTE,\n        // eslint-disable-next-line @typescript-eslint/unbound-method\n        update: this.calculateSegmentTypes,\n        noAlloc\n      },\n      instanceStrokeWidths: {\n        size: 1,\n        accessor: 'getWidth',\n        transition: ATTRIBUTE_TRANSITION,\n        defaultValue: 1\n      },\n      instanceColors: {\n        size: this.props.colorFormat.length,\n        type: GL.UNSIGNED_BYTE,\n        normalized: true,\n        accessor: 'getColor',\n        transition: ATTRIBUTE_TRANSITION,\n        defaultValue: DEFAULT_COLOR\n      },\n      instancePickingColors: {\n        size: 3,\n        type: GL.UNSIGNED_BYTE,\n        accessor: (object, {index, target: value}) =>\n          this.encodePickingColor(object && object.__source ? object.__source.index : index, value)\n      }\n    });\n    /* eslint-enable max-len */\n\n    this.setState({\n      pathTesselator: new PathTesselator({\n        fp64: this.use64bitPositions()\n      })\n    });\n  }\n\n  updateState(params: UpdateParameters<this>) {\n    super.updateState(params);\n    const {props, changeFlags} = params;\n\n    const attributeManager = this.getAttributeManager();\n\n    const geometryChanged =\n      changeFlags.dataChanged ||\n      (changeFlags.updateTriggersChanged &&\n        (changeFlags.updateTriggersChanged.all || changeFlags.updateTriggersChanged.getPath));\n\n    if (geometryChanged) {\n      const {pathTesselator} = this.state;\n      const buffers = (props.data as any).attributes || {};\n\n      pathTesselator.updateGeometry({\n        data: props.data,\n        geometryBuffer: buffers.getPath,\n        buffers,\n        normalize: !props._pathType,\n        loop: props._pathType === 'loop',\n        getGeometry: props.getPath,\n        positionFormat: props.positionFormat,\n        wrapLongitude: props.wrapLongitude,\n        // TODO - move the flag out of the viewport\n        resolution: this.context.viewport.resolution,\n        dataChanged: changeFlags.dataChanged\n      });\n      this.setState({\n        numInstances: pathTesselator.instanceCount,\n        startIndices: pathTesselator.vertexStarts\n      });\n      if (!changeFlags.dataChanged) {\n        // Base `layer.updateState` only invalidates all attributes on data change\n        // Cover the rest of the scenarios here\n        attributeManager!.invalidateAll();\n      }\n    }\n\n    if (changeFlags.extensionsChanged) {\n      const {gl} = this.context;\n      this.state.model?.delete();\n      this.state.model = this._getModel(gl);\n      attributeManager!.invalidateAll();\n    }\n  }\n\n  getPickingInfo(params: GetPickingInfoParams): PickingInfo {\n    const info = super.getPickingInfo(params);\n    const {index} = info;\n    const {data} = this.props;\n\n    // Check if data comes from a composite layer, wrapped with getSubLayerRow\n    if (data[0] && data[0].__source) {\n      // index decoded from picking color refers to the source index\n      info.object = (data as any[]).find(d => d.__source.index === index);\n    }\n    return info;\n  }\n\n  /** Override base Layer method */\n  disablePickingIndex(objectIndex: number) {\n    const {data} = this.props;\n\n    // Check if data comes from a composite layer, wrapped with getSubLayerRow\n    if (data[0] && data[0].__source) {\n      // index decoded from picking color refers to the source index\n      for (let i = 0; i < (data as any[]).length; i++) {\n        if (data[i].__source.index === objectIndex) {\n          this._disablePickingIndex(i);\n        }\n      }\n    } else {\n      this._disablePickingIndex(objectIndex);\n    }\n  }\n\n  draw({uniforms}) {\n    const {\n      jointRounded,\n      capRounded,\n      billboard,\n      miterLimit,\n      widthUnits,\n      widthScale,\n      widthMinPixels,\n      widthMaxPixels\n    } = this.props;\n\n    this.state.model\n      .setUniforms(uniforms)\n      .setUniforms({\n        jointType: Number(jointRounded),\n        capType: Number(capRounded),\n        billboard,\n        widthUnits: UNIT[widthUnits],\n        widthScale,\n        miterLimit,\n        widthMinPixels,\n        widthMaxPixels\n      })\n      .draw();\n  }\n\n  protected _getModel(gl: WebGLRenderingContext): Model {\n    /*\n     *       _\n     *        \"-_ 1                   3                       5\n     *     _     \"o---------------------o-------------------_-o\n     *       -   / \"\"--..__              '.             _.-' /\n     *   _     \"@- - - - - \"\"--..__- - - - x - - - -_.@'    /\n     *    \"-_  /                   \"\"--..__ '.  _,-` :     /\n     *       \"o----------------------------\"\"-o'    :     /\n     *      0,2                            4 / '.  :     /\n     *                                      /   '.:     /\n     *                                     /     :'.   /\n     *                                    /     :  ', /\n     *                                   /     :     o\n     */\n\n    // prettier-ignore\n    const SEGMENT_INDICES = [\n      // start corner\n      0, 1, 2,\n      // body\n      1, 4, 2,\n      1, 3, 4,\n      // end corner\n      3, 5, 4\n    ];\n\n    // [0] position on segment - 0: start, 1: end\n    // [1] side of path - -1: left, 0: center (joint), 1: right\n    // prettier-ignore\n    const SEGMENT_POSITIONS = [\n      // bevel start corner\n      0, 0,\n      // start inner corner\n      0, -1,\n      // start outer corner\n      0, 1,\n      // end inner corner\n      1, -1,\n      // end outer corner\n      1, 1,\n      // bevel end corner\n      1, 0\n    ];\n\n    return new Model(gl, {\n      ...this.getShaders(),\n      id: this.props.id,\n      geometry: new Geometry({\n        drawMode: GL.TRIANGLES,\n        attributes: {\n          indices: new Uint16Array(SEGMENT_INDICES),\n          positions: {value: new Float32Array(SEGMENT_POSITIONS), size: 2}\n        }\n      }),\n      isInstanced: true\n    });\n  }\n\n  protected calculatePositions(attribute) {\n    const {pathTesselator} = this.state;\n\n    attribute.startIndices = pathTesselator.vertexStarts;\n    attribute.value = pathTesselator.get('positions');\n  }\n\n  protected calculateSegmentTypes(attribute) {\n    const {pathTesselator} = this.state;\n\n    attribute.startIndices = pathTesselator.vertexStarts;\n    attribute.value = pathTesselator.get('segmentTypes');\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME path-layer-vertex-shader\n\nattribute vec2 positions;\n\nattribute float instanceTypes;\nattribute vec3 instanceStartPositions;\nattribute vec3 instanceEndPositions;\nattribute vec3 instanceLeftPositions;\nattribute vec3 instanceRightPositions;\nattribute vec3 instanceLeftPositions64Low;\nattribute vec3 instanceStartPositions64Low;\nattribute vec3 instanceEndPositions64Low;\nattribute vec3 instanceRightPositions64Low;\nattribute float instanceStrokeWidths;\nattribute vec4 instanceColors;\nattribute vec3 instancePickingColors;\n\nuniform float widthScale;\nuniform float widthMinPixels;\nuniform float widthMaxPixels;\nuniform float jointType;\nuniform float capType;\nuniform float miterLimit;\nuniform bool billboard;\nuniform int widthUnits;\n\nuniform float opacity;\n\nvarying vec4 vColor;\nvarying vec2 vCornerOffset;\nvarying float vMiterLength;\nvarying vec2 vPathPosition;\nvarying float vPathLength;\nvarying float vJointType;\n\nconst float EPSILON = 0.001;\nconst vec3 ZERO_OFFSET = vec3(0.0);\n\nfloat flipIfTrue(bool flag) {\n  return -(float(flag) * 2. - 1.);\n}\n\n// calculate line join positions\nvec3 lineJoin(\n  vec3 prevPoint, vec3 currPoint, vec3 nextPoint,\n  vec2 width\n) {\n  bool isEnd = positions.x > 0.0;\n  // side of the segment - -1: left, 0: center, 1: right\n  float sideOfPath = positions.y;\n  float isJoint = float(sideOfPath == 0.0);\n\n  vec3 deltaA3 = (currPoint - prevPoint);\n  vec3 deltaB3 = (nextPoint - currPoint);\n\n  mat3 rotationMatrix;\n  bool needsRotation = !billboard && project_needs_rotation(currPoint, rotationMatrix);\n  if (needsRotation) {\n    deltaA3 = deltaA3 * rotationMatrix;\n    deltaB3 = deltaB3 * rotationMatrix;\n  }\n  vec2 deltaA = deltaA3.xy / width;\n  vec2 deltaB = deltaB3.xy / width;\n\n  float lenA = length(deltaA);\n  float lenB = length(deltaB);\n\n  vec2 dirA = lenA > 0. ? normalize(deltaA) : vec2(0.0, 0.0);\n  vec2 dirB = lenB > 0. ? normalize(deltaB) : vec2(0.0, 0.0);\n\n  vec2 perpA = vec2(-dirA.y, dirA.x);\n  vec2 perpB = vec2(-dirB.y, dirB.x);\n\n  // tangent of the corner\n  vec2 tangent = dirA + dirB;\n  tangent = length(tangent) > 0. ? normalize(tangent) : perpA;\n  // direction of the corner\n  vec2 miterVec = vec2(-tangent.y, tangent.x);\n  // direction of the segment\n  vec2 dir = isEnd ? dirA : dirB;\n  // direction of the extrusion\n  vec2 perp = isEnd ? perpA : perpB;\n  // length of the segment\n  float L = isEnd ? lenA : lenB;\n\n  // A = angle of the corner\n  float sinHalfA = abs(dot(miterVec, perp));\n  float cosHalfA = abs(dot(dirA, miterVec));\n\n  // -1: right, 1: left\n  float turnDirection = flipIfTrue(dirA.x * dirB.y >= dirA.y * dirB.x);\n\n  // relative position to the corner:\n  // -1: inside (smaller side of the angle)\n  // 0: center\n  // 1: outside (bigger side of the angle)\n  float cornerPosition = sideOfPath * turnDirection;\n\n  float miterSize = 1.0 / max(sinHalfA, EPSILON);\n  // trim if inside corner extends further than the line segment\n  miterSize = mix(\n    min(miterSize, max(lenA, lenB) / max(cosHalfA, EPSILON)),\n    miterSize,\n    step(0.0, cornerPosition)\n  );\n\n  vec2 offsetVec = mix(miterVec * miterSize, perp, step(0.5, cornerPosition))\n    * (sideOfPath + isJoint * turnDirection);\n\n  // special treatment for start cap and end cap\n  bool isStartCap = lenA == 0.0 || (!isEnd && (instanceTypes == 1.0 || instanceTypes == 3.0));\n  bool isEndCap = lenB == 0.0 || (isEnd && (instanceTypes == 2.0 || instanceTypes == 3.0));\n  bool isCap = isStartCap || isEndCap;\n\n  // extend out a triangle to envelope the round cap\n  if (isCap) {\n    offsetVec = mix(perp * sideOfPath, dir * capType * 4.0 * flipIfTrue(isStartCap), isJoint);\n    vJointType = capType;\n  } else {\n    vJointType = jointType;\n  }\n\n  // Generate variables for fragment shader\n  vPathLength = L;\n  vCornerOffset = offsetVec;\n  vMiterLength = dot(vCornerOffset, miterVec * turnDirection);\n  vMiterLength = isCap ? isJoint : vMiterLength;\n\n  vec2 offsetFromStartOfPath = vCornerOffset + deltaA * float(isEnd);\n  vPathPosition = vec2(\n    dot(offsetFromStartOfPath, perp),\n    dot(offsetFromStartOfPath, dir)\n  );\n  geometry.uv = vPathPosition;\n\n  float isValid = step(instanceTypes, 3.5);\n  vec3 offset = vec3(offsetVec * width * isValid, 0.0);\n\n  if (needsRotation) {\n    offset = rotationMatrix * offset;\n  }\n  return currPoint + offset;\n}\n\n// In clipspace extrusion, if a line extends behind the camera, clip it to avoid visual artifacts\nvoid clipLine(inout vec4 position, vec4 refPosition) {\n  if (position.w < EPSILON) {\n    float r = (EPSILON - refPosition.w) / (position.w - refPosition.w);\n    position = refPosition + (position - refPosition) * r;\n  }\n}\n\nvoid main() {\n  geometry.pickingColor = instancePickingColors;\n\n  vColor = vec4(instanceColors.rgb, instanceColors.a * opacity);\n\n  float isEnd = positions.x;\n\n  vec3 prevPosition = mix(instanceLeftPositions, instanceStartPositions, isEnd);\n  vec3 prevPosition64Low = mix(instanceLeftPositions64Low, instanceStartPositions64Low, isEnd);\n\n  vec3 currPosition = mix(instanceStartPositions, instanceEndPositions, isEnd);\n  vec3 currPosition64Low = mix(instanceStartPositions64Low, instanceEndPositions64Low, isEnd);\n\n  vec3 nextPosition = mix(instanceEndPositions, instanceRightPositions, isEnd);\n  vec3 nextPosition64Low = mix(instanceEndPositions64Low, instanceRightPositions64Low, isEnd);\n\n  geometry.worldPosition = currPosition;\n  vec2 widthPixels = vec2(clamp(\n    project_size_to_pixel(instanceStrokeWidths * widthScale, widthUnits),\n    widthMinPixels, widthMaxPixels) / 2.0);\n  vec3 width;\n\n  if (billboard) {\n    // Extrude in clipspace\n    vec4 prevPositionScreen = project_position_to_clipspace(prevPosition, prevPosition64Low, ZERO_OFFSET);\n    vec4 currPositionScreen = project_position_to_clipspace(currPosition, currPosition64Low, ZERO_OFFSET, geometry.position);\n    vec4 nextPositionScreen = project_position_to_clipspace(nextPosition, nextPosition64Low, ZERO_OFFSET);\n\n    clipLine(prevPositionScreen, currPositionScreen);\n    clipLine(nextPositionScreen, currPositionScreen);\n    clipLine(currPositionScreen, mix(nextPositionScreen, prevPositionScreen, isEnd));\n\n    width = vec3(widthPixels, 0.0);\n    DECKGL_FILTER_SIZE(width, geometry);\n\n    vec3 pos = lineJoin(\n      prevPositionScreen.xyz / prevPositionScreen.w,\n      currPositionScreen.xyz / currPositionScreen.w,\n      nextPositionScreen.xyz / nextPositionScreen.w,\n      project_pixel_size_to_clipspace(width.xy)\n    );\n\n    gl_Position = vec4(pos * currPositionScreen.w, currPositionScreen.w);\n  } else {\n    // Extrude in commonspace\n    prevPosition = project_position(prevPosition, prevPosition64Low);\n    currPosition = project_position(currPosition, currPosition64Low);\n    nextPosition = project_position(nextPosition, nextPosition64Low);\n\n    width = vec3(project_pixel_size(widthPixels), 0.0);\n    DECKGL_FILTER_SIZE(width, geometry);\n\n    vec4 pos = vec4(\n      lineJoin(prevPosition, currPosition, nextPosition, width.xy),\n      1.0);\n    geometry.position = pos;\n    gl_Position = project_common_position_to_clipspace(pos);\n  }\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME path-layer-fragment-shader\n\nprecision highp float;\n\nuniform float miterLimit;\n\nvarying vec4 vColor;\nvarying vec2 vCornerOffset;\nvarying float vMiterLength;\n/*\n * vPathPosition represents the relative coordinates of the current fragment on the path segment.\n * vPathPosition.x - position along the width of the path, between [-1, 1]. 0 is the center line.\n * vPathPosition.y - position along the length of the path, between [0, L / width].\n */\nvarying vec2 vPathPosition;\nvarying float vPathLength;\nvarying float vJointType;\n\nvoid main(void) {\n  geometry.uv = vPathPosition;\n\n  if (vPathPosition.y < 0.0 || vPathPosition.y > vPathLength) {\n    // if joint is rounded, test distance from the corner\n    if (vJointType > 0.5 && length(vCornerOffset) > 1.0) {\n      discard;\n    }\n    // trim miter\n    if (vJointType < 0.5 && vMiterLength > miterLimit + 1.0) {\n      discard;\n    }\n  }\n  gl_FragColor = vColor;\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n`;\n","/* global document */\nimport GL from '@luma.gl/constants';\nimport {Texture2D, copyToTexture} from '@luma.gl/core';\nimport {ImageLoader} from '@loaders.gl/images';\nimport {load} from '@loaders.gl/core';\nimport {createIterable} from '@deck.gl/core';\n\nimport type {AccessorFunction} from '@deck.gl/core';\n\nconst DEFAULT_CANVAS_WIDTH = 1024;\nconst DEFAULT_BUFFER = 4;\n\nconst noop = () => {};\n\nconst DEFAULT_TEXTURE_PARAMETERS = {\n  [GL.TEXTURE_MIN_FILTER]: GL.LINEAR_MIPMAP_LINEAR,\n  // GL.LINEAR is the default value but explicitly set it here\n  [GL.TEXTURE_MAG_FILTER]: GL.LINEAR,\n  // for texture boundary artifact\n  [GL.TEXTURE_WRAP_S]: GL.CLAMP_TO_EDGE,\n  [GL.TEXTURE_WRAP_T]: GL.CLAMP_TO_EDGE\n};\n\ntype IconDef = {\n  /** Width of the icon */\n  width: number;\n  /** Height of the icon */\n  height: number;\n  /** Horizontal position of icon anchor. Default: half width. */\n  anchorX?: number;\n  /** Vertical position of icon anchor. Default: half height. */\n  anchorY?: number;\n  /**\n   * Whether the icon is treated as a transparency mask.\n   * If `true`, color defined by `getColor` is applied.\n   * If `false`, pixel color from the icon image is applied.\n   * @default false\n   */\n  mask?: boolean;\n};\n\nexport type UnpackedIcon = {\n  /** Url to fetch the icon */\n  url: string;\n  /** Unique identifier of the icon. Icons of the same id are only fetched once. Fallback to `url` if not specified. */\n  id?: string;\n} & IconDef;\n\ntype PrepackedIcon = {\n  /** Left position of the icon on the atlas */\n  x: number;\n  /** Top position of the icon on the atlas */\n  y: number;\n} & IconDef;\n\nexport type IconMapping = Record<string, PrepackedIcon>;\n\nexport type LoadIconErrorContext = {\n  error: Error;\n  /** The URL that was trying to fetch */\n  url: string;\n  /** The original data object that requested this icon */\n  source: any;\n  /** The index of the original data object that requested this icon */\n  sourceIndex: number;\n  /** The load options used for the fetch */\n  loadOptions: any;\n};\n\nfunction nextPowOfTwo(number: number): number {\n  return Math.pow(2, Math.ceil(Math.log2(number)));\n}\n\n// update comment to create a new texture and copy original data.\nfunction resizeImage(\n  ctx: CanvasRenderingContext2D,\n  imageData: HTMLImageElement | ImageBitmap,\n  width: number,\n  height: number\n): HTMLImageElement | HTMLCanvasElement | ImageBitmap {\n  if (width === imageData.width && height === imageData.height) {\n    return imageData;\n  }\n\n  ctx.canvas.height = height;\n  ctx.canvas.width = width;\n\n  ctx.clearRect(0, 0, ctx.canvas.width, ctx.canvas.height);\n\n  // image, sx, sy, sWidth, sHeight, dx, dy, dWidth, dHeight\n  ctx.drawImage(imageData, 0, 0, imageData.width, imageData.height, 0, 0, width, height);\n\n  return ctx.canvas;\n}\n\nfunction getIconId(icon: UnpackedIcon): string {\n  return icon && (icon.id || icon.url);\n}\n\n// resize texture without losing original data\nfunction resizeTexture(\n  texture: Texture2D,\n  width: number,\n  height: number,\n  parameters: any\n): Texture2D {\n  const oldWidth = texture.width;\n  const oldHeight = texture.height;\n\n  const newTexture = new Texture2D(texture.gl, {width, height, parameters});\n  copyToTexture(texture, newTexture, {\n    targetY: 0,\n    width: oldWidth,\n    height: oldHeight\n  });\n\n  texture.delete();\n  return newTexture;\n}\n\n// traverse icons in a row of icon atlas\n// extend each icon with left-top coordinates\nfunction buildRowMapping(\n  mapping: IconMapping,\n  columns: {\n    icon: UnpackedIcon;\n    xOffset: number;\n  }[],\n  yOffset: number\n): void {\n  for (let i = 0; i < columns.length; i++) {\n    const {icon, xOffset} = columns[i];\n    const id = getIconId(icon);\n    mapping[id] = {\n      ...icon,\n      x: xOffset,\n      y: yOffset\n    };\n  }\n}\n\n/**\n * Generate coordinate mapping to retrieve icon left-top position from an icon atlas\n */\nexport function buildMapping({\n  icons,\n  buffer,\n  mapping = {},\n  xOffset = 0,\n  yOffset = 0,\n  rowHeight = 0,\n  canvasWidth\n}: {\n  /** list of icon definitions */\n  icons: UnpackedIcon[];\n  /** add bleeding buffer to the right and bottom side of the image */\n  buffer: number;\n  /** right position of last icon in old mapping */\n  xOffset: number;\n  /** top position in last icon in old mapping */\n  yOffset: number;\n  /** height of the last icon's row */\n  rowHeight: number;\n  /** max width of canvas */\n  canvasWidth: number;\n  mapping: IconMapping;\n}): {\n  mapping: IconMapping;\n  rowHeight: number;\n  xOffset: number;\n  yOffset: number;\n  canvasWidth: number;\n  canvasHeight: number;\n} {\n  let columns: {\n    icon: UnpackedIcon;\n    xOffset: number;\n  }[] = [];\n  // Strategy to layout all the icons into a texture:\n  // traverse the icons sequentially, layout the icons from left to right, top to bottom\n  // when the sum of the icons width is equal or larger than canvasWidth,\n  // move to next row starting from total height so far plus max height of the icons in previous row\n  // row width is equal to canvasWidth\n  // row height is decided by the max height of the icons in that row\n  // mapping coordinates of each icon is its left-top position in the texture\n  for (let i = 0; i < icons.length; i++) {\n    const icon = icons[i];\n    const id = getIconId(icon);\n\n    if (!mapping[id]) {\n      const {height, width} = icon;\n\n      // fill one row\n      if (xOffset + width + buffer > canvasWidth) {\n        buildRowMapping(mapping, columns, yOffset);\n\n        xOffset = 0;\n        yOffset = rowHeight + yOffset + buffer;\n        rowHeight = 0;\n        columns = [];\n      }\n\n      columns.push({\n        icon,\n        xOffset\n      });\n\n      xOffset = xOffset + width + buffer;\n      rowHeight = Math.max(rowHeight, height);\n    }\n  }\n\n  if (columns.length > 0) {\n    buildRowMapping(mapping, columns, yOffset);\n  }\n\n  return {\n    mapping,\n    rowHeight,\n    xOffset,\n    yOffset,\n    canvasWidth,\n    canvasHeight: nextPowOfTwo(rowHeight + yOffset + buffer)\n  };\n}\n\n// extract icons from data\n// return icons should be unique, and not cached or cached but url changed\nexport function getDiffIcons(\n  data: any,\n  getIcon: AccessorFunction<any, UnpackedIcon> | null,\n  cachedIcons: Record<string, PrepackedIcon & {url?: string}>\n): Record<\n  string,\n  UnpackedIcon & {\n    source: any;\n    sourceIndex: number;\n  }\n> | null {\n  if (!data || !getIcon) {\n    return null;\n  }\n\n  cachedIcons = cachedIcons || {};\n  const icons = {};\n  const {iterable, objectInfo} = createIterable(data);\n  for (const object of iterable) {\n    objectInfo.index++;\n    const icon = getIcon(object, objectInfo);\n    const id = getIconId(icon);\n\n    if (!icon) {\n      throw new Error('Icon is missing.');\n    }\n\n    if (!icon.url) {\n      throw new Error('Icon url is missing.');\n    }\n\n    if (!icons[id] && (!cachedIcons[id] || icon.url !== cachedIcons[id].url)) {\n      icons[id] = {...icon, source: object, sourceIndex: objectInfo.index};\n    }\n  }\n  return icons;\n}\n\nexport default class IconManager {\n  gl: WebGLRenderingContext;\n\n  private onUpdate: () => void;\n  private onError: (context: LoadIconErrorContext) => void;\n  private _loadOptions: any = null;\n  private _texture: Texture2D | null = null;\n  private _externalTexture: Texture2D | null = null;\n  private _mapping: IconMapping = {};\n  private _textureParameters: Record<number, number> | null = null;\n\n  /** count of pending requests to fetch icons */\n  private _pendingCount: number = 0;\n\n  private _autoPacking: boolean = false;\n\n  // / internal state used for autoPacking\n\n  private _xOffset: number = 0;\n  private _yOffset: number = 0;\n  private _rowHeight: number = 0;\n  private _buffer: number = DEFAULT_BUFFER;\n  private _canvasWidth: number = DEFAULT_CANVAS_WIDTH;\n  private _canvasHeight: number = 0;\n  private _canvas: HTMLCanvasElement | null = null;\n\n  constructor(\n    gl: WebGLRenderingContext,\n    {\n      onUpdate = noop,\n      onError = noop\n    }: {\n      /** Callback when the texture updates */\n      onUpdate: () => void;\n      /** Callback when an error is encountered */\n      onError: (context: LoadIconErrorContext) => void;\n    }\n  ) {\n    this.gl = gl;\n    this.onUpdate = onUpdate;\n    this.onError = onError;\n  }\n\n  finalize(): void {\n    this._texture?.delete();\n  }\n\n  getTexture(): Texture2D | null {\n    return this._texture || this._externalTexture;\n  }\n\n  getIconMapping(icon: string | UnpackedIcon): PrepackedIcon {\n    const id = this._autoPacking ? getIconId(icon as UnpackedIcon) : (icon as string);\n    return this._mapping[id] || {};\n  }\n\n  setProps({\n    loadOptions,\n    autoPacking,\n    iconAtlas,\n    iconMapping,\n    textureParameters\n  }: {\n    loadOptions?: any;\n    autoPacking?: boolean;\n    iconAtlas?: Texture2D | null;\n    iconMapping?: IconMapping | null;\n    textureParameters?: Record<number, number> | null;\n  }) {\n    if (loadOptions) {\n      this._loadOptions = loadOptions;\n    }\n\n    if (autoPacking !== undefined) {\n      this._autoPacking = autoPacking;\n    }\n\n    if (iconMapping) {\n      this._mapping = iconMapping;\n    }\n\n    if (iconAtlas) {\n      this._texture?.delete();\n      this._texture = null;\n      this._externalTexture = iconAtlas;\n    }\n\n    if (textureParameters) {\n      this._textureParameters = textureParameters;\n    }\n  }\n\n  get isLoaded(): boolean {\n    return this._pendingCount === 0;\n  }\n\n  packIcons(data: any, getIcon: AccessorFunction<any, UnpackedIcon>): void {\n    if (!this._autoPacking || typeof document === 'undefined') {\n      return;\n    }\n\n    const icons = Object.values(getDiffIcons(data, getIcon, this._mapping) || {});\n\n    if (icons.length > 0) {\n      // generate icon mapping\n      const {mapping, xOffset, yOffset, rowHeight, canvasHeight} = buildMapping({\n        icons,\n        buffer: this._buffer,\n        canvasWidth: this._canvasWidth,\n        mapping: this._mapping,\n        rowHeight: this._rowHeight,\n        xOffset: this._xOffset,\n        yOffset: this._yOffset\n      });\n\n      this._rowHeight = rowHeight;\n      this._mapping = mapping;\n      this._xOffset = xOffset;\n      this._yOffset = yOffset;\n      this._canvasHeight = canvasHeight;\n\n      // create new texture\n      if (!this._texture) {\n        this._texture = new Texture2D(this.gl, {\n          width: this._canvasWidth,\n          height: this._canvasHeight,\n          parameters: this._textureParameters || DEFAULT_TEXTURE_PARAMETERS\n        });\n      }\n\n      if (this._texture.height !== this._canvasHeight) {\n        this._texture = resizeTexture(\n          this._texture,\n          this._canvasWidth,\n          this._canvasHeight,\n          this._textureParameters || DEFAULT_TEXTURE_PARAMETERS\n        );\n      }\n\n      this.onUpdate();\n\n      // load images\n      this._canvas = this._canvas || document.createElement('canvas');\n      this._loadIcons(icons);\n    }\n  }\n\n  private _loadIcons(\n    icons: (UnpackedIcon & {\n      source: any;\n      sourceIndex: number;\n    })[]\n  ): void {\n    // This method is only called in the auto packing case, where _canvas is defined\n    const ctx = this._canvas!.getContext('2d') as CanvasRenderingContext2D;\n\n    for (const icon of icons) {\n      this._pendingCount++;\n      load(icon.url, this._loadOptions)\n        .then(imageData => {\n          const id = getIconId(icon);\n          const {x, y, width, height} = this._mapping[id];\n\n          const data = resizeImage(ctx, imageData, width, height);\n\n          this._texture.setSubImageData({\n            data,\n            x,\n            y,\n            width,\n            height\n          });\n\n          // Call to regenerate mipmaps after modifying texture(s)\n          this._texture.generateMipmap();\n\n          this.onUpdate();\n        })\n        .catch(error => {\n          this.onError({\n            url: icon.url,\n            source: icon.source,\n            sourceIndex: icon.sourceIndex,\n            loadOptions: this._loadOptions,\n            error\n          });\n        })\n        .finally(() => {\n          this._pendingCount--;\n        });\n    }\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\nimport {Layer, project32, picking, log, UNIT} from '@deck.gl/core';\nimport GL from '@luma.gl/constants';\nimport {Model, Geometry} from '@luma.gl/core';\n\nimport vs from './icon-layer-vertex.glsl';\nimport fs from './icon-layer-fragment.glsl';\nimport IconManager from './icon-manager';\n\nimport type {\n  LayerProps,\n  Accessor,\n  AccessorFunction,\n  Position,\n  Color,\n  Texture,\n  Unit,\n  UpdateParameters,\n  LayerContext,\n  DefaultProps\n} from '@deck.gl/core';\nimport type {UnpackedIcon, IconMapping, LoadIconErrorContext} from './icon-manager';\n\ntype _IconLayerProps<DataT> = {\n  /** A prepacked image that contains all icons. */\n  iconAtlas?: string | Texture;\n  /** Icon names mapped to icon definitions, or a URL to load such mapping from a JSON file. */\n  iconMapping?: string | IconMapping;\n\n  /** Icon size multiplier.\n   * @default 1\n   */\n  sizeScale?: number;\n  /**\n   * The units of the icon size, one of `meters`, `common`, and `pixels`.\n   *\n   * @default 'pixels'\n   */\n  sizeUnits?: Unit;\n  /**\n   * The minimum size in pixels. When using non-pixel `sizeUnits`, this prop can be used to prevent the icon from getting too small when zoomed out.\n   */\n  sizeMinPixels?: number;\n  /**\n   * The maximum size in pixels. When using non-pixel `sizeUnits`, this prop can be used to prevent the icon from getting too big when zoomed in.\n   */\n  sizeMaxPixels?: number;\n  /** If `true`, the icon always faces camera. Otherwise the icon faces up (z)\n   * @default true\n   */\n  billboard?: boolean;\n  /**\n   * Discard pixels whose opacity is below this threshold.\n   * A discarded pixel would create a \"hole\" in the icon that is not considered part of the object.\n   * @default 0.05\n   */\n  alphaCutoff?: number;\n\n  /** Anchor position accessor. */\n  getPosition?: Accessor<DataT, Position>;\n  /** Icon definition accessor.\n   * Should return the icon id if using pre-packed icons (`iconAtlas` + `iconMapping`).\n   * Return an object that defines the icon if using auto-packing.\n   */\n  getIcon?: AccessorFunction<DataT, string> | AccessorFunction<DataT, UnpackedIcon>;\n  /** Icon color accessor.\n   * @default [0, 0, 0, 255]\n   */\n  getColor?: Accessor<DataT, Color>;\n  /** Icon size accessor.\n   * @default 1\n   */\n  getSize?: Accessor<DataT, number>;\n  /** Icon rotation accessor, in degrees.\n   * @default 0\n   */\n  getAngle?: Accessor<DataT, number>;\n  /**\n   * Icon offsest accessor, in pixels.\n   * @default [0, 0]\n   */\n  getPixelOffset?: Accessor<DataT, [number, number]>;\n  /**\n   * Callback called if the attempt to fetch an icon returned by `getIcon` fails.\n   */\n  onIconError?: ((context: LoadIconErrorContext) => void) | null;\n\n  /** Customize the [texture parameters](https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/texParameter). */\n  textureParameters?: Record<number, number> | null;\n};\n\nexport type IconLayerProps<DataT = any> = _IconLayerProps<DataT> & LayerProps<DataT>;\n\nconst DEFAULT_COLOR: [number, number, number, number] = [0, 0, 0, 255];\n\nconst defaultProps: DefaultProps<IconLayerProps> = {\n  iconAtlas: {type: 'image', value: null, async: true},\n  iconMapping: {type: 'object', value: {}, async: true},\n  sizeScale: {type: 'number', value: 1, min: 0},\n  billboard: true,\n  sizeUnits: 'pixels',\n  sizeMinPixels: {type: 'number', min: 0, value: 0}, //  min point radius in pixels\n  sizeMaxPixels: {type: 'number', min: 0, value: Number.MAX_SAFE_INTEGER}, // max point radius in pixels\n  alphaCutoff: {type: 'number', value: 0.05, min: 0, max: 1},\n\n  getPosition: {type: 'accessor', value: x => x.position},\n  getIcon: {type: 'accessor', value: x => x.icon},\n  getColor: {type: 'accessor', value: DEFAULT_COLOR},\n  getSize: {type: 'accessor', value: 1},\n  getAngle: {type: 'accessor', value: 0},\n  getPixelOffset: {type: 'accessor', value: [0, 0]},\n\n  onIconError: {type: 'function', value: null, compare: false, optional: true}\n};\n\n/** Render raster icons at given coordinates. */\nexport default class IconLayer<DataT = any, ExtraPropsT = {}> extends Layer<\n  ExtraPropsT & Required<_IconLayerProps<DataT>>\n> {\n  static defaultProps = defaultProps;\n  static layerName = 'IconLayer';\n\n  state!: {\n    model?: Model;\n    iconManager: IconManager;\n  };\n\n  getShaders() {\n    return super.getShaders({vs, fs, modules: [project32, picking]});\n  }\n\n  initializeState() {\n    this.state = {\n      iconManager: new IconManager(this.context.gl, {\n        onUpdate: this._onUpdate.bind(this),\n        onError: this._onError.bind(this)\n      })\n    };\n\n    const attributeManager = this.getAttributeManager();\n    /* eslint-disable max-len */\n    attributeManager!.addInstanced({\n      instancePositions: {\n        size: 3,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        transition: true,\n        accessor: 'getPosition'\n      },\n      instanceSizes: {\n        size: 1,\n        transition: true,\n        accessor: 'getSize',\n        defaultValue: 1\n      },\n      instanceOffsets: {\n        size: 2,\n        accessor: 'getIcon',\n        // eslint-disable-next-line @typescript-eslint/unbound-method\n        transform: this.getInstanceOffset\n      },\n      instanceIconFrames: {\n        size: 4,\n        accessor: 'getIcon',\n        // eslint-disable-next-line @typescript-eslint/unbound-method\n        transform: this.getInstanceIconFrame\n      },\n      instanceColorModes: {\n        size: 1,\n        type: GL.UNSIGNED_BYTE,\n        accessor: 'getIcon',\n        // eslint-disable-next-line @typescript-eslint/unbound-method\n        transform: this.getInstanceColorMode\n      },\n      instanceColors: {\n        size: this.props.colorFormat.length,\n        type: GL.UNSIGNED_BYTE,\n        normalized: true,\n        transition: true,\n        accessor: 'getColor',\n        defaultValue: DEFAULT_COLOR\n      },\n      instanceAngles: {\n        size: 1,\n        transition: true,\n        accessor: 'getAngle'\n      },\n      instancePixelOffset: {\n        size: 2,\n        transition: true,\n        accessor: 'getPixelOffset'\n      }\n    });\n    /* eslint-enable max-len */\n  }\n\n  /* eslint-disable max-statements, complexity */\n  updateState(params: UpdateParameters<this>) {\n    super.updateState(params);\n    const {props, oldProps, changeFlags} = params;\n\n    const attributeManager = this.getAttributeManager();\n    const {iconAtlas, iconMapping, data, getIcon, textureParameters} = props;\n    const {iconManager} = this.state;\n\n    // internalState is always defined during updateState\n    const prePacked = iconAtlas || this.internalState!.isAsyncPropLoading('iconAtlas');\n    iconManager.setProps({\n      loadOptions: props.loadOptions,\n      autoPacking: !prePacked,\n      iconAtlas,\n      iconMapping: prePacked ? (iconMapping as IconMapping) : null,\n      textureParameters\n    });\n\n    // prepacked iconAtlas from user\n    if (prePacked) {\n      if (oldProps.iconMapping !== props.iconMapping) {\n        attributeManager!.invalidate('getIcon');\n      }\n    } else if (\n      changeFlags.dataChanged ||\n      (changeFlags.updateTriggersChanged &&\n        (changeFlags.updateTriggersChanged.all || changeFlags.updateTriggersChanged.getIcon))\n    ) {\n      // Auto packing - getIcon is expected to return an object\n      iconManager.packIcons(data, getIcon as AccessorFunction<any, UnpackedIcon>);\n    }\n\n    if (changeFlags.extensionsChanged) {\n      const {gl} = this.context;\n      this.state.model?.delete();\n      this.state.model = this._getModel(gl);\n      attributeManager!.invalidateAll();\n    }\n  }\n  /* eslint-enable max-statements, complexity */\n\n  get isLoaded(): boolean {\n    return super.isLoaded && this.state.iconManager.isLoaded;\n  }\n\n  finalizeState(context: LayerContext): void {\n    super.finalizeState(context);\n    // Release resources held by the icon manager\n    this.state.iconManager.finalize();\n  }\n\n  draw({uniforms}): void {\n    const {sizeScale, sizeMinPixels, sizeMaxPixels, sizeUnits, billboard, alphaCutoff} = this.props;\n    const {iconManager} = this.state;\n\n    const iconsTexture = iconManager.getTexture();\n    if (iconsTexture) {\n      this.state.model\n        .setUniforms(uniforms)\n        .setUniforms({\n          iconsTexture,\n          iconsTextureDim: [iconsTexture.width, iconsTexture.height],\n          sizeUnits: UNIT[sizeUnits],\n          sizeScale,\n          sizeMinPixels,\n          sizeMaxPixels,\n          billboard,\n          alphaCutoff\n        })\n        .draw();\n    }\n  }\n\n  protected _getModel(gl: WebGLRenderingContext): Model {\n    // The icon-layer vertex shader uses 2d positions\n    // specifed via: attribute vec2 positions;\n    const positions = [-1, -1, -1, 1, 1, 1, 1, -1];\n\n    return new Model(gl, {\n      ...this.getShaders(),\n      id: this.props.id,\n      geometry: new Geometry({\n        drawMode: GL.TRIANGLE_FAN,\n        attributes: {\n          // The size must be explicitly passed here otherwise luma.gl\n          // will default to assuming that positions are 3D (x,y,z)\n          positions: {\n            size: 2,\n            value: new Float32Array(positions)\n          }\n        }\n      }),\n      isInstanced: true\n    });\n  }\n\n  private _onUpdate(): void {\n    this.setNeedsRedraw();\n  }\n\n  private _onError(evt: LoadIconErrorContext): void {\n    const onIconError = this.getCurrentLayer()?.props.onIconError;\n    if (onIconError) {\n      onIconError(evt);\n    } else {\n      log.error(evt.error.message)();\n    }\n  }\n\n  protected getInstanceOffset(icon: string): number[] {\n    const {\n      width,\n      height,\n      anchorX = width / 2,\n      anchorY = height / 2\n    } = this.state.iconManager.getIconMapping(icon);\n    return [width / 2 - anchorX, height / 2 - anchorY];\n  }\n\n  protected getInstanceColorMode(icon: string): number {\n    const mapping = this.state.iconManager.getIconMapping(icon);\n    return mapping.mask ? 1 : 0;\n  }\n\n  protected getInstanceIconFrame(icon: string): number[] {\n    const {x, y, width, height} = this.state.iconManager.getIconMapping(icon);\n    return [x, y, width, height];\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME icon-layer-vertex-shader\n\nattribute vec2 positions;\n\nattribute vec3 instancePositions;\nattribute vec3 instancePositions64Low;\nattribute float instanceSizes;\nattribute float instanceAngles;\nattribute vec4 instanceColors;\nattribute vec3 instancePickingColors;\nattribute vec4 instanceIconFrames;\nattribute float instanceColorModes;\nattribute vec2 instanceOffsets;\nattribute vec2 instancePixelOffset;\n\nuniform float sizeScale;\nuniform vec2 iconsTextureDim;\nuniform float sizeMinPixels;\nuniform float sizeMaxPixels;\nuniform bool billboard;\nuniform int sizeUnits;\n\nvarying float vColorMode;\nvarying vec4 vColor;\nvarying vec2 vTextureCoords;\nvarying vec2 uv;\n\nvec2 rotate_by_angle(vec2 vertex, float angle) {\n  float angle_radian = angle * PI / 180.0;\n  float cos_angle = cos(angle_radian);\n  float sin_angle = sin(angle_radian);\n  mat2 rotationMatrix = mat2(cos_angle, -sin_angle, sin_angle, cos_angle);\n  return rotationMatrix * vertex;\n}\n\nvoid main(void) {\n  geometry.worldPosition = instancePositions;\n  geometry.uv = positions;\n  geometry.pickingColor = instancePickingColors;\n  uv = positions;\n\n  vec2 iconSize = instanceIconFrames.zw;\n  // convert size in meters to pixels, then scaled and clamp\n \n  // project meters to pixels and clamp to limits \n  float sizePixels = clamp(\n    project_size_to_pixel(instanceSizes * sizeScale, sizeUnits), \n    sizeMinPixels, sizeMaxPixels\n  );\n\n  // scale icon height to match instanceSize\n  float instanceScale = iconSize.y == 0.0 ? 0.0 : sizePixels / iconSize.y;\n\n  // scale and rotate vertex in \"pixel\" value and convert back to fraction in clipspace\n  vec2 pixelOffset = positions / 2.0 * iconSize + instanceOffsets;\n  pixelOffset = rotate_by_angle(pixelOffset, instanceAngles) * instanceScale;\n  pixelOffset += instancePixelOffset;\n  pixelOffset.y *= -1.0;\n\n  if (billboard)  {\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, vec3(0.0), geometry.position);\n    vec3 offset = vec3(pixelOffset, 0.0);\n    DECKGL_FILTER_SIZE(offset, geometry);\n    gl_Position.xy += project_pixel_size_to_clipspace(offset.xy);\n\n  } else {\n    vec3 offset_common = vec3(project_pixel_size(pixelOffset), 0.0);\n    DECKGL_FILTER_SIZE(offset_common, geometry);\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, offset_common, geometry.position); \n  }\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  vTextureCoords = mix(\n    instanceIconFrames.xy,\n    instanceIconFrames.xy + iconSize,\n    (positions.xy + 1.0) / 2.0\n  ) / iconsTextureDim;\n\n  vColor = instanceColors;\n  DECKGL_FILTER_COLOR(vColor, geometry);\n\n  vColorMode = instanceColorModes;\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME icon-layer-fragment-shader\n\nprecision highp float;\n\nuniform float opacity;\nuniform sampler2D iconsTexture;\nuniform float alphaCutoff;\n\nvarying float vColorMode;\nvarying vec4 vColor;\nvarying vec2 vTextureCoords;\nvarying vec2 uv;\n\nvoid main(void) {\n  geometry.uv = uv;\n\n  vec4 texColor = texture2D(iconsTexture, vTextureCoords);\n\n  // if colorMode == 0, use pixel color from the texture\n  // if colorMode == 1 or rendering picking buffer, use texture as transparency mask\n  vec3 color = mix(texColor.rgb, vColor.rgb, vColorMode);\n  // Take the global opacity and the alpha from vColor into account for the alpha component\n  float a = texColor.a * opacity * vColor.a;\n\n  if (a < alphaCutoff) {\n    discard;\n  }\n\n  gl_FragColor = vec4(color, a);\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n`;\n","var setPrototypeOf = require(\"./setPrototypeOf.js\");\nfunction _inherits(subClass, superClass) {\n  if (typeof superClass !== \"function\" && superClass !== null) {\n    throw new TypeError(\"Super expression must either be null or a function\");\n  }\n  subClass.prototype = Object.create(superClass && superClass.prototype, {\n    constructor: {\n      value: subClass,\n      writable: true,\n      configurable: true\n    }\n  });\n  Object.defineProperty(subClass, \"prototype\", {\n    writable: false\n  });\n  if (superClass) setPrototypeOf(subClass, superClass);\n}\nmodule.exports = _inherits, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","var _typeof = require(\"./typeof.js\")[\"default\"];\nvar assertThisInitialized = require(\"./assertThisInitialized.js\");\nfunction _possibleConstructorReturn(self, call) {\n  if (call && (_typeof(call) === \"object\" || typeof call === \"function\")) {\n    return call;\n  } else if (call !== void 0) {\n    throw new TypeError(\"Derived constructors may only return object or undefined\");\n  }\n  return assertThisInitialized(self);\n}\nmodule.exports = _possibleConstructorReturn, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","import MathArray from './math-array';\nimport { checkNumber } from '../../lib/validators';\nimport assert from '../../lib/assert';\nexport default class Vector extends MathArray {\n  get x() {\n    return this[0];\n  }\n\n  set x(value) {\n    this[0] = checkNumber(value);\n  }\n\n  get y() {\n    return this[1];\n  }\n\n  set y(value) {\n    this[1] = checkNumber(value);\n  }\n\n  len() {\n    return Math.sqrt(this.lengthSquared());\n  }\n\n  magnitude() {\n    return this.len();\n  }\n\n  lengthSquared() {\n    let length = 0;\n\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      length += this[i] * this[i];\n    }\n\n    return length;\n  }\n\n  magnitudeSquared() {\n    return this.lengthSquared();\n  }\n\n  distance(mathArray) {\n    return Math.sqrt(this.distanceSquared(mathArray));\n  }\n\n  distanceSquared(mathArray) {\n    let length = 0;\n\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      const dist = this[i] - mathArray[i];\n      length += dist * dist;\n    }\n\n    return checkNumber(length);\n  }\n\n  dot(mathArray) {\n    let product = 0;\n\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      product += this[i] * mathArray[i];\n    }\n\n    return checkNumber(product);\n  }\n\n  normalize() {\n    const length = this.magnitude();\n\n    if (length !== 0) {\n      for (let i = 0; i < this.ELEMENTS; ++i) {\n        this[i] /= length;\n      }\n    }\n\n    return this.check();\n  }\n\n  multiply(...vectors) {\n    for (const vector of vectors) {\n      for (let i = 0; i < this.ELEMENTS; ++i) {\n        this[i] *= vector[i];\n      }\n    }\n\n    return this.check();\n  }\n\n  divide(...vectors) {\n    for (const vector of vectors) {\n      for (let i = 0; i < this.ELEMENTS; ++i) {\n        this[i] /= vector[i];\n      }\n    }\n\n    return this.check();\n  }\n\n  lengthSq() {\n    return this.lengthSquared();\n  }\n\n  distanceTo(vector) {\n    return this.distance(vector);\n  }\n\n  distanceToSquared(vector) {\n    return this.distanceSquared(vector);\n  }\n\n  getComponent(i) {\n    assert(i >= 0 && i < this.ELEMENTS, 'index is out of range');\n    return checkNumber(this[i]);\n  }\n\n  setComponent(i, value) {\n    assert(i >= 0 && i < this.ELEMENTS, 'index is out of range');\n    this[i] = value;\n    return this.check();\n  }\n\n  addVectors(a, b) {\n    return this.copy(a).add(b);\n  }\n\n  subVectors(a, b) {\n    return this.copy(a).subtract(b);\n  }\n\n  multiplyVectors(a, b) {\n    return this.copy(a).multiply(b);\n  }\n\n  addScaledVector(a, b) {\n    return this.add(new this.constructor(a).multiplyScalar(b));\n  }\n\n}\n//# sourceMappingURL=vector.js.map","function _extendableBuiltin(cls) {\n  function ExtendableBuiltin() {\n    var instance = Reflect.construct(cls, Array.from(arguments));\n    Object.setPrototypeOf(instance, Object.getPrototypeOf(this));\n    return instance;\n  }\n\n  ExtendableBuiltin.prototype = Object.create(cls.prototype, {\n    constructor: {\n      value: cls,\n      enumerable: false,\n      writable: true,\n      configurable: true\n    }\n  });\n\n  if (Object.setPrototypeOf) {\n    Object.setPrototypeOf(ExtendableBuiltin, cls);\n  } else {\n    ExtendableBuiltin.__proto__ = cls;\n  }\n\n  return ExtendableBuiltin;\n}\n\nimport { config, formatValue, equals, isArray } from '../../lib/common';\nexport default class MathArray extends _extendableBuiltin(Array) {\n  clone() {\n    return new this.constructor().copy(this);\n  }\n\n  fromArray(array, offset = 0) {\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      this[i] = array[i + offset];\n    }\n\n    return this.check();\n  }\n\n  toArray(targetArray = [], offset = 0) {\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      targetArray[offset + i] = this[i];\n    }\n\n    return targetArray;\n  }\n\n  from(arrayOrObject) {\n    return Array.isArray(arrayOrObject) ? this.copy(arrayOrObject) : this.fromObject(arrayOrObject);\n  }\n\n  to(arrayOrObject) {\n    if (arrayOrObject === this) {\n      return this;\n    }\n\n    return isArray(arrayOrObject) ? this.toArray(arrayOrObject) : this.toObject(arrayOrObject);\n  }\n\n  toTarget(target) {\n    return target ? this.to(target) : this;\n  }\n\n  toFloat32Array() {\n    return new Float32Array(this);\n  }\n\n  toString() {\n    return this.formatString(config);\n  }\n\n  formatString(opts) {\n    let string = '';\n\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      string += (i > 0 ? ', ' : '') + formatValue(this[i], opts);\n    }\n\n    return \"\".concat(opts.printTypes ? this.constructor.name : '', \"[\").concat(string, \"]\");\n  }\n\n  equals(array) {\n    if (!array || this.length !== array.length) {\n      return false;\n    }\n\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      if (!equals(this[i], array[i])) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  exactEquals(array) {\n    if (!array || this.length !== array.length) {\n      return false;\n    }\n\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      if (this[i] !== array[i]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  negate() {\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      this[i] = -this[i];\n    }\n\n    return this.check();\n  }\n\n  lerp(a, b, t) {\n    if (t === undefined) {\n      return this.lerp(this, a, b);\n    }\n\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      const ai = a[i];\n      this[i] = ai + t * (b[i] - ai);\n    }\n\n    return this.check();\n  }\n\n  min(vector) {\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      this[i] = Math.min(vector[i], this[i]);\n    }\n\n    return this.check();\n  }\n\n  max(vector) {\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      this[i] = Math.max(vector[i], this[i]);\n    }\n\n    return this.check();\n  }\n\n  clamp(minVector, maxVector) {\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      this[i] = Math.min(Math.max(this[i], minVector[i]), maxVector[i]);\n    }\n\n    return this.check();\n  }\n\n  add(...vectors) {\n    for (const vector of vectors) {\n      for (let i = 0; i < this.ELEMENTS; ++i) {\n        this[i] += vector[i];\n      }\n    }\n\n    return this.check();\n  }\n\n  subtract(...vectors) {\n    for (const vector of vectors) {\n      for (let i = 0; i < this.ELEMENTS; ++i) {\n        this[i] -= vector[i];\n      }\n    }\n\n    return this.check();\n  }\n\n  scale(scale) {\n    if (typeof scale === 'number') {\n      for (let i = 0; i < this.ELEMENTS; ++i) {\n        this[i] *= scale;\n      }\n    } else {\n      for (let i = 0; i < this.ELEMENTS && i < scale.length; ++i) {\n        this[i] *= scale[i];\n      }\n    }\n\n    return this.check();\n  }\n\n  multiplyByScalar(scalar) {\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      this[i] *= scalar;\n    }\n\n    return this.check();\n  }\n\n  check() {\n    if (config.debug && !this.validate()) {\n      throw new Error(\"math.gl: \".concat(this.constructor.name, \" some fields set to invalid numbers'\"));\n    }\n\n    return this;\n  }\n\n  validate() {\n    let valid = this.length === this.ELEMENTS;\n\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      valid = valid && Number.isFinite(this[i]);\n    }\n\n    return valid;\n  }\n\n  sub(a) {\n    return this.subtract(a);\n  }\n\n  setScalar(a) {\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      this[i] = a;\n    }\n\n    return this.check();\n  }\n\n  addScalar(a) {\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      this[i] += a;\n    }\n\n    return this.check();\n  }\n\n  subScalar(a) {\n    return this.addScalar(-a);\n  }\n\n  multiplyScalar(scalar) {\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      this[i] *= scalar;\n    }\n\n    return this.check();\n  }\n\n  divideScalar(a) {\n    return this.multiplyByScalar(1 / a);\n  }\n\n  clampScalar(min, max) {\n    for (let i = 0; i < this.ELEMENTS; ++i) {\n      this[i] = Math.min(Math.max(this[i], min), max);\n    }\n\n    return this.check();\n  }\n\n  get elements() {\n    return this;\n  }\n\n}\n//# sourceMappingURL=math-array.js.map","// Copyright (c) 2015-2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\nimport {COORDINATE_SYSTEM, PROJECTION_MODE} from '../../lib/constants';\nimport project from '../project/project';\nimport {Vector3, Matrix4} from '@math.gl/core';\nimport memoize from '../../utils/memoize';\nimport {pixelsToWorld} from '@math.gl/web-mercator';\n\nimport type {Texture2D} from '@luma.gl/webgl';\nimport type {ShaderModule, NumericArray} from '../../types/types';\nimport type Viewport from '../../viewports/viewport';\nimport type {ProjectUniforms} from '../project/viewport-uniforms';\n\nconst vs = `\nconst int max_lights = 2;\nuniform mat4 shadow_uViewProjectionMatrices[max_lights];\nuniform vec4 shadow_uProjectCenters[max_lights];\nuniform bool shadow_uDrawShadowMap;\nuniform bool shadow_uUseShadowMap;\nuniform int shadow_uLightId;\nuniform float shadow_uLightCount;\n\nvarying vec3 shadow_vPosition[max_lights];\n\nvec4 shadow_setVertexPosition(vec4 position_commonspace) {\n  if (shadow_uDrawShadowMap) {\n    return project_common_position_to_clipspace(position_commonspace, shadow_uViewProjectionMatrices[shadow_uLightId], shadow_uProjectCenters[shadow_uLightId]);\n  }\n  if (shadow_uUseShadowMap) {\n    for (int i = 0; i < max_lights; i++) {\n      if(i < int(shadow_uLightCount)) {\n        vec4 shadowMap_position = project_common_position_to_clipspace(position_commonspace, shadow_uViewProjectionMatrices[i], shadow_uProjectCenters[i]);\n        shadow_vPosition[i] = (shadowMap_position.xyz / shadowMap_position.w + 1.0) / 2.0;\n      }\n    }\n  }\n  return gl_Position;\n}\n`;\n\nconst fs = `\nconst int max_lights = 2;\nuniform bool shadow_uDrawShadowMap;\nuniform bool shadow_uUseShadowMap;\nuniform sampler2D shadow_uShadowMap0;\nuniform sampler2D shadow_uShadowMap1;\nuniform vec4 shadow_uColor;\nuniform float shadow_uLightCount;\n\nvarying vec3 shadow_vPosition[max_lights];\n\nconst vec4 bitPackShift = vec4(1.0, 255.0, 65025.0, 16581375.0);\nconst vec4 bitUnpackShift = 1.0 / bitPackShift;\nconst vec4 bitMask = vec4(1.0 / 255.0, 1.0 / 255.0, 1.0 / 255.0,  0.0);\n\nfloat shadow_getShadowWeight(vec3 position, sampler2D shadowMap) {\n  vec4 rgbaDepth = texture2D(shadowMap, position.xy);\n\n  float z = dot(rgbaDepth, bitUnpackShift);\n  return smoothstep(0.001, 0.01, position.z - z);\n}\n\nvec4 shadow_filterShadowColor(vec4 color) {\n  if (shadow_uDrawShadowMap) {\n    vec4 rgbaDepth = fract(gl_FragCoord.z * bitPackShift);\n    rgbaDepth -= rgbaDepth.gbaa * bitMask;\n    return rgbaDepth;\n  }\n  if (shadow_uUseShadowMap) {\n    float shadowAlpha = 0.0;\n    shadowAlpha += shadow_getShadowWeight(shadow_vPosition[0], shadow_uShadowMap0);\n    if(shadow_uLightCount > 1.0) {\n      shadowAlpha += shadow_getShadowWeight(shadow_vPosition[1], shadow_uShadowMap1);\n    }\n    shadowAlpha *= shadow_uColor.a / shadow_uLightCount;\n    float blendedAlpha = shadowAlpha + color.a * (1.0 - shadowAlpha);\n\n    return vec4(\n      mix(color.rgb, shadow_uColor.rgb, shadowAlpha / blendedAlpha),\n      blendedAlpha\n    );\n  }\n  return color;\n}\n`;\n\nconst getMemoizedViewportCenterPosition = memoize(getViewportCenterPosition);\nconst getMemoizedViewProjectionMatrices = memoize(getViewProjectionMatrices);\n\nconst DEFAULT_SHADOW_COLOR = [0, 0, 0, 1.0];\nconst VECTOR_TO_POINT_MATRIX = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0];\n\ntype ShadowModuleSettings = {\n  viewport: Viewport;\n  shadowEnabled?: boolean;\n  drawToShadowMap?: boolean;\n  shadowMaps?: Texture2D[];\n  dummyShadowMap?: Texture2D;\n  shadowColor?: number[];\n  shadowMatrices?: Matrix4[];\n  shadowLightId?: number;\n};\n\nfunction screenToCommonSpace(xyz: number[], pixelUnprojectionMatrix: number[]): number[] {\n  const [x, y, z] = xyz;\n  const coord = pixelsToWorld([x, y, z], pixelUnprojectionMatrix);\n\n  if (Number.isFinite(z)) {\n    return coord;\n  }\n  return [coord[0], coord[1], 0];\n}\n\nfunction getViewportCenterPosition({\n  viewport,\n  center\n}: {\n  viewport: Viewport;\n  center: NumericArray;\n}): NumericArray {\n  return new Matrix4(viewport.viewProjectionMatrix).invert().transform(center);\n}\n\nfunction getViewProjectionMatrices({\n  viewport,\n  shadowMatrices\n}: {\n  viewport: Viewport;\n  shadowMatrices: Matrix4[];\n}): Matrix4[] {\n  const projectionMatrices: Matrix4[] = [];\n  const pixelUnprojectionMatrix = viewport.pixelUnprojectionMatrix;\n  const farZ = viewport.isGeospatial ? undefined : 1;\n  const corners = [\n    [0, 0, farZ], // top left ground\n    [viewport.width, 0, farZ], // top right ground\n    [0, viewport.height, farZ], // bottom left ground\n    [viewport.width, viewport.height, farZ], // bottom right ground\n    [0, 0, -1], // top left near\n    [viewport.width, 0, -1], // top right near\n    [0, viewport.height, -1], // bottom left near\n    [viewport.width, viewport.height, -1] // bottom right near\n  ].map(pixel =>\n    // @ts-expect-error z may be undefined\n    screenToCommonSpace(pixel, pixelUnprojectionMatrix)\n  );\n\n  for (const shadowMatrix of shadowMatrices) {\n    const viewMatrix = shadowMatrix.clone().translate(new Vector3(viewport.center).negate());\n    const positions = corners.map(corner => viewMatrix.transform(corner));\n    const projectionMatrix = new Matrix4().ortho({\n      left: Math.min(...positions.map(position => position[0])),\n      right: Math.max(...positions.map(position => position[0])),\n      bottom: Math.min(...positions.map(position => position[1])),\n      top: Math.max(...positions.map(position => position[1])),\n      near: Math.min(...positions.map(position => -position[2])),\n      far: Math.max(...positions.map(position => -position[2]))\n    });\n    projectionMatrices.push(projectionMatrix.multiplyRight(shadowMatrix));\n  }\n  return projectionMatrices;\n}\n\n/* eslint-disable camelcase */\nfunction createShadowUniforms(\n  opts: ShadowModuleSettings,\n  context: ProjectUniforms\n): Record<string, any> {\n  const {shadowEnabled = true} = opts;\n  if (!shadowEnabled || !opts.shadowMatrices || !opts.shadowMatrices.length) {\n    return {\n      shadow_uDrawShadowMap: false,\n      shadow_uUseShadowMap: false\n    };\n  }\n  const uniforms = {\n    shadow_uDrawShadowMap: Boolean(opts.drawToShadowMap),\n    shadow_uUseShadowMap: opts.shadowMaps ? opts.shadowMaps.length > 0 : false,\n    shadow_uColor: opts.shadowColor || DEFAULT_SHADOW_COLOR,\n    shadow_uLightId: opts.shadowLightId || 0,\n    shadow_uLightCount: opts.shadowMatrices.length\n  };\n\n  const center = getMemoizedViewportCenterPosition({\n    viewport: opts.viewport,\n    center: context.project_uCenter\n  });\n\n  const projectCenters: NumericArray[] = [];\n  const viewProjectionMatrices = getMemoizedViewProjectionMatrices({\n    shadowMatrices: opts.shadowMatrices,\n    viewport: opts.viewport\n  }).slice();\n\n  for (let i = 0; i < opts.shadowMatrices.length; i++) {\n    const viewProjectionMatrix = viewProjectionMatrices[i];\n    const viewProjectionMatrixCentered = viewProjectionMatrix\n      .clone()\n      .translate(new Vector3(opts.viewport.center).negate());\n\n    if (\n      context.project_uCoordinateSystem === COORDINATE_SYSTEM.LNGLAT &&\n      context.project_uProjectionMode === PROJECTION_MODE.WEB_MERCATOR\n    ) {\n      viewProjectionMatrices[i] = viewProjectionMatrixCentered;\n      projectCenters[i] = center;\n    } else {\n      viewProjectionMatrices[i] = viewProjectionMatrix\n        .clone()\n        .multiplyRight(VECTOR_TO_POINT_MATRIX);\n      projectCenters[i] = viewProjectionMatrixCentered.transform(center);\n    }\n  }\n\n  for (let i = 0; i < viewProjectionMatrices.length; i++) {\n    uniforms[`shadow_uViewProjectionMatrices[${i}]`] = viewProjectionMatrices[i];\n    uniforms[`shadow_uProjectCenters[${i}]`] = projectCenters[i];\n\n    if (opts.shadowMaps && opts.shadowMaps.length > 0) {\n      uniforms[`shadow_uShadowMap${i}`] = opts.shadowMaps[i];\n    } else {\n      uniforms[`shadow_uShadowMap${i}`] = opts.dummyShadowMap;\n    }\n  }\n  return uniforms;\n}\n\nexport default {\n  name: 'shadow',\n  dependencies: [project],\n  vs,\n  fs,\n  inject: {\n    'vs:DECKGL_FILTER_GL_POSITION': `\n    position = shadow_setVertexPosition(geometry.position);\n    `,\n    'fs:DECKGL_FILTER_COLOR': `\n    color = shadow_filterShadowColor(color);\n    `\n  },\n  getUniforms: (opts = {}, context = {}) => {\n    if (\n      'viewport' in opts &&\n      (opts.drawToShadowMap || (opts.shadowMaps && opts.shadowMaps.length > 0))\n    ) {\n      // @ts-expect-error if opts.viewport is defined, context should contain the project module's uniforms\n      return createShadowUniforms(opts, context);\n    }\n    return {};\n  }\n} as ShaderModule<ShadowModuleSettings>;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n/* eslint-disable complexity, camelcase */\n\nimport * as mat4 from 'gl-matrix/mat4';\nimport * as vec4 from 'gl-matrix/vec4';\n\nimport {COORDINATE_SYSTEM, PROJECTION_MODE} from '../../lib/constants';\n\nimport memoize from '../../utils/memoize';\n\nimport type Viewport from '../../viewports/viewport';\nimport type {CoordinateSystem} from '../../lib/constants';\nimport type {NumericArray} from '../../types/types';\n\ntype Vec3 = [number, number, number];\ntype Vec4 = [number, number, number, number];\n\n// To quickly set a vector to zero\nconst ZERO_VECTOR: Vec4 = [0, 0, 0, 0];\n// 4x4 matrix that drops 4th component of vector\nconst VECTOR_TO_POINT_MATRIX = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0];\nconst IDENTITY_MATRIX = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];\nconst DEFAULT_PIXELS_PER_UNIT2: Vec3 = [0, 0, 0];\nconst DEFAULT_COORDINATE_ORIGIN: Vec3 = [0, 0, 0];\n\nconst getMemoizedViewportUniforms = memoize(calculateViewportUniforms);\n\nexport function getOffsetOrigin(\n  viewport: Viewport,\n  coordinateSystem: CoordinateSystem,\n  coordinateOrigin: Vec3 = DEFAULT_COORDINATE_ORIGIN\n): {\n  geospatialOrigin: Vec3 | null;\n  shaderCoordinateOrigin: Vec3;\n  offsetMode: boolean;\n} {\n  if (coordinateOrigin.length < 3) {\n    coordinateOrigin = [coordinateOrigin[0], coordinateOrigin[1], 0];\n  }\n\n  let shaderCoordinateOrigin = coordinateOrigin;\n  let geospatialOrigin: Vec3 | null;\n  let offsetMode = true;\n\n  if (\n    coordinateSystem === COORDINATE_SYSTEM.LNGLAT_OFFSETS ||\n    coordinateSystem === COORDINATE_SYSTEM.METER_OFFSETS\n  ) {\n    geospatialOrigin = coordinateOrigin;\n  } else {\n    geospatialOrigin = viewport.isGeospatial\n      ? // @ts-expect-error longitude and latitude are not defined on the base Viewport, but is expected on geospatial viewports\n        [Math.fround(viewport.longitude), Math.fround(viewport.latitude), 0]\n      : null;\n  }\n\n  switch (viewport.projectionMode) {\n    case PROJECTION_MODE.WEB_MERCATOR:\n      if (\n        coordinateSystem === COORDINATE_SYSTEM.LNGLAT ||\n        coordinateSystem === COORDINATE_SYSTEM.CARTESIAN\n      ) {\n        geospatialOrigin = [0, 0, 0];\n        offsetMode = false;\n      }\n      break;\n\n    case PROJECTION_MODE.WEB_MERCATOR_AUTO_OFFSET:\n      if (coordinateSystem === COORDINATE_SYSTEM.LNGLAT) {\n        // viewport center in world space\n        // @ts-expect-error when using LNGLAT coordinates, we expect the viewport to be geospatial, in which case geospatialOrigin is defined\n        shaderCoordinateOrigin = geospatialOrigin;\n      } else if (coordinateSystem === COORDINATE_SYSTEM.CARTESIAN) {\n        // viewport center in common space\n        shaderCoordinateOrigin = [\n          Math.fround(viewport.center[0]),\n          Math.fround(viewport.center[1]),\n          0\n        ];\n        // Geospatial origin (wgs84) must match shaderCoordinateOrigin (common)\n        geospatialOrigin = viewport.unprojectPosition(shaderCoordinateOrigin);\n        shaderCoordinateOrigin[0] -= coordinateOrigin[0];\n        shaderCoordinateOrigin[1] -= coordinateOrigin[1];\n        shaderCoordinateOrigin[2] -= coordinateOrigin[2];\n      }\n      break;\n\n    case PROJECTION_MODE.IDENTITY:\n      shaderCoordinateOrigin = viewport.position.map(Math.fround) as Vec3;\n      shaderCoordinateOrigin[2] = shaderCoordinateOrigin[2] || 0;\n      break;\n\n    case PROJECTION_MODE.GLOBE:\n      offsetMode = false;\n      geospatialOrigin = null;\n      break;\n\n    default:\n      // Unknown projection mode\n      offsetMode = false;\n  }\n\n  return {geospatialOrigin, shaderCoordinateOrigin, offsetMode};\n}\n\n// The code that utilizes Matrix4 does the same calculation as their mat4 counterparts,\n// has lower performance but provides error checking.\nfunction calculateMatrixAndOffset(\n  viewport: Viewport,\n  coordinateSystem: CoordinateSystem,\n  coordinateOrigin: Vec3\n): {\n  viewMatrix: NumericArray;\n  viewProjectionMatrix: NumericArray;\n  projectionCenter: Vec4;\n  originCommon: Vec4;\n  cameraPosCommon: Vec3;\n  shaderCoordinateOrigin: Vec3;\n  geospatialOrigin: Vec3 | null;\n} {\n  const {viewMatrixUncentered, projectionMatrix} = viewport;\n  let {viewMatrix, viewProjectionMatrix} = viewport;\n\n  let projectionCenter = ZERO_VECTOR;\n  let originCommon: Vec4 = ZERO_VECTOR;\n  let cameraPosCommon: Vec3 = viewport.cameraPosition as Vec3;\n  const {geospatialOrigin, shaderCoordinateOrigin, offsetMode} = getOffsetOrigin(\n    viewport,\n    coordinateSystem,\n    coordinateOrigin\n  );\n\n  if (offsetMode) {\n    // Calculate transformed projectionCenter (using 64 bit precision JS)\n    // This is the key to offset mode precision\n    // (avoids doing this addition in 32 bit precision in GLSL)\n    // @ts-expect-error the 4th component is assigned below\n    originCommon = viewport.projectPosition(geospatialOrigin || shaderCoordinateOrigin);\n\n    cameraPosCommon = [\n      cameraPosCommon[0] - originCommon[0],\n      cameraPosCommon[1] - originCommon[1],\n      cameraPosCommon[2] - originCommon[2]\n    ];\n\n    originCommon[3] = 1;\n\n    // projectionCenter = new Matrix4(viewProjectionMatrix)\n    //   .transformVector([positionPixels[0], positionPixels[1], 0.0, 1.0]);\n    projectionCenter = vec4.transformMat4([], originCommon, viewProjectionMatrix);\n\n    // Always apply uncentered projection matrix if available (shader adds center)\n    viewMatrix = viewMatrixUncentered || viewMatrix;\n\n    // Zero out 4th coordinate (\"after\" model matrix) - avoids further translations\n    // viewMatrix = new Matrix4(viewMatrixUncentered || viewMatrix)\n    //   .multiplyRight(VECTOR_TO_POINT_MATRIX);\n    viewProjectionMatrix = mat4.multiply([], projectionMatrix, viewMatrix);\n    viewProjectionMatrix = mat4.multiply([], viewProjectionMatrix, VECTOR_TO_POINT_MATRIX);\n  }\n\n  return {\n    viewMatrix,\n    viewProjectionMatrix,\n    projectionCenter,\n    originCommon,\n    cameraPosCommon,\n    shaderCoordinateOrigin,\n    geospatialOrigin\n  };\n}\n\nexport type ProjectUniforms = {\n  project_uCoordinateSystem: number;\n  project_uProjectionMode: number;\n  project_uCoordinateOrigin: Vec3;\n  project_uCommonOrigin: Vec3;\n  project_uCenter: Vec4;\n  // Backward compatibility\n  // TODO: remove in v9\n  project_uPseudoMeters: boolean;\n\n  // Screen size\n  project_uViewportSize: [number, number];\n  project_uDevicePixelRatio: number;\n\n  project_uFocalDistance: number;\n  project_uCommonUnitsPerMeter: Vec3;\n  project_uCommonUnitsPerWorldUnit: Vec3;\n  project_uCommonUnitsPerWorldUnit2: Vec3;\n  /** 2^zoom */\n  project_uScale: number;\n  project_uWrapLongitude: boolean;\n\n  project_uViewProjectionMatrix: NumericArray;\n  project_uModelMatrix: NumericArray;\n\n  // This is for lighting calculations\n  project_uCameraPosition: Vec3;\n};\n\nexport type ProjectModuleSettings = {\n  viewport: Viewport;\n  devicePixelRatio?: number;\n  modelMatrix?: NumericArray | null;\n  coordinateSystem?: CoordinateSystem;\n  coordinateOrigin?: Vec3;\n  autoWrapLongitude?: boolean;\n};\n\n/**\n * Returns uniforms for shaders based on current projection\n * includes: projection matrix suitable for shaders\n *\n * TODO - Ensure this works with any viewport, not just WebMercatorViewports\n *\n * @param {WebMercatorViewport} viewport -\n * @return {Float32Array} - 4x4 projection matrix that can be used in shaders\n */\nexport function getUniformsFromViewport({\n  viewport,\n  devicePixelRatio = 1,\n  modelMatrix = null,\n  // Match Layer.defaultProps\n  coordinateSystem = COORDINATE_SYSTEM.DEFAULT,\n  coordinateOrigin = DEFAULT_COORDINATE_ORIGIN,\n  autoWrapLongitude = false\n}: ProjectModuleSettings): ProjectUniforms {\n  if (coordinateSystem === COORDINATE_SYSTEM.DEFAULT) {\n    coordinateSystem = viewport.isGeospatial\n      ? COORDINATE_SYSTEM.LNGLAT\n      : COORDINATE_SYSTEM.CARTESIAN;\n  }\n\n  const uniforms = getMemoizedViewportUniforms({\n    viewport,\n    devicePixelRatio,\n    coordinateSystem,\n    coordinateOrigin\n  });\n\n  uniforms.project_uWrapLongitude = autoWrapLongitude;\n  uniforms.project_uModelMatrix = modelMatrix || IDENTITY_MATRIX;\n\n  return uniforms;\n}\n\nfunction calculateViewportUniforms({\n  viewport,\n  devicePixelRatio,\n  coordinateSystem,\n  coordinateOrigin\n}: {\n  viewport: Viewport;\n  devicePixelRatio: number;\n  coordinateSystem: CoordinateSystem;\n  coordinateOrigin: Vec3;\n}): ProjectUniforms {\n  const {\n    projectionCenter,\n    viewProjectionMatrix,\n    originCommon,\n    cameraPosCommon,\n    shaderCoordinateOrigin,\n    geospatialOrigin\n  } = calculateMatrixAndOffset(viewport, coordinateSystem, coordinateOrigin);\n\n  // Calculate projection pixels per unit\n  const distanceScales = viewport.getDistanceScales();\n\n  const viewportSize: [number, number] = [\n    viewport.width * devicePixelRatio,\n    viewport.height * devicePixelRatio\n  ];\n\n  // Distance at which screen pixels are projected.\n  // Used to scale sizes in clipspace to match screen pixels.\n  // When using Viewport class's default projection matrix, this yields 1 for orthographic\n  // and `viewport.focalDistance` for perspective views\n  const focalDistance =\n    vec4.transformMat4([], [0, 0, -viewport.focalDistance, 1], viewport.projectionMatrix)[3] || 1;\n\n  const uniforms: ProjectUniforms = {\n    // Projection mode values\n    project_uCoordinateSystem: coordinateSystem,\n    project_uProjectionMode: viewport.projectionMode,\n    project_uCoordinateOrigin: shaderCoordinateOrigin,\n    project_uCommonOrigin: originCommon.slice(0, 3) as Vec3,\n    project_uCenter: projectionCenter,\n\n    // Backward compatibility\n    // TODO: remove in v9\n    // @ts-expect-error _pseudoMeters is only defined on WebMercator viewport\n    project_uPseudoMeters: Boolean(viewport._pseudoMeters),\n\n    // Screen size\n    project_uViewportSize: viewportSize,\n    project_uDevicePixelRatio: devicePixelRatio,\n\n    project_uFocalDistance: focalDistance,\n    project_uCommonUnitsPerMeter: distanceScales.unitsPerMeter as Vec3,\n    project_uCommonUnitsPerWorldUnit: distanceScales.unitsPerMeter as Vec3,\n    project_uCommonUnitsPerWorldUnit2: DEFAULT_PIXELS_PER_UNIT2,\n    project_uScale: viewport.scale, // This is the mercator scale (2 ** zoom)\n    project_uWrapLongitude: false,\n\n    project_uViewProjectionMatrix: viewProjectionMatrix,\n    project_uModelMatrix: IDENTITY_MATRIX,\n\n    // This is for lighting calculations\n    project_uCameraPosition: cameraPosCommon\n  };\n\n  if (geospatialOrigin) {\n    // Get high-precision DistanceScales from geospatial viewport\n    // TODO: stricter types in Viewport classes\n    const distanceScalesAtOrigin = viewport.getDistanceScales(geospatialOrigin) as {\n      unitsPerMeter: Vec3;\n      metersPerUnit: Vec3;\n      unitsPerMeter2: Vec3;\n      unitsPerDegree: Vec3;\n      degreesPerUnit: Vec3;\n      unitsPerDegree2: Vec3;\n    };\n    switch (coordinateSystem) {\n      case COORDINATE_SYSTEM.METER_OFFSETS:\n        uniforms.project_uCommonUnitsPerWorldUnit = distanceScalesAtOrigin.unitsPerMeter;\n        uniforms.project_uCommonUnitsPerWorldUnit2 = distanceScalesAtOrigin.unitsPerMeter2;\n        break;\n\n      case COORDINATE_SYSTEM.LNGLAT:\n      case COORDINATE_SYSTEM.LNGLAT_OFFSETS:\n        // @ts-expect-error _pseudoMeters only exists on WebMercatorView\n        if (!viewport._pseudoMeters) {\n          uniforms.project_uCommonUnitsPerMeter = distanceScalesAtOrigin.unitsPerMeter;\n        }\n        uniforms.project_uCommonUnitsPerWorldUnit = distanceScalesAtOrigin.unitsPerDegree;\n        uniforms.project_uCommonUnitsPerWorldUnit2 = distanceScalesAtOrigin.unitsPerDegree2;\n        break;\n\n      // a.k.a \"preprojected\" positions\n      case COORDINATE_SYSTEM.CARTESIAN:\n        uniforms.project_uCommonUnitsPerWorldUnit = [1, 1, distanceScalesAtOrigin.unitsPerMeter[2]];\n        uniforms.project_uCommonUnitsPerWorldUnit2 = [\n          0,\n          0,\n          distanceScalesAtOrigin.unitsPerMeter2[2]\n        ];\n        break;\n\n      default:\n        break;\n    }\n  }\n\n  return uniforms;\n}\n","import type Viewport from '../viewports/viewport';\n\nexport default abstract class ViewState<T, Props, State> implements IViewState<T> {\n  private _viewportProps: Required<Props>;\n  private _state: State;\n\n  constructor(props: Required<Props>, state: State) {\n    this._viewportProps = this.applyConstraints(props);\n    this._state = state;\n  }\n\n  getViewportProps(): Required<Props> {\n    return this._viewportProps;\n  }\n\n  getState(): State {\n    return this._state;\n  }\n\n  abstract applyConstraints(props: Required<Props>): Required<Props>;\n\n  abstract shortestPathFrom(viewState: T): Props;\n\n  abstract panStart(params: {pos: [number, number]}): T;\n  abstract pan({pos, startPos}: {pos: [number, number]; startPos?: [number, number]}): T;\n  abstract panEnd(): T;\n\n  abstract rotateStart(params: {pos: [number, number]}): T;\n  abstract rotate(params: {pos?: [number, number]; deltaAngleX?: number; deltaAngleY: number}): T;\n  abstract rotateEnd(): T;\n\n  abstract zoomStart({pos}: {pos: [number, number]}): T;\n  abstract zoom({\n    pos,\n    startPos,\n    scale\n  }: {\n    pos: [number, number];\n    startPos?: [number, number];\n    scale: number;\n  }): T;\n  abstract zoomEnd(): T;\n\n  abstract zoomIn(speed?: number): T;\n  abstract zoomOut(speed?: number): T;\n\n  abstract moveLeft(speed?: number): T;\n  abstract moveRight(speed?: number): T;\n  abstract moveUp(speed?: number): T;\n  abstract moveDown(speed?: number): T;\n\n  abstract rotateLeft(speed?: number): T;\n  abstract rotateRight(speed?: number): T;\n  abstract rotateUp(speed?: number): T;\n  abstract rotateDown(speed?: number): T;\n}\n\nexport interface IViewState<T> {\n  makeViewport?: (props: Record<string, any>) => Viewport;\n\n  getViewportProps(): Record<string, any>;\n\n  getState(): Record<string, any>;\n\n  shortestPathFrom(viewState: T): Record<string, any>;\n\n  panStart(params: {pos: [number, number]}): T;\n  pan({pos, startPos}: {pos: [number, number]; startPos?: [number, number]}): T;\n  panEnd(): T;\n\n  rotateStart(params: {pos: [number, number]}): T;\n  rotate(params: {pos?: [number, number]; deltaAngleX?: number; deltaAngleY?: number}): T;\n  rotateEnd(): T;\n\n  zoomStart({pos}: {pos: [number, number]}): T;\n  zoom({\n    pos,\n    startPos,\n    scale\n  }: {\n    pos: [number, number];\n    startPos?: [number, number];\n    scale: number;\n  }): T;\n  zoomEnd(): T;\n\n  zoomIn(speed?: number): T;\n  zoomOut(speed?: number): T;\n\n  moveLeft(speed?: number): T;\n  moveRight(speed?: number): T;\n  moveUp(speed?: number): T;\n  moveDown(speed?: number): T;\n\n  rotateLeft(speed?: number): T;\n  rotateRight(speed?: number): T;\n  rotateUp(speed?: number): T;\n  rotateDown(speed?: number): T;\n}\n","import { concatenateArrayBuffersAsync } from '@loaders.gl/loader-utils';\nimport { isResponse, isReadableStream, isAsyncIterable, isIterable, isIterator, isBlob, isBuffer } from '../../javascript-utils/is-type';\nimport { makeIterator } from '../../iterators/make-iterator/make-iterator';\nimport { checkResponse, makeResponse } from '../utils/response-utils';\nconst ERR_DATA = 'Cannot convert supplied data type';\nexport function getArrayBufferOrStringFromDataSync(data, loader, options) {\n  if (loader.text && typeof data === 'string') {\n    return data;\n  }\n\n  if (isBuffer(data)) {\n    data = data.buffer;\n  }\n\n  if (data instanceof ArrayBuffer) {\n    const arrayBuffer = data;\n\n    if (loader.text && !loader.binary) {\n      const textDecoder = new TextDecoder('utf8');\n      return textDecoder.decode(arrayBuffer);\n    }\n\n    return arrayBuffer;\n  }\n\n  if (ArrayBuffer.isView(data)) {\n    if (loader.text && !loader.binary) {\n      const textDecoder = new TextDecoder('utf8');\n      return textDecoder.decode(data);\n    }\n\n    let arrayBuffer = data.buffer;\n    const byteLength = data.byteLength || data.length;\n\n    if (data.byteOffset !== 0 || byteLength !== arrayBuffer.byteLength) {\n      arrayBuffer = arrayBuffer.slice(data.byteOffset, data.byteOffset + byteLength);\n    }\n\n    return arrayBuffer;\n  }\n\n  throw new Error(ERR_DATA);\n}\nexport async function getArrayBufferOrStringFromData(data, loader, options) {\n  const isArrayBuffer = data instanceof ArrayBuffer || ArrayBuffer.isView(data);\n\n  if (typeof data === 'string' || isArrayBuffer) {\n    return getArrayBufferOrStringFromDataSync(data, loader, options);\n  }\n\n  if (isBlob(data)) {\n    data = await makeResponse(data);\n  }\n\n  if (isResponse(data)) {\n    const response = data;\n    await checkResponse(response);\n    return loader.binary ? await response.arrayBuffer() : await response.text();\n  }\n\n  if (isReadableStream(data)) {\n    data = makeIterator(data, options);\n  }\n\n  if (isIterable(data) || isAsyncIterable(data)) {\n    return concatenateArrayBuffersAsync(data);\n  }\n\n  throw new Error(ERR_DATA);\n}\nexport async function getAsyncIterableFromData(data, options) {\n  if (isIterator(data)) {\n    return data;\n  }\n\n  if (isResponse(data)) {\n    const response = data;\n    await checkResponse(response);\n    const body = await response.body;\n    return makeIterator(body, options);\n  }\n\n  if (isBlob(data) || isReadableStream(data)) {\n    return makeIterator(data, options);\n  }\n\n  if (isAsyncIterable(data)) {\n    return data[Symbol.asyncIterator]();\n  }\n\n  return getIterableFromData(data);\n}\nexport async function getReadableStream(data) {\n  if (isReadableStream(data)) {\n    return data;\n  }\n\n  if (isResponse(data)) {\n    return data.body;\n  }\n\n  const response = await makeResponse(data);\n  return response.body;\n}\n\nfunction getIterableFromData(data) {\n  if (ArrayBuffer.isView(data)) {\n    return function* oneChunk() {\n      yield data.buffer;\n    }();\n  }\n\n  if (data instanceof ArrayBuffer) {\n    return function* oneChunk() {\n      yield data;\n    }();\n  }\n\n  if (isIterator(data)) {\n    return data;\n  }\n\n  if (isIterable(data)) {\n    return data[Symbol.iterator]();\n  }\n\n  throw new Error(ERR_DATA);\n}\n//# sourceMappingURL=get-data.js.map","const DEFAULT_CHUNK_SIZE = 256 * 1024;\nexport function* makeArrayBufferIterator(arrayBuffer, options = {}) {\n  const {\n    chunkSize = DEFAULT_CHUNK_SIZE\n  } = options;\n  let byteOffset = 0;\n\n  while (byteOffset < arrayBuffer.byteLength) {\n    const chunkByteLength = Math.min(arrayBuffer.byteLength - byteOffset, chunkSize);\n    const chunk = new ArrayBuffer(chunkByteLength);\n    const sourceArray = new Uint8Array(arrayBuffer, byteOffset, chunkByteLength);\n    const chunkArray = new Uint8Array(chunk);\n    chunkArray.set(sourceArray);\n    byteOffset += chunkByteLength;\n    yield chunk;\n  }\n}\n//# sourceMappingURL=make-array-buffer-iterator.js.map","import { isBrowser, toArrayBuffer } from '@loaders.gl/loader-utils';\nexport function makeStreamIterator(stream, options) {\n  return isBrowser ? makeBrowserStreamIterator(stream, options) : makeNodeStreamIterator(stream, options);\n}\n\nasync function* makeBrowserStreamIterator(stream, options) {\n  const reader = stream.getReader();\n  let nextBatchPromise;\n\n  try {\n    while (true) {\n      const currentBatchPromise = nextBatchPromise || reader.read();\n\n      if (options !== null && options !== void 0 && options._streamReadAhead) {\n        nextBatchPromise = reader.read();\n      }\n\n      const {\n        done,\n        value\n      } = await currentBatchPromise;\n\n      if (done) {\n        return;\n      }\n\n      yield toArrayBuffer(value);\n    }\n  } catch (error) {\n    reader.releaseLock();\n  }\n}\n\nasync function* makeNodeStreamIterator(stream, options) {\n  for await (const chunk of stream) {\n    yield toArrayBuffer(chunk);\n  }\n}\n//# sourceMappingURL=make-stream-iterator.js.map","import { makeStringIterator } from './make-string-iterator';\nimport { makeArrayBufferIterator } from './make-array-buffer-iterator';\nimport { makeBlobIterator } from './make-blob-iterator';\nimport { makeStreamIterator } from './make-stream-iterator';\nimport { isBlob, isReadableStream, isResponse } from '../../javascript-utils/is-type';\nexport function makeIterator(data, options) {\n  if (typeof data === 'string') {\n    return makeStringIterator(data, options);\n  }\n\n  if (data instanceof ArrayBuffer) {\n    return makeArrayBufferIterator(data, options);\n  }\n\n  if (isBlob(data)) {\n    return makeBlobIterator(data, options);\n  }\n\n  if (isReadableStream(data)) {\n    return makeStreamIterator(data, options);\n  }\n\n  if (isResponse(data)) {\n    const response = data;\n    return makeStreamIterator(response.body, options);\n  }\n\n  throw new Error('makeIterator');\n}\n//# sourceMappingURL=make-iterator.js.map","const DEFAULT_CHUNK_SIZE = 256 * 1024;\nexport function* makeStringIterator(string, options) {\n  const chunkSize = (options === null || options === void 0 ? void 0 : options.chunkSize) || DEFAULT_CHUNK_SIZE;\n  let offset = 0;\n  const textEncoder = new TextEncoder();\n\n  while (offset < string.length) {\n    const chunkLength = Math.min(string.length - offset, chunkSize);\n    const chunk = string.slice(offset, offset + chunkLength);\n    offset += chunkLength;\n    yield textEncoder.encode(chunk);\n  }\n}\n//# sourceMappingURL=make-string-iterator.js.map","const DEFAULT_CHUNK_SIZE = 1024 * 1024;\nexport async function* makeBlobIterator(blob, options) {\n  const chunkSize = (options === null || options === void 0 ? void 0 : options.chunkSize) || DEFAULT_CHUNK_SIZE;\n  let offset = 0;\n\n  while (offset < blob.size) {\n    const end = offset + chunkSize;\n    const chunk = await blob.slice(offset, end).arrayBuffer();\n    offset = end;\n    yield chunk;\n  }\n}\n//# sourceMappingURL=make-blob-iterator.js.map","/**\n * The _model_module_version/_view_module_version this package implements.\n *\n * The html widget manager assumes that this is the same as the npm package\n * version number.\n */\n\nexport const MODULE_VERSION =\n  typeof __VERSION__ === 'undefined' ? 'untranspiled source' : __VERSION__;\nexport const MODULE_NAME = '@deck.gl/jupyter-widget';\n","/*\r\n Copyright 2013 Daniel Wirtz <dcode@dcode.io>\r\n Copyright 2009 The Closure Library Authors. All Rights Reserved.\r\n\r\n Licensed under the Apache License, Version 2.0 (the \"License\");\r\n you may not use this file except in compliance with the License.\r\n You may obtain a copy of the License at\r\n\r\n http://www.apache.org/licenses/LICENSE-2.0\r\n\r\n Unless required by applicable law or agreed to in writing, software\r\n distributed under the License is distributed on an \"AS-IS\" BASIS,\r\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\n See the License for the specific language governing permissions and\r\n limitations under the License.\r\n */\r\n\r\n/**\r\n * @license long.js (c) 2013 Daniel Wirtz <dcode@dcode.io>\r\n * Released under the Apache License, Version 2.0\r\n * see: https://github.com/dcodeIO/long.js for details\r\n */\r\n(function(global, factory) {\r\n\r\n    /* AMD */ if (typeof define === 'function' && define[\"amd\"])\r\n        define([], factory);\r\n    /* CommonJS */ else if (typeof require === 'function' && typeof module === \"object\" && module && module[\"exports\"])\r\n        module[\"exports\"] = factory();\r\n    /* Global */ else\r\n        (global[\"dcodeIO\"] = global[\"dcodeIO\"] || {})[\"Long\"] = factory();\r\n\r\n})(this, function() {\r\n    \"use strict\";\r\n\r\n    /**\r\n     * Constructs a 64 bit two's-complement integer, given its low and high 32 bit values as *signed* integers.\r\n     *  See the from* functions below for more convenient ways of constructing Longs.\r\n     * @exports Long\r\n     * @class A Long class for representing a 64 bit two's-complement integer value.\r\n     * @param {number} low The low (signed) 32 bits of the long\r\n     * @param {number} high The high (signed) 32 bits of the long\r\n     * @param {boolean=} unsigned Whether unsigned or not, defaults to `false` for signed\r\n     * @constructor\r\n     */\r\n    function Long(low, high, unsigned) {\r\n\r\n        /**\r\n         * The low 32 bits as a signed value.\r\n         * @type {number}\r\n         */\r\n        this.low = low | 0;\r\n\r\n        /**\r\n         * The high 32 bits as a signed value.\r\n         * @type {number}\r\n         */\r\n        this.high = high | 0;\r\n\r\n        /**\r\n         * Whether unsigned or not.\r\n         * @type {boolean}\r\n         */\r\n        this.unsigned = !!unsigned;\r\n    }\r\n\r\n    // The internal representation of a long is the two given signed, 32-bit values.\r\n    // We use 32-bit pieces because these are the size of integers on which\r\n    // Javascript performs bit-operations.  For operations like addition and\r\n    // multiplication, we split each number into 16 bit pieces, which can easily be\r\n    // multiplied within Javascript's floating-point representation without overflow\r\n    // or change in sign.\r\n    //\r\n    // In the algorithms below, we frequently reduce the negative case to the\r\n    // positive case by negating the input(s) and then post-processing the result.\r\n    // Note that we must ALWAYS check specially whether those values are MIN_VALUE\r\n    // (-2^63) because -MIN_VALUE == MIN_VALUE (since 2^63 cannot be represented as\r\n    // a positive number, it overflows back into a negative).  Not handling this\r\n    // case would often result in infinite recursion.\r\n    //\r\n    // Common constant values ZERO, ONE, NEG_ONE, etc. are defined below the from*\r\n    // methods on which they depend.\r\n\r\n    /**\r\n     * An indicator used to reliably determine if an object is a Long or not.\r\n     * @type {boolean}\r\n     * @const\r\n     * @private\r\n     */\r\n    Long.prototype.__isLong__;\r\n\r\n    Object.defineProperty(Long.prototype, \"__isLong__\", {\r\n        value: true,\r\n        enumerable: false,\r\n        configurable: false\r\n    });\r\n\r\n    /**\r\n     * @function\r\n     * @param {*} obj Object\r\n     * @returns {boolean}\r\n     * @inner\r\n     */\r\n    function isLong(obj) {\r\n        return (obj && obj[\"__isLong__\"]) === true;\r\n    }\r\n\r\n    /**\r\n     * Tests if the specified object is a Long.\r\n     * @function\r\n     * @param {*} obj Object\r\n     * @returns {boolean}\r\n     */\r\n    Long.isLong = isLong;\r\n\r\n    /**\r\n     * A cache of the Long representations of small integer values.\r\n     * @type {!Object}\r\n     * @inner\r\n     */\r\n    var INT_CACHE = {};\r\n\r\n    /**\r\n     * A cache of the Long representations of small unsigned integer values.\r\n     * @type {!Object}\r\n     * @inner\r\n     */\r\n    var UINT_CACHE = {};\r\n\r\n    /**\r\n     * @param {number} value\r\n     * @param {boolean=} unsigned\r\n     * @returns {!Long}\r\n     * @inner\r\n     */\r\n    function fromInt(value, unsigned) {\r\n        var obj, cachedObj, cache;\r\n        if (unsigned) {\r\n            value >>>= 0;\r\n            if (cache = (0 <= value && value < 256)) {\r\n                cachedObj = UINT_CACHE[value];\r\n                if (cachedObj)\r\n                    return cachedObj;\r\n            }\r\n            obj = fromBits(value, (value | 0) < 0 ? -1 : 0, true);\r\n            if (cache)\r\n                UINT_CACHE[value] = obj;\r\n            return obj;\r\n        } else {\r\n            value |= 0;\r\n            if (cache = (-128 <= value && value < 128)) {\r\n                cachedObj = INT_CACHE[value];\r\n                if (cachedObj)\r\n                    return cachedObj;\r\n            }\r\n            obj = fromBits(value, value < 0 ? -1 : 0, false);\r\n            if (cache)\r\n                INT_CACHE[value] = obj;\r\n            return obj;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Returns a Long representing the given 32 bit integer value.\r\n     * @function\r\n     * @param {number} value The 32 bit integer in question\r\n     * @param {boolean=} unsigned Whether unsigned or not, defaults to `false` for signed\r\n     * @returns {!Long} The corresponding Long value\r\n     */\r\n    Long.fromInt = fromInt;\r\n\r\n    /**\r\n     * @param {number} value\r\n     * @param {boolean=} unsigned\r\n     * @returns {!Long}\r\n     * @inner\r\n     */\r\n    function fromNumber(value, unsigned) {\r\n        if (isNaN(value) || !isFinite(value))\r\n            return unsigned ? UZERO : ZERO;\r\n        if (unsigned) {\r\n            if (value < 0)\r\n                return UZERO;\r\n            if (value >= TWO_PWR_64_DBL)\r\n                return MAX_UNSIGNED_VALUE;\r\n        } else {\r\n            if (value <= -TWO_PWR_63_DBL)\r\n                return MIN_VALUE;\r\n            if (value + 1 >= TWO_PWR_63_DBL)\r\n                return MAX_VALUE;\r\n        }\r\n        if (value < 0)\r\n            return fromNumber(-value, unsigned).neg();\r\n        return fromBits((value % TWO_PWR_32_DBL) | 0, (value / TWO_PWR_32_DBL) | 0, unsigned);\r\n    }\r\n\r\n    /**\r\n     * Returns a Long representing the given value, provided that it is a finite number. Otherwise, zero is returned.\r\n     * @function\r\n     * @param {number} value The number in question\r\n     * @param {boolean=} unsigned Whether unsigned or not, defaults to `false` for signed\r\n     * @returns {!Long} The corresponding Long value\r\n     */\r\n    Long.fromNumber = fromNumber;\r\n\r\n    /**\r\n     * @param {number} lowBits\r\n     * @param {number} highBits\r\n     * @param {boolean=} unsigned\r\n     * @returns {!Long}\r\n     * @inner\r\n     */\r\n    function fromBits(lowBits, highBits, unsigned) {\r\n        return new Long(lowBits, highBits, unsigned);\r\n    }\r\n\r\n    /**\r\n     * Returns a Long representing the 64 bit integer that comes by concatenating the given low and high bits. Each is\r\n     *  assumed to use 32 bits.\r\n     * @function\r\n     * @param {number} lowBits The low 32 bits\r\n     * @param {number} highBits The high 32 bits\r\n     * @param {boolean=} unsigned Whether unsigned or not, defaults to `false` for signed\r\n     * @returns {!Long} The corresponding Long value\r\n     */\r\n    Long.fromBits = fromBits;\r\n\r\n    /**\r\n     * @function\r\n     * @param {number} base\r\n     * @param {number} exponent\r\n     * @returns {number}\r\n     * @inner\r\n     */\r\n    var pow_dbl = Math.pow; // Used 4 times (4*8 to 15+4)\r\n\r\n    /**\r\n     * @param {string} str\r\n     * @param {(boolean|number)=} unsigned\r\n     * @param {number=} radix\r\n     * @returns {!Long}\r\n     * @inner\r\n     */\r\n    function fromString(str, unsigned, radix) {\r\n        if (str.length === 0)\r\n            throw Error('empty string');\r\n        if (str === \"NaN\" || str === \"Infinity\" || str === \"+Infinity\" || str === \"-Infinity\")\r\n            return ZERO;\r\n        if (typeof unsigned === 'number') {\r\n            // For goog.math.long compatibility\r\n            radix = unsigned,\r\n            unsigned = false;\r\n        } else {\r\n            unsigned = !! unsigned;\r\n        }\r\n        radix = radix || 10;\r\n        if (radix < 2 || 36 < radix)\r\n            throw RangeError('radix');\r\n\r\n        var p;\r\n        if ((p = str.indexOf('-')) > 0)\r\n            throw Error('interior hyphen');\r\n        else if (p === 0) {\r\n            return fromString(str.substring(1), unsigned, radix).neg();\r\n        }\r\n\r\n        // Do several (8) digits each time through the loop, so as to\r\n        // minimize the calls to the very expensive emulated div.\r\n        var radixToPower = fromNumber(pow_dbl(radix, 8));\r\n\r\n        var result = ZERO;\r\n        for (var i = 0; i < str.length; i += 8) {\r\n            var size = Math.min(8, str.length - i),\r\n                value = parseInt(str.substring(i, i + size), radix);\r\n            if (size < 8) {\r\n                var power = fromNumber(pow_dbl(radix, size));\r\n                result = result.mul(power).add(fromNumber(value));\r\n            } else {\r\n                result = result.mul(radixToPower);\r\n                result = result.add(fromNumber(value));\r\n            }\r\n        }\r\n        result.unsigned = unsigned;\r\n        return result;\r\n    }\r\n\r\n    /**\r\n     * Returns a Long representation of the given string, written using the specified radix.\r\n     * @function\r\n     * @param {string} str The textual representation of the Long\r\n     * @param {(boolean|number)=} unsigned Whether unsigned or not, defaults to `false` for signed\r\n     * @param {number=} radix The radix in which the text is written (2-36), defaults to 10\r\n     * @returns {!Long} The corresponding Long value\r\n     */\r\n    Long.fromString = fromString;\r\n\r\n    /**\r\n     * @function\r\n     * @param {!Long|number|string|!{low: number, high: number, unsigned: boolean}} val\r\n     * @returns {!Long}\r\n     * @inner\r\n     */\r\n    function fromValue(val) {\r\n        if (val /* is compatible */ instanceof Long)\r\n            return val;\r\n        if (typeof val === 'number')\r\n            return fromNumber(val);\r\n        if (typeof val === 'string')\r\n            return fromString(val);\r\n        // Throws for non-objects, converts non-instanceof Long:\r\n        return fromBits(val.low, val.high, val.unsigned);\r\n    }\r\n\r\n    /**\r\n     * Converts the specified value to a Long.\r\n     * @function\r\n     * @param {!Long|number|string|!{low: number, high: number, unsigned: boolean}} val Value\r\n     * @returns {!Long}\r\n     */\r\n    Long.fromValue = fromValue;\r\n\r\n    // NOTE: the compiler should inline these constant values below and then remove these variables, so there should be\r\n    // no runtime penalty for these.\r\n\r\n    /**\r\n     * @type {number}\r\n     * @const\r\n     * @inner\r\n     */\r\n    var TWO_PWR_16_DBL = 1 << 16;\r\n\r\n    /**\r\n     * @type {number}\r\n     * @const\r\n     * @inner\r\n     */\r\n    var TWO_PWR_24_DBL = 1 << 24;\r\n\r\n    /**\r\n     * @type {number}\r\n     * @const\r\n     * @inner\r\n     */\r\n    var TWO_PWR_32_DBL = TWO_PWR_16_DBL * TWO_PWR_16_DBL;\r\n\r\n    /**\r\n     * @type {number}\r\n     * @const\r\n     * @inner\r\n     */\r\n    var TWO_PWR_64_DBL = TWO_PWR_32_DBL * TWO_PWR_32_DBL;\r\n\r\n    /**\r\n     * @type {number}\r\n     * @const\r\n     * @inner\r\n     */\r\n    var TWO_PWR_63_DBL = TWO_PWR_64_DBL / 2;\r\n\r\n    /**\r\n     * @type {!Long}\r\n     * @const\r\n     * @inner\r\n     */\r\n    var TWO_PWR_24 = fromInt(TWO_PWR_24_DBL);\r\n\r\n    /**\r\n     * @type {!Long}\r\n     * @inner\r\n     */\r\n    var ZERO = fromInt(0);\r\n\r\n    /**\r\n     * Signed zero.\r\n     * @type {!Long}\r\n     */\r\n    Long.ZERO = ZERO;\r\n\r\n    /**\r\n     * @type {!Long}\r\n     * @inner\r\n     */\r\n    var UZERO = fromInt(0, true);\r\n\r\n    /**\r\n     * Unsigned zero.\r\n     * @type {!Long}\r\n     */\r\n    Long.UZERO = UZERO;\r\n\r\n    /**\r\n     * @type {!Long}\r\n     * @inner\r\n     */\r\n    var ONE = fromInt(1);\r\n\r\n    /**\r\n     * Signed one.\r\n     * @type {!Long}\r\n     */\r\n    Long.ONE = ONE;\r\n\r\n    /**\r\n     * @type {!Long}\r\n     * @inner\r\n     */\r\n    var UONE = fromInt(1, true);\r\n\r\n    /**\r\n     * Unsigned one.\r\n     * @type {!Long}\r\n     */\r\n    Long.UONE = UONE;\r\n\r\n    /**\r\n     * @type {!Long}\r\n     * @inner\r\n     */\r\n    var NEG_ONE = fromInt(-1);\r\n\r\n    /**\r\n     * Signed negative one.\r\n     * @type {!Long}\r\n     */\r\n    Long.NEG_ONE = NEG_ONE;\r\n\r\n    /**\r\n     * @type {!Long}\r\n     * @inner\r\n     */\r\n    var MAX_VALUE = fromBits(0xFFFFFFFF|0, 0x7FFFFFFF|0, false);\r\n\r\n    /**\r\n     * Maximum signed value.\r\n     * @type {!Long}\r\n     */\r\n    Long.MAX_VALUE = MAX_VALUE;\r\n\r\n    /**\r\n     * @type {!Long}\r\n     * @inner\r\n     */\r\n    var MAX_UNSIGNED_VALUE = fromBits(0xFFFFFFFF|0, 0xFFFFFFFF|0, true);\r\n\r\n    /**\r\n     * Maximum unsigned value.\r\n     * @type {!Long}\r\n     */\r\n    Long.MAX_UNSIGNED_VALUE = MAX_UNSIGNED_VALUE;\r\n\r\n    /**\r\n     * @type {!Long}\r\n     * @inner\r\n     */\r\n    var MIN_VALUE = fromBits(0, 0x80000000|0, false);\r\n\r\n    /**\r\n     * Minimum signed value.\r\n     * @type {!Long}\r\n     */\r\n    Long.MIN_VALUE = MIN_VALUE;\r\n\r\n    /**\r\n     * @alias Long.prototype\r\n     * @inner\r\n     */\r\n    var LongPrototype = Long.prototype;\r\n\r\n    /**\r\n     * Converts the Long to a 32 bit integer, assuming it is a 32 bit integer.\r\n     * @returns {number}\r\n     */\r\n    LongPrototype.toInt = function toInt() {\r\n        return this.unsigned ? this.low >>> 0 : this.low;\r\n    };\r\n\r\n    /**\r\n     * Converts the Long to a the nearest floating-point representation of this value (double, 53 bit mantissa).\r\n     * @returns {number}\r\n     */\r\n    LongPrototype.toNumber = function toNumber() {\r\n        if (this.unsigned)\r\n            return ((this.high >>> 0) * TWO_PWR_32_DBL) + (this.low >>> 0);\r\n        return this.high * TWO_PWR_32_DBL + (this.low >>> 0);\r\n    };\r\n\r\n    /**\r\n     * Converts the Long to a string written in the specified radix.\r\n     * @param {number=} radix Radix (2-36), defaults to 10\r\n     * @returns {string}\r\n     * @override\r\n     * @throws {RangeError} If `radix` is out of range\r\n     */\r\n    LongPrototype.toString = function toString(radix) {\r\n        radix = radix || 10;\r\n        if (radix < 2 || 36 < radix)\r\n            throw RangeError('radix');\r\n        if (this.isZero())\r\n            return '0';\r\n        if (this.isNegative()) { // Unsigned Longs are never negative\r\n            if (this.eq(MIN_VALUE)) {\r\n                // We need to change the Long value before it can be negated, so we remove\r\n                // the bottom-most digit in this base and then recurse to do the rest.\r\n                var radixLong = fromNumber(radix),\r\n                    div = this.div(radixLong),\r\n                    rem1 = div.mul(radixLong).sub(this);\r\n                return div.toString(radix) + rem1.toInt().toString(radix);\r\n            } else\r\n                return '-' + this.neg().toString(radix);\r\n        }\r\n\r\n        // Do several (6) digits each time through the loop, so as to\r\n        // minimize the calls to the very expensive emulated div.\r\n        var radixToPower = fromNumber(pow_dbl(radix, 6), this.unsigned),\r\n            rem = this;\r\n        var result = '';\r\n        while (true) {\r\n            var remDiv = rem.div(radixToPower),\r\n                intval = rem.sub(remDiv.mul(radixToPower)).toInt() >>> 0,\r\n                digits = intval.toString(radix);\r\n            rem = remDiv;\r\n            if (rem.isZero())\r\n                return digits + result;\r\n            else {\r\n                while (digits.length < 6)\r\n                    digits = '0' + digits;\r\n                result = '' + digits + result;\r\n            }\r\n        }\r\n    };\r\n\r\n    /**\r\n     * Gets the high 32 bits as a signed integer.\r\n     * @returns {number} Signed high bits\r\n     */\r\n    LongPrototype.getHighBits = function getHighBits() {\r\n        return this.high;\r\n    };\r\n\r\n    /**\r\n     * Gets the high 32 bits as an unsigned integer.\r\n     * @returns {number} Unsigned high bits\r\n     */\r\n    LongPrototype.getHighBitsUnsigned = function getHighBitsUnsigned() {\r\n        return this.high >>> 0;\r\n    };\r\n\r\n    /**\r\n     * Gets the low 32 bits as a signed integer.\r\n     * @returns {number} Signed low bits\r\n     */\r\n    LongPrototype.getLowBits = function getLowBits() {\r\n        return this.low;\r\n    };\r\n\r\n    /**\r\n     * Gets the low 32 bits as an unsigned integer.\r\n     * @returns {number} Unsigned low bits\r\n     */\r\n    LongPrototype.getLowBitsUnsigned = function getLowBitsUnsigned() {\r\n        return this.low >>> 0;\r\n    };\r\n\r\n    /**\r\n     * Gets the number of bits needed to represent the absolute value of this Long.\r\n     * @returns {number}\r\n     */\r\n    LongPrototype.getNumBitsAbs = function getNumBitsAbs() {\r\n        if (this.isNegative()) // Unsigned Longs are never negative\r\n            return this.eq(MIN_VALUE) ? 64 : this.neg().getNumBitsAbs();\r\n        var val = this.high != 0 ? this.high : this.low;\r\n        for (var bit = 31; bit > 0; bit--)\r\n            if ((val & (1 << bit)) != 0)\r\n                break;\r\n        return this.high != 0 ? bit + 33 : bit + 1;\r\n    };\r\n\r\n    /**\r\n     * Tests if this Long's value equals zero.\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.isZero = function isZero() {\r\n        return this.high === 0 && this.low === 0;\r\n    };\r\n\r\n    /**\r\n     * Tests if this Long's value is negative.\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.isNegative = function isNegative() {\r\n        return !this.unsigned && this.high < 0;\r\n    };\r\n\r\n    /**\r\n     * Tests if this Long's value is positive.\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.isPositive = function isPositive() {\r\n        return this.unsigned || this.high >= 0;\r\n    };\r\n\r\n    /**\r\n     * Tests if this Long's value is odd.\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.isOdd = function isOdd() {\r\n        return (this.low & 1) === 1;\r\n    };\r\n\r\n    /**\r\n     * Tests if this Long's value is even.\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.isEven = function isEven() {\r\n        return (this.low & 1) === 0;\r\n    };\r\n\r\n    /**\r\n     * Tests if this Long's value equals the specified's.\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.equals = function equals(other) {\r\n        if (!isLong(other))\r\n            other = fromValue(other);\r\n        if (this.unsigned !== other.unsigned && (this.high >>> 31) === 1 && (other.high >>> 31) === 1)\r\n            return false;\r\n        return this.high === other.high && this.low === other.low;\r\n    };\r\n\r\n    /**\r\n     * Tests if this Long's value equals the specified's. This is an alias of {@link Long#equals}.\r\n     * @function\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.eq = LongPrototype.equals;\r\n\r\n    /**\r\n     * Tests if this Long's value differs from the specified's.\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.notEquals = function notEquals(other) {\r\n        return !this.eq(/* validates */ other);\r\n    };\r\n\r\n    /**\r\n     * Tests if this Long's value differs from the specified's. This is an alias of {@link Long#notEquals}.\r\n     * @function\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.neq = LongPrototype.notEquals;\r\n\r\n    /**\r\n     * Tests if this Long's value is less than the specified's.\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.lessThan = function lessThan(other) {\r\n        return this.comp(/* validates */ other) < 0;\r\n    };\r\n\r\n    /**\r\n     * Tests if this Long's value is less than the specified's. This is an alias of {@link Long#lessThan}.\r\n     * @function\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.lt = LongPrototype.lessThan;\r\n\r\n    /**\r\n     * Tests if this Long's value is less than or equal the specified's.\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.lessThanOrEqual = function lessThanOrEqual(other) {\r\n        return this.comp(/* validates */ other) <= 0;\r\n    };\r\n\r\n    /**\r\n     * Tests if this Long's value is less than or equal the specified's. This is an alias of {@link Long#lessThanOrEqual}.\r\n     * @function\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.lte = LongPrototype.lessThanOrEqual;\r\n\r\n    /**\r\n     * Tests if this Long's value is greater than the specified's.\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.greaterThan = function greaterThan(other) {\r\n        return this.comp(/* validates */ other) > 0;\r\n    };\r\n\r\n    /**\r\n     * Tests if this Long's value is greater than the specified's. This is an alias of {@link Long#greaterThan}.\r\n     * @function\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.gt = LongPrototype.greaterThan;\r\n\r\n    /**\r\n     * Tests if this Long's value is greater than or equal the specified's.\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.greaterThanOrEqual = function greaterThanOrEqual(other) {\r\n        return this.comp(/* validates */ other) >= 0;\r\n    };\r\n\r\n    /**\r\n     * Tests if this Long's value is greater than or equal the specified's. This is an alias of {@link Long#greaterThanOrEqual}.\r\n     * @function\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {boolean}\r\n     */\r\n    LongPrototype.gte = LongPrototype.greaterThanOrEqual;\r\n\r\n    /**\r\n     * Compares this Long's value with the specified's.\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {number} 0 if they are the same, 1 if the this is greater and -1\r\n     *  if the given one is greater\r\n     */\r\n    LongPrototype.compare = function compare(other) {\r\n        if (!isLong(other))\r\n            other = fromValue(other);\r\n        if (this.eq(other))\r\n            return 0;\r\n        var thisNeg = this.isNegative(),\r\n            otherNeg = other.isNegative();\r\n        if (thisNeg && !otherNeg)\r\n            return -1;\r\n        if (!thisNeg && otherNeg)\r\n            return 1;\r\n        // At this point the sign bits are the same\r\n        if (!this.unsigned)\r\n            return this.sub(other).isNegative() ? -1 : 1;\r\n        // Both are positive if at least one is unsigned\r\n        return (other.high >>> 0) > (this.high >>> 0) || (other.high === this.high && (other.low >>> 0) > (this.low >>> 0)) ? -1 : 1;\r\n    };\r\n\r\n    /**\r\n     * Compares this Long's value with the specified's. This is an alias of {@link Long#compare}.\r\n     * @function\r\n     * @param {!Long|number|string} other Other value\r\n     * @returns {number} 0 if they are the same, 1 if the this is greater and -1\r\n     *  if the given one is greater\r\n     */\r\n    LongPrototype.comp = LongPrototype.compare;\r\n\r\n    /**\r\n     * Negates this Long's value.\r\n     * @returns {!Long} Negated Long\r\n     */\r\n    LongPrototype.negate = function negate() {\r\n        if (!this.unsigned && this.eq(MIN_VALUE))\r\n            return MIN_VALUE;\r\n        return this.not().add(ONE);\r\n    };\r\n\r\n    /**\r\n     * Negates this Long's value. This is an alias of {@link Long#negate}.\r\n     * @function\r\n     * @returns {!Long} Negated Long\r\n     */\r\n    LongPrototype.neg = LongPrototype.negate;\r\n\r\n    /**\r\n     * Returns the sum of this and the specified Long.\r\n     * @param {!Long|number|string} addend Addend\r\n     * @returns {!Long} Sum\r\n     */\r\n    LongPrototype.add = function add(addend) {\r\n        if (!isLong(addend))\r\n            addend = fromValue(addend);\r\n\r\n        // Divide each number into 4 chunks of 16 bits, and then sum the chunks.\r\n\r\n        var a48 = this.high >>> 16;\r\n        var a32 = this.high & 0xFFFF;\r\n        var a16 = this.low >>> 16;\r\n        var a00 = this.low & 0xFFFF;\r\n\r\n        var b48 = addend.high >>> 16;\r\n        var b32 = addend.high & 0xFFFF;\r\n        var b16 = addend.low >>> 16;\r\n        var b00 = addend.low & 0xFFFF;\r\n\r\n        var c48 = 0, c32 = 0, c16 = 0, c00 = 0;\r\n        c00 += a00 + b00;\r\n        c16 += c00 >>> 16;\r\n        c00 &= 0xFFFF;\r\n        c16 += a16 + b16;\r\n        c32 += c16 >>> 16;\r\n        c16 &= 0xFFFF;\r\n        c32 += a32 + b32;\r\n        c48 += c32 >>> 16;\r\n        c32 &= 0xFFFF;\r\n        c48 += a48 + b48;\r\n        c48 &= 0xFFFF;\r\n        return fromBits((c16 << 16) | c00, (c48 << 16) | c32, this.unsigned);\r\n    };\r\n\r\n    /**\r\n     * Returns the difference of this and the specified Long.\r\n     * @param {!Long|number|string} subtrahend Subtrahend\r\n     * @returns {!Long} Difference\r\n     */\r\n    LongPrototype.subtract = function subtract(subtrahend) {\r\n        if (!isLong(subtrahend))\r\n            subtrahend = fromValue(subtrahend);\r\n        return this.add(subtrahend.neg());\r\n    };\r\n\r\n    /**\r\n     * Returns the difference of this and the specified Long. This is an alias of {@link Long#subtract}.\r\n     * @function\r\n     * @param {!Long|number|string} subtrahend Subtrahend\r\n     * @returns {!Long} Difference\r\n     */\r\n    LongPrototype.sub = LongPrototype.subtract;\r\n\r\n    /**\r\n     * Returns the product of this and the specified Long.\r\n     * @param {!Long|number|string} multiplier Multiplier\r\n     * @returns {!Long} Product\r\n     */\r\n    LongPrototype.multiply = function multiply(multiplier) {\r\n        if (this.isZero())\r\n            return ZERO;\r\n        if (!isLong(multiplier))\r\n            multiplier = fromValue(multiplier);\r\n        if (multiplier.isZero())\r\n            return ZERO;\r\n        if (this.eq(MIN_VALUE))\r\n            return multiplier.isOdd() ? MIN_VALUE : ZERO;\r\n        if (multiplier.eq(MIN_VALUE))\r\n            return this.isOdd() ? MIN_VALUE : ZERO;\r\n\r\n        if (this.isNegative()) {\r\n            if (multiplier.isNegative())\r\n                return this.neg().mul(multiplier.neg());\r\n            else\r\n                return this.neg().mul(multiplier).neg();\r\n        } else if (multiplier.isNegative())\r\n            return this.mul(multiplier.neg()).neg();\r\n\r\n        // If both longs are small, use float multiplication\r\n        if (this.lt(TWO_PWR_24) && multiplier.lt(TWO_PWR_24))\r\n            return fromNumber(this.toNumber() * multiplier.toNumber(), this.unsigned);\r\n\r\n        // Divide each long into 4 chunks of 16 bits, and then add up 4x4 products.\r\n        // We can skip products that would overflow.\r\n\r\n        var a48 = this.high >>> 16;\r\n        var a32 = this.high & 0xFFFF;\r\n        var a16 = this.low >>> 16;\r\n        var a00 = this.low & 0xFFFF;\r\n\r\n        var b48 = multiplier.high >>> 16;\r\n        var b32 = multiplier.high & 0xFFFF;\r\n        var b16 = multiplier.low >>> 16;\r\n        var b00 = multiplier.low & 0xFFFF;\r\n\r\n        var c48 = 0, c32 = 0, c16 = 0, c00 = 0;\r\n        c00 += a00 * b00;\r\n        c16 += c00 >>> 16;\r\n        c00 &= 0xFFFF;\r\n        c16 += a16 * b00;\r\n        c32 += c16 >>> 16;\r\n        c16 &= 0xFFFF;\r\n        c16 += a00 * b16;\r\n        c32 += c16 >>> 16;\r\n        c16 &= 0xFFFF;\r\n        c32 += a32 * b00;\r\n        c48 += c32 >>> 16;\r\n        c32 &= 0xFFFF;\r\n        c32 += a16 * b16;\r\n        c48 += c32 >>> 16;\r\n        c32 &= 0xFFFF;\r\n        c32 += a00 * b32;\r\n        c48 += c32 >>> 16;\r\n        c32 &= 0xFFFF;\r\n        c48 += a48 * b00 + a32 * b16 + a16 * b32 + a00 * b48;\r\n        c48 &= 0xFFFF;\r\n        return fromBits((c16 << 16) | c00, (c48 << 16) | c32, this.unsigned);\r\n    };\r\n\r\n    /**\r\n     * Returns the product of this and the specified Long. This is an alias of {@link Long#multiply}.\r\n     * @function\r\n     * @param {!Long|number|string} multiplier Multiplier\r\n     * @returns {!Long} Product\r\n     */\r\n    LongPrototype.mul = LongPrototype.multiply;\r\n\r\n    /**\r\n     * Returns this Long divided by the specified. The result is signed if this Long is signed or\r\n     *  unsigned if this Long is unsigned.\r\n     * @param {!Long|number|string} divisor Divisor\r\n     * @returns {!Long} Quotient\r\n     */\r\n    LongPrototype.divide = function divide(divisor) {\r\n        if (!isLong(divisor))\r\n            divisor = fromValue(divisor);\r\n        if (divisor.isZero())\r\n            throw Error('division by zero');\r\n        if (this.isZero())\r\n            return this.unsigned ? UZERO : ZERO;\r\n        var approx, rem, res;\r\n        if (!this.unsigned) {\r\n            // This section is only relevant for signed longs and is derived from the\r\n            // closure library as a whole.\r\n            if (this.eq(MIN_VALUE)) {\r\n                if (divisor.eq(ONE) || divisor.eq(NEG_ONE))\r\n                    return MIN_VALUE;  // recall that -MIN_VALUE == MIN_VALUE\r\n                else if (divisor.eq(MIN_VALUE))\r\n                    return ONE;\r\n                else {\r\n                    // At this point, we have |other| >= 2, so |this/other| < |MIN_VALUE|.\r\n                    var halfThis = this.shr(1);\r\n                    approx = halfThis.div(divisor).shl(1);\r\n                    if (approx.eq(ZERO)) {\r\n                        return divisor.isNegative() ? ONE : NEG_ONE;\r\n                    } else {\r\n                        rem = this.sub(divisor.mul(approx));\r\n                        res = approx.add(rem.div(divisor));\r\n                        return res;\r\n                    }\r\n                }\r\n            } else if (divisor.eq(MIN_VALUE))\r\n                return this.unsigned ? UZERO : ZERO;\r\n            if (this.isNegative()) {\r\n                if (divisor.isNegative())\r\n                    return this.neg().div(divisor.neg());\r\n                return this.neg().div(divisor).neg();\r\n            } else if (divisor.isNegative())\r\n                return this.div(divisor.neg()).neg();\r\n            res = ZERO;\r\n        } else {\r\n            // The algorithm below has not been made for unsigned longs. It's therefore\r\n            // required to take special care of the MSB prior to running it.\r\n            if (!divisor.unsigned)\r\n                divisor = divisor.toUnsigned();\r\n            if (divisor.gt(this))\r\n                return UZERO;\r\n            if (divisor.gt(this.shru(1))) // 15 >>> 1 = 7 ; with divisor = 8 ; true\r\n                return UONE;\r\n            res = UZERO;\r\n        }\r\n\r\n        // Repeat the following until the remainder is less than other:  find a\r\n        // floating-point that approximates remainder / other *from below*, add this\r\n        // into the result, and subtract it from the remainder.  It is critical that\r\n        // the approximate value is less than or equal to the real value so that the\r\n        // remainder never becomes negative.\r\n        rem = this;\r\n        while (rem.gte(divisor)) {\r\n            // Approximate the result of division. This may be a little greater or\r\n            // smaller than the actual value.\r\n            approx = Math.max(1, Math.floor(rem.toNumber() / divisor.toNumber()));\r\n\r\n            // We will tweak the approximate result by changing it in the 48-th digit or\r\n            // the smallest non-fractional digit, whichever is larger.\r\n            var log2 = Math.ceil(Math.log(approx) / Math.LN2),\r\n                delta = (log2 <= 48) ? 1 : pow_dbl(2, log2 - 48),\r\n\r\n            // Decrease the approximation until it is smaller than the remainder.  Note\r\n            // that if it is too large, the product overflows and is negative.\r\n                approxRes = fromNumber(approx),\r\n                approxRem = approxRes.mul(divisor);\r\n            while (approxRem.isNegative() || approxRem.gt(rem)) {\r\n                approx -= delta;\r\n                approxRes = fromNumber(approx, this.unsigned);\r\n                approxRem = approxRes.mul(divisor);\r\n            }\r\n\r\n            // We know the answer can't be zero... and actually, zero would cause\r\n            // infinite recursion since we would make no progress.\r\n            if (approxRes.isZero())\r\n                approxRes = ONE;\r\n\r\n            res = res.add(approxRes);\r\n            rem = rem.sub(approxRem);\r\n        }\r\n        return res;\r\n    };\r\n\r\n    /**\r\n     * Returns this Long divided by the specified. This is an alias of {@link Long#divide}.\r\n     * @function\r\n     * @param {!Long|number|string} divisor Divisor\r\n     * @returns {!Long} Quotient\r\n     */\r\n    LongPrototype.div = LongPrototype.divide;\r\n\r\n    /**\r\n     * Returns this Long modulo the specified.\r\n     * @param {!Long|number|string} divisor Divisor\r\n     * @returns {!Long} Remainder\r\n     */\r\n    LongPrototype.modulo = function modulo(divisor) {\r\n        if (!isLong(divisor))\r\n            divisor = fromValue(divisor);\r\n        return this.sub(this.div(divisor).mul(divisor));\r\n    };\r\n\r\n    /**\r\n     * Returns this Long modulo the specified. This is an alias of {@link Long#modulo}.\r\n     * @function\r\n     * @param {!Long|number|string} divisor Divisor\r\n     * @returns {!Long} Remainder\r\n     */\r\n    LongPrototype.mod = LongPrototype.modulo;\r\n\r\n    /**\r\n     * Returns the bitwise NOT of this Long.\r\n     * @returns {!Long}\r\n     */\r\n    LongPrototype.not = function not() {\r\n        return fromBits(~this.low, ~this.high, this.unsigned);\r\n    };\r\n\r\n    /**\r\n     * Returns the bitwise AND of this Long and the specified.\r\n     * @param {!Long|number|string} other Other Long\r\n     * @returns {!Long}\r\n     */\r\n    LongPrototype.and = function and(other) {\r\n        if (!isLong(other))\r\n            other = fromValue(other);\r\n        return fromBits(this.low & other.low, this.high & other.high, this.unsigned);\r\n    };\r\n\r\n    /**\r\n     * Returns the bitwise OR of this Long and the specified.\r\n     * @param {!Long|number|string} other Other Long\r\n     * @returns {!Long}\r\n     */\r\n    LongPrototype.or = function or(other) {\r\n        if (!isLong(other))\r\n            other = fromValue(other);\r\n        return fromBits(this.low | other.low, this.high | other.high, this.unsigned);\r\n    };\r\n\r\n    /**\r\n     * Returns the bitwise XOR of this Long and the given one.\r\n     * @param {!Long|number|string} other Other Long\r\n     * @returns {!Long}\r\n     */\r\n    LongPrototype.xor = function xor(other) {\r\n        if (!isLong(other))\r\n            other = fromValue(other);\r\n        return fromBits(this.low ^ other.low, this.high ^ other.high, this.unsigned);\r\n    };\r\n\r\n    /**\r\n     * Returns this Long with bits shifted to the left by the given amount.\r\n     * @param {number|!Long} numBits Number of bits\r\n     * @returns {!Long} Shifted Long\r\n     */\r\n    LongPrototype.shiftLeft = function shiftLeft(numBits) {\r\n        if (isLong(numBits))\r\n            numBits = numBits.toInt();\r\n        if ((numBits &= 63) === 0)\r\n            return this;\r\n        else if (numBits < 32)\r\n            return fromBits(this.low << numBits, (this.high << numBits) | (this.low >>> (32 - numBits)), this.unsigned);\r\n        else\r\n            return fromBits(0, this.low << (numBits - 32), this.unsigned);\r\n    };\r\n\r\n    /**\r\n     * Returns this Long with bits shifted to the left by the given amount. This is an alias of {@link Long#shiftLeft}.\r\n     * @function\r\n     * @param {number|!Long} numBits Number of bits\r\n     * @returns {!Long} Shifted Long\r\n     */\r\n    LongPrototype.shl = LongPrototype.shiftLeft;\r\n\r\n    /**\r\n     * Returns this Long with bits arithmetically shifted to the right by the given amount.\r\n     * @param {number|!Long} numBits Number of bits\r\n     * @returns {!Long} Shifted Long\r\n     */\r\n    LongPrototype.shiftRight = function shiftRight(numBits) {\r\n        if (isLong(numBits))\r\n            numBits = numBits.toInt();\r\n        if ((numBits &= 63) === 0)\r\n            return this;\r\n        else if (numBits < 32)\r\n            return fromBits((this.low >>> numBits) | (this.high << (32 - numBits)), this.high >> numBits, this.unsigned);\r\n        else\r\n            return fromBits(this.high >> (numBits - 32), this.high >= 0 ? 0 : -1, this.unsigned);\r\n    };\r\n\r\n    /**\r\n     * Returns this Long with bits arithmetically shifted to the right by the given amount. This is an alias of {@link Long#shiftRight}.\r\n     * @function\r\n     * @param {number|!Long} numBits Number of bits\r\n     * @returns {!Long} Shifted Long\r\n     */\r\n    LongPrototype.shr = LongPrototype.shiftRight;\r\n\r\n    /**\r\n     * Returns this Long with bits logically shifted to the right by the given amount.\r\n     * @param {number|!Long} numBits Number of bits\r\n     * @returns {!Long} Shifted Long\r\n     */\r\n    LongPrototype.shiftRightUnsigned = function shiftRightUnsigned(numBits) {\r\n        if (isLong(numBits))\r\n            numBits = numBits.toInt();\r\n        numBits &= 63;\r\n        if (numBits === 0)\r\n            return this;\r\n        else {\r\n            var high = this.high;\r\n            if (numBits < 32) {\r\n                var low = this.low;\r\n                return fromBits((low >>> numBits) | (high << (32 - numBits)), high >>> numBits, this.unsigned);\r\n            } else if (numBits === 32)\r\n                return fromBits(high, 0, this.unsigned);\r\n            else\r\n                return fromBits(high >>> (numBits - 32), 0, this.unsigned);\r\n        }\r\n    };\r\n\r\n    /**\r\n     * Returns this Long with bits logically shifted to the right by the given amount. This is an alias of {@link Long#shiftRightUnsigned}.\r\n     * @function\r\n     * @param {number|!Long} numBits Number of bits\r\n     * @returns {!Long} Shifted Long\r\n     */\r\n    LongPrototype.shru = LongPrototype.shiftRightUnsigned;\r\n\r\n    /**\r\n     * Converts this Long to signed.\r\n     * @returns {!Long} Signed long\r\n     */\r\n    LongPrototype.toSigned = function toSigned() {\r\n        if (!this.unsigned)\r\n            return this;\r\n        return fromBits(this.low, this.high, false);\r\n    };\r\n\r\n    /**\r\n     * Converts this Long to unsigned.\r\n     * @returns {!Long} Unsigned long\r\n     */\r\n    LongPrototype.toUnsigned = function toUnsigned() {\r\n        if (this.unsigned)\r\n            return this;\r\n        return fromBits(this.low, this.high, true);\r\n    };\r\n\r\n    /**\r\n     * Converts this Long to its byte representation.\r\n     * @param {boolean=} le Whether little or big endian, defaults to big endian\r\n     * @returns {!Array.<number>} Byte representation\r\n     */\r\n    LongPrototype.toBytes = function(le) {\r\n        return le ? this.toBytesLE() : this.toBytesBE();\r\n    }\r\n\r\n    /**\r\n     * Converts this Long to its little endian byte representation.\r\n     * @returns {!Array.<number>} Little endian byte representation\r\n     */\r\n    LongPrototype.toBytesLE = function() {\r\n        var hi = this.high,\r\n            lo = this.low;\r\n        return [\r\n             lo         & 0xff,\r\n            (lo >>>  8) & 0xff,\r\n            (lo >>> 16) & 0xff,\r\n            (lo >>> 24) & 0xff,\r\n             hi         & 0xff,\r\n            (hi >>>  8) & 0xff,\r\n            (hi >>> 16) & 0xff,\r\n            (hi >>> 24) & 0xff\r\n        ];\r\n    }\r\n\r\n    /**\r\n     * Converts this Long to its big endian byte representation.\r\n     * @returns {!Array.<number>} Big endian byte representation\r\n     */\r\n    LongPrototype.toBytesBE = function() {\r\n        var hi = this.high,\r\n            lo = this.low;\r\n        return [\r\n            (hi >>> 24) & 0xff,\r\n            (hi >>> 16) & 0xff,\r\n            (hi >>>  8) & 0xff,\r\n             hi         & 0xff,\r\n            (lo >>> 24) & 0xff,\r\n            (lo >>> 16) & 0xff,\r\n            (lo >>>  8) & 0xff,\r\n             lo         & 0xff\r\n        ];\r\n    }\r\n\r\n    return Long;\r\n});\r\n","import {COORDINATE_SYSTEM, createIterable} from '@deck.gl/core';\n\n/* eslint-disable max-statements, complexity, camelcase */\nconst RADIAN_PER_DEGREE = Math.PI / 180;\nconst modelMatrix = new Float32Array(16);\nconst valueArray = new Float32Array(12);\n\nfunction calculateTransformMatrix(targetMatrix, orientation, scale) {\n  const pitch = orientation[0] * RADIAN_PER_DEGREE;\n  const yaw = orientation[1] * RADIAN_PER_DEGREE;\n  const roll = orientation[2] * RADIAN_PER_DEGREE;\n\n  const sr = Math.sin(roll);\n  const sp = Math.sin(pitch);\n  const sw = Math.sin(yaw);\n\n  const cr = Math.cos(roll);\n  const cp = Math.cos(pitch);\n  const cw = Math.cos(yaw);\n\n  const scx = scale[0];\n  const scy = scale[1];\n  const scz = scale[2];\n\n  targetMatrix[0] = scx * cw * cp; // 0,0\n  targetMatrix[1] = scx * sw * cp; // 1,0\n  targetMatrix[2] = scx * -sp; // 2,0\n  targetMatrix[3] = scy * (-sw * cr + cw * sp * sr); // 0,1\n  targetMatrix[4] = scy * (cw * cr + sw * sp * sr); // 1,1\n  targetMatrix[5] = scy * cp * sr; // 2,1\n  targetMatrix[6] = scz * (sw * sr + cw * sp * cr); // 0,2\n  targetMatrix[7] = scz * (-cw * sr + sw * sp * cr); // 1,2\n  targetMatrix[8] = scz * cp * cr; // 2,2\n}\n\nfunction getExtendedMat3FromMat4(mat4) {\n  mat4[0] = mat4[0];\n  mat4[1] = mat4[1];\n  mat4[2] = mat4[2];\n  mat4[3] = mat4[4];\n  mat4[4] = mat4[5];\n  mat4[5] = mat4[6];\n  mat4[6] = mat4[8];\n  mat4[7] = mat4[9];\n  mat4[8] = mat4[10];\n  mat4[9] = mat4[12];\n  mat4[10] = mat4[13];\n  mat4[11] = mat4[14];\n\n  return mat4.subarray(0, 12);\n}\n\nexport const MATRIX_ATTRIBUTES = {\n  size: 12,\n  accessor: ['getOrientation', 'getScale', 'getTranslation', 'getTransformMatrix'],\n  shaderAttributes: {\n    instanceModelMatrix__LOCATION_0: {\n      size: 3,\n      elementOffset: 0\n    },\n    instanceModelMatrix__LOCATION_1: {\n      size: 3,\n      elementOffset: 3\n    },\n    instanceModelMatrix__LOCATION_2: {\n      size: 3,\n      elementOffset: 6\n    },\n    instanceTranslation: {\n      size: 3,\n      elementOffset: 9\n    }\n  } as const,\n\n  update(attribute, {startRow, endRow}) {\n    // @ts-expect-error: \"this\" will be bound to a layer when this function is called\n    const {data, getOrientation, getScale, getTranslation, getTransformMatrix} = this.props;\n\n    const arrayMatrix = Array.isArray(getTransformMatrix);\n    const constantMatrix = arrayMatrix && getTransformMatrix.length === 16;\n    const constantScale = Array.isArray(getScale);\n    const constantOrientation = Array.isArray(getOrientation);\n    const constantTranslation = Array.isArray(getTranslation);\n\n    const hasMatrix = constantMatrix || (!arrayMatrix && Boolean(getTransformMatrix(data[0])));\n\n    if (hasMatrix) {\n      attribute.constant = constantMatrix;\n    } else {\n      attribute.constant = constantOrientation && constantScale && constantTranslation;\n    }\n\n    const instanceModelMatrixData = attribute.value;\n\n    if (attribute.constant) {\n      let matrix;\n\n      if (hasMatrix) {\n        modelMatrix.set(getTransformMatrix);\n        matrix = getExtendedMat3FromMat4(modelMatrix);\n      } else {\n        matrix = valueArray;\n\n        const orientation = getOrientation;\n        const scale = getScale;\n\n        calculateTransformMatrix(matrix, orientation, scale);\n        matrix.set(getTranslation, 9);\n      }\n\n      attribute.value = new Float32Array(matrix);\n    } else {\n      let i = startRow * attribute.size;\n      const {iterable, objectInfo} = createIterable(data, startRow, endRow);\n      for (const object of iterable) {\n        objectInfo.index++;\n        let matrix;\n\n        if (hasMatrix) {\n          modelMatrix.set(\n            constantMatrix ? getTransformMatrix : getTransformMatrix(object, objectInfo)\n          );\n          matrix = getExtendedMat3FromMat4(modelMatrix);\n        } else {\n          matrix = valueArray;\n\n          const orientation = constantOrientation\n            ? getOrientation\n            : getOrientation(object, objectInfo);\n          const scale = constantScale ? getScale : getScale(object, objectInfo);\n\n          calculateTransformMatrix(matrix, orientation, scale);\n          matrix.set(constantTranslation ? getTranslation : getTranslation(object, objectInfo), 9);\n        }\n\n        instanceModelMatrixData[i++] = matrix[0];\n        instanceModelMatrixData[i++] = matrix[1];\n        instanceModelMatrixData[i++] = matrix[2];\n        instanceModelMatrixData[i++] = matrix[3];\n        instanceModelMatrixData[i++] = matrix[4];\n        instanceModelMatrixData[i++] = matrix[5];\n        instanceModelMatrixData[i++] = matrix[6];\n        instanceModelMatrixData[i++] = matrix[7];\n        instanceModelMatrixData[i++] = matrix[8];\n        instanceModelMatrixData[i++] = matrix[9];\n        instanceModelMatrixData[i++] = matrix[10];\n        instanceModelMatrixData[i++] = matrix[11];\n      }\n    }\n  }\n};\n\n// only apply composeModelMatrix when in cartesian or meter_offsets coordinate system\n// with `composeModelMatrix` enabled, the rotation part of the layer's modelMatrix will be composed to instance's transformations\n// since rotating latitude and longitude can not provide meaningful results, hence `composeModelMatrix` is disabled\n// when in LNGLAT and LNGLAT_OFFSET coordinates.\nexport function shouldComposeModelMatrix(viewport, coordinateSystem) {\n  return (\n    coordinateSystem === COORDINATE_SYSTEM.CARTESIAN ||\n    coordinateSystem === COORDINATE_SYSTEM.METER_OFFSETS ||\n    (coordinateSystem === COORDINATE_SYSTEM.DEFAULT && !viewport.isGeospatial)\n  );\n}\n","/* global process, document */\nimport {loadCSS} from './css-utils';\n\n// SSR safe import (ensures this file can be imported under Node.js e.g. for tests)\n// From https://github.com/mapbox/mapbox-gl-js/issues/4593#issuecomment-546290823\n// eslint-disable-next-line no-undef\nlet mapboxgl;\n\nif (process.browser) {\n  mapboxgl = require('mapbox-gl');\n}\n\nconst MAPBOX_CSS_URL = 'https://api.tiles.mapbox.com/mapbox-gl-js/v1.2.1/mapbox-gl.css';\n\nexport default mapboxgl;\n\nexport function loadMapboxCSS(url = MAPBOX_CSS_URL) {\n  loadCSS(url);\n}\n\n/**\n * Hides elements in the mapbox-gl.js library and adds pydeck tag\n */\nexport function modifyMapboxElements() {\n  const classes = ['mapboxgl-missing-css'];\n  for (const c of classes) {\n    const el = document.getElementsByClassName(c)[0];\n    if (el && el.style) {\n      el.style.display = 'none';\n    }\n  }\n}\n","import { log } from '@luma.gl/gltools';\nimport { Stats } from '@probe.gl/stats';\nimport { isBrowser } from '@probe.gl/env';\nconst VERSION = typeof \"8.5.16\" !== 'undefined' ? \"8.5.16\" : 'untranspiled source';\nconst STARTUP_MESSAGE = 'set luma.log.level=1 (or higher) to trace rendering';\nexport class StatsManager {\n  constructor() {\n    this.stats = new Map();\n  }\n\n  get(name) {\n    if (!this.stats.has(name)) {\n      this.stats.set(name, new Stats({\n        id: name\n      }));\n    }\n\n    return this.stats.get(name);\n  }\n\n}\nconst lumaStats = new StatsManager();\n\nif (globalThis.luma && globalThis.luma.VERSION !== VERSION) {\n  throw new Error(\"luma.gl - multiple VERSIONs detected: \".concat(globalThis.luma.VERSION, \" vs \").concat(VERSION));\n}\n\nif (!globalThis.luma) {\n  if (isBrowser()) {\n    log.log(1, \"luma.gl \".concat(VERSION, \" - \").concat(STARTUP_MESSAGE))();\n  }\n\n  globalThis.luma = globalThis.luma || {\n    VERSION,\n    version: VERSION,\n    log,\n    stats: lumaStats,\n    globals: {\n      modules: {},\n      nodeIO: {}\n    }\n  };\n}\n\nexport { lumaStats };\nexport default globalThis.luma;\n//# sourceMappingURL=init.js.map","export class Worker {}\nexport const parentPort = null;\n//# sourceMappingURL=worker_threads-browser.js.map","import { assert } from '../env-utils/assert';\nconst workerURLCache = new Map();\nexport function getLoadableWorkerURL(props) {\n  assert(props.source && !props.url || !props.source && props.url);\n  let workerURL = workerURLCache.get(props.source || props.url);\n\n  if (!workerURL) {\n    if (props.url) {\n      workerURL = getLoadableWorkerURLFromURL(props.url);\n      workerURLCache.set(props.url, workerURL);\n    }\n\n    if (props.source) {\n      workerURL = getLoadableWorkerURLFromSource(props.source);\n      workerURLCache.set(props.source, workerURL);\n    }\n  }\n\n  assert(workerURL);\n  return workerURL;\n}\n\nfunction getLoadableWorkerURLFromURL(url) {\n  if (!url.startsWith('http')) {\n    return url;\n  }\n\n  const workerSource = buildScriptSource(url);\n  return getLoadableWorkerURLFromSource(workerSource);\n}\n\nfunction getLoadableWorkerURLFromSource(workerSource) {\n  const blob = new Blob([workerSource], {\n    type: 'application/javascript'\n  });\n  return URL.createObjectURL(blob);\n}\n\nfunction buildScriptSource(workerUrl) {\n  return \"try {\\n  importScripts('\".concat(workerUrl, \"');\\n} catch (error) {\\n  console.error(error);\\n  throw error;\\n}\");\n}\n//# sourceMappingURL=get-loadable-worker-url.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { Worker as NodeWorker } from '../node/worker_threads';\nimport { isBrowser } from '../env-utils/globals';\nimport { assert } from '../env-utils/assert';\nimport { getLoadableWorkerURL } from '../worker-utils/get-loadable-worker-url';\nimport { getTransferList } from '../worker-utils/get-transfer-list';\n\nconst NOOP = () => {};\n\nexport default class WorkerThread {\n  static isSupported() {\n    return typeof Worker !== 'undefined' && isBrowser || typeof NodeWorker !== 'undefined' && !isBrowser;\n  }\n\n  constructor(props) {\n    _defineProperty(this, \"name\", void 0);\n\n    _defineProperty(this, \"source\", void 0);\n\n    _defineProperty(this, \"url\", void 0);\n\n    _defineProperty(this, \"terminated\", false);\n\n    _defineProperty(this, \"worker\", void 0);\n\n    _defineProperty(this, \"onMessage\", void 0);\n\n    _defineProperty(this, \"onError\", void 0);\n\n    _defineProperty(this, \"_loadableURL\", '');\n\n    const {\n      name,\n      source,\n      url\n    } = props;\n    assert(source || url);\n    this.name = name;\n    this.source = source;\n    this.url = url;\n    this.onMessage = NOOP;\n\n    this.onError = error => console.log(error);\n\n    this.worker = isBrowser ? this._createBrowserWorker() : this._createNodeWorker();\n  }\n\n  destroy() {\n    this.onMessage = NOOP;\n    this.onError = NOOP;\n    this.worker.terminate();\n    this.terminated = true;\n  }\n\n  get isRunning() {\n    return Boolean(this.onMessage);\n  }\n\n  postMessage(data, transferList) {\n    transferList = transferList || getTransferList(data);\n    this.worker.postMessage(data, transferList);\n  }\n\n  _getErrorFromErrorEvent(event) {\n    let message = 'Failed to load ';\n    message += \"worker \".concat(this.name, \" from \").concat(this.url, \". \");\n\n    if (event.message) {\n      message += \"\".concat(event.message, \" in \");\n    }\n\n    if (event.lineno) {\n      message += \":\".concat(event.lineno, \":\").concat(event.colno);\n    }\n\n    return new Error(message);\n  }\n\n  _createBrowserWorker() {\n    this._loadableURL = getLoadableWorkerURL({\n      source: this.source,\n      url: this.url\n    });\n    const worker = new Worker(this._loadableURL, {\n      name: this.name\n    });\n\n    worker.onmessage = event => {\n      if (!event.data) {\n        this.onError(new Error('No data received'));\n      } else {\n        this.onMessage(event.data);\n      }\n    };\n\n    worker.onerror = error => {\n      this.onError(this._getErrorFromErrorEvent(error));\n      this.terminated = true;\n    };\n\n    worker.onmessageerror = event => console.error(event);\n\n    return worker;\n  }\n\n  _createNodeWorker() {\n    let worker;\n\n    if (this.url) {\n      const absolute = this.url.includes(':/') || this.url.startsWith('/');\n      const url = absolute ? this.url : \"./\".concat(this.url);\n      worker = new NodeWorker(url, {\n        eval: false\n      });\n    } else if (this.source) {\n      worker = new NodeWorker(this.source, {\n        eval: true\n      });\n    } else {\n      throw new Error('no worker');\n    }\n\n    worker.on('message', data => {\n      this.onMessage(data);\n    });\n    worker.on('error', error => {\n      this.onError(error);\n    });\n    worker.on('exit', code => {});\n    return worker;\n  }\n\n}\n//# sourceMappingURL=worker-thread.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { assert } from '../env-utils/assert';\nexport default class WorkerJob {\n  constructor(jobName, workerThread) {\n    _defineProperty(this, \"name\", void 0);\n\n    _defineProperty(this, \"workerThread\", void 0);\n\n    _defineProperty(this, \"isRunning\", true);\n\n    _defineProperty(this, \"result\", void 0);\n\n    _defineProperty(this, \"_resolve\", () => {});\n\n    _defineProperty(this, \"_reject\", () => {});\n\n    this.name = jobName;\n    this.workerThread = workerThread;\n    this.result = new Promise((resolve, reject) => {\n      this._resolve = resolve;\n      this._reject = reject;\n    });\n  }\n\n  postMessage(type, payload) {\n    this.workerThread.postMessage({\n      source: 'loaders.gl',\n      type,\n      payload\n    });\n  }\n\n  done(value) {\n    assert(this.isRunning);\n    this.isRunning = false;\n\n    this._resolve(value);\n  }\n\n  error(error) {\n    assert(this.isRunning);\n    this.isRunning = false;\n\n    this._reject(error);\n  }\n\n}\n//# sourceMappingURL=worker-job.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { isMobile } from '../env-utils/globals';\nimport WorkerThread from './worker-thread';\nimport WorkerJob from './worker-job';\nexport default class WorkerPool {\n  static isSupported() {\n    return WorkerThread.isSupported();\n  }\n\n  constructor(props) {\n    _defineProperty(this, \"name\", 'unnamed');\n\n    _defineProperty(this, \"source\", void 0);\n\n    _defineProperty(this, \"url\", void 0);\n\n    _defineProperty(this, \"maxConcurrency\", 1);\n\n    _defineProperty(this, \"maxMobileConcurrency\", 1);\n\n    _defineProperty(this, \"onDebug\", () => {});\n\n    _defineProperty(this, \"reuseWorkers\", true);\n\n    _defineProperty(this, \"props\", {});\n\n    _defineProperty(this, \"jobQueue\", []);\n\n    _defineProperty(this, \"idleQueue\", []);\n\n    _defineProperty(this, \"count\", 0);\n\n    _defineProperty(this, \"isDestroyed\", false);\n\n    this.source = props.source;\n    this.url = props.url;\n    this.setProps(props);\n  }\n\n  destroy() {\n    this.idleQueue.forEach(worker => worker.destroy());\n    this.isDestroyed = true;\n  }\n\n  setProps(props) {\n    this.props = { ...this.props,\n      ...props\n    };\n\n    if (props.name !== undefined) {\n      this.name = props.name;\n    }\n\n    if (props.maxConcurrency !== undefined) {\n      this.maxConcurrency = props.maxConcurrency;\n    }\n\n    if (props.maxMobileConcurrency !== undefined) {\n      this.maxMobileConcurrency = props.maxMobileConcurrency;\n    }\n\n    if (props.reuseWorkers !== undefined) {\n      this.reuseWorkers = props.reuseWorkers;\n    }\n\n    if (props.onDebug !== undefined) {\n      this.onDebug = props.onDebug;\n    }\n  }\n\n  async startJob(name, onMessage = (job, type, data) => job.done(data), onError = (job, error) => job.error(error)) {\n    const startPromise = new Promise(onStart => {\n      this.jobQueue.push({\n        name,\n        onMessage,\n        onError,\n        onStart\n      });\n      return this;\n    });\n\n    this._startQueuedJob();\n\n    return await startPromise;\n  }\n\n  async _startQueuedJob() {\n    if (!this.jobQueue.length) {\n      return;\n    }\n\n    const workerThread = this._getAvailableWorker();\n\n    if (!workerThread) {\n      return;\n    }\n\n    const queuedJob = this.jobQueue.shift();\n\n    if (queuedJob) {\n      this.onDebug({\n        message: 'Starting job',\n        name: queuedJob.name,\n        workerThread,\n        backlog: this.jobQueue.length\n      });\n      const job = new WorkerJob(queuedJob.name, workerThread);\n\n      workerThread.onMessage = data => queuedJob.onMessage(job, data.type, data.payload);\n\n      workerThread.onError = error => queuedJob.onError(job, error);\n\n      queuedJob.onStart(job);\n\n      try {\n        await job.result;\n      } finally {\n        this.returnWorkerToQueue(workerThread);\n      }\n    }\n  }\n\n  returnWorkerToQueue(worker) {\n    const shouldDestroyWorker = this.isDestroyed || !this.reuseWorkers || this.count > this._getMaxConcurrency();\n\n    if (shouldDestroyWorker) {\n      worker.destroy();\n      this.count--;\n    } else {\n      this.idleQueue.push(worker);\n    }\n\n    if (!this.isDestroyed) {\n      this._startQueuedJob();\n    }\n  }\n\n  _getAvailableWorker() {\n    if (this.idleQueue.length > 0) {\n      return this.idleQueue.shift() || null;\n    }\n\n    if (this.count < this._getMaxConcurrency()) {\n      this.count++;\n      const name = \"\".concat(this.name.toLowerCase(), \" (#\").concat(this.count, \" of \").concat(this.maxConcurrency, \")\");\n      return new WorkerThread({\n        name,\n        source: this.source,\n        url: this.url\n      });\n    }\n\n    return null;\n  }\n\n  _getMaxConcurrency() {\n    return isMobile ? this.maxMobileConcurrency : this.maxConcurrency;\n  }\n\n}\n//# sourceMappingURL=worker-pool.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport WorkerPool from './worker-pool';\nimport WorkerThread from './worker-thread';\nconst DEFAULT_PROPS = {\n  maxConcurrency: 3,\n  maxMobileConcurrency: 1,\n  reuseWorkers: true,\n  onDebug: () => {}\n};\nexport default class WorkerFarm {\n  static isSupported() {\n    return WorkerThread.isSupported();\n  }\n\n  static getWorkerFarm(props = {}) {\n    WorkerFarm._workerFarm = WorkerFarm._workerFarm || new WorkerFarm({});\n\n    WorkerFarm._workerFarm.setProps(props);\n\n    return WorkerFarm._workerFarm;\n  }\n\n  constructor(props) {\n    _defineProperty(this, \"props\", void 0);\n\n    _defineProperty(this, \"workerPools\", new Map());\n\n    this.props = { ...DEFAULT_PROPS\n    };\n    this.setProps(props);\n    this.workerPools = new Map();\n  }\n\n  destroy() {\n    for (const workerPool of this.workerPools.values()) {\n      workerPool.destroy();\n    }\n\n    this.workerPools = new Map();\n  }\n\n  setProps(props) {\n    this.props = { ...this.props,\n      ...props\n    };\n\n    for (const workerPool of this.workerPools.values()) {\n      workerPool.setProps(this._getWorkerPoolProps());\n    }\n  }\n\n  getWorkerPool(options) {\n    const {\n      name,\n      source,\n      url\n    } = options;\n    let workerPool = this.workerPools.get(name);\n\n    if (!workerPool) {\n      workerPool = new WorkerPool({\n        name,\n        source,\n        url\n      });\n      workerPool.setProps(this._getWorkerPoolProps());\n      this.workerPools.set(name, workerPool);\n    }\n\n    return workerPool;\n  }\n\n  _getWorkerPoolProps() {\n    return {\n      maxConcurrency: this.props.maxConcurrency,\n      maxMobileConcurrency: this.props.maxMobileConcurrency,\n      reuseWorkers: this.props.reuseWorkers,\n      onDebug: this.props.onDebug\n    };\n  }\n\n}\n\n_defineProperty(WorkerFarm, \"_workerFarm\", void 0);\n//# sourceMappingURL=worker-farm.js.map","export async function* makeTextDecoderIterator(arrayBufferIterator, options = {}) {\n  const textDecoder = new TextDecoder(undefined, options);\n\n  for await (const arrayBuffer of arrayBufferIterator) {\n    yield typeof arrayBuffer === 'string' ? arrayBuffer : textDecoder.decode(arrayBuffer, {\n      stream: true\n    });\n  }\n}\nexport async function* makeTextEncoderIterator(textIterator) {\n  const textEncoder = new TextEncoder();\n\n  for await (const text of textIterator) {\n    yield typeof text === 'string' ? textEncoder.encode(text) : text;\n  }\n}\nexport async function* makeLineIterator(textIterator) {\n  let previous = '';\n\n  for await (const textChunk of textIterator) {\n    previous += textChunk;\n    let eolIndex;\n\n    while ((eolIndex = previous.indexOf('\\n')) >= 0) {\n      const line = previous.slice(0, eolIndex + 1);\n      previous = previous.slice(eolIndex + 1);\n      yield line;\n    }\n  }\n\n  if (previous.length > 0) {\n    yield previous;\n  }\n}\nexport async function* makeNumberedLineIterator(lineIterator) {\n  let counter = 1;\n\n  for await (const line of lineIterator) {\n    yield {\n      counter,\n      line\n    };\n    counter++;\n  }\n}\n//# sourceMappingURL=text-iterators.js.map","export function getFirstCharacters(data, length = 5) {\n  if (typeof data === 'string') {\n    return data.slice(0, length);\n  } else if (ArrayBuffer.isView(data)) {\n    return getMagicString(data.buffer, data.byteOffset, length);\n  } else if (data instanceof ArrayBuffer) {\n    const byteOffset = 0;\n    return getMagicString(data, byteOffset, length);\n  }\n\n  return '';\n}\nexport function getMagicString(arrayBuffer, byteOffset, length) {\n  if (arrayBuffer.byteLength <= byteOffset + length) {\n    return '';\n  }\n\n  const dataView = new DataView(arrayBuffer);\n  let magic = '';\n\n  for (let i = 0; i < length; i++) {\n    magic += String.fromCharCode(dataView.getUint8(byteOffset + i));\n  }\n\n  return magic;\n}\n//# sourceMappingURL=get-first-characters.js.map","export default function getHiResTimestamp() {\n  let timestamp;\n\n  if (typeof window !== 'undefined' && window.performance) {\n    timestamp = window.performance.now();\n  } else if (typeof process !== 'undefined' && process.hrtime) {\n    const timeParts = process.hrtime();\n    timestamp = timeParts[0] * 1000 + timeParts[1] / 1e6;\n  } else {\n    timestamp = Date.now();\n  }\n\n  return timestamp;\n}\n//# sourceMappingURL=hi-res-timestamp.js.map","import {COMPONENT_SYMBOL} from './constants';\nimport {PropType} from './prop-types';\n\nexport function validateProps(props) {\n  const propTypes = getPropTypes(props);\n\n  for (const propName in propTypes) {\n    const propType = propTypes[propName];\n    const {validate} = propType;\n    if (validate && !validate(props[propName], propType)) {\n      throw new Error(`Invalid prop ${propName}: ${props[propName]}`);\n    }\n  }\n}\n\n// Returns an object with \"change flags\", either false or strings indicating reason for change\nexport function diffProps(\n  props,\n  oldProps\n): {\n  dataChanged: string | false | {startRow: number; endRow?: number}[];\n  propsChanged: string | false;\n  updateTriggersChanged: Record<string, true> | false;\n  extensionsChanged: boolean;\n  transitionsChanged: Record<string, true> | false;\n} {\n  // First check if any props have changed (ignore props that will be examined separately)\n  const propsChangedReason = compareProps({\n    newProps: props,\n    oldProps,\n    propTypes: getPropTypes(props),\n    ignoreProps: {data: null, updateTriggers: null, extensions: null, transitions: null}\n  });\n\n  // Now check if any data related props have changed\n  const dataChangedReason = diffDataProps(props, oldProps);\n\n  // Check update triggers to determine if any attributes need regeneration\n  // Note - if data has changed, all attributes will need regeneration, so skip this step\n  let updateTriggersChangedReason: false | string | Record<string, true> = false;\n  if (!dataChangedReason) {\n    updateTriggersChangedReason = diffUpdateTriggers(props, oldProps);\n  }\n\n  return {\n    dataChanged: dataChangedReason,\n    propsChanged: propsChangedReason,\n    updateTriggersChanged: updateTriggersChangedReason,\n    extensionsChanged: diffExtensions(props, oldProps),\n    transitionsChanged: diffTransitions(props, oldProps)\n  };\n}\n\nfunction diffTransitions(props, oldProps): false | Record<string, true> {\n  if (!props.transitions) {\n    return false;\n  }\n  const result: Record<string, true> = {};\n  const propTypes = getPropTypes(props);\n  let changed = false;\n\n  for (const key in props.transitions) {\n    const propType = propTypes[key];\n    const type = propType && propType.type;\n    const isTransitionable = type === 'number' || type === 'color' || type === 'array';\n    if (isTransitionable && comparePropValues(props[key], oldProps[key], propType)) {\n      result[key] = true;\n      changed = true;\n    }\n  }\n  return changed ? result : false;\n}\n\n/**\n * Performs equality by iterating through keys on an object and returning false\n * when any key has values which are not strictly equal between the arguments.\n * @param {Object} opt.oldProps - object with old key/value pairs\n * @param {Object} opt.newProps - object with new key/value pairs\n * @param {Object} opt.ignoreProps={} - object, keys that should not be compared\n * @returns {null|String} - null when values of all keys are strictly equal.\n *   if unequal, returns a string explaining what changed.\n */\n/* eslint-disable max-statements, max-depth, complexity */\n/*\n * Note: for better performance, this function assumes that both oldProps and newProps\n   inherit the same prototype (defaultProps). That is, if neither object contains own\n   property <key>, assume `oldProps.<key>` and `newProps.<key>` are equal.\n */\nexport function compareProps({\n  newProps,\n  oldProps,\n  ignoreProps = {},\n  propTypes = {},\n  triggerName = 'props'\n}): string | false {\n  // shallow equality => deep equality\n  if (oldProps === newProps) {\n    return false;\n  }\n\n  // TODO - do we need these checks? Should never happen...\n  if (typeof newProps !== 'object' || newProps === null) {\n    return `${triggerName} changed shallowly`;\n  }\n\n  if (typeof oldProps !== 'object' || oldProps === null) {\n    return `${triggerName} changed shallowly`;\n  }\n\n  // Compare explicitly defined new props against old/default values\n  for (const key of Object.keys(newProps)) {\n    if (!(key in ignoreProps)) {\n      if (!(key in oldProps)) {\n        return `${triggerName}.${key} added`;\n      }\n      const changed = comparePropValues(newProps[key], oldProps[key], propTypes[key]);\n      if (changed) {\n        return `${triggerName}.${key} ${changed}`;\n      }\n    }\n  }\n\n  // Test if any old props have been dropped\n  for (const key of Object.keys(oldProps)) {\n    if (!(key in ignoreProps)) {\n      if (!(key in newProps)) {\n        return `${triggerName}.${key} dropped`;\n      }\n      if (!Object.hasOwnProperty.call(newProps, key)) {\n        // Compare dropped old prop against default value\n        const changed = comparePropValues(newProps[key], oldProps[key], propTypes[key]);\n        if (changed) {\n          return `${triggerName}.${key} ${changed}`;\n        }\n      }\n    }\n  }\n\n  return false;\n}\n/* eslint-enable max-statements, max-depth, complexity */\n\n// HELPERS\nfunction comparePropValues(newProp, oldProp, propType) {\n  // If prop type has an equal function, invoke it\n  let equal = propType && propType.equal;\n  if (equal && !equal(newProp, oldProp, propType)) {\n    return 'changed deeply';\n  }\n\n  if (!equal) {\n    // If object has an equals function, invoke it\n    equal = newProp && oldProp && newProp.equals;\n    if (equal && !equal.call(newProp, oldProp)) {\n      return 'changed deeply';\n    }\n  }\n\n  if (!equal && oldProp !== newProp) {\n    return 'changed shallowly';\n  }\n\n  return null;\n}\n\n// The comparison of the data prop requires special handling\n// the dataComparator should be used if supplied\nfunction diffDataProps(props, oldProps): string | false | {startRow: number; endRow?: number}[] {\n  if (oldProps === null) {\n    return 'oldProps is null, initial diff';\n  }\n\n  let dataChanged: string | false | {startRow: number; endRow?: number}[] = false;\n  // Support optional app defined comparison of data\n  const {dataComparator, _dataDiff} = props;\n  if (dataComparator) {\n    if (!dataComparator(props.data, oldProps.data)) {\n      dataChanged = 'Data comparator detected a change';\n    }\n    // Otherwise, do a shallow equal on props\n  } else if (props.data !== oldProps.data) {\n    dataChanged = 'A new data container was supplied';\n  }\n  if (dataChanged && _dataDiff) {\n    dataChanged = _dataDiff(props.data, oldProps.data) || dataChanged;\n  }\n\n  return dataChanged;\n}\n\n// Checks if any update triggers have changed\n// also calls callback to invalidate attributes accordingly.\nfunction diffUpdateTriggers(props, oldProps): Record<string, true> | false {\n  if (oldProps === null) {\n    return {all: true};\n  }\n\n  // If the 'all' updateTrigger fires, ignore testing others\n  if ('all' in props.updateTriggers) {\n    const diffReason = diffUpdateTrigger(props, oldProps, 'all');\n    if (diffReason) {\n      return {all: true};\n    }\n  }\n\n  const reason: Record<string, true> = {};\n  let changed = false;\n  // If the 'all' updateTrigger didn't fire, need to check all others\n  for (const triggerName in props.updateTriggers) {\n    if (triggerName !== 'all') {\n      const diffReason = diffUpdateTrigger(props, oldProps, triggerName);\n      if (diffReason) {\n        reason[triggerName] = true;\n        changed = true;\n      }\n    }\n  }\n\n  return changed ? reason : false;\n}\n\n// Returns true if any extensions have changed\nfunction diffExtensions(props, oldProps): boolean {\n  if (oldProps === null) {\n    return true;\n  }\n\n  const oldExtensions = oldProps.extensions;\n  const {extensions} = props;\n\n  if (extensions === oldExtensions) {\n    return false;\n  }\n  if (!oldExtensions || !extensions) {\n    return true;\n  }\n  if (extensions.length !== oldExtensions.length) {\n    return true;\n  }\n  for (let i = 0; i < extensions.length; i++) {\n    if (!extensions[i].equals(oldExtensions[i])) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction diffUpdateTrigger(props, oldProps, triggerName) {\n  let newTriggers = props.updateTriggers[triggerName];\n  newTriggers = newTriggers === undefined || newTriggers === null ? {} : newTriggers;\n  let oldTriggers = oldProps.updateTriggers[triggerName];\n  oldTriggers = oldTriggers === undefined || oldTriggers === null ? {} : oldTriggers;\n  const diffReason = compareProps({\n    oldProps: oldTriggers,\n    newProps: newTriggers,\n    triggerName\n  });\n  return diffReason;\n}\n\nfunction getPropTypes(props): Record<string, PropType> {\n  const layer = props[COMPONENT_SYMBOL];\n  const LayerType = layer && layer.constructor;\n  return LayerType ? LayerType._propTypes : {};\n}\n","import {default as LayersPass} from './layers-pass';\nimport {\n  Framebuffer,\n  Texture2D,\n  Renderbuffer,\n  withParameters,\n  cssToDeviceRatio\n} from '@luma.gl/core';\n\nexport default class ShadowPass extends LayersPass {\n  shadowMap: Texture2D;\n  depthBuffer: Renderbuffer;\n  fbo: Framebuffer;\n\n  constructor(\n    gl: WebGLRenderingContext,\n    props?: {\n      id;\n    }\n  ) {\n    super(gl, props);\n\n    // The shadowMap texture\n    this.shadowMap = new Texture2D(gl, {\n      width: 1,\n      height: 1,\n      parameters: {\n        [gl.TEXTURE_MIN_FILTER]: gl.LINEAR,\n        [gl.TEXTURE_MAG_FILTER]: gl.LINEAR,\n        [gl.TEXTURE_WRAP_S]: gl.CLAMP_TO_EDGE,\n        [gl.TEXTURE_WRAP_T]: gl.CLAMP_TO_EDGE\n      }\n    });\n\n    this.depthBuffer = new Renderbuffer(gl, {\n      format: gl.DEPTH_COMPONENT16,\n      width: 1,\n      height: 1\n    });\n\n    this.fbo = new Framebuffer(gl, {\n      id: 'shadowmap',\n      width: 1,\n      height: 1,\n      attachments: {\n        [gl.COLOR_ATTACHMENT0]: this.shadowMap,\n        // Depth attachment has to be specified for depth test to work\n        [gl.DEPTH_ATTACHMENT]: this.depthBuffer\n      }\n    });\n  }\n\n  render(params) {\n    const target = this.fbo;\n\n    withParameters(\n      this.gl,\n      {\n        depthRange: [0, 1],\n        depthTest: true,\n        blend: false,\n        clearColor: [1, 1, 1, 1]\n      },\n      () => {\n        const viewport = params.viewports[0];\n        const pixelRatio = cssToDeviceRatio(this.gl);\n        const width = viewport.width * pixelRatio;\n        const height = viewport.height * pixelRatio;\n        if (width !== target.width || height !== target.height) {\n          target.resize({width, height});\n        }\n\n        super.render({...params, target, pass: 'shadow'});\n      }\n    );\n  }\n\n  shouldDrawLayer(layer) {\n    return layer.props.shadowEnabled !== false;\n  }\n\n  getModuleParameters() {\n    return {\n      drawToShadowMap: true\n    };\n  }\n\n  delete() {\n    if (this.fbo) {\n      this.fbo.delete();\n      this.fbo = null;\n    }\n\n    if (this.shadowMap) {\n      this.shadowMap.delete();\n      this.shadowMap = null;\n    }\n\n    if (this.depthBuffer) {\n      this.depthBuffer.delete();\n      this.depthBuffer = null;\n    }\n  }\n}\n","import {Texture2D, ProgramManager} from '@luma.gl/core';\nimport {AmbientLight} from './ambient-light';\nimport {DirectionalLight} from './directional-light';\nimport {PointLight} from './point-light';\nimport {Matrix4, Vector3} from '@math.gl/core';\nimport ShadowPass from '../../passes/shadow-pass';\nimport shadow from '../../shaderlib/shadow/shadow';\n\nimport type Layer from '../../lib/layer';\nimport type {Effect, PreRenderOptions} from '../../lib/effect';\n\nconst DEFAULT_AMBIENT_LIGHT_PROPS = {color: [255, 255, 255], intensity: 1.0};\nconst DEFAULT_DIRECTIONAL_LIGHT_PROPS = [\n  {\n    color: [255, 255, 255],\n    intensity: 1.0,\n    direction: [-1, 3, -1]\n  },\n  {\n    color: [255, 255, 255],\n    intensity: 0.9,\n    direction: [1, -8, -2.5]\n  }\n];\nconst DEFAULT_SHADOW_COLOR = [0, 0, 0, 200 / 255];\n\n// Class to manage ambient, point and directional light sources in deck\nexport default class LightingEffect implements Effect {\n  id = 'lighting-effect';\n  props = null;\n  shadowColor: number[] = DEFAULT_SHADOW_COLOR;\n\n  private shadow: boolean;\n  private ambientLight: AmbientLight | null = null;\n  private directionalLights: DirectionalLight[] = [];\n  private pointLights: PointLight[] = [];\n  private shadowPasses: ShadowPass[] = [];\n  private shadowMaps: Texture2D[] = [];\n  private dummyShadowMap: Texture2D | null = null;\n  private programManager?: ProgramManager;\n  private shadowMatrices?: Matrix4[];\n\n  constructor(props: Record<string, PointLight | DirectionalLight | AmbientLight> = {}) {\n    for (const key in props) {\n      const lightSource = props[key];\n\n      switch (lightSource.type) {\n        case 'ambient':\n          this.ambientLight = lightSource;\n          break;\n\n        case 'directional':\n          this.directionalLights.push(lightSource as DirectionalLight);\n          break;\n\n        case 'point':\n          this.pointLights.push(lightSource as PointLight);\n          break;\n        default:\n      }\n    }\n    this._applyDefaultLights();\n\n    this.shadow = this.directionalLights.some(light => light.shadow);\n  }\n\n  preRender(\n    gl: WebGLRenderingContext,\n    {layers, layerFilter, viewports, onViewportActive, views}: PreRenderOptions\n  ) {\n    if (!this.shadow) return;\n\n    // create light matrix every frame to make sure always updated from light source\n    this.shadowMatrices = this._calculateMatrices();\n\n    if (this.shadowPasses.length === 0) {\n      this._createShadowPasses(gl);\n    }\n    if (!this.programManager) {\n      // TODO - support multiple contexts\n      this.programManager = ProgramManager.getDefaultProgramManager(gl);\n      if (shadow) {\n        this.programManager.addDefaultModule(shadow);\n      }\n    }\n\n    if (!this.dummyShadowMap) {\n      this.dummyShadowMap = new Texture2D(gl, {\n        width: 1,\n        height: 1\n      });\n    }\n\n    for (let i = 0; i < this.shadowPasses.length; i++) {\n      const shadowPass = this.shadowPasses[i];\n      shadowPass.render({\n        layers,\n        layerFilter,\n        viewports,\n        onViewportActive,\n        views,\n        moduleParameters: {\n          shadowLightId: i,\n          dummyShadowMap: this.dummyShadowMap,\n          shadowMatrices: this.shadowMatrices\n        }\n      });\n    }\n  }\n\n  getModuleParameters(layer: Layer) {\n    const parameters: {\n      lightSources?: {\n        ambientLight: AmbientLight | null;\n        directionalLights: DirectionalLight[];\n        pointLights: PointLight[];\n      };\n      shadowMaps?: Texture2D[];\n      dummyShadowMap?: Texture2D;\n      shadowColor?: number[];\n      shadowMatrices?: Matrix4[];\n    } = this.shadow\n      ? {\n          shadowMaps: this.shadowMaps,\n          dummyShadowMap: this.dummyShadowMap,\n          shadowColor: this.shadowColor,\n          shadowMatrices: this.shadowMatrices\n        }\n      : {};\n\n    // when not rendering to screen, turn off lighting by adding empty light source object\n    // lights shader module relies on the `lightSources` to turn on/off lighting\n    parameters.lightSources = {\n      ambientLight: this.ambientLight,\n      directionalLights: this.directionalLights.map(directionalLight =>\n        directionalLight.getProjectedLight({layer})\n      ),\n      pointLights: this.pointLights.map(pointLight => pointLight.getProjectedLight({layer}))\n    };\n\n    return parameters;\n  }\n\n  cleanup(): void {\n    for (const shadowPass of this.shadowPasses) {\n      shadowPass.delete();\n    }\n    this.shadowPasses.length = 0;\n    this.shadowMaps.length = 0;\n\n    if (this.dummyShadowMap) {\n      this.dummyShadowMap.delete();\n      this.dummyShadowMap = null;\n    }\n\n    if (this.shadow && this.programManager) {\n      this.programManager.removeDefaultModule(shadow);\n      this.programManager = null;\n    }\n  }\n\n  private _calculateMatrices(): Matrix4[] {\n    const lightMatrices: Matrix4[] = [];\n    for (const light of this.directionalLights) {\n      const viewMatrix = new Matrix4().lookAt({\n        eye: new Vector3(light.direction).negate()\n      });\n\n      lightMatrices.push(viewMatrix);\n    }\n    return lightMatrices;\n  }\n\n  private _createShadowPasses(gl: WebGLRenderingContext): void {\n    for (let i = 0; i < this.directionalLights.length; i++) {\n      const shadowPass = new ShadowPass(gl);\n      this.shadowPasses[i] = shadowPass;\n      this.shadowMaps[i] = shadowPass.shadowMap;\n    }\n  }\n\n  private _applyDefaultLights(): void {\n    const {ambientLight, pointLights, directionalLights} = this;\n    if (!ambientLight && pointLights.length === 0 && directionalLights.length === 0) {\n      this.ambientLight = new AmbientLight(DEFAULT_AMBIENT_LIGHT_PROPS);\n      this.directionalLights.push(\n        new DirectionalLight(DEFAULT_DIRECTIONAL_LIGHT_PROPS[0]),\n        new DirectionalLight(DEFAULT_DIRECTIONAL_LIGHT_PROPS[1])\n      );\n    }\n  }\n}\n","var superPropBase = require(\"./superPropBase.js\");\nfunction _get() {\n  if (typeof Reflect !== \"undefined\" && Reflect.get) {\n    module.exports = _get = Reflect.get.bind(), module.exports.__esModule = true, module.exports[\"default\"] = module.exports;\n  } else {\n    module.exports = _get = function _get(target, property, receiver) {\n      var base = superPropBase(target, property);\n      if (!base) return;\n      var desc = Object.getOwnPropertyDescriptor(base, property);\n      if (desc.get) {\n        return desc.get.call(arguments.length < 3 ? target : receiver);\n      }\n      return desc.value;\n    }, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;\n  }\n  return _get.apply(this, arguments);\n}\nmodule.exports = _get, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","module.exports = __WEBPACK_EXTERNAL_MODULE__141__;","import isElectron from './is-electron';\nexport default function isBrowser() {\n  const isNode = typeof process === 'object' && String(process) === '[object process]' && !process.browser;\n  return !isNode || isElectron();\n}\nexport function isBrowserMainThread() {\n  return isBrowser() && typeof document !== 'undefined';\n}\n//# sourceMappingURL=is-browser.js.map","import { log } from '@luma.gl/gltools';\nexport function checkProps(className, props, propChecks) {\n  const {\n    removedProps = {},\n    deprecatedProps = {},\n    replacedProps = {}\n  } = propChecks;\n\n  for (const propName in removedProps) {\n    if (propName in props) {\n      const replacementProp = removedProps[propName];\n      const replacement = replacementProp ? \"\".concat(className, \".\").concat(removedProps[propName]) : 'N/A';\n      log.removed(\"\".concat(className, \".\").concat(propName), replacement)();\n    }\n  }\n\n  for (const propName in deprecatedProps) {\n    if (propName in props) {\n      const replacementProp = deprecatedProps[propName];\n      log.deprecated(\"\".concat(className, \".\").concat(propName), \"\".concat(className, \".\").concat(replacementProp))();\n    }\n  }\n\n  let newProps = null;\n\n  for (const propName in replacedProps) {\n    if (propName in props) {\n      const replacementProp = replacedProps[propName];\n      log.deprecated(\"\".concat(className, \".\").concat(propName), \"\".concat(className, \".\").concat(replacementProp))();\n      newProps = newProps || Object.assign({}, props);\n      newProps[replacementProp] = props[propName];\n      delete newProps[propName];\n    }\n  }\n\n  return newProps || props;\n}\n//# sourceMappingURL=check-props.js.map","export default function assert(condition, message) {\n  if (!condition) {\n    throw new Error(\"math.gl assertion \".concat(message));\n  }\n}\n//# sourceMappingURL=assert.js.map","/**\n * Projection utils\n * TODO: move to Viewport class?\n */\nimport {COORDINATE_SYSTEM} from '../../lib/constants';\nimport {getOffsetOrigin} from './viewport-uniforms';\nimport WebMercatorViewport from '../../viewports/web-mercator-viewport';\n\nimport * as vec4 from 'gl-matrix/vec4';\nimport * as vec3 from 'gl-matrix/vec3';\nimport {addMetersToLngLat} from '@math.gl/web-mercator';\n\nimport type {CoordinateSystem} from '../../lib/constants';\nimport type Viewport from '../../viewports/viewport';\nimport type {NumericArray} from '../../types/types';\n\n// In project.glsl, offset modes calculate z differently from LNG_LAT mode.\n// offset modes apply the y adjustment (unitsPerMeter2) when projecting z\n// LNG_LAT mode only use the linear scale.\nfunction lngLatZToWorldPosition(\n  lngLatZ: [number, number, number],\n  viewport: Viewport,\n  offsetMode: boolean = false\n): [number, number, number] {\n  const p = viewport.projectPosition(lngLatZ);\n\n  // TODO - avoid using instanceof\n  if (offsetMode && viewport instanceof WebMercatorViewport) {\n    const [longitude, latitude, z = 0] = lngLatZ;\n    const distanceScales = viewport.getDistanceScales([longitude, latitude]);\n    p[2] = z * distanceScales.unitsPerMeter[2];\n  }\n  return p;\n}\n\nfunction normalizeParameters(opts: {\n  viewport: Viewport;\n  coordinateSystem: CoordinateSystem;\n  coordinateOrigin: [number, number, number];\n  modelMatrix?: NumericArray | null;\n  fromCoordinateSystem?: CoordinateSystem;\n  fromCoordinateOrigin?: [number, number, number];\n}): {\n  viewport: Viewport;\n  coordinateSystem: CoordinateSystem;\n  coordinateOrigin: [number, number, number];\n  modelMatrix?: NumericArray | null;\n  fromCoordinateSystem: CoordinateSystem;\n  fromCoordinateOrigin: [number, number, number];\n} {\n  const {viewport, modelMatrix, coordinateOrigin} = opts;\n  let {coordinateSystem, fromCoordinateSystem, fromCoordinateOrigin} = opts;\n\n  if (coordinateSystem === COORDINATE_SYSTEM.DEFAULT) {\n    coordinateSystem = viewport.isGeospatial\n      ? COORDINATE_SYSTEM.LNGLAT\n      : COORDINATE_SYSTEM.CARTESIAN;\n  }\n\n  if (fromCoordinateSystem === undefined) {\n    fromCoordinateSystem = coordinateSystem;\n  }\n  if (fromCoordinateOrigin === undefined) {\n    fromCoordinateOrigin = coordinateOrigin;\n  }\n\n  return {\n    viewport,\n    coordinateSystem,\n    coordinateOrigin,\n    modelMatrix,\n    fromCoordinateSystem,\n    fromCoordinateOrigin\n  };\n}\n\n/** Get the common space position from world coordinates in the given coordinate system */\nexport function getWorldPosition(\n  position: number[],\n  {\n    viewport,\n    modelMatrix,\n    coordinateSystem,\n    coordinateOrigin,\n    offsetMode\n  }: {\n    viewport: Viewport;\n    modelMatrix?: NumericArray | null;\n    coordinateSystem: CoordinateSystem;\n    coordinateOrigin: [number, number, number];\n    offsetMode?: boolean;\n  }\n): [number, number, number] {\n  let [x, y, z = 0] = position;\n\n  if (modelMatrix) {\n    [x, y, z] = vec4.transformMat4([], [x, y, z, 1.0], modelMatrix);\n  }\n\n  switch (coordinateSystem) {\n    case COORDINATE_SYSTEM.LNGLAT:\n      return lngLatZToWorldPosition([x, y, z], viewport, offsetMode);\n\n    case COORDINATE_SYSTEM.LNGLAT_OFFSETS:\n      return lngLatZToWorldPosition(\n        [x + coordinateOrigin[0], y + coordinateOrigin[1], z + (coordinateOrigin[2] || 0)],\n        viewport,\n        offsetMode\n      );\n\n    case COORDINATE_SYSTEM.METER_OFFSETS:\n      return lngLatZToWorldPosition(\n        addMetersToLngLat(coordinateOrigin, [x, y, z]) as [number, number, number],\n        viewport,\n        offsetMode\n      );\n\n    case COORDINATE_SYSTEM.CARTESIAN:\n    default:\n      return viewport.isGeospatial\n        ? [x + coordinateOrigin[0], y + coordinateOrigin[1], z + coordinateOrigin[2]]\n        : viewport.projectPosition([x, y, z]);\n  }\n}\n\n/**\n * Equivalent to project_position in project.glsl\n * projects a user supplied position to world position directly with or without\n * a reference coordinate system\n */\nexport function projectPosition(\n  position: number[],\n  params: {\n    /** The current viewport */\n    viewport: Viewport;\n    /** The reference coordinate system used to align world position */\n    coordinateSystem: CoordinateSystem;\n    /** The reference coordinate origin used to align world position */\n    coordinateOrigin: [number, number, number];\n    /** The model matrix of the supplied position */\n    modelMatrix?: NumericArray | null;\n    /** The coordinate system that the supplied position is in. Default to the same as `coordinateSystem`. */\n    fromCoordinateSystem?: CoordinateSystem;\n    /** The coordinate origin that the supplied position is in. Default to the same as `coordinateOrigin`. */\n    fromCoordinateOrigin?: [number, number, number];\n  }\n): [number, number, number] {\n  const {\n    viewport,\n    coordinateSystem,\n    coordinateOrigin,\n    modelMatrix,\n    fromCoordinateSystem,\n    fromCoordinateOrigin\n  } = normalizeParameters(params);\n\n  const {geospatialOrigin, shaderCoordinateOrigin, offsetMode} = getOffsetOrigin(\n    viewport,\n    coordinateSystem,\n    coordinateOrigin\n  );\n\n  const worldPosition = getWorldPosition(position, {\n    viewport,\n    modelMatrix,\n    coordinateSystem: fromCoordinateSystem,\n    coordinateOrigin: fromCoordinateOrigin,\n    offsetMode\n  });\n\n  if (offsetMode) {\n    const positionCommonSpace = viewport.projectPosition(\n      geospatialOrigin || shaderCoordinateOrigin\n    );\n    vec3.sub(worldPosition, worldPosition, positionCommonSpace);\n  }\n\n  return worldPosition;\n}\n","export default \"#if (defined(SHADER_TYPE_FRAGMENT) && defined(LIGHTING_FRAGMENT)) || (defined(SHADER_TYPE_VERTEX) && defined(LIGHTING_VERTEX))\\n\\nstruct AmbientLight {\\n vec3 color;\\n};\\n\\nstruct PointLight {\\n vec3 color;\\n vec3 position;\\n vec3 attenuation;\\n};\\n\\nstruct DirectionalLight {\\n  vec3 color;\\n  vec3 direction;\\n};\\n\\nuniform AmbientLight lighting_uAmbientLight;\\nuniform PointLight lighting_uPointLight[MAX_LIGHTS];\\nuniform DirectionalLight lighting_uDirectionalLight[MAX_LIGHTS];\\nuniform int lighting_uPointLightCount;\\nuniform int lighting_uDirectionalLightCount;\\n\\nuniform bool lighting_uEnabled;\\n\\nfloat getPointLightAttenuation(PointLight pointLight, float distance) {\\n  return pointLight.attenuation.x\\n       + pointLight.attenuation.y * distance\\n       + pointLight.attenuation.z * distance * distance;\\n}\\n\\n#endif\\n\";\n//# sourceMappingURL=lights.glsl.js.map","import lightingShader from './lights.glsl';\nconst INITIAL_MODULE_OPTIONS = {\n  lightSources: {}\n};\n\nfunction convertColor() {\n  let {\n    color = [0, 0, 0],\n    intensity = 1.0\n  } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n  return color.map(component => component * intensity / 255.0);\n}\n\nfunction getLightSourceUniforms(_ref) {\n  let {\n    ambientLight,\n    pointLights = [],\n    directionalLights = []\n  } = _ref;\n  const lightSourceUniforms = {};\n\n  if (ambientLight) {\n    lightSourceUniforms['lighting_uAmbientLight.color'] = convertColor(ambientLight);\n  } else {\n    lightSourceUniforms['lighting_uAmbientLight.color'] = [0, 0, 0];\n  }\n\n  pointLights.forEach((pointLight, index) => {\n    lightSourceUniforms[\"lighting_uPointLight[\".concat(index, \"].color\")] = convertColor(pointLight);\n    lightSourceUniforms[\"lighting_uPointLight[\".concat(index, \"].position\")] = pointLight.position;\n    lightSourceUniforms[\"lighting_uPointLight[\".concat(index, \"].attenuation\")] = pointLight.attenuation || [1, 0, 0];\n  });\n  lightSourceUniforms.lighting_uPointLightCount = pointLights.length;\n  directionalLights.forEach((directionalLight, index) => {\n    lightSourceUniforms[\"lighting_uDirectionalLight[\".concat(index, \"].color\")] = convertColor(directionalLight);\n    lightSourceUniforms[\"lighting_uDirectionalLight[\".concat(index, \"].direction\")] = directionalLight.direction;\n  });\n  lightSourceUniforms.lighting_uDirectionalLightCount = directionalLights.length;\n  return lightSourceUniforms;\n}\n\nfunction getUniforms() {\n  let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : INITIAL_MODULE_OPTIONS;\n\n  if ('lightSources' in opts) {\n    const {\n      ambientLight,\n      pointLights,\n      directionalLights\n    } = opts.lightSources || {};\n    const hasLights = ambientLight || pointLights && pointLights.length > 0 || directionalLights && directionalLights.length > 0;\n\n    if (!hasLights) {\n      return {\n        lighting_uEnabled: false\n      };\n    }\n\n    return Object.assign({}, getLightSourceUniforms({\n      ambientLight,\n      pointLights,\n      directionalLights\n    }), {\n      lighting_uEnabled: true\n    });\n  }\n\n  if ('lights' in opts) {\n    const lightSources = {\n      pointLights: [],\n      directionalLights: []\n    };\n\n    for (const light of opts.lights || []) {\n      switch (light.type) {\n        case 'ambient':\n          lightSources.ambientLight = light;\n          break;\n\n        case 'directional':\n          lightSources.directionalLights.push(light);\n          break;\n\n        case 'point':\n          lightSources.pointLights.push(light);\n          break;\n\n        default:\n      }\n    }\n\n    return getUniforms({\n      lightSources\n    });\n  }\n\n  return {};\n}\n\nexport const lights = {\n  name: 'lights',\n  vs: lightingShader,\n  fs: lightingShader,\n  getUniforms,\n  defines: {\n    MAX_LIGHTS: 3\n  }\n};\n//# sourceMappingURL=lights.js.map","/*! Hammer.JS - v2.0.7 - 2016-04-22\n * http://hammerjs.github.io/\n *\n * Copyright (c) 2016 Jorik Tangelder;\n * Licensed under the MIT license */\n(function(window, document, exportName, undefined) {\n  'use strict';\n\nvar VENDOR_PREFIXES = ['', 'webkit', 'Moz', 'MS', 'ms', 'o'];\nvar TEST_ELEMENT = document.createElement('div');\n\nvar TYPE_FUNCTION = 'function';\n\nvar round = Math.round;\nvar abs = Math.abs;\nvar now = Date.now;\n\n/**\n * set a timeout with a given scope\n * @param {Function} fn\n * @param {Number} timeout\n * @param {Object} context\n * @returns {number}\n */\nfunction setTimeoutContext(fn, timeout, context) {\n    return setTimeout(bindFn(fn, context), timeout);\n}\n\n/**\n * if the argument is an array, we want to execute the fn on each entry\n * if it aint an array we don't want to do a thing.\n * this is used by all the methods that accept a single and array argument.\n * @param {*|Array} arg\n * @param {String} fn\n * @param {Object} [context]\n * @returns {Boolean}\n */\nfunction invokeArrayArg(arg, fn, context) {\n    if (Array.isArray(arg)) {\n        each(arg, context[fn], context);\n        return true;\n    }\n    return false;\n}\n\n/**\n * walk objects and arrays\n * @param {Object} obj\n * @param {Function} iterator\n * @param {Object} context\n */\nfunction each(obj, iterator, context) {\n    var i;\n\n    if (!obj) {\n        return;\n    }\n\n    if (obj.forEach) {\n        obj.forEach(iterator, context);\n    } else if (obj.length !== undefined) {\n        i = 0;\n        while (i < obj.length) {\n            iterator.call(context, obj[i], i, obj);\n            i++;\n        }\n    } else {\n        for (i in obj) {\n            obj.hasOwnProperty(i) && iterator.call(context, obj[i], i, obj);\n        }\n    }\n}\n\n/**\n * wrap a method with a deprecation warning and stack trace\n * @param {Function} method\n * @param {String} name\n * @param {String} message\n * @returns {Function} A new function wrapping the supplied method.\n */\nfunction deprecate(method, name, message) {\n    var deprecationMessage = 'DEPRECATED METHOD: ' + name + '\\n' + message + ' AT \\n';\n    return function() {\n        var e = new Error('get-stack-trace');\n        var stack = e && e.stack ? e.stack.replace(/^[^\\(]+?[\\n$]/gm, '')\n            .replace(/^\\s+at\\s+/gm, '')\n            .replace(/^Object.<anonymous>\\s*\\(/gm, '{anonymous}()@') : 'Unknown Stack Trace';\n\n        var log = window.console && (window.console.warn || window.console.log);\n        if (log) {\n            log.call(window.console, deprecationMessage, stack);\n        }\n        return method.apply(this, arguments);\n    };\n}\n\n/**\n * extend object.\n * means that properties in dest will be overwritten by the ones in src.\n * @param {Object} target\n * @param {...Object} objects_to_assign\n * @returns {Object} target\n */\nvar assign;\nif (typeof Object.assign !== 'function') {\n    assign = function assign(target) {\n        if (target === undefined || target === null) {\n            throw new TypeError('Cannot convert undefined or null to object');\n        }\n\n        var output = Object(target);\n        for (var index = 1; index < arguments.length; index++) {\n            var source = arguments[index];\n            if (source !== undefined && source !== null) {\n                for (var nextKey in source) {\n                    if (source.hasOwnProperty(nextKey)) {\n                        output[nextKey] = source[nextKey];\n                    }\n                }\n            }\n        }\n        return output;\n    };\n} else {\n    assign = Object.assign;\n}\n\n/**\n * extend object.\n * means that properties in dest will be overwritten by the ones in src.\n * @param {Object} dest\n * @param {Object} src\n * @param {Boolean} [merge=false]\n * @returns {Object} dest\n */\nvar extend = deprecate(function extend(dest, src, merge) {\n    var keys = Object.keys(src);\n    var i = 0;\n    while (i < keys.length) {\n        if (!merge || (merge && dest[keys[i]] === undefined)) {\n            dest[keys[i]] = src[keys[i]];\n        }\n        i++;\n    }\n    return dest;\n}, 'extend', 'Use `assign`.');\n\n/**\n * merge the values from src in the dest.\n * means that properties that exist in dest will not be overwritten by src\n * @param {Object} dest\n * @param {Object} src\n * @returns {Object} dest\n */\nvar merge = deprecate(function merge(dest, src) {\n    return extend(dest, src, true);\n}, 'merge', 'Use `assign`.');\n\n/**\n * simple class inheritance\n * @param {Function} child\n * @param {Function} base\n * @param {Object} [properties]\n */\nfunction inherit(child, base, properties) {\n    var baseP = base.prototype,\n        childP;\n\n    childP = child.prototype = Object.create(baseP);\n    childP.constructor = child;\n    childP._super = baseP;\n\n    if (properties) {\n        assign(childP, properties);\n    }\n}\n\n/**\n * simple function bind\n * @param {Function} fn\n * @param {Object} context\n * @returns {Function}\n */\nfunction bindFn(fn, context) {\n    return function boundFn() {\n        return fn.apply(context, arguments);\n    };\n}\n\n/**\n * let a boolean value also be a function that must return a boolean\n * this first item in args will be used as the context\n * @param {Boolean|Function} val\n * @param {Array} [args]\n * @returns {Boolean}\n */\nfunction boolOrFn(val, args) {\n    if (typeof val == TYPE_FUNCTION) {\n        return val.apply(args ? args[0] || undefined : undefined, args);\n    }\n    return val;\n}\n\n/**\n * use the val2 when val1 is undefined\n * @param {*} val1\n * @param {*} val2\n * @returns {*}\n */\nfunction ifUndefined(val1, val2) {\n    return (val1 === undefined) ? val2 : val1;\n}\n\n/**\n * addEventListener with multiple events at once\n * @param {EventTarget} target\n * @param {String} types\n * @param {Function} handler\n */\nfunction addEventListeners(target, types, handler) {\n    each(splitStr(types), function(type) {\n        target.addEventListener(type, handler, false);\n    });\n}\n\n/**\n * removeEventListener with multiple events at once\n * @param {EventTarget} target\n * @param {String} types\n * @param {Function} handler\n */\nfunction removeEventListeners(target, types, handler) {\n    each(splitStr(types), function(type) {\n        target.removeEventListener(type, handler, false);\n    });\n}\n\n/**\n * find if a node is in the given parent\n * @method hasParent\n * @param {HTMLElement} node\n * @param {HTMLElement} parent\n * @return {Boolean} found\n */\nfunction hasParent(node, parent) {\n    while (node) {\n        if (node == parent) {\n            return true;\n        }\n        node = node.parentNode;\n    }\n    return false;\n}\n\n/**\n * small indexOf wrapper\n * @param {String} str\n * @param {String} find\n * @returns {Boolean} found\n */\nfunction inStr(str, find) {\n    return str.indexOf(find) > -1;\n}\n\n/**\n * split string on whitespace\n * @param {String} str\n * @returns {Array} words\n */\nfunction splitStr(str) {\n    return str.trim().split(/\\s+/g);\n}\n\n/**\n * find if a array contains the object using indexOf or a simple polyFill\n * @param {Array} src\n * @param {String} find\n * @param {String} [findByKey]\n * @return {Boolean|Number} false when not found, or the index\n */\nfunction inArray(src, find, findByKey) {\n    if (src.indexOf && !findByKey) {\n        return src.indexOf(find);\n    } else {\n        var i = 0;\n        while (i < src.length) {\n            if ((findByKey && src[i][findByKey] == find) || (!findByKey && src[i] === find)) {\n                return i;\n            }\n            i++;\n        }\n        return -1;\n    }\n}\n\n/**\n * convert array-like objects to real arrays\n * @param {Object} obj\n * @returns {Array}\n */\nfunction toArray(obj) {\n    return Array.prototype.slice.call(obj, 0);\n}\n\n/**\n * unique array with objects based on a key (like 'id') or just by the array's value\n * @param {Array} src [{id:1},{id:2},{id:1}]\n * @param {String} [key]\n * @param {Boolean} [sort=False]\n * @returns {Array} [{id:1},{id:2}]\n */\nfunction uniqueArray(src, key, sort) {\n    var results = [];\n    var values = [];\n    var i = 0;\n\n    while (i < src.length) {\n        var val = key ? src[i][key] : src[i];\n        if (inArray(values, val) < 0) {\n            results.push(src[i]);\n        }\n        values[i] = val;\n        i++;\n    }\n\n    if (sort) {\n        if (!key) {\n            results = results.sort();\n        } else {\n            results = results.sort(function sortUniqueArray(a, b) {\n                return a[key] > b[key];\n            });\n        }\n    }\n\n    return results;\n}\n\n/**\n * get the prefixed property\n * @param {Object} obj\n * @param {String} property\n * @returns {String|Undefined} prefixed\n */\nfunction prefixed(obj, property) {\n    var prefix, prop;\n    var camelProp = property[0].toUpperCase() + property.slice(1);\n\n    var i = 0;\n    while (i < VENDOR_PREFIXES.length) {\n        prefix = VENDOR_PREFIXES[i];\n        prop = (prefix) ? prefix + camelProp : property;\n\n        if (prop in obj) {\n            return prop;\n        }\n        i++;\n    }\n    return undefined;\n}\n\n/**\n * get a unique id\n * @returns {number} uniqueId\n */\nvar _uniqueId = 1;\nfunction uniqueId() {\n    return _uniqueId++;\n}\n\n/**\n * get the window object of an element\n * @param {HTMLElement} element\n * @returns {DocumentView|Window}\n */\nfunction getWindowForElement(element) {\n    var doc = element.ownerDocument || element;\n    return (doc.defaultView || doc.parentWindow || window);\n}\n\nvar MOBILE_REGEX = /mobile|tablet|ip(ad|hone|od)|android/i;\n\nvar SUPPORT_TOUCH = ('ontouchstart' in window);\nvar SUPPORT_POINTER_EVENTS = prefixed(window, 'PointerEvent') !== undefined;\nvar SUPPORT_ONLY_TOUCH = SUPPORT_TOUCH && MOBILE_REGEX.test(navigator.userAgent);\n\nvar INPUT_TYPE_TOUCH = 'touch';\nvar INPUT_TYPE_PEN = 'pen';\nvar INPUT_TYPE_MOUSE = 'mouse';\nvar INPUT_TYPE_KINECT = 'kinect';\n\nvar COMPUTE_INTERVAL = 25;\n\nvar INPUT_START = 1;\nvar INPUT_MOVE = 2;\nvar INPUT_END = 4;\nvar INPUT_CANCEL = 8;\n\nvar DIRECTION_NONE = 1;\nvar DIRECTION_LEFT = 2;\nvar DIRECTION_RIGHT = 4;\nvar DIRECTION_UP = 8;\nvar DIRECTION_DOWN = 16;\n\nvar DIRECTION_HORIZONTAL = DIRECTION_LEFT | DIRECTION_RIGHT;\nvar DIRECTION_VERTICAL = DIRECTION_UP | DIRECTION_DOWN;\nvar DIRECTION_ALL = DIRECTION_HORIZONTAL | DIRECTION_VERTICAL;\n\nvar PROPS_XY = ['x', 'y'];\nvar PROPS_CLIENT_XY = ['clientX', 'clientY'];\n\n/**\n * create new input type manager\n * @param {Manager} manager\n * @param {Function} callback\n * @returns {Input}\n * @constructor\n */\nfunction Input(manager, callback) {\n    var self = this;\n    this.manager = manager;\n    this.callback = callback;\n    this.element = manager.element;\n    this.target = manager.options.inputTarget;\n\n    // smaller wrapper around the handler, for the scope and the enabled state of the manager,\n    // so when disabled the input events are completely bypassed.\n    this.domHandler = function(ev) {\n        if (boolOrFn(manager.options.enable, [manager])) {\n            self.handler(ev);\n        }\n    };\n\n    this.init();\n\n}\n\nInput.prototype = {\n    /**\n     * should handle the inputEvent data and trigger the callback\n     * @virtual\n     */\n    handler: function() { },\n\n    /**\n     * bind the events\n     */\n    init: function() {\n        this.evEl && addEventListeners(this.element, this.evEl, this.domHandler);\n        this.evTarget && addEventListeners(this.target, this.evTarget, this.domHandler);\n        this.evWin && addEventListeners(getWindowForElement(this.element), this.evWin, this.domHandler);\n    },\n\n    /**\n     * unbind the events\n     */\n    destroy: function() {\n        this.evEl && removeEventListeners(this.element, this.evEl, this.domHandler);\n        this.evTarget && removeEventListeners(this.target, this.evTarget, this.domHandler);\n        this.evWin && removeEventListeners(getWindowForElement(this.element), this.evWin, this.domHandler);\n    }\n};\n\n/**\n * create new input type manager\n * called by the Manager constructor\n * @param {Hammer} manager\n * @returns {Input}\n */\nfunction createInputInstance(manager) {\n    var Type;\n    var inputClass = manager.options.inputClass;\n\n    if (inputClass) {\n        Type = inputClass;\n    } else if (SUPPORT_POINTER_EVENTS) {\n        Type = PointerEventInput;\n    } else if (SUPPORT_ONLY_TOUCH) {\n        Type = TouchInput;\n    } else if (!SUPPORT_TOUCH) {\n        Type = MouseInput;\n    } else {\n        Type = TouchMouseInput;\n    }\n    return new (Type)(manager, inputHandler);\n}\n\n/**\n * handle input events\n * @param {Manager} manager\n * @param {String} eventType\n * @param {Object} input\n */\nfunction inputHandler(manager, eventType, input) {\n    var pointersLen = input.pointers.length;\n    var changedPointersLen = input.changedPointers.length;\n    var isFirst = (eventType & INPUT_START && (pointersLen - changedPointersLen === 0));\n    var isFinal = (eventType & (INPUT_END | INPUT_CANCEL) && (pointersLen - changedPointersLen === 0));\n\n    input.isFirst = !!isFirst;\n    input.isFinal = !!isFinal;\n\n    if (isFirst) {\n        manager.session = {};\n    }\n\n    // source event is the normalized value of the domEvents\n    // like 'touchstart, mouseup, pointerdown'\n    input.eventType = eventType;\n\n    // compute scale, rotation etc\n    computeInputData(manager, input);\n\n    // emit secret event\n    manager.emit('hammer.input', input);\n\n    manager.recognize(input);\n    manager.session.prevInput = input;\n}\n\n/**\n * extend the data with some usable properties like scale, rotate, velocity etc\n * @param {Object} manager\n * @param {Object} input\n */\nfunction computeInputData(manager, input) {\n    var session = manager.session;\n    var pointers = input.pointers;\n    var pointersLength = pointers.length;\n\n    // store the first input to calculate the distance and direction\n    if (!session.firstInput) {\n        session.firstInput = simpleCloneInputData(input);\n    }\n\n    // to compute scale and rotation we need to store the multiple touches\n    if (pointersLength > 1 && !session.firstMultiple) {\n        session.firstMultiple = simpleCloneInputData(input);\n    } else if (pointersLength === 1) {\n        session.firstMultiple = false;\n    }\n\n    var firstInput = session.firstInput;\n    var firstMultiple = session.firstMultiple;\n    var offsetCenter = firstMultiple ? firstMultiple.center : firstInput.center;\n\n    var center = input.center = getCenter(pointers);\n    input.timeStamp = now();\n    input.deltaTime = input.timeStamp - firstInput.timeStamp;\n\n    input.angle = getAngle(offsetCenter, center);\n    input.distance = getDistance(offsetCenter, center);\n\n    computeDeltaXY(session, input);\n    input.offsetDirection = getDirection(input.deltaX, input.deltaY);\n\n    var overallVelocity = getVelocity(input.deltaTime, input.deltaX, input.deltaY);\n    input.overallVelocityX = overallVelocity.x;\n    input.overallVelocityY = overallVelocity.y;\n    input.overallVelocity = (abs(overallVelocity.x) > abs(overallVelocity.y)) ? overallVelocity.x : overallVelocity.y;\n\n    input.scale = firstMultiple ? getScale(firstMultiple.pointers, pointers) : 1;\n    input.rotation = firstMultiple ? getRotation(firstMultiple.pointers, pointers) : 0;\n\n    input.maxPointers = !session.prevInput ? input.pointers.length : ((input.pointers.length >\n        session.prevInput.maxPointers) ? input.pointers.length : session.prevInput.maxPointers);\n\n    computeIntervalInputData(session, input);\n\n    // find the correct target\n    var target = manager.element;\n    if (hasParent(input.srcEvent.target, target)) {\n        target = input.srcEvent.target;\n    }\n    input.target = target;\n}\n\nfunction computeDeltaXY(session, input) {\n    var center = input.center;\n    var offset = session.offsetDelta || {};\n    var prevDelta = session.prevDelta || {};\n    var prevInput = session.prevInput || {};\n\n    if (input.eventType === INPUT_START || prevInput.eventType === INPUT_END) {\n        prevDelta = session.prevDelta = {\n            x: prevInput.deltaX || 0,\n            y: prevInput.deltaY || 0\n        };\n\n        offset = session.offsetDelta = {\n            x: center.x,\n            y: center.y\n        };\n    }\n\n    input.deltaX = prevDelta.x + (center.x - offset.x);\n    input.deltaY = prevDelta.y + (center.y - offset.y);\n}\n\n/**\n * velocity is calculated every x ms\n * @param {Object} session\n * @param {Object} input\n */\nfunction computeIntervalInputData(session, input) {\n    var last = session.lastInterval || input,\n        deltaTime = input.timeStamp - last.timeStamp,\n        velocity, velocityX, velocityY, direction;\n\n    if (input.eventType != INPUT_CANCEL && (deltaTime > COMPUTE_INTERVAL || last.velocity === undefined)) {\n        var deltaX = input.deltaX - last.deltaX;\n        var deltaY = input.deltaY - last.deltaY;\n\n        var v = getVelocity(deltaTime, deltaX, deltaY);\n        velocityX = v.x;\n        velocityY = v.y;\n        velocity = (abs(v.x) > abs(v.y)) ? v.x : v.y;\n        direction = getDirection(deltaX, deltaY);\n\n        session.lastInterval = input;\n    } else {\n        // use latest velocity info if it doesn't overtake a minimum period\n        velocity = last.velocity;\n        velocityX = last.velocityX;\n        velocityY = last.velocityY;\n        direction = last.direction;\n    }\n\n    input.velocity = velocity;\n    input.velocityX = velocityX;\n    input.velocityY = velocityY;\n    input.direction = direction;\n}\n\n/**\n * create a simple clone from the input used for storage of firstInput and firstMultiple\n * @param {Object} input\n * @returns {Object} clonedInputData\n */\nfunction simpleCloneInputData(input) {\n    // make a simple copy of the pointers because we will get a reference if we don't\n    // we only need clientXY for the calculations\n    var pointers = [];\n    var i = 0;\n    while (i < input.pointers.length) {\n        pointers[i] = {\n            clientX: round(input.pointers[i].clientX),\n            clientY: round(input.pointers[i].clientY)\n        };\n        i++;\n    }\n\n    return {\n        timeStamp: now(),\n        pointers: pointers,\n        center: getCenter(pointers),\n        deltaX: input.deltaX,\n        deltaY: input.deltaY\n    };\n}\n\n/**\n * get the center of all the pointers\n * @param {Array} pointers\n * @return {Object} center contains `x` and `y` properties\n */\nfunction getCenter(pointers) {\n    var pointersLength = pointers.length;\n\n    // no need to loop when only one touch\n    if (pointersLength === 1) {\n        return {\n            x: round(pointers[0].clientX),\n            y: round(pointers[0].clientY)\n        };\n    }\n\n    var x = 0, y = 0, i = 0;\n    while (i < pointersLength) {\n        x += pointers[i].clientX;\n        y += pointers[i].clientY;\n        i++;\n    }\n\n    return {\n        x: round(x / pointersLength),\n        y: round(y / pointersLength)\n    };\n}\n\n/**\n * calculate the velocity between two points. unit is in px per ms.\n * @param {Number} deltaTime\n * @param {Number} x\n * @param {Number} y\n * @return {Object} velocity `x` and `y`\n */\nfunction getVelocity(deltaTime, x, y) {\n    return {\n        x: x / deltaTime || 0,\n        y: y / deltaTime || 0\n    };\n}\n\n/**\n * get the direction between two points\n * @param {Number} x\n * @param {Number} y\n * @return {Number} direction\n */\nfunction getDirection(x, y) {\n    if (x === y) {\n        return DIRECTION_NONE;\n    }\n\n    if (abs(x) >= abs(y)) {\n        return x < 0 ? DIRECTION_LEFT : DIRECTION_RIGHT;\n    }\n    return y < 0 ? DIRECTION_UP : DIRECTION_DOWN;\n}\n\n/**\n * calculate the absolute distance between two points\n * @param {Object} p1 {x, y}\n * @param {Object} p2 {x, y}\n * @param {Array} [props] containing x and y keys\n * @return {Number} distance\n */\nfunction getDistance(p1, p2, props) {\n    if (!props) {\n        props = PROPS_XY;\n    }\n    var x = p2[props[0]] - p1[props[0]],\n        y = p2[props[1]] - p1[props[1]];\n\n    return Math.sqrt((x * x) + (y * y));\n}\n\n/**\n * calculate the angle between two coordinates\n * @param {Object} p1\n * @param {Object} p2\n * @param {Array} [props] containing x and y keys\n * @return {Number} angle\n */\nfunction getAngle(p1, p2, props) {\n    if (!props) {\n        props = PROPS_XY;\n    }\n    var x = p2[props[0]] - p1[props[0]],\n        y = p2[props[1]] - p1[props[1]];\n    return Math.atan2(y, x) * 180 / Math.PI;\n}\n\n/**\n * calculate the rotation degrees between two pointersets\n * @param {Array} start array of pointers\n * @param {Array} end array of pointers\n * @return {Number} rotation\n */\nfunction getRotation(start, end) {\n    return getAngle(end[1], end[0], PROPS_CLIENT_XY) + getAngle(start[1], start[0], PROPS_CLIENT_XY);\n}\n\n/**\n * calculate the scale factor between two pointersets\n * no scale is 1, and goes down to 0 when pinched together, and bigger when pinched out\n * @param {Array} start array of pointers\n * @param {Array} end array of pointers\n * @return {Number} scale\n */\nfunction getScale(start, end) {\n    return getDistance(end[0], end[1], PROPS_CLIENT_XY) / getDistance(start[0], start[1], PROPS_CLIENT_XY);\n}\n\nvar MOUSE_INPUT_MAP = {\n    mousedown: INPUT_START,\n    mousemove: INPUT_MOVE,\n    mouseup: INPUT_END\n};\n\nvar MOUSE_ELEMENT_EVENTS = 'mousedown';\nvar MOUSE_WINDOW_EVENTS = 'mousemove mouseup';\n\n/**\n * Mouse events input\n * @constructor\n * @extends Input\n */\nfunction MouseInput() {\n    this.evEl = MOUSE_ELEMENT_EVENTS;\n    this.evWin = MOUSE_WINDOW_EVENTS;\n\n    this.pressed = false; // mousedown state\n\n    Input.apply(this, arguments);\n}\n\ninherit(MouseInput, Input, {\n    /**\n     * handle mouse events\n     * @param {Object} ev\n     */\n    handler: function MEhandler(ev) {\n        var eventType = MOUSE_INPUT_MAP[ev.type];\n\n        // on start we want to have the left mouse button down\n        if (eventType & INPUT_START && ev.button === 0) {\n            this.pressed = true;\n        }\n\n        if (eventType & INPUT_MOVE && ev.which !== 1) {\n            eventType = INPUT_END;\n        }\n\n        // mouse must be down\n        if (!this.pressed) {\n            return;\n        }\n\n        if (eventType & INPUT_END) {\n            this.pressed = false;\n        }\n\n        this.callback(this.manager, eventType, {\n            pointers: [ev],\n            changedPointers: [ev],\n            pointerType: INPUT_TYPE_MOUSE,\n            srcEvent: ev\n        });\n    }\n});\n\nvar POINTER_INPUT_MAP = {\n    pointerdown: INPUT_START,\n    pointermove: INPUT_MOVE,\n    pointerup: INPUT_END,\n    pointercancel: INPUT_CANCEL,\n    pointerout: INPUT_CANCEL\n};\n\n// in IE10 the pointer types is defined as an enum\nvar IE10_POINTER_TYPE_ENUM = {\n    2: INPUT_TYPE_TOUCH,\n    3: INPUT_TYPE_PEN,\n    4: INPUT_TYPE_MOUSE,\n    5: INPUT_TYPE_KINECT // see https://twitter.com/jacobrossi/status/480596438489890816\n};\n\nvar POINTER_ELEMENT_EVENTS = 'pointerdown';\nvar POINTER_WINDOW_EVENTS = 'pointermove pointerup pointercancel';\n\n// IE10 has prefixed support, and case-sensitive\nif (window.MSPointerEvent && !window.PointerEvent) {\n    POINTER_ELEMENT_EVENTS = 'MSPointerDown';\n    POINTER_WINDOW_EVENTS = 'MSPointerMove MSPointerUp MSPointerCancel';\n}\n\n/**\n * Pointer events input\n * @constructor\n * @extends Input\n */\nfunction PointerEventInput() {\n    this.evEl = POINTER_ELEMENT_EVENTS;\n    this.evWin = POINTER_WINDOW_EVENTS;\n\n    Input.apply(this, arguments);\n\n    this.store = (this.manager.session.pointerEvents = []);\n}\n\ninherit(PointerEventInput, Input, {\n    /**\n     * handle mouse events\n     * @param {Object} ev\n     */\n    handler: function PEhandler(ev) {\n        var store = this.store;\n        var removePointer = false;\n\n        var eventTypeNormalized = ev.type.toLowerCase().replace('ms', '');\n        var eventType = POINTER_INPUT_MAP[eventTypeNormalized];\n        var pointerType = IE10_POINTER_TYPE_ENUM[ev.pointerType] || ev.pointerType;\n\n        var isTouch = (pointerType == INPUT_TYPE_TOUCH);\n\n        // get index of the event in the store\n        var storeIndex = inArray(store, ev.pointerId, 'pointerId');\n\n        // start and mouse must be down\n        if (eventType & INPUT_START && (ev.button === 0 || isTouch)) {\n            if (storeIndex < 0) {\n                store.push(ev);\n                storeIndex = store.length - 1;\n            }\n        } else if (eventType & (INPUT_END | INPUT_CANCEL)) {\n            removePointer = true;\n        }\n\n        // it not found, so the pointer hasn't been down (so it's probably a hover)\n        if (storeIndex < 0) {\n            return;\n        }\n\n        // update the event in the store\n        store[storeIndex] = ev;\n\n        this.callback(this.manager, eventType, {\n            pointers: store,\n            changedPointers: [ev],\n            pointerType: pointerType,\n            srcEvent: ev\n        });\n\n        if (removePointer) {\n            // remove from the store\n            store.splice(storeIndex, 1);\n        }\n    }\n});\n\nvar SINGLE_TOUCH_INPUT_MAP = {\n    touchstart: INPUT_START,\n    touchmove: INPUT_MOVE,\n    touchend: INPUT_END,\n    touchcancel: INPUT_CANCEL\n};\n\nvar SINGLE_TOUCH_TARGET_EVENTS = 'touchstart';\nvar SINGLE_TOUCH_WINDOW_EVENTS = 'touchstart touchmove touchend touchcancel';\n\n/**\n * Touch events input\n * @constructor\n * @extends Input\n */\nfunction SingleTouchInput() {\n    this.evTarget = SINGLE_TOUCH_TARGET_EVENTS;\n    this.evWin = SINGLE_TOUCH_WINDOW_EVENTS;\n    this.started = false;\n\n    Input.apply(this, arguments);\n}\n\ninherit(SingleTouchInput, Input, {\n    handler: function TEhandler(ev) {\n        var type = SINGLE_TOUCH_INPUT_MAP[ev.type];\n\n        // should we handle the touch events?\n        if (type === INPUT_START) {\n            this.started = true;\n        }\n\n        if (!this.started) {\n            return;\n        }\n\n        var touches = normalizeSingleTouches.call(this, ev, type);\n\n        // when done, reset the started state\n        if (type & (INPUT_END | INPUT_CANCEL) && touches[0].length - touches[1].length === 0) {\n            this.started = false;\n        }\n\n        this.callback(this.manager, type, {\n            pointers: touches[0],\n            changedPointers: touches[1],\n            pointerType: INPUT_TYPE_TOUCH,\n            srcEvent: ev\n        });\n    }\n});\n\n/**\n * @this {TouchInput}\n * @param {Object} ev\n * @param {Number} type flag\n * @returns {undefined|Array} [all, changed]\n */\nfunction normalizeSingleTouches(ev, type) {\n    var all = toArray(ev.touches);\n    var changed = toArray(ev.changedTouches);\n\n    if (type & (INPUT_END | INPUT_CANCEL)) {\n        all = uniqueArray(all.concat(changed), 'identifier', true);\n    }\n\n    return [all, changed];\n}\n\nvar TOUCH_INPUT_MAP = {\n    touchstart: INPUT_START,\n    touchmove: INPUT_MOVE,\n    touchend: INPUT_END,\n    touchcancel: INPUT_CANCEL\n};\n\nvar TOUCH_TARGET_EVENTS = 'touchstart touchmove touchend touchcancel';\n\n/**\n * Multi-user touch events input\n * @constructor\n * @extends Input\n */\nfunction TouchInput() {\n    this.evTarget = TOUCH_TARGET_EVENTS;\n    this.targetIds = {};\n\n    Input.apply(this, arguments);\n}\n\ninherit(TouchInput, Input, {\n    handler: function MTEhandler(ev) {\n        var type = TOUCH_INPUT_MAP[ev.type];\n        var touches = getTouches.call(this, ev, type);\n        if (!touches) {\n            return;\n        }\n\n        this.callback(this.manager, type, {\n            pointers: touches[0],\n            changedPointers: touches[1],\n            pointerType: INPUT_TYPE_TOUCH,\n            srcEvent: ev\n        });\n    }\n});\n\n/**\n * @this {TouchInput}\n * @param {Object} ev\n * @param {Number} type flag\n * @returns {undefined|Array} [all, changed]\n */\nfunction getTouches(ev, type) {\n    var allTouches = toArray(ev.touches);\n    var targetIds = this.targetIds;\n\n    // when there is only one touch, the process can be simplified\n    if (type & (INPUT_START | INPUT_MOVE) && allTouches.length === 1) {\n        targetIds[allTouches[0].identifier] = true;\n        return [allTouches, allTouches];\n    }\n\n    var i,\n        targetTouches,\n        changedTouches = toArray(ev.changedTouches),\n        changedTargetTouches = [],\n        target = this.target;\n\n    // get target touches from touches\n    targetTouches = allTouches.filter(function(touch) {\n        return hasParent(touch.target, target);\n    });\n\n    // collect touches\n    if (type === INPUT_START) {\n        i = 0;\n        while (i < targetTouches.length) {\n            targetIds[targetTouches[i].identifier] = true;\n            i++;\n        }\n    }\n\n    // filter changed touches to only contain touches that exist in the collected target ids\n    i = 0;\n    while (i < changedTouches.length) {\n        if (targetIds[changedTouches[i].identifier]) {\n            changedTargetTouches.push(changedTouches[i]);\n        }\n\n        // cleanup removed touches\n        if (type & (INPUT_END | INPUT_CANCEL)) {\n            delete targetIds[changedTouches[i].identifier];\n        }\n        i++;\n    }\n\n    if (!changedTargetTouches.length) {\n        return;\n    }\n\n    return [\n        // merge targetTouches with changedTargetTouches so it contains ALL touches, including 'end' and 'cancel'\n        uniqueArray(targetTouches.concat(changedTargetTouches), 'identifier', true),\n        changedTargetTouches\n    ];\n}\n\n/**\n * Combined touch and mouse input\n *\n * Touch has a higher priority then mouse, and while touching no mouse events are allowed.\n * This because touch devices also emit mouse events while doing a touch.\n *\n * @constructor\n * @extends Input\n */\n\nvar DEDUP_TIMEOUT = 2500;\nvar DEDUP_DISTANCE = 25;\n\nfunction TouchMouseInput() {\n    Input.apply(this, arguments);\n\n    var handler = bindFn(this.handler, this);\n    this.touch = new TouchInput(this.manager, handler);\n    this.mouse = new MouseInput(this.manager, handler);\n\n    this.primaryTouch = null;\n    this.lastTouches = [];\n}\n\ninherit(TouchMouseInput, Input, {\n    /**\n     * handle mouse and touch events\n     * @param {Hammer} manager\n     * @param {String} inputEvent\n     * @param {Object} inputData\n     */\n    handler: function TMEhandler(manager, inputEvent, inputData) {\n        var isTouch = (inputData.pointerType == INPUT_TYPE_TOUCH),\n            isMouse = (inputData.pointerType == INPUT_TYPE_MOUSE);\n\n        if (isMouse && inputData.sourceCapabilities && inputData.sourceCapabilities.firesTouchEvents) {\n            return;\n        }\n\n        // when we're in a touch event, record touches to  de-dupe synthetic mouse event\n        if (isTouch) {\n            recordTouches.call(this, inputEvent, inputData);\n        } else if (isMouse && isSyntheticEvent.call(this, inputData)) {\n            return;\n        }\n\n        this.callback(manager, inputEvent, inputData);\n    },\n\n    /**\n     * remove the event listeners\n     */\n    destroy: function destroy() {\n        this.touch.destroy();\n        this.mouse.destroy();\n    }\n});\n\nfunction recordTouches(eventType, eventData) {\n    if (eventType & INPUT_START) {\n        this.primaryTouch = eventData.changedPointers[0].identifier;\n        setLastTouch.call(this, eventData);\n    } else if (eventType & (INPUT_END | INPUT_CANCEL)) {\n        setLastTouch.call(this, eventData);\n    }\n}\n\nfunction setLastTouch(eventData) {\n    var touch = eventData.changedPointers[0];\n\n    if (touch.identifier === this.primaryTouch) {\n        var lastTouch = {x: touch.clientX, y: touch.clientY};\n        this.lastTouches.push(lastTouch);\n        var lts = this.lastTouches;\n        var removeLastTouch = function() {\n            var i = lts.indexOf(lastTouch);\n            if (i > -1) {\n                lts.splice(i, 1);\n            }\n        };\n        setTimeout(removeLastTouch, DEDUP_TIMEOUT);\n    }\n}\n\nfunction isSyntheticEvent(eventData) {\n    var x = eventData.srcEvent.clientX, y = eventData.srcEvent.clientY;\n    for (var i = 0; i < this.lastTouches.length; i++) {\n        var t = this.lastTouches[i];\n        var dx = Math.abs(x - t.x), dy = Math.abs(y - t.y);\n        if (dx <= DEDUP_DISTANCE && dy <= DEDUP_DISTANCE) {\n            return true;\n        }\n    }\n    return false;\n}\n\nvar PREFIXED_TOUCH_ACTION = prefixed(TEST_ELEMENT.style, 'touchAction');\nvar NATIVE_TOUCH_ACTION = PREFIXED_TOUCH_ACTION !== undefined;\n\n// magical touchAction value\nvar TOUCH_ACTION_COMPUTE = 'compute';\nvar TOUCH_ACTION_AUTO = 'auto';\nvar TOUCH_ACTION_MANIPULATION = 'manipulation'; // not implemented\nvar TOUCH_ACTION_NONE = 'none';\nvar TOUCH_ACTION_PAN_X = 'pan-x';\nvar TOUCH_ACTION_PAN_Y = 'pan-y';\nvar TOUCH_ACTION_MAP = getTouchActionProps();\n\n/**\n * Touch Action\n * sets the touchAction property or uses the js alternative\n * @param {Manager} manager\n * @param {String} value\n * @constructor\n */\nfunction TouchAction(manager, value) {\n    this.manager = manager;\n    this.set(value);\n}\n\nTouchAction.prototype = {\n    /**\n     * set the touchAction value on the element or enable the polyfill\n     * @param {String} value\n     */\n    set: function(value) {\n        // find out the touch-action by the event handlers\n        if (value == TOUCH_ACTION_COMPUTE) {\n            value = this.compute();\n        }\n\n        if (NATIVE_TOUCH_ACTION && this.manager.element.style && TOUCH_ACTION_MAP[value]) {\n            this.manager.element.style[PREFIXED_TOUCH_ACTION] = value;\n        }\n        this.actions = value.toLowerCase().trim();\n    },\n\n    /**\n     * just re-set the touchAction value\n     */\n    update: function() {\n        this.set(this.manager.options.touchAction);\n    },\n\n    /**\n     * compute the value for the touchAction property based on the recognizer's settings\n     * @returns {String} value\n     */\n    compute: function() {\n        var actions = [];\n        each(this.manager.recognizers, function(recognizer) {\n            if (boolOrFn(recognizer.options.enable, [recognizer])) {\n                actions = actions.concat(recognizer.getTouchAction());\n            }\n        });\n        return cleanTouchActions(actions.join(' '));\n    },\n\n    /**\n     * this method is called on each input cycle and provides the preventing of the browser behavior\n     * @param {Object} input\n     */\n    preventDefaults: function(input) {\n        var srcEvent = input.srcEvent;\n        var direction = input.offsetDirection;\n\n        // if the touch action did prevented once this session\n        if (this.manager.session.prevented) {\n            srcEvent.preventDefault();\n            return;\n        }\n\n        var actions = this.actions;\n        var hasNone = inStr(actions, TOUCH_ACTION_NONE) && !TOUCH_ACTION_MAP[TOUCH_ACTION_NONE];\n        var hasPanY = inStr(actions, TOUCH_ACTION_PAN_Y) && !TOUCH_ACTION_MAP[TOUCH_ACTION_PAN_Y];\n        var hasPanX = inStr(actions, TOUCH_ACTION_PAN_X) && !TOUCH_ACTION_MAP[TOUCH_ACTION_PAN_X];\n\n        if (hasNone) {\n            //do not prevent defaults if this is a tap gesture\n\n            var isTapPointer = input.pointers.length === 1;\n            var isTapMovement = input.distance < 2;\n            var isTapTouchTime = input.deltaTime < 250;\n\n            if (isTapPointer && isTapMovement && isTapTouchTime) {\n                return;\n            }\n        }\n\n        if (hasPanX && hasPanY) {\n            // `pan-x pan-y` means browser handles all scrolling/panning, do not prevent\n            return;\n        }\n\n        if (hasNone ||\n            (hasPanY && direction & DIRECTION_HORIZONTAL) ||\n            (hasPanX && direction & DIRECTION_VERTICAL)) {\n            return this.preventSrc(srcEvent);\n        }\n    },\n\n    /**\n     * call preventDefault to prevent the browser's default behavior (scrolling in most cases)\n     * @param {Object} srcEvent\n     */\n    preventSrc: function(srcEvent) {\n        this.manager.session.prevented = true;\n        srcEvent.preventDefault();\n    }\n};\n\n/**\n * when the touchActions are collected they are not a valid value, so we need to clean things up. *\n * @param {String} actions\n * @returns {*}\n */\nfunction cleanTouchActions(actions) {\n    // none\n    if (inStr(actions, TOUCH_ACTION_NONE)) {\n        return TOUCH_ACTION_NONE;\n    }\n\n    var hasPanX = inStr(actions, TOUCH_ACTION_PAN_X);\n    var hasPanY = inStr(actions, TOUCH_ACTION_PAN_Y);\n\n    // if both pan-x and pan-y are set (different recognizers\n    // for different directions, e.g. horizontal pan but vertical swipe?)\n    // we need none (as otherwise with pan-x pan-y combined none of these\n    // recognizers will work, since the browser would handle all panning\n    if (hasPanX && hasPanY) {\n        return TOUCH_ACTION_NONE;\n    }\n\n    // pan-x OR pan-y\n    if (hasPanX || hasPanY) {\n        return hasPanX ? TOUCH_ACTION_PAN_X : TOUCH_ACTION_PAN_Y;\n    }\n\n    // manipulation\n    if (inStr(actions, TOUCH_ACTION_MANIPULATION)) {\n        return TOUCH_ACTION_MANIPULATION;\n    }\n\n    return TOUCH_ACTION_AUTO;\n}\n\nfunction getTouchActionProps() {\n    if (!NATIVE_TOUCH_ACTION) {\n        return false;\n    }\n    var touchMap = {};\n    var cssSupports = window.CSS && window.CSS.supports;\n    ['auto', 'manipulation', 'pan-y', 'pan-x', 'pan-x pan-y', 'none'].forEach(function(val) {\n\n        // If css.supports is not supported but there is native touch-action assume it supports\n        // all values. This is the case for IE 10 and 11.\n        touchMap[val] = cssSupports ? window.CSS.supports('touch-action', val) : true;\n    });\n    return touchMap;\n}\n\n/**\n * Recognizer flow explained; *\n * All recognizers have the initial state of POSSIBLE when a input session starts.\n * The definition of a input session is from the first input until the last input, with all it's movement in it. *\n * Example session for mouse-input: mousedown -> mousemove -> mouseup\n *\n * On each recognizing cycle (see Manager.recognize) the .recognize() method is executed\n * which determines with state it should be.\n *\n * If the recognizer has the state FAILED, CANCELLED or RECOGNIZED (equals ENDED), it is reset to\n * POSSIBLE to give it another change on the next cycle.\n *\n *               Possible\n *                  |\n *            +-----+---------------+\n *            |                     |\n *      +-----+-----+               |\n *      |           |               |\n *   Failed      Cancelled          |\n *                          +-------+------+\n *                          |              |\n *                      Recognized       Began\n *                                         |\n *                                      Changed\n *                                         |\n *                                  Ended/Recognized\n */\nvar STATE_POSSIBLE = 1;\nvar STATE_BEGAN = 2;\nvar STATE_CHANGED = 4;\nvar STATE_ENDED = 8;\nvar STATE_RECOGNIZED = STATE_ENDED;\nvar STATE_CANCELLED = 16;\nvar STATE_FAILED = 32;\n\n/**\n * Recognizer\n * Every recognizer needs to extend from this class.\n * @constructor\n * @param {Object} options\n */\nfunction Recognizer(options) {\n    this.options = assign({}, this.defaults, options || {});\n\n    this.id = uniqueId();\n\n    this.manager = null;\n\n    // default is enable true\n    this.options.enable = ifUndefined(this.options.enable, true);\n\n    this.state = STATE_POSSIBLE;\n\n    this.simultaneous = {};\n    this.requireFail = [];\n}\n\nRecognizer.prototype = {\n    /**\n     * @virtual\n     * @type {Object}\n     */\n    defaults: {},\n\n    /**\n     * set options\n     * @param {Object} options\n     * @return {Recognizer}\n     */\n    set: function(options) {\n        assign(this.options, options);\n\n        // also update the touchAction, in case something changed about the directions/enabled state\n        this.manager && this.manager.touchAction.update();\n        return this;\n    },\n\n    /**\n     * recognize simultaneous with an other recognizer.\n     * @param {Recognizer} otherRecognizer\n     * @returns {Recognizer} this\n     */\n    recognizeWith: function(otherRecognizer) {\n        if (invokeArrayArg(otherRecognizer, 'recognizeWith', this)) {\n            return this;\n        }\n\n        var simultaneous = this.simultaneous;\n        otherRecognizer = getRecognizerByNameIfManager(otherRecognizer, this);\n        if (!simultaneous[otherRecognizer.id]) {\n            simultaneous[otherRecognizer.id] = otherRecognizer;\n            otherRecognizer.recognizeWith(this);\n        }\n        return this;\n    },\n\n    /**\n     * drop the simultaneous link. it doesnt remove the link on the other recognizer.\n     * @param {Recognizer} otherRecognizer\n     * @returns {Recognizer} this\n     */\n    dropRecognizeWith: function(otherRecognizer) {\n        if (invokeArrayArg(otherRecognizer, 'dropRecognizeWith', this)) {\n            return this;\n        }\n\n        otherRecognizer = getRecognizerByNameIfManager(otherRecognizer, this);\n        delete this.simultaneous[otherRecognizer.id];\n        return this;\n    },\n\n    /**\n     * recognizer can only run when an other is failing\n     * @param {Recognizer} otherRecognizer\n     * @returns {Recognizer} this\n     */\n    requireFailure: function(otherRecognizer) {\n        if (invokeArrayArg(otherRecognizer, 'requireFailure', this)) {\n            return this;\n        }\n\n        var requireFail = this.requireFail;\n        otherRecognizer = getRecognizerByNameIfManager(otherRecognizer, this);\n        if (inArray(requireFail, otherRecognizer) === -1) {\n            requireFail.push(otherRecognizer);\n            otherRecognizer.requireFailure(this);\n        }\n        return this;\n    },\n\n    /**\n     * drop the requireFailure link. it does not remove the link on the other recognizer.\n     * @param {Recognizer} otherRecognizer\n     * @returns {Recognizer} this\n     */\n    dropRequireFailure: function(otherRecognizer) {\n        if (invokeArrayArg(otherRecognizer, 'dropRequireFailure', this)) {\n            return this;\n        }\n\n        otherRecognizer = getRecognizerByNameIfManager(otherRecognizer, this);\n        var index = inArray(this.requireFail, otherRecognizer);\n        if (index > -1) {\n            this.requireFail.splice(index, 1);\n        }\n        return this;\n    },\n\n    /**\n     * has require failures boolean\n     * @returns {boolean}\n     */\n    hasRequireFailures: function() {\n        return this.requireFail.length > 0;\n    },\n\n    /**\n     * if the recognizer can recognize simultaneous with an other recognizer\n     * @param {Recognizer} otherRecognizer\n     * @returns {Boolean}\n     */\n    canRecognizeWith: function(otherRecognizer) {\n        return !!this.simultaneous[otherRecognizer.id];\n    },\n\n    /**\n     * You should use `tryEmit` instead of `emit` directly to check\n     * that all the needed recognizers has failed before emitting.\n     * @param {Object} input\n     */\n    emit: function(input) {\n        var self = this;\n        var state = this.state;\n\n        function emit(event) {\n            self.manager.emit(event, input);\n        }\n\n        // 'panstart' and 'panmove'\n        if (state < STATE_ENDED) {\n            emit(self.options.event + stateStr(state));\n        }\n\n        emit(self.options.event); // simple 'eventName' events\n\n        if (input.additionalEvent) { // additional event(panleft, panright, pinchin, pinchout...)\n            emit(input.additionalEvent);\n        }\n\n        // panend and pancancel\n        if (state >= STATE_ENDED) {\n            emit(self.options.event + stateStr(state));\n        }\n    },\n\n    /**\n     * Check that all the require failure recognizers has failed,\n     * if true, it emits a gesture event,\n     * otherwise, setup the state to FAILED.\n     * @param {Object} input\n     */\n    tryEmit: function(input) {\n        if (this.canEmit()) {\n            return this.emit(input);\n        }\n        // it's failing anyway\n        this.state = STATE_FAILED;\n    },\n\n    /**\n     * can we emit?\n     * @returns {boolean}\n     */\n    canEmit: function() {\n        var i = 0;\n        while (i < this.requireFail.length) {\n            if (!(this.requireFail[i].state & (STATE_FAILED | STATE_POSSIBLE))) {\n                return false;\n            }\n            i++;\n        }\n        return true;\n    },\n\n    /**\n     * update the recognizer\n     * @param {Object} inputData\n     */\n    recognize: function(inputData) {\n        // make a new copy of the inputData\n        // so we can change the inputData without messing up the other recognizers\n        var inputDataClone = assign({}, inputData);\n\n        // is is enabled and allow recognizing?\n        if (!boolOrFn(this.options.enable, [this, inputDataClone])) {\n            this.reset();\n            this.state = STATE_FAILED;\n            return;\n        }\n\n        // reset when we've reached the end\n        if (this.state & (STATE_RECOGNIZED | STATE_CANCELLED | STATE_FAILED)) {\n            this.state = STATE_POSSIBLE;\n        }\n\n        this.state = this.process(inputDataClone);\n\n        // the recognizer has recognized a gesture\n        // so trigger an event\n        if (this.state & (STATE_BEGAN | STATE_CHANGED | STATE_ENDED | STATE_CANCELLED)) {\n            this.tryEmit(inputDataClone);\n        }\n    },\n\n    /**\n     * return the state of the recognizer\n     * the actual recognizing happens in this method\n     * @virtual\n     * @param {Object} inputData\n     * @returns {Const} STATE\n     */\n    process: function(inputData) { }, // jshint ignore:line\n\n    /**\n     * return the preferred touch-action\n     * @virtual\n     * @returns {Array}\n     */\n    getTouchAction: function() { },\n\n    /**\n     * called when the gesture isn't allowed to recognize\n     * like when another is being recognized or it is disabled\n     * @virtual\n     */\n    reset: function() { }\n};\n\n/**\n * get a usable string, used as event postfix\n * @param {Const} state\n * @returns {String} state\n */\nfunction stateStr(state) {\n    if (state & STATE_CANCELLED) {\n        return 'cancel';\n    } else if (state & STATE_ENDED) {\n        return 'end';\n    } else if (state & STATE_CHANGED) {\n        return 'move';\n    } else if (state & STATE_BEGAN) {\n        return 'start';\n    }\n    return '';\n}\n\n/**\n * direction cons to string\n * @param {Const} direction\n * @returns {String}\n */\nfunction directionStr(direction) {\n    if (direction == DIRECTION_DOWN) {\n        return 'down';\n    } else if (direction == DIRECTION_UP) {\n        return 'up';\n    } else if (direction == DIRECTION_LEFT) {\n        return 'left';\n    } else if (direction == DIRECTION_RIGHT) {\n        return 'right';\n    }\n    return '';\n}\n\n/**\n * get a recognizer by name if it is bound to a manager\n * @param {Recognizer|String} otherRecognizer\n * @param {Recognizer} recognizer\n * @returns {Recognizer}\n */\nfunction getRecognizerByNameIfManager(otherRecognizer, recognizer) {\n    var manager = recognizer.manager;\n    if (manager) {\n        return manager.get(otherRecognizer);\n    }\n    return otherRecognizer;\n}\n\n/**\n * This recognizer is just used as a base for the simple attribute recognizers.\n * @constructor\n * @extends Recognizer\n */\nfunction AttrRecognizer() {\n    Recognizer.apply(this, arguments);\n}\n\ninherit(AttrRecognizer, Recognizer, {\n    /**\n     * @namespace\n     * @memberof AttrRecognizer\n     */\n    defaults: {\n        /**\n         * @type {Number}\n         * @default 1\n         */\n        pointers: 1\n    },\n\n    /**\n     * Used to check if it the recognizer receives valid input, like input.distance > 10.\n     * @memberof AttrRecognizer\n     * @param {Object} input\n     * @returns {Boolean} recognized\n     */\n    attrTest: function(input) {\n        var optionPointers = this.options.pointers;\n        return optionPointers === 0 || input.pointers.length === optionPointers;\n    },\n\n    /**\n     * Process the input and return the state for the recognizer\n     * @memberof AttrRecognizer\n     * @param {Object} input\n     * @returns {*} State\n     */\n    process: function(input) {\n        var state = this.state;\n        var eventType = input.eventType;\n\n        var isRecognized = state & (STATE_BEGAN | STATE_CHANGED);\n        var isValid = this.attrTest(input);\n\n        // on cancel input and we've recognized before, return STATE_CANCELLED\n        if (isRecognized && (eventType & INPUT_CANCEL || !isValid)) {\n            return state | STATE_CANCELLED;\n        } else if (isRecognized || isValid) {\n            if (eventType & INPUT_END) {\n                return state | STATE_ENDED;\n            } else if (!(state & STATE_BEGAN)) {\n                return STATE_BEGAN;\n            }\n            return state | STATE_CHANGED;\n        }\n        return STATE_FAILED;\n    }\n});\n\n/**\n * Pan\n * Recognized when the pointer is down and moved in the allowed direction.\n * @constructor\n * @extends AttrRecognizer\n */\nfunction PanRecognizer() {\n    AttrRecognizer.apply(this, arguments);\n\n    this.pX = null;\n    this.pY = null;\n}\n\ninherit(PanRecognizer, AttrRecognizer, {\n    /**\n     * @namespace\n     * @memberof PanRecognizer\n     */\n    defaults: {\n        event: 'pan',\n        threshold: 10,\n        pointers: 1,\n        direction: DIRECTION_ALL\n    },\n\n    getTouchAction: function() {\n        var direction = this.options.direction;\n        var actions = [];\n        if (direction & DIRECTION_HORIZONTAL) {\n            actions.push(TOUCH_ACTION_PAN_Y);\n        }\n        if (direction & DIRECTION_VERTICAL) {\n            actions.push(TOUCH_ACTION_PAN_X);\n        }\n        return actions;\n    },\n\n    directionTest: function(input) {\n        var options = this.options;\n        var hasMoved = true;\n        var distance = input.distance;\n        var direction = input.direction;\n        var x = input.deltaX;\n        var y = input.deltaY;\n\n        // lock to axis?\n        if (!(direction & options.direction)) {\n            if (options.direction & DIRECTION_HORIZONTAL) {\n                direction = (x === 0) ? DIRECTION_NONE : (x < 0) ? DIRECTION_LEFT : DIRECTION_RIGHT;\n                hasMoved = x != this.pX;\n                distance = Math.abs(input.deltaX);\n            } else {\n                direction = (y === 0) ? DIRECTION_NONE : (y < 0) ? DIRECTION_UP : DIRECTION_DOWN;\n                hasMoved = y != this.pY;\n                distance = Math.abs(input.deltaY);\n            }\n        }\n        input.direction = direction;\n        return hasMoved && distance > options.threshold && direction & options.direction;\n    },\n\n    attrTest: function(input) {\n        return AttrRecognizer.prototype.attrTest.call(this, input) &&\n            (this.state & STATE_BEGAN || (!(this.state & STATE_BEGAN) && this.directionTest(input)));\n    },\n\n    emit: function(input) {\n\n        this.pX = input.deltaX;\n        this.pY = input.deltaY;\n\n        var direction = directionStr(input.direction);\n\n        if (direction) {\n            input.additionalEvent = this.options.event + direction;\n        }\n        this._super.emit.call(this, input);\n    }\n});\n\n/**\n * Pinch\n * Recognized when two or more pointers are moving toward (zoom-in) or away from each other (zoom-out).\n * @constructor\n * @extends AttrRecognizer\n */\nfunction PinchRecognizer() {\n    AttrRecognizer.apply(this, arguments);\n}\n\ninherit(PinchRecognizer, AttrRecognizer, {\n    /**\n     * @namespace\n     * @memberof PinchRecognizer\n     */\n    defaults: {\n        event: 'pinch',\n        threshold: 0,\n        pointers: 2\n    },\n\n    getTouchAction: function() {\n        return [TOUCH_ACTION_NONE];\n    },\n\n    attrTest: function(input) {\n        return this._super.attrTest.call(this, input) &&\n            (Math.abs(input.scale - 1) > this.options.threshold || this.state & STATE_BEGAN);\n    },\n\n    emit: function(input) {\n        if (input.scale !== 1) {\n            var inOut = input.scale < 1 ? 'in' : 'out';\n            input.additionalEvent = this.options.event + inOut;\n        }\n        this._super.emit.call(this, input);\n    }\n});\n\n/**\n * Press\n * Recognized when the pointer is down for x ms without any movement.\n * @constructor\n * @extends Recognizer\n */\nfunction PressRecognizer() {\n    Recognizer.apply(this, arguments);\n\n    this._timer = null;\n    this._input = null;\n}\n\ninherit(PressRecognizer, Recognizer, {\n    /**\n     * @namespace\n     * @memberof PressRecognizer\n     */\n    defaults: {\n        event: 'press',\n        pointers: 1,\n        time: 251, // minimal time of the pointer to be pressed\n        threshold: 9 // a minimal movement is ok, but keep it low\n    },\n\n    getTouchAction: function() {\n        return [TOUCH_ACTION_AUTO];\n    },\n\n    process: function(input) {\n        var options = this.options;\n        var validPointers = input.pointers.length === options.pointers;\n        var validMovement = input.distance < options.threshold;\n        var validTime = input.deltaTime > options.time;\n\n        this._input = input;\n\n        // we only allow little movement\n        // and we've reached an end event, so a tap is possible\n        if (!validMovement || !validPointers || (input.eventType & (INPUT_END | INPUT_CANCEL) && !validTime)) {\n            this.reset();\n        } else if (input.eventType & INPUT_START) {\n            this.reset();\n            this._timer = setTimeoutContext(function() {\n                this.state = STATE_RECOGNIZED;\n                this.tryEmit();\n            }, options.time, this);\n        } else if (input.eventType & INPUT_END) {\n            return STATE_RECOGNIZED;\n        }\n        return STATE_FAILED;\n    },\n\n    reset: function() {\n        clearTimeout(this._timer);\n    },\n\n    emit: function(input) {\n        if (this.state !== STATE_RECOGNIZED) {\n            return;\n        }\n\n        if (input && (input.eventType & INPUT_END)) {\n            this.manager.emit(this.options.event + 'up', input);\n        } else {\n            this._input.timeStamp = now();\n            this.manager.emit(this.options.event, this._input);\n        }\n    }\n});\n\n/**\n * Rotate\n * Recognized when two or more pointer are moving in a circular motion.\n * @constructor\n * @extends AttrRecognizer\n */\nfunction RotateRecognizer() {\n    AttrRecognizer.apply(this, arguments);\n}\n\ninherit(RotateRecognizer, AttrRecognizer, {\n    /**\n     * @namespace\n     * @memberof RotateRecognizer\n     */\n    defaults: {\n        event: 'rotate',\n        threshold: 0,\n        pointers: 2\n    },\n\n    getTouchAction: function() {\n        return [TOUCH_ACTION_NONE];\n    },\n\n    attrTest: function(input) {\n        return this._super.attrTest.call(this, input) &&\n            (Math.abs(input.rotation) > this.options.threshold || this.state & STATE_BEGAN);\n    }\n});\n\n/**\n * Swipe\n * Recognized when the pointer is moving fast (velocity), with enough distance in the allowed direction.\n * @constructor\n * @extends AttrRecognizer\n */\nfunction SwipeRecognizer() {\n    AttrRecognizer.apply(this, arguments);\n}\n\ninherit(SwipeRecognizer, AttrRecognizer, {\n    /**\n     * @namespace\n     * @memberof SwipeRecognizer\n     */\n    defaults: {\n        event: 'swipe',\n        threshold: 10,\n        velocity: 0.3,\n        direction: DIRECTION_HORIZONTAL | DIRECTION_VERTICAL,\n        pointers: 1\n    },\n\n    getTouchAction: function() {\n        return PanRecognizer.prototype.getTouchAction.call(this);\n    },\n\n    attrTest: function(input) {\n        var direction = this.options.direction;\n        var velocity;\n\n        if (direction & (DIRECTION_HORIZONTAL | DIRECTION_VERTICAL)) {\n            velocity = input.overallVelocity;\n        } else if (direction & DIRECTION_HORIZONTAL) {\n            velocity = input.overallVelocityX;\n        } else if (direction & DIRECTION_VERTICAL) {\n            velocity = input.overallVelocityY;\n        }\n\n        return this._super.attrTest.call(this, input) &&\n            direction & input.offsetDirection &&\n            input.distance > this.options.threshold &&\n            input.maxPointers == this.options.pointers &&\n            abs(velocity) > this.options.velocity && input.eventType & INPUT_END;\n    },\n\n    emit: function(input) {\n        var direction = directionStr(input.offsetDirection);\n        if (direction) {\n            this.manager.emit(this.options.event + direction, input);\n        }\n\n        this.manager.emit(this.options.event, input);\n    }\n});\n\n/**\n * A tap is ecognized when the pointer is doing a small tap/click. Multiple taps are recognized if they occur\n * between the given interval and position. The delay option can be used to recognize multi-taps without firing\n * a single tap.\n *\n * The eventData from the emitted event contains the property `tapCount`, which contains the amount of\n * multi-taps being recognized.\n * @constructor\n * @extends Recognizer\n */\nfunction TapRecognizer() {\n    Recognizer.apply(this, arguments);\n\n    // previous time and center,\n    // used for tap counting\n    this.pTime = false;\n    this.pCenter = false;\n\n    this._timer = null;\n    this._input = null;\n    this.count = 0;\n}\n\ninherit(TapRecognizer, Recognizer, {\n    /**\n     * @namespace\n     * @memberof PinchRecognizer\n     */\n    defaults: {\n        event: 'tap',\n        pointers: 1,\n        taps: 1,\n        interval: 300, // max time between the multi-tap taps\n        time: 250, // max time of the pointer to be down (like finger on the screen)\n        threshold: 9, // a minimal movement is ok, but keep it low\n        posThreshold: 10 // a multi-tap can be a bit off the initial position\n    },\n\n    getTouchAction: function() {\n        return [TOUCH_ACTION_MANIPULATION];\n    },\n\n    process: function(input) {\n        var options = this.options;\n\n        var validPointers = input.pointers.length === options.pointers;\n        var validMovement = input.distance < options.threshold;\n        var validTouchTime = input.deltaTime < options.time;\n\n        this.reset();\n\n        if ((input.eventType & INPUT_START) && (this.count === 0)) {\n            return this.failTimeout();\n        }\n\n        // we only allow little movement\n        // and we've reached an end event, so a tap is possible\n        if (validMovement && validTouchTime && validPointers) {\n            if (input.eventType != INPUT_END) {\n                return this.failTimeout();\n            }\n\n            var validInterval = this.pTime ? (input.timeStamp - this.pTime < options.interval) : true;\n            var validMultiTap = !this.pCenter || getDistance(this.pCenter, input.center) < options.posThreshold;\n\n            this.pTime = input.timeStamp;\n            this.pCenter = input.center;\n\n            if (!validMultiTap || !validInterval) {\n                this.count = 1;\n            } else {\n                this.count += 1;\n            }\n\n            this._input = input;\n\n            // if tap count matches we have recognized it,\n            // else it has began recognizing...\n            var tapCount = this.count % options.taps;\n            if (tapCount === 0) {\n                // no failing requirements, immediately trigger the tap event\n                // or wait as long as the multitap interval to trigger\n                if (!this.hasRequireFailures()) {\n                    return STATE_RECOGNIZED;\n                } else {\n                    this._timer = setTimeoutContext(function() {\n                        this.state = STATE_RECOGNIZED;\n                        this.tryEmit();\n                    }, options.interval, this);\n                    return STATE_BEGAN;\n                }\n            }\n        }\n        return STATE_FAILED;\n    },\n\n    failTimeout: function() {\n        this._timer = setTimeoutContext(function() {\n            this.state = STATE_FAILED;\n        }, this.options.interval, this);\n        return STATE_FAILED;\n    },\n\n    reset: function() {\n        clearTimeout(this._timer);\n    },\n\n    emit: function() {\n        if (this.state == STATE_RECOGNIZED) {\n            this._input.tapCount = this.count;\n            this.manager.emit(this.options.event, this._input);\n        }\n    }\n});\n\n/**\n * Simple way to create a manager with a default set of recognizers.\n * @param {HTMLElement} element\n * @param {Object} [options]\n * @constructor\n */\nfunction Hammer(element, options) {\n    options = options || {};\n    options.recognizers = ifUndefined(options.recognizers, Hammer.defaults.preset);\n    return new Manager(element, options);\n}\n\n/**\n * @const {string}\n */\nHammer.VERSION = '2.0.7';\n\n/**\n * default settings\n * @namespace\n */\nHammer.defaults = {\n    /**\n     * set if DOM events are being triggered.\n     * But this is slower and unused by simple implementations, so disabled by default.\n     * @type {Boolean}\n     * @default false\n     */\n    domEvents: false,\n\n    /**\n     * The value for the touchAction property/fallback.\n     * When set to `compute` it will magically set the correct value based on the added recognizers.\n     * @type {String}\n     * @default compute\n     */\n    touchAction: TOUCH_ACTION_COMPUTE,\n\n    /**\n     * @type {Boolean}\n     * @default true\n     */\n    enable: true,\n\n    /**\n     * EXPERIMENTAL FEATURE -- can be removed/changed\n     * Change the parent input target element.\n     * If Null, then it is being set the to main element.\n     * @type {Null|EventTarget}\n     * @default null\n     */\n    inputTarget: null,\n\n    /**\n     * force an input class\n     * @type {Null|Function}\n     * @default null\n     */\n    inputClass: null,\n\n    /**\n     * Default recognizer setup when calling `Hammer()`\n     * When creating a new Manager these will be skipped.\n     * @type {Array}\n     */\n    preset: [\n        // RecognizerClass, options, [recognizeWith, ...], [requireFailure, ...]\n        [RotateRecognizer, {enable: false}],\n        [PinchRecognizer, {enable: false}, ['rotate']],\n        [SwipeRecognizer, {direction: DIRECTION_HORIZONTAL}],\n        [PanRecognizer, {direction: DIRECTION_HORIZONTAL}, ['swipe']],\n        [TapRecognizer],\n        [TapRecognizer, {event: 'doubletap', taps: 2}, ['tap']],\n        [PressRecognizer]\n    ],\n\n    /**\n     * Some CSS properties can be used to improve the working of Hammer.\n     * Add them to this method and they will be set when creating a new Manager.\n     * @namespace\n     */\n    cssProps: {\n        /**\n         * Disables text selection to improve the dragging gesture. Mainly for desktop browsers.\n         * @type {String}\n         * @default 'none'\n         */\n        userSelect: 'none',\n\n        /**\n         * Disable the Windows Phone grippers when pressing an element.\n         * @type {String}\n         * @default 'none'\n         */\n        touchSelect: 'none',\n\n        /**\n         * Disables the default callout shown when you touch and hold a touch target.\n         * On iOS, when you touch and hold a touch target such as a link, Safari displays\n         * a callout containing information about the link. This property allows you to disable that callout.\n         * @type {String}\n         * @default 'none'\n         */\n        touchCallout: 'none',\n\n        /**\n         * Specifies whether zooming is enabled. Used by IE10>\n         * @type {String}\n         * @default 'none'\n         */\n        contentZooming: 'none',\n\n        /**\n         * Specifies that an entire element should be draggable instead of its contents. Mainly for desktop browsers.\n         * @type {String}\n         * @default 'none'\n         */\n        userDrag: 'none',\n\n        /**\n         * Overrides the highlight color shown when the user taps a link or a JavaScript\n         * clickable element in iOS. This property obeys the alpha value, if specified.\n         * @type {String}\n         * @default 'rgba(0,0,0,0)'\n         */\n        tapHighlightColor: 'rgba(0,0,0,0)'\n    }\n};\n\nvar STOP = 1;\nvar FORCED_STOP = 2;\n\n/**\n * Manager\n * @param {HTMLElement} element\n * @param {Object} [options]\n * @constructor\n */\nfunction Manager(element, options) {\n    this.options = assign({}, Hammer.defaults, options || {});\n\n    this.options.inputTarget = this.options.inputTarget || element;\n\n    this.handlers = {};\n    this.session = {};\n    this.recognizers = [];\n    this.oldCssProps = {};\n\n    this.element = element;\n    this.input = createInputInstance(this);\n    this.touchAction = new TouchAction(this, this.options.touchAction);\n\n    toggleCssProps(this, true);\n\n    each(this.options.recognizers, function(item) {\n        var recognizer = this.add(new (item[0])(item[1]));\n        item[2] && recognizer.recognizeWith(item[2]);\n        item[3] && recognizer.requireFailure(item[3]);\n    }, this);\n}\n\nManager.prototype = {\n    /**\n     * set options\n     * @param {Object} options\n     * @returns {Manager}\n     */\n    set: function(options) {\n        assign(this.options, options);\n\n        // Options that need a little more setup\n        if (options.touchAction) {\n            this.touchAction.update();\n        }\n        if (options.inputTarget) {\n            // Clean up existing event listeners and reinitialize\n            this.input.destroy();\n            this.input.target = options.inputTarget;\n            this.input.init();\n        }\n        return this;\n    },\n\n    /**\n     * stop recognizing for this session.\n     * This session will be discarded, when a new [input]start event is fired.\n     * When forced, the recognizer cycle is stopped immediately.\n     * @param {Boolean} [force]\n     */\n    stop: function(force) {\n        this.session.stopped = force ? FORCED_STOP : STOP;\n    },\n\n    /**\n     * run the recognizers!\n     * called by the inputHandler function on every movement of the pointers (touches)\n     * it walks through all the recognizers and tries to detect the gesture that is being made\n     * @param {Object} inputData\n     */\n    recognize: function(inputData) {\n        var session = this.session;\n        if (session.stopped) {\n            return;\n        }\n\n        // run the touch-action polyfill\n        this.touchAction.preventDefaults(inputData);\n\n        var recognizer;\n        var recognizers = this.recognizers;\n\n        // this holds the recognizer that is being recognized.\n        // so the recognizer's state needs to be BEGAN, CHANGED, ENDED or RECOGNIZED\n        // if no recognizer is detecting a thing, it is set to `null`\n        var curRecognizer = session.curRecognizer;\n\n        // reset when the last recognizer is recognized\n        // or when we're in a new session\n        if (!curRecognizer || (curRecognizer && curRecognizer.state & STATE_RECOGNIZED)) {\n            curRecognizer = session.curRecognizer = null;\n        }\n\n        var i = 0;\n        while (i < recognizers.length) {\n            recognizer = recognizers[i];\n\n            // find out if we are allowed try to recognize the input for this one.\n            // 1.   allow if the session is NOT forced stopped (see the .stop() method)\n            // 2.   allow if we still haven't recognized a gesture in this session, or the this recognizer is the one\n            //      that is being recognized.\n            // 3.   allow if the recognizer is allowed to run simultaneous with the current recognized recognizer.\n            //      this can be setup with the `recognizeWith()` method on the recognizer.\n            if (session.stopped !== FORCED_STOP && ( // 1\n                    !curRecognizer || recognizer == curRecognizer || // 2\n                    recognizer.canRecognizeWith(curRecognizer))) { // 3\n                recognizer.recognize(inputData);\n            } else {\n                recognizer.reset();\n            }\n\n            // if the recognizer has been recognizing the input as a valid gesture, we want to store this one as the\n            // current active recognizer. but only if we don't already have an active recognizer\n            if (!curRecognizer && recognizer.state & (STATE_BEGAN | STATE_CHANGED | STATE_ENDED)) {\n                curRecognizer = session.curRecognizer = recognizer;\n            }\n            i++;\n        }\n    },\n\n    /**\n     * get a recognizer by its event name.\n     * @param {Recognizer|String} recognizer\n     * @returns {Recognizer|Null}\n     */\n    get: function(recognizer) {\n        if (recognizer instanceof Recognizer) {\n            return recognizer;\n        }\n\n        var recognizers = this.recognizers;\n        for (var i = 0; i < recognizers.length; i++) {\n            if (recognizers[i].options.event == recognizer) {\n                return recognizers[i];\n            }\n        }\n        return null;\n    },\n\n    /**\n     * add a recognizer to the manager\n     * existing recognizers with the same event name will be removed\n     * @param {Recognizer} recognizer\n     * @returns {Recognizer|Manager}\n     */\n    add: function(recognizer) {\n        if (invokeArrayArg(recognizer, 'add', this)) {\n            return this;\n        }\n\n        // remove existing\n        var existing = this.get(recognizer.options.event);\n        if (existing) {\n            this.remove(existing);\n        }\n\n        this.recognizers.push(recognizer);\n        recognizer.manager = this;\n\n        this.touchAction.update();\n        return recognizer;\n    },\n\n    /**\n     * remove a recognizer by name or instance\n     * @param {Recognizer|String} recognizer\n     * @returns {Manager}\n     */\n    remove: function(recognizer) {\n        if (invokeArrayArg(recognizer, 'remove', this)) {\n            return this;\n        }\n\n        recognizer = this.get(recognizer);\n\n        // let's make sure this recognizer exists\n        if (recognizer) {\n            var recognizers = this.recognizers;\n            var index = inArray(recognizers, recognizer);\n\n            if (index !== -1) {\n                recognizers.splice(index, 1);\n                this.touchAction.update();\n            }\n        }\n\n        return this;\n    },\n\n    /**\n     * bind event\n     * @param {String} events\n     * @param {Function} handler\n     * @returns {EventEmitter} this\n     */\n    on: function(events, handler) {\n        if (events === undefined) {\n            return;\n        }\n        if (handler === undefined) {\n            return;\n        }\n\n        var handlers = this.handlers;\n        each(splitStr(events), function(event) {\n            handlers[event] = handlers[event] || [];\n            handlers[event].push(handler);\n        });\n        return this;\n    },\n\n    /**\n     * unbind event, leave emit blank to remove all handlers\n     * @param {String} events\n     * @param {Function} [handler]\n     * @returns {EventEmitter} this\n     */\n    off: function(events, handler) {\n        if (events === undefined) {\n            return;\n        }\n\n        var handlers = this.handlers;\n        each(splitStr(events), function(event) {\n            if (!handler) {\n                delete handlers[event];\n            } else {\n                handlers[event] && handlers[event].splice(inArray(handlers[event], handler), 1);\n            }\n        });\n        return this;\n    },\n\n    /**\n     * emit event to the listeners\n     * @param {String} event\n     * @param {Object} data\n     */\n    emit: function(event, data) {\n        // we also want to trigger dom events\n        if (this.options.domEvents) {\n            triggerDomEvent(event, data);\n        }\n\n        // no handlers, so skip it all\n        var handlers = this.handlers[event] && this.handlers[event].slice();\n        if (!handlers || !handlers.length) {\n            return;\n        }\n\n        data.type = event;\n        data.preventDefault = function() {\n            data.srcEvent.preventDefault();\n        };\n\n        var i = 0;\n        while (i < handlers.length) {\n            handlers[i](data);\n            i++;\n        }\n    },\n\n    /**\n     * destroy the manager and unbinds all events\n     * it doesn't unbind dom events, that is the user own responsibility\n     */\n    destroy: function() {\n        this.element && toggleCssProps(this, false);\n\n        this.handlers = {};\n        this.session = {};\n        this.input.destroy();\n        this.element = null;\n    }\n};\n\n/**\n * add/remove the css properties as defined in manager.options.cssProps\n * @param {Manager} manager\n * @param {Boolean} add\n */\nfunction toggleCssProps(manager, add) {\n    var element = manager.element;\n    if (!element.style) {\n        return;\n    }\n    var prop;\n    each(manager.options.cssProps, function(value, name) {\n        prop = prefixed(element.style, name);\n        if (add) {\n            manager.oldCssProps[prop] = element.style[prop];\n            element.style[prop] = value;\n        } else {\n            element.style[prop] = manager.oldCssProps[prop] || '';\n        }\n    });\n    if (!add) {\n        manager.oldCssProps = {};\n    }\n}\n\n/**\n * trigger dom event\n * @param {String} event\n * @param {Object} data\n */\nfunction triggerDomEvent(event, data) {\n    var gestureEvent = document.createEvent('Event');\n    gestureEvent.initEvent(event, true, true);\n    gestureEvent.gesture = data;\n    data.target.dispatchEvent(gestureEvent);\n}\n\nassign(Hammer, {\n    INPUT_START: INPUT_START,\n    INPUT_MOVE: INPUT_MOVE,\n    INPUT_END: INPUT_END,\n    INPUT_CANCEL: INPUT_CANCEL,\n\n    STATE_POSSIBLE: STATE_POSSIBLE,\n    STATE_BEGAN: STATE_BEGAN,\n    STATE_CHANGED: STATE_CHANGED,\n    STATE_ENDED: STATE_ENDED,\n    STATE_RECOGNIZED: STATE_RECOGNIZED,\n    STATE_CANCELLED: STATE_CANCELLED,\n    STATE_FAILED: STATE_FAILED,\n\n    DIRECTION_NONE: DIRECTION_NONE,\n    DIRECTION_LEFT: DIRECTION_LEFT,\n    DIRECTION_RIGHT: DIRECTION_RIGHT,\n    DIRECTION_UP: DIRECTION_UP,\n    DIRECTION_DOWN: DIRECTION_DOWN,\n    DIRECTION_HORIZONTAL: DIRECTION_HORIZONTAL,\n    DIRECTION_VERTICAL: DIRECTION_VERTICAL,\n    DIRECTION_ALL: DIRECTION_ALL,\n\n    Manager: Manager,\n    Input: Input,\n    TouchAction: TouchAction,\n\n    TouchInput: TouchInput,\n    MouseInput: MouseInput,\n    PointerEventInput: PointerEventInput,\n    TouchMouseInput: TouchMouseInput,\n    SingleTouchInput: SingleTouchInput,\n\n    Recognizer: Recognizer,\n    AttrRecognizer: AttrRecognizer,\n    Tap: TapRecognizer,\n    Pan: PanRecognizer,\n    Swipe: SwipeRecognizer,\n    Pinch: PinchRecognizer,\n    Rotate: RotateRecognizer,\n    Press: PressRecognizer,\n\n    on: addEventListeners,\n    off: removeEventListeners,\n    each: each,\n    merge: merge,\n    extend: extend,\n    assign: assign,\n    inherit: inherit,\n    bindFn: bindFn,\n    prefixed: prefixed\n});\n\n// this prevents errors when Hammer is loaded in the presence of an AMD\n//  style loader but by script tag, not by the loader.\nvar freeGlobal = (typeof window !== 'undefined' ? window : (typeof self !== 'undefined' ? self : {})); // jshint ignore:line\nfreeGlobal.Hammer = Hammer;\n\nif (typeof define === 'function' && define.amd) {\n    define(function() {\n        return Hammer;\n    });\n} else if (typeof module != 'undefined' && module.exports) {\n    module.exports = Hammer;\n} else {\n    window[exportName] = Hammer;\n}\n\n})(window, document, 'Hammer');\n","import { assert } from '../env-utils/assert';\nexport function padToNBytes(byteLength, padding) {\n  assert(byteLength >= 0);\n  assert(padding > 0);\n  return byteLength + (padding - 1) & ~(padding - 1);\n}\nexport function copyArrayBuffer(targetBuffer, sourceBuffer, byteOffset, byteLength = sourceBuffer.byteLength) {\n  const targetArray = new Uint8Array(targetBuffer, byteOffset, byteLength);\n  const sourceArray = new Uint8Array(sourceBuffer);\n  targetArray.set(sourceArray);\n  return targetBuffer;\n}\nexport function copyToArray(source, target, targetOffset) {\n  let sourceArray;\n\n  if (source instanceof ArrayBuffer) {\n    sourceArray = new Uint8Array(source);\n  } else {\n    const srcByteOffset = source.byteOffset;\n    const srcByteLength = source.byteLength;\n    sourceArray = new Uint8Array(source.buffer || source.arrayBuffer, srcByteOffset, srcByteLength);\n  }\n\n  target.set(sourceArray, targetOffset);\n  return targetOffset + padToNBytes(sourceArray.byteLength, 4);\n}\n//# sourceMappingURL=memory-copy-utils.js.map","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n/* eslint-disable max-len */\n\nexport {default as SimpleMeshLayer} from './simple-mesh-layer/simple-mesh-layer';\nexport {default as ScenegraphLayer} from './scenegraph-layer/scenegraph-layer';\n\nexport type {ScenegraphLayerProps} from './scenegraph-layer/scenegraph-layer';\nexport type {SimpleMeshLayerProps} from './simple-mesh-layer/simple-mesh-layer';\n","const DEFAULT_LIGHT_COLOR = [255, 255, 255];\nconst DEFAULT_LIGHT_INTENSITY = 1.0;\n\nlet idCount = 0;\n\nexport type AmbientLightOptions = {\n  id?: string;\n  /** Light color, [r, g, b] in the 0-255 range\n   * @default [255, 255, 255]\n   */\n  color?: number[];\n  /** Light intensity, higher number is brighter\n   * @default 1.0\n   */\n  intensity?: number;\n};\n\nexport class AmbientLight {\n  id: string;\n  color: number[];\n  intensity: number;\n  type = 'ambient';\n\n  constructor(props: AmbientLightOptions = {}) {\n    const {color = DEFAULT_LIGHT_COLOR} = props;\n    const {intensity = DEFAULT_LIGHT_INTENSITY} = props;\n\n    this.id = props.id || `ambient-${idCount++}`;\n    this.color = color;\n    this.intensity = intensity;\n  }\n}\n","import View, {CommonViewState} from './view';\nimport WebMercatorViewport from '../viewports/web-mercator-viewport';\nimport MapController from '../controllers/map-controller';\n\nimport type {NumericArray} from '../types/types';\n\nexport type MapViewState = {\n  /** Longitude of the map center */\n  longitude: number;\n  /** Latitude of the map center */\n  latitude: number;\n  /** Zoom level */\n  zoom: number;\n  /** Pitch (tilt) of the map, in degrees. `0` looks top down */\n  pitch?: number;\n  /** Bearing (rotation) of the map, in degrees. `0` is north up */\n  bearing?: number;\n  /** Min zoom, default `0` */\n  minZoom?: number;\n  /** Max zoom, default `20` */\n  maxZoom?: number;\n  /** Min pitch, default `0` */\n  minPitch?: number;\n  /** Max pitch, default `60` */\n  maxPitch?: number;\n  /** Viewport center offsets from lng, lat in meters */\n  position?: number[];\n} & CommonViewState;\n\ntype MapViewProps = {\n  /** Whether to render multiple copies of the map at low zoom levels. Default `false`. */\n  repeat?: boolean;\n  /** Scaler for the near plane, 1 unit equals to the height of the viewport. Default to `0.1`. Overwrites the `near` parameter. */\n  nearZMultiplier?: boolean;\n  /** Scaler for the far plane, 1 unit equals to the distance from the camera to the top edge of the screen. Default to `1.01`. Overwrites the `far` parameter. */\n  farZMultiplier?: boolean;\n  /** Custom projection matrix */\n  projectionMatrix?: NumericArray;\n  /** Field of view covered by the camera, in the perspective case. In degrees. If not supplied, will be calculated from `altitude`. */\n  fovy?: number;\n  /** Distance of the camera relative to viewport height. Default `1.5`. */\n  altitude?: number;\n  /** Whether to create an orthographic or perspective projection matrix. Default is `false` (perspective projection). */\n  orthographic?: boolean;\n};\n\nexport default class MapView extends View<MapViewState, MapViewProps> {\n  static displayName = 'MapView';\n\n  get ViewportType() {\n    return WebMercatorViewport;\n  }\n\n  get ControllerType() {\n    return MapController;\n  }\n}\n","import Transition, {TransitionSettings as BaseTransitionSettings} from '../transitions/transition';\nimport TransitionInterpolator from '../transitions/transition-interpolator';\nimport type {IViewState} from './view-state';\n\nimport type {Timeline} from '@luma.gl/core';\nimport type {InteractionState} from './controller';\n\nconst noop = () => {};\n\n// Enums cannot be directly exported as they are not transpiled correctly into ES5, see https://github.com/visgl/deck.gl/issues/7130\nexport const TRANSITION_EVENTS = {\n  BREAK: 1,\n  SNAP_TO_END: 2,\n  IGNORE: 3\n} as const;\n\ntype TransitionEvent = 1 | 2 | 3;\n\nexport type TransitionProps = {\n  /** Transition duration in milliseconds, default value 0, implies no transition. When using `FlyToInterpolator`, it can also be set to `'auto'`. */\n  transitionDuration?: number | 'auto';\n  /** An interpolator object that defines the transition behavior between two viewports. */\n  transitionInterpolator?: TransitionInterpolator;\n  /** Easing function that can be used to achieve effects like \"Ease-In-Cubic\", \"Ease-Out-Cubic\", etc. Default value performs Linear easing. */\n  transitionEasing?: (t: number) => number;\n  /** Controls how to process a new view state change that occurs during an existing transition. */\n  transitionInterruption?: TransitionEvent;\n  /** Callback fired when requested transition starts. */\n  onTransitionStart?: (transition: Transition) => void;\n  /** Callback fired when requested transition is interrupted. */\n  onTransitionInterrupt?: (transition: Transition) => void;\n  /** Callback fired when requested transition ends. */\n  onTransitionEnd?: (transition: Transition) => void;\n};\n\nconst DEFAULT_EASING = t => t;\nconst DEFAULT_INTERRUPTION = TRANSITION_EVENTS.BREAK;\n\ntype TransitionSettings = BaseTransitionSettings & {\n  interpolator: TransitionInterpolator;\n  easing: (t: number) => number;\n  interruption: TransitionEvent;\n  startProps: Record<string, any>;\n  endProps: Record<string, any>;\n};\n\nexport default class TransitionManager<ControllerState extends IViewState<ControllerState>> {\n  getControllerState: (props: any) => ControllerState;\n  props?: TransitionProps;\n  propsInTransition: Record<string, any> | null;\n  transition: Transition;\n  onViewStateChange: (params: {\n    viewState: Record<string, any>;\n    oldViewState: Record<string, any>;\n  }) => void;\n  onStateChange: (state: InteractionState) => void;\n\n  constructor(opts: {\n    timeline: Timeline;\n    getControllerState: (props: any) => ControllerState;\n    onViewStateChange?: (params: {\n      viewState: Record<string, any>;\n      oldViewState: Record<string, any>;\n    }) => void;\n    onStateChange?: (state: InteractionState) => void;\n  }) {\n    this.getControllerState = opts.getControllerState;\n    this.propsInTransition = null;\n    this.transition = new Transition(opts.timeline);\n\n    this.onViewStateChange = opts.onViewStateChange || noop;\n    this.onStateChange = opts.onStateChange || noop;\n  }\n\n  finalize(): void {\n    this.transition.cancel();\n  }\n\n  // Returns current transitioned viewport.\n  getViewportInTransition(): Record<string, any> | null {\n    return this.propsInTransition;\n  }\n\n  // Process the vewiport change, either ignore or trigger a new transition.\n  // Return true if a new transition is triggered, false otherwise.\n  processViewStateChange(nextProps: TransitionProps) {\n    let transitionTriggered = false;\n    const currentProps = this.props;\n    // Set this.props here as '_triggerTransition' calls '_updateViewport' that uses this.props.\n    this.props = nextProps;\n\n    // NOTE: Be cautious re-ordering statements in this function.\n    if (!currentProps || this._shouldIgnoreViewportChange(currentProps, nextProps)) {\n      return false;\n    }\n\n    if (this._isTransitionEnabled(nextProps)) {\n      let startProps = currentProps;\n      if (this.transition.inProgress) {\n        const {interruption, endProps} = this.transition.settings as TransitionSettings;\n        startProps = {\n          ...currentProps,\n          ...(interruption === TRANSITION_EVENTS.SNAP_TO_END\n            ? endProps\n            : this.propsInTransition || currentProps)\n        };\n      }\n\n      this._triggerTransition(startProps, nextProps);\n\n      transitionTriggered = true;\n    } else {\n      this.transition.cancel();\n    }\n\n    return transitionTriggered;\n  }\n\n  updateTransition() {\n    this.transition.update();\n  }\n\n  // Helper methods\n\n  _isTransitionEnabled(props: TransitionProps): boolean {\n    const {transitionDuration, transitionInterpolator} = props;\n    return (\n      ((transitionDuration as number) > 0 || transitionDuration === 'auto') &&\n      Boolean(transitionInterpolator)\n    );\n  }\n\n  _isUpdateDueToCurrentTransition(props: TransitionProps): boolean {\n    if (this.transition.inProgress && this.propsInTransition) {\n      return (this.transition.settings as TransitionSettings).interpolator.arePropsEqual(\n        props,\n        this.propsInTransition\n      );\n    }\n    return false;\n  }\n\n  _shouldIgnoreViewportChange(currentProps: TransitionProps, nextProps: TransitionProps): boolean {\n    if (this.transition.inProgress) {\n      // Ignore update if it is requested to be ignored\n      return (\n        (this.transition.settings as TransitionSettings).interruption ===\n          TRANSITION_EVENTS.IGNORE ||\n        // Ignore update if it is due to current active transition.\n        this._isUpdateDueToCurrentTransition(nextProps)\n      );\n    }\n    if (this._isTransitionEnabled(nextProps)) {\n      // Ignore if none of the viewport props changed.\n      return (nextProps.transitionInterpolator as TransitionInterpolator).arePropsEqual(\n        currentProps,\n        nextProps\n      );\n    }\n    return true;\n  }\n\n  _triggerTransition(startProps: TransitionProps, endProps: TransitionProps): void {\n    const startViewstate = this.getControllerState(startProps);\n    const endViewStateProps = this.getControllerState(endProps).shortestPathFrom(startViewstate);\n\n    // update transitionDuration for 'auto' mode\n    const transitionInterpolator = endProps.transitionInterpolator as TransitionInterpolator;\n    const duration = transitionInterpolator.getDuration\n      ? transitionInterpolator.getDuration(startProps, endProps)\n      : (endProps.transitionDuration as number);\n\n    if (duration === 0) {\n      return;\n    }\n\n    const initialProps = transitionInterpolator.initializeProps(startProps, endViewStateProps);\n\n    this.propsInTransition = {};\n    const transitionSettings: TransitionSettings = {\n      duration,\n      easing: endProps.transitionEasing || DEFAULT_EASING,\n      interpolator: transitionInterpolator,\n      interruption: endProps.transitionInterruption || DEFAULT_INTERRUPTION,\n\n      startProps: initialProps.start,\n      endProps: initialProps.end,\n\n      onStart: endProps.onTransitionStart,\n      onUpdate: this._onTransitionUpdate,\n      onInterrupt: this._onTransitionEnd(endProps.onTransitionInterrupt),\n      onEnd: this._onTransitionEnd(endProps.onTransitionEnd)\n    };\n    this.transition.start(transitionSettings);\n\n    this.onStateChange({inTransition: true});\n\n    this.updateTransition();\n  }\n\n  _onTransitionEnd(callback?: (transition: Transition) => void) {\n    return transition => {\n      this.propsInTransition = null;\n\n      this.onStateChange({\n        inTransition: false,\n        isZooming: false,\n        isPanning: false,\n        isRotating: false\n      });\n\n      callback?.(transition);\n    };\n  }\n\n  _onTransitionUpdate = transition => {\n    // NOTE: Be cautious re-ordering statements in this function.\n    const {\n      time,\n      settings: {interpolator, startProps, endProps, duration, easing}\n    } = transition;\n    const t = easing(time / duration);\n    const viewport = interpolator.interpolateProps(startProps, endProps, t);\n\n    // This gurantees all props (e.g. bearing, longitude) are normalized\n    // So when viewports are compared they are in same range.\n    this.propsInTransition = this.getControllerState({\n      ...this.props,\n      ...viewport\n    }).getViewportProps();\n\n    this.onViewStateChange({\n      viewState: this.propsInTransition,\n      oldViewState: this.props as TransitionProps\n    });\n  };\n}\n","const DEFAULT_VERSION = 'latest';\nexport const VERSION = typeof \"3.2.10\" !== 'undefined' ? \"3.2.10\" : DEFAULT_VERSION;\n\nif (typeof \"3.2.10\" === 'undefined') {\n  console.error('loaders.gl: The __VERSION__ variable is not injected using babel plugin. Latest unstable workers would be fetched from the CDN.');\n}\n//# sourceMappingURL=version.js.map","import { concatenateArrayBuffers } from '../binary-utils/array-buffer-utils';\nexport async function forEach(iterator, visitor) {\n  while (true) {\n    const {\n      done,\n      value\n    } = await iterator.next();\n\n    if (done) {\n      iterator.return();\n      return;\n    }\n\n    const cancel = visitor(value);\n\n    if (cancel) {\n      return;\n    }\n  }\n}\nexport async function concatenateArrayBuffersAsync(asyncIterator) {\n  const arrayBuffers = [];\n\n  for await (const chunk of asyncIterator) {\n    arrayBuffers.push(chunk);\n  }\n\n  return concatenateArrayBuffers(...arrayBuffers);\n}\nexport async function concatenateStringsAsync(asyncIterator) {\n  const strings = [];\n\n  for await (const chunk of asyncIterator) {\n    strings.push(chunk);\n  }\n\n  return strings.join('');\n}\n//# sourceMappingURL=async-iteration.js.map","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {ProgramManager} from '@luma.gl/core';\nimport {gouraudLighting, phongLighting} from '@luma.gl/core';\nimport project from './project/project';\nimport project32 from './project32/project32';\nimport shadow from './shadow/shadow';\nimport picking from './picking/picking';\n\nconst DEFAULT_MODULES = [project];\n\nconst SHADER_HOOKS = [\n  'vs:DECKGL_FILTER_SIZE(inout vec3 size, VertexGeometry geometry)',\n  'vs:DECKGL_FILTER_GL_POSITION(inout vec4 position, VertexGeometry geometry)',\n  'vs:DECKGL_FILTER_COLOR(inout vec4 color, VertexGeometry geometry)',\n  'fs:DECKGL_FILTER_COLOR(inout vec4 color, FragmentGeometry geometry)'\n];\n\nexport function createProgramManager(gl) {\n  const programManager = ProgramManager.getDefaultProgramManager(gl);\n\n  for (const shaderModule of DEFAULT_MODULES) {\n    programManager.addDefaultModule(shaderModule);\n  }\n  for (const shaderHook of SHADER_HOOKS) {\n    programManager.addShaderHook(shaderHook);\n  }\n\n  return programManager;\n}\n\nexport {picking, project, project32, gouraudLighting, phongLighting, shadow};\n\n// Useful for custom shader modules\nexport type {ProjectUniforms} from './project/viewport-uniforms';\n\n// TODO - these should be imported from luma.gl\n/* eslint-disable camelcase */\nexport type PickingUniforms = {\n  picking_uActive: boolean;\n  picking_uAttribute: boolean;\n  picking_uSelectedColor: [number, number, number];\n  picking_uSelectedColorValid: boolean;\n  picking_uHighlightColor: [number, number, number, number];\n};\n\nexport type LightingModuleSettings = {\n  material:\n    | boolean\n    | {\n        ambient?: number;\n        diffuse?: number;\n        shininess?: number;\n        specularColor?: [number, number, number];\n      };\n};\n","import View, {CommonViewState} from './view';\nimport OrthographicViewport from '../viewports/orthographic-viewport';\nimport OrthographicController from '../controllers/orthographic-controller';\n\nexport type OrthographicViewState = {\n  /** The world position at the center of the viewport. Default `[0, 0, 0]`. */\n  target?: [number, number, number] | [number, number];\n  /**  The zoom level of the viewport. `zoom: 0` maps one unit distance to one pixel on screen, and increasing `zoom` by `1` scales the same object to twice as large.\n   *   To apply independent zoom levels to the X and Y axes, supply an array `[zoomX, zoomY]`. Default `0`. */\n  zoom?: number | [number, number];\n  /** The min zoom level of the viewport. Default `-Infinity`. */\n  minZoom?: number;\n  /** The max zoom level of the viewport. Default `Infinity`. */\n  maxZoom?: number;\n} & CommonViewState;\n\ntype OrthographicViewProps = {\n  /** Distance of near clipping plane. Default `0.1`. */\n  near?: number;\n  /** Distance of far clipping plane. Default `1000`. */\n  far?: number;\n  /** Whether to use top-left coordinates (`true`) or bottom-left coordinates (`false`). Default `true`. */\n  flipY?: boolean;\n};\n\nexport default class OrthographicView extends View<OrthographicViewState, OrthographicViewProps> {\n  static displayName = 'OrthographicView';\n\n  get ViewportType() {\n    return OrthographicViewport;\n  }\n\n  get ControllerType() {\n    return OrthographicController;\n  }\n}\n","import Viewport from '../viewports/viewport';\n\nimport {Matrix4, clamp} from '@math.gl/core';\nimport {pixelsToWorld} from '@math.gl/web-mercator';\nimport * as vec2 from 'gl-matrix/vec2';\n\nimport type {Padding} from './viewport';\n\nconst viewMatrix = new Matrix4().lookAt({eye: [0, 0, 1]});\n\nfunction getProjectionMatrix({\n  width,\n  height,\n  near,\n  far,\n  padding\n}: {\n  width: number;\n  height: number;\n  near: number;\n  far: number;\n  padding: Padding | null;\n}) {\n  let left = -width / 2;\n  let right = width / 2;\n  let bottom = -height / 2;\n  let top = height / 2;\n  if (padding) {\n    const {left: l = 0, right: r = 0, top: t = 0, bottom: b = 0} = padding;\n    const offsetX = clamp((l + width - r) / 2, 0, width) - width / 2;\n    const offsetY = clamp((t + height - b) / 2, 0, height) - height / 2;\n    left -= offsetX;\n    right -= offsetX;\n    bottom += offsetY;\n    top += offsetY;\n  }\n\n  return new Matrix4().ortho({\n    left,\n    right,\n    bottom,\n    top,\n    near,\n    far\n  });\n}\n\nexport type OrthographicViewportOptions = {\n  /** Name of the viewport */\n  id?: string;\n  /** Left offset from the canvas edge, in pixels */\n  x?: number;\n  /** Top offset from the canvas edge, in pixels */\n  y?: number;\n  /** Viewport width in pixels */\n  width?: number;\n  /** Viewport height in pixels */\n  height?: number;\n  /** The world position at the center of the viewport. Default `[0, 0, 0]`. */\n  target?: [number, number, number] | [number, number];\n  /**  The zoom level of the viewport. `zoom: 0` maps one unit distance to one pixel on screen, and increasing `zoom` by `1` scales the same object to twice as large.\n   *   To apply independent zoom levels to the X and Y axes, supply an array `[zoomX, zoomY]`. Default `0`. */\n  zoom?: number | [number, number];\n  /** Padding around the viewport, in pixels. */\n  padding?: Padding | null;\n  /** Distance of near clipping plane. Default `0.1`. */\n  near?: number;\n  /** Distance of far clipping plane. Default `1000`. */\n  far?: number;\n  /** Whether to use top-left coordinates (`true`) or bottom-left coordinates (`false`). Default `true`. */\n  flipY?: boolean;\n};\n\nexport default class OrthographicViewport extends Viewport {\n  constructor(props: OrthographicViewportOptions) {\n    const {\n      width,\n      height,\n      near = 0.1,\n      far = 1000,\n      zoom = 0,\n      target = [0, 0, 0],\n      padding = null,\n      flipY = true\n    } = props;\n    const zoomX = Array.isArray(zoom) ? zoom[0] : zoom;\n    const zoomY = Array.isArray(zoom) ? zoom[1] : zoom;\n    const zoom_ = Math.min(zoomX, zoomY);\n    const scale = Math.pow(2, zoom_);\n\n    let distanceScales;\n    if (zoomX !== zoomY) {\n      const scaleX = Math.pow(2, zoomX);\n      const scaleY = Math.pow(2, zoomY);\n\n      distanceScales = {\n        unitsPerMeter: [scaleX / scale, scaleY / scale, 1],\n        metersPerUnit: [scale / scaleX, scale / scaleY, 1]\n      };\n    }\n\n    super({\n      ...props,\n      // in case viewState contains longitude/latitude values,\n      // make sure that the base Viewport class does not treat this as a geospatial viewport\n      longitude: undefined,\n      position: target,\n      viewMatrix: viewMatrix.clone().scale([scale, scale * (flipY ? -1 : 1), scale]),\n      projectionMatrix: getProjectionMatrix({\n        width: width || 1,\n        height: height || 1,\n        padding,\n        near,\n        far\n      }),\n      zoom: zoom_,\n      distanceScales\n    });\n  }\n\n  projectFlat([X, Y]: number[]): [number, number] {\n    const {unitsPerMeter} = this.distanceScales;\n    return [X * unitsPerMeter[0], Y * unitsPerMeter[1]];\n  }\n\n  unprojectFlat([x, y]: number[]): [number, number] {\n    const {metersPerUnit} = this.distanceScales;\n    return [x * metersPerUnit[0], y * metersPerUnit[1]];\n  }\n\n  /* Needed by LinearInterpolator */\n  panByPosition(coords: number[], pixel: number[]): OrthographicViewportOptions {\n    const fromLocation = pixelsToWorld(pixel, this.pixelUnprojectionMatrix);\n    const toLocation = this.projectFlat(coords);\n\n    const translate = vec2.add([], toLocation, vec2.negate([], fromLocation));\n    const newCenter = vec2.add([], this.center, translate);\n\n    return {target: this.unprojectFlat(newCenter)};\n  }\n}\n","import {clamp} from '@math.gl/core';\nimport Controller from './controller';\nimport {OrbitState} from './orbit-controller';\nimport LinearInterpolator from '../transitions/linear-interpolator';\n\nclass OrthographicState extends OrbitState {\n  zoomAxis: 'X' | 'Y' | 'all';\n\n  constructor(props) {\n    super(props);\n\n    this.zoomAxis = props.zoomAxis || 'all';\n  }\n\n  _calculateNewZoom({scale, startZoom}) {\n    const {maxZoom, minZoom} = this.getViewportProps();\n    if (startZoom === undefined) {\n      startZoom = this.getViewportProps().zoom;\n    }\n    let deltaZoom = Math.log2(scale);\n    if (Array.isArray(startZoom)) {\n      let [newZoomX, newZoomY] = startZoom;\n      switch (this.zoomAxis) {\n        case 'X':\n          // Scale x only\n          newZoomX = clamp(newZoomX + deltaZoom, minZoom, maxZoom);\n          break;\n        case 'Y':\n          // Scale y only\n          newZoomY = clamp(newZoomY + deltaZoom, minZoom, maxZoom);\n          break;\n        default:\n          // Lock aspect ratio\n          let z = Math.min(newZoomX + deltaZoom, newZoomY + deltaZoom);\n          if (z < minZoom) {\n            deltaZoom += minZoom - z;\n          }\n          z = Math.max(newZoomX + deltaZoom, newZoomY + deltaZoom);\n          if (z > maxZoom) {\n            deltaZoom += maxZoom - z;\n          }\n          newZoomX += deltaZoom;\n          newZoomY += deltaZoom;\n      }\n      return [newZoomX, newZoomY];\n    }\n    // Ignore `zoomAxis`\n    // `LinearTransitionInterpolator` does not support interpolation between a number and an array\n    // So if zoom is a number (legacy use case), new zoom still has to be a number\n    return clamp(startZoom + deltaZoom, minZoom, maxZoom);\n  }\n}\n\nexport default class OrthographicController extends Controller<OrbitState> {\n  ControllerState = OrthographicState;\n  transition = {\n    transitionDuration: 300,\n    transitionInterpolator: new LinearInterpolator(['target', 'zoom'])\n  };\n  dragMode: 'pan' | 'rotate' = 'pan';\n\n  _onPanRotate() {\n    // No rotation in orthographic view\n    return false;\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nconst ERR_NOT_OBJECT = 'count(): argument not an object';\nconst ERR_NOT_CONTAINER = 'count(): argument not a container';\n\n/**\n * Deduces numer of elements in a JavaScript container.\n * - Auto-deduction for ES6 containers that define a count() method\n * - Auto-deduction for ES6 containers that define a size member\n * - Auto-deduction for Classic Arrays via the built-in length attribute\n * - Also handles objects, although note that this an O(N) operation\n */\nexport function count(container: any): number {\n  if (!isObject(container)) {\n    throw new Error(ERR_NOT_OBJECT);\n  }\n\n  // Check if ES6 collection \"count\" function is available\n  if (typeof container.count === 'function') {\n    return container.count();\n  }\n\n  // Check if ES6 collection \"size\" attribute is set\n  if (Number.isFinite(container.size)) {\n    return container.size;\n  }\n\n  // Check if array length attribute is set\n  // Note: checking this last since some ES6 collections (Immutable.js)\n  // emit profuse warnings when trying to access `length` attribute\n  if (Number.isFinite(container.length)) {\n    return container.length;\n  }\n\n  // Note that getting the count of an object is O(N)\n  if (isPlainObject(container)) {\n    return Object.keys(container).length;\n  }\n\n  throw new Error(ERR_NOT_CONTAINER);\n}\n\n/**\n * Checks if argument is a plain object (not a class or array etc)\n * @param {*} value - JavaScript value to be tested\n * @return {Boolean} - true if argument is a plain JavaScript object\n */\nfunction isPlainObject(value) {\n  return value !== null && typeof value === 'object' && value.constructor === Object;\n}\n\n/**\n * Checks if argument is an indexable object (not a primitive value, nor null)\n * @param {*} value - JavaScript value to be tested\n * @return {Boolean} - true if argument is a JavaScript object\n */\nfunction isObject(value) {\n  return value !== null && typeof value === 'object';\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n// Merge two luma.gl shader descriptors\nexport function mergeShaders(target, source) {\n  if (!source) {\n    return target;\n  }\n  const result = {...target, ...source};\n\n  if ('defines' in source) {\n    result.defines = {...target.defines, ...source.defines};\n  }\n  if ('modules' in source) {\n    result.modules = (target.modules || []).concat(source.modules);\n\n    // Hack: prject32 and project64 cannot co-exist\n    if (source.modules.some(module => module.name === 'project64')) {\n      const index = result.modules.findIndex(module => module.name === 'project32');\n      if (index >= 0) {\n        result.modules.splice(index, 1);\n      }\n    }\n  }\n  if ('inject' in source) {\n    if (!target.inject) {\n      result.inject = source.inject;\n    } else {\n      const mergedInjection = {...target.inject};\n      for (const key in source.inject) {\n        mergedInjection[key] = (mergedInjection[key] || '') + source.inject[key];\n      }\n      result.inject = mergedInjection;\n    }\n  }\n  return result;\n}\n","import {Matrix4} from '@math.gl/core';\nimport Viewport from './viewport';\nimport {PROJECTION_MODE} from '../lib/constants';\n\nimport * as vec3 from 'gl-matrix/vec3';\nimport * as vec4 from 'gl-matrix/vec4';\n\nconst DEGREES_TO_RADIANS = Math.PI / 180;\nconst RADIANS_TO_DEGREES = 180 / Math.PI;\nconst EARTH_RADIUS = 6370972;\nconst GLOBE_RADIUS = 256;\n\nfunction getDistanceScales() {\n  const unitsPerMeter = GLOBE_RADIUS / EARTH_RADIUS;\n  const unitsPerDegree = (Math.PI / 180) * GLOBE_RADIUS;\n\n  return {\n    unitsPerMeter: [unitsPerMeter, unitsPerMeter, unitsPerMeter],\n    unitsPerMeter2: [0, 0, 0],\n    metersPerUnit: [1 / unitsPerMeter, 1 / unitsPerMeter, 1 / unitsPerMeter],\n    unitsPerDegree: [unitsPerDegree, unitsPerDegree, unitsPerMeter],\n    unitsPerDegree2: [0, 0, 0],\n    degreesPerUnit: [1 / unitsPerDegree, 1 / unitsPerDegree, 1 / unitsPerMeter]\n  };\n}\n\nexport type GlobeViewportOptions = {\n  /** Name of the viewport */\n  id?: string;\n  /** Left offset from the canvas edge, in pixels */\n  x?: number;\n  /** Top offset from the canvas edge, in pixels */\n  y?: number;\n  /** Viewport width in pixels */\n  width?: number;\n  /** Viewport height in pixels */\n  height?: number;\n  /** Longitude in degrees */\n  longitude?: number;\n  /** Latitude in degrees */\n  latitude?: number;\n  /** Camera altitude relative to the viewport height, used to control the FOV. Default `1.5` */\n  altitude?: number;\n  /* Meter offsets of the viewport center from lng, lat */\n  position?: number[];\n  /** Zoom level */\n  zoom?: number;\n  /** Use orthographic projection */\n  orthographic?: boolean;\n  /** Scaler for the near plane, 1 unit equals to the height of the viewport. Default `0.1` */\n  nearZMultiplier?: number;\n  /** Scaler for the far plane, 1 unit equals to the distance from the camera to the edge of the screen. Default `2` */\n  farZMultiplier?: number;\n  /** The resolution at which to turn flat features into 3D meshes, in degrees. Smaller numbers will generate more detailed mesh. Default `10` */\n  resolution?: number;\n};\n\nexport default class GlobeViewport extends Viewport {\n  // @ts-ignore\n  longitude: number;\n  // @ts-ignore\n  latitude: number;\n  resolution: number;\n\n  constructor(opts: GlobeViewportOptions = {}) {\n    const {\n      latitude = 0,\n      longitude = 0,\n      zoom = 0,\n      nearZMultiplier = 0.1,\n      farZMultiplier = 2,\n      resolution = 10\n    } = opts;\n\n    let {height, altitude = 1.5} = opts;\n\n    height = height || 1;\n    altitude = Math.max(0.75, altitude);\n\n    // Calculate view matrix\n    const viewMatrix = new Matrix4().lookAt({eye: [0, -altitude, 0], up: [0, 0, 1]});\n    const scale = Math.pow(2, zoom);\n    viewMatrix.rotateX(latitude * DEGREES_TO_RADIANS);\n    viewMatrix.rotateZ(-longitude * DEGREES_TO_RADIANS);\n    viewMatrix.scale(scale / height);\n\n    const halfFov = Math.atan(0.5 / altitude);\n    const relativeScale = (GLOBE_RADIUS * 2 * scale) / height;\n\n    super({\n      ...opts,\n      // x, y, width,\n      height,\n\n      // view matrix\n      viewMatrix,\n      longitude,\n      latitude,\n      zoom,\n\n      // projection matrix parameters\n      distanceScales: getDistanceScales(),\n      fovyRadians: halfFov * 2,\n      focalDistance: altitude,\n      near: nearZMultiplier,\n      far: Math.min(2, 1 / relativeScale + 1) * altitude * farZMultiplier\n    });\n\n    this.latitude = latitude;\n    this.longitude = longitude;\n    this.resolution = resolution;\n  }\n\n  get projectionMode() {\n    return PROJECTION_MODE.GLOBE;\n  }\n\n  getDistanceScales() {\n    return this.distanceScales;\n  }\n\n  getBounds(options: {z?: number} = {}): [number, number, number, number] {\n    const unprojectOption = {targetZ: options.z || 0};\n\n    const left = this.unproject([0, this.height / 2], unprojectOption);\n    const top = this.unproject([this.width / 2, 0], unprojectOption);\n    const right = this.unproject([this.width, this.height / 2], unprojectOption);\n    const bottom = this.unproject([this.width / 2, this.height], unprojectOption);\n\n    if (right[0] < this.longitude) right[0] += 360;\n    if (left[0] > this.longitude) left[0] -= 360;\n\n    return [\n      Math.min(left[0], right[0], top[0], bottom[0]),\n      Math.min(left[1], right[1], top[1], bottom[1]),\n      Math.max(left[0], right[0], top[0], bottom[0]),\n      Math.max(left[1], right[1], top[1], bottom[1])\n    ];\n  }\n\n  unproject(\n    xyz: number[],\n    {topLeft = true, targetZ}: {topLeft?: boolean; targetZ?: number} = {}\n  ): number[] {\n    const [x, y, z] = xyz;\n\n    const y2 = topLeft ? y : this.height - y;\n    const {pixelUnprojectionMatrix} = this;\n\n    let coord;\n    if (Number.isFinite(z)) {\n      // Has depth component\n      coord = transformVector(pixelUnprojectionMatrix, [x, y2, z, 1]);\n    } else {\n      // since we don't know the correct projected z value for the point,\n      // unproject two points to get a line and then find the point on that line that intersects with the sphere\n      const coord0 = transformVector(pixelUnprojectionMatrix, [x, y2, -1, 1]);\n      const coord1 = transformVector(pixelUnprojectionMatrix, [x, y2, 1, 1]);\n\n      const lt = ((targetZ || 0) / EARTH_RADIUS + 1) * GLOBE_RADIUS;\n      const lSqr = vec3.sqrLen(vec3.sub([], coord0, coord1));\n      const l0Sqr = vec3.sqrLen(coord0);\n      const l1Sqr = vec3.sqrLen(coord1);\n      const sSqr = (4 * l0Sqr * l1Sqr - (lSqr - l0Sqr - l1Sqr) ** 2) / 16;\n      const dSqr = (4 * sSqr) / lSqr;\n      const r0 = Math.sqrt(l0Sqr - dSqr);\n      const dr = Math.sqrt(Math.max(0, lt * lt - dSqr));\n      const t = (r0 - dr) / Math.sqrt(lSqr);\n\n      coord = vec3.lerp([], coord0, coord1, t);\n    }\n    const [X, Y, Z] = this.unprojectPosition(coord);\n\n    if (Number.isFinite(z)) {\n      return [X, Y, Z];\n    }\n    return Number.isFinite(targetZ) ? [X, Y, targetZ as number] : [X, Y];\n  }\n\n  projectPosition(xyz: number[]): [number, number, number] {\n    const [lng, lat, Z = 0] = xyz;\n    const lambda = lng * DEGREES_TO_RADIANS;\n    const phi = lat * DEGREES_TO_RADIANS;\n    const cosPhi = Math.cos(phi);\n    const D = (Z / EARTH_RADIUS + 1) * GLOBE_RADIUS;\n\n    return [Math.sin(lambda) * cosPhi * D, -Math.cos(lambda) * cosPhi * D, Math.sin(phi) * D];\n  }\n\n  unprojectPosition(xyz: number[]): [number, number, number] {\n    const [x, y, z] = xyz;\n    const D = vec3.len(xyz);\n    const phi = Math.asin(z / D);\n    const lambda = Math.atan2(x, -y);\n\n    const lng = lambda * RADIANS_TO_DEGREES;\n    const lat = phi * RADIANS_TO_DEGREES;\n    const Z = (D / GLOBE_RADIUS - 1) * EARTH_RADIUS;\n    return [lng, lat, Z];\n  }\n\n  projectFlat(xyz: number[]): [number, number] {\n    return xyz as [number, number];\n  }\n\n  unprojectFlat(xyz: number[]): [number, number] {\n    return xyz as [number, number];\n  }\n\n  panByPosition(coords: number[], pixel: number[]): GlobeViewportOptions {\n    const fromPosition = this.unproject(pixel);\n    return {\n      longitude: coords[0] - fromPosition[0] + this.longitude,\n      latitude: coords[1] - fromPosition[1] + this.latitude\n    };\n  }\n}\n\nfunction transformVector(matrix: number[], vector: number[]): number[] {\n  const result = vec4.transformMat4([], vector, matrix);\n  vec4.scale(result, result, 1 / result[3]);\n  return result;\n}\n","import {lerp} from '@math.gl/core';\nimport Transition from './transition';\n\nexport default class CPUInterpolationTransition extends Transition {\n  get value() {\n    return this._value;\n  }\n\n  _onUpdate() {\n    const {\n      time,\n      settings: {fromValue, toValue, duration, easing}\n    } = this;\n    const t = easing(time / duration);\n    this._value = lerp(fromValue, toValue, t);\n  }\n}\n","import Transition from './transition';\n\nconst EPSILON = 1e-5;\n\n/*\n * Calculate the next value in the spring transition\n * @param prev {Number} - previous value\n * @param cur {Number} - current value\n * @param dest {Number} - destination value\n * @param damping {Number}\n * @param stiffness {Number}\n */\nfunction updateSpringElement(prev, cur, dest, damping, stiffness) {\n  const velocity = cur - prev;\n  const delta = dest - cur;\n  const spring = delta * stiffness;\n  const damper = -velocity * damping;\n  return spring + damper + velocity + cur;\n}\n\n/*\n * Calculate the next value in the spring transition\n * @param prev {Number|Array} - previous value\n * @param cur {Number|Array} - current value\n * @param dest {Number|Array} - destination value\n * @param damping {Number}\n * @param stiffness {Number}\n */\nfunction updateSpring(prev, cur, dest, damping, stiffness) {\n  if (Array.isArray(dest)) {\n    const next = [];\n    for (let i = 0; i < dest.length; i++) {\n      next[i] = updateSpringElement(prev[i], cur[i], dest[i], damping, stiffness);\n    }\n    return next;\n  }\n  return updateSpringElement(prev, cur, dest, damping, stiffness);\n}\n\n/*\n * Calculate the distance between two numbers or two vectors\n */\nfunction distance(value1, value2) {\n  if (Array.isArray(value1)) {\n    let distanceSquare = 0;\n    for (let i = 0; i < value1.length; i++) {\n      const d = value1[i] - value2[i];\n      distanceSquare += d * d;\n    }\n    return Math.sqrt(distanceSquare);\n  }\n  return Math.abs(value1 - value2);\n}\n\nexport default class CPUSpringTransition extends Transition {\n  get value() {\n    return this._currValue;\n  }\n\n  _onUpdate() {\n    // TODO - use timeline\n    // const {time} = this;\n\n    const {fromValue, toValue, damping, stiffness} = this.settings;\n    const {_prevValue = fromValue, _currValue = fromValue} = this;\n    let nextValue = updateSpring(_prevValue, _currValue, toValue, damping, stiffness);\n    const delta = distance(nextValue, toValue);\n    const velocity = distance(nextValue, _currValue);\n\n    if (delta < EPSILON && velocity < EPSILON) {\n      nextValue = toValue;\n      this.end();\n    }\n\n    this._prevValue = _currValue;\n    this._currValue = nextValue;\n  }\n}\n","import {normalizeTransitionSettings} from './attribute/attribute-transition-utils';\nimport CPUInterpolationTransition from '../transitions/cpu-interpolation-transition';\nimport CPUSpringTransition from '../transitions/cpu-spring-transition';\nimport log from '../utils/log';\n\nconst TRANSITION_TYPES = {\n  interpolation: CPUInterpolationTransition,\n  spring: CPUSpringTransition\n};\n\nexport default class UniformTransitionManager {\n  constructor(timeline) {\n    this.transitions = new Map();\n    this.timeline = timeline;\n  }\n\n  get active() {\n    return this.transitions.size > 0;\n  }\n\n  add(key, fromValue, toValue, settings) {\n    const {transitions} = this;\n    if (transitions.has(key)) {\n      const transition = transitions.get(key);\n      // value may not be available if `update()` has not been called. Fallback to `fromValue`\n      const {value = transition.settings.fromValue} = transition;\n      // start from interrupted position\n      fromValue = value;\n      this.remove(key);\n    }\n\n    settings = normalizeTransitionSettings(settings);\n    if (!settings) {\n      return;\n    }\n\n    const TransitionType = TRANSITION_TYPES[settings.type];\n    if (!TransitionType) {\n      log.error(`unsupported transition type '${settings.type}'`)();\n      return;\n    }\n    const transition = new TransitionType(this.timeline);\n    transition.start({\n      ...settings,\n      fromValue,\n      toValue\n    });\n    transitions.set(key, transition);\n  }\n\n  remove(key) {\n    const {transitions} = this;\n    if (transitions.has(key)) {\n      transitions.get(key).cancel();\n      transitions.delete(key);\n    }\n  }\n\n  update() {\n    const propsInTransition = {};\n\n    for (const [key, transition] of this.transitions) {\n      transition.update();\n      propsInTransition[key] = transition.value;\n      if (!transition.inProgress) {\n        // transition ended\n        this.remove(key);\n      }\n    }\n\n    return propsInTransition;\n  }\n\n  clear() {\n    for (const key of this.transitions.keys()) {\n      this.remove(key);\n    }\n  }\n}\n","import {Texture2D} from '@luma.gl/core';\nimport GL from '@luma.gl/constants';\n\nimport type Layer from '../lib/layer';\n\nconst DEFAULT_TEXTURE_PARAMETERS: Record<number, number> = {\n  [GL.TEXTURE_MIN_FILTER]: GL.LINEAR_MIPMAP_LINEAR,\n  [GL.TEXTURE_MAG_FILTER]: GL.LINEAR,\n  [GL.TEXTURE_WRAP_S]: GL.CLAMP_TO_EDGE,\n  [GL.TEXTURE_WRAP_T]: GL.CLAMP_TO_EDGE\n};\n\n// Track the textures that are created by us. They need to be released when they are no longer used.\nconst internalTextures: Record<string, Texture2D> = {};\n\nexport function createTexture(layer: Layer, image: any): Texture2D | null {\n  const gl = layer.context && layer.context.gl;\n  if (!gl || !image) {\n    return null;\n  }\n\n  // image could be one of:\n  //  - Texture2D\n  //  - Browser object: Image, ImageData, ImageData, HTMLCanvasElement, HTMLVideoElement, ImageBitmap\n  //  - Plain object: {width: <number>, height: <number>, data: <Uint8Array>}\n  if (image instanceof Texture2D) {\n    return image;\n  } else if (image.constructor && image.constructor.name !== 'Object') {\n    // Browser object\n    image = {data: image};\n  }\n\n  let specialTextureParameters: Record<string, any> | null = null;\n  if (image.compressed) {\n    specialTextureParameters = {\n      [GL.TEXTURE_MIN_FILTER]: image.data.length > 1 ? GL.LINEAR_MIPMAP_NEAREST : GL.LINEAR\n    };\n  }\n\n  const texture = new Texture2D(gl, {\n    ...image,\n    parameters: {\n      ...DEFAULT_TEXTURE_PARAMETERS,\n      ...specialTextureParameters,\n      // @ts-expect-error textureParameter may not be defined\n      ...layer.props.textureParameters\n    }\n  });\n  // Track this texture\n  internalTextures[texture.id] = true;\n  return texture;\n}\n\nexport function destroyTexture(texture: Texture2D) {\n  if (!texture || !(texture instanceof Texture2D)) {\n    return;\n  }\n  if (internalTextures[texture.id]) {\n    texture.delete();\n    delete internalTextures[texture.id];\n  }\n}\n","import {createTexture, destroyTexture} from '../utils/texture';\nimport {deepEqual} from '../utils/deep-equal';\n\nimport type Component from './component';\nimport type {Color, Texture} from '../types/layer-props';\n\ntype BasePropType<ValueT> = {\n  value: ValueT;\n  async?: boolean;\n  validate?: (value: any, propType: PropType) => boolean;\n  equal?: (value1: ValueT, value2: ValueT, propType: PropType) => boolean;\n};\n\n/**\n * Normalized prop type definition\n */\nexport type PropType = BasePropType<any> & {\n  type: string;\n  name: string;\n  transform?: (value: any, propType: PropType, component: Component<any>) => any;\n  release?: (value: any, propType: PropType, component: Component<any>) => void;\n};\n\ntype DefaultProp<T> =\n  | T\n  | DeprecatedProp\n  | BooleanPropType\n  | NumberPropType\n  | ColorPropType\n  | ImagePropType\n  | DataPropType<T>\n  | ArrayPropType<T>\n  | ObjectPropType<T>\n  | AccessorPropType<T>\n  | FunctionPropType<T>;\n\nexport type DefaultProps<T extends Record<string, any>> = {\n  [propName in keyof T]?: DefaultProp<Required<T>[propName]>;\n};\n\ntype BooleanPropType = BasePropType<boolean> & {\n  type: 'boolean';\n};\ntype NumberPropType = BasePropType<number> & {\n  type: 'number';\n  min?: number;\n  max?: number;\n};\ntype ColorPropType = BasePropType<Color | null> & {\n  type: 'color';\n  optional?: boolean;\n};\ntype ArrayPropType<T = any[]> = BasePropType<T> & {\n  type: 'array';\n  optional?: boolean;\n  compare?: boolean;\n};\ntype AccessorPropType<T = any> = BasePropType<T> & {\n  type: 'accessor';\n};\ntype FunctionPropType<T = Function> = BasePropType<T> & {\n  type: 'function';\n  optional?: boolean;\n  compare?: boolean;\n};\ntype DataPropType<T = any> = BasePropType<T> & {\n  type: 'data';\n};\ntype ImagePropType = BasePropType<Texture | null> & {\n  type: 'image';\n};\ntype ObjectPropType<T = any> = BasePropType<T> & {\n  type: 'object';\n  optional?: boolean;\n  compare?: boolean;\n};\ntype DeprecatedProp = {\n  deprecatedFor?: string | string[];\n};\ntype PropTypeDef =\n  | DeprecatedProp\n  | boolean\n  | BooleanPropType\n  | number\n  | NumberPropType\n  | string\n  | DataPropType\n  | number[]\n  | ColorPropType\n  | ArrayPropType\n  | AccessorPropType\n  | FunctionPropType\n  | ImagePropType\n  | ObjectPropType\n  | null;\n\nconst TYPE_DEFINITIONS = {\n  boolean: {\n    validate(value, propType: BooleanPropType) {\n      return true;\n    },\n    equal(value1, value2, propType: BooleanPropType) {\n      return Boolean(value1) === Boolean(value2);\n    }\n  },\n  number: {\n    validate(value, propType: NumberPropType) {\n      return (\n        Number.isFinite(value) &&\n        (!('max' in propType) || value <= propType.max!) &&\n        (!('min' in propType) || value >= propType.min!)\n      );\n    }\n  },\n  color: {\n    validate(value, propType: ColorPropType) {\n      return (\n        (propType.optional && !value) ||\n        (isArray(value) && (value.length === 3 || value.length === 4))\n      );\n    },\n    equal(value1, value2, propType: ColorPropType) {\n      return arrayEqual(value1, value2);\n    }\n  },\n  accessor: {\n    validate(value, propType: AccessorPropType) {\n      const valueType = getTypeOf(value);\n      return valueType === 'function' || valueType === getTypeOf(propType.value);\n    },\n    equal(value1, value2, propType: AccessorPropType) {\n      if (typeof value2 === 'function') {\n        return true;\n      }\n      return arrayEqual(value1, value2);\n    }\n  },\n  array: {\n    validate(value, propType: ArrayPropType) {\n      return (propType.optional && !value) || isArray(value);\n    },\n    equal(value1, value2, propType: ArrayPropType) {\n      return propType.compare ? arrayEqual(value1, value2) : value1 === value2;\n    }\n  },\n  object: {\n    equal(value1, value2, propType: ObjectPropType) {\n      return propType.compare ? deepEqual(value1, value2) : value1 === value2;\n    }\n  },\n  function: {\n    validate(value, propType: FunctionPropType) {\n      return (propType.optional && !value) || typeof value === 'function';\n    },\n    equal(value1, value2, propType: FunctionPropType) {\n      return !propType.compare || value1 === value2;\n    }\n  },\n  data: {\n    transform: (value, propType: DataPropType, component) => {\n      const {dataTransform} = component.props;\n      return dataTransform && value ? dataTransform(value) : value;\n    }\n  },\n  image: {\n    transform: (value, propType: ImagePropType, component) => {\n      return createTexture(component, value);\n    },\n    release: value => {\n      destroyTexture(value);\n    }\n  }\n} as const;\n\nfunction arrayEqual(array1, array2) {\n  if (array1 === array2) {\n    return true;\n  }\n  if (!isArray(array1) || !isArray(array2)) {\n    return false;\n  }\n  const len = array1.length;\n  if (len !== array2.length) {\n    return false;\n  }\n  for (let i = 0; i < len; i++) {\n    if (array1[i] !== array2[i]) {\n      return false;\n    }\n  }\n  return true;\n}\n\nexport function parsePropTypes(propDefs: Record<string, PropTypeDef>): {\n  propTypes: Record<string, PropType>;\n  defaultProps: Record<string, any>;\n  deprecatedProps: Record<string, string[]>;\n} {\n  const propTypes = {};\n  const defaultProps = {};\n  const deprecatedProps = {};\n\n  for (const [propName, propDef] of Object.entries(propDefs)) {\n    const deprecated = (propDef as DeprecatedProp)?.deprecatedFor;\n    if (deprecated) {\n      deprecatedProps[propName] = Array.isArray(deprecated) ? deprecated : [deprecated];\n    } else {\n      const propType = parsePropType(propName, propDef);\n      propTypes[propName] = propType;\n      defaultProps[propName] = propType.value;\n    }\n  }\n  return {propTypes, defaultProps, deprecatedProps};\n}\n\n// Parses one property definition entry. Either contains:\n// * a valid prop type object ({type, ...})\n// * or just a default value, in which case type and name inference is used\nfunction parsePropType(name: string, propDef: PropTypeDef): PropType {\n  switch (getTypeOf(propDef)) {\n    case 'object':\n      return normalizePropDefinition(name, propDef);\n\n    case 'array':\n      return normalizePropDefinition(name, {type: 'array', value: propDef, compare: false});\n\n    case 'boolean':\n      return normalizePropDefinition(name, {type: 'boolean', value: propDef});\n\n    case 'number':\n      return normalizePropDefinition(name, {type: 'number', value: propDef});\n\n    case 'function':\n      // return guessFunctionType(name, propDef);\n      return normalizePropDefinition(name, {type: 'function', value: propDef, compare: true});\n\n    default:\n      return {name, type: 'unknown', value: propDef};\n  }\n}\n\nfunction normalizePropDefinition(name, propDef): PropType {\n  if (!('type' in propDef)) {\n    if (!('value' in propDef)) {\n      // If no type and value this object is likely the value\n      return {name, type: 'object', value: propDef};\n    }\n    return {name, type: getTypeOf(propDef.value), ...propDef};\n  }\n  return {name, ...TYPE_DEFINITIONS[propDef.type], ...propDef};\n}\n\nfunction isArray(value: any): boolean {\n  return Array.isArray(value) || ArrayBuffer.isView(value);\n}\n\n// improved version of javascript typeof that can distinguish arrays and null values\nfunction getTypeOf(value: any): string {\n  if (isArray(value)) {\n    return 'array';\n  }\n  if (value === null) {\n    return 'null';\n  }\n  return typeof value;\n}\n","import log from '../utils/log';\nimport {isAsyncIterable} from '../utils/iterable-utils';\nimport {parsePropTypes} from './prop-types';\nimport {\n  COMPONENT_SYMBOL,\n  ASYNC_ORIGINAL_SYMBOL,\n  ASYNC_RESOLVED_SYMBOL,\n  ASYNC_DEFAULTS_SYMBOL\n} from './constants';\nimport {StatefulComponentProps} from './component';\nimport type Component from './component';\n\n// Create a property object\nexport function createProps<T>(\n  component: Component<T>,\n  propObjects: Partial<T>[]\n): StatefulComponentProps<T> {\n  // Get default prop object (a prototype chain for now)\n  const propsPrototype = getPropsPrototype(component.constructor);\n\n  // Create a new prop object with default props object in prototype chain\n  const propsInstance = Object.create(propsPrototype);\n\n  // Props need a back pointer to the owning component\n  propsInstance[COMPONENT_SYMBOL] = component;\n  // The supplied (original) values for those async props that are set to url strings or Promises.\n  // In this case, the actual (i.e. resolved) values are looked up from component.internalState\n  propsInstance[ASYNC_ORIGINAL_SYMBOL] = {};\n  // Note: the actual (resolved) values for props that are NOT set to urls or Promises.\n  // in this case the values are served directly from this map\n  propsInstance[ASYNC_RESOLVED_SYMBOL] = {};\n\n  // \"Copy\" all sync props\n  for (let i = 0; i < propObjects.length; ++i) {\n    const props = propObjects[i];\n    // Do not use Object.assign here to avoid Symbols in props overwriting our private fields\n    // This might happen if one of the arguments is another props instance\n    for (const key in props) {\n      propsInstance[key] = props[key];\n    }\n  }\n\n  // Props must be immutable\n  Object.freeze(propsInstance);\n\n  return propsInstance;\n}\n\n// Return precalculated defaultProps and propType objects if available\n// build them if needed\nfunction getPropsPrototype(componentClass) {\n  const defaultProps = getOwnProperty(componentClass, '_mergedDefaultProps');\n  if (!defaultProps) {\n    createPropsPrototypeAndTypes(componentClass);\n    return componentClass._mergedDefaultProps;\n  }\n  return defaultProps;\n}\n\n// Build defaultProps and propType objects by walking component prototype chain\nfunction createPropsPrototypeAndTypes(componentClass) {\n  const parent = componentClass.prototype;\n  if (!parent) {\n    return;\n  }\n\n  const parentClass = Object.getPrototypeOf(componentClass);\n  const parentDefaultProps = getPropsPrototype(parentClass);\n\n  // Parse propTypes from Component.defaultProps\n  const componentDefaultProps = getOwnProperty(componentClass, 'defaultProps') || {};\n  const componentPropDefs = parsePropTypes(componentDefaultProps);\n\n  // Create any necessary property descriptors and create the default prop object\n  // Assign merged default props\n  const defaultProps = createPropsPrototype(\n    componentPropDefs.defaultProps,\n    parentDefaultProps,\n    componentClass\n  );\n\n  // Create a merged type object\n  const propTypes = {...parentClass._propTypes, ...componentPropDefs.propTypes};\n  // Add getters/setters for async props\n  addAsyncPropsToPropPrototype(defaultProps, propTypes);\n\n  // Create a map for prop whose default value is a callback\n  const deprecatedProps = {\n    ...parentClass._deprecatedProps,\n    ...componentPropDefs.deprecatedProps\n  };\n  // Add setters for deprecated props\n  addDeprecatedPropsToPropPrototype(defaultProps, deprecatedProps);\n\n  // Store the precalculated props\n  componentClass._mergedDefaultProps = defaultProps;\n  componentClass._propTypes = propTypes;\n  componentClass._deprecatedProps = deprecatedProps;\n}\n\n// Builds a pre-merged default props object that component props can inherit from\nfunction createPropsPrototype(props, parentProps, componentClass) {\n  const defaultProps = Object.create(null);\n\n  Object.assign(defaultProps, parentProps, props);\n\n  // Avoid freezing `id` prop\n  const id = getComponentName(componentClass);\n  delete props.id;\n\n  Object.defineProperties(defaultProps, {\n    // `id` is treated specially because layer might need to override it\n    id: {\n      writable: true,\n      value: id\n    }\n  });\n\n  return defaultProps;\n}\n\nfunction addDeprecatedPropsToPropPrototype(defaultProps, deprecatedProps) {\n  for (const propName in deprecatedProps) {\n    /* eslint-disable accessor-pairs */\n    Object.defineProperty(defaultProps, propName, {\n      enumerable: false,\n      set(newValue) {\n        const nameStr = `${this.id}: ${propName}`;\n\n        for (const newPropName of deprecatedProps[propName]) {\n          if (!hasOwnProperty(this, newPropName)) {\n            this[newPropName] = newValue;\n          }\n        }\n\n        log.deprecated(nameStr, deprecatedProps[propName].join('/'))();\n      }\n    });\n    /* eslint-enable accessor-pairs */\n  }\n}\n\n// Create descriptors for overridable props\nfunction addAsyncPropsToPropPrototype(defaultProps, propTypes) {\n  const defaultValues = {};\n\n  const descriptors = {};\n\n  // Move async props into shadow values\n  for (const propName in propTypes) {\n    const propType = propTypes[propName];\n    const {name, value} = propType;\n\n    // Note: async is ES7 keyword, can't destructure\n    if (propType.async) {\n      defaultValues[name] = value;\n      descriptors[name] = getDescriptorForAsyncProp(name);\n    }\n  }\n\n  // Default \"resolved\" values for async props, returned if value not yet resolved/set.\n  defaultProps[ASYNC_DEFAULTS_SYMBOL] = defaultValues;\n  // Shadowed object, just to make sure \"early indexing\" into the instance does not fail\n  defaultProps[ASYNC_ORIGINAL_SYMBOL] = {};\n\n  Object.defineProperties(defaultProps, descriptors);\n}\n\n// Helper: Configures getter and setter for one async prop\nfunction getDescriptorForAsyncProp(name) {\n  return {\n    enumerable: true,\n    // Save the provided value for async props in a special map\n    set(newValue) {\n      if (\n        typeof newValue === 'string' ||\n        newValue instanceof Promise ||\n        isAsyncIterable(newValue)\n      ) {\n        this[ASYNC_ORIGINAL_SYMBOL][name] = newValue;\n      } else {\n        this[ASYNC_RESOLVED_SYMBOL][name] = newValue;\n      }\n    },\n    // Only the component's state knows the true value of async prop\n    get() {\n      if (this[ASYNC_RESOLVED_SYMBOL]) {\n        // Prop value isn't async, so just return it\n        if (name in this[ASYNC_RESOLVED_SYMBOL]) {\n          const value = this[ASYNC_RESOLVED_SYMBOL][name];\n\n          return value || this[ASYNC_DEFAULTS_SYMBOL][name];\n        }\n\n        if (name in this[ASYNC_ORIGINAL_SYMBOL]) {\n          // It's an async prop value: look into component state\n          const state = this[COMPONENT_SYMBOL] && this[COMPONENT_SYMBOL].internalState;\n          if (state && state.hasAsyncProp(name)) {\n            return state.getAsyncProp(name) || this[ASYNC_DEFAULTS_SYMBOL][name];\n          }\n        }\n      }\n\n      // the prop is not supplied, or\n      // component not yet initialized/matched, return the component's default value for the prop\n      return this[ASYNC_DEFAULTS_SYMBOL][name];\n    }\n  };\n}\n\n// HELPER METHODS\n\nfunction hasOwnProperty(object, prop) {\n  return Object.prototype.hasOwnProperty.call(object, prop);\n}\n\n// Constructors have their super class constructors as prototypes\nfunction getOwnProperty(object, prop) {\n  return hasOwnProperty(object, prop) && object[prop];\n}\n\nfunction getComponentName(componentClass) {\n  const componentName =\n    getOwnProperty(componentClass, 'layerName') || getOwnProperty(componentClass, 'componentName');\n  if (!componentName) {\n    log.once(0, `${componentClass.name}.componentName not specified`)();\n  }\n  return componentName || componentClass.name;\n}\n","import {\n  COMPONENT_SYMBOL,\n  ASYNC_ORIGINAL_SYMBOL,\n  ASYNC_RESOLVED_SYMBOL,\n  ASYNC_DEFAULTS_SYMBOL\n} from './constants';\nimport {createProps} from './create-props';\n\nlet counter = 0;\n\nexport type StatefulComponentProps<PropsT> = PropsT & {\n  id: string;\n  [COMPONENT_SYMBOL]: Component<PropsT>;\n  [ASYNC_DEFAULTS_SYMBOL]: Partial<PropsT>;\n  [ASYNC_ORIGINAL_SYMBOL]: Partial<PropsT>;\n  [ASYNC_RESOLVED_SYMBOL]: Partial<PropsT>;\n};\n\nexport default class Component<PropsT = {}> {\n  static componentName: string = 'Component';\n  static defaultProps: Readonly<{}> = {};\n\n  id: string;\n  props: StatefulComponentProps<PropsT>;\n  count: number;\n\n  constructor(...propObjects: Partial<PropsT>[]) {\n    // Merge supplied props with default props and freeze them.\n    /* eslint-disable prefer-spread */\n    this.props = createProps<PropsT>(this, propObjects);\n    /* eslint-enable prefer-spread */\n\n    this.id = this.props.id; // The layer's id, used for matching with layers from last render cycle\n    this.count = counter++; // Keep track of how many layer instances you are generating\n  }\n\n  // clone this layer with modified props\n  clone(newProps: Partial<PropsT>) {\n    const {props} = this;\n\n    // Async props cannot be copied with Object.assign, copy them separately\n    const asyncProps: Partial<PropsT> = {};\n\n    // See async props definition in create-props.js\n    for (const key in props[ASYNC_DEFAULTS_SYMBOL]) {\n      if (key in props[ASYNC_RESOLVED_SYMBOL]) {\n        asyncProps[key] = props[ASYNC_RESOLVED_SYMBOL][key];\n      } else if (key in props[ASYNC_ORIGINAL_SYMBOL]) {\n        asyncProps[key] = props[ASYNC_ORIGINAL_SYMBOL][key];\n      }\n    }\n\n    // Some custom layer implementation may not support multiple arguments in the constructor\n    // @ts-ignore\n    return new this.constructor({...props, ...asyncProps, ...newProps});\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {isAsyncIterable} from '../utils/iterable-utils';\nimport {ASYNC_ORIGINAL_SYMBOL, ASYNC_RESOLVED_SYMBOL, ASYNC_DEFAULTS_SYMBOL} from './constants';\nimport type Component from './component';\nimport {PropType} from './prop-types';\n\nconst EMPTY_PROPS = Object.freeze({});\n\ntype AsyncPropState = {\n  type: PropType;\n  lastValue: any;\n  resolvedValue: any;\n  pendingLoadCount: number;\n  resolvedLoadCount: number;\n};\n\nexport default class ComponentState<ComponentT extends Component> {\n  component: ComponentT;\n  onAsyncPropUpdated: (propName: string, value: any) => void;\n\n  private asyncProps: Partial<Record<string, AsyncPropState>>;\n  private oldProps: ComponentT['props'] | null;\n  private oldAsyncProps: ComponentT['props'] | null;\n\n  constructor(component: ComponentT) {\n    this.component = component;\n    this.asyncProps = {}; // Prop values that the layer sees\n    this.onAsyncPropUpdated = () => {};\n    this.oldProps = null; // Last props before update\n    this.oldAsyncProps = null; // Last props before update, with async values copied.\n  }\n\n  finalize() {\n    for (const propName in this.asyncProps) {\n      const asyncProp = this.asyncProps[propName];\n      if (asyncProp && asyncProp.type && asyncProp.type.release) {\n        // Release any resources created by transforms\n        asyncProp.type.release(\n          asyncProp.resolvedValue,\n          asyncProp.type,\n          this.component as Component\n        );\n      }\n    }\n  }\n\n  /* Layer-facing props API */\n\n  getOldProps(): ComponentT['props'] | typeof EMPTY_PROPS {\n    return this.oldAsyncProps || this.oldProps || EMPTY_PROPS;\n  }\n\n  resetOldProps() {\n    this.oldAsyncProps = null;\n    this.oldProps = this.component.props;\n  }\n\n  // Checks if a prop is overridden\n  hasAsyncProp(propName: string): boolean {\n    return propName in this.asyncProps;\n  }\n\n  // Returns value of an overriden prop\n  getAsyncProp(propName: string): any {\n    const asyncProp = this.asyncProps[propName];\n    return asyncProp && asyncProp.resolvedValue;\n  }\n\n  isAsyncPropLoading(propName?: string): boolean {\n    if (propName) {\n      const asyncProp = this.asyncProps[propName];\n      return Boolean(\n        asyncProp &&\n          asyncProp.pendingLoadCount > 0 &&\n          asyncProp.pendingLoadCount !== asyncProp.resolvedLoadCount\n      );\n    }\n    for (const key in this.asyncProps) {\n      if (this.isAsyncPropLoading(key)) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  // Without changing the original prop value, swap out the data resolution under the hood\n  reloadAsyncProp(propName: string, value: any) {\n    this._watchPromise(propName, Promise.resolve(value));\n  }\n\n  // Updates all async/overridden props (when new props come in)\n  // Checks if urls have changed, starts loading, or removes override\n  setAsyncProps(props: ComponentT['props']) {\n    // NOTE: prop param and default values are only support for testing\n    const resolvedValues = props[ASYNC_RESOLVED_SYMBOL] || {};\n    const originalValues = props[ASYNC_ORIGINAL_SYMBOL] || props;\n    const defaultValues = props[ASYNC_DEFAULTS_SYMBOL] || {};\n\n    // TODO - use async props from the layer's prop types\n    for (const propName in resolvedValues) {\n      const value = resolvedValues[propName];\n      this._createAsyncPropData(propName, defaultValues[propName]);\n      this._updateAsyncProp(propName, value);\n      // Use transformed value\n      resolvedValues[propName] = this.getAsyncProp(propName);\n    }\n\n    for (const propName in originalValues) {\n      const value = originalValues[propName];\n      // Makes sure a record exists for this prop\n      this._createAsyncPropData(propName, defaultValues[propName]);\n      this._updateAsyncProp(propName, value);\n    }\n  }\n\n  /* Placeholder methods for subclassing */\n\n  protected _fetch(propName: string, url: string): any {\n    return null;\n  }\n\n  protected _onResolve(propName: string, value: any) {} // eslint-disable-line @typescript-eslint/no-empty-function\n\n  protected _onError(propName: string, error: Error) {} // eslint-disable-line @typescript-eslint/no-empty-function\n\n  // Intercept strings (URLs) and Promises and activates loading and prop rewriting\n  private _updateAsyncProp(propName: string, value: any) {\n    if (!this._didAsyncInputValueChange(propName, value)) {\n      return;\n    }\n\n    // interpret value string as url and start a new load tracked by a promise\n    if (typeof value === 'string') {\n      value = this._fetch(propName, value);\n    }\n\n    // interprets promise and track the \"loading\"\n    if (value instanceof Promise) {\n      this._watchPromise(propName, value);\n      return;\n    }\n\n    if (isAsyncIterable(value)) {\n      this._resolveAsyncIterable(propName, value); // eslint-disable-line @typescript-eslint/no-floating-promises\n      return;\n    }\n\n    // else, normal, non-async value. Just store value for now\n    this._setPropValue(propName, value);\n  }\n\n  // Whenever async props are changing, we need to make a copy of oldProps\n  // otherwise the prop rewriting will affect the value both in props and oldProps.\n  // While the copy is relatively expensive, this only happens on load completion.\n  private _freezeAsyncOldProps() {\n    if (!this.oldAsyncProps && this.oldProps) {\n      // 1. inherit all synchronous props from oldProps\n      // 2. reconfigure the async prop descriptors to fixed values\n      this.oldAsyncProps = Object.create(this.oldProps);\n      for (const propName in this.asyncProps) {\n        Object.defineProperty(this.oldAsyncProps, propName, {\n          enumerable: true,\n          value: this.oldProps[propName]\n        });\n      }\n    }\n  }\n\n  // Checks if an input value actually changed (to avoid reloading/rewatching promises/urls)\n  private _didAsyncInputValueChange(propName: string, value: any): boolean {\n    // @ts-ignore\n    const asyncProp: AsyncPropState = this.asyncProps[propName];\n    if (value === asyncProp.resolvedValue || value === asyncProp.lastValue) {\n      return false;\n    }\n    asyncProp.lastValue = value;\n    return true;\n  }\n\n  // Set normal, non-async value\n  private _setPropValue(propName: string, value: any) {\n    // Save the current value before overwriting so that diffProps can access both\n    this._freezeAsyncOldProps();\n\n    const asyncProp = this.asyncProps[propName];\n    if (asyncProp) {\n      value = this._postProcessValue(asyncProp, value);\n      asyncProp.resolvedValue = value;\n      asyncProp.pendingLoadCount++;\n      asyncProp.resolvedLoadCount = asyncProp.pendingLoadCount;\n    }\n  }\n\n  // Set a just resolved async value, calling onAsyncPropUpdates if value changes asynchronously\n  private _setAsyncPropValue(propName: string, value: any, loadCount: number) {\n    // Only update if loadCount is larger or equal to resolvedLoadCount\n    // otherwise a more recent load has already completed\n    const asyncProp = this.asyncProps[propName];\n    if (asyncProp && loadCount >= asyncProp.resolvedLoadCount && value !== undefined) {\n      // Save the current value before overwriting so that diffProps can access both\n      this._freezeAsyncOldProps();\n\n      asyncProp.resolvedValue = value;\n      asyncProp.resolvedLoadCount = loadCount;\n\n      // Call callback to inform listener\n      this.onAsyncPropUpdated(propName, value);\n    }\n  }\n\n  // Tracks a promise, sets the prop when loaded, handles load count\n  private _watchPromise(propName: string, promise: Promise<any>) {\n    const asyncProp = this.asyncProps[propName];\n    if (asyncProp) {\n      asyncProp.pendingLoadCount++;\n      const loadCount = asyncProp.pendingLoadCount;\n      promise\n        .then(data => {\n          data = this._postProcessValue(asyncProp, data);\n          this._setAsyncPropValue(propName, data, loadCount);\n          this._onResolve(propName, data);\n        })\n        .catch(error => {\n          this._onError(propName, error);\n        });\n    }\n  }\n\n  private async _resolveAsyncIterable(\n    propName: string,\n    iterable: AsyncIterable<any>\n  ): Promise<void> {\n    if (propName !== 'data') {\n      // we only support data as async iterable\n      this._setPropValue(propName, iterable);\n      return;\n    }\n\n    const asyncProp = this.asyncProps[propName];\n    if (!asyncProp) {\n      return;\n    }\n\n    asyncProp.pendingLoadCount++;\n    const loadCount = asyncProp.pendingLoadCount;\n    let data: any[] = [];\n    let count = 0;\n\n    for await (const chunk of iterable) {\n      // @ts-expect-error (2339) dataTransform is not decared in base component props\n      const {dataTransform} = this.component.props;\n      if (dataTransform) {\n        data = dataTransform(chunk, data) as any[];\n      } else {\n        data = data.concat(chunk);\n      }\n\n      // Used by the default _dataDiff function\n      Object.defineProperty(data, '__diff', {\n        enumerable: false,\n        value: [{startRow: count, endRow: data.length}]\n      });\n\n      count = data.length;\n      this._setAsyncPropValue(propName, data, loadCount);\n    }\n\n    this._onResolve(propName, data);\n  }\n\n  // Give the app a chance to post process the loaded data\n  private _postProcessValue(asyncProp, value: any) {\n    const propType = asyncProp.type;\n    if (propType) {\n      if (propType.release) {\n        propType.release(asyncProp.resolvedValue, propType, this.component);\n      }\n      if (propType.transform) {\n        return propType.transform(value, propType, this.component);\n      }\n    }\n    return value;\n  }\n\n  // Creating an asyncProp record if needed\n  private _createAsyncPropData(propName: string, defaultValue: any) {\n    const asyncProp = this.asyncProps[propName];\n    if (!asyncProp) {\n      // @ts-expect-error\n      const propTypes = this.component && this.component.constructor._propTypes;\n      // assert(defaultValue !== undefined);\n      this.asyncProps[propName] = {\n        type: propTypes && propTypes[propName],\n        lastValue: null, // Supplied prop value (can be url/promise, not visible to layer)\n        resolvedValue: defaultValue, // Resolved prop value (valid data, can be \"shown\" to layer)\n        pendingLoadCount: 0, // How many loads have been issued\n        resolvedLoadCount: 0 // Latest resolved load, (earlier loads will be ignored)\n      };\n    }\n  }\n}\n","import ComponentState from '../lifecycle/component-state';\n\nimport type Layer from './layer';\nimport type AttributeManager from './attribute/attribute-manager';\nimport type Viewport from '../viewports/viewport';\nimport type UniformTransitionManager from './uniform-transition-manager';\n\nexport type ChangeFlags = {\n  // Primary changeFlags, can be strings stating reason for change\n  dataChanged: string | false | {startRow: number; endRow?: number}[];\n  propsChanged: string | false;\n  updateTriggersChanged: Record<string, true> | false;\n  extensionsChanged: boolean;\n  viewportChanged: boolean;\n  stateChanged: boolean;\n\n  // Derived changeFlags\n  propsOrDataChanged: boolean;\n  somethingChanged: boolean;\n};\n\nexport default class LayerState<LayerT extends Layer> extends ComponentState<LayerT> {\n  attributeManager: AttributeManager | null;\n  needsRedraw: boolean;\n  needsUpdate: boolean;\n  /**\n   * Sublayers rendered in a previous cycle\n   */\n  subLayers: Layer[] | null;\n  /**\n   * If the layer is using the shared instancedPickingColors buffer\n   */\n  usesPickingColorCache: boolean;\n  /**\n   * Dirty flags of the layer's props and state\n   */\n  changeFlags!: ChangeFlags;\n\n  /** The last viewport rendered by this layer */\n  viewport?: Viewport;\n\n  uniformTransitions!: UniformTransitionManager;\n  /** Populated during uniform transition to replace user-supplied values */\n  propsInTransition?: LayerT['props'];\n\n  constructor({\n    attributeManager,\n    layer\n  }: {\n    attributeManager: AttributeManager | null;\n    layer: LayerT;\n  }) {\n    super(layer);\n    this.attributeManager = attributeManager;\n    this.needsRedraw = true;\n    this.needsUpdate = true;\n    this.subLayers = null;\n    this.usesPickingColorCache = false;\n  }\n\n  get layer(): LayerT {\n    return this.component;\n  }\n\n  set layer(layer: LayerT) {\n    this.component = layer;\n  }\n\n  /* Override base Component methods with Layer-specific handling */\n\n  protected _fetch(propName, url: string) {\n    const fetch = this.component.props.fetch;\n    if (fetch) {\n      return fetch(url, {propName, layer: this.layer});\n    }\n    return super._fetch(propName, url);\n  }\n\n  protected _onResolve(propName: string, value: any) {\n    const onDataLoad = this.component.props.onDataLoad;\n    if (propName === 'data' && onDataLoad) {\n      onDataLoad(value, {propName, layer: this.layer});\n    }\n  }\n\n  protected _onError(propName: string, error: Error) {\n    this.layer.raiseError(error, `loading ${propName} of ${this.layer}`);\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n/* eslint-disable react/no-direct-mutation-state */\nimport {COORDINATE_SYSTEM, OPERATION} from './constants';\nimport AttributeManager from './attribute/attribute-manager';\nimport UniformTransitionManager from './uniform-transition-manager';\nimport {diffProps, validateProps} from '../lifecycle/props';\nimport {LIFECYCLE, Lifecycle} from '../lifecycle/constants';\nimport {count} from '../utils/count';\nimport log from '../utils/log';\nimport debug from '../debug';\nimport GL from '@luma.gl/constants';\nimport {withParameters, setParameters} from '@luma.gl/core';\nimport assert from '../utils/assert';\nimport memoize from '../utils/memoize';\nimport {mergeShaders} from '../utils/shader';\nimport {projectPosition, getWorldPosition} from '../shaderlib/project/project-functions';\nimport typedArrayManager from '../utils/typed-array-manager';\n\nimport Component from '../lifecycle/component';\nimport LayerState, {ChangeFlags} from './layer-state';\n\nimport {worldToPixels} from '@math.gl/web-mercator';\n\nimport {load} from '@loaders.gl/core';\n\nimport type {Loader} from '@loaders.gl/loader-utils';\nimport type {CoordinateSystem} from './constants';\nimport type Attribute from './attribute/attribute';\nimport type {Model} from '@luma.gl/engine';\nimport type {PickingInfo, GetPickingInfoParams} from './picking/pick-info';\nimport type Viewport from '../viewports/viewport';\nimport type {NumericArray} from '../types/types';\nimport type {DefaultProps} from '../lifecycle/prop-types';\nimport type {LayerProps} from '../types/layer-props';\nimport type {LayerContext} from './layer-manager';\n\nconst TRACE_CHANGE_FLAG = 'layer.changeFlag';\nconst TRACE_INITIALIZE = 'layer.initialize';\nconst TRACE_UPDATE = 'layer.update';\nconst TRACE_FINALIZE = 'layer.finalize';\nconst TRACE_MATCHED = 'layer.matched';\n\nconst MAX_PICKING_COLOR_CACHE_SIZE = 2 ** 24 - 1;\n\nconst EMPTY_ARRAY = Object.freeze([]);\n\n// Only compare the same two viewports once\nconst areViewportsEqual = memoize(\n  ({oldViewport, viewport}: {oldViewport: Viewport; viewport: Viewport}): boolean => {\n    return oldViewport.equals(viewport);\n  }\n);\n\nlet pickingColorCache = new Uint8ClampedArray(0);\n\nconst defaultProps: DefaultProps<LayerProps> = {\n  // data: Special handling for null, see below\n  data: {type: 'data', value: EMPTY_ARRAY, async: true},\n  dataComparator: {type: 'function', value: null, compare: false, optional: true},\n  _dataDiff: {\n    type: 'function',\n    // @ts-ignore __diff is not defined on data\n    value: data => data && data.__diff,\n    compare: false,\n    optional: true\n  },\n  dataTransform: {type: 'function', value: null, compare: false, optional: true},\n  onDataLoad: {type: 'function', value: null, compare: false, optional: true},\n  onError: {type: 'function', value: null, compare: false, optional: true},\n  fetch: {\n    type: 'function',\n    value: <LayerT extends Layer>(\n      url: string,\n      {\n        propName,\n        layer,\n        loaders,\n        loadOptions,\n        signal\n      }: {\n        propName: string;\n        layer: LayerT;\n        loaders?: Loader[];\n        loadOptions?: any;\n        signal?: AbortSignal;\n      }\n    ) => {\n      const {resourceManager} = layer.context;\n      loadOptions = loadOptions || layer.getLoadOptions();\n      loaders = loaders || layer.props.loaders;\n      if (signal) {\n        loadOptions = {\n          ...loadOptions,\n          fetch: {\n            ...loadOptions?.fetch,\n            signal\n          }\n        };\n      }\n\n      let inResourceManager = resourceManager.contains(url);\n\n      if (!inResourceManager && !loadOptions) {\n        // If there is no layer-specific load options, then attempt to cache this resource in the data manager\n        resourceManager.add({resourceId: url, data: load(url, loaders), persistent: false});\n        inResourceManager = true;\n      }\n      if (inResourceManager) {\n        return resourceManager.subscribe({\n          resourceId: url,\n          onChange: data => layer.internalState?.reloadAsyncProp(propName, data),\n          consumerId: layer.id,\n          requestId: propName\n        });\n      }\n\n      return load(url, loaders, loadOptions);\n    },\n    compare: false\n  },\n  updateTriggers: {}, // Update triggers: a core change detection mechanism in deck.gl\n\n  visible: true,\n  pickable: false,\n  opacity: {type: 'number', min: 0, max: 1, value: 1},\n  operation: OPERATION.DRAW,\n\n  onHover: {type: 'function', value: null, compare: false, optional: true},\n  onClick: {type: 'function', value: null, compare: false, optional: true},\n  onDragStart: {type: 'function', value: null, compare: false, optional: true},\n  onDrag: {type: 'function', value: null, compare: false, optional: true},\n  onDragEnd: {type: 'function', value: null, compare: false, optional: true},\n\n  coordinateSystem: COORDINATE_SYSTEM.DEFAULT,\n  coordinateOrigin: {type: 'array', value: [0, 0, 0], compare: true},\n  modelMatrix: {type: 'array', value: null, compare: true, optional: true},\n  wrapLongitude: false,\n  positionFormat: 'XYZ',\n  colorFormat: 'RGBA',\n\n  parameters: {type: 'object', value: {}, optional: true, compare: true},\n  transitions: null,\n  extensions: [],\n  loaders: {type: 'array', value: [], optional: true, compare: true},\n\n  // Offset depth based on layer index to avoid z-fighting.\n  // Negative values pull layer towards the camera\n  // https://www.opengl.org/archives/resources/faq/technical/polygonoffset.htm\n  getPolygonOffset: {\n    type: 'function',\n    value: ({layerIndex}) => [0, -layerIndex * 100],\n    compare: false\n  },\n\n  // Selection/Highlighting\n  highlightedObjectIndex: null,\n  autoHighlight: false,\n  highlightColor: {type: 'accessor', value: [0, 0, 128, 128]}\n};\n\nexport type UpdateParameters<LayerT extends Layer> = {\n  props: LayerT['props'];\n  oldProps: LayerT['props'];\n  context: LayerContext;\n  changeFlags: ChangeFlags;\n};\n\nexport default abstract class Layer<PropsT = {}> extends Component<PropsT & Required<LayerProps>> {\n  static defaultProps = defaultProps;\n  static layerName: string = 'Layer';\n\n  internalState: LayerState<this> | null = null;\n  lifecycle: Lifecycle = LIFECYCLE.NO_STATE; // Helps track and debug the life cycle of the layers\n\n  // context and state can technically be null before a layer is initialized/matched.\n  // However, they are most extensively accessed in a layer's lifecycle methods, where they are always defined.\n  // Checking for null state constantly in layer implementation is unnecessarily verbose.\n  context!: LayerContext; // Will reference layer manager's context, contains state shared by layers\n  state!: Record<string, any>; // Will be set to the shared layer state object during layer matching\n\n  parent: Layer | null = null;\n\n  get root(): Layer {\n    // eslint-disable-next-line\n    let layer: Layer = this;\n    while (layer.parent) {\n      layer = layer.parent;\n    }\n    return layer;\n  }\n\n  toString(): string {\n    const className = (this.constructor as typeof Layer).layerName || this.constructor.name;\n    return `${className}({id: '${this.props.id}'})`;\n  }\n\n  // Public API for users\n\n  /** Projects a point with current view state from the current layer's coordinate system to screen */\n  project(xyz: number[]): number[] {\n    assert(this.internalState);\n    const viewport = this.internalState.viewport || this.context.viewport;\n\n    const worldPosition = getWorldPosition(xyz, {\n      viewport,\n      modelMatrix: this.props.modelMatrix,\n      coordinateOrigin: this.props.coordinateOrigin,\n      coordinateSystem: this.props.coordinateSystem\n    });\n    const [x, y, z] = worldToPixels(worldPosition, viewport.pixelProjectionMatrix);\n    return xyz.length === 2 ? [x, y] : [x, y, z];\n  }\n\n  /** Unprojects a screen pixel to the current view's default coordinate system\n      Note: this does not reverse `project`. */\n  unproject(xy: number[]): number[] {\n    assert(this.internalState);\n    const viewport = this.internalState.viewport || this.context.viewport;\n    return viewport.unproject(xy);\n  }\n\n  /** Projects a point with current view state from the current layer's coordinate system to the world space */\n  projectPosition(\n    xyz: number[],\n    params?: {\n      /** The viewport to use */\n      viewport?: Viewport;\n      /** The coordinate system that the supplied position is in. Default to the same as `coordinateSystem`. */\n      fromCoordinateSystem?: CoordinateSystem;\n      /** The coordinate origin that the supplied position is in. Default to the same as `coordinateOrigin`. */\n      fromCoordinateOrigin?: [number, number, number];\n    }\n  ): [number, number, number] {\n    assert(this.internalState);\n    const viewport = this.internalState.viewport || this.context.viewport;\n\n    return projectPosition(xyz, {\n      viewport,\n      modelMatrix: this.props.modelMatrix,\n      coordinateOrigin: this.props.coordinateOrigin,\n      coordinateSystem: this.props.coordinateSystem,\n      ...params\n    });\n  }\n\n  // Public API for custom layer implementation\n\n  /** `true` if this layer renders other layers */\n  get isComposite(): boolean {\n    return false;\n  }\n\n  /** Updates selected state members and marks the layer for redraw */\n  setState(partialState: any): void {\n    this.setChangeFlags({stateChanged: true});\n    Object.assign(this.state, partialState);\n    this.setNeedsRedraw();\n  }\n\n  /** Sets the redraw flag for this layer, will trigger a redraw next animation frame */\n  setNeedsRedraw(): void {\n    if (this.internalState) {\n      this.internalState.needsRedraw = true;\n    }\n  }\n\n  /** Mark this layer as needs a deep update */\n  setNeedsUpdate() {\n    if (this.internalState) {\n      this.context.layerManager.setNeedsUpdate(String(this));\n      this.internalState.needsUpdate = true;\n    }\n  }\n\n  /** Returns true if all async resources are loaded */\n  get isLoaded(): boolean {\n    return this.internalState ? !this.internalState.isAsyncPropLoading() : false;\n  }\n\n  /** Returns true if using shader-based WGS84 longitude wrapping */\n  get wrapLongitude(): boolean {\n    return this.props.wrapLongitude;\n  }\n\n  /** Returns true if the layer is visible in the picking pass */\n  isPickable(): boolean {\n    return this.props.pickable && this.props.visible;\n  }\n\n  /** Returns an array of models used by this layer, can be overriden by layer subclass */\n  getModels(): Model[] {\n    return (this.state && (this.state.models || (this.state.model && [this.state.model]))) || [];\n  }\n\n  /** Update shader module parameters */\n  setModuleParameters(moduleParameters: any): void {\n    for (const model of this.getModels()) {\n      model.updateModuleSettings(moduleParameters);\n    }\n  }\n\n  /** Returns the attribute manager of this layer */\n  getAttributeManager(): AttributeManager | null {\n    return this.internalState && this.internalState.attributeManager;\n  }\n\n  /** Returns the most recent layer that matched to this state\n    (When reacting to an async event, this layer may no longer be the latest) */\n  getCurrentLayer(): Layer<PropsT> | null {\n    return this.internalState && this.internalState.layer;\n  }\n\n  /** Returns the default parse options for async props */\n  getLoadOptions(): any {\n    return this.props.loadOptions;\n  }\n\n  use64bitPositions(): boolean {\n    const {coordinateSystem} = this.props;\n    return (\n      coordinateSystem === COORDINATE_SYSTEM.DEFAULT ||\n      coordinateSystem === COORDINATE_SYSTEM.LNGLAT ||\n      coordinateSystem === COORDINATE_SYSTEM.CARTESIAN\n    );\n  }\n\n  // Event handling\n  onHover(info: PickingInfo, pickingEvent): boolean {\n    if (this.props.onHover) {\n      return this.props.onHover(info, pickingEvent) || false;\n    }\n    return false;\n  }\n\n  onClick(info: PickingInfo, pickingEvent): boolean {\n    if (this.props.onClick) {\n      return this.props.onClick(info, pickingEvent) || false;\n    }\n    return false;\n  }\n\n  // Returns the picking color that doesn't match any subfeature\n  // Use if some graphics do not belong to any pickable subfeature\n  // @return {Array} - a black color\n  nullPickingColor() {\n    return [0, 0, 0];\n  }\n\n  // Returns the picking color that doesn't match any subfeature\n  // Use if some graphics do not belong to any pickable subfeature\n  encodePickingColor(i, target: number[] = []): number[] {\n    target[0] = (i + 1) & 255;\n    target[1] = ((i + 1) >> 8) & 255;\n    target[2] = (((i + 1) >> 8) >> 8) & 255;\n    return target;\n  }\n\n  // Returns the index corresponding to a picking color that doesn't match any subfeature\n  // @param {Uint8Array} color - color array to be decoded\n  // @return {Array} - the decoded picking color\n  decodePickingColor(color) {\n    assert(color instanceof Uint8Array);\n    const [i1, i2, i3] = color;\n    // 1 was added to seperate from no selection\n    const index = i1 + i2 * 256 + i3 * 65536 - 1;\n    return index;\n  }\n\n  /** Deduces number of instances. Intention is to support:\n    - Explicit setting of numInstances\n    - Auto-deduction for ES6 containers that define a size member\n    - Auto-deduction for Classic Arrays via the built-in length attribute\n    - Auto-deduction via arrays */\n  getNumInstances(): number {\n    // First Check if app has provided an explicit value\n    if (Number.isFinite(this.props.numInstances)) {\n      return this.props.numInstances as number;\n    }\n\n    // Second check if the layer has set its own value\n    if (this.state && this.state.numInstances !== undefined) {\n      return this.state.numInstances;\n    }\n\n    // Use container library to get a count for any ES6 container or object\n    return count(this.props.data);\n  }\n\n  /** Buffer layout describes how many attribute values are packed for each data object\n      The default (null) is one value each object.\n      Some data formats (e.g. paths, polygons) have various length. Their buffer layout\n      is in the form of [L0, L1, L2, ...] */\n  getStartIndices(): NumericArray | null {\n    // First Check if startIndices is provided as an explicit value\n    if (this.props.startIndices) {\n      return this.props.startIndices;\n    }\n\n    // Second check if the layer has set its own value\n    if (this.state && this.state.startIndices) {\n      return this.state.startIndices;\n    }\n\n    return null;\n  }\n\n  // Default implementation\n  // Sublayers chould override this method to provide an accurate calculation of the bounds\n  getBounds(): [number[], number[]] | null {\n    const attributeManager = this.getAttributeManager();\n    if (!attributeManager) return null;\n    const {positions, instancePositions} = attributeManager.attributes;\n    return (positions || instancePositions)?.getBounds();\n  }\n\n  // / LIFECYCLE METHODS - overridden by the layer subclasses\n\n  /** Called once to set up the initial state. Layers can create WebGL resources here. */\n  abstract initializeState(context: LayerContext): void;\n\n  getShaders(shaders: any): any {\n    for (const extension of this.props.extensions) {\n      shaders = mergeShaders(shaders, extension.getShaders.call(this, extension));\n    }\n    return shaders;\n  }\n\n  /** Controls if updateState should be called. By default returns true if any prop has changed */\n  shouldUpdateState(params: UpdateParameters<Layer<PropsT>>): boolean {\n    return params.changeFlags.propsOrDataChanged;\n  }\n\n  /* eslint-disable-next-line complexity */\n  /** Default implementation, all attributes will be invalidated and updated when data changes */\n  updateState(params: UpdateParameters<Layer<PropsT>>): void {\n    const attributeManager = this.getAttributeManager();\n    const {dataChanged} = params.changeFlags;\n    if (dataChanged && attributeManager) {\n      if (Array.isArray(dataChanged)) {\n        // is partial update\n        for (const dataRange of dataChanged) {\n          attributeManager.invalidateAll(dataRange);\n        }\n      } else {\n        attributeManager.invalidateAll();\n      }\n    }\n\n    const {props, oldProps} = params;\n    const neededPickingBuffer =\n      Number.isInteger(oldProps.highlightedObjectIndex) || oldProps.pickable;\n    const needPickingBuffer = Number.isInteger(props.highlightedObjectIndex) || props.pickable;\n    if (neededPickingBuffer !== needPickingBuffer && attributeManager) {\n      const {pickingColors, instancePickingColors} = attributeManager.attributes;\n      const pickingColorsAttribute = pickingColors || instancePickingColors;\n      if (pickingColorsAttribute) {\n        if (needPickingBuffer && pickingColorsAttribute.constant) {\n          pickingColorsAttribute.constant = false;\n          attributeManager.invalidate(pickingColorsAttribute.id);\n        }\n        if (!pickingColorsAttribute.value && !needPickingBuffer) {\n          pickingColorsAttribute.constant = true;\n          pickingColorsAttribute.value = [0, 0, 0];\n        }\n      }\n    }\n  }\n\n  /** Called once when layer is no longer matched and state will be discarded. Layers can destroy WebGL resources here. */\n  finalizeState(context: LayerContext): void {\n    for (const model of this.getModels()) {\n      model.delete();\n    }\n    const attributeManager = this.getAttributeManager();\n    if (attributeManager) {\n      attributeManager.finalize();\n    }\n    if (this.context) {\n      this.context.resourceManager.unsubscribe({consumerId: this.id});\n    }\n    if (this.internalState) {\n      this.internalState.uniformTransitions.clear();\n      this.internalState.finalize();\n    }\n  }\n\n  // If state has a model, draw it with supplied uniforms\n  draw(opts) {\n    for (const model of this.getModels()) {\n      model.draw(opts);\n    }\n  }\n\n  // called to populate the info object that is passed to the event handler\n  // @return null to cancel event\n  getPickingInfo({info, mode, sourceLayer}: GetPickingInfoParams) {\n    const {index} = info;\n\n    if (index >= 0) {\n      // If props.data is an indexable array, get the object\n      if (Array.isArray(this.props.data)) {\n        info.object = this.props.data[index];\n      }\n    }\n\n    return info;\n  }\n\n  // END LIFECYCLE METHODS\n\n  // / INTERNAL METHODS - called by LayerManager, DeckRenderer and DeckPicker\n\n  /** (Internal) Propagate an error event through the system */\n  raiseError(error: Error, message: string): void {\n    if (message) {\n      error.message = `${message}: ${error.message}`;\n    }\n    if (!this.props.onError?.(error)) {\n      this.context?.onError?.(error, this);\n    }\n  }\n\n  /** (Internal) Checks if this layer needs redraw */\n  getNeedsRedraw(\n    opts: {\n      /** Reset redraw flags to false after the check */\n      clearRedrawFlags: boolean;\n    } = {clearRedrawFlags: false}\n  ): string | false {\n    return this._getNeedsRedraw(opts);\n  }\n\n  /** (Internal) Checks if this layer needs a deep update */\n  needsUpdate(): boolean {\n    if (!this.internalState) {\n      return false;\n    }\n\n    // Call subclass lifecycle method\n    return (\n      this.internalState.needsUpdate ||\n      this.hasUniformTransition() ||\n      this.shouldUpdateState(this._getUpdateParams())\n    );\n    // End lifecycle method\n  }\n\n  /** Checks if this layer has ongoing uniform transition */\n  hasUniformTransition(): boolean {\n    return this.internalState?.uniformTransitions.active || false;\n  }\n\n  /** Called when this layer is rendered into the given viewport */\n  activateViewport(viewport: Viewport): void {\n    if (!this.internalState) {\n      return;\n    }\n\n    const oldViewport = this.internalState.viewport;\n    this.internalState.viewport = viewport;\n\n    if (!oldViewport || !areViewportsEqual({oldViewport, viewport})) {\n      this.setChangeFlags({viewportChanged: true});\n\n      if (this.isComposite) {\n        if (this.needsUpdate()) {\n          // Composite layers may add/remove sublayers on viewport change\n          // Because we cannot change the layers list during a draw cycle, we don't want to update sublayers right away\n          // This will not call update immediately, but mark the layerManager as needs update on the next frame\n          this.setNeedsUpdate();\n        }\n      } else {\n        this._update();\n      }\n    }\n  }\n\n  /** Default implementation of attribute invalidation, can be redefined */\n  protected invalidateAttribute(name = 'all'): void {\n    const attributeManager = this.getAttributeManager();\n    if (!attributeManager) {\n      return;\n    }\n\n    if (name === 'all') {\n      attributeManager.invalidateAll();\n    } else {\n      attributeManager.invalidate(name);\n    }\n  }\n\n  /** Send updated attributes to the WebGL model */\n  protected updateAttributes(changedAttributes: {[id: string]: Attribute}) {\n    for (const model of this.getModels()) {\n      this._setModelAttributes(model, changedAttributes);\n    }\n  }\n\n  /** Recalculate any attributes if needed */\n  protected _updateAttributes(): void {\n    const attributeManager = this.getAttributeManager();\n    if (!attributeManager) {\n      return;\n    }\n    const props = this.props;\n\n    // Figure out data length\n    const numInstances = this.getNumInstances();\n    const startIndices = this.getStartIndices();\n\n    attributeManager.update({\n      data: props.data,\n      numInstances,\n      startIndices,\n      props,\n      transitions: props.transitions,\n      // @ts-ignore (TS2339) property attribute is not present on some acceptable data types\n      buffers: props.data.attributes,\n      context: this\n    });\n\n    const changedAttributes = attributeManager.getChangedAttributes({clearChangedFlags: true});\n    this.updateAttributes(changedAttributes);\n  }\n\n  /** Update attribute transitions. This is called in drawLayer, no model updates required. */\n  private _updateAttributeTransition() {\n    const attributeManager = this.getAttributeManager();\n    if (attributeManager) {\n      attributeManager.updateTransition();\n    }\n  }\n\n  /** Update uniform (prop) transitions. This is called in updateState, may result in model updates. */\n  private _updateUniformTransition(): Layer<PropsT>['props'] {\n    // @ts-ignore (TS2339) internalState is alwasy defined when this method is called\n    const {uniformTransitions} = this.internalState;\n    if (uniformTransitions.active) {\n      // clone props\n      const propsInTransition = uniformTransitions.update();\n      const props = Object.create(this.props);\n      for (const key in propsInTransition) {\n        Object.defineProperty(props, key, {value: propsInTransition[key]});\n      }\n      return props;\n    }\n    return this.props;\n  }\n\n  /** Updater for the automatically populated instancePickingColors attribute */\n  protected calculateInstancePickingColors(\n    attribute: Attribute,\n    {numInstances}: {numInstances: number}\n  ) {\n    if (attribute.constant) {\n      return;\n    }\n\n    // calculateInstancePickingColors always generates the same sequence.\n    // pickingColorCache saves the largest generated sequence for reuse\n    const cacheSize = Math.floor(pickingColorCache.length / 3);\n\n    // Record when using the picking buffer cache, so that layers can always point at the most recently allocated cache\n    // @ts-ignore (TS2531) internalState is always defined when this method is called\n    this.internalState.usesPickingColorCache = true;\n\n    if (cacheSize < numInstances) {\n      if (numInstances > MAX_PICKING_COLOR_CACHE_SIZE) {\n        log.warn(\n          'Layer has too many data objects. Picking might not be able to distinguish all objects.'\n        )();\n      }\n\n      pickingColorCache = typedArrayManager.allocate(pickingColorCache, numInstances, {\n        size: 3,\n        copy: true,\n        maxCount: Math.max(numInstances, MAX_PICKING_COLOR_CACHE_SIZE)\n      });\n\n      // If the attribute is larger than the cache, resize the cache and populate the missing chunk\n      const newCacheSize = Math.floor(pickingColorCache.length / 3);\n      const pickingColor = [];\n      for (let i = cacheSize; i < newCacheSize; i++) {\n        this.encodePickingColor(i, pickingColor);\n        pickingColorCache[i * 3 + 0] = pickingColor[0];\n        pickingColorCache[i * 3 + 1] = pickingColor[1];\n        pickingColorCache[i * 3 + 2] = pickingColor[2];\n      }\n    }\n\n    attribute.value = pickingColorCache.subarray(0, numInstances * 3);\n  }\n\n  /** Apply changed attributes to  */\n  protected _setModelAttributes(\n    model: Model,\n    changedAttributes: {\n      [id: string]: Attribute;\n    }\n  ) {\n    const attributeManager = this.getAttributeManager();\n    // @ts-ignore luma.gl type issue\n    const excludeAttributes = model.userData.excludeAttributes || {};\n    // @ts-ignore (TS2531) this method is only called internally with attributeManager defined\n    const shaderAttributes = attributeManager.getShaderAttributes(\n      changedAttributes,\n      excludeAttributes\n    );\n\n    model.setAttributes(shaderAttributes);\n  }\n\n  /** (Internal) Sets the picking color at the specified index to null picking color. Used for multi-depth picking.\n     This method may be overriden by layer implementations */\n  disablePickingIndex(objectIndex: number): void {\n    this._disablePickingIndex(objectIndex);\n  }\n\n  // TODO - simplify subclassing interface\n  protected _disablePickingIndex(objectIndex: number): void {\n    // @ts-ignore (TS2531) this method is only called internally with attributeManager defined\n    const {pickingColors, instancePickingColors} = this.getAttributeManager().attributes;\n    const colors = pickingColors || instancePickingColors;\n    if (!colors) {\n      return;\n    }\n\n    const start = colors.getVertexOffset(objectIndex);\n    const end = colors.getVertexOffset(objectIndex + 1);\n\n    // Fill the sub buffer with 0s\n    colors.buffer.subData({\n      data: new Uint8Array(end - start),\n      offset: start // 1 byte per element\n    });\n  }\n\n  /** (Internal) Re-enable all picking indices after multi-depth picking */\n  restorePickingColors(): void {\n    // @ts-ignore (TS2531) this method is only called internally with attributeManager defined\n    const {pickingColors, instancePickingColors} = this.getAttributeManager().attributes;\n    const colors = pickingColors || instancePickingColors;\n    if (!colors) {\n      return;\n    }\n    // The picking color cache may have been freed and then reallocated. This ensures we read from the currently allocated cache.\n    if (\n      // @ts-ignore (TS2531) this method is only called internally with internalState defined\n      this.internalState.usesPickingColorCache &&\n      (colors.value as Uint8ClampedArray).buffer !== pickingColorCache.buffer\n    ) {\n      colors.value = pickingColorCache.subarray(0, (colors.value as Uint8ClampedArray).length);\n    }\n    colors.updateSubBuffer({startOffset: 0});\n  }\n\n  /* eslint-disable max-statements */\n  /* (Internal) Called by layer manager when a new layer is found */\n  _initialize() {\n    assert(!this.internalState); // finalized layer cannot be reused\n    assert(Number.isFinite(this.props.coordinateSystem)); // invalid coordinateSystem\n\n    debug(TRACE_INITIALIZE, this);\n\n    const attributeManager = this._getAttributeManager();\n\n    if (attributeManager) {\n      // All instanced layers get instancePickingColors attribute by default\n      // Their shaders can use it to render a picking scene\n      // TODO - this slightly slows down non instanced layers\n      attributeManager.addInstanced({\n        instancePickingColors: {\n          type: GL.UNSIGNED_BYTE,\n          size: 3,\n          noAlloc: true,\n          // Updaters are always called with `this` pointing to the layer\n          // eslint-disable-next-line @typescript-eslint/unbound-method\n          update: this.calculateInstancePickingColors\n        }\n      });\n    }\n\n    this.internalState = new LayerState<this>({\n      attributeManager,\n      layer: this\n    });\n    this._clearChangeFlags(); // populate this.internalState.changeFlags\n\n    this.state = {};\n    // for backwards compatibility with older layers\n    // TODO - remove in next release\n    /* eslint-disable accessor-pairs */\n    Object.defineProperty(this.state, 'attributeManager', {\n      get: () => {\n        log.deprecated('layer.state.attributeManager', 'layer.getAttributeManager()')();\n        return attributeManager;\n      }\n    });\n    /* eslint-enable accessor-pairs */\n\n    this.internalState.layer = this;\n    this.internalState.uniformTransitions = new UniformTransitionManager(this.context.timeline);\n    this.internalState.onAsyncPropUpdated = this._onAsyncPropUpdated.bind(this);\n\n    // Ensure any async props are updated\n    this.internalState.setAsyncProps(this.props);\n\n    // Call subclass lifecycle methods\n    this.initializeState(this.context);\n\n    // Initialize extensions\n    for (const extension of this.props.extensions) {\n      extension.initializeState.call(this, this.context, extension);\n    }\n    // End subclass lifecycle methods\n\n    // initializeState callback tends to clear state\n    this.setChangeFlags({\n      dataChanged: 'init',\n      propsChanged: 'init',\n      viewportChanged: true,\n      extensionsChanged: true\n    });\n\n    this._update();\n  }\n\n  /** (Internal) Called by layer manager to transfer state from an old layer */\n  _transferState(oldLayer: Layer<PropsT>): void {\n    debug(TRACE_MATCHED, this, this === oldLayer);\n\n    const {state, internalState} = oldLayer;\n\n    if (this === oldLayer) {\n      return;\n    }\n\n    // Move internalState\n    this.internalState = internalState as LayerState<this>;\n    this.internalState.layer = this;\n\n    // Move state\n    this.state = state;\n    // We keep the state ref on old layers to support async actions\n    // oldLayer.state = null;\n\n    // Ensure any async props are updated\n    this.internalState.setAsyncProps(this.props);\n\n    this._diffProps(this.props, this.internalState.getOldProps() as Layer<PropsT>['props']);\n  }\n\n  /** (Internal) Called by layer manager when a new layer is added or an existing layer is matched with a new instance */\n  _update(): void {\n    // Call subclass lifecycle method\n    const stateNeedsUpdate = this.needsUpdate();\n    // End lifecycle method\n    debug(TRACE_UPDATE, this, stateNeedsUpdate);\n\n    if (!stateNeedsUpdate) {\n      return;\n    }\n\n    const currentProps = this.props;\n    const context = this.context;\n    const internalState = this.internalState as LayerState<this>;\n\n    const currentViewport = context.viewport;\n    const propsInTransition = this._updateUniformTransition();\n    internalState.propsInTransition = propsInTransition;\n    // Overwrite this.context.viewport during update to use the last activated viewport on this layer\n    // In multi-view applications, a layer may only be drawn in one of the views\n    // Which would make the \"active\" viewport different from the shared context\n    context.viewport = internalState.viewport || currentViewport;\n    // Overwrite this.props during update to use in-transition prop values\n    this.props = propsInTransition;\n\n    try {\n      const updateParams = this._getUpdateParams();\n      const oldModels = this.getModels();\n\n      // Safely call subclass lifecycle methods\n      if (context.gl) {\n        this.updateState(updateParams);\n      } else {\n        try {\n          this.updateState(updateParams);\n        } catch (error) {\n          // ignore error if gl context is missing\n        }\n      }\n      // Execute extension updates\n      for (const extension of this.props.extensions) {\n        extension.updateState.call(this, updateParams, extension);\n      }\n\n      const modelChanged = this.getModels()[0] !== oldModels[0];\n      this._postUpdate(updateParams, modelChanged);\n      // End subclass lifecycle methods\n    } finally {\n      // Restore shared context\n      context.viewport = currentViewport;\n      this.props = currentProps;\n      this._clearChangeFlags();\n      internalState.needsUpdate = false;\n      internalState.resetOldProps();\n    }\n  }\n  /* eslint-enable max-statements */\n\n  /** (Internal) Called by manager when layer is about to be disposed \n      Note: not guaranteed to be called on application shutdown */\n  _finalize(): void {\n    debug(TRACE_FINALIZE, this);\n\n    // Call subclass lifecycle method\n    this.finalizeState(this.context);\n    // Finalize extensions\n    for (const extension of this.props.extensions) {\n      extension.finalizeState.call(this, extension);\n    }\n  }\n\n  // Calculates uniforms\n  _drawLayer({\n    moduleParameters = null,\n    uniforms = {},\n    parameters = {}\n  }: {\n    moduleParameters: any;\n    uniforms: any;\n    parameters: any;\n  }): void {\n    this._updateAttributeTransition();\n\n    const currentProps = this.props;\n    const context = this.context;\n    // Overwrite this.props during redraw to use in-transition prop values\n    // `internalState.propsInTransition` could be missing if `updateState` failed\n    // @ts-ignore (TS2339) internalState is alwasy defined when this method is called\n    this.props = this.internalState.propsInTransition || currentProps;\n\n    const opacity = this.props.opacity;\n    // apply gamma to opacity to make it visually \"linear\"\n    uniforms.opacity = Math.pow(opacity, 1 / 2.2);\n\n    try {\n      // TODO/ib - hack move to luma Model.draw\n      if (moduleParameters) {\n        this.setModuleParameters(moduleParameters);\n      }\n\n      // Apply polygon offset to avoid z-fighting\n      // TODO - move to draw-layers\n      const {getPolygonOffset} = this.props;\n      const offsets = (getPolygonOffset && getPolygonOffset(uniforms)) || [0, 0];\n\n      setParameters(context.gl, {polygonOffset: offsets});\n\n      // Call subclass lifecycle method\n      withParameters(context.gl, parameters, () => {\n        const opts = {moduleParameters, uniforms, parameters, context};\n\n        // extensions\n        for (const extension of this.props.extensions) {\n          extension.draw.call(this, opts, extension);\n        }\n\n        this.draw(opts);\n      });\n    } finally {\n      this.props = currentProps;\n    }\n\n    // End lifecycle method\n  }\n\n  // Helper methods\n  /** Returns the current change flags */\n  getChangeFlags(): ChangeFlags | undefined {\n    return this.internalState?.changeFlags;\n  }\n\n  /* eslint-disable complexity */\n  /** Dirty some change flags, will be handled by updateLayer */\n  setChangeFlags(flags: Partial<ChangeFlags>): void {\n    if (!this.internalState) {\n      return;\n    }\n    const {changeFlags} = this.internalState;\n\n    /* eslint-disable no-fallthrough, max-depth */\n    for (const key in flags) {\n      if (flags[key]) {\n        let flagChanged = false;\n        switch (key) {\n          case 'dataChanged':\n            // changeFlags.dataChanged may be `false`, a string (reason) or an array of ranges\n            const dataChangedReason = flags[key];\n            const prevDataChangedReason = changeFlags[key];\n            if (dataChangedReason && Array.isArray(prevDataChangedReason)) {\n              // Merge partial updates\n              changeFlags.dataChanged = Array.isArray(dataChangedReason)\n                ? prevDataChangedReason.concat(dataChangedReason)\n                : dataChangedReason;\n              flagChanged = true;\n            }\n\n          default:\n            if (!changeFlags[key]) {\n              changeFlags[key] = flags[key];\n              flagChanged = true;\n            }\n        }\n        if (flagChanged) {\n          debug(TRACE_CHANGE_FLAG, this, key, flags);\n        }\n      }\n    }\n    /* eslint-enable no-fallthrough, max-depth */\n\n    // Update composite flags\n    const propsOrDataChanged = Boolean(\n      changeFlags.dataChanged ||\n        changeFlags.updateTriggersChanged ||\n        changeFlags.propsChanged ||\n        changeFlags.extensionsChanged\n    );\n    changeFlags.propsOrDataChanged = propsOrDataChanged;\n    changeFlags.somethingChanged =\n      propsOrDataChanged || changeFlags.viewportChanged || changeFlags.stateChanged;\n  }\n  /* eslint-enable complexity */\n\n  /** Clear all changeFlags, typically after an update */\n  private _clearChangeFlags(): void {\n    // @ts-ignore TS2531 this method can only be called internally with internalState assigned\n    this.internalState.changeFlags = {\n      dataChanged: false,\n      propsChanged: false,\n      updateTriggersChanged: false,\n      viewportChanged: false,\n      stateChanged: false,\n      extensionsChanged: false,\n      propsOrDataChanged: false,\n      somethingChanged: false\n    };\n  }\n\n  /** Compares the layers props with old props from a matched older layer\n      and extracts change flags that describe what has change so that state\n      can be update correctly with minimal effort */\n  private _diffProps(newProps: Layer<PropsT>['props'], oldProps: Layer<PropsT>['props']) {\n    const changeFlags = diffProps(newProps, oldProps);\n\n    // iterate over changedTriggers\n    if (changeFlags.updateTriggersChanged) {\n      for (const key in changeFlags.updateTriggersChanged) {\n        if (changeFlags.updateTriggersChanged[key]) {\n          this.invalidateAttribute(key);\n        }\n      }\n    }\n\n    // trigger uniform transitions\n    if (changeFlags.transitionsChanged) {\n      for (const key in changeFlags.transitionsChanged) {\n        // prop changed and transition is enabled\n        // @ts-ignore (TS2531) internalState is always defined when this method is called\n        this.internalState.uniformTransitions.add(\n          key,\n          oldProps[key],\n          newProps[key],\n          newProps.transitions?.[key]\n        );\n      }\n    }\n\n    return this.setChangeFlags(changeFlags);\n  }\n\n  /** (Internal) called by layer manager to perform extra props validation (in development only) */\n  validateProps(): void {\n    validateProps(this.props);\n  }\n\n  /** (Internal) Called by deck picker when the hovered object changes to update the auto highlight */\n  updateAutoHighlight(info: PickingInfo): void {\n    if (this.props.autoHighlight && !Number.isInteger(this.props.highlightedObjectIndex)) {\n      this._updateAutoHighlight(info);\n    }\n  }\n\n  // May be overriden by subclasses\n\n  // TODO - simplify subclassing interface\n  /** Update picking module parameters to highlight the hovered object */\n  protected _updateAutoHighlight(info: PickingInfo): void {\n    const pickingModuleParameters: any = {\n      pickingSelectedColor: info.picked ? info.color : null\n    };\n    const {highlightColor} = this.props;\n    if (info.picked && typeof highlightColor === 'function') {\n      pickingModuleParameters.pickingHighlightColor = highlightColor(info);\n    }\n    this.setModuleParameters(pickingModuleParameters);\n    // setModuleParameters does not trigger redraw\n    this.setNeedsRedraw();\n  }\n\n  /** Create new attribute manager */\n  protected _getAttributeManager(): AttributeManager | null {\n    const context = this.context;\n    return new AttributeManager(context.gl, {\n      id: this.props.id,\n      stats: context.stats,\n      timeline: context.timeline\n    });\n  }\n\n  // Private methods\n\n  /** Called after updateState to perform common tasks */\n  protected _postUpdate(updateParams: UpdateParameters<Layer<PropsT>>, forceUpdate: boolean) {\n    const {props, oldProps} = updateParams;\n\n    this.setNeedsRedraw();\n    // Check if attributes need recalculation\n    this._updateAttributes();\n\n    // Note: Automatic instance count update only works for single layers\n    const {model} = this.state;\n    model?.setInstanceCount(this.getNumInstances());\n\n    // Set picking module parameters to match props\n    const {autoHighlight, highlightedObjectIndex, highlightColor} = props;\n    if (\n      forceUpdate ||\n      oldProps.autoHighlight !== autoHighlight ||\n      oldProps.highlightedObjectIndex !== highlightedObjectIndex ||\n      oldProps.highlightColor !== highlightColor\n    ) {\n      const parameters: any = {};\n      if (!autoHighlight) {\n        parameters.pickingSelectedColor = null;\n      }\n      if (Array.isArray(highlightColor)) {\n        parameters.pickingHighlightColor = highlightColor;\n      }\n\n      // highlightedObjectIndex will overwrite any settings from auto highlighting.\n      if (Number.isInteger(highlightedObjectIndex)) {\n        parameters.pickingSelectedColor =\n          Number.isFinite(highlightedObjectIndex) && (highlightedObjectIndex as number) >= 0\n            ? this.encodePickingColor(highlightedObjectIndex)\n            : null;\n      }\n\n      this.setModuleParameters(parameters);\n    }\n  }\n\n  private _getUpdateParams(): UpdateParameters<Layer<PropsT>> {\n    return {\n      props: this.props,\n      // @ts-ignore TS2531 this method can only be called internally with internalState assigned\n      oldProps: this.internalState.getOldProps() as PropsT,\n      context: this.context,\n      // @ts-ignore TS2531 this method can only be called internally with internalState assigned\n      changeFlags: this.internalState.changeFlags\n    };\n  }\n\n  /** Checks state of attributes and model */\n  private _getNeedsRedraw(opts: {clearRedrawFlags: boolean}): string | false {\n    // this method may be called by the render loop as soon a the layer\n    // has been created, so guard against uninitialized state\n    if (!this.internalState) {\n      return false;\n    }\n\n    let redraw: string | false = false;\n    redraw = redraw || (this.internalState.needsRedraw && this.id);\n    this.internalState.needsRedraw = this.internalState.needsRedraw && !opts.clearRedrawFlags;\n\n    // TODO - is attribute manager needed? - Model should be enough.\n    const attributeManager = this.getAttributeManager();\n    const attributeManagerNeedsRedraw = attributeManager\n      ? attributeManager.getNeedsRedraw(opts)\n      : false;\n    redraw = redraw || attributeManagerNeedsRedraw;\n\n    return redraw;\n  }\n\n  /** Callback when asyn prop is loaded */\n  private _onAsyncPropUpdated(): void {\n    // @ts-ignore TS2531 this method can only be called internally with internalState assigned\n    this._diffProps(this.props, this.internalState.getOldProps());\n    this.setNeedsUpdate();\n  }\n}\n","/* eslint-disable complexity */\nimport type DataColumn from './data-column';\nimport type {BufferAccessor, ShaderAttributeOptions} from './data-column';\nimport type {Buffer} from '@luma.gl/webgl';\nimport type {NumericArray} from '../../types/types';\n\nexport interface IShaderAttribute {\n  value: NumericArray | null;\n  getValue(): [Buffer, BufferAccessor] | NumericArray | null;\n}\n\n/* This class creates a luma.gl-compatible \"view\" on top of a DataColumn instance */\nexport default class ShaderAttribute implements IShaderAttribute {\n  opts: ShaderAttributeOptions;\n  source: DataColumn<any, any>;\n\n  constructor(dataColumn: DataColumn<any, any>, opts: ShaderAttributeOptions) {\n    // Options that cannot be changed later\n    this.opts = opts;\n    this.source = dataColumn;\n  }\n\n  get value(): NumericArray | null {\n    return this.source.value;\n  }\n\n  getValue(): [Buffer, BufferAccessor] | NumericArray | null {\n    const buffer = this.source.getBuffer();\n    const accessor = this.getAccessor();\n    if (buffer) {\n      return [buffer, accessor];\n    }\n\n    const {value} = this.source;\n    const {size} = accessor;\n    let constantValue = value;\n\n    if (value && value.length !== size) {\n      constantValue = new Float32Array(size);\n      // initiate offset values\n      const index = accessor.elementOffset || 0; // element offset\n      for (let i = 0; i < size; ++i) {\n        constantValue[i] = value[index + i];\n      }\n    }\n\n    return constantValue;\n  }\n\n  getAccessor() {\n    return {\n      // source data accessor\n      ...this.source.getAccessor(),\n      // shader attribute overrides\n      ...this.opts\n    };\n  }\n}\n","/* eslint-disable complexity */\nimport GL from '@luma.gl/constants';\nimport {hasFeature, FEATURES, Buffer} from '@luma.gl/core';\nimport ShaderAttribute, {IShaderAttribute} from './shader-attribute';\nimport {glArrayFromType} from './gl-utils';\nimport typedArrayManager from '../../utils/typed-array-manager';\nimport {toDoublePrecisionArray} from '../../utils/math-utils';\nimport log from '../../utils/log';\n\nimport type {Buffer as LumaBuffer} from '@luma.gl/webgl';\nimport type {TypedArray, NumericArray, TypedArrayConstructor} from '../../types/types';\n\nexport type BufferAccessor = {\n  /** A WebGL data type, see [vertexAttribPointer](https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/vertexAttribPointer#parameters). */\n  type?: number;\n  /** The number of elements per vertex attribute. */\n  size?: number;\n  /** 1 if instanced. */\n  divisor?: number;\n  /** Offset of the first vertex attribute into the buffer, in bytes. */\n  offset?: number;\n  /** The offset between the beginning of consecutive vertex attributes, in bytes. */\n  stride?: number;\n  /** Whether data values should be normalized. Note that all color attributes in deck.gl layers are normalized by default. */\n  normalized?: boolean;\n  integer?: boolean;\n};\n\nexport type ShaderAttributeOptions = Partial<BufferAccessor> & {\n  offset: number;\n  stride: number;\n  vertexOffset?: number;\n  elementOffset?: number;\n};\n\nfunction getStride(accessor: DataColumnSettings<any>): number {\n  return accessor.stride || accessor.size * accessor.bytesPerElement;\n}\n\nfunction resolveShaderAttribute(\n  baseAccessor: DataColumnSettings<any>,\n  shaderAttributeOptions: Partial<ShaderAttributeOptions>\n): ShaderAttributeOptions {\n  if (shaderAttributeOptions.offset) {\n    log.removed('shaderAttribute.offset', 'vertexOffset, elementOffset')();\n  }\n\n  // All shader attributes share the parent's stride\n  const stride = getStride(baseAccessor);\n  // `vertexOffset` is used to access the neighboring vertex's value\n  // e.g. `nextPositions` in polygon\n  const vertexOffset =\n    shaderAttributeOptions.vertexOffset !== undefined\n      ? shaderAttributeOptions.vertexOffset\n      : baseAccessor.vertexOffset || 0;\n  // `elementOffset` is defined when shader attribute's size is smaller than the parent's\n  // e.g. `translations` in transform matrix\n  const elementOffset = shaderAttributeOptions.elementOffset || 0;\n  const offset =\n    // offsets defined by the attribute\n    vertexOffset * stride +\n    elementOffset * baseAccessor.bytesPerElement +\n    // offsets defined by external buffers if any\n    (baseAccessor.offset || 0);\n\n  return {\n    ...shaderAttributeOptions,\n    offset,\n    stride\n  };\n}\n\nfunction resolveDoublePrecisionShaderAttributes(\n  baseAccessor: DataColumnSettings<any>,\n  shaderAttributeOptions: Partial<ShaderAttributeOptions>\n): {\n  high: ShaderAttributeOptions;\n  low: ShaderAttributeOptions;\n} {\n  const resolvedOptions = resolveShaderAttribute(baseAccessor, shaderAttributeOptions);\n\n  return {\n    high: resolvedOptions,\n    low: {\n      ...resolvedOptions,\n      offset: resolvedOptions.offset + baseAccessor.size * 4\n    }\n  };\n}\n\nexport type DataColumnOptions<Options> = Options &\n  BufferAccessor & {\n    id?: string;\n    vertexOffset?: number;\n    fp64?: boolean;\n    logicalType?: number;\n    isIndexed?: boolean;\n    defaultValue?: number | number[];\n  };\n\ntype DataColumnSettings<Options> = DataColumnOptions<Options> & {\n  type: number;\n  size: number;\n  logicalType?: number;\n  bytesPerElement: number;\n  defaultValue: number[];\n  defaultType: TypedArrayConstructor;\n};\n\ntype DataColumnInternalState<Options, State> = State & {\n  externalBuffer: LumaBuffer | null;\n  bufferAccessor: DataColumnSettings<Options>;\n  allocatedValue: TypedArray | null;\n  numInstances: number;\n  bounds: [number[], number[]] | null;\n  constant: boolean;\n};\n\nexport default class DataColumn<Options, State> implements IShaderAttribute {\n  gl: WebGLRenderingContext;\n  id: string;\n  size: number;\n  settings: DataColumnSettings<Options>;\n  value: NumericArray | null;\n  doublePrecision: boolean;\n\n  protected _buffer: LumaBuffer | null;\n  protected state: DataColumnInternalState<Options, State>;\n\n  /* eslint-disable max-statements */\n  constructor(gl: WebGLRenderingContext, opts: DataColumnOptions<Options>, state: State) {\n    this.gl = gl;\n    this.id = opts.id || '';\n    this.size = opts.size || 1;\n\n    const logicalType = opts.logicalType || opts.type;\n    const doublePrecision = logicalType === GL.DOUBLE;\n\n    let {defaultValue} = opts;\n    defaultValue = Number.isFinite(defaultValue)\n      ? [defaultValue]\n      : defaultValue || new Array(this.size).fill(0);\n\n    let bufferType: number;\n    if (doublePrecision) {\n      bufferType = GL.FLOAT;\n    } else if (!logicalType && opts.isIndexed) {\n      bufferType =\n        gl && hasFeature(gl, FEATURES.ELEMENT_INDEX_UINT32) ? GL.UNSIGNED_INT : GL.UNSIGNED_SHORT;\n    } else {\n      bufferType = logicalType || GL.FLOAT;\n    }\n\n    // This is the attribute type defined by the layer\n    // If an external buffer is provided, this.type may be overwritten\n    // But we always want to use defaultType for allocation\n    let defaultType = glArrayFromType(logicalType || bufferType || GL.FLOAT);\n    this.doublePrecision = doublePrecision;\n\n    // `fp64: false` tells a double-precision attribute to allocate Float32Arrays\n    // by default when using auto-packing. This is more efficient in use cases where\n    // high precision is unnecessary, but the `64Low` attribute is still required\n    // by the shader.\n    if (doublePrecision && opts.fp64 === false) {\n      defaultType = Float32Array;\n    }\n\n    this.value = null;\n    this.settings = {\n      ...opts,\n      defaultType,\n      defaultValue: defaultValue as number[],\n      logicalType,\n      type: bufferType,\n      size: this.size,\n      bytesPerElement: defaultType.BYTES_PER_ELEMENT\n    };\n    this.state = {\n      ...state,\n      externalBuffer: null,\n      bufferAccessor: this.settings,\n      allocatedValue: null,\n      numInstances: 0,\n      bounds: null,\n      constant: false\n    };\n    this._buffer = null;\n  }\n  /* eslint-enable max-statements */\n\n  get isConstant(): boolean {\n    return this.state.constant;\n  }\n\n  get buffer(): LumaBuffer {\n    if (!this._buffer) {\n      const {isIndexed, type} = this.settings;\n      this._buffer = new Buffer(this.gl, {\n        id: this.id,\n        target: isIndexed ? GL.ELEMENT_ARRAY_BUFFER : GL.ARRAY_BUFFER,\n        accessor: {type}\n      }) as LumaBuffer;\n    }\n    return this._buffer;\n  }\n\n  get byteOffset(): number {\n    const accessor = this.getAccessor();\n    if (accessor.vertexOffset) {\n      return accessor.vertexOffset * getStride(accessor);\n    }\n    return 0;\n  }\n\n  get numInstances(): number {\n    return this.state.numInstances;\n  }\n\n  set numInstances(n: number) {\n    this.state.numInstances = n;\n  }\n\n  delete(): void {\n    if (this._buffer) {\n      this._buffer.delete();\n      this._buffer = null;\n    }\n    typedArrayManager.release(this.state.allocatedValue);\n  }\n\n  getShaderAttributes(\n    id: string,\n    options: Partial<ShaderAttributeOptions> | null\n  ): Record<string, IShaderAttribute> {\n    if (this.doublePrecision) {\n      const shaderAttributes = {};\n      const isBuffer64Bit = this.value instanceof Float64Array;\n\n      const doubleShaderAttributeDefs = resolveDoublePrecisionShaderAttributes(\n        this.getAccessor(),\n        options || {}\n      );\n\n      shaderAttributes[id] = new ShaderAttribute(this, doubleShaderAttributeDefs.high);\n      shaderAttributes[`${id}64Low`] = isBuffer64Bit\n        ? new ShaderAttribute(this, doubleShaderAttributeDefs.low)\n        : new Float32Array(this.size); // use constant for low part if buffer is 32-bit\n      return shaderAttributes;\n    }\n    if (options) {\n      const shaderAttributeDef = resolveShaderAttribute(this.getAccessor(), options);\n      return {[id]: new ShaderAttribute(this, shaderAttributeDef)};\n    }\n    return {[id]: this};\n  }\n\n  getBuffer(): LumaBuffer | null {\n    if (this.state.constant) {\n      return null;\n    }\n    return this.state.externalBuffer || this._buffer;\n  }\n\n  getValue(): [LumaBuffer, BufferAccessor] | NumericArray | null {\n    if (this.state.constant) {\n      return this.value;\n    }\n    return [this.getBuffer() as LumaBuffer, this.getAccessor() as BufferAccessor];\n  }\n\n  getAccessor(): DataColumnSettings<Options> {\n    return this.state.bufferAccessor;\n  }\n\n  // Returns [min: Array(size), max: Array(size)]\n  /* eslint-disable max-depth */\n  getBounds(): [number[], number[]] | null {\n    if (this.state.bounds) {\n      return this.state.bounds;\n    }\n    let result: [number[], number[]] | null = null;\n    if (this.state.constant && this.value) {\n      const min = Array.from(this.value);\n      result = [min, min];\n    } else {\n      const {value, numInstances, size} = this;\n      const len = numInstances * size;\n      if (value && len && value.length >= len) {\n        const min = new Array(size).fill(Infinity);\n        const max = new Array(size).fill(-Infinity);\n        for (let i = 0; i < len; ) {\n          for (let j = 0; j < size; j++) {\n            const v = value[i++];\n            if (v < min[j]) min[j] = v;\n            if (v > max[j]) max[j] = v;\n          }\n        }\n        result = [min, max];\n      }\n    }\n    this.state.bounds = result;\n    return result;\n  }\n\n  // returns true if success\n  // eslint-disable-next-line max-statements\n  setData(\n    data:\n      | TypedArray\n      | LumaBuffer\n      | ({\n          constant?: boolean;\n          value?: NumericArray;\n          buffer?: LumaBuffer;\n        } & Partial<BufferAccessor>)\n  ): boolean {\n    const {state} = this;\n\n    let opts: {\n      constant?: boolean;\n      value?: NumericArray;\n      buffer?: LumaBuffer;\n    } & Partial<BufferAccessor>;\n    if (ArrayBuffer.isView(data)) {\n      opts = {value: data};\n    } else if (data instanceof Buffer) {\n      opts = {buffer: data as LumaBuffer};\n    } else {\n      opts = data;\n    }\n\n    const accessor: DataColumnSettings<Options> = {...this.settings, ...opts};\n    state.bufferAccessor = accessor;\n    state.bounds = null; // clear cached bounds\n\n    if (opts.constant) {\n      // set constant\n      let value = opts.value as NumericArray;\n      value = this._normalizeValue(value, [], 0);\n      if (this.settings.normalized) {\n        value = this.normalizeConstant(value);\n      }\n      const hasChanged = !state.constant || !this._areValuesEqual(value, this.value);\n\n      if (!hasChanged) {\n        return false;\n      }\n      state.externalBuffer = null;\n      state.constant = true;\n      this.value = value;\n    } else if (opts.buffer) {\n      const buffer = opts.buffer;\n      state.externalBuffer = buffer;\n      state.constant = false;\n      this.value = opts.value || null;\n      const isBuffer64Bit = opts.value instanceof Float64Array;\n\n      // Copy the type of the buffer into the accessor\n      // @ts-ignore\n      accessor.type = opts.type || buffer.accessor.type;\n      // @ts-ignore\n      accessor.bytesPerElement = buffer.accessor.BYTES_PER_ELEMENT * (isBuffer64Bit ? 2 : 1);\n      accessor.stride = getStride(accessor);\n    } else if (opts.value) {\n      this._checkExternalBuffer(opts);\n\n      let value = opts.value as TypedArray;\n      state.externalBuffer = null;\n      state.constant = false;\n      this.value = value;\n\n      accessor.bytesPerElement = value.BYTES_PER_ELEMENT;\n      accessor.stride = getStride(accessor);\n\n      const {buffer, byteOffset} = this;\n\n      if (this.doublePrecision && value instanceof Float64Array) {\n        value = toDoublePrecisionArray(value, accessor);\n      }\n\n      // A small over allocation is used as safety margin\n      // Shader attributes may try to access this buffer with bigger offsets\n      const requiredBufferSize = value.byteLength + byteOffset + accessor.stride * 2;\n      if (buffer.byteLength < requiredBufferSize) {\n        buffer.reallocate(requiredBufferSize);\n      }\n      // Hack: force Buffer to infer data type\n      buffer.setAccessor(null);\n      buffer.subData({data: value, offset: byteOffset});\n      // @ts-ignore\n      accessor.type = opts.type || buffer.accessor.type;\n    }\n\n    return true;\n  }\n\n  updateSubBuffer(\n    opts: {\n      startOffset?: number;\n      endOffset?: number;\n    } = {}\n  ): void {\n    this.state.bounds = null; // clear cached bounds\n\n    const value = this.value as TypedArray;\n    const {startOffset = 0, endOffset} = opts;\n    this.buffer.subData({\n      data:\n        this.doublePrecision && value instanceof Float64Array\n          ? toDoublePrecisionArray(value, {\n              size: this.size,\n              startIndex: startOffset,\n              endIndex: endOffset\n            })\n          : value.subarray(startOffset, endOffset),\n      offset: startOffset * value.BYTES_PER_ELEMENT + this.byteOffset\n    });\n  }\n\n  allocate(numInstances: number, copy: boolean = false): boolean {\n    const {state} = this;\n    const oldValue = state.allocatedValue;\n\n    // Allocate at least one element to ensure a valid buffer\n    const value = typedArrayManager.allocate(oldValue, numInstances + 1, {\n      size: this.size,\n      type: this.settings.defaultType,\n      copy\n    });\n\n    this.value = value;\n\n    const {buffer, byteOffset} = this;\n\n    if (buffer.byteLength < value.byteLength + byteOffset) {\n      buffer.reallocate(value.byteLength + byteOffset);\n\n      if (copy && oldValue) {\n        // Upload the full existing attribute value to the GPU, so that updateBuffer\n        // can choose to only update a partial range.\n        // TODO - copy old buffer to new buffer on the GPU\n        buffer.subData({\n          data:\n            oldValue instanceof Float64Array ? toDoublePrecisionArray(oldValue, this) : oldValue,\n          offset: byteOffset\n        });\n      }\n    }\n\n    state.allocatedValue = value;\n    state.constant = false;\n    state.externalBuffer = null;\n    state.bufferAccessor = this.settings;\n    return true;\n  }\n\n  // PRIVATE HELPER METHODS\n  protected _checkExternalBuffer(opts: {value?: NumericArray; normalized?: boolean}): void {\n    const {value} = opts;\n    if (!ArrayBuffer.isView(value)) {\n      throw new Error(`Attribute ${this.id} value is not TypedArray`);\n    }\n    const ArrayType = this.settings.defaultType;\n\n    let illegalArrayType = false;\n    if (this.doublePrecision) {\n      // not 32bit or 64bit\n      illegalArrayType = value.BYTES_PER_ELEMENT < 4;\n    }\n    if (illegalArrayType) {\n      throw new Error(`Attribute ${this.id} does not support ${value.constructor.name}`);\n    }\n    if (!(value instanceof ArrayType) && this.settings.normalized && !('normalized' in opts)) {\n      log.warn(`Attribute ${this.id} is normalized`)();\n    }\n  }\n\n  // https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/vertexAttribPointer\n  normalizeConstant(value: NumericArray): NumericArray {\n    switch (this.settings.type) {\n      case GL.BYTE:\n        // normalize [-128, 127] to [-1, 1]\n        return new Float32Array(value).map(x => ((x + 128) / 255) * 2 - 1);\n\n      case GL.SHORT:\n        // normalize [-32768, 32767] to [-1, 1]\n        return new Float32Array(value).map(x => ((x + 32768) / 65535) * 2 - 1);\n\n      case GL.UNSIGNED_BYTE:\n        // normalize [0, 255] to [0, 1]\n        return new Float32Array(value).map(x => x / 255);\n\n      case GL.UNSIGNED_SHORT:\n        // normalize [0, 65535] to [0, 1]\n        return new Float32Array(value).map(x => x / 65535);\n\n      default:\n        // No normalization for gl.FLOAT and gl.HALF_FLOAT\n        return value;\n    }\n  }\n\n  /* check user supplied values and apply fallback */\n  protected _normalizeValue(value: any, out: NumericArray, start: number): NumericArray {\n    const {defaultValue, size} = this.settings;\n\n    if (Number.isFinite(value)) {\n      out[start] = value;\n      return out;\n    }\n    if (!value) {\n      out[start] = defaultValue[0];\n      return out;\n    }\n\n    // Important - switch cases are 5x more performant than a for loop!\n    /* eslint-disable no-fallthrough, default-case */\n    switch (size) {\n      case 4:\n        out[start + 3] = Number.isFinite(value[3]) ? value[3] : defaultValue[3];\n      case 3:\n        out[start + 2] = Number.isFinite(value[2]) ? value[2] : defaultValue[2];\n      case 2:\n        out[start + 1] = Number.isFinite(value[1]) ? value[1] : defaultValue[1];\n      case 1:\n        out[start + 0] = Number.isFinite(value[0]) ? value[0] : defaultValue[0];\n        break;\n\n      default:\n        // In the rare case where the attribute size > 4, do it the slow way\n        // This is used for e.g. transform matrices\n        let i = size;\n        while (--i >= 0) {\n          out[start + i] = Number.isFinite(value[i]) ? value[i] : defaultValue[i];\n        }\n    }\n\n    return out;\n  }\n\n  protected _areValuesEqual(value1: any, value2: any): boolean {\n    if (!value1 || !value2) {\n      return false;\n    }\n    const {size} = this;\n    for (let i = 0; i < size; i++) {\n      if (value1[i] !== value2[i]) {\n        return false;\n      }\n    }\n    return true;\n  }\n}\n","import GL from '@luma.gl/constants';\nimport type {TypedArrayConstructor} from '../../types/types';\n\n/* eslint-disable complexity */\nexport function glArrayFromType(glType: number): TypedArrayConstructor {\n  // Sorted in some order of likelihood to reduce amount of comparisons\n  switch (glType) {\n    case GL.FLOAT:\n      return Float32Array;\n    case GL.DOUBLE:\n      return Float64Array;\n    case GL.UNSIGNED_SHORT:\n    case GL.UNSIGNED_SHORT_5_6_5:\n    case GL.UNSIGNED_SHORT_4_4_4_4:\n    case GL.UNSIGNED_SHORT_5_5_5_1:\n      return Uint16Array;\n    case GL.UNSIGNED_INT:\n      return Uint32Array;\n    case GL.UNSIGNED_BYTE:\n      return Uint8ClampedArray;\n    case GL.BYTE:\n      return Int8Array;\n    case GL.SHORT:\n      return Int16Array;\n    case GL.INT:\n      return Int32Array;\n    default:\n      throw new Error('Unknown GL type');\n  }\n}\n/* eslint-enable complexity */\n","/*\n * range (Array)\n *   + start (Number) - the start index (incl.)\n *   + end (Number) - the end index (excl.)\n * rangeList (Array) - array of sorted, combined ranges\n */\nexport const EMPTY = [];\nexport const FULL = [[0, Infinity]];\n\n// Insert a range into a range collection\nexport function add(rangeList, range) {\n  // Noop if range collection already covers all\n  if (rangeList === FULL) {\n    return rangeList;\n  }\n\n  // Validate the input range\n  if (range[0] < 0) {\n    range[0] = 0;\n  }\n  if (range[0] >= range[1]) {\n    return rangeList;\n  }\n\n  // TODO - split off to tree-shakable Range class\n  const newRangeList: number[] = [];\n  const len = rangeList.length;\n  let insertPosition = 0;\n\n  for (let i = 0; i < len; i++) {\n    const range0 = rangeList[i];\n\n    if (range0[1] < range[0]) {\n      // the current range is to the left of the new range\n      newRangeList.push(range0);\n      insertPosition = i + 1;\n    } else if (range0[0] > range[1]) {\n      // the current range is to the right of the new range\n      newRangeList.push(range0);\n    } else {\n      range = [Math.min(range0[0], range[0]), Math.max(range0[1], range[1])];\n    }\n  }\n  newRangeList.splice(insertPosition, 0, range);\n  return newRangeList;\n}\n","/* eslint-disable complexity */\nimport DataColumn, {DataColumnOptions, ShaderAttributeOptions, BufferAccessor} from './data-column';\nimport {IShaderAttribute} from './shader-attribute';\nimport assert from '../../utils/assert';\nimport {createIterable, getAccessorFromBuffer} from '../../utils/iterable-utils';\nimport {fillArray} from '../../utils/flatten';\nimport * as range from '../../utils/range';\nimport {normalizeTransitionSettings, TransitionSettings} from './attribute-transition-utils';\nimport type {Buffer} from '@luma.gl/webgl';\n\nimport type {NumericArray, TypedArray} from '../../types/types';\n\nexport type Accessor<DataType, ReturnType> = (\n  object: DataType,\n  context: {\n    data: any;\n    index: number;\n    target: number[];\n  }\n) => ReturnType;\n\nexport type Updater = (\n  attribute: Attribute,\n  {\n    data,\n    startRow,\n    endRow,\n    props,\n    numInstances\n  }: {\n    data: any;\n    startRow: number;\n    endRow: number;\n    props: any;\n    numInstances: number;\n  }\n) => void;\n\nexport type AttributeOptions = DataColumnOptions<{\n  transition?: boolean | Partial<TransitionSettings>;\n  noAlloc?: boolean;\n  update?: Updater;\n  accessor?: Accessor<any, any> | string | string[];\n  transform?: (value: any) => any;\n  shaderAttributes?: Record<string, Partial<ShaderAttributeOptions>>;\n}>;\n\nexport type BinaryAttribute = Partial<BufferAccessor> & {value?: TypedArray; buffer?: Buffer};\n\ntype AttributeInternalState = {\n  startIndices: NumericArray | null;\n  /** Legacy: external binary supplied via attribute name */\n  lastExternalBuffer: TypedArray | Buffer | BinaryAttribute | null;\n  /** External binary supplied via accessor name */\n  binaryValue: TypedArray | Buffer | BinaryAttribute | null;\n  binaryAccessor: Accessor<any, any> | null;\n  needsUpdate: string | boolean;\n  needsRedraw: string | boolean;\n  updateRanges: number[][];\n};\n\nexport default class Attribute extends DataColumn<AttributeOptions, AttributeInternalState> {\n  /** Legacy approach to set attribute value - read `isConstant` instead for attribute state */\n  constant: boolean = false;\n\n  constructor(gl: WebGLRenderingContext, opts: AttributeOptions) {\n    super(gl, opts, {\n      startIndices: null,\n      lastExternalBuffer: null,\n      binaryValue: null,\n      binaryAccessor: null,\n      needsUpdate: true,\n      needsRedraw: false,\n      updateRanges: range.FULL\n    });\n\n    // eslint-disable-next-line\n    this.settings.update = opts.update || (opts.accessor ? this._autoUpdater : undefined);\n\n    Object.seal(this.settings);\n    Object.seal(this.state);\n\n    // Check all fields and generate helpful error messages\n    this._validateAttributeUpdaters();\n  }\n\n  get startIndices(): NumericArray | null {\n    return this.state.startIndices;\n  }\n\n  set startIndices(layout: NumericArray | null) {\n    this.state.startIndices = layout;\n  }\n\n  needsUpdate(): string | boolean {\n    return this.state.needsUpdate;\n  }\n\n  needsRedraw({clearChangedFlags = false}: {clearChangedFlags?: boolean} = {}): string | boolean {\n    const needsRedraw = this.state.needsRedraw;\n    this.state.needsRedraw = needsRedraw && !clearChangedFlags;\n    return needsRedraw;\n  }\n\n  getUpdateTriggers(): string[] {\n    const {accessor} = this.settings;\n\n    // Backards compatibility: allow attribute name to be used as update trigger key\n    return [this.id].concat((typeof accessor !== 'function' && accessor) || []);\n  }\n\n  supportsTransition(): boolean {\n    return Boolean(this.settings.transition);\n  }\n\n  // Resolve transition settings object if transition is enabled, otherwise `null`\n  getTransitionSetting(opts: Record<string, any>): TransitionSettings | null {\n    if (!opts || !this.supportsTransition()) {\n      return null;\n    }\n    const {accessor} = this.settings;\n    // TODO: have the layer resolve these transition settings itself?\n    const layerSettings = this.settings.transition;\n    // these are the transition settings passed in by the user\n    const userSettings = Array.isArray(accessor)\n      ? // @ts-ignore\n        opts[accessor.find(a => opts[a])]\n      : // @ts-ignore\n        opts[accessor];\n\n    // Shorthand: use duration instead of parameter object\n    return normalizeTransitionSettings(userSettings, layerSettings);\n  }\n\n  setNeedsUpdate(reason: string = this.id, dataRange?: {startRow?: number; endRow?: number}): void {\n    this.state.needsUpdate = this.state.needsUpdate || reason;\n    this.setNeedsRedraw(reason);\n    if (dataRange) {\n      const {startRow = 0, endRow = Infinity} = dataRange;\n      this.state.updateRanges = range.add(this.state.updateRanges, [startRow, endRow]);\n    } else {\n      this.state.updateRanges = range.FULL;\n    }\n  }\n\n  clearNeedsUpdate(): void {\n    this.state.needsUpdate = false;\n    this.state.updateRanges = range.EMPTY;\n  }\n\n  setNeedsRedraw(reason: string = this.id): void {\n    this.state.needsRedraw = this.state.needsRedraw || reason;\n  }\n\n  allocate(numInstances: number): boolean {\n    const {state, settings} = this;\n\n    if (settings.noAlloc) {\n      // Data is provided through a Buffer object.\n      return false;\n    }\n\n    if (settings.update) {\n      super.allocate(numInstances, state.updateRanges !== range.FULL);\n      return true;\n    }\n\n    return false;\n  }\n\n  updateBuffer({\n    numInstances,\n    data,\n    props,\n    context\n  }: {\n    numInstances: number;\n    data: any;\n    props: any;\n    context: any;\n  }): boolean {\n    if (!this.needsUpdate()) {\n      return false;\n    }\n\n    const {\n      state: {updateRanges},\n      settings: {update, noAlloc}\n    } = this;\n\n    let updated = true;\n    if (update) {\n      // Custom updater - typically for non-instanced layers\n      for (const [startRow, endRow] of updateRanges) {\n        update.call(context, this, {data, startRow, endRow, props, numInstances});\n      }\n      if (!this.value) {\n        // no value was assigned during update\n      } else if (\n        this.constant ||\n        this.buffer.byteLength < (this.value as TypedArray).byteLength + this.byteOffset\n      ) {\n        this.setData({\n          value: this.value,\n          constant: this.constant\n        });\n        // Setting attribute.constant in updater is a legacy approach that interferes with allocation in the next cycle\n        // Respect it here but reset after use\n        this.constant = false;\n      } else {\n        for (const [startRow, endRow] of updateRanges) {\n          const startOffset = Number.isFinite(startRow) ? this.getVertexOffset(startRow) : 0;\n          const endOffset = Number.isFinite(endRow)\n            ? this.getVertexOffset(endRow)\n            : noAlloc || !Number.isFinite(numInstances)\n            ? this.value.length\n            : numInstances * this.size;\n\n          super.updateSubBuffer({startOffset, endOffset});\n        }\n      }\n      this._checkAttributeArray();\n    } else {\n      updated = false;\n    }\n\n    this.clearNeedsUpdate();\n    this.setNeedsRedraw();\n\n    return updated;\n  }\n\n  // Use generic value\n  // Returns true if successful\n  setConstantValue(value?: NumericArray): boolean {\n    if (value === undefined || typeof value === 'function') {\n      return false;\n    }\n\n    const hasChanged = this.setData({constant: true, value});\n\n    if (hasChanged) {\n      this.setNeedsRedraw();\n    }\n    this.clearNeedsUpdate();\n    return true;\n  }\n\n  // Use external buffer\n  // Returns true if successful\n  // eslint-disable-next-line max-statements\n  setExternalBuffer(buffer?: TypedArray | Buffer | BinaryAttribute): boolean {\n    const {state} = this;\n\n    if (!buffer) {\n      state.lastExternalBuffer = null;\n      return false;\n    }\n\n    this.clearNeedsUpdate();\n\n    if (state.lastExternalBuffer === buffer) {\n      return true;\n    }\n    state.lastExternalBuffer = buffer;\n    this.setNeedsRedraw();\n    this.setData(buffer);\n    return true;\n  }\n\n  // Binary value is a typed array packed from mapping the source data with the accessor\n  // If the returned value from the accessor is the same as the attribute value, set it directly\n  // Otherwise use the auto updater for transform/normalization\n  setBinaryValue(\n    buffer?: TypedArray | Buffer | BinaryAttribute,\n    startIndices: NumericArray | null = null\n  ): boolean {\n    const {state, settings} = this;\n\n    if (!buffer) {\n      state.binaryValue = null;\n      state.binaryAccessor = null;\n      return false;\n    }\n\n    if (settings.noAlloc) {\n      // Let the layer handle this\n      return false;\n    }\n\n    if (state.binaryValue === buffer) {\n      this.clearNeedsUpdate();\n      return true;\n    }\n    state.binaryValue = buffer;\n    this.setNeedsRedraw();\n\n    const needsUpdate = settings.transform || startIndices !== this.startIndices;\n\n    if (needsUpdate) {\n      if (ArrayBuffer.isView(buffer)) {\n        buffer = {value: buffer};\n      }\n      const binaryValue = buffer as BinaryAttribute;\n      assert(ArrayBuffer.isView(binaryValue.value), `invalid ${settings.accessor}`);\n      const needsNormalize = Boolean(binaryValue.size) && binaryValue.size !== this.size;\n\n      state.binaryAccessor = getAccessorFromBuffer(binaryValue.value, {\n        size: binaryValue.size || this.size,\n        stride: binaryValue.stride,\n        offset: binaryValue.offset,\n        startIndices: startIndices as NumericArray,\n        nested: needsNormalize\n      });\n      // Fall through to auto updater\n      return false;\n    }\n\n    this.clearNeedsUpdate();\n    this.setData(buffer);\n    return true;\n  }\n\n  getVertexOffset(row: number): number {\n    const {startIndices} = this;\n    const vertexIndex = startIndices ? startIndices[row] : row;\n    return vertexIndex * this.size;\n  }\n\n  getShaderAttributes(): Record<string, IShaderAttribute> {\n    const shaderAttributeDefs = this.settings.shaderAttributes || {[this.id]: null};\n    const shaderAttributes: Record<string, IShaderAttribute> = {};\n\n    for (const shaderAttributeName in shaderAttributeDefs) {\n      Object.assign(\n        shaderAttributes,\n        super.getShaderAttributes(shaderAttributeName, shaderAttributeDefs[shaderAttributeName])\n      );\n    }\n\n    return shaderAttributes;\n  }\n\n  /* eslint-disable max-depth, max-statements */\n  private _autoUpdater(\n    attribute: Attribute,\n    {\n      data,\n      startRow,\n      endRow,\n      props,\n      numInstances\n    }: {\n      data: any;\n      startRow: number;\n      endRow: number;\n      props: any;\n      numInstances: number;\n    }\n  ): void {\n    if (attribute.constant) {\n      return;\n    }\n    const {settings, state, value, size, startIndices} = attribute;\n\n    const {accessor, transform} = settings;\n    const accessorFunc: Accessor<any, any> =\n      state.binaryAccessor ||\n      // @ts-ignore\n      (typeof accessor === 'function' ? accessor : props[accessor]);\n\n    assert(typeof accessorFunc === 'function', `accessor \"${accessor}\" is not a function`);\n\n    let i = attribute.getVertexOffset(startRow);\n    const {iterable, objectInfo} = createIterable(data, startRow, endRow);\n    for (const object of iterable) {\n      objectInfo.index++;\n\n      let objectValue = accessorFunc(object, objectInfo);\n      if (transform) {\n        // transform callbacks could be bound to a particular layer instance.\n        // always point `this` to the current layer.\n        objectValue = transform.call(this, objectValue);\n      }\n\n      if (startIndices) {\n        const numVertices =\n          (objectInfo.index < startIndices.length - 1\n            ? startIndices[objectInfo.index + 1]\n            : numInstances) - startIndices[objectInfo.index];\n        if (objectValue && Array.isArray(objectValue[0])) {\n          let startIndex = i;\n          for (const item of objectValue) {\n            attribute._normalizeValue(item, value as TypedArray, startIndex);\n            startIndex += size;\n          }\n        } else if (objectValue && objectValue.length > size) {\n          (value as TypedArray).set(objectValue, i);\n        } else {\n          attribute._normalizeValue(objectValue, objectInfo.target, 0);\n          fillArray({\n            target: value,\n            source: objectInfo.target,\n            start: i,\n            count: numVertices\n          });\n        }\n        i += numVertices * size;\n      } else {\n        attribute._normalizeValue(objectValue, value as TypedArray, i);\n        i += size;\n      }\n    }\n  }\n  /* eslint-enable max-depth, max-statements */\n\n  // Validate deck.gl level fields\n  private _validateAttributeUpdaters() {\n    const {settings} = this;\n\n    // Check that 'update' is a valid function\n    const hasUpdater = settings.noAlloc || typeof settings.update === 'function';\n    if (!hasUpdater) {\n      throw new Error(`Attribute ${this.id} missing update or accessor`);\n    }\n  }\n\n  // check that the first few elements of the attribute are reasonable\n  /* eslint-disable no-fallthrough */\n  private _checkAttributeArray() {\n    const {value} = this;\n    const limit = Math.min(4, this.size);\n    if (value && value.length >= limit) {\n      let valid = true;\n      switch (limit) {\n        case 4:\n          valid = valid && Number.isFinite(value[3]);\n        case 3:\n          valid = valid && Number.isFinite(value[2]);\n        case 2:\n          valid = valid && Number.isFinite(value[1]);\n        case 1:\n          valid = valid && Number.isFinite(value[0]);\n          break;\n        default:\n          valid = false;\n      }\n\n      if (!valid) {\n        throw new Error(`Illegal attribute generated for ${this.id}`);\n      }\n    }\n  }\n  /* eslint-enable no-fallthrough */\n}\n","import GL from '@luma.gl/constants';\nimport {Buffer, Transform} from '@luma.gl/core';\nimport Attribute from '../lib/attribute/attribute';\nimport {\n  padBuffer,\n  getAttributeTypeFromSize,\n  getSourceBufferAttribute,\n  getAttributeBufferLength,\n  cycleBuffers,\n  InterpolationTransitionSettings\n} from '../lib/attribute/attribute-transition-utils';\nimport Transition from './transition';\n\nimport type {Timeline, Transform as LumaTransform} from '@luma.gl/engine';\nimport type {Buffer as LumaBuffer} from '@luma.gl/webgl';\nimport type {NumericArray} from '../types/types';\nimport type GPUTransition from './gpu-transition';\n\nexport default class GPUInterpolationTransition implements GPUTransition {\n  gl: WebGLRenderingContext;\n  type = 'interpolation';\n  attributeInTransition: Attribute;\n\n  private settings?: InterpolationTransitionSettings;\n  private attribute: Attribute;\n  private transition: Transition;\n  private currentStartIndices: NumericArray | null;\n  private currentLength: number;\n  private transform: LumaTransform;\n  private buffers: LumaBuffer[];\n\n  constructor({\n    gl,\n    attribute,\n    timeline\n  }: {\n    gl: WebGLRenderingContext;\n    attribute: Attribute;\n    timeline: Timeline;\n  }) {\n    this.gl = gl;\n    this.transition = new Transition(timeline);\n    this.attribute = attribute;\n    // this is the attribute we return during the transition - note: if it is a constant\n    // attribute, it will be converted and returned as a regular attribute\n    // `attribute.userData` is the original options passed when constructing the attribute.\n    // This ensures that we set the proper `doublePrecision` flag and shader attributes.\n    this.attributeInTransition = new Attribute(gl, attribute.settings);\n    this.currentStartIndices = attribute.startIndices;\n    // storing currentLength because this.buffer may be larger than the actual length we want to use\n    // this is because we only reallocate buffers when they grow, not when they shrink,\n    // due to performance costs\n    this.currentLength = 0;\n    this.transform = getTransform(gl, attribute);\n    const bufferOpts = {\n      byteLength: 0,\n      usage: GL.DYNAMIC_COPY\n    };\n    this.buffers = [\n      new Buffer(gl, bufferOpts), // from\n      new Buffer(gl, bufferOpts) // current\n    ];\n  }\n\n  get inProgress(): boolean {\n    return this.transition.inProgress;\n  }\n\n  // this is called when an attribute's values have changed and\n  // we need to start animating towards the new values\n  // this also correctly resizes / pads the transform's buffers\n  // in case the attribute's buffer has changed in length or in\n  // startIndices\n  start(transitionSettings: InterpolationTransitionSettings, numInstances: number): void {\n    if (transitionSettings.duration <= 0) {\n      this.transition.cancel();\n      return;\n    }\n    this.settings = transitionSettings;\n\n    const {gl, buffers, attribute} = this;\n    // Alternate between two buffers when new transitions start.\n    // Last destination buffer is used as an attribute (from state),\n    // And the other buffer is now the current buffer.\n    cycleBuffers(buffers);\n\n    const padBufferOpts = {\n      numInstances,\n      attribute,\n      fromLength: this.currentLength,\n      fromStartIndices: this.currentStartIndices,\n      getData: transitionSettings.enter\n    };\n\n    for (const buffer of buffers) {\n      padBuffer({buffer, ...padBufferOpts});\n    }\n\n    this.currentStartIndices = attribute.startIndices;\n    this.currentLength = getAttributeBufferLength(attribute, numInstances);\n    this.attributeInTransition.setData({\n      buffer: buffers[1],\n      // Hack: Float64Array is required for double-precision attributes\n      // to generate correct shader attributes\n      value: attribute.value as NumericArray\n    });\n\n    this.transition.start(transitionSettings);\n\n    this.transform.update({\n      elementCount: Math.floor(this.currentLength / attribute.size),\n      sourceBuffers: {\n        aFrom: buffers[0],\n        aTo: getSourceBufferAttribute(gl, attribute)\n      },\n      feedbackBuffers: {\n        vCurrent: buffers[1]\n      }\n    });\n  }\n\n  update(): boolean {\n    const updated = this.transition.update();\n    if (updated) {\n      const {duration, easing} = this.settings as InterpolationTransitionSettings;\n      const {time} = this.transition;\n      let t = time / duration;\n      if (easing) {\n        t = easing(t);\n      }\n      this.transform.run({\n        uniforms: {time: t}\n      });\n    }\n    return updated;\n  }\n\n  cancel(): void {\n    this.transition.cancel();\n    this.transform.delete();\n    for (const buffer of this.buffers) {\n      buffer.delete();\n    }\n    this.buffers.length = 0;\n  }\n}\n\nconst vs = `\n#define SHADER_NAME interpolation-transition-vertex-shader\n\nuniform float time;\nattribute ATTRIBUTE_TYPE aFrom;\nattribute ATTRIBUTE_TYPE aTo;\nvarying ATTRIBUTE_TYPE vCurrent;\n\nvoid main(void) {\n  vCurrent = mix(aFrom, aTo, time);\n  gl_Position = vec4(0.0);\n}\n`;\n\nfunction getTransform(gl: WebGLRenderingContext, attribute: Attribute): LumaTransform {\n  const attributeType = getAttributeTypeFromSize(attribute.size);\n  return new Transform(gl, {\n    vs,\n    defines: {\n      ATTRIBUTE_TYPE: attributeType\n    },\n    varyings: ['vCurrent']\n  });\n}\n","import {Transform} from '@luma.gl/core';\nimport GPUInterpolationTransition from '../../transitions/gpu-interpolation-transition';\nimport GPUSpringTransition from '../../transitions/gpu-spring-transition';\nimport log from '../../utils/log';\n\nimport type {TransitionSettings} from './attribute-transition-utils';\nimport type Attribute from './attribute';\nimport type {Timeline} from '@luma.gl/engine';\nimport type GPUTransition from '../../transitions/gpu-transition';\nimport type {ConstructorOf} from '../../types/types';\n\nconst TRANSITION_TYPES: Record<string, ConstructorOf<GPUTransition>> = {\n  interpolation: GPUInterpolationTransition,\n  spring: GPUSpringTransition\n};\n\nexport default class AttributeTransitionManager {\n  id: string;\n  isSupported: boolean;\n\n  private gl: WebGLRenderingContext;\n  private timeline?: Timeline;\n\n  private transitions: {[id: string]: GPUTransition};\n  private needsRedraw: boolean;\n  private numInstances: number;\n\n  constructor(\n    gl: WebGLRenderingContext,\n    {\n      id,\n      timeline\n    }: {\n      id: string;\n      timeline?: Timeline;\n    }\n  ) {\n    this.id = id;\n    this.gl = gl;\n    this.timeline = timeline;\n\n    this.transitions = {};\n    this.needsRedraw = false;\n    this.numInstances = 1;\n\n    this.isSupported = Transform.isSupported(gl);\n  }\n\n  finalize(): void {\n    for (const attributeName in this.transitions) {\n      this._removeTransition(attributeName);\n    }\n  }\n\n  /* Public methods */\n\n  // Called when attribute manager updates\n  // Check the latest attributes for updates.\n  update({\n    attributes,\n    transitions,\n    numInstances\n  }: {\n    attributes: {[id: string]: Attribute};\n    transitions: any;\n    numInstances: number;\n  }): void {\n    // Transform class will crash if elementCount is 0\n    this.numInstances = numInstances || 1;\n\n    for (const attributeName in attributes) {\n      const attribute = attributes[attributeName];\n      const settings = attribute.getTransitionSetting(transitions);\n\n      // this attribute might not support transitions?\n      if (!settings) continue; // eslint-disable-line no-continue\n      this._updateAttribute(attributeName, attribute, settings);\n    }\n\n    for (const attributeName in this.transitions) {\n      const attribute = attributes[attributeName];\n      if (!attribute || !attribute.getTransitionSetting(transitions)) {\n        // Animated attribute has been removed\n        this._removeTransition(attributeName);\n      }\n    }\n  }\n\n  // Returns `true` if attribute is transition-enabled\n  hasAttribute(attributeName: string): boolean {\n    const transition = this.transitions[attributeName];\n    return transition && transition.inProgress;\n  }\n\n  // Get all the animated attributes\n  getAttributes(): {[id: string]: Attribute} {\n    const animatedAttributes = {};\n\n    for (const attributeName in this.transitions) {\n      const transition = this.transitions[attributeName];\n      if (transition.inProgress) {\n        animatedAttributes[attributeName] = transition.attributeInTransition;\n      }\n    }\n\n    return animatedAttributes;\n  }\n\n  /* eslint-disable max-statements */\n  // Called every render cycle, run transform feedback\n  // Returns `true` if anything changes\n  run(): boolean {\n    if (!this.isSupported || this.numInstances === 0) {\n      return false;\n    }\n\n    for (const attributeName in this.transitions) {\n      const updated = this.transitions[attributeName].update();\n      if (updated) {\n        this.needsRedraw = true;\n      }\n    }\n\n    const needsRedraw = this.needsRedraw;\n    this.needsRedraw = false;\n    return needsRedraw;\n  }\n  /* eslint-enable max-statements */\n\n  /* Private methods */\n  private _removeTransition(attributeName: string): void {\n    this.transitions[attributeName].cancel();\n    delete this.transitions[attributeName];\n  }\n\n  // Check an attributes for updates\n  // Returns a transition object if a new transition is triggered.\n  private _updateAttribute(\n    attributeName: string,\n    attribute: Attribute,\n    settings: TransitionSettings\n  ): void {\n    const transition = this.transitions[attributeName];\n    // an attribute can change transition type when it updates\n    // let's remove the transition when that happens so we can create the new transition type\n    // TODO: when switching transition types, make sure to carry over the attribute's\n    // previous buffers, currentLength, startIndices, etc, to be used as the starting point\n    // for the next transition\n    let isNew = !transition || transition.type !== settings.type;\n    if (isNew) {\n      if (!this.isSupported) {\n        log.warn(\n          `WebGL2 not supported by this browser. Transition for ${attributeName} is disabled.`\n        )();\n        return;\n      }\n\n      if (transition) {\n        this._removeTransition(attributeName);\n      }\n\n      const TransitionType = TRANSITION_TYPES[settings.type];\n      if (TransitionType) {\n        this.transitions[attributeName] = new TransitionType({\n          attribute,\n          timeline: this.timeline,\n          gl: this.gl\n        });\n      } else {\n        log.error(`unsupported transition type '${settings.type}'`)();\n        isNew = false;\n      }\n    }\n\n    if (isNew || attribute.needsRedraw()) {\n      this.needsRedraw = true;\n      this.transitions[attributeName].start(settings, this.numInstances);\n    }\n  }\n}\n","/* eslint-disable complexity, max-statements, max-params */\nimport GL from '@luma.gl/constants';\nimport {Buffer, Transform, Framebuffer, Texture2D, readPixelsToArray} from '@luma.gl/core';\nimport {\n  padBuffer,\n  getAttributeTypeFromSize,\n  getSourceBufferAttribute,\n  getAttributeBufferLength,\n  cycleBuffers,\n  SpringTransitionSettings\n} from '../lib/attribute/attribute-transition-utils';\nimport Attribute from '../lib/attribute/attribute';\nimport Transition from './transition';\n\nimport type {Timeline, Transform as LumaTransform} from '@luma.gl/engine';\nimport type {\n  Buffer as LumaBuffer,\n  Framebuffer as LumaFramebuffer,\n  Texture2D as LumaTexture2D\n} from '@luma.gl/webgl';\nimport type {NumericArray} from '../types/types';\nimport type GPUTransition from './gpu-transition';\n\nexport default class GPUSpringTransition implements GPUTransition {\n  gl: WebGLRenderingContext;\n  type = 'spring';\n  attributeInTransition: Attribute;\n\n  private settings?: SpringTransitionSettings;\n  private attribute: Attribute;\n  private transition: Transition;\n  private currentStartIndices: NumericArray | null;\n  private currentLength: number;\n  private texture: LumaTexture2D;\n  private framebuffer: LumaFramebuffer;\n  private transform: LumaTransform;\n  private buffers: LumaBuffer[];\n\n  constructor({\n    gl,\n    attribute,\n    timeline\n  }: {\n    gl: WebGLRenderingContext;\n    attribute: Attribute;\n    timeline: Timeline;\n  }) {\n    this.gl = gl;\n    this.type = 'spring';\n    this.transition = new Transition(timeline);\n    this.attribute = attribute;\n    // this is the attribute we return during the transition - note: if it is a constant\n    // attribute, it will be converted and returned as a regular attribute\n    // `attribute.userData` is the original options passed when constructing the attribute.\n    // This ensures that we set the proper `doublePrecision` flag and shader attributes.\n    this.attributeInTransition = new Attribute(gl, {...attribute.settings, normalized: false});\n    this.currentStartIndices = attribute.startIndices;\n    // storing currentLength because this.buffer may be larger than the actual length we want to use\n    // this is because we only reallocate buffers when they grow, not when they shrink,\n    // due to performance costs\n    this.currentLength = 0;\n    this.texture = getTexture(gl);\n    this.framebuffer = getFramebuffer(gl, this.texture);\n    this.transform = getTransform(gl, attribute, this.framebuffer);\n    const bufferOpts = {\n      byteLength: 0,\n      usage: GL.DYNAMIC_COPY\n    };\n    this.buffers = [\n      new Buffer(gl, bufferOpts), // previous\n      new Buffer(gl, bufferOpts), // current\n      new Buffer(gl, bufferOpts) // next\n    ];\n  }\n\n  get inProgress(): boolean {\n    return this.transition.inProgress;\n  }\n\n  // this is called when an attribute's values have changed and\n  // we need to start animating towards the new values\n  // this also correctly resizes / pads the transform's buffers\n  // in case the attribute's buffer has changed in length or in\n  // startIndices\n  start(transitionSettings: SpringTransitionSettings, numInstances: number): void {\n    const {gl, buffers, attribute} = this;\n    const padBufferOpts = {\n      numInstances,\n      attribute,\n      fromLength: this.currentLength,\n      fromStartIndices: this.currentStartIndices,\n      getData: transitionSettings.enter\n    };\n\n    for (const buffer of buffers) {\n      padBuffer({buffer, ...padBufferOpts});\n    }\n\n    this.settings = transitionSettings;\n    this.currentStartIndices = attribute.startIndices;\n    this.currentLength = getAttributeBufferLength(attribute, numInstances);\n    this.attributeInTransition.setData({\n      buffer: buffers[1],\n      // Hack: Float64Array is required for double-precision attributes\n      // to generate correct shader attributes\n      value: attribute.value as NumericArray\n    });\n\n    // when an attribute changes values, a new transition is started. These\n    // are properties that we have to store on this.transition but can change\n    // when new transitions are started, so we have to keep them up-to-date.\n    // this.transition.start() takes the latest settings and updates them.\n    this.transition.start({...transitionSettings, duration: Infinity});\n\n    this.transform.update({\n      elementCount: Math.floor(this.currentLength / attribute.size),\n      sourceBuffers: {\n        aTo: getSourceBufferAttribute(gl, attribute)\n      }\n    });\n  }\n\n  update() {\n    const {buffers, transform, framebuffer, transition} = this;\n    const updated = transition.update();\n    if (!updated) {\n      return false;\n    }\n    const settings = this.settings as SpringTransitionSettings;\n\n    transform.update({\n      sourceBuffers: {\n        aPrev: buffers[0],\n        aCur: buffers[1]\n      },\n      feedbackBuffers: {\n        vNext: buffers[2]\n      }\n    });\n    transform.run({\n      framebuffer,\n      discard: false,\n      clearRenderTarget: true,\n      uniforms: {\n        stiffness: settings.stiffness,\n        damping: settings.damping\n      },\n      parameters: {\n        depthTest: false,\n        blend: true,\n        viewport: [0, 0, 1, 1],\n        blendFunc: [GL.ONE, GL.ONE],\n        blendEquation: [GL.MAX, GL.MAX]\n      }\n    });\n\n    cycleBuffers(buffers);\n    this.attributeInTransition.setData({\n      buffer: buffers[1],\n      // Hack: Float64Array is required for double-precision attributes\n      // to generate correct shader attributes\n      value: this.attribute.value as NumericArray\n    });\n\n    const isTransitioning = readPixelsToArray(framebuffer)[0] > 0;\n\n    if (!isTransitioning) {\n      transition.end();\n    }\n\n    return true;\n  }\n\n  cancel() {\n    this.transition.cancel();\n    this.transform.delete();\n    for (const buffer of this.buffers) {\n      buffer.delete();\n    }\n    this.buffers.length = 0;\n    this.texture.delete();\n    this.framebuffer.delete();\n  }\n}\n\nfunction getTransform(\n  gl: WebGLRenderingContext,\n  attribute: Attribute,\n  framebuffer: LumaFramebuffer\n): LumaTransform {\n  const attributeType = getAttributeTypeFromSize(attribute.size);\n  return new Transform(gl, {\n    framebuffer,\n    vs: `\n#define SHADER_NAME spring-transition-vertex-shader\n\n#define EPSILON 0.00001\n\nuniform float stiffness;\nuniform float damping;\nattribute ATTRIBUTE_TYPE aPrev;\nattribute ATTRIBUTE_TYPE aCur;\nattribute ATTRIBUTE_TYPE aTo;\nvarying ATTRIBUTE_TYPE vNext;\nvarying float vIsTransitioningFlag;\n\nATTRIBUTE_TYPE getNextValue(ATTRIBUTE_TYPE cur, ATTRIBUTE_TYPE prev, ATTRIBUTE_TYPE dest) {\n  ATTRIBUTE_TYPE velocity = cur - prev;\n  ATTRIBUTE_TYPE delta = dest - cur;\n  ATTRIBUTE_TYPE spring = delta * stiffness;\n  ATTRIBUTE_TYPE damper = velocity * -1.0 * damping;\n  return spring + damper + velocity + cur;\n}\n\nvoid main(void) {\n  bool isTransitioning = length(aCur - aPrev) > EPSILON || length(aTo - aCur) > EPSILON;\n  vIsTransitioningFlag = isTransitioning ? 1.0 : 0.0;\n\n  vNext = getNextValue(aCur, aPrev, aTo);\n  gl_Position = vec4(0, 0, 0, 1);\n  gl_PointSize = 100.0;\n}\n`,\n    fs: `\n#define SHADER_NAME spring-transition-is-transitioning-fragment-shader\n\nvarying float vIsTransitioningFlag;\n\nvoid main(void) {\n  if (vIsTransitioningFlag == 0.0) {\n    discard;\n  }\n  gl_FragColor = vec4(1.0);\n}`,\n    defines: {\n      ATTRIBUTE_TYPE: attributeType\n    },\n    varyings: ['vNext']\n  });\n}\n\nfunction getTexture(gl: WebGLRenderingContext): LumaTexture2D {\n  return new Texture2D(gl, {\n    data: new Uint8Array(4),\n    format: GL.RGBA,\n    type: GL.UNSIGNED_BYTE,\n    border: 0,\n    mipmaps: false,\n    dataFormat: GL.RGBA,\n    width: 1,\n    height: 1\n  });\n}\n\nfunction getFramebuffer(gl: WebGLRenderingContext, texture: LumaTexture2D): LumaFramebuffer {\n  return new Framebuffer(gl, {\n    id: 'spring-transition-is-transitioning-framebuffer',\n    width: 1,\n    height: 1,\n    attachments: {\n      [GL.COLOR_ATTACHMENT0]: texture\n    }\n  });\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n/* eslint-disable guard-for-in */\nimport Attribute, {AttributeOptions} from './attribute';\nimport {IShaderAttribute} from './shader-attribute';\nimport log from '../../utils/log';\nimport debug from '../../debug';\nimport {NumericArray} from '../../types/types';\n\nimport AttributeTransitionManager from './attribute-transition-manager';\n\nimport type {Stat} from 'probe.gl';\nimport type {Timeline} from '@luma.gl/engine';\n\nconst TRACE_INVALIDATE = 'attributeManager.invalidate';\nconst TRACE_UPDATE_START = 'attributeManager.updateStart';\nconst TRACE_UPDATE_END = 'attributeManager.updateEnd';\nconst TRACE_ATTRIBUTE_UPDATE_START = 'attribute.updateStart';\nconst TRACE_ATTRIBUTE_ALLOCATE = 'attribute.allocate';\nconst TRACE_ATTRIBUTE_UPDATE_END = 'attribute.updateEnd';\n\nexport default class AttributeManager {\n  /**\n   * @classdesc\n   * Automated attribute generation and management. Suitable when a set of\n   * vertex shader attributes are generated by iteration over a data array,\n   * and updates to these attributes are needed either when the data itself\n   * changes, or when other data relevant to the calculations change.\n   *\n   * - First the application registers descriptions of its dynamic vertex\n   *   attributes using AttributeManager.add().\n   * - Then, when any change that affects attributes is detected by the\n   *   application, the app will call AttributeManager.invalidate().\n   * - Finally before it renders, it calls AttributeManager.update() to\n   *   ensure that attributes are automatically rebuilt if anything has been\n   *   invalidated.\n   *\n   * The application provided update functions describe how attributes\n   * should be updated from a data array and are expected to traverse\n   * that data array (or iterable) and fill in the attribute's typed array.\n   *\n   * Note that the attribute manager intentionally does not do advanced\n   * change detection, but instead makes it easy to build such detection\n   * by offering the ability to \"invalidate\" each attribute separately.\n   */\n  id: string;\n  gl: WebGLRenderingContext;\n  attributes: Record<string, Attribute>;\n  updateTriggers: {[name: string]: string[]};\n  needsRedraw: string | boolean;\n  userData: any;\n\n  private stats?: Stat;\n  private attributeTransitionManager: AttributeTransitionManager;\n\n  constructor(\n    gl: WebGLRenderingContext,\n    {\n      id = 'attribute-manager',\n      stats,\n      timeline\n    }: {\n      id?: string;\n      stats?: Stat;\n      timeline?: Timeline;\n    } = {}\n  ) {\n    this.id = id;\n    this.gl = gl;\n\n    this.attributes = {};\n\n    this.updateTriggers = {};\n    this.needsRedraw = true;\n\n    this.userData = {};\n    this.stats = stats;\n\n    this.attributeTransitionManager = new AttributeTransitionManager(gl, {\n      id: `${id}-transitions`,\n      timeline\n    });\n\n    // For debugging sanity, prevent uninitialized members\n    Object.seal(this);\n  }\n\n  finalize() {\n    for (const attributeName in this.attributes) {\n      this.attributes[attributeName].delete();\n    }\n    this.attributeTransitionManager.finalize();\n  }\n\n  // Returns the redraw flag, optionally clearing it.\n  // Redraw flag will be set if any attributes attributes changed since\n  // flag was last cleared.\n  //\n  // @param {String} [clearRedrawFlags=false] - whether to clear the flag\n  // @return {false|String} - reason a redraw is needed.\n  getNeedsRedraw(opts: {clearRedrawFlags?: boolean} = {clearRedrawFlags: false}): string | false {\n    const redraw = this.needsRedraw;\n    this.needsRedraw = this.needsRedraw && !opts.clearRedrawFlags;\n    return redraw && this.id;\n  }\n\n  // Sets the redraw flag.\n  // @param {Boolean} redraw=true\n  setNeedsRedraw() {\n    this.needsRedraw = true;\n  }\n\n  // Adds attributes\n  add(attributes: {[id: string]: AttributeOptions}) {\n    this._add(attributes);\n  }\n\n  // Adds attributes\n  addInstanced(attributes: {[id: string]: AttributeOptions}) {\n    this._add(attributes, {instanced: 1});\n  }\n\n  /**\n   * Removes attributes\n   * Takes an array of attribute names and delete them from\n   * the attribute map if they exists\n   *\n   * @example\n   * attributeManager.remove(['position']);\n   *\n   * @param {Object} attributeNameArray - attribute name array (see above)\n   */\n  remove(attributeNameArray: string[]) {\n    for (const name of attributeNameArray) {\n      if (this.attributes[name] !== undefined) {\n        this.attributes[name].delete();\n        delete this.attributes[name];\n      }\n    }\n  }\n\n  // Marks an attribute for update\n  invalidate(triggerName: string, dataRange?: {startRow?: number; endRow?: number}) {\n    const invalidatedAttributes = this._invalidateTrigger(triggerName, dataRange);\n    // For performance tuning\n    debug(TRACE_INVALIDATE, this, triggerName, invalidatedAttributes);\n  }\n\n  invalidateAll(dataRange?: {startRow?: number; endRow?: number}) {\n    for (const attributeName in this.attributes) {\n      this.attributes[attributeName].setNeedsUpdate(attributeName, dataRange);\n    }\n    // For performance tuning\n    debug(TRACE_INVALIDATE, this, 'all');\n  }\n\n  // Ensure all attribute buffers are updated from props or data.\n  update({\n    data,\n    numInstances,\n    startIndices = null,\n    transitions,\n    props = {},\n    buffers = {},\n    context = {}\n  }: {\n    data: any;\n    numInstances: number;\n    startIndices?: NumericArray | null;\n    transitions: any;\n    props: any;\n    buffers: any;\n    context: any;\n  }) {\n    // keep track of whether some attributes are updated\n    let updated = false;\n\n    debug(TRACE_UPDATE_START, this);\n    if (this.stats) {\n      this.stats.get('Update Attributes').timeStart();\n    }\n\n    for (const attributeName in this.attributes) {\n      const attribute = this.attributes[attributeName];\n      const accessorName = attribute.settings.accessor;\n      attribute.startIndices = startIndices;\n      attribute.numInstances = numInstances;\n\n      if (props[attributeName]) {\n        log.removed(`props.${attributeName}`, `data.attributes.${attributeName}`)();\n      }\n\n      if (attribute.setExternalBuffer(buffers[attributeName])) {\n        // Step 1: try update attribute directly from external buffers\n      } else if (\n        attribute.setBinaryValue(\n          typeof accessorName === 'string' ? buffers[accessorName] : undefined,\n          data.startIndices\n        )\n      ) {\n        // Step 2: try set packed value from external typed array\n      } else if (\n        typeof accessorName === 'string' &&\n        !buffers[accessorName] &&\n        attribute.setConstantValue(props[accessorName])\n      ) {\n        // Step 3: try set constant value from props\n        // Note: if buffers[accessorName] is supplied, ignore props[accessorName]\n        // This may happen when setBinaryValue falls through to use the auto updater\n      } else if (attribute.needsUpdate()) {\n        // Step 4: update via updater callback\n        updated = true;\n        this._updateAttribute({\n          attribute,\n          numInstances,\n          data,\n          props,\n          context\n        });\n      }\n\n      this.needsRedraw = this.needsRedraw || attribute.needsRedraw();\n    }\n\n    if (updated) {\n      // Only initiate alloc/update (and logging) if actually needed\n      debug(TRACE_UPDATE_END, this, numInstances);\n    }\n\n    if (this.stats) {\n      this.stats.get('Update Attributes').timeEnd();\n    }\n\n    this.attributeTransitionManager.update({\n      attributes: this.attributes,\n      numInstances,\n      transitions\n    });\n  }\n\n  // Update attribute transition to the current timestamp\n  // Returns `true` if any transition is in progress\n  updateTransition() {\n    const {attributeTransitionManager} = this;\n    const transitionUpdated = attributeTransitionManager.run();\n    this.needsRedraw = this.needsRedraw || transitionUpdated;\n    return transitionUpdated;\n  }\n\n  /**\n   * Returns all attribute descriptors\n   * Note: Format matches luma.gl Model/Program.setAttributes()\n   * @return {Object} attributes - descriptors\n   */\n  getAttributes(): {[id: string]: Attribute} {\n    return this.attributes;\n  }\n\n  /**\n   * Returns changed attribute descriptors\n   * This indicates which WebGLBuffers need to be updated\n   * @return {Object} attributes - descriptors\n   */\n  getChangedAttributes(opts: {clearChangedFlags?: boolean} = {clearChangedFlags: false}): {\n    [id: string]: Attribute;\n  } {\n    const {attributes, attributeTransitionManager} = this;\n\n    const changedAttributes = {...attributeTransitionManager.getAttributes()};\n\n    for (const attributeName in attributes) {\n      const attribute = attributes[attributeName];\n      if (attribute.needsRedraw(opts) && !attributeTransitionManager.hasAttribute(attributeName)) {\n        changedAttributes[attributeName] = attribute;\n      }\n    }\n\n    return changedAttributes;\n  }\n\n  // Returns shader attributes\n  getShaderAttributes(\n    attributes?: {[id: string]: Attribute},\n    excludeAttributes: Record<string, boolean> = {}\n  ): {[id: string]: IShaderAttribute} {\n    if (!attributes) {\n      attributes = this.getAttributes();\n    }\n    const shaderAttributes = {};\n    for (const attributeName in attributes) {\n      if (!excludeAttributes[attributeName]) {\n        Object.assign(shaderAttributes, attributes[attributeName].getShaderAttributes());\n      }\n    }\n    return shaderAttributes;\n  }\n\n  // PRIVATE METHODS\n\n  // Used to register an attribute\n  private _add(attributes: {[id: string]: AttributeOptions}, extraProps: any = {}) {\n    for (const attributeName in attributes) {\n      const attribute = attributes[attributeName];\n\n      // Initialize the attribute descriptor, with WebGL and metadata fields\n      this.attributes[attributeName] = this._createAttribute(attributeName, attribute, extraProps);\n    }\n\n    this._mapUpdateTriggersToAttributes();\n  }\n  /* eslint-enable max-statements */\n\n  private _createAttribute(name: string, attribute: AttributeOptions, extraProps: any) {\n    // For expected default values see:\n    // https://github.com/visgl/luma.gl/blob/1affe21352e289eeaccee2a876865138858a765c/modules/webgl/src/classes/accessor.js#L5-L13\n    // and https://deck.gl/docs/api-reference/core/attribute-manager#add\n    const props: AttributeOptions = {\n      ...attribute,\n      id: name,\n      size: (attribute.isIndexed && 1) || attribute.size || 1,\n      divisor: extraProps.instanced ? 1 : attribute.divisor || 0\n    };\n\n    return new Attribute(this.gl, props);\n  }\n\n  // build updateTrigger name to attribute name mapping\n  private _mapUpdateTriggersToAttributes() {\n    const triggers: {[name: string]: string[]} = {};\n\n    for (const attributeName in this.attributes) {\n      const attribute = this.attributes[attributeName];\n      attribute.getUpdateTriggers().forEach(triggerName => {\n        if (!triggers[triggerName]) {\n          triggers[triggerName] = [];\n        }\n        triggers[triggerName].push(attributeName);\n      });\n    }\n\n    this.updateTriggers = triggers;\n  }\n\n  private _invalidateTrigger(\n    triggerName: string,\n    dataRange?: {startRow?: number; endRow?: number}\n  ): string[] {\n    const {attributes, updateTriggers} = this;\n    const invalidatedAttributes = updateTriggers[triggerName];\n\n    if (invalidatedAttributes) {\n      invalidatedAttributes.forEach(name => {\n        const attribute = attributes[name];\n        if (attribute) {\n          attribute.setNeedsUpdate(attribute.id, dataRange);\n        }\n      });\n    }\n    return invalidatedAttributes;\n  }\n\n  private _updateAttribute(opts: {\n    attribute: Attribute;\n    numInstances: number;\n    data: any;\n    props: any;\n    context: any;\n  }) {\n    const {attribute, numInstances} = opts;\n    debug(TRACE_ATTRIBUTE_UPDATE_START, attribute);\n\n    if (attribute.constant) {\n      // The attribute is flagged as constant outside of an update cycle\n      // Skip allocation and updater call\n      attribute.setConstantValue(attribute.value as NumericArray);\n      return;\n    }\n\n    if (attribute.allocate(numInstances)) {\n      debug(TRACE_ATTRIBUTE_ALLOCATE, attribute, numInstances);\n    }\n\n    // Calls update on any buffers that need update\n    const updated = attribute.updateBuffer(opts);\n    if (updated) {\n      this.needsRedraw = true;\n      debug(TRACE_ATTRIBUTE_UPDATE_END, attribute, numInstances);\n    }\n  }\n}\n","const INF = 1e20;\n\nexport default class TinySDF {\n    constructor({\n        fontSize = 24,\n        buffer = 3,\n        radius = 8,\n        cutoff = 0.25,\n        fontFamily = 'sans-serif',\n        fontWeight = 'normal',\n        fontStyle = 'normal'\n    } = {}) {\n        this.buffer = buffer;\n        this.cutoff = cutoff;\n        this.radius = radius;\n\n        // make the canvas size big enough to both have the specified buffer around the glyph\n        // for \"halo\", and account for some glyphs possibly being larger than their font size\n        const size = this.size = fontSize + buffer * 4;\n\n        const canvas = this._createCanvas(size);\n        const ctx = this.ctx = canvas.getContext('2d', {willReadFrequently: true});\n        ctx.font = `${fontStyle} ${fontWeight} ${fontSize}px ${fontFamily}`;\n\n        ctx.textBaseline = 'alphabetic';\n        ctx.textAlign = 'left'; // Necessary so that RTL text doesn't have different alignment\n        ctx.fillStyle = 'black';\n\n        // temporary arrays for the distance transform\n        this.gridOuter = new Float64Array(size * size);\n        this.gridInner = new Float64Array(size * size);\n        this.f = new Float64Array(size);\n        this.z = new Float64Array(size + 1);\n        this.v = new Uint16Array(size);\n    }\n\n    _createCanvas(size) {\n        const canvas = document.createElement('canvas');\n        canvas.width = canvas.height = size;\n        return canvas;\n    }\n\n    draw(char) {\n        const {\n            width: glyphAdvance,\n            actualBoundingBoxAscent,\n            actualBoundingBoxDescent,\n            actualBoundingBoxLeft,\n            actualBoundingBoxRight\n        } = this.ctx.measureText(char);\n\n        // The integer/pixel part of the top alignment is encoded in metrics.glyphTop\n        // The remainder is implicitly encoded in the rasterization\n        const glyphTop = Math.ceil(actualBoundingBoxAscent);\n        const glyphLeft = 0;\n\n        // If the glyph overflows the canvas size, it will be clipped at the bottom/right\n        const glyphWidth = Math.min(this.size - this.buffer, Math.ceil(actualBoundingBoxRight - actualBoundingBoxLeft));\n        const glyphHeight = Math.min(this.size - this.buffer, glyphTop + Math.ceil(actualBoundingBoxDescent));\n\n        const width = glyphWidth + 2 * this.buffer;\n        const height = glyphHeight + 2 * this.buffer;\n\n        const len = Math.max(width * height, 0);\n        const data = new Uint8ClampedArray(len);\n        const glyph = {data, width, height, glyphWidth, glyphHeight, glyphTop, glyphLeft, glyphAdvance};\n        if (glyphWidth === 0 || glyphHeight === 0) return glyph;\n\n        const {ctx, buffer, gridInner, gridOuter} = this;\n        ctx.clearRect(buffer, buffer, glyphWidth, glyphHeight);\n        ctx.fillText(char, buffer, buffer + glyphTop);\n        const imgData = ctx.getImageData(buffer, buffer, glyphWidth, glyphHeight);\n\n        // Initialize grids outside the glyph range to alpha 0\n        gridOuter.fill(INF, 0, len);\n        gridInner.fill(0, 0, len);\n\n        for (let y = 0; y < glyphHeight; y++) {\n            for (let x = 0; x < glyphWidth; x++) {\n                const a = imgData.data[4 * (y * glyphWidth + x) + 3] / 255; // alpha value\n                if (a === 0) continue; // empty pixels\n\n                const j = (y + buffer) * width + x + buffer;\n\n                if (a === 1) { // fully drawn pixels\n                    gridOuter[j] = 0;\n                    gridInner[j] = INF;\n\n                } else { // aliased pixels\n                    const d = 0.5 - a;\n                    gridOuter[j] = d > 0 ? d * d : 0;\n                    gridInner[j] = d < 0 ? d * d : 0;\n                }\n            }\n        }\n\n        edt(gridOuter, 0, 0, width, height, width, this.f, this.v, this.z);\n        edt(gridInner, buffer, buffer, glyphWidth, glyphHeight, width, this.f, this.v, this.z);\n\n        for (let i = 0; i < len; i++) {\n            const d = Math.sqrt(gridOuter[i]) - Math.sqrt(gridInner[i]);\n            data[i] = Math.round(255 - 255 * (d / this.radius + this.cutoff));\n        }\n\n        return glyph;\n    }\n}\n\n// 2D Euclidean squared distance transform by Felzenszwalb & Huttenlocher https://cs.brown.edu/~pff/papers/dt-final.pdf\nfunction edt(data, x0, y0, width, height, gridSize, f, v, z) {\n    for (let x = x0; x < x0 + width; x++) edt1d(data, y0 * gridSize + x, gridSize, height, f, v, z);\n    for (let y = y0; y < y0 + height; y++) edt1d(data, y * gridSize + x0, 1, width, f, v, z);\n}\n\n// 1D squared distance transform\nfunction edt1d(grid, offset, stride, length, f, v, z) {\n    v[0] = 0;\n    z[0] = -INF;\n    z[1] = INF;\n    f[0] = grid[offset];\n\n    for (let q = 1, k = 0, s = 0; q < length; q++) {\n        f[q] = grid[offset + q * stride];\n        const q2 = q * q;\n        do {\n            const r = v[k];\n            s = (f[q] - f[r] + q2 - r * r) / (q - r) / 2;\n        } while (s <= z[k] && --k > -1);\n\n        k++;\n        v[k] = q;\n        z[k] = s;\n        z[k + 1] = INF;\n    }\n\n    for (let q = 0, k = 0; q < length; q++) {\n        while (z[k + 1] < q) k++;\n        const r = v[k];\n        const qr = q - r;\n        grid[offset + q * stride] = f[r] + qr * qr;\n    }\n}\n","/* eslint-disable max-statements, max-params, complexity, max-depth */\n// TODO merge with icon-layer/icon-manager\nimport {log} from '@deck.gl/core';\nimport type {NumericArray} from '@math.gl/core';\n\nconst MISSING_CHAR_WIDTH = 32;\nconst SINGLE_LINE = [];\n\nexport type Character = {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n  layoutWidth: number;\n  layoutHeight: number;\n  layoutOffsetY?: number;\n};\n\nexport type CharacterMapping = Record<string, Character>;\n\nexport function nextPowOfTwo(number: number): number {\n  return Math.pow(2, Math.ceil(Math.log2(number)));\n}\n\n/**\n * Generate character mapping table or update from an existing mapping table\n */\nexport function buildMapping({\n  characterSet,\n  getFontWidth,\n  fontHeight,\n  buffer,\n  maxCanvasWidth,\n  mapping = {},\n  xOffset = 0,\n  yOffset = 0\n}: {\n  /** list of characters */\n  characterSet: Set<string>;\n  /** function to get width of each character */\n  getFontWidth: (char: string) => number;\n  /** height of font */\n  fontHeight: number;\n  /** bleeding buffer surround each character */\n  buffer: number;\n  /** max width of font atlas */\n  maxCanvasWidth: number;\n  /** cached mapping table */\n  mapping?: CharacterMapping;\n  /** x position of last character in the existing mapping table */\n  xOffset?: number;\n  /** y position of last character in the existing mapping table */\n  yOffset?: number;\n}): {\n  /** new mapping table */\n  mapping: CharacterMapping;\n  /** x position of last character in the new mapping table */\n  xOffset: number;\n  /** y position of last character in the new mapping table */\n  yOffset: number;\n  /** height of the font atlas canvas, power of 2 */\n  canvasHeight: number;\n} {\n  let row = 0;\n  // continue from x position of last character in the old mapping\n  let x = xOffset;\n  const rowHeight = fontHeight + buffer * 2;\n\n  for (const char of characterSet) {\n    if (!mapping[char]) {\n      // measure texts\n      // TODO - use Advanced text metrics when they are adopted:\n      // https://developer.mozilla.org/en-US/docs/Web/API/TextMetrics\n      const width = getFontWidth(char);\n\n      if (x + width + buffer * 2 > maxCanvasWidth) {\n        x = 0;\n        row++;\n      }\n      mapping[char] = {\n        x: x + buffer,\n        y: yOffset + row * rowHeight + buffer,\n        width,\n        height: rowHeight,\n        layoutWidth: width,\n        layoutHeight: fontHeight\n      };\n      x += width + buffer * 2;\n    }\n  }\n\n  return {\n    mapping,\n    xOffset: x,\n    yOffset: yOffset + row * rowHeight,\n    canvasHeight: nextPowOfTwo(yOffset + (row + 1) * rowHeight)\n  };\n}\n\nfunction getTextWidth(\n  text: string[],\n  startIndex: number,\n  endIndex: number,\n  mapping: CharacterMapping\n): number {\n  let width = 0;\n  for (let i = startIndex; i < endIndex; i++) {\n    const character = text[i];\n    width += mapping[character]?.layoutWidth || 0;\n  }\n\n  return width;\n}\n\nfunction breakAll(\n  text: string[],\n  startIndex: number,\n  endIndex: number,\n  maxWidth: number,\n  iconMapping: CharacterMapping,\n  target: number[]\n): number {\n  let rowStartCharIndex = startIndex;\n  let rowOffsetLeft = 0;\n\n  for (let i = startIndex; i < endIndex; i++) {\n    // 2. figure out where to break lines\n    const textWidth = getTextWidth(text, i, i + 1, iconMapping);\n    if (rowOffsetLeft + textWidth > maxWidth) {\n      if (rowStartCharIndex < i) {\n        target.push(i);\n      }\n      rowStartCharIndex = i;\n      rowOffsetLeft = 0;\n    }\n    rowOffsetLeft += textWidth;\n  }\n\n  return rowOffsetLeft;\n}\n\nfunction breakWord(\n  text: string[],\n  startIndex: number,\n  endIndex: number,\n  maxWidth: number,\n  iconMapping: CharacterMapping,\n  target: number[]\n): number {\n  let rowStartCharIndex = startIndex;\n  let groupStartCharIndex = startIndex;\n  let groupEndCharIndex = startIndex;\n  let rowOffsetLeft = 0;\n\n  for (let i = startIndex; i < endIndex; i++) {\n    // 1. break text into word groups\n    //  - if current char is white space\n    //  - else if next char is white space\n    //  - else if reach last char\n    if (text[i] === ' ') {\n      groupEndCharIndex = i + 1;\n    } else if (text[i + 1] === ' ' || i + 1 === endIndex) {\n      groupEndCharIndex = i + 1;\n    }\n\n    if (groupEndCharIndex > groupStartCharIndex) {\n      // 2. break text into next row at maxWidth\n      let groupWidth = getTextWidth(text, groupStartCharIndex, groupEndCharIndex, iconMapping);\n      if (rowOffsetLeft + groupWidth > maxWidth) {\n        if (rowStartCharIndex < groupStartCharIndex) {\n          target.push(groupStartCharIndex);\n          rowStartCharIndex = groupStartCharIndex;\n          rowOffsetLeft = 0;\n        }\n\n        // if a single text group is bigger than maxWidth, then `break-all`\n        if (groupWidth > maxWidth) {\n          groupWidth = breakAll(\n            text,\n            groupStartCharIndex,\n            groupEndCharIndex,\n            maxWidth,\n            iconMapping,\n            target\n          );\n          // move reference to last row\n          rowStartCharIndex = target[target.length - 1];\n        }\n      }\n      groupStartCharIndex = groupEndCharIndex;\n      rowOffsetLeft += groupWidth;\n    }\n  }\n\n  return rowOffsetLeft;\n}\n\n/**\n * Wrap the given text so that each line does not exceed the given max width.\n * Returns a list of indices where line breaks should be inserted.\n */\nexport function autoWrapping(\n  text: string[],\n  wordBreak: 'break-all' | 'break-word',\n  maxWidth: number,\n  iconMapping: CharacterMapping,\n  startIndex: number = 0,\n  endIndex: number\n): number[] {\n  if (endIndex === undefined) {\n    endIndex = text.length;\n  }\n  const result = [];\n  if (wordBreak === 'break-all') {\n    breakAll(text, startIndex, endIndex, maxWidth, iconMapping, result);\n  } else {\n    breakWord(text, startIndex, endIndex, maxWidth, iconMapping, result);\n  }\n  return result;\n}\n\nfunction transformRow(\n  line: string[],\n  startIndex: number,\n  endIndex: number,\n  iconMapping: CharacterMapping,\n  leftOffsets: number[],\n  rowSize: [number, number]\n) {\n  let x = 0;\n  let rowHeight = 0;\n\n  for (let i = startIndex; i < endIndex; i++) {\n    const character = line[i];\n    const frame = iconMapping[character];\n    if (frame) {\n      if (!rowHeight) {\n        // frame.height should be a constant\n        rowHeight = frame.layoutHeight;\n      }\n      leftOffsets[i] = x + frame.layoutWidth / 2;\n      x += frame.layoutWidth;\n    } else {\n      log.warn(`Missing character: ${character} (${character.codePointAt(0)})`)();\n      leftOffsets[i] = x;\n      x += MISSING_CHAR_WIDTH;\n    }\n  }\n\n  rowSize[0] = x;\n  rowSize[1] = rowHeight;\n}\n\n/**\n * Transform a text paragraph to an array of characters, each character contains\n */\nexport function transformParagraph(\n  paragraph: string,\n  /** CSS line-height */\n  lineHeight: number,\n  /** CSS word-break option */\n  wordBreak: 'break-word' | 'break-all',\n  /** CSS max-width */\n  maxWidth: number,\n  /** character mapping table for retrieving a character from font atlas */\n  iconMapping: CharacterMapping\n): {\n  /** x position of each character */\n  x: number[];\n  /** y position of each character */\n  y: number[];\n  /** the current row width of each character */\n  rowWidth: number[];\n  /** the width and height of the paragraph */\n  size: [number, number];\n} {\n  // Break into an array of characters\n  // When dealing with double-length unicode characters, `str.length` or `str[i]` do not work\n  const characters = Array.from(paragraph);\n  const numCharacters = characters.length;\n  const x = new Array(numCharacters) as number[];\n  const y = new Array(numCharacters) as number[];\n  const rowWidth = new Array(numCharacters) as number[];\n  const autoWrappingEnabled =\n    (wordBreak === 'break-word' || wordBreak === 'break-all') && isFinite(maxWidth) && maxWidth > 0;\n\n  // maxWidth and height of the paragraph\n  const size: [number, number] = [0, 0];\n  const rowSize: [number, number] = [0, 0];\n  let rowOffsetTop = 0;\n  let lineStartIndex = 0;\n  let lineEndIndex = 0;\n\n  for (let i = 0; i <= numCharacters; i++) {\n    const char = characters[i];\n    if (char === '\\n' || i === numCharacters) {\n      lineEndIndex = i;\n    }\n\n    if (lineEndIndex > lineStartIndex) {\n      const rows = autoWrappingEnabled\n        ? autoWrapping(characters, wordBreak, maxWidth, iconMapping, lineStartIndex, lineEndIndex)\n        : SINGLE_LINE;\n\n      for (let rowIndex = 0; rowIndex <= rows.length; rowIndex++) {\n        const rowStart = rowIndex === 0 ? lineStartIndex : rows[rowIndex - 1];\n        const rowEnd = rowIndex < rows.length ? rows[rowIndex] : lineEndIndex;\n\n        transformRow(characters, rowStart, rowEnd, iconMapping, x, rowSize);\n        for (let j = rowStart; j < rowEnd; j++) {\n          const char = characters[j];\n          const layoutOffsetY = iconMapping[char]?.layoutOffsetY || 0;\n          y[j] = rowOffsetTop + rowSize[1] / 2 + layoutOffsetY;\n          rowWidth[j] = rowSize[0];\n        }\n\n        rowOffsetTop = rowOffsetTop + rowSize[1] * lineHeight;\n        size[0] = Math.max(size[0], rowSize[0]);\n      }\n      lineStartIndex = lineEndIndex;\n    }\n\n    if (char === '\\n') {\n      // Make sure result.length matches paragraph.length\n      x[lineStartIndex] = 0;\n      y[lineStartIndex] = 0;\n      rowWidth[lineStartIndex] = 0;\n      lineStartIndex++;\n    }\n  }\n\n  // last row\n  size[1] = rowOffsetTop;\n  return {x, y, rowWidth, size};\n}\n\nexport function getTextFromBuffer({\n  value,\n  length,\n  stride,\n  offset,\n  startIndices,\n  characterSet\n}: {\n  value: Uint8Array | Uint8ClampedArray | Uint16Array | Uint32Array;\n  length: number;\n  stride?: number;\n  offset?: number;\n  startIndices: NumericArray;\n  characterSet?: Set<string>;\n}): {\n  texts: string[];\n  characterCount: number;\n} {\n  const bytesPerElement = value.BYTES_PER_ELEMENT;\n  const elementStride = stride ? stride / bytesPerElement : 1;\n  const elementOffset = offset ? offset / bytesPerElement : 0;\n  const characterCount =\n    startIndices[length] || Math.ceil((value.length - elementOffset) / elementStride);\n  const autoCharacterSet = characterSet && new Set<number>();\n\n  const texts = new Array(length);\n\n  let codes = value;\n  if (elementStride > 1 || elementOffset > 0) {\n    const ArrayType = value.constructor as\n      | Uint8ArrayConstructor\n      | Uint8ClampedArrayConstructor\n      | Uint16ArrayConstructor\n      | Uint32ArrayConstructor;\n    codes = new ArrayType(characterCount);\n    for (let i = 0; i < characterCount; i++) {\n      codes[i] = value[i * elementStride + elementOffset];\n    }\n  }\n\n  for (let index = 0; index < length; index++) {\n    const startIndex = startIndices[index];\n    const endIndex = startIndices[index + 1] || characterCount;\n    const codesAtIndex = codes.subarray(startIndex, endIndex);\n    // @ts-ignore TS wants the argument to be number[] but typed array works too\n    texts[index] = String.fromCodePoint.apply(null, codesAtIndex);\n    if (autoCharacterSet) {\n      // eslint-disable-next-line @typescript-eslint/unbound-method\n      codesAtIndex.forEach(autoCharacterSet.add, autoCharacterSet);\n    }\n  }\n\n  if (autoCharacterSet) {\n    for (const charCode of autoCharacterSet) {\n      characterSet.add(String.fromCodePoint(charCode));\n    }\n  }\n\n  return {texts, characterCount};\n}\n","/**\n * LRU Cache class with limit\n *\n * Update order for each get/set operation\n * Delete oldest when reach given limit\n */\n\nexport default class LRUCache<ValueT> {\n  private limit: number;\n  private _cache: Record<string, ValueT> = {};\n  /** access/update order, first item is oldest, last item is newest */\n  private _order: string[] = [];\n\n  constructor(limit: number = 5) {\n    this.limit = limit;\n  }\n\n  get(key: string): ValueT {\n    const value = this._cache[key];\n    if (value) {\n      // update order\n      this._deleteOrder(key);\n      this._appendOrder(key);\n    }\n    return value;\n  }\n\n  set(key: string, value: ValueT): void {\n    if (!this._cache[key]) {\n      // if reach limit, delete the oldest\n      if (Object.keys(this._cache).length === this.limit) {\n        this.delete(this._order[0]);\n      }\n\n      this._cache[key] = value;\n      this._appendOrder(key);\n    } else {\n      // if found in cache, delete the old one, insert new one to the first of list\n      this.delete(key);\n\n      this._cache[key] = value;\n      this._appendOrder(key);\n    }\n  }\n\n  delete(key: string): void {\n    const value = this._cache[key];\n    if (value) {\n      delete this._cache[key];\n      this._deleteOrder(key);\n    }\n  }\n\n  private _deleteOrder(key: string): void {\n    const index = this._order.indexOf(key);\n    if (index >= 0) {\n      this._order.splice(index, 1);\n    }\n  }\n\n  private _appendOrder(key: string): void {\n    this._order.push(key);\n  }\n}\n","/* global document */\nimport TinySDF from '@mapbox/tiny-sdf';\n\nimport {log} from '@deck.gl/core';\n\nimport {buildMapping, CharacterMapping} from './utils';\nimport LRUCache from './lru-cache';\n\nimport type {Texture} from '@deck.gl/core';\n\nfunction getDefaultCharacterSet() {\n  const charSet: string[] = [];\n  for (let i = 32; i < 128; i++) {\n    charSet.push(String.fromCharCode(i));\n  }\n  return charSet;\n}\n\nexport type FontSettings = {\n  /** CSS font family\n   * @default 'Monaco, monospace'\n   */\n  fontFamily?: string;\n  /** CSS font weight\n   * @default 'normal'\n   */\n  fontWeight?: string | number;\n  /** Specifies a list of characters to include in the font.\n   * @default (ASCII characters 32-128)\n   */\n  characterSet?: Set<string> | string[] | string;\n  /** Font size in pixels. This option is only applied for generating `fontAtlas`, it does not impact the size of displayed text labels. Larger `fontSize` will give you a sharper look when rendering text labels with very large font sizes. But larger `fontSize` requires more time and space to generate the `fontAtlas`.\n   * @default 64\n   */\n  fontSize?: number;\n  /** Whitespace buffer around each side of the character. In general, bigger `fontSize` requires bigger `buffer`. Increase `buffer` will add more space between each character when layout `characterSet` in `fontAtlas`. This option could be tuned to provide sufficient space for drawing each character and avoiding overlapping of neighboring characters.\n   * @default 4\n   */\n  buffer?: number;\n  /** Flag to enable / disable `sdf`. [`sdf` (Signed Distance Fields)](http://cs.brown.edu/people/pfelzens/papers/dt-final.pdf) will provide a sharper look when rendering with very large or small font sizes. `TextLayer` integrates with [`TinySDF`](https://github.com/mapbox/tiny-sdf) which implements the `sdf` algorithm.\n   * @default false\n   */\n  sdf?: boolean;\n  /** How much of the radius (relative) is used for the inside part the glyph. Bigger `cutoff` makes character thinner. Smaller `cutoff` makes character look thicker. Only applies when `sdf: true`.\n   * @default 0.25\n   */\n  cutoff?: number;\n  /** How many pixels around the glyph shape to use for encoding distance. Bigger radius yields higher quality outcome. Only applies when `sdf: true`.\n   * @default 12\n   */\n  radius?: number;\n  /** How much smoothing to apply to the text edges. Only applies when `sdf: true`.\n   * @default 0.1\n   */\n  smoothing?: number;\n};\n\nexport const DEFAULT_FONT_SETTINGS: Required<FontSettings> = {\n  fontFamily: 'Monaco, monospace',\n  fontWeight: 'normal',\n  characterSet: getDefaultCharacterSet(),\n  fontSize: 64,\n  buffer: 4,\n  sdf: false,\n  cutoff: 0.25,\n  radius: 12,\n  smoothing: 0.1\n};\n\nconst MAX_CANVAS_WIDTH = 1024;\n\nconst BASELINE_SCALE = 0.9;\nconst HEIGHT_SCALE = 1.2;\n\n// only preserve latest three fontAtlas\nconst CACHE_LIMIT = 3;\n\ntype FontAtlas = {\n  /** x position of last character in mapping */\n  xOffset: number;\n  /** y position of last character in mapping */\n  yOffset: number;\n  /** bounding box of each character in the texture */\n  mapping: CharacterMapping;\n  /** packed texture */\n  data: HTMLCanvasElement;\n  /** texture width */\n  width: number;\n  /** texture height */\n  height: number;\n};\n\nlet cache = new LRUCache<FontAtlas>(CACHE_LIMIT);\n\n/**\n * get all the chars not in cache\n * @returns chars not in cache\n */\nfunction getNewChars(cacheKey: string, characterSet: Set<string> | string[] | string): Set<string> {\n  let newCharSet: Set<string>;\n  if (typeof characterSet === 'string') {\n    newCharSet = new Set(Array.from(characterSet));\n  } else {\n    newCharSet = new Set(characterSet);\n  }\n\n  const cachedFontAtlas = cache.get(cacheKey);\n  if (!cachedFontAtlas) {\n    return newCharSet;\n  }\n\n  for (const char in cachedFontAtlas.mapping) {\n    if (newCharSet.has(char)) {\n      newCharSet.delete(char);\n    }\n  }\n  return newCharSet;\n}\n\nfunction populateAlphaChannel(alphaChannel: Uint8ClampedArray, imageData: ImageData): void {\n  // populate distance value from tinySDF to image alpha channel\n  for (let i = 0; i < alphaChannel.length; i++) {\n    imageData.data[4 * i + 3] = alphaChannel[i];\n  }\n}\n\nfunction setTextStyle(\n  ctx: CanvasRenderingContext2D,\n  fontFamily: string,\n  fontSize: number,\n  fontWeight: string | number\n): void {\n  ctx.font = `${fontWeight} ${fontSize}px ${fontFamily}`;\n  ctx.fillStyle = '#000';\n  ctx.textBaseline = 'alphabetic';\n  ctx.textAlign = 'left';\n}\n\n/**\n * Sets the Font Atlas LRU Cache Limit\n * @param {number} limit LRU Cache limit\n */\nexport function setFontAtlasCacheLimit(limit: number): void {\n  log.assert(Number.isFinite(limit) && limit >= CACHE_LIMIT, 'Invalid cache limit');\n\n  cache = new LRUCache(limit);\n}\n\nexport default class FontAtlasManager {\n  /** Font settings */\n  props: Required<FontSettings> = {...DEFAULT_FONT_SETTINGS};\n\n  /** Cache key of the current font atlas */\n  private _key?: string;\n  /** The current font atlas */\n  private _atlas?: FontAtlas;\n\n  get texture(): Texture | undefined {\n    return this._atlas;\n  }\n\n  get mapping(): CharacterMapping | undefined {\n    return this._atlas && this._atlas.mapping;\n  }\n\n  get scale(): number {\n    const {fontSize, buffer} = this.props;\n    return (fontSize * HEIGHT_SCALE + buffer * 2) / fontSize;\n  }\n\n  setProps(props: FontSettings = {}) {\n    Object.assign(this.props, props);\n\n    // update cache key\n    this._key = this._getKey();\n\n    const charSet = getNewChars(this._key, this.props.characterSet);\n    const cachedFontAtlas = cache.get(this._key);\n\n    // if a fontAtlas associated with the new settings is cached and\n    // there are no new chars\n    if (cachedFontAtlas && charSet.size === 0) {\n      // update texture with cached fontAtlas\n      if (this._atlas !== cachedFontAtlas) {\n        this._atlas = cachedFontAtlas;\n      }\n      return;\n    }\n\n    // update fontAtlas with new settings\n    const fontAtlas = this._generateFontAtlas(charSet, cachedFontAtlas);\n    this._atlas = fontAtlas;\n\n    // update cache\n    cache.set(this._key, fontAtlas);\n  }\n\n  // eslint-disable-next-line max-statements\n  private _generateFontAtlas(characterSet: Set<string>, cachedFontAtlas?: FontAtlas): FontAtlas {\n    const {fontFamily, fontWeight, fontSize, buffer, sdf, radius, cutoff} = this.props;\n    let canvas = cachedFontAtlas && cachedFontAtlas.data;\n    if (!canvas) {\n      canvas = document.createElement('canvas');\n      canvas.width = MAX_CANVAS_WIDTH;\n    }\n    const ctx = canvas.getContext('2d')!;\n\n    setTextStyle(ctx, fontFamily, fontSize, fontWeight);\n\n    // 1. build mapping\n    const {mapping, canvasHeight, xOffset, yOffset} = buildMapping({\n      getFontWidth: char => ctx.measureText(char).width,\n      fontHeight: fontSize * HEIGHT_SCALE,\n      buffer,\n      characterSet,\n      maxCanvasWidth: MAX_CANVAS_WIDTH,\n      ...(cachedFontAtlas && {\n        mapping: cachedFontAtlas.mapping,\n        xOffset: cachedFontAtlas.xOffset,\n        yOffset: cachedFontAtlas.yOffset\n      })\n    });\n\n    // 2. update canvas\n    // copy old canvas data to new canvas only when height changed\n    if (canvas.height !== canvasHeight) {\n      const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);\n      canvas.height = canvasHeight;\n      ctx.putImageData(imageData, 0, 0);\n    }\n    setTextStyle(ctx, fontFamily, fontSize, fontWeight);\n\n    // 3. layout characters\n    if (sdf) {\n      const tinySDF = new TinySDF({\n        fontSize,\n        buffer,\n        radius,\n        cutoff,\n        fontFamily,\n        fontWeight: `${fontWeight}`\n      });\n\n      for (const char of characterSet) {\n        const {data, width, height, glyphTop} = tinySDF.draw(char);\n        mapping[char].width = width;\n        mapping[char].layoutOffsetY = fontSize * BASELINE_SCALE - glyphTop;\n\n        const imageData = ctx.createImageData(width, height);\n        populateAlphaChannel(data, imageData);\n        ctx.putImageData(imageData, mapping[char].x, mapping[char].y);\n      }\n    } else {\n      for (const char of characterSet) {\n        ctx.fillText(char, mapping[char].x, mapping[char].y + buffer + fontSize * BASELINE_SCALE);\n      }\n    }\n\n    return {\n      xOffset,\n      yOffset,\n      mapping,\n      data: canvas,\n      width: canvas.width,\n      height: canvas.height\n    };\n  }\n\n  private _getKey(): string {\n    const {fontFamily, fontWeight, fontSize, buffer, sdf, radius, cutoff} = this.props;\n    if (sdf) {\n      return `${fontFamily} ${fontWeight} ${fontSize} ${buffer} ${radius} ${cutoff}`;\n    }\n    return `${fontFamily} ${fontWeight} ${fontSize} ${buffer}`;\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {CompositeLayer, createIterable} from '@deck.gl/core';\nimport MultiIconLayer from './multi-icon-layer/multi-icon-layer';\nimport FontAtlasManager, {\n  DEFAULT_FONT_SETTINGS,\n  setFontAtlasCacheLimit\n} from './font-atlas-manager';\nimport {transformParagraph, getTextFromBuffer} from './utils';\n\nimport TextBackgroundLayer from './text-background-layer/text-background-layer';\n\nimport type {FontSettings} from './font-atlas-manager';\nimport type {\n  LayerProps,\n  Accessor,\n  AccessorFunction,\n  Unit,\n  Position,\n  Color,\n  UpdateParameters,\n  GetPickingInfoParams,\n  PickingInfo,\n  DefaultProps\n} from '@deck.gl/core';\n\nconst TEXT_ANCHOR = {\n  start: 1,\n  middle: 0,\n  end: -1\n} as const;\n\nconst ALIGNMENT_BASELINE = {\n  top: 1,\n  center: 0,\n  bottom: -1\n} as const;\n\nconst DEFAULT_COLOR: [number, number, number, number] = [0, 0, 0, 255];\n\nconst DEFAULT_LINE_HEIGHT = 1.0;\n\ntype _TextLayerProps<DataT> = {\n  /** If `true`, the text always faces camera. Otherwise the text faces up (z).\n   * @default true\n   */\n  billboard?: boolean;\n  /**\n   * Text size multiplier.\n   * @default 1\n   */\n  sizeScale?: number;\n  /**\n   * The units of the size, one of `'meters'`, `'common'`, and `'pixels'`.\n   * @default 'pixels'\n   */\n  sizeUnits?: Unit;\n  /**\n   * The minimum size in pixels. When using non-pixel `sizeUnits`, this prop can be used to prevent the icon from getting too small when zoomed out.\n   * @default 0\n   */\n  sizeMinPixels?: number;\n  /**\n   * The maximum size in pixels. When using non-pixel `sizeUnits`, this prop can be used to prevent the icon from getting too big when zoomed in.\n   * @default Number.MAX_SAFE_INTEGER\n   */\n  sizeMaxPixels?: number;\n\n  /** Whether to render background for the text blocks.\n   * @default false\n   */\n  background?: boolean;\n  /** Background color accessor.\n   * @default [255, 255, 255, 255]\n   */\n  getBackgroundColor?: Accessor<DataT, Color>;\n  /** Border color accessor.\n   * @default [0, 0, 0, 255]\n   */\n  getBorderColor?: Accessor<DataT, Color>;\n  /** Border width accessor.\n   * @default 0\n   */\n  getBorderWidth?: Accessor<DataT, number>;\n  /**\n   * The padding of the background..\n   * If an array of 2 is supplied, it is interpreted as `[padding_x, padding_y]` in pixels.\n   * If an array of 4 is supplied, it is interpreted as `[padding_left, padding_top, padding_right, padding_bottom]` in pixels.\n   * @default [0, 0, 0, 0]\n   */\n  backgroundPadding?: [number, number] | [number, number, number, number];\n  /**\n   * Specifies a list of characters to include in the font. If set to 'auto', will be automatically generated from the data set.\n   * @default (ASCII characters 32-128)\n   */\n  characterSet?: FontSettings['characterSet'] | 'auto';\n  /** CSS font family\n   * @default 'Monaco, monospace'\n   */\n  fontFamily?: FontSettings['fontFamily'];\n  /** CSS font weight\n   * @default 'normal'\n   */\n  fontWeight?: FontSettings['fontWeight'];\n  /** A unitless number that will be multiplied with the current font size to set the line height.\n   * @default 'normal'\n   */\n  lineHeight?: number;\n  /**\n   * Width of outline around the text, relative to the font size. Only effective if `fontSettings.sdf` is `true`.\n   * @default 0\n   */\n  outlineWidth?: number;\n  /**\n   * Color of outline around the text, in `[r, g, b, [a]]`. Each channel is a number between 0-255 and `a` is 255 if not supplied.\n   * @default [0, 0, 0, 255]\n   */\n  outlineColor?: Color;\n  /**\n   * Advance options for fine tuning the appearance and performance of the generated shared `fontAtlas`.\n   */\n  fontSettings?: FontSettings;\n  /**\n   * Available options are `break-all` and `break-word`. A valid `maxWidth` has to be provided to use `wordBreak`.\n   * @default 'break-word'\n   */\n  wordBreak?: 'break-word' | 'break-all';\n  /**\n   * `maxWidth` is used together with `break-word` for wrapping text. The value of `maxWidth` specifies the width limit to break the text into multiple lines.\n   * @default -1\n   */\n  maxWidth?: number;\n  /**\n   * Label text accessor\n   */\n  getText?: AccessorFunction<DataT, string>;\n  /**\n   * Anchor position accessor\n   */\n  getPosition?: Accessor<DataT, Position>;\n  /**\n   * Label color accessor\n   * @default [0, 0, 0, 255]\n   */\n  getColor?: Accessor<DataT, Color>;\n  /**\n   * Label size accessor\n   * @default 32\n   */\n  getSize?: Accessor<DataT, number>;\n  /**\n   * Label rotation accessor, in degrees\n   * @default 0\n   */\n  getAngle?: Accessor<DataT, number>;\n  /**\n   * Horizontal alignment accessor\n   * @default 'middle'\n   */\n  getTextAnchor?: Accessor<DataT, 'start' | 'middle' | 'end'>;\n  /**\n   * Vertical alignment accessor\n   * @default 'center'\n   */\n  getAlignmentBaseline?: Accessor<DataT, 'top' | 'center' | 'bottom'>;\n  /**\n   * Label offset from the anchor position, [x, y] in pixels\n   * @default [0, 0]\n   */\n  getPixelOffset?: Accessor<DataT, [number, number]>;\n  /**\n   * @deprecated Use `background` and `getBackgroundColor` instead\n   */\n  backgroundColor?: Color;\n};\n\nexport type TextLayerProps<DataT = any> = _TextLayerProps<DataT> & LayerProps<DataT>;\n\nconst defaultProps: DefaultProps<TextLayerProps> = {\n  billboard: true,\n  sizeScale: 1,\n  sizeUnits: 'pixels',\n  sizeMinPixels: 0,\n  sizeMaxPixels: Number.MAX_SAFE_INTEGER,\n\n  background: false,\n  getBackgroundColor: {type: 'accessor', value: [255, 255, 255, 255]},\n  getBorderColor: {type: 'accessor', value: DEFAULT_COLOR},\n  getBorderWidth: {type: 'accessor', value: 0},\n  backgroundPadding: {type: 'array', value: [0, 0, 0, 0]},\n\n  characterSet: {type: 'object', value: DEFAULT_FONT_SETTINGS.characterSet},\n  fontFamily: DEFAULT_FONT_SETTINGS.fontFamily,\n  fontWeight: DEFAULT_FONT_SETTINGS.fontWeight,\n  lineHeight: DEFAULT_LINE_HEIGHT,\n  outlineWidth: {type: 'number', value: 0, min: 0},\n  outlineColor: {type: 'color', value: DEFAULT_COLOR},\n  fontSettings: {},\n\n  // auto wrapping options\n  wordBreak: 'break-word',\n  maxWidth: {type: 'number', value: -1},\n\n  getText: {type: 'accessor', value: x => x.text},\n  getPosition: {type: 'accessor', value: x => x.position},\n  getColor: {type: 'accessor', value: DEFAULT_COLOR},\n  getSize: {type: 'accessor', value: 32},\n  getAngle: {type: 'accessor', value: 0},\n  getTextAnchor: {type: 'accessor', value: 'middle'},\n  getAlignmentBaseline: {type: 'accessor', value: 'center'},\n  getPixelOffset: {type: 'accessor', value: [0, 0]},\n\n  // deprecated\n  backgroundColor: {deprecatedFor: ['background', 'getBackgroundColor']}\n};\n\n/** Render text labels at given coordinates. */\nexport default class TextLayer<DataT = any, ExtraPropsT = {}> extends CompositeLayer<\n  ExtraPropsT & Required<_TextLayerProps<DataT>>\n> {\n  static defaultProps = defaultProps;\n  static layerName = 'TextLayer';\n\n  state!: {\n    styleVersion: number;\n    fontAtlasManager: FontAtlasManager;\n    characterSet?: Set<string>;\n    startIndices?: number[];\n    numInstances?: number;\n    getText?: AccessorFunction<DataT, string>;\n  };\n\n  initializeState() {\n    this.state = {\n      styleVersion: 0,\n      fontAtlasManager: new FontAtlasManager()\n    };\n  }\n\n  // eslint-disable-next-line complexity\n  updateState(params: UpdateParameters<this>) {\n    const {props, oldProps, changeFlags} = params;\n    const textChanged =\n      changeFlags.dataChanged ||\n      (changeFlags.updateTriggersChanged &&\n        (changeFlags.updateTriggersChanged.all || changeFlags.updateTriggersChanged.getText));\n\n    if (textChanged) {\n      this._updateText();\n    }\n\n    const fontChanged = this._updateFontAtlas();\n\n    const styleChanged =\n      fontChanged ||\n      props.lineHeight !== oldProps.lineHeight ||\n      props.wordBreak !== oldProps.wordBreak ||\n      props.maxWidth !== oldProps.maxWidth;\n\n    if (styleChanged) {\n      this.setState({\n        styleVersion: this.state.styleVersion + 1\n      });\n    }\n  }\n\n  getPickingInfo({info}: GetPickingInfoParams): PickingInfo {\n    // because `TextLayer` assign the same pickingInfoIndex for one text label,\n    // here info.index refers the index of text label in props.data\n    info.object = info.index >= 0 ? this.props.data[info.index] : null;\n    return info;\n  }\n\n  /** Returns true if font has changed */\n  private _updateFontAtlas(): boolean {\n    const {fontSettings, fontFamily, fontWeight} = this.props;\n    const {fontAtlasManager, characterSet} = this.state;\n\n    const fontProps = {\n      ...fontSettings,\n      characterSet,\n      fontFamily,\n      fontWeight\n    };\n\n    if (!fontAtlasManager.mapping) {\n      // This is the first update\n      fontAtlasManager.setProps(fontProps);\n      return true;\n    }\n\n    for (const key in fontProps) {\n      if (fontProps[key] !== fontAtlasManager.props[key]) {\n        fontAtlasManager.setProps(fontProps);\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  // Text strings are variable width objects\n  // Count characters and start offsets\n  private _updateText() {\n    const {data, characterSet} = this.props;\n    const textBuffer = (data as any).attributes?.getText;\n    let {getText} = this.props;\n    let startIndices: number[] = (data as any).startIndices;\n    let numInstances: number;\n\n    const autoCharacterSet = characterSet === 'auto' && new Set();\n\n    if (textBuffer && startIndices) {\n      const {texts, characterCount} = getTextFromBuffer({\n        ...(ArrayBuffer.isView(textBuffer) ? {value: textBuffer} : textBuffer),\n        // @ts-ignore if data.attribute is defined then length is expected\n        length: data.length,\n        startIndices,\n        characterSet: autoCharacterSet\n      });\n      numInstances = characterCount;\n      getText = (_, {index}) => texts[index];\n    } else {\n      const {iterable, objectInfo} = createIterable(data);\n      startIndices = [0];\n      numInstances = 0;\n\n      for (const object of iterable) {\n        objectInfo.index++;\n        // Break into an array of characters\n        // When dealing with double-length unicode characters, `str.length` or `str[i]` do not work\n        const text = Array.from(getText(object, objectInfo) || '');\n        if (autoCharacterSet) {\n          // eslint-disable-next-line @typescript-eslint/unbound-method\n          text.forEach(autoCharacterSet.add, autoCharacterSet);\n        }\n        numInstances += text.length;\n        startIndices.push(numInstances);\n      }\n    }\n\n    this.setState({\n      getText,\n      startIndices,\n      numInstances,\n      characterSet: autoCharacterSet || characterSet\n    });\n  }\n\n  // Returns the x, y offsets of each character in a text string\n  private getBoundingRect: AccessorFunction<DataT, [number, number, number, number]> = (\n    object,\n    objectInfo\n  ) => {\n    const iconMapping = this.state.fontAtlasManager.mapping!;\n    const getText = this.state.getText!;\n    const {wordBreak, maxWidth, lineHeight, getTextAnchor, getAlignmentBaseline} = this.props;\n\n    const paragraph = getText(object, objectInfo) || '';\n    const {\n      size: [width, height]\n    } = transformParagraph(paragraph, lineHeight, wordBreak, maxWidth, iconMapping);\n    const anchorX =\n      TEXT_ANCHOR[\n        typeof getTextAnchor === 'function' ? getTextAnchor(object, objectInfo) : getTextAnchor\n      ];\n    const anchorY =\n      ALIGNMENT_BASELINE[\n        typeof getAlignmentBaseline === 'function'\n          ? getAlignmentBaseline(object, objectInfo)\n          : getAlignmentBaseline\n      ];\n\n    return [((anchorX - 1) * width) / 2, ((anchorY - 1) * height) / 2, width, height];\n  };\n\n  // Returns the x, y, w, h of each text object\n  private getIconOffsets: AccessorFunction<DataT, number[]> = (object, objectInfo) => {\n    const iconMapping = this.state.fontAtlasManager.mapping!;\n    const getText = this.state.getText!;\n    const {wordBreak, maxWidth, lineHeight, getTextAnchor, getAlignmentBaseline} = this.props;\n\n    const paragraph = getText(object, objectInfo) || '';\n    const {\n      x,\n      y,\n      rowWidth,\n      size: [width, height]\n    } = transformParagraph(paragraph, lineHeight, wordBreak, maxWidth, iconMapping);\n    const anchorX =\n      TEXT_ANCHOR[\n        typeof getTextAnchor === 'function' ? getTextAnchor(object, objectInfo) : getTextAnchor\n      ];\n    const anchorY =\n      ALIGNMENT_BASELINE[\n        typeof getAlignmentBaseline === 'function'\n          ? getAlignmentBaseline(object, objectInfo)\n          : getAlignmentBaseline\n      ];\n\n    const numCharacters = x.length;\n    const offsets = new Array(numCharacters * 2);\n    let index = 0;\n\n    for (let i = 0; i < numCharacters; i++) {\n      // For a multi-line object, offset in x-direction needs consider\n      // the row offset in the paragraph and the object offset in the row\n      const rowOffset = ((1 - anchorX) * (width - rowWidth[i])) / 2;\n      offsets[index++] = ((anchorX - 1) * width) / 2 + rowOffset + x[i];\n      offsets[index++] = ((anchorY - 1) * height) / 2 + y[i];\n    }\n    return offsets;\n  };\n\n  renderLayers() {\n    const {\n      startIndices,\n      numInstances,\n      getText,\n      fontAtlasManager: {scale, texture, mapping},\n      styleVersion\n    } = this.state;\n\n    const {\n      data,\n      _dataDiff,\n      getPosition,\n      getColor,\n      getSize,\n      getAngle,\n      getPixelOffset,\n      getBackgroundColor,\n      getBorderColor,\n      getBorderWidth,\n      backgroundPadding,\n      background,\n      billboard,\n      fontSettings,\n      outlineWidth,\n      outlineColor,\n      sizeScale,\n      sizeUnits,\n      sizeMinPixels,\n      sizeMaxPixels,\n      transitions,\n      updateTriggers\n    } = this.props;\n\n    const CharactersLayerClass = this.getSubLayerClass('characters', MultiIconLayer);\n    const BackgroundLayerClass = this.getSubLayerClass('background', TextBackgroundLayer);\n\n    return [\n      background &&\n        new BackgroundLayerClass(\n          {\n            // background props\n            getFillColor: getBackgroundColor,\n            getLineColor: getBorderColor,\n            getLineWidth: getBorderWidth,\n            padding: backgroundPadding,\n\n            // props shared with characters layer\n            getPosition,\n            getSize,\n            getAngle,\n            getPixelOffset,\n            billboard,\n            sizeScale: sizeScale / this.state.fontAtlasManager.props.fontSize,\n            sizeUnits,\n            sizeMinPixels,\n            sizeMaxPixels,\n\n            transitions: transitions && {\n              getPosition: transitions.getPosition,\n              getAngle: transitions.getAngle,\n              getSize: transitions.getSize,\n              getFillColor: transitions.getBackgroundColor,\n              getLineColor: transitions.getBorderColor,\n              getLineWidth: transitions.getBorderWidth,\n              getPixelOffset: transitions.getPixelOffset\n            }\n          },\n          this.getSubLayerProps({\n            id: 'background',\n            updateTriggers: {\n              getPosition: updateTriggers.getPosition,\n              getAngle: updateTriggers.getAngle,\n              getSize: updateTriggers.getSize,\n              getFillColor: updateTriggers.getBackgroundColor,\n              getLineColor: updateTriggers.getBorderColor,\n              getLineWidth: updateTriggers.getBorderWidth,\n              getPixelOffset: updateTriggers.getPixelOffset,\n              getBoundingRect: {\n                getText: updateTriggers.getText,\n                getTextAnchor: updateTriggers.getTextAnchor,\n                getAlignmentBaseline: updateTriggers.getAlignmentBaseline,\n                styleVersion\n              }\n            }\n          }),\n          {\n            data:\n              // @ts-ignore (2339) attribute is not defined on all data types\n              data.attributes && data.attributes.background\n                ? // @ts-ignore (2339) attribute is not defined on all data types\n                  {length: data.length, attributes: data.attributes.background}\n                : data,\n            _dataDiff,\n            // Maintain the same background behavior as <=8.3. Remove in v9?\n            autoHighlight: false,\n            getBoundingRect: this.getBoundingRect\n          }\n        ),\n      new CharactersLayerClass(\n        {\n          sdf: fontSettings.sdf,\n          smoothing: Number.isFinite(fontSettings.smoothing)\n            ? fontSettings.smoothing\n            : DEFAULT_FONT_SETTINGS.smoothing,\n          outlineWidth: outlineWidth / (fontSettings.radius || DEFAULT_FONT_SETTINGS.radius),\n          outlineColor,\n          iconAtlas: texture,\n          iconMapping: mapping,\n\n          getPosition,\n          getColor,\n          getSize,\n          getAngle,\n          getPixelOffset,\n\n          billboard,\n          sizeScale: sizeScale * scale,\n          sizeUnits,\n          sizeMinPixels: sizeMinPixels * scale,\n          sizeMaxPixels: sizeMaxPixels * scale,\n\n          transitions: transitions && {\n            getPosition: transitions.getPosition,\n            getAngle: transitions.getAngle,\n            getColor: transitions.getColor,\n            getSize: transitions.getSize,\n            getPixelOffset: transitions.getPixelOffset\n          }\n        },\n        this.getSubLayerProps({\n          id: 'characters',\n          updateTriggers: {\n            getIcon: updateTriggers.getText,\n            getPosition: updateTriggers.getPosition,\n            getAngle: updateTriggers.getAngle,\n            getColor: updateTriggers.getColor,\n            getSize: updateTriggers.getSize,\n            getPixelOffset: updateTriggers.getPixelOffset,\n            getIconOffsets: {\n              getText: updateTriggers.getText,\n              getTextAnchor: updateTriggers.getTextAnchor,\n              getAlignmentBaseline: updateTriggers.getAlignmentBaseline,\n              styleVersion\n            }\n          }\n        }),\n        {\n          data,\n          _dataDiff,\n          startIndices,\n          numInstances,\n          getIconOffsets: this.getIconOffsets,\n          getIcon: getText\n        }\n      )\n    ];\n  }\n\n  static set fontAtlasCacheLimit(limit: number) {\n    setFontAtlasCacheLimit(limit);\n  }\n}\n","import {log, BinaryAttribute} from '@deck.gl/core';\nimport {Geometry, uid} from '@luma.gl/core';\nimport {modifyPolygonWindingDirection, WINDING} from '@math.gl/polygon';\n\ntype ColumnGeometryProps = {\n  id?: string;\n  radius: number;\n  height?: number;\n  nradial?: number;\n  vertices?: number[];\n};\n\nexport default class ColumnGeometry extends Geometry {\n  constructor(props: ColumnGeometryProps) {\n    const {id = uid('column-geometry')} = props;\n    const {indices, attributes} = tesselateColumn(props);\n    super({\n      ...props,\n      id,\n      indices,\n      attributes\n    });\n  }\n}\n\n/* eslint-disable max-statements, complexity */\nfunction tesselateColumn(props: ColumnGeometryProps): {\n  indices: Uint16Array;\n  attributes: Record<string, BinaryAttribute>;\n} {\n  const {radius, height = 1, nradial = 10} = props;\n  let {vertices} = props;\n\n  if (vertices) {\n    log.assert(vertices.length >= nradial); // `vertices` must contain at least `diskResolution` points\n    vertices = vertices.flatMap(v => [v[0], v[1]]);\n    modifyPolygonWindingDirection(vertices, WINDING.COUNTER_CLOCKWISE);\n  }\n\n  const isExtruded = height > 0;\n  const vertsAroundEdge = nradial + 1; // loop\n  const numVertices = isExtruded\n    ? vertsAroundEdge * 3 + 1 // top, side top edge, side bottom edge, one additional degenerage vertex\n    : nradial; // top\n\n  const stepAngle = (Math.PI * 2) / nradial;\n\n  // Used for wireframe\n  const indices = new Uint16Array(isExtruded ? nradial * 3 * 2 : 0); // top loop, side vertical, bottom loop\n\n  const positions = new Float32Array(numVertices * 3);\n  const normals = new Float32Array(numVertices * 3);\n\n  let i = 0;\n\n  // side tesselation: 0, 1, 2, 3, 4, 5, ...\n  //\n  // 0 - 2 - 4  ... top\n  // | / | / |\n  // 1 - 3 - 5  ... bottom\n  //\n  if (isExtruded) {\n    for (let j = 0; j < vertsAroundEdge; j++) {\n      const a = j * stepAngle;\n      const vertexIndex = j % nradial;\n      const sin = Math.sin(a);\n      const cos = Math.cos(a);\n\n      for (let k = 0; k < 2; k++) {\n        positions[i + 0] = vertices ? vertices[vertexIndex * 2] : cos * radius;\n        positions[i + 1] = vertices ? vertices[vertexIndex * 2 + 1] : sin * radius;\n        positions[i + 2] = (1 / 2 - k) * height;\n\n        normals[i + 0] = vertices ? vertices[vertexIndex * 2] : cos;\n        normals[i + 1] = vertices ? vertices[vertexIndex * 2 + 1] : sin;\n\n        i += 3;\n      }\n    }\n\n    // duplicate the last vertex to create proper degenerate triangle.\n    positions[i + 0] = positions[i - 3];\n    positions[i + 1] = positions[i - 2];\n    positions[i + 2] = positions[i - 1];\n    i += 3;\n  }\n\n  // The column geometry is rendered as a triangle strip, so\n  // in order to render sides and top in one go we need to use degenerate triangles.\n  // Duplicate last vertex of side trinagles and first vertex of the top cap to preserve winding order.\n\n  // top tesselation: 0, -1, 1, -2, 2, -3, 3, ...\n  //\n  //    0 -- 1\n  //   /      \\\n  // -1        2\n  //  |        |\n  // -2        3\n  //   \\      /\n  //   -3 -- 4\n  //\n  for (let j = isExtruded ? 0 : 1; j < vertsAroundEdge; j++) {\n    const v = Math.floor(j / 2) * Math.sign(0.5 - (j % 2));\n    const a = v * stepAngle;\n    const vertexIndex = (v + nradial) % nradial;\n    const sin = Math.sin(a);\n    const cos = Math.cos(a);\n\n    positions[i + 0] = vertices ? vertices[vertexIndex * 2] : cos * radius;\n    positions[i + 1] = vertices ? vertices[vertexIndex * 2 + 1] : sin * radius;\n    positions[i + 2] = height / 2;\n\n    normals[i + 2] = 1;\n\n    i += 3;\n  }\n\n  if (isExtruded) {\n    let index = 0;\n    for (let j = 0; j < nradial; j++) {\n      // top loop\n      indices[index++] = j * 2 + 0;\n      indices[index++] = j * 2 + 2;\n      // side vertical\n      indices[index++] = j * 2 + 0;\n      indices[index++] = j * 2 + 1;\n      // bottom loop\n      indices[index++] = j * 2 + 1;\n      indices[index++] = j * 2 + 3;\n    }\n  }\n\n  return {\n    indices,\n    attributes: {\n      POSITION: {size: 3, value: positions},\n      NORMAL: {size: 3, value: normals}\n    }\n  };\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {\n  Layer,\n  project32,\n  gouraudLighting,\n  phongLighting,\n  picking,\n  UNIT,\n  LayerProps,\n  UpdateParameters,\n  Unit,\n  AccessorFunction,\n  Position,\n  Accessor,\n  Color,\n  Material,\n  DefaultProps\n} from '@deck.gl/core';\nimport GL from '@luma.gl/constants';\nimport {Model, isWebGL2, hasFeature, FEATURES} from '@luma.gl/core';\nimport ColumnGeometry from './column-geometry';\n\nimport vs from './column-layer-vertex.glsl';\nimport fs from './column-layer-fragment.glsl';\n\nconst DEFAULT_COLOR: [number, number, number, number] = [0, 0, 0, 255];\n\nconst defaultProps: DefaultProps<ColumnLayerProps> = {\n  diskResolution: {type: 'number', min: 4, value: 20},\n  vertices: null,\n  radius: {type: 'number', min: 0, value: 1000},\n  angle: {type: 'number', value: 0},\n  offset: {type: 'array', value: [0, 0]},\n  coverage: {type: 'number', min: 0, max: 1, value: 1},\n  elevationScale: {type: 'number', min: 0, value: 1},\n  radiusUnits: 'meters',\n  lineWidthUnits: 'meters',\n  lineWidthScale: 1,\n  lineWidthMinPixels: 0,\n  lineWidthMaxPixels: Number.MAX_SAFE_INTEGER,\n\n  extruded: true,\n  wireframe: false,\n  filled: true,\n  stroked: false,\n\n  getPosition: {type: 'accessor', value: x => x.position},\n  getFillColor: {type: 'accessor', value: DEFAULT_COLOR},\n  getLineColor: {type: 'accessor', value: DEFAULT_COLOR},\n  getLineWidth: {type: 'accessor', value: 1},\n  getElevation: {type: 'accessor', value: 1000},\n  material: true,\n  getColor: {deprecatedFor: ['getFillColor', 'getLineColor']}\n};\n\n/** All properties supported by ColumnLayer. */\nexport type ColumnLayerProps<DataT = any> = _ColumnLayerProps<DataT> & LayerProps<DataT>;\n\n/** Properties added by ColumnLayer. */\ntype _ColumnLayerProps<DataT> = {\n  /**\n   * The number of sides to render the disk as.\n   * @default 20\n   */\n  diskResolution?: number;\n\n  /**\n   * isk size in units specified by `radiusUnits`.\n   * @default 1000\n   */\n  radius?: number;\n\n  /**\n   * Disk rotation, counter-clockwise in degrees.\n   * @default 0\n   */\n  angle?: number;\n\n  /**\n   * Replace the default geometry (regular polygon that fits inside the unit circle) with a custom one.\n   * @default null\n   */\n  vertices: Position[] | null;\n\n  /**\n   * Disk offset from the position, relative to the radius.\n   * @default [0,0]\n   */\n  offset?: [number, number];\n\n  /**\n   * Radius multiplier, between 0 - 1\n   * @default 1\n   */\n  coverage?: number;\n\n  /**\n   * Column elevation multiplier.\n   * @default 1\n   */\n  elevationScale?: number;\n\n  /**\n   * Whether to draw a filled column (solid fill).\n   * @default true\n   */\n  filled?: boolean;\n\n  /**\n   * Whether to draw an outline around the disks.\n   * @default false\n   */\n  stroked?: boolean;\n\n  /**\n   * Whether to extrude the columns. If set to `false`, all columns will be rendered as flat polygons.\n   * @default true\n   */\n  extruded?: boolean;\n\n  /**\n   * Whether to generate a line wireframe of the column.\n   * @default false\n   */\n  wireframe?: boolean;\n\n  /**\n   * If `true`, the vertical surfaces of the columns use [flat shading](https://en.wikipedia.org/wiki/Shading#Flat_vs._smooth_shading).\n   * @default false\n   */\n  flatShading?: boolean;\n\n  /**\n   * The units of the radius.\n   * @default 'meters'\n   */\n  radiusUnits?: Unit;\n\n  /**\n   * The units of the line width.\n   * @default 'meters'\n   */\n  lineWidthUnits?: Unit;\n\n  /**\n   * The line width multiplier that multiplied to all outlines.\n   * @default 1\n   */\n  lineWidthScale?: number;\n\n  /**\n   * The minimum outline width in pixels.\n   * @default 0\n   */\n  lineWidthMinPixels?: number;\n\n  /**\n   * The maximum outline width in pixels.\n   * @default Number.MAX_SAFE_INTEGER\n   */\n  lineWidthMaxPixels?: number;\n\n  /**\n   * Material settings for lighting effect. Applies if `extruded: true`.\n   *\n   * @default true\n   * @see https://deck.gl/docs/developer-guide/using-lighting\n   */\n  material?: Material;\n\n  /**\n   * Method called to retrieve the position of each column.\n   * @default object => object.position\n   */\n  getPosition?: AccessorFunction<DataT, Position>;\n\n  /**\n   * @deprecated Use getFilledColor and getLineColor instead\n   */\n  getColor?: Accessor<DataT, Color>;\n\n  /**\n   * Fill collor value or accessor.\n   * @default [0, 0, 0, 255]\n   */\n  getFillColor?: Accessor<DataT, Color>;\n\n  /**\n   * Line color value or accessor.\n   *\n   * @default [0, 0, 0, 255]\n   */\n  getLineColor?: Accessor<DataT, Color>;\n\n  /**\n   * The elevation of each cell in meters.\n   * @default 1000\n   */\n  getElevation?: Accessor<DataT, number>;\n\n  /**\n   * The width of the outline of the column, in units specified by `lineWidthUnits`.\n   *\n   * @default 1\n   */\n  getLineWidth?: Accessor<DataT, number>;\n};\n\n/** Render extruded cylinders (tessellated regular polygons) at given coordinates. */\nexport default class ColumnLayer<DataT = any, ExtraPropsT = {}> extends Layer<\n  ExtraPropsT & Required<_ColumnLayerProps<DataT>>\n> {\n  static layerName = 'ColumnLayer';\n  static defaultProps = defaultProps;\n\n  getShaders() {\n    const {gl} = this.context;\n    const transpileToGLSL100 = !isWebGL2(gl);\n    const defines: Record<string, any> = {};\n\n    const useDerivatives = this.props.flatShading && hasFeature(gl, FEATURES.GLSL_DERIVATIVES);\n    if (useDerivatives) {\n      defines.FLAT_SHADING = 1;\n    }\n    return super.getShaders({\n      vs,\n      fs,\n      defines,\n      transpileToGLSL100,\n      modules: [project32, useDerivatives ? phongLighting : gouraudLighting, picking]\n    });\n  }\n\n  /**\n   * DeckGL calls initializeState when GL context is available\n   * Essentially a deferred constructor\n   */\n  initializeState() {\n    const attributeManager = this.getAttributeManager()!;\n    /* eslint-disable max-len */\n    attributeManager.addInstanced({\n      instancePositions: {\n        size: 3,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        transition: true,\n        accessor: 'getPosition'\n      },\n      instanceElevations: {\n        size: 1,\n        transition: true,\n        accessor: 'getElevation'\n      },\n      instanceFillColors: {\n        size: this.props.colorFormat.length,\n        type: GL.UNSIGNED_BYTE,\n        normalized: true,\n        transition: true,\n        accessor: 'getFillColor',\n        defaultValue: DEFAULT_COLOR\n      },\n      instanceLineColors: {\n        size: this.props.colorFormat.length,\n        type: GL.UNSIGNED_BYTE,\n        normalized: true,\n        transition: true,\n        accessor: 'getLineColor',\n        defaultValue: DEFAULT_COLOR\n      },\n      instanceStrokeWidths: {\n        size: 1,\n        accessor: 'getLineWidth',\n        transition: true\n      }\n    });\n    /* eslint-enable max-len */\n  }\n\n  updateState(params: UpdateParameters<this>): void {\n    super.updateState(params);\n\n    const {props, oldProps, changeFlags} = params;\n    const regenerateModels =\n      changeFlags.extensionsChanged || props.flatShading !== oldProps.flatShading;\n\n    if (regenerateModels) {\n      const {gl} = this.context;\n      this.state.model?.delete();\n      this.state.model = this._getModel(gl);\n      this.getAttributeManager()!.invalidateAll();\n    }\n\n    if (\n      regenerateModels ||\n      props.diskResolution !== oldProps.diskResolution ||\n      props.vertices !== oldProps.vertices ||\n      (props.extruded || props.stroked) !== (oldProps.extruded || oldProps.stroked)\n    ) {\n      this._updateGeometry(props);\n    }\n  }\n\n  getGeometry(diskResolution: number, vertices: number[] | undefined, hasThinkness: boolean) {\n    const geometry = new ColumnGeometry({\n      radius: 1,\n      height: hasThinkness ? 2 : 0,\n      vertices,\n      nradial: diskResolution\n    });\n\n    let meanVertexDistance = 0;\n    if (vertices) {\n      for (let i = 0; i < diskResolution; i++) {\n        const p = vertices[i];\n        const d = Math.sqrt(p[0] * p[0] + p[1] * p[1]);\n        meanVertexDistance += d / diskResolution;\n      }\n    } else {\n      meanVertexDistance = 1;\n    }\n    this.setState({\n      edgeDistance: Math.cos(Math.PI / diskResolution) * meanVertexDistance\n    });\n\n    return geometry;\n  }\n\n  protected _getModel(gl: WebGLRenderingContext): Model {\n    return new Model(gl, {\n      ...this.getShaders(),\n      id: this.props.id,\n      isInstanced: true\n    });\n  }\n\n  protected _updateGeometry({diskResolution, vertices, extruded, stroked}) {\n    const geometry: any = this.getGeometry(diskResolution, vertices, extruded || stroked);\n\n    this.setState({\n      fillVertexCount: geometry.attributes.POSITION.value.length / 3,\n      wireframeVertexCount: geometry.indices.value.length\n    });\n\n    this.state.model.setProps({geometry});\n  }\n\n  draw({uniforms}) {\n    const {\n      lineWidthUnits,\n      lineWidthScale,\n      lineWidthMinPixels,\n      lineWidthMaxPixels,\n      radiusUnits,\n      elevationScale,\n      extruded,\n      filled,\n      stroked,\n      wireframe,\n      offset,\n      coverage,\n      radius,\n      angle\n    } = this.props;\n    const {model, fillVertexCount, wireframeVertexCount, edgeDistance} = this.state;\n\n    model.setUniforms(uniforms).setUniforms({\n      radius,\n      angle: (angle / 180) * Math.PI,\n      offset,\n      extruded,\n      stroked,\n      coverage,\n      elevationScale,\n      edgeDistance,\n      radiusUnits: UNIT[radiusUnits],\n      widthUnits: UNIT[lineWidthUnits],\n      widthScale: lineWidthScale,\n      widthMinPixels: lineWidthMinPixels,\n      widthMaxPixels: lineWidthMaxPixels\n    });\n\n    // When drawing 3d: draw wireframe first so it doesn't get occluded by depth test\n    if (extruded && wireframe) {\n      model.setProps({isIndexed: true});\n      model\n        .setVertexCount(wireframeVertexCount)\n        .setDrawMode(GL.LINES)\n        .setUniforms({isStroke: true})\n        .draw();\n    }\n    if (filled) {\n      model.setProps({isIndexed: false});\n      model\n        .setVertexCount(fillVertexCount)\n        .setDrawMode(GL.TRIANGLE_STRIP)\n        .setUniforms({isStroke: false})\n        .draw();\n    }\n    // When drawing 2d: draw fill before stroke so that the outline is always on top\n    if (!extruded && stroked) {\n      model.setProps({isIndexed: false});\n      // The width of the stroke is achieved by flattening the side of the cylinder.\n      // Skip the last 1/3 of the vertices which is the top.\n      model\n        .setVertexCount((fillVertexCount * 2) / 3)\n        .setDrawMode(GL.TRIANGLE_STRIP)\n        .setUniforms({isStroke: true})\n        .draw();\n    }\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `#version 300 es\n\n#define SHADER_NAME column-layer-vertex-shader\n\nin vec3 positions;\nin vec3 normals;\n\nin vec3 instancePositions;\nin float instanceElevations;\nin vec3 instancePositions64Low;\nin vec4 instanceFillColors;\nin vec4 instanceLineColors;\nin float instanceStrokeWidths;\n\nin vec3 instancePickingColors;\n\n// Custom uniforms\nuniform float opacity;\nuniform float radius;\nuniform float angle;\nuniform vec2 offset;\nuniform bool extruded;\nuniform bool stroked;\nuniform bool isStroke;\nuniform float coverage;\nuniform float elevationScale;\nuniform float edgeDistance;\nuniform float widthScale;\nuniform float widthMinPixels;\nuniform float widthMaxPixels;\nuniform int radiusUnits;\nuniform int widthUnits;\n\n// Result\nout vec4 vColor;\n#ifdef FLAT_SHADING\nout vec4 position_commonspace;\n#endif\n\nvoid main(void) {\n  geometry.worldPosition = instancePositions;\n\n  vec4 color = isStroke ? instanceLineColors : instanceFillColors;\n  // rotate primitive position and normal\n  mat2 rotationMatrix = mat2(cos(angle), sin(angle), -sin(angle), cos(angle));\n\n  // calculate elevation, if 3d not enabled set to 0\n  // cylindar gemoetry height are between -1.0 to 1.0, transform it to between 0, 1\n  float elevation = 0.0;\n  // calculate stroke offset\n  float strokeOffsetRatio = 1.0;\n\n  if (extruded) {\n    elevation = instanceElevations * (positions.z + 1.0) / 2.0 * elevationScale;\n  } else if (stroked) {\n    float widthPixels = clamp(\n      project_size_to_pixel(instanceStrokeWidths * widthScale, widthUnits),\n      widthMinPixels, widthMaxPixels) / 2.0;\n    float halfOffset = project_pixel_size(widthPixels) / project_size(edgeDistance * coverage * radius);\n    if (isStroke) {\n      strokeOffsetRatio -= sign(positions.z) * halfOffset;\n    } else {\n      strokeOffsetRatio -= halfOffset;\n    }\n  }\n\n  // if alpha == 0.0 or z < 0.0, do not render element\n  float shouldRender = float(color.a > 0.0 && instanceElevations >= 0.0);\n  float dotRadius = radius * coverage * shouldRender;\n\n  geometry.pickingColor = instancePickingColors;\n\n  // project center of column\n  vec3 centroidPosition = vec3(instancePositions.xy, instancePositions.z + elevation);\n  vec3 centroidPosition64Low = instancePositions64Low;\n  vec2 offset = (rotationMatrix * positions.xy * strokeOffsetRatio + offset) * dotRadius;\n  if (radiusUnits == UNIT_METERS) {\n    offset = project_size(offset);\n  }\n  vec3 pos = vec3(offset, 0.);\n  DECKGL_FILTER_SIZE(pos, geometry);\n\n  gl_Position = project_position_to_clipspace(centroidPosition, centroidPosition64Low, pos, geometry.position);\n  geometry.normal = project_normal(vec3(rotationMatrix * normals.xy, normals.z));\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  // Light calculations\n  if (extruded && !isStroke) {\n#ifdef FLAT_SHADING\n    position_commonspace = geometry.position;\n    vColor = vec4(color.rgb, color.a * opacity);\n#else\n    vec3 lightColor = lighting_getLightColor(color.rgb, project_uCameraPosition, geometry.position.xyz, geometry.normal);\n    vColor = vec4(lightColor, color.a * opacity);\n#endif\n  } else {\n    vColor = vec4(color.rgb, color.a * opacity);\n  }\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `#version 300 es\n#define SHADER_NAME column-layer-fragment-shader\n\nprecision highp float;\n\nuniform vec3 project_uCameraPosition;\nuniform bool extruded;\nuniform bool isStroke;\n\nout vec4 fragColor;\n\nin vec4 vColor;\n#ifdef FLAT_SHADING\nin vec4 position_commonspace;\n#endif\n\nvoid main(void) {\n  fragColor = vColor;\n#ifdef FLAT_SHADING\n  if (extruded && !isStroke && !picking_uActive) {\n    vec3 normal = normalize(cross(dFdx(position_commonspace.xyz), dFdy(position_commonspace.xyz)));\n    fragColor.rgb = lighting_getLightColor(vColor.rgb, project_uCameraPosition, position_commonspace.xyz, normal);\n  }\n#endif\n  DECKGL_FILTER_COLOR(fragColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {Layer, project32, picking, UNIT} from '@deck.gl/core';\nimport GL from '@luma.gl/constants';\nimport {Model, Geometry} from '@luma.gl/core';\n\nimport vs from './scatterplot-layer-vertex.glsl';\nimport fs from './scatterplot-layer-fragment.glsl';\n\nimport type {\n  LayerProps,\n  UpdateParameters,\n  Accessor,\n  Unit,\n  Position,\n  Color,\n  DefaultProps\n} from '@deck.gl/core';\n\nconst DEFAULT_COLOR: [number, number, number, number] = [0, 0, 0, 255];\n\n/** All props supported by the ScatterplotLayer */\nexport type ScatterplotLayerProps<DataT = any> = _ScatterplotLayerProps<DataT> & LayerProps<DataT>;\n\n/** Props added by the ScatterplotLayer */\ntype _ScatterplotLayerProps<DataT> = {\n  /**\n   * The units of the radius, one of `'meters'`, `'common'`, and `'pixels'`.\n   * @default 'meters'\n   */\n  radiusUnits?: Unit;\n  /**\n   * Radius multiplier.\n   * @default 1\n   */\n  radiusScale?: number;\n  /**\n   * The minimum radius in pixels. This prop can be used to prevent the circle from getting too small when zoomed out.\n   * @default 0\n   */\n  radiusMinPixels?: number;\n  /**\n   * The maximum radius in pixels. This prop can be used to prevent the circle from getting too big when zoomed in.\n   * @default Number.MAX_SAFE_INTEGER\n   */\n  radiusMaxPixels?: number;\n\n  /**\n   * The units of the stroke width, one of `'meters'`, `'common'`, and `'pixels'`.\n   * @default 'meters'\n   */\n  lineWidthUnits?: Unit;\n  /**\n   * Stroke width multiplier.\n   * @default 1\n   */\n  lineWidthScale?: number;\n  /**\n   * The minimum stroke width in pixels. This prop can be used to prevent the line from getting too thin when zoomed out.\n   * @default 0\n   */\n  lineWidthMinPixels?: number;\n  /**\n   * The maximum stroke width in pixels. This prop can be used to prevent the circle from getting too thick when zoomed in.\n   * @default Number.MAX_SAFE_INTEGER\n   */\n  lineWidthMaxPixels?: number;\n\n  /**\n   * Draw the outline of points.\n   * @default false\n   */\n  stroked?: boolean;\n  /**\n   * Draw the filled area of points.\n   * @default true\n   */\n  filled?: boolean;\n  /**\n   * If `true`, rendered circles always face the camera. If `false` circles face up (i.e. are parallel with the ground plane).\n   * @default false\n   */\n  billboard?: boolean;\n  /**\n   * If `true`, circles are rendered with smoothed edges. If `false`, circles are rendered with rough edges. Antialiasing can cause artifacts on edges of overlapping circles.\n   * @default true\n   */\n  antialiasing?: boolean;\n\n  /**\n   * Center position accessor.\n   */\n  getPosition?: Accessor<DataT, Position>;\n  /**\n   * Radius accessor.\n   * @default 1\n   */\n  getRadius?: Accessor<DataT, number>;\n  /**\n   * Fill color accessor.\n   * @default [0, 0, 0, 255]\n   */\n  getFillColor?: Accessor<DataT, Color>;\n  /**\n   * Stroke color accessor.\n   * @default [0, 0, 0, 255]\n   */\n  getLineColor?: Accessor<DataT, Color>;\n  /**\n   * Stroke width accessor.\n   * @default 1\n   */\n  getLineWidth?: Accessor<DataT, number>;\n  /**\n   * @deprecated Use `getLineWidth` instead\n   */\n  strokeWidth?: number;\n  /**\n   * @deprecated Use `stroked` instead\n   */\n  outline?: boolean;\n  /**\n   * @deprecated Use `getFillColor` and `getLineColor` instead\n   */\n  getColor?: Accessor<DataT, Color>;\n};\n\nconst defaultProps: DefaultProps<ScatterplotLayerProps> = {\n  radiusUnits: 'meters',\n  radiusScale: {type: 'number', min: 0, value: 1},\n  radiusMinPixels: {type: 'number', min: 0, value: 0}, //  min point radius in pixels\n  radiusMaxPixels: {type: 'number', min: 0, value: Number.MAX_SAFE_INTEGER}, // max point radius in pixels\n\n  lineWidthUnits: 'meters',\n  lineWidthScale: {type: 'number', min: 0, value: 1},\n  lineWidthMinPixels: {type: 'number', min: 0, value: 0},\n  lineWidthMaxPixels: {type: 'number', min: 0, value: Number.MAX_SAFE_INTEGER},\n\n  stroked: false,\n  filled: true,\n  billboard: false,\n  antialiasing: true,\n\n  getPosition: {type: 'accessor', value: x => x.position},\n  getRadius: {type: 'accessor', value: 1},\n  getFillColor: {type: 'accessor', value: DEFAULT_COLOR},\n  getLineColor: {type: 'accessor', value: DEFAULT_COLOR},\n  getLineWidth: {type: 'accessor', value: 1},\n\n  // deprecated\n  strokeWidth: {deprecatedFor: 'getLineWidth'},\n  outline: {deprecatedFor: 'stroked'},\n  getColor: {deprecatedFor: ['getFillColor', 'getLineColor']}\n};\n\n/** Render circles at given coordinates. */\nexport default class ScatterplotLayer<DataT = any, ExtraPropsT = {}> extends Layer<\n  ExtraPropsT & Required<_ScatterplotLayerProps<DataT>>\n> {\n  static defaultProps = defaultProps;\n  static layerName: string = 'ScatterplotLayer';\n\n  getShaders() {\n    return super.getShaders({vs, fs, modules: [project32, picking]});\n  }\n\n  initializeState() {\n    this.getAttributeManager()!.addInstanced({\n      instancePositions: {\n        size: 3,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        transition: true,\n        accessor: 'getPosition'\n      },\n      instanceRadius: {\n        size: 1,\n        transition: true,\n        accessor: 'getRadius',\n        defaultValue: 1\n      },\n      instanceFillColors: {\n        size: this.props.colorFormat.length,\n        transition: true,\n        normalized: true,\n        type: GL.UNSIGNED_BYTE,\n        accessor: 'getFillColor',\n        defaultValue: [0, 0, 0, 255]\n      },\n      instanceLineColors: {\n        size: this.props.colorFormat.length,\n        transition: true,\n        normalized: true,\n        type: GL.UNSIGNED_BYTE,\n        accessor: 'getLineColor',\n        defaultValue: [0, 0, 0, 255]\n      },\n      instanceLineWidths: {\n        size: 1,\n        transition: true,\n        accessor: 'getLineWidth',\n        defaultValue: 1\n      }\n    });\n  }\n\n  updateState(params: UpdateParameters<this>) {\n    super.updateState(params);\n\n    if (params.changeFlags.extensionsChanged) {\n      const {gl} = this.context;\n      this.state.model?.delete();\n      this.state.model = this._getModel(gl);\n      this.getAttributeManager()!.invalidateAll();\n    }\n  }\n\n  draw({uniforms}) {\n    const {\n      radiusUnits,\n      radiusScale,\n      radiusMinPixels,\n      radiusMaxPixels,\n      stroked,\n      filled,\n      billboard,\n      antialiasing,\n      lineWidthUnits,\n      lineWidthScale,\n      lineWidthMinPixels,\n      lineWidthMaxPixels\n    } = this.props;\n\n    this.state.model\n      .setUniforms(uniforms)\n      .setUniforms({\n        stroked: stroked ? 1 : 0,\n        filled,\n        billboard,\n        antialiasing,\n        radiusUnits: UNIT[radiusUnits],\n        radiusScale,\n        radiusMinPixels,\n        radiusMaxPixels,\n        lineWidthUnits: UNIT[lineWidthUnits],\n        lineWidthScale,\n        lineWidthMinPixels,\n        lineWidthMaxPixels\n      })\n      .draw();\n  }\n\n  protected _getModel(gl) {\n    // a square that minimally cover the unit circle\n    const positions = [-1, -1, 0, 1, -1, 0, 1, 1, 0, -1, 1, 0];\n\n    return new Model(gl, {\n      ...this.getShaders(),\n      id: this.props.id,\n      geometry: new Geometry({\n        drawMode: GL.TRIANGLE_FAN,\n        vertexCount: 4,\n        attributes: {\n          positions: {size: 3, value: new Float32Array(positions)}\n        }\n      }),\n      isInstanced: true\n    });\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME scatterplot-layer-vertex-shader\n\nattribute vec3 positions;\n\nattribute vec3 instancePositions;\nattribute vec3 instancePositions64Low;\nattribute float instanceRadius;\nattribute float instanceLineWidths;\nattribute vec4 instanceFillColors;\nattribute vec4 instanceLineColors;\nattribute vec3 instancePickingColors;\n\nuniform float opacity;\nuniform float radiusScale;\nuniform float radiusMinPixels;\nuniform float radiusMaxPixels;\nuniform float lineWidthScale;\nuniform float lineWidthMinPixels;\nuniform float lineWidthMaxPixels;\nuniform float stroked;\nuniform bool filled;\nuniform bool antialiasing;\nuniform bool billboard;\nuniform int radiusUnits;\nuniform int lineWidthUnits;\n\nvarying vec4 vFillColor;\nvarying vec4 vLineColor;\nvarying vec2 unitPosition;\nvarying float innerUnitRadius;\nvarying float outerRadiusPixels;\n\n\nvoid main(void) {\n  geometry.worldPosition = instancePositions;\n\n  // Multiply out radius and clamp to limits\n  outerRadiusPixels = clamp(\n    project_size_to_pixel(radiusScale * instanceRadius, radiusUnits),\n    radiusMinPixels, radiusMaxPixels\n  );\n  \n  // Multiply out line width and clamp to limits\n  float lineWidthPixels = clamp(\n    project_size_to_pixel(lineWidthScale * instanceLineWidths, lineWidthUnits),\n    lineWidthMinPixels, lineWidthMaxPixels\n  );\n\n  // outer radius needs to offset by half stroke width\n  outerRadiusPixels += stroked * lineWidthPixels / 2.0;\n\n  // Expand geometry to accomodate edge smoothing\n  float edgePadding = antialiasing ? (outerRadiusPixels + SMOOTH_EDGE_RADIUS) / outerRadiusPixels : 1.0;\n\n  // position on the containing square in [-1, 1] space\n  unitPosition = edgePadding * positions.xy;\n  geometry.uv = unitPosition;\n  geometry.pickingColor = instancePickingColors;\n\n  innerUnitRadius = 1.0 - stroked * lineWidthPixels / outerRadiusPixels;\n  \n  if (billboard) {\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, vec3(0.0), geometry.position);\n    vec3 offset = edgePadding * positions * outerRadiusPixels;\n    DECKGL_FILTER_SIZE(offset, geometry);\n    gl_Position.xy += project_pixel_size_to_clipspace(offset.xy);\n  } else {\n    vec3 offset = edgePadding * positions * project_pixel_size(outerRadiusPixels);\n    DECKGL_FILTER_SIZE(offset, geometry);\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, offset, geometry.position);\n  }\n\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  // Apply opacity to instance color, or return instance picking color\n  vFillColor = vec4(instanceFillColors.rgb, instanceFillColors.a * opacity);\n  DECKGL_FILTER_COLOR(vFillColor, geometry);\n  vLineColor = vec4(instanceLineColors.rgb, instanceLineColors.a * opacity);\n  DECKGL_FILTER_COLOR(vLineColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME scatterplot-layer-fragment-shader\n\nprecision highp float;\n\nuniform bool filled;\nuniform float stroked;\nuniform bool antialiasing;\n\nvarying vec4 vFillColor;\nvarying vec4 vLineColor;\nvarying vec2 unitPosition;\nvarying float innerUnitRadius;\nvarying float outerRadiusPixels;\n\nvoid main(void) {\n  geometry.uv = unitPosition;\n\n  float distToCenter = length(unitPosition) * outerRadiusPixels;\n  float inCircle = antialiasing ? \n    smoothedge(distToCenter, outerRadiusPixels) : \n    step(distToCenter, outerRadiusPixels);\n\n  if (inCircle == 0.0) {\n    discard;\n  }\n\n  if (stroked > 0.5) {\n    float isLine = antialiasing ? \n      smoothedge(innerUnitRadius * outerRadiusPixels, distToCenter) :\n      step(innerUnitRadius * outerRadiusPixels, distToCenter);\n\n    if (filled) {\n      gl_FragColor = mix(vFillColor, vLineColor, isLine);\n    } else {\n      if (isLine == 0.0) {\n        discard;\n      }\n      gl_FragColor = vec4(vLineColor.rgb, vLineColor.a * isLine);\n    }\n  } else if (filled) {\n    gl_FragColor = vFillColor;\n  } else {\n    discard;\n  }\n\n  gl_FragColor.a *= inCircle;\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n`;\n","import {Layer, project32, picking, UNIT} from '@deck.gl/core';\nimport GL from '@luma.gl/constants';\nimport {Model, Geometry} from '@luma.gl/core';\n\nimport vs from './text-background-layer-vertex.glsl';\nimport fs from './text-background-layer-fragment.glsl';\n\nimport type {\n  LayerProps,\n  Accessor,\n  Unit,\n  Position,\n  Color,\n  UpdateParameters,\n  DefaultProps\n} from '@deck.gl/core';\n\ntype _TextBackgroundLayerProps<DataT> = {\n  billboard?: boolean;\n  sizeScale?: number;\n  sizeUnits?: Unit;\n  sizeMinPixels?: number;\n  sizeMaxPixels?: number;\n\n  padding?: [number, number] | [number, number, number, number];\n\n  getPosition?: Accessor<DataT, Position>;\n  getSize?: Accessor<DataT, number>;\n  getAngle?: Accessor<DataT, number>;\n  getPixelOffset?: Accessor<DataT, [number, number]>;\n  getBoundingRect?: Accessor<DataT, [number, number, number, number]>;\n  getFillColor?: Accessor<DataT, Color>;\n  getLineColor?: Accessor<DataT, Color>;\n  getLineWidth?: Accessor<DataT, number>;\n};\n\nexport type TextBackgroundLayerProps<DataT = any> = _TextBackgroundLayerProps<DataT> &\n  LayerProps<DataT>;\n\nconst defaultProps: DefaultProps<TextBackgroundLayerProps> = {\n  billboard: true,\n  sizeScale: 1,\n  sizeUnits: 'pixels',\n  sizeMinPixels: 0,\n  sizeMaxPixels: Number.MAX_SAFE_INTEGER,\n\n  padding: {type: 'array', value: [0, 0, 0, 0]},\n\n  getPosition: {type: 'accessor', value: x => x.position},\n  getSize: {type: 'accessor', value: 1},\n  getAngle: {type: 'accessor', value: 0},\n  getPixelOffset: {type: 'accessor', value: [0, 0]},\n  getBoundingRect: {type: 'accessor', value: [0, 0, 0, 0]},\n  getFillColor: {type: 'accessor', value: [0, 0, 0, 255]},\n  getLineColor: {type: 'accessor', value: [0, 0, 0, 255]},\n  getLineWidth: {type: 'accessor', value: 1}\n};\n\nexport default class TextBackgroundLayer<DataT = any, ExtraPropsT = {}> extends Layer<\n  ExtraPropsT & Required<_TextBackgroundLayerProps<DataT>>\n> {\n  static defaultProps = defaultProps;\n  static layerName = 'TextBackgroundLayer';\n\n  state!: {\n    model: Model;\n  };\n\n  getShaders() {\n    return super.getShaders({vs, fs, modules: [project32, picking]});\n  }\n\n  initializeState() {\n    this.getAttributeManager()!.addInstanced({\n      instancePositions: {\n        size: 3,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        transition: true,\n        accessor: 'getPosition'\n      },\n      instanceSizes: {\n        size: 1,\n        transition: true,\n        accessor: 'getSize',\n        defaultValue: 1\n      },\n      instanceAngles: {\n        size: 1,\n        transition: true,\n        accessor: 'getAngle'\n      },\n      instanceRects: {\n        size: 4,\n        accessor: 'getBoundingRect'\n      },\n      instancePixelOffsets: {\n        size: 2,\n        transition: true,\n        accessor: 'getPixelOffset'\n      },\n      instanceFillColors: {\n        size: 4,\n        transition: true,\n        normalized: true,\n        type: GL.UNSIGNED_BYTE,\n        accessor: 'getFillColor',\n        defaultValue: [0, 0, 0, 255]\n      },\n      instanceLineColors: {\n        size: 4,\n        transition: true,\n        normalized: true,\n        type: GL.UNSIGNED_BYTE,\n        accessor: 'getLineColor',\n        defaultValue: [0, 0, 0, 255]\n      },\n      instanceLineWidths: {\n        size: 1,\n        transition: true,\n        accessor: 'getLineWidth',\n        defaultValue: 1\n      }\n    });\n  }\n\n  updateState(params: UpdateParameters<this>) {\n    super.updateState(params);\n    const {changeFlags} = params;\n    if (changeFlags.extensionsChanged) {\n      const {gl} = this.context;\n      this.state.model?.delete();\n      this.state.model = this._getModel(gl);\n      this.getAttributeManager()!.invalidateAll();\n    }\n  }\n\n  draw({uniforms}) {\n    const {billboard, sizeScale, sizeUnits, sizeMinPixels, sizeMaxPixels, getLineWidth} =\n      this.props;\n    let {padding} = this.props;\n\n    if (padding.length < 4) {\n      padding = [padding[0], padding[1], padding[0], padding[1]];\n    }\n\n    this.state.model\n      .setUniforms(uniforms)\n      .setUniforms({\n        billboard,\n        stroked: Boolean(getLineWidth),\n        padding,\n        sizeUnits: UNIT[sizeUnits],\n        sizeScale,\n        sizeMinPixels,\n        sizeMaxPixels\n      })\n      .draw();\n  }\n\n  protected _getModel(gl: WebGLRenderingContext): Model {\n    // a square that minimally cover the unit circle\n    const positions = [0, 0, 1, 0, 1, 1, 0, 1];\n\n    return new Model(gl, {\n      ...this.getShaders(),\n      id: this.props.id,\n      geometry: new Geometry({\n        drawMode: GL.TRIANGLE_FAN,\n        vertexCount: 4,\n        attributes: {\n          positions: {size: 2, value: new Float32Array(positions)}\n        }\n      }),\n      isInstanced: true\n    });\n  }\n}\n","export default `\\\n#define SHADER_NAME text-background-layer-vertex-shader\n\nattribute vec2 positions;\n\nattribute vec3 instancePositions;\nattribute vec3 instancePositions64Low;\nattribute vec4 instanceRects;\nattribute float instanceSizes;\nattribute float instanceAngles;\nattribute vec2 instancePixelOffsets;\nattribute float instanceLineWidths;\nattribute vec4 instanceFillColors;\nattribute vec4 instanceLineColors;\nattribute vec3 instancePickingColors;\n\nuniform bool billboard;\nuniform float opacity;\nuniform float sizeScale;\nuniform float sizeMinPixels;\nuniform float sizeMaxPixels;\nuniform vec4 padding;\nuniform int sizeUnits;\n\nvarying vec4 vFillColor;\nvarying vec4 vLineColor;\nvarying float vLineWidth;\nvarying vec2 uv;\nvarying vec2 dimensions;\n\nvec2 rotate_by_angle(vec2 vertex, float angle) {\n  float angle_radian = radians(angle);\n  float cos_angle = cos(angle_radian);\n  float sin_angle = sin(angle_radian);\n  mat2 rotationMatrix = mat2(cos_angle, -sin_angle, sin_angle, cos_angle);\n  return rotationMatrix * vertex;\n}\n\nvoid main(void) {\n  geometry.worldPosition = instancePositions;\n  geometry.uv = positions;\n  geometry.pickingColor = instancePickingColors;\n  uv = positions;\n  vLineWidth = instanceLineWidths;\n\n  // convert size in meters to pixels, then scaled and clamp\n\n  // project meters to pixels and clamp to limits\n  float sizePixels = clamp(\n    project_size_to_pixel(instanceSizes * sizeScale, sizeUnits),\n    sizeMinPixels, sizeMaxPixels\n  );\n\n  dimensions = instanceRects.zw * sizePixels + padding.xy + padding.zw;\n\n  vec2 pixelOffset = (positions * instanceRects.zw + instanceRects.xy) * sizePixels + mix(-padding.xy, padding.zw, positions);\n  pixelOffset = rotate_by_angle(pixelOffset, instanceAngles);\n  pixelOffset += instancePixelOffsets;\n  pixelOffset.y *= -1.0;\n\n  if (billboard)  {\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, vec3(0.0), geometry.position);\n    vec3 offset = vec3(pixelOffset, 0.0);\n    DECKGL_FILTER_SIZE(offset, geometry);\n    gl_Position.xy += project_pixel_size_to_clipspace(offset.xy);\n  } else {\n    vec3 offset_common = vec3(project_pixel_size(pixelOffset), 0.0);\n    DECKGL_FILTER_SIZE(offset_common, geometry);\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, offset_common, geometry.position);\n  }\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  // Apply opacity to instance color, or return instance picking color\n  vFillColor = vec4(instanceFillColors.rgb, instanceFillColors.a * opacity);\n  DECKGL_FILTER_COLOR(vFillColor, geometry);\n  vLineColor = vec4(instanceLineColors.rgb, instanceLineColors.a * opacity);\n  DECKGL_FILTER_COLOR(vLineColor, geometry);\n}\n`;\n","export default `\\\n#define SHADER_NAME text-background-layer-fragment-shader\n\nprecision highp float;\n\nuniform bool stroked;\n\nvarying vec4 vFillColor;\nvarying vec4 vLineColor;\nvarying float vLineWidth;\nvarying vec2 uv;\nvarying vec2 dimensions;\n\nvoid main(void) {\n  geometry.uv = uv;\n\n  vec2 pixelPosition = uv * dimensions;\n  if (stroked) {\n    float distToEdge = min(\n      min(pixelPosition.x, dimensions.x - pixelPosition.x),\n      min(pixelPosition.y, dimensions.y - pixelPosition.y)\n    );\n    float isBorder = smoothedge(distToEdge, vLineWidth);\n    gl_FragColor = mix(vFillColor, vLineColor, isBorder);\n  } else {\n    gl_FragColor = vFillColor;\n  }\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n`;\n","import {load} from '@loaders.gl/core';\n\nimport type {ResourceManagerContext} from './resource-manager';\n\nexport type ResourceSubscriber<T = any> = {\n  onChange: (data: T | Promise<T>) => void;\n};\n\nexport default class Resource<T = any> {\n  id: string;\n  context: ResourceManagerContext;\n  isLoaded!: boolean;\n  persistent?: boolean;\n\n  private _loadCount: number = 0;\n  private _subscribers = new Set<ResourceSubscriber<T>>();\n  private _data!: T | Promise<T> | string;\n  private _loader?: Promise<void>;\n  private _error?: Error;\n  private _content?: T;\n\n  constructor(id: string, data: T | Promise<T> | string, context: ResourceManagerContext) {\n    this.id = id;\n    this.context = context;\n\n    this.setData(data);\n  }\n\n  // consumer: {onChange: Function}\n  subscribe(consumer: ResourceSubscriber<T>): void {\n    this._subscribers.add(consumer);\n  }\n\n  unsubscribe(consumer: ResourceSubscriber<T>): void {\n    this._subscribers.delete(consumer);\n  }\n\n  inUse(): boolean {\n    return this._subscribers.size > 0;\n  }\n\n  delete(): void {\n    // Remove any resources created\n  }\n\n  getData(): T | Promise<T> {\n    return this.isLoaded\n      ? this._error\n        ? Promise.reject(this._error)\n        : this._content!\n      : this._loader!.then(() => this.getData());\n  }\n\n  setData(data: any, forceUpdate?: boolean) {\n    if (data === this._data && !forceUpdate) {\n      return;\n    }\n    this._data = data;\n    const loadCount = ++this._loadCount;\n\n    let loader = data;\n    if (typeof data === 'string') {\n      loader = load(data);\n    }\n    if (loader instanceof Promise) {\n      this.isLoaded = false;\n      this._loader = loader\n        .then(result => {\n          // check if source has changed\n          if (this._loadCount === loadCount) {\n            this.isLoaded = true;\n            this._error = undefined;\n            this._content = result;\n          }\n        })\n        .catch(error => {\n          if (this._loadCount === loadCount) {\n            this.isLoaded = true;\n            this._error = error || true;\n          }\n        });\n    } else {\n      this.isLoaded = true;\n      this._error = undefined;\n      this._content = data;\n    }\n\n    for (const subscriber of this._subscribers) {\n      subscriber.onChange(this.getData());\n    }\n  }\n}\n","/* global setTimeout */\nimport Resource from './resource';\nimport type {ResourceSubscriber} from './resource';\n\nexport type ResourceManagerContext = {\n  gl: WebGLRenderingContext;\n  resourceManager: ResourceManager;\n};\n\nexport default class ResourceManager {\n  protocol: string;\n\n  private _context: ResourceManagerContext;\n  private _resources: Record<string, Resource>;\n  private _consumers: Record<\n    string,\n    Record<\n      string,\n      ResourceSubscriber & {\n        resourceId: string;\n      }\n    >\n  >;\n  private _pruneRequest: number | null;\n\n  constructor({gl, protocol}) {\n    this.protocol = protocol || 'resource://';\n\n    this._context = {\n      gl,\n      resourceManager: this\n    };\n    this._resources = {};\n    this._consumers = {};\n\n    this._pruneRequest = null;\n  }\n\n  contains(resourceId: string): boolean {\n    if (resourceId.startsWith(this.protocol)) {\n      return true;\n    }\n    return resourceId in this._resources;\n  }\n\n  add({\n    resourceId,\n    data,\n    forceUpdate = false,\n    persistent = true\n  }: {\n    resourceId: string;\n    data: any;\n    forceUpdate?: boolean;\n    persistent?: boolean;\n  }) {\n    let res = this._resources[resourceId];\n\n    if (res) {\n      res.setData(data, forceUpdate);\n    } else {\n      res = new Resource(resourceId, data, this._context);\n      this._resources[resourceId] = res;\n    }\n    // persistent resources can only be removed by calling `remove`\n    // non-persistent resources may be released when there are no more consumers\n    res.persistent = persistent;\n  }\n\n  remove(resourceId: string): void {\n    const res = this._resources[resourceId];\n\n    if (res) {\n      res.delete();\n      delete this._resources[resourceId];\n    }\n  }\n\n  unsubscribe({consumerId}: {consumerId: string}): void {\n    const consumer = this._consumers[consumerId];\n    if (consumer) {\n      for (const requestId in consumer) {\n        const request = consumer[requestId];\n        const resource = this._resources[request.resourceId];\n        if (resource) {\n          resource.unsubscribe(request);\n        }\n      }\n      delete this._consumers[consumerId];\n      this.prune();\n    }\n  }\n\n  subscribe<T>({\n    resourceId,\n    onChange,\n    consumerId,\n    requestId = 'default'\n  }: {\n    resourceId: string;\n    onChange: (data: T | Promise<T>) => void;\n    consumerId: string;\n    requestId: string;\n  }): T | Promise<T> | undefined {\n    const {_resources: resources, protocol} = this;\n    if (resourceId.startsWith(protocol)) {\n      resourceId = resourceId.replace(protocol, '');\n      if (!resources[resourceId]) {\n        // Add placeholder. When this resource becomes available, the consumer will be notified.\n        this.add({resourceId, data: null, persistent: false});\n      }\n    }\n    const res: Resource<T> = resources[resourceId];\n    this._track(consumerId, requestId, res, onChange);\n    if (res) {\n      return res.getData();\n    }\n\n    return undefined;\n  }\n\n  prune(): void {\n    if (!this._pruneRequest) {\n      // prune() may be called multiple times in the same animation frame.\n      // Batch multiple requests together\n      // @ts-ignore setTimeout returns NodeJS.Timeout in node\n      this._pruneRequest = setTimeout(() => this._prune(), 0);\n    }\n  }\n\n  finalize(): void {\n    for (const key in this._resources) {\n      this._resources[key].delete();\n    }\n  }\n\n  private _track(\n    consumerId: string,\n    requestId: string,\n    resource: Resource,\n    onChange: (data: any) => void\n  ) {\n    const consumers = this._consumers;\n    const consumer = (consumers[consumerId] = consumers[consumerId] || {});\n    const request = consumer[requestId] || {};\n\n    const oldResource = request.resourceId && this._resources[request.resourceId];\n    if (oldResource) {\n      oldResource.unsubscribe(request);\n      this.prune();\n    }\n    if (resource) {\n      consumer[requestId] = request;\n      request.onChange = onChange;\n      request.resourceId = resource.id;\n      resource.subscribe(request);\n    }\n  }\n\n  private _prune(): void {\n    this._pruneRequest = null;\n\n    for (const key of Object.keys(this._resources)) {\n      const res = this._resources[key];\n      if (!res.persistent && !res.inUse()) {\n        res.delete();\n        delete this._resources[key];\n      }\n    }\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {Timeline} from '@luma.gl/core';\nimport {LIFECYCLE} from '../lifecycle/constants';\nimport log from '../utils/log';\nimport debug from '../debug';\nimport {flatten} from '../utils/flatten';\nimport {Stats} from '@probe.gl/stats';\nimport ResourceManager from './resource/resource-manager';\n\nimport Viewport from '../viewports/viewport';\nimport {createProgramManager} from '../shaderlib';\n\nimport type Layer from './layer';\nimport type CompositeLayer from './composite-layer';\nimport type Deck from './deck';\nimport type {ProgramManager} from '@luma.gl/engine';\n\nconst TRACE_SET_LAYERS = 'layerManager.setLayers';\nconst TRACE_ACTIVATE_VIEWPORT = 'layerManager.activateViewport';\n\nexport type LayerContext = {\n  layerManager: LayerManager;\n  resourceManager: ResourceManager;\n  deck?: Deck;\n  gl: WebGLRenderingContext;\n  programManager: ProgramManager;\n  stats: Stats;\n  viewport: Viewport;\n  timeline: Timeline;\n  mousePosition: {x: number; y: number} | null;\n  userData: any;\n  onError?: <PropsT>(error: Error, source: Layer<PropsT>) => void;\n};\n\nexport type LayersList = (Layer | undefined | false | null | LayersList)[];\n\nexport default class LayerManager {\n  layers: Layer[];\n  context: LayerContext;\n  resourceManager: ResourceManager;\n\n  private _lastRenderedLayers: LayersList = [];\n  private _needsRedraw: string | false = false;\n  private _needsUpdate: string | false = false;\n  private _nextLayers: LayersList | null = null;\n  private _debug: boolean = false;\n\n  // eslint-disable-next-line\n  constructor(\n    gl,\n    {\n      deck,\n      stats,\n      viewport,\n      timeline\n    }: {\n      deck?: Deck;\n      stats?: Stats;\n      viewport?: Viewport;\n      timeline?: Timeline;\n    } = {}\n  ) {\n    // Currently deck.gl expects the DeckGL.layers array to be different\n    // whenever React rerenders. If the same layers array is used, the\n    // LayerManager's diffing algorithm will generate a fatal error and\n    // break the rendering.\n\n    // `this._lastRenderedLayers` stores the UNFILTERED layers sent\n    // down to LayerManager, so that `layers` reference can be compared.\n    // If it's the same across two React render calls, the diffing logic\n    // will be skipped.\n    this.layers = [];\n    this.resourceManager = new ResourceManager({gl, protocol: 'deck://'});\n\n    this.context = {\n      mousePosition: null,\n      userData: {},\n      layerManager: this,\n      gl,\n      deck,\n      // Enabling luma.gl Program caching using private API (_cachePrograms)\n      programManager: gl && createProgramManager(gl),\n      stats: stats || new Stats({id: 'deck.gl'}),\n      // Make sure context.viewport is not empty on the first layer initialization\n      viewport: viewport || new Viewport({id: 'DEFAULT-INITIAL-VIEWPORT'}), // Current viewport, exposed to layers for project* function\n      timeline: timeline || new Timeline(),\n      resourceManager: this.resourceManager,\n      onError: undefined\n    };\n\n    Object.seal(this);\n  }\n\n  /** Method to call when the layer manager is not needed anymore. */\n  finalize() {\n    this.resourceManager.finalize();\n    // Finalize all layers\n    for (const layer of this.layers) {\n      this._finalizeLayer(layer);\n    }\n  }\n\n  /** Check if a redraw is needed */\n  needsRedraw(\n    opts: {\n      /** Reset redraw flags to false after the call */\n      clearRedrawFlags: boolean;\n    } = {clearRedrawFlags: false}\n  ): string | false {\n    let redraw = this._needsRedraw;\n    if (opts.clearRedrawFlags) {\n      this._needsRedraw = false;\n    }\n\n    // This layers list doesn't include sublayers, relying on composite layers\n    for (const layer of this.layers) {\n      // Call every layer to clear their flags\n      const layerNeedsRedraw = layer.getNeedsRedraw(opts);\n      redraw = redraw || layerNeedsRedraw;\n    }\n\n    return redraw;\n  }\n\n  /** Check if a deep update of all layers is needed */\n  needsUpdate(): string | false {\n    if (this._nextLayers && this._nextLayers !== this._lastRenderedLayers) {\n      // New layers array may be the same as the old one if `setProps` is called by React\n      return 'layers changed';\n    }\n    return this._needsUpdate;\n  }\n\n  /** Layers will be redrawn (in next animation frame) */\n  setNeedsRedraw(reason: string): void {\n    this._needsRedraw = this._needsRedraw || reason;\n  }\n\n  /** Layers will be updated deeply (in next animation frame)\n    Potentially regenerating attributes and sub layers */\n  setNeedsUpdate(reason: string): void {\n    this._needsUpdate = this._needsUpdate || reason;\n  }\n\n  /** Gets a list of currently rendered layers. Optionally filter by id. */\n  getLayers({layerIds}: {layerIds?: string[]} = {}): Layer[] {\n    // Filtering by layerId compares beginning of strings, so that sublayers will be included\n    // Dependes on the convention of adding suffixes to the parent's layer name\n    return layerIds\n      ? this.layers.filter(layer => layerIds.find(layerId => layer.id.indexOf(layerId) === 0))\n      : this.layers;\n  }\n\n  /** Set props needed for layer rendering and picking. */\n  setProps(props: any): void {\n    if ('debug' in props) {\n      this._debug = props.debug;\n    }\n\n    // A way for apps to add data to context that can be accessed in layers\n    if ('userData' in props) {\n      this.context.userData = props.userData;\n    }\n\n    // New layers will be processed in `updateLayers` in the next update cycle\n    if ('layers' in props) {\n      this._nextLayers = props.layers;\n    }\n\n    if ('onError' in props) {\n      this.context.onError = props.onError;\n    }\n  }\n\n  /** Supply a new layer list, initiating sublayer generation and layer matching */\n  setLayers(newLayers: LayersList, reason?: string): void {\n    debug(TRACE_SET_LAYERS, this, reason, newLayers);\n\n    this._lastRenderedLayers = newLayers;\n\n    const flatLayers = flatten(newLayers, Boolean) as Layer[];\n\n    for (const layer of flatLayers) {\n      layer.context = this.context;\n    }\n\n    this._updateLayers(this.layers, flatLayers);\n  }\n\n  /** Update layers from last cycle if `setNeedsUpdate()` has been called */\n  updateLayers(): void {\n    // NOTE: For now, even if only some layer has changed, we update all layers\n    // to ensure that layer id maps etc remain consistent even if different\n    // sublayers are rendered\n    const reason = this.needsUpdate();\n    if (reason) {\n      this.setNeedsRedraw(`updating layers: ${reason}`);\n      // Force a full update\n      this.setLayers(this._nextLayers || this._lastRenderedLayers, reason);\n    }\n    // Updated, clear the backlog\n    this._nextLayers = null;\n  }\n\n  //\n  // INTERNAL METHODS\n  //\n\n  /** Make a viewport \"current\" in layer context, updating viewportChanged flags */\n  activateViewport = (viewport: Viewport) => {\n    debug(TRACE_ACTIVATE_VIEWPORT, this, viewport);\n    if (viewport) {\n      this.context.viewport = viewport;\n    }\n  };\n\n  private _handleError(stage: string, error: Error, layer: Layer) {\n    layer.raiseError(error, `${stage} of ${layer}`);\n  }\n\n  // TODO - mark layers with exceptions as bad and remove from rendering cycle?\n  /** Match all layers, checking for caught errors\n    to avoid having an exception in one layer disrupt other layers */\n  private _updateLayers(oldLayers: Layer[], newLayers: Layer[]): void {\n    // Create old layer map\n    const oldLayerMap: {[layerId: string]: Layer | null} = {};\n    for (const oldLayer of oldLayers) {\n      if (oldLayerMap[oldLayer.id]) {\n        log.warn(`Multiple old layers with same id ${oldLayer.id}`)();\n      } else {\n        oldLayerMap[oldLayer.id] = oldLayer;\n      }\n    }\n\n    // Allocate array for generated layers\n    const generatedLayers: Layer[] = [];\n\n    // Match sublayers\n    this._updateSublayersRecursively(newLayers, oldLayerMap, generatedLayers);\n\n    // Finalize unmatched layers\n    this._finalizeOldLayers(oldLayerMap);\n\n    let needsUpdate: string | false = false;\n    for (const layer of generatedLayers) {\n      if (layer.hasUniformTransition()) {\n        needsUpdate = `Uniform transition in ${layer}`;\n        break;\n      }\n    }\n\n    this._needsUpdate = needsUpdate;\n    this.layers = generatedLayers;\n  }\n\n  /* eslint-disable complexity,max-statements */\n  // Note: adds generated layers to `generatedLayers` array parameter\n  private _updateSublayersRecursively(\n    newLayers: Layer[],\n    oldLayerMap: {[layerId: string]: Layer | null},\n    generatedLayers: Layer[]\n  ) {\n    for (const newLayer of newLayers) {\n      newLayer.context = this.context;\n\n      // Given a new coming layer, find its matching old layer (if any)\n      const oldLayer = oldLayerMap[newLayer.id];\n      if (oldLayer === null) {\n        // null, rather than undefined, means this id was originally there\n        log.warn(`Multiple new layers with same id ${newLayer.id}`)();\n      }\n      // Remove the old layer from candidates, as it has been matched with this layer\n      oldLayerMap[newLayer.id] = null;\n\n      let sublayers: Layer[] | null = null;\n\n      // We must not generate exceptions until after layer matching is complete\n      try {\n        if (this._debug && oldLayer !== newLayer) {\n          newLayer.validateProps();\n        }\n\n        if (!oldLayer) {\n          this._initializeLayer(newLayer);\n        } else {\n          this._transferLayerState(oldLayer, newLayer);\n          this._updateLayer(newLayer);\n        }\n        generatedLayers.push(newLayer);\n\n        // Call layer lifecycle method: render sublayers\n        sublayers = newLayer.isComposite ? (newLayer as CompositeLayer).getSubLayers() : null;\n        // End layer lifecycle method: render sublayers\n      } catch (err) {\n        this._handleError('matching', err as Error, newLayer); // Record first exception\n      }\n\n      if (sublayers) {\n        this._updateSublayersRecursively(sublayers, oldLayerMap, generatedLayers);\n      }\n    }\n  }\n  /* eslint-enable complexity,max-statements */\n\n  // Finalize any old layers that were not matched\n  private _finalizeOldLayers(oldLayerMap: {[layerId: string]: Layer | null}): void {\n    for (const layerId in oldLayerMap) {\n      const layer = oldLayerMap[layerId];\n      if (layer) {\n        this._finalizeLayer(layer);\n      }\n    }\n  }\n\n  // / EXCEPTION SAFE LAYER ACCESS\n\n  /** Safely initializes a single layer, calling layer methods */\n  private _initializeLayer(layer: Layer): void {\n    try {\n      layer._initialize();\n      layer.lifecycle = LIFECYCLE.INITIALIZED;\n    } catch (err) {\n      this._handleError('initialization', err as Error, layer);\n      // TODO - what should the lifecycle state be here? LIFECYCLE.INITIALIZATION_FAILED?\n    }\n  }\n\n  /** Transfer state from one layer to a newer version */\n  private _transferLayerState(oldLayer: Layer, newLayer: Layer): void {\n    newLayer._transferState(oldLayer);\n    newLayer.lifecycle = LIFECYCLE.MATCHED;\n\n    if (newLayer !== oldLayer) {\n      oldLayer.lifecycle = LIFECYCLE.AWAITING_GC;\n    }\n  }\n\n  /** Safely updates a single layer, cleaning all flags */\n  private _updateLayer(layer: Layer): void {\n    try {\n      layer._update();\n    } catch (err) {\n      this._handleError('update', err as Error, layer);\n    }\n  }\n\n  /** Safely finalizes a single layer, removing all resources */\n  private _finalizeLayer(layer: Layer): void {\n    this._needsRedraw = this._needsRedraw || `finalized ${layer}`;\n\n    layer.lifecycle = LIFECYCLE.AWAITING_FINALIZATION;\n\n    try {\n      layer._finalize();\n      layer.lifecycle = LIFECYCLE.FINALIZED;\n    } catch (err) {\n      this._handleError('finalization', err as Error, layer);\n    }\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport GL from '@luma.gl/constants';\nimport {log} from '@deck.gl/core';\nimport IconLayer from '../../icon-layer/icon-layer';\n\nimport fs from './multi-icon-layer-fragment.glsl';\n\nimport type {IconLayerProps} from '../../icon-layer/icon-layer';\nimport type {Accessor, Color, UpdateParameters, DefaultProps} from '@deck.gl/core';\nimport {Character} from '../utils';\n\n// TODO expose as layer properties\nconst DEFAULT_BUFFER = 192.0 / 256;\nconst EMPTY_ARRAY = [];\n\ntype _MultiIconLayerProps<DataT> = {\n  getIconOffsets?: Accessor<DataT, number[]>;\n  sdf?: boolean;\n  smoothing?: number;\n  outlineWidth?: number;\n  outlineColor?: Color;\n};\n\nexport type MultiIconLayerProps<DataT = any> = _MultiIconLayerProps<DataT> & IconLayerProps<DataT>;\n\nconst defaultProps: DefaultProps<MultiIconLayerProps> = {\n  getIconOffsets: {type: 'accessor', value: x => x.offsets},\n  alphaCutoff: 0.001,\n  smoothing: 0.1,\n  outlineWidth: 0,\n  outlineColor: {type: 'color', value: [0, 0, 0, 255]}\n};\n\nexport default class MultiIconLayer<DataT, ExtraPropsT = {}> extends IconLayer<\n  DataT,\n  ExtraPropsT & Required<_MultiIconLayerProps<DataT>>\n> {\n  static defaultProps = defaultProps;\n  static layerName = 'MultiIconLayer';\n\n  state!: IconLayer['state'] & {\n    outlineColor: Color;\n  };\n\n  getShaders() {\n    return {...super.getShaders(), fs};\n  }\n\n  initializeState() {\n    super.initializeState();\n\n    const attributeManager = this.getAttributeManager();\n    attributeManager!.addInstanced({\n      instanceOffsets: {\n        size: 2,\n        accessor: 'getIconOffsets'\n      },\n      instancePickingColors: {\n        type: GL.UNSIGNED_BYTE,\n        size: 3,\n        accessor: (object, {index, target: value}) => this.encodePickingColor(index, value)\n      }\n    });\n  }\n\n  updateState(params: UpdateParameters<this>) {\n    super.updateState(params);\n    const {props, oldProps} = params;\n    let {outlineColor} = props;\n\n    if (outlineColor !== oldProps.outlineColor) {\n      outlineColor = outlineColor.map(x => x / 255) as Color;\n      outlineColor[3] = Number.isFinite(outlineColor[3]) ? outlineColor[3] : 1;\n\n      this.setState({\n        outlineColor\n      });\n    }\n    if (!props.sdf && props.outlineWidth) {\n      log.warn(`${this.id}: fontSettings.sdf is required to render outline`)();\n    }\n  }\n\n  draw(params) {\n    const {sdf, smoothing, outlineWidth} = this.props;\n    const {outlineColor} = this.state;\n    const outlineBuffer = outlineWidth\n      ? Math.max(smoothing, DEFAULT_BUFFER * (1 - outlineWidth))\n      : -1;\n\n    params.uniforms = {\n      ...params.uniforms,\n      // Refer the following doc about gamma and buffer\n      // https://blog.mapbox.com/drawing-text-with-signed-distance-fields-in-mapbox-gl-b0933af6f817\n      buffer: DEFAULT_BUFFER,\n      outlineBuffer,\n      gamma: smoothing,\n      sdf: Boolean(sdf),\n      outlineColor\n    };\n\n    super.draw(params);\n\n    // draw text without outline on top to ensure a thick outline won't occlude other characters\n    if (sdf && outlineWidth) {\n      const {iconManager} = this.state;\n      const iconsTexture = iconManager.getTexture();\n\n      if (iconsTexture) {\n        this.state.model.draw({uniforms: {outlineBuffer: DEFAULT_BUFFER}});\n      }\n    }\n  }\n\n  protected getInstanceOffset(icons: string): number[] {\n    return icons ? Array.from(icons).flatMap(icon => super.getInstanceOffset(icon)) : EMPTY_ARRAY;\n  }\n\n  getInstanceColorMode(icons: string): number {\n    return 1; // mask\n  }\n\n  getInstanceIconFrame(icons: string): number[] {\n    return icons\n      ? Array.from(icons).flatMap(icon => super.getInstanceIconFrame(icon))\n      : EMPTY_ARRAY;\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME multi-icon-layer-fragment-shader\n\nprecision highp float;\n\nuniform float opacity;\nuniform sampler2D iconsTexture;\nuniform float gamma;\nuniform bool sdf;\nuniform float alphaCutoff;\nuniform float buffer;\nuniform float outlineBuffer;\nuniform vec4 outlineColor;\n\nvarying vec4 vColor;\nvarying vec2 vTextureCoords;\nvarying vec2 uv;\n\nvoid main(void) {\n  geometry.uv = uv;\n\n  if (!picking_uActive) {\n    float alpha = texture2D(iconsTexture, vTextureCoords).a;\n    vec4 color = vColor;\n\n    // if enable sdf (signed distance fields)\n    if (sdf) {\n      float distance = alpha;\n      alpha = smoothstep(buffer - gamma, buffer + gamma, distance);\n\n      if (outlineBuffer > 0.0) {\n        float inFill = alpha;\n        float inBorder = smoothstep(outlineBuffer - gamma, outlineBuffer + gamma, distance);\n        color = mix(outlineColor, vColor, inFill);\n        alpha = inBorder;\n      }\n    }\n\n    // Take the global opacity and the alpha from color into account for the alpha component\n    float a = alpha * color.a;\n    \n    if (a < alphaCutoff) {\n      discard;\n    }\n\n    gl_FragColor = vec4(color.rgb, a * opacity);\n  }\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n`;\n","import {OPERATION} from '../lib/constants';\nimport LayersPass from './layers-pass';\n\nexport default class DrawLayersPass extends LayersPass {\n  shouldDrawLayer(layer) {\n    return layer.props.operation === OPERATION.DRAW;\n  }\n}\n","import debug from '../debug';\nimport DrawLayersPass from '../passes/draw-layers-pass';\nimport PickLayersPass from '../passes/pick-layers-pass';\nimport {Framebuffer} from '@luma.gl/core';\n\nconst TRACE_RENDER_LAYERS = 'deckRenderer.renderLayers';\n\nexport default class DeckRenderer {\n  constructor(gl) {\n    this.gl = gl;\n    this.layerFilter = null;\n    this.drawPickingColors = false;\n    this.drawLayersPass = new DrawLayersPass(gl);\n    this.pickLayersPass = new PickLayersPass(gl);\n    this.renderCount = 0;\n    this._needsRedraw = 'Initial render';\n    this.renderBuffers = [];\n    this.lastPostProcessEffect = null;\n  }\n\n  setProps(props) {\n    if ('layerFilter' in props && this.layerFilter !== props.layerFilter) {\n      this.layerFilter = props.layerFilter;\n      this._needsRedraw = 'layerFilter changed';\n    }\n\n    if ('drawPickingColors' in props && this.drawPickingColors !== props.drawPickingColors) {\n      this.drawPickingColors = props.drawPickingColors;\n      this._needsRedraw = 'drawPickingColors changed';\n    }\n  }\n\n  /*\n    target,\n    layers,\n    viewports,\n    onViewportActive,\n    views,\n    redrawReason,\n    clearCanvas,\n    effects,\n    pass,\n    stats\n  */\n  renderLayers(opts) {\n    const layerPass = this.drawPickingColors ? this.pickLayersPass : this.drawLayersPass;\n\n    opts.layerFilter = opts.layerFilter || this.layerFilter;\n    opts.effects = opts.effects || [];\n    opts.target = opts.target || Framebuffer.getDefaultFramebuffer(this.gl);\n\n    this._preRender(opts.effects, opts);\n\n    const outputBuffer = this.lastPostProcessEffect ? this.renderBuffers[0] : opts.target;\n    const renderStats = layerPass.render({...opts, target: outputBuffer});\n\n    this._postRender(opts.effects, opts);\n\n    this.renderCount++;\n\n    debug(TRACE_RENDER_LAYERS, this, renderStats, opts);\n  }\n\n  needsRedraw(opts = {clearRedrawFlags: false}) {\n    const redraw = this._needsRedraw;\n    if (opts.clearRedrawFlags) {\n      this._needsRedraw = false;\n    }\n    return redraw;\n  }\n\n  finalize() {\n    const {renderBuffers} = this;\n    for (const buffer of renderBuffers) {\n      buffer.delete();\n    }\n    renderBuffers.length = 0;\n  }\n\n  // Private\n  _preRender(effects, opts) {\n    let lastPostProcessEffect = null;\n\n    for (const effect of effects) {\n      effect.preRender(this.gl, opts);\n      if (effect.postRender) {\n        lastPostProcessEffect = effect;\n      }\n    }\n\n    if (lastPostProcessEffect) {\n      this._resizeRenderBuffers();\n    }\n    this.lastPostProcessEffect = lastPostProcessEffect;\n  }\n\n  _resizeRenderBuffers() {\n    const {renderBuffers} = this;\n    if (renderBuffers.length === 0) {\n      renderBuffers.push(new Framebuffer(this.gl), new Framebuffer(this.gl));\n    }\n    for (const buffer of renderBuffers) {\n      buffer.resize();\n    }\n  }\n\n  _postRender(effects, opts) {\n    const {renderBuffers} = this;\n    const params = {\n      inputBuffer: renderBuffers[0],\n      swapBuffer: renderBuffers[1],\n      target: null\n    };\n    for (const effect of effects) {\n      if (effect.postRender) {\n        if (effect === this.lastPostProcessEffect) {\n          params.target = opts.target;\n          effect.postRender(this.gl, params);\n          break;\n        }\n        const buffer = effect.postRender(this.gl, params);\n        params.inputBuffer = buffer;\n        params.swapBuffer = buffer === renderBuffers[0] ? renderBuffers[1] : renderBuffers[0];\n      }\n    }\n  }\n}\n","/* global document */\nconst state = {\n  onIninitialize: _ => _,\n  onFinalize: _ => _,\n  onMessage: null\n};\n\nexport default class Transport {\n  static setCallbacks({onInitialize, onFinalize, onMessage}) {\n    if (onInitialize) {\n      state.onInitialize = onInitialize;\n    }\n    if (onFinalize) {\n      state.onFinalize = onFinalize;\n    }\n    if (onMessage) {\n      state.onMessage = onMessage;\n    }\n    // this._flushQueuedConnections();\n  }\n\n  constructor(name = 'Transport') {\n    this.name = name;\n    this._messageQueue = [];\n    this.userData = {};\n  }\n\n  /**\n   * Return a root DOM element for this transport connection\n   * @return {HTMLElement} default implementation returns document.body\n   * Jupyter Notebook transports will return an element associated with the notebook cell\n   */\n  getRootDOMElement() {\n    return typeof document !== 'undefined' ? document.body : null;\n  }\n\n  /**\n   * Back-channel messaging\n   */\n  sendJSONMessage() {\n    // eslint-disable-next-line\n    console.error('Back-channel not implemented for this transport');\n  }\n\n  /**\n   * Back-channel messaging\n   */\n  sendBinaryMessage() {\n    // eslint-disable-next-line\n    console.error('Back-channel not implemented for this transport');\n  }\n\n  //\n  // API for transports (not intended for apps)\n  //\n\n  _initialize(options = {}) {\n    const message = {transport: this, ...options};\n    state.onInitialize(message);\n\n    // console.debug('Resolving init promise', options); // eslint-disable-line\n    // this._initResolvers.resolve(message);\n  }\n\n  _finalize(options = {}) {\n    const message = {transport: this, ...options};\n\n    // TODO - could potentially be called without Initialize being called\n    state.onFinalize(message);\n    this._destroyed = true;\n  }\n\n  _messageReceived(message = {}) {\n    message = {transport: this, ...message};\n\n    // TODO - this function could potentially be called before callback registered/ Initialize called\n    // if (!state.onMessage) {\n    //   console.error('Queueing transport message', message); // eslint-disable-line\n    //   this._messageQueue.push(message);\n    //   return;\n    // }\n\n    console.debug('Delivering transport message', message); // eslint-disable-line\n    state.onMessage(message);\n  }\n\n  /*\n  // This tries to handle the case that a transport connection initializes before the application\n  // has set the callbacks.\n  // Note: It is not clear that this can actually happen in the in initial Jupyter widget transport\n  _flushQueuedConnections() {\n    if (onInitialize) {\n      state._initPromise.then(initArgs => {\n        onInitialize(initArgs);\n\n        if (state._onMessage) {\n          // Send any queued messages\n          let message;\n          while ((message = this._messageQueue.pop())) {\n            console.debug('Delivering queued transport message', message); // eslint-disable-line\n            this._onMessage(message);\n          }\n        }\n      });\n    }\n  }\n  */\n\n  static _stringifyJSONSafe(v) {\n    const cache = new Set();\n    return JSON.stringify(v, (key, value) => {\n      if (typeof value === 'object' && value !== null) {\n        if (cache.has(value)) {\n          // Circular reference found\n          try {\n            // If this value does not reference a parent it can be deduped\n            return JSON.parse(JSON.stringify(value));\n          } catch (err) {\n            // discard key if value cannot be deduped\n            return undefined;\n          }\n        }\n        // Store value in our set\n        cache.add(value);\n      }\n      return value;\n    });\n  }\n}\n","var toPropertyKey = require(\"./toPropertyKey.js\");\nfunction _defineProperty(obj, key, value) {\n  key = toPropertyKey(key);\n  if (key in obj) {\n    Object.defineProperty(obj, key, {\n      value: value,\n      enumerable: true,\n      configurable: true,\n      writable: true\n    });\n  } else {\n    obj[key] = value;\n  }\n  return obj;\n}\nmodule.exports = _defineProperty, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","export default function isElectron(mockUserAgent) {\n  if (typeof window !== 'undefined' && typeof window.process === 'object' && window.process.type === 'renderer') {\n    return true;\n  }\n\n  if (typeof process !== 'undefined' && typeof process.versions === 'object' && Boolean(process.versions.electron)) {\n    return true;\n  }\n\n  const realUserAgent = typeof navigator === 'object' && typeof navigator.userAgent === 'string' && navigator.userAgent;\n  const userAgent = mockUserAgent || realUserAgent;\n\n  if (userAgent && userAgent.indexOf('Electron') >= 0) {\n    return true;\n  }\n\n  return false;\n}\n//# sourceMappingURL=is-electron.js.map","import { log } from '@luma.gl/gltools';\nexport function stubRemovedMethods(instance, className, version, methodNames) {\n  const upgradeMessage = \"See luma.gl \".concat(version, \" Upgrade Guide at https://luma.gl/docs/upgrade-guide\");\n  const prototype = Object.getPrototypeOf(instance);\n  methodNames.forEach(methodName => {\n    if (prototype.methodName) {\n      return;\n    }\n\n    prototype[methodName] = () => {\n      log.removed(\"Calling removed method \".concat(className, \".\").concat(methodName, \": \"), upgradeMessage)();\n      throw new Error(methodName);\n    };\n  });\n}\n//# sourceMappingURL=stub-methods.js.map","import MathArray from './math-array';\nimport { checkNumber } from '../../lib/validators';\nimport { config } from '../../lib/common';\nexport default class Matrix extends MathArray {\n  toString() {\n    let string = '[';\n\n    if (config.printRowMajor) {\n      string += 'row-major:';\n\n      for (let row = 0; row < this.RANK; ++row) {\n        for (let col = 0; col < this.RANK; ++col) {\n          string += \" \".concat(this[col * this.RANK + row]);\n        }\n      }\n    } else {\n      string += 'column-major:';\n\n      for (let i = 0; i < this.ELEMENTS; ++i) {\n        string += \" \".concat(this[i]);\n      }\n    }\n\n    string += ']';\n    return string;\n  }\n\n  getElementIndex(row, col) {\n    return col * this.RANK + row;\n  }\n\n  getElement(row, col) {\n    return this[col * this.RANK + row];\n  }\n\n  setElement(row, col, value) {\n    this[col * this.RANK + row] = checkNumber(value);\n    return this;\n  }\n\n  getColumn(columnIndex, result = new Array(this.RANK).fill(-0)) {\n    const firstIndex = columnIndex * this.RANK;\n\n    for (let i = 0; i < this.RANK; ++i) {\n      result[i] = this[firstIndex + i];\n    }\n\n    return result;\n  }\n\n  setColumn(columnIndex, columnVector) {\n    const firstIndex = columnIndex * this.RANK;\n\n    for (let i = 0; i < this.RANK; ++i) {\n      this[firstIndex + i] = columnVector[i];\n    }\n\n    return this;\n  }\n\n}\n//# sourceMappingURL=matrix.js.map","export default class Pass {\n  id: string;\n  gl: WebGLRenderingContext;\n  props: any;\n\n  constructor(gl: WebGLRenderingContext, props: {id: string} = {id: 'pass'}) {\n    const {id} = props;\n    this.id = id; // id of this pass\n    this.gl = gl;\n    this.props = {...props};\n  }\n\n  setProps(props): void {\n    Object.assign(this.props, props);\n  }\n\n  render(params): void {} // eslint-disable-line @typescript-eslint/no-empty-function\n\n  cleanup() {} // eslint-disable-line @typescript-eslint/no-empty-function\n}\n","export function getTransferList(object, recursive = true, transfers) {\n  const transfersSet = transfers || new Set();\n\n  if (!object) {} else if (isTransferable(object)) {\n    transfersSet.add(object);\n  } else if (isTransferable(object.buffer)) {\n    transfersSet.add(object.buffer);\n  } else if (ArrayBuffer.isView(object)) {} else if (recursive && typeof object === 'object') {\n    for (const key in object) {\n      getTransferList(object[key], recursive, transfersSet);\n    }\n  }\n\n  return transfers === undefined ? Array.from(transfersSet) : [];\n}\n\nfunction isTransferable(object) {\n  if (!object) {\n    return false;\n  }\n\n  if (object instanceof ArrayBuffer) {\n    return true;\n  }\n\n  if (typeof MessagePort !== 'undefined' && object instanceof MessagePort) {\n    return true;\n  }\n\n  if (typeof ImageBitmap !== 'undefined' && object instanceof ImageBitmap) {\n    return true;\n  }\n\n  if (typeof OffscreenCanvas !== 'undefined' && object instanceof OffscreenCanvas) {\n    return true;\n  }\n\n  return false;\n}\n\nexport function getTransferListForWriter(object) {\n  if (object === null) {\n    return {};\n  }\n\n  const clone = Object.assign({}, object);\n  Object.keys(clone).forEach(key => {\n    if (typeof object[key] === 'object' && !ArrayBuffer.isView(object[key])) {\n      clone[key] = getTransferListForWriter(object[key]);\n    } else if (typeof clone[key] === 'function' || clone[key] instanceof RegExp) {\n      clone[key] = {};\n    } else {\n      clone[key] = object[key];\n    }\n  });\n  return clone;\n}\n//# sourceMappingURL=get-transfer-list.js.map","import LayersPass, {LayersPassRenderOptions, RenderStats, Rect} from './layers-pass';\nimport {withParameters} from '@luma.gl/core';\nimport GL from '@luma.gl/constants';\nimport {OPERATION} from '../lib/constants';\nimport log from '../utils/log';\n\nimport type {Framebuffer} from '@luma.gl/core';\nimport type Viewport from '../viewports/viewport';\nimport type Layer from '../lib/layer';\n\nconst PICKING_PARAMETERS = {\n  blendFunc: [GL.ONE, GL.ZERO, GL.CONSTANT_ALPHA, GL.ZERO],\n  blendEquation: GL.FUNC_ADD\n};\n\ntype PickLayersPassRenderOptions = LayersPassRenderOptions & {\n  pickingFBO: Framebuffer;\n  deviceRect: Rect;\n  pickZ: boolean;\n};\n\ntype EncodedPickingColors = {\n  a: number;\n  layer: Layer;\n  viewports: Viewport[];\n};\n\nexport type PickingColorDecoder = (pickedColor: number[] | Uint8Array) =>\n  | {\n      pickedLayer: Layer;\n      pickedViewports: Viewport[];\n      pickedObjectIndex: number;\n    }\n  | undefined;\n\nexport default class PickLayersPass extends LayersPass {\n  private pickZ?: boolean;\n  private _colors: {\n    byLayer: Map<Layer, EncodedPickingColors>;\n    byAlpha: EncodedPickingColors[];\n  } | null = null;\n\n  render(props: PickLayersPassRenderOptions) {\n    if (props.pickingFBO) {\n      // When drawing into an off-screen buffer, use the alpha channel to encode layer index\n      return this._drawPickingBuffer(props);\n    }\n    // When drawing to screen (debug mode), do not use the alpha channel so that result is always visible\n    return super.render(props);\n  }\n\n  // Private\n  // Draws list of layers and viewports into the picking buffer\n  // Note: does not sample the buffer, that has to be done by the caller\n  _drawPickingBuffer({\n    layers,\n    layerFilter,\n    views,\n    viewports,\n    onViewportActive,\n    pickingFBO,\n    deviceRect: {x, y, width, height},\n    cullRect,\n    effects,\n    pass = 'picking',\n    pickZ\n  }: PickLayersPassRenderOptions): {\n    decodePickingColor: PickingColorDecoder | null;\n    stats: RenderStats;\n  } {\n    const gl = this.gl;\n    this.pickZ = pickZ;\n\n    // Track encoded layer indices\n    const encodedColors = pickZ\n      ? null\n      : {\n          byLayer: new Map(),\n          byAlpha: []\n        };\n    // Temporarily store it on the instance so that it can be accessed by this.getLayerParameters\n    this._colors = encodedColors;\n\n    // Make sure we clear scissor test and fbo bindings in case of exceptions\n    // We are only interested in one pixel, no need to render anything else\n    // Note that the callback here is called synchronously.\n    // Set blend mode for picking\n    // always overwrite existing pixel with [r,g,b,layerIndex]\n    const renderStatus = withParameters(\n      gl,\n      {\n        scissorTest: true,\n        scissor: [x, y, width, height],\n        clearColor: [0, 0, 0, 0],\n        // When used as Mapbox custom layer, the context state may be dirty\n        // TODO - Remove when mapbox fixes this issue\n        // https://github.com/mapbox/mapbox-gl-js/issues/7801\n        depthMask: true,\n        depthTest: true,\n        depthRange: [0, 1],\n        colorMask: [true, true, true, true],\n        // Blending\n        ...PICKING_PARAMETERS,\n        blend: !pickZ\n      },\n      () =>\n        super.render({\n          target: pickingFBO,\n          layers,\n          layerFilter,\n          views,\n          viewports,\n          onViewportActive,\n          cullRect,\n          effects: effects?.filter(e => e.useInPicking),\n          pass\n        })\n    );\n\n    // Clear the temp field\n    this._colors = null;\n    const decodePickingColor = encodedColors && decodeColor.bind(null, encodedColors);\n    return {decodePickingColor, stats: renderStatus};\n  }\n\n  protected shouldDrawLayer(layer: Layer): boolean {\n    return layer.props.pickable && layer.props.operation === OPERATION.DRAW;\n  }\n\n  protected getModuleParameters() {\n    return {\n      pickingActive: 1,\n      pickingAttribute: this.pickZ,\n      // turn off lighting by adding empty light source object\n      // lights shader module relies on the `lightSources` to turn on/off lighting\n      lightSources: {}\n    };\n  }\n\n  protected getLayerParameters(layer: Layer, layerIndex: number, viewport: Viewport): any {\n    const pickParameters = {...layer.props.parameters};\n\n    if (!this._colors) {\n      pickParameters.blend = false;\n    } else {\n      Object.assign(pickParameters, PICKING_PARAMETERS);\n      pickParameters.blend = true;\n      pickParameters.blendColor = encodeColor(this._colors, layer, viewport);\n    }\n\n    return pickParameters;\n  }\n}\n\n// Assign an unique alpha value for each pickable layer and track the encoding in the cache object\n// Returns normalized blend color\nfunction encodeColor(\n  encoded: {\n    byLayer: Map<Layer, EncodedPickingColors>;\n    byAlpha: EncodedPickingColors[];\n  },\n  layer: Layer,\n  viewport: Viewport\n): number[] {\n  const {byLayer, byAlpha} = encoded;\n  let a;\n\n  // Encode layerIndex in the alpha channel\n  // TODO - combine small layers to better utilize the picking color space\n  let entry = byLayer.get(layer);\n  if (entry) {\n    entry.viewports.push(viewport);\n    a = entry.a;\n  } else {\n    a = byLayer.size + 1;\n    if (a <= 255) {\n      entry = {a, layer, viewports: [viewport]};\n      byLayer.set(layer, entry);\n      byAlpha[a] = entry;\n    } else {\n      log.warn('Too many pickable layers, only picking the first 255')();\n      a = 0;\n    }\n  }\n  return [0, 0, 0, a / 255];\n}\n\n// Given a picked color, retrieve the corresponding layer and viewports from cache\nfunction decodeColor(\n  encoded: {\n    byLayer: Map<Layer, EncodedPickingColors>;\n    byAlpha: EncodedPickingColors[];\n  },\n  pickedColor: number[] | Uint8Array\n):\n  | {\n      pickedLayer: Layer;\n      pickedViewports: Viewport[];\n      pickedObjectIndex: number;\n    }\n  | undefined {\n  const entry = encoded.byAlpha[pickedColor[3]];\n  return (\n    entry && {\n      pickedLayer: entry.layer,\n      pickedViewports: entry.viewports,\n      pickedObjectIndex: entry.layer.decodePickingColor(pickedColor)\n    }\n  );\n}\n","const BIG_ENDIAN = false;\nconst LITTLE_ENDIAN = true;\nexport function getBinaryImageMetadata(binaryData) {\n  const dataView = toDataView(binaryData);\n  return getPngMetadata(dataView) || getJpegMetadata(dataView) || getGifMetadata(dataView) || getBmpMetadata(dataView);\n}\n\nfunction getPngMetadata(binaryData) {\n  const dataView = toDataView(binaryData);\n  const isPng = dataView.byteLength >= 24 && dataView.getUint32(0, BIG_ENDIAN) === 0x89504e47;\n\n  if (!isPng) {\n    return null;\n  }\n\n  return {\n    mimeType: 'image/png',\n    width: dataView.getUint32(16, BIG_ENDIAN),\n    height: dataView.getUint32(20, BIG_ENDIAN)\n  };\n}\n\nfunction getGifMetadata(binaryData) {\n  const dataView = toDataView(binaryData);\n  const isGif = dataView.byteLength >= 10 && dataView.getUint32(0, BIG_ENDIAN) === 0x47494638;\n\n  if (!isGif) {\n    return null;\n  }\n\n  return {\n    mimeType: 'image/gif',\n    width: dataView.getUint16(6, LITTLE_ENDIAN),\n    height: dataView.getUint16(8, LITTLE_ENDIAN)\n  };\n}\n\nexport function getBmpMetadata(binaryData) {\n  const dataView = toDataView(binaryData);\n  const isBmp = dataView.byteLength >= 14 && dataView.getUint16(0, BIG_ENDIAN) === 0x424d && dataView.getUint32(2, LITTLE_ENDIAN) === dataView.byteLength;\n\n  if (!isBmp) {\n    return null;\n  }\n\n  return {\n    mimeType: 'image/bmp',\n    width: dataView.getUint32(18, LITTLE_ENDIAN),\n    height: dataView.getUint32(22, LITTLE_ENDIAN)\n  };\n}\n\nfunction getJpegMetadata(binaryData) {\n  const dataView = toDataView(binaryData);\n  const isJpeg = dataView.byteLength >= 3 && dataView.getUint16(0, BIG_ENDIAN) === 0xffd8 && dataView.getUint8(2) === 0xff;\n\n  if (!isJpeg) {\n    return null;\n  }\n\n  const {\n    tableMarkers,\n    sofMarkers\n  } = getJpegMarkers();\n  let i = 2;\n\n  while (i + 9 < dataView.byteLength) {\n    const marker = dataView.getUint16(i, BIG_ENDIAN);\n\n    if (sofMarkers.has(marker)) {\n      return {\n        mimeType: 'image/jpeg',\n        height: dataView.getUint16(i + 5, BIG_ENDIAN),\n        width: dataView.getUint16(i + 7, BIG_ENDIAN)\n      };\n    }\n\n    if (!tableMarkers.has(marker)) {\n      return null;\n    }\n\n    i += 2;\n    i += dataView.getUint16(i, BIG_ENDIAN);\n  }\n\n  return null;\n}\n\nfunction getJpegMarkers() {\n  const tableMarkers = new Set([0xffdb, 0xffc4, 0xffcc, 0xffdd, 0xfffe]);\n\n  for (let i = 0xffe0; i < 0xfff0; ++i) {\n    tableMarkers.add(i);\n  }\n\n  const sofMarkers = new Set([0xffc0, 0xffc1, 0xffc2, 0xffc3, 0xffc5, 0xffc6, 0xffc7, 0xffc9, 0xffca, 0xffcb, 0xffcd, 0xffce, 0xffcf, 0xffde]);\n  return {\n    tableMarkers,\n    sofMarkers\n  };\n}\n\nfunction toDataView(data) {\n  if (data instanceof DataView) {\n    return data;\n  }\n\n  if (ArrayBuffer.isView(data)) {\n    return new DataView(data.buffer);\n  }\n\n  if (data instanceof ArrayBuffer) {\n    return new DataView(data);\n  }\n\n  throw new Error('toDataView');\n}\n//# sourceMappingURL=binary-image-api.js.map","// Assume data array is sorted by <accessor>\n// Replaces the specified range with a new subarray\n// Mutates the data array\n// Returns {startRow, endRow} of the inserted items\nexport function replaceInRange({\n  data,\n  getIndex,\n  dataRange,\n  replace\n}: {\n  data: any[];\n  getIndex: (d: any) => number;\n  dataRange: {startRow?: number; endRow?: number};\n  replace: any[];\n}): {startRow: Number; endRow: number} {\n  const {startRow = 0, endRow = Infinity} = dataRange;\n  const count = data.length;\n  let replaceStart = count;\n  let replaceEnd = count;\n  for (let i = 0; i < count; i++) {\n    const row = getIndex(data[i]);\n    if (replaceStart > i && row >= startRow) {\n      replaceStart = i;\n    }\n    if (row >= endRow) {\n      replaceEnd = i;\n      break;\n    }\n  }\n  let index = replaceStart;\n  const dataLengthChanged = replaceEnd - replaceStart !== replace.length;\n  // Save the items after replaceEnd before we overwrite data\n  const endChunk = dataLengthChanged ? data.slice(replaceEnd) : undefined;\n  // Insert new items\n  for (let i = 0; i < replace.length; i++) {\n    data[index++] = replace[i];\n  }\n  if (endChunk) {\n    // Append items after replaceEnd\n    for (let i = 0; i < endChunk.length; i++) {\n      data[index++] = endChunk[i];\n    }\n    // Trim additional items\n    data.length = index;\n  }\n\n  return {\n    startRow: replaceStart,\n    endRow: replaceStart + replace.length\n  };\n}\n","var objectWithoutPropertiesLoose = require(\"./objectWithoutPropertiesLoose\");\n\nfunction _objectWithoutProperties(source, excluded) {\n  if (source == null) return {};\n  var target = objectWithoutPropertiesLoose(source, excluded);\n  var key, i;\n\n  if (Object.getOwnPropertySymbols) {\n    var sourceSymbolKeys = Object.getOwnPropertySymbols(source);\n\n    for (i = 0; i < sourceSymbolKeys.length; i++) {\n      key = sourceSymbolKeys[i];\n      if (excluded.indexOf(key) >= 0) continue;\n      if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;\n      target[key] = source[key];\n    }\n  }\n\n  return target;\n}\n\nmodule.exports = _objectWithoutProperties;","/* global document */\n// TODO - make sure this can be called multiple times without adding elements\nexport function loadCSS(url) {\n  const link = document.createElement('link');\n  link.type = 'text/css';\n  link.rel = 'stylesheet';\n  link.href = url;\n  document.getElementsByTagName('head')[0].appendChild(link);\n}\n\nexport function createContainer(width, height) {\n  const container = document.createElement('div');\n  container.style.width = Number.isFinite(width) ? `${width}px` : width;\n  container.style.height = `${height}px`;\n  container.style.position = 'relative';\n  return container;\n}\n","export const VERSION = typeof \"3.2.10\" !== 'undefined' ? \"3.2.10\" : 'latest';\n//# sourceMappingURL=version.js.map","import { VERSION } from './lib/utils/version';\nconst DEFAULT_DRACO_OPTIONS = {\n  draco: {\n    decoderType: typeof WebAssembly === 'object' ? 'wasm' : 'js',\n    libraryPath: 'libs/',\n    extraAttributes: {},\n    attributeNameEntry: undefined\n  }\n};\nexport const DracoLoader = {\n  name: 'Draco',\n  id: 'draco',\n  module: 'draco',\n  shapes: ['mesh'],\n  version: VERSION,\n  worker: true,\n  extensions: ['drc'],\n  mimeTypes: ['application/octet-stream'],\n  binary: true,\n  tests: ['DRACO'],\n  options: DEFAULT_DRACO_OPTIONS\n};\nexport const _TypecheckDracoLoader = DracoLoader;\n//# sourceMappingURL=draco-loader.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { assert } from '../../utils/assert';\nexport default class Schema {\n  constructor(fields, metadata) {\n    _defineProperty(this, \"fields\", void 0);\n\n    _defineProperty(this, \"metadata\", void 0);\n\n    assert(Array.isArray(fields));\n    checkNames(fields);\n    this.fields = fields;\n    this.metadata = metadata || new Map();\n  }\n\n  compareTo(other) {\n    if (this.metadata !== other.metadata) {\n      return false;\n    }\n\n    if (this.fields.length !== other.fields.length) {\n      return false;\n    }\n\n    for (let i = 0; i < this.fields.length; ++i) {\n      if (!this.fields[i].compareTo(other.fields[i])) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  select(...columnNames) {\n    const nameMap = Object.create(null);\n\n    for (const name of columnNames) {\n      nameMap[name] = true;\n    }\n\n    const selectedFields = this.fields.filter(field => nameMap[field.name]);\n    return new Schema(selectedFields, this.metadata);\n  }\n\n  selectAt(...columnIndices) {\n    const selectedFields = columnIndices.map(index => this.fields[index]).filter(Boolean);\n    return new Schema(selectedFields, this.metadata);\n  }\n\n  assign(schemaOrFields) {\n    let fields;\n    let metadata = this.metadata;\n\n    if (schemaOrFields instanceof Schema) {\n      const otherSchema = schemaOrFields;\n      fields = otherSchema.fields;\n      metadata = mergeMaps(mergeMaps(new Map(), this.metadata), otherSchema.metadata);\n    } else {\n      fields = schemaOrFields;\n    }\n\n    const fieldMap = Object.create(null);\n\n    for (const field of this.fields) {\n      fieldMap[field.name] = field;\n    }\n\n    for (const field of fields) {\n      fieldMap[field.name] = field;\n    }\n\n    const mergedFields = Object.values(fieldMap);\n    return new Schema(mergedFields, metadata);\n  }\n\n}\n\nfunction checkNames(fields) {\n  const usedNames = {};\n\n  for (const field of fields) {\n    if (usedNames[field.name]) {\n      console.warn('Schema: duplicated field name', field.name, field);\n    }\n\n    usedNames[field.name] = true;\n  }\n}\n\nfunction mergeMaps(m1, m2) {\n  return new Map([...(m1 || new Map()), ...(m2 || new Map())]);\n}\n//# sourceMappingURL=schema.js.map","export function assert(condition, message) {\n  if (!condition) {\n    throw new Error(message || 'loader assertion failed.');\n  }\n}\n//# sourceMappingURL=assert.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nexport default class Field {\n  constructor(name, type, nullable = false, metadata = new Map()) {\n    _defineProperty(this, \"name\", void 0);\n\n    _defineProperty(this, \"type\", void 0);\n\n    _defineProperty(this, \"nullable\", void 0);\n\n    _defineProperty(this, \"metadata\", void 0);\n\n    this.name = name;\n    this.type = type;\n    this.nullable = nullable;\n    this.metadata = metadata;\n  }\n\n  get typeId() {\n    return this.type && this.type.typeId;\n  }\n\n  clone() {\n    return new Field(this.name, this.type, this.nullable, this.metadata);\n  }\n\n  compareTo(other) {\n    return this.name === other.name && this.type === other.type && this.nullable === other.nullable && this.metadata === other.metadata;\n  }\n\n  toString() {\n    return \"\".concat(this.type).concat(this.nullable ? ', nullable' : '').concat(this.metadata ? \", metadata: \".concat(this.metadata) : '');\n  }\n\n}\n//# sourceMappingURL=field.js.map","export let Type;\n\n(function (Type) {\n  Type[Type[\"NONE\"] = 0] = \"NONE\";\n  Type[Type[\"Null\"] = 1] = \"Null\";\n  Type[Type[\"Int\"] = 2] = \"Int\";\n  Type[Type[\"Float\"] = 3] = \"Float\";\n  Type[Type[\"Binary\"] = 4] = \"Binary\";\n  Type[Type[\"Utf8\"] = 5] = \"Utf8\";\n  Type[Type[\"Bool\"] = 6] = \"Bool\";\n  Type[Type[\"Decimal\"] = 7] = \"Decimal\";\n  Type[Type[\"Date\"] = 8] = \"Date\";\n  Type[Type[\"Time\"] = 9] = \"Time\";\n  Type[Type[\"Timestamp\"] = 10] = \"Timestamp\";\n  Type[Type[\"Interval\"] = 11] = \"Interval\";\n  Type[Type[\"List\"] = 12] = \"List\";\n  Type[Type[\"Struct\"] = 13] = \"Struct\";\n  Type[Type[\"Union\"] = 14] = \"Union\";\n  Type[Type[\"FixedSizeBinary\"] = 15] = \"FixedSizeBinary\";\n  Type[Type[\"FixedSizeList\"] = 16] = \"FixedSizeList\";\n  Type[Type[\"Map\"] = 17] = \"Map\";\n  Type[Type[\"Dictionary\"] = -1] = \"Dictionary\";\n  Type[Type[\"Int8\"] = -2] = \"Int8\";\n  Type[Type[\"Int16\"] = -3] = \"Int16\";\n  Type[Type[\"Int32\"] = -4] = \"Int32\";\n  Type[Type[\"Int64\"] = -5] = \"Int64\";\n  Type[Type[\"Uint8\"] = -6] = \"Uint8\";\n  Type[Type[\"Uint16\"] = -7] = \"Uint16\";\n  Type[Type[\"Uint32\"] = -8] = \"Uint32\";\n  Type[Type[\"Uint64\"] = -9] = \"Uint64\";\n  Type[Type[\"Float16\"] = -10] = \"Float16\";\n  Type[Type[\"Float32\"] = -11] = \"Float32\";\n  Type[Type[\"Float64\"] = -12] = \"Float64\";\n  Type[Type[\"DateDay\"] = -13] = \"DateDay\";\n  Type[Type[\"DateMillisecond\"] = -14] = \"DateMillisecond\";\n  Type[Type[\"TimestampSecond\"] = -15] = \"TimestampSecond\";\n  Type[Type[\"TimestampMillisecond\"] = -16] = \"TimestampMillisecond\";\n  Type[Type[\"TimestampMicrosecond\"] = -17] = \"TimestampMicrosecond\";\n  Type[Type[\"TimestampNanosecond\"] = -18] = \"TimestampNanosecond\";\n  Type[Type[\"TimeSecond\"] = -19] = \"TimeSecond\";\n  Type[Type[\"TimeMillisecond\"] = -20] = \"TimeMillisecond\";\n  Type[Type[\"TimeMicrosecond\"] = -21] = \"TimeMicrosecond\";\n  Type[Type[\"TimeNanosecond\"] = -22] = \"TimeNanosecond\";\n  Type[Type[\"DenseUnion\"] = -23] = \"DenseUnion\";\n  Type[Type[\"SparseUnion\"] = -24] = \"SparseUnion\";\n  Type[Type[\"IntervalDayTime\"] = -25] = \"IntervalDayTime\";\n  Type[Type[\"IntervalYearMonth\"] = -26] = \"IntervalYearMonth\";\n})(Type || (Type = {}));\n//# sourceMappingURL=enum.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\n\nlet _Symbol$toStringTag, _Symbol$toStringTag2, _Symbol$toStringTag3, _Symbol$toStringTag4, _Symbol$toStringTag5, _Symbol$toStringTag6, _Symbol$toStringTag7, _Symbol$toStringTag8;\n\nimport { Type } from './enum';\nexport { Type } from './enum';\nexport class DataType {\n  static isNull(x) {\n    return x && x.typeId === Type.Null;\n  }\n\n  static isInt(x) {\n    return x && x.typeId === Type.Int;\n  }\n\n  static isFloat(x) {\n    return x && x.typeId === Type.Float;\n  }\n\n  static isBinary(x) {\n    return x && x.typeId === Type.Binary;\n  }\n\n  static isUtf8(x) {\n    return x && x.typeId === Type.Utf8;\n  }\n\n  static isBool(x) {\n    return x && x.typeId === Type.Bool;\n  }\n\n  static isDecimal(x) {\n    return x && x.typeId === Type.Decimal;\n  }\n\n  static isDate(x) {\n    return x && x.typeId === Type.Date;\n  }\n\n  static isTime(x) {\n    return x && x.typeId === Type.Time;\n  }\n\n  static isTimestamp(x) {\n    return x && x.typeId === Type.Timestamp;\n  }\n\n  static isInterval(x) {\n    return x && x.typeId === Type.Interval;\n  }\n\n  static isList(x) {\n    return x && x.typeId === Type.List;\n  }\n\n  static isStruct(x) {\n    return x && x.typeId === Type.Struct;\n  }\n\n  static isUnion(x) {\n    return x && x.typeId === Type.Union;\n  }\n\n  static isFixedSizeBinary(x) {\n    return x && x.typeId === Type.FixedSizeBinary;\n  }\n\n  static isFixedSizeList(x) {\n    return x && x.typeId === Type.FixedSizeList;\n  }\n\n  static isMap(x) {\n    return x && x.typeId === Type.Map;\n  }\n\n  static isDictionary(x) {\n    return x && x.typeId === Type.Dictionary;\n  }\n\n  get typeId() {\n    return Type.NONE;\n  }\n\n  compareTo(other) {\n    return this === other;\n  }\n\n}\nexport class Null extends DataType {\n  get typeId() {\n    return Type.Null;\n  }\n\n  get [Symbol.toStringTag]() {\n    return 'Null';\n  }\n\n  toString() {\n    return 'Null';\n  }\n\n}\nexport class Bool extends DataType {\n  get typeId() {\n    return Type.Bool;\n  }\n\n  get [Symbol.toStringTag]() {\n    return 'Bool';\n  }\n\n  toString() {\n    return 'Bool';\n  }\n\n}\n_Symbol$toStringTag = Symbol.toStringTag;\nexport class Int extends DataType {\n  constructor(isSigned, bitWidth) {\n    super();\n\n    _defineProperty(this, \"isSigned\", void 0);\n\n    _defineProperty(this, \"bitWidth\", void 0);\n\n    this.isSigned = isSigned;\n    this.bitWidth = bitWidth;\n  }\n\n  get typeId() {\n    return Type.Int;\n  }\n\n  get [_Symbol$toStringTag]() {\n    return 'Int';\n  }\n\n  toString() {\n    return \"\".concat(this.isSigned ? 'I' : 'Ui', \"nt\").concat(this.bitWidth);\n  }\n\n}\nexport class Int8 extends Int {\n  constructor() {\n    super(true, 8);\n  }\n\n}\nexport class Int16 extends Int {\n  constructor() {\n    super(true, 16);\n  }\n\n}\nexport class Int32 extends Int {\n  constructor() {\n    super(true, 32);\n  }\n\n}\nexport class Int64 extends Int {\n  constructor() {\n    super(true, 64);\n  }\n\n}\nexport class Uint8 extends Int {\n  constructor() {\n    super(false, 8);\n  }\n\n}\nexport class Uint16 extends Int {\n  constructor() {\n    super(false, 16);\n  }\n\n}\nexport class Uint32 extends Int {\n  constructor() {\n    super(false, 32);\n  }\n\n}\nexport class Uint64 extends Int {\n  constructor() {\n    super(false, 64);\n  }\n\n}\nconst Precision = {\n  HALF: 16,\n  SINGLE: 32,\n  DOUBLE: 64\n};\n_Symbol$toStringTag2 = Symbol.toStringTag;\nexport class Float extends DataType {\n  constructor(precision) {\n    super();\n\n    _defineProperty(this, \"precision\", void 0);\n\n    this.precision = precision;\n  }\n\n  get typeId() {\n    return Type.Float;\n  }\n\n  get [_Symbol$toStringTag2]() {\n    return 'Float';\n  }\n\n  toString() {\n    return \"Float\".concat(this.precision);\n  }\n\n}\nexport class Float16 extends Float {\n  constructor() {\n    super(Precision.HALF);\n  }\n\n}\nexport class Float32 extends Float {\n  constructor() {\n    super(Precision.SINGLE);\n  }\n\n}\nexport class Float64 extends Float {\n  constructor() {\n    super(Precision.DOUBLE);\n  }\n\n}\nexport class Binary extends DataType {\n  constructor() {\n    super();\n  }\n\n  get typeId() {\n    return Type.Binary;\n  }\n\n  toString() {\n    return 'Binary';\n  }\n\n  get [Symbol.toStringTag]() {\n    return 'Binary';\n  }\n\n}\nexport class Utf8 extends DataType {\n  get typeId() {\n    return Type.Utf8;\n  }\n\n  get [Symbol.toStringTag]() {\n    return 'Utf8';\n  }\n\n  toString() {\n    return 'Utf8';\n  }\n\n}\nconst DateUnit = {\n  DAY: 0,\n  MILLISECOND: 1\n};\n_Symbol$toStringTag3 = Symbol.toStringTag;\nexport class Date extends DataType {\n  constructor(unit) {\n    super();\n\n    _defineProperty(this, \"unit\", void 0);\n\n    this.unit = unit;\n  }\n\n  get typeId() {\n    return Type.Date;\n  }\n\n  get [_Symbol$toStringTag3]() {\n    return 'Date';\n  }\n\n  toString() {\n    return \"Date\".concat((this.unit + 1) * 32, \"<\").concat(DateUnit[this.unit], \">\");\n  }\n\n}\nexport class DateDay extends Date {\n  constructor() {\n    super(DateUnit.DAY);\n  }\n\n}\nexport class DateMillisecond extends Date {\n  constructor() {\n    super(DateUnit.MILLISECOND);\n  }\n\n}\nconst TimeUnit = {\n  SECOND: 1,\n  MILLISECOND: 1e3,\n  MICROSECOND: 1e6,\n  NANOSECOND: 1e9\n};\n_Symbol$toStringTag4 = Symbol.toStringTag;\nexport class Time extends DataType {\n  constructor(unit, bitWidth) {\n    super();\n\n    _defineProperty(this, \"unit\", void 0);\n\n    _defineProperty(this, \"bitWidth\", void 0);\n\n    this.unit = unit;\n    this.bitWidth = bitWidth;\n  }\n\n  get typeId() {\n    return Type.Time;\n  }\n\n  toString() {\n    return \"Time\".concat(this.bitWidth, \"<\").concat(TimeUnit[this.unit], \">\");\n  }\n\n  get [_Symbol$toStringTag4]() {\n    return 'Time';\n  }\n\n}\nexport class TimeSecond extends Time {\n  constructor() {\n    super(TimeUnit.SECOND, 32);\n  }\n\n}\nexport class TimeMillisecond extends Time {\n  constructor() {\n    super(TimeUnit.MILLISECOND, 32);\n  }\n\n}\n_Symbol$toStringTag5 = Symbol.toStringTag;\nexport class Timestamp extends DataType {\n  constructor(unit, timezone = null) {\n    super();\n\n    _defineProperty(this, \"unit\", void 0);\n\n    _defineProperty(this, \"timezone\", void 0);\n\n    this.unit = unit;\n    this.timezone = timezone;\n  }\n\n  get typeId() {\n    return Type.Timestamp;\n  }\n\n  get [_Symbol$toStringTag5]() {\n    return 'Timestamp';\n  }\n\n  toString() {\n    return \"Timestamp<\".concat(TimeUnit[this.unit]).concat(this.timezone ? \", \".concat(this.timezone) : '', \">\");\n  }\n\n}\nexport class TimestampSecond extends Timestamp {\n  constructor(timezone = null) {\n    super(TimeUnit.SECOND, timezone);\n  }\n\n}\nexport class TimestampMillisecond extends Timestamp {\n  constructor(timezone = null) {\n    super(TimeUnit.MILLISECOND, timezone);\n  }\n\n}\nexport class TimestampMicrosecond extends Timestamp {\n  constructor(timezone = null) {\n    super(TimeUnit.MICROSECOND, timezone);\n  }\n\n}\nexport class TimestampNanosecond extends Timestamp {\n  constructor(timezone = null) {\n    super(TimeUnit.NANOSECOND, timezone);\n  }\n\n}\nconst IntervalUnit = {\n  DAY_TIME: 0,\n  YEAR_MONTH: 1\n};\n_Symbol$toStringTag6 = Symbol.toStringTag;\nexport class Interval extends DataType {\n  constructor(unit) {\n    super();\n\n    _defineProperty(this, \"unit\", void 0);\n\n    this.unit = unit;\n  }\n\n  get typeId() {\n    return Type.Interval;\n  }\n\n  get [_Symbol$toStringTag6]() {\n    return 'Interval';\n  }\n\n  toString() {\n    return \"Interval<\".concat(IntervalUnit[this.unit], \">\");\n  }\n\n}\nexport class IntervalDayTime extends Interval {\n  constructor() {\n    super(IntervalUnit.DAY_TIME);\n  }\n\n}\nexport class IntervalYearMonth extends Interval {\n  constructor() {\n    super(IntervalUnit.YEAR_MONTH);\n  }\n\n}\n_Symbol$toStringTag7 = Symbol.toStringTag;\nexport class FixedSizeList extends DataType {\n  constructor(listSize, child) {\n    super();\n\n    _defineProperty(this, \"listSize\", void 0);\n\n    _defineProperty(this, \"children\", void 0);\n\n    this.listSize = listSize;\n    this.children = [child];\n  }\n\n  get typeId() {\n    return Type.FixedSizeList;\n  }\n\n  get valueType() {\n    return this.children[0].type;\n  }\n\n  get valueField() {\n    return this.children[0];\n  }\n\n  get [_Symbol$toStringTag7]() {\n    return 'FixedSizeList';\n  }\n\n  toString() {\n    return \"FixedSizeList[\".concat(this.listSize, \"]<\").concat(this.valueType, \">\");\n  }\n\n}\n_Symbol$toStringTag8 = Symbol.toStringTag;\nexport class Struct extends DataType {\n  constructor(children) {\n    super();\n\n    _defineProperty(this, \"children\", void 0);\n\n    this.children = children;\n  }\n\n  get typeId() {\n    return Type.Struct;\n  }\n\n  toString() {\n    return \"Struct<{\".concat(this.children.map(f => \"\".concat(f.name, \":\").concat(f.type)).join(', '), \"}>\");\n  }\n\n  get [_Symbol$toStringTag8]() {\n    return 'Struct';\n  }\n\n}\n//# sourceMappingURL=type.js.map","import { Schema, Field, FixedSizeList } from '../../lib/schema/schema';\nimport { getArrowTypeFromTypedArray } from '../../lib/arrow/arrow-like-type-utils';\nexport function deduceMeshSchema(attributes, metadata) {\n  const fields = deduceMeshFields(attributes);\n  return new Schema(fields, metadata);\n}\nexport function deduceMeshField(attributeName, attribute, optionalMetadata) {\n  const type = getArrowTypeFromTypedArray(attribute.value);\n  const metadata = optionalMetadata ? optionalMetadata : makeMeshAttributeMetadata(attribute);\n  const field = new Field(attributeName, new FixedSizeList(attribute.size, new Field('value', type)), false, metadata);\n  return field;\n}\n\nfunction deduceMeshFields(attributes) {\n  const fields = [];\n\n  for (const attributeName in attributes) {\n    const attribute = attributes[attributeName];\n    fields.push(deduceMeshField(attributeName, attribute));\n  }\n\n  return fields;\n}\n\nexport function makeMeshAttributeMetadata(attribute) {\n  const result = new Map();\n\n  if ('byteOffset' in attribute) {\n    result.set('byteOffset', attribute.byteOffset.toString(10));\n  }\n\n  if ('byteStride' in attribute) {\n    result.set('byteStride', attribute.byteStride.toString(10));\n  }\n\n  if ('normalized' in attribute) {\n    result.set('normalized', attribute.normalized.toString());\n  }\n\n  return result;\n}\n//# sourceMappingURL=deduce-mesh-schema.js.map","import { Float32, Float64, Int16, Int32, Int8, Uint16, Uint32, Uint8 } from '../schema/schema';\nexport function getArrowTypeFromTypedArray(array) {\n  switch (array.constructor) {\n    case Int8Array:\n      return new Int8();\n\n    case Uint8Array:\n      return new Uint8();\n\n    case Int16Array:\n      return new Int16();\n\n    case Uint16Array:\n      return new Uint16();\n\n    case Int32Array:\n      return new Int32();\n\n    case Uint32Array:\n      return new Uint32();\n\n    case Float32Array:\n      return new Float32();\n\n    case Float64Array:\n      return new Float64();\n\n    default:\n      throw new Error('array type not supported');\n  }\n}\n//# sourceMappingURL=arrow-like-type-utils.js.map","import { deduceMeshField } from '@loaders.gl/schema';\nimport { Schema } from '@loaders.gl/schema';\nexport function getDracoSchema(attributes, loaderData, indices) {\n  const metadataMap = makeMetadata(loaderData.metadata);\n  const fields = [];\n  const namedLoaderDataAttributes = transformAttributesLoaderData(loaderData.attributes);\n\n  for (const attributeName in attributes) {\n    const attribute = attributes[attributeName];\n    const field = getArrowFieldFromAttribute(attributeName, attribute, namedLoaderDataAttributes[attributeName]);\n    fields.push(field);\n  }\n\n  if (indices) {\n    const indicesField = getArrowFieldFromAttribute('indices', indices);\n    fields.push(indicesField);\n  }\n\n  return new Schema(fields, metadataMap);\n}\n\nfunction transformAttributesLoaderData(loaderData) {\n  const result = {};\n\n  for (const key in loaderData) {\n    const dracoAttribute = loaderData[key];\n    result[dracoAttribute.name || 'undefined'] = dracoAttribute;\n  }\n\n  return result;\n}\n\nfunction getArrowFieldFromAttribute(attributeName, attribute, loaderData) {\n  const metadataMap = loaderData ? makeMetadata(loaderData.metadata) : undefined;\n  const field = deduceMeshField(attributeName, attribute, metadataMap);\n  return field;\n}\n\nfunction makeMetadata(metadata) {\n  const metadataMap = new Map();\n\n  for (const key in metadata) {\n    metadataMap.set(\"\".concat(key, \".string\"), JSON.stringify(metadata[key]));\n  }\n\n  return metadataMap;\n}\n//# sourceMappingURL=get-draco-schema.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { getMeshBoundingBox } from '@loaders.gl/schema';\nimport { getDracoSchema } from './utils/get-draco-schema';\nconst GEOMETRY_TYPE = {\n  TRIANGULAR_MESH: 0,\n  POINT_CLOUD: 1\n};\nconst DRACO_TO_GLTF_ATTRIBUTE_NAME_MAP = {\n  POSITION: 'POSITION',\n  NORMAL: 'NORMAL',\n  COLOR: 'COLOR_0',\n  TEX_COORD: 'TEXCOORD_0'\n};\nconst DRACO_DATA_TYPE_TO_TYPED_ARRAY_MAP = {\n  1: Int8Array,\n  2: Uint8Array,\n  3: Int16Array,\n  4: Uint16Array,\n  5: Int32Array,\n  6: Uint32Array,\n  9: Float32Array\n};\nconst INDEX_ITEM_SIZE = 4;\nexport default class DracoParser {\n  constructor(draco) {\n    _defineProperty(this, \"draco\", void 0);\n\n    _defineProperty(this, \"decoder\", void 0);\n\n    _defineProperty(this, \"metadataQuerier\", void 0);\n\n    this.draco = draco;\n    this.decoder = new this.draco.Decoder();\n    this.metadataQuerier = new this.draco.MetadataQuerier();\n  }\n\n  destroy() {\n    this.draco.destroy(this.decoder);\n    this.draco.destroy(this.metadataQuerier);\n  }\n\n  parseSync(arrayBuffer, options = {}) {\n    const buffer = new this.draco.DecoderBuffer();\n    buffer.Init(new Int8Array(arrayBuffer), arrayBuffer.byteLength);\n\n    this._disableAttributeTransforms(options);\n\n    const geometry_type = this.decoder.GetEncodedGeometryType(buffer);\n    const dracoGeometry = geometry_type === this.draco.TRIANGULAR_MESH ? new this.draco.Mesh() : new this.draco.PointCloud();\n\n    try {\n      let dracoStatus;\n\n      switch (geometry_type) {\n        case this.draco.TRIANGULAR_MESH:\n          dracoStatus = this.decoder.DecodeBufferToMesh(buffer, dracoGeometry);\n          break;\n\n        case this.draco.POINT_CLOUD:\n          dracoStatus = this.decoder.DecodeBufferToPointCloud(buffer, dracoGeometry);\n          break;\n\n        default:\n          throw new Error('DRACO: Unknown geometry type.');\n      }\n\n      if (!dracoStatus.ok() || !dracoGeometry.ptr) {\n        const message = \"DRACO decompression failed: \".concat(dracoStatus.error_msg());\n        throw new Error(message);\n      }\n\n      const loaderData = this._getDracoLoaderData(dracoGeometry, geometry_type, options);\n\n      const geometry = this._getMeshData(dracoGeometry, loaderData, options);\n\n      const boundingBox = getMeshBoundingBox(geometry.attributes);\n      const schema = getDracoSchema(geometry.attributes, loaderData, geometry.indices);\n      const data = {\n        loader: 'draco',\n        loaderData,\n        header: {\n          vertexCount: dracoGeometry.num_points(),\n          boundingBox\n        },\n        ...geometry,\n        schema\n      };\n      return data;\n    } finally {\n      this.draco.destroy(buffer);\n\n      if (dracoGeometry) {\n        this.draco.destroy(dracoGeometry);\n      }\n    }\n  }\n\n  _getDracoLoaderData(dracoGeometry, geometry_type, options) {\n    const metadata = this._getTopLevelMetadata(dracoGeometry);\n\n    const attributes = this._getDracoAttributes(dracoGeometry, options);\n\n    return {\n      geometry_type,\n      num_attributes: dracoGeometry.num_attributes(),\n      num_points: dracoGeometry.num_points(),\n      num_faces: dracoGeometry instanceof this.draco.Mesh ? dracoGeometry.num_faces() : 0,\n      metadata,\n      attributes\n    };\n  }\n\n  _getDracoAttributes(dracoGeometry, options) {\n    const dracoAttributes = {};\n\n    for (let attributeId = 0; attributeId < dracoGeometry.num_attributes(); attributeId++) {\n      const dracoAttribute = this.decoder.GetAttribute(dracoGeometry, attributeId);\n\n      const metadata = this._getAttributeMetadata(dracoGeometry, attributeId);\n\n      dracoAttributes[dracoAttribute.unique_id()] = {\n        unique_id: dracoAttribute.unique_id(),\n        attribute_type: dracoAttribute.attribute_type(),\n        data_type: dracoAttribute.data_type(),\n        num_components: dracoAttribute.num_components(),\n        byte_offset: dracoAttribute.byte_offset(),\n        byte_stride: dracoAttribute.byte_stride(),\n        normalized: dracoAttribute.normalized(),\n        attribute_index: attributeId,\n        metadata\n      };\n\n      const quantization = this._getQuantizationTransform(dracoAttribute, options);\n\n      if (quantization) {\n        dracoAttributes[dracoAttribute.unique_id()].quantization_transform = quantization;\n      }\n\n      const octahedron = this._getOctahedronTransform(dracoAttribute, options);\n\n      if (octahedron) {\n        dracoAttributes[dracoAttribute.unique_id()].octahedron_transform = octahedron;\n      }\n    }\n\n    return dracoAttributes;\n  }\n\n  _getMeshData(dracoGeometry, loaderData, options) {\n    const attributes = this._getMeshAttributes(loaderData, dracoGeometry, options);\n\n    const positionAttribute = attributes.POSITION;\n\n    if (!positionAttribute) {\n      throw new Error('DRACO: No position attribute found.');\n    }\n\n    if (dracoGeometry instanceof this.draco.Mesh) {\n      switch (options.topology) {\n        case 'triangle-strip':\n          return {\n            topology: 'triangle-strip',\n            mode: 4,\n            attributes,\n            indices: {\n              value: this._getTriangleStripIndices(dracoGeometry),\n              size: 1\n            }\n          };\n\n        case 'triangle-list':\n        default:\n          return {\n            topology: 'triangle-list',\n            mode: 5,\n            attributes,\n            indices: {\n              value: this._getTriangleListIndices(dracoGeometry),\n              size: 1\n            }\n          };\n      }\n    }\n\n    return {\n      topology: 'point-list',\n      mode: 0,\n      attributes\n    };\n  }\n\n  _getMeshAttributes(loaderData, dracoGeometry, options) {\n    const attributes = {};\n\n    for (const loaderAttribute of Object.values(loaderData.attributes)) {\n      const attributeName = this._deduceAttributeName(loaderAttribute, options);\n\n      loaderAttribute.name = attributeName;\n\n      const {\n        value,\n        size\n      } = this._getAttributeValues(dracoGeometry, loaderAttribute);\n\n      attributes[attributeName] = {\n        value,\n        size,\n        byteOffset: loaderAttribute.byte_offset,\n        byteStride: loaderAttribute.byte_stride,\n        normalized: loaderAttribute.normalized\n      };\n    }\n\n    return attributes;\n  }\n\n  _getTriangleListIndices(dracoGeometry) {\n    const numFaces = dracoGeometry.num_faces();\n    const numIndices = numFaces * 3;\n    const byteLength = numIndices * INDEX_ITEM_SIZE;\n\n    const ptr = this.draco._malloc(byteLength);\n\n    try {\n      this.decoder.GetTrianglesUInt32Array(dracoGeometry, byteLength, ptr);\n      return new Uint32Array(this.draco.HEAPF32.buffer, ptr, numIndices).slice();\n    } finally {\n      this.draco._free(ptr);\n    }\n  }\n\n  _getTriangleStripIndices(dracoGeometry) {\n    const dracoArray = new this.draco.DracoInt32Array();\n\n    try {\n      this.decoder.GetTriangleStripsFromMesh(dracoGeometry, dracoArray);\n      return getUint32Array(dracoArray);\n    } finally {\n      this.draco.destroy(dracoArray);\n    }\n  }\n\n  _getAttributeValues(dracoGeometry, attribute) {\n    const TypedArrayCtor = DRACO_DATA_TYPE_TO_TYPED_ARRAY_MAP[attribute.data_type];\n    const numComponents = attribute.num_components;\n    const numPoints = dracoGeometry.num_points();\n    const numValues = numPoints * numComponents;\n    const byteLength = numValues * TypedArrayCtor.BYTES_PER_ELEMENT;\n    const dataType = getDracoDataType(this.draco, TypedArrayCtor);\n    let value;\n\n    const ptr = this.draco._malloc(byteLength);\n\n    try {\n      const dracoAttribute = this.decoder.GetAttribute(dracoGeometry, attribute.attribute_index);\n      this.decoder.GetAttributeDataArrayForAllPoints(dracoGeometry, dracoAttribute, dataType, byteLength, ptr);\n      value = new TypedArrayCtor(this.draco.HEAPF32.buffer, ptr, numValues).slice();\n    } finally {\n      this.draco._free(ptr);\n    }\n\n    return {\n      value,\n      size: numComponents\n    };\n  }\n\n  _deduceAttributeName(attribute, options) {\n    const uniqueId = attribute.unique_id;\n\n    for (const [attributeName, attributeUniqueId] of Object.entries(options.extraAttributes || {})) {\n      if (attributeUniqueId === uniqueId) {\n        return attributeName;\n      }\n    }\n\n    const thisAttributeType = attribute.attribute_type;\n\n    for (const dracoAttributeConstant in DRACO_TO_GLTF_ATTRIBUTE_NAME_MAP) {\n      const attributeType = this.draco[dracoAttributeConstant];\n\n      if (attributeType === thisAttributeType) {\n        return DRACO_TO_GLTF_ATTRIBUTE_NAME_MAP[dracoAttributeConstant];\n      }\n    }\n\n    const entryName = options.attributeNameEntry || 'name';\n\n    if (attribute.metadata[entryName]) {\n      return attribute.metadata[entryName].string;\n    }\n\n    return \"CUSTOM_ATTRIBUTE_\".concat(uniqueId);\n  }\n\n  _getTopLevelMetadata(dracoGeometry) {\n    const dracoMetadata = this.decoder.GetMetadata(dracoGeometry);\n    return this._getDracoMetadata(dracoMetadata);\n  }\n\n  _getAttributeMetadata(dracoGeometry, attributeId) {\n    const dracoMetadata = this.decoder.GetAttributeMetadata(dracoGeometry, attributeId);\n    return this._getDracoMetadata(dracoMetadata);\n  }\n\n  _getDracoMetadata(dracoMetadata) {\n    if (!dracoMetadata || !dracoMetadata.ptr) {\n      return {};\n    }\n\n    const result = {};\n    const numEntries = this.metadataQuerier.NumEntries(dracoMetadata);\n\n    for (let entryIndex = 0; entryIndex < numEntries; entryIndex++) {\n      const entryName = this.metadataQuerier.GetEntryName(dracoMetadata, entryIndex);\n      result[entryName] = this._getDracoMetadataField(dracoMetadata, entryName);\n    }\n\n    return result;\n  }\n\n  _getDracoMetadataField(dracoMetadata, entryName) {\n    const dracoArray = new this.draco.DracoInt32Array();\n\n    try {\n      this.metadataQuerier.GetIntEntryArray(dracoMetadata, entryName, dracoArray);\n      const intArray = getInt32Array(dracoArray);\n      return {\n        int: this.metadataQuerier.GetIntEntry(dracoMetadata, entryName),\n        string: this.metadataQuerier.GetStringEntry(dracoMetadata, entryName),\n        double: this.metadataQuerier.GetDoubleEntry(dracoMetadata, entryName),\n        intArray\n      };\n    } finally {\n      this.draco.destroy(dracoArray);\n    }\n  }\n\n  _disableAttributeTransforms(options) {\n    const {\n      quantizedAttributes = [],\n      octahedronAttributes = []\n    } = options;\n    const skipAttributes = [...quantizedAttributes, ...octahedronAttributes];\n\n    for (const dracoAttributeName of skipAttributes) {\n      this.decoder.SkipAttributeTransform(this.draco[dracoAttributeName]);\n    }\n  }\n\n  _getQuantizationTransform(dracoAttribute, options) {\n    const {\n      quantizedAttributes = []\n    } = options;\n    const attribute_type = dracoAttribute.attribute_type();\n    const skip = quantizedAttributes.map(type => this.decoder[type]).includes(attribute_type);\n\n    if (skip) {\n      const transform = new this.draco.AttributeQuantizationTransform();\n\n      try {\n        if (transform.InitFromAttribute(dracoAttribute)) {\n          return {\n            quantization_bits: transform.quantization_bits(),\n            range: transform.range(),\n            min_values: new Float32Array([1, 2, 3]).map(i => transform.min_value(i))\n          };\n        }\n      } finally {\n        this.draco.destroy(transform);\n      }\n    }\n\n    return null;\n  }\n\n  _getOctahedronTransform(dracoAttribute, options) {\n    const {\n      octahedronAttributes = []\n    } = options;\n    const attribute_type = dracoAttribute.attribute_type();\n    const octahedron = octahedronAttributes.map(type => this.decoder[type]).includes(attribute_type);\n\n    if (octahedron) {\n      const transform = new this.draco.AttributeQuantizationTransform();\n\n      try {\n        if (transform.InitFromAttribute(dracoAttribute)) {\n          return {\n            quantization_bits: transform.quantization_bits()\n          };\n        }\n      } finally {\n        this.draco.destroy(transform);\n      }\n    }\n\n    return null;\n  }\n\n}\n\nfunction getDracoDataType(draco, attributeType) {\n  switch (attributeType) {\n    case Float32Array:\n      return draco.DT_FLOAT32;\n\n    case Int8Array:\n      return draco.DT_INT8;\n\n    case Int16Array:\n      return draco.DT_INT16;\n\n    case Int32Array:\n      return draco.DT_INT32;\n\n    case Uint8Array:\n      return draco.DT_UINT8;\n\n    case Uint16Array:\n      return draco.DT_UINT16;\n\n    case Uint32Array:\n      return draco.DT_UINT32;\n\n    default:\n      return draco.DT_INVALID;\n  }\n}\n\nfunction getInt32Array(dracoArray) {\n  const numValues = dracoArray.size();\n  const intArray = new Int32Array(numValues);\n\n  for (let i = 0; i < numValues; i++) {\n    intArray[i] = dracoArray.GetValue(i);\n  }\n\n  return intArray;\n}\n\nfunction getUint32Array(dracoArray) {\n  const numValues = dracoArray.size();\n  const intArray = new Int32Array(numValues);\n\n  for (let i = 0; i < numValues; i++) {\n    intArray[i] = dracoArray.GetValue(i);\n  }\n\n  return intArray;\n}\n//# sourceMappingURL=draco-parser.js.map","export function getMeshSize(attributes) {\n  let size = 0;\n\n  for (const attributeName in attributes) {\n    const attribute = attributes[attributeName];\n\n    if (ArrayBuffer.isView(attribute)) {\n      size += attribute.byteLength * attribute.BYTES_PER_ELEMENT;\n    }\n  }\n\n  return size;\n}\nexport function getMeshBoundingBox(attributes) {\n  let minX = Infinity;\n  let minY = Infinity;\n  let minZ = Infinity;\n  let maxX = -Infinity;\n  let maxY = -Infinity;\n  let maxZ = -Infinity;\n  const positions = attributes.POSITION ? attributes.POSITION.value : [];\n  const len = positions && positions.length;\n\n  for (let i = 0; i < len; i += 3) {\n    const x = positions[i];\n    const y = positions[i + 1];\n    const z = positions[i + 2];\n    minX = x < minX ? x : minX;\n    minY = y < minY ? y : minY;\n    minZ = z < minZ ? z : minZ;\n    maxX = x > maxX ? x : maxX;\n    maxY = y > maxY ? y : maxY;\n    maxZ = z > maxZ ? z : maxZ;\n  }\n\n  return [[minX, minY, minZ], [maxX, maxY, maxZ]];\n}\n//# sourceMappingURL=mesh-utils.js.map","import { loadLibrary } from '@loaders.gl/worker-utils';\nconst DRACO_VERSION = '1.4.1';\nconst DRACO_JS_DECODER_URL = \"https://www.gstatic.com/draco/versioned/decoders/\".concat(DRACO_VERSION, \"/draco_decoder.js\");\nconst DRACO_WASM_WRAPPER_URL = \"https://www.gstatic.com/draco/versioned/decoders/\".concat(DRACO_VERSION, \"/draco_wasm_wrapper.js\");\nconst DRACO_WASM_DECODER_URL = \"https://www.gstatic.com/draco/versioned/decoders/\".concat(DRACO_VERSION, \"/draco_decoder.wasm\");\nconst DRACO_ENCODER_URL = \"https://raw.githubusercontent.com/google/draco/\".concat(DRACO_VERSION, \"/javascript/draco_encoder.js\");\nlet loadDecoderPromise;\nlet loadEncoderPromise;\nexport async function loadDracoDecoderModule(options) {\n  const modules = options.modules || {};\n\n  if (modules.draco3d) {\n    loadDecoderPromise = loadDecoderPromise || modules.draco3d.createDecoderModule({}).then(draco => {\n      return {\n        draco\n      };\n    });\n  } else {\n    loadDecoderPromise = loadDecoderPromise || loadDracoDecoder(options);\n  }\n\n  return await loadDecoderPromise;\n}\nexport async function loadDracoEncoderModule(options) {\n  const modules = options.modules || {};\n\n  if (modules.draco3d) {\n    loadEncoderPromise = loadEncoderPromise || modules.draco3d.createEncoderModule({}).then(draco => {\n      return {\n        draco\n      };\n    });\n  } else {\n    loadEncoderPromise = loadEncoderPromise || loadDracoEncoder(options);\n  }\n\n  return await loadEncoderPromise;\n}\n\nasync function loadDracoDecoder(options) {\n  let DracoDecoderModule;\n  let wasmBinary;\n\n  switch (options.draco && options.draco.decoderType) {\n    case 'js':\n      DracoDecoderModule = await loadLibrary(DRACO_JS_DECODER_URL, 'draco', options);\n      break;\n\n    case 'wasm':\n    default:\n      [DracoDecoderModule, wasmBinary] = await Promise.all([await loadLibrary(DRACO_WASM_WRAPPER_URL, 'draco', options), await loadLibrary(DRACO_WASM_DECODER_URL, 'draco', options)]);\n  }\n\n  DracoDecoderModule = DracoDecoderModule || globalThis.DracoDecoderModule;\n  return await initializeDracoDecoder(DracoDecoderModule, wasmBinary);\n}\n\nfunction initializeDracoDecoder(DracoDecoderModule, wasmBinary) {\n  const options = {};\n\n  if (wasmBinary) {\n    options.wasmBinary = wasmBinary;\n  }\n\n  return new Promise(resolve => {\n    DracoDecoderModule({ ...options,\n      onModuleLoaded: draco => resolve({\n        draco\n      })\n    });\n  });\n}\n\nasync function loadDracoEncoder(options) {\n  let DracoEncoderModule = await loadLibrary(DRACO_ENCODER_URL, 'draco', options);\n  DracoEncoderModule = DracoEncoderModule || globalThis.DracoEncoderModule;\n  return new Promise(resolve => {\n    DracoEncoderModule({\n      onModuleLoaded: draco => resolve({\n        draco\n      })\n    });\n  });\n}\n//# sourceMappingURL=draco-module-loader.js.map","import { DracoLoader as DracoWorkerLoader } from './draco-loader';\nimport DracoParser from './lib/draco-parser';\nimport { loadDracoDecoderModule } from './lib/draco-module-loader';\nimport { VERSION } from './lib/utils/version';\nimport { isBrowser } from '@loaders.gl/worker-utils';\nexport { DracoWriter } from './draco-writer';\nexport const DracoWriterWorker = {\n  id: isBrowser ? 'draco-writer' : 'draco-writer-nodejs',\n  name: 'Draco compressed geometry writer',\n  module: 'draco',\n  version: VERSION,\n  worker: true,\n  options: {\n    draco: {},\n    source: null\n  }\n};\nexport { DracoWorkerLoader };\nexport const DracoLoader = { ...DracoWorkerLoader,\n  parse\n};\n\nasync function parse(arrayBuffer, options) {\n  const {\n    draco\n  } = await loadDracoDecoderModule(options);\n  const dracoParser = new DracoParser(draco);\n\n  try {\n    return dracoParser.parseSync(arrayBuffer, options === null || options === void 0 ? void 0 : options.draco);\n  } finally {\n    dracoParser.destroy();\n  }\n}\n\nexport const _TypecheckDracoLoader = DracoLoader;\n//# sourceMappingURL=index.js.map","let arrayBuffer = null;\nexport function getScratchArrayBuffer(byteLength) {\n  if (!arrayBuffer || arrayBuffer.byteLength < byteLength) {\n    arrayBuffer = new ArrayBuffer(byteLength);\n  }\n\n  return arrayBuffer;\n}\nexport function getScratchArray(Type, length) {\n  const scratchArrayBuffer = getScratchArrayBuffer(Type.BYTES_PER_ELEMENT * length);\n  return new Type(scratchArrayBuffer, 0, length);\n}\nexport function fillArray(_ref) {\n  let {\n    target,\n    source,\n    start = 0,\n    count = 1\n  } = _ref;\n  const length = source.length;\n  const total = count * length;\n  let copied = 0;\n\n  for (let i = start; copied < length; copied++) {\n    target[i++] = source[copied];\n  }\n\n  while (copied < total) {\n    if (copied < total - copied) {\n      target.copyWithin(start + copied, start, start + copied);\n      copied *= 2;\n    } else {\n      target.copyWithin(start + copied, start, start + total - copied);\n      copied = total;\n    }\n  }\n\n  return target;\n}\n//# sourceMappingURL=array-utils-flat.js.map","import Resource from './resource';\nimport Buffer from './buffer';\nimport { isWebGL2 } from '@luma.gl/gltools';\nimport { getScratchArray, fillArray } from '../utils/array-utils-flat';\nimport { assert } from '../utils/assert';\nimport { getBrowser } from '@probe.gl/env';\nconst ERR_ELEMENTS = 'elements must be GL.ELEMENT_ARRAY_BUFFER';\nexport default class VertexArrayObject extends Resource {\n  get [Symbol.toStringTag]() {\n    return 'VertexArrayObject';\n  }\n\n  static isSupported(gl) {\n    let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n\n    if (options.constantAttributeZero) {\n      return isWebGL2(gl) || getBrowser() === 'Chrome';\n    }\n\n    return true;\n  }\n\n  static getDefaultArray(gl) {\n    gl.luma = gl.luma || {};\n\n    if (!gl.luma.defaultVertexArray) {\n      gl.luma.defaultVertexArray = new VertexArrayObject(gl, {\n        handle: null,\n        isDefaultArray: true\n      });\n    }\n\n    return gl.luma.defaultVertexArray;\n  }\n\n  static getMaxAttributes(gl) {\n    VertexArrayObject.MAX_ATTRIBUTES = VertexArrayObject.MAX_ATTRIBUTES || gl.getParameter(34921);\n    return VertexArrayObject.MAX_ATTRIBUTES;\n  }\n\n  static setConstant(gl, location, array) {\n    switch (array.constructor) {\n      case Float32Array:\n        VertexArrayObject._setConstantFloatArray(gl, location, array);\n\n        break;\n\n      case Int32Array:\n        VertexArrayObject._setConstantIntArray(gl, location, array);\n\n        break;\n\n      case Uint32Array:\n        VertexArrayObject._setConstantUintArray(gl, location, array);\n\n        break;\n\n      default:\n        assert(false);\n    }\n  }\n\n  constructor(gl) {\n    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    const id = opts.id || opts.program && opts.program.id;\n    super(gl, Object.assign({}, opts, {\n      id\n    }));\n    this.buffer = null;\n    this.bufferValue = null;\n    this.isDefaultArray = opts.isDefaultArray || false;\n    this.gl2 = gl;\n    this.initialize(opts);\n    Object.seal(this);\n  }\n\n  delete() {\n    super.delete();\n\n    if (this.buffer) {\n      this.buffer.delete();\n    }\n\n    return this;\n  }\n\n  get MAX_ATTRIBUTES() {\n    return VertexArrayObject.getMaxAttributes(this.gl);\n  }\n\n  initialize() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    return this.setProps(props);\n  }\n\n  setProps(props) {\n    return this;\n  }\n\n  setElementBuffer() {\n    let elementBuffer = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;\n    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    assert(!elementBuffer || elementBuffer.target === 34963, ERR_ELEMENTS);\n    this.bind(() => {\n      this.gl.bindBuffer(34963, elementBuffer ? elementBuffer.handle : null);\n    });\n    return this;\n  }\n\n  setBuffer(location, buffer, accessor) {\n    if (buffer.target === 34963) {\n      return this.setElementBuffer(buffer, accessor);\n    }\n\n    const {\n      size,\n      type,\n      stride,\n      offset,\n      normalized,\n      integer,\n      divisor\n    } = accessor;\n    const {\n      gl,\n      gl2\n    } = this;\n    location = Number(location);\n    this.bind(() => {\n      gl.bindBuffer(34962, buffer.handle);\n\n      if (integer) {\n        assert(isWebGL2(gl));\n        gl2.vertexAttribIPointer(location, size, type, stride, offset);\n      } else {\n        gl.vertexAttribPointer(location, size, type, normalized, stride, offset);\n      }\n\n      gl.enableVertexAttribArray(location);\n      gl2.vertexAttribDivisor(location, divisor || 0);\n    });\n    return this;\n  }\n\n  enable(location) {\n    let enable = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;\n    const disablingAttributeZero = !enable && location === 0 && !VertexArrayObject.isSupported(this.gl, {\n      constantAttributeZero: true\n    });\n\n    if (!disablingAttributeZero) {\n      location = Number(location);\n      this.bind(() => enable ? this.gl.enableVertexAttribArray(location) : this.gl.disableVertexAttribArray(location));\n    }\n\n    return this;\n  }\n\n  getConstantBuffer(elementCount, value) {\n    const constantValue = this._normalizeConstantArrayValue(value);\n\n    const byteLength = constantValue.byteLength * elementCount;\n    const length = constantValue.length * elementCount;\n    let updateNeeded = !this.buffer;\n    this.buffer = this.buffer || new Buffer(this.gl, byteLength);\n    updateNeeded = updateNeeded || this.buffer.reallocate(byteLength);\n    updateNeeded = updateNeeded || !this._compareConstantArrayValues(constantValue, this.bufferValue);\n\n    if (updateNeeded) {\n      const typedArray = getScratchArray(value.constructor, length);\n      fillArray({\n        target: typedArray,\n        source: constantValue,\n        start: 0,\n        count: length\n      });\n      this.buffer.subData(typedArray);\n      this.bufferValue = value;\n    }\n\n    return this.buffer;\n  }\n\n  _normalizeConstantArrayValue(arrayValue) {\n    if (Array.isArray(arrayValue)) {\n      return new Float32Array(arrayValue);\n    }\n\n    return arrayValue;\n  }\n\n  _compareConstantArrayValues(v1, v2) {\n    if (!v1 || !v2 || v1.length !== v2.length || v1.constructor !== v2.constructor) {\n      return false;\n    }\n\n    for (let i = 0; i < v1.length; ++i) {\n      if (v1[i] !== v2[i]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  static _setConstantFloatArray(gl, location, array) {\n    switch (array.length) {\n      case 1:\n        gl.vertexAttrib1fv(location, array);\n        break;\n\n      case 2:\n        gl.vertexAttrib2fv(location, array);\n        break;\n\n      case 3:\n        gl.vertexAttrib3fv(location, array);\n        break;\n\n      case 4:\n        gl.vertexAttrib4fv(location, array);\n        break;\n\n      default:\n        assert(false);\n    }\n  }\n\n  static _setConstantIntArray(gl, location, array) {\n    assert(isWebGL2(gl));\n\n    switch (array.length) {\n      case 1:\n        gl.vertexAttribI1iv(location, array);\n        break;\n\n      case 2:\n        gl.vertexAttribI2iv(location, array);\n        break;\n\n      case 3:\n        gl.vertexAttribI3iv(location, array);\n        break;\n\n      case 4:\n        gl.vertexAttribI4iv(location, array);\n        break;\n\n      default:\n        assert(false);\n    }\n  }\n\n  static _setConstantUintArray(gl, location, array) {\n    assert(isWebGL2(gl));\n\n    switch (array.length) {\n      case 1:\n        gl.vertexAttribI1uiv(location, array);\n        break;\n\n      case 2:\n        gl.vertexAttribI2uiv(location, array);\n        break;\n\n      case 3:\n        gl.vertexAttribI3uiv(location, array);\n        break;\n\n      case 4:\n        gl.vertexAttribI4uiv(location, array);\n        break;\n\n      default:\n        assert(false);\n    }\n  }\n\n  _createHandle() {\n    const gl2 = this.gl;\n    return gl2.createVertexArray();\n  }\n\n  _deleteHandle(handle) {\n    this.gl2.deleteVertexArray(handle);\n    return [this.elements];\n  }\n\n  _bindHandle(handle) {\n    this.gl2.bindVertexArray(handle);\n  }\n\n  _getParameter(pname, _ref) {\n    let {\n      location\n    } = _ref;\n    assert(Number.isFinite(location));\n    return this.bind(() => {\n      switch (pname) {\n        case 34373:\n          return this.gl.getVertexAttribOffset(location, pname);\n\n        default:\n          return this.gl.getVertexAttrib(location, pname);\n      }\n    });\n  }\n\n}\n//# sourceMappingURL=vertex-array-object.js.map","import { log } from '@luma.gl/gltools';\nimport Accessor from './accessor';\nimport Buffer from './buffer';\nimport VertexArrayObject from './vertex-array-object';\nimport { assert } from '../utils/assert';\nimport { stubRemovedMethods } from '../utils/stub-methods';\nconst ERR_ATTRIBUTE_TYPE = 'VertexArray: attributes must be Buffers or constants (i.e. typed array)';\nconst MULTI_LOCATION_ATTRIBUTE_REGEXP = /^(.+)__LOCATION_([0-9]+)$/;\nconst DEPRECATIONS_V6 = ['setBuffers', 'setGeneric', 'clearBindings', 'setLocations', 'setGenericValues', 'setDivisor', 'enable', 'disable'];\nexport default class VertexArray {\n  constructor(gl) {\n    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    const id = opts.id || opts.program && opts.program.id;\n    this.id = id;\n    this.gl = gl;\n    this.configuration = null;\n    this.elements = null;\n    this.elementsAccessor = null;\n    this.values = null;\n    this.accessors = null;\n    this.unused = null;\n    this.drawParams = null;\n    this.buffer = null;\n    this.attributes = {};\n    this.vertexArrayObject = new VertexArrayObject(gl);\n    stubRemovedMethods(this, 'VertexArray', 'v6.0', DEPRECATIONS_V6);\n    this.initialize(opts);\n    Object.seal(this);\n  }\n\n  delete() {\n    if (this.buffer) {\n      this.buffer.delete();\n    }\n\n    this.vertexArrayObject.delete();\n  }\n\n  initialize() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    this.reset();\n    this.configuration = null;\n    this.bindOnUse = false;\n    return this.setProps(props);\n  }\n\n  reset() {\n    this.elements = null;\n    this.elementsAccessor = null;\n    const {\n      MAX_ATTRIBUTES\n    } = this.vertexArrayObject;\n    this.values = new Array(MAX_ATTRIBUTES).fill(null);\n    this.accessors = new Array(MAX_ATTRIBUTES).fill(null);\n    this.unused = {};\n    this.drawParams = null;\n    return this;\n  }\n\n  setProps(props) {\n    if ('program' in props) {\n      this.configuration = props.program && props.program.configuration;\n    }\n\n    if ('configuration' in props) {\n      this.configuration = props.configuration;\n    }\n\n    if ('attributes' in props) {\n      this.setAttributes(props.attributes);\n    }\n\n    if ('elements' in props) {\n      this.setElementBuffer(props.elements);\n    }\n\n    if ('bindOnUse' in props) {\n      props = props.bindOnUse;\n    }\n\n    return this;\n  }\n\n  clearDrawParams() {\n    this.drawParams = null;\n  }\n\n  getDrawParams() {\n    this.drawParams = this.drawParams || this._updateDrawParams();\n    return this.drawParams;\n  }\n\n  setAttributes(attributes) {\n    Object.assign(this.attributes, attributes);\n    this.vertexArrayObject.bind(() => {\n      for (const locationOrName in attributes) {\n        const value = attributes[locationOrName];\n\n        this._setAttribute(locationOrName, value);\n      }\n\n      this.gl.bindBuffer(34962, null);\n    });\n    return this;\n  }\n\n  setElementBuffer() {\n    let elementBuffer = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;\n    let accessor = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    this.elements = elementBuffer;\n    this.elementsAccessor = accessor;\n    this.clearDrawParams();\n    this.vertexArrayObject.setElementBuffer(elementBuffer, accessor);\n    return this;\n  }\n\n  setBuffer(locationOrName, buffer) {\n    let appAccessor = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};\n\n    if (buffer.target === 34963) {\n      return this.setElementBuffer(buffer, appAccessor);\n    }\n\n    const {\n      location,\n      accessor\n    } = this._resolveLocationAndAccessor(locationOrName, buffer, buffer.accessor, appAccessor);\n\n    if (location >= 0) {\n      this.values[location] = buffer;\n      this.accessors[location] = accessor;\n      this.clearDrawParams();\n      this.vertexArrayObject.setBuffer(location, buffer, accessor);\n    }\n\n    return this;\n  }\n\n  setConstant(locationOrName, arrayValue) {\n    let appAccessor = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};\n\n    const {\n      location,\n      accessor\n    } = this._resolveLocationAndAccessor(locationOrName, arrayValue, Object.assign({\n      size: arrayValue.length\n    }, appAccessor));\n\n    if (location >= 0) {\n      arrayValue = this.vertexArrayObject._normalizeConstantArrayValue(arrayValue);\n      this.values[location] = arrayValue;\n      this.accessors[location] = accessor;\n      this.clearDrawParams();\n      this.vertexArrayObject.enable(location, false);\n    }\n\n    return this;\n  }\n\n  unbindBuffers() {\n    this.vertexArrayObject.bind(() => {\n      if (this.elements) {\n        this.vertexArrayObject.setElementBuffer(null);\n      }\n\n      this.buffer = this.buffer || new Buffer(this.gl, {\n        accessor: {\n          size: 4\n        }\n      });\n\n      for (let location = 0; location < this.vertexArrayObject.MAX_ATTRIBUTES; location++) {\n        if (this.values[location] instanceof Buffer) {\n          this.gl.disableVertexAttribArray(location);\n          this.gl.bindBuffer(34962, this.buffer.handle);\n          this.gl.vertexAttribPointer(location, 1, 5126, false, 0, 0);\n        }\n      }\n    });\n    return this;\n  }\n\n  bindBuffers() {\n    this.vertexArrayObject.bind(() => {\n      if (this.elements) {\n        this.setElementBuffer(this.elements);\n      }\n\n      for (let location = 0; location < this.vertexArrayObject.MAX_ATTRIBUTES; location++) {\n        const buffer = this.values[location];\n\n        if (buffer instanceof Buffer) {\n          this.setBuffer(location, buffer);\n        }\n      }\n    });\n    return this;\n  }\n\n  bindForDraw(vertexCount, instanceCount, func) {\n    let value;\n    this.vertexArrayObject.bind(() => {\n      this._setConstantAttributes(vertexCount, instanceCount);\n\n      value = func();\n    });\n    return value;\n  }\n\n  _resolveLocationAndAccessor(locationOrName, value, valueAccessor, appAccessor) {\n    const INVALID_RESULT = {\n      location: -1,\n      accessor: null\n    };\n\n    const {\n      location,\n      name\n    } = this._getAttributeIndex(locationOrName);\n\n    if (!Number.isFinite(location) || location < 0) {\n      this.unused[locationOrName] = value;\n      log.once(3, () => \"unused value \".concat(locationOrName, \" in \").concat(this.id))();\n      return INVALID_RESULT;\n    }\n\n    const accessInfo = this._getAttributeInfo(name || location);\n\n    if (!accessInfo) {\n      return INVALID_RESULT;\n    }\n\n    const currentAccessor = this.accessors[location] || {};\n    const accessor = Accessor.resolve(accessInfo.accessor, currentAccessor, valueAccessor, appAccessor);\n    const {\n      size,\n      type\n    } = accessor;\n    assert(Number.isFinite(size) && Number.isFinite(type));\n    return {\n      location,\n      accessor\n    };\n  }\n\n  _getAttributeInfo(attributeName) {\n    return this.configuration && this.configuration.getAttributeInfo(attributeName);\n  }\n\n  _getAttributeIndex(locationOrName) {\n    const location = Number(locationOrName);\n\n    if (Number.isFinite(location)) {\n      return {\n        location\n      };\n    }\n\n    const multiLocation = MULTI_LOCATION_ATTRIBUTE_REGEXP.exec(locationOrName);\n    const name = multiLocation ? multiLocation[1] : locationOrName;\n    const locationOffset = multiLocation ? Number(multiLocation[2]) : 0;\n\n    if (this.configuration) {\n      return {\n        location: this.configuration.getAttributeLocation(name) + locationOffset,\n        name\n      };\n    }\n\n    return {\n      location: -1\n    };\n  }\n\n  _setAttribute(locationOrName, value) {\n    if (value instanceof Buffer) {\n      this.setBuffer(locationOrName, value);\n    } else if (Array.isArray(value) && value.length && value[0] instanceof Buffer) {\n      const buffer = value[0];\n      const accessor = value[1];\n      this.setBuffer(locationOrName, buffer, accessor);\n    } else if (ArrayBuffer.isView(value) || Array.isArray(value)) {\n      const constant = value;\n      this.setConstant(locationOrName, constant);\n    } else if (value.buffer instanceof Buffer) {\n      const accessor = value;\n      this.setBuffer(locationOrName, accessor.buffer, accessor);\n    } else {\n      throw new Error(ERR_ATTRIBUTE_TYPE);\n    }\n  }\n\n  _setConstantAttributes(vertexCount, instanceCount) {\n    const elementCount = Math.max(vertexCount | 0, instanceCount | 0);\n    let constant = this.values[0];\n\n    if (ArrayBuffer.isView(constant)) {\n      this._setConstantAttributeZero(constant, elementCount);\n    }\n\n    for (let location = 1; location < this.vertexArrayObject.MAX_ATTRIBUTES; location++) {\n      constant = this.values[location];\n\n      if (ArrayBuffer.isView(constant)) {\n        this._setConstantAttribute(location, constant);\n      }\n    }\n  }\n\n  _setConstantAttributeZero(constant, elementCount) {\n    if (VertexArrayObject.isSupported(this.gl, {\n      constantAttributeZero: true\n    })) {\n      this._setConstantAttribute(0, constant);\n\n      return;\n    }\n\n    const buffer = this.vertexArrayObject.getConstantBuffer(elementCount, constant);\n    this.vertexArrayObject.setBuffer(0, buffer, this.accessors[0]);\n  }\n\n  _setConstantAttribute(location, constant) {\n    VertexArrayObject.setConstant(this.gl, location, constant);\n  }\n\n  _updateDrawParams() {\n    const drawParams = {\n      isIndexed: false,\n      isInstanced: false,\n      indexCount: Infinity,\n      vertexCount: Infinity,\n      instanceCount: Infinity\n    };\n\n    for (let location = 0; location < this.vertexArrayObject.MAX_ATTRIBUTES; location++) {\n      this._updateDrawParamsForLocation(drawParams, location);\n    }\n\n    if (this.elements) {\n      drawParams.elementCount = this.elements.getElementCount(this.elements.accessor);\n      drawParams.isIndexed = true;\n      drawParams.indexType = this.elementsAccessor.type || this.elements.accessor.type;\n      drawParams.indexOffset = this.elementsAccessor.offset || 0;\n    }\n\n    if (drawParams.indexCount === Infinity) {\n      drawParams.indexCount = 0;\n    }\n\n    if (drawParams.vertexCount === Infinity) {\n      drawParams.vertexCount = 0;\n    }\n\n    if (drawParams.instanceCount === Infinity) {\n      drawParams.instanceCount = 0;\n    }\n\n    return drawParams;\n  }\n\n  _updateDrawParamsForLocation(drawParams, location) {\n    const value = this.values[location];\n    const accessor = this.accessors[location];\n\n    if (!value) {\n      return;\n    }\n\n    const {\n      divisor\n    } = accessor;\n    const isInstanced = divisor > 0;\n    drawParams.isInstanced = drawParams.isInstanced || isInstanced;\n\n    if (value instanceof Buffer) {\n      const buffer = value;\n\n      if (isInstanced) {\n        const instanceCount = buffer.getVertexCount(accessor);\n        drawParams.instanceCount = Math.min(drawParams.instanceCount, instanceCount);\n      } else {\n        const vertexCount = buffer.getVertexCount(accessor);\n        drawParams.vertexCount = Math.min(drawParams.vertexCount, vertexCount);\n      }\n    }\n  }\n\n  setElements() {\n    let elementBuffer = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;\n    let accessor = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    log.deprecated('setElements', 'setElementBuffer')();\n    return this.setElementBuffer(elementBuffer, accessor);\n  }\n\n}\n//# sourceMappingURL=vertex-array.js.map","function formatArrayValue(v, opts) {\n  const {\n    maxElts = 16,\n    size = 1\n  } = opts;\n  let string = '[';\n\n  for (let i = 0; i < v.length && i < maxElts; ++i) {\n    if (i > 0) {\n      string += \",\".concat(i % size === 0 ? ' ' : '');\n    }\n\n    string += formatValue(v[i], opts);\n  }\n\n  const terminator = v.length > maxElts ? '...' : ']';\n  return \"\".concat(string).concat(terminator);\n}\n\nexport function formatValue(v) {\n  let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n  const EPSILON = 1e-16;\n  const {\n    isInteger = false\n  } = opts;\n\n  if (Array.isArray(v) || ArrayBuffer.isView(v)) {\n    return formatArrayValue(v, opts);\n  }\n\n  if (!Number.isFinite(v)) {\n    return String(v);\n  }\n\n  if (Math.abs(v) < EPSILON) {\n    return isInteger ? '0' : '0.';\n  }\n\n  if (isInteger) {\n    return v.toFixed(0);\n  }\n\n  if (Math.abs(v) > 100 && Math.abs(v) < 10000) {\n    return v.toFixed(0);\n  }\n\n  const string = v.toPrecision(2);\n  const decimal = string.indexOf('.0');\n  return decimal === string.length - 2 ? string.slice(0, -1) : string;\n}\n//# sourceMappingURL=format-value.js.map","import Buffer from '../classes/buffer';\nimport { getKey } from '../webgl-utils/constants-to-keys';\nimport { getCompositeGLType } from '../webgl-utils/attribute-utils';\nimport { formatValue } from '../utils/format-value';\nexport function getDebugTableForVertexArray(_ref) {\n  let {\n    vertexArray,\n    header = 'Attributes'\n  } = _ref;\n\n  if (!vertexArray.configuration) {\n    return {};\n  }\n\n  const table = {};\n\n  if (vertexArray.elements) {\n    table.ELEMENT_ARRAY_BUFFER = getDebugTableRow(vertexArray, vertexArray.elements, null, header);\n  }\n\n  const attributes = vertexArray.values;\n\n  for (const attributeLocation in attributes) {\n    const info = vertexArray._getAttributeInfo(attributeLocation);\n\n    if (info) {\n      let rowHeader = \"\".concat(attributeLocation, \": \").concat(info.name);\n      const accessor = vertexArray.accessors[info.location];\n\n      if (accessor) {\n        rowHeader = \"\".concat(attributeLocation, \": \").concat(getGLSLDeclaration(info.name, accessor));\n      }\n\n      table[rowHeader] = getDebugTableRow(vertexArray, attributes[attributeLocation], accessor, header);\n    }\n  }\n\n  return table;\n}\n\nfunction getDebugTableRow(vertexArray, attribute, accessor, header) {\n  const {\n    gl\n  } = vertexArray;\n\n  if (!attribute) {\n    return {\n      [header]: 'null',\n      'Format ': 'N/A'\n    };\n  }\n\n  let type = 'NOT PROVIDED';\n  let size = 1;\n  let verts = 0;\n  let bytes = 0;\n  let isInteger;\n  let marker;\n  let value;\n\n  if (accessor) {\n    type = accessor.type;\n    size = accessor.size;\n    type = String(type).replace('Array', '');\n    isInteger = type.indexOf('nt') !== -1;\n  }\n\n  if (attribute instanceof Buffer) {\n    const buffer = attribute;\n    const {\n      data,\n      changed\n    } = buffer.getDebugData();\n    marker = changed ? '*' : '';\n    value = data;\n    bytes = buffer.byteLength;\n    verts = bytes / data.BYTES_PER_ELEMENT / size;\n    let format;\n\n    if (accessor) {\n      const instanced = accessor.divisor > 0;\n      format = \"\".concat(instanced ? 'I ' : 'P ', \" \").concat(verts, \" (x\").concat(size, \"=\").concat(bytes, \" bytes \").concat(getKey(gl, type), \")\");\n    } else {\n      isInteger = true;\n      format = \"\".concat(bytes, \" bytes\");\n    }\n\n    return {\n      [header]: \"\".concat(marker).concat(formatValue(value, {\n        size,\n        isInteger\n      })),\n      'Format ': format\n    };\n  }\n\n  value = attribute;\n  size = attribute.length;\n  type = String(attribute.constructor.name).replace('Array', '');\n  isInteger = type.indexOf('nt') !== -1;\n  return {\n    [header]: \"\".concat(formatValue(value, {\n      size,\n      isInteger\n    }), \" (constant)\"),\n    'Format ': \"\".concat(size, \"x\").concat(type, \" (constant)\")\n  };\n}\n\nfunction getGLSLDeclaration(name, accessor) {\n  const {\n    type,\n    size\n  } = accessor;\n  const typeAndName = getCompositeGLType(type, size);\n  return typeAndName ? \"\".concat(name, \" (\").concat(typeAndName.name, \")\") : name;\n}\n//# sourceMappingURL=debug-vertex-array.js.map","import { assert } from '../utils/assert';\nimport { formatValue } from '../utils/format-value';\nexport function getDebugTableForUniforms(_ref) {\n  let {\n    header = 'Uniforms',\n    program,\n    uniforms,\n    undefinedOnly = false\n  } = _ref;\n  assert(program);\n  const SHADER_MODULE_UNIFORM_REGEXP = '.*_.*';\n  const PROJECT_MODULE_UNIFORM_REGEXP = '.*Matrix';\n  const uniformLocations = program._uniformSetters;\n  const table = {};\n  const uniformNames = Object.keys(uniformLocations).sort();\n  let count = 0;\n\n  for (const uniformName of uniformNames) {\n    if (!uniformName.match(SHADER_MODULE_UNIFORM_REGEXP) && !uniformName.match(PROJECT_MODULE_UNIFORM_REGEXP)) {\n      if (addUniformToTable({\n        table,\n        header,\n        uniforms,\n        uniformName,\n        undefinedOnly\n      })) {\n        count++;\n      }\n    }\n  }\n\n  for (const uniformName of uniformNames) {\n    if (uniformName.match(PROJECT_MODULE_UNIFORM_REGEXP)) {\n      if (addUniformToTable({\n        table,\n        header,\n        uniforms,\n        uniformName,\n        undefinedOnly\n      })) {\n        count++;\n      }\n    }\n  }\n\n  for (const uniformName of uniformNames) {\n    if (!table[uniformName]) {\n      if (addUniformToTable({\n        table,\n        header,\n        uniforms,\n        uniformName,\n        undefinedOnly\n      })) {\n        count++;\n      }\n    }\n  }\n\n  let unusedCount = 0;\n  const unusedTable = {};\n\n  if (!undefinedOnly) {\n    for (const uniformName in uniforms) {\n      const uniform = uniforms[uniformName];\n\n      if (!table[uniformName]) {\n        unusedCount++;\n        unusedTable[uniformName] = {\n          Type: \"NOT USED: \".concat(uniform),\n          [header]: formatValue(uniform)\n        };\n      }\n    }\n  }\n\n  return {\n    table,\n    count,\n    unusedTable,\n    unusedCount\n  };\n}\n\nfunction addUniformToTable(_ref2) {\n  let {\n    table,\n    header,\n    uniforms,\n    uniformName,\n    undefinedOnly\n  } = _ref2;\n  const value = uniforms[uniformName];\n  const isDefined = isUniformDefined(value);\n\n  if (!undefinedOnly || !isDefined) {\n    table[uniformName] = {\n      [header]: isDefined ? formatValue(value) : 'N/A',\n      'Uniform Type': isDefined ? value : 'NOT PROVIDED'\n    };\n    return true;\n  }\n\n  return false;\n}\n\nfunction isUniformDefined(value) {\n  return value !== undefined && value !== null;\n}\n//# sourceMappingURL=debug-uniforms.js.map","import { getCompositeGLType } from '../webgl-utils/attribute-utils';\nexport function getDebugTableForProgramConfiguration(config) {\n  const table = {};\n  const header = \"Accessors for \".concat(config.id);\n\n  for (const attributeInfo of config.attributeInfos) {\n    if (attributeInfo) {\n      const glslDeclaration = getGLSLDeclaration(attributeInfo);\n      table[\"in \".concat(glslDeclaration)] = {\n        [header]: JSON.stringify(attributeInfo.accessor)\n      };\n    }\n  }\n\n  for (const varyingInfo of config.varyingInfos) {\n    if (varyingInfo) {\n      const glslDeclaration = getGLSLDeclaration(varyingInfo);\n      table[\"out \".concat(glslDeclaration)] = {\n        [header]: JSON.stringify(varyingInfo.accessor)\n      };\n    }\n  }\n\n  return table;\n}\n\nfunction getGLSLDeclaration(attributeInfo) {\n  const {\n    type,\n    size\n  } = attributeInfo.accessor;\n  const typeAndName = getCompositeGLType(type, size);\n\n  if (typeAndName) {\n    return \"\".concat(typeAndName.name, \" \").concat(attributeInfo.name);\n  }\n\n  return attributeInfo.name;\n}\n//# sourceMappingURL=debug-program-configuration.js.map","import { Buffer, assert } from '@luma.gl/webgl';\nconst GLTF_TO_LUMA_ATTRIBUTE_MAP = {\n  POSITION: 'positions',\n  NORMAL: 'normals',\n  COLOR_0: 'colors',\n  TEXCOORD_0: 'texCoords',\n  TEXCOORD_1: 'texCoords1',\n  TEXCOORD_2: 'texCoords2'\n};\nexport function getBuffersFromGeometry(gl, geometry, options) {\n  const buffers = {};\n  let indices = geometry.indices;\n\n  for (const name in geometry.attributes) {\n    const attribute = geometry.attributes[name];\n    const remappedName = mapAttributeName(name, options);\n\n    if (name === 'indices') {\n      indices = attribute;\n    } else if (attribute.constant) {\n      buffers[remappedName] = attribute.value;\n    } else {\n      const typedArray = attribute.value;\n      const accessor = { ...attribute\n      };\n      delete accessor.value;\n      buffers[remappedName] = [new Buffer(gl, typedArray), accessor];\n      inferAttributeAccessor(name, accessor);\n    }\n  }\n\n  if (indices) {\n    const data = indices.value || indices;\n    assert(data instanceof Uint16Array || data instanceof Uint32Array, 'attribute array for \"indices\" must be of integer type');\n    const accessor = {\n      size: 1,\n      isIndexed: indices.isIndexed === undefined ? true : indices.isIndexed\n    };\n    buffers.indices = [new Buffer(gl, {\n      data,\n      target: 34963\n    }), accessor];\n  }\n\n  return buffers;\n}\n\nfunction mapAttributeName(name, options) {\n  const {\n    attributeMap = GLTF_TO_LUMA_ATTRIBUTE_MAP\n  } = options || {};\n  return attributeMap && attributeMap[name] || name;\n}\n\nexport function inferAttributeAccessor(attributeName, attribute) {\n  let category;\n\n  switch (attributeName) {\n    case 'texCoords':\n    case 'texCoord1':\n    case 'texCoord2':\n    case 'texCoord3':\n      category = 'uvs';\n      break;\n\n    case 'vertices':\n    case 'positions':\n    case 'normals':\n    case 'pickingColors':\n      category = 'vectors';\n      break;\n\n    default:\n  }\n\n  switch (category) {\n    case 'vectors':\n      attribute.size = attribute.size || 3;\n      break;\n\n    case 'uvs':\n      attribute.size = attribute.size || 2;\n      break;\n\n    default:\n  }\n\n  assert(Number.isFinite(attribute.size), \"attribute \".concat(attributeName, \" needs size\"));\n}\n//# sourceMappingURL=model-utils.js.map","import { isWebGL } from '@luma.gl/gltools';\nimport ProgramManager from './program-manager';\nimport { Program, VertexArray, clear, TransformFeedback, Buffer, log, isObjectEmpty, uid, assert } from '@luma.gl/webgl';\nimport { getDebugTableForUniforms, getDebugTableForVertexArray, getDebugTableForProgramConfiguration } from '@luma.gl/webgl';\nimport { getBuffersFromGeometry } from './model-utils';\nconst LOG_DRAW_PRIORITY = 2;\nconst LOG_DRAW_TIMEOUT = 10000;\nconst ERR_MODEL_PARAMS = 'Model needs drawMode and vertexCount';\n\nconst NOOP = () => {};\n\nconst DRAW_PARAMS = {};\nexport default class Model {\n  constructor(gl) {\n    let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    const {\n      id = uid('model')\n    } = props;\n    assert(isWebGL(gl));\n    this.id = id;\n    this.gl = gl;\n    this.id = props.id || uid('Model');\n    this.lastLogTime = 0;\n    this.animated = false;\n    this.initialize(props);\n  }\n\n  initialize(props) {\n    this.props = {};\n    this.programManager = props.programManager || ProgramManager.getDefaultProgramManager(this.gl);\n    this._programManagerState = -1;\n    this._managedProgram = false;\n    const {\n      program = null,\n      vs,\n      fs,\n      modules,\n      defines,\n      inject,\n      varyings,\n      bufferMode,\n      transpileToGLSL100\n    } = props;\n    this.programProps = {\n      program,\n      vs,\n      fs,\n      modules,\n      defines,\n      inject,\n      varyings,\n      bufferMode,\n      transpileToGLSL100\n    };\n    this.program = null;\n    this.vertexArray = null;\n    this._programDirty = true;\n    this.userData = {};\n    this.needsRedraw = true;\n    this._attributes = {};\n    this.attributes = {};\n    this.uniforms = {};\n    this.pickable = true;\n\n    this._checkProgram();\n\n    this.setUniforms(Object.assign({}, this.getModuleUniforms(props.moduleSettings)));\n    this.drawMode = props.drawMode !== undefined ? props.drawMode : 4;\n    this.vertexCount = props.vertexCount || 0;\n    this.geometryBuffers = {};\n    this.isInstanced = props.isInstanced || props.instanced || props.instanceCount > 0;\n\n    this._setModelProps(props);\n\n    this.geometry = {};\n    assert(this.drawMode !== undefined && Number.isFinite(this.vertexCount), ERR_MODEL_PARAMS);\n  }\n\n  setProps(props) {\n    this._setModelProps(props);\n  }\n\n  delete() {\n    for (const key in this._attributes) {\n      if (this._attributes[key] !== this.attributes[key]) {\n        this._attributes[key].delete();\n      }\n    }\n\n    if (this._managedProgram) {\n      this.programManager.release(this.program);\n      this._managedProgram = false;\n    }\n\n    this.vertexArray.delete();\n\n    this._deleteGeometryBuffers();\n  }\n\n  getDrawMode() {\n    return this.drawMode;\n  }\n\n  getVertexCount() {\n    return this.vertexCount;\n  }\n\n  getInstanceCount() {\n    return this.instanceCount;\n  }\n\n  getAttributes() {\n    return this.attributes;\n  }\n\n  getProgram() {\n    return this.program;\n  }\n\n  setProgram(props) {\n    const {\n      program,\n      vs,\n      fs,\n      modules,\n      defines,\n      inject,\n      varyings,\n      bufferMode,\n      transpileToGLSL100\n    } = props;\n    this.programProps = {\n      program,\n      vs,\n      fs,\n      modules,\n      defines,\n      inject,\n      varyings,\n      bufferMode,\n      transpileToGLSL100\n    };\n    this._programDirty = true;\n  }\n\n  getUniforms() {\n    return this.uniforms;\n  }\n\n  setDrawMode(drawMode) {\n    this.drawMode = drawMode;\n    return this;\n  }\n\n  setVertexCount(vertexCount) {\n    assert(Number.isFinite(vertexCount));\n    this.vertexCount = vertexCount;\n    return this;\n  }\n\n  setInstanceCount(instanceCount) {\n    assert(Number.isFinite(instanceCount));\n    this.instanceCount = instanceCount;\n    return this;\n  }\n\n  setGeometry(geometry) {\n    this.drawMode = geometry.drawMode;\n    this.vertexCount = geometry.getVertexCount();\n\n    this._deleteGeometryBuffers();\n\n    this.geometryBuffers = getBuffersFromGeometry(this.gl, geometry);\n    this.vertexArray.setAttributes(this.geometryBuffers);\n    return this;\n  }\n\n  setAttributes() {\n    let attributes = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    if (isObjectEmpty(attributes)) {\n      return this;\n    }\n\n    const normalizedAttributes = {};\n\n    for (const name in attributes) {\n      const attribute = attributes[name];\n      normalizedAttributes[name] = attribute.getValue ? attribute.getValue() : attribute;\n    }\n\n    this.vertexArray.setAttributes(normalizedAttributes);\n    return this;\n  }\n\n  setUniforms() {\n    let uniforms = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    Object.assign(this.uniforms, uniforms);\n    return this;\n  }\n\n  getModuleUniforms(opts) {\n    this._checkProgram();\n\n    const getUniforms = this.programManager.getUniforms(this.program);\n\n    if (getUniforms) {\n      return getUniforms(opts);\n    }\n\n    return {};\n  }\n\n  updateModuleSettings(opts) {\n    const uniforms = this.getModuleUniforms(opts || {});\n    return this.setUniforms(uniforms);\n  }\n\n  clear(opts) {\n    clear(this.program.gl, opts);\n    return this;\n  }\n\n  draw() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    this._checkProgram();\n\n    const {\n      moduleSettings = null,\n      framebuffer,\n      uniforms = {},\n      attributes = {},\n      transformFeedback = this.transformFeedback,\n      parameters = {},\n      vertexArray = this.vertexArray\n    } = opts;\n    this.setAttributes(attributes);\n    this.updateModuleSettings(moduleSettings);\n    this.setUniforms(uniforms);\n    let logPriority;\n\n    if (log.priority >= LOG_DRAW_PRIORITY) {\n      logPriority = this._logDrawCallStart(LOG_DRAW_PRIORITY);\n    }\n\n    const drawParams = this.vertexArray.getDrawParams();\n    const {\n      isIndexed = drawParams.isIndexed,\n      indexType = drawParams.indexType,\n      indexOffset = drawParams.indexOffset,\n      vertexArrayInstanced = drawParams.isInstanced\n    } = this.props;\n\n    if (vertexArrayInstanced && !this.isInstanced) {\n      log.warn('Found instanced attributes on non-instanced model', this.id)();\n    }\n\n    const {\n      isInstanced,\n      instanceCount\n    } = this;\n    const {\n      onBeforeRender = NOOP,\n      onAfterRender = NOOP\n    } = this.props;\n    onBeforeRender();\n    this.program.setUniforms(this.uniforms);\n    const didDraw = this.program.draw(Object.assign(DRAW_PARAMS, opts, {\n      logPriority,\n      uniforms: null,\n      framebuffer,\n      parameters,\n      drawMode: this.getDrawMode(),\n      vertexCount: this.getVertexCount(),\n      vertexArray,\n      transformFeedback,\n      isIndexed,\n      indexType,\n      isInstanced,\n      instanceCount,\n      offset: isIndexed ? indexOffset : 0\n    }));\n    onAfterRender();\n\n    if (log.priority >= LOG_DRAW_PRIORITY) {\n      this._logDrawCallEnd(logPriority, vertexArray, framebuffer);\n    }\n\n    return didDraw;\n  }\n\n  transform() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      discard = true,\n      feedbackBuffers,\n      unbindModels = []\n    } = opts;\n    let {\n      parameters\n    } = opts;\n\n    if (feedbackBuffers) {\n      this._setFeedbackBuffers(feedbackBuffers);\n    }\n\n    if (discard) {\n      parameters = Object.assign({}, parameters, {\n        [35977]: discard\n      });\n    }\n\n    unbindModels.forEach(model => model.vertexArray.unbindBuffers());\n\n    try {\n      this.draw(Object.assign({}, opts, {\n        parameters\n      }));\n    } finally {\n      unbindModels.forEach(model => model.vertexArray.bindBuffers());\n    }\n\n    return this;\n  }\n\n  render() {\n    let uniforms = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    log.warn('Model.render() is deprecated. Use Model.setUniforms() and Model.draw()')();\n    return this.setUniforms(uniforms).draw();\n  }\n\n  _setModelProps(props) {\n    Object.assign(this.props, props);\n\n    if ('uniforms' in props) {\n      this.setUniforms(props.uniforms);\n    }\n\n    if ('pickable' in props) {\n      this.pickable = props.pickable;\n    }\n\n    if ('instanceCount' in props) {\n      this.instanceCount = props.instanceCount;\n    }\n\n    if ('geometry' in props) {\n      this.setGeometry(props.geometry);\n    }\n\n    if ('attributes' in props) {\n      this.setAttributes(props.attributes);\n    }\n\n    if ('_feedbackBuffers' in props) {\n      this._setFeedbackBuffers(props._feedbackBuffers);\n    }\n  }\n\n  _checkProgram() {\n    const needsUpdate = this._programDirty || this.programManager.stateHash !== this._programManagerState;\n\n    if (!needsUpdate) {\n      return;\n    }\n\n    let {\n      program\n    } = this.programProps;\n\n    if (program) {\n      this._managedProgram = false;\n    } else {\n      const {\n        vs,\n        fs,\n        modules,\n        inject,\n        defines,\n        varyings,\n        bufferMode,\n        transpileToGLSL100\n      } = this.programProps;\n      program = this.programManager.get({\n        vs,\n        fs,\n        modules,\n        inject,\n        defines,\n        varyings,\n        bufferMode,\n        transpileToGLSL100\n      });\n\n      if (this.program && this._managedProgram) {\n        this.programManager.release(this.program);\n      }\n\n      this._programManagerState = this.programManager.stateHash;\n      this._managedProgram = true;\n    }\n\n    assert(program instanceof Program, 'Model needs a program');\n    this._programDirty = false;\n\n    if (program === this.program) {\n      return;\n    }\n\n    this.program = program;\n\n    if (this.vertexArray) {\n      this.vertexArray.setProps({\n        program: this.program,\n        attributes: this.vertexArray.attributes\n      });\n    } else {\n      this.vertexArray = new VertexArray(this.gl, {\n        program: this.program\n      });\n    }\n\n    this.setUniforms(Object.assign({}, this.getModuleUniforms()));\n  }\n\n  _deleteGeometryBuffers() {\n    for (const name in this.geometryBuffers) {\n      const buffer = this.geometryBuffers[name][0] || this.geometryBuffers[name];\n\n      if (buffer instanceof Buffer) {\n        buffer.delete();\n      }\n    }\n  }\n\n  _setAnimationProps(animationProps) {\n    if (this.animated) {\n      assert(animationProps, 'Model.draw(): animated uniforms but no animationProps');\n    }\n  }\n\n  _setFeedbackBuffers() {\n    let feedbackBuffers = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    if (isObjectEmpty(feedbackBuffers)) {\n      return this;\n    }\n\n    const {\n      gl\n    } = this.program;\n    this.transformFeedback = this.transformFeedback || new TransformFeedback(gl, {\n      program: this.program\n    });\n    this.transformFeedback.setBuffers(feedbackBuffers);\n    return this;\n  }\n\n  _logDrawCallStart(logLevel) {\n    const logDrawTimeout = logLevel > 3 ? 0 : LOG_DRAW_TIMEOUT;\n\n    if (Date.now() - this.lastLogTime < logDrawTimeout) {\n      return undefined;\n    }\n\n    this.lastLogTime = Date.now();\n    log.group(LOG_DRAW_PRIORITY, \">>> DRAWING MODEL \".concat(this.id), {\n      collapsed: log.level <= 2\n    })();\n    return logLevel;\n  }\n\n  _logDrawCallEnd(logLevel, vertexArray, uniforms, framebuffer) {\n    if (logLevel === undefined) {\n      return;\n    }\n\n    const attributeTable = getDebugTableForVertexArray({\n      vertexArray,\n      header: \"\".concat(this.id, \" attributes\"),\n      attributes: this._attributes\n    });\n    const {\n      table: uniformTable,\n      unusedTable,\n      unusedCount\n    } = getDebugTableForUniforms({\n      header: \"\".concat(this.id, \" uniforms\"),\n      program: this.program,\n      uniforms: Object.assign({}, this.program.uniforms, uniforms)\n    });\n    const {\n      table: missingTable,\n      count: missingCount\n    } = getDebugTableForUniforms({\n      header: \"\".concat(this.id, \" uniforms\"),\n      program: this.program,\n      uniforms: Object.assign({}, this.program.uniforms, uniforms),\n      undefinedOnly: true\n    });\n\n    if (missingCount > 0) {\n      log.log('MISSING UNIFORMS', Object.keys(missingTable))();\n    }\n\n    if (unusedCount > 0) {\n      log.log('UNUSED UNIFORMS', Object.keys(unusedTable))();\n    }\n\n    const configTable = getDebugTableForProgramConfiguration(this.vertexArray.configuration);\n    log.table(logLevel, attributeTable)();\n    log.table(logLevel, uniformTable)();\n    log.table(logLevel + 1, configTable)();\n\n    if (framebuffer) {\n      framebuffer.log({\n        logLevel: LOG_DRAW_PRIORITY,\n        message: \"Rendered to \".concat(framebuffer.id)\n      });\n    }\n\n    log.groupEnd(LOG_DRAW_PRIORITY)();\n  }\n\n}\n//# sourceMappingURL=model.js.map","export default function assert(condition, message) {\n  if (!condition) {\n    throw new Error(message || 'shadertools: assertion failed.');\n  }\n}\n//# sourceMappingURL=assert.js.map","import { assertWebGL2Context, withParameters } from '@luma.gl/gltools';\nimport { assert } from '../utils/assert';\nconst GL_DEPTH_BUFFER_BIT = 0x00000100;\nconst GL_STENCIL_BUFFER_BIT = 0x00000400;\nconst GL_COLOR_BUFFER_BIT = 0x00004000;\nconst GL_COLOR = 0x1800;\nconst GL_DEPTH = 0x1801;\nconst GL_STENCIL = 0x1802;\nconst GL_DEPTH_STENCIL = 0x84f9;\nconst ERR_ARGUMENTS = 'clear: bad arguments';\nexport function clear(gl) {\n  let {\n    framebuffer = null,\n    color = null,\n    depth = null,\n    stencil = null\n  } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n  const parameters = {};\n\n  if (framebuffer) {\n    parameters.framebuffer = framebuffer;\n  }\n\n  let clearFlags = 0;\n\n  if (color) {\n    clearFlags |= GL_COLOR_BUFFER_BIT;\n\n    if (color !== true) {\n      parameters.clearColor = color;\n    }\n  }\n\n  if (depth) {\n    clearFlags |= GL_DEPTH_BUFFER_BIT;\n\n    if (depth !== true) {\n      parameters.clearDepth = depth;\n    }\n  }\n\n  if (stencil) {\n    clearFlags |= GL_STENCIL_BUFFER_BIT;\n\n    if (depth !== true) {\n      parameters.clearStencil = depth;\n    }\n  }\n\n  assert(clearFlags !== 0, ERR_ARGUMENTS);\n  withParameters(gl, parameters, () => {\n    gl.clear(clearFlags);\n  });\n}\nexport function clearBuffer(gl) {\n  let {\n    framebuffer = null,\n    buffer = GL_COLOR,\n    drawBuffer = 0,\n    value = [0, 0, 0, 0]\n  } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n  assertWebGL2Context(gl);\n  withParameters(gl, {\n    framebuffer\n  }, () => {\n    switch (buffer) {\n      case GL_COLOR:\n        switch (value.constructor) {\n          case Int32Array:\n            gl.clearBufferiv(buffer, drawBuffer, value);\n            break;\n\n          case Uint32Array:\n            gl.clearBufferuiv(buffer, drawBuffer, value);\n            break;\n\n          case Float32Array:\n          default:\n            gl.clearBufferfv(buffer, drawBuffer, value);\n        }\n\n        break;\n\n      case GL_DEPTH:\n        gl.clearBufferfv(GL_DEPTH, 0, [value]);\n        break;\n\n      case GL_STENCIL:\n        gl.clearBufferiv(GL_STENCIL, 0, [value]);\n        break;\n\n      case GL_DEPTH_STENCIL:\n        const [depth, stencil] = value;\n        gl.clearBufferfi(GL_DEPTH_STENCIL, 0, depth, stencil);\n        break;\n\n      default:\n        assert(false, ERR_ARGUMENTS);\n    }\n  });\n}\n//# sourceMappingURL=clear.js.map","import Framebuffer from '../classes/framebuffer';\nimport Texture2D from '../classes/texture-2d';\nexport const FEATURES = {\n  WEBGL2: 'WEBGL2',\n  VERTEX_ARRAY_OBJECT: 'VERTEX_ARRAY_OBJECT',\n  TIMER_QUERY: 'TIMER_QUERY',\n  INSTANCED_RENDERING: 'INSTANCED_RENDERING',\n  MULTIPLE_RENDER_TARGETS: 'MULTIPLE_RENDER_TARGETS',\n  ELEMENT_INDEX_UINT32: 'ELEMENT_INDEX_UINT32',\n  BLEND_EQUATION_MINMAX: 'BLEND_EQUATION_MINMAX',\n  FLOAT_BLEND: 'FLOAT_BLEND',\n  COLOR_ENCODING_SRGB: 'COLOR_ENCODING_SRGB',\n  TEXTURE_DEPTH: 'TEXTURE_DEPTH',\n  TEXTURE_FLOAT: 'TEXTURE_FLOAT',\n  TEXTURE_HALF_FLOAT: 'TEXTURE_HALF_FLOAT',\n  TEXTURE_FILTER_LINEAR_FLOAT: 'TEXTURE_FILTER_LINEAR_FLOAT',\n  TEXTURE_FILTER_LINEAR_HALF_FLOAT: 'TEXTURE_FILTER_LINEAR_HALF_FLOAT',\n  TEXTURE_FILTER_ANISOTROPIC: 'TEXTURE_FILTER_ANISOTROPIC',\n  COLOR_ATTACHMENT_RGBA32F: 'COLOR_ATTACHMENT_RGBA32F',\n  COLOR_ATTACHMENT_FLOAT: 'COLOR_ATTACHMENT_FLOAT',\n  COLOR_ATTACHMENT_HALF_FLOAT: 'COLOR_ATTACHMENT_HALF_FLOAT',\n  GLSL_FRAG_DATA: 'GLSL_FRAG_DATA',\n  GLSL_FRAG_DEPTH: 'GLSL_FRAG_DEPTH',\n  GLSL_DERIVATIVES: 'GLSL_DERIVATIVES',\n  GLSL_TEXTURE_LOD: 'GLSL_TEXTURE_LOD'\n};\n\nfunction checkFloat32ColorAttachment(gl) {\n  const testTexture = new Texture2D(gl, {\n    format: 6408,\n    type: 5126,\n    dataFormat: 6408\n  });\n  const testFb = new Framebuffer(gl, {\n    id: \"test-framebuffer\",\n    check: false,\n    attachments: {\n      [36064]: testTexture\n    }\n  });\n  const status = testFb.getStatus();\n  testTexture.delete();\n  testFb.delete();\n  return status === 36053;\n}\n\nexport default {\n  [FEATURES.WEBGL2]: [false, true],\n  [FEATURES.VERTEX_ARRAY_OBJECT]: ['OES_vertex_array_object', true],\n  [FEATURES.TIMER_QUERY]: ['EXT_disjoint_timer_query', 'EXT_disjoint_timer_query_webgl2'],\n  [FEATURES.INSTANCED_RENDERING]: ['ANGLE_instanced_arrays', true],\n  [FEATURES.MULTIPLE_RENDER_TARGETS]: ['WEBGL_draw_buffers', true],\n  [FEATURES.ELEMENT_INDEX_UINT32]: ['OES_element_index_uint', true],\n  [FEATURES.BLEND_EQUATION_MINMAX]: ['EXT_blend_minmax', true],\n  [FEATURES.FLOAT_BLEND]: ['EXT_float_blend'],\n  [FEATURES.COLOR_ENCODING_SRGB]: ['EXT_sRGB', true],\n  [FEATURES.TEXTURE_DEPTH]: ['WEBGL_depth_texture', true],\n  [FEATURES.TEXTURE_FLOAT]: ['OES_texture_float', true],\n  [FEATURES.TEXTURE_HALF_FLOAT]: ['OES_texture_half_float', true],\n  [FEATURES.TEXTURE_FILTER_LINEAR_FLOAT]: ['OES_texture_float_linear'],\n  [FEATURES.TEXTURE_FILTER_LINEAR_HALF_FLOAT]: ['OES_texture_half_float_linear'],\n  [FEATURES.TEXTURE_FILTER_ANISOTROPIC]: ['EXT_texture_filter_anisotropic'],\n  [FEATURES.COLOR_ATTACHMENT_RGBA32F]: [checkFloat32ColorAttachment, 'EXT_color_buffer_float'],\n  [FEATURES.COLOR_ATTACHMENT_FLOAT]: [false, 'EXT_color_buffer_float'],\n  [FEATURES.COLOR_ATTACHMENT_HALF_FLOAT]: ['EXT_color_buffer_half_float'],\n  [FEATURES.GLSL_FRAG_DATA]: ['WEBGL_draw_buffers', true],\n  [FEATURES.GLSL_FRAG_DEPTH]: ['EXT_frag_depth', true],\n  [FEATURES.GLSL_DERIVATIVES]: ['OES_standard_derivatives', true],\n  [FEATURES.GLSL_TEXTURE_LOD]: ['EXT_shader_texture_lod', true]\n};\n//# sourceMappingURL=webgl-features-table.js.map","import { assert } from '../env-utils/assert';\nimport { VERSION as __VERSION__ } from '../env-utils/version';\nconst NPM_TAG = 'latest';\nconst VERSION = typeof \"3.2.10\" !== 'undefined' ? \"3.2.10\" : NPM_TAG;\nexport function getWorkerName(worker) {\n  const warning = worker.version !== VERSION ? \" (worker-utils@\".concat(VERSION, \")\") : '';\n  return \"\".concat(worker.name, \"@\").concat(worker.version).concat(warning);\n}\nexport function getWorkerURL(worker, options = {}) {\n  const workerOptions = options[worker.id] || {};\n  const workerFile = \"\".concat(worker.id, \"-worker.js\");\n  let url = workerOptions.workerUrl;\n\n  if (!url && worker.id === 'compression') {\n    url = options.workerUrl;\n  }\n\n  if (options._workerType === 'test') {\n    url = \"modules/\".concat(worker.module, \"/dist/\").concat(workerFile);\n  }\n\n  if (!url) {\n    let version = worker.version;\n\n    if (version === 'latest') {\n      version = NPM_TAG;\n    }\n\n    const versionTag = version ? \"@\".concat(version) : '';\n    url = \"https://unpkg.com/@loaders.gl/\".concat(worker.module).concat(versionTag, \"/dist/\").concat(workerFile);\n  }\n\n  assert(url);\n  return url;\n}\n//# sourceMappingURL=get-worker-url.js.map","import { MODULE_INJECTORS_VS, MODULE_INJECTORS_FS } from '../modules/module-injectors';\nimport { VERTEX_SHADER, FRAGMENT_SHADER } from './constants';\nimport { assert } from '../utils';\nconst MODULE_INJECTORS = {\n  [VERTEX_SHADER]: MODULE_INJECTORS_VS,\n  [FRAGMENT_SHADER]: MODULE_INJECTORS_FS\n};\nexport const DECLARATION_INJECT_MARKER = '__LUMA_INJECT_DECLARATIONS__';\nconst REGEX_START_OF_MAIN = /void\\s+main\\s*\\([^)]*\\)\\s*\\{\\n?/;\nconst REGEX_END_OF_MAIN = /}\\n?[^{}]*$/;\nconst fragments = [];\nexport default function injectShader(source, type, inject) {\n  let injectStandardStubs = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;\n  const isVertex = type === VERTEX_SHADER;\n\n  for (const key in inject) {\n    const fragmentData = inject[key];\n    fragmentData.sort((a, b) => a.order - b.order);\n    fragments.length = fragmentData.length;\n\n    for (let i = 0, len = fragmentData.length; i < len; ++i) {\n      fragments[i] = fragmentData[i].injection;\n    }\n\n    const fragmentString = \"\".concat(fragments.join('\\n'), \"\\n\");\n\n    switch (key) {\n      case 'vs:#decl':\n        if (isVertex) {\n          source = source.replace(DECLARATION_INJECT_MARKER, fragmentString);\n        }\n\n        break;\n\n      case 'vs:#main-start':\n        if (isVertex) {\n          source = source.replace(REGEX_START_OF_MAIN, match => match + fragmentString);\n        }\n\n        break;\n\n      case 'vs:#main-end':\n        if (isVertex) {\n          source = source.replace(REGEX_END_OF_MAIN, match => fragmentString + match);\n        }\n\n        break;\n\n      case 'fs:#decl':\n        if (!isVertex) {\n          source = source.replace(DECLARATION_INJECT_MARKER, fragmentString);\n        }\n\n        break;\n\n      case 'fs:#main-start':\n        if (!isVertex) {\n          source = source.replace(REGEX_START_OF_MAIN, match => match + fragmentString);\n        }\n\n        break;\n\n      case 'fs:#main-end':\n        if (!isVertex) {\n          source = source.replace(REGEX_END_OF_MAIN, match => fragmentString + match);\n        }\n\n        break;\n\n      default:\n        source = source.replace(key, match => match + fragmentString);\n    }\n  }\n\n  source = source.replace(DECLARATION_INJECT_MARKER, '');\n\n  if (injectStandardStubs) {\n    source = source.replace(/\\}\\s*$/, match => match + MODULE_INJECTORS[type]);\n  }\n\n  return source;\n}\nexport function combineInjects(injects) {\n  const result = {};\n  assert(Array.isArray(injects) && injects.length > 1);\n  injects.forEach(inject => {\n    for (const key in inject) {\n      result[key] = result[key] ? \"\".concat(result[key], \"\\n\").concat(inject[key]) : inject[key];\n    }\n  });\n  return result;\n}\n//# sourceMappingURL=inject-shader.js.map","export const MODULE_INJECTORS_VS = \"#ifdef MODULE_LOGDEPTH\\n  logdepth_adjustPosition(gl_Position);\\n#endif\\n\";\nexport const MODULE_INJECTORS_FS = \"#ifdef MODULE_MATERIAL\\n  gl_FragColor = material_filterColor(gl_FragColor);\\n#endif\\n\\n#ifdef MODULE_LIGHTING\\n  gl_FragColor = lighting_filterColor(gl_FragColor);\\n#endif\\n\\n#ifdef MODULE_FOG\\n  gl_FragColor = fog_filterColor(gl_FragColor);\\n#endif\\n\\n#ifdef MODULE_PICKING\\n  gl_FragColor = picking_filterHighlightColor(gl_FragColor);\\n  gl_FragColor = picking_filterPickingColor(gl_FragColor);\\n#endif\\n\\n#ifdef MODULE_LOGDEPTH\\n  logdepth_setFragDepth();\\n#endif\\n\";\n//# sourceMappingURL=module-injectors.js.map","function _typeof(obj) {\n  \"@babel/helpers - typeof\";\n\n  return (module.exports = _typeof = \"function\" == typeof Symbol && \"symbol\" == typeof Symbol.iterator ? function (obj) {\n    return typeof obj;\n  } : function (obj) {\n    return obj && \"function\" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj;\n  }, module.exports.__esModule = true, module.exports[\"default\"] = module.exports), _typeof(obj);\n}\nmodule.exports = _typeof, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","import { isBrowser } from '@loaders.gl/worker-utils';\nimport { WorkerFarm, getWorkerURL } from '@loaders.gl/worker-utils';\nexport function canParseWithWorker(loader, options) {\n  if (!WorkerFarm.isSupported()) {\n    return false;\n  }\n\n  if (!isBrowser && !(options !== null && options !== void 0 && options._nodeWorkers)) {\n    return false;\n  }\n\n  return loader.worker && (options === null || options === void 0 ? void 0 : options.worker);\n}\nexport async function parseWithWorker(loader, data, options, context, parseOnMainThread) {\n  const name = loader.id;\n  const url = getWorkerURL(loader, options);\n  const workerFarm = WorkerFarm.getWorkerFarm(options);\n  const workerPool = workerFarm.getWorkerPool({\n    name,\n    url\n  });\n  options = JSON.parse(JSON.stringify(options));\n  context = JSON.parse(JSON.stringify(context || {}));\n  const job = await workerPool.startJob('process-on-worker', onMessage.bind(null, parseOnMainThread));\n  job.postMessage('process', {\n    input: data,\n    options,\n    context\n  });\n  const result = await job.result;\n  return await result.result;\n}\n\nasync function onMessage(parseOnMainThread, job, type, payload) {\n  switch (type) {\n    case 'done':\n      job.done(payload);\n      break;\n\n    case 'error':\n      job.error(new Error(payload.error));\n      break;\n\n    case 'process':\n      const {\n        id,\n        input,\n        options\n      } = payload;\n\n      try {\n        const result = await parseOnMainThread(input, options);\n        job.postMessage('done', {\n          id,\n          result\n        });\n      } catch (error) {\n        const message = error instanceof Error ? error.message : 'unknown error';\n        job.postMessage('error', {\n          id,\n          error: message\n        });\n      }\n\n      break;\n\n    default:\n      console.warn(\"parse-with-worker unknown message \".concat(type));\n  }\n}\n//# sourceMappingURL=parse-with-worker.js.map","export default function assert(condition, message = '') {\n  if (!condition) {\n    throw new Error(`JSON conversion error ${message}`);\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n/**\n * Access properties of nested containers using dot-path notation\n * Returns `undefined` if any container is not valid, instead of throwing\n * @param {Object} container - container that supports get\n * @param {String|*} compositeKey - key to access, can be '.'-separated string\n * @return {*} - value in the final key of the nested container, or `undefined`\n */\nexport function get(container, compositeKey) {\n  // Split the key into subkeys\n  const keyList = getKeys(compositeKey);\n  // Recursively get the value of each key;\n  let value = container;\n  for (const key of keyList) {\n    // If any intermediate subfield is not an object, return undefined\n    value = isObject(value) ? value[key] : undefined;\n  }\n  return value;\n}\n\n/**\n * Checks if argument is an \"indexable\" object (not a primitive value, nor null)\n * @param {*} value - JavaScript value to be tested\n * @return {Boolean} - true if argument is a JavaScript object\n */\nfunction isObject(value) {\n  return value !== null && typeof value === 'object';\n}\n\n// Cache key to key arrays for speed\nconst keyMap = {};\n\n// Takes a string of '.' separated keys and returns an array of keys\n// - 'feature.geometry.type' => ['feature', 'geometry', 'type']\n// - 'feature' => ['feature']\nfunction getKeys(compositeKey) {\n  if (typeof compositeKey === 'string') {\n    // else assume string and split around dots\n    let keyList = keyMap[compositeKey];\n    if (!keyList) {\n      keyList = compositeKey.split('.');\n      keyMap[compositeKey] = keyList;\n    }\n    return keyList;\n  }\n  // Wrap in array if needed\n  return Array.isArray(compositeKey) ? compositeKey : [compositeKey];\n}\n","import {get} from '../utils/get';\n\n// expression-eval: Small jsep based expression parser that supports array and object indexing\nimport expressionEval from 'expression-eval';\n\nconst cachedExpressionMap = {\n  '-': object => object\n};\n\n// Calculates an accessor function from a JSON string\n// '-' : x => x\n// 'a.b.c': x => x.a.b.c\nexport default function parseExpressionString(propValue, configuration) {\n  // NOTE: Can be null which represents invalid function. Return null so that prop can be omitted\n  if (propValue in cachedExpressionMap) {\n    return cachedExpressionMap[propValue];\n  }\n\n  let func;\n  // Compile with expression-eval\n  const ast = expressionEval.parse(propValue);\n  if (!ast.right && !ast.left && ast.type === 'Identifier') {\n    func = row => {\n      return get(row, propValue);\n    };\n  } else {\n    // NOTE: To avoid security risks, the arguments passed to the\n    // compiled expression must only give access to pure data (no globals etc)\n    // We disable function call syntax\n    traverse(ast, node => {\n      if (node.type === 'CallExpression') {\n        throw new Error('Function calls not allowed in JSON expressions');\n      }\n    });\n    // TODO Something like `expressionEval.eval(ast, {row});` would be useful for unpacking arrays\n    func = row => {\n      return expressionEval.eval(ast, row);\n    };\n  }\n\n  // Cache the compiled function\n  cachedExpressionMap[propValue] = func;\n  return func;\n}\n\n// Helper function to search all nodes in AST returned by expressionEval\n// eslint-disable-next-line complexity\nfunction traverse(node, visitor) {\n  if (Array.isArray(node)) {\n    node.forEach(element => traverse(element, visitor));\n  } else if (node && typeof node === 'object') {\n    if (node.type) {\n      visitor(node);\n    }\n    for (const key in node) {\n      traverse(node[key], visitor);\n    }\n  }\n}\n","const FUNCTION_IDENTIFIER = '@@=';\nconst CONSTANT_IDENTIFIER = '@@#';\nconst TYPE_KEY = '@@type';\nconst FUNCTION_KEY = '@@function';\n\nexport {FUNCTION_IDENTIFIER, CONSTANT_IDENTIFIER, TYPE_KEY, FUNCTION_KEY};\n","// TODO - default parsing code should not be part of the configuration.\nimport parseExpressionString from './helpers/parse-expression-string';\nimport assert from './utils/assert';\n\nimport {TYPE_KEY, FUNCTION_KEY} from './syntactic-sugar';\n\nconst isObject = value => value && typeof value === 'object';\n\nexport default class JSONConfiguration {\n  constructor(...configurations) {\n    // Initialize config with default values\n    this.typeKey = TYPE_KEY;\n    this.functionKey = FUNCTION_KEY;\n    this.log = console; // eslint-disable-line\n    this.classes = {};\n    this.reactComponents = {};\n    this.enumerations = {};\n    this.constants = {};\n    this.functions = {};\n    // TODO - this needs to be simpler, function conversion should be built in\n    this.convertFunction = parseExpressionString;\n    this.preProcessClassProps = (Class, props) => props;\n    this.postProcessConvertedJson = json => json;\n\n    for (const configuration of configurations) {\n      this.merge(configuration);\n    }\n  }\n\n  merge(configuration) {\n    for (const key in configuration) {\n      switch (key) {\n        // DEPRECATED = For backwards compatibility, add views and layers to classes;\n        case 'layers':\n        case 'views':\n          Object.assign(this.classes, configuration[key]);\n          break;\n        default:\n          // Store configuration as root fields (this.classes, ...)\n          if (key in this) {\n            const value = configuration[key];\n            this[key] = isObject(this[key]) ? Object.assign(this[key], value) : value;\n          }\n      }\n    }\n  }\n\n  validate(configuration) {\n    assert(!this.typeKey || typeof this.typeKey === 'string');\n    assert(isObject(this.classes));\n    return true;\n  }\n}\n","import parseExpressionString from './parse-expression-string';\n\nimport {FUNCTION_IDENTIFIER} from '../syntactic-sugar';\n\nfunction hasFunctionIdentifier(value) {\n  return typeof value === 'string' && value.startsWith(FUNCTION_IDENTIFIER);\n}\n\nfunction trimFunctionIdentifier(value) {\n  return value.replace(FUNCTION_IDENTIFIER, '');\n}\n\n// Try to determine if any props are function valued\n// and if so convert their string values to functions\nexport default function convertFunctions(props, configuration) {\n  // Use deck.gl prop types if available.\n  const replacedProps = {};\n  for (const propName in props) {\n    let propValue = props[propName];\n\n    // Parse string valued expressions\n    const isFunction = hasFunctionIdentifier(propValue);\n\n    if (isFunction) {\n      // Parse string as \"expression\", return equivalent JavaScript function\n      propValue = trimFunctionIdentifier(propValue);\n      propValue = parseExpressionString(propValue, configuration);\n    }\n\n    replacedProps[propName] = propValue;\n  }\n\n  return replacedProps;\n}\n","import convertFunctions from './convert-functions';\n\n// This attempts to instantiate a class, either as a class or as a React component\nexport function instantiateClass(type, props, configuration) {\n  // Find the class\n  const Class = configuration.classes[type];\n  const Component = configuration.reactComponents[type];\n\n  // Check that the class is in the configuration.\n  if (!Class && !Component) {\n    const {log} = configuration; // eslint-disable-line\n    if (log) {\n      const stringProps = JSON.stringify(props, null, 0).slice(0, 40);\n      log.warn(`JSON converter: No registered class of type ${type}(${stringProps}...)  `);\n    }\n    return null;\n  }\n\n  if (Class) {\n    return instantiateJavaScriptClass(Class, props, configuration);\n  }\n\n  return instantiateReactComponent(Component, props, configuration);\n}\n\nfunction instantiateJavaScriptClass(Class, props, configuration) {\n  if (configuration.preProcessClassProps) {\n    props = configuration.preProcessClassProps(Class, props, configuration);\n  }\n  props = convertFunctions(props, configuration);\n  return new Class(props);\n}\n\nfunction instantiateReactComponent(Component, props, configuration) {\n  const {React} = configuration;\n  const {children = []} = props;\n  delete props.children;\n  if (configuration.preProcessClassProps) {\n    props = configuration.preProcessClassProps(Component, props, configuration);\n  }\n\n  props = convertFunctions(props, configuration);\n\n  return React.createElement(Component, props, children);\n}\n","// Converts JSON to props (\"hydrating\" classes, resolving enums and functions etc).\n// Lightly processes `json` props, transform string values, and extract `views` and `layers`\n// See: https://github.com/visgl/deck.gl/blob/master/dev-docs/RFCs/v6.1/json-layers-rfc.md\n//\n// NOTES:\n// * This is intended to provide minimal necessary processing required to support\n//   existing deck.gl props via JSON. This is not an implementation of alternate JSON schemas.\n// * Optionally, error checking could be applied, but ideally should leverage\n//   non-JSON specific mechanisms like prop types.\n\nimport assert from './utils/assert';\nimport JSONConfiguration from './json-configuration';\nimport {instantiateClass} from './helpers/instantiate-class';\nimport {executeFunction} from './helpers/execute-function';\n\nimport {FUNCTION_IDENTIFIER, CONSTANT_IDENTIFIER, FUNCTION_KEY} from './syntactic-sugar';\nimport parseJSON from './helpers/parse-json';\n\nconst isObject = value => value && typeof value === 'object';\n\nexport default class JSONConverter {\n  constructor(props) {\n    this.log = console; // eslint-disable-line\n    this.configuration = {};\n    this.onJSONChange = () => {};\n    this.json = null;\n    this.convertedJson = null;\n    this.setProps(props);\n  }\n\n  finalize() {}\n\n  setProps(props) {\n    // HANDLE CONFIGURATION PROPS\n    if ('configuration' in props) {\n      // Accept object or `JSONConfiguration`\n      this.configuration =\n        props.configuration instanceof JSONConfiguration\n          ? props.configuration\n          : new JSONConfiguration(props.configuration);\n    }\n\n    if ('onJSONChange' in props) {\n      this.onJSONChange = props.onJSONChange;\n    }\n  }\n\n  mergeConfiguration(config) {\n    this.configuration.merge(config);\n  }\n\n  convert(json) {\n    // Use shallow equality to ensure we only convert same json once\n    if (!json || json === this.json) {\n      return this.convertedJson;\n    }\n    // Save json for shallow diffing\n    this.json = json;\n\n    // Accept JSON strings by parsing them\n    const parsedJSON = parseJSON(json);\n\n    // Convert the JSON\n    let convertedJson = convertJSON(parsedJSON, this.configuration);\n\n    convertedJson = this.configuration.postProcessConvertedJson(convertedJson);\n\n    this.convertedJson = convertedJson;\n    return convertedJson;\n  }\n\n  // DEPRECATED: Backwards compatibility\n  convertJson(json) {\n    return this.convert(json);\n  }\n}\n\nfunction convertJSON(json, configuration) {\n  // Fixup configuration\n  configuration = new JSONConfiguration(configuration);\n  return convertJSONRecursively(json, '', configuration);\n}\n\n// Converts JSON to props (\"hydrating\" classes, resolving enums and functions etc).\nfunction convertJSONRecursively(json, key, configuration) {\n  if (Array.isArray(json)) {\n    return json.map((element, i) => convertJSONRecursively(element, String(i), configuration));\n  }\n\n  // If object.type is in configuration, instantiate\n  if (isClassInstance(json, configuration)) {\n    return convertClassInstance(json, configuration);\n  }\n\n  if (isObject(json)) {\n    // If object.function is in configuration, convert object to function\n    if (FUNCTION_KEY in json) {\n      return convertFunctionObject(json, configuration);\n    }\n    return convertPlainObject(json, configuration);\n  }\n\n  // Single value\n  if (typeof json === 'string') {\n    return convertString(json, key, configuration);\n  }\n\n  // Return unchanged (number, boolean, ...)\n  return json;\n}\n\n// Returns true if an object has a `type` field\nfunction isClassInstance(json, configuration) {\n  const {typeKey} = configuration;\n  const isClass = isObject(json) && Boolean(json[typeKey]);\n  return isClass;\n}\n\nfunction convertClassInstance(json, configuration) {\n  // Extract the class type field\n  const {typeKey} = configuration;\n  const type = json[typeKey];\n\n  // Prepare a props object and ensure all values have been converted\n  let props = {...json};\n  delete props[typeKey];\n\n  props = convertPlainObject(props, configuration);\n\n  return instantiateClass(type, props, configuration);\n}\n\n// Plain JS object, embed functions.\nfunction convertFunctionObject(json, configuration) {\n  // Extract the target function field\n  const {functionKey} = configuration;\n  const targetFunction = json[functionKey];\n\n  // Prepare a props object and ensure all values have been converted\n  let props = {...json};\n  delete props[functionKey];\n\n  props = convertPlainObject(props, configuration);\n\n  return executeFunction(targetFunction, props, configuration);\n}\n\n// Plain JS object, convert each key and return.\nfunction convertPlainObject(json, configuration) {\n  assert(isObject(json));\n\n  const result = {};\n  for (const key in json) {\n    const value = json[key];\n    result[key] = convertJSONRecursively(value, key, configuration);\n  }\n  return result;\n}\n\n// Convert one string value in an object\n// TODO - We could also support string syntax for hydrating other types, like regexps...\n// But no current use case\nfunction convertString(string, key, configuration) {\n  // Here the JSON value is supposed to be treated as a function\n  if (string.startsWith(FUNCTION_IDENTIFIER) && configuration.convertFunction) {\n    string = string.replace(FUNCTION_IDENTIFIER, '');\n    return configuration.convertFunction(string, configuration);\n  }\n  if (string.startsWith(CONSTANT_IDENTIFIER)) {\n    string = string.replace(CONSTANT_IDENTIFIER, '');\n    if (configuration.constants[string]) {\n      return configuration.constants[string];\n    }\n    // enum\n    const [enumVarName, enumValName] = string.split('.');\n    return configuration.enumerations[enumVarName][enumValName];\n  }\n  return string;\n}\n","// Accept JSON strings by parsing them\n// TODO - use a parser that provides meaninful error messages\nexport default function parseJSON(json) {\n  return typeof json === 'string' ? JSON.parse(json) : json;\n}\n","// This attempts to execute a function\nexport function executeFunction(targetFunction, props, configuration) {\n  // Find the function\n  const matchedFunction = configuration.functions[targetFunction];\n\n  // Check that the function is in the configuration.\n  if (!matchedFunction) {\n    const {log} = configuration; // eslint-disable-line\n    if (log) {\n      const stringProps = JSON.stringify(props, null, 0).slice(0, 40);\n      log.warn(`JSON converter: No registered function ${targetFunction}(${stringProps}...)  `);\n    }\n    return null;\n  }\n\n  return matchedFunction(props);\n}\n","// TODO - can we reuse the core util? Assuming we don't want to export it\n\n/* eslint-disable complexity */\n\n// Compares two objects to see if their keys are shallowly equal\nexport function shallowEqualObjects(a, b) {\n  if (a === b) {\n    return true;\n  }\n\n  if (typeof a !== 'object' || a === null || typeof b !== 'object' || b === null) {\n    return false;\n  }\n\n  if (Object.keys(a).length !== Object.keys(b).length) {\n    return false;\n  }\n\n  for (const key in a) {\n    if (!(key in b) || a[key] !== b[key]) {\n      return false;\n    }\n  }\n  for (const key in b) {\n    if (!(key in a)) {\n      return false;\n    }\n  }\n  return true;\n}\n","// @deck.gl/json: top-level exports\n\n// Generic JSON converter, usable by other wrapper modules\nexport {default as JSONConverter} from './json-converter';\nexport {default as JSONConfiguration} from './json-configuration';\n\n// Transports\nexport {default as Transport} from './transports/transport';\n\n// Helpers\nexport {default as _convertFunctions} from './helpers/convert-functions';\nexport {default as _parseExpressionString} from './helpers/parse-expression-string';\nexport {shallowEqualObjects as _shallowEqualObjects} from './utils/shallow-equal-objects';\n","// Jupyter Widget based Transport implementation\n\nimport {Transport} from '@deck.gl/json';\n\n/**\n * A Transport subclass for communicating with Jupyter kernels\n * via the Jupyter Widget API.\n */\nexport default class JupyterTransport extends Transport {\n  constructor() {\n    super('Jupyter Transport (JavaScript <=> Jupyter Kernel)');\n    this.jupyterModel = null; // Set manually by the Jupyter Widget View\n    this.jupyterView = null; // Set manually by the Jupyter Widget View\n  }\n\n  getRootDOMElement() {\n    return this.jupyterView.el;\n  }\n\n  /**\n   * back-channel messaging for event handling etc\n   */\n  sendJSONMessage(type, data) {\n    const string = Transport._stringifyJSONSafe({type, data});\n    this.jupyterModel.send(string);\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\nimport Layer, {UpdateParameters} from './layer';\nimport debug from '../debug';\nimport {flatten} from '../utils/flatten';\n\nimport type AttributeManager from './attribute/attribute-manager';\nimport type {PickingInfo, GetPickingInfoParams} from './picking/pick-info';\nimport type {FilterContext} from '../passes/layers-pass';\nimport type {LayersList, LayerContext} from './layer-manager';\nimport type {CompositeLayerProps, Accessor, AccessorContext} from '../types/layer-props';\nimport {ConstructorOf} from '../types/types';\n\nconst TRACE_RENDER_LAYERS = 'compositeLayer.renderLayers';\n\nexport default abstract class CompositeLayer<PropsT = {}> extends Layer<\n  PropsT & Required<CompositeLayerProps>\n> {\n  static layerName: string = 'CompositeLayer';\n\n  /** `true` if this layer renders other layers */\n  get isComposite(): boolean {\n    return true;\n  }\n\n  /** Returns true if all async resources are loaded */\n  get isLoaded(): boolean {\n    return super.isLoaded && this.getSubLayers().every(layer => layer.isLoaded);\n  }\n\n  /** Return last rendered sub layers */\n  getSubLayers(): Layer[] {\n    return (this.internalState && this.internalState.subLayers) || [];\n  }\n\n  // initializeState is usually not needed for composite layers\n  // Provide empty definition to disable check for missing definition\n  // eslint-disable-next-line @typescript-eslint/no-empty-function\n  initializeState(context: LayerContext): void {}\n\n  /** Updates selected state members and marks the composite layer to need rerender */\n  setState(updateObject: any): void {\n    super.setState(updateObject);\n    // Trigger a layer update\n    // Although conceptually layer.draw and compositeLayer.renderLayers are equivalent,\n    // they are executed during different lifecycles.\n    // draw can be called without calling updateState (e.g. most viewport changes),\n    // while renderLayers can only be called during a recursive layer update.\n    this.setNeedsUpdate();\n  }\n\n  /** called to augment the info object that is bubbled up from a sublayer\n      override Layer.getPickingInfo() because decoding / setting uniform do\n      not apply to a composite layer. */\n  getPickingInfo({info}: GetPickingInfoParams): PickingInfo {\n    const {object} = info;\n    const isDataWrapped =\n      object && object.__source && object.__source.parent && object.__source.parent.id === this.id;\n\n    if (!isDataWrapped) {\n      return info;\n    }\n\n    // override object with picked data\n    info.object = object.__source.object;\n    info.index = object.__source.index;\n\n    return info;\n  }\n\n  // Implement to generate subLayers\n  abstract renderLayers(): Layer | null | LayersList;\n\n  /**\n   * Filters sub layers at draw time. Return true if the sub layer should be drawn.\n   */\n  filterSubLayer(context: FilterContext): boolean {\n    return true;\n  }\n\n  /** Returns true if sub layer needs to be rendered */\n  protected shouldRenderSubLayer(subLayerId: string, data: any): boolean {\n    return data && data.length;\n  }\n\n  /** Returns sub layer class for a specific sublayer */\n  protected getSubLayerClass<T extends Layer>(\n    subLayerId: string,\n    DefaultLayerClass: ConstructorOf<T>\n  ): ConstructorOf<T> {\n    const {_subLayerProps: overridingProps} = this.props;\n\n    return (\n      (overridingProps &&\n        overridingProps[subLayerId] &&\n        (overridingProps[subLayerId].type as ConstructorOf<T>)) ||\n      DefaultLayerClass\n    );\n  }\n\n  /** When casting user data into another format to pass to sublayers,\n      add reference to the original object and object index */\n  protected getSubLayerRow<T>(row: T, sourceObject: any, sourceObjectIndex: number): T {\n    // @ts-ignore (TS2339) adding undefined property\n    row.__source = {\n      parent: this,\n      object: sourceObject,\n      index: sourceObjectIndex\n    };\n    return row;\n  }\n\n  /** Some composite layers cast user data into another format before passing to sublayers\n    We need to unwrap them before calling the accessor so that they see the original data\n    objects */\n  protected getSubLayerAccessor<In, Out>(accessor: Accessor<In, Out>): Accessor<In, Out> {\n    if (typeof accessor === 'function') {\n      const objectInfo: AccessorContext<In> = {\n        index: -1,\n        // @ts-ignore accessing resolved data\n        data: this.props.data,\n        target: []\n      };\n      return (x: any, i: AccessorContext<In>) => {\n        if (x && x.__source) {\n          objectInfo.index = x.__source.index;\n          // @ts-ignore (TS2349) Out is never a function\n          return accessor(x.__source.object as In, objectInfo);\n        }\n        // @ts-ignore (TS2349) Out is never a function\n        return accessor(x as In, i);\n      };\n    }\n    return accessor;\n  }\n\n  // eslint-disable-next-line complexity\n  /** Returns sub layer props for a specific sublayer */\n  protected getSubLayerProps(\n    sublayerProps: {\n      id?: string;\n      updateTriggers?: Record<string, any>;\n      [propName: string]: any;\n    } = {}\n  ): any {\n    const {\n      opacity,\n      pickable,\n      visible,\n      parameters,\n      getPolygonOffset,\n      highlightedObjectIndex,\n      autoHighlight,\n      highlightColor,\n      coordinateSystem,\n      coordinateOrigin,\n      wrapLongitude,\n      positionFormat,\n      modelMatrix,\n      extensions,\n      fetch,\n      operation,\n      _subLayerProps: overridingProps\n    } = this.props;\n    const newProps = {\n      id: '',\n      updateTriggers: {},\n      opacity,\n      pickable,\n      visible,\n      parameters,\n      getPolygonOffset,\n      highlightedObjectIndex,\n      autoHighlight,\n      highlightColor,\n      coordinateSystem,\n      coordinateOrigin,\n      wrapLongitude,\n      positionFormat,\n      modelMatrix,\n      extensions,\n      fetch,\n      operation\n    };\n\n    const overridingSublayerProps =\n      overridingProps && sublayerProps.id && overridingProps[sublayerProps.id];\n    const overridingSublayerTriggers =\n      overridingSublayerProps && overridingSublayerProps.updateTriggers;\n    const sublayerId = sublayerProps.id || 'sublayer';\n\n    if (overridingSublayerProps) {\n      // @ts-ignore (TS2339) hidden property\n      const propTypes = this.constructor._propTypes;\n      const subLayerPropTypes = sublayerProps.type ? sublayerProps.type._propTypes : {};\n      for (const key in overridingSublayerProps) {\n        const propType = subLayerPropTypes[key] || propTypes[key];\n        // eslint-disable-next-line\n        if (propType && propType.type === 'accessor') {\n          overridingSublayerProps[key] = this.getSubLayerAccessor(overridingSublayerProps[key]);\n        }\n      }\n    }\n\n    Object.assign(\n      newProps,\n      sublayerProps,\n      // experimental feature that allows users to override sublayer props via parent layer prop\n      overridingSublayerProps\n    );\n    newProps.id = `${this.props.id}-${sublayerId}`;\n    newProps.updateTriggers = {\n      all: this.props.updateTriggers?.all,\n      ...sublayerProps.updateTriggers,\n      ...overridingSublayerTriggers\n    };\n\n    // Pass through extension props\n    // @ts-ignore (TS2532) extensions is always defined after merging with default props\n    for (const extension of extensions) {\n      const passThroughProps = extension.getSubLayerProps.call(this, extension);\n      if (passThroughProps) {\n        Object.assign(newProps, passThroughProps, {\n          updateTriggers: Object.assign(newProps.updateTriggers, passThroughProps.updateTriggers)\n        });\n      }\n    }\n\n    return newProps;\n  }\n\n  /** Update sub layers to highlight the hovered object */\n  protected _updateAutoHighlight(info: PickingInfo): void {\n    for (const layer of this.getSubLayers()) {\n      layer.updateAutoHighlight(info);\n    }\n  }\n\n  /** Override base Layer method */\n  protected _getAttributeManager(): AttributeManager | null {\n    return null;\n  }\n\n  /** (Internal) Called after an update to rerender sub layers */\n  protected _postUpdate(updateParams: UpdateParameters<this>, forceUpdate: boolean) {\n    // @ts-ignore (TS2531) this method is only called internally when internalState is defined\n    let subLayers = this.internalState.subLayers as Layer[];\n    const shouldUpdate = !subLayers || this.needsUpdate();\n    if (shouldUpdate) {\n      const subLayersList = this.renderLayers();\n      // Flatten the returned array, removing any null, undefined or false\n      // this allows layers to render sublayers conditionally\n      // (see CompositeLayer.renderLayers docs)\n      subLayers = flatten(subLayersList, Boolean) as Layer[];\n      // @ts-ignore (TS2531) this method is only called internally when internalState is defined\n      this.internalState.subLayers = subLayers;\n    }\n    debug(TRACE_RENDER_LAYERS, this, shouldUpdate, subLayers);\n\n    // populate reference to parent layer (this layer)\n    // NOTE: needs to be done even when reusing layers as the parent may have changed\n    for (const layer of subLayers) {\n      layer.parent = this;\n    }\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {deepEqual} from '../utils/deep-equal';\nimport log from '../utils/log';\nimport {flatten} from '../utils/flatten';\n\nimport type Controller from '../controllers/controller';\nimport type {ViewStateChangeParameters, InteractionState} from '../controllers/controller';\nimport type Viewport from '../viewports/viewport';\nimport type View from '../views/view';\nimport type {Timeline} from '@luma.gl/engine';\nimport type {EventManager} from 'mjolnir.js';\nimport type {ConstructorOf} from '../types/types';\n\nexport default class ViewManager {\n  width: number;\n  height: number;\n  views: View[];\n  viewState: any;\n  controllers: {[viewId: string]: Controller<any> | null};\n  timeline: Timeline;\n\n  private _viewports: Viewport[];\n  private _viewportMap: {[viewId: string]: Viewport};\n  private _isUpdating: boolean;\n  private _needsRedraw: string | false;\n  private _needsUpdate: string | false;\n  private _eventManager: EventManager;\n  private _eventCallbacks: {\n    onViewStateChange?: (params: ViewStateChangeParameters & {viewId: string}) => void;\n    onInteractionStateChange?: (state: InteractionState) => void;\n  };\n\n  constructor(props: {\n    // Initial options\n    timeline: Timeline;\n    eventManager: EventManager;\n    onViewStateChange?: (params: ViewStateChangeParameters & {viewId: string}) => void;\n    onInteractionStateChange?: (state: InteractionState) => void;\n    // Props\n    views?: View[];\n    viewState?: any;\n    width?: number;\n    height?: number;\n  }) {\n    // List of view descriptors, gets re-evaluated when width/height changes\n    this.views = [];\n    this.width = 100;\n    this.height = 100;\n    this.viewState = {};\n    this.controllers = {};\n    this.timeline = props.timeline;\n\n    this._viewports = []; // Generated viewports\n    this._viewportMap = {};\n    this._isUpdating = false;\n    this._needsRedraw = 'First render';\n    this._needsUpdate = 'Initialize';\n\n    this._eventManager = props.eventManager;\n    this._eventCallbacks = {\n      onViewStateChange: props.onViewStateChange,\n      onInteractionStateChange: props.onInteractionStateChange\n    };\n\n    Object.seal(this);\n\n    // Init with default map viewport\n    this.setProps(props);\n  }\n\n  /** Remove all resources and event listeners */\n  finalize(): void {\n    for (const key in this.controllers) {\n      const controller = this.controllers[key];\n      if (controller) {\n        controller.finalize();\n      }\n    }\n    this.controllers = {};\n  }\n\n  /** Check if a redraw is needed */\n  needsRedraw(\n    opts: {\n      /** Reset redraw flags to false */\n      clearRedrawFlags?: boolean;\n    } = {clearRedrawFlags: false}\n  ): string | false {\n    const redraw = this._needsRedraw;\n    if (opts.clearRedrawFlags) {\n      this._needsRedraw = false;\n    }\n    return redraw;\n  }\n\n  /** Mark the manager as dirty. Will rebuild all viewports and update controllers. */\n  setNeedsUpdate(reason: string): void {\n    this._needsUpdate = this._needsUpdate || reason;\n    this._needsRedraw = this._needsRedraw || reason;\n  }\n\n  /** Checks each viewport for transition updates */\n  updateViewStates(): void {\n    for (const viewId in this.controllers) {\n      const controller = this.controllers[viewId];\n      if (controller) {\n        controller.updateTransition();\n      }\n    }\n  }\n\n  /** Get a set of viewports for a given width and height\n   * TODO - Intention is for deck.gl to autodeduce width and height and drop the need for props\n   * @param rect (object, optional) - filter the viewports\n   *   + not provided - return all viewports\n   *   + {x, y} - only return viewports that contain this pixel\n   *   + {x, y, width, height} - only return viewports that overlap with this rectangle\n   */\n  getViewports(rect?: {x: number; y: number; width?: number; height?: number}): Viewport[] {\n    if (rect) {\n      return this._viewports.filter(viewport => viewport.containsPixel(rect));\n    }\n    return this._viewports;\n  }\n\n  /** Get a map of all views */\n  getViews(): {[viewId: string]: View} {\n    const viewMap = {};\n    this.views.forEach(view => {\n      viewMap[view.id] = view;\n    });\n    return viewMap;\n  }\n\n  /** Resolves a viewId string to a View */\n  getView(viewId: string): View | undefined {\n    return this.views.find(view => view.id === viewId);\n  }\n\n  /** Returns the viewState for a specific viewId. Matches the viewState by\n    1. view.viewStateId\n    2. view.id\n    3. root viewState\n    then applies the view's filter if any */\n  getViewState(viewOrViewId: string | View): any {\n    const view: View | undefined =\n      typeof viewOrViewId === 'string' ? this.getView(viewOrViewId) : viewOrViewId;\n    // Backward compatibility: view state for single view\n    const viewState = (view && this.viewState[view.getViewStateId()]) || this.viewState;\n    return view ? view.filterViewState(viewState) : viewState;\n  }\n\n  getViewport(viewId: string): Viewport | undefined {\n    return this._viewportMap[viewId];\n  }\n\n  /**\n   * Unproject pixel coordinates on screen onto world coordinates,\n   * (possibly [lon, lat]) on map.\n   * - [x, y] => [lng, lat]\n   * - [x, y, z] => [lng, lat, Z]\n   * @param {Array} xyz -\n   * @param {Object} opts - options\n   * @param {Object} opts.topLeft=true - Whether origin is top left\n   * @return {Array|null} - [lng, lat, Z] or [X, Y, Z]\n   */\n  unproject(xyz: number[], opts?: {topLeft?: boolean}): number[] | null {\n    const viewports = this.getViewports();\n    const pixel = {x: xyz[0], y: xyz[1]};\n    for (let i = viewports.length - 1; i >= 0; --i) {\n      const viewport = viewports[i];\n      if (viewport.containsPixel(pixel)) {\n        const p = xyz.slice();\n        p[0] -= viewport.x;\n        p[1] -= viewport.y;\n        return viewport.unproject(p, opts);\n      }\n    }\n    return null;\n  }\n\n  /** Update the manager with new Deck props */\n  setProps(props: {views?: View[]; viewState?: any; width?: number; height?: number}) {\n    if (props.views) {\n      this._setViews(props.views);\n    }\n\n    if (props.viewState) {\n      this._setViewState(props.viewState);\n    }\n\n    if ('width' in props || 'height' in props) {\n      this._setSize(props.width as number, props.height as number);\n    }\n\n    // Important: avoid invoking _update() inside itself\n    // Nested updates result in unexpected side effects inside _rebuildViewports()\n    // when using auto control in pure-js\n    if (!this._isUpdating) {\n      this._update();\n    }\n  }\n\n  //\n  // PRIVATE METHODS\n  //\n\n  private _update(): void {\n    this._isUpdating = true;\n\n    // Only rebuild viewports if the update flag is set\n    if (this._needsUpdate) {\n      this._needsUpdate = false;\n      this._rebuildViewports();\n    }\n\n    // If viewport transition(s) are triggered during viewports update, controller(s)\n    // will immediately call `onViewStateChange` which calls `viewManager.setProps` again.\n    if (this._needsUpdate) {\n      this._needsUpdate = false;\n      this._rebuildViewports();\n    }\n\n    this._isUpdating = false;\n  }\n\n  private _setSize(width: number, height: number): void {\n    if (width !== this.width || height !== this.height) {\n      this.width = width;\n      this.height = height;\n      this.setNeedsUpdate('Size changed');\n    }\n  }\n\n  // Update the view descriptor list and set change flag if needed\n  // Does not actually rebuild the `Viewport`s until `getViewports` is called\n  private _setViews(views: View[]): void {\n    views = flatten(views, Boolean);\n\n    const viewsChanged = this._diffViews(views, this.views);\n    if (viewsChanged) {\n      this.setNeedsUpdate('views changed');\n    }\n\n    this.views = views;\n  }\n\n  private _setViewState(viewState: any): void {\n    if (viewState) {\n      const viewStateChanged = !deepEqual(viewState, this.viewState);\n\n      if (viewStateChanged) {\n        this.setNeedsUpdate('viewState changed');\n      }\n\n      this.viewState = viewState;\n    } else {\n      log.warn('missing `viewState` or `initialViewState`')();\n    }\n  }\n\n  private _onViewStateChange(viewId: string, event: ViewStateChangeParameters) {\n    if (this._eventCallbacks.onViewStateChange) {\n      this._eventCallbacks.onViewStateChange({...event, viewId});\n    }\n  }\n\n  private _createController(\n    view: View,\n    props: {id: string; type: ConstructorOf<Controller<any>>}\n  ): Controller<any> {\n    const Controller = props.type;\n\n    const controller = new Controller({\n      timeline: this.timeline,\n      eventManager: this._eventManager,\n      // Set an internal callback that calls the prop callback if provided\n      onViewStateChange: this._onViewStateChange.bind(this, props.id),\n      onStateChange: this._eventCallbacks.onInteractionStateChange,\n      makeViewport: viewState =>\n        this.getView(view.id)?.makeViewport({\n          viewState,\n          width: this.width,\n          height: this.height\n        })\n    });\n\n    return controller;\n  }\n\n  private _updateController(\n    view: View,\n    viewState: any,\n    viewport: Viewport,\n    controller?: Controller<any> | null\n  ): Controller<any> | null {\n    const controllerProps = view.controller;\n    if (controllerProps) {\n      const resolvedProps = {\n        ...viewState,\n        ...controllerProps,\n        id: view.id,\n        x: viewport.x,\n        y: viewport.y,\n        width: viewport.width,\n        height: viewport.height\n      };\n\n      // TODO - check if view / controller type has changed, and replace the controller\n      if (!controller) {\n        controller = this._createController(view, resolvedProps);\n      }\n      if (controller) {\n        controller.setProps(resolvedProps);\n      }\n      return controller;\n    }\n    return null;\n  }\n\n  // Rebuilds viewports from descriptors towards a certain window size\n  private _rebuildViewports(): void {\n    const {views} = this;\n\n    const oldControllers = this.controllers;\n    this._viewports = [];\n    this.controllers = {};\n\n    let invalidateControllers = false;\n    // Create controllers in reverse order, so that views on top receive events first\n    for (let i = views.length; i--; ) {\n      const view = views[i];\n      const viewState = this.getViewState(view);\n      const viewport = view.makeViewport({viewState, width: this.width, height: this.height});\n\n      let oldController = oldControllers[view.id];\n      const hasController = Boolean(view.controller);\n      if (hasController && !oldController) {\n        // When a new controller is added, invalidate all controllers below it so that\n        // events are registered in the correct order\n        invalidateControllers = true;\n      }\n      if ((invalidateControllers || !hasController) && oldController) {\n        // Remove and reattach invalidated controller\n        oldController.finalize();\n        oldController = null;\n      }\n\n      // Update the controller\n      this.controllers[view.id] = this._updateController(view, viewState, viewport, oldController);\n\n      this._viewports.unshift(viewport);\n    }\n\n    // Remove unused controllers\n    for (const id in oldControllers) {\n      const oldController = oldControllers[id];\n      if (oldController && !this.controllers[id]) {\n        oldController.finalize();\n      }\n    }\n\n    this._buildViewportMap();\n  }\n\n  _buildViewportMap(): void {\n    // Build a view id to view index\n    this._viewportMap = {};\n    this._viewports.forEach(viewport => {\n      if (viewport.id) {\n        // TODO - issue warning if multiple viewports use same id\n        this._viewportMap[viewport.id] = this._viewportMap[viewport.id] || viewport;\n      }\n    });\n  }\n\n  // Check if viewport array has changed, returns true if any change\n  // Note that descriptors can be the same\n  _diffViews(newViews: View[], oldViews: View[]): boolean {\n    if (newViews.length !== oldViews.length) {\n      return true;\n    }\n\n    return newViews.some((_, i) => !newViews[i].equals(oldViews[i]));\n  }\n}\n","import {Framebuffer, Texture2D, withParameters} from '@luma.gl/core';\nimport {OPERATION} from '../lib/constants';\nimport LayersPass from './layers-pass';\n\nimport type {LayersPassRenderOptions} from './layers-pass';\n\ntype MaskPassRenderOptions = LayersPassRenderOptions & {\n  /** The channel to render into, 0:red, 1:green, 2:blue, 3:alpha */\n  channel: number;\n};\n\nexport default class MaskPass extends LayersPass {\n  maskMap: Texture2D;\n  fbo: Framebuffer;\n\n  constructor(gl, props: {id: string; mapSize?: number}) {\n    super(gl, props);\n\n    const {mapSize = 2048} = props;\n\n    this.maskMap = new Texture2D(gl, {\n      width: mapSize,\n      height: mapSize,\n      parameters: {\n        [gl.TEXTURE_MIN_FILTER]: gl.LINEAR,\n        [gl.TEXTURE_MAG_FILTER]: gl.LINEAR,\n        [gl.TEXTURE_WRAP_S]: gl.CLAMP_TO_EDGE,\n        [gl.TEXTURE_WRAP_T]: gl.CLAMP_TO_EDGE\n      }\n    });\n\n    this.fbo = new Framebuffer(gl, {\n      id: 'maskmap',\n      width: mapSize,\n      height: mapSize,\n      attachments: {\n        [gl.COLOR_ATTACHMENT0]: this.maskMap\n      }\n    });\n  }\n\n  render(options: MaskPassRenderOptions) {\n    const gl = this.gl;\n\n    const colorMask = [false, false, false, false];\n    colorMask[options.channel] = true;\n\n    return withParameters(\n      gl,\n      {\n        clearColor: [255, 255, 255, 255],\n        blend: true,\n        blendFunc: [gl.ZERO, gl.ONE],\n        blendEquation: gl.FUNC_SUBTRACT,\n        colorMask,\n        depthTest: false\n      },\n      () => super.render({...options, target: this.fbo, pass: 'mask'})\n    );\n  }\n\n  shouldDrawLayer(layer) {\n    return layer.props.operation === OPERATION.MASK;\n  }\n\n  delete() {\n    this.fbo.delete();\n    this.maskMap.delete();\n  }\n}\n","import {Texture2D} from '@luma.gl/core';\n// import {readPixelsToArray} from '@luma.gl/core';\nimport {equals} from '@math.gl/core';\nimport MaskPass from '../../passes/mask-pass';\nimport {OPERATION} from '../../lib/constants';\nimport {getMaskBounds, getMaskViewport} from './utils';\nimport log from '../../utils/log';\n\nimport type {Effect, PreRenderOptions} from '../../lib/effect';\nimport type Layer from '../../lib/layer';\nimport type Viewport from '../../viewports/viewport';\nimport type {MaskBounds} from './utils';\nimport type {CoordinateSystem} from '../../lib/constants';\n\ntype Mask = {\n  /** The channel index */\n  index: number;\n  bounds: MaskBounds;\n  coordinateOrigin: [number, number, number];\n  coordinateSystem: CoordinateSystem;\n};\n\ntype Channel = {\n  id: string;\n  index: number;\n  layers: Layer[];\n  bounds: MaskBounds;\n  maskBounds: MaskBounds;\n  layerBounds: MaskBounds[];\n  coordinateOrigin: [number, number, number];\n  coordinateSystem: CoordinateSystem;\n};\n\n// Class to manage mask effect\nexport default class MaskEffect implements Effect {\n  id = 'mask-effect';\n  props = null;\n  useInPicking = true;\n\n  private dummyMaskMap?: Texture2D;\n  private channels: (Channel | null)[] = [];\n  private masks: Record<string, Mask> | null = null;\n  private maskPass?: MaskPass;\n  private maskMap?: Texture2D;\n  private lastViewport?: Viewport;\n\n  preRender(\n    gl: WebGLRenderingContext,\n    {layers, layerFilter, viewports, onViewportActive, views}: PreRenderOptions\n  ): void {\n    if (!this.dummyMaskMap) {\n      this.dummyMaskMap = new Texture2D(gl, {\n        width: 1,\n        height: 1\n      });\n    }\n\n    const maskLayers = layers.filter(l => l.props.visible && l.props.operation === OPERATION.MASK);\n    if (maskLayers.length === 0) {\n      this.masks = null;\n      this.channels.length = 0;\n      return;\n    }\n    this.masks = {};\n\n    if (!this.maskPass) {\n      this.maskPass = new MaskPass(gl, {id: 'default-mask'});\n      this.maskMap = this.maskPass.maskMap;\n    }\n\n    // Map layers to channels\n    const channelMap = this._sortMaskChannels(maskLayers);\n    // TODO - support multiple views\n    const viewport = viewports[0];\n    const viewportChanged = !this.lastViewport || !this.lastViewport.equals(viewport);\n\n    for (const maskId in channelMap) {\n      this._renderChannel(channelMap[maskId], {\n        layerFilter,\n        onViewportActive,\n        views,\n        viewport,\n        viewportChanged\n      });\n    }\n\n    // // Debug show FBO contents on screen\n    // const color = readPixelsToArray(this.maskMap);\n    // let canvas = document.getElementById('fbo-canvas');\n    // if (!canvas) {\n    //   canvas = document.createElement('canvas');\n    //   canvas.id = 'fbo-canvas';\n    //   canvas.width = this.maskMap.width;\n    //   canvas.height = this.maskMap.height;\n    //   canvas.style.zIndex = 100;\n    //   canvas.style.position = 'absolute';\n    //   canvas.style.right = 0;\n    //   canvas.style.border = 'blue 1px solid';\n    //   canvas.style.width = '256px';\n    //   canvas.style.transform = 'scaleY(-1)';\n    //   document.body.appendChild(canvas);\n    // }\n    // const ctx = canvas.getContext('2d');\n    // const imageData = ctx.createImageData(this.maskMap.width, this.maskMap.height);\n    // for (let i = 0; i < color.length; i += 4) {\n    //   imageData.data[i + 0] = color[i + 0];\n    //   imageData.data[i + 1] = color[i + 1];\n    //   imageData.data[i + 2] = color[i + 2];\n    //   imageData.data[i + 3] = color[i + 3] + 128;\n    // }\n    // ctx.putImageData(imageData, 0, 0);\n  }\n\n  private _renderChannel(\n    channelInfo: Channel,\n    {\n      layerFilter,\n      onViewportActive,\n      views,\n      viewport,\n      viewportChanged\n    }: {\n      layerFilter: PreRenderOptions['layerFilter'];\n      onViewportActive: PreRenderOptions['onViewportActive'];\n      views: PreRenderOptions['views'];\n      viewport: Viewport;\n      viewportChanged: boolean;\n    }\n  ) {\n    const oldChannelInfo = this.channels[channelInfo.index];\n    if (!oldChannelInfo) {\n      return;\n    }\n\n    const maskChanged =\n      // If a channel is new\n      channelInfo === oldChannelInfo ||\n      // If sublayers have changed\n      oldChannelInfo.layers.length !== channelInfo.layers.length ||\n      // If a sublayer's positions have been updated, the cached bounds will change shallowly\n      channelInfo.layerBounds.some((b, i) => b !== oldChannelInfo.layerBounds[i]);\n\n    channelInfo.bounds = oldChannelInfo.bounds;\n    channelInfo.maskBounds = oldChannelInfo.maskBounds;\n    this.channels[channelInfo.index] = channelInfo;\n\n    if (maskChanged || viewportChanged) {\n      // Recalculate mask bounds\n      this.lastViewport = viewport;\n\n      channelInfo.bounds = getMaskBounds({layers: channelInfo.layers, viewport});\n\n      if (maskChanged || !equals(channelInfo.bounds, oldChannelInfo.bounds)) {\n        // Rerender mask FBO\n        const {maskPass, maskMap} = this;\n\n        const maskViewport = getMaskViewport({\n          bounds: channelInfo.bounds,\n          viewport,\n          width: maskMap.width,\n          height: maskMap.height\n        });\n\n        channelInfo.maskBounds = maskViewport ? maskViewport.getBounds() : [0, 0, 1, 1];\n\n        // @ts-ignore (2532) This method is only called from preRender where maskPass is defined\n        maskPass.render({\n          pass: 'mask',\n          channel: channelInfo.index,\n          layers: channelInfo.layers,\n          layerFilter,\n          viewports: maskViewport ? [maskViewport] : [],\n          onViewportActive,\n          views,\n          moduleParameters: {\n            devicePixelRatio: 1\n          }\n        });\n      }\n    }\n\n    // @ts-ignore (2532) This method is only called from preRender where masks is defined\n    this.masks[channelInfo.id] = {\n      index: channelInfo.index,\n      bounds: channelInfo.maskBounds,\n      coordinateOrigin: channelInfo.coordinateOrigin,\n      coordinateSystem: channelInfo.coordinateSystem\n    };\n  }\n\n  /**\n   * Find a channel to render each mask into\n   * If a maskId already exists, diff and update the existing channel\n   * Otherwise replace a removed mask\n   * Otherwise create a new channel\n   * Returns a map from mask layer id to channel info\n   */\n  private _sortMaskChannels(maskLayers: Layer[]): Record<string, Channel> {\n    const channelMap = {};\n    let channelCount = 0;\n    for (const layer of maskLayers) {\n      const {id} = layer.root;\n      let channelInfo = channelMap[id];\n      if (!channelInfo) {\n        if (++channelCount > 4) {\n          log.warn('Too many mask layers. The max supported is 4')();\n          continue; // eslint-disable-line no-continue\n        }\n        channelInfo = {\n          id,\n          index: this.channels.findIndex(c => c?.id === id),\n          layers: [],\n          layerBounds: [],\n          coordinateOrigin: layer.root.props.coordinateOrigin,\n          coordinateSystem: layer.root.props.coordinateSystem\n        };\n        channelMap[id] = channelInfo;\n      }\n      channelInfo.layers.push(layer);\n      channelInfo.layerBounds.push(layer.getBounds());\n    }\n\n    for (let i = 0; i < 4; i++) {\n      const channelInfo = this.channels[i];\n      if (!channelInfo || !(channelInfo.id in channelMap)) {\n        // The mask id at this channel no longer exists\n        this.channels[i] = null;\n      }\n    }\n\n    for (const maskId in channelMap) {\n      const channelInfo = channelMap[maskId];\n\n      if (channelInfo.index < 0) {\n        channelInfo.index = this.channels.findIndex(c => !c);\n        this.channels[channelInfo.index] = channelInfo;\n      }\n    }\n    return channelMap;\n  }\n\n  getModuleParameters(): {\n    maskMap: Texture2D;\n    maskChannels: Record<string, Mask> | null;\n  } {\n    return {\n      maskMap: this.masks ? this.maskMap : this.dummyMaskMap,\n      maskChannels: this.masks\n    };\n  }\n\n  cleanup(): void {\n    if (this.dummyMaskMap) {\n      this.dummyMaskMap.delete();\n      this.dummyMaskMap = undefined;\n    }\n\n    if (this.maskPass) {\n      this.maskPass.delete();\n      this.maskPass = undefined;\n      this.maskMap = undefined;\n    }\n\n    this.lastViewport = undefined;\n    this.masks = null;\n    this.channels.length = 0;\n  }\n}\n","import log from '../../utils/log';\nimport OrthographicView from '../../views/orthographic-view';\nimport WebMercatorViewport from '../../viewports/web-mercator-viewport';\nimport {fitBounds} from '@math.gl/web-mercator';\n\nimport type Layer from '../../lib/layer';\nimport type Viewport from '../../viewports/viewport';\n\nexport type MaskBounds = [number, number, number, number];\n\n/*\n * Compute the bounds of the mask in world space, such that it covers an\n * area currently visible (extended by a buffer) or the area of the masking\n * data, whichever is smaller\n */\nexport function getMaskBounds({\n  layers,\n  viewport\n}: {\n  layers: Layer[];\n  viewport: Viewport;\n}): MaskBounds {\n  // Join the bounds of layer data\n  let bounds: MaskBounds | null = null;\n  for (const layer of layers) {\n    const subLayerBounds = layer.getBounds();\n    if (subLayerBounds) {\n      if (bounds) {\n        bounds[0] = Math.min(bounds[0], subLayerBounds[0][0]);\n        bounds[1] = Math.min(bounds[1], subLayerBounds[0][1]);\n        bounds[2] = Math.max(bounds[2], subLayerBounds[1][0]);\n        bounds[3] = Math.max(bounds[3], subLayerBounds[1][1]);\n      } else {\n        bounds = [\n          subLayerBounds[0][0],\n          subLayerBounds[0][1],\n          subLayerBounds[1][0],\n          subLayerBounds[1][1]\n        ];\n      }\n    }\n  }\n  const viewportBounds = viewport.getBounds();\n  if (!bounds) {\n    return viewportBounds;\n  }\n\n  // Expand viewport bounds by 2X. Heurestically chosen to avoid masking\n  // errors when mask is partially out of view\n  const paddedBounds = _doubleBounds(viewportBounds);\n\n  // When bounds of the mask are smaller than the viewport bounds simply use\n  // mask bounds, so as to maximize resolution & avoid mask rerenders\n  if (\n    bounds[2] - bounds[0] < paddedBounds[2] - paddedBounds[0] ||\n    bounds[3] - bounds[1] < paddedBounds[3] - paddedBounds[1]\n  ) {\n    return bounds;\n  }\n\n  // As viewport shrinks, to avoid pixelation along mask edges\n  // we need to reduce the bounds and only render the visible portion\n  // of the mask.\n  // We pad the viewport bounds to capture the section\n  // of the mask just outside the viewport to correctly maskByInstance.\n  // Intersect mask & padded viewport bounds\n  bounds[0] = Math.max(bounds[0], paddedBounds[0]);\n  bounds[1] = Math.max(bounds[1], paddedBounds[1]);\n  bounds[2] = Math.min(bounds[2], paddedBounds[2]);\n  bounds[3] = Math.min(bounds[3], paddedBounds[3]);\n  return bounds;\n}\n\n/*\n * Compute viewport to render the mask into, covering the given bounds\n */\nexport function getMaskViewport({\n  bounds,\n  viewport,\n  width,\n  height\n}: {\n  bounds: MaskBounds;\n  viewport: Viewport;\n  width: number;\n  height: number;\n}): Viewport | null {\n  if (bounds[2] <= bounds[0] || bounds[3] <= bounds[1]) {\n    return null;\n  }\n\n  if (viewport.resolution !== undefined) {\n    log.warn('MaskExtension is not supported in GlobeView')();\n    return null;\n  }\n\n  // Single pixel border to prevent mask bleeding at edge of texture\n  const padding = 1;\n  width -= padding * 2;\n  height -= padding * 2;\n\n  if (viewport.isGeospatial) {\n    const {longitude, latitude, zoom} = fitBounds({\n      width,\n      height,\n      bounds: [\n        [bounds[0], bounds[1]],\n        [bounds[2], bounds[3]]\n      ],\n      maxZoom: 20\n    });\n    return new WebMercatorViewport({\n      longitude,\n      latitude,\n      zoom,\n      x: padding,\n      y: padding,\n      width,\n      height\n    });\n  }\n\n  const center = [(bounds[0] + bounds[2]) / 2, (bounds[1] + bounds[3]) / 2, 0];\n  const scale = Math.min(\n    1048576, // maxZoom of 20: Math.pow(2, 20) = 1048576\n    width / (bounds[2] - bounds[0]),\n    height / (bounds[3] - bounds[1])\n  );\n\n  return new OrthographicView({\n    x: padding,\n    y: padding\n  }).makeViewport({\n    width,\n    height,\n    viewState: {\n      target: center,\n      zoom: Math.log2(scale)\n    }\n  });\n}\n\nfunction _doubleBounds(bounds: MaskBounds): MaskBounds {\n  const size = {\n    x: bounds[2] - bounds[0],\n    y: bounds[3] - bounds[1]\n  };\n  const center = {\n    x: bounds[0] + 0.5 * size.x,\n    y: bounds[1] + 0.5 * size.y\n  };\n  return [center.x - size.x, center.y - size.y, center.x + size.x, center.y + size.y];\n}\n","import {deepEqual} from '../utils/deep-equal';\nimport LightingEffect from '../effects/lighting/lighting-effect';\nimport MaskEffect from '../effects/mask/mask-effect';\nimport type {Effect} from './effect';\n\nconst DEFAULT_LIGHTING_EFFECT = new LightingEffect();\n\nexport default class EffectManager {\n  effects: Effect[];\n  _internalEffects: Effect[];\n  _needsRedraw: false | string;\n\n  constructor() {\n    this.effects = [];\n    this._internalEffects = [];\n    this._needsRedraw = 'Initial render';\n    this.setEffects();\n  }\n\n  setProps(props) {\n    if ('effects' in props) {\n      if (props.effects.length !== this.effects.length || !deepEqual(props.effects, this.effects)) {\n        this.setEffects(props.effects);\n        this._needsRedraw = 'effects changed';\n      }\n    }\n  }\n\n  needsRedraw(opts = {clearRedrawFlags: false}): false | string {\n    const redraw = this._needsRedraw;\n    if (opts.clearRedrawFlags) {\n      this._needsRedraw = false;\n    }\n    return redraw;\n  }\n\n  getEffects() {\n    return this._internalEffects;\n  }\n\n  finalize() {\n    this.cleanup();\n  }\n\n  // Private\n  setEffects(effects: Effect[] = []) {\n    this.cleanup();\n    this.effects = effects;\n\n    this._internalEffects = effects.slice();\n    // Unique MaskEffect per EffectManager as GL context may be different\n    this._internalEffects.push(new MaskEffect());\n    if (!effects.some(effect => effect instanceof LightingEffect)) {\n      this._internalEffects.push(DEFAULT_LIGHTING_EFFECT);\n    }\n  }\n\n  cleanup() {\n    for (const effect of this.effects) {\n      effect.cleanup();\n    }\n\n    for (const effect of this._internalEffects) {\n      effect.cleanup();\n    }\n    this.effects.length = 0;\n    this._internalEffects.length = 0;\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport log from '../../utils/log';\nimport type Layer from '../layer';\nimport type Viewport from '../../viewports/viewport';\nimport type {PickingColorDecoder} from '../../passes/pick-layers-pass';\n\nexport type PickedPixel = {\n  pickedColor: Uint8Array | null;\n  pickedLayer?: Layer;\n  pickedViewports?: Viewport[];\n  pickedX?: number;\n  pickedY?: number;\n  pickedObjectIndex: number;\n};\n\nconst NO_PICKED_OBJECT = {\n  pickedColor: null,\n  pickedObjectIndex: -1\n};\n\n/* eslint-disable max-depth, max-statements */\n/**\n * Pick at a specified pixel with a tolerance radius\n * Returns the closest object to the pixel in shape `{pickedColor, pickedLayer, pickedObjectIndex}`\n */\nexport function getClosestObject({\n  pickedColors,\n  decodePickingColor,\n  deviceX,\n  deviceY,\n  deviceRadius,\n  deviceRect\n}: {\n  pickedColors: Uint8Array;\n  decodePickingColor: PickingColorDecoder;\n  deviceX: number;\n  deviceY: number;\n  deviceRadius: number;\n  deviceRect: {x: number; y: number; width: number; height: number};\n}): PickedPixel {\n  // Traverse all pixels in picking results and find the one closest to the supplied\n  // [deviceX, deviceY]\n  const {x, y, width, height} = deviceRect;\n  let minSquareDistanceToCenter = deviceRadius * deviceRadius;\n  let closestPixelIndex = -1;\n  let i = 0;\n\n  for (let row = 0; row < height; row++) {\n    const dy = row + y - deviceY;\n    const dy2 = dy * dy;\n\n    if (dy2 > minSquareDistanceToCenter) {\n      // skip this row\n      i += 4 * width;\n    } else {\n      for (let col = 0; col < width; col++) {\n        // Decode picked layer from color\n        const pickedLayerIndex = pickedColors[i + 3] - 1;\n\n        if (pickedLayerIndex >= 0) {\n          const dx = col + x - deviceX;\n          const d2 = dx * dx + dy2;\n\n          if (d2 <= minSquareDistanceToCenter) {\n            minSquareDistanceToCenter = d2;\n            closestPixelIndex = i;\n          }\n        }\n        i += 4;\n      }\n    }\n  }\n\n  if (closestPixelIndex >= 0) {\n    // Decode picked object index from color\n    const pickedColor = pickedColors.slice(closestPixelIndex, closestPixelIndex + 4);\n    const pickedObject = decodePickingColor(pickedColor);\n    if (pickedObject) {\n      const dy = Math.floor(closestPixelIndex / 4 / width);\n      const dx = closestPixelIndex / 4 - dy * width;\n      return {\n        ...pickedObject,\n        pickedColor,\n        pickedX: x + dx,\n        pickedY: y + dy\n      };\n    }\n    log.error('Picked non-existent layer. Is picking buffer corrupt?')();\n  }\n  return NO_PICKED_OBJECT;\n}\n\n/**\n * Examines a picking buffer for unique colors\n * Returns array of unique objects in shape `{x, y, pickedColor, pickedLayer, pickedObjectIndex}`\n */\nexport function getUniqueObjects({\n  pickedColors,\n  decodePickingColor\n}: {\n  pickedColors: Uint8Array;\n  decodePickingColor: PickingColorDecoder;\n}): PickedPixel[] {\n  const uniqueColors = new Map();\n\n  // Traverse all pixels in picking results and get unique colors\n  if (pickedColors) {\n    for (let i = 0; i < pickedColors.length; i += 4) {\n      // Decode picked layer from color\n      const pickedLayerIndex = pickedColors[i + 3] - 1;\n\n      if (pickedLayerIndex >= 0) {\n        const pickedColor = pickedColors.slice(i, i + 4);\n        const colorKey = pickedColor.join(',');\n        // eslint-disable-next-line\n        if (!uniqueColors.has(colorKey)) {\n          const pickedObject = decodePickingColor(pickedColor);\n          // eslint-disable-next-line\n          if (pickedObject) {\n            uniqueColors.set(colorKey, {\n              ...pickedObject,\n              color: pickedColor\n            });\n          } else {\n            log.error('Picked non-existent layer. Is picking buffer corrupt?')();\n          }\n        }\n      }\n    }\n  }\n\n  return Array.from(uniqueColors.values());\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport type Layer from '../layer';\nimport type Viewport from '../../viewports/viewport';\nimport type {PickedPixel} from './query-object';\n\nexport interface PickingInfo {\n  color: Uint8Array | null;\n  layer: Layer | null;\n  sourceLayer?: Layer | null;\n  viewport?: Viewport;\n  index: number;\n  picked: boolean;\n  object?: any;\n  x: number;\n  y: number;\n  pixel?: [number, number];\n  coordinate?: number[];\n  devicePixel?: [number, number];\n  pixelRatio: number;\n}\n\nexport interface GetPickingInfoParams {\n  info: PickingInfo;\n  mode: string;\n  sourceLayer: Layer | null;\n}\n\n/** Generates some basic information of the picking action: x, y, coordinates etc.\n * Regardless if anything is picked\n */\nexport function getEmptyPickingInfo({\n  pickInfo,\n  viewports,\n  pixelRatio,\n  x,\n  y,\n  z\n}: {\n  pickInfo?: PickedPixel;\n  viewports: Viewport[];\n  pixelRatio: number;\n  x: number;\n  y: number;\n  z?: number;\n}): PickingInfo {\n  // If more than one viewports are used in the picking pass, locate the viewport that\n  // drew the picked pixel\n  let pickedViewport = viewports[0];\n  if (viewports.length > 1) {\n    // Find the viewport that contain the picked pixel\n    pickedViewport = getViewportFromCoordinates(pickInfo?.pickedViewports || viewports, {x, y});\n  }\n  let coordinate: number[] | undefined;\n  if (pickedViewport) {\n    const point = [x - pickedViewport.x, y - pickedViewport.y];\n    if (z !== undefined) {\n      point[2] = z;\n    }\n    coordinate = pickedViewport.unproject(point);\n  }\n\n  return {\n    color: null,\n    layer: null,\n    viewport: pickedViewport,\n    index: -1,\n    picked: false,\n    x,\n    y,\n    pixel: [x, y],\n    coordinate,\n    devicePixel:\n      pickInfo && 'pickedX' in pickInfo\n        ? [pickInfo.pickedX as number, pickInfo.pickedY as number]\n        : undefined,\n    pixelRatio\n  };\n}\n\n/* eslint-disable max-depth */\n/** Generates the picking info of a picking operation */\nexport function processPickInfo(opts: {\n  pickInfo: PickedPixel;\n  lastPickedInfo: {\n    index: number;\n    layerId: string | null;\n    info: PickingInfo | null;\n  };\n  mode: string;\n  layers: Layer[];\n  viewports: Viewport[];\n  pixelRatio: number;\n  x: number;\n  y: number;\n  z?: number;\n}): Map<string | null, PickingInfo> {\n  const {pickInfo, lastPickedInfo, mode, layers} = opts;\n  const {pickedColor, pickedLayer, pickedObjectIndex} = pickInfo;\n\n  const affectedLayers = pickedLayer ? [pickedLayer] : [];\n\n  if (mode === 'hover') {\n    // only invoke onHover events if picked object has changed\n    const lastPickedPixelIndex = lastPickedInfo.index;\n    const lastPickedLayerId = lastPickedInfo.layerId;\n    const pickedLayerId = pickedLayer ? pickedLayer.props.id : null;\n\n    // proceed only if picked object changed\n    if (pickedLayerId !== lastPickedLayerId || pickedObjectIndex !== lastPickedPixelIndex) {\n      if (pickedLayerId !== lastPickedLayerId) {\n        // We cannot store a ref to lastPickedLayer in the context because\n        // the state of an outdated layer is no longer valid\n        // and the props may have changed\n        const lastPickedLayer = layers.find(layer => layer.props.id === lastPickedLayerId);\n        if (lastPickedLayer) {\n          // Let leave event fire before enter event\n          affectedLayers.unshift(lastPickedLayer);\n        }\n      }\n\n      // Update layer manager context\n      lastPickedInfo.layerId = pickedLayerId;\n      lastPickedInfo.index = pickedObjectIndex;\n      lastPickedInfo.info = null;\n    }\n  }\n\n  const baseInfo = getEmptyPickingInfo(opts);\n\n  // Use a Map to store all picking infos.\n  // The following two forEach loops are the result of\n  // https://github.com/visgl/deck.gl/issues/443\n  // Please be very careful when changing this pattern\n  const infos = new Map();\n\n  // Make sure infos always contain something even if no layer is affected\n  infos.set(null, baseInfo);\n\n  affectedLayers.forEach(layer => {\n    let info = {...baseInfo};\n\n    if (layer === pickedLayer) {\n      info.color = pickedColor;\n      info.index = pickedObjectIndex;\n      info.picked = true;\n    }\n\n    info = getLayerPickingInfo({layer, info, mode});\n    const rootLayer = info.layer as Layer;\n\n    if (layer === pickedLayer && mode === 'hover') {\n      lastPickedInfo.info = info;\n    }\n\n    // This guarantees that there will be only one copy of info for\n    // one composite layer\n    infos.set(rootLayer.id, info);\n\n    if (mode === 'hover') {\n      rootLayer.updateAutoHighlight(info);\n    }\n  });\n\n  return infos;\n}\n\n/** Walk up the layer composite chain to populate the info object */\nexport function getLayerPickingInfo({\n  layer,\n  info,\n  mode\n}: {\n  layer: Layer;\n  info: PickingInfo;\n  mode: string;\n}): PickingInfo {\n  while (layer && info) {\n    // For a composite layer, sourceLayer will point to the sublayer\n    // where the event originates from.\n    // It provides additional context for the composite layer's\n    // getPickingInfo() method to populate the info object\n    const sourceLayer = info.layer || null;\n    info.sourceLayer = sourceLayer;\n    info.layer = layer;\n    // layer.pickLayer() function requires a non-null ```layer.state```\n    // object to function properly. So the layer referenced here\n    // must be the \"current\" layer, not an \"out-dated\" / \"invalidated\" layer\n    info = layer.getPickingInfo({info, mode, sourceLayer});\n    layer = layer.parent as Layer;\n  }\n  return info;\n}\n\n/** Indentifies which viewport, if any corresponds to x and y\n   If multiple viewports contain the target pixel, last viewport drawn is returend\n   Returns first viewport if no match */\nfunction getViewportFromCoordinates(\n  viewports: Viewport[],\n  pixel: {x: number; y: number}\n): Viewport {\n  // find the last viewport that contains the pixel\n  for (let i = viewports.length - 1; i >= 0; i--) {\n    const viewport = viewports[i];\n    if (viewport.containsPixel(pixel)) {\n      return viewport;\n    }\n  }\n  return viewports[0];\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {\n  Framebuffer,\n  Texture2D,\n  isWebGL2,\n  readPixelsToArray,\n  cssToDeviceRatio,\n  cssToDevicePixels\n} from '@luma.gl/core';\nimport GL from '@luma.gl/constants';\nimport PickLayersPass, {PickingColorDecoder} from '../passes/pick-layers-pass';\nimport {getClosestObject, getUniqueObjects, PickedPixel} from './picking/query-object';\nimport {\n  processPickInfo,\n  getLayerPickingInfo,\n  getEmptyPickingInfo,\n  PickingInfo\n} from './picking/pick-info';\n\nimport type {Framebuffer as LumaFramebuffer} from '@luma.gl/webgl';\nimport type {FilterContext, Rect} from '../passes/layers-pass';\nimport type Layer from './layer';\nimport type {Effect} from './effect';\nimport type View from '../views/view';\nimport type Viewport from '../viewports/viewport';\n\nexport type PickByPointOptions = {\n  x: number;\n  y: number;\n  radius?: number;\n  depth?: number;\n  mode?: string;\n  unproject3D?: boolean;\n};\n\nexport type PickByRectOptions = {\n  x: number;\n  y: number;\n  width?: number;\n  height?: number;\n  mode?: string;\n  maxObjects?: number | null;\n};\n\ntype PickOperationContext = {\n  layers: Layer[];\n  views: Record<string, View>;\n  viewports: Viewport[];\n  onViewportActive: (viewport: Viewport) => void;\n  effects: Effect[];\n};\n\n/** Manages picking in a Deck context */\nexport default class DeckPicker {\n  gl: WebGLRenderingContext;\n  pickingFBO?: LumaFramebuffer;\n  depthFBO?: LumaFramebuffer;\n  pickLayersPass: PickLayersPass;\n  layerFilter?: (context: FilterContext) => boolean;\n\n  /** Identifiers of the previously picked object, for callback tracking and auto highlight */\n  lastPickedInfo: {\n    index: number;\n    layerId: string | null;\n    info: PickingInfo | null;\n  };\n\n  _pickable: boolean = true;\n\n  constructor(gl: WebGLRenderingContext) {\n    this.gl = gl;\n    this.pickLayersPass = new PickLayersPass(gl);\n    this.lastPickedInfo = {\n      index: -1,\n      layerId: null,\n      info: null\n    };\n  }\n\n  setProps(props: any): void {\n    if ('layerFilter' in props) {\n      this.layerFilter = props.layerFilter;\n    }\n\n    if ('_pickable' in props) {\n      this._pickable = props._pickable;\n    }\n  }\n\n  finalize() {\n    if (this.pickingFBO) {\n      this.pickingFBO.delete();\n    }\n    if (this.depthFBO) {\n      this.depthFBO.color.delete();\n      this.depthFBO.delete();\n    }\n  }\n\n  /** Pick the closest info at given coordinate */\n  pickObject(opts: PickByPointOptions & PickOperationContext) {\n    return this._pickClosestObject(opts);\n  }\n\n  /** Get all unique infos within a bounding box */\n  pickObjects(opts: PickByRectOptions & PickOperationContext) {\n    return this._pickVisibleObjects(opts);\n  }\n\n  // Returns a new picking info object by assuming the last picked object is still picked\n  getLastPickedObject({x, y, layers, viewports}, lastPickedInfo = this.lastPickedInfo.info) {\n    const lastPickedLayerId = lastPickedInfo && lastPickedInfo.layer && lastPickedInfo.layer.id;\n    const lastPickedViewportId =\n      lastPickedInfo && lastPickedInfo.viewport && lastPickedInfo.viewport.id;\n    const layer = lastPickedLayerId ? layers.find(l => l.id === lastPickedLayerId) : null;\n    const viewport =\n      (lastPickedViewportId && viewports.find(v => v.id === lastPickedViewportId)) || viewports[0];\n    const coordinate = viewport && viewport.unproject([x - viewport.x, y - viewport.y]);\n\n    const info = {\n      x,\n      y,\n      viewport,\n      coordinate,\n      layer\n    };\n\n    return {...lastPickedInfo, ...info};\n  }\n\n  // Private\n\n  /** Ensures that picking framebuffer exists and matches the canvas size */\n  _resizeBuffer() {\n    const {gl} = this;\n\n    // Create a frame buffer if not already available\n    if (!this.pickingFBO) {\n      this.pickingFBO = new Framebuffer(gl);\n\n      if (Framebuffer.isSupported(gl, {colorBufferFloat: true})) {\n        const depthFBO = new Framebuffer(gl);\n        depthFBO.attach({\n          [GL.COLOR_ATTACHMENT0]: new Texture2D(gl, {\n            format: isWebGL2(gl) ? GL.RGBA32F : GL.RGBA,\n            type: GL.FLOAT\n          })\n        });\n        this.depthFBO = depthFBO;\n      }\n    }\n    // Resize it to current canvas size (this is a noop if size hasn't changed)\n    this.pickingFBO?.resize({width: gl.canvas.width, height: gl.canvas.height});\n    this.depthFBO?.resize({width: gl.canvas.width, height: gl.canvas.height});\n  }\n\n  /** Preliminary filtering of the layers list. Skid picking pass if no layer is pickable. */\n  _getPickable(layers: Layer[]): Layer[] | null {\n    if (this._pickable === false) {\n      return null;\n    }\n    const pickableLayers = layers.filter(layer => layer.isPickable() && !layer.isComposite);\n    return pickableLayers.length ? pickableLayers : null;\n  }\n\n  // eslint-disable-next-line max-statements,complexity\n  /** Pick the closest object at the given coordinate */\n  _pickClosestObject({\n    layers,\n    views,\n    viewports,\n    x,\n    y,\n    radius = 0,\n    depth = 1,\n    mode = 'query',\n    unproject3D,\n    onViewportActive,\n    effects\n  }: PickByPointOptions & PickOperationContext): {\n    result: PickingInfo[];\n    emptyInfo: PickingInfo;\n  } {\n    const pickableLayers = this._getPickable(layers);\n    const pixelRatio = cssToDeviceRatio(this.gl);\n\n    if (!pickableLayers) {\n      return {\n        result: [],\n        emptyInfo: getEmptyPickingInfo({viewports, x, y, pixelRatio})\n      };\n    }\n\n    this._resizeBuffer();\n\n    // Convert from canvas top-left to WebGL bottom-left coordinates\n    // Top-left coordinates [x, y] to bottom-left coordinates [deviceX, deviceY]\n    // And compensate for pixelRatio\n    const devicePixelRange = cssToDevicePixels(this.gl, [x, y], true);\n    const devicePixel = [\n      devicePixelRange.x + Math.floor(devicePixelRange.width / 2),\n      devicePixelRange.y + Math.floor(devicePixelRange.height / 2)\n    ];\n\n    const deviceRadius = Math.round(radius * pixelRatio);\n    const {width, height} = this.pickingFBO as LumaFramebuffer;\n    const deviceRect = this._getPickingRect({\n      deviceX: devicePixel[0],\n      deviceY: devicePixel[1],\n      deviceRadius,\n      deviceWidth: width,\n      deviceHeight: height\n    });\n\n    const cullRect: Rect = {\n      x: x - radius,\n      y: y - radius,\n      width: radius * 2 + 1,\n      height: radius * 2 + 1\n    };\n\n    let infos: Map<string | null, PickingInfo>;\n    const result: PickingInfo[] = [];\n    const affectedLayers = new Set<Layer>();\n\n    for (let i = 0; i < depth; i++) {\n      let pickInfo: PickedPixel;\n\n      if (deviceRect) {\n        const pickedResult = this._drawAndSample({\n          layers: pickableLayers,\n          views,\n          viewports,\n          onViewportActive,\n          deviceRect,\n          cullRect,\n          effects,\n          pass: `picking:${mode}`\n        });\n\n        pickInfo = getClosestObject({\n          ...pickedResult,\n          deviceX: devicePixel[0],\n          deviceY: devicePixel[1],\n          deviceRadius,\n          deviceRect\n        });\n      } else {\n        pickInfo = {\n          pickedColor: null,\n          pickedObjectIndex: -1\n        };\n      }\n\n      let z;\n      if (pickInfo.pickedLayer && unproject3D && this.depthFBO) {\n        const pickedResultPass2 = this._drawAndSample(\n          {\n            layers: [pickInfo.pickedLayer],\n            views,\n            viewports,\n            onViewportActive,\n            deviceRect: {\n              x: pickInfo.pickedX as number,\n              y: pickInfo.pickedY as number,\n              width: 1,\n              height: 1\n            },\n            cullRect,\n            effects,\n            pass: `picking:${mode}:z`\n          },\n          true\n        );\n        // picked value is in common space (pixels) from the camera target (viewport.position)\n        // convert it to meters from the ground\n        z = pickedResultPass2.pickedColors[0];\n      }\n\n      // Only exclude if we need to run picking again.\n      // We need to run picking again if an object is detected AND\n      // we have not exhausted the requested depth.\n      if (pickInfo.pickedLayer && i + 1 < depth) {\n        affectedLayers.add(pickInfo.pickedLayer);\n        pickInfo.pickedLayer.disablePickingIndex(pickInfo.pickedObjectIndex);\n      }\n\n      // This logic needs to run even if no object is picked.\n      infos = processPickInfo({\n        pickInfo,\n        lastPickedInfo: this.lastPickedInfo,\n        mode,\n        layers: pickableLayers,\n        viewports,\n        x,\n        y,\n        z,\n        pixelRatio\n      });\n\n      for (const info of infos.values()) {\n        if (info.layer) {\n          result.push(info);\n        }\n      }\n\n      // If no object is picked stop.\n      if (!pickInfo.pickedColor) {\n        break;\n      }\n    }\n\n    // reset only affected buffers\n    for (const layer of affectedLayers) {\n      layer.restorePickingColors();\n    }\n\n    return {result, emptyInfo: infos!.get(null) as PickingInfo};\n  }\n\n  /** Pick all objects within the given bounding box */\n  _pickVisibleObjects({\n    layers,\n    views,\n    viewports,\n    x,\n    y,\n    width = 1,\n    height = 1,\n    mode = 'query',\n    maxObjects = null,\n    onViewportActive,\n    effects\n  }: PickByRectOptions & PickOperationContext): PickingInfo[] {\n    const pickableLayers = this._getPickable(layers);\n\n    if (!pickableLayers) {\n      return [];\n    }\n\n    this._resizeBuffer();\n    // Convert from canvas top-left to WebGL bottom-left coordinates\n    // And compensate for pixelRatio\n    const pixelRatio = cssToDeviceRatio(this.gl);\n    const leftTop = cssToDevicePixels(this.gl, [x, y], true);\n\n    // take left and top (y inverted in device pixels) from start location\n    const deviceLeft = leftTop.x;\n    const deviceTop = leftTop.y + leftTop.height;\n\n    // take right and bottom (y inverted in device pixels) from end location\n    const rightBottom = cssToDevicePixels(this.gl, [x + width, y + height], true);\n    const deviceRight = rightBottom.x + rightBottom.width;\n    const deviceBottom = rightBottom.y;\n\n    const deviceRect = {\n      x: deviceLeft,\n      y: deviceBottom,\n      // deviceTop and deviceRight represent the first pixel outside the desired rect\n      width: deviceRight - deviceLeft,\n      height: deviceTop - deviceBottom\n    };\n\n    const pickedResult = this._drawAndSample({\n      layers: pickableLayers,\n      views,\n      viewports,\n      onViewportActive,\n      deviceRect,\n      cullRect: {x, y, width, height},\n      effects,\n      pass: `picking:${mode}`\n    });\n\n    const pickInfos = getUniqueObjects(pickedResult);\n\n    // Only return unique infos, identified by info.object\n    const uniqueInfos = new Map();\n\n    const isMaxObjects = Number.isFinite(maxObjects);\n\n    for (let i = 0; i < pickInfos.length; i++) {\n      if (isMaxObjects && maxObjects && uniqueInfos.size >= maxObjects) {\n        break;\n      }\n      const pickInfo = pickInfos[i];\n      let info: PickingInfo = {\n        color: pickInfo.pickedColor,\n        layer: null,\n        index: pickInfo.pickedObjectIndex,\n        picked: true,\n        x,\n        y,\n        pixelRatio\n      };\n\n      info = getLayerPickingInfo({layer: pickInfo.pickedLayer as Layer, info, mode});\n      if (!uniqueInfos.has(info.object)) {\n        uniqueInfos.set(info.object, info);\n      }\n    }\n\n    return Array.from(uniqueInfos.values());\n  }\n\n  /** Renders layers into the picking buffer with picking colors and read the pixels. */\n  _drawAndSample(params: {\n    deviceRect: Rect;\n    pass: string;\n    layers: Layer[];\n    views: Record<string, View>;\n    viewports: Viewport[];\n    onViewportActive: (viewport: Viewport) => void;\n    cullRect?: Rect;\n    effects: Effect[];\n  }): {\n    pickedColors: Uint8Array;\n    decodePickingColor: PickingColorDecoder;\n  };\n\n  /** Renders layers into the picking buffer with encoded z values and read the pixels. */\n  _drawAndSample(\n    params: {\n      deviceRect: Rect;\n      pass: string;\n      layers: Layer[];\n      views: Record<string, View>;\n      viewports: Viewport[];\n      onViewportActive: (viewport: Viewport) => void;\n      cullRect?: Rect;\n      effects: Effect[];\n    },\n    pickZ: true\n  ): {\n    pickedColors: Float32Array;\n    decodePickingColor: null;\n  };\n\n  _drawAndSample(\n    {\n      layers,\n      views,\n      viewports,\n      onViewportActive,\n      deviceRect,\n      cullRect,\n      effects,\n      pass\n    }: {\n      deviceRect: Rect;\n      pass: string;\n      layers: Layer[];\n      views: Record<string, View>;\n      viewports: Viewport[];\n      onViewportActive: (viewport: Viewport) => void;\n      cullRect?: Rect;\n      effects: Effect[];\n    },\n    pickZ: boolean = false\n  ): {\n    pickedColors: Uint8Array | Float32Array;\n    decodePickingColor: PickingColorDecoder | null;\n  } {\n    const pickingFBO = pickZ ? this.depthFBO : this.pickingFBO;\n\n    const {decodePickingColor} = this.pickLayersPass.render({\n      layers,\n      layerFilter: this.layerFilter,\n      views,\n      viewports,\n      onViewportActive,\n      pickingFBO,\n      deviceRect,\n      cullRect,\n      effects,\n      pass,\n      pickZ\n    });\n\n    // Read from an already rendered picking buffer\n    // Returns an Uint8ClampedArray of picked pixels\n    const {x, y, width, height} = deviceRect;\n    const pickedColors = new (pickZ ? Float32Array : Uint8Array)(width * height * 4);\n    readPixelsToArray(pickingFBO, {\n      sourceX: x,\n      sourceY: y,\n      sourceWidth: width,\n      sourceHeight: height,\n      target: pickedColors\n    });\n\n    return {pickedColors, decodePickingColor};\n  }\n\n  // Calculate a picking rect centered on deviceX and deviceY and clipped to device\n  // Returns null if pixel is outside of device\n  _getPickingRect({\n    deviceX,\n    deviceY,\n    deviceRadius,\n    deviceWidth,\n    deviceHeight\n  }: {\n    deviceX: number;\n    deviceY: number;\n    deviceRadius: number;\n    deviceWidth: number;\n    deviceHeight: number;\n  }): Rect | null {\n    // Create a box of size `radius * 2 + 1` centered at [deviceX, deviceY]\n    const x = Math.max(0, deviceX - deviceRadius);\n    const y = Math.max(0, deviceY - deviceRadius);\n    const width = Math.min(deviceWidth, deviceX + deviceRadius + 1) - x;\n    const height = Math.min(deviceHeight, deviceY + deviceRadius + 1) - y;\n\n    // x, y out of bounds.\n    if (width <= 0 || height <= 0) {\n      return null;\n    }\n\n    return {x, y, width, height};\n  }\n}\n","// Copyright (c) 2015 - 2019 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n/* global document */\nconst defaultStyle: Partial<CSSStyleDeclaration> = {\n  zIndex: '1',\n  position: 'absolute',\n  pointerEvents: 'none',\n  color: '#a0a7b4',\n  backgroundColor: '#29323c',\n  padding: '10px',\n  top: '0',\n  left: '0',\n  display: 'none'\n};\n\nexport type TooltipContent =\n  | null\n  | string\n  | {\n      text?: string;\n      html?: string;\n      className?: string;\n      style?: Partial<CSSStyleDeclaration>;\n    };\n\nexport default class Tooltip {\n  private el: HTMLDivElement | null = null;\n\n  isVisible: boolean = false;\n\n  constructor(canvas: HTMLCanvasElement) {\n    const canvasParent = canvas.parentElement;\n    if (canvasParent) {\n      this.el = document.createElement('div');\n      this.el.className = 'deck-tooltip';\n      Object.assign(this.el.style, defaultStyle);\n      canvasParent.appendChild(this.el);\n    }\n  }\n\n  setTooltip(displayInfo: TooltipContent, x?: number, y?: number): void {\n    const el = this.el;\n    if (!el) {\n      return;\n    }\n\n    if (typeof displayInfo === 'string') {\n      el.innerText = displayInfo;\n    } else if (!displayInfo) {\n      this.isVisible = false;\n      el.style.display = 'none';\n      return;\n    } else {\n      if (displayInfo.text) {\n        el.innerText = displayInfo.text;\n      }\n      if (displayInfo.html) {\n        el.innerHTML = displayInfo.html;\n      }\n      if (displayInfo.className) {\n        el.className = displayInfo.className;\n      }\n      Object.assign(el.style, displayInfo.style);\n    }\n    this.isVisible = true;\n    el.style.display = 'block';\n    el.style.transform = `translate(${x}px, ${y}px)`;\n  }\n\n  remove(): void {\n    if (this.el) {\n      this.el.remove();\n      this.el = null;\n    }\n  }\n}\n","import Resource from './resource';\nimport { FEATURES, hasFeatures } from '../features';\nimport { isWebGL2 } from '@luma.gl/gltools';\nimport { assert } from '../utils/assert';\nconst GL_QUERY_RESULT = 0x8866;\nconst GL_QUERY_RESULT_AVAILABLE = 0x8867;\nconst GL_TIME_ELAPSED_EXT = 0x88bf;\nconst GL_GPU_DISJOINT_EXT = 0x8fbb;\nconst GL_TRANSFORM_FEEDBACK_PRIMITIVES_WRITTEN = 0x8c88;\nconst GL_ANY_SAMPLES_PASSED = 0x8c2f;\nconst GL_ANY_SAMPLES_PASSED_CONSERVATIVE = 0x8d6a;\nexport default class Query extends Resource {\n  get [Symbol.toStringTag]() {\n    return 'Query';\n  }\n\n  static isSupported(gl) {\n    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];\n    const webgl2 = isWebGL2(gl);\n    const hasTimerQuery = hasFeatures(gl, FEATURES.TIMER_QUERY);\n    let supported = webgl2 || hasTimerQuery;\n\n    for (const key of opts) {\n      switch (key) {\n        case 'queries':\n          supported = supported && webgl2;\n          break;\n\n        case 'timers':\n          supported = supported && hasTimerQuery;\n          break;\n\n        default:\n          assert(false);\n      }\n    }\n\n    return supported;\n  }\n\n  constructor(gl) {\n    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    super(gl, opts);\n    this.target = null;\n    this._queryPending = false;\n    this._pollingPromise = null;\n    Object.seal(this);\n  }\n\n  beginTimeElapsedQuery() {\n    return this.begin(GL_TIME_ELAPSED_EXT);\n  }\n\n  beginOcclusionQuery() {\n    let {\n      conservative = false\n    } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    return this.begin(conservative ? GL_ANY_SAMPLES_PASSED_CONSERVATIVE : GL_ANY_SAMPLES_PASSED);\n  }\n\n  beginTransformFeedbackQuery() {\n    return this.begin(GL_TRANSFORM_FEEDBACK_PRIMITIVES_WRITTEN);\n  }\n\n  begin(target) {\n    if (this._queryPending) {\n      return this;\n    }\n\n    this.target = target;\n    this.gl2.beginQuery(this.target, this.handle);\n    return this;\n  }\n\n  end() {\n    if (this._queryPending) {\n      return this;\n    }\n\n    if (this.target) {\n      this.gl2.endQuery(this.target);\n      this.target = null;\n      this._queryPending = true;\n    }\n\n    return this;\n  }\n\n  isResultAvailable() {\n    if (!this._queryPending) {\n      return false;\n    }\n\n    const resultAvailable = this.gl2.getQueryParameter(this.handle, GL_QUERY_RESULT_AVAILABLE);\n\n    if (resultAvailable) {\n      this._queryPending = false;\n    }\n\n    return resultAvailable;\n  }\n\n  isTimerDisjoint() {\n    return this.gl2.getParameter(GL_GPU_DISJOINT_EXT);\n  }\n\n  getResult() {\n    return this.gl2.getQueryParameter(this.handle, GL_QUERY_RESULT);\n  }\n\n  getTimerMilliseconds() {\n    return this.getResult() / 1e6;\n  }\n\n  createPoll() {\n    let limit = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : Number.POSITIVE_INFINITY;\n\n    if (this._pollingPromise) {\n      return this._pollingPromise;\n    }\n\n    let counter = 0;\n    this._pollingPromise = new Promise((resolve, reject) => {\n      const poll = () => {\n        if (this.isResultAvailable()) {\n          resolve(this.getResult());\n          this._pollingPromise = null;\n        } else if (counter++ > limit) {\n          reject('Timed out');\n          this._pollingPromise = null;\n        } else {\n          requestAnimationFrame(poll);\n        }\n      };\n\n      requestAnimationFrame(poll);\n    });\n    return this._pollingPromise;\n  }\n\n  _createHandle() {\n    return Query.isSupported(this.gl) ? this.gl2.createQuery() : null;\n  }\n\n  _deleteHandle() {\n    this.gl2.deleteQuery(this.handle);\n  }\n\n}\n//# sourceMappingURL=query.js.map","import { isWebGL, createGLContext, instrumentGLContext, resizeGLContext, resetParameters } from '@luma.gl/gltools';\nimport { requestAnimationFrame, cancelAnimationFrame, Query, lumaStats, Framebuffer, log, assert } from '@luma.gl/webgl';\nimport { isBrowser } from '@probe.gl/env';\nconst isPage = isBrowser() && typeof document !== 'undefined';\nlet statIdCounter = 0;\nexport default class AnimationLoop {\n  constructor() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      onCreateContext = opts => createGLContext(opts),\n      onAddHTML = null,\n      onInitialize = () => {},\n      onRender = () => {},\n      onFinalize = () => {},\n      onError,\n      gl = null,\n      glOptions = {},\n      debug = false,\n      createFramebuffer = false,\n      autoResizeViewport = true,\n      autoResizeDrawingBuffer = true,\n      stats = lumaStats.get(\"animation-loop-\".concat(statIdCounter++))\n    } = props;\n    let {\n      useDevicePixels = true\n    } = props;\n\n    if ('useDevicePixelRatio' in props) {\n      log.deprecated('useDevicePixelRatio', 'useDevicePixels')();\n      useDevicePixels = props.useDevicePixelRatio;\n    }\n\n    this.props = {\n      onCreateContext,\n      onAddHTML,\n      onInitialize,\n      onRender,\n      onFinalize,\n      onError,\n      gl,\n      glOptions,\n      debug,\n      createFramebuffer\n    };\n    this.gl = gl;\n    this.needsRedraw = null;\n    this.timeline = null;\n    this.stats = stats;\n    this.cpuTime = this.stats.get('CPU Time');\n    this.gpuTime = this.stats.get('GPU Time');\n    this.frameRate = this.stats.get('Frame Rate');\n    this._initialized = false;\n    this._running = false;\n    this._animationFrameId = null;\n    this._nextFramePromise = null;\n    this._resolveNextFrame = null;\n    this._cpuStartTime = 0;\n    this.setProps({\n      autoResizeViewport,\n      autoResizeDrawingBuffer,\n      useDevicePixels\n    });\n    this.start = this.start.bind(this);\n    this.stop = this.stop.bind(this);\n    this._pageLoadPromise = null;\n    this._onMousemove = this._onMousemove.bind(this);\n    this._onMouseleave = this._onMouseleave.bind(this);\n  }\n\n  delete() {\n    this.stop();\n\n    this._setDisplay(null);\n  }\n\n  setNeedsRedraw(reason) {\n    assert(typeof reason === 'string');\n    this.needsRedraw = this.needsRedraw || reason;\n    return this;\n  }\n\n  setProps(props) {\n    if ('autoResizeViewport' in props) {\n      this.autoResizeViewport = props.autoResizeViewport;\n    }\n\n    if ('autoResizeDrawingBuffer' in props) {\n      this.autoResizeDrawingBuffer = props.autoResizeDrawingBuffer;\n    }\n\n    if ('useDevicePixels' in props) {\n      this.useDevicePixels = props.useDevicePixels;\n    }\n\n    return this;\n  }\n\n  start() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    if (this._running) {\n      return this;\n    }\n\n    this._running = true;\n\n    const startPromise = this._getPageLoadPromise().then(() => {\n      if (!this._running || this._initialized) {\n        return null;\n      }\n\n      this._createWebGLContext(opts);\n\n      this._createFramebuffer();\n\n      this._startEventHandling();\n\n      this._initializeCallbackData();\n\n      this._updateCallbackData();\n\n      this._resizeCanvasDrawingBuffer();\n\n      this._resizeViewport();\n\n      this._gpuTimeQuery = Query.isSupported(this.gl, ['timers']) ? new Query(this.gl) : null;\n      this._initialized = true;\n      return this.onInitialize(this.animationProps);\n    }).then(appContext => {\n      if (this._running) {\n        this._addCallbackData(appContext || {});\n\n        if (appContext !== false) {\n          this._startLoop();\n        }\n      }\n    });\n\n    if (this.props.onError) {\n      startPromise.catch(this.props.onError);\n    }\n\n    return this;\n  }\n\n  redraw() {\n    if (this.isContextLost()) {\n      return this;\n    }\n\n    this._beginTimers();\n\n    this._setupFrame();\n\n    this._updateCallbackData();\n\n    this._renderFrame(this.animationProps);\n\n    this._clearNeedsRedraw();\n\n    if (this.offScreen && this.gl.commit) {\n      this.gl.commit();\n    }\n\n    if (this._resolveNextFrame) {\n      this._resolveNextFrame(this);\n\n      this._nextFramePromise = null;\n      this._resolveNextFrame = null;\n    }\n\n    this._endTimers();\n\n    return this;\n  }\n\n  stop() {\n    if (this._running) {\n      this._finalizeCallbackData();\n\n      this._cancelAnimationFrame(this._animationFrameId);\n\n      this._nextFramePromise = null;\n      this._resolveNextFrame = null;\n      this._animationFrameId = null;\n      this._running = false;\n    }\n\n    return this;\n  }\n\n  attachTimeline(timeline) {\n    this.timeline = timeline;\n    return this.timeline;\n  }\n\n  detachTimeline() {\n    this.timeline = null;\n  }\n\n  waitForRender() {\n    this.setNeedsRedraw('waitForRender');\n\n    if (!this._nextFramePromise) {\n      this._nextFramePromise = new Promise(resolve => {\n        this._resolveNextFrame = resolve;\n      });\n    }\n\n    return this._nextFramePromise;\n  }\n\n  async toDataURL() {\n    this.setNeedsRedraw('toDataURL');\n    await this.waitForRender();\n    return this.gl.canvas.toDataURL();\n  }\n\n  isContextLost() {\n    return this.gl.isContextLost();\n  }\n\n  onCreateContext() {\n    return this.props.onCreateContext(...arguments);\n  }\n\n  onInitialize() {\n    return this.props.onInitialize(...arguments);\n  }\n\n  onRender() {\n    return this.props.onRender(...arguments);\n  }\n\n  onFinalize() {\n    return this.props.onFinalize(...arguments);\n  }\n\n  getHTMLControlValue(id) {\n    let defaultValue = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 1;\n    const element = document.getElementById(id);\n    return element ? Number(element.value) : defaultValue;\n  }\n\n  setViewParameters() {\n    log.removed('AnimationLoop.setViewParameters', 'AnimationLoop.setProps')();\n    return this;\n  }\n\n  _startLoop() {\n    const renderFrame = () => {\n      if (!this._running) {\n        return;\n      }\n\n      this.redraw();\n      this._animationFrameId = this._requestAnimationFrame(renderFrame);\n    };\n\n    this._cancelAnimationFrame(this._animationFrameId);\n\n    this._animationFrameId = this._requestAnimationFrame(renderFrame);\n  }\n\n  _getPageLoadPromise() {\n    if (!this._pageLoadPromise) {\n      this._pageLoadPromise = isPage ? new Promise((resolve, reject) => {\n        if (isPage && document.readyState === 'complete') {\n          resolve(document);\n          return;\n        }\n\n        window.addEventListener('load', () => {\n          resolve(document);\n        });\n      }) : Promise.resolve({});\n    }\n\n    return this._pageLoadPromise;\n  }\n\n  _setDisplay(display) {\n    if (this.display) {\n      this.display.delete();\n      this.display.animationLoop = null;\n    }\n\n    if (display) {\n      display.animationLoop = this;\n    }\n\n    this.display = display;\n  }\n\n  _cancelAnimationFrame(animationFrameId) {\n    if (this.display && this.display.cancelAnimationFrame) {\n      return this.display.cancelAnimationFrame(animationFrameId);\n    }\n\n    return cancelAnimationFrame(animationFrameId);\n  }\n\n  _requestAnimationFrame(renderFrameCallback) {\n    if (this._running) {\n      if (this.display && this.display.requestAnimationFrame) {\n        return this.display.requestAnimationFrame(renderFrameCallback);\n      }\n\n      return requestAnimationFrame(renderFrameCallback);\n    }\n\n    return undefined;\n  }\n\n  _renderFrame() {\n    if (this.display) {\n      this.display._renderFrame(...arguments);\n\n      return;\n    }\n\n    this.onRender(...arguments);\n  }\n\n  _clearNeedsRedraw() {\n    this.needsRedraw = null;\n  }\n\n  _setupFrame() {\n    this._resizeCanvasDrawingBuffer();\n\n    this._resizeViewport();\n\n    this._resizeFramebuffer();\n  }\n\n  _initializeCallbackData() {\n    this.animationProps = {\n      gl: this.gl,\n      stop: this.stop,\n      canvas: this.gl.canvas,\n      framebuffer: this.framebuffer,\n      useDevicePixels: this.useDevicePixels,\n      needsRedraw: null,\n      startTime: Date.now(),\n      engineTime: 0,\n      tick: 0,\n      tock: 0,\n      time: 0,\n      _timeline: this.timeline,\n      _loop: this,\n      _animationLoop: this,\n      _mousePosition: null\n    };\n  }\n\n  _updateCallbackData() {\n    const {\n      width,\n      height,\n      aspect\n    } = this._getSizeAndAspect();\n\n    if (width !== this.animationProps.width || height !== this.animationProps.height) {\n      this.setNeedsRedraw('drawing buffer resized');\n    }\n\n    if (aspect !== this.animationProps.aspect) {\n      this.setNeedsRedraw('drawing buffer aspect changed');\n    }\n\n    this.animationProps.width = width;\n    this.animationProps.height = height;\n    this.animationProps.aspect = aspect;\n    this.animationProps.needsRedraw = this.needsRedraw;\n    this.animationProps.engineTime = Date.now() - this.animationProps.startTime;\n\n    if (this.timeline) {\n      this.timeline.update(this.animationProps.engineTime);\n    }\n\n    this.animationProps.tick = Math.floor(this.animationProps.time / 1000 * 60);\n    this.animationProps.tock++;\n    this.animationProps.time = this.timeline ? this.timeline.getTime() : this.animationProps.engineTime;\n    this.animationProps._offScreen = this.offScreen;\n  }\n\n  _finalizeCallbackData() {\n    this.onFinalize(this.animationProps);\n  }\n\n  _addCallbackData(appContext) {\n    if (typeof appContext === 'object' && appContext !== null) {\n      this.animationProps = Object.assign({}, this.animationProps, appContext);\n    }\n  }\n\n  _createWebGLContext(opts) {\n    this.offScreen = opts.canvas && typeof OffscreenCanvas !== 'undefined' && opts.canvas instanceof OffscreenCanvas;\n    opts = Object.assign({}, opts, this.props.glOptions);\n    this.gl = this.props.gl ? instrumentGLContext(this.props.gl, opts) : this.onCreateContext(opts);\n\n    if (!isWebGL(this.gl)) {\n      throw new Error('AnimationLoop.onCreateContext - illegal context returned');\n    }\n\n    resetParameters(this.gl);\n\n    this._createInfoDiv();\n  }\n\n  _createInfoDiv() {\n    if (this.gl.canvas && this.props.onAddHTML) {\n      const wrapperDiv = document.createElement('div');\n      document.body.appendChild(wrapperDiv);\n      wrapperDiv.style.position = 'relative';\n      const div = document.createElement('div');\n      div.style.position = 'absolute';\n      div.style.left = '10px';\n      div.style.bottom = '10px';\n      div.style.width = '300px';\n      div.style.background = 'white';\n      wrapperDiv.appendChild(this.gl.canvas);\n      wrapperDiv.appendChild(div);\n      const html = this.props.onAddHTML(div);\n\n      if (html) {\n        div.innerHTML = html;\n      }\n    }\n  }\n\n  _getSizeAndAspect() {\n    const width = this.gl.drawingBufferWidth;\n    const height = this.gl.drawingBufferHeight;\n    let aspect = 1;\n    const {\n      canvas\n    } = this.gl;\n\n    if (canvas && canvas.clientHeight) {\n      aspect = canvas.clientWidth / canvas.clientHeight;\n    } else if (width > 0 && height > 0) {\n      aspect = width / height;\n    }\n\n    return {\n      width,\n      height,\n      aspect\n    };\n  }\n\n  _resizeViewport() {\n    if (this.autoResizeViewport) {\n      this.gl.viewport(0, 0, this.gl.drawingBufferWidth, this.gl.drawingBufferHeight);\n    }\n  }\n\n  _resizeCanvasDrawingBuffer() {\n    if (this.autoResizeDrawingBuffer) {\n      resizeGLContext(this.gl, {\n        useDevicePixels: this.useDevicePixels\n      });\n    }\n  }\n\n  _createFramebuffer() {\n    if (this.props.createFramebuffer) {\n      this.framebuffer = new Framebuffer(this.gl);\n    }\n  }\n\n  _resizeFramebuffer() {\n    if (this.framebuffer) {\n      this.framebuffer.resize({\n        width: this.gl.drawingBufferWidth,\n        height: this.gl.drawingBufferHeight\n      });\n    }\n  }\n\n  _beginTimers() {\n    this.frameRate.timeEnd();\n    this.frameRate.timeStart();\n\n    if (this._gpuTimeQuery && this._gpuTimeQuery.isResultAvailable() && !this._gpuTimeQuery.isTimerDisjoint()) {\n      this.stats.get('GPU Time').addTime(this._gpuTimeQuery.getTimerMilliseconds());\n    }\n\n    if (this._gpuTimeQuery) {\n      this._gpuTimeQuery.beginTimeElapsedQuery();\n    }\n\n    this.cpuTime.timeStart();\n  }\n\n  _endTimers() {\n    this.cpuTime.timeEnd();\n\n    if (this._gpuTimeQuery) {\n      this._gpuTimeQuery.end();\n    }\n  }\n\n  _startEventHandling() {\n    const {\n      canvas\n    } = this.gl;\n\n    if (canvas) {\n      canvas.addEventListener('mousemove', this._onMousemove);\n      canvas.addEventListener('mouseleave', this._onMouseleave);\n    }\n  }\n\n  _onMousemove(e) {\n    this.animationProps._mousePosition = [e.offsetX, e.offsetY];\n  }\n\n  _onMouseleave(e) {\n    this.animationProps._mousePosition = null;\n  }\n\n}\n//# sourceMappingURL=animation-loop.js.map","export function requestAnimationFrame(callback) {\n  return typeof window !== 'undefined' && window.requestAnimationFrame ? window.requestAnimationFrame(callback) : setTimeout(callback, 1000 / 60);\n}\nexport function cancelAnimationFrame(timerId) {\n  return typeof window !== 'undefined' && window.cancelAnimationFrame ? window.cancelAnimationFrame(timerId) : clearTimeout(timerId);\n}\n//# sourceMappingURL=request-animation-frame.js.map","/**\n * This file contains overrides the default\n * hammer.js functions to add our own utility\n */\n/* eslint-disable */\n/* Hammer.js constants */\nconst INPUT_START = 1;\nconst INPUT_MOVE = 2;\nconst INPUT_END = 4;\nconst MOUSE_INPUT_MAP = {\n    mousedown: INPUT_START,\n    mousemove: INPUT_MOVE,\n    mouseup: INPUT_END\n};\n/**\n * Helper function that returns true if any element in an array meets given criteria.\n * Because older browsers do not support `Array.prototype.some`\n * @params array {Array}\n * @params predict {Function}\n */\nfunction some(array, predict) {\n    for (let i = 0; i < array.length; i++) {\n        if (predict(array[i])) {\n            return true;\n        }\n    }\n    return false;\n}\n/* eslint-disable no-invalid-this */\nexport function enhancePointerEventInput(PointerEventInput) {\n    const oldHandler = PointerEventInput.prototype.handler;\n    // overrides PointerEventInput.handler to accept right mouse button\n    PointerEventInput.prototype.handler = function handler(ev) {\n        const store = this.store;\n        // Allow non-left mouse buttons through\n        if (ev.button > 0 && ev.type === 'pointerdown') {\n            if (!some(store, e => e.pointerId === ev.pointerId)) {\n                store.push(ev);\n            }\n        }\n        oldHandler.call(this, ev);\n    };\n}\n// overrides MouseInput.handler to accept right mouse button\nexport function enhanceMouseInput(MouseInput) {\n    MouseInput.prototype.handler = function handler(ev) {\n        let eventType = MOUSE_INPUT_MAP[ev.type];\n        // on start we want to have the mouse button down\n        if (eventType & INPUT_START && ev.button >= 0) {\n            this.pressed = true;\n        }\n        if (eventType & INPUT_MOVE && ev.which === 0) {\n            eventType = INPUT_END;\n        }\n        // mouse must be down\n        if (!this.pressed) {\n            return;\n        }\n        if (eventType & INPUT_END) {\n            this.pressed = false;\n        }\n        this.callback(this.manager, eventType, {\n            pointers: [ev],\n            changedPointers: [ev],\n            pointerType: 'mouse',\n            srcEvent: ev\n        });\n    };\n}\n//# sourceMappingURL=hammer-overrides.js.map","import hammerjs from 'hammerjs';\nimport { enhancePointerEventInput, enhanceMouseInput } from './hammer-overrides';\nenhancePointerEventInput(hammerjs.PointerEventInput);\nenhanceMouseInput(hammerjs.MouseInput);\nexport const Manager = hammerjs.Manager;\nexport default hammerjs;\n//# sourceMappingURL=hammer.browser.js.map","export default class Input {\n    constructor(element, callback, options) {\n        this.element = element;\n        this.callback = callback;\n        this.options = { enable: true, ...options };\n    }\n}\n//# sourceMappingURL=input.js.map","import Hammer from './utils/hammer';\n// This module contains constants that must be conditionally required\n// due to `window`/`document` references downstream.\nexport const RECOGNIZERS = Hammer\n    ? [\n        [Hammer.Pan, { event: 'tripan', pointers: 3, threshold: 0, enable: false }],\n        [Hammer.Rotate, { enable: false }],\n        [Hammer.Pinch, { enable: false }],\n        [Hammer.Swipe, { enable: false }],\n        [Hammer.Pan, { threshold: 0, enable: false }],\n        [Hammer.Press, { enable: false }],\n        [Hammer.Tap, { event: 'doubletap', taps: 2, enable: false }],\n        // TODO - rename to 'tap' and 'singletap' in the next major release\n        [Hammer.Tap, { event: 'anytap', enable: false }],\n        [Hammer.Tap, { enable: false }]\n    ]\n    : null;\n// Recognize the following gestures even if a given recognizer succeeds\nexport const RECOGNIZER_COMPATIBLE_MAP = {\n    tripan: ['rotate', 'pinch', 'pan'],\n    rotate: ['pinch'],\n    pinch: ['pan'],\n    pan: ['press', 'doubletap', 'anytap', 'tap'],\n    doubletap: ['anytap'],\n    anytap: ['tap']\n};\n// Recognize the folling gestures only if a given recognizer fails\nexport const RECOGNIZER_FALLBACK_MAP = {\n    doubletap: ['tap']\n};\n/**\n * Only one set of basic input events will be fired by Hammer.js:\n * either pointer, touch, or mouse, depending on system support.\n * In order to enable an application to be agnostic of system support,\n * alias basic input events into \"classes\" of events: down, move, and up.\n * See `_onBasicInput()` for usage of these aliases.\n */\nexport const BASIC_EVENT_ALIASES = {\n    pointerdown: 'pointerdown',\n    pointermove: 'pointermove',\n    pointerup: 'pointerup',\n    touchstart: 'pointerdown',\n    touchmove: 'pointermove',\n    touchend: 'pointerup',\n    mousedown: 'pointerdown',\n    mousemove: 'pointermove',\n    mouseup: 'pointerup'\n};\nexport const INPUT_EVENT_TYPES = {\n    KEY_EVENTS: ['keydown', 'keyup'],\n    MOUSE_EVENTS: ['mousedown', 'mousemove', 'mouseup', 'mouseover', 'mouseout', 'mouseleave'],\n    WHEEL_EVENTS: [\n        // Chrome, Safari\n        'wheel',\n        // IE\n        'mousewheel'\n    ]\n};\n/**\n * \"Gestural\" events are those that have semantic meaning beyond the basic input event,\n * e.g. a click or tap is a sequence of `down` and `up` events with no `move` event in between.\n * Hammer.js handles these with its Recognizer system;\n * this block maps event names to the Recognizers required to detect the events.\n */\nexport const EVENT_RECOGNIZER_MAP = {\n    tap: 'tap',\n    anytap: 'anytap',\n    doubletap: 'doubletap',\n    press: 'press',\n    pinch: 'pinch',\n    pinchin: 'pinch',\n    pinchout: 'pinch',\n    pinchstart: 'pinch',\n    pinchmove: 'pinch',\n    pinchend: 'pinch',\n    pinchcancel: 'pinch',\n    rotate: 'rotate',\n    rotatestart: 'rotate',\n    rotatemove: 'rotate',\n    rotateend: 'rotate',\n    rotatecancel: 'rotate',\n    tripan: 'tripan',\n    tripanstart: 'tripan',\n    tripanmove: 'tripan',\n    tripanup: 'tripan',\n    tripandown: 'tripan',\n    tripanleft: 'tripan',\n    tripanright: 'tripan',\n    tripanend: 'tripan',\n    tripancancel: 'tripan',\n    pan: 'pan',\n    panstart: 'pan',\n    panmove: 'pan',\n    panup: 'pan',\n    pandown: 'pan',\n    panleft: 'pan',\n    panright: 'pan',\n    panend: 'pan',\n    pancancel: 'pan',\n    swipe: 'swipe',\n    swipeleft: 'swipe',\n    swiperight: 'swipe',\n    swipeup: 'swipe',\n    swipedown: 'swipe'\n};\n/**\n * Map gestural events typically provided by browsers\n * that are not reported in 'hammer.input' events\n * to corresponding Hammer.js gestures.\n */\nexport const GESTURE_EVENT_ALIASES = {\n    click: 'tap',\n    anyclick: 'anytap',\n    dblclick: 'doubletap',\n    mousedown: 'pointerdown',\n    mousemove: 'pointermove',\n    mouseup: 'pointerup',\n    mouseover: 'pointerover',\n    mouseout: 'pointerout',\n    mouseleave: 'pointerleave'\n};\n//# sourceMappingURL=constants.js.map","import Input from './input';\nimport { INPUT_EVENT_TYPES } from '../constants';\nimport { window, userAgent, passiveSupported } from '../utils/globals';\nconst firefox = userAgent.indexOf('firefox') !== -1;\nconst { WHEEL_EVENTS } = INPUT_EVENT_TYPES;\nconst EVENT_TYPE = 'wheel';\n// Constants for normalizing input delta\nconst WHEEL_DELTA_MAGIC_SCALER = 4.000244140625;\nconst WHEEL_DELTA_PER_LINE = 40;\n// Slow down zoom if shift key is held for more precise zooming\nconst SHIFT_MULTIPLIER = 0.25;\nexport default class WheelInput extends Input {\n    constructor(element, callback, options) {\n        super(element, callback, options);\n        /* eslint-disable complexity, max-statements */\n        this.handleEvent = (event) => {\n            if (!this.options.enable) {\n                return;\n            }\n            let value = event.deltaY;\n            if (window.WheelEvent) {\n                // Firefox doubles the values on retina screens...\n                if (firefox && event.deltaMode === window.WheelEvent.DOM_DELTA_PIXEL) {\n                    value /= window.devicePixelRatio;\n                }\n                if (event.deltaMode === window.WheelEvent.DOM_DELTA_LINE) {\n                    value *= WHEEL_DELTA_PER_LINE;\n                }\n            }\n            if (value !== 0 && value % WHEEL_DELTA_MAGIC_SCALER === 0) {\n                // This one is definitely a mouse wheel event.\n                // Normalize this value to match trackpad.\n                value = Math.floor(value / WHEEL_DELTA_MAGIC_SCALER);\n            }\n            if (event.shiftKey && value) {\n                value = value * SHIFT_MULTIPLIER;\n            }\n            this.callback({\n                type: EVENT_TYPE,\n                center: {\n                    x: event.clientX,\n                    y: event.clientY\n                },\n                delta: -value,\n                srcEvent: event,\n                pointerType: 'mouse',\n                target: event.target\n            });\n        };\n        this.events = (this.options.events || []).concat(WHEEL_EVENTS);\n        this.events.forEach(event => element.addEventListener(event, this.handleEvent, passiveSupported ? { passive: false } : false));\n    }\n    destroy() {\n        this.events.forEach(event => this.element.removeEventListener(event, this.handleEvent));\n    }\n    /**\n     * Enable this input (begin processing events)\n     * if the specified event type is among those handled by this input.\n     */\n    enableEventType(eventType, enabled) {\n        if (eventType === EVENT_TYPE) {\n            this.options.enable = enabled;\n        }\n    }\n}\n//# sourceMappingURL=wheel-input.js.map","import Input from './input';\nimport { INPUT_EVENT_TYPES } from '../constants';\nconst { MOUSE_EVENTS } = INPUT_EVENT_TYPES;\nconst MOVE_EVENT_TYPE = 'pointermove';\nconst OVER_EVENT_TYPE = 'pointerover';\nconst OUT_EVENT_TYPE = 'pointerout';\nconst ENTER_EVENT_TYPE = 'pointerenter';\nconst LEAVE_EVENT_TYPE = 'pointerleave';\n/**\n * Hammer.js swallows 'move' events (for pointer/touch/mouse)\n * when the pointer is not down. This class sets up a handler\n * specifically for these events to work around this limitation.\n * Note that this could be extended to more intelligently handle\n * move events across input types, e.g. storing multiple simultaneous\n * pointer/touch events, calculating speed/direction, etc.\n */\nexport default class MoveInput extends Input {\n    constructor(element, callback, options) {\n        super(element, callback, options);\n        this.handleEvent = (event) => {\n            this.handleOverEvent(event);\n            this.handleOutEvent(event);\n            this.handleEnterEvent(event);\n            this.handleLeaveEvent(event);\n            this.handleMoveEvent(event);\n        };\n        this.pressed = false;\n        const { enable } = this.options;\n        this.enableMoveEvent = enable;\n        this.enableLeaveEvent = enable;\n        this.enableEnterEvent = enable;\n        this.enableOutEvent = enable;\n        this.enableOverEvent = enable;\n        this.events = (this.options.events || []).concat(MOUSE_EVENTS);\n        this.events.forEach(event => element.addEventListener(event, this.handleEvent));\n    }\n    destroy() {\n        this.events.forEach(event => this.element.removeEventListener(event, this.handleEvent));\n    }\n    /**\n     * Enable this input (begin processing events)\n     * if the specified event type is among those handled by this input.\n     */\n    enableEventType(eventType, enabled) {\n        if (eventType === MOVE_EVENT_TYPE) {\n            this.enableMoveEvent = enabled;\n        }\n        if (eventType === OVER_EVENT_TYPE) {\n            this.enableOverEvent = enabled;\n        }\n        if (eventType === OUT_EVENT_TYPE) {\n            this.enableOutEvent = enabled;\n        }\n        if (eventType === ENTER_EVENT_TYPE) {\n            this.enableEnterEvent = enabled;\n        }\n        if (eventType === LEAVE_EVENT_TYPE) {\n            this.enableLeaveEvent = enabled;\n        }\n    }\n    handleOverEvent(event) {\n        if (this.enableOverEvent) {\n            if (event.type === 'mouseover') {\n                this._emit(OVER_EVENT_TYPE, event);\n            }\n        }\n    }\n    handleOutEvent(event) {\n        if (this.enableOutEvent) {\n            if (event.type === 'mouseout') {\n                this._emit(OUT_EVENT_TYPE, event);\n            }\n        }\n    }\n    handleEnterEvent(event) {\n        if (this.enableEnterEvent) {\n            if (event.type === 'mouseenter') {\n                this._emit(ENTER_EVENT_TYPE, event);\n            }\n        }\n    }\n    handleLeaveEvent(event) {\n        if (this.enableLeaveEvent) {\n            if (event.type === 'mouseleave') {\n                this._emit(LEAVE_EVENT_TYPE, event);\n            }\n        }\n    }\n    handleMoveEvent(event) {\n        if (this.enableMoveEvent) {\n            switch (event.type) {\n                case 'mousedown':\n                    if (event.button >= 0) {\n                        // Button is down\n                        this.pressed = true;\n                    }\n                    break;\n                case 'mousemove':\n                    // Move events use `which` to track the button being pressed\n                    if (event.which === 0) {\n                        // Button is not down\n                        this.pressed = false;\n                    }\n                    if (!this.pressed) {\n                        // Drag events are emitted by hammer already\n                        // we just need to emit the move event on hover\n                        this._emit(MOVE_EVENT_TYPE, event);\n                    }\n                    break;\n                case 'mouseup':\n                    this.pressed = false;\n                    break;\n                default:\n            }\n        }\n    }\n    _emit(type, event) {\n        this.callback({\n            type,\n            center: {\n                x: event.clientX,\n                y: event.clientY\n            },\n            srcEvent: event,\n            pointerType: 'mouse',\n            target: event.target\n        });\n    }\n}\n//# sourceMappingURL=move-input.js.map","import Input from './input';\nimport { INPUT_EVENT_TYPES } from '../constants';\nconst { KEY_EVENTS } = INPUT_EVENT_TYPES;\nconst DOWN_EVENT_TYPE = 'keydown';\nconst UP_EVENT_TYPE = 'keyup';\nexport default class KeyInput extends Input {\n    constructor(element, callback, options) {\n        super(element, callback, options);\n        this.handleEvent = (event) => {\n            // Ignore if focused on text input\n            const targetElement = (event.target || event.srcElement);\n            if ((targetElement.tagName === 'INPUT' && targetElement.type === 'text') ||\n                targetElement.tagName === 'TEXTAREA') {\n                return;\n            }\n            if (this.enableDownEvent && event.type === 'keydown') {\n                this.callback({\n                    type: DOWN_EVENT_TYPE,\n                    srcEvent: event,\n                    key: event.key,\n                    target: event.target\n                });\n            }\n            if (this.enableUpEvent && event.type === 'keyup') {\n                this.callback({\n                    type: UP_EVENT_TYPE,\n                    srcEvent: event,\n                    key: event.key,\n                    target: event.target\n                });\n            }\n        };\n        this.enableDownEvent = this.options.enable;\n        this.enableUpEvent = this.options.enable;\n        this.events = (this.options.events || []).concat(KEY_EVENTS);\n        element.tabIndex = this.options.tabIndex || 0;\n        element.style.outline = 'none';\n        this.events.forEach(event => element.addEventListener(event, this.handleEvent));\n    }\n    destroy() {\n        this.events.forEach(event => this.element.removeEventListener(event, this.handleEvent));\n    }\n    /**\n     * Enable this input (begin processing events)\n     * if the specified event type is among those handled by this input.\n     */\n    enableEventType(eventType, enabled) {\n        if (eventType === DOWN_EVENT_TYPE) {\n            this.enableDownEvent = enabled;\n        }\n        if (eventType === UP_EVENT_TYPE) {\n            this.enableUpEvent = enabled;\n        }\n    }\n}\n//# sourceMappingURL=key-input.js.map","import Input from './input';\nconst EVENT_TYPE = 'contextmenu';\nexport default class ContextmenuInput extends Input {\n    constructor(element, callback, options) {\n        super(element, callback, options);\n        this.handleEvent = (event) => {\n            if (!this.options.enable) {\n                return;\n            }\n            this.callback({\n                type: EVENT_TYPE,\n                center: {\n                    x: event.clientX,\n                    y: event.clientY\n                },\n                srcEvent: event,\n                pointerType: 'mouse',\n                target: event.target\n            });\n        };\n        element.addEventListener('contextmenu', this.handleEvent);\n    }\n    destroy() {\n        this.element.removeEventListener('contextmenu', this.handleEvent);\n    }\n    /**\n     * Enable this input (begin processing events)\n     * if the specified event type is among those handled by this input.\n     */\n    enableEventType(eventType, enabled) {\n        if (eventType === EVENT_TYPE) {\n            this.options.enable = enabled;\n        }\n    }\n}\n//# sourceMappingURL=contextmenu-input.js.map","/* Constants */\nconst DOWN_EVENT = 1;\nconst MOVE_EVENT = 2;\nconst UP_EVENT = 4;\nconst MOUSE_EVENTS = {\n    pointerdown: DOWN_EVENT,\n    pointermove: MOVE_EVENT,\n    pointerup: UP_EVENT,\n    mousedown: DOWN_EVENT,\n    mousemove: MOVE_EVENT,\n    mouseup: UP_EVENT\n};\n// MouseEvent.which https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/which\nconst MOUSE_EVENT_WHICH_LEFT = 1;\nconst MOUSE_EVENT_WHICH_MIDDLE = 2;\nconst MOUSE_EVENT_WHICH_RIGHT = 3;\n// MouseEvent.button https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/button\nconst MOUSE_EVENT_BUTTON_LEFT = 0;\nconst MOUSE_EVENT_BUTTON_MIDDLE = 1;\nconst MOUSE_EVENT_BUTTON_RIGHT = 2;\n// MouseEvent.buttons https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/buttons\nconst MOUSE_EVENT_BUTTONS_LEFT_MASK = 1;\nconst MOUSE_EVENT_BUTTONS_RIGHT_MASK = 2;\nconst MOUSE_EVENT_BUTTONS_MIDDLE_MASK = 4;\n/**\n * Extract the involved mouse button\n */\nexport function whichButtons(event) {\n    const eventType = MOUSE_EVENTS[event.srcEvent.type];\n    if (!eventType) {\n        // Not a mouse evet\n        return null;\n    }\n    const { buttons, button, which } = event.srcEvent;\n    let leftButton = false;\n    let middleButton = false;\n    let rightButton = false;\n    if (\n    // button is up, need to find out which one was pressed before\n    eventType === UP_EVENT ||\n        // moving but does not support `buttons` API\n        (eventType === MOVE_EVENT && !Number.isFinite(buttons))) {\n        leftButton = which === MOUSE_EVENT_WHICH_LEFT;\n        middleButton = which === MOUSE_EVENT_WHICH_MIDDLE;\n        rightButton = which === MOUSE_EVENT_WHICH_RIGHT;\n    }\n    else if (eventType === MOVE_EVENT) {\n        leftButton = Boolean(buttons & MOUSE_EVENT_BUTTONS_LEFT_MASK);\n        middleButton = Boolean(buttons & MOUSE_EVENT_BUTTONS_MIDDLE_MASK);\n        rightButton = Boolean(buttons & MOUSE_EVENT_BUTTONS_RIGHT_MASK);\n    }\n    else if (eventType === DOWN_EVENT) {\n        leftButton = button === MOUSE_EVENT_BUTTON_LEFT;\n        middleButton = button === MOUSE_EVENT_BUTTON_MIDDLE;\n        rightButton = button === MOUSE_EVENT_BUTTON_RIGHT;\n    }\n    return { leftButton, middleButton, rightButton };\n}\n/**\n * Calculate event position relative to the root element\n */\nexport function getOffsetPosition(event, rootElement) {\n    const center = event.center;\n    // `center` is a hammer.js event property\n    if (!center) {\n        // Not a gestural event\n        return null;\n    }\n    const rect = rootElement.getBoundingClientRect();\n    // Fix scale for map affected by a CSS transform.\n    // See https://stackoverflow.com/a/26893663/3528533\n    const scaleX = rect.width / rootElement.offsetWidth || 1;\n    const scaleY = rect.height / rootElement.offsetHeight || 1;\n    // Calculate center relative to the root element\n    const offsetCenter = {\n        x: (center.x - rect.left - rootElement.clientLeft) / scaleX,\n        y: (center.y - rect.top - rootElement.clientTop) / scaleY\n    };\n    return { center, offsetCenter };\n}\n//# sourceMappingURL=event-utils.js.map","import { whichButtons, getOffsetPosition } from './event-utils';\nconst DEFAULT_OPTIONS = {\n    srcElement: 'root',\n    priority: 0\n};\nexport default class EventRegistrar {\n    constructor(eventManager) {\n        /**\n         * Handles hammerjs event\n         */\n        this.handleEvent = (event) => {\n            if (this.isEmpty()) {\n                return;\n            }\n            const mjolnirEvent = this._normalizeEvent(event);\n            let target = event.srcEvent.target;\n            while (target && target !== mjolnirEvent.rootElement) {\n                this._emit(mjolnirEvent, target);\n                if (mjolnirEvent.handled) {\n                    return;\n                }\n                target = target.parentNode;\n            }\n            this._emit(mjolnirEvent, 'root');\n        };\n        this.eventManager = eventManager;\n        this.handlers = [];\n        // Element -> handler map\n        this.handlersByElement = new Map();\n        this._active = false;\n    }\n    // Returns true if there are no non-passive handlers\n    isEmpty() {\n        return !this._active;\n    }\n    add(type, handler, options, once = false, passive = false) {\n        const { handlers, handlersByElement } = this;\n        let opts = DEFAULT_OPTIONS;\n        if (typeof options === 'string' || (options && options.addEventListener)) {\n            // is DOM element, backward compatibility\n            // @ts-ignore\n            opts = { ...DEFAULT_OPTIONS, srcElement: options };\n        }\n        else if (options) {\n            opts = { ...DEFAULT_OPTIONS, ...options };\n        }\n        let entries = handlersByElement.get(opts.srcElement);\n        if (!entries) {\n            entries = [];\n            handlersByElement.set(opts.srcElement, entries);\n        }\n        const entry = {\n            type,\n            handler,\n            srcElement: opts.srcElement,\n            priority: opts.priority\n        };\n        if (once) {\n            entry.once = true;\n        }\n        if (passive) {\n            entry.passive = true;\n        }\n        handlers.push(entry);\n        this._active = this._active || !entry.passive;\n        // Sort handlers by descending priority\n        // Handlers with the same priority are excuted in the order of registration\n        let insertPosition = entries.length - 1;\n        while (insertPosition >= 0) {\n            if (entries[insertPosition].priority >= entry.priority) {\n                break;\n            }\n            insertPosition--;\n        }\n        entries.splice(insertPosition + 1, 0, entry);\n    }\n    remove(type, handler) {\n        const { handlers, handlersByElement } = this;\n        for (let i = handlers.length - 1; i >= 0; i--) {\n            const entry = handlers[i];\n            if (entry.type === type && entry.handler === handler) {\n                handlers.splice(i, 1);\n                const entries = handlersByElement.get(entry.srcElement);\n                entries.splice(entries.indexOf(entry), 1);\n                if (entries.length === 0) {\n                    handlersByElement.delete(entry.srcElement);\n                }\n            }\n        }\n        this._active = handlers.some(entry => !entry.passive);\n    }\n    /**\n     * Invoke handlers on a particular element\n     */\n    _emit(event, srcElement) {\n        const entries = this.handlersByElement.get(srcElement);\n        if (entries) {\n            let immediatePropagationStopped = false;\n            // Prevents the current event from bubbling up\n            const stopPropagation = () => {\n                event.handled = true;\n            };\n            // Prevent any remaining listeners from being called\n            const stopImmediatePropagation = () => {\n                event.handled = true;\n                immediatePropagationStopped = true;\n            };\n            const entriesToRemove = [];\n            for (let i = 0; i < entries.length; i++) {\n                const { type, handler, once } = entries[i];\n                handler({\n                    ...event,\n                    // @ts-ignore\n                    type,\n                    stopPropagation,\n                    stopImmediatePropagation\n                });\n                if (once) {\n                    entriesToRemove.push(entries[i]);\n                }\n                if (immediatePropagationStopped) {\n                    break;\n                }\n            }\n            for (let i = 0; i < entriesToRemove.length; i++) {\n                const { type, handler } = entriesToRemove[i];\n                this.remove(type, handler);\n            }\n        }\n    }\n    /**\n     * Normalizes hammerjs and custom events to have predictable fields.\n     */\n    _normalizeEvent(event) {\n        const rootElement = this.eventManager.getElement();\n        return {\n            ...event,\n            ...whichButtons(event),\n            ...getOffsetPosition(event, rootElement),\n            preventDefault: () => {\n                event.srcEvent.preventDefault();\n            },\n            stopImmediatePropagation: null,\n            stopPropagation: null,\n            handled: false,\n            rootElement\n        };\n    }\n}\n//# sourceMappingURL=event-registrar.js.map","import { Manager } from './utils/hammer';\nimport WheelInput from './inputs/wheel-input';\nimport MoveInput from './inputs/move-input';\nimport KeyInput from './inputs/key-input';\nimport ContextmenuInput from './inputs/contextmenu-input';\nimport EventRegistrar from './utils/event-registrar';\nimport { BASIC_EVENT_ALIASES, EVENT_RECOGNIZER_MAP, GESTURE_EVENT_ALIASES, RECOGNIZERS, RECOGNIZER_COMPATIBLE_MAP, RECOGNIZER_FALLBACK_MAP } from './constants';\nconst DEFAULT_OPTIONS = {\n    // event handlers\n    events: null,\n    // custom recognizers\n    recognizers: null,\n    recognizerOptions: {},\n    // Manager class\n    Manager,\n    // allow browser default touch action\n    // https://github.com/uber/react-map-gl/issues/506\n    touchAction: 'none',\n    tabIndex: 0\n};\n// Unified API for subscribing to events about both\n// basic input events (e.g. 'mousemove', 'touchstart', 'wheel')\n// and gestural input (e.g. 'click', 'tap', 'panstart').\n// Delegates gesture related event registration and handling to Hammer.js.\nexport default class EventManager {\n    constructor(element = null, options) {\n        /**\n         * Handle basic events using the 'hammer.input' Hammer.js API:\n         * Before running Recognizers, Hammer emits a 'hammer.input' event\n         * with the basic event info. This function emits all basic events\n         * aliased to the \"class\" of event received.\n         * See constants.BASIC_EVENT_CLASSES basic event class definitions.\n         */\n        this._onBasicInput = (event) => {\n            const { srcEvent } = event;\n            const alias = BASIC_EVENT_ALIASES[srcEvent.type];\n            if (alias) {\n                // fire all events aliased to srcEvent.type\n                this.manager.emit(alias, event);\n            }\n        };\n        /**\n         * Handle events not supported by Hammer.js,\n         * and pipe back out through same (Hammer) channel used by other events.\n         */\n        this._onOtherEvent = (event) => {\n            // console.log('onotherevent', event.type, event)\n            this.manager.emit(event.type, event);\n        };\n        this.options = { ...DEFAULT_OPTIONS, ...options };\n        this.events = new Map();\n        this.setElement(element);\n        // Register all passed events.\n        const { events } = this.options;\n        if (events) {\n            this.on(events);\n        }\n    }\n    getElement() {\n        return this.element;\n    }\n    setElement(element) {\n        if (this.element) {\n            // unregister all events\n            this.destroy();\n        }\n        this.element = element;\n        if (!element) {\n            return;\n        }\n        const { options } = this;\n        const ManagerClass = options.Manager;\n        this.manager = new ManagerClass(element, {\n            touchAction: options.touchAction,\n            recognizers: options.recognizers || RECOGNIZERS\n        }).on('hammer.input', this._onBasicInput);\n        if (!options.recognizers) {\n            // Set default recognize withs\n            // http://hammerjs.github.io/recognize-with/\n            Object.keys(RECOGNIZER_COMPATIBLE_MAP).forEach(name => {\n                const recognizer = this.manager.get(name);\n                if (recognizer) {\n                    RECOGNIZER_COMPATIBLE_MAP[name].forEach(otherName => {\n                        recognizer.recognizeWith(otherName);\n                    });\n                }\n            });\n        }\n        // Set recognizer options\n        for (const recognizerName in options.recognizerOptions) {\n            const recognizer = this.manager.get(recognizerName);\n            if (recognizer) {\n                const recognizerOption = options.recognizerOptions[recognizerName];\n                // `enable` is managed by the event registrations\n                delete recognizerOption.enable;\n                recognizer.set(recognizerOption);\n            }\n        }\n        // Handle events not handled by Hammer.js:\n        // - mouse wheel\n        // - pointer/touch/mouse move\n        this.wheelInput = new WheelInput(element, this._onOtherEvent, {\n            enable: false\n        });\n        this.moveInput = new MoveInput(element, this._onOtherEvent, {\n            enable: false\n        });\n        this.keyInput = new KeyInput(element, this._onOtherEvent, {\n            enable: false,\n            tabIndex: options.tabIndex\n        });\n        this.contextmenuInput = new ContextmenuInput(element, this._onOtherEvent, {\n            enable: false\n        });\n        // Register all existing events\n        for (const [eventAlias, eventRegistrar] of this.events) {\n            if (!eventRegistrar.isEmpty()) {\n                // Enable recognizer for this event.\n                this._toggleRecognizer(eventRegistrar.recognizerName, true);\n                this.manager.on(eventAlias, eventRegistrar.handleEvent);\n            }\n        }\n    }\n    // Tear down internal event management implementations.\n    destroy() {\n        if (this.element) {\n            // wheelInput etc. are created in setElement() and therefore\n            // cannot exist if there is no element\n            this.wheelInput.destroy();\n            this.moveInput.destroy();\n            this.keyInput.destroy();\n            this.contextmenuInput.destroy();\n            this.manager.destroy();\n            this.wheelInput = null;\n            this.moveInput = null;\n            this.keyInput = null;\n            this.contextmenuInput = null;\n            this.manager = null;\n            this.element = null;\n        }\n    }\n    /** Register an event handler function to be called on `event` */\n    on(event, handler, opts) {\n        this._addEventHandler(event, handler, opts, false);\n    }\n    once(event, handler, opts) {\n        this._addEventHandler(event, handler, opts, true);\n    }\n    watch(event, handler, opts) {\n        this._addEventHandler(event, handler, opts, false, true);\n    }\n    off(event, handler) {\n        this._removeEventHandler(event, handler);\n    }\n    /*\n     * Enable/disable recognizer for the given event\n     */\n    _toggleRecognizer(name, enabled) {\n        const { manager } = this;\n        if (!manager) {\n            return;\n        }\n        const recognizer = manager.get(name);\n        // @ts-ignore\n        if (recognizer && recognizer.options.enable !== enabled) {\n            recognizer.set({ enable: enabled });\n            const fallbackRecognizers = RECOGNIZER_FALLBACK_MAP[name];\n            if (fallbackRecognizers && !this.options.recognizers) {\n                // Set default require failures\n                // http://hammerjs.github.io/require-failure/\n                fallbackRecognizers.forEach(otherName => {\n                    const otherRecognizer = manager.get(otherName);\n                    if (enabled) {\n                        // Wait for this recognizer to fail\n                        otherRecognizer.requireFailure(name);\n                        /**\n                         * This seems to be a bug in hammerjs:\n                         * requireFailure() adds both ways\n                         * dropRequireFailure() only drops one way\n                         * https://github.com/hammerjs/hammer.js/blob/master/src/recognizerjs/\n                           recognizer-constructor.js#L136\n                         */\n                        recognizer.dropRequireFailure(otherName);\n                    }\n                    else {\n                        // Do not wait for this recognizer to fail\n                        otherRecognizer.dropRequireFailure(name);\n                    }\n                });\n            }\n        }\n        this.wheelInput.enableEventType(name, enabled);\n        this.moveInput.enableEventType(name, enabled);\n        this.keyInput.enableEventType(name, enabled);\n        this.contextmenuInput.enableEventType(name, enabled);\n    }\n    /**\n     * Process the event registration for a single event + handler.\n     */\n    _addEventHandler(event, handler, opts, once, passive) {\n        if (typeof event !== 'string') {\n            // @ts-ignore\n            opts = handler;\n            // If `event` is a map, call `on()` for each entry.\n            for (const eventName in event) {\n                this._addEventHandler(eventName, event[eventName], opts, once, passive);\n            }\n            return;\n        }\n        const { manager, events } = this;\n        // Alias to a recognized gesture as necessary.\n        const eventAlias = GESTURE_EVENT_ALIASES[event] || event;\n        let eventRegistrar = events.get(eventAlias);\n        if (!eventRegistrar) {\n            eventRegistrar = new EventRegistrar(this);\n            events.set(eventAlias, eventRegistrar);\n            // Enable recognizer for this event.\n            eventRegistrar.recognizerName = EVENT_RECOGNIZER_MAP[eventAlias] || eventAlias;\n            // Listen to the event\n            if (manager) {\n                manager.on(eventAlias, eventRegistrar.handleEvent);\n            }\n        }\n        eventRegistrar.add(event, handler, opts, once, passive);\n        if (!eventRegistrar.isEmpty()) {\n            this._toggleRecognizer(eventRegistrar.recognizerName, true);\n        }\n    }\n    /**\n     * Process the event deregistration for a single event + handler.\n     */\n    _removeEventHandler(event, handler) {\n        if (typeof event !== 'string') {\n            // If `event` is a map, call `off()` for each entry.\n            for (const eventName in event) {\n                this._removeEventHandler(eventName, event[eventName]);\n            }\n            return;\n        }\n        const { events } = this;\n        // Alias to a recognized gesture as necessary.\n        const eventAlias = GESTURE_EVENT_ALIASES[event] || event;\n        const eventRegistrar = events.get(eventAlias);\n        if (!eventRegistrar) {\n            return;\n        }\n        eventRegistrar.remove(event, handler);\n        if (eventRegistrar.isEmpty()) {\n            const { recognizerName } = eventRegistrar;\n            // Disable recognizer if no more handlers are attached to its events\n            let isRecognizerUsed = false;\n            for (const eh of events.values()) {\n                if (eh.recognizerName === recognizerName && !eh.isEmpty()) {\n                    isRecognizerUsed = true;\n                    break;\n                }\n            }\n            if (!isRecognizerUsed) {\n                this._toggleRecognizer(recognizerName, false);\n            }\n        }\n    }\n}\n//# sourceMappingURL=event-manager.js.map","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport LayerManager from './layer-manager';\nimport ViewManager from './view-manager';\nimport MapView from '../views/map-view';\nimport EffectManager from './effect-manager';\nimport DeckRenderer from './deck-renderer';\nimport DeckPicker from './deck-picker';\nimport Tooltip from './tooltip';\nimport log from '../utils/log';\nimport {deepEqual} from '../utils/deep-equal';\nimport typedArrayManager from '../utils/typed-array-manager';\nimport deckGlobal from './init';\n\nimport {getBrowser} from '@probe.gl/env';\nimport GL from '@luma.gl/constants';\nimport {\n  AnimationLoop,\n  createGLContext,\n  instrumentGLContext,\n  setParameters,\n  Timeline,\n  lumaStats\n} from '@luma.gl/core';\nimport {Stats} from '@probe.gl/stats';\nimport {EventManager} from 'mjolnir.js';\n\nimport assert from '../utils/assert';\nimport {EVENTS} from './constants';\n\nimport type {Effect} from './effect';\nimport type {FilterContext} from '../passes/layers-pass';\nimport type Layer from './layer';\nimport type View from '../views/view';\nimport type Viewport from '../viewports/viewport';\nimport type {RecognizerOptions, MjolnirGestureEvent, MjolnirPointerEvent} from 'mjolnir.js';\nimport type {Framebuffer} from '@luma.gl/core';\nimport type {TypedArrayManagerOptions} from '../utils/typed-array-manager';\nimport type {ViewStateChangeParameters, InteractionState} from '../controllers/controller';\nimport type {PickingInfo} from './picking/pick-info';\nimport type {PickByPointOptions, PickByRectOptions} from './deck-picker';\nimport type {LayersList} from './layer-manager';\nimport type {TooltipContent} from './tooltip';\n\n/* global document */\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction noop() {}\n\nconst getCursor = ({isDragging}) => (isDragging ? 'grabbing' : 'grab');\n\nexport type DeckMetrics = {\n  fps: number;\n  setPropsTime: number;\n  updateAttributesTime: number;\n  framesRedrawn: number;\n  pickTime: number;\n  pickCount: number;\n  gpuTime: number;\n  gpuTimePerFrame: number;\n  cpuTime: number;\n  cpuTimePerFrame: number;\n  bufferMemory: number;\n  textureMemory: number;\n  renderbufferMemory: number;\n  gpuMemory: number;\n};\n\ntype CursorState = {\n  /** Whether the cursor is over a pickable object */\n  isHovering: boolean;\n  /** Whether the cursor is down */\n  isDragging: boolean;\n};\n\nexport type DeckProps = {\n  /** Id of this Deck instance */\n  id?: string;\n  /** Width of the canvas, a number in pixels or a valid CSS string.\n   * @default `'100%'`\n   */\n  width?: string | number | null;\n  /** Height of the canvas, a number in pixels or a valid CSS string.\n   * @default `'100%'`\n   */\n  height?: string | number | null;\n  /** Additional CSS styles for the canvas. */\n  style?: Partial<CSSStyleDeclaration> | null;\n\n  /** Controls the resolution of drawing buffer used for rendering.\n   * @default `true` (use browser devicePixelRatio)\n   */\n  useDevicePixels?: boolean | number;\n  /** Extra pixels around the pointer to include while picking.\n   * @default `0`\n   */\n  pickingRadius?: number;\n\n  /** WebGL parameters to be set before each frame is rendered.\n   * @see https://github.com/visgl/luma.gl/blob/8.5-release/modules/gltools/docs/api-reference/parameter-setting.md#parameters\n   */\n  parameters?: any;\n  /** If supplied, will be called before a layer is drawn to determine whether it should be rendered. */\n  layerFilter?: ((context: FilterContext) => boolean) | null;\n\n  /** The container to append the auto-created canvas to.\n   * @default `document.body`\n   */\n  parent?: HTMLDivElement | null;\n  /** The canvas to render into.\n   * Can be either a HTMLCanvasElement or the element id.\n   * Will be auto-created if not supplied.\n   */\n  canvas?: HTMLCanvasElement | string | null;\n  /** WebGL context. Will be auto-created if not supplied. */\n  gl?: WebGLRenderingContext | null;\n  /** Additional options used when creating the WebGL context. */\n  glOptions?: WebGLContextAttributes;\n\n  /**\n   * The array of Layer instances to be rendered.\n   * Nested arrays are accepted, as well as falsy values (`null`, `false`, `undefined`)\n   */\n  layers?: LayersList;\n  /** The array of effects to be rendered. A lighting effect will be added if an empty array is supplied. */\n  effects?: Effect[];\n  /** A single View instance, or an array of `View` instances.\n   * @default `new MapView()`\n   */\n  views?: View | View[] | null;\n  /** Options for viewport interactivity, e.g. pan, rotate and zoom with mouse, touch and keyboard.\n   * This is a shorthand for defining interaction with the `views` prop if you are using the default view (i.e. a single `MapView`)\n   */\n  controller?: View['props']['controller'];\n  /**\n   * An object that describes the view state for each view in the `views` prop.\n   * Use if the camera state should be managed external to the `Deck` instance.\n   */\n  viewState?: any;\n  /**\n   * If provided, the `Deck` instance will track camera state changes automatically,\n   * with `initialViewState` as its initial settings.\n   */\n  initialViewState?: any;\n\n  /** Allow browser default touch actions.\n   * @default `'none'`\n   */\n  touchAction?: string;\n  /** Set Hammer.js recognizer options for gesture recognition. See documentation for details. */\n  eventRecognizerOptions?: {\n    [type: string]: RecognizerOptions;\n  };\n\n  /** (Experimental) Render to a custom frame buffer other than to screen. */\n  _framebuffer?: Framebuffer | null;\n  /** (Experimental) Forces deck.gl to redraw layers every animation frame. */\n  _animate?: boolean;\n  /** (Experimental) If set to `false`, force disables all picking features, disregarding the `pickable` prop set in any layer. */\n  _pickable?: boolean;\n  /** (Experimental) Fine-tune attribute memory usage. See documentation for details. */\n  _typedArrayManagerProps?: TypedArrayManagerOptions;\n\n  /** Called once the WebGL context has been initiated. */\n  onWebGLInitialized?: (gl: WebGLRenderingContext) => void;\n  /** Called when the canvas resizes. */\n  onResize?: (dimensions: {width: number; height: number}) => void;\n  /** Called when the user has interacted with the deck.gl canvas, e.g. using mouse, touch or keyboard. */\n  onViewStateChange?: (params: ViewStateChangeParameters & {viewId: string}) => any;\n  /** Called when the user has interacted with the deck.gl canvas, e.g. using mouse, touch or keyboard. */\n  onInteractionStateChange?: (state: InteractionState) => void;\n  /** Called just before the canvas rerenders. */\n  onBeforeRender?: (context: {gl: WebGLRenderingContext}) => void;\n  /** Called right after the canvas rerenders. */\n  onAfterRender?: (context: {gl: WebGLRenderingContext}) => void;\n  /** Called once after gl context and all Deck components are created. */\n  onLoad?: () => void;\n  /** Called if deck.gl encounters an error.\n   * If this callback is set to `null`, errors are silently ignored.\n   * @default `console.error`\n   */\n  onError?: ((error: Error, layer?: Layer) => void) | null;\n  /** Called when the pointer moves over the canvas. */\n  onHover?: ((info: PickingInfo, event: MjolnirPointerEvent) => void) | null;\n  /** Called when clicking on the canvas. */\n  onClick?: ((info: PickingInfo, event: MjolnirGestureEvent) => void) | null;\n  /** Called when the user starts dragging on the canvas. */\n  onDragStart?: ((info: PickingInfo, event: MjolnirGestureEvent) => void) | null;\n  /** Called when dragging the canvas. */\n  onDrag?: ((info: PickingInfo, event: MjolnirGestureEvent) => void) | null;\n  /** Called when the user releases from dragging the canvas. */\n  onDragEnd?: ((info: PickingInfo, event: MjolnirGestureEvent) => void) | null;\n\n  /** (Experimental) Replace the default redraw procedure */\n  _customRender?: ((reason: string) => void) | null;\n  /** (Experimental) Called once every second with performance metrics. */\n  _onMetrics?: ((metrics: DeckMetrics) => void) | null;\n\n  /** A custom callback to retrieve the cursor type. */\n  getCursor?: (state: CursorState) => string;\n  /** Callback that takes a hovered-over point and renders a tooltip. */\n  getTooltip?: ((info: PickingInfo) => TooltipContent) | null;\n\n  /** (Debug) Flag to enable WebGL debug mode. Requires importing `@luma.gl/debug`. */\n  debug?: boolean;\n  /** (Debug) Render the picking buffer to screen. */\n  drawPickingColors?: boolean;\n};\n\nconst defaultProps = {\n  id: '',\n  width: '100%',\n  height: '100%',\n  style: null,\n  viewState: null,\n  initialViewState: null,\n  pickingRadius: 0,\n  layerFilter: null,\n  glOptions: {},\n  parameters: {},\n  parent: null,\n  gl: null,\n  canvas: null,\n  layers: [],\n  effects: [],\n  views: null,\n  controller: null, // Rely on external controller, e.g. react-map-gl\n  useDevicePixels: true,\n  touchAction: 'none',\n  eventRecognizerOptions: {},\n  _framebuffer: null,\n  _animate: false,\n  _pickable: true,\n  _typedArrayManagerProps: {},\n  _customRender: null,\n\n  onWebGLInitialized: noop,\n  onResize: noop,\n  onViewStateChange: noop,\n  onInteractionStateChange: noop,\n  onBeforeRender: noop,\n  onAfterRender: noop,\n  onLoad: noop,\n  onError: (error: Error) => log.error(error.message)(),\n  onHover: null,\n  onClick: null,\n  onDragStart: null,\n  onDrag: null,\n  onDragEnd: null,\n  _onMetrics: null,\n\n  getCursor,\n  getTooltip: null,\n\n  debug: false,\n  drawPickingColors: false\n};\n\n/* eslint-disable max-statements */\nexport default class Deck {\n  static defaultProps = defaultProps;\n  // This is used to defeat tree shaking of init.js\n  // https://github.com/visgl/deck.gl/issues/3213\n  static VERSION = deckGlobal.VERSION;\n\n  readonly props: Required<DeckProps>;\n  readonly width: number = 0;\n  readonly height: number = 0;\n  // Allows attaching arbitrary data to the instance\n  readonly userData: Record<string, any> = {};\n\n  protected canvas: HTMLCanvasElement | null = null;\n  protected viewManager: ViewManager | null = null;\n  protected layerManager: LayerManager | null = null;\n  protected effectManager: EffectManager | null = null;\n  protected deckRenderer: DeckRenderer | null = null;\n  protected deckPicker: DeckPicker | null = null;\n  protected eventManager: EventManager | null = null;\n  protected tooltip: Tooltip | null = null;\n  protected metrics: DeckMetrics;\n  protected animationLoop: AnimationLoop;\n  protected stats: Stats;\n\n  /** Internal view state if no callback is supplied */\n  protected viewState: any;\n  protected cursorState: CursorState;\n\n  private _needsRedraw: false | string;\n  private _pickRequest: {\n    mode: string;\n    event: MjolnirPointerEvent | null;\n    x: number;\n    y: number;\n    radius: number;\n  };\n  /**\n   * Pick and store the object under the pointer on `pointerdown`.\n   * This object is reused for subsequent `onClick` and `onDrag*` callbacks.\n   */\n  private _lastPointerDownInfo: PickingInfo | null = null;\n  private _metricsCounter: number;\n\n  constructor(props: DeckProps) {\n    this.props = {...defaultProps, ...props};\n    props = this.props;\n\n    this._needsRedraw = 'Initial render';\n    this._pickRequest = {\n      mode: 'hover',\n      x: -1,\n      y: -1,\n      radius: 0,\n      event: null\n    };\n\n    this.cursorState = {\n      isHovering: false,\n      isDragging: false\n    };\n\n    if (props.viewState && props.initialViewState) {\n      log.warn(\n        'View state tracking is disabled. Use either `initialViewState` for auto update or `viewState` for manual update.'\n      )();\n    }\n    if (getBrowser() === 'IE') {\n      log.warn('IE 11 is not supported')();\n    }\n    this.viewState = props.initialViewState;\n\n    if (!props.gl) {\n      // Note: LayerManager creation deferred until gl context available\n      if (typeof document !== 'undefined') {\n        this.canvas = this._createCanvas(props);\n      }\n    }\n    this.animationLoop = this._createAnimationLoop(props);\n\n    this.stats = new Stats({id: 'deck.gl'});\n    this.metrics = {\n      fps: 0,\n      setPropsTime: 0,\n      updateAttributesTime: 0,\n      framesRedrawn: 0,\n      pickTime: 0,\n      pickCount: 0,\n      gpuTime: 0,\n      gpuTimePerFrame: 0,\n      cpuTime: 0,\n      cpuTimePerFrame: 0,\n      bufferMemory: 0,\n      textureMemory: 0,\n      renderbufferMemory: 0,\n      gpuMemory: 0\n    };\n    this._metricsCounter = 0;\n\n    this.setProps(props);\n\n    // UNSAFE/experimental prop: only set at initialization to avoid performance hit\n    if (props._typedArrayManagerProps) {\n      typedArrayManager.setOptions(props._typedArrayManagerProps);\n    }\n\n    this.animationLoop.start();\n  }\n\n  /** Stop rendering and dispose all resources */\n  finalize() {\n    this.animationLoop.stop();\n    this.animationLoop = null;\n    this._lastPointerDownInfo = null;\n\n    this.layerManager?.finalize();\n    this.layerManager = null;\n\n    this.viewManager?.finalize();\n    this.viewManager = null;\n\n    this.effectManager?.finalize();\n    this.effectManager = null;\n\n    this.deckRenderer?.finalize();\n    this.deckRenderer = null;\n\n    this.deckPicker?.finalize();\n    this.deckPicker = null;\n\n    this.eventManager?.destroy();\n    this.eventManager = null;\n\n    this.tooltip?.remove();\n    this.tooltip = null;\n\n    if (!this.props.canvas && !this.props.gl && this.canvas) {\n      // remove internally created canvas\n      this.canvas.parentElement?.removeChild(this.canvas);\n      this.canvas = null;\n    }\n  }\n\n  /** Partially update props */\n  setProps(props: DeckProps): void {\n    this.stats.get('setProps Time').timeStart();\n\n    if ('onLayerHover' in props) {\n      log.removed('onLayerHover', 'onHover')();\n    }\n    if ('onLayerClick' in props) {\n      log.removed('onLayerClick', 'onClick')();\n    }\n    if (props.initialViewState && !deepEqual(this.props.initialViewState, props.initialViewState)) {\n      // Overwrite internal view state\n      this.viewState = props.initialViewState;\n    }\n\n    // Merge with existing props\n    Object.assign(this.props, props);\n\n    // Update CSS size of canvas\n    this._setCanvasSize(this.props);\n\n    // We need to overwrite CSS style width and height with actual, numeric values\n    const resolvedProps: Required<DeckProps> & {\n      width: number;\n      height: number;\n      views: View[];\n      viewState: Record<string, any>;\n    } = Object.create(this.props);\n    Object.assign(resolvedProps, {\n      views: this._getViews(),\n      width: this.width,\n      height: this.height,\n      viewState: this._getViewState()\n    });\n\n    // Update the animation loop\n    this.animationLoop.setProps(resolvedProps);\n\n    // If initialized, update sub manager props\n    if (this.layerManager) {\n      this.viewManager!.setProps(resolvedProps);\n      // Make sure that any new layer gets initialized with the current viewport\n      this.layerManager.activateViewport(this.getViewports()[0]);\n      this.layerManager.setProps(resolvedProps);\n      this.effectManager!.setProps(resolvedProps);\n      this.deckRenderer!.setProps(resolvedProps);\n      this.deckPicker!.setProps(resolvedProps);\n    }\n\n    this.stats.get('setProps Time').timeEnd();\n  }\n\n  // Public API\n\n  /**\n   * Check if a redraw is needed\n   * @returns `false` or a string summarizing the redraw reason\n   */\n  needsRedraw(\n    opts: {\n      /** Reset the redraw flag afterwards. Default `true` */\n      clearRedrawFlags: boolean;\n    } = {clearRedrawFlags: false}\n  ): false | string {\n    if (!this.layerManager) {\n      // Not initialized or already finalized\n      return false;\n    }\n    if (this.props._animate) {\n      return 'Deck._animate';\n    }\n\n    let redraw: false | string = this._needsRedraw;\n\n    if (opts.clearRedrawFlags) {\n      this._needsRedraw = false;\n    }\n\n    const viewManagerNeedsRedraw = this.viewManager!.needsRedraw(opts);\n    const layerManagerNeedsRedraw = this.layerManager.needsRedraw(opts);\n    const effectManagerNeedsRedraw = this.effectManager!.needsRedraw(opts);\n    const deckRendererNeedsRedraw = this.deckRenderer!.needsRedraw(opts);\n\n    redraw =\n      redraw ||\n      viewManagerNeedsRedraw ||\n      layerManagerNeedsRedraw ||\n      effectManagerNeedsRedraw ||\n      deckRendererNeedsRedraw;\n    return redraw;\n  }\n\n  /**\n   * Redraw the GL context\n   * @param reason If not provided, only redraw if deemed necessary. Otherwise redraw regardless of internal states.\n   * @returns\n   */\n  redraw(reason?: string): void {\n    if (!this.layerManager) {\n      // Not yet initialized\n      return;\n    }\n    // Check if we need to redraw\n    let redrawReason = this.needsRedraw({clearRedrawFlags: true});\n    // User-supplied should take precedent, however the redraw flags get cleared regardless\n    redrawReason = reason || redrawReason;\n\n    if (!redrawReason) {\n      return;\n    }\n\n    this.stats.get('Redraw Count').incrementCount();\n    if (this.props._customRender) {\n      this.props._customRender(redrawReason);\n    } else {\n      this._drawLayers(redrawReason);\n    }\n  }\n\n  /** Flag indicating that the Deck instance has initialized its resources and it's safe to call public methods. */\n  get isInitialized(): boolean {\n    return this.viewManager !== null;\n  }\n\n  /** Get a list of views that are currently rendered */\n  getViews(): View[] {\n    assert(this.viewManager);\n    return this.viewManager.views;\n  }\n\n  /** Get a list of viewports that are currently rendered.\n   * @param rect If provided, only returns viewports within the given bounding box.\n   */\n  getViewports(rect?: {x: number; y: number; width?: number; height?: number}): Viewport[] {\n    assert(this.viewManager);\n    return this.viewManager.getViewports(rect);\n  }\n\n  /** Query the object rendered on top at a given point */\n  pickObject(opts: {\n    /** x position in pixels */\n    x: number;\n    /** y position in pixels */\n    y: number;\n    /** Radius of tolerance in pixels. Default `0`. */\n    radius?: number;\n    /** A list of layer ids to query from. If not specified, then all pickable and visible layers are queried. */\n    layerIds?: string[];\n    /** If `true`, `info.coordinate` will be a 3D point by unprojecting the `x, y` screen coordinates onto the picked geometry. Default `false`. */\n    unproject3D?: boolean;\n  }): PickingInfo | null {\n    const infos = this._pick('pickObject', 'pickObject Time', opts).result;\n    return infos.length ? infos[0] : null;\n  }\n\n  /* Query all rendered objects at a given point */\n  pickMultipleObjects(opts: {\n    /** x position in pixels */\n    x: number;\n    /** y position in pixels */\n    y: number;\n    /** Radius of tolerance in pixels. Default `0`. */\n    radius?: number;\n    /** Specifies the max number of objects to return. Default `10`. */\n    depth?: number;\n    /** A list of layer ids to query from. If not specified, then all pickable and visible layers are queried. */\n    layerIds?: string[];\n    /** If `true`, `info.coordinate` will be a 3D point by unprojecting the `x, y` screen coordinates onto the picked geometry. Default `false`. */\n    unproject3D?: boolean;\n  }): PickingInfo[] {\n    opts.depth = opts.depth || 10;\n    return this._pick('pickObject', 'pickMultipleObjects Time', opts).result;\n  }\n\n  /* Query all objects rendered on top within a bounding box */\n  pickObjects(opts: {\n    /** Left of the bounding box in pixels */\n    x: number;\n    /** Top of the bounding box in pixels */\n    y: number;\n    /** Width of the bounding box in pixels. Default `1` */\n    width?: number;\n    /** Height of the bounding box in pixels. Default `1` */\n    height?: number;\n    /** A list of layer ids to query from. If not specified, then all pickable and visible layers are queried. */\n    layerIds?: string[];\n    /** If specified, limits the number of objects that can be returned. */\n    maxObjects?: number | null;\n  }): PickingInfo[] {\n    return this._pick('pickObjects', 'pickObjects Time', opts);\n  }\n\n  /** Experimental\n   * Add a global resource for sharing among layers\n   */\n  _addResources(\n    resources: {\n      [id: string]: any;\n    },\n    forceUpdate = false\n  ) {\n    for (const id in resources) {\n      this.layerManager!.resourceManager.add({resourceId: id, data: resources[id], forceUpdate});\n    }\n  }\n\n  /** Experimental\n   * Remove a global resource\n   */\n  _removeResources(resourceIds: string[]) {\n    for (const id of resourceIds) {\n      this.layerManager!.resourceManager.remove(id);\n    }\n  }\n\n  // Private Methods\n\n  private _pick(\n    method: 'pickObject',\n    statKey: string,\n    opts: PickByPointOptions & {layerIds?: string[]}\n  ): {\n    result: PickingInfo[];\n    emptyInfo: PickingInfo;\n  };\n  private _pick(\n    method: 'pickObjects',\n    statKey: string,\n    opts: PickByRectOptions & {layerIds?: string[]}\n  ): PickingInfo[];\n\n  private _pick(\n    method: 'pickObject' | 'pickObjects',\n    statKey: string,\n    opts: (PickByPointOptions | PickByRectOptions) & {layerIds?: string[]}\n  ) {\n    assert(this.deckPicker);\n\n    const {stats} = this;\n\n    stats.get('Pick Count').incrementCount();\n    stats.get(statKey).timeStart();\n\n    const infos = this.deckPicker[method]({\n      // layerManager, viewManager and effectManager are always defined if deckPicker is\n      layers: this.layerManager!.getLayers(opts),\n      views: this.viewManager!.getViews(),\n      viewports: this.getViewports(opts),\n      onViewportActive: this.layerManager!.activateViewport,\n      effects: this.effectManager!.getEffects(),\n      ...opts\n    });\n\n    stats.get(statKey).timeEnd();\n\n    return infos;\n  }\n\n  /** Resolve props.canvas to element */\n  private _createCanvas(props: DeckProps): HTMLCanvasElement {\n    let canvas = props.canvas;\n\n    // TODO EventManager should accept element id\n    if (typeof canvas === 'string') {\n      canvas = document.getElementById(canvas) as HTMLCanvasElement;\n      assert(canvas);\n    }\n\n    if (!canvas) {\n      canvas = document.createElement('canvas');\n      canvas.id = props.id || 'deckgl-overlay';\n      const parent = props.parent || document.body;\n      parent.appendChild(canvas);\n    }\n\n    Object.assign(canvas.style, props.style);\n\n    return canvas;\n  }\n\n  /** Updates canvas width and/or height, if provided as props */\n  private _setCanvasSize(props: Required<DeckProps>): void {\n    if (!this.canvas) {\n      return;\n    }\n\n    const {width, height} = props;\n    // Set size ONLY if props are being provided, otherwise let canvas be layouted freely\n    if (width || width === 0) {\n      const cssWidth = Number.isFinite(width) ? `${width}px` : (width as string);\n      this.canvas.style.width = cssWidth;\n    }\n    if (height || height === 0) {\n      const cssHeight = Number.isFinite(height) ? `${height}px` : (height as string);\n      // Note: position==='absolute' required for height 100% to work\n      this.canvas.style.position = props.style?.position || 'absolute';\n      this.canvas.style.height = cssHeight;\n    }\n  }\n\n  /** If canvas size has changed, reads out the new size and update */\n  private _updateCanvasSize(): void {\n    const {canvas} = this;\n    if (!canvas) {\n      return;\n    }\n    // Fallback to width/height when clientWidth/clientHeight are 0 or undefined.\n    const newWidth = canvas.clientWidth || canvas.width;\n    const newHeight = canvas.clientHeight || canvas.height;\n    if (newWidth !== this.width || newHeight !== this.height) {\n      // @ts-expect-error private assign to read-only property\n      this.width = newWidth;\n      // @ts-expect-error private assign to read-only property\n      this.height = newHeight;\n      this.viewManager?.setProps({width: newWidth, height: newHeight});\n      this.props.onResize({width: newWidth, height: newHeight});\n    }\n  }\n\n  private _createAnimationLoop(props: DeckProps): AnimationLoop {\n    const {\n      width,\n      height,\n      gl,\n      glOptions,\n      debug,\n      onError,\n      onBeforeRender,\n      onAfterRender,\n      useDevicePixels\n    } = props;\n\n    return new AnimationLoop({\n      width,\n      height,\n      useDevicePixels,\n      autoResizeViewport: false,\n      gl,\n      onCreateContext: opts =>\n        createGLContext({\n          ...glOptions,\n          ...opts,\n          canvas: this.canvas,\n          debug,\n          onContextLost: () => this._onContextLost()\n        }),\n      onInitialize: context => this._setGLContext(context.gl),\n      onRender: this._onRenderFrame.bind(this),\n      onBeforeRender,\n      onAfterRender,\n      onError\n    });\n  }\n\n  // Get the most relevant view state: props.viewState, if supplied, shadows internal viewState\n  // TODO: For backwards compatibility ensure numeric width and height is added to the viewState\n  private _getViewState(): Record<string, any> {\n    return this.props.viewState || this.viewState;\n  }\n\n  // Get the view descriptor list\n  private _getViews(): View[] {\n    // Default to a full screen map view port\n    let views = this.props.views || [new MapView({id: 'default-view'})];\n    views = Array.isArray(views) ? views : [views];\n    if (views.length && this.props.controller) {\n      // Backward compatibility: support controller prop\n      views[0].props.controller = this.props.controller;\n    }\n    return views;\n  }\n\n  private _onContextLost() {\n    const {onError} = this.props;\n    if (this.animationLoop && onError) {\n      onError(new Error('WebGL context is lost'));\n    }\n  }\n\n  // The `pointermove` event may fire multiple times in between two animation frames,\n  // it's a waste of time to run picking without rerender. Instead we save the last pick\n  // request and only do it once on the next animation frame.\n  /** Internal use only: event handler for pointerdown */\n  _onPointerMove = (event: MjolnirPointerEvent) => {\n    const {_pickRequest} = this;\n    if (event.type === 'pointerleave') {\n      _pickRequest.x = -1;\n      _pickRequest.y = -1;\n      _pickRequest.radius = 0;\n    } else if (event.leftButton || event.rightButton) {\n      // Do not trigger onHover callbacks if mouse button is down.\n      return;\n    } else {\n      const pos = event.offsetCenter;\n      // Do not trigger callbacks when click/hover position is invalid. Doing so will cause a\n      // assertion error when attempting to unproject the position.\n      if (!pos) {\n        return;\n      }\n      _pickRequest.x = pos.x;\n      _pickRequest.y = pos.y;\n      _pickRequest.radius = this.props.pickingRadius;\n    }\n\n    if (this.layerManager) {\n      this.layerManager.context.mousePosition = {x: _pickRequest.x, y: _pickRequest.y};\n    }\n\n    _pickRequest.event = event;\n  };\n\n  /** Actually run picking */\n  private _pickAndCallback() {\n    const {_pickRequest} = this;\n\n    if (_pickRequest.event) {\n      // Perform picking\n      const {result, emptyInfo} = this._pick('pickObject', 'pickObject Time', _pickRequest);\n      this.cursorState.isHovering = result.length > 0;\n\n      // There are 4 possible scenarios:\n      // result is [outInfo, pickedInfo] (moved from one pickable layer to another)\n      // result is [outInfo] (moved outside of a pickable layer)\n      // result is [pickedInfo] (moved into or over a pickable layer)\n      // result is [] (nothing is or was picked)\n      //\n      // `layer.props.onHover` should be called on all affected layers (out/over)\n      // `deck.props.onHover` should be called with the picked info if any, or empty info otherwise\n      // `deck.props.getTooltip` should be called with the picked info if any, or empty info otherwise\n\n      // Execute callbacks\n      let pickedInfo = emptyInfo;\n      let handled = false;\n      for (const info of result) {\n        pickedInfo = info;\n        handled = info.layer?.onHover(info, _pickRequest.event) || handled;\n      }\n      if (!handled && this.props.onHover) {\n        this.props.onHover(pickedInfo, _pickRequest.event);\n      }\n\n      // Update tooltip\n      if (this.props.getTooltip && this.tooltip) {\n        const displayInfo = this.props.getTooltip(pickedInfo);\n        this.tooltip.setTooltip(displayInfo, pickedInfo.x, pickedInfo.y);\n      }\n\n      // Clear pending pickRequest\n      _pickRequest.event = null;\n    }\n  }\n\n  private _updateCursor(): void {\n    const container = this.props.parent || this.canvas;\n    if (container) {\n      container.style.cursor = this.props.getCursor(this.cursorState);\n    }\n  }\n\n  private _setGLContext(gl: WebGLRenderingContext) {\n    if (this.layerManager) {\n      return;\n    }\n\n    // if external context...\n    if (!this.canvas) {\n      this.canvas = gl.canvas;\n      instrumentGLContext(gl, {enable: true, copyState: true});\n    }\n\n    this.tooltip = new Tooltip(this.canvas);\n\n    setParameters(gl, {\n      blend: true,\n      blendFunc: [GL.SRC_ALPHA, GL.ONE_MINUS_SRC_ALPHA, GL.ONE, GL.ONE_MINUS_SRC_ALPHA],\n      polygonOffsetFill: true,\n      depthTest: true,\n      depthFunc: GL.LEQUAL\n    });\n\n    this.props.onWebGLInitialized(gl);\n\n    // timeline for transitions\n    const timeline = new Timeline();\n    timeline.play();\n    this.animationLoop.attachTimeline(timeline);\n\n    this.eventManager = new EventManager(this.props.parent || gl.canvas, {\n      touchAction: this.props.touchAction,\n      recognizerOptions: this.props.eventRecognizerOptions,\n      events: {\n        pointerdown: this._onPointerDown,\n        pointermove: this._onPointerMove,\n        pointerleave: this._onPointerMove\n      }\n    });\n    for (const eventType in EVENTS) {\n      this.eventManager.on(eventType as keyof typeof EVENTS, this._onEvent);\n    }\n\n    this.viewManager = new ViewManager({\n      timeline,\n      eventManager: this.eventManager,\n      onViewStateChange: this._onViewStateChange.bind(this),\n      onInteractionStateChange: this._onInteractionStateChange.bind(this),\n      views: this._getViews(),\n      viewState: this._getViewState(),\n      width: this.width,\n      height: this.height\n    });\n\n    // viewManager must be initialized before layerManager\n    // layerManager depends on viewport created by viewManager.\n    const viewport = this.viewManager.getViewports()[0];\n\n    // Note: avoid React setState due GL animation loop / setState timing issue\n    this.layerManager = new LayerManager(gl, {\n      deck: this,\n      stats: this.stats,\n      viewport,\n      timeline\n    });\n\n    this.effectManager = new EffectManager();\n\n    this.deckRenderer = new DeckRenderer(gl);\n\n    this.deckPicker = new DeckPicker(gl);\n\n    this.setProps(this.props);\n\n    this._updateCanvasSize();\n    this.props.onLoad();\n  }\n\n  /** Internal only: default render function (redraw all layers and views) */\n  _drawLayers(\n    redrawReason: string,\n    renderOptions?: {\n      target?: Framebuffer;\n      layerFilter?: (context: FilterContext) => boolean;\n      layers?: Layer[];\n      viewports?: Viewport[];\n      views?: {[viewId: string]: View};\n      pass?: string;\n      effects?: Effect[];\n      clearStack?: boolean;\n      clearCanvas?: boolean;\n    }\n  ) {\n    const {gl} = this.layerManager!.context;\n\n    setParameters(gl, this.props.parameters);\n\n    this.props.onBeforeRender({gl});\n\n    this.deckRenderer!.renderLayers({\n      target: this.props._framebuffer,\n      layers: this.layerManager!.getLayers(),\n      viewports: this.viewManager!.getViewports(),\n      onViewportActive: this.layerManager!.activateViewport,\n      views: this.viewManager!.getViews(),\n      pass: 'screen',\n      redrawReason,\n      effects: this.effectManager!.getEffects(),\n      ...renderOptions\n    });\n\n    this.props.onAfterRender({gl});\n  }\n\n  // Callbacks\n\n  private _onRenderFrame(animationProps: any) {\n    this._getFrameStats();\n\n    // Log perf stats every second\n    if (this._metricsCounter++ % 60 === 0) {\n      this._getMetrics();\n      this.stats.reset();\n      log.table(4, this.metrics)();\n\n      // Experimental: report metrics\n      if (this.props._onMetrics) {\n        this.props._onMetrics(this.metrics);\n      }\n    }\n\n    this._updateCanvasSize();\n\n    this._updateCursor();\n\n    // If view state has changed, clear tooltip\n    if (this.tooltip!.isVisible && this.viewManager!.needsRedraw()) {\n      this.tooltip!.setTooltip(null);\n    }\n\n    // Update layers if needed (e.g. some async prop has loaded)\n    // Note: This can trigger a redraw\n    this.layerManager!.updateLayers();\n\n    // Perform picking request if any\n    this._pickAndCallback();\n\n    // Redraw if necessary\n    this.redraw();\n\n    // Update viewport transition if needed\n    // Note: this can trigger `onViewStateChange`, and affect layers\n    // We want to defer these changes to the next frame\n    if (this.viewManager) {\n      this.viewManager.updateViewStates();\n    }\n  }\n\n  // Callbacks\n\n  private _onViewStateChange(params: ViewStateChangeParameters & {viewId: string}) {\n    // Let app know that view state is changing, and give it a chance to change it\n    const viewState = this.props.onViewStateChange(params) || params.viewState;\n\n    // If initialViewState was set on creation, auto track position\n    if (this.viewState) {\n      this.viewState = {...this.viewState, [params.viewId]: viewState};\n      if (!this.props.viewState) {\n        // Apply internal view state\n        if (this.viewManager) {\n          this.viewManager.setProps({viewState: this.viewState});\n        }\n      }\n    }\n  }\n\n  private _onInteractionStateChange(interactionState: InteractionState) {\n    this.cursorState.isDragging = interactionState.isDragging || false;\n    this.props.onInteractionStateChange(interactionState);\n  }\n\n  /** Internal use only: event handler for click & drag */\n  _onEvent = (event: MjolnirGestureEvent) => {\n    const eventOptions = EVENTS[event.type];\n    const pos = event.offsetCenter;\n\n    if (!eventOptions || !pos || !this.layerManager) {\n      return;\n    }\n\n    // Reuse last picked object\n    const layers = this.layerManager.getLayers();\n    const info = this.deckPicker!.getLastPickedObject(\n      {\n        x: pos.x,\n        y: pos.y,\n        layers,\n        viewports: this.getViewports(pos)\n      },\n      this._lastPointerDownInfo\n    );\n\n    const {layer} = info;\n    const layerHandler =\n      layer && (layer[eventOptions.handler] || layer.props[eventOptions.handler]);\n    const rootHandler = this.props[eventOptions.handler];\n    let handled = false;\n\n    if (layerHandler) {\n      handled = layerHandler.call(layer, info, event);\n    }\n    if (!handled && rootHandler) {\n      rootHandler(info, event);\n    }\n  };\n\n  /** Internal use only: evnet handler for pointerdown */\n  _onPointerDown = (event: MjolnirPointerEvent) => {\n    const pos = event.offsetCenter;\n    const pickedInfo = this._pick('pickObject', 'pickObject Time', {\n      x: pos.x,\n      y: pos.y,\n      radius: this.props.pickingRadius\n    });\n    this._lastPointerDownInfo = pickedInfo.result[0] || pickedInfo.emptyInfo;\n  };\n\n  private _getFrameStats(): void {\n    const {stats} = this;\n    stats.get('frameRate').timeEnd();\n    stats.get('frameRate').timeStart();\n\n    // Get individual stats from luma.gl so reset works\n    const animationLoopStats = this.animationLoop.stats;\n    stats.get('GPU Time').addTime(animationLoopStats.get('GPU Time').lastTiming);\n    stats.get('CPU Time').addTime(animationLoopStats.get('CPU Time').lastTiming);\n  }\n\n  private _getMetrics(): void {\n    const {metrics, stats} = this;\n    metrics.fps = stats.get('frameRate').getHz();\n    metrics.setPropsTime = stats.get('setProps Time').time;\n    metrics.updateAttributesTime = stats.get('Update Attributes').time;\n    metrics.framesRedrawn = stats.get('Redraw Count').count;\n    metrics.pickTime =\n      stats.get('pickObject Time').time +\n      stats.get('pickMultipleObjects Time').time +\n      stats.get('pickObjects Time').time;\n    metrics.pickCount = stats.get('Pick Count').count;\n\n    // Luma stats\n    metrics.gpuTime = stats.get('GPU Time').time;\n    metrics.cpuTime = stats.get('CPU Time').time;\n    metrics.gpuTimePerFrame = stats.get('GPU Time').getAverageTime();\n    metrics.cpuTimePerFrame = stats.get('CPU Time').getAverageTime();\n\n    const memoryStats = lumaStats.get('Memory Usage');\n    metrics.bufferMemory = memoryStats.get('Buffer Memory').count;\n    metrics.textureMemory = memoryStats.get('Texture Memory').count;\n    metrics.renderbufferMemory = memoryStats.get('Renderbuffer Memory').count;\n    metrics.gpuMemory = memoryStats.get('GPU Memory').count;\n  }\n}\n","import type {Loader} from '@loaders.gl/loader-utils';\n\nfunction isJSON(text: string): boolean {\n  const firstChar = text[0];\n  const lastChar = text[text.length - 1];\n  return (firstChar === '{' && lastChar === '}') || (firstChar === '[' && lastChar === ']');\n}\n\n// A light weight version instead of @loaders.gl/json (stream processing etc.)\nexport default {\n  id: 'JSON',\n  name: 'JSON',\n  module: '',\n  version: '',\n  options: {},\n  extensions: ['json', 'geojson'],\n  mimeTypes: ['application/json', 'application/geo+json'],\n  testText: isJSON,\n  parseTextSync: JSON.parse\n} as Loader;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {registerLoaders} from '@loaders.gl/core';\nimport {ImageLoader} from '@loaders.gl/images';\n\nimport log from '../utils/log';\nimport {register} from '../debug';\nimport jsonLoader from '../utils/json-loader';\n\n// Version detection using babel plugin\n// Fallback for tests and SSR since global variable is defined by Webpack.\nconst version =\n  // @ts-expect-error __VERSION__ is replaced during transpilation\n  typeof __VERSION__ !== 'undefined'\n    ? // @ts-expect-error\n      __VERSION__\n    : globalThis.DECK_VERSION || 'untranspiled source';\n\n// Note: a `deck` object not created by deck.gl may exist in the global scope\nconst existingVersion = globalThis.deck && globalThis.deck.VERSION;\n\nif (existingVersion && existingVersion !== version) {\n  throw new Error(`deck.gl - multiple versions detected: ${existingVersion} vs ${version}`);\n}\n\nif (!existingVersion) {\n  log.log(1, `deck.gl ${version}`)();\n\n  globalThis.deck = {\n    ...globalThis.deck,\n    VERSION: version,\n    version,\n    log,\n    // experimental\n    _registerLoggers: register\n  };\n\n  registerLoaders([\n    jsonLoader,\n    // @ts-expect-error non-standard Loader format\n    [ImageLoader, {imagebitmap: {premultiplyAlpha: 'none'}}]\n  ]);\n}\n\nexport default globalThis.deck;\n","'use strict';\n\nmodule.exports = Pbf;\n\nvar ieee754 = require('ieee754');\n\nfunction Pbf(buf) {\n    this.buf = ArrayBuffer.isView && ArrayBuffer.isView(buf) ? buf : new Uint8Array(buf || 0);\n    this.pos = 0;\n    this.type = 0;\n    this.length = this.buf.length;\n}\n\nPbf.Varint  = 0; // varint: int32, int64, uint32, uint64, sint32, sint64, bool, enum\nPbf.Fixed64 = 1; // 64-bit: double, fixed64, sfixed64\nPbf.Bytes   = 2; // length-delimited: string, bytes, embedded messages, packed repeated fields\nPbf.Fixed32 = 5; // 32-bit: float, fixed32, sfixed32\n\nvar SHIFT_LEFT_32 = (1 << 16) * (1 << 16),\n    SHIFT_RIGHT_32 = 1 / SHIFT_LEFT_32;\n\n// Threshold chosen based on both benchmarking and knowledge about browser string\n// data structures (which currently switch structure types at 12 bytes or more)\nvar TEXT_DECODER_MIN_LENGTH = 12;\nvar utf8TextDecoder = typeof TextDecoder === 'undefined' ? null : new TextDecoder('utf8');\n\nPbf.prototype = {\n\n    destroy: function() {\n        this.buf = null;\n    },\n\n    // === READING =================================================================\n\n    readFields: function(readField, result, end) {\n        end = end || this.length;\n\n        while (this.pos < end) {\n            var val = this.readVarint(),\n                tag = val >> 3,\n                startPos = this.pos;\n\n            this.type = val & 0x7;\n            readField(tag, result, this);\n\n            if (this.pos === startPos) this.skip(val);\n        }\n        return result;\n    },\n\n    readMessage: function(readField, result) {\n        return this.readFields(readField, result, this.readVarint() + this.pos);\n    },\n\n    readFixed32: function() {\n        var val = readUInt32(this.buf, this.pos);\n        this.pos += 4;\n        return val;\n    },\n\n    readSFixed32: function() {\n        var val = readInt32(this.buf, this.pos);\n        this.pos += 4;\n        return val;\n    },\n\n    // 64-bit int handling is based on github.com/dpw/node-buffer-more-ints (MIT-licensed)\n\n    readFixed64: function() {\n        var val = readUInt32(this.buf, this.pos) + readUInt32(this.buf, this.pos + 4) * SHIFT_LEFT_32;\n        this.pos += 8;\n        return val;\n    },\n\n    readSFixed64: function() {\n        var val = readUInt32(this.buf, this.pos) + readInt32(this.buf, this.pos + 4) * SHIFT_LEFT_32;\n        this.pos += 8;\n        return val;\n    },\n\n    readFloat: function() {\n        var val = ieee754.read(this.buf, this.pos, true, 23, 4);\n        this.pos += 4;\n        return val;\n    },\n\n    readDouble: function() {\n        var val = ieee754.read(this.buf, this.pos, true, 52, 8);\n        this.pos += 8;\n        return val;\n    },\n\n    readVarint: function(isSigned) {\n        var buf = this.buf,\n            val, b;\n\n        b = buf[this.pos++]; val  =  b & 0x7f;        if (b < 0x80) return val;\n        b = buf[this.pos++]; val |= (b & 0x7f) << 7;  if (b < 0x80) return val;\n        b = buf[this.pos++]; val |= (b & 0x7f) << 14; if (b < 0x80) return val;\n        b = buf[this.pos++]; val |= (b & 0x7f) << 21; if (b < 0x80) return val;\n        b = buf[this.pos];   val |= (b & 0x0f) << 28;\n\n        return readVarintRemainder(val, isSigned, this);\n    },\n\n    readVarint64: function() { // for compatibility with v2.0.1\n        return this.readVarint(true);\n    },\n\n    readSVarint: function() {\n        var num = this.readVarint();\n        return num % 2 === 1 ? (num + 1) / -2 : num / 2; // zigzag encoding\n    },\n\n    readBoolean: function() {\n        return Boolean(this.readVarint());\n    },\n\n    readString: function() {\n        var end = this.readVarint() + this.pos;\n        var pos = this.pos;\n        this.pos = end;\n\n        if (end - pos >= TEXT_DECODER_MIN_LENGTH && utf8TextDecoder) {\n            // longer strings are fast with the built-in browser TextDecoder API\n            return readUtf8TextDecoder(this.buf, pos, end);\n        }\n        // short strings are fast with our custom implementation\n        return readUtf8(this.buf, pos, end);\n    },\n\n    readBytes: function() {\n        var end = this.readVarint() + this.pos,\n            buffer = this.buf.subarray(this.pos, end);\n        this.pos = end;\n        return buffer;\n    },\n\n    // verbose for performance reasons; doesn't affect gzipped size\n\n    readPackedVarint: function(arr, isSigned) {\n        if (this.type !== Pbf.Bytes) return arr.push(this.readVarint(isSigned));\n        var end = readPackedEnd(this);\n        arr = arr || [];\n        while (this.pos < end) arr.push(this.readVarint(isSigned));\n        return arr;\n    },\n    readPackedSVarint: function(arr) {\n        if (this.type !== Pbf.Bytes) return arr.push(this.readSVarint());\n        var end = readPackedEnd(this);\n        arr = arr || [];\n        while (this.pos < end) arr.push(this.readSVarint());\n        return arr;\n    },\n    readPackedBoolean: function(arr) {\n        if (this.type !== Pbf.Bytes) return arr.push(this.readBoolean());\n        var end = readPackedEnd(this);\n        arr = arr || [];\n        while (this.pos < end) arr.push(this.readBoolean());\n        return arr;\n    },\n    readPackedFloat: function(arr) {\n        if (this.type !== Pbf.Bytes) return arr.push(this.readFloat());\n        var end = readPackedEnd(this);\n        arr = arr || [];\n        while (this.pos < end) arr.push(this.readFloat());\n        return arr;\n    },\n    readPackedDouble: function(arr) {\n        if (this.type !== Pbf.Bytes) return arr.push(this.readDouble());\n        var end = readPackedEnd(this);\n        arr = arr || [];\n        while (this.pos < end) arr.push(this.readDouble());\n        return arr;\n    },\n    readPackedFixed32: function(arr) {\n        if (this.type !== Pbf.Bytes) return arr.push(this.readFixed32());\n        var end = readPackedEnd(this);\n        arr = arr || [];\n        while (this.pos < end) arr.push(this.readFixed32());\n        return arr;\n    },\n    readPackedSFixed32: function(arr) {\n        if (this.type !== Pbf.Bytes) return arr.push(this.readSFixed32());\n        var end = readPackedEnd(this);\n        arr = arr || [];\n        while (this.pos < end) arr.push(this.readSFixed32());\n        return arr;\n    },\n    readPackedFixed64: function(arr) {\n        if (this.type !== Pbf.Bytes) return arr.push(this.readFixed64());\n        var end = readPackedEnd(this);\n        arr = arr || [];\n        while (this.pos < end) arr.push(this.readFixed64());\n        return arr;\n    },\n    readPackedSFixed64: function(arr) {\n        if (this.type !== Pbf.Bytes) return arr.push(this.readSFixed64());\n        var end = readPackedEnd(this);\n        arr = arr || [];\n        while (this.pos < end) arr.push(this.readSFixed64());\n        return arr;\n    },\n\n    skip: function(val) {\n        var type = val & 0x7;\n        if (type === Pbf.Varint) while (this.buf[this.pos++] > 0x7f) {}\n        else if (type === Pbf.Bytes) this.pos = this.readVarint() + this.pos;\n        else if (type === Pbf.Fixed32) this.pos += 4;\n        else if (type === Pbf.Fixed64) this.pos += 8;\n        else throw new Error('Unimplemented type: ' + type);\n    },\n\n    // === WRITING =================================================================\n\n    writeTag: function(tag, type) {\n        this.writeVarint((tag << 3) | type);\n    },\n\n    realloc: function(min) {\n        var length = this.length || 16;\n\n        while (length < this.pos + min) length *= 2;\n\n        if (length !== this.length) {\n            var buf = new Uint8Array(length);\n            buf.set(this.buf);\n            this.buf = buf;\n            this.length = length;\n        }\n    },\n\n    finish: function() {\n        this.length = this.pos;\n        this.pos = 0;\n        return this.buf.subarray(0, this.length);\n    },\n\n    writeFixed32: function(val) {\n        this.realloc(4);\n        writeInt32(this.buf, val, this.pos);\n        this.pos += 4;\n    },\n\n    writeSFixed32: function(val) {\n        this.realloc(4);\n        writeInt32(this.buf, val, this.pos);\n        this.pos += 4;\n    },\n\n    writeFixed64: function(val) {\n        this.realloc(8);\n        writeInt32(this.buf, val & -1, this.pos);\n        writeInt32(this.buf, Math.floor(val * SHIFT_RIGHT_32), this.pos + 4);\n        this.pos += 8;\n    },\n\n    writeSFixed64: function(val) {\n        this.realloc(8);\n        writeInt32(this.buf, val & -1, this.pos);\n        writeInt32(this.buf, Math.floor(val * SHIFT_RIGHT_32), this.pos + 4);\n        this.pos += 8;\n    },\n\n    writeVarint: function(val) {\n        val = +val || 0;\n\n        if (val > 0xfffffff || val < 0) {\n            writeBigVarint(val, this);\n            return;\n        }\n\n        this.realloc(4);\n\n        this.buf[this.pos++] =           val & 0x7f  | (val > 0x7f ? 0x80 : 0); if (val <= 0x7f) return;\n        this.buf[this.pos++] = ((val >>>= 7) & 0x7f) | (val > 0x7f ? 0x80 : 0); if (val <= 0x7f) return;\n        this.buf[this.pos++] = ((val >>>= 7) & 0x7f) | (val > 0x7f ? 0x80 : 0); if (val <= 0x7f) return;\n        this.buf[this.pos++] =   (val >>> 7) & 0x7f;\n    },\n\n    writeSVarint: function(val) {\n        this.writeVarint(val < 0 ? -val * 2 - 1 : val * 2);\n    },\n\n    writeBoolean: function(val) {\n        this.writeVarint(Boolean(val));\n    },\n\n    writeString: function(str) {\n        str = String(str);\n        this.realloc(str.length * 4);\n\n        this.pos++; // reserve 1 byte for short string length\n\n        var startPos = this.pos;\n        // write the string directly to the buffer and see how much was written\n        this.pos = writeUtf8(this.buf, str, this.pos);\n        var len = this.pos - startPos;\n\n        if (len >= 0x80) makeRoomForExtraLength(startPos, len, this);\n\n        // finally, write the message length in the reserved place and restore the position\n        this.pos = startPos - 1;\n        this.writeVarint(len);\n        this.pos += len;\n    },\n\n    writeFloat: function(val) {\n        this.realloc(4);\n        ieee754.write(this.buf, val, this.pos, true, 23, 4);\n        this.pos += 4;\n    },\n\n    writeDouble: function(val) {\n        this.realloc(8);\n        ieee754.write(this.buf, val, this.pos, true, 52, 8);\n        this.pos += 8;\n    },\n\n    writeBytes: function(buffer) {\n        var len = buffer.length;\n        this.writeVarint(len);\n        this.realloc(len);\n        for (var i = 0; i < len; i++) this.buf[this.pos++] = buffer[i];\n    },\n\n    writeRawMessage: function(fn, obj) {\n        this.pos++; // reserve 1 byte for short message length\n\n        // write the message directly to the buffer and see how much was written\n        var startPos = this.pos;\n        fn(obj, this);\n        var len = this.pos - startPos;\n\n        if (len >= 0x80) makeRoomForExtraLength(startPos, len, this);\n\n        // finally, write the message length in the reserved place and restore the position\n        this.pos = startPos - 1;\n        this.writeVarint(len);\n        this.pos += len;\n    },\n\n    writeMessage: function(tag, fn, obj) {\n        this.writeTag(tag, Pbf.Bytes);\n        this.writeRawMessage(fn, obj);\n    },\n\n    writePackedVarint:   function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedVarint, arr);   },\n    writePackedSVarint:  function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedSVarint, arr);  },\n    writePackedBoolean:  function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedBoolean, arr);  },\n    writePackedFloat:    function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedFloat, arr);    },\n    writePackedDouble:   function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedDouble, arr);   },\n    writePackedFixed32:  function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedFixed32, arr);  },\n    writePackedSFixed32: function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedSFixed32, arr); },\n    writePackedFixed64:  function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedFixed64, arr);  },\n    writePackedSFixed64: function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedSFixed64, arr); },\n\n    writeBytesField: function(tag, buffer) {\n        this.writeTag(tag, Pbf.Bytes);\n        this.writeBytes(buffer);\n    },\n    writeFixed32Field: function(tag, val) {\n        this.writeTag(tag, Pbf.Fixed32);\n        this.writeFixed32(val);\n    },\n    writeSFixed32Field: function(tag, val) {\n        this.writeTag(tag, Pbf.Fixed32);\n        this.writeSFixed32(val);\n    },\n    writeFixed64Field: function(tag, val) {\n        this.writeTag(tag, Pbf.Fixed64);\n        this.writeFixed64(val);\n    },\n    writeSFixed64Field: function(tag, val) {\n        this.writeTag(tag, Pbf.Fixed64);\n        this.writeSFixed64(val);\n    },\n    writeVarintField: function(tag, val) {\n        this.writeTag(tag, Pbf.Varint);\n        this.writeVarint(val);\n    },\n    writeSVarintField: function(tag, val) {\n        this.writeTag(tag, Pbf.Varint);\n        this.writeSVarint(val);\n    },\n    writeStringField: function(tag, str) {\n        this.writeTag(tag, Pbf.Bytes);\n        this.writeString(str);\n    },\n    writeFloatField: function(tag, val) {\n        this.writeTag(tag, Pbf.Fixed32);\n        this.writeFloat(val);\n    },\n    writeDoubleField: function(tag, val) {\n        this.writeTag(tag, Pbf.Fixed64);\n        this.writeDouble(val);\n    },\n    writeBooleanField: function(tag, val) {\n        this.writeVarintField(tag, Boolean(val));\n    }\n};\n\nfunction readVarintRemainder(l, s, p) {\n    var buf = p.buf,\n        h, b;\n\n    b = buf[p.pos++]; h  = (b & 0x70) >> 4;  if (b < 0x80) return toNum(l, h, s);\n    b = buf[p.pos++]; h |= (b & 0x7f) << 3;  if (b < 0x80) return toNum(l, h, s);\n    b = buf[p.pos++]; h |= (b & 0x7f) << 10; if (b < 0x80) return toNum(l, h, s);\n    b = buf[p.pos++]; h |= (b & 0x7f) << 17; if (b < 0x80) return toNum(l, h, s);\n    b = buf[p.pos++]; h |= (b & 0x7f) << 24; if (b < 0x80) return toNum(l, h, s);\n    b = buf[p.pos++]; h |= (b & 0x01) << 31; if (b < 0x80) return toNum(l, h, s);\n\n    throw new Error('Expected varint not more than 10 bytes');\n}\n\nfunction readPackedEnd(pbf) {\n    return pbf.type === Pbf.Bytes ?\n        pbf.readVarint() + pbf.pos : pbf.pos + 1;\n}\n\nfunction toNum(low, high, isSigned) {\n    if (isSigned) {\n        return high * 0x100000000 + (low >>> 0);\n    }\n\n    return ((high >>> 0) * 0x100000000) + (low >>> 0);\n}\n\nfunction writeBigVarint(val, pbf) {\n    var low, high;\n\n    if (val >= 0) {\n        low  = (val % 0x100000000) | 0;\n        high = (val / 0x100000000) | 0;\n    } else {\n        low  = ~(-val % 0x100000000);\n        high = ~(-val / 0x100000000);\n\n        if (low ^ 0xffffffff) {\n            low = (low + 1) | 0;\n        } else {\n            low = 0;\n            high = (high + 1) | 0;\n        }\n    }\n\n    if (val >= 0x10000000000000000 || val < -0x10000000000000000) {\n        throw new Error('Given varint doesn\\'t fit into 10 bytes');\n    }\n\n    pbf.realloc(10);\n\n    writeBigVarintLow(low, high, pbf);\n    writeBigVarintHigh(high, pbf);\n}\n\nfunction writeBigVarintLow(low, high, pbf) {\n    pbf.buf[pbf.pos++] = low & 0x7f | 0x80; low >>>= 7;\n    pbf.buf[pbf.pos++] = low & 0x7f | 0x80; low >>>= 7;\n    pbf.buf[pbf.pos++] = low & 0x7f | 0x80; low >>>= 7;\n    pbf.buf[pbf.pos++] = low & 0x7f | 0x80; low >>>= 7;\n    pbf.buf[pbf.pos]   = low & 0x7f;\n}\n\nfunction writeBigVarintHigh(high, pbf) {\n    var lsb = (high & 0x07) << 4;\n\n    pbf.buf[pbf.pos++] |= lsb         | ((high >>>= 3) ? 0x80 : 0); if (!high) return;\n    pbf.buf[pbf.pos++]  = high & 0x7f | ((high >>>= 7) ? 0x80 : 0); if (!high) return;\n    pbf.buf[pbf.pos++]  = high & 0x7f | ((high >>>= 7) ? 0x80 : 0); if (!high) return;\n    pbf.buf[pbf.pos++]  = high & 0x7f | ((high >>>= 7) ? 0x80 : 0); if (!high) return;\n    pbf.buf[pbf.pos++]  = high & 0x7f | ((high >>>= 7) ? 0x80 : 0); if (!high) return;\n    pbf.buf[pbf.pos++]  = high & 0x7f;\n}\n\nfunction makeRoomForExtraLength(startPos, len, pbf) {\n    var extraLen =\n        len <= 0x3fff ? 1 :\n        len <= 0x1fffff ? 2 :\n        len <= 0xfffffff ? 3 : Math.floor(Math.log(len) / (Math.LN2 * 7));\n\n    // if 1 byte isn't enough for encoding message length, shift the data to the right\n    pbf.realloc(extraLen);\n    for (var i = pbf.pos - 1; i >= startPos; i--) pbf.buf[i + extraLen] = pbf.buf[i];\n}\n\nfunction writePackedVarint(arr, pbf)   { for (var i = 0; i < arr.length; i++) pbf.writeVarint(arr[i]);   }\nfunction writePackedSVarint(arr, pbf)  { for (var i = 0; i < arr.length; i++) pbf.writeSVarint(arr[i]);  }\nfunction writePackedFloat(arr, pbf)    { for (var i = 0; i < arr.length; i++) pbf.writeFloat(arr[i]);    }\nfunction writePackedDouble(arr, pbf)   { for (var i = 0; i < arr.length; i++) pbf.writeDouble(arr[i]);   }\nfunction writePackedBoolean(arr, pbf)  { for (var i = 0; i < arr.length; i++) pbf.writeBoolean(arr[i]);  }\nfunction writePackedFixed32(arr, pbf)  { for (var i = 0; i < arr.length; i++) pbf.writeFixed32(arr[i]);  }\nfunction writePackedSFixed32(arr, pbf) { for (var i = 0; i < arr.length; i++) pbf.writeSFixed32(arr[i]); }\nfunction writePackedFixed64(arr, pbf)  { for (var i = 0; i < arr.length; i++) pbf.writeFixed64(arr[i]);  }\nfunction writePackedSFixed64(arr, pbf) { for (var i = 0; i < arr.length; i++) pbf.writeSFixed64(arr[i]); }\n\n// Buffer code below from https://github.com/feross/buffer, MIT-licensed\n\nfunction readUInt32(buf, pos) {\n    return ((buf[pos]) |\n        (buf[pos + 1] << 8) |\n        (buf[pos + 2] << 16)) +\n        (buf[pos + 3] * 0x1000000);\n}\n\nfunction writeInt32(buf, val, pos) {\n    buf[pos] = val;\n    buf[pos + 1] = (val >>> 8);\n    buf[pos + 2] = (val >>> 16);\n    buf[pos + 3] = (val >>> 24);\n}\n\nfunction readInt32(buf, pos) {\n    return ((buf[pos]) |\n        (buf[pos + 1] << 8) |\n        (buf[pos + 2] << 16)) +\n        (buf[pos + 3] << 24);\n}\n\nfunction readUtf8(buf, pos, end) {\n    var str = '';\n    var i = pos;\n\n    while (i < end) {\n        var b0 = buf[i];\n        var c = null; // codepoint\n        var bytesPerSequence =\n            b0 > 0xEF ? 4 :\n            b0 > 0xDF ? 3 :\n            b0 > 0xBF ? 2 : 1;\n\n        if (i + bytesPerSequence > end) break;\n\n        var b1, b2, b3;\n\n        if (bytesPerSequence === 1) {\n            if (b0 < 0x80) {\n                c = b0;\n            }\n        } else if (bytesPerSequence === 2) {\n            b1 = buf[i + 1];\n            if ((b1 & 0xC0) === 0x80) {\n                c = (b0 & 0x1F) << 0x6 | (b1 & 0x3F);\n                if (c <= 0x7F) {\n                    c = null;\n                }\n            }\n        } else if (bytesPerSequence === 3) {\n            b1 = buf[i + 1];\n            b2 = buf[i + 2];\n            if ((b1 & 0xC0) === 0x80 && (b2 & 0xC0) === 0x80) {\n                c = (b0 & 0xF) << 0xC | (b1 & 0x3F) << 0x6 | (b2 & 0x3F);\n                if (c <= 0x7FF || (c >= 0xD800 && c <= 0xDFFF)) {\n                    c = null;\n                }\n            }\n        } else if (bytesPerSequence === 4) {\n            b1 = buf[i + 1];\n            b2 = buf[i + 2];\n            b3 = buf[i + 3];\n            if ((b1 & 0xC0) === 0x80 && (b2 & 0xC0) === 0x80 && (b3 & 0xC0) === 0x80) {\n                c = (b0 & 0xF) << 0x12 | (b1 & 0x3F) << 0xC | (b2 & 0x3F) << 0x6 | (b3 & 0x3F);\n                if (c <= 0xFFFF || c >= 0x110000) {\n                    c = null;\n                }\n            }\n        }\n\n        if (c === null) {\n            c = 0xFFFD;\n            bytesPerSequence = 1;\n\n        } else if (c > 0xFFFF) {\n            c -= 0x10000;\n            str += String.fromCharCode(c >>> 10 & 0x3FF | 0xD800);\n            c = 0xDC00 | c & 0x3FF;\n        }\n\n        str += String.fromCharCode(c);\n        i += bytesPerSequence;\n    }\n\n    return str;\n}\n\nfunction readUtf8TextDecoder(buf, pos, end) {\n    return utf8TextDecoder.decode(buf.subarray(pos, end));\n}\n\nfunction writeUtf8(buf, str, pos) {\n    for (var i = 0, c, lead; i < str.length; i++) {\n        c = str.charCodeAt(i); // code point\n\n        if (c > 0xD7FF && c < 0xE000) {\n            if (lead) {\n                if (c < 0xDC00) {\n                    buf[pos++] = 0xEF;\n                    buf[pos++] = 0xBF;\n                    buf[pos++] = 0xBD;\n                    lead = c;\n                    continue;\n                } else {\n                    c = lead - 0xD800 << 10 | c - 0xDC00 | 0x10000;\n                    lead = null;\n                }\n            } else {\n                if (c > 0xDBFF || (i + 1 === str.length)) {\n                    buf[pos++] = 0xEF;\n                    buf[pos++] = 0xBF;\n                    buf[pos++] = 0xBD;\n                } else {\n                    lead = c;\n                }\n                continue;\n            }\n        } else if (lead) {\n            buf[pos++] = 0xEF;\n            buf[pos++] = 0xBF;\n            buf[pos++] = 0xBD;\n            lead = null;\n        }\n\n        if (c < 0x80) {\n            buf[pos++] = c;\n        } else {\n            if (c < 0x800) {\n                buf[pos++] = c >> 0x6 | 0xC0;\n            } else {\n                if (c < 0x10000) {\n                    buf[pos++] = c >> 0xC | 0xE0;\n                } else {\n                    buf[pos++] = c >> 0x12 | 0xF0;\n                    buf[pos++] = c >> 0xC & 0x3F | 0x80;\n                }\n                buf[pos++] = c >> 0x6 & 0x3F | 0x80;\n            }\n            buf[pos++] = c & 0x3F | 0x80;\n        }\n    }\n    return pos;\n}\n","const jsep = require('jsep');\n\n/**\n * Evaluation code from JSEP project, under MIT License.\n * Copyright (c) 2013 Stephen Oney, http://jsep.from.so/\n */\n\nconst binops = {\n  '||':  function (a, b) { return a || b; },\n  '&&':  function (a, b) { return a && b; },\n  '|':   function (a, b) { return a | b; },\n  '^':   function (a, b) { return a ^ b; },\n  '&':   function (a, b) { return a & b; },\n  '==':  function (a, b) { return a == b; }, // jshint ignore:line\n  '!=':  function (a, b) { return a != b; }, // jshint ignore:line\n  '===': function (a, b) { return a === b; },\n  '!==': function (a, b) { return a !== b; },\n  '<':   function (a, b) { return a < b; },\n  '>':   function (a, b) { return a > b; },\n  '<=':  function (a, b) { return a <= b; },\n  '>=':  function (a, b) { return a >= b; },\n  '<<':  function (a, b) { return a << b; },\n  '>>':  function (a, b) { return a >> b; },\n  '>>>': function (a, b) { return a >>> b; },\n  '+':   function (a, b) { return a + b; },\n  '-':   function (a, b) { return a - b; },\n  '*':   function (a, b) { return a * b; },\n  '/':   function (a, b) { return a / b; },\n  '%':   function (a, b) { return a % b; }\n};\n\nconst unops = {\n  '-' :  function (a) { return -a; },\n  '+' :  function (a) { return +a; },\n  '~' :  function (a) { return ~a; },\n  '!' :  function (a) { return !a; },\n};\n\nfunction evaluateArray ( list, context ) {\n  return list.map(function (v) { return evaluate(v, context); });\n}\n\nasync function evaluateArrayAsync( list, context ) {\n  const res = await Promise.all(list.map((v) => evaluateAsync(v, context)));\n  return res;\n}\n\nfunction evaluateMember ( node, context ) {\n  const object = evaluate(node.object, context);\n  if ( node.computed ) {\n    return [object, object[evaluate(node.property, context)]];\n  } else {\n    return [object, object[node.property.name]];\n  }\n}\n\nasync function evaluateMemberAsync( node, context ) {\n  const object = await evaluateAsync(node.object, context);\n  if (  node.computed) {\n    return [object, object[await evaluateAsync(node.property, context)]];\n  } else {\n    return [object, object[node.property.name]];\n  }\n}\n\nfunction evaluate ( node, context ) {\n\n  switch ( node.type ) {\n\n    case 'ArrayExpression':\n      return evaluateArray( node.elements, context );\n\n    case 'BinaryExpression':\n      return binops[ node.operator ]( evaluate( node.left, context ), evaluate( node.right, context ) );\n\n    case 'CallExpression':\n      let caller, fn, assign;\n      if (node.callee.type === 'MemberExpression') {\n        assign = evaluateMember( node.callee, context );\n        caller = assign[0];\n        fn = assign[1];\n      } else {\n        fn = evaluate( node.callee, context );\n      }\n      if (typeof fn  !== 'function') { return undefined; }\n      return fn.apply( caller, evaluateArray( node.arguments, context ) );\n\n    case 'ConditionalExpression':\n      return evaluate( node.test, context )\n        ? evaluate( node.consequent, context )\n        : evaluate( node.alternate, context );\n\n    case 'Identifier':\n      return context[node.name];\n\n    case 'Literal':\n      return node.value;\n\n    case 'LogicalExpression':\n      if (node.operator === '||') {\n        return evaluate( node.left, context ) || evaluate( node.right, context );\n      } else if (node.operator === '&&') {\n        return evaluate( node.left, context ) && evaluate( node.right, context );\n      }\n      return binops[ node.operator ]( evaluate( node.left, context ), evaluate( node.right, context ) );\n\n    case 'MemberExpression':\n      return evaluateMember(node, context)[1];\n\n    case 'ThisExpression':\n      return context;\n\n    case 'UnaryExpression':\n      return unops[ node.operator ]( evaluate( node.argument, context ) );\n\n    default:\n      return undefined;\n  }\n\n}\n\nasync function evaluateAsync( node, context ) {\n\n  switch ( node.type ) {\n\n    case 'ArrayExpression':\n      return await evaluateArrayAsync( node.elements, context );\n\n    case 'BinaryExpression': {\n      const [left, right] = await Promise.all([\n        evaluateAsync( node.left, context ),\n        evaluateAsync( node.right, context )\n      ]);\n      return binops[ node.operator ]( left, right );\n    }\n\n    case 'CallExpression':\n      let caller, fn, assign;\n      if (node.callee.type === 'MemberExpression') {\n        assign = await evaluateMemberAsync( node.callee, context );\n        caller = assign[0];\n        fn = assign[1];\n      } else {\n        fn = await evaluateAsync( node.callee, context );\n      }\n      if (typeof fn !== 'function') {\n        return undefined;\n      }\n      return await fn.apply(\n        caller,\n        await evaluateArrayAsync( node.arguments, context )\n      );\n\n    case 'ConditionalExpression':\n      return (await evaluateAsync( node.test, context ))\n        ? await evaluateAsync( node.consequent, context )\n        : await evaluateAsync( node.alternate, context );\n\n    case 'Identifier':\n      return context[node.name];\n\n    case 'Literal':\n      return node.value;\n\n    case 'LogicalExpression': {\n      if (node.operator === '||') {\n        return (\n          (await evaluateAsync( node.left, context )) ||\n          (await evaluateAsync( node.right, context ))\n        );\n      } else if (node.operator === '&&') {\n        return (\n          (await evaluateAsync( node.left, context )) &&\n          (await evaluateAsync( node.right, context ))\n        );\n      }\n\n      const [left, right] = await Promise.all([\n        evaluateAsync( node.left, context ),\n        evaluateAsync( node.right, context )\n      ]);\n\n      return binops[ node.operator ]( left, right );\n    }\n\n    case 'MemberExpression':\n      return (await evaluateMemberAsync(node, context))[1];\n\n    case 'ThisExpression':\n      return context;\n\n    case 'UnaryExpression':\n      return unops[ node.operator ](await evaluateAsync( node.argument, context ));\n\n    default:\n      return undefined;\n  }\n}\n\nfunction compile (expression) {\n  return evaluate.bind(null, jsep(expression));\n}\n\nfunction compileAsync(expression) {\n  return evaluateAsync.bind(null, jsep(expression));\n}\n\nmodule.exports = {\n  parse: jsep,\n  eval: evaluate,\n  evalAsync: evaluateAsync,\n  compile: compile,\n  compileAsync: compileAsync\n};\n","import ShaderModule from './shader-module';\nimport { assert } from '../utils';\nexport function resolveModules(modules) {\n  return getShaderDependencies(instantiateModules(modules));\n}\n\nfunction getShaderDependencies(modules) {\n  const moduleMap = {};\n  const moduleDepth = {};\n  getDependencyGraph({\n    modules,\n    level: 0,\n    moduleMap,\n    moduleDepth\n  });\n  return Object.keys(moduleDepth).sort((a, b) => moduleDepth[b] - moduleDepth[a]).map(name => moduleMap[name]);\n}\n\nfunction getDependencyGraph(_ref) {\n  let {\n    modules,\n    level,\n    moduleMap,\n    moduleDepth\n  } = _ref;\n\n  if (level >= 5) {\n    throw new Error('Possible loop in shader dependency graph');\n  }\n\n  for (const module of modules) {\n    moduleMap[module.name] = module;\n\n    if (moduleDepth[module.name] === undefined || moduleDepth[module.name] < level) {\n      moduleDepth[module.name] = level;\n    }\n  }\n\n  for (const module of modules) {\n    if (module.dependencies) {\n      getDependencyGraph({\n        modules: module.dependencies,\n        level: level + 1,\n        moduleMap,\n        moduleDepth\n      });\n    }\n  }\n}\n\nfunction instantiateModules(modules, seen) {\n  return modules.map(module => {\n    if (module instanceof ShaderModule) {\n      return module;\n    }\n\n    assert(typeof module !== 'string', \"Shader module use by name is deprecated. Import shader module '\".concat(module, \"' and use it directly.\"));\n    assert(module.name, 'shader module has no name');\n    module = new ShaderModule(module);\n    module.dependencies = instantiateModules(module.dependencies);\n    return module;\n  });\n}\n\nexport const TEST_EXPORTS = {\n  getShaderDependencies,\n  getDependencyGraph\n};\n//# sourceMappingURL=resolve-modules.js.map","export default function isOldIE() {\n  let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n  const navigator = typeof window !== 'undefined' ? window.navigator || {} : {};\n  const userAgent = opts.userAgent || navigator.userAgent || '';\n  const isMSIE = userAgent.indexOf('MSIE ') !== -1;\n  const isTrident = userAgent.indexOf('Trident/') !== -1;\n  return isMSIE || isTrident;\n}\n//# sourceMappingURL=is-old-ie.js.map","import isOldIE from './is-old-ie';\nimport assert from './assert';\nconst GL_VENDOR = 0x1f00;\nconst GL_RENDERER = 0x1f01;\nconst GL_VERSION = 0x1f02;\nconst GL_SHADING_LANGUAGE_VERSION = 0x8b8c;\nconst WEBGL_FEATURES = {\n  GLSL_FRAG_DATA: ['WEBGL_draw_buffers', true],\n  GLSL_FRAG_DEPTH: ['EXT_frag_depth', true],\n  GLSL_DERIVATIVES: ['OES_standard_derivatives', true],\n  GLSL_TEXTURE_LOD: ['EXT_shader_texture_lod', true]\n};\nconst FEATURES = {};\nObject.keys(WEBGL_FEATURES).forEach(key => {\n  FEATURES[key] = key;\n});\nexport { FEATURES };\n\nfunction isWebGL2(gl) {\n  if (typeof WebGL2RenderingContext !== 'undefined' && gl instanceof WebGL2RenderingContext) {\n    return true;\n  }\n\n  return Boolean(gl && gl._version === 2);\n}\n\nexport function getContextInfo(gl) {\n  const info = gl.getExtension('WEBGL_debug_renderer_info');\n  const vendor = gl.getParameter(info && info.UNMASKED_VENDOR_WEBGL || GL_VENDOR);\n  const renderer = gl.getParameter(info && info.UNMASKED_RENDERER_WEBGL || GL_RENDERER);\n  const gpuVendor = identifyGPUVendor(vendor, renderer);\n  const gpuInfo = {\n    gpuVendor,\n    vendor,\n    renderer,\n    version: gl.getParameter(GL_VERSION),\n    shadingLanguageVersion: gl.getParameter(GL_SHADING_LANGUAGE_VERSION)\n  };\n  return gpuInfo;\n}\n\nfunction identifyGPUVendor(vendor, renderer) {\n  if (vendor.match(/NVIDIA/i) || renderer.match(/NVIDIA/i)) {\n    return 'NVIDIA';\n  }\n\n  if (vendor.match(/INTEL/i) || renderer.match(/INTEL/i)) {\n    return 'INTEL';\n  }\n\n  if (vendor.match(/AMD/i) || renderer.match(/AMD/i) || vendor.match(/ATI/i) || renderer.match(/ATI/i)) {\n    return 'AMD';\n  }\n\n  return 'UNKNOWN GPU';\n}\n\nconst compiledGlslExtensions = {};\nexport function canCompileGLGSExtension(gl, cap) {\n  let opts = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};\n  const feature = WEBGL_FEATURES[cap];\n  assert(feature, cap);\n\n  if (!isOldIE(opts)) {\n    return true;\n  }\n\n  if (cap in compiledGlslExtensions) {\n    return compiledGlslExtensions[cap];\n  }\n\n  const extensionName = feature[0];\n  const behavior = opts.behavior || 'enable';\n  const source = \"#extension GL_\".concat(extensionName, \" : \").concat(behavior, \"\\nvoid main(void) {}\");\n  const shader = gl.createShader(35633);\n  gl.shaderSource(shader, source);\n  gl.compileShader(shader);\n  const canCompile = gl.getShaderParameter(shader, 35713);\n  gl.deleteShader(shader);\n  compiledGlslExtensions[cap] = canCompile;\n  return canCompile;\n}\n\nfunction getFeature(gl, cap) {\n  const feature = WEBGL_FEATURES[cap];\n  assert(feature, cap);\n  const extensionName = isWebGL2(gl) ? feature[1] || feature[0] : feature[0];\n  const value = typeof extensionName === 'string' ? Boolean(gl.getExtension(extensionName)) : extensionName;\n  assert(value === false || value === true);\n  return value;\n}\n\nexport function hasFeatures(gl, features) {\n  features = Array.isArray(features) ? features : [features];\n  return features.every(feature => getFeature(gl, feature));\n}\n//# sourceMappingURL=webgl-info.js.map","function testVariable(qualifier) {\n  return new RegExp(\"\\\\b\".concat(qualifier, \"[ \\\\t]+(\\\\w+[ \\\\t]+\\\\w+(\\\\[\\\\w+\\\\])?;)\"), 'g');\n}\n\nconst ES300_REPLACEMENTS = [[/^(#version[ \\t]+(100|300[ \\t]+es))?[ \\t]*\\n/, '#version 300 es\\n'], [/\\btexture(2D|2DProj|Cube)Lod(EXT)?\\(/g, 'textureLod('], [/\\btexture(2D|2DProj|Cube)(EXT)?\\(/g, 'texture(']];\nconst ES300_VERTEX_REPLACEMENTS = [...ES300_REPLACEMENTS, [testVariable('attribute'), 'in $1'], [testVariable('varying'), 'out $1']];\nconst ES300_FRAGMENT_REPLACEMENTS = [...ES300_REPLACEMENTS, [testVariable('varying'), 'in $1']];\nconst ES100_REPLACEMENTS = [[/^#version[ \\t]+300[ \\t]+es/, '#version 100'], [/\\btexture(2D|2DProj|Cube)Lod\\(/g, 'texture$1LodEXT('], [/\\btexture\\(/g, 'texture2D('], [/\\btextureLod\\(/g, 'texture2DLodEXT(']];\nconst ES100_VERTEX_REPLACEMENTS = [...ES100_REPLACEMENTS, [testVariable('in'), 'attribute $1'], [testVariable('out'), 'varying $1']];\nconst ES100_FRAGMENT_REPLACEMENTS = [...ES100_REPLACEMENTS, [testVariable('in'), 'varying $1']];\nconst ES100_FRAGMENT_OUTPUT_NAME = 'gl_FragColor';\nconst ES300_FRAGMENT_OUTPUT_REGEX = /\\bout[ \\t]+vec4[ \\t]+(\\w+)[ \\t]*;\\n?/;\nconst REGEX_START_OF_MAIN = /void\\s+main\\s*\\([^)]*\\)\\s*\\{\\n?/;\nexport default function transpileShader(source, targetGLSLVersion, isVertex) {\n  switch (targetGLSLVersion) {\n    case 300:\n      return isVertex ? convertShader(source, ES300_VERTEX_REPLACEMENTS) : convertFragmentShaderTo300(source);\n\n    case 100:\n      return isVertex ? convertShader(source, ES100_VERTEX_REPLACEMENTS) : convertFragmentShaderTo100(source);\n\n    default:\n      throw new Error(\"unknown GLSL version \".concat(targetGLSLVersion));\n  }\n}\n\nfunction convertShader(source, replacements) {\n  for (const [pattern, replacement] of replacements) {\n    source = source.replace(pattern, replacement);\n  }\n\n  return source;\n}\n\nfunction convertFragmentShaderTo300(source) {\n  source = convertShader(source, ES300_FRAGMENT_REPLACEMENTS);\n  const outputMatch = source.match(ES300_FRAGMENT_OUTPUT_REGEX);\n\n  if (outputMatch) {\n    const outputName = outputMatch[1];\n    source = source.replace(new RegExp(\"\\\\b\".concat(ES100_FRAGMENT_OUTPUT_NAME, \"\\\\b\"), 'g'), outputName);\n  } else {\n    const outputName = 'fragmentColor';\n    source = source.replace(REGEX_START_OF_MAIN, match => \"out vec4 \".concat(outputName, \";\\n\").concat(match)).replace(new RegExp(\"\\\\b\".concat(ES100_FRAGMENT_OUTPUT_NAME, \"\\\\b\"), 'g'), outputName);\n  }\n\n  return source;\n}\n\nfunction convertFragmentShaderTo100(source) {\n  source = convertShader(source, ES100_FRAGMENT_REPLACEMENTS);\n  const outputMatch = source.match(ES300_FRAGMENT_OUTPUT_REGEX);\n\n  if (outputMatch) {\n    const outputName = outputMatch[1];\n    source = source.replace(ES300_FRAGMENT_OUTPUT_REGEX, '').replace(new RegExp(\"\\\\b\".concat(outputName, \"\\\\b\"), 'g'), ES100_FRAGMENT_OUTPUT_NAME);\n  }\n\n  return source;\n}\n//# sourceMappingURL=transpile-shader.js.map","import { VERTEX_SHADER, FRAGMENT_SHADER } from './constants';\nimport { resolveModules } from './resolve-modules';\nimport { getPlatformShaderDefines, getVersionDefines } from './platform-defines';\nimport injectShader, { DECLARATION_INJECT_MARKER } from './inject-shader';\nimport transpileShader from './transpile-shader';\nimport { assert } from '../utils';\nconst INJECT_SHADER_DECLARATIONS = \"\\n\\n\".concat(DECLARATION_INJECT_MARKER, \"\\n\\n\");\nconst SHADER_TYPE = {\n  [VERTEX_SHADER]: 'vertex',\n  [FRAGMENT_SHADER]: 'fragment'\n};\nconst FRAGMENT_SHADER_PROLOGUE = \"precision highp float;\\n\\n\";\nexport function assembleShaders(gl, opts) {\n  const {\n    vs,\n    fs\n  } = opts;\n  const modules = resolveModules(opts.modules || []);\n  return {\n    gl,\n    vs: assembleShader(gl, Object.assign({}, opts, {\n      source: vs,\n      type: VERTEX_SHADER,\n      modules\n    })),\n    fs: assembleShader(gl, Object.assign({}, opts, {\n      source: fs,\n      type: FRAGMENT_SHADER,\n      modules\n    })),\n    getUniforms: assembleGetUniforms(modules)\n  };\n}\n\nfunction assembleShader(gl, _ref) {\n  let {\n    id,\n    source,\n    type,\n    modules,\n    defines = {},\n    hookFunctions = [],\n    inject = {},\n    transpileToGLSL100 = false,\n    prologue = true,\n    log\n  } = _ref;\n  assert(typeof source === 'string', 'shader source must be a string');\n  const isVertex = type === VERTEX_SHADER;\n  const sourceLines = source.split('\\n');\n  let glslVersion = 100;\n  let versionLine = '';\n  let coreSource = source;\n\n  if (sourceLines[0].indexOf('#version ') === 0) {\n    glslVersion = 300;\n    versionLine = sourceLines[0];\n    coreSource = sourceLines.slice(1).join('\\n');\n  } else {\n    versionLine = \"#version \".concat(glslVersion);\n  }\n\n  const allDefines = {};\n  modules.forEach(module => {\n    Object.assign(allDefines, module.getDefines());\n  });\n  Object.assign(allDefines, defines);\n  let assembledSource = prologue ? \"\".concat(versionLine, \"\\n\").concat(getShaderName({\n    id,\n    source,\n    type\n  }), \"\\n\").concat(getShaderType({\n    type\n  }), \"\\n\").concat(getPlatformShaderDefines(gl), \"\\n\").concat(getVersionDefines(gl, glslVersion, !isVertex), \"\\n\").concat(getApplicationDefines(allDefines), \"\\n\").concat(isVertex ? '' : FRAGMENT_SHADER_PROLOGUE, \"\\n\") : \"\".concat(versionLine, \"\\n\");\n  const hookFunctionMap = normalizeHookFunctions(hookFunctions);\n  const hookInjections = {};\n  const declInjections = {};\n  const mainInjections = {};\n\n  for (const key in inject) {\n    const injection = typeof inject[key] === 'string' ? {\n      injection: inject[key],\n      order: 0\n    } : inject[key];\n    const match = key.match(/^(v|f)s:(#)?([\\w-]+)$/);\n\n    if (match) {\n      const hash = match[2];\n      const name = match[3];\n\n      if (hash) {\n        if (name === 'decl') {\n          declInjections[key] = [injection];\n        } else {\n          mainInjections[key] = [injection];\n        }\n      } else {\n        hookInjections[key] = [injection];\n      }\n    } else {\n      mainInjections[key] = [injection];\n    }\n  }\n\n  for (const module of modules) {\n    if (log) {\n      module.checkDeprecations(coreSource, log);\n    }\n\n    const moduleSource = module.getModuleSource(type, glslVersion);\n    assembledSource += moduleSource;\n    const injections = module.injections[type];\n\n    for (const key in injections) {\n      const match = key.match(/^(v|f)s:#([\\w-]+)$/);\n\n      if (match) {\n        const name = match[2];\n        const injectionType = name === 'decl' ? declInjections : mainInjections;\n        injectionType[key] = injectionType[key] || [];\n        injectionType[key].push(injections[key]);\n      } else {\n        hookInjections[key] = hookInjections[key] || [];\n        hookInjections[key].push(injections[key]);\n      }\n    }\n  }\n\n  assembledSource += INJECT_SHADER_DECLARATIONS;\n  assembledSource = injectShader(assembledSource, type, declInjections);\n  assembledSource += getHookFunctions(hookFunctionMap[type], hookInjections);\n  assembledSource += coreSource;\n  assembledSource = injectShader(assembledSource, type, mainInjections);\n  assembledSource = transpileShader(assembledSource, transpileToGLSL100 ? 100 : glslVersion, isVertex);\n  return assembledSource;\n}\n\nfunction assembleGetUniforms(modules) {\n  return function getUniforms(opts) {\n    const uniforms = {};\n\n    for (const module of modules) {\n      const moduleUniforms = module.getUniforms(opts, uniforms);\n      Object.assign(uniforms, moduleUniforms);\n    }\n\n    return uniforms;\n  };\n}\n\nfunction getShaderType(_ref2) {\n  let {\n    type\n  } = _ref2;\n  return \"\\n#define SHADER_TYPE_\".concat(SHADER_TYPE[type].toUpperCase(), \"\\n\");\n}\n\nfunction getShaderName(_ref3) {\n  let {\n    id,\n    source,\n    type\n  } = _ref3;\n  const injectShaderName = id && typeof id === 'string' && source.indexOf('SHADER_NAME') === -1;\n  return injectShaderName ? \"\\n#define SHADER_NAME \".concat(id, \"_\").concat(SHADER_TYPE[type], \"\\n\\n\") : '';\n}\n\nfunction getApplicationDefines() {\n  let defines = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n  let count = 0;\n  let sourceText = '';\n\n  for (const define in defines) {\n    if (count === 0) {\n      sourceText += '\\n// APPLICATION DEFINES\\n';\n    }\n\n    count++;\n    const value = defines[define];\n\n    if (value || Number.isFinite(value)) {\n      sourceText += \"#define \".concat(define.toUpperCase(), \" \").concat(defines[define], \"\\n\");\n    }\n  }\n\n  if (count === 0) {\n    sourceText += '\\n';\n  }\n\n  return sourceText;\n}\n\nfunction getHookFunctions(hookFunctions, hookInjections) {\n  let result = '';\n\n  for (const hookName in hookFunctions) {\n    const hookFunction = hookFunctions[hookName];\n    result += \"void \".concat(hookFunction.signature, \" {\\n\");\n\n    if (hookFunction.header) {\n      result += \"  \".concat(hookFunction.header);\n    }\n\n    if (hookInjections[hookName]) {\n      const injections = hookInjections[hookName];\n      injections.sort((a, b) => a.order - b.order);\n\n      for (const injection of injections) {\n        result += \"  \".concat(injection.injection, \"\\n\");\n      }\n    }\n\n    if (hookFunction.footer) {\n      result += \"  \".concat(hookFunction.footer);\n    }\n\n    result += '}\\n';\n  }\n\n  return result;\n}\n\nfunction normalizeHookFunctions(hookFunctions) {\n  const result = {\n    vs: {},\n    fs: {}\n  };\n  hookFunctions.forEach(hook => {\n    let opts;\n\n    if (typeof hook !== 'string') {\n      opts = hook;\n      hook = opts.hook;\n    } else {\n      opts = {};\n    }\n\n    hook = hook.trim();\n    const [stage, signature] = hook.split(':');\n    const name = hook.replace(/\\(.+/, '');\n    result[stage][name] = Object.assign(opts, {\n      signature\n    });\n  });\n  return result;\n}\n//# sourceMappingURL=assemble-shaders.js.map","import { getContextInfo, hasFeatures, canCompileGLGSExtension, FEATURES } from '../utils/webgl-info';\nexport function getPlatformShaderDefines(gl) {\n  const debugInfo = getContextInfo(gl);\n\n  switch (debugInfo.gpuVendor.toLowerCase()) {\n    case 'nvidia':\n      return \"#define NVIDIA_GPU\\n// Nvidia optimizes away the calculation necessary for emulated fp64\\n#define LUMA_FP64_CODE_ELIMINATION_WORKAROUND 1\\n\";\n\n    case 'intel':\n      return \"#define INTEL_GPU\\n// Intel optimizes away the calculation necessary for emulated fp64\\n#define LUMA_FP64_CODE_ELIMINATION_WORKAROUND 1\\n// Intel's built-in 'tan' function doesn't have acceptable precision\\n#define LUMA_FP32_TAN_PRECISION_WORKAROUND 1\\n// Intel GPU doesn't have full 32 bits precision in same cases, causes overflow\\n#define LUMA_FP64_HIGH_BITS_OVERFLOW_WORKAROUND 1\\n\";\n\n    case 'amd':\n      return \"#define AMD_GPU\\n\";\n\n    default:\n      return \"#define DEFAULT_GPU\\n// Prevent driver from optimizing away the calculation necessary for emulated fp64\\n#define LUMA_FP64_CODE_ELIMINATION_WORKAROUND 1\\n// Intel's built-in 'tan' function doesn't have acceptable precision\\n#define LUMA_FP32_TAN_PRECISION_WORKAROUND 1\\n// Intel GPU doesn't have full 32 bits precision in same cases, causes overflow\\n#define LUMA_FP64_HIGH_BITS_OVERFLOW_WORKAROUND 1\\n\";\n  }\n}\nexport function getVersionDefines(gl, glslVersion, isFragment) {\n  let versionDefines = \"#if (__VERSION__ > 120)\\n\\n# define FEATURE_GLSL_DERIVATIVES\\n# define FEATURE_GLSL_DRAW_BUFFERS\\n# define FEATURE_GLSL_FRAG_DEPTH\\n# define FEATURE_GLSL_TEXTURE_LOD\\n\\n// DEPRECATED FLAGS, remove in v9\\n# define FRAG_DEPTH\\n# define DERIVATIVES\\n# define DRAW_BUFFERS\\n# define TEXTURE_LOD\\n\\n#endif // __VERSION\\n\";\n\n  if (hasFeatures(gl, FEATURES.GLSL_FRAG_DEPTH)) {\n    versionDefines += \"\\n// FRAG_DEPTH => gl_FragDepth is available\\n#ifdef GL_EXT_frag_depth\\n#extension GL_EXT_frag_depth : enable\\n# define FEATURE_GLSL_FRAG_DEPTH\\n# define FRAG_DEPTH\\n# define gl_FragDepth gl_FragDepthEXT\\n#endif\\n\";\n  }\n\n  if (hasFeatures(gl, FEATURES.GLSL_DERIVATIVES) && canCompileGLGSExtension(gl, FEATURES.GLSL_DERIVATIVES)) {\n    versionDefines += \"\\n// DERIVATIVES => dxdF, dxdY and fwidth are available\\n#ifdef GL_OES_standard_derivatives\\n#extension GL_OES_standard_derivatives : enable\\n# define FEATURE_GLSL_DERIVATIVES\\n# define DERIVATIVES\\n#endif\\n\";\n  }\n\n  if (hasFeatures(gl, FEATURES.GLSL_FRAG_DATA) && canCompileGLGSExtension(gl, FEATURES.GLSL_FRAG_DATA, {\n    behavior: 'require'\n  })) {\n    versionDefines += \"\\n// DRAW_BUFFERS => gl_FragData[] is available\\n#ifdef GL_EXT_draw_buffers\\n#extension GL_EXT_draw_buffers : require\\n#define FEATURE_GLSL_DRAW_BUFFERS\\n#define DRAW_BUFFERS\\n#endif\\n\";\n  }\n\n  if (hasFeatures(gl, FEATURES.GLSL_TEXTURE_LOD)) {\n    versionDefines += \"// TEXTURE_LOD => texture2DLod etc are available\\n#ifdef GL_EXT_shader_texture_lod\\n#extension GL_EXT_shader_texture_lod : enable\\n\\n# define FEATURE_GLSL_TEXTURE_LOD\\n# define TEXTURE_LOD\\n\\n#endif\\n\";\n  }\n\n  return versionDefines;\n}\n//# sourceMappingURL=platform-defines.js.map","import { assembleShaders } from '@luma.gl/shadertools';\nimport { Program } from '@luma.gl/webgl';\nexport default class ProgramManager {\n  static getDefaultProgramManager(gl) {\n    gl.luma = gl.luma || {};\n    gl.luma.defaultProgramManager = gl.luma.defaultProgramManager || new ProgramManager(gl);\n    return gl.luma.defaultProgramManager;\n  }\n\n  constructor(gl) {\n    this.gl = gl;\n    this._programCache = {};\n    this._getUniforms = {};\n    this._registeredModules = {};\n    this._hookFunctions = [];\n    this._defaultModules = [];\n    this._hashes = {};\n    this._hashCounter = 0;\n    this.stateHash = 0;\n    this._useCounts = {};\n  }\n\n  addDefaultModule(module) {\n    if (!this._defaultModules.find(m => m.name === module.name)) {\n      this._defaultModules.push(module);\n    }\n\n    this.stateHash++;\n  }\n\n  removeDefaultModule(module) {\n    const moduleName = typeof module === 'string' ? module : module.name;\n    this._defaultModules = this._defaultModules.filter(m => m.name !== moduleName);\n    this.stateHash++;\n  }\n\n  addShaderHook(hook, opts) {\n    if (opts) {\n      hook = Object.assign(opts, {\n        hook\n      });\n    }\n\n    this._hookFunctions.push(hook);\n\n    this.stateHash++;\n  }\n\n  get() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      vs = '',\n      fs = '',\n      defines = {},\n      inject = {},\n      varyings = [],\n      bufferMode = 0x8c8d,\n      transpileToGLSL100 = false\n    } = props;\n\n    const modules = this._getModuleList(props.modules);\n\n    const vsHash = this._getHash(vs);\n\n    const fsHash = this._getHash(fs);\n\n    const moduleHashes = modules.map(m => this._getHash(m.name)).sort();\n    const varyingHashes = varyings.map(v => this._getHash(v));\n    const defineKeys = Object.keys(defines).sort();\n    const injectKeys = Object.keys(inject).sort();\n    const defineHashes = [];\n    const injectHashes = [];\n\n    for (const key of defineKeys) {\n      defineHashes.push(this._getHash(key));\n      defineHashes.push(this._getHash(defines[key]));\n    }\n\n    for (const key of injectKeys) {\n      injectHashes.push(this._getHash(key));\n      injectHashes.push(this._getHash(inject[key]));\n    }\n\n    const hash = \"\".concat(vsHash, \"/\").concat(fsHash, \"D\").concat(defineHashes.join('/'), \"M\").concat(moduleHashes.join('/'), \"I\").concat(injectHashes.join('/'), \"V\").concat(varyingHashes.join('/'), \"H\").concat(this.stateHash, \"B\").concat(bufferMode).concat(transpileToGLSL100 ? 'T' : '');\n\n    if (!this._programCache[hash]) {\n      const assembled = assembleShaders(this.gl, {\n        vs,\n        fs,\n        modules,\n        inject,\n        defines,\n        hookFunctions: this._hookFunctions,\n        transpileToGLSL100\n      });\n      this._programCache[hash] = new Program(this.gl, {\n        hash,\n        vs: assembled.vs,\n        fs: assembled.fs,\n        varyings,\n        bufferMode\n      });\n\n      this._getUniforms[hash] = assembled.getUniforms || (x => {});\n\n      this._useCounts[hash] = 0;\n    }\n\n    this._useCounts[hash]++;\n    return this._programCache[hash];\n  }\n\n  getUniforms(program) {\n    return this._getUniforms[program.hash] || null;\n  }\n\n  release(program) {\n    const hash = program.hash;\n    this._useCounts[hash]--;\n\n    if (this._useCounts[hash] === 0) {\n      this._programCache[hash].delete();\n\n      delete this._programCache[hash];\n      delete this._getUniforms[hash];\n      delete this._useCounts[hash];\n    }\n  }\n\n  _getHash(key) {\n    if (this._hashes[key] === undefined) {\n      this._hashes[key] = this._hashCounter++;\n    }\n\n    return this._hashes[key];\n  }\n\n  _getModuleList() {\n    let appModules = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];\n    const modules = new Array(this._defaultModules.length + appModules.length);\n    const seen = {};\n    let count = 0;\n\n    for (let i = 0, len = this._defaultModules.length; i < len; ++i) {\n      const module = this._defaultModules[i];\n      const name = module.name;\n      modules[count++] = module;\n      seen[name] = true;\n    }\n\n    for (let i = 0, len = appModules.length; i < len; ++i) {\n      const module = appModules[i];\n      const name = module.name;\n\n      if (!seen[name]) {\n        modules[count++] = module;\n        seen[name] = true;\n      }\n    }\n\n    modules.length = count;\n    return modules;\n  }\n\n}\n//# sourceMappingURL=program-manager.js.map","const TYPE_DEFINITIONS = {\n  number: {\n    validate(value, propType) {\n      return Number.isFinite(value) && (!('max' in propType) || value <= propType.max) && (!('min' in propType) || value >= propType.min);\n    }\n\n  },\n  array: {\n    validate(value, propType) {\n      return Array.isArray(value) || ArrayBuffer.isView(value);\n    }\n\n  }\n};\nexport function parsePropTypes(propDefs) {\n  const propTypes = {};\n\n  for (const propName in propDefs) {\n    const propDef = propDefs[propName];\n    const propType = parsePropType(propDef);\n    propTypes[propName] = propType;\n  }\n\n  return propTypes;\n}\n\nfunction parsePropType(propDef) {\n  let type = getTypeOf(propDef);\n\n  if (type === 'object') {\n    if (!propDef) {\n      return {\n        type: 'object',\n        value: null\n      };\n    }\n\n    if ('type' in propDef) {\n      return Object.assign({}, propDef, TYPE_DEFINITIONS[propDef.type]);\n    }\n\n    if (!('value' in propDef)) {\n      return {\n        type: 'object',\n        value: propDef\n      };\n    }\n\n    type = getTypeOf(propDef.value);\n    return Object.assign({\n      type\n    }, propDef, TYPE_DEFINITIONS[type]);\n  }\n\n  return Object.assign({\n    type,\n    value: propDef\n  }, TYPE_DEFINITIONS[type]);\n}\n\nfunction getTypeOf(value) {\n  if (Array.isArray(value) || ArrayBuffer.isView(value)) {\n    return 'array';\n  }\n\n  return typeof value;\n}\n//# sourceMappingURL=prop-types.js.map","import { assert } from '../utils';\nimport { parsePropTypes } from './filters/prop-types';\nconst VERTEX_SHADER = 'vs';\nconst FRAGMENT_SHADER = 'fs';\nexport default class ShaderModule {\n  constructor(_ref) {\n    let {\n      name,\n      vs,\n      fs,\n      dependencies = [],\n      uniforms,\n      getUniforms,\n      deprecations = [],\n      defines = {},\n      inject = {},\n      vertexShader,\n      fragmentShader\n    } = _ref;\n    assert(typeof name === 'string');\n    this.name = name;\n    this.vs = vs || vertexShader;\n    this.fs = fs || fragmentShader;\n    this.getModuleUniforms = getUniforms;\n    this.dependencies = dependencies;\n    this.deprecations = this._parseDeprecationDefinitions(deprecations);\n    this.defines = defines;\n    this.injections = normalizeInjections(inject);\n\n    if (uniforms) {\n      this.uniforms = parsePropTypes(uniforms);\n    }\n  }\n\n  getModuleSource(type) {\n    let moduleSource;\n\n    switch (type) {\n      case VERTEX_SHADER:\n        moduleSource = this.vs || '';\n        break;\n\n      case FRAGMENT_SHADER:\n        moduleSource = this.fs || '';\n        break;\n\n      default:\n        assert(false);\n    }\n\n    return \"#define MODULE_\".concat(this.name.toUpperCase().replace(/[^0-9a-z]/gi, '_'), \"\\n\").concat(moduleSource, \"// END MODULE_\").concat(this.name, \"\\n\\n\");\n  }\n\n  getUniforms(opts, uniforms) {\n    if (this.getModuleUniforms) {\n      return this.getModuleUniforms(opts, uniforms);\n    }\n\n    if (this.uniforms) {\n      return this._defaultGetUniforms(opts);\n    }\n\n    return {};\n  }\n\n  getDefines() {\n    return this.defines;\n  }\n\n  checkDeprecations(shaderSource, log) {\n    this.deprecations.forEach(def => {\n      if (def.regex.test(shaderSource)) {\n        if (def.deprecated) {\n          log.deprecated(def.old, def.new)();\n        } else {\n          log.removed(def.old, def.new)();\n        }\n      }\n    });\n  }\n\n  _parseDeprecationDefinitions(deprecations) {\n    deprecations.forEach(def => {\n      switch (def.type) {\n        case 'function':\n          def.regex = new RegExp(\"\\\\b\".concat(def.old, \"\\\\(\"));\n          break;\n\n        default:\n          def.regex = new RegExp(\"\".concat(def.type, \" \").concat(def.old, \";\"));\n      }\n    });\n    return deprecations;\n  }\n\n  _defaultGetUniforms() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const uniforms = {};\n    const propTypes = this.uniforms;\n\n    for (const key in propTypes) {\n      const propDef = propTypes[key];\n\n      if (key in opts && !propDef.private) {\n        if (propDef.validate) {\n          assert(propDef.validate(opts[key], propDef), \"\".concat(this.name, \": invalid \").concat(key));\n        }\n\n        uniforms[key] = opts[key];\n      } else {\n        uniforms[key] = propDef.value;\n      }\n    }\n\n    return uniforms;\n  }\n\n}\nexport function normalizeShaderModule(module) {\n  if (!module.normalized) {\n    module.normalized = true;\n\n    if (module.uniforms && !module.getUniforms) {\n      const shaderModule = new ShaderModule(module);\n      module.getUniforms = shaderModule.getUniforms.bind(shaderModule);\n    }\n  }\n\n  return module;\n}\n\nfunction normalizeInjections(injections) {\n  const result = {\n    vs: {},\n    fs: {}\n  };\n\n  for (const hook in injections) {\n    let injection = injections[hook];\n    const stage = hook.slice(0, 2);\n\n    if (typeof injection === 'string') {\n      injection = {\n        order: 0,\n        injection\n      };\n    }\n\n    result[stage][hook] = injection;\n  }\n\n  return result;\n}\n//# sourceMappingURL=shader-module.js.map","import { assert } from '../utils/assert';\nexport function glFormatToComponents(format) {\n  switch (format) {\n    case 6406:\n    case 33326:\n    case 6403:\n      return 1;\n\n    case 33328:\n    case 33319:\n      return 2;\n\n    case 6407:\n    case 34837:\n      return 3;\n\n    case 6408:\n    case 34836:\n      return 4;\n\n    default:\n      assert(false);\n      return 0;\n  }\n}\nexport function glTypeToBytes(type) {\n  switch (type) {\n    case 5121:\n      return 1;\n\n    case 33635:\n    case 32819:\n    case 32820:\n      return 2;\n\n    case 5126:\n      return 4;\n\n    default:\n      assert(false);\n      return 0;\n  }\n}\n//# sourceMappingURL=format-utils.js.map","import Buffer from './buffer';\nimport Framebuffer from './framebuffer';\nimport Texture from './texture';\nimport { assertWebGL2Context, withParameters, log } from '@luma.gl/gltools';\nimport { flipRows, scalePixels } from '../webgl-utils/typed-array-utils';\nimport { getTypedArrayFromGLType, getGLTypeFromTypedArray } from '../webgl-utils/typed-array-utils';\nimport { glFormatToComponents, glTypeToBytes } from '../webgl-utils/format-utils';\nimport { toFramebuffer } from '../webgl-utils/texture-utils';\nimport { assert } from '../utils/assert';\nexport function readPixelsToArray(source) {\n  let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n  const {\n    sourceX = 0,\n    sourceY = 0,\n    sourceFormat = 6408\n  } = options;\n  let {\n    sourceAttachment = 36064,\n    target = null,\n    sourceWidth,\n    sourceHeight,\n    sourceType\n  } = options;\n  const {\n    framebuffer,\n    deleteFramebuffer\n  } = getFramebuffer(source);\n  assert(framebuffer);\n  const {\n    gl,\n    handle,\n    attachments\n  } = framebuffer;\n  sourceWidth = sourceWidth || framebuffer.width;\n  sourceHeight = sourceHeight || framebuffer.height;\n\n  if (sourceAttachment === 36064 && handle === null) {\n    sourceAttachment = 1028;\n  }\n\n  assert(attachments[sourceAttachment]);\n  sourceType = sourceType || attachments[sourceAttachment].type;\n  target = getPixelArray(target, sourceType, sourceFormat, sourceWidth, sourceHeight);\n  sourceType = sourceType || getGLTypeFromTypedArray(target);\n  const prevHandle = gl.bindFramebuffer(36160, handle);\n  gl.readPixels(sourceX, sourceY, sourceWidth, sourceHeight, sourceFormat, sourceType, target);\n  gl.bindFramebuffer(36160, prevHandle || null);\n\n  if (deleteFramebuffer) {\n    framebuffer.delete();\n  }\n\n  return target;\n}\nexport function readPixelsToBuffer(source, _ref) {\n  let {\n    sourceX = 0,\n    sourceY = 0,\n    sourceFormat = 6408,\n    target = null,\n    targetByteOffset = 0,\n    sourceWidth,\n    sourceHeight,\n    sourceType\n  } = _ref;\n  const {\n    framebuffer,\n    deleteFramebuffer\n  } = getFramebuffer(source);\n  assert(framebuffer);\n  sourceWidth = sourceWidth || framebuffer.width;\n  sourceHeight = sourceHeight || framebuffer.height;\n  const gl2 = assertWebGL2Context(framebuffer.gl);\n  sourceType = sourceType || (target ? target.type : 5121);\n\n  if (!target) {\n    const components = glFormatToComponents(sourceFormat);\n    const byteCount = glTypeToBytes(sourceType);\n    const byteLength = targetByteOffset + sourceWidth * sourceHeight * components * byteCount;\n    target = new Buffer(gl2, {\n      byteLength,\n      accessor: {\n        type: sourceType,\n        size: components\n      }\n    });\n  }\n\n  target.bind({\n    target: 35051\n  });\n  withParameters(gl2, {\n    framebuffer\n  }, () => {\n    gl2.readPixels(sourceX, sourceY, sourceWidth, sourceHeight, sourceFormat, sourceType, targetByteOffset);\n  });\n  target.unbind({\n    target: 35051\n  });\n\n  if (deleteFramebuffer) {\n    framebuffer.delete();\n  }\n\n  return target;\n}\nexport function copyToDataUrl(source) {\n  let {\n    sourceAttachment = 36064,\n    targetMaxHeight = Number.MAX_SAFE_INTEGER\n  } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n  let data = readPixelsToArray(source, {\n    sourceAttachment\n  });\n  let {\n    width,\n    height\n  } = source;\n\n  while (height > targetMaxHeight) {\n    ({\n      data,\n      width,\n      height\n    } = scalePixels({\n      data,\n      width,\n      height\n    }));\n  }\n\n  flipRows({\n    data,\n    width,\n    height\n  });\n  const canvas = document.createElement('canvas');\n  canvas.width = width;\n  canvas.height = height;\n  const context = canvas.getContext('2d');\n  const imageData = context.createImageData(width, height);\n  imageData.data.set(data);\n  context.putImageData(imageData, 0, 0);\n  return canvas.toDataURL();\n}\nexport function copyToImage(source) {\n  let {\n    sourceAttachment = 36064,\n    targetImage = null\n  } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n  const dataUrl = copyToDataUrl(source, {\n    sourceAttachment\n  });\n  targetImage = targetImage || new Image();\n  targetImage.src = dataUrl;\n  return targetImage;\n}\nexport function copyToTexture(source, target) {\n  let options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};\n  const {\n    sourceX = 0,\n    sourceY = 0,\n    targetMipmaplevel = 0,\n    targetInternalFormat = 6408\n  } = options;\n  let {\n    targetX,\n    targetY,\n    targetZ,\n    width,\n    height\n  } = options;\n  const {\n    framebuffer,\n    deleteFramebuffer\n  } = getFramebuffer(source);\n  assert(framebuffer);\n  const {\n    gl,\n    handle\n  } = framebuffer;\n  const isSubCopy = typeof targetX !== 'undefined' || typeof targetY !== 'undefined' || typeof targetZ !== 'undefined';\n  targetX = targetX || 0;\n  targetY = targetY || 0;\n  targetZ = targetZ || 0;\n  const prevHandle = gl.bindFramebuffer(36160, handle);\n  assert(target);\n  let texture = null;\n\n  if (target instanceof Texture) {\n    texture = target;\n    width = Number.isFinite(width) ? width : texture.width;\n    height = Number.isFinite(height) ? height : texture.height;\n    texture.bind(0);\n    target = texture.target;\n  }\n\n  if (!isSubCopy) {\n    gl.copyTexImage2D(target, targetMipmaplevel, targetInternalFormat, sourceX, sourceY, width, height, 0);\n  } else {\n    switch (target) {\n      case 3553:\n      case 34067:\n        gl.copyTexSubImage2D(target, targetMipmaplevel, targetX, targetY, sourceX, sourceY, width, height);\n        break;\n\n      case 35866:\n      case 32879:\n        const gl2 = assertWebGL2Context(gl);\n        gl2.copyTexSubImage3D(target, targetMipmaplevel, targetX, targetY, targetZ, sourceX, sourceY, width, height);\n        break;\n\n      default:\n    }\n  }\n\n  if (texture) {\n    texture.unbind();\n  }\n\n  gl.bindFramebuffer(36160, prevHandle || null);\n\n  if (deleteFramebuffer) {\n    framebuffer.delete();\n  }\n\n  return texture;\n}\nexport function blit(source, target) {\n  let options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};\n  const {\n    sourceX0 = 0,\n    sourceY0 = 0,\n    targetX0 = 0,\n    targetY0 = 0,\n    color = true,\n    depth = false,\n    stencil = false,\n    filter = 9728\n  } = options;\n  let {\n    sourceX1,\n    sourceY1,\n    targetX1,\n    targetY1,\n    sourceAttachment = 36064,\n    mask = 0\n  } = options;\n  const {\n    framebuffer: srcFramebuffer,\n    deleteFramebuffer: deleteSrcFramebuffer\n  } = getFramebuffer(source);\n  const {\n    framebuffer: dstFramebuffer,\n    deleteFramebuffer: deleteDstFramebuffer\n  } = getFramebuffer(target);\n  assert(srcFramebuffer);\n  assert(dstFramebuffer);\n  const {\n    gl,\n    handle,\n    width,\n    height,\n    readBuffer\n  } = dstFramebuffer;\n  const gl2 = assertWebGL2Context(gl);\n\n  if (!srcFramebuffer.handle && sourceAttachment === 36064) {\n    sourceAttachment = 1028;\n  }\n\n  if (color) {\n    mask |= 16384;\n  }\n\n  if (depth) {\n    mask |= 256;\n  }\n\n  if (stencil) {\n    mask |= 1024;\n  }\n\n  if (deleteSrcFramebuffer || deleteDstFramebuffer) {\n    if (mask & (256 | 1024)) {\n      mask = 16384;\n      log.warn('Blitting from or into a Texture object, forcing mask to GL.COLOR_BUFFER_BIT')();\n    }\n  }\n\n  assert(mask);\n  sourceX1 = sourceX1 === undefined ? srcFramebuffer.width : sourceX1;\n  sourceY1 = sourceY1 === undefined ? srcFramebuffer.height : sourceY1;\n  targetX1 = targetX1 === undefined ? width : targetX1;\n  targetY1 = targetY1 === undefined ? height : targetY1;\n  const prevDrawHandle = gl.bindFramebuffer(36009, handle);\n  const prevReadHandle = gl.bindFramebuffer(36008, srcFramebuffer.handle);\n  gl2.readBuffer(sourceAttachment);\n  gl2.blitFramebuffer(sourceX0, sourceY0, sourceX1, sourceY1, targetX0, targetY0, targetX1, targetY1, mask, filter);\n  gl2.readBuffer(readBuffer);\n  gl2.bindFramebuffer(36008, prevReadHandle || null);\n  gl2.bindFramebuffer(36009, prevDrawHandle || null);\n\n  if (deleteSrcFramebuffer) {\n    srcFramebuffer.delete();\n  }\n\n  if (deleteDstFramebuffer) {\n    dstFramebuffer.delete();\n  }\n\n  return dstFramebuffer;\n}\n\nfunction getFramebuffer(source) {\n  if (!(source instanceof Framebuffer)) {\n    return {\n      framebuffer: toFramebuffer(source),\n      deleteFramebuffer: true\n    };\n  }\n\n  return {\n    framebuffer: source,\n    deleteFramebuffer: false\n  };\n}\n\nfunction getPixelArray(pixelArray, type, format, width, height) {\n  if (pixelArray) {\n    return pixelArray;\n  }\n\n  type = type || 5121;\n  const ArrayType = getTypedArrayFromGLType(type, {\n    clamped: false\n  });\n  const components = glFormatToComponents(format);\n  return new ArrayType(width * height * components);\n}\n//# sourceMappingURL=copy-and-blit.js.map","var _typeof = require(\"./typeof.js\")[\"default\"];\nvar toPrimitive = require(\"./toPrimitive.js\");\nfunction _toPropertyKey(arg) {\n  var key = toPrimitive(arg, \"string\");\n  return _typeof(key) === \"symbol\" ? key : String(key);\n}\nmodule.exports = _toPropertyKey, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","import { isBlob } from '../../javascript-utils/is-type';\nimport { isLoaderObject } from '../loader-utils/normalize-loader';\nimport { getFetchFunction } from '../loader-utils/option-utils';\nimport { parse } from './parse';\nexport async function load(url, loaders, options, context) {\n  if (!Array.isArray(loaders) && !isLoaderObject(loaders)) {\n    context = undefined;\n    options = loaders;\n    loaders = undefined;\n  }\n\n  const fetch = getFetchFunction(options);\n  let data = url;\n\n  if (typeof url === 'string') {\n    data = await fetch(url);\n  }\n\n  if (isBlob(url)) {\n    data = await fetch(url);\n  }\n\n  return await parse(data, loaders, options);\n}\n//# sourceMappingURL=load.js.map","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport project from '../project/project';\nimport type {ShaderModule} from '../../types/types';\n\nconst vs = `\nvec4 project_position_to_clipspace(\n  vec3 position, vec3 position64Low, vec3 offset, out vec4 commonPosition\n) {\n  vec3 projectedPosition = project_position(position, position64Low);\n  mat3 rotation;\n  if (project_needs_rotation(projectedPosition, rotation)) {\n    // offset is specified as ENU\n    // when in globe projection, rotate offset so that the ground alighs with the surface of the globe\n    offset = rotation * offset;\n  }\n  commonPosition = vec4(projectedPosition + offset, 1.0);\n  return project_common_position_to_clipspace(commonPosition);\n}\n\nvec4 project_position_to_clipspace(\n  vec3 position, vec3 position64Low, vec3 offset\n) {\n  vec4 commonPosition;\n  return project_position_to_clipspace(position, position64Low, offset, commonPosition);\n}\n`;\n\nexport default {\n  name: 'project32',\n  dependencies: [project],\n  vs\n} as ShaderModule;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\nimport {deepEqual} from '../utils/deep-equal';\nimport type Layer from './layer';\nimport type CompositeLayer from './composite-layer';\nimport type {UpdateParameters} from './layer';\nimport type {LayerContext} from './layer-manager';\n\nexport default abstract class LayerExtension<OptionsT = undefined> {\n  /**\n   * Note that defaultProps of a LayerExtension does not behave like defaultProps of a Layer:\n      - The default values are not automatically merged with user-supplied props when the layer is constructed\n      - The types are not used during props diff\n   * Currently they are only used in getSubLayerProps\n   * TODO: find a more consistent solution\n   */\n  static defaultProps: any = {};\n  opts!: OptionsT;\n\n  constructor(opts?: OptionsT) {\n    if (opts) {\n      this.opts = opts;\n    }\n  }\n\n  /** Returns true if two extensions are equivalent */\n  equals(extension: LayerExtension<OptionsT>): boolean {\n    if (this === extension) {\n      return true;\n    }\n\n    return this.constructor === extension.constructor && deepEqual(this.opts, extension.opts);\n  }\n\n  /** Only called if attached to a primitive layer */\n  getShaders(this: Layer, extension: this): any {\n    return null;\n  }\n\n  /** Only called if attached to a CompositeLayer */\n  getSubLayerProps(this: CompositeLayer, extension: this): any {\n    const {defaultProps} = extension.constructor as typeof LayerExtension;\n    const newProps = {\n      updateTriggers: {}\n    };\n\n    /* eslint-disable max-depth */\n    for (const key in defaultProps) {\n      if (key in this.props) {\n        const propDef = defaultProps[key];\n        const propValue = this.props[key];\n        newProps[key] = propValue;\n        if (propDef && propDef.type === 'accessor') {\n          newProps.updateTriggers[key] = this.props.updateTriggers[key];\n          if (typeof propValue === 'function') {\n            newProps[key] = this.getSubLayerAccessor(propValue);\n          }\n        }\n      }\n    }\n    /* eslint-enable max-depth */\n    return newProps;\n  }\n\n  /* eslint-disable @typescript-eslint/no-empty-function */\n  initializeState(this: Layer, context: LayerContext, extension: this): void {}\n\n  updateState(this: Layer, params: UpdateParameters<Layer>, extension: this): void {}\n\n  draw(this: Layer, params: any, extension: this): void {}\n\n  finalizeState(this: Layer, context: LayerContext, extension: this): void {}\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\nimport {createIterable, getAccessorFromBuffer} from './iterable-utils';\nimport defaultTypedArrayManager from './typed-array-manager';\nimport assert from './assert';\n\nimport {Buffer} from '@luma.gl/webgl';\n\nimport type {BinaryAttribute} from '../lib/attribute/attribute';\nimport type {TypedArray} from '../types/types';\nimport type {AccessorFunction} from '../types/layer-props';\nimport type {TypedArrayManager} from './typed-array-manager';\n\ntype ExternalBuffer = TypedArray | Buffer | BinaryAttribute;\n\ntype TesselatorOptions<GeometryT, ExtraOptionsT> = ExtraOptionsT & {\n  attributes?: Record<string, any>;\n  getGeometry?: AccessorFunction<any, GeometryT>;\n  data?: any;\n  buffers?: Record<string, ExternalBuffer>;\n  geometryBuffer?: ExternalBuffer;\n  positionFormat?: 'XY' | 'XYZ';\n  dataChanged?: {startRow: number; endRow?: number}[] | string | false;\n  normalize?: boolean;\n};\n\nexport type GeometryUpdateContext = {\n  vertexStart: number;\n  indexStart: number;\n  geometrySize: number;\n  geometryIndex: number;\n};\n\nexport default abstract class Tesselator<GeometryT, NormalizedGeometryT, ExtraOptionsT> {\n  opts: TesselatorOptions<GeometryT, ExtraOptionsT>;\n  typedArrayManager: TypedArrayManager;\n  indexStarts: number[] = [0];\n  vertexStarts: number[] = [0];\n  vertexCount: number = 0;\n  instanceCount: number = 0;\n  attributes: Record<string, TypedArray | null>;\n\n  protected _attributeDefs: any;\n  protected data: any;\n  protected getGeometry?: AccessorFunction<any, GeometryT> | null;\n  protected geometryBuffer?: ExternalBuffer;\n  protected buffers!: Record<string, ExternalBuffer>;\n  protected positionSize!: number;\n  protected normalize!: boolean;\n\n  constructor(opts: TesselatorOptions<GeometryT, ExtraOptionsT>) {\n    const {attributes = {}} = opts;\n\n    this.typedArrayManager = defaultTypedArrayManager;\n    this.attributes = {};\n    this._attributeDefs = attributes;\n    this.opts = opts;\n\n    this.updateGeometry(opts);\n  }\n\n  /* Public methods */\n  updateGeometry(opts: TesselatorOptions<GeometryT, ExtraOptionsT>): void {\n    Object.assign(this.opts, opts);\n    const {\n      data,\n      buffers = {},\n      getGeometry,\n      geometryBuffer,\n      positionFormat,\n      dataChanged,\n      normalize = true\n    } = this.opts;\n    this.data = data;\n    this.getGeometry = getGeometry;\n    this.positionSize =\n      // @ts-ignore (2339) when geometryBuffer is a luma Buffer, size falls back to positionFormat\n      (geometryBuffer && geometryBuffer.size) || (positionFormat === 'XY' ? 2 : 3);\n    this.buffers = buffers;\n    this.normalize = normalize;\n\n    // Handle external logical value\n    if (geometryBuffer) {\n      assert(data.startIndices); // binary data missing startIndices\n      this.getGeometry = this.getGeometryFromBuffer(geometryBuffer);\n\n      if (!normalize) {\n        // skip packing and set attribute value directly\n        // TODO - avoid mutating user-provided object\n        buffers.positions = geometryBuffer;\n      }\n    }\n    this.geometryBuffer = buffers.positions;\n\n    if (Array.isArray(dataChanged)) {\n      // is partial update\n      for (const dataRange of dataChanged as {startRow: number; endRow?: number}[]) {\n        this._rebuildGeometry(dataRange);\n      }\n    } else {\n      this._rebuildGeometry();\n    }\n  }\n\n  updatePartialGeometry({startRow, endRow}: {startRow: number; endRow: number}): void {\n    this._rebuildGeometry({startRow, endRow});\n  }\n\n  // Subclass interface\n\n  /** Convert geometry to a uniform shape */\n  protected abstract normalizeGeometry(geometry: GeometryT): NormalizedGeometryT;\n\n  /** Update the positions buffer of a single geometry */\n  protected abstract updateGeometryAttributes(\n    geometry: NormalizedGeometryT | null,\n    context: GeometryUpdateContext\n  );\n\n  /** Get the number of vertices in a geometry */\n  protected abstract getGeometrySize(geometry: NormalizedGeometryT): number;\n\n  protected getGeometryFromBuffer(\n    geometryBuffer: ExternalBuffer\n  ): AccessorFunction<any, GeometryT> | null {\n    const value = (geometryBuffer as BinaryAttribute).value || geometryBuffer;\n    if (!ArrayBuffer.isView(value)) {\n      // Cannot read binary geometries\n      return null;\n    }\n\n    // @ts-ignore (2322) NumericArray not assignable to GeometryT\n    return getAccessorFromBuffer(value, {\n      size: this.positionSize,\n      offset: (geometryBuffer as BinaryAttribute).offset,\n      stride: (geometryBuffer as BinaryAttribute).stride,\n      startIndices: this.data.startIndices\n    });\n  }\n\n  /* Private utility methods */\n  private _allocate(instanceCount: number, copy: boolean): void {\n    // allocate attributes\n    const {attributes, buffers, _attributeDefs, typedArrayManager} = this;\n    for (const name in _attributeDefs) {\n      if (name in buffers) {\n        // Use external buffer\n        typedArrayManager.release(attributes[name]);\n        attributes[name] = null;\n      } else {\n        const def = _attributeDefs[name];\n        // If dataRange is supplied, this is a partial update.\n        // In case we need to reallocate the typed array, it will need the old values copied\n        // before performing partial update.\n        def.copy = copy;\n\n        attributes[name] = typedArrayManager.allocate(attributes[name], instanceCount, def);\n      }\n    }\n  }\n\n  /**\n   * Visit all objects\n   * `data` is expected to be an iterable consistent with the base Layer expectation\n   */\n  private _forEachGeometry(\n    visitor: (geometry: GeometryT | null, index: number) => void,\n    startRow: number,\n    endRow: number\n  ): void {\n    const {data, getGeometry} = this;\n    const {iterable, objectInfo} = createIterable(data, startRow, endRow);\n    for (const object of iterable) {\n      objectInfo.index++;\n      const geometry = getGeometry ? getGeometry(object, objectInfo) : null;\n      visitor(geometry, objectInfo.index);\n    }\n  }\n\n  /* eslint-disable complexity,max-statements */\n  private _rebuildGeometry(dataRange?: {startRow: number; endRow?: number}): void {\n    if (!this.data) {\n      return;\n    }\n\n    let {indexStarts, vertexStarts, instanceCount} = this;\n    const {data, geometryBuffer} = this;\n    const {startRow = 0, endRow = Infinity} = dataRange || {};\n\n    const normalizedData: Record<number, NormalizedGeometryT | null> = {};\n\n    if (!dataRange) {\n      // Full update - regenerate buffer layout from scratch\n      indexStarts = [0];\n      vertexStarts = [0];\n    }\n    if (this.normalize || !geometryBuffer) {\n      this._forEachGeometry(\n        (geometry: GeometryT | null, dataIndex: number) => {\n          const normalizedGeometry = geometry && this.normalizeGeometry(geometry);\n          normalizedData[dataIndex] = normalizedGeometry;\n          vertexStarts[dataIndex + 1] =\n            vertexStarts[dataIndex] +\n            (normalizedGeometry ? this.getGeometrySize(normalizedGeometry) : 0);\n        },\n        startRow,\n        endRow\n      );\n      // count instances\n      instanceCount = vertexStarts[vertexStarts.length - 1];\n    } else {\n      // assume user provided data is already normalized\n      vertexStarts = data.startIndices;\n      instanceCount = vertexStarts[data.length] || 0;\n\n      if (ArrayBuffer.isView(geometryBuffer)) {\n        instanceCount = instanceCount || geometryBuffer.length / this.positionSize;\n      } else if (geometryBuffer instanceof Buffer) {\n        // @ts-expect-error (2339) accessor is not typed\n        const byteStride = geometryBuffer.accessor.stride || this.positionSize * 4;\n        instanceCount = instanceCount || geometryBuffer.byteLength / byteStride;\n      } else if (geometryBuffer.buffer) {\n        const byteStride = geometryBuffer.stride || this.positionSize * 4;\n        instanceCount = instanceCount || geometryBuffer.buffer.byteLength / byteStride;\n      } else if (geometryBuffer.value) {\n        const bufferValue = geometryBuffer.value;\n        const elementStride =\n          // @ts-ignore (2339) if stride is not specified, will fall through to positionSize\n          geometryBuffer.stride / bufferValue.BYTES_PER_ELEMENT || this.positionSize;\n        instanceCount = instanceCount || bufferValue.length / elementStride;\n      }\n    }\n\n    // allocate attributes\n    this._allocate(instanceCount, Boolean(dataRange));\n\n    this.indexStarts = indexStarts;\n    this.vertexStarts = vertexStarts;\n    this.instanceCount = instanceCount;\n\n    // @ts-ignore (2739) context will be populated in the loop\n    const context: GeometryUpdateContext = {};\n\n    this._forEachGeometry(\n      (geometry: GeometryT | null, dataIndex: number) => {\n        const normalizedGeometry =\n          normalizedData[dataIndex] ||\n          // @ts-expect-error (2352) GeometryT cannot be casted to NormalizedGeometryT. We are assuming the user passed already normalized data if opts.normalize is set to false.\n          (geometry as NormalizedGeometryT);\n        context.vertexStart = vertexStarts[dataIndex];\n        context.indexStart = indexStarts[dataIndex];\n        const vertexEnd =\n          dataIndex < vertexStarts.length - 1 ? vertexStarts[dataIndex + 1] : instanceCount;\n        context.geometrySize = vertexEnd - vertexStarts[dataIndex];\n        context.geometryIndex = dataIndex;\n        this.updateGeometryAttributes(normalizedGeometry, context);\n      },\n      startRow,\n      endRow\n    );\n\n    this.vertexCount = indexStarts[indexStarts.length - 1];\n  }\n}\n","import { WorkerFarm } from '@loaders.gl/worker-utils';\nimport { isBrowser } from '../env-utils/globals';\nexport function canEncodeWithWorker(writer, options) {\n  if (!WorkerFarm.isSupported()) {\n    return false;\n  }\n\n  if (!isBrowser && !(options !== null && options !== void 0 && options._nodeWorkers)) {\n    return false;\n  }\n\n  return writer.worker && (options === null || options === void 0 ? void 0 : options.worker);\n}\n//# sourceMappingURL=encode-with-worker.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { Stats } from '@probe.gl/stats';\nconst STAT_QUEUED_REQUESTS = 'Queued Requests';\nconst STAT_ACTIVE_REQUESTS = 'Active Requests';\nconst STAT_CANCELLED_REQUESTS = 'Cancelled Requests';\nconst STAT_QUEUED_REQUESTS_EVER = 'Queued Requests Ever';\nconst STAT_ACTIVE_REQUESTS_EVER = 'Active Requests Ever';\nconst DEFAULT_PROPS = {\n  id: 'request-scheduler',\n  throttleRequests: true,\n  maxRequests: 6\n};\nexport default class RequestScheduler {\n  constructor(props = {}) {\n    _defineProperty(this, \"props\", void 0);\n\n    _defineProperty(this, \"stats\", void 0);\n\n    _defineProperty(this, \"activeRequestCount\", 0);\n\n    _defineProperty(this, \"requestQueue\", []);\n\n    _defineProperty(this, \"requestMap\", new Map());\n\n    _defineProperty(this, \"deferredUpdate\", null);\n\n    this.props = { ...DEFAULT_PROPS,\n      ...props\n    };\n    this.stats = new Stats({\n      id: this.props.id\n    });\n    this.stats.get(STAT_QUEUED_REQUESTS);\n    this.stats.get(STAT_ACTIVE_REQUESTS);\n    this.stats.get(STAT_CANCELLED_REQUESTS);\n    this.stats.get(STAT_QUEUED_REQUESTS_EVER);\n    this.stats.get(STAT_ACTIVE_REQUESTS_EVER);\n  }\n\n  scheduleRequest(handle, getPriority = () => 0) {\n    if (!this.props.throttleRequests) {\n      return Promise.resolve({\n        done: () => {}\n      });\n    }\n\n    if (this.requestMap.has(handle)) {\n      return this.requestMap.get(handle);\n    }\n\n    const request = {\n      handle,\n      priority: 0,\n      getPriority\n    };\n    const promise = new Promise(resolve => {\n      request.resolve = resolve;\n      return request;\n    });\n    this.requestQueue.push(request);\n    this.requestMap.set(handle, promise);\n\n    this._issueNewRequests();\n\n    return promise;\n  }\n\n  _issueRequest(request) {\n    const {\n      handle,\n      resolve\n    } = request;\n    let isDone = false;\n\n    const done = () => {\n      if (!isDone) {\n        isDone = true;\n        this.requestMap.delete(handle);\n        this.activeRequestCount--;\n\n        this._issueNewRequests();\n      }\n    };\n\n    this.activeRequestCount++;\n    return resolve ? resolve({\n      done\n    }) : Promise.resolve({\n      done\n    });\n  }\n\n  _issueNewRequests() {\n    if (!this.deferredUpdate) {\n      this.deferredUpdate = setTimeout(() => this._issueNewRequestsAsync(), 0);\n    }\n  }\n\n  _issueNewRequestsAsync() {\n    this.deferredUpdate = null;\n    const freeSlots = Math.max(this.props.maxRequests - this.activeRequestCount, 0);\n\n    if (freeSlots === 0) {\n      return;\n    }\n\n    this._updateAllRequests();\n\n    for (let i = 0; i < freeSlots; ++i) {\n      const request = this.requestQueue.shift();\n\n      if (request) {\n        this._issueRequest(request);\n      }\n    }\n  }\n\n  _updateAllRequests() {\n    const requestQueue = this.requestQueue;\n\n    for (let i = 0; i < requestQueue.length; ++i) {\n      const request = requestQueue[i];\n\n      if (!this._updateRequest(request)) {\n        requestQueue.splice(i, 1);\n        this.requestMap.delete(request.handle);\n        i--;\n      }\n    }\n\n    requestQueue.sort((a, b) => a.priority - b.priority);\n  }\n\n  _updateRequest(request) {\n    request.priority = request.getPriority(request.handle);\n\n    if (request.priority < 0) {\n      request.resolve(null);\n      return false;\n    }\n\n    return true;\n  }\n\n}\n//# sourceMappingURL=request-scheduler.js.map","const VERSION = typeof \"3.2.10\" !== 'undefined' ? \"3.2.10\" : 'latest';\nexport const JSONLoader = {\n  name: 'JSON',\n  id: 'json',\n  module: 'json',\n  version: VERSION,\n  extensions: ['json', 'geojson'],\n  mimeTypes: ['application/json'],\n  category: 'json',\n  text: true,\n  parseTextSync,\n  parse: async arrayBuffer => parseTextSync(new TextDecoder().decode(arrayBuffer)),\n  options: {}\n};\n\nfunction parseTextSync(text) {\n  return JSON.parse(text);\n}\n\nexport const _typecheckJSONLoader = JSONLoader;\n//# sourceMappingURL=json-loader.js.map","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {CubeGeometry} from '@luma.gl/core';\nimport {UNIT} from '@deck.gl/core';\nimport ColumnLayer, {ColumnLayerProps} from './column-layer';\n\nimport type {DefaultProps} from '@deck.gl/core';\n\nconst defaultProps: DefaultProps<GridCellLayerProps> = {\n  cellSize: {type: 'number', min: 0, value: 1000},\n  offset: {type: 'array', value: [1, 1]}\n};\n\n/** All properties supported by GridCellLayer. */\nexport type GridCellLayerProps<DataT = any> = _GridCellLayerProps & ColumnLayerProps<DataT>;\n\n/** Properties added by GridCellLayer. */\ntype _GridCellLayerProps = {\n  /**\n   * @default 1000\n   */\n  cellSize?: number;\n};\n\nexport default class GridCellLayer<DataT = any, ExtraPropsT = {}> extends ColumnLayer<\n  DataT,\n  ExtraPropsT & Required<_GridCellLayerProps>\n> {\n  static layerName = 'GridCellLayer';\n  static defaultProps = defaultProps;\n\n  getGeometry(diskResolution) {\n    return new CubeGeometry();\n  }\n\n  draw({uniforms}) {\n    const {elevationScale, extruded, offset, coverage, cellSize, angle, radiusUnits} = this.props;\n    this.state.model\n      .setUniforms(uniforms)\n      .setUniforms({\n        radius: cellSize / 2,\n        radiusUnits: UNIT[radiusUnits],\n        angle,\n        offset,\n        extruded,\n        coverage,\n        elevationScale,\n        edgeDistance: 1,\n        isWireframe: false\n      })\n      .draw();\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {\n  Accessor,\n  AccessorFunction,\n  Color,\n  CompositeLayer,\n  CompositeLayerProps,\n  createIterable,\n  Layer,\n  LayersList,\n  log,\n  Unit,\n  Material,\n  UpdateParameters,\n  DefaultProps\n} from '@deck.gl/core';\nimport SolidPolygonLayer from '../solid-polygon-layer/solid-polygon-layer';\nimport PathLayer from '../path-layer/path-layer';\nimport * as Polygon from '../solid-polygon-layer/polygon';\nimport {replaceInRange} from '../utils';\n\n/**\n * All properties supported by `PolygonLayer`.\n */\nexport type PolygonLayerProps<DataT = any> = _PolygonLayerProps<DataT> & CompositeLayerProps<DataT>;\n\n/**\n * Properties added by `PolygonLayer`.\n */\ntype _PolygonLayerProps<DataT = any> = {\n  /**\n   * Whether to draw an outline around the polygon (solid fill).\n   *\n   * Note that both the outer polygon as well the outlines of any holes will be drawn.\n   *\n   * @default true\n   */\n  stroked?: boolean;\n\n  /**\n   * Whether to draw a filled polygon (solid fill).\n   *\n   * Note that only the area between the outer polygon and any holes will be filled.\n   *\n   * @default true\n   */\n  filled?: boolean;\n\n  /**\n   * Whether to extrude the polygons.\n   *\n   * Based on the elevations provided by the `getElevation` accessor.\n   *\n   * If set to `false`, all polygons will be flat, this generates less geometry and is faster\n   * than simply returning 0 from getElevation.\n   *\n   * @default false\n   */\n  extruded?: boolean;\n\n  /**\n   * Elevation multiplier.\n   *\n   * The final elevation is calculated by `elevationScale * getElevation(d)`.\n   * `elevationScale` is a handy property to scale all elevation without updating the data.\n   *\n   * @default 1\n   */\n  elevationScale?: number;\n\n  /**\n   * Whether to generate a line wireframe of the hexagon.\n   *\n   * The outline will have \"horizontal\" lines closing the top and bottom polygons and a vertical\n   * line (a \"strut\") for each vertex on the polygon.\n   *\n   * @default false\n   */\n  wireframe?: boolean;\n\n  /**\n   * The units of the line width, one of `meters`, `common`, and `pixels`.\n   *\n   * @default 'meters'\n   * @see Unit.\n   */\n  lineWidthUnits?: Unit;\n\n  /**\n   * The line width multiplier that multiplied to all outlines of `Polygon` and `MultiPolygon`\n   * features if the stroked attribute is true.\n   *\n   * @default 1\n   */\n  lineWidthScale?: number;\n\n  /**\n   * The minimum line width in pixels.\n   *\n   * @default 0\n   */\n  lineWidthMinPixels?: number;\n\n  /**\n   * The maximum line width in pixels\n   *\n   * @default Number.MAX_SAFE_INTEGER\n   */\n  lineWidthMaxPixels?: number;\n\n  /**\n   * Type of joint. If `true`, draw round joints. Otherwise draw miter joints.\n   *\n   * @default false\n   */\n  lineJointRounded?: boolean;\n\n  /**\n   * The maximum extent of a joint in ratio to the stroke width.\n   *\n   * Only works if `lineJointRounded` is false.\n   *\n   * @default 4\n   */\n  lineMiterLimit?: number;\n\n  lineDashJustified?: boolean;\n\n  /** Called on each object in the data stream to retrieve its corresponding polygon. */\n  getPolygon?: AccessorFunction<DataT, any>;\n\n  /**\n   * Fill collor value or accessor.\n   *\n   * @default [0, 0, 0, 255]\n   */\n  getFillColor?: Accessor<DataT, Color>;\n\n  /**\n   * Line color value or accessor.\n   *\n   * @default [0, 0, 0, 255]\n   */\n  getLineColor?: Accessor<DataT, Color>;\n\n  /**\n   * Line width value or accessor.\n   *\n   * @default [0, 0, 0, 255]\n   */\n  getLineWidth?: Accessor<DataT, number>;\n\n  /**\n   * Elevation valur or accessor.\n   *\n   * Only used if `extruded: true`.\n   *\n   * @default 1000\n   */\n  getElevation?: Accessor<DataT, number>;\n\n  /**\n   * This property has been moved to `PathStyleExtension`.\n   *\n   * @deprecated\n   */\n  getLineDashArray?: Accessor<DataT, number> | null;\n\n  /**\n   * If `false`, will skip normalizing the coordinates returned by `getPolygon`.\n   *\n   * **Note**: This prop is experimental\n   *\n   * @default true\n   */\n  _normalize?: boolean;\n\n  /**\n   * Specifies the winding order of rings in the polygon data.\n   *\n   * **Note**: This prop is experimental\n   *\n   * @default 'CW'\n   */\n  _windingOrder?: 'CW' | 'CCW';\n\n  /**\n   * Material settings for lighting effect. Applies if `extruded: true`.\n   *\n   * @default true\n   * @see https://deck.gl/docs/developer-guide/using-lighting\n   */\n  material?: Material;\n};\n\nconst defaultLineColor: [number, number, number, number] = [0, 0, 0, 255];\nconst defaultFillColor: [number, number, number, number] = [0, 0, 0, 255];\n\nconst defaultProps: DefaultProps<PolygonLayerProps> = {\n  stroked: true,\n  filled: true,\n  extruded: false,\n  elevationScale: 1,\n  wireframe: false,\n  _normalize: true,\n  _windingOrder: 'CW',\n\n  lineWidthUnits: 'meters',\n  lineWidthScale: 1,\n  lineWidthMinPixels: 0,\n  lineWidthMaxPixels: Number.MAX_SAFE_INTEGER,\n  lineJointRounded: false,\n  lineMiterLimit: 4,\n\n  getPolygon: {type: 'accessor', value: f => f.polygon},\n  // Polygon fill color\n  getFillColor: {type: 'accessor', value: defaultFillColor},\n  // Point, line and polygon outline color\n  getLineColor: {type: 'accessor', value: defaultLineColor},\n  // Line and polygon outline accessors\n  getLineWidth: {type: 'accessor', value: 1},\n  // Polygon extrusion accessor\n  getElevation: {type: 'accessor', value: 1000},\n\n  // Optional material for 'lighting' shader module\n  material: true\n};\n\n/** A composite layer that renders filled, stroked and/or extruded polygons. */\nexport default class PolygonLayer<DataT = any, ExtraProps = {}> extends CompositeLayer<\n  Required<_PolygonLayerProps<DataT>> & ExtraProps\n> {\n  static layerName = 'PolygonLayer';\n  static defaultProps = defaultProps;\n\n  initializeState(): void {\n    this.state = {\n      paths: []\n    };\n\n    if (this.props.getLineDashArray) {\n      log.removed('getLineDashArray', 'PathStyleExtension')();\n    }\n  }\n\n  updateState({changeFlags}: UpdateParameters<this>) {\n    const geometryChanged =\n      changeFlags.dataChanged ||\n      (changeFlags.updateTriggersChanged &&\n        (changeFlags.updateTriggersChanged.all || changeFlags.updateTriggersChanged.getPolygon));\n\n    if (geometryChanged && Array.isArray(changeFlags.dataChanged)) {\n      const paths = this.state.paths.slice();\n      const pathsDiff = changeFlags.dataChanged.map(dataRange =>\n        replaceInRange({\n          data: paths,\n          getIndex: p => p.__source.index,\n          dataRange,\n          replace: this._getPaths(dataRange)\n        })\n      );\n      this.setState({paths, pathsDiff});\n    } else if (geometryChanged) {\n      this.setState({\n        paths: this._getPaths(),\n        pathsDiff: null\n      });\n    }\n  }\n\n  private _getPaths(dataRange: {startRow?: number; endRow?: number} = {}): {path: number[]}[] {\n    const {data, getPolygon, positionFormat, _normalize} = this.props;\n    const paths: {path: number[]}[] = [];\n    const positionSize = positionFormat === 'XY' ? 2 : 3;\n    const {startRow, endRow} = dataRange;\n\n    const {iterable, objectInfo} = createIterable(data, startRow, endRow);\n    for (const object of iterable) {\n      objectInfo.index++;\n      let polygon = getPolygon(object, objectInfo);\n      if (_normalize) {\n        polygon = Polygon.normalize(polygon, positionSize);\n      }\n      const {holeIndices} = polygon;\n      const positions = polygon.positions || polygon;\n\n      if (holeIndices) {\n        // split the positions array into `holeIndices.length + 1` rings\n        // holeIndices[-1] falls back to 0\n        // holeIndices[holeIndices.length] falls back to positions.length\n        for (let i = 0; i <= holeIndices.length; i++) {\n          const path = positions.slice(holeIndices[i - 1] || 0, holeIndices[i] || positions.length);\n          paths.push(this.getSubLayerRow({path}, object, objectInfo.index));\n        }\n      } else {\n        paths.push(this.getSubLayerRow({path: positions}, object, objectInfo.index));\n      }\n    }\n    return paths;\n  }\n\n  /* eslint-disable complexity */\n  renderLayers(): Layer | null | LayersList {\n    // Layer composition props\n    const {\n      data,\n      _dataDiff,\n      stroked,\n      filled,\n      extruded,\n      wireframe,\n      _normalize,\n      _windingOrder,\n      elevationScale,\n      transitions,\n      positionFormat\n    } = this.props;\n\n    // Rendering props underlying layer\n    const {\n      lineWidthUnits,\n      lineWidthScale,\n      lineWidthMinPixels,\n      lineWidthMaxPixels,\n      lineJointRounded,\n      lineMiterLimit,\n      lineDashJustified\n    } = this.props;\n\n    // Accessor props for underlying layers\n    const {\n      getFillColor,\n      getLineColor,\n      getLineWidth,\n      getLineDashArray,\n      getElevation,\n      getPolygon,\n      updateTriggers,\n      material\n    } = this.props;\n\n    const {paths, pathsDiff} = this.state;\n\n    const FillLayer = this.getSubLayerClass('fill', SolidPolygonLayer);\n    const StrokeLayer = this.getSubLayerClass('stroke', PathLayer);\n\n    // Filled Polygon Layer\n    const polygonLayer =\n      this.shouldRenderSubLayer('fill', paths) &&\n      new FillLayer(\n        {\n          _dataDiff,\n          extruded,\n          elevationScale,\n\n          filled,\n          wireframe,\n          _normalize,\n          _windingOrder,\n\n          getElevation,\n          getFillColor,\n          getLineColor: extruded && wireframe ? getLineColor : defaultLineColor,\n\n          material,\n          transitions\n        },\n        this.getSubLayerProps({\n          id: 'fill',\n          updateTriggers: updateTriggers && {\n            getPolygon: updateTriggers.getPolygon,\n            getElevation: updateTriggers.getElevation,\n            getFillColor: updateTriggers.getFillColor,\n            // using a legacy API to invalid lineColor attributes\n            // if (extruded && wireframe) has changed\n            lineColors: extruded && wireframe,\n            getLineColor: updateTriggers.getLineColor\n          }\n        }),\n        {\n          data,\n          positionFormat,\n          getPolygon\n        }\n      );\n\n    // Polygon line layer\n    const polygonLineLayer =\n      !extruded &&\n      stroked &&\n      this.shouldRenderSubLayer('stroke', paths) &&\n      new StrokeLayer(\n        {\n          _dataDiff: pathsDiff && (() => pathsDiff),\n          widthUnits: lineWidthUnits,\n          widthScale: lineWidthScale,\n          widthMinPixels: lineWidthMinPixels,\n          widthMaxPixels: lineWidthMaxPixels,\n          jointRounded: lineJointRounded,\n          miterLimit: lineMiterLimit,\n          dashJustified: lineDashJustified,\n\n          // Already normalized\n          _pathType: 'loop',\n\n          transitions: transitions && {\n            getWidth: transitions.getLineWidth,\n            getColor: transitions.getLineColor,\n            getPath: transitions.getPolygon\n          },\n\n          getColor: this.getSubLayerAccessor(getLineColor),\n          getWidth: this.getSubLayerAccessor(getLineWidth),\n          getDashArray: this.getSubLayerAccessor(getLineDashArray)\n        },\n        this.getSubLayerProps({\n          id: 'stroke',\n          updateTriggers: updateTriggers && {\n            getWidth: updateTriggers.getLineWidth,\n            getColor: updateTriggers.getLineColor,\n            getDashArray: updateTriggers.getLineDashArray\n          }\n        }),\n        {\n          data: paths,\n          positionFormat,\n          getPath: x => x.path\n        }\n      );\n\n    return [\n      // If not extruded: flat fill layer is drawn below outlines\n      !extruded && polygonLayer,\n      polygonLineLayer,\n      // If extruded: draw fill layer last for correct blending behavior\n      extruded && polygonLayer\n    ];\n  }\n  /* eslint-enable complexity */\n}\n","import { getFirstCharacters } from '../binary-utils/get-first-characters';\nexport function parseJSON(string) {\n  try {\n    return JSON.parse(string);\n  } catch (_) {\n    throw new Error(\"Failed to parse JSON from data starting with \\\"\".concat(getFirstCharacters(string), \"\\\"\"));\n  }\n}\n//# sourceMappingURL=parse-json.js.map","exports.read = function (buffer, offset, isLE, mLen, nBytes) {\n  var e, m\n  var eLen = (nBytes * 8) - mLen - 1\n  var eMax = (1 << eLen) - 1\n  var eBias = eMax >> 1\n  var nBits = -7\n  var i = isLE ? (nBytes - 1) : 0\n  var d = isLE ? -1 : 1\n  var s = buffer[offset + i]\n\n  i += d\n\n  e = s & ((1 << (-nBits)) - 1)\n  s >>= (-nBits)\n  nBits += eLen\n  for (; nBits > 0; e = (e * 256) + buffer[offset + i], i += d, nBits -= 8) {}\n\n  m = e & ((1 << (-nBits)) - 1)\n  e >>= (-nBits)\n  nBits += mLen\n  for (; nBits > 0; m = (m * 256) + buffer[offset + i], i += d, nBits -= 8) {}\n\n  if (e === 0) {\n    e = 1 - eBias\n  } else if (e === eMax) {\n    return m ? NaN : ((s ? -1 : 1) * Infinity)\n  } else {\n    m = m + Math.pow(2, mLen)\n    e = e - eBias\n  }\n  return (s ? -1 : 1) * m * Math.pow(2, e - mLen)\n}\n\nexports.write = function (buffer, value, offset, isLE, mLen, nBytes) {\n  var e, m, c\n  var eLen = (nBytes * 8) - mLen - 1\n  var eMax = (1 << eLen) - 1\n  var eBias = eMax >> 1\n  var rt = (mLen === 23 ? Math.pow(2, -24) - Math.pow(2, -77) : 0)\n  var i = isLE ? 0 : (nBytes - 1)\n  var d = isLE ? 1 : -1\n  var s = value < 0 || (value === 0 && 1 / value < 0) ? 1 : 0\n\n  value = Math.abs(value)\n\n  if (isNaN(value) || value === Infinity) {\n    m = isNaN(value) ? 1 : 0\n    e = eMax\n  } else {\n    e = Math.floor(Math.log(value) / Math.LN2)\n    if (value * (c = Math.pow(2, -e)) < 1) {\n      e--\n      c *= 2\n    }\n    if (e + eBias >= 1) {\n      value += rt / c\n    } else {\n      value += rt * Math.pow(2, 1 - eBias)\n    }\n    if (value * c >= 2) {\n      e++\n      c /= 2\n    }\n\n    if (e + eBias >= eMax) {\n      m = 0\n      e = eMax\n    } else if (e + eBias >= 1) {\n      m = ((value * c) - 1) * Math.pow(2, mLen)\n      e = e + eBias\n    } else {\n      m = value * Math.pow(2, eBias - 1) * Math.pow(2, mLen)\n      e = 0\n    }\n  }\n\n  for (; mLen >= 8; buffer[offset + i] = m & 0xff, i += d, m /= 256, mLen -= 8) {}\n\n  e = (e << mLen) | m\n  eLen += mLen\n  for (; eLen > 0; buffer[offset + i] = e & 0xff, i += d, e /= 256, eLen -= 8) {}\n\n  buffer[offset + i - d] |= s * 128\n}\n","function _arrayLikeToArray(arr, len) {\n  if (len == null || len > arr.length) len = arr.length;\n  for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i];\n  return arr2;\n}\nmodule.exports = _arrayLikeToArray, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","import { Vector3, Matrix4 } from '@math.gl/core';\nimport { assert, uid } from '@luma.gl/webgl';\nexport default class ScenegraphNode {\n  constructor() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      id\n    } = props;\n    this.id = id || uid(this.constructor.name);\n    this.display = true;\n    this.position = new Vector3();\n    this.rotation = new Vector3();\n    this.scale = new Vector3(1, 1, 1);\n    this.matrix = new Matrix4();\n    this.userData = {};\n    this.props = {};\n\n    this._setScenegraphNodeProps(props);\n  }\n\n  delete() {}\n\n  setProps(props) {\n    this._setScenegraphNodeProps(props);\n\n    return this;\n  }\n\n  toString() {\n    return \"{type: ScenegraphNode, id: \".concat(this.id, \")}\");\n  }\n\n  setPosition(position) {\n    assert(position.length === 3, 'setPosition requires vector argument');\n    this.position = position;\n    return this;\n  }\n\n  setRotation(rotation) {\n    assert(rotation.length === 3, 'setRotation requires vector argument');\n    this.rotation = rotation;\n    return this;\n  }\n\n  setScale(scale) {\n    assert(scale.length === 3, 'setScale requires vector argument');\n    this.scale = scale;\n    return this;\n  }\n\n  setMatrix(matrix) {\n    let copyMatrix = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;\n\n    if (copyMatrix) {\n      this.matrix.copy(matrix);\n    } else {\n      this.matrix = matrix;\n    }\n  }\n\n  setMatrixComponents(_ref) {\n    let {\n      position,\n      rotation,\n      scale,\n      update = true\n    } = _ref;\n\n    if (position) {\n      this.setPosition(position);\n    }\n\n    if (rotation) {\n      this.setRotation(rotation);\n    }\n\n    if (scale) {\n      this.setScale(scale);\n    }\n\n    if (update) {\n      this.updateMatrix();\n    }\n\n    return this;\n  }\n\n  updateMatrix() {\n    const pos = this.position;\n    const rot = this.rotation;\n    const scale = this.scale;\n    this.matrix.identity();\n    this.matrix.translate(pos);\n    this.matrix.rotateXYZ(rot);\n    this.matrix.scale(scale);\n    return this;\n  }\n\n  update() {\n    let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      position,\n      rotation,\n      scale\n    } = options;\n\n    if (position) {\n      this.setPosition(position);\n    }\n\n    if (rotation) {\n      this.setRotation(rotation);\n    }\n\n    if (scale) {\n      this.setScale(scale);\n    }\n\n    this.updateMatrix();\n    return this;\n  }\n\n  getCoordinateUniforms(viewMatrix, modelMatrix) {\n    assert(viewMatrix);\n    modelMatrix = modelMatrix || this.matrix;\n    const worldMatrix = new Matrix4(viewMatrix).multiplyRight(modelMatrix);\n    const worldInverse = worldMatrix.invert();\n    const worldInverseTranspose = worldInverse.transpose();\n    return {\n      viewMatrix,\n      modelMatrix,\n      objectMatrix: modelMatrix,\n      worldMatrix,\n      worldInverseMatrix: worldInverse,\n      worldInverseTransposeMatrix: worldInverseTranspose\n    };\n  }\n\n  _setScenegraphNodeProps(props) {\n    if ('display' in props) {\n      this.display = props.display;\n    }\n\n    if ('position' in props) {\n      this.setPosition(props.position);\n    }\n\n    if ('rotation' in props) {\n      this.setRotation(props.rotation);\n    }\n\n    if ('scale' in props) {\n      this.setScale(props.scale);\n    }\n\n    if ('matrix' in props) {\n      this.setMatrix(props.matrix);\n    }\n\n    Object.assign(this.props, props);\n  }\n\n}\n//# sourceMappingURL=scenegraph-node.js.map","import { Matrix4 } from '@math.gl/core';\nimport { log } from '@luma.gl/webgl';\nimport ScenegraphNode from './scenegraph-node';\nexport default class GroupNode extends ScenegraphNode {\n  constructor() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    props = Array.isArray(props) ? {\n      children: props\n    } : props;\n    const {\n      children = []\n    } = props;\n    log.assert(children.every(child => child instanceof ScenegraphNode), 'every child must an instance of ScenegraphNode');\n    super(props);\n    this.children = children;\n  }\n\n  add() {\n    for (var _len = arguments.length, children = new Array(_len), _key = 0; _key < _len; _key++) {\n      children[_key] = arguments[_key];\n    }\n\n    for (const child of children) {\n      if (Array.isArray(child)) {\n        this.add(...child);\n      } else {\n        this.children.push(child);\n      }\n    }\n\n    return this;\n  }\n\n  remove(child) {\n    const children = this.children;\n    const indexOf = children.indexOf(child);\n\n    if (indexOf > -1) {\n      children.splice(indexOf, 1);\n    }\n\n    return this;\n  }\n\n  removeAll() {\n    this.children = [];\n    return this;\n  }\n\n  delete() {\n    this.children.forEach(child => child.delete());\n    this.removeAll();\n    super.delete();\n  }\n\n  traverse(visitor) {\n    let {\n      worldMatrix = new Matrix4()\n    } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    const modelMatrix = new Matrix4(worldMatrix).multiplyRight(this.matrix);\n\n    for (const child of this.children) {\n      if (child instanceof GroupNode) {\n        child.traverse(visitor, {\n          worldMatrix: modelMatrix\n        });\n      } else {\n        visitor(child, {\n          worldMatrix: modelMatrix\n        });\n      }\n    }\n  }\n\n}\n//# sourceMappingURL=group-node.js.map","import { assert, log } from '@luma.gl/webgl';\nimport { Matrix4, Quaternion } from '@math.gl/core';\nexport const ATTRIBUTE_TYPE_TO_COMPONENTS = {\n  SCALAR: 1,\n  VEC2: 2,\n  VEC3: 3,\n  VEC4: 4,\n  MAT2: 4,\n  MAT3: 9,\n  MAT4: 16\n};\nexport const ATTRIBUTE_COMPONENT_TYPE_TO_ARRAY = {\n  5120: Int8Array,\n  5121: Uint8Array,\n  5122: Int16Array,\n  5123: Uint16Array,\n  5125: Uint32Array,\n  5126: Float32Array\n};\n\nfunction accessorToJsArray(accessor) {\n  if (!accessor._animation) {\n    const ArrayType = ATTRIBUTE_COMPONENT_TYPE_TO_ARRAY[accessor.componentType];\n    const components = ATTRIBUTE_TYPE_TO_COMPONENTS[accessor.type];\n    const length = components * accessor.count;\n    const {\n      buffer,\n      byteOffset\n    } = accessor.bufferView.data;\n    const array = new ArrayType(buffer, byteOffset + (accessor.byteOffset || 0), length);\n\n    if (components === 1) {\n      accessor._animation = Array.from(array);\n    } else {\n      const slicedArray = [];\n\n      for (let i = 0; i < array.length; i += components) {\n        slicedArray.push(Array.from(array.slice(i, i + components)));\n      }\n\n      accessor._animation = slicedArray;\n    }\n  }\n\n  return accessor._animation;\n}\n\nconst helperMatrix = new Matrix4();\n\nfunction applyTranslationRotationScale(gltfNode, node) {\n  node.matrix.identity();\n\n  if (gltfNode.translation) {\n    node.matrix.translate(gltfNode.translation);\n  }\n\n  if (gltfNode.rotation) {\n    const rotationMatrix = helperMatrix.fromQuaternion(gltfNode.rotation);\n    node.matrix.multiplyRight(rotationMatrix);\n  }\n\n  if (gltfNode.scale) {\n    node.matrix.scale(gltfNode.scale);\n  }\n}\n\nconst quaternion = new Quaternion();\n\nfunction linearInterpolate(target, path, start, stop, ratio) {\n  if (path === 'rotation') {\n    quaternion.slerp({\n      start,\n      target: stop,\n      ratio\n    });\n\n    for (let i = 0; i < quaternion.length; i++) {\n      target[path][i] = quaternion[i];\n    }\n  } else {\n    for (let i = 0; i < start.length; i++) {\n      target[path][i] = ratio * stop[i] + (1 - ratio) * start[i];\n    }\n  }\n}\n\nfunction cubicsplineInterpolate(target, path, _ref) {\n  let {\n    p0,\n    outTangent0,\n    inTangent1,\n    p1,\n    tDiff,\n    ratio: t\n  } = _ref;\n\n  for (let i = 0; i < target[path].length; i++) {\n    const m0 = outTangent0[i] * tDiff;\n    const m1 = inTangent1[i] * tDiff;\n    target[path][i] = (2 * Math.pow(t, 3) - 3 * Math.pow(t, 2) + 1) * p0[i] + (Math.pow(t, 3) - 2 * Math.pow(t, 2) + t) * m0 + (-2 * Math.pow(t, 3) + 3 * Math.pow(t, 2)) * p1[i] + (Math.pow(t, 3) - Math.pow(t, 2)) * m1;\n  }\n}\n\nfunction stepInterpolate(target, path, value) {\n  for (let i = 0; i < value.length; i++) {\n    target[path][i] = value[i];\n  }\n}\n\nfunction interpolate(time, _ref2, target, path) {\n  let {\n    input,\n    interpolation,\n    output\n  } = _ref2;\n  const maxTime = input[input.length - 1];\n  const animationTime = time % maxTime;\n  const nextIndex = input.findIndex(t => t >= animationTime);\n  const previousIndex = Math.max(0, nextIndex - 1);\n\n  if (!Array.isArray(target[path])) {\n    switch (path) {\n      case 'translation':\n        target[path] = [0, 0, 0];\n        break;\n\n      case 'rotation':\n        target[path] = [0, 0, 0, 1];\n        break;\n\n      case 'scale':\n        target[path] = [1, 1, 1];\n        break;\n\n      default:\n        log.warn(\"Bad animation path \".concat(path))();\n    }\n  }\n\n  assert(target[path].length === output[previousIndex].length);\n  const previousTime = input[previousIndex];\n  const nextTime = input[nextIndex];\n\n  switch (interpolation) {\n    case 'STEP':\n      stepInterpolate(target, path, output[previousIndex]);\n      break;\n\n    case 'LINEAR':\n      if (nextTime > previousTime) {\n        const ratio = (animationTime - previousTime) / (nextTime - previousTime);\n        linearInterpolate(target, path, output[previousIndex], output[nextIndex], ratio);\n      }\n\n      break;\n\n    case 'CUBICSPLINE':\n      if (nextTime > previousTime) {\n        const ratio = (animationTime - previousTime) / (nextTime - previousTime);\n        const tDiff = nextTime - previousTime;\n        const p0 = output[3 * previousIndex + 1];\n        const outTangent0 = output[3 * previousIndex + 2];\n        const inTangent1 = output[3 * nextIndex + 0];\n        const p1 = output[3 * nextIndex + 1];\n        cubicsplineInterpolate(target, path, {\n          p0,\n          outTangent0,\n          inTangent1,\n          p1,\n          tDiff,\n          ratio\n        });\n      }\n\n      break;\n\n    default:\n      log.warn(\"Interpolation \".concat(interpolation, \" not supported\"))();\n      break;\n  }\n}\n\nclass GLTFAnimation {\n  constructor(props) {\n    this.startTime = 0;\n    this.playing = true;\n    this.speed = 1;\n    this.channels = [];\n    Object.assign(this, props);\n  }\n\n  animate(timeMs) {\n    if (!this.playing) {\n      return;\n    }\n\n    const absTime = timeMs / 1000;\n    const time = (absTime - this.startTime) * this.speed;\n    this.channels.forEach(_ref3 => {\n      let {\n        sampler,\n        target,\n        path\n      } = _ref3;\n      interpolate(time, sampler, target, path);\n      applyTranslationRotationScale(target, target._node);\n    });\n  }\n\n}\n\nexport default class GLTFAnimator {\n  constructor(gltf) {\n    this.animations = gltf.animations.map((animation, index) => {\n      const name = animation.name || \"Animation-\".concat(index);\n      const samplers = animation.samplers.map(_ref4 => {\n        let {\n          input,\n          interpolation = 'LINEAR',\n          output\n        } = _ref4;\n        return {\n          input: accessorToJsArray(gltf.accessors[input]),\n          interpolation,\n          output: accessorToJsArray(gltf.accessors[output])\n        };\n      });\n      const channels = animation.channels.map(_ref5 => {\n        let {\n          sampler,\n          target\n        } = _ref5;\n        return {\n          sampler: samplers[sampler],\n          target: gltf.nodes[target.node],\n          path: target.path\n        };\n      });\n      return new GLTFAnimation({\n        name,\n        channels\n      });\n    });\n  }\n\n  animate(time) {\n    this.setTime(time);\n  }\n\n  setTime(time) {\n    this.animations.forEach(animation => animation.animate(time));\n  }\n\n  getAnimations() {\n    return this.animations;\n  }\n\n}\n//# sourceMappingURL=gltf-animator.js.map","import { Model } from '@luma.gl/engine';\nimport ScenegraphNode from './scenegraph-node';\nexport default class ModelNode extends ScenegraphNode {\n  constructor(gl) {\n    let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    super(props);\n    this.onBeforeRender = null;\n    this.AfterRender = null;\n\n    if (gl instanceof Model) {\n      this.model = gl;\n\n      this._setModelNodeProps(props);\n    } else {\n      this.model = new Model(gl, props);\n    }\n\n    this.managedResources = props.managedResources || [];\n  }\n\n  setProps(props) {\n    super.setProps(props);\n\n    this._setModelNodeProps(props);\n\n    return this;\n  }\n\n  delete() {\n    if (this.model) {\n      this.model.delete();\n      this.model = null;\n    }\n\n    this.managedResources.forEach(resource => resource.delete());\n    this.managedResources = [];\n  }\n\n  draw() {\n    return this.model.draw(...arguments);\n  }\n\n  setUniforms() {\n    this.model.setUniforms(...arguments);\n    return this;\n  }\n\n  setAttributes() {\n    this.model.setAttributes(...arguments);\n    return this;\n  }\n\n  updateModuleSettings() {\n    this.model.updateModuleSettings(...arguments);\n    return this;\n  }\n\n  _setModelNodeProps(props) {\n    this.model.setProps(props);\n  }\n\n}\n//# sourceMappingURL=model-node.js.map","import { isWebGL2 } from '@luma.gl/gltools';\nimport { log } from '@luma.gl/webgl';\nimport { pbr } from '@luma.gl/shadertools';\nimport ModelNode from '../scenegraph/model-node';\nimport GLTFMaterialParser from './gltf-material-parser';\nconst vs = \"\\n#if (__VERSION__ < 300)\\n  #define _attr attribute\\n#else\\n  #define _attr in\\n#endif\\n\\n  _attr vec4 POSITION;\\n\\n  #ifdef HAS_NORMALS\\n    _attr vec4 NORMAL;\\n  #endif\\n\\n  #ifdef HAS_TANGENTS\\n    _attr vec4 TANGENT;\\n  #endif\\n\\n  #ifdef HAS_UV\\n    _attr vec2 TEXCOORD_0;\\n  #endif\\n\\n  void main(void) {\\n    vec4 _NORMAL = vec4(0.);\\n    vec4 _TANGENT = vec4(0.);\\n    vec2 _TEXCOORD_0 = vec2(0.);\\n\\n    #ifdef HAS_NORMALS\\n      _NORMAL = NORMAL;\\n    #endif\\n\\n    #ifdef HAS_TANGENTS\\n      _TANGENT = TANGENT;\\n    #endif\\n\\n    #ifdef HAS_UV\\n      _TEXCOORD_0 = TEXCOORD_0;\\n    #endif\\n\\n    pbr_setPositionNormalTangentUV(POSITION, _NORMAL, _TANGENT, _TEXCOORD_0);\\n    gl_Position = u_MVPMatrix * POSITION;\\n  }\\n\";\nconst fs = \"\\n#if (__VERSION__ < 300)\\n  #define fragmentColor gl_FragColor\\n#else\\n  out vec4 fragmentColor;\\n#endif\\n\\n  void main(void) {\\n    fragmentColor = pbr_filterColor(vec4(0));\\n  }\\n\";\n\nfunction addVersionToShader(gl, source) {\n  if (isWebGL2(gl)) {\n    return \"#version 300 es\\n\".concat(source);\n  }\n\n  return source;\n}\n\nexport default function createGLTFModel(gl, options) {\n  const {\n    id,\n    drawMode,\n    vertexCount,\n    attributes,\n    modelOptions\n  } = options;\n  const materialParser = new GLTFMaterialParser(gl, options);\n  log.info(4, 'createGLTFModel defines: ', materialParser.defines)();\n  const managedResources = [];\n  managedResources.push(...materialParser.generatedTextures);\n  managedResources.push(...Object.values(attributes).map(attribute => attribute.buffer));\n  const model = new ModelNode(gl, Object.assign({\n    id,\n    drawMode,\n    vertexCount,\n    modules: [pbr],\n    defines: materialParser.defines,\n    parameters: materialParser.parameters,\n    vs: addVersionToShader(gl, vs),\n    fs: addVersionToShader(gl, fs),\n    managedResources\n  }, modelOptions));\n  model.setProps({\n    attributes\n  });\n  model.setUniforms(materialParser.uniforms);\n  return model;\n}\n//# sourceMappingURL=create-gltf-model.js.map","import { Matrix4 } from '@math.gl/core';\nimport { Buffer, Accessor, log } from '@luma.gl/webgl';\nimport GroupNode from '../scenegraph/group-node';\nimport GLTFAnimator from './gltf-animator';\nimport createGLTFModel from './create-gltf-model';\nconst ATTRIBUTE_TYPE_TO_COMPONENTS = {\n  SCALAR: 1,\n  VEC2: 2,\n  VEC3: 3,\n  VEC4: 4,\n  MAT2: 4,\n  MAT3: 9,\n  MAT4: 16\n};\nconst DEFAULT_OPTIONS = {\n  modelOptions: {},\n  pbrDebug: false,\n  imageBasedLightingEnvironment: null,\n  lights: true,\n  useTangents: false\n};\nexport default class GLTFInstantiator {\n  constructor(gl) {\n    let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    this.gl = gl;\n    this.options = Object.assign({}, DEFAULT_OPTIONS, options);\n  }\n\n  instantiate(gltf) {\n    this.gltf = gltf;\n    const scenes = (gltf.scenes || []).map(scene => this.createScene(scene));\n    return scenes;\n  }\n\n  createAnimator() {\n    if (Array.isArray(this.gltf.animations)) {\n      return new GLTFAnimator(this.gltf);\n    }\n\n    return null;\n  }\n\n  createScene(gltfScene) {\n    const gltfNodes = gltfScene.nodes || [];\n    const nodes = gltfNodes.map(node => this.createNode(node));\n    const scene = new GroupNode({\n      id: gltfScene.name || gltfScene.id,\n      children: nodes\n    });\n    return scene;\n  }\n\n  createNode(gltfNode) {\n    if (!gltfNode._node) {\n      const gltfChildren = gltfNode.children || [];\n      const children = gltfChildren.map(child => this.createNode(child));\n\n      if (gltfNode.mesh) {\n        children.push(this.createMesh(gltfNode.mesh));\n      }\n\n      const node = new GroupNode({\n        id: gltfNode.name || gltfNode.id,\n        children\n      });\n\n      if (gltfNode.matrix) {\n        node.setMatrix(gltfNode.matrix);\n      } else {\n        node.matrix.identity();\n\n        if (gltfNode.translation) {\n          node.matrix.translate(gltfNode.translation);\n        }\n\n        if (gltfNode.rotation) {\n          const rotationMatrix = new Matrix4().fromQuaternion(gltfNode.rotation);\n          node.matrix.multiplyRight(rotationMatrix);\n        }\n\n        if (gltfNode.scale) {\n          node.matrix.scale(gltfNode.scale);\n        }\n      }\n\n      gltfNode._node = node;\n    }\n\n    return gltfNode._node;\n  }\n\n  createMesh(gltfMesh) {\n    if (!gltfMesh._mesh) {\n      const gltfPrimitives = gltfMesh.primitives || [];\n      const primitives = gltfPrimitives.map((gltfPrimitive, i) => this.createPrimitive(gltfPrimitive, i, gltfMesh));\n      const mesh = new GroupNode({\n        id: gltfMesh.name || gltfMesh.id,\n        children: primitives\n      });\n      gltfMesh._mesh = mesh;\n    }\n\n    return gltfMesh._mesh;\n  }\n\n  getVertexCount(attributes) {\n    log.warn('getVertexCount() not found')();\n  }\n\n  createPrimitive(gltfPrimitive, i, gltfMesh) {\n    return createGLTFModel(this.gl, Object.assign({\n      id: gltfPrimitive.name || \"\".concat(gltfMesh.name || gltfMesh.id, \"-primitive-\").concat(i),\n      drawMode: gltfPrimitive.mode || 4,\n      vertexCount: gltfPrimitive.indices ? gltfPrimitive.indices.count : this.getVertexCount(gltfPrimitive.attributes),\n      attributes: this.createAttributes(gltfPrimitive.attributes, gltfPrimitive.indices),\n      material: gltfPrimitive.material\n    }, this.options));\n  }\n\n  createAttributes(attributes, indices) {\n    const loadedAttributes = {};\n    Object.keys(attributes).forEach(attrName => {\n      loadedAttributes[attrName] = this.createAccessor(attributes[attrName], this.createBuffer(attributes[attrName], this.gl.ARRAY_BUFFER));\n    });\n\n    if (indices) {\n      loadedAttributes.indices = this.createAccessor(indices, this.createBuffer(indices, this.gl.ELEMENT_ARRAY_BUFFER));\n    }\n\n    log.info(4, 'glTF Attributes', {\n      attributes,\n      indices,\n      generated: loadedAttributes\n    })();\n    return loadedAttributes;\n  }\n\n  createBuffer(attribute, target) {\n    if (!attribute.bufferView) {\n      attribute.bufferView = {};\n    }\n\n    const {\n      bufferView\n    } = attribute;\n\n    if (!bufferView.lumaBuffers) {\n      bufferView.lumaBuffers = {};\n    }\n\n    if (!bufferView.lumaBuffers[target]) {\n      bufferView.lumaBuffers[target] = new Buffer(this.gl, {\n        id: \"from-\".concat(bufferView.id),\n        data: bufferView.data || attribute.value,\n        target\n      });\n    }\n\n    return bufferView.lumaBuffers[target];\n  }\n\n  createAccessor(accessor, buffer) {\n    return new Accessor({\n      buffer,\n      offset: accessor.byteOffset || 0,\n      stride: accessor.bufferView.byteStride || 0,\n      type: accessor.componentType,\n      size: ATTRIBUTE_TYPE_TO_COMPONENTS[accessor.type]\n    });\n  }\n\n  createSampler(gltfSampler) {\n    return gltfSampler;\n  }\n\n  needsPOT() {\n    return false;\n  }\n\n}\n//# sourceMappingURL=gltf-instantiator.js.map","/* global requestAnimationFrame */\nimport type {GroupNode, ModelNode} from '@luma.gl/experimental';\n\nexport async function waitForGLTFAssets(gltfObjects: {scenes: GroupNode[]}): Promise<void> {\n  const remaining: any[] = [];\n\n  gltfObjects.scenes.forEach(scene => {\n    scene.traverse((model: ModelNode) => {\n      Object.values(model.model.getUniforms()).forEach((uniform: any) => {\n        if (uniform.loaded === false) {\n          remaining.push(uniform);\n        }\n      });\n    });\n  });\n\n  return await waitWhileCondition(() => remaining.some(uniform => !uniform.loaded));\n}\n\nasync function waitWhileCondition(condition: () => boolean): Promise<void> {\n  while (condition()) {\n    await new Promise(resolve => requestAnimationFrame(resolve));\n  }\n}\n","// Copyright (c) 2019 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {Layer, project32, picking, log} from '@deck.gl/core';\nimport {isWebGL2} from '@luma.gl/core';\nimport {pbr} from '@luma.gl/shadertools';\nimport {\n  ScenegraphNode,\n  GroupNode,\n  GLTFAnimator,\n  GLTFEnvironment,\n  createGLTFObjects\n} from '@luma.gl/experimental';\nimport GL from '@luma.gl/constants';\nimport {GLTFLoader} from '@loaders.gl/gltf';\nimport {waitForGLTFAssets} from './gltf-utils';\n\nimport {MATRIX_ATTRIBUTES, shouldComposeModelMatrix} from '../utils/matrix';\n\nimport vs from './scenegraph-layer-vertex.glsl';\nimport fs from './scenegraph-layer-fragment.glsl';\n\nimport type {\n  UpdateParameters,\n  LayerContext,\n  LayerProps,\n  Position,\n  Color,\n  Accessor,\n  DefaultProps\n} from '@deck.gl/core';\n\nconst DEFAULT_COLOR: [number, number, number, number] = [255, 255, 255, 255];\n\nexport type ScenegraphLayerProps<DataT = any> = _ScenegraphLayerProps<DataT> & LayerProps<DataT>;\n\ntype _ScenegraphLayerProps<DataT> = {\n  // TODO - define in luma.gl\n  /**\n   * A url for a glTF model or scenegraph loaded via a [scenegraph loader](https://loaders.gl/docs/specifications/category-scenegraph)\n   */\n  scenegraph: any;\n  /**\n   * Create a luma.gl GroupNode from the resolved scenegraph prop\n   */\n  getScene?: (\n    scenegraph: any,\n    context: {gl: WebGLRenderingContext; layer: ScenegraphLayer<DataT>}\n  ) => GroupNode;\n  /**\n   * Create a luma.gl GLTFAnimator from the resolved scenegraph prop\n   */\n  getAnimator?: (\n    scenegraph: any,\n    context: {gl: WebGLRenderingContext; layer: ScenegraphLayer<DataT>}\n  ) => GLTFAnimator;\n  /**\n   * (Experimental) animation configurations. Requires `_animate` on deck object.\n   */\n  _animations?: {\n    [name: number | string | '*']: {\n      /** If the animation is playing */\n      playing?: boolean;\n      /** Start time of the animation, default `0` */\n      startTime?: number;\n      /** Speed multiplier of the animation, default `1` */\n      speed?: number;\n    };\n  } | null;\n  /**\n   * (Experimental) lighting mode\n   * @default 'flat'\n   */\n  _lighting?: 'flat' | 'pbr';\n  /**\n   * (Experimental) lighting environment. Requires `_lighting` to be `'pbr'`.\n   */\n  _imageBasedLightingEnvironment?:\n    | null\n    | GLTFEnvironment\n    | ((context: {gl: WebGLRenderingContext; layer: ScenegraphLayer<DataT>}) => GLTFEnvironment);\n\n  /** Anchor position accessor. */\n  getPosition?: Accessor<DataT, Position>;\n  /** Color value or accessor.\n   * @default [255, 255, 255, 255]\n   */\n  getColor?: Accessor<DataT, Color>;\n  /**\n   * Orientation in [pitch, yaw, roll] in degrees.\n   * @see https://en.wikipedia.org/wiki/Euler_angles\n   * @default [0, 0, 0]\n   */\n  getOrientation?: Accessor<DataT, [number, number, number]>;\n  /**\n   * Scaling factor of the model along each axis.\n   * @default [1, 1, 1]\n   */\n  getScale?: Accessor<DataT, [number, number, number]>;\n  /**\n   * Translation from the anchor point, [x, y, z] in meters.\n   * @default [0, 0, 0]\n   */\n  getTranslation?: Accessor<DataT, [number, number, number]>;\n  /**\n   * TransformMatrix. If specified, `getOrientation`, `getScale` and `getTranslation` are ignored.\n   */\n  getTransformMatrix?: Accessor<DataT, number[]>;\n  /**\n   * Multiplier to scale each geometry by.\n   * @default 1\n   */\n  sizeScale?: number;\n  /**\n   * The minimum size in pixels for one unit of the scene.\n   * @default 0\n   */\n  sizeMinPixels?: number;\n  /**\n   * The maximum size in pixels for one unit of the scene.\n   * @default Number.MAX_SAFE_INTEGER\n   */\n  sizeMaxPixels?: number;\n};\n\nconst defaultProps: DefaultProps<ScenegraphLayerProps> = {\n  scenegraph: {type: 'object', value: null, async: true},\n  getScene: gltf => {\n    if (gltf && gltf.scenes) {\n      // gltf post processor replaces `gltf.scene` number with the scene `object`\n      return typeof gltf.scene === 'object' ? gltf.scene : gltf.scenes[gltf.scene || 0];\n    }\n    return gltf;\n  },\n  getAnimator: scenegraph => scenegraph && scenegraph.animator,\n  _animations: null,\n\n  sizeScale: {type: 'number', value: 1, min: 0},\n  sizeMinPixels: {type: 'number', min: 0, value: 0},\n  sizeMaxPixels: {type: 'number', min: 0, value: Number.MAX_SAFE_INTEGER},\n\n  getPosition: {type: 'accessor', value: x => x.position},\n  getColor: {type: 'accessor', value: DEFAULT_COLOR},\n\n  // flat or pbr\n  _lighting: 'flat',\n  // _lighting must be pbr for this to work\n  _imageBasedLightingEnvironment: null,\n\n  // yaw, pitch and roll are in degrees\n  // https://en.wikipedia.org/wiki/Euler_angles\n  // [pitch, yaw, roll]\n  getOrientation: {type: 'accessor', value: [0, 0, 0]},\n  getScale: {type: 'accessor', value: [1, 1, 1]},\n  getTranslation: {type: 'accessor', value: [0, 0, 0]},\n  // 4x4 matrix\n  getTransformMatrix: {type: 'accessor', value: []},\n\n  loaders: [GLTFLoader]\n};\n\n/** Render a number of instances of a complete glTF scenegraph. */\nexport default class ScenegraphLayer<DataT = any, ExtraPropsT = {}> extends Layer<\n  ExtraPropsT & Required<_ScenegraphLayerProps<DataT>>\n> {\n  static defaultProps = defaultProps;\n  static layerName = 'ScenegraphLayer';\n\n  state!: {\n    scenegraph: GroupNode;\n    animator: GLTFAnimator;\n    attributesAvailable?: boolean;\n  };\n\n  getShaders() {\n    const modules = [project32, picking];\n\n    if (this.props._lighting === 'pbr') {\n      modules.push(pbr);\n    }\n\n    return {vs, fs, modules};\n  }\n\n  initializeState() {\n    const attributeManager = this.getAttributeManager();\n    // attributeManager is always defined for primitive layers\n    attributeManager!.addInstanced({\n      instancePositions: {\n        size: 3,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        accessor: 'getPosition',\n        transition: true\n      },\n      instanceColors: {\n        type: GL.UNSIGNED_BYTE,\n        size: this.props.colorFormat.length,\n        accessor: 'getColor',\n        normalized: true,\n        defaultValue: DEFAULT_COLOR,\n        transition: true\n      },\n      instanceModelMatrix: MATRIX_ATTRIBUTES\n    });\n  }\n\n  updateState(params: UpdateParameters<this>) {\n    super.updateState(params);\n    const {props, oldProps} = params;\n\n    if (props.scenegraph !== oldProps.scenegraph) {\n      this._updateScenegraph();\n    } else if (props._animations !== oldProps._animations) {\n      this._applyAnimationsProp(this.state.scenegraph, this.state.animator, props._animations);\n    }\n  }\n\n  finalizeState(context: LayerContext) {\n    super.finalizeState(context);\n    this._deleteScenegraph();\n  }\n\n  private _updateScenegraph(): void {\n    const props = this.props;\n    const {gl} = this.context;\n    let scenegraphData: any = null;\n    if (props.scenegraph instanceof ScenegraphNode) {\n      // Signature 1: props.scenegraph is a proper luma.gl Scenegraph\n      scenegraphData = {scenes: [props.scenegraph]};\n    } else if (props.scenegraph && !props.scenegraph.gltf) {\n      // Converts loaders.gl gltf to luma.gl scenegraph using the undocumented @luma.gl/experimental function\n      const gltf = props.scenegraph;\n      const gltfObjects = createGLTFObjects(gl, gltf, this._getModelOptions());\n      scenegraphData = {gltf, ...gltfObjects};\n\n      waitForGLTFAssets(gltfObjects).then(() => this.setNeedsRedraw()); // eslint-disable-line @typescript-eslint/no-floating-promises\n    } else if (props.scenegraph) {\n      // DEPRECATED PATH: Assumes this data was loaded through GLTFScenegraphLoader\n      log.deprecated(\n        'ScenegraphLayer.props.scenegraph',\n        'Use GLTFLoader instead of GLTFScenegraphLoader'\n      )();\n      scenegraphData = props.scenegraph;\n    }\n\n    const options = {layer: this, gl};\n    const scenegraph = props.getScene(scenegraphData, options);\n    const animator = props.getAnimator(scenegraphData, options);\n\n    if (scenegraph instanceof ScenegraphNode) {\n      this._deleteScenegraph();\n      this._applyAllAttributes(scenegraph);\n      this._applyAnimationsProp(scenegraph, animator, props._animations);\n      this.setState({scenegraph, animator});\n    } else if (scenegraph !== null) {\n      log.warn('invalid scenegraph:', scenegraph)();\n    }\n  }\n\n  private _applyAllAttributes(scenegraph: GroupNode): void {\n    if (this.state.attributesAvailable) {\n      // attributeManager is always defined for primitive layers\n      const allAttributes = this.getAttributeManager()!.getAttributes();\n      scenegraph.traverse(model => {\n        this._setModelAttributes(model.model, allAttributes);\n      });\n    }\n  }\n\n  private _applyAnimationsProp(\n    scenegraph: GroupNode,\n    animator: GLTFAnimator,\n    animationsProp: any\n  ): void {\n    if (!scenegraph || !animator || !animationsProp) {\n      return;\n    }\n\n    const animations = animator.getAnimations();\n\n    // sort() to ensure '*' comes first so that other values can override\n    Object.keys(animationsProp)\n      .sort()\n      .forEach(key => {\n        // Key can be:\n        //  - number for index number\n        //  - name for animation name\n        //  - * to affect all animations\n        const value = animationsProp[key];\n\n        if (key === '*') {\n          animations.forEach(animation => {\n            Object.assign(animation, value);\n          });\n        } else if (Number.isFinite(Number(key))) {\n          const number = Number(key);\n          if (number >= 0 && number < animations.length) {\n            Object.assign(animations[number], value);\n          } else {\n            log.warn(`animation ${key} not found`)();\n          }\n        } else {\n          const findResult = animations.find(({name}) => name === key);\n          if (findResult) {\n            Object.assign(findResult, value);\n          } else {\n            log.warn(`animation ${key} not found`)();\n          }\n        }\n      });\n  }\n\n  private _deleteScenegraph(): void {\n    const {scenegraph} = this.state;\n    if (scenegraph instanceof ScenegraphNode) {\n      scenegraph.delete();\n    }\n  }\n\n  private _getModelOptions(): any {\n    const {_imageBasedLightingEnvironment} = this.props;\n\n    let env: GLTFEnvironment | null = null;\n    if (_imageBasedLightingEnvironment) {\n      if (typeof _imageBasedLightingEnvironment === 'function') {\n        env = _imageBasedLightingEnvironment({gl: this.context.gl, layer: this});\n      } else {\n        env = _imageBasedLightingEnvironment;\n      }\n    }\n\n    return {\n      gl: this.context.gl,\n      waitForFullLoad: true,\n      imageBasedLightingEnvironment: env,\n      modelOptions: {\n        isInstanced: true,\n        transpileToGLSL100: !isWebGL2(this.context.gl),\n        ...this.getShaders()\n      },\n      // tangents are not supported\n      useTangents: false\n    };\n  }\n\n  updateAttributes(changedAttributes) {\n    this.setState({attributesAvailable: true});\n    if (!this.state.scenegraph) return;\n\n    this.state.scenegraph.traverse(model => {\n      this._setModelAttributes(model.model, changedAttributes);\n    });\n  }\n\n  draw({moduleParameters = null, parameters = {}, context}) {\n    if (!this.state.scenegraph) return;\n\n    if (this.props._animations && this.state.animator) {\n      this.state.animator.animate(context.timeline.getTime());\n      this.setNeedsRedraw();\n    }\n\n    const {viewport} = this.context;\n    const {sizeScale, sizeMinPixels, sizeMaxPixels, opacity, coordinateSystem} = this.props;\n    const numInstances = this.getNumInstances();\n    this.state.scenegraph.traverse((model, {worldMatrix}) => {\n      model.model.setInstanceCount(numInstances);\n      model.updateModuleSettings(moduleParameters);\n      model.draw({\n        parameters,\n        uniforms: {\n          sizeScale,\n          opacity,\n          sizeMinPixels,\n          sizeMaxPixels,\n          composeModelMatrix: shouldComposeModelMatrix(viewport, coordinateSystem),\n          sceneModelMatrix: worldMatrix,\n          // Needed for PBR (TODO: find better way to get it)\n          // eslint-disable-next-line camelcase\n          u_Camera: model.model.getUniforms().project_uCameraPosition\n        }\n      });\n    });\n  }\n}\n","export default `\\\n#version 300 es\n\n// Instance attributes\nin vec3 instancePositions;\nin vec3 instancePositions64Low;\nin vec4 instanceColors;\nin vec3 instancePickingColors;\nin mat3 instanceModelMatrix;\nin vec3 instanceTranslation;\n\n// Uniforms\nuniform float sizeScale;\nuniform float sizeMinPixels;\nuniform float sizeMaxPixels;\nuniform mat4 sceneModelMatrix;\nuniform bool composeModelMatrix;\n\n// Attributes\nin vec4 POSITION;\n\n#ifdef HAS_UV\n  in vec2 TEXCOORD_0;\n#endif\n\n#ifdef MODULE_PBR\n  #ifdef HAS_NORMALS\n    in vec4 NORMAL;\n  #endif\n#endif\n\n// Varying\nout vec4 vColor;\n\n// MODULE_PBR contains all the varying definitions needed\n#ifndef MODULE_PBR\n  #ifdef HAS_UV\n    out vec2 vTEXCOORD_0;\n  #endif\n#endif\n\n// Main\nvoid main(void) {\n  #if defined(HAS_UV) && !defined(MODULE_PBR)\n    vTEXCOORD_0 = TEXCOORD_0;\n    geometry.uv = vTEXCOORD_0;\n  #endif\n\n  geometry.worldPosition = instancePositions;\n  geometry.pickingColor = instancePickingColors;\n\n  vec3 normal = vec3(0.0, 0.0, 1.0);\n  #ifdef MODULE_PBR\n    #ifdef HAS_NORMALS\n      normal = instanceModelMatrix * (sceneModelMatrix * vec4(NORMAL.xyz, 0.0)).xyz;\n    #endif\n  #endif\n\n  float originalSize = project_size_to_pixel(sizeScale);\n  float clampedSize = clamp(originalSize, sizeMinPixels, sizeMaxPixels);\n\n  vec3 pos = (instanceModelMatrix * (sceneModelMatrix * POSITION).xyz) * sizeScale * (clampedSize / originalSize) + instanceTranslation;\n  if(composeModelMatrix) {\n    DECKGL_FILTER_SIZE(pos, geometry);\n    // using instancePositions as world coordinates\n    // when using globe mode, this branch does not re-orient the model to align with the surface of the earth\n    // call project_normal before setting position to avoid rotation\n    geometry.normal = project_normal(normal);\n    gl_Position = project_position_to_clipspace(pos + instancePositions, instancePositions64Low, vec3(0.0), geometry.position);\n  }\n  else {\n    pos = project_size(pos);\n    DECKGL_FILTER_SIZE(pos, geometry);\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, pos, geometry.position);\n    geometry.normal = project_normal(normal);\n  }\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  #ifdef MODULE_PBR\n    // set PBR data\n    pbr_vPosition = geometry.position.xyz;\n    #ifdef HAS_NORMALS\n      pbr_vNormal = geometry.normal;\n    #endif\n\n    #ifdef HAS_UV\n      pbr_vUV = TEXCOORD_0;\n    #else\n      pbr_vUV = vec2(0., 0.);\n    #endif\n    geometry.uv = pbr_vUV;\n  #endif\n\n  vColor = instanceColors;\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n`;\n","export default `\\\n#version 300 es\n\n// Uniforms\nuniform float opacity;\n\n// Varying\nin vec4 vColor;\n\nout vec4 fragmentColor;\n\n// MODULE_PBR contains all the varying definitions needed\n#ifndef MODULE_PBR\n  #if defined(HAS_UV) && defined(HAS_BASECOLORMAP)\n    in vec2 vTEXCOORD_0;\n    uniform sampler2D u_BaseColorSampler;\n  #endif\n#endif\n\nvoid main(void) {\n  #ifdef MODULE_PBR\n    fragmentColor = vColor * pbr_filterColor(vec4(0));\n    geometry.uv = pbr_vUV;\n  #else\n    #if defined(HAS_UV) && defined(HAS_BASECOLORMAP)\n      fragmentColor = vColor * texture2D(u_BaseColorSampler, vTEXCOORD_0);\n      geometry.uv = vTEXCOORD_0;\n    #else\n      fragmentColor = vColor;\n    #endif\n  #endif\n\n  fragmentColor.a *= opacity;\n  DECKGL_FILTER_COLOR(fragmentColor, geometry);\n}\n`;\n","import GLTFInstantiator from './gltf-instantiator';\nexport default function createGLTFObjects(gl, gltf, options) {\n  const instantiator = new GLTFInstantiator(gl, options);\n  const scenes = instantiator.instantiate(gltf);\n  const animator = instantiator.createAnimator();\n  return {\n    scenes,\n    animator\n  };\n}\n//# sourceMappingURL=create-gltf-objects.js.map","// This module implement some utility functions to work with\n// the geojson-binary format defined at loaders.gl:\n// https://github.com/visgl/loaders.gl/blob/master/modules/gis/docs/api-reference/geojson-to-binary.md\n\nimport {\n  BinaryFeatures,\n  BinaryLineFeatures,\n  BinaryPointFeatures,\n  BinaryPolygonFeatures,\n  Feature\n} from '@loaders.gl/schema';\n\nexport type BinaryFeatureTypes = BinaryPointFeatures | BinaryLineFeatures | BinaryPolygonFeatures;\n\ntype FeaureOnlyProperties = Pick<Feature, 'properties'>;\n\n/**\n * Return the feature for an accesor\n */\nexport function binaryToFeatureForAccesor(\n  data: BinaryFeatureTypes,\n  index: number\n): FeaureOnlyProperties | null {\n  if (!data) {\n    return null;\n  }\n\n  const featureIndex = 'startIndices' in data ? (data as any).startIndices[index] : index;\n  const geometryIndex = data.featureIds.value[featureIndex];\n\n  if (featureIndex !== -1) {\n    return getPropertiesForIndex(data, geometryIndex, featureIndex);\n  }\n\n  return null;\n}\n\nfunction getPropertiesForIndex(\n  data: BinaryFeatureTypes,\n  propertiesIndex: number,\n  numericPropsIndex: number\n): FeaureOnlyProperties {\n  const feature = {\n    properties: {...data.properties[propertiesIndex]}\n  };\n\n  for (const prop in data.numericProps) {\n    feature.properties[prop] = data.numericProps[prop].value[numericPropsIndex];\n  }\n\n  return feature;\n}\n\n// Custom picking color to keep binary indexes\nexport function calculatePickingColors(\n  geojsonBinary: BinaryFeatures,\n  encodePickingColor: (id: number, result: number[]) => void\n): Record<string, Uint8ClampedArray | null> {\n  const pickingColors: Record<string, Uint8ClampedArray | null> = {\n    points: null,\n    lines: null,\n    polygons: null\n  };\n  for (const key in pickingColors) {\n    const featureIds = geojsonBinary[key].globalFeatureIds.value;\n    pickingColors[key] = new Uint8ClampedArray(featureIds.length * 3);\n    const pickingColor = [];\n    for (let i = 0; i < featureIds.length; i++) {\n      encodePickingColor(featureIds[i], pickingColor);\n      pickingColors[key]![i * 3 + 0] = pickingColor[0];\n      pickingColors[key]![i * 3 + 1] = pickingColor[1];\n      pickingColors[key]![i * 3 + 2] = pickingColor[2];\n    }\n  }\n\n  return pickingColors;\n}\n","import {CompositeLayer, Layer} from '@deck.gl/core';\n\nimport IconLayer from '../icon-layer/icon-layer';\nimport ScatterplotLayer from '../scatterplot-layer/scatterplot-layer';\nimport TextLayer from '../text-layer/text-layer';\nimport PathLayer from '../path-layer/path-layer';\nimport SolidPolygonLayer from '../solid-polygon-layer/solid-polygon-layer';\n\nexport const POINT_LAYER = {\n  circle: {\n    type: ScatterplotLayer,\n    props: {\n      filled: 'filled',\n      stroked: 'stroked',\n\n      lineWidthMaxPixels: 'lineWidthMaxPixels',\n      lineWidthMinPixels: 'lineWidthMinPixels',\n      lineWidthScale: 'lineWidthScale',\n      lineWidthUnits: 'lineWidthUnits',\n      pointRadiusMaxPixels: 'radiusMaxPixels',\n      pointRadiusMinPixels: 'radiusMinPixels',\n      pointRadiusScale: 'radiusScale',\n      pointRadiusUnits: 'radiusUnits',\n      pointAntialiasing: 'antialiasing',\n      pointBillboard: 'billboard',\n\n      getFillColor: 'getFillColor',\n      getLineColor: 'getLineColor',\n      getLineWidth: 'getLineWidth',\n      getPointRadius: 'getRadius'\n    }\n  },\n  icon: {\n    type: IconLayer,\n    props: {\n      iconAtlas: 'iconAtlas',\n      iconMapping: 'iconMapping',\n\n      iconSizeMaxPixels: 'sizeMaxPixels',\n      iconSizeMinPixels: 'sizeMinPixels',\n      iconSizeScale: 'sizeScale',\n      iconSizeUnits: 'sizeUnits',\n      iconAlphaCutoff: 'alphaCutoff',\n      iconBillboard: 'billboard',\n\n      getIcon: 'getIcon',\n      getIconAngle: 'getAngle',\n      getIconColor: 'getColor',\n      getIconPixelOffset: 'getPixelOffset',\n      getIconSize: 'getSize'\n    }\n  },\n  text: {\n    type: TextLayer,\n    props: {\n      textSizeMaxPixels: 'sizeMaxPixels',\n      textSizeMinPixels: 'sizeMinPixels',\n      textSizeScale: 'sizeScale',\n      textSizeUnits: 'sizeUnits',\n\n      textBackground: 'background',\n      textBackgroundPadding: 'backgroundPadding',\n      textFontFamily: 'fontFamily',\n      textFontWeight: 'fontWeight',\n      textLineHeight: 'lineHeight',\n      textMaxWidth: 'maxWidth',\n      textOutlineColor: 'outlineColor',\n      textOutlineWidth: 'outlineWidth',\n      textWordBreak: 'wordBreak',\n      textCharacterSet: 'characterSet',\n      textBillboard: 'billboard',\n      textFontSettings: 'fontSettings',\n\n      getText: 'getText',\n      getTextAngle: 'getAngle',\n      getTextColor: 'getColor',\n      getTextPixelOffset: 'getPixelOffset',\n      getTextSize: 'getSize',\n      getTextAnchor: 'getTextAnchor',\n      getTextAlignmentBaseline: 'getAlignmentBaseline',\n      getTextBackgroundColor: 'getBackgroundColor',\n      getTextBorderColor: 'getBorderColor',\n      getTextBorderWidth: 'getBorderWidth'\n    }\n  }\n};\n\nexport const LINE_LAYER = {\n  type: PathLayer,\n  props: {\n    lineWidthUnits: 'widthUnits',\n    lineWidthScale: 'widthScale',\n    lineWidthMinPixels: 'widthMinPixels',\n    lineWidthMaxPixels: 'widthMaxPixels',\n    lineJointRounded: 'jointRounded',\n    lineCapRounded: 'capRounded',\n    lineMiterLimit: 'miterLimit',\n    lineBillboard: 'billboard',\n\n    getLineColor: 'getColor',\n    getLineWidth: 'getWidth'\n  }\n};\n\nexport const POLYGON_LAYER = {\n  type: SolidPolygonLayer,\n  props: {\n    extruded: 'extruded',\n    filled: 'filled',\n    wireframe: 'wireframe',\n    elevationScale: 'elevationScale',\n    material: 'material',\n    _full3d: '_full3d',\n\n    getElevation: 'getElevation',\n    getFillColor: 'getFillColor',\n    getLineColor: 'getLineColor'\n  }\n};\n\nexport function getDefaultProps({\n  type,\n  props\n}: {\n  type: typeof Layer;\n  props: Record<string, string>;\n}): Record<string, any> {\n  const result = {};\n  for (const key in props) {\n    result[key] = type.defaultProps[props[key]];\n  }\n  return result;\n}\n\nexport function forwardProps(\n  layer: CompositeLayer,\n  mapping: Record<string, string>\n): Record<string, any> {\n  const {transitions, updateTriggers} = layer.props;\n  const result: Record<string, any> = {\n    updateTriggers: {},\n    transitions: transitions && {\n      getPosition: transitions.geometry\n    }\n  };\n\n  for (const sourceKey in mapping) {\n    const targetKey = mapping[sourceKey];\n    let value = layer.props[sourceKey];\n    if (sourceKey.startsWith('get')) {\n      // isAccessor\n      value = (layer as any).getSubLayerAccessor(value);\n      result.updateTriggers[targetKey] = updateTriggers[sourceKey];\n      if (transitions) {\n        result.transitions[targetKey] = transitions[sourceKey];\n      }\n    }\n    result[targetKey] = value;\n  }\n  return result;\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\nimport {log} from '@deck.gl/core';\nimport type {\n  Feature,\n  GeoJSON,\n  GeoJsonGeometryTypes,\n  LineString,\n  MultiLineString,\n  MultiPoint,\n  MultiPolygon,\n  Point,\n  Polygon\n} from 'geojson';\n\ntype SupportedGeometry = Point | MultiPoint | LineString | MultiLineString | Polygon | MultiPolygon;\n\nexport type SeparatedGeometries = {\n  pointFeatures: {geometry: Point}[];\n  lineFeatures: {geometry: LineString}[];\n  polygonFeatures: {geometry: Polygon}[];\n  polygonOutlineFeatures: {geometry: LineString}[];\n};\n\n/**\n * \"Normalizes\" complete or partial GeoJSON data into iterable list of features\n * Can accept GeoJSON geometry or \"Feature\", \"FeatureCollection\" in addition\n * to plain arrays and iterables.\n * Works by extracting the feature array or wrapping single objects in an array,\n * so that subsequent code can simply iterate over features.\n *\n * @param {object} geojson - geojson data\n * @param {Object|Array} data - geojson object (FeatureCollection, Feature or\n *  Geometry) or array of features\n * @return {Array|\"iteratable\"} - iterable list of features\n */\nexport function getGeojsonFeatures(geojson: GeoJSON): Feature[] {\n  // If array, assume this is a list of features\n  if (Array.isArray(geojson)) {\n    return geojson;\n  }\n\n  log.assert(geojson.type, 'GeoJSON does not have type');\n\n  switch (geojson.type) {\n    case 'Feature':\n      // Wrap the feature in a 'Features' array\n      return [geojson];\n    case 'FeatureCollection':\n      // Just return the 'Features' array from the collection\n      log.assert(Array.isArray(geojson.features), 'GeoJSON does not have features array');\n      return geojson.features;\n    default:\n      // Assume it's a geometry, we'll check type in separateGeojsonFeatures\n      // Wrap the geometry object in a 'Feature' object and wrap in an array\n      return [{geometry: geojson}] as Feature[];\n  }\n}\n\n// Linearize\nexport function separateGeojsonFeatures(\n  features: Feature[],\n  wrapFeature: <T>(row: T, sourceObject: any, sourceObjectIndex: number) => T,\n  dataRange: {startRow?: number; endRow?: number} = {}\n): SeparatedGeometries {\n  const separated: SeparatedGeometries = {\n    pointFeatures: [],\n    lineFeatures: [],\n    polygonFeatures: [],\n    polygonOutlineFeatures: []\n  };\n  const {startRow = 0, endRow = features.length} = dataRange;\n\n  for (let featureIndex = startRow; featureIndex < endRow; featureIndex++) {\n    const feature = features[featureIndex];\n    const {geometry} = feature;\n\n    if (!geometry) {\n      // geometry can be null per specification\n      continue;\n    }\n\n    if (geometry.type === 'GeometryCollection') {\n      log.assert(Array.isArray(geometry.geometries), 'GeoJSON does not have geometries array');\n      const {geometries} = geometry;\n      for (let i = 0; i < geometries.length; i++) {\n        const subGeometry = geometries[i];\n        separateGeometry(\n          subGeometry as SupportedGeometry,\n          separated,\n          wrapFeature,\n          feature,\n          featureIndex\n        );\n      }\n    } else {\n      separateGeometry(geometry, separated, wrapFeature, feature, featureIndex);\n    }\n  }\n\n  return separated;\n}\n\nfunction separateGeometry(\n  geometry: SupportedGeometry,\n  separated: SeparatedGeometries,\n  wrapFeature: <T>(row: T, sourceObject: any, sourceObjectIndex: number) => T,\n  sourceFeature: Feature,\n  sourceFeatureIndex: number\n) {\n  const {type, coordinates} = geometry;\n  const {pointFeatures, lineFeatures, polygonFeatures, polygonOutlineFeatures} = separated;\n\n  if (!validateGeometry(type, coordinates)) {\n    // Avoid hard failure if some features are malformed\n    log.warn(`${type} coordinates are malformed`)();\n    return;\n  }\n\n  // Split each feature, but keep track of the source feature and index (for Multi* geometries)\n  switch (type) {\n    case 'Point':\n      pointFeatures.push(\n        wrapFeature(\n          {\n            geometry\n          },\n          sourceFeature,\n          sourceFeatureIndex\n        )\n      );\n      break;\n    case 'MultiPoint':\n      coordinates.forEach(point => {\n        pointFeatures.push(\n          wrapFeature(\n            {\n              geometry: {type: 'Point', coordinates: point}\n            },\n            sourceFeature,\n            sourceFeatureIndex\n          )\n        );\n      });\n      break;\n    case 'LineString':\n      lineFeatures.push(\n        wrapFeature(\n          {\n            geometry\n          },\n          sourceFeature,\n          sourceFeatureIndex\n        )\n      );\n      break;\n    case 'MultiLineString':\n      // Break multilinestrings into multiple lines\n      coordinates.forEach(path => {\n        lineFeatures.push(\n          wrapFeature(\n            {\n              geometry: {type: 'LineString', coordinates: path}\n            },\n            sourceFeature,\n            sourceFeatureIndex\n          )\n        );\n      });\n      break;\n    case 'Polygon':\n      polygonFeatures.push(\n        wrapFeature(\n          {\n            geometry\n          },\n          sourceFeature,\n          sourceFeatureIndex\n        )\n      );\n      // Break polygon into multiple lines\n      coordinates.forEach(path => {\n        polygonOutlineFeatures.push(\n          wrapFeature(\n            {\n              geometry: {type: 'LineString', coordinates: path}\n            },\n            sourceFeature,\n            sourceFeatureIndex\n          )\n        );\n      });\n      break;\n    case 'MultiPolygon':\n      // Break multipolygons into multiple polygons\n      coordinates.forEach(polygon => {\n        polygonFeatures.push(\n          wrapFeature(\n            {\n              geometry: {type: 'Polygon', coordinates: polygon}\n            },\n            sourceFeature,\n            sourceFeatureIndex\n          )\n        );\n        // Break polygon into multiple lines\n        polygon.forEach(path => {\n          polygonOutlineFeatures.push(\n            wrapFeature(\n              {\n                geometry: {type: 'LineString', coordinates: path}\n              },\n              sourceFeature,\n              sourceFeatureIndex\n            )\n          );\n        });\n      });\n      break;\n    default:\n  }\n}\n\n/**\n * Simple GeoJSON validation util. For perf reasons we do not validate against the full spec,\n * only the following:\n   - geometry.type is supported\n   - geometry.coordinate has correct nesting level\n */\nconst COORDINATE_NEST_LEVEL: Record<SupportedGeometry['type'], number> = {\n  Point: 1,\n  MultiPoint: 2,\n  LineString: 2,\n  MultiLineString: 3,\n  Polygon: 3,\n  MultiPolygon: 4\n};\n\nexport function validateGeometry(type: GeoJsonGeometryTypes, coordinates: any): boolean {\n  let nestLevel = COORDINATE_NEST_LEVEL[type] as number;\n\n  log.assert(nestLevel, `Unknown GeoJSON type ${type}`);\n\n  while (coordinates && --nestLevel > 0) {\n    coordinates = coordinates[0];\n  }\n\n  return coordinates && Number.isFinite(coordinates[0]);\n}\n","import {BinaryAttribute, LayerData, LayerProps} from '@deck.gl/core';\nimport {PolygonLayerProps, ScatterplotLayerProps} from '..';\nimport {calculatePickingColors} from './geojson-binary';\nimport {BinaryFeatures} from '@loaders.gl/schema';\nimport {SeparatedGeometries} from './geojson';\n\n// TODO: PathLayer is not yet typed\ntype PathLayerProps = LayerProps & Record<string, any>;\n\ntype SubLayersProps = {\n  points: Partial<ScatterplotLayerProps>;\n  lines: Partial<PathLayerProps>;\n  polygons: Partial<PolygonLayerProps>;\n  polygonsOutline: Partial<PathLayerProps>;\n};\n\ntype ExtendedBinaryFeatures = {\n  [P in keyof BinaryFeatures]: BinaryFeatures[P] & {attributes?: Record<string, BinaryAttribute>};\n};\n\nfunction createEmptyLayerProps(): SubLayersProps {\n  return {\n    points: {},\n    lines: {},\n    polygons: {},\n    polygonsOutline: {}\n  };\n}\n\nfunction getCoordinates(f) {\n  return f.geometry.coordinates;\n}\n\nexport function createLayerPropsFromFeatures(\n  features: SeparatedGeometries,\n  featuresDiff\n): SubLayersProps {\n  const layerProps = createEmptyLayerProps();\n  const {pointFeatures, lineFeatures, polygonFeatures, polygonOutlineFeatures} = features;\n\n  layerProps.points.data = pointFeatures;\n  layerProps.points._dataDiff = featuresDiff.pointFeatures && (() => featuresDiff.pointFeatures);\n  layerProps.points.getPosition = getCoordinates;\n\n  layerProps.lines.data = lineFeatures;\n  layerProps.lines._dataDiff = featuresDiff.lineFeatures && (() => featuresDiff.lineFeatures);\n  layerProps.lines.getPath = getCoordinates;\n\n  layerProps.polygons.data = polygonFeatures;\n  layerProps.polygons._dataDiff =\n    featuresDiff.polygonFeatures && (() => featuresDiff.polygonFeatures);\n  layerProps.polygons.getPolygon = getCoordinates;\n\n  layerProps.polygonsOutline.data = polygonOutlineFeatures;\n  layerProps.polygonsOutline._dataDiff =\n    featuresDiff.polygonOutlineFeatures && (() => featuresDiff.polygonOutlineFeatures);\n  layerProps.polygonsOutline.getPath = getCoordinates;\n\n  return layerProps;\n}\n\nexport function createLayerPropsFromBinary(\n  geojsonBinary: Required<ExtendedBinaryFeatures>,\n  encodePickingColor\n): SubLayersProps {\n  // The binary data format is documented here\n  // https://github.com/visgl/loaders.gl/blob/master/modules/gis/docs/api-reference/geojson-to-binary.md\n  // It is the default output from the `MVTLoader` and can also be obtained\n  // from GeoJSON by using the `geojsonToBinary` utility function.\n  const layerProps = createEmptyLayerProps();\n  const {points, lines, polygons} = geojsonBinary;\n\n  const customPickingColors = calculatePickingColors(geojsonBinary, encodePickingColor);\n\n  layerProps.points.data = {\n    length: points.positions.value.length / points.positions.size,\n    attributes: {\n      ...points.attributes,\n      getPosition: points.positions,\n      instancePickingColors: {\n        size: 3,\n        value: customPickingColors.points!\n      }\n    },\n    properties: points.properties,\n    numericProps: points.numericProps,\n    featureIds: points.featureIds\n  } as LayerData<any>;\n\n  layerProps.lines.data = {\n    length: lines.pathIndices.value.length - 1,\n    startIndices: lines.pathIndices.value,\n    attributes: {\n      ...lines.attributes,\n      getPath: lines.positions,\n      instancePickingColors: {\n        size: 3,\n        value: customPickingColors.lines!\n      }\n    },\n    properties: lines.properties,\n    numericProps: lines.numericProps,\n    featureIds: lines.featureIds\n  } as LayerData<any>;\n  layerProps.lines._pathType = 'open';\n\n  layerProps.polygons.data = {\n    length: polygons.polygonIndices.value.length - 1,\n    startIndices: polygons.polygonIndices.value,\n    attributes: {\n      ...polygons.attributes,\n      getPolygon: polygons.positions,\n      pickingColors: {\n        size: 3,\n        value: customPickingColors.polygons!\n      }\n    },\n    properties: polygons.properties,\n    numericProps: polygons.numericProps,\n    featureIds: polygons.featureIds\n  } as LayerData<any>;\n  layerProps.polygons._normalize = false;\n  if (polygons.triangles) {\n    (layerProps.polygons.data as any).attributes.indices = polygons.triangles.value;\n  }\n\n  layerProps.polygonsOutline.data = {\n    length: polygons.primitivePolygonIndices.value.length - 1,\n    startIndices: polygons.primitivePolygonIndices.value,\n    attributes: {\n      ...polygons.attributes,\n      getPath: polygons.positions,\n      instancePickingColors: {\n        size: 3,\n        value: customPickingColors.polygons!\n      }\n    },\n    properties: polygons.properties,\n    numericProps: polygons.numericProps,\n    featureIds: polygons.featureIds\n  } as LayerData<any>;\n  layerProps.polygonsOutline._pathType = 'open';\n\n  return layerProps;\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {\n  Accessor,\n  Color,\n  CompositeLayer,\n  CompositeLayerProps,\n  Layer,\n  PickingInfo,\n  Unit,\n  Material,\n  UpdateParameters,\n  _ConstructorOf,\n  DefaultProps\n} from '@deck.gl/core';\n\nimport type {BinaryFeatures} from '@loaders.gl/schema';\nimport type {Feature} from 'geojson';\n\nimport {replaceInRange} from '../utils';\nimport {BinaryFeatureTypes, binaryToFeatureForAccesor} from './geojson-binary';\nimport {\n  POINT_LAYER,\n  LINE_LAYER,\n  POLYGON_LAYER,\n  getDefaultProps,\n  forwardProps\n} from './sub-layer-map';\n\nimport {getGeojsonFeatures, SeparatedGeometries, separateGeojsonFeatures} from './geojson';\nimport {createLayerPropsFromFeatures, createLayerPropsFromBinary} from './geojson-layer-props';\n\n/** All properties supported by GeoJsonLayer */\nexport type GeoJsonLayerProps<DataT extends Feature = Feature> = _GeoJsonLayerProps<DataT> &\n  CompositeLayerProps<DataT>;\n\n/** Properties added by GeoJsonLayer */\nexport type _GeoJsonLayerProps<DataT extends Feature = Feature> = {\n  /**\n   * How to render Point and MultiPoint features in the data.\n   *\n   * Supported types are:\n   *  * `'circle'`\n   *  * `'icon'`\n   *  * `'text'`\n   *\n   * @default 'circle'\n   */\n  pointType?: string;\n} & _GeoJsonLayerFillProps<DataT> &\n  _GeoJsonLayerStrokeProps<DataT> &\n  _GeoJsonLayer3DProps<DataT> &\n  _GeoJsonLayerPointCircleProps<DataT> &\n  _GeojsonLayerIconPointProps<DataT> &\n  _GeojsonLayerTextPointProps<DataT>;\n\n/** GeoJsonLayer fill options. */\ntype _GeoJsonLayerFillProps<DataT> = {\n  /**\n   * Whether to draw a filled polygon (solid fill).\n   *\n   * Note that only the area between the outer polygon and any holes will be filled.\n   *\n   * @default true\n   */\n  filled?: boolean;\n\n  /**\n   * Fill collor value or accessor.\n   *\n   * @default [0, 0, 0, 255]\n   */\n  getFillColor?: Accessor<DataT, Color>;\n};\n\n/** GeoJsonLayer stroke options. */\ntype _GeoJsonLayerStrokeProps<DataT> = {\n  /**\n   * Whether to draw an outline around the polygon (solid fill).\n   *\n   * Note that both the outer polygon as well the outlines of any holes will be drawn.\n   *\n   * @default true\n   */\n  stroked?: boolean;\n\n  /**\n   * Line color value or accessor.\n   *\n   * @default [0, 0, 0, 255]\n   */\n  getLineColor?: Accessor<DataT, Color>;\n\n  /**\n   * Line width value or accessor.\n   *\n   * @default [0, 0, 0, 255]\n   */\n  getLineWidth?: Accessor<DataT, number>;\n\n  /**\n   * The units of the line width, one of `meters`, `common`, and `pixels`.\n   *\n   * @default 'meters'\n   * @see Unit.\n   */\n  lineWidthUnits?: Unit;\n\n  /**\n   * A multiplier that is applied to all line widths\n   *\n   * @default 1\n   */\n  lineWidthScale?: number;\n\n  /**\n   * The minimum line width in pixels.\n   *\n   * @default 0\n   */\n  lineWidthMinPixels?: number;\n\n  /**\n   * The maximum line width in pixels\n   *\n   * @default Number.MAX_SAFE_INTEGER\n   */\n  lineWidthMaxPixels?: number;\n\n  /**\n   * Type of joint. If `true`, draw round joints. Otherwise draw miter joints.\n   *\n   * @default false\n   */\n  lineJointRounded?: boolean;\n\n  /**\n   * The maximum extent of a joint in ratio to the stroke width.\n   *\n   * Only works if `lineJointRounded` is false.\n   *\n   * @default 4\n   */\n  lineMiterLimit?: number;\n\n  /**\n   * Type of line caps.\n   *\n   * If `true`, draw round caps. Otherwise draw square caps.\n   *\n   * @default false\n   */\n  lineCapRounded?: boolean;\n\n  /**\n   * If `true`, extrude the line in screen space (width always faces the camera).\n   * If `false`, the width always faces up.\n   *\n   * @default false\n   */\n  lineBillboard?: boolean;\n};\n\n/** GeoJsonLayer 3D options. */\ntype _GeoJsonLayer3DProps<DataT> = {\n  /**\n   * Extrude Polygon and MultiPolygon features along the z-axis if set to true\n   *\n   * Based on the elevations provided by the `getElevation` accessor.\n   *\n   * @default false\n   */\n  extruded?: boolean;\n\n  /**\n   * Whether to generate a line wireframe of the hexagon.\n   *\n   * @default false\n   */\n  wireframe?: boolean;\n\n  /**\n   * (Experimental) This prop is only effective with `XYZ` data.\n   * When true, polygon tesselation will be performed on the plane with the largest area, instead of the xy plane.\n   * @default false\n   */\n  _full3d?: boolean;\n\n  /**\n   * Elevation valur or accessor.\n   *\n   * Only used if `extruded: true`.\n   *\n   * @default 1000\n   */\n  getElevation?: Accessor<DataT, number>;\n\n  /**\n   * Elevation multiplier.\n   *\n   * The final elevation is calculated by `elevationScale * getElevation(d)`.\n   * `elevationScale` is a handy property to scale all elevation without updating the data.\n   *\n   * @default 1\n   */\n  elevationScale?: boolean;\n\n  /**\n   * Material settings for lighting effect. Applies to extruded polgons.\n   *\n   * @default true\n   * @see https://deck.gl/docs/developer-guide/using-lighting\n   */\n  material?: Material;\n};\n\n/** GeoJsonLayer Properties forwarded to `ScatterPlotLayer` if `pointType` is `'circle'` */\nexport type _GeoJsonLayerPointCircleProps<DataT> = {\n  getPointRadius?: Accessor<DataT, number>;\n  pointRadiusUnits?: Unit;\n  pointRadiusScale?: number;\n  pointRadiusMinPixels?: number;\n  pointRadiusMaxPixels?: number;\n  pointAntialiasing?: boolean;\n  pointBillboard?: boolean;\n\n  /** @deprecated use getPointRadius */\n  getRadius?: Accessor<DataT, number>;\n};\n\n/** GeoJsonLayer properties forwarded to `IconLayer` if `pointType` is `'icon'` */\ntype _GeojsonLayerIconPointProps<DataT> = {\n  iconAtlas?: any;\n  iconMapping?: any;\n  getIcon?: Accessor<DataT, any>;\n  getIconSize?: Accessor<DataT, number>;\n  getIconColor?: Accessor<DataT, Color>;\n  getIconAngle?: Accessor<DataT, number>;\n  getIconPixelOffset?: Accessor<DataT, number[]>;\n  iconSizeUnits?: Unit;\n  iconSizeScale?: number;\n  iconSizeMinPixels?: number;\n  iconSizeMaxPixels?: number;\n  iconBillboard?: boolean;\n  iconAlphaCutoff?: number;\n};\n\n/** GeoJsonLayer properties forwarded to `TextLayer` if `pointType` is `'text'` */\ntype _GeojsonLayerTextPointProps<DataT> = {\n  getText?: Accessor<DataT, any>;\n  getTextColor?: Accessor<DataT, Color>;\n  getTextAngle?: Accessor<DataT, number>;\n  getTextSize?: Accessor<DataT, number>;\n  getTextAnchor?: Accessor<DataT, string>;\n  getTextAlignmentBaseline?: Accessor<DataT, string>;\n  getTextPixelOffset?: Accessor<DataT, number[]>;\n  getTextBackgroundColor?: Accessor<DataT, Color>;\n  getTextBorderColor?: Accessor<DataT, Color>;\n  getTextBorderWidth?: Accessor<DataT, number>;\n  textSizeUnits?: Unit;\n  textSizeScale?: number;\n  textSizeMinPixels?: number;\n  textSizeMaxPixels?: number;\n  textCharacterSet?: any;\n  textFontFamily?: string;\n  textFontWeight?: number;\n  textLineHeight?: number;\n  textMaxWidth?: number;\n  textWordBreak?: string; // TODO\n  textBackground?: boolean;\n  textBackgroundPadding?: number[];\n  textOutlineColor?: Color;\n  textOutlineWidth?: number;\n  textBillboard?: boolean;\n  textFontSettings?: any;\n};\n\nconst FEATURE_TYPES = ['points', 'linestrings', 'polygons'];\n\nconst defaultProps: DefaultProps<GeoJsonLayerProps> = {\n  ...getDefaultProps(POINT_LAYER.circle),\n  ...getDefaultProps(POINT_LAYER.icon),\n  ...getDefaultProps(POINT_LAYER.text),\n  ...getDefaultProps(LINE_LAYER),\n  ...getDefaultProps(POLYGON_LAYER),\n\n  // Overwrite sub layer defaults\n  stroked: true,\n  filled: true,\n  extruded: false,\n  wireframe: false,\n  _full3d: false,\n  iconAtlas: {type: 'object', value: null},\n  iconMapping: {type: 'object', value: {}},\n  getIcon: {type: 'accessor', value: f => f.properties.icon},\n  getText: {type: 'accessor', value: f => f.properties.text},\n\n  // Self props\n  pointType: 'circle',\n\n  // TODO: deprecated, remove in v9\n  getRadius: {deprecatedFor: 'getPointRadius'}\n};\n\ntype GeoJsonPickingInfo = PickingInfo & {\n  featureType?: string | null;\n  info?: any;\n};\n\n/** Render GeoJSON formatted data as polygons, lines and points (circles, icons and/or texts). */\nexport default class GeoJsonLayer<\n  DataT extends Feature = Feature,\n  ExtraProps = {}\n> extends CompositeLayer<Required<GeoJsonLayerProps<DataT>> & ExtraProps> {\n  static layerName = 'GeoJsonLayer';\n  static defaultProps = defaultProps;\n\n  initializeState(): void {\n    this.state = {\n      layerProps: {},\n      features: {}\n    };\n  }\n\n  updateState({props, changeFlags}: UpdateParameters<this>): void {\n    if (!changeFlags.dataChanged) {\n      return;\n    }\n    const {data} = this.props;\n    const binary =\n      data && 'points' in (data as {}) && 'polygons' in (data as {}) && 'lines' in (data as {});\n\n    this.setState({binary});\n\n    if (binary) {\n      this._updateStateBinary({props, changeFlags});\n    } else {\n      this._updateStateJSON({props, changeFlags});\n    }\n  }\n\n  private _updateStateBinary({props, changeFlags}): void {\n    // eslint-disable-next-line @typescript-eslint/unbound-method\n    const layerProps = createLayerPropsFromBinary(props.data, this.encodePickingColor);\n    this.setState({layerProps});\n  }\n\n  private _updateStateJSON({props, changeFlags}): void {\n    const features: Feature[] = getGeojsonFeatures(props.data) as any;\n    const wrapFeature = this.getSubLayerRow.bind(this);\n    let newFeatures: SeparatedGeometries = {} as SeparatedGeometries;\n    const featuresDiff = {};\n\n    if (Array.isArray(changeFlags.dataChanged)) {\n      const oldFeatures = this.state.features;\n      for (const key in oldFeatures) {\n        newFeatures[key] = oldFeatures[key].slice();\n        featuresDiff[key] = [];\n      }\n\n      for (const dataRange of changeFlags.dataChanged) {\n        const partialFeatures = separateGeojsonFeatures(features, wrapFeature, dataRange);\n        for (const key in oldFeatures) {\n          featuresDiff[key].push(\n            replaceInRange({\n              data: newFeatures[key],\n              getIndex: f => f.__source.index,\n              dataRange,\n              replace: partialFeatures[key]\n            })\n          );\n        }\n      }\n    } else {\n      newFeatures = separateGeojsonFeatures(features, wrapFeature);\n    }\n\n    const layerProps = createLayerPropsFromFeatures(newFeatures, featuresDiff);\n\n    this.setState({\n      features: newFeatures,\n      featuresDiff,\n      layerProps\n    });\n  }\n\n  getPickingInfo(params): GeoJsonPickingInfo {\n    const info = super.getPickingInfo(params) as GeoJsonPickingInfo;\n    const {index, sourceLayer} = info;\n    info.featureType = FEATURE_TYPES.find(ft => sourceLayer!.id.startsWith(`${this.id}-${ft}-`));\n    if (index >= 0 && sourceLayer!.id.startsWith(`${this.id}-points-text`) && this.state.binary) {\n      info.index = (this.props.data as BinaryFeatures).points!.globalFeatureIds.value[index];\n    }\n    return info;\n  }\n\n  _updateAutoHighlight(info: GeoJsonPickingInfo): void {\n    // All sub layers except the points layer use source feature index to encode the picking color\n    // The points layer uses indices from the points data array.\n    const pointLayerIdPrefix = `${this.id}-points-`;\n    const sourceIsPoints = info.featureType === 'points';\n    for (const layer of this.getSubLayers()) {\n      if (layer.id.startsWith(pointLayerIdPrefix) === sourceIsPoints) {\n        layer.updateAutoHighlight(info);\n      }\n    }\n  }\n\n  private _renderPolygonLayer(): Layer | null {\n    const {extruded, wireframe} = this.props;\n    const {layerProps} = this.state;\n    const id = 'polygons-fill';\n\n    const PolygonFillLayer =\n      this.shouldRenderSubLayer(id, layerProps.polygons.data) &&\n      this.getSubLayerClass(id, POLYGON_LAYER.type);\n\n    if (PolygonFillLayer) {\n      const forwardedProps = forwardProps(this, POLYGON_LAYER.props);\n      // Avoid building the lineColors attribute if wireframe is off\n      const useLineColor = extruded && wireframe;\n      if (!useLineColor) {\n        delete forwardedProps.getLineColor;\n      }\n      // using a legacy API to invalid lineColor attributes\n      forwardedProps.updateTriggers.lineColors = useLineColor;\n\n      return new PolygonFillLayer(\n        forwardedProps,\n        this.getSubLayerProps({\n          id,\n          updateTriggers: forwardedProps.updateTriggers\n        }),\n        layerProps.polygons\n      );\n    }\n    return null;\n  }\n\n  private _renderLineLayers(): (Layer | false)[] | null {\n    const {extruded, stroked} = this.props;\n    const {layerProps} = this.state;\n    const polygonStrokeLayerId = 'polygons-stroke';\n    const lineStringsLayerId = 'linestrings';\n\n    const PolygonStrokeLayer =\n      !extruded &&\n      stroked &&\n      this.shouldRenderSubLayer(polygonStrokeLayerId, layerProps.polygonsOutline.data) &&\n      this.getSubLayerClass(polygonStrokeLayerId, LINE_LAYER.type);\n    const LineStringsLayer =\n      this.shouldRenderSubLayer(lineStringsLayerId, layerProps.lines.data) &&\n      this.getSubLayerClass(lineStringsLayerId, LINE_LAYER.type);\n\n    if (PolygonStrokeLayer || LineStringsLayer) {\n      const forwardedProps = forwardProps(this, LINE_LAYER.props);\n\n      return [\n        PolygonStrokeLayer &&\n          new PolygonStrokeLayer(\n            forwardedProps,\n            this.getSubLayerProps({\n              id: polygonStrokeLayerId,\n              updateTriggers: forwardedProps.updateTriggers\n            }),\n            layerProps.polygonsOutline\n          ),\n\n        LineStringsLayer &&\n          new LineStringsLayer(\n            forwardedProps,\n            this.getSubLayerProps({\n              id: lineStringsLayerId,\n              updateTriggers: forwardedProps.updateTriggers\n            }),\n            layerProps.lines\n          )\n      ];\n    }\n    return null;\n  }\n\n  private _renderPointLayers(): Layer[] | null {\n    const {pointType} = this.props;\n    const {layerProps, binary} = this.state;\n    let {highlightedObjectIndex} = this.props;\n\n    if (!binary && Number.isFinite(highlightedObjectIndex)) {\n      highlightedObjectIndex = layerProps.points.data.findIndex(\n        d => d.__source.index === highlightedObjectIndex\n      );\n    }\n\n    // Avoid duplicate sub layer ids\n    const types = new Set(pointType.split('+'));\n    const pointLayers: Layer[] = [];\n    for (const type of types) {\n      const id = `points-${type}`;\n      const PointLayerMapping = POINT_LAYER[type];\n      const PointsLayer: _ConstructorOf<Layer> =\n        PointLayerMapping &&\n        this.shouldRenderSubLayer(id, layerProps.points.data) &&\n        this.getSubLayerClass(id, PointLayerMapping.type);\n      if (PointsLayer) {\n        const forwardedProps = forwardProps(this, PointLayerMapping.props);\n        let pointsLayerProps = layerProps.points;\n\n        if (type === 'text' && binary) {\n          // Picking colors are per-point but for text per-character are required\n          // getPickingInfo() maps back to the correct index\n          // eslint-disable-next-line @typescript-eslint/no-unused-vars\n          const {instancePickingColors, ...rest} = pointsLayerProps.data.attributes;\n          pointsLayerProps = {\n            ...pointsLayerProps,\n            data: {...pointsLayerProps.data, attributes: rest}\n          };\n        }\n\n        pointLayers.push(\n          new PointsLayer(\n            forwardedProps,\n            this.getSubLayerProps({\n              id,\n              updateTriggers: forwardedProps.updateTriggers,\n              highlightedObjectIndex\n            }),\n            pointsLayerProps\n          )\n        );\n      }\n    }\n    return pointLayers;\n  }\n\n  renderLayers() {\n    const {extruded} = this.props;\n\n    const polygonFillLayer = this._renderPolygonLayer();\n    const lineLayers = this._renderLineLayers();\n    const pointLayers = this._renderPointLayers();\n\n    return [\n      // If not extruded: flat fill layer is drawn below outlines\n      !extruded && polygonFillLayer,\n      lineLayers,\n      pointLayers,\n      // If extruded: draw fill layer last for correct blending behavior\n      extruded && polygonFillLayer\n    ];\n  }\n\n  protected getSubLayerAccessor<In, Out>(accessor: Accessor<In, Out>): Accessor<In, Out> {\n    const {binary} = this.state;\n    if (!binary || typeof accessor !== 'function') {\n      return super.getSubLayerAccessor(accessor);\n    }\n\n    return (object, info) => {\n      const {data, index} = info;\n      const feature = binaryToFeatureForAccesor(data as unknown as BinaryFeatureTypes, index);\n      // @ts-ignore (TS2349) accessor is always function\n      return accessor(feature, info);\n    };\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {\n  Layer,\n  project32,\n  picking,\n  UNIT,\n  UpdateParameters,\n  LayerProps,\n  Unit,\n  AccessorFunction,\n  Position,\n  Accessor,\n  Color,\n  DefaultProps\n} from '@deck.gl/core';\n\nimport GL from '@luma.gl/constants';\nimport {Model, Geometry} from '@luma.gl/core';\n\nimport vs from './arc-layer-vertex.glsl';\nimport fs from './arc-layer-fragment.glsl';\n\nconst DEFAULT_COLOR: [number, number, number, number] = [0, 0, 0, 255];\n\nconst defaultProps: DefaultProps<ArcLayerProps> = {\n  getSourcePosition: {type: 'accessor', value: x => x.sourcePosition},\n  getTargetPosition: {type: 'accessor', value: x => x.targetPosition},\n  getSourceColor: {type: 'accessor', value: DEFAULT_COLOR},\n  getTargetColor: {type: 'accessor', value: DEFAULT_COLOR},\n  getWidth: {type: 'accessor', value: 1},\n  getHeight: {type: 'accessor', value: 1},\n  getTilt: {type: 'accessor', value: 0},\n\n  greatCircle: false,\n\n  widthUnits: 'pixels',\n  widthScale: {type: 'number', value: 1, min: 0},\n  widthMinPixels: {type: 'number', value: 0, min: 0},\n  widthMaxPixels: {type: 'number', value: Number.MAX_SAFE_INTEGER, min: 0}\n};\n\n/** All properties supported by ArcLayer. */\nexport type ArcLayerProps<DataT = any> = _ArcLayerProps<DataT> & LayerProps<DataT>;\n\n/** Properties added by ArcLayer. */\ntype _ArcLayerProps<DataT> = {\n  /**\n   * If `true`, create the arc along the shortest path on the earth surface.\n   * @default false\n   */\n  greatCircle?: boolean;\n\n  /**\n   * The units of the line width, one of `'meters'`, `'common'`, and `'pixels'`\n   * @default 'pixels'\n   */\n  widthUnits?: Unit;\n\n  /**\n   * The scaling multiplier for the width of each line.\n   * @default 1\n   */\n  widthScale?: number;\n\n  /**\n   * The minimum line width in pixels.\n   * @default 0\n   */\n  widthMinPixels?: number;\n\n  /**\n   * The maximum line width in pixels.\n   * @default Number.MAX_SAFE_INTEGER\n   */\n  widthMaxPixels?: number;\n\n  /**\n   * Method called to retrieve the source position of each object.\n   * @default object => object.sourcePosition\n   */\n  getSourcePosition?: AccessorFunction<DataT, Position>;\n\n  /**\n   * Method called to retrieve the target position of each object.\n   * @default object => object.targetPosition\n   */\n  getTargetPosition?: AccessorFunction<DataT, Position>;\n\n  /**\n   * The rgba color is in the format of `[r, g, b, [a]]`.\n   * @default [0, 0, 0, 255]\n   */\n  getSourceColor?: Accessor<DataT, Color>;\n\n  /**\n   * The rgba color is in the format of `[r, g, b, [a]]`.\n   * @default [0, 0, 0, 255]\n   */\n  getTargetColor?: Accessor<DataT, Color>;\n\n  /**\n   * The line width of each object, in units specified by `widthUnits`.\n   * @default 1\n   */\n  getWidth?: Accessor<DataT, number>;\n\n  /**\n   * Multiplier of layer height. `0` will make the layer flat.\n   * @default 1\n   */\n  getHeight?: Accessor<DataT, number>;\n\n  /**\n   * Use to tilt the arc to the side if you have multiple arcs with the same source and target positions.\n   * @default 0\n   */\n  getTilt?: Accessor<DataT, number>;\n};\n\n/** Render raised arcs joining pairs of source and target coordinates. */\nexport default class ArcLayer<DataT = any, ExtraPropsT = {}> extends Layer<\n  ExtraPropsT & Required<_ArcLayerProps<DataT>>\n> {\n  static layerName = 'ArcLayer';\n  static defaultProps = defaultProps;\n\n  state!: Layer['state'] & {\n    model?: Model;\n  };\n\n  getShaders() {\n    return super.getShaders({vs, fs, modules: [project32, picking]}); // 'project' module added by default.\n  }\n\n  // This layer has its own wrapLongitude logic\n  get wrapLongitude() {\n    return false;\n  }\n\n  initializeState() {\n    const attributeManager = this.getAttributeManager()!;\n\n    /* eslint-disable max-len */\n    attributeManager.addInstanced({\n      instanceSourcePositions: {\n        size: 3,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        transition: true,\n        accessor: 'getSourcePosition'\n      },\n      instanceTargetPositions: {\n        size: 3,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        transition: true,\n        accessor: 'getTargetPosition'\n      },\n      instanceSourceColors: {\n        size: this.props.colorFormat.length,\n        type: GL.UNSIGNED_BYTE,\n        normalized: true,\n        transition: true,\n        accessor: 'getSourceColor',\n        defaultValue: DEFAULT_COLOR\n      },\n      instanceTargetColors: {\n        size: this.props.colorFormat.length,\n        type: GL.UNSIGNED_BYTE,\n        normalized: true,\n        transition: true,\n        accessor: 'getTargetColor',\n        defaultValue: DEFAULT_COLOR\n      },\n      instanceWidths: {\n        size: 1,\n        transition: true,\n        accessor: 'getWidth',\n        defaultValue: 1\n      },\n      instanceHeights: {\n        size: 1,\n        transition: true,\n        accessor: 'getHeight',\n        defaultValue: 1\n      },\n      instanceTilts: {\n        size: 1,\n        transition: true,\n        accessor: 'getTilt',\n        defaultValue: 0\n      }\n    });\n    /* eslint-enable max-len */\n  }\n\n  updateState(opts: UpdateParameters<this>): void {\n    super.updateState(opts);\n    // Re-generate model if geometry changed\n    if (opts.changeFlags.extensionsChanged) {\n      const {gl} = this.context;\n      this.state.model?.delete();\n      this.state.model = this._getModel(gl);\n      this.getAttributeManager()!.invalidateAll();\n    }\n  }\n\n  draw({uniforms}) {\n    const {widthUnits, widthScale, widthMinPixels, widthMaxPixels, greatCircle, wrapLongitude} =\n      this.props;\n\n    this.state.model\n      .setUniforms(uniforms)\n      .setUniforms({\n        greatCircle,\n        widthUnits: UNIT[widthUnits],\n        widthScale,\n        widthMinPixels,\n        widthMaxPixels,\n        useShortestPath: wrapLongitude\n      })\n      .draw();\n  }\n\n  protected _getModel(gl: WebGLRenderingContext): Model {\n    let positions: number[] = [];\n    const NUM_SEGMENTS = 50;\n    /*\n     *  (0, -1)-------------_(1, -1)\n     *       |          _,-\"  |\n     *       o      _,-\"      o\n     *       |  _,-\"          |\n     *   (0, 1)\"-------------(1, 1)\n     */\n    for (let i = 0; i < NUM_SEGMENTS; i++) {\n      positions = positions.concat([i, 1, 0, i, -1, 0]);\n    }\n\n    const model = new Model(gl, {\n      ...this.getShaders(),\n      id: this.props.id,\n      geometry: new Geometry({\n        drawMode: GL.TRIANGLE_STRIP,\n        attributes: {\n          positions: new Float32Array(positions)\n        }\n      }),\n      isInstanced: true\n    });\n\n    model.setUniforms({numSegments: NUM_SEGMENTS});\n\n    return model;\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME arc-layer-vertex-shader\n\nattribute vec3 positions;\nattribute vec4 instanceSourceColors;\nattribute vec4 instanceTargetColors;\nattribute vec3 instanceSourcePositions;\nattribute vec3 instanceSourcePositions64Low;\nattribute vec3 instanceTargetPositions;\nattribute vec3 instanceTargetPositions64Low;\nattribute vec3 instancePickingColors;\nattribute float instanceWidths;\nattribute float instanceHeights;\nattribute float instanceTilts;\n\nuniform bool greatCircle;\nuniform bool useShortestPath;\nuniform float numSegments;\nuniform float opacity;\nuniform float widthScale;\nuniform float widthMinPixels;\nuniform float widthMaxPixels;\nuniform int widthUnits;\n\nvarying vec4 vColor;\nvarying vec2 uv;\nvarying float isValid;\n\nfloat paraboloid(float distance, float sourceZ, float targetZ, float ratio) {\n  // d: distance on the xy plane\n  // r: ratio of the current point\n  // p: ratio of the peak of the arc\n  // h: height multiplier\n  // z = f(r) = sqrt(r * (p * 2 - r)) * d * h\n  // f(0) = 0\n  // f(1) = dz\n\n  float deltaZ = targetZ - sourceZ;\n  float dh = distance * instanceHeights;\n  if (dh == 0.0) {\n    return sourceZ + deltaZ * ratio;\n  }\n  float unitZ = deltaZ / dh;\n  float p2 = unitZ * unitZ + 1.0;\n\n  // sqrt does not deal with negative values, manually flip source and target if delta.z < 0\n  float dir = step(deltaZ, 0.0);\n  float z0 = mix(sourceZ, targetZ, dir);\n  float r = mix(ratio, 1.0 - ratio, dir);\n  return sqrt(r * (p2 - r)) * dh + z0;\n}\n\n// offset vector by strokeWidth pixels\n// offset_direction is -1 (left) or 1 (right)\nvec2 getExtrusionOffset(vec2 line_clipspace, float offset_direction, float width) {\n  // normalized direction of the line\n  vec2 dir_screenspace = normalize(line_clipspace * project_uViewportSize);\n  // rotate by 90 degrees\n  dir_screenspace = vec2(-dir_screenspace.y, dir_screenspace.x);\n\n  return dir_screenspace * offset_direction * width / 2.0;\n}\n\nfloat getSegmentRatio(float index) {\n  return smoothstep(0.0, 1.0, index / (numSegments - 1.0));\n}\n\nvec3 interpolateFlat(vec3 source, vec3 target, float segmentRatio) {\n  float distance = length(source.xy - target.xy);\n  float z = paraboloid(distance, source.z, target.z, segmentRatio);\n\n  float tiltAngle = radians(instanceTilts);\n  vec2 tiltDirection = normalize(target.xy - source.xy);\n  vec2 tilt = vec2(-tiltDirection.y, tiltDirection.x) * z * sin(tiltAngle);\n\n  return vec3(\n    mix(source.xy, target.xy, segmentRatio) + tilt,\n    z * cos(tiltAngle)\n  );\n}\n\n/* Great circle interpolation\n * http://www.movable-type.co.uk/scripts/latlong.html\n */\nfloat getAngularDist (vec2 source, vec2 target) {\n  vec2 sourceRadians = radians(source);\n  vec2 targetRadians = radians(target);\n  vec2 sin_half_delta = sin((sourceRadians - targetRadians) / 2.0);\n  vec2 shd_sq = sin_half_delta * sin_half_delta;\n\n  float a = shd_sq.y + cos(sourceRadians.y) * cos(targetRadians.y) * shd_sq.x;\n  return 2.0 * asin(sqrt(a));\n}\n\nvec3 interpolateGreatCircle(vec3 source, vec3 target, vec3 source3D, vec3 target3D, float angularDist, float t) {\n  vec2 lngLat;\n\n  // if the angularDist is PI, linear interpolation is applied. otherwise, use spherical interpolation\n  if(abs(angularDist - PI) < 0.001) {\n    lngLat = (1.0 - t) * source.xy + t * target.xy;\n  } else {\n    float a = sin((1.0 - t) * angularDist);\n    float b = sin(t * angularDist);\n    vec3 p = source3D.yxz * a + target3D.yxz * b;\n    lngLat = degrees(vec2(atan(p.y, -p.x), atan(p.z, length(p.xy))));\n  }\n\n  float z = paraboloid(angularDist * EARTH_RADIUS, source.z, target.z, t);\n\n  return vec3(lngLat, z);\n}\n\n/* END GREAT CIRCLE */\n\nvoid main(void) {\n  geometry.worldPosition = instanceSourcePositions;\n  geometry.worldPositionAlt = instanceTargetPositions;\n\n  float segmentIndex = positions.x;\n  float segmentRatio = getSegmentRatio(segmentIndex);\n  float prevSegmentRatio = getSegmentRatio(max(0.0, segmentIndex - 1.0));\n  float nextSegmentRatio = getSegmentRatio(min(numSegments - 1.0, segmentIndex + 1.0));\n\n  // if it's the first point, use next - current as direction\n  // otherwise use current - prev\n  float indexDir = mix(-1.0, 1.0, step(segmentIndex, 0.0));\n  isValid = 1.0;\n\n  uv = vec2(segmentRatio, positions.y);\n  geometry.uv = uv;\n  geometry.pickingColor = instancePickingColors;\n\n  vec4 curr;\n  vec4 next;\n  vec3 source;\n  vec3 target;\n\n  if ((greatCircle || project_uProjectionMode == PROJECTION_MODE_GLOBE) && project_uCoordinateSystem == COORDINATE_SYSTEM_LNGLAT) {\n    source = project_globe_(vec3(instanceSourcePositions.xy, 0.0));\n    target = project_globe_(vec3(instanceTargetPositions.xy, 0.0));\n    float angularDist = getAngularDist(instanceSourcePositions.xy, instanceTargetPositions.xy);\n\n    vec3 prevPos = interpolateGreatCircle(instanceSourcePositions, instanceTargetPositions, source, target, angularDist, prevSegmentRatio);\n    vec3 currPos = interpolateGreatCircle(instanceSourcePositions, instanceTargetPositions, source, target, angularDist, segmentRatio);\n    vec3 nextPos = interpolateGreatCircle(instanceSourcePositions, instanceTargetPositions, source, target, angularDist, nextSegmentRatio);\n\n    if (abs(currPos.x - prevPos.x) > 180.0) {\n      indexDir = -1.0;\n      isValid = 0.0;\n    } else if (abs(currPos.x - nextPos.x) > 180.0) {\n      indexDir = 1.0;\n      isValid = 0.0;\n    }\n    nextPos = indexDir < 0.0 ? prevPos : nextPos;\n    nextSegmentRatio = indexDir < 0.0 ? prevSegmentRatio : nextSegmentRatio;\n\n    if (isValid == 0.0) {\n      // split at the 180th meridian\n      nextPos.x += nextPos.x > 0.0 ? -360.0 : 360.0;\n      float t = ((currPos.x > 0.0 ? 180.0 : -180.0) - currPos.x) / (nextPos.x - currPos.x);\n      currPos = mix(currPos, nextPos, t);\n      segmentRatio = mix(segmentRatio, nextSegmentRatio, t);\n    }\n\n    vec3 currPos64Low = mix(instanceSourcePositions64Low, instanceTargetPositions64Low, segmentRatio);\n    vec3 nextPos64Low = mix(instanceSourcePositions64Low, instanceTargetPositions64Low, nextSegmentRatio);\n  \n    curr = project_position_to_clipspace(currPos, currPos64Low, vec3(0.0), geometry.position);\n    next = project_position_to_clipspace(nextPos, nextPos64Low, vec3(0.0));\n  \n  } else {\n    vec3 source_world = instanceSourcePositions;\n    vec3 target_world = instanceTargetPositions;\n    if (useShortestPath) {\n      source_world.x = mod(source_world.x + 180., 360.0) - 180.;\n      target_world.x = mod(target_world.x + 180., 360.0) - 180.;\n\n      float deltaLng = target_world.x - source_world.x;\n      if (deltaLng > 180.) target_world.x -= 360.;\n      if (deltaLng < -180.) source_world.x -= 360.;\n    }\n    source = project_position(source_world, instanceSourcePositions64Low);\n    target = project_position(target_world, instanceTargetPositions64Low);\n\n    // common x at longitude=-180\n    float antiMeridianX = 0.0;\n\n    if (useShortestPath) {\n      if (project_uProjectionMode == PROJECTION_MODE_WEB_MERCATOR_AUTO_OFFSET) {\n        antiMeridianX = -(project_uCoordinateOrigin.x + 180.) / 360. * TILE_SIZE;\n      }\n      float thresholdRatio = (antiMeridianX - source.x) / (target.x - source.x);\n\n      if (prevSegmentRatio <= thresholdRatio && nextSegmentRatio > thresholdRatio) {\n        isValid = 0.0;\n        indexDir = sign(segmentRatio - thresholdRatio);\n        segmentRatio = thresholdRatio;\n      }\n    }\n\n    nextSegmentRatio = indexDir < 0.0 ? prevSegmentRatio : nextSegmentRatio;\n    vec3 currPos = interpolateFlat(source, target, segmentRatio);\n    vec3 nextPos = interpolateFlat(source, target, nextSegmentRatio);\n\n    if (useShortestPath) {\n      if (nextPos.x < antiMeridianX) {\n        currPos.x += TILE_SIZE;\n        nextPos.x += TILE_SIZE;\n      }\n    }\n\n    curr = project_common_position_to_clipspace(vec4(currPos, 1.0));\n    next = project_common_position_to_clipspace(vec4(nextPos, 1.0));\n    geometry.position = vec4(currPos, 1.0);\n  }\n\n  // Multiply out width and clamp to limits\n  // mercator pixels are interpreted as screen pixels\n  float widthPixels = clamp(\n    project_size_to_pixel(instanceWidths * widthScale, widthUnits),\n    widthMinPixels, widthMaxPixels\n  );\n\n  // extrude\n  vec3 offset = vec3(\n    getExtrusionOffset((next.xy - curr.xy) * indexDir, positions.y, widthPixels),\n    0.0);\n  DECKGL_FILTER_SIZE(offset, geometry);\n  gl_Position = curr + vec4(project_pixel_size_to_clipspace(offset.xy), 0.0, 0.0);\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  vec4 color = mix(instanceSourceColors, instanceTargetColors, segmentRatio);\n  vColor = vec4(color.rgb, color.a * opacity);\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME arc-layer-fragment-shader\n\nprecision highp float;\n\nvarying vec4 vColor;\nvarying vec2 uv;\nvarying float isValid;\n\nvoid main(void) {\n  if (isValid == 0.0) {\n    discard;\n  }\n\n  gl_FragColor = vColor;\n  geometry.uv = uv;\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {\n  Layer,\n  project32,\n  picking,\n  UNIT,\n  LayerProps,\n  Unit,\n  Position,\n  Accessor,\n  Color,\n  UpdateParameters,\n  DefaultProps\n} from '@deck.gl/core';\nimport GL from '@luma.gl/constants';\nimport {Model, Geometry} from '@luma.gl/core';\n\nimport vs from './line-layer-vertex.glsl';\nimport fs from './line-layer-fragment.glsl';\n\nconst DEFAULT_COLOR: [number, number, number, number] = [0, 0, 0, 255];\n\nconst defaultProps: DefaultProps<LineLayerProps> = {\n  getSourcePosition: {type: 'accessor', value: x => x.sourcePosition},\n  getTargetPosition: {type: 'accessor', value: x => x.targetPosition},\n  getColor: {type: 'accessor', value: DEFAULT_COLOR},\n  getWidth: {type: 'accessor', value: 1},\n\n  widthUnits: 'pixels',\n  widthScale: {type: 'number', value: 1, min: 0},\n  widthMinPixels: {type: 'number', value: 0, min: 0},\n  widthMaxPixels: {type: 'number', value: Number.MAX_SAFE_INTEGER, min: 0}\n};\n\n/** All properties supported by LineLayer. */\nexport type LineLayerProps<DataT = any> = _LineLayerProps<DataT> & LayerProps<DataT>;\n\n/** Properties added by LineLayer. */\ntype _LineLayerProps<DataT> = {\n  /**\n   * The units of the line width, one of `'meters'`, `'common'`, and `'pixels'`.\n   * @default 'pixels'\n   */\n  widthUnits?: Unit;\n\n  /**\n   * The scaling multiplier for the width of each line.\n   * @default 1\n   */\n  widthScale?: number;\n\n  /**\n   * The minimum line width in pixels.\n   * @default 0\n   */\n  widthMinPixels?: number;\n\n  /**\n   * The maximum line width in pixels.\n   * @default Number.MAX_SAFE_INTEGER\n   */\n  widthMaxPixels?: number;\n\n  /**\n   * Source position of each object.\n   * @default object => object.sourcePosition\n   */\n  getSourcePosition?: Accessor<DataT, Position>;\n\n  /**\n   * Target position of each object.\n   * @default object => object.targetPosition\n   */\n  getTargetPosition?: Accessor<DataT, Position>;\n\n  /**\n   * The rgba color is in the format of `[r, g, b, [a]]`.\n   * @default [0, 0, 0, 255]\n   */\n  getColor?: Accessor<DataT, Color>;\n\n  /**\n   * Width of each object\n   * @default 1\n   */\n  getWidth?: Accessor<DataT, number>;\n};\n\n/**\n * A layer that renders straight lines joining pairs of source and target coordinates.\n */\nexport default class LineLayer<DataT = any, ExtraProps = {}> extends Layer<\n  ExtraProps & Required<_LineLayerProps<DataT>>\n> {\n  static layerName = 'LineLayer';\n  static defaultProps = defaultProps;\n\n  getShaders() {\n    return super.getShaders({vs, fs, modules: [project32, picking]});\n  }\n\n  // This layer has its own wrapLongitude logic\n  get wrapLongitude(): boolean {\n    return false;\n  }\n\n  initializeState() {\n    const attributeManager = this.getAttributeManager()!;\n\n    /* eslint-disable max-len */\n    attributeManager.addInstanced({\n      instanceSourcePositions: {\n        size: 3,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        transition: true,\n        accessor: 'getSourcePosition'\n      },\n      instanceTargetPositions: {\n        size: 3,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        transition: true,\n        accessor: 'getTargetPosition'\n      },\n      instanceColors: {\n        size: this.props.colorFormat.length,\n        type: GL.UNSIGNED_BYTE,\n        normalized: true,\n        transition: true,\n        accessor: 'getColor',\n        defaultValue: [0, 0, 0, 255]\n      },\n      instanceWidths: {\n        size: 1,\n        transition: true,\n        accessor: 'getWidth',\n        defaultValue: 1\n      }\n    });\n    /* eslint-enable max-len */\n  }\n\n  updateState(params: UpdateParameters<this>): void {\n    super.updateState(params);\n\n    if (params.changeFlags.extensionsChanged) {\n      const {gl} = this.context;\n      this.state.model?.delete();\n      this.state.model = this._getModel(gl);\n      this.getAttributeManager()!.invalidateAll();\n    }\n  }\n\n  draw({uniforms}): void {\n    const {widthUnits, widthScale, widthMinPixels, widthMaxPixels, wrapLongitude} = this.props;\n\n    this.state.model\n      .setUniforms(uniforms)\n      .setUniforms({\n        widthUnits: UNIT[widthUnits],\n        widthScale,\n        widthMinPixels,\n        widthMaxPixels,\n        useShortestPath: wrapLongitude ? 1 : 0\n      })\n      .draw();\n\n    if (wrapLongitude) {\n      // Render a second copy for the clipped lines at the 180th meridian\n      this.state.model\n        .setUniforms({\n          useShortestPath: -1\n        })\n        .draw();\n    }\n  }\n\n  protected _getModel(gl: WebGLRenderingContext): Model {\n    /*\n     *  (0, -1)-------------_(1, -1)\n     *       |          _,-\"  |\n     *       o      _,-\"      o\n     *       |  _,-\"          |\n     *   (0, 1)\"-------------(1, 1)\n     */\n    const positions = [0, -1, 0, 0, 1, 0, 1, -1, 0, 1, 1, 0];\n\n    return new Model(gl, {\n      ...this.getShaders(),\n      id: this.props.id,\n      geometry: new Geometry({\n        drawMode: GL.TRIANGLE_STRIP,\n        attributes: {\n          positions: new Float32Array(positions)\n        }\n      }),\n      isInstanced: true\n    });\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME line-layer-vertex-shader\n\nattribute vec3 positions;\nattribute vec3 instanceSourcePositions;\nattribute vec3 instanceTargetPositions;\nattribute vec3 instanceSourcePositions64Low;\nattribute vec3 instanceTargetPositions64Low;\nattribute vec4 instanceColors;\nattribute vec3 instancePickingColors;\nattribute float instanceWidths;\n\nuniform float opacity;\nuniform float widthScale;\nuniform float widthMinPixels;\nuniform float widthMaxPixels;\nuniform float useShortestPath;\nuniform int widthUnits;\n\nvarying vec4 vColor;\nvarying vec2 uv;\n\n// offset vector by strokeWidth pixels\n// offset_direction is -1 (left) or 1 (right)\nvec2 getExtrusionOffset(vec2 line_clipspace, float offset_direction, float width) {\n  // normalized direction of the line\n  vec2 dir_screenspace = normalize(line_clipspace * project_uViewportSize);\n  // rotate by 90 degrees\n  dir_screenspace = vec2(-dir_screenspace.y, dir_screenspace.x);\n\n  return dir_screenspace * offset_direction * width / 2.0;\n}\n\nvec3 splitLine(vec3 a, vec3 b, float x) {\n  float t = (x - a.x) / (b.x - a.x);\n  return vec3(x, mix(a.yz, b.yz, t));\n}\n\nvoid main(void) {\n  geometry.worldPosition = instanceSourcePositions;\n  geometry.worldPositionAlt = instanceTargetPositions;\n\n  vec3 source_world = instanceSourcePositions;\n  vec3 target_world = instanceTargetPositions;\n  vec3 source_world_64low = instanceSourcePositions64Low;\n  vec3 target_world_64low = instanceTargetPositions64Low;\n\n  if (useShortestPath > 0.5 || useShortestPath < -0.5) {\n    source_world.x = mod(source_world.x + 180., 360.0) - 180.;\n    target_world.x = mod(target_world.x + 180., 360.0) - 180.;\n    float deltaLng = target_world.x - source_world.x;\n\n    if (deltaLng * useShortestPath > 180.) {\n      source_world.x += 360. * useShortestPath;\n      source_world = splitLine(source_world, target_world, 180. * useShortestPath);\n      source_world_64low = vec3(0.0);\n    } else if (deltaLng * useShortestPath < -180.) {\n      target_world.x += 360. * useShortestPath;\n      target_world = splitLine(source_world, target_world, 180. * useShortestPath);\n      target_world_64low = vec3(0.0);\n    } else if (useShortestPath < 0.) {\n      // Line is not split, abort\n      gl_Position = vec4(0.);\n      return;\n    }\n  }\n\n  // Position\n  vec4 source_commonspace;\n  vec4 target_commonspace;\n  vec4 source = project_position_to_clipspace(source_world, source_world_64low, vec3(0.), source_commonspace);\n  vec4 target = project_position_to_clipspace(target_world, target_world_64low, vec3(0.), target_commonspace);\n  \n  // linear interpolation of source & target to pick right coord\n  float segmentIndex = positions.x;\n  vec4 p = mix(source, target, segmentIndex);\n  geometry.position = mix(source_commonspace, target_commonspace, segmentIndex);\n  uv = positions.xy;\n  geometry.uv = uv;\n  geometry.pickingColor = instancePickingColors;\n\n  // Multiply out width and clamp to limits\n  float widthPixels = clamp(\n    project_size_to_pixel(instanceWidths * widthScale, widthUnits),\n    widthMinPixels, widthMaxPixels\n  );\n\n  // extrude\n  vec3 offset = vec3(\n    getExtrusionOffset(target.xy - source.xy, positions.y, widthPixels),\n    0.0);\n  DECKGL_FILTER_SIZE(offset, geometry);\n  gl_Position = p + vec4(project_pixel_size_to_clipspace(offset.xy), 0.0, 0.0);\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  // Color\n  vColor = vec4(instanceColors.rgb, instanceColors.a * opacity);\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME line-layer-fragment-shader\n\nprecision highp float;\n\nvarying vec4 vColor;\nvarying vec2 uv;\n\nvoid main(void) {\n  geometry.uv = uv;\n\n  gl_FragColor = vColor;\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {\n  Layer,\n  project32,\n  gouraudLighting,\n  picking,\n  UNIT,\n  LayerProps,\n  UpdateParameters,\n  Unit,\n  AccessorFunction,\n  Position,\n  Accessor,\n  Color,\n  Material,\n  DefaultProps\n} from '@deck.gl/core';\nimport GL from '@luma.gl/constants';\nimport {Model, Geometry} from '@luma.gl/core';\n\nimport vs from './point-cloud-layer-vertex.glsl';\nimport fs from './point-cloud-layer-fragment.glsl';\n\nconst DEFAULT_COLOR: [number, number, number, number] = [0, 0, 0, 255];\nconst DEFAULT_NORMAL: [number, number, number] = [0, 0, 1];\n\nconst defaultProps: DefaultProps<PointCloudLayerProps> = {\n  sizeUnits: 'pixels',\n  pointSize: {type: 'number', min: 0, value: 10}, //  point radius in pixels\n\n  getPosition: {type: 'accessor', value: x => x.position},\n  getNormal: {type: 'accessor', value: DEFAULT_NORMAL},\n  getColor: {type: 'accessor', value: DEFAULT_COLOR},\n\n  material: true,\n\n  // Depreated\n  radiusPixels: {deprecatedFor: 'pointSize'}\n};\n\n// support loaders.gl point cloud format\nfunction normalizeData(data) {\n  const {header, attributes} = data;\n  if (!header || !attributes) {\n    return;\n  }\n\n  data.length = header.vertexCount;\n\n  if (attributes.POSITION) {\n    attributes.instancePositions = attributes.POSITION;\n  }\n  if (attributes.NORMAL) {\n    attributes.instanceNormals = attributes.NORMAL;\n  }\n  if (attributes.COLOR_0) {\n    attributes.instanceColors = attributes.COLOR_0;\n  }\n}\n\n/** All properties supported by PointCloudLayer. */\nexport type PointCloudLayerProps<DataT = any> = _PointCloudLayerProps<DataT> & LayerProps<DataT>;\n\n/** Properties added by PointCloudLayer. */\ntype _PointCloudLayerProps<DataT> = {\n  /**\n   * The units of the point size, one of `'meters'`, `'common'`, and `'pixels'`.\n   * @default 'pixels'\n   */\n  sizeUnits?: Unit;\n\n  /**\n   * Global radius of all points, in units specified by `sizeUnits`\n   * @default 10\n   */\n  pointSize?: number;\n\n  /**\n   * @deprecated Use `pointSize` instead\n   */\n  radiusPixels?: number;\n\n  /**\n   * Material settings for lighting effect.\n   *\n   * @default true\n   * @see https://deck.gl/docs/developer-guide/using-lighting\n   */\n  material?: Material;\n\n  /**\n   * Method called to retrieve the position of each object.\n   * @default object => object.position\n   */\n  getPosition?: AccessorFunction<DataT, Position>;\n\n  /**\n   * The normal of each object, in `[nx, ny, nz]`.\n   * @default [0, 0, 1]\n   */\n  getNormal?: Accessor<DataT, [number, number, number]>;\n\n  /**\n   * The rgba color is in the format of `[r, g, b, [a]]`\n   * @default [0, 0, 0, 255]\n   */\n  getColor?: Accessor<DataT, Color>;\n};\n\n/** Render a point cloud with 3D positions, normals and colors. */\nexport default class PointCloudLayer<DataT = any, ExtraPropsT = {}> extends Layer<\n  ExtraPropsT & Required<_PointCloudLayerProps<DataT>>\n> {\n  static layerName = 'PointCloudLayer';\n  static defaultProps = defaultProps;\n\n  getShaders() {\n    return super.getShaders({vs, fs, modules: [project32, gouraudLighting, picking]});\n  }\n\n  initializeState() {\n    this.getAttributeManager()!.addInstanced({\n      instancePositions: {\n        size: 3,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        transition: true,\n        accessor: 'getPosition'\n      },\n      instanceNormals: {\n        size: 3,\n        transition: true,\n        accessor: 'getNormal',\n        defaultValue: DEFAULT_NORMAL\n      },\n      instanceColors: {\n        size: this.props.colorFormat.length,\n        type: GL.UNSIGNED_BYTE,\n        normalized: true,\n        transition: true,\n        accessor: 'getColor',\n        defaultValue: DEFAULT_COLOR\n      }\n    });\n  }\n\n  updateState(params: UpdateParameters<this>): void {\n    const {changeFlags, props} = params;\n    super.updateState(params);\n    if (changeFlags.extensionsChanged) {\n      const {gl} = this.context;\n      this.state.model?.delete();\n      this.state.model = this._getModel(gl);\n      this.getAttributeManager()!.invalidateAll();\n    }\n    if (changeFlags.dataChanged) {\n      normalizeData(props.data);\n    }\n  }\n\n  draw({uniforms}) {\n    const {pointSize, sizeUnits} = this.props;\n\n    this.state.model\n      .setUniforms(uniforms)\n      .setUniforms({\n        sizeUnits: UNIT[sizeUnits],\n        radiusPixels: pointSize\n      })\n      .draw();\n  }\n\n  protected _getModel(gl: WebGLRenderingContext): Model {\n    // a triangle that minimally cover the unit circle\n    const positions: number[] = [];\n    for (let i = 0; i < 3; i++) {\n      const angle = (i / 3) * Math.PI * 2;\n      positions.push(Math.cos(angle) * 2, Math.sin(angle) * 2, 0);\n    }\n\n    return new Model(gl, {\n      ...this.getShaders(),\n      id: this.props.id,\n      geometry: new Geometry({\n        drawMode: GL.TRIANGLES,\n        attributes: {\n          positions: new Float32Array(positions)\n        }\n      }),\n      isInstanced: true\n    });\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME point-cloud-layer-vertex-shader\n\nattribute vec3 positions;\nattribute vec3 instanceNormals;\nattribute vec4 instanceColors;\nattribute vec3 instancePositions;\nattribute vec3 instancePositions64Low;\nattribute vec3 instancePickingColors;\n\nuniform float opacity;\nuniform float radiusPixels;\nuniform int sizeUnits;\n\nvarying vec4 vColor;\nvarying vec2 unitPosition;\n\nvoid main(void) {\n  geometry.worldPosition = instancePositions;\n  geometry.normal = project_normal(instanceNormals);\n\n  // position on the containing square in [-1, 1] space\n  unitPosition = positions.xy;\n  geometry.uv = unitPosition;\n  geometry.pickingColor = instancePickingColors;\n\n  // Find the center of the point and add the current vertex\n  vec3 offset = vec3(positions.xy * project_size_to_pixel(radiusPixels, sizeUnits), 0.0);\n  DECKGL_FILTER_SIZE(offset, geometry);\n\n  gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, vec3(0.), geometry.position);\n  gl_Position.xy += project_pixel_size_to_clipspace(offset.xy);\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  // Apply lighting\n  vec3 lightColor = lighting_getLightColor(instanceColors.rgb, project_uCameraPosition, geometry.position.xyz, geometry.normal);\n\n  // Apply opacity to instance color, or return instance picking color\n  vColor = vec4(lightColor, instanceColors.a * opacity);\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME point-cloud-layer-fragment-shader\n\nprecision highp float;\n\nvarying vec4 vColor;\nvarying vec2 unitPosition;\n\nvoid main(void) {\n  geometry.uv = unitPosition;\n\n  float distToCenter = length(unitPosition);\n\n  if (distToCenter > 1.0) {\n    discard;\n  }\n\n  gl_FragColor = vColor;\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n`;\n","// Note: This file will either be moved back to deck.gl or reformatted to web-monorepo standards\n// Disabling lint temporarily to facilitate copying code in and out of this repo\n/* eslint-disable */\n\n// Copyright (c) 2015 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {\n  Layer,\n  project32,\n  phongLighting,\n  picking,\n  DefaultProps,\n  log,\n  LayerContext,\n  Material\n} from '@deck.gl/core';\nimport GL from '@luma.gl/constants';\nimport {Model, Geometry, Texture2D, isWebGL2} from '@luma.gl/core';\nimport {hasFeature, FEATURES} from '@luma.gl/webgl';\n\nimport {MATRIX_ATTRIBUTES, shouldComposeModelMatrix} from '../utils/matrix';\n\nimport vs from './simple-mesh-layer-vertex.glsl';\nimport fs from './simple-mesh-layer-fragment.glsl';\n\nimport type {LayerProps, UpdateParameters, Accessor, Position, Color, Texture} from '@deck.gl/core';\nimport type {MeshAttribute, MeshAttributes} from '@loaders.gl/schema';\nimport type {Geometry as GeometryType} from '@luma.gl/engine';\nimport {GLTFMaterialParser} from '@luma.gl/experimental';\n\nfunction validateGeometryAttributes(attributes: Record<string, any>, useMeshColors: boolean): void {\n  const hasColorAttribute = attributes.COLOR_0 || attributes.colors;\n  const useColorAttribute = hasColorAttribute && useMeshColors;\n  if (!useColorAttribute) {\n    attributes.colors = {constant: true, value: new Float32Array([1, 1, 1])};\n  }\n  log.assert(\n    attributes.positions || attributes.POSITION,\n    'no \"postions\" or \"POSITION\" attribute in mesh'\n  );\n}\n\n/*\n * Convert mesh data into geometry\n * @returns {Geometry} geometry\n */\nfunction getGeometry(data: Mesh, useMeshColors: boolean): Geometry {\n  if ((data as any).attributes) {\n    validateGeometryAttributes((data as any).attributes, useMeshColors);\n    if (data instanceof Geometry) {\n      return data;\n    } else {\n      return new Geometry(data);\n    }\n  } else if ((data as MeshAttributes).positions || (data as MeshAttributes).POSITION) {\n    validateGeometryAttributes(data, useMeshColors);\n    return new Geometry({\n      attributes: data\n    });\n  }\n  throw Error('Invalid mesh');\n}\n\nconst DEFAULT_COLOR: [number, number, number, number] = [0, 0, 0, 255];\n\ntype Mesh =\n  | GeometryType\n  | {\n      attributes: MeshAttributes;\n      indices?: MeshAttribute;\n    }\n  | MeshAttributes;\n\ntype _SimpleMeshLayerProps<DataT> = {\n  mesh: string | Mesh | Promise<Mesh> | null;\n  texture?: string | Texture | Promise<Texture>;\n  /** Customize the [texture parameters](https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/texParameter). */\n  textureParameters?: Record<number, number> | null;\n\n  /** Anchor position accessor. */\n  getPosition?: Accessor<DataT, Position>;\n  /** Color value or accessor.\n   * If `mesh` does not contain vertex colors, use this color to render each object.\n   * If `mesh` contains vertex colors, then the two colors are mixed together.\n   * Use `[255, 255, 255]` to use the original mesh colors.\n   * If `texture` is assigned, then both colors will be ignored.\n   * @default [0, 0, 0, 255]\n   */\n  getColor?: Accessor<DataT, Color>;\n  /**\n   * Orientation in [pitch, yaw, roll] in degrees.\n   * @see https://en.wikipedia.org/wiki/Euler_angles\n   * @default [0, 0, 0]\n   */\n  getOrientation?: Accessor<DataT, [number, number, number]>;\n  /**\n   * Scaling factor of the model along each axis.\n   * @default [1, 1, 1]\n   */\n  getScale?: Accessor<DataT, [number, number, number]>;\n  /**\n   * Translation from the anchor point, [x, y, z] in meters.\n   * @default [0, 0, 0]\n   */\n  getTranslation?: Accessor<DataT, [number, number, number]>;\n  /**\n   * TransformMatrix. If specified, `getOrientation`, `getScale` and `getTranslation` are ignored.\n   */\n  getTransformMatrix?: Accessor<DataT, number[]>;\n  /**\n   * Multiplier to scale each geometry by.\n   * @default 1\n   */\n  sizeScale?: number;\n  /**\n   * @deprecated Whether to color pixels using vertex colors supplied in the mesh (the `COLOR_0` or `colors` attribute).\n   * If set to `false` vertex colors will be ignored.\n   * This prop will be removed and set to always true in the next major release.\n   * @default false\n   */\n  _useMeshColors?: boolean;\n\n  /**\n   * (Experimental) If rendering only one instance of the mesh, set this to false to treat mesh positions\n   * as deltas of the world coordinates of the anchor.\n   * E.g. in LNGLAT coordinates, mesh positions are interpreted as meter offsets by default.\n   * setting _instanced to false interpreted mesh positions as lnglat deltas.\n   * @default true\n   */\n  _instanced?: true; // TODO - formalize API\n  /**\n   * Whether to render the mesh in wireframe mode.\n   * @default false\n   */\n  wireframe?: false;\n  /**\n   * Material props for lighting effect.\n   *\n   * @default true\n   * @see https://deck.gl/docs/developer-guide/using-lighting#constructing-a-material-instance\n   */\n  material?: Material;\n};\n\nexport type SimpleMeshLayerProps<DataT = any> = _SimpleMeshLayerProps<DataT> & LayerProps<DataT>;\n\nconst defaultProps: DefaultProps<SimpleMeshLayerProps> = {\n  mesh: {type: 'object', value: null, async: true},\n  texture: {type: 'image', value: null, async: true},\n  sizeScale: {type: 'number', value: 1, min: 0},\n  // Whether the color attribute in a mesh will be used\n  // This prop will be removed and set to true in next major release\n  _useMeshColors: {type: 'boolean', value: false},\n\n  // _instanced is a hack to use world position instead of meter offsets in mesh\n  // TODO - formalize API\n  _instanced: true,\n  // NOTE(Tarek): Quick and dirty wireframe. Just draws\n  // the same mesh with LINE_STRIPS. Won't follow edges\n  // of the original mesh.\n  wireframe: false,\n  // Optional material for 'lighting' shader module\n  material: true,\n  getPosition: {type: 'accessor', value: x => x.position},\n  getColor: {type: 'accessor', value: DEFAULT_COLOR},\n\n  // yaw, pitch and roll are in degrees\n  // https://en.wikipedia.org/wiki/Euler_angles\n  // [pitch, yaw, roll]\n  getOrientation: {type: 'accessor', value: [0, 0, 0]},\n  getScale: {type: 'accessor', value: [1, 1, 1]},\n  getTranslation: {type: 'accessor', value: [0, 0, 0]},\n  // 4x4 matrix\n  getTransformMatrix: {type: 'accessor', value: []}\n};\n\n/** Render a number of instances of an arbitrary 3D geometry. */\nexport default class SimpleMeshLayer<DataT = any, ExtraPropsT = {}> extends Layer<\n  ExtraPropsT & Required<_SimpleMeshLayerProps<DataT>>\n> {\n  static defaultProps = defaultProps;\n  static layerName = 'SimpleMeshLayer';\n\n  state!: {\n    materialParser?: GLTFMaterialParser;\n    model?: Model;\n    emptyTexture: Texture2D;\n    hasNormals?: boolean;\n  };\n\n  getShaders() {\n    const transpileToGLSL100 = !isWebGL2(this.context.gl);\n\n    const defines: any = {};\n\n    if (hasFeature(this.context.gl, FEATURES.GLSL_DERIVATIVES)) {\n      defines.DERIVATIVES_AVAILABLE = 1;\n    }\n\n    return super.getShaders({\n      vs,\n      fs,\n      modules: [project32, phongLighting, picking],\n      transpileToGLSL100,\n      defines\n    });\n  }\n\n  initializeState() {\n    const attributeManager = this.getAttributeManager();\n    // attributeManager is always defined in a primitive layer\n    attributeManager!.addInstanced({\n      instancePositions: {\n        transition: true,\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions(),\n        size: 3,\n        accessor: 'getPosition'\n      },\n      instanceColors: {\n        type: GL.UNSIGNED_BYTE,\n        transition: true,\n        size: this.props.colorFormat.length,\n        normalized: true,\n        accessor: 'getColor',\n        defaultValue: [0, 0, 0, 255]\n      },\n      instanceModelMatrix: MATRIX_ATTRIBUTES\n    });\n\n    this.setState({\n      // Avoid luma.gl's missing uniform warning\n      // TODO - add feature to luma.gl to specify ignored uniforms?\n      emptyTexture: new Texture2D(this.context.gl, {\n        data: new Uint8Array(4),\n        width: 1,\n        height: 1\n      })\n    });\n  }\n\n  updateState(params: UpdateParameters<this>) {\n    super.updateState(params);\n\n    const {props, oldProps, changeFlags} = params;\n    if (props.mesh !== oldProps.mesh || changeFlags.extensionsChanged) {\n      this.state.model?.delete();\n      if (props.mesh) {\n        this.state.model = this.getModel(props.mesh as Mesh);\n\n        const attributes = (props.mesh as any).attributes || props.mesh;\n        this.setState({\n          hasNormals: Boolean(attributes.NORMAL || attributes.normals)\n        });\n      }\n      // attributeManager is always defined in a primitive layer\n      this.getAttributeManager()!.invalidateAll();\n    }\n\n    if (props.texture !== oldProps.texture) {\n      this.setTexture(props.texture);\n    }\n\n    if (this.state.model) {\n      this.state.model.setDrawMode(this.props.wireframe ? GL.LINE_STRIP : GL.TRIANGLES);\n    }\n  }\n\n  finalizeState(context: LayerContext) {\n    super.finalizeState(context);\n\n    this.state.emptyTexture.delete();\n  }\n\n  draw({uniforms}) {\n    if (!this.state.model) {\n      return;\n    }\n\n    const {viewport} = this.context;\n    const {sizeScale, coordinateSystem, _instanced} = this.props;\n\n    this.state.model\n      .setUniforms(uniforms)\n      .setUniforms({\n        sizeScale,\n        composeModelMatrix: !_instanced || shouldComposeModelMatrix(viewport, coordinateSystem),\n        flatShading: !this.state.hasNormals\n      })\n      .draw();\n  }\n\n  protected getModel(mesh: Mesh): Model {\n    const model = new Model(this.context.gl, {\n      ...this.getShaders(),\n      id: this.props.id,\n      geometry: getGeometry(mesh, this.props._useMeshColors),\n      isInstanced: true\n    });\n\n    const {texture} = this.props;\n    const {emptyTexture} = this.state;\n    model.setUniforms({\n      sampler: texture || emptyTexture,\n      hasTexture: Boolean(texture)\n    });\n\n    return model;\n  }\n\n  private setTexture(texture: Texture2D): void {\n    const {emptyTexture, model} = this.state;\n\n    // props.mesh may not be ready at this time.\n    // The sampler will be set when `getModel` is called\n    if (model) {\n      model.setUniforms({\n        sampler: texture || emptyTexture,\n        hasTexture: Boolean(texture)\n      });\n    }\n  }\n}\n","export default `#version 300 es\n#define SHADER_NAME simple-mesh-layer-vs\n\n// Scale the model\nuniform float sizeScale;\nuniform bool composeModelMatrix;\n\n// Primitive attributes\nin vec3 positions;\nin vec3 normals;\nin vec3 colors;\nin vec2 texCoords;\n\n// Instance attributes\nin vec3 instancePositions;\nin vec3 instancePositions64Low;\nin vec4 instanceColors;\nin vec3 instancePickingColors;\nin mat3 instanceModelMatrix;\nin vec3 instanceTranslation;\n\n// Outputs to fragment shader\nout vec2 vTexCoord;\nout vec3 cameraPosition;\nout vec3 normals_commonspace;\nout vec4 position_commonspace;\nout vec4 vColor;\n\nvoid main(void) {\n  geometry.worldPosition = instancePositions;\n  geometry.uv = texCoords;\n  geometry.pickingColor = instancePickingColors;\n\n  vTexCoord = texCoords;\n  cameraPosition = project_uCameraPosition;\n  vColor = vec4(colors * instanceColors.rgb, instanceColors.a);\n\n  vec3 pos = (instanceModelMatrix * positions) * sizeScale + instanceTranslation;\n\n  if (composeModelMatrix) {\n    DECKGL_FILTER_SIZE(pos, geometry);\n    // using instancePositions as world coordinates\n    // when using globe mode, this branch does not re-orient the model to align with the surface of the earth\n    // call project_normal before setting position to avoid rotation\n    normals_commonspace = project_normal(instanceModelMatrix * normals);\n    gl_Position = project_position_to_clipspace(pos + instancePositions, instancePositions64Low, vec3(0.0), position_commonspace);\n    geometry.position = position_commonspace;\n  }\n  else {\n    pos = project_size(pos);\n    DECKGL_FILTER_SIZE(pos, geometry);\n    gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, pos, position_commonspace);\n    geometry.position = position_commonspace;\n    normals_commonspace = project_normal(instanceModelMatrix * normals);\n  }\n\n  geometry.normal = normals_commonspace;\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n`;\n","export default `#version 300 es\n#define SHADER_NAME simple-mesh-layer-fs\n\nprecision highp float;\n\nuniform bool hasTexture;\nuniform sampler2D sampler;\nuniform bool flatShading;\nuniform float opacity;\n\nin vec2 vTexCoord;\nin vec3 cameraPosition;\nin vec3 normals_commonspace;\nin vec4 position_commonspace;\nin vec4 vColor;\n\nout vec4 fragColor;\n\nvoid main(void) {\n  geometry.uv = vTexCoord;\n\n  vec3 normal;\n  if (flatShading) {\n\n// NOTE(Tarek): This is necessary because\n// headless.gl reports the extension as\n// available but does not support it in\n// the shader.\n#ifdef DERIVATIVES_AVAILABLE\n    normal = normalize(cross(dFdx(position_commonspace.xyz), dFdy(position_commonspace.xyz)));\n#else\n    normal = vec3(0.0, 0.0, 1.0);\n#endif\n  } else {\n    normal = normals_commonspace;\n  }\n\n  vec4 color = hasTexture ? texture(sampler, vTexCoord) : vColor;\n  vec3 lightColor = lighting_getLightColor(color.rgb, cameraPosition, position_commonspace.xyz, normal);\n  fragColor = vec4(lightColor, color.a * opacity);\n\n  DECKGL_FILTER_COLOR(fragColor, geometry);\n}\n`;\n","const DEFAULT_HIGHLIGHT_COLOR = new Uint8Array([0, 255, 255, 255]);\nconst DEFAULT_MODULE_OPTIONS = {\n  pickingSelectedColor: null,\n  pickingHighlightColor: DEFAULT_HIGHLIGHT_COLOR,\n  pickingActive: false,\n  pickingAttribute: false\n};\n\nfunction getUniforms() {\n  let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : DEFAULT_MODULE_OPTIONS;\n  const uniforms = {};\n\n  if (opts.pickingSelectedColor !== undefined) {\n    if (!opts.pickingSelectedColor) {\n      uniforms.picking_uSelectedColorValid = 0;\n    } else {\n      const selectedColor = opts.pickingSelectedColor.slice(0, 3);\n      uniforms.picking_uSelectedColorValid = 1;\n      uniforms.picking_uSelectedColor = selectedColor;\n    }\n  }\n\n  if (opts.pickingHighlightColor) {\n    const color = Array.from(opts.pickingHighlightColor, x => x / 255);\n\n    if (!Number.isFinite(color[3])) {\n      color[3] = 1;\n    }\n\n    uniforms.picking_uHighlightColor = color;\n  }\n\n  if (opts.pickingActive !== undefined) {\n    uniforms.picking_uActive = Boolean(opts.pickingActive);\n    uniforms.picking_uAttribute = Boolean(opts.pickingAttribute);\n  }\n\n  return uniforms;\n}\n\nconst vs = \"uniform bool picking_uActive;\\nuniform bool picking_uAttribute;\\nuniform vec3 picking_uSelectedColor;\\nuniform bool picking_uSelectedColorValid;\\n\\nout vec4 picking_vRGBcolor_Avalid;\\n\\nconst float COLOR_SCALE = 1. / 255.;\\n\\nbool picking_isColorValid(vec3 color) {\\n  return dot(color, vec3(1.0)) > 0.001;\\n}\\n\\nbool isVertexPicked(vec3 vertexColor) {\\n  return\\n    picking_uSelectedColorValid &&\\n    !picking_isColorValid(abs(vertexColor - picking_uSelectedColor));\\n}\\n\\nvoid picking_setPickingColor(vec3 pickingColor) {\\n  if (picking_uActive) {\\n    picking_vRGBcolor_Avalid.a = float(picking_isColorValid(pickingColor));\\n\\n    if (!picking_uAttribute) {\\n      picking_vRGBcolor_Avalid.rgb = pickingColor * COLOR_SCALE;\\n    }\\n  } else {\\n    picking_vRGBcolor_Avalid.a = float(isVertexPicked(pickingColor));\\n  }\\n}\\n\\nvoid picking_setPickingAttribute(float value) {\\n  if (picking_uAttribute) {\\n    picking_vRGBcolor_Avalid.r = value;\\n  }\\n}\\nvoid picking_setPickingAttribute(vec2 value) {\\n  if (picking_uAttribute) {\\n    picking_vRGBcolor_Avalid.rg = value;\\n  }\\n}\\nvoid picking_setPickingAttribute(vec3 value) {\\n  if (picking_uAttribute) {\\n    picking_vRGBcolor_Avalid.rgb = value;\\n  }\\n}\\n\";\nconst fs = \"uniform bool picking_uActive;\\nuniform vec3 picking_uSelectedColor;\\nuniform vec4 picking_uHighlightColor;\\n\\nin vec4 picking_vRGBcolor_Avalid;\\nvec4 picking_filterHighlightColor(vec4 color) {\\n  if (picking_uActive) {\\n    return color;\\n  }\\n  bool selected = bool(picking_vRGBcolor_Avalid.a);\\n\\n  if (selected) {\\n    float highLightAlpha = picking_uHighlightColor.a;\\n    float blendedAlpha = highLightAlpha + color.a * (1.0 - highLightAlpha);\\n    float highLightRatio = highLightAlpha / blendedAlpha;\\n\\n    vec3 blendedRGB = mix(color.rgb, picking_uHighlightColor.rgb, highLightRatio);\\n    return vec4(blendedRGB, blendedAlpha);\\n  } else {\\n    return color;\\n  }\\n}\\nvec4 picking_filterPickingColor(vec4 color) {\\n  if (picking_uActive) {\\n    if (picking_vRGBcolor_Avalid.a == 0.0) {\\n      discard;\\n    }\\n    return picking_vRGBcolor_Avalid;\\n  }\\n  return color;\\n}\\nvec4 picking_filterColor(vec4 color) {\\n  vec4 highightColor = picking_filterHighlightColor(color);\\n  return picking_filterPickingColor(highightColor);\\n}\\n\\n\";\nexport const picking = {\n  name: 'picking',\n  vs,\n  fs,\n  getUniforms\n};\n//# sourceMappingURL=picking.js.map","import {picking} from '@luma.gl/core';\nimport type {ShaderModule} from '../../types/types';\n\ntype PickingModuleSettings = {\n  /** Set to a picking color to visually highlight that item */\n  pickingSelectedColor?: [number, number, number] | null;\n  /** Color of the highlight */\n  pickingHighlightColor?: [number, number, number, number];\n  /** Set to true when rendering to off-screen \"picking\" buffer */\n  pickingActive?: boolean;\n  /** Set to true when picking an attribute value instead of object index */\n  pickingAttribute?: boolean;\n};\n\nexport default {\n  inject: {\n    'vs:DECKGL_FILTER_GL_POSITION': `\n    // for picking depth values\n    picking_setPickingAttribute(position.z / position.w);\n  `,\n    'vs:DECKGL_FILTER_COLOR': `\n  picking_setPickingColor(geometry.pickingColor);\n  `,\n    'fs:DECKGL_FILTER_COLOR': {\n      order: 99,\n      injection: `\n  // use highlight color if this fragment belongs to the selected object.\n  color = picking_filterHighlightColor(color);\n\n  // use picking color if rendering to picking FBO.\n  color = picking_filterPickingColor(color);\n    `\n    }\n  },\n  ...picking\n} as ShaderModule<PickingModuleSettings>;\n","export default \"\\nuniform float lighting_uAmbient;\\nuniform float lighting_uDiffuse;\\nuniform float lighting_uShininess;\\nuniform vec3  lighting_uSpecularColor;\\n\\nvec3 lighting_getLightColor(vec3 surfaceColor, vec3 light_direction, vec3 view_direction, vec3 normal_worldspace, vec3 color) {\\n    vec3 halfway_direction = normalize(light_direction + view_direction);\\n    float lambertian = dot(light_direction, normal_worldspace);\\n    float specular = 0.0;\\n    if (lambertian > 0.0) {\\n      float specular_angle = max(dot(normal_worldspace, halfway_direction), 0.0);\\n      specular = pow(specular_angle, lighting_uShininess);\\n    }\\n    lambertian = max(lambertian, 0.0);\\n    return (lambertian * lighting_uDiffuse * surfaceColor + specular * lighting_uSpecularColor) * color;\\n}\\n\\nvec3 lighting_getLightColor(vec3 surfaceColor, vec3 cameraPosition, vec3 position_worldspace, vec3 normal_worldspace) {\\n  vec3 lightColor = surfaceColor;\\n\\n  if (lighting_uEnabled) {\\n    vec3 view_direction = normalize(cameraPosition - position_worldspace);\\n    lightColor = lighting_uAmbient * surfaceColor * lighting_uAmbientLight.color;\\n\\n    for (int i = 0; i < MAX_LIGHTS; i++) {\\n      if (i >= lighting_uPointLightCount) {\\n        break;\\n      }\\n      PointLight pointLight = lighting_uPointLight[i];\\n      vec3 light_position_worldspace = pointLight.position;\\n      vec3 light_direction = normalize(light_position_worldspace - position_worldspace);\\n      lightColor += lighting_getLightColor(surfaceColor, light_direction, view_direction, normal_worldspace, pointLight.color);\\n    }\\n\\n    for (int i = 0; i < MAX_LIGHTS; i++) {\\n      if (i >= lighting_uDirectionalLightCount) {\\n        break;\\n      }\\n      DirectionalLight directionalLight = lighting_uDirectionalLight[i];\\n      lightColor += lighting_getLightColor(surfaceColor, -directionalLight.direction, view_direction, normal_worldspace, directionalLight.color);\\n    }\\n  }\\n  return lightColor;\\n}\\n\\nvec3 lighting_getSpecularLightColor(vec3 cameraPosition, vec3 position_worldspace, vec3 normal_worldspace) {\\n  vec3 lightColor = vec3(0, 0, 0);\\n  vec3 surfaceColor = vec3(0, 0, 0);\\n\\n  if (lighting_uEnabled) {\\n    vec3 view_direction = normalize(cameraPosition - position_worldspace);\\n\\n    for (int i = 0; i < MAX_LIGHTS; i++) {\\n      if (i >= lighting_uPointLightCount) {\\n        break;\\n      }\\n      PointLight pointLight = lighting_uPointLight[i];\\n      vec3 light_position_worldspace = pointLight.position;\\n      vec3 light_direction = normalize(light_position_worldspace - position_worldspace);\\n      lightColor += lighting_getLightColor(surfaceColor, light_direction, view_direction, normal_worldspace, pointLight.color);\\n    }\\n\\n    for (int i = 0; i < MAX_LIGHTS; i++) {\\n      if (i >= lighting_uDirectionalLightCount) {\\n        break;\\n      }\\n      DirectionalLight directionalLight = lighting_uDirectionalLight[i];\\n      lightColor += lighting_getLightColor(surfaceColor, -directionalLight.direction, view_direction, normal_worldspace, directionalLight.color);\\n    }\\n  }\\n  return lightColor;\\n}\\n\";\n//# sourceMappingURL=phong-lighting.glsl.js.map","import { lights } from '../lights/lights';\nimport lightingShader from './phong-lighting.glsl';\nconst INITIAL_MODULE_OPTIONS = {};\n\nfunction getMaterialUniforms(material) {\n  const {\n    ambient = 0.35,\n    diffuse = 0.6,\n    shininess = 32,\n    specularColor = [30, 30, 30]\n  } = material;\n  return {\n    lighting_uAmbient: ambient,\n    lighting_uDiffuse: diffuse,\n    lighting_uShininess: shininess,\n    lighting_uSpecularColor: specularColor.map(x => x / 255)\n  };\n}\n\nfunction getUniforms() {\n  let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : INITIAL_MODULE_OPTIONS;\n\n  if (!('material' in opts)) {\n    return {};\n  }\n\n  const {\n    material\n  } = opts;\n\n  if (!material) {\n    return {\n      lighting_uEnabled: false\n    };\n  }\n\n  return getMaterialUniforms(material);\n}\n\nexport const gouraudLighting = {\n  name: 'gouraud-lighting',\n  dependencies: [lights],\n  vs: lightingShader,\n  defines: {\n    LIGHTING_VERTEX: 1\n  },\n  getUniforms\n};\nexport const phongLighting = {\n  name: 'phong-lighting',\n  dependencies: [lights],\n  fs: lightingShader,\n  defines: {\n    LIGHTING_FRAGMENT: 1\n  },\n  getUniforms\n};\n//# sourceMappingURL=phong-lighting.js.map","import Texture2D from '../classes/texture-2d';\nimport TextureCube from '../classes/texture-cube';\nimport Texture3D from '../classes/texture-3d';\nimport Framebuffer from '../classes/framebuffer';\nimport { assert } from '../utils/assert';\nexport function cloneTextureFrom(refTexture, overrides) {\n  assert(refTexture instanceof Texture2D || refTexture instanceof TextureCube || refTexture instanceof Texture3D);\n  const TextureType = refTexture.constructor;\n  const {\n    gl,\n    width,\n    height,\n    format,\n    type,\n    dataFormat,\n    border,\n    mipmaps\n  } = refTexture;\n  const textureOptions = Object.assign({\n    width,\n    height,\n    format,\n    type,\n    dataFormat,\n    border,\n    mipmaps\n  }, overrides);\n  return new TextureType(gl, textureOptions);\n}\nexport function toFramebuffer(texture, opts) {\n  const {\n    gl,\n    width,\n    height,\n    id\n  } = texture;\n  const framebuffer = new Framebuffer(gl, Object.assign({}, opts, {\n    id: \"framebuffer-for-\".concat(id),\n    width,\n    height,\n    attachments: {\n      [36064]: texture\n    }\n  }));\n  return framebuffer;\n}\n//# sourceMappingURL=texture-utils.js.map","import { log, assertWebGLContext } from '@luma.gl/gltools';\nimport Texture from './texture';\nconst FACES = [34069, 34070, 34071, 34072, 34073, 34074];\nexport default class TextureCube extends Texture {\n  get [Symbol.toStringTag]() {\n    return 'TextureCube';\n  }\n\n  constructor(gl) {\n    let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    assertWebGLContext(gl);\n    super(gl, Object.assign({}, props, {\n      target: 34067\n    }));\n    this.initialize(props);\n    Object.seal(this);\n  }\n\n  initialize() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      mipmaps = true,\n      parameters = {}\n    } = props;\n    this.opts = props;\n    this.setCubeMapImageData(props).then(() => {\n      this.loaded = true;\n\n      if (mipmaps) {\n        this.generateMipmap(props);\n      }\n\n      this.setParameters(parameters);\n    });\n    return this;\n  }\n\n  subImage(_ref) {\n    let {\n      face,\n      data,\n      x = 0,\n      y = 0,\n      mipmapLevel = 0\n    } = _ref;\n    return this._subImage({\n      target: face,\n      data,\n      x,\n      y,\n      mipmapLevel\n    });\n  }\n\n  async setCubeMapImageData(_ref2) {\n    let {\n      width,\n      height,\n      pixels,\n      data,\n      border = 0,\n      format = 6408,\n      type = 5121\n    } = _ref2;\n    const {\n      gl\n    } = this;\n    const imageDataMap = pixels || data;\n    const resolvedFaces = await Promise.all(FACES.map(face => {\n      const facePixels = imageDataMap[face];\n      return Promise.all(Array.isArray(facePixels) ? facePixels : [facePixels]);\n    }));\n    this.bind();\n    FACES.forEach((face, index) => {\n      if (resolvedFaces[index].length > 1 && this.opts.mipmaps !== false) {\n        log.warn(\"\".concat(this.id, \" has mipmap and multiple LODs.\"))();\n      }\n\n      resolvedFaces[index].forEach((image, lodLevel) => {\n        if (width && height) {\n          gl.texImage2D(face, lodLevel, format, width, height, border, format, type, image);\n        } else {\n          gl.texImage2D(face, lodLevel, format, format, type, image);\n        }\n      });\n    });\n    this.unbind();\n  }\n\n  setImageDataForFace(options) {\n    const {\n      face,\n      width,\n      height,\n      pixels,\n      data,\n      border = 0,\n      format = 6408,\n      type = 5121\n    } = options;\n    const {\n      gl\n    } = this;\n    const imageData = pixels || data;\n    this.bind();\n\n    if (imageData instanceof Promise) {\n      imageData.then(resolvedImageData => this.setImageDataForFace(Object.assign({}, options, {\n        face,\n        data: resolvedImageData,\n        pixels: resolvedImageData\n      })));\n    } else if (this.width || this.height) {\n      gl.texImage2D(face, 0, format, width, height, border, format, type, imageData);\n    } else {\n      gl.texImage2D(face, 0, format, format, type, imageData);\n    }\n\n    return this;\n  }\n\n}\nTextureCube.FACES = FACES;\n//# sourceMappingURL=texture-cube.js.map","import { isWebGL2, assertWebGL2Context, withParameters } from '@luma.gl/gltools';\nimport Texture from './texture';\nimport { DATA_FORMAT_CHANNELS, TYPE_SIZES } from './texture-formats';\nimport Buffer from './buffer';\nexport default class Texture3D extends Texture {\n  get [Symbol.toStringTag]() {\n    return 'Texture3D';\n  }\n\n  static isSupported(gl) {\n    return isWebGL2(gl);\n  }\n\n  constructor(gl) {\n    let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    assertWebGL2Context(gl);\n    props = Object.assign({\n      depth: 1\n    }, props, {\n      target: 32879,\n      unpackFlipY: false\n    });\n    super(gl, props);\n    this.initialize(props);\n    Object.seal(this);\n  }\n\n  setImageData(_ref) {\n    let {\n      level = 0,\n      dataFormat = 6408,\n      width,\n      height,\n      depth = 1,\n      border = 0,\n      format,\n      type = 5121,\n      offset = 0,\n      data,\n      parameters = {}\n    } = _ref;\n\n    this._trackDeallocatedMemory('Texture');\n\n    this.gl.bindTexture(this.target, this.handle);\n    withParameters(this.gl, parameters, () => {\n      if (ArrayBuffer.isView(data)) {\n        this.gl.texImage3D(this.target, level, dataFormat, width, height, depth, border, format, type, data);\n      }\n\n      if (data instanceof Buffer) {\n        this.gl.bindBuffer(35052, data.handle);\n        this.gl.texImage3D(this.target, level, dataFormat, width, height, depth, border, format, type, offset);\n      }\n    });\n\n    if (data && data.byteLength) {\n      this._trackAllocatedMemory(data.byteLength, 'Texture');\n    } else {\n      const channels = DATA_FORMAT_CHANNELS[this.dataFormat] || 4;\n      const channelSize = TYPE_SIZES[this.type] || 1;\n\n      this._trackAllocatedMemory(this.width * this.height * this.depth * channels * channelSize, 'Texture');\n    }\n\n    this.loaded = true;\n    return this;\n  }\n\n}\n//# sourceMappingURL=texture-3d.js.map","import isElectron from './is-electron';\nexport default function isBrowser() {\n  const isNode = typeof process === 'object' && String(process) === '[object process]' && !process.browser;\n  return !isNode || isElectron();\n}\nexport function isBrowserMainThread() {\n  return isBrowser() && typeof document !== 'undefined';\n}\n//# sourceMappingURL=is-browser.js.map","export default function isElectron(mockUserAgent) {\n  if (typeof window !== 'undefined' && typeof window.process === 'object' && window.process.type === 'renderer') {\n    return true;\n  }\n\n  if (typeof process !== 'undefined' && typeof process.versions === 'object' && Boolean(process.versions.electron)) {\n    return true;\n  }\n\n  const realUserAgent = typeof navigator === 'object' && typeof navigator.userAgent === 'string' && navigator.userAgent;\n  const userAgent = mockUserAgent || realUserAgent;\n\n  if (userAgent && userAgent.indexOf('Electron') >= 0) {\n    return true;\n  }\n\n  return false;\n}\n//# sourceMappingURL=is-electron.js.map","function _asyncIterator(iterable) {\n  var method;\n\n  if (typeof Symbol !== \"undefined\") {\n    if (Symbol.asyncIterator) {\n      method = iterable[Symbol.asyncIterator];\n      if (method != null) return method.call(iterable);\n    }\n\n    if (Symbol.iterator) {\n      method = iterable[Symbol.iterator];\n      if (method != null) return method.call(iterable);\n    }\n  }\n\n  throw new TypeError(\"Object is not async iterable\");\n}\n\nmodule.exports = _asyncIterator;","import _classCallCheck from \"@babel/runtime/helpers/esm/classCallCheck\";\nimport _createClass from \"@babel/runtime/helpers/esm/createClass\";\nimport _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport PropTypes from 'prop-types';\nimport { document } from '../utils/globals';\n\nfunction noop() {}\n\nfunction defaultOnError(event) {\n  if (event) {\n    console.error(event.error);\n  }\n}\n\nvar propTypes = {\n  container: PropTypes.object,\n  gl: PropTypes.object,\n  mapboxApiAccessToken: PropTypes.string,\n  mapboxApiUrl: PropTypes.string,\n  attributionControl: PropTypes.bool,\n  preserveDrawingBuffer: PropTypes.bool,\n  reuseMaps: PropTypes.bool,\n  transformRequest: PropTypes.func,\n  mapOptions: PropTypes.object,\n  mapStyle: PropTypes.oneOfType([PropTypes.string, PropTypes.object]),\n  visible: PropTypes.bool,\n  asyncRender: PropTypes.bool,\n  onLoad: PropTypes.func,\n  onError: PropTypes.func,\n  width: PropTypes.number,\n  height: PropTypes.number,\n  viewState: PropTypes.object,\n  longitude: PropTypes.number,\n  latitude: PropTypes.number,\n  zoom: PropTypes.number,\n  bearing: PropTypes.number,\n  pitch: PropTypes.number,\n  altitude: PropTypes.number\n};\nvar defaultProps = {\n  container: document.body,\n  mapboxApiAccessToken: getAccessToken(),\n  mapboxApiUrl: 'https://api.mapbox.com',\n  preserveDrawingBuffer: false,\n  attributionControl: true,\n  reuseMaps: false,\n  mapOptions: {},\n  mapStyle: 'mapbox://styles/mapbox/light-v8',\n  visible: true,\n  asyncRender: false,\n  onLoad: noop,\n  onError: defaultOnError,\n  width: 0,\n  height: 0,\n  longitude: 0,\n  latitude: 0,\n  zoom: 0,\n  bearing: 0,\n  pitch: 0,\n  altitude: 1.5\n};\nexport function getAccessToken() {\n  var accessToken = null;\n\n  if (typeof window !== 'undefined' && window.location) {\n    var match = window.location.search.match(/access_token=([^&\\/]*)/);\n    accessToken = match && match[1];\n  }\n\n  if (!accessToken && typeof process !== 'undefined') {\n    accessToken = accessToken || process.env.MapboxAccessToken || process.env.REACT_APP_MAPBOX_ACCESS_TOKEN;\n  }\n\n  return accessToken || 'no-token';\n}\n\nfunction checkPropTypes(props) {\n  var component = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'component';\n\n  if (props.debug) {\n    PropTypes.checkPropTypes(propTypes, props, 'prop', component);\n  }\n}\n\nvar Mapbox = function () {\n  function Mapbox(props) {\n    var _this = this;\n\n    _classCallCheck(this, Mapbox);\n\n    _defineProperty(this, \"mapboxgl\", void 0);\n\n    _defineProperty(this, \"props\", defaultProps);\n\n    _defineProperty(this, \"_map\", null);\n\n    _defineProperty(this, \"width\", 0);\n\n    _defineProperty(this, \"height\", 0);\n\n    _defineProperty(this, \"_fireLoadEvent\", function () {\n      _this.props.onLoad({\n        type: 'load',\n        target: _this._map\n      });\n    });\n\n    if (!props.mapboxgl) {\n      throw new Error('Mapbox not available');\n    }\n\n    this.mapboxgl = props.mapboxgl;\n\n    if (!Mapbox.initialized) {\n      Mapbox.initialized = true;\n\n      this._checkStyleSheet(this.mapboxgl.version);\n    }\n\n    this._initialize(props);\n  }\n\n  _createClass(Mapbox, [{\n    key: \"finalize\",\n    value: function finalize() {\n      this._destroy();\n\n      return this;\n    }\n  }, {\n    key: \"setProps\",\n    value: function setProps(props) {\n      this._update(this.props, props);\n\n      return this;\n    }\n  }, {\n    key: \"resize\",\n    value: function resize() {\n      this._map.resize();\n\n      return this;\n    }\n  }, {\n    key: \"redraw\",\n    value: function redraw() {\n      var map = this._map;\n\n      if (map.style) {\n        if (map._frame) {\n          map._frame.cancel();\n\n          map._frame = null;\n        }\n\n        map._render();\n      }\n    }\n  }, {\n    key: \"getMap\",\n    value: function getMap() {\n      return this._map;\n    }\n  }, {\n    key: \"_reuse\",\n    value: function _reuse(props) {\n      this._map = Mapbox.savedMap;\n\n      var oldContainer = this._map.getContainer();\n\n      var newContainer = props.container;\n      newContainer.classList.add('mapboxgl-map');\n\n      while (oldContainer.childNodes.length > 0) {\n        newContainer.appendChild(oldContainer.childNodes[0]);\n      }\n\n      this._map._container = newContainer;\n      Mapbox.savedMap = null;\n\n      if (props.mapStyle) {\n        this._map.setStyle(props.mapStyle, {\n          diff: false\n        });\n      }\n\n      if (this._map.isStyleLoaded()) {\n        this._fireLoadEvent();\n      } else {\n        this._map.once('styledata', this._fireLoadEvent);\n      }\n    }\n  }, {\n    key: \"_create\",\n    value: function _create(props) {\n      if (props.reuseMaps && Mapbox.savedMap) {\n        this._reuse(props);\n      } else {\n        if (props.gl) {\n          var getContext = HTMLCanvasElement.prototype.getContext;\n\n          HTMLCanvasElement.prototype.getContext = function () {\n            HTMLCanvasElement.prototype.getContext = getContext;\n            return props.gl;\n          };\n        }\n\n        var mapOptions = {\n          container: props.container,\n          center: [0, 0],\n          zoom: 8,\n          pitch: 0,\n          bearing: 0,\n          maxZoom: 24,\n          style: props.mapStyle,\n          interactive: false,\n          trackResize: false,\n          attributionControl: props.attributionControl,\n          preserveDrawingBuffer: props.preserveDrawingBuffer\n        };\n\n        if (props.transformRequest) {\n          mapOptions.transformRequest = props.transformRequest;\n        }\n\n        this._map = new this.mapboxgl.Map(Object.assign({}, mapOptions, props.mapOptions));\n\n        this._map.once('load', props.onLoad);\n\n        this._map.on('error', props.onError);\n      }\n\n      return this;\n    }\n  }, {\n    key: \"_destroy\",\n    value: function _destroy() {\n      if (!this._map) {\n        return;\n      }\n\n      if (!Mapbox.savedMap) {\n        Mapbox.savedMap = this._map;\n\n        this._map.off('load', this.props.onLoad);\n\n        this._map.off('error', this.props.onError);\n\n        this._map.off('styledata', this._fireLoadEvent);\n      } else {\n        this._map.remove();\n      }\n\n      this._map = null;\n    }\n  }, {\n    key: \"_initialize\",\n    value: function _initialize(props) {\n      var _this2 = this;\n\n      props = Object.assign({}, defaultProps, props);\n      checkPropTypes(props, 'Mapbox');\n      this.mapboxgl.accessToken = props.mapboxApiAccessToken || defaultProps.mapboxApiAccessToken;\n      this.mapboxgl.baseApiUrl = props.mapboxApiUrl;\n\n      this._create(props);\n\n      var _props = props,\n          container = _props.container;\n      Object.defineProperty(container, 'offsetWidth', {\n        get: function get() {\n          return _this2.width;\n        }\n      });\n      Object.defineProperty(container, 'clientWidth', {\n        get: function get() {\n          return _this2.width;\n        }\n      });\n      Object.defineProperty(container, 'offsetHeight', {\n        get: function get() {\n          return _this2.height;\n        }\n      });\n      Object.defineProperty(container, 'clientHeight', {\n        get: function get() {\n          return _this2.height;\n        }\n      });\n\n      var canvas = this._map.getCanvas();\n\n      if (canvas) {\n        canvas.style.outline = 'none';\n      }\n\n      this._updateMapViewport({}, props);\n\n      this._updateMapSize({}, props);\n\n      this.props = props;\n    }\n  }, {\n    key: \"_update\",\n    value: function _update(oldProps, newProps) {\n      if (!this._map) {\n        return;\n      }\n\n      newProps = Object.assign({}, this.props, newProps);\n      checkPropTypes(newProps, 'Mapbox');\n\n      var viewportChanged = this._updateMapViewport(oldProps, newProps);\n\n      var sizeChanged = this._updateMapSize(oldProps, newProps);\n\n      if (!newProps.asyncRender && (viewportChanged || sizeChanged)) {\n        this.redraw();\n      }\n\n      this.props = newProps;\n    }\n  }, {\n    key: \"_updateMapSize\",\n    value: function _updateMapSize(oldProps, newProps) {\n      var sizeChanged = oldProps.width !== newProps.width || oldProps.height !== newProps.height;\n\n      if (sizeChanged) {\n        this.width = newProps.width;\n        this.height = newProps.height;\n        this.resize();\n      }\n\n      return sizeChanged;\n    }\n  }, {\n    key: \"_updateMapViewport\",\n    value: function _updateMapViewport(oldProps, newProps) {\n      var oldViewState = this._getViewState(oldProps);\n\n      var newViewState = this._getViewState(newProps);\n\n      var viewportChanged = newViewState.latitude !== oldViewState.latitude || newViewState.longitude !== oldViewState.longitude || newViewState.zoom !== oldViewState.zoom || newViewState.pitch !== oldViewState.pitch || newViewState.bearing !== oldViewState.bearing || newViewState.altitude !== oldViewState.altitude;\n\n      if (viewportChanged) {\n        this._map.jumpTo(this._viewStateToMapboxProps(newViewState));\n\n        if (newViewState.altitude !== oldViewState.altitude) {\n          this._map.transform.altitude = newViewState.altitude;\n        }\n      }\n\n      return viewportChanged;\n    }\n  }, {\n    key: \"_getViewState\",\n    value: function _getViewState(props) {\n      var _ref = props.viewState || props,\n          longitude = _ref.longitude,\n          latitude = _ref.latitude,\n          zoom = _ref.zoom,\n          _ref$pitch = _ref.pitch,\n          pitch = _ref$pitch === void 0 ? 0 : _ref$pitch,\n          _ref$bearing = _ref.bearing,\n          bearing = _ref$bearing === void 0 ? 0 : _ref$bearing,\n          _ref$altitude = _ref.altitude,\n          altitude = _ref$altitude === void 0 ? 1.5 : _ref$altitude;\n\n      return {\n        longitude: longitude,\n        latitude: latitude,\n        zoom: zoom,\n        pitch: pitch,\n        bearing: bearing,\n        altitude: altitude\n      };\n    }\n  }, {\n    key: \"_checkStyleSheet\",\n    value: function _checkStyleSheet() {\n      var mapboxVersion = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '0.47.0';\n\n      if (typeof document === 'undefined') {\n        return;\n      }\n\n      try {\n        var testElement = document.createElement('div');\n        testElement.className = 'mapboxgl-map';\n        testElement.style.display = 'none';\n        document.body.append(testElement);\n        var isCssLoaded = window.getComputedStyle(testElement).position !== 'static';\n\n        if (!isCssLoaded) {\n          var link = document.createElement('link');\n          link.setAttribute('rel', 'stylesheet');\n          link.setAttribute('type', 'text/css');\n          link.setAttribute('href', \"https://api.tiles.mapbox.com/mapbox-gl-js/v\".concat(mapboxVersion, \"/mapbox-gl.css\"));\n          document.head.append(link);\n        }\n      } catch (error) {}\n    }\n  }, {\n    key: \"_viewStateToMapboxProps\",\n    value: function _viewStateToMapboxProps(viewState) {\n      return {\n        center: [viewState.longitude, viewState.latitude],\n        zoom: viewState.zoom,\n        bearing: viewState.bearing,\n        pitch: viewState.pitch\n      };\n    }\n  }]);\n\n  return Mapbox;\n}();\n\n_defineProperty(Mapbox, \"initialized\", false);\n\n_defineProperty(Mapbox, \"propTypes\", propTypes);\n\n_defineProperty(Mapbox, \"defaultProps\", defaultProps);\n\n_defineProperty(Mapbox, \"savedMap\", null);\n\nexport { Mapbox as default };\n//# sourceMappingURL=mapbox.js.map","export default function _classCallCheck(instance, Constructor) {\n  if (!(instance instanceof Constructor)) {\n    throw new TypeError(\"Cannot call a class as a function\");\n  }\n}","function _defineProperties(target, props) {\n  for (var i = 0; i < props.length; i++) {\n    var descriptor = props[i];\n    descriptor.enumerable = descriptor.enumerable || false;\n    descriptor.configurable = true;\n    if (\"value\" in descriptor) descriptor.writable = true;\n    Object.defineProperty(target, descriptor.key, descriptor);\n  }\n}\n\nexport default function _createClass(Constructor, protoProps, staticProps) {\n  if (protoProps) _defineProperties(Constructor.prototype, protoProps);\n  if (staticProps) _defineProperties(Constructor, staticProps);\n  return Constructor;\n}","'use strict';\n\nmodule.exports = earcut;\nmodule.exports.default = earcut;\n\nfunction earcut(data, holeIndices, dim) {\n\n    dim = dim || 2;\n\n    var hasHoles = holeIndices && holeIndices.length,\n        outerLen = hasHoles ? holeIndices[0] * dim : data.length,\n        outerNode = linkedList(data, 0, outerLen, dim, true),\n        triangles = [];\n\n    if (!outerNode || outerNode.next === outerNode.prev) return triangles;\n\n    var minX, minY, maxX, maxY, x, y, invSize;\n\n    if (hasHoles) outerNode = eliminateHoles(data, holeIndices, outerNode, dim);\n\n    // if the shape is not too simple, we'll use z-order curve hash later; calculate polygon bbox\n    if (data.length > 80 * dim) {\n        minX = maxX = data[0];\n        minY = maxY = data[1];\n\n        for (var i = dim; i < outerLen; i += dim) {\n            x = data[i];\n            y = data[i + 1];\n            if (x < minX) minX = x;\n            if (y < minY) minY = y;\n            if (x > maxX) maxX = x;\n            if (y > maxY) maxY = y;\n        }\n\n        // minX, minY and invSize are later used to transform coords into integers for z-order calculation\n        invSize = Math.max(maxX - minX, maxY - minY);\n        invSize = invSize !== 0 ? 32767 / invSize : 0;\n    }\n\n    earcutLinked(outerNode, triangles, dim, minX, minY, invSize, 0);\n\n    return triangles;\n}\n\n// create a circular doubly linked list from polygon points in the specified winding order\nfunction linkedList(data, start, end, dim, clockwise) {\n    var i, last;\n\n    if (clockwise === (signedArea(data, start, end, dim) > 0)) {\n        for (i = start; i < end; i += dim) last = insertNode(i, data[i], data[i + 1], last);\n    } else {\n        for (i = end - dim; i >= start; i -= dim) last = insertNode(i, data[i], data[i + 1], last);\n    }\n\n    if (last && equals(last, last.next)) {\n        removeNode(last);\n        last = last.next;\n    }\n\n    return last;\n}\n\n// eliminate colinear or duplicate points\nfunction filterPoints(start, end) {\n    if (!start) return start;\n    if (!end) end = start;\n\n    var p = start,\n        again;\n    do {\n        again = false;\n\n        if (!p.steiner && (equals(p, p.next) || area(p.prev, p, p.next) === 0)) {\n            removeNode(p);\n            p = end = p.prev;\n            if (p === p.next) break;\n            again = true;\n\n        } else {\n            p = p.next;\n        }\n    } while (again || p !== end);\n\n    return end;\n}\n\n// main ear slicing loop which triangulates a polygon (given as a linked list)\nfunction earcutLinked(ear, triangles, dim, minX, minY, invSize, pass) {\n    if (!ear) return;\n\n    // interlink polygon nodes in z-order\n    if (!pass && invSize) indexCurve(ear, minX, minY, invSize);\n\n    var stop = ear,\n        prev, next;\n\n    // iterate through ears, slicing them one by one\n    while (ear.prev !== ear.next) {\n        prev = ear.prev;\n        next = ear.next;\n\n        if (invSize ? isEarHashed(ear, minX, minY, invSize) : isEar(ear)) {\n            // cut off the triangle\n            triangles.push(prev.i / dim | 0);\n            triangles.push(ear.i / dim | 0);\n            triangles.push(next.i / dim | 0);\n\n            removeNode(ear);\n\n            // skipping the next vertex leads to less sliver triangles\n            ear = next.next;\n            stop = next.next;\n\n            continue;\n        }\n\n        ear = next;\n\n        // if we looped through the whole remaining polygon and can't find any more ears\n        if (ear === stop) {\n            // try filtering points and slicing again\n            if (!pass) {\n                earcutLinked(filterPoints(ear), triangles, dim, minX, minY, invSize, 1);\n\n            // if this didn't work, try curing all small self-intersections locally\n            } else if (pass === 1) {\n                ear = cureLocalIntersections(filterPoints(ear), triangles, dim);\n                earcutLinked(ear, triangles, dim, minX, minY, invSize, 2);\n\n            // as a last resort, try splitting the remaining polygon into two\n            } else if (pass === 2) {\n                splitEarcut(ear, triangles, dim, minX, minY, invSize);\n            }\n\n            break;\n        }\n    }\n}\n\n// check whether a polygon node forms a valid ear with adjacent nodes\nfunction isEar(ear) {\n    var a = ear.prev,\n        b = ear,\n        c = ear.next;\n\n    if (area(a, b, c) >= 0) return false; // reflex, can't be an ear\n\n    // now make sure we don't have other points inside the potential ear\n    var ax = a.x, bx = b.x, cx = c.x, ay = a.y, by = b.y, cy = c.y;\n\n    // triangle bbox; min & max are calculated like this for speed\n    var x0 = ax < bx ? (ax < cx ? ax : cx) : (bx < cx ? bx : cx),\n        y0 = ay < by ? (ay < cy ? ay : cy) : (by < cy ? by : cy),\n        x1 = ax > bx ? (ax > cx ? ax : cx) : (bx > cx ? bx : cx),\n        y1 = ay > by ? (ay > cy ? ay : cy) : (by > cy ? by : cy);\n\n    var p = c.next;\n    while (p !== a) {\n        if (p.x >= x0 && p.x <= x1 && p.y >= y0 && p.y <= y1 &&\n            pointInTriangle(ax, ay, bx, by, cx, cy, p.x, p.y) &&\n            area(p.prev, p, p.next) >= 0) return false;\n        p = p.next;\n    }\n\n    return true;\n}\n\nfunction isEarHashed(ear, minX, minY, invSize) {\n    var a = ear.prev,\n        b = ear,\n        c = ear.next;\n\n    if (area(a, b, c) >= 0) return false; // reflex, can't be an ear\n\n    var ax = a.x, bx = b.x, cx = c.x, ay = a.y, by = b.y, cy = c.y;\n\n    // triangle bbox; min & max are calculated like this for speed\n    var x0 = ax < bx ? (ax < cx ? ax : cx) : (bx < cx ? bx : cx),\n        y0 = ay < by ? (ay < cy ? ay : cy) : (by < cy ? by : cy),\n        x1 = ax > bx ? (ax > cx ? ax : cx) : (bx > cx ? bx : cx),\n        y1 = ay > by ? (ay > cy ? ay : cy) : (by > cy ? by : cy);\n\n    // z-order range for the current triangle bbox;\n    var minZ = zOrder(x0, y0, minX, minY, invSize),\n        maxZ = zOrder(x1, y1, minX, minY, invSize);\n\n    var p = ear.prevZ,\n        n = ear.nextZ;\n\n    // look for points inside the triangle in both directions\n    while (p && p.z >= minZ && n && n.z <= maxZ) {\n        if (p.x >= x0 && p.x <= x1 && p.y >= y0 && p.y <= y1 && p !== a && p !== c &&\n            pointInTriangle(ax, ay, bx, by, cx, cy, p.x, p.y) && area(p.prev, p, p.next) >= 0) return false;\n        p = p.prevZ;\n\n        if (n.x >= x0 && n.x <= x1 && n.y >= y0 && n.y <= y1 && n !== a && n !== c &&\n            pointInTriangle(ax, ay, bx, by, cx, cy, n.x, n.y) && area(n.prev, n, n.next) >= 0) return false;\n        n = n.nextZ;\n    }\n\n    // look for remaining points in decreasing z-order\n    while (p && p.z >= minZ) {\n        if (p.x >= x0 && p.x <= x1 && p.y >= y0 && p.y <= y1 && p !== a && p !== c &&\n            pointInTriangle(ax, ay, bx, by, cx, cy, p.x, p.y) && area(p.prev, p, p.next) >= 0) return false;\n        p = p.prevZ;\n    }\n\n    // look for remaining points in increasing z-order\n    while (n && n.z <= maxZ) {\n        if (n.x >= x0 && n.x <= x1 && n.y >= y0 && n.y <= y1 && n !== a && n !== c &&\n            pointInTriangle(ax, ay, bx, by, cx, cy, n.x, n.y) && area(n.prev, n, n.next) >= 0) return false;\n        n = n.nextZ;\n    }\n\n    return true;\n}\n\n// go through all polygon nodes and cure small local self-intersections\nfunction cureLocalIntersections(start, triangles, dim) {\n    var p = start;\n    do {\n        var a = p.prev,\n            b = p.next.next;\n\n        if (!equals(a, b) && intersects(a, p, p.next, b) && locallyInside(a, b) && locallyInside(b, a)) {\n\n            triangles.push(a.i / dim | 0);\n            triangles.push(p.i / dim | 0);\n            triangles.push(b.i / dim | 0);\n\n            // remove two nodes involved\n            removeNode(p);\n            removeNode(p.next);\n\n            p = start = b;\n        }\n        p = p.next;\n    } while (p !== start);\n\n    return filterPoints(p);\n}\n\n// try splitting polygon into two and triangulate them independently\nfunction splitEarcut(start, triangles, dim, minX, minY, invSize) {\n    // look for a valid diagonal that divides the polygon into two\n    var a = start;\n    do {\n        var b = a.next.next;\n        while (b !== a.prev) {\n            if (a.i !== b.i && isValidDiagonal(a, b)) {\n                // split the polygon in two by the diagonal\n                var c = splitPolygon(a, b);\n\n                // filter colinear points around the cuts\n                a = filterPoints(a, a.next);\n                c = filterPoints(c, c.next);\n\n                // run earcut on each half\n                earcutLinked(a, triangles, dim, minX, minY, invSize, 0);\n                earcutLinked(c, triangles, dim, minX, minY, invSize, 0);\n                return;\n            }\n            b = b.next;\n        }\n        a = a.next;\n    } while (a !== start);\n}\n\n// link every hole into the outer loop, producing a single-ring polygon without holes\nfunction eliminateHoles(data, holeIndices, outerNode, dim) {\n    var queue = [],\n        i, len, start, end, list;\n\n    for (i = 0, len = holeIndices.length; i < len; i++) {\n        start = holeIndices[i] * dim;\n        end = i < len - 1 ? holeIndices[i + 1] * dim : data.length;\n        list = linkedList(data, start, end, dim, false);\n        if (list === list.next) list.steiner = true;\n        queue.push(getLeftmost(list));\n    }\n\n    queue.sort(compareX);\n\n    // process holes from left to right\n    for (i = 0; i < queue.length; i++) {\n        outerNode = eliminateHole(queue[i], outerNode);\n    }\n\n    return outerNode;\n}\n\nfunction compareX(a, b) {\n    return a.x - b.x;\n}\n\n// find a bridge between vertices that connects hole with an outer ring and and link it\nfunction eliminateHole(hole, outerNode) {\n    var bridge = findHoleBridge(hole, outerNode);\n    if (!bridge) {\n        return outerNode;\n    }\n\n    var bridgeReverse = splitPolygon(bridge, hole);\n\n    // filter collinear points around the cuts\n    filterPoints(bridgeReverse, bridgeReverse.next);\n    return filterPoints(bridge, bridge.next);\n}\n\n// David Eberly's algorithm for finding a bridge between hole and outer polygon\nfunction findHoleBridge(hole, outerNode) {\n    var p = outerNode,\n        hx = hole.x,\n        hy = hole.y,\n        qx = -Infinity,\n        m;\n\n    // find a segment intersected by a ray from the hole's leftmost point to the left;\n    // segment's endpoint with lesser x will be potential connection point\n    do {\n        if (hy <= p.y && hy >= p.next.y && p.next.y !== p.y) {\n            var x = p.x + (hy - p.y) * (p.next.x - p.x) / (p.next.y - p.y);\n            if (x <= hx && x > qx) {\n                qx = x;\n                m = p.x < p.next.x ? p : p.next;\n                if (x === hx) return m; // hole touches outer segment; pick leftmost endpoint\n            }\n        }\n        p = p.next;\n    } while (p !== outerNode);\n\n    if (!m) return null;\n\n    // look for points inside the triangle of hole point, segment intersection and endpoint;\n    // if there are no points found, we have a valid connection;\n    // otherwise choose the point of the minimum angle with the ray as connection point\n\n    var stop = m,\n        mx = m.x,\n        my = m.y,\n        tanMin = Infinity,\n        tan;\n\n    p = m;\n\n    do {\n        if (hx >= p.x && p.x >= mx && hx !== p.x &&\n                pointInTriangle(hy < my ? hx : qx, hy, mx, my, hy < my ? qx : hx, hy, p.x, p.y)) {\n\n            tan = Math.abs(hy - p.y) / (hx - p.x); // tangential\n\n            if (locallyInside(p, hole) &&\n                (tan < tanMin || (tan === tanMin && (p.x > m.x || (p.x === m.x && sectorContainsSector(m, p)))))) {\n                m = p;\n                tanMin = tan;\n            }\n        }\n\n        p = p.next;\n    } while (p !== stop);\n\n    return m;\n}\n\n// whether sector in vertex m contains sector in vertex p in the same coordinates\nfunction sectorContainsSector(m, p) {\n    return area(m.prev, m, p.prev) < 0 && area(p.next, m, m.next) < 0;\n}\n\n// interlink polygon nodes in z-order\nfunction indexCurve(start, minX, minY, invSize) {\n    var p = start;\n    do {\n        if (p.z === 0) p.z = zOrder(p.x, p.y, minX, minY, invSize);\n        p.prevZ = p.prev;\n        p.nextZ = p.next;\n        p = p.next;\n    } while (p !== start);\n\n    p.prevZ.nextZ = null;\n    p.prevZ = null;\n\n    sortLinked(p);\n}\n\n// Simon Tatham's linked list merge sort algorithm\n// http://www.chiark.greenend.org.uk/~sgtatham/algorithms/listsort.html\nfunction sortLinked(list) {\n    var i, p, q, e, tail, numMerges, pSize, qSize,\n        inSize = 1;\n\n    do {\n        p = list;\n        list = null;\n        tail = null;\n        numMerges = 0;\n\n        while (p) {\n            numMerges++;\n            q = p;\n            pSize = 0;\n            for (i = 0; i < inSize; i++) {\n                pSize++;\n                q = q.nextZ;\n                if (!q) break;\n            }\n            qSize = inSize;\n\n            while (pSize > 0 || (qSize > 0 && q)) {\n\n                if (pSize !== 0 && (qSize === 0 || !q || p.z <= q.z)) {\n                    e = p;\n                    p = p.nextZ;\n                    pSize--;\n                } else {\n                    e = q;\n                    q = q.nextZ;\n                    qSize--;\n                }\n\n                if (tail) tail.nextZ = e;\n                else list = e;\n\n                e.prevZ = tail;\n                tail = e;\n            }\n\n            p = q;\n        }\n\n        tail.nextZ = null;\n        inSize *= 2;\n\n    } while (numMerges > 1);\n\n    return list;\n}\n\n// z-order of a point given coords and inverse of the longer side of data bbox\nfunction zOrder(x, y, minX, minY, invSize) {\n    // coords are transformed into non-negative 15-bit integer range\n    x = (x - minX) * invSize | 0;\n    y = (y - minY) * invSize | 0;\n\n    x = (x | (x << 8)) & 0x00FF00FF;\n    x = (x | (x << 4)) & 0x0F0F0F0F;\n    x = (x | (x << 2)) & 0x33333333;\n    x = (x | (x << 1)) & 0x55555555;\n\n    y = (y | (y << 8)) & 0x00FF00FF;\n    y = (y | (y << 4)) & 0x0F0F0F0F;\n    y = (y | (y << 2)) & 0x33333333;\n    y = (y | (y << 1)) & 0x55555555;\n\n    return x | (y << 1);\n}\n\n// find the leftmost node of a polygon ring\nfunction getLeftmost(start) {\n    var p = start,\n        leftmost = start;\n    do {\n        if (p.x < leftmost.x || (p.x === leftmost.x && p.y < leftmost.y)) leftmost = p;\n        p = p.next;\n    } while (p !== start);\n\n    return leftmost;\n}\n\n// check if a point lies within a convex triangle\nfunction pointInTriangle(ax, ay, bx, by, cx, cy, px, py) {\n    return (cx - px) * (ay - py) >= (ax - px) * (cy - py) &&\n           (ax - px) * (by - py) >= (bx - px) * (ay - py) &&\n           (bx - px) * (cy - py) >= (cx - px) * (by - py);\n}\n\n// check if a diagonal between two polygon nodes is valid (lies in polygon interior)\nfunction isValidDiagonal(a, b) {\n    return a.next.i !== b.i && a.prev.i !== b.i && !intersectsPolygon(a, b) && // dones't intersect other edges\n           (locallyInside(a, b) && locallyInside(b, a) && middleInside(a, b) && // locally visible\n            (area(a.prev, a, b.prev) || area(a, b.prev, b)) || // does not create opposite-facing sectors\n            equals(a, b) && area(a.prev, a, a.next) > 0 && area(b.prev, b, b.next) > 0); // special zero-length case\n}\n\n// signed area of a triangle\nfunction area(p, q, r) {\n    return (q.y - p.y) * (r.x - q.x) - (q.x - p.x) * (r.y - q.y);\n}\n\n// check if two points are equal\nfunction equals(p1, p2) {\n    return p1.x === p2.x && p1.y === p2.y;\n}\n\n// check if two segments intersect\nfunction intersects(p1, q1, p2, q2) {\n    var o1 = sign(area(p1, q1, p2));\n    var o2 = sign(area(p1, q1, q2));\n    var o3 = sign(area(p2, q2, p1));\n    var o4 = sign(area(p2, q2, q1));\n\n    if (o1 !== o2 && o3 !== o4) return true; // general case\n\n    if (o1 === 0 && onSegment(p1, p2, q1)) return true; // p1, q1 and p2 are collinear and p2 lies on p1q1\n    if (o2 === 0 && onSegment(p1, q2, q1)) return true; // p1, q1 and q2 are collinear and q2 lies on p1q1\n    if (o3 === 0 && onSegment(p2, p1, q2)) return true; // p2, q2 and p1 are collinear and p1 lies on p2q2\n    if (o4 === 0 && onSegment(p2, q1, q2)) return true; // p2, q2 and q1 are collinear and q1 lies on p2q2\n\n    return false;\n}\n\n// for collinear points p, q, r, check if point q lies on segment pr\nfunction onSegment(p, q, r) {\n    return q.x <= Math.max(p.x, r.x) && q.x >= Math.min(p.x, r.x) && q.y <= Math.max(p.y, r.y) && q.y >= Math.min(p.y, r.y);\n}\n\nfunction sign(num) {\n    return num > 0 ? 1 : num < 0 ? -1 : 0;\n}\n\n// check if a polygon diagonal intersects any polygon segments\nfunction intersectsPolygon(a, b) {\n    var p = a;\n    do {\n        if (p.i !== a.i && p.next.i !== a.i && p.i !== b.i && p.next.i !== b.i &&\n                intersects(p, p.next, a, b)) return true;\n        p = p.next;\n    } while (p !== a);\n\n    return false;\n}\n\n// check if a polygon diagonal is locally inside the polygon\nfunction locallyInside(a, b) {\n    return area(a.prev, a, a.next) < 0 ?\n        area(a, b, a.next) >= 0 && area(a, a.prev, b) >= 0 :\n        area(a, b, a.prev) < 0 || area(a, a.next, b) < 0;\n}\n\n// check if the middle point of a polygon diagonal is inside the polygon\nfunction middleInside(a, b) {\n    var p = a,\n        inside = false,\n        px = (a.x + b.x) / 2,\n        py = (a.y + b.y) / 2;\n    do {\n        if (((p.y > py) !== (p.next.y > py)) && p.next.y !== p.y &&\n                (px < (p.next.x - p.x) * (py - p.y) / (p.next.y - p.y) + p.x))\n            inside = !inside;\n        p = p.next;\n    } while (p !== a);\n\n    return inside;\n}\n\n// link two polygon vertices with a bridge; if the vertices belong to the same ring, it splits polygon into two;\n// if one belongs to the outer ring and another to a hole, it merges it into a single ring\nfunction splitPolygon(a, b) {\n    var a2 = new Node(a.i, a.x, a.y),\n        b2 = new Node(b.i, b.x, b.y),\n        an = a.next,\n        bp = b.prev;\n\n    a.next = b;\n    b.prev = a;\n\n    a2.next = an;\n    an.prev = a2;\n\n    b2.next = a2;\n    a2.prev = b2;\n\n    bp.next = b2;\n    b2.prev = bp;\n\n    return b2;\n}\n\n// create a node and optionally link it with previous one (in a circular doubly linked list)\nfunction insertNode(i, x, y, last) {\n    var p = new Node(i, x, y);\n\n    if (!last) {\n        p.prev = p;\n        p.next = p;\n\n    } else {\n        p.next = last.next;\n        p.prev = last;\n        last.next.prev = p;\n        last.next = p;\n    }\n    return p;\n}\n\nfunction removeNode(p) {\n    p.next.prev = p.prev;\n    p.prev.next = p.next;\n\n    if (p.prevZ) p.prevZ.nextZ = p.nextZ;\n    if (p.nextZ) p.nextZ.prevZ = p.prevZ;\n}\n\nfunction Node(i, x, y) {\n    // vertex index in coordinates array\n    this.i = i;\n\n    // vertex coordinates\n    this.x = x;\n    this.y = y;\n\n    // previous and next vertex nodes in a polygon ring\n    this.prev = null;\n    this.next = null;\n\n    // z-order curve value\n    this.z = 0;\n\n    // previous and next nodes in z-order\n    this.prevZ = null;\n    this.nextZ = null;\n\n    // indicates whether this is a steiner point\n    this.steiner = false;\n}\n\n// return a percentage difference between the polygon area and its triangulation area;\n// used to verify correctness of triangulation\nearcut.deviation = function (data, holeIndices, dim, triangles) {\n    var hasHoles = holeIndices && holeIndices.length;\n    var outerLen = hasHoles ? holeIndices[0] * dim : data.length;\n\n    var polygonArea = Math.abs(signedArea(data, 0, outerLen, dim));\n    if (hasHoles) {\n        for (var i = 0, len = holeIndices.length; i < len; i++) {\n            var start = holeIndices[i] * dim;\n            var end = i < len - 1 ? holeIndices[i + 1] * dim : data.length;\n            polygonArea -= Math.abs(signedArea(data, start, end, dim));\n        }\n    }\n\n    var trianglesArea = 0;\n    for (i = 0; i < triangles.length; i += 3) {\n        var a = triangles[i] * dim;\n        var b = triangles[i + 1] * dim;\n        var c = triangles[i + 2] * dim;\n        trianglesArea += Math.abs(\n            (data[a] - data[c]) * (data[b + 1] - data[a + 1]) -\n            (data[a] - data[b]) * (data[c + 1] - data[a + 1]));\n    }\n\n    return polygonArea === 0 && trianglesArea === 0 ? 0 :\n        Math.abs((trianglesArea - polygonArea) / polygonArea);\n};\n\nfunction signedArea(data, start, end, dim) {\n    var sum = 0;\n    for (var i = start, j = end - dim; i < end; i += dim) {\n        sum += (data[j] - data[i]) * (data[i + 1] + data[j + 1]);\n        j = i;\n    }\n    return sum;\n}\n\n// turn a polygon in a multi-dimensional array form (e.g. as in GeoJSON) into a form Earcut accepts\nearcut.flatten = function (data) {\n    var dim = data[0][0].length,\n        result = {vertices: [], holes: [], dimensions: dim},\n        holeIndex = 0;\n\n    for (var i = 0; i < data.length; i++) {\n        for (var j = 0; j < data[i].length; j++) {\n            for (var d = 0; d < dim; d++) result.vertices.push(data[i][j][d]);\n        }\n        if (i > 0) {\n            holeIndex += data[i - 1].length;\n            result.holes.push(holeIndex);\n        }\n    }\n    return result;\n};\n","const t=new Uint8Array([0]),e=[171,75,84,88,32,50,48,187,13,10,26,10];var n,i,s,a,r,o,l,f;!function(t){t[t.NONE=0]=\"NONE\",t[t.BASISLZ=1]=\"BASISLZ\",t[t.ZSTD=2]=\"ZSTD\",t[t.ZLIB=3]=\"ZLIB\"}(n||(n={})),function(t){t[t.BASICFORMAT=0]=\"BASICFORMAT\"}(i||(i={})),function(t){t[t.UNSPECIFIED=0]=\"UNSPECIFIED\",t[t.ETC1S=163]=\"ETC1S\",t[t.UASTC=166]=\"UASTC\"}(s||(s={})),function(t){t[t.UNSPECIFIED=0]=\"UNSPECIFIED\",t[t.SRGB=1]=\"SRGB\"}(a||(a={})),function(t){t[t.UNSPECIFIED=0]=\"UNSPECIFIED\",t[t.LINEAR=1]=\"LINEAR\",t[t.SRGB=2]=\"SRGB\",t[t.ITU=3]=\"ITU\",t[t.NTSC=4]=\"NTSC\",t[t.SLOG=5]=\"SLOG\",t[t.SLOG2=6]=\"SLOG2\"}(r||(r={})),function(t){t[t.ALPHA_STRAIGHT=0]=\"ALPHA_STRAIGHT\",t[t.ALPHA_PREMULTIPLIED=1]=\"ALPHA_PREMULTIPLIED\"}(o||(o={})),function(t){t[t.RGB=0]=\"RGB\",t[t.RRR=3]=\"RRR\",t[t.GGG=4]=\"GGG\",t[t.AAA=15]=\"AAA\"}(l||(l={})),function(t){t[t.RGB=0]=\"RGB\",t[t.RGBA=3]=\"RGBA\",t[t.RRR=4]=\"RRR\",t[t.RRRG=5]=\"RRRG\"}(f||(f={}));class U{constructor(){this.vkFormat=0,this.typeSize=1,this.pixelWidth=0,this.pixelHeight=0,this.pixelDepth=0,this.layerCount=0,this.faceCount=1,this.supercompressionScheme=n.NONE,this.levels=[],this.dataFormatDescriptor=[{vendorId:0,descriptorType:i.BASICFORMAT,versionNumber:2,descriptorBlockSize:40,colorModel:s.UNSPECIFIED,colorPrimaries:a.SRGB,transferFunction:a.SRGB,flags:o.ALPHA_STRAIGHT,texelBlockDimension:{x:4,y:4,z:1,w:1},bytesPlane:[],samples:[]}],this.keyValue={},this.globalData=null}}class c{constructor(t,e,n,i){this._dataView=new DataView(t.buffer,t.byteOffset+e,n),this._littleEndian=i,this._offset=0}_nextUint8(){const t=this._dataView.getUint8(this._offset);return this._offset+=1,t}_nextUint16(){const t=this._dataView.getUint16(this._offset,this._littleEndian);return this._offset+=2,t}_nextUint32(){const t=this._dataView.getUint32(this._offset,this._littleEndian);return this._offset+=4,t}_nextUint64(){const t=this._dataView.getUint32(this._offset,this._littleEndian)+2**32*this._dataView.getUint32(this._offset+4,this._littleEndian);return this._offset+=8,t}_skip(t){return this._offset+=t,this}_scan(t,e=0){const n=this._offset;let i=0;for(;this._dataView.getUint8(this._offset)!==e&&i<t;)i++,this._offset++;return i<t&&this._offset++,new Uint8Array(this._dataView.buffer,this._dataView.byteOffset+n,i)}}function h(t){return\"undefined\"!=typeof TextEncoder?(new TextEncoder).encode(t):Buffer.from(t)}function _(t){return\"undefined\"!=typeof TextDecoder?(new TextDecoder).decode(t):Buffer.from(t).toString(\"utf8\")}function g(t){let e=0;for(const n of t)e+=n.byteLength;const n=new Uint8Array(e);let i=0;for(const e of t)n.set(new Uint8Array(e),i),i+=e.byteLength;return n}function p(t){const n=new Uint8Array(t.buffer,t.byteOffset,e.length);if(n[0]!==e[0]||n[1]!==e[1]||n[2]!==e[2]||n[3]!==e[3]||n[4]!==e[4]||n[5]!==e[5]||n[6]!==e[6]||n[7]!==e[7]||n[8]!==e[8]||n[9]!==e[9]||n[10]!==e[10]||n[11]!==e[11])throw new Error(\"Missing KTX 2.0 identifier.\");const i=new U,s=17*Uint32Array.BYTES_PER_ELEMENT,a=new c(t,e.length,s,!0);i.vkFormat=a._nextUint32(),i.typeSize=a._nextUint32(),i.pixelWidth=a._nextUint32(),i.pixelHeight=a._nextUint32(),i.pixelDepth=a._nextUint32(),i.layerCount=a._nextUint32(),i.faceCount=a._nextUint32();const r=a._nextUint32();i.supercompressionScheme=a._nextUint32();const o=a._nextUint32(),l=a._nextUint32(),f=a._nextUint32(),h=a._nextUint32(),g=a._nextUint64(),p=a._nextUint64(),x=new c(t,e.length+s,3*r*8,!0);for(let e=0;e<r;e++)i.levels.push({levelData:new Uint8Array(t.buffer,t.byteOffset+x._nextUint64(),x._nextUint64()),uncompressedByteLength:x._nextUint64()});const u=new c(t,o,l,!0),y={vendorId:u._skip(4)._nextUint16(),descriptorType:u._nextUint16(),versionNumber:u._nextUint16(),descriptorBlockSize:u._nextUint16(),colorModel:u._nextUint8(),colorPrimaries:u._nextUint8(),transferFunction:u._nextUint8(),flags:u._nextUint8(),texelBlockDimension:{x:u._nextUint8()+1,y:u._nextUint8()+1,z:u._nextUint8()+1,w:u._nextUint8()+1},bytesPlane:[u._nextUint8(),u._nextUint8(),u._nextUint8(),u._nextUint8(),u._nextUint8(),u._nextUint8(),u._nextUint8(),u._nextUint8()],samples:[]},D=(y.descriptorBlockSize/4-6)/4;for(let t=0;t<D;t++)y.samples[t]={bitOffset:u._nextUint16(),bitLength:u._nextUint8(),channelID:u._nextUint8(),samplePosition:[u._nextUint8(),u._nextUint8(),u._nextUint8(),u._nextUint8()],sampleLower:u._nextUint32(),sampleUpper:u._nextUint32()};i.dataFormatDescriptor.length=0,i.dataFormatDescriptor.push(y);const b=new c(t,f,h,!0);for(;b._offset<h;){const t=b._nextUint32(),e=b._scan(t),n=_(e),s=b._scan(t-e.byteLength);i.keyValue[n]=n.match(/^ktx/i)?_(s):s,t%4&&b._skip(4-t%4)}if(p<=0)return i;const d=new c(t,g,p,!0),B=d._nextUint16(),w=d._nextUint16(),A=d._nextUint32(),S=d._nextUint32(),m=d._nextUint32(),L=d._nextUint32(),I=[];for(let t=0;t<r;t++)I.push({imageFlags:d._nextUint32(),rgbSliceByteOffset:d._nextUint32(),rgbSliceByteLength:d._nextUint32(),alphaSliceByteOffset:d._nextUint32(),alphaSliceByteLength:d._nextUint32()});const R=g+d._offset,E=R+A,T=E+S,O=T+m,P=new Uint8Array(t.buffer,t.byteOffset+R,A),C=new Uint8Array(t.buffer,t.byteOffset+E,S),F=new Uint8Array(t.buffer,t.byteOffset+T,m),G=new Uint8Array(t.buffer,t.byteOffset+O,L);return i.globalData={endpointCount:B,selectorCount:w,imageDescs:I,endpointsData:P,selectorsData:C,tablesData:F,extendedData:G},i}function x(){return(x=Object.assign||function(t){for(var e=1;e<arguments.length;e++){var n=arguments[e];for(var i in n)Object.prototype.hasOwnProperty.call(n,i)&&(t[i]=n[i])}return t}).apply(this,arguments)}const u={keepWriter:!1};function y(n,s={}){s=x({},u,s);let a=new ArrayBuffer(0);if(n.globalData){const t=new ArrayBuffer(20+5*n.globalData.imageDescs.length*4),e=new DataView(t);e.setUint16(0,n.globalData.endpointCount,!0),e.setUint16(2,n.globalData.selectorCount,!0),e.setUint32(4,n.globalData.endpointsData.byteLength,!0),e.setUint32(8,n.globalData.selectorsData.byteLength,!0),e.setUint32(12,n.globalData.tablesData.byteLength,!0),e.setUint32(16,n.globalData.extendedData.byteLength,!0);for(let t=0;t<n.globalData.imageDescs.length;t++){const i=n.globalData.imageDescs[t];e.setUint32(20+5*t*4+0,i.imageFlags,!0),e.setUint32(20+5*t*4+4,i.rgbSliceByteOffset,!0),e.setUint32(20+5*t*4+8,i.rgbSliceByteLength,!0),e.setUint32(20+5*t*4+12,i.alphaSliceByteOffset,!0),e.setUint32(20+5*t*4+16,i.alphaSliceByteLength,!0)}a=g([t,n.globalData.endpointsData,n.globalData.selectorsData,n.globalData.tablesData,n.globalData.extendedData])}const r=[];let o=n.keyValue;s.keepWriter||(o=x({},n.keyValue,{KTXwriter:\"KTX-Parse v0.0.4\"}));for(const e in o){const n=o[e],i=h(e),s=\"string\"==typeof n?h(n):n,a=i.byteLength+1+s.byteLength+1,l=a%4?4-a%4:0;r.push(g([new Uint32Array([a]),i,t,s,t,new Uint8Array(l).fill(0)]))}const l=g(r),f=new ArrayBuffer(44),U=new DataView(f);if(1!==n.dataFormatDescriptor.length||n.dataFormatDescriptor[0].descriptorType!==i.BASICFORMAT)throw new Error(\"Only BASICFORMAT Data Format Descriptor output supported.\");const c=n.dataFormatDescriptor[0];U.setUint32(0,44,!0),U.setUint16(4,c.vendorId,!0),U.setUint16(6,c.descriptorType,!0),U.setUint16(8,c.versionNumber,!0),U.setUint16(10,c.descriptorBlockSize,!0),U.setUint8(12,c.colorModel),U.setUint8(13,c.colorPrimaries),U.setUint8(14,c.transferFunction),U.setUint8(15,c.flags),U.setUint8(16,c.texelBlockDimension.x-1),U.setUint8(17,c.texelBlockDimension.y-1),U.setUint8(18,c.texelBlockDimension.z-1),U.setUint8(19,c.texelBlockDimension.w-1);for(let t=0;t<8;t++)U.setUint8(20+t,c.bytesPlane[t]);for(let t=0;t<c.samples.length;t++){const e=c.samples[t],n=28+16*t;U.setUint16(n+0,e.bitOffset,!0),U.setUint8(n+2,e.bitLength),U.setUint8(n+3,e.channelID),U.setUint8(n+4,e.samplePosition[0]),U.setUint8(n+5,e.samplePosition[1]),U.setUint8(n+6,e.samplePosition[2]),U.setUint8(n+7,e.samplePosition[3]),U.setUint32(n+8,e.sampleLower,!0),U.setUint32(n+12,e.sampleUpper,!0)}const _=e.length+68+3*n.levels.length*8,p=_+f.byteLength;let y=p+l.byteLength;y%8&&(y+=8-y%8);const D=[],b=new DataView(new ArrayBuffer(3*n.levels.length*8));let d=y+a.byteLength;for(let t=0;t<n.levels.length;t++){const e=n.levels[t];D.push(e.levelData),b.setBigUint64(24*t+0,BigInt(d),!0),b.setBigUint64(24*t+8,BigInt(e.levelData.byteLength),!0),b.setBigUint64(24*t+16,BigInt(e.uncompressedByteLength),!0),d+=e.levelData.byteLength}const B=new ArrayBuffer(68),w=new DataView(B);return w.setUint32(0,n.vkFormat,!0),w.setUint32(4,n.typeSize,!0),w.setUint32(8,n.pixelWidth,!0),w.setUint32(12,n.pixelHeight,!0),w.setUint32(16,n.pixelDepth,!0),w.setUint32(20,n.layerCount,!0),w.setUint32(24,n.faceCount,!0),w.setUint32(28,n.levels.length,!0),w.setUint32(32,n.supercompressionScheme,!0),w.setUint32(36,_,!0),w.setUint32(40,f.byteLength,!0),w.setUint32(44,p,!0),w.setUint32(48,l.byteLength,!0),w.setBigUint64(52,BigInt(y),!0),w.setBigUint64(60,BigInt(a.byteLength),!0),new Uint8Array(g([new Uint8Array(e).buffer,B,b.buffer,f,l,new ArrayBuffer(y-(p+l.byteLength)),a,...D]))}export{U as KTX2Container,p as read,y as write};\n//# sourceMappingURL=ktx-parse.modern.js.map\n","import { Texture2D, hasFeature, FEATURES, log } from '@luma.gl/webgl';\nexport default class GLTFMaterialParser {\n  constructor(gl, _ref) {\n    let {\n      attributes,\n      material,\n      pbrDebug,\n      imageBasedLightingEnvironment,\n      lights,\n      useTangents\n    } = _ref;\n    this.gl = gl;\n    this.defines = {\n      MANUAL_SRGB: 1,\n      SRGB_FAST_APPROXIMATION: 1\n    };\n\n    if (hasFeature(gl, FEATURES.GLSL_TEXTURE_LOD)) {\n      this.defines.USE_TEX_LOD = 1;\n    }\n\n    this.uniforms = {\n      u_Camera: [0, 0, 0],\n      u_MetallicRoughnessValues: [1, 1]\n    };\n    this.parameters = {};\n    this.generatedTextures = [];\n\n    if (imageBasedLightingEnvironment) {\n      this.uniforms.u_DiffuseEnvSampler = imageBasedLightingEnvironment.getDiffuseEnvSampler();\n      this.uniforms.u_SpecularEnvSampler = imageBasedLightingEnvironment.getSpecularEnvSampler();\n      this.uniforms.u_brdfLUT = imageBasedLightingEnvironment.getBrdfTexture();\n      this.uniforms.u_ScaleIBLAmbient = [1, 1];\n    }\n\n    if (pbrDebug) {\n      this.uniforms.u_ScaleDiffBaseMR = [0, 0, 0, 0];\n      this.uniforms.u_ScaleFGDSpec = [0, 0, 0, 0];\n    }\n\n    this.defineIfPresent(attributes.NORMAL, 'HAS_NORMALS');\n    this.defineIfPresent(attributes.TANGENT && useTangents, 'HAS_TANGENTS');\n    this.defineIfPresent(attributes.TEXCOORD_0, 'HAS_UV');\n    this.defineIfPresent(imageBasedLightingEnvironment, 'USE_IBL');\n    this.defineIfPresent(lights, 'USE_LIGHTS');\n    this.defineIfPresent(pbrDebug, 'PBR_DEBUG');\n\n    if (material) {\n      this.parseMaterial(material);\n    }\n  }\n\n  defineIfPresent(value, name) {\n    if (value) {\n      this.defines[name] = 1;\n    }\n  }\n\n  parseTexture(gltfTexture, name) {\n    let define = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;\n    const parameters = gltfTexture.texture && gltfTexture.texture.sampler && gltfTexture.texture.sampler.parameters || {};\n    const image = gltfTexture.texture.source.image;\n    let textureOptions;\n    let specialTextureParameters = {};\n\n    if (image.compressed) {\n      textureOptions = image;\n      specialTextureParameters = {\n        [this.gl.TEXTURE_MIN_FILTER]: image.data.length > 1 ? this.gl.LINEAR_MIPMAP_NEAREST : this.gl.LINEAR\n      };\n    } else {\n      textureOptions = {\n        data: image\n      };\n    }\n\n    const texture = new Texture2D(this.gl, {\n      id: gltfTexture.name || gltfTexture.id,\n      parameters: { ...parameters,\n        ...specialTextureParameters\n      },\n      pixelStore: {\n        [this.gl.UNPACK_FLIP_Y_WEBGL]: false\n      },\n      ...textureOptions\n    });\n    this.uniforms[name] = texture;\n    this.defineIfPresent(define, define);\n    this.generatedTextures.push(texture);\n  }\n\n  parsePbrMetallicRoughness(pbrMetallicRoughness) {\n    if (pbrMetallicRoughness.baseColorTexture) {\n      this.parseTexture(pbrMetallicRoughness.baseColorTexture, 'u_BaseColorSampler', 'HAS_BASECOLORMAP');\n    }\n\n    this.uniforms.u_BaseColorFactor = pbrMetallicRoughness.baseColorFactor || [1, 1, 1, 1];\n\n    if (pbrMetallicRoughness.metallicRoughnessTexture) {\n      this.parseTexture(pbrMetallicRoughness.metallicRoughnessTexture, 'u_MetallicRoughnessSampler', 'HAS_METALROUGHNESSMAP');\n    }\n\n    const {\n      metallicFactor = 1,\n      roughnessFactor = 1\n    } = pbrMetallicRoughness;\n    this.uniforms.u_MetallicRoughnessValues = [metallicFactor, roughnessFactor];\n  }\n\n  parseMaterial(material) {\n    this.uniforms.pbr_uUnlit = Boolean(material.unlit);\n\n    if (material.pbrMetallicRoughness) {\n      this.parsePbrMetallicRoughness(material.pbrMetallicRoughness);\n    }\n\n    if (material.normalTexture) {\n      this.parseTexture(material.normalTexture, 'u_NormalSampler', 'HAS_NORMALMAP');\n      const {\n        scale = 1\n      } = material.normalTexture;\n      this.uniforms.u_NormalScale = scale;\n    }\n\n    if (material.occlusionTexture) {\n      this.parseTexture(material.occlusionTexture, 'u_OcclusionSampler', 'HAS_OCCLUSIONMAP');\n      const {\n        strength = 1\n      } = material.occlusionTexture;\n      this.uniforms.u_OcclusionStrength = strength;\n    }\n\n    if (material.emissiveTexture) {\n      this.parseTexture(material.emissiveTexture, 'u_EmissiveSampler', 'HAS_EMISSIVEMAP');\n      this.uniforms.u_EmissiveFactor = material.emissiveFactor || [0, 0, 0];\n    }\n\n    if (material.alphaMode === 'MASK') {\n      const {\n        alphaCutoff = 0.5\n      } = material;\n      this.defines.ALPHA_CUTOFF = 1;\n      this.uniforms.u_AlphaCutoff = alphaCutoff;\n    } else if (material.alphaMode === 'BLEND') {\n      log.warn('BLEND alphaMode might not work well because it requires mesh sorting')();\n      Object.assign(this.parameters, {\n        blend: true,\n        blendEquation: this.gl.FUNC_ADD,\n        blendFunc: [this.gl.SRC_ALPHA, this.gl.ONE_MINUS_SRC_ALPHA, this.gl.ONE, this.gl.ONE_MINUS_SRC_ALPHA]\n      });\n    }\n  }\n\n  delete() {\n    this.generatedTextures.forEach(texture => texture.delete());\n  }\n\n}\n//# sourceMappingURL=gltf-material-parser.js.map","import isElectron from './is-electron';\nexport default function isBrowser() {\n  const isNode = typeof process === 'object' && String(process) === '[object process]' && !process.browser;\n  return !isNode || isElectron();\n}\nexport function isBrowserMainThread() {\n  return isBrowser() && typeof document !== 'undefined';\n}\n//# sourceMappingURL=is-browser.js.map","export default function isElectron(mockUserAgent) {\n  if (typeof window !== 'undefined' && typeof window.process === 'object' && window.process.type === 'renderer') {\n    return true;\n  }\n\n  if (typeof process !== 'undefined' && typeof process.versions === 'object' && Boolean(process.versions['electron'])) {\n    return true;\n  }\n\n  const realUserAgent = typeof navigator === 'object' && typeof navigator.userAgent === 'string' && navigator.userAgent;\n  const userAgent = mockUserAgent || realUserAgent;\n\n  if (userAgent && userAgent.indexOf('Electron') >= 0) {\n    return true;\n  }\n\n  return false;\n}\n//# sourceMappingURL=is-electron.js.map","var arrayWithoutHoles = require(\"./arrayWithoutHoles.js\");\nvar iterableToArray = require(\"./iterableToArray.js\");\nvar unsupportedIterableToArray = require(\"./unsupportedIterableToArray.js\");\nvar nonIterableSpread = require(\"./nonIterableSpread.js\");\nfunction _toConsumableArray(arr) {\n  return arrayWithoutHoles(arr) || iterableToArray(arr) || unsupportedIterableToArray(arr) || nonIterableSpread();\n}\nmodule.exports = _toConsumableArray, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","import WEBGL_FEATURES from './webgl-features-table';\nimport { isWebGL2, log } from '@luma.gl/gltools';\nimport { assert } from '../utils/assert';\nconst LOG_UNSUPPORTED_FEATURE = 2;\nexport function hasFeature(gl, feature) {\n  return hasFeatures(gl, feature);\n}\nexport function hasFeatures(gl, features) {\n  features = Array.isArray(features) ? features : [features];\n  return features.every(feature => {\n    return isFeatureSupported(gl, feature);\n  });\n}\nexport function getFeatures(gl) {\n  gl.luma = gl.luma || {};\n  gl.luma.caps = gl.luma.caps || {};\n\n  for (const cap in WEBGL_FEATURES) {\n    if (gl.luma.caps[cap] === undefined) {\n      gl.luma.caps[cap] = isFeatureSupported(gl, cap);\n    }\n  }\n\n  return gl.luma.caps;\n}\n\nfunction isFeatureSupported(gl, cap) {\n  gl.luma = gl.luma || {};\n  gl.luma.caps = gl.luma.caps || {};\n\n  if (gl.luma.caps[cap] === undefined) {\n    gl.luma.caps[cap] = queryFeature(gl, cap);\n  }\n\n  if (!gl.luma.caps[cap]) {\n    log.log(LOG_UNSUPPORTED_FEATURE, \"Feature: \".concat(cap, \" not supported\"))();\n  }\n\n  return gl.luma.caps[cap];\n}\n\nfunction queryFeature(gl, cap) {\n  const feature = WEBGL_FEATURES[cap];\n  assert(feature, cap);\n  let isSupported;\n  const featureDefinition = isWebGL2(gl) ? feature[1] || feature[0] : feature[0];\n\n  if (typeof featureDefinition === 'function') {\n    isSupported = featureDefinition(gl);\n  } else if (Array.isArray(featureDefinition)) {\n    isSupported = true;\n\n    for (const extension of featureDefinition) {\n      isSupported = isSupported && Boolean(gl.getExtension(extension));\n    }\n  } else if (typeof featureDefinition === 'string') {\n    isSupported = Boolean(gl.getExtension(featureDefinition));\n  } else if (typeof featureDefinition === 'boolean') {\n    isSupported = featureDefinition;\n  } else {\n    assert(false);\n  }\n\n  return isSupported;\n}\n//# sourceMappingURL=features.js.map","/* global window, document */\n\n// See https://github.com/jupyter-widgets/widget-ts-cookiecutter/blob/master/%7B%7Bcookiecutter.github_project_name%7D%7D/src/extension.ts\n// Entry point for the Jupyter Notebook bundle containing custom Backbone model and view definitions.\n\n// Some static assets may be required by the custom widget javascript. The base\n// url for the notebook is not known at build time and is therefore computed dynamically.\nconst dataBaseUrl = document.body && document.body.getAttribute('data-base-url');\nif (dataBaseUrl) {\n  window.__webpack_public_path__ = `${dataBaseUrl}nbextensions/pydeck/nb_extension`;\n}\n\n// Initialize the transport\nconst {jupyterTransport} = require('./lib/jupyter-transport').default;\n\nlet JupyterTransportModel = null;\nlet JupyterTransportView = null;\ntry {\n  JupyterTransportModel = require('./lib/jupyter-transport-model').default;\n  JupyterTransportView = require('./lib/jupyter-transport-view').default;\n} catch (err) {\n  // Note: Happens in the to_html() case\n}\n\nconst {MODULE_VERSION, MODULE_NAME} = require('./version');\n\n// TODO - this should be placed in a separate module `@deck.gl/playground`\nconst {createDeck, updateDeck} = require('./playground/create-deck');\nconst {initPlayground} = require('./playground');\ninitPlayground();\n\nmodule.exports = {\n  // Transports\n  jupyterTransport,\n\n  // Jupyter Hooks\n  MODULE_VERSION,\n  MODULE_NAME,\n  JupyterTransportModel,\n  JupyterTransportView,\n\n  // For to_html()...\n  initPlayground,\n  // TODO - use playground?\n  createDeck,\n  updateDeck\n};\n","var _typeof = require(\"./typeof.js\")[\"default\"];\nfunction _toPrimitive(input, hint) {\n  if (_typeof(input) !== \"object\" || input === null) return input;\n  var prim = input[Symbol.toPrimitive];\n  if (prim !== undefined) {\n    var res = prim.call(input, hint || \"default\");\n    if (_typeof(res) !== \"object\") return res;\n    throw new TypeError(\"@@toPrimitive must return a primitive value.\");\n  }\n  return (hint === \"string\" ? String : Number)(input);\n}\nmodule.exports = _toPrimitive, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","function _setPrototypeOf(o, p) {\n  module.exports = _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) {\n    o.__proto__ = p;\n    return o;\n  }, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;\n  return _setPrototypeOf(o, p);\n}\nmodule.exports = _setPrototypeOf, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","function _assertThisInitialized(self) {\n  if (self === void 0) {\n    throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\");\n  }\n  return self;\n}\nmodule.exports = _assertThisInitialized, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","var getPrototypeOf = require(\"./getPrototypeOf.js\");\nfunction _superPropBase(object, property) {\n  while (!Object.prototype.hasOwnProperty.call(object, property)) {\n    object = getPrototypeOf(object);\n    if (object === null) break;\n  }\n  return object;\n}\nmodule.exports = _superPropBase, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","import {DOMWidgetView} from '@jupyter-widgets/base';\nimport JupyterTransport from './jupyter-transport';\n\nexport default class JupyterTransportView extends DOMWidgetView {\n  initialize() {\n    this.listenTo(this.model, 'destroy', this.remove);\n\n    // TODO - is there any variable information on the model we can use to\n    // give an interesting name or id to this instance?\n    this.transport = new JupyterTransport();\n\n    // Expose Jupyter internals to enable work-arounds\n    this.transport.jupyterModel = this.model;\n    this.transport.jupyterView = this;\n    this.transport._initialize();\n    super.initialize.apply(this, arguments);\n  }\n\n  remove() {\n    if (this.transport) {\n      this.transport._finalize();\n      this.transport.jupyterModel = null;\n      this.transport.jupyterView = null;\n      this.transport = null;\n    }\n  }\n\n  render() {\n    super.render();\n\n    this.model.on('change:json_input', this.onJsonChanged.bind(this));\n    this.model.on('change:data_buffer', this.onDataBufferChanged.bind(this));\n\n    this.onDataBufferChanged();\n  }\n\n  onJsonChanged() {\n    const json = JSON.parse(this.model.get('json_input'));\n    this.transport._messageReceived({type: 'json', json});\n  }\n\n  onDataBufferChanged() {\n    const json = this.model.get('json_input');\n    const dataBuffer = this.model.get('data_buffer');\n\n    if (json && dataBuffer) {\n      this.transport._messageReceived({\n        type: 'json-with-binary',\n        json,\n        binary: dataBuffer\n      });\n    } else {\n      this.transport._messageReceived({type: 'json', json});\n    }\n  }\n}\n","// We use `require` here because luma and deck core must be imported before `global`\nconst LumaGL = require('./lumagl');\nconst deckGLCore = require('../src');\n\nconst DeckGL = require('./deckgl').default;\nconst {registerLoaders, load, parse, fetchFile} = require('@loaders.gl/core');\n\n/* global window, global */\nconst _global = typeof window === 'undefined' ? global : window;\n_global.deck = _global.deck || {};\n_global.luma = _global.luma || {};\n_global.loaders = _global.loaders || {};\n\nObject.assign(_global.deck, deckGLCore, {DeckGL});\nObject.assign(_global.luma, LumaGL);\nObject.assign(_global.loaders, {registerLoaders, load, parse, fetchFile});\n\nmodule.exports = _global.deck;\n","function _arrayWithoutHoles(arr) {\n  if (Array.isArray(arr)) {\n    for (var i = 0, arr2 = new Array(arr.length); i < arr.length; i++) {\n      arr2[i] = arr[i];\n    }\n\n    return arr2;\n  }\n}\n\nmodule.exports = _arrayWithoutHoles;","function _iterableToArray(iter) {\n  if (Symbol.iterator in Object(iter) || Object.prototype.toString.call(iter) === \"[object Arguments]\") return Array.from(iter);\n}\n\nmodule.exports = _iterableToArray;","function _nonIterableSpread() {\n  throw new TypeError(\"Invalid attempt to spread non-iterable instance\");\n}\n\nmodule.exports = _nonIterableSpread;","function _arrayWithHoles(arr) {\n  if (Array.isArray(arr)) return arr;\n}\n\nmodule.exports = _arrayWithHoles;","function _iterableToArrayLimit(arr, i) {\n  if (!(Symbol.iterator in Object(arr) || Object.prototype.toString.call(arr) === \"[object Arguments]\")) {\n    return;\n  }\n\n  var _arr = [];\n  var _n = true;\n  var _d = false;\n  var _e = undefined;\n\n  try {\n    for (var _i = arr[Symbol.iterator](), _s; !(_n = (_s = _i.next()).done); _n = true) {\n      _arr.push(_s.value);\n\n      if (i && _arr.length === i) break;\n    }\n  } catch (err) {\n    _d = true;\n    _e = err;\n  } finally {\n    try {\n      if (!_n && _i[\"return\"] != null) _i[\"return\"]();\n    } finally {\n      if (_d) throw _e;\n    }\n  }\n\n  return _arr;\n}\n\nmodule.exports = _iterableToArrayLimit;","function _nonIterableRest() {\n  throw new TypeError(\"Invalid attempt to destructure non-iterable instance\");\n}\n\nmodule.exports = _nonIterableRest;","var getPrototypeOf = require(\"./getPrototypeOf\");\n\nfunction _superPropBase(object, property) {\n  while (!Object.prototype.hasOwnProperty.call(object, property)) {\n    object = getPrototypeOf(object);\n    if (object === null) break;\n  }\n\n  return object;\n}\n\nmodule.exports = _superPropBase;","function _setPrototypeOf(o, p) {\n  module.exports = _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) {\n    o.__proto__ = p;\n    return o;\n  };\n\n  return _setPrototypeOf(o, p);\n}\n\nmodule.exports = _setPrototypeOf;","/**\n * Copyright (c) 2014-present, Facebook, Inc.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\nvar runtime = (function (exports) {\n  \"use strict\";\n\n  var Op = Object.prototype;\n  var hasOwn = Op.hasOwnProperty;\n  var undefined; // More compressible than void 0.\n  var $Symbol = typeof Symbol === \"function\" ? Symbol : {};\n  var iteratorSymbol = $Symbol.iterator || \"@@iterator\";\n  var asyncIteratorSymbol = $Symbol.asyncIterator || \"@@asyncIterator\";\n  var toStringTagSymbol = $Symbol.toStringTag || \"@@toStringTag\";\n\n  function wrap(innerFn, outerFn, self, tryLocsList) {\n    // If outerFn provided and outerFn.prototype is a Generator, then outerFn.prototype instanceof Generator.\n    var protoGenerator = outerFn && outerFn.prototype instanceof Generator ? outerFn : Generator;\n    var generator = Object.create(protoGenerator.prototype);\n    var context = new Context(tryLocsList || []);\n\n    // The ._invoke method unifies the implementations of the .next,\n    // .throw, and .return methods.\n    generator._invoke = makeInvokeMethod(innerFn, self, context);\n\n    return generator;\n  }\n  exports.wrap = wrap;\n\n  // Try/catch helper to minimize deoptimizations. Returns a completion\n  // record like context.tryEntries[i].completion. This interface could\n  // have been (and was previously) designed to take a closure to be\n  // invoked without arguments, but in all the cases we care about we\n  // already have an existing method we want to call, so there's no need\n  // to create a new function object. We can even get away with assuming\n  // the method takes exactly one argument, since that happens to be true\n  // in every case, so we don't have to touch the arguments object. The\n  // only additional allocation required is the completion record, which\n  // has a stable shape and so hopefully should be cheap to allocate.\n  function tryCatch(fn, obj, arg) {\n    try {\n      return { type: \"normal\", arg: fn.call(obj, arg) };\n    } catch (err) {\n      return { type: \"throw\", arg: err };\n    }\n  }\n\n  var GenStateSuspendedStart = \"suspendedStart\";\n  var GenStateSuspendedYield = \"suspendedYield\";\n  var GenStateExecuting = \"executing\";\n  var GenStateCompleted = \"completed\";\n\n  // Returning this object from the innerFn has the same effect as\n  // breaking out of the dispatch switch statement.\n  var ContinueSentinel = {};\n\n  // Dummy constructor functions that we use as the .constructor and\n  // .constructor.prototype properties for functions that return Generator\n  // objects. For full spec compliance, you may wish to configure your\n  // minifier not to mangle the names of these two functions.\n  function Generator() {}\n  function GeneratorFunction() {}\n  function GeneratorFunctionPrototype() {}\n\n  // This is a polyfill for %IteratorPrototype% for environments that\n  // don't natively support it.\n  var IteratorPrototype = {};\n  IteratorPrototype[iteratorSymbol] = function () {\n    return this;\n  };\n\n  var getProto = Object.getPrototypeOf;\n  var NativeIteratorPrototype = getProto && getProto(getProto(values([])));\n  if (NativeIteratorPrototype &&\n      NativeIteratorPrototype !== Op &&\n      hasOwn.call(NativeIteratorPrototype, iteratorSymbol)) {\n    // This environment has a native %IteratorPrototype%; use it instead\n    // of the polyfill.\n    IteratorPrototype = NativeIteratorPrototype;\n  }\n\n  var Gp = GeneratorFunctionPrototype.prototype =\n    Generator.prototype = Object.create(IteratorPrototype);\n  GeneratorFunction.prototype = Gp.constructor = GeneratorFunctionPrototype;\n  GeneratorFunctionPrototype.constructor = GeneratorFunction;\n  GeneratorFunctionPrototype[toStringTagSymbol] =\n    GeneratorFunction.displayName = \"GeneratorFunction\";\n\n  // Helper for defining the .next, .throw, and .return methods of the\n  // Iterator interface in terms of a single ._invoke method.\n  function defineIteratorMethods(prototype) {\n    [\"next\", \"throw\", \"return\"].forEach(function(method) {\n      prototype[method] = function(arg) {\n        return this._invoke(method, arg);\n      };\n    });\n  }\n\n  exports.isGeneratorFunction = function(genFun) {\n    var ctor = typeof genFun === \"function\" && genFun.constructor;\n    return ctor\n      ? ctor === GeneratorFunction ||\n        // For the native GeneratorFunction constructor, the best we can\n        // do is to check its .name property.\n        (ctor.displayName || ctor.name) === \"GeneratorFunction\"\n      : false;\n  };\n\n  exports.mark = function(genFun) {\n    if (Object.setPrototypeOf) {\n      Object.setPrototypeOf(genFun, GeneratorFunctionPrototype);\n    } else {\n      genFun.__proto__ = GeneratorFunctionPrototype;\n      if (!(toStringTagSymbol in genFun)) {\n        genFun[toStringTagSymbol] = \"GeneratorFunction\";\n      }\n    }\n    genFun.prototype = Object.create(Gp);\n    return genFun;\n  };\n\n  // Within the body of any async function, `await x` is transformed to\n  // `yield regeneratorRuntime.awrap(x)`, so that the runtime can test\n  // `hasOwn.call(value, \"__await\")` to determine if the yielded value is\n  // meant to be awaited.\n  exports.awrap = function(arg) {\n    return { __await: arg };\n  };\n\n  function AsyncIterator(generator) {\n    function invoke(method, arg, resolve, reject) {\n      var record = tryCatch(generator[method], generator, arg);\n      if (record.type === \"throw\") {\n        reject(record.arg);\n      } else {\n        var result = record.arg;\n        var value = result.value;\n        if (value &&\n            typeof value === \"object\" &&\n            hasOwn.call(value, \"__await\")) {\n          return Promise.resolve(value.__await).then(function(value) {\n            invoke(\"next\", value, resolve, reject);\n          }, function(err) {\n            invoke(\"throw\", err, resolve, reject);\n          });\n        }\n\n        return Promise.resolve(value).then(function(unwrapped) {\n          // When a yielded Promise is resolved, its final value becomes\n          // the .value of the Promise<{value,done}> result for the\n          // current iteration.\n          result.value = unwrapped;\n          resolve(result);\n        }, function(error) {\n          // If a rejected Promise was yielded, throw the rejection back\n          // into the async generator function so it can be handled there.\n          return invoke(\"throw\", error, resolve, reject);\n        });\n      }\n    }\n\n    var previousPromise;\n\n    function enqueue(method, arg) {\n      function callInvokeWithMethodAndArg() {\n        return new Promise(function(resolve, reject) {\n          invoke(method, arg, resolve, reject);\n        });\n      }\n\n      return previousPromise =\n        // If enqueue has been called before, then we want to wait until\n        // all previous Promises have been resolved before calling invoke,\n        // so that results are always delivered in the correct order. If\n        // enqueue has not been called before, then it is important to\n        // call invoke immediately, without waiting on a callback to fire,\n        // so that the async generator function has the opportunity to do\n        // any necessary setup in a predictable way. This predictability\n        // is why the Promise constructor synchronously invokes its\n        // executor callback, and why async functions synchronously\n        // execute code before the first await. Since we implement simple\n        // async functions in terms of async generators, it is especially\n        // important to get this right, even though it requires care.\n        previousPromise ? previousPromise.then(\n          callInvokeWithMethodAndArg,\n          // Avoid propagating failures to Promises returned by later\n          // invocations of the iterator.\n          callInvokeWithMethodAndArg\n        ) : callInvokeWithMethodAndArg();\n    }\n\n    // Define the unified helper method that is used to implement .next,\n    // .throw, and .return (see defineIteratorMethods).\n    this._invoke = enqueue;\n  }\n\n  defineIteratorMethods(AsyncIterator.prototype);\n  AsyncIterator.prototype[asyncIteratorSymbol] = function () {\n    return this;\n  };\n  exports.AsyncIterator = AsyncIterator;\n\n  // Note that simple async functions are implemented on top of\n  // AsyncIterator objects; they just return a Promise for the value of\n  // the final result produced by the iterator.\n  exports.async = function(innerFn, outerFn, self, tryLocsList) {\n    var iter = new AsyncIterator(\n      wrap(innerFn, outerFn, self, tryLocsList)\n    );\n\n    return exports.isGeneratorFunction(outerFn)\n      ? iter // If outerFn is a generator, return the full iterator.\n      : iter.next().then(function(result) {\n          return result.done ? result.value : iter.next();\n        });\n  };\n\n  function makeInvokeMethod(innerFn, self, context) {\n    var state = GenStateSuspendedStart;\n\n    return function invoke(method, arg) {\n      if (state === GenStateExecuting) {\n        throw new Error(\"Generator is already running\");\n      }\n\n      if (state === GenStateCompleted) {\n        if (method === \"throw\") {\n          throw arg;\n        }\n\n        // Be forgiving, per 25.3.3.3.3 of the spec:\n        // https://people.mozilla.org/~jorendorff/es6-draft.html#sec-generatorresume\n        return doneResult();\n      }\n\n      context.method = method;\n      context.arg = arg;\n\n      while (true) {\n        var delegate = context.delegate;\n        if (delegate) {\n          var delegateResult = maybeInvokeDelegate(delegate, context);\n          if (delegateResult) {\n            if (delegateResult === ContinueSentinel) continue;\n            return delegateResult;\n          }\n        }\n\n        if (context.method === \"next\") {\n          // Setting context._sent for legacy support of Babel's\n          // function.sent implementation.\n          context.sent = context._sent = context.arg;\n\n        } else if (context.method === \"throw\") {\n          if (state === GenStateSuspendedStart) {\n            state = GenStateCompleted;\n            throw context.arg;\n          }\n\n          context.dispatchException(context.arg);\n\n        } else if (context.method === \"return\") {\n          context.abrupt(\"return\", context.arg);\n        }\n\n        state = GenStateExecuting;\n\n        var record = tryCatch(innerFn, self, context);\n        if (record.type === \"normal\") {\n          // If an exception is thrown from innerFn, we leave state ===\n          // GenStateExecuting and loop back for another invocation.\n          state = context.done\n            ? GenStateCompleted\n            : GenStateSuspendedYield;\n\n          if (record.arg === ContinueSentinel) {\n            continue;\n          }\n\n          return {\n            value: record.arg,\n            done: context.done\n          };\n\n        } else if (record.type === \"throw\") {\n          state = GenStateCompleted;\n          // Dispatch the exception by looping back around to the\n          // context.dispatchException(context.arg) call above.\n          context.method = \"throw\";\n          context.arg = record.arg;\n        }\n      }\n    };\n  }\n\n  // Call delegate.iterator[context.method](context.arg) and handle the\n  // result, either by returning a { value, done } result from the\n  // delegate iterator, or by modifying context.method and context.arg,\n  // setting context.delegate to null, and returning the ContinueSentinel.\n  function maybeInvokeDelegate(delegate, context) {\n    var method = delegate.iterator[context.method];\n    if (method === undefined) {\n      // A .throw or .return when the delegate iterator has no .throw\n      // method always terminates the yield* loop.\n      context.delegate = null;\n\n      if (context.method === \"throw\") {\n        // Note: [\"return\"] must be used for ES3 parsing compatibility.\n        if (delegate.iterator[\"return\"]) {\n          // If the delegate iterator has a return method, give it a\n          // chance to clean up.\n          context.method = \"return\";\n          context.arg = undefined;\n          maybeInvokeDelegate(delegate, context);\n\n          if (context.method === \"throw\") {\n            // If maybeInvokeDelegate(context) changed context.method from\n            // \"return\" to \"throw\", let that override the TypeError below.\n            return ContinueSentinel;\n          }\n        }\n\n        context.method = \"throw\";\n        context.arg = new TypeError(\n          \"The iterator does not provide a 'throw' method\");\n      }\n\n      return ContinueSentinel;\n    }\n\n    var record = tryCatch(method, delegate.iterator, context.arg);\n\n    if (record.type === \"throw\") {\n      context.method = \"throw\";\n      context.arg = record.arg;\n      context.delegate = null;\n      return ContinueSentinel;\n    }\n\n    var info = record.arg;\n\n    if (! info) {\n      context.method = \"throw\";\n      context.arg = new TypeError(\"iterator result is not an object\");\n      context.delegate = null;\n      return ContinueSentinel;\n    }\n\n    if (info.done) {\n      // Assign the result of the finished delegate to the temporary\n      // variable specified by delegate.resultName (see delegateYield).\n      context[delegate.resultName] = info.value;\n\n      // Resume execution at the desired location (see delegateYield).\n      context.next = delegate.nextLoc;\n\n      // If context.method was \"throw\" but the delegate handled the\n      // exception, let the outer generator proceed normally. If\n      // context.method was \"next\", forget context.arg since it has been\n      // \"consumed\" by the delegate iterator. If context.method was\n      // \"return\", allow the original .return call to continue in the\n      // outer generator.\n      if (context.method !== \"return\") {\n        context.method = \"next\";\n        context.arg = undefined;\n      }\n\n    } else {\n      // Re-yield the result returned by the delegate method.\n      return info;\n    }\n\n    // The delegate iterator is finished, so forget it and continue with\n    // the outer generator.\n    context.delegate = null;\n    return ContinueSentinel;\n  }\n\n  // Define Generator.prototype.{next,throw,return} in terms of the\n  // unified ._invoke helper method.\n  defineIteratorMethods(Gp);\n\n  Gp[toStringTagSymbol] = \"Generator\";\n\n  // A Generator should always return itself as the iterator object when the\n  // @@iterator function is called on it. Some browsers' implementations of the\n  // iterator prototype chain incorrectly implement this, causing the Generator\n  // object to not be returned from this call. This ensures that doesn't happen.\n  // See https://github.com/facebook/regenerator/issues/274 for more details.\n  Gp[iteratorSymbol] = function() {\n    return this;\n  };\n\n  Gp.toString = function() {\n    return \"[object Generator]\";\n  };\n\n  function pushTryEntry(locs) {\n    var entry = { tryLoc: locs[0] };\n\n    if (1 in locs) {\n      entry.catchLoc = locs[1];\n    }\n\n    if (2 in locs) {\n      entry.finallyLoc = locs[2];\n      entry.afterLoc = locs[3];\n    }\n\n    this.tryEntries.push(entry);\n  }\n\n  function resetTryEntry(entry) {\n    var record = entry.completion || {};\n    record.type = \"normal\";\n    delete record.arg;\n    entry.completion = record;\n  }\n\n  function Context(tryLocsList) {\n    // The root entry object (effectively a try statement without a catch\n    // or a finally block) gives us a place to store values thrown from\n    // locations where there is no enclosing try statement.\n    this.tryEntries = [{ tryLoc: \"root\" }];\n    tryLocsList.forEach(pushTryEntry, this);\n    this.reset(true);\n  }\n\n  exports.keys = function(object) {\n    var keys = [];\n    for (var key in object) {\n      keys.push(key);\n    }\n    keys.reverse();\n\n    // Rather than returning an object with a next method, we keep\n    // things simple and return the next function itself.\n    return function next() {\n      while (keys.length) {\n        var key = keys.pop();\n        if (key in object) {\n          next.value = key;\n          next.done = false;\n          return next;\n        }\n      }\n\n      // To avoid creating an additional object, we just hang the .value\n      // and .done properties off the next function object itself. This\n      // also ensures that the minifier will not anonymize the function.\n      next.done = true;\n      return next;\n    };\n  };\n\n  function values(iterable) {\n    if (iterable) {\n      var iteratorMethod = iterable[iteratorSymbol];\n      if (iteratorMethod) {\n        return iteratorMethod.call(iterable);\n      }\n\n      if (typeof iterable.next === \"function\") {\n        return iterable;\n      }\n\n      if (!isNaN(iterable.length)) {\n        var i = -1, next = function next() {\n          while (++i < iterable.length) {\n            if (hasOwn.call(iterable, i)) {\n              next.value = iterable[i];\n              next.done = false;\n              return next;\n            }\n          }\n\n          next.value = undefined;\n          next.done = true;\n\n          return next;\n        };\n\n        return next.next = next;\n      }\n    }\n\n    // Return an iterator with no values.\n    return { next: doneResult };\n  }\n  exports.values = values;\n\n  function doneResult() {\n    return { value: undefined, done: true };\n  }\n\n  Context.prototype = {\n    constructor: Context,\n\n    reset: function(skipTempReset) {\n      this.prev = 0;\n      this.next = 0;\n      // Resetting context._sent for legacy support of Babel's\n      // function.sent implementation.\n      this.sent = this._sent = undefined;\n      this.done = false;\n      this.delegate = null;\n\n      this.method = \"next\";\n      this.arg = undefined;\n\n      this.tryEntries.forEach(resetTryEntry);\n\n      if (!skipTempReset) {\n        for (var name in this) {\n          // Not sure about the optimal order of these conditions:\n          if (name.charAt(0) === \"t\" &&\n              hasOwn.call(this, name) &&\n              !isNaN(+name.slice(1))) {\n            this[name] = undefined;\n          }\n        }\n      }\n    },\n\n    stop: function() {\n      this.done = true;\n\n      var rootEntry = this.tryEntries[0];\n      var rootRecord = rootEntry.completion;\n      if (rootRecord.type === \"throw\") {\n        throw rootRecord.arg;\n      }\n\n      return this.rval;\n    },\n\n    dispatchException: function(exception) {\n      if (this.done) {\n        throw exception;\n      }\n\n      var context = this;\n      function handle(loc, caught) {\n        record.type = \"throw\";\n        record.arg = exception;\n        context.next = loc;\n\n        if (caught) {\n          // If the dispatched exception was caught by a catch block,\n          // then let that catch block handle the exception normally.\n          context.method = \"next\";\n          context.arg = undefined;\n        }\n\n        return !! caught;\n      }\n\n      for (var i = this.tryEntries.length - 1; i >= 0; --i) {\n        var entry = this.tryEntries[i];\n        var record = entry.completion;\n\n        if (entry.tryLoc === \"root\") {\n          // Exception thrown outside of any try block that could handle\n          // it, so set the completion value of the entire function to\n          // throw the exception.\n          return handle(\"end\");\n        }\n\n        if (entry.tryLoc <= this.prev) {\n          var hasCatch = hasOwn.call(entry, \"catchLoc\");\n          var hasFinally = hasOwn.call(entry, \"finallyLoc\");\n\n          if (hasCatch && hasFinally) {\n            if (this.prev < entry.catchLoc) {\n              return handle(entry.catchLoc, true);\n            } else if (this.prev < entry.finallyLoc) {\n              return handle(entry.finallyLoc);\n            }\n\n          } else if (hasCatch) {\n            if (this.prev < entry.catchLoc) {\n              return handle(entry.catchLoc, true);\n            }\n\n          } else if (hasFinally) {\n            if (this.prev < entry.finallyLoc) {\n              return handle(entry.finallyLoc);\n            }\n\n          } else {\n            throw new Error(\"try statement without catch or finally\");\n          }\n        }\n      }\n    },\n\n    abrupt: function(type, arg) {\n      for (var i = this.tryEntries.length - 1; i >= 0; --i) {\n        var entry = this.tryEntries[i];\n        if (entry.tryLoc <= this.prev &&\n            hasOwn.call(entry, \"finallyLoc\") &&\n            this.prev < entry.finallyLoc) {\n          var finallyEntry = entry;\n          break;\n        }\n      }\n\n      if (finallyEntry &&\n          (type === \"break\" ||\n           type === \"continue\") &&\n          finallyEntry.tryLoc <= arg &&\n          arg <= finallyEntry.finallyLoc) {\n        // Ignore the finally entry if control is not jumping to a\n        // location outside the try/catch block.\n        finallyEntry = null;\n      }\n\n      var record = finallyEntry ? finallyEntry.completion : {};\n      record.type = type;\n      record.arg = arg;\n\n      if (finallyEntry) {\n        this.method = \"next\";\n        this.next = finallyEntry.finallyLoc;\n        return ContinueSentinel;\n      }\n\n      return this.complete(record);\n    },\n\n    complete: function(record, afterLoc) {\n      if (record.type === \"throw\") {\n        throw record.arg;\n      }\n\n      if (record.type === \"break\" ||\n          record.type === \"continue\") {\n        this.next = record.arg;\n      } else if (record.type === \"return\") {\n        this.rval = this.arg = record.arg;\n        this.method = \"return\";\n        this.next = \"end\";\n      } else if (record.type === \"normal\" && afterLoc) {\n        this.next = afterLoc;\n      }\n\n      return ContinueSentinel;\n    },\n\n    finish: function(finallyLoc) {\n      for (var i = this.tryEntries.length - 1; i >= 0; --i) {\n        var entry = this.tryEntries[i];\n        if (entry.finallyLoc === finallyLoc) {\n          this.complete(entry.completion, entry.afterLoc);\n          resetTryEntry(entry);\n          return ContinueSentinel;\n        }\n      }\n    },\n\n    \"catch\": function(tryLoc) {\n      for (var i = this.tryEntries.length - 1; i >= 0; --i) {\n        var entry = this.tryEntries[i];\n        if (entry.tryLoc === tryLoc) {\n          var record = entry.completion;\n          if (record.type === \"throw\") {\n            var thrown = record.arg;\n            resetTryEntry(entry);\n          }\n          return thrown;\n        }\n      }\n\n      // The context.catch method must only be called with a location\n      // argument that corresponds to a known catch block.\n      throw new Error(\"illegal catch attempt\");\n    },\n\n    delegateYield: function(iterable, resultName, nextLoc) {\n      this.delegate = {\n        iterator: values(iterable),\n        resultName: resultName,\n        nextLoc: nextLoc\n      };\n\n      if (this.method === \"next\") {\n        // Deliberately forget the last sent value so that we don't\n        // accidentally pass it on to the delegate.\n        this.arg = undefined;\n      }\n\n      return ContinueSentinel;\n    }\n  };\n\n  // Regardless of whether this script is executing as a CommonJS module\n  // or not, return the runtime object so that we can declare the variable\n  // regeneratorRuntime in the outer scope, which allows this module to be\n  // injected easily by `bin/regenerator --include-runtime script.js`.\n  return exports;\n\n}(\n  // If this script is executing as a CommonJS module, use module.exports\n  // as the regeneratorRuntime namespace. Otherwise create a new empty\n  // object. Either way, the resulting object will be used to initialize\n  // the regeneratorRuntime variable at the top of this file.\n  typeof module === \"object\" ? module.exports : {}\n));\n\ntry {\n  regeneratorRuntime = runtime;\n} catch (accidentalStrictMode) {\n  // This module should not be running in strict mode, so the above\n  // assignment should always work unless something is misconfigured. Just\n  // in case runtime.js accidentally runs in strict mode, we can escape\n  // strict mode using a global Function call. This could conceivably fail\n  // if a Content Security Policy forbids using Function, but in that case\n  // the proper solution is to fix the accidental strict mode problem. If\n  // you've misconfigured your bundler to force strict mode and applied a\n  // CSP to forbid Function, and you're not willing to fix either of those\n  // problems, please detail your unique predicament in a GitHub issue.\n  Function(\"r\", \"regeneratorRuntime = r\")(runtime);\n}\n","/* global window, document */\n/* eslint-disable max-statements */\nimport Mapbox from 'react-map-gl/dist/esm/mapbox/mapbox';\n\nimport {Deck} from '../src';\n\nconst CANVAS_STYLE = {\n  position: 'absolute',\n  left: 0,\n  top: 0,\n  width: '100%',\n  height: '100%'\n};\n\n// Create canvas elements for map and deck\nfunction createCanvas(props) {\n  let {container = document.body} = props;\n\n  if (typeof container === 'string') {\n    container = document.getElementById(container);\n  }\n\n  if (!container) {\n    throw Error('Deck: container not found');\n  }\n\n  // Add DOM elements\n  const containerStyle = window.getComputedStyle(container);\n  if (containerStyle.position === 'static') {\n    container.style.position = 'relative';\n  }\n\n  const mapCanvas = document.createElement('div');\n  container.appendChild(mapCanvas);\n  Object.assign(mapCanvas.style, CANVAS_STYLE);\n\n  const deckCanvas = document.createElement('canvas');\n  container.appendChild(deckCanvas);\n  Object.assign(deckCanvas.style, CANVAS_STYLE);\n\n  return {container, mapCanvas, deckCanvas};\n}\n\n/**\n * @params container (Element) - DOM element to add deck.gl canvas to\n * @params map (Object) - map API. Set to falsy to disable\n */\nexport default class DeckGL extends Deck {\n  constructor(props = {}) {\n    if (typeof document === 'undefined') {\n      // Not browser\n      throw Error('Deck can only be used in the browser');\n    }\n\n    const {mapCanvas, deckCanvas} = createCanvas(props);\n\n    const viewState = props.viewState || props.initialViewState;\n    const isMap = Number.isFinite(viewState && viewState.latitude);\n    const {map = window.mapboxgl} = props;\n\n    super({canvas: deckCanvas, ...props});\n\n    if (map && map.Map) {\n      // Default create mapbox map\n      this._map =\n        isMap &&\n        new Mapbox({\n          ...props,\n          viewState,\n          container: mapCanvas,\n          mapboxgl: map\n        });\n    } else {\n      this._map = map;\n    }\n\n    // Update base map\n    this._onBeforeRender = params => {\n      this.onBeforeRender(params);\n      if (this._map) {\n        const viewport = this.getViewports()[0];\n        this._map.setProps({\n          width: viewport.width,\n          height: viewport.height,\n          viewState: viewport\n        });\n      }\n    };\n  }\n\n  getMapboxMap() {\n    return this._map && this._map.getMap();\n  }\n\n  finalize() {\n    if (this._map) {\n      this._map.finalize();\n    }\n\n    super.finalize();\n  }\n\n  setProps(props) {\n    // Replace user callback with our own\n    // `setProps` is first called in parent class constructor\n    // During which this._onBeforeRender is not defined\n    // It is called a second time in _onRendererInitialized with all current props\n    if (\n      'onBeforeRender' in props &&\n      this._onBeforeRender &&\n      props.onBeforeRender !== this._onBeforeRender\n    ) {\n      this.onBeforeRender = props.onBeforeRender;\n      props.onBeforeRender = this._onBeforeRender;\n    }\n    if ('mapStyle' in props && this._map) {\n      this._map._map.setStyle(props.mapStyle);\n    }\n\n    super.setProps(props);\n  }\n}\n","/**\n * Copyright (c) 2013-present, Facebook, Inc.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n'use strict';\n\nvar ReactPropTypesSecret = require('./lib/ReactPropTypesSecret');\n\nfunction emptyFunction() {}\nfunction emptyFunctionWithReset() {}\nemptyFunctionWithReset.resetWarningCache = emptyFunction;\n\nmodule.exports = function() {\n  function shim(props, propName, componentName, location, propFullName, secret) {\n    if (secret === ReactPropTypesSecret) {\n      // It is still safe when called from React.\n      return;\n    }\n    var err = new Error(\n      'Calling PropTypes validators directly is not supported by the `prop-types` package. ' +\n      'Use PropTypes.checkPropTypes() to call them. ' +\n      'Read more at http://fb.me/use-check-prop-types'\n    );\n    err.name = 'Invariant Violation';\n    throw err;\n  };\n  shim.isRequired = shim;\n  function getShim() {\n    return shim;\n  };\n  // Important!\n  // Keep this list in sync with production version in `./factoryWithTypeCheckers.js`.\n  var ReactPropTypes = {\n    array: shim,\n    bool: shim,\n    func: shim,\n    number: shim,\n    object: shim,\n    string: shim,\n    symbol: shim,\n\n    any: shim,\n    arrayOf: getShim,\n    element: shim,\n    elementType: shim,\n    instanceOf: getShim,\n    node: shim,\n    objectOf: getShim,\n    oneOf: getShim,\n    oneOfType: getShim,\n    shape: getShim,\n    exact: getShim,\n\n    checkPropTypes: emptyFunctionWithReset,\n    resetWarningCache: emptyFunction\n  };\n\n  ReactPropTypes.PropTypes = ReactPropTypes;\n\n  return ReactPropTypes;\n};\n","/**\n * Copyright (c) 2013-present, Facebook, Inc.\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n'use strict';\n\nvar ReactPropTypesSecret = 'SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED';\n\nmodule.exports = ReactPropTypesSecret;\n","function _objectWithoutPropertiesLoose(source, excluded) {\n  if (source == null) return {};\n  var target = {};\n  var sourceKeys = Object.keys(source);\n  var key, i;\n\n  for (i = 0; i < sourceKeys.length; i++) {\n    key = sourceKeys[i];\n    if (excluded.indexOf(key) >= 0) continue;\n    target[key] = source[key];\n  }\n\n  return target;\n}\n\nmodule.exports = _objectWithoutPropertiesLoose;","/*!\n * The buffer module from node.js, for the browser.\n *\n * @author   Feross Aboukhadijeh <http://feross.org>\n * @license  MIT\n */\n/* eslint-disable no-proto */\n\n'use strict'\n\nvar base64 = require('base64-js')\nvar ieee754 = require('ieee754')\nvar isArray = require('isarray')\n\nexports.Buffer = Buffer\nexports.SlowBuffer = SlowBuffer\nexports.INSPECT_MAX_BYTES = 50\n\n/**\n * If `Buffer.TYPED_ARRAY_SUPPORT`:\n *   === true    Use Uint8Array implementation (fastest)\n *   === false   Use Object implementation (most compatible, even IE6)\n *\n * Browsers that support typed arrays are IE 10+, Firefox 4+, Chrome 7+, Safari 5.1+,\n * Opera 11.6+, iOS 4.2+.\n *\n * Due to various browser bugs, sometimes the Object implementation will be used even\n * when the browser supports typed arrays.\n *\n * Note:\n *\n *   - Firefox 4-29 lacks support for adding new properties to `Uint8Array` instances,\n *     See: https://bugzilla.mozilla.org/show_bug.cgi?id=695438.\n *\n *   - Chrome 9-10 is missing the `TypedArray.prototype.subarray` function.\n *\n *   - IE10 has a broken `TypedArray.prototype.subarray` function which returns arrays of\n *     incorrect length in some situations.\n\n * We detect these buggy browsers and set `Buffer.TYPED_ARRAY_SUPPORT` to `false` so they\n * get the Object implementation, which is slower but behaves correctly.\n */\nBuffer.TYPED_ARRAY_SUPPORT = global.TYPED_ARRAY_SUPPORT !== undefined\n  ? global.TYPED_ARRAY_SUPPORT\n  : typedArraySupport()\n\n/*\n * Export kMaxLength after typed array support is determined.\n */\nexports.kMaxLength = kMaxLength()\n\nfunction typedArraySupport () {\n  try {\n    var arr = new Uint8Array(1)\n    arr.__proto__ = {__proto__: Uint8Array.prototype, foo: function () { return 42 }}\n    return arr.foo() === 42 && // typed array instances can be augmented\n        typeof arr.subarray === 'function' && // chrome 9-10 lack `subarray`\n        arr.subarray(1, 1).byteLength === 0 // ie10 has broken `subarray`\n  } catch (e) {\n    return false\n  }\n}\n\nfunction kMaxLength () {\n  return Buffer.TYPED_ARRAY_SUPPORT\n    ? 0x7fffffff\n    : 0x3fffffff\n}\n\nfunction createBuffer (that, length) {\n  if (kMaxLength() < length) {\n    throw new RangeError('Invalid typed array length')\n  }\n  if (Buffer.TYPED_ARRAY_SUPPORT) {\n    // Return an augmented `Uint8Array` instance, for best performance\n    that = new Uint8Array(length)\n    that.__proto__ = Buffer.prototype\n  } else {\n    // Fallback: Return an object instance of the Buffer class\n    if (that === null) {\n      that = new Buffer(length)\n    }\n    that.length = length\n  }\n\n  return that\n}\n\n/**\n * The Buffer constructor returns instances of `Uint8Array` that have their\n * prototype changed to `Buffer.prototype`. Furthermore, `Buffer` is a subclass of\n * `Uint8Array`, so the returned instances will have all the node `Buffer` methods\n * and the `Uint8Array` methods. Square bracket notation works as expected -- it\n * returns a single octet.\n *\n * The `Uint8Array` prototype remains unmodified.\n */\n\nfunction Buffer (arg, encodingOrOffset, length) {\n  if (!Buffer.TYPED_ARRAY_SUPPORT && !(this instanceof Buffer)) {\n    return new Buffer(arg, encodingOrOffset, length)\n  }\n\n  // Common case.\n  if (typeof arg === 'number') {\n    if (typeof encodingOrOffset === 'string') {\n      throw new Error(\n        'If encoding is specified then the first argument must be a string'\n      )\n    }\n    return allocUnsafe(this, arg)\n  }\n  return from(this, arg, encodingOrOffset, length)\n}\n\nBuffer.poolSize = 8192 // not used by this implementation\n\n// TODO: Legacy, not needed anymore. Remove in next major version.\nBuffer._augment = function (arr) {\n  arr.__proto__ = Buffer.prototype\n  return arr\n}\n\nfunction from (that, value, encodingOrOffset, length) {\n  if (typeof value === 'number') {\n    throw new TypeError('\"value\" argument must not be a number')\n  }\n\n  if (typeof ArrayBuffer !== 'undefined' && value instanceof ArrayBuffer) {\n    return fromArrayBuffer(that, value, encodingOrOffset, length)\n  }\n\n  if (typeof value === 'string') {\n    return fromString(that, value, encodingOrOffset)\n  }\n\n  return fromObject(that, value)\n}\n\n/**\n * Functionally equivalent to Buffer(arg, encoding) but throws a TypeError\n * if value is a number.\n * Buffer.from(str[, encoding])\n * Buffer.from(array)\n * Buffer.from(buffer)\n * Buffer.from(arrayBuffer[, byteOffset[, length]])\n **/\nBuffer.from = function (value, encodingOrOffset, length) {\n  return from(null, value, encodingOrOffset, length)\n}\n\nif (Buffer.TYPED_ARRAY_SUPPORT) {\n  Buffer.prototype.__proto__ = Uint8Array.prototype\n  Buffer.__proto__ = Uint8Array\n  if (typeof Symbol !== 'undefined' && Symbol.species &&\n      Buffer[Symbol.species] === Buffer) {\n    // Fix subarray() in ES2016. See: https://github.com/feross/buffer/pull/97\n    Object.defineProperty(Buffer, Symbol.species, {\n      value: null,\n      configurable: true\n    })\n  }\n}\n\nfunction assertSize (size) {\n  if (typeof size !== 'number') {\n    throw new TypeError('\"size\" argument must be a number')\n  } else if (size < 0) {\n    throw new RangeError('\"size\" argument must not be negative')\n  }\n}\n\nfunction alloc (that, size, fill, encoding) {\n  assertSize(size)\n  if (size <= 0) {\n    return createBuffer(that, size)\n  }\n  if (fill !== undefined) {\n    // Only pay attention to encoding if it's a string. This\n    // prevents accidentally sending in a number that would\n    // be interpretted as a start offset.\n    return typeof encoding === 'string'\n      ? createBuffer(that, size).fill(fill, encoding)\n      : createBuffer(that, size).fill(fill)\n  }\n  return createBuffer(that, size)\n}\n\n/**\n * Creates a new filled Buffer instance.\n * alloc(size[, fill[, encoding]])\n **/\nBuffer.alloc = function (size, fill, encoding) {\n  return alloc(null, size, fill, encoding)\n}\n\nfunction allocUnsafe (that, size) {\n  assertSize(size)\n  that = createBuffer(that, size < 0 ? 0 : checked(size) | 0)\n  if (!Buffer.TYPED_ARRAY_SUPPORT) {\n    for (var i = 0; i < size; ++i) {\n      that[i] = 0\n    }\n  }\n  return that\n}\n\n/**\n * Equivalent to Buffer(num), by default creates a non-zero-filled Buffer instance.\n * */\nBuffer.allocUnsafe = function (size) {\n  return allocUnsafe(null, size)\n}\n/**\n * Equivalent to SlowBuffer(num), by default creates a non-zero-filled Buffer instance.\n */\nBuffer.allocUnsafeSlow = function (size) {\n  return allocUnsafe(null, size)\n}\n\nfunction fromString (that, string, encoding) {\n  if (typeof encoding !== 'string' || encoding === '') {\n    encoding = 'utf8'\n  }\n\n  if (!Buffer.isEncoding(encoding)) {\n    throw new TypeError('\"encoding\" must be a valid string encoding')\n  }\n\n  var length = byteLength(string, encoding) | 0\n  that = createBuffer(that, length)\n\n  var actual = that.write(string, encoding)\n\n  if (actual !== length) {\n    // Writing a hex string, for example, that contains invalid characters will\n    // cause everything after the first invalid character to be ignored. (e.g.\n    // 'abxxcd' will be treated as 'ab')\n    that = that.slice(0, actual)\n  }\n\n  return that\n}\n\nfunction fromArrayLike (that, array) {\n  var length = array.length < 0 ? 0 : checked(array.length) | 0\n  that = createBuffer(that, length)\n  for (var i = 0; i < length; i += 1) {\n    that[i] = array[i] & 255\n  }\n  return that\n}\n\nfunction fromArrayBuffer (that, array, byteOffset, length) {\n  array.byteLength // this throws if `array` is not a valid ArrayBuffer\n\n  if (byteOffset < 0 || array.byteLength < byteOffset) {\n    throw new RangeError('\\'offset\\' is out of bounds')\n  }\n\n  if (array.byteLength < byteOffset + (length || 0)) {\n    throw new RangeError('\\'length\\' is out of bounds')\n  }\n\n  if (byteOffset === undefined && length === undefined) {\n    array = new Uint8Array(array)\n  } else if (length === undefined) {\n    array = new Uint8Array(array, byteOffset)\n  } else {\n    array = new Uint8Array(array, byteOffset, length)\n  }\n\n  if (Buffer.TYPED_ARRAY_SUPPORT) {\n    // Return an augmented `Uint8Array` instance, for best performance\n    that = array\n    that.__proto__ = Buffer.prototype\n  } else {\n    // Fallback: Return an object instance of the Buffer class\n    that = fromArrayLike(that, array)\n  }\n  return that\n}\n\nfunction fromObject (that, obj) {\n  if (Buffer.isBuffer(obj)) {\n    var len = checked(obj.length) | 0\n    that = createBuffer(that, len)\n\n    if (that.length === 0) {\n      return that\n    }\n\n    obj.copy(that, 0, 0, len)\n    return that\n  }\n\n  if (obj) {\n    if ((typeof ArrayBuffer !== 'undefined' &&\n        obj.buffer instanceof ArrayBuffer) || 'length' in obj) {\n      if (typeof obj.length !== 'number' || isnan(obj.length)) {\n        return createBuffer(that, 0)\n      }\n      return fromArrayLike(that, obj)\n    }\n\n    if (obj.type === 'Buffer' && isArray(obj.data)) {\n      return fromArrayLike(that, obj.data)\n    }\n  }\n\n  throw new TypeError('First argument must be a string, Buffer, ArrayBuffer, Array, or array-like object.')\n}\n\nfunction checked (length) {\n  // Note: cannot use `length < kMaxLength()` here because that fails when\n  // length is NaN (which is otherwise coerced to zero.)\n  if (length >= kMaxLength()) {\n    throw new RangeError('Attempt to allocate Buffer larger than maximum ' +\n                         'size: 0x' + kMaxLength().toString(16) + ' bytes')\n  }\n  return length | 0\n}\n\nfunction SlowBuffer (length) {\n  if (+length != length) { // eslint-disable-line eqeqeq\n    length = 0\n  }\n  return Buffer.alloc(+length)\n}\n\nBuffer.isBuffer = function isBuffer (b) {\n  return !!(b != null && b._isBuffer)\n}\n\nBuffer.compare = function compare (a, b) {\n  if (!Buffer.isBuffer(a) || !Buffer.isBuffer(b)) {\n    throw new TypeError('Arguments must be Buffers')\n  }\n\n  if (a === b) return 0\n\n  var x = a.length\n  var y = b.length\n\n  for (var i = 0, len = Math.min(x, y); i < len; ++i) {\n    if (a[i] !== b[i]) {\n      x = a[i]\n      y = b[i]\n      break\n    }\n  }\n\n  if (x < y) return -1\n  if (y < x) return 1\n  return 0\n}\n\nBuffer.isEncoding = function isEncoding (encoding) {\n  switch (String(encoding).toLowerCase()) {\n    case 'hex':\n    case 'utf8':\n    case 'utf-8':\n    case 'ascii':\n    case 'latin1':\n    case 'binary':\n    case 'base64':\n    case 'ucs2':\n    case 'ucs-2':\n    case 'utf16le':\n    case 'utf-16le':\n      return true\n    default:\n      return false\n  }\n}\n\nBuffer.concat = function concat (list, length) {\n  if (!isArray(list)) {\n    throw new TypeError('\"list\" argument must be an Array of Buffers')\n  }\n\n  if (list.length === 0) {\n    return Buffer.alloc(0)\n  }\n\n  var i\n  if (length === undefined) {\n    length = 0\n    for (i = 0; i < list.length; ++i) {\n      length += list[i].length\n    }\n  }\n\n  var buffer = Buffer.allocUnsafe(length)\n  var pos = 0\n  for (i = 0; i < list.length; ++i) {\n    var buf = list[i]\n    if (!Buffer.isBuffer(buf)) {\n      throw new TypeError('\"list\" argument must be an Array of Buffers')\n    }\n    buf.copy(buffer, pos)\n    pos += buf.length\n  }\n  return buffer\n}\n\nfunction byteLength (string, encoding) {\n  if (Buffer.isBuffer(string)) {\n    return string.length\n  }\n  if (typeof ArrayBuffer !== 'undefined' && typeof ArrayBuffer.isView === 'function' &&\n      (ArrayBuffer.isView(string) || string instanceof ArrayBuffer)) {\n    return string.byteLength\n  }\n  if (typeof string !== 'string') {\n    string = '' + string\n  }\n\n  var len = string.length\n  if (len === 0) return 0\n\n  // Use a for loop to avoid recursion\n  var loweredCase = false\n  for (;;) {\n    switch (encoding) {\n      case 'ascii':\n      case 'latin1':\n      case 'binary':\n        return len\n      case 'utf8':\n      case 'utf-8':\n      case undefined:\n        return utf8ToBytes(string).length\n      case 'ucs2':\n      case 'ucs-2':\n      case 'utf16le':\n      case 'utf-16le':\n        return len * 2\n      case 'hex':\n        return len >>> 1\n      case 'base64':\n        return base64ToBytes(string).length\n      default:\n        if (loweredCase) return utf8ToBytes(string).length // assume utf8\n        encoding = ('' + encoding).toLowerCase()\n        loweredCase = true\n    }\n  }\n}\nBuffer.byteLength = byteLength\n\nfunction slowToString (encoding, start, end) {\n  var loweredCase = false\n\n  // No need to verify that \"this.length <= MAX_UINT32\" since it's a read-only\n  // property of a typed array.\n\n  // This behaves neither like String nor Uint8Array in that we set start/end\n  // to their upper/lower bounds if the value passed is out of range.\n  // undefined is handled specially as per ECMA-262 6th Edition,\n  // Section 13.3.3.7 Runtime Semantics: KeyedBindingInitialization.\n  if (start === undefined || start < 0) {\n    start = 0\n  }\n  // Return early if start > this.length. Done here to prevent potential uint32\n  // coercion fail below.\n  if (start > this.length) {\n    return ''\n  }\n\n  if (end === undefined || end > this.length) {\n    end = this.length\n  }\n\n  if (end <= 0) {\n    return ''\n  }\n\n  // Force coersion to uint32. This will also coerce falsey/NaN values to 0.\n  end >>>= 0\n  start >>>= 0\n\n  if (end <= start) {\n    return ''\n  }\n\n  if (!encoding) encoding = 'utf8'\n\n  while (true) {\n    switch (encoding) {\n      case 'hex':\n        return hexSlice(this, start, end)\n\n      case 'utf8':\n      case 'utf-8':\n        return utf8Slice(this, start, end)\n\n      case 'ascii':\n        return asciiSlice(this, start, end)\n\n      case 'latin1':\n      case 'binary':\n        return latin1Slice(this, start, end)\n\n      case 'base64':\n        return base64Slice(this, start, end)\n\n      case 'ucs2':\n      case 'ucs-2':\n      case 'utf16le':\n      case 'utf-16le':\n        return utf16leSlice(this, start, end)\n\n      default:\n        if (loweredCase) throw new TypeError('Unknown encoding: ' + encoding)\n        encoding = (encoding + '').toLowerCase()\n        loweredCase = true\n    }\n  }\n}\n\n// The property is used by `Buffer.isBuffer` and `is-buffer` (in Safari 5-7) to detect\n// Buffer instances.\nBuffer.prototype._isBuffer = true\n\nfunction swap (b, n, m) {\n  var i = b[n]\n  b[n] = b[m]\n  b[m] = i\n}\n\nBuffer.prototype.swap16 = function swap16 () {\n  var len = this.length\n  if (len % 2 !== 0) {\n    throw new RangeError('Buffer size must be a multiple of 16-bits')\n  }\n  for (var i = 0; i < len; i += 2) {\n    swap(this, i, i + 1)\n  }\n  return this\n}\n\nBuffer.prototype.swap32 = function swap32 () {\n  var len = this.length\n  if (len % 4 !== 0) {\n    throw new RangeError('Buffer size must be a multiple of 32-bits')\n  }\n  for (var i = 0; i < len; i += 4) {\n    swap(this, i, i + 3)\n    swap(this, i + 1, i + 2)\n  }\n  return this\n}\n\nBuffer.prototype.swap64 = function swap64 () {\n  var len = this.length\n  if (len % 8 !== 0) {\n    throw new RangeError('Buffer size must be a multiple of 64-bits')\n  }\n  for (var i = 0; i < len; i += 8) {\n    swap(this, i, i + 7)\n    swap(this, i + 1, i + 6)\n    swap(this, i + 2, i + 5)\n    swap(this, i + 3, i + 4)\n  }\n  return this\n}\n\nBuffer.prototype.toString = function toString () {\n  var length = this.length | 0\n  if (length === 0) return ''\n  if (arguments.length === 0) return utf8Slice(this, 0, length)\n  return slowToString.apply(this, arguments)\n}\n\nBuffer.prototype.equals = function equals (b) {\n  if (!Buffer.isBuffer(b)) throw new TypeError('Argument must be a Buffer')\n  if (this === b) return true\n  return Buffer.compare(this, b) === 0\n}\n\nBuffer.prototype.inspect = function inspect () {\n  var str = ''\n  var max = exports.INSPECT_MAX_BYTES\n  if (this.length > 0) {\n    str = this.toString('hex', 0, max).match(/.{2}/g).join(' ')\n    if (this.length > max) str += ' ... '\n  }\n  return '<Buffer ' + str + '>'\n}\n\nBuffer.prototype.compare = function compare (target, start, end, thisStart, thisEnd) {\n  if (!Buffer.isBuffer(target)) {\n    throw new TypeError('Argument must be a Buffer')\n  }\n\n  if (start === undefined) {\n    start = 0\n  }\n  if (end === undefined) {\n    end = target ? target.length : 0\n  }\n  if (thisStart === undefined) {\n    thisStart = 0\n  }\n  if (thisEnd === undefined) {\n    thisEnd = this.length\n  }\n\n  if (start < 0 || end > target.length || thisStart < 0 || thisEnd > this.length) {\n    throw new RangeError('out of range index')\n  }\n\n  if (thisStart >= thisEnd && start >= end) {\n    return 0\n  }\n  if (thisStart >= thisEnd) {\n    return -1\n  }\n  if (start >= end) {\n    return 1\n  }\n\n  start >>>= 0\n  end >>>= 0\n  thisStart >>>= 0\n  thisEnd >>>= 0\n\n  if (this === target) return 0\n\n  var x = thisEnd - thisStart\n  var y = end - start\n  var len = Math.min(x, y)\n\n  var thisCopy = this.slice(thisStart, thisEnd)\n  var targetCopy = target.slice(start, end)\n\n  for (var i = 0; i < len; ++i) {\n    if (thisCopy[i] !== targetCopy[i]) {\n      x = thisCopy[i]\n      y = targetCopy[i]\n      break\n    }\n  }\n\n  if (x < y) return -1\n  if (y < x) return 1\n  return 0\n}\n\n// Finds either the first index of `val` in `buffer` at offset >= `byteOffset`,\n// OR the last index of `val` in `buffer` at offset <= `byteOffset`.\n//\n// Arguments:\n// - buffer - a Buffer to search\n// - val - a string, Buffer, or number\n// - byteOffset - an index into `buffer`; will be clamped to an int32\n// - encoding - an optional encoding, relevant is val is a string\n// - dir - true for indexOf, false for lastIndexOf\nfunction bidirectionalIndexOf (buffer, val, byteOffset, encoding, dir) {\n  // Empty buffer means no match\n  if (buffer.length === 0) return -1\n\n  // Normalize byteOffset\n  if (typeof byteOffset === 'string') {\n    encoding = byteOffset\n    byteOffset = 0\n  } else if (byteOffset > 0x7fffffff) {\n    byteOffset = 0x7fffffff\n  } else if (byteOffset < -0x80000000) {\n    byteOffset = -0x80000000\n  }\n  byteOffset = +byteOffset  // Coerce to Number.\n  if (isNaN(byteOffset)) {\n    // byteOffset: it it's undefined, null, NaN, \"foo\", etc, search whole buffer\n    byteOffset = dir ? 0 : (buffer.length - 1)\n  }\n\n  // Normalize byteOffset: negative offsets start from the end of the buffer\n  if (byteOffset < 0) byteOffset = buffer.length + byteOffset\n  if (byteOffset >= buffer.length) {\n    if (dir) return -1\n    else byteOffset = buffer.length - 1\n  } else if (byteOffset < 0) {\n    if (dir) byteOffset = 0\n    else return -1\n  }\n\n  // Normalize val\n  if (typeof val === 'string') {\n    val = Buffer.from(val, encoding)\n  }\n\n  // Finally, search either indexOf (if dir is true) or lastIndexOf\n  if (Buffer.isBuffer(val)) {\n    // Special case: looking for empty string/buffer always fails\n    if (val.length === 0) {\n      return -1\n    }\n    return arrayIndexOf(buffer, val, byteOffset, encoding, dir)\n  } else if (typeof val === 'number') {\n    val = val & 0xFF // Search for a byte value [0-255]\n    if (Buffer.TYPED_ARRAY_SUPPORT &&\n        typeof Uint8Array.prototype.indexOf === 'function') {\n      if (dir) {\n        return Uint8Array.prototype.indexOf.call(buffer, val, byteOffset)\n      } else {\n        return Uint8Array.prototype.lastIndexOf.call(buffer, val, byteOffset)\n      }\n    }\n    return arrayIndexOf(buffer, [ val ], byteOffset, encoding, dir)\n  }\n\n  throw new TypeError('val must be string, number or Buffer')\n}\n\nfunction arrayIndexOf (arr, val, byteOffset, encoding, dir) {\n  var indexSize = 1\n  var arrLength = arr.length\n  var valLength = val.length\n\n  if (encoding !== undefined) {\n    encoding = String(encoding).toLowerCase()\n    if (encoding === 'ucs2' || encoding === 'ucs-2' ||\n        encoding === 'utf16le' || encoding === 'utf-16le') {\n      if (arr.length < 2 || val.length < 2) {\n        return -1\n      }\n      indexSize = 2\n      arrLength /= 2\n      valLength /= 2\n      byteOffset /= 2\n    }\n  }\n\n  function read (buf, i) {\n    if (indexSize === 1) {\n      return buf[i]\n    } else {\n      return buf.readUInt16BE(i * indexSize)\n    }\n  }\n\n  var i\n  if (dir) {\n    var foundIndex = -1\n    for (i = byteOffset; i < arrLength; i++) {\n      if (read(arr, i) === read(val, foundIndex === -1 ? 0 : i - foundIndex)) {\n        if (foundIndex === -1) foundIndex = i\n        if (i - foundIndex + 1 === valLength) return foundIndex * indexSize\n      } else {\n        if (foundIndex !== -1) i -= i - foundIndex\n        foundIndex = -1\n      }\n    }\n  } else {\n    if (byteOffset + valLength > arrLength) byteOffset = arrLength - valLength\n    for (i = byteOffset; i >= 0; i--) {\n      var found = true\n      for (var j = 0; j < valLength; j++) {\n        if (read(arr, i + j) !== read(val, j)) {\n          found = false\n          break\n        }\n      }\n      if (found) return i\n    }\n  }\n\n  return -1\n}\n\nBuffer.prototype.includes = function includes (val, byteOffset, encoding) {\n  return this.indexOf(val, byteOffset, encoding) !== -1\n}\n\nBuffer.prototype.indexOf = function indexOf (val, byteOffset, encoding) {\n  return bidirectionalIndexOf(this, val, byteOffset, encoding, true)\n}\n\nBuffer.prototype.lastIndexOf = function lastIndexOf (val, byteOffset, encoding) {\n  return bidirectionalIndexOf(this, val, byteOffset, encoding, false)\n}\n\nfunction hexWrite (buf, string, offset, length) {\n  offset = Number(offset) || 0\n  var remaining = buf.length - offset\n  if (!length) {\n    length = remaining\n  } else {\n    length = Number(length)\n    if (length > remaining) {\n      length = remaining\n    }\n  }\n\n  // must be an even number of digits\n  var strLen = string.length\n  if (strLen % 2 !== 0) throw new TypeError('Invalid hex string')\n\n  if (length > strLen / 2) {\n    length = strLen / 2\n  }\n  for (var i = 0; i < length; ++i) {\n    var parsed = parseInt(string.substr(i * 2, 2), 16)\n    if (isNaN(parsed)) return i\n    buf[offset + i] = parsed\n  }\n  return i\n}\n\nfunction utf8Write (buf, string, offset, length) {\n  return blitBuffer(utf8ToBytes(string, buf.length - offset), buf, offset, length)\n}\n\nfunction asciiWrite (buf, string, offset, length) {\n  return blitBuffer(asciiToBytes(string), buf, offset, length)\n}\n\nfunction latin1Write (buf, string, offset, length) {\n  return asciiWrite(buf, string, offset, length)\n}\n\nfunction base64Write (buf, string, offset, length) {\n  return blitBuffer(base64ToBytes(string), buf, offset, length)\n}\n\nfunction ucs2Write (buf, string, offset, length) {\n  return blitBuffer(utf16leToBytes(string, buf.length - offset), buf, offset, length)\n}\n\nBuffer.prototype.write = function write (string, offset, length, encoding) {\n  // Buffer#write(string)\n  if (offset === undefined) {\n    encoding = 'utf8'\n    length = this.length\n    offset = 0\n  // Buffer#write(string, encoding)\n  } else if (length === undefined && typeof offset === 'string') {\n    encoding = offset\n    length = this.length\n    offset = 0\n  // Buffer#write(string, offset[, length][, encoding])\n  } else if (isFinite(offset)) {\n    offset = offset | 0\n    if (isFinite(length)) {\n      length = length | 0\n      if (encoding === undefined) encoding = 'utf8'\n    } else {\n      encoding = length\n      length = undefined\n    }\n  // legacy write(string, encoding, offset, length) - remove in v0.13\n  } else {\n    throw new Error(\n      'Buffer.write(string, encoding, offset[, length]) is no longer supported'\n    )\n  }\n\n  var remaining = this.length - offset\n  if (length === undefined || length > remaining) length = remaining\n\n  if ((string.length > 0 && (length < 0 || offset < 0)) || offset > this.length) {\n    throw new RangeError('Attempt to write outside buffer bounds')\n  }\n\n  if (!encoding) encoding = 'utf8'\n\n  var loweredCase = false\n  for (;;) {\n    switch (encoding) {\n      case 'hex':\n        return hexWrite(this, string, offset, length)\n\n      case 'utf8':\n      case 'utf-8':\n        return utf8Write(this, string, offset, length)\n\n      case 'ascii':\n        return asciiWrite(this, string, offset, length)\n\n      case 'latin1':\n      case 'binary':\n        return latin1Write(this, string, offset, length)\n\n      case 'base64':\n        // Warning: maxLength not taken into account in base64Write\n        return base64Write(this, string, offset, length)\n\n      case 'ucs2':\n      case 'ucs-2':\n      case 'utf16le':\n      case 'utf-16le':\n        return ucs2Write(this, string, offset, length)\n\n      default:\n        if (loweredCase) throw new TypeError('Unknown encoding: ' + encoding)\n        encoding = ('' + encoding).toLowerCase()\n        loweredCase = true\n    }\n  }\n}\n\nBuffer.prototype.toJSON = function toJSON () {\n  return {\n    type: 'Buffer',\n    data: Array.prototype.slice.call(this._arr || this, 0)\n  }\n}\n\nfunction base64Slice (buf, start, end) {\n  if (start === 0 && end === buf.length) {\n    return base64.fromByteArray(buf)\n  } else {\n    return base64.fromByteArray(buf.slice(start, end))\n  }\n}\n\nfunction utf8Slice (buf, start, end) {\n  end = Math.min(buf.length, end)\n  var res = []\n\n  var i = start\n  while (i < end) {\n    var firstByte = buf[i]\n    var codePoint = null\n    var bytesPerSequence = (firstByte > 0xEF) ? 4\n      : (firstByte > 0xDF) ? 3\n      : (firstByte > 0xBF) ? 2\n      : 1\n\n    if (i + bytesPerSequence <= end) {\n      var secondByte, thirdByte, fourthByte, tempCodePoint\n\n      switch (bytesPerSequence) {\n        case 1:\n          if (firstByte < 0x80) {\n            codePoint = firstByte\n          }\n          break\n        case 2:\n          secondByte = buf[i + 1]\n          if ((secondByte & 0xC0) === 0x80) {\n            tempCodePoint = (firstByte & 0x1F) << 0x6 | (secondByte & 0x3F)\n            if (tempCodePoint > 0x7F) {\n              codePoint = tempCodePoint\n            }\n          }\n          break\n        case 3:\n          secondByte = buf[i + 1]\n          thirdByte = buf[i + 2]\n          if ((secondByte & 0xC0) === 0x80 && (thirdByte & 0xC0) === 0x80) {\n            tempCodePoint = (firstByte & 0xF) << 0xC | (secondByte & 0x3F) << 0x6 | (thirdByte & 0x3F)\n            if (tempCodePoint > 0x7FF && (tempCodePoint < 0xD800 || tempCodePoint > 0xDFFF)) {\n              codePoint = tempCodePoint\n            }\n          }\n          break\n        case 4:\n          secondByte = buf[i + 1]\n          thirdByte = buf[i + 2]\n          fourthByte = buf[i + 3]\n          if ((secondByte & 0xC0) === 0x80 && (thirdByte & 0xC0) === 0x80 && (fourthByte & 0xC0) === 0x80) {\n            tempCodePoint = (firstByte & 0xF) << 0x12 | (secondByte & 0x3F) << 0xC | (thirdByte & 0x3F) << 0x6 | (fourthByte & 0x3F)\n            if (tempCodePoint > 0xFFFF && tempCodePoint < 0x110000) {\n              codePoint = tempCodePoint\n            }\n          }\n      }\n    }\n\n    if (codePoint === null) {\n      // we did not generate a valid codePoint so insert a\n      // replacement char (U+FFFD) and advance only 1 byte\n      codePoint = 0xFFFD\n      bytesPerSequence = 1\n    } else if (codePoint > 0xFFFF) {\n      // encode to utf16 (surrogate pair dance)\n      codePoint -= 0x10000\n      res.push(codePoint >>> 10 & 0x3FF | 0xD800)\n      codePoint = 0xDC00 | codePoint & 0x3FF\n    }\n\n    res.push(codePoint)\n    i += bytesPerSequence\n  }\n\n  return decodeCodePointsArray(res)\n}\n\n// Based on http://stackoverflow.com/a/22747272/680742, the browser with\n// the lowest limit is Chrome, with 0x10000 args.\n// We go 1 magnitude less, for safety\nvar MAX_ARGUMENTS_LENGTH = 0x1000\n\nfunction decodeCodePointsArray (codePoints) {\n  var len = codePoints.length\n  if (len <= MAX_ARGUMENTS_LENGTH) {\n    return String.fromCharCode.apply(String, codePoints) // avoid extra slice()\n  }\n\n  // Decode in chunks to avoid \"call stack size exceeded\".\n  var res = ''\n  var i = 0\n  while (i < len) {\n    res += String.fromCharCode.apply(\n      String,\n      codePoints.slice(i, i += MAX_ARGUMENTS_LENGTH)\n    )\n  }\n  return res\n}\n\nfunction asciiSlice (buf, start, end) {\n  var ret = ''\n  end = Math.min(buf.length, end)\n\n  for (var i = start; i < end; ++i) {\n    ret += String.fromCharCode(buf[i] & 0x7F)\n  }\n  return ret\n}\n\nfunction latin1Slice (buf, start, end) {\n  var ret = ''\n  end = Math.min(buf.length, end)\n\n  for (var i = start; i < end; ++i) {\n    ret += String.fromCharCode(buf[i])\n  }\n  return ret\n}\n\nfunction hexSlice (buf, start, end) {\n  var len = buf.length\n\n  if (!start || start < 0) start = 0\n  if (!end || end < 0 || end > len) end = len\n\n  var out = ''\n  for (var i = start; i < end; ++i) {\n    out += toHex(buf[i])\n  }\n  return out\n}\n\nfunction utf16leSlice (buf, start, end) {\n  var bytes = buf.slice(start, end)\n  var res = ''\n  for (var i = 0; i < bytes.length; i += 2) {\n    res += String.fromCharCode(bytes[i] + bytes[i + 1] * 256)\n  }\n  return res\n}\n\nBuffer.prototype.slice = function slice (start, end) {\n  var len = this.length\n  start = ~~start\n  end = end === undefined ? len : ~~end\n\n  if (start < 0) {\n    start += len\n    if (start < 0) start = 0\n  } else if (start > len) {\n    start = len\n  }\n\n  if (end < 0) {\n    end += len\n    if (end < 0) end = 0\n  } else if (end > len) {\n    end = len\n  }\n\n  if (end < start) end = start\n\n  var newBuf\n  if (Buffer.TYPED_ARRAY_SUPPORT) {\n    newBuf = this.subarray(start, end)\n    newBuf.__proto__ = Buffer.prototype\n  } else {\n    var sliceLen = end - start\n    newBuf = new Buffer(sliceLen, undefined)\n    for (var i = 0; i < sliceLen; ++i) {\n      newBuf[i] = this[i + start]\n    }\n  }\n\n  return newBuf\n}\n\n/*\n * Need to make sure that buffer isn't trying to write out of bounds.\n */\nfunction checkOffset (offset, ext, length) {\n  if ((offset % 1) !== 0 || offset < 0) throw new RangeError('offset is not uint')\n  if (offset + ext > length) throw new RangeError('Trying to access beyond buffer length')\n}\n\nBuffer.prototype.readUIntLE = function readUIntLE (offset, byteLength, noAssert) {\n  offset = offset | 0\n  byteLength = byteLength | 0\n  if (!noAssert) checkOffset(offset, byteLength, this.length)\n\n  var val = this[offset]\n  var mul = 1\n  var i = 0\n  while (++i < byteLength && (mul *= 0x100)) {\n    val += this[offset + i] * mul\n  }\n\n  return val\n}\n\nBuffer.prototype.readUIntBE = function readUIntBE (offset, byteLength, noAssert) {\n  offset = offset | 0\n  byteLength = byteLength | 0\n  if (!noAssert) {\n    checkOffset(offset, byteLength, this.length)\n  }\n\n  var val = this[offset + --byteLength]\n  var mul = 1\n  while (byteLength > 0 && (mul *= 0x100)) {\n    val += this[offset + --byteLength] * mul\n  }\n\n  return val\n}\n\nBuffer.prototype.readUInt8 = function readUInt8 (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 1, this.length)\n  return this[offset]\n}\n\nBuffer.prototype.readUInt16LE = function readUInt16LE (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 2, this.length)\n  return this[offset] | (this[offset + 1] << 8)\n}\n\nBuffer.prototype.readUInt16BE = function readUInt16BE (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 2, this.length)\n  return (this[offset] << 8) | this[offset + 1]\n}\n\nBuffer.prototype.readUInt32LE = function readUInt32LE (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 4, this.length)\n\n  return ((this[offset]) |\n      (this[offset + 1] << 8) |\n      (this[offset + 2] << 16)) +\n      (this[offset + 3] * 0x1000000)\n}\n\nBuffer.prototype.readUInt32BE = function readUInt32BE (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 4, this.length)\n\n  return (this[offset] * 0x1000000) +\n    ((this[offset + 1] << 16) |\n    (this[offset + 2] << 8) |\n    this[offset + 3])\n}\n\nBuffer.prototype.readIntLE = function readIntLE (offset, byteLength, noAssert) {\n  offset = offset | 0\n  byteLength = byteLength | 0\n  if (!noAssert) checkOffset(offset, byteLength, this.length)\n\n  var val = this[offset]\n  var mul = 1\n  var i = 0\n  while (++i < byteLength && (mul *= 0x100)) {\n    val += this[offset + i] * mul\n  }\n  mul *= 0x80\n\n  if (val >= mul) val -= Math.pow(2, 8 * byteLength)\n\n  return val\n}\n\nBuffer.prototype.readIntBE = function readIntBE (offset, byteLength, noAssert) {\n  offset = offset | 0\n  byteLength = byteLength | 0\n  if (!noAssert) checkOffset(offset, byteLength, this.length)\n\n  var i = byteLength\n  var mul = 1\n  var val = this[offset + --i]\n  while (i > 0 && (mul *= 0x100)) {\n    val += this[offset + --i] * mul\n  }\n  mul *= 0x80\n\n  if (val >= mul) val -= Math.pow(2, 8 * byteLength)\n\n  return val\n}\n\nBuffer.prototype.readInt8 = function readInt8 (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 1, this.length)\n  if (!(this[offset] & 0x80)) return (this[offset])\n  return ((0xff - this[offset] + 1) * -1)\n}\n\nBuffer.prototype.readInt16LE = function readInt16LE (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 2, this.length)\n  var val = this[offset] | (this[offset + 1] << 8)\n  return (val & 0x8000) ? val | 0xFFFF0000 : val\n}\n\nBuffer.prototype.readInt16BE = function readInt16BE (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 2, this.length)\n  var val = this[offset + 1] | (this[offset] << 8)\n  return (val & 0x8000) ? val | 0xFFFF0000 : val\n}\n\nBuffer.prototype.readInt32LE = function readInt32LE (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 4, this.length)\n\n  return (this[offset]) |\n    (this[offset + 1] << 8) |\n    (this[offset + 2] << 16) |\n    (this[offset + 3] << 24)\n}\n\nBuffer.prototype.readInt32BE = function readInt32BE (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 4, this.length)\n\n  return (this[offset] << 24) |\n    (this[offset + 1] << 16) |\n    (this[offset + 2] << 8) |\n    (this[offset + 3])\n}\n\nBuffer.prototype.readFloatLE = function readFloatLE (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 4, this.length)\n  return ieee754.read(this, offset, true, 23, 4)\n}\n\nBuffer.prototype.readFloatBE = function readFloatBE (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 4, this.length)\n  return ieee754.read(this, offset, false, 23, 4)\n}\n\nBuffer.prototype.readDoubleLE = function readDoubleLE (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 8, this.length)\n  return ieee754.read(this, offset, true, 52, 8)\n}\n\nBuffer.prototype.readDoubleBE = function readDoubleBE (offset, noAssert) {\n  if (!noAssert) checkOffset(offset, 8, this.length)\n  return ieee754.read(this, offset, false, 52, 8)\n}\n\nfunction checkInt (buf, value, offset, ext, max, min) {\n  if (!Buffer.isBuffer(buf)) throw new TypeError('\"buffer\" argument must be a Buffer instance')\n  if (value > max || value < min) throw new RangeError('\"value\" argument is out of bounds')\n  if (offset + ext > buf.length) throw new RangeError('Index out of range')\n}\n\nBuffer.prototype.writeUIntLE = function writeUIntLE (value, offset, byteLength, noAssert) {\n  value = +value\n  offset = offset | 0\n  byteLength = byteLength | 0\n  if (!noAssert) {\n    var maxBytes = Math.pow(2, 8 * byteLength) - 1\n    checkInt(this, value, offset, byteLength, maxBytes, 0)\n  }\n\n  var mul = 1\n  var i = 0\n  this[offset] = value & 0xFF\n  while (++i < byteLength && (mul *= 0x100)) {\n    this[offset + i] = (value / mul) & 0xFF\n  }\n\n  return offset + byteLength\n}\n\nBuffer.prototype.writeUIntBE = function writeUIntBE (value, offset, byteLength, noAssert) {\n  value = +value\n  offset = offset | 0\n  byteLength = byteLength | 0\n  if (!noAssert) {\n    var maxBytes = Math.pow(2, 8 * byteLength) - 1\n    checkInt(this, value, offset, byteLength, maxBytes, 0)\n  }\n\n  var i = byteLength - 1\n  var mul = 1\n  this[offset + i] = value & 0xFF\n  while (--i >= 0 && (mul *= 0x100)) {\n    this[offset + i] = (value / mul) & 0xFF\n  }\n\n  return offset + byteLength\n}\n\nBuffer.prototype.writeUInt8 = function writeUInt8 (value, offset, noAssert) {\n  value = +value\n  offset = offset | 0\n  if (!noAssert) checkInt(this, value, offset, 1, 0xff, 0)\n  if (!Buffer.TYPED_ARRAY_SUPPORT) value = Math.floor(value)\n  this[offset] = (value & 0xff)\n  return offset + 1\n}\n\nfunction objectWriteUInt16 (buf, value, offset, littleEndian) {\n  if (value < 0) value = 0xffff + value + 1\n  for (var i = 0, j = Math.min(buf.length - offset, 2); i < j; ++i) {\n    buf[offset + i] = (value & (0xff << (8 * (littleEndian ? i : 1 - i)))) >>>\n      (littleEndian ? i : 1 - i) * 8\n  }\n}\n\nBuffer.prototype.writeUInt16LE = function writeUInt16LE (value, offset, noAssert) {\n  value = +value\n  offset = offset | 0\n  if (!noAssert) checkInt(this, value, offset, 2, 0xffff, 0)\n  if (Buffer.TYPED_ARRAY_SUPPORT) {\n    this[offset] = (value & 0xff)\n    this[offset + 1] = (value >>> 8)\n  } else {\n    objectWriteUInt16(this, value, offset, true)\n  }\n  return offset + 2\n}\n\nBuffer.prototype.writeUInt16BE = function writeUInt16BE (value, offset, noAssert) {\n  value = +value\n  offset = offset | 0\n  if (!noAssert) checkInt(this, value, offset, 2, 0xffff, 0)\n  if (Buffer.TYPED_ARRAY_SUPPORT) {\n    this[offset] = (value >>> 8)\n    this[offset + 1] = (value & 0xff)\n  } else {\n    objectWriteUInt16(this, value, offset, false)\n  }\n  return offset + 2\n}\n\nfunction objectWriteUInt32 (buf, value, offset, littleEndian) {\n  if (value < 0) value = 0xffffffff + value + 1\n  for (var i = 0, j = Math.min(buf.length - offset, 4); i < j; ++i) {\n    buf[offset + i] = (value >>> (littleEndian ? i : 3 - i) * 8) & 0xff\n  }\n}\n\nBuffer.prototype.writeUInt32LE = function writeUInt32LE (value, offset, noAssert) {\n  value = +value\n  offset = offset | 0\n  if (!noAssert) checkInt(this, value, offset, 4, 0xffffffff, 0)\n  if (Buffer.TYPED_ARRAY_SUPPORT) {\n    this[offset + 3] = (value >>> 24)\n    this[offset + 2] = (value >>> 16)\n    this[offset + 1] = (value >>> 8)\n    this[offset] = (value & 0xff)\n  } else {\n    objectWriteUInt32(this, value, offset, true)\n  }\n  return offset + 4\n}\n\nBuffer.prototype.writeUInt32BE = function writeUInt32BE (value, offset, noAssert) {\n  value = +value\n  offset = offset | 0\n  if (!noAssert) checkInt(this, value, offset, 4, 0xffffffff, 0)\n  if (Buffer.TYPED_ARRAY_SUPPORT) {\n    this[offset] = (value >>> 24)\n    this[offset + 1] = (value >>> 16)\n    this[offset + 2] = (value >>> 8)\n    this[offset + 3] = (value & 0xff)\n  } else {\n    objectWriteUInt32(this, value, offset, false)\n  }\n  return offset + 4\n}\n\nBuffer.prototype.writeIntLE = function writeIntLE (value, offset, byteLength, noAssert) {\n  value = +value\n  offset = offset | 0\n  if (!noAssert) {\n    var limit = Math.pow(2, 8 * byteLength - 1)\n\n    checkInt(this, value, offset, byteLength, limit - 1, -limit)\n  }\n\n  var i = 0\n  var mul = 1\n  var sub = 0\n  this[offset] = value & 0xFF\n  while (++i < byteLength && (mul *= 0x100)) {\n    if (value < 0 && sub === 0 && this[offset + i - 1] !== 0) {\n      sub = 1\n    }\n    this[offset + i] = ((value / mul) >> 0) - sub & 0xFF\n  }\n\n  return offset + byteLength\n}\n\nBuffer.prototype.writeIntBE = function writeIntBE (value, offset, byteLength, noAssert) {\n  value = +value\n  offset = offset | 0\n  if (!noAssert) {\n    var limit = Math.pow(2, 8 * byteLength - 1)\n\n    checkInt(this, value, offset, byteLength, limit - 1, -limit)\n  }\n\n  var i = byteLength - 1\n  var mul = 1\n  var sub = 0\n  this[offset + i] = value & 0xFF\n  while (--i >= 0 && (mul *= 0x100)) {\n    if (value < 0 && sub === 0 && this[offset + i + 1] !== 0) {\n      sub = 1\n    }\n    this[offset + i] = ((value / mul) >> 0) - sub & 0xFF\n  }\n\n  return offset + byteLength\n}\n\nBuffer.prototype.writeInt8 = function writeInt8 (value, offset, noAssert) {\n  value = +value\n  offset = offset | 0\n  if (!noAssert) checkInt(this, value, offset, 1, 0x7f, -0x80)\n  if (!Buffer.TYPED_ARRAY_SUPPORT) value = Math.floor(value)\n  if (value < 0) value = 0xff + value + 1\n  this[offset] = (value & 0xff)\n  return offset + 1\n}\n\nBuffer.prototype.writeInt16LE = function writeInt16LE (value, offset, noAssert) {\n  value = +value\n  offset = offset | 0\n  if (!noAssert) checkInt(this, value, offset, 2, 0x7fff, -0x8000)\n  if (Buffer.TYPED_ARRAY_SUPPORT) {\n    this[offset] = (value & 0xff)\n    this[offset + 1] = (value >>> 8)\n  } else {\n    objectWriteUInt16(this, value, offset, true)\n  }\n  return offset + 2\n}\n\nBuffer.prototype.writeInt16BE = function writeInt16BE (value, offset, noAssert) {\n  value = +value\n  offset = offset | 0\n  if (!noAssert) checkInt(this, value, offset, 2, 0x7fff, -0x8000)\n  if (Buffer.TYPED_ARRAY_SUPPORT) {\n    this[offset] = (value >>> 8)\n    this[offset + 1] = (value & 0xff)\n  } else {\n    objectWriteUInt16(this, value, offset, false)\n  }\n  return offset + 2\n}\n\nBuffer.prototype.writeInt32LE = function writeInt32LE (value, offset, noAssert) {\n  value = +value\n  offset = offset | 0\n  if (!noAssert) checkInt(this, value, offset, 4, 0x7fffffff, -0x80000000)\n  if (Buffer.TYPED_ARRAY_SUPPORT) {\n    this[offset] = (value & 0xff)\n    this[offset + 1] = (value >>> 8)\n    this[offset + 2] = (value >>> 16)\n    this[offset + 3] = (value >>> 24)\n  } else {\n    objectWriteUInt32(this, value, offset, true)\n  }\n  return offset + 4\n}\n\nBuffer.prototype.writeInt32BE = function writeInt32BE (value, offset, noAssert) {\n  value = +value\n  offset = offset | 0\n  if (!noAssert) checkInt(this, value, offset, 4, 0x7fffffff, -0x80000000)\n  if (value < 0) value = 0xffffffff + value + 1\n  if (Buffer.TYPED_ARRAY_SUPPORT) {\n    this[offset] = (value >>> 24)\n    this[offset + 1] = (value >>> 16)\n    this[offset + 2] = (value >>> 8)\n    this[offset + 3] = (value & 0xff)\n  } else {\n    objectWriteUInt32(this, value, offset, false)\n  }\n  return offset + 4\n}\n\nfunction checkIEEE754 (buf, value, offset, ext, max, min) {\n  if (offset + ext > buf.length) throw new RangeError('Index out of range')\n  if (offset < 0) throw new RangeError('Index out of range')\n}\n\nfunction writeFloat (buf, value, offset, littleEndian, noAssert) {\n  if (!noAssert) {\n    checkIEEE754(buf, value, offset, 4, 3.4028234663852886e+38, -3.4028234663852886e+38)\n  }\n  ieee754.write(buf, value, offset, littleEndian, 23, 4)\n  return offset + 4\n}\n\nBuffer.prototype.writeFloatLE = function writeFloatLE (value, offset, noAssert) {\n  return writeFloat(this, value, offset, true, noAssert)\n}\n\nBuffer.prototype.writeFloatBE = function writeFloatBE (value, offset, noAssert) {\n  return writeFloat(this, value, offset, false, noAssert)\n}\n\nfunction writeDouble (buf, value, offset, littleEndian, noAssert) {\n  if (!noAssert) {\n    checkIEEE754(buf, value, offset, 8, 1.7976931348623157E+308, -1.7976931348623157E+308)\n  }\n  ieee754.write(buf, value, offset, littleEndian, 52, 8)\n  return offset + 8\n}\n\nBuffer.prototype.writeDoubleLE = function writeDoubleLE (value, offset, noAssert) {\n  return writeDouble(this, value, offset, true, noAssert)\n}\n\nBuffer.prototype.writeDoubleBE = function writeDoubleBE (value, offset, noAssert) {\n  return writeDouble(this, value, offset, false, noAssert)\n}\n\n// copy(targetBuffer, targetStart=0, sourceStart=0, sourceEnd=buffer.length)\nBuffer.prototype.copy = function copy (target, targetStart, start, end) {\n  if (!start) start = 0\n  if (!end && end !== 0) end = this.length\n  if (targetStart >= target.length) targetStart = target.length\n  if (!targetStart) targetStart = 0\n  if (end > 0 && end < start) end = start\n\n  // Copy 0 bytes; we're done\n  if (end === start) return 0\n  if (target.length === 0 || this.length === 0) return 0\n\n  // Fatal error conditions\n  if (targetStart < 0) {\n    throw new RangeError('targetStart out of bounds')\n  }\n  if (start < 0 || start >= this.length) throw new RangeError('sourceStart out of bounds')\n  if (end < 0) throw new RangeError('sourceEnd out of bounds')\n\n  // Are we oob?\n  if (end > this.length) end = this.length\n  if (target.length - targetStart < end - start) {\n    end = target.length - targetStart + start\n  }\n\n  var len = end - start\n  var i\n\n  if (this === target && start < targetStart && targetStart < end) {\n    // descending copy from end\n    for (i = len - 1; i >= 0; --i) {\n      target[i + targetStart] = this[i + start]\n    }\n  } else if (len < 1000 || !Buffer.TYPED_ARRAY_SUPPORT) {\n    // ascending copy from start\n    for (i = 0; i < len; ++i) {\n      target[i + targetStart] = this[i + start]\n    }\n  } else {\n    Uint8Array.prototype.set.call(\n      target,\n      this.subarray(start, start + len),\n      targetStart\n    )\n  }\n\n  return len\n}\n\n// Usage:\n//    buffer.fill(number[, offset[, end]])\n//    buffer.fill(buffer[, offset[, end]])\n//    buffer.fill(string[, offset[, end]][, encoding])\nBuffer.prototype.fill = function fill (val, start, end, encoding) {\n  // Handle string cases:\n  if (typeof val === 'string') {\n    if (typeof start === 'string') {\n      encoding = start\n      start = 0\n      end = this.length\n    } else if (typeof end === 'string') {\n      encoding = end\n      end = this.length\n    }\n    if (val.length === 1) {\n      var code = val.charCodeAt(0)\n      if (code < 256) {\n        val = code\n      }\n    }\n    if (encoding !== undefined && typeof encoding !== 'string') {\n      throw new TypeError('encoding must be a string')\n    }\n    if (typeof encoding === 'string' && !Buffer.isEncoding(encoding)) {\n      throw new TypeError('Unknown encoding: ' + encoding)\n    }\n  } else if (typeof val === 'number') {\n    val = val & 255\n  }\n\n  // Invalid ranges are not set to a default, so can range check early.\n  if (start < 0 || this.length < start || this.length < end) {\n    throw new RangeError('Out of range index')\n  }\n\n  if (end <= start) {\n    return this\n  }\n\n  start = start >>> 0\n  end = end === undefined ? this.length : end >>> 0\n\n  if (!val) val = 0\n\n  var i\n  if (typeof val === 'number') {\n    for (i = start; i < end; ++i) {\n      this[i] = val\n    }\n  } else {\n    var bytes = Buffer.isBuffer(val)\n      ? val\n      : utf8ToBytes(new Buffer(val, encoding).toString())\n    var len = bytes.length\n    for (i = 0; i < end - start; ++i) {\n      this[i + start] = bytes[i % len]\n    }\n  }\n\n  return this\n}\n\n// HELPER FUNCTIONS\n// ================\n\nvar INVALID_BASE64_RE = /[^+\\/0-9A-Za-z-_]/g\n\nfunction base64clean (str) {\n  // Node strips out invalid characters like \\n and \\t from the string, base64-js does not\n  str = stringtrim(str).replace(INVALID_BASE64_RE, '')\n  // Node converts strings with length < 2 to ''\n  if (str.length < 2) return ''\n  // Node allows for non-padded base64 strings (missing trailing ===), base64-js does not\n  while (str.length % 4 !== 0) {\n    str = str + '='\n  }\n  return str\n}\n\nfunction stringtrim (str) {\n  if (str.trim) return str.trim()\n  return str.replace(/^\\s+|\\s+$/g, '')\n}\n\nfunction toHex (n) {\n  if (n < 16) return '0' + n.toString(16)\n  return n.toString(16)\n}\n\nfunction utf8ToBytes (string, units) {\n  units = units || Infinity\n  var codePoint\n  var length = string.length\n  var leadSurrogate = null\n  var bytes = []\n\n  for (var i = 0; i < length; ++i) {\n    codePoint = string.charCodeAt(i)\n\n    // is surrogate component\n    if (codePoint > 0xD7FF && codePoint < 0xE000) {\n      // last char was a lead\n      if (!leadSurrogate) {\n        // no lead yet\n        if (codePoint > 0xDBFF) {\n          // unexpected trail\n          if ((units -= 3) > -1) bytes.push(0xEF, 0xBF, 0xBD)\n          continue\n        } else if (i + 1 === length) {\n          // unpaired lead\n          if ((units -= 3) > -1) bytes.push(0xEF, 0xBF, 0xBD)\n          continue\n        }\n\n        // valid lead\n        leadSurrogate = codePoint\n\n        continue\n      }\n\n      // 2 leads in a row\n      if (codePoint < 0xDC00) {\n        if ((units -= 3) > -1) bytes.push(0xEF, 0xBF, 0xBD)\n        leadSurrogate = codePoint\n        continue\n      }\n\n      // valid surrogate pair\n      codePoint = (leadSurrogate - 0xD800 << 10 | codePoint - 0xDC00) + 0x10000\n    } else if (leadSurrogate) {\n      // valid bmp char, but last char was a lead\n      if ((units -= 3) > -1) bytes.push(0xEF, 0xBF, 0xBD)\n    }\n\n    leadSurrogate = null\n\n    // encode utf8\n    if (codePoint < 0x80) {\n      if ((units -= 1) < 0) break\n      bytes.push(codePoint)\n    } else if (codePoint < 0x800) {\n      if ((units -= 2) < 0) break\n      bytes.push(\n        codePoint >> 0x6 | 0xC0,\n        codePoint & 0x3F | 0x80\n      )\n    } else if (codePoint < 0x10000) {\n      if ((units -= 3) < 0) break\n      bytes.push(\n        codePoint >> 0xC | 0xE0,\n        codePoint >> 0x6 & 0x3F | 0x80,\n        codePoint & 0x3F | 0x80\n      )\n    } else if (codePoint < 0x110000) {\n      if ((units -= 4) < 0) break\n      bytes.push(\n        codePoint >> 0x12 | 0xF0,\n        codePoint >> 0xC & 0x3F | 0x80,\n        codePoint >> 0x6 & 0x3F | 0x80,\n        codePoint & 0x3F | 0x80\n      )\n    } else {\n      throw new Error('Invalid code point')\n    }\n  }\n\n  return bytes\n}\n\nfunction asciiToBytes (str) {\n  var byteArray = []\n  for (var i = 0; i < str.length; ++i) {\n    // Node's code seems to be doing this and not & 0x7F..\n    byteArray.push(str.charCodeAt(i) & 0xFF)\n  }\n  return byteArray\n}\n\nfunction utf16leToBytes (str, units) {\n  var c, hi, lo\n  var byteArray = []\n  for (var i = 0; i < str.length; ++i) {\n    if ((units -= 2) < 0) break\n\n    c = str.charCodeAt(i)\n    hi = c >> 8\n    lo = c % 256\n    byteArray.push(lo)\n    byteArray.push(hi)\n  }\n\n  return byteArray\n}\n\nfunction base64ToBytes (str) {\n  return base64.toByteArray(base64clean(str))\n}\n\nfunction blitBuffer (src, dst, offset, length) {\n  for (var i = 0; i < length; ++i) {\n    if ((i + offset >= dst.length) || (i >= src.length)) break\n    dst[i + offset] = src[i]\n  }\n  return i\n}\n\nfunction isnan (val) {\n  return val !== val // eslint-disable-line no-self-compare\n}\n","'use strict'\n\nexports.byteLength = byteLength\nexports.toByteArray = toByteArray\nexports.fromByteArray = fromByteArray\n\nvar lookup = []\nvar revLookup = []\nvar Arr = typeof Uint8Array !== 'undefined' ? Uint8Array : Array\n\nvar code = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'\nfor (var i = 0, len = code.length; i < len; ++i) {\n  lookup[i] = code[i]\n  revLookup[code.charCodeAt(i)] = i\n}\n\n// Support decoding URL-safe base64 strings, as Node.js does.\n// See: https://en.wikipedia.org/wiki/Base64#URL_applications\nrevLookup['-'.charCodeAt(0)] = 62\nrevLookup['_'.charCodeAt(0)] = 63\n\nfunction getLens (b64) {\n  var len = b64.length\n\n  if (len % 4 > 0) {\n    throw new Error('Invalid string. Length must be a multiple of 4')\n  }\n\n  // Trim off extra bytes after placeholder bytes are found\n  // See: https://github.com/beatgammit/base64-js/issues/42\n  var validLen = b64.indexOf('=')\n  if (validLen === -1) validLen = len\n\n  var placeHoldersLen = validLen === len\n    ? 0\n    : 4 - (validLen % 4)\n\n  return [validLen, placeHoldersLen]\n}\n\n// base64 is 4/3 + up to two characters of the original data\nfunction byteLength (b64) {\n  var lens = getLens(b64)\n  var validLen = lens[0]\n  var placeHoldersLen = lens[1]\n  return ((validLen + placeHoldersLen) * 3 / 4) - placeHoldersLen\n}\n\nfunction _byteLength (b64, validLen, placeHoldersLen) {\n  return ((validLen + placeHoldersLen) * 3 / 4) - placeHoldersLen\n}\n\nfunction toByteArray (b64) {\n  var tmp\n  var lens = getLens(b64)\n  var validLen = lens[0]\n  var placeHoldersLen = lens[1]\n\n  var arr = new Arr(_byteLength(b64, validLen, placeHoldersLen))\n\n  var curByte = 0\n\n  // if there are placeholders, only get up to the last complete 4 chars\n  var len = placeHoldersLen > 0\n    ? validLen - 4\n    : validLen\n\n  var i\n  for (i = 0; i < len; i += 4) {\n    tmp =\n      (revLookup[b64.charCodeAt(i)] << 18) |\n      (revLookup[b64.charCodeAt(i + 1)] << 12) |\n      (revLookup[b64.charCodeAt(i + 2)] << 6) |\n      revLookup[b64.charCodeAt(i + 3)]\n    arr[curByte++] = (tmp >> 16) & 0xFF\n    arr[curByte++] = (tmp >> 8) & 0xFF\n    arr[curByte++] = tmp & 0xFF\n  }\n\n  if (placeHoldersLen === 2) {\n    tmp =\n      (revLookup[b64.charCodeAt(i)] << 2) |\n      (revLookup[b64.charCodeAt(i + 1)] >> 4)\n    arr[curByte++] = tmp & 0xFF\n  }\n\n  if (placeHoldersLen === 1) {\n    tmp =\n      (revLookup[b64.charCodeAt(i)] << 10) |\n      (revLookup[b64.charCodeAt(i + 1)] << 4) |\n      (revLookup[b64.charCodeAt(i + 2)] >> 2)\n    arr[curByte++] = (tmp >> 8) & 0xFF\n    arr[curByte++] = tmp & 0xFF\n  }\n\n  return arr\n}\n\nfunction tripletToBase64 (num) {\n  return lookup[num >> 18 & 0x3F] +\n    lookup[num >> 12 & 0x3F] +\n    lookup[num >> 6 & 0x3F] +\n    lookup[num & 0x3F]\n}\n\nfunction encodeChunk (uint8, start, end) {\n  var tmp\n  var output = []\n  for (var i = start; i < end; i += 3) {\n    tmp =\n      ((uint8[i] << 16) & 0xFF0000) +\n      ((uint8[i + 1] << 8) & 0xFF00) +\n      (uint8[i + 2] & 0xFF)\n    output.push(tripletToBase64(tmp))\n  }\n  return output.join('')\n}\n\nfunction fromByteArray (uint8) {\n  var tmp\n  var len = uint8.length\n  var extraBytes = len % 3 // if we have 1 byte left, pad 2 bytes\n  var parts = []\n  var maxChunkLength = 16383 // must be multiple of 3\n\n  // go through the array every three bytes, we'll deal with trailing stuff later\n  for (var i = 0, len2 = len - extraBytes; i < len2; i += maxChunkLength) {\n    parts.push(encodeChunk(\n      uint8, i, (i + maxChunkLength) > len2 ? len2 : (i + maxChunkLength)\n    ))\n  }\n\n  // pad the end with zeros, but make sure to not forget the extra bytes\n  if (extraBytes === 1) {\n    tmp = uint8[len - 1]\n    parts.push(\n      lookup[tmp >> 2] +\n      lookup[(tmp << 4) & 0x3F] +\n      '=='\n    )\n  } else if (extraBytes === 2) {\n    tmp = (uint8[len - 2] << 8) + uint8[len - 1]\n    parts.push(\n      lookup[tmp >> 10] +\n      lookup[(tmp >> 4) & 0x3F] +\n      lookup[(tmp << 2) & 0x3F] +\n      '='\n    )\n  }\n\n  return parts.join('')\n}\n","var toString = {}.toString;\n\nmodule.exports = Array.isArray || function (arr) {\n  return toString.call(arr) == '[object Array]';\n};\n","//     JavaScript Expression Parser (JSEP) 0.3.4\r\n//     JSEP may be freely distributed under the MIT License\r\n//     http://jsep.from.so/\r\n\r\n/*global module: true, exports: true, console: true */\r\n(function (root) {\r\n\t'use strict';\r\n\t// Node Types\r\n\t// ----------\r\n\r\n\t// This is the full set of types that any JSEP node can be.\r\n\t// Store them here to save space when minified\r\n\tvar COMPOUND = 'Compound',\r\n\t\tIDENTIFIER = 'Identifier',\r\n\t\tMEMBER_EXP = 'MemberExpression',\r\n\t\tLITERAL = 'Literal',\r\n\t\tTHIS_EXP = 'ThisExpression',\r\n\t\tCALL_EXP = 'CallExpression',\r\n\t\tUNARY_EXP = 'UnaryExpression',\r\n\t\tBINARY_EXP = 'BinaryExpression',\r\n\t\tLOGICAL_EXP = 'LogicalExpression',\r\n\t\tCONDITIONAL_EXP = 'ConditionalExpression',\r\n\t\tARRAY_EXP = 'ArrayExpression',\r\n\r\n\t\tPERIOD_CODE = 46, // '.'\r\n\t\tCOMMA_CODE  = 44, // ','\r\n\t\tSQUOTE_CODE = 39, // single quote\r\n\t\tDQUOTE_CODE = 34, // double quotes\r\n\t\tOPAREN_CODE = 40, // (\r\n\t\tCPAREN_CODE = 41, // )\r\n\t\tOBRACK_CODE = 91, // [\r\n\t\tCBRACK_CODE = 93, // ]\r\n\t\tQUMARK_CODE = 63, // ?\r\n\t\tSEMCOL_CODE = 59, // ;\r\n\t\tCOLON_CODE  = 58, // :\r\n\r\n\t\tthrowError = function(message, index) {\r\n\t\t\tvar error = new Error(message + ' at character ' + index);\r\n\t\t\terror.index = index;\r\n\t\t\terror.description = message;\r\n\t\t\tthrow error;\r\n\t\t},\r\n\r\n\t// Operations\r\n\t// ----------\r\n\r\n\t// Set `t` to `true` to save space (when minified, not gzipped)\r\n\t\tt = true,\r\n\t// Use a quickly-accessible map to store all of the unary operators\r\n\t// Values are set to `true` (it really doesn't matter)\r\n\t\tunary_ops = {'-': t, '!': t, '~': t, '+': t},\r\n\t// Also use a map for the binary operations but set their values to their\r\n\t// binary precedence for quick reference:\r\n\t// see [Order of operations](http://en.wikipedia.org/wiki/Order_of_operations#Programming_language)\r\n\t\tbinary_ops = {\r\n\t\t\t'||': 1, '&&': 2, '|': 3,  '^': 4,  '&': 5,\r\n\t\t\t'==': 6, '!=': 6, '===': 6, '!==': 6,\r\n\t\t\t'<': 7,  '>': 7,  '<=': 7,  '>=': 7,\r\n\t\t\t'<<':8,  '>>': 8, '>>>': 8,\r\n\t\t\t'+': 9, '-': 9,\r\n\t\t\t'*': 10, '/': 10, '%': 10\r\n\t\t},\r\n\t// Get return the longest key length of any object\r\n\t\tgetMaxKeyLen = function(obj) {\r\n\t\t\tvar max_len = 0, len;\r\n\t\t\tfor(var key in obj) {\r\n\t\t\t\tif((len = key.length) > max_len && obj.hasOwnProperty(key)) {\r\n\t\t\t\t\tmax_len = len;\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\treturn max_len;\r\n\t\t},\r\n\t\tmax_unop_len = getMaxKeyLen(unary_ops),\r\n\t\tmax_binop_len = getMaxKeyLen(binary_ops),\r\n\t// Literals\r\n\t// ----------\r\n\t// Store the values to return for the various literals we may encounter\r\n\t\tliterals = {\r\n\t\t\t'true': true,\r\n\t\t\t'false': false,\r\n\t\t\t'null': null\r\n\t\t},\r\n\t// Except for `this`, which is special. This could be changed to something like `'self'` as well\r\n\t\tthis_str = 'this',\r\n\t// Returns the precedence of a binary operator or `0` if it isn't a binary operator\r\n\t\tbinaryPrecedence = function(op_val) {\r\n\t\t\treturn binary_ops[op_val] || 0;\r\n\t\t},\r\n\t// Utility function (gets called from multiple places)\r\n\t// Also note that `a && b` and `a || b` are *logical* expressions, not binary expressions\r\n\t\tcreateBinaryExpression = function (operator, left, right) {\r\n\t\t\tvar type = (operator === '||' || operator === '&&') ? LOGICAL_EXP : BINARY_EXP;\r\n\t\t\treturn {\r\n\t\t\t\ttype: type,\r\n\t\t\t\toperator: operator,\r\n\t\t\t\tleft: left,\r\n\t\t\t\tright: right\r\n\t\t\t};\r\n\t\t},\r\n\t\t// `ch` is a character code in the next three functions\r\n\t\tisDecimalDigit = function(ch) {\r\n\t\t\treturn (ch >= 48 && ch <= 57); // 0...9\r\n\t\t},\r\n\t\tisIdentifierStart = function(ch) {\r\n\t\t\treturn (ch === 36) || (ch === 95) || // `$` and `_`\r\n\t\t\t\t\t(ch >= 65 && ch <= 90) || // A...Z\r\n\t\t\t\t\t(ch >= 97 && ch <= 122) || // a...z\r\n                    (ch >= 128 && !binary_ops[String.fromCharCode(ch)]); // any non-ASCII that is not an operator\r\n\t\t},\r\n\t\tisIdentifierPart = function(ch) {\r\n\t\t\treturn (ch === 36) || (ch === 95) || // `$` and `_`\r\n\t\t\t\t\t(ch >= 65 && ch <= 90) || // A...Z\r\n\t\t\t\t\t(ch >= 97 && ch <= 122) || // a...z\r\n\t\t\t\t\t(ch >= 48 && ch <= 57) || // 0...9\r\n                    (ch >= 128 && !binary_ops[String.fromCharCode(ch)]); // any non-ASCII that is not an operator\r\n\t\t},\r\n\r\n\t\t// Parsing\r\n\t\t// -------\r\n\t\t// `expr` is a string with the passed in expression\r\n\t\tjsep = function(expr) {\r\n\t\t\t// `index` stores the character number we are currently at while `length` is a constant\r\n\t\t\t// All of the gobbles below will modify `index` as we move along\r\n\t\t\tvar index = 0,\r\n\t\t\t\tcharAtFunc = expr.charAt,\r\n\t\t\t\tcharCodeAtFunc = expr.charCodeAt,\r\n\t\t\t\texprI = function(i) { return charAtFunc.call(expr, i); },\r\n\t\t\t\texprICode = function(i) { return charCodeAtFunc.call(expr, i); },\r\n\t\t\t\tlength = expr.length,\r\n\r\n\t\t\t\t// Push `index` up to the next non-space character\r\n\t\t\t\tgobbleSpaces = function() {\r\n\t\t\t\t\tvar ch = exprICode(index);\r\n\t\t\t\t\t// space or tab\r\n\t\t\t\t\twhile(ch === 32 || ch === 9 || ch === 10 || ch === 13) {\r\n\t\t\t\t\t\tch = exprICode(++index);\r\n\t\t\t\t\t}\r\n\t\t\t\t},\r\n\r\n\t\t\t\t// The main parsing function. Much of this code is dedicated to ternary expressions\r\n\t\t\t\tgobbleExpression = function() {\r\n\t\t\t\t\tvar test = gobbleBinaryExpression(),\r\n\t\t\t\t\t\tconsequent, alternate;\r\n\t\t\t\t\tgobbleSpaces();\r\n\t\t\t\t\tif(exprICode(index) === QUMARK_CODE) {\r\n\t\t\t\t\t\t// Ternary expression: test ? consequent : alternate\r\n\t\t\t\t\t\tindex++;\r\n\t\t\t\t\t\tconsequent = gobbleExpression();\r\n\t\t\t\t\t\tif(!consequent) {\r\n\t\t\t\t\t\t\tthrowError('Expected expression', index);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t\tgobbleSpaces();\r\n\t\t\t\t\t\tif(exprICode(index) === COLON_CODE) {\r\n\t\t\t\t\t\t\tindex++;\r\n\t\t\t\t\t\t\talternate = gobbleExpression();\r\n\t\t\t\t\t\t\tif(!alternate) {\r\n\t\t\t\t\t\t\t\tthrowError('Expected expression', index);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\treturn {\r\n\t\t\t\t\t\t\t\ttype: CONDITIONAL_EXP,\r\n\t\t\t\t\t\t\t\ttest: test,\r\n\t\t\t\t\t\t\t\tconsequent: consequent,\r\n\t\t\t\t\t\t\t\talternate: alternate\r\n\t\t\t\t\t\t\t};\r\n\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\tthrowError('Expected :', index);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t} else {\r\n\t\t\t\t\t\treturn test;\r\n\t\t\t\t\t}\r\n\t\t\t\t},\r\n\r\n\t\t\t\t// Search for the operation portion of the string (e.g. `+`, `===`)\r\n\t\t\t\t// Start by taking the longest possible binary operations (3 characters: `===`, `!==`, `>>>`)\r\n\t\t\t\t// and move down from 3 to 2 to 1 character until a matching binary operation is found\r\n\t\t\t\t// then, return that binary operation\r\n\t\t\t\tgobbleBinaryOp = function() {\r\n\t\t\t\t\tgobbleSpaces();\r\n\t\t\t\t\tvar biop, to_check = expr.substr(index, max_binop_len), tc_len = to_check.length;\r\n\t\t\t\t\twhile(tc_len > 0) {\r\n\t\t\t\t\t\t// Don't accept a binary op when it is an identifier.\r\n\t\t\t\t\t\t// Binary ops that start with a identifier-valid character must be followed\r\n\t\t\t\t\t\t// by a non identifier-part valid character\r\n\t\t\t\t\t\tif(binary_ops.hasOwnProperty(to_check) && (\r\n\t\t\t\t\t\t\t!isIdentifierStart(exprICode(index)) ||\r\n\t\t\t\t\t\t\t(index+to_check.length< expr.length && !isIdentifierPart(exprICode(index+to_check.length)))\r\n\t\t\t\t\t\t)) {\r\n\t\t\t\t\t\t\tindex += tc_len;\r\n\t\t\t\t\t\t\treturn to_check;\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t\tto_check = to_check.substr(0, --tc_len);\r\n\t\t\t\t\t}\r\n\t\t\t\t\treturn false;\r\n\t\t\t\t},\r\n\r\n\t\t\t\t// This function is responsible for gobbling an individual expression,\r\n\t\t\t\t// e.g. `1`, `1+2`, `a+(b*2)-Math.sqrt(2)`\r\n\t\t\t\tgobbleBinaryExpression = function() {\r\n\t\t\t\t\tvar ch_i, node, biop, prec, stack, biop_info, left, right, i;\r\n\r\n\t\t\t\t\t// First, try to get the leftmost thing\r\n\t\t\t\t\t// Then, check to see if there's a binary operator operating on that leftmost thing\r\n\t\t\t\t\tleft = gobbleToken();\r\n\t\t\t\t\tbiop = gobbleBinaryOp();\r\n\r\n\t\t\t\t\t// If there wasn't a binary operator, just return the leftmost node\r\n\t\t\t\t\tif(!biop) {\r\n\t\t\t\t\t\treturn left;\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\t// Otherwise, we need to start a stack to properly place the binary operations in their\r\n\t\t\t\t\t// precedence structure\r\n\t\t\t\t\tbiop_info = { value: biop, prec: binaryPrecedence(biop)};\r\n\r\n\t\t\t\t\tright = gobbleToken();\r\n\t\t\t\t\tif(!right) {\r\n\t\t\t\t\t\tthrowError(\"Expected expression after \" + biop, index);\r\n\t\t\t\t\t}\r\n\t\t\t\t\tstack = [left, biop_info, right];\r\n\r\n\t\t\t\t\t// Properly deal with precedence using [recursive descent](http://www.engr.mun.ca/~theo/Misc/exp_parsing.htm)\r\n\t\t\t\t\twhile((biop = gobbleBinaryOp())) {\r\n\t\t\t\t\t\tprec = binaryPrecedence(biop);\r\n\r\n\t\t\t\t\t\tif(prec === 0) {\r\n\t\t\t\t\t\t\tbreak;\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t\tbiop_info = { value: biop, prec: prec };\r\n\r\n\t\t\t\t\t\t// Reduce: make a binary expression from the three topmost entries.\r\n\t\t\t\t\t\twhile ((stack.length > 2) && (prec <= stack[stack.length - 2].prec)) {\r\n\t\t\t\t\t\t\tright = stack.pop();\r\n\t\t\t\t\t\t\tbiop = stack.pop().value;\r\n\t\t\t\t\t\t\tleft = stack.pop();\r\n\t\t\t\t\t\t\tnode = createBinaryExpression(biop, left, right);\r\n\t\t\t\t\t\t\tstack.push(node);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tnode = gobbleToken();\r\n\t\t\t\t\t\tif(!node) {\r\n\t\t\t\t\t\t\tthrowError(\"Expected expression after \" + biop, index);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t\tstack.push(biop_info, node);\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\ti = stack.length - 1;\r\n\t\t\t\t\tnode = stack[i];\r\n\t\t\t\t\twhile(i > 1) {\r\n\t\t\t\t\t\tnode = createBinaryExpression(stack[i - 1].value, stack[i - 2], node);\r\n\t\t\t\t\t\ti -= 2;\r\n\t\t\t\t\t}\r\n\t\t\t\t\treturn node;\r\n\t\t\t\t},\r\n\r\n\t\t\t\t// An individual part of a binary expression:\r\n\t\t\t\t// e.g. `foo.bar(baz)`, `1`, `\"abc\"`, `(a % 2)` (because it's in parenthesis)\r\n\t\t\t\tgobbleToken = function() {\r\n\t\t\t\t\tvar ch, to_check, tc_len;\r\n\r\n\t\t\t\t\tgobbleSpaces();\r\n\t\t\t\t\tch = exprICode(index);\r\n\r\n\t\t\t\t\tif(isDecimalDigit(ch) || ch === PERIOD_CODE) {\r\n\t\t\t\t\t\t// Char code 46 is a dot `.` which can start off a numeric literal\r\n\t\t\t\t\t\treturn gobbleNumericLiteral();\r\n\t\t\t\t\t} else if(ch === SQUOTE_CODE || ch === DQUOTE_CODE) {\r\n\t\t\t\t\t\t// Single or double quotes\r\n\t\t\t\t\t\treturn gobbleStringLiteral();\r\n\t\t\t\t\t} else if (ch === OBRACK_CODE) {\r\n\t\t\t\t\t\treturn gobbleArray();\r\n\t\t\t\t\t} else {\r\n\t\t\t\t\t\tto_check = expr.substr(index, max_unop_len);\r\n\t\t\t\t\t\ttc_len = to_check.length;\r\n\t\t\t\t\t\twhile(tc_len > 0) {\r\n\t\t\t\t\t\t// Don't accept an unary op when it is an identifier.\r\n\t\t\t\t\t\t// Unary ops that start with a identifier-valid character must be followed\r\n\t\t\t\t\t\t// by a non identifier-part valid character\r\n\t\t\t\t\t\t\tif(unary_ops.hasOwnProperty(to_check) && (\r\n\t\t\t\t\t\t\t\t!isIdentifierStart(exprICode(index)) ||\r\n\t\t\t\t\t\t\t\t(index+to_check.length < expr.length && !isIdentifierPart(exprICode(index+to_check.length)))\r\n\t\t\t\t\t\t\t)) {\r\n\t\t\t\t\t\t\t\tindex += tc_len;\r\n\t\t\t\t\t\t\t\treturn {\r\n\t\t\t\t\t\t\t\t\ttype: UNARY_EXP,\r\n\t\t\t\t\t\t\t\t\toperator: to_check,\r\n\t\t\t\t\t\t\t\t\targument: gobbleToken(),\r\n\t\t\t\t\t\t\t\t\tprefix: true\r\n\t\t\t\t\t\t\t\t};\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\tto_check = to_check.substr(0, --tc_len);\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (isIdentifierStart(ch) || ch === OPAREN_CODE) { // open parenthesis\r\n\t\t\t\t\t\t\t// `foo`, `bar.baz`\r\n\t\t\t\t\t\t\treturn gobbleVariable();\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\treturn false;\r\n\t\t\t\t},\r\n\t\t\t\t// Parse simple numeric literals: `12`, `3.4`, `.5`. Do this by using a string to\r\n\t\t\t\t// keep track of everything in the numeric literal and then calling `parseFloat` on that string\r\n\t\t\t\tgobbleNumericLiteral = function() {\r\n\t\t\t\t\tvar number = '', ch, chCode;\r\n\t\t\t\t\twhile(isDecimalDigit(exprICode(index))) {\r\n\t\t\t\t\t\tnumber += exprI(index++);\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\tif(exprICode(index) === PERIOD_CODE) { // can start with a decimal marker\r\n\t\t\t\t\t\tnumber += exprI(index++);\r\n\r\n\t\t\t\t\t\twhile(isDecimalDigit(exprICode(index))) {\r\n\t\t\t\t\t\t\tnumber += exprI(index++);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\tch = exprI(index);\r\n\t\t\t\t\tif(ch === 'e' || ch === 'E') { // exponent marker\r\n\t\t\t\t\t\tnumber += exprI(index++);\r\n\t\t\t\t\t\tch = exprI(index);\r\n\t\t\t\t\t\tif(ch === '+' || ch === '-') { // exponent sign\r\n\t\t\t\t\t\t\tnumber += exprI(index++);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t\twhile(isDecimalDigit(exprICode(index))) { //exponent itself\r\n\t\t\t\t\t\t\tnumber += exprI(index++);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t\tif(!isDecimalDigit(exprICode(index-1)) ) {\r\n\t\t\t\t\t\t\tthrowError('Expected exponent (' + number + exprI(index) + ')', index);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t}\r\n\r\n\r\n\t\t\t\t\tchCode = exprICode(index);\r\n\t\t\t\t\t// Check to make sure this isn't a variable name that start with a number (123abc)\r\n\t\t\t\t\tif(isIdentifierStart(chCode)) {\r\n\t\t\t\t\t\tthrowError('Variable names cannot start with a number (' +\r\n\t\t\t\t\t\t\t\t\tnumber + exprI(index) + ')', index);\r\n\t\t\t\t\t} else if(chCode === PERIOD_CODE) {\r\n\t\t\t\t\t\tthrowError('Unexpected period', index);\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\treturn {\r\n\t\t\t\t\t\ttype: LITERAL,\r\n\t\t\t\t\t\tvalue: parseFloat(number),\r\n\t\t\t\t\t\traw: number\r\n\t\t\t\t\t};\r\n\t\t\t\t},\r\n\r\n\t\t\t\t// Parses a string literal, staring with single or double quotes with basic support for escape codes\r\n\t\t\t\t// e.g. `\"hello world\"`, `'this is\\nJSEP'`\r\n\t\t\t\tgobbleStringLiteral = function() {\r\n\t\t\t\t\tvar str = '', quote = exprI(index++), closed = false, ch;\r\n\r\n\t\t\t\t\twhile(index < length) {\r\n\t\t\t\t\t\tch = exprI(index++);\r\n\t\t\t\t\t\tif(ch === quote) {\r\n\t\t\t\t\t\t\tclosed = true;\r\n\t\t\t\t\t\t\tbreak;\r\n\t\t\t\t\t\t} else if(ch === '\\\\') {\r\n\t\t\t\t\t\t\t// Check for all of the common escape codes\r\n\t\t\t\t\t\t\tch = exprI(index++);\r\n\t\t\t\t\t\t\tswitch(ch) {\r\n\t\t\t\t\t\t\t\tcase 'n': str += '\\n'; break;\r\n\t\t\t\t\t\t\t\tcase 'r': str += '\\r'; break;\r\n\t\t\t\t\t\t\t\tcase 't': str += '\\t'; break;\r\n\t\t\t\t\t\t\t\tcase 'b': str += '\\b'; break;\r\n\t\t\t\t\t\t\t\tcase 'f': str += '\\f'; break;\r\n\t\t\t\t\t\t\t\tcase 'v': str += '\\x0B'; break;\r\n\t\t\t\t\t\t\t\tdefault : str += ch;\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\tstr += ch;\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\tif(!closed) {\r\n\t\t\t\t\t\tthrowError('Unclosed quote after \"'+str+'\"', index);\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\treturn {\r\n\t\t\t\t\t\ttype: LITERAL,\r\n\t\t\t\t\t\tvalue: str,\r\n\t\t\t\t\t\traw: quote + str + quote\r\n\t\t\t\t\t};\r\n\t\t\t\t},\r\n\r\n\t\t\t\t// Gobbles only identifiers\r\n\t\t\t\t// e.g.: `foo`, `_value`, `$x1`\r\n\t\t\t\t// Also, this function checks if that identifier is a literal:\r\n\t\t\t\t// (e.g. `true`, `false`, `null`) or `this`\r\n\t\t\t\tgobbleIdentifier = function() {\r\n\t\t\t\t\tvar ch = exprICode(index), start = index, identifier;\r\n\r\n\t\t\t\t\tif(isIdentifierStart(ch)) {\r\n\t\t\t\t\t\tindex++;\r\n\t\t\t\t\t} else {\r\n\t\t\t\t\t\tthrowError('Unexpected ' + exprI(index), index);\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\twhile(index < length) {\r\n\t\t\t\t\t\tch = exprICode(index);\r\n\t\t\t\t\t\tif(isIdentifierPart(ch)) {\r\n\t\t\t\t\t\t\tindex++;\r\n\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\tbreak;\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t}\r\n\t\t\t\t\tidentifier = expr.slice(start, index);\r\n\r\n\t\t\t\t\tif(literals.hasOwnProperty(identifier)) {\r\n\t\t\t\t\t\treturn {\r\n\t\t\t\t\t\t\ttype: LITERAL,\r\n\t\t\t\t\t\t\tvalue: literals[identifier],\r\n\t\t\t\t\t\t\traw: identifier\r\n\t\t\t\t\t\t};\r\n\t\t\t\t\t} else if(identifier === this_str) {\r\n\t\t\t\t\t\treturn { type: THIS_EXP };\r\n\t\t\t\t\t} else {\r\n\t\t\t\t\t\treturn {\r\n\t\t\t\t\t\t\ttype: IDENTIFIER,\r\n\t\t\t\t\t\t\tname: identifier\r\n\t\t\t\t\t\t};\r\n\t\t\t\t\t}\r\n\t\t\t\t},\r\n\r\n\t\t\t\t// Gobbles a list of arguments within the context of a function call\r\n\t\t\t\t// or array literal. This function also assumes that the opening character\r\n\t\t\t\t// `(` or `[` has already been gobbled, and gobbles expressions and commas\r\n\t\t\t\t// until the terminator character `)` or `]` is encountered.\r\n\t\t\t\t// e.g. `foo(bar, baz)`, `my_func()`, or `[bar, baz]`\r\n\t\t\t\tgobbleArguments = function(termination) {\r\n\t\t\t\t\tvar ch_i, args = [], node, closed = false;\r\n\t\t\t\t\twhile(index < length) {\r\n\t\t\t\t\t\tgobbleSpaces();\r\n\t\t\t\t\t\tch_i = exprICode(index);\r\n\t\t\t\t\t\tif(ch_i === termination) { // done parsing\r\n\t\t\t\t\t\t\tclosed = true;\r\n\t\t\t\t\t\t\tindex++;\r\n\t\t\t\t\t\t\tbreak;\r\n\t\t\t\t\t\t} else if (ch_i === COMMA_CODE) { // between expressions\r\n\t\t\t\t\t\t\tindex++;\r\n\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\tnode = gobbleExpression();\r\n\t\t\t\t\t\t\tif(!node || node.type === COMPOUND) {\r\n\t\t\t\t\t\t\t\tthrowError('Expected comma', index);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\targs.push(node);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t}\r\n\t\t\t\t\tif (!closed) {\r\n\t\t\t\t\t\tthrowError('Expected ' + String.fromCharCode(termination), index);\r\n\t\t\t\t\t}\r\n\t\t\t\t\treturn args;\r\n\t\t\t\t},\r\n\r\n\t\t\t\t// Gobble a non-literal variable name. This variable name may include properties\r\n\t\t\t\t// e.g. `foo`, `bar.baz`, `foo['bar'].baz`\r\n\t\t\t\t// It also gobbles function calls:\r\n\t\t\t\t// e.g. `Math.acos(obj.angle)`\r\n\t\t\t\tgobbleVariable = function() {\r\n\t\t\t\t\tvar ch_i, node;\r\n\t\t\t\t\tch_i = exprICode(index);\r\n\r\n\t\t\t\t\tif(ch_i === OPAREN_CODE) {\r\n\t\t\t\t\t\tnode = gobbleGroup();\r\n\t\t\t\t\t} else {\r\n\t\t\t\t\t\tnode = gobbleIdentifier();\r\n\t\t\t\t\t}\r\n\t\t\t\t\tgobbleSpaces();\r\n\t\t\t\t\tch_i = exprICode(index);\r\n\t\t\t\t\twhile(ch_i === PERIOD_CODE || ch_i === OBRACK_CODE || ch_i === OPAREN_CODE) {\r\n\t\t\t\t\t\tindex++;\r\n\t\t\t\t\t\tif(ch_i === PERIOD_CODE) {\r\n\t\t\t\t\t\t\tgobbleSpaces();\r\n\t\t\t\t\t\t\tnode = {\r\n\t\t\t\t\t\t\t\ttype: MEMBER_EXP,\r\n\t\t\t\t\t\t\t\tcomputed: false,\r\n\t\t\t\t\t\t\t\tobject: node,\r\n\t\t\t\t\t\t\t\tproperty: gobbleIdentifier()\r\n\t\t\t\t\t\t\t};\r\n\t\t\t\t\t\t} else if(ch_i === OBRACK_CODE) {\r\n\t\t\t\t\t\t\tnode = {\r\n\t\t\t\t\t\t\t\ttype: MEMBER_EXP,\r\n\t\t\t\t\t\t\t\tcomputed: true,\r\n\t\t\t\t\t\t\t\tobject: node,\r\n\t\t\t\t\t\t\t\tproperty: gobbleExpression()\r\n\t\t\t\t\t\t\t};\r\n\t\t\t\t\t\t\tgobbleSpaces();\r\n\t\t\t\t\t\t\tch_i = exprICode(index);\r\n\t\t\t\t\t\t\tif(ch_i !== CBRACK_CODE) {\r\n\t\t\t\t\t\t\t\tthrowError('Unclosed [', index);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\tindex++;\r\n\t\t\t\t\t\t} else if(ch_i === OPAREN_CODE) {\r\n\t\t\t\t\t\t\t// A function call is being made; gobble all the arguments\r\n\t\t\t\t\t\t\tnode = {\r\n\t\t\t\t\t\t\t\ttype: CALL_EXP,\r\n\t\t\t\t\t\t\t\t'arguments': gobbleArguments(CPAREN_CODE),\r\n\t\t\t\t\t\t\t\tcallee: node\r\n\t\t\t\t\t\t\t};\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t\tgobbleSpaces();\r\n\t\t\t\t\t\tch_i = exprICode(index);\r\n\t\t\t\t\t}\r\n\t\t\t\t\treturn node;\r\n\t\t\t\t},\r\n\r\n\t\t\t\t// Responsible for parsing a group of things within parentheses `()`\r\n\t\t\t\t// This function assumes that it needs to gobble the opening parenthesis\r\n\t\t\t\t// and then tries to gobble everything within that parenthesis, assuming\r\n\t\t\t\t// that the next thing it should see is the close parenthesis. If not,\r\n\t\t\t\t// then the expression probably doesn't have a `)`\r\n\t\t\t\tgobbleGroup = function() {\r\n\t\t\t\t\tindex++;\r\n\t\t\t\t\tvar node = gobbleExpression();\r\n\t\t\t\t\tgobbleSpaces();\r\n\t\t\t\t\tif(exprICode(index) === CPAREN_CODE) {\r\n\t\t\t\t\t\tindex++;\r\n\t\t\t\t\t\treturn node;\r\n\t\t\t\t\t} else {\r\n\t\t\t\t\t\tthrowError('Unclosed (', index);\r\n\t\t\t\t\t}\r\n\t\t\t\t},\r\n\r\n\t\t\t\t// Responsible for parsing Array literals `[1, 2, 3]`\r\n\t\t\t\t// This function assumes that it needs to gobble the opening bracket\r\n\t\t\t\t// and then tries to gobble the expressions as arguments.\r\n\t\t\t\tgobbleArray = function() {\r\n\t\t\t\t\tindex++;\r\n\t\t\t\t\treturn {\r\n\t\t\t\t\t\ttype: ARRAY_EXP,\r\n\t\t\t\t\t\telements: gobbleArguments(CBRACK_CODE)\r\n\t\t\t\t\t};\r\n\t\t\t\t},\r\n\r\n\t\t\t\tnodes = [], ch_i, node;\r\n\r\n\t\t\twhile(index < length) {\r\n\t\t\t\tch_i = exprICode(index);\r\n\r\n\t\t\t\t// Expressions can be separated by semicolons, commas, or just inferred without any\r\n\t\t\t\t// separators\r\n\t\t\t\tif(ch_i === SEMCOL_CODE || ch_i === COMMA_CODE) {\r\n\t\t\t\t\tindex++; // ignore separators\r\n\t\t\t\t} else {\r\n\t\t\t\t\t// Try to gobble each expression individually\r\n\t\t\t\t\tif((node = gobbleExpression())) {\r\n\t\t\t\t\t\tnodes.push(node);\r\n\t\t\t\t\t// If we weren't able to find a binary expression and are out of room, then\r\n\t\t\t\t\t// the expression passed in probably has too much\r\n\t\t\t\t\t} else if(index < length) {\r\n\t\t\t\t\t\tthrowError('Unexpected \"' + exprI(index) + '\"', index);\r\n\t\t\t\t\t}\r\n\t\t\t\t}\r\n\t\t\t}\r\n\r\n\t\t\t// If there's only one expression just try returning the expression\r\n\t\t\tif(nodes.length === 1) {\r\n\t\t\t\treturn nodes[0];\r\n\t\t\t} else {\r\n\t\t\t\treturn {\r\n\t\t\t\t\ttype: COMPOUND,\r\n\t\t\t\t\tbody: nodes\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t};\r\n\r\n\t// To be filled in by the template\r\n\tjsep.version = '0.3.4';\r\n\tjsep.toString = function() { return 'JavaScript Expression Parser (JSEP) v' + jsep.version; };\r\n\r\n\t/**\r\n\t * @method jsep.addUnaryOp\r\n\t * @param {string} op_name The name of the unary op to add\r\n\t * @return jsep\r\n\t */\r\n\tjsep.addUnaryOp = function(op_name) {\r\n\t\tmax_unop_len = Math.max(op_name.length, max_unop_len);\r\n\t\tunary_ops[op_name] = t; return this;\r\n\t};\r\n\r\n\t/**\r\n\t * @method jsep.addBinaryOp\r\n\t * @param {string} op_name The name of the binary op to add\r\n\t * @param {number} precedence The precedence of the binary op (can be a float)\r\n\t * @return jsep\r\n\t */\r\n\tjsep.addBinaryOp = function(op_name, precedence) {\r\n\t\tmax_binop_len = Math.max(op_name.length, max_binop_len);\r\n\t\tbinary_ops[op_name] = precedence;\r\n\t\treturn this;\r\n\t};\r\n\r\n\t/**\r\n\t * @method jsep.addLiteral\r\n\t * @param {string} literal_name The name of the literal to add\r\n\t * @param {*} literal_value The value of the literal\r\n\t * @return jsep\r\n\t */\r\n\tjsep.addLiteral = function(literal_name, literal_value) {\r\n\t\tliterals[literal_name] = literal_value;\r\n\t\treturn this;\r\n\t};\r\n\r\n\t/**\r\n\t * @method jsep.removeUnaryOp\r\n\t * @param {string} op_name The name of the unary op to remove\r\n\t * @return jsep\r\n\t */\r\n\tjsep.removeUnaryOp = function(op_name) {\r\n\t\tdelete unary_ops[op_name];\r\n\t\tif(op_name.length === max_unop_len) {\r\n\t\t\tmax_unop_len = getMaxKeyLen(unary_ops);\r\n\t\t}\r\n\t\treturn this;\r\n\t};\r\n\r\n\t/**\r\n\t * @method jsep.removeAllUnaryOps\r\n\t * @return jsep\r\n\t */\r\n\tjsep.removeAllUnaryOps = function() {\r\n\t\tunary_ops = {};\r\n\t\tmax_unop_len = 0;\r\n\r\n\t\treturn this;\r\n\t};\r\n\r\n\t/**\r\n\t * @method jsep.removeBinaryOp\r\n\t * @param {string} op_name The name of the binary op to remove\r\n\t * @return jsep\r\n\t */\r\n\tjsep.removeBinaryOp = function(op_name) {\r\n\t\tdelete binary_ops[op_name];\r\n\t\tif(op_name.length === max_binop_len) {\r\n\t\t\tmax_binop_len = getMaxKeyLen(binary_ops);\r\n\t\t}\r\n\t\treturn this;\r\n\t};\r\n\r\n\t/**\r\n\t * @method jsep.removeAllBinaryOps\r\n\t * @return jsep\r\n\t */\r\n\tjsep.removeAllBinaryOps = function() {\r\n\t\tbinary_ops = {};\r\n\t\tmax_binop_len = 0;\r\n\r\n\t\treturn this;\r\n\t};\r\n\r\n\t/**\r\n\t * @method jsep.removeLiteral\r\n\t * @param {string} literal_name The name of the literal to remove\r\n\t * @return jsep\r\n\t */\r\n\tjsep.removeLiteral = function(literal_name) {\r\n\t\tdelete literals[literal_name];\r\n\t\treturn this;\r\n\t};\r\n\r\n\t/**\r\n\t * @method jsep.removeAllLiterals\r\n\t * @return jsep\r\n\t */\r\n\tjsep.removeAllLiterals = function() {\r\n\t\tliterals = {};\r\n\r\n\t\treturn this;\r\n\t};\r\n\r\n\t// In desktop environments, have a way to restore the old value for `jsep`\r\n\tif (typeof exports === 'undefined') {\r\n\t\tvar old_jsep = root.jsep;\r\n\t\t// The star of the show! It's a function!\r\n\t\troot.jsep = jsep;\r\n\t\t// And a courteous function willing to move out of the way for other similarly-named objects!\r\n\t\tjsep.noConflict = function() {\r\n\t\t\tif(root.jsep === jsep) {\r\n\t\t\t\troot.jsep = old_jsep;\r\n\t\t\t}\r\n\t\t\treturn jsep;\r\n\t\t};\r\n\t} else {\r\n\t\t// In Node.JS environments\r\n\t\tif (typeof module !== 'undefined' && module.exports) {\r\n\t\t\texports = module.exports = jsep;\r\n\t\t} else {\r\n\t\t\texports.parse = jsep;\r\n\t\t}\r\n\t}\r\n}(this));\r\n","/* Mapbox GL JS is licensed under the 3-Clause BSD License. Full text of license: https://github.com/mapbox/mapbox-gl-js/blob/v1.13.3/LICENSE.txt */\n(function (global, factory) {\ntypeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :\ntypeof define === 'function' && define.amd ? define(factory) :\n(global = global || self, global.mapboxgl = factory());\n}(this, (function () { 'use strict';\n\n/* eslint-disable */\n\nvar shared, worker, mapboxgl;\n// define gets called three times: one for each chunk. we rely on the order\n// they're imported to know which is which\nfunction define(_, chunk) {\nif (!shared) {\n    shared = chunk;\n} else if (!worker) {\n    worker = chunk;\n} else {\n    var workerBundleString = 'var sharedChunk = {}; (' + shared + ')(sharedChunk); (' + worker + ')(sharedChunk);'\n\n    var sharedChunk = {};\n    shared(sharedChunk);\n    mapboxgl = chunk(sharedChunk);\n    if (typeof window !== 'undefined') {\n        mapboxgl.workerUrl = window.URL.createObjectURL(new Blob([workerBundleString], { type: 'text/javascript' }));\n    }\n}\n}\n\n\ndefine([\"exports\"],(function(t){\"use strict\";function e(t,e){return t(e={exports:{}},e.exports),e.exports}var r=n;function n(t,e,r,n){this.cx=3*t,this.bx=3*(r-t)-this.cx,this.ax=1-this.cx-this.bx,this.cy=3*e,this.by=3*(n-e)-this.cy,this.ay=1-this.cy-this.by,this.p1x=t,this.p1y=n,this.p2x=r,this.p2y=n;}n.prototype.sampleCurveX=function(t){return ((this.ax*t+this.bx)*t+this.cx)*t},n.prototype.sampleCurveY=function(t){return ((this.ay*t+this.by)*t+this.cy)*t},n.prototype.sampleCurveDerivativeX=function(t){return (3*this.ax*t+2*this.bx)*t+this.cx},n.prototype.solveCurveX=function(t,e){var r,n,i,a,o;for(void 0===e&&(e=1e-6),i=t,o=0;o<8;o++){if(a=this.sampleCurveX(i)-t,Math.abs(a)<e)return i;var s=this.sampleCurveDerivativeX(i);if(Math.abs(s)<1e-6)break;i-=a/s;}if((i=t)<(r=0))return r;if(i>(n=1))return n;for(;r<n;){if(a=this.sampleCurveX(i),Math.abs(a-t)<e)return i;t>a?r=i:n=i,i=.5*(n-r)+r;}return i},n.prototype.solve=function(t,e){return this.sampleCurveY(this.solveCurveX(t,e))};var i=a;function a(t,e){this.x=t,this.y=e;}a.prototype={clone:function(){return new a(this.x,this.y)},add:function(t){return this.clone()._add(t)},sub:function(t){return this.clone()._sub(t)},multByPoint:function(t){return this.clone()._multByPoint(t)},divByPoint:function(t){return this.clone()._divByPoint(t)},mult:function(t){return this.clone()._mult(t)},div:function(t){return this.clone()._div(t)},rotate:function(t){return this.clone()._rotate(t)},rotateAround:function(t,e){return this.clone()._rotateAround(t,e)},matMult:function(t){return this.clone()._matMult(t)},unit:function(){return this.clone()._unit()},perp:function(){return this.clone()._perp()},round:function(){return this.clone()._round()},mag:function(){return Math.sqrt(this.x*this.x+this.y*this.y)},equals:function(t){return this.x===t.x&&this.y===t.y},dist:function(t){return Math.sqrt(this.distSqr(t))},distSqr:function(t){var e=t.x-this.x,r=t.y-this.y;return e*e+r*r},angle:function(){return Math.atan2(this.y,this.x)},angleTo:function(t){return Math.atan2(this.y-t.y,this.x-t.x)},angleWith:function(t){return this.angleWithSep(t.x,t.y)},angleWithSep:function(t,e){return Math.atan2(this.x*e-this.y*t,this.x*t+this.y*e)},_matMult:function(t){var e=t[2]*this.x+t[3]*this.y;return this.x=t[0]*this.x+t[1]*this.y,this.y=e,this},_add:function(t){return this.x+=t.x,this.y+=t.y,this},_sub:function(t){return this.x-=t.x,this.y-=t.y,this},_mult:function(t){return this.x*=t,this.y*=t,this},_div:function(t){return this.x/=t,this.y/=t,this},_multByPoint:function(t){return this.x*=t.x,this.y*=t.y,this},_divByPoint:function(t){return this.x/=t.x,this.y/=t.y,this},_unit:function(){return this._div(this.mag()),this},_perp:function(){var t=this.y;return this.y=this.x,this.x=-t,this},_rotate:function(t){var e=Math.cos(t),r=Math.sin(t),n=r*this.x+e*this.y;return this.x=e*this.x-r*this.y,this.y=n,this},_rotateAround:function(t,e){var r=Math.cos(t),n=Math.sin(t),i=e.y+n*(this.x-e.x)+r*(this.y-e.y);return this.x=e.x+r*(this.x-e.x)-n*(this.y-e.y),this.y=i,this},_round:function(){return this.x=Math.round(this.x),this.y=Math.round(this.y),this}},a.convert=function(t){return t instanceof a?t:Array.isArray(t)?new a(t[0],t[1]):t};var o=\"undefined\"!=typeof self?self:{},s=Math.pow(2,53)-1;function u(t,e,n,i){var a=new r(t,e,n,i);return function(t){return a.solve(t)}}var l=u(.25,.1,.25,1);function p(t,e,r){return Math.min(r,Math.max(e,t))}function c(t,e,r){var n=r-e,i=((t-e)%n+n)%n+e;return i===e?r:i}function h(t){for(var e=[],r=arguments.length-1;r-- >0;)e[r]=arguments[r+1];for(var n=0,i=e;n<i.length;n+=1){var a=i[n];for(var o in a)t[o]=a[o];}return t}var f=1;function y(){return f++}function d(){return function t(e){return e?(e^16*Math.random()>>e/4).toString(16):([1e7]+-[1e3]+-4e3+-8e3+-1e11).replace(/[018]/g,t)}()}function m(t){return !!t&&/^[0-9a-f]{8}-[0-9a-f]{4}-[4][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(t)}function v(t,e){t.forEach((function(t){e[t]&&(e[t]=e[t].bind(e));}));}function g(t,e){return -1!==t.indexOf(e,t.length-e.length)}function x(t,e,r){var n={};for(var i in t)n[i]=e.call(r||this,t[i],i,t);return n}function b(t,e,r){var n={};for(var i in t)e.call(r||this,t[i],i,t)&&(n[i]=t[i]);return n}function w(t){return Array.isArray(t)?t.map(w):\"object\"==typeof t&&t?x(t,w):t}var _={};function A(t){_[t]||(\"undefined\"!=typeof console&&console.warn(t),_[t]=!0);}function S(t,e,r){return (r.y-t.y)*(e.x-t.x)>(e.y-t.y)*(r.x-t.x)}function k(t){for(var e=0,r=0,n=t.length,i=n-1,a=void 0,o=void 0;r<n;i=r++)e+=((o=t[i]).x-(a=t[r]).x)*(a.y+o.y);return e}function I(){return \"undefined\"!=typeof WorkerGlobalScope&&\"undefined\"!=typeof self&&self instanceof WorkerGlobalScope}function z(t){var e={};if(t.replace(/(?:^|(?:\\s*\\,\\s*))([^\\x00-\\x20\\(\\)<>@\\,;\\:\\\\\"\\/\\[\\]\\?\\=\\{\\}\\x7F]+)(?:\\=(?:([^\\x00-\\x20\\(\\)<>@\\,;\\:\\\\\"\\/\\[\\]\\?\\=\\{\\}\\x7F]+)|(?:\\\"((?:[^\"\\\\]|\\\\.)*)\\\")))?/g,(function(t,r,n,i){var a=n||i;return e[r]=!a||a.toLowerCase(),\"\"})),e[\"max-age\"]){var r=parseInt(e[\"max-age\"],10);isNaN(r)?delete e[\"max-age\"]:e[\"max-age\"]=r;}return e}var C=null;function E(t){if(null==C){var e=t.navigator?t.navigator.userAgent:null;C=!!t.safari||!(!e||!(/\\b(iPad|iPhone|iPod)\\b/.test(e)||e.match(\"Safari\")&&!e.match(\"Chrome\")));}return C}function P(t){try{var e=o[t];return e.setItem(\"_mapbox_test_\",1),e.removeItem(\"_mapbox_test_\"),!0}catch(t){return !1}}var M,B,T,V,F=o.performance&&o.performance.now?o.performance.now.bind(o.performance):Date.now.bind(Date),D=o.requestAnimationFrame||o.mozRequestAnimationFrame||o.webkitRequestAnimationFrame||o.msRequestAnimationFrame,L=o.cancelAnimationFrame||o.mozCancelAnimationFrame||o.webkitCancelAnimationFrame||o.msCancelAnimationFrame,O={now:F,frame:function(t){var e=D(t);return {cancel:function(){return L(e)}}},getImageData:function(t,e){void 0===e&&(e=0);var r=o.document.createElement(\"canvas\"),n=r.getContext(\"2d\");if(!n)throw new Error(\"failed to create canvas 2d context\");return r.width=t.width,r.height=t.height,n.drawImage(t,0,0,t.width,t.height),n.getImageData(-e,-e,t.width+2*e,t.height+2*e)},resolveURL:function(t){return M||(M=o.document.createElement(\"a\")),M.href=t,M.href},hardwareConcurrency:o.navigator&&o.navigator.hardwareConcurrency||4,get devicePixelRatio(){return o.devicePixelRatio},get prefersReducedMotion(){return !!o.matchMedia&&(null==B&&(B=o.matchMedia(\"(prefers-reduced-motion: reduce)\")),B.matches)}},R={API_URL:\"https://api.mapbox.com\",get EVENTS_URL(){return this.API_URL?0===this.API_URL.indexOf(\"https://api.mapbox.cn\")?\"https://events.mapbox.cn/events/v2\":0===this.API_URL.indexOf(\"https://api.mapbox.com\")?\"https://events.mapbox.com/events/v2\":null:null},FEEDBACK_URL:\"https://apps.mapbox.com/feedback\",REQUIRE_ACCESS_TOKEN:!0,ACCESS_TOKEN:null,MAX_PARALLEL_IMAGE_REQUESTS:16},U={supported:!1,testSupport:function(t){!j&&V&&(q?N(t):T=t);}},j=!1,q=!1;function N(t){var e=t.createTexture();t.bindTexture(t.TEXTURE_2D,e);try{if(t.texImage2D(t.TEXTURE_2D,0,t.RGBA,t.RGBA,t.UNSIGNED_BYTE,V),t.isContextLost())return;U.supported=!0;}catch(t){}t.deleteTexture(e),j=!0;}o.document&&((V=o.document.createElement(\"img\")).onload=function(){T&&N(T),T=null,q=!0;},V.onerror=function(){j=!0,T=null;},V.src=\"data:image/webp;base64,UklGRh4AAABXRUJQVlA4TBEAAAAvAQAAAAfQ//73v/+BiOh/AAA=\");var K=\"01\",G=function(t,e){this._transformRequestFn=t,this._customAccessToken=e,this._createSkuToken();};function Z(t){return 0===t.indexOf(\"mapbox:\")}G.prototype._createSkuToken=function(){var t=function(){for(var t=\"\",e=0;e<10;e++)t+=\"0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ\"[Math.floor(62*Math.random())];return {token:[\"1\",K,t].join(\"\"),tokenExpiresAt:Date.now()+432e5}}();this._skuToken=t.token,this._skuTokenExpiresAt=t.tokenExpiresAt;},G.prototype._isSkuTokenExpired=function(){return Date.now()>this._skuTokenExpiresAt},G.prototype.transformRequest=function(t,e){return this._transformRequestFn&&this._transformRequestFn(t,e)||{url:t}},G.prototype.normalizeStyleURL=function(t,e){if(!Z(t))return t;var r=Y(t);return r.path=\"/styles/v1\"+r.path,this._makeAPIURL(r,this._customAccessToken||e)},G.prototype.normalizeGlyphsURL=function(t,e){if(!Z(t))return t;var r=Y(t);return r.path=\"/fonts/v1\"+r.path,this._makeAPIURL(r,this._customAccessToken||e)},G.prototype.normalizeSourceURL=function(t,e){if(!Z(t))return t;var r=Y(t);return r.path=\"/v4/\"+r.authority+\".json\",r.params.push(\"secure\"),this._makeAPIURL(r,this._customAccessToken||e)},G.prototype.normalizeSpriteURL=function(t,e,r,n){var i=Y(t);return Z(t)?(i.path=\"/styles/v1\"+i.path+\"/sprite\"+e+r,this._makeAPIURL(i,this._customAccessToken||n)):(i.path+=\"\"+e+r,$(i))},G.prototype.normalizeTileURL=function(t,e){if(this._isSkuTokenExpired()&&this._createSkuToken(),t&&!Z(t))return t;var r=Y(t);r.path=r.path.replace(/(\\.(png|jpg)\\d*)(?=$)/,(O.devicePixelRatio>=2||512===e?\"@2x\":\"\")+(U.supported?\".webp\":\"$1\")),r.path=r.path.replace(/^.+\\/v4\\//,\"/\"),r.path=\"/v4\"+r.path;var n=this._customAccessToken||function(t){for(var e=0,r=t;e<r.length;e+=1){var n=r[e].match(/^access_token=(.*)$/);if(n)return n[1]}return null}(r.params)||R.ACCESS_TOKEN;return R.REQUIRE_ACCESS_TOKEN&&n&&this._skuToken&&r.params.push(\"sku=\"+this._skuToken),this._makeAPIURL(r,n)},G.prototype.canonicalizeTileURL=function(t,e){var r=Y(t);if(!r.path.match(/(^\\/v4\\/)/)||!r.path.match(/\\.[\\w]+$/))return t;var n=\"mapbox://tiles/\";n+=r.path.replace(\"/v4/\",\"\");var i=r.params;return e&&(i=i.filter((function(t){return !t.match(/^access_token=/)}))),i.length&&(n+=\"?\"+i.join(\"&\")),n},G.prototype.canonicalizeTileset=function(t,e){for(var r=!!e&&Z(e),n=[],i=0,a=t.tiles||[];i<a.length;i+=1){var o=a[i];J(o)?n.push(this.canonicalizeTileURL(o,r)):n.push(o);}return n},G.prototype._makeAPIURL=function(t,e){var r=\"See https://www.mapbox.com/api-documentation/#access-tokens-and-token-scopes\",n=Y(R.API_URL);if(t.protocol=n.protocol,t.authority=n.authority,\"http\"===t.protocol){var i=t.params.indexOf(\"secure\");i>=0&&t.params.splice(i,1);}if(\"/\"!==n.path&&(t.path=\"\"+n.path+t.path),!R.REQUIRE_ACCESS_TOKEN)return $(t);if(!(e=e||R.ACCESS_TOKEN))throw new Error(\"An API access token is required to use Mapbox GL. \"+r);if(\"s\"===e[0])throw new Error(\"Use a public access token (pk.*) with Mapbox GL, not a secret access token (sk.*). \"+r);return t.params=t.params.filter((function(t){return -1===t.indexOf(\"access_token\")})),t.params.push(\"access_token=\"+e),$(t)};var X=/^((https?:)?\\/\\/)?([^\\/]+\\.)?mapbox\\.c(n|om)(\\/|\\?|$)/i;function J(t){return X.test(t)}var H=/^(\\w+):\\/\\/([^/?]*)(\\/[^?]+)?\\??(.+)?/;function Y(t){var e=t.match(H);if(!e)throw new Error(\"Unable to parse URL object\");return {protocol:e[1],authority:e[2],path:e[3]||\"/\",params:e[4]?e[4].split(\"&\"):[]}}function $(t){var e=t.params.length?\"?\"+t.params.join(\"&\"):\"\";return t.protocol+\"://\"+t.authority+t.path+e}function W(t){if(!t)return null;var e=t.split(\".\");if(!e||3!==e.length)return null;try{return JSON.parse(decodeURIComponent(o.atob(e[1]).split(\"\").map((function(t){return \"%\"+(\"00\"+t.charCodeAt(0).toString(16)).slice(-2)})).join(\"\")))}catch(t){return null}}var Q=function(t){this.type=t,this.anonId=null,this.eventData={},this.queue=[],this.pendingRequest=null;};Q.prototype.getStorageKey=function(t){var e,r=W(R.ACCESS_TOKEN);return e=r&&r.u?o.btoa(encodeURIComponent(r.u).replace(/%([0-9A-F]{2})/g,(function(t,e){return String.fromCharCode(Number(\"0x\"+e))}))):R.ACCESS_TOKEN||\"\",t?\"mapbox.eventData.\"+t+\":\"+e:\"mapbox.eventData:\"+e},Q.prototype.fetchEventData=function(){var t=P(\"localStorage\"),e=this.getStorageKey(),r=this.getStorageKey(\"uuid\");if(t)try{var n=o.localStorage.getItem(e);n&&(this.eventData=JSON.parse(n));var i=o.localStorage.getItem(r);i&&(this.anonId=i);}catch(t){A(\"Unable to read from LocalStorage\");}},Q.prototype.saveEventData=function(){var t=P(\"localStorage\"),e=this.getStorageKey(),r=this.getStorageKey(\"uuid\");if(t)try{o.localStorage.setItem(r,this.anonId),Object.keys(this.eventData).length>=1&&o.localStorage.setItem(e,JSON.stringify(this.eventData));}catch(t){A(\"Unable to write to LocalStorage\");}},Q.prototype.processRequests=function(t){},Q.prototype.postEvent=function(t,e,r,n){var i=this;if(R.EVENTS_URL){var a=Y(R.EVENTS_URL);a.params.push(\"access_token=\"+(n||R.ACCESS_TOKEN||\"\"));var o={event:this.type,created:new Date(t).toISOString(),sdkIdentifier:\"mapbox-gl-js\",sdkVersion:\"1.13.3\",skuId:K,userId:this.anonId},s=e?h(o,e):o,u={url:$(a),headers:{\"Content-Type\":\"text/plain\"},body:JSON.stringify([s])};this.pendingRequest=wt(u,(function(t){i.pendingRequest=null,r(t),i.saveEventData(),i.processRequests(n);}));}},Q.prototype.queueRequest=function(t,e){this.queue.push(t),this.processRequests(e);};var tt,et,rt=function(t){function e(){t.call(this,\"map.load\"),this.success={},this.skuToken=\"\";}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.postMapLoadEvent=function(t,e,r,n){this.skuToken=r;var i=!(!n&&!R.ACCESS_TOKEN),a=Array.isArray(t)&&t.some((function(t){return Z(t)||J(t)}));R.EVENTS_URL&&i&&a&&this.queueRequest({id:e,timestamp:Date.now()},n);},e.prototype.processRequests=function(t){var e=this;if(!this.pendingRequest&&0!==this.queue.length){var r=this.queue.shift(),n=r.id,i=r.timestamp;n&&this.success[n]||(this.anonId||this.fetchEventData(),m(this.anonId)||(this.anonId=d()),this.postEvent(i,{skuToken:this.skuToken},(function(t){t||n&&(e.success[n]=!0);}),t));}},e}(Q),nt=new(function(t){function e(e){t.call(this,\"appUserTurnstile\"),this._customAccessToken=e;}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.postTurnstileEvent=function(t,e){R.EVENTS_URL&&R.ACCESS_TOKEN&&Array.isArray(t)&&t.some((function(t){return Z(t)||J(t)}))&&this.queueRequest(Date.now(),e);},e.prototype.processRequests=function(t){var e=this;if(!this.pendingRequest&&0!==this.queue.length){this.anonId&&this.eventData.lastSuccess&&this.eventData.tokenU||this.fetchEventData();var r=W(R.ACCESS_TOKEN),n=r?r.u:R.ACCESS_TOKEN,i=n!==this.eventData.tokenU;m(this.anonId)||(this.anonId=d(),i=!0);var a=this.queue.shift();if(this.eventData.lastSuccess){var o=new Date(this.eventData.lastSuccess),s=new Date(a),u=(a-this.eventData.lastSuccess)/864e5;i=i||u>=1||u<-1||o.getDate()!==s.getDate();}else i=!0;if(!i)return this.processRequests();this.postEvent(a,{\"enabled.telemetry\":!1},(function(t){t||(e.eventData.lastSuccess=a,e.eventData.tokenU=n);}),t);}},e}(Q)),it=nt.postTurnstileEvent.bind(nt),at=new rt,ot=at.postMapLoadEvent.bind(at),st=500,ut=50;function lt(){o.caches&&!tt&&(tt=o.caches.open(\"mapbox-tiles\"));}function pt(t){var e=t.indexOf(\"?\");return e<0?t:t.slice(0,e)}var ct,ht=1/0;function ft(){return null==ct&&(ct=o.OffscreenCanvas&&new o.OffscreenCanvas(1,1).getContext(\"2d\")&&\"function\"==typeof o.createImageBitmap),ct}var yt={Unknown:\"Unknown\",Style:\"Style\",Source:\"Source\",Tile:\"Tile\",Glyphs:\"Glyphs\",SpriteImage:\"SpriteImage\",SpriteJSON:\"SpriteJSON\",Image:\"Image\"};\"function\"==typeof Object.freeze&&Object.freeze(yt);var dt=function(t){function e(e,r,n){401===r&&J(n)&&(e+=\": you may have provided an invalid Mapbox access token. See https://www.mapbox.com/api-documentation/#access-tokens-and-token-scopes\"),t.call(this,e),this.status=r,this.url=n,this.name=this.constructor.name,this.message=e;}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.toString=function(){return this.name+\": \"+this.message+\" (\"+this.status+\"): \"+this.url},e}(Error),mt=I()?function(){return self.worker&&self.worker.referrer}:function(){return (\"blob:\"===o.location.protocol?o.parent:o).location.href};var vt,gt,xt=function(t,e){if(!(/^file:/.test(r=t.url)||/^file:/.test(mt())&&!/^\\w+:/.test(r))){if(o.fetch&&o.Request&&o.AbortController&&o.Request.prototype.hasOwnProperty(\"signal\"))return function(t,e){var r,n=new o.AbortController,i=new o.Request(t.url,{method:t.method||\"GET\",body:t.body,credentials:t.credentials,headers:t.headers,referrer:mt(),signal:n.signal}),a=!1,s=!1,u=(r=i.url).indexOf(\"sku=\")>0&&J(r);\"json\"===t.type&&i.headers.set(\"Accept\",\"application/json\");var l=function(r,n,a){if(!s){if(r&&\"SecurityError\"!==r.message&&A(r),n&&a)return p(n);var l=Date.now();o.fetch(i).then((function(r){if(r.ok){var n=u?r.clone():null;return p(r,n,l)}return e(new dt(r.statusText,r.status,t.url))})).catch((function(t){20!==t.code&&e(new Error(t.message));}));}},p=function(r,n,u){(\"arrayBuffer\"===t.type?r.arrayBuffer():\"json\"===t.type?r.json():r.text()).then((function(t){s||(n&&u&&function(t,e,r){if(lt(),tt){var n={status:e.status,statusText:e.statusText,headers:new o.Headers};e.headers.forEach((function(t,e){return n.headers.set(e,t)}));var i=z(e.headers.get(\"Cache-Control\")||\"\");i[\"no-store\"]||(i[\"max-age\"]&&n.headers.set(\"Expires\",new Date(r+1e3*i[\"max-age\"]).toUTCString()),new Date(n.headers.get(\"Expires\")).getTime()-r<42e4||function(t,e){if(void 0===et)try{new Response(new ReadableStream),et=!0;}catch(t){et=!1;}et?e(t.body):t.blob().then(e);}(e,(function(e){var r=new o.Response(e,n);lt(),tt&&tt.then((function(e){return e.put(pt(t.url),r)})).catch((function(t){return A(t.message)}));})));}}(i,n,u),a=!0,e(null,t,r.headers.get(\"Cache-Control\"),r.headers.get(\"Expires\")));})).catch((function(t){s||e(new Error(t.message));}));};return u?function(t,e){if(lt(),!tt)return e(null);var r=pt(t.url);tt.then((function(t){t.match(r).then((function(n){var i=function(t){if(!t)return !1;var e=new Date(t.headers.get(\"Expires\")||0),r=z(t.headers.get(\"Cache-Control\")||\"\");return e>Date.now()&&!r[\"no-cache\"]}(n);t.delete(r),i&&t.put(r,n.clone()),e(null,n,i);})).catch(e);})).catch(e);}(i,l):l(null,null),{cancel:function(){s=!0,a||n.abort();}}}(t,e);if(I()&&self.worker&&self.worker.actor)return self.worker.actor.send(\"getResource\",t,e,void 0,!0)}var r;return function(t,e){var r=new o.XMLHttpRequest;for(var n in r.open(t.method||\"GET\",t.url,!0),\"arrayBuffer\"===t.type&&(r.responseType=\"arraybuffer\"),t.headers)r.setRequestHeader(n,t.headers[n]);return \"json\"===t.type&&(r.responseType=\"text\",r.setRequestHeader(\"Accept\",\"application/json\")),r.withCredentials=\"include\"===t.credentials,r.onerror=function(){e(new Error(r.statusText));},r.onload=function(){if((r.status>=200&&r.status<300||0===r.status)&&null!==r.response){var n=r.response;if(\"json\"===t.type)try{n=JSON.parse(r.response);}catch(t){return e(t)}e(null,n,r.getResponseHeader(\"Cache-Control\"),r.getResponseHeader(\"Expires\"));}else e(new dt(r.statusText,r.status,t.url));},r.send(t.body),{cancel:function(){return r.abort()}}}(t,e)},bt=function(t,e){return xt(h(t,{type:\"arrayBuffer\"}),e)},wt=function(t,e){return xt(h(t,{method:\"POST\"}),e)},_t=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAC0lEQVQYV2NgAAIAAAUAAarVyFEAAAAASUVORK5CYII=\";vt=[],gt=0;var At=function(t,e){if(U.supported&&(t.headers||(t.headers={}),t.headers.accept=\"image/webp,*/*\"),gt>=R.MAX_PARALLEL_IMAGE_REQUESTS){var r={requestParameters:t,callback:e,cancelled:!1,cancel:function(){this.cancelled=!0;}};return vt.push(r),r}gt++;var n=!1,i=function(){if(!n)for(n=!0,gt--;vt.length&&gt<R.MAX_PARALLEL_IMAGE_REQUESTS;){var t=vt.shift();t.cancelled||(t.cancel=At(t.requestParameters,t.callback).cancel);}},a=bt(t,(function(t,r,n,a){i(),t?e(t):r&&(ft()?function(t,e){var r=new o.Blob([new Uint8Array(t)],{type:\"image/png\"});o.createImageBitmap(r).then((function(t){e(null,t);})).catch((function(t){e(new Error(\"Could not load image because of \"+t.message+\". Please make sure to use a supported image type such as PNG or JPEG. Note that SVGs are not supported.\"));}));}(r,e):function(t,e,r,n){var i=new o.Image,a=o.URL;i.onload=function(){e(null,i),a.revokeObjectURL(i.src),i.onload=null,o.requestAnimationFrame((function(){i.src=_t;}));},i.onerror=function(){return e(new Error(\"Could not load image. Please make sure to use a supported image type such as PNG or JPEG. Note that SVGs are not supported.\"))};var s=new o.Blob([new Uint8Array(t)],{type:\"image/png\"});i.cacheControl=r,i.expires=n,i.src=t.byteLength?a.createObjectURL(s):_t;}(r,e,n,a));}));return {cancel:function(){a.cancel(),i();}}};function St(t,e,r){r[t]&&-1!==r[t].indexOf(e)||(r[t]=r[t]||[],r[t].push(e));}function kt(t,e,r){if(r&&r[t]){var n=r[t].indexOf(e);-1!==n&&r[t].splice(n,1);}}var It=function(t,e){void 0===e&&(e={}),h(this,e),this.type=t;},zt=function(t){function e(e,r){void 0===r&&(r={}),t.call(this,\"error\",h({error:e},r));}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e}(It),Ct=function(){};Ct.prototype.on=function(t,e){return this._listeners=this._listeners||{},St(t,e,this._listeners),this},Ct.prototype.off=function(t,e){return kt(t,e,this._listeners),kt(t,e,this._oneTimeListeners),this},Ct.prototype.once=function(t,e){return this._oneTimeListeners=this._oneTimeListeners||{},St(t,e,this._oneTimeListeners),this},Ct.prototype.fire=function(t,e){\"string\"==typeof t&&(t=new It(t,e||{}));var r=t.type;if(this.listens(r)){t.target=this;for(var n=0,i=this._listeners&&this._listeners[r]?this._listeners[r].slice():[];n<i.length;n+=1)i[n].call(this,t);for(var a=0,o=this._oneTimeListeners&&this._oneTimeListeners[r]?this._oneTimeListeners[r].slice():[];a<o.length;a+=1){var s=o[a];kt(r,s,this._oneTimeListeners),s.call(this,t);}var u=this._eventedParent;u&&(h(t,\"function\"==typeof this._eventedParentData?this._eventedParentData():this._eventedParentData),u.fire(t));}else t instanceof zt&&console.error(t.error);return this},Ct.prototype.listens=function(t){return this._listeners&&this._listeners[t]&&this._listeners[t].length>0||this._oneTimeListeners&&this._oneTimeListeners[t]&&this._oneTimeListeners[t].length>0||this._eventedParent&&this._eventedParent.listens(t)},Ct.prototype.setEventedParent=function(t,e){return this._eventedParent=t,this._eventedParentData=e,this};var Et={$version:8,$root:{version:{required:!0,type:\"enum\",values:[8]},name:{type:\"string\"},metadata:{type:\"*\"},center:{type:\"array\",value:\"number\"},zoom:{type:\"number\"},bearing:{type:\"number\",default:0,period:360,units:\"degrees\"},pitch:{type:\"number\",default:0,units:\"degrees\"},light:{type:\"light\"},sources:{required:!0,type:\"sources\"},sprite:{type:\"string\"},glyphs:{type:\"string\"},transition:{type:\"transition\"},layers:{required:!0,type:\"array\",value:\"layer\"}},sources:{\"*\":{type:\"source\"}},source:[\"source_vector\",\"source_raster\",\"source_raster_dem\",\"source_geojson\",\"source_video\",\"source_image\"],source_vector:{type:{required:!0,type:\"enum\",values:{vector:{}}},url:{type:\"string\"},tiles:{type:\"array\",value:\"string\"},bounds:{type:\"array\",value:\"number\",length:4,default:[-180,-85.051129,180,85.051129]},scheme:{type:\"enum\",values:{xyz:{},tms:{}},default:\"xyz\"},minzoom:{type:\"number\",default:0},maxzoom:{type:\"number\",default:22},attribution:{type:\"string\"},promoteId:{type:\"promoteId\"},volatile:{type:\"boolean\",default:!1},\"*\":{type:\"*\"}},source_raster:{type:{required:!0,type:\"enum\",values:{raster:{}}},url:{type:\"string\"},tiles:{type:\"array\",value:\"string\"},bounds:{type:\"array\",value:\"number\",length:4,default:[-180,-85.051129,180,85.051129]},minzoom:{type:\"number\",default:0},maxzoom:{type:\"number\",default:22},tileSize:{type:\"number\",default:512,units:\"pixels\"},scheme:{type:\"enum\",values:{xyz:{},tms:{}},default:\"xyz\"},attribution:{type:\"string\"},volatile:{type:\"boolean\",default:!1},\"*\":{type:\"*\"}},source_raster_dem:{type:{required:!0,type:\"enum\",values:{\"raster-dem\":{}}},url:{type:\"string\"},tiles:{type:\"array\",value:\"string\"},bounds:{type:\"array\",value:\"number\",length:4,default:[-180,-85.051129,180,85.051129]},minzoom:{type:\"number\",default:0},maxzoom:{type:\"number\",default:22},tileSize:{type:\"number\",default:512,units:\"pixels\"},attribution:{type:\"string\"},encoding:{type:\"enum\",values:{terrarium:{},mapbox:{}},default:\"mapbox\"},volatile:{type:\"boolean\",default:!1},\"*\":{type:\"*\"}},source_geojson:{type:{required:!0,type:\"enum\",values:{geojson:{}}},data:{type:\"*\"},maxzoom:{type:\"number\",default:18},attribution:{type:\"string\"},buffer:{type:\"number\",default:128,maximum:512,minimum:0},filter:{type:\"*\"},tolerance:{type:\"number\",default:.375},cluster:{type:\"boolean\",default:!1},clusterRadius:{type:\"number\",default:50,minimum:0},clusterMaxZoom:{type:\"number\"},clusterMinPoints:{type:\"number\"},clusterProperties:{type:\"*\"},lineMetrics:{type:\"boolean\",default:!1},generateId:{type:\"boolean\",default:!1},promoteId:{type:\"promoteId\"}},source_video:{type:{required:!0,type:\"enum\",values:{video:{}}},urls:{required:!0,type:\"array\",value:\"string\"},coordinates:{required:!0,type:\"array\",length:4,value:{type:\"array\",length:2,value:\"number\"}}},source_image:{type:{required:!0,type:\"enum\",values:{image:{}}},url:{required:!0,type:\"string\"},coordinates:{required:!0,type:\"array\",length:4,value:{type:\"array\",length:2,value:\"number\"}}},layer:{id:{type:\"string\",required:!0},type:{type:\"enum\",values:{fill:{},line:{},symbol:{},circle:{},heatmap:{},\"fill-extrusion\":{},raster:{},hillshade:{},background:{}},required:!0},metadata:{type:\"*\"},source:{type:\"string\"},\"source-layer\":{type:\"string\"},minzoom:{type:\"number\",minimum:0,maximum:24},maxzoom:{type:\"number\",minimum:0,maximum:24},filter:{type:\"filter\"},layout:{type:\"layout\"},paint:{type:\"paint\"}},layout:[\"layout_fill\",\"layout_line\",\"layout_circle\",\"layout_heatmap\",\"layout_fill-extrusion\",\"layout_symbol\",\"layout_raster\",\"layout_hillshade\",\"layout_background\"],layout_background:{visibility:{type:\"enum\",values:{visible:{},none:{}},default:\"visible\",\"property-type\":\"constant\"}},layout_fill:{\"fill-sort-key\":{type:\"number\",expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},visibility:{type:\"enum\",values:{visible:{},none:{}},default:\"visible\",\"property-type\":\"constant\"}},layout_circle:{\"circle-sort-key\":{type:\"number\",expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},visibility:{type:\"enum\",values:{visible:{},none:{}},default:\"visible\",\"property-type\":\"constant\"}},layout_heatmap:{visibility:{type:\"enum\",values:{visible:{},none:{}},default:\"visible\",\"property-type\":\"constant\"}},\"layout_fill-extrusion\":{visibility:{type:\"enum\",values:{visible:{},none:{}},default:\"visible\",\"property-type\":\"constant\"}},layout_line:{\"line-cap\":{type:\"enum\",values:{butt:{},round:{},square:{}},default:\"butt\",expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"line-join\":{type:\"enum\",values:{bevel:{},round:{},miter:{}},default:\"miter\",expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"line-miter-limit\":{type:\"number\",default:2,requires:[{\"line-join\":\"miter\"}],expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"line-round-limit\":{type:\"number\",default:1.05,requires:[{\"line-join\":\"round\"}],expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"line-sort-key\":{type:\"number\",expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},visibility:{type:\"enum\",values:{visible:{},none:{}},default:\"visible\",\"property-type\":\"constant\"}},layout_symbol:{\"symbol-placement\":{type:\"enum\",values:{point:{},line:{},\"line-center\":{}},default:\"point\",expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"symbol-spacing\":{type:\"number\",default:250,minimum:1,units:\"pixels\",requires:[{\"symbol-placement\":\"line\"}],expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"symbol-avoid-edges\":{type:\"boolean\",default:!1,expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"symbol-sort-key\":{type:\"number\",expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"symbol-z-order\":{type:\"enum\",values:{auto:{},\"viewport-y\":{},source:{}},default:\"auto\",expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"icon-allow-overlap\":{type:\"boolean\",default:!1,requires:[\"icon-image\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"icon-ignore-placement\":{type:\"boolean\",default:!1,requires:[\"icon-image\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"icon-optional\":{type:\"boolean\",default:!1,requires:[\"icon-image\",\"text-field\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"icon-rotation-alignment\":{type:\"enum\",values:{map:{},viewport:{},auto:{}},default:\"auto\",requires:[\"icon-image\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"icon-size\":{type:\"number\",default:1,minimum:0,units:\"factor of the original icon size\",requires:[\"icon-image\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"icon-text-fit\":{type:\"enum\",values:{none:{},width:{},height:{},both:{}},default:\"none\",requires:[\"icon-image\",\"text-field\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"icon-text-fit-padding\":{type:\"array\",value:\"number\",length:4,default:[0,0,0,0],units:\"pixels\",requires:[\"icon-image\",\"text-field\",{\"icon-text-fit\":[\"both\",\"width\",\"height\"]}],expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"icon-image\":{type:\"resolvedImage\",tokens:!0,expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"icon-rotate\":{type:\"number\",default:0,period:360,units:\"degrees\",requires:[\"icon-image\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"icon-padding\":{type:\"number\",default:2,minimum:0,units:\"pixels\",requires:[\"icon-image\"],expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"icon-keep-upright\":{type:\"boolean\",default:!1,requires:[\"icon-image\",{\"icon-rotation-alignment\":\"map\"},{\"symbol-placement\":[\"line\",\"line-center\"]}],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"icon-offset\":{type:\"array\",value:\"number\",length:2,default:[0,0],requires:[\"icon-image\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"icon-anchor\":{type:\"enum\",values:{center:{},left:{},right:{},top:{},bottom:{},\"top-left\":{},\"top-right\":{},\"bottom-left\":{},\"bottom-right\":{}},default:\"center\",requires:[\"icon-image\"],expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"icon-pitch-alignment\":{type:\"enum\",values:{map:{},viewport:{},auto:{}},default:\"auto\",requires:[\"icon-image\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"text-pitch-alignment\":{type:\"enum\",values:{map:{},viewport:{},auto:{}},default:\"auto\",requires:[\"text-field\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"text-rotation-alignment\":{type:\"enum\",values:{map:{},viewport:{},auto:{}},default:\"auto\",requires:[\"text-field\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"text-field\":{type:\"formatted\",default:\"\",tokens:!0,expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"text-font\":{type:\"array\",value:\"string\",default:[\"Open Sans Regular\",\"Arial Unicode MS Regular\"],requires:[\"text-field\"],expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"text-size\":{type:\"number\",default:16,minimum:0,units:\"pixels\",requires:[\"text-field\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"text-max-width\":{type:\"number\",default:10,minimum:0,units:\"ems\",requires:[\"text-field\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"text-line-height\":{type:\"number\",default:1.2,units:\"ems\",requires:[\"text-field\"],expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"text-letter-spacing\":{type:\"number\",default:0,units:\"ems\",requires:[\"text-field\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"text-justify\":{type:\"enum\",values:{auto:{},left:{},center:{},right:{}},default:\"center\",requires:[\"text-field\"],expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"text-radial-offset\":{type:\"number\",units:\"ems\",default:0,requires:[\"text-field\"],\"property-type\":\"data-driven\",expression:{interpolated:!0,parameters:[\"zoom\",\"feature\"]}},\"text-variable-anchor\":{type:\"array\",value:\"enum\",values:{center:{},left:{},right:{},top:{},bottom:{},\"top-left\":{},\"top-right\":{},\"bottom-left\":{},\"bottom-right\":{}},requires:[\"text-field\",{\"symbol-placement\":[\"point\"]}],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"text-anchor\":{type:\"enum\",values:{center:{},left:{},right:{},top:{},bottom:{},\"top-left\":{},\"top-right\":{},\"bottom-left\":{},\"bottom-right\":{}},default:\"center\",requires:[\"text-field\",{\"!\":\"text-variable-anchor\"}],expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"text-max-angle\":{type:\"number\",default:45,units:\"degrees\",requires:[\"text-field\",{\"symbol-placement\":[\"line\",\"line-center\"]}],expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"text-writing-mode\":{type:\"array\",value:\"enum\",values:{horizontal:{},vertical:{}},requires:[\"text-field\",{\"symbol-placement\":[\"point\"]}],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"text-rotate\":{type:\"number\",default:0,period:360,units:\"degrees\",requires:[\"text-field\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"text-padding\":{type:\"number\",default:2,minimum:0,units:\"pixels\",requires:[\"text-field\"],expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"text-keep-upright\":{type:\"boolean\",default:!0,requires:[\"text-field\",{\"text-rotation-alignment\":\"map\"},{\"symbol-placement\":[\"line\",\"line-center\"]}],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"text-transform\":{type:\"enum\",values:{none:{},uppercase:{},lowercase:{}},default:\"none\",requires:[\"text-field\"],expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"text-offset\":{type:\"array\",value:\"number\",units:\"ems\",length:2,default:[0,0],requires:[\"text-field\",{\"!\":\"text-radial-offset\"}],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"data-driven\"},\"text-allow-overlap\":{type:\"boolean\",default:!1,requires:[\"text-field\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"text-ignore-placement\":{type:\"boolean\",default:!1,requires:[\"text-field\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"text-optional\":{type:\"boolean\",default:!1,requires:[\"text-field\",\"icon-image\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},visibility:{type:\"enum\",values:{visible:{},none:{}},default:\"visible\",\"property-type\":\"constant\"}},layout_raster:{visibility:{type:\"enum\",values:{visible:{},none:{}},default:\"visible\",\"property-type\":\"constant\"}},layout_hillshade:{visibility:{type:\"enum\",values:{visible:{},none:{}},default:\"visible\",\"property-type\":\"constant\"}},filter:{type:\"array\",value:\"*\"},filter_operator:{type:\"enum\",values:{\"==\":{},\"!=\":{},\">\":{},\">=\":{},\"<\":{},\"<=\":{},in:{},\"!in\":{},all:{},any:{},none:{},has:{},\"!has\":{},within:{}}},geometry_type:{type:\"enum\",values:{Point:{},LineString:{},Polygon:{}}},function:{expression:{type:\"expression\"},stops:{type:\"array\",value:\"function_stop\"},base:{type:\"number\",default:1,minimum:0},property:{type:\"string\",default:\"$zoom\"},type:{type:\"enum\",values:{identity:{},exponential:{},interval:{},categorical:{}},default:\"exponential\"},colorSpace:{type:\"enum\",values:{rgb:{},lab:{},hcl:{}},default:\"rgb\"},default:{type:\"*\",required:!1}},function_stop:{type:\"array\",minimum:0,maximum:24,value:[\"number\",\"color\"],length:2},expression:{type:\"array\",value:\"*\",minimum:1},light:{anchor:{type:\"enum\",default:\"viewport\",values:{map:{},viewport:{}},\"property-type\":\"data-constant\",transition:!1,expression:{interpolated:!1,parameters:[\"zoom\"]}},position:{type:\"array\",default:[1.15,210,30],length:3,value:\"number\",\"property-type\":\"data-constant\",transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]}},color:{type:\"color\",\"property-type\":\"data-constant\",default:\"#ffffff\",expression:{interpolated:!0,parameters:[\"zoom\"]},transition:!0},intensity:{type:\"number\",\"property-type\":\"data-constant\",default:.5,minimum:0,maximum:1,expression:{interpolated:!0,parameters:[\"zoom\"]},transition:!0}},paint:[\"paint_fill\",\"paint_line\",\"paint_circle\",\"paint_heatmap\",\"paint_fill-extrusion\",\"paint_symbol\",\"paint_raster\",\"paint_hillshade\",\"paint_background\"],paint_fill:{\"fill-antialias\":{type:\"boolean\",default:!0,expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"fill-opacity\":{type:\"number\",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"fill-color\":{type:\"color\",default:\"#000000\",transition:!0,requires:[{\"!\":\"fill-pattern\"}],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"fill-outline-color\":{type:\"color\",transition:!0,requires:[{\"!\":\"fill-pattern\"},{\"fill-antialias\":!0}],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"fill-translate\":{type:\"array\",value:\"number\",length:2,default:[0,0],transition:!0,units:\"pixels\",expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"fill-translate-anchor\":{type:\"enum\",values:{map:{},viewport:{}},default:\"map\",requires:[\"fill-translate\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"fill-pattern\":{type:\"resolvedImage\",transition:!0,expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"cross-faded-data-driven\"}},\"paint_fill-extrusion\":{\"fill-extrusion-opacity\":{type:\"number\",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"fill-extrusion-color\":{type:\"color\",default:\"#000000\",transition:!0,requires:[{\"!\":\"fill-extrusion-pattern\"}],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"fill-extrusion-translate\":{type:\"array\",value:\"number\",length:2,default:[0,0],transition:!0,units:\"pixels\",expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"fill-extrusion-translate-anchor\":{type:\"enum\",values:{map:{},viewport:{}},default:\"map\",requires:[\"fill-extrusion-translate\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"fill-extrusion-pattern\":{type:\"resolvedImage\",transition:!0,expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"cross-faded-data-driven\"},\"fill-extrusion-height\":{type:\"number\",default:0,minimum:0,units:\"meters\",transition:!0,expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"fill-extrusion-base\":{type:\"number\",default:0,minimum:0,units:\"meters\",transition:!0,requires:[\"fill-extrusion-height\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"fill-extrusion-vertical-gradient\":{type:\"boolean\",default:!0,transition:!1,expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"}},paint_line:{\"line-opacity\":{type:\"number\",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"line-color\":{type:\"color\",default:\"#000000\",transition:!0,requires:[{\"!\":\"line-pattern\"}],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"line-translate\":{type:\"array\",value:\"number\",length:2,default:[0,0],transition:!0,units:\"pixels\",expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"line-translate-anchor\":{type:\"enum\",values:{map:{},viewport:{}},default:\"map\",requires:[\"line-translate\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"line-width\":{type:\"number\",default:1,minimum:0,transition:!0,units:\"pixels\",expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"line-gap-width\":{type:\"number\",default:0,minimum:0,transition:!0,units:\"pixels\",expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"line-offset\":{type:\"number\",default:0,transition:!0,units:\"pixels\",expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"line-blur\":{type:\"number\",default:0,minimum:0,transition:!0,units:\"pixels\",expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"line-dasharray\":{type:\"array\",value:\"number\",minimum:0,transition:!0,units:\"line widths\",requires:[{\"!\":\"line-pattern\"}],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"cross-faded\"},\"line-pattern\":{type:\"resolvedImage\",transition:!0,expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]},\"property-type\":\"cross-faded-data-driven\"},\"line-gradient\":{type:\"color\",transition:!1,requires:[{\"!\":\"line-dasharray\"},{\"!\":\"line-pattern\"},{source:\"geojson\",has:{lineMetrics:!0}}],expression:{interpolated:!0,parameters:[\"line-progress\"]},\"property-type\":\"color-ramp\"}},paint_circle:{\"circle-radius\":{type:\"number\",default:5,minimum:0,transition:!0,units:\"pixels\",expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"circle-color\":{type:\"color\",default:\"#000000\",transition:!0,expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"circle-blur\":{type:\"number\",default:0,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"circle-opacity\":{type:\"number\",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"circle-translate\":{type:\"array\",value:\"number\",length:2,default:[0,0],transition:!0,units:\"pixels\",expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"circle-translate-anchor\":{type:\"enum\",values:{map:{},viewport:{}},default:\"map\",requires:[\"circle-translate\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"circle-pitch-scale\":{type:\"enum\",values:{map:{},viewport:{}},default:\"map\",expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"circle-pitch-alignment\":{type:\"enum\",values:{map:{},viewport:{}},default:\"viewport\",expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"circle-stroke-width\":{type:\"number\",default:0,minimum:0,transition:!0,units:\"pixels\",expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"circle-stroke-color\":{type:\"color\",default:\"#000000\",transition:!0,expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"circle-stroke-opacity\":{type:\"number\",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"}},paint_heatmap:{\"heatmap-radius\":{type:\"number\",default:30,minimum:1,transition:!0,units:\"pixels\",expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"heatmap-weight\":{type:\"number\",default:1,minimum:0,transition:!1,expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"heatmap-intensity\":{type:\"number\",default:1,minimum:0,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"heatmap-color\":{type:\"color\",default:[\"interpolate\",[\"linear\"],[\"heatmap-density\"],0,\"rgba(0, 0, 255, 0)\",.1,\"royalblue\",.3,\"cyan\",.5,\"lime\",.7,\"yellow\",1,\"red\"],transition:!1,expression:{interpolated:!0,parameters:[\"heatmap-density\"]},\"property-type\":\"color-ramp\"},\"heatmap-opacity\":{type:\"number\",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"}},paint_symbol:{\"icon-opacity\":{type:\"number\",default:1,minimum:0,maximum:1,transition:!0,requires:[\"icon-image\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"icon-color\":{type:\"color\",default:\"#000000\",transition:!0,requires:[\"icon-image\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"icon-halo-color\":{type:\"color\",default:\"rgba(0, 0, 0, 0)\",transition:!0,requires:[\"icon-image\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"icon-halo-width\":{type:\"number\",default:0,minimum:0,transition:!0,units:\"pixels\",requires:[\"icon-image\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"icon-halo-blur\":{type:\"number\",default:0,minimum:0,transition:!0,units:\"pixels\",requires:[\"icon-image\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"icon-translate\":{type:\"array\",value:\"number\",length:2,default:[0,0],transition:!0,units:\"pixels\",requires:[\"icon-image\"],expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"icon-translate-anchor\":{type:\"enum\",values:{map:{},viewport:{}},default:\"map\",requires:[\"icon-image\",\"icon-translate\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"text-opacity\":{type:\"number\",default:1,minimum:0,maximum:1,transition:!0,requires:[\"text-field\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"text-color\":{type:\"color\",default:\"#000000\",transition:!0,overridable:!0,requires:[\"text-field\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"text-halo-color\":{type:\"color\",default:\"rgba(0, 0, 0, 0)\",transition:!0,requires:[\"text-field\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"text-halo-width\":{type:\"number\",default:0,minimum:0,transition:!0,units:\"pixels\",requires:[\"text-field\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"text-halo-blur\":{type:\"number\",default:0,minimum:0,transition:!0,units:\"pixels\",requires:[\"text-field\"],expression:{interpolated:!0,parameters:[\"zoom\",\"feature\",\"feature-state\"]},\"property-type\":\"data-driven\"},\"text-translate\":{type:\"array\",value:\"number\",length:2,default:[0,0],transition:!0,units:\"pixels\",requires:[\"text-field\"],expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"text-translate-anchor\":{type:\"enum\",values:{map:{},viewport:{}},default:\"map\",requires:[\"text-field\",\"text-translate\"],expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"}},paint_raster:{\"raster-opacity\":{type:\"number\",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"raster-hue-rotate\":{type:\"number\",default:0,period:360,transition:!0,units:\"degrees\",expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"raster-brightness-min\":{type:\"number\",default:0,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"raster-brightness-max\":{type:\"number\",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"raster-saturation\":{type:\"number\",default:0,minimum:-1,maximum:1,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"raster-contrast\":{type:\"number\",default:0,minimum:-1,maximum:1,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"raster-resampling\":{type:\"enum\",values:{linear:{},nearest:{}},default:\"linear\",expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"raster-fade-duration\":{type:\"number\",default:300,minimum:0,transition:!1,units:\"milliseconds\",expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"}},paint_hillshade:{\"hillshade-illumination-direction\":{type:\"number\",default:335,minimum:0,maximum:359,transition:!1,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"hillshade-illumination-anchor\":{type:\"enum\",values:{map:{},viewport:{}},default:\"viewport\",expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"hillshade-exaggeration\":{type:\"number\",default:.5,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"hillshade-shadow-color\":{type:\"color\",default:\"#000000\",transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"hillshade-highlight-color\":{type:\"color\",default:\"#FFFFFF\",transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"hillshade-accent-color\":{type:\"color\",default:\"#000000\",transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"}},paint_background:{\"background-color\":{type:\"color\",default:\"#000000\",transition:!0,requires:[{\"!\":\"background-pattern\"}],expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"},\"background-pattern\":{type:\"resolvedImage\",transition:!0,expression:{interpolated:!1,parameters:[\"zoom\"]},\"property-type\":\"cross-faded\"},\"background-opacity\":{type:\"number\",default:1,minimum:0,maximum:1,transition:!0,expression:{interpolated:!0,parameters:[\"zoom\"]},\"property-type\":\"data-constant\"}},transition:{duration:{type:\"number\",default:300,minimum:0,units:\"milliseconds\"},delay:{type:\"number\",default:0,minimum:0,units:\"milliseconds\"}},\"property-type\":{\"data-driven\":{type:\"property-type\"},\"cross-faded\":{type:\"property-type\"},\"cross-faded-data-driven\":{type:\"property-type\"},\"color-ramp\":{type:\"property-type\"},\"data-constant\":{type:\"property-type\"},constant:{type:\"property-type\"}},promoteId:{\"*\":{type:\"string\"}}},Pt=function(t,e,r,n){this.message=(t?t+\": \":\"\")+r,n&&(this.identifier=n),null!=e&&e.__line__&&(this.line=e.__line__);};function Mt(t){var e=t.value;return e?[new Pt(t.key,e,\"constants have been deprecated as of v8\")]:[]}function Bt(t){for(var e=[],r=arguments.length-1;r-- >0;)e[r]=arguments[r+1];for(var n=0,i=e;n<i.length;n+=1){var a=i[n];for(var o in a)t[o]=a[o];}return t}function Tt(t){return t instanceof Number||t instanceof String||t instanceof Boolean?t.valueOf():t}function Vt(t){if(Array.isArray(t))return t.map(Vt);if(t instanceof Object&&!(t instanceof Number||t instanceof String||t instanceof Boolean)){var e={};for(var r in t)e[r]=Vt(t[r]);return e}return Tt(t)}var Ft=function(t){function e(e,r){t.call(this,r),this.message=r,this.key=e;}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e}(Error),Dt=function(t,e){void 0===e&&(e=[]),this.parent=t,this.bindings={};for(var r=0,n=e;r<n.length;r+=1){var i=n[r];this.bindings[i[0]]=i[1];}};Dt.prototype.concat=function(t){return new Dt(this,t)},Dt.prototype.get=function(t){if(this.bindings[t])return this.bindings[t];if(this.parent)return this.parent.get(t);throw new Error(t+\" not found in scope.\")},Dt.prototype.has=function(t){return !!this.bindings[t]||!!this.parent&&this.parent.has(t)};var Lt={kind:\"null\"},Ot={kind:\"number\"},Rt={kind:\"string\"},Ut={kind:\"boolean\"},jt={kind:\"color\"},qt={kind:\"object\"},Nt={kind:\"value\"},Kt={kind:\"collator\"},Gt={kind:\"formatted\"},Zt={kind:\"resolvedImage\"};function Xt(t,e){return {kind:\"array\",itemType:t,N:e}}function Jt(t){if(\"array\"===t.kind){var e=Jt(t.itemType);return \"number\"==typeof t.N?\"array<\"+e+\", \"+t.N+\">\":\"value\"===t.itemType.kind?\"array\":\"array<\"+e+\">\"}return t.kind}var Ht=[Lt,Ot,Rt,Ut,jt,Gt,qt,Xt(Nt),Zt];function Yt(t,e){if(\"error\"===e.kind)return null;if(\"array\"===t.kind){if(\"array\"===e.kind&&(0===e.N&&\"value\"===e.itemType.kind||!Yt(t.itemType,e.itemType))&&(\"number\"!=typeof t.N||t.N===e.N))return null}else {if(t.kind===e.kind)return null;if(\"value\"===t.kind)for(var r=0,n=Ht;r<n.length;r+=1)if(!Yt(n[r],e))return null}return \"Expected \"+Jt(t)+\" but found \"+Jt(e)+\" instead.\"}function $t(t,e){return e.some((function(e){return e.kind===t.kind}))}function Wt(t,e){return e.some((function(e){return \"null\"===e?null===t:\"array\"===e?Array.isArray(t):\"object\"===e?t&&!Array.isArray(t)&&\"object\"==typeof t:e===typeof t}))}var Qt=e((function(t,e){var r={transparent:[0,0,0,0],aliceblue:[240,248,255,1],antiquewhite:[250,235,215,1],aqua:[0,255,255,1],aquamarine:[127,255,212,1],azure:[240,255,255,1],beige:[245,245,220,1],bisque:[255,228,196,1],black:[0,0,0,1],blanchedalmond:[255,235,205,1],blue:[0,0,255,1],blueviolet:[138,43,226,1],brown:[165,42,42,1],burlywood:[222,184,135,1],cadetblue:[95,158,160,1],chartreuse:[127,255,0,1],chocolate:[210,105,30,1],coral:[255,127,80,1],cornflowerblue:[100,149,237,1],cornsilk:[255,248,220,1],crimson:[220,20,60,1],cyan:[0,255,255,1],darkblue:[0,0,139,1],darkcyan:[0,139,139,1],darkgoldenrod:[184,134,11,1],darkgray:[169,169,169,1],darkgreen:[0,100,0,1],darkgrey:[169,169,169,1],darkkhaki:[189,183,107,1],darkmagenta:[139,0,139,1],darkolivegreen:[85,107,47,1],darkorange:[255,140,0,1],darkorchid:[153,50,204,1],darkred:[139,0,0,1],darksalmon:[233,150,122,1],darkseagreen:[143,188,143,1],darkslateblue:[72,61,139,1],darkslategray:[47,79,79,1],darkslategrey:[47,79,79,1],darkturquoise:[0,206,209,1],darkviolet:[148,0,211,1],deeppink:[255,20,147,1],deepskyblue:[0,191,255,1],dimgray:[105,105,105,1],dimgrey:[105,105,105,1],dodgerblue:[30,144,255,1],firebrick:[178,34,34,1],floralwhite:[255,250,240,1],forestgreen:[34,139,34,1],fuchsia:[255,0,255,1],gainsboro:[220,220,220,1],ghostwhite:[248,248,255,1],gold:[255,215,0,1],goldenrod:[218,165,32,1],gray:[128,128,128,1],green:[0,128,0,1],greenyellow:[173,255,47,1],grey:[128,128,128,1],honeydew:[240,255,240,1],hotpink:[255,105,180,1],indianred:[205,92,92,1],indigo:[75,0,130,1],ivory:[255,255,240,1],khaki:[240,230,140,1],lavender:[230,230,250,1],lavenderblush:[255,240,245,1],lawngreen:[124,252,0,1],lemonchiffon:[255,250,205,1],lightblue:[173,216,230,1],lightcoral:[240,128,128,1],lightcyan:[224,255,255,1],lightgoldenrodyellow:[250,250,210,1],lightgray:[211,211,211,1],lightgreen:[144,238,144,1],lightgrey:[211,211,211,1],lightpink:[255,182,193,1],lightsalmon:[255,160,122,1],lightseagreen:[32,178,170,1],lightskyblue:[135,206,250,1],lightslategray:[119,136,153,1],lightslategrey:[119,136,153,1],lightsteelblue:[176,196,222,1],lightyellow:[255,255,224,1],lime:[0,255,0,1],limegreen:[50,205,50,1],linen:[250,240,230,1],magenta:[255,0,255,1],maroon:[128,0,0,1],mediumaquamarine:[102,205,170,1],mediumblue:[0,0,205,1],mediumorchid:[186,85,211,1],mediumpurple:[147,112,219,1],mediumseagreen:[60,179,113,1],mediumslateblue:[123,104,238,1],mediumspringgreen:[0,250,154,1],mediumturquoise:[72,209,204,1],mediumvioletred:[199,21,133,1],midnightblue:[25,25,112,1],mintcream:[245,255,250,1],mistyrose:[255,228,225,1],moccasin:[255,228,181,1],navajowhite:[255,222,173,1],navy:[0,0,128,1],oldlace:[253,245,230,1],olive:[128,128,0,1],olivedrab:[107,142,35,1],orange:[255,165,0,1],orangered:[255,69,0,1],orchid:[218,112,214,1],palegoldenrod:[238,232,170,1],palegreen:[152,251,152,1],paleturquoise:[175,238,238,1],palevioletred:[219,112,147,1],papayawhip:[255,239,213,1],peachpuff:[255,218,185,1],peru:[205,133,63,1],pink:[255,192,203,1],plum:[221,160,221,1],powderblue:[176,224,230,1],purple:[128,0,128,1],rebeccapurple:[102,51,153,1],red:[255,0,0,1],rosybrown:[188,143,143,1],royalblue:[65,105,225,1],saddlebrown:[139,69,19,1],salmon:[250,128,114,1],sandybrown:[244,164,96,1],seagreen:[46,139,87,1],seashell:[255,245,238,1],sienna:[160,82,45,1],silver:[192,192,192,1],skyblue:[135,206,235,1],slateblue:[106,90,205,1],slategray:[112,128,144,1],slategrey:[112,128,144,1],snow:[255,250,250,1],springgreen:[0,255,127,1],steelblue:[70,130,180,1],tan:[210,180,140,1],teal:[0,128,128,1],thistle:[216,191,216,1],tomato:[255,99,71,1],turquoise:[64,224,208,1],violet:[238,130,238,1],wheat:[245,222,179,1],white:[255,255,255,1],whitesmoke:[245,245,245,1],yellow:[255,255,0,1],yellowgreen:[154,205,50,1]};function n(t){return (t=Math.round(t))<0?0:t>255?255:t}function i(t){return n(\"%\"===t[t.length-1]?parseFloat(t)/100*255:parseInt(t))}function a(t){return (e=\"%\"===t[t.length-1]?parseFloat(t)/100:parseFloat(t))<0?0:e>1?1:e;var e;}function o(t,e,r){return r<0?r+=1:r>1&&(r-=1),6*r<1?t+(e-t)*r*6:2*r<1?e:3*r<2?t+(e-t)*(2/3-r)*6:t}try{e.parseCSSColor=function(t){var e,s=t.replace(/ /g,\"\").toLowerCase();if(s in r)return r[s].slice();if(\"#\"===s[0])return 4===s.length?(e=parseInt(s.substr(1),16))>=0&&e<=4095?[(3840&e)>>4|(3840&e)>>8,240&e|(240&e)>>4,15&e|(15&e)<<4,1]:null:7===s.length&&(e=parseInt(s.substr(1),16))>=0&&e<=16777215?[(16711680&e)>>16,(65280&e)>>8,255&e,1]:null;var u=s.indexOf(\"(\"),l=s.indexOf(\")\");if(-1!==u&&l+1===s.length){var p=s.substr(0,u),c=s.substr(u+1,l-(u+1)).split(\",\"),h=1;switch(p){case\"rgba\":if(4!==c.length)return null;h=a(c.pop());case\"rgb\":return 3!==c.length?null:[i(c[0]),i(c[1]),i(c[2]),h];case\"hsla\":if(4!==c.length)return null;h=a(c.pop());case\"hsl\":if(3!==c.length)return null;var f=(parseFloat(c[0])%360+360)%360/360,y=a(c[1]),d=a(c[2]),m=d<=.5?d*(y+1):d+y-d*y,v=2*d-m;return [n(255*o(v,m,f+1/3)),n(255*o(v,m,f)),n(255*o(v,m,f-1/3)),h];default:return null}}return null};}catch(t){}})).parseCSSColor,te=function(t,e,r,n){void 0===n&&(n=1),this.r=t,this.g=e,this.b=r,this.a=n;};te.parse=function(t){if(t){if(t instanceof te)return t;if(\"string\"==typeof t){var e=Qt(t);if(e)return new te(e[0]/255*e[3],e[1]/255*e[3],e[2]/255*e[3],e[3])}}},te.prototype.toString=function(){var t=this.toArray(),e=t[1],r=t[2],n=t[3];return \"rgba(\"+Math.round(t[0])+\",\"+Math.round(e)+\",\"+Math.round(r)+\",\"+n+\")\"},te.prototype.toArray=function(){var t=this.a;return 0===t?[0,0,0,0]:[255*this.r/t,255*this.g/t,255*this.b/t,t]},te.black=new te(0,0,0,1),te.white=new te(1,1,1,1),te.transparent=new te(0,0,0,0),te.red=new te(1,0,0,1);var ee=function(t,e,r){this.sensitivity=t?e?\"variant\":\"case\":e?\"accent\":\"base\",this.locale=r,this.collator=new Intl.Collator(this.locale?this.locale:[],{sensitivity:this.sensitivity,usage:\"search\"});};ee.prototype.compare=function(t,e){return this.collator.compare(t,e)},ee.prototype.resolvedLocale=function(){return new Intl.Collator(this.locale?this.locale:[]).resolvedOptions().locale};var re=function(t,e,r,n,i){this.text=t,this.image=e,this.scale=r,this.fontStack=n,this.textColor=i;},ne=function(t){this.sections=t;};ne.fromString=function(t){return new ne([new re(t,null,null,null,null)])},ne.prototype.isEmpty=function(){return 0===this.sections.length||!this.sections.some((function(t){return 0!==t.text.length||t.image&&0!==t.image.name.length}))},ne.factory=function(t){return t instanceof ne?t:ne.fromString(t)},ne.prototype.toString=function(){return 0===this.sections.length?\"\":this.sections.map((function(t){return t.text})).join(\"\")},ne.prototype.serialize=function(){for(var t=[\"format\"],e=0,r=this.sections;e<r.length;e+=1){var n=r[e];if(n.image)t.push([\"image\",n.image.name]);else {t.push(n.text);var i={};n.fontStack&&(i[\"text-font\"]=[\"literal\",n.fontStack.split(\",\")]),n.scale&&(i[\"font-scale\"]=n.scale),n.textColor&&(i[\"text-color\"]=[\"rgba\"].concat(n.textColor.toArray())),t.push(i);}}return t};var ie=function(t){this.name=t.name,this.available=t.available;};function ae(t,e,r,n){return \"number\"==typeof t&&t>=0&&t<=255&&\"number\"==typeof e&&e>=0&&e<=255&&\"number\"==typeof r&&r>=0&&r<=255?void 0===n||\"number\"==typeof n&&n>=0&&n<=1?null:\"Invalid rgba value [\"+[t,e,r,n].join(\", \")+\"]: 'a' must be between 0 and 1.\":\"Invalid rgba value [\"+(\"number\"==typeof n?[t,e,r,n]:[t,e,r]).join(\", \")+\"]: 'r', 'g', and 'b' must be between 0 and 255.\"}function oe(t){if(null===t)return !0;if(\"string\"==typeof t)return !0;if(\"boolean\"==typeof t)return !0;if(\"number\"==typeof t)return !0;if(t instanceof te)return !0;if(t instanceof ee)return !0;if(t instanceof ne)return !0;if(t instanceof ie)return !0;if(Array.isArray(t)){for(var e=0,r=t;e<r.length;e+=1)if(!oe(r[e]))return !1;return !0}if(\"object\"==typeof t){for(var n in t)if(!oe(t[n]))return !1;return !0}return !1}function se(t){if(null===t)return Lt;if(\"string\"==typeof t)return Rt;if(\"boolean\"==typeof t)return Ut;if(\"number\"==typeof t)return Ot;if(t instanceof te)return jt;if(t instanceof ee)return Kt;if(t instanceof ne)return Gt;if(t instanceof ie)return Zt;if(Array.isArray(t)){for(var e,r=t.length,n=0,i=t;n<i.length;n+=1){var a=se(i[n]);if(e){if(e===a)continue;e=Nt;break}e=a;}return Xt(e||Nt,r)}return qt}function ue(t){var e=typeof t;return null===t?\"\":\"string\"===e||\"number\"===e||\"boolean\"===e?String(t):t instanceof te||t instanceof ne||t instanceof ie?t.toString():JSON.stringify(t)}ie.prototype.toString=function(){return this.name},ie.fromString=function(t){return t?new ie({name:t,available:!1}):null},ie.prototype.serialize=function(){return [\"image\",this.name]};var le=function(t,e){this.type=t,this.value=e;};le.parse=function(t,e){if(2!==t.length)return e.error(\"'literal' expression requires exactly one argument, but found \"+(t.length-1)+\" instead.\");if(!oe(t[1]))return e.error(\"invalid value\");var r=t[1],n=se(r),i=e.expectedType;return \"array\"!==n.kind||0!==n.N||!i||\"array\"!==i.kind||\"number\"==typeof i.N&&0!==i.N||(n=i),new le(n,r)},le.prototype.evaluate=function(){return this.value},le.prototype.eachChild=function(){},le.prototype.outputDefined=function(){return !0},le.prototype.serialize=function(){return \"array\"===this.type.kind||\"object\"===this.type.kind?[\"literal\",this.value]:this.value instanceof te?[\"rgba\"].concat(this.value.toArray()):this.value instanceof ne?this.value.serialize():this.value};var pe=function(t){this.name=\"ExpressionEvaluationError\",this.message=t;};pe.prototype.toJSON=function(){return this.message};var ce={string:Rt,number:Ot,boolean:Ut,object:qt},he=function(t,e){this.type=t,this.args=e;};he.parse=function(t,e){if(t.length<2)return e.error(\"Expected at least one argument.\");var r,n=1,i=t[0];if(\"array\"===i){var a,o;if(t.length>2){var s=t[1];if(\"string\"!=typeof s||!(s in ce)||\"object\"===s)return e.error('The item type argument of \"array\" must be one of string, number, boolean',1);a=ce[s],n++;}else a=Nt;if(t.length>3){if(null!==t[2]&&(\"number\"!=typeof t[2]||t[2]<0||t[2]!==Math.floor(t[2])))return e.error('The length argument to \"array\" must be a positive integer literal',2);o=t[2],n++;}r=Xt(a,o);}else r=ce[i];for(var u=[];n<t.length;n++){var l=e.parse(t[n],n,Nt);if(!l)return null;u.push(l);}return new he(r,u)},he.prototype.evaluate=function(t){for(var e=0;e<this.args.length;e++){var r=this.args[e].evaluate(t);if(!Yt(this.type,se(r)))return r;if(e===this.args.length-1)throw new pe(\"Expected value to be of type \"+Jt(this.type)+\", but found \"+Jt(se(r))+\" instead.\")}return null},he.prototype.eachChild=function(t){this.args.forEach(t);},he.prototype.outputDefined=function(){return this.args.every((function(t){return t.outputDefined()}))},he.prototype.serialize=function(){var t=this.type,e=[t.kind];if(\"array\"===t.kind){var r=t.itemType;if(\"string\"===r.kind||\"number\"===r.kind||\"boolean\"===r.kind){e.push(r.kind);var n=t.N;(\"number\"==typeof n||this.args.length>1)&&e.push(n);}}return e.concat(this.args.map((function(t){return t.serialize()})))};var fe=function(t){this.type=Gt,this.sections=t;};fe.parse=function(t,e){if(t.length<2)return e.error(\"Expected at least one argument.\");var r=t[1];if(!Array.isArray(r)&&\"object\"==typeof r)return e.error(\"First argument must be an image or text section.\");for(var n=[],i=!1,a=1;a<=t.length-1;++a){var o=t[a];if(i&&\"object\"==typeof o&&!Array.isArray(o)){i=!1;var s=null;if(o[\"font-scale\"]&&!(s=e.parse(o[\"font-scale\"],1,Ot)))return null;var u=null;if(o[\"text-font\"]&&!(u=e.parse(o[\"text-font\"],1,Xt(Rt))))return null;var l=null;if(o[\"text-color\"]&&!(l=e.parse(o[\"text-color\"],1,jt)))return null;var p=n[n.length-1];p.scale=s,p.font=u,p.textColor=l;}else {var c=e.parse(t[a],1,Nt);if(!c)return null;var h=c.type.kind;if(\"string\"!==h&&\"value\"!==h&&\"null\"!==h&&\"resolvedImage\"!==h)return e.error(\"Formatted text type must be 'string', 'value', 'image' or 'null'.\");i=!0,n.push({content:c,scale:null,font:null,textColor:null});}}return new fe(n)},fe.prototype.evaluate=function(t){return new ne(this.sections.map((function(e){var r=e.content.evaluate(t);return se(r)===Zt?new re(\"\",r,null,null,null):new re(ue(r),null,e.scale?e.scale.evaluate(t):null,e.font?e.font.evaluate(t).join(\",\"):null,e.textColor?e.textColor.evaluate(t):null)})))},fe.prototype.eachChild=function(t){for(var e=0,r=this.sections;e<r.length;e+=1){var n=r[e];t(n.content),n.scale&&t(n.scale),n.font&&t(n.font),n.textColor&&t(n.textColor);}},fe.prototype.outputDefined=function(){return !1},fe.prototype.serialize=function(){for(var t=[\"format\"],e=0,r=this.sections;e<r.length;e+=1){var n=r[e];t.push(n.content.serialize());var i={};n.scale&&(i[\"font-scale\"]=n.scale.serialize()),n.font&&(i[\"text-font\"]=n.font.serialize()),n.textColor&&(i[\"text-color\"]=n.textColor.serialize()),t.push(i);}return t};var ye=function(t){this.type=Zt,this.input=t;};ye.parse=function(t,e){if(2!==t.length)return e.error(\"Expected two arguments.\");var r=e.parse(t[1],1,Rt);return r?new ye(r):e.error(\"No image name provided.\")},ye.prototype.evaluate=function(t){var e=this.input.evaluate(t),r=ie.fromString(e);return r&&t.availableImages&&(r.available=t.availableImages.indexOf(e)>-1),r},ye.prototype.eachChild=function(t){t(this.input);},ye.prototype.outputDefined=function(){return !1},ye.prototype.serialize=function(){return [\"image\",this.input.serialize()]};var de={\"to-boolean\":Ut,\"to-color\":jt,\"to-number\":Ot,\"to-string\":Rt},me=function(t,e){this.type=t,this.args=e;};me.parse=function(t,e){if(t.length<2)return e.error(\"Expected at least one argument.\");var r=t[0];if((\"to-boolean\"===r||\"to-string\"===r)&&2!==t.length)return e.error(\"Expected one argument.\");for(var n=de[r],i=[],a=1;a<t.length;a++){var o=e.parse(t[a],a,Nt);if(!o)return null;i.push(o);}return new me(n,i)},me.prototype.evaluate=function(t){if(\"boolean\"===this.type.kind)return Boolean(this.args[0].evaluate(t));if(\"color\"===this.type.kind){for(var e,r,n=0,i=this.args;n<i.length;n+=1){if(r=null,(e=i[n].evaluate(t))instanceof te)return e;if(\"string\"==typeof e){var a=t.parseColor(e);if(a)return a}else if(Array.isArray(e)&&!(r=e.length<3||e.length>4?\"Invalid rbga value \"+JSON.stringify(e)+\": expected an array containing either three or four numeric values.\":ae(e[0],e[1],e[2],e[3])))return new te(e[0]/255,e[1]/255,e[2]/255,e[3])}throw new pe(r||\"Could not parse color from value '\"+(\"string\"==typeof e?e:String(JSON.stringify(e)))+\"'\")}if(\"number\"===this.type.kind){for(var o=null,s=0,u=this.args;s<u.length;s+=1){if(null===(o=u[s].evaluate(t)))return 0;var l=Number(o);if(!isNaN(l))return l}throw new pe(\"Could not convert \"+JSON.stringify(o)+\" to number.\")}return \"formatted\"===this.type.kind?ne.fromString(ue(this.args[0].evaluate(t))):\"resolvedImage\"===this.type.kind?ie.fromString(ue(this.args[0].evaluate(t))):ue(this.args[0].evaluate(t))},me.prototype.eachChild=function(t){this.args.forEach(t);},me.prototype.outputDefined=function(){return this.args.every((function(t){return t.outputDefined()}))},me.prototype.serialize=function(){if(\"formatted\"===this.type.kind)return new fe([{content:this.args[0],scale:null,font:null,textColor:null}]).serialize();if(\"resolvedImage\"===this.type.kind)return new ye(this.args[0]).serialize();var t=[\"to-\"+this.type.kind];return this.eachChild((function(e){t.push(e.serialize());})),t};var ve=[\"Unknown\",\"Point\",\"LineString\",\"Polygon\"],ge=function(){this.globals=null,this.feature=null,this.featureState=null,this.formattedSection=null,this._parseColorCache={},this.availableImages=null,this.canonical=null;};ge.prototype.id=function(){return this.feature&&\"id\"in this.feature?this.feature.id:null},ge.prototype.geometryType=function(){return this.feature?\"number\"==typeof this.feature.type?ve[this.feature.type]:this.feature.type:null},ge.prototype.geometry=function(){return this.feature&&\"geometry\"in this.feature?this.feature.geometry:null},ge.prototype.canonicalID=function(){return this.canonical},ge.prototype.properties=function(){return this.feature&&this.feature.properties||{}},ge.prototype.parseColor=function(t){var e=this._parseColorCache[t];return e||(e=this._parseColorCache[t]=te.parse(t)),e};var xe=function(t,e,r,n){this.name=t,this.type=e,this._evaluate=r,this.args=n;};xe.prototype.evaluate=function(t){return this._evaluate(t,this.args)},xe.prototype.eachChild=function(t){this.args.forEach(t);},xe.prototype.outputDefined=function(){return !1},xe.prototype.serialize=function(){return [this.name].concat(this.args.map((function(t){return t.serialize()})))},xe.parse=function(t,e){var r,n=t[0],i=xe.definitions[n];if(!i)return e.error('Unknown expression \"'+n+'\". If you wanted a literal array, use [\"literal\", [...]].',0);for(var a=Array.isArray(i)?i[0]:i.type,o=Array.isArray(i)?[[i[1],i[2]]]:i.overloads,s=o.filter((function(e){var r=e[0];return !Array.isArray(r)||r.length===t.length-1})),u=null,l=0,p=s;l<p.length;l+=1){var c=p[l],h=c[0],f=c[1];u=new je(e.registry,e.path,null,e.scope);for(var y=[],d=!1,m=1;m<t.length;m++){var v=t[m],g=Array.isArray(h)?h[m-1]:h.type,x=u.parse(v,1+y.length,g);if(!x){d=!0;break}y.push(x);}if(!d)if(Array.isArray(h)&&h.length!==y.length)u.error(\"Expected \"+h.length+\" arguments, but found \"+y.length+\" instead.\");else {for(var b=0;b<y.length;b++){var w=Array.isArray(h)?h[b]:h.type,_=y[b];u.concat(b+1).checkSubtype(w,_.type);}if(0===u.errors.length)return new xe(n,a,f,y)}}if(1===s.length)(r=e.errors).push.apply(r,u.errors);else {for(var A=(s.length?s:o).map((function(t){var e;return e=t[0],Array.isArray(e)?\"(\"+e.map(Jt).join(\", \")+\")\":\"(\"+Jt(e.type)+\"...)\"})).join(\" | \"),S=[],k=1;k<t.length;k++){var I=e.parse(t[k],1+S.length);if(!I)return null;S.push(Jt(I.type));}e.error(\"Expected arguments of type \"+A+\", but found (\"+S.join(\", \")+\") instead.\");}return null},xe.register=function(t,e){for(var r in xe.definitions=e,e)t[r]=xe;};var be=function(t,e,r){this.type=Kt,this.locale=r,this.caseSensitive=t,this.diacriticSensitive=e;};function we(t,e){t[0]=Math.min(t[0],e[0]),t[1]=Math.min(t[1],e[1]),t[2]=Math.max(t[2],e[0]),t[3]=Math.max(t[3],e[1]);}function _e(t,e){return !(t[0]<=e[0]||t[2]>=e[2]||t[1]<=e[1]||t[3]>=e[3])}function Ae(t,e){var r=(180+t[0])/360,n=(180-180/Math.PI*Math.log(Math.tan(Math.PI/4+t[1]*Math.PI/360)))/360,i=Math.pow(2,e.z);return [Math.round(r*i*8192),Math.round(n*i*8192)]}function Se(t,e,r){return e[1]>t[1]!=r[1]>t[1]&&t[0]<(r[0]-e[0])*(t[1]-e[1])/(r[1]-e[1])+e[0]}function ke(t,e){for(var r,n,i,a,o,s,u,l=!1,p=0,c=e.length;p<c;p++)for(var h=e[p],f=0,y=h.length;f<y-1;f++){if((a=(r=t)[0]-(n=h[f])[0])*(u=r[1]-(i=h[f+1])[1])-(s=r[0]-i[0])*(o=r[1]-n[1])==0&&a*s<=0&&o*u<=0)return !1;Se(t,h[f],h[f+1])&&(l=!l);}return l}function Ie(t,e){for(var r=0;r<e.length;r++)if(ke(t,e[r]))return !0;return !1}function ze(t,e,r,n){var i=n[0]-r[0],a=n[1]-r[1],o=(t[0]-r[0])*a-i*(t[1]-r[1]),s=(e[0]-r[0])*a-i*(e[1]-r[1]);return o>0&&s<0||o<0&&s>0}function Ce(t,e,r){for(var n=0,i=r;n<i.length;n+=1)for(var a=i[n],o=0;o<a.length-1;++o)if(0!=(c=[(p=a[o+1])[0]-(l=a[o])[0],p[1]-l[1]])[0]*(h=[(u=e)[0]-(s=t)[0],u[1]-s[1]])[1]-c[1]*h[0]&&ze(s,u,l,p)&&ze(l,p,s,u))return !0;var s,u,l,p,c,h;return !1}function Ee(t,e){for(var r=0;r<t.length;++r)if(!ke(t[r],e))return !1;for(var n=0;n<t.length-1;++n)if(Ce(t[n],t[n+1],e))return !1;return !0}function Pe(t,e){for(var r=0;r<e.length;r++)if(Ee(t,e[r]))return !0;return !1}function Me(t,e,r){for(var n=[],i=0;i<t.length;i++){for(var a=[],o=0;o<t[i].length;o++){var s=Ae(t[i][o],r);we(e,s),a.push(s);}n.push(a);}return n}function Be(t,e,r){for(var n=[],i=0;i<t.length;i++){var a=Me(t[i],e,r);n.push(a);}return n}function Te(t,e,r,n){if(t[0]<r[0]||t[0]>r[2]){var i=.5*n,a=t[0]-r[0]>i?-n:r[0]-t[0]>i?n:0;0===a&&(a=t[0]-r[2]>i?-n:r[2]-t[0]>i?n:0),t[0]+=a;}we(e,t);}function Ve(t,e,r,n){for(var i=8192*Math.pow(2,n.z),a=[8192*n.x,8192*n.y],o=[],s=0,u=t;s<u.length;s+=1)for(var l=0,p=u[s];l<p.length;l+=1){var c=p[l],h=[c.x+a[0],c.y+a[1]];Te(h,e,r,i),o.push(h);}return o}function Fe(t,e,r,n){for(var i,a=8192*Math.pow(2,n.z),o=[8192*n.x,8192*n.y],s=[],u=0,l=t;u<l.length;u+=1){for(var p=[],c=0,h=l[u];c<h.length;c+=1){var f=h[c],y=[f.x+o[0],f.y+o[1]];we(e,y),p.push(y);}s.push(p);}if(e[2]-e[0]<=a/2){(i=e)[0]=i[1]=1/0,i[2]=i[3]=-1/0;for(var d=0,m=s;d<m.length;d+=1)for(var v=0,g=m[d];v<g.length;v+=1)Te(g[v],e,r,a);}return s}be.parse=function(t,e){if(2!==t.length)return e.error(\"Expected one argument.\");var r=t[1];if(\"object\"!=typeof r||Array.isArray(r))return e.error(\"Collator options argument must be an object.\");var n=e.parse(void 0!==r[\"case-sensitive\"]&&r[\"case-sensitive\"],1,Ut);if(!n)return null;var i=e.parse(void 0!==r[\"diacritic-sensitive\"]&&r[\"diacritic-sensitive\"],1,Ut);if(!i)return null;var a=null;return r.locale&&!(a=e.parse(r.locale,1,Rt))?null:new be(n,i,a)},be.prototype.evaluate=function(t){return new ee(this.caseSensitive.evaluate(t),this.diacriticSensitive.evaluate(t),this.locale?this.locale.evaluate(t):null)},be.prototype.eachChild=function(t){t(this.caseSensitive),t(this.diacriticSensitive),this.locale&&t(this.locale);},be.prototype.outputDefined=function(){return !1},be.prototype.serialize=function(){var t={};return t[\"case-sensitive\"]=this.caseSensitive.serialize(),t[\"diacritic-sensitive\"]=this.diacriticSensitive.serialize(),this.locale&&(t.locale=this.locale.serialize()),[\"collator\",t]};var De=function(t,e){this.type=Ut,this.geojson=t,this.geometries=e;};function Le(t){if(t instanceof xe){if(\"get\"===t.name&&1===t.args.length)return !1;if(\"feature-state\"===t.name)return !1;if(\"has\"===t.name&&1===t.args.length)return !1;if(\"properties\"===t.name||\"geometry-type\"===t.name||\"id\"===t.name)return !1;if(/^filter-/.test(t.name))return !1}if(t instanceof De)return !1;var e=!0;return t.eachChild((function(t){e&&!Le(t)&&(e=!1);})),e}function Oe(t){if(t instanceof xe&&\"feature-state\"===t.name)return !1;var e=!0;return t.eachChild((function(t){e&&!Oe(t)&&(e=!1);})),e}function Re(t,e){if(t instanceof xe&&e.indexOf(t.name)>=0)return !1;var r=!0;return t.eachChild((function(t){r&&!Re(t,e)&&(r=!1);})),r}De.parse=function(t,e){if(2!==t.length)return e.error(\"'within' expression requires exactly one argument, but found \"+(t.length-1)+\" instead.\");if(oe(t[1])){var r=t[1];if(\"FeatureCollection\"===r.type)for(var n=0;n<r.features.length;++n){var i=r.features[n].geometry.type;if(\"Polygon\"===i||\"MultiPolygon\"===i)return new De(r,r.features[n].geometry)}else if(\"Feature\"===r.type){var a=r.geometry.type;if(\"Polygon\"===a||\"MultiPolygon\"===a)return new De(r,r.geometry)}else if(\"Polygon\"===r.type||\"MultiPolygon\"===r.type)return new De(r,r)}return e.error(\"'within' expression requires valid geojson object that contains polygon geometry type.\")},De.prototype.evaluate=function(t){if(null!=t.geometry()&&null!=t.canonicalID()){if(\"Point\"===t.geometryType())return function(t,e){var r=[1/0,1/0,-1/0,-1/0],n=[1/0,1/0,-1/0,-1/0],i=t.canonicalID();if(\"Polygon\"===e.type){var a=Me(e.coordinates,n,i),o=Ve(t.geometry(),r,n,i);if(!_e(r,n))return !1;for(var s=0,u=o;s<u.length;s+=1)if(!ke(u[s],a))return !1}if(\"MultiPolygon\"===e.type){var l=Be(e.coordinates,n,i),p=Ve(t.geometry(),r,n,i);if(!_e(r,n))return !1;for(var c=0,h=p;c<h.length;c+=1)if(!Ie(h[c],l))return !1}return !0}(t,this.geometries);if(\"LineString\"===t.geometryType())return function(t,e){var r=[1/0,1/0,-1/0,-1/0],n=[1/0,1/0,-1/0,-1/0],i=t.canonicalID();if(\"Polygon\"===e.type){var a=Me(e.coordinates,n,i),o=Fe(t.geometry(),r,n,i);if(!_e(r,n))return !1;for(var s=0,u=o;s<u.length;s+=1)if(!Ee(u[s],a))return !1}if(\"MultiPolygon\"===e.type){var l=Be(e.coordinates,n,i),p=Fe(t.geometry(),r,n,i);if(!_e(r,n))return !1;for(var c=0,h=p;c<h.length;c+=1)if(!Pe(h[c],l))return !1}return !0}(t,this.geometries)}return !1},De.prototype.eachChild=function(){},De.prototype.outputDefined=function(){return !0},De.prototype.serialize=function(){return [\"within\",this.geojson]};var Ue=function(t,e){this.type=e.type,this.name=t,this.boundExpression=e;};Ue.parse=function(t,e){if(2!==t.length||\"string\"!=typeof t[1])return e.error(\"'var' expression requires exactly one string literal argument.\");var r=t[1];return e.scope.has(r)?new Ue(r,e.scope.get(r)):e.error('Unknown variable \"'+r+'\". Make sure \"'+r+'\" has been bound in an enclosing \"let\" expression before using it.',1)},Ue.prototype.evaluate=function(t){return this.boundExpression.evaluate(t)},Ue.prototype.eachChild=function(){},Ue.prototype.outputDefined=function(){return !1},Ue.prototype.serialize=function(){return [\"var\",this.name]};var je=function(t,e,r,n,i){void 0===e&&(e=[]),void 0===n&&(n=new Dt),void 0===i&&(i=[]),this.registry=t,this.path=e,this.key=e.map((function(t){return \"[\"+t+\"]\"})).join(\"\"),this.scope=n,this.errors=i,this.expectedType=r;};function qe(t,e){for(var r,n=t.length-1,i=0,a=n,o=0;i<=a;)if((r=t[o=Math.floor((i+a)/2)])<=e){if(o===n||e<t[o+1])return o;i=o+1;}else {if(!(r>e))throw new pe(\"Input is not a number.\");a=o-1;}return 0}je.prototype.parse=function(t,e,r,n,i){return void 0===i&&(i={}),e?this.concat(e,r,n)._parse(t,i):this._parse(t,i)},je.prototype._parse=function(t,e){function r(t,e,r){return \"assert\"===r?new he(e,[t]):\"coerce\"===r?new me(e,[t]):t}if(null!==t&&\"string\"!=typeof t&&\"boolean\"!=typeof t&&\"number\"!=typeof t||(t=[\"literal\",t]),Array.isArray(t)){if(0===t.length)return this.error('Expected an array with at least one element. If you wanted a literal array, use [\"literal\", []].');var n=t[0];if(\"string\"!=typeof n)return this.error(\"Expression name must be a string, but found \"+typeof n+' instead. If you wanted a literal array, use [\"literal\", [...]].',0),null;var i=this.registry[n];if(i){var a=i.parse(t,this);if(!a)return null;if(this.expectedType){var o=this.expectedType,s=a.type;if(\"string\"!==o.kind&&\"number\"!==o.kind&&\"boolean\"!==o.kind&&\"object\"!==o.kind&&\"array\"!==o.kind||\"value\"!==s.kind)if(\"color\"!==o.kind&&\"formatted\"!==o.kind&&\"resolvedImage\"!==o.kind||\"value\"!==s.kind&&\"string\"!==s.kind){if(this.checkSubtype(o,s))return null}else a=r(a,o,e.typeAnnotation||\"coerce\");else a=r(a,o,e.typeAnnotation||\"assert\");}if(!(a instanceof le)&&\"resolvedImage\"!==a.type.kind&&function t(e){if(e instanceof Ue)return t(e.boundExpression);if(e instanceof xe&&\"error\"===e.name)return !1;if(e instanceof be)return !1;if(e instanceof De)return !1;var r=e instanceof me||e instanceof he,n=!0;return e.eachChild((function(e){n=r?n&&t(e):n&&e instanceof le;})),!!n&&Le(e)&&Re(e,[\"zoom\",\"heatmap-density\",\"line-progress\",\"accumulated\",\"is-supported-script\"])}(a)){var u=new ge;try{a=new le(a.type,a.evaluate(u));}catch(t){return this.error(t.message),null}}return a}return this.error('Unknown expression \"'+n+'\". If you wanted a literal array, use [\"literal\", [...]].',0)}return this.error(void 0===t?\"'undefined' value invalid. Use null instead.\":\"object\"==typeof t?'Bare objects invalid. Use [\"literal\", {...}] instead.':\"Expected an array, but found \"+typeof t+\" instead.\")},je.prototype.concat=function(t,e,r){var n=\"number\"==typeof t?this.path.concat(t):this.path,i=r?this.scope.concat(r):this.scope;return new je(this.registry,n,e||null,i,this.errors)},je.prototype.error=function(t){for(var e=[],r=arguments.length-1;r-- >0;)e[r]=arguments[r+1];var n=\"\"+this.key+e.map((function(t){return \"[\"+t+\"]\"})).join(\"\");this.errors.push(new Ft(n,t));},je.prototype.checkSubtype=function(t,e){var r=Yt(t,e);return r&&this.error(r),r};var Ne=function(t,e,r){this.type=t,this.input=e,this.labels=[],this.outputs=[];for(var n=0,i=r;n<i.length;n+=1){var a=i[n],o=a[1];this.labels.push(a[0]),this.outputs.push(o);}};function Ke(t,e,r){return t*(1-r)+e*r}Ne.parse=function(t,e){if(t.length-1<4)return e.error(\"Expected at least 4 arguments, but found only \"+(t.length-1)+\".\");if((t.length-1)%2!=0)return e.error(\"Expected an even number of arguments.\");var r=e.parse(t[1],1,Ot);if(!r)return null;var n=[],i=null;e.expectedType&&\"value\"!==e.expectedType.kind&&(i=e.expectedType);for(var a=1;a<t.length;a+=2){var o=1===a?-1/0:t[a],s=t[a+1],u=a,l=a+1;if(\"number\"!=typeof o)return e.error('Input/output pairs for \"step\" expressions must be defined using literal numeric values (not computed expressions) for the input values.',u);if(n.length&&n[n.length-1][0]>=o)return e.error('Input/output pairs for \"step\" expressions must be arranged with input values in strictly ascending order.',u);var p=e.parse(s,l,i);if(!p)return null;i=i||p.type,n.push([o,p]);}return new Ne(i,r,n)},Ne.prototype.evaluate=function(t){var e=this.labels,r=this.outputs;if(1===e.length)return r[0].evaluate(t);var n=this.input.evaluate(t);if(n<=e[0])return r[0].evaluate(t);var i=e.length;return n>=e[i-1]?r[i-1].evaluate(t):r[qe(e,n)].evaluate(t)},Ne.prototype.eachChild=function(t){t(this.input);for(var e=0,r=this.outputs;e<r.length;e+=1)t(r[e]);},Ne.prototype.outputDefined=function(){return this.outputs.every((function(t){return t.outputDefined()}))},Ne.prototype.serialize=function(){for(var t=[\"step\",this.input.serialize()],e=0;e<this.labels.length;e++)e>0&&t.push(this.labels[e]),t.push(this.outputs[e].serialize());return t};var Ge=Object.freeze({__proto__:null,number:Ke,color:function(t,e,r){return new te(Ke(t.r,e.r,r),Ke(t.g,e.g,r),Ke(t.b,e.b,r),Ke(t.a,e.a,r))},array:function(t,e,r){return t.map((function(t,n){return Ke(t,e[n],r)}))}}),Ze=6/29*3*(6/29),Xe=Math.PI/180,Je=180/Math.PI;function He(t){return t>.008856451679035631?Math.pow(t,1/3):t/Ze+4/29}function Ye(t){return t>6/29?t*t*t:Ze*(t-4/29)}function $e(t){return 255*(t<=.0031308?12.92*t:1.055*Math.pow(t,1/2.4)-.055)}function We(t){return (t/=255)<=.04045?t/12.92:Math.pow((t+.055)/1.055,2.4)}function Qe(t){var e=We(t.r),r=We(t.g),n=We(t.b),i=He((.4124564*e+.3575761*r+.1804375*n)/.95047),a=He((.2126729*e+.7151522*r+.072175*n)/1);return {l:116*a-16,a:500*(i-a),b:200*(a-He((.0193339*e+.119192*r+.9503041*n)/1.08883)),alpha:t.a}}function tr(t){var e=(t.l+16)/116,r=isNaN(t.a)?e:e+t.a/500,n=isNaN(t.b)?e:e-t.b/200;return e=1*Ye(e),r=.95047*Ye(r),n=1.08883*Ye(n),new te($e(3.2404542*r-1.5371385*e-.4985314*n),$e(-.969266*r+1.8760108*e+.041556*n),$e(.0556434*r-.2040259*e+1.0572252*n),t.alpha)}function er(t,e,r){var n=e-t;return t+r*(n>180||n<-180?n-360*Math.round(n/360):n)}var rr={forward:Qe,reverse:tr,interpolate:function(t,e,r){return {l:Ke(t.l,e.l,r),a:Ke(t.a,e.a,r),b:Ke(t.b,e.b,r),alpha:Ke(t.alpha,e.alpha,r)}}},nr={forward:function(t){var e=Qe(t),r=e.l,n=e.a,i=e.b,a=Math.atan2(i,n)*Je;return {h:a<0?a+360:a,c:Math.sqrt(n*n+i*i),l:r,alpha:t.a}},reverse:function(t){var e=t.h*Xe,r=t.c;return tr({l:t.l,a:Math.cos(e)*r,b:Math.sin(e)*r,alpha:t.alpha})},interpolate:function(t,e,r){return {h:er(t.h,e.h,r),c:Ke(t.c,e.c,r),l:Ke(t.l,e.l,r),alpha:Ke(t.alpha,e.alpha,r)}}},ir=Object.freeze({__proto__:null,lab:rr,hcl:nr}),ar=function(t,e,r,n,i){this.type=t,this.operator=e,this.interpolation=r,this.input=n,this.labels=[],this.outputs=[];for(var a=0,o=i;a<o.length;a+=1){var s=o[a],u=s[1];this.labels.push(s[0]),this.outputs.push(u);}};function or(t,e,r,n){var i=n-r,a=t-r;return 0===i?0:1===e?a/i:(Math.pow(e,a)-1)/(Math.pow(e,i)-1)}ar.interpolationFactor=function(t,e,n,i){var a=0;if(\"exponential\"===t.name)a=or(e,t.base,n,i);else if(\"linear\"===t.name)a=or(e,1,n,i);else if(\"cubic-bezier\"===t.name){var o=t.controlPoints;a=new r(o[0],o[1],o[2],o[3]).solve(or(e,1,n,i));}return a},ar.parse=function(t,e){var r=t[0],n=t[1],i=t[2],a=t.slice(3);if(!Array.isArray(n)||0===n.length)return e.error(\"Expected an interpolation type expression.\",1);if(\"linear\"===n[0])n={name:\"linear\"};else if(\"exponential\"===n[0]){var o=n[1];if(\"number\"!=typeof o)return e.error(\"Exponential interpolation requires a numeric base.\",1,1);n={name:\"exponential\",base:o};}else {if(\"cubic-bezier\"!==n[0])return e.error(\"Unknown interpolation type \"+String(n[0]),1,0);var s=n.slice(1);if(4!==s.length||s.some((function(t){return \"number\"!=typeof t||t<0||t>1})))return e.error(\"Cubic bezier interpolation requires four numeric arguments with values between 0 and 1.\",1);n={name:\"cubic-bezier\",controlPoints:s};}if(t.length-1<4)return e.error(\"Expected at least 4 arguments, but found only \"+(t.length-1)+\".\");if((t.length-1)%2!=0)return e.error(\"Expected an even number of arguments.\");if(!(i=e.parse(i,2,Ot)))return null;var u=[],l=null;\"interpolate-hcl\"===r||\"interpolate-lab\"===r?l=jt:e.expectedType&&\"value\"!==e.expectedType.kind&&(l=e.expectedType);for(var p=0;p<a.length;p+=2){var c=a[p],h=a[p+1],f=p+3,y=p+4;if(\"number\"!=typeof c)return e.error('Input/output pairs for \"interpolate\" expressions must be defined using literal numeric values (not computed expressions) for the input values.',f);if(u.length&&u[u.length-1][0]>=c)return e.error('Input/output pairs for \"interpolate\" expressions must be arranged with input values in strictly ascending order.',f);var d=e.parse(h,y,l);if(!d)return null;l=l||d.type,u.push([c,d]);}return \"number\"===l.kind||\"color\"===l.kind||\"array\"===l.kind&&\"number\"===l.itemType.kind&&\"number\"==typeof l.N?new ar(l,r,n,i,u):e.error(\"Type \"+Jt(l)+\" is not interpolatable.\")},ar.prototype.evaluate=function(t){var e=this.labels,r=this.outputs;if(1===e.length)return r[0].evaluate(t);var n=this.input.evaluate(t);if(n<=e[0])return r[0].evaluate(t);var i=e.length;if(n>=e[i-1])return r[i-1].evaluate(t);var a=qe(e,n),o=ar.interpolationFactor(this.interpolation,n,e[a],e[a+1]),s=r[a].evaluate(t),u=r[a+1].evaluate(t);return \"interpolate\"===this.operator?Ge[this.type.kind.toLowerCase()](s,u,o):\"interpolate-hcl\"===this.operator?nr.reverse(nr.interpolate(nr.forward(s),nr.forward(u),o)):rr.reverse(rr.interpolate(rr.forward(s),rr.forward(u),o))},ar.prototype.eachChild=function(t){t(this.input);for(var e=0,r=this.outputs;e<r.length;e+=1)t(r[e]);},ar.prototype.outputDefined=function(){return this.outputs.every((function(t){return t.outputDefined()}))},ar.prototype.serialize=function(){var t;t=\"linear\"===this.interpolation.name?[\"linear\"]:\"exponential\"===this.interpolation.name?1===this.interpolation.base?[\"linear\"]:[\"exponential\",this.interpolation.base]:[\"cubic-bezier\"].concat(this.interpolation.controlPoints);for(var e=[this.operator,t,this.input.serialize()],r=0;r<this.labels.length;r++)e.push(this.labels[r],this.outputs[r].serialize());return e};var sr=function(t,e){this.type=t,this.args=e;};sr.parse=function(t,e){if(t.length<2)return e.error(\"Expectected at least one argument.\");var r=null,n=e.expectedType;n&&\"value\"!==n.kind&&(r=n);for(var i=[],a=0,o=t.slice(1);a<o.length;a+=1){var s=e.parse(o[a],1+i.length,r,void 0,{typeAnnotation:\"omit\"});if(!s)return null;r=r||s.type,i.push(s);}var u=n&&i.some((function(t){return Yt(n,t.type)}));return new sr(u?Nt:r,i)},sr.prototype.evaluate=function(t){for(var e,r=null,n=0,i=0,a=this.args;i<a.length&&(n++,(r=a[i].evaluate(t))&&r instanceof ie&&!r.available&&(e||(e=r.name),r=null,n===this.args.length&&(r=e)),null===r);i+=1);return r},sr.prototype.eachChild=function(t){this.args.forEach(t);},sr.prototype.outputDefined=function(){return this.args.every((function(t){return t.outputDefined()}))},sr.prototype.serialize=function(){var t=[\"coalesce\"];return this.eachChild((function(e){t.push(e.serialize());})),t};var ur=function(t,e){this.type=e.type,this.bindings=[].concat(t),this.result=e;};ur.prototype.evaluate=function(t){return this.result.evaluate(t)},ur.prototype.eachChild=function(t){for(var e=0,r=this.bindings;e<r.length;e+=1)t(r[e][1]);t(this.result);},ur.parse=function(t,e){if(t.length<4)return e.error(\"Expected at least 3 arguments, but found \"+(t.length-1)+\" instead.\");for(var r=[],n=1;n<t.length-1;n+=2){var i=t[n];if(\"string\"!=typeof i)return e.error(\"Expected string, but found \"+typeof i+\" instead.\",n);if(/[^a-zA-Z0-9_]/.test(i))return e.error(\"Variable names must contain only alphanumeric characters or '_'.\",n);var a=e.parse(t[n+1],n+1);if(!a)return null;r.push([i,a]);}var o=e.parse(t[t.length-1],t.length-1,e.expectedType,r);return o?new ur(r,o):null},ur.prototype.outputDefined=function(){return this.result.outputDefined()},ur.prototype.serialize=function(){for(var t=[\"let\"],e=0,r=this.bindings;e<r.length;e+=1){var n=r[e];t.push(n[0],n[1].serialize());}return t.push(this.result.serialize()),t};var lr=function(t,e,r){this.type=t,this.index=e,this.input=r;};lr.parse=function(t,e){if(3!==t.length)return e.error(\"Expected 2 arguments, but found \"+(t.length-1)+\" instead.\");var r=e.parse(t[1],1,Ot),n=e.parse(t[2],2,Xt(e.expectedType||Nt));return r&&n?new lr(n.type.itemType,r,n):null},lr.prototype.evaluate=function(t){var e=this.index.evaluate(t),r=this.input.evaluate(t);if(e<0)throw new pe(\"Array index out of bounds: \"+e+\" < 0.\");if(e>=r.length)throw new pe(\"Array index out of bounds: \"+e+\" > \"+(r.length-1)+\".\");if(e!==Math.floor(e))throw new pe(\"Array index must be an integer, but found \"+e+\" instead.\");return r[e]},lr.prototype.eachChild=function(t){t(this.index),t(this.input);},lr.prototype.outputDefined=function(){return !1},lr.prototype.serialize=function(){return [\"at\",this.index.serialize(),this.input.serialize()]};var pr=function(t,e){this.type=Ut,this.needle=t,this.haystack=e;};pr.parse=function(t,e){if(3!==t.length)return e.error(\"Expected 2 arguments, but found \"+(t.length-1)+\" instead.\");var r=e.parse(t[1],1,Nt),n=e.parse(t[2],2,Nt);return r&&n?$t(r.type,[Ut,Rt,Ot,Lt,Nt])?new pr(r,n):e.error(\"Expected first argument to be of type boolean, string, number or null, but found \"+Jt(r.type)+\" instead\"):null},pr.prototype.evaluate=function(t){var e=this.needle.evaluate(t),r=this.haystack.evaluate(t);if(!r)return !1;if(!Wt(e,[\"boolean\",\"string\",\"number\",\"null\"]))throw new pe(\"Expected first argument to be of type boolean, string, number or null, but found \"+Jt(se(e))+\" instead.\");if(!Wt(r,[\"string\",\"array\"]))throw new pe(\"Expected second argument to be of type array or string, but found \"+Jt(se(r))+\" instead.\");return r.indexOf(e)>=0},pr.prototype.eachChild=function(t){t(this.needle),t(this.haystack);},pr.prototype.outputDefined=function(){return !0},pr.prototype.serialize=function(){return [\"in\",this.needle.serialize(),this.haystack.serialize()]};var cr=function(t,e,r){this.type=Ot,this.needle=t,this.haystack=e,this.fromIndex=r;};cr.parse=function(t,e){if(t.length<=2||t.length>=5)return e.error(\"Expected 3 or 4 arguments, but found \"+(t.length-1)+\" instead.\");var r=e.parse(t[1],1,Nt),n=e.parse(t[2],2,Nt);if(!r||!n)return null;if(!$t(r.type,[Ut,Rt,Ot,Lt,Nt]))return e.error(\"Expected first argument to be of type boolean, string, number or null, but found \"+Jt(r.type)+\" instead\");if(4===t.length){var i=e.parse(t[3],3,Ot);return i?new cr(r,n,i):null}return new cr(r,n)},cr.prototype.evaluate=function(t){var e=this.needle.evaluate(t),r=this.haystack.evaluate(t);if(!Wt(e,[\"boolean\",\"string\",\"number\",\"null\"]))throw new pe(\"Expected first argument to be of type boolean, string, number or null, but found \"+Jt(se(e))+\" instead.\");if(!Wt(r,[\"string\",\"array\"]))throw new pe(\"Expected second argument to be of type array or string, but found \"+Jt(se(r))+\" instead.\");if(this.fromIndex){var n=this.fromIndex.evaluate(t);return r.indexOf(e,n)}return r.indexOf(e)},cr.prototype.eachChild=function(t){t(this.needle),t(this.haystack),this.fromIndex&&t(this.fromIndex);},cr.prototype.outputDefined=function(){return !1},cr.prototype.serialize=function(){if(null!=this.fromIndex&&void 0!==this.fromIndex){var t=this.fromIndex.serialize();return [\"index-of\",this.needle.serialize(),this.haystack.serialize(),t]}return [\"index-of\",this.needle.serialize(),this.haystack.serialize()]};var hr=function(t,e,r,n,i,a){this.inputType=t,this.type=e,this.input=r,this.cases=n,this.outputs=i,this.otherwise=a;};hr.parse=function(t,e){if(t.length<5)return e.error(\"Expected at least 4 arguments, but found only \"+(t.length-1)+\".\");if(t.length%2!=1)return e.error(\"Expected an even number of arguments.\");var r,n;e.expectedType&&\"value\"!==e.expectedType.kind&&(n=e.expectedType);for(var i={},a=[],o=2;o<t.length-1;o+=2){var s=t[o],u=t[o+1];Array.isArray(s)||(s=[s]);var l=e.concat(o);if(0===s.length)return l.error(\"Expected at least one branch label.\");for(var p=0,c=s;p<c.length;p+=1){var h=c[p];if(\"number\"!=typeof h&&\"string\"!=typeof h)return l.error(\"Branch labels must be numbers or strings.\");if(\"number\"==typeof h&&Math.abs(h)>Number.MAX_SAFE_INTEGER)return l.error(\"Branch labels must be integers no larger than \"+Number.MAX_SAFE_INTEGER+\".\");if(\"number\"==typeof h&&Math.floor(h)!==h)return l.error(\"Numeric branch labels must be integer values.\");if(r){if(l.checkSubtype(r,se(h)))return null}else r=se(h);if(void 0!==i[String(h)])return l.error(\"Branch labels must be unique.\");i[String(h)]=a.length;}var f=e.parse(u,o,n);if(!f)return null;n=n||f.type,a.push(f);}var y=e.parse(t[1],1,Nt);if(!y)return null;var d=e.parse(t[t.length-1],t.length-1,n);return d?\"value\"!==y.type.kind&&e.concat(1).checkSubtype(r,y.type)?null:new hr(r,n,y,i,a,d):null},hr.prototype.evaluate=function(t){var e=this.input.evaluate(t);return (se(e)===this.inputType&&this.outputs[this.cases[e]]||this.otherwise).evaluate(t)},hr.prototype.eachChild=function(t){t(this.input),this.outputs.forEach(t),t(this.otherwise);},hr.prototype.outputDefined=function(){return this.outputs.every((function(t){return t.outputDefined()}))&&this.otherwise.outputDefined()},hr.prototype.serialize=function(){for(var t=this,e=[\"match\",this.input.serialize()],r=[],n={},i=0,a=Object.keys(this.cases).sort();i<a.length;i+=1){var o=a[i];void 0===(c=n[this.cases[o]])?(n[this.cases[o]]=r.length,r.push([this.cases[o],[o]])):r[c][1].push(o);}for(var s=function(e){return \"number\"===t.inputType.kind?Number(e):e},u=0,l=r;u<l.length;u+=1){var p=l[u],c=p[0],h=p[1];e.push(1===h.length?s(h[0]):h.map(s)),e.push(this.outputs[outputIndex$1].serialize());}return e.push(this.otherwise.serialize()),e};var fr=function(t,e,r){this.type=t,this.branches=e,this.otherwise=r;};fr.parse=function(t,e){if(t.length<4)return e.error(\"Expected at least 3 arguments, but found only \"+(t.length-1)+\".\");if(t.length%2!=0)return e.error(\"Expected an odd number of arguments.\");var r;e.expectedType&&\"value\"!==e.expectedType.kind&&(r=e.expectedType);for(var n=[],i=1;i<t.length-1;i+=2){var a=e.parse(t[i],i,Ut);if(!a)return null;var o=e.parse(t[i+1],i+1,r);if(!o)return null;n.push([a,o]),r=r||o.type;}var s=e.parse(t[t.length-1],t.length-1,r);return s?new fr(r,n,s):null},fr.prototype.evaluate=function(t){for(var e=0,r=this.branches;e<r.length;e+=1){var n=r[e],i=n[1];if(n[0].evaluate(t))return i.evaluate(t)}return this.otherwise.evaluate(t)},fr.prototype.eachChild=function(t){for(var e=0,r=this.branches;e<r.length;e+=1){var n=r[e],i=n[1];t(n[0]),t(i);}t(this.otherwise);},fr.prototype.outputDefined=function(){return this.branches.every((function(t){return t[1].outputDefined()}))&&this.otherwise.outputDefined()},fr.prototype.serialize=function(){var t=[\"case\"];return this.eachChild((function(e){t.push(e.serialize());})),t};var yr=function(t,e,r,n){this.type=t,this.input=e,this.beginIndex=r,this.endIndex=n;};function dr(t,e){return \"==\"===t||\"!=\"===t?\"boolean\"===e.kind||\"string\"===e.kind||\"number\"===e.kind||\"null\"===e.kind||\"value\"===e.kind:\"string\"===e.kind||\"number\"===e.kind||\"value\"===e.kind}function mr(t,e,r,n){return 0===n.compare(e,r)}function vr(t,e,r){var n=\"==\"!==t&&\"!=\"!==t;return function(){function i(t,e,r){this.type=Ut,this.lhs=t,this.rhs=e,this.collator=r,this.hasUntypedArgument=\"value\"===t.type.kind||\"value\"===e.type.kind;}return i.parse=function(t,e){if(3!==t.length&&4!==t.length)return e.error(\"Expected two or three arguments.\");var r=t[0],a=e.parse(t[1],1,Nt);if(!a)return null;if(!dr(r,a.type))return e.concat(1).error('\"'+r+\"\\\" comparisons are not supported for type '\"+Jt(a.type)+\"'.\");var o=e.parse(t[2],2,Nt);if(!o)return null;if(!dr(r,o.type))return e.concat(2).error('\"'+r+\"\\\" comparisons are not supported for type '\"+Jt(o.type)+\"'.\");if(a.type.kind!==o.type.kind&&\"value\"!==a.type.kind&&\"value\"!==o.type.kind)return e.error(\"Cannot compare types '\"+Jt(a.type)+\"' and '\"+Jt(o.type)+\"'.\");n&&(\"value\"===a.type.kind&&\"value\"!==o.type.kind?a=new he(o.type,[a]):\"value\"!==a.type.kind&&\"value\"===o.type.kind&&(o=new he(a.type,[o])));var s=null;if(4===t.length){if(\"string\"!==a.type.kind&&\"string\"!==o.type.kind&&\"value\"!==a.type.kind&&\"value\"!==o.type.kind)return e.error(\"Cannot use collator to compare non-string types.\");if(!(s=e.parse(t[3],3,Kt)))return null}return new i(a,o,s)},i.prototype.evaluate=function(i){var a=this.lhs.evaluate(i),o=this.rhs.evaluate(i);if(n&&this.hasUntypedArgument){var s=se(a),u=se(o);if(s.kind!==u.kind||\"string\"!==s.kind&&\"number\"!==s.kind)throw new pe('Expected arguments for \"'+t+'\" to be (string, string) or (number, number), but found ('+s.kind+\", \"+u.kind+\") instead.\")}if(this.collator&&!n&&this.hasUntypedArgument){var l=se(a),p=se(o);if(\"string\"!==l.kind||\"string\"!==p.kind)return e(i,a,o)}return this.collator?r(i,a,o,this.collator.evaluate(i)):e(i,a,o)},i.prototype.eachChild=function(t){t(this.lhs),t(this.rhs),this.collator&&t(this.collator);},i.prototype.outputDefined=function(){return !0},i.prototype.serialize=function(){var e=[t];return this.eachChild((function(t){e.push(t.serialize());})),e},i}()}yr.parse=function(t,e){if(t.length<=2||t.length>=5)return e.error(\"Expected 3 or 4 arguments, but found \"+(t.length-1)+\" instead.\");var r=e.parse(t[1],1,Nt),n=e.parse(t[2],2,Ot);if(!r||!n)return null;if(!$t(r.type,[Xt(Nt),Rt,Nt]))return e.error(\"Expected first argument to be of type array or string, but found \"+Jt(r.type)+\" instead\");if(4===t.length){var i=e.parse(t[3],3,Ot);return i?new yr(r.type,r,n,i):null}return new yr(r.type,r,n)},yr.prototype.evaluate=function(t){var e=this.input.evaluate(t),r=this.beginIndex.evaluate(t);if(!Wt(e,[\"string\",\"array\"]))throw new pe(\"Expected first argument to be of type array or string, but found \"+Jt(se(e))+\" instead.\");if(this.endIndex){var n=this.endIndex.evaluate(t);return e.slice(r,n)}return e.slice(r)},yr.prototype.eachChild=function(t){t(this.input),t(this.beginIndex),this.endIndex&&t(this.endIndex);},yr.prototype.outputDefined=function(){return !1},yr.prototype.serialize=function(){if(null!=this.endIndex&&void 0!==this.endIndex){var t=this.endIndex.serialize();return [\"slice\",this.input.serialize(),this.beginIndex.serialize(),t]}return [\"slice\",this.input.serialize(),this.beginIndex.serialize()]};var gr=vr(\"==\",(function(t,e,r){return e===r}),mr),xr=vr(\"!=\",(function(t,e,r){return e!==r}),(function(t,e,r,n){return !mr(0,e,r,n)})),br=vr(\"<\",(function(t,e,r){return e<r}),(function(t,e,r,n){return n.compare(e,r)<0})),wr=vr(\">\",(function(t,e,r){return e>r}),(function(t,e,r,n){return n.compare(e,r)>0})),_r=vr(\"<=\",(function(t,e,r){return e<=r}),(function(t,e,r,n){return n.compare(e,r)<=0})),Ar=vr(\">=\",(function(t,e,r){return e>=r}),(function(t,e,r,n){return n.compare(e,r)>=0})),Sr=function(t,e,r,n,i){this.type=Rt,this.number=t,this.locale=e,this.currency=r,this.minFractionDigits=n,this.maxFractionDigits=i;};Sr.parse=function(t,e){if(3!==t.length)return e.error(\"Expected two arguments.\");var r=e.parse(t[1],1,Ot);if(!r)return null;var n=t[2];if(\"object\"!=typeof n||Array.isArray(n))return e.error(\"NumberFormat options argument must be an object.\");var i=null;if(n.locale&&!(i=e.parse(n.locale,1,Rt)))return null;var a=null;if(n.currency&&!(a=e.parse(n.currency,1,Rt)))return null;var o=null;if(n[\"min-fraction-digits\"]&&!(o=e.parse(n[\"min-fraction-digits\"],1,Ot)))return null;var s=null;return n[\"max-fraction-digits\"]&&!(s=e.parse(n[\"max-fraction-digits\"],1,Ot))?null:new Sr(r,i,a,o,s)},Sr.prototype.evaluate=function(t){return new Intl.NumberFormat(this.locale?this.locale.evaluate(t):[],{style:this.currency?\"currency\":\"decimal\",currency:this.currency?this.currency.evaluate(t):void 0,minimumFractionDigits:this.minFractionDigits?this.minFractionDigits.evaluate(t):void 0,maximumFractionDigits:this.maxFractionDigits?this.maxFractionDigits.evaluate(t):void 0}).format(this.number.evaluate(t))},Sr.prototype.eachChild=function(t){t(this.number),this.locale&&t(this.locale),this.currency&&t(this.currency),this.minFractionDigits&&t(this.minFractionDigits),this.maxFractionDigits&&t(this.maxFractionDigits);},Sr.prototype.outputDefined=function(){return !1},Sr.prototype.serialize=function(){var t={};return this.locale&&(t.locale=this.locale.serialize()),this.currency&&(t.currency=this.currency.serialize()),this.minFractionDigits&&(t[\"min-fraction-digits\"]=this.minFractionDigits.serialize()),this.maxFractionDigits&&(t[\"max-fraction-digits\"]=this.maxFractionDigits.serialize()),[\"number-format\",this.number.serialize(),t]};var kr=function(t){this.type=Ot,this.input=t;};kr.parse=function(t,e){if(2!==t.length)return e.error(\"Expected 1 argument, but found \"+(t.length-1)+\" instead.\");var r=e.parse(t[1],1);return r?\"array\"!==r.type.kind&&\"string\"!==r.type.kind&&\"value\"!==r.type.kind?e.error(\"Expected argument of type string or array, but found \"+Jt(r.type)+\" instead.\"):new kr(r):null},kr.prototype.evaluate=function(t){var e=this.input.evaluate(t);if(\"string\"==typeof e)return e.length;if(Array.isArray(e))return e.length;throw new pe(\"Expected value to be of type string or array, but found \"+Jt(se(e))+\" instead.\")},kr.prototype.eachChild=function(t){t(this.input);},kr.prototype.outputDefined=function(){return !1},kr.prototype.serialize=function(){var t=[\"length\"];return this.eachChild((function(e){t.push(e.serialize());})),t};var Ir={\"==\":gr,\"!=\":xr,\">\":wr,\"<\":br,\">=\":Ar,\"<=\":_r,array:he,at:lr,boolean:he,case:fr,coalesce:sr,collator:be,format:fe,image:ye,in:pr,\"index-of\":cr,interpolate:ar,\"interpolate-hcl\":ar,\"interpolate-lab\":ar,length:kr,let:ur,literal:le,match:hr,number:he,\"number-format\":Sr,object:he,slice:yr,step:Ne,string:he,\"to-boolean\":me,\"to-color\":me,\"to-number\":me,\"to-string\":me,var:Ue,within:De};function zr(t,e){var r=e[0],n=e[1],i=e[2],a=e[3];r=r.evaluate(t),n=n.evaluate(t),i=i.evaluate(t);var o=a?a.evaluate(t):1,s=ae(r,n,i,o);if(s)throw new pe(s);return new te(r/255*o,n/255*o,i/255*o,o)}function Cr(t,e){return t in e}function Er(t,e){var r=e[t];return void 0===r?null:r}function Pr(t){return {type:t}}function Mr(t){return {result:\"success\",value:t}}function Br(t){return {result:\"error\",value:t}}function Tr(t){return \"data-driven\"===t[\"property-type\"]||\"cross-faded-data-driven\"===t[\"property-type\"]}function Vr(t){return !!t.expression&&t.expression.parameters.indexOf(\"zoom\")>-1}function Fr(t){return !!t.expression&&t.expression.interpolated}function Dr(t){return t instanceof Number?\"number\":t instanceof String?\"string\":t instanceof Boolean?\"boolean\":Array.isArray(t)?\"array\":null===t?\"null\":typeof t}function Lr(t){return \"object\"==typeof t&&null!==t&&!Array.isArray(t)}function Or(t){return t}function Rr(t,e,r){return void 0!==t?t:void 0!==e?e:void 0!==r?r:void 0}function Ur(t,e,r,n,i){return Rr(typeof r===i?n[r]:void 0,t.default,e.default)}function jr(t,e,r){if(\"number\"!==Dr(r))return Rr(t.default,e.default);var n=t.stops.length;if(1===n)return t.stops[0][1];if(r<=t.stops[0][0])return t.stops[0][1];if(r>=t.stops[n-1][0])return t.stops[n-1][1];var i=qe(t.stops.map((function(t){return t[0]})),r);return t.stops[i][1]}function qr(t,e,r){var n=void 0!==t.base?t.base:1;if(\"number\"!==Dr(r))return Rr(t.default,e.default);var i=t.stops.length;if(1===i)return t.stops[0][1];if(r<=t.stops[0][0])return t.stops[0][1];if(r>=t.stops[i-1][0])return t.stops[i-1][1];var a=qe(t.stops.map((function(t){return t[0]})),r),o=function(t,e,r,n){var i=n-r,a=t-r;return 0===i?0:1===e?a/i:(Math.pow(e,a)-1)/(Math.pow(e,i)-1)}(r,n,t.stops[a][0],t.stops[a+1][0]),s=t.stops[a][1],u=t.stops[a+1][1],l=Ge[e.type]||Or;if(t.colorSpace&&\"rgb\"!==t.colorSpace){var p=ir[t.colorSpace];l=function(t,e){return p.reverse(p.interpolate(p.forward(t),p.forward(e),o))};}return \"function\"==typeof s.evaluate?{evaluate:function(){for(var t=[],e=arguments.length;e--;)t[e]=arguments[e];var r=s.evaluate.apply(void 0,t),n=u.evaluate.apply(void 0,t);if(void 0!==r&&void 0!==n)return l(r,n,o)}}:l(s,u,o)}function Nr(t,e,r){return \"color\"===e.type?r=te.parse(r):\"formatted\"===e.type?r=ne.fromString(r.toString()):\"resolvedImage\"===e.type?r=ie.fromString(r.toString()):Dr(r)===e.type||\"enum\"===e.type&&e.values[r]||(r=void 0),Rr(r,t.default,e.default)}xe.register(Ir,{error:[{kind:\"error\"},[Rt],function(t,e){throw new pe(e[0].evaluate(t))}],typeof:[Rt,[Nt],function(t,e){return Jt(se(e[0].evaluate(t)))}],\"to-rgba\":[Xt(Ot,4),[jt],function(t,e){return e[0].evaluate(t).toArray()}],rgb:[jt,[Ot,Ot,Ot],zr],rgba:[jt,[Ot,Ot,Ot,Ot],zr],has:{type:Ut,overloads:[[[Rt],function(t,e){return Cr(e[0].evaluate(t),t.properties())}],[[Rt,qt],function(t,e){var r=e[1];return Cr(e[0].evaluate(t),r.evaluate(t))}]]},get:{type:Nt,overloads:[[[Rt],function(t,e){return Er(e[0].evaluate(t),t.properties())}],[[Rt,qt],function(t,e){var r=e[1];return Er(e[0].evaluate(t),r.evaluate(t))}]]},\"feature-state\":[Nt,[Rt],function(t,e){return Er(e[0].evaluate(t),t.featureState||{})}],properties:[qt,[],function(t){return t.properties()}],\"geometry-type\":[Rt,[],function(t){return t.geometryType()}],id:[Nt,[],function(t){return t.id()}],zoom:[Ot,[],function(t){return t.globals.zoom}],\"heatmap-density\":[Ot,[],function(t){return t.globals.heatmapDensity||0}],\"line-progress\":[Ot,[],function(t){return t.globals.lineProgress||0}],accumulated:[Nt,[],function(t){return void 0===t.globals.accumulated?null:t.globals.accumulated}],\"+\":[Ot,Pr(Ot),function(t,e){for(var r=0,n=0,i=e;n<i.length;n+=1)r+=i[n].evaluate(t);return r}],\"*\":[Ot,Pr(Ot),function(t,e){for(var r=1,n=0,i=e;n<i.length;n+=1)r*=i[n].evaluate(t);return r}],\"-\":{type:Ot,overloads:[[[Ot,Ot],function(t,e){var r=e[1];return e[0].evaluate(t)-r.evaluate(t)}],[[Ot],function(t,e){return -e[0].evaluate(t)}]]},\"/\":[Ot,[Ot,Ot],function(t,e){var r=e[1];return e[0].evaluate(t)/r.evaluate(t)}],\"%\":[Ot,[Ot,Ot],function(t,e){var r=e[1];return e[0].evaluate(t)%r.evaluate(t)}],ln2:[Ot,[],function(){return Math.LN2}],pi:[Ot,[],function(){return Math.PI}],e:[Ot,[],function(){return Math.E}],\"^\":[Ot,[Ot,Ot],function(t,e){var r=e[1];return Math.pow(e[0].evaluate(t),r.evaluate(t))}],sqrt:[Ot,[Ot],function(t,e){return Math.sqrt(e[0].evaluate(t))}],log10:[Ot,[Ot],function(t,e){return Math.log(e[0].evaluate(t))/Math.LN10}],ln:[Ot,[Ot],function(t,e){return Math.log(e[0].evaluate(t))}],log2:[Ot,[Ot],function(t,e){return Math.log(e[0].evaluate(t))/Math.LN2}],sin:[Ot,[Ot],function(t,e){return Math.sin(e[0].evaluate(t))}],cos:[Ot,[Ot],function(t,e){return Math.cos(e[0].evaluate(t))}],tan:[Ot,[Ot],function(t,e){return Math.tan(e[0].evaluate(t))}],asin:[Ot,[Ot],function(t,e){return Math.asin(e[0].evaluate(t))}],acos:[Ot,[Ot],function(t,e){return Math.acos(e[0].evaluate(t))}],atan:[Ot,[Ot],function(t,e){return Math.atan(e[0].evaluate(t))}],min:[Ot,Pr(Ot),function(t,e){return Math.min.apply(Math,e.map((function(e){return e.evaluate(t)})))}],max:[Ot,Pr(Ot),function(t,e){return Math.max.apply(Math,e.map((function(e){return e.evaluate(t)})))}],abs:[Ot,[Ot],function(t,e){return Math.abs(e[0].evaluate(t))}],round:[Ot,[Ot],function(t,e){var r=e[0].evaluate(t);return r<0?-Math.round(-r):Math.round(r)}],floor:[Ot,[Ot],function(t,e){return Math.floor(e[0].evaluate(t))}],ceil:[Ot,[Ot],function(t,e){return Math.ceil(e[0].evaluate(t))}],\"filter-==\":[Ut,[Rt,Nt],function(t,e){var r=e[0],n=e[1];return t.properties()[r.value]===n.value}],\"filter-id-==\":[Ut,[Nt],function(t,e){var r=e[0];return t.id()===r.value}],\"filter-type-==\":[Ut,[Rt],function(t,e){var r=e[0];return t.geometryType()===r.value}],\"filter-<\":[Ut,[Rt,Nt],function(t,e){var r=e[0],n=e[1],i=t.properties()[r.value],a=n.value;return typeof i==typeof a&&i<a}],\"filter-id-<\":[Ut,[Nt],function(t,e){var r=e[0],n=t.id(),i=r.value;return typeof n==typeof i&&n<i}],\"filter->\":[Ut,[Rt,Nt],function(t,e){var r=e[0],n=e[1],i=t.properties()[r.value],a=n.value;return typeof i==typeof a&&i>a}],\"filter-id->\":[Ut,[Nt],function(t,e){var r=e[0],n=t.id(),i=r.value;return typeof n==typeof i&&n>i}],\"filter-<=\":[Ut,[Rt,Nt],function(t,e){var r=e[0],n=e[1],i=t.properties()[r.value],a=n.value;return typeof i==typeof a&&i<=a}],\"filter-id-<=\":[Ut,[Nt],function(t,e){var r=e[0],n=t.id(),i=r.value;return typeof n==typeof i&&n<=i}],\"filter->=\":[Ut,[Rt,Nt],function(t,e){var r=e[0],n=e[1],i=t.properties()[r.value],a=n.value;return typeof i==typeof a&&i>=a}],\"filter-id->=\":[Ut,[Nt],function(t,e){var r=e[0],n=t.id(),i=r.value;return typeof n==typeof i&&n>=i}],\"filter-has\":[Ut,[Nt],function(t,e){return e[0].value in t.properties()}],\"filter-has-id\":[Ut,[],function(t){return null!==t.id()&&void 0!==t.id()}],\"filter-type-in\":[Ut,[Xt(Rt)],function(t,e){return e[0].value.indexOf(t.geometryType())>=0}],\"filter-id-in\":[Ut,[Xt(Nt)],function(t,e){return e[0].value.indexOf(t.id())>=0}],\"filter-in-small\":[Ut,[Rt,Xt(Nt)],function(t,e){var r=e[0];return e[1].value.indexOf(t.properties()[r.value])>=0}],\"filter-in-large\":[Ut,[Rt,Xt(Nt)],function(t,e){var r=e[0],n=e[1];return function(t,e,r,n){for(;r<=n;){var i=r+n>>1;if(e[i]===t)return !0;e[i]>t?n=i-1:r=i+1;}return !1}(t.properties()[r.value],n.value,0,n.value.length-1)}],all:{type:Ut,overloads:[[[Ut,Ut],function(t,e){var r=e[1];return e[0].evaluate(t)&&r.evaluate(t)}],[Pr(Ut),function(t,e){for(var r=0,n=e;r<n.length;r+=1)if(!n[r].evaluate(t))return !1;return !0}]]},any:{type:Ut,overloads:[[[Ut,Ut],function(t,e){var r=e[1];return e[0].evaluate(t)||r.evaluate(t)}],[Pr(Ut),function(t,e){for(var r=0,n=e;r<n.length;r+=1)if(n[r].evaluate(t))return !0;return !1}]]},\"!\":[Ut,[Ut],function(t,e){return !e[0].evaluate(t)}],\"is-supported-script\":[Ut,[Rt],function(t,e){var r=t.globals&&t.globals.isSupportedScript;return !r||r(e[0].evaluate(t))}],upcase:[Rt,[Rt],function(t,e){return e[0].evaluate(t).toUpperCase()}],downcase:[Rt,[Rt],function(t,e){return e[0].evaluate(t).toLowerCase()}],concat:[Rt,Pr(Nt),function(t,e){return e.map((function(e){return ue(e.evaluate(t))})).join(\"\")}],\"resolved-locale\":[Rt,[Kt],function(t,e){return e[0].evaluate(t).resolvedLocale()}]});var Kr=function(t,e){this.expression=t,this._warningHistory={},this._evaluator=new ge,this._defaultValue=e?function(t){return \"color\"===t.type&&Lr(t.default)?new te(0,0,0,0):\"color\"===t.type?te.parse(t.default)||null:void 0===t.default?null:t.default}(e):null,this._enumValues=e&&\"enum\"===e.type?e.values:null;};function Gr(t){return Array.isArray(t)&&t.length>0&&\"string\"==typeof t[0]&&t[0]in Ir}function Zr(t,e){var r=new je(Ir,[],e?function(t){var e={color:jt,string:Rt,number:Ot,enum:Rt,boolean:Ut,formatted:Gt,resolvedImage:Zt};return \"array\"===t.type?Xt(e[t.value]||Nt,t.length):e[t.type]}(e):void 0),n=r.parse(t,void 0,void 0,void 0,e&&\"string\"===e.type?{typeAnnotation:\"coerce\"}:void 0);return n?Mr(new Kr(n,e)):Br(r.errors)}Kr.prototype.evaluateWithoutErrorHandling=function(t,e,r,n,i,a){return this._evaluator.globals=t,this._evaluator.feature=e,this._evaluator.featureState=r,this._evaluator.canonical=n,this._evaluator.availableImages=i||null,this._evaluator.formattedSection=a,this.expression.evaluate(this._evaluator)},Kr.prototype.evaluate=function(t,e,r,n,i,a){this._evaluator.globals=t,this._evaluator.feature=e||null,this._evaluator.featureState=r||null,this._evaluator.canonical=n,this._evaluator.availableImages=i||null,this._evaluator.formattedSection=a||null;try{var o=this.expression.evaluate(this._evaluator);if(null==o||\"number\"==typeof o&&o!=o)return this._defaultValue;if(this._enumValues&&!(o in this._enumValues))throw new pe(\"Expected value to be one of \"+Object.keys(this._enumValues).map((function(t){return JSON.stringify(t)})).join(\", \")+\", but found \"+JSON.stringify(o)+\" instead.\");return o}catch(t){return this._warningHistory[t.message]||(this._warningHistory[t.message]=!0,\"undefined\"!=typeof console&&console.warn(t.message)),this._defaultValue}};var Xr=function(t,e){this.kind=t,this._styleExpression=e,this.isStateDependent=\"constant\"!==t&&!Oe(e.expression);};Xr.prototype.evaluateWithoutErrorHandling=function(t,e,r,n,i,a){return this._styleExpression.evaluateWithoutErrorHandling(t,e,r,n,i,a)},Xr.prototype.evaluate=function(t,e,r,n,i,a){return this._styleExpression.evaluate(t,e,r,n,i,a)};var Jr=function(t,e,r,n){this.kind=t,this.zoomStops=r,this._styleExpression=e,this.isStateDependent=\"camera\"!==t&&!Oe(e.expression),this.interpolationType=n;};function Hr(t,e){if(\"error\"===(t=Zr(t,e)).result)return t;var r=t.value.expression,n=Le(r);if(!n&&!Tr(e))return Br([new Ft(\"\",\"data expressions not supported\")]);var i=Re(r,[\"zoom\"]);if(!i&&!Vr(e))return Br([new Ft(\"\",\"zoom expressions not supported\")]);var a=function t(e){var r=null;if(e instanceof ur)r=t(e.result);else if(e instanceof sr)for(var n=0,i=e.args;n<i.length&&!(r=t(i[n]));n+=1);else (e instanceof Ne||e instanceof ar)&&e.input instanceof xe&&\"zoom\"===e.input.name&&(r=e);return r instanceof Ft||e.eachChild((function(e){var n=t(e);n instanceof Ft?r=n:!r&&n?r=new Ft(\"\",'\"zoom\" expression may only be used as input to a top-level \"step\" or \"interpolate\" expression.'):r&&n&&r!==n&&(r=new Ft(\"\",'Only one zoom-based \"step\" or \"interpolate\" subexpression may be used in an expression.'));})),r}(r);return a||i?a instanceof Ft?Br([a]):a instanceof ar&&!Fr(e)?Br([new Ft(\"\",'\"interpolate\" expressions cannot be used with this property')]):Mr(a?new Jr(n?\"camera\":\"composite\",t.value,a.labels,a instanceof ar?a.interpolation:void 0):new Xr(n?\"constant\":\"source\",t.value)):Br([new Ft(\"\",'\"zoom\" expression may only be used as input to a top-level \"step\" or \"interpolate\" expression.')])}Jr.prototype.evaluateWithoutErrorHandling=function(t,e,r,n,i,a){return this._styleExpression.evaluateWithoutErrorHandling(t,e,r,n,i,a)},Jr.prototype.evaluate=function(t,e,r,n,i,a){return this._styleExpression.evaluate(t,e,r,n,i,a)},Jr.prototype.interpolationFactor=function(t,e,r){return this.interpolationType?ar.interpolationFactor(this.interpolationType,t,e,r):0};var Yr=function(t,e){this._parameters=t,this._specification=e,Bt(this,function t(e,r){var n,i,a,o=\"color\"===r.type,s=e.stops&&\"object\"==typeof e.stops[0][0],u=s||!(s||void 0!==e.property),l=e.type||(Fr(r)?\"exponential\":\"interval\");if(o&&((e=Bt({},e)).stops&&(e.stops=e.stops.map((function(t){return [t[0],te.parse(t[1])]}))),e.default=te.parse(e.default?e.default:r.default)),e.colorSpace&&\"rgb\"!==e.colorSpace&&!ir[e.colorSpace])throw new Error(\"Unknown color space: \"+e.colorSpace);if(\"exponential\"===l)n=qr;else if(\"interval\"===l)n=jr;else if(\"categorical\"===l){n=Ur,i=Object.create(null);for(var p=0,c=e.stops;p<c.length;p+=1){var h=c[p];i[h[0]]=h[1];}a=typeof e.stops[0][0];}else {if(\"identity\"!==l)throw new Error('Unknown function type \"'+l+'\"');n=Nr;}if(s){for(var f={},y=[],d=0;d<e.stops.length;d++){var m=e.stops[d],v=m[0].zoom;void 0===f[v]&&(f[v]={zoom:v,type:e.type,property:e.property,default:e.default,stops:[]},y.push(v)),f[v].stops.push([m[0].value,m[1]]);}for(var g=[],x=0,b=y;x<b.length;x+=1){var w=b[x];g.push([f[w].zoom,t(f[w],r)]);}var _={name:\"linear\"};return {kind:\"composite\",interpolationType:_,interpolationFactor:ar.interpolationFactor.bind(void 0,_),zoomStops:g.map((function(t){return t[0]})),evaluate:function(t,n){var i=t.zoom;return qr({stops:g,base:e.base},r,i).evaluate(i,n)}}}if(u){var A=\"exponential\"===l?{name:\"exponential\",base:void 0!==e.base?e.base:1}:null;return {kind:\"camera\",interpolationType:A,interpolationFactor:ar.interpolationFactor.bind(void 0,A),zoomStops:e.stops.map((function(t){return t[0]})),evaluate:function(t){return n(e,r,t.zoom,i,a)}}}return {kind:\"source\",evaluate:function(t,o){var s=o&&o.properties?o.properties[e.property]:void 0;return void 0===s?Rr(e.default,r.default):n(e,r,s,i,a)}}}(this._parameters,this._specification));};function $r(t){var e=t.key,r=t.value,n=t.valueSpec||{},i=t.objectElementValidators||{},a=t.style,o=t.styleSpec,s=[],u=Dr(r);if(\"object\"!==u)return [new Pt(e,r,\"object expected, \"+u+\" found\")];for(var l in r){var p=l.split(\".\")[0],c=n[p]||n[\"*\"],h=void 0;if(i[p])h=i[p];else if(n[p])h=An;else if(i[\"*\"])h=i[\"*\"];else {if(!n[\"*\"]){s.push(new Pt(e,r[l],'unknown property \"'+l+'\"'));continue}h=An;}s=s.concat(h({key:(e?e+\".\":e)+l,value:r[l],valueSpec:c,style:a,styleSpec:o,object:r,objectKey:l},r));}for(var f in n)i[f]||n[f].required&&void 0===n[f].default&&void 0===r[f]&&s.push(new Pt(e,r,'missing required property \"'+f+'\"'));return s}function Wr(t){var e=t.value,r=t.valueSpec,n=t.style,i=t.styleSpec,a=t.key,o=t.arrayElementValidator||An;if(\"array\"!==Dr(e))return [new Pt(a,e,\"array expected, \"+Dr(e)+\" found\")];if(r.length&&e.length!==r.length)return [new Pt(a,e,\"array length \"+r.length+\" expected, length \"+e.length+\" found\")];if(r[\"min-length\"]&&e.length<r[\"min-length\"])return [new Pt(a,e,\"array length at least \"+r[\"min-length\"]+\" expected, length \"+e.length+\" found\")];var s={type:r.value,values:r.values};i.$version<7&&(s.function=r.function),\"object\"===Dr(r.value)&&(s=r.value);for(var u=[],l=0;l<e.length;l++)u=u.concat(o({array:e,arrayIndex:l,value:e[l],valueSpec:s,style:n,styleSpec:i,key:a+\"[\"+l+\"]\"}));return u}function Qr(t){var e=t.key,r=t.value,n=t.valueSpec,i=Dr(r);return \"number\"===i&&r!=r&&(i=\"NaN\"),\"number\"!==i?[new Pt(e,r,\"number expected, \"+i+\" found\")]:\"minimum\"in n&&r<n.minimum?[new Pt(e,r,r+\" is less than the minimum value \"+n.minimum)]:\"maximum\"in n&&r>n.maximum?[new Pt(e,r,r+\" is greater than the maximum value \"+n.maximum)]:[]}function tn(t){var e,r,n,i=t.valueSpec,a=Tt(t.value.type),o={},s=\"categorical\"!==a&&void 0===t.value.property,u=!s,l=\"array\"===Dr(t.value.stops)&&\"array\"===Dr(t.value.stops[0])&&\"object\"===Dr(t.value.stops[0][0]),p=$r({key:t.key,value:t.value,valueSpec:t.styleSpec.function,style:t.style,styleSpec:t.styleSpec,objectElementValidators:{stops:function(t){if(\"identity\"===a)return [new Pt(t.key,t.value,'identity function may not have a \"stops\" property')];var e=[],r=t.value;return e=e.concat(Wr({key:t.key,value:r,valueSpec:t.valueSpec,style:t.style,styleSpec:t.styleSpec,arrayElementValidator:c})),\"array\"===Dr(r)&&0===r.length&&e.push(new Pt(t.key,r,\"array must have at least one stop\")),e},default:function(t){return An({key:t.key,value:t.value,valueSpec:i,style:t.style,styleSpec:t.styleSpec})}}});return \"identity\"===a&&s&&p.push(new Pt(t.key,t.value,'missing required property \"property\"')),\"identity\"===a||t.value.stops||p.push(new Pt(t.key,t.value,'missing required property \"stops\"')),\"exponential\"===a&&t.valueSpec.expression&&!Fr(t.valueSpec)&&p.push(new Pt(t.key,t.value,\"exponential functions not supported\")),t.styleSpec.$version>=8&&(u&&!Tr(t.valueSpec)?p.push(new Pt(t.key,t.value,\"property functions not supported\")):s&&!Vr(t.valueSpec)&&p.push(new Pt(t.key,t.value,\"zoom functions not supported\"))),\"categorical\"!==a&&!l||void 0!==t.value.property||p.push(new Pt(t.key,t.value,'\"property\" property is required')),p;function c(t){var e=[],a=t.value,s=t.key;if(\"array\"!==Dr(a))return [new Pt(s,a,\"array expected, \"+Dr(a)+\" found\")];if(2!==a.length)return [new Pt(s,a,\"array length 2 expected, length \"+a.length+\" found\")];if(l){if(\"object\"!==Dr(a[0]))return [new Pt(s,a,\"object expected, \"+Dr(a[0])+\" found\")];if(void 0===a[0].zoom)return [new Pt(s,a,\"object stop key must have zoom\")];if(void 0===a[0].value)return [new Pt(s,a,\"object stop key must have value\")];if(n&&n>Tt(a[0].zoom))return [new Pt(s,a[0].zoom,\"stop zoom values must appear in ascending order\")];Tt(a[0].zoom)!==n&&(n=Tt(a[0].zoom),r=void 0,o={}),e=e.concat($r({key:s+\"[0]\",value:a[0],valueSpec:{zoom:{}},style:t.style,styleSpec:t.styleSpec,objectElementValidators:{zoom:Qr,value:h}}));}else e=e.concat(h({key:s+\"[0]\",value:a[0],valueSpec:{},style:t.style,styleSpec:t.styleSpec},a));return Gr(Vt(a[1]))?e.concat([new Pt(s+\"[1]\",a[1],\"expressions are not allowed in function stops.\")]):e.concat(An({key:s+\"[1]\",value:a[1],valueSpec:i,style:t.style,styleSpec:t.styleSpec}))}function h(t,n){var s=Dr(t.value),u=Tt(t.value),l=null!==t.value?t.value:n;if(e){if(s!==e)return [new Pt(t.key,l,s+\" stop domain type must match previous stop domain type \"+e)]}else e=s;if(\"number\"!==s&&\"string\"!==s&&\"boolean\"!==s)return [new Pt(t.key,l,\"stop domain value must be a number, string, or boolean\")];if(\"number\"!==s&&\"categorical\"!==a){var p=\"number expected, \"+s+\" found\";return Tr(i)&&void 0===a&&(p+='\\nIf you intended to use a categorical function, specify `\"type\": \"categorical\"`.'),[new Pt(t.key,l,p)]}return \"categorical\"!==a||\"number\"!==s||isFinite(u)&&Math.floor(u)===u?\"categorical\"!==a&&\"number\"===s&&void 0!==r&&u<r?[new Pt(t.key,l,\"stop domain values must appear in ascending order\")]:(r=u,\"categorical\"===a&&u in o?[new Pt(t.key,l,\"stop domain values must be unique\")]:(o[u]=!0,[])):[new Pt(t.key,l,\"integer expected, found \"+u)]}}function en(t){var e=(\"property\"===t.expressionContext?Hr:Zr)(Vt(t.value),t.valueSpec);if(\"error\"===e.result)return e.value.map((function(e){return new Pt(\"\"+t.key+e.key,t.value,e.message)}));var r=e.value.expression||e.value._styleExpression.expression;if(\"property\"===t.expressionContext&&\"text-font\"===t.propertyKey&&!r.outputDefined())return [new Pt(t.key,t.value,'Invalid data expression for \"'+t.propertyKey+'\". Output values must be contained as literals within the expression.')];if(\"property\"===t.expressionContext&&\"layout\"===t.propertyType&&!Oe(r))return [new Pt(t.key,t.value,'\"feature-state\" data expressions are not supported with layout properties.')];if(\"filter\"===t.expressionContext&&!Oe(r))return [new Pt(t.key,t.value,'\"feature-state\" data expressions are not supported with filters.')];if(t.expressionContext&&0===t.expressionContext.indexOf(\"cluster\")){if(!Re(r,[\"zoom\",\"feature-state\"]))return [new Pt(t.key,t.value,'\"zoom\" and \"feature-state\" expressions are not supported with cluster properties.')];if(\"cluster-initial\"===t.expressionContext&&!Le(r))return [new Pt(t.key,t.value,\"Feature data expressions are not supported with initial expression part of cluster properties.\")]}return []}function rn(t){var e=t.key,r=t.value,n=t.valueSpec,i=[];return Array.isArray(n.values)?-1===n.values.indexOf(Tt(r))&&i.push(new Pt(e,r,\"expected one of [\"+n.values.join(\", \")+\"], \"+JSON.stringify(r)+\" found\")):-1===Object.keys(n.values).indexOf(Tt(r))&&i.push(new Pt(e,r,\"expected one of [\"+Object.keys(n.values).join(\", \")+\"], \"+JSON.stringify(r)+\" found\")),i}function nn(t){if(!0===t||!1===t)return !0;if(!Array.isArray(t)||0===t.length)return !1;switch(t[0]){case\"has\":return t.length>=2&&\"$id\"!==t[1]&&\"$type\"!==t[1];case\"in\":return t.length>=3&&(\"string\"!=typeof t[1]||Array.isArray(t[2]));case\"!in\":case\"!has\":case\"none\":return !1;case\"==\":case\"!=\":case\">\":case\">=\":case\"<\":case\"<=\":return 3!==t.length||Array.isArray(t[1])||Array.isArray(t[2]);case\"any\":case\"all\":for(var e=0,r=t.slice(1);e<r.length;e+=1){var n=r[e];if(!nn(n)&&\"boolean\"!=typeof n)return !1}return !0;default:return !0}}Yr.deserialize=function(t){return new Yr(t._parameters,t._specification)},Yr.serialize=function(t){return {_parameters:t._parameters,_specification:t._specification}};var an={type:\"boolean\",default:!1,transition:!1,\"property-type\":\"data-driven\",expression:{interpolated:!1,parameters:[\"zoom\",\"feature\"]}};function on(t){if(null==t)return {filter:function(){return !0},needGeometry:!1};nn(t)||(t=un(t));var e=Zr(t,an);if(\"error\"===e.result)throw new Error(e.value.map((function(t){return t.key+\": \"+t.message})).join(\", \"));return {filter:function(t,r,n){return e.value.evaluate(t,r,{},n)},needGeometry:function t(e){if(!Array.isArray(e))return !1;if(\"within\"===e[0])return !0;for(var r=1;r<e.length;r++)if(t(e[r]))return !0;return !1}(t)}}function sn(t,e){return t<e?-1:t>e?1:0}function un(t){if(!t)return !0;var e,r=t[0];return t.length<=1?\"any\"!==r:\"==\"===r?ln(t[1],t[2],\"==\"):\"!=\"===r?hn(ln(t[1],t[2],\"==\")):\"<\"===r||\">\"===r||\"<=\"===r||\">=\"===r?ln(t[1],t[2],r):\"any\"===r?(e=t.slice(1),[\"any\"].concat(e.map(un))):\"all\"===r?[\"all\"].concat(t.slice(1).map(un)):\"none\"===r?[\"all\"].concat(t.slice(1).map(un).map(hn)):\"in\"===r?pn(t[1],t.slice(2)):\"!in\"===r?hn(pn(t[1],t.slice(2))):\"has\"===r?cn(t[1]):\"!has\"===r?hn(cn(t[1])):\"within\"!==r||t}function ln(t,e,r){switch(t){case\"$type\":return [\"filter-type-\"+r,e];case\"$id\":return [\"filter-id-\"+r,e];default:return [\"filter-\"+r,t,e]}}function pn(t,e){if(0===e.length)return !1;switch(t){case\"$type\":return [\"filter-type-in\",[\"literal\",e]];case\"$id\":return [\"filter-id-in\",[\"literal\",e]];default:return e.length>200&&!e.some((function(t){return typeof t!=typeof e[0]}))?[\"filter-in-large\",t,[\"literal\",e.sort(sn)]]:[\"filter-in-small\",t,[\"literal\",e]]}}function cn(t){switch(t){case\"$type\":return !0;case\"$id\":return [\"filter-has-id\"];default:return [\"filter-has\",t]}}function hn(t){return [\"!\",t]}function fn(t){return nn(Vt(t.value))?en(Bt({},t,{expressionContext:\"filter\",valueSpec:{value:\"boolean\"}})):function t(e){var r=e.value,n=e.key;if(\"array\"!==Dr(r))return [new Pt(n,r,\"array expected, \"+Dr(r)+\" found\")];var i,a=e.styleSpec,o=[];if(r.length<1)return [new Pt(n,r,\"filter array must have at least 1 element\")];switch(o=o.concat(rn({key:n+\"[0]\",value:r[0],valueSpec:a.filter_operator,style:e.style,styleSpec:e.styleSpec})),Tt(r[0])){case\"<\":case\"<=\":case\">\":case\">=\":r.length>=2&&\"$type\"===Tt(r[1])&&o.push(new Pt(n,r,'\"$type\" cannot be use with operator \"'+r[0]+'\"'));case\"==\":case\"!=\":3!==r.length&&o.push(new Pt(n,r,'filter array for operator \"'+r[0]+'\" must have 3 elements'));case\"in\":case\"!in\":r.length>=2&&\"string\"!==(i=Dr(r[1]))&&o.push(new Pt(n+\"[1]\",r[1],\"string expected, \"+i+\" found\"));for(var s=2;s<r.length;s++)i=Dr(r[s]),\"$type\"===Tt(r[1])?o=o.concat(rn({key:n+\"[\"+s+\"]\",value:r[s],valueSpec:a.geometry_type,style:e.style,styleSpec:e.styleSpec})):\"string\"!==i&&\"number\"!==i&&\"boolean\"!==i&&o.push(new Pt(n+\"[\"+s+\"]\",r[s],\"string, number, or boolean expected, \"+i+\" found\"));break;case\"any\":case\"all\":case\"none\":for(var u=1;u<r.length;u++)o=o.concat(t({key:n+\"[\"+u+\"]\",value:r[u],style:e.style,styleSpec:e.styleSpec}));break;case\"has\":case\"!has\":i=Dr(r[1]),2!==r.length?o.push(new Pt(n,r,'filter array for \"'+r[0]+'\" operator must have 2 elements')):\"string\"!==i&&o.push(new Pt(n+\"[1]\",r[1],\"string expected, \"+i+\" found\"));break;case\"within\":i=Dr(r[1]),2!==r.length?o.push(new Pt(n,r,'filter array for \"'+r[0]+'\" operator must have 2 elements')):\"object\"!==i&&o.push(new Pt(n+\"[1]\",r[1],\"object expected, \"+i+\" found\"));}return o}(t)}function yn(t,e){var r=t.key,n=t.style,i=t.styleSpec,a=t.value,o=t.objectKey,s=i[e+\"_\"+t.layerType];if(!s)return [];var u=o.match(/^(.*)-transition$/);if(\"paint\"===e&&u&&s[u[1]]&&s[u[1]].transition)return An({key:r,value:a,valueSpec:i.transition,style:n,styleSpec:i});var l,p=t.valueSpec||s[o];if(!p)return [new Pt(r,a,'unknown property \"'+o+'\"')];if(\"string\"===Dr(a)&&Tr(p)&&!p.tokens&&(l=/^{([^}]+)}$/.exec(a)))return [new Pt(r,a,'\"'+o+'\" does not support interpolation syntax\\nUse an identity property function instead: `{ \"type\": \"identity\", \"property\": '+JSON.stringify(l[1])+\" }`.\")];var c=[];return \"symbol\"===t.layerType&&(\"text-field\"===o&&n&&!n.glyphs&&c.push(new Pt(r,a,'use of \"text-field\" requires a style \"glyphs\" property')),\"text-font\"===o&&Lr(Vt(a))&&\"identity\"===Tt(a.type)&&c.push(new Pt(r,a,'\"text-font\" does not support identity functions'))),c.concat(An({key:t.key,value:a,valueSpec:p,style:n,styleSpec:i,expressionContext:\"property\",propertyType:e,propertyKey:o}))}function dn(t){return yn(t,\"paint\")}function mn(t){return yn(t,\"layout\")}function vn(t){var e=[],r=t.value,n=t.key,i=t.style,a=t.styleSpec;r.type||r.ref||e.push(new Pt(n,r,'either \"type\" or \"ref\" is required'));var o,s=Tt(r.type),u=Tt(r.ref);if(r.id)for(var l=Tt(r.id),p=0;p<t.arrayIndex;p++){var c=i.layers[p];Tt(c.id)===l&&e.push(new Pt(n,r.id,'duplicate layer id \"'+r.id+'\", previously used at line '+c.id.__line__));}if(\"ref\"in r)[\"type\",\"source\",\"source-layer\",\"filter\",\"layout\"].forEach((function(t){t in r&&e.push(new Pt(n,r[t],'\"'+t+'\" is prohibited for ref layers'));})),i.layers.forEach((function(t){Tt(t.id)===u&&(o=t);})),o?o.ref?e.push(new Pt(n,r.ref,\"ref cannot reference another ref layer\")):s=Tt(o.type):e.push(new Pt(n,r.ref,'ref layer \"'+u+'\" not found'));else if(\"background\"!==s)if(r.source){var h=i.sources&&i.sources[r.source],f=h&&Tt(h.type);h?\"vector\"===f&&\"raster\"===s?e.push(new Pt(n,r.source,'layer \"'+r.id+'\" requires a raster source')):\"raster\"===f&&\"raster\"!==s?e.push(new Pt(n,r.source,'layer \"'+r.id+'\" requires a vector source')):\"vector\"!==f||r[\"source-layer\"]?\"raster-dem\"===f&&\"hillshade\"!==s?e.push(new Pt(n,r.source,\"raster-dem source can only be used with layer type 'hillshade'.\")):\"line\"!==s||!r.paint||!r.paint[\"line-gradient\"]||\"geojson\"===f&&h.lineMetrics||e.push(new Pt(n,r,'layer \"'+r.id+'\" specifies a line-gradient, which requires a GeoJSON source with `lineMetrics` enabled.')):e.push(new Pt(n,r,'layer \"'+r.id+'\" must specify a \"source-layer\"')):e.push(new Pt(n,r.source,'source \"'+r.source+'\" not found'));}else e.push(new Pt(n,r,'missing required property \"source\"'));return e=e.concat($r({key:n,value:r,valueSpec:a.layer,style:t.style,styleSpec:t.styleSpec,objectElementValidators:{\"*\":function(){return []},type:function(){return An({key:n+\".type\",value:r.type,valueSpec:a.layer.type,style:t.style,styleSpec:t.styleSpec,object:r,objectKey:\"type\"})},filter:fn,layout:function(t){return $r({layer:r,key:t.key,value:t.value,style:t.style,styleSpec:t.styleSpec,objectElementValidators:{\"*\":function(t){return mn(Bt({layerType:s},t))}}})},paint:function(t){return $r({layer:r,key:t.key,value:t.value,style:t.style,styleSpec:t.styleSpec,objectElementValidators:{\"*\":function(t){return dn(Bt({layerType:s},t))}}})}}}))}function gn(t){var e=t.value,r=t.key,n=Dr(e);return \"string\"!==n?[new Pt(r,e,\"string expected, \"+n+\" found\")]:[]}var xn={promoteId:function(t){var e=t.key,r=t.value;if(\"string\"===Dr(r))return gn({key:e,value:r});var n=[];for(var i in r)n.push.apply(n,gn({key:e+\".\"+i,value:r[i]}));return n}};function bn(t){var e=t.value,r=t.key,n=t.styleSpec,i=t.style;if(!e.type)return [new Pt(r,e,'\"type\" is required')];var a,o=Tt(e.type);switch(o){case\"vector\":case\"raster\":case\"raster-dem\":return $r({key:r,value:e,valueSpec:n[\"source_\"+o.replace(\"-\",\"_\")],style:t.style,styleSpec:n,objectElementValidators:xn});case\"geojson\":if(a=$r({key:r,value:e,valueSpec:n.source_geojson,style:i,styleSpec:n,objectElementValidators:xn}),e.cluster)for(var s in e.clusterProperties){var u=e.clusterProperties[s],l=u[0],p=\"string\"==typeof l?[l,[\"accumulated\"],[\"get\",s]]:l;a.push.apply(a,en({key:r+\".\"+s+\".map\",value:u[1],expressionContext:\"cluster-map\"})),a.push.apply(a,en({key:r+\".\"+s+\".reduce\",value:p,expressionContext:\"cluster-reduce\"}));}return a;case\"video\":return $r({key:r,value:e,valueSpec:n.source_video,style:i,styleSpec:n});case\"image\":return $r({key:r,value:e,valueSpec:n.source_image,style:i,styleSpec:n});case\"canvas\":return [new Pt(r,null,\"Please use runtime APIs to add canvas sources, rather than including them in stylesheets.\",\"source.canvas\")];default:return rn({key:r+\".type\",value:e.type,valueSpec:{values:[\"vector\",\"raster\",\"raster-dem\",\"geojson\",\"video\",\"image\"]},style:i,styleSpec:n})}}function wn(t){var e=t.value,r=t.styleSpec,n=r.light,i=t.style,a=[],o=Dr(e);if(void 0===e)return a;if(\"object\"!==o)return a.concat([new Pt(\"light\",e,\"object expected, \"+o+\" found\")]);for(var s in e){var u=s.match(/^(.*)-transition$/);a=a.concat(u&&n[u[1]]&&n[u[1]].transition?An({key:s,value:e[s],valueSpec:r.transition,style:i,styleSpec:r}):n[s]?An({key:s,value:e[s],valueSpec:n[s],style:i,styleSpec:r}):[new Pt(s,e[s],'unknown property \"'+s+'\"')]);}return a}var _n={\"*\":function(){return []},array:Wr,boolean:function(t){var e=t.value,r=t.key,n=Dr(e);return \"boolean\"!==n?[new Pt(r,e,\"boolean expected, \"+n+\" found\")]:[]},number:Qr,color:function(t){var e=t.key,r=t.value,n=Dr(r);return \"string\"!==n?[new Pt(e,r,\"color expected, \"+n+\" found\")]:null===Qt(r)?[new Pt(e,r,'color expected, \"'+r+'\" found')]:[]},constants:Mt,enum:rn,filter:fn,function:tn,layer:vn,object:$r,source:bn,light:wn,string:gn,formatted:function(t){return 0===gn(t).length?[]:en(t)},resolvedImage:function(t){return 0===gn(t).length?[]:en(t)}};function An(t){var e=t.value,r=t.valueSpec,n=t.styleSpec;return r.expression&&Lr(Tt(e))?tn(t):r.expression&&Gr(Vt(e))?en(t):r.type&&_n[r.type]?_n[r.type](t):$r(Bt({},t,{valueSpec:r.type?n[r.type]:r}))}function Sn(t){var e=t.value,r=t.key,n=gn(t);return n.length||(-1===e.indexOf(\"{fontstack}\")&&n.push(new Pt(r,e,'\"glyphs\" url must include a \"{fontstack}\" token')),-1===e.indexOf(\"{range}\")&&n.push(new Pt(r,e,'\"glyphs\" url must include a \"{range}\" token'))),n}function kn(t,e){void 0===e&&(e=Et);var r=[];return r=r.concat(An({key:\"\",value:t,valueSpec:e.$root,styleSpec:e,style:t,objectElementValidators:{glyphs:Sn,\"*\":function(){return []}}})),t.constants&&(r=r.concat(Mt({key:\"constants\",value:t.constants,style:t,styleSpec:e}))),In(r)}function In(t){return [].concat(t).sort((function(t,e){return t.line-e.line}))}function zn(t){return function(){for(var e=[],r=arguments.length;r--;)e[r]=arguments[r];return In(t.apply(this,e))}}kn.source=zn(bn),kn.light=zn(wn),kn.layer=zn(vn),kn.filter=zn(fn),kn.paintProperty=zn(dn),kn.layoutProperty=zn(mn);var Cn=kn,En=Cn.light,Pn=Cn.paintProperty,Mn=Cn.layoutProperty;function Bn(t,e){var r=!1;if(e&&e.length)for(var n=0,i=e;n<i.length;n+=1)t.fire(new zt(new Error(i[n].message))),r=!0;return r}var Tn=Vn;function Vn(t,e,r){var n=this.cells=[];if(t instanceof ArrayBuffer){this.arrayBuffer=t;var i=new Int32Array(this.arrayBuffer);t=i[0],this.d=(e=i[1])+2*(r=i[2]);for(var a=0;a<this.d*this.d;a++){var o=i[3+a],s=i[3+a+1];n.push(o===s?null:i.subarray(o,s));}var u=i[3+n.length+1];this.keys=i.subarray(i[3+n.length],u),this.bboxes=i.subarray(u),this.insert=this._insertReadonly;}else {this.d=e+2*r;for(var l=0;l<this.d*this.d;l++)n.push([]);this.keys=[],this.bboxes=[];}this.n=e,this.extent=t,this.padding=r,this.scale=e/t,this.uid=0;var p=r/e*t;this.min=-p,this.max=t+p;}Vn.prototype.insert=function(t,e,r,n,i){this._forEachCell(e,r,n,i,this._insertCell,this.uid++),this.keys.push(t),this.bboxes.push(e),this.bboxes.push(r),this.bboxes.push(n),this.bboxes.push(i);},Vn.prototype._insertReadonly=function(){throw \"Cannot insert into a GridIndex created from an ArrayBuffer.\"},Vn.prototype._insertCell=function(t,e,r,n,i,a){this.cells[i].push(a);},Vn.prototype.query=function(t,e,r,n,i){var a=this.min,o=this.max;if(t<=a&&e<=a&&o<=r&&o<=n&&!i)return Array.prototype.slice.call(this.keys);var s=[];return this._forEachCell(t,e,r,n,this._queryCell,s,{},i),s},Vn.prototype._queryCell=function(t,e,r,n,i,a,o,s){var u=this.cells[i];if(null!==u)for(var l=this.keys,p=this.bboxes,c=0;c<u.length;c++){var h=u[c];if(void 0===o[h]){var f=4*h;(s?s(p[f+0],p[f+1],p[f+2],p[f+3]):t<=p[f+2]&&e<=p[f+3]&&r>=p[f+0]&&n>=p[f+1])?(o[h]=!0,a.push(l[h])):o[h]=!1;}}},Vn.prototype._forEachCell=function(t,e,r,n,i,a,o,s){for(var u=this._convertToCellCoord(t),l=this._convertToCellCoord(e),p=this._convertToCellCoord(r),c=this._convertToCellCoord(n),h=u;h<=p;h++)for(var f=l;f<=c;f++){var y=this.d*f+h;if((!s||s(this._convertFromCellCoord(h),this._convertFromCellCoord(f),this._convertFromCellCoord(h+1),this._convertFromCellCoord(f+1)))&&i.call(this,t,e,r,n,y,a,o,s))return}},Vn.prototype._convertFromCellCoord=function(t){return (t-this.padding)/this.scale},Vn.prototype._convertToCellCoord=function(t){return Math.max(0,Math.min(this.d-1,Math.floor(t*this.scale)+this.padding))},Vn.prototype.toArrayBuffer=function(){if(this.arrayBuffer)return this.arrayBuffer;for(var t=this.cells,e=3+this.cells.length+1+1,r=0,n=0;n<this.cells.length;n++)r+=this.cells[n].length;var i=new Int32Array(e+r+this.keys.length+this.bboxes.length);i[0]=this.extent,i[1]=this.n,i[2]=this.padding;for(var a=e,o=0;o<t.length;o++){var s=t[o];i[3+o]=a,i.set(s,a),a+=s.length;}return i[3+t.length]=a,i.set(this.keys,a),i[3+t.length+1]=a+=this.keys.length,i.set(this.bboxes,a),a+=this.bboxes.length,i.buffer};var Fn=o.ImageData,Dn=o.ImageBitmap,Ln={};function On(t,e,r){void 0===r&&(r={}),Object.defineProperty(e,\"_classRegistryKey\",{value:t,writeable:!1}),Ln[t]={klass:e,omit:r.omit||[],shallow:r.shallow||[]};}for(var Rn in On(\"Object\",Object),Tn.serialize=function(t,e){var r=t.toArrayBuffer();return e&&e.push(r),{buffer:r}},Tn.deserialize=function(t){return new Tn(t.buffer)},On(\"Grid\",Tn),On(\"Color\",te),On(\"Error\",Error),On(\"ResolvedImage\",ie),On(\"StylePropertyFunction\",Yr),On(\"StyleExpression\",Kr,{omit:[\"_evaluator\"]}),On(\"ZoomDependentExpression\",Jr),On(\"ZoomConstantExpression\",Xr),On(\"CompoundExpression\",xe,{omit:[\"_evaluate\"]}),Ir)Ir[Rn]._classRegistryKey||On(\"Expression_\"+Rn,Ir[Rn]);function Un(t){return t&&\"undefined\"!=typeof ArrayBuffer&&(t instanceof ArrayBuffer||t.constructor&&\"ArrayBuffer\"===t.constructor.name)}function jn(t){return Dn&&t instanceof Dn}function qn(t,e){if(null==t||\"boolean\"==typeof t||\"number\"==typeof t||\"string\"==typeof t||t instanceof Boolean||t instanceof Number||t instanceof String||t instanceof Date||t instanceof RegExp)return t;if(Un(t)||jn(t))return e&&e.push(t),t;if(ArrayBuffer.isView(t)){var r=t;return e&&e.push(r.buffer),r}if(t instanceof Fn)return e&&e.push(t.data.buffer),t;if(Array.isArray(t)){for(var n=[],i=0,a=t;i<a.length;i+=1)n.push(qn(a[i],e));return n}if(\"object\"==typeof t){var o=t.constructor,s=o._classRegistryKey;if(!s)throw new Error(\"can't serialize object of unregistered class\");var u=o.serialize?o.serialize(t,e):{};if(!o.serialize){for(var l in t)if(t.hasOwnProperty(l)&&!(Ln[s].omit.indexOf(l)>=0)){var p=t[l];u[l]=Ln[s].shallow.indexOf(l)>=0?p:qn(p,e);}t instanceof Error&&(u.message=t.message);}if(u.$name)throw new Error(\"$name property is reserved for worker serialization logic.\");return \"Object\"!==s&&(u.$name=s),u}throw new Error(\"can't serialize object of type \"+typeof t)}function Nn(t){if(null==t||\"boolean\"==typeof t||\"number\"==typeof t||\"string\"==typeof t||t instanceof Boolean||t instanceof Number||t instanceof String||t instanceof Date||t instanceof RegExp||Un(t)||jn(t)||ArrayBuffer.isView(t)||t instanceof Fn)return t;if(Array.isArray(t))return t.map(Nn);if(\"object\"==typeof t){var e=t.$name||\"Object\",r=Ln[e].klass;if(!r)throw new Error(\"can't deserialize unregistered class \"+e);if(r.deserialize)return r.deserialize(t);for(var n=Object.create(r.prototype),i=0,a=Object.keys(t);i<a.length;i+=1){var o=a[i];if(\"$name\"!==o){var s=t[o];n[o]=Ln[e].shallow.indexOf(o)>=0?s:Nn(s);}}return n}throw new Error(\"can't deserialize object of type \"+typeof t)}var Kn=function(){this.first=!0;};Kn.prototype.update=function(t,e){var r=Math.floor(t);return this.first?(this.first=!1,this.lastIntegerZoom=r,this.lastIntegerZoomTime=0,this.lastZoom=t,this.lastFloorZoom=r,!0):(this.lastFloorZoom>r?(this.lastIntegerZoom=r+1,this.lastIntegerZoomTime=e):this.lastFloorZoom<r&&(this.lastIntegerZoom=r,this.lastIntegerZoomTime=e),t!==this.lastZoom&&(this.lastZoom=t,this.lastFloorZoom=r,!0))};var Gn={\"Latin-1 Supplement\":function(t){return t>=128&&t<=255},Arabic:function(t){return t>=1536&&t<=1791},\"Arabic Supplement\":function(t){return t>=1872&&t<=1919},\"Arabic Extended-A\":function(t){return t>=2208&&t<=2303},\"Hangul Jamo\":function(t){return t>=4352&&t<=4607},\"Unified Canadian Aboriginal Syllabics\":function(t){return t>=5120&&t<=5759},Khmer:function(t){return t>=6016&&t<=6143},\"Unified Canadian Aboriginal Syllabics Extended\":function(t){return t>=6320&&t<=6399},\"General Punctuation\":function(t){return t>=8192&&t<=8303},\"Letterlike Symbols\":function(t){return t>=8448&&t<=8527},\"Number Forms\":function(t){return t>=8528&&t<=8591},\"Miscellaneous Technical\":function(t){return t>=8960&&t<=9215},\"Control Pictures\":function(t){return t>=9216&&t<=9279},\"Optical Character Recognition\":function(t){return t>=9280&&t<=9311},\"Enclosed Alphanumerics\":function(t){return t>=9312&&t<=9471},\"Geometric Shapes\":function(t){return t>=9632&&t<=9727},\"Miscellaneous Symbols\":function(t){return t>=9728&&t<=9983},\"Miscellaneous Symbols and Arrows\":function(t){return t>=11008&&t<=11263},\"CJK Radicals Supplement\":function(t){return t>=11904&&t<=12031},\"Kangxi Radicals\":function(t){return t>=12032&&t<=12255},\"Ideographic Description Characters\":function(t){return t>=12272&&t<=12287},\"CJK Symbols and Punctuation\":function(t){return t>=12288&&t<=12351},Hiragana:function(t){return t>=12352&&t<=12447},Katakana:function(t){return t>=12448&&t<=12543},Bopomofo:function(t){return t>=12544&&t<=12591},\"Hangul Compatibility Jamo\":function(t){return t>=12592&&t<=12687},Kanbun:function(t){return t>=12688&&t<=12703},\"Bopomofo Extended\":function(t){return t>=12704&&t<=12735},\"CJK Strokes\":function(t){return t>=12736&&t<=12783},\"Katakana Phonetic Extensions\":function(t){return t>=12784&&t<=12799},\"Enclosed CJK Letters and Months\":function(t){return t>=12800&&t<=13055},\"CJK Compatibility\":function(t){return t>=13056&&t<=13311},\"CJK Unified Ideographs Extension A\":function(t){return t>=13312&&t<=19903},\"Yijing Hexagram Symbols\":function(t){return t>=19904&&t<=19967},\"CJK Unified Ideographs\":function(t){return t>=19968&&t<=40959},\"Yi Syllables\":function(t){return t>=40960&&t<=42127},\"Yi Radicals\":function(t){return t>=42128&&t<=42191},\"Hangul Jamo Extended-A\":function(t){return t>=43360&&t<=43391},\"Hangul Syllables\":function(t){return t>=44032&&t<=55215},\"Hangul Jamo Extended-B\":function(t){return t>=55216&&t<=55295},\"Private Use Area\":function(t){return t>=57344&&t<=63743},\"CJK Compatibility Ideographs\":function(t){return t>=63744&&t<=64255},\"Arabic Presentation Forms-A\":function(t){return t>=64336&&t<=65023},\"Vertical Forms\":function(t){return t>=65040&&t<=65055},\"CJK Compatibility Forms\":function(t){return t>=65072&&t<=65103},\"Small Form Variants\":function(t){return t>=65104&&t<=65135},\"Arabic Presentation Forms-B\":function(t){return t>=65136&&t<=65279},\"Halfwidth and Fullwidth Forms\":function(t){return t>=65280&&t<=65519}};function Zn(t){for(var e=0,r=t;e<r.length;e+=1)if(Xn(r[e].charCodeAt(0)))return !0;return !1}function Xn(t){return !(746!==t&&747!==t&&(t<4352||!(Gn[\"Bopomofo Extended\"](t)||Gn.Bopomofo(t)||Gn[\"CJK Compatibility Forms\"](t)&&!(t>=65097&&t<=65103)||Gn[\"CJK Compatibility Ideographs\"](t)||Gn[\"CJK Compatibility\"](t)||Gn[\"CJK Radicals Supplement\"](t)||Gn[\"CJK Strokes\"](t)||!(!Gn[\"CJK Symbols and Punctuation\"](t)||t>=12296&&t<=12305||t>=12308&&t<=12319||12336===t)||Gn[\"CJK Unified Ideographs Extension A\"](t)||Gn[\"CJK Unified Ideographs\"](t)||Gn[\"Enclosed CJK Letters and Months\"](t)||Gn[\"Hangul Compatibility Jamo\"](t)||Gn[\"Hangul Jamo Extended-A\"](t)||Gn[\"Hangul Jamo Extended-B\"](t)||Gn[\"Hangul Jamo\"](t)||Gn[\"Hangul Syllables\"](t)||Gn.Hiragana(t)||Gn[\"Ideographic Description Characters\"](t)||Gn.Kanbun(t)||Gn[\"Kangxi Radicals\"](t)||Gn[\"Katakana Phonetic Extensions\"](t)||Gn.Katakana(t)&&12540!==t||!(!Gn[\"Halfwidth and Fullwidth Forms\"](t)||65288===t||65289===t||65293===t||t>=65306&&t<=65310||65339===t||65341===t||65343===t||t>=65371&&t<=65503||65507===t||t>=65512&&t<=65519)||!(!Gn[\"Small Form Variants\"](t)||t>=65112&&t<=65118||t>=65123&&t<=65126)||Gn[\"Unified Canadian Aboriginal Syllabics\"](t)||Gn[\"Unified Canadian Aboriginal Syllabics Extended\"](t)||Gn[\"Vertical Forms\"](t)||Gn[\"Yijing Hexagram Symbols\"](t)||Gn[\"Yi Syllables\"](t)||Gn[\"Yi Radicals\"](t))))}function Jn(t){return !(Xn(t)||function(t){return !!(Gn[\"Latin-1 Supplement\"](t)&&(167===t||169===t||174===t||177===t||188===t||189===t||190===t||215===t||247===t)||Gn[\"General Punctuation\"](t)&&(8214===t||8224===t||8225===t||8240===t||8241===t||8251===t||8252===t||8258===t||8263===t||8264===t||8265===t||8273===t)||Gn[\"Letterlike Symbols\"](t)||Gn[\"Number Forms\"](t)||Gn[\"Miscellaneous Technical\"](t)&&(t>=8960&&t<=8967||t>=8972&&t<=8991||t>=8996&&t<=9e3||9003===t||t>=9085&&t<=9114||t>=9150&&t<=9165||9167===t||t>=9169&&t<=9179||t>=9186&&t<=9215)||Gn[\"Control Pictures\"](t)&&9251!==t||Gn[\"Optical Character Recognition\"](t)||Gn[\"Enclosed Alphanumerics\"](t)||Gn[\"Geometric Shapes\"](t)||Gn[\"Miscellaneous Symbols\"](t)&&!(t>=9754&&t<=9759)||Gn[\"Miscellaneous Symbols and Arrows\"](t)&&(t>=11026&&t<=11055||t>=11088&&t<=11097||t>=11192&&t<=11243)||Gn[\"CJK Symbols and Punctuation\"](t)||Gn.Katakana(t)||Gn[\"Private Use Area\"](t)||Gn[\"CJK Compatibility Forms\"](t)||Gn[\"Small Form Variants\"](t)||Gn[\"Halfwidth and Fullwidth Forms\"](t)||8734===t||8756===t||8757===t||t>=9984&&t<=10087||t>=10102&&t<=10131||65532===t||65533===t)}(t))}function Hn(t){return t>=1424&&t<=2303||Gn[\"Arabic Presentation Forms-A\"](t)||Gn[\"Arabic Presentation Forms-B\"](t)}function Yn(t,e){return !(!e&&Hn(t)||t>=2304&&t<=3583||t>=3840&&t<=4255||Gn.Khmer(t))}function $n(t){for(var e=0,r=t;e<r.length;e+=1)if(Hn(r[e].charCodeAt(0)))return !0;return !1}var Wn=null,Qn=\"unavailable\",ti=null,ei=function(t){t&&\"string\"==typeof t&&t.indexOf(\"NetworkError\")>-1&&(Qn=\"error\"),Wn&&Wn(t);};function ri(){ni.fire(new It(\"pluginStateChange\",{pluginStatus:Qn,pluginURL:ti}));}var ni=new Ct,ii=function(){return Qn},ai=function(){if(\"deferred\"!==Qn||!ti)throw new Error(\"rtl-text-plugin cannot be downloaded unless a pluginURL is specified\");Qn=\"loading\",ri(),ti&&bt({url:ti},(function(t){t?ei(t):(Qn=\"loaded\",ri());}));},oi={applyArabicShaping:null,processBidirectionalText:null,processStyledBidirectionalText:null,isLoaded:function(){return \"loaded\"===Qn||null!=oi.applyArabicShaping},isLoading:function(){return \"loading\"===Qn},setState:function(t){Qn=t.pluginStatus,ti=t.pluginURL;},isParsed:function(){return null!=oi.applyArabicShaping&&null!=oi.processBidirectionalText&&null!=oi.processStyledBidirectionalText},getPluginURL:function(){return ti}},si=function(t,e){this.zoom=t,e?(this.now=e.now,this.fadeDuration=e.fadeDuration,this.zoomHistory=e.zoomHistory,this.transition=e.transition):(this.now=0,this.fadeDuration=0,this.zoomHistory=new Kn,this.transition={});};si.prototype.isSupportedScript=function(t){return function(t,e){for(var r=0,n=t;r<n.length;r+=1)if(!Yn(n[r].charCodeAt(0),e))return !1;return !0}(t,oi.isLoaded())},si.prototype.crossFadingFactor=function(){return 0===this.fadeDuration?1:Math.min((this.now-this.zoomHistory.lastIntegerZoomTime)/this.fadeDuration,1)},si.prototype.getCrossfadeParameters=function(){var t=this.zoom,e=t-Math.floor(t),r=this.crossFadingFactor();return t>this.zoomHistory.lastIntegerZoom?{fromScale:2,toScale:1,t:e+(1-e)*r}:{fromScale:.5,toScale:1,t:1-(1-r)*e}};var ui=function(t,e){this.property=t,this.value=e,this.expression=function(t,e){if(Lr(t))return new Yr(t,e);if(Gr(t)){var r=Hr(t,e);if(\"error\"===r.result)throw new Error(r.value.map((function(t){return t.key+\": \"+t.message})).join(\", \"));return r.value}var n=t;return \"string\"==typeof t&&\"color\"===e.type&&(n=te.parse(t)),{kind:\"constant\",evaluate:function(){return n}}}(void 0===e?t.specification.default:e,t.specification);};ui.prototype.isDataDriven=function(){return \"source\"===this.expression.kind||\"composite\"===this.expression.kind},ui.prototype.possiblyEvaluate=function(t,e,r){return this.property.possiblyEvaluate(this,t,e,r)};var li=function(t){this.property=t,this.value=new ui(t,void 0);};li.prototype.transitioned=function(t,e){return new ci(this.property,this.value,e,h({},t.transition,this.transition),t.now)},li.prototype.untransitioned=function(){return new ci(this.property,this.value,null,{},0)};var pi=function(t){this._properties=t,this._values=Object.create(t.defaultTransitionablePropertyValues);};pi.prototype.getValue=function(t){return w(this._values[t].value.value)},pi.prototype.setValue=function(t,e){this._values.hasOwnProperty(t)||(this._values[t]=new li(this._values[t].property)),this._values[t].value=new ui(this._values[t].property,null===e?void 0:w(e));},pi.prototype.getTransition=function(t){return w(this._values[t].transition)},pi.prototype.setTransition=function(t,e){this._values.hasOwnProperty(t)||(this._values[t]=new li(this._values[t].property)),this._values[t].transition=w(e)||void 0;},pi.prototype.serialize=function(){for(var t={},e=0,r=Object.keys(this._values);e<r.length;e+=1){var n=r[e],i=this.getValue(n);void 0!==i&&(t[n]=i);var a=this.getTransition(n);void 0!==a&&(t[n+\"-transition\"]=a);}return t},pi.prototype.transitioned=function(t,e){for(var r=new hi(this._properties),n=0,i=Object.keys(this._values);n<i.length;n+=1){var a=i[n];r._values[a]=this._values[a].transitioned(t,e._values[a]);}return r},pi.prototype.untransitioned=function(){for(var t=new hi(this._properties),e=0,r=Object.keys(this._values);e<r.length;e+=1){var n=r[e];t._values[n]=this._values[n].untransitioned();}return t};var ci=function(t,e,r,n,i){this.property=t,this.value=e,this.begin=i+n.delay||0,this.end=this.begin+n.duration||0,t.specification.transition&&(n.delay||n.duration)&&(this.prior=r);};ci.prototype.possiblyEvaluate=function(t,e,r){var n=t.now||0,i=this.value.possiblyEvaluate(t,e,r),a=this.prior;if(a){if(n>this.end)return this.prior=null,i;if(this.value.isDataDriven())return this.prior=null,i;if(n<this.begin)return a.possiblyEvaluate(t,e,r);var o=(n-this.begin)/(this.end-this.begin);return this.property.interpolate(a.possiblyEvaluate(t,e,r),i,function(t){if(t<=0)return 0;if(t>=1)return 1;var e=t*t,r=e*t;return 4*(t<.5?r:3*(t-e)+r-.75)}(o))}return i};var hi=function(t){this._properties=t,this._values=Object.create(t.defaultTransitioningPropertyValues);};hi.prototype.possiblyEvaluate=function(t,e,r){for(var n=new di(this._properties),i=0,a=Object.keys(this._values);i<a.length;i+=1){var o=a[i];n._values[o]=this._values[o].possiblyEvaluate(t,e,r);}return n},hi.prototype.hasTransition=function(){for(var t=0,e=Object.keys(this._values);t<e.length;t+=1)if(this._values[e[t]].prior)return !0;return !1};var fi=function(t){this._properties=t,this._values=Object.create(t.defaultPropertyValues);};fi.prototype.getValue=function(t){return w(this._values[t].value)},fi.prototype.setValue=function(t,e){this._values[t]=new ui(this._values[t].property,null===e?void 0:w(e));},fi.prototype.serialize=function(){for(var t={},e=0,r=Object.keys(this._values);e<r.length;e+=1){var n=r[e],i=this.getValue(n);void 0!==i&&(t[n]=i);}return t},fi.prototype.possiblyEvaluate=function(t,e,r){for(var n=new di(this._properties),i=0,a=Object.keys(this._values);i<a.length;i+=1){var o=a[i];n._values[o]=this._values[o].possiblyEvaluate(t,e,r);}return n};var yi=function(t,e,r){this.property=t,this.value=e,this.parameters=r;};yi.prototype.isConstant=function(){return \"constant\"===this.value.kind},yi.prototype.constantOr=function(t){return \"constant\"===this.value.kind?this.value.value:t},yi.prototype.evaluate=function(t,e,r,n){return this.property.evaluate(this.value,this.parameters,t,e,r,n)};var di=function(t){this._properties=t,this._values=Object.create(t.defaultPossiblyEvaluatedValues);};di.prototype.get=function(t){return this._values[t]};var mi=function(t){this.specification=t;};mi.prototype.possiblyEvaluate=function(t,e){return t.expression.evaluate(e)},mi.prototype.interpolate=function(t,e,r){var n=Ge[this.specification.type];return n?n(t,e,r):t};var vi=function(t,e){this.specification=t,this.overrides=e;};vi.prototype.possiblyEvaluate=function(t,e,r,n){return new yi(this,\"constant\"===t.expression.kind||\"camera\"===t.expression.kind?{kind:\"constant\",value:t.expression.evaluate(e,null,{},r,n)}:t.expression,e)},vi.prototype.interpolate=function(t,e,r){if(\"constant\"!==t.value.kind||\"constant\"!==e.value.kind)return t;if(void 0===t.value.value||void 0===e.value.value)return new yi(this,{kind:\"constant\",value:void 0},t.parameters);var n=Ge[this.specification.type];return n?new yi(this,{kind:\"constant\",value:n(t.value.value,e.value.value,r)},t.parameters):t},vi.prototype.evaluate=function(t,e,r,n,i,a){return \"constant\"===t.kind?t.value:t.evaluate(e,r,n,i,a)};var gi=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.possiblyEvaluate=function(t,e,r,n){if(void 0===t.value)return new yi(this,{kind:\"constant\",value:void 0},e);if(\"constant\"===t.expression.kind){var i=t.expression.evaluate(e,null,{},r,n),a=\"resolvedImage\"===t.property.specification.type&&\"string\"!=typeof i?i.name:i,o=this._calculate(a,a,a,e);return new yi(this,{kind:\"constant\",value:o},e)}if(\"camera\"===t.expression.kind){var s=this._calculate(t.expression.evaluate({zoom:e.zoom-1}),t.expression.evaluate({zoom:e.zoom}),t.expression.evaluate({zoom:e.zoom+1}),e);return new yi(this,{kind:\"constant\",value:s},e)}return new yi(this,t.expression,e)},e.prototype.evaluate=function(t,e,r,n,i,a){if(\"source\"===t.kind){var o=t.evaluate(e,r,n,i,a);return this._calculate(o,o,o,e)}return \"composite\"===t.kind?this._calculate(t.evaluate({zoom:Math.floor(e.zoom)-1},r,n),t.evaluate({zoom:Math.floor(e.zoom)},r,n),t.evaluate({zoom:Math.floor(e.zoom)+1},r,n),e):t.value},e.prototype._calculate=function(t,e,r,n){return n.zoom>n.zoomHistory.lastIntegerZoom?{from:t,to:e}:{from:r,to:e}},e.prototype.interpolate=function(t){return t},e}(vi),xi=function(t){this.specification=t;};xi.prototype.possiblyEvaluate=function(t,e,r,n){if(void 0!==t.value){if(\"constant\"===t.expression.kind){var i=t.expression.evaluate(e,null,{},r,n);return this._calculate(i,i,i,e)}return this._calculate(t.expression.evaluate(new si(Math.floor(e.zoom-1),e)),t.expression.evaluate(new si(Math.floor(e.zoom),e)),t.expression.evaluate(new si(Math.floor(e.zoom+1),e)),e)}},xi.prototype._calculate=function(t,e,r,n){return n.zoom>n.zoomHistory.lastIntegerZoom?{from:t,to:e}:{from:r,to:e}},xi.prototype.interpolate=function(t){return t};var bi=function(t){this.specification=t;};bi.prototype.possiblyEvaluate=function(t,e,r,n){return !!t.expression.evaluate(e,null,{},r,n)},bi.prototype.interpolate=function(){return !1};var wi=function(t){for(var e in this.properties=t,this.defaultPropertyValues={},this.defaultTransitionablePropertyValues={},this.defaultTransitioningPropertyValues={},this.defaultPossiblyEvaluatedValues={},this.overridableProperties=[],t){var r=t[e];r.specification.overridable&&this.overridableProperties.push(e);var n=this.defaultPropertyValues[e]=new ui(r,void 0),i=this.defaultTransitionablePropertyValues[e]=new li(r);this.defaultTransitioningPropertyValues[e]=i.untransitioned(),this.defaultPossiblyEvaluatedValues[e]=n.possiblyEvaluate({});}};On(\"DataDrivenProperty\",vi),On(\"DataConstantProperty\",mi),On(\"CrossFadedDataDrivenProperty\",gi),On(\"CrossFadedProperty\",xi),On(\"ColorRampProperty\",bi);var _i=function(t){function e(e,r){if(t.call(this),this.id=e.id,this.type=e.type,this._featureFilter={filter:function(){return !0},needGeometry:!1},\"custom\"!==e.type&&(this.metadata=(e=e).metadata,this.minzoom=e.minzoom,this.maxzoom=e.maxzoom,\"background\"!==e.type&&(this.source=e.source,this.sourceLayer=e[\"source-layer\"],this.filter=e.filter),r.layout&&(this._unevaluatedLayout=new fi(r.layout)),r.paint)){for(var n in this._transitionablePaint=new pi(r.paint),e.paint)this.setPaintProperty(n,e.paint[n],{validate:!1});for(var i in e.layout)this.setLayoutProperty(i,e.layout[i],{validate:!1});this._transitioningPaint=this._transitionablePaint.untransitioned(),this.paint=new di(r.paint);}}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getCrossfadeParameters=function(){return this._crossfadeParameters},e.prototype.getLayoutProperty=function(t){return \"visibility\"===t?this.visibility:this._unevaluatedLayout.getValue(t)},e.prototype.setLayoutProperty=function(t,e,r){void 0===r&&(r={}),null!=e&&this._validate(Mn,\"layers.\"+this.id+\".layout.\"+t,t,e,r)||(\"visibility\"!==t?this._unevaluatedLayout.setValue(t,e):this.visibility=e);},e.prototype.getPaintProperty=function(t){return g(t,\"-transition\")?this._transitionablePaint.getTransition(t.slice(0,-\"-transition\".length)):this._transitionablePaint.getValue(t)},e.prototype.setPaintProperty=function(t,e,r){if(void 0===r&&(r={}),null!=e&&this._validate(Pn,\"layers.\"+this.id+\".paint.\"+t,t,e,r))return !1;if(g(t,\"-transition\"))return this._transitionablePaint.setTransition(t.slice(0,-\"-transition\".length),e||void 0),!1;var n=this._transitionablePaint._values[t],i=\"cross-faded-data-driven\"===n.property.specification[\"property-type\"],a=n.value.isDataDriven(),o=n.value;this._transitionablePaint.setValue(t,e),this._handleSpecialPaintPropertyUpdate(t);var s=this._transitionablePaint._values[t].value;return s.isDataDriven()||a||i||this._handleOverridablePaintPropertyUpdate(t,o,s)},e.prototype._handleSpecialPaintPropertyUpdate=function(t){},e.prototype._handleOverridablePaintPropertyUpdate=function(t,e,r){return !1},e.prototype.isHidden=function(t){return !!(this.minzoom&&t<this.minzoom)||!!(this.maxzoom&&t>=this.maxzoom)||\"none\"===this.visibility},e.prototype.updateTransitions=function(t){this._transitioningPaint=this._transitionablePaint.transitioned(t,this._transitioningPaint);},e.prototype.hasTransition=function(){return this._transitioningPaint.hasTransition()},e.prototype.recalculate=function(t,e){t.getCrossfadeParameters&&(this._crossfadeParameters=t.getCrossfadeParameters()),this._unevaluatedLayout&&(this.layout=this._unevaluatedLayout.possiblyEvaluate(t,void 0,e)),this.paint=this._transitioningPaint.possiblyEvaluate(t,void 0,e);},e.prototype.serialize=function(){var t={id:this.id,type:this.type,source:this.source,\"source-layer\":this.sourceLayer,metadata:this.metadata,minzoom:this.minzoom,maxzoom:this.maxzoom,filter:this.filter,layout:this._unevaluatedLayout&&this._unevaluatedLayout.serialize(),paint:this._transitionablePaint&&this._transitionablePaint.serialize()};return this.visibility&&(t.layout=t.layout||{},t.layout.visibility=this.visibility),b(t,(function(t,e){return !(void 0===t||\"layout\"===e&&!Object.keys(t).length||\"paint\"===e&&!Object.keys(t).length)}))},e.prototype._validate=function(t,e,r,n,i){return void 0===i&&(i={}),(!i||!1!==i.validate)&&Bn(this,t.call(Cn,{key:e,layerType:this.type,objectKey:r,value:n,styleSpec:Et,style:{glyphs:!0,sprite:!0}}))},e.prototype.is3D=function(){return !1},e.prototype.isTileClipped=function(){return !1},e.prototype.hasOffscreenPass=function(){return !1},e.prototype.resize=function(){},e.prototype.isStateDependent=function(){for(var t in this.paint._values){var e=this.paint.get(t);if(e instanceof yi&&Tr(e.property.specification)&&(\"source\"===e.value.kind||\"composite\"===e.value.kind)&&e.value.isStateDependent)return !0}return !1},e}(Ct),Ai={Int8:Int8Array,Uint8:Uint8Array,Int16:Int16Array,Uint16:Uint16Array,Int32:Int32Array,Uint32:Uint32Array,Float32:Float32Array},Si=function(t,e){this._structArray=t,this._pos1=e*this.size,this._pos2=this._pos1/2,this._pos4=this._pos1/4,this._pos8=this._pos1/8;},ki=function(){this.isTransferred=!1,this.capacity=-1,this.resize(0);};function Ii(t,e){void 0===e&&(e=1);var r=0,n=0;return {members:t.map((function(t){var i=Ai[t.type].BYTES_PER_ELEMENT,a=r=zi(r,Math.max(e,i)),o=t.components||1;return n=Math.max(n,i),r+=i*o,{name:t.name,type:t.type,components:o,offset:a}})),size:zi(r,Math.max(n,e)),alignment:e}}function zi(t,e){return Math.ceil(t/e)*e}ki.serialize=function(t,e){return t._trim(),e&&(t.isTransferred=!0,e.push(t.arrayBuffer)),{length:t.length,arrayBuffer:t.arrayBuffer}},ki.deserialize=function(t){var e=Object.create(this.prototype);return e.arrayBuffer=t.arrayBuffer,e.length=t.length,e.capacity=t.arrayBuffer.byteLength/e.bytesPerElement,e._refreshViews(),e},ki.prototype._trim=function(){this.length!==this.capacity&&(this.capacity=this.length,this.arrayBuffer=this.arrayBuffer.slice(0,this.length*this.bytesPerElement),this._refreshViews());},ki.prototype.clear=function(){this.length=0;},ki.prototype.resize=function(t){this.reserve(t),this.length=t;},ki.prototype.reserve=function(t){if(t>this.capacity){this.capacity=Math.max(t,Math.floor(5*this.capacity),128),this.arrayBuffer=new ArrayBuffer(this.capacity*this.bytesPerElement);var e=this.uint8;this._refreshViews(),e&&this.uint8.set(e);}},ki.prototype._refreshViews=function(){throw new Error(\"_refreshViews() must be implemented by each concrete StructArray layout\")};var Ci=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e){var r=this.length;return this.resize(r+1),this.emplace(r,t,e)},e.prototype.emplace=function(t,e,r){var n=2*t;return this.int16[n+0]=e,this.int16[n+1]=r,t},e}(ki);Ci.prototype.bytesPerElement=4,On(\"StructArrayLayout2i4\",Ci);var Ei=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r,n){var i=this.length;return this.resize(i+1),this.emplace(i,t,e,r,n)},e.prototype.emplace=function(t,e,r,n,i){var a=4*t;return this.int16[a+0]=e,this.int16[a+1]=r,this.int16[a+2]=n,this.int16[a+3]=i,t},e}(ki);Ei.prototype.bytesPerElement=8,On(\"StructArrayLayout4i8\",Ei);var Pi=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r,n,i,a){var o=this.length;return this.resize(o+1),this.emplace(o,t,e,r,n,i,a)},e.prototype.emplace=function(t,e,r,n,i,a,o){var s=6*t;return this.int16[s+0]=e,this.int16[s+1]=r,this.int16[s+2]=n,this.int16[s+3]=i,this.int16[s+4]=a,this.int16[s+5]=o,t},e}(ki);Pi.prototype.bytesPerElement=12,On(\"StructArrayLayout2i4i12\",Pi);var Mi=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r,n,i,a){var o=this.length;return this.resize(o+1),this.emplace(o,t,e,r,n,i,a)},e.prototype.emplace=function(t,e,r,n,i,a,o){var s=4*t,u=8*t;return this.int16[s+0]=e,this.int16[s+1]=r,this.uint8[u+4]=n,this.uint8[u+5]=i,this.uint8[u+6]=a,this.uint8[u+7]=o,t},e}(ki);Mi.prototype.bytesPerElement=8,On(\"StructArrayLayout2i4ub8\",Mi);var Bi=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e){var r=this.length;return this.resize(r+1),this.emplace(r,t,e)},e.prototype.emplace=function(t,e,r){var n=2*t;return this.float32[n+0]=e,this.float32[n+1]=r,t},e}(ki);Bi.prototype.bytesPerElement=8,On(\"StructArrayLayout2f8\",Bi);var Ti=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r,n,i,a,o,s,u,l){var p=this.length;return this.resize(p+1),this.emplace(p,t,e,r,n,i,a,o,s,u,l)},e.prototype.emplace=function(t,e,r,n,i,a,o,s,u,l,p){var c=10*t;return this.uint16[c+0]=e,this.uint16[c+1]=r,this.uint16[c+2]=n,this.uint16[c+3]=i,this.uint16[c+4]=a,this.uint16[c+5]=o,this.uint16[c+6]=s,this.uint16[c+7]=u,this.uint16[c+8]=l,this.uint16[c+9]=p,t},e}(ki);Ti.prototype.bytesPerElement=20,On(\"StructArrayLayout10ui20\",Ti);var Vi=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r,n,i,a,o,s,u,l,p,c){var h=this.length;return this.resize(h+1),this.emplace(h,t,e,r,n,i,a,o,s,u,l,p,c)},e.prototype.emplace=function(t,e,r,n,i,a,o,s,u,l,p,c,h){var f=12*t;return this.int16[f+0]=e,this.int16[f+1]=r,this.int16[f+2]=n,this.int16[f+3]=i,this.uint16[f+4]=a,this.uint16[f+5]=o,this.uint16[f+6]=s,this.uint16[f+7]=u,this.int16[f+8]=l,this.int16[f+9]=p,this.int16[f+10]=c,this.int16[f+11]=h,t},e}(ki);Vi.prototype.bytesPerElement=24,On(\"StructArrayLayout4i4ui4i24\",Vi);var Fi=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r){var n=this.length;return this.resize(n+1),this.emplace(n,t,e,r)},e.prototype.emplace=function(t,e,r,n){var i=3*t;return this.float32[i+0]=e,this.float32[i+1]=r,this.float32[i+2]=n,t},e}(ki);Fi.prototype.bytesPerElement=12,On(\"StructArrayLayout3f12\",Fi);var Di=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.uint32=new Uint32Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t){var e=this.length;return this.resize(e+1),this.emplace(e,t)},e.prototype.emplace=function(t,e){return this.uint32[1*t+0]=e,t},e}(ki);Di.prototype.bytesPerElement=4,On(\"StructArrayLayout1ul4\",Di);var Li=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer),this.uint32=new Uint32Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r,n,i,a,o,s,u){var l=this.length;return this.resize(l+1),this.emplace(l,t,e,r,n,i,a,o,s,u)},e.prototype.emplace=function(t,e,r,n,i,a,o,s,u,l){var p=10*t,c=5*t;return this.int16[p+0]=e,this.int16[p+1]=r,this.int16[p+2]=n,this.int16[p+3]=i,this.int16[p+4]=a,this.int16[p+5]=o,this.uint32[c+3]=s,this.uint16[p+8]=u,this.uint16[p+9]=l,t},e}(ki);Li.prototype.bytesPerElement=20,On(\"StructArrayLayout6i1ul2ui20\",Li);var Oi=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r,n,i,a){var o=this.length;return this.resize(o+1),this.emplace(o,t,e,r,n,i,a)},e.prototype.emplace=function(t,e,r,n,i,a,o){var s=6*t;return this.int16[s+0]=e,this.int16[s+1]=r,this.int16[s+2]=n,this.int16[s+3]=i,this.int16[s+4]=a,this.int16[s+5]=o,t},e}(ki);Oi.prototype.bytesPerElement=12,On(\"StructArrayLayout2i2i2i12\",Oi);var Ri=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r,n,i){var a=this.length;return this.resize(a+1),this.emplace(a,t,e,r,n,i)},e.prototype.emplace=function(t,e,r,n,i,a){var o=4*t,s=8*t;return this.float32[o+0]=e,this.float32[o+1]=r,this.float32[o+2]=n,this.int16[s+6]=i,this.int16[s+7]=a,t},e}(ki);Ri.prototype.bytesPerElement=16,On(\"StructArrayLayout2f1f2i16\",Ri);var Ui=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r,n){var i=this.length;return this.resize(i+1),this.emplace(i,t,e,r,n)},e.prototype.emplace=function(t,e,r,n,i){var a=12*t,o=3*t;return this.uint8[a+0]=e,this.uint8[a+1]=r,this.float32[o+1]=n,this.float32[o+2]=i,t},e}(ki);Ui.prototype.bytesPerElement=12,On(\"StructArrayLayout2ub2f12\",Ui);var ji=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r){var n=this.length;return this.resize(n+1),this.emplace(n,t,e,r)},e.prototype.emplace=function(t,e,r,n){var i=3*t;return this.uint16[i+0]=e,this.uint16[i+1]=r,this.uint16[i+2]=n,t},e}(ki);ji.prototype.bytesPerElement=6,On(\"StructArrayLayout3ui6\",ji);var qi=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer),this.uint32=new Uint32Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r,n,i,a,o,s,u,l,p,c,h,f,y,d,m){var v=this.length;return this.resize(v+1),this.emplace(v,t,e,r,n,i,a,o,s,u,l,p,c,h,f,y,d,m)},e.prototype.emplace=function(t,e,r,n,i,a,o,s,u,l,p,c,h,f,y,d,m,v){var g=24*t,x=12*t,b=48*t;return this.int16[g+0]=e,this.int16[g+1]=r,this.uint16[g+2]=n,this.uint16[g+3]=i,this.uint32[x+2]=a,this.uint32[x+3]=o,this.uint32[x+4]=s,this.uint16[g+10]=u,this.uint16[g+11]=l,this.uint16[g+12]=p,this.float32[x+7]=c,this.float32[x+8]=h,this.uint8[b+36]=f,this.uint8[b+37]=y,this.uint8[b+38]=d,this.uint32[x+10]=m,this.int16[g+22]=v,t},e}(ki);qi.prototype.bytesPerElement=48,On(\"StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48\",qi);var Ni=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer),this.uint32=new Uint32Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r,n,i,a,o,s,u,l,p,c,h,f,y,d,m,v,g,x,b,w,_,A,S,k,I,z){var C=this.length;return this.resize(C+1),this.emplace(C,t,e,r,n,i,a,o,s,u,l,p,c,h,f,y,d,m,v,g,x,b,w,_,A,S,k,I,z)},e.prototype.emplace=function(t,e,r,n,i,a,o,s,u,l,p,c,h,f,y,d,m,v,g,x,b,w,_,A,S,k,I,z,C){var E=34*t,P=17*t;return this.int16[E+0]=e,this.int16[E+1]=r,this.int16[E+2]=n,this.int16[E+3]=i,this.int16[E+4]=a,this.int16[E+5]=o,this.int16[E+6]=s,this.int16[E+7]=u,this.uint16[E+8]=l,this.uint16[E+9]=p,this.uint16[E+10]=c,this.uint16[E+11]=h,this.uint16[E+12]=f,this.uint16[E+13]=y,this.uint16[E+14]=d,this.uint16[E+15]=m,this.uint16[E+16]=v,this.uint16[E+17]=g,this.uint16[E+18]=x,this.uint16[E+19]=b,this.uint16[E+20]=w,this.uint16[E+21]=_,this.uint16[E+22]=A,this.uint32[P+12]=S,this.float32[P+13]=k,this.float32[P+14]=I,this.float32[P+15]=z,this.float32[P+16]=C,t},e}(ki);Ni.prototype.bytesPerElement=68,On(\"StructArrayLayout8i15ui1ul4f68\",Ni);var Ki=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t){var e=this.length;return this.resize(e+1),this.emplace(e,t)},e.prototype.emplace=function(t,e){return this.float32[1*t+0]=e,t},e}(ki);Ki.prototype.bytesPerElement=4,On(\"StructArrayLayout1f4\",Ki);var Gi=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.int16=new Int16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r){var n=this.length;return this.resize(n+1),this.emplace(n,t,e,r)},e.prototype.emplace=function(t,e,r,n){var i=3*t;return this.int16[i+0]=e,this.int16[i+1]=r,this.int16[i+2]=n,t},e}(ki);Gi.prototype.bytesPerElement=6,On(\"StructArrayLayout3i6\",Gi);var Zi=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.uint32=new Uint32Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r){var n=this.length;return this.resize(n+1),this.emplace(n,t,e,r)},e.prototype.emplace=function(t,e,r,n){var i=4*t;return this.uint32[2*t+0]=e,this.uint16[i+2]=r,this.uint16[i+3]=n,t},e}(ki);Zi.prototype.bytesPerElement=8,On(\"StructArrayLayout1ul2ui8\",Zi);var Xi=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e){var r=this.length;return this.resize(r+1),this.emplace(r,t,e)},e.prototype.emplace=function(t,e,r){var n=2*t;return this.uint16[n+0]=e,this.uint16[n+1]=r,t},e}(ki);Xi.prototype.bytesPerElement=4,On(\"StructArrayLayout2ui4\",Xi);var Ji=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.uint16=new Uint16Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t){var e=this.length;return this.resize(e+1),this.emplace(e,t)},e.prototype.emplace=function(t,e){return this.uint16[1*t+0]=e,t},e}(ki);Ji.prototype.bytesPerElement=2,On(\"StructArrayLayout1ui2\",Ji);var Hi=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._refreshViews=function(){this.uint8=new Uint8Array(this.arrayBuffer),this.float32=new Float32Array(this.arrayBuffer);},e.prototype.emplaceBack=function(t,e,r,n){var i=this.length;return this.resize(i+1),this.emplace(i,t,e,r,n)},e.prototype.emplace=function(t,e,r,n,i){var a=4*t;return this.float32[a+0]=e,this.float32[a+1]=r,this.float32[a+2]=n,this.float32[a+3]=i,t},e}(ki);Hi.prototype.bytesPerElement=16,On(\"StructArrayLayout4f16\",Hi);var Yi=function(t){function e(){t.apply(this,arguments);}t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e;var r={anchorPointX:{configurable:!0},anchorPointY:{configurable:!0},x1:{configurable:!0},y1:{configurable:!0},x2:{configurable:!0},y2:{configurable:!0},featureIndex:{configurable:!0},sourceLayerIndex:{configurable:!0},bucketIndex:{configurable:!0},anchorPoint:{configurable:!0}};return r.anchorPointX.get=function(){return this._structArray.int16[this._pos2+0]},r.anchorPointY.get=function(){return this._structArray.int16[this._pos2+1]},r.x1.get=function(){return this._structArray.int16[this._pos2+2]},r.y1.get=function(){return this._structArray.int16[this._pos2+3]},r.x2.get=function(){return this._structArray.int16[this._pos2+4]},r.y2.get=function(){return this._structArray.int16[this._pos2+5]},r.featureIndex.get=function(){return this._structArray.uint32[this._pos4+3]},r.sourceLayerIndex.get=function(){return this._structArray.uint16[this._pos2+8]},r.bucketIndex.get=function(){return this._structArray.uint16[this._pos2+9]},r.anchorPoint.get=function(){return new i(this.anchorPointX,this.anchorPointY)},Object.defineProperties(e.prototype,r),e}(Si);Yi.prototype.size=20;var $i=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.get=function(t){return new Yi(this,t)},e}(Li);On(\"CollisionBoxArray\",$i);var Wi=function(t){function e(){t.apply(this,arguments);}t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e;var r={anchorX:{configurable:!0},anchorY:{configurable:!0},glyphStartIndex:{configurable:!0},numGlyphs:{configurable:!0},vertexStartIndex:{configurable:!0},lineStartIndex:{configurable:!0},lineLength:{configurable:!0},segment:{configurable:!0},lowerSize:{configurable:!0},upperSize:{configurable:!0},lineOffsetX:{configurable:!0},lineOffsetY:{configurable:!0},writingMode:{configurable:!0},placedOrientation:{configurable:!0},hidden:{configurable:!0},crossTileID:{configurable:!0},associatedIconIndex:{configurable:!0}};return r.anchorX.get=function(){return this._structArray.int16[this._pos2+0]},r.anchorY.get=function(){return this._structArray.int16[this._pos2+1]},r.glyphStartIndex.get=function(){return this._structArray.uint16[this._pos2+2]},r.numGlyphs.get=function(){return this._structArray.uint16[this._pos2+3]},r.vertexStartIndex.get=function(){return this._structArray.uint32[this._pos4+2]},r.lineStartIndex.get=function(){return this._structArray.uint32[this._pos4+3]},r.lineLength.get=function(){return this._structArray.uint32[this._pos4+4]},r.segment.get=function(){return this._structArray.uint16[this._pos2+10]},r.lowerSize.get=function(){return this._structArray.uint16[this._pos2+11]},r.upperSize.get=function(){return this._structArray.uint16[this._pos2+12]},r.lineOffsetX.get=function(){return this._structArray.float32[this._pos4+7]},r.lineOffsetY.get=function(){return this._structArray.float32[this._pos4+8]},r.writingMode.get=function(){return this._structArray.uint8[this._pos1+36]},r.placedOrientation.get=function(){return this._structArray.uint8[this._pos1+37]},r.placedOrientation.set=function(t){this._structArray.uint8[this._pos1+37]=t;},r.hidden.get=function(){return this._structArray.uint8[this._pos1+38]},r.hidden.set=function(t){this._structArray.uint8[this._pos1+38]=t;},r.crossTileID.get=function(){return this._structArray.uint32[this._pos4+10]},r.crossTileID.set=function(t){this._structArray.uint32[this._pos4+10]=t;},r.associatedIconIndex.get=function(){return this._structArray.int16[this._pos2+22]},Object.defineProperties(e.prototype,r),e}(Si);Wi.prototype.size=48;var Qi=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.get=function(t){return new Wi(this,t)},e}(qi);On(\"PlacedSymbolArray\",Qi);var ta=function(t){function e(){t.apply(this,arguments);}t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e;var r={anchorX:{configurable:!0},anchorY:{configurable:!0},rightJustifiedTextSymbolIndex:{configurable:!0},centerJustifiedTextSymbolIndex:{configurable:!0},leftJustifiedTextSymbolIndex:{configurable:!0},verticalPlacedTextSymbolIndex:{configurable:!0},placedIconSymbolIndex:{configurable:!0},verticalPlacedIconSymbolIndex:{configurable:!0},key:{configurable:!0},textBoxStartIndex:{configurable:!0},textBoxEndIndex:{configurable:!0},verticalTextBoxStartIndex:{configurable:!0},verticalTextBoxEndIndex:{configurable:!0},iconBoxStartIndex:{configurable:!0},iconBoxEndIndex:{configurable:!0},verticalIconBoxStartIndex:{configurable:!0},verticalIconBoxEndIndex:{configurable:!0},featureIndex:{configurable:!0},numHorizontalGlyphVertices:{configurable:!0},numVerticalGlyphVertices:{configurable:!0},numIconVertices:{configurable:!0},numVerticalIconVertices:{configurable:!0},useRuntimeCollisionCircles:{configurable:!0},crossTileID:{configurable:!0},textBoxScale:{configurable:!0},textOffset0:{configurable:!0},textOffset1:{configurable:!0},collisionCircleDiameter:{configurable:!0}};return r.anchorX.get=function(){return this._structArray.int16[this._pos2+0]},r.anchorY.get=function(){return this._structArray.int16[this._pos2+1]},r.rightJustifiedTextSymbolIndex.get=function(){return this._structArray.int16[this._pos2+2]},r.centerJustifiedTextSymbolIndex.get=function(){return this._structArray.int16[this._pos2+3]},r.leftJustifiedTextSymbolIndex.get=function(){return this._structArray.int16[this._pos2+4]},r.verticalPlacedTextSymbolIndex.get=function(){return this._structArray.int16[this._pos2+5]},r.placedIconSymbolIndex.get=function(){return this._structArray.int16[this._pos2+6]},r.verticalPlacedIconSymbolIndex.get=function(){return this._structArray.int16[this._pos2+7]},r.key.get=function(){return this._structArray.uint16[this._pos2+8]},r.textBoxStartIndex.get=function(){return this._structArray.uint16[this._pos2+9]},r.textBoxEndIndex.get=function(){return this._structArray.uint16[this._pos2+10]},r.verticalTextBoxStartIndex.get=function(){return this._structArray.uint16[this._pos2+11]},r.verticalTextBoxEndIndex.get=function(){return this._structArray.uint16[this._pos2+12]},r.iconBoxStartIndex.get=function(){return this._structArray.uint16[this._pos2+13]},r.iconBoxEndIndex.get=function(){return this._structArray.uint16[this._pos2+14]},r.verticalIconBoxStartIndex.get=function(){return this._structArray.uint16[this._pos2+15]},r.verticalIconBoxEndIndex.get=function(){return this._structArray.uint16[this._pos2+16]},r.featureIndex.get=function(){return this._structArray.uint16[this._pos2+17]},r.numHorizontalGlyphVertices.get=function(){return this._structArray.uint16[this._pos2+18]},r.numVerticalGlyphVertices.get=function(){return this._structArray.uint16[this._pos2+19]},r.numIconVertices.get=function(){return this._structArray.uint16[this._pos2+20]},r.numVerticalIconVertices.get=function(){return this._structArray.uint16[this._pos2+21]},r.useRuntimeCollisionCircles.get=function(){return this._structArray.uint16[this._pos2+22]},r.crossTileID.get=function(){return this._structArray.uint32[this._pos4+12]},r.crossTileID.set=function(t){this._structArray.uint32[this._pos4+12]=t;},r.textBoxScale.get=function(){return this._structArray.float32[this._pos4+13]},r.textOffset0.get=function(){return this._structArray.float32[this._pos4+14]},r.textOffset1.get=function(){return this._structArray.float32[this._pos4+15]},r.collisionCircleDiameter.get=function(){return this._structArray.float32[this._pos4+16]},Object.defineProperties(e.prototype,r),e}(Si);ta.prototype.size=68;var ea=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.get=function(t){return new ta(this,t)},e}(Ni);On(\"SymbolInstanceArray\",ea);var ra=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getoffsetX=function(t){return this.float32[1*t+0]},e}(Ki);On(\"GlyphOffsetArray\",ra);var na=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getx=function(t){return this.int16[3*t+0]},e.prototype.gety=function(t){return this.int16[3*t+1]},e.prototype.gettileUnitDistanceFromAnchor=function(t){return this.int16[3*t+2]},e}(Gi);On(\"SymbolLineVertexArray\",na);var ia=function(t){function e(){t.apply(this,arguments);}t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e;var r={featureIndex:{configurable:!0},sourceLayerIndex:{configurable:!0},bucketIndex:{configurable:!0}};return r.featureIndex.get=function(){return this._structArray.uint32[this._pos4+0]},r.sourceLayerIndex.get=function(){return this._structArray.uint16[this._pos2+2]},r.bucketIndex.get=function(){return this._structArray.uint16[this._pos2+3]},Object.defineProperties(e.prototype,r),e}(Si);ia.prototype.size=8;var aa=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.get=function(t){return new ia(this,t)},e}(Zi);On(\"FeatureIndexArray\",aa);var oa=Ii([{name:\"a_pos\",components:2,type:\"Int16\"}],4).members,sa=function(t){void 0===t&&(t=[]),this.segments=t;};function ua(t,e){return 256*(t=p(Math.floor(t),0,255))+p(Math.floor(e),0,255)}sa.prototype.prepareSegment=function(t,e,r,n){var i=this.segments[this.segments.length-1];return t>sa.MAX_VERTEX_ARRAY_LENGTH&&A(\"Max vertices per segment is \"+sa.MAX_VERTEX_ARRAY_LENGTH+\": bucket requested \"+t),(!i||i.vertexLength+t>sa.MAX_VERTEX_ARRAY_LENGTH||i.sortKey!==n)&&(i={vertexOffset:e.length,primitiveOffset:r.length,vertexLength:0,primitiveLength:0},void 0!==n&&(i.sortKey=n),this.segments.push(i)),i},sa.prototype.get=function(){return this.segments},sa.prototype.destroy=function(){for(var t=0,e=this.segments;t<e.length;t+=1){var r=e[t];for(var n in r.vaos)r.vaos[n].destroy();}},sa.simpleSegment=function(t,e,r,n){return new sa([{vertexOffset:t,primitiveOffset:e,vertexLength:r,primitiveLength:n,vaos:{},sortKey:0}])},sa.MAX_VERTEX_ARRAY_LENGTH=Math.pow(2,16)-1,On(\"SegmentVector\",sa);var la=Ii([{name:\"a_pattern_from\",components:4,type:\"Uint16\"},{name:\"a_pattern_to\",components:4,type:\"Uint16\"},{name:\"a_pixel_ratio_from\",components:1,type:\"Uint16\"},{name:\"a_pixel_ratio_to\",components:1,type:\"Uint16\"}]),pa=e((function(t){t.exports=function(t,e){var r,n,i,a,o,s,u,l;for(n=t.length-(r=3&t.length),i=e,o=3432918353,s=461845907,l=0;l<n;)u=255&t.charCodeAt(l)|(255&t.charCodeAt(++l))<<8|(255&t.charCodeAt(++l))<<16|(255&t.charCodeAt(++l))<<24,++l,i=27492+(65535&(a=5*(65535&(i=(i^=u=(65535&(u=(u=(65535&u)*o+(((u>>>16)*o&65535)<<16)&4294967295)<<15|u>>>17))*s+(((u>>>16)*s&65535)<<16)&4294967295)<<13|i>>>19))+((5*(i>>>16)&65535)<<16)&4294967295))+((58964+(a>>>16)&65535)<<16);switch(u=0,r){case 3:u^=(255&t.charCodeAt(l+2))<<16;case 2:u^=(255&t.charCodeAt(l+1))<<8;case 1:i^=u=(65535&(u=(u=(65535&(u^=255&t.charCodeAt(l)))*o+(((u>>>16)*o&65535)<<16)&4294967295)<<15|u>>>17))*s+(((u>>>16)*s&65535)<<16)&4294967295;}return i^=t.length,i=2246822507*(65535&(i^=i>>>16))+((2246822507*(i>>>16)&65535)<<16)&4294967295,i=3266489909*(65535&(i^=i>>>13))+((3266489909*(i>>>16)&65535)<<16)&4294967295,(i^=i>>>16)>>>0};})),ca=e((function(t){t.exports=function(t,e){for(var r,n=t.length,i=e^n,a=0;n>=4;)r=1540483477*(65535&(r=255&t.charCodeAt(a)|(255&t.charCodeAt(++a))<<8|(255&t.charCodeAt(++a))<<16|(255&t.charCodeAt(++a))<<24))+((1540483477*(r>>>16)&65535)<<16),i=1540483477*(65535&i)+((1540483477*(i>>>16)&65535)<<16)^(r=1540483477*(65535&(r^=r>>>24))+((1540483477*(r>>>16)&65535)<<16)),n-=4,++a;switch(n){case 3:i^=(255&t.charCodeAt(a+2))<<16;case 2:i^=(255&t.charCodeAt(a+1))<<8;case 1:i=1540483477*(65535&(i^=255&t.charCodeAt(a)))+((1540483477*(i>>>16)&65535)<<16);}return i=1540483477*(65535&(i^=i>>>13))+((1540483477*(i>>>16)&65535)<<16),(i^=i>>>15)>>>0};})),ha=pa,fa=ca;ha.murmur3=pa,ha.murmur2=fa;var ya=function(){this.ids=[],this.positions=[],this.indexed=!1;};ya.prototype.add=function(t,e,r,n){this.ids.push(ma(t)),this.positions.push(e,r,n);},ya.prototype.getPositions=function(t){for(var e=ma(t),r=0,n=this.ids.length-1;r<n;){var i=r+n>>1;this.ids[i]>=e?n=i:r=i+1;}for(var a=[];this.ids[r]===e;)a.push({index:this.positions[3*r],start:this.positions[3*r+1],end:this.positions[3*r+2]}),r++;return a},ya.serialize=function(t,e){var r=new Float64Array(t.ids),n=new Uint32Array(t.positions);return function t(e,r,n,i){for(;n<i;){for(var a=e[n+i>>1],o=n-1,s=i+1;;){do{o++;}while(e[o]<a);do{s--;}while(e[s]>a);if(o>=s)break;va(e,o,s),va(r,3*o,3*s),va(r,3*o+1,3*s+1),va(r,3*o+2,3*s+2);}s-n<i-s?(t(e,r,n,s),n=s+1):(t(e,r,s+1,i),i=s);}}(r,n,0,r.length-1),e&&e.push(r.buffer,n.buffer),{ids:r,positions:n}},ya.deserialize=function(t){var e=new ya;return e.ids=t.ids,e.positions=t.positions,e.indexed=!0,e};var da=Math.pow(2,53)-1;function ma(t){var e=+t;return !isNaN(e)&&e<=da?e:ha(String(t))}function va(t,e,r){var n=t[e];t[e]=t[r],t[r]=n;}On(\"FeaturePositionMap\",ya);var ga=function(t,e){this.gl=t.gl,this.location=e;},xa=function(t){function e(e,r){t.call(this,e,r),this.current=0;}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){this.current!==t&&(this.current=t,this.gl.uniform1i(this.location,t));},e}(ga),ba=function(t){function e(e,r){t.call(this,e,r),this.current=0;}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){this.current!==t&&(this.current=t,this.gl.uniform1f(this.location,t));},e}(ga),wa=function(t){function e(e,r){t.call(this,e,r),this.current=[0,0];}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){t[0]===this.current[0]&&t[1]===this.current[1]||(this.current=t,this.gl.uniform2f(this.location,t[0],t[1]));},e}(ga),_a=function(t){function e(e,r){t.call(this,e,r),this.current=[0,0,0];}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){t[0]===this.current[0]&&t[1]===this.current[1]&&t[2]===this.current[2]||(this.current=t,this.gl.uniform3f(this.location,t[0],t[1],t[2]));},e}(ga),Aa=function(t){function e(e,r){t.call(this,e,r),this.current=[0,0,0,0];}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){t[0]===this.current[0]&&t[1]===this.current[1]&&t[2]===this.current[2]&&t[3]===this.current[3]||(this.current=t,this.gl.uniform4f(this.location,t[0],t[1],t[2],t[3]));},e}(ga),Sa=function(t){function e(e,r){t.call(this,e,r),this.current=te.transparent;}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){t.r===this.current.r&&t.g===this.current.g&&t.b===this.current.b&&t.a===this.current.a||(this.current=t,this.gl.uniform4f(this.location,t.r,t.g,t.b,t.a));},e}(ga),ka=new Float32Array(16),Ia=function(t){function e(e,r){t.call(this,e,r),this.current=ka;}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){if(t[12]!==this.current[12]||t[0]!==this.current[0])return this.current=t,void this.gl.uniformMatrix4fv(this.location,!1,t);for(var e=1;e<16;e++)if(t[e]!==this.current[e]){this.current=t,this.gl.uniformMatrix4fv(this.location,!1,t);break}},e}(ga);function za(t){return [ua(255*t.r,255*t.g),ua(255*t.b,255*t.a)]}var Ca=function(t,e,r){this.value=t,this.uniformNames=e.map((function(t){return \"u_\"+t})),this.type=r;};Ca.prototype.setUniform=function(t,e,r){t.set(r.constantOr(this.value));},Ca.prototype.getBinding=function(t,e,r){return \"color\"===this.type?new Sa(t,e):new ba(t,e)};var Ea=function(t,e){this.uniformNames=e.map((function(t){return \"u_\"+t})),this.patternFrom=null,this.patternTo=null,this.pixelRatioFrom=1,this.pixelRatioTo=1;};Ea.prototype.setConstantPatternPositions=function(t,e){this.pixelRatioFrom=e.pixelRatio,this.pixelRatioTo=t.pixelRatio,this.patternFrom=e.tlbr,this.patternTo=t.tlbr;},Ea.prototype.setUniform=function(t,e,r,n){var i=\"u_pattern_to\"===n?this.patternTo:\"u_pattern_from\"===n?this.patternFrom:\"u_pixel_ratio_to\"===n?this.pixelRatioTo:\"u_pixel_ratio_from\"===n?this.pixelRatioFrom:null;i&&t.set(i);},Ea.prototype.getBinding=function(t,e,r){return \"u_pattern\"===r.substr(0,9)?new Aa(t,e):new ba(t,e)};var Pa=function(t,e,r,n){this.expression=t,this.type=r,this.maxValue=0,this.paintVertexAttributes=e.map((function(t){return {name:\"a_\"+t,type:\"Float32\",components:\"color\"===r?2:1,offset:0}})),this.paintVertexArray=new n;};Pa.prototype.populatePaintArray=function(t,e,r,n,i){var a=this.paintVertexArray.length,o=this.expression.evaluate(new si(0),e,{},n,[],i);this.paintVertexArray.resize(t),this._setPaintValue(a,t,o);},Pa.prototype.updatePaintArray=function(t,e,r,n){var i=this.expression.evaluate({zoom:0},r,n);this._setPaintValue(t,e,i);},Pa.prototype._setPaintValue=function(t,e,r){if(\"color\"===this.type)for(var n=za(r),i=t;i<e;i++)this.paintVertexArray.emplace(i,n[0],n[1]);else {for(var a=t;a<e;a++)this.paintVertexArray.emplace(a,r);this.maxValue=Math.max(this.maxValue,Math.abs(r));}},Pa.prototype.upload=function(t){this.paintVertexArray&&this.paintVertexArray.arrayBuffer&&(this.paintVertexBuffer&&this.paintVertexBuffer.buffer?this.paintVertexBuffer.updateData(this.paintVertexArray):this.paintVertexBuffer=t.createVertexBuffer(this.paintVertexArray,this.paintVertexAttributes,this.expression.isStateDependent));},Pa.prototype.destroy=function(){this.paintVertexBuffer&&this.paintVertexBuffer.destroy();};var Ma=function(t,e,r,n,i,a){this.expression=t,this.uniformNames=e.map((function(t){return \"u_\"+t+\"_t\"})),this.type=r,this.useIntegerZoom=n,this.zoom=i,this.maxValue=0,this.paintVertexAttributes=e.map((function(t){return {name:\"a_\"+t,type:\"Float32\",components:\"color\"===r?4:2,offset:0}})),this.paintVertexArray=new a;};Ma.prototype.populatePaintArray=function(t,e,r,n,i){var a=this.expression.evaluate(new si(this.zoom),e,{},n,[],i),o=this.expression.evaluate(new si(this.zoom+1),e,{},n,[],i),s=this.paintVertexArray.length;this.paintVertexArray.resize(t),this._setPaintValue(s,t,a,o);},Ma.prototype.updatePaintArray=function(t,e,r,n){var i=this.expression.evaluate({zoom:this.zoom},r,n),a=this.expression.evaluate({zoom:this.zoom+1},r,n);this._setPaintValue(t,e,i,a);},Ma.prototype._setPaintValue=function(t,e,r,n){if(\"color\"===this.type)for(var i=za(r),a=za(n),o=t;o<e;o++)this.paintVertexArray.emplace(o,i[0],i[1],a[0],a[1]);else {for(var s=t;s<e;s++)this.paintVertexArray.emplace(s,r,n);this.maxValue=Math.max(this.maxValue,Math.abs(r),Math.abs(n));}},Ma.prototype.upload=function(t){this.paintVertexArray&&this.paintVertexArray.arrayBuffer&&(this.paintVertexBuffer&&this.paintVertexBuffer.buffer?this.paintVertexBuffer.updateData(this.paintVertexArray):this.paintVertexBuffer=t.createVertexBuffer(this.paintVertexArray,this.paintVertexAttributes,this.expression.isStateDependent));},Ma.prototype.destroy=function(){this.paintVertexBuffer&&this.paintVertexBuffer.destroy();},Ma.prototype.setUniform=function(t,e){var r=this.useIntegerZoom?Math.floor(e.zoom):e.zoom,n=p(this.expression.interpolationFactor(r,this.zoom,this.zoom+1),0,1);t.set(n);},Ma.prototype.getBinding=function(t,e,r){return new ba(t,e)};var Ba=function(t,e,r,n,i,a){this.expression=t,this.type=e,this.useIntegerZoom=r,this.zoom=n,this.layerId=a,this.zoomInPaintVertexArray=new i,this.zoomOutPaintVertexArray=new i;};Ba.prototype.populatePaintArray=function(t,e,r){var n=this.zoomInPaintVertexArray.length;this.zoomInPaintVertexArray.resize(t),this.zoomOutPaintVertexArray.resize(t),this._setPaintValues(n,t,e.patterns&&e.patterns[this.layerId],r);},Ba.prototype.updatePaintArray=function(t,e,r,n,i){this._setPaintValues(t,e,r.patterns&&r.patterns[this.layerId],i);},Ba.prototype._setPaintValues=function(t,e,r,n){if(n&&r){var i=n[r.min],a=n[r.mid],o=n[r.max];if(i&&a&&o)for(var s=t;s<e;s++)this.zoomInPaintVertexArray.emplace(s,a.tl[0],a.tl[1],a.br[0],a.br[1],i.tl[0],i.tl[1],i.br[0],i.br[1],a.pixelRatio,i.pixelRatio),this.zoomOutPaintVertexArray.emplace(s,a.tl[0],a.tl[1],a.br[0],a.br[1],o.tl[0],o.tl[1],o.br[0],o.br[1],a.pixelRatio,o.pixelRatio);}},Ba.prototype.upload=function(t){this.zoomInPaintVertexArray&&this.zoomInPaintVertexArray.arrayBuffer&&this.zoomOutPaintVertexArray&&this.zoomOutPaintVertexArray.arrayBuffer&&(this.zoomInPaintVertexBuffer=t.createVertexBuffer(this.zoomInPaintVertexArray,la.members,this.expression.isStateDependent),this.zoomOutPaintVertexBuffer=t.createVertexBuffer(this.zoomOutPaintVertexArray,la.members,this.expression.isStateDependent));},Ba.prototype.destroy=function(){this.zoomOutPaintVertexBuffer&&this.zoomOutPaintVertexBuffer.destroy(),this.zoomInPaintVertexBuffer&&this.zoomInPaintVertexBuffer.destroy();};var Ta=function(t,e,r){this.binders={},this._buffers=[];var n=[];for(var i in t.paint._values)if(r(i)){var a=t.paint.get(i);if(a instanceof yi&&Tr(a.property.specification)){var o=Fa(i,t.type),s=a.value,u=a.property.specification.type,l=a.property.useIntegerZoom,p=a.property.specification[\"property-type\"],c=\"cross-faded\"===p||\"cross-faded-data-driven\"===p;if(\"constant\"===s.kind)this.binders[i]=c?new Ea(s.value,o):new Ca(s.value,o,u),n.push(\"/u_\"+i);else if(\"source\"===s.kind||c){var h=Da(i,u,\"source\");this.binders[i]=c?new Ba(s,u,l,e,h,t.id):new Pa(s,o,u,h),n.push(\"/a_\"+i);}else {var f=Da(i,u,\"composite\");this.binders[i]=new Ma(s,o,u,l,e,f),n.push(\"/z_\"+i);}}}this.cacheKey=n.sort().join(\"\");};Ta.prototype.getMaxValue=function(t){var e=this.binders[t];return e instanceof Pa||e instanceof Ma?e.maxValue:0},Ta.prototype.populatePaintArrays=function(t,e,r,n,i){for(var a in this.binders){var o=this.binders[a];(o instanceof Pa||o instanceof Ma||o instanceof Ba)&&o.populatePaintArray(t,e,r,n,i);}},Ta.prototype.setConstantPatternPositions=function(t,e){for(var r in this.binders){var n=this.binders[r];n instanceof Ea&&n.setConstantPatternPositions(t,e);}},Ta.prototype.updatePaintArrays=function(t,e,r,n,i){var a=!1;for(var o in t)for(var s=0,u=e.getPositions(o);s<u.length;s+=1){var l=u[s],p=r.feature(l.index);for(var c in this.binders){var h=this.binders[c];if((h instanceof Pa||h instanceof Ma||h instanceof Ba)&&!0===h.expression.isStateDependent){var f=n.paint.get(c);h.expression=f.value,h.updatePaintArray(l.start,l.end,p,t[o],i),a=!0;}}}return a},Ta.prototype.defines=function(){var t=[];for(var e in this.binders){var r=this.binders[e];(r instanceof Ca||r instanceof Ea)&&t.push.apply(t,r.uniformNames.map((function(t){return \"#define HAS_UNIFORM_\"+t})));}return t},Ta.prototype.getBinderAttributes=function(){var t=[];for(var e in this.binders){var r=this.binders[e];if(r instanceof Pa||r instanceof Ma)for(var n=0;n<r.paintVertexAttributes.length;n++)t.push(r.paintVertexAttributes[n].name);else if(r instanceof Ba)for(var i=0;i<la.members.length;i++)t.push(la.members[i].name);}return t},Ta.prototype.getBinderUniforms=function(){var t=[];for(var e in this.binders){var r=this.binders[e];if(r instanceof Ca||r instanceof Ea||r instanceof Ma)for(var n=0,i=r.uniformNames;n<i.length;n+=1)t.push(i[n]);}return t},Ta.prototype.getPaintVertexBuffers=function(){return this._buffers},Ta.prototype.getUniforms=function(t,e){var r=[];for(var n in this.binders){var i=this.binders[n];if(i instanceof Ca||i instanceof Ea||i instanceof Ma)for(var a=0,o=i.uniformNames;a<o.length;a+=1){var s=o[a];if(e[s]){var u=i.getBinding(t,e[s],s);r.push({name:s,property:n,binding:u});}}}return r},Ta.prototype.setUniforms=function(t,e,r,n){for(var i=0,a=e;i<a.length;i+=1){var o=a[i],s=o.name,u=o.property;this.binders[u].setUniform(o.binding,n,r.get(u),s);}},Ta.prototype.updatePaintBuffers=function(t){for(var e in this._buffers=[],this.binders){var r=this.binders[e];if(t&&r instanceof Ba){var n=2===t.fromScale?r.zoomInPaintVertexBuffer:r.zoomOutPaintVertexBuffer;n&&this._buffers.push(n);}else (r instanceof Pa||r instanceof Ma)&&r.paintVertexBuffer&&this._buffers.push(r.paintVertexBuffer);}},Ta.prototype.upload=function(t){for(var e in this.binders){var r=this.binders[e];(r instanceof Pa||r instanceof Ma||r instanceof Ba)&&r.upload(t);}this.updatePaintBuffers();},Ta.prototype.destroy=function(){for(var t in this.binders){var e=this.binders[t];(e instanceof Pa||e instanceof Ma||e instanceof Ba)&&e.destroy();}};var Va=function(t,e,r){void 0===r&&(r=function(){return !0}),this.programConfigurations={};for(var n=0,i=t;n<i.length;n+=1){var a=i[n];this.programConfigurations[a.id]=new Ta(a,e,r);}this.needsUpload=!1,this._featureMap=new ya,this._bufferOffset=0;};function Fa(t,e){return {\"text-opacity\":[\"opacity\"],\"icon-opacity\":[\"opacity\"],\"text-color\":[\"fill_color\"],\"icon-color\":[\"fill_color\"],\"text-halo-color\":[\"halo_color\"],\"icon-halo-color\":[\"halo_color\"],\"text-halo-blur\":[\"halo_blur\"],\"icon-halo-blur\":[\"halo_blur\"],\"text-halo-width\":[\"halo_width\"],\"icon-halo-width\":[\"halo_width\"],\"line-gap-width\":[\"gapwidth\"],\"line-pattern\":[\"pattern_to\",\"pattern_from\",\"pixel_ratio_to\",\"pixel_ratio_from\"],\"fill-pattern\":[\"pattern_to\",\"pattern_from\",\"pixel_ratio_to\",\"pixel_ratio_from\"],\"fill-extrusion-pattern\":[\"pattern_to\",\"pattern_from\",\"pixel_ratio_to\",\"pixel_ratio_from\"]}[t]||[t.replace(e+\"-\",\"\").replace(/-/g,\"_\")]}function Da(t,e,r){var n={color:{source:Bi,composite:Hi},number:{source:Ki,composite:Bi}},i=function(t){return {\"line-pattern\":{source:Ti,composite:Ti},\"fill-pattern\":{source:Ti,composite:Ti},\"fill-extrusion-pattern\":{source:Ti,composite:Ti}}[t]}(t);return i&&i[r]||n[e][r]}Va.prototype.populatePaintArrays=function(t,e,r,n,i,a){for(var o in this.programConfigurations)this.programConfigurations[o].populatePaintArrays(t,e,n,i,a);void 0!==e.id&&this._featureMap.add(e.id,r,this._bufferOffset,t),this._bufferOffset=t,this.needsUpload=!0;},Va.prototype.updatePaintArrays=function(t,e,r,n){for(var i=0,a=r;i<a.length;i+=1){var o=a[i];this.needsUpload=this.programConfigurations[o.id].updatePaintArrays(t,this._featureMap,e,o,n)||this.needsUpload;}},Va.prototype.get=function(t){return this.programConfigurations[t]},Va.prototype.upload=function(t){if(this.needsUpload){for(var e in this.programConfigurations)this.programConfigurations[e].upload(t);this.needsUpload=!1;}},Va.prototype.destroy=function(){for(var t in this.programConfigurations)this.programConfigurations[t].destroy();},On(\"ConstantBinder\",Ca),On(\"CrossFadedConstantBinder\",Ea),On(\"SourceExpressionBinder\",Pa),On(\"CrossFadedCompositeBinder\",Ba),On(\"CompositeExpressionBinder\",Ma),On(\"ProgramConfiguration\",Ta,{omit:[\"_buffers\"]}),On(\"ProgramConfigurationSet\",Va);var La=Math.pow(2,14)-1,Oa=-La-1;function Ra(t){for(var e=8192/t.extent,r=t.loadGeometry(),n=0;n<r.length;n++)for(var i=r[n],a=0;a<i.length;a++){var o=i[a],s=Math.round(o.x*e),u=Math.round(o.y*e);o.x=p(s,Oa,La),o.y=p(u,Oa,La),(s<o.x||s>o.x+1||u<o.y||u>o.y+1)&&A(\"Geometry exceeds allowed extent, reduce your vector tile buffer size\");}return r}function Ua(t,e){return {type:t.type,id:t.id,properties:t.properties,geometry:e?Ra(t):[]}}function ja(t,e,r,n,i){t.emplaceBack(2*e+(n+1)/2,2*r+(i+1)/2);}var qa=function(t){this.zoom=t.zoom,this.overscaling=t.overscaling,this.layers=t.layers,this.layerIds=this.layers.map((function(t){return t.id})),this.index=t.index,this.hasPattern=!1,this.layoutVertexArray=new Ci,this.indexArray=new ji,this.segments=new sa,this.programConfigurations=new Va(t.layers,t.zoom),this.stateDependentLayerIds=this.layers.filter((function(t){return t.isStateDependent()})).map((function(t){return t.id}));};function Na(t,e){for(var r=0;r<t.length;r++)if(Wa(e,t[r]))return !0;for(var n=0;n<e.length;n++)if(Wa(t,e[n]))return !0;return !!Xa(t,e)}function Ka(t,e,r){return !!Wa(t,e)||!!Ha(e,t,r)}function Ga(t,e){if(1===t.length)return $a(e,t[0]);for(var r=0;r<e.length;r++)for(var n=e[r],i=0;i<n.length;i++)if(Wa(t,n[i]))return !0;for(var a=0;a<t.length;a++)if($a(e,t[a]))return !0;for(var o=0;o<e.length;o++)if(Xa(t,e[o]))return !0;return !1}function Za(t,e,r){if(t.length>1){if(Xa(t,e))return !0;for(var n=0;n<e.length;n++)if(Ha(e[n],t,r))return !0}for(var i=0;i<t.length;i++)if(Ha(t[i],e,r))return !0;return !1}function Xa(t,e){if(0===t.length||0===e.length)return !1;for(var r=0;r<t.length-1;r++)for(var n=t[r],i=t[r+1],a=0;a<e.length-1;a++)if(Ja(n,i,e[a],e[a+1]))return !0;return !1}function Ja(t,e,r,n){return S(t,r,n)!==S(e,r,n)&&S(t,e,r)!==S(t,e,n)}function Ha(t,e,r){var n=r*r;if(1===e.length)return t.distSqr(e[0])<n;for(var i=1;i<e.length;i++)if(Ya(t,e[i-1],e[i])<n)return !0;return !1}function Ya(t,e,r){var n=e.distSqr(r);if(0===n)return t.distSqr(e);var i=((t.x-e.x)*(r.x-e.x)+(t.y-e.y)*(r.y-e.y))/n;return t.distSqr(i<0?e:i>1?r:r.sub(e)._mult(i)._add(e))}function $a(t,e){for(var r,n,i,a=!1,o=0;o<t.length;o++)for(var s=0,u=(r=t[o]).length-1;s<r.length;u=s++)(n=r[s]).y>e.y!=(i=r[u]).y>e.y&&e.x<(i.x-n.x)*(e.y-n.y)/(i.y-n.y)+n.x&&(a=!a);return a}function Wa(t,e){for(var r=!1,n=0,i=t.length-1;n<t.length;i=n++){var a=t[n],o=t[i];a.y>e.y!=o.y>e.y&&e.x<(o.x-a.x)*(e.y-a.y)/(o.y-a.y)+a.x&&(r=!r);}return r}function Qa(t,e,r){var n=r[0],i=r[2];if(t.x<n.x&&e.x<n.x||t.x>i.x&&e.x>i.x||t.y<n.y&&e.y<n.y||t.y>i.y&&e.y>i.y)return !1;var a=S(t,e,r[0]);return a!==S(t,e,r[1])||a!==S(t,e,r[2])||a!==S(t,e,r[3])}function to(t,e,r){var n=e.paint.get(t).value;return \"constant\"===n.kind?n.value:r.programConfigurations.get(e.id).getMaxValue(t)}function eo(t){return Math.sqrt(t[0]*t[0]+t[1]*t[1])}function ro(t,e,r,n,a){if(!e[0]&&!e[1])return t;var o=i.convert(e)._mult(a);\"viewport\"===r&&o._rotate(-n);for(var s=[],u=0;u<t.length;u++)s.push(t[u].sub(o));return s}qa.prototype.populate=function(t,e,r){var n=this.layers[0],i=[],a=null;\"circle\"===n.type&&(a=n.layout.get(\"circle-sort-key\"));for(var o=0,s=t;o<s.length;o+=1){var u=s[o],l=u.feature,p=u.id,c=u.index,h=u.sourceLayerIndex,f=this.layers[0]._featureFilter.needGeometry,y=Ua(l,f);if(this.layers[0]._featureFilter.filter(new si(this.zoom),y,r)){var d=a?a.evaluate(y,{},r):void 0,m={id:p,properties:l.properties,type:l.type,sourceLayerIndex:h,index:c,geometry:f?y.geometry:Ra(l),patterns:{},sortKey:d};i.push(m);}}a&&i.sort((function(t,e){return t.sortKey-e.sortKey}));for(var v=0,g=i;v<g.length;v+=1){var x=g[v],b=x.geometry,w=x.index,_=x.sourceLayerIndex,A=t[w].feature;this.addFeature(x,b,w,r),e.featureIndex.insert(A,b,w,_,this.index);}},qa.prototype.update=function(t,e,r){this.stateDependentLayers.length&&this.programConfigurations.updatePaintArrays(t,e,this.stateDependentLayers,r);},qa.prototype.isEmpty=function(){return 0===this.layoutVertexArray.length},qa.prototype.uploadPending=function(){return !this.uploaded||this.programConfigurations.needsUpload},qa.prototype.upload=function(t){this.uploaded||(this.layoutVertexBuffer=t.createVertexBuffer(this.layoutVertexArray,oa),this.indexBuffer=t.createIndexBuffer(this.indexArray)),this.programConfigurations.upload(t),this.uploaded=!0;},qa.prototype.destroy=function(){this.layoutVertexBuffer&&(this.layoutVertexBuffer.destroy(),this.indexBuffer.destroy(),this.programConfigurations.destroy(),this.segments.destroy());},qa.prototype.addFeature=function(t,e,r,n){for(var i=0,a=e;i<a.length;i+=1)for(var o=0,s=a[i];o<s.length;o+=1){var u=s[o],l=u.x,p=u.y;if(!(l<0||l>=8192||p<0||p>=8192)){var c=this.segments.prepareSegment(4,this.layoutVertexArray,this.indexArray,t.sortKey),h=c.vertexLength;ja(this.layoutVertexArray,l,p,-1,-1),ja(this.layoutVertexArray,l,p,1,-1),ja(this.layoutVertexArray,l,p,1,1),ja(this.layoutVertexArray,l,p,-1,1),this.indexArray.emplaceBack(h,h+1,h+2),this.indexArray.emplaceBack(h,h+3,h+2),c.vertexLength+=4,c.primitiveLength+=2;}}this.programConfigurations.populatePaintArrays(this.layoutVertexArray.length,t,r,{},n);},On(\"CircleBucket\",qa,{omit:[\"layers\"]});var no=new wi({\"circle-sort-key\":new vi(Et.layout_circle[\"circle-sort-key\"])}),io={paint:new wi({\"circle-radius\":new vi(Et.paint_circle[\"circle-radius\"]),\"circle-color\":new vi(Et.paint_circle[\"circle-color\"]),\"circle-blur\":new vi(Et.paint_circle[\"circle-blur\"]),\"circle-opacity\":new vi(Et.paint_circle[\"circle-opacity\"]),\"circle-translate\":new mi(Et.paint_circle[\"circle-translate\"]),\"circle-translate-anchor\":new mi(Et.paint_circle[\"circle-translate-anchor\"]),\"circle-pitch-scale\":new mi(Et.paint_circle[\"circle-pitch-scale\"]),\"circle-pitch-alignment\":new mi(Et.paint_circle[\"circle-pitch-alignment\"]),\"circle-stroke-width\":new vi(Et.paint_circle[\"circle-stroke-width\"]),\"circle-stroke-color\":new vi(Et.paint_circle[\"circle-stroke-color\"]),\"circle-stroke-opacity\":new vi(Et.paint_circle[\"circle-stroke-opacity\"])}),layout:no},ao=\"undefined\"!=typeof Float32Array?Float32Array:Array;function oo(t){return t[0]=1,t[1]=0,t[2]=0,t[3]=0,t[4]=0,t[5]=1,t[6]=0,t[7]=0,t[8]=0,t[9]=0,t[10]=1,t[11]=0,t[12]=0,t[13]=0,t[14]=0,t[15]=1,t}function so(t,e,r){var n=e[0],i=e[1],a=e[2],o=e[3],s=e[4],u=e[5],l=e[6],p=e[7],c=e[8],h=e[9],f=e[10],y=e[11],d=e[12],m=e[13],v=e[14],g=e[15],x=r[0],b=r[1],w=r[2],_=r[3];return t[0]=x*n+b*s+w*c+_*d,t[1]=x*i+b*u+w*h+_*m,t[2]=x*a+b*l+w*f+_*v,t[3]=x*o+b*p+w*y+_*g,t[4]=(x=r[4])*n+(b=r[5])*s+(w=r[6])*c+(_=r[7])*d,t[5]=x*i+b*u+w*h+_*m,t[6]=x*a+b*l+w*f+_*v,t[7]=x*o+b*p+w*y+_*g,t[8]=(x=r[8])*n+(b=r[9])*s+(w=r[10])*c+(_=r[11])*d,t[9]=x*i+b*u+w*h+_*m,t[10]=x*a+b*l+w*f+_*v,t[11]=x*o+b*p+w*y+_*g,t[12]=(x=r[12])*n+(b=r[13])*s+(w=r[14])*c+(_=r[15])*d,t[13]=x*i+b*u+w*h+_*m,t[14]=x*a+b*l+w*f+_*v,t[15]=x*o+b*p+w*y+_*g,t}Math.hypot||(Math.hypot=function(){for(var t=arguments,e=0,r=arguments.length;r--;)e+=t[r]*t[r];return Math.sqrt(e)});var uo,lo=so;function po(t,e,r){var n=e[0],i=e[1],a=e[2],o=e[3];return t[0]=r[0]*n+r[4]*i+r[8]*a+r[12]*o,t[1]=r[1]*n+r[5]*i+r[9]*a+r[13]*o,t[2]=r[2]*n+r[6]*i+r[10]*a+r[14]*o,t[3]=r[3]*n+r[7]*i+r[11]*a+r[15]*o,t}uo=new ao(3),ao!=Float32Array&&(uo[0]=0,uo[1]=0,uo[2]=0),function(){var t=new ao(4);ao!=Float32Array&&(t[0]=0,t[1]=0,t[2]=0,t[3]=0);}();var co=(function(){var t=new ao(2);ao!=Float32Array&&(t[0]=0,t[1]=0);}(),function(t){function e(e){t.call(this,e,io);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.createBucket=function(t){return new qa(t)},e.prototype.queryRadius=function(t){var e=t;return to(\"circle-radius\",this,e)+to(\"circle-stroke-width\",this,e)+eo(this.paint.get(\"circle-translate\"))},e.prototype.queryIntersectsFeature=function(t,e,r,n,i,a,o,s){for(var u=ro(t,this.paint.get(\"circle-translate\"),this.paint.get(\"circle-translate-anchor\"),a.angle,o),l=this.paint.get(\"circle-radius\").evaluate(e,r)+this.paint.get(\"circle-stroke-width\").evaluate(e,r),p=\"map\"===this.paint.get(\"circle-pitch-alignment\"),c=p?u:function(t,e){return t.map((function(t){return ho(t,e)}))}(u,s),h=p?l*o:l,f=0,y=n;f<y.length;f+=1)for(var d=0,m=y[f];d<m.length;d+=1){var v=m[d],g=p?v:ho(v,s),x=h,b=po([],[v.x,v.y,0,1],s);if(\"viewport\"===this.paint.get(\"circle-pitch-scale\")&&\"map\"===this.paint.get(\"circle-pitch-alignment\")?x*=b[3]/a.cameraToCenterDistance:\"map\"===this.paint.get(\"circle-pitch-scale\")&&\"viewport\"===this.paint.get(\"circle-pitch-alignment\")&&(x*=a.cameraToCenterDistance/b[3]),Ka(c,g,x))return !0}return !1},e}(_i));function ho(t,e){var r=po([],[t.x,t.y,0,1],e);return new i(r[0]/r[3],r[1]/r[3])}var fo=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e}(qa);function yo(t,e,r,n){var i=e.width,a=e.height;if(n){if(n instanceof Uint8ClampedArray)n=new Uint8Array(n.buffer);else if(n.length!==i*a*r)throw new RangeError(\"mismatched image size\")}else n=new Uint8Array(i*a*r);return t.width=i,t.height=a,t.data=n,t}function mo(t,e,r){var n=e.width,i=e.height;if(n!==t.width||i!==t.height){var a=yo({},{width:n,height:i},r);vo(t,a,{x:0,y:0},{x:0,y:0},{width:Math.min(t.width,n),height:Math.min(t.height,i)},r),t.width=n,t.height=i,t.data=a.data;}}function vo(t,e,r,n,i,a){if(0===i.width||0===i.height)return e;if(i.width>t.width||i.height>t.height||r.x>t.width-i.width||r.y>t.height-i.height)throw new RangeError(\"out of range source coordinates for image copy\");if(i.width>e.width||i.height>e.height||n.x>e.width-i.width||n.y>e.height-i.height)throw new RangeError(\"out of range destination coordinates for image copy\");for(var o=t.data,s=e.data,u=0;u<i.height;u++)for(var l=((r.y+u)*t.width+r.x)*a,p=((n.y+u)*e.width+n.x)*a,c=0;c<i.width*a;c++)s[p+c]=o[l+c];return e}On(\"HeatmapBucket\",fo,{omit:[\"layers\"]});var go=function(t,e){yo(this,t,1,e);};go.prototype.resize=function(t){mo(this,t,1);},go.prototype.clone=function(){return new go({width:this.width,height:this.height},new Uint8Array(this.data))},go.copy=function(t,e,r,n,i){vo(t,e,r,n,i,1);};var xo=function(t,e){yo(this,t,4,e);};xo.prototype.resize=function(t){mo(this,t,4);},xo.prototype.replace=function(t,e){e?this.data.set(t):this.data=t instanceof Uint8ClampedArray?new Uint8Array(t.buffer):t;},xo.prototype.clone=function(){return new xo({width:this.width,height:this.height},new Uint8Array(this.data))},xo.copy=function(t,e,r,n,i){vo(t,e,r,n,i,4);},On(\"AlphaImage\",go),On(\"RGBAImage\",xo);var bo={paint:new wi({\"heatmap-radius\":new vi(Et.paint_heatmap[\"heatmap-radius\"]),\"heatmap-weight\":new vi(Et.paint_heatmap[\"heatmap-weight\"]),\"heatmap-intensity\":new mi(Et.paint_heatmap[\"heatmap-intensity\"]),\"heatmap-color\":new bi(Et.paint_heatmap[\"heatmap-color\"]),\"heatmap-opacity\":new mi(Et.paint_heatmap[\"heatmap-opacity\"])})};function wo(t){var e={},r=t.resolution||256,n=t.clips?t.clips.length:1,i=t.image||new xo({width:r,height:n}),a=function(r,n,a){e[t.evaluationKey]=a;var o=t.expression.evaluate(e);i.data[r+n+0]=Math.floor(255*o.r/o.a),i.data[r+n+1]=Math.floor(255*o.g/o.a),i.data[r+n+2]=Math.floor(255*o.b/o.a),i.data[r+n+3]=Math.floor(255*o.a);};if(t.clips)for(var o=0,s=0;o<n;++o,s+=4*r)for(var u=0,l=0;u<r;u++,l+=4){var p=u/(r-1),c=t.clips[o];a(s,l,c.start*(1-p)+c.end*p);}else for(var h=0,f=0;h<r;h++,f+=4)a(0,f,h/(r-1));return i}var _o=function(t){function e(e){t.call(this,e,bo),this._updateColorRamp();}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.createBucket=function(t){return new fo(t)},e.prototype._handleSpecialPaintPropertyUpdate=function(t){\"heatmap-color\"===t&&this._updateColorRamp();},e.prototype._updateColorRamp=function(){this.colorRamp=wo({expression:this._transitionablePaint._values[\"heatmap-color\"].value.expression,evaluationKey:\"heatmapDensity\",image:this.colorRamp}),this.colorRampTexture=null;},e.prototype.resize=function(){this.heatmapFbo&&(this.heatmapFbo.destroy(),this.heatmapFbo=null);},e.prototype.queryRadius=function(){return 0},e.prototype.queryIntersectsFeature=function(){return !1},e.prototype.hasOffscreenPass=function(){return 0!==this.paint.get(\"heatmap-opacity\")&&\"none\"!==this.visibility},e}(_i),Ao={paint:new wi({\"hillshade-illumination-direction\":new mi(Et.paint_hillshade[\"hillshade-illumination-direction\"]),\"hillshade-illumination-anchor\":new mi(Et.paint_hillshade[\"hillshade-illumination-anchor\"]),\"hillshade-exaggeration\":new mi(Et.paint_hillshade[\"hillshade-exaggeration\"]),\"hillshade-shadow-color\":new mi(Et.paint_hillshade[\"hillshade-shadow-color\"]),\"hillshade-highlight-color\":new mi(Et.paint_hillshade[\"hillshade-highlight-color\"]),\"hillshade-accent-color\":new mi(Et.paint_hillshade[\"hillshade-accent-color\"])})},So=function(t){function e(e){t.call(this,e,Ao);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.hasOffscreenPass=function(){return 0!==this.paint.get(\"hillshade-exaggeration\")&&\"none\"!==this.visibility},e}(_i),ko=Ii([{name:\"a_pos\",components:2,type:\"Int16\"}],4).members,Io=Co,zo=Co;function Co(t,e,r){r=r||2;var n,i,a,o,s,u,l,p=e&&e.length,c=p?e[0]*r:t.length,h=Eo(t,0,c,r,!0),f=[];if(!h||h.next===h.prev)return f;if(p&&(h=function(t,e,r,n){var i,a,o,s=[];for(i=0,a=e.length;i<a;i++)(o=Eo(t,e[i]*n,i<a-1?e[i+1]*n:t.length,n,!1))===o.next&&(o.steiner=!0),s.push(Uo(o));for(s.sort(Do),i=0;i<s.length;i++)Lo(s[i],r),r=Po(r,r.next);return r}(t,e,h,r)),t.length>80*r){n=a=t[0],i=o=t[1];for(var y=r;y<c;y+=r)(s=t[y])<n&&(n=s),(u=t[y+1])<i&&(i=u),s>a&&(a=s),u>o&&(o=u);l=0!==(l=Math.max(a-n,o-i))?1/l:0;}return Mo(h,f,r,n,i,l),f}function Eo(t,e,r,n,i){var a,o;if(i===Qo(t,e,r,n)>0)for(a=e;a<r;a+=n)o=Yo(a,t[a],t[a+1],o);else for(a=r-n;a>=e;a-=n)o=Yo(a,t[a],t[a+1],o);return o&&Ko(o,o.next)&&($o(o),o=o.next),o}function Po(t,e){if(!t)return t;e||(e=t);var r,n=t;do{if(r=!1,n.steiner||!Ko(n,n.next)&&0!==No(n.prev,n,n.next))n=n.next;else {if($o(n),(n=e=n.prev)===n.next)break;r=!0;}}while(r||n!==e);return e}function Mo(t,e,r,n,i,a,o){if(t){!o&&a&&function(t,e,r,n){var i=t;do{null===i.z&&(i.z=Ro(i.x,i.y,e,r,n)),i.prevZ=i.prev,i.nextZ=i.next,i=i.next;}while(i!==t);i.prevZ.nextZ=null,i.prevZ=null,function(t){var e,r,n,i,a,o,s,u,l=1;do{for(r=t,t=null,a=null,o=0;r;){for(o++,n=r,s=0,e=0;e<l&&(s++,n=n.nextZ);e++);for(u=l;s>0||u>0&&n;)0!==s&&(0===u||!n||r.z<=n.z)?(i=r,r=r.nextZ,s--):(i=n,n=n.nextZ,u--),a?a.nextZ=i:t=i,i.prevZ=a,a=i;r=n;}a.nextZ=null,l*=2;}while(o>1)}(i);}(t,n,i,a);for(var s,u,l=t;t.prev!==t.next;)if(s=t.prev,u=t.next,a?To(t,n,i,a):Bo(t))e.push(s.i/r),e.push(t.i/r),e.push(u.i/r),$o(t),t=u.next,l=u.next;else if((t=u)===l){o?1===o?Mo(t=Vo(Po(t),e,r),e,r,n,i,a,2):2===o&&Fo(t,e,r,n,i,a):Mo(Po(t),e,r,n,i,a,1);break}}}function Bo(t){var e=t.prev,r=t,n=t.next;if(No(e,r,n)>=0)return !1;for(var i=t.next.next;i!==t.prev;){if(jo(e.x,e.y,r.x,r.y,n.x,n.y,i.x,i.y)&&No(i.prev,i,i.next)>=0)return !1;i=i.next;}return !0}function To(t,e,r,n){var i=t.prev,a=t,o=t.next;if(No(i,a,o)>=0)return !1;for(var s=i.x>a.x?i.x>o.x?i.x:o.x:a.x>o.x?a.x:o.x,u=i.y>a.y?i.y>o.y?i.y:o.y:a.y>o.y?a.y:o.y,l=Ro(i.x<a.x?i.x<o.x?i.x:o.x:a.x<o.x?a.x:o.x,i.y<a.y?i.y<o.y?i.y:o.y:a.y<o.y?a.y:o.y,e,r,n),p=Ro(s,u,e,r,n),c=t.prevZ,h=t.nextZ;c&&c.z>=l&&h&&h.z<=p;){if(c!==t.prev&&c!==t.next&&jo(i.x,i.y,a.x,a.y,o.x,o.y,c.x,c.y)&&No(c.prev,c,c.next)>=0)return !1;if(c=c.prevZ,h!==t.prev&&h!==t.next&&jo(i.x,i.y,a.x,a.y,o.x,o.y,h.x,h.y)&&No(h.prev,h,h.next)>=0)return !1;h=h.nextZ;}for(;c&&c.z>=l;){if(c!==t.prev&&c!==t.next&&jo(i.x,i.y,a.x,a.y,o.x,o.y,c.x,c.y)&&No(c.prev,c,c.next)>=0)return !1;c=c.prevZ;}for(;h&&h.z<=p;){if(h!==t.prev&&h!==t.next&&jo(i.x,i.y,a.x,a.y,o.x,o.y,h.x,h.y)&&No(h.prev,h,h.next)>=0)return !1;h=h.nextZ;}return !0}function Vo(t,e,r){var n=t;do{var i=n.prev,a=n.next.next;!Ko(i,a)&&Go(i,n,n.next,a)&&Jo(i,a)&&Jo(a,i)&&(e.push(i.i/r),e.push(n.i/r),e.push(a.i/r),$o(n),$o(n.next),n=t=a),n=n.next;}while(n!==t);return Po(n)}function Fo(t,e,r,n,i,a){var o=t;do{for(var s=o.next.next;s!==o.prev;){if(o.i!==s.i&&qo(o,s)){var u=Ho(o,s);return o=Po(o,o.next),u=Po(u,u.next),Mo(o,e,r,n,i,a),void Mo(u,e,r,n,i,a)}s=s.next;}o=o.next;}while(o!==t)}function Do(t,e){return t.x-e.x}function Lo(t,e){if(e=function(t,e){var r,n=e,i=t.x,a=t.y,o=-1/0;do{if(a<=n.y&&a>=n.next.y&&n.next.y!==n.y){var s=n.x+(a-n.y)*(n.next.x-n.x)/(n.next.y-n.y);if(s<=i&&s>o){if(o=s,s===i){if(a===n.y)return n;if(a===n.next.y)return n.next}r=n.x<n.next.x?n:n.next;}}n=n.next;}while(n!==e);if(!r)return null;if(i===o)return r;var u,l=r,p=r.x,c=r.y,h=1/0;n=r;do{i>=n.x&&n.x>=p&&i!==n.x&&jo(a<c?i:o,a,p,c,a<c?o:i,a,n.x,n.y)&&(u=Math.abs(a-n.y)/(i-n.x),Jo(n,t)&&(u<h||u===h&&(n.x>r.x||n.x===r.x&&Oo(r,n)))&&(r=n,h=u)),n=n.next;}while(n!==l);return r}(t,e)){var r=Ho(e,t);Po(e,e.next),Po(r,r.next);}}function Oo(t,e){return No(t.prev,t,e.prev)<0&&No(e.next,t,t.next)<0}function Ro(t,e,r,n,i){return (t=1431655765&((t=858993459&((t=252645135&((t=16711935&((t=32767*(t-r)*i)|t<<8))|t<<4))|t<<2))|t<<1))|(e=1431655765&((e=858993459&((e=252645135&((e=16711935&((e=32767*(e-n)*i)|e<<8))|e<<4))|e<<2))|e<<1))<<1}function Uo(t){var e=t,r=t;do{(e.x<r.x||e.x===r.x&&e.y<r.y)&&(r=e),e=e.next;}while(e!==t);return r}function jo(t,e,r,n,i,a,o,s){return (i-o)*(e-s)-(t-o)*(a-s)>=0&&(t-o)*(n-s)-(r-o)*(e-s)>=0&&(r-o)*(a-s)-(i-o)*(n-s)>=0}function qo(t,e){return t.next.i!==e.i&&t.prev.i!==e.i&&!function(t,e){var r=t;do{if(r.i!==t.i&&r.next.i!==t.i&&r.i!==e.i&&r.next.i!==e.i&&Go(r,r.next,t,e))return !0;r=r.next;}while(r!==t);return !1}(t,e)&&(Jo(t,e)&&Jo(e,t)&&function(t,e){var r=t,n=!1,i=(t.x+e.x)/2,a=(t.y+e.y)/2;do{r.y>a!=r.next.y>a&&r.next.y!==r.y&&i<(r.next.x-r.x)*(a-r.y)/(r.next.y-r.y)+r.x&&(n=!n),r=r.next;}while(r!==t);return n}(t,e)&&(No(t.prev,t,e.prev)||No(t,e.prev,e))||Ko(t,e)&&No(t.prev,t,t.next)>0&&No(e.prev,e,e.next)>0)}function No(t,e,r){return (e.y-t.y)*(r.x-e.x)-(e.x-t.x)*(r.y-e.y)}function Ko(t,e){return t.x===e.x&&t.y===e.y}function Go(t,e,r,n){var i=Xo(No(t,e,r)),a=Xo(No(t,e,n)),o=Xo(No(r,n,t)),s=Xo(No(r,n,e));return i!==a&&o!==s||!(0!==i||!Zo(t,r,e))||!(0!==a||!Zo(t,n,e))||!(0!==o||!Zo(r,t,n))||!(0!==s||!Zo(r,e,n))}function Zo(t,e,r){return e.x<=Math.max(t.x,r.x)&&e.x>=Math.min(t.x,r.x)&&e.y<=Math.max(t.y,r.y)&&e.y>=Math.min(t.y,r.y)}function Xo(t){return t>0?1:t<0?-1:0}function Jo(t,e){return No(t.prev,t,t.next)<0?No(t,e,t.next)>=0&&No(t,t.prev,e)>=0:No(t,e,t.prev)<0||No(t,t.next,e)<0}function Ho(t,e){var r=new Wo(t.i,t.x,t.y),n=new Wo(e.i,e.x,e.y),i=t.next,a=e.prev;return t.next=e,e.prev=t,r.next=i,i.prev=r,n.next=r,r.prev=n,a.next=n,n.prev=a,n}function Yo(t,e,r,n){var i=new Wo(t,e,r);return n?(i.next=n.next,i.prev=n,n.next.prev=i,n.next=i):(i.prev=i,i.next=i),i}function $o(t){t.next.prev=t.prev,t.prev.next=t.next,t.prevZ&&(t.prevZ.nextZ=t.nextZ),t.nextZ&&(t.nextZ.prevZ=t.prevZ);}function Wo(t,e,r){this.i=t,this.x=e,this.y=r,this.prev=null,this.next=null,this.z=null,this.prevZ=null,this.nextZ=null,this.steiner=!1;}function Qo(t,e,r,n){for(var i=0,a=e,o=r-n;a<r;a+=n)i+=(t[o]-t[a])*(t[a+1]+t[o+1]),o=a;return i}function ts(t,e,r,n,i){!function t(e,r,n,i,a){for(;i>n;){if(i-n>600){var o=i-n+1,s=r-n+1,u=Math.log(o),l=.5*Math.exp(2*u/3),p=.5*Math.sqrt(u*l*(o-l)/o)*(s-o/2<0?-1:1);t(e,r,Math.max(n,Math.floor(r-s*l/o+p)),Math.min(i,Math.floor(r+(o-s)*l/o+p)),a);}var c=e[r],h=n,f=i;for(es(e,n,r),a(e[i],c)>0&&es(e,n,i);h<f;){for(es(e,h,f),h++,f--;a(e[h],c)<0;)h++;for(;a(e[f],c)>0;)f--;}0===a(e[n],c)?es(e,n,f):es(e,++f,i),f<=r&&(n=f+1),r<=f&&(i=f-1);}}(t,e,r||0,n||t.length-1,i||rs);}function es(t,e,r){var n=t[e];t[e]=t[r],t[r]=n;}function rs(t,e){return t<e?-1:t>e?1:0}function ns(t,e){var r=t.length;if(r<=1)return [t];for(var n,i,a=[],o=0;o<r;o++){var s=k(t[o]);0!==s&&(t[o].area=Math.abs(s),void 0===i&&(i=s<0),i===s<0?(n&&a.push(n),n=[t[o]]):n.push(t[o]));}if(n&&a.push(n),e>1)for(var u=0;u<a.length;u++)a[u].length<=e||(ts(a[u],e,1,a[u].length-1,is),a[u]=a[u].slice(0,e));return a}function is(t,e){return e.area-t.area}function as(t,e,r){for(var n=r.patternDependencies,i=!1,a=0,o=e;a<o.length;a+=1){var s=o[a].paint.get(t+\"-pattern\");s.isConstant()||(i=!0);var u=s.constantOr(null);u&&(i=!0,n[u.to]=!0,n[u.from]=!0);}return i}function os(t,e,r,n,i){for(var a=i.patternDependencies,o=0,s=e;o<s.length;o+=1){var u=s[o],l=u.paint.get(t+\"-pattern\").value;if(\"constant\"!==l.kind){var p=l.evaluate({zoom:n-1},r,{},i.availableImages),c=l.evaluate({zoom:n},r,{},i.availableImages),h=l.evaluate({zoom:n+1},r,{},i.availableImages);c=c&&c.name?c.name:c,h=h&&h.name?h.name:h,a[p=p&&p.name?p.name:p]=!0,a[c]=!0,a[h]=!0,r.patterns[u.id]={min:p,mid:c,max:h};}}return r}Co.deviation=function(t,e,r,n){var i=e&&e.length,a=Math.abs(Qo(t,0,i?e[0]*r:t.length,r));if(i)for(var o=0,s=e.length;o<s;o++)a-=Math.abs(Qo(t,e[o]*r,o<s-1?e[o+1]*r:t.length,r));var u=0;for(o=0;o<n.length;o+=3){var l=n[o]*r,p=n[o+1]*r,c=n[o+2]*r;u+=Math.abs((t[l]-t[c])*(t[p+1]-t[l+1])-(t[l]-t[p])*(t[c+1]-t[l+1]));}return 0===a&&0===u?0:Math.abs((u-a)/a)},Co.flatten=function(t){for(var e=t[0][0].length,r={vertices:[],holes:[],dimensions:e},n=0,i=0;i<t.length;i++){for(var a=0;a<t[i].length;a++)for(var o=0;o<e;o++)r.vertices.push(t[i][a][o]);i>0&&r.holes.push(n+=t[i-1].length);}return r},Io.default=zo;var ss=function(t){this.zoom=t.zoom,this.overscaling=t.overscaling,this.layers=t.layers,this.layerIds=this.layers.map((function(t){return t.id})),this.index=t.index,this.hasPattern=!1,this.patternFeatures=[],this.layoutVertexArray=new Ci,this.indexArray=new ji,this.indexArray2=new Xi,this.programConfigurations=new Va(t.layers,t.zoom),this.segments=new sa,this.segments2=new sa,this.stateDependentLayerIds=this.layers.filter((function(t){return t.isStateDependent()})).map((function(t){return t.id}));};ss.prototype.populate=function(t,e,r){this.hasPattern=as(\"fill\",this.layers,e);for(var n=this.layers[0].layout.get(\"fill-sort-key\"),i=[],a=0,o=t;a<o.length;a+=1){var s=o[a],u=s.feature,l=s.id,p=s.index,c=s.sourceLayerIndex,h=this.layers[0]._featureFilter.needGeometry,f=Ua(u,h);if(this.layers[0]._featureFilter.filter(new si(this.zoom),f,r)){var y=n?n.evaluate(f,{},r,e.availableImages):void 0,d={id:l,properties:u.properties,type:u.type,sourceLayerIndex:c,index:p,geometry:h?f.geometry:Ra(u),patterns:{},sortKey:y};i.push(d);}}n&&i.sort((function(t,e){return t.sortKey-e.sortKey}));for(var m=0,v=i;m<v.length;m+=1){var g=v[m],x=g.geometry,b=g.index,w=g.sourceLayerIndex;if(this.hasPattern){var _=os(\"fill\",this.layers,g,this.zoom,e);this.patternFeatures.push(_);}else this.addFeature(g,x,b,r,{});e.featureIndex.insert(t[b].feature,x,b,w,this.index);}},ss.prototype.update=function(t,e,r){this.stateDependentLayers.length&&this.programConfigurations.updatePaintArrays(t,e,this.stateDependentLayers,r);},ss.prototype.addFeatures=function(t,e,r){for(var n=0,i=this.patternFeatures;n<i.length;n+=1){var a=i[n];this.addFeature(a,a.geometry,a.index,e,r);}},ss.prototype.isEmpty=function(){return 0===this.layoutVertexArray.length},ss.prototype.uploadPending=function(){return !this.uploaded||this.programConfigurations.needsUpload},ss.prototype.upload=function(t){this.uploaded||(this.layoutVertexBuffer=t.createVertexBuffer(this.layoutVertexArray,ko),this.indexBuffer=t.createIndexBuffer(this.indexArray),this.indexBuffer2=t.createIndexBuffer(this.indexArray2)),this.programConfigurations.upload(t),this.uploaded=!0;},ss.prototype.destroy=function(){this.layoutVertexBuffer&&(this.layoutVertexBuffer.destroy(),this.indexBuffer.destroy(),this.indexBuffer2.destroy(),this.programConfigurations.destroy(),this.segments.destroy(),this.segments2.destroy());},ss.prototype.addFeature=function(t,e,r,n,i){for(var a=0,o=ns(e,500);a<o.length;a+=1){for(var s=o[a],u=0,l=0,p=s;l<p.length;l+=1)u+=p[l].length;for(var c=this.segments.prepareSegment(u,this.layoutVertexArray,this.indexArray),h=c.vertexLength,f=[],y=[],d=0,m=s;d<m.length;d+=1){var v=m[d];if(0!==v.length){v!==s[0]&&y.push(f.length/2);var g=this.segments2.prepareSegment(v.length,this.layoutVertexArray,this.indexArray2),x=g.vertexLength;this.layoutVertexArray.emplaceBack(v[0].x,v[0].y),this.indexArray2.emplaceBack(x+v.length-1,x),f.push(v[0].x),f.push(v[0].y);for(var b=1;b<v.length;b++)this.layoutVertexArray.emplaceBack(v[b].x,v[b].y),this.indexArray2.emplaceBack(x+b-1,x+b),f.push(v[b].x),f.push(v[b].y);g.vertexLength+=v.length,g.primitiveLength+=v.length;}}for(var w=Io(f,y),_=0;_<w.length;_+=3)this.indexArray.emplaceBack(h+w[_],h+w[_+1],h+w[_+2]);c.vertexLength+=u,c.primitiveLength+=w.length/3;}this.programConfigurations.populatePaintArrays(this.layoutVertexArray.length,t,r,i,n);},On(\"FillBucket\",ss,{omit:[\"layers\",\"patternFeatures\"]});var us=new wi({\"fill-sort-key\":new vi(Et.layout_fill[\"fill-sort-key\"])}),ls={paint:new wi({\"fill-antialias\":new mi(Et.paint_fill[\"fill-antialias\"]),\"fill-opacity\":new vi(Et.paint_fill[\"fill-opacity\"]),\"fill-color\":new vi(Et.paint_fill[\"fill-color\"]),\"fill-outline-color\":new vi(Et.paint_fill[\"fill-outline-color\"]),\"fill-translate\":new mi(Et.paint_fill[\"fill-translate\"]),\"fill-translate-anchor\":new mi(Et.paint_fill[\"fill-translate-anchor\"]),\"fill-pattern\":new gi(Et.paint_fill[\"fill-pattern\"])}),layout:us},ps=function(t){function e(e){t.call(this,e,ls);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.recalculate=function(e,r){t.prototype.recalculate.call(this,e,r);var n=this.paint._values[\"fill-outline-color\"];\"constant\"===n.value.kind&&void 0===n.value.value&&(this.paint._values[\"fill-outline-color\"]=this.paint._values[\"fill-color\"]);},e.prototype.createBucket=function(t){return new ss(t)},e.prototype.queryRadius=function(){return eo(this.paint.get(\"fill-translate\"))},e.prototype.queryIntersectsFeature=function(t,e,r,n,i,a,o){return Ga(ro(t,this.paint.get(\"fill-translate\"),this.paint.get(\"fill-translate-anchor\"),a.angle,o),n)},e.prototype.isTileClipped=function(){return !0},e}(_i),cs=Ii([{name:\"a_pos\",components:2,type:\"Int16\"},{name:\"a_normal_ed\",components:4,type:\"Int16\"}],4).members,hs=fs;function fs(t,e,r,n,i){this.properties={},this.extent=r,this.type=0,this._pbf=t,this._geometry=-1,this._keys=n,this._values=i,t.readFields(ys,this,e);}function ys(t,e,r){1==t?e.id=r.readVarint():2==t?function(t,e){for(var r=t.readVarint()+t.pos;t.pos<r;){var n=e._keys[t.readVarint()],i=e._values[t.readVarint()];e.properties[n]=i;}}(r,e):3==t?e.type=r.readVarint():4==t&&(e._geometry=r.pos);}function ds(t){for(var e,r,n=0,i=0,a=t.length,o=a-1;i<a;o=i++)n+=((r=t[o]).x-(e=t[i]).x)*(e.y+r.y);return n}fs.types=[\"Unknown\",\"Point\",\"LineString\",\"Polygon\"],fs.prototype.loadGeometry=function(){var t=this._pbf;t.pos=this._geometry;for(var e,r=t.readVarint()+t.pos,n=1,a=0,o=0,s=0,u=[];t.pos<r;){if(a<=0){var l=t.readVarint();n=7&l,a=l>>3;}if(a--,1===n||2===n)o+=t.readSVarint(),s+=t.readSVarint(),1===n&&(e&&u.push(e),e=[]),e.push(new i(o,s));else {if(7!==n)throw new Error(\"unknown command \"+n);e&&e.push(e[0].clone());}}return e&&u.push(e),u},fs.prototype.bbox=function(){var t=this._pbf;t.pos=this._geometry;for(var e=t.readVarint()+t.pos,r=1,n=0,i=0,a=0,o=1/0,s=-1/0,u=1/0,l=-1/0;t.pos<e;){if(n<=0){var p=t.readVarint();r=7&p,n=p>>3;}if(n--,1===r||2===r)(i+=t.readSVarint())<o&&(o=i),i>s&&(s=i),(a+=t.readSVarint())<u&&(u=a),a>l&&(l=a);else if(7!==r)throw new Error(\"unknown command \"+r)}return [o,u,s,l]},fs.prototype.toGeoJSON=function(t,e,r){var n,i,a=this.extent*Math.pow(2,r),o=this.extent*t,s=this.extent*e,u=this.loadGeometry(),l=fs.types[this.type];function p(t){for(var e=0;e<t.length;e++){var r=t[e];t[e]=[360*(r.x+o)/a-180,360/Math.PI*Math.atan(Math.exp((180-360*(r.y+s)/a)*Math.PI/180))-90];}}switch(this.type){case 1:var c=[];for(n=0;n<u.length;n++)c[n]=u[n][0];p(u=c);break;case 2:for(n=0;n<u.length;n++)p(u[n]);break;case 3:for(u=function(t){var e=t.length;if(e<=1)return [t];for(var r,n,i=[],a=0;a<e;a++){var o=ds(t[a]);0!==o&&(void 0===n&&(n=o<0),n===o<0?(r&&i.push(r),r=[t[a]]):r.push(t[a]));}return r&&i.push(r),i}(u),n=0;n<u.length;n++)for(i=0;i<u[n].length;i++)p(u[n][i]);}1===u.length?u=u[0]:l=\"Multi\"+l;var h={type:\"Feature\",geometry:{type:l,coordinates:u},properties:this.properties};return \"id\"in this&&(h.id=this.id),h};var ms=vs;function vs(t,e){this.version=1,this.name=null,this.extent=4096,this.length=0,this._pbf=t,this._keys=[],this._values=[],this._features=[],t.readFields(gs,this,e),this.length=this._features.length;}function gs(t,e,r){15===t?e.version=r.readVarint():1===t?e.name=r.readString():5===t?e.extent=r.readVarint():2===t?e._features.push(r.pos):3===t?e._keys.push(r.readString()):4===t&&e._values.push(function(t){for(var e=null,r=t.readVarint()+t.pos;t.pos<r;){var n=t.readVarint()>>3;e=1===n?t.readString():2===n?t.readFloat():3===n?t.readDouble():4===n?t.readVarint64():5===n?t.readVarint():6===n?t.readSVarint():7===n?t.readBoolean():null;}return e}(r));}function xs(t,e,r){if(3===t){var n=new ms(r,r.readVarint()+r.pos);n.length&&(e[n.name]=n);}}vs.prototype.feature=function(t){if(t<0||t>=this._features.length)throw new Error(\"feature index out of bounds\");this._pbf.pos=this._features[t];var e=this._pbf.readVarint()+this._pbf.pos;return new hs(this._pbf,e,this.extent,this._keys,this._values)};var bs={VectorTile:function(t,e){this.layers=t.readFields(xs,{},e);},VectorTileFeature:hs,VectorTileLayer:ms},ws=bs.VectorTileFeature.types,_s=Math.pow(2,13);function As(t,e,r,n,i,a,o,s){t.emplaceBack(e,r,2*Math.floor(n*_s)+o,i*_s*2,a*_s*2,Math.round(s));}var Ss=function(t){this.zoom=t.zoom,this.overscaling=t.overscaling,this.layers=t.layers,this.layerIds=this.layers.map((function(t){return t.id})),this.index=t.index,this.hasPattern=!1,this.layoutVertexArray=new Pi,this.indexArray=new ji,this.programConfigurations=new Va(t.layers,t.zoom),this.segments=new sa,this.stateDependentLayerIds=this.layers.filter((function(t){return t.isStateDependent()})).map((function(t){return t.id}));};function ks(t,e){return t.x===e.x&&(t.x<0||t.x>8192)||t.y===e.y&&(t.y<0||t.y>8192)}Ss.prototype.populate=function(t,e,r){this.features=[],this.hasPattern=as(\"fill-extrusion\",this.layers,e);for(var n=0,i=t;n<i.length;n+=1){var a=i[n],o=a.feature,s=a.id,u=a.index,l=a.sourceLayerIndex,p=this.layers[0]._featureFilter.needGeometry,c=Ua(o,p);if(this.layers[0]._featureFilter.filter(new si(this.zoom),c,r)){var h={id:s,sourceLayerIndex:l,index:u,geometry:p?c.geometry:Ra(o),properties:o.properties,type:o.type,patterns:{}};this.hasPattern?this.features.push(os(\"fill-extrusion\",this.layers,h,this.zoom,e)):this.addFeature(h,h.geometry,u,r,{}),e.featureIndex.insert(o,h.geometry,u,l,this.index,!0);}}},Ss.prototype.addFeatures=function(t,e,r){for(var n=0,i=this.features;n<i.length;n+=1){var a=i[n];this.addFeature(a,a.geometry,a.index,e,r);}},Ss.prototype.update=function(t,e,r){this.stateDependentLayers.length&&this.programConfigurations.updatePaintArrays(t,e,this.stateDependentLayers,r);},Ss.prototype.isEmpty=function(){return 0===this.layoutVertexArray.length},Ss.prototype.uploadPending=function(){return !this.uploaded||this.programConfigurations.needsUpload},Ss.prototype.upload=function(t){this.uploaded||(this.layoutVertexBuffer=t.createVertexBuffer(this.layoutVertexArray,cs),this.indexBuffer=t.createIndexBuffer(this.indexArray)),this.programConfigurations.upload(t),this.uploaded=!0;},Ss.prototype.destroy=function(){this.layoutVertexBuffer&&(this.layoutVertexBuffer.destroy(),this.indexBuffer.destroy(),this.programConfigurations.destroy(),this.segments.destroy());},Ss.prototype.addFeature=function(t,e,r,n,i){for(var a=0,o=ns(e,500);a<o.length;a+=1){for(var s=o[a],u=0,l=0,p=s;l<p.length;l+=1)u+=p[l].length;for(var c=this.segments.prepareSegment(4,this.layoutVertexArray,this.indexArray),h=0,f=s;h<f.length;h+=1){var y=f[h];if(0!==y.length&&!((B=y).every((function(t){return t.x<0}))||B.every((function(t){return t.x>8192}))||B.every((function(t){return t.y<0}))||B.every((function(t){return t.y>8192}))))for(var d=0,m=0;m<y.length;m++){var v=y[m];if(m>=1){var g=y[m-1];if(!ks(v,g)){c.vertexLength+4>sa.MAX_VERTEX_ARRAY_LENGTH&&(c=this.segments.prepareSegment(4,this.layoutVertexArray,this.indexArray));var x=v.sub(g)._perp()._unit(),b=g.dist(v);d+b>32768&&(d=0),As(this.layoutVertexArray,v.x,v.y,x.x,x.y,0,0,d),As(this.layoutVertexArray,v.x,v.y,x.x,x.y,0,1,d),As(this.layoutVertexArray,g.x,g.y,x.x,x.y,0,0,d+=b),As(this.layoutVertexArray,g.x,g.y,x.x,x.y,0,1,d);var w=c.vertexLength;this.indexArray.emplaceBack(w,w+2,w+1),this.indexArray.emplaceBack(w+1,w+2,w+3),c.vertexLength+=4,c.primitiveLength+=2;}}}}if(c.vertexLength+u>sa.MAX_VERTEX_ARRAY_LENGTH&&(c=this.segments.prepareSegment(u,this.layoutVertexArray,this.indexArray)),\"Polygon\"===ws[t.type]){for(var _=[],A=[],S=c.vertexLength,k=0,I=s;k<I.length;k+=1){var z=I[k];if(0!==z.length){z!==s[0]&&A.push(_.length/2);for(var C=0;C<z.length;C++){var E=z[C];As(this.layoutVertexArray,E.x,E.y,0,0,1,1,0),_.push(E.x),_.push(E.y);}}}for(var P=Io(_,A),M=0;M<P.length;M+=3)this.indexArray.emplaceBack(S+P[M],S+P[M+2],S+P[M+1]);c.primitiveLength+=P.length/3,c.vertexLength+=u;}}var B;this.programConfigurations.populatePaintArrays(this.layoutVertexArray.length,t,r,i,n);},On(\"FillExtrusionBucket\",Ss,{omit:[\"layers\",\"features\"]});var Is={paint:new wi({\"fill-extrusion-opacity\":new mi(Et[\"paint_fill-extrusion\"][\"fill-extrusion-opacity\"]),\"fill-extrusion-color\":new vi(Et[\"paint_fill-extrusion\"][\"fill-extrusion-color\"]),\"fill-extrusion-translate\":new mi(Et[\"paint_fill-extrusion\"][\"fill-extrusion-translate\"]),\"fill-extrusion-translate-anchor\":new mi(Et[\"paint_fill-extrusion\"][\"fill-extrusion-translate-anchor\"]),\"fill-extrusion-pattern\":new gi(Et[\"paint_fill-extrusion\"][\"fill-extrusion-pattern\"]),\"fill-extrusion-height\":new vi(Et[\"paint_fill-extrusion\"][\"fill-extrusion-height\"]),\"fill-extrusion-base\":new vi(Et[\"paint_fill-extrusion\"][\"fill-extrusion-base\"]),\"fill-extrusion-vertical-gradient\":new mi(Et[\"paint_fill-extrusion\"][\"fill-extrusion-vertical-gradient\"])})},zs=function(t){function e(e){t.call(this,e,Is);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.createBucket=function(t){return new Ss(t)},e.prototype.queryRadius=function(){return eo(this.paint.get(\"fill-extrusion-translate\"))},e.prototype.is3D=function(){return !0},e.prototype.queryIntersectsFeature=function(t,e,r,n,a,o,s,u){var l=ro(t,this.paint.get(\"fill-extrusion-translate\"),this.paint.get(\"fill-extrusion-translate-anchor\"),o.angle,s),p=this.paint.get(\"fill-extrusion-height\").evaluate(e,r),c=this.paint.get(\"fill-extrusion-base\").evaluate(e,r),h=function(t,e,r,n){for(var a=[],o=0,s=t;o<s.length;o+=1){var u=s[o],l=[u.x,u.y,0,1];po(l,l,e),a.push(new i(l[0]/l[3],l[1]/l[3]));}return a}(l,u),f=function(t,e,r,n){for(var a=[],o=[],s=n[8]*e,u=n[9]*e,l=n[10]*e,p=n[11]*e,c=n[8]*r,h=n[9]*r,f=n[10]*r,y=n[11]*r,d=0,m=t;d<m.length;d+=1){for(var v=[],g=[],x=0,b=m[d];x<b.length;x+=1){var w=b[x],_=w.x,A=w.y,S=n[0]*_+n[4]*A+n[12],k=n[1]*_+n[5]*A+n[13],I=n[2]*_+n[6]*A+n[14],z=n[3]*_+n[7]*A+n[15],C=I+l,E=z+p,P=S+c,M=k+h,B=I+f,T=z+y,V=new i((S+s)/E,(k+u)/E);V.z=C/E,v.push(V);var F=new i(P/T,M/T);F.z=B/T,g.push(F);}a.push(v),o.push(g);}return [a,o]}(n,c,p,u);return function(t,e,r){var n=1/0;Ga(r,e)&&(n=Es(r,e[0]));for(var i=0;i<e.length;i++)for(var a=e[i],o=t[i],s=0;s<a.length-1;s++){var u=a[s],l=[u,a[s+1],o[s+1],o[s],u];Na(r,l)&&(n=Math.min(n,Es(r,l)));}return n!==1/0&&n}(f[0],f[1],h)},e}(_i);function Cs(t,e){return t.x*e.x+t.y*e.y}function Es(t,e){if(1===t.length){for(var r,n=0,i=e[n++];!r||i.equals(r);)if(!(r=e[n++]))return 1/0;for(;n<e.length;n++){var a=e[n],o=t[0],s=r.sub(i),u=a.sub(i),l=o.sub(i),p=Cs(s,s),c=Cs(s,u),h=Cs(u,u),f=Cs(l,s),y=Cs(l,u),d=p*h-c*c,m=(h*f-c*y)/d,v=(p*y-c*f)/d,g=i.z*(1-m-v)+r.z*m+a.z*v;if(isFinite(g))return g}return 1/0}for(var x=1/0,b=0,w=e;b<w.length;b+=1)x=Math.min(x,w[b].z);return x}var Ps=Ii([{name:\"a_pos_normal\",components:2,type:\"Int16\"},{name:\"a_data\",components:4,type:\"Uint8\"}],4).members,Ms=Ii([{name:\"a_uv_x\",components:1,type:\"Float32\"},{name:\"a_split_index\",components:1,type:\"Float32\"}]).members,Bs=bs.VectorTileFeature.types,Ts=Math.cos(Math.PI/180*37.5),Vs=Math.pow(2,14)/.5,Fs=function(t){var e=this;this.zoom=t.zoom,this.overscaling=t.overscaling,this.layers=t.layers,this.layerIds=this.layers.map((function(t){return t.id})),this.index=t.index,this.hasPattern=!1,this.patternFeatures=[],this.lineClipsArray=[],this.gradients={},this.layers.forEach((function(t){e.gradients[t.id]={};})),this.layoutVertexArray=new Mi,this.layoutVertexArray2=new Bi,this.indexArray=new ji,this.programConfigurations=new Va(t.layers,t.zoom),this.segments=new sa,this.maxLineLength=0,this.stateDependentLayerIds=this.layers.filter((function(t){return t.isStateDependent()})).map((function(t){return t.id}));};Fs.prototype.populate=function(t,e,r){this.hasPattern=as(\"line\",this.layers,e);for(var n=this.layers[0].layout.get(\"line-sort-key\"),i=[],a=0,o=t;a<o.length;a+=1){var s=o[a],u=s.feature,l=s.id,p=s.index,c=s.sourceLayerIndex,h=this.layers[0]._featureFilter.needGeometry,f=Ua(u,h);if(this.layers[0]._featureFilter.filter(new si(this.zoom),f,r)){var y=n?n.evaluate(f,{},r):void 0,d={id:l,properties:u.properties,type:u.type,sourceLayerIndex:c,index:p,geometry:h?f.geometry:Ra(u),patterns:{},sortKey:y};i.push(d);}}n&&i.sort((function(t,e){return t.sortKey-e.sortKey}));for(var m=0,v=i;m<v.length;m+=1){var g=v[m],x=g.geometry,b=g.index,w=g.sourceLayerIndex;if(this.hasPattern){var _=os(\"line\",this.layers,g,this.zoom,e);this.patternFeatures.push(_);}else this.addFeature(g,x,b,r,{});e.featureIndex.insert(t[b].feature,x,b,w,this.index);}},Fs.prototype.update=function(t,e,r){this.stateDependentLayers.length&&this.programConfigurations.updatePaintArrays(t,e,this.stateDependentLayers,r);},Fs.prototype.addFeatures=function(t,e,r){for(var n=0,i=this.patternFeatures;n<i.length;n+=1){var a=i[n];this.addFeature(a,a.geometry,a.index,e,r);}},Fs.prototype.isEmpty=function(){return 0===this.layoutVertexArray.length},Fs.prototype.uploadPending=function(){return !this.uploaded||this.programConfigurations.needsUpload},Fs.prototype.upload=function(t){this.uploaded||(0!==this.layoutVertexArray2.length&&(this.layoutVertexBuffer2=t.createVertexBuffer(this.layoutVertexArray2,Ms)),this.layoutVertexBuffer=t.createVertexBuffer(this.layoutVertexArray,Ps),this.indexBuffer=t.createIndexBuffer(this.indexArray)),this.programConfigurations.upload(t),this.uploaded=!0;},Fs.prototype.destroy=function(){this.layoutVertexBuffer&&(this.layoutVertexBuffer.destroy(),this.indexBuffer.destroy(),this.programConfigurations.destroy(),this.segments.destroy());},Fs.prototype.lineFeatureClips=function(t){if(t.properties&&t.properties.hasOwnProperty(\"mapbox_clip_start\")&&t.properties.hasOwnProperty(\"mapbox_clip_end\"))return {start:+t.properties.mapbox_clip_start,end:+t.properties.mapbox_clip_end}},Fs.prototype.addFeature=function(t,e,r,n,i){var a=this.layers[0].layout,o=a.get(\"line-join\").evaluate(t,{}),s=a.get(\"line-cap\"),u=a.get(\"line-miter-limit\"),l=a.get(\"line-round-limit\");this.lineClips=this.lineFeatureClips(t);for(var p=0,c=e;p<c.length;p+=1)this.addLine(c[p],t,o,s,u,l);this.programConfigurations.populatePaintArrays(this.layoutVertexArray.length,t,r,i,n);},Fs.prototype.addLine=function(t,e,r,n,i,a){if(this.distance=0,this.scaledDistance=0,this.totalDistance=0,this.lineClips){this.lineClipsArray.push(this.lineClips);for(var o=0;o<t.length-1;o++)this.totalDistance+=t[o].dist(t[o+1]);this.updateScaledDistance(),this.maxLineLength=Math.max(this.maxLineLength,this.totalDistance);}for(var s=\"Polygon\"===Bs[e.type],u=t.length;u>=2&&t[u-1].equals(t[u-2]);)u--;for(var l=0;l<u-1&&t[l].equals(t[l+1]);)l++;if(!(u<(s?3:2))){\"bevel\"===r&&(i=1.05);var p,c=this.overscaling<=16?122880/(512*this.overscaling):0,h=this.segments.prepareSegment(10*u,this.layoutVertexArray,this.indexArray),f=void 0,y=void 0,d=void 0,m=void 0;this.e1=this.e2=-1,s&&(m=t[l].sub(p=t[u-2])._unit()._perp());for(var v=l;v<u;v++)if(!(y=v===u-1?s?t[l+1]:void 0:t[v+1])||!t[v].equals(y)){m&&(d=m),p&&(f=p),p=t[v],m=y?y.sub(p)._unit()._perp():d;var g=(d=d||m).add(m);0===g.x&&0===g.y||g._unit();var x=d.x*m.x+d.y*m.y,b=g.x*m.x+g.y*m.y,w=0!==b?1/b:1/0,_=2*Math.sqrt(2-2*b),A=b<Ts&&f&&y,S=d.x*m.y-d.y*m.x>0;if(A&&v>l){var k=p.dist(f);if(k>2*c){var I=p.sub(p.sub(f)._mult(c/k)._round());this.updateDistance(f,I),this.addCurrentVertex(I,d,0,0,h),f=I;}}var z=f&&y,C=z?r:s?\"butt\":n;if(z&&\"round\"===C&&(w<a?C=\"miter\":w<=2&&(C=\"fakeround\")),\"miter\"===C&&w>i&&(C=\"bevel\"),\"bevel\"===C&&(w>2&&(C=\"flipbevel\"),w<i&&(C=\"miter\")),f&&this.updateDistance(f,p),\"miter\"===C)g._mult(w),this.addCurrentVertex(p,g,0,0,h);else if(\"flipbevel\"===C){if(w>100)g=m.mult(-1);else {var E=w*d.add(m).mag()/d.sub(m).mag();g._perp()._mult(E*(S?-1:1));}this.addCurrentVertex(p,g,0,0,h),this.addCurrentVertex(p,g.mult(-1),0,0,h);}else if(\"bevel\"===C||\"fakeround\"===C){var P=-Math.sqrt(w*w-1),M=S?P:0,B=S?0:P;if(f&&this.addCurrentVertex(p,d,M,B,h),\"fakeround\"===C)for(var T=Math.round(180*_/Math.PI/20),V=1;V<T;V++){var F=V/T;if(.5!==F){var D=F-.5;F+=F*D*(F-1)*((1.0904+x*(x*(3.55645-1.43519*x)-3.2452))*D*D+(.848013+x*(.215638*x-1.06021)));}var L=m.sub(d)._mult(F)._add(d)._unit()._mult(S?-1:1);this.addHalfVertex(p,L.x,L.y,!1,S,0,h);}y&&this.addCurrentVertex(p,m,-M,-B,h);}else if(\"butt\"===C)this.addCurrentVertex(p,g,0,0,h);else if(\"square\"===C){var O=f?1:-1;this.addCurrentVertex(p,g,O,O,h);}else \"round\"===C&&(f&&(this.addCurrentVertex(p,d,0,0,h),this.addCurrentVertex(p,d,1,1,h,!0)),y&&(this.addCurrentVertex(p,m,-1,-1,h,!0),this.addCurrentVertex(p,m,0,0,h)));if(A&&v<u-1){var R=p.dist(y);if(R>2*c){var U=p.add(y.sub(p)._mult(c/R)._round());this.updateDistance(p,U),this.addCurrentVertex(U,m,0,0,h),p=U;}}}}},Fs.prototype.addCurrentVertex=function(t,e,r,n,i,a){void 0===a&&(a=!1);var o=e.y*n-e.x,s=-e.y-e.x*n;this.addHalfVertex(t,e.x+e.y*r,e.y-e.x*r,a,!1,r,i),this.addHalfVertex(t,o,s,a,!0,-n,i),this.distance>Vs/2&&0===this.totalDistance&&(this.distance=0,this.addCurrentVertex(t,e,r,n,i,a));},Fs.prototype.addHalfVertex=function(t,e,r,n,i,a,o){var s=.5*(this.lineClips?this.scaledDistance*(Vs-1):this.scaledDistance);this.layoutVertexArray.emplaceBack((t.x<<1)+(n?1:0),(t.y<<1)+(i?1:0),Math.round(63*e)+128,Math.round(63*r)+128,1+(0===a?0:a<0?-1:1)|(63&s)<<2,s>>6),this.lineClips&&this.layoutVertexArray2.emplaceBack((this.scaledDistance-this.lineClips.start)/(this.lineClips.end-this.lineClips.start),this.lineClipsArray.length);var u=o.vertexLength++;this.e1>=0&&this.e2>=0&&(this.indexArray.emplaceBack(this.e1,this.e2,u),o.primitiveLength++),i?this.e2=u:this.e1=u;},Fs.prototype.updateScaledDistance=function(){this.scaledDistance=this.lineClips?this.lineClips.start+(this.lineClips.end-this.lineClips.start)*this.distance/this.totalDistance:this.distance;},Fs.prototype.updateDistance=function(t,e){this.distance+=t.dist(e),this.updateScaledDistance();},On(\"LineBucket\",Fs,{omit:[\"layers\",\"patternFeatures\"]});var Ds=new wi({\"line-cap\":new mi(Et.layout_line[\"line-cap\"]),\"line-join\":new vi(Et.layout_line[\"line-join\"]),\"line-miter-limit\":new mi(Et.layout_line[\"line-miter-limit\"]),\"line-round-limit\":new mi(Et.layout_line[\"line-round-limit\"]),\"line-sort-key\":new vi(Et.layout_line[\"line-sort-key\"])}),Ls={paint:new wi({\"line-opacity\":new vi(Et.paint_line[\"line-opacity\"]),\"line-color\":new vi(Et.paint_line[\"line-color\"]),\"line-translate\":new mi(Et.paint_line[\"line-translate\"]),\"line-translate-anchor\":new mi(Et.paint_line[\"line-translate-anchor\"]),\"line-width\":new vi(Et.paint_line[\"line-width\"]),\"line-gap-width\":new vi(Et.paint_line[\"line-gap-width\"]),\"line-offset\":new vi(Et.paint_line[\"line-offset\"]),\"line-blur\":new vi(Et.paint_line[\"line-blur\"]),\"line-dasharray\":new xi(Et.paint_line[\"line-dasharray\"]),\"line-pattern\":new gi(Et.paint_line[\"line-pattern\"]),\"line-gradient\":new bi(Et.paint_line[\"line-gradient\"])}),layout:Ds},Os=new(function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.possiblyEvaluate=function(e,r){return r=new si(Math.floor(r.zoom),{now:r.now,fadeDuration:r.fadeDuration,zoomHistory:r.zoomHistory,transition:r.transition}),t.prototype.possiblyEvaluate.call(this,e,r)},e.prototype.evaluate=function(e,r,n,i){return r=h({},r,{zoom:Math.floor(r.zoom)}),t.prototype.evaluate.call(this,e,r,n,i)},e}(vi))(Ls.paint.properties[\"line-width\"].specification);Os.useIntegerZoom=!0;var Rs=function(t){function e(e){t.call(this,e,Ls),this.gradientVersion=0;}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._handleSpecialPaintPropertyUpdate=function(t){\"line-gradient\"===t&&(this.stepInterpolant=this._transitionablePaint._values[\"line-gradient\"].value.expression._styleExpression.expression instanceof Ne,this.gradientVersion=(this.gradientVersion+1)%s);},e.prototype.gradientExpression=function(){return this._transitionablePaint._values[\"line-gradient\"].value.expression},e.prototype.recalculate=function(e,r){t.prototype.recalculate.call(this,e,r),this.paint._values[\"line-floorwidth\"]=Os.possiblyEvaluate(this._transitioningPaint._values[\"line-width\"].value,e);},e.prototype.createBucket=function(t){return new Fs(t)},e.prototype.queryRadius=function(t){var e=t,r=Us(to(\"line-width\",this,e),to(\"line-gap-width\",this,e)),n=to(\"line-offset\",this,e);return r/2+Math.abs(n)+eo(this.paint.get(\"line-translate\"))},e.prototype.queryIntersectsFeature=function(t,e,r,n,a,o,s){var u=ro(t,this.paint.get(\"line-translate\"),this.paint.get(\"line-translate-anchor\"),o.angle,s),l=s/2*Us(this.paint.get(\"line-width\").evaluate(e,r),this.paint.get(\"line-gap-width\").evaluate(e,r)),p=this.paint.get(\"line-offset\").evaluate(e,r);return p&&(n=function(t,e){for(var r=[],n=new i(0,0),a=0;a<t.length;a++){for(var o=t[a],s=[],u=0;u<o.length;u++){var l=o[u],p=o[u+1],c=0===u?n:l.sub(o[u-1])._unit()._perp(),h=u===o.length-1?n:p.sub(l)._unit()._perp(),f=c._add(h)._unit();f._mult(1/(f.x*h.x+f.y*h.y)),s.push(f._mult(e)._add(l));}r.push(s);}return r}(n,p*s)),function(t,e,r){for(var n=0;n<e.length;n++){var i=e[n];if(t.length>=3)for(var a=0;a<i.length;a++)if(Wa(t,i[a]))return !0;if(Za(t,i,r))return !0}return !1}(u,n,l)},e.prototype.isTileClipped=function(){return !0},e}(_i);function Us(t,e){return e>0?e+2*t:t}var js=Ii([{name:\"a_pos_offset\",components:4,type:\"Int16\"},{name:\"a_data\",components:4,type:\"Uint16\"},{name:\"a_pixeloffset\",components:4,type:\"Int16\"}],4),qs=Ii([{name:\"a_projected_pos\",components:3,type:\"Float32\"}],4),Ns=(Ii([{name:\"a_fade_opacity\",components:1,type:\"Uint32\"}],4),Ii([{name:\"a_placed\",components:2,type:\"Uint8\"},{name:\"a_shift\",components:2,type:\"Float32\"}])),Ks=(Ii([{type:\"Int16\",name:\"anchorPointX\"},{type:\"Int16\",name:\"anchorPointY\"},{type:\"Int16\",name:\"x1\"},{type:\"Int16\",name:\"y1\"},{type:\"Int16\",name:\"x2\"},{type:\"Int16\",name:\"y2\"},{type:\"Uint32\",name:\"featureIndex\"},{type:\"Uint16\",name:\"sourceLayerIndex\"},{type:\"Uint16\",name:\"bucketIndex\"}]),Ii([{name:\"a_pos\",components:2,type:\"Int16\"},{name:\"a_anchor_pos\",components:2,type:\"Int16\"},{name:\"a_extrude\",components:2,type:\"Int16\"}],4)),Gs=Ii([{name:\"a_pos\",components:2,type:\"Float32\"},{name:\"a_radius\",components:1,type:\"Float32\"},{name:\"a_flags\",components:2,type:\"Int16\"}],4);function Zs(t,e,r){return t.sections.forEach((function(t){t.text=function(t,e,r){var n=e.layout.get(\"text-transform\").evaluate(r,{});return \"uppercase\"===n?t=t.toLocaleUpperCase():\"lowercase\"===n&&(t=t.toLocaleLowerCase()),oi.applyArabicShaping&&(t=oi.applyArabicShaping(t)),t}(t.text,e,r);})),t}Ii([{name:\"triangle\",components:3,type:\"Uint16\"}]),Ii([{type:\"Int16\",name:\"anchorX\"},{type:\"Int16\",name:\"anchorY\"},{type:\"Uint16\",name:\"glyphStartIndex\"},{type:\"Uint16\",name:\"numGlyphs\"},{type:\"Uint32\",name:\"vertexStartIndex\"},{type:\"Uint32\",name:\"lineStartIndex\"},{type:\"Uint32\",name:\"lineLength\"},{type:\"Uint16\",name:\"segment\"},{type:\"Uint16\",name:\"lowerSize\"},{type:\"Uint16\",name:\"upperSize\"},{type:\"Float32\",name:\"lineOffsetX\"},{type:\"Float32\",name:\"lineOffsetY\"},{type:\"Uint8\",name:\"writingMode\"},{type:\"Uint8\",name:\"placedOrientation\"},{type:\"Uint8\",name:\"hidden\"},{type:\"Uint32\",name:\"crossTileID\"},{type:\"Int16\",name:\"associatedIconIndex\"}]),Ii([{type:\"Int16\",name:\"anchorX\"},{type:\"Int16\",name:\"anchorY\"},{type:\"Int16\",name:\"rightJustifiedTextSymbolIndex\"},{type:\"Int16\",name:\"centerJustifiedTextSymbolIndex\"},{type:\"Int16\",name:\"leftJustifiedTextSymbolIndex\"},{type:\"Int16\",name:\"verticalPlacedTextSymbolIndex\"},{type:\"Int16\",name:\"placedIconSymbolIndex\"},{type:\"Int16\",name:\"verticalPlacedIconSymbolIndex\"},{type:\"Uint16\",name:\"key\"},{type:\"Uint16\",name:\"textBoxStartIndex\"},{type:\"Uint16\",name:\"textBoxEndIndex\"},{type:\"Uint16\",name:\"verticalTextBoxStartIndex\"},{type:\"Uint16\",name:\"verticalTextBoxEndIndex\"},{type:\"Uint16\",name:\"iconBoxStartIndex\"},{type:\"Uint16\",name:\"iconBoxEndIndex\"},{type:\"Uint16\",name:\"verticalIconBoxStartIndex\"},{type:\"Uint16\",name:\"verticalIconBoxEndIndex\"},{type:\"Uint16\",name:\"featureIndex\"},{type:\"Uint16\",name:\"numHorizontalGlyphVertices\"},{type:\"Uint16\",name:\"numVerticalGlyphVertices\"},{type:\"Uint16\",name:\"numIconVertices\"},{type:\"Uint16\",name:\"numVerticalIconVertices\"},{type:\"Uint16\",name:\"useRuntimeCollisionCircles\"},{type:\"Uint32\",name:\"crossTileID\"},{type:\"Float32\",name:\"textBoxScale\"},{type:\"Float32\",components:2,name:\"textOffset\"},{type:\"Float32\",name:\"collisionCircleDiameter\"}]),Ii([{type:\"Float32\",name:\"offsetX\"}]),Ii([{type:\"Int16\",name:\"x\"},{type:\"Int16\",name:\"y\"},{type:\"Int16\",name:\"tileUnitDistanceFromAnchor\"}]);var Xs={\"!\":\"︕\",\"#\":\"＃\",$:\"＄\",\"%\":\"％\",\"&\":\"＆\",\"(\":\"︵\",\")\":\"︶\",\"*\":\"＊\",\"+\":\"＋\",\",\":\"︐\",\"-\":\"︲\",\".\":\"・\",\"/\":\"／\",\":\":\"︓\",\";\":\"︔\",\"<\":\"︿\",\"=\":\"＝\",\">\":\"﹀\",\"?\":\"︖\",\"@\":\"＠\",\"[\":\"﹇\",\"\\\\\":\"＼\",\"]\":\"﹈\",\"^\":\"＾\",_:\"︳\",\"`\":\"｀\",\"{\":\"︷\",\"|\":\"―\",\"}\":\"︸\",\"~\":\"～\",\"¢\":\"￠\",\"£\":\"￡\",\"¥\":\"￥\",\"¦\":\"￤\",\"¬\":\"￢\",\"¯\":\"￣\",\"–\":\"︲\",\"—\":\"︱\",\"‘\":\"﹃\",\"’\":\"﹄\",\"“\":\"﹁\",\"”\":\"﹂\",\"…\":\"︙\",\"‧\":\"・\",\"₩\":\"￦\",\"、\":\"︑\",\"。\":\"︒\",\"〈\":\"︿\",\"〉\":\"﹀\",\"《\":\"︽\",\"》\":\"︾\",\"「\":\"﹁\",\"」\":\"﹂\",\"『\":\"﹃\",\"』\":\"﹄\",\"【\":\"︻\",\"】\":\"︼\",\"〔\":\"︹\",\"〕\":\"︺\",\"〖\":\"︗\",\"〗\":\"︘\",\"！\":\"︕\",\"（\":\"︵\",\"）\":\"︶\",\"，\":\"︐\",\"－\":\"︲\",\"．\":\"・\",\"：\":\"︓\",\"；\":\"︔\",\"＜\":\"︿\",\"＞\":\"﹀\",\"？\":\"︖\",\"［\":\"﹇\",\"］\":\"﹈\",\"＿\":\"︳\",\"｛\":\"︷\",\"｜\":\"―\",\"｝\":\"︸\",\"｟\":\"︵\",\"｠\":\"︶\",\"｡\":\"︒\",\"｢\":\"﹁\",\"｣\":\"﹂\"},Js=function(t,e,r,n,i){var a,o,s=8*i-n-1,u=(1<<s)-1,l=u>>1,p=-7,c=r?i-1:0,h=r?-1:1,f=t[e+c];for(c+=h,a=f&(1<<-p)-1,f>>=-p,p+=s;p>0;a=256*a+t[e+c],c+=h,p-=8);for(o=a&(1<<-p)-1,a>>=-p,p+=n;p>0;o=256*o+t[e+c],c+=h,p-=8);if(0===a)a=1-l;else {if(a===u)return o?NaN:1/0*(f?-1:1);o+=Math.pow(2,n),a-=l;}return (f?-1:1)*o*Math.pow(2,a-n)},Hs=function(t,e,r,n,i,a){var o,s,u,l=8*a-i-1,p=(1<<l)-1,c=p>>1,h=23===i?Math.pow(2,-24)-Math.pow(2,-77):0,f=n?0:a-1,y=n?1:-1,d=e<0||0===e&&1/e<0?1:0;for(e=Math.abs(e),isNaN(e)||e===1/0?(s=isNaN(e)?1:0,o=p):(o=Math.floor(Math.log(e)/Math.LN2),e*(u=Math.pow(2,-o))<1&&(o--,u*=2),(e+=o+c>=1?h/u:h*Math.pow(2,1-c))*u>=2&&(o++,u/=2),o+c>=p?(s=0,o=p):o+c>=1?(s=(e*u-1)*Math.pow(2,i),o+=c):(s=e*Math.pow(2,c-1)*Math.pow(2,i),o=0));i>=8;t[r+f]=255&s,f+=y,s/=256,i-=8);for(o=o<<i|s,l+=i;l>0;t[r+f]=255&o,f+=y,o/=256,l-=8);t[r+f-y]|=128*d;},Ys=$s;function $s(t){this.buf=ArrayBuffer.isView&&ArrayBuffer.isView(t)?t:new Uint8Array(t||0),this.pos=0,this.type=0,this.length=this.buf.length;}$s.Varint=0,$s.Fixed64=1,$s.Bytes=2,$s.Fixed32=5;var Ws=\"undefined\"==typeof TextDecoder?null:new TextDecoder(\"utf8\");function Qs(t){return t.type===$s.Bytes?t.readVarint()+t.pos:t.pos+1}function tu(t,e,r){return r?4294967296*e+(t>>>0):4294967296*(e>>>0)+(t>>>0)}function eu(t,e,r){var n=e<=16383?1:e<=2097151?2:e<=268435455?3:Math.floor(Math.log(e)/(7*Math.LN2));r.realloc(n);for(var i=r.pos-1;i>=t;i--)r.buf[i+n]=r.buf[i];}function ru(t,e){for(var r=0;r<t.length;r++)e.writeVarint(t[r]);}function nu(t,e){for(var r=0;r<t.length;r++)e.writeSVarint(t[r]);}function iu(t,e){for(var r=0;r<t.length;r++)e.writeFloat(t[r]);}function au(t,e){for(var r=0;r<t.length;r++)e.writeDouble(t[r]);}function ou(t,e){for(var r=0;r<t.length;r++)e.writeBoolean(t[r]);}function su(t,e){for(var r=0;r<t.length;r++)e.writeFixed32(t[r]);}function uu(t,e){for(var r=0;r<t.length;r++)e.writeSFixed32(t[r]);}function lu(t,e){for(var r=0;r<t.length;r++)e.writeFixed64(t[r]);}function pu(t,e){for(var r=0;r<t.length;r++)e.writeSFixed64(t[r]);}function cu(t,e){return (t[e]|t[e+1]<<8|t[e+2]<<16)+16777216*t[e+3]}function hu(t,e,r){t[r]=e,t[r+1]=e>>>8,t[r+2]=e>>>16,t[r+3]=e>>>24;}function fu(t,e){return (t[e]|t[e+1]<<8|t[e+2]<<16)+(t[e+3]<<24)}function yu(t,e,r){1===t&&r.readMessage(du,e);}function du(t,e,r){if(3===t){var n=r.readMessage(mu,{}),i=n.width,a=n.height,o=n.left,s=n.top,u=n.advance;e.push({id:n.id,bitmap:new go({width:i+6,height:a+6},n.bitmap),metrics:{width:i,height:a,left:o,top:s,advance:u}});}}function mu(t,e,r){1===t?e.id=r.readVarint():2===t?e.bitmap=r.readBytes():3===t?e.width=r.readVarint():4===t?e.height=r.readVarint():5===t?e.left=r.readSVarint():6===t?e.top=r.readSVarint():7===t&&(e.advance=r.readVarint());}function vu(t){for(var e=0,r=0,n=0,i=t;n<i.length;n+=1){var a=i[n];e+=a.w*a.h,r=Math.max(r,a.w);}t.sort((function(t,e){return e.h-t.h}));for(var o=[{x:0,y:0,w:Math.max(Math.ceil(Math.sqrt(e/.95)),r),h:1/0}],s=0,u=0,l=0,p=t;l<p.length;l+=1)for(var c=p[l],h=o.length-1;h>=0;h--){var f=o[h];if(!(c.w>f.w||c.h>f.h)){if(c.x=f.x,c.y=f.y,u=Math.max(u,c.y+c.h),s=Math.max(s,c.x+c.w),c.w===f.w&&c.h===f.h){var y=o.pop();h<o.length&&(o[h]=y);}else c.h===f.h?(f.x+=c.w,f.w-=c.w):c.w===f.w?(f.y+=c.h,f.h-=c.h):(o.push({x:f.x+c.w,y:f.y,w:f.w-c.w,h:c.h}),f.y+=c.h,f.h-=c.h);break}}return {w:s,h:u,fill:e/(s*u)||0}}$s.prototype={destroy:function(){this.buf=null;},readFields:function(t,e,r){for(r=r||this.length;this.pos<r;){var n=this.readVarint(),i=n>>3,a=this.pos;this.type=7&n,t(i,e,this),this.pos===a&&this.skip(n);}return e},readMessage:function(t,e){return this.readFields(t,e,this.readVarint()+this.pos)},readFixed32:function(){var t=cu(this.buf,this.pos);return this.pos+=4,t},readSFixed32:function(){var t=fu(this.buf,this.pos);return this.pos+=4,t},readFixed64:function(){var t=cu(this.buf,this.pos)+4294967296*cu(this.buf,this.pos+4);return this.pos+=8,t},readSFixed64:function(){var t=cu(this.buf,this.pos)+4294967296*fu(this.buf,this.pos+4);return this.pos+=8,t},readFloat:function(){var t=Js(this.buf,this.pos,!0,23,4);return this.pos+=4,t},readDouble:function(){var t=Js(this.buf,this.pos,!0,52,8);return this.pos+=8,t},readVarint:function(t){var e,r,n=this.buf;return e=127&(r=n[this.pos++]),r<128?e:(e|=(127&(r=n[this.pos++]))<<7,r<128?e:(e|=(127&(r=n[this.pos++]))<<14,r<128?e:(e|=(127&(r=n[this.pos++]))<<21,r<128?e:function(t,e,r){var n,i,a=r.buf;if(n=(112&(i=a[r.pos++]))>>4,i<128)return tu(t,n,e);if(n|=(127&(i=a[r.pos++]))<<3,i<128)return tu(t,n,e);if(n|=(127&(i=a[r.pos++]))<<10,i<128)return tu(t,n,e);if(n|=(127&(i=a[r.pos++]))<<17,i<128)return tu(t,n,e);if(n|=(127&(i=a[r.pos++]))<<24,i<128)return tu(t,n,e);if(n|=(1&(i=a[r.pos++]))<<31,i<128)return tu(t,n,e);throw new Error(\"Expected varint not more than 10 bytes\")}(e|=(15&(r=n[this.pos]))<<28,t,this))))},readVarint64:function(){return this.readVarint(!0)},readSVarint:function(){var t=this.readVarint();return t%2==1?(t+1)/-2:t/2},readBoolean:function(){return Boolean(this.readVarint())},readString:function(){var t=this.readVarint()+this.pos,e=this.pos;return this.pos=t,t-e>=12&&Ws?function(t,e,r){return Ws.decode(t.subarray(e,r))}(this.buf,e,t):function(t,e,r){for(var n=\"\",i=e;i<r;){var a,o,s,u=t[i],l=null,p=u>239?4:u>223?3:u>191?2:1;if(i+p>r)break;1===p?u<128&&(l=u):2===p?128==(192&(a=t[i+1]))&&(l=(31&u)<<6|63&a)<=127&&(l=null):3===p?(o=t[i+2],128==(192&(a=t[i+1]))&&128==(192&o)&&((l=(15&u)<<12|(63&a)<<6|63&o)<=2047||l>=55296&&l<=57343)&&(l=null)):4===p&&(o=t[i+2],s=t[i+3],128==(192&(a=t[i+1]))&&128==(192&o)&&128==(192&s)&&((l=(15&u)<<18|(63&a)<<12|(63&o)<<6|63&s)<=65535||l>=1114112)&&(l=null)),null===l?(l=65533,p=1):l>65535&&(l-=65536,n+=String.fromCharCode(l>>>10&1023|55296),l=56320|1023&l),n+=String.fromCharCode(l),i+=p;}return n}(this.buf,e,t)},readBytes:function(){var t=this.readVarint()+this.pos,e=this.buf.subarray(this.pos,t);return this.pos=t,e},readPackedVarint:function(t,e){if(this.type!==$s.Bytes)return t.push(this.readVarint(e));var r=Qs(this);for(t=t||[];this.pos<r;)t.push(this.readVarint(e));return t},readPackedSVarint:function(t){if(this.type!==$s.Bytes)return t.push(this.readSVarint());var e=Qs(this);for(t=t||[];this.pos<e;)t.push(this.readSVarint());return t},readPackedBoolean:function(t){if(this.type!==$s.Bytes)return t.push(this.readBoolean());var e=Qs(this);for(t=t||[];this.pos<e;)t.push(this.readBoolean());return t},readPackedFloat:function(t){if(this.type!==$s.Bytes)return t.push(this.readFloat());var e=Qs(this);for(t=t||[];this.pos<e;)t.push(this.readFloat());return t},readPackedDouble:function(t){if(this.type!==$s.Bytes)return t.push(this.readDouble());var e=Qs(this);for(t=t||[];this.pos<e;)t.push(this.readDouble());return t},readPackedFixed32:function(t){if(this.type!==$s.Bytes)return t.push(this.readFixed32());var e=Qs(this);for(t=t||[];this.pos<e;)t.push(this.readFixed32());return t},readPackedSFixed32:function(t){if(this.type!==$s.Bytes)return t.push(this.readSFixed32());var e=Qs(this);for(t=t||[];this.pos<e;)t.push(this.readSFixed32());return t},readPackedFixed64:function(t){if(this.type!==$s.Bytes)return t.push(this.readFixed64());var e=Qs(this);for(t=t||[];this.pos<e;)t.push(this.readFixed64());return t},readPackedSFixed64:function(t){if(this.type!==$s.Bytes)return t.push(this.readSFixed64());var e=Qs(this);for(t=t||[];this.pos<e;)t.push(this.readSFixed64());return t},skip:function(t){var e=7&t;if(e===$s.Varint)for(;this.buf[this.pos++]>127;);else if(e===$s.Bytes)this.pos=this.readVarint()+this.pos;else if(e===$s.Fixed32)this.pos+=4;else {if(e!==$s.Fixed64)throw new Error(\"Unimplemented type: \"+e);this.pos+=8;}},writeTag:function(t,e){this.writeVarint(t<<3|e);},realloc:function(t){for(var e=this.length||16;e<this.pos+t;)e*=2;if(e!==this.length){var r=new Uint8Array(e);r.set(this.buf),this.buf=r,this.length=e;}},finish:function(){return this.length=this.pos,this.pos=0,this.buf.subarray(0,this.length)},writeFixed32:function(t){this.realloc(4),hu(this.buf,t,this.pos),this.pos+=4;},writeSFixed32:function(t){this.realloc(4),hu(this.buf,t,this.pos),this.pos+=4;},writeFixed64:function(t){this.realloc(8),hu(this.buf,-1&t,this.pos),hu(this.buf,Math.floor(t*(1/4294967296)),this.pos+4),this.pos+=8;},writeSFixed64:function(t){this.realloc(8),hu(this.buf,-1&t,this.pos),hu(this.buf,Math.floor(t*(1/4294967296)),this.pos+4),this.pos+=8;},writeVarint:function(t){(t=+t||0)>268435455||t<0?function(t,e){var r,n;if(t>=0?(r=t%4294967296|0,n=t/4294967296|0):(n=~(-t/4294967296),4294967295^(r=~(-t%4294967296))?r=r+1|0:(r=0,n=n+1|0)),t>=0x10000000000000000||t<-0x10000000000000000)throw new Error(\"Given varint doesn't fit into 10 bytes\");e.realloc(10),function(t,e,r){r.buf[r.pos++]=127&t|128,t>>>=7,r.buf[r.pos++]=127&t|128,t>>>=7,r.buf[r.pos++]=127&t|128,t>>>=7,r.buf[r.pos++]=127&t|128,r.buf[r.pos]=127&(t>>>=7);}(r,0,e),function(t,e){var r=(7&t)<<4;e.buf[e.pos++]|=r|((t>>>=3)?128:0),t&&(e.buf[e.pos++]=127&t|((t>>>=7)?128:0),t&&(e.buf[e.pos++]=127&t|((t>>>=7)?128:0),t&&(e.buf[e.pos++]=127&t|((t>>>=7)?128:0),t&&(e.buf[e.pos++]=127&t|((t>>>=7)?128:0),t&&(e.buf[e.pos++]=127&t)))));}(n,e);}(t,this):(this.realloc(4),this.buf[this.pos++]=127&t|(t>127?128:0),t<=127||(this.buf[this.pos++]=127&(t>>>=7)|(t>127?128:0),t<=127||(this.buf[this.pos++]=127&(t>>>=7)|(t>127?128:0),t<=127||(this.buf[this.pos++]=t>>>7&127))));},writeSVarint:function(t){this.writeVarint(t<0?2*-t-1:2*t);},writeBoolean:function(t){this.writeVarint(Boolean(t));},writeString:function(t){t=String(t),this.realloc(4*t.length),this.pos++;var e=this.pos;this.pos=function(t,e,r){for(var n,i,a=0;a<e.length;a++){if((n=e.charCodeAt(a))>55295&&n<57344){if(!i){n>56319||a+1===e.length?(t[r++]=239,t[r++]=191,t[r++]=189):i=n;continue}if(n<56320){t[r++]=239,t[r++]=191,t[r++]=189,i=n;continue}n=i-55296<<10|n-56320|65536,i=null;}else i&&(t[r++]=239,t[r++]=191,t[r++]=189,i=null);n<128?t[r++]=n:(n<2048?t[r++]=n>>6|192:(n<65536?t[r++]=n>>12|224:(t[r++]=n>>18|240,t[r++]=n>>12&63|128),t[r++]=n>>6&63|128),t[r++]=63&n|128);}return r}(this.buf,t,this.pos);var r=this.pos-e;r>=128&&eu(e,r,this),this.pos=e-1,this.writeVarint(r),this.pos+=r;},writeFloat:function(t){this.realloc(4),Hs(this.buf,t,this.pos,!0,23,4),this.pos+=4;},writeDouble:function(t){this.realloc(8),Hs(this.buf,t,this.pos,!0,52,8),this.pos+=8;},writeBytes:function(t){var e=t.length;this.writeVarint(e),this.realloc(e);for(var r=0;r<e;r++)this.buf[this.pos++]=t[r];},writeRawMessage:function(t,e){this.pos++;var r=this.pos;t(e,this);var n=this.pos-r;n>=128&&eu(r,n,this),this.pos=r-1,this.writeVarint(n),this.pos+=n;},writeMessage:function(t,e,r){this.writeTag(t,$s.Bytes),this.writeRawMessage(e,r);},writePackedVarint:function(t,e){e.length&&this.writeMessage(t,ru,e);},writePackedSVarint:function(t,e){e.length&&this.writeMessage(t,nu,e);},writePackedBoolean:function(t,e){e.length&&this.writeMessage(t,ou,e);},writePackedFloat:function(t,e){e.length&&this.writeMessage(t,iu,e);},writePackedDouble:function(t,e){e.length&&this.writeMessage(t,au,e);},writePackedFixed32:function(t,e){e.length&&this.writeMessage(t,su,e);},writePackedSFixed32:function(t,e){e.length&&this.writeMessage(t,uu,e);},writePackedFixed64:function(t,e){e.length&&this.writeMessage(t,lu,e);},writePackedSFixed64:function(t,e){e.length&&this.writeMessage(t,pu,e);},writeBytesField:function(t,e){this.writeTag(t,$s.Bytes),this.writeBytes(e);},writeFixed32Field:function(t,e){this.writeTag(t,$s.Fixed32),this.writeFixed32(e);},writeSFixed32Field:function(t,e){this.writeTag(t,$s.Fixed32),this.writeSFixed32(e);},writeFixed64Field:function(t,e){this.writeTag(t,$s.Fixed64),this.writeFixed64(e);},writeSFixed64Field:function(t,e){this.writeTag(t,$s.Fixed64),this.writeSFixed64(e);},writeVarintField:function(t,e){this.writeTag(t,$s.Varint),this.writeVarint(e);},writeSVarintField:function(t,e){this.writeTag(t,$s.Varint),this.writeSVarint(e);},writeStringField:function(t,e){this.writeTag(t,$s.Bytes),this.writeString(e);},writeFloatField:function(t,e){this.writeTag(t,$s.Fixed32),this.writeFloat(e);},writeDoubleField:function(t,e){this.writeTag(t,$s.Fixed64),this.writeDouble(e);},writeBooleanField:function(t,e){this.writeVarintField(t,Boolean(e));}};var gu=function(t,e){var r=e.pixelRatio,n=e.version,i=e.stretchX,a=e.stretchY,o=e.content;this.paddedRect=t,this.pixelRatio=r,this.stretchX=i,this.stretchY=a,this.content=o,this.version=n;},xu={tl:{configurable:!0},br:{configurable:!0},tlbr:{configurable:!0},displaySize:{configurable:!0}};xu.tl.get=function(){return [this.paddedRect.x+1,this.paddedRect.y+1]},xu.br.get=function(){return [this.paddedRect.x+this.paddedRect.w-1,this.paddedRect.y+this.paddedRect.h-1]},xu.tlbr.get=function(){return this.tl.concat(this.br)},xu.displaySize.get=function(){return [(this.paddedRect.w-2)/this.pixelRatio,(this.paddedRect.h-2)/this.pixelRatio]},Object.defineProperties(gu.prototype,xu);var bu=function(t,e){var r={},n={};this.haveRenderCallbacks=[];var i=[];this.addImages(t,r,i),this.addImages(e,n,i);var a=vu(i),o=new xo({width:a.w||1,height:a.h||1});for(var s in t){var u=t[s],l=r[s].paddedRect;xo.copy(u.data,o,{x:0,y:0},{x:l.x+1,y:l.y+1},u.data);}for(var p in e){var c=e[p],h=n[p].paddedRect,f=h.x+1,y=h.y+1,d=c.data.width,m=c.data.height;xo.copy(c.data,o,{x:0,y:0},{x:f,y:y},c.data),xo.copy(c.data,o,{x:0,y:m-1},{x:f,y:y-1},{width:d,height:1}),xo.copy(c.data,o,{x:0,y:0},{x:f,y:y+m},{width:d,height:1}),xo.copy(c.data,o,{x:d-1,y:0},{x:f-1,y:y},{width:1,height:m}),xo.copy(c.data,o,{x:0,y:0},{x:f+d,y:y},{width:1,height:m});}this.image=o,this.iconPositions=r,this.patternPositions=n;};bu.prototype.addImages=function(t,e,r){for(var n in t){var i=t[n],a={x:0,y:0,w:i.data.width+2,h:i.data.height+2};r.push(a),e[n]=new gu(a,i),i.hasRenderCallback&&this.haveRenderCallbacks.push(n);}},bu.prototype.patchUpdatedImages=function(t,e){for(var r in t.dispatchRenderCallbacks(this.haveRenderCallbacks),t.updatedImages)this.patchUpdatedImage(this.iconPositions[r],t.getImage(r),e),this.patchUpdatedImage(this.patternPositions[r],t.getImage(r),e);},bu.prototype.patchUpdatedImage=function(t,e,r){if(t&&e&&t.version!==e.version){t.version=e.version;var n=t.tl;r.update(e.data,void 0,{x:n[0],y:n[1]});}},On(\"ImagePosition\",gu),On(\"ImageAtlas\",bu);var wu={horizontal:1,vertical:2,horizontalOnly:3},_u=function(){this.scale=1,this.fontStack=\"\",this.imageName=null;};_u.forText=function(t,e){var r=new _u;return r.scale=t||1,r.fontStack=e,r},_u.forImage=function(t){var e=new _u;return e.imageName=t,e};var Au=function(){this.text=\"\",this.sectionIndex=[],this.sections=[],this.imageSectionID=null;};function Su(t,e,r,n,i,a,o,s,u,l,p,c,h,f,y,d){var m,v=Au.fromFeature(t,i);c===wu.vertical&&v.verticalizePunctuation();var g=oi.processBidirectionalText,x=oi.processStyledBidirectionalText;if(g&&1===v.sections.length){m=[];for(var b=0,w=g(v.toString(),Mu(v,l,a,e,n,f,y));b<w.length;b+=1){var _=w[b],A=new Au;A.text=_,A.sections=v.sections;for(var S=0;S<_.length;S++)A.sectionIndex.push(0);m.push(A);}}else if(x){m=[];for(var k=0,I=x(v.text,v.sectionIndex,Mu(v,l,a,e,n,f,y));k<I.length;k+=1){var z=I[k],C=new Au;C.text=z[0],C.sectionIndex=z[1],C.sections=v.sections,m.push(C);}}else m=function(t,e){for(var r=[],n=t.text,i=0,a=0,o=e;a<o.length;a+=1){var s=o[a];r.push(t.substring(i,s)),i=s;}return i<n.length&&r.push(t.substring(i,n.length)),r}(v,Mu(v,l,a,e,n,f,y));var E=[],P={positionedLines:E,text:v.toString(),top:p[1],bottom:p[1],left:p[0],right:p[0],writingMode:c,iconsInText:!1,verticalizable:!1};return function(t,e,r,n,i,a,o,s,u,l,p,c){for(var h=0,f=-17,y=0,d=0,m=\"right\"===s?1:\"left\"===s?0:.5,v=0,g=0,x=i;g<x.length;g+=1){var b=x[g];b.trim();var w=b.getMaxScale(),_=24*(w-1),A={positionedGlyphs:[],lineOffset:0};t.positionedLines[v]=A;var S=A.positionedGlyphs,k=0;if(b.length()){for(var I=0;I<b.length();I++){var z=b.getSection(I),C=b.getSectionIndex(I),E=b.getCharCode(I),P=0,M=null,B=null,T=null,V=24,F=!(u===wu.horizontal||!p&&!Xn(E)||p&&(ku[E]||(K=E,Gn.Arabic(K)||Gn[\"Arabic Supplement\"](K)||Gn[\"Arabic Extended-A\"](K)||Gn[\"Arabic Presentation Forms-A\"](K)||Gn[\"Arabic Presentation Forms-B\"](K))));if(z.imageName){var D=n[z.imageName];if(!D)continue;T=z.imageName,t.iconsInText=t.iconsInText||!0,B=D.paddedRect;var L=D.displaySize;z.scale=24*z.scale/c,P=_+(24-L[1]*z.scale),V=(M={width:L[0],height:L[1],left:1,top:-3,advance:F?L[1]:L[0]}).advance;var O=F?L[0]*z.scale-24*w:L[1]*z.scale-24*w;O>0&&O>k&&(k=O);}else {var R=r[z.fontStack],U=R&&R[E];if(U&&U.rect)B=U.rect,M=U.metrics;else {var j=e[z.fontStack],q=j&&j[E];if(!q)continue;M=q.metrics;}P=24*(w-z.scale);}F?(t.verticalizable=!0,S.push({glyph:E,imageName:T,x:h,y:f+P,vertical:F,scale:z.scale,fontStack:z.fontStack,sectionIndex:C,metrics:M,rect:B}),h+=V*z.scale+l):(S.push({glyph:E,imageName:T,x:h,y:f+P,vertical:F,scale:z.scale,fontStack:z.fontStack,sectionIndex:C,metrics:M,rect:B}),h+=M.advance*z.scale+l);}0!==S.length&&(y=Math.max(h-l,y),Tu(S,0,S.length-1,m,k)),h=0;var N=a*w+k;A.lineOffset=Math.max(k,_),f+=N,d=Math.max(N,d),++v;}else f+=a,++v;}var K,G=f- -17,Z=Bu(o),X=Z.horizontalAlign,J=Z.verticalAlign;(function(t,e,r,n,i,a,o,s,u){var l,p=(e-r)*i;l=a!==o?-s*n- -17:(-n*u+.5)*o;for(var c=0,h=t;c<h.length;c+=1)for(var f=0,y=h[c].positionedGlyphs;f<y.length;f+=1){var d=y[f];d.x+=p,d.y+=l;}})(t.positionedLines,m,X,J,y,d,a,G,i.length),t.top+=-J*G,t.bottom=t.top+G,t.left+=-X*y,t.right=t.left+y;}(P,e,r,n,m,o,s,u,c,l,h,d),!function(t){for(var e=0,r=t;e<r.length;e+=1)if(0!==r[e].positionedGlyphs.length)return !1;return !0}(E)&&P}Au.fromFeature=function(t,e){for(var r=new Au,n=0;n<t.sections.length;n++){var i=t.sections[n];i.image?r.addImageSection(i):r.addTextSection(i,e);}return r},Au.prototype.length=function(){return this.text.length},Au.prototype.getSection=function(t){return this.sections[this.sectionIndex[t]]},Au.prototype.getSectionIndex=function(t){return this.sectionIndex[t]},Au.prototype.getCharCode=function(t){return this.text.charCodeAt(t)},Au.prototype.verticalizePunctuation=function(){this.text=function(t){for(var e=\"\",r=0;r<t.length;r++){var n=t.charCodeAt(r+1)||null,i=t.charCodeAt(r-1)||null;e+=n&&Jn(n)&&!Xs[t[r+1]]||i&&Jn(i)&&!Xs[t[r-1]]||!Xs[t[r]]?t[r]:Xs[t[r]];}return e}(this.text);},Au.prototype.trim=function(){for(var t=0,e=0;e<this.text.length&&ku[this.text.charCodeAt(e)];e++)t++;for(var r=this.text.length,n=this.text.length-1;n>=0&&n>=t&&ku[this.text.charCodeAt(n)];n--)r--;this.text=this.text.substring(t,r),this.sectionIndex=this.sectionIndex.slice(t,r);},Au.prototype.substring=function(t,e){var r=new Au;return r.text=this.text.substring(t,e),r.sectionIndex=this.sectionIndex.slice(t,e),r.sections=this.sections,r},Au.prototype.toString=function(){return this.text},Au.prototype.getMaxScale=function(){var t=this;return this.sectionIndex.reduce((function(e,r){return Math.max(e,t.sections[r].scale)}),0)},Au.prototype.addTextSection=function(t,e){this.text+=t.text,this.sections.push(_u.forText(t.scale,t.fontStack||e));for(var r=this.sections.length-1,n=0;n<t.text.length;++n)this.sectionIndex.push(r);},Au.prototype.addImageSection=function(t){var e=t.image?t.image.name:\"\";if(0!==e.length){var r=this.getNextImageSectionCharCode();r?(this.text+=String.fromCharCode(r),this.sections.push(_u.forImage(e)),this.sectionIndex.push(this.sections.length-1)):A(\"Reached maximum number of images 6401\");}else A(\"Can't add FormattedSection with an empty image.\");},Au.prototype.getNextImageSectionCharCode=function(){return this.imageSectionID?this.imageSectionID>=63743?null:++this.imageSectionID:(this.imageSectionID=57344,this.imageSectionID)};var ku={9:!0,10:!0,11:!0,12:!0,13:!0,32:!0},Iu={};function zu(t,e,r,n,i,a){if(e.imageName){var o=n[e.imageName];return o?o.displaySize[0]*e.scale*24/a+i:0}var s=r[e.fontStack],u=s&&s[t];return u?u.metrics.advance*e.scale+i:0}function Cu(t,e,r,n){var i=Math.pow(t-e,2);return n?t<e?i/2:2*i:i+Math.abs(r)*r}function Eu(t,e,r){var n=0;return 10===t&&(n-=1e4),r&&(n+=150),40!==t&&65288!==t||(n+=50),41!==e&&65289!==e||(n+=50),n}function Pu(t,e,r,n,i,a){for(var o=null,s=Cu(e,r,i,a),u=0,l=n;u<l.length;u+=1){var p=l[u],c=Cu(e-p.x,r,i,a)+p.badness;c<=s&&(o=p,s=c);}return {index:t,x:e,priorBreak:o,badness:s}}function Mu(t,e,r,n,i,a,o){if(\"point\"!==a)return [];if(!t)return [];for(var s,u=[],l=function(t,e,r,n,i,a){for(var o=0,s=0;s<t.length();s++){var u=t.getSection(s);o+=zu(t.getCharCode(s),u,n,i,e,a);}return o/Math.max(1,Math.ceil(o/r))}(t,e,r,n,i,o),p=t.text.indexOf(\"​\")>=0,c=0,h=0;h<t.length();h++){var f=t.getSection(h),y=t.getCharCode(h);if(ku[y]||(c+=zu(y,f,n,i,e,o)),h<t.length()-1){var d=!((s=y)<11904||!(Gn[\"Bopomofo Extended\"](s)||Gn.Bopomofo(s)||Gn[\"CJK Compatibility Forms\"](s)||Gn[\"CJK Compatibility Ideographs\"](s)||Gn[\"CJK Compatibility\"](s)||Gn[\"CJK Radicals Supplement\"](s)||Gn[\"CJK Strokes\"](s)||Gn[\"CJK Symbols and Punctuation\"](s)||Gn[\"CJK Unified Ideographs Extension A\"](s)||Gn[\"CJK Unified Ideographs\"](s)||Gn[\"Enclosed CJK Letters and Months\"](s)||Gn[\"Halfwidth and Fullwidth Forms\"](s)||Gn.Hiragana(s)||Gn[\"Ideographic Description Characters\"](s)||Gn[\"Kangxi Radicals\"](s)||Gn[\"Katakana Phonetic Extensions\"](s)||Gn.Katakana(s)||Gn[\"Vertical Forms\"](s)||Gn[\"Yi Radicals\"](s)||Gn[\"Yi Syllables\"](s)));(Iu[y]||d||f.imageName)&&u.push(Pu(h+1,c,l,u,Eu(y,t.getCharCode(h+1),d&&p),!1));}}return function t(e){return e?t(e.priorBreak).concat(e.index):[]}(Pu(t.length(),c,l,u,0,!0))}function Bu(t){var e=.5,r=.5;switch(t){case\"right\":case\"top-right\":case\"bottom-right\":e=1;break;case\"left\":case\"top-left\":case\"bottom-left\":e=0;}switch(t){case\"bottom\":case\"bottom-right\":case\"bottom-left\":r=1;break;case\"top\":case\"top-right\":case\"top-left\":r=0;}return {horizontalAlign:e,verticalAlign:r}}function Tu(t,e,r,n,i){if(n||i)for(var a=t[r],o=(t[r].x+a.metrics.advance*a.scale)*n,s=e;s<=r;s++)t[s].x-=o,t[s].y+=i;}function Vu(t,e,r,n,i,a){var o,s=t.image;if(s.content){var u=s.content,l=s.pixelRatio||1;o=[u[0]/l,u[1]/l,s.displaySize[0]-u[2]/l,s.displaySize[1]-u[3]/l];}var p,c,h,f,y=e.left*a,d=e.right*a;\"width\"===r||\"both\"===r?(f=i[0]+y-n[3],c=i[0]+d+n[1]):c=(f=i[0]+(y+d-s.displaySize[0])/2)+s.displaySize[0];var m=e.top*a,v=e.bottom*a;return \"height\"===r||\"both\"===r?(p=i[1]+m-n[0],h=i[1]+v+n[2]):h=(p=i[1]+(m+v-s.displaySize[1])/2)+s.displaySize[1],{image:s,top:p,right:c,bottom:h,left:f,collisionPadding:o}}Iu[10]=!0,Iu[32]=!0,Iu[38]=!0,Iu[40]=!0,Iu[41]=!0,Iu[43]=!0,Iu[45]=!0,Iu[47]=!0,Iu[173]=!0,Iu[183]=!0,Iu[8203]=!0,Iu[8208]=!0,Iu[8211]=!0,Iu[8231]=!0;var Fu=function(t){function e(e,r,n,i){t.call(this,e,r),this.angle=n,void 0!==i&&(this.segment=i);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.clone=function(){return new e(this.x,this.y,this.angle,this.segment)},e}(i);function Du(t,e){var r=e.expression;if(\"constant\"===r.kind)return {kind:\"constant\",layoutSize:r.evaluate(new si(t+1))};if(\"source\"===r.kind)return {kind:\"source\"};for(var n=r.zoomStops,i=r.interpolationType,a=0;a<n.length&&n[a]<=t;)a++;for(var o=a=Math.max(0,a-1);o<n.length&&n[o]<t+1;)o++;o=Math.min(n.length-1,o);var s=n[a],u=n[o];return \"composite\"===r.kind?{kind:\"composite\",minZoom:s,maxZoom:u,interpolationType:i}:{kind:\"camera\",minZoom:s,maxZoom:u,minSize:r.evaluate(new si(s)),maxSize:r.evaluate(new si(u)),interpolationType:i}}function Lu(t,e,r){var n=e.uSize,i=r.lowerSize;return \"source\"===t.kind?i/128:\"composite\"===t.kind?Ke(i/128,r.upperSize/128,e.uSizeT):n}function Ou(t,e){var r=0,n=0;if(\"constant\"===t.kind)n=t.layoutSize;else if(\"source\"!==t.kind){var i=t.interpolationType,a=i?p(ar.interpolationFactor(i,e,t.minZoom,t.maxZoom),0,1):0;\"camera\"===t.kind?n=Ke(t.minSize,t.maxSize,a):r=a;}return {uSizeT:r,uSize:n}}On(\"Anchor\",Fu);var Ru=Object.freeze({__proto__:null,getSizeData:Du,evaluateSizeForFeature:Lu,evaluateSizeForZoom:Ou,SIZE_PACK_FACTOR:128});function Uu(t,e,r,n,i){if(void 0===e.segment)return !0;for(var a=e,o=e.segment+1,s=0;s>-r/2;){if(--o<0)return !1;s-=t[o].dist(a),a=t[o];}s+=t[o].dist(t[o+1]),o++;for(var u=[],l=0;s<r/2;){var p=t[o],c=t[o+1];if(!c)return !1;var h=t[o-1].angleTo(p)-p.angleTo(c);for(h=Math.abs((h+3*Math.PI)%(2*Math.PI)-Math.PI),u.push({distance:s,angleDelta:h}),l+=h;s-u[0].distance>n;)l-=u.shift().angleDelta;if(l>i)return !1;o++,s+=p.dist(c);}return !0}function ju(t){for(var e=0,r=0;r<t.length-1;r++)e+=t[r].dist(t[r+1]);return e}function qu(t,e,r){return t?.6*e*r:0}function Nu(t,e){return Math.max(t?t.right-t.left:0,e?e.right-e.left:0)}function Ku(t,e,r,n,i,a){for(var o=qu(r,i,a),s=Nu(r,n)*a,u=0,l=ju(t)/2,p=0;p<t.length-1;p++){var c=t[p],h=t[p+1],f=c.dist(h);if(u+f>l){var y=(l-u)/f,d=Ke(c.x,h.x,y),m=Ke(c.y,h.y,y),v=new Fu(d,m,h.angleTo(c),p);return v._round(),!o||Uu(t,v,s,o,e)?v:void 0}u+=f;}}function Gu(t,e,r,n,i,a,o,s,u){var l=qu(n,a,o),p=Nu(n,i),c=p*o,h=0===t[0].x||t[0].x===u||0===t[0].y||t[0].y===u;return e-c<e/4&&(e=c+e/4),function t(e,r,n,i,a,o,s,u,l){for(var p=o/2,c=ju(e),h=0,f=r-n,y=[],d=0;d<e.length-1;d++){for(var m=e[d],v=e[d+1],g=m.dist(v),x=v.angleTo(m);f+n<h+g;){var b=((f+=n)-h)/g,w=Ke(m.x,v.x,b),_=Ke(m.y,v.y,b);if(w>=0&&w<l&&_>=0&&_<l&&f-p>=0&&f+p<=c){var A=new Fu(w,_,x,d);A._round(),i&&!Uu(e,A,o,i,a)||y.push(A);}}h+=g;}return u||y.length||s||(y=t(e,h/2,n,i,a,o,s,!0,l)),y}(t,h?e/2*s%e:(p/2+2*a)*o*s%e,e,l,r,c,h,!1,u)}function Zu(t,e,r,n,a){for(var o=[],s=0;s<t.length;s++)for(var u=t[s],l=void 0,p=0;p<u.length-1;p++){var c=u[p],h=u[p+1];c.x<e&&h.x<e||(c.x<e?c=new i(e,c.y+(e-c.x)/(h.x-c.x)*(h.y-c.y))._round():h.x<e&&(h=new i(e,c.y+(e-c.x)/(h.x-c.x)*(h.y-c.y))._round()),c.y<r&&h.y<r||(c.y<r?c=new i(c.x+(r-c.y)/(h.y-c.y)*(h.x-c.x),r)._round():h.y<r&&(h=new i(c.x+(r-c.y)/(h.y-c.y)*(h.x-c.x),r)._round()),c.x>=n&&h.x>=n||(c.x>=n?c=new i(n,c.y+(n-c.x)/(h.x-c.x)*(h.y-c.y))._round():h.x>=n&&(h=new i(n,c.y+(n-c.x)/(h.x-c.x)*(h.y-c.y))._round()),c.y>=a&&h.y>=a||(c.y>=a?c=new i(c.x+(a-c.y)/(h.y-c.y)*(h.x-c.x),a)._round():h.y>=a&&(h=new i(c.x+(a-c.y)/(h.y-c.y)*(h.x-c.x),a)._round()),l&&c.equals(l[l.length-1])||o.push(l=[c]),l.push(h)))));}return o}function Xu(t,e,r,n){var a=[],o=t.image,s=o.pixelRatio,u=o.paddedRect.w-2,l=o.paddedRect.h-2,p=t.right-t.left,c=t.bottom-t.top,h=o.stretchX||[[0,u]],f=o.stretchY||[[0,l]],y=function(t,e){return t+e[1]-e[0]},d=h.reduce(y,0),m=f.reduce(y,0),v=u-d,g=l-m,x=0,b=d,w=0,_=m,A=0,S=v,k=0,I=g;if(o.content&&n){var z=o.content;x=Ju(h,0,z[0]),w=Ju(f,0,z[1]),b=Ju(h,z[0],z[2]),_=Ju(f,z[1],z[3]),A=z[0]-x,k=z[1]-w,S=z[2]-z[0]-b,I=z[3]-z[1]-_;}var C=function(n,a,u,l){var h=Yu(n.stretch-x,b,p,t.left),f=$u(n.fixed-A,S,n.stretch,d),y=Yu(a.stretch-w,_,c,t.top),v=$u(a.fixed-k,I,a.stretch,m),g=Yu(u.stretch-x,b,p,t.left),z=$u(u.fixed-A,S,u.stretch,d),C=Yu(l.stretch-w,_,c,t.top),E=$u(l.fixed-k,I,l.stretch,m),P=new i(h,y),M=new i(g,y),B=new i(g,C),T=new i(h,C),V=new i(f/s,v/s),F=new i(z/s,E/s),D=e*Math.PI/180;if(D){var L=Math.sin(D),O=Math.cos(D),R=[O,-L,L,O];P._matMult(R),M._matMult(R),T._matMult(R),B._matMult(R);}var U=n.stretch+n.fixed,j=a.stretch+a.fixed;return {tl:P,tr:M,bl:T,br:B,tex:{x:o.paddedRect.x+1+U,y:o.paddedRect.y+1+j,w:u.stretch+u.fixed-U,h:l.stretch+l.fixed-j},writingMode:void 0,glyphOffset:[0,0],sectionIndex:0,pixelOffsetTL:V,pixelOffsetBR:F,minFontScaleX:S/s/p,minFontScaleY:I/s/c,isSDF:r}};if(n&&(o.stretchX||o.stretchY))for(var E=Hu(h,v,d),P=Hu(f,g,m),M=0;M<E.length-1;M++)for(var B=E[M],T=E[M+1],V=0;V<P.length-1;V++)a.push(C(B,P[V],T,P[V+1]));else a.push(C({fixed:0,stretch:-1},{fixed:0,stretch:-1},{fixed:0,stretch:u+1},{fixed:0,stretch:l+1}));return a}function Ju(t,e,r){for(var n=0,i=0,a=t;i<a.length;i+=1){var o=a[i];n+=Math.max(e,Math.min(r,o[1]))-Math.max(e,Math.min(r,o[0]));}return n}function Hu(t,e,r){for(var n=[{fixed:-1,stretch:0}],i=0,a=t;i<a.length;i+=1){var o=a[i],s=o[0],u=o[1],l=n[n.length-1];n.push({fixed:s-l.stretch,stretch:l.stretch}),n.push({fixed:s-l.stretch,stretch:l.stretch+(u-s)});}return n.push({fixed:e+1,stretch:r}),n}function Yu(t,e,r,n){return t/e*r+n}function $u(t,e,r,n){return t-e*r/n}var Wu=function(t,e,r,n,a,o,s,u,l,p){if(this.boxStartIndex=t.length,l){var c=o.top,h=o.bottom,f=o.collisionPadding;f&&(c-=f[1],h+=f[3]);var y=h-c;y>0&&(y=Math.max(10,y),this.circleDiameter=y);}else {var d=o.top*s-u,m=o.bottom*s+u,v=o.left*s-u,g=o.right*s+u,x=o.collisionPadding;if(x&&(v-=x[0]*s,d-=x[1]*s,g+=x[2]*s,m+=x[3]*s),p){var b=new i(v,d),w=new i(g,d),_=new i(v,m),A=new i(g,m),S=p*Math.PI/180;b._rotate(S),w._rotate(S),_._rotate(S),A._rotate(S),v=Math.min(b.x,w.x,_.x,A.x),g=Math.max(b.x,w.x,_.x,A.x),d=Math.min(b.y,w.y,_.y,A.y),m=Math.max(b.y,w.y,_.y,A.y);}t.emplaceBack(e.x,e.y,v,d,g,m,r,n,a);}this.boxEndIndex=t.length;},Qu=function(t,e){if(void 0===t&&(t=[]),void 0===e&&(e=tl),this.data=t,this.length=this.data.length,this.compare=e,this.length>0)for(var r=(this.length>>1)-1;r>=0;r--)this._down(r);};function tl(t,e){return t<e?-1:t>e?1:0}function el(t,e,r){void 0===e&&(e=1),void 0===r&&(r=!1);for(var n=1/0,a=1/0,o=-1/0,s=-1/0,u=t[0],l=0;l<u.length;l++){var p=u[l];(!l||p.x<n)&&(n=p.x),(!l||p.y<a)&&(a=p.y),(!l||p.x>o)&&(o=p.x),(!l||p.y>s)&&(s=p.y);}var c=Math.min(o-n,s-a),h=c/2,f=new Qu([],rl);if(0===c)return new i(n,a);for(var y=n;y<o;y+=c)for(var d=a;d<s;d+=c)f.push(new nl(y+h,d+h,h,t));for(var m=function(t){for(var e=0,r=0,n=0,i=t[0],a=0,o=i.length,s=o-1;a<o;s=a++){var u=i[a],l=i[s],p=u.x*l.y-l.x*u.y;r+=(u.x+l.x)*p,n+=(u.y+l.y)*p,e+=3*p;}return new nl(r/e,n/e,0,t)}(t),v=f.length;f.length;){var g=f.pop();(g.d>m.d||!m.d)&&(m=g,r&&console.log(\"found best %d after %d probes\",Math.round(1e4*g.d)/1e4,v)),g.max-m.d<=e||(f.push(new nl(g.p.x-(h=g.h/2),g.p.y-h,h,t)),f.push(new nl(g.p.x+h,g.p.y-h,h,t)),f.push(new nl(g.p.x-h,g.p.y+h,h,t)),f.push(new nl(g.p.x+h,g.p.y+h,h,t)),v+=4);}return r&&(console.log(\"num probes: \"+v),console.log(\"best distance: \"+m.d)),m.p}function rl(t,e){return e.max-t.max}function nl(t,e,r,n){this.p=new i(t,e),this.h=r,this.d=function(t,e){for(var r=!1,n=1/0,i=0;i<e.length;i++)for(var a=e[i],o=0,s=a.length,u=s-1;o<s;u=o++){var l=a[o],p=a[u];l.y>t.y!=p.y>t.y&&t.x<(p.x-l.x)*(t.y-l.y)/(p.y-l.y)+l.x&&(r=!r),n=Math.min(n,Ya(t,l,p));}return (r?1:-1)*Math.sqrt(n)}(this.p,n),this.max=this.d+this.h*Math.SQRT2;}Qu.prototype.push=function(t){this.data.push(t),this.length++,this._up(this.length-1);},Qu.prototype.pop=function(){if(0!==this.length){var t=this.data[0],e=this.data.pop();return this.length--,this.length>0&&(this.data[0]=e,this._down(0)),t}},Qu.prototype.peek=function(){return this.data[0]},Qu.prototype._up=function(t){for(var e=this.data,r=this.compare,n=e[t];t>0;){var i=t-1>>1,a=e[i];if(r(n,a)>=0)break;e[t]=a,t=i;}e[t]=n;},Qu.prototype._down=function(t){for(var e=this.data,r=this.compare,n=this.length>>1,i=e[t];t<n;){var a=1+(t<<1),o=e[a],s=a+1;if(s<this.length&&r(e[s],o)<0&&(a=s,o=e[s]),r(o,i)>=0)break;e[t]=o,t=a;}e[t]=i;};var il=Number.POSITIVE_INFINITY;function al(t,e){return e[1]!==il?function(t,e,r){var n=0,i=0;switch(e=Math.abs(e),r=Math.abs(r),t){case\"top-right\":case\"top-left\":case\"top\":i=r-7;break;case\"bottom-right\":case\"bottom-left\":case\"bottom\":i=7-r;}switch(t){case\"top-right\":case\"bottom-right\":case\"right\":n=-e;break;case\"top-left\":case\"bottom-left\":case\"left\":n=e;}return [n,i]}(t,e[0],e[1]):function(t,e){var r=0,n=0;e<0&&(e=0);var i=e/Math.sqrt(2);switch(t){case\"top-right\":case\"top-left\":n=i-7;break;case\"bottom-right\":case\"bottom-left\":n=7-i;break;case\"bottom\":n=7-e;break;case\"top\":n=e-7;}switch(t){case\"top-right\":case\"bottom-right\":r=-i;break;case\"top-left\":case\"bottom-left\":r=i;break;case\"left\":r=e;break;case\"right\":r=-e;}return [r,n]}(t,e[0])}function ol(t){switch(t){case\"right\":case\"top-right\":case\"bottom-right\":return \"right\";case\"left\":case\"top-left\":case\"bottom-left\":return \"left\"}return \"center\"}function sl(t,e,r,n,a,o,s,u,l,p,c,h,f,y,d){var m=function(t,e,r,n,a,o,s,u){for(var l=n.layout.get(\"text-rotate\").evaluate(o,{})*Math.PI/180,p=[],c=0,h=e.positionedLines;c<h.length;c+=1)for(var f=h[c],y=0,d=f.positionedGlyphs;y<d.length;y+=1){var m=d[y];if(m.rect){var v=m.rect||{},g=4,x=!0,b=1,w=0,_=(a||u)&&m.vertical,A=m.metrics.advance*m.scale/2;if(u&&e.verticalizable&&(w=f.lineOffset/2-(m.imageName?-(24-m.metrics.width*m.scale)/2:24*(m.scale-1))),m.imageName){var S=s[m.imageName];x=S.sdf,g=1/(b=S.pixelRatio);}var k=a?[m.x+A,m.y]:[0,0],I=a?[0,0]:[m.x+A+r[0],m.y+r[1]-w],z=[0,0];_&&(z=I,I=[0,0]);var C=(m.metrics.left-g)*m.scale-A+I[0],E=(-m.metrics.top-g)*m.scale+I[1],P=C+v.w*m.scale/b,M=E+v.h*m.scale/b,B=new i(C,E),T=new i(P,E),V=new i(C,M),F=new i(P,M);if(_){var D=new i(-A,A- -17),L=-Math.PI/2,O=12-A,R=new i(22-O,-(m.imageName?O:0)),U=new(Function.prototype.bind.apply(i,[null].concat(z)));B._rotateAround(L,D)._add(R)._add(U),T._rotateAround(L,D)._add(R)._add(U),V._rotateAround(L,D)._add(R)._add(U),F._rotateAround(L,D)._add(R)._add(U);}if(l){var j=Math.sin(l),q=Math.cos(l),N=[q,-j,j,q];B._matMult(N),T._matMult(N),V._matMult(N),F._matMult(N);}var K=new i(0,0),G=new i(0,0);p.push({tl:B,tr:T,bl:V,br:F,tex:v,writingMode:e.writingMode,glyphOffset:k,sectionIndex:m.sectionIndex,isSDF:x,pixelOffsetTL:K,pixelOffsetBR:G,minFontScaleX:0,minFontScaleY:0});}}return p}(0,r,u,a,o,s,n,t.allowVerticalPlacement),v=t.textSizeData,g=null;\"source\"===v.kind?(g=[128*a.layout.get(\"text-size\").evaluate(s,{})])[0]>32640&&A(t.layerIds[0]+': Value for \"text-size\" is >= 255. Reduce your \"text-size\".'):\"composite\"===v.kind&&((g=[128*y.compositeTextSizes[0].evaluate(s,{},d),128*y.compositeTextSizes[1].evaluate(s,{},d)])[0]>32640||g[1]>32640)&&A(t.layerIds[0]+': Value for \"text-size\" is >= 255. Reduce your \"text-size\".'),t.addSymbols(t.text,m,g,u,o,s,p,e,l.lineStartIndex,l.lineLength,f,d);for(var x=0,b=c;x<b.length;x+=1)h[b[x]]=t.text.placedSymbolArray.length-1;return 4*m.length}function ul(t){for(var e in t)return t[e];return null}function ll(t,e,r,n){var i=t.compareText;if(e in i){for(var a=i[e],o=a.length-1;o>=0;o--)if(n.dist(a[o])<r)return !0}else i[e]=[];return i[e].push(n),!1}var pl=bs.VectorTileFeature.types,cl=[{name:\"a_fade_opacity\",components:1,type:\"Uint8\",offset:0}];function hl(t,e,r,n,i,a,o,s,u,l,p,c,h){var f=s?Math.min(32640,Math.round(s[0])):0,y=s?Math.min(32640,Math.round(s[1])):0;t.emplaceBack(e,r,Math.round(32*n),Math.round(32*i),a,o,(f<<1)+(u?1:0),y,16*l,16*p,256*c,256*h);}function fl(t,e,r){t.emplaceBack(e.x,e.y,r),t.emplaceBack(e.x,e.y,r),t.emplaceBack(e.x,e.y,r),t.emplaceBack(e.x,e.y,r);}function yl(t){for(var e=0,r=t.sections;e<r.length;e+=1)if($n(r[e].text))return !0;return !1}var dl=function(t){this.layoutVertexArray=new Vi,this.indexArray=new ji,this.programConfigurations=t,this.segments=new sa,this.dynamicLayoutVertexArray=new Fi,this.opacityVertexArray=new Di,this.placedSymbolArray=new Qi;};dl.prototype.isEmpty=function(){return 0===this.layoutVertexArray.length&&0===this.indexArray.length&&0===this.dynamicLayoutVertexArray.length&&0===this.opacityVertexArray.length},dl.prototype.upload=function(t,e,r,n){this.isEmpty()||(r&&(this.layoutVertexBuffer=t.createVertexBuffer(this.layoutVertexArray,js.members),this.indexBuffer=t.createIndexBuffer(this.indexArray,e),this.dynamicLayoutVertexBuffer=t.createVertexBuffer(this.dynamicLayoutVertexArray,qs.members,!0),this.opacityVertexBuffer=t.createVertexBuffer(this.opacityVertexArray,cl,!0),this.opacityVertexBuffer.itemSize=1),(r||n)&&this.programConfigurations.upload(t));},dl.prototype.destroy=function(){this.layoutVertexBuffer&&(this.layoutVertexBuffer.destroy(),this.indexBuffer.destroy(),this.programConfigurations.destroy(),this.segments.destroy(),this.dynamicLayoutVertexBuffer.destroy(),this.opacityVertexBuffer.destroy());},On(\"SymbolBuffers\",dl);var ml=function(t,e,r){this.layoutVertexArray=new t,this.layoutAttributes=e,this.indexArray=new r,this.segments=new sa,this.collisionVertexArray=new Ui;};ml.prototype.upload=function(t){this.layoutVertexBuffer=t.createVertexBuffer(this.layoutVertexArray,this.layoutAttributes),this.indexBuffer=t.createIndexBuffer(this.indexArray),this.collisionVertexBuffer=t.createVertexBuffer(this.collisionVertexArray,Ns.members,!0);},ml.prototype.destroy=function(){this.layoutVertexBuffer&&(this.layoutVertexBuffer.destroy(),this.indexBuffer.destroy(),this.segments.destroy(),this.collisionVertexBuffer.destroy());},On(\"CollisionBuffers\",ml);var vl=function(t){this.collisionBoxArray=t.collisionBoxArray,this.zoom=t.zoom,this.overscaling=t.overscaling,this.layers=t.layers,this.layerIds=this.layers.map((function(t){return t.id})),this.index=t.index,this.pixelRatio=t.pixelRatio,this.sourceLayerIndex=t.sourceLayerIndex,this.hasPattern=!1,this.hasRTLText=!1,this.sortKeyRanges=[],this.collisionCircleArray=[],this.placementInvProjMatrix=oo([]),this.placementViewportMatrix=oo([]);var e=this.layers[0]._unevaluatedLayout._values;this.textSizeData=Du(this.zoom,e[\"text-size\"]),this.iconSizeData=Du(this.zoom,e[\"icon-size\"]);var r=this.layers[0].layout,n=r.get(\"symbol-sort-key\"),i=r.get(\"symbol-z-order\");this.canOverlap=r.get(\"text-allow-overlap\")||r.get(\"icon-allow-overlap\")||r.get(\"text-ignore-placement\")||r.get(\"icon-ignore-placement\"),this.sortFeaturesByKey=\"viewport-y\"!==i&&void 0!==n.constantOr(1),this.sortFeaturesByY=(\"viewport-y\"===i||\"auto\"===i&&!this.sortFeaturesByKey)&&this.canOverlap,\"point\"===r.get(\"symbol-placement\")&&(this.writingModes=r.get(\"text-writing-mode\").map((function(t){return wu[t]}))),this.stateDependentLayerIds=this.layers.filter((function(t){return t.isStateDependent()})).map((function(t){return t.id})),this.sourceID=t.sourceID;};vl.prototype.createArrays=function(){this.text=new dl(new Va(this.layers,this.zoom,(function(t){return /^text/.test(t)}))),this.icon=new dl(new Va(this.layers,this.zoom,(function(t){return /^icon/.test(t)}))),this.glyphOffsetArray=new ra,this.lineVertexArray=new na,this.symbolInstances=new ea;},vl.prototype.calculateGlyphDependencies=function(t,e,r,n,i){for(var a=0;a<t.length;a++)if(e[t.charCodeAt(a)]=!0,(r||n)&&i){var o=Xs[t.charAt(a)];o&&(e[o.charCodeAt(0)]=!0);}},vl.prototype.populate=function(t,e,r){var n=this.layers[0],i=n.layout,a=i.get(\"text-font\"),o=i.get(\"text-field\"),s=i.get(\"icon-image\"),u=(\"constant\"!==o.value.kind||o.value.value instanceof ne&&!o.value.value.isEmpty()||o.value.value.toString().length>0)&&(\"constant\"!==a.value.kind||a.value.value.length>0),l=\"constant\"!==s.value.kind||!!s.value.value||Object.keys(s.parameters).length>0,p=i.get(\"symbol-sort-key\");if(this.features=[],u||l){for(var c=e.iconDependencies,h=e.glyphDependencies,f=e.availableImages,y=new si(this.zoom),d=0,m=t;d<m.length;d+=1){var v=m[d],g=v.feature,x=v.id,b=v.index,w=v.sourceLayerIndex,_=n._featureFilter.needGeometry,A=Ua(g,_);if(n._featureFilter.filter(y,A,r)){_||(A.geometry=Ra(g));var S=void 0;if(u){var k=n.getValueAndResolveTokens(\"text-field\",A,r,f),I=ne.factory(k);yl(I)&&(this.hasRTLText=!0),(!this.hasRTLText||\"unavailable\"===ii()||this.hasRTLText&&oi.isParsed())&&(S=Zs(I,n,A));}var z=void 0;if(l){var C=n.getValueAndResolveTokens(\"icon-image\",A,r,f);z=C instanceof ie?C:ie.fromString(C);}if(S||z){var E=this.sortFeaturesByKey?p.evaluate(A,{},r):void 0;if(this.features.push({id:x,text:S,icon:z,index:b,sourceLayerIndex:w,geometry:A.geometry,properties:g.properties,type:pl[g.type],sortKey:E}),z&&(c[z.name]=!0),S){var P=a.evaluate(A,{},r).join(\",\"),M=\"map\"===i.get(\"text-rotation-alignment\")&&\"point\"!==i.get(\"symbol-placement\");this.allowVerticalPlacement=this.writingModes&&this.writingModes.indexOf(wu.vertical)>=0;for(var B=0,T=S.sections;B<T.length;B+=1){var V=T[B];if(V.image)c[V.image.name]=!0;else {var F=Zn(S.toString()),D=V.fontStack||P,L=h[D]=h[D]||{};this.calculateGlyphDependencies(V.text,L,M,this.allowVerticalPlacement,F);}}}}}}\"line\"===i.get(\"symbol-placement\")&&(this.features=function(t){var e={},r={},n=[],i=0;function a(e){n.push(t[e]),i++;}function o(t,e,i){var a=r[t];return delete r[t],r[e]=a,n[a].geometry[0].pop(),n[a].geometry[0]=n[a].geometry[0].concat(i[0]),a}function s(t,r,i){var a=e[r];return delete e[r],e[t]=a,n[a].geometry[0].shift(),n[a].geometry[0]=i[0].concat(n[a].geometry[0]),a}function u(t,e,r){var n=r?e[0][e[0].length-1]:e[0][0];return t+\":\"+n.x+\":\"+n.y}for(var l=0;l<t.length;l++){var p=t[l],c=p.geometry,h=p.text?p.text.toString():null;if(h){var f=u(h,c),y=u(h,c,!0);if(f in r&&y in e&&r[f]!==e[y]){var d=s(f,y,c),m=o(f,y,n[d].geometry);delete e[f],delete r[y],r[u(h,n[m].geometry,!0)]=m,n[d].geometry=null;}else f in r?o(f,y,c):y in e?s(f,y,c):(a(l),e[f]=i-1,r[y]=i-1);}else a(l);}return n.filter((function(t){return t.geometry}))}(this.features)),this.sortFeaturesByKey&&this.features.sort((function(t,e){return t.sortKey-e.sortKey}));}},vl.prototype.update=function(t,e,r){this.stateDependentLayers.length&&(this.text.programConfigurations.updatePaintArrays(t,e,this.layers,r),this.icon.programConfigurations.updatePaintArrays(t,e,this.layers,r));},vl.prototype.isEmpty=function(){return 0===this.symbolInstances.length&&!this.hasRTLText},vl.prototype.uploadPending=function(){return !this.uploaded||this.text.programConfigurations.needsUpload||this.icon.programConfigurations.needsUpload},vl.prototype.upload=function(t){!this.uploaded&&this.hasDebugData()&&(this.textCollisionBox.upload(t),this.iconCollisionBox.upload(t)),this.text.upload(t,this.sortFeaturesByY,!this.uploaded,this.text.programConfigurations.needsUpload),this.icon.upload(t,this.sortFeaturesByY,!this.uploaded,this.icon.programConfigurations.needsUpload),this.uploaded=!0;},vl.prototype.destroyDebugData=function(){this.textCollisionBox.destroy(),this.iconCollisionBox.destroy();},vl.prototype.destroy=function(){this.text.destroy(),this.icon.destroy(),this.hasDebugData()&&this.destroyDebugData();},vl.prototype.addToLineVertexArray=function(t,e){var r=this.lineVertexArray.length;if(void 0!==t.segment){for(var n=t.dist(e[t.segment+1]),i=t.dist(e[t.segment]),a={},o=t.segment+1;o<e.length;o++)a[o]={x:e[o].x,y:e[o].y,tileUnitDistanceFromAnchor:n},o<e.length-1&&(n+=e[o+1].dist(e[o]));for(var s=t.segment||0;s>=0;s--)a[s]={x:e[s].x,y:e[s].y,tileUnitDistanceFromAnchor:i},s>0&&(i+=e[s-1].dist(e[s]));for(var u=0;u<e.length;u++){var l=a[u];this.lineVertexArray.emplaceBack(l.x,l.y,l.tileUnitDistanceFromAnchor);}}return {lineStartIndex:r,lineLength:this.lineVertexArray.length-r}},vl.prototype.addSymbols=function(t,e,r,n,i,a,o,s,u,l,p,c){for(var h=t.indexArray,f=t.layoutVertexArray,y=t.segments.prepareSegment(4*e.length,f,h,this.canOverlap?a.sortKey:void 0),d=this.glyphOffsetArray.length,m=y.vertexLength,v=this.allowVerticalPlacement&&o===wu.vertical?Math.PI/2:0,g=a.text&&a.text.sections,x=0;x<e.length;x++){var b=e[x],w=b.tl,_=b.tr,A=b.bl,S=b.br,k=b.tex,I=b.pixelOffsetTL,z=b.pixelOffsetBR,C=b.minFontScaleX,E=b.minFontScaleY,P=b.glyphOffset,M=b.isSDF,B=b.sectionIndex,T=y.vertexLength,V=P[1];hl(f,s.x,s.y,w.x,V+w.y,k.x,k.y,r,M,I.x,I.y,C,E),hl(f,s.x,s.y,_.x,V+_.y,k.x+k.w,k.y,r,M,z.x,I.y,C,E),hl(f,s.x,s.y,A.x,V+A.y,k.x,k.y+k.h,r,M,I.x,z.y,C,E),hl(f,s.x,s.y,S.x,V+S.y,k.x+k.w,k.y+k.h,r,M,z.x,z.y,C,E),fl(t.dynamicLayoutVertexArray,s,v),h.emplaceBack(T,T+1,T+2),h.emplaceBack(T+1,T+2,T+3),y.vertexLength+=4,y.primitiveLength+=2,this.glyphOffsetArray.emplaceBack(P[0]),x!==e.length-1&&B===e[x+1].sectionIndex||t.programConfigurations.populatePaintArrays(f.length,a,a.index,{},c,g&&g[B]);}t.placedSymbolArray.emplaceBack(s.x,s.y,d,this.glyphOffsetArray.length-d,m,u,l,s.segment,r?r[0]:0,r?r[1]:0,n[0],n[1],o,0,!1,0,p);},vl.prototype._addCollisionDebugVertex=function(t,e,r,n,i,a){return e.emplaceBack(0,0),t.emplaceBack(r.x,r.y,n,i,Math.round(a.x),Math.round(a.y))},vl.prototype.addCollisionDebugVertices=function(t,e,r,n,a,o,s){var u=a.segments.prepareSegment(4,a.layoutVertexArray,a.indexArray),l=u.vertexLength,p=a.layoutVertexArray,c=a.collisionVertexArray,h=s.anchorX,f=s.anchorY;this._addCollisionDebugVertex(p,c,o,h,f,new i(t,e)),this._addCollisionDebugVertex(p,c,o,h,f,new i(r,e)),this._addCollisionDebugVertex(p,c,o,h,f,new i(r,n)),this._addCollisionDebugVertex(p,c,o,h,f,new i(t,n)),u.vertexLength+=4;var y=a.indexArray;y.emplaceBack(l,l+1),y.emplaceBack(l+1,l+2),y.emplaceBack(l+2,l+3),y.emplaceBack(l+3,l),u.primitiveLength+=4;},vl.prototype.addDebugCollisionBoxes=function(t,e,r,n){for(var i=t;i<e;i++){var a=this.collisionBoxArray.get(i);this.addCollisionDebugVertices(a.x1,a.y1,a.x2,a.y2,n?this.textCollisionBox:this.iconCollisionBox,a.anchorPoint,r);}},vl.prototype.generateCollisionDebugBuffers=function(){this.hasDebugData()&&this.destroyDebugData(),this.textCollisionBox=new ml(Oi,Ks.members,Xi),this.iconCollisionBox=new ml(Oi,Ks.members,Xi);for(var t=0;t<this.symbolInstances.length;t++){var e=this.symbolInstances.get(t);this.addDebugCollisionBoxes(e.textBoxStartIndex,e.textBoxEndIndex,e,!0),this.addDebugCollisionBoxes(e.verticalTextBoxStartIndex,e.verticalTextBoxEndIndex,e,!0),this.addDebugCollisionBoxes(e.iconBoxStartIndex,e.iconBoxEndIndex,e,!1),this.addDebugCollisionBoxes(e.verticalIconBoxStartIndex,e.verticalIconBoxEndIndex,e,!1);}},vl.prototype._deserializeCollisionBoxesForSymbol=function(t,e,r,n,i,a,o,s,u){for(var l={},p=e;p<r;p++){var c=t.get(p);l.textBox={x1:c.x1,y1:c.y1,x2:c.x2,y2:c.y2,anchorPointX:c.anchorPointX,anchorPointY:c.anchorPointY},l.textFeatureIndex=c.featureIndex;break}for(var h=n;h<i;h++){var f=t.get(h);l.verticalTextBox={x1:f.x1,y1:f.y1,x2:f.x2,y2:f.y2,anchorPointX:f.anchorPointX,anchorPointY:f.anchorPointY},l.verticalTextFeatureIndex=f.featureIndex;break}for(var y=a;y<o;y++){var d=t.get(y);l.iconBox={x1:d.x1,y1:d.y1,x2:d.x2,y2:d.y2,anchorPointX:d.anchorPointX,anchorPointY:d.anchorPointY},l.iconFeatureIndex=d.featureIndex;break}for(var m=s;m<u;m++){var v=t.get(m);l.verticalIconBox={x1:v.x1,y1:v.y1,x2:v.x2,y2:v.y2,anchorPointX:v.anchorPointX,anchorPointY:v.anchorPointY},l.verticalIconFeatureIndex=v.featureIndex;break}return l},vl.prototype.deserializeCollisionBoxes=function(t){this.collisionArrays=[];for(var e=0;e<this.symbolInstances.length;e++){var r=this.symbolInstances.get(e);this.collisionArrays.push(this._deserializeCollisionBoxesForSymbol(t,r.textBoxStartIndex,r.textBoxEndIndex,r.verticalTextBoxStartIndex,r.verticalTextBoxEndIndex,r.iconBoxStartIndex,r.iconBoxEndIndex,r.verticalIconBoxStartIndex,r.verticalIconBoxEndIndex));}},vl.prototype.hasTextData=function(){return this.text.segments.get().length>0},vl.prototype.hasIconData=function(){return this.icon.segments.get().length>0},vl.prototype.hasDebugData=function(){return this.textCollisionBox&&this.iconCollisionBox},vl.prototype.hasTextCollisionBoxData=function(){return this.hasDebugData()&&this.textCollisionBox.segments.get().length>0},vl.prototype.hasIconCollisionBoxData=function(){return this.hasDebugData()&&this.iconCollisionBox.segments.get().length>0},vl.prototype.addIndicesForPlacedSymbol=function(t,e){for(var r=t.placedSymbolArray.get(e),n=r.vertexStartIndex+4*r.numGlyphs,i=r.vertexStartIndex;i<n;i+=4)t.indexArray.emplaceBack(i,i+1,i+2),t.indexArray.emplaceBack(i+1,i+2,i+3);},vl.prototype.getSortedSymbolIndexes=function(t){if(this.sortedAngle===t&&void 0!==this.symbolInstanceIndexes)return this.symbolInstanceIndexes;for(var e=Math.sin(t),r=Math.cos(t),n=[],i=[],a=[],o=0;o<this.symbolInstances.length;++o){a.push(o);var s=this.symbolInstances.get(o);n.push(0|Math.round(e*s.anchorX+r*s.anchorY)),i.push(s.featureIndex);}return a.sort((function(t,e){return n[t]-n[e]||i[e]-i[t]})),a},vl.prototype.addToSortKeyRanges=function(t,e){var r=this.sortKeyRanges[this.sortKeyRanges.length-1];r&&r.sortKey===e?r.symbolInstanceEnd=t+1:this.sortKeyRanges.push({sortKey:e,symbolInstanceStart:t,symbolInstanceEnd:t+1});},vl.prototype.sortFeatures=function(t){var e=this;if(this.sortFeaturesByY&&this.sortedAngle!==t&&!(this.text.segments.get().length>1||this.icon.segments.get().length>1)){this.symbolInstanceIndexes=this.getSortedSymbolIndexes(t),this.sortedAngle=t,this.text.indexArray.clear(),this.icon.indexArray.clear(),this.featureSortOrder=[];for(var r=0,n=this.symbolInstanceIndexes;r<n.length;r+=1){var i=this.symbolInstances.get(n[r]);this.featureSortOrder.push(i.featureIndex),[i.rightJustifiedTextSymbolIndex,i.centerJustifiedTextSymbolIndex,i.leftJustifiedTextSymbolIndex].forEach((function(t,r,n){t>=0&&n.indexOf(t)===r&&e.addIndicesForPlacedSymbol(e.text,t);})),i.verticalPlacedTextSymbolIndex>=0&&this.addIndicesForPlacedSymbol(this.text,i.verticalPlacedTextSymbolIndex),i.placedIconSymbolIndex>=0&&this.addIndicesForPlacedSymbol(this.icon,i.placedIconSymbolIndex),i.verticalPlacedIconSymbolIndex>=0&&this.addIndicesForPlacedSymbol(this.icon,i.verticalPlacedIconSymbolIndex);}this.text.indexBuffer&&this.text.indexBuffer.updateData(this.text.indexArray),this.icon.indexBuffer&&this.icon.indexBuffer.updateData(this.icon.indexArray);}},On(\"SymbolBucket\",vl,{omit:[\"layers\",\"collisionBoxArray\",\"features\",\"compareText\"]}),vl.MAX_GLYPHS=65535,vl.addDynamicAttributes=fl;var gl=new wi({\"symbol-placement\":new mi(Et.layout_symbol[\"symbol-placement\"]),\"symbol-spacing\":new mi(Et.layout_symbol[\"symbol-spacing\"]),\"symbol-avoid-edges\":new mi(Et.layout_symbol[\"symbol-avoid-edges\"]),\"symbol-sort-key\":new vi(Et.layout_symbol[\"symbol-sort-key\"]),\"symbol-z-order\":new mi(Et.layout_symbol[\"symbol-z-order\"]),\"icon-allow-overlap\":new mi(Et.layout_symbol[\"icon-allow-overlap\"]),\"icon-ignore-placement\":new mi(Et.layout_symbol[\"icon-ignore-placement\"]),\"icon-optional\":new mi(Et.layout_symbol[\"icon-optional\"]),\"icon-rotation-alignment\":new mi(Et.layout_symbol[\"icon-rotation-alignment\"]),\"icon-size\":new vi(Et.layout_symbol[\"icon-size\"]),\"icon-text-fit\":new mi(Et.layout_symbol[\"icon-text-fit\"]),\"icon-text-fit-padding\":new mi(Et.layout_symbol[\"icon-text-fit-padding\"]),\"icon-image\":new vi(Et.layout_symbol[\"icon-image\"]),\"icon-rotate\":new vi(Et.layout_symbol[\"icon-rotate\"]),\"icon-padding\":new mi(Et.layout_symbol[\"icon-padding\"]),\"icon-keep-upright\":new mi(Et.layout_symbol[\"icon-keep-upright\"]),\"icon-offset\":new vi(Et.layout_symbol[\"icon-offset\"]),\"icon-anchor\":new vi(Et.layout_symbol[\"icon-anchor\"]),\"icon-pitch-alignment\":new mi(Et.layout_symbol[\"icon-pitch-alignment\"]),\"text-pitch-alignment\":new mi(Et.layout_symbol[\"text-pitch-alignment\"]),\"text-rotation-alignment\":new mi(Et.layout_symbol[\"text-rotation-alignment\"]),\"text-field\":new vi(Et.layout_symbol[\"text-field\"]),\"text-font\":new vi(Et.layout_symbol[\"text-font\"]),\"text-size\":new vi(Et.layout_symbol[\"text-size\"]),\"text-max-width\":new vi(Et.layout_symbol[\"text-max-width\"]),\"text-line-height\":new mi(Et.layout_symbol[\"text-line-height\"]),\"text-letter-spacing\":new vi(Et.layout_symbol[\"text-letter-spacing\"]),\"text-justify\":new vi(Et.layout_symbol[\"text-justify\"]),\"text-radial-offset\":new vi(Et.layout_symbol[\"text-radial-offset\"]),\"text-variable-anchor\":new mi(Et.layout_symbol[\"text-variable-anchor\"]),\"text-anchor\":new vi(Et.layout_symbol[\"text-anchor\"]),\"text-max-angle\":new mi(Et.layout_symbol[\"text-max-angle\"]),\"text-writing-mode\":new mi(Et.layout_symbol[\"text-writing-mode\"]),\"text-rotate\":new vi(Et.layout_symbol[\"text-rotate\"]),\"text-padding\":new mi(Et.layout_symbol[\"text-padding\"]),\"text-keep-upright\":new mi(Et.layout_symbol[\"text-keep-upright\"]),\"text-transform\":new vi(Et.layout_symbol[\"text-transform\"]),\"text-offset\":new vi(Et.layout_symbol[\"text-offset\"]),\"text-allow-overlap\":new mi(Et.layout_symbol[\"text-allow-overlap\"]),\"text-ignore-placement\":new mi(Et.layout_symbol[\"text-ignore-placement\"]),\"text-optional\":new mi(Et.layout_symbol[\"text-optional\"])}),xl={paint:new wi({\"icon-opacity\":new vi(Et.paint_symbol[\"icon-opacity\"]),\"icon-color\":new vi(Et.paint_symbol[\"icon-color\"]),\"icon-halo-color\":new vi(Et.paint_symbol[\"icon-halo-color\"]),\"icon-halo-width\":new vi(Et.paint_symbol[\"icon-halo-width\"]),\"icon-halo-blur\":new vi(Et.paint_symbol[\"icon-halo-blur\"]),\"icon-translate\":new mi(Et.paint_symbol[\"icon-translate\"]),\"icon-translate-anchor\":new mi(Et.paint_symbol[\"icon-translate-anchor\"]),\"text-opacity\":new vi(Et.paint_symbol[\"text-opacity\"]),\"text-color\":new vi(Et.paint_symbol[\"text-color\"],{runtimeType:jt,getOverride:function(t){return t.textColor},hasOverride:function(t){return !!t.textColor}}),\"text-halo-color\":new vi(Et.paint_symbol[\"text-halo-color\"]),\"text-halo-width\":new vi(Et.paint_symbol[\"text-halo-width\"]),\"text-halo-blur\":new vi(Et.paint_symbol[\"text-halo-blur\"]),\"text-translate\":new mi(Et.paint_symbol[\"text-translate\"]),\"text-translate-anchor\":new mi(Et.paint_symbol[\"text-translate-anchor\"])}),layout:gl},bl=function(t){this.type=t.property.overrides?t.property.overrides.runtimeType:Lt,this.defaultValue=t;};bl.prototype.evaluate=function(t){if(t.formattedSection){var e=this.defaultValue.property.overrides;if(e&&e.hasOverride(t.formattedSection))return e.getOverride(t.formattedSection)}return t.feature&&t.featureState?this.defaultValue.evaluate(t.feature,t.featureState):this.defaultValue.property.specification.default},bl.prototype.eachChild=function(t){this.defaultValue.isConstant()||t(this.defaultValue.value._styleExpression.expression);},bl.prototype.outputDefined=function(){return !1},bl.prototype.serialize=function(){return null},On(\"FormatSectionOverride\",bl,{omit:[\"defaultValue\"]});var wl=function(t){function e(e){t.call(this,e,xl);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.recalculate=function(e,r){if(t.prototype.recalculate.call(this,e,r),\"auto\"===this.layout.get(\"icon-rotation-alignment\")&&(this.layout._values[\"icon-rotation-alignment\"]=\"point\"!==this.layout.get(\"symbol-placement\")?\"map\":\"viewport\"),\"auto\"===this.layout.get(\"text-rotation-alignment\")&&(this.layout._values[\"text-rotation-alignment\"]=\"point\"!==this.layout.get(\"symbol-placement\")?\"map\":\"viewport\"),\"auto\"===this.layout.get(\"text-pitch-alignment\")&&(this.layout._values[\"text-pitch-alignment\"]=this.layout.get(\"text-rotation-alignment\")),\"auto\"===this.layout.get(\"icon-pitch-alignment\")&&(this.layout._values[\"icon-pitch-alignment\"]=this.layout.get(\"icon-rotation-alignment\")),\"point\"===this.layout.get(\"symbol-placement\")){var n=this.layout.get(\"text-writing-mode\");if(n){for(var i=[],a=0,o=n;a<o.length;a+=1){var s=o[a];i.indexOf(s)<0&&i.push(s);}this.layout._values[\"text-writing-mode\"]=i;}else this.layout._values[\"text-writing-mode\"]=[\"horizontal\"];}this._setPaintOverrides();},e.prototype.getValueAndResolveTokens=function(t,e,r,n){var i=this.layout.get(t).evaluate(e,{},r,n),a=this._unevaluatedLayout._values[t];return a.isDataDriven()||Gr(a.value)||!i?i:function(t,e){return e.replace(/{([^{}]+)}/g,(function(e,r){return r in t?String(t[r]):\"\"}))}(e.properties,i)},e.prototype.createBucket=function(t){return new vl(t)},e.prototype.queryRadius=function(){return 0},e.prototype.queryIntersectsFeature=function(){return !1},e.prototype._setPaintOverrides=function(){for(var t=0,r=xl.paint.overridableProperties;t<r.length;t+=1){var n=r[t];if(e.hasPaintOverride(this.layout,n)){var i,a=this.paint.get(n),o=new bl(a),s=new Kr(o,a.property.specification);i=\"constant\"===a.value.kind||\"source\"===a.value.kind?new Xr(\"source\",s):new Jr(\"composite\",s,a.value.zoomStops,a.value._interpolationType),this.paint._values[n]=new yi(a.property,i,a.parameters);}}},e.prototype._handleOverridablePaintPropertyUpdate=function(t,r,n){return !(!this.layout||r.isDataDriven()||n.isDataDriven())&&e.hasPaintOverride(this.layout,t)},e.hasPaintOverride=function(t,e){var r=t.get(\"text-field\"),n=xl.paint.properties[e],i=!1,a=function(t){for(var e=0,r=t;e<r.length;e+=1)if(n.overrides&&n.overrides.hasOverride(r[e]))return void(i=!0)};if(\"constant\"===r.value.kind&&r.value.value instanceof ne)a(r.value.value.sections);else if(\"source\"===r.value.kind){var o=function(t){i||(t instanceof le&&se(t.value)===Gt?a(t.value.sections):t instanceof fe?a(t.sections):t.eachChild(o));},s=r.value;s._styleExpression&&o(s._styleExpression.expression);}return i},e}(_i),_l={paint:new wi({\"background-color\":new mi(Et.paint_background[\"background-color\"]),\"background-pattern\":new xi(Et.paint_background[\"background-pattern\"]),\"background-opacity\":new mi(Et.paint_background[\"background-opacity\"])})},Al=function(t){function e(e){t.call(this,e,_l);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e}(_i),Sl={paint:new wi({\"raster-opacity\":new mi(Et.paint_raster[\"raster-opacity\"]),\"raster-hue-rotate\":new mi(Et.paint_raster[\"raster-hue-rotate\"]),\"raster-brightness-min\":new mi(Et.paint_raster[\"raster-brightness-min\"]),\"raster-brightness-max\":new mi(Et.paint_raster[\"raster-brightness-max\"]),\"raster-saturation\":new mi(Et.paint_raster[\"raster-saturation\"]),\"raster-contrast\":new mi(Et.paint_raster[\"raster-contrast\"]),\"raster-resampling\":new mi(Et.paint_raster[\"raster-resampling\"]),\"raster-fade-duration\":new mi(Et.paint_raster[\"raster-fade-duration\"])})},kl=function(t){function e(e){t.call(this,e,Sl);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e}(_i),Il=function(t){function e(e){t.call(this,e,{}),this.implementation=e;}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.is3D=function(){return \"3d\"===this.implementation.renderingMode},e.prototype.hasOffscreenPass=function(){return void 0!==this.implementation.prerender},e.prototype.recalculate=function(){},e.prototype.updateTransitions=function(){},e.prototype.hasTransition=function(){},e.prototype.serialize=function(){},e.prototype.onAdd=function(t){this.implementation.onAdd&&this.implementation.onAdd(t,t.painter.context.gl);},e.prototype.onRemove=function(t){this.implementation.onRemove&&this.implementation.onRemove(t,t.painter.context.gl);},e}(_i),zl={circle:co,heatmap:_o,hillshade:So,fill:ps,\"fill-extrusion\":zs,line:Rs,symbol:wl,background:Al,raster:kl},Cl=o.HTMLImageElement,El=o.HTMLCanvasElement,Pl=o.HTMLVideoElement,Ml=o.ImageData,Bl=o.ImageBitmap,Tl=function(t,e,r,n){this.context=t,this.format=r,this.texture=t.gl.createTexture(),this.update(e,n);};Tl.prototype.update=function(t,e,r){var n=t.width,i=t.height,a=!(this.size&&this.size[0]===n&&this.size[1]===i||r),o=this.context,s=o.gl;if(this.useMipmap=Boolean(e&&e.useMipmap),s.bindTexture(s.TEXTURE_2D,this.texture),o.pixelStoreUnpackFlipY.set(!1),o.pixelStoreUnpack.set(1),o.pixelStoreUnpackPremultiplyAlpha.set(this.format===s.RGBA&&(!e||!1!==e.premultiply)),a)this.size=[n,i],t instanceof Cl||t instanceof El||t instanceof Pl||t instanceof Ml||Bl&&t instanceof Bl?s.texImage2D(s.TEXTURE_2D,0,this.format,this.format,s.UNSIGNED_BYTE,t):s.texImage2D(s.TEXTURE_2D,0,this.format,n,i,0,this.format,s.UNSIGNED_BYTE,t.data);else {var u=r||{x:0,y:0},l=u.x,p=u.y;t instanceof Cl||t instanceof El||t instanceof Pl||t instanceof Ml||Bl&&t instanceof Bl?s.texSubImage2D(s.TEXTURE_2D,0,l,p,s.RGBA,s.UNSIGNED_BYTE,t):s.texSubImage2D(s.TEXTURE_2D,0,l,p,n,i,s.RGBA,s.UNSIGNED_BYTE,t.data);}this.useMipmap&&this.isSizePowerOfTwo()&&s.generateMipmap(s.TEXTURE_2D);},Tl.prototype.bind=function(t,e,r){var n=this.context.gl;n.bindTexture(n.TEXTURE_2D,this.texture),r!==n.LINEAR_MIPMAP_NEAREST||this.isSizePowerOfTwo()||(r=n.LINEAR),t!==this.filter&&(n.texParameteri(n.TEXTURE_2D,n.TEXTURE_MAG_FILTER,t),n.texParameteri(n.TEXTURE_2D,n.TEXTURE_MIN_FILTER,r||t),this.filter=t),e!==this.wrap&&(n.texParameteri(n.TEXTURE_2D,n.TEXTURE_WRAP_S,e),n.texParameteri(n.TEXTURE_2D,n.TEXTURE_WRAP_T,e),this.wrap=e);},Tl.prototype.isSizePowerOfTwo=function(){return this.size[0]===this.size[1]&&Math.log(this.size[0])/Math.LN2%1==0},Tl.prototype.destroy=function(){this.context.gl.deleteTexture(this.texture),this.texture=null;};var Vl=function(t){var e=this;this._callback=t,this._triggered=!1,\"undefined\"!=typeof MessageChannel&&(this._channel=new MessageChannel,this._channel.port2.onmessage=function(){e._triggered=!1,e._callback();});};Vl.prototype.trigger=function(){var t=this;this._triggered||(this._triggered=!0,this._channel?this._channel.port1.postMessage(!0):setTimeout((function(){t._triggered=!1,t._callback();}),0));},Vl.prototype.remove=function(){delete this._channel,this._callback=function(){};};var Fl=function(t,e,r){this.target=t,this.parent=e,this.mapId=r,this.callbacks={},this.tasks={},this.taskQueue=[],this.cancelCallbacks={},v([\"receive\",\"process\"],this),this.invoker=new Vl(this.process),this.target.addEventListener(\"message\",this.receive,!1),this.globalScope=I()?t:o;};function Dl(t,e,r){var n=2*Math.PI*6378137/256/Math.pow(2,r);return [t*n-2*Math.PI*6378137/2,e*n-2*Math.PI*6378137/2]}Fl.prototype.send=function(t,e,r,n,i){var a=this;void 0===i&&(i=!1);var o=Math.round(1e18*Math.random()).toString(36).substring(0,10);r&&(this.callbacks[o]=r);var s=E(this.globalScope)?void 0:[];return this.target.postMessage({id:o,type:t,hasCallback:!!r,targetMapId:n,mustQueue:i,sourceMapId:this.mapId,data:qn(e,s)},s),{cancel:function(){r&&delete a.callbacks[o],a.target.postMessage({id:o,type:\"<cancel>\",targetMapId:n,sourceMapId:a.mapId});}}},Fl.prototype.receive=function(t){var e=t.data,r=e.id;if(r&&(!e.targetMapId||this.mapId===e.targetMapId))if(\"<cancel>\"===e.type){delete this.tasks[r];var n=this.cancelCallbacks[r];delete this.cancelCallbacks[r],n&&n();}else I()||e.mustQueue?(this.tasks[r]=e,this.taskQueue.push(r),this.invoker.trigger()):this.processTask(r,e);},Fl.prototype.process=function(){if(this.taskQueue.length){var t=this.taskQueue.shift(),e=this.tasks[t];delete this.tasks[t],this.taskQueue.length&&this.invoker.trigger(),e&&this.processTask(t,e);}},Fl.prototype.processTask=function(t,e){var r=this;if(\"<response>\"===e.type){var n=this.callbacks[t];delete this.callbacks[t],n&&(e.error?n(Nn(e.error)):n(null,Nn(e.data)));}else {var i=!1,a=E(this.globalScope)?void 0:[],o=e.hasCallback?function(e,n){i=!0,delete r.cancelCallbacks[t],r.target.postMessage({id:t,type:\"<response>\",sourceMapId:r.mapId,error:e?qn(e):null,data:qn(n,a)},a);}:function(t){i=!0;},s=null,u=Nn(e.data);if(this.parent[e.type])s=this.parent[e.type](e.sourceMapId,u,o);else if(this.parent.getWorkerSource){var l=e.type.split(\".\");s=this.parent.getWorkerSource(e.sourceMapId,l[0],u.source)[l[1]](u,o);}else o(new Error(\"Could not find function \"+e.type));!i&&s&&s.cancel&&(this.cancelCallbacks[t]=s.cancel);}},Fl.prototype.remove=function(){this.invoker.remove(),this.target.removeEventListener(\"message\",this.receive,!1);};var Ll=function(t,e){t&&(e?this.setSouthWest(t).setNorthEast(e):4===t.length?this.setSouthWest([t[0],t[1]]).setNorthEast([t[2],t[3]]):this.setSouthWest(t[0]).setNorthEast(t[1]));};Ll.prototype.setNorthEast=function(t){return this._ne=t instanceof Ol?new Ol(t.lng,t.lat):Ol.convert(t),this},Ll.prototype.setSouthWest=function(t){return this._sw=t instanceof Ol?new Ol(t.lng,t.lat):Ol.convert(t),this},Ll.prototype.extend=function(t){var e,r,n=this._sw,i=this._ne;if(t instanceof Ol)e=t,r=t;else {if(!(t instanceof Ll))return Array.isArray(t)?4===t.length||t.every(Array.isArray)?this.extend(Ll.convert(t)):this.extend(Ol.convert(t)):this;if(r=t._ne,!(e=t._sw)||!r)return this}return n||i?(n.lng=Math.min(e.lng,n.lng),n.lat=Math.min(e.lat,n.lat),i.lng=Math.max(r.lng,i.lng),i.lat=Math.max(r.lat,i.lat)):(this._sw=new Ol(e.lng,e.lat),this._ne=new Ol(r.lng,r.lat)),this},Ll.prototype.getCenter=function(){return new Ol((this._sw.lng+this._ne.lng)/2,(this._sw.lat+this._ne.lat)/2)},Ll.prototype.getSouthWest=function(){return this._sw},Ll.prototype.getNorthEast=function(){return this._ne},Ll.prototype.getNorthWest=function(){return new Ol(this.getWest(),this.getNorth())},Ll.prototype.getSouthEast=function(){return new Ol(this.getEast(),this.getSouth())},Ll.prototype.getWest=function(){return this._sw.lng},Ll.prototype.getSouth=function(){return this._sw.lat},Ll.prototype.getEast=function(){return this._ne.lng},Ll.prototype.getNorth=function(){return this._ne.lat},Ll.prototype.toArray=function(){return [this._sw.toArray(),this._ne.toArray()]},Ll.prototype.toString=function(){return \"LngLatBounds(\"+this._sw.toString()+\", \"+this._ne.toString()+\")\"},Ll.prototype.isEmpty=function(){return !(this._sw&&this._ne)},Ll.prototype.contains=function(t){var e=Ol.convert(t),r=e.lng,n=e.lat,i=this._sw.lng<=r&&r<=this._ne.lng;return this._sw.lng>this._ne.lng&&(i=this._sw.lng>=r&&r>=this._ne.lng),this._sw.lat<=n&&n<=this._ne.lat&&i},Ll.convert=function(t){return !t||t instanceof Ll?t:new Ll(t)};var Ol=function(t,e){if(isNaN(t)||isNaN(e))throw new Error(\"Invalid LngLat object: (\"+t+\", \"+e+\")\");if(this.lng=+t,this.lat=+e,this.lat>90||this.lat<-90)throw new Error(\"Invalid LngLat latitude value: must be between -90 and 90\")};Ol.prototype.wrap=function(){return new Ol(c(this.lng,-180,180),this.lat)},Ol.prototype.toArray=function(){return [this.lng,this.lat]},Ol.prototype.toString=function(){return \"LngLat(\"+this.lng+\", \"+this.lat+\")\"},Ol.prototype.distanceTo=function(t){var e=Math.PI/180,r=this.lat*e,n=t.lat*e,i=Math.sin(r)*Math.sin(n)+Math.cos(r)*Math.cos(n)*Math.cos((t.lng-this.lng)*e);return 6371008.8*Math.acos(Math.min(i,1))},Ol.prototype.toBounds=function(t){void 0===t&&(t=0);var e=360*t/40075017,r=e/Math.cos(Math.PI/180*this.lat);return new Ll(new Ol(this.lng-r,this.lat-e),new Ol(this.lng+r,this.lat+e))},Ol.convert=function(t){if(t instanceof Ol)return t;if(Array.isArray(t)&&(2===t.length||3===t.length))return new Ol(Number(t[0]),Number(t[1]));if(!Array.isArray(t)&&\"object\"==typeof t&&null!==t)return new Ol(Number(\"lng\"in t?t.lng:t.lon),Number(t.lat));throw new Error(\"`LngLatLike` argument must be specified as a LngLat instance, an object {lng: <lng>, lat: <lat>}, an object {lon: <lng>, lat: <lat>}, or an array of [<lng>, <lat>]\")};var Rl=2*Math.PI*6371008.8;function Ul(t){return Rl*Math.cos(t*Math.PI/180)}function jl(t){return (180+t)/360}function ql(t){return (180-180/Math.PI*Math.log(Math.tan(Math.PI/4+t*Math.PI/360)))/360}function Nl(t,e){return t/Ul(e)}function Kl(t){return 360/Math.PI*Math.atan(Math.exp((180-360*t)*Math.PI/180))-90}var Gl=function(t,e,r){void 0===r&&(r=0),this.x=+t,this.y=+e,this.z=+r;};Gl.fromLngLat=function(t,e){void 0===e&&(e=0);var r=Ol.convert(t);return new Gl(jl(r.lng),ql(r.lat),Nl(e,r.lat))},Gl.prototype.toLngLat=function(){return new Ol(360*this.x-180,Kl(this.y))},Gl.prototype.toAltitude=function(){return this.z*Ul(Kl(this.y))},Gl.prototype.meterInMercatorCoordinateUnits=function(){return 1/Rl*(t=Kl(this.y),1/Math.cos(t*Math.PI/180));var t;};var Zl=function(t,e,r){this.z=t,this.x=e,this.y=r,this.key=Hl(0,t,t,e,r);};Zl.prototype.equals=function(t){return this.z===t.z&&this.x===t.x&&this.y===t.y},Zl.prototype.url=function(t,e){var r,n,i,a,o,s=(n=this.y,i=this.z,a=Dl(256*(r=this.x),256*(n=Math.pow(2,i)-n-1),i),o=Dl(256*(r+1),256*(n+1),i),a[0]+\",\"+a[1]+\",\"+o[0]+\",\"+o[1]),u=function(t,e,r){for(var n,i=\"\",a=t;a>0;a--)i+=(e&(n=1<<a-1)?1:0)+(r&n?2:0);return i}(this.z,this.x,this.y);return t[(this.x+this.y)%t.length].replace(\"{prefix}\",(this.x%16).toString(16)+(this.y%16).toString(16)).replace(\"{z}\",String(this.z)).replace(\"{x}\",String(this.x)).replace(\"{y}\",String(\"tms\"===e?Math.pow(2,this.z)-this.y-1:this.y)).replace(\"{quadkey}\",u).replace(\"{bbox-epsg-3857}\",s)},Zl.prototype.getTilePoint=function(t){var e=Math.pow(2,this.z);return new i(8192*(t.x*e-this.x),8192*(t.y*e-this.y))},Zl.prototype.toString=function(){return this.z+\"/\"+this.x+\"/\"+this.y};var Xl=function(t,e){this.wrap=t,this.canonical=e,this.key=Hl(t,e.z,e.z,e.x,e.y);},Jl=function(t,e,r,n,i){this.overscaledZ=t,this.wrap=e,this.canonical=new Zl(r,+n,+i),this.key=Hl(e,t,r,n,i);};function Hl(t,e,r,n,i){(t*=2)<0&&(t=-1*t-1);var a=1<<r;return (a*a*t+a*i+n).toString(36)+r.toString(36)+e.toString(36)}Jl.prototype.equals=function(t){return this.overscaledZ===t.overscaledZ&&this.wrap===t.wrap&&this.canonical.equals(t.canonical)},Jl.prototype.scaledTo=function(t){var e=this.canonical.z-t;return t>this.canonical.z?new Jl(t,this.wrap,this.canonical.z,this.canonical.x,this.canonical.y):new Jl(t,this.wrap,t,this.canonical.x>>e,this.canonical.y>>e)},Jl.prototype.calculateScaledKey=function(t,e){var r=this.canonical.z-t;return t>this.canonical.z?Hl(this.wrap*+e,t,this.canonical.z,this.canonical.x,this.canonical.y):Hl(this.wrap*+e,t,t,this.canonical.x>>r,this.canonical.y>>r)},Jl.prototype.isChildOf=function(t){if(t.wrap!==this.wrap)return !1;var e=this.canonical.z-t.canonical.z;return 0===t.overscaledZ||t.overscaledZ<this.overscaledZ&&t.canonical.x===this.canonical.x>>e&&t.canonical.y===this.canonical.y>>e},Jl.prototype.children=function(t){if(this.overscaledZ>=t)return [new Jl(this.overscaledZ+1,this.wrap,this.canonical.z,this.canonical.x,this.canonical.y)];var e=this.canonical.z+1,r=2*this.canonical.x,n=2*this.canonical.y;return [new Jl(e,this.wrap,e,r,n),new Jl(e,this.wrap,e,r+1,n),new Jl(e,this.wrap,e,r,n+1),new Jl(e,this.wrap,e,r+1,n+1)]},Jl.prototype.isLessThan=function(t){return this.wrap<t.wrap||!(this.wrap>t.wrap)&&(this.overscaledZ<t.overscaledZ||!(this.overscaledZ>t.overscaledZ)&&(this.canonical.x<t.canonical.x||!(this.canonical.x>t.canonical.x)&&this.canonical.y<t.canonical.y))},Jl.prototype.wrapped=function(){return new Jl(this.overscaledZ,0,this.canonical.z,this.canonical.x,this.canonical.y)},Jl.prototype.unwrapTo=function(t){return new Jl(this.overscaledZ,t,this.canonical.z,this.canonical.x,this.canonical.y)},Jl.prototype.overscaleFactor=function(){return Math.pow(2,this.overscaledZ-this.canonical.z)},Jl.prototype.toUnwrapped=function(){return new Xl(this.wrap,this.canonical)},Jl.prototype.toString=function(){return this.overscaledZ+\"/\"+this.canonical.x+\"/\"+this.canonical.y},Jl.prototype.getTilePoint=function(t){return this.canonical.getTilePoint(new Gl(t.x-this.wrap,t.y))},On(\"CanonicalTileID\",Zl),On(\"OverscaledTileID\",Jl,{omit:[\"posMatrix\"]});var Yl=function(t,e,r){if(this.uid=t,e.height!==e.width)throw new RangeError(\"DEM tiles must be square\");if(r&&\"mapbox\"!==r&&\"terrarium\"!==r)return A('\"'+r+'\" is not a valid encoding type. Valid types include \"mapbox\" and \"terrarium\".');this.stride=e.height;var n=this.dim=e.height-2;this.data=new Uint32Array(e.data.buffer),this.encoding=r||\"mapbox\";for(var i=0;i<n;i++)this.data[this._idx(-1,i)]=this.data[this._idx(0,i)],this.data[this._idx(n,i)]=this.data[this._idx(n-1,i)],this.data[this._idx(i,-1)]=this.data[this._idx(i,0)],this.data[this._idx(i,n)]=this.data[this._idx(i,n-1)];this.data[this._idx(-1,-1)]=this.data[this._idx(0,0)],this.data[this._idx(n,-1)]=this.data[this._idx(n-1,0)],this.data[this._idx(-1,n)]=this.data[this._idx(0,n-1)],this.data[this._idx(n,n)]=this.data[this._idx(n-1,n-1)];};Yl.prototype.get=function(t,e){var r=new Uint8Array(this.data.buffer),n=4*this._idx(t,e);return (\"terrarium\"===this.encoding?this._unpackTerrarium:this._unpackMapbox)(r[n],r[n+1],r[n+2])},Yl.prototype.getUnpackVector=function(){return \"terrarium\"===this.encoding?[256,1,1/256,32768]:[6553.6,25.6,.1,1e4]},Yl.prototype._idx=function(t,e){if(t<-1||t>=this.dim+1||e<-1||e>=this.dim+1)throw new RangeError(\"out of range source coordinates for DEM data\");return (e+1)*this.stride+(t+1)},Yl.prototype._unpackMapbox=function(t,e,r){return (256*t*256+256*e+r)/10-1e4},Yl.prototype._unpackTerrarium=function(t,e,r){return 256*t+e+r/256-32768},Yl.prototype.getPixels=function(){return new xo({width:this.stride,height:this.stride},new Uint8Array(this.data.buffer))},Yl.prototype.backfillBorder=function(t,e,r){if(this.dim!==t.dim)throw new Error(\"dem dimension mismatch\");var n=e*this.dim,i=e*this.dim+this.dim,a=r*this.dim,o=r*this.dim+this.dim;switch(e){case-1:n=i-1;break;case 1:i=n+1;}switch(r){case-1:a=o-1;break;case 1:o=a+1;}for(var s=-e*this.dim,u=-r*this.dim,l=a;l<o;l++)for(var p=n;p<i;p++)this.data[this._idx(p,l)]=t.data[this._idx(p+s,l+u)];},On(\"DEMData\",Yl);var $l=function(t){this._stringToNumber={},this._numberToString=[];for(var e=0;e<t.length;e++){var r=t[e];this._stringToNumber[r]=e,this._numberToString[e]=r;}};$l.prototype.encode=function(t){return this._stringToNumber[t]},$l.prototype.decode=function(t){return this._numberToString[t]};var Wl=function(t,e,r,n,i){this.type=\"Feature\",this._vectorTileFeature=t,t._z=e,t._x=r,t._y=n,this.properties=t.properties,this.id=i;},Ql={geometry:{configurable:!0}};Ql.geometry.get=function(){return void 0===this._geometry&&(this._geometry=this._vectorTileFeature.toGeoJSON(this._vectorTileFeature._x,this._vectorTileFeature._y,this._vectorTileFeature._z).geometry),this._geometry},Ql.geometry.set=function(t){this._geometry=t;},Wl.prototype.toJSON=function(){var t={geometry:this.geometry};for(var e in this)\"_geometry\"!==e&&\"_vectorTileFeature\"!==e&&(t[e]=this[e]);return t},Object.defineProperties(Wl.prototype,Ql);var tp=function(){this.state={},this.stateChanges={},this.deletedStates={};};tp.prototype.updateState=function(t,e,r){var n=String(e);if(this.stateChanges[t]=this.stateChanges[t]||{},this.stateChanges[t][n]=this.stateChanges[t][n]||{},h(this.stateChanges[t][n],r),null===this.deletedStates[t])for(var i in this.deletedStates[t]={},this.state[t])i!==n&&(this.deletedStates[t][i]=null);else if(this.deletedStates[t]&&null===this.deletedStates[t][n])for(var a in this.deletedStates[t][n]={},this.state[t][n])r[a]||(this.deletedStates[t][n][a]=null);else for(var o in r)this.deletedStates[t]&&this.deletedStates[t][n]&&null===this.deletedStates[t][n][o]&&delete this.deletedStates[t][n][o];},tp.prototype.removeFeatureState=function(t,e,r){if(null!==this.deletedStates[t]){var n=String(e);if(this.deletedStates[t]=this.deletedStates[t]||{},r&&void 0!==e)null!==this.deletedStates[t][n]&&(this.deletedStates[t][n]=this.deletedStates[t][n]||{},this.deletedStates[t][n][r]=null);else if(void 0!==e)if(this.stateChanges[t]&&this.stateChanges[t][n])for(r in this.deletedStates[t][n]={},this.stateChanges[t][n])this.deletedStates[t][n][r]=null;else this.deletedStates[t][n]=null;else this.deletedStates[t]=null;}},tp.prototype.getState=function(t,e){var r=String(e),n=h({},(this.state[t]||{})[r],(this.stateChanges[t]||{})[r]);if(null===this.deletedStates[t])return {};if(this.deletedStates[t]){var i=this.deletedStates[t][e];if(null===i)return {};for(var a in i)delete n[a];}return n},tp.prototype.initializeTileState=function(t,e){t.setFeatureState(this.state,e);},tp.prototype.coalesceChanges=function(t,e){var r={};for(var n in this.stateChanges){this.state[n]=this.state[n]||{};var i={};for(var a in this.stateChanges[n])this.state[n][a]||(this.state[n][a]={}),h(this.state[n][a],this.stateChanges[n][a]),i[a]=this.state[n][a];r[n]=i;}for(var o in this.deletedStates){this.state[o]=this.state[o]||{};var s={};if(null===this.deletedStates[o])for(var u in this.state[o])s[u]={},this.state[o][u]={};else for(var l in this.deletedStates[o]){if(null===this.deletedStates[o][l])this.state[o][l]={};else for(var p=0,c=Object.keys(this.deletedStates[o][l]);p<c.length;p+=1)delete this.state[o][l][c[p]];s[l]=this.state[o][l];}r[o]=r[o]||{},h(r[o],s);}if(this.stateChanges={},this.deletedStates={},0!==Object.keys(r).length)for(var f in t)t[f].setFeatureState(r,e);};var ep=function(t,e){this.tileID=t,this.x=t.canonical.x,this.y=t.canonical.y,this.z=t.canonical.z,this.grid=new Tn(8192,16,0),this.grid3D=new Tn(8192,16,0),this.featureIndexArray=new aa,this.promoteId=e;};function rp(t,e,r,n,i){return x(t,(function(t,a){var o=e instanceof di?e.get(a):null;return o&&o.evaluate?o.evaluate(r,n,i):o}))}function np(t){for(var e=1/0,r=1/0,n=-1/0,i=-1/0,a=0,o=t;a<o.length;a+=1){var s=o[a];e=Math.min(e,s.x),r=Math.min(r,s.y),n=Math.max(n,s.x),i=Math.max(i,s.y);}return {minX:e,minY:r,maxX:n,maxY:i}}function ip(t,e){return e-t}ep.prototype.insert=function(t,e,r,n,i,a){var o=this.featureIndexArray.length;this.featureIndexArray.emplaceBack(r,n,i);for(var s=a?this.grid3D:this.grid,u=0;u<e.length;u++){for(var l=e[u],p=[1/0,1/0,-1/0,-1/0],c=0;c<l.length;c++){var h=l[c];p[0]=Math.min(p[0],h.x),p[1]=Math.min(p[1],h.y),p[2]=Math.max(p[2],h.x),p[3]=Math.max(p[3],h.y);}p[0]<8192&&p[1]<8192&&p[2]>=0&&p[3]>=0&&s.insert(o,p[0],p[1],p[2],p[3]);}},ep.prototype.loadVTLayers=function(){return this.vtLayers||(this.vtLayers=new bs.VectorTile(new Ys(this.rawTileData)).layers,this.sourceLayerCoder=new $l(this.vtLayers?Object.keys(this.vtLayers).sort():[\"_geojsonTileLayer\"])),this.vtLayers},ep.prototype.query=function(t,e,r,n){var a=this;this.loadVTLayers();for(var o=t.params||{},s=8192/t.tileSize/t.scale,u=on(o.filter),l=t.queryGeometry,p=t.queryPadding*s,c=np(l),h=this.grid.query(c.minX-p,c.minY-p,c.maxX+p,c.maxY+p),f=np(t.cameraQueryGeometry),y=this.grid3D.query(f.minX-p,f.minY-p,f.maxX+p,f.maxY+p,(function(e,r,n,a){return function(t,e,r,n,a){for(var o=0,s=t;o<s.length;o+=1){var u=s[o];if(e<=u.x&&r<=u.y&&n>=u.x&&a>=u.y)return !0}var l=[new i(e,r),new i(e,a),new i(n,a),new i(n,r)];if(t.length>2)for(var p=0,c=l;p<c.length;p+=1)if(Wa(t,c[p]))return !0;for(var h=0;h<t.length-1;h++)if(Qa(t[h],t[h+1],l))return !0;return !1}(t.cameraQueryGeometry,e-p,r-p,n+p,a+p)})),d=0,m=y;d<m.length;d+=1)h.push(m[d]);h.sort(ip);for(var v,g={},x=function(i){var p=h[i];if(p!==v){v=p;var c=a.featureIndexArray.get(p),f=null;a.loadMatchingFeature(g,c.bucketIndex,c.sourceLayerIndex,c.featureIndex,u,o.layers,o.availableImages,e,r,n,(function(e,r,n){return f||(f=Ra(e)),r.queryIntersectsFeature(l,e,n,f,a.z,t.transform,s,t.pixelPosMatrix)}));}},b=0;b<h.length;b++)x(b);return g},ep.prototype.loadMatchingFeature=function(t,e,r,n,i,a,o,s,u,l,p){var c=this.bucketLayerIDs[e];if(!a||function(t,e){for(var r=0;r<t.length;r++)if(e.indexOf(t[r])>=0)return !0;return !1}(a,c)){var f=this.sourceLayerCoder.decode(r),y=this.vtLayers[f].feature(n);if(i.needGeometry){var d=Ua(y,!0);if(!i.filter(new si(this.tileID.overscaledZ),d,this.tileID.canonical))return}else if(!i.filter(new si(this.tileID.overscaledZ),y))return;for(var m=this.getId(y,f),v=0;v<c.length;v++){var g=c[v];if(!(a&&a.indexOf(g)<0)){var x=s[g];if(x){var b={};void 0!==m&&l&&(b=l.getState(x.sourceLayer||\"_geojsonTileLayer\",m));var w=h({},u[g]);w.paint=rp(w.paint,x.paint,y,b,o),w.layout=rp(w.layout,x.layout,y,b,o);var _=!p||p(y,x,b);if(_){var A=new Wl(y,this.z,this.x,this.y,m);A.layer=w;var S=t[g];void 0===S&&(S=t[g]=[]),S.push({featureIndex:n,feature:A,intersectionZ:_});}}}}}},ep.prototype.lookupSymbolFeatures=function(t,e,r,n,i,a,o,s){var u={};this.loadVTLayers();for(var l=on(i),p=0,c=t;p<c.length;p+=1)this.loadMatchingFeature(u,r,n,c[p],l,a,o,s,e);return u},ep.prototype.hasLayer=function(t){for(var e=0,r=this.bucketLayerIDs;e<r.length;e+=1)for(var n=0,i=r[e];n<i.length;n+=1)if(t===i[n])return !0;return !1},ep.prototype.getId=function(t,e){var r=t.id;return this.promoteId&&\"boolean\"==typeof(r=t.properties[\"string\"==typeof this.promoteId?this.promoteId:this.promoteId[e]])&&(r=Number(r)),r},On(\"FeatureIndex\",ep,{omit:[\"rawTileData\",\"sourceLayerCoder\"]});var ap=function(t,e){this.tileID=t,this.uid=y(),this.uses=0,this.tileSize=e,this.buckets={},this.expirationTime=null,this.queryPadding=0,this.hasSymbolBuckets=!1,this.hasRTLText=!1,this.dependencies={},this.expiredRequestCount=0,this.state=\"loading\";};ap.prototype.registerFadeDuration=function(t){var e=t+this.timeAdded;e<O.now()||this.fadeEndTime&&e<this.fadeEndTime||(this.fadeEndTime=e);},ap.prototype.wasRequested=function(){return \"errored\"===this.state||\"loaded\"===this.state||\"reloading\"===this.state},ap.prototype.loadVectorData=function(t,e,r){if(this.hasData()&&this.unloadVectorData(),this.state=\"loaded\",t){for(var n in t.featureIndex&&(this.latestFeatureIndex=t.featureIndex,t.rawTileData?(this.latestRawTileData=t.rawTileData,this.latestFeatureIndex.rawTileData=t.rawTileData):this.latestRawTileData&&(this.latestFeatureIndex.rawTileData=this.latestRawTileData)),this.collisionBoxArray=t.collisionBoxArray,this.buckets=function(t,e){var r={};if(!e)return r;for(var n=function(){var t=a[i],n=t.layerIds.map((function(t){return e.getLayer(t)})).filter(Boolean);if(0!==n.length){t.layers=n,t.stateDependentLayerIds&&(t.stateDependentLayers=t.stateDependentLayerIds.map((function(t){return n.filter((function(e){return e.id===t}))[0]})));for(var o=0,s=n;o<s.length;o+=1)r[s[o].id]=t;}},i=0,a=t;i<a.length;i+=1)n();return r}(t.buckets,e.style),this.hasSymbolBuckets=!1,this.buckets){var i=this.buckets[n];if(i instanceof vl){if(this.hasSymbolBuckets=!0,!r)break;i.justReloaded=!0;}}if(this.hasRTLText=!1,this.hasSymbolBuckets)for(var a in this.buckets){var o=this.buckets[a];if(o instanceof vl&&o.hasRTLText){this.hasRTLText=!0,oi.isLoading()||oi.isLoaded()||\"deferred\"!==ii()||ai();break}}for(var s in this.queryPadding=0,this.buckets){var u=this.buckets[s];this.queryPadding=Math.max(this.queryPadding,e.style.getLayer(s).queryRadius(u));}t.imageAtlas&&(this.imageAtlas=t.imageAtlas),t.glyphAtlasImage&&(this.glyphAtlasImage=t.glyphAtlasImage);}else this.collisionBoxArray=new $i;},ap.prototype.unloadVectorData=function(){for(var t in this.buckets)this.buckets[t].destroy();this.buckets={},this.imageAtlasTexture&&this.imageAtlasTexture.destroy(),this.imageAtlas&&(this.imageAtlas=null),this.glyphAtlasTexture&&this.glyphAtlasTexture.destroy(),this.latestFeatureIndex=null,this.state=\"unloaded\";},ap.prototype.getBucket=function(t){return this.buckets[t.id]},ap.prototype.upload=function(t){for(var e in this.buckets){var r=this.buckets[e];r.uploadPending()&&r.upload(t);}var n=t.gl;this.imageAtlas&&!this.imageAtlas.uploaded&&(this.imageAtlasTexture=new Tl(t,this.imageAtlas.image,n.RGBA),this.imageAtlas.uploaded=!0),this.glyphAtlasImage&&(this.glyphAtlasTexture=new Tl(t,this.glyphAtlasImage,n.ALPHA),this.glyphAtlasImage=null);},ap.prototype.prepare=function(t){this.imageAtlas&&this.imageAtlas.patchUpdatedImages(t,this.imageAtlasTexture);},ap.prototype.queryRenderedFeatures=function(t,e,r,n,i,a,o,s,u,l){return this.latestFeatureIndex&&this.latestFeatureIndex.rawTileData?this.latestFeatureIndex.query({queryGeometry:n,cameraQueryGeometry:i,scale:a,tileSize:this.tileSize,pixelPosMatrix:l,transform:s,params:o,queryPadding:this.queryPadding*u},t,e,r):{}},ap.prototype.querySourceFeatures=function(t,e){var r=this.latestFeatureIndex;if(r&&r.rawTileData){var n=r.loadVTLayers(),i=e?e.sourceLayer:\"\",a=n._geojsonTileLayer||n[i];if(a)for(var o=on(e&&e.filter),s=this.tileID.canonical,u=s.z,l=s.x,p=s.y,c={z:u,x:l,y:p},h=0;h<a.length;h++){var f=a.feature(h);if(o.needGeometry){var y=Ua(f,!0);if(!o.filter(new si(this.tileID.overscaledZ),y,this.tileID.canonical))continue}else if(!o.filter(new si(this.tileID.overscaledZ),f))continue;var d=r.getId(f,i),m=new Wl(f,u,l,p,d);m.tile=c,t.push(m);}}},ap.prototype.hasData=function(){return \"loaded\"===this.state||\"reloading\"===this.state||\"expired\"===this.state},ap.prototype.patternsLoaded=function(){return this.imageAtlas&&!!Object.keys(this.imageAtlas.patternPositions).length},ap.prototype.setExpiryData=function(t){var e=this.expirationTime;if(t.cacheControl){var r=z(t.cacheControl);r[\"max-age\"]&&(this.expirationTime=Date.now()+1e3*r[\"max-age\"]);}else t.expires&&(this.expirationTime=new Date(t.expires).getTime());if(this.expirationTime){var n=Date.now(),i=!1;if(this.expirationTime>n)i=!1;else if(e)if(this.expirationTime<e)i=!0;else {var a=this.expirationTime-e;a?this.expirationTime=n+Math.max(a,3e4):i=!0;}else i=!0;i?(this.expiredRequestCount++,this.state=\"expired\"):this.expiredRequestCount=0;}},ap.prototype.getExpiryTimeout=function(){if(this.expirationTime)return this.expiredRequestCount?1e3*(1<<Math.min(this.expiredRequestCount-1,31)):Math.min(this.expirationTime-(new Date).getTime(),Math.pow(2,31)-1)},ap.prototype.setFeatureState=function(t,e){if(this.latestFeatureIndex&&this.latestFeatureIndex.rawTileData&&0!==Object.keys(t).length){var r=this.latestFeatureIndex.loadVTLayers();for(var n in this.buckets)if(e.style.hasLayer(n)){var i=this.buckets[n],a=i.layers[0].sourceLayer||\"_geojsonTileLayer\",o=r[a],s=t[a];if(o&&s&&0!==Object.keys(s).length){i.update(s,o,this.imageAtlas&&this.imageAtlas.patternPositions||{});var u=e&&e.style&&e.style.getLayer(n);u&&(this.queryPadding=Math.max(this.queryPadding,u.queryRadius(i)));}}}},ap.prototype.holdingForFade=function(){return void 0!==this.symbolFadeHoldUntil},ap.prototype.symbolFadeFinished=function(){return !this.symbolFadeHoldUntil||this.symbolFadeHoldUntil<O.now()},ap.prototype.clearFadeHold=function(){this.symbolFadeHoldUntil=void 0;},ap.prototype.setHoldDuration=function(t){this.symbolFadeHoldUntil=O.now()+t;},ap.prototype.setDependencies=function(t,e){for(var r={},n=0,i=e;n<i.length;n+=1)r[i[n]]=!0;this.dependencies[t]=r;},ap.prototype.hasDependency=function(t,e){for(var r=0,n=t;r<n.length;r+=1){var i=this.dependencies[n[r]];if(i)for(var a=0,o=e;a<o.length;a+=1)if(i[o[a]])return !0}return !1};var op=o.performance,sp=function(t){this._marks={start:[t.url,\"start\"].join(\"#\"),end:[t.url,\"end\"].join(\"#\"),measure:t.url.toString()},op.mark(this._marks.start);};sp.prototype.finish=function(){op.mark(this._marks.end);var t=op.getEntriesByName(this._marks.measure);return 0===t.length&&(op.measure(this._marks.measure,this._marks.start,this._marks.end),t=op.getEntriesByName(this._marks.measure),op.clearMarks(this._marks.start),op.clearMarks(this._marks.end),op.clearMeasures(this._marks.measure)),t},t.Actor=Fl,t.AlphaImage=go,t.CanonicalTileID=Zl,t.CollisionBoxArray=$i,t.Color=te,t.DEMData=Yl,t.DataConstantProperty=mi,t.DictionaryCoder=$l,t.EXTENT=8192,t.ErrorEvent=zt,t.EvaluationParameters=si,t.Event=It,t.Evented=Ct,t.FeatureIndex=ep,t.FillBucket=ss,t.FillExtrusionBucket=Ss,t.ImageAtlas=bu,t.ImagePosition=gu,t.LineBucket=Fs,t.LngLat=Ol,t.LngLatBounds=Ll,t.MercatorCoordinate=Gl,t.ONE_EM=24,t.OverscaledTileID=Jl,t.Point=i,t.Point$1=i,t.Properties=wi,t.Protobuf=Ys,t.RGBAImage=xo,t.RequestManager=G,t.RequestPerformance=sp,t.ResourceType=yt,t.SegmentVector=sa,t.SourceFeatureState=tp,t.StructArrayLayout1ui2=Ji,t.StructArrayLayout2f1f2i16=Ri,t.StructArrayLayout2i4=Ci,t.StructArrayLayout3ui6=ji,t.StructArrayLayout4i8=Ei,t.SymbolBucket=vl,t.Texture=Tl,t.Tile=ap,t.Transitionable=pi,t.Uniform1f=ba,t.Uniform1i=xa,t.Uniform2f=wa,t.Uniform3f=_a,t.Uniform4f=Aa,t.UniformColor=Sa,t.UniformMatrix4f=Ia,t.UnwrappedTileID=Xl,t.ValidationError=Pt,t.WritingMode=wu,t.ZoomHistory=Kn,t.add=function(t,e,r){return t[0]=e[0]+r[0],t[1]=e[1]+r[1],t[2]=e[2]+r[2],t},t.addDynamicAttributes=fl,t.asyncAll=function(t,e,r){if(!t.length)return r(null,[]);var n=t.length,i=new Array(t.length),a=null;t.forEach((function(t,o){e(t,(function(t,e){t&&(a=t),i[o]=e,0==--n&&r(a,i);}));}));},t.bezier=u,t.bindAll=v,t.browser=O,t.cacheEntryPossiblyAdded=function(t){++ht>ut&&(t.getActor().send(\"enforceCacheSizeLimit\",st),ht=0);},t.clamp=p,t.clearTileCache=function(t){var e=o.caches.delete(\"mapbox-tiles\");t&&e.catch(t).then((function(){return t()}));},t.clipLine=Zu,t.clone=function(t){var e=new ao(16);return e[0]=t[0],e[1]=t[1],e[2]=t[2],e[3]=t[3],e[4]=t[4],e[5]=t[5],e[6]=t[6],e[7]=t[7],e[8]=t[8],e[9]=t[9],e[10]=t[10],e[11]=t[11],e[12]=t[12],e[13]=t[13],e[14]=t[14],e[15]=t[15],e},t.clone$1=w,t.clone$2=function(t){var e=new ao(3);return e[0]=t[0],e[1]=t[1],e[2]=t[2],e},t.collisionCircleLayout=Gs,t.config=R,t.create=function(){var t=new ao(16);return ao!=Float32Array&&(t[1]=0,t[2]=0,t[3]=0,t[4]=0,t[6]=0,t[7]=0,t[8]=0,t[9]=0,t[11]=0,t[12]=0,t[13]=0,t[14]=0),t[0]=1,t[5]=1,t[10]=1,t[15]=1,t},t.create$1=function(){var t=new ao(9);return ao!=Float32Array&&(t[1]=0,t[2]=0,t[3]=0,t[5]=0,t[6]=0,t[7]=0),t[0]=1,t[4]=1,t[8]=1,t},t.create$2=function(){var t=new ao(4);return ao!=Float32Array&&(t[1]=0,t[2]=0),t[0]=1,t[3]=1,t},t.createCommonjsModule=e,t.createExpression=Zr,t.createLayout=Ii,t.createStyleLayer=function(t){return \"custom\"===t.type?new Il(t):new zl[t.type](t)},t.cross=function(t,e,r){var n=e[0],i=e[1],a=e[2],o=r[0],s=r[1],u=r[2];return t[0]=i*u-a*s,t[1]=a*o-n*u,t[2]=n*s-i*o,t},t.deepEqual=function t(e,r){if(Array.isArray(e)){if(!Array.isArray(r)||e.length!==r.length)return !1;for(var n=0;n<e.length;n++)if(!t(e[n],r[n]))return !1;return !0}if(\"object\"==typeof e&&null!==e&&null!==r){if(\"object\"!=typeof r)return !1;if(Object.keys(e).length!==Object.keys(r).length)return !1;for(var i in e)if(!t(e[i],r[i]))return !1;return !0}return e===r},t.dot=function(t,e){return t[0]*e[0]+t[1]*e[1]+t[2]*e[2]},t.dot$1=function(t,e){return t[0]*e[0]+t[1]*e[1]+t[2]*e[2]+t[3]*e[3]},t.ease=l,t.emitValidationErrors=Bn,t.endsWith=g,t.enforceCacheSizeLimit=function(t){lt(),tt&&tt.then((function(e){e.keys().then((function(r){for(var n=0;n<r.length-t;n++)e.delete(r[n]);}));}));},t.evaluateSizeForFeature=Lu,t.evaluateSizeForZoom=Ou,t.evaluateVariableOffset=al,t.evented=ni,t.extend=h,t.featureFilter=on,t.filterObject=b,t.fromRotation=function(t,e){var r=Math.sin(e),n=Math.cos(e);return t[0]=n,t[1]=r,t[2]=0,t[3]=-r,t[4]=n,t[5]=0,t[6]=0,t[7]=0,t[8]=1,t},t.getAnchorAlignment=Bu,t.getAnchorJustification=ol,t.getArrayBuffer=bt,t.getImage=At,t.getJSON=function(t,e){return xt(h(t,{type:\"json\"}),e)},t.getRTLTextPluginStatus=ii,t.getReferrer=mt,t.getVideo=function(t,e){var r,n,i=o.document.createElement(\"video\");i.muted=!0,i.onloadstart=function(){e(null,i);};for(var a=0;a<t.length;a++){var s=o.document.createElement(\"source\");r=t[a],n=void 0,(n=o.document.createElement(\"a\")).href=r,(n.protocol!==o.document.location.protocol||n.host!==o.document.location.host)&&(i.crossOrigin=\"Anonymous\"),s.src=t[a],i.appendChild(s);}return {cancel:function(){}}},t.identity=oo,t.invert=function(t,e){var r=e[0],n=e[1],i=e[2],a=e[3],o=e[4],s=e[5],u=e[6],l=e[7],p=e[8],c=e[9],h=e[10],f=e[11],y=e[12],d=e[13],m=e[14],v=e[15],g=r*s-n*o,x=r*u-i*o,b=r*l-a*o,w=n*u-i*s,_=n*l-a*s,A=i*l-a*u,S=p*d-c*y,k=p*m-h*y,I=p*v-f*y,z=c*m-h*d,C=c*v-f*d,E=h*v-f*m,P=g*E-x*C+b*z+w*I-_*k+A*S;return P?(t[0]=(s*E-u*C+l*z)*(P=1/P),t[1]=(i*C-n*E-a*z)*P,t[2]=(d*A-m*_+v*w)*P,t[3]=(h*_-c*A-f*w)*P,t[4]=(u*I-o*E-l*k)*P,t[5]=(r*E-i*I+a*k)*P,t[6]=(m*b-y*A-v*x)*P,t[7]=(p*A-h*b+f*x)*P,t[8]=(o*C-s*I+l*S)*P,t[9]=(n*I-r*C-a*S)*P,t[10]=(y*_-d*b+v*g)*P,t[11]=(c*b-p*_-f*g)*P,t[12]=(s*k-o*z-u*S)*P,t[13]=(r*z-n*k+i*S)*P,t[14]=(d*x-y*w-m*g)*P,t[15]=(p*w-c*x+h*g)*P,t):null},t.isChar=Gn,t.isMapboxURL=Z,t.keysDifference=function(t,e){var r=[];for(var n in t)n in e||r.push(n);return r},t.makeRequest=xt,t.mapObject=x,t.mercatorXfromLng=jl,t.mercatorYfromLat=ql,t.mercatorZfromAltitude=Nl,t.mul=lo,t.multiply=so,t.mvt=bs,t.nextPowerOfTwo=function(t){return t<=1?1:Math.pow(2,Math.ceil(Math.log(t)/Math.LN2))},t.normalize=function(t,e){var r=e[0],n=e[1],i=e[2],a=r*r+n*n+i*i;return a>0&&(a=1/Math.sqrt(a)),t[0]=e[0]*a,t[1]=e[1]*a,t[2]=e[2]*a,t},t.number=Ke,t.offscreenCanvasSupported=ft,t.ortho=function(t,e,r,n,i,a,o){var s=1/(e-r),u=1/(n-i),l=1/(a-o);return t[0]=-2*s,t[1]=0,t[2]=0,t[3]=0,t[4]=0,t[5]=-2*u,t[6]=0,t[7]=0,t[8]=0,t[9]=0,t[10]=2*l,t[11]=0,t[12]=(e+r)*s,t[13]=(i+n)*u,t[14]=(o+a)*l,t[15]=1,t},t.parseGlyphPBF=function(t){return new Ys(t).readFields(yu,[])},t.pbf=Ys,t.performSymbolLayout=function(t,e,r,n,i,a,o){t.createArrays(),t.tilePixelRatio=8192/(512*t.overscaling),t.compareText={},t.iconsNeedLinear=!1;var s=t.layers[0].layout,u=t.layers[0]._unevaluatedLayout._values,l={};if(\"composite\"===t.textSizeData.kind){var p=t.textSizeData,c=p.maxZoom;l.compositeTextSizes=[u[\"text-size\"].possiblyEvaluate(new si(p.minZoom),o),u[\"text-size\"].possiblyEvaluate(new si(c),o)];}if(\"composite\"===t.iconSizeData.kind){var h=t.iconSizeData,f=h.maxZoom;l.compositeIconSizes=[u[\"icon-size\"].possiblyEvaluate(new si(h.minZoom),o),u[\"icon-size\"].possiblyEvaluate(new si(f),o)];}l.layoutTextSize=u[\"text-size\"].possiblyEvaluate(new si(t.zoom+1),o),l.layoutIconSize=u[\"icon-size\"].possiblyEvaluate(new si(t.zoom+1),o),l.textMaxSize=u[\"text-size\"].possiblyEvaluate(new si(18));for(var y=24*s.get(\"text-line-height\"),d=\"map\"===s.get(\"text-rotation-alignment\")&&\"point\"!==s.get(\"symbol-placement\"),m=s.get(\"text-keep-upright\"),v=s.get(\"text-size\"),g=function(){var a=b[x],u=s.get(\"text-font\").evaluate(a,{},o).join(\",\"),p=v.evaluate(a,{},o),c=l.layoutTextSize.evaluate(a,{},o),h=l.layoutIconSize.evaluate(a,{},o),f={horizontal:{},vertical:void 0},g=a.text,w=[0,0];if(g){var _=g.toString(),S=24*s.get(\"text-letter-spacing\").evaluate(a,{},o),k=function(t){for(var e=0,r=t;e<r.length;e+=1)if(n=r[e].charCodeAt(0),Gn.Arabic(n)||Gn[\"Arabic Supplement\"](n)||Gn[\"Arabic Extended-A\"](n)||Gn[\"Arabic Presentation Forms-A\"](n)||Gn[\"Arabic Presentation Forms-B\"](n))return !1;var n;return !0}(_)?S:0,I=s.get(\"text-anchor\").evaluate(a,{},o),z=s.get(\"text-variable-anchor\");if(!z){var C=s.get(\"text-radial-offset\").evaluate(a,{},o);w=C?al(I,[24*C,il]):s.get(\"text-offset\").evaluate(a,{},o).map((function(t){return 24*t}));}var E=d?\"center\":s.get(\"text-justify\").evaluate(a,{},o),P=s.get(\"symbol-placement\"),M=\"point\"===P?24*s.get(\"text-max-width\").evaluate(a,{},o):0,B=function(){t.allowVerticalPlacement&&Zn(_)&&(f.vertical=Su(g,e,r,i,u,M,y,I,\"left\",k,w,wu.vertical,!0,P,c,p));};if(!d&&z){for(var T=\"auto\"===E?z.map((function(t){return ol(t)})):[E],V=!1,F=0;F<T.length;F++){var D=T[F];if(!f.horizontal[D])if(V)f.horizontal[D]=f.horizontal[0];else {var L=Su(g,e,r,i,u,M,y,\"center\",D,k,w,wu.horizontal,!1,P,c,p);L&&(f.horizontal[D]=L,V=1===L.positionedLines.length);}}B();}else {\"auto\"===E&&(E=ol(I));var O=Su(g,e,r,i,u,M,y,I,E,k,w,wu.horizontal,!1,P,c,p);O&&(f.horizontal[E]=O),B(),Zn(_)&&d&&m&&(f.vertical=Su(g,e,r,i,u,M,y,I,E,k,w,wu.vertical,!1,P,c,p));}}var R=void 0,U=!1;if(a.icon&&a.icon.name){var j=n[a.icon.name];j&&(R=function(t,e,r){var n=Bu(r),i=e[0]-t.displaySize[0]*n.horizontalAlign,a=e[1]-t.displaySize[1]*n.verticalAlign;return {image:t,top:a,bottom:a+t.displaySize[1],left:i,right:i+t.displaySize[0]}}(i[a.icon.name],s.get(\"icon-offset\").evaluate(a,{},o),s.get(\"icon-anchor\").evaluate(a,{},o)),U=j.sdf,void 0===t.sdfIcons?t.sdfIcons=j.sdf:t.sdfIcons!==j.sdf&&A(\"Style sheet warning: Cannot mix SDF and non-SDF icons in one buffer\"),(j.pixelRatio!==t.pixelRatio||0!==s.get(\"icon-rotate\").constantOr(1))&&(t.iconsNeedLinear=!0));}var q=ul(f.horizontal)||f.vertical;t.iconsInText=!!q&&q.iconsInText,(q||R)&&function(t,e,r,n,i,a,o,s,u,l,p){var c=a.textMaxSize.evaluate(e,{});void 0===c&&(c=o);var h,f=t.layers[0].layout,y=f.get(\"icon-offset\").evaluate(e,{},p),d=ul(r.horizontal),m=o/24,v=t.tilePixelRatio*m,g=t.tilePixelRatio*c/24,x=t.tilePixelRatio*s,b=t.tilePixelRatio*f.get(\"symbol-spacing\"),w=f.get(\"text-padding\")*t.tilePixelRatio,_=f.get(\"icon-padding\")*t.tilePixelRatio,S=f.get(\"text-max-angle\")/180*Math.PI,k=\"map\"===f.get(\"text-rotation-alignment\")&&\"point\"!==f.get(\"symbol-placement\"),I=\"map\"===f.get(\"icon-rotation-alignment\")&&\"point\"!==f.get(\"symbol-placement\"),z=f.get(\"symbol-placement\"),C=b/2,E=f.get(\"icon-text-fit\");n&&\"none\"!==E&&(t.allowVerticalPlacement&&r.vertical&&(h=Vu(n,r.vertical,E,f.get(\"icon-text-fit-padding\"),y,m)),d&&(n=Vu(n,d,E,f.get(\"icon-text-fit-padding\"),y,m)));var P=function(s,c){c.x<0||c.x>=8192||c.y<0||c.y>=8192||function(t,e,r,n,i,a,o,s,u,l,p,c,h,f,y,d,m,v,g,x,b,w,_,S,k){var I,z,C,E,P,M=t.addToLineVertexArray(e,r),B=0,T=0,V=0,F=0,D=-1,L=-1,O={},R=ha(\"\"),U=0,j=0;if(void 0===s._unevaluatedLayout.getValue(\"text-radial-offset\")?(U=(I=s.layout.get(\"text-offset\").evaluate(b,{},S).map((function(t){return 24*t})))[0],j=I[1]):(U=24*s.layout.get(\"text-radial-offset\").evaluate(b,{},S),j=il),t.allowVerticalPlacement&&n.vertical){var q=s.layout.get(\"text-rotate\").evaluate(b,{},S)+90;E=new Wu(u,e,l,p,c,n.vertical,h,f,y,q),o&&(P=new Wu(u,e,l,p,c,o,m,v,y,q));}if(i){var N=s.layout.get(\"icon-rotate\").evaluate(b,{}),K=\"none\"!==s.layout.get(\"icon-text-fit\"),G=Xu(i,N,_,K),Z=o?Xu(o,N,_,K):void 0;C=new Wu(u,e,l,p,c,i,m,v,!1,N),B=4*G.length;var X=t.iconSizeData,J=null;\"source\"===X.kind?(J=[128*s.layout.get(\"icon-size\").evaluate(b,{})])[0]>32640&&A(t.layerIds[0]+': Value for \"icon-size\" is >= 255. Reduce your \"icon-size\".'):\"composite\"===X.kind&&((J=[128*w.compositeIconSizes[0].evaluate(b,{},S),128*w.compositeIconSizes[1].evaluate(b,{},S)])[0]>32640||J[1]>32640)&&A(t.layerIds[0]+': Value for \"icon-size\" is >= 255. Reduce your \"icon-size\".'),t.addSymbols(t.icon,G,J,x,g,b,!1,e,M.lineStartIndex,M.lineLength,-1,S),D=t.icon.placedSymbolArray.length-1,Z&&(T=4*Z.length,t.addSymbols(t.icon,Z,J,x,g,b,wu.vertical,e,M.lineStartIndex,M.lineLength,-1,S),L=t.icon.placedSymbolArray.length-1);}for(var H in n.horizontal){var Y=n.horizontal[H];if(!z){R=ha(Y.text);var $=s.layout.get(\"text-rotate\").evaluate(b,{},S);z=new Wu(u,e,l,p,c,Y,h,f,y,$);}var W=1===Y.positionedLines.length;if(V+=sl(t,e,Y,a,s,y,b,d,M,n.vertical?wu.horizontal:wu.horizontalOnly,W?Object.keys(n.horizontal):[H],O,D,w,S),W)break}n.vertical&&(F+=sl(t,e,n.vertical,a,s,y,b,d,M,wu.vertical,[\"vertical\"],O,L,w,S));var Q=z?z.boxStartIndex:t.collisionBoxArray.length,tt=z?z.boxEndIndex:t.collisionBoxArray.length,et=E?E.boxStartIndex:t.collisionBoxArray.length,rt=E?E.boxEndIndex:t.collisionBoxArray.length,nt=C?C.boxStartIndex:t.collisionBoxArray.length,it=C?C.boxEndIndex:t.collisionBoxArray.length,at=P?P.boxStartIndex:t.collisionBoxArray.length,ot=P?P.boxEndIndex:t.collisionBoxArray.length,st=-1,ut=function(t,e){return t&&t.circleDiameter?Math.max(t.circleDiameter,e):e};st=ut(z,st),st=ut(E,st),st=ut(C,st);var lt=(st=ut(P,st))>-1?1:0;lt&&(st*=k/24),t.glyphOffsetArray.length>=vl.MAX_GLYPHS&&A(\"Too many glyphs being rendered in a tile. See https://github.com/mapbox/mapbox-gl-js/issues/2907\"),void 0!==b.sortKey&&t.addToSortKeyRanges(t.symbolInstances.length,b.sortKey),t.symbolInstances.emplaceBack(e.x,e.y,O.right>=0?O.right:-1,O.center>=0?O.center:-1,O.left>=0?O.left:-1,O.vertical||-1,D,L,R,Q,tt,et,rt,nt,it,at,ot,l,V,F,B,T,lt,0,h,U,j,st);}(t,c,s,r,n,i,h,t.layers[0],t.collisionBoxArray,e.index,e.sourceLayerIndex,t.index,v,w,k,u,x,_,I,y,e,a,l,p,o);};if(\"line\"===z)for(var M=0,B=Zu(e.geometry,0,0,8192,8192);M<B.length;M+=1)for(var T=B[M],V=0,F=Gu(T,b,S,r.vertical||d,n,24,g,t.overscaling,8192);V<F.length;V+=1){var D=F[V];d&&ll(t,d.text,C,D)||P(T,D);}else if(\"line-center\"===z)for(var L=0,O=e.geometry;L<O.length;L+=1){var R=O[L];if(R.length>1){var U=Ku(R,S,r.vertical||d,n,24,g);U&&P(R,U);}}else if(\"Polygon\"===e.type)for(var j=0,q=ns(e.geometry,0);j<q.length;j+=1){var N=q[j],K=el(N,16);P(N[0],new Fu(K.x,K.y,0));}else if(\"LineString\"===e.type)for(var G=0,Z=e.geometry;G<Z.length;G+=1){var X=Z[G];P(X,new Fu(X[0].x,X[0].y,0));}else if(\"Point\"===e.type)for(var J=0,H=e.geometry;J<H.length;J+=1)for(var Y=0,$=H[J];Y<$.length;Y+=1){var W=$[Y];P([W],new Fu(W.x,W.y,0));}}(t,a,f,R,n,l,c,h,w,U,o);},x=0,b=t.features;x<b.length;x+=1)g();a&&t.generateCollisionDebugBuffers();},t.perspective=function(t,e,r,n,i){var a,o=1/Math.tan(e/2);return t[0]=o/r,t[1]=0,t[2]=0,t[3]=0,t[4]=0,t[5]=o,t[6]=0,t[7]=0,t[8]=0,t[9]=0,t[11]=-1,t[12]=0,t[13]=0,t[15]=0,null!=i&&i!==1/0?(t[10]=(i+n)*(a=1/(n-i)),t[14]=2*i*n*a):(t[10]=-1,t[14]=-2*n),t},t.pick=function(t,e){for(var r={},n=0;n<e.length;n++){var i=e[n];i in t&&(r[i]=t[i]);}return r},t.plugin=oi,t.polygonIntersectsPolygon=Na,t.postMapLoadEvent=ot,t.postTurnstileEvent=it,t.potpack=vu,t.refProperties=[\"type\",\"source\",\"source-layer\",\"minzoom\",\"maxzoom\",\"filter\",\"layout\"],t.register=On,t.registerForPluginStateChange=function(t){return t({pluginStatus:Qn,pluginURL:ti}),ni.on(\"pluginStateChange\",t),t},t.renderColorRamp=wo,t.rotate=function(t,e,r){var n=e[0],i=e[1],a=e[2],o=e[3],s=Math.sin(r),u=Math.cos(r);return t[0]=n*u+a*s,t[1]=i*u+o*s,t[2]=n*-s+a*u,t[3]=i*-s+o*u,t},t.rotateX=function(t,e,r){var n=Math.sin(r),i=Math.cos(r),a=e[4],o=e[5],s=e[6],u=e[7],l=e[8],p=e[9],c=e[10],h=e[11];return e!==t&&(t[0]=e[0],t[1]=e[1],t[2]=e[2],t[3]=e[3],t[12]=e[12],t[13]=e[13],t[14]=e[14],t[15]=e[15]),t[4]=a*i+l*n,t[5]=o*i+p*n,t[6]=s*i+c*n,t[7]=u*i+h*n,t[8]=l*i-a*n,t[9]=p*i-o*n,t[10]=c*i-s*n,t[11]=h*i-u*n,t},t.rotateZ=function(t,e,r){var n=Math.sin(r),i=Math.cos(r),a=e[0],o=e[1],s=e[2],u=e[3],l=e[4],p=e[5],c=e[6],h=e[7];return e!==t&&(t[8]=e[8],t[9]=e[9],t[10]=e[10],t[11]=e[11],t[12]=e[12],t[13]=e[13],t[14]=e[14],t[15]=e[15]),t[0]=a*i+l*n,t[1]=o*i+p*n,t[2]=s*i+c*n,t[3]=u*i+h*n,t[4]=l*i-a*n,t[5]=p*i-o*n,t[6]=c*i-s*n,t[7]=h*i-u*n,t},t.scale=function(t,e,r){var n=r[0],i=r[1],a=r[2];return t[0]=e[0]*n,t[1]=e[1]*n,t[2]=e[2]*n,t[3]=e[3]*n,t[4]=e[4]*i,t[5]=e[5]*i,t[6]=e[6]*i,t[7]=e[7]*i,t[8]=e[8]*a,t[9]=e[9]*a,t[10]=e[10]*a,t[11]=e[11]*a,t[12]=e[12],t[13]=e[13],t[14]=e[14],t[15]=e[15],t},t.scale$1=function(t,e,r){return t[0]=e[0]*r,t[1]=e[1]*r,t[2]=e[2]*r,t[3]=e[3]*r,t},t.scale$2=function(t,e,r){return t[0]=e[0]*r,t[1]=e[1]*r,t[2]=e[2]*r,t},t.setCacheLimits=function(t,e){st=t,ut=e;},t.setRTLTextPlugin=function(t,e,r){if(void 0===r&&(r=!1),\"deferred\"===Qn||\"loading\"===Qn||\"loaded\"===Qn)throw new Error(\"setRTLTextPlugin cannot be called multiple times.\");ti=O.resolveURL(t),Qn=\"deferred\",Wn=e,ri(),r||ai();},t.sphericalToCartesian=function(t){var e=t[0],r=t[1],n=t[2];return r+=90,r*=Math.PI/180,n*=Math.PI/180,{x:e*Math.cos(r)*Math.sin(n),y:e*Math.sin(r)*Math.sin(n),z:e*Math.cos(n)}},t.sqrLen=function(t){var e=t[0],r=t[1];return e*e+r*r},t.styleSpec=Et,t.sub=function(t,e,r){return t[0]=e[0]-r[0],t[1]=e[1]-r[1],t[2]=e[2]-r[2],t},t.symbolSize=Ru,t.transformMat3=function(t,e,r){var n=e[0],i=e[1],a=e[2];return t[0]=n*r[0]+i*r[3]+a*r[6],t[1]=n*r[1]+i*r[4]+a*r[7],t[2]=n*r[2]+i*r[5]+a*r[8],t},t.transformMat4=po,t.translate=function(t,e,r){var n,i,a,o,s,u,l,p,c,h,f,y,d=r[0],m=r[1],v=r[2];return e===t?(t[12]=e[0]*d+e[4]*m+e[8]*v+e[12],t[13]=e[1]*d+e[5]*m+e[9]*v+e[13],t[14]=e[2]*d+e[6]*m+e[10]*v+e[14],t[15]=e[3]*d+e[7]*m+e[11]*v+e[15]):(i=e[1],a=e[2],o=e[3],s=e[4],u=e[5],l=e[6],p=e[7],c=e[8],h=e[9],f=e[10],y=e[11],t[0]=n=e[0],t[1]=i,t[2]=a,t[3]=o,t[4]=s,t[5]=u,t[6]=l,t[7]=p,t[8]=c,t[9]=h,t[10]=f,t[11]=y,t[12]=n*d+s*m+c*v+e[12],t[13]=i*d+u*m+h*v+e[13],t[14]=a*d+l*m+f*v+e[14],t[15]=o*d+p*m+y*v+e[15]),t},t.triggerPluginCompletionEvent=ei,t.uniqueId=y,t.validateCustomStyleLayer=function(t){var e=[],r=t.id;return void 0===r&&e.push({message:\"layers.\"+r+': missing required property \"id\"'}),void 0===t.render&&e.push({message:\"layers.\"+r+': missing required method \"render\"'}),t.renderingMode&&\"2d\"!==t.renderingMode&&\"3d\"!==t.renderingMode&&e.push({message:\"layers.\"+r+': property \"renderingMode\" must be either \"2d\" or \"3d\"'}),e},t.validateLight=En,t.validateStyle=Cn,t.values=function(t){var e=[];for(var r in t)e.push(t[r]);return e},t.vectorTile=bs,t.version=\"1.13.3\",t.warnOnce=A,t.webpSupported=U,t.window=o,t.wrap=c;}));\n\ndefine([\"./shared\"],(function(e){\"use strict\";function t(e){var r=typeof e;if(\"number\"===r||\"boolean\"===r||\"string\"===r||null==e)return JSON.stringify(e);if(Array.isArray(e)){for(var i=\"[\",o=0,n=e;o<n.length;o+=1)i+=t(n[o])+\",\";return i+\"]\"}for(var a=Object.keys(e).sort(),s=\"{\",l=0;l<a.length;l++)s+=JSON.stringify(a[l])+\":\"+t(e[a[l]])+\",\";return s+\"}\"}function r(r){for(var i=\"\",o=0,n=e.refProperties;o<n.length;o+=1)i+=\"/\"+t(r[n[o]]);return i}var i=function(e){this.keyCache={},e&&this.replace(e);};i.prototype.replace=function(e){this._layerConfigs={},this._layers={},this.update(e,[]);},i.prototype.update=function(t,i){for(var o=this,n=0,a=t;n<a.length;n+=1){var s=a[n];this._layerConfigs[s.id]=s;var l=this._layers[s.id]=e.createStyleLayer(s);l._featureFilter=e.featureFilter(l.filter),this.keyCache[s.id]&&delete this.keyCache[s.id];}for(var u=0,h=i;u<h.length;u+=1){var c=h[u];delete this.keyCache[c],delete this._layerConfigs[c],delete this._layers[c];}this.familiesBySource={};for(var p=0,f=function(e,t){for(var i={},o=0;o<e.length;o++){var n=t&&t[e[o].id]||r(e[o]);t&&(t[e[o].id]=n);var a=i[n];a||(a=i[n]=[]),a.push(e[o]);}var s=[];for(var l in i)s.push(i[l]);return s}(e.values(this._layerConfigs),this.keyCache);p<f.length;p+=1){var d=f[p].map((function(e){return o._layers[e.id]})),g=d[0];if(\"none\"!==g.visibility){var v=g.source||\"\",m=this.familiesBySource[v];m||(m=this.familiesBySource[v]={});var y=g.sourceLayer||\"_geojsonTileLayer\",x=m[y];x||(x=m[y]=[]),x.push(d);}}};var o=function(t){var r={},i=[];for(var o in t){var n=t[o],a=r[o]={};for(var s in n){var l=n[+s];if(l&&0!==l.bitmap.width&&0!==l.bitmap.height){var u={x:0,y:0,w:l.bitmap.width+2,h:l.bitmap.height+2};i.push(u),a[s]={rect:u,metrics:l.metrics};}}}var h=e.potpack(i),c=new e.AlphaImage({width:h.w||1,height:h.h||1});for(var p in t){var f=t[p];for(var d in f){var g=f[+d];if(g&&0!==g.bitmap.width&&0!==g.bitmap.height){var v=r[p][d].rect;e.AlphaImage.copy(g.bitmap,c,{x:0,y:0},{x:v.x+1,y:v.y+1},g.bitmap);}}}this.image=c,this.positions=r;};e.register(\"GlyphAtlas\",o);var n=function(t){this.tileID=new e.OverscaledTileID(t.tileID.overscaledZ,t.tileID.wrap,t.tileID.canonical.z,t.tileID.canonical.x,t.tileID.canonical.y),this.uid=t.uid,this.zoom=t.zoom,this.pixelRatio=t.pixelRatio,this.tileSize=t.tileSize,this.source=t.source,this.overscaling=this.tileID.overscaleFactor(),this.showCollisionBoxes=t.showCollisionBoxes,this.collectResourceTiming=!!t.collectResourceTiming,this.returnDependencies=!!t.returnDependencies,this.promoteId=t.promoteId;};function a(t,r,i){for(var o=new e.EvaluationParameters(r),n=0,a=t;n<a.length;n+=1)a[n].recalculate(o,i);}function s(t,r){var i=e.getArrayBuffer(t.request,(function(t,i,o,n){t?r(t):i&&r(null,{vectorTile:new e.vectorTile.VectorTile(new e.pbf(i)),rawData:i,cacheControl:o,expires:n});}));return function(){i.cancel(),r();}}n.prototype.parse=function(t,r,i,n,s){var l=this;this.status=\"parsing\",this.data=t,this.collisionBoxArray=new e.CollisionBoxArray;var u=new e.DictionaryCoder(Object.keys(t.layers).sort()),h=new e.FeatureIndex(this.tileID,this.promoteId);h.bucketLayerIDs=[];var c,p,f,d,g={},v={featureIndex:h,iconDependencies:{},patternDependencies:{},glyphDependencies:{},availableImages:i},m=r.familiesBySource[this.source];for(var y in m){var x=t.layers[y];if(x){1===x.version&&e.warnOnce('Vector tile source \"'+this.source+'\" layer \"'+y+'\" does not use vector tile spec v2 and therefore may have some rendering errors.');for(var w=u.encode(y),S=[],I=0;I<x.length;I++){var M=x.feature(I),b=h.getId(M,y);S.push({feature:M,id:b,index:I,sourceLayerIndex:w});}for(var _=0,k=m[y];_<k.length;_+=1){var P=k[_],T=P[0];T.minzoom&&this.zoom<Math.floor(T.minzoom)||T.maxzoom&&this.zoom>=T.maxzoom||\"none\"!==T.visibility&&(a(P,this.zoom,i),(g[T.id]=T.createBucket({index:h.bucketLayerIDs.length,layers:P,zoom:this.zoom,pixelRatio:this.pixelRatio,overscaling:this.overscaling,collisionBoxArray:this.collisionBoxArray,sourceLayerIndex:w,sourceID:this.source})).populate(S,v,this.tileID.canonical),h.bucketLayerIDs.push(P.map((function(e){return e.id}))));}}}var C=e.mapObject(v.glyphDependencies,(function(e){return Object.keys(e).map(Number)}));Object.keys(C).length?n.send(\"getGlyphs\",{uid:this.uid,stacks:C},(function(e,t){c||(c=e,p=t,z.call(l));})):p={};var D=Object.keys(v.iconDependencies);D.length?n.send(\"getImages\",{icons:D,source:this.source,tileID:this.tileID,type:\"icons\"},(function(e,t){c||(c=e,f=t,z.call(l));})):f={};var L=Object.keys(v.patternDependencies);function z(){if(c)return s(c);if(p&&f&&d){var t=new o(p),r=new e.ImageAtlas(f,d);for(var n in g){var l=g[n];l instanceof e.SymbolBucket?(a(l.layers,this.zoom,i),e.performSymbolLayout(l,p,t.positions,f,r.iconPositions,this.showCollisionBoxes,this.tileID.canonical)):l.hasPattern&&(l instanceof e.LineBucket||l instanceof e.FillBucket||l instanceof e.FillExtrusionBucket)&&(a(l.layers,this.zoom,i),l.addFeatures(v,this.tileID.canonical,r.patternPositions));}this.status=\"done\",s(null,{buckets:e.values(g).filter((function(e){return !e.isEmpty()})),featureIndex:h,collisionBoxArray:this.collisionBoxArray,glyphAtlasImage:t.image,imageAtlas:r,glyphMap:this.returnDependencies?p:null,iconMap:this.returnDependencies?f:null,glyphPositions:this.returnDependencies?t.positions:null});}}L.length?n.send(\"getImages\",{icons:L,source:this.source,tileID:this.tileID,type:\"patterns\"},(function(e,t){c||(c=e,d=t,z.call(l));})):d={},z.call(this);};var l=function(e,t,r,i){this.actor=e,this.layerIndex=t,this.availableImages=r,this.loadVectorData=i||s,this.loading={},this.loaded={};};l.prototype.loadTile=function(t,r){var i=this,o=t.uid;this.loading||(this.loading={});var a=!!(t&&t.request&&t.request.collectResourceTiming)&&new e.RequestPerformance(t.request),s=this.loading[o]=new n(t);s.abort=this.loadVectorData(t,(function(t,n){if(delete i.loading[o],t||!n)return s.status=\"done\",i.loaded[o]=s,r(t);var l=n.rawData,u={};n.expires&&(u.expires=n.expires),n.cacheControl&&(u.cacheControl=n.cacheControl);var h={};if(a){var c=a.finish();c&&(h.resourceTiming=JSON.parse(JSON.stringify(c)));}s.vectorTile=n.vectorTile,s.parse(n.vectorTile,i.layerIndex,i.availableImages,i.actor,(function(t,i){if(t||!i)return r(t);r(null,e.extend({rawTileData:l.slice(0)},i,u,h));})),i.loaded=i.loaded||{},i.loaded[o]=s;}));},l.prototype.reloadTile=function(e,t){var r=this,i=this.loaded,o=e.uid,n=this;if(i&&i[o]){var a=i[o];a.showCollisionBoxes=e.showCollisionBoxes;var s=function(e,i){var o=a.reloadCallback;o&&(delete a.reloadCallback,a.parse(a.vectorTile,n.layerIndex,r.availableImages,n.actor,o)),t(e,i);};\"parsing\"===a.status?a.reloadCallback=s:\"done\"===a.status&&(a.vectorTile?a.parse(a.vectorTile,this.layerIndex,this.availableImages,this.actor,s):s());}},l.prototype.abortTile=function(e,t){var r=this.loading,i=e.uid;r&&r[i]&&r[i].abort&&(r[i].abort(),delete r[i]),t();},l.prototype.removeTile=function(e,t){var r=this.loaded,i=e.uid;r&&r[i]&&delete r[i],t();};var u=e.window.ImageBitmap,h=function(){this.loaded={};};function c(e,t){if(0!==e.length){p(e[0],t);for(var r=1;r<e.length;r++)p(e[r],!t);}}function p(e,t){for(var r=0,i=0,o=0,n=e.length,a=n-1;o<n;a=o++){var s=(e[o][0]-e[a][0])*(e[a][1]+e[o][1]),l=r+s;i+=Math.abs(r)>=Math.abs(s)?r-l+s:s-l+r,r=l;}r+i>=0!=!!t&&e.reverse();}h.prototype.loadTile=function(t,r){var i=t.uid,o=t.encoding,n=t.rawImageData,a=u&&n instanceof u?this.getImageData(n):n,s=new e.DEMData(i,a,o);this.loaded=this.loaded||{},this.loaded[i]=s,r(null,s);},h.prototype.getImageData=function(t){this.offscreenCanvas&&this.offscreenCanvasContext||(this.offscreenCanvas=new OffscreenCanvas(t.width,t.height),this.offscreenCanvasContext=this.offscreenCanvas.getContext(\"2d\")),this.offscreenCanvas.width=t.width,this.offscreenCanvas.height=t.height,this.offscreenCanvasContext.drawImage(t,0,0,t.width,t.height);var r=this.offscreenCanvasContext.getImageData(-1,-1,t.width+2,t.height+2);return this.offscreenCanvasContext.clearRect(0,0,this.offscreenCanvas.width,this.offscreenCanvas.height),new e.RGBAImage({width:r.width,height:r.height},r.data)},h.prototype.removeTile=function(e){var t=this.loaded,r=e.uid;t&&t[r]&&delete t[r];};var f=e.vectorTile.VectorTileFeature.prototype.toGeoJSON,d=function(t){this._feature=t,this.extent=e.EXTENT,this.type=t.type,this.properties=t.tags,\"id\"in t&&!isNaN(t.id)&&(this.id=parseInt(t.id,10));};d.prototype.loadGeometry=function(){if(1===this._feature.type){for(var t=[],r=0,i=this._feature.geometry;r<i.length;r+=1){var o=i[r];t.push([new e.Point$1(o[0],o[1])]);}return t}for(var n=[],a=0,s=this._feature.geometry;a<s.length;a+=1){for(var l=[],u=0,h=s[a];u<h.length;u+=1){var c=h[u];l.push(new e.Point$1(c[0],c[1]));}n.push(l);}return n},d.prototype.toGeoJSON=function(e,t,r){return f.call(this,e,t,r)};var g=function(t){this.layers={_geojsonTileLayer:this},this.name=\"_geojsonTileLayer\",this.extent=e.EXTENT,this.length=t.length,this._features=t;};g.prototype.feature=function(e){return new d(this._features[e])};var v=e.vectorTile.VectorTileFeature,m=y;function y(e,t){this.options=t||{},this.features=e,this.length=e.length;}function x(e,t){this.id=\"number\"==typeof e.id?e.id:void 0,this.type=e.type,this.rawGeometry=1===e.type?[e.geometry]:e.geometry,this.properties=e.tags,this.extent=t||4096;}y.prototype.feature=function(e){return new x(this.features[e],this.options.extent)},x.prototype.loadGeometry=function(){var t=this.rawGeometry;this.geometry=[];for(var r=0;r<t.length;r++){for(var i=t[r],o=[],n=0;n<i.length;n++)o.push(new e.Point$1(i[n][0],i[n][1]));this.geometry.push(o);}return this.geometry},x.prototype.bbox=function(){this.geometry||this.loadGeometry();for(var e=this.geometry,t=1/0,r=-1/0,i=1/0,o=-1/0,n=0;n<e.length;n++)for(var a=e[n],s=0;s<a.length;s++){var l=a[s];t=Math.min(t,l.x),r=Math.max(r,l.x),i=Math.min(i,l.y),o=Math.max(o,l.y);}return [t,i,r,o]},x.prototype.toGeoJSON=v.prototype.toGeoJSON;var w=I,S=m;function I(t){var r=new e.pbf;return function(e,t){for(var r in e.layers)t.writeMessage(3,M,e.layers[r]);}(t,r),r.finish()}function M(e,t){var r;t.writeVarintField(15,e.version||1),t.writeStringField(1,e.name||\"\"),t.writeVarintField(5,e.extent||4096);var i={keys:[],values:[],keycache:{},valuecache:{}};for(r=0;r<e.length;r++)i.feature=e.feature(r),t.writeMessage(2,b,i);var o=i.keys;for(r=0;r<o.length;r++)t.writeStringField(3,o[r]);var n=i.values;for(r=0;r<n.length;r++)t.writeMessage(4,C,n[r]);}function b(e,t){var r=e.feature;void 0!==r.id&&t.writeVarintField(1,r.id),t.writeMessage(2,_,e),t.writeVarintField(3,r.type),t.writeMessage(4,T,r);}function _(e,t){var r=e.feature,i=e.keys,o=e.values,n=e.keycache,a=e.valuecache;for(var s in r.properties){var l=n[s];void 0===l&&(i.push(s),n[s]=l=i.length-1),t.writeVarint(l);var u=r.properties[s],h=typeof u;\"string\"!==h&&\"boolean\"!==h&&\"number\"!==h&&(u=JSON.stringify(u));var c=h+\":\"+u,p=a[c];void 0===p&&(o.push(u),a[c]=p=o.length-1),t.writeVarint(p);}}function k(e,t){return (t<<3)+(7&e)}function P(e){return e<<1^e>>31}function T(e,t){for(var r=e.loadGeometry(),i=e.type,o=0,n=0,a=r.length,s=0;s<a;s++){var l=r[s],u=1;1===i&&(u=l.length),t.writeVarint(k(1,u));for(var h=3===i?l.length-1:l.length,c=0;c<h;c++){1===c&&1!==i&&t.writeVarint(k(2,h-1));var p=l[c].x-o,f=l[c].y-n;t.writeVarint(P(p)),t.writeVarint(P(f)),o+=p,n+=f;}3===i&&t.writeVarint(k(7,1));}}function C(e,t){var r=typeof e;\"string\"===r?t.writeStringField(1,e):\"boolean\"===r?t.writeBooleanField(7,e):\"number\"===r&&(e%1!=0?t.writeDoubleField(3,e):e<0?t.writeSVarintField(6,e):t.writeVarintField(5,e));}function D(e,t,r,i){L(e,r,i),L(t,2*r,2*i),L(t,2*r+1,2*i+1);}function L(e,t,r){var i=e[t];e[t]=e[r],e[r]=i;}function z(e,t,r,i){var o=e-r,n=t-i;return o*o+n*n}w.fromVectorTileJs=I,w.fromGeojsonVt=function(e,t){t=t||{};var r={};for(var i in e)r[i]=new m(e[i].features,t),r[i].name=i,r[i].version=t.version,r[i].extent=t.extent;return I({layers:r})},w.GeoJSONWrapper=S;var O=function(e){return e[0]},E=function(e){return e[1]},F=function(e,t,r,i,o){void 0===t&&(t=O),void 0===r&&(r=E),void 0===i&&(i=64),void 0===o&&(o=Float64Array),this.nodeSize=i,this.points=e;for(var n=e.length<65536?Uint16Array:Uint32Array,a=this.ids=new n(e.length),s=this.coords=new o(2*e.length),l=0;l<e.length;l++)a[l]=l,s[2*l]=t(e[l]),s[2*l+1]=r(e[l]);!function e(t,r,i,o,n,a){if(!(n-o<=i)){var s=o+n>>1;!function e(t,r,i,o,n,a){for(;n>o;){if(n-o>600){var s=n-o+1,l=i-o+1,u=Math.log(s),h=.5*Math.exp(2*u/3),c=.5*Math.sqrt(u*h*(s-h)/s)*(l-s/2<0?-1:1);e(t,r,i,Math.max(o,Math.floor(i-l*h/s+c)),Math.min(n,Math.floor(i+(s-l)*h/s+c)),a);}var p=r[2*i+a],f=o,d=n;for(D(t,r,o,i),r[2*n+a]>p&&D(t,r,o,n);f<d;){for(D(t,r,f,d),f++,d--;r[2*f+a]<p;)f++;for(;r[2*d+a]>p;)d--;}r[2*o+a]===p?D(t,r,o,d):D(t,r,++d,n),d<=i&&(o=d+1),i<=d&&(n=d-1);}}(t,r,s,o,n,a%2),e(t,r,i,o,s-1,a+1),e(t,r,i,s+1,n,a+1);}}(a,s,i,0,a.length-1,0);};F.prototype.range=function(e,t,r,i){return function(e,t,r,i,o,n,a){for(var s,l,u=[0,e.length-1,0],h=[];u.length;){var c=u.pop(),p=u.pop(),f=u.pop();if(p-f<=a)for(var d=f;d<=p;d++)l=t[2*d+1],(s=t[2*d])>=r&&s<=o&&l>=i&&l<=n&&h.push(e[d]);else {var g=Math.floor((f+p)/2);l=t[2*g+1],(s=t[2*g])>=r&&s<=o&&l>=i&&l<=n&&h.push(e[g]);var v=(c+1)%2;(0===c?r<=s:i<=l)&&(u.push(f),u.push(g-1),u.push(v)),(0===c?o>=s:n>=l)&&(u.push(g+1),u.push(p),u.push(v));}}return h}(this.ids,this.coords,e,t,r,i,this.nodeSize)},F.prototype.within=function(e,t,r){return function(e,t,r,i,o,n){for(var a=[0,e.length-1,0],s=[],l=o*o;a.length;){var u=a.pop(),h=a.pop(),c=a.pop();if(h-c<=n)for(var p=c;p<=h;p++)z(t[2*p],t[2*p+1],r,i)<=l&&s.push(e[p]);else {var f=Math.floor((c+h)/2),d=t[2*f],g=t[2*f+1];z(d,g,r,i)<=l&&s.push(e[f]);var v=(u+1)%2;(0===u?r-o<=d:i-o<=g)&&(a.push(c),a.push(f-1),a.push(v)),(0===u?r+o>=d:i+o>=g)&&(a.push(f+1),a.push(h),a.push(v));}}return s}(this.ids,this.coords,e,t,r,this.nodeSize)};var N={minZoom:0,maxZoom:16,minPoints:2,radius:40,extent:512,nodeSize:64,log:!1,generateId:!1,reduce:null,map:function(e){return e}},J=function(e){this.options=V(Object.create(N),e),this.trees=new Array(this.options.maxZoom+1);};function Z(e,t,r,i,o){return {x:e,y:t,zoom:1/0,id:r,parentId:-1,numPoints:i,properties:o}}function A(e,t){var r=e.geometry.coordinates,i=r[1];return {x:Y(r[0]),y:j(i),zoom:1/0,index:t,parentId:-1}}function B(e){return {type:\"Feature\",id:e.id,properties:G(e),geometry:{type:\"Point\",coordinates:[(i=e.x,360*(i-.5)),(t=e.y,r=(180-360*t)*Math.PI/180,360*Math.atan(Math.exp(r))/Math.PI-90)]}};var t,r,i;}function G(e){var t=e.numPoints,r=t>=1e4?Math.round(t/1e3)+\"k\":t>=1e3?Math.round(t/100)/10+\"k\":t;return V(V({},e.properties),{cluster:!0,cluster_id:e.id,point_count:t,point_count_abbreviated:r})}function Y(e){return e/360+.5}function j(e){var t=Math.sin(e*Math.PI/180),r=.5-.25*Math.log((1+t)/(1-t))/Math.PI;return r<0?0:r>1?1:r}function V(e,t){for(var r in t)e[r]=t[r];return e}function X(e){return e.x}function W(e){return e.y}function R(e,t,r,i,o,n){var a=o-r,s=n-i;if(0!==a||0!==s){var l=((e-r)*a+(t-i)*s)/(a*a+s*s);l>1?(r=o,i=n):l>0&&(r+=a*l,i+=s*l);}return (a=e-r)*a+(s=t-i)*s}function q(e,t,r,i){var o={id:void 0===e?null:e,type:t,geometry:r,tags:i,minX:1/0,minY:1/0,maxX:-1/0,maxY:-1/0};return function(e){var t=e.geometry,r=e.type;if(\"Point\"===r||\"MultiPoint\"===r||\"LineString\"===r)U(e,t);else if(\"Polygon\"===r||\"MultiLineString\"===r)for(var i=0;i<t.length;i++)U(e,t[i]);else if(\"MultiPolygon\"===r)for(i=0;i<t.length;i++)for(var o=0;o<t[i].length;o++)U(e,t[i][o]);}(o),o}function U(e,t){for(var r=0;r<t.length;r+=3)e.minX=Math.min(e.minX,t[r]),e.minY=Math.min(e.minY,t[r+1]),e.maxX=Math.max(e.maxX,t[r]),e.maxY=Math.max(e.maxY,t[r+1]);}function $(e,t,r,i){if(t.geometry){var o=t.geometry.coordinates,n=t.geometry.type,a=Math.pow(r.tolerance/((1<<r.maxZoom)*r.extent),2),s=[],l=t.id;if(r.promoteId?l=t.properties[r.promoteId]:r.generateId&&(l=i||0),\"Point\"===n)H(o,s);else if(\"MultiPoint\"===n)for(var u=0;u<o.length;u++)H(o[u],s);else if(\"LineString\"===n)K(o,s,a,!1);else if(\"MultiLineString\"===n){if(r.lineMetrics){for(u=0;u<o.length;u++)K(o[u],s=[],a,!1),e.push(q(l,\"LineString\",s,t.properties));return}Q(o,s,a,!1);}else if(\"Polygon\"===n)Q(o,s,a,!0);else {if(\"MultiPolygon\"!==n){if(\"GeometryCollection\"===n){for(u=0;u<t.geometry.geometries.length;u++)$(e,{id:l,geometry:t.geometry.geometries[u],properties:t.properties},r,i);return}throw new Error(\"Input data is not a valid GeoJSON object.\")}for(u=0;u<o.length;u++){var h=[];Q(o[u],h,a,!0),s.push(h);}}e.push(q(l,n,s,t.properties));}}function H(e,t){t.push(ee(e[0])),t.push(te(e[1])),t.push(0);}function K(e,t,r,i){for(var o,n,a=0,s=0;s<e.length;s++){var l=ee(e[s][0]),u=te(e[s][1]);t.push(l),t.push(u),t.push(0),s>0&&(a+=i?(o*u-l*n)/2:Math.sqrt(Math.pow(l-o,2)+Math.pow(u-n,2))),o=l,n=u;}var h=t.length-3;t[2]=1,function e(t,r,i,o){for(var n,a=o,s=i-r>>1,l=i-r,u=t[r],h=t[r+1],c=t[i],p=t[i+1],f=r+3;f<i;f+=3){var d=R(t[f],t[f+1],u,h,c,p);if(d>a)n=f,a=d;else if(d===a){var g=Math.abs(f-s);g<l&&(n=f,l=g);}}a>o&&(n-r>3&&e(t,r,n,o),t[n+2]=a,i-n>3&&e(t,n,i,o));}(t,0,h,r),t[h+2]=1,t.size=Math.abs(a),t.start=0,t.end=t.size;}function Q(e,t,r,i){for(var o=0;o<e.length;o++){var n=[];K(e[o],n,r,i),t.push(n);}}function ee(e){return e/360+.5}function te(e){var t=Math.sin(e*Math.PI/180),r=.5-.25*Math.log((1+t)/(1-t))/Math.PI;return r<0?0:r>1?1:r}function re(e,t,r,i,o,n,a,s){if(i/=t,n>=(r/=t)&&a<i)return e;if(a<r||n>=i)return null;for(var l=[],u=0;u<e.length;u++){var h=e[u],c=h.geometry,p=h.type,f=0===o?h.minX:h.minY,d=0===o?h.maxX:h.maxY;if(f>=r&&d<i)l.push(h);else if(!(d<r||f>=i)){var g=[];if(\"Point\"===p||\"MultiPoint\"===p)ie(c,g,r,i,o);else if(\"LineString\"===p)oe(c,g,r,i,o,!1,s.lineMetrics);else if(\"MultiLineString\"===p)ae(c,g,r,i,o,!1);else if(\"Polygon\"===p)ae(c,g,r,i,o,!0);else if(\"MultiPolygon\"===p)for(var v=0;v<c.length;v++){var m=[];ae(c[v],m,r,i,o,!0),m.length&&g.push(m);}if(g.length){if(s.lineMetrics&&\"LineString\"===p){for(v=0;v<g.length;v++)l.push(q(h.id,p,g[v],h.tags));continue}\"LineString\"!==p&&\"MultiLineString\"!==p||(1===g.length?(p=\"LineString\",g=g[0]):p=\"MultiLineString\"),\"Point\"!==p&&\"MultiPoint\"!==p||(p=3===g.length?\"Point\":\"MultiPoint\"),l.push(q(h.id,p,g,h.tags));}}}return l.length?l:null}function ie(e,t,r,i,o){for(var n=0;n<e.length;n+=3){var a=e[n+o];a>=r&&a<=i&&(t.push(e[n]),t.push(e[n+1]),t.push(e[n+2]));}}function oe(e,t,r,i,o,n,a){for(var s,l,u=ne(e),h=0===o?le:ue,c=e.start,p=0;p<e.length-3;p+=3){var f=e[p],d=e[p+1],g=e[p+2],v=e[p+3],m=e[p+4],y=0===o?f:d,x=0===o?v:m,w=!1;a&&(s=Math.sqrt(Math.pow(f-v,2)+Math.pow(d-m,2))),y<r?x>r&&(l=h(u,f,d,v,m,r),a&&(u.start=c+s*l)):y>i?x<i&&(l=h(u,f,d,v,m,i),a&&(u.start=c+s*l)):se(u,f,d,g),x<r&&y>=r&&(l=h(u,f,d,v,m,r),w=!0),x>i&&y<=i&&(l=h(u,f,d,v,m,i),w=!0),!n&&w&&(a&&(u.end=c+s*l),t.push(u),u=ne(e)),a&&(c+=s);}var S=e.length-3;f=e[S],d=e[S+1],g=e[S+2],(y=0===o?f:d)>=r&&y<=i&&se(u,f,d,g),S=u.length-3,n&&S>=3&&(u[S]!==u[0]||u[S+1]!==u[1])&&se(u,u[0],u[1],u[2]),u.length&&t.push(u);}function ne(e){var t=[];return t.size=e.size,t.start=e.start,t.end=e.end,t}function ae(e,t,r,i,o,n){for(var a=0;a<e.length;a++)oe(e[a],t,r,i,o,n,!1);}function se(e,t,r,i){e.push(t),e.push(r),e.push(i);}function le(e,t,r,i,o,n){var a=(n-t)/(i-t);return e.push(n),e.push(r+(o-r)*a),e.push(1),a}function ue(e,t,r,i,o,n){var a=(n-r)/(o-r);return e.push(t+(i-t)*a),e.push(n),e.push(1),a}function he(e,t){for(var r=[],i=0;i<e.length;i++){var o,n=e[i],a=n.type;if(\"Point\"===a||\"MultiPoint\"===a||\"LineString\"===a)o=ce(n.geometry,t);else if(\"MultiLineString\"===a||\"Polygon\"===a){o=[];for(var s=0;s<n.geometry.length;s++)o.push(ce(n.geometry[s],t));}else if(\"MultiPolygon\"===a)for(o=[],s=0;s<n.geometry.length;s++){for(var l=[],u=0;u<n.geometry[s].length;u++)l.push(ce(n.geometry[s][u],t));o.push(l);}r.push(q(n.id,a,o,n.tags));}return r}function ce(e,t){var r=[];r.size=e.size,void 0!==e.start&&(r.start=e.start,r.end=e.end);for(var i=0;i<e.length;i+=3)r.push(e[i]+t,e[i+1],e[i+2]);return r}function pe(e,t){if(e.transformed)return e;var r,i,o,n=1<<e.z,a=e.x,s=e.y;for(r=0;r<e.features.length;r++){var l=e.features[r],u=l.geometry,h=l.type;if(l.geometry=[],1===h)for(i=0;i<u.length;i+=2)l.geometry.push(fe(u[i],u[i+1],t,n,a,s));else for(i=0;i<u.length;i++){var c=[];for(o=0;o<u[i].length;o+=2)c.push(fe(u[i][o],u[i][o+1],t,n,a,s));l.geometry.push(c);}}return e.transformed=!0,e}function fe(e,t,r,i,o,n){return [Math.round(r*(e*i-o)),Math.round(r*(t*i-n))]}function de(e,t,r,i,o){for(var n=t===o.maxZoom?0:o.tolerance/((1<<t)*o.extent),a={features:[],numPoints:0,numSimplified:0,numFeatures:0,source:null,x:r,y:i,z:t,transformed:!1,minX:2,minY:1,maxX:-1,maxY:0},s=0;s<e.length;s++){a.numFeatures++,ge(a,e[s],n,o);var l=e[s].minX,u=e[s].minY,h=e[s].maxX,c=e[s].maxY;l<a.minX&&(a.minX=l),u<a.minY&&(a.minY=u),h>a.maxX&&(a.maxX=h),c>a.maxY&&(a.maxY=c);}return a}function ge(e,t,r,i){var o=t.geometry,n=t.type,a=[];if(\"Point\"===n||\"MultiPoint\"===n)for(var s=0;s<o.length;s+=3)a.push(o[s]),a.push(o[s+1]),e.numPoints++,e.numSimplified++;else if(\"LineString\"===n)ve(a,o,e,r,!1,!1);else if(\"MultiLineString\"===n||\"Polygon\"===n)for(s=0;s<o.length;s++)ve(a,o[s],e,r,\"Polygon\"===n,0===s);else if(\"MultiPolygon\"===n)for(var l=0;l<o.length;l++){var u=o[l];for(s=0;s<u.length;s++)ve(a,u[s],e,r,!0,0===s);}if(a.length){var h=t.tags||null;if(\"LineString\"===n&&i.lineMetrics){for(var c in h={},t.tags)h[c]=t.tags[c];h.mapbox_clip_start=o.start/o.size,h.mapbox_clip_end=o.end/o.size;}var p={geometry:a,type:\"Polygon\"===n||\"MultiPolygon\"===n?3:\"LineString\"===n||\"MultiLineString\"===n?2:1,tags:h};null!==t.id&&(p.id=t.id),e.features.push(p);}}function ve(e,t,r,i,o,n){var a=i*i;if(i>0&&t.size<(o?a:i))r.numPoints+=t.length/3;else {for(var s=[],l=0;l<t.length;l+=3)(0===i||t[l+2]>a)&&(r.numSimplified++,s.push(t[l]),s.push(t[l+1])),r.numPoints++;o&&function(e,t){for(var r=0,i=0,o=e.length,n=o-2;i<o;n=i,i+=2)r+=(e[i]-e[n])*(e[i+1]+e[n+1]);if(r>0===t)for(i=0,o=e.length;i<o/2;i+=2){var a=e[i],s=e[i+1];e[i]=e[o-2-i],e[i+1]=e[o-1-i],e[o-2-i]=a,e[o-1-i]=s;}}(s,n),e.push(s);}}function me(e,t){var r=(t=this.options=function(e,t){for(var r in t)e[r]=t[r];return e}(Object.create(this.options),t)).debug;if(r&&console.time(\"preprocess data\"),t.maxZoom<0||t.maxZoom>24)throw new Error(\"maxZoom should be in the 0-24 range\");if(t.promoteId&&t.generateId)throw new Error(\"promoteId and generateId cannot be used together.\");var i=function(e,t){var r=[];if(\"FeatureCollection\"===e.type)for(var i=0;i<e.features.length;i++)$(r,e.features[i],t,i);else $(r,\"Feature\"===e.type?e:{geometry:e},t);return r}(e,t);this.tiles={},this.tileCoords=[],r&&(console.timeEnd(\"preprocess data\"),console.log(\"index: maxZoom: %d, maxPoints: %d\",t.indexMaxZoom,t.indexMaxPoints),console.time(\"generate tiles\"),this.stats={},this.total=0),(i=function(e,t){var r=t.buffer/t.extent,i=e,o=re(e,1,-1-r,r,0,-1,2,t),n=re(e,1,1-r,2+r,0,-1,2,t);return (o||n)&&(i=re(e,1,-r,1+r,0,-1,2,t)||[],o&&(i=he(o,1).concat(i)),n&&(i=i.concat(he(n,-1)))),i}(i,t)).length&&this.splitTile(i,0,0,0),r&&(i.length&&console.log(\"features: %d, points: %d\",this.tiles[0].numFeatures,this.tiles[0].numPoints),console.timeEnd(\"generate tiles\"),console.log(\"tiles generated:\",this.total,JSON.stringify(this.stats)));}function ye(e,t,r){return 32*((1<<e)*r+t)+e}function xe(e,t){var r=e.tileID.canonical;if(!this._geoJSONIndex)return t(null,null);var i=this._geoJSONIndex.getTile(r.z,r.x,r.y);if(!i)return t(null,null);var o=new g(i.features),n=w(o);0===n.byteOffset&&n.byteLength===n.buffer.byteLength||(n=new Uint8Array(n)),t(null,{vectorTile:o,rawData:n.buffer});}J.prototype.load=function(e){var t=this.options,r=t.log,i=t.minZoom,o=t.maxZoom,n=t.nodeSize;r&&console.time(\"total time\");var a=\"prepare \"+e.length+\" points\";r&&console.time(a),this.points=e;for(var s=[],l=0;l<e.length;l++)e[l].geometry&&s.push(A(e[l],l));this.trees[o+1]=new F(s,X,W,n,Float32Array),r&&console.timeEnd(a);for(var u=o;u>=i;u--){var h=+Date.now();s=this._cluster(s,u),this.trees[u]=new F(s,X,W,n,Float32Array),r&&console.log(\"z%d: %d clusters in %dms\",u,s.length,+Date.now()-h);}return r&&console.timeEnd(\"total time\"),this},J.prototype.getClusters=function(e,t){var r=((e[0]+180)%360+360)%360-180,i=Math.max(-90,Math.min(90,e[1])),o=180===e[2]?180:((e[2]+180)%360+360)%360-180,n=Math.max(-90,Math.min(90,e[3]));if(e[2]-e[0]>=360)r=-180,o=180;else if(r>o){var a=this.getClusters([r,i,180,n],t),s=this.getClusters([-180,i,o,n],t);return a.concat(s)}for(var l=this.trees[this._limitZoom(t)],u=[],h=0,c=l.range(Y(r),j(n),Y(o),j(i));h<c.length;h+=1){var p=l.points[c[h]];u.push(p.numPoints?B(p):this.points[p.index]);}return u},J.prototype.getChildren=function(e){var t=this._getOriginId(e),r=this._getOriginZoom(e),i=\"No cluster with the specified id.\",o=this.trees[r];if(!o)throw new Error(i);var n=o.points[t];if(!n)throw new Error(i);for(var a=this.options.radius/(this.options.extent*Math.pow(2,r-1)),s=[],l=0,u=o.within(n.x,n.y,a);l<u.length;l+=1){var h=o.points[u[l]];h.parentId===e&&s.push(h.numPoints?B(h):this.points[h.index]);}if(0===s.length)throw new Error(i);return s},J.prototype.getLeaves=function(e,t,r){var i=[];return this._appendLeaves(i,e,t=t||10,r=r||0,0),i},J.prototype.getTile=function(e,t,r){var i=this.trees[this._limitZoom(e)],o=Math.pow(2,e),n=this.options,a=n.radius/n.extent,s=(r-a)/o,l=(r+1+a)/o,u={features:[]};return this._addTileFeatures(i.range((t-a)/o,s,(t+1+a)/o,l),i.points,t,r,o,u),0===t&&this._addTileFeatures(i.range(1-a/o,s,1,l),i.points,o,r,o,u),t===o-1&&this._addTileFeatures(i.range(0,s,a/o,l),i.points,-1,r,o,u),u.features.length?u:null},J.prototype.getClusterExpansionZoom=function(e){for(var t=this._getOriginZoom(e)-1;t<=this.options.maxZoom;){var r=this.getChildren(e);if(t++,1!==r.length)break;e=r[0].properties.cluster_id;}return t},J.prototype._appendLeaves=function(e,t,r,i,o){for(var n=0,a=this.getChildren(t);n<a.length;n+=1){var s=a[n],l=s.properties;if(l&&l.cluster?o+l.point_count<=i?o+=l.point_count:o=this._appendLeaves(e,l.cluster_id,r,i,o):o<i?o++:e.push(s),e.length===r)break}return o},J.prototype._addTileFeatures=function(e,t,r,i,o,n){for(var a=0,s=e;a<s.length;a+=1){var l=t[s[a]],u=l.numPoints,h={type:1,geometry:[[Math.round(this.options.extent*(l.x*o-r)),Math.round(this.options.extent*(l.y*o-i))]],tags:u?G(l):this.points[l.index].properties},c=void 0;u?c=l.id:this.options.generateId?c=l.index:this.points[l.index].id&&(c=this.points[l.index].id),void 0!==c&&(h.id=c),n.features.push(h);}},J.prototype._limitZoom=function(e){return Math.max(this.options.minZoom,Math.min(+e,this.options.maxZoom+1))},J.prototype._cluster=function(e,t){for(var r=[],i=this.options,o=i.reduce,n=i.minPoints,a=i.radius/(i.extent*Math.pow(2,t)),s=0;s<e.length;s++){var l=e[s];if(!(l.zoom<=t)){l.zoom=t;for(var u=this.trees[t+1],h=u.within(l.x,l.y,a),c=l.numPoints||1,p=c,f=0,d=h;f<d.length;f+=1){var g=u.points[d[f]];g.zoom>t&&(p+=g.numPoints||1);}if(p>=n){for(var v=l.x*c,m=l.y*c,y=o&&c>1?this._map(l,!0):null,x=(s<<5)+(t+1)+this.points.length,w=0,S=h;w<S.length;w+=1){var I=u.points[S[w]];if(!(I.zoom<=t)){I.zoom=t;var M=I.numPoints||1;v+=I.x*M,m+=I.y*M,I.parentId=x,o&&(y||(y=this._map(l,!0)),o(y,this._map(I)));}}l.parentId=x,r.push(Z(v/p,m/p,x,p,y));}else if(r.push(l),p>1)for(var b=0,_=h;b<_.length;b+=1){var k=u.points[_[b]];k.zoom<=t||(k.zoom=t,r.push(k));}}}return r},J.prototype._getOriginId=function(e){return e-this.points.length>>5},J.prototype._getOriginZoom=function(e){return (e-this.points.length)%32},J.prototype._map=function(e,t){if(e.numPoints)return t?V({},e.properties):e.properties;var r=this.points[e.index].properties,i=this.options.map(r);return t&&i===r?V({},i):i},me.prototype.options={maxZoom:14,indexMaxZoom:5,indexMaxPoints:1e5,tolerance:3,extent:4096,buffer:64,lineMetrics:!1,promoteId:null,generateId:!1,debug:0},me.prototype.splitTile=function(e,t,r,i,o,n,a){for(var s=[e,t,r,i],l=this.options,u=l.debug;s.length;){i=s.pop(),r=s.pop(),t=s.pop(),e=s.pop();var h=1<<t,c=ye(t,r,i),p=this.tiles[c];if(!p&&(u>1&&console.time(\"creation\"),p=this.tiles[c]=de(e,t,r,i,l),this.tileCoords.push({z:t,x:r,y:i}),u)){u>1&&(console.log(\"tile z%d-%d-%d (features: %d, points: %d, simplified: %d)\",t,r,i,p.numFeatures,p.numPoints,p.numSimplified),console.timeEnd(\"creation\"));var f=\"z\"+t;this.stats[f]=(this.stats[f]||0)+1,this.total++;}if(p.source=e,o){if(t===l.maxZoom||t===o)continue;var d=1<<o-t;if(r!==Math.floor(n/d)||i!==Math.floor(a/d))continue}else if(t===l.indexMaxZoom||p.numPoints<=l.indexMaxPoints)continue;if(p.source=null,0!==e.length){u>1&&console.time(\"clipping\");var g,v,m,y,x,w,S=.5*l.buffer/l.extent,I=.5-S,M=.5+S,b=1+S;g=v=m=y=null,x=re(e,h,r-S,r+M,0,p.minX,p.maxX,l),w=re(e,h,r+I,r+b,0,p.minX,p.maxX,l),e=null,x&&(g=re(x,h,i-S,i+M,1,p.minY,p.maxY,l),v=re(x,h,i+I,i+b,1,p.minY,p.maxY,l),x=null),w&&(m=re(w,h,i-S,i+M,1,p.minY,p.maxY,l),y=re(w,h,i+I,i+b,1,p.minY,p.maxY,l),w=null),u>1&&console.timeEnd(\"clipping\"),s.push(g||[],t+1,2*r,2*i),s.push(v||[],t+1,2*r,2*i+1),s.push(m||[],t+1,2*r+1,2*i),s.push(y||[],t+1,2*r+1,2*i+1);}}},me.prototype.getTile=function(e,t,r){var i=this.options,o=i.extent,n=i.debug;if(e<0||e>24)return null;var a=1<<e,s=ye(e,t=(t%a+a)%a,r);if(this.tiles[s])return pe(this.tiles[s],o);n>1&&console.log(\"drilling down to z%d-%d-%d\",e,t,r);for(var l,u=e,h=t,c=r;!l&&u>0;)u--,h=Math.floor(h/2),c=Math.floor(c/2),l=this.tiles[ye(u,h,c)];return l&&l.source?(n>1&&console.log(\"found parent tile z%d-%d-%d\",u,h,c),n>1&&console.time(\"drilling down\"),this.splitTile(l.source,u,h,c,e,t,r),n>1&&console.timeEnd(\"drilling down\"),this.tiles[s]?pe(this.tiles[s],o):null):null};var we=function(t){function r(e,r,i,o){t.call(this,e,r,i,xe),o&&(this.loadGeoJSON=o);}return t&&(r.__proto__=t),(r.prototype=Object.create(t&&t.prototype)).constructor=r,r.prototype.loadData=function(e,t){this._pendingCallback&&this._pendingCallback(null,{abandoned:!0}),this._pendingCallback=t,this._pendingLoadDataParams=e,this._state&&\"Idle\"!==this._state?this._state=\"NeedsLoadData\":(this._state=\"Coalescing\",this._loadData());},r.prototype._loadData=function(){var t=this;if(this._pendingCallback&&this._pendingLoadDataParams){var r=this._pendingCallback,i=this._pendingLoadDataParams;delete this._pendingCallback,delete this._pendingLoadDataParams;var o=!!(i&&i.request&&i.request.collectResourceTiming)&&new e.RequestPerformance(i.request);this.loadGeoJSON(i,(function(n,a){if(n||!a)return r(n);if(\"object\"!=typeof a)return r(new Error(\"Input data given to '\"+i.source+\"' is not a valid GeoJSON object.\"));!function e(t,r){var i,o=t&&t.type;if(\"FeatureCollection\"===o)for(i=0;i<t.features.length;i++)e(t.features[i],r);else if(\"GeometryCollection\"===o)for(i=0;i<t.geometries.length;i++)e(t.geometries[i],r);else if(\"Feature\"===o)e(t.geometry,r);else if(\"Polygon\"===o)c(t.coordinates,r);else if(\"MultiPolygon\"===o)for(i=0;i<t.coordinates.length;i++)c(t.coordinates[i],r);return t}(a,!0);try{if(i.filter){var s=e.createExpression(i.filter,{type:\"boolean\",\"property-type\":\"data-driven\",overridable:!1,transition:!1});if(\"error\"===s.result)throw new Error(s.value.map((function(e){return e.key+\": \"+e.message})).join(\", \"));var l=a.features.filter((function(e){return s.value.evaluate({zoom:0},e)}));a={type:\"FeatureCollection\",features:l};}t._geoJSONIndex=i.cluster?new J(function(t){var r=t.superclusterOptions,i=t.clusterProperties;if(!i||!r)return r;for(var o={},n={},a={accumulated:null,zoom:0},s={properties:null},l=Object.keys(i),u=0,h=l;u<h.length;u+=1){var c=h[u],p=i[c],f=p[0],d=e.createExpression(p[1]),g=e.createExpression(\"string\"==typeof f?[f,[\"accumulated\"],[\"get\",c]]:f);o[c]=d.value,n[c]=g.value;}return r.map=function(e){s.properties=e;for(var t={},r=0,i=l;r<i.length;r+=1){var n=i[r];t[n]=o[n].evaluate(a,s);}return t},r.reduce=function(e,t){s.properties=t;for(var r=0,i=l;r<i.length;r+=1){var o=i[r];a.accumulated=e[o],e[o]=n[o].evaluate(a,s);}},r}(i)).load(a.features):function(e,t){return new me(e,t)}(a,i.geojsonVtOptions);}catch(n){return r(n)}t.loaded={};var u={};if(o){var h=o.finish();h&&(u.resourceTiming={},u.resourceTiming[i.source]=JSON.parse(JSON.stringify(h)));}r(null,u);}));}},r.prototype.coalesce=function(){\"Coalescing\"===this._state?this._state=\"Idle\":\"NeedsLoadData\"===this._state&&(this._state=\"Coalescing\",this._loadData());},r.prototype.reloadTile=function(e,r){var i=this.loaded;return i&&i[e.uid]?t.prototype.reloadTile.call(this,e,r):this.loadTile(e,r)},r.prototype.loadGeoJSON=function(t,r){if(t.request)e.getJSON(t.request,r);else {if(\"string\"!=typeof t.data)return r(new Error(\"Input data given to '\"+t.source+\"' is not a valid GeoJSON object.\"));try{return r(null,JSON.parse(t.data))}catch(e){return r(new Error(\"Input data given to '\"+t.source+\"' is not a valid GeoJSON object.\"))}}},r.prototype.removeSource=function(e,t){this._pendingCallback&&this._pendingCallback(null,{abandoned:!0}),t();},r.prototype.getClusterExpansionZoom=function(e,t){try{t(null,this._geoJSONIndex.getClusterExpansionZoom(e.clusterId));}catch(e){t(e);}},r.prototype.getClusterChildren=function(e,t){try{t(null,this._geoJSONIndex.getChildren(e.clusterId));}catch(e){t(e);}},r.prototype.getClusterLeaves=function(e,t){try{t(null,this._geoJSONIndex.getLeaves(e.clusterId,e.limit,e.offset));}catch(e){t(e);}},r}(l),Se=function(t){var r=this;this.self=t,this.actor=new e.Actor(t,this),this.layerIndexes={},this.availableImages={},this.workerSourceTypes={vector:l,geojson:we},this.workerSources={},this.demWorkerSources={},this.self.registerWorkerSource=function(e,t){if(r.workerSourceTypes[e])throw new Error('Worker source with name \"'+e+'\" already registered.');r.workerSourceTypes[e]=t;},this.self.registerRTLTextPlugin=function(t){if(e.plugin.isParsed())throw new Error(\"RTL text plugin already registered.\");e.plugin.applyArabicShaping=t.applyArabicShaping,e.plugin.processBidirectionalText=t.processBidirectionalText,e.plugin.processStyledBidirectionalText=t.processStyledBidirectionalText;};};return Se.prototype.setReferrer=function(e,t){this.referrer=t;},Se.prototype.setImages=function(e,t,r){for(var i in this.availableImages[e]=t,this.workerSources[e]){var o=this.workerSources[e][i];for(var n in o)o[n].availableImages=t;}r();},Se.prototype.setLayers=function(e,t,r){this.getLayerIndex(e).replace(t),r();},Se.prototype.updateLayers=function(e,t,r){this.getLayerIndex(e).update(t.layers,t.removedIds),r();},Se.prototype.loadTile=function(e,t,r){this.getWorkerSource(e,t.type,t.source).loadTile(t,r);},Se.prototype.loadDEMTile=function(e,t,r){this.getDEMWorkerSource(e,t.source).loadTile(t,r);},Se.prototype.reloadTile=function(e,t,r){this.getWorkerSource(e,t.type,t.source).reloadTile(t,r);},Se.prototype.abortTile=function(e,t,r){this.getWorkerSource(e,t.type,t.source).abortTile(t,r);},Se.prototype.removeTile=function(e,t,r){this.getWorkerSource(e,t.type,t.source).removeTile(t,r);},Se.prototype.removeDEMTile=function(e,t){this.getDEMWorkerSource(e,t.source).removeTile(t);},Se.prototype.removeSource=function(e,t,r){if(this.workerSources[e]&&this.workerSources[e][t.type]&&this.workerSources[e][t.type][t.source]){var i=this.workerSources[e][t.type][t.source];delete this.workerSources[e][t.type][t.source],void 0!==i.removeSource?i.removeSource(t,r):r();}},Se.prototype.loadWorkerSource=function(e,t,r){try{this.self.importScripts(t.url),r();}catch(e){r(e.toString());}},Se.prototype.syncRTLPluginState=function(t,r,i){try{e.plugin.setState(r);var o=e.plugin.getPluginURL();if(e.plugin.isLoaded()&&!e.plugin.isParsed()&&null!=o){this.self.importScripts(o);var n=e.plugin.isParsed();i(n?void 0:new Error(\"RTL Text Plugin failed to import scripts from \"+o),n);}}catch(e){i(e.toString());}},Se.prototype.getAvailableImages=function(e){var t=this.availableImages[e];return t||(t=[]),t},Se.prototype.getLayerIndex=function(e){var t=this.layerIndexes[e];return t||(t=this.layerIndexes[e]=new i),t},Se.prototype.getWorkerSource=function(e,t,r){var i=this;return this.workerSources[e]||(this.workerSources[e]={}),this.workerSources[e][t]||(this.workerSources[e][t]={}),this.workerSources[e][t][r]||(this.workerSources[e][t][r]=new this.workerSourceTypes[t]({send:function(t,r,o){i.actor.send(t,r,o,e);}},this.getLayerIndex(e),this.getAvailableImages(e))),this.workerSources[e][t][r]},Se.prototype.getDEMWorkerSource=function(e,t){return this.demWorkerSources[e]||(this.demWorkerSources[e]={}),this.demWorkerSources[e][t]||(this.demWorkerSources[e][t]=new h),this.demWorkerSources[e][t]},Se.prototype.enforceCacheSizeLimit=function(t,r){e.enforceCacheSizeLimit(r);},\"undefined\"!=typeof WorkerGlobalScope&&\"undefined\"!=typeof self&&self instanceof WorkerGlobalScope&&(self.worker=new Se(self)),Se}));\n\ndefine([\"./shared\"],(function(t){\"use strict\";var e=t.createCommonjsModule((function(t){function e(t){return !i(t)}function i(t){return \"undefined\"==typeof window||\"undefined\"==typeof document?\"not a browser\":Array.prototype&&Array.prototype.every&&Array.prototype.filter&&Array.prototype.forEach&&Array.prototype.indexOf&&Array.prototype.lastIndexOf&&Array.prototype.map&&Array.prototype.some&&Array.prototype.reduce&&Array.prototype.reduceRight&&Array.isArray?Function.prototype&&Function.prototype.bind?Object.keys&&Object.create&&Object.getPrototypeOf&&Object.getOwnPropertyNames&&Object.isSealed&&Object.isFrozen&&Object.isExtensible&&Object.getOwnPropertyDescriptor&&Object.defineProperty&&Object.defineProperties&&Object.seal&&Object.freeze&&Object.preventExtensions?\"JSON\"in window&&\"parse\"in JSON&&\"stringify\"in JSON?function(){if(!(\"Worker\"in window&&\"Blob\"in window&&\"URL\"in window))return !1;var t,e,i=new Blob([\"\"],{type:\"text/javascript\"}),o=URL.createObjectURL(i);try{e=new Worker(o),t=!0;}catch(e){t=!1;}return e&&e.terminate(),URL.revokeObjectURL(o),t}()?\"Uint8ClampedArray\"in window?ArrayBuffer.isView?function(){var t=document.createElement(\"canvas\");t.width=t.height=1;var e=t.getContext(\"2d\");if(!e)return !1;var i=e.getImageData(0,0,1,1);return i&&i.width===t.width}()?(void 0===o[i=t&&t.failIfMajorPerformanceCaveat]&&(o[i]=function(t){var i=function(t){var i=document.createElement(\"canvas\"),o=Object.create(e.webGLContextAttributes);return o.failIfMajorPerformanceCaveat=t,i.probablySupportsContext?i.probablySupportsContext(\"webgl\",o)||i.probablySupportsContext(\"experimental-webgl\",o):i.supportsContext?i.supportsContext(\"webgl\",o)||i.supportsContext(\"experimental-webgl\",o):i.getContext(\"webgl\",o)||i.getContext(\"experimental-webgl\",o)}(t);if(!i)return !1;var o=i.createShader(i.VERTEX_SHADER);return !(!o||i.isContextLost())&&(i.shaderSource(o,\"void main() {}\"),i.compileShader(o),!0===i.getShaderParameter(o,i.COMPILE_STATUS))}(i)),o[i]?void 0:\"insufficient WebGL support\"):\"insufficient Canvas/getImageData support\":\"insufficient ArrayBuffer support\":\"insufficient Uint8ClampedArray support\":\"insufficient worker support\":\"insufficient JSON support\":\"insufficient Object support\":\"insufficient Function support\":\"insufficent Array support\";var i;}t.exports?t.exports=e:window&&(window.mapboxgl=window.mapboxgl||{},window.mapboxgl.supported=e,window.mapboxgl.notSupportedReason=i);var o={};e.webGLContextAttributes={antialias:!1,alpha:!0,stencil:!0,depth:!0};})),i={create:function(e,i,o){var r=t.window.document.createElement(e);return void 0!==i&&(r.className=i),o&&o.appendChild(r),r},createNS:function(e,i){return t.window.document.createElementNS(e,i)}},o=t.window.document&&t.window.document.documentElement.style;function r(t){if(!o)return t[0];for(var e=0;e<t.length;e++)if(t[e]in o)return t[e];return t[0]}var a,n=r([\"userSelect\",\"MozUserSelect\",\"WebkitUserSelect\",\"msUserSelect\"]);i.disableDrag=function(){o&&n&&(a=o[n],o[n]=\"none\");},i.enableDrag=function(){o&&n&&(o[n]=a);};var s=r([\"transform\",\"WebkitTransform\"]);i.setTransform=function(t,e){t.style[s]=e;};var l=!1;try{var c=Object.defineProperty({},\"passive\",{get:function(){l=!0;}});t.window.addEventListener(\"test\",c,c),t.window.removeEventListener(\"test\",c,c);}catch(t){l=!1;}i.addEventListener=function(t,e,i,o){void 0===o&&(o={}),t.addEventListener(e,i,\"passive\"in o&&l?o:o.capture);},i.removeEventListener=function(t,e,i,o){void 0===o&&(o={}),t.removeEventListener(e,i,\"passive\"in o&&l?o:o.capture);};var u=function(e){e.preventDefault(),e.stopPropagation(),t.window.removeEventListener(\"click\",u,!0);};function h(t){var e=t.userImage;return !!(e&&e.render&&e.render())&&(t.data.replace(new Uint8Array(e.data.buffer)),!0)}i.suppressClick=function(){t.window.addEventListener(\"click\",u,!0),t.window.setTimeout((function(){t.window.removeEventListener(\"click\",u,!0);}),0);},i.mousePos=function(e,i){var o=e.getBoundingClientRect();return new t.Point(i.clientX-o.left-e.clientLeft,i.clientY-o.top-e.clientTop)},i.touchPos=function(e,i){for(var o=e.getBoundingClientRect(),r=[],a=0;a<i.length;a++)r.push(new t.Point(i[a].clientX-o.left-e.clientLeft,i[a].clientY-o.top-e.clientTop));return r},i.mouseButton=function(e){return void 0!==t.window.InstallTrigger&&2===e.button&&e.ctrlKey&&t.window.navigator.platform.toUpperCase().indexOf(\"MAC\")>=0?0:e.button},i.remove=function(t){t.parentNode&&t.parentNode.removeChild(t);};var p=function(e){function i(){e.call(this),this.images={},this.updatedImages={},this.callbackDispatchedThisFrame={},this.loaded=!1,this.requestors=[],this.patterns={},this.atlasImage=new t.RGBAImage({width:1,height:1}),this.dirty=!0;}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.isLoaded=function(){return this.loaded},i.prototype.setLoaded=function(t){if(this.loaded!==t&&(this.loaded=t,t)){for(var e=0,i=this.requestors;e<i.length;e+=1){var o=i[e];this._notify(o.ids,o.callback);}this.requestors=[];}},i.prototype.getImage=function(t){return this.images[t]},i.prototype.addImage=function(t,e){this._validate(t,e)&&(this.images[t]=e);},i.prototype._validate=function(e,i){var o=!0;return this._validateStretch(i.stretchX,i.data&&i.data.width)||(this.fire(new t.ErrorEvent(new Error('Image \"'+e+'\" has invalid \"stretchX\" value'))),o=!1),this._validateStretch(i.stretchY,i.data&&i.data.height)||(this.fire(new t.ErrorEvent(new Error('Image \"'+e+'\" has invalid \"stretchY\" value'))),o=!1),this._validateContent(i.content,i)||(this.fire(new t.ErrorEvent(new Error('Image \"'+e+'\" has invalid \"content\" value'))),o=!1),o},i.prototype._validateStretch=function(t,e){if(!t)return !0;for(var i=0,o=0,r=t;o<r.length;o+=1){var a=r[o];if(a[0]<i||a[1]<a[0]||e<a[1])return !1;i=a[1];}return !0},i.prototype._validateContent=function(t,e){return !(t&&(4!==t.length||t[0]<0||e.data.width<t[0]||t[1]<0||e.data.height<t[1]||t[2]<0||e.data.width<t[2]||t[3]<0||e.data.height<t[3]||t[2]<t[0]||t[3]<t[1]))},i.prototype.updateImage=function(t,e){e.version=this.images[t].version+1,this.images[t]=e,this.updatedImages[t]=!0;},i.prototype.removeImage=function(t){var e=this.images[t];delete this.images[t],delete this.patterns[t],e.userImage&&e.userImage.onRemove&&e.userImage.onRemove();},i.prototype.listImages=function(){return Object.keys(this.images)},i.prototype.getImages=function(t,e){var i=!0;if(!this.isLoaded())for(var o=0,r=t;o<r.length;o+=1)this.images[r[o]]||(i=!1);this.isLoaded()||i?this._notify(t,e):this.requestors.push({ids:t,callback:e});},i.prototype._notify=function(e,i){for(var o={},r=0,a=e;r<a.length;r+=1){var n=a[r];this.images[n]||this.fire(new t.Event(\"styleimagemissing\",{id:n}));var s=this.images[n];s?o[n]={data:s.data.clone(),pixelRatio:s.pixelRatio,sdf:s.sdf,version:s.version,stretchX:s.stretchX,stretchY:s.stretchY,content:s.content,hasRenderCallback:Boolean(s.userImage&&s.userImage.render)}:t.warnOnce('Image \"'+n+'\" could not be loaded. Please make sure you have added the image with map.addImage() or a \"sprite\" property in your style. You can provide missing images by listening for the \"styleimagemissing\" map event.');}i(null,o);},i.prototype.getPixelSize=function(){var t=this.atlasImage;return {width:t.width,height:t.height}},i.prototype.getPattern=function(e){var i=this.patterns[e],o=this.getImage(e);if(!o)return null;if(i&&i.position.version===o.version)return i.position;if(i)i.position.version=o.version;else {var r={w:o.data.width+2,h:o.data.height+2,x:0,y:0},a=new t.ImagePosition(r,o);this.patterns[e]={bin:r,position:a};}return this._updatePatternAtlas(),this.patterns[e].position},i.prototype.bind=function(e){var i=e.gl;this.atlasTexture?this.dirty&&(this.atlasTexture.update(this.atlasImage),this.dirty=!1):this.atlasTexture=new t.Texture(e,this.atlasImage,i.RGBA),this.atlasTexture.bind(i.LINEAR,i.CLAMP_TO_EDGE);},i.prototype._updatePatternAtlas=function(){var e=[];for(var i in this.patterns)e.push(this.patterns[i].bin);var o=t.potpack(e),r=o.w,a=o.h,n=this.atlasImage;for(var s in n.resize({width:r||1,height:a||1}),this.patterns){var l=this.patterns[s].bin,c=l.x+1,u=l.y+1,h=this.images[s].data,p=h.width,d=h.height;t.RGBAImage.copy(h,n,{x:0,y:0},{x:c,y:u},{width:p,height:d}),t.RGBAImage.copy(h,n,{x:0,y:d-1},{x:c,y:u-1},{width:p,height:1}),t.RGBAImage.copy(h,n,{x:0,y:0},{x:c,y:u+d},{width:p,height:1}),t.RGBAImage.copy(h,n,{x:p-1,y:0},{x:c-1,y:u},{width:1,height:d}),t.RGBAImage.copy(h,n,{x:0,y:0},{x:c+p,y:u},{width:1,height:d});}this.dirty=!0;},i.prototype.beginFrame=function(){this.callbackDispatchedThisFrame={};},i.prototype.dispatchRenderCallbacks=function(t){for(var e=0,i=t;e<i.length;e+=1){var o=i[e];if(!this.callbackDispatchedThisFrame[o]){this.callbackDispatchedThisFrame[o]=!0;var r=this.images[o];h(r)&&this.updateImage(o,r);}}},i}(t.Evented),d=m,_=m,f=1e20;function m(t,e,i,o,r,a){this.fontSize=t||24,this.buffer=void 0===e?3:e,this.cutoff=o||.25,this.fontFamily=r||\"sans-serif\",this.fontWeight=a||\"normal\",this.radius=i||8;var n=this.size=this.fontSize+2*this.buffer;this.canvas=document.createElement(\"canvas\"),this.canvas.width=this.canvas.height=n,this.ctx=this.canvas.getContext(\"2d\"),this.ctx.font=this.fontWeight+\" \"+this.fontSize+\"px \"+this.fontFamily,this.ctx.textBaseline=\"middle\",this.ctx.fillStyle=\"black\",this.gridOuter=new Float64Array(n*n),this.gridInner=new Float64Array(n*n),this.f=new Float64Array(n),this.d=new Float64Array(n),this.z=new Float64Array(n+1),this.v=new Int16Array(n),this.middle=Math.round(n/2*(navigator.userAgent.indexOf(\"Gecko/\")>=0?1.2:1));}function g(t,e,i,o,r,a,n){for(var s=0;s<e;s++){for(var l=0;l<i;l++)o[l]=t[l*e+s];for(v(o,r,a,n,i),l=0;l<i;l++)t[l*e+s]=r[l];}for(l=0;l<i;l++){for(s=0;s<e;s++)o[s]=t[l*e+s];for(v(o,r,a,n,e),s=0;s<e;s++)t[l*e+s]=Math.sqrt(r[s]);}}function v(t,e,i,o,r){i[0]=0,o[0]=-f,o[1]=+f;for(var a=1,n=0;a<r;a++){for(var s=(t[a]+a*a-(t[i[n]]+i[n]*i[n]))/(2*a-2*i[n]);s<=o[n];)n--,s=(t[a]+a*a-(t[i[n]]+i[n]*i[n]))/(2*a-2*i[n]);i[++n]=a,o[n]=s,o[n+1]=+f;}for(a=0,n=0;a<r;a++){for(;o[n+1]<a;)n++;e[a]=(a-i[n])*(a-i[n])+t[i[n]];}}m.prototype.draw=function(t){this.ctx.clearRect(0,0,this.size,this.size),this.ctx.fillText(t,this.buffer,this.middle);for(var e=this.ctx.getImageData(0,0,this.size,this.size),i=new Uint8ClampedArray(this.size*this.size),o=0;o<this.size*this.size;o++){var r=e.data[4*o+3]/255;this.gridOuter[o]=1===r?0:0===r?f:Math.pow(Math.max(0,.5-r),2),this.gridInner[o]=1===r?f:0===r?0:Math.pow(Math.max(0,r-.5),2);}for(g(this.gridOuter,this.size,this.size,this.f,this.d,this.v,this.z),g(this.gridInner,this.size,this.size,this.f,this.d,this.v,this.z),o=0;o<this.size*this.size;o++)i[o]=Math.max(0,Math.min(255,Math.round(255-255*((this.gridOuter[o]-this.gridInner[o])/this.radius+this.cutoff))));return i},d.default=_;var y=function(t,e){this.requestManager=t,this.localIdeographFontFamily=e,this.entries={};};y.prototype.setURL=function(t){this.url=t;},y.prototype.getGlyphs=function(e,i){var o=this,r=[];for(var a in e)for(var n=0,s=e[a];n<s.length;n+=1)r.push({stack:a,id:s[n]});t.asyncAll(r,(function(t,e){var i=t.stack,r=t.id,a=o.entries[i];a||(a=o.entries[i]={glyphs:{},requests:{},ranges:{}});var n=a.glyphs[r];if(void 0===n){if(n=o._tinySDF(a,i,r))return a.glyphs[r]=n,void e(null,{stack:i,id:r,glyph:n});var s=Math.floor(r/256);if(256*s>65535)e(new Error(\"glyphs > 65535 not supported\"));else if(a.ranges[s])e(null,{stack:i,id:r,glyph:n});else {var l=a.requests[s];l||(l=a.requests[s]=[],y.loadGlyphRange(i,s,o.url,o.requestManager,(function(t,e){if(e){for(var i in e)o._doesCharSupportLocalGlyph(+i)||(a.glyphs[+i]=e[+i]);a.ranges[s]=!0;}for(var r=0,n=l;r<n.length;r+=1)(0,n[r])(t,e);delete a.requests[s];}))),l.push((function(t,o){t?e(t):o&&e(null,{stack:i,id:r,glyph:o[r]||null});}));}}else e(null,{stack:i,id:r,glyph:n});}),(function(t,e){if(t)i(t);else if(e){for(var o={},r=0,a=e;r<a.length;r+=1){var n=a[r],s=n.stack,l=n.id,c=n.glyph;(o[s]||(o[s]={}))[l]=c&&{id:c.id,bitmap:c.bitmap.clone(),metrics:c.metrics};}i(null,o);}}));},y.prototype._doesCharSupportLocalGlyph=function(e){return !!this.localIdeographFontFamily&&(t.isChar[\"CJK Unified Ideographs\"](e)||t.isChar[\"Hangul Syllables\"](e)||t.isChar.Hiragana(e)||t.isChar.Katakana(e))},y.prototype._tinySDF=function(e,i,o){var r=this.localIdeographFontFamily;if(r&&this._doesCharSupportLocalGlyph(o)){var a=e.tinySDF;if(!a){var n=\"400\";/bold/i.test(i)?n=\"900\":/medium/i.test(i)?n=\"500\":/light/i.test(i)&&(n=\"200\"),a=e.tinySDF=new y.TinySDF(24,3,8,.25,r,n);}return {id:o,bitmap:new t.AlphaImage({width:30,height:30},a.draw(String.fromCharCode(o))),metrics:{width:24,height:24,left:0,top:-8,advance:24}}}},y.loadGlyphRange=function(e,i,o,r,a){var n=256*i,s=n+255,l=r.transformRequest(r.normalizeGlyphsURL(o).replace(\"{fontstack}\",e).replace(\"{range}\",n+\"-\"+s),t.ResourceType.Glyphs);t.getArrayBuffer(l,(function(e,i){if(e)a(e);else if(i){for(var o={},r=0,n=t.parseGlyphPBF(i);r<n.length;r+=1){var s=n[r];o[s.id]=s;}a(null,o);}}));},y.TinySDF=d;var x=function(){this.specification=t.styleSpec.light.position;};x.prototype.possiblyEvaluate=function(e,i){return t.sphericalToCartesian(e.expression.evaluate(i))},x.prototype.interpolate=function(e,i,o){return {x:t.number(e.x,i.x,o),y:t.number(e.y,i.y,o),z:t.number(e.z,i.z,o)}};var b=new t.Properties({anchor:new t.DataConstantProperty(t.styleSpec.light.anchor),position:new x,color:new t.DataConstantProperty(t.styleSpec.light.color),intensity:new t.DataConstantProperty(t.styleSpec.light.intensity)}),w=function(e){function i(i){e.call(this),this._transitionable=new t.Transitionable(b),this.setLight(i),this._transitioning=this._transitionable.untransitioned();}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.getLight=function(){return this._transitionable.serialize()},i.prototype.setLight=function(e,i){if(void 0===i&&(i={}),!this._validate(t.validateLight,e,i))for(var o in e){var r=e[o];t.endsWith(o,\"-transition\")?this._transitionable.setTransition(o.slice(0,-\"-transition\".length),r):this._transitionable.setValue(o,r);}},i.prototype.updateTransitions=function(t){this._transitioning=this._transitionable.transitioned(t,this._transitioning);},i.prototype.hasTransition=function(){return this._transitioning.hasTransition()},i.prototype.recalculate=function(t){this.properties=this._transitioning.possiblyEvaluate(t);},i.prototype._validate=function(e,i,o){return (!o||!1!==o.validate)&&t.emitValidationErrors(this,e.call(t.validateStyle,t.extend({value:i,style:{glyphs:!0,sprite:!0},styleSpec:t.styleSpec})))},i}(t.Evented),T=function(t,e){this.width=t,this.height=e,this.nextRow=0,this.data=new Uint8Array(this.width*this.height),this.dashEntry={};};T.prototype.getDash=function(t,e){var i=t.join(\",\")+String(e);return this.dashEntry[i]||(this.dashEntry[i]=this.addDash(t,e)),this.dashEntry[i]},T.prototype.getDashRanges=function(t,e,i){var o=[],r=t.length%2==1?-t[t.length-1]*i:0,a=t[0]*i,n=!0;o.push({left:r,right:a,isDash:n,zeroLength:0===t[0]});for(var s=t[0],l=1;l<t.length;l++){var c=t[l];o.push({left:r=s*i,right:a=(s+=c)*i,isDash:n=!n,zeroLength:0===c});}return o},T.prototype.addRoundDash=function(t,e,i){for(var o=e/2,r=-i;r<=i;r++)for(var a=this.width*(this.nextRow+i+r),n=0,s=t[n],l=0;l<this.width;l++){l/s.right>1&&(s=t[++n]);var c=Math.abs(l-s.left),u=Math.abs(l-s.right),h=Math.min(c,u),p=void 0,d=r/i*(o+1);if(s.isDash){var _=o-Math.abs(d);p=Math.sqrt(h*h+_*_);}else p=o-Math.sqrt(h*h+d*d);this.data[a+l]=Math.max(0,Math.min(255,p+128));}},T.prototype.addRegularDash=function(t){for(var e=t.length-1;e>=0;--e){var i=t[e],o=t[e+1];i.zeroLength?t.splice(e,1):o&&o.isDash===i.isDash&&(o.left=i.left,t.splice(e,1));}var r=t[0],a=t[t.length-1];r.isDash===a.isDash&&(r.left=a.left-this.width,a.right=r.right+this.width);for(var n=this.width*this.nextRow,s=0,l=t[s],c=0;c<this.width;c++){c/l.right>1&&(l=t[++s]);var u=Math.abs(c-l.left),h=Math.abs(c-l.right),p=Math.min(u,h);this.data[n+c]=Math.max(0,Math.min(255,(l.isDash?p:-p)+128));}},T.prototype.addDash=function(e,i){var o=i?7:0,r=2*o+1;if(this.nextRow+r>this.height)return t.warnOnce(\"LineAtlas out of space\"),null;for(var a=0,n=0;n<e.length;n++)a+=e[n];if(0!==a){var s=this.width/a,l=this.getDashRanges(e,this.width,s);i?this.addRoundDash(l,s,o):this.addRegularDash(l);}var c={y:(this.nextRow+o+.5)/this.height,height:2*o/this.height,width:a};return this.nextRow+=r,this.dirty=!0,c},T.prototype.bind=function(t){var e=t.gl;this.texture?(e.bindTexture(e.TEXTURE_2D,this.texture),this.dirty&&(this.dirty=!1,e.texSubImage2D(e.TEXTURE_2D,0,0,0,this.width,this.height,e.ALPHA,e.UNSIGNED_BYTE,this.data))):(this.texture=e.createTexture(),e.bindTexture(e.TEXTURE_2D,this.texture),e.texParameteri(e.TEXTURE_2D,e.TEXTURE_WRAP_S,e.REPEAT),e.texParameteri(e.TEXTURE_2D,e.TEXTURE_WRAP_T,e.REPEAT),e.texParameteri(e.TEXTURE_2D,e.TEXTURE_MIN_FILTER,e.LINEAR),e.texParameteri(e.TEXTURE_2D,e.TEXTURE_MAG_FILTER,e.LINEAR),e.texImage2D(e.TEXTURE_2D,0,e.ALPHA,this.width,this.height,0,e.ALPHA,e.UNSIGNED_BYTE,this.data));};var E=function e(i,o){this.workerPool=i,this.actors=[],this.currentActor=0,this.id=t.uniqueId();for(var r=this.workerPool.acquire(this.id),a=0;a<r.length;a++){var n=new e.Actor(r[a],o,this.id);n.name=\"Worker \"+a,this.actors.push(n);}};function I(e,i,o){var r=function(r,a){if(r)return o(r);if(a){var n=t.pick(t.extend(a,e),[\"tiles\",\"minzoom\",\"maxzoom\",\"attribution\",\"mapbox_logo\",\"bounds\",\"scheme\",\"tileSize\",\"encoding\"]);a.vector_layers&&(n.vectorLayers=a.vector_layers,n.vectorLayerIds=n.vectorLayers.map((function(t){return t.id}))),n.tiles=i.canonicalizeTileset(n,e.url),o(null,n);}};return e.url?t.getJSON(i.transformRequest(i.normalizeSourceURL(e.url),t.ResourceType.Source),r):t.browser.frame((function(){return r(null,e)}))}E.prototype.broadcast=function(e,i,o){t.asyncAll(this.actors,(function(t,o){t.send(e,i,o);}),o=o||function(){});},E.prototype.getActor=function(){return this.currentActor=(this.currentActor+1)%this.actors.length,this.actors[this.currentActor]},E.prototype.remove=function(){this.actors.forEach((function(t){t.remove();})),this.actors=[],this.workerPool.release(this.id);},E.Actor=t.Actor;var P=function(e,i,o){this.bounds=t.LngLatBounds.convert(this.validateBounds(e)),this.minzoom=i||0,this.maxzoom=o||24;};P.prototype.validateBounds=function(t){return Array.isArray(t)&&4===t.length?[Math.max(-180,t[0]),Math.max(-90,t[1]),Math.min(180,t[2]),Math.min(90,t[3])]:[-180,-90,180,90]},P.prototype.contains=function(e){var i=Math.pow(2,e.z),o=Math.floor(t.mercatorXfromLng(this.bounds.getWest())*i),r=Math.floor(t.mercatorYfromLat(this.bounds.getNorth())*i),a=Math.ceil(t.mercatorXfromLng(this.bounds.getEast())*i),n=Math.ceil(t.mercatorYfromLat(this.bounds.getSouth())*i);return e.x>=o&&e.x<a&&e.y>=r&&e.y<n};var S=function(e){function i(i,o,r,a){if(e.call(this),this.id=i,this.dispatcher=r,this.type=\"vector\",this.minzoom=0,this.maxzoom=22,this.scheme=\"xyz\",this.tileSize=512,this.reparseOverscaled=!0,this.isTileClipped=!0,this._loaded=!1,t.extend(this,t.pick(o,[\"url\",\"scheme\",\"tileSize\",\"promoteId\"])),this._options=t.extend({type:\"vector\"},o),this._collectResourceTiming=o.collectResourceTiming,512!==this.tileSize)throw new Error(\"vector tile sources must have a tileSize of 512\");this.setEventedParent(a);}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.load=function(){var e=this;this._loaded=!1,this.fire(new t.Event(\"dataloading\",{dataType:\"source\"})),this._tileJSONRequest=I(this._options,this.map._requestManager,(function(i,o){e._tileJSONRequest=null,e._loaded=!0,i?e.fire(new t.ErrorEvent(i)):o&&(t.extend(e,o),o.bounds&&(e.tileBounds=new P(o.bounds,e.minzoom,e.maxzoom)),t.postTurnstileEvent(o.tiles,e.map._requestManager._customAccessToken),t.postMapLoadEvent(o.tiles,e.map._getMapId(),e.map._requestManager._skuToken,e.map._requestManager._customAccessToken),e.fire(new t.Event(\"data\",{dataType:\"source\",sourceDataType:\"metadata\"})),e.fire(new t.Event(\"data\",{dataType:\"source\",sourceDataType:\"content\"})));}));},i.prototype.loaded=function(){return this._loaded},i.prototype.hasTile=function(t){return !this.tileBounds||this.tileBounds.contains(t.canonical)},i.prototype.onAdd=function(t){this.map=t,this.load();},i.prototype.setSourceProperty=function(t){this._tileJSONRequest&&this._tileJSONRequest.cancel(),t(),this.map.style.sourceCaches[this.id].clearTiles(),this.load();},i.prototype.setTiles=function(t){var e=this;return this.setSourceProperty((function(){e._options.tiles=t;})),this},i.prototype.setUrl=function(t){var e=this;return this.setSourceProperty((function(){e.url=t,e._options.url=t;})),this},i.prototype.onRemove=function(){this._tileJSONRequest&&(this._tileJSONRequest.cancel(),this._tileJSONRequest=null);},i.prototype.serialize=function(){return t.extend({},this._options)},i.prototype.loadTile=function(e,i){var o=this.map._requestManager.normalizeTileURL(e.tileID.canonical.url(this.tiles,this.scheme)),r={request:this.map._requestManager.transformRequest(o,t.ResourceType.Tile),uid:e.uid,tileID:e.tileID,zoom:e.tileID.overscaledZ,tileSize:this.tileSize*e.tileID.overscaleFactor(),type:this.type,source:this.id,pixelRatio:t.browser.devicePixelRatio,showCollisionBoxes:this.map.showCollisionBoxes,promoteId:this.promoteId};function a(o,r){return delete e.request,e.aborted?i(null):o&&404!==o.status?i(o):(r&&r.resourceTiming&&(e.resourceTiming=r.resourceTiming),this.map._refreshExpiredTiles&&r&&e.setExpiryData(r),e.loadVectorData(r,this.map.painter),t.cacheEntryPossiblyAdded(this.dispatcher),i(null),void(e.reloadCallback&&(this.loadTile(e,e.reloadCallback),e.reloadCallback=null)))}r.request.collectResourceTiming=this._collectResourceTiming,e.actor&&\"expired\"!==e.state?\"loading\"===e.state?e.reloadCallback=i:e.request=e.actor.send(\"reloadTile\",r,a.bind(this)):(e.actor=this.dispatcher.getActor(),e.request=e.actor.send(\"loadTile\",r,a.bind(this)));},i.prototype.abortTile=function(t){t.request&&(t.request.cancel(),delete t.request),t.actor&&t.actor.send(\"abortTile\",{uid:t.uid,type:this.type,source:this.id},void 0);},i.prototype.unloadTile=function(t){t.unloadVectorData(),t.actor&&t.actor.send(\"removeTile\",{uid:t.uid,type:this.type,source:this.id},void 0);},i.prototype.hasTransition=function(){return !1},i}(t.Evented),C=function(e){function i(i,o,r,a){e.call(this),this.id=i,this.dispatcher=r,this.setEventedParent(a),this.type=\"raster\",this.minzoom=0,this.maxzoom=22,this.roundZoom=!0,this.scheme=\"xyz\",this.tileSize=512,this._loaded=!1,this._options=t.extend({type:\"raster\"},o),t.extend(this,t.pick(o,[\"url\",\"scheme\",\"tileSize\"]));}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.load=function(){var e=this;this._loaded=!1,this.fire(new t.Event(\"dataloading\",{dataType:\"source\"})),this._tileJSONRequest=I(this._options,this.map._requestManager,(function(i,o){e._tileJSONRequest=null,e._loaded=!0,i?e.fire(new t.ErrorEvent(i)):o&&(t.extend(e,o),o.bounds&&(e.tileBounds=new P(o.bounds,e.minzoom,e.maxzoom)),t.postTurnstileEvent(o.tiles),t.postMapLoadEvent(o.tiles,e.map._getMapId(),e.map._requestManager._skuToken),e.fire(new t.Event(\"data\",{dataType:\"source\",sourceDataType:\"metadata\"})),e.fire(new t.Event(\"data\",{dataType:\"source\",sourceDataType:\"content\"})));}));},i.prototype.loaded=function(){return this._loaded},i.prototype.onAdd=function(t){this.map=t,this.load();},i.prototype.onRemove=function(){this._tileJSONRequest&&(this._tileJSONRequest.cancel(),this._tileJSONRequest=null);},i.prototype.serialize=function(){return t.extend({},this._options)},i.prototype.hasTile=function(t){return !this.tileBounds||this.tileBounds.contains(t.canonical)},i.prototype.loadTile=function(e,i){var o=this,r=this.map._requestManager.normalizeTileURL(e.tileID.canonical.url(this.tiles,this.scheme),this.tileSize);e.request=t.getImage(this.map._requestManager.transformRequest(r,t.ResourceType.Tile),(function(r,a){if(delete e.request,e.aborted)e.state=\"unloaded\",i(null);else if(r)e.state=\"errored\",i(r);else if(a){o.map._refreshExpiredTiles&&e.setExpiryData(a),delete a.cacheControl,delete a.expires;var n=o.map.painter.context,s=n.gl;e.texture=o.map.painter.getTileTexture(a.width),e.texture?e.texture.update(a,{useMipmap:!0}):(e.texture=new t.Texture(n,a,s.RGBA,{useMipmap:!0}),e.texture.bind(s.LINEAR,s.CLAMP_TO_EDGE,s.LINEAR_MIPMAP_NEAREST),n.extTextureFilterAnisotropic&&s.texParameterf(s.TEXTURE_2D,n.extTextureFilterAnisotropic.TEXTURE_MAX_ANISOTROPY_EXT,n.extTextureFilterAnisotropicMax)),e.state=\"loaded\",t.cacheEntryPossiblyAdded(o.dispatcher),i(null);}}));},i.prototype.abortTile=function(t,e){t.request&&(t.request.cancel(),delete t.request),e();},i.prototype.unloadTile=function(t,e){t.texture&&this.map.painter.saveTileTexture(t.texture),e();},i.prototype.hasTransition=function(){return !1},i}(t.Evented),z=function(e){function i(i,o,r,a){e.call(this,i,o,r,a),this.type=\"raster-dem\",this.maxzoom=22,this._options=t.extend({type:\"raster-dem\"},o),this.encoding=o.encoding||\"mapbox\";}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.serialize=function(){return {type:\"raster-dem\",url:this.url,tileSize:this.tileSize,tiles:this.tiles,bounds:this.bounds,encoding:this.encoding}},i.prototype.loadTile=function(e,i){var o=this.map._requestManager.normalizeTileURL(e.tileID.canonical.url(this.tiles,this.scheme),this.tileSize);function r(t,o){t&&(e.state=\"errored\",i(t)),o&&(e.dem=o,e.needsHillshadePrepare=!0,e.state=\"loaded\",i(null));}e.request=t.getImage(this.map._requestManager.transformRequest(o,t.ResourceType.Tile),function(o,a){if(delete e.request,e.aborted)e.state=\"unloaded\",i(null);else if(o)e.state=\"errored\",i(o);else if(a){this.map._refreshExpiredTiles&&e.setExpiryData(a),delete a.cacheControl,delete a.expires;var n=t.window.ImageBitmap&&a instanceof t.window.ImageBitmap&&t.offscreenCanvasSupported()?a:t.browser.getImageData(a,1),s={uid:e.uid,coord:e.tileID,source:this.id,rawImageData:n,encoding:this.encoding};e.actor&&\"expired\"!==e.state||(e.actor=this.dispatcher.getActor(),e.actor.send(\"loadDEMTile\",s,r.bind(this)));}}.bind(this)),e.neighboringTiles=this._getNeighboringTiles(e.tileID);},i.prototype._getNeighboringTiles=function(e){var i=e.canonical,o=Math.pow(2,i.z),r=(i.x-1+o)%o,a=0===i.x?e.wrap-1:e.wrap,n=(i.x+1+o)%o,s=i.x+1===o?e.wrap+1:e.wrap,l={};return l[new t.OverscaledTileID(e.overscaledZ,a,i.z,r,i.y).key]={backfilled:!1},l[new t.OverscaledTileID(e.overscaledZ,s,i.z,n,i.y).key]={backfilled:!1},i.y>0&&(l[new t.OverscaledTileID(e.overscaledZ,a,i.z,r,i.y-1).key]={backfilled:!1},l[new t.OverscaledTileID(e.overscaledZ,e.wrap,i.z,i.x,i.y-1).key]={backfilled:!1},l[new t.OverscaledTileID(e.overscaledZ,s,i.z,n,i.y-1).key]={backfilled:!1}),i.y+1<o&&(l[new t.OverscaledTileID(e.overscaledZ,a,i.z,r,i.y+1).key]={backfilled:!1},l[new t.OverscaledTileID(e.overscaledZ,e.wrap,i.z,i.x,i.y+1).key]={backfilled:!1},l[new t.OverscaledTileID(e.overscaledZ,s,i.z,n,i.y+1).key]={backfilled:!1}),l},i.prototype.unloadTile=function(t){t.demTexture&&this.map.painter.saveTileTexture(t.demTexture),t.fbo&&(t.fbo.destroy(),delete t.fbo),t.dem&&delete t.dem,delete t.neighboringTiles,t.state=\"unloaded\",t.actor&&t.actor.send(\"removeDEMTile\",{uid:t.uid,source:this.id});},i}(C),D=function(e){function i(i,o,r,a){e.call(this),this.id=i,this.type=\"geojson\",this.minzoom=0,this.maxzoom=18,this.tileSize=512,this.isTileClipped=!0,this.reparseOverscaled=!0,this._removed=!1,this._loaded=!1,this.actor=r.getActor(),this.setEventedParent(a),this._data=o.data,this._options=t.extend({},o),this._collectResourceTiming=o.collectResourceTiming,this._resourceTiming=[],void 0!==o.maxzoom&&(this.maxzoom=o.maxzoom),o.type&&(this.type=o.type),o.attribution&&(this.attribution=o.attribution),this.promoteId=o.promoteId;var n=t.EXTENT/this.tileSize;this.workerOptions=t.extend({source:this.id,cluster:o.cluster||!1,geojsonVtOptions:{buffer:(void 0!==o.buffer?o.buffer:128)*n,tolerance:(void 0!==o.tolerance?o.tolerance:.375)*n,extent:t.EXTENT,maxZoom:this.maxzoom,lineMetrics:o.lineMetrics||!1,generateId:o.generateId||!1},superclusterOptions:{maxZoom:void 0!==o.clusterMaxZoom?Math.min(o.clusterMaxZoom,this.maxzoom-1):this.maxzoom-1,minPoints:Math.max(2,o.clusterMinPoints||2),extent:t.EXTENT,radius:(o.clusterRadius||50)*n,log:!1,generateId:o.generateId||!1},clusterProperties:o.clusterProperties,filter:o.filter},o.workerOptions);}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.load=function(){var e=this;this.fire(new t.Event(\"dataloading\",{dataType:\"source\"})),this._updateWorkerData((function(i){if(i)e.fire(new t.ErrorEvent(i));else {var o={dataType:\"source\",sourceDataType:\"metadata\"};e._collectResourceTiming&&e._resourceTiming&&e._resourceTiming.length>0&&(o.resourceTiming=e._resourceTiming,e._resourceTiming=[]),e.fire(new t.Event(\"data\",o));}}));},i.prototype.onAdd=function(t){this.map=t,this.load();},i.prototype.setData=function(e){var i=this;return this._data=e,this.fire(new t.Event(\"dataloading\",{dataType:\"source\"})),this._updateWorkerData((function(e){if(e)i.fire(new t.ErrorEvent(e));else {var o={dataType:\"source\",sourceDataType:\"content\"};i._collectResourceTiming&&i._resourceTiming&&i._resourceTiming.length>0&&(o.resourceTiming=i._resourceTiming,i._resourceTiming=[]),i.fire(new t.Event(\"data\",o));}})),this},i.prototype.getClusterExpansionZoom=function(t,e){return this.actor.send(\"geojson.getClusterExpansionZoom\",{clusterId:t,source:this.id},e),this},i.prototype.getClusterChildren=function(t,e){return this.actor.send(\"geojson.getClusterChildren\",{clusterId:t,source:this.id},e),this},i.prototype.getClusterLeaves=function(t,e,i,o){return this.actor.send(\"geojson.getClusterLeaves\",{source:this.id,clusterId:t,limit:e,offset:i},o),this},i.prototype._updateWorkerData=function(e){var i=this;this._loaded=!1;var o=t.extend({},this.workerOptions),r=this._data;\"string\"==typeof r?(o.request=this.map._requestManager.transformRequest(t.browser.resolveURL(r),t.ResourceType.Source),o.request.collectResourceTiming=this._collectResourceTiming):o.data=JSON.stringify(r),this.actor.send(this.type+\".loadData\",o,(function(t,r){i._removed||r&&r.abandoned||(i._loaded=!0,r&&r.resourceTiming&&r.resourceTiming[i.id]&&(i._resourceTiming=r.resourceTiming[i.id].slice(0)),i.actor.send(i.type+\".coalesce\",{source:o.source},null),e(t));}));},i.prototype.loaded=function(){return this._loaded},i.prototype.loadTile=function(e,i){var o=this,r=e.actor?\"reloadTile\":\"loadTile\";e.actor=this.actor,e.request=this.actor.send(r,{type:this.type,uid:e.uid,tileID:e.tileID,zoom:e.tileID.overscaledZ,maxZoom:this.maxzoom,tileSize:this.tileSize,source:this.id,pixelRatio:t.browser.devicePixelRatio,showCollisionBoxes:this.map.showCollisionBoxes,promoteId:this.promoteId},(function(t,a){return delete e.request,e.unloadVectorData(),e.aborted?i(null):t?i(t):(e.loadVectorData(a,o.map.painter,\"reloadTile\"===r),i(null))}));},i.prototype.abortTile=function(t){t.request&&(t.request.cancel(),delete t.request),t.aborted=!0;},i.prototype.unloadTile=function(t){t.unloadVectorData(),this.actor.send(\"removeTile\",{uid:t.uid,type:this.type,source:this.id});},i.prototype.onRemove=function(){this._removed=!0,this.actor.send(\"removeSource\",{type:this.type,source:this.id});},i.prototype.serialize=function(){return t.extend({},this._options,{type:this.type,data:this._data})},i.prototype.hasTransition=function(){return !1},i}(t.Evented),A=t.createLayout([{name:\"a_pos\",type:\"Int16\",components:2},{name:\"a_texture_pos\",type:\"Int16\",components:2}]),M=function(e){function i(t,i,o,r){e.call(this),this.id=t,this.dispatcher=o,this.coordinates=i.coordinates,this.type=\"image\",this.minzoom=0,this.maxzoom=22,this.tileSize=512,this.tiles={},this._loaded=!1,this.setEventedParent(r),this.options=i;}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.load=function(e,i){var o=this;this._loaded=!1,this.fire(new t.Event(\"dataloading\",{dataType:\"source\"})),this.url=this.options.url,t.getImage(this.map._requestManager.transformRequest(this.url,t.ResourceType.Image),(function(r,a){o._loaded=!0,r?o.fire(new t.ErrorEvent(r)):a&&(o.image=a,e&&(o.coordinates=e),i&&i(),o._finishLoading());}));},i.prototype.loaded=function(){return this._loaded},i.prototype.updateImage=function(t){var e=this;return this.image&&t.url?(this.options.url=t.url,this.load(t.coordinates,(function(){e.texture=null;})),this):this},i.prototype._finishLoading=function(){this.map&&(this.setCoordinates(this.coordinates),this.fire(new t.Event(\"data\",{dataType:\"source\",sourceDataType:\"metadata\"})));},i.prototype.onAdd=function(t){this.map=t,this.load();},i.prototype.setCoordinates=function(e){var i=this;this.coordinates=e;var o=e.map(t.MercatorCoordinate.fromLngLat);this.tileID=function(e){for(var i=1/0,o=1/0,r=-1/0,a=-1/0,n=0,s=e;n<s.length;n+=1){var l=s[n];i=Math.min(i,l.x),o=Math.min(o,l.y),r=Math.max(r,l.x),a=Math.max(a,l.y);}var c=Math.max(r-i,a-o),u=Math.max(0,Math.floor(-Math.log(c)/Math.LN2)),h=Math.pow(2,u);return new t.CanonicalTileID(u,Math.floor((i+r)/2*h),Math.floor((o+a)/2*h))}(o),this.minzoom=this.maxzoom=this.tileID.z;var r=o.map((function(t){return i.tileID.getTilePoint(t)._round()}));return this._boundsArray=new t.StructArrayLayout4i8,this._boundsArray.emplaceBack(r[0].x,r[0].y,0,0),this._boundsArray.emplaceBack(r[1].x,r[1].y,t.EXTENT,0),this._boundsArray.emplaceBack(r[3].x,r[3].y,0,t.EXTENT),this._boundsArray.emplaceBack(r[2].x,r[2].y,t.EXTENT,t.EXTENT),this.boundsBuffer&&(this.boundsBuffer.destroy(),delete this.boundsBuffer),this.fire(new t.Event(\"data\",{dataType:\"source\",sourceDataType:\"content\"})),this},i.prototype.prepare=function(){if(0!==Object.keys(this.tiles).length&&this.image){var e=this.map.painter.context,i=e.gl;for(var o in this.boundsBuffer||(this.boundsBuffer=e.createVertexBuffer(this._boundsArray,A.members)),this.boundsSegments||(this.boundsSegments=t.SegmentVector.simpleSegment(0,0,4,2)),this.texture||(this.texture=new t.Texture(e,this.image,i.RGBA),this.texture.bind(i.LINEAR,i.CLAMP_TO_EDGE)),this.tiles){var r=this.tiles[o];\"loaded\"!==r.state&&(r.state=\"loaded\",r.texture=this.texture);}}},i.prototype.loadTile=function(t,e){this.tileID&&this.tileID.equals(t.tileID.canonical)?(this.tiles[String(t.tileID.wrap)]=t,t.buckets={},e(null)):(t.state=\"errored\",e(null));},i.prototype.serialize=function(){return {type:\"image\",url:this.options.url,coordinates:this.coordinates}},i.prototype.hasTransition=function(){return !1},i}(t.Evented),L=function(e){function i(t,i,o,r){e.call(this,t,i,o,r),this.roundZoom=!0,this.type=\"video\",this.options=i;}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.load=function(){var e=this;this._loaded=!1;var i=this.options;this.urls=[];for(var o=0,r=i.urls;o<r.length;o+=1)this.urls.push(this.map._requestManager.transformRequest(r[o],t.ResourceType.Source).url);t.getVideo(this.urls,(function(i,o){e._loaded=!0,i?e.fire(new t.ErrorEvent(i)):o&&(e.video=o,e.video.loop=!0,e.video.setAttribute(\"playsinline\",\"\"),e.video.addEventListener(\"playing\",(function(){e.map.triggerRepaint();})),e.map&&e.video.play(),e._finishLoading());}));},i.prototype.pause=function(){this.video&&this.video.pause();},i.prototype.play=function(){this.video&&this.video.play();},i.prototype.seek=function(e){if(this.video){var i=this.video.seekable;e<i.start(0)||e>i.end(0)?this.fire(new t.ErrorEvent(new t.ValidationError(\"sources.\"+this.id,null,\"Playback for this video can be set only between the \"+i.start(0)+\" and \"+i.end(0)+\"-second mark.\"))):this.video.currentTime=e;}},i.prototype.getVideo=function(){return this.video},i.prototype.onAdd=function(t){this.map||(this.map=t,this.load(),this.video&&(this.video.play(),this.setCoordinates(this.coordinates)));},i.prototype.prepare=function(){if(!(0===Object.keys(this.tiles).length||this.video.readyState<2)){var e=this.map.painter.context,i=e.gl;for(var o in this.boundsBuffer||(this.boundsBuffer=e.createVertexBuffer(this._boundsArray,A.members)),this.boundsSegments||(this.boundsSegments=t.SegmentVector.simpleSegment(0,0,4,2)),this.texture?this.video.paused||(this.texture.bind(i.LINEAR,i.CLAMP_TO_EDGE),i.texSubImage2D(i.TEXTURE_2D,0,0,0,i.RGBA,i.UNSIGNED_BYTE,this.video)):(this.texture=new t.Texture(e,this.video,i.RGBA),this.texture.bind(i.LINEAR,i.CLAMP_TO_EDGE)),this.tiles){var r=this.tiles[o];\"loaded\"!==r.state&&(r.state=\"loaded\",r.texture=this.texture);}}},i.prototype.serialize=function(){return {type:\"video\",urls:this.urls,coordinates:this.coordinates}},i.prototype.hasTransition=function(){return this.video&&!this.video.paused},i}(M),R=function(e){function i(i,o,r,a){e.call(this,i,o,r,a),o.coordinates?Array.isArray(o.coordinates)&&4===o.coordinates.length&&!o.coordinates.some((function(t){return !Array.isArray(t)||2!==t.length||t.some((function(t){return \"number\"!=typeof t}))}))||this.fire(new t.ErrorEvent(new t.ValidationError(\"sources.\"+i,null,'\"coordinates\" property must be an array of 4 longitude/latitude array pairs'))):this.fire(new t.ErrorEvent(new t.ValidationError(\"sources.\"+i,null,'missing required property \"coordinates\"'))),o.animate&&\"boolean\"!=typeof o.animate&&this.fire(new t.ErrorEvent(new t.ValidationError(\"sources.\"+i,null,'optional \"animate\" property must be a boolean value'))),o.canvas?\"string\"==typeof o.canvas||o.canvas instanceof t.window.HTMLCanvasElement||this.fire(new t.ErrorEvent(new t.ValidationError(\"sources.\"+i,null,'\"canvas\" must be either a string representing the ID of the canvas element from which to read, or an HTMLCanvasElement instance'))):this.fire(new t.ErrorEvent(new t.ValidationError(\"sources.\"+i,null,'missing required property \"canvas\"'))),this.options=o,this.animate=void 0===o.animate||o.animate;}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.load=function(){this._loaded=!0,this.canvas||(this.canvas=this.options.canvas instanceof t.window.HTMLCanvasElement?this.options.canvas:t.window.document.getElementById(this.options.canvas)),this.width=this.canvas.width,this.height=this.canvas.height,this._hasInvalidDimensions()?this.fire(new t.ErrorEvent(new Error(\"Canvas dimensions cannot be less than or equal to zero.\"))):(this.play=function(){this._playing=!0,this.map.triggerRepaint();},this.pause=function(){this._playing&&(this.prepare(),this._playing=!1);},this._finishLoading());},i.prototype.getCanvas=function(){return this.canvas},i.prototype.onAdd=function(t){this.map=t,this.load(),this.canvas&&this.animate&&this.play();},i.prototype.onRemove=function(){this.pause();},i.prototype.prepare=function(){var e=!1;if(this.canvas.width!==this.width&&(this.width=this.canvas.width,e=!0),this.canvas.height!==this.height&&(this.height=this.canvas.height,e=!0),!this._hasInvalidDimensions()&&0!==Object.keys(this.tiles).length){var i=this.map.painter.context,o=i.gl;for(var r in this.boundsBuffer||(this.boundsBuffer=i.createVertexBuffer(this._boundsArray,A.members)),this.boundsSegments||(this.boundsSegments=t.SegmentVector.simpleSegment(0,0,4,2)),this.texture?(e||this._playing)&&this.texture.update(this.canvas,{premultiply:!0}):this.texture=new t.Texture(i,this.canvas,o.RGBA,{premultiply:!0}),this.tiles){var a=this.tiles[r];\"loaded\"!==a.state&&(a.state=\"loaded\",a.texture=this.texture);}}},i.prototype.serialize=function(){return {type:\"canvas\",coordinates:this.coordinates}},i.prototype.hasTransition=function(){return this._playing},i.prototype._hasInvalidDimensions=function(){for(var t=0,e=[this.canvas.width,this.canvas.height];t<e.length;t+=1){var i=e[t];if(isNaN(i)||i<=0)return !0}return !1},i}(M),k={vector:S,raster:C,\"raster-dem\":z,geojson:D,video:L,image:M,canvas:R};function B(e,i){var o=t.identity([]);return t.translate(o,o,[1,1,0]),t.scale(o,o,[.5*e.width,.5*e.height,1]),t.multiply(o,o,e.calculatePosMatrix(i.toUnwrapped()))}function O(t,e,i,o,r,a){var n=function(t,e,i){if(t)for(var o=0,r=t;o<r.length;o+=1){var a=e[r[o]];if(a&&a.source===i&&\"fill-extrusion\"===a.type)return !0}else for(var n in e){var s=e[n];if(s.source===i&&\"fill-extrusion\"===s.type)return !0}return !1}(r&&r.layers,e,t.id),s=a.maxPitchScaleFactor(),l=t.tilesIn(o,s,n);l.sort(F);for(var c=[],u=0,h=l;u<h.length;u+=1){var p=h[u];c.push({wrappedTileID:p.tileID.wrapped().key,queryResults:p.tile.queryRenderedFeatures(e,i,t._state,p.queryGeometry,p.cameraQueryGeometry,p.scale,r,a,s,B(t.transform,p.tileID))});}var d=function(t){for(var e={},i={},o=0,r=t;o<r.length;o+=1){var a=r[o],n=a.queryResults,s=a.wrappedTileID,l=i[s]=i[s]||{};for(var c in n)for(var u=n[c],h=l[c]=l[c]||{},p=e[c]=e[c]||[],d=0,_=u;d<_.length;d+=1){var f=_[d];h[f.featureIndex]||(h[f.featureIndex]=!0,p.push(f));}}return e}(c);for(var _ in d)d[_].forEach((function(e){var i=e.feature,o=t.getFeatureState(i.layer[\"source-layer\"],i.id);i.source=i.layer.source,i.layer[\"source-layer\"]&&(i.sourceLayer=i.layer[\"source-layer\"]),i.state=o;}));return d}function F(t,e){var i=t.tileID,o=e.tileID;return i.overscaledZ-o.overscaledZ||i.canonical.y-o.canonical.y||i.wrap-o.wrap||i.canonical.x-o.canonical.x}var U=function(t,e){this.max=t,this.onRemove=e,this.reset();};U.prototype.reset=function(){for(var t in this.data)for(var e=0,i=this.data[t];e<i.length;e+=1){var o=i[e];o.timeout&&clearTimeout(o.timeout),this.onRemove(o.value);}return this.data={},this.order=[],this},U.prototype.add=function(t,e,i){var o=this,r=t.wrapped().key;void 0===this.data[r]&&(this.data[r]=[]);var a={value:e,timeout:void 0};if(void 0!==i&&(a.timeout=setTimeout((function(){o.remove(t,a);}),i)),this.data[r].push(a),this.order.push(r),this.order.length>this.max){var n=this._getAndRemoveByKey(this.order[0]);n&&this.onRemove(n);}return this},U.prototype.has=function(t){return t.wrapped().key in this.data},U.prototype.getAndRemove=function(t){return this.has(t)?this._getAndRemoveByKey(t.wrapped().key):null},U.prototype._getAndRemoveByKey=function(t){var e=this.data[t].shift();return e.timeout&&clearTimeout(e.timeout),0===this.data[t].length&&delete this.data[t],this.order.splice(this.order.indexOf(t),1),e.value},U.prototype.getByKey=function(t){var e=this.data[t];return e?e[0].value:null},U.prototype.get=function(t){return this.has(t)?this.data[t.wrapped().key][0].value:null},U.prototype.remove=function(t,e){if(!this.has(t))return this;var i=t.wrapped().key,o=void 0===e?0:this.data[i].indexOf(e),r=this.data[i][o];return this.data[i].splice(o,1),r.timeout&&clearTimeout(r.timeout),0===this.data[i].length&&delete this.data[i],this.onRemove(r.value),this.order.splice(this.order.indexOf(i),1),this},U.prototype.setMaxSize=function(t){for(this.max=t;this.order.length>this.max;){var e=this._getAndRemoveByKey(this.order[0]);e&&this.onRemove(e);}return this},U.prototype.filter=function(t){var e=[];for(var i in this.data)for(var o=0,r=this.data[i];o<r.length;o+=1){var a=r[o];t(a.value)||e.push(a);}for(var n=0,s=e;n<s.length;n+=1){var l=s[n];this.remove(l.value.tileID,l);}};var N=function(t,e,i){this.context=t;var o=t.gl;this.buffer=o.createBuffer(),this.dynamicDraw=Boolean(i),this.context.unbindVAO(),t.bindElementBuffer.set(this.buffer),o.bufferData(o.ELEMENT_ARRAY_BUFFER,e.arrayBuffer,this.dynamicDraw?o.DYNAMIC_DRAW:o.STATIC_DRAW),this.dynamicDraw||delete e.arrayBuffer;};N.prototype.bind=function(){this.context.bindElementBuffer.set(this.buffer);},N.prototype.updateData=function(t){var e=this.context.gl;this.context.unbindVAO(),this.bind(),e.bufferSubData(e.ELEMENT_ARRAY_BUFFER,0,t.arrayBuffer);},N.prototype.destroy=function(){this.buffer&&(this.context.gl.deleteBuffer(this.buffer),delete this.buffer);};var Z={Int8:\"BYTE\",Uint8:\"UNSIGNED_BYTE\",Int16:\"SHORT\",Uint16:\"UNSIGNED_SHORT\",Int32:\"INT\",Uint32:\"UNSIGNED_INT\",Float32:\"FLOAT\"},q=function(t,e,i,o){this.length=e.length,this.attributes=i,this.itemSize=e.bytesPerElement,this.dynamicDraw=o,this.context=t;var r=t.gl;this.buffer=r.createBuffer(),t.bindVertexBuffer.set(this.buffer),r.bufferData(r.ARRAY_BUFFER,e.arrayBuffer,this.dynamicDraw?r.DYNAMIC_DRAW:r.STATIC_DRAW),this.dynamicDraw||delete e.arrayBuffer;};q.prototype.bind=function(){this.context.bindVertexBuffer.set(this.buffer);},q.prototype.updateData=function(t){var e=this.context.gl;this.bind(),e.bufferSubData(e.ARRAY_BUFFER,0,t.arrayBuffer);},q.prototype.enableAttributes=function(t,e){for(var i=0;i<this.attributes.length;i++){var o=e.attributes[this.attributes[i].name];void 0!==o&&t.enableVertexAttribArray(o);}},q.prototype.setVertexAttribPointers=function(t,e,i){for(var o=0;o<this.attributes.length;o++){var r=this.attributes[o],a=e.attributes[r.name];void 0!==a&&t.vertexAttribPointer(a,r.components,t[Z[r.type]],!1,this.itemSize,r.offset+this.itemSize*(i||0));}},q.prototype.destroy=function(){this.buffer&&(this.context.gl.deleteBuffer(this.buffer),delete this.buffer);};var j=function(t){this.gl=t.gl,this.default=this.getDefault(),this.current=this.default,this.dirty=!1;};j.prototype.get=function(){return this.current},j.prototype.set=function(t){},j.prototype.getDefault=function(){return this.default},j.prototype.setDefault=function(){this.set(this.default);};var V=function(e){function i(){e.apply(this,arguments);}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.getDefault=function(){return t.Color.transparent},i.prototype.set=function(t){var e=this.current;(t.r!==e.r||t.g!==e.g||t.b!==e.b||t.a!==e.a||this.dirty)&&(this.gl.clearColor(t.r,t.g,t.b,t.a),this.current=t,this.dirty=!1);},i}(j),G=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return 1},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.clearDepth(t),this.current=t,this.dirty=!1);},e}(j),W=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return 0},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.clearStencil(t),this.current=t,this.dirty=!1);},e}(j),X=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return [!0,!0,!0,!0]},e.prototype.set=function(t){var e=this.current;(t[0]!==e[0]||t[1]!==e[1]||t[2]!==e[2]||t[3]!==e[3]||this.dirty)&&(this.gl.colorMask(t[0],t[1],t[2],t[3]),this.current=t,this.dirty=!1);},e}(j),H=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return !0},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.depthMask(t),this.current=t,this.dirty=!1);},e}(j),K=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return 255},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.stencilMask(t),this.current=t,this.dirty=!1);},e}(j),Y=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return {func:this.gl.ALWAYS,ref:0,mask:255}},e.prototype.set=function(t){var e=this.current;(t.func!==e.func||t.ref!==e.ref||t.mask!==e.mask||this.dirty)&&(this.gl.stencilFunc(t.func,t.ref,t.mask),this.current=t,this.dirty=!1);},e}(j),J=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){var t=this.gl;return [t.KEEP,t.KEEP,t.KEEP]},e.prototype.set=function(t){var e=this.current;(t[0]!==e[0]||t[1]!==e[1]||t[2]!==e[2]||this.dirty)&&(this.gl.stencilOp(t[0],t[1],t[2]),this.current=t,this.dirty=!1);},e}(j),Q=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return !1},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;t?e.enable(e.STENCIL_TEST):e.disable(e.STENCIL_TEST),this.current=t,this.dirty=!1;}},e}(j),$=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return [0,1]},e.prototype.set=function(t){var e=this.current;(t[0]!==e[0]||t[1]!==e[1]||this.dirty)&&(this.gl.depthRange(t[0],t[1]),this.current=t,this.dirty=!1);},e}(j),tt=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return !1},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;t?e.enable(e.DEPTH_TEST):e.disable(e.DEPTH_TEST),this.current=t,this.dirty=!1;}},e}(j),et=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return this.gl.LESS},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.depthFunc(t),this.current=t,this.dirty=!1);},e}(j),it=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return !1},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;t?e.enable(e.BLEND):e.disable(e.BLEND),this.current=t,this.dirty=!1;}},e}(j),ot=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){var t=this.gl;return [t.ONE,t.ZERO]},e.prototype.set=function(t){var e=this.current;(t[0]!==e[0]||t[1]!==e[1]||this.dirty)&&(this.gl.blendFunc(t[0],t[1]),this.current=t,this.dirty=!1);},e}(j),rt=function(e){function i(){e.apply(this,arguments);}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.getDefault=function(){return t.Color.transparent},i.prototype.set=function(t){var e=this.current;(t.r!==e.r||t.g!==e.g||t.b!==e.b||t.a!==e.a||this.dirty)&&(this.gl.blendColor(t.r,t.g,t.b,t.a),this.current=t,this.dirty=!1);},i}(j),at=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return this.gl.FUNC_ADD},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.blendEquation(t),this.current=t,this.dirty=!1);},e}(j),nt=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return !1},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;t?e.enable(e.CULL_FACE):e.disable(e.CULL_FACE),this.current=t,this.dirty=!1;}},e}(j),st=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return this.gl.BACK},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.cullFace(t),this.current=t,this.dirty=!1);},e}(j),lt=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return this.gl.CCW},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.frontFace(t),this.current=t,this.dirty=!1);},e}(j),ct=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.useProgram(t),this.current=t,this.dirty=!1);},e}(j),ut=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return this.gl.TEXTURE0},e.prototype.set=function(t){(t!==this.current||this.dirty)&&(this.gl.activeTexture(t),this.current=t,this.dirty=!1);},e}(j),ht=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){var t=this.gl;return [0,0,t.drawingBufferWidth,t.drawingBufferHeight]},e.prototype.set=function(t){var e=this.current;(t[0]!==e[0]||t[1]!==e[1]||t[2]!==e[2]||t[3]!==e[3]||this.dirty)&&(this.gl.viewport(t[0],t[1],t[2],t[3]),this.current=t,this.dirty=!1);},e}(j),pt=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.bindFramebuffer(e.FRAMEBUFFER,t),this.current=t,this.dirty=!1;}},e}(j),dt=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.bindRenderbuffer(e.RENDERBUFFER,t),this.current=t,this.dirty=!1;}},e}(j),_t=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.bindTexture(e.TEXTURE_2D,t),this.current=t,this.dirty=!1;}},e}(j),ft=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.bindBuffer(e.ARRAY_BUFFER,t),this.current=t,this.dirty=!1;}},e}(j),mt=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){var e=this.gl;e.bindBuffer(e.ELEMENT_ARRAY_BUFFER,t),this.current=t,this.dirty=!1;},e}(j),gt=function(t){function e(e){t.call(this,e),this.vao=e.extVertexArrayObject;}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e.prototype.set=function(t){this.vao&&(t!==this.current||this.dirty)&&(this.vao.bindVertexArrayOES(t),this.current=t,this.dirty=!1);},e}(j),vt=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return 4},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.pixelStorei(e.UNPACK_ALIGNMENT,t),this.current=t,this.dirty=!1;}},e}(j),yt=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return !1},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.pixelStorei(e.UNPACK_PREMULTIPLY_ALPHA_WEBGL,t),this.current=t,this.dirty=!1;}},e}(j),xt=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return !1},e.prototype.set=function(t){if(t!==this.current||this.dirty){var e=this.gl;e.pixelStorei(e.UNPACK_FLIP_Y_WEBGL,t),this.current=t,this.dirty=!1;}},e}(j),bt=function(t){function e(e,i){t.call(this,e),this.context=e,this.parent=i;}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.getDefault=function(){return null},e}(j),wt=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.setDirty=function(){this.dirty=!0;},e.prototype.set=function(t){if(t!==this.current||this.dirty){this.context.bindFramebuffer.set(this.parent);var e=this.gl;e.framebufferTexture2D(e.FRAMEBUFFER,e.COLOR_ATTACHMENT0,e.TEXTURE_2D,t,0),this.current=t,this.dirty=!1;}},e}(bt),Tt=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.set=function(t){if(t!==this.current||this.dirty){this.context.bindFramebuffer.set(this.parent);var e=this.gl;e.framebufferRenderbuffer(e.FRAMEBUFFER,e.DEPTH_ATTACHMENT,e.RENDERBUFFER,t),this.current=t,this.dirty=!1;}},e}(bt),Et=function(t,e,i,o){this.context=t,this.width=e,this.height=i;var r=this.framebuffer=t.gl.createFramebuffer();this.colorAttachment=new wt(t,r),o&&(this.depthAttachment=new Tt(t,r));};Et.prototype.destroy=function(){var t=this.context.gl,e=this.colorAttachment.get();if(e&&t.deleteTexture(e),this.depthAttachment){var i=this.depthAttachment.get();i&&t.deleteRenderbuffer(i);}t.deleteFramebuffer(this.framebuffer);};var It=function(t,e,i){this.func=t,this.mask=e,this.range=i;};It.ReadOnly=!1,It.ReadWrite=!0,It.disabled=new It(519,It.ReadOnly,[0,1]);var Pt=function(t,e,i,o,r,a){this.test=t,this.ref=e,this.mask=i,this.fail=o,this.depthFail=r,this.pass=a;};Pt.disabled=new Pt({func:519,mask:0},0,0,7680,7680,7680);var St=function(t,e,i){this.blendFunction=t,this.blendColor=e,this.mask=i;};St.disabled=new St(St.Replace=[1,0],t.Color.transparent,[!1,!1,!1,!1]),St.unblended=new St(St.Replace,t.Color.transparent,[!0,!0,!0,!0]),St.alphaBlended=new St([1,771],t.Color.transparent,[!0,!0,!0,!0]);var Ct=function(t,e,i){this.enable=t,this.mode=e,this.frontFace=i;};Ct.disabled=new Ct(!1,1029,2305),Ct.backCCW=new Ct(!0,1029,2305);var zt=function(t){this.gl=t,this.extVertexArrayObject=this.gl.getExtension(\"OES_vertex_array_object\"),this.clearColor=new V(this),this.clearDepth=new G(this),this.clearStencil=new W(this),this.colorMask=new X(this),this.depthMask=new H(this),this.stencilMask=new K(this),this.stencilFunc=new Y(this),this.stencilOp=new J(this),this.stencilTest=new Q(this),this.depthRange=new $(this),this.depthTest=new tt(this),this.depthFunc=new et(this),this.blend=new it(this),this.blendFunc=new ot(this),this.blendColor=new rt(this),this.blendEquation=new at(this),this.cullFace=new nt(this),this.cullFaceSide=new st(this),this.frontFace=new lt(this),this.program=new ct(this),this.activeTexture=new ut(this),this.viewport=new ht(this),this.bindFramebuffer=new pt(this),this.bindRenderbuffer=new dt(this),this.bindTexture=new _t(this),this.bindVertexBuffer=new ft(this),this.bindElementBuffer=new mt(this),this.bindVertexArrayOES=this.extVertexArrayObject&&new gt(this),this.pixelStoreUnpack=new vt(this),this.pixelStoreUnpackPremultiplyAlpha=new yt(this),this.pixelStoreUnpackFlipY=new xt(this),this.extTextureFilterAnisotropic=t.getExtension(\"EXT_texture_filter_anisotropic\")||t.getExtension(\"MOZ_EXT_texture_filter_anisotropic\")||t.getExtension(\"WEBKIT_EXT_texture_filter_anisotropic\"),this.extTextureFilterAnisotropic&&(this.extTextureFilterAnisotropicMax=t.getParameter(this.extTextureFilterAnisotropic.MAX_TEXTURE_MAX_ANISOTROPY_EXT)),this.extTextureHalfFloat=t.getExtension(\"OES_texture_half_float\"),this.extTextureHalfFloat&&(t.getExtension(\"OES_texture_half_float_linear\"),this.extRenderToTextureHalfFloat=t.getExtension(\"EXT_color_buffer_half_float\")),this.extTimerQuery=t.getExtension(\"EXT_disjoint_timer_query\"),this.maxTextureSize=t.getParameter(t.MAX_TEXTURE_SIZE);};zt.prototype.setDefault=function(){this.unbindVAO(),this.clearColor.setDefault(),this.clearDepth.setDefault(),this.clearStencil.setDefault(),this.colorMask.setDefault(),this.depthMask.setDefault(),this.stencilMask.setDefault(),this.stencilFunc.setDefault(),this.stencilOp.setDefault(),this.stencilTest.setDefault(),this.depthRange.setDefault(),this.depthTest.setDefault(),this.depthFunc.setDefault(),this.blend.setDefault(),this.blendFunc.setDefault(),this.blendColor.setDefault(),this.blendEquation.setDefault(),this.cullFace.setDefault(),this.cullFaceSide.setDefault(),this.frontFace.setDefault(),this.program.setDefault(),this.activeTexture.setDefault(),this.bindFramebuffer.setDefault(),this.pixelStoreUnpack.setDefault(),this.pixelStoreUnpackPremultiplyAlpha.setDefault(),this.pixelStoreUnpackFlipY.setDefault();},zt.prototype.setDirty=function(){this.clearColor.dirty=!0,this.clearDepth.dirty=!0,this.clearStencil.dirty=!0,this.colorMask.dirty=!0,this.depthMask.dirty=!0,this.stencilMask.dirty=!0,this.stencilFunc.dirty=!0,this.stencilOp.dirty=!0,this.stencilTest.dirty=!0,this.depthRange.dirty=!0,this.depthTest.dirty=!0,this.depthFunc.dirty=!0,this.blend.dirty=!0,this.blendFunc.dirty=!0,this.blendColor.dirty=!0,this.blendEquation.dirty=!0,this.cullFace.dirty=!0,this.cullFaceSide.dirty=!0,this.frontFace.dirty=!0,this.program.dirty=!0,this.activeTexture.dirty=!0,this.viewport.dirty=!0,this.bindFramebuffer.dirty=!0,this.bindRenderbuffer.dirty=!0,this.bindTexture.dirty=!0,this.bindVertexBuffer.dirty=!0,this.bindElementBuffer.dirty=!0,this.extVertexArrayObject&&(this.bindVertexArrayOES.dirty=!0),this.pixelStoreUnpack.dirty=!0,this.pixelStoreUnpackPremultiplyAlpha.dirty=!0,this.pixelStoreUnpackFlipY.dirty=!0;},zt.prototype.createIndexBuffer=function(t,e){return new N(this,t,e)},zt.prototype.createVertexBuffer=function(t,e,i){return new q(this,t,e,i)},zt.prototype.createRenderbuffer=function(t,e,i){var o=this.gl,r=o.createRenderbuffer();return this.bindRenderbuffer.set(r),o.renderbufferStorage(o.RENDERBUFFER,t,e,i),this.bindRenderbuffer.set(null),r},zt.prototype.createFramebuffer=function(t,e,i){return new Et(this,t,e,i)},zt.prototype.clear=function(t){var e=t.color,i=t.depth,o=this.gl,r=0;e&&(r|=o.COLOR_BUFFER_BIT,this.clearColor.set(e),this.colorMask.set([!0,!0,!0,!0])),void 0!==i&&(r|=o.DEPTH_BUFFER_BIT,this.depthRange.set([0,1]),this.clearDepth.set(i),this.depthMask.set(!0)),o.clear(r);},zt.prototype.setCullFace=function(t){!1===t.enable?this.cullFace.set(!1):(this.cullFace.set(!0),this.cullFaceSide.set(t.mode),this.frontFace.set(t.frontFace));},zt.prototype.setDepthMode=function(t){t.func!==this.gl.ALWAYS||t.mask?(this.depthTest.set(!0),this.depthFunc.set(t.func),this.depthMask.set(t.mask),this.depthRange.set(t.range)):this.depthTest.set(!1);},zt.prototype.setStencilMode=function(t){t.test.func!==this.gl.ALWAYS||t.mask?(this.stencilTest.set(!0),this.stencilMask.set(t.mask),this.stencilOp.set([t.fail,t.depthFail,t.pass]),this.stencilFunc.set({func:t.test.func,ref:t.ref,mask:t.test.mask})):this.stencilTest.set(!1);},zt.prototype.setColorMode=function(e){t.deepEqual(e.blendFunction,St.Replace)?this.blend.set(!1):(this.blend.set(!0),this.blendFunc.set(e.blendFunction),this.blendColor.set(e.blendColor)),this.colorMask.set(e.mask);},zt.prototype.unbindVAO=function(){this.extVertexArrayObject&&this.bindVertexArrayOES.set(null);};var Dt=function(e){function i(i,o,r){var a=this;e.call(this),this.id=i,this.dispatcher=r,this.on(\"data\",(function(t){\"source\"===t.dataType&&\"metadata\"===t.sourceDataType&&(a._sourceLoaded=!0),a._sourceLoaded&&!a._paused&&\"source\"===t.dataType&&\"content\"===t.sourceDataType&&(a.reload(),a.transform&&a.update(a.transform));})),this.on(\"error\",(function(){a._sourceErrored=!0;})),this._source=function(e,i,o,r){var a=new k[i.type](e,i,o,r);if(a.id!==e)throw new Error(\"Expected Source id to be \"+e+\" instead of \"+a.id);return t.bindAll([\"load\",\"abort\",\"unload\",\"serialize\",\"prepare\"],a),a}(i,o,r,this),this._tiles={},this._cache=new U(0,this._unloadTile.bind(this)),this._timers={},this._cacheTimers={},this._maxTileCacheSize=null,this._loadedParentTiles={},this._coveredTiles={},this._state=new t.SourceFeatureState;}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.onAdd=function(t){this.map=t,this._maxTileCacheSize=t?t._maxTileCacheSize:null,this._source&&this._source.onAdd&&this._source.onAdd(t);},i.prototype.onRemove=function(t){this._source&&this._source.onRemove&&this._source.onRemove(t);},i.prototype.loaded=function(){if(this._sourceErrored)return !0;if(!this._sourceLoaded)return !1;if(!this._source.loaded())return !1;for(var t in this._tiles){var e=this._tiles[t];if(\"loaded\"!==e.state&&\"errored\"!==e.state)return !1}return !0},i.prototype.getSource=function(){return this._source},i.prototype.pause=function(){this._paused=!0;},i.prototype.resume=function(){if(this._paused){var t=this._shouldReloadOnResume;this._paused=!1,this._shouldReloadOnResume=!1,t&&this.reload(),this.transform&&this.update(this.transform);}},i.prototype._loadTile=function(t,e){return this._source.loadTile(t,e)},i.prototype._unloadTile=function(t){if(this._source.unloadTile)return this._source.unloadTile(t,(function(){}))},i.prototype._abortTile=function(t){if(this._source.abortTile)return this._source.abortTile(t,(function(){}))},i.prototype.serialize=function(){return this._source.serialize()},i.prototype.prepare=function(t){for(var e in this._source.prepare&&this._source.prepare(),this._state.coalesceChanges(this._tiles,this.map?this.map.painter:null),this._tiles){var i=this._tiles[e];i.upload(t),i.prepare(this.map.style.imageManager);}},i.prototype.getIds=function(){return t.values(this._tiles).map((function(t){return t.tileID})).sort(At).map((function(t){return t.key}))},i.prototype.getRenderableIds=function(e){var i=this,o=[];for(var r in this._tiles)this._isIdRenderable(r,e)&&o.push(this._tiles[r]);return e?o.sort((function(e,o){var r=e.tileID,a=o.tileID,n=new t.Point(r.canonical.x,r.canonical.y)._rotate(i.transform.angle),s=new t.Point(a.canonical.x,a.canonical.y)._rotate(i.transform.angle);return r.overscaledZ-a.overscaledZ||s.y-n.y||s.x-n.x})).map((function(t){return t.tileID.key})):o.map((function(t){return t.tileID})).sort(At).map((function(t){return t.key}))},i.prototype.hasRenderableParent=function(t){var e=this.findLoadedParent(t,0);return !!e&&this._isIdRenderable(e.tileID.key)},i.prototype._isIdRenderable=function(t,e){return this._tiles[t]&&this._tiles[t].hasData()&&!this._coveredTiles[t]&&(e||!this._tiles[t].holdingForFade())},i.prototype.reload=function(){if(this._paused)this._shouldReloadOnResume=!0;else for(var t in this._cache.reset(),this._tiles)\"errored\"!==this._tiles[t].state&&this._reloadTile(t,\"reloading\");},i.prototype._reloadTile=function(t,e){var i=this._tiles[t];i&&(\"loading\"!==i.state&&(i.state=e),this._loadTile(i,this._tileLoaded.bind(this,i,t,e)));},i.prototype._tileLoaded=function(e,i,o,r){if(r)return e.state=\"errored\",void(404!==r.status?this._source.fire(new t.ErrorEvent(r,{tile:e})):this.update(this.transform));e.timeAdded=t.browser.now(),\"expired\"===o&&(e.refreshedUponExpiration=!0),this._setTileReloadTimer(i,e),\"raster-dem\"===this.getSource().type&&e.dem&&this._backfillDEM(e),this._state.initializeTileState(e,this.map?this.map.painter:null),this._source.fire(new t.Event(\"data\",{dataType:\"source\",tile:e,coord:e.tileID}));},i.prototype._backfillDEM=function(t){for(var e=this.getRenderableIds(),i=0;i<e.length;i++){var o=e[i];if(t.neighboringTiles&&t.neighboringTiles[o]){var r=this.getTileByID(o);a(t,r),a(r,t);}}function a(t,e){t.needsHillshadePrepare=!0;var i=e.tileID.canonical.x-t.tileID.canonical.x,o=e.tileID.canonical.y-t.tileID.canonical.y,r=Math.pow(2,t.tileID.canonical.z),a=e.tileID.key;0===i&&0===o||Math.abs(o)>1||(Math.abs(i)>1&&(1===Math.abs(i+r)?i+=r:1===Math.abs(i-r)&&(i-=r)),e.dem&&t.dem&&(t.dem.backfillBorder(e.dem,i,o),t.neighboringTiles&&t.neighboringTiles[a]&&(t.neighboringTiles[a].backfilled=!0)));}},i.prototype.getTile=function(t){return this.getTileByID(t.key)},i.prototype.getTileByID=function(t){return this._tiles[t]},i.prototype._retainLoadedChildren=function(t,e,i,o){for(var r in this._tiles){var a=this._tiles[r];if(!(o[r]||!a.hasData()||a.tileID.overscaledZ<=e||a.tileID.overscaledZ>i)){for(var n=a.tileID;a&&a.tileID.overscaledZ>e+1;){var s=a.tileID.scaledTo(a.tileID.overscaledZ-1);(a=this._tiles[s.key])&&a.hasData()&&(n=s);}for(var l=n;l.overscaledZ>e;)if(t[(l=l.scaledTo(l.overscaledZ-1)).key]){o[n.key]=n;break}}}},i.prototype.findLoadedParent=function(t,e){if(t.key in this._loadedParentTiles){var i=this._loadedParentTiles[t.key];return i&&i.tileID.overscaledZ>=e?i:null}for(var o=t.overscaledZ-1;o>=e;o--){var r=t.scaledTo(o),a=this._getLoadedTile(r);if(a)return a}},i.prototype._getLoadedTile=function(t){var e=this._tiles[t.key];return e&&e.hasData()?e:this._cache.getByKey(t.wrapped().key)},i.prototype.updateCacheSize=function(t){var e=Math.ceil(t.width/this._source.tileSize)+1,i=Math.ceil(t.height/this._source.tileSize)+1,o=Math.floor(e*i*5),r=\"number\"==typeof this._maxTileCacheSize?Math.min(this._maxTileCacheSize,o):o;this._cache.setMaxSize(r);},i.prototype.handleWrapJump=function(t){var e=Math.round((t-(void 0===this._prevLng?t:this._prevLng))/360);if(this._prevLng=t,e){var i={};for(var o in this._tiles){var r=this._tiles[o];r.tileID=r.tileID.unwrapTo(r.tileID.wrap+e),i[r.tileID.key]=r;}for(var a in this._tiles=i,this._timers)clearTimeout(this._timers[a]),delete this._timers[a];for(var n in this._tiles)this._setTileReloadTimer(n,this._tiles[n]);}},i.prototype.update=function(e){var o=this;if(this.transform=e,this._sourceLoaded&&!this._paused){var r;this.updateCacheSize(e),this.handleWrapJump(this.transform.center.lng),this._coveredTiles={},this.used?this._source.tileID?r=e.getVisibleUnwrappedCoordinates(this._source.tileID).map((function(e){return new t.OverscaledTileID(e.canonical.z,e.wrap,e.canonical.z,e.canonical.x,e.canonical.y)})):(r=e.coveringTiles({tileSize:this._source.tileSize,minzoom:this._source.minzoom,maxzoom:this._source.maxzoom,roundZoom:this._source.roundZoom,reparseOverscaled:this._source.reparseOverscaled}),this._source.hasTile&&(r=r.filter((function(t){return o._source.hasTile(t)})))):r=[];var a=e.coveringZoomLevel(this._source),n=Math.max(a-i.maxOverzooming,this._source.minzoom),s=Math.max(a+i.maxUnderzooming,this._source.minzoom),l=this._updateRetainedTiles(r,a);if(Mt(this._source.type)){for(var c={},u={},h=0,p=Object.keys(l);h<p.length;h+=1){var d=p[h],_=l[d],f=this._tiles[d];if(f&&!(f.fadeEndTime&&f.fadeEndTime<=t.browser.now())){var m=this.findLoadedParent(_,n);m&&(this._addTile(m.tileID),c[m.tileID.key]=m.tileID),u[d]=_;}}for(var g in this._retainLoadedChildren(u,a,s,l),c)l[g]||(this._coveredTiles[g]=!0,l[g]=c[g]);}for(var v in l)this._tiles[v].clearFadeHold();for(var y=0,x=t.keysDifference(this._tiles,l);y<x.length;y+=1){var b=x[y],w=this._tiles[b];w.hasSymbolBuckets&&!w.holdingForFade()?w.setHoldDuration(this.map._fadeDuration):w.hasSymbolBuckets&&!w.symbolFadeFinished()||this._removeTile(b);}this._updateLoadedParentTileCache();}},i.prototype.releaseSymbolFadeTiles=function(){for(var t in this._tiles)this._tiles[t].holdingForFade()&&this._removeTile(t);},i.prototype._updateRetainedTiles=function(t,e){for(var o={},r={},a=Math.max(e-i.maxOverzooming,this._source.minzoom),n=Math.max(e+i.maxUnderzooming,this._source.minzoom),s={},l=0,c=t;l<c.length;l+=1){var u=c[l],h=this._addTile(u);o[u.key]=u,h.hasData()||e<this._source.maxzoom&&(s[u.key]=u);}this._retainLoadedChildren(s,e,n,o);for(var p=0,d=t;p<d.length;p+=1){var _=d[p],f=this._tiles[_.key];if(!f.hasData()){if(e+1>this._source.maxzoom){var m=_.children(this._source.maxzoom)[0],g=this.getTile(m);if(g&&g.hasData()){o[m.key]=m;continue}}else {var v=_.children(this._source.maxzoom);if(o[v[0].key]&&o[v[1].key]&&o[v[2].key]&&o[v[3].key])continue}for(var y=f.wasRequested(),x=_.overscaledZ-1;x>=a;--x){var b=_.scaledTo(x);if(r[b.key])break;if(r[b.key]=!0,!(f=this.getTile(b))&&y&&(f=this._addTile(b)),f&&(o[b.key]=b,y=f.wasRequested(),f.hasData()))break}}}return o},i.prototype._updateLoadedParentTileCache=function(){for(var t in this._loadedParentTiles={},this._tiles){for(var e=[],i=void 0,o=this._tiles[t].tileID;o.overscaledZ>0;){if(o.key in this._loadedParentTiles){i=this._loadedParentTiles[o.key];break}e.push(o.key);var r=o.scaledTo(o.overscaledZ-1);if(i=this._getLoadedTile(r))break;o=r;}for(var a=0,n=e;a<n.length;a+=1)this._loadedParentTiles[n[a]]=i;}},i.prototype._addTile=function(e){var i=this._tiles[e.key];if(i)return i;(i=this._cache.getAndRemove(e))&&(this._setTileReloadTimer(e.key,i),i.tileID=e,this._state.initializeTileState(i,this.map?this.map.painter:null),this._cacheTimers[e.key]&&(clearTimeout(this._cacheTimers[e.key]),delete this._cacheTimers[e.key],this._setTileReloadTimer(e.key,i)));var o=Boolean(i);return o||(i=new t.Tile(e,this._source.tileSize*e.overscaleFactor()),this._loadTile(i,this._tileLoaded.bind(this,i,e.key,i.state))),i?(i.uses++,this._tiles[e.key]=i,o||this._source.fire(new t.Event(\"dataloading\",{tile:i,coord:i.tileID,dataType:\"source\"})),i):null},i.prototype._setTileReloadTimer=function(t,e){var i=this;t in this._timers&&(clearTimeout(this._timers[t]),delete this._timers[t]);var o=e.getExpiryTimeout();o&&(this._timers[t]=setTimeout((function(){i._reloadTile(t,\"expired\"),delete i._timers[t];}),o));},i.prototype._removeTile=function(t){var e=this._tiles[t];e&&(e.uses--,delete this._tiles[t],this._timers[t]&&(clearTimeout(this._timers[t]),delete this._timers[t]),e.uses>0||(e.hasData()&&\"reloading\"!==e.state?this._cache.add(e.tileID,e,e.getExpiryTimeout()):(e.aborted=!0,this._abortTile(e),this._unloadTile(e))));},i.prototype.clearTiles=function(){for(var t in this._shouldReloadOnResume=!1,this._paused=!1,this._tiles)this._removeTile(t);this._cache.reset();},i.prototype.tilesIn=function(e,i,o){var r=this,a=[],n=this.transform;if(!n)return a;for(var s=o?n.getCameraQueryGeometry(e):e,l=e.map((function(t){return n.pointCoordinate(t)})),c=s.map((function(t){return n.pointCoordinate(t)})),u=this.getIds(),h=1/0,p=1/0,d=-1/0,_=-1/0,f=0,m=c;f<m.length;f+=1){var g=m[f];h=Math.min(h,g.x),p=Math.min(p,g.y),d=Math.max(d,g.x),_=Math.max(_,g.y);}for(var v=function(e){var o=r._tiles[u[e]];if(!o.holdingForFade()){var s=o.tileID,f=Math.pow(2,n.zoom-o.tileID.overscaledZ),m=i*o.queryPadding*t.EXTENT/o.tileSize/f,g=[s.getTilePoint(new t.MercatorCoordinate(h,p)),s.getTilePoint(new t.MercatorCoordinate(d,_))];if(g[0].x-m<t.EXTENT&&g[0].y-m<t.EXTENT&&g[1].x+m>=0&&g[1].y+m>=0){var v=l.map((function(t){return s.getTilePoint(t)})),y=c.map((function(t){return s.getTilePoint(t)}));a.push({tile:o,tileID:s,queryGeometry:v,cameraQueryGeometry:y,scale:f});}}},y=0;y<u.length;y++)v(y);return a},i.prototype.getVisibleCoordinates=function(t){for(var e=this,i=this.getRenderableIds(t).map((function(t){return e._tiles[t].tileID})),o=0,r=i;o<r.length;o+=1){var a=r[o];a.posMatrix=this.transform.calculatePosMatrix(a.toUnwrapped());}return i},i.prototype.hasTransition=function(){if(this._source.hasTransition())return !0;if(Mt(this._source.type))for(var e in this._tiles){var i=this._tiles[e];if(void 0!==i.fadeEndTime&&i.fadeEndTime>=t.browser.now())return !0}return !1},i.prototype.setFeatureState=function(t,e,i){this._state.updateState(t=t||\"_geojsonTileLayer\",e,i);},i.prototype.removeFeatureState=function(t,e,i){this._state.removeFeatureState(t=t||\"_geojsonTileLayer\",e,i);},i.prototype.getFeatureState=function(t,e){return this._state.getState(t=t||\"_geojsonTileLayer\",e)},i.prototype.setDependencies=function(t,e,i){var o=this._tiles[t];o&&o.setDependencies(e,i);},i.prototype.reloadTilesForDependencies=function(t,e){for(var i in this._tiles)this._tiles[i].hasDependency(t,e)&&this._reloadTile(i,\"reloading\");this._cache.filter((function(i){return !i.hasDependency(t,e)}));},i}(t.Evented);function At(t,e){var i=Math.abs(2*t.wrap)-+(t.wrap<0),o=Math.abs(2*e.wrap)-+(e.wrap<0);return t.overscaledZ-e.overscaledZ||o-i||e.canonical.y-t.canonical.y||e.canonical.x-t.canonical.x}function Mt(t){return \"raster\"===t||\"image\"===t||\"video\"===t}function Lt(){return new t.window.Worker(Kr.workerUrl)}Dt.maxOverzooming=10,Dt.maxUnderzooming=3;var Rt=\"mapboxgl_preloaded_worker_pool\",kt=function(){this.active={};};kt.prototype.acquire=function(t){if(!this.workers)for(this.workers=[];this.workers.length<kt.workerCount;)this.workers.push(new Lt);return this.active[t]=!0,this.workers.slice()},kt.prototype.release=function(t){delete this.active[t],0===this.numActive()&&(this.workers.forEach((function(t){t.terminate();})),this.workers=null);},kt.prototype.isPreloaded=function(){return !!this.active[Rt]},kt.prototype.numActive=function(){return Object.keys(this.active).length};var Bt,Ot=Math.floor(t.browser.hardwareConcurrency/2);function Ft(){return Bt||(Bt=new kt),Bt}function Ut(e,i){var o={};for(var r in e)\"ref\"!==r&&(o[r]=e[r]);return t.refProperties.forEach((function(t){t in i&&(o[t]=i[t]);})),o}function Nt(t){t=t.slice();for(var e=Object.create(null),i=0;i<t.length;i++)e[t[i].id]=t[i];for(var o=0;o<t.length;o++)\"ref\"in t[o]&&(t[o]=Ut(t[o],e[t[o].ref]));return t}kt.workerCount=Math.max(Math.min(Ot,6),1);var Zt={setStyle:\"setStyle\",addLayer:\"addLayer\",removeLayer:\"removeLayer\",setPaintProperty:\"setPaintProperty\",setLayoutProperty:\"setLayoutProperty\",setFilter:\"setFilter\",addSource:\"addSource\",removeSource:\"removeSource\",setGeoJSONSourceData:\"setGeoJSONSourceData\",setLayerZoomRange:\"setLayerZoomRange\",setLayerProperty:\"setLayerProperty\",setCenter:\"setCenter\",setZoom:\"setZoom\",setBearing:\"setBearing\",setPitch:\"setPitch\",setSprite:\"setSprite\",setGlyphs:\"setGlyphs\",setTransition:\"setTransition\",setLight:\"setLight\"};function qt(t,e,i){i.push({command:Zt.addSource,args:[t,e[t]]});}function jt(t,e,i){e.push({command:Zt.removeSource,args:[t]}),i[t]=!0;}function Vt(t,e,i,o){jt(t,i,o),qt(t,e,i);}function Gt(e,i,o){var r;for(r in e[o])if(e[o].hasOwnProperty(r)&&\"data\"!==r&&!t.deepEqual(e[o][r],i[o][r]))return !1;for(r in i[o])if(i[o].hasOwnProperty(r)&&\"data\"!==r&&!t.deepEqual(e[o][r],i[o][r]))return !1;return !0}function Wt(e,i,o,r,a,n){var s;for(s in i=i||{},e=e||{})e.hasOwnProperty(s)&&(t.deepEqual(e[s],i[s])||o.push({command:n,args:[r,s,i[s],a]}));for(s in i)i.hasOwnProperty(s)&&!e.hasOwnProperty(s)&&(t.deepEqual(e[s],i[s])||o.push({command:n,args:[r,s,i[s],a]}));}function Xt(t){return t.id}function Ht(t,e){return t[e.id]=e,t}var Kt=function(t,e){this.reset(t,e);};Kt.prototype.reset=function(t,e){this.points=t||[],this._distances=[0];for(var i=1;i<this.points.length;i++)this._distances[i]=this._distances[i-1]+this.points[i].dist(this.points[i-1]);this.length=this._distances[this._distances.length-1],this.padding=Math.min(e||0,.5*this.length),this.paddedLength=this.length-2*this.padding;},Kt.prototype.lerp=function(e){if(1===this.points.length)return this.points[0];e=t.clamp(e,0,1);for(var i=1,o=this._distances[i],r=e*this.paddedLength+this.padding;o<r&&i<this._distances.length;)o=this._distances[++i];var a=i-1,n=this._distances[a],s=o-n,l=s>0?(r-n)/s:0;return this.points[a].mult(1-l).add(this.points[i].mult(l))};var Yt=function(t,e,i){var o=this.boxCells=[],r=this.circleCells=[];this.xCellCount=Math.ceil(t/i),this.yCellCount=Math.ceil(e/i);for(var a=0;a<this.xCellCount*this.yCellCount;a++)o.push([]),r.push([]);this.circleKeys=[],this.boxKeys=[],this.bboxes=[],this.circles=[],this.width=t,this.height=e,this.xScale=this.xCellCount/t,this.yScale=this.yCellCount/e,this.boxUid=0,this.circleUid=0;};function Jt(e,i,o,r,a){var n=t.create();return i?(t.scale(n,n,[1/a,1/a,1]),o||t.rotateZ(n,n,r.angle)):t.multiply(n,r.labelPlaneMatrix,e),n}function Qt(e,i,o,r,a){if(i){var n=t.clone(e);return t.scale(n,n,[a,a,1]),o||t.rotateZ(n,n,-r.angle),n}return r.glCoordMatrix}function $t(e,i){var o=[e.x,e.y,0,1];ue(o,o,i);var r=o[3];return {point:new t.Point(o[0]/r,o[1]/r),signedDistanceFromCamera:r}}function te(t,e){return .5+t/e*.5}function ee(t,e){var i=t[0]/t[3],o=t[1]/t[3];return i>=-e[0]&&i<=e[0]&&o>=-e[1]&&o<=e[1]}function ie(e,i,o,r,a,n,s,l){var c=r?e.textSizeData:e.iconSizeData,u=t.evaluateSizeForZoom(c,o.transform.zoom),h=[256/o.width*2+1,256/o.height*2+1],p=r?e.text.dynamicLayoutVertexArray:e.icon.dynamicLayoutVertexArray;p.clear();for(var d=e.lineVertexArray,_=r?e.text.placedSymbolArray:e.icon.placedSymbolArray,f=o.transform.width/o.transform.height,m=!1,g=0;g<_.length;g++){var v=_.get(g);if(v.hidden||v.writingMode===t.WritingMode.vertical&&!m)ce(v.numGlyphs,p);else {m=!1;var y=[v.anchorX,v.anchorY,0,1];if(t.transformMat4(y,y,i),ee(y,h)){var x=te(o.transform.cameraToCenterDistance,y[3]),b=t.evaluateSizeForFeature(c,u,v),w=s?b/x:b*x,T=new t.Point(v.anchorX,v.anchorY),E=$t(T,a).point,I={},P=ae(v,w,!1,l,i,a,n,e.glyphOffsetArray,d,p,E,T,I,f);m=P.useVertical,(P.notEnoughRoom||m||P.needsFlipping&&ae(v,w,!0,l,i,a,n,e.glyphOffsetArray,d,p,E,T,I,f).notEnoughRoom)&&ce(v.numGlyphs,p);}else ce(v.numGlyphs,p);}}r?e.text.dynamicLayoutVertexBuffer.updateData(p):e.icon.dynamicLayoutVertexBuffer.updateData(p);}function oe(t,e,i,o,r,a,n,s,l,c,u){var h=s.glyphStartIndex+s.numGlyphs,p=s.lineStartIndex,d=s.lineStartIndex+s.lineLength,_=e.getoffsetX(s.glyphStartIndex),f=e.getoffsetX(h-1),m=se(t*_,i,o,r,a,n,s.segment,p,d,l,c,u);if(!m)return null;var g=se(t*f,i,o,r,a,n,s.segment,p,d,l,c,u);return g?{first:m,last:g}:null}function re(e,i,o,r){return e===t.WritingMode.horizontal&&Math.abs(o.y-i.y)>Math.abs(o.x-i.x)*r?{useVertical:!0}:(e===t.WritingMode.vertical?i.y<o.y:i.x>o.x)?{needsFlipping:!0}:null}function ae(e,i,o,r,a,n,s,l,c,u,h,p,d,_){var f,m=i/24,g=e.lineOffsetX*m,v=e.lineOffsetY*m;if(e.numGlyphs>1){var y=e.glyphStartIndex+e.numGlyphs,x=e.lineStartIndex,b=e.lineStartIndex+e.lineLength,w=oe(m,l,g,v,o,h,p,e,c,n,d);if(!w)return {notEnoughRoom:!0};var T=$t(w.first.point,s).point,E=$t(w.last.point,s).point;if(r&&!o){var I=re(e.writingMode,T,E,_);if(I)return I}f=[w.first];for(var P=e.glyphStartIndex+1;P<y-1;P++)f.push(se(m*l.getoffsetX(P),g,v,o,h,p,e.segment,x,b,c,n,d));f.push(w.last);}else {if(r&&!o){var S=$t(p,a).point,C=e.lineStartIndex+e.segment+1,z=new t.Point(c.getx(C),c.gety(C)),D=$t(z,a),A=D.signedDistanceFromCamera>0?D.point:ne(p,z,S,1,a),M=re(e.writingMode,S,A,_);if(M)return M}var L=se(m*l.getoffsetX(e.glyphStartIndex),g,v,o,h,p,e.segment,e.lineStartIndex,e.lineStartIndex+e.lineLength,c,n,d);if(!L)return {notEnoughRoom:!0};f=[L];}for(var R=0,k=f;R<k.length;R+=1){var B=k[R];t.addDynamicAttributes(u,B.point,B.angle);}return {}}function ne(t,e,i,o,r){var a=$t(t.add(t.sub(e)._unit()),r).point,n=i.sub(a);return i.add(n._mult(o/n.mag()))}function se(e,i,o,r,a,n,s,l,c,u,h,p){var d=r?e-i:e+i,_=d>0?1:-1,f=0;r&&(_*=-1,f=Math.PI),_<0&&(f+=Math.PI);for(var m=_>0?l+s:l+s+1,g=a,v=a,y=0,x=0,b=Math.abs(d),w=[];y+x<=b;){if((m+=_)<l||m>=c)return null;if(v=g,w.push(g),void 0===(g=p[m])){var T=new t.Point(u.getx(m),u.gety(m)),E=$t(T,h);if(E.signedDistanceFromCamera>0)g=p[m]=E.point;else {var I=m-_;g=ne(0===y?n:new t.Point(u.getx(I),u.gety(I)),T,v,b-y+1,h);}}y+=x,x=v.dist(g);}var P=(b-y)/x,S=g.sub(v),C=S.mult(P)._add(v);C._add(S._unit()._perp()._mult(o*_));var z=f+Math.atan2(g.y-v.y,g.x-v.x);return w.push(C),{point:C,angle:z,path:w}}Yt.prototype.keysLength=function(){return this.boxKeys.length+this.circleKeys.length},Yt.prototype.insert=function(t,e,i,o,r){this._forEachCell(e,i,o,r,this._insertBoxCell,this.boxUid++),this.boxKeys.push(t),this.bboxes.push(e),this.bboxes.push(i),this.bboxes.push(o),this.bboxes.push(r);},Yt.prototype.insertCircle=function(t,e,i,o){this._forEachCell(e-o,i-o,e+o,i+o,this._insertCircleCell,this.circleUid++),this.circleKeys.push(t),this.circles.push(e),this.circles.push(i),this.circles.push(o);},Yt.prototype._insertBoxCell=function(t,e,i,o,r,a){this.boxCells[r].push(a);},Yt.prototype._insertCircleCell=function(t,e,i,o,r,a){this.circleCells[r].push(a);},Yt.prototype._query=function(t,e,i,o,r,a){if(i<0||t>this.width||o<0||e>this.height)return !r&&[];var n=[];if(t<=0&&e<=0&&this.width<=i&&this.height<=o){if(r)return !0;for(var s=0;s<this.boxKeys.length;s++)n.push({key:this.boxKeys[s],x1:this.bboxes[4*s],y1:this.bboxes[4*s+1],x2:this.bboxes[4*s+2],y2:this.bboxes[4*s+3]});for(var l=0;l<this.circleKeys.length;l++){var c=this.circles[3*l],u=this.circles[3*l+1],h=this.circles[3*l+2];n.push({key:this.circleKeys[l],x1:c-h,y1:u-h,x2:c+h,y2:u+h});}return a?n.filter(a):n}return this._forEachCell(t,e,i,o,this._queryCell,n,{hitTest:r,seenUids:{box:{},circle:{}}},a),r?n.length>0:n},Yt.prototype._queryCircle=function(t,e,i,o,r){var a=t-i,n=t+i,s=e-i,l=e+i;if(n<0||a>this.width||l<0||s>this.height)return !o&&[];var c=[];return this._forEachCell(a,s,n,l,this._queryCellCircle,c,{hitTest:o,circle:{x:t,y:e,radius:i},seenUids:{box:{},circle:{}}},r),o?c.length>0:c},Yt.prototype.query=function(t,e,i,o,r){return this._query(t,e,i,o,!1,r)},Yt.prototype.hitTest=function(t,e,i,o,r){return this._query(t,e,i,o,!0,r)},Yt.prototype.hitTestCircle=function(t,e,i,o){return this._queryCircle(t,e,i,!0,o)},Yt.prototype._queryCell=function(t,e,i,o,r,a,n,s){var l=n.seenUids,c=this.boxCells[r];if(null!==c)for(var u=this.bboxes,h=0,p=c;h<p.length;h+=1){var d=p[h];if(!l.box[d]){l.box[d]=!0;var _=4*d;if(t<=u[_+2]&&e<=u[_+3]&&i>=u[_+0]&&o>=u[_+1]&&(!s||s(this.boxKeys[d]))){if(n.hitTest)return a.push(!0),!0;a.push({key:this.boxKeys[d],x1:u[_],y1:u[_+1],x2:u[_+2],y2:u[_+3]});}}}var f=this.circleCells[r];if(null!==f)for(var m=this.circles,g=0,v=f;g<v.length;g+=1){var y=v[g];if(!l.circle[y]){l.circle[y]=!0;var x=3*y;if(this._circleAndRectCollide(m[x],m[x+1],m[x+2],t,e,i,o)&&(!s||s(this.circleKeys[y]))){if(n.hitTest)return a.push(!0),!0;var b=m[x],w=m[x+1],T=m[x+2];a.push({key:this.circleKeys[y],x1:b-T,y1:w-T,x2:b+T,y2:w+T});}}}},Yt.prototype._queryCellCircle=function(t,e,i,o,r,a,n,s){var l=n.circle,c=n.seenUids,u=this.boxCells[r];if(null!==u)for(var h=this.bboxes,p=0,d=u;p<d.length;p+=1){var _=d[p];if(!c.box[_]){c.box[_]=!0;var f=4*_;if(this._circleAndRectCollide(l.x,l.y,l.radius,h[f+0],h[f+1],h[f+2],h[f+3])&&(!s||s(this.boxKeys[_])))return a.push(!0),!0}}var m=this.circleCells[r];if(null!==m)for(var g=this.circles,v=0,y=m;v<y.length;v+=1){var x=y[v];if(!c.circle[x]){c.circle[x]=!0;var b=3*x;if(this._circlesCollide(g[b],g[b+1],g[b+2],l.x,l.y,l.radius)&&(!s||s(this.circleKeys[x])))return a.push(!0),!0}}},Yt.prototype._forEachCell=function(t,e,i,o,r,a,n,s){for(var l=this._convertToXCellCoord(t),c=this._convertToYCellCoord(e),u=this._convertToXCellCoord(i),h=this._convertToYCellCoord(o),p=l;p<=u;p++)for(var d=c;d<=h;d++)if(r.call(this,t,e,i,o,this.xCellCount*d+p,a,n,s))return},Yt.prototype._convertToXCellCoord=function(t){return Math.max(0,Math.min(this.xCellCount-1,Math.floor(t*this.xScale)))},Yt.prototype._convertToYCellCoord=function(t){return Math.max(0,Math.min(this.yCellCount-1,Math.floor(t*this.yScale)))},Yt.prototype._circlesCollide=function(t,e,i,o,r,a){var n=o-t,s=r-e,l=i+a;return l*l>n*n+s*s},Yt.prototype._circleAndRectCollide=function(t,e,i,o,r,a,n){var s=(a-o)/2,l=Math.abs(t-(o+s));if(l>s+i)return !1;var c=(n-r)/2,u=Math.abs(e-(r+c));if(u>c+i)return !1;if(l<=s||u<=c)return !0;var h=l-s,p=u-c;return h*h+p*p<=i*i};var le=new Float32Array([-1/0,-1/0,0,-1/0,-1/0,0,-1/0,-1/0,0,-1/0,-1/0,0]);function ce(t,e){for(var i=0;i<t;i++){var o=e.length;e.resize(o+4),e.float32.set(le,3*o);}}function ue(t,e,i){var o=e[0],r=e[1];return t[0]=i[0]*o+i[4]*r+i[12],t[1]=i[1]*o+i[5]*r+i[13],t[3]=i[3]*o+i[7]*r+i[15],t}var he=function(t,e,i){void 0===e&&(e=new Yt(t.width+200,t.height+200,25)),void 0===i&&(i=new Yt(t.width+200,t.height+200,25)),this.transform=t,this.grid=e,this.ignoredGrid=i,this.pitchfactor=Math.cos(t._pitch)*t.cameraToCenterDistance,this.screenRightBoundary=t.width+100,this.screenBottomBoundary=t.height+100,this.gridRightBoundary=t.width+200,this.gridBottomBoundary=t.height+200;};function pe(e,i,o){return i*(t.EXTENT/(e.tileSize*Math.pow(2,o-e.tileID.overscaledZ)))}he.prototype.placeCollisionBox=function(t,e,i,o,r){var a=this.projectAndGetPerspectiveRatio(o,t.anchorPointX,t.anchorPointY),n=i*a.perspectiveRatio,s=t.x1*n+a.point.x,l=t.y1*n+a.point.y,c=t.x2*n+a.point.x,u=t.y2*n+a.point.y;return !this.isInsideGrid(s,l,c,u)||!e&&this.grid.hitTest(s,l,c,u,r)?{box:[],offscreen:!1}:{box:[s,l,c,u],offscreen:this.isOffscreen(s,l,c,u)}},he.prototype.placeCollisionCircles=function(e,i,o,r,a,n,s,l,c,u,h,p,d){var _=[],f=new t.Point(i.anchorX,i.anchorY),m=$t(f,n),g=te(this.transform.cameraToCenterDistance,m.signedDistanceFromCamera),v=(u?a/g:a*g)/t.ONE_EM,y=$t(f,s).point,x=oe(v,r,i.lineOffsetX*v,i.lineOffsetY*v,!1,y,f,i,o,s,{}),b=!1,w=!1,T=!0;if(x){for(var E=.5*p*g+d,I=new t.Point(-100,-100),P=new t.Point(this.screenRightBoundary,this.screenBottomBoundary),S=new Kt,C=x.first,z=x.last,D=[],A=C.path.length-1;A>=1;A--)D.push(C.path[A]);for(var M=1;M<z.path.length;M++)D.push(z.path[M]);var L=2.5*E;if(l){var R=D.map((function(t){return $t(t,l)}));D=R.some((function(t){return t.signedDistanceFromCamera<=0}))?[]:R.map((function(t){return t.point}));}var k=[];if(D.length>0){for(var B=D[0].clone(),O=D[0].clone(),F=1;F<D.length;F++)B.x=Math.min(B.x,D[F].x),B.y=Math.min(B.y,D[F].y),O.x=Math.max(O.x,D[F].x),O.y=Math.max(O.y,D[F].y);k=B.x>=I.x&&O.x<=P.x&&B.y>=I.y&&O.y<=P.y?[D]:O.x<I.x||B.x>P.x||O.y<I.y||B.y>P.y?[]:t.clipLine([D],I.x,I.y,P.x,P.y);}for(var U=0,N=k;U<N.length;U+=1){var Z;S.reset(N[U],.25*E),Z=S.length<=.5*E?1:Math.ceil(S.paddedLength/L)+1;for(var q=0;q<Z;q++){var j=q/Math.max(Z-1,1),V=S.lerp(j),G=V.x+100,W=V.y+100;_.push(G,W,E,0);var X=G-E,H=W-E,K=G+E,Y=W+E;if(T=T&&this.isOffscreen(X,H,K,Y),w=w||this.isInsideGrid(X,H,K,Y),!e&&this.grid.hitTestCircle(G,W,E,h)&&(b=!0,!c))return {circles:[],offscreen:!1,collisionDetected:b}}}}return {circles:!c&&b||!w?[]:_,offscreen:T,collisionDetected:b}},he.prototype.queryRenderedSymbols=function(e){if(0===e.length||0===this.grid.keysLength()&&0===this.ignoredGrid.keysLength())return {};for(var i=[],o=1/0,r=1/0,a=-1/0,n=-1/0,s=0,l=e;s<l.length;s+=1){var c=l[s],u=new t.Point(c.x+100,c.y+100);o=Math.min(o,u.x),r=Math.min(r,u.y),a=Math.max(a,u.x),n=Math.max(n,u.y),i.push(u);}for(var h={},p={},d=0,_=this.grid.query(o,r,a,n).concat(this.ignoredGrid.query(o,r,a,n));d<_.length;d+=1){var f=_[d],m=f.key;if(void 0===h[m.bucketInstanceId]&&(h[m.bucketInstanceId]={}),!h[m.bucketInstanceId][m.featureIndex]){var g=[new t.Point(f.x1,f.y1),new t.Point(f.x2,f.y1),new t.Point(f.x2,f.y2),new t.Point(f.x1,f.y2)];t.polygonIntersectsPolygon(i,g)&&(h[m.bucketInstanceId][m.featureIndex]=!0,void 0===p[m.bucketInstanceId]&&(p[m.bucketInstanceId]=[]),p[m.bucketInstanceId].push(m.featureIndex));}}return p},he.prototype.insertCollisionBox=function(t,e,i,o,r){(e?this.ignoredGrid:this.grid).insert({bucketInstanceId:i,featureIndex:o,collisionGroupID:r},t[0],t[1],t[2],t[3]);},he.prototype.insertCollisionCircles=function(t,e,i,o,r){for(var a=e?this.ignoredGrid:this.grid,n={bucketInstanceId:i,featureIndex:o,collisionGroupID:r},s=0;s<t.length;s+=4)a.insertCircle(n,t[s],t[s+1],t[s+2]);},he.prototype.projectAndGetPerspectiveRatio=function(e,i,o){var r=[i,o,0,1];return ue(r,r,e),{point:new t.Point((r[0]/r[3]+1)/2*this.transform.width+100,(-r[1]/r[3]+1)/2*this.transform.height+100),perspectiveRatio:.5+this.transform.cameraToCenterDistance/r[3]*.5}},he.prototype.isOffscreen=function(t,e,i,o){return i<100||t>=this.screenRightBoundary||o<100||e>this.screenBottomBoundary},he.prototype.isInsideGrid=function(t,e,i,o){return i>=0&&t<this.gridRightBoundary&&o>=0&&e<this.gridBottomBoundary},he.prototype.getViewportMatrix=function(){var e=t.identity([]);return t.translate(e,e,[-100,-100,0]),e};var de=function(t,e,i,o){this.opacity=t?Math.max(0,Math.min(1,t.opacity+(t.placed?e:-e))):o&&i?1:0,this.placed=i;};de.prototype.isHidden=function(){return 0===this.opacity&&!this.placed};var _e=function(t,e,i,o,r){this.text=new de(t?t.text:null,e,i,r),this.icon=new de(t?t.icon:null,e,o,r);};_e.prototype.isHidden=function(){return this.text.isHidden()&&this.icon.isHidden()};var fe=function(t,e,i){this.text=t,this.icon=e,this.skipFade=i;},me=function(){this.invProjMatrix=t.create(),this.viewportMatrix=t.create(),this.circles=[];},ge=function(t,e,i,o,r){this.bucketInstanceId=t,this.featureIndex=e,this.sourceLayerIndex=i,this.bucketIndex=o,this.tileID=r;},ve=function(t){this.crossSourceCollisions=t,this.maxGroupID=0,this.collisionGroups={};};function ye(e,i,o,r,a){var n=t.getAnchorAlignment(e),s=-(n.horizontalAlign-.5)*i,l=-(n.verticalAlign-.5)*o,c=t.evaluateVariableOffset(e,r);return new t.Point(s+c[0]*a,l+c[1]*a)}function xe(e,i,o,r,a,n){var s=e.x1,l=e.x2,c=e.y1,u=e.y2,h=e.anchorPointX,p=e.anchorPointY,d=new t.Point(i,o);return r&&d._rotate(a?n:-n),{x1:s+d.x,y1:c+d.y,x2:l+d.x,y2:u+d.y,anchorPointX:h,anchorPointY:p}}ve.prototype.get=function(t){if(this.crossSourceCollisions)return {ID:0,predicate:null};if(!this.collisionGroups[t]){var e=++this.maxGroupID;this.collisionGroups[t]={ID:e,predicate:function(t){return t.collisionGroupID===e}};}return this.collisionGroups[t]};var be=function(t,e,i,o){this.transform=t.clone(),this.collisionIndex=new he(this.transform),this.placements={},this.opacities={},this.variableOffsets={},this.stale=!1,this.commitTime=0,this.fadeDuration=e,this.retainedQueryData={},this.collisionGroups=new ve(i),this.collisionCircleArrays={},this.prevPlacement=o,o&&(o.prevPlacement=void 0),this.placedOrientations={};};function we(t,e,i,o,r){t.emplaceBack(e?1:0,i?1:0,o||0,r||0),t.emplaceBack(e?1:0,i?1:0,o||0,r||0),t.emplaceBack(e?1:0,i?1:0,o||0,r||0),t.emplaceBack(e?1:0,i?1:0,o||0,r||0);}be.prototype.getBucketParts=function(e,i,o,r){var a=o.getBucket(i),n=o.latestFeatureIndex;if(a&&n&&i.id===a.layerIds[0]){var s=o.collisionBoxArray,l=a.layers[0].layout,c=Math.pow(2,this.transform.zoom-o.tileID.overscaledZ),u=o.tileSize/t.EXTENT,h=this.transform.calculatePosMatrix(o.tileID.toUnwrapped()),p=\"map\"===l.get(\"text-pitch-alignment\"),d=\"map\"===l.get(\"text-rotation-alignment\"),_=pe(o,1,this.transform.zoom),f=Jt(h,p,d,this.transform,_),m=null;if(p){var g=Qt(h,p,d,this.transform,_);m=t.multiply([],this.transform.labelPlaneMatrix,g);}this.retainedQueryData[a.bucketInstanceId]=new ge(a.bucketInstanceId,n,a.sourceLayerIndex,a.index,o.tileID);var v={bucket:a,layout:l,posMatrix:h,textLabelPlaneMatrix:f,labelToScreenMatrix:m,scale:c,textPixelRatio:u,holdingForFade:o.holdingForFade(),collisionBoxArray:s,partiallyEvaluatedTextSize:t.evaluateSizeForZoom(a.textSizeData,this.transform.zoom),collisionGroup:this.collisionGroups.get(a.sourceID)};if(r)for(var y=0,x=a.sortKeyRanges;y<x.length;y+=1){var b=x[y];e.push({sortKey:b.sortKey,symbolInstanceStart:b.symbolInstanceStart,symbolInstanceEnd:b.symbolInstanceEnd,parameters:v});}else e.push({symbolInstanceStart:0,symbolInstanceEnd:a.symbolInstances.length,parameters:v});}},be.prototype.attemptAnchorPlacement=function(t,e,i,o,r,a,n,s,l,c,u,h,p,d,_){var f,m=[h.textOffset0,h.textOffset1],g=ye(t,i,o,m,r),v=this.collisionIndex.placeCollisionBox(xe(e,g.x,g.y,a,n,this.transform.angle),u,s,l,c.predicate);if(!_||0!==this.collisionIndex.placeCollisionBox(xe(_,g.x,g.y,a,n,this.transform.angle),u,s,l,c.predicate).box.length)return v.box.length>0?(this.prevPlacement&&this.prevPlacement.variableOffsets[h.crossTileID]&&this.prevPlacement.placements[h.crossTileID]&&this.prevPlacement.placements[h.crossTileID].text&&(f=this.prevPlacement.variableOffsets[h.crossTileID].anchor),this.variableOffsets[h.crossTileID]={textOffset:m,width:i,height:o,anchor:t,textBoxScale:r,prevAnchor:f},this.markUsedJustification(p,t,h,d),p.allowVerticalPlacement&&(this.markUsedOrientation(p,d,h),this.placedOrientations[h.crossTileID]=d),{shift:g,placedGlyphBoxes:v}):void 0},be.prototype.placeLayerBucketPart=function(e,i,o){var r=this,a=e.parameters,n=a.bucket,s=a.layout,l=a.posMatrix,c=a.textLabelPlaneMatrix,u=a.labelToScreenMatrix,h=a.textPixelRatio,p=a.holdingForFade,d=a.collisionBoxArray,_=a.partiallyEvaluatedTextSize,f=a.collisionGroup,m=s.get(\"text-optional\"),g=s.get(\"icon-optional\"),v=s.get(\"text-allow-overlap\"),y=s.get(\"icon-allow-overlap\"),x=\"map\"===s.get(\"text-rotation-alignment\"),b=\"map\"===s.get(\"text-pitch-alignment\"),w=\"none\"!==s.get(\"icon-text-fit\"),T=\"viewport-y\"===s.get(\"symbol-z-order\"),E=v&&(y||!n.hasIconData()||g),I=y&&(v||!n.hasTextData()||m);!n.collisionArrays&&d&&n.deserializeCollisionBoxes(d);var P=function(e,a){if(!i[e.crossTileID])if(p)r.placements[e.crossTileID]=new fe(!1,!1,!1);else {var d,T=!1,P=!1,S=!0,C=null,z={box:null,offscreen:null},D={box:null,offscreen:null},A=null,M=null,L=0,R=0,k=0;a.textFeatureIndex?L=a.textFeatureIndex:e.useRuntimeCollisionCircles&&(L=e.featureIndex),a.verticalTextFeatureIndex&&(R=a.verticalTextFeatureIndex);var B=a.textBox;if(B){var O=function(i){var o=t.WritingMode.horizontal;if(n.allowVerticalPlacement&&!i&&r.prevPlacement){var a=r.prevPlacement.placedOrientations[e.crossTileID];a&&(r.placedOrientations[e.crossTileID]=a,r.markUsedOrientation(n,o=a,e));}return o},F=function(i,o){if(n.allowVerticalPlacement&&e.numVerticalGlyphVertices>0&&a.verticalTextBox)for(var r=0,s=n.writingModes;r<s.length&&(s[r]===t.WritingMode.vertical?(z=o(),D=z):z=i(),!(z&&z.box&&z.box.length));r+=1);else z=i();};if(s.get(\"text-variable-anchor\")){var U=s.get(\"text-variable-anchor\");if(r.prevPlacement&&r.prevPlacement.variableOffsets[e.crossTileID]){var N=r.prevPlacement.variableOffsets[e.crossTileID];U.indexOf(N.anchor)>0&&(U=U.filter((function(t){return t!==N.anchor}))).unshift(N.anchor);}var Z=function(t,i,o){for(var a=t.x2-t.x1,s=t.y2-t.y1,c=e.textBoxScale,u=w&&!y?i:null,p={box:[],offscreen:!1},d=v?2*U.length:U.length,_=0;_<d;++_){var m=r.attemptAnchorPlacement(U[_%U.length],t,a,s,c,x,b,h,l,f,_>=U.length,e,n,o,u);if(m&&(p=m.placedGlyphBoxes)&&p.box&&p.box.length){T=!0,C=m.shift;break}}return p};F((function(){return Z(B,a.iconBox,t.WritingMode.horizontal)}),(function(){var i=a.verticalTextBox;return n.allowVerticalPlacement&&!(z&&z.box&&z.box.length)&&e.numVerticalGlyphVertices>0&&i?Z(i,a.verticalIconBox,t.WritingMode.vertical):{box:null,offscreen:null}})),z&&(T=z.box,S=z.offscreen);var q=O(z&&z.box);if(!T&&r.prevPlacement){var j=r.prevPlacement.variableOffsets[e.crossTileID];j&&(r.variableOffsets[e.crossTileID]=j,r.markUsedJustification(n,j.anchor,e,q));}}else {var V=function(t,i){var o=r.collisionIndex.placeCollisionBox(t,v,h,l,f.predicate);return o&&o.box&&o.box.length&&(r.markUsedOrientation(n,i,e),r.placedOrientations[e.crossTileID]=i),o};F((function(){return V(B,t.WritingMode.horizontal)}),(function(){var i=a.verticalTextBox;return n.allowVerticalPlacement&&e.numVerticalGlyphVertices>0&&i?V(i,t.WritingMode.vertical):{box:null,offscreen:null}})),O(z&&z.box&&z.box.length);}}if(T=(d=z)&&d.box&&d.box.length>0,S=d&&d.offscreen,e.useRuntimeCollisionCircles){var G=n.text.placedSymbolArray.get(e.centerJustifiedTextSymbolIndex),W=t.evaluateSizeForFeature(n.textSizeData,_,G),X=s.get(\"text-padding\");A=r.collisionIndex.placeCollisionCircles(v,G,n.lineVertexArray,n.glyphOffsetArray,W,l,c,u,o,b,f.predicate,e.collisionCircleDiameter,X),T=v||A.circles.length>0&&!A.collisionDetected,S=S&&A.offscreen;}if(a.iconFeatureIndex&&(k=a.iconFeatureIndex),a.iconBox){var H=function(t){var e=w&&C?xe(t,C.x,C.y,x,b,r.transform.angle):t;return r.collisionIndex.placeCollisionBox(e,y,h,l,f.predicate)};P=D&&D.box&&D.box.length&&a.verticalIconBox?(M=H(a.verticalIconBox)).box.length>0:(M=H(a.iconBox)).box.length>0,S=S&&M.offscreen;}var K=m||0===e.numHorizontalGlyphVertices&&0===e.numVerticalGlyphVertices,Y=g||0===e.numIconVertices;if(K||Y?Y?K||(P=P&&T):T=P&&T:P=T=P&&T,T&&d&&d.box&&r.collisionIndex.insertCollisionBox(d.box,s.get(\"text-ignore-placement\"),n.bucketInstanceId,D&&D.box&&R?R:L,f.ID),P&&M&&r.collisionIndex.insertCollisionBox(M.box,s.get(\"icon-ignore-placement\"),n.bucketInstanceId,k,f.ID),A&&(T&&r.collisionIndex.insertCollisionCircles(A.circles,s.get(\"text-ignore-placement\"),n.bucketInstanceId,L,f.ID),o)){var J=n.bucketInstanceId,Q=r.collisionCircleArrays[J];void 0===Q&&(Q=r.collisionCircleArrays[J]=new me);for(var $=0;$<A.circles.length;$+=4)Q.circles.push(A.circles[$+0]),Q.circles.push(A.circles[$+1]),Q.circles.push(A.circles[$+2]),Q.circles.push(A.collisionDetected?1:0);}r.placements[e.crossTileID]=new fe(T||E,P||I,S||n.justReloaded),i[e.crossTileID]=!0;}};if(T)for(var S=n.getSortedSymbolIndexes(this.transform.angle),C=S.length-1;C>=0;--C){var z=S[C];P(n.symbolInstances.get(z),n.collisionArrays[z]);}else for(var D=e.symbolInstanceStart;D<e.symbolInstanceEnd;D++)P(n.symbolInstances.get(D),n.collisionArrays[D]);if(o&&n.bucketInstanceId in this.collisionCircleArrays){var A=this.collisionCircleArrays[n.bucketInstanceId];t.invert(A.invProjMatrix,l),A.viewportMatrix=this.collisionIndex.getViewportMatrix();}n.justReloaded=!1;},be.prototype.markUsedJustification=function(e,i,o,r){var a;a=r===t.WritingMode.vertical?o.verticalPlacedTextSymbolIndex:{left:o.leftJustifiedTextSymbolIndex,center:o.centerJustifiedTextSymbolIndex,right:o.rightJustifiedTextSymbolIndex}[t.getAnchorJustification(i)];for(var n=0,s=[o.leftJustifiedTextSymbolIndex,o.centerJustifiedTextSymbolIndex,o.rightJustifiedTextSymbolIndex,o.verticalPlacedTextSymbolIndex];n<s.length;n+=1){var l=s[n];l>=0&&(e.text.placedSymbolArray.get(l).crossTileID=a>=0&&l!==a?0:o.crossTileID);}},be.prototype.markUsedOrientation=function(e,i,o){for(var r=i===t.WritingMode.horizontal||i===t.WritingMode.horizontalOnly?i:0,a=i===t.WritingMode.vertical?i:0,n=0,s=[o.leftJustifiedTextSymbolIndex,o.centerJustifiedTextSymbolIndex,o.rightJustifiedTextSymbolIndex];n<s.length;n+=1)e.text.placedSymbolArray.get(s[n]).placedOrientation=r;o.verticalPlacedTextSymbolIndex&&(e.text.placedSymbolArray.get(o.verticalPlacedTextSymbolIndex).placedOrientation=a);},be.prototype.commit=function(t){this.commitTime=t,this.zoomAtLastRecencyCheck=this.transform.zoom;var e=this.prevPlacement,i=!1;this.prevZoomAdjustment=e?e.zoomAdjustment(this.transform.zoom):0;var o=e?e.symbolFadeChange(t):1,r=e?e.opacities:{},a=e?e.variableOffsets:{},n=e?e.placedOrientations:{};for(var s in this.placements){var l=this.placements[s],c=r[s];c?(this.opacities[s]=new _e(c,o,l.text,l.icon),i=i||l.text!==c.text.placed||l.icon!==c.icon.placed):(this.opacities[s]=new _e(null,o,l.text,l.icon,l.skipFade),i=i||l.text||l.icon);}for(var u in r){var h=r[u];if(!this.opacities[u]){var p=new _e(h,o,!1,!1);p.isHidden()||(this.opacities[u]=p,i=i||h.text.placed||h.icon.placed);}}for(var d in a)this.variableOffsets[d]||!this.opacities[d]||this.opacities[d].isHidden()||(this.variableOffsets[d]=a[d]);for(var _ in n)this.placedOrientations[_]||!this.opacities[_]||this.opacities[_].isHidden()||(this.placedOrientations[_]=n[_]);i?this.lastPlacementChangeTime=t:\"number\"!=typeof this.lastPlacementChangeTime&&(this.lastPlacementChangeTime=e?e.lastPlacementChangeTime:t);},be.prototype.updateLayerOpacities=function(t,e){for(var i={},o=0,r=e;o<r.length;o+=1){var a=r[o],n=a.getBucket(t);n&&a.latestFeatureIndex&&t.id===n.layerIds[0]&&this.updateBucketOpacities(n,i,a.collisionBoxArray);}},be.prototype.updateBucketOpacities=function(e,i,o){var r=this;e.hasTextData()&&e.text.opacityVertexArray.clear(),e.hasIconData()&&e.icon.opacityVertexArray.clear(),e.hasIconCollisionBoxData()&&e.iconCollisionBox.collisionVertexArray.clear(),e.hasTextCollisionBoxData()&&e.textCollisionBox.collisionVertexArray.clear();var a=e.layers[0].layout,n=new _e(null,0,!1,!1,!0),s=a.get(\"text-allow-overlap\"),l=a.get(\"icon-allow-overlap\"),c=a.get(\"text-variable-anchor\"),u=\"map\"===a.get(\"text-rotation-alignment\"),h=\"map\"===a.get(\"text-pitch-alignment\"),p=\"none\"!==a.get(\"icon-text-fit\"),d=new _e(null,0,s&&(l||!e.hasIconData()||a.get(\"icon-optional\")),l&&(s||!e.hasTextData()||a.get(\"text-optional\")),!0);!e.collisionArrays&&o&&(e.hasIconCollisionBoxData()||e.hasTextCollisionBoxData())&&e.deserializeCollisionBoxes(o);for(var _=function(t,e,i){for(var o=0;o<e/4;o++)t.opacityVertexArray.emplaceBack(i);},f=function(o){var a=e.symbolInstances.get(o),s=a.numHorizontalGlyphVertices,l=a.numVerticalGlyphVertices,f=a.crossTileID,m=r.opacities[f];i[f]?m=n:m||(r.opacities[f]=m=d),i[f]=!0;var g=a.numIconVertices>0,v=r.placedOrientations[a.crossTileID],y=v===t.WritingMode.vertical,x=v===t.WritingMode.horizontal||v===t.WritingMode.horizontalOnly;if(s>0||l>0){var b=De(m.text);_(e.text,s,y?Ae:b),_(e.text,l,x?Ae:b);var w=m.text.isHidden();[a.rightJustifiedTextSymbolIndex,a.centerJustifiedTextSymbolIndex,a.leftJustifiedTextSymbolIndex].forEach((function(t){t>=0&&(e.text.placedSymbolArray.get(t).hidden=w||y?1:0);})),a.verticalPlacedTextSymbolIndex>=0&&(e.text.placedSymbolArray.get(a.verticalPlacedTextSymbolIndex).hidden=w||x?1:0);var T=r.variableOffsets[a.crossTileID];T&&r.markUsedJustification(e,T.anchor,a,v);var E=r.placedOrientations[a.crossTileID];E&&(r.markUsedJustification(e,\"left\",a,E),r.markUsedOrientation(e,E,a));}if(g){var I=De(m.icon),P=!(p&&a.verticalPlacedIconSymbolIndex&&y);a.placedIconSymbolIndex>=0&&(_(e.icon,a.numIconVertices,P?I:Ae),e.icon.placedSymbolArray.get(a.placedIconSymbolIndex).hidden=m.icon.isHidden()),a.verticalPlacedIconSymbolIndex>=0&&(_(e.icon,a.numVerticalIconVertices,P?Ae:I),e.icon.placedSymbolArray.get(a.verticalPlacedIconSymbolIndex).hidden=m.icon.isHidden());}if(e.hasIconCollisionBoxData()||e.hasTextCollisionBoxData()){var S=e.collisionArrays[o];if(S){var C=new t.Point(0,0);if(S.textBox||S.verticalTextBox){var z=!0;if(c){var D=r.variableOffsets[f];D?(C=ye(D.anchor,D.width,D.height,D.textOffset,D.textBoxScale),u&&C._rotate(h?r.transform.angle:-r.transform.angle)):z=!1;}S.textBox&&we(e.textCollisionBox.collisionVertexArray,m.text.placed,!z||y,C.x,C.y),S.verticalTextBox&&we(e.textCollisionBox.collisionVertexArray,m.text.placed,!z||x,C.x,C.y);}var A=Boolean(!x&&S.verticalIconBox);S.iconBox&&we(e.iconCollisionBox.collisionVertexArray,m.icon.placed,A,p?C.x:0,p?C.y:0),S.verticalIconBox&&we(e.iconCollisionBox.collisionVertexArray,m.icon.placed,!A,p?C.x:0,p?C.y:0);}}},m=0;m<e.symbolInstances.length;m++)f(m);if(e.sortFeatures(this.transform.angle),this.retainedQueryData[e.bucketInstanceId]&&(this.retainedQueryData[e.bucketInstanceId].featureSortOrder=e.featureSortOrder),e.hasTextData()&&e.text.opacityVertexBuffer&&e.text.opacityVertexBuffer.updateData(e.text.opacityVertexArray),e.hasIconData()&&e.icon.opacityVertexBuffer&&e.icon.opacityVertexBuffer.updateData(e.icon.opacityVertexArray),e.hasIconCollisionBoxData()&&e.iconCollisionBox.collisionVertexBuffer&&e.iconCollisionBox.collisionVertexBuffer.updateData(e.iconCollisionBox.collisionVertexArray),e.hasTextCollisionBoxData()&&e.textCollisionBox.collisionVertexBuffer&&e.textCollisionBox.collisionVertexBuffer.updateData(e.textCollisionBox.collisionVertexArray),e.bucketInstanceId in this.collisionCircleArrays){var g=this.collisionCircleArrays[e.bucketInstanceId];e.placementInvProjMatrix=g.invProjMatrix,e.placementViewportMatrix=g.viewportMatrix,e.collisionCircleArray=g.circles,delete this.collisionCircleArrays[e.bucketInstanceId];}},be.prototype.symbolFadeChange=function(t){return 0===this.fadeDuration?1:(t-this.commitTime)/this.fadeDuration+this.prevZoomAdjustment},be.prototype.zoomAdjustment=function(t){return Math.max(0,(this.transform.zoom-t)/1.5)},be.prototype.hasTransitions=function(t){return this.stale||t-this.lastPlacementChangeTime<this.fadeDuration},be.prototype.stillRecent=function(t,e){var i=this.zoomAtLastRecencyCheck===e?1-this.zoomAdjustment(e):1;return this.zoomAtLastRecencyCheck=e,this.commitTime+this.fadeDuration*i>t},be.prototype.setStale=function(){this.stale=!0;};var Te=Math.pow(2,25),Ee=Math.pow(2,24),Ie=Math.pow(2,17),Pe=Math.pow(2,16),Se=Math.pow(2,9),Ce=Math.pow(2,8),ze=Math.pow(2,1);function De(t){if(0===t.opacity&&!t.placed)return 0;if(1===t.opacity&&t.placed)return 4294967295;var e=t.placed?1:0,i=Math.floor(127*t.opacity);return i*Te+e*Ee+i*Ie+e*Pe+i*Se+e*Ce+i*ze+e}var Ae=0,Me=function(t){this._sortAcrossTiles=\"viewport-y\"!==t.layout.get(\"symbol-z-order\")&&void 0!==t.layout.get(\"symbol-sort-key\").constantOr(1),this._currentTileIndex=0,this._currentPartIndex=0,this._seenCrossTileIDs={},this._bucketParts=[];};Me.prototype.continuePlacement=function(t,e,i,o,r){for(var a=this._bucketParts;this._currentTileIndex<t.length;)if(e.getBucketParts(a,o,t[this._currentTileIndex],this._sortAcrossTiles),this._currentTileIndex++,r())return !0;for(this._sortAcrossTiles&&(this._sortAcrossTiles=!1,a.sort((function(t,e){return t.sortKey-e.sortKey})));this._currentPartIndex<a.length;)if(e.placeLayerBucketPart(a[this._currentPartIndex],this._seenCrossTileIDs,i),this._currentPartIndex++,r())return !0;return !1};var Le=function(t,e,i,o,r,a,n){this.placement=new be(t,r,a,n),this._currentPlacementIndex=e.length-1,this._forceFullPlacement=i,this._showCollisionBoxes=o,this._done=!1;};Le.prototype.isDone=function(){return this._done},Le.prototype.continuePlacement=function(e,i,o){for(var r=this,a=t.browser.now(),n=function(){var e=t.browser.now()-a;return !r._forceFullPlacement&&e>2};this._currentPlacementIndex>=0;){var s=i[e[this._currentPlacementIndex]],l=this.placement.collisionIndex.transform.zoom;if(\"symbol\"===s.type&&(!s.minzoom||s.minzoom<=l)&&(!s.maxzoom||s.maxzoom>l)){if(this._inProgressLayer||(this._inProgressLayer=new Me(s)),this._inProgressLayer.continuePlacement(o[s.source],this.placement,this._showCollisionBoxes,s,n))return;delete this._inProgressLayer;}this._currentPlacementIndex--;}this._done=!0;},Le.prototype.commit=function(t){return this.placement.commit(t),this.placement};var Re=512/t.EXTENT/2,ke=function(t,e,i){this.tileID=t,this.indexedSymbolInstances={},this.bucketInstanceId=i;for(var o=0;o<e.length;o++){var r=e.get(o),a=r.key;this.indexedSymbolInstances[a]||(this.indexedSymbolInstances[a]=[]),this.indexedSymbolInstances[a].push({crossTileID:r.crossTileID,coord:this.getScaledCoordinates(r,t)});}};ke.prototype.getScaledCoordinates=function(e,i){var o=Re/Math.pow(2,i.canonical.z-this.tileID.canonical.z);return {x:Math.floor((i.canonical.x*t.EXTENT+e.anchorX)*o),y:Math.floor((i.canonical.y*t.EXTENT+e.anchorY)*o)}},ke.prototype.findMatches=function(t,e,i){for(var o=this.tileID.canonical.z<e.canonical.z?1:Math.pow(2,this.tileID.canonical.z-e.canonical.z),r=0;r<t.length;r++){var a=t.get(r);if(!a.crossTileID){var n=this.indexedSymbolInstances[a.key];if(n)for(var s=this.getScaledCoordinates(a,e),l=0,c=n;l<c.length;l+=1){var u=c[l];if(Math.abs(u.coord.x-s.x)<=o&&Math.abs(u.coord.y-s.y)<=o&&!i[u.crossTileID]){i[u.crossTileID]=!0,a.crossTileID=u.crossTileID;break}}}}};var Be=function(){this.maxCrossTileID=0;};Be.prototype.generate=function(){return ++this.maxCrossTileID};var Oe=function(){this.indexes={},this.usedCrossTileIDs={},this.lng=0;};Oe.prototype.handleWrapJump=function(t){var e=Math.round((t-this.lng)/360);if(0!==e)for(var i in this.indexes){var o=this.indexes[i],r={};for(var a in o){var n=o[a];n.tileID=n.tileID.unwrapTo(n.tileID.wrap+e),r[n.tileID.key]=n;}this.indexes[i]=r;}this.lng=t;},Oe.prototype.addBucket=function(t,e,i){if(this.indexes[t.overscaledZ]&&this.indexes[t.overscaledZ][t.key]){if(this.indexes[t.overscaledZ][t.key].bucketInstanceId===e.bucketInstanceId)return !1;this.removeBucketCrossTileIDs(t.overscaledZ,this.indexes[t.overscaledZ][t.key]);}for(var o=0;o<e.symbolInstances.length;o++)e.symbolInstances.get(o).crossTileID=0;this.usedCrossTileIDs[t.overscaledZ]||(this.usedCrossTileIDs[t.overscaledZ]={});var r=this.usedCrossTileIDs[t.overscaledZ];for(var a in this.indexes){var n=this.indexes[a];if(Number(a)>t.overscaledZ)for(var s in n){var l=n[s];l.tileID.isChildOf(t)&&l.findMatches(e.symbolInstances,t,r);}else {var c=n[t.scaledTo(Number(a)).key];c&&c.findMatches(e.symbolInstances,t,r);}}for(var u=0;u<e.symbolInstances.length;u++){var h=e.symbolInstances.get(u);h.crossTileID||(h.crossTileID=i.generate(),r[h.crossTileID]=!0);}return void 0===this.indexes[t.overscaledZ]&&(this.indexes[t.overscaledZ]={}),this.indexes[t.overscaledZ][t.key]=new ke(t,e.symbolInstances,e.bucketInstanceId),!0},Oe.prototype.removeBucketCrossTileIDs=function(t,e){for(var i in e.indexedSymbolInstances)for(var o=0,r=e.indexedSymbolInstances[i];o<r.length;o+=1)delete this.usedCrossTileIDs[t][r[o].crossTileID];},Oe.prototype.removeStaleBuckets=function(t){var e=!1;for(var i in this.indexes){var o=this.indexes[i];for(var r in o)t[o[r].bucketInstanceId]||(this.removeBucketCrossTileIDs(i,o[r]),delete o[r],e=!0);}return e};var Fe=function(){this.layerIndexes={},this.crossTileIDs=new Be,this.maxBucketInstanceId=0,this.bucketsInCurrentPlacement={};};Fe.prototype.addLayer=function(t,e,i){var o=this.layerIndexes[t.id];void 0===o&&(o=this.layerIndexes[t.id]=new Oe);var r=!1,a={};o.handleWrapJump(i);for(var n=0,s=e;n<s.length;n+=1){var l=s[n],c=l.getBucket(t);c&&t.id===c.layerIds[0]&&(c.bucketInstanceId||(c.bucketInstanceId=++this.maxBucketInstanceId),o.addBucket(l.tileID,c,this.crossTileIDs)&&(r=!0),a[c.bucketInstanceId]=!0);}return o.removeStaleBuckets(a)&&(r=!0),r},Fe.prototype.pruneUnusedLayers=function(t){var e={};for(var i in t.forEach((function(t){e[t]=!0;})),this.layerIndexes)e[i]||delete this.layerIndexes[i];};var Ue=function(e,i){return t.emitValidationErrors(e,i&&i.filter((function(t){return \"source.canvas\"!==t.identifier})))},Ne=t.pick(Zt,[\"addLayer\",\"removeLayer\",\"setPaintProperty\",\"setLayoutProperty\",\"setFilter\",\"addSource\",\"removeSource\",\"setLayerZoomRange\",\"setLight\",\"setTransition\",\"setGeoJSONSourceData\"]),Ze=t.pick(Zt,[\"setCenter\",\"setZoom\",\"setBearing\",\"setPitch\"]),qe=function(){var e={},i=t.styleSpec.$version;for(var o in t.styleSpec.$root){var r,a=t.styleSpec.$root[o];if(a.required)null!=(r=\"version\"===o?i:\"array\"===a.type?[]:{})&&(e[o]=r);}return e}(),je=function(e){function i(o,r){var a=this;void 0===r&&(r={}),e.call(this),this.map=o,this.dispatcher=new E(Ft(),this),this.imageManager=new p,this.imageManager.setEventedParent(this),this.glyphManager=new y(o._requestManager,r.localIdeographFontFamily),this.lineAtlas=new T(256,512),this.crossTileSymbolIndex=new Fe,this._layers={},this._serializedLayers={},this._order=[],this.sourceCaches={},this.zoomHistory=new t.ZoomHistory,this._loaded=!1,this._availableImages=[],this._resetUpdates(),this.dispatcher.broadcast(\"setReferrer\",t.getReferrer());var n=this;this._rtlTextPluginCallback=i.registerForPluginStateChange((function(e){n.dispatcher.broadcast(\"syncRTLPluginState\",{pluginStatus:e.pluginStatus,pluginURL:e.pluginURL},(function(e,i){if(t.triggerPluginCompletionEvent(e),i&&i.every((function(t){return t})))for(var o in n.sourceCaches)n.sourceCaches[o].reload();}));})),this.on(\"data\",(function(t){if(\"source\"===t.dataType&&\"metadata\"===t.sourceDataType){var e=a.sourceCaches[t.sourceId];if(e){var i=e.getSource();if(i&&i.vectorLayerIds)for(var o in a._layers){var r=a._layers[o];r.source===i.id&&a._validateLayer(r);}}}}));}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.loadURL=function(e,i){var o=this;void 0===i&&(i={}),this.fire(new t.Event(\"dataloading\",{dataType:\"style\"}));var r=\"boolean\"==typeof i.validate?i.validate:!t.isMapboxURL(e);e=this.map._requestManager.normalizeStyleURL(e,i.accessToken);var a=this.map._requestManager.transformRequest(e,t.ResourceType.Style);this._request=t.getJSON(a,(function(e,i){o._request=null,e?o.fire(new t.ErrorEvent(e)):i&&o._load(i,r);}));},i.prototype.loadJSON=function(e,i){var o=this;void 0===i&&(i={}),this.fire(new t.Event(\"dataloading\",{dataType:\"style\"})),this._request=t.browser.frame((function(){o._request=null,o._load(e,!1!==i.validate);}));},i.prototype.loadEmpty=function(){this.fire(new t.Event(\"dataloading\",{dataType:\"style\"})),this._load(qe,!1);},i.prototype._load=function(e,i){if(!i||!Ue(this,t.validateStyle(e))){for(var o in this._loaded=!0,this.stylesheet=e,e.sources)this.addSource(o,e.sources[o],{validate:!1});e.sprite?this._loadSprite(e.sprite):this.imageManager.setLoaded(!0),this.glyphManager.setURL(e.glyphs);var r=Nt(this.stylesheet.layers);this._order=r.map((function(t){return t.id})),this._layers={},this._serializedLayers={};for(var a=0,n=r;a<n.length;a+=1){var s=n[a];(s=t.createStyleLayer(s)).setEventedParent(this,{layer:{id:s.id}}),this._layers[s.id]=s,this._serializedLayers[s.id]=s.serialize();}this.dispatcher.broadcast(\"setLayers\",this._serializeLayers(this._order)),this.light=new w(this.stylesheet.light),this.fire(new t.Event(\"data\",{dataType:\"style\"})),this.fire(new t.Event(\"style.load\"));}},i.prototype._loadSprite=function(e){var i=this;this._spriteRequest=function(e,i,o){var r,a,n,s=t.browser.devicePixelRatio>1?\"@2x\":\"\",l=t.getJSON(i.transformRequest(i.normalizeSpriteURL(e,s,\".json\"),t.ResourceType.SpriteJSON),(function(t,e){l=null,n||(n=t,r=e,u());})),c=t.getImage(i.transformRequest(i.normalizeSpriteURL(e,s,\".png\"),t.ResourceType.SpriteImage),(function(t,e){c=null,n||(n=t,a=e,u());}));function u(){if(n)o(n);else if(r&&a){var e=t.browser.getImageData(a),i={};for(var s in r){var l=r[s],c=l.width,u=l.height,h=l.x,p=l.y,d=l.sdf,_=l.pixelRatio,f=l.stretchX,m=l.stretchY,g=l.content,v=new t.RGBAImage({width:c,height:u});t.RGBAImage.copy(e,v,{x:h,y:p},{x:0,y:0},{width:c,height:u}),i[s]={data:v,pixelRatio:_,sdf:d,stretchX:f,stretchY:m,content:g};}o(null,i);}}return {cancel:function(){l&&(l.cancel(),l=null),c&&(c.cancel(),c=null);}}}(e,this.map._requestManager,(function(e,o){if(i._spriteRequest=null,e)i.fire(new t.ErrorEvent(e));else if(o)for(var r in o)i.imageManager.addImage(r,o[r]);i.imageManager.setLoaded(!0),i._availableImages=i.imageManager.listImages(),i.dispatcher.broadcast(\"setImages\",i._availableImages),i.fire(new t.Event(\"data\",{dataType:\"style\"}));}));},i.prototype._validateLayer=function(e){var i=this.sourceCaches[e.source];if(i){var o=e.sourceLayer;if(o){var r=i.getSource();(\"geojson\"===r.type||r.vectorLayerIds&&-1===r.vectorLayerIds.indexOf(o))&&this.fire(new t.ErrorEvent(new Error('Source layer \"'+o+'\" does not exist on source \"'+r.id+'\" as specified by style layer \"'+e.id+'\"')));}}},i.prototype.loaded=function(){if(!this._loaded)return !1;if(Object.keys(this._updatedSources).length)return !1;for(var t in this.sourceCaches)if(!this.sourceCaches[t].loaded())return !1;return !!this.imageManager.isLoaded()},i.prototype._serializeLayers=function(t){for(var e=[],i=0,o=t;i<o.length;i+=1){var r=this._layers[o[i]];\"custom\"!==r.type&&e.push(r.serialize());}return e},i.prototype.hasTransitions=function(){if(this.light&&this.light.hasTransition())return !0;for(var t in this.sourceCaches)if(this.sourceCaches[t].hasTransition())return !0;for(var e in this._layers)if(this._layers[e].hasTransition())return !0;return !1},i.prototype._checkLoaded=function(){if(!this._loaded)throw new Error(\"Style is not done loading\")},i.prototype.update=function(e){if(this._loaded){var i=this._changed;if(this._changed){var o=Object.keys(this._updatedLayers),r=Object.keys(this._removedLayers);for(var a in (o.length||r.length)&&this._updateWorkerLayers(o,r),this._updatedSources){var n=this._updatedSources[a];\"reload\"===n?this._reloadSource(a):\"clear\"===n&&this._clearSource(a);}for(var s in this._updateTilesForChangedImages(),this._updatedPaintProps)this._layers[s].updateTransitions(e);this.light.updateTransitions(e),this._resetUpdates();}var l={};for(var c in this.sourceCaches){var u=this.sourceCaches[c];l[c]=u.used,u.used=!1;}for(var h=0,p=this._order;h<p.length;h+=1){var d=this._layers[p[h]];d.recalculate(e,this._availableImages),!d.isHidden(e.zoom)&&d.source&&(this.sourceCaches[d.source].used=!0);}for(var _ in l){var f=this.sourceCaches[_];l[_]!==f.used&&f.fire(new t.Event(\"data\",{sourceDataType:\"visibility\",dataType:\"source\",sourceId:_}));}this.light.recalculate(e),this.z=e.zoom,i&&this.fire(new t.Event(\"data\",{dataType:\"style\"}));}},i.prototype._updateTilesForChangedImages=function(){var t=Object.keys(this._changedImages);if(t.length){for(var e in this.sourceCaches)this.sourceCaches[e].reloadTilesForDependencies([\"icons\",\"patterns\"],t);this._changedImages={};}},i.prototype._updateWorkerLayers=function(t,e){this.dispatcher.broadcast(\"updateLayers\",{layers:this._serializeLayers(t),removedIds:e});},i.prototype._resetUpdates=function(){this._changed=!1,this._updatedLayers={},this._removedLayers={},this._updatedSources={},this._updatedPaintProps={},this._changedImages={};},i.prototype.setState=function(e){var i=this;if(this._checkLoaded(),Ue(this,t.validateStyle(e)))return !1;(e=t.clone$1(e)).layers=Nt(e.layers);var o=function(e,i){if(!e)return [{command:Zt.setStyle,args:[i]}];var o=[];try{if(!t.deepEqual(e.version,i.version))return [{command:Zt.setStyle,args:[i]}];t.deepEqual(e.center,i.center)||o.push({command:Zt.setCenter,args:[i.center]}),t.deepEqual(e.zoom,i.zoom)||o.push({command:Zt.setZoom,args:[i.zoom]}),t.deepEqual(e.bearing,i.bearing)||o.push({command:Zt.setBearing,args:[i.bearing]}),t.deepEqual(e.pitch,i.pitch)||o.push({command:Zt.setPitch,args:[i.pitch]}),t.deepEqual(e.sprite,i.sprite)||o.push({command:Zt.setSprite,args:[i.sprite]}),t.deepEqual(e.glyphs,i.glyphs)||o.push({command:Zt.setGlyphs,args:[i.glyphs]}),t.deepEqual(e.transition,i.transition)||o.push({command:Zt.setTransition,args:[i.transition]}),t.deepEqual(e.light,i.light)||o.push({command:Zt.setLight,args:[i.light]});var r={},a=[];!function(e,i,o,r){var a;for(a in i=i||{},e=e||{})e.hasOwnProperty(a)&&(i.hasOwnProperty(a)||jt(a,o,r));for(a in i)i.hasOwnProperty(a)&&(e.hasOwnProperty(a)?t.deepEqual(e[a],i[a])||(\"geojson\"===e[a].type&&\"geojson\"===i[a].type&&Gt(e,i,a)?o.push({command:Zt.setGeoJSONSourceData,args:[a,i[a].data]}):Vt(a,i,o,r)):qt(a,i,o));}(e.sources,i.sources,a,r);var n=[];e.layers&&e.layers.forEach((function(t){r[t.source]?o.push({command:Zt.removeLayer,args:[t.id]}):n.push(t);})),o=o.concat(a),function(e,i,o){i=i||[];var r,a,n,s,l,c,u,h=(e=e||[]).map(Xt),p=i.map(Xt),d=e.reduce(Ht,{}),_=i.reduce(Ht,{}),f=h.slice(),m=Object.create(null);for(r=0,a=0;r<h.length;r++)_.hasOwnProperty(n=h[r])?a++:(o.push({command:Zt.removeLayer,args:[n]}),f.splice(f.indexOf(n,a),1));for(r=0,a=0;r<p.length;r++)f[f.length-1-r]!==(n=p[p.length-1-r])&&(d.hasOwnProperty(n)?(o.push({command:Zt.removeLayer,args:[n]}),f.splice(f.lastIndexOf(n,f.length-a),1)):a++,o.push({command:Zt.addLayer,args:[_[n],c=f[f.length-r]]}),f.splice(f.length-r,0,n),m[n]=!0);for(r=0;r<p.length;r++)if(s=d[n=p[r]],l=_[n],!m[n]&&!t.deepEqual(s,l))if(t.deepEqual(s.source,l.source)&&t.deepEqual(s[\"source-layer\"],l[\"source-layer\"])&&t.deepEqual(s.type,l.type)){for(u in Wt(s.layout,l.layout,o,n,null,Zt.setLayoutProperty),Wt(s.paint,l.paint,o,n,null,Zt.setPaintProperty),t.deepEqual(s.filter,l.filter)||o.push({command:Zt.setFilter,args:[n,l.filter]}),t.deepEqual(s.minzoom,l.minzoom)&&t.deepEqual(s.maxzoom,l.maxzoom)||o.push({command:Zt.setLayerZoomRange,args:[n,l.minzoom,l.maxzoom]}),s)s.hasOwnProperty(u)&&\"layout\"!==u&&\"paint\"!==u&&\"filter\"!==u&&\"metadata\"!==u&&\"minzoom\"!==u&&\"maxzoom\"!==u&&(0===u.indexOf(\"paint.\")?Wt(s[u],l[u],o,n,u.slice(6),Zt.setPaintProperty):t.deepEqual(s[u],l[u])||o.push({command:Zt.setLayerProperty,args:[n,u,l[u]]}));for(u in l)l.hasOwnProperty(u)&&!s.hasOwnProperty(u)&&\"layout\"!==u&&\"paint\"!==u&&\"filter\"!==u&&\"metadata\"!==u&&\"minzoom\"!==u&&\"maxzoom\"!==u&&(0===u.indexOf(\"paint.\")?Wt(s[u],l[u],o,n,u.slice(6),Zt.setPaintProperty):t.deepEqual(s[u],l[u])||o.push({command:Zt.setLayerProperty,args:[n,u,l[u]]}));}else o.push({command:Zt.removeLayer,args:[n]}),c=f[f.lastIndexOf(n)+1],o.push({command:Zt.addLayer,args:[l,c]});}(n,i.layers,o);}catch(t){console.warn(\"Unable to compute style diff:\",t),o=[{command:Zt.setStyle,args:[i]}];}return o}(this.serialize(),e).filter((function(t){return !(t.command in Ze)}));if(0===o.length)return !1;var r=o.filter((function(t){return !(t.command in Ne)}));if(r.length>0)throw new Error(\"Unimplemented: \"+r.map((function(t){return t.command})).join(\", \")+\".\");return o.forEach((function(t){\"setTransition\"!==t.command&&i[t.command].apply(i,t.args);})),this.stylesheet=e,!0},i.prototype.addImage=function(e,i){if(this.getImage(e))return this.fire(new t.ErrorEvent(new Error(\"An image with this name already exists.\")));this.imageManager.addImage(e,i),this._afterImageUpdated(e);},i.prototype.updateImage=function(t,e){this.imageManager.updateImage(t,e);},i.prototype.getImage=function(t){return this.imageManager.getImage(t)},i.prototype.removeImage=function(e){if(!this.getImage(e))return this.fire(new t.ErrorEvent(new Error(\"No image with this name exists.\")));this.imageManager.removeImage(e),this._afterImageUpdated(e);},i.prototype._afterImageUpdated=function(e){this._availableImages=this.imageManager.listImages(),this._changedImages[e]=!0,this._changed=!0,this.dispatcher.broadcast(\"setImages\",this._availableImages),this.fire(new t.Event(\"data\",{dataType:\"style\"}));},i.prototype.listImages=function(){return this._checkLoaded(),this.imageManager.listImages()},i.prototype.addSource=function(e,i,o){var r=this;if(void 0===o&&(o={}),this._checkLoaded(),void 0!==this.sourceCaches[e])throw new Error(\"There is already a source with this ID\");if(!i.type)throw new Error(\"The type property must be defined, but only the following properties were given: \"+Object.keys(i).join(\", \")+\".\");if(!([\"vector\",\"raster\",\"geojson\",\"video\",\"image\"].indexOf(i.type)>=0&&this._validate(t.validateStyle.source,\"sources.\"+e,i,null,o))){this.map&&this.map._collectResourceTiming&&(i.collectResourceTiming=!0);var a=this.sourceCaches[e]=new Dt(e,i,this.dispatcher);a.style=this,a.setEventedParent(this,(function(){return {isSourceLoaded:r.loaded(),source:a.serialize(),sourceId:e}})),a.onAdd(this.map),this._changed=!0;}},i.prototype.removeSource=function(e){if(this._checkLoaded(),void 0===this.sourceCaches[e])throw new Error(\"There is no source with this ID\");for(var i in this._layers)if(this._layers[i].source===e)return this.fire(new t.ErrorEvent(new Error('Source \"'+e+'\" cannot be removed while layer \"'+i+'\" is using it.')));var o=this.sourceCaches[e];delete this.sourceCaches[e],delete this._updatedSources[e],o.fire(new t.Event(\"data\",{sourceDataType:\"metadata\",dataType:\"source\",sourceId:e})),o.setEventedParent(null),o.clearTiles(),o.onRemove&&o.onRemove(this.map),this._changed=!0;},i.prototype.setGeoJSONSourceData=function(t,e){this._checkLoaded(),this.sourceCaches[t].getSource().setData(e),this._changed=!0;},i.prototype.getSource=function(t){return this.sourceCaches[t]&&this.sourceCaches[t].getSource()},i.prototype.addLayer=function(e,i,o){void 0===o&&(o={}),this._checkLoaded();var r=e.id;if(this.getLayer(r))this.fire(new t.ErrorEvent(new Error('Layer with id \"'+r+'\" already exists on this map')));else {var a;if(\"custom\"===e.type){if(Ue(this,t.validateCustomStyleLayer(e)))return;a=t.createStyleLayer(e);}else {if(\"object\"==typeof e.source&&(this.addSource(r,e.source),e=t.clone$1(e),e=t.extend(e,{source:r})),this._validate(t.validateStyle.layer,\"layers.\"+r,e,{arrayIndex:-1},o))return;a=t.createStyleLayer(e),this._validateLayer(a),a.setEventedParent(this,{layer:{id:r}}),this._serializedLayers[a.id]=a.serialize();}var n=i?this._order.indexOf(i):this._order.length;if(i&&-1===n)this.fire(new t.ErrorEvent(new Error('Layer with id \"'+i+'\" does not exist on this map.')));else {if(this._order.splice(n,0,r),this._layerOrderChanged=!0,this._layers[r]=a,this._removedLayers[r]&&a.source&&\"custom\"!==a.type){var s=this._removedLayers[r];delete this._removedLayers[r],s.type!==a.type?this._updatedSources[a.source]=\"clear\":(this._updatedSources[a.source]=\"reload\",this.sourceCaches[a.source].pause());}this._updateLayer(a),a.onAdd&&a.onAdd(this.map);}}},i.prototype.moveLayer=function(e,i){if(this._checkLoaded(),this._changed=!0,this._layers[e]){if(e!==i){var o=this._order.indexOf(e);this._order.splice(o,1);var r=i?this._order.indexOf(i):this._order.length;i&&-1===r?this.fire(new t.ErrorEvent(new Error('Layer with id \"'+i+'\" does not exist on this map.'))):(this._order.splice(r,0,e),this._layerOrderChanged=!0);}}else this.fire(new t.ErrorEvent(new Error(\"The layer '\"+e+\"' does not exist in the map's style and cannot be moved.\")));},i.prototype.removeLayer=function(e){this._checkLoaded();var i=this._layers[e];if(i){i.setEventedParent(null);var o=this._order.indexOf(e);this._order.splice(o,1),this._layerOrderChanged=!0,this._changed=!0,this._removedLayers[e]=i,delete this._layers[e],delete this._serializedLayers[e],delete this._updatedLayers[e],delete this._updatedPaintProps[e],i.onRemove&&i.onRemove(this.map);}else this.fire(new t.ErrorEvent(new Error(\"The layer '\"+e+\"' does not exist in the map's style and cannot be removed.\")));},i.prototype.getLayer=function(t){return this._layers[t]},i.prototype.hasLayer=function(t){return t in this._layers},i.prototype.setLayerZoomRange=function(e,i,o){this._checkLoaded();var r=this.getLayer(e);r?r.minzoom===i&&r.maxzoom===o||(null!=i&&(r.minzoom=i),null!=o&&(r.maxzoom=o),this._updateLayer(r)):this.fire(new t.ErrorEvent(new Error(\"The layer '\"+e+\"' does not exist in the map's style and cannot have zoom extent.\")));},i.prototype.setFilter=function(e,i,o){void 0===o&&(o={}),this._checkLoaded();var r=this.getLayer(e);if(r){if(!t.deepEqual(r.filter,i))return null==i?(r.filter=void 0,void this._updateLayer(r)):void(this._validate(t.validateStyle.filter,\"layers.\"+r.id+\".filter\",i,null,o)||(r.filter=t.clone$1(i),this._updateLayer(r)))}else this.fire(new t.ErrorEvent(new Error(\"The layer '\"+e+\"' does not exist in the map's style and cannot be filtered.\")));},i.prototype.getFilter=function(e){return t.clone$1(this.getLayer(e).filter)},i.prototype.setLayoutProperty=function(e,i,o,r){void 0===r&&(r={}),this._checkLoaded();var a=this.getLayer(e);a?t.deepEqual(a.getLayoutProperty(i),o)||(a.setLayoutProperty(i,o,r),this._updateLayer(a)):this.fire(new t.ErrorEvent(new Error(\"The layer '\"+e+\"' does not exist in the map's style and cannot be styled.\")));},i.prototype.getLayoutProperty=function(e,i){var o=this.getLayer(e);if(o)return o.getLayoutProperty(i);this.fire(new t.ErrorEvent(new Error(\"The layer '\"+e+\"' does not exist in the map's style.\")));},i.prototype.setPaintProperty=function(e,i,o,r){void 0===r&&(r={}),this._checkLoaded();var a=this.getLayer(e);a?t.deepEqual(a.getPaintProperty(i),o)||(a.setPaintProperty(i,o,r)&&this._updateLayer(a),this._changed=!0,this._updatedPaintProps[e]=!0):this.fire(new t.ErrorEvent(new Error(\"The layer '\"+e+\"' does not exist in the map's style and cannot be styled.\")));},i.prototype.getPaintProperty=function(t,e){return this.getLayer(t).getPaintProperty(e)},i.prototype.setFeatureState=function(e,i){this._checkLoaded();var o=e.source,r=e.sourceLayer,a=this.sourceCaches[o];if(void 0!==a){var n=a.getSource().type;\"geojson\"===n&&r?this.fire(new t.ErrorEvent(new Error(\"GeoJSON sources cannot have a sourceLayer parameter.\"))):\"vector\"!==n||r?(void 0===e.id&&this.fire(new t.ErrorEvent(new Error(\"The feature id parameter must be provided.\"))),a.setFeatureState(r,e.id,i)):this.fire(new t.ErrorEvent(new Error(\"The sourceLayer parameter must be provided for vector source types.\")));}else this.fire(new t.ErrorEvent(new Error(\"The source '\"+o+\"' does not exist in the map's style.\")));},i.prototype.removeFeatureState=function(e,i){this._checkLoaded();var o=e.source,r=this.sourceCaches[o];if(void 0!==r){var a=r.getSource().type,n=\"vector\"===a?e.sourceLayer:void 0;\"vector\"!==a||n?i&&\"string\"!=typeof e.id&&\"number\"!=typeof e.id?this.fire(new t.ErrorEvent(new Error(\"A feature id is required to remove its specific state property.\"))):r.removeFeatureState(n,e.id,i):this.fire(new t.ErrorEvent(new Error(\"The sourceLayer parameter must be provided for vector source types.\")));}else this.fire(new t.ErrorEvent(new Error(\"The source '\"+o+\"' does not exist in the map's style.\")));},i.prototype.getFeatureState=function(e){this._checkLoaded();var i=e.source,o=e.sourceLayer,r=this.sourceCaches[i];if(void 0!==r){if(\"vector\"!==r.getSource().type||o)return void 0===e.id&&this.fire(new t.ErrorEvent(new Error(\"The feature id parameter must be provided.\"))),r.getFeatureState(o,e.id);this.fire(new t.ErrorEvent(new Error(\"The sourceLayer parameter must be provided for vector source types.\")));}else this.fire(new t.ErrorEvent(new Error(\"The source '\"+i+\"' does not exist in the map's style.\")));},i.prototype.getTransition=function(){return t.extend({duration:300,delay:0},this.stylesheet&&this.stylesheet.transition)},i.prototype.serialize=function(){return t.filterObject({version:this.stylesheet.version,name:this.stylesheet.name,metadata:this.stylesheet.metadata,light:this.stylesheet.light,center:this.stylesheet.center,zoom:this.stylesheet.zoom,bearing:this.stylesheet.bearing,pitch:this.stylesheet.pitch,sprite:this.stylesheet.sprite,glyphs:this.stylesheet.glyphs,transition:this.stylesheet.transition,sources:t.mapObject(this.sourceCaches,(function(t){return t.serialize()})),layers:this._serializeLayers(this._order)},(function(t){return void 0!==t}))},i.prototype._updateLayer=function(t){this._updatedLayers[t.id]=!0,t.source&&!this._updatedSources[t.source]&&\"raster\"!==this.sourceCaches[t.source].getSource().type&&(this._updatedSources[t.source]=\"reload\",this.sourceCaches[t.source].pause()),this._changed=!0;},i.prototype._flattenAndSortRenderedFeatures=function(t){for(var e=this,i=function(t){return \"fill-extrusion\"===e._layers[t].type},o={},r=[],a=this._order.length-1;a>=0;a--){var n=this._order[a];if(i(n)){o[n]=a;for(var s=0,l=t;s<l.length;s+=1){var c=l[s][n];if(c)for(var u=0,h=c;u<h.length;u+=1)r.push(h[u]);}}}r.sort((function(t,e){return e.intersectionZ-t.intersectionZ}));for(var p=[],d=this._order.length-1;d>=0;d--){var _=this._order[d];if(i(_))for(var f=r.length-1;f>=0;f--){var m=r[f].feature;if(o[m.layer.id]<d)break;p.push(m),r.pop();}else for(var g=0,v=t;g<v.length;g+=1){var y=v[g][_];if(y)for(var x=0,b=y;x<b.length;x+=1)p.push(b[x].feature);}}return p},i.prototype.queryRenderedFeatures=function(e,i,o){i&&i.filter&&this._validate(t.validateStyle.filter,\"queryRenderedFeatures.filter\",i.filter,null,i);var r={};if(i&&i.layers){if(!Array.isArray(i.layers))return this.fire(new t.ErrorEvent(new Error(\"parameters.layers must be an Array.\"))),[];for(var a=0,n=i.layers;a<n.length;a+=1){var s=n[a],l=this._layers[s];if(!l)return this.fire(new t.ErrorEvent(new Error(\"The layer '\"+s+\"' does not exist in the map's style and cannot be queried for features.\"))),[];r[l.source]=!0;}}var c=[];for(var u in i.availableImages=this._availableImages,this.sourceCaches)i.layers&&!r[u]||c.push(O(this.sourceCaches[u],this._layers,this._serializedLayers,e,i,o));return this.placement&&c.push(function(t,e,i,o,r,a,n){for(var s={},l=a.queryRenderedSymbols(o),c=[],u=0,h=Object.keys(l).map(Number);u<h.length;u+=1)c.push(n[h[u]]);c.sort(F);for(var p=function(){var i=_[d],o=i.featureIndex.lookupSymbolFeatures(l[i.bucketInstanceId],e,i.bucketIndex,i.sourceLayerIndex,r.filter,r.layers,r.availableImages,t);for(var a in o){var n=s[a]=s[a]||[],c=o[a];c.sort((function(t,e){var o=i.featureSortOrder;if(o){var r=o.indexOf(t.featureIndex);return o.indexOf(e.featureIndex)-r}return e.featureIndex-t.featureIndex}));for(var u=0,h=c;u<h.length;u+=1)n.push(h[u]);}},d=0,_=c;d<_.length;d+=1)p();var f=function(e){s[e].forEach((function(o){var r=o.feature,a=i[t[e].source].getFeatureState(r.layer[\"source-layer\"],r.id);r.source=r.layer.source,r.layer[\"source-layer\"]&&(r.sourceLayer=r.layer[\"source-layer\"]),r.state=a;}));};for(var m in s)f(m);return s}(this._layers,this._serializedLayers,this.sourceCaches,e,i,this.placement.collisionIndex,this.placement.retainedQueryData)),this._flattenAndSortRenderedFeatures(c)},i.prototype.querySourceFeatures=function(e,i){i&&i.filter&&this._validate(t.validateStyle.filter,\"querySourceFeatures.filter\",i.filter,null,i);var o=this.sourceCaches[e];return o?function(t,e){for(var i=t.getRenderableIds().map((function(e){return t.getTileByID(e)})),o=[],r={},a=0;a<i.length;a++){var n=i[a],s=n.tileID.canonical.key;r[s]||(r[s]=!0,n.querySourceFeatures(o,e));}return o}(o,i):[]},i.prototype.addSourceType=function(t,e,o){return i.getSourceType(t)?o(new Error('A source type called \"'+t+'\" already exists.')):(i.setSourceType(t,e),e.workerSourceURL?void this.dispatcher.broadcast(\"loadWorkerSource\",{name:t,url:e.workerSourceURL},o):o(null,null))},i.prototype.getLight=function(){return this.light.getLight()},i.prototype.setLight=function(e,i){void 0===i&&(i={}),this._checkLoaded();var o=this.light.getLight(),r=!1;for(var a in e)if(!t.deepEqual(e[a],o[a])){r=!0;break}if(r){var n={now:t.browser.now(),transition:t.extend({duration:300,delay:0},this.stylesheet.transition)};this.light.setLight(e,i),this.light.updateTransitions(n);}},i.prototype._validate=function(e,i,o,r,a){return void 0===a&&(a={}),(!a||!1!==a.validate)&&Ue(this,e.call(t.validateStyle,t.extend({key:i,style:this.serialize(),value:o,styleSpec:t.styleSpec},r)))},i.prototype._remove=function(){for(var e in this._request&&(this._request.cancel(),this._request=null),this._spriteRequest&&(this._spriteRequest.cancel(),this._spriteRequest=null),t.evented.off(\"pluginStateChange\",this._rtlTextPluginCallback),this._layers)this._layers[e].setEventedParent(null);for(var i in this.sourceCaches)this.sourceCaches[i].clearTiles(),this.sourceCaches[i].setEventedParent(null);this.imageManager.setEventedParent(null),this.setEventedParent(null),this.dispatcher.remove();},i.prototype._clearSource=function(t){this.sourceCaches[t].clearTiles();},i.prototype._reloadSource=function(t){this.sourceCaches[t].resume(),this.sourceCaches[t].reload();},i.prototype._updateSources=function(t){for(var e in this.sourceCaches)this.sourceCaches[e].update(t);},i.prototype._generateCollisionBoxes=function(){for(var t in this.sourceCaches)this._reloadSource(t);},i.prototype._updatePlacement=function(e,i,o,r,a){void 0===a&&(a=!1);for(var n=!1,s=!1,l={},c=0,u=this._order;c<u.length;c+=1){var h=this._layers[u[c]];if(\"symbol\"===h.type){if(!l[h.source]){var p=this.sourceCaches[h.source];l[h.source]=p.getRenderableIds(!0).map((function(t){return p.getTileByID(t)})).sort((function(t,e){return e.tileID.overscaledZ-t.tileID.overscaledZ||(t.tileID.isLessThan(e.tileID)?-1:1)}));}var d=this.crossTileSymbolIndex.addLayer(h,l[h.source],e.center.lng);n=n||d;}}if(this.crossTileSymbolIndex.pruneUnusedLayers(this._order),((a=a||this._layerOrderChanged||0===o)||!this.pauseablePlacement||this.pauseablePlacement.isDone()&&!this.placement.stillRecent(t.browser.now(),e.zoom))&&(this.pauseablePlacement=new Le(e,this._order,a,i,o,r,this.placement),this._layerOrderChanged=!1),this.pauseablePlacement.isDone()?this.placement.setStale():(this.pauseablePlacement.continuePlacement(this._order,this._layers,l),this.pauseablePlacement.isDone()&&(this.placement=this.pauseablePlacement.commit(t.browser.now()),s=!0),n&&this.pauseablePlacement.placement.setStale()),s||n)for(var _=0,f=this._order;_<f.length;_+=1){var m=this._layers[f[_]];\"symbol\"===m.type&&this.placement.updateLayerOpacities(m,l[m.source]);}return !this.pauseablePlacement.isDone()||this.placement.hasTransitions(t.browser.now())},i.prototype._releaseSymbolFadeTiles=function(){for(var t in this.sourceCaches)this.sourceCaches[t].releaseSymbolFadeTiles();},i.prototype.getImages=function(t,e,i){this.imageManager.getImages(e.icons,i),this._updateTilesForChangedImages();var o=this.sourceCaches[e.source];o&&o.setDependencies(e.tileID.key,e.type,e.icons);},i.prototype.getGlyphs=function(t,e,i){this.glyphManager.getGlyphs(e.stacks,i);},i.prototype.getResource=function(e,i,o){return t.makeRequest(i,o)},i}(t.Evented);je.getSourceType=function(t){return k[t]},je.setSourceType=function(t,e){k[t]=e;},je.registerForPluginStateChange=t.registerForPluginStateChange;var Ve=t.createLayout([{name:\"a_pos\",type:\"Int16\",components:2}]),Ge=gi(\"#ifdef GL_ES\\nprecision mediump float;\\n#else\\n#if !defined(lowp)\\n#define lowp\\n#endif\\n#if !defined(mediump)\\n#define mediump\\n#endif\\n#if !defined(highp)\\n#define highp\\n#endif\\n#endif\",\"#ifdef GL_ES\\nprecision highp float;\\n#else\\n#if !defined(lowp)\\n#define lowp\\n#endif\\n#if !defined(mediump)\\n#define mediump\\n#endif\\n#if !defined(highp)\\n#define highp\\n#endif\\n#endif\\nvec2 unpack_float(const float packedValue) {int packedIntValue=int(packedValue);int v0=packedIntValue/256;return vec2(v0,packedIntValue-v0*256);}vec2 unpack_opacity(const float packedOpacity) {int intOpacity=int(packedOpacity)/2;return vec2(float(intOpacity)/127.0,mod(packedOpacity,2.0));}vec4 decode_color(const vec2 encodedColor) {return vec4(unpack_float(encodedColor[0])/255.0,unpack_float(encodedColor[1])/255.0\\n);}float unpack_mix_vec2(const vec2 packedValue,const float t) {return mix(packedValue[0],packedValue[1],t);}vec4 unpack_mix_color(const vec4 packedColors,const float t) {vec4 minColor=decode_color(vec2(packedColors[0],packedColors[1]));vec4 maxColor=decode_color(vec2(packedColors[2],packedColors[3]));return mix(minColor,maxColor,t);}vec2 get_pattern_pos(const vec2 pixel_coord_upper,const vec2 pixel_coord_lower,const vec2 pattern_size,const float tile_units_to_pixels,const vec2 pos) {vec2 offset=mod(mod(mod(pixel_coord_upper,pattern_size)*256.0,pattern_size)*256.0+pixel_coord_lower,pattern_size);return (tile_units_to_pixels*pos+offset)/pattern_size;}\"),We=gi(\"uniform vec4 u_color;uniform float u_opacity;void main() {gl_FragColor=u_color*u_opacity;\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"attribute vec2 a_pos;uniform mat4 u_matrix;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);}\"),Xe=gi(\"uniform vec2 u_pattern_tl_a;uniform vec2 u_pattern_br_a;uniform vec2 u_pattern_tl_b;uniform vec2 u_pattern_br_b;uniform vec2 u_texsize;uniform float u_mix;uniform float u_opacity;uniform sampler2D u_image;varying vec2 v_pos_a;varying vec2 v_pos_b;void main() {vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(u_pattern_tl_a/u_texsize,u_pattern_br_a/u_texsize,imagecoord);vec4 color1=texture2D(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(u_pattern_tl_b/u_texsize,u_pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture2D(u_image,pos2);gl_FragColor=mix(color1,color2,u_mix)*u_opacity;\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"uniform mat4 u_matrix;uniform vec2 u_pattern_size_a;uniform vec2 u_pattern_size_b;uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform float u_scale_a;uniform float u_scale_b;uniform float u_tile_units_to_pixels;attribute vec2 a_pos;varying vec2 v_pos_a;varying vec2 v_pos_b;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,u_scale_a*u_pattern_size_a,u_tile_units_to_pixels,a_pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,u_scale_b*u_pattern_size_b,u_tile_units_to_pixels,a_pos);}\"),He=gi(\"varying vec3 v_data;\\n#pragma mapbox: define highp vec4 color\\n#pragma mapbox: define mediump float radius\\n#pragma mapbox: define lowp float blur\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define highp vec4 stroke_color\\n#pragma mapbox: define mediump float stroke_width\\n#pragma mapbox: define lowp float stroke_opacity\\nvoid main() {\\n#pragma mapbox: initialize highp vec4 color\\n#pragma mapbox: initialize mediump float radius\\n#pragma mapbox: initialize lowp float blur\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize highp vec4 stroke_color\\n#pragma mapbox: initialize mediump float stroke_width\\n#pragma mapbox: initialize lowp float stroke_opacity\\nvec2 extrude=v_data.xy;float extrude_length=length(extrude);lowp float antialiasblur=v_data.z;float antialiased_blur=-max(blur,antialiasblur);float opacity_t=smoothstep(0.0,antialiased_blur,extrude_length-1.0);float color_t=stroke_width < 0.01 ? 0.0 : smoothstep(antialiased_blur,0.0,extrude_length-radius/(radius+stroke_width));gl_FragColor=opacity_t*mix(color*opacity,stroke_color*stroke_opacity,color_t);\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"uniform mat4 u_matrix;uniform bool u_scale_with_map;uniform bool u_pitch_with_map;uniform vec2 u_extrude_scale;uniform lowp float u_device_pixel_ratio;uniform highp float u_camera_to_center_distance;attribute vec2 a_pos;varying vec3 v_data;\\n#pragma mapbox: define highp vec4 color\\n#pragma mapbox: define mediump float radius\\n#pragma mapbox: define lowp float blur\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define highp vec4 stroke_color\\n#pragma mapbox: define mediump float stroke_width\\n#pragma mapbox: define lowp float stroke_opacity\\nvoid main(void) {\\n#pragma mapbox: initialize highp vec4 color\\n#pragma mapbox: initialize mediump float radius\\n#pragma mapbox: initialize lowp float blur\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize highp vec4 stroke_color\\n#pragma mapbox: initialize mediump float stroke_width\\n#pragma mapbox: initialize lowp float stroke_opacity\\nvec2 extrude=vec2(mod(a_pos,2.0)*2.0-1.0);vec2 circle_center=floor(a_pos*0.5);if (u_pitch_with_map) {vec2 corner_position=circle_center;if (u_scale_with_map) {corner_position+=extrude*(radius+stroke_width)*u_extrude_scale;} else {vec4 projected_center=u_matrix*vec4(circle_center,0,1);corner_position+=extrude*(radius+stroke_width)*u_extrude_scale*(projected_center.w/u_camera_to_center_distance);}gl_Position=u_matrix*vec4(corner_position,0,1);} else {gl_Position=u_matrix*vec4(circle_center,0,1);if (u_scale_with_map) {gl_Position.xy+=extrude*(radius+stroke_width)*u_extrude_scale*u_camera_to_center_distance;} else {gl_Position.xy+=extrude*(radius+stroke_width)*u_extrude_scale*gl_Position.w;}}lowp float antialiasblur=1.0/u_device_pixel_ratio/(radius+stroke_width);v_data=vec3(extrude.x,extrude.y,antialiasblur);}\"),Ke=gi(\"void main() {gl_FragColor=vec4(1.0);}\",\"attribute vec2 a_pos;uniform mat4 u_matrix;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);}\"),Ye=gi(\"uniform highp float u_intensity;varying vec2 v_extrude;\\n#pragma mapbox: define highp float weight\\n#define GAUSS_COEF 0.3989422804014327\\nvoid main() {\\n#pragma mapbox: initialize highp float weight\\nfloat d=-0.5*3.0*3.0*dot(v_extrude,v_extrude);float val=weight*u_intensity*GAUSS_COEF*exp(d);gl_FragColor=vec4(val,1.0,1.0,1.0);\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"uniform mat4 u_matrix;uniform float u_extrude_scale;uniform float u_opacity;uniform float u_intensity;attribute vec2 a_pos;varying vec2 v_extrude;\\n#pragma mapbox: define highp float weight\\n#pragma mapbox: define mediump float radius\\nconst highp float ZERO=1.0/255.0/16.0;\\n#define GAUSS_COEF 0.3989422804014327\\nvoid main(void) {\\n#pragma mapbox: initialize highp float weight\\n#pragma mapbox: initialize mediump float radius\\nvec2 unscaled_extrude=vec2(mod(a_pos,2.0)*2.0-1.0);float S=sqrt(-2.0*log(ZERO/weight/u_intensity/GAUSS_COEF))/3.0;v_extrude=S*unscaled_extrude;vec2 extrude=v_extrude*radius*u_extrude_scale;vec4 pos=vec4(floor(a_pos*0.5)+extrude,0,1);gl_Position=u_matrix*pos;}\"),Je=gi(\"uniform sampler2D u_image;uniform sampler2D u_color_ramp;uniform float u_opacity;varying vec2 v_pos;void main() {float t=texture2D(u_image,v_pos).r;vec4 color=texture2D(u_color_ramp,vec2(t,0.5));gl_FragColor=color*u_opacity;\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(0.0);\\n#endif\\n}\",\"uniform mat4 u_matrix;uniform vec2 u_world;attribute vec2 a_pos;varying vec2 v_pos;void main() {gl_Position=u_matrix*vec4(a_pos*u_world,0,1);v_pos.x=a_pos.x;v_pos.y=1.0-a_pos.y;}\"),Qe=gi(\"varying float v_placed;varying float v_notUsed;void main() {float alpha=0.5;gl_FragColor=vec4(1.0,0.0,0.0,1.0)*alpha;if (v_placed > 0.5) {gl_FragColor=vec4(0.0,0.0,1.0,0.5)*alpha;}if (v_notUsed > 0.5) {gl_FragColor*=.1;}}\",\"attribute vec2 a_pos;attribute vec2 a_anchor_pos;attribute vec2 a_extrude;attribute vec2 a_placed;attribute vec2 a_shift;uniform mat4 u_matrix;uniform vec2 u_extrude_scale;uniform float u_camera_to_center_distance;varying float v_placed;varying float v_notUsed;void main() {vec4 projectedPoint=u_matrix*vec4(a_anchor_pos,0,1);highp float camera_to_anchor_distance=projectedPoint.w;highp float collision_perspective_ratio=clamp(0.5+0.5*(u_camera_to_center_distance/camera_to_anchor_distance),0.0,4.0);gl_Position=u_matrix*vec4(a_pos,0.0,1.0);gl_Position.xy+=(a_extrude+a_shift)*u_extrude_scale*gl_Position.w*collision_perspective_ratio;v_placed=a_placed.x;v_notUsed=a_placed.y;}\"),$e=gi(\"varying float v_radius;varying vec2 v_extrude;varying float v_perspective_ratio;varying float v_collision;void main() {float alpha=0.5*min(v_perspective_ratio,1.0);float stroke_radius=0.9*max(v_perspective_ratio,1.0);float distance_to_center=length(v_extrude);float distance_to_edge=abs(distance_to_center-v_radius);float opacity_t=smoothstep(-stroke_radius,0.0,-distance_to_edge);vec4 color=mix(vec4(0.0,0.0,1.0,0.5),vec4(1.0,0.0,0.0,1.0),v_collision);gl_FragColor=color*alpha*opacity_t;}\",\"attribute vec2 a_pos;attribute float a_radius;attribute vec2 a_flags;uniform mat4 u_matrix;uniform mat4 u_inv_matrix;uniform vec2 u_viewport_size;uniform float u_camera_to_center_distance;varying float v_radius;varying vec2 v_extrude;varying float v_perspective_ratio;varying float v_collision;vec3 toTilePosition(vec2 screenPos) {vec4 rayStart=u_inv_matrix*vec4(screenPos,-1.0,1.0);vec4 rayEnd  =u_inv_matrix*vec4(screenPos, 1.0,1.0);rayStart.xyz/=rayStart.w;rayEnd.xyz  /=rayEnd.w;highp float t=(0.0-rayStart.z)/(rayEnd.z-rayStart.z);return mix(rayStart.xyz,rayEnd.xyz,t);}void main() {vec2 quadCenterPos=a_pos;float radius=a_radius;float collision=a_flags.x;float vertexIdx=a_flags.y;vec2 quadVertexOffset=vec2(mix(-1.0,1.0,float(vertexIdx >=2.0)),mix(-1.0,1.0,float(vertexIdx >=1.0 && vertexIdx <=2.0)));vec2 quadVertexExtent=quadVertexOffset*radius;vec3 tilePos=toTilePosition(quadCenterPos);vec4 clipPos=u_matrix*vec4(tilePos,1.0);highp float camera_to_anchor_distance=clipPos.w;highp float collision_perspective_ratio=clamp(0.5+0.5*(u_camera_to_center_distance/camera_to_anchor_distance),0.0,4.0);float padding_factor=1.2;v_radius=radius;v_extrude=quadVertexExtent*padding_factor;v_perspective_ratio=collision_perspective_ratio;v_collision=collision;gl_Position=vec4(clipPos.xyz/clipPos.w,1.0)+vec4(quadVertexExtent*padding_factor/u_viewport_size*2.0,0.0,0.0);}\"),ti=gi(\"uniform highp vec4 u_color;uniform sampler2D u_overlay;varying vec2 v_uv;void main() {vec4 overlay_color=texture2D(u_overlay,v_uv);gl_FragColor=mix(u_color,overlay_color,overlay_color.a);}\",\"attribute vec2 a_pos;varying vec2 v_uv;uniform mat4 u_matrix;uniform float u_overlay_scale;void main() {v_uv=a_pos/8192.0;gl_Position=u_matrix*vec4(a_pos*u_overlay_scale,0,1);}\"),ei=gi(\"#pragma mapbox: define highp vec4 color\\n#pragma mapbox: define lowp float opacity\\nvoid main() {\\n#pragma mapbox: initialize highp vec4 color\\n#pragma mapbox: initialize lowp float opacity\\ngl_FragColor=color*opacity;\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"attribute vec2 a_pos;uniform mat4 u_matrix;\\n#pragma mapbox: define highp vec4 color\\n#pragma mapbox: define lowp float opacity\\nvoid main() {\\n#pragma mapbox: initialize highp vec4 color\\n#pragma mapbox: initialize lowp float opacity\\ngl_Position=u_matrix*vec4(a_pos,0,1);}\"),ii=gi(\"varying vec2 v_pos;\\n#pragma mapbox: define highp vec4 outline_color\\n#pragma mapbox: define lowp float opacity\\nvoid main() {\\n#pragma mapbox: initialize highp vec4 outline_color\\n#pragma mapbox: initialize lowp float opacity\\nfloat dist=length(v_pos-gl_FragCoord.xy);float alpha=1.0-smoothstep(0.0,1.0,dist);gl_FragColor=outline_color*(alpha*opacity);\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"attribute vec2 a_pos;uniform mat4 u_matrix;uniform vec2 u_world;varying vec2 v_pos;\\n#pragma mapbox: define highp vec4 outline_color\\n#pragma mapbox: define lowp float opacity\\nvoid main() {\\n#pragma mapbox: initialize highp vec4 outline_color\\n#pragma mapbox: initialize lowp float opacity\\ngl_Position=u_matrix*vec4(a_pos,0,1);v_pos=(gl_Position.xy/gl_Position.w+1.0)/2.0*u_world;}\"),oi=gi(\"uniform vec2 u_texsize;uniform sampler2D u_image;uniform float u_fade;varying vec2 v_pos_a;varying vec2 v_pos_b;varying vec2 v_pos;\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define lowp vec4 pattern_from\\n#pragma mapbox: define lowp vec4 pattern_to\\nvoid main() {\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize mediump vec4 pattern_from\\n#pragma mapbox: initialize mediump vec4 pattern_to\\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(pattern_tl_a/u_texsize,pattern_br_a/u_texsize,imagecoord);vec4 color1=texture2D(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(pattern_tl_b/u_texsize,pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture2D(u_image,pos2);float dist=length(v_pos-gl_FragCoord.xy);float alpha=1.0-smoothstep(0.0,1.0,dist);gl_FragColor=mix(color1,color2,u_fade)*alpha*opacity;\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"uniform mat4 u_matrix;uniform vec2 u_world;uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform vec3 u_scale;attribute vec2 a_pos;varying vec2 v_pos_a;varying vec2 v_pos_b;varying vec2 v_pos;\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define lowp vec4 pattern_from\\n#pragma mapbox: define lowp vec4 pattern_to\\n#pragma mapbox: define lowp float pixel_ratio_from\\n#pragma mapbox: define lowp float pixel_ratio_to\\nvoid main() {\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize mediump vec4 pattern_from\\n#pragma mapbox: initialize mediump vec4 pattern_to\\n#pragma mapbox: initialize lowp float pixel_ratio_from\\n#pragma mapbox: initialize lowp float pixel_ratio_to\\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;gl_Position=u_matrix*vec4(a_pos,0,1);vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,fromScale*display_size_a,tileRatio,a_pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,toScale*display_size_b,tileRatio,a_pos);v_pos=(gl_Position.xy/gl_Position.w+1.0)/2.0*u_world;}\"),ri=gi(\"uniform vec2 u_texsize;uniform float u_fade;uniform sampler2D u_image;varying vec2 v_pos_a;varying vec2 v_pos_b;\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define lowp vec4 pattern_from\\n#pragma mapbox: define lowp vec4 pattern_to\\nvoid main() {\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize mediump vec4 pattern_from\\n#pragma mapbox: initialize mediump vec4 pattern_to\\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(pattern_tl_a/u_texsize,pattern_br_a/u_texsize,imagecoord);vec4 color1=texture2D(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(pattern_tl_b/u_texsize,pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture2D(u_image,pos2);gl_FragColor=mix(color1,color2,u_fade)*opacity;\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"uniform mat4 u_matrix;uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform vec3 u_scale;attribute vec2 a_pos;varying vec2 v_pos_a;varying vec2 v_pos_b;\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define lowp vec4 pattern_from\\n#pragma mapbox: define lowp vec4 pattern_to\\n#pragma mapbox: define lowp float pixel_ratio_from\\n#pragma mapbox: define lowp float pixel_ratio_to\\nvoid main() {\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize mediump vec4 pattern_from\\n#pragma mapbox: initialize mediump vec4 pattern_to\\n#pragma mapbox: initialize lowp float pixel_ratio_from\\n#pragma mapbox: initialize lowp float pixel_ratio_to\\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileZoomRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;gl_Position=u_matrix*vec4(a_pos,0,1);v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,fromScale*display_size_a,tileZoomRatio,a_pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,toScale*display_size_b,tileZoomRatio,a_pos);}\"),ai=gi(\"varying vec4 v_color;void main() {gl_FragColor=v_color;\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"uniform mat4 u_matrix;uniform vec3 u_lightcolor;uniform lowp vec3 u_lightpos;uniform lowp float u_lightintensity;uniform float u_vertical_gradient;uniform lowp float u_opacity;attribute vec2 a_pos;attribute vec4 a_normal_ed;varying vec4 v_color;\\n#pragma mapbox: define highp float base\\n#pragma mapbox: define highp float height\\n#pragma mapbox: define highp vec4 color\\nvoid main() {\\n#pragma mapbox: initialize highp float base\\n#pragma mapbox: initialize highp float height\\n#pragma mapbox: initialize highp vec4 color\\nvec3 normal=a_normal_ed.xyz;base=max(0.0,base);height=max(0.0,height);float t=mod(normal.x,2.0);gl_Position=u_matrix*vec4(a_pos,t > 0.0 ? height : base,1);float colorvalue=color.r*0.2126+color.g*0.7152+color.b*0.0722;v_color=vec4(0.0,0.0,0.0,1.0);vec4 ambientlight=vec4(0.03,0.03,0.03,1.0);color+=ambientlight;float directional=clamp(dot(normal/16384.0,u_lightpos),0.0,1.0);directional=mix((1.0-u_lightintensity),max((1.0-colorvalue+u_lightintensity),1.0),directional);if (normal.y !=0.0) {directional*=((1.0-u_vertical_gradient)+(u_vertical_gradient*clamp((t+base)*pow(height/150.0,0.5),mix(0.7,0.98,1.0-u_lightintensity),1.0)));}v_color.r+=clamp(color.r*directional*u_lightcolor.r,mix(0.0,0.3,1.0-u_lightcolor.r),1.0);v_color.g+=clamp(color.g*directional*u_lightcolor.g,mix(0.0,0.3,1.0-u_lightcolor.g),1.0);v_color.b+=clamp(color.b*directional*u_lightcolor.b,mix(0.0,0.3,1.0-u_lightcolor.b),1.0);v_color*=u_opacity;}\"),ni=gi(\"uniform vec2 u_texsize;uniform float u_fade;uniform sampler2D u_image;varying vec2 v_pos_a;varying vec2 v_pos_b;varying vec4 v_lighting;\\n#pragma mapbox: define lowp float base\\n#pragma mapbox: define lowp float height\\n#pragma mapbox: define lowp vec4 pattern_from\\n#pragma mapbox: define lowp vec4 pattern_to\\n#pragma mapbox: define lowp float pixel_ratio_from\\n#pragma mapbox: define lowp float pixel_ratio_to\\nvoid main() {\\n#pragma mapbox: initialize lowp float base\\n#pragma mapbox: initialize lowp float height\\n#pragma mapbox: initialize mediump vec4 pattern_from\\n#pragma mapbox: initialize mediump vec4 pattern_to\\n#pragma mapbox: initialize lowp float pixel_ratio_from\\n#pragma mapbox: initialize lowp float pixel_ratio_to\\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(pattern_tl_a/u_texsize,pattern_br_a/u_texsize,imagecoord);vec4 color1=texture2D(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(pattern_tl_b/u_texsize,pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture2D(u_image,pos2);vec4 mixedColor=mix(color1,color2,u_fade);gl_FragColor=mixedColor*v_lighting;\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"uniform mat4 u_matrix;uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform float u_height_factor;uniform vec3 u_scale;uniform float u_vertical_gradient;uniform lowp float u_opacity;uniform vec3 u_lightcolor;uniform lowp vec3 u_lightpos;uniform lowp float u_lightintensity;attribute vec2 a_pos;attribute vec4 a_normal_ed;varying vec2 v_pos_a;varying vec2 v_pos_b;varying vec4 v_lighting;\\n#pragma mapbox: define lowp float base\\n#pragma mapbox: define lowp float height\\n#pragma mapbox: define lowp vec4 pattern_from\\n#pragma mapbox: define lowp vec4 pattern_to\\n#pragma mapbox: define lowp float pixel_ratio_from\\n#pragma mapbox: define lowp float pixel_ratio_to\\nvoid main() {\\n#pragma mapbox: initialize lowp float base\\n#pragma mapbox: initialize lowp float height\\n#pragma mapbox: initialize mediump vec4 pattern_from\\n#pragma mapbox: initialize mediump vec4 pattern_to\\n#pragma mapbox: initialize lowp float pixel_ratio_from\\n#pragma mapbox: initialize lowp float pixel_ratio_to\\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;vec3 normal=a_normal_ed.xyz;float edgedistance=a_normal_ed.w;vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;base=max(0.0,base);height=max(0.0,height);float t=mod(normal.x,2.0);float z=t > 0.0 ? height : base;gl_Position=u_matrix*vec4(a_pos,z,1);vec2 pos=normal.x==1.0 && normal.y==0.0 && normal.z==16384.0\\n? a_pos\\n: vec2(edgedistance,z*u_height_factor);v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,fromScale*display_size_a,tileRatio,pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,toScale*display_size_b,tileRatio,pos);v_lighting=vec4(0.0,0.0,0.0,1.0);float directional=clamp(dot(normal/16383.0,u_lightpos),0.0,1.0);directional=mix((1.0-u_lightintensity),max((0.5+u_lightintensity),1.0),directional);if (normal.y !=0.0) {directional*=((1.0-u_vertical_gradient)+(u_vertical_gradient*clamp((t+base)*pow(height/150.0,0.5),mix(0.7,0.98,1.0-u_lightintensity),1.0)));}v_lighting.rgb+=clamp(directional*u_lightcolor,mix(vec3(0.0),vec3(0.3),1.0-u_lightcolor),vec3(1.0));v_lighting*=u_opacity;}\"),si=gi(\"#ifdef GL_ES\\nprecision highp float;\\n#endif\\nuniform sampler2D u_image;varying vec2 v_pos;uniform vec2 u_dimension;uniform float u_zoom;uniform vec4 u_unpack;float getElevation(vec2 coord,float bias) {vec4 data=texture2D(u_image,coord)*255.0;data.a=-1.0;return dot(data,u_unpack)/4.0;}void main() {vec2 epsilon=1.0/u_dimension;float a=getElevation(v_pos+vec2(-epsilon.x,-epsilon.y),0.0);float b=getElevation(v_pos+vec2(0,-epsilon.y),0.0);float c=getElevation(v_pos+vec2(epsilon.x,-epsilon.y),0.0);float d=getElevation(v_pos+vec2(-epsilon.x,0),0.0);float e=getElevation(v_pos,0.0);float f=getElevation(v_pos+vec2(epsilon.x,0),0.0);float g=getElevation(v_pos+vec2(-epsilon.x,epsilon.y),0.0);float h=getElevation(v_pos+vec2(0,epsilon.y),0.0);float i=getElevation(v_pos+vec2(epsilon.x,epsilon.y),0.0);float exaggerationFactor=u_zoom < 2.0 ? 0.4 : u_zoom < 4.5 ? 0.35 : 0.3;float exaggeration=u_zoom < 15.0 ? (u_zoom-15.0)*exaggerationFactor : 0.0;vec2 deriv=vec2((c+f+f+i)-(a+d+d+g),(g+h+h+i)-(a+b+b+c))/pow(2.0,exaggeration+(19.2562-u_zoom));gl_FragColor=clamp(vec4(deriv.x/2.0+0.5,deriv.y/2.0+0.5,1.0,1.0),0.0,1.0);\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"uniform mat4 u_matrix;uniform vec2 u_dimension;attribute vec2 a_pos;attribute vec2 a_texture_pos;varying vec2 v_pos;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);highp vec2 epsilon=1.0/u_dimension;float scale=(u_dimension.x-2.0)/u_dimension.x;v_pos=(a_texture_pos/8192.0)*scale+epsilon;}\"),li=gi(\"uniform sampler2D u_image;varying vec2 v_pos;uniform vec2 u_latrange;uniform vec2 u_light;uniform vec4 u_shadow;uniform vec4 u_highlight;uniform vec4 u_accent;\\n#define PI 3.141592653589793\\nvoid main() {vec4 pixel=texture2D(u_image,v_pos);vec2 deriv=((pixel.rg*2.0)-1.0);float scaleFactor=cos(radians((u_latrange[0]-u_latrange[1])*(1.0-v_pos.y)+u_latrange[1]));float slope=atan(1.25*length(deriv)/scaleFactor);float aspect=deriv.x !=0.0 ? atan(deriv.y,-deriv.x) : PI/2.0*(deriv.y > 0.0 ? 1.0 :-1.0);float intensity=u_light.x;float azimuth=u_light.y+PI;float base=1.875-intensity*1.75;float maxValue=0.5*PI;float scaledSlope=intensity !=0.5 ? ((pow(base,slope)-1.0)/(pow(base,maxValue)-1.0))*maxValue : slope;float accent=cos(scaledSlope);vec4 accent_color=(1.0-accent)*u_accent*clamp(intensity*2.0,0.0,1.0);float shade=abs(mod((aspect+azimuth)/PI+0.5,2.0)-1.0);vec4 shade_color=mix(u_shadow,u_highlight,shade)*sin(scaledSlope)*clamp(intensity*2.0,0.0,1.0);gl_FragColor=accent_color*(1.0-shade_color.a)+shade_color;\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"uniform mat4 u_matrix;attribute vec2 a_pos;attribute vec2 a_texture_pos;varying vec2 v_pos;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);v_pos=a_texture_pos/8192.0;}\"),ci=gi(\"uniform lowp float u_device_pixel_ratio;varying vec2 v_width2;varying vec2 v_normal;varying float v_gamma_scale;\\n#pragma mapbox: define highp vec4 color\\n#pragma mapbox: define lowp float blur\\n#pragma mapbox: define lowp float opacity\\nvoid main() {\\n#pragma mapbox: initialize highp vec4 color\\n#pragma mapbox: initialize lowp float blur\\n#pragma mapbox: initialize lowp float opacity\\nfloat dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);gl_FragColor=color*(alpha*opacity);\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"\\n#define scale 0.015873016\\nattribute vec2 a_pos_normal;attribute vec4 a_data;uniform mat4 u_matrix;uniform mediump float u_ratio;uniform vec2 u_units_to_pixels;uniform lowp float u_device_pixel_ratio;varying vec2 v_normal;varying vec2 v_width2;varying float v_gamma_scale;varying highp float v_linesofar;\\n#pragma mapbox: define highp vec4 color\\n#pragma mapbox: define lowp float blur\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define mediump float gapwidth\\n#pragma mapbox: define lowp float offset\\n#pragma mapbox: define mediump float width\\nvoid main() {\\n#pragma mapbox: initialize highp vec4 color\\n#pragma mapbox: initialize lowp float blur\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize mediump float gapwidth\\n#pragma mapbox: initialize lowp float offset\\n#pragma mapbox: initialize mediump float width\\nfloat ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=a_data.xy-128.0;float a_direction=mod(a_data.z,4.0)-1.0;v_linesofar=(floor(a_data.z/4.0)+a_data.w*64.0)*2.0;vec2 pos=floor(a_pos_normal*0.5);mediump vec2 normal=a_pos_normal-2.0*pos;normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);vec4 projected_extrude=u_matrix*vec4(dist/u_ratio,0.0,0.0);gl_Position=u_matrix*vec4(pos+offset2/u_ratio,0.0,1.0)+projected_extrude;float extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length(projected_extrude.xy/gl_Position.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;v_width2=vec2(outset,inset);}\"),ui=gi(\"uniform lowp float u_device_pixel_ratio;uniform sampler2D u_image;varying vec2 v_width2;varying vec2 v_normal;varying float v_gamma_scale;varying highp vec2 v_uv;\\n#pragma mapbox: define lowp float blur\\n#pragma mapbox: define lowp float opacity\\nvoid main() {\\n#pragma mapbox: initialize lowp float blur\\n#pragma mapbox: initialize lowp float opacity\\nfloat dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);vec4 color=texture2D(u_image,v_uv);gl_FragColor=color*(alpha*opacity);\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"\\n#define scale 0.015873016\\nattribute vec2 a_pos_normal;attribute vec4 a_data;attribute float a_uv_x;attribute float a_split_index;uniform mat4 u_matrix;uniform mediump float u_ratio;uniform lowp float u_device_pixel_ratio;uniform vec2 u_units_to_pixels;uniform float u_image_height;varying vec2 v_normal;varying vec2 v_width2;varying float v_gamma_scale;varying highp vec2 v_uv;\\n#pragma mapbox: define lowp float blur\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define mediump float gapwidth\\n#pragma mapbox: define lowp float offset\\n#pragma mapbox: define mediump float width\\nvoid main() {\\n#pragma mapbox: initialize lowp float blur\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize mediump float gapwidth\\n#pragma mapbox: initialize lowp float offset\\n#pragma mapbox: initialize mediump float width\\nfloat ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=a_data.xy-128.0;float a_direction=mod(a_data.z,4.0)-1.0;highp float texel_height=1.0/u_image_height;highp float half_texel_height=0.5*texel_height;v_uv=vec2(a_uv_x,a_split_index*texel_height-half_texel_height);vec2 pos=floor(a_pos_normal*0.5);mediump vec2 normal=a_pos_normal-2.0*pos;normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);vec4 projected_extrude=u_matrix*vec4(dist/u_ratio,0.0,0.0);gl_Position=u_matrix*vec4(pos+offset2/u_ratio,0.0,1.0)+projected_extrude;float extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length(projected_extrude.xy/gl_Position.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;v_width2=vec2(outset,inset);}\"),hi=gi(\"uniform lowp float u_device_pixel_ratio;uniform vec2 u_texsize;uniform float u_fade;uniform mediump vec3 u_scale;uniform sampler2D u_image;varying vec2 v_normal;varying vec2 v_width2;varying float v_linesofar;varying float v_gamma_scale;varying float v_width;\\n#pragma mapbox: define lowp vec4 pattern_from\\n#pragma mapbox: define lowp vec4 pattern_to\\n#pragma mapbox: define lowp float pixel_ratio_from\\n#pragma mapbox: define lowp float pixel_ratio_to\\n#pragma mapbox: define lowp float blur\\n#pragma mapbox: define lowp float opacity\\nvoid main() {\\n#pragma mapbox: initialize mediump vec4 pattern_from\\n#pragma mapbox: initialize mediump vec4 pattern_to\\n#pragma mapbox: initialize lowp float pixel_ratio_from\\n#pragma mapbox: initialize lowp float pixel_ratio_to\\n#pragma mapbox: initialize lowp float blur\\n#pragma mapbox: initialize lowp float opacity\\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileZoomRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;vec2 pattern_size_a=vec2(display_size_a.x*fromScale/tileZoomRatio,display_size_a.y);vec2 pattern_size_b=vec2(display_size_b.x*toScale/tileZoomRatio,display_size_b.y);float aspect_a=display_size_a.y/v_width;float aspect_b=display_size_b.y/v_width;float dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);float x_a=mod(v_linesofar/pattern_size_a.x*aspect_a,1.0);float x_b=mod(v_linesofar/pattern_size_b.x*aspect_b,1.0);float y=0.5*v_normal.y+0.5;vec2 texel_size=1.0/u_texsize;vec2 pos_a=mix(pattern_tl_a*texel_size-texel_size,pattern_br_a*texel_size+texel_size,vec2(x_a,y));vec2 pos_b=mix(pattern_tl_b*texel_size-texel_size,pattern_br_b*texel_size+texel_size,vec2(x_b,y));vec4 color=mix(texture2D(u_image,pos_a),texture2D(u_image,pos_b),u_fade);gl_FragColor=color*alpha*opacity;\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"\\n#define scale 0.015873016\\n#define LINE_DISTANCE_SCALE 2.0\\nattribute vec2 a_pos_normal;attribute vec4 a_data;uniform mat4 u_matrix;uniform vec2 u_units_to_pixels;uniform mediump float u_ratio;uniform lowp float u_device_pixel_ratio;varying vec2 v_normal;varying vec2 v_width2;varying float v_linesofar;varying float v_gamma_scale;varying float v_width;\\n#pragma mapbox: define lowp float blur\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define lowp float offset\\n#pragma mapbox: define mediump float gapwidth\\n#pragma mapbox: define mediump float width\\n#pragma mapbox: define lowp float floorwidth\\n#pragma mapbox: define lowp vec4 pattern_from\\n#pragma mapbox: define lowp vec4 pattern_to\\n#pragma mapbox: define lowp float pixel_ratio_from\\n#pragma mapbox: define lowp float pixel_ratio_to\\nvoid main() {\\n#pragma mapbox: initialize lowp float blur\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize lowp float offset\\n#pragma mapbox: initialize mediump float gapwidth\\n#pragma mapbox: initialize mediump float width\\n#pragma mapbox: initialize lowp float floorwidth\\n#pragma mapbox: initialize mediump vec4 pattern_from\\n#pragma mapbox: initialize mediump vec4 pattern_to\\n#pragma mapbox: initialize lowp float pixel_ratio_from\\n#pragma mapbox: initialize lowp float pixel_ratio_to\\nfloat ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=a_data.xy-128.0;float a_direction=mod(a_data.z,4.0)-1.0;float a_linesofar=(floor(a_data.z/4.0)+a_data.w*64.0)*LINE_DISTANCE_SCALE;vec2 pos=floor(a_pos_normal*0.5);mediump vec2 normal=a_pos_normal-2.0*pos;normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);vec4 projected_extrude=u_matrix*vec4(dist/u_ratio,0.0,0.0);gl_Position=u_matrix*vec4(pos+offset2/u_ratio,0.0,1.0)+projected_extrude;float extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length(projected_extrude.xy/gl_Position.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;v_linesofar=a_linesofar;v_width2=vec2(outset,inset);v_width=floorwidth;}\"),pi=gi(\"uniform lowp float u_device_pixel_ratio;uniform sampler2D u_image;uniform float u_sdfgamma;uniform float u_mix;varying vec2 v_normal;varying vec2 v_width2;varying vec2 v_tex_a;varying vec2 v_tex_b;varying float v_gamma_scale;\\n#pragma mapbox: define highp vec4 color\\n#pragma mapbox: define lowp float blur\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define mediump float width\\n#pragma mapbox: define lowp float floorwidth\\nvoid main() {\\n#pragma mapbox: initialize highp vec4 color\\n#pragma mapbox: initialize lowp float blur\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize mediump float width\\n#pragma mapbox: initialize lowp float floorwidth\\nfloat dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);float sdfdist_a=texture2D(u_image,v_tex_a).a;float sdfdist_b=texture2D(u_image,v_tex_b).a;float sdfdist=mix(sdfdist_a,sdfdist_b,u_mix);alpha*=smoothstep(0.5-u_sdfgamma/floorwidth,0.5+u_sdfgamma/floorwidth,sdfdist);gl_FragColor=color*(alpha*opacity);\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"\\n#define scale 0.015873016\\n#define LINE_DISTANCE_SCALE 2.0\\nattribute vec2 a_pos_normal;attribute vec4 a_data;uniform mat4 u_matrix;uniform mediump float u_ratio;uniform lowp float u_device_pixel_ratio;uniform vec2 u_patternscale_a;uniform float u_tex_y_a;uniform vec2 u_patternscale_b;uniform float u_tex_y_b;uniform vec2 u_units_to_pixels;varying vec2 v_normal;varying vec2 v_width2;varying vec2 v_tex_a;varying vec2 v_tex_b;varying float v_gamma_scale;\\n#pragma mapbox: define highp vec4 color\\n#pragma mapbox: define lowp float blur\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define mediump float gapwidth\\n#pragma mapbox: define lowp float offset\\n#pragma mapbox: define mediump float width\\n#pragma mapbox: define lowp float floorwidth\\nvoid main() {\\n#pragma mapbox: initialize highp vec4 color\\n#pragma mapbox: initialize lowp float blur\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize mediump float gapwidth\\n#pragma mapbox: initialize lowp float offset\\n#pragma mapbox: initialize mediump float width\\n#pragma mapbox: initialize lowp float floorwidth\\nfloat ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=a_data.xy-128.0;float a_direction=mod(a_data.z,4.0)-1.0;float a_linesofar=(floor(a_data.z/4.0)+a_data.w*64.0)*LINE_DISTANCE_SCALE;vec2 pos=floor(a_pos_normal*0.5);mediump vec2 normal=a_pos_normal-2.0*pos;normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);vec4 projected_extrude=u_matrix*vec4(dist/u_ratio,0.0,0.0);gl_Position=u_matrix*vec4(pos+offset2/u_ratio,0.0,1.0)+projected_extrude;float extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length(projected_extrude.xy/gl_Position.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;v_tex_a=vec2(a_linesofar*u_patternscale_a.x/floorwidth,normal.y*u_patternscale_a.y+u_tex_y_a);v_tex_b=vec2(a_linesofar*u_patternscale_b.x/floorwidth,normal.y*u_patternscale_b.y+u_tex_y_b);v_width2=vec2(outset,inset);}\"),di=gi(\"uniform float u_fade_t;uniform float u_opacity;uniform sampler2D u_image0;uniform sampler2D u_image1;varying vec2 v_pos0;varying vec2 v_pos1;uniform float u_brightness_low;uniform float u_brightness_high;uniform float u_saturation_factor;uniform float u_contrast_factor;uniform vec3 u_spin_weights;void main() {vec4 color0=texture2D(u_image0,v_pos0);vec4 color1=texture2D(u_image1,v_pos1);if (color0.a > 0.0) {color0.rgb=color0.rgb/color0.a;}if (color1.a > 0.0) {color1.rgb=color1.rgb/color1.a;}vec4 color=mix(color0,color1,u_fade_t);color.a*=u_opacity;vec3 rgb=color.rgb;rgb=vec3(dot(rgb,u_spin_weights.xyz),dot(rgb,u_spin_weights.zxy),dot(rgb,u_spin_weights.yzx));float average=(color.r+color.g+color.b)/3.0;rgb+=(average-rgb)*u_saturation_factor;rgb=(rgb-0.5)*u_contrast_factor+0.5;vec3 u_high_vec=vec3(u_brightness_low,u_brightness_low,u_brightness_low);vec3 u_low_vec=vec3(u_brightness_high,u_brightness_high,u_brightness_high);gl_FragColor=vec4(mix(u_high_vec,u_low_vec,rgb)*color.a,color.a);\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"uniform mat4 u_matrix;uniform vec2 u_tl_parent;uniform float u_scale_parent;uniform float u_buffer_scale;attribute vec2 a_pos;attribute vec2 a_texture_pos;varying vec2 v_pos0;varying vec2 v_pos1;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);v_pos0=(((a_texture_pos/8192.0)-0.5)/u_buffer_scale )+0.5;v_pos1=(v_pos0*u_scale_parent)+u_tl_parent;}\"),_i=gi(\"uniform sampler2D u_texture;varying vec2 v_tex;varying float v_fade_opacity;\\n#pragma mapbox: define lowp float opacity\\nvoid main() {\\n#pragma mapbox: initialize lowp float opacity\\nlowp float alpha=opacity*v_fade_opacity;gl_FragColor=texture2D(u_texture,v_tex)*alpha;\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"const float PI=3.141592653589793;attribute vec4 a_pos_offset;attribute vec4 a_data;attribute vec4 a_pixeloffset;attribute vec3 a_projected_pos;attribute float a_fade_opacity;uniform bool u_is_size_zoom_constant;uniform bool u_is_size_feature_constant;uniform highp float u_size_t;uniform highp float u_size;uniform highp float u_camera_to_center_distance;uniform highp float u_pitch;uniform bool u_rotate_symbol;uniform highp float u_aspect_ratio;uniform float u_fade_change;uniform mat4 u_matrix;uniform mat4 u_label_plane_matrix;uniform mat4 u_coord_matrix;uniform bool u_is_text;uniform bool u_pitch_with_map;uniform vec2 u_texsize;varying vec2 v_tex;varying float v_fade_opacity;\\n#pragma mapbox: define lowp float opacity\\nvoid main() {\\n#pragma mapbox: initialize lowp float opacity\\nvec2 a_pos=a_pos_offset.xy;vec2 a_offset=a_pos_offset.zw;vec2 a_tex=a_data.xy;vec2 a_size=a_data.zw;float a_size_min=floor(a_size[0]*0.5);vec2 a_pxoffset=a_pixeloffset.xy;vec2 a_minFontScale=a_pixeloffset.zw/256.0;highp float segment_angle=-a_projected_pos[2];float size;if (!u_is_size_zoom_constant && !u_is_size_feature_constant) {size=mix(a_size_min,a_size[1],u_size_t)/128.0;} else if (u_is_size_zoom_constant && !u_is_size_feature_constant) {size=a_size_min/128.0;} else {size=u_size;}vec4 projectedPoint=u_matrix*vec4(a_pos,0,1);highp float camera_to_anchor_distance=projectedPoint.w;highp float distance_ratio=u_pitch_with_map ?\\ncamera_to_anchor_distance/u_camera_to_center_distance :\\nu_camera_to_center_distance/camera_to_anchor_distance;highp float perspective_ratio=clamp(0.5+0.5*distance_ratio,0.0,4.0);size*=perspective_ratio;float fontScale=u_is_text ? size/24.0 : size;highp float symbol_rotation=0.0;if (u_rotate_symbol) {vec4 offsetProjectedPoint=u_matrix*vec4(a_pos+vec2(1,0),0,1);vec2 a=projectedPoint.xy/projectedPoint.w;vec2 b=offsetProjectedPoint.xy/offsetProjectedPoint.w;symbol_rotation=atan((b.y-a.y)/u_aspect_ratio,b.x-a.x);}highp float angle_sin=sin(segment_angle+symbol_rotation);highp float angle_cos=cos(segment_angle+symbol_rotation);mat2 rotation_matrix=mat2(angle_cos,-1.0*angle_sin,angle_sin,angle_cos);vec4 projected_pos=u_label_plane_matrix*vec4(a_projected_pos.xy,0.0,1.0);gl_Position=u_coord_matrix*vec4(projected_pos.xy/projected_pos.w+rotation_matrix*(a_offset/32.0*max(a_minFontScale,fontScale)+a_pxoffset/16.0),0.0,1.0);v_tex=a_tex/u_texsize;vec2 fade_opacity=unpack_opacity(a_fade_opacity);float fade_change=fade_opacity[1] > 0.5 ? u_fade_change :-u_fade_change;v_fade_opacity=max(0.0,min(1.0,fade_opacity[0]+fade_change));}\"),fi=gi(\"#define SDF_PX 8.0\\nuniform bool u_is_halo;uniform sampler2D u_texture;uniform highp float u_gamma_scale;uniform lowp float u_device_pixel_ratio;uniform bool u_is_text;varying vec2 v_data0;varying vec3 v_data1;\\n#pragma mapbox: define highp vec4 fill_color\\n#pragma mapbox: define highp vec4 halo_color\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define lowp float halo_width\\n#pragma mapbox: define lowp float halo_blur\\nvoid main() {\\n#pragma mapbox: initialize highp vec4 fill_color\\n#pragma mapbox: initialize highp vec4 halo_color\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize lowp float halo_width\\n#pragma mapbox: initialize lowp float halo_blur\\nfloat EDGE_GAMMA=0.105/u_device_pixel_ratio;vec2 tex=v_data0.xy;float gamma_scale=v_data1.x;float size=v_data1.y;float fade_opacity=v_data1[2];float fontScale=u_is_text ? size/24.0 : size;lowp vec4 color=fill_color;highp float gamma=EDGE_GAMMA/(fontScale*u_gamma_scale);lowp float buff=(256.0-64.0)/256.0;if (u_is_halo) {color=halo_color;gamma=(halo_blur*1.19/SDF_PX+EDGE_GAMMA)/(fontScale*u_gamma_scale);buff=(6.0-halo_width/fontScale)/SDF_PX;}lowp float dist=texture2D(u_texture,tex).a;highp float gamma_scaled=gamma*gamma_scale;highp float alpha=smoothstep(buff-gamma_scaled,buff+gamma_scaled,dist);gl_FragColor=color*(alpha*opacity*fade_opacity);\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"const float PI=3.141592653589793;attribute vec4 a_pos_offset;attribute vec4 a_data;attribute vec4 a_pixeloffset;attribute vec3 a_projected_pos;attribute float a_fade_opacity;uniform bool u_is_size_zoom_constant;uniform bool u_is_size_feature_constant;uniform highp float u_size_t;uniform highp float u_size;uniform mat4 u_matrix;uniform mat4 u_label_plane_matrix;uniform mat4 u_coord_matrix;uniform bool u_is_text;uniform bool u_pitch_with_map;uniform highp float u_pitch;uniform bool u_rotate_symbol;uniform highp float u_aspect_ratio;uniform highp float u_camera_to_center_distance;uniform float u_fade_change;uniform vec2 u_texsize;varying vec2 v_data0;varying vec3 v_data1;\\n#pragma mapbox: define highp vec4 fill_color\\n#pragma mapbox: define highp vec4 halo_color\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define lowp float halo_width\\n#pragma mapbox: define lowp float halo_blur\\nvoid main() {\\n#pragma mapbox: initialize highp vec4 fill_color\\n#pragma mapbox: initialize highp vec4 halo_color\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize lowp float halo_width\\n#pragma mapbox: initialize lowp float halo_blur\\nvec2 a_pos=a_pos_offset.xy;vec2 a_offset=a_pos_offset.zw;vec2 a_tex=a_data.xy;vec2 a_size=a_data.zw;float a_size_min=floor(a_size[0]*0.5);vec2 a_pxoffset=a_pixeloffset.xy;highp float segment_angle=-a_projected_pos[2];float size;if (!u_is_size_zoom_constant && !u_is_size_feature_constant) {size=mix(a_size_min,a_size[1],u_size_t)/128.0;} else if (u_is_size_zoom_constant && !u_is_size_feature_constant) {size=a_size_min/128.0;} else {size=u_size;}vec4 projectedPoint=u_matrix*vec4(a_pos,0,1);highp float camera_to_anchor_distance=projectedPoint.w;highp float distance_ratio=u_pitch_with_map ?\\ncamera_to_anchor_distance/u_camera_to_center_distance :\\nu_camera_to_center_distance/camera_to_anchor_distance;highp float perspective_ratio=clamp(0.5+0.5*distance_ratio,0.0,4.0);size*=perspective_ratio;float fontScale=u_is_text ? size/24.0 : size;highp float symbol_rotation=0.0;if (u_rotate_symbol) {vec4 offsetProjectedPoint=u_matrix*vec4(a_pos+vec2(1,0),0,1);vec2 a=projectedPoint.xy/projectedPoint.w;vec2 b=offsetProjectedPoint.xy/offsetProjectedPoint.w;symbol_rotation=atan((b.y-a.y)/u_aspect_ratio,b.x-a.x);}highp float angle_sin=sin(segment_angle+symbol_rotation);highp float angle_cos=cos(segment_angle+symbol_rotation);mat2 rotation_matrix=mat2(angle_cos,-1.0*angle_sin,angle_sin,angle_cos);vec4 projected_pos=u_label_plane_matrix*vec4(a_projected_pos.xy,0.0,1.0);gl_Position=u_coord_matrix*vec4(projected_pos.xy/projected_pos.w+rotation_matrix*(a_offset/32.0*fontScale+a_pxoffset),0.0,1.0);float gamma_scale=gl_Position.w;vec2 fade_opacity=unpack_opacity(a_fade_opacity);float fade_change=fade_opacity[1] > 0.5 ? u_fade_change :-u_fade_change;float interpolated_fade_opacity=max(0.0,min(1.0,fade_opacity[0]+fade_change));v_data0=a_tex/u_texsize;v_data1=vec3(gamma_scale,size,interpolated_fade_opacity);}\"),mi=gi(\"#define SDF_PX 8.0\\n#define SDF 1.0\\n#define ICON 0.0\\nuniform bool u_is_halo;uniform sampler2D u_texture;uniform sampler2D u_texture_icon;uniform highp float u_gamma_scale;uniform lowp float u_device_pixel_ratio;varying vec4 v_data0;varying vec4 v_data1;\\n#pragma mapbox: define highp vec4 fill_color\\n#pragma mapbox: define highp vec4 halo_color\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define lowp float halo_width\\n#pragma mapbox: define lowp float halo_blur\\nvoid main() {\\n#pragma mapbox: initialize highp vec4 fill_color\\n#pragma mapbox: initialize highp vec4 halo_color\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize lowp float halo_width\\n#pragma mapbox: initialize lowp float halo_blur\\nfloat fade_opacity=v_data1[2];if (v_data1.w==ICON) {vec2 tex_icon=v_data0.zw;lowp float alpha=opacity*fade_opacity;gl_FragColor=texture2D(u_texture_icon,tex_icon)*alpha;\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\nreturn;}vec2 tex=v_data0.xy;float EDGE_GAMMA=0.105/u_device_pixel_ratio;float gamma_scale=v_data1.x;float size=v_data1.y;float fontScale=size/24.0;lowp vec4 color=fill_color;highp float gamma=EDGE_GAMMA/(fontScale*u_gamma_scale);lowp float buff=(256.0-64.0)/256.0;if (u_is_halo) {color=halo_color;gamma=(halo_blur*1.19/SDF_PX+EDGE_GAMMA)/(fontScale*u_gamma_scale);buff=(6.0-halo_width/fontScale)/SDF_PX;}lowp float dist=texture2D(u_texture,tex).a;highp float gamma_scaled=gamma*gamma_scale;highp float alpha=smoothstep(buff-gamma_scaled,buff+gamma_scaled,dist);gl_FragColor=color*(alpha*opacity*fade_opacity);\\n#ifdef OVERDRAW_INSPECTOR\\ngl_FragColor=vec4(1.0);\\n#endif\\n}\",\"const float PI=3.141592653589793;attribute vec4 a_pos_offset;attribute vec4 a_data;attribute vec3 a_projected_pos;attribute float a_fade_opacity;uniform bool u_is_size_zoom_constant;uniform bool u_is_size_feature_constant;uniform highp float u_size_t;uniform highp float u_size;uniform mat4 u_matrix;uniform mat4 u_label_plane_matrix;uniform mat4 u_coord_matrix;uniform bool u_is_text;uniform bool u_pitch_with_map;uniform highp float u_pitch;uniform bool u_rotate_symbol;uniform highp float u_aspect_ratio;uniform highp float u_camera_to_center_distance;uniform float u_fade_change;uniform vec2 u_texsize;uniform vec2 u_texsize_icon;varying vec4 v_data0;varying vec4 v_data1;\\n#pragma mapbox: define highp vec4 fill_color\\n#pragma mapbox: define highp vec4 halo_color\\n#pragma mapbox: define lowp float opacity\\n#pragma mapbox: define lowp float halo_width\\n#pragma mapbox: define lowp float halo_blur\\nvoid main() {\\n#pragma mapbox: initialize highp vec4 fill_color\\n#pragma mapbox: initialize highp vec4 halo_color\\n#pragma mapbox: initialize lowp float opacity\\n#pragma mapbox: initialize lowp float halo_width\\n#pragma mapbox: initialize lowp float halo_blur\\nvec2 a_pos=a_pos_offset.xy;vec2 a_offset=a_pos_offset.zw;vec2 a_tex=a_data.xy;vec2 a_size=a_data.zw;float a_size_min=floor(a_size[0]*0.5);float is_sdf=a_size[0]-2.0*a_size_min;highp float segment_angle=-a_projected_pos[2];float size;if (!u_is_size_zoom_constant && !u_is_size_feature_constant) {size=mix(a_size_min,a_size[1],u_size_t)/128.0;} else if (u_is_size_zoom_constant && !u_is_size_feature_constant) {size=a_size_min/128.0;} else {size=u_size;}vec4 projectedPoint=u_matrix*vec4(a_pos,0,1);highp float camera_to_anchor_distance=projectedPoint.w;highp float distance_ratio=u_pitch_with_map ?\\ncamera_to_anchor_distance/u_camera_to_center_distance :\\nu_camera_to_center_distance/camera_to_anchor_distance;highp float perspective_ratio=clamp(0.5+0.5*distance_ratio,0.0,4.0);size*=perspective_ratio;float fontScale=size/24.0;highp float symbol_rotation=0.0;if (u_rotate_symbol) {vec4 offsetProjectedPoint=u_matrix*vec4(a_pos+vec2(1,0),0,1);vec2 a=projectedPoint.xy/projectedPoint.w;vec2 b=offsetProjectedPoint.xy/offsetProjectedPoint.w;symbol_rotation=atan((b.y-a.y)/u_aspect_ratio,b.x-a.x);}highp float angle_sin=sin(segment_angle+symbol_rotation);highp float angle_cos=cos(segment_angle+symbol_rotation);mat2 rotation_matrix=mat2(angle_cos,-1.0*angle_sin,angle_sin,angle_cos);vec4 projected_pos=u_label_plane_matrix*vec4(a_projected_pos.xy,0.0,1.0);gl_Position=u_coord_matrix*vec4(projected_pos.xy/projected_pos.w+rotation_matrix*(a_offset/32.0*fontScale),0.0,1.0);float gamma_scale=gl_Position.w;vec2 fade_opacity=unpack_opacity(a_fade_opacity);float fade_change=fade_opacity[1] > 0.5 ? u_fade_change :-u_fade_change;float interpolated_fade_opacity=max(0.0,min(1.0,fade_opacity[0]+fade_change));v_data0.xy=a_tex/u_texsize;v_data0.zw=a_tex/u_texsize_icon;v_data1=vec4(gamma_scale,size,interpolated_fade_opacity,is_sdf);}\");function gi(t,e){var i=/#pragma mapbox: ([\\w]+) ([\\w]+) ([\\w]+) ([\\w]+)/g,o=e.match(/attribute ([\\w]+) ([\\w]+)/g),r=t.match(/uniform ([\\w]+) ([\\w]+)([\\s]*)([\\w]*)/g),a=e.match(/uniform ([\\w]+) ([\\w]+)([\\s]*)([\\w]*)/g),n=a?a.concat(r):r,s={};return {fragmentSource:t=t.replace(i,(function(t,e,i,o,r){return s[r]=!0,\"define\"===e?\"\\n#ifndef HAS_UNIFORM_u_\"+r+\"\\nvarying \"+i+\" \"+o+\" \"+r+\";\\n#else\\nuniform \"+i+\" \"+o+\" u_\"+r+\";\\n#endif\\n\":\"\\n#ifdef HAS_UNIFORM_u_\"+r+\"\\n    \"+i+\" \"+o+\" \"+r+\" = u_\"+r+\";\\n#endif\\n\"})),vertexSource:e=e.replace(i,(function(t,e,i,o,r){var a=\"float\"===o?\"vec2\":\"vec4\",n=r.match(/color/)?\"color\":a;return s[r]?\"define\"===e?\"\\n#ifndef HAS_UNIFORM_u_\"+r+\"\\nuniform lowp float u_\"+r+\"_t;\\nattribute \"+i+\" \"+a+\" a_\"+r+\";\\nvarying \"+i+\" \"+o+\" \"+r+\";\\n#else\\nuniform \"+i+\" \"+o+\" u_\"+r+\";\\n#endif\\n\":\"vec4\"===n?\"\\n#ifndef HAS_UNIFORM_u_\"+r+\"\\n    \"+r+\" = a_\"+r+\";\\n#else\\n    \"+i+\" \"+o+\" \"+r+\" = u_\"+r+\";\\n#endif\\n\":\"\\n#ifndef HAS_UNIFORM_u_\"+r+\"\\n    \"+r+\" = unpack_mix_\"+n+\"(a_\"+r+\", u_\"+r+\"_t);\\n#else\\n    \"+i+\" \"+o+\" \"+r+\" = u_\"+r+\";\\n#endif\\n\":\"define\"===e?\"\\n#ifndef HAS_UNIFORM_u_\"+r+\"\\nuniform lowp float u_\"+r+\"_t;\\nattribute \"+i+\" \"+a+\" a_\"+r+\";\\n#else\\nuniform \"+i+\" \"+o+\" u_\"+r+\";\\n#endif\\n\":\"vec4\"===n?\"\\n#ifndef HAS_UNIFORM_u_\"+r+\"\\n    \"+i+\" \"+o+\" \"+r+\" = a_\"+r+\";\\n#else\\n    \"+i+\" \"+o+\" \"+r+\" = u_\"+r+\";\\n#endif\\n\":\"\\n#ifndef HAS_UNIFORM_u_\"+r+\"\\n    \"+i+\" \"+o+\" \"+r+\" = unpack_mix_\"+n+\"(a_\"+r+\", u_\"+r+\"_t);\\n#else\\n    \"+i+\" \"+o+\" \"+r+\" = u_\"+r+\";\\n#endif\\n\"})),staticAttributes:o,staticUniforms:n}}var vi=Object.freeze({__proto__:null,prelude:Ge,background:We,backgroundPattern:Xe,circle:He,clippingMask:Ke,heatmap:Ye,heatmapTexture:Je,collisionBox:Qe,collisionCircle:$e,debug:ti,fill:ei,fillOutline:ii,fillOutlinePattern:oi,fillPattern:ri,fillExtrusion:ai,fillExtrusionPattern:ni,hillshadePrepare:si,hillshade:li,line:ci,lineGradient:ui,linePattern:hi,lineSDF:pi,raster:di,symbolIcon:_i,symbolSDF:fi,symbolTextAndIcon:mi}),yi=function(){this.boundProgram=null,this.boundLayoutVertexBuffer=null,this.boundPaintVertexBuffers=[],this.boundIndexBuffer=null,this.boundVertexOffset=null,this.boundDynamicVertexBuffer=null,this.vao=null;};function xi(t){for(var e=[],i=0;i<t.length;i++)if(null!==t[i]){var o=t[i].split(\" \");e.push(o.pop());}return e}yi.prototype.bind=function(t,e,i,o,r,a,n,s){this.context=t;for(var l=this.boundPaintVertexBuffers.length!==o.length,c=0;!l&&c<o.length;c++)this.boundPaintVertexBuffers[c]!==o[c]&&(l=!0);t.extVertexArrayObject&&this.vao&&this.boundProgram===e&&this.boundLayoutVertexBuffer===i&&!l&&this.boundIndexBuffer===r&&this.boundVertexOffset===a&&this.boundDynamicVertexBuffer===n&&this.boundDynamicVertexBuffer2===s?(t.bindVertexArrayOES.set(this.vao),n&&n.bind(),r&&r.dynamicDraw&&r.bind(),s&&s.bind()):this.freshBind(e,i,o,r,a,n,s);},yi.prototype.freshBind=function(t,e,i,o,r,a,n){var s,l=t.numAttributes,c=this.context,u=c.gl;if(c.extVertexArrayObject)this.vao&&this.destroy(),this.vao=c.extVertexArrayObject.createVertexArrayOES(),c.bindVertexArrayOES.set(this.vao),s=0,this.boundProgram=t,this.boundLayoutVertexBuffer=e,this.boundPaintVertexBuffers=i,this.boundIndexBuffer=o,this.boundVertexOffset=r,this.boundDynamicVertexBuffer=a,this.boundDynamicVertexBuffer2=n;else {s=c.currentNumAttributes||0;for(var h=l;h<s;h++)u.disableVertexAttribArray(h);}e.enableAttributes(u,t);for(var p=0,d=i;p<d.length;p+=1)d[p].enableAttributes(u,t);a&&a.enableAttributes(u,t),n&&n.enableAttributes(u,t),e.bind(),e.setVertexAttribPointers(u,t,r);for(var _=0,f=i;_<f.length;_+=1){var m=f[_];m.bind(),m.setVertexAttribPointers(u,t,r);}a&&(a.bind(),a.setVertexAttribPointers(u,t,r)),o&&o.bind(),n&&(n.bind(),n.setVertexAttribPointers(u,t,r)),c.currentNumAttributes=l;},yi.prototype.destroy=function(){this.vao&&(this.context.extVertexArrayObject.deleteVertexArrayOES(this.vao),this.vao=null);};var bi=function(t,e,i,o,r,a){var n=t.gl;this.program=n.createProgram();for(var s=xi(i.staticAttributes),l=o?o.getBinderAttributes():[],c=s.concat(l),u=i.staticUniforms?xi(i.staticUniforms):[],h=o?o.getBinderUniforms():[],p=[],d=0,_=u.concat(h);d<_.length;d+=1){var f=_[d];p.indexOf(f)<0&&p.push(f);}var m=o?o.defines():[];a&&m.push(\"#define OVERDRAW_INSPECTOR;\");var g=m.concat(Ge.fragmentSource,i.fragmentSource).join(\"\\n\"),v=m.concat(Ge.vertexSource,i.vertexSource).join(\"\\n\"),y=n.createShader(n.FRAGMENT_SHADER);if(n.isContextLost())this.failedToCreate=!0;else {n.shaderSource(y,g),n.compileShader(y),n.attachShader(this.program,y);var x=n.createShader(n.VERTEX_SHADER);if(n.isContextLost())this.failedToCreate=!0;else {n.shaderSource(x,v),n.compileShader(x),n.attachShader(this.program,x),this.attributes={};var b={};this.numAttributes=c.length;for(var w=0;w<this.numAttributes;w++)c[w]&&(n.bindAttribLocation(this.program,w,c[w]),this.attributes[c[w]]=w);n.linkProgram(this.program),n.deleteShader(x),n.deleteShader(y);for(var T=0;T<p.length;T++){var E=p[T];if(E&&!b[E]){var I=n.getUniformLocation(this.program,E);I&&(b[E]=I);}}this.fixedUniforms=r(t,b),this.binderUniforms=o?o.getUniforms(t,b):[];}}};function wi(t,e,i){var o=1/pe(i,1,e.transform.tileZoom),r=Math.pow(2,i.tileID.overscaledZ),a=i.tileSize*Math.pow(2,e.transform.tileZoom)/r,n=a*(i.tileID.canonical.x+i.tileID.wrap*r),s=a*i.tileID.canonical.y;return {u_image:0,u_texsize:i.imageAtlasTexture.size,u_scale:[o,t.fromScale,t.toScale],u_fade:t.t,u_pixel_coord_upper:[n>>16,s>>16],u_pixel_coord_lower:[65535&n,65535&s]}}bi.prototype.draw=function(t,e,i,o,r,a,n,s,l,c,u,h,p,d,_,f){var m,g=t.gl;if(!this.failedToCreate){for(var v in t.program.set(this.program),t.setDepthMode(i),t.setStencilMode(o),t.setColorMode(r),t.setCullFace(a),this.fixedUniforms)this.fixedUniforms[v].set(n[v]);d&&d.setUniforms(t,this.binderUniforms,h,{zoom:p});for(var y=(m={},m[g.LINES]=2,m[g.TRIANGLES]=3,m[g.LINE_STRIP]=1,m)[e],x=0,b=u.get();x<b.length;x+=1){var w=b[x],T=w.vaos||(w.vaos={});(T[s]||(T[s]=new yi)).bind(t,this,l,d?d.getPaintVertexBuffers():[],c,w.vertexOffset,_,f),g.drawElements(e,w.primitiveLength*y,g.UNSIGNED_SHORT,w.primitiveOffset*y*2);}}};var Ti=function(e,i,o,r){var a=i.style.light,n=a.properties.get(\"position\"),s=[n.x,n.y,n.z],l=t.create$1();\"viewport\"===a.properties.get(\"anchor\")&&t.fromRotation(l,-i.transform.angle),t.transformMat3(s,s,l);var c=a.properties.get(\"color\");return {u_matrix:e,u_lightpos:s,u_lightintensity:a.properties.get(\"intensity\"),u_lightcolor:[c.r,c.g,c.b],u_vertical_gradient:+o,u_opacity:r}},Ei=function(e,i,o,r,a,n,s){return t.extend(Ti(e,i,o,r),wi(n,i,s),{u_height_factor:-Math.pow(2,a.overscaledZ)/s.tileSize/8})},Ii=function(t){return {u_matrix:t}},Pi=function(e,i,o,r){return t.extend(Ii(e),wi(o,i,r))},Si=function(t,e){return {u_matrix:t,u_world:e}},Ci=function(e,i,o,r,a){return t.extend(Pi(e,i,o,r),{u_world:a})},zi=function(e,i,o,r){var a,n,s=e.transform;if(\"map\"===r.paint.get(\"circle-pitch-alignment\")){var l=pe(o,1,s.zoom);a=!0,n=[l,l];}else a=!1,n=s.pixelsToGLUnits;return {u_camera_to_center_distance:s.cameraToCenterDistance,u_scale_with_map:+(\"map\"===r.paint.get(\"circle-pitch-scale\")),u_matrix:e.translatePosMatrix(i.posMatrix,o,r.paint.get(\"circle-translate\"),r.paint.get(\"circle-translate-anchor\")),u_pitch_with_map:+a,u_device_pixel_ratio:t.browser.devicePixelRatio,u_extrude_scale:n}},Di=function(t,e,i){var o=pe(i,1,e.zoom),r=Math.pow(2,e.zoom-i.tileID.overscaledZ),a=i.tileID.overscaleFactor();return {u_matrix:t,u_camera_to_center_distance:e.cameraToCenterDistance,u_pixels_to_tile_units:o,u_extrude_scale:[e.pixelsToGLUnits[0]/(o*r),e.pixelsToGLUnits[1]/(o*r)],u_overscale_factor:a}},Ai=function(t,e,i){return {u_matrix:t,u_inv_matrix:e,u_camera_to_center_distance:i.cameraToCenterDistance,u_viewport_size:[i.width,i.height]}},Mi=function(t,e,i){return void 0===i&&(i=1),{u_matrix:t,u_color:e,u_overlay:0,u_overlay_scale:i}},Li=function(t){return {u_matrix:t}},Ri=function(t,e,i,o){return {u_matrix:t,u_extrude_scale:pe(e,1,i),u_intensity:o}},ki=function(e,i,o){var r=e.transform;return {u_matrix:Ni(e,i,o),u_ratio:1/pe(i,1,r.zoom),u_device_pixel_ratio:t.browser.devicePixelRatio,u_units_to_pixels:[1/r.pixelsToGLUnits[0],1/r.pixelsToGLUnits[1]]}},Bi=function(e,i,o,r){return t.extend(ki(e,i,o),{u_image:0,u_image_height:r})},Oi=function(e,i,o,r){var a=e.transform,n=Ui(i,a);return {u_matrix:Ni(e,i,o),u_texsize:i.imageAtlasTexture.size,u_ratio:1/pe(i,1,a.zoom),u_device_pixel_ratio:t.browser.devicePixelRatio,u_image:0,u_scale:[n,r.fromScale,r.toScale],u_fade:r.t,u_units_to_pixels:[1/a.pixelsToGLUnits[0],1/a.pixelsToGLUnits[1]]}},Fi=function(e,i,o,r,a){var n=e.lineAtlas,s=Ui(i,e.transform),l=\"round\"===o.layout.get(\"line-cap\"),c=n.getDash(r.from,l),u=n.getDash(r.to,l),h=c.width*a.fromScale,p=u.width*a.toScale;return t.extend(ki(e,i,o),{u_patternscale_a:[s/h,-c.height/2],u_patternscale_b:[s/p,-u.height/2],u_sdfgamma:n.width/(256*Math.min(h,p)*t.browser.devicePixelRatio)/2,u_image:0,u_tex_y_a:c.y,u_tex_y_b:u.y,u_mix:a.t})};function Ui(t,e){return 1/pe(t,1,e.tileZoom)}function Ni(t,e,i){return t.translatePosMatrix(e.tileID.posMatrix,e,i.paint.get(\"line-translate\"),i.paint.get(\"line-translate-anchor\"))}var Zi=function(t,e,i,o,r){return {u_matrix:t,u_tl_parent:e,u_scale_parent:i,u_buffer_scale:1,u_fade_t:o.mix,u_opacity:o.opacity*r.paint.get(\"raster-opacity\"),u_image0:0,u_image1:1,u_brightness_low:r.paint.get(\"raster-brightness-min\"),u_brightness_high:r.paint.get(\"raster-brightness-max\"),u_saturation_factor:(n=r.paint.get(\"raster-saturation\"),n>0?1-1/(1.001-n):-n),u_contrast_factor:(a=r.paint.get(\"raster-contrast\"),a>0?1/(1-a):1+a),u_spin_weights:qi(r.paint.get(\"raster-hue-rotate\"))};var a,n;};function qi(t){t*=Math.PI/180;var e=Math.sin(t),i=Math.cos(t);return [(2*i+1)/3,(-Math.sqrt(3)*e-i+1)/3,(Math.sqrt(3)*e-i+1)/3]}var ji,Vi=function(t,e,i,o,r,a,n,s,l,c){var u=r.transform;return {u_is_size_zoom_constant:+(\"constant\"===t||\"source\"===t),u_is_size_feature_constant:+(\"constant\"===t||\"camera\"===t),u_size_t:e?e.uSizeT:0,u_size:e?e.uSize:0,u_camera_to_center_distance:u.cameraToCenterDistance,u_pitch:u.pitch/360*2*Math.PI,u_rotate_symbol:+i,u_aspect_ratio:u.width/u.height,u_fade_change:r.options.fadeDuration?r.symbolFadeChange:1,u_matrix:a,u_label_plane_matrix:n,u_coord_matrix:s,u_is_text:+l,u_pitch_with_map:+o,u_texsize:c,u_texture:0}},Gi=function(e,i,o,r,a,n,s,l,c,u,h){var p=a.transform;return t.extend(Vi(e,i,o,r,a,n,s,l,c,u),{u_gamma_scale:r?Math.cos(p._pitch)*p.cameraToCenterDistance:1,u_device_pixel_ratio:t.browser.devicePixelRatio,u_is_halo:+h})},Wi=function(e,i,o,r,a,n,s,l,c,u){return t.extend(Gi(e,i,o,r,a,n,s,l,!0,c,!0),{u_texsize_icon:u,u_texture_icon:1})},Xi=function(t,e,i){return {u_matrix:t,u_opacity:e,u_color:i}},Hi=function(e,i,o,r,a,n){return t.extend(function(t,e,i,o){var r=i.imageManager.getPattern(t.from.toString()),a=i.imageManager.getPattern(t.to.toString()),n=i.imageManager.getPixelSize(),s=n.width,l=n.height,c=Math.pow(2,o.tileID.overscaledZ),u=o.tileSize*Math.pow(2,i.transform.tileZoom)/c,h=u*(o.tileID.canonical.x+o.tileID.wrap*c),p=u*o.tileID.canonical.y;return {u_image:0,u_pattern_tl_a:r.tl,u_pattern_br_a:r.br,u_pattern_tl_b:a.tl,u_pattern_br_b:a.br,u_texsize:[s,l],u_mix:e.t,u_pattern_size_a:r.displaySize,u_pattern_size_b:a.displaySize,u_scale_a:e.fromScale,u_scale_b:e.toScale,u_tile_units_to_pixels:1/pe(o,1,i.transform.tileZoom),u_pixel_coord_upper:[h>>16,p>>16],u_pixel_coord_lower:[65535&h,65535&p]}}(r,n,o,a),{u_matrix:e,u_opacity:i})},Ki={fillExtrusion:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_lightpos:new t.Uniform3f(e,i.u_lightpos),u_lightintensity:new t.Uniform1f(e,i.u_lightintensity),u_lightcolor:new t.Uniform3f(e,i.u_lightcolor),u_vertical_gradient:new t.Uniform1f(e,i.u_vertical_gradient),u_opacity:new t.Uniform1f(e,i.u_opacity)}},fillExtrusionPattern:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_lightpos:new t.Uniform3f(e,i.u_lightpos),u_lightintensity:new t.Uniform1f(e,i.u_lightintensity),u_lightcolor:new t.Uniform3f(e,i.u_lightcolor),u_vertical_gradient:new t.Uniform1f(e,i.u_vertical_gradient),u_height_factor:new t.Uniform1f(e,i.u_height_factor),u_image:new t.Uniform1i(e,i.u_image),u_texsize:new t.Uniform2f(e,i.u_texsize),u_pixel_coord_upper:new t.Uniform2f(e,i.u_pixel_coord_upper),u_pixel_coord_lower:new t.Uniform2f(e,i.u_pixel_coord_lower),u_scale:new t.Uniform3f(e,i.u_scale),u_fade:new t.Uniform1f(e,i.u_fade),u_opacity:new t.Uniform1f(e,i.u_opacity)}},fill:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix)}},fillPattern:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_image:new t.Uniform1i(e,i.u_image),u_texsize:new t.Uniform2f(e,i.u_texsize),u_pixel_coord_upper:new t.Uniform2f(e,i.u_pixel_coord_upper),u_pixel_coord_lower:new t.Uniform2f(e,i.u_pixel_coord_lower),u_scale:new t.Uniform3f(e,i.u_scale),u_fade:new t.Uniform1f(e,i.u_fade)}},fillOutline:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_world:new t.Uniform2f(e,i.u_world)}},fillOutlinePattern:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_world:new t.Uniform2f(e,i.u_world),u_image:new t.Uniform1i(e,i.u_image),u_texsize:new t.Uniform2f(e,i.u_texsize),u_pixel_coord_upper:new t.Uniform2f(e,i.u_pixel_coord_upper),u_pixel_coord_lower:new t.Uniform2f(e,i.u_pixel_coord_lower),u_scale:new t.Uniform3f(e,i.u_scale),u_fade:new t.Uniform1f(e,i.u_fade)}},circle:function(e,i){return {u_camera_to_center_distance:new t.Uniform1f(e,i.u_camera_to_center_distance),u_scale_with_map:new t.Uniform1i(e,i.u_scale_with_map),u_pitch_with_map:new t.Uniform1i(e,i.u_pitch_with_map),u_extrude_scale:new t.Uniform2f(e,i.u_extrude_scale),u_device_pixel_ratio:new t.Uniform1f(e,i.u_device_pixel_ratio),u_matrix:new t.UniformMatrix4f(e,i.u_matrix)}},collisionBox:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_camera_to_center_distance:new t.Uniform1f(e,i.u_camera_to_center_distance),u_pixels_to_tile_units:new t.Uniform1f(e,i.u_pixels_to_tile_units),u_extrude_scale:new t.Uniform2f(e,i.u_extrude_scale),u_overscale_factor:new t.Uniform1f(e,i.u_overscale_factor)}},collisionCircle:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_inv_matrix:new t.UniformMatrix4f(e,i.u_inv_matrix),u_camera_to_center_distance:new t.Uniform1f(e,i.u_camera_to_center_distance),u_viewport_size:new t.Uniform2f(e,i.u_viewport_size)}},debug:function(e,i){return {u_color:new t.UniformColor(e,i.u_color),u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_overlay:new t.Uniform1i(e,i.u_overlay),u_overlay_scale:new t.Uniform1f(e,i.u_overlay_scale)}},clippingMask:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix)}},heatmap:function(e,i){return {u_extrude_scale:new t.Uniform1f(e,i.u_extrude_scale),u_intensity:new t.Uniform1f(e,i.u_intensity),u_matrix:new t.UniformMatrix4f(e,i.u_matrix)}},heatmapTexture:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_world:new t.Uniform2f(e,i.u_world),u_image:new t.Uniform1i(e,i.u_image),u_color_ramp:new t.Uniform1i(e,i.u_color_ramp),u_opacity:new t.Uniform1f(e,i.u_opacity)}},hillshade:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_image:new t.Uniform1i(e,i.u_image),u_latrange:new t.Uniform2f(e,i.u_latrange),u_light:new t.Uniform2f(e,i.u_light),u_shadow:new t.UniformColor(e,i.u_shadow),u_highlight:new t.UniformColor(e,i.u_highlight),u_accent:new t.UniformColor(e,i.u_accent)}},hillshadePrepare:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_image:new t.Uniform1i(e,i.u_image),u_dimension:new t.Uniform2f(e,i.u_dimension),u_zoom:new t.Uniform1f(e,i.u_zoom),u_unpack:new t.Uniform4f(e,i.u_unpack)}},line:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_ratio:new t.Uniform1f(e,i.u_ratio),u_device_pixel_ratio:new t.Uniform1f(e,i.u_device_pixel_ratio),u_units_to_pixels:new t.Uniform2f(e,i.u_units_to_pixels)}},lineGradient:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_ratio:new t.Uniform1f(e,i.u_ratio),u_device_pixel_ratio:new t.Uniform1f(e,i.u_device_pixel_ratio),u_units_to_pixels:new t.Uniform2f(e,i.u_units_to_pixels),u_image:new t.Uniform1i(e,i.u_image),u_image_height:new t.Uniform1f(e,i.u_image_height)}},linePattern:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_texsize:new t.Uniform2f(e,i.u_texsize),u_ratio:new t.Uniform1f(e,i.u_ratio),u_device_pixel_ratio:new t.Uniform1f(e,i.u_device_pixel_ratio),u_image:new t.Uniform1i(e,i.u_image),u_units_to_pixels:new t.Uniform2f(e,i.u_units_to_pixels),u_scale:new t.Uniform3f(e,i.u_scale),u_fade:new t.Uniform1f(e,i.u_fade)}},lineSDF:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_ratio:new t.Uniform1f(e,i.u_ratio),u_device_pixel_ratio:new t.Uniform1f(e,i.u_device_pixel_ratio),u_units_to_pixels:new t.Uniform2f(e,i.u_units_to_pixels),u_patternscale_a:new t.Uniform2f(e,i.u_patternscale_a),u_patternscale_b:new t.Uniform2f(e,i.u_patternscale_b),u_sdfgamma:new t.Uniform1f(e,i.u_sdfgamma),u_image:new t.Uniform1i(e,i.u_image),u_tex_y_a:new t.Uniform1f(e,i.u_tex_y_a),u_tex_y_b:new t.Uniform1f(e,i.u_tex_y_b),u_mix:new t.Uniform1f(e,i.u_mix)}},raster:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_tl_parent:new t.Uniform2f(e,i.u_tl_parent),u_scale_parent:new t.Uniform1f(e,i.u_scale_parent),u_buffer_scale:new t.Uniform1f(e,i.u_buffer_scale),u_fade_t:new t.Uniform1f(e,i.u_fade_t),u_opacity:new t.Uniform1f(e,i.u_opacity),u_image0:new t.Uniform1i(e,i.u_image0),u_image1:new t.Uniform1i(e,i.u_image1),u_brightness_low:new t.Uniform1f(e,i.u_brightness_low),u_brightness_high:new t.Uniform1f(e,i.u_brightness_high),u_saturation_factor:new t.Uniform1f(e,i.u_saturation_factor),u_contrast_factor:new t.Uniform1f(e,i.u_contrast_factor),u_spin_weights:new t.Uniform3f(e,i.u_spin_weights)}},symbolIcon:function(e,i){return {u_is_size_zoom_constant:new t.Uniform1i(e,i.u_is_size_zoom_constant),u_is_size_feature_constant:new t.Uniform1i(e,i.u_is_size_feature_constant),u_size_t:new t.Uniform1f(e,i.u_size_t),u_size:new t.Uniform1f(e,i.u_size),u_camera_to_center_distance:new t.Uniform1f(e,i.u_camera_to_center_distance),u_pitch:new t.Uniform1f(e,i.u_pitch),u_rotate_symbol:new t.Uniform1i(e,i.u_rotate_symbol),u_aspect_ratio:new t.Uniform1f(e,i.u_aspect_ratio),u_fade_change:new t.Uniform1f(e,i.u_fade_change),u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_label_plane_matrix:new t.UniformMatrix4f(e,i.u_label_plane_matrix),u_coord_matrix:new t.UniformMatrix4f(e,i.u_coord_matrix),u_is_text:new t.Uniform1i(e,i.u_is_text),u_pitch_with_map:new t.Uniform1i(e,i.u_pitch_with_map),u_texsize:new t.Uniform2f(e,i.u_texsize),u_texture:new t.Uniform1i(e,i.u_texture)}},symbolSDF:function(e,i){return {u_is_size_zoom_constant:new t.Uniform1i(e,i.u_is_size_zoom_constant),u_is_size_feature_constant:new t.Uniform1i(e,i.u_is_size_feature_constant),u_size_t:new t.Uniform1f(e,i.u_size_t),u_size:new t.Uniform1f(e,i.u_size),u_camera_to_center_distance:new t.Uniform1f(e,i.u_camera_to_center_distance),u_pitch:new t.Uniform1f(e,i.u_pitch),u_rotate_symbol:new t.Uniform1i(e,i.u_rotate_symbol),u_aspect_ratio:new t.Uniform1f(e,i.u_aspect_ratio),u_fade_change:new t.Uniform1f(e,i.u_fade_change),u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_label_plane_matrix:new t.UniformMatrix4f(e,i.u_label_plane_matrix),u_coord_matrix:new t.UniformMatrix4f(e,i.u_coord_matrix),u_is_text:new t.Uniform1i(e,i.u_is_text),u_pitch_with_map:new t.Uniform1i(e,i.u_pitch_with_map),u_texsize:new t.Uniform2f(e,i.u_texsize),u_texture:new t.Uniform1i(e,i.u_texture),u_gamma_scale:new t.Uniform1f(e,i.u_gamma_scale),u_device_pixel_ratio:new t.Uniform1f(e,i.u_device_pixel_ratio),u_is_halo:new t.Uniform1i(e,i.u_is_halo)}},symbolTextAndIcon:function(e,i){return {u_is_size_zoom_constant:new t.Uniform1i(e,i.u_is_size_zoom_constant),u_is_size_feature_constant:new t.Uniform1i(e,i.u_is_size_feature_constant),u_size_t:new t.Uniform1f(e,i.u_size_t),u_size:new t.Uniform1f(e,i.u_size),u_camera_to_center_distance:new t.Uniform1f(e,i.u_camera_to_center_distance),u_pitch:new t.Uniform1f(e,i.u_pitch),u_rotate_symbol:new t.Uniform1i(e,i.u_rotate_symbol),u_aspect_ratio:new t.Uniform1f(e,i.u_aspect_ratio),u_fade_change:new t.Uniform1f(e,i.u_fade_change),u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_label_plane_matrix:new t.UniformMatrix4f(e,i.u_label_plane_matrix),u_coord_matrix:new t.UniformMatrix4f(e,i.u_coord_matrix),u_is_text:new t.Uniform1i(e,i.u_is_text),u_pitch_with_map:new t.Uniform1i(e,i.u_pitch_with_map),u_texsize:new t.Uniform2f(e,i.u_texsize),u_texsize_icon:new t.Uniform2f(e,i.u_texsize_icon),u_texture:new t.Uniform1i(e,i.u_texture),u_texture_icon:new t.Uniform1i(e,i.u_texture_icon),u_gamma_scale:new t.Uniform1f(e,i.u_gamma_scale),u_device_pixel_ratio:new t.Uniform1f(e,i.u_device_pixel_ratio),u_is_halo:new t.Uniform1i(e,i.u_is_halo)}},background:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_opacity:new t.Uniform1f(e,i.u_opacity),u_color:new t.UniformColor(e,i.u_color)}},backgroundPattern:function(e,i){return {u_matrix:new t.UniformMatrix4f(e,i.u_matrix),u_opacity:new t.Uniform1f(e,i.u_opacity),u_image:new t.Uniform1i(e,i.u_image),u_pattern_tl_a:new t.Uniform2f(e,i.u_pattern_tl_a),u_pattern_br_a:new t.Uniform2f(e,i.u_pattern_br_a),u_pattern_tl_b:new t.Uniform2f(e,i.u_pattern_tl_b),u_pattern_br_b:new t.Uniform2f(e,i.u_pattern_br_b),u_texsize:new t.Uniform2f(e,i.u_texsize),u_mix:new t.Uniform1f(e,i.u_mix),u_pattern_size_a:new t.Uniform2f(e,i.u_pattern_size_a),u_pattern_size_b:new t.Uniform2f(e,i.u_pattern_size_b),u_scale_a:new t.Uniform1f(e,i.u_scale_a),u_scale_b:new t.Uniform1f(e,i.u_scale_b),u_pixel_coord_upper:new t.Uniform2f(e,i.u_pixel_coord_upper),u_pixel_coord_lower:new t.Uniform2f(e,i.u_pixel_coord_lower),u_tile_units_to_pixels:new t.Uniform1f(e,i.u_tile_units_to_pixels)}}};function Yi(e,i,o,r,a,n,s){for(var l=e.context,c=l.gl,u=e.useProgram(\"collisionBox\"),h=[],p=0,d=0,_=0;_<r.length;_++){var f=r[_],m=i.getTile(f),g=m.getBucket(o);if(g){var v=f.posMatrix;0===a[0]&&0===a[1]||(v=e.translatePosMatrix(f.posMatrix,m,a,n));var y=s?g.textCollisionBox:g.iconCollisionBox,x=g.collisionCircleArray;if(x.length>0){var b=t.create(),w=v;t.mul(b,g.placementInvProjMatrix,e.transform.glCoordMatrix),t.mul(b,b,g.placementViewportMatrix),h.push({circleArray:x,circleOffset:d,transform:w,invTransform:b}),d=p+=x.length/4;}y&&u.draw(l,c.LINES,It.disabled,Pt.disabled,e.colorModeForRenderPass(),Ct.disabled,Di(v,e.transform,m),o.id,y.layoutVertexBuffer,y.indexBuffer,y.segments,null,e.transform.zoom,null,null,y.collisionVertexBuffer);}}if(s&&h.length){var T=e.useProgram(\"collisionCircle\"),E=new t.StructArrayLayout2f1f2i16;E.resize(4*p),E._trim();for(var I=0,P=0,S=h;P<S.length;P+=1)for(var C=S[P],z=0;z<C.circleArray.length/4;z++){var D=4*z,A=C.circleArray[D+0],M=C.circleArray[D+1],L=C.circleArray[D+2],R=C.circleArray[D+3];E.emplace(I++,A,M,L,R,0),E.emplace(I++,A,M,L,R,1),E.emplace(I++,A,M,L,R,2),E.emplace(I++,A,M,L,R,3);}(!ji||ji.length<2*p)&&(ji=function(e){var i=2*e,o=new t.StructArrayLayout3ui6;o.resize(i),o._trim();for(var r=0;r<i;r++){var a=6*r;o.uint16[a+0]=4*r+0,o.uint16[a+1]=4*r+1,o.uint16[a+2]=4*r+2,o.uint16[a+3]=4*r+2,o.uint16[a+4]=4*r+3,o.uint16[a+5]=4*r+0;}return o}(p));for(var k=l.createIndexBuffer(ji,!0),B=l.createVertexBuffer(E,t.collisionCircleLayout.members,!0),O=0,F=h;O<F.length;O+=1){var U=F[O],N=Ai(U.transform,U.invTransform,e.transform);T.draw(l,c.TRIANGLES,It.disabled,Pt.disabled,e.colorModeForRenderPass(),Ct.disabled,N,o.id,B,k,t.SegmentVector.simpleSegment(0,2*U.circleOffset,U.circleArray.length,U.circleArray.length/2),null,e.transform.zoom,null,null,null);}B.destroy(),k.destroy();}}var Ji=t.identity(new Float32Array(16));function Qi(e,i,o,r,a,n){var s=t.getAnchorAlignment(e),l=-(s.horizontalAlign-.5)*i,c=-(s.verticalAlign-.5)*o,u=t.evaluateVariableOffset(e,r);return new t.Point((l/a+u[0])*n,(c/a+u[1])*n)}function $i(e,i,o,r,a,n,s,l,c,u,h){var p=e.text.placedSymbolArray,d=e.text.dynamicLayoutVertexArray,_=e.icon.dynamicLayoutVertexArray,f={};d.clear();for(var m=0;m<p.length;m++){var g=p.get(m),v=g.hidden||!g.crossTileID||e.allowVerticalPlacement&&!g.placedOrientation?null:r[g.crossTileID];if(v){var y=new t.Point(g.anchorX,g.anchorY),x=$t(y,o?l:s),b=te(n.cameraToCenterDistance,x.signedDistanceFromCamera),w=a.evaluateSizeForFeature(e.textSizeData,u,g)*b/t.ONE_EM;o&&(w*=e.tilePixelRatio/c);for(var T=Qi(v.anchor,v.width,v.height,v.textOffset,v.textBoxScale,w),E=o?$t(y.add(T),s).point:x.point.add(i?T.rotate(-n.angle):T),I=e.allowVerticalPlacement&&g.placedOrientation===t.WritingMode.vertical?Math.PI/2:0,P=0;P<g.numGlyphs;P++)t.addDynamicAttributes(d,E,I);h&&g.associatedIconIndex>=0&&(f[g.associatedIconIndex]={shiftedAnchor:E,angle:I});}else ce(g.numGlyphs,d);}if(h){_.clear();for(var S=e.icon.placedSymbolArray,C=0;C<S.length;C++){var z=S.get(C);if(z.hidden)ce(z.numGlyphs,_);else {var D=f[C];if(D)for(var A=0;A<z.numGlyphs;A++)t.addDynamicAttributes(_,D.shiftedAnchor,D.angle);else ce(z.numGlyphs,_);}}e.icon.dynamicLayoutVertexBuffer.updateData(_);}e.text.dynamicLayoutVertexBuffer.updateData(d);}function to(t,e,i){return i.iconsInText&&e?\"symbolTextAndIcon\":t?\"symbolSDF\":\"symbolIcon\"}function eo(e,i,o,r,a,n,s,l,c,u,h,p){for(var d=e.context,_=d.gl,f=e.transform,m=\"map\"===l,g=\"map\"===c,v=m&&\"point\"!==o.layout.get(\"symbol-placement\"),y=m&&!g&&!v,x=void 0!==o.layout.get(\"symbol-sort-key\").constantOr(1),b=!1,w=e.depthModeForSublayer(0,It.ReadOnly),T=o.layout.get(\"text-variable-anchor\"),E=[],I=0,P=r;I<P.length;I+=1){var S=P[I],C=i.getTile(S),z=C.getBucket(o);if(z){var D=a?z.text:z.icon;if(D&&D.segments.get().length){var A=D.programConfigurations.get(o.id),M=a||z.sdfIcons,L=a?z.textSizeData:z.iconSizeData,R=g||0!==f.pitch,k=e.useProgram(to(M,a,z),A),B=t.evaluateSizeForZoom(L,f.zoom),O=void 0,F=[0,0],U=void 0,N=void 0,Z=null,q=void 0;if(a)U=C.glyphAtlasTexture,N=_.LINEAR,O=C.glyphAtlasTexture.size,z.iconsInText&&(F=C.imageAtlasTexture.size,Z=C.imageAtlasTexture,q=R||e.options.rotating||e.options.zooming||\"composite\"===L.kind||\"camera\"===L.kind?_.LINEAR:_.NEAREST);else {var j=1!==o.layout.get(\"icon-size\").constantOr(0)||z.iconsNeedLinear;U=C.imageAtlasTexture,N=M||e.options.rotating||e.options.zooming||j||R?_.LINEAR:_.NEAREST,O=C.imageAtlasTexture.size;}var V=pe(C,1,e.transform.zoom),G=Jt(S.posMatrix,g,m,e.transform,V),W=Qt(S.posMatrix,g,m,e.transform,V),X=T&&z.hasTextData(),H=\"none\"!==o.layout.get(\"icon-text-fit\")&&X&&z.hasIconData();v&&ie(z,S.posMatrix,e,a,G,W,g,u);var K=e.translatePosMatrix(S.posMatrix,C,n,s),Y=v||a&&T||H?Ji:G,J=e.translatePosMatrix(W,C,n,s,!0),Q=M&&0!==o.paint.get(a?\"text-halo-width\":\"icon-halo-width\").constantOr(1),$={program:k,buffers:D,uniformValues:M?z.iconsInText?Wi(L.kind,B,y,g,e,K,Y,J,O,F):Gi(L.kind,B,y,g,e,K,Y,J,a,O,!0):Vi(L.kind,B,y,g,e,K,Y,J,a,O),atlasTexture:U,atlasTextureIcon:Z,atlasInterpolation:N,atlasInterpolationIcon:q,isSDF:M,hasHalo:Q};if(x&&z.canOverlap){b=!0;for(var tt=0,et=D.segments.get();tt<et.length;tt+=1){var it=et[tt];E.push({segments:new t.SegmentVector([it]),sortKey:it.sortKey,state:$});}}else E.push({segments:D.segments,sortKey:0,state:$});}}}b&&E.sort((function(t,e){return t.sortKey-e.sortKey}));for(var ot=0,rt=E;ot<rt.length;ot+=1){var at=rt[ot],nt=at.state;if(d.activeTexture.set(_.TEXTURE0),nt.atlasTexture.bind(nt.atlasInterpolation,_.CLAMP_TO_EDGE),nt.atlasTextureIcon&&(d.activeTexture.set(_.TEXTURE1),nt.atlasTextureIcon&&nt.atlasTextureIcon.bind(nt.atlasInterpolationIcon,_.CLAMP_TO_EDGE)),nt.isSDF){var st=nt.uniformValues;nt.hasHalo&&(st.u_is_halo=1,io(nt.buffers,at.segments,o,e,nt.program,w,h,p,st)),st.u_is_halo=0;}io(nt.buffers,at.segments,o,e,nt.program,w,h,p,nt.uniformValues);}}function io(t,e,i,o,r,a,n,s,l){var c=o.context;r.draw(c,c.gl.TRIANGLES,a,n,s,Ct.disabled,l,i.id,t.layoutVertexBuffer,t.indexBuffer,e,i.paint,o.transform.zoom,t.programConfigurations.get(i.id),t.dynamicLayoutVertexBuffer,t.opacityVertexBuffer);}function oo(t,e,i,o,r,a,n){var s,l,c,u,h,p=t.context.gl,d=i.paint.get(\"fill-pattern\"),_=d&&d.constantOr(1),f=i.getCrossfadeParameters();n?(l=_&&!i.getPaintProperty(\"fill-outline-color\")?\"fillOutlinePattern\":\"fillOutline\",s=p.LINES):(l=_?\"fillPattern\":\"fill\",s=p.TRIANGLES);for(var m=0,g=o;m<g.length;m+=1){var v=g[m],y=e.getTile(v);if(!_||y.patternsLoaded()){var x=y.getBucket(i);if(x){var b=x.programConfigurations.get(i.id),w=t.useProgram(l,b);_&&(t.context.activeTexture.set(p.TEXTURE0),y.imageAtlasTexture.bind(p.LINEAR,p.CLAMP_TO_EDGE),b.updatePaintBuffers(f));var T=d.constantOr(null);if(T&&y.imageAtlas){var E=y.imageAtlas,I=E.patternPositions[T.to.toString()],P=E.patternPositions[T.from.toString()];I&&P&&b.setConstantPatternPositions(I,P);}var S=t.translatePosMatrix(v.posMatrix,y,i.paint.get(\"fill-translate\"),i.paint.get(\"fill-translate-anchor\"));if(n){u=x.indexBuffer2,h=x.segments2;var C=[p.drawingBufferWidth,p.drawingBufferHeight];c=\"fillOutlinePattern\"===l&&_?Ci(S,t,f,y,C):Si(S,C);}else u=x.indexBuffer,h=x.segments,c=_?Pi(S,t,f,y):Ii(S);w.draw(t.context,s,r,t.stencilModeForClipping(v),a,Ct.disabled,c,i.id,x.layoutVertexBuffer,u,h,i.paint,t.transform.zoom,b);}}}}function ro(t,e,i,o,r,a,n){for(var s=t.context,l=s.gl,c=i.paint.get(\"fill-extrusion-pattern\"),u=c.constantOr(1),h=i.getCrossfadeParameters(),p=i.paint.get(\"fill-extrusion-opacity\"),d=0,_=o;d<_.length;d+=1){var f=_[d],m=e.getTile(f),g=m.getBucket(i);if(g){var v=g.programConfigurations.get(i.id),y=t.useProgram(u?\"fillExtrusionPattern\":\"fillExtrusion\",v);u&&(t.context.activeTexture.set(l.TEXTURE0),m.imageAtlasTexture.bind(l.LINEAR,l.CLAMP_TO_EDGE),v.updatePaintBuffers(h));var x=c.constantOr(null);if(x&&m.imageAtlas){var b=m.imageAtlas,w=b.patternPositions[x.to.toString()],T=b.patternPositions[x.from.toString()];w&&T&&v.setConstantPatternPositions(w,T);}var E=t.translatePosMatrix(f.posMatrix,m,i.paint.get(\"fill-extrusion-translate\"),i.paint.get(\"fill-extrusion-translate-anchor\")),I=i.paint.get(\"fill-extrusion-vertical-gradient\"),P=u?Ei(E,t,I,p,f,h,m):Ti(E,t,I,p);y.draw(s,s.gl.TRIANGLES,r,a,n,Ct.backCCW,P,i.id,g.layoutVertexBuffer,g.indexBuffer,g.segments,i.paint,t.transform.zoom,v);}}}function ao(e,i,o,r,a,n){var s=e.context,l=s.gl,c=i.fbo;if(c){var u=e.useProgram(\"hillshade\");s.activeTexture.set(l.TEXTURE0),l.bindTexture(l.TEXTURE_2D,c.colorAttachment.get());var h=function(e,i,o){var r=o.paint.get(\"hillshade-shadow-color\"),a=o.paint.get(\"hillshade-highlight-color\"),n=o.paint.get(\"hillshade-accent-color\"),s=o.paint.get(\"hillshade-illumination-direction\")*(Math.PI/180);\"viewport\"===o.paint.get(\"hillshade-illumination-anchor\")&&(s-=e.transform.angle);var l,c,u,h=!e.options.moving;return {u_matrix:e.transform.calculatePosMatrix(i.tileID.toUnwrapped(),h),u_image:0,u_latrange:(l=i.tileID,c=Math.pow(2,l.canonical.z),u=l.canonical.y,[new t.MercatorCoordinate(0,u/c).toLngLat().lat,new t.MercatorCoordinate(0,(u+1)/c).toLngLat().lat]),u_light:[o.paint.get(\"hillshade-exaggeration\"),s],u_shadow:r,u_highlight:a,u_accent:n}}(e,i,o);u.draw(s,l.TRIANGLES,r,a,n,Ct.disabled,h,o.id,e.rasterBoundsBuffer,e.quadTriangleIndexBuffer,e.rasterBoundsSegments);}}function no(e,i,o,r,a,n){var s=e.context,l=s.gl,c=i.dem;if(c&&c.data){var u=c.dim,h=c.stride,p=c.getPixels();if(s.activeTexture.set(l.TEXTURE1),s.pixelStoreUnpackPremultiplyAlpha.set(!1),i.demTexture=i.demTexture||e.getTileTexture(h),i.demTexture){var d=i.demTexture;d.update(p,{premultiply:!1}),d.bind(l.NEAREST,l.CLAMP_TO_EDGE);}else i.demTexture=new t.Texture(s,p,l.RGBA,{premultiply:!1}),i.demTexture.bind(l.NEAREST,l.CLAMP_TO_EDGE);s.activeTexture.set(l.TEXTURE0);var _=i.fbo;if(!_){var f=new t.Texture(s,{width:u,height:u,data:null},l.RGBA);f.bind(l.LINEAR,l.CLAMP_TO_EDGE),(_=i.fbo=s.createFramebuffer(u,u,!0)).colorAttachment.set(f.texture);}s.bindFramebuffer.set(_.framebuffer),s.viewport.set([0,0,u,u]),e.useProgram(\"hillshadePrepare\").draw(s,l.TRIANGLES,r,a,n,Ct.disabled,function(e,i){var o=i.stride,r=t.create();return t.ortho(r,0,t.EXTENT,-t.EXTENT,0,0,1),t.translate(r,r,[0,-t.EXTENT,0]),{u_matrix:r,u_image:1,u_dimension:[o,o],u_zoom:e.overscaledZ,u_unpack:i.getUnpackVector()}}(i.tileID,c),o.id,e.rasterBoundsBuffer,e.quadTriangleIndexBuffer,e.rasterBoundsSegments),i.needsHillshadePrepare=!1;}}function so(e,i,o,r,a){var n=r.paint.get(\"raster-fade-duration\");if(n>0){var s=t.browser.now(),l=(s-e.timeAdded)/n,c=i?(s-i.timeAdded)/n:-1,u=o.getSource(),h=a.coveringZoomLevel({tileSize:u.tileSize,roundZoom:u.roundZoom}),p=!i||Math.abs(i.tileID.overscaledZ-h)>Math.abs(e.tileID.overscaledZ-h),d=p&&e.refreshedUponExpiration?1:t.clamp(p?l:1-c,0,1);return e.refreshedUponExpiration&&l>=1&&(e.refreshedUponExpiration=!1),i?{opacity:1,mix:1-d}:{opacity:d,mix:0}}return {opacity:1,mix:0}}var lo=new t.Color(1,0,0,1),co=new t.Color(0,1,0,1),uo=new t.Color(0,0,1,1),ho=new t.Color(1,0,1,1),po=new t.Color(0,1,1,1);function _o(t,e,i,o){mo(t,0,e+i/2,t.transform.width,i,o);}function fo(t,e,i,o){mo(t,e-i/2,0,i,t.transform.height,o);}function mo(e,i,o,r,a,n){var s=e.context,l=s.gl;l.enable(l.SCISSOR_TEST),l.scissor(i*t.browser.devicePixelRatio,o*t.browser.devicePixelRatio,r*t.browser.devicePixelRatio,a*t.browser.devicePixelRatio),s.clear({color:n}),l.disable(l.SCISSOR_TEST);}function go(e,i,o){var r=e.context,a=r.gl,n=o.posMatrix,s=e.useProgram(\"debug\"),l=It.disabled,c=Pt.disabled,u=e.colorModeForRenderPass();r.activeTexture.set(a.TEXTURE0),e.emptyTexture.bind(a.LINEAR,a.CLAMP_TO_EDGE),s.draw(r,a.LINE_STRIP,l,c,u,Ct.disabled,Mi(n,t.Color.red),\"$debug\",e.debugBuffer,e.tileBorderIndexBuffer,e.debugSegments);var h=i.getTileByID(o.key).latestRawTileData,p=Math.floor((h&&h.byteLength||0)/1024),d=i.getTile(o).tileSize,_=512/Math.min(d,512)*(o.overscaledZ/e.transform.zoom)*.5,f=o.canonical.toString();o.overscaledZ!==o.canonical.z&&(f+=\" => \"+o.overscaledZ),function(t,e){t.initDebugOverlayCanvas();var i=t.debugOverlayCanvas,o=t.context.gl,r=t.debugOverlayCanvas.getContext(\"2d\");r.clearRect(0,0,i.width,i.height),r.shadowColor=\"white\",r.shadowBlur=2,r.lineWidth=1.5,r.strokeStyle=\"white\",r.textBaseline=\"top\",r.font=\"bold 36px Open Sans, sans-serif\",r.fillText(e,5,5),r.strokeText(e,5,5),t.debugOverlayTexture.update(i),t.debugOverlayTexture.bind(o.LINEAR,o.CLAMP_TO_EDGE);}(e,f+\" \"+p+\"kb\"),s.draw(r,a.TRIANGLES,l,c,St.alphaBlended,Ct.disabled,Mi(n,t.Color.transparent,_),\"$debug\",e.debugBuffer,e.quadTriangleIndexBuffer,e.debugSegments);}var vo={symbol:function(e,i,o,r,a){if(\"translucent\"===e.renderPass){var n=Pt.disabled,s=e.colorModeForRenderPass();o.layout.get(\"text-variable-anchor\")&&function(e,i,o,r,a,n,s){for(var l=i.transform,c=\"map\"===a,u=\"map\"===n,h=0,p=e;h<p.length;h+=1){var d=p[h],_=r.getTile(d),f=_.getBucket(o);if(f&&f.text&&f.text.segments.get().length){var m=t.evaluateSizeForZoom(f.textSizeData,l.zoom),g=pe(_,1,i.transform.zoom),v=Jt(d.posMatrix,u,c,i.transform,g),y=\"none\"!==o.layout.get(\"icon-text-fit\")&&f.hasIconData();if(m){var x=Math.pow(2,l.zoom-_.tileID.overscaledZ);$i(f,c,u,s,t.symbolSize,l,v,d.posMatrix,x,m,y);}}}}(r,e,o,i,o.layout.get(\"text-rotation-alignment\"),o.layout.get(\"text-pitch-alignment\"),a),0!==o.paint.get(\"icon-opacity\").constantOr(1)&&eo(e,i,o,r,!1,o.paint.get(\"icon-translate\"),o.paint.get(\"icon-translate-anchor\"),o.layout.get(\"icon-rotation-alignment\"),o.layout.get(\"icon-pitch-alignment\"),o.layout.get(\"icon-keep-upright\"),n,s),0!==o.paint.get(\"text-opacity\").constantOr(1)&&eo(e,i,o,r,!0,o.paint.get(\"text-translate\"),o.paint.get(\"text-translate-anchor\"),o.layout.get(\"text-rotation-alignment\"),o.layout.get(\"text-pitch-alignment\"),o.layout.get(\"text-keep-upright\"),n,s),i.map.showCollisionBoxes&&(Yi(e,i,o,r,o.paint.get(\"text-translate\"),o.paint.get(\"text-translate-anchor\"),!0),Yi(e,i,o,r,o.paint.get(\"icon-translate\"),o.paint.get(\"icon-translate-anchor\"),!1));}},circle:function(e,i,o,r){if(\"translucent\"===e.renderPass){var a=o.paint.get(\"circle-opacity\"),n=o.paint.get(\"circle-stroke-width\"),s=o.paint.get(\"circle-stroke-opacity\"),l=void 0!==o.layout.get(\"circle-sort-key\").constantOr(1);if(0!==a.constantOr(1)||0!==n.constantOr(1)&&0!==s.constantOr(1)){for(var c=e.context,u=c.gl,h=e.depthModeForSublayer(0,It.ReadOnly),p=Pt.disabled,d=e.colorModeForRenderPass(),_=[],f=0;f<r.length;f++){var m=r[f],g=i.getTile(m),v=g.getBucket(o);if(v){var y=v.programConfigurations.get(o.id),x={programConfiguration:y,program:e.useProgram(\"circle\",y),layoutVertexBuffer:v.layoutVertexBuffer,indexBuffer:v.indexBuffer,uniformValues:zi(e,m,g,o)};if(l)for(var b=0,w=v.segments.get();b<w.length;b+=1){var T=w[b];_.push({segments:new t.SegmentVector([T]),sortKey:T.sortKey,state:x});}else _.push({segments:v.segments,sortKey:0,state:x});}}l&&_.sort((function(t,e){return t.sortKey-e.sortKey}));for(var E=0,I=_;E<I.length;E+=1){var P=I[E],S=P.state;S.program.draw(c,u.TRIANGLES,h,p,d,Ct.disabled,S.uniformValues,o.id,S.layoutVertexBuffer,S.indexBuffer,P.segments,o.paint,e.transform.zoom,S.programConfiguration);}}}},heatmap:function(e,i,o,r){if(0!==o.paint.get(\"heatmap-opacity\"))if(\"offscreen\"===e.renderPass){var a=e.context,n=a.gl,s=Pt.disabled,l=new St([n.ONE,n.ONE],t.Color.transparent,[!0,!0,!0,!0]);!function(t,e,i){var o=t.gl;t.activeTexture.set(o.TEXTURE1),t.viewport.set([0,0,e.width/4,e.height/4]);var r=i.heatmapFbo;if(r)o.bindTexture(o.TEXTURE_2D,r.colorAttachment.get()),t.bindFramebuffer.set(r.framebuffer);else {var a=o.createTexture();o.bindTexture(o.TEXTURE_2D,a),o.texParameteri(o.TEXTURE_2D,o.TEXTURE_WRAP_S,o.CLAMP_TO_EDGE),o.texParameteri(o.TEXTURE_2D,o.TEXTURE_WRAP_T,o.CLAMP_TO_EDGE),o.texParameteri(o.TEXTURE_2D,o.TEXTURE_MIN_FILTER,o.LINEAR),o.texParameteri(o.TEXTURE_2D,o.TEXTURE_MAG_FILTER,o.LINEAR),r=i.heatmapFbo=t.createFramebuffer(e.width/4,e.height/4,!1),function(t,e,i,o){var r=t.gl;r.texImage2D(r.TEXTURE_2D,0,r.RGBA,e.width/4,e.height/4,0,r.RGBA,t.extRenderToTextureHalfFloat?t.extTextureHalfFloat.HALF_FLOAT_OES:r.UNSIGNED_BYTE,null),o.colorAttachment.set(i);}(t,e,a,r);}}(a,e,o),a.clear({color:t.Color.transparent});for(var c=0;c<r.length;c++){var u=r[c];if(!i.hasRenderableParent(u)){var h=i.getTile(u),p=h.getBucket(o);if(p){var d=p.programConfigurations.get(o.id);e.useProgram(\"heatmap\",d).draw(a,n.TRIANGLES,It.disabled,s,l,Ct.disabled,Ri(u.posMatrix,h,e.transform.zoom,o.paint.get(\"heatmap-intensity\")),o.id,p.layoutVertexBuffer,p.indexBuffer,p.segments,o.paint,e.transform.zoom,d);}}}a.viewport.set([0,0,e.width,e.height]);}else \"translucent\"===e.renderPass&&(e.context.setColorMode(e.colorModeForRenderPass()),function(e,i){var o=e.context,r=o.gl,a=i.heatmapFbo;if(a){o.activeTexture.set(r.TEXTURE0),r.bindTexture(r.TEXTURE_2D,a.colorAttachment.get()),o.activeTexture.set(r.TEXTURE1);var n=i.colorRampTexture;n||(n=i.colorRampTexture=new t.Texture(o,i.colorRamp,r.RGBA)),n.bind(r.LINEAR,r.CLAMP_TO_EDGE),e.useProgram(\"heatmapTexture\").draw(o,r.TRIANGLES,It.disabled,Pt.disabled,e.colorModeForRenderPass(),Ct.disabled,function(e,i,o,r){var a=t.create();t.ortho(a,0,e.width,e.height,0,0,1);var n=e.context.gl;return {u_matrix:a,u_world:[n.drawingBufferWidth,n.drawingBufferHeight],u_image:0,u_color_ramp:1,u_opacity:i.paint.get(\"heatmap-opacity\")}}(e,i),i.id,e.viewportBuffer,e.quadTriangleIndexBuffer,e.viewportSegments,i.paint,e.transform.zoom);}}(e,o));},line:function(e,i,o,r){if(\"translucent\"===e.renderPass){var a=o.paint.get(\"line-opacity\"),n=o.paint.get(\"line-width\");if(0!==a.constantOr(1)&&0!==n.constantOr(1))for(var s=e.depthModeForSublayer(0,It.ReadOnly),l=e.colorModeForRenderPass(),c=o.paint.get(\"line-dasharray\"),u=o.paint.get(\"line-pattern\"),h=u.constantOr(1),p=o.paint.get(\"line-gradient\"),d=o.getCrossfadeParameters(),_=h?\"linePattern\":c?\"lineSDF\":p?\"lineGradient\":\"line\",f=e.context,m=f.gl,g=!0,v=0,y=r;v<y.length;v+=1){var x=y[v],b=i.getTile(x);if(!h||b.patternsLoaded()){var w=b.getBucket(o);if(w){var T=w.programConfigurations.get(o.id),E=e.context.program.get(),I=e.useProgram(_,T),P=g||I.program!==E,S=u.constantOr(null);if(S&&b.imageAtlas){var C=b.imageAtlas,z=C.patternPositions[S.to.toString()],D=C.patternPositions[S.from.toString()];z&&D&&T.setConstantPatternPositions(z,D);}var A=h?Oi(e,b,o,d):c?Fi(e,b,o,c,d):p?Bi(e,b,o,w.lineClipsArray.length):ki(e,b,o);if(h)f.activeTexture.set(m.TEXTURE0),b.imageAtlasTexture.bind(m.LINEAR,m.CLAMP_TO_EDGE),T.updatePaintBuffers(d);else if(c&&(P||e.lineAtlas.dirty))f.activeTexture.set(m.TEXTURE0),e.lineAtlas.bind(f);else if(p){var M=w.gradients[o.id],L=M.texture;if(o.gradientVersion!==M.version){var R=256;if(o.stepInterpolant){var k=i.getSource().maxzoom,B=x.canonical.z===k?Math.ceil(1<<e.transform.maxZoom-x.canonical.z):1;R=t.clamp(t.nextPowerOfTwo(w.maxLineLength/t.EXTENT*1024*B),256,f.maxTextureSize);}M.gradient=t.renderColorRamp({expression:o.gradientExpression(),evaluationKey:\"lineProgress\",resolution:R,image:M.gradient||void 0,clips:w.lineClipsArray}),M.texture?M.texture.update(M.gradient):M.texture=new t.Texture(f,M.gradient,m.RGBA),M.version=o.gradientVersion,L=M.texture;}f.activeTexture.set(m.TEXTURE0),L.bind(o.stepInterpolant?m.NEAREST:m.LINEAR,m.CLAMP_TO_EDGE);}I.draw(f,m.TRIANGLES,s,e.stencilModeForClipping(x),l,Ct.disabled,A,o.id,w.layoutVertexBuffer,w.indexBuffer,w.segments,o.paint,e.transform.zoom,T,w.layoutVertexBuffer2),g=!1;}}}}},fill:function(e,i,o,r){var a=o.paint.get(\"fill-color\"),n=o.paint.get(\"fill-opacity\");if(0!==n.constantOr(1)){var s=e.colorModeForRenderPass(),l=o.paint.get(\"fill-pattern\"),c=e.opaquePassEnabledForLayer()&&!l.constantOr(1)&&1===a.constantOr(t.Color.transparent).a&&1===n.constantOr(0)?\"opaque\":\"translucent\";if(e.renderPass===c){var u=e.depthModeForSublayer(1,\"opaque\"===e.renderPass?It.ReadWrite:It.ReadOnly);oo(e,i,o,r,u,s,!1);}if(\"translucent\"===e.renderPass&&o.paint.get(\"fill-antialias\")){var h=e.depthModeForSublayer(o.getPaintProperty(\"fill-outline-color\")?2:0,It.ReadOnly);oo(e,i,o,r,h,s,!0);}}},\"fill-extrusion\":function(t,e,i,o){var r=i.paint.get(\"fill-extrusion-opacity\");if(0!==r&&\"translucent\"===t.renderPass){var a=new It(t.context.gl.LEQUAL,It.ReadWrite,t.depthRangeFor3D);if(1!==r||i.paint.get(\"fill-extrusion-pattern\").constantOr(1))ro(t,e,i,o,a,Pt.disabled,St.disabled),ro(t,e,i,o,a,t.stencilModeFor3D(),t.colorModeForRenderPass());else {var n=t.colorModeForRenderPass();ro(t,e,i,o,a,Pt.disabled,n);}}},hillshade:function(t,e,i,o){if(\"offscreen\"===t.renderPass||\"translucent\"===t.renderPass){for(var r=t.context,a=t.depthModeForSublayer(0,It.ReadOnly),n=t.colorModeForRenderPass(),s=\"translucent\"===t.renderPass?t.stencilConfigForOverlap(o):[{},o],l=s[0],c=0,u=s[1];c<u.length;c+=1){var h=u[c],p=e.getTile(h);p.needsHillshadePrepare&&\"offscreen\"===t.renderPass?no(t,p,i,a,Pt.disabled,n):\"translucent\"===t.renderPass&&ao(t,p,i,a,l[h.overscaledZ],n);}r.viewport.set([0,0,t.width,t.height]);}},raster:function(t,e,i,o){if(\"translucent\"===t.renderPass&&0!==i.paint.get(\"raster-opacity\")&&o.length)for(var r=t.context,a=r.gl,n=e.getSource(),s=t.useProgram(\"raster\"),l=t.colorModeForRenderPass(),c=n instanceof M?[{},o]:t.stencilConfigForOverlap(o),u=c[0],h=c[1],p=h[h.length-1].overscaledZ,d=!t.options.moving,_=0,f=h;_<f.length;_+=1){var m=f[_],g=t.depthModeForSublayer(m.overscaledZ-p,1===i.paint.get(\"raster-opacity\")?It.ReadWrite:It.ReadOnly,a.LESS),v=e.getTile(m),y=t.transform.calculatePosMatrix(m.toUnwrapped(),d);v.registerFadeDuration(i.paint.get(\"raster-fade-duration\"));var x=e.findLoadedParent(m,0),b=so(v,x,e,i,t.transform),w=void 0,T=void 0,E=\"nearest\"===i.paint.get(\"raster-resampling\")?a.NEAREST:a.LINEAR;r.activeTexture.set(a.TEXTURE0),v.texture.bind(E,a.CLAMP_TO_EDGE,a.LINEAR_MIPMAP_NEAREST),r.activeTexture.set(a.TEXTURE1),x?(x.texture.bind(E,a.CLAMP_TO_EDGE,a.LINEAR_MIPMAP_NEAREST),w=Math.pow(2,x.tileID.overscaledZ-v.tileID.overscaledZ),T=[v.tileID.canonical.x*w%1,v.tileID.canonical.y*w%1]):v.texture.bind(E,a.CLAMP_TO_EDGE,a.LINEAR_MIPMAP_NEAREST);var I=Zi(y,T||[0,0],w||1,b,i);n instanceof M?s.draw(r,a.TRIANGLES,g,Pt.disabled,l,Ct.disabled,I,i.id,n.boundsBuffer,t.quadTriangleIndexBuffer,n.boundsSegments):s.draw(r,a.TRIANGLES,g,u[m.overscaledZ],l,Ct.disabled,I,i.id,t.rasterBoundsBuffer,t.quadTriangleIndexBuffer,t.rasterBoundsSegments);}},background:function(t,e,i){var o=i.paint.get(\"background-color\"),r=i.paint.get(\"background-opacity\");if(0!==r){var a=t.context,n=a.gl,s=t.transform,l=s.tileSize,c=i.paint.get(\"background-pattern\");if(!t.isPatternMissing(c)){var u=!c&&1===o.a&&1===r&&t.opaquePassEnabledForLayer()?\"opaque\":\"translucent\";if(t.renderPass===u){var h=Pt.disabled,p=t.depthModeForSublayer(0,\"opaque\"===u?It.ReadWrite:It.ReadOnly),d=t.colorModeForRenderPass(),_=t.useProgram(c?\"backgroundPattern\":\"background\"),f=s.coveringTiles({tileSize:l});c&&(a.activeTexture.set(n.TEXTURE0),t.imageManager.bind(t.context));for(var m=i.getCrossfadeParameters(),g=0,v=f;g<v.length;g+=1){var y=v[g],x=t.transform.calculatePosMatrix(y.toUnwrapped()),b=c?Hi(x,r,t,c,{tileID:y,tileSize:l},m):Xi(x,r,o);_.draw(a,n.TRIANGLES,p,h,d,Ct.disabled,b,i.id,t.tileExtentBuffer,t.quadTriangleIndexBuffer,t.tileExtentSegments);}}}}},debug:function(t,e,i){for(var o=0;o<i.length;o++)go(t,e,i[o]);},custom:function(t,e,i){var o=t.context,r=i.implementation;if(\"offscreen\"===t.renderPass){var a=r.prerender;a&&(t.setCustomLayerDefaults(),o.setColorMode(t.colorModeForRenderPass()),a.call(r,o.gl,t.transform.customLayerMatrix()),o.setDirty(),t.setBaseState());}else if(\"translucent\"===t.renderPass){t.setCustomLayerDefaults(),o.setColorMode(t.colorModeForRenderPass()),o.setStencilMode(Pt.disabled);var n=\"3d\"===r.renderingMode?new It(t.context.gl.LEQUAL,It.ReadWrite,t.depthRangeFor3D):t.depthModeForSublayer(0,It.ReadOnly);o.setDepthMode(n),r.render(o.gl,t.transform.customLayerMatrix()),o.setDirty(),t.setBaseState(),o.bindFramebuffer.set(null);}}},yo=function(t,e){this.context=new zt(t),this.transform=e,this._tileTextures={},this.setup(),this.numSublayers=Dt.maxUnderzooming+Dt.maxOverzooming+1,this.depthEpsilon=1/Math.pow(2,16),this.crossTileSymbolIndex=new Fe,this.gpuTimers={};};yo.prototype.resize=function(e,i){if(this.width=e*t.browser.devicePixelRatio,this.height=i*t.browser.devicePixelRatio,this.context.viewport.set([0,0,this.width,this.height]),this.style)for(var o=0,r=this.style._order;o<r.length;o+=1)this.style._layers[r[o]].resize();},yo.prototype.setup=function(){var e=this.context,i=new t.StructArrayLayout2i4;i.emplaceBack(0,0),i.emplaceBack(t.EXTENT,0),i.emplaceBack(0,t.EXTENT),i.emplaceBack(t.EXTENT,t.EXTENT),this.tileExtentBuffer=e.createVertexBuffer(i,Ve.members),this.tileExtentSegments=t.SegmentVector.simpleSegment(0,0,4,2);var o=new t.StructArrayLayout2i4;o.emplaceBack(0,0),o.emplaceBack(t.EXTENT,0),o.emplaceBack(0,t.EXTENT),o.emplaceBack(t.EXTENT,t.EXTENT),this.debugBuffer=e.createVertexBuffer(o,Ve.members),this.debugSegments=t.SegmentVector.simpleSegment(0,0,4,5);var r=new t.StructArrayLayout4i8;r.emplaceBack(0,0,0,0),r.emplaceBack(t.EXTENT,0,t.EXTENT,0),r.emplaceBack(0,t.EXTENT,0,t.EXTENT),r.emplaceBack(t.EXTENT,t.EXTENT,t.EXTENT,t.EXTENT),this.rasterBoundsBuffer=e.createVertexBuffer(r,A.members),this.rasterBoundsSegments=t.SegmentVector.simpleSegment(0,0,4,2);var a=new t.StructArrayLayout2i4;a.emplaceBack(0,0),a.emplaceBack(1,0),a.emplaceBack(0,1),a.emplaceBack(1,1),this.viewportBuffer=e.createVertexBuffer(a,Ve.members),this.viewportSegments=t.SegmentVector.simpleSegment(0,0,4,2);var n=new t.StructArrayLayout1ui2;n.emplaceBack(0),n.emplaceBack(1),n.emplaceBack(3),n.emplaceBack(2),n.emplaceBack(0),this.tileBorderIndexBuffer=e.createIndexBuffer(n);var s=new t.StructArrayLayout3ui6;s.emplaceBack(0,1,2),s.emplaceBack(2,1,3),this.quadTriangleIndexBuffer=e.createIndexBuffer(s),this.emptyTexture=new t.Texture(e,{width:1,height:1,data:new Uint8Array([0,0,0,0])},e.gl.RGBA);var l=this.context.gl;this.stencilClearMode=new Pt({func:l.ALWAYS,mask:0},0,255,l.ZERO,l.ZERO,l.ZERO);},yo.prototype.clearStencil=function(){var e=this.context,i=e.gl;this.nextStencilID=1,this.currentStencilSource=void 0;var o=t.create();t.ortho(o,0,this.width,this.height,0,0,1),t.scale(o,o,[i.drawingBufferWidth,i.drawingBufferHeight,0]),this.useProgram(\"clippingMask\").draw(e,i.TRIANGLES,It.disabled,this.stencilClearMode,St.disabled,Ct.disabled,Li(o),\"$clipping\",this.viewportBuffer,this.quadTriangleIndexBuffer,this.viewportSegments);},yo.prototype._renderTileClippingMasks=function(t,e){if(this.currentStencilSource!==t.source&&t.isTileClipped()&&e&&e.length){this.currentStencilSource=t.source;var i=this.context,o=i.gl;this.nextStencilID+e.length>256&&this.clearStencil(),i.setColorMode(St.disabled),i.setDepthMode(It.disabled);var r=this.useProgram(\"clippingMask\");this._tileClippingMaskIDs={};for(var a=0,n=e;a<n.length;a+=1){var s=n[a],l=this._tileClippingMaskIDs[s.key]=this.nextStencilID++;r.draw(i,o.TRIANGLES,It.disabled,new Pt({func:o.ALWAYS,mask:0},l,255,o.KEEP,o.KEEP,o.REPLACE),St.disabled,Ct.disabled,Li(s.posMatrix),\"$clipping\",this.tileExtentBuffer,this.quadTriangleIndexBuffer,this.tileExtentSegments);}}},yo.prototype.stencilModeFor3D=function(){this.currentStencilSource=void 0,this.nextStencilID+1>256&&this.clearStencil();var t=this.nextStencilID++,e=this.context.gl;return new Pt({func:e.NOTEQUAL,mask:255},t,255,e.KEEP,e.KEEP,e.REPLACE)},yo.prototype.stencilModeForClipping=function(t){var e=this.context.gl;return new Pt({func:e.EQUAL,mask:255},this._tileClippingMaskIDs[t.key],0,e.KEEP,e.KEEP,e.REPLACE)},yo.prototype.stencilConfigForOverlap=function(t){var e,i=this.context.gl,o=t.sort((function(t,e){return e.overscaledZ-t.overscaledZ})),r=o[o.length-1].overscaledZ,a=o[0].overscaledZ-r+1;if(a>1){this.currentStencilSource=void 0,this.nextStencilID+a>256&&this.clearStencil();for(var n={},s=0;s<a;s++)n[s+r]=new Pt({func:i.GEQUAL,mask:255},s+this.nextStencilID,255,i.KEEP,i.KEEP,i.REPLACE);return this.nextStencilID+=a,[n,o]}return [(e={},e[r]=Pt.disabled,e),o]},yo.prototype.colorModeForRenderPass=function(){var e=this.context.gl;return this._showOverdrawInspector?new St([e.CONSTANT_COLOR,e.ONE],new t.Color(1/8,1/8,1/8,0),[!0,!0,!0,!0]):\"opaque\"===this.renderPass?St.unblended:St.alphaBlended},yo.prototype.depthModeForSublayer=function(t,e,i){if(!this.opaquePassEnabledForLayer())return It.disabled;var o=1-((1+this.currentLayer)*this.numSublayers+t)*this.depthEpsilon;return new It(i||this.context.gl.LEQUAL,e,[o,o])},yo.prototype.opaquePassEnabledForLayer=function(){return this.currentLayer<this.opaquePassCutoff},yo.prototype.render=function(e,i){var o=this;this.style=e,this.options=i,this.lineAtlas=e.lineAtlas,this.imageManager=e.imageManager,this.glyphManager=e.glyphManager,this.symbolFadeChange=e.placement.symbolFadeChange(t.browser.now()),this.imageManager.beginFrame();var r=this.style._order,a=this.style.sourceCaches;for(var n in a){var s=a[n];s.used&&s.prepare(this.context);}var l,c,u={},h={},p={};for(var d in a){var _=a[d];u[d]=_.getVisibleCoordinates(),h[d]=u[d].slice().reverse(),p[d]=_.getVisibleCoordinates(!0).reverse();}this.opaquePassCutoff=1/0;for(var f=0;f<r.length;f++)if(this.style._layers[r[f]].is3D()){this.opaquePassCutoff=f;break}this.renderPass=\"offscreen\";for(var m=0,g=r;m<g.length;m+=1){var v=this.style._layers[g[m]];if(v.hasOffscreenPass()&&!v.isHidden(this.transform.zoom)){var y=h[v.source];(\"custom\"===v.type||y.length)&&this.renderLayer(this,a[v.source],v,y);}}for(this.context.bindFramebuffer.set(null),this.context.clear({color:i.showOverdrawInspector?t.Color.black:t.Color.transparent,depth:1}),this.clearStencil(),this._showOverdrawInspector=i.showOverdrawInspector,this.depthRangeFor3D=[0,1-(e._order.length+2)*this.numSublayers*this.depthEpsilon],this.renderPass=\"opaque\",this.currentLayer=r.length-1;this.currentLayer>=0;this.currentLayer--){var x=this.style._layers[r[this.currentLayer]],b=a[x.source],w=u[x.source];this._renderTileClippingMasks(x,w),this.renderLayer(this,b,x,w);}for(this.renderPass=\"translucent\",this.currentLayer=0;this.currentLayer<r.length;this.currentLayer++){var T=this.style._layers[r[this.currentLayer]],E=a[T.source],I=(\"symbol\"===T.type?p:h)[T.source];this._renderTileClippingMasks(T,u[T.source]),this.renderLayer(this,E,T,I);}this.options.showTileBoundaries&&(t.values(this.style._layers).forEach((function(t){t.source&&!t.isHidden(o.transform.zoom)&&(t.source!==(c&&c.id)&&(c=o.style.sourceCaches[t.source]),(!l||l.getSource().maxzoom<c.getSource().maxzoom)&&(l=c));})),l&&vo.debug(this,l,l.getVisibleCoordinates())),this.options.showPadding&&function(t){var e=t.transform.padding;_o(t,t.transform.height-(e.top||0),3,lo),_o(t,e.bottom||0,3,co),fo(t,e.left||0,3,uo),fo(t,t.transform.width-(e.right||0),3,ho);var i=t.transform.centerPoint;!function(t,e,i,o){mo(t,e-1,i-10,2,20,o),mo(t,e-10,i-1,20,2,o);}(t,i.x,t.transform.height-i.y,po);}(this),this.context.setDefault();},yo.prototype.renderLayer=function(t,e,i,o){i.isHidden(this.transform.zoom)||(\"background\"===i.type||\"custom\"===i.type||o.length)&&(this.id=i.id,this.gpuTimingStart(i),vo[i.type](t,e,i,o,this.style.placement.variableOffsets),this.gpuTimingEnd());},yo.prototype.gpuTimingStart=function(t){if(this.options.gpuTiming){var e=this.context.extTimerQuery,i=this.gpuTimers[t.id];i||(i=this.gpuTimers[t.id]={calls:0,cpuTime:0,query:e.createQueryEXT()}),i.calls++,e.beginQueryEXT(e.TIME_ELAPSED_EXT,i.query);}},yo.prototype.gpuTimingEnd=function(){if(this.options.gpuTiming){var t=this.context.extTimerQuery;t.endQueryEXT(t.TIME_ELAPSED_EXT);}},yo.prototype.collectGpuTimers=function(){var t=this.gpuTimers;return this.gpuTimers={},t},yo.prototype.queryGpuTimers=function(t){var e={};for(var i in t){var o=t[i],r=this.context.extTimerQuery,a=r.getQueryObjectEXT(o.query,r.QUERY_RESULT_EXT)/1e6;r.deleteQueryEXT(o.query),e[i]=a;}return e},yo.prototype.translatePosMatrix=function(e,i,o,r,a){if(!o[0]&&!o[1])return e;var n=a?\"map\"===r?this.transform.angle:0:\"viewport\"===r?-this.transform.angle:0;if(n){var s=Math.sin(n),l=Math.cos(n);o=[o[0]*l-o[1]*s,o[0]*s+o[1]*l];}var c=[a?o[0]:pe(i,o[0],this.transform.zoom),a?o[1]:pe(i,o[1],this.transform.zoom),0],u=new Float32Array(16);return t.translate(u,e,c),u},yo.prototype.saveTileTexture=function(t){var e=this._tileTextures[t.size[0]];e?e.push(t):this._tileTextures[t.size[0]]=[t];},yo.prototype.getTileTexture=function(t){var e=this._tileTextures[t];return e&&e.length>0?e.pop():null},yo.prototype.isPatternMissing=function(t){if(!t)return !1;if(!t.from||!t.to)return !0;var e=this.imageManager.getPattern(t.from.toString()),i=this.imageManager.getPattern(t.to.toString());return !e||!i},yo.prototype.useProgram=function(t,e){this.cache=this.cache||{};var i=\"\"+t+(e?e.cacheKey:\"\")+(this._showOverdrawInspector?\"/overdraw\":\"\");return this.cache[i]||(this.cache[i]=new bi(this.context,t,vi[t],e,Ki[t],this._showOverdrawInspector)),this.cache[i]},yo.prototype.setCustomLayerDefaults=function(){this.context.unbindVAO(),this.context.cullFace.setDefault(),this.context.activeTexture.setDefault(),this.context.pixelStoreUnpack.setDefault(),this.context.pixelStoreUnpackPremultiplyAlpha.setDefault(),this.context.pixelStoreUnpackFlipY.setDefault();},yo.prototype.setBaseState=function(){var t=this.context.gl;this.context.cullFace.set(!1),this.context.viewport.set([0,0,this.width,this.height]),this.context.blendEquation.set(t.FUNC_ADD);},yo.prototype.initDebugOverlayCanvas=function(){null==this.debugOverlayCanvas&&(this.debugOverlayCanvas=t.window.document.createElement(\"canvas\"),this.debugOverlayCanvas.width=512,this.debugOverlayCanvas.height=512,this.debugOverlayTexture=new t.Texture(this.context,this.debugOverlayCanvas,this.context.gl.RGBA));},yo.prototype.destroy=function(){this.emptyTexture.destroy(),this.debugOverlayTexture&&this.debugOverlayTexture.destroy();};var xo=function(t,e){this.points=t,this.planes=e;};xo.fromInvProjectionMatrix=function(e,i,o){var r=Math.pow(2,o),a=[[-1,1,-1,1],[1,1,-1,1],[1,-1,-1,1],[-1,-1,-1,1],[-1,1,1,1],[1,1,1,1],[1,-1,1,1],[-1,-1,1,1]].map((function(i){return t.transformMat4([],i,e)})).map((function(e){return t.scale$1([],e,1/e[3]/i*r)})),n=[[0,1,2],[6,5,4],[0,3,7],[2,1,5],[3,2,6],[0,4,5]].map((function(e){var i=t.sub([],a[e[0]],a[e[1]]),o=t.sub([],a[e[2]],a[e[1]]),r=t.normalize([],t.cross([],i,o)),n=-t.dot(r,a[e[1]]);return r.concat(n)}));return new xo(a,n)};var bo=function(e,i){this.min=e,this.max=i,this.center=t.scale$2([],t.add([],this.min,this.max),.5);};bo.prototype.quadrant=function(e){for(var i=[e%2==0,e<2],o=t.clone$2(this.min),r=t.clone$2(this.max),a=0;a<i.length;a++)o[a]=i[a]?this.min[a]:this.center[a],r[a]=i[a]?this.center[a]:this.max[a];return r[2]=this.max[2],new bo(o,r)},bo.prototype.distanceX=function(t){return Math.max(Math.min(this.max[0],t[0]),this.min[0])-t[0]},bo.prototype.distanceY=function(t){return Math.max(Math.min(this.max[1],t[1]),this.min[1])-t[1]},bo.prototype.intersects=function(e){for(var i=[[this.min[0],this.min[1],0,1],[this.max[0],this.min[1],0,1],[this.max[0],this.max[1],0,1],[this.min[0],this.max[1],0,1]],o=!0,r=0;r<e.planes.length;r++){for(var a=e.planes[r],n=0,s=0;s<i.length;s++)n+=t.dot$1(a,i[s])>=0;if(0===n)return 0;n!==i.length&&(o=!1);}if(o)return 2;for(var l=0;l<3;l++){for(var c=Number.MAX_VALUE,u=-Number.MAX_VALUE,h=0;h<e.points.length;h++){var p=e.points[h][l]-this.min[l];c=Math.min(c,p),u=Math.max(u,p);}if(u<0||c>this.max[l]-this.min[l])return 0}return 1};var wo=function(t,e,i,o){if(void 0===t&&(t=0),void 0===e&&(e=0),void 0===i&&(i=0),void 0===o&&(o=0),isNaN(t)||t<0||isNaN(e)||e<0||isNaN(i)||i<0||isNaN(o)||o<0)throw new Error(\"Invalid value for edge-insets, top, bottom, left and right must all be numbers\");this.top=t,this.bottom=e,this.left=i,this.right=o;};wo.prototype.interpolate=function(e,i,o){return null!=i.top&&null!=e.top&&(this.top=t.number(e.top,i.top,o)),null!=i.bottom&&null!=e.bottom&&(this.bottom=t.number(e.bottom,i.bottom,o)),null!=i.left&&null!=e.left&&(this.left=t.number(e.left,i.left,o)),null!=i.right&&null!=e.right&&(this.right=t.number(e.right,i.right,o)),this},wo.prototype.getCenter=function(e,i){var o=t.clamp((this.left+e-this.right)/2,0,e),r=t.clamp((this.top+i-this.bottom)/2,0,i);return new t.Point(o,r)},wo.prototype.equals=function(t){return this.top===t.top&&this.bottom===t.bottom&&this.left===t.left&&this.right===t.right},wo.prototype.clone=function(){return new wo(this.top,this.bottom,this.left,this.right)},wo.prototype.toJSON=function(){return {top:this.top,bottom:this.bottom,left:this.left,right:this.right}};var To=function(e,i,o,r,a){this.tileSize=512,this.maxValidLatitude=85.051129,this._renderWorldCopies=void 0===a||a,this._minZoom=e||0,this._maxZoom=i||22,this._minPitch=null==o?0:o,this._maxPitch=null==r?60:r,this.setMaxBounds(),this.width=0,this.height=0,this._center=new t.LngLat(0,0),this.zoom=0,this.angle=0,this._fov=.6435011087932844,this._pitch=0,this._unmodified=!0,this._edgeInsets=new wo,this._posMatrixCache={},this._alignedPosMatrixCache={};},Eo={minZoom:{configurable:!0},maxZoom:{configurable:!0},minPitch:{configurable:!0},maxPitch:{configurable:!0},renderWorldCopies:{configurable:!0},worldSize:{configurable:!0},centerOffset:{configurable:!0},size:{configurable:!0},bearing:{configurable:!0},pitch:{configurable:!0},fov:{configurable:!0},zoom:{configurable:!0},center:{configurable:!0},padding:{configurable:!0},centerPoint:{configurable:!0},unmodified:{configurable:!0},point:{configurable:!0}};To.prototype.clone=function(){var t=new To(this._minZoom,this._maxZoom,this._minPitch,this.maxPitch,this._renderWorldCopies);return t.tileSize=this.tileSize,t.latRange=this.latRange,t.width=this.width,t.height=this.height,t._center=this._center,t.zoom=this.zoom,t.angle=this.angle,t._fov=this._fov,t._pitch=this._pitch,t._unmodified=this._unmodified,t._edgeInsets=this._edgeInsets.clone(),t._calcMatrices(),t},Eo.minZoom.get=function(){return this._minZoom},Eo.minZoom.set=function(t){this._minZoom!==t&&(this._minZoom=t,this.zoom=Math.max(this.zoom,t));},Eo.maxZoom.get=function(){return this._maxZoom},Eo.maxZoom.set=function(t){this._maxZoom!==t&&(this._maxZoom=t,this.zoom=Math.min(this.zoom,t));},Eo.minPitch.get=function(){return this._minPitch},Eo.minPitch.set=function(t){this._minPitch!==t&&(this._minPitch=t,this.pitch=Math.max(this.pitch,t));},Eo.maxPitch.get=function(){return this._maxPitch},Eo.maxPitch.set=function(t){this._maxPitch!==t&&(this._maxPitch=t,this.pitch=Math.min(this.pitch,t));},Eo.renderWorldCopies.get=function(){return this._renderWorldCopies},Eo.renderWorldCopies.set=function(t){void 0===t?t=!0:null===t&&(t=!1),this._renderWorldCopies=t;},Eo.worldSize.get=function(){return this.tileSize*this.scale},Eo.centerOffset.get=function(){return this.centerPoint._sub(this.size._div(2))},Eo.size.get=function(){return new t.Point(this.width,this.height)},Eo.bearing.get=function(){return -this.angle/Math.PI*180},Eo.bearing.set=function(e){var i=-t.wrap(e,-180,180)*Math.PI/180;this.angle!==i&&(this._unmodified=!1,this.angle=i,this._calcMatrices(),this.rotationMatrix=t.create$2(),t.rotate(this.rotationMatrix,this.rotationMatrix,this.angle));},Eo.pitch.get=function(){return this._pitch/Math.PI*180},Eo.pitch.set=function(e){var i=t.clamp(e,this.minPitch,this.maxPitch)/180*Math.PI;this._pitch!==i&&(this._unmodified=!1,this._pitch=i,this._calcMatrices());},Eo.fov.get=function(){return this._fov/Math.PI*180},Eo.fov.set=function(t){t=Math.max(.01,Math.min(60,t)),this._fov!==t&&(this._unmodified=!1,this._fov=t/180*Math.PI,this._calcMatrices());},Eo.zoom.get=function(){return this._zoom},Eo.zoom.set=function(t){var e=Math.min(Math.max(t,this.minZoom),this.maxZoom);this._zoom!==e&&(this._unmodified=!1,this._zoom=e,this.scale=this.zoomScale(e),this.tileZoom=Math.floor(e),this.zoomFraction=e-this.tileZoom,this._constrain(),this._calcMatrices());},Eo.center.get=function(){return this._center},Eo.center.set=function(t){t.lat===this._center.lat&&t.lng===this._center.lng||(this._unmodified=!1,this._center=t,this._constrain(),this._calcMatrices());},Eo.padding.get=function(){return this._edgeInsets.toJSON()},Eo.padding.set=function(t){this._edgeInsets.equals(t)||(this._unmodified=!1,this._edgeInsets.interpolate(this._edgeInsets,t,1),this._calcMatrices());},Eo.centerPoint.get=function(){return this._edgeInsets.getCenter(this.width,this.height)},To.prototype.isPaddingEqual=function(t){return this._edgeInsets.equals(t)},To.prototype.interpolatePadding=function(t,e,i){this._unmodified=!1,this._edgeInsets.interpolate(t,e,i),this._constrain(),this._calcMatrices();},To.prototype.coveringZoomLevel=function(t){var e=(t.roundZoom?Math.round:Math.floor)(this.zoom+this.scaleZoom(this.tileSize/t.tileSize));return Math.max(0,e)},To.prototype.getVisibleUnwrappedCoordinates=function(e){var i=[new t.UnwrappedTileID(0,e)];if(this._renderWorldCopies)for(var o=this.pointCoordinate(new t.Point(0,0)),r=this.pointCoordinate(new t.Point(this.width,0)),a=this.pointCoordinate(new t.Point(this.width,this.height)),n=this.pointCoordinate(new t.Point(0,this.height)),s=Math.floor(Math.min(o.x,r.x,a.x,n.x)),l=Math.floor(Math.max(o.x,r.x,a.x,n.x)),c=s-1;c<=l+1;c++)0!==c&&i.push(new t.UnwrappedTileID(c,e));return i},To.prototype.coveringTiles=function(e){var i=this.coveringZoomLevel(e),o=i;if(void 0!==e.minzoom&&i<e.minzoom)return [];void 0!==e.maxzoom&&i>e.maxzoom&&(i=e.maxzoom);var r=t.MercatorCoordinate.fromLngLat(this.center),a=Math.pow(2,i),n=[a*r.x,a*r.y,0],s=xo.fromInvProjectionMatrix(this.invProjMatrix,this.worldSize,i),l=e.minzoom||0;this.pitch<=60&&this._edgeInsets.top<.1&&(l=i);var c=function(t){return {aabb:new bo([t*a,0,0],[(t+1)*a,a,0]),zoom:0,x:0,y:0,wrap:t,fullyVisible:!1}},u=[],h=[],p=i,d=e.reparseOverscaled?o:i;if(this._renderWorldCopies)for(var _=1;_<=3;_++)u.push(c(-_)),u.push(c(_));for(u.push(c(0));u.length>0;){var f=u.pop(),m=f.x,g=f.y,v=f.fullyVisible;if(!v){var y=f.aabb.intersects(s);if(0===y)continue;v=2===y;}var x=f.aabb.distanceX(n),b=f.aabb.distanceY(n),w=Math.max(Math.abs(x),Math.abs(b));if(f.zoom===p||w>3+(1<<p-f.zoom)-2&&f.zoom>=l)h.push({tileID:new t.OverscaledTileID(f.zoom===p?d:f.zoom,f.wrap,f.zoom,m,g),distanceSq:t.sqrLen([n[0]-.5-m,n[1]-.5-g])});else for(var T=0;T<4;T++){var E=(m<<1)+T%2,I=(g<<1)+(T>>1);u.push({aabb:f.aabb.quadrant(T),zoom:f.zoom+1,x:E,y:I,wrap:f.wrap,fullyVisible:v});}}return h.sort((function(t,e){return t.distanceSq-e.distanceSq})).map((function(t){return t.tileID}))},To.prototype.resize=function(t,e){this.width=t,this.height=e,this.pixelsToGLUnits=[2/t,-2/e],this._constrain(),this._calcMatrices();},Eo.unmodified.get=function(){return this._unmodified},To.prototype.zoomScale=function(t){return Math.pow(2,t)},To.prototype.scaleZoom=function(t){return Math.log(t)/Math.LN2},To.prototype.project=function(e){var i=t.clamp(e.lat,-this.maxValidLatitude,this.maxValidLatitude);return new t.Point(t.mercatorXfromLng(e.lng)*this.worldSize,t.mercatorYfromLat(i)*this.worldSize)},To.prototype.unproject=function(e){return new t.MercatorCoordinate(e.x/this.worldSize,e.y/this.worldSize).toLngLat()},Eo.point.get=function(){return this.project(this.center)},To.prototype.setLocationAtPoint=function(e,i){var o=this.pointCoordinate(i),r=this.pointCoordinate(this.centerPoint),a=this.locationCoordinate(e),n=new t.MercatorCoordinate(a.x-(o.x-r.x),a.y-(o.y-r.y));this.center=this.coordinateLocation(n),this._renderWorldCopies&&(this.center=this.center.wrap());},To.prototype.locationPoint=function(t){return this.coordinatePoint(this.locationCoordinate(t))},To.prototype.pointLocation=function(t){return this.coordinateLocation(this.pointCoordinate(t))},To.prototype.locationCoordinate=function(e){return t.MercatorCoordinate.fromLngLat(e)},To.prototype.coordinateLocation=function(t){return t.toLngLat()},To.prototype.pointCoordinate=function(e){var i=[e.x,e.y,0,1],o=[e.x,e.y,1,1];t.transformMat4(i,i,this.pixelMatrixInverse),t.transformMat4(o,o,this.pixelMatrixInverse);var r=i[3],a=o[3],n=i[1]/r,s=o[1]/a,l=i[2]/r,c=o[2]/a,u=l===c?0:(0-l)/(c-l);return new t.MercatorCoordinate(t.number(i[0]/r,o[0]/a,u)/this.worldSize,t.number(n,s,u)/this.worldSize)},To.prototype.coordinatePoint=function(e){var i=[e.x*this.worldSize,e.y*this.worldSize,0,1];return t.transformMat4(i,i,this.pixelMatrix),new t.Point(i[0]/i[3],i[1]/i[3])},To.prototype.getBounds=function(){return (new t.LngLatBounds).extend(this.pointLocation(new t.Point(0,0))).extend(this.pointLocation(new t.Point(this.width,0))).extend(this.pointLocation(new t.Point(this.width,this.height))).extend(this.pointLocation(new t.Point(0,this.height)))},To.prototype.getMaxBounds=function(){return this.latRange&&2===this.latRange.length&&this.lngRange&&2===this.lngRange.length?new t.LngLatBounds([this.lngRange[0],this.latRange[0]],[this.lngRange[1],this.latRange[1]]):null},To.prototype.setMaxBounds=function(t){t?(this.lngRange=[t.getWest(),t.getEast()],this.latRange=[t.getSouth(),t.getNorth()],this._constrain()):(this.lngRange=null,this.latRange=[-this.maxValidLatitude,this.maxValidLatitude]);},To.prototype.calculatePosMatrix=function(e,i){void 0===i&&(i=!1);var o=e.key,r=i?this._alignedPosMatrixCache:this._posMatrixCache;if(r[o])return r[o];var a=e.canonical,n=this.worldSize/this.zoomScale(a.z),s=a.x+Math.pow(2,a.z)*e.wrap,l=t.identity(new Float64Array(16));return t.translate(l,l,[s*n,a.y*n,0]),t.scale(l,l,[n/t.EXTENT,n/t.EXTENT,1]),t.multiply(l,i?this.alignedProjMatrix:this.projMatrix,l),r[o]=new Float32Array(l),r[o]},To.prototype.customLayerMatrix=function(){return this.mercatorMatrix.slice()},To.prototype._constrain=function(){if(this.center&&this.width&&this.height&&!this._constraining){this._constraining=!0;var e,i,o,r,a=-90,n=90,s=-180,l=180,c=this.size,u=this._unmodified;if(this.latRange){var h=this.latRange;a=t.mercatorYfromLat(h[1])*this.worldSize,e=(n=t.mercatorYfromLat(h[0])*this.worldSize)-a<c.y?c.y/(n-a):0;}if(this.lngRange){var p=this.lngRange;s=t.mercatorXfromLng(p[0])*this.worldSize,i=(l=t.mercatorXfromLng(p[1])*this.worldSize)-s<c.x?c.x/(l-s):0;}var d=this.point,_=Math.max(i||0,e||0);if(_)return this.center=this.unproject(new t.Point(i?(l+s)/2:d.x,e?(n+a)/2:d.y)),this.zoom+=this.scaleZoom(_),this._unmodified=u,void(this._constraining=!1);if(this.latRange){var f=d.y,m=c.y/2;f-m<a&&(r=a+m),f+m>n&&(r=n-m);}if(this.lngRange){var g=d.x,v=c.x/2;g-v<s&&(o=s+v),g+v>l&&(o=l-v);}void 0===o&&void 0===r||(this.center=this.unproject(new t.Point(void 0!==o?o:d.x,void 0!==r?r:d.y))),this._unmodified=u,this._constraining=!1;}},To.prototype._calcMatrices=function(){if(this.height){var e=this.centerOffset;this.cameraToCenterDistance=.5/Math.tan(this._fov/2)*this.height;var i=Math.PI/2+this._pitch,o=this._fov*(.5+e.y/this.height),r=Math.sin(o)*this.cameraToCenterDistance/Math.sin(t.clamp(Math.PI-i-o,.01,Math.PI-.01)),a=this.point,n=a.x,s=a.y,l=1.01*(Math.cos(Math.PI/2-this._pitch)*r+this.cameraToCenterDistance),c=this.height/50,u=new Float64Array(16);t.perspective(u,this._fov,this.width/this.height,c,l),u[8]=2*-e.x/this.width,u[9]=2*e.y/this.height,t.scale(u,u,[1,-1,1]),t.translate(u,u,[0,0,-this.cameraToCenterDistance]),t.rotateX(u,u,this._pitch),t.rotateZ(u,u,this.angle),t.translate(u,u,[-n,-s,0]),this.mercatorMatrix=t.scale([],u,[this.worldSize,this.worldSize,this.worldSize]),t.scale(u,u,[1,1,t.mercatorZfromAltitude(1,this.center.lat)*this.worldSize,1]),this.projMatrix=u,this.invProjMatrix=t.invert([],this.projMatrix);var h=this.width%2/2,p=this.height%2/2,d=Math.cos(this.angle),_=Math.sin(this.angle),f=n-Math.round(n)+d*h+_*p,m=s-Math.round(s)+d*p+_*h,g=new Float64Array(u);if(t.translate(g,g,[f>.5?f-1:f,m>.5?m-1:m,0]),this.alignedProjMatrix=g,u=t.create(),t.scale(u,u,[this.width/2,-this.height/2,1]),t.translate(u,u,[1,-1,0]),this.labelPlaneMatrix=u,u=t.create(),t.scale(u,u,[1,-1,1]),t.translate(u,u,[-1,-1,0]),t.scale(u,u,[2/this.width,2/this.height,1]),this.glCoordMatrix=u,this.pixelMatrix=t.multiply(new Float64Array(16),this.labelPlaneMatrix,this.projMatrix),!(u=t.invert(new Float64Array(16),this.pixelMatrix)))throw new Error(\"failed to invert matrix\");this.pixelMatrixInverse=u,this._posMatrixCache={},this._alignedPosMatrixCache={};}},To.prototype.maxPitchScaleFactor=function(){if(!this.pixelMatrixInverse)return 1;var e=this.pointCoordinate(new t.Point(0,0)),i=[e.x*this.worldSize,e.y*this.worldSize,0,1];return t.transformMat4(i,i,this.pixelMatrix)[3]/this.cameraToCenterDistance},To.prototype.getCameraPoint=function(){var e=Math.tan(this._pitch)*(this.cameraToCenterDistance||1);return this.centerPoint.add(new t.Point(0,e))},To.prototype.getCameraQueryGeometry=function(e){var i=this.getCameraPoint();if(1===e.length)return [e[0],i];for(var o=i.x,r=i.y,a=i.x,n=i.y,s=0,l=e;s<l.length;s+=1){var c=l[s];o=Math.min(o,c.x),r=Math.min(r,c.y),a=Math.max(a,c.x),n=Math.max(n,c.y);}return [new t.Point(o,r),new t.Point(a,r),new t.Point(a,n),new t.Point(o,n),new t.Point(o,r)]},Object.defineProperties(To.prototype,Eo);var Io=function(e){var i,o,r,a;this._hashName=e&&encodeURIComponent(e),t.bindAll([\"_getCurrentHash\",\"_onHashChange\",\"_updateHash\"],this),this._updateHash=(i=this._updateHashUnthrottled.bind(this),o=!1,r=null,a=function(){r=null,o&&(i(),r=setTimeout(a,300),o=!1);},function(){return o=!0,r||a(),r});};Io.prototype.addTo=function(e){return this._map=e,t.window.addEventListener(\"hashchange\",this._onHashChange,!1),this._map.on(\"moveend\",this._updateHash),this},Io.prototype.remove=function(){return t.window.removeEventListener(\"hashchange\",this._onHashChange,!1),this._map.off(\"moveend\",this._updateHash),clearTimeout(this._updateHash()),delete this._map,this},Io.prototype.getHashString=function(e){var i=this._map.getCenter(),o=Math.round(100*this._map.getZoom())/100,r=Math.ceil((o*Math.LN2+Math.log(512/360/.5))/Math.LN10),a=Math.pow(10,r),n=Math.round(i.lng*a)/a,s=Math.round(i.lat*a)/a,l=this._map.getBearing(),c=this._map.getPitch(),u=\"\";if(u+=e?\"/\"+n+\"/\"+s+\"/\"+o:o+\"/\"+s+\"/\"+n,(l||c)&&(u+=\"/\"+Math.round(10*l)/10),c&&(u+=\"/\"+Math.round(c)),this._hashName){var h=this._hashName,p=!1,d=t.window.location.hash.slice(1).split(\"&\").map((function(t){var e=t.split(\"=\")[0];return e===h?(p=!0,e+\"=\"+u):t})).filter((function(t){return t}));return p||d.push(h+\"=\"+u),\"#\"+d.join(\"&\")}return \"#\"+u},Io.prototype._getCurrentHash=function(){var e,i=this,o=t.window.location.hash.replace(\"#\",\"\");return this._hashName?(o.split(\"&\").map((function(t){return t.split(\"=\")})).forEach((function(t){t[0]===i._hashName&&(e=t);})),(e&&e[1]||\"\").split(\"/\")):o.split(\"/\")},Io.prototype._onHashChange=function(){var t=this._getCurrentHash();if(t.length>=3&&!t.some((function(t){return isNaN(t)}))){var e=this._map.dragRotate.isEnabled()&&this._map.touchZoomRotate.isEnabled()?+(t[3]||0):this._map.getBearing();return this._map.jumpTo({center:[+t[2],+t[1]],zoom:+t[0],bearing:e,pitch:+(t[4]||0)}),!0}return !1},Io.prototype._updateHashUnthrottled=function(){var e=t.window.location.href.replace(/(#.+)?$/,this.getHashString());try{t.window.history.replaceState(t.window.history.state,null,e);}catch(t){}};var Po={linearity:.3,easing:t.bezier(0,0,.3,1)},So=t.extend({deceleration:2500,maxSpeed:1400},Po),Co=t.extend({deceleration:20,maxSpeed:1400},Po),zo=t.extend({deceleration:1e3,maxSpeed:360},Po),Do=t.extend({deceleration:1e3,maxSpeed:90},Po),Ao=function(t){this._map=t,this.clear();};function Mo(t,e){(!t.duration||t.duration<e.duration)&&(t.duration=e.duration,t.easing=e.easing);}function Lo(e,i,o){var r=o.maxSpeed,a=o.linearity,n=o.deceleration,s=t.clamp(e*a/(i/1e3),-r,r),l=Math.abs(s)/(n*a);return {easing:o.easing,duration:1e3*l,amount:s*(l/2)}}Ao.prototype.clear=function(){this._inertiaBuffer=[];},Ao.prototype.record=function(e){this._drainInertiaBuffer(),this._inertiaBuffer.push({time:t.browser.now(),settings:e});},Ao.prototype._drainInertiaBuffer=function(){for(var e=this._inertiaBuffer,i=t.browser.now();e.length>0&&i-e[0].time>160;)e.shift();},Ao.prototype._onMoveEnd=function(e){if(this._drainInertiaBuffer(),!(this._inertiaBuffer.length<2)){for(var i={zoom:0,bearing:0,pitch:0,pan:new t.Point(0,0),pinchAround:void 0,around:void 0},o=0,r=this._inertiaBuffer;o<r.length;o+=1){var a=r[o].settings;i.zoom+=a.zoomDelta||0,i.bearing+=a.bearingDelta||0,i.pitch+=a.pitchDelta||0,a.panDelta&&i.pan._add(a.panDelta),a.around&&(i.around=a.around),a.pinchAround&&(i.pinchAround=a.pinchAround);}var n=this._inertiaBuffer[this._inertiaBuffer.length-1].time-this._inertiaBuffer[0].time,s={};if(i.pan.mag()){var l=Lo(i.pan.mag(),n,t.extend({},So,e||{}));s.offset=i.pan.mult(l.amount/i.pan.mag()),s.center=this._map.transform.center,Mo(s,l);}if(i.zoom){var c=Lo(i.zoom,n,Co);s.zoom=this._map.transform.zoom+c.amount,Mo(s,c);}if(i.bearing){var u=Lo(i.bearing,n,zo);s.bearing=this._map.transform.bearing+t.clamp(u.amount,-179,179),Mo(s,u);}if(i.pitch){var h=Lo(i.pitch,n,Do);s.pitch=this._map.transform.pitch+h.amount,Mo(s,h);}if(s.zoom||s.bearing){var p=void 0===i.pinchAround?i.around:i.pinchAround;s.around=p?this._map.unproject(p):this._map.getCenter();}return this.clear(),t.extend(s,{noMoveStart:!0})}};var Ro=function(e){function o(o,r,a,n){void 0===n&&(n={});var s=i.mousePos(r.getCanvasContainer(),a),l=r.unproject(s);e.call(this,o,t.extend({point:s,lngLat:l,originalEvent:a},n)),this._defaultPrevented=!1,this.target=r;}e&&(o.__proto__=e),(o.prototype=Object.create(e&&e.prototype)).constructor=o;var r={defaultPrevented:{configurable:!0}};return o.prototype.preventDefault=function(){this._defaultPrevented=!0;},r.defaultPrevented.get=function(){return this._defaultPrevented},Object.defineProperties(o.prototype,r),o}(t.Event),ko=function(e){function o(o,r,a){var n=\"touchend\"===o?a.changedTouches:a.touches,s=i.touchPos(r.getCanvasContainer(),n),l=s.map((function(t){return r.unproject(t)})),c=s.reduce((function(t,e,i,o){return t.add(e.div(o.length))}),new t.Point(0,0)),u=r.unproject(c);e.call(this,o,{points:s,point:c,lngLats:l,lngLat:u,originalEvent:a}),this._defaultPrevented=!1;}e&&(o.__proto__=e),(o.prototype=Object.create(e&&e.prototype)).constructor=o;var r={defaultPrevented:{configurable:!0}};return o.prototype.preventDefault=function(){this._defaultPrevented=!0;},r.defaultPrevented.get=function(){return this._defaultPrevented},Object.defineProperties(o.prototype,r),o}(t.Event),Bo=function(t){function e(e,i,o){t.call(this,e,{originalEvent:o}),this._defaultPrevented=!1;}t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e;var i={defaultPrevented:{configurable:!0}};return e.prototype.preventDefault=function(){this._defaultPrevented=!0;},i.defaultPrevented.get=function(){return this._defaultPrevented},Object.defineProperties(e.prototype,i),e}(t.Event),Oo=function(t,e){this._map=t,this._clickTolerance=e.clickTolerance;};Oo.prototype.reset=function(){delete this._mousedownPos;},Oo.prototype.wheel=function(t){return this._firePreventable(new Bo(t.type,this._map,t))},Oo.prototype.mousedown=function(t,e){return this._mousedownPos=e,this._firePreventable(new Ro(t.type,this._map,t))},Oo.prototype.mouseup=function(t){this._map.fire(new Ro(t.type,this._map,t));},Oo.prototype.click=function(t,e){this._mousedownPos&&this._mousedownPos.dist(e)>=this._clickTolerance||this._map.fire(new Ro(t.type,this._map,t));},Oo.prototype.dblclick=function(t){return this._firePreventable(new Ro(t.type,this._map,t))},Oo.prototype.mouseover=function(t){this._map.fire(new Ro(t.type,this._map,t));},Oo.prototype.mouseout=function(t){this._map.fire(new Ro(t.type,this._map,t));},Oo.prototype.touchstart=function(t){return this._firePreventable(new ko(t.type,this._map,t))},Oo.prototype.touchmove=function(t){this._map.fire(new ko(t.type,this._map,t));},Oo.prototype.touchend=function(t){this._map.fire(new ko(t.type,this._map,t));},Oo.prototype.touchcancel=function(t){this._map.fire(new ko(t.type,this._map,t));},Oo.prototype._firePreventable=function(t){if(this._map.fire(t),t.defaultPrevented)return {}},Oo.prototype.isEnabled=function(){return !0},Oo.prototype.isActive=function(){return !1},Oo.prototype.enable=function(){},Oo.prototype.disable=function(){};var Fo=function(t){this._map=t;};Fo.prototype.reset=function(){this._delayContextMenu=!1,delete this._contextMenuEvent;},Fo.prototype.mousemove=function(t){this._map.fire(new Ro(t.type,this._map,t));},Fo.prototype.mousedown=function(){this._delayContextMenu=!0;},Fo.prototype.mouseup=function(){this._delayContextMenu=!1,this._contextMenuEvent&&(this._map.fire(new Ro(\"contextmenu\",this._map,this._contextMenuEvent)),delete this._contextMenuEvent);},Fo.prototype.contextmenu=function(t){this._delayContextMenu?this._contextMenuEvent=t:this._map.fire(new Ro(t.type,this._map,t)),this._map.listens(\"contextmenu\")&&t.preventDefault();},Fo.prototype.isEnabled=function(){return !0},Fo.prototype.isActive=function(){return !1},Fo.prototype.enable=function(){},Fo.prototype.disable=function(){};var Uo=function(t,e){this._map=t,this._el=t.getCanvasContainer(),this._container=t.getContainer(),this._clickTolerance=e.clickTolerance||1;};function No(t,e){for(var i={},o=0;o<t.length;o++)i[t[o].identifier]=e[o];return i}Uo.prototype.isEnabled=function(){return !!this._enabled},Uo.prototype.isActive=function(){return !!this._active},Uo.prototype.enable=function(){this.isEnabled()||(this._enabled=!0);},Uo.prototype.disable=function(){this.isEnabled()&&(this._enabled=!1);},Uo.prototype.mousedown=function(t,e){this.isEnabled()&&t.shiftKey&&0===t.button&&(i.disableDrag(),this._startPos=this._lastPos=e,this._active=!0);},Uo.prototype.mousemoveWindow=function(t,e){if(this._active){var o=e;if(!(this._lastPos.equals(o)||!this._box&&o.dist(this._startPos)<this._clickTolerance)){var r=this._startPos;this._lastPos=o,this._box||(this._box=i.create(\"div\",\"mapboxgl-boxzoom\",this._container),this._container.classList.add(\"mapboxgl-crosshair\"),this._fireEvent(\"boxzoomstart\",t));var a=Math.min(r.x,o.x),n=Math.max(r.x,o.x),s=Math.min(r.y,o.y),l=Math.max(r.y,o.y);i.setTransform(this._box,\"translate(\"+a+\"px,\"+s+\"px)\"),this._box.style.width=n-a+\"px\",this._box.style.height=l-s+\"px\";}}},Uo.prototype.mouseupWindow=function(e,o){var r=this;if(this._active&&0===e.button){var a=this._startPos,n=o;if(this.reset(),i.suppressClick(),a.x!==n.x||a.y!==n.y)return this._map.fire(new t.Event(\"boxzoomend\",{originalEvent:e})),{cameraAnimation:function(t){return t.fitScreenCoordinates(a,n,r._map.getBearing(),{linear:!0})}};this._fireEvent(\"boxzoomcancel\",e);}},Uo.prototype.keydown=function(t){this._active&&27===t.keyCode&&(this.reset(),this._fireEvent(\"boxzoomcancel\",t));},Uo.prototype.blur=function(){this.reset();},Uo.prototype.reset=function(){this._active=!1,this._container.classList.remove(\"mapboxgl-crosshair\"),this._box&&(i.remove(this._box),this._box=null),i.enableDrag(),delete this._startPos,delete this._lastPos;},Uo.prototype._fireEvent=function(e,i){return this._map.fire(new t.Event(e,{originalEvent:i}))};var Zo=function(t){this.reset(),this.numTouches=t.numTouches;};Zo.prototype.reset=function(){delete this.centroid,delete this.startTime,delete this.touches,this.aborted=!1;},Zo.prototype.touchstart=function(e,i,o){(this.centroid||o.length>this.numTouches)&&(this.aborted=!0),this.aborted||(void 0===this.startTime&&(this.startTime=e.timeStamp),o.length===this.numTouches&&(this.centroid=function(e){for(var i=new t.Point(0,0),o=0,r=e;o<r.length;o+=1)i._add(r[o]);return i.div(e.length)}(i),this.touches=No(o,i)));},Zo.prototype.touchmove=function(t,e,i){if(!this.aborted&&this.centroid){var o=No(i,e);for(var r in this.touches){var a=o[r];(!a||a.dist(this.touches[r])>30)&&(this.aborted=!0);}}},Zo.prototype.touchend=function(t,e,i){if((!this.centroid||t.timeStamp-this.startTime>500)&&(this.aborted=!0),0===i.length){var o=!this.aborted&&this.centroid;if(this.reset(),o)return o}};var qo=function(t){this.singleTap=new Zo(t),this.numTaps=t.numTaps,this.reset();};qo.prototype.reset=function(){this.lastTime=1/0,delete this.lastTap,this.count=0,this.singleTap.reset();},qo.prototype.touchstart=function(t,e,i){this.singleTap.touchstart(t,e,i);},qo.prototype.touchmove=function(t,e,i){this.singleTap.touchmove(t,e,i);},qo.prototype.touchend=function(t,e,i){var o=this.singleTap.touchend(t,e,i);if(o){var r=t.timeStamp-this.lastTime<500,a=!this.lastTap||this.lastTap.dist(o)<30;if(r&&a||this.reset(),this.count++,this.lastTime=t.timeStamp,this.lastTap=o,this.count===this.numTaps)return this.reset(),o}};var jo=function(){this._zoomIn=new qo({numTouches:1,numTaps:2}),this._zoomOut=new qo({numTouches:2,numTaps:1}),this.reset();};jo.prototype.reset=function(){this._active=!1,this._zoomIn.reset(),this._zoomOut.reset();},jo.prototype.touchstart=function(t,e,i){this._zoomIn.touchstart(t,e,i),this._zoomOut.touchstart(t,e,i);},jo.prototype.touchmove=function(t,e,i){this._zoomIn.touchmove(t,e,i),this._zoomOut.touchmove(t,e,i);},jo.prototype.touchend=function(t,e,i){var o=this,r=this._zoomIn.touchend(t,e,i),a=this._zoomOut.touchend(t,e,i);return r?(this._active=!0,t.preventDefault(),setTimeout((function(){return o.reset()}),0),{cameraAnimation:function(e){return e.easeTo({duration:300,zoom:e.getZoom()+1,around:e.unproject(r)},{originalEvent:t})}}):a?(this._active=!0,t.preventDefault(),setTimeout((function(){return o.reset()}),0),{cameraAnimation:function(e){return e.easeTo({duration:300,zoom:e.getZoom()-1,around:e.unproject(a)},{originalEvent:t})}}):void 0},jo.prototype.touchcancel=function(){this.reset();},jo.prototype.enable=function(){this._enabled=!0;},jo.prototype.disable=function(){this._enabled=!1,this.reset();},jo.prototype.isEnabled=function(){return this._enabled},jo.prototype.isActive=function(){return this._active};var Vo={0:1,2:2},Go=function(t){this.reset(),this._clickTolerance=t.clickTolerance||1;};Go.prototype.blur=function(){this.reset();},Go.prototype.reset=function(){this._active=!1,this._moved=!1,delete this._lastPoint,delete this._eventButton;},Go.prototype._correctButton=function(t,e){return !1},Go.prototype._move=function(t,e){return {}},Go.prototype.mousedown=function(t,e){if(!this._lastPoint){var o=i.mouseButton(t);this._correctButton(t,o)&&(this._lastPoint=e,this._eventButton=o);}},Go.prototype.mousemoveWindow=function(t,e){var i=this._lastPoint;if(i)if(t.preventDefault(),function(t,e){var i=Vo[e];return void 0===t.buttons||(t.buttons&i)!==i}(t,this._eventButton))this.reset();else if(this._moved||!(e.dist(i)<this._clickTolerance))return this._moved=!0,this._lastPoint=e,this._move(i,e)},Go.prototype.mouseupWindow=function(t){this._lastPoint&&i.mouseButton(t)===this._eventButton&&(this._moved&&i.suppressClick(),this.reset());},Go.prototype.enable=function(){this._enabled=!0;},Go.prototype.disable=function(){this._enabled=!1,this.reset();},Go.prototype.isEnabled=function(){return this._enabled},Go.prototype.isActive=function(){return this._active};var Wo=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.mousedown=function(e,i){t.prototype.mousedown.call(this,e,i),this._lastPoint&&(this._active=!0);},e.prototype._correctButton=function(t,e){return 0===e&&!t.ctrlKey},e.prototype._move=function(t,e){return {around:e,panDelta:e.sub(t)}},e}(Go),Xo=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._correctButton=function(t,e){return 0===e&&t.ctrlKey||2===e},e.prototype._move=function(t,e){var i=.8*(e.x-t.x);if(i)return this._active=!0,{bearingDelta:i}},e.prototype.contextmenu=function(t){t.preventDefault();},e}(Go),Ho=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype._correctButton=function(t,e){return 0===e&&t.ctrlKey||2===e},e.prototype._move=function(t,e){var i=-.5*(e.y-t.y);if(i)return this._active=!0,{pitchDelta:i}},e.prototype.contextmenu=function(t){t.preventDefault();},e}(Go),Ko=function(t){this._minTouches=1,this._clickTolerance=t.clickTolerance||1,this.reset();};Ko.prototype.reset=function(){this._active=!1,this._touches={},this._sum=new t.Point(0,0);},Ko.prototype.touchstart=function(t,e,i){return this._calculateTransform(t,e,i)},Ko.prototype.touchmove=function(t,e,i){if(this._active&&!(i.length<this._minTouches))return t.preventDefault(),this._calculateTransform(t,e,i)},Ko.prototype.touchend=function(t,e,i){this._calculateTransform(t,e,i),this._active&&i.length<this._minTouches&&this.reset();},Ko.prototype.touchcancel=function(){this.reset();},Ko.prototype._calculateTransform=function(e,i,o){o.length>0&&(this._active=!0);var r=No(o,i),a=new t.Point(0,0),n=new t.Point(0,0),s=0;for(var l in r){var c=r[l],u=this._touches[l];u&&(a._add(c),n._add(c.sub(u)),s++,r[l]=c);}if(this._touches=r,!(s<this._minTouches)&&n.mag()){var h=n.div(s);if(this._sum._add(h),!(this._sum.mag()<this._clickTolerance))return {around:a.div(s),panDelta:h}}},Ko.prototype.enable=function(){this._enabled=!0;},Ko.prototype.disable=function(){this._enabled=!1,this.reset();},Ko.prototype.isEnabled=function(){return this._enabled},Ko.prototype.isActive=function(){return this._active};var Yo=function(){this.reset();};function Jo(t,e,i){for(var o=0;o<t.length;o++)if(t[o].identifier===i)return e[o]}function Qo(t,e){return Math.log(t/e)/Math.LN2}Yo.prototype.reset=function(){this._active=!1,delete this._firstTwoTouches;},Yo.prototype._start=function(t){},Yo.prototype._move=function(t,e,i){return {}},Yo.prototype.touchstart=function(t,e,i){this._firstTwoTouches||i.length<2||(this._firstTwoTouches=[i[0].identifier,i[1].identifier],this._start([e[0],e[1]]));},Yo.prototype.touchmove=function(t,e,i){if(this._firstTwoTouches){t.preventDefault();var o=this._firstTwoTouches,r=o[1],a=Jo(i,e,o[0]),n=Jo(i,e,r);if(a&&n){var s=this._aroundCenter?null:a.add(n).div(2);return this._move([a,n],s,t)}}},Yo.prototype.touchend=function(t,e,o){if(this._firstTwoTouches){var r=this._firstTwoTouches,a=r[1],n=Jo(o,e,r[0]),s=Jo(o,e,a);n&&s||(this._active&&i.suppressClick(),this.reset());}},Yo.prototype.touchcancel=function(){this.reset();},Yo.prototype.enable=function(t){this._enabled=!0,this._aroundCenter=!!t&&\"center\"===t.around;},Yo.prototype.disable=function(){this._enabled=!1,this.reset();},Yo.prototype.isEnabled=function(){return this._enabled},Yo.prototype.isActive=function(){return this._active};var $o=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.reset=function(){t.prototype.reset.call(this),delete this._distance,delete this._startDistance;},e.prototype._start=function(t){this._startDistance=this._distance=t[0].dist(t[1]);},e.prototype._move=function(t,e){var i=this._distance;if(this._distance=t[0].dist(t[1]),this._active||!(Math.abs(Qo(this._distance,this._startDistance))<.1))return this._active=!0,{zoomDelta:Qo(this._distance,i),pinchAround:e}},e}(Yo);function tr(t,e){return 180*t.angleWith(e)/Math.PI}var er=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.reset=function(){t.prototype.reset.call(this),delete this._minDiameter,delete this._startVector,delete this._vector;},e.prototype._start=function(t){this._startVector=this._vector=t[0].sub(t[1]),this._minDiameter=t[0].dist(t[1]);},e.prototype._move=function(t,e){var i=this._vector;if(this._vector=t[0].sub(t[1]),this._active||!this._isBelowThreshold(this._vector))return this._active=!0,{bearingDelta:tr(this._vector,i),pinchAround:e}},e.prototype._isBelowThreshold=function(t){this._minDiameter=Math.min(this._minDiameter,t.mag());var e=25/(Math.PI*this._minDiameter)*360,i=tr(t,this._startVector);return Math.abs(i)<e},e}(Yo);function ir(t){return Math.abs(t.y)>Math.abs(t.x)}var or=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e.prototype.reset=function(){t.prototype.reset.call(this),this._valid=void 0,delete this._firstMove,delete this._lastPoints;},e.prototype._start=function(t){this._lastPoints=t,ir(t[0].sub(t[1]))&&(this._valid=!1);},e.prototype._move=function(t,e,i){var o=t[0].sub(this._lastPoints[0]),r=t[1].sub(this._lastPoints[1]);if(this._valid=this.gestureBeginsVertically(o,r,i.timeStamp),this._valid)return this._lastPoints=t,this._active=!0,{pitchDelta:(o.y+r.y)/2*-.5}},e.prototype.gestureBeginsVertically=function(t,e,i){if(void 0!==this._valid)return this._valid;var o=t.mag()>=2,r=e.mag()>=2;if(o||r){if(!o||!r)return void 0===this._firstMove&&(this._firstMove=i),i-this._firstMove<100&&void 0;var a=t.y>0==e.y>0;return ir(t)&&ir(e)&&a}},e}(Yo),rr={panStep:100,bearingStep:15,pitchStep:10},ar=function(){var t=rr;this._panStep=t.panStep,this._bearingStep=t.bearingStep,this._pitchStep=t.pitchStep,this._rotationDisabled=!1;};function nr(t){return t*(2-t)}ar.prototype.blur=function(){this.reset();},ar.prototype.reset=function(){this._active=!1;},ar.prototype.keydown=function(t){var e=this;if(!(t.altKey||t.ctrlKey||t.metaKey)){var i=0,o=0,r=0,a=0,n=0;switch(t.keyCode){case 61:case 107:case 171:case 187:i=1;break;case 189:case 109:case 173:i=-1;break;case 37:t.shiftKey?o=-1:(t.preventDefault(),a=-1);break;case 39:t.shiftKey?o=1:(t.preventDefault(),a=1);break;case 38:t.shiftKey?r=1:(t.preventDefault(),n=-1);break;case 40:t.shiftKey?r=-1:(t.preventDefault(),n=1);break;default:return}return this._rotationDisabled&&(o=0,r=0),{cameraAnimation:function(s){var l=s.getZoom();s.easeTo({duration:300,easeId:\"keyboardHandler\",easing:nr,zoom:i?Math.round(l)+i*(t.shiftKey?2:1):l,bearing:s.getBearing()+o*e._bearingStep,pitch:s.getPitch()+r*e._pitchStep,offset:[-a*e._panStep,-n*e._panStep],center:s.getCenter()},{originalEvent:t});}}}},ar.prototype.enable=function(){this._enabled=!0;},ar.prototype.disable=function(){this._enabled=!1,this.reset();},ar.prototype.isEnabled=function(){return this._enabled},ar.prototype.isActive=function(){return this._active},ar.prototype.disableRotation=function(){this._rotationDisabled=!0;},ar.prototype.enableRotation=function(){this._rotationDisabled=!1;};var sr=function(e,i){this._map=e,this._el=e.getCanvasContainer(),this._handler=i,this._delta=0,this._defaultZoomRate=.01,this._wheelZoomRate=1/450,t.bindAll([\"_onTimeout\"],this);};sr.prototype.setZoomRate=function(t){this._defaultZoomRate=t;},sr.prototype.setWheelZoomRate=function(t){this._wheelZoomRate=t;},sr.prototype.isEnabled=function(){return !!this._enabled},sr.prototype.isActive=function(){return !!this._active||void 0!==this._finishTimeout},sr.prototype.isZooming=function(){return !!this._zooming},sr.prototype.enable=function(t){this.isEnabled()||(this._enabled=!0,this._aroundCenter=t&&\"center\"===t.around);},sr.prototype.disable=function(){this.isEnabled()&&(this._enabled=!1);},sr.prototype.wheel=function(e){if(this.isEnabled()){var i=e.deltaMode===t.window.WheelEvent.DOM_DELTA_LINE?40*e.deltaY:e.deltaY,o=t.browser.now(),r=o-(this._lastWheelEventTime||0);this._lastWheelEventTime=o,0!==i&&i%4.000244140625==0?this._type=\"wheel\":0!==i&&Math.abs(i)<4?this._type=\"trackpad\":r>400?(this._type=null,this._lastValue=i,this._timeout=setTimeout(this._onTimeout,40,e)):this._type||(this._type=Math.abs(r*i)<200?\"trackpad\":\"wheel\",this._timeout&&(clearTimeout(this._timeout),this._timeout=null,i+=this._lastValue)),e.shiftKey&&i&&(i/=4),this._type&&(this._lastWheelEvent=e,this._delta-=i,this._active||this._start(e)),e.preventDefault();}},sr.prototype._onTimeout=function(t){this._type=\"wheel\",this._delta-=this._lastValue,this._active||this._start(t);},sr.prototype._start=function(e){if(this._delta){this._frameId&&(this._frameId=null),this._active=!0,this.isZooming()||(this._zooming=!0),this._finishTimeout&&(clearTimeout(this._finishTimeout),delete this._finishTimeout);var o=i.mousePos(this._el,e);this._around=t.LngLat.convert(this._aroundCenter?this._map.getCenter():this._map.unproject(o)),this._aroundPoint=this._map.transform.locationPoint(this._around),this._frameId||(this._frameId=!0,this._handler._triggerRenderFrame());}},sr.prototype.renderFrame=function(){var e=this;if(this._frameId&&(this._frameId=null,this.isActive())){var i=this._map.transform;if(0!==this._delta){var o=\"wheel\"===this._type&&Math.abs(this._delta)>4.000244140625?this._wheelZoomRate:this._defaultZoomRate,r=2/(1+Math.exp(-Math.abs(this._delta*o)));this._delta<0&&0!==r&&(r=1/r);var a=\"number\"==typeof this._targetZoom?i.zoomScale(this._targetZoom):i.scale;this._targetZoom=Math.min(i.maxZoom,Math.max(i.minZoom,i.scaleZoom(a*r))),\"wheel\"===this._type&&(this._startZoom=i.zoom,this._easing=this._smoothOutEasing(200)),this._delta=0;}var n,s=\"number\"==typeof this._targetZoom?this._targetZoom:i.zoom,l=this._startZoom,c=this._easing,u=!1;if(\"wheel\"===this._type&&l&&c){var h=Math.min((t.browser.now()-this._lastWheelEventTime)/200,1),p=c(h);n=t.number(l,s,p),h<1?this._frameId||(this._frameId=!0):u=!0;}else n=s,u=!0;return this._active=!0,u&&(this._active=!1,this._finishTimeout=setTimeout((function(){e._zooming=!1,e._handler._triggerRenderFrame(),delete e._targetZoom,delete e._finishTimeout;}),200)),{noInertia:!0,needsRenderFrame:!u,zoomDelta:n-i.zoom,around:this._aroundPoint,originalEvent:this._lastWheelEvent}}},sr.prototype._smoothOutEasing=function(e){var i=t.ease;if(this._prevEase){var o=this._prevEase,r=(t.browser.now()-o.start)/o.duration,a=o.easing(r+.01)-o.easing(r),n=.27/Math.sqrt(a*a+1e-4)*.01,s=Math.sqrt(.0729-n*n);i=t.bezier(n,s,.25,1);}return this._prevEase={start:t.browser.now(),duration:e,easing:i},i},sr.prototype.blur=function(){this.reset();},sr.prototype.reset=function(){this._active=!1;};var lr=function(t,e){this._clickZoom=t,this._tapZoom=e;};lr.prototype.enable=function(){this._clickZoom.enable(),this._tapZoom.enable();},lr.prototype.disable=function(){this._clickZoom.disable(),this._tapZoom.disable();},lr.prototype.isEnabled=function(){return this._clickZoom.isEnabled()&&this._tapZoom.isEnabled()},lr.prototype.isActive=function(){return this._clickZoom.isActive()||this._tapZoom.isActive()};var cr=function(){this.reset();};cr.prototype.reset=function(){this._active=!1;},cr.prototype.blur=function(){this.reset();},cr.prototype.dblclick=function(t,e){return t.preventDefault(),{cameraAnimation:function(i){i.easeTo({duration:300,zoom:i.getZoom()+(t.shiftKey?-1:1),around:i.unproject(e)},{originalEvent:t});}}},cr.prototype.enable=function(){this._enabled=!0;},cr.prototype.disable=function(){this._enabled=!1,this.reset();},cr.prototype.isEnabled=function(){return this._enabled},cr.prototype.isActive=function(){return this._active};var ur=function(){this._tap=new qo({numTouches:1,numTaps:1}),this.reset();};ur.prototype.reset=function(){this._active=!1,delete this._swipePoint,delete this._swipeTouch,delete this._tapTime,this._tap.reset();},ur.prototype.touchstart=function(t,e,i){this._swipePoint||(this._tapTime&&t.timeStamp-this._tapTime>500&&this.reset(),this._tapTime?i.length>0&&(this._swipePoint=e[0],this._swipeTouch=i[0].identifier):this._tap.touchstart(t,e,i));},ur.prototype.touchmove=function(t,e,i){if(this._tapTime){if(this._swipePoint){if(i[0].identifier!==this._swipeTouch)return;var o=e[0],r=o.y-this._swipePoint.y;return this._swipePoint=o,t.preventDefault(),this._active=!0,{zoomDelta:r/128}}}else this._tap.touchmove(t,e,i);},ur.prototype.touchend=function(t,e,i){this._tapTime?this._swipePoint&&0===i.length&&this.reset():this._tap.touchend(t,e,i)&&(this._tapTime=t.timeStamp);},ur.prototype.touchcancel=function(){this.reset();},ur.prototype.enable=function(){this._enabled=!0;},ur.prototype.disable=function(){this._enabled=!1,this.reset();},ur.prototype.isEnabled=function(){return this._enabled},ur.prototype.isActive=function(){return this._active};var hr=function(t,e,i){this._el=t,this._mousePan=e,this._touchPan=i;};hr.prototype.enable=function(t){this._inertiaOptions=t||{},this._mousePan.enable(),this._touchPan.enable(),this._el.classList.add(\"mapboxgl-touch-drag-pan\");},hr.prototype.disable=function(){this._mousePan.disable(),this._touchPan.disable(),this._el.classList.remove(\"mapboxgl-touch-drag-pan\");},hr.prototype.isEnabled=function(){return this._mousePan.isEnabled()&&this._touchPan.isEnabled()},hr.prototype.isActive=function(){return this._mousePan.isActive()||this._touchPan.isActive()};var pr=function(t,e,i){this._pitchWithRotate=t.pitchWithRotate,this._mouseRotate=e,this._mousePitch=i;};pr.prototype.enable=function(){this._mouseRotate.enable(),this._pitchWithRotate&&this._mousePitch.enable();},pr.prototype.disable=function(){this._mouseRotate.disable(),this._mousePitch.disable();},pr.prototype.isEnabled=function(){return this._mouseRotate.isEnabled()&&(!this._pitchWithRotate||this._mousePitch.isEnabled())},pr.prototype.isActive=function(){return this._mouseRotate.isActive()||this._mousePitch.isActive()};var dr=function(t,e,i,o){this._el=t,this._touchZoom=e,this._touchRotate=i,this._tapDragZoom=o,this._rotationDisabled=!1,this._enabled=!0;};dr.prototype.enable=function(t){this._touchZoom.enable(t),this._rotationDisabled||this._touchRotate.enable(t),this._tapDragZoom.enable(),this._el.classList.add(\"mapboxgl-touch-zoom-rotate\");},dr.prototype.disable=function(){this._touchZoom.disable(),this._touchRotate.disable(),this._tapDragZoom.disable(),this._el.classList.remove(\"mapboxgl-touch-zoom-rotate\");},dr.prototype.isEnabled=function(){return this._touchZoom.isEnabled()&&(this._rotationDisabled||this._touchRotate.isEnabled())&&this._tapDragZoom.isEnabled()},dr.prototype.isActive=function(){return this._touchZoom.isActive()||this._touchRotate.isActive()||this._tapDragZoom.isActive()},dr.prototype.disableRotation=function(){this._rotationDisabled=!0,this._touchRotate.disable();},dr.prototype.enableRotation=function(){this._rotationDisabled=!1,this._touchZoom.isEnabled()&&this._touchRotate.enable();};var _r=function(t){return t.zoom||t.drag||t.pitch||t.rotate},fr=function(t){function e(){t.apply(this,arguments);}return t&&(e.__proto__=t),(e.prototype=Object.create(t&&t.prototype)).constructor=e,e}(t.Event);function mr(t){return t.panDelta&&t.panDelta.mag()||t.zoomDelta||t.bearingDelta||t.pitchDelta}var gr=function(e,o){this._map=e,this._el=this._map.getCanvasContainer(),this._handlers=[],this._handlersById={},this._changes=[],this._inertia=new Ao(e),this._bearingSnap=o.bearingSnap,this._previousActiveHandlers={},this._eventsInProgress={},this._addDefaultHandlers(o),t.bindAll([\"handleEvent\",\"handleWindowEvent\"],this);var r=this._el;this._listeners=[[r,\"touchstart\",{passive:!0}],[r,\"touchmove\",{passive:!1}],[r,\"touchend\",void 0],[r,\"touchcancel\",void 0],[r,\"mousedown\",void 0],[r,\"mousemove\",void 0],[r,\"mouseup\",void 0],[t.window.document,\"mousemove\",{capture:!0}],[t.window.document,\"mouseup\",void 0],[r,\"mouseover\",void 0],[r,\"mouseout\",void 0],[r,\"dblclick\",void 0],[r,\"click\",void 0],[r,\"keydown\",{capture:!1}],[r,\"keyup\",void 0],[r,\"wheel\",{passive:!1}],[r,\"contextmenu\",void 0],[t.window,\"blur\",void 0]];for(var a=0,n=this._listeners;a<n.length;a+=1){var s=n[a],l=s[0];i.addEventListener(l,s[1],l===t.window.document?this.handleWindowEvent:this.handleEvent,s[2]);}};gr.prototype.destroy=function(){for(var e=0,o=this._listeners;e<o.length;e+=1){var r=o[e],a=r[0];i.removeEventListener(a,r[1],a===t.window.document?this.handleWindowEvent:this.handleEvent,r[2]);}},gr.prototype._addDefaultHandlers=function(t){var e=this._map,i=e.getCanvasContainer();this._add(\"mapEvent\",new Oo(e,t));var o=e.boxZoom=new Uo(e,t);this._add(\"boxZoom\",o);var r=new jo,a=new cr;e.doubleClickZoom=new lr(a,r),this._add(\"tapZoom\",r),this._add(\"clickZoom\",a);var n=new ur;this._add(\"tapDragZoom\",n);var s=e.touchPitch=new or;this._add(\"touchPitch\",s);var l=new Xo(t),c=new Ho(t);e.dragRotate=new pr(t,l,c),this._add(\"mouseRotate\",l,[\"mousePitch\"]),this._add(\"mousePitch\",c,[\"mouseRotate\"]);var u=new Wo(t),h=new Ko(t);e.dragPan=new hr(i,u,h),this._add(\"mousePan\",u),this._add(\"touchPan\",h,[\"touchZoom\",\"touchRotate\"]);var p=new er,d=new $o;e.touchZoomRotate=new dr(i,d,p,n),this._add(\"touchRotate\",p,[\"touchPan\",\"touchZoom\"]),this._add(\"touchZoom\",d,[\"touchPan\",\"touchRotate\"]);var _=e.scrollZoom=new sr(e,this);this._add(\"scrollZoom\",_,[\"mousePan\"]);var f=e.keyboard=new ar;this._add(\"keyboard\",f),this._add(\"blockableMapEvent\",new Fo(e));for(var m=0,g=[\"boxZoom\",\"doubleClickZoom\",\"tapDragZoom\",\"touchPitch\",\"dragRotate\",\"dragPan\",\"touchZoomRotate\",\"scrollZoom\",\"keyboard\"];m<g.length;m+=1){var v=g[m];t.interactive&&t[v]&&e[v].enable(t[v]);}},gr.prototype._add=function(t,e,i){this._handlers.push({handlerName:t,handler:e,allowed:i}),this._handlersById[t]=e;},gr.prototype.stop=function(t){if(!this._updatingCamera){for(var e=0,i=this._handlers;e<i.length;e+=1)i[e].handler.reset();this._inertia.clear(),this._fireEvents({},{},t),this._changes=[];}},gr.prototype.isActive=function(){for(var t=0,e=this._handlers;t<e.length;t+=1)if(e[t].handler.isActive())return !0;return !1},gr.prototype.isZooming=function(){return !!this._eventsInProgress.zoom||this._map.scrollZoom.isZooming()},gr.prototype.isRotating=function(){return !!this._eventsInProgress.rotate},gr.prototype.isMoving=function(){return Boolean(_r(this._eventsInProgress))||this.isZooming()},gr.prototype._blockedByActive=function(t,e,i){for(var o in t)if(o!==i&&(!e||e.indexOf(o)<0))return !0;return !1},gr.prototype.handleWindowEvent=function(t){this.handleEvent(t,t.type+\"Window\");},gr.prototype._getMapTouches=function(t){for(var e=[],i=0,o=t;i<o.length;i+=1){var r=o[i];this._el.contains(r.target)&&e.push(r);}return e},gr.prototype.handleEvent=function(t,e){this._updatingCamera=!0;for(var o=\"renderFrame\"===t.type?void 0:t,r={needsRenderFrame:!1},a={},n={},s=t.touches?this._getMapTouches(t.touches):void 0,l=s?i.touchPos(this._el,s):i.mousePos(this._el,t),c=0,u=this._handlers;c<u.length;c+=1){var h=u[c],p=h.handlerName,d=h.handler,_=h.allowed;if(d.isEnabled()){var f=void 0;this._blockedByActive(n,_,p)?d.reset():d[e||t.type]&&(f=d[e||t.type](t,l,s),this.mergeHandlerResult(r,a,f,p,o),f&&f.needsRenderFrame&&this._triggerRenderFrame()),(f||d.isActive())&&(n[p]=d);}}var m={};for(var g in this._previousActiveHandlers)n[g]||(m[g]=o);this._previousActiveHandlers=n,(Object.keys(m).length||mr(r))&&(this._changes.push([r,a,m]),this._triggerRenderFrame()),(Object.keys(n).length||mr(r))&&this._map._stop(!0),this._updatingCamera=!1;var v=r.cameraAnimation;v&&(this._inertia.clear(),this._fireEvents({},{},!0),this._changes=[],v(this._map));},gr.prototype.mergeHandlerResult=function(e,i,o,r,a){if(o){t.extend(e,o);var n={handlerName:r,originalEvent:o.originalEvent||a};void 0!==o.zoomDelta&&(i.zoom=n),void 0!==o.panDelta&&(i.drag=n),void 0!==o.pitchDelta&&(i.pitch=n),void 0!==o.bearingDelta&&(i.rotate=n);}},gr.prototype._applyChanges=function(){for(var e={},i={},o={},r=0,a=this._changes;r<a.length;r+=1){var n=a[r],s=n[0],l=n[1],c=n[2];s.panDelta&&(e.panDelta=(e.panDelta||new t.Point(0,0))._add(s.panDelta)),s.zoomDelta&&(e.zoomDelta=(e.zoomDelta||0)+s.zoomDelta),s.bearingDelta&&(e.bearingDelta=(e.bearingDelta||0)+s.bearingDelta),s.pitchDelta&&(e.pitchDelta=(e.pitchDelta||0)+s.pitchDelta),void 0!==s.around&&(e.around=s.around),void 0!==s.pinchAround&&(e.pinchAround=s.pinchAround),s.noInertia&&(e.noInertia=s.noInertia),t.extend(i,l),t.extend(o,c);}this._updateMapTransform(e,i,o),this._changes=[];},gr.prototype._updateMapTransform=function(t,e,i){var o=this._map,r=o.transform;if(!mr(t))return this._fireEvents(e,i,!0);var a=t.panDelta,n=t.zoomDelta,s=t.bearingDelta,l=t.pitchDelta,c=t.around,u=t.pinchAround;void 0!==u&&(c=u),o._stop(!0),c=c||o.transform.centerPoint;var h=r.pointLocation(a?c.sub(a):c);s&&(r.bearing+=s),l&&(r.pitch+=l),n&&(r.zoom+=n),r.setLocationAtPoint(h,c),this._map._update(),t.noInertia||this._inertia.record(t),this._fireEvents(e,i,!0);},gr.prototype._fireEvents=function(e,i,o){var r=this,a=_r(this._eventsInProgress),n=_r(e),s={};for(var l in e)this._eventsInProgress[l]||(s[l+\"start\"]=e[l].originalEvent),this._eventsInProgress[l]=e[l];for(var c in !a&&n&&this._fireEvent(\"movestart\",n.originalEvent),s)this._fireEvent(c,s[c]);for(var u in n&&this._fireEvent(\"move\",n.originalEvent),e)this._fireEvent(u,e[u].originalEvent);var h,p={};for(var d in this._eventsInProgress){var _=this._eventsInProgress[d],f=_.handlerName,m=_.originalEvent;this._handlersById[f].isActive()||(delete this._eventsInProgress[d],p[d+\"end\"]=h=i[f]||m);}for(var g in p)this._fireEvent(g,p[g]);var v=_r(this._eventsInProgress);if(o&&(a||n)&&!v){this._updatingCamera=!0;var y=this._inertia._onMoveEnd(this._map.dragPan._inertiaOptions),x=function(t){return 0!==t&&-r._bearingSnap<t&&t<r._bearingSnap};y?(x(y.bearing||this._map.getBearing())&&(y.bearing=0),this._map.easeTo(y,{originalEvent:h})):(this._map.fire(new t.Event(\"moveend\",{originalEvent:h})),x(this._map.getBearing())&&this._map.resetNorth()),this._updatingCamera=!1;}},gr.prototype._fireEvent=function(e,i){this._map.fire(new t.Event(e,i?{originalEvent:i}:{}));},gr.prototype._requestFrame=function(){var t=this;return this._map.triggerRepaint(),this._map._renderTaskQueue.add((function(e){delete t._frameId,t.handleEvent(new fr(\"renderFrame\",{timeStamp:e})),t._applyChanges();}))},gr.prototype._triggerRenderFrame=function(){void 0===this._frameId&&(this._frameId=this._requestFrame());};var vr=function(e){function i(i,o){e.call(this),this._moving=!1,this._zooming=!1,this.transform=i,this._bearingSnap=o.bearingSnap,t.bindAll([\"_renderFrameCallback\"],this);}return e&&(i.__proto__=e),(i.prototype=Object.create(e&&e.prototype)).constructor=i,i.prototype.getCenter=function(){return new t.LngLat(this.transform.center.lng,this.transform.center.lat)},i.prototype.setCenter=function(t,e){return this.jumpTo({center:t},e)},i.prototype.panBy=function(e,i,o){return e=t.Point.convert(e).mult(-1),this.panTo(this.transform.center,t.extend({offset:e},i),o)},i.prototype.panTo=function(e,i,o){return this.easeTo(t.extend({center:e},i),o)},i.prototype.getZoom=function(){return this.transform.zoom},i.prototype.setZoom=function(t,e){return this.jumpTo({zoom:t},e),this},i.prototype.zoomTo=function(e,i,o){return this.easeTo(t.extend({zoom:e},i),o)},i.prototype.zoomIn=function(t,e){return this.zoomTo(this.getZoom()+1,t,e),this},i.prototype.zoomOut=function(t,e){return this.zoomTo(this.getZoom()-1,t,e),this},i.prototype.getBearing=function(){return this.transform.bearing},i.prototype.setBearing=function(t,e){return this.jumpTo({bearing:t},e),this},i.prototype.getPadding=function(){return this.transform.padding},i.prototype.setPadding=function(t,e){return this.jumpTo({padding:t},e),this},i.prototype.rotateTo=function(e,i,o){return this.easeTo(t.extend({bearing:e},i),o)},i.prototype.resetNorth=function(e,i){return this.rotateTo(0,t.extend({duration:1e3},e),i),this},i.prototype.resetNorthPitch=function(e,i){return this.easeTo(t.extend({bearing:0,pitch:0,duration:1e3},e),i),this},i.prototype.snapToNorth=function(t,e){return Math.abs(this.getBearing())<this._bearingSnap?this.resetNorth(t,e):this},i.prototype.getPitch=function(){return this.transform.pitch},i.prototype.setPitch=function(t,e){return this.jumpTo({pitch:t},e),this},i.prototype.cameraForBounds=function(e,i){e=t.LngLatBounds.convert(e);var o=i&&i.bearing||0;return this._cameraForBoxAndBearing(e.getNorthWest(),e.getSouthEast(),o,i)},i.prototype._cameraForBoxAndBearing=function(e,i,o,r){var a={top:0,bottom:0,right:0,left:0};if(\"number\"==typeof(r=t.extend({padding:a,offset:[0,0],maxZoom:this.transform.maxZoom},r)).padding){var n=r.padding;r.padding={top:n,bottom:n,right:n,left:n};}r.padding=t.extend(a,r.padding);var s=this.transform,l=s.padding,c=s.project(t.LngLat.convert(e)),u=s.project(t.LngLat.convert(i)),h=c.rotate(-o*Math.PI/180),p=u.rotate(-o*Math.PI/180),d=new t.Point(Math.max(h.x,p.x),Math.max(h.y,p.y)),_=new t.Point(Math.min(h.x,p.x),Math.min(h.y,p.y)),f=d.sub(_),m=(s.width-(l.left+l.right+r.padding.left+r.padding.right))/f.x,g=(s.height-(l.top+l.bottom+r.padding.top+r.padding.bottom))/f.y;if(!(g<0||m<0)){var v=Math.min(s.scaleZoom(s.scale*Math.min(m,g)),r.maxZoom),y=\"number\"==typeof r.offset.x?new t.Point(r.offset.x,r.offset.y):t.Point.convert(r.offset),x=new t.Point((r.padding.left-r.padding.right)/2,(r.padding.top-r.padding.bottom)/2).rotate(o*Math.PI/180),b=y.add(x).mult(s.scale/s.zoomScale(v));return {center:s.unproject(c.add(u).div(2).sub(b)),zoom:v,bearing:o}}t.warnOnce(\"Map cannot fit within canvas with the given bounds, padding, and/or offset.\");},i.prototype.fitBounds=function(t,e,i){return this._fitInternal(this.cameraForBounds(t,e),e,i)},i.prototype.fitScreenCoordinates=function(e,i,o,r,a){return this._fitInternal(this._cameraForBoxAndBearing(this.transform.pointLocation(t.Point.convert(e)),this.transform.pointLocation(t.Point.convert(i)),o,r),r,a)},i.prototype._fitInternal=function(e,i,o){return e?(delete(i=t.extend(e,i)).padding,i.linear?this.easeTo(i,o):this.flyTo(i,o)):this},i.prototype.jumpTo=function(e,i){this.stop();var o=this.transform,r=!1,a=!1,n=!1;return \"zoom\"in e&&o.zoom!==+e.zoom&&(r=!0,o.zoom=+e.zoom),void 0!==e.center&&(o.center=t.LngLat.convert(e.center)),\"bearing\"in e&&o.bearing!==+e.bearing&&(a=!0,o.bearing=+e.bearing),\"pitch\"in e&&o.pitch!==+e.pitch&&(n=!0,o.pitch=+e.pitch),null==e.padding||o.isPaddingEqual(e.padding)||(o.padding=e.padding),this.fire(new t.Event(\"movestart\",i)).fire(new t.Event(\"move\",i)),r&&this.fire(new t.Event(\"zoomstart\",i)).fire(new t.Event(\"zoom\",i)).fire(new t.Event(\"zoomend\",i)),a&&this.fire(new t.Event(\"rotatestart\",i)).fire(new t.Event(\"rotate\",i)).fire(new t.Event(\"rotateend\",i)),n&&this.fire(new t.Event(\"pitchstart\",i)).fire(new t.Event(\"pitch\",i)).fire(new t.Event(\"pitchend\",i)),this.fire(new t.Event(\"moveend\",i))},i.prototype.easeTo=function(e,i){var o=this;this._stop(!1,e.easeId),(!1===(e=t.extend({offset:[0,0],duration:500,easing:t.ease},e)).animate||!e.essential&&t.browser.prefersReducedMotion)&&(e.duration=0);var r=this.transform,a=this.getZoom(),n=this.getBearing(),s=this.getPitch(),l=this.getPadding(),c=\"zoom\"in e?+e.zoom:a,u=\"bearing\"in e?this._normalizeBearing(e.bearing,n):n,h=\"pitch\"in e?+e.pitch:s,p=\"padding\"in e?e.padding:r.padding,d=t.Point.convert(e.offset),_=r.centerPoint.add(d),f=r.pointLocation(_),m=t.LngLat.convert(e.center||f);this._normalizeCenter(m);var g,v,y=r.project(f),x=r.project(m).sub(y),b=r.zoomScale(c-a);e.around&&(g=t.LngLat.convert(e.around),v=r.locationPoint(g));var w={moving:this._moving,zooming:this._zooming,rotating:this._rotating,pitching:this._pitching};return this._zooming=this._zooming||c!==a,this._rotating=this._rotating||n!==u,this._pitching=this._pitching||h!==s,this._padding=!r.isPaddingEqual(p),this._easeId=e.easeId,this._prepareEase(i,e.noMoveStart,w),this._ease((function(e){if(o._zooming&&(r.zoom=t.number(a,c,e)),o._rotating&&(r.bearing=t.number(n,u,e)),o._pitching&&(r.pitch=t.number(s,h,e)),o._padding&&(r.interpolatePadding(l,p,e),_=r.centerPoint.add(d)),g)r.setLocationAtPoint(g,v);else {var f=r.zoomScale(r.zoom-a),m=c>a?Math.min(2,b):Math.max(.5,b),w=Math.pow(m,1-e),T=r.unproject(y.add(x.mult(e*w)).mult(f));r.setLocationAtPoint(r.renderWorldCopies?T.wrap():T,_);}o._fireMoveEvents(i);}),(function(t){o._afterEase(i,t);}),e),this},i.prototype._prepareEase=function(e,i,o){void 0===o&&(o={}),this._moving=!0,i||o.moving||this.fire(new t.Event(\"movestart\",e)),this._zooming&&!o.zooming&&this.fire(new t.Event(\"zoomstart\",e)),this._rotating&&!o.rotating&&this.fire(new t.Event(\"rotatestart\",e)),this._pitching&&!o.pitching&&this.fire(new t.Event(\"pitchstart\",e));},i.prototype._fireMoveEvents=function(e){this.fire(new t.Event(\"move\",e)),this._zooming&&this.fire(new t.Event(\"zoom\",e)),this._rotating&&this.fire(new t.Event(\"rotate\",e)),this._pitching&&this.fire(new t.Event(\"pitch\",e));},i.prototype._afterEase=function(e,i){if(!this._easeId||!i||this._easeId!==i){delete this._easeId;var o=this._zooming,r=this._rotating,a=this._pitching;this._moving=!1,this._zooming=!1,this._rotating=!1,this._pitching=!1,this._padding=!1,o&&this.fire(new t.Event(\"zoomend\",e)),r&&this.fire(new t.Event(\"rotateend\",e)),a&&this.fire(new t.Event(\"pitchend\",e)),this.fire(new t.Event(\"moveend\",e));}},i.prototype.flyTo=function(e,i){var o=this;if(!e.essential&&t.browser.prefersReducedMotion){var r=t.pick(e,[\"center\",\"zoom\",\"bearing\",\"pitch\",\"around\"]);return this.jumpTo(r,i)}this.stop(),e=t.extend({offset:[0,0],speed:1.2,curve:1.42,easing:t.ease},e);var a=this.transform,n=this.getZoom(),s=this.getBearing(),l=this.getPitch(),c=this.getPadding(),u=\"zoom\"in e?t.clamp(+e.zoom,a.minZoom,a.maxZoom):n,h=\"bearing\"in e?this._normalizeBearing(e.bearing,s):s,p=\"pitch\"in e?+e.pitch:l,d=\"padding\"in e?e.padding:a.padding,_=a.zoomScale(u-n),f=t.Point.convert(e.offset),m=a.centerPoint.add(f),g=a.pointLocation(m),v=t.LngLat.convert(e.center||g);this._normalizeCenter(v);var y=a.project(g),x=a.project(v).sub(y),b=e.curve,w=Math.max(a.width,a.height),T=w/_,E=x.mag();if(\"minZoom\"in e){var I=t.clamp(Math.min(e.minZoom,n,u),a.minZoom,a.maxZoom),P=w/a.zoomScale(I-n);b=Math.sqrt(P/E*2);}var S=b*b;function C(t){var e=(T*T-w*w+(t?-1:1)*S*S*E*E)/(2*(t?T:w)*S*E);return Math.log(Math.sqrt(e*e+1)-e)}function z(t){return (Math.exp(t)-Math.exp(-t))/2}function D(t){return (Math.exp(t)+Math.exp(-t))/2}var A=C(0),M=function(t){return D(A)/D(A+b*t)},L=function(t){return w*((D(A)*(z(e=A+b*t)/D(e))-z(A))/S)/E;var e;},R=(C(1)-A)/b;if(Math.abs(E)<1e-6||!isFinite(R)){if(Math.abs(w-T)<1e-6)return this.easeTo(e,i);var k=T<w?-1:1;R=Math.abs(Math.log(T/w))/b,L=function(){return 0},M=function(t){return Math.exp(k*b*t)};}return e.duration=\"duration\"in e?+e.duration:1e3*R/(\"screenSpeed\"in e?+e.screenSpeed/b:+e.speed),e.maxDuration&&e.duration>e.maxDuration&&(e.duration=0),this._zooming=!0,this._rotating=s!==h,this._pitching=p!==l,this._padding=!a.isPaddingEqual(d),this._prepareEase(i,!1),this._ease((function(e){var r=e*R,_=1/M(r);a.zoom=1===e?u:n+a.scaleZoom(_),o._rotating&&(a.bearing=t.number(s,h,e)),o._pitching&&(a.pitch=t.number(l,p,e)),o._padding&&(a.interpolatePadding(c,d,e),m=a.centerPoint.add(f));var g=1===e?v:a.unproject(y.add(x.mult(L(r))).mult(_));a.setLocationAtPoint(a.renderWorldCopies?g.wrap():g,m),o._fireMoveEvents(i);}),(function(){return o._afterEase(i)}),e),this},i.prototype.isEasing=function(){return !!this._easeFrameId},i.prototype.stop=function(){return this._stop()},i.prototype._stop=function(t,e){if(this._easeFrameId&&(this._cancelRenderFrame(this._easeFrameId),delete this._easeFrameId,delete this._onEaseFrame),this._onEaseEnd){var i=this._onEaseEnd;delete this._onEaseEnd,i.call(this,e);}if(!t){var o=this.handlers;o&&o.stop(!1);}return this},i.prototype._ease=function(e,i,o){!1===o.animate||0===o.duration?(e(1),i()):(this._easeStart=t.browser.now(),this._easeOptions=o,this._onEaseFrame=e,this._onEaseEnd=i,this._easeFrameId=this._requestRenderFrame(this._renderFrameCallback));},i.prototype._renderFrameCallback=function(){var e=Math.min((t.browser.now()-this._easeStart)/this._easeOptions.duration,1);this._onEaseFrame(this._easeOptions.easing(e)),e<1?this._easeFrameId=this._requestRenderFrame(this._renderFrameCallback):this.stop();},i.prototype._normalizeBearing=function(e,i){e=t.wrap(e,-180,180);var o=Math.abs(e-i);return Math.abs(e-360-i)<o&&(e-=360),Math.abs(e+360-i)<o&&(e+=360),e},i.prototype._normalizeCenter=function(t){var e=this.transform;if(e.renderWorldCopies&&!e.lngRange){var i=t.lng-e.center.lng;t.lng+=i>180?-360:i<-180?360:0;}},i}(t.Evented),yr=function(e){void 0===e&&(e={}),this.options=e,t.bindAll([\"_toggleAttribution\",\"_updateEditLink\",\"_updateData\",\"_updateCompact\"],this);};yr.prototype.getDefaultPosition=function(){return \"bottom-right\"},yr.prototype.onAdd=function(t){var e=this.options&&this.options.compact;return this._map=t,this._container=i.create(\"div\",\"mapboxgl-ctrl mapboxgl-ctrl-attrib\"),this._compactButton=i.create(\"button\",\"mapboxgl-ctrl-attrib-button\",this._container),this._compactButton.addEventListener(\"click\",this._toggleAttribution),this._setElementTitle(this._compactButton,\"ToggleAttribution\"),this._innerContainer=i.create(\"div\",\"mapboxgl-ctrl-attrib-inner\",this._container),this._innerContainer.setAttribute(\"role\",\"list\"),e&&this._container.classList.add(\"mapboxgl-compact\"),this._updateAttributions(),this._updateEditLink(),this._map.on(\"styledata\",this._updateData),this._map.on(\"sourcedata\",this._updateData),this._map.on(\"moveend\",this._updateEditLink),void 0===e&&(this._map.on(\"resize\",this._updateCompact),this._updateCompact()),this._container},yr.prototype.onRemove=function(){i.remove(this._container),this._map.off(\"styledata\",this._updateData),this._map.off(\"sourcedata\",this._updateData),this._map.off(\"moveend\",this._updateEditLink),this._map.off(\"resize\",this._updateCompact),this._map=void 0,this._attribHTML=void 0;},yr.prototype._setElementTitle=function(t,e){var i=this._map._getUIString(\"AttributionControl.\"+e);t.title=i,t.setAttribute(\"aria-label\",i);},yr.prototype._toggleAttribution=function(){this._container.classList.contains(\"mapboxgl-compact-show\")?(this._container.classList.remove(\"mapboxgl-compact-show\"),this._compactButton.setAttribute(\"aria-pressed\",\"false\")):(this._container.classList.add(\"mapboxgl-compact-show\"),this._compactButton.setAttribute(\"aria-pressed\",\"true\"));},yr.prototype._updateEditLink=function(){var e=this._editLink;e||(e=this._editLink=this._container.querySelector(\".mapbox-improve-map\"));var i=[{key:\"owner\",value:this.styleOwner},{key:\"id\",value:this.styleId},{key:\"access_token\",value:this._map._requestManager._customAccessToken||t.config.ACCESS_TOKEN}];if(e){var o=i.reduce((function(t,e,o){return e.value&&(t+=e.key+\"=\"+e.value+(o<i.length-1?\"&\":\"\")),t}),\"?\");e.href=t.config.FEEDBACK_URL+\"/\"+o+(this._map._hash?this._map._hash.getHashString(!0):\"\"),e.rel=\"noopener nofollow\",this._setElementTitle(e,\"MapFeedback\");}},yr.prototype._updateData=function(t){!t||\"metadata\"!==t.sourceDataType&&\"visibility\"!==t.sourceDataType&&\"style\"!==t.dataType||(this._updateAttributions(),this._updateEditLink());},yr.prototype._updateAttributions=function(){if(this._map.style){var t=[];if(this.options.customAttribution&&(Array.isArray(this.options.customAttribution)?t=t.concat(this.options.customAttribution.map((function(t){return \"string\"!=typeof t?\"\":t}))):\"string\"==typeof this.options.customAttribution&&t.push(this.options.customAttribution)),this._map.style.stylesheet){var e=this._map.style.stylesheet;this.styleOwner=e.owner,this.styleId=e.id;}var i=this._map.style.sourceCaches;for(var o in i){var r=i[o];if(r.used){var a=r.getSource();a.attribution&&t.indexOf(a.attribution)<0&&t.push(a.attribution);}}t.sort((function(t,e){return t.length-e.length}));var n=(t=t.filter((function(e,i){for(var o=i+1;o<t.length;o++)if(t[o].indexOf(e)>=0)return !1;return !0}))).join(\" | \");n!==this._attribHTML&&(this._attribHTML=n,t.length?(this._innerContainer.innerHTML=n,this._container.classList.remove(\"mapboxgl-attrib-empty\")):this._container.classList.add(\"mapboxgl-attrib-empty\"),this._editLink=null);}},yr.prototype._updateCompact=function(){this._map.getCanvasContainer().offsetWidth<=640?this._container.classList.add(\"mapboxgl-compact\"):this._container.classList.remove(\"mapboxgl-compact\",\"mapboxgl-compact-show\");};var xr=function(){t.bindAll([\"_updateLogo\"],this),t.bindAll([\"_updateCompact\"],this);};xr.prototype.onAdd=function(t){this._map=t,this._container=i.create(\"div\",\"mapboxgl-ctrl\");var e=i.create(\"a\",\"mapboxgl-ctrl-logo\");return e.target=\"_blank\",e.rel=\"noopener nofollow\",e.href=\"https://www.mapbox.com/\",e.setAttribute(\"aria-label\",this._map._getUIString(\"LogoControl.Title\")),e.setAttribute(\"rel\",\"noopener nofollow\"),this._container.appendChild(e),this._container.style.display=\"none\",this._map.on(\"sourcedata\",this._updateLogo),this._updateLogo(),this._map.on(\"resize\",this._updateCompact),this._updateCompact(),this._container},xr.prototype.onRemove=function(){i.remove(this._container),this._map.off(\"sourcedata\",this._updateLogo),this._map.off(\"resize\",this._updateCompact);},xr.prototype.getDefaultPosition=function(){return \"bottom-left\"},xr.prototype._updateLogo=function(t){t&&\"metadata\"!==t.sourceDataType||(this._container.style.display=this._logoRequired()?\"block\":\"none\");},xr.prototype._logoRequired=function(){if(this._map.style){var t=this._map.style.sourceCaches;for(var e in t)if(t[e].getSource().mapbox_logo)return !0;return !1}},xr.prototype._updateCompact=function(){var t=this._container.children;if(t.length){var e=t[0];this._map.getCanvasContainer().offsetWidth<250?e.classList.add(\"mapboxgl-compact\"):e.classList.remove(\"mapboxgl-compact\");}};var br=function(){this._queue=[],this._id=0,this._cleared=!1,this._currentlyRunning=!1;};br.prototype.add=function(t){var e=++this._id;return this._queue.push({callback:t,id:e,cancelled:!1}),e},br.prototype.remove=function(t){for(var e=this._currentlyRunning,i=0,o=e?this._queue.concat(e):this._queue;i<o.length;i+=1){var r=o[i];if(r.id===t)return void(r.cancelled=!0)}},br.prototype.run=function(t){void 0===t&&(t=0);var e=this._currentlyRunning=this._queue;this._queue=[];for(var i=0,o=e;i<o.length;i+=1){var r=o[i];if(!r.cancelled&&(r.callback(t),this._cleared))break}this._cleared=!1,this._currentlyRunning=!1;},br.prototype.clear=function(){this._currentlyRunning&&(this._cleared=!0),this._queue=[];};var wr={\"AttributionControl.ToggleAttribution\":\"Toggle attribution\",\"AttributionControl.MapFeedback\":\"Map feedback\",\"FullscreenControl.Enter\":\"Enter fullscreen\",\"FullscreenControl.Exit\":\"Exit fullscreen\",\"GeolocateControl.FindMyLocation\":\"Find my location\",\"GeolocateControl.LocationNotAvailable\":\"Location not available\",\"LogoControl.Title\":\"Mapbox logo\",\"NavigationControl.ResetBearing\":\"Reset bearing to north\",\"NavigationControl.ZoomIn\":\"Zoom in\",\"NavigationControl.ZoomOut\":\"Zoom out\",\"ScaleControl.Feet\":\"ft\",\"ScaleControl.Meters\":\"m\",\"ScaleControl.Kilometers\":\"km\",\"ScaleControl.Miles\":\"mi\",\"ScaleControl.NauticalMiles\":\"nm\"},Tr=t.window.HTMLImageElement,Er=t.window.HTMLElement,Ir=t.window.ImageBitmap,Pr={center:[0,0],zoom:0,bearing:0,pitch:0,minZoom:-2,maxZoom:22,minPitch:0,maxPitch:60,interactive:!0,scrollZoom:!0,boxZoom:!0,dragRotate:!0,dragPan:!0,keyboard:!0,doubleClickZoom:!0,touchZoomRotate:!0,touchPitch:!0,bearingSnap:7,clickTolerance:3,pitchWithRotate:!0,hash:!1,attributionControl:!0,failIfMajorPerformanceCaveat:!1,preserveDrawingBuffer:!1,trackResize:!0,renderWorldCopies:!0,refreshExpiredTiles:!0,maxTileCacheSize:null,localIdeographFontFamily:\"sans-serif\",transformRequest:null,accessToken:null,fadeDuration:300,crossSourceCollisions:!0},Sr=function(o){function r(e){var i=this;if(null!=(e=t.extend({},Pr,e)).minZoom&&null!=e.maxZoom&&e.minZoom>e.maxZoom)throw new Error(\"maxZoom must be greater than or equal to minZoom\");if(null!=e.minPitch&&null!=e.maxPitch&&e.minPitch>e.maxPitch)throw new Error(\"maxPitch must be greater than or equal to minPitch\");if(null!=e.minPitch&&e.minPitch<0)throw new Error(\"minPitch must be greater than or equal to 0\");if(null!=e.maxPitch&&e.maxPitch>60)throw new Error(\"maxPitch must be less than or equal to 60\");var r=new To(e.minZoom,e.maxZoom,e.minPitch,e.maxPitch,e.renderWorldCopies);if(o.call(this,r,e),this._interactive=e.interactive,this._maxTileCacheSize=e.maxTileCacheSize,this._failIfMajorPerformanceCaveat=e.failIfMajorPerformanceCaveat,this._preserveDrawingBuffer=e.preserveDrawingBuffer,this._antialias=e.antialias,this._trackResize=e.trackResize,this._bearingSnap=e.bearingSnap,this._refreshExpiredTiles=e.refreshExpiredTiles,this._fadeDuration=e.fadeDuration,this._crossSourceCollisions=e.crossSourceCollisions,this._crossFadingFactor=1,this._collectResourceTiming=e.collectResourceTiming,this._renderTaskQueue=new br,this._controls=[],this._mapId=t.uniqueId(),this._locale=t.extend({},wr,e.locale),this._clickTolerance=e.clickTolerance,this._requestManager=new t.RequestManager(e.transformRequest,e.accessToken),\"string\"==typeof e.container){if(this._container=t.window.document.getElementById(e.container),!this._container)throw new Error(\"Container '\"+e.container+\"' not found.\")}else {if(!(e.container instanceof Er))throw new Error(\"Invalid type: 'container' must be a String or HTMLElement.\");this._container=e.container;}if(e.maxBounds&&this.setMaxBounds(e.maxBounds),t.bindAll([\"_onWindowOnline\",\"_onWindowResize\",\"_onMapScroll\",\"_contextLost\",\"_contextRestored\"],this),this._setupContainer(),this._setupPainter(),void 0===this.painter)throw new Error(\"Failed to initialize WebGL.\");this.on(\"move\",(function(){return i._update(!1)})),this.on(\"moveend\",(function(){return i._update(!1)})),this.on(\"zoom\",(function(){return i._update(!0)})),void 0!==t.window&&(t.window.addEventListener(\"online\",this._onWindowOnline,!1),t.window.addEventListener(\"resize\",this._onWindowResize,!1),t.window.addEventListener(\"orientationchange\",this._onWindowResize,!1)),this.handlers=new gr(this,e),this._hash=e.hash&&new Io(\"string\"==typeof e.hash&&e.hash||void 0).addTo(this),this._hash&&this._hash._onHashChange()||(this.jumpTo({center:e.center,zoom:e.zoom,bearing:e.bearing,pitch:e.pitch}),e.bounds&&(this.resize(),this.fitBounds(e.bounds,t.extend({},e.fitBoundsOptions,{duration:0})))),this.resize(),this._localIdeographFontFamily=e.localIdeographFontFamily,e.style&&this.setStyle(e.style,{localIdeographFontFamily:e.localIdeographFontFamily}),e.attributionControl&&this.addControl(new yr({customAttribution:e.customAttribution})),this.addControl(new xr,e.logoPosition),this.on(\"style.load\",(function(){i.transform.unmodified&&i.jumpTo(i.style.stylesheet);})),this.on(\"data\",(function(e){i._update(\"style\"===e.dataType),i.fire(new t.Event(e.dataType+\"data\",e));})),this.on(\"dataloading\",(function(e){i.fire(new t.Event(e.dataType+\"dataloading\",e));}));}o&&(r.__proto__=o),(r.prototype=Object.create(o&&o.prototype)).constructor=r;var a={showTileBoundaries:{configurable:!0},showPadding:{configurable:!0},showCollisionBoxes:{configurable:!0},showOverdrawInspector:{configurable:!0},repaint:{configurable:!0},vertices:{configurable:!0},version:{configurable:!0}};return r.prototype._getMapId=function(){return this._mapId},r.prototype.addControl=function(e,i){if(void 0===i&&(i=e.getDefaultPosition?e.getDefaultPosition():\"top-right\"),!e||!e.onAdd)return this.fire(new t.ErrorEvent(new Error(\"Invalid argument to map.addControl(). Argument must be a control with onAdd and onRemove methods.\")));var o=e.onAdd(this);this._controls.push(e);var r=this._controlPositions[i];return -1!==i.indexOf(\"bottom\")?r.insertBefore(o,r.firstChild):r.appendChild(o),this},r.prototype.removeControl=function(e){if(!e||!e.onRemove)return this.fire(new t.ErrorEvent(new Error(\"Invalid argument to map.removeControl(). Argument must be a control with onAdd and onRemove methods.\")));var i=this._controls.indexOf(e);return i>-1&&this._controls.splice(i,1),e.onRemove(this),this},r.prototype.hasControl=function(t){return this._controls.indexOf(t)>-1},r.prototype.resize=function(e){var i=this._containerDimensions(),o=i[0],r=i[1];if(o===this.transform.width&&r===this.transform.height)return this;this._resizeCanvas(o,r),this.transform.resize(o,r),this.painter.resize(o,r);var a=!this._moving;return a&&this.fire(new t.Event(\"movestart\",e)).fire(new t.Event(\"move\",e)),this.fire(new t.Event(\"resize\",e)),a&&this.fire(new t.Event(\"moveend\",e)),this},r.prototype.getBounds=function(){return this.transform.getBounds()},r.prototype.getMaxBounds=function(){return this.transform.getMaxBounds()},r.prototype.setMaxBounds=function(e){return this.transform.setMaxBounds(t.LngLatBounds.convert(e)),this._update()},r.prototype.setMinZoom=function(t){if((t=null==t?-2:t)>=-2&&t<=this.transform.maxZoom)return this.transform.minZoom=t,this._update(),this.getZoom()<t&&this.setZoom(t),this;throw new Error(\"minZoom must be between -2 and the current maxZoom, inclusive\")},r.prototype.getMinZoom=function(){return this.transform.minZoom},r.prototype.setMaxZoom=function(t){if((t=null==t?22:t)>=this.transform.minZoom)return this.transform.maxZoom=t,this._update(),this.getZoom()>t&&this.setZoom(t),this;throw new Error(\"maxZoom must be greater than the current minZoom\")},r.prototype.getMaxZoom=function(){return this.transform.maxZoom},r.prototype.setMinPitch=function(t){if((t=null==t?0:t)<0)throw new Error(\"minPitch must be greater than or equal to 0\");if(t>=0&&t<=this.transform.maxPitch)return this.transform.minPitch=t,this._update(),this.getPitch()<t&&this.setPitch(t),this;throw new Error(\"minPitch must be between 0 and the current maxPitch, inclusive\")},r.prototype.getMinPitch=function(){return this.transform.minPitch},r.prototype.setMaxPitch=function(t){if((t=null==t?60:t)>60)throw new Error(\"maxPitch must be less than or equal to 60\");if(t>=this.transform.minPitch)return this.transform.maxPitch=t,this._update(),this.getPitch()>t&&this.setPitch(t),this;throw new Error(\"maxPitch must be greater than the current minPitch\")},r.prototype.getMaxPitch=function(){return this.transform.maxPitch},r.prototype.getRenderWorldCopies=function(){return this.transform.renderWorldCopies},r.prototype.setRenderWorldCopies=function(t){return this.transform.renderWorldCopies=t,this._update()},r.prototype.project=function(e){return this.transform.locationPoint(t.LngLat.convert(e))},r.prototype.unproject=function(e){return this.transform.pointLocation(t.Point.convert(e))},r.prototype.isMoving=function(){return this._moving||this.handlers.isMoving()},r.prototype.isZooming=function(){return this._zooming||this.handlers.isZooming()},r.prototype.isRotating=function(){return this._rotating||this.handlers.isRotating()},r.prototype._createDelegatedListener=function(t,e,i){var o,r=this;if(\"mouseenter\"===t||\"mouseover\"===t){var a=!1;return {layer:e,listener:i,delegates:{mousemove:function(o){var n=r.getLayer(e)?r.queryRenderedFeatures(o.point,{layers:[e]}):[];n.length?a||(a=!0,i.call(r,new Ro(t,r,o.originalEvent,{features:n}))):a=!1;},mouseout:function(){a=!1;}}}}if(\"mouseleave\"===t||\"mouseout\"===t){var n=!1;return {layer:e,listener:i,delegates:{mousemove:function(o){(r.getLayer(e)?r.queryRenderedFeatures(o.point,{layers:[e]}):[]).length?n=!0:n&&(n=!1,i.call(r,new Ro(t,r,o.originalEvent)));},mouseout:function(e){n&&(n=!1,i.call(r,new Ro(t,r,e.originalEvent)));}}}}return {layer:e,listener:i,delegates:(o={},o[t]=function(t){var o=r.getLayer(e)?r.queryRenderedFeatures(t.point,{layers:[e]}):[];o.length&&(t.features=o,i.call(r,t),delete t.features);},o)}},r.prototype.on=function(t,e,i){if(void 0===i)return o.prototype.on.call(this,t,e);var r=this._createDelegatedListener(t,e,i);for(var a in this._delegatedListeners=this._delegatedListeners||{},this._delegatedListeners[t]=this._delegatedListeners[t]||[],this._delegatedListeners[t].push(r),r.delegates)this.on(a,r.delegates[a]);return this},r.prototype.once=function(t,e,i){if(void 0===i)return o.prototype.once.call(this,t,e);var r=this._createDelegatedListener(t,e,i);for(var a in r.delegates)this.once(a,r.delegates[a]);return this},r.prototype.off=function(t,e,i){var r=this;return void 0===i?o.prototype.off.call(this,t,e):(this._delegatedListeners&&this._delegatedListeners[t]&&function(o){for(var a=o[t],n=0;n<a.length;n++){var s=a[n];if(s.layer===e&&s.listener===i){for(var l in s.delegates)r.off(l,s.delegates[l]);return a.splice(n,1),r}}}(this._delegatedListeners),this)},r.prototype.queryRenderedFeatures=function(e,i){if(!this.style)return [];var o;if(void 0!==i||void 0===e||e instanceof t.Point||Array.isArray(e)||(i=e,e=void 0),i=i||{},(e=e||[[0,0],[this.transform.width,this.transform.height]])instanceof t.Point||\"number\"==typeof e[0])o=[t.Point.convert(e)];else {var r=t.Point.convert(e[0]),a=t.Point.convert(e[1]);o=[r,new t.Point(a.x,r.y),a,new t.Point(r.x,a.y),r];}return this.style.queryRenderedFeatures(o,i,this.transform)},r.prototype.querySourceFeatures=function(t,e){return this.style.querySourceFeatures(t,e)},r.prototype.setStyle=function(e,i){return !1!==(i=t.extend({},{localIdeographFontFamily:this._localIdeographFontFamily},i)).diff&&i.localIdeographFontFamily===this._localIdeographFontFamily&&this.style&&e?(this._diffStyle(e,i),this):(this._localIdeographFontFamily=i.localIdeographFontFamily,this._updateStyle(e,i))},r.prototype._getUIString=function(t){var e=this._locale[t];if(null==e)throw new Error(\"Missing UI string '\"+t+\"'\");return e},r.prototype._updateStyle=function(t,e){return this.style&&(this.style.setEventedParent(null),this.style._remove()),t?(this.style=new je(this,e||{}),this.style.setEventedParent(this,{style:this.style}),\"string\"==typeof t?this.style.loadURL(t):this.style.loadJSON(t),this):(delete this.style,this)},r.prototype._lazyInitEmptyStyle=function(){this.style||(this.style=new je(this,{}),this.style.setEventedParent(this,{style:this.style}),this.style.loadEmpty());},r.prototype._diffStyle=function(e,i){var o=this;if(\"string\"==typeof e){var r=this._requestManager.normalizeStyleURL(e),a=this._requestManager.transformRequest(r,t.ResourceType.Style);t.getJSON(a,(function(e,r){e?o.fire(new t.ErrorEvent(e)):r&&o._updateDiff(r,i);}));}else \"object\"==typeof e&&this._updateDiff(e,i);},r.prototype._updateDiff=function(e,i){try{this.style.setState(e)&&this._update(!0);}catch(o){t.warnOnce(\"Unable to perform style diff: \"+(o.message||o.error||o)+\".  Rebuilding the style from scratch.\"),this._updateStyle(e,i);}},r.prototype.getStyle=function(){if(this.style)return this.style.serialize()},r.prototype.isStyleLoaded=function(){return this.style?this.style.loaded():t.warnOnce(\"There is no style added to the map.\")},r.prototype.addSource=function(t,e){return this._lazyInitEmptyStyle(),this.style.addSource(t,e),this._update(!0)},r.prototype.isSourceLoaded=function(e){var i=this.style&&this.style.sourceCaches[e];if(void 0!==i)return i.loaded();this.fire(new t.ErrorEvent(new Error(\"There is no source with ID '\"+e+\"'\")));},r.prototype.areTilesLoaded=function(){var t=this.style&&this.style.sourceCaches;for(var e in t){var i=t[e]._tiles;for(var o in i){var r=i[o];if(\"loaded\"!==r.state&&\"errored\"!==r.state)return !1}}return !0},r.prototype.addSourceType=function(t,e,i){return this._lazyInitEmptyStyle(),this.style.addSourceType(t,e,i)},r.prototype.removeSource=function(t){return this.style.removeSource(t),this._update(!0)},r.prototype.getSource=function(t){return this.style.getSource(t)},r.prototype.addImage=function(e,i,o){void 0===o&&(o={});var r=o.pixelRatio;void 0===r&&(r=1);var a=o.sdf;void 0===a&&(a=!1);var n=o.stretchX,s=o.stretchY,l=o.content;if(this._lazyInitEmptyStyle(),i instanceof Tr||Ir&&i instanceof Ir){var c=t.browser.getImageData(i);this.style.addImage(e,{data:new t.RGBAImage({width:c.width,height:c.height},c.data),pixelRatio:r,stretchX:n,stretchY:s,content:l,sdf:a,version:0});}else {if(void 0===i.width||void 0===i.height)return this.fire(new t.ErrorEvent(new Error(\"Invalid arguments to map.addImage(). The second argument must be an `HTMLImageElement`, `ImageData`, `ImageBitmap`, or object with `width`, `height`, and `data` properties with the same format as `ImageData`\")));var u=i;this.style.addImage(e,{data:new t.RGBAImage({width:i.width,height:i.height},new Uint8Array(i.data)),pixelRatio:r,stretchX:n,stretchY:s,content:l,sdf:a,version:0,userImage:u}),u.onAdd&&u.onAdd(this,e);}},r.prototype.updateImage=function(e,i){var o=this.style.getImage(e);if(!o)return this.fire(new t.ErrorEvent(new Error(\"The map has no image with that id. If you are adding a new image use `map.addImage(...)` instead.\")));var r=i instanceof Tr||Ir&&i instanceof Ir?t.browser.getImageData(i):i,a=r.width,n=r.height,s=r.data;return void 0===a||void 0===n?this.fire(new t.ErrorEvent(new Error(\"Invalid arguments to map.updateImage(). The second argument must be an `HTMLImageElement`, `ImageData`, `ImageBitmap`, or object with `width`, `height`, and `data` properties with the same format as `ImageData`\"))):a!==o.data.width||n!==o.data.height?this.fire(new t.ErrorEvent(new Error(\"The width and height of the updated image must be that same as the previous version of the image\"))):(o.data.replace(s,!(i instanceof Tr||Ir&&i instanceof Ir)),void this.style.updateImage(e,o))},r.prototype.hasImage=function(e){return e?!!this.style.getImage(e):(this.fire(new t.ErrorEvent(new Error(\"Missing required image id\"))),!1)},r.prototype.removeImage=function(t){this.style.removeImage(t);},r.prototype.loadImage=function(e,i){t.getImage(this._requestManager.transformRequest(e,t.ResourceType.Image),i);},r.prototype.listImages=function(){return this.style.listImages()},r.prototype.addLayer=function(t,e){return this._lazyInitEmptyStyle(),this.style.addLayer(t,e),this._update(!0)},r.prototype.moveLayer=function(t,e){return this.style.moveLayer(t,e),this._update(!0)},r.prototype.removeLayer=function(t){return this.style.removeLayer(t),this._update(!0)},r.prototype.getLayer=function(t){return this.style.getLayer(t)},r.prototype.setLayerZoomRange=function(t,e,i){return this.style.setLayerZoomRange(t,e,i),this._update(!0)},r.prototype.setFilter=function(t,e,i){return void 0===i&&(i={}),this.style.setFilter(t,e,i),this._update(!0)},r.prototype.getFilter=function(t){return this.style.getFilter(t)},r.prototype.setPaintProperty=function(t,e,i,o){return void 0===o&&(o={}),this.style.setPaintProperty(t,e,i,o),this._update(!0)},r.prototype.getPaintProperty=function(t,e){return this.style.getPaintProperty(t,e)},r.prototype.setLayoutProperty=function(t,e,i,o){return void 0===o&&(o={}),this.style.setLayoutProperty(t,e,i,o),this._update(!0)},r.prototype.getLayoutProperty=function(t,e){return this.style.getLayoutProperty(t,e)},r.prototype.setLight=function(t,e){return void 0===e&&(e={}),this._lazyInitEmptyStyle(),this.style.setLight(t,e),this._update(!0)},r.prototype.getLight=function(){return this.style.getLight()},r.prototype.setFeatureState=function(t,e){return this.style.setFeatureState(t,e),this._update()},r.prototype.removeFeatureState=function(t,e){return this.style.removeFeatureState(t,e),this._update()},r.prototype.getFeatureState=function(t){return this.style.getFeatureState(t)},r.prototype.getContainer=function(){return this._container},r.prototype.getCanvasContainer=function(){return this._canvasContainer},r.prototype.getCanvas=function(){return this._canvas},r.prototype._containerDimensions=function(){var t=0,e=0;return this._container&&(t=this._container.clientWidth||400,e=this._container.clientHeight||300),[t,e]},r.prototype._detectMissingCSS=function(){\"rgb(250, 128, 114)\"!==t.window.getComputedStyle(this._missingCSSCanary).getPropertyValue(\"background-color\")&&t.warnOnce(\"This page appears to be missing CSS declarations for Mapbox GL JS, which may cause the map to display incorrectly. Please ensure your page includes mapbox-gl.css, as described in https://www.mapbox.com/mapbox-gl-js/api/.\");},r.prototype._setupContainer=function(){var t=this._container;t.classList.add(\"mapboxgl-map\"),(this._missingCSSCanary=i.create(\"div\",\"mapboxgl-canary\",t)).style.visibility=\"hidden\",this._detectMissingCSS();var e=this._canvasContainer=i.create(\"div\",\"mapboxgl-canvas-container\",t);this._interactive&&e.classList.add(\"mapboxgl-interactive\"),this._canvas=i.create(\"canvas\",\"mapboxgl-canvas\",e),this._canvas.addEventListener(\"webglcontextlost\",this._contextLost,!1),this._canvas.addEventListener(\"webglcontextrestored\",this._contextRestored,!1),this._canvas.setAttribute(\"tabindex\",\"0\"),this._canvas.setAttribute(\"aria-label\",\"Map\"),this._canvas.setAttribute(\"role\",\"region\");var o=this._containerDimensions();this._resizeCanvas(o[0],o[1]);var r=this._controlContainer=i.create(\"div\",\"mapboxgl-control-container\",t),a=this._controlPositions={};[\"top-left\",\"top-right\",\"bottom-left\",\"bottom-right\"].forEach((function(t){a[t]=i.create(\"div\",\"mapboxgl-ctrl-\"+t,r);})),this._container.addEventListener(\"scroll\",this._onMapScroll,!1);},r.prototype._resizeCanvas=function(e,i){var o=t.browser.devicePixelRatio||1;this._canvas.width=o*e,this._canvas.height=o*i,this._canvas.style.width=e+\"px\",this._canvas.style.height=i+\"px\";},r.prototype._setupPainter=function(){var i=t.extend({},e.webGLContextAttributes,{failIfMajorPerformanceCaveat:this._failIfMajorPerformanceCaveat,preserveDrawingBuffer:this._preserveDrawingBuffer,antialias:this._antialias||!1}),o=this._canvas.getContext(\"webgl\",i)||this._canvas.getContext(\"experimental-webgl\",i);o?(this.painter=new yo(o,this.transform),t.webpSupported.testSupport(o)):this.fire(new t.ErrorEvent(new Error(\"Failed to initialize WebGL\")));},r.prototype._contextLost=function(e){e.preventDefault(),this._frame&&(this._frame.cancel(),this._frame=null),this.fire(new t.Event(\"webglcontextlost\",{originalEvent:e}));},r.prototype._contextRestored=function(e){this._setupPainter(),this.resize(),this._update(),this.fire(new t.Event(\"webglcontextrestored\",{originalEvent:e}));},r.prototype._onMapScroll=function(t){if(t.target===this._container)return this._container.scrollTop=0,this._container.scrollLeft=0,!1},r.prototype.loaded=function(){return !this._styleDirty&&!this._sourcesDirty&&!!this.style&&this.style.loaded()},r.prototype._update=function(t){return this.style?(this._styleDirty=this._styleDirty||t,this._sourcesDirty=!0,this.triggerRepaint(),this):this},r.prototype._requestRenderFrame=function(t){return this._update(),this._renderTaskQueue.add(t)},r.prototype._cancelRenderFrame=function(t){this._renderTaskQueue.remove(t);},r.prototype._render=function(e){var i,o=this,r=0,a=this.painter.context.extTimerQuery;if(this.listens(\"gpu-timing-frame\")&&(i=a.createQueryEXT(),a.beginQueryEXT(a.TIME_ELAPSED_EXT,i),r=t.browser.now()),this.painter.context.setDirty(),this.painter.setBaseState(),this._renderTaskQueue.run(e),!this._removed){var n=!1;if(this.style&&this._styleDirty){this._styleDirty=!1;var s=this.transform.zoom,l=t.browser.now();this.style.zoomHistory.update(s,l);var c=new t.EvaluationParameters(s,{now:l,fadeDuration:this._fadeDuration,zoomHistory:this.style.zoomHistory,transition:this.style.getTransition()}),u=c.crossFadingFactor();1===u&&u===this._crossFadingFactor||(n=!0,this._crossFadingFactor=u),this.style.update(c);}if(this.style&&this._sourcesDirty&&(this._sourcesDirty=!1,this.style._updateSources(this.transform)),this._placementDirty=this.style&&this.style._updatePlacement(this.painter.transform,this.showCollisionBoxes,this._fadeDuration,this._crossSourceCollisions),this.painter.render(this.style,{showTileBoundaries:this.showTileBoundaries,showOverdrawInspector:this._showOverdrawInspector,rotating:this.isRotating(),zooming:this.isZooming(),moving:this.isMoving(),fadeDuration:this._fadeDuration,showPadding:this.showPadding,gpuTiming:!!this.listens(\"gpu-timing-layer\")}),this.fire(new t.Event(\"render\")),this.loaded()&&!this._loaded&&(this._loaded=!0,this.fire(new t.Event(\"load\"))),this.style&&(this.style.hasTransitions()||n)&&(this._styleDirty=!0),this.style&&!this._placementDirty&&this.style._releaseSymbolFadeTiles(),this.listens(\"gpu-timing-frame\")){var h=t.browser.now()-r;a.endQueryEXT(a.TIME_ELAPSED_EXT,i),setTimeout((function(){var e=a.getQueryObjectEXT(i,a.QUERY_RESULT_EXT)/1e6;a.deleteQueryEXT(i),o.fire(new t.Event(\"gpu-timing-frame\",{cpuTime:h,gpuTime:e}));}),50);}if(this.listens(\"gpu-timing-layer\")){var p=this.painter.collectGpuTimers();setTimeout((function(){var e=o.painter.queryGpuTimers(p);o.fire(new t.Event(\"gpu-timing-layer\",{layerTimes:e}));}),50);}var d=this._sourcesDirty||this._styleDirty||this._placementDirty;return d||this._repaint?this.triggerRepaint():!this.isMoving()&&this.loaded()&&this.fire(new t.Event(\"idle\")),!this._loaded||this._fullyLoaded||d||(this._fullyLoaded=!0),this}},r.prototype.remove=function(){this._hash&&this._hash.remove();for(var e=0,i=this._controls;e<i.length;e+=1)i[e].onRemove(this);this._controls=[],this._frame&&(this._frame.cancel(),this._frame=null),this._renderTaskQueue.clear(),this.painter.destroy(),this.handlers.destroy(),delete this.handlers,this.setStyle(null),void 0!==t.window&&(t.window.removeEventListener(\"resize\",this._onWindowResize,!1),t.window.removeEventListener(\"orientationchange\",this._onWindowResize,!1),t.window.removeEventListener(\"online\",this._onWindowOnline,!1));var o=this.painter.context.gl.getExtension(\"WEBGL_lose_context\");o&&o.loseContext(),Cr(this._canvasContainer),Cr(this._controlContainer),Cr(this._missingCSSCanary),this._container.classList.remove(\"mapboxgl-map\"),this._removed=!0,this.fire(new t.Event(\"remove\"));},r.prototype.triggerRepaint=function(){var e=this;this.style&&!this._frame&&(this._frame=t.browser.frame((function(t){e._frame=null,e._render(t);})));},r.prototype._onWindowOnline=function(){this._update();},r.prototype._onWindowResize=function(t){this._trackResize&&this.resize({originalEvent:t})._update();},a.showTileBoundaries.get=function(){return !!this._showTileBoundaries},a.showTileBoundaries.set=function(t){this._showTileBoundaries!==t&&(this._showTileBoundaries=t,this._update());},a.showPadding.get=function(){return !!this._showPadding},a.showPadding.set=function(t){this._showPadding!==t&&(this._showPadding=t,this._update());},a.showCollisionBoxes.get=function(){return !!this._showCollisionBoxes},a.showCollisionBoxes.set=function(t){this._showCollisionBoxes!==t&&(this._showCollisionBoxes=t,t?this.style._generateCollisionBoxes():this._update());},a.showOverdrawInspector.get=function(){return !!this._showOverdrawInspector},a.showOverdrawInspector.set=function(t){this._showOverdrawInspector!==t&&(this._showOverdrawInspector=t,this._update());},a.repaint.get=function(){return !!this._repaint},a.repaint.set=function(t){this._repaint!==t&&(this._repaint=t,this.triggerRepaint());},a.vertices.get=function(){return !!this._vertices},a.vertices.set=function(t){this._vertices=t,this._update();},r.prototype._setCacheLimits=function(e,i){t.setCacheLimits(e,i);},a.version.get=function(){return t.version},Object.defineProperties(r.prototype,a),r}(vr);function Cr(t){t.parentNode&&t.parentNode.removeChild(t);}var zr={showCompass:!0,showZoom:!0,visualizePitch:!1},Dr=function(e){var o=this;this.options=t.extend({},zr,e),this._container=i.create(\"div\",\"mapboxgl-ctrl mapboxgl-ctrl-group\"),this._container.addEventListener(\"contextmenu\",(function(t){return t.preventDefault()})),this.options.showZoom&&(t.bindAll([\"_setButtonTitle\",\"_updateZoomButtons\"],this),this._zoomInButton=this._createButton(\"mapboxgl-ctrl-zoom-in\",(function(t){return o._map.zoomIn({},{originalEvent:t})})),i.create(\"span\",\"mapboxgl-ctrl-icon\",this._zoomInButton).setAttribute(\"aria-hidden\",!0),this._zoomOutButton=this._createButton(\"mapboxgl-ctrl-zoom-out\",(function(t){return o._map.zoomOut({},{originalEvent:t})})),i.create(\"span\",\"mapboxgl-ctrl-icon\",this._zoomOutButton).setAttribute(\"aria-hidden\",!0)),this.options.showCompass&&(t.bindAll([\"_rotateCompassArrow\"],this),this._compass=this._createButton(\"mapboxgl-ctrl-compass\",(function(t){o.options.visualizePitch?o._map.resetNorthPitch({},{originalEvent:t}):o._map.resetNorth({},{originalEvent:t});})),this._compassIcon=i.create(\"span\",\"mapboxgl-ctrl-icon\",this._compass),this._compassIcon.setAttribute(\"aria-hidden\",!0));};Dr.prototype._updateZoomButtons=function(){var t=this._map.getZoom(),e=t===this._map.getMaxZoom(),i=t===this._map.getMinZoom();this._zoomInButton.disabled=e,this._zoomOutButton.disabled=i,this._zoomInButton.setAttribute(\"aria-disabled\",e.toString()),this._zoomOutButton.setAttribute(\"aria-disabled\",i.toString());},Dr.prototype._rotateCompassArrow=function(){var t=this.options.visualizePitch?\"scale(\"+1/Math.pow(Math.cos(this._map.transform.pitch*(Math.PI/180)),.5)+\") rotateX(\"+this._map.transform.pitch+\"deg) rotateZ(\"+this._map.transform.angle*(180/Math.PI)+\"deg)\":\"rotate(\"+this._map.transform.angle*(180/Math.PI)+\"deg)\";this._compassIcon.style.transform=t;},Dr.prototype.onAdd=function(t){return this._map=t,this.options.showZoom&&(this._setButtonTitle(this._zoomInButton,\"ZoomIn\"),this._setButtonTitle(this._zoomOutButton,\"ZoomOut\"),this._map.on(\"zoom\",this._updateZoomButtons),this._updateZoomButtons()),this.options.showCompass&&(this._setButtonTitle(this._compass,\"ResetBearing\"),this.options.visualizePitch&&this._map.on(\"pitch\",this._rotateCompassArrow),this._map.on(\"rotate\",this._rotateCompassArrow),this._rotateCompassArrow(),this._handler=new Ar(this._map,this._compass,this.options.visualizePitch)),this._container},Dr.prototype.onRemove=function(){i.remove(this._container),this.options.showZoom&&this._map.off(\"zoom\",this._updateZoomButtons),this.options.showCompass&&(this.options.visualizePitch&&this._map.off(\"pitch\",this._rotateCompassArrow),this._map.off(\"rotate\",this._rotateCompassArrow),this._handler.off(),delete this._handler),delete this._map;},Dr.prototype._createButton=function(t,e){var o=i.create(\"button\",t,this._container);return o.type=\"button\",o.addEventListener(\"click\",e),o},Dr.prototype._setButtonTitle=function(t,e){var i=this._map._getUIString(\"NavigationControl.\"+e);t.title=i,t.setAttribute(\"aria-label\",i);};var Ar=function(e,o,r){void 0===r&&(r=!1),this._clickTolerance=10,this.element=o,this.mouseRotate=new Xo({clickTolerance:e.dragRotate._mouseRotate._clickTolerance}),this.map=e,r&&(this.mousePitch=new Ho({clickTolerance:e.dragRotate._mousePitch._clickTolerance})),t.bindAll([\"mousedown\",\"mousemove\",\"mouseup\",\"touchstart\",\"touchmove\",\"touchend\",\"reset\"],this),i.addEventListener(o,\"mousedown\",this.mousedown),i.addEventListener(o,\"touchstart\",this.touchstart,{passive:!1}),i.addEventListener(o,\"touchmove\",this.touchmove),i.addEventListener(o,\"touchend\",this.touchend),i.addEventListener(o,\"touchcancel\",this.reset);};function Mr(e,i,o){if(e=new t.LngLat(e.lng,e.lat),i){var r=new t.LngLat(e.lng-360,e.lat),a=new t.LngLat(e.lng+360,e.lat),n=o.locationPoint(e).distSqr(i);o.locationPoint(r).distSqr(i)<n?e=r:o.locationPoint(a).distSqr(i)<n&&(e=a);}for(;Math.abs(e.lng-o.center.lng)>180;){var s=o.locationPoint(e);if(s.x>=0&&s.y>=0&&s.x<=o.width&&s.y<=o.height)break;e.lng>o.center.lng?e.lng-=360:e.lng+=360;}return e}Ar.prototype.down=function(t,e){this.mouseRotate.mousedown(t,e),this.mousePitch&&this.mousePitch.mousedown(t,e),i.disableDrag();},Ar.prototype.move=function(t,e){var i=this.map,o=this.mouseRotate.mousemoveWindow(t,e);if(o&&o.bearingDelta&&i.setBearing(i.getBearing()+o.bearingDelta),this.mousePitch){var r=this.mousePitch.mousemoveWindow(t,e);r&&r.pitchDelta&&i.setPitch(i.getPitch()+r.pitchDelta);}},Ar.prototype.off=function(){var t=this.element;i.removeEventListener(t,\"mousedown\",this.mousedown),i.removeEventListener(t,\"touchstart\",this.touchstart,{passive:!1}),i.removeEventListener(t,\"touchmove\",this.touchmove),i.removeEventListener(t,\"touchend\",this.touchend),i.removeEventListener(t,\"touchcancel\",this.reset),this.offTemp();},Ar.prototype.offTemp=function(){i.enableDrag(),i.removeEventListener(t.window,\"mousemove\",this.mousemove),i.removeEventListener(t.window,\"mouseup\",this.mouseup);},Ar.prototype.mousedown=function(e){this.down(t.extend({},e,{ctrlKey:!0,preventDefault:function(){return e.preventDefault()}}),i.mousePos(this.element,e)),i.addEventListener(t.window,\"mousemove\",this.mousemove),i.addEventListener(t.window,\"mouseup\",this.mouseup);},Ar.prototype.mousemove=function(t){this.move(t,i.mousePos(this.element,t));},Ar.prototype.mouseup=function(t){this.mouseRotate.mouseupWindow(t),this.mousePitch&&this.mousePitch.mouseupWindow(t),this.offTemp();},Ar.prototype.touchstart=function(t){1!==t.targetTouches.length?this.reset():(this._startPos=this._lastPos=i.touchPos(this.element,t.targetTouches)[0],this.down({type:\"mousedown\",button:0,ctrlKey:!0,preventDefault:function(){return t.preventDefault()}},this._startPos));},Ar.prototype.touchmove=function(t){1!==t.targetTouches.length?this.reset():(this._lastPos=i.touchPos(this.element,t.targetTouches)[0],this.move({preventDefault:function(){return t.preventDefault()}},this._lastPos));},Ar.prototype.touchend=function(t){0===t.targetTouches.length&&this._startPos&&this._lastPos&&this._startPos.dist(this._lastPos)<this._clickTolerance&&this.element.click(),this.reset();},Ar.prototype.reset=function(){this.mouseRotate.reset(),this.mousePitch&&this.mousePitch.reset(),delete this._startPos,delete this._lastPos,this.offTemp();};var Lr={center:\"translate(-50%,-50%)\",top:\"translate(-50%,0)\",\"top-left\":\"translate(0,0)\",\"top-right\":\"translate(-100%,0)\",bottom:\"translate(-50%,-100%)\",\"bottom-left\":\"translate(0,-100%)\",\"bottom-right\":\"translate(-100%,-100%)\",left:\"translate(0,-50%)\",right:\"translate(-100%,-50%)\"};function Rr(t,e,i){var o=t.classList;for(var r in Lr)o.remove(\"mapboxgl-\"+i+\"-anchor-\"+r);o.add(\"mapboxgl-\"+i+\"-anchor-\"+e);}var kr,Br=function(e){function o(o,r){if(e.call(this),(o instanceof t.window.HTMLElement||r)&&(o=t.extend({element:o},r)),t.bindAll([\"_update\",\"_onMove\",\"_onUp\",\"_addDragHandler\",\"_onMapClick\",\"_onKeyPress\"],this),this._anchor=o&&o.anchor||\"center\",this._color=o&&o.color||\"#3FB1CE\",this._scale=o&&o.scale||1,this._draggable=o&&o.draggable||!1,this._clickTolerance=o&&o.clickTolerance||0,this._isDragging=!1,this._state=\"inactive\",this._rotation=o&&o.rotation||0,this._rotationAlignment=o&&o.rotationAlignment||\"auto\",this._pitchAlignment=o&&o.pitchAlignment&&\"auto\"!==o.pitchAlignment?o.pitchAlignment:this._rotationAlignment,o&&o.element)this._element=o.element,this._offset=t.Point.convert(o&&o.offset||[0,0]);else {this._defaultMarker=!0,this._element=i.create(\"div\"),this._element.setAttribute(\"aria-label\",\"Map marker\");var a=i.createNS(\"http://www.w3.org/2000/svg\",\"svg\");a.setAttributeNS(null,\"display\",\"block\"),a.setAttributeNS(null,\"height\",\"41px\"),a.setAttributeNS(null,\"width\",\"27px\"),a.setAttributeNS(null,\"viewBox\",\"0 0 27 41\");var n=i.createNS(\"http://www.w3.org/2000/svg\",\"g\");n.setAttributeNS(null,\"stroke\",\"none\"),n.setAttributeNS(null,\"stroke-width\",\"1\"),n.setAttributeNS(null,\"fill\",\"none\"),n.setAttributeNS(null,\"fill-rule\",\"evenodd\");var s=i.createNS(\"http://www.w3.org/2000/svg\",\"g\");s.setAttributeNS(null,\"fill-rule\",\"nonzero\");var l=i.createNS(\"http://www.w3.org/2000/svg\",\"g\");l.setAttributeNS(null,\"transform\",\"translate(3.0, 29.0)\"),l.setAttributeNS(null,\"fill\",\"#000000\");for(var c=0,u=[{rx:\"10.5\",ry:\"5.25002273\"},{rx:\"10.5\",ry:\"5.25002273\"},{rx:\"9.5\",ry:\"4.77275007\"},{rx:\"8.5\",ry:\"4.29549936\"},{rx:\"7.5\",ry:\"3.81822308\"},{rx:\"6.5\",ry:\"3.34094679\"},{rx:\"5.5\",ry:\"2.86367051\"},{rx:\"4.5\",ry:\"2.38636864\"}];c<u.length;c+=1){var h=u[c],p=i.createNS(\"http://www.w3.org/2000/svg\",\"ellipse\");p.setAttributeNS(null,\"opacity\",\"0.04\"),p.setAttributeNS(null,\"cx\",\"10.5\"),p.setAttributeNS(null,\"cy\",\"5.80029008\"),p.setAttributeNS(null,\"rx\",h.rx),p.setAttributeNS(null,\"ry\",h.ry),l.appendChild(p);}var d=i.createNS(\"http://www.w3.org/2000/svg\",\"g\");d.setAttributeNS(null,\"fill\",this._color);var _=i.createNS(\"http://www.w3.org/2000/svg\",\"path\");_.setAttributeNS(null,\"d\",\"M27,13.5 C27,19.074644 20.250001,27.000002 14.75,34.500002 C14.016665,35.500004 12.983335,35.500004 12.25,34.500002 C6.7499993,27.000002 0,19.222562 0,13.5 C0,6.0441559 6.0441559,0 13.5,0 C20.955844,0 27,6.0441559 27,13.5 Z\"),d.appendChild(_);var f=i.createNS(\"http://www.w3.org/2000/svg\",\"g\");f.setAttributeNS(null,\"opacity\",\"0.25\"),f.setAttributeNS(null,\"fill\",\"#000000\");var m=i.createNS(\"http://www.w3.org/2000/svg\",\"path\");m.setAttributeNS(null,\"d\",\"M13.5,0 C6.0441559,0 0,6.0441559 0,13.5 C0,19.222562 6.7499993,27 12.25,34.5 C13,35.522727 14.016664,35.500004 14.75,34.5 C20.250001,27 27,19.074644 27,13.5 C27,6.0441559 20.955844,0 13.5,0 Z M13.5,1 C20.415404,1 26,6.584596 26,13.5 C26,15.898657 24.495584,19.181431 22.220703,22.738281 C19.945823,26.295132 16.705119,30.142167 13.943359,33.908203 C13.743445,34.180814 13.612715,34.322738 13.5,34.441406 C13.387285,34.322738 13.256555,34.180814 13.056641,33.908203 C10.284481,30.127985 7.4148684,26.314159 5.015625,22.773438 C2.6163816,19.232715 1,15.953538 1,13.5 C1,6.584596 6.584596,1 13.5,1 Z\"),f.appendChild(m);var g=i.createNS(\"http://www.w3.org/2000/svg\",\"g\");g.setAttributeNS(null,\"transform\",\"translate(6.0, 7.0)\"),g.setAttributeNS(null,\"fill\",\"#FFFFFF\");var v=i.createNS(\"http://www.w3.org/2000/svg\",\"g\");v.setAttributeNS(null,\"transform\",\"translate(8.0, 8.0)\");var y=i.createNS(\"http://www.w3.org/2000/svg\",\"circle\");y.setAttributeNS(null,\"fill\",\"#000000\"),y.setAttributeNS(null,\"opacity\",\"0.25\"),y.setAttributeNS(null,\"cx\",\"5.5\"),y.setAttributeNS(null,\"cy\",\"5.5\"),y.setAttributeNS(null,\"r\",\"5.4999962\");var x=i.createNS(\"http://www.w3.org/2000/svg\",\"circle\");x.setAttributeNS(null,\"fill\",\"#FFFFFF\"),x.setAttributeNS(null,\"cx\",\"5.5\"),x.setAttributeNS(null,\"cy\",\"5.5\"),x.setAttributeNS(null,\"r\",\"5.4999962\"),v.appendChild(y),v.appendChild(x),s.appendChild(l),s.appendChild(d),s.appendChild(f),s.appendChild(g),s.appendChild(v),a.appendChild(s),a.setAttributeNS(null,\"height\",41*this._scale+\"px\"),a.setAttributeNS(null,\"width\",27*this._scale+\"px\"),this._element.appendChild(a),this._offset=t.Point.convert(o&&o.offset||[0,-14]);}this._element.classList.add(\"mapboxgl-marker\"),this._element.addEventListener(\"dragstart\",(function(t){t.preventDefault();})),this._element.addEventListener(\"mousedown\",(function(t){t.preventDefault();})),Rr(this._element,this._anchor,\"marker\"),this._popup=null;}return e&&(o.__proto__=e),(o.prototype=Object.create(e&&e.prototype)).constructor=o,o.prototype.addTo=function(t){return this.remove(),this._map=t,t.getCanvasContainer().appendChild(this._element),t.on(\"move\",this._update),t.on(\"moveend\",this._update),this.setDraggable(this._draggable),this._update(),this._map.on(\"click\",this._onMapClick),this},o.prototype.remove=function(){return this._map&&(this._map.off(\"click\",this._onMapClick),this._map.off(\"move\",this._update),this._map.off(\"moveend\",this._update),this._map.off(\"mousedown\",this._addDragHandler),this._map.off(\"touchstart\",this._addDragHandler),this._map.off(\"mouseup\",this._onUp),this._map.off(\"touchend\",this._onUp),this._map.off(\"mousemove\",this._onMove),this._map.off(\"touchmove\",this._onMove),delete this._map),i.remove(this._element),this._popup&&this._popup.remove(),this},o.prototype.getLngLat=function(){return this._lngLat},o.prototype.setLngLat=function(e){return this._lngLat=t.LngLat.convert(e),this._pos=null,this._popup&&this._popup.setLngLat(this._lngLat),this._update(),this},o.prototype.getElement=function(){return this._element},o.prototype.setPopup=function(t){if(this._popup&&(this._popup.remove(),this._popup=null,this._element.removeEventListener(\"keypress\",this._onKeyPress),this._originalTabIndex||this._element.removeAttribute(\"tabindex\")),t){if(!(\"offset\"in t.options)){var e=Math.sqrt(Math.pow(13.5,2)/2);t.options.offset=this._defaultMarker?{top:[0,0],\"top-left\":[0,0],\"top-right\":[0,0],bottom:[0,-38.1],\"bottom-left\":[e,-1*(24.6+e)],\"bottom-right\":[-e,-1*(24.6+e)],left:[13.5,-24.6],right:[-13.5,-24.6]}:this._offset;}this._popup=t,this._lngLat&&this._popup.setLngLat(this._lngLat),this._originalTabIndex=this._element.getAttribute(\"tabindex\"),this._originalTabIndex||this._element.setAttribute(\"tabindex\",\"0\"),this._element.addEventListener(\"keypress\",this._onKeyPress);}return this},o.prototype._onKeyPress=function(t){var e=t.code,i=t.charCode||t.keyCode;\"Space\"!==e&&\"Enter\"!==e&&32!==i&&13!==i||this.togglePopup();},o.prototype._onMapClick=function(t){var e=t.originalEvent.target,i=this._element;this._popup&&(e===i||i.contains(e))&&this.togglePopup();},o.prototype.getPopup=function(){return this._popup},o.prototype.togglePopup=function(){var t=this._popup;return t?(t.isOpen()?t.remove():t.addTo(this._map),this):this},o.prototype._update=function(t){if(this._map){this._map.transform.renderWorldCopies&&(this._lngLat=Mr(this._lngLat,this._pos,this._map.transform)),this._pos=this._map.project(this._lngLat)._add(this._offset);var e=\"\";\"viewport\"===this._rotationAlignment||\"auto\"===this._rotationAlignment?e=\"rotateZ(\"+this._rotation+\"deg)\":\"map\"===this._rotationAlignment&&(e=\"rotateZ(\"+(this._rotation-this._map.getBearing())+\"deg)\");var o=\"\";\"viewport\"===this._pitchAlignment||\"auto\"===this._pitchAlignment?o=\"rotateX(0deg)\":\"map\"===this._pitchAlignment&&(o=\"rotateX(\"+this._map.getPitch()+\"deg)\"),t&&\"moveend\"!==t.type||(this._pos=this._pos.round()),i.setTransform(this._element,Lr[this._anchor]+\" translate(\"+this._pos.x+\"px, \"+this._pos.y+\"px) \"+o+\" \"+e);}},o.prototype.getOffset=function(){return this._offset},o.prototype.setOffset=function(e){return this._offset=t.Point.convert(e),this._update(),this},o.prototype._onMove=function(e){if(!this._isDragging){var i=this._clickTolerance||this._map._clickTolerance;this._isDragging=e.point.dist(this._pointerdownPos)>=i;}this._isDragging&&(this._pos=e.point.sub(this._positionDelta),this._lngLat=this._map.unproject(this._pos),this.setLngLat(this._lngLat),this._element.style.pointerEvents=\"none\",\"pending\"===this._state&&(this._state=\"active\",this.fire(new t.Event(\"dragstart\"))),this.fire(new t.Event(\"drag\")));},o.prototype._onUp=function(){this._element.style.pointerEvents=\"auto\",this._positionDelta=null,this._pointerdownPos=null,this._isDragging=!1,this._map.off(\"mousemove\",this._onMove),this._map.off(\"touchmove\",this._onMove),\"active\"===this._state&&this.fire(new t.Event(\"dragend\")),this._state=\"inactive\";},o.prototype._addDragHandler=function(t){this._element.contains(t.originalEvent.target)&&(t.preventDefault(),this._positionDelta=t.point.sub(this._pos).add(this._offset),this._pointerdownPos=t.point,this._state=\"pending\",this._map.on(\"mousemove\",this._onMove),this._map.on(\"touchmove\",this._onMove),this._map.once(\"mouseup\",this._onUp),this._map.once(\"touchend\",this._onUp));},o.prototype.setDraggable=function(t){return this._draggable=!!t,this._map&&(t?(this._map.on(\"mousedown\",this._addDragHandler),this._map.on(\"touchstart\",this._addDragHandler)):(this._map.off(\"mousedown\",this._addDragHandler),this._map.off(\"touchstart\",this._addDragHandler))),this},o.prototype.isDraggable=function(){return this._draggable},o.prototype.setRotation=function(t){return this._rotation=t||0,this._update(),this},o.prototype.getRotation=function(){return this._rotation},o.prototype.setRotationAlignment=function(t){return this._rotationAlignment=t||\"auto\",this._update(),this},o.prototype.getRotationAlignment=function(){return this._rotationAlignment},o.prototype.setPitchAlignment=function(t){return this._pitchAlignment=t&&\"auto\"!==t?t:this._rotationAlignment,this._update(),this},o.prototype.getPitchAlignment=function(){return this._pitchAlignment},o}(t.Evented),Or={positionOptions:{enableHighAccuracy:!1,maximumAge:0,timeout:6e3},fitBoundsOptions:{maxZoom:15},trackUserLocation:!1,showAccuracyCircle:!0,showUserLocation:!0},Fr=0,Ur=!1,Nr=function(e){function o(i){e.call(this),this.options=t.extend({},Or,i),t.bindAll([\"_onSuccess\",\"_onError\",\"_onZoom\",\"_finish\",\"_setupUI\",\"_updateCamera\",\"_updateMarker\"],this);}return e&&(o.__proto__=e),(o.prototype=Object.create(e&&e.prototype)).constructor=o,o.prototype.onAdd=function(e){var o;return this._map=e,this._container=i.create(\"div\",\"mapboxgl-ctrl mapboxgl-ctrl-group\"),o=this._setupUI,void 0!==kr?o(kr):void 0!==t.window.navigator.permissions?t.window.navigator.permissions.query({name:\"geolocation\"}).then((function(t){o(kr=\"denied\"!==t.state);})):o(kr=!!t.window.navigator.geolocation),this._container},o.prototype.onRemove=function(){void 0!==this._geolocationWatchID&&(t.window.navigator.geolocation.clearWatch(this._geolocationWatchID),this._geolocationWatchID=void 0),this.options.showUserLocation&&this._userLocationDotMarker&&this._userLocationDotMarker.remove(),this.options.showAccuracyCircle&&this._accuracyCircleMarker&&this._accuracyCircleMarker.remove(),i.remove(this._container),this._map.off(\"zoom\",this._onZoom),this._map=void 0,Fr=0,Ur=!1;},o.prototype._isOutOfMapMaxBounds=function(t){var e=this._map.getMaxBounds(),i=t.coords;return e&&(i.longitude<e.getWest()||i.longitude>e.getEast()||i.latitude<e.getSouth()||i.latitude>e.getNorth())},o.prototype._setErrorState=function(){switch(this._watchState){case\"WAITING_ACTIVE\":this._watchState=\"ACTIVE_ERROR\",this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-active\"),this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-active-error\");break;case\"ACTIVE_LOCK\":this._watchState=\"ACTIVE_ERROR\",this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-active\"),this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-active-error\"),this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-waiting\");break;case\"BACKGROUND\":this._watchState=\"BACKGROUND_ERROR\",this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-background\"),this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-background-error\"),this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-waiting\");}},o.prototype._onSuccess=function(e){if(this._map){if(this._isOutOfMapMaxBounds(e))return this._setErrorState(),this.fire(new t.Event(\"outofmaxbounds\",e)),this._updateMarker(),void this._finish();if(this.options.trackUserLocation)switch(this._lastKnownPosition=e,this._watchState){case\"WAITING_ACTIVE\":case\"ACTIVE_LOCK\":case\"ACTIVE_ERROR\":this._watchState=\"ACTIVE_LOCK\",this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-waiting\"),this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-active-error\"),this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-active\");break;case\"BACKGROUND\":case\"BACKGROUND_ERROR\":this._watchState=\"BACKGROUND\",this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-waiting\"),this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-background-error\"),this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-background\");}this.options.showUserLocation&&\"OFF\"!==this._watchState&&this._updateMarker(e),this.options.trackUserLocation&&\"ACTIVE_LOCK\"!==this._watchState||this._updateCamera(e),this.options.showUserLocation&&this._dotElement.classList.remove(\"mapboxgl-user-location-dot-stale\"),this.fire(new t.Event(\"geolocate\",e)),this._finish();}},o.prototype._updateCamera=function(e){var i=new t.LngLat(e.coords.longitude,e.coords.latitude),o=e.coords.accuracy,r=this._map.getBearing(),a=t.extend({bearing:r},this.options.fitBoundsOptions);this._map.fitBounds(i.toBounds(o),a,{geolocateSource:!0});},o.prototype._updateMarker=function(e){if(e){var i=new t.LngLat(e.coords.longitude,e.coords.latitude);this._accuracyCircleMarker.setLngLat(i).addTo(this._map),this._userLocationDotMarker.setLngLat(i).addTo(this._map),this._accuracy=e.coords.accuracy,this.options.showUserLocation&&this.options.showAccuracyCircle&&this._updateCircleRadius();}else this._userLocationDotMarker.remove(),this._accuracyCircleMarker.remove();},o.prototype._updateCircleRadius=function(){var t=this._map._container.clientHeight/2,e=this._map.unproject([0,t]),i=this._map.unproject([1,t]),o=e.distanceTo(i),r=Math.ceil(2*this._accuracy/o);this._circleElement.style.width=r+\"px\",this._circleElement.style.height=r+\"px\";},o.prototype._onZoom=function(){this.options.showUserLocation&&this.options.showAccuracyCircle&&this._updateCircleRadius();},o.prototype._onError=function(e){if(this._map){if(this.options.trackUserLocation)if(1===e.code){this._watchState=\"OFF\",this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-waiting\"),this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-active\"),this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-active-error\"),this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-background\"),this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-background-error\"),this._geolocateButton.disabled=!0;var i=this._map._getUIString(\"GeolocateControl.LocationNotAvailable\");this._geolocateButton.title=i,this._geolocateButton.setAttribute(\"aria-label\",i),void 0!==this._geolocationWatchID&&this._clearWatch();}else {if(3===e.code&&Ur)return;this._setErrorState();}\"OFF\"!==this._watchState&&this.options.showUserLocation&&this._dotElement.classList.add(\"mapboxgl-user-location-dot-stale\"),this.fire(new t.Event(\"error\",e)),this._finish();}},o.prototype._finish=function(){this._timeoutId&&clearTimeout(this._timeoutId),this._timeoutId=void 0;},o.prototype._setupUI=function(e){var o=this;if(this._container.addEventListener(\"contextmenu\",(function(t){return t.preventDefault()})),this._geolocateButton=i.create(\"button\",\"mapboxgl-ctrl-geolocate\",this._container),i.create(\"span\",\"mapboxgl-ctrl-icon\",this._geolocateButton).setAttribute(\"aria-hidden\",!0),this._geolocateButton.type=\"button\",!1===e){t.warnOnce(\"Geolocation support is not available so the GeolocateControl will be disabled.\");var r=this._map._getUIString(\"GeolocateControl.LocationNotAvailable\");this._geolocateButton.disabled=!0,this._geolocateButton.title=r,this._geolocateButton.setAttribute(\"aria-label\",r);}else {var a=this._map._getUIString(\"GeolocateControl.FindMyLocation\");this._geolocateButton.title=a,this._geolocateButton.setAttribute(\"aria-label\",a);}this.options.trackUserLocation&&(this._geolocateButton.setAttribute(\"aria-pressed\",\"false\"),this._watchState=\"OFF\"),this.options.showUserLocation&&(this._dotElement=i.create(\"div\",\"mapboxgl-user-location-dot\"),this._userLocationDotMarker=new Br(this._dotElement),this._circleElement=i.create(\"div\",\"mapboxgl-user-location-accuracy-circle\"),this._accuracyCircleMarker=new Br({element:this._circleElement,pitchAlignment:\"map\"}),this.options.trackUserLocation&&(this._watchState=\"OFF\"),this._map.on(\"zoom\",this._onZoom)),this._geolocateButton.addEventListener(\"click\",this.trigger.bind(this)),this._setup=!0,this.options.trackUserLocation&&this._map.on(\"movestart\",(function(e){e.geolocateSource||\"ACTIVE_LOCK\"!==o._watchState||e.originalEvent&&\"resize\"===e.originalEvent.type||(o._watchState=\"BACKGROUND\",o._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-background\"),o._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-active\"),o.fire(new t.Event(\"trackuserlocationend\")));}));},o.prototype.trigger=function(){if(!this._setup)return t.warnOnce(\"Geolocate control triggered before added to a map\"),!1;if(this.options.trackUserLocation){switch(this._watchState){case\"OFF\":this._watchState=\"WAITING_ACTIVE\",this.fire(new t.Event(\"trackuserlocationstart\"));break;case\"WAITING_ACTIVE\":case\"ACTIVE_LOCK\":case\"ACTIVE_ERROR\":case\"BACKGROUND_ERROR\":Fr--,Ur=!1,this._watchState=\"OFF\",this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-waiting\"),this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-active\"),this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-active-error\"),this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-background\"),this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-background-error\"),this.fire(new t.Event(\"trackuserlocationend\"));break;case\"BACKGROUND\":this._watchState=\"ACTIVE_LOCK\",this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-background\"),this._lastKnownPosition&&this._updateCamera(this._lastKnownPosition),this.fire(new t.Event(\"trackuserlocationstart\"));}switch(this._watchState){case\"WAITING_ACTIVE\":this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-waiting\"),this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-active\");break;case\"ACTIVE_LOCK\":this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-active\");break;case\"ACTIVE_ERROR\":this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-waiting\"),this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-active-error\");break;case\"BACKGROUND\":this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-background\");break;case\"BACKGROUND_ERROR\":this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-waiting\"),this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-background-error\");}if(\"OFF\"===this._watchState&&void 0!==this._geolocationWatchID)this._clearWatch();else if(void 0===this._geolocationWatchID){var e;this._geolocateButton.classList.add(\"mapboxgl-ctrl-geolocate-waiting\"),this._geolocateButton.setAttribute(\"aria-pressed\",\"true\"),++Fr>1?(e={maximumAge:6e5,timeout:0},Ur=!0):(e=this.options.positionOptions,Ur=!1),this._geolocationWatchID=t.window.navigator.geolocation.watchPosition(this._onSuccess,this._onError,e);}}else t.window.navigator.geolocation.getCurrentPosition(this._onSuccess,this._onError,this.options.positionOptions),this._timeoutId=setTimeout(this._finish,1e4);return !0},o.prototype._clearWatch=function(){t.window.navigator.geolocation.clearWatch(this._geolocationWatchID),this._geolocationWatchID=void 0,this._geolocateButton.classList.remove(\"mapboxgl-ctrl-geolocate-waiting\"),this._geolocateButton.setAttribute(\"aria-pressed\",\"false\"),this.options.showUserLocation&&this._updateMarker(null);},o}(t.Evented),Zr={maxWidth:100,unit:\"metric\"},qr=function(e){this.options=t.extend({},Zr,e),t.bindAll([\"_onMove\",\"setUnit\"],this);};function jr(t,e,i){var o=i&&i.maxWidth||100,r=t._container.clientHeight/2,a=t.unproject([0,r]),n=t.unproject([o,r]),s=a.distanceTo(n);if(i&&\"imperial\"===i.unit){var l=3.2808*s;l>5280?Vr(e,o,l/5280,t._getUIString(\"ScaleControl.Miles\")):Vr(e,o,l,t._getUIString(\"ScaleControl.Feet\"));}else i&&\"nautical\"===i.unit?Vr(e,o,s/1852,t._getUIString(\"ScaleControl.NauticalMiles\")):s>=1e3?Vr(e,o,s/1e3,t._getUIString(\"ScaleControl.Kilometers\")):Vr(e,o,s,t._getUIString(\"ScaleControl.Meters\"));}function Vr(t,e,i,o){var r,a,n,s=(r=i,(a=Math.pow(10,(\"\"+Math.floor(r)).length-1))*(n=(n=r/a)>=10?10:n>=5?5:n>=3?3:n>=2?2:n>=1?1:function(t){var e=Math.pow(10,Math.ceil(-Math.log(t)/Math.LN10));return Math.round(t*e)/e}(n)));t.style.width=e*(s/i)+\"px\",t.innerHTML=s+\"&nbsp;\"+o;}qr.prototype.getDefaultPosition=function(){return \"bottom-left\"},qr.prototype._onMove=function(){jr(this._map,this._container,this.options);},qr.prototype.onAdd=function(t){return this._map=t,this._container=i.create(\"div\",\"mapboxgl-ctrl mapboxgl-ctrl-scale\",t.getContainer()),this._map.on(\"move\",this._onMove),this._onMove(),this._container},qr.prototype.onRemove=function(){i.remove(this._container),this._map.off(\"move\",this._onMove),this._map=void 0;},qr.prototype.setUnit=function(t){this.options.unit=t,jr(this._map,this._container,this.options);};var Gr=function(e){this._fullscreen=!1,e&&e.container&&(e.container instanceof t.window.HTMLElement?this._container=e.container:t.warnOnce(\"Full screen control 'container' must be a DOM element.\")),t.bindAll([\"_onClickFullscreen\",\"_changeIcon\"],this),\"onfullscreenchange\"in t.window.document?this._fullscreenchange=\"fullscreenchange\":\"onmozfullscreenchange\"in t.window.document?this._fullscreenchange=\"mozfullscreenchange\":\"onwebkitfullscreenchange\"in t.window.document?this._fullscreenchange=\"webkitfullscreenchange\":\"onmsfullscreenchange\"in t.window.document&&(this._fullscreenchange=\"MSFullscreenChange\");};Gr.prototype.onAdd=function(e){return this._map=e,this._container||(this._container=this._map.getContainer()),this._controlContainer=i.create(\"div\",\"mapboxgl-ctrl mapboxgl-ctrl-group\"),this._checkFullscreenSupport()?this._setupUI():(this._controlContainer.style.display=\"none\",t.warnOnce(\"This device does not support fullscreen mode.\")),this._controlContainer},Gr.prototype.onRemove=function(){i.remove(this._controlContainer),this._map=null,t.window.document.removeEventListener(this._fullscreenchange,this._changeIcon);},Gr.prototype._checkFullscreenSupport=function(){return !!(t.window.document.fullscreenEnabled||t.window.document.mozFullScreenEnabled||t.window.document.msFullscreenEnabled||t.window.document.webkitFullscreenEnabled)},Gr.prototype._setupUI=function(){var e=this._fullscreenButton=i.create(\"button\",\"mapboxgl-ctrl-fullscreen\",this._controlContainer);i.create(\"span\",\"mapboxgl-ctrl-icon\",e).setAttribute(\"aria-hidden\",!0),e.type=\"button\",this._updateTitle(),this._fullscreenButton.addEventListener(\"click\",this._onClickFullscreen),t.window.document.addEventListener(this._fullscreenchange,this._changeIcon);},Gr.prototype._updateTitle=function(){var t=this._getTitle();this._fullscreenButton.setAttribute(\"aria-label\",t),this._fullscreenButton.title=t;},Gr.prototype._getTitle=function(){return this._map._getUIString(this._isFullscreen()?\"FullscreenControl.Exit\":\"FullscreenControl.Enter\")},Gr.prototype._isFullscreen=function(){return this._fullscreen},Gr.prototype._changeIcon=function(){(t.window.document.fullscreenElement||t.window.document.mozFullScreenElement||t.window.document.webkitFullscreenElement||t.window.document.msFullscreenElement)===this._container!==this._fullscreen&&(this._fullscreen=!this._fullscreen,this._fullscreenButton.classList.toggle(\"mapboxgl-ctrl-shrink\"),this._fullscreenButton.classList.toggle(\"mapboxgl-ctrl-fullscreen\"),this._updateTitle());},Gr.prototype._onClickFullscreen=function(){this._isFullscreen()?t.window.document.exitFullscreen?t.window.document.exitFullscreen():t.window.document.mozCancelFullScreen?t.window.document.mozCancelFullScreen():t.window.document.msExitFullscreen?t.window.document.msExitFullscreen():t.window.document.webkitCancelFullScreen&&t.window.document.webkitCancelFullScreen():this._container.requestFullscreen?this._container.requestFullscreen():this._container.mozRequestFullScreen?this._container.mozRequestFullScreen():this._container.msRequestFullscreen?this._container.msRequestFullscreen():this._container.webkitRequestFullscreen&&this._container.webkitRequestFullscreen();};var Wr={closeButton:!0,closeOnClick:!0,focusAfterOpen:!0,className:\"\",maxWidth:\"240px\"},Xr=[\"a[href]\",\"[tabindex]:not([tabindex='-1'])\",\"[contenteditable]:not([contenteditable='false'])\",\"button:not([disabled])\",\"input:not([disabled])\",\"select:not([disabled])\",\"textarea:not([disabled])\"].join(\", \"),Hr=function(e){function o(i){e.call(this),this.options=t.extend(Object.create(Wr),i),t.bindAll([\"_update\",\"_onClose\",\"remove\",\"_onMouseMove\",\"_onMouseUp\",\"_onDrag\"],this);}return e&&(o.__proto__=e),(o.prototype=Object.create(e&&e.prototype)).constructor=o,o.prototype.addTo=function(e){return this._map&&this.remove(),this._map=e,this.options.closeOnClick&&this._map.on(\"click\",this._onClose),this.options.closeOnMove&&this._map.on(\"move\",this._onClose),this._map.on(\"remove\",this.remove),this._update(),this._focusFirstElement(),this._trackPointer?(this._map.on(\"mousemove\",this._onMouseMove),this._map.on(\"mouseup\",this._onMouseUp),this._container&&this._container.classList.add(\"mapboxgl-popup-track-pointer\"),this._map._canvasContainer.classList.add(\"mapboxgl-track-pointer\")):this._map.on(\"move\",this._update),this.fire(new t.Event(\"open\")),this},o.prototype.isOpen=function(){return !!this._map},o.prototype.remove=function(){return this._content&&i.remove(this._content),this._container&&(i.remove(this._container),delete this._container),this._map&&(this._map.off(\"move\",this._update),this._map.off(\"move\",this._onClose),this._map.off(\"click\",this._onClose),this._map.off(\"remove\",this.remove),this._map.off(\"mousemove\",this._onMouseMove),this._map.off(\"mouseup\",this._onMouseUp),this._map.off(\"drag\",this._onDrag),delete this._map),this.fire(new t.Event(\"close\")),this},o.prototype.getLngLat=function(){return this._lngLat},o.prototype.setLngLat=function(e){return this._lngLat=t.LngLat.convert(e),this._pos=null,this._trackPointer=!1,this._update(),this._map&&(this._map.on(\"move\",this._update),this._map.off(\"mousemove\",this._onMouseMove),this._container&&this._container.classList.remove(\"mapboxgl-popup-track-pointer\"),this._map._canvasContainer.classList.remove(\"mapboxgl-track-pointer\")),this},o.prototype.trackPointer=function(){return this._trackPointer=!0,this._pos=null,this._update(),this._map&&(this._map.off(\"move\",this._update),this._map.on(\"mousemove\",this._onMouseMove),this._map.on(\"drag\",this._onDrag),this._container&&this._container.classList.add(\"mapboxgl-popup-track-pointer\"),this._map._canvasContainer.classList.add(\"mapboxgl-track-pointer\")),this},o.prototype.getElement=function(){return this._container},o.prototype.setText=function(e){return this.setDOMContent(t.window.document.createTextNode(e))},o.prototype.setHTML=function(e){var i,o=t.window.document.createDocumentFragment(),r=t.window.document.createElement(\"body\");for(r.innerHTML=e;i=r.firstChild;)o.appendChild(i);return this.setDOMContent(o)},o.prototype.getMaxWidth=function(){return this._container&&this._container.style.maxWidth},o.prototype.setMaxWidth=function(t){return this.options.maxWidth=t,this._update(),this},o.prototype.setDOMContent=function(t){if(this._content)for(;this._content.hasChildNodes();)this._content.firstChild&&this._content.removeChild(this._content.firstChild);else this._content=i.create(\"div\",\"mapboxgl-popup-content\",this._container);return this._content.appendChild(t),this._createCloseButton(),this._update(),this._focusFirstElement(),this},o.prototype.addClassName=function(t){this._container&&this._container.classList.add(t);},o.prototype.removeClassName=function(t){this._container&&this._container.classList.remove(t);},o.prototype.setOffset=function(t){return this.options.offset=t,this._update(),this},o.prototype.toggleClassName=function(t){if(this._container)return this._container.classList.toggle(t)},o.prototype._createCloseButton=function(){this.options.closeButton&&(this._closeButton=i.create(\"button\",\"mapboxgl-popup-close-button\",this._content),this._closeButton.type=\"button\",this._closeButton.setAttribute(\"aria-label\",\"Close popup\"),this._closeButton.innerHTML=\"&#215;\",this._closeButton.addEventListener(\"click\",this._onClose));},o.prototype._onMouseUp=function(t){this._update(t.point);},o.prototype._onMouseMove=function(t){this._update(t.point);},o.prototype._onDrag=function(t){this._update(t.point);},o.prototype._update=function(e){var o=this;if(this._map&&(this._lngLat||this._trackPointer)&&this._content&&(this._container||(this._container=i.create(\"div\",\"mapboxgl-popup\",this._map.getContainer()),this._tip=i.create(\"div\",\"mapboxgl-popup-tip\",this._container),this._container.appendChild(this._content),this.options.className&&this.options.className.split(\" \").forEach((function(t){return o._container.classList.add(t)})),this._trackPointer&&this._container.classList.add(\"mapboxgl-popup-track-pointer\")),this.options.maxWidth&&this._container.style.maxWidth!==this.options.maxWidth&&(this._container.style.maxWidth=this.options.maxWidth),this._map.transform.renderWorldCopies&&!this._trackPointer&&(this._lngLat=Mr(this._lngLat,this._pos,this._map.transform)),!this._trackPointer||e)){var r=this._pos=this._trackPointer&&e?e:this._map.project(this._lngLat),a=this.options.anchor,n=function e(i){if(i){if(\"number\"==typeof i){var o=Math.round(Math.sqrt(.5*Math.pow(i,2)));return {center:new t.Point(0,0),top:new t.Point(0,i),\"top-left\":new t.Point(o,o),\"top-right\":new t.Point(-o,o),bottom:new t.Point(0,-i),\"bottom-left\":new t.Point(o,-o),\"bottom-right\":new t.Point(-o,-o),left:new t.Point(i,0),right:new t.Point(-i,0)}}if(i instanceof t.Point||Array.isArray(i)){var r=t.Point.convert(i);return {center:r,top:r,\"top-left\":r,\"top-right\":r,bottom:r,\"bottom-left\":r,\"bottom-right\":r,left:r,right:r}}return {center:t.Point.convert(i.center||[0,0]),top:t.Point.convert(i.top||[0,0]),\"top-left\":t.Point.convert(i[\"top-left\"]||[0,0]),\"top-right\":t.Point.convert(i[\"top-right\"]||[0,0]),bottom:t.Point.convert(i.bottom||[0,0]),\"bottom-left\":t.Point.convert(i[\"bottom-left\"]||[0,0]),\"bottom-right\":t.Point.convert(i[\"bottom-right\"]||[0,0]),left:t.Point.convert(i.left||[0,0]),right:t.Point.convert(i.right||[0,0])}}return e(new t.Point(0,0))}(this.options.offset);if(!a){var s,l=this._container.offsetWidth,c=this._container.offsetHeight;s=r.y+n.bottom.y<c?[\"top\"]:r.y>this._map.transform.height-c?[\"bottom\"]:[],r.x<l/2?s.push(\"left\"):r.x>this._map.transform.width-l/2&&s.push(\"right\"),a=0===s.length?\"bottom\":s.join(\"-\");}var u=r.add(n[a]).round();i.setTransform(this._container,Lr[a]+\" translate(\"+u.x+\"px,\"+u.y+\"px)\"),Rr(this._container,a,\"popup\");}},o.prototype._focusFirstElement=function(){if(this.options.focusAfterOpen&&this._container){var t=this._container.querySelector(Xr);t&&t.focus();}},o.prototype._onClose=function(){this.remove();},o}(t.Evented),Kr={version:t.version,supported:e,setRTLTextPlugin:t.setRTLTextPlugin,getRTLTextPluginStatus:t.getRTLTextPluginStatus,Map:Sr,NavigationControl:Dr,GeolocateControl:Nr,AttributionControl:yr,ScaleControl:qr,FullscreenControl:Gr,Popup:Hr,Marker:Br,Style:je,LngLat:t.LngLat,LngLatBounds:t.LngLatBounds,Point:t.Point,MercatorCoordinate:t.MercatorCoordinate,Evented:t.Evented,config:t.config,prewarm:function(){Ft().acquire(Rt);},clearPrewarmedResources:function(){var t=Bt;t&&(t.isPreloaded()&&1===t.numActive()?(t.release(Rt),Bt=null):console.warn(\"Could not clear WebWorkers since there are active Map instances that still reference it. The pre-warmed WebWorker pool can only be cleared when all map instances have been removed with map.remove()\"));},get accessToken(){return t.config.ACCESS_TOKEN},set accessToken(e){t.config.ACCESS_TOKEN=e;},get baseApiUrl(){return t.config.API_URL},set baseApiUrl(e){t.config.API_URL=e;},get workerCount(){return kt.workerCount},set workerCount(t){kt.workerCount=t;},get maxParallelImageRequests(){return t.config.MAX_PARALLEL_IMAGE_REQUESTS},set maxParallelImageRequests(e){t.config.MAX_PARALLEL_IMAGE_REQUESTS=e;},clearStorage:function(e){t.clearTileCache(e);},workerUrl:\"\"};return Kr}));\n\n//\n\nreturn mapboxgl;\n\n})));\n//# sourceMappingURL=mapbox-gl.js.map\n","var arrayLikeToArray = require(\"./arrayLikeToArray.js\");\nfunction _arrayWithoutHoles(arr) {\n  if (Array.isArray(arr)) return arrayLikeToArray(arr);\n}\nmodule.exports = _arrayWithoutHoles, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","function _iterableToArray(iter) {\n  if (typeof Symbol !== \"undefined\" && iter[Symbol.iterator] != null || iter[\"@@iterator\"] != null) return Array.from(iter);\n}\nmodule.exports = _iterableToArray, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","var arrayLikeToArray = require(\"./arrayLikeToArray.js\");\nfunction _unsupportedIterableToArray(o, minLen) {\n  if (!o) return;\n  if (typeof o === \"string\") return arrayLikeToArray(o, minLen);\n  var n = Object.prototype.toString.call(o).slice(8, -1);\n  if (n === \"Object\" && o.constructor) n = o.constructor.name;\n  if (n === \"Map\" || n === \"Set\") return Array.from(o);\n  if (n === \"Arguments\" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return arrayLikeToArray(o, minLen);\n}\nmodule.exports = _unsupportedIterableToArray, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","function _nonIterableSpread() {\n  throw new TypeError(\"Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.\");\n}\nmodule.exports = _nonIterableSpread, module.exports.__esModule = true, module.exports[\"default\"] = module.exports;","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\nimport {DefaultProps} from '@deck.gl/core';\nimport {ArcLayer, ArcLayerProps} from '@deck.gl/layers';\n\nconst defaultProps: DefaultProps<ArcLayerProps> = {\n  getHeight: {type: 'accessor', value: 0},\n  greatCircle: true\n};\n\n/** All properties supported by GreatCircleLayer. */\nexport type GreatCircleLayerProps<DataT = any> = ArcLayerProps<DataT>;\n\n// This layer has been merged into the core ArcLayer\n// Keeping for backward-compatibility\n/** @deprecated Use ArcLayer with `greatCircle: true` instead */\nexport default class GreatCircleLayer<DataT = any, ExtraProps = {}> extends ArcLayer<\n  DataT,\n  ExtraProps\n> {\n  static layerName = 'GreatCircleLayer';\n  static defaultProps: any = defaultProps;\n}\n","import {CompositeLayer, CompositeLayerProps, Layer, LayersList, DefaultProps} from '@deck.gl/core';\nimport {PolygonLayer, PolygonLayerProps} from '@deck.gl/layers';\n\nconst defaultProps: DefaultProps<GeoCellLayerProps> = {\n  ...PolygonLayer.defaultProps\n};\n\n/** All properties supported by GeoCellLayer. */\nexport type GeoCellLayerProps<DataT = any> = PolygonLayerProps<DataT> & CompositeLayerProps<DataT>;\n\nexport default class GeoCellLayer<DataT = any, ExtraProps = {}> extends CompositeLayer<\n  Required<GeoCellLayerProps<DataT>> & ExtraProps\n> {\n  static layerName = 'GeoCellLayer';\n  static defaultProps = defaultProps;\n\n  /** Implement to generate props to create geometry. */\n  indexToBounds(): Partial<GeoCellLayer['props']> | null {\n    return null;\n  }\n\n  renderLayers(): Layer | null | LayersList {\n    // Rendering props underlying layer\n    const {\n      elevationScale,\n      extruded,\n      wireframe,\n      filled,\n      stroked,\n      lineWidthUnits,\n      lineWidthScale,\n      lineWidthMinPixels,\n      lineWidthMaxPixels,\n      lineJointRounded,\n      lineMiterLimit,\n      lineDashJustified,\n      getElevation,\n      getFillColor,\n      getLineColor,\n      getLineWidth\n    } = this.props;\n\n    // Accessor props for underlying layers\n    const {updateTriggers, material, transitions} = this.props;\n\n    // Filled Polygon Layer\n    const CellLayer = this.getSubLayerClass('cell', PolygonLayer);\n    return new CellLayer(\n      {\n        filled,\n        wireframe,\n\n        extruded,\n        elevationScale,\n\n        stroked,\n        lineWidthUnits,\n        lineWidthScale,\n        lineWidthMinPixels,\n        lineWidthMaxPixels,\n        lineJointRounded,\n        lineMiterLimit,\n        lineDashJustified,\n\n        material,\n        transitions,\n\n        getElevation,\n        getFillColor,\n        getLineColor,\n        getLineWidth\n      },\n      this.getSubLayerProps({\n        id: 'cell',\n        updateTriggers: updateTriggers && {\n          getElevation: updateTriggers.getElevation,\n          getFillColor: updateTriggers.getFillColor,\n          getLineColor: updateTriggers.getLineColor,\n          getLineWidth: updateTriggers.getLineWidth\n        }\n      }),\n      this.indexToBounds()\n    );\n  }\n}\n","/*\nAdapted from s2-geometry\n\nISC License (ISC)\n\nCopyright (c) 2012-2016, Jon Atkins <github@jonatkins.com>\nCopyright (c) 2016, AJ ONeal <aj@daplie.com>\n\nPermission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.\n*/\n\nimport Long from 'long';\n\n//\n// Functional Style\n//\nconst FACE_BITS = 3;\nconst MAX_LEVEL = 30;\nconst POS_BITS = 2 * MAX_LEVEL + 1; // 61 (60 bits of data, 1 bit lsb marker)\nconst RADIAN_TO_DEGREE = 180 / Math.PI;\n\nexport function IJToST(\n  ij: [number, number],\n  order: number,\n  offsets: [number, number]\n): [number, number] {\n  const maxSize = 1 << order;\n\n  return [(ij[0] + offsets[0]) / maxSize, (ij[1] + offsets[1]) / maxSize];\n}\n\nfunction singleSTtoUV(st: number): number {\n  if (st >= 0.5) {\n    return (1 / 3.0) * (4 * st * st - 1);\n  }\n  return (1 / 3.0) * (1 - 4 * (1 - st) * (1 - st));\n}\n\nexport function STToUV(st: [number, number]): [number, number] {\n  return [singleSTtoUV(st[0]), singleSTtoUV(st[1])];\n}\n\nexport function FaceUVToXYZ(face: number, [u, v]: [number, number]): [number, number, number] {\n  switch (face) {\n    case 0:\n      return [1, u, v];\n    case 1:\n      return [-u, 1, v];\n    case 2:\n      return [-u, -v, 1];\n    case 3:\n      return [-1, -v, -u];\n    case 4:\n      return [v, -1, -u];\n    case 5:\n      return [v, u, -1];\n    default:\n      throw new Error('Invalid face');\n  }\n}\n\nexport function XYZToLngLat([x, y, z]: [number, number, number]): [number, number] {\n  const lat = Math.atan2(z, Math.sqrt(x * x + y * y));\n  const lng = Math.atan2(y, x);\n\n  return [lng * RADIAN_TO_DEGREE, lat * RADIAN_TO_DEGREE];\n}\n\nexport function toHilbertQuadkey(idS: string): string {\n  let bin = Long.fromString(idS, true, 10).toString(2);\n\n  while (bin.length < FACE_BITS + POS_BITS) {\n    // eslint-disable-next-line prefer-template\n    bin = '0' + bin;\n  }\n\n  // MUST come AFTER binstr has been left-padded with '0's\n  const lsbIndex = bin.lastIndexOf('1');\n  // substr(start, len)\n  // substring(start, end) // includes start, does not include end\n  const faceB = bin.substring(0, 3);\n  // posB will always be a multiple of 2 (or it's invalid)\n  const posB = bin.substring(3, lsbIndex);\n  const levelN = posB.length / 2;\n\n  const faceS = Long.fromString(faceB, true, 2).toString(10);\n  let posS = Long.fromString(posB, true, 2).toString(4);\n\n  while (posS.length < levelN) {\n    // eslint-disable-next-line prefer-template\n    posS = '0' + posS;\n  }\n\n  return `${faceS}/${posS}`;\n}\n\nfunction rotateAndFlipQuadrant(n: number, point: [number, number], rx: number, ry: number): void {\n  if (ry === 0) {\n    if (rx === 1) {\n      point[0] = n - 1 - point[0];\n      point[1] = n - 1 - point[1];\n    }\n\n    const x = point[0];\n    point[0] = point[1];\n    point[1] = x;\n  }\n}\n\nexport function FromHilbertQuadKey(hilbertQuadkey: string): {\n  face: number;\n  ij: [number, number];\n  level: number;\n} {\n  const parts = hilbertQuadkey.split('/');\n  const face = parseInt(parts[0], 10);\n  const position = parts[1];\n  const maxLevel = position.length;\n  const point = [0, 0] as [number, number];\n  let level;\n\n  for (let i = maxLevel - 1; i >= 0; i--) {\n    level = maxLevel - i;\n    const bit = position[i];\n    let rx = 0;\n    let ry = 0;\n    if (bit === '1') {\n      ry = 1;\n    } else if (bit === '2') {\n      rx = 1;\n      ry = 1;\n    } else if (bit === '3') {\n      rx = 1;\n    }\n\n    const val = Math.pow(2, level - 1);\n    rotateAndFlipQuadrant(val, point, rx, ry);\n\n    point[0] += val * rx;\n    point[1] += val * ry;\n  }\n\n  if (face % 2 === 1) {\n    const t = point[0];\n    point[0] = point[1];\n    point[1] = t;\n  }\n\n  return {face, ij: point, level};\n}\n","// s2-geometry is a pure JavaScript port of Google/Niantic's S2 Geometry library\n// which is perfect since it works in the browser.\nimport {\n  toHilbertQuadkey,\n  FromHilbertQuadKey,\n  IJToST,\n  STToUV,\n  FaceUVToXYZ,\n  XYZToLngLat\n} from './s2-geometry';\nimport Long from 'long';\n\n/**\n * Given an S2 token this function convert the token to 64 bit id\n   https://github.com/google/s2-geometry-library-java/blob/c04b68bf3197a9c34082327eeb3aec7ab7c85da1/src/com/google/common/geometry/S2CellId.java#L439\n * */\nfunction getIdFromToken(token: string): number {\n  // pad token with zeros to make the length 16\n  const paddedToken = token.padEnd(16, '0');\n  return Long.fromString(paddedToken, 16);\n}\n\nconst MAX_RESOLUTION = 100;\n\n/* Adapted from s2-geometry's S2Cell.getCornerLatLngs */\n/* eslint-disable max-statements */\nfunction getGeoBounds({\n  face,\n  ij,\n  level\n}: {\n  face: number;\n  ij: [number, number];\n  level: number;\n}): Float64Array {\n  const offsets = [\n    [0, 0],\n    [0, 1],\n    [1, 1],\n    [1, 0],\n    [0, 0]\n  ];\n\n  // The S2 cell edge is curved: http://s2geometry.io/\n  // This is more prominent at lower levels\n  // resolution is the number of segments to generate per edge.\n  // We exponentially reduce resolution as level increases so it doesn't affect perf\n  // when there are a large number of cells\n  const resolution = Math.max(1, Math.ceil(MAX_RESOLUTION * Math.pow(2, -level)));\n  const result = new Float64Array(4 * resolution * 2 + 2);\n  let ptIndex = 0;\n  let prevLng = 0;\n\n  for (let i = 0; i < 4; i++) {\n    const offset = offsets[i].slice(0) as [number, number];\n    const nextOffset = offsets[i + 1];\n    const stepI = (nextOffset[0] - offset[0]) / resolution;\n    const stepJ = (nextOffset[1] - offset[1]) / resolution;\n\n    for (let j = 0; j < resolution; j++) {\n      offset[0] += stepI;\n      offset[1] += stepJ;\n      // Cell can be represented by coordinates IJ, ST, UV, XYZ\n      // http://s2geometry.io/devguide/s2cell_hierarchy#coordinate-systems\n      const st = IJToST(ij, level, offset);\n      const uv = STToUV(st);\n      const xyz = FaceUVToXYZ(face, uv);\n      const lngLat = XYZToLngLat(xyz);\n\n      // Adjust longitude for Web Mercator projection\n      if (Math.abs(lngLat[1]) > 89.999) {\n        lngLat[0] = prevLng;\n      }\n      const deltaLng = lngLat[0] - prevLng;\n      lngLat[0] += deltaLng > 180 ? -360 : deltaLng < -180 ? 360 : 0;\n\n      result[ptIndex++] = lngLat[0];\n      result[ptIndex++] = lngLat[1];\n      prevLng = lngLat[0];\n    }\n  }\n  // close the loop\n  result[ptIndex++] = result[0];\n  result[ptIndex++] = result[1];\n  return result;\n}\n/* eslint-enable max-statements */\n\nexport function getS2QuadKey(token: string | number): string {\n  if (typeof token === 'string') {\n    if (token.indexOf('/') > 0) {\n      // is Hilbert quad key\n      return token;\n    }\n    // is S2 token\n    token = getIdFromToken(token);\n  }\n  // is Long id\n  return toHilbertQuadkey(token.toString());\n}\n\n/**\n * Get a polygon with corner coordinates for an s2 cell\n * @param {*} cell - This can be an S2 key or token\n * @return {Float64Array} - a simple polygon in flat array format: [lng0, lat0, lng1, lat1, ...]\n *   - the polygon is closed, i.e. last coordinate is a copy of the first coordinate\n */\nexport function getS2Polygon(token: string | number): Float64Array {\n  const key = getS2QuadKey(token);\n  const s2cell = FromHilbertQuadKey(key);\n\n  return getGeoBounds(s2cell);\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {AccessorFunction, DefaultProps} from '@deck.gl/core';\nimport GeoCellLayer, {GeoCellLayerProps} from '../geo-cell-layer/GeoCellLayer';\nimport {getS2Polygon} from './s2-utils';\n\nconst defaultProps: DefaultProps<S2LayerProps> = {\n  getS2Token: {type: 'accessor', value: d => d.token}\n};\n\n/** All properties supported by S2Layer. */\nexport type S2LayerProps<DataT = any> = _S2LayerProps<DataT> & GeoCellLayerProps<DataT>;\n\n/** Properties added by S2Layer. */\ntype _S2LayerProps<DataT> = {\n  /**\n   * Called for each data object to retrieve the quadkey string identifier.\n   *\n   * By default, it reads `token` property of data object.\n   */\n  getS2Token?: AccessorFunction<DataT, string>;\n};\n\n/** Render filled and/or stroked polygons based on the [S2](http://s2geometry.io/) geospatial indexing system. */\nexport default class S2Layer<DataT = any, ExtraProps = {}> extends GeoCellLayer<\n  DataT,\n  Required<_S2LayerProps<DataT>> & ExtraProps\n> {\n  static layerName = 'S2Layer';\n  static defaultProps = defaultProps;\n\n  indexToBounds(): Partial<GeoCellLayer['props']> | null {\n    const {data, getS2Token} = this.props;\n\n    return {\n      data,\n      _normalize: false,\n      positionFormat: 'XY',\n      getPolygon: (x: DataT, objectInfo) => getS2Polygon(getS2Token(x, objectInfo))\n    };\n  }\n}\n","import {worldToLngLat} from '@math.gl/web-mercator';\n\nconst TILE_SIZE = 512;\n\nexport function quadkeyToWorldBounds(quadkey: string): [number[], number[]] {\n  let x = 0;\n  let y = 0;\n  let mask = 1 << quadkey.length;\n  const scale = mask / TILE_SIZE;\n\n  for (let i = 0; i < quadkey.length; i++) {\n    mask >>= 1;\n    const q = parseInt(quadkey[i]);\n    if (q % 2) x |= mask;\n    if (q > 1) y |= mask;\n  }\n  return [\n    [x / scale, TILE_SIZE - y / scale],\n    [(x + 0.99) / scale, TILE_SIZE - (y + 0.99) / scale]\n  ];\n}\n\nexport function getQuadkeyPolygon(quadkey: string): number[] {\n  const [topLeft, bottomRight] = quadkeyToWorldBounds(quadkey);\n  const [w, n] = worldToLngLat(topLeft);\n  const [e, s] = worldToLngLat(bottomRight);\n  return [e, n, e, s, w, s, w, n, e, n];\n}\n","import {AccessorFunction, DefaultProps} from '@deck.gl/core';\nimport GeoCellLayer, {GeoCellLayerProps} from '../geo-cell-layer/GeoCellLayer';\nimport {getQuadkeyPolygon} from './quadkey-utils';\n\nconst defaultProps: DefaultProps<QuadkeyLayerProps> = {\n  getQuadkey: {type: 'accessor', value: d => d.quadkey}\n};\n\n/** All properties supported by QuadkeyLayer. */\nexport type QuadkeyLayerProps<DataT = any> = _QuadkeyLayerProps<DataT> & GeoCellLayerProps<DataT>;\n\n/** Properties added by QuadkeyLayer. */\ntype _QuadkeyLayerProps<DataT> = {\n  /**\n   * Called for each data object to retrieve the quadkey string identifier.\n   *\n   * By default, it reads `quadkey` property of data object.\n   */\n  getQuadkey?: AccessorFunction<DataT, string>;\n};\n\n/** Render filled and/or stroked polygons based on the [Quadkey](https://towardsdatascience.com/geospatial-indexing-with-quadkeys-d933dff01496) geospatial indexing system. */\nexport default class QuadkeyLayer<DataT = any, ExtraProps = {}> extends GeoCellLayer<\n  DataT,\n  Required<_QuadkeyLayerProps<DataT>> & ExtraProps\n> {\n  static layerName = 'QuadkeyLayer';\n  static defaultProps = defaultProps;\n\n  indexToBounds(): Partial<GeoCellLayer['props']> | null {\n    const {data, getQuadkey} = this.props;\n\n    return {\n      data,\n      _normalize: false,\n      positionFormat: 'XY',\n\n      getPolygon: (x: DataT, objectInfo) => getQuadkeyPolygon(getQuadkey(x, objectInfo))\n    };\n  }\n}\n","/* eslint-env browser */\nimport {Layer, log} from '@deck.gl/core';\nimport {RequestScheduler} from '@loaders.gl/loader-utils';\nimport {TileBoundingBox, TileIndex, TileLoadProps} from './types';\n\nexport type TileLoadDataProps<DataT = any> = {\n  requestScheduler: RequestScheduler;\n  getData: (props: TileLoadProps) => Promise<DataT>;\n  onLoad: (tile: Tile2DHeader<DataT>) => void;\n  onError: (error: any, tile: Tile2DHeader<DataT>) => void;\n};\n\nexport default class Tile2DHeader<DataT = any> {\n  index: TileIndex;\n  isVisible: boolean;\n  isSelected: boolean;\n  parent: Tile2DHeader | null;\n  children: Tile2DHeader[] | null;\n  content: DataT | null;\n  state?: number;\n  layers?: Layer[] | null;\n\n  id!: string; // assigned _always_ with result of `getTileId`\n  bbox!: TileBoundingBox; // assigned _always_ with result of `getTileMetadata`\n  zoom!: number; // assigned _always_ with result of `getTileZoom`\n  userData?: Record<string, any>; // _may be_ assigned with result of `getTileMetadata`\n\n  private _abortController: AbortController | null;\n  private _loader: Promise<void> | undefined;\n  private _loaderId: number;\n  private _isLoaded: boolean;\n  private _isCancelled: boolean;\n  private _needsReload: boolean;\n\n  constructor(index: TileIndex) {\n    this.index = index;\n    this.isVisible = false;\n    this.isSelected = false;\n    this.parent = null;\n    this.children = [];\n\n    this.content = null;\n\n    this._loader = undefined;\n    this._abortController = null;\n    this._loaderId = 0;\n    this._isLoaded = false;\n    this._isCancelled = false;\n    this._needsReload = false;\n  }\n\n  get data(): Promise<DataT | null> | DataT | null {\n    return this.isLoading && this._loader ? this._loader.then(() => this.data) : this.content;\n  }\n\n  get isLoaded(): boolean {\n    return this._isLoaded && !this._needsReload;\n  }\n\n  get isLoading(): boolean {\n    return Boolean(this._loader) && !this._isCancelled;\n  }\n\n  get needsReload(): boolean {\n    return this._needsReload || this._isCancelled;\n  }\n\n  get byteLength(): number {\n    const result = this.content ? (this.content as any).byteLength : 0;\n    if (!Number.isFinite(result)) {\n      log.error('byteLength not defined in tile data')();\n    }\n    return result;\n  }\n\n  /* eslint-disable max-statements */\n  private async _loadData({\n    getData,\n    requestScheduler,\n    onLoad,\n    onError\n  }: TileLoadDataProps<DataT>): Promise<void> {\n    const {index, id, bbox, userData, zoom} = this;\n    const loaderId = this._loaderId;\n\n    this._abortController = new AbortController();\n    const {signal} = this._abortController;\n\n    // @ts-expect-error (2345) Argument of type '(tile: any) => 1 | -1' is not assignable ...\n    const requestToken = await requestScheduler.scheduleRequest(this, tile => {\n      return tile.isSelected ? 1 : -1;\n    });\n\n    if (!requestToken) {\n      this._isCancelled = true;\n      return;\n    }\n    // A tile can be cancelled while being scheduled\n    if (this._isCancelled) {\n      requestToken.done();\n      return;\n    }\n\n    let tileData: DataT | null = null;\n    let error;\n    try {\n      tileData = await getData({index, id, bbox, userData, zoom, signal});\n    } catch (err) {\n      error = err || true;\n    } finally {\n      requestToken.done();\n    }\n\n    // If loadData has been called with a newer version, discard the result from this operation\n    if (loaderId !== this._loaderId) {\n      return;\n    }\n    // Clear the `isLoading` flag\n    this._loader = undefined;\n    // Rewrite tile content with the result of getTileData if successful, or `null` in case of\n    // error or cancellation\n    this.content = tileData;\n    // If cancelled, do not invoke the callbacks\n    // Consider it loaded if we tried to cancel but `getTileData` still returned data\n    if (this._isCancelled && !tileData) {\n      this._isLoaded = false;\n      return;\n    }\n    this._isLoaded = true;\n    this._isCancelled = false;\n\n    if (error) {\n      onError(error, this);\n    } else {\n      onLoad(this);\n    }\n  }\n\n  loadData(opts: TileLoadDataProps): Promise<void> {\n    this._isLoaded = false;\n    this._isCancelled = false;\n    this._needsReload = false;\n    this._loaderId++;\n    this._loader = this._loadData(opts);\n    return this._loader;\n  }\n\n  setNeedsReload(): void {\n    if (this.isLoading) {\n      this.abort();\n      this._loader = undefined;\n    }\n    this._needsReload = true;\n  }\n\n  abort(): void {\n    if (this.isLoaded) {\n      return;\n    }\n\n    this._isCancelled = true;\n    this._abortController?.abort();\n  }\n}\n","export const INTERSECTION = {\n  OUTSIDE: -1,\n  INTERSECTING: 0,\n  INSIDE: 1\n};\n//# sourceMappingURL=constants.js.map","export default function _defineProperty(obj, key, value) {\n  if (key in obj) {\n    Object.defineProperty(obj, key, {\n      value: value,\n      enumerable: true,\n      configurable: true,\n      writable: true\n    });\n  } else {\n    obj[key] = value;\n  }\n\n  return obj;\n}","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { Vector3 } from '@math.gl/core';\nimport { INTERSECTION } from '../../constants';\nconst scratchVector = new Vector3();\nconst scratchNormal = new Vector3();\nexport default class AxisAlignedBoundingBox {\n  constructor(minimum = [0, 0, 0], maximum = [0, 0, 0], center) {\n    _defineProperty(this, \"center\", void 0);\n\n    _defineProperty(this, \"halfDiagonal\", void 0);\n\n    _defineProperty(this, \"minimum\", void 0);\n\n    _defineProperty(this, \"maximum\", void 0);\n\n    center = center || scratchVector.copy(minimum).add(maximum).scale(0.5);\n    this.center = new Vector3(center);\n    this.halfDiagonal = new Vector3(maximum).subtract(this.center);\n    this.minimum = new Vector3(minimum);\n    this.maximum = new Vector3(maximum);\n  }\n\n  clone() {\n    return new AxisAlignedBoundingBox(this.minimum, this.maximum, this.center);\n  }\n\n  equals(right) {\n    return this === right || Boolean(right) && this.minimum.equals(right.minimum) && this.maximum.equals(right.maximum);\n  }\n\n  transform(transform) {\n    this.center.transformAsPoint(transform);\n    this.halfDiagonal.transform(transform);\n    this.minimum.transform(transform);\n    this.maximum.transform(transform);\n    return this;\n  }\n\n  intersectPlane(plane) {\n    const {\n      halfDiagonal\n    } = this;\n    const normal = scratchNormal.from(plane.normal);\n    const e = halfDiagonal.x * Math.abs(normal.x) + halfDiagonal.y * Math.abs(normal.y) + halfDiagonal.z * Math.abs(normal.z);\n    const s = this.center.dot(normal) + plane.distance;\n\n    if (s - e > 0) {\n      return INTERSECTION.INSIDE;\n    }\n\n    if (s + e < 0) {\n      return INTERSECTION.OUTSIDE;\n    }\n\n    return INTERSECTION.INTERSECTING;\n  }\n\n  distanceTo(point) {\n    return Math.sqrt(this.distanceSquaredTo(point));\n  }\n\n  distanceSquaredTo(point) {\n    const offset = scratchVector.from(point).subtract(this.center);\n    const {\n      halfDiagonal\n    } = this;\n    let distanceSquared = 0.0;\n    let d;\n    d = Math.abs(offset.x) - halfDiagonal.x;\n\n    if (d > 0) {\n      distanceSquared += d * d;\n    }\n\n    d = Math.abs(offset.y) - halfDiagonal.y;\n\n    if (d > 0) {\n      distanceSquared += d * d;\n    }\n\n    d = Math.abs(offset.z) - halfDiagonal.z;\n\n    if (d > 0) {\n      distanceSquared += d * d;\n    }\n\n    return distanceSquared;\n  }\n\n}\n//# sourceMappingURL=axis-aligned-bounding-box.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { Vector3 } from '@math.gl/core';\nimport * as mat4 from 'gl-matrix/mat4';\nimport { INTERSECTION } from '../../constants';\nconst scratchVector = new Vector3();\nconst scratchVector2 = new Vector3();\nexport default class BoundingSphere {\n  constructor(center = [0, 0, 0], radius = 0.0) {\n    _defineProperty(this, \"center\", void 0);\n\n    _defineProperty(this, \"radius\", void 0);\n\n    this.radius = -0;\n    this.center = new Vector3();\n    this.fromCenterRadius(center, radius);\n  }\n\n  fromCenterRadius(center, radius) {\n    this.center.from(center);\n    this.radius = radius;\n    return this;\n  }\n\n  fromCornerPoints(corner, oppositeCorner) {\n    oppositeCorner = scratchVector.from(oppositeCorner);\n    this.center = new Vector3().from(corner).add(oppositeCorner).scale(0.5);\n    this.radius = this.center.distance(oppositeCorner);\n    return this;\n  }\n\n  equals(right) {\n    return this === right || Boolean(right) && this.center.equals(right.center) && this.radius === right.radius;\n  }\n\n  clone() {\n    return new BoundingSphere(this.center, this.radius);\n  }\n\n  union(boundingSphere) {\n    const leftCenter = this.center;\n    const leftRadius = this.radius;\n    const rightCenter = boundingSphere.center;\n    const rightRadius = boundingSphere.radius;\n    const toRightCenter = scratchVector.copy(rightCenter).subtract(leftCenter);\n    const centerSeparation = toRightCenter.magnitude();\n\n    if (leftRadius >= centerSeparation + rightRadius) {\n      return this.clone();\n    }\n\n    if (rightRadius >= centerSeparation + leftRadius) {\n      return boundingSphere.clone();\n    }\n\n    const halfDistanceBetweenTangentPoints = (leftRadius + centerSeparation + rightRadius) * 0.5;\n    scratchVector2.copy(toRightCenter).scale((-leftRadius + halfDistanceBetweenTangentPoints) / centerSeparation).add(leftCenter);\n    this.center.copy(scratchVector2);\n    this.radius = halfDistanceBetweenTangentPoints;\n    return this;\n  }\n\n  expand(point) {\n    const scratchPoint = scratchVector.from(point);\n    const radius = scratchPoint.subtract(this.center).magnitude();\n\n    if (radius > this.radius) {\n      this.radius = radius;\n    }\n\n    return this;\n  }\n\n  transform(transform) {\n    this.center.transform(transform);\n    const scale = mat4.getScaling(scratchVector, transform);\n    this.radius = Math.max(scale[0], Math.max(scale[1], scale[2])) * this.radius;\n    return this;\n  }\n\n  distanceSquaredTo(point) {\n    const d = this.distanceTo(point);\n    return d * d;\n  }\n\n  distanceTo(point) {\n    const scratchPoint = scratchVector.from(point);\n    const delta = scratchPoint.subtract(this.center);\n    return Math.max(0, delta.len() - this.radius);\n  }\n\n  intersectPlane(plane) {\n    const center = this.center;\n    const radius = this.radius;\n    const normal = plane.normal;\n    const distanceToPlane = normal.dot(center) + plane.distance;\n\n    if (distanceToPlane < -radius) {\n      return INTERSECTION.OUTSIDE;\n    }\n\n    if (distanceToPlane < radius) {\n      return INTERSECTION.INTERSECTING;\n    }\n\n    return INTERSECTION.INSIDE;\n  }\n\n}\n//# sourceMappingURL=bounding-sphere.js.map","import Matrix from './base/matrix';\nimport { checkVector } from '../lib/validators';\nimport { vec4_transformMat3 } from '../lib/gl-matrix-extras';\nimport * as mat3 from 'gl-matrix/mat3';\nimport * as vec2 from 'gl-matrix/vec2';\nimport * as vec3 from 'gl-matrix/vec3';\nvar INDICES;\n\n(function (INDICES) {\n  INDICES[INDICES[\"COL0ROW0\"] = 0] = \"COL0ROW0\";\n  INDICES[INDICES[\"COL0ROW1\"] = 1] = \"COL0ROW1\";\n  INDICES[INDICES[\"COL0ROW2\"] = 2] = \"COL0ROW2\";\n  INDICES[INDICES[\"COL1ROW0\"] = 3] = \"COL1ROW0\";\n  INDICES[INDICES[\"COL1ROW1\"] = 4] = \"COL1ROW1\";\n  INDICES[INDICES[\"COL1ROW2\"] = 5] = \"COL1ROW2\";\n  INDICES[INDICES[\"COL2ROW0\"] = 6] = \"COL2ROW0\";\n  INDICES[INDICES[\"COL2ROW1\"] = 7] = \"COL2ROW1\";\n  INDICES[INDICES[\"COL2ROW2\"] = 8] = \"COL2ROW2\";\n})(INDICES || (INDICES = {}));\n\nconst IDENTITY_MATRIX = Object.freeze([1, 0, 0, 0, 1, 0, 0, 0, 1]);\nexport default class Matrix3 extends Matrix {\n  static get IDENTITY() {\n    return getIdentityMatrix();\n  }\n\n  static get ZERO() {\n    return getZeroMatrix();\n  }\n\n  get ELEMENTS() {\n    return 9;\n  }\n\n  get RANK() {\n    return 3;\n  }\n\n  get INDICES() {\n    return INDICES;\n  }\n\n  constructor(array, ...args) {\n    super(-0, -0, -0, -0, -0, -0, -0, -0, -0);\n\n    if (arguments.length === 1 && Array.isArray(array)) {\n      this.copy(array);\n    } else if (args.length > 0) {\n      this.copy([array, ...args]);\n    } else {\n      this.identity();\n    }\n  }\n\n  copy(array) {\n    this[0] = array[0];\n    this[1] = array[1];\n    this[2] = array[2];\n    this[3] = array[3];\n    this[4] = array[4];\n    this[5] = array[5];\n    this[6] = array[6];\n    this[7] = array[7];\n    this[8] = array[8];\n    return this.check();\n  }\n\n  identity() {\n    return this.copy(IDENTITY_MATRIX);\n  }\n\n  fromObject(object) {\n    return this.check();\n  }\n\n  fromQuaternion(q) {\n    mat3.fromQuat(this, q);\n    return this.check();\n  }\n\n  set(m00, m10, m20, m01, m11, m21, m02, m12, m22) {\n    this[0] = m00;\n    this[1] = m10;\n    this[2] = m20;\n    this[3] = m01;\n    this[4] = m11;\n    this[5] = m21;\n    this[6] = m02;\n    this[7] = m12;\n    this[8] = m22;\n    return this.check();\n  }\n\n  setRowMajor(m00, m01, m02, m10, m11, m12, m20, m21, m22) {\n    this[0] = m00;\n    this[1] = m10;\n    this[2] = m20;\n    this[3] = m01;\n    this[4] = m11;\n    this[5] = m21;\n    this[6] = m02;\n    this[7] = m12;\n    this[8] = m22;\n    return this.check();\n  }\n\n  determinant() {\n    return mat3.determinant(this);\n  }\n\n  transpose() {\n    mat3.transpose(this, this);\n    return this.check();\n  }\n\n  invert() {\n    mat3.invert(this, this);\n    return this.check();\n  }\n\n  multiplyLeft(a) {\n    mat3.multiply(this, a, this);\n    return this.check();\n  }\n\n  multiplyRight(a) {\n    mat3.multiply(this, this, a);\n    return this.check();\n  }\n\n  rotate(radians) {\n    mat3.rotate(this, this, radians);\n    return this.check();\n  }\n\n  scale(factor) {\n    if (Array.isArray(factor)) {\n      mat3.scale(this, this, factor);\n    } else {\n      mat3.scale(this, this, [factor, factor]);\n    }\n\n    return this.check();\n  }\n\n  translate(vec) {\n    mat3.translate(this, this, vec);\n    return this.check();\n  }\n\n  transform(vector, result) {\n    let out;\n\n    switch (vector.length) {\n      case 2:\n        out = vec2.transformMat3(result || [-0, -0], vector, this);\n        break;\n\n      case 3:\n        out = vec3.transformMat3(result || [-0, -0, -0], vector, this);\n        break;\n\n      case 4:\n        out = vec4_transformMat3(result || [-0, -0, -0, -0], vector, this);\n        break;\n\n      default:\n        throw new Error('Illegal vector');\n    }\n\n    checkVector(out, vector.length);\n    return out;\n  }\n\n  transformVector(vector, result) {\n    return this.transform(vector, result);\n  }\n\n  transformVector2(vector, result) {\n    return this.transform(vector, result);\n  }\n\n  transformVector3(vector, result) {\n    return this.transform(vector, result);\n  }\n\n}\nlet ZERO_MATRIX3;\nlet IDENTITY_MATRIX3;\n\nfunction getZeroMatrix() {\n  if (!ZERO_MATRIX3) {\n    ZERO_MATRIX3 = new Matrix3([0, 0, 0, 0, 0, 0, 0, 0, 0]);\n    Object.freeze(ZERO_MATRIX3);\n  }\n\n  return ZERO_MATRIX3;\n}\n\nfunction getIdentityMatrix() {\n  if (!IDENTITY_MATRIX3) {\n    IDENTITY_MATRIX3 = new Matrix3();\n    Object.freeze(IDENTITY_MATRIX3);\n  }\n\n  return IDENTITY_MATRIX3;\n}\n//# sourceMappingURL=matrix3.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { Vector3, Matrix3, Quaternion } from '@math.gl/core';\nimport BoundingSphere from './bounding-sphere';\nimport { INTERSECTION } from '../../constants';\nconst scratchVector3 = new Vector3();\nconst scratchOffset = new Vector3();\nconst scratchVectorU = new Vector3();\nconst scratchVectorV = new Vector3();\nconst scratchVectorW = new Vector3();\nconst scratchCorner = new Vector3();\nconst scratchToCenter = new Vector3();\nconst MATRIX3 = {\n  COLUMN0ROW0: 0,\n  COLUMN0ROW1: 1,\n  COLUMN0ROW2: 2,\n  COLUMN1ROW0: 3,\n  COLUMN1ROW1: 4,\n  COLUMN1ROW2: 5,\n  COLUMN2ROW0: 6,\n  COLUMN2ROW1: 7,\n  COLUMN2ROW2: 8\n};\nexport default class OrientedBoundingBox {\n  constructor(center = [0, 0, 0], halfAxes = [0, 0, 0, 0, 0, 0, 0, 0, 0]) {\n    _defineProperty(this, \"center\", void 0);\n\n    _defineProperty(this, \"halfAxes\", void 0);\n\n    this.center = new Vector3().from(center);\n    this.halfAxes = new Matrix3(halfAxes);\n  }\n\n  get halfSize() {\n    const xAxis = this.halfAxes.getColumn(0);\n    const yAxis = this.halfAxes.getColumn(1);\n    const zAxis = this.halfAxes.getColumn(2);\n    return [new Vector3(xAxis).len(), new Vector3(yAxis).len(), new Vector3(zAxis).len()];\n  }\n\n  get quaternion() {\n    const xAxis = this.halfAxes.getColumn(0);\n    const yAxis = this.halfAxes.getColumn(1);\n    const zAxis = this.halfAxes.getColumn(2);\n    const normXAxis = new Vector3(xAxis).normalize();\n    const normYAxis = new Vector3(yAxis).normalize();\n    const normZAxis = new Vector3(zAxis).normalize();\n    return new Quaternion().fromMatrix3(new Matrix3([...normXAxis, ...normYAxis, ...normZAxis]));\n  }\n\n  fromCenterHalfSizeQuaternion(center, halfSize, quaternion) {\n    const quaternionObject = new Quaternion(quaternion);\n    const directionsMatrix = new Matrix3().fromQuaternion(quaternionObject);\n    directionsMatrix[0] = directionsMatrix[0] * halfSize[0];\n    directionsMatrix[1] = directionsMatrix[1] * halfSize[0];\n    directionsMatrix[2] = directionsMatrix[2] * halfSize[0];\n    directionsMatrix[3] = directionsMatrix[3] * halfSize[1];\n    directionsMatrix[4] = directionsMatrix[4] * halfSize[1];\n    directionsMatrix[5] = directionsMatrix[5] * halfSize[1];\n    directionsMatrix[6] = directionsMatrix[6] * halfSize[2];\n    directionsMatrix[7] = directionsMatrix[7] * halfSize[2];\n    directionsMatrix[8] = directionsMatrix[8] * halfSize[2];\n    this.center = new Vector3().from(center);\n    this.halfAxes = directionsMatrix;\n    return this;\n  }\n\n  clone() {\n    return new OrientedBoundingBox(this.center, this.halfAxes);\n  }\n\n  equals(right) {\n    return this === right || Boolean(right) && this.center.equals(right.center) && this.halfAxes.equals(right.halfAxes);\n  }\n\n  getBoundingSphere(result = new BoundingSphere()) {\n    const halfAxes = this.halfAxes;\n    const u = halfAxes.getColumn(0, scratchVectorU);\n    const v = halfAxes.getColumn(1, scratchVectorV);\n    const w = halfAxes.getColumn(2, scratchVectorW);\n    const cornerVector = scratchVector3.copy(u).add(v).add(w);\n    result.center.copy(this.center);\n    result.radius = cornerVector.magnitude();\n    return result;\n  }\n\n  intersectPlane(plane) {\n    const center = this.center;\n    const normal = plane.normal;\n    const halfAxes = this.halfAxes;\n    const normalX = normal.x;\n    const normalY = normal.y;\n    const normalZ = normal.z;\n    const radEffective = Math.abs(normalX * halfAxes[MATRIX3.COLUMN0ROW0] + normalY * halfAxes[MATRIX3.COLUMN0ROW1] + normalZ * halfAxes[MATRIX3.COLUMN0ROW2]) + Math.abs(normalX * halfAxes[MATRIX3.COLUMN1ROW0] + normalY * halfAxes[MATRIX3.COLUMN1ROW1] + normalZ * halfAxes[MATRIX3.COLUMN1ROW2]) + Math.abs(normalX * halfAxes[MATRIX3.COLUMN2ROW0] + normalY * halfAxes[MATRIX3.COLUMN2ROW1] + normalZ * halfAxes[MATRIX3.COLUMN2ROW2]);\n    const distanceToPlane = normal.dot(center) + plane.distance;\n\n    if (distanceToPlane <= -radEffective) {\n      return INTERSECTION.OUTSIDE;\n    } else if (distanceToPlane >= radEffective) {\n      return INTERSECTION.INSIDE;\n    }\n\n    return INTERSECTION.INTERSECTING;\n  }\n\n  distanceTo(point) {\n    return Math.sqrt(this.distanceSquaredTo(point));\n  }\n\n  distanceSquaredTo(point) {\n    const offset = scratchOffset.from(point).subtract(this.center);\n    const halfAxes = this.halfAxes;\n    const u = halfAxes.getColumn(0, scratchVectorU);\n    const v = halfAxes.getColumn(1, scratchVectorV);\n    const w = halfAxes.getColumn(2, scratchVectorW);\n    const uHalf = u.magnitude();\n    const vHalf = v.magnitude();\n    const wHalf = w.magnitude();\n    u.normalize();\n    v.normalize();\n    w.normalize();\n    let distanceSquared = 0.0;\n    let d;\n    d = Math.abs(offset.dot(u)) - uHalf;\n\n    if (d > 0) {\n      distanceSquared += d * d;\n    }\n\n    d = Math.abs(offset.dot(v)) - vHalf;\n\n    if (d > 0) {\n      distanceSquared += d * d;\n    }\n\n    d = Math.abs(offset.dot(w)) - wHalf;\n\n    if (d > 0) {\n      distanceSquared += d * d;\n    }\n\n    return distanceSquared;\n  }\n\n  computePlaneDistances(position, direction, result = [-0, -0]) {\n    let minDist = Number.POSITIVE_INFINITY;\n    let maxDist = Number.NEGATIVE_INFINITY;\n    const center = this.center;\n    const halfAxes = this.halfAxes;\n    const u = halfAxes.getColumn(0, scratchVectorU);\n    const v = halfAxes.getColumn(1, scratchVectorV);\n    const w = halfAxes.getColumn(2, scratchVectorW);\n    const corner = scratchCorner.copy(u).add(v).add(w).add(center);\n    const toCenter = scratchToCenter.copy(corner).subtract(position);\n    let mag = direction.dot(toCenter);\n    minDist = Math.min(mag, minDist);\n    maxDist = Math.max(mag, maxDist);\n    corner.copy(center).add(u).add(v).subtract(w);\n    toCenter.copy(corner).subtract(position);\n    mag = direction.dot(toCenter);\n    minDist = Math.min(mag, minDist);\n    maxDist = Math.max(mag, maxDist);\n    corner.copy(center).add(u).subtract(v).add(w);\n    toCenter.copy(corner).subtract(position);\n    mag = direction.dot(toCenter);\n    minDist = Math.min(mag, minDist);\n    maxDist = Math.max(mag, maxDist);\n    corner.copy(center).add(u).subtract(v).subtract(w);\n    toCenter.copy(corner).subtract(position);\n    mag = direction.dot(toCenter);\n    minDist = Math.min(mag, minDist);\n    maxDist = Math.max(mag, maxDist);\n    center.copy(corner).subtract(u).add(v).add(w);\n    toCenter.copy(corner).subtract(position);\n    mag = direction.dot(toCenter);\n    minDist = Math.min(mag, minDist);\n    maxDist = Math.max(mag, maxDist);\n    center.copy(corner).subtract(u).add(v).subtract(w);\n    toCenter.copy(corner).subtract(position);\n    mag = direction.dot(toCenter);\n    minDist = Math.min(mag, minDist);\n    maxDist = Math.max(mag, maxDist);\n    center.copy(corner).subtract(u).subtract(v).add(w);\n    toCenter.copy(corner).subtract(position);\n    mag = direction.dot(toCenter);\n    minDist = Math.min(mag, minDist);\n    maxDist = Math.max(mag, maxDist);\n    center.copy(corner).subtract(u).subtract(v).subtract(w);\n    toCenter.copy(corner).subtract(position);\n    mag = direction.dot(toCenter);\n    minDist = Math.min(mag, minDist);\n    maxDist = Math.max(mag, maxDist);\n    result[0] = minDist;\n    result[1] = maxDist;\n    return result;\n  }\n\n  transform(transformation) {\n    this.center.transformAsPoint(transformation);\n    const xAxis = this.halfAxes.getColumn(0, scratchVectorU);\n    xAxis.transformAsPoint(transformation);\n    const yAxis = this.halfAxes.getColumn(1, scratchVectorV);\n    yAxis.transformAsPoint(transformation);\n    const zAxis = this.halfAxes.getColumn(2, scratchVectorW);\n    zAxis.transformAsPoint(transformation);\n    this.halfAxes = new Matrix3([...xAxis, ...yAxis, ...zAxis]);\n    return this;\n  }\n\n  getTransform() {\n    throw new Error('not implemented');\n  }\n\n}\n//# sourceMappingURL=oriented-bounding-box.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { Vector3, equals, assert } from '@math.gl/core';\nconst scratchPosition = new Vector3();\nconst scratchNormal = new Vector3();\nexport default class Plane {\n  constructor(normal = [0, 0, 1], distance = 0) {\n    _defineProperty(this, \"normal\", void 0);\n\n    _defineProperty(this, \"distance\", void 0);\n\n    this.normal = new Vector3();\n    this.distance = -0;\n    this.fromNormalDistance(normal, distance);\n  }\n\n  fromNormalDistance(normal, distance) {\n    assert(Number.isFinite(distance));\n    this.normal.from(normal).normalize();\n    this.distance = distance;\n    return this;\n  }\n\n  fromPointNormal(point, normal) {\n    point = scratchPosition.from(point);\n    this.normal.from(normal).normalize();\n    const distance = -this.normal.dot(point);\n    this.distance = distance;\n    return this;\n  }\n\n  fromCoefficients(a, b, c, d) {\n    this.normal.set(a, b, c);\n    assert(equals(this.normal.len(), 1));\n    this.distance = d;\n    return this;\n  }\n\n  clone() {\n    return new Plane(this.normal, this.distance);\n  }\n\n  equals(right) {\n    return equals(this.distance, right.distance) && equals(this.normal, right.normal);\n  }\n\n  getPointDistance(point) {\n    return this.normal.dot(point) + this.distance;\n  }\n\n  transform(matrix4) {\n    const normal = scratchNormal.copy(this.normal).transformAsVector(matrix4).normalize();\n    const point = this.normal.scale(-this.distance).transform(matrix4);\n    return this.fromPointNormal(point, normal);\n  }\n\n  projectPointOntoPlane(point, result = [0, 0, 0]) {\n    point = scratchPosition.from(point);\n    const pointDistance = this.getPointDistance(point);\n    const scaledNormal = scratchNormal.copy(this.normal).scale(pointDistance);\n    return point.subtract(scaledNormal).to(result);\n  }\n\n}\n//# sourceMappingURL=plane.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { Vector3, assert } from '@math.gl/core';\nimport { INTERSECTION } from '../constants';\nimport Plane from './plane';\nconst faces = [new Vector3([1, 0, 0]), new Vector3([0, 1, 0]), new Vector3([0, 0, 1])];\nconst scratchPlaneCenter = new Vector3();\nconst scratchPlaneNormal = new Vector3();\nconst scratchPlane = new Plane(new Vector3(1.0, 0.0, 0.0), 0.0);\nexport default class CullingVolume {\n  constructor(planes = []) {\n    _defineProperty(this, \"planes\", void 0);\n\n    this.planes = planes;\n  }\n\n  fromBoundingSphere(boundingSphere) {\n    this.planes.length = 2 * faces.length;\n    const center = boundingSphere.center;\n    const radius = boundingSphere.radius;\n    let planeIndex = 0;\n\n    for (const faceNormal of faces) {\n      let plane0 = this.planes[planeIndex];\n      let plane1 = this.planes[planeIndex + 1];\n\n      if (!plane0) {\n        plane0 = this.planes[planeIndex] = new Plane();\n      }\n\n      if (!plane1) {\n        plane1 = this.planes[planeIndex + 1] = new Plane();\n      }\n\n      const plane0Center = scratchPlaneCenter.copy(faceNormal).scale(-radius).add(center);\n      const plane0Distance = -faceNormal.dot(plane0Center);\n      plane0.fromPointNormal(plane0Center, faceNormal);\n      const plane1Center = scratchPlaneCenter.copy(faceNormal).scale(radius).add(center);\n      const negatedFaceNormal = scratchPlaneNormal.copy(faceNormal).negate();\n      const plane1Distance = -negatedFaceNormal.dot(plane1Center);\n      plane1.fromPointNormal(plane1Center, negatedFaceNormal);\n      planeIndex += 2;\n    }\n\n    return this;\n  }\n\n  computeVisibility(boundingVolume) {\n    let intersect = INTERSECTION.INSIDE;\n\n    for (const plane of this.planes) {\n      const result = boundingVolume.intersectPlane(plane);\n\n      switch (result) {\n        case INTERSECTION.OUTSIDE:\n          return INTERSECTION.OUTSIDE;\n\n        case INTERSECTION.INTERSECTING:\n          intersect = INTERSECTION.INTERSECTING;\n          break;\n\n        default:\n      }\n    }\n\n    return intersect;\n  }\n\n  computeVisibilityWithPlaneMask(boundingVolume, parentPlaneMask) {\n    assert(Number.isFinite(parentPlaneMask), 'parentPlaneMask is required.');\n\n    if (parentPlaneMask === CullingVolume.MASK_OUTSIDE || parentPlaneMask === CullingVolume.MASK_INSIDE) {\n      return parentPlaneMask;\n    }\n\n    let mask = CullingVolume.MASK_INSIDE;\n    const planes = this.planes;\n\n    for (let k = 0; k < this.planes.length; ++k) {\n      const flag = k < 31 ? 1 << k : 0;\n\n      if (k < 31 && (parentPlaneMask & flag) === 0) {\n        continue;\n      }\n\n      const plane = planes[k];\n      const result = boundingVolume.intersectPlane(plane);\n\n      if (result === INTERSECTION.OUTSIDE) {\n        return CullingVolume.MASK_OUTSIDE;\n      } else if (result === INTERSECTION.INTERSECTING) {\n        mask |= flag;\n      }\n    }\n\n    return mask;\n  }\n\n}\n\n_defineProperty(CullingVolume, \"MASK_OUTSIDE\", 0xffffffff);\n\n_defineProperty(CullingVolume, \"MASK_INSIDE\", 0x00000000);\n\n_defineProperty(CullingVolume, \"MASK_INDETERMINATE\", 0x7fffffff);\n//# sourceMappingURL=culling-volume.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { Vector3, Matrix4, assert } from '@math.gl/core';\nimport CullingVolume from './culling-volume';\nimport Plane from './plane';\nconst scratchPlaneUpVector = new Vector3();\nconst scratchPlaneRightVector = new Vector3();\nconst scratchPlaneNearCenter = new Vector3();\nconst scratchPlaneFarCenter = new Vector3();\nconst scratchPlaneNormal = new Vector3();\nexport default class PerspectiveOffCenterFrustum {\n  constructor(options = {}) {\n    _defineProperty(this, \"left\", void 0);\n\n    _defineProperty(this, \"_left\", void 0);\n\n    _defineProperty(this, \"right\", void 0);\n\n    _defineProperty(this, \"_right\", void 0);\n\n    _defineProperty(this, \"top\", void 0);\n\n    _defineProperty(this, \"_top\", void 0);\n\n    _defineProperty(this, \"bottom\", void 0);\n\n    _defineProperty(this, \"_bottom\", void 0);\n\n    _defineProperty(this, \"near\", void 0);\n\n    _defineProperty(this, \"_near\", void 0);\n\n    _defineProperty(this, \"far\", void 0);\n\n    _defineProperty(this, \"_far\", void 0);\n\n    _defineProperty(this, \"_cullingVolume\", new CullingVolume([new Plane(), new Plane(), new Plane(), new Plane(), new Plane(), new Plane()]));\n\n    _defineProperty(this, \"_perspectiveMatrix\", new Matrix4());\n\n    _defineProperty(this, \"_infinitePerspective\", new Matrix4());\n\n    const {\n      near = 1.0,\n      far = 500000000.0\n    } = options;\n    this.left = options.left;\n    this._left = undefined;\n    this.right = options.right;\n    this._right = undefined;\n    this.top = options.top;\n    this._top = undefined;\n    this.bottom = options.bottom;\n    this._bottom = undefined;\n    this.near = near;\n    this._near = near;\n    this.far = far;\n    this._far = far;\n  }\n\n  clone() {\n    return new PerspectiveOffCenterFrustum({\n      right: this.right,\n      left: this.left,\n      top: this.top,\n      bottom: this.bottom,\n      near: this.near,\n      far: this.far\n    });\n  }\n\n  equals(other) {\n    return other && other instanceof PerspectiveOffCenterFrustum && this.right === other.right && this.left === other.left && this.top === other.top && this.bottom === other.bottom && this.near === other.near && this.far === other.far;\n  }\n\n  get projectionMatrix() {\n    this._update();\n\n    return this._perspectiveMatrix;\n  }\n\n  get infiniteProjectionMatrix() {\n    this._update();\n\n    return this._infinitePerspective;\n  }\n\n  computeCullingVolume(position, direction, up) {\n    assert(position, 'position is required.');\n    assert(direction, 'direction is required.');\n    assert(up, 'up is required.');\n    const planes = this._cullingVolume.planes;\n    up = scratchPlaneUpVector.copy(up).normalize();\n    const right = scratchPlaneRightVector.copy(direction).cross(up).normalize();\n    const nearCenter = scratchPlaneNearCenter.copy(direction).multiplyByScalar(this.near).add(position);\n    const farCenter = scratchPlaneFarCenter.copy(direction).multiplyByScalar(this.far).add(position);\n    let normal = scratchPlaneNormal;\n    normal.copy(right).multiplyByScalar(this.left).add(nearCenter).subtract(position).cross(up);\n    planes[0].fromPointNormal(position, normal);\n    normal.copy(right).multiplyByScalar(this.right).add(nearCenter).subtract(position).cross(up).negate();\n    planes[1].fromPointNormal(position, normal);\n    normal.copy(up).multiplyByScalar(this.bottom).add(nearCenter).subtract(position).cross(right).negate();\n    planes[2].fromPointNormal(position, normal);\n    normal.copy(up).multiplyByScalar(this.top).add(nearCenter).subtract(position).cross(right);\n    planes[3].fromPointNormal(position, normal);\n    normal = new Vector3().copy(direction);\n    planes[4].fromPointNormal(nearCenter, normal);\n    normal.negate();\n    planes[5].fromPointNormal(farCenter, normal);\n    return this._cullingVolume;\n  }\n\n  getPixelDimensions(drawingBufferWidth, drawingBufferHeight, distance, result) {\n    this._update();\n\n    assert(Number.isFinite(drawingBufferWidth) && Number.isFinite(drawingBufferHeight));\n    assert(drawingBufferWidth > 0);\n    assert(drawingBufferHeight > 0);\n    assert(distance > 0);\n    assert(result);\n    const inverseNear = 1.0 / this.near;\n    let tanTheta = this.top * inverseNear;\n    const pixelHeight = 2.0 * distance * tanTheta / drawingBufferHeight;\n    tanTheta = this.right * inverseNear;\n    const pixelWidth = 2.0 * distance * tanTheta / drawingBufferWidth;\n    result.x = pixelWidth;\n    result.y = pixelHeight;\n    return result;\n  }\n\n  _update() {\n    assert(Number.isFinite(this.right) && Number.isFinite(this.left) && Number.isFinite(this.top) && Number.isFinite(this.bottom) && Number.isFinite(this.near) && Number.isFinite(this.far));\n    const {\n      top,\n      bottom,\n      right,\n      left,\n      near,\n      far\n    } = this;\n\n    if (top !== this._top || bottom !== this._bottom || left !== this._left || right !== this._right || near !== this._near || far !== this._far) {\n      assert(this.near > 0 && this.near < this.far, 'near must be greater than zero and less than far.');\n      this._left = left;\n      this._right = right;\n      this._top = top;\n      this._bottom = bottom;\n      this._near = near;\n      this._far = far;\n      this._perspectiveMatrix = new Matrix4().frustum({\n        left,\n        right,\n        bottom,\n        top,\n        near,\n        far\n      });\n      this._infinitePerspective = new Matrix4().frustum({\n        left,\n        right,\n        bottom,\n        top,\n        near,\n        far: Infinity\n      });\n    }\n  }\n\n}\n//# sourceMappingURL=perspective-off-center-frustum.js.map","import { Vector3 } from '@math.gl/core';\nimport BoundingSphere from '../bounding-volumes/bounding-sphere';\nconst fromPointsXMin = new Vector3();\nconst fromPointsYMin = new Vector3();\nconst fromPointsZMin = new Vector3();\nconst fromPointsXMax = new Vector3();\nconst fromPointsYMax = new Vector3();\nconst fromPointsZMax = new Vector3();\nconst fromPointsCurrentPos = new Vector3();\nconst fromPointsScratch = new Vector3();\nconst fromPointsRitterCenter = new Vector3();\nconst fromPointsMinBoxPt = new Vector3();\nconst fromPointsMaxBoxPt = new Vector3();\nconst fromPointsNaiveCenterScratch = new Vector3();\nconst volumeConstant = 4.0 / 3.0 * Math.PI;\nexport default function makeBoundingSphereFromPoints(positions, result = new BoundingSphere()) {\n  if (!positions || positions.length === 0) {\n    return result.fromCenterRadius([0, 0, 0], 0);\n  }\n\n  const currentPos = fromPointsCurrentPos.copy(positions[0]);\n  const xMin = fromPointsXMin.copy(currentPos);\n  const yMin = fromPointsYMin.copy(currentPos);\n  const zMin = fromPointsZMin.copy(currentPos);\n  const xMax = fromPointsXMax.copy(currentPos);\n  const yMax = fromPointsYMax.copy(currentPos);\n  const zMax = fromPointsZMax.copy(currentPos);\n\n  for (const position of positions) {\n    currentPos.copy(position);\n    const x = currentPos.x;\n    const y = currentPos.y;\n    const z = currentPos.z;\n\n    if (x < xMin.x) {\n      xMin.copy(currentPos);\n    }\n\n    if (x > xMax.x) {\n      xMax.copy(currentPos);\n    }\n\n    if (y < yMin.y) {\n      yMin.copy(currentPos);\n    }\n\n    if (y > yMax.y) {\n      yMax.copy(currentPos);\n    }\n\n    if (z < zMin.z) {\n      zMin.copy(currentPos);\n    }\n\n    if (z > zMax.z) {\n      zMax.copy(currentPos);\n    }\n  }\n\n  const xSpan = fromPointsScratch.copy(xMax).subtract(xMin).magnitudeSquared();\n  const ySpan = fromPointsScratch.copy(yMax).subtract(yMin).magnitudeSquared();\n  const zSpan = fromPointsScratch.copy(zMax).subtract(zMin).magnitudeSquared();\n  let diameter1 = xMin;\n  let diameter2 = xMax;\n  let maxSpan = xSpan;\n\n  if (ySpan > maxSpan) {\n    maxSpan = ySpan;\n    diameter1 = yMin;\n    diameter2 = yMax;\n  }\n\n  if (zSpan > maxSpan) {\n    maxSpan = zSpan;\n    diameter1 = zMin;\n    diameter2 = zMax;\n  }\n\n  const ritterCenter = fromPointsRitterCenter;\n  ritterCenter.x = (diameter1.x + diameter2.x) * 0.5;\n  ritterCenter.y = (diameter1.y + diameter2.y) * 0.5;\n  ritterCenter.z = (diameter1.z + diameter2.z) * 0.5;\n  let radiusSquared = fromPointsScratch.copy(diameter2).subtract(ritterCenter).magnitudeSquared();\n  let ritterRadius = Math.sqrt(radiusSquared);\n  const minBoxPt = fromPointsMinBoxPt;\n  minBoxPt.x = xMin.x;\n  minBoxPt.y = yMin.y;\n  minBoxPt.z = zMin.z;\n  const maxBoxPt = fromPointsMaxBoxPt;\n  maxBoxPt.x = xMax.x;\n  maxBoxPt.y = yMax.y;\n  maxBoxPt.z = zMax.z;\n  const naiveCenter = fromPointsNaiveCenterScratch.copy(minBoxPt).add(maxBoxPt).multiplyByScalar(0.5);\n  let naiveRadius = 0;\n\n  for (const position of positions) {\n    currentPos.copy(position);\n    const r = fromPointsScratch.copy(currentPos).subtract(naiveCenter).magnitude();\n\n    if (r > naiveRadius) {\n      naiveRadius = r;\n    }\n\n    const oldCenterToPointSquared = fromPointsScratch.copy(currentPos).subtract(ritterCenter).magnitudeSquared();\n\n    if (oldCenterToPointSquared > radiusSquared) {\n      const oldCenterToPoint = Math.sqrt(oldCenterToPointSquared);\n      ritterRadius = (ritterRadius + oldCenterToPoint) * 0.5;\n      radiusSquared = ritterRadius * ritterRadius;\n      const oldToNew = oldCenterToPoint - ritterRadius;\n      ritterCenter.x = (ritterRadius * ritterCenter.x + oldToNew * currentPos.x) / oldCenterToPoint;\n      ritterCenter.y = (ritterRadius * ritterCenter.y + oldToNew * currentPos.y) / oldCenterToPoint;\n      ritterCenter.z = (ritterRadius * ritterCenter.z + oldToNew * currentPos.z) / oldCenterToPoint;\n    }\n  }\n\n  if (ritterRadius < naiveRadius) {\n    ritterCenter.to(result.center);\n    result.radius = ritterRadius;\n  } else {\n    naiveCenter.to(result.center);\n    result.radius = naiveRadius;\n  }\n\n  return result;\n}\n//# sourceMappingURL=bounding-sphere-from-points.js.map","export default {\n  EPSILON1: 1e-1,\n  EPSILON2: 1e-2,\n  EPSILON3: 1e-3,\n  EPSILON4: 1e-4,\n  EPSILON5: 1e-5,\n  EPSILON6: 1e-6,\n  EPSILON7: 1e-7,\n  EPSILON8: 1e-8,\n  EPSILON9: 1e-9,\n  EPSILON10: 1e-10,\n  EPSILON11: 1e-11,\n  EPSILON12: 1e-12,\n  EPSILON13: 1e-13,\n  EPSILON14: 1e-14,\n  EPSILON15: 1e-15,\n  EPSILON16: 1e-16,\n  EPSILON17: 1e-17,\n  EPSILON18: 1e-18,\n  EPSILON19: 1e-19,\n  EPSILON20: 1e-20,\n  PI_OVER_TWO: Math.PI / 2,\n  PI_OVER_FOUR: Math.PI / 4,\n  PI_OVER_SIX: Math.PI / 6,\n  TWO_PI: Math.PI * 2\n};\n//# sourceMappingURL=math-utils.js.map","import { Matrix3, _MathUtils } from '@math.gl/core';\nconst scratchMatrix = new Matrix3();\nconst scratchUnitary = new Matrix3();\nconst scratchDiagonal = new Matrix3();\nconst jMatrix = new Matrix3();\nconst jMatrixTranspose = new Matrix3();\nexport default function computeEigenDecomposition(matrix, result = {}) {\n  const EIGEN_TOLERANCE = _MathUtils.EPSILON20;\n  const EIGEN_MAX_SWEEPS = 10;\n  let count = 0;\n  let sweep = 0;\n  const unitaryMatrix = scratchUnitary;\n  const diagonalMatrix = scratchDiagonal;\n  unitaryMatrix.identity();\n  diagonalMatrix.copy(matrix);\n  const epsilon = EIGEN_TOLERANCE * computeFrobeniusNorm(diagonalMatrix);\n\n  while (sweep < EIGEN_MAX_SWEEPS && offDiagonalFrobeniusNorm(diagonalMatrix) > epsilon) {\n    shurDecomposition(diagonalMatrix, jMatrix);\n    jMatrixTranspose.copy(jMatrix).transpose();\n    diagonalMatrix.multiplyRight(jMatrix);\n    diagonalMatrix.multiplyLeft(jMatrixTranspose);\n    unitaryMatrix.multiplyRight(jMatrix);\n\n    if (++count > 2) {\n      ++sweep;\n      count = 0;\n    }\n  }\n\n  result.unitary = unitaryMatrix.toTarget(result.unitary);\n  result.diagonal = diagonalMatrix.toTarget(result.diagonal);\n  return result;\n}\n\nfunction computeFrobeniusNorm(matrix) {\n  let norm = 0.0;\n\n  for (let i = 0; i < 9; ++i) {\n    const temp = matrix[i];\n    norm += temp * temp;\n  }\n\n  return Math.sqrt(norm);\n}\n\nconst rowVal = [1, 0, 0];\nconst colVal = [2, 2, 1];\n\nfunction offDiagonalFrobeniusNorm(matrix) {\n  let norm = 0.0;\n\n  for (let i = 0; i < 3; ++i) {\n    const temp = matrix[scratchMatrix.getElementIndex(colVal[i], rowVal[i])];\n    norm += 2.0 * temp * temp;\n  }\n\n  return Math.sqrt(norm);\n}\n\nfunction shurDecomposition(matrix, result) {\n  const tolerance = _MathUtils.EPSILON15;\n  let maxDiagonal = 0.0;\n  let rotAxis = 1;\n\n  for (let i = 0; i < 3; ++i) {\n    const temp = Math.abs(matrix[scratchMatrix.getElementIndex(colVal[i], rowVal[i])]);\n\n    if (temp > maxDiagonal) {\n      rotAxis = i;\n      maxDiagonal = temp;\n    }\n  }\n\n  const p = rowVal[rotAxis];\n  const q = colVal[rotAxis];\n  let c = 1.0;\n  let s = 0.0;\n\n  if (Math.abs(matrix[scratchMatrix.getElementIndex(q, p)]) > tolerance) {\n    const qq = matrix[scratchMatrix.getElementIndex(q, q)];\n    const pp = matrix[scratchMatrix.getElementIndex(p, p)];\n    const qp = matrix[scratchMatrix.getElementIndex(q, p)];\n    const tau = (qq - pp) / 2.0 / qp;\n    let t;\n\n    if (tau < 0.0) {\n      t = -1.0 / (-tau + Math.sqrt(1.0 + tau * tau));\n    } else {\n      t = 1.0 / (tau + Math.sqrt(1.0 + tau * tau));\n    }\n\n    c = 1.0 / Math.sqrt(1.0 + t * t);\n    s = t * c;\n  }\n\n  Matrix3.IDENTITY.to(result);\n  result[scratchMatrix.getElementIndex(p, p)] = result[scratchMatrix.getElementIndex(q, q)] = c;\n  result[scratchMatrix.getElementIndex(q, p)] = s;\n  result[scratchMatrix.getElementIndex(p, q)] = -s;\n  return result;\n}\n//# sourceMappingURL=compute-eigen-decomposition.js.map","import { Vector3, Matrix3 } from '@math.gl/core';\nimport computeEigenDecomposition from './compute-eigen-decomposition';\nimport OrientedBoundingBox from '../bounding-volumes/oriented-bounding-box';\nimport AxisAlignedBoundingBox from '../bounding-volumes/axis-aligned-bounding-box';\nconst scratchVector2 = new Vector3();\nconst scratchVector3 = new Vector3();\nconst scratchVector4 = new Vector3();\nconst scratchVector5 = new Vector3();\nconst scratchVector6 = new Vector3();\nconst scratchCovarianceResult = new Matrix3();\nconst scratchEigenResult = {\n  diagonal: new Matrix3(),\n  unitary: new Matrix3()\n};\nexport function makeOrientedBoundingBoxFromPoints(positions, result = new OrientedBoundingBox()) {\n  if (!positions || positions.length === 0) {\n    result.halfAxes = new Matrix3([0, 0, 0, 0, 0, 0, 0, 0, 0]);\n    result.center = new Vector3();\n    return result;\n  }\n\n  const length = positions.length;\n  const meanPoint = new Vector3(0, 0, 0);\n\n  for (const position of positions) {\n    meanPoint.add(position);\n  }\n\n  const invLength = 1.0 / length;\n  meanPoint.multiplyByScalar(invLength);\n  let exx = 0.0;\n  let exy = 0.0;\n  let exz = 0.0;\n  let eyy = 0.0;\n  let eyz = 0.0;\n  let ezz = 0.0;\n\n  for (const position of positions) {\n    const p = scratchVector2.copy(position).subtract(meanPoint);\n    exx += p.x * p.x;\n    exy += p.x * p.y;\n    exz += p.x * p.z;\n    eyy += p.y * p.y;\n    eyz += p.y * p.z;\n    ezz += p.z * p.z;\n  }\n\n  exx *= invLength;\n  exy *= invLength;\n  exz *= invLength;\n  eyy *= invLength;\n  eyz *= invLength;\n  ezz *= invLength;\n  const covarianceMatrix = scratchCovarianceResult;\n  covarianceMatrix[0] = exx;\n  covarianceMatrix[1] = exy;\n  covarianceMatrix[2] = exz;\n  covarianceMatrix[3] = exy;\n  covarianceMatrix[4] = eyy;\n  covarianceMatrix[5] = eyz;\n  covarianceMatrix[6] = exz;\n  covarianceMatrix[7] = eyz;\n  covarianceMatrix[8] = ezz;\n  const {\n    unitary\n  } = computeEigenDecomposition(covarianceMatrix, scratchEigenResult);\n  const rotation = result.halfAxes.copy(unitary);\n  let v1 = rotation.getColumn(0, scratchVector4);\n  let v2 = rotation.getColumn(1, scratchVector5);\n  let v3 = rotation.getColumn(2, scratchVector6);\n  let u1 = -Number.MAX_VALUE;\n  let u2 = -Number.MAX_VALUE;\n  let u3 = -Number.MAX_VALUE;\n  let l1 = Number.MAX_VALUE;\n  let l2 = Number.MAX_VALUE;\n  let l3 = Number.MAX_VALUE;\n\n  for (const position of positions) {\n    scratchVector2.copy(position);\n    u1 = Math.max(scratchVector2.dot(v1), u1);\n    u2 = Math.max(scratchVector2.dot(v2), u2);\n    u3 = Math.max(scratchVector2.dot(v3), u3);\n    l1 = Math.min(scratchVector2.dot(v1), l1);\n    l2 = Math.min(scratchVector2.dot(v2), l2);\n    l3 = Math.min(scratchVector2.dot(v3), l3);\n  }\n\n  v1 = v1.multiplyByScalar(0.5 * (l1 + u1));\n  v2 = v2.multiplyByScalar(0.5 * (l2 + u2));\n  v3 = v3.multiplyByScalar(0.5 * (l3 + u3));\n  result.center.copy(v1).add(v2).add(v3);\n  const scale = scratchVector3.set(u1 - l1, u2 - l2, u3 - l3).multiplyByScalar(0.5);\n  const scaleMatrix = new Matrix3([scale[0], 0, 0, 0, scale[1], 0, 0, 0, scale[2]]);\n  result.halfAxes.multiplyRight(scaleMatrix);\n  return result;\n}\nexport function makeAxisAlignedBoundingBoxFromPoints(positions, result = new AxisAlignedBoundingBox()) {\n  if (!positions || positions.length === 0) {\n    result.minimum.set(0, 0, 0);\n    result.maximum.set(0, 0, 0);\n    result.center.set(0, 0, 0);\n    result.halfDiagonal.set(0, 0, 0);\n    return result;\n  }\n\n  let minimumX = positions[0][0];\n  let minimumY = positions[0][1];\n  let minimumZ = positions[0][2];\n  let maximumX = positions[0][0];\n  let maximumY = positions[0][1];\n  let maximumZ = positions[0][2];\n\n  for (const p of positions) {\n    const x = p[0];\n    const y = p[1];\n    const z = p[2];\n    minimumX = Math.min(x, minimumX);\n    maximumX = Math.max(x, maximumX);\n    minimumY = Math.min(y, minimumY);\n    maximumY = Math.max(y, maximumY);\n    minimumZ = Math.min(z, minimumZ);\n    maximumZ = Math.max(z, maximumZ);\n  }\n\n  result.minimum.set(minimumX, minimumY, minimumZ);\n  result.maximum.set(maximumX, maximumY, maximumZ);\n  result.center.copy(result.minimum).add(result.maximum).scale(0.5);\n  result.halfDiagonal.copy(result.maximum).subtract(result.center);\n  return result;\n}\n//# sourceMappingURL=bounding-box-from-points.js.map","/* eslint-disable complexity */\nimport {Viewport, WebMercatorViewport, _GlobeViewport} from '@deck.gl/core';\nimport {\n  CullingVolume,\n  Plane,\n  AxisAlignedBoundingBox,\n  makeOrientedBoundingBoxFromPoints\n} from '@math.gl/culling';\nimport {lngLatToWorld} from '@math.gl/web-mercator';\nimport {Bounds, TileIndex, ZRange} from './types';\nimport {osmTile2lngLat} from './utils';\n\nconst TILE_SIZE = 512;\n// number of world copies to check\nconst MAX_MAPS = 3;\n// for calculating bounding volume of a tile in a non-web-mercator viewport\nconst REF_POINTS_5 = [\n  [0.5, 0.5],\n  [0, 0],\n  [0, 1],\n  [1, 0],\n  [1, 1]\n]; // 4 corners and center\nconst REF_POINTS_9 = REF_POINTS_5.concat([\n  [0, 0.5],\n  [0.5, 0],\n  [1, 0.5],\n  [0.5, 1]\n]); // 4 corners, center and 4 mid points\nconst REF_POINTS_11 = REF_POINTS_9.concat([\n  [0.25, 0.5],\n  [0.75, 0.5]\n]); // 2 additional points on equator for top tile\n\nclass OSMNode {\n  x: number;\n  y: number;\n  z: number;\n\n  private childVisible?: boolean;\n  private selected?: boolean;\n\n  private _children?: OSMNode[];\n\n  constructor(x, y, z) {\n    this.x = x;\n    this.y = y;\n    this.z = z;\n  }\n\n  get children() {\n    if (!this._children) {\n      const x = this.x * 2;\n      const y = this.y * 2;\n      const z = this.z + 1;\n      this._children = [\n        new OSMNode(x, y, z),\n        new OSMNode(x, y + 1, z),\n        new OSMNode(x + 1, y, z),\n        new OSMNode(x + 1, y + 1, z)\n      ];\n    }\n    return this._children;\n  }\n\n  update(params: {\n    viewport: Viewport;\n    project: ((xyz: number[]) => number[]) | null;\n    cullingVolume: CullingVolume;\n    elevationBounds: ZRange;\n    minZ: number;\n    maxZ: number;\n    bounds?: Bounds;\n    offset: number;\n  }) {\n    const {viewport, cullingVolume, elevationBounds, minZ, maxZ, bounds, offset, project} = params;\n    const boundingVolume = this.getBoundingVolume(elevationBounds, offset, project);\n\n    // First, check if this tile is visible\n    if (bounds && !this.insideBounds(bounds)) {\n      return false;\n    }\n\n    const isInside = cullingVolume.computeVisibility(boundingVolume);\n    if (isInside < 0) {\n      return false;\n    }\n\n    // Avoid loading overlapping tiles - if a descendant is requested, do not request the ancester\n    if (!this.childVisible) {\n      let {z} = this;\n      if (z < maxZ && z >= minZ) {\n        // Adjust LOD\n        // If the tile is far enough from the camera, accept a lower zoom level\n        const distance =\n          (boundingVolume.distanceTo(viewport.cameraPosition) * viewport.scale) / viewport.height;\n        z += Math.floor(Math.log2(distance));\n      }\n      if (z >= maxZ) {\n        // LOD is acceptable\n        this.selected = true;\n        return true;\n      }\n    }\n\n    // LOD is not enough, recursively test child tiles\n    this.selected = false;\n    this.childVisible = true;\n    for (const child of this.children) {\n      child.update(params);\n    }\n    return true;\n  }\n\n  getSelected(result: OSMNode[] = []): OSMNode[] {\n    if (this.selected) {\n      result.push(this);\n    }\n    if (this._children) {\n      for (const node of this._children) {\n        node.getSelected(result);\n      }\n    }\n    return result;\n  }\n\n  insideBounds([minX, minY, maxX, maxY]: Bounds): boolean {\n    const scale = Math.pow(2, this.z);\n    const extent = TILE_SIZE / scale;\n\n    return (\n      this.x * extent < maxX &&\n      this.y * extent < maxY &&\n      (this.x + 1) * extent > minX &&\n      (this.y + 1) * extent > minY\n    );\n  }\n\n  getBoundingVolume(\n    zRange: ZRange,\n    worldOffset: number,\n    project: ((xyz: number[]) => number[]) | null\n  ) {\n    if (project) {\n      // Custom projection\n      // Estimate bounding box from sample points\n      // At low zoom level we need more samples to calculate the bounding volume correctly\n      const refPoints = this.z < 1 ? REF_POINTS_11 : this.z < 2 ? REF_POINTS_9 : REF_POINTS_5;\n\n      // Convert from tile-relative coordinates to common space\n      const refPointPositions: number[][] = [];\n      for (const p of refPoints) {\n        const lngLat: number[] = osmTile2lngLat(this.x + p[0], this.y + p[1], this.z);\n        lngLat[2] = zRange[0];\n        refPointPositions.push(project(lngLat));\n\n        if (zRange[0] !== zRange[1]) {\n          // Account for the elevation volume\n          lngLat[2] = zRange[1];\n          refPointPositions.push(project(lngLat));\n        }\n      }\n\n      return makeOrientedBoundingBoxFromPoints(refPointPositions);\n    }\n\n    // Use WebMercator projection\n    const scale = Math.pow(2, this.z);\n    const extent = TILE_SIZE / scale;\n    const originX = this.x * extent + worldOffset * TILE_SIZE;\n    // deck's common space is y-flipped\n    const originY = TILE_SIZE - (this.y + 1) * extent;\n\n    return new AxisAlignedBoundingBox(\n      [originX, originY, zRange[0]],\n      [originX + extent, originY + extent, zRange[1]]\n    );\n  }\n}\n\nexport function getOSMTileIndices(\n  viewport: Viewport,\n  maxZ: number,\n  zRange: ZRange | undefined,\n  bounds?: Bounds\n): TileIndex[] {\n  const project: ((xyz: number[]) => number[]) | null =\n    viewport instanceof _GlobeViewport && viewport.resolution\n      ? // eslint-disable-next-line @typescript-eslint/unbound-method\n        viewport.projectPosition\n      : null;\n\n  // Get the culling volume of the current camera\n  const planes: Plane[] = Object.values(viewport.getFrustumPlanes()).map(\n    ({normal, distance}) => new Plane(normal.clone().negate(), distance)\n  );\n  const cullingVolume = new CullingVolume(planes);\n\n  // Project zRange from meters to common space\n  const unitsPerMeter = viewport.distanceScales.unitsPerMeter[2];\n  const elevationMin = (zRange && zRange[0] * unitsPerMeter) || 0;\n  const elevationMax = (zRange && zRange[1] * unitsPerMeter) || 0;\n\n  // Always load at the current zoom level if pitch is small\n  const minZ = viewport instanceof WebMercatorViewport && viewport.pitch <= 60 ? maxZ : 0;\n\n  // Map extent to OSM position\n  if (bounds) {\n    const [minLng, minLat, maxLng, maxLat] = bounds;\n    const topLeft = lngLatToWorld([minLng, maxLat]);\n    const bottomRight = lngLatToWorld([maxLng, minLat]);\n    bounds = [topLeft[0], TILE_SIZE - topLeft[1], bottomRight[0], TILE_SIZE - bottomRight[1]];\n  }\n\n  const root = new OSMNode(0, 0, 0);\n  const traversalParams = {\n    viewport,\n    project,\n    cullingVolume,\n    elevationBounds: [elevationMin, elevationMax] as ZRange,\n    minZ,\n    maxZ,\n    bounds,\n    // num. of worlds from the center. For repeated maps\n    offset: 0\n  };\n\n  root.update(traversalParams);\n\n  if (\n    viewport instanceof WebMercatorViewport &&\n    viewport.subViewports &&\n    viewport.subViewports.length > 1\n  ) {\n    // Check worlds in repeated maps\n    traversalParams.offset = -1;\n    while (root.update(traversalParams)) {\n      if (--traversalParams.offset < -MAX_MAPS) {\n        break;\n      }\n    }\n    traversalParams.offset = 1;\n    while (root.update(traversalParams)) {\n      if (++traversalParams.offset > MAX_MAPS) {\n        break;\n      }\n    }\n  }\n\n  return root.getSelected();\n}\n","import {Viewport} from '@deck.gl/core';\nimport {Matrix4} from '@math.gl/core';\nimport {getOSMTileIndices} from './tile-2d-traversal';\nimport {Bounds, GeoBoundingBox, TileBoundingBox, TileIndex, ZRange} from './types';\n\nconst TILE_SIZE = 512;\nconst DEFAULT_EXTENT: Bounds = [-Infinity, -Infinity, Infinity, Infinity];\n\nexport const urlType = {\n  type: 'url',\n  value: null,\n  validate: (value, propType) =>\n    (propType.optional && value === null) ||\n    typeof value === 'string' ||\n    (Array.isArray(value) && value.every(url => typeof url === 'string')),\n  equals: (value1, value2) => {\n    if (value1 === value2) {\n      return true;\n    }\n    if (!Array.isArray(value1) || !Array.isArray(value2)) {\n      return false;\n    }\n    const len = value1.length;\n    if (len !== value2.length) {\n      return false;\n    }\n    for (let i = 0; i < len; i++) {\n      if (value1[i] !== value2[i]) {\n        return false;\n      }\n    }\n    return true;\n  }\n};\n\nfunction transformBox(bbox: Bounds, modelMatrix: Matrix4): Bounds {\n  const transformedCoords = [\n    // top-left\n    modelMatrix.transformAsPoint([bbox[0], bbox[1]]),\n    // top-right\n    modelMatrix.transformAsPoint([bbox[2], bbox[1]]),\n    // bottom-left\n    modelMatrix.transformAsPoint([bbox[0], bbox[3]]),\n    // bottom-right\n    modelMatrix.transformAsPoint([bbox[2], bbox[3]])\n  ];\n  const transformedBox: Bounds = [\n    // Minimum x coord\n    Math.min(...transformedCoords.map(i => i[0])),\n    // Minimum y coord\n    Math.min(...transformedCoords.map(i => i[1])),\n    // Max x coord\n    Math.max(...transformedCoords.map(i => i[0])),\n    // Max y coord\n    Math.max(...transformedCoords.map(i => i[1]))\n  ];\n  return transformedBox;\n}\n\nfunction stringHash(s: string): number {\n  return Math.abs(s.split('').reduce((a, b) => ((a << 5) - a + b.charCodeAt(0)) | 0, 0));\n}\n\nexport function getURLFromTemplate(\n  template: string | string[],\n  tile: {\n    index: TileIndex;\n    id: string;\n  }\n): string | null {\n  if (!template || !template.length) {\n    return null;\n  }\n  const {index, id} = tile;\n\n  if (Array.isArray(template)) {\n    const i = stringHash(id) % template.length;\n    template = template[i];\n  }\n\n  let url = template;\n  for (const key of Object.keys(index)) {\n    const regex = new RegExp(`{${key}}`, 'g');\n    url = url.replace(regex, String(index[key]));\n  }\n\n  // Back-compatible support for {-y}\n  if (Number.isInteger(index.y) && Number.isInteger(index.z)) {\n    url = url.replace(/\\{-y\\}/g, String(Math.pow(2, index.z) - index.y - 1));\n  }\n  return url;\n}\n\n/**\n * gets the bounding box of a viewport\n */\nfunction getBoundingBox(viewport: Viewport, zRange: number[] | null, extent: Bounds): Bounds {\n  let bounds;\n  if (zRange && zRange.length === 2) {\n    const [minZ, maxZ] = zRange;\n    const bounds0 = viewport.getBounds({z: minZ});\n    const bounds1 = viewport.getBounds({z: maxZ});\n    bounds = [\n      Math.min(bounds0[0], bounds1[0]),\n      Math.min(bounds0[1], bounds1[1]),\n      Math.max(bounds0[2], bounds1[2]),\n      Math.max(bounds0[3], bounds1[3])\n    ];\n  } else {\n    bounds = viewport.getBounds();\n  }\n  if (!viewport.isGeospatial) {\n    return [\n      // Top corner should not be more then bottom corner in either direction\n      Math.max(Math.min(bounds[0], extent[2]), extent[0]),\n      Math.max(Math.min(bounds[1], extent[3]), extent[1]),\n      // Bottom corner should not be less then top corner in either direction\n      Math.min(Math.max(bounds[2], extent[0]), extent[2]),\n      Math.min(Math.max(bounds[3], extent[1]), extent[3])\n    ];\n  }\n  return [\n    Math.max(bounds[0], extent[0]),\n    Math.max(bounds[1], extent[1]),\n    Math.min(bounds[2], extent[2]),\n    Math.min(bounds[3], extent[3])\n  ];\n}\n\n/** Get culling bounds in world space */\nexport function getCullBounds({\n  viewport,\n  z,\n  cullRect\n}: {\n  /** Current viewport */\n  viewport: Viewport;\n  /** Current z range */\n  z: ZRange | number | undefined;\n  /** Culling rectangle in screen space */\n  cullRect: {x: number; y: number; width: number; height: number};\n}): [number, number, number, number] {\n  const x = cullRect.x - viewport.x;\n  const y = cullRect.y - viewport.y;\n  const {width, height} = cullRect;\n\n  if (!Array.isArray(z)) {\n    const unprojectOption = {targetZ: z || 0};\n\n    const topLeft = viewport.unproject([x, y], unprojectOption);\n    const topRight = viewport.unproject([x + width, y], unprojectOption);\n    const bottomLeft = viewport.unproject([x, y + height], unprojectOption);\n    const bottomRight = viewport.unproject([x + width, y + height], unprojectOption);\n\n    return [\n      Math.min(topLeft[0], topRight[0], bottomLeft[0], bottomRight[0]),\n      Math.min(topLeft[1], topRight[1], bottomLeft[1], bottomRight[1]),\n      Math.max(topLeft[0], topRight[0], bottomLeft[0], bottomRight[0]),\n      Math.max(topLeft[1], topRight[1], bottomLeft[1], bottomRight[1])\n    ];\n  }\n\n  const bounds0 = getCullBounds({viewport, z: z[0], cullRect});\n  const bounds1 = getCullBounds({viewport, z: z[1], cullRect});\n\n  return [\n    Math.min(bounds0[0], bounds1[0]),\n    Math.min(bounds0[1], bounds1[1]),\n    Math.max(bounds0[2], bounds1[2]),\n    Math.max(bounds0[3], bounds1[3])\n  ];\n}\n\nfunction getIndexingCoords(bbox: Bounds, scale: number, modelMatrixInverse?: Matrix4): Bounds {\n  if (modelMatrixInverse) {\n    const transformedTileIndex = transformBox(bbox, modelMatrixInverse).map(\n      i => (i * scale) / TILE_SIZE\n    );\n    return transformedTileIndex as Bounds;\n  }\n  return bbox.map(i => (i * scale) / TILE_SIZE) as Bounds;\n}\n\nfunction getScale(z: number, tileSize: number): number {\n  return (Math.pow(2, z) * TILE_SIZE) / tileSize;\n}\n\n// https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames#Lon..2Flat._to_tile_numbers_2\nexport function osmTile2lngLat(x: number, y: number, z: number): [number, number] {\n  const scale = getScale(z, TILE_SIZE);\n  const lng = (x / scale) * 360 - 180;\n  const n = Math.PI - (2 * Math.PI * y) / scale;\n  const lat = (180 / Math.PI) * Math.atan(0.5 * (Math.exp(n) - Math.exp(-n)));\n  return [lng, lat];\n}\n\nfunction tile2XY(x: number, y: number, z: number, tileSize: number): [number, number] {\n  const scale = getScale(z, tileSize);\n  return [(x / scale) * TILE_SIZE, (y / scale) * TILE_SIZE];\n}\nexport function tileToBoundingBox(\n  viewport: Viewport,\n  x: number,\n  y: number,\n  z: number,\n  tileSize: number = TILE_SIZE\n): TileBoundingBox {\n  if (viewport.isGeospatial) {\n    const [west, north] = osmTile2lngLat(x, y, z);\n    const [east, south] = osmTile2lngLat(x + 1, y + 1, z);\n    return {west, north, east, south};\n  }\n  const [left, top] = tile2XY(x, y, z, tileSize);\n  const [right, bottom] = tile2XY(x + 1, y + 1, z, tileSize);\n  return {left, top, right, bottom};\n}\n\nfunction getIdentityTileIndices(\n  viewport: Viewport,\n  z: number,\n  tileSize: number,\n  extent: Bounds,\n  modelMatrixInverse?: Matrix4\n) {\n  const bbox = getBoundingBox(viewport, null, extent);\n  const scale = getScale(z, tileSize);\n  const [minX, minY, maxX, maxY] = getIndexingCoords(bbox, scale, modelMatrixInverse);\n  const indices: TileIndex[] = [];\n\n  /*\n      |  TILE  |  TILE  |  TILE  |\n        |(minX)            |(maxX)\n   */\n  for (let x = Math.floor(minX); x < maxX; x++) {\n    for (let y = Math.floor(minY); y < maxY; y++) {\n      indices.push({x, y, z});\n    }\n  }\n  return indices;\n}\n\n/**\n * Returns all tile indices in the current viewport. If the current zoom level is smaller\n * than minZoom, return an empty array. If the current zoom level is greater than maxZoom,\n * return tiles that are on maxZoom.\n */\n// eslint-disable-next-line complexity\nexport function getTileIndices({\n  viewport,\n  maxZoom,\n  minZoom,\n  zRange,\n  extent,\n  tileSize = TILE_SIZE,\n  modelMatrix,\n  modelMatrixInverse,\n  zoomOffset = 0\n}: {\n  viewport: Viewport;\n  maxZoom?: number;\n  minZoom?: number;\n  zRange: ZRange | undefined;\n  extent?: Bounds;\n  tileSize?: number;\n  modelMatrix?: Matrix4;\n  modelMatrixInverse?: Matrix4;\n  zoomOffset?: number;\n}) {\n  let z = viewport.isGeospatial\n    ? Math.round(viewport.zoom + Math.log2(TILE_SIZE / tileSize)) + zoomOffset\n    : Math.ceil(viewport.zoom) + zoomOffset;\n  if (typeof minZoom === 'number' && Number.isFinite(minZoom) && z < minZoom) {\n    if (!extent) {\n      return [];\n    }\n    z = minZoom;\n  }\n  if (typeof maxZoom === 'number' && Number.isFinite(maxZoom) && z > maxZoom) {\n    z = maxZoom;\n  }\n  let transformedExtent = extent;\n  if (modelMatrix && modelMatrixInverse && extent && !viewport.isGeospatial) {\n    transformedExtent = transformBox(extent, modelMatrix);\n  }\n  return viewport.isGeospatial\n    ? getOSMTileIndices(viewport, z, zRange, extent)\n    : getIdentityTileIndices(\n        viewport,\n        z,\n        tileSize,\n        transformedExtent || DEFAULT_EXTENT,\n        modelMatrixInverse\n      );\n}\n\n/**\n * Returns true if s is a valid URL template\n */\nexport function isURLTemplate(s: string): boolean {\n  return /(?=.*{z})(?=.*{x})(?=.*({y}|{-y}))/.test(s);\n}\n\nexport function isGeoBoundingBox(v: any): v is GeoBoundingBox {\n  return (\n    Number.isFinite(v.west) &&\n    Number.isFinite(v.north) &&\n    Number.isFinite(v.east) &&\n    Number.isFinite(v.south)\n  );\n}\n","import Tile2DHeader from './tile-2d-header';\nimport {getTileIndices, tileToBoundingBox, getCullBounds} from './utils';\nimport {RequestScheduler} from '@loaders.gl/loader-utils';\nimport {Matrix4, equals} from '@math.gl/core';\nimport {Viewport} from '@deck.gl/core';\nimport {Bounds, TileIndex, ZRange} from './types';\nimport {TileLayerProps} from './tile-layer';\nimport {_memoize as memoize} from '@deck.gl/core';\n\n// bit masks\nconst TILE_STATE_VISITED = 1;\nconst TILE_STATE_VISIBLE = 2;\n/*\n   show cached parent tile if children are loading\n   +-----------+       +-----+            +-----+-----+\n   |           |       |     |            |     |     |\n   |           |       |     |            |     |     |\n   |           |  -->  +-----+-----+  ->  +-----+-----+\n   |           |             |     |      |     |     |\n   |           |             |     |      |     |     |\n   +-----------+             +-----+      +-----+-----+\n\n   show cached children tiles when parent is loading\n   +-------+----       +------------\n   |       |           |\n   |       |           |\n   |       |           |\n   +-------+----  -->  |\n   |       |           |\n */\n\nexport const STRATEGY_NEVER = 'never';\nexport const STRATEGY_REPLACE = 'no-overlap';\nexport const STRATEGY_DEFAULT = 'best-available';\n\nexport type RefinementStrategyFunction = (tiles: Tile2DHeader[]) => void;\nexport type RefinementStrategy =\n  | typeof STRATEGY_NEVER\n  | typeof STRATEGY_REPLACE\n  | typeof STRATEGY_DEFAULT\n  | RefinementStrategyFunction;\n\nconst DEFAULT_CACHE_SCALE = 5;\n\nconst STRATEGIES = {\n  [STRATEGY_DEFAULT]: updateTileStateDefault,\n  [STRATEGY_REPLACE]: updateTileStateReplace,\n  [STRATEGY_NEVER]: () => {}\n};\n\nexport type Tileset2DProps = Pick<\n  Required<TileLayerProps>,\n  | 'tileSize'\n  | 'maxCacheSize'\n  | 'maxCacheByteSize'\n  | 'refinementStrategy'\n  | 'extent'\n  | 'maxZoom'\n  | 'minZoom'\n  | 'maxRequests'\n  | 'zoomOffset'\n> & {\n  getTileData: NonNullable<TileLayerProps['getTileData']>;\n  onTileLoad: (tile: Tile2DHeader) => void;\n  onTileUnload: (tile: Tile2DHeader) => void;\n  onTileError: (error: any, tile: Tile2DHeader) => void;\n};\n\n/**\n * Manages loading and purging of tile data. This class caches recently visited tiles\n * and only creates new tiles if they are present.\n */\nexport default class Tileset2D {\n  private opts: Tileset2DProps;\n  private _requestScheduler: RequestScheduler;\n  private _cache: Map<string, Tile2DHeader>;\n  private _dirty: boolean;\n  private _tiles: Tile2DHeader[];\n\n  private _cacheByteSize: number;\n  private _viewport: Viewport | null;\n  private _zRange?: ZRange;\n  private _selectedTiles: Tile2DHeader[] | null;\n  private _frameNumber: number;\n  private _modelMatrix: Matrix4;\n  private _modelMatrixInverse: Matrix4;\n\n  private _maxZoom?: number;\n  private _minZoom?: number;\n\n  private onTileLoad: (tile: Tile2DHeader) => void;\n\n  /**\n   * Takes in a function that returns tile data, a cache size, and a max and a min zoom level.\n   * Cache size defaults to 5 * number of tiles in the current viewport\n   */\n  constructor(opts: Tileset2DProps) {\n    this.opts = opts;\n\n    this.onTileLoad = tile => {\n      this.opts.onTileLoad(tile);\n      if (this.opts.maxCacheByteSize) {\n        this._cacheByteSize += tile.byteLength;\n        this._resizeCache();\n      }\n    };\n\n    this._requestScheduler = new RequestScheduler({\n      maxRequests: opts.maxRequests,\n      throttleRequests: opts.maxRequests > 0\n    });\n\n    // Maps tile id in string {z}-{x}-{y} to a Tile object\n    this._cache = new Map();\n    this._tiles = [];\n    this._dirty = false;\n    this._cacheByteSize = 0;\n\n    // Cache the last processed viewport\n    this._viewport = null;\n    this._selectedTiles = null;\n    this._frameNumber = 0;\n\n    this._modelMatrix = new Matrix4();\n    this._modelMatrixInverse = new Matrix4();\n\n    this.setOptions(opts);\n  }\n\n  /* Public API */\n  get tiles() {\n    return this._tiles;\n  }\n\n  get selectedTiles(): Tile2DHeader[] | null {\n    return this._selectedTiles;\n  }\n\n  get isLoaded(): boolean {\n    return this._selectedTiles !== null && this._selectedTiles.every(tile => tile.isLoaded);\n  }\n\n  get needsReload(): boolean {\n    return this._selectedTiles !== null && this._selectedTiles.some(tile => tile.needsReload);\n  }\n\n  setOptions(opts: Tileset2DProps): void {\n    Object.assign(this.opts, opts);\n    if (Number.isFinite(opts.maxZoom)) {\n      this._maxZoom = Math.floor(opts.maxZoom as number);\n    }\n    if (Number.isFinite(opts.minZoom)) {\n      this._minZoom = Math.ceil(opts.minZoom as number);\n    }\n  }\n\n  // Clean up any outstanding tile requests.\n  finalize(): void {\n    for (const tile of this._cache.values()) {\n      if (tile.isLoading) {\n        tile.abort();\n      }\n    }\n    this._cache.clear();\n    this._tiles = [];\n    this._selectedTiles = null;\n  }\n\n  reloadAll(): void {\n    for (const id of this._cache.keys()) {\n      const tile = this._cache.get(id) as Tile2DHeader;\n      if (!this._selectedTiles || !this._selectedTiles.includes(tile)) {\n        this._cache.delete(id);\n      } else {\n        tile.setNeedsReload();\n      }\n    }\n  }\n\n  /**\n   * Update the cache with the given viewport and model matrix and triggers callback onUpdate.\n   */\n  update(\n    viewport: Viewport,\n    {zRange, modelMatrix}: {zRange?: ZRange; modelMatrix?: Matrix4} = {}\n  ): number {\n    const modelMatrixAsMatrix4 = new Matrix4(modelMatrix);\n    const isModelMatrixNew = !modelMatrixAsMatrix4.equals(this._modelMatrix);\n    if (\n      !this._viewport ||\n      !viewport.equals(this._viewport) ||\n      !equals(this._zRange, zRange) ||\n      isModelMatrixNew\n    ) {\n      if (isModelMatrixNew) {\n        this._modelMatrixInverse = modelMatrixAsMatrix4.clone().invert();\n        this._modelMatrix = modelMatrixAsMatrix4;\n      }\n      this._viewport = viewport;\n      this._zRange = zRange;\n      const tileIndices = this.getTileIndices({\n        viewport,\n        maxZoom: this._maxZoom,\n        minZoom: this._minZoom,\n        zRange,\n        modelMatrix: this._modelMatrix,\n        modelMatrixInverse: this._modelMatrixInverse\n      });\n      this._selectedTiles = tileIndices.map(index => this._getTile(index, true));\n\n      if (this._dirty) {\n        // Some new tiles are added\n        this._rebuildTree();\n      }\n      // Check for needed reloads explicitly even if the view/matrix has not changed.\n    } else if (this.needsReload) {\n      this._selectedTiles = this._selectedTiles!.map(tile => this._getTile(tile.index, true));\n    }\n\n    // Update tile states\n    const changed = this.updateTileStates();\n    this._pruneRequests();\n\n    if (this._dirty) {\n      // cache size is either the user defined maxSize or 5 * number of current tiles in the viewport.\n      this._resizeCache();\n    }\n\n    if (changed) {\n      this._frameNumber++;\n    }\n\n    return this._frameNumber;\n  }\n\n  isTileVisible(\n    tile: Tile2DHeader,\n    cullRect?: {x: number; y: number; width: number; height: number}\n  ): boolean {\n    if (!tile.isVisible) {\n      return false;\n    }\n\n    if (cullRect && this._viewport) {\n      const [minX, minY, maxX, maxY] = getCullBounds({\n        viewport: this._viewport,\n        z: this._zRange,\n        cullRect\n      });\n      const {bbox} = tile;\n      if ('west' in bbox) {\n        return bbox.west < maxX && bbox.east > minX && bbox.south < maxY && bbox.north > minY;\n      }\n      // top/bottom could be swapped depending on the indexing system\n      const y0 = Math.min(bbox.top, bbox.bottom);\n      const y1 = Math.max(bbox.top, bbox.bottom);\n      return bbox.left < maxX && bbox.right > minX && y0 < maxY && y1 > minY;\n    }\n    return true;\n  }\n\n  /* Public interface for subclassing */\n\n  /** Returns array of tile indices in the current viewport */\n  getTileIndices({\n    viewport,\n    maxZoom,\n    minZoom,\n    zRange,\n    modelMatrix,\n    modelMatrixInverse\n  }: {\n    viewport: Viewport;\n    maxZoom?: number;\n    minZoom?: number;\n    zRange: ZRange | undefined;\n    tileSize?: number;\n    modelMatrix?: Matrix4;\n    modelMatrixInverse?: Matrix4;\n    zoomOffset?: number;\n  }): TileIndex[] {\n    const {tileSize, extent, zoomOffset} = this.opts;\n    return getTileIndices({\n      viewport,\n      maxZoom,\n      minZoom,\n      zRange,\n      tileSize,\n      extent: extent as Bounds | undefined,\n      modelMatrix,\n      modelMatrixInverse,\n      zoomOffset\n    });\n  }\n\n  /** Returns unique string key for a tile index */\n  getTileId(index: TileIndex) {\n    return `${index.x}-${index.y}-${index.z}`;\n  }\n\n  /** Returns a zoom level for a tile index */\n  getTileZoom(index: TileIndex) {\n    return index.z;\n  }\n\n  /** Returns additional metadata to add to tile, bbox by default */\n  getTileMetadata(index: TileIndex): Record<string, any> {\n    const {tileSize} = this.opts;\n    // @ts-expect-error\n    return {bbox: tileToBoundingBox(this._viewport, index.x, index.y, index.z, tileSize)};\n  }\n\n  /** Returns index of the parent tile */\n  getParentIndex(index: TileIndex) {\n    const x = Math.floor(index.x / 2);\n    const y = Math.floor(index.y / 2);\n    const z = index.z - 1;\n    return {x, y, z};\n  }\n\n  // Returns true if any tile's visibility changed\n  private updateTileStates() {\n    const refinementStrategy = this.opts.refinementStrategy || STRATEGY_DEFAULT;\n\n    const visibilities = new Array(this._cache.size);\n    let i = 0;\n    // Reset state\n    for (const tile of this._cache.values()) {\n      // save previous state\n      visibilities[i++] = tile.isVisible;\n      tile.isSelected = false;\n      tile.isVisible = false;\n    }\n    // @ts-expect-error called only when _selectedTiles is already defined\n    for (const tile of this._selectedTiles) {\n      tile.isSelected = true;\n      tile.isVisible = true;\n    }\n\n    // Strategy-specific state logic\n    (typeof refinementStrategy === 'function'\n      ? refinementStrategy\n      : STRATEGIES[refinementStrategy])(Array.from(this._cache.values()));\n\n    i = 0;\n    // Check if any visibility has changed\n    for (const tile of this._cache.values()) {\n      if (visibilities[i++] !== tile.isVisible) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  /* Private methods */\n\n  private _getCullBounds = memoize(getCullBounds);\n\n  private _pruneRequests(): void {\n    const {maxRequests} = this.opts;\n\n    const abortCandidates: Tile2DHeader[] = [];\n    let ongoingRequestCount = 0;\n    for (const tile of this._cache.values()) {\n      // Keep track of all the ongoing requests\n      if (tile.isLoading) {\n        ongoingRequestCount++;\n        if (!tile.isSelected && !tile.isVisible) {\n          abortCandidates.push(tile);\n        }\n      }\n    }\n\n    while (maxRequests > 0 && ongoingRequestCount > maxRequests && abortCandidates.length > 0) {\n      // There are too many ongoing requests, so abort some that are unselected\n      const tile = abortCandidates.shift()!;\n      tile.abort();\n      ongoingRequestCount--;\n    }\n  }\n\n  // This needs to be called every time some tiles have been added/removed from cache\n  private _rebuildTree() {\n    const {_cache} = this;\n\n    // Reset states\n    for (const tile of _cache.values()) {\n      tile.parent = null;\n      if (tile.children) {\n        tile.children.length = 0;\n      }\n    }\n\n    // Rebuild tree\n    for (const tile of _cache.values()) {\n      const parent = this._getNearestAncestor(tile);\n      tile.parent = parent;\n      if (parent?.children) {\n        parent.children.push(tile);\n      }\n    }\n  }\n\n  /**\n   * Clear tiles that are not visible when the cache is full\n   */\n  /* eslint-disable complexity */\n  private _resizeCache() {\n    const {_cache, opts} = this;\n\n    const maxCacheSize =\n      opts.maxCacheSize ||\n      // @ts-expect-error called only when selectedTiles is initialized\n      (opts.maxCacheByteSize ? Infinity : DEFAULT_CACHE_SCALE * this.selectedTiles.length);\n    const maxCacheByteSize = opts.maxCacheByteSize || Infinity;\n\n    const overflown = _cache.size > maxCacheSize || this._cacheByteSize > maxCacheByteSize;\n\n    if (overflown) {\n      for (const [id, tile] of _cache) {\n        if (!tile.isVisible && !tile.isSelected) {\n          // delete tile\n          this._cacheByteSize -= opts.maxCacheByteSize ? tile.byteLength : 0;\n          _cache.delete(id);\n          this.opts.onTileUnload(tile);\n        }\n        if (_cache.size <= maxCacheSize && this._cacheByteSize <= maxCacheByteSize) {\n          break;\n        }\n      }\n      this._rebuildTree();\n      this._dirty = true;\n    }\n    if (this._dirty) {\n      // sort by zoom level so that smaller tiles are displayed on top\n      this._tiles = Array.from(this._cache.values()).sort((t1, t2) => t1.zoom - t2.zoom);\n\n      this._dirty = false;\n    }\n  }\n  /* eslint-enable complexity */\n\n  private _getTile(index: TileIndex, create: true): Tile2DHeader;\n  private _getTile(index: TileIndex, create?: false): Tile2DHeader | undefined;\n  private _getTile(index: TileIndex, create?: boolean): Tile2DHeader | undefined {\n    const id = this.getTileId(index);\n    let tile = this._cache.get(id);\n    let needsReload = false;\n\n    if (!tile && create) {\n      tile = new Tile2DHeader(index);\n      Object.assign(tile, this.getTileMetadata(tile.index));\n      Object.assign(tile, {id, zoom: this.getTileZoom(tile.index)});\n      needsReload = true;\n      this._cache.set(id, tile);\n      this._dirty = true;\n    } else if (tile && tile.needsReload) {\n      needsReload = true;\n    }\n    if (tile && needsReload) {\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      tile.loadData({\n        getData: this.opts.getTileData,\n        requestScheduler: this._requestScheduler,\n        onLoad: this.onTileLoad,\n        onError: this.opts.onTileError\n      });\n    }\n\n    return tile;\n  }\n\n  _getNearestAncestor(tile: Tile2DHeader): Tile2DHeader | null {\n    const {_minZoom = 0} = this;\n\n    let index = tile.index;\n    while (this.getTileZoom(index) > _minZoom) {\n      index = this.getParentIndex(index);\n      const parent = this._getTile(index);\n      if (parent) {\n        return parent;\n      }\n    }\n    return null;\n  }\n}\n\n/* -- Refinement strategies --*/\n/* eslint-disable max-depth */\n\n// For all the selected && pending tiles:\n// - pick the closest ancestor as placeholder\n// - if no ancestor is visible, pick the closest children as placeholder\nfunction updateTileStateDefault(allTiles: Tile2DHeader[]) {\n  for (const tile of allTiles) {\n    tile.state = 0;\n  }\n  for (const tile of allTiles) {\n    if (tile.isSelected && !getPlaceholderInAncestors(tile)) {\n      getPlaceholderInChildren(tile);\n    }\n  }\n  for (const tile of allTiles) {\n    tile.isVisible = Boolean(tile.state! & TILE_STATE_VISIBLE);\n  }\n}\n\n// Until a selected tile and all its selected siblings are loaded, use the closest ancestor as placeholder\nfunction updateTileStateReplace(allTiles: Tile2DHeader[]) {\n  for (const tile of allTiles) {\n    tile.state = 0;\n  }\n  for (const tile of allTiles) {\n    if (tile.isSelected) {\n      getPlaceholderInAncestors(tile);\n    }\n  }\n  // Always process parents first\n  const sortedTiles = Array.from(allTiles).sort((t1, t2) => t1.zoom - t2.zoom);\n  for (const tile of sortedTiles) {\n    tile.isVisible = Boolean(tile.state! & TILE_STATE_VISIBLE);\n\n    if (tile.children && (tile.isVisible || tile.state! & TILE_STATE_VISITED)) {\n      // If the tile is rendered, or if the tile has been explicitly hidden, hide all of its children\n      for (const child of tile.children) {\n        child.state = TILE_STATE_VISITED;\n      }\n    } else if (tile.isSelected) {\n      getPlaceholderInChildren(tile);\n    }\n  }\n}\n\n// Walk up the tree until we find one ancestor that is loaded. Returns true if successful.\nfunction getPlaceholderInAncestors(startTile: Tile2DHeader) {\n  let tile: Tile2DHeader | null = startTile;\n  while (tile) {\n    if (tile.isLoaded || tile.content) {\n      tile.state! |= TILE_STATE_VISIBLE;\n      return true;\n    }\n    tile = tile.parent;\n  }\n  return false;\n}\n\n// Recursively set children as placeholder\nfunction getPlaceholderInChildren(tile) {\n  for (const child of tile.children) {\n    if (child.isLoaded || child.content) {\n      child.state |= TILE_STATE_VISIBLE;\n    } else {\n      getPlaceholderInChildren(child);\n    }\n  }\n}\n","import {\n  CompositeLayer,\n  CompositeLayerProps,\n  Layer,\n  LayerProps,\n  UpdateParameters,\n  PickingInfo,\n  GetPickingInfoParams,\n  DefaultProps,\n  FilterContext,\n  _flatten as flatten\n} from '@deck.gl/core';\nimport {GeoJsonLayer} from '@deck.gl/layers';\nimport {LayersList} from '@deck.gl/core';\nimport Tile2DHeader from './tile-2d-header';\n\nimport Tileset2D, {RefinementStrategy, STRATEGY_DEFAULT, Tileset2DProps} from './tileset-2d';\nimport {TileLoadProps, ZRange} from './types';\nimport {urlType, getURLFromTemplate} from './utils';\n\nconst defaultProps: DefaultProps<TileLayerProps> = {\n  TilesetClass: Tileset2D,\n  data: {type: 'data', value: []},\n  dataComparator: urlType.equals,\n  renderSubLayers: {type: 'function', value: props => new GeoJsonLayer(props), compare: false},\n  getTileData: {type: 'function', optional: true, value: null, compare: false},\n  // TODO - change to onViewportLoad to align with Tile3DLayer\n  onViewportLoad: {type: 'function', optional: true, value: null, compare: false},\n  onTileLoad: {type: 'function', value: tile => {}, compare: false},\n  onTileUnload: {type: 'function', value: tile => {}, compare: false},\n  // eslint-disable-next-line\n  onTileError: {type: 'function', value: err => console.error(err), compare: false},\n  extent: {type: 'array', optional: true, value: null, compare: true},\n  tileSize: 512,\n  maxZoom: null,\n  minZoom: 0,\n  maxCacheSize: null,\n  maxCacheByteSize: null,\n  refinementStrategy: STRATEGY_DEFAULT,\n  zRange: null,\n  maxRequests: 6,\n  zoomOffset: 0\n};\n\n/** All props supported by the TileLayer */\nexport type TileLayerProps<DataT = any> = CompositeLayerProps<any> & _TileLayerProps<DataT>;\n\n/** Props added by the TileLayer */\ntype _TileLayerProps<DataT> = {\n  /**\n   * Optionally implement a custom indexing scheme.\n   */\n  TilesetClass: typeof Tileset2D;\n  /**\n   * Renders one or an array of Layer instances.\n   */\n  renderSubLayers?: (\n    props: TileLayerProps<DataT> & {\n      id: string;\n      data: DataT;\n      _offset: number;\n      tile: Tile2DHeader<DataT>;\n    }\n  ) => Layer | null | LayersList;\n  /**\n   * If supplied, `getTileData` is called to retrieve the data of each tile.\n   */\n  getTileData?: ((props: TileLoadProps) => Promise<DataT> | DataT) | null;\n\n  /** Called when all tiles in the current viewport are loaded. */\n  onViewportLoad?: ((tiles: Tile2DHeader<DataT>[]) => void) | null;\n\n  /** Called when a tile successfully loads. */\n  onTileLoad?: (tile: Tile2DHeader<DataT>) => void;\n\n  /** Called when a tile is cleared from cache. */\n  onTileUnload?: (tile: Tile2DHeader<DataT>) => void;\n\n  /** Called when a tile failed to load. */\n  onTileError?: (err: any) => void;\n\n  /** The bounding box of the layer's data. */\n  extent?: number[] | null;\n\n  /** The pixel dimension of the tiles, usually a power of 2. */\n  tileSize?: number;\n\n  /** The max zoom level of the layer's data.\n   * @default null\n   */\n  maxZoom?: number | null;\n\n  /** The min zoom level of the layer's data.\n   * @default 0\n   */\n  minZoom?: number | null;\n\n  /** The maximum number of tiles that can be cached. */\n  maxCacheSize?: number | null;\n\n  /**\n   * The maximum memory used for caching tiles.\n   *\n   * @default null\n   */\n  maxCacheByteSize?: number | null;\n\n  /**\n   * How the tile layer refines the visibility of tiles.\n   *\n   * @default 'best-available'\n   */\n  refinementStrategy?: RefinementStrategy;\n\n  /** Range of minimum and maximum heights in the tile. */\n  zRange?: ZRange | null;\n\n  /**\n   * The maximum number of concurrent getTileData calls.\n   *\n   * @default 6\n   */\n  maxRequests?: number;\n\n  /**\n   * This offset changes the zoom level at which the tiles are fetched.\n   *\n   * Needs to be an integer.\n   *\n   * @default 0\n   */\n  zoomOffset?: number;\n};\n\nexport type TiledPickingInfo<DataT = any> = PickingInfo & {\n  tile?: Tile2DHeader<DataT>;\n};\n\n/**\n * The TileLayer is a composite layer that makes it possible to visualize very large datasets.\n *\n * Instead of fetching the entire dataset, it only loads and renders what's visible in the current viewport.\n */\nexport default class TileLayer<DataT = any, ExtraPropsT = {}> extends CompositeLayer<\n  ExtraPropsT & Required<_TileLayerProps<DataT>>\n> {\n  static defaultProps = defaultProps as any;\n  static layerName = 'TileLayer';\n\n  initializeState() {\n    this.state = {\n      tileset: null,\n      isLoaded: false\n    };\n  }\n\n  finalizeState() {\n    this.state?.tileset?.finalize();\n  }\n\n  get isLoaded(): boolean {\n    return this.state?.tileset?.selectedTiles.every(\n      tile => tile.isLoaded && tile.layers && tile.layers.every(layer => layer.isLoaded)\n    );\n  }\n\n  shouldUpdateState({changeFlags}): boolean {\n    return changeFlags.somethingChanged;\n  }\n\n  updateState({changeFlags}: UpdateParameters<this>) {\n    let {tileset} = this.state;\n    const propsChanged = changeFlags.propsOrDataChanged || changeFlags.updateTriggersChanged;\n    const dataChanged =\n      changeFlags.dataChanged ||\n      (changeFlags.updateTriggersChanged &&\n        (changeFlags.updateTriggersChanged.all || changeFlags.updateTriggersChanged.getTileData));\n\n    if (!tileset) {\n      tileset = new this.props.TilesetClass(this._getTilesetOptions());\n      this.setState({tileset});\n    } else if (propsChanged) {\n      tileset.setOptions(this._getTilesetOptions());\n\n      if (dataChanged) {\n        // reload all tiles\n        // use cached layers until new content is loaded\n        tileset.reloadAll();\n      } else {\n        // some render options changed, regenerate sub layers now\n        this.state.tileset.tiles.forEach(tile => {\n          tile.layers = null;\n        });\n      }\n    }\n\n    this._updateTileset();\n  }\n\n  _getTilesetOptions(): Tileset2DProps {\n    const {\n      tileSize,\n      maxCacheSize,\n      maxCacheByteSize,\n      refinementStrategy,\n      extent,\n      maxZoom,\n      minZoom,\n      maxRequests,\n      zoomOffset\n    } = this.props;\n\n    return {\n      maxCacheSize,\n      maxCacheByteSize,\n      maxZoom,\n      minZoom,\n      tileSize,\n      refinementStrategy,\n      extent,\n      maxRequests,\n      zoomOffset,\n\n      getTileData: this.getTileData.bind(this),\n      onTileLoad: this._onTileLoad.bind(this),\n      onTileError: this._onTileError.bind(this),\n      onTileUnload: this._onTileUnload.bind(this)\n    };\n  }\n\n  private _updateTileset(): void {\n    const {tileset} = this.state;\n    const {zRange, modelMatrix} = this.props;\n    const frameNumber = tileset.update(this.context.viewport, {zRange, modelMatrix});\n    const {isLoaded} = tileset;\n\n    const loadingStateChanged = this.state.isLoaded !== isLoaded;\n    const tilesetChanged = this.state.frameNumber !== frameNumber;\n\n    if (isLoaded && (loadingStateChanged || tilesetChanged)) {\n      this._onViewportLoad();\n    }\n\n    if (tilesetChanged) {\n      // Save the tileset frame number - trigger a rerender\n      this.setState({frameNumber});\n    }\n    // Save the loaded state - should not trigger a rerender\n    this.state.isLoaded = isLoaded;\n  }\n\n  _onViewportLoad(): void {\n    const {tileset} = this.state;\n    const {onViewportLoad} = this.props;\n\n    if (onViewportLoad) {\n      onViewportLoad(tileset.selectedTiles);\n    }\n  }\n\n  _onTileLoad(tile: Tile2DHeader<DataT>): void {\n    this.props.onTileLoad(tile);\n    tile.layers = null;\n\n    this.setNeedsUpdate();\n  }\n\n  _onTileError(error: any, tile: Tile2DHeader<DataT>) {\n    this.props.onTileError(error);\n    tile.layers = null;\n\n    this.setNeedsUpdate();\n  }\n\n  _onTileUnload(tile: Tile2DHeader<DataT>) {\n    this.props.onTileUnload(tile);\n  }\n\n  // Methods for subclass to override\n\n  getTileData(tile: TileLoadProps): Promise<DataT> | DataT | null {\n    const {data, getTileData, fetch} = this.props;\n    const {signal} = tile;\n\n    tile.url =\n      typeof data === 'string' || Array.isArray(data) ? getURLFromTemplate(data, tile) : null;\n\n    if (getTileData) {\n      return getTileData(tile);\n    }\n    if (fetch && tile.url) {\n      return fetch(tile.url, {propName: 'data', layer: this, signal});\n    }\n    return null;\n  }\n\n  renderSubLayers(\n    props: TileLayer['props'] & {\n      id: string;\n      data: DataT;\n      _offset: number;\n      tile: Tile2DHeader<DataT>;\n    }\n  ): Layer | null | LayersList {\n    return this.props.renderSubLayers(props);\n  }\n\n  getSubLayerPropsByTile(tile: Tile2DHeader): Partial<LayerProps> | null {\n    return null;\n  }\n\n  getPickingInfo({info, sourceLayer}: GetPickingInfoParams): TiledPickingInfo<DataT> {\n    if (info.picked) {\n      (info as any).tile = (sourceLayer as any).props.tile;\n    }\n    return info;\n  }\n\n  protected _updateAutoHighlight(info: PickingInfo): void {\n    if (info.sourceLayer) {\n      info.sourceLayer.updateAutoHighlight(info);\n    }\n  }\n\n  renderLayers(): Layer | null | LayersList {\n    return this.state.tileset.tiles.map((tile: Tile2DHeader) => {\n      const subLayerProps = this.getSubLayerPropsByTile(tile);\n      // cache the rendered layer in the tile\n      if (!tile.isLoaded && !tile.content) {\n        // nothing to show\n      } else if (!tile.layers) {\n        const layers = this.renderSubLayers({\n          ...this.props,\n          id: `${this.id}-${tile.id}`,\n          data: tile.content,\n          _offset: 0,\n          tile\n        });\n        tile.layers = (flatten(layers, Boolean) as Layer<{tile?: Tile2DHeader}>[]).map(layer =>\n          layer.clone({\n            tile,\n            ...subLayerProps\n          })\n        );\n      } else if (\n        subLayerProps &&\n        tile.layers[0] &&\n        Object.keys(subLayerProps).some(\n          propName => tile.layers![0].props[propName] !== subLayerProps[propName]\n        )\n      ) {\n        tile.layers = tile.layers.map(layer => layer.clone(subLayerProps));\n      }\n      return tile.layers;\n    });\n  }\n\n  filterSubLayer({layer, cullRect}: FilterContext) {\n    const {tile} = (layer as Layer<{tile: Tile2DHeader}>).props;\n    return this.state.tileset.isTileVisible(tile, cullRect);\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport type {NumericArray} from '@math.gl/core';\nimport {AccessorFunction, DefaultProps} from '@deck.gl/core';\nimport {PathLayer, PathLayerProps} from '@deck.gl/layers';\n\nconst defaultProps: DefaultProps<TripsLayerProps> = {\n  fadeTrail: true,\n  trailLength: {type: 'number', value: 120, min: 0},\n  currentTime: {type: 'number', value: 0, min: 0},\n  getTimestamps: {type: 'accessor', value: d => d.timestamps}\n};\n\n/** All properties supported by TripsLayer. */\nexport type TripsLayerProps<DataT = any> = _TripsLayerProps<DataT> & PathLayerProps<DataT>;\n\n/** Properties added by TripsLayer. */\ntype _TripsLayerProps<DataT = any> = {\n  /**\n   * Whether or not the path fades out.\n   * @default true\n   */\n  fadeTrail?: boolean;\n  /**\n   * Trail length.\n   * @default 120\n   */\n  trailLength?: number;\n  /**\n   * The current time of the frame.\n   * @default 0\n   */\n  currentTime?: number;\n  /**\n   * Timestamp accessor.\n   */\n  getTimestamps?: AccessorFunction<DataT, NumericArray>;\n};\n\n/** Render animated paths that represent vehicle trips. */\nexport default class TripsLayer<DataT = any, ExtraProps = {}> extends PathLayer<\n  DataT,\n  Required<_TripsLayerProps> & ExtraProps\n> {\n  static layerName = 'TripsLayer';\n  static defaultProps = defaultProps;\n\n  getShaders() {\n    const shaders = super.getShaders();\n    shaders.inject = {\n      'vs:#decl': `\\\nuniform float trailLength;\nattribute float instanceTimestamps;\nattribute float instanceNextTimestamps;\nvarying float vTime;\n`,\n      // Timestamp of the vertex\n      'vs:#main-end': `\\\nvTime = instanceTimestamps + (instanceNextTimestamps - instanceTimestamps) * vPathPosition.y / vPathLength;\n`,\n      'fs:#decl': `\\\nuniform bool fadeTrail;\nuniform float trailLength;\nuniform float currentTime;\nvarying float vTime;\n`,\n      // Drop the segments outside of the time window\n      'fs:#main-start': `\\\nif(vTime > currentTime || (fadeTrail && (vTime < currentTime - trailLength))) {\n  discard;\n}\n`,\n      // Fade the color (currentTime - 100%, end of trail - 0%)\n      'fs:DECKGL_FILTER_COLOR': `\\\nif(fadeTrail) {\n  color.a *= 1.0 - (currentTime - vTime) / trailLength;\n}\n`\n    };\n    return shaders;\n  }\n\n  initializeState() {\n    super.initializeState();\n\n    const attributeManager = this.getAttributeManager();\n    attributeManager!.addInstanced({\n      timestamps: {\n        size: 1,\n        accessor: 'getTimestamps',\n        shaderAttributes: {\n          instanceTimestamps: {\n            vertexOffset: 0\n          },\n          instanceNextTimestamps: {\n            vertexOffset: 1\n          }\n        }\n      }\n    });\n  }\n\n  draw(params) {\n    const {fadeTrail, trailLength, currentTime} = this.props;\n\n    params.uniforms = {\n      ...params.uniforms,\n      fadeTrail,\n      trailLength,\n      currentTime\n    };\n\n    super.draw(params);\n  }\n}\n","var libh3 = function (libh3) {\n  libh3 = libh3 || {};\n  var Module = typeof libh3 !== \"undefined\" ? libh3 : {};\n  var moduleOverrides = {};\n  var key;\n\n  for (key in Module) {\n    if (Module.hasOwnProperty(key)) {\n      moduleOverrides[key] = Module[key];\n    }\n  }\n\n  var arguments_ = [];\n  var scriptDirectory = \"\";\n\n  function locateFile(path) {\n    if (Module[\"locateFile\"]) {\n      return Module[\"locateFile\"](path, scriptDirectory);\n    }\n\n    return scriptDirectory + path;\n  }\n\n  var readAsync;\n\n  {\n    if (document.currentScript) {\n      scriptDirectory = document.currentScript.src;\n    }\n\n    if (scriptDirectory.indexOf(\"blob:\") !== 0) {\n      scriptDirectory = scriptDirectory.substr(0, scriptDirectory.lastIndexOf(\"/\") + 1);\n    } else {\n      scriptDirectory = \"\";\n    }\n\n    readAsync = function readAsync(url, onload, onerror) {\n      var xhr = new XMLHttpRequest();\n      xhr.open(\"GET\", url, true);\n      xhr.responseType = \"arraybuffer\";\n\n      xhr.onload = function xhr_onload() {\n        if (xhr.status == 200 || xhr.status == 0 && xhr.response) {\n          onload(xhr.response);\n          return;\n        }\n\n        var data = tryParseAsDataURI(url);\n\n        if (data) {\n          onload(data.buffer);\n          return;\n        }\n\n        onerror();\n      };\n\n      xhr.onerror = onerror;\n      xhr.send(null);\n    };\n  }\n\n  var out = Module[\"print\"] || console.log.bind(console);\n  var err = Module[\"printErr\"] || console.warn.bind(console);\n\n  for (key in moduleOverrides) {\n    if (moduleOverrides.hasOwnProperty(key)) {\n      Module[key] = moduleOverrides[key];\n    }\n  }\n\n  moduleOverrides = null;\n  if (Module[\"arguments\"]) { arguments_ = Module[\"arguments\"]; }\n\n  var tempRet0 = 0;\n\n  var setTempRet0 = function (value) {\n    tempRet0 = value;\n  };\n\n  var getTempRet0 = function () {\n    return tempRet0;\n  };\n\n  var GLOBAL_BASE = 8;\n\n  function setValue(ptr, value, type, noSafe) {\n    type = type || \"i8\";\n    if (type.charAt(type.length - 1) === \"*\") { type = \"i32\"; }\n\n    switch (type) {\n      case \"i1\":\n        HEAP8[ptr >> 0] = value;\n        break;\n\n      case \"i8\":\n        HEAP8[ptr >> 0] = value;\n        break;\n\n      case \"i16\":\n        HEAP16[ptr >> 1] = value;\n        break;\n\n      case \"i32\":\n        HEAP32[ptr >> 2] = value;\n        break;\n\n      case \"i64\":\n        tempI64 = [value >>> 0, (tempDouble = value, +Math_abs(tempDouble) >= +1 ? tempDouble > +0 ? (Math_min(+Math_floor(tempDouble / +4294967296), +4294967295) | 0) >>> 0 : ~~+Math_ceil((tempDouble - +(~~tempDouble >>> 0)) / +4294967296) >>> 0 : 0)], HEAP32[ptr >> 2] = tempI64[0], HEAP32[ptr + 4 >> 2] = tempI64[1];\n        break;\n\n      case \"float\":\n        HEAPF32[ptr >> 2] = value;\n        break;\n\n      case \"double\":\n        HEAPF64[ptr >> 3] = value;\n        break;\n\n      default:\n        abort(\"invalid type for setValue: \" + type);\n    }\n  }\n\n  function getValue(ptr, type, noSafe) {\n    type = type || \"i8\";\n    if (type.charAt(type.length - 1) === \"*\") { type = \"i32\"; }\n\n    switch (type) {\n      case \"i1\":\n        return HEAP8[ptr >> 0];\n\n      case \"i8\":\n        return HEAP8[ptr >> 0];\n\n      case \"i16\":\n        return HEAP16[ptr >> 1];\n\n      case \"i32\":\n        return HEAP32[ptr >> 2];\n\n      case \"i64\":\n        return HEAP32[ptr >> 2];\n\n      case \"float\":\n        return HEAPF32[ptr >> 2];\n\n      case \"double\":\n        return HEAPF64[ptr >> 3];\n\n      default:\n        abort(\"invalid type for getValue: \" + type);\n    }\n\n    return null;\n  }\n\n  var ABORT = false;\n\n  function assert(condition, text) {\n    if (!condition) {\n      abort(\"Assertion failed: \" + text);\n    }\n  }\n\n  function getCFunc(ident) {\n    var func = Module[\"_\" + ident];\n    assert(func, \"Cannot call unknown function \" + ident + \", make sure it is exported\");\n    return func;\n  }\n\n  function ccall(ident, returnType, argTypes, args, opts) {\n    var toC = {\n      \"string\": function (str) {\n        var ret = 0;\n\n        if (str !== null && str !== undefined && str !== 0) {\n          var len = (str.length << 2) + 1;\n          ret = stackAlloc(len);\n          stringToUTF8(str, ret, len);\n        }\n\n        return ret;\n      },\n      \"array\": function (arr) {\n        var ret = stackAlloc(arr.length);\n        writeArrayToMemory(arr, ret);\n        return ret;\n      }\n    };\n\n    function convertReturnValue(ret) {\n      if (returnType === \"string\") { return UTF8ToString(ret); }\n      if (returnType === \"boolean\") { return Boolean(ret); }\n      return ret;\n    }\n\n    var func = getCFunc(ident);\n    var cArgs = [];\n    var stack = 0;\n\n    if (args) {\n      for (var i = 0; i < args.length; i++) {\n        var converter = toC[argTypes[i]];\n\n        if (converter) {\n          if (stack === 0) { stack = stackSave(); }\n          cArgs[i] = converter(args[i]);\n        } else {\n          cArgs[i] = args[i];\n        }\n      }\n    }\n\n    var ret = func.apply(null, cArgs);\n    ret = convertReturnValue(ret);\n    if (stack !== 0) { stackRestore(stack); }\n    return ret;\n  }\n\n  function cwrap(ident, returnType, argTypes, opts) {\n    argTypes = argTypes || [];\n    var numericArgs = argTypes.every(function (type) {\n      return type === \"number\";\n    });\n    var numericRet = returnType !== \"string\";\n\n    if (numericRet && numericArgs && !opts) {\n      return getCFunc(ident);\n    }\n\n    return function () {\n      return ccall(ident, returnType, argTypes, arguments, opts);\n    };\n  }\n  var UTF8Decoder = typeof TextDecoder !== \"undefined\" ? new TextDecoder(\"utf8\") : undefined;\n\n  function UTF8ArrayToString(u8Array, idx, maxBytesToRead) {\n    var endIdx = idx + maxBytesToRead;\n    var endPtr = idx;\n\n    while (u8Array[endPtr] && !(endPtr >= endIdx)) { ++endPtr; }\n\n    if (endPtr - idx > 16 && u8Array.subarray && UTF8Decoder) {\n      return UTF8Decoder.decode(u8Array.subarray(idx, endPtr));\n    } else {\n      var str = \"\";\n\n      while (idx < endPtr) {\n        var u0 = u8Array[idx++];\n\n        if (!(u0 & 128)) {\n          str += String.fromCharCode(u0);\n          continue;\n        }\n\n        var u1 = u8Array[idx++] & 63;\n\n        if ((u0 & 224) == 192) {\n          str += String.fromCharCode((u0 & 31) << 6 | u1);\n          continue;\n        }\n\n        var u2 = u8Array[idx++] & 63;\n\n        if ((u0 & 240) == 224) {\n          u0 = (u0 & 15) << 12 | u1 << 6 | u2;\n        } else {\n          u0 = (u0 & 7) << 18 | u1 << 12 | u2 << 6 | u8Array[idx++] & 63;\n        }\n\n        if (u0 < 65536) {\n          str += String.fromCharCode(u0);\n        } else {\n          var ch = u0 - 65536;\n          str += String.fromCharCode(55296 | ch >> 10, 56320 | ch & 1023);\n        }\n      }\n    }\n\n    return str;\n  }\n\n  function UTF8ToString(ptr, maxBytesToRead) {\n    return ptr ? UTF8ArrayToString(HEAPU8, ptr, maxBytesToRead) : \"\";\n  }\n\n  function stringToUTF8Array(str, outU8Array, outIdx, maxBytesToWrite) {\n    if (!(maxBytesToWrite > 0)) { return 0; }\n    var startIdx = outIdx;\n    var endIdx = outIdx + maxBytesToWrite - 1;\n\n    for (var i = 0; i < str.length; ++i) {\n      var u = str.charCodeAt(i);\n\n      if (u >= 55296 && u <= 57343) {\n        var u1 = str.charCodeAt(++i);\n        u = 65536 + ((u & 1023) << 10) | u1 & 1023;\n      }\n\n      if (u <= 127) {\n        if (outIdx >= endIdx) { break; }\n        outU8Array[outIdx++] = u;\n      } else if (u <= 2047) {\n        if (outIdx + 1 >= endIdx) { break; }\n        outU8Array[outIdx++] = 192 | u >> 6;\n        outU8Array[outIdx++] = 128 | u & 63;\n      } else if (u <= 65535) {\n        if (outIdx + 2 >= endIdx) { break; }\n        outU8Array[outIdx++] = 224 | u >> 12;\n        outU8Array[outIdx++] = 128 | u >> 6 & 63;\n        outU8Array[outIdx++] = 128 | u & 63;\n      } else {\n        if (outIdx + 3 >= endIdx) { break; }\n        outU8Array[outIdx++] = 240 | u >> 18;\n        outU8Array[outIdx++] = 128 | u >> 12 & 63;\n        outU8Array[outIdx++] = 128 | u >> 6 & 63;\n        outU8Array[outIdx++] = 128 | u & 63;\n      }\n    }\n\n    outU8Array[outIdx] = 0;\n    return outIdx - startIdx;\n  }\n\n  function stringToUTF8(str, outPtr, maxBytesToWrite) {\n    return stringToUTF8Array(str, HEAPU8, outPtr, maxBytesToWrite);\n  }\n\n  var UTF16Decoder = typeof TextDecoder !== \"undefined\" ? new TextDecoder(\"utf-16le\") : undefined;\n\n  function writeArrayToMemory(array, buffer) {\n    HEAP8.set(array, buffer);\n  }\n\n  function alignUp(x, multiple) {\n    if (x % multiple > 0) {\n      x += multiple - x % multiple;\n    }\n\n    return x;\n  }\n\n  var buffer, HEAP8, HEAPU8, HEAP16, HEAPU16, HEAP32, HEAPU32, HEAPF32, HEAPF64;\n\n  function updateGlobalBufferAndViews(buf) {\n    buffer = buf;\n    Module[\"HEAP8\"] = HEAP8 = new Int8Array(buf);\n    Module[\"HEAP16\"] = HEAP16 = new Int16Array(buf);\n    Module[\"HEAP32\"] = HEAP32 = new Int32Array(buf);\n    Module[\"HEAPU8\"] = HEAPU8 = new Uint8Array(buf);\n    Module[\"HEAPU16\"] = HEAPU16 = new Uint16Array(buf);\n    Module[\"HEAPU32\"] = HEAPU32 = new Uint32Array(buf);\n    Module[\"HEAPF32\"] = HEAPF32 = new Float32Array(buf);\n    Module[\"HEAPF64\"] = HEAPF64 = new Float64Array(buf);\n  }\n\n  var DYNAMIC_BASE = 5266928,\n      DYNAMICTOP_PTR = 24016;\n  var INITIAL_TOTAL_MEMORY = Module[\"TOTAL_MEMORY\"] || 33554432;\n\n  if (Module[\"buffer\"]) {\n    buffer = Module[\"buffer\"];\n  } else {\n    buffer = new ArrayBuffer(INITIAL_TOTAL_MEMORY);\n  }\n\n  INITIAL_TOTAL_MEMORY = buffer.byteLength;\n  updateGlobalBufferAndViews(buffer);\n  HEAP32[DYNAMICTOP_PTR >> 2] = DYNAMIC_BASE;\n\n  function callRuntimeCallbacks(callbacks) {\n    while (callbacks.length > 0) {\n      var callback = callbacks.shift();\n\n      if (typeof callback == \"function\") {\n        callback();\n        continue;\n      }\n\n      var func = callback.func;\n\n      if (typeof func === \"number\") {\n        if (callback.arg === undefined) {\n          Module[\"dynCall_v\"](func);\n        } else {\n          Module[\"dynCall_vi\"](func, callback.arg);\n        }\n      } else {\n        func(callback.arg === undefined ? null : callback.arg);\n      }\n    }\n  }\n\n  var __ATPRERUN__ = [];\n  var __ATINIT__ = [];\n  var __ATMAIN__ = [];\n  var __ATPOSTRUN__ = [];\n\n  function preRun() {\n    if (Module[\"preRun\"]) {\n      if (typeof Module[\"preRun\"] == \"function\") { Module[\"preRun\"] = [Module[\"preRun\"]]; }\n\n      while (Module[\"preRun\"].length) {\n        addOnPreRun(Module[\"preRun\"].shift());\n      }\n    }\n\n    callRuntimeCallbacks(__ATPRERUN__);\n  }\n\n  function initRuntime() {\n    callRuntimeCallbacks(__ATINIT__);\n  }\n\n  function preMain() {\n    callRuntimeCallbacks(__ATMAIN__);\n  }\n\n  function postRun() {\n    if (Module[\"postRun\"]) {\n      if (typeof Module[\"postRun\"] == \"function\") { Module[\"postRun\"] = [Module[\"postRun\"]]; }\n\n      while (Module[\"postRun\"].length) {\n        addOnPostRun(Module[\"postRun\"].shift());\n      }\n    }\n\n    callRuntimeCallbacks(__ATPOSTRUN__);\n  }\n\n  function addOnPreRun(cb) {\n    __ATPRERUN__.unshift(cb);\n  }\n\n  function addOnPostRun(cb) {\n    __ATPOSTRUN__.unshift(cb);\n  }\n\n  var Math_abs = Math.abs;\n  var Math_ceil = Math.ceil;\n  var Math_floor = Math.floor;\n  var Math_min = Math.min;\n  var runDependencies = 0;\n  var runDependencyWatcher = null;\n  var dependenciesFulfilled = null;\n\n  function addRunDependency(id) {\n    runDependencies++;\n\n    if (Module[\"monitorRunDependencies\"]) {\n      Module[\"monitorRunDependencies\"](runDependencies);\n    }\n  }\n\n  function removeRunDependency(id) {\n    runDependencies--;\n\n    if (Module[\"monitorRunDependencies\"]) {\n      Module[\"monitorRunDependencies\"](runDependencies);\n    }\n\n    if (runDependencies == 0) {\n      if (runDependencyWatcher !== null) {\n        clearInterval(runDependencyWatcher);\n        runDependencyWatcher = null;\n      }\n\n      if (dependenciesFulfilled) {\n        var callback = dependenciesFulfilled;\n        dependenciesFulfilled = null;\n        callback();\n      }\n    }\n  }\n\n  Module[\"preloadedImages\"] = {};\n  Module[\"preloadedAudios\"] = {};\n  var memoryInitializer = null;\n  var dataURIPrefix = \"data:application/octet-stream;base64,\";\n\n  function isDataURI(filename) {\n    return String.prototype.startsWith ? filename.startsWith(dataURIPrefix) : filename.indexOf(dataURIPrefix) === 0;\n  }\n\n  var tempDouble;\n  var tempI64;\n  memoryInitializer = \"data:application/octet-stream;base64,AAAAAAAAAAACAAAAAwAAAAEAAAAFAAAABAAAAAYAAAAAAAAAAAAAAAAAAAABAAAAAgAAAAMAAAAEAAAABQAAAAYAAAABAAAABAAAAAMAAAAGAAAABQAAAAIAAAAAAAAAAgAAAAMAAAABAAAABAAAAAYAAAAAAAAABQAAAAMAAAAGAAAABAAAAAUAAAAAAAAAAQAAAAIAAAAEAAAABQAAAAYAAAAAAAAAAgAAAAMAAAABAAAABQAAAAIAAAAAAAAAAQAAAAMAAAAGAAAABAAAAAYAAAAAAAAABQAAAAIAAAABAAAABAAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAAAAgAAAAMAAAAAAAAAAAAAAAIAAAAAAAAAAQAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAEAAAABgAAAAAAAAAFAAAAAAAAAAAAAAAEAAAABQAAAAAAAAAAAAAAAAAAAAIAAAAAAAAABgAAAAAAAAAGAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAACAAAAAwAAAAQAAAAFAAAABgAAAAEAAAACAAAAAwAAAAQAAAAFAAAABgAAAAAAAAACAAAAAwAAAAQAAAAFAAAABgAAAAAAAAABAAAAAwAAAAQAAAAFAAAABgAAAAAAAAABAAAAAgAAAAQAAAAFAAAABgAAAAAAAAABAAAAAgAAAAMAAAAFAAAABgAAAAAAAAABAAAAAgAAAAMAAAAEAAAABgAAAAAAAAABAAAAAgAAAAMAAAAEAAAABQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAADAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAACAAAAAgAAAAAAAAAAAAAABgAAAAAAAAADAAAAAgAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAUAAAAEAAAAAAAAAAEAAAAAAAAAAAAAAAUAAAAFAAAAAAAAAAAAAAAAAAAABgAAAAAAAAAEAAAAAAAAAAYAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAUAAAACAAAABAAAAAMAAAAIAAAA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AAAAAAAAAAAAAAAABQAAAAAAAAAAAAAABQAAAAAAAAAAAAAAAAAAAAUAAAABAAAAAAAAAAAAAAABAAAAAwAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAQAAAAMAAAAAAAAAAAAAAAEAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAMAAAAFAAAAAQAAAAAAAAAAAAAAAQAAAAAAAAABAAAAAAAAAAEAAAAAAAAA/////wMAAAAAAAAABQAAAAIAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAQAAAAFAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABQAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAwAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAUAAAAFAAAAAAAAAAAAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAUAAAAFAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAABAAAAAAAAAAEAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAMAAAAAAAAAAAAAAP////8DAAAAAAAAAAUAAAACAAAAAAAAAAAAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAADAAAAAwAAAAAAAAAAAAAAAQAAAAAAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAEAAAADAAAAAAAAAAAAAAABAAAAAAAAAAMAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABQAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAwAAAAAAAAADAAAAAAAAAAAAAAABAAAAAwAAAAAAAAAAAAAAAQAAAAAAAAADAAAAAwAAAAMAAAADAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAMAAAAAAAAA/////wMAAAAAAAAABQAAAAIAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAADAAAAAAAAAAAAAAADAAAAAAAAAAAAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAADAAAABQAAAAUAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAUAAAAFAAAAAAAAAAAAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAADAAAAAAAAAAAAAAABAAAAAAAAAAAAAAADAAAAAAAAAAAAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAMAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAADAAAAAwAAAAAAAAADAAAAAAAAAAAAAAD/////AwAAAAAAAAAFAAAAAgAAAAAAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAAAAAADAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAADAAAAAwAAAAAAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAMAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAMAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAMAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAAAAAD/////AwAAAAAAAAAFAAAAAgAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAMAAAADAAAAAwAAAAMAAAADAAAAAAAAAAAAAAADAAAAAwAAAAMAAAADAAAAAAAAAAMAAAAAAAAAAwAAAAMAAAADAAAAAwAAAAAAAAADAAAAAAAAAP////8DAAAAAAAAAAUAAAACAAAAAAAAAAAAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAAAAAADAAAAAwAAAAAAAAADAAAAAAAAAAAAAAADAAAAAwAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAMAAAAAAAAAAAAAAP////8DAAAAAAAAAAUAAAACAAAAAAAAAAAAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAMAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAUAAAAAAAAAAAAAAAMAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAMAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAEAAAADAAAAAQAAAAAAAAABAAAAAAAAAAAAAAADAAAAAAAAAAMAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAMAAAAAAAAA/////wMAAAAAAAAABQAAAAIAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAAAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAMAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAMAAAAAAAAAAAAAAAMAAAADAAAAAwAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAMAAAAAAAAABQAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAUAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAUAAAAFAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAADAAAAAAAAAAAAAAD/////AwAAAAAAAAAFAAAAAgAAAAAAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAADAAAAAAAAAAUAAAAAAAAAAAAAAAUAAAAFAAAAAAAAAAAAAAAAAAAAAQAAAAMAAAABAAAAAAAAAAEAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAADAAAAAAAAAAMAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAMAAAABAAAAAAAAAAEAAAAAAAAAAwAAAAMAAAADAAAAAwAAAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAQAAAAAAAAADAAAABQAAAAEAAAAAAAAA/////wMAAAAAAAAABQAAAAIAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAUAAAAFAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAEAAAABQAAAAEAAAAAAAAAAwAAAAMAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAFAAAAAAAAAAAAAAAAAAAAAAAAAAMAAAAAAAAABQAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAgAAAAUAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAQAAAAMAAAABAAAAAAAAAAEAAAAAAAAABQAAAAAAAAAAAAAABQAAAAUAAAAAAAAAAAAAAP////8BAAAAAAAAAAMAAAAEAAAAAgAAAAAAAAAAAAAAAQAAAAAAAAAAAAAABQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAUAAAAAAAAAAAAAAAUAAAAFAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAABAAAABQAAAAEAAAAAAAAAAAAAAAEAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAAAAAAAAAAAAAAQAAAP//////////AQAAAAEAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAACAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAABAAAAAQAAAAAAAAAAAAAAAAAAAAMAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAACwAAAAIAAAAAAAAAAAAAAAEAAAACAAAABgAAAAQAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABgAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAACAAAAAAAAAAEAAAABAAAAAAAAAAAAAAAAAAAABwAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAIAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAABgAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAoAAAACAAAAAAAAAAAAAAABAAAAAQAAAAUAAAAGAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAsAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABQAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAHAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAACwAAAAEAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAAAAAIAAAAAAAAAAAAAAAEAAAADAAAABwAAAAYAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAHAAAAAQAAAAAAAAABAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAMAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAEAAAABAAAAAAAAAAAAAAAAAAAABAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAYAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAOAAAAAgAAAAAAAAAAAAAAAQAAAAAAAAAJAAAABQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAABAAAAAQAAAAAAAAAAAAAAAAAAAAwAAAABAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAHAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACwAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAoAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAANAAAAAgAAAAAAAAAAAAAAAQAAAAQAAAAIAAAACgAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAsAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAJAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAYAAAACAAAAAAAAAAAAAAABAAAACwAAAA8AAAAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACQAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAA4AAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFAAAAAQAAAAAAAAABAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAABAAAAAQAAAAAAAAAAAAAAAAAAAAgAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAFAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAcAAAACAAAAAAAAAAAAAAABAAAADAAAABAAAAAMAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAACgAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAkAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAANAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAA8AAAAAAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAPAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAA4AAAABAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAANAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAABQAAAAIAAAAAAAAAAAAAAAEAAAAKAAAAEwAAAAgAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAOAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACQAAAAEAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAA4AAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAARAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAADAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAARAAAAAAAAAAEAAAABAAAAAAAAAAAAAAAAAAAADwAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAABAAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAJAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA0AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIAAAAAgAAAAAAAAAAAAAAAQAAAA0AAAARAAAADQAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAABEAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAATAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAADgAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAABMAAAAAAAAAAQAAAAEAAAAAAAAAAAAAAAAAAAARAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAADQAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAABEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACQAAAAIAAAAAAAAAAAAAAAEAAAAOAAAAEgAAAA8AAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAPAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEgAAAAAAAAABAAAAAQAAAAAAAAAAAAAAAAAAABIAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAATAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAEQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAASAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAEgAAAAEAAAAAAAAAAQAAAAAAAAAAAAAAAAAAABMAAAACAAAAAAAAAAAAAAABAAAA//////////8TAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABMAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAASAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAABIAAAAAAAAAGAAAAAAAAAAhAAAAAAAAAB4AAAAAAAAAIAAAAAMAAAAxAAAAAQAAADAAAAADAAAAMgAAAAMAAAAIAAAAAAAAAAUAAAAFAAAACgAAAAUAAAAWAAAAAAAAABAAAAAAAAAAEgAAAAAAAAApAAAAAQAAACEAAAAAAAAAHgAAAAAAAAAEAAAAAAAAAAAAAAAFAAAAAgAAAAUAAAAPAAAAAQAAAAgAAAAAAAAABQAAAAUAAAAfAAAAAQAAABYAAAAAAAAAEAAAAAAAAAACAAAAAAAAAAYAAAAAAAAADgAAAAAAAAAKAAAAAAAAAAsAAAAAAAAAEQAAAAMAAAAYAAAAAQAAABcAAAADAAAAGQAAAAMAAAAAAAAAAAAAAAEAAAAFAAAACQAAAAUAAAAFAAAAAAAAAAIAAAAAAAAABgAAAAAAAAASAAAAAQAAAAoAAAAAAAAACwAAAAAAAAAEAAAAAQAAAAMAAAAFAAAABwAAAAUAAAAIAAAAAQAAAAAAAAAAAAAAAQAAAAUAAAAQAAAAAQAAAAUAAAAAAAAAAgAAAAAAAAAHAAAAAAAAABUAAAAAAAAAJgAAAAAAAAAJAAAAAAAAABMAAAAAAAAAIgAAAAMAAAAOAAAAAQAAABQAAAADAAAAJAAAAAMAAAADAAAAAAAAAA0AAAAFAAAAHQAAAAUAAAABAAAAAAAAAAcAAAAAAAAAFQAAAAAAAAAGAAAA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74auECWhw7+cjSACjzniv8CZ+wUhN9I/1uGEKzup6z+/GYr/04bavwmkNHp7xee/F2NMZVAA1z+82s+x2BLivwr2ytbJ9em/KwEH1sMS1r8yp/2LhTfev81i5RexJsy/BlIKPVwR5b95Wyu0/Qjnv5DjoT7YYcs/nBhKZ6zrwr8wRYS7Nebuv3OW6geh+Lu/SLrixebL3j+pcyymN9Xrv8rHIFfWehZAMBwUdlo0DECTUc17EOb2PxpVB1SWChdAzjbhb9pTDUDQhmdvECX5P9FlMKCC9+g/IIAzjELgE0DajDngMv8GQFhWDmDPjNs/y1guLh96EkAxPi8k7DIEQJCc4URlhRhA3eLKKLwkEECqpNAyTBD/P6xpjXcDiwVAFtl//cQm4z+Ibt3XKiYTQM7mCLUb3QdAoM1t8yVv7D8aLZv2Nk8UQEAJPV5nQwxAtSsfTCoE9z9TPjXLXIIWQBVanC5W9AtAYM3d7Adm9j++5mQz1FoWQBUThyaVBghAwH5muQsV7T89Q1qv82MUQJoWGOfNuBdAzrkClkmwDkDQjKq77t37Py+g0dtitsE/ZwAMTwVPEUBojepluNwBQGYbtuW+t9w/HNWIJs6MEkDTNuQUSlgEQKxktPP5TcQ/ixbLB8JjEUCwuWjXMQYCQAS/R09FkRdAowpiZjhhDkB7LmlczD/7P01iQmhhsAVAnrtTwDy84z/Z6jfQ2TgTQChOCXMnWwpAhrW3daoz8z/HYJvVPI4VQLT3ik5FcA5Angi7LOZd+z+NNVzDy5gXQBXdvVTFUA1AYNMgOeYe+T8+qHXGCwkXQKQTOKwa5AJA8gFVoEMW0T+FwzJyttIRQAEAAAD/////BwAAAP////8xAAAA/////1cBAAD/////YQkAAP////+nQQAA/////5HLAQD/////95AMAP/////B9lcAAAAAAAAAAAAAAAAAAgAAAP////8OAAAA/////2IAAAD/////rgIAAP/////CEgAA/////06DAAD/////IpcDAP/////uIRkA/////4LtrwAAAAAAAAAAAAAAAAAAAAAAAgAAAP//////////AQAAAAMAAAD//////////////////////////////////////////////////////////////////////////wEAAAAAAAAAAgAAAP///////////////wMAAAD//////////////////////////////////////////////////////////////////////////wEAAAAAAAAAAgAAAP///////////////wMAAAD//////////////////////////////////////////////////////////////////////////wEAAAAAAAAAAgAAAP///////////////wMAAAD//////////////////////////////////////////////////////////wIAAAD//////////wEAAAAAAAAA/////////////////////wMAAAD/////////////////////////////////////////////////////AwAAAP////////////////////8AAAAA/////////////////////wEAAAD///////////////8CAAAA////////////////////////////////AwAAAP////////////////////8AAAAA////////////////AgAAAAEAAAD/////////////////////////////////////////////////////AwAAAP////////////////////8AAAAA////////////////AgAAAAEAAAD/////////////////////////////////////////////////////AwAAAP////////////////////8AAAAA////////////////AgAAAAEAAAD/////////////////////////////////////////////////////AwAAAP////////////////////8AAAAA////////////////AgAAAAEAAAD/////////////////////////////////////////////////////AQAAAAIAAAD///////////////8AAAAA/////////////////////wMAAAD/////////////////////////////////////////////////////AQAAAAIAAAD///////////////8AAAAA/////////////////////wMAAAD/////////////////////////////////////////////////////AQAAAAIAAAD///////////////8AAAAA/////////////////////wMAAAD/////////////////////////////////////////////////////AQAAAAIAAAD///////////////8AAAAA/////////////////////wMAAAD///////////////////////////////8CAAAA////////////////AQAAAP////////////////////8AAAAA/////////////////////wMAAAD/////////////////////////////////////////////////////AwAAAP////////////////////8AAAAAAQAAAP//////////AgAAAP//////////////////////////////////////////////////////////AwAAAP///////////////wIAAAAAAAAAAQAAAP//////////////////////////////////////////////////////////////////////////AwAAAP///////////////wIAAAAAAAAAAQAAAP//////////////////////////////////////////////////////////////////////////AwAAAP///////////////wIAAAAAAAAAAQAAAP//////////////////////////////////////////////////////////////////////////AwAAAAEAAAD//////////wIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAgAAAAAAAAACAAAAAQAAAAEAAAACAAAAAgAAAAAAAAAFAAAABQAAAAAAAAACAAAAAgAAAAMAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAAAAAAIAAAABAAAAAgAAAAIAAAACAAAAAAAAAAUAAAAGAAAAAAAAAAIAAAACAAAAAwAAAAIAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAIAAAAAAAAAAgAAAAEAAAADAAAAAgAAAAIAAAAAAAAABQAAAAcAAAAAAAAAAgAAAAIAAAADAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAgAAAAAAAAACAAAAAQAAAAQAAAACAAAAAgAAAAAAAAAFAAAACAAAAAAAAAACAAAAAgAAAAMAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAMAAAACAAAAAAAAAAIAAAABAAAAAAAAAAIAAAACAAAAAAAAAAUAAAAJAAAAAAAAAAIAAAACAAAAAwAAAAUAAAAAAAAAAAAAAAAAAAAAAAAACgAAAAIAAAACAAAAAAAAAAMAAAAOAAAAAgAAAAAAAAACAAAAAwAAAAAAAAAAAAAAAgAAAAIAAAADAAAABgAAAAAAAAAAAAAAAAAAAAAAAAALAAAAAgAAAAIAAAAAAAAAAwAAAAoAAAACAAAAAAAAAAIAAAADAAAAAQAAAAAAAAACAAAAAgAAAAMAAAAHAAAAAAAAAAAAAAAAAAAAAAAAAAwAAAACAAAAAgAAAAAAAAADAAAACwAAAAIAAAAAAAAAAgAAAAMAAAACAAAAAAAAAAIAAAACAAAAAwAAAAgAAAAAAAAAAAAAAAAAAAAAAAAADQAAAAIAAAACAAAAAAAAAAMAAAAMAAAAAgAAAAAAAAACAAAAAwAAAAMAAAAAAAAAAgAAAAIAAAADAAAACQAAAAAAAAAAAAAAAAAAAAAAAAAOAAAAAgAAAAIAAAAAAAAAAwAAAA0AAAACAAAAAAAAAAIAAAADAAAABAAAAAAAAAACAAAAAgAAAAMAAAAKAAAAAAAAAAAAAAAAAAAAAAAAAAUAAAACAAAAAgAAAAAAAAADAAAABgAAAAIAAAAAAAAAAgAAAAMAAAAPAAAAAAAAAAIAAAACAAAAAwAAAAsAAAAAAAAAAAAAAAAAAAAAAAAABgAAAAIAAAACAAAAAAAAAAMAAAAHAAAAAgAAAAAAAAACAAAAAwAAABAAAAAAAAAAAgAAAAIAAAADAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAHAAAAAgAAAAIAAAAAAAAAAwAAAAgAAAACAAAAAAAAAAIAAAADAAAAEQAAAAAAAAACAAAAAgAAAAMAAAANAAAAAAAAAAAAAAAAAAAAAAAAAAgAAAACAAAAAgAAAAAAAAADAAAACQAAAAIAAAAAAAAAAgAAAAMAAAASAAAAAAAAAAIAAAACAAAAAwAAAA4AAAAAAAAAAAAAAAAAAAAAAAAACQAAAAIAAAACAAAAAAAAAAMAAAAFAAAAAgAAAAAAAAACAAAAAwAAABMAAAAAAAAAAgAAAAIAAAADAAAA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AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/////////////////////////////////////wAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAUAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAUAAAABAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP////////////////////////////////////8AAAAAAQAAAAEAAAABAAAAAQAAAAEAAAABAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAABAAAAAAAAAAAAAAABAAAAAQAAAAEAAAAAAAAAAQAAAAAAAAAFAAAAAQAAAAEAAAAAAAAAAAAAAAEAAAABAAAAAAAAAAEAAAABAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEBAAAAAAABAAEAAAEBAAAAAAABAAAAAQAAAAEAAQAAAAAAAAAAAAAAAAAAAAAEAAAABAAAAAAAAAACAAAAAQAAAAMAAAAOAAAABgAAAAsAAAACAAAABwAAAAEAAAAYAAAABQAAAAoAAAABAAAABgAAAAAAAAAmAAAABwAAAAwAAAADAAAACAAAAAIAAAAxAAAACQAAAA4AAAAAAAAABQAAAAQAAAA6AAAACAAAAA0AAAAEAAAACQAAAAMAAAA/AAAACwAAAAYAAAAPAAAACgAAABAAAABIAAAADAAAAAcAAAAQAAAACwAAABEAAABTAAAACgAAAAUAAAATAAAADgAAAA8AAABhAAAADQAAAAgAAAARAAAADAAAABIAAABrAAAADgAAAAkAAAASAAAADQAAABMAAAB1AAAADwAAABMAAAARAAAAEgAAABAAAAAHAAAABwAAAAEAAAACAAAABAAAAAMAAAAAAAAAAAAAAAcAAAADAAAAAQAAAAIAAAAFAAAABAAAAAAAAAAAAAAAYWxnb3MuYwBfcG9seWZpbGxJbnRlcm5hbABhZGphY2VudEZhY2VEaXJbdG1wRmlqay5mYWNlXVtmaWprLmZhY2VdID09IEtJAGZhY2VpamsuYwBfZmFjZUlqa1BlbnRUb0dlb0JvdW5kYXJ5AGFkamFjZW50RmFjZURpcltjZW50ZXJJSksuZmFjZV1bZmFjZTJdID09IEtJAF9mYWNlSWprVG9HZW9Cb3VuZGFyeQBwb2x5Z29uLT5uZXh0ID09IE5VTEwAbGlua2VkR2VvLmMAYWRkTmV3TGlua2VkUG9seWdvbgBuZXh0ICE9IE5VTEwAbG9vcCAhPSBOVUxMAGFkZE5ld0xpbmtlZExvb3AAcG9seWdvbi0+Zmlyc3QgPT0gTlVMTABhZGRMaW5rZWRMb29wAGNvb3JkICE9IE5VTEwAYWRkTGlua2VkQ29vcmQAbG9vcC0+Zmlyc3QgPT0gTlVMTABpbm5lckxvb3BzICE9IE5VTEwAbm9ybWFsaXplTXVsdGlQb2x5Z29uAGJib3hlcyAhPSBOVUxMAGNhbmRpZGF0ZXMgIT0gTlVMTABmaW5kUG9seWdvbkZvckhvbGUAY2FuZGlkYXRlQkJveGVzICE9IE5VTEwAcmV2RGlyICE9IElOVkFMSURfRElHSVQAbG9jYWxpai5jAGgzVG9Mb2NhbElqawBiYXNlQ2VsbCAhPSBvcmlnaW5CYXNlQ2VsbAAhKG9yaWdpbk9uUGVudCAmJiBpbmRleE9uUGVudCkAcGVudGFnb25Sb3RhdGlvbnMgPj0gMABkaXJlY3Rpb25Sb3RhdGlvbnMgPj0gMABiYXNlQ2VsbCA9PSBvcmlnaW5CYXNlQ2VsbABiYXNlQ2VsbCAhPSBJTlZBTElEX0JBU0VfQ0VMTABsb2NhbElqa1RvSDMAIV9pc0Jhc2VDZWxsUGVudGFnb24oYmFzZUNlbGwpAGJhc2VDZWxsUm90YXRpb25zID49IDAAd2l0aGluUGVudGFnb25Sb3RhdGlvbnMgPj0gMABncmFwaC0+YnVja2V0cyAhPSBOVUxMAHZlcnRleEdyYXBoLmMAaW5pdFZlcnRleEdyYXBoAG5vZGUgIT0gTlVMTABhZGRWZXJ0ZXhOb2Rl\";\n  var tempDoublePtr = 24032;\n\n  function demangle(func) {\n    return func;\n  }\n\n  function demangleAll(text) {\n    var regex = /\\b__Z[\\w\\d_]+/g;\n    return text.replace(regex, function (x) {\n      var y = demangle(x);\n      return x === y ? x : y + \" [\" + x + \"]\";\n    });\n  }\n\n  function jsStackTrace() {\n    var err = new Error();\n\n    if (!err.stack) {\n      try {\n        throw new Error(0);\n      } catch (e) {\n        err = e;\n      }\n\n      if (!err.stack) {\n        return \"(no stack trace available)\";\n      }\n    }\n\n    return err.stack.toString();\n  }\n\n  function stackTrace() {\n    var js = jsStackTrace();\n    if (Module[\"extraStackTrace\"]) { js += \"\\n\" + Module[\"extraStackTrace\"](); }\n    return demangleAll(js);\n  }\n\n  function ___assert_fail(condition, filename, line, func) {\n    abort(\"Assertion failed: \" + UTF8ToString(condition) + \", at: \" + [filename ? UTF8ToString(filename) : \"unknown filename\", line, func ? UTF8ToString(func) : \"unknown function\"]);\n  }\n\n  function _emscripten_get_heap_size() {\n    return HEAP8.length;\n  }\n\n  function _emscripten_memcpy_big(dest, src, num) {\n    HEAPU8.set(HEAPU8.subarray(src, src + num), dest);\n  }\n\n  function ___setErrNo(value) {\n    if (Module[\"___errno_location\"]) { HEAP32[Module[\"___errno_location\"]() >> 2] = value; }\n    return value;\n  }\n\n  function abortOnCannotGrowMemory(requestedSize) {\n    abort(\"OOM\");\n  }\n\n  function emscripten_realloc_buffer(size) {\n    try {\n      var newBuffer = new ArrayBuffer(size);\n      if (newBuffer.byteLength != size) { return; }\n      new Int8Array(newBuffer).set(HEAP8);\n\n      _emscripten_replace_memory(newBuffer);\n\n      updateGlobalBufferAndViews(newBuffer);\n      return 1;\n    } catch (e) {}\n  }\n\n  function _emscripten_resize_heap(requestedSize) {\n    var oldSize = _emscripten_get_heap_size();\n\n    var PAGE_MULTIPLE = 16777216;\n    var LIMIT = 2147483648 - PAGE_MULTIPLE;\n\n    if (requestedSize > LIMIT) {\n      return false;\n    }\n\n    var MIN_TOTAL_MEMORY = 16777216;\n    var newSize = Math.max(oldSize, MIN_TOTAL_MEMORY);\n\n    while (newSize < requestedSize) {\n      if (newSize <= 536870912) {\n        newSize = alignUp(2 * newSize, PAGE_MULTIPLE);\n      } else {\n        newSize = Math.min(alignUp((3 * newSize + 2147483648) / 4, PAGE_MULTIPLE), LIMIT);\n      }\n    }\n\n    var replacement = emscripten_realloc_buffer(newSize);\n\n    if (!replacement) {\n      return false;\n    }\n\n    return true;\n  }\n\n  var decodeBase64 = typeof atob === \"function\" ? atob : function (input) {\n    var keyStr = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=\";\n    var output = \"\";\n    var chr1, chr2, chr3;\n    var enc1, enc2, enc3, enc4;\n    var i = 0;\n    input = input.replace(/[^A-Za-z0-9\\+\\/\\=]/g, \"\");\n\n    do {\n      enc1 = keyStr.indexOf(input.charAt(i++));\n      enc2 = keyStr.indexOf(input.charAt(i++));\n      enc3 = keyStr.indexOf(input.charAt(i++));\n      enc4 = keyStr.indexOf(input.charAt(i++));\n      chr1 = enc1 << 2 | enc2 >> 4;\n      chr2 = (enc2 & 15) << 4 | enc3 >> 2;\n      chr3 = (enc3 & 3) << 6 | enc4;\n      output = output + String.fromCharCode(chr1);\n\n      if (enc3 !== 64) {\n        output = output + String.fromCharCode(chr2);\n      }\n\n      if (enc4 !== 64) {\n        output = output + String.fromCharCode(chr3);\n      }\n    } while (i < input.length);\n\n    return output;\n  };\n\n  function intArrayFromBase64(s) {\n    try {\n      var decoded = decodeBase64(s);\n      var bytes = new Uint8Array(decoded.length);\n\n      for (var i = 0; i < decoded.length; ++i) {\n        bytes[i] = decoded.charCodeAt(i);\n      }\n\n      return bytes;\n    } catch (_) {\n      throw new Error(\"Converting base64 string to bytes failed.\");\n    }\n  }\n\n  function tryParseAsDataURI(filename) {\n    if (!isDataURI(filename)) {\n      return;\n    }\n\n    return intArrayFromBase64(filename.slice(dataURIPrefix.length));\n  }\n\n  var asmGlobalArg = {\n    \"Math\": Math,\n    \"Int8Array\": Int8Array,\n    \"Int32Array\": Int32Array,\n    \"Uint8Array\": Uint8Array,\n    \"Float32Array\": Float32Array,\n    \"Float64Array\": Float64Array\n  };\n  var asmLibraryArg = {\n    \"a\": abort,\n    \"b\": setTempRet0,\n    \"c\": getTempRet0,\n    \"d\": ___assert_fail,\n    \"e\": ___setErrNo,\n    \"f\": _emscripten_get_heap_size,\n    \"g\": _emscripten_memcpy_big,\n    \"h\": _emscripten_resize_heap,\n    \"i\": abortOnCannotGrowMemory,\n    \"j\": demangle,\n    \"k\": demangleAll,\n    \"l\": emscripten_realloc_buffer,\n    \"m\": jsStackTrace,\n    \"n\": stackTrace,\n    \"o\": tempDoublePtr,\n    \"p\": DYNAMICTOP_PTR\n  }; // EMSCRIPTEN_START_ASM\n\n  var asm =\n  /** @suppress {uselessCode} */\n  function (global, env, buffer) {\n    \"almost asm\";\n\n    var a = new global.Int8Array(buffer),\n        b = new global.Int32Array(buffer),\n        c = new global.Uint8Array(buffer),\n        d = new global.Float32Array(buffer),\n        e = new global.Float64Array(buffer),\n        g = env.p | 0,\n        p = global.Math.floor,\n        q = global.Math.abs,\n        r = global.Math.sqrt,\n        s = global.Math.pow,\n        t = global.Math.cos,\n        u = global.Math.sin,\n        v = global.Math.tan,\n        w = global.Math.acos,\n        x = global.Math.asin,\n        y = global.Math.atan,\n        z = global.Math.atan2,\n        A = global.Math.ceil,\n        B = global.Math.imul,\n        C = global.Math.min,\n        D = global.Math.clz32,\n        F = env.b,\n        G = env.c,\n        H = env.d,\n        I = env.e,\n        J = env.f,\n        K = env.g,\n        L = env.h,\n        M = env.i,\n        S = 24048;\n\n    function V(newBuffer) {\n      a = new Int8Array(newBuffer);\n      c = new Uint8Array(newBuffer);\n      b = new Int32Array(newBuffer);\n      d = new Float32Array(newBuffer);\n      e = new Float64Array(newBuffer);\n      buffer = newBuffer;\n      return true;\n    } // EMSCRIPTEN_START_FUNCS\n\n\n    function W(a) {\n      a = a | 0;\n      var b = 0;\n      b = S;\n      S = S + a | 0;\n      S = S + 15 & -16;\n      return b | 0;\n    }\n\n    function X() {\n      return S | 0;\n    }\n\n    function Y(a) {\n      a = a | 0;\n      S = a;\n    }\n\n    function Z(a, b) {\n      a = a | 0;\n      b = b | 0;\n      S = a;\n    }\n\n    function _(a) {\n      a = a | 0;\n      return (B(a * 3 | 0, a + 1 | 0) | 0) + 1 | 0;\n    }\n\n    function $(a, b, c, d) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0;\n      if (!(ba(a, b, c, d, 0) | 0)) { return; }\n      f = (B(c * 3 | 0, c + 1 | 0) | 0) + 1 | 0;\n      hd(d | 0, 0, f << 3 | 0) | 0;\n      e = Yc(f, 4) | 0;\n      if (!e) { return; }\n      ca(a, b, c, d, e, f, 0);\n      Xc(e);\n      return;\n    }\n\n    function aa(a, b, c, d, e) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      var f = 0;\n      if (!(ba(a, b, c, d, e) | 0)) { return; }\n      f = (B(c * 3 | 0, c + 1 | 0) | 0) + 1 | 0;\n      hd(d | 0, 0, f << 3 | 0) | 0;\n\n      if (e | 0) {\n        hd(e | 0, 0, f << 2 | 0) | 0;\n        ca(a, b, c, d, e, f, 0);\n        return;\n      }\n\n      e = Yc(f, 4) | 0;\n      if (!e) { return; }\n      ca(a, b, c, d, e, f, 0);\n      Xc(e);\n      return;\n    }\n\n    function ba(a, c, d, e, f) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      f = f | 0;\n      var g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0;\n      o = S;\n      S = S + 16 | 0;\n      n = o;\n      g = e;\n      b[g >> 2] = a;\n      b[g + 4 >> 2] = c;\n      g = (f | 0) != 0;\n      if (g) { b[f >> 2] = 0; }\n\n      if (Fb(a, c) | 0) {\n        n = 1;\n        S = o;\n        return n | 0;\n      }\n\n      b[n >> 2] = 0;\n\n      a: do { if ((d | 0) >= 1) {\n        if (g) {\n          k = 0;\n          l = 1;\n          m = 1;\n          h = 0;\n          g = a;\n\n          while (1) {\n            if (!(h | k)) {\n              g = da(g, c, 4, n) | 0;\n              c = G() | 0;\n\n              if ((g | 0) == 0 & (c | 0) == 0) {\n                g = 2;\n                break a;\n              }\n\n              if (Fb(g, c) | 0) {\n                g = 1;\n                break a;\n              }\n            }\n\n            g = da(g, c, b[16 + (k << 2) >> 2] | 0, n) | 0;\n            c = G() | 0;\n\n            if ((g | 0) == 0 & (c | 0) == 0) {\n              g = 2;\n              break a;\n            }\n\n            a = e + (m << 3) | 0;\n            b[a >> 2] = g;\n            b[a + 4 >> 2] = c;\n            b[f + (m << 2) >> 2] = l;\n            h = h + 1 | 0;\n            a = (h | 0) == (l | 0);\n            i = k + 1 | 0;\n            j = (i | 0) == 6;\n\n            if (Fb(g, c) | 0) {\n              g = 1;\n              break a;\n            }\n\n            l = l + (j & a & 1) | 0;\n\n            if ((l | 0) > (d | 0)) {\n              g = 0;\n              break;\n            } else {\n              k = a ? j ? 0 : i : k;\n              m = m + 1 | 0;\n              h = a ? 0 : h;\n            }\n          }\n        } else {\n          k = 0;\n          l = 1;\n          m = 1;\n          h = 0;\n          g = a;\n\n          while (1) {\n            if (!(h | k)) {\n              g = da(g, c, 4, n) | 0;\n              c = G() | 0;\n\n              if ((g | 0) == 0 & (c | 0) == 0) {\n                g = 2;\n                break a;\n              }\n\n              if (Fb(g, c) | 0) {\n                g = 1;\n                break a;\n              }\n            }\n\n            g = da(g, c, b[16 + (k << 2) >> 2] | 0, n) | 0;\n            c = G() | 0;\n\n            if ((g | 0) == 0 & (c | 0) == 0) {\n              g = 2;\n              break a;\n            }\n\n            a = e + (m << 3) | 0;\n            b[a >> 2] = g;\n            b[a + 4 >> 2] = c;\n            h = h + 1 | 0;\n            a = (h | 0) == (l | 0);\n            i = k + 1 | 0;\n            j = (i | 0) == 6;\n\n            if (Fb(g, c) | 0) {\n              g = 1;\n              break a;\n            }\n\n            l = l + (j & a & 1) | 0;\n\n            if ((l | 0) > (d | 0)) {\n              g = 0;\n              break;\n            } else {\n              k = a ? j ? 0 : i : k;\n              m = m + 1 | 0;\n              h = a ? 0 : h;\n            }\n          }\n        }\n      } else { g = 0; } } while (0);\n\n      n = g;\n      S = o;\n      return n | 0;\n    }\n\n    function ca(a, c, d, e, f, g, h) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      f = f | 0;\n      g = g | 0;\n      h = h | 0;\n      var i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0;\n      m = S;\n      S = S + 16 | 0;\n      l = m;\n\n      if ((a | 0) == 0 & (c | 0) == 0) {\n        S = m;\n        return;\n      }\n\n      i = bd(a | 0, c | 0, g | 0, ((g | 0) < 0) << 31 >> 31 | 0) | 0;\n      G() | 0;\n      j = e + (i << 3) | 0;\n      n = j;\n      o = b[n >> 2] | 0;\n      n = b[n + 4 >> 2] | 0;\n      k = (o | 0) == (a | 0) & (n | 0) == (c | 0);\n      if (!((o | 0) == 0 & (n | 0) == 0 | k)) { do {\n        i = (i + 1 | 0) % (g | 0) | 0;\n        j = e + (i << 3) | 0;\n        o = j;\n        n = b[o >> 2] | 0;\n        o = b[o + 4 >> 2] | 0;\n        k = (n | 0) == (a | 0) & (o | 0) == (c | 0);\n      } while (!((n | 0) == 0 & (o | 0) == 0 | k)); }\n      i = f + (i << 2) | 0;\n\n      if (k ? (b[i >> 2] | 0) <= (h | 0) : 0) {\n        S = m;\n        return;\n      }\n\n      o = j;\n      b[o >> 2] = a;\n      b[o + 4 >> 2] = c;\n      b[i >> 2] = h;\n\n      if ((h | 0) >= (d | 0)) {\n        S = m;\n        return;\n      }\n\n      o = h + 1 | 0;\n      b[l >> 2] = 0;\n      n = da(a, c, 2, l) | 0;\n      ca(n, G() | 0, d, e, f, g, o);\n      b[l >> 2] = 0;\n      n = da(a, c, 3, l) | 0;\n      ca(n, G() | 0, d, e, f, g, o);\n      b[l >> 2] = 0;\n      n = da(a, c, 1, l) | 0;\n      ca(n, G() | 0, d, e, f, g, o);\n      b[l >> 2] = 0;\n      n = da(a, c, 5, l) | 0;\n      ca(n, G() | 0, d, e, f, g, o);\n      b[l >> 2] = 0;\n      n = da(a, c, 4, l) | 0;\n      ca(n, G() | 0, d, e, f, g, o);\n      b[l >> 2] = 0;\n      n = da(a, c, 6, l) | 0;\n      ca(n, G() | 0, d, e, f, g, o);\n      S = m;\n      return;\n    }\n\n    function da(a, c, d, e) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      var f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0;\n\n      if ((b[e >> 2] | 0) > 0) {\n        f = 0;\n\n        do {\n          d = Pa(d) | 0;\n          f = f + 1 | 0;\n        } while ((f | 0) < (b[e >> 2] | 0));\n      }\n\n      i = cd(a | 0, c | 0, 45) | 0;\n      G() | 0;\n      j = i & 127;\n      g = Lb(a, c) | 0;\n      f = cd(a | 0, c | 0, 52) | 0;\n      G() | 0;\n      f = f & 15;\n\n      a: do { if (!f) { h = 6; }else { while (1) {\n        m = (15 - f | 0) * 3 | 0;\n        n = cd(a | 0, c | 0, m | 0) | 0;\n        G() | 0;\n        n = n & 7;\n        o = (Rb(f) | 0) == 0;\n        f = f + -1 | 0;\n        l = dd(7, 0, m | 0) | 0;\n        c = c & ~(G() | 0);\n        m = dd(b[(o ? 464 : 48) + (n * 28 | 0) + (d << 2) >> 2] | 0, 0, m | 0) | 0;\n        k = G() | 0;\n        d = b[(o ? 672 : 256) + (n * 28 | 0) + (d << 2) >> 2] | 0;\n        a = m | a & ~l;\n        c = k | c;\n\n        if (!d) {\n          d = 0;\n          break a;\n        }\n\n        if (!f) {\n          h = 6;\n          break;\n        }\n      } } } while (0);\n\n      if ((h | 0) == 6) {\n        o = b[880 + (j * 28 | 0) + (d << 2) >> 2] | 0;\n        n = dd(o | 0, 0, 45) | 0;\n        a = n | a;\n        c = G() | 0 | c & -1040385;\n        d = b[4304 + (j * 28 | 0) + (d << 2) >> 2] | 0;\n\n        if ((o & 127 | 0) == 127) {\n          o = dd(b[880 + (j * 28 | 0) + 20 >> 2] | 0, 0, 45) | 0;\n          c = G() | 0 | c & -1040385;\n          d = b[4304 + (j * 28 | 0) + 20 >> 2] | 0;\n          a = Nb(o | a, c) | 0;\n          c = G() | 0;\n          b[e >> 2] = (b[e >> 2] | 0) + 1;\n        }\n      }\n\n      h = cd(a | 0, c | 0, 45) | 0;\n      G() | 0;\n      h = h & 127;\n\n      b: do { if (!(la(h) | 0)) {\n        if ((d | 0) > 0) {\n          f = 0;\n\n          do {\n            a = Nb(a, c) | 0;\n            c = G() | 0;\n            f = f + 1 | 0;\n          } while ((f | 0) != (d | 0));\n        }\n      } else {\n        c: do { if ((Lb(a, c) | 0) == 1) {\n          if ((j | 0) != (h | 0)) { if (ra(h, b[7728 + (j * 28 | 0) >> 2] | 0) | 0) {\n            a = Pb(a, c) | 0;\n            g = 1;\n            c = G() | 0;\n            break;\n          } else {\n            a = Nb(a, c) | 0;\n            g = 1;\n            c = G() | 0;\n            break;\n          } }\n\n          switch (g | 0) {\n            case 5:\n              {\n                a = Pb(a, c) | 0;\n                c = G() | 0;\n                b[e >> 2] = (b[e >> 2] | 0) + 5;\n                g = 0;\n                break c;\n              }\n\n            case 3:\n              {\n                a = Nb(a, c) | 0;\n                c = G() | 0;\n                b[e >> 2] = (b[e >> 2] | 0) + 1;\n                g = 0;\n                break c;\n              }\n\n            default:\n              {\n                n = 0;\n                o = 0;\n                F(n | 0);\n                return o | 0;\n              }\n          }\n        } else { g = 0; } } while (0);\n\n        if ((d | 0) > 0) {\n          f = 0;\n\n          do {\n            a = Mb(a, c) | 0;\n            c = G() | 0;\n            f = f + 1 | 0;\n          } while ((f | 0) != (d | 0));\n        }\n\n        if ((j | 0) != (h | 0)) {\n          if (!(ma(h) | 0)) {\n            if ((g | 0) != 0 | (Lb(a, c) | 0) != 5) { break; }\n            b[e >> 2] = (b[e >> 2] | 0) + 1;\n            break;\n          }\n\n          switch (i & 127) {\n            case 8:\n            case 118:\n              break b;\n\n            default:\n\n          }\n\n          if ((Lb(a, c) | 0) != 3) { b[e >> 2] = (b[e >> 2] | 0) + 1; }\n        }\n      } } while (0);\n\n      b[e >> 2] = ((b[e >> 2] | 0) + d | 0) % 6 | 0;\n      n = c;\n      o = a;\n      F(n | 0);\n      return o | 0;\n    }\n\n    function ea(a, c, d, e) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      var f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0;\n      m = S;\n      S = S + 16 | 0;\n      l = m;\n\n      if (!d) {\n        l = e;\n        b[l >> 2] = a;\n        b[l + 4 >> 2] = c;\n        l = 0;\n        S = m;\n        return l | 0;\n      }\n\n      b[l >> 2] = 0;\n\n      a: do { if (!(Fb(a, c) | 0)) {\n        g = (d | 0) > 0;\n\n        if (g) {\n          f = 0;\n          k = a;\n\n          do {\n            k = da(k, c, 4, l) | 0;\n            c = G() | 0;\n\n            if ((k | 0) == 0 & (c | 0) == 0) {\n              a = 2;\n              break a;\n            }\n\n            f = f + 1 | 0;\n\n            if (Fb(k, c) | 0) {\n              a = 1;\n              break a;\n            }\n          } while ((f | 0) < (d | 0));\n\n          j = e;\n          b[j >> 2] = k;\n          b[j + 4 >> 2] = c;\n          j = d + -1 | 0;\n\n          if (g) {\n            g = 0;\n            h = 1;\n            f = k;\n            a = c;\n\n            do {\n              f = da(f, a, 2, l) | 0;\n              a = G() | 0;\n\n              if ((f | 0) == 0 & (a | 0) == 0) {\n                a = 2;\n                break a;\n              }\n\n              i = e + (h << 3) | 0;\n              b[i >> 2] = f;\n              b[i + 4 >> 2] = a;\n              h = h + 1 | 0;\n\n              if (Fb(f, a) | 0) {\n                a = 1;\n                break a;\n              }\n\n              g = g + 1 | 0;\n            } while ((g | 0) < (d | 0));\n\n            i = 0;\n            g = h;\n\n            do {\n              f = da(f, a, 3, l) | 0;\n              a = G() | 0;\n\n              if ((f | 0) == 0 & (a | 0) == 0) {\n                a = 2;\n                break a;\n              }\n\n              h = e + (g << 3) | 0;\n              b[h >> 2] = f;\n              b[h + 4 >> 2] = a;\n              g = g + 1 | 0;\n\n              if (Fb(f, a) | 0) {\n                a = 1;\n                break a;\n              }\n\n              i = i + 1 | 0;\n            } while ((i | 0) < (d | 0));\n\n            h = 0;\n\n            do {\n              f = da(f, a, 1, l) | 0;\n              a = G() | 0;\n\n              if ((f | 0) == 0 & (a | 0) == 0) {\n                a = 2;\n                break a;\n              }\n\n              i = e + (g << 3) | 0;\n              b[i >> 2] = f;\n              b[i + 4 >> 2] = a;\n              g = g + 1 | 0;\n\n              if (Fb(f, a) | 0) {\n                a = 1;\n                break a;\n              }\n\n              h = h + 1 | 0;\n            } while ((h | 0) < (d | 0));\n\n            h = 0;\n\n            do {\n              f = da(f, a, 5, l) | 0;\n              a = G() | 0;\n\n              if ((f | 0) == 0 & (a | 0) == 0) {\n                a = 2;\n                break a;\n              }\n\n              i = e + (g << 3) | 0;\n              b[i >> 2] = f;\n              b[i + 4 >> 2] = a;\n              g = g + 1 | 0;\n\n              if (Fb(f, a) | 0) {\n                a = 1;\n                break a;\n              }\n\n              h = h + 1 | 0;\n            } while ((h | 0) < (d | 0));\n\n            h = 0;\n\n            do {\n              f = da(f, a, 4, l) | 0;\n              a = G() | 0;\n\n              if ((f | 0) == 0 & (a | 0) == 0) {\n                a = 2;\n                break a;\n              }\n\n              i = e + (g << 3) | 0;\n              b[i >> 2] = f;\n              b[i + 4 >> 2] = a;\n              g = g + 1 | 0;\n\n              if (Fb(f, a) | 0) {\n                a = 1;\n                break a;\n              }\n\n              h = h + 1 | 0;\n            } while ((h | 0) < (d | 0));\n\n            h = 0;\n\n            while (1) {\n              f = da(f, a, 6, l) | 0;\n              a = G() | 0;\n\n              if ((f | 0) == 0 & (a | 0) == 0) {\n                a = 2;\n                break a;\n              }\n\n              if ((h | 0) != (j | 0)) {\n                i = e + (g << 3) | 0;\n                b[i >> 2] = f;\n                b[i + 4 >> 2] = a;\n                if (!(Fb(f, a) | 0)) { g = g + 1 | 0; }else {\n                  a = 1;\n                  break a;\n                }\n              }\n\n              h = h + 1 | 0;\n\n              if ((h | 0) >= (d | 0)) {\n                h = k;\n                g = c;\n                break;\n              }\n            }\n          } else {\n            h = k;\n            f = k;\n            g = c;\n            a = c;\n          }\n        } else {\n          h = e;\n          b[h >> 2] = a;\n          b[h + 4 >> 2] = c;\n          h = a;\n          f = a;\n          g = c;\n          a = c;\n        }\n\n        a = ((h | 0) != (f | 0) | (g | 0) != (a | 0)) & 1;\n      } else { a = 1; } } while (0);\n\n      l = a;\n      S = m;\n      return l | 0;\n    }\n\n    function fa(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      g = S;\n      S = S + 48 | 0;\n      f = g + 8 | 0;\n      e = g;\n      i = a;\n      h = b[i + 4 >> 2] | 0;\n      d = e;\n      b[d >> 2] = b[i >> 2];\n      b[d + 4 >> 2] = h;\n      vc(e, f);\n      f = ya(f, c) | 0;\n      c = b[e >> 2] | 0;\n      e = b[a + 8 >> 2] | 0;\n\n      if ((e | 0) <= 0) {\n        i = c;\n        h = (f | 0) < (i | 0);\n        i = h ? i : f;\n        i = i + 12 | 0;\n        S = g;\n        return i | 0;\n      }\n\n      d = b[a + 12 >> 2] | 0;\n      a = 0;\n\n      do {\n        c = (b[d + (a << 3) >> 2] | 0) + c | 0;\n        a = a + 1 | 0;\n      } while ((a | 0) < (e | 0));\n\n      i = (f | 0) < (c | 0);\n      i = i ? c : f;\n      i = i + 12 | 0;\n      S = g;\n      return i | 0;\n    }\n\n    function ga(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0;\n      i = S;\n      S = S + 48 | 0;\n      e = i + 8 | 0;\n      f = i;\n\n      if (!(ha(a, c, d) | 0)) {\n        S = i;\n        return;\n      }\n\n      j = a;\n      g = b[j + 4 >> 2] | 0;\n      h = f;\n      b[h >> 2] = b[j >> 2];\n      b[h + 4 >> 2] = g;\n      vc(f, e);\n      h = ya(e, c) | 0;\n      c = b[f >> 2] | 0;\n      g = b[a + 8 >> 2] | 0;\n\n      if ((g | 0) > 0) {\n        f = b[a + 12 >> 2] | 0;\n        e = 0;\n\n        do {\n          c = (b[f + (e << 3) >> 2] | 0) + c | 0;\n          e = e + 1 | 0;\n        } while ((e | 0) != (g | 0));\n      }\n\n      c = (h | 0) < (c | 0) ? c : h;\n\n      if ((c | 0) <= -12) {\n        S = i;\n        return;\n      }\n\n      j = c + 11 | 0;\n      hd(d | 0, 0, (((j | 0) > 0 ? j : 0) << 3) + 8 | 0) | 0;\n      S = i;\n      return;\n    }\n\n    function ha(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0,\n          p = 0,\n          q = 0,\n          r = 0,\n          s = 0,\n          t = 0,\n          u = 0,\n          v = 0,\n          w = 0,\n          x = 0,\n          y = 0,\n          z = 0,\n          A = 0,\n          B = 0,\n          C = 0,\n          D = 0,\n          E = 0,\n          F = 0,\n          I = 0,\n          J = 0;\n      J = S;\n      S = S + 112 | 0;\n      D = J + 80 | 0;\n      j = J + 72 | 0;\n      E = J;\n      F = J + 56 | 0;\n      k = a + 8 | 0;\n      I = Wc((b[k >> 2] << 5) + 32 | 0) | 0;\n      if (!I) { H(22848, 22448, 800, 22456); }\n      wc(a, I);\n      g = a;\n      e = b[g + 4 >> 2] | 0;\n      i = j;\n      b[i >> 2] = b[g >> 2];\n      b[i + 4 >> 2] = e;\n      vc(j, D);\n      i = ya(D, c) | 0;\n      e = b[j >> 2] | 0;\n      g = b[k >> 2] | 0;\n\n      if ((g | 0) > 0) {\n        h = b[a + 12 >> 2] | 0;\n        f = 0;\n\n        do {\n          e = (b[h + (f << 3) >> 2] | 0) + e | 0;\n          f = f + 1 | 0;\n        } while ((f | 0) != (g | 0));\n      }\n\n      i = (i | 0) < (e | 0) ? e : i;\n      C = i + 12 | 0;\n      f = Yc(C, 8) | 0;\n      l = Yc(C, 8) | 0;\n      b[D >> 2] = 0;\n      A = a;\n      B = b[A + 4 >> 2] | 0;\n      e = j;\n      b[e >> 2] = b[A >> 2];\n      b[e + 4 >> 2] = B;\n      e = ia(j, C, c, D, f, l) | 0;\n\n      if (e | 0) {\n        Xc(f);\n        Xc(l);\n        Xc(I);\n        I = e;\n        S = J;\n        return I | 0;\n      }\n\n      a: do { if ((b[k >> 2] | 0) > 0) {\n        g = a + 12 | 0;\n        e = 0;\n\n        while (1) {\n          h = ia((b[g >> 2] | 0) + (e << 3) | 0, C, c, D, f, l) | 0;\n          e = e + 1 | 0;\n          if (h | 0) { break; }\n          if ((e | 0) >= (b[k >> 2] | 0)) { break a; }\n        }\n\n        Xc(f);\n        Xc(l);\n        Xc(I);\n        I = h;\n        S = J;\n        return I | 0;\n      } } while (0);\n\n      if ((i | 0) > -12) { hd(l | 0, 0, ((C | 0) > 1 ? C : 1) << 3 | 0) | 0; }\n\n      b: do { if ((b[D >> 2] | 0) > 0) {\n        B = ((C | 0) < 0) << 31 >> 31;\n        v = f;\n        w = l;\n        x = f;\n        y = f;\n        z = l;\n        A = f;\n        e = f;\n        r = f;\n        s = l;\n        t = l;\n        u = l;\n        f = l;\n\n        c: while (1) {\n          q = b[D >> 2] | 0;\n          o = 0;\n          p = 0;\n          g = 0;\n\n          while (1) {\n            h = E;\n            i = h + 56 | 0;\n\n            do {\n              b[h >> 2] = 0;\n              h = h + 4 | 0;\n            } while ((h | 0) < (i | 0));\n\n            c = v + (o << 3) | 0;\n            j = b[c >> 2] | 0;\n            c = b[c + 4 >> 2] | 0;\n\n            if (ba(j, c, 1, E, 0) | 0) {\n              h = E;\n              i = h + 56 | 0;\n\n              do {\n                b[h >> 2] = 0;\n                h = h + 4 | 0;\n              } while ((h | 0) < (i | 0));\n\n              h = Yc(7, 4) | 0;\n\n              if (h | 0) {\n                ca(j, c, 1, E, h, 7, 0);\n                Xc(h);\n              }\n            }\n\n            n = 0;\n\n            do {\n              m = E + (n << 3) | 0;\n              l = b[m >> 2] | 0;\n              m = b[m + 4 >> 2] | 0;\n\n              d: do { if (!((l | 0) == 0 & (m | 0) == 0)) {\n                j = bd(l | 0, m | 0, C | 0, B | 0) | 0;\n                G() | 0;\n                h = d + (j << 3) | 0;\n                i = h;\n                c = b[i >> 2] | 0;\n                i = b[i + 4 >> 2] | 0;\n\n                if (!((c | 0) == 0 & (i | 0) == 0)) {\n                  k = 0;\n\n                  while (1) {\n                    if ((k | 0) > (C | 0)) { break c; }\n                    if ((c | 0) == (l | 0) & (i | 0) == (m | 0)) { break d; }\n                    j = (j + 1 | 0) % (C | 0) | 0;\n                    h = d + (j << 3) | 0;\n                    i = h;\n                    c = b[i >> 2] | 0;\n                    i = b[i + 4 >> 2] | 0;\n                    if ((c | 0) == 0 & (i | 0) == 0) { break; }else { k = k + 1 | 0; }\n                  }\n                }\n\n                if (!((l | 0) == 0 & (m | 0) == 0)) {\n                  Vb(l, m, F);\n\n                  if (xc(a, I, F) | 0) {\n                    k = h;\n                    b[k >> 2] = l;\n                    b[k + 4 >> 2] = m;\n                    k = w + (g << 3) | 0;\n                    b[k >> 2] = l;\n                    b[k + 4 >> 2] = m;\n                    g = g + 1 | 0;\n                  }\n                }\n              } } while (0);\n\n              n = n + 1 | 0;\n            } while (n >>> 0 < 7);\n\n            p = p + 1 | 0;\n            if ((p | 0) >= (q | 0)) { break; }else { o = o + 1 | 0; }\n          }\n\n          if ((q | 0) > 0) { hd(x | 0, 0, q << 3 | 0) | 0; }\n          b[D >> 2] = g;\n\n          if ((g | 0) > 0) {\n            l = f;\n            m = u;\n            n = A;\n            o = t;\n            p = s;\n            q = w;\n            f = r;\n            u = e;\n            t = y;\n            s = x;\n            r = l;\n            e = m;\n            A = z;\n            z = n;\n            y = o;\n            x = p;\n            w = v;\n            v = q;\n          } else { break b; }\n        }\n\n        Xc(y);\n        Xc(z);\n        Xc(I);\n        I = -1;\n        S = J;\n        return I | 0;\n      } else { e = l; } } while (0);\n\n      Xc(I);\n      Xc(f);\n      Xc(e);\n      I = 0;\n      S = J;\n      return I | 0;\n    }\n\n    function ia(a, c, d, f, g, h) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      f = f | 0;\n      g = g | 0;\n      h = h | 0;\n      var i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0,\n          p = 0,\n          q = 0,\n          r = 0.0,\n          s = 0,\n          t = 0,\n          u = 0,\n          v = 0,\n          w = 0,\n          x = 0,\n          y = 0,\n          z = 0,\n          A = 0,\n          B = 0,\n          C = 0,\n          D = 0.0,\n          E = 0.0;\n      C = S;\n      S = S + 48 | 0;\n      y = C + 32 | 0;\n      z = C + 16 | 0;\n      A = C;\n      i = b[a >> 2] | 0;\n\n      if ((i | 0) <= 0) {\n        B = 0;\n        S = C;\n        return B | 0;\n      }\n\n      t = a + 4 | 0;\n      u = y + 8 | 0;\n      v = z + 8 | 0;\n      w = A + 8 | 0;\n      x = ((c | 0) < 0) << 31 >> 31;\n      s = 0;\n\n      a: while (1) {\n        j = b[t >> 2] | 0;\n        q = j + (s << 4) | 0;\n        b[y >> 2] = b[q >> 2];\n        b[y + 4 >> 2] = b[q + 4 >> 2];\n        b[y + 8 >> 2] = b[q + 8 >> 2];\n        b[y + 12 >> 2] = b[q + 12 >> 2];\n\n        if ((s | 0) == (i + -1 | 0)) {\n          b[z >> 2] = b[j >> 2];\n          b[z + 4 >> 2] = b[j + 4 >> 2];\n          b[z + 8 >> 2] = b[j + 8 >> 2];\n          b[z + 12 >> 2] = b[j + 12 >> 2];\n        } else {\n          q = j + (s + 1 << 4) | 0;\n          b[z >> 2] = b[q >> 2];\n          b[z + 4 >> 2] = b[q + 4 >> 2];\n          b[z + 8 >> 2] = b[q + 8 >> 2];\n          b[z + 12 >> 2] = b[q + 12 >> 2];\n        }\n\n        q = za(y, z, d) | 0;\n\n        b: do { if ((q | 0) > 0) {\n          r = +(q | 0);\n          p = 0;\n\n          c: while (1) {\n            E = +(q - p | 0);\n            D = +(p | 0);\n            e[A >> 3] = +e[y >> 3] * E / r + +e[z >> 3] * D / r;\n            e[w >> 3] = +e[u >> 3] * E / r + +e[v >> 3] * D / r;\n            n = Sb(A, d) | 0;\n            o = G() | 0;\n            j = bd(n | 0, o | 0, c | 0, x | 0) | 0;\n            G() | 0;\n            i = h + (j << 3) | 0;\n            k = i;\n            l = b[k >> 2] | 0;\n            k = b[k + 4 >> 2] | 0;\n\n            d: do { if ((l | 0) == 0 & (k | 0) == 0) { B = 14; }else {\n              m = 0;\n\n              while (1) {\n                if ((m | 0) > (c | 0)) {\n                  i = 1;\n                  break d;\n                }\n\n                if ((l | 0) == (n | 0) & (k | 0) == (o | 0)) {\n                  i = 7;\n                  break d;\n                }\n\n                j = (j + 1 | 0) % (c | 0) | 0;\n                i = h + (j << 3) | 0;\n                k = i;\n                l = b[k >> 2] | 0;\n                k = b[k + 4 >> 2] | 0;\n\n                if ((l | 0) == 0 & (k | 0) == 0) {\n                  B = 14;\n                  break;\n                } else { m = m + 1 | 0; }\n              }\n            } } while (0);\n\n            if ((B | 0) == 14) {\n              B = 0;\n              if ((n | 0) == 0 & (o | 0) == 0) { i = 7; }else {\n                b[i >> 2] = n;\n                b[i + 4 >> 2] = o;\n                i = b[f >> 2] | 0;\n                m = g + (i << 3) | 0;\n                b[m >> 2] = n;\n                b[m + 4 >> 2] = o;\n                b[f >> 2] = i + 1;\n                i = 0;\n              }\n            }\n\n            switch (i & 7) {\n              case 7:\n              case 0:\n                break;\n\n              default:\n                break c;\n            }\n\n            p = p + 1 | 0;\n\n            if ((q | 0) <= (p | 0)) {\n              B = 8;\n              break b;\n            }\n          }\n\n          if (i | 0) {\n            i = -1;\n            B = 20;\n            break a;\n          }\n        } else { B = 8; } } while (0);\n\n        if ((B | 0) == 8) { B = 0; }\n        s = s + 1 | 0;\n        i = b[a >> 2] | 0;\n\n        if ((s | 0) >= (i | 0)) {\n          i = 0;\n          B = 20;\n          break;\n        }\n      }\n\n      if ((B | 0) == 20) {\n        S = C;\n        return i | 0;\n      }\n\n      return 0;\n    }\n\n    function ja(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0;\n      k = S;\n      S = S + 176 | 0;\n      j = k;\n\n      if ((c | 0) < 1) {\n        Mc(d, 0, 0);\n        S = k;\n        return;\n      }\n\n      h = a;\n      h = cd(b[h >> 2] | 0, b[h + 4 >> 2] | 0, 52) | 0;\n      G() | 0;\n      Mc(d, (c | 0) > 6 ? c : 6, h & 15);\n      h = 0;\n\n      do {\n        e = a + (h << 3) | 0;\n        Wb(b[e >> 2] | 0, b[e + 4 >> 2] | 0, j);\n        e = b[j >> 2] | 0;\n\n        if ((e | 0) > 0) {\n          i = 0;\n\n          do {\n            g = j + 8 + (i << 4) | 0;\n            i = i + 1 | 0;\n            e = j + 8 + (((i | 0) % (e | 0) | 0) << 4) | 0;\n            f = Rc(d, e, g) | 0;\n            if (!f) { Qc(d, g, e) | 0; }else { Pc(d, f) | 0; }\n            e = b[j >> 2] | 0;\n          } while ((i | 0) < (e | 0));\n        }\n\n        h = h + 1 | 0;\n      } while ((h | 0) != (c | 0));\n\n      S = k;\n      return;\n    }\n\n    function ka(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0;\n      g = S;\n      S = S + 32 | 0;\n      e = g;\n      f = g + 16 | 0;\n      ja(a, c, f);\n      b[d >> 2] = 0;\n      b[d + 4 >> 2] = 0;\n      b[d + 8 >> 2] = 0;\n      a = Oc(f) | 0;\n\n      if (!a) {\n        kc(d) | 0;\n        Nc(f);\n        S = g;\n        return;\n      }\n\n      do {\n        c = hc(d) | 0;\n\n        do {\n          ic(c, a) | 0;\n          h = a + 16 | 0;\n          b[e >> 2] = b[h >> 2];\n          b[e + 4 >> 2] = b[h + 4 >> 2];\n          b[e + 8 >> 2] = b[h + 8 >> 2];\n          b[e + 12 >> 2] = b[h + 12 >> 2];\n          Pc(f, a) | 0;\n          a = Sc(f, e) | 0;\n        } while ((a | 0) != 0);\n\n        a = Oc(f) | 0;\n      } while ((a | 0) != 0);\n\n      kc(d) | 0;\n      Nc(f);\n      S = g;\n      return;\n    }\n\n    function la(a) {\n      a = a | 0;\n      return b[7728 + (a * 28 | 0) + 16 >> 2] | 0;\n    }\n\n    function ma(a) {\n      a = a | 0;\n      return (a | 0) == 4 | (a | 0) == 117 | 0;\n    }\n\n    function na(a) {\n      a = a | 0;\n      return b[11152 + ((b[a >> 2] | 0) * 216 | 0) + ((b[a + 4 >> 2] | 0) * 72 | 0) + ((b[a + 8 >> 2] | 0) * 24 | 0) + (b[a + 12 >> 2] << 3) >> 2] | 0;\n    }\n\n    function oa(a) {\n      a = a | 0;\n      return b[11152 + ((b[a >> 2] | 0) * 216 | 0) + ((b[a + 4 >> 2] | 0) * 72 | 0) + ((b[a + 8 >> 2] | 0) * 24 | 0) + (b[a + 12 >> 2] << 3) + 4 >> 2] | 0;\n    }\n\n    function pa(a, c) {\n      a = a | 0;\n      c = c | 0;\n      a = 7728 + (a * 28 | 0) | 0;\n      b[c >> 2] = b[a >> 2];\n      b[c + 4 >> 2] = b[a + 4 >> 2];\n      b[c + 8 >> 2] = b[a + 8 >> 2];\n      b[c + 12 >> 2] = b[a + 12 >> 2];\n      return;\n    }\n\n    function qa(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0;\n\n      if (c >>> 0 > 20) {\n        c = -1;\n        return c | 0;\n      }\n\n      do { if ((b[11152 + (c * 216 | 0) >> 2] | 0) != (a | 0)) {\n        if ((b[11152 + (c * 216 | 0) + 8 >> 2] | 0) != (a | 0)) {\n          if ((b[11152 + (c * 216 | 0) + 16 >> 2] | 0) != (a | 0)) {\n            if ((b[11152 + (c * 216 | 0) + 24 >> 2] | 0) != (a | 0)) {\n              if ((b[11152 + (c * 216 | 0) + 32 >> 2] | 0) != (a | 0)) {\n                if ((b[11152 + (c * 216 | 0) + 40 >> 2] | 0) != (a | 0)) {\n                  if ((b[11152 + (c * 216 | 0) + 48 >> 2] | 0) != (a | 0)) {\n                    if ((b[11152 + (c * 216 | 0) + 56 >> 2] | 0) != (a | 0)) {\n                      if ((b[11152 + (c * 216 | 0) + 64 >> 2] | 0) != (a | 0)) {\n                        if ((b[11152 + (c * 216 | 0) + 72 >> 2] | 0) != (a | 0)) {\n                          if ((b[11152 + (c * 216 | 0) + 80 >> 2] | 0) != (a | 0)) {\n                            if ((b[11152 + (c * 216 | 0) + 88 >> 2] | 0) != (a | 0)) {\n                              if ((b[11152 + (c * 216 | 0) + 96 >> 2] | 0) != (a | 0)) {\n                                if ((b[11152 + (c * 216 | 0) + 104 >> 2] | 0) != (a | 0)) {\n                                  if ((b[11152 + (c * 216 | 0) + 112 >> 2] | 0) != (a | 0)) {\n                                    if ((b[11152 + (c * 216 | 0) + 120 >> 2] | 0) != (a | 0)) {\n                                      if ((b[11152 + (c * 216 | 0) + 128 >> 2] | 0) != (a | 0)) {\n                                        if ((b[11152 + (c * 216 | 0) + 136 >> 2] | 0) == (a | 0)) {\n                                          a = 2;\n                                          d = 1;\n                                          e = 2;\n                                        } else {\n                                          if ((b[11152 + (c * 216 | 0) + 144 >> 2] | 0) == (a | 0)) {\n                                            a = 0;\n                                            d = 2;\n                                            e = 0;\n                                            break;\n                                          }\n\n                                          if ((b[11152 + (c * 216 | 0) + 152 >> 2] | 0) == (a | 0)) {\n                                            a = 0;\n                                            d = 2;\n                                            e = 1;\n                                            break;\n                                          }\n\n                                          if ((b[11152 + (c * 216 | 0) + 160 >> 2] | 0) == (a | 0)) {\n                                            a = 0;\n                                            d = 2;\n                                            e = 2;\n                                            break;\n                                          }\n\n                                          if ((b[11152 + (c * 216 | 0) + 168 >> 2] | 0) == (a | 0)) {\n                                            a = 1;\n                                            d = 2;\n                                            e = 0;\n                                            break;\n                                          }\n\n                                          if ((b[11152 + (c * 216 | 0) + 176 >> 2] | 0) == (a | 0)) {\n                                            a = 1;\n                                            d = 2;\n                                            e = 1;\n                                            break;\n                                          }\n\n                                          if ((b[11152 + (c * 216 | 0) + 184 >> 2] | 0) == (a | 0)) {\n                                            a = 1;\n                                            d = 2;\n                                            e = 2;\n                                            break;\n                                          }\n\n                                          if ((b[11152 + (c * 216 | 0) + 192 >> 2] | 0) == (a | 0)) {\n                                            a = 2;\n                                            d = 2;\n                                            e = 0;\n                                            break;\n                                          }\n\n                                          if ((b[11152 + (c * 216 | 0) + 200 >> 2] | 0) == (a | 0)) {\n                                            a = 2;\n                                            d = 2;\n                                            e = 1;\n                                            break;\n                                          }\n\n                                          if ((b[11152 + (c * 216 | 0) + 208 >> 2] | 0) == (a | 0)) {\n                                            a = 2;\n                                            d = 2;\n                                            e = 2;\n                                            break;\n                                          } else { a = -1; }\n\n                                          return a | 0;\n                                        }\n                                      } else {\n                                        a = 2;\n                                        d = 1;\n                                        e = 1;\n                                      }\n                                    } else {\n                                      a = 2;\n                                      d = 1;\n                                      e = 0;\n                                    }\n                                  } else {\n                                    a = 1;\n                                    d = 1;\n                                    e = 2;\n                                  }\n                                } else {\n                                  a = 1;\n                                  d = 1;\n                                  e = 1;\n                                }\n                              } else {\n                                a = 1;\n                                d = 1;\n                                e = 0;\n                              }\n                            } else {\n                              a = 0;\n                              d = 1;\n                              e = 2;\n                            }\n                          } else {\n                            a = 0;\n                            d = 1;\n                            e = 1;\n                          }\n                        } else {\n                          a = 0;\n                          d = 1;\n                          e = 0;\n                        }\n                      } else {\n                        a = 2;\n                        d = 0;\n                        e = 2;\n                      }\n                    } else {\n                      a = 2;\n                      d = 0;\n                      e = 1;\n                    }\n                  } else {\n                    a = 2;\n                    d = 0;\n                    e = 0;\n                  }\n                } else {\n                  a = 1;\n                  d = 0;\n                  e = 2;\n                }\n              } else {\n                a = 1;\n                d = 0;\n                e = 1;\n              }\n            } else {\n              a = 1;\n              d = 0;\n              e = 0;\n            }\n          } else {\n            a = 0;\n            d = 0;\n            e = 2;\n          }\n        } else {\n          a = 0;\n          d = 0;\n          e = 1;\n        }\n      } else {\n        a = 0;\n        d = 0;\n        e = 0;\n      } } while (0);\n\n      c = b[11152 + (c * 216 | 0) + (d * 72 | 0) + (a * 24 | 0) + (e << 3) + 4 >> 2] | 0;\n      return c | 0;\n    }\n\n    function ra(a, c) {\n      a = a | 0;\n      c = c | 0;\n\n      if ((b[7728 + (a * 28 | 0) + 20 >> 2] | 0) == (c | 0)) {\n        c = 1;\n        return c | 0;\n      }\n\n      c = (b[7728 + (a * 28 | 0) + 24 >> 2] | 0) == (c | 0);\n      return c | 0;\n    }\n\n    function sa(a, c) {\n      a = a | 0;\n      c = c | 0;\n      return b[880 + (a * 28 | 0) + (c << 2) >> 2] | 0;\n    }\n\n    function ta(a, c) {\n      a = a | 0;\n      c = c | 0;\n\n      if ((b[880 + (a * 28 | 0) >> 2] | 0) == (c | 0)) {\n        c = 0;\n        return c | 0;\n      }\n\n      if ((b[880 + (a * 28 | 0) + 4 >> 2] | 0) == (c | 0)) {\n        c = 1;\n        return c | 0;\n      }\n\n      if ((b[880 + (a * 28 | 0) + 8 >> 2] | 0) == (c | 0)) {\n        c = 2;\n        return c | 0;\n      }\n\n      if ((b[880 + (a * 28 | 0) + 12 >> 2] | 0) == (c | 0)) {\n        c = 3;\n        return c | 0;\n      }\n\n      if ((b[880 + (a * 28 | 0) + 16 >> 2] | 0) == (c | 0)) {\n        c = 4;\n        return c | 0;\n      }\n\n      if ((b[880 + (a * 28 | 0) + 20 >> 2] | 0) == (c | 0)) {\n        c = 5;\n        return c | 0;\n      } else { return ((b[880 + (a * 28 | 0) + 24 >> 2] | 0) == (c | 0) ? 6 : 7) | 0; }\n\n      return 0;\n    }\n\n    function ua() {\n      return 122;\n    }\n\n    function va(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0;\n      c = 0;\n\n      do {\n        dd(c | 0, 0, 45) | 0;\n        e = G() | 0 | 134225919;\n        d = a + (c << 3) | 0;\n        b[d >> 2] = -1;\n        b[d + 4 >> 2] = e;\n        c = c + 1 | 0;\n      } while ((c | 0) != 122);\n\n      return;\n    }\n\n    function wa(a) {\n      a = a | 0;\n      return +e[a + 16 >> 3] < +e[a + 24 >> 3] | 0;\n    }\n\n    function xa(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0.0,\n          d = 0.0,\n          f = 0.0;\n      c = +e[b >> 3];\n\n      if (!(c >= +e[a + 8 >> 3])) {\n        b = 0;\n        return b | 0;\n      }\n\n      if (!(c <= +e[a >> 3])) {\n        b = 0;\n        return b | 0;\n      }\n\n      d = +e[a + 16 >> 3];\n      c = +e[a + 24 >> 3];\n      f = +e[b + 8 >> 3];\n      b = f >= c;\n      a = f <= d & 1;\n\n      if (d < c) {\n        if (b) { a = 1; }\n      } else if (!b) { a = 0; }\n\n      b = (a | 0) != 0;\n      return b | 0;\n    }\n\n    function ya(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0.0,\n          l = 0.0;\n      i = S;\n      S = S + 288 | 0;\n      d = i + 264 | 0;\n      f = i + 96 | 0;\n      g = i;\n      h = g;\n      j = h + 96 | 0;\n\n      do {\n        b[h >> 2] = 0;\n        h = h + 4 | 0;\n      } while ((h | 0) < (j | 0));\n\n      _b(c, g);\n\n      h = g;\n      j = b[h >> 2] | 0;\n      h = b[h + 4 >> 2] | 0;\n      Vb(j, h, d);\n      Wb(j, h, f);\n      k = +jb(d, f + 8 | 0);\n      e[d >> 3] = +e[a >> 3];\n      h = d + 8 | 0;\n      e[h >> 3] = +e[a + 16 >> 3];\n      e[f >> 3] = +e[a + 8 >> 3];\n      j = f + 8 | 0;\n      e[j >> 3] = +e[a + 24 >> 3];\n      l = +jb(d, f);\n      j = ~~+A(+(l * l / +ed(+ +q(+((+e[h >> 3] - +e[j >> 3]) / (+e[d >> 3] - +e[f >> 3]))), 3.0) / (k * (k * 2.59807621135) * .8)));\n      S = i;\n      return ((j | 0) == 0 ? 1 : j) | 0;\n    }\n\n    function za(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0.0;\n      i = S;\n      S = S + 288 | 0;\n      e = i + 264 | 0;\n      f = i + 96 | 0;\n      g = i;\n      h = g;\n      j = h + 96 | 0;\n\n      do {\n        b[h >> 2] = 0;\n        h = h + 4 | 0;\n      } while ((h | 0) < (j | 0));\n\n      _b(d, g);\n\n      j = g;\n      h = b[j >> 2] | 0;\n      j = b[j + 4 >> 2] | 0;\n      Vb(h, j, e);\n      Wb(h, j, f);\n      k = +jb(e, f + 8 | 0);\n      j = ~~+A(+(+jb(a, c) / (k * 2.0)));\n      S = i;\n      return ((j | 0) == 0 ? 1 : j) | 0;\n    }\n\n    function Aa(a, c, d, e) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      b[a >> 2] = c;\n      b[a + 4 >> 2] = d;\n      b[a + 8 >> 2] = e;\n      return;\n    }\n\n    function Ba(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0.0,\n          j = 0.0,\n          k = 0.0,\n          l = 0.0,\n          m = 0,\n          n = 0,\n          o = 0.0;\n      n = c + 8 | 0;\n      b[n >> 2] = 0;\n      k = +e[a >> 3];\n      i = +q(+k);\n      l = +e[a + 8 >> 3];\n      j = +q(+l) / .8660254037844386;\n      i = i + j * .5;\n      d = ~~i;\n      a = ~~j;\n      i = i - +(d | 0);\n      j = j - +(a | 0);\n\n      do { if (i < .5) {\n        if (i < .3333333333333333) {\n          b[c >> 2] = d;\n\n          if (j < (i + 1.0) * .5) {\n            b[c + 4 >> 2] = a;\n            break;\n          } else {\n            a = a + 1 | 0;\n            b[c + 4 >> 2] = a;\n            break;\n          }\n        } else {\n          o = 1.0 - i;\n          a = (!(j < o) & 1) + a | 0;\n          b[c + 4 >> 2] = a;\n\n          if (o <= j & j < i * 2.0) {\n            d = d + 1 | 0;\n            b[c >> 2] = d;\n            break;\n          } else {\n            b[c >> 2] = d;\n            break;\n          }\n        }\n      } else {\n        if (!(i < .6666666666666666)) {\n          d = d + 1 | 0;\n          b[c >> 2] = d;\n\n          if (j < i * .5) {\n            b[c + 4 >> 2] = a;\n            break;\n          } else {\n            a = a + 1 | 0;\n            b[c + 4 >> 2] = a;\n            break;\n          }\n        }\n\n        if (j < 1.0 - i) {\n          b[c + 4 >> 2] = a;\n\n          if (i * 2.0 + -1.0 < j) {\n            b[c >> 2] = d;\n            break;\n          }\n        } else {\n          a = a + 1 | 0;\n          b[c + 4 >> 2] = a;\n        }\n\n        d = d + 1 | 0;\n        b[c >> 2] = d;\n      } } while (0);\n\n      do { if (k < 0.0) { if (!(a & 1)) {\n        m = (a | 0) / 2 | 0;\n        m = _c(d | 0, ((d | 0) < 0) << 31 >> 31 | 0, m | 0, ((m | 0) < 0) << 31 >> 31 | 0) | 0;\n        d = ~~(+(d | 0) - (+(m >>> 0) + 4294967296.0 * +(G() | 0)) * 2.0);\n        b[c >> 2] = d;\n        break;\n      } else {\n        m = (a + 1 | 0) / 2 | 0;\n        m = _c(d | 0, ((d | 0) < 0) << 31 >> 31 | 0, m | 0, ((m | 0) < 0) << 31 >> 31 | 0) | 0;\n        d = ~~(+(d | 0) - ((+(m >>> 0) + 4294967296.0 * +(G() | 0)) * 2.0 + 1.0));\n        b[c >> 2] = d;\n        break;\n      } } } while (0);\n\n      m = c + 4 | 0;\n\n      if (l < 0.0) {\n        d = d - ((a << 1 | 1 | 0) / 2 | 0) | 0;\n        b[c >> 2] = d;\n        a = 0 - a | 0;\n        b[m >> 2] = a;\n      }\n\n      f = a - d | 0;\n\n      if ((d | 0) < 0) {\n        g = 0 - d | 0;\n        b[m >> 2] = f;\n        b[n >> 2] = g;\n        b[c >> 2] = 0;\n        a = f;\n        d = 0;\n      } else { g = 0; }\n\n      if ((a | 0) < 0) {\n        d = d - a | 0;\n        b[c >> 2] = d;\n        g = g - a | 0;\n        b[n >> 2] = g;\n        b[m >> 2] = 0;\n        a = 0;\n      }\n\n      h = d - g | 0;\n      f = a - g | 0;\n\n      if ((g | 0) < 0) {\n        b[c >> 2] = h;\n        b[m >> 2] = f;\n        b[n >> 2] = 0;\n        a = f;\n        d = h;\n        g = 0;\n      }\n\n      f = (a | 0) < (d | 0) ? a : d;\n      f = (g | 0) < (f | 0) ? g : f;\n      if ((f | 0) <= 0) { return; }\n      b[c >> 2] = d - f;\n      b[m >> 2] = a - f;\n      b[n >> 2] = g - f;\n      return;\n    }\n\n    function Ca(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0;\n      c = b[a >> 2] | 0;\n      h = a + 4 | 0;\n      d = b[h >> 2] | 0;\n\n      if ((c | 0) < 0) {\n        d = d - c | 0;\n        b[h >> 2] = d;\n        g = a + 8 | 0;\n        b[g >> 2] = (b[g >> 2] | 0) - c;\n        b[a >> 2] = 0;\n        c = 0;\n      }\n\n      if ((d | 0) < 0) {\n        c = c - d | 0;\n        b[a >> 2] = c;\n        g = a + 8 | 0;\n        f = (b[g >> 2] | 0) - d | 0;\n        b[g >> 2] = f;\n        b[h >> 2] = 0;\n        d = 0;\n      } else {\n        f = a + 8 | 0;\n        g = f;\n        f = b[f >> 2] | 0;\n      }\n\n      if ((f | 0) < 0) {\n        c = c - f | 0;\n        b[a >> 2] = c;\n        d = d - f | 0;\n        b[h >> 2] = d;\n        b[g >> 2] = 0;\n        f = 0;\n      }\n\n      e = (d | 0) < (c | 0) ? d : c;\n      e = (f | 0) < (e | 0) ? f : e;\n      if ((e | 0) <= 0) { return; }\n      b[a >> 2] = c - e;\n      b[h >> 2] = d - e;\n      b[g >> 2] = f - e;\n      return;\n    }\n\n    function Da(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0.0,\n          f = 0;\n      f = b[a + 8 >> 2] | 0;\n      d = +((b[a + 4 >> 2] | 0) - f | 0);\n      e[c >> 3] = +((b[a >> 2] | 0) - f | 0) - d * .5;\n      e[c + 8 >> 3] = d * .8660254037844386;\n      return;\n    }\n\n    function Ea(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      b[d >> 2] = (b[c >> 2] | 0) + (b[a >> 2] | 0);\n      b[d + 4 >> 2] = (b[c + 4 >> 2] | 0) + (b[a + 4 >> 2] | 0);\n      b[d + 8 >> 2] = (b[c + 8 >> 2] | 0) + (b[a + 8 >> 2] | 0);\n      return;\n    }\n\n    function Fa(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      b[d >> 2] = (b[a >> 2] | 0) - (b[c >> 2] | 0);\n      b[d + 4 >> 2] = (b[a + 4 >> 2] | 0) - (b[c + 4 >> 2] | 0);\n      b[d + 8 >> 2] = (b[a + 8 >> 2] | 0) - (b[c + 8 >> 2] | 0);\n      return;\n    }\n\n    function Ga(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0;\n      d = B(b[a >> 2] | 0, c) | 0;\n      b[a >> 2] = d;\n      d = a + 4 | 0;\n      e = B(b[d >> 2] | 0, c) | 0;\n      b[d >> 2] = e;\n      a = a + 8 | 0;\n      c = B(b[a >> 2] | 0, c) | 0;\n      b[a >> 2] = c;\n      return;\n    }\n\n    function Ha(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      h = b[a >> 2] | 0;\n      i = (h | 0) < 0;\n      e = (b[a + 4 >> 2] | 0) - (i ? h : 0) | 0;\n      g = (e | 0) < 0;\n      f = (g ? 0 - e | 0 : 0) + ((b[a + 8 >> 2] | 0) - (i ? h : 0)) | 0;\n      d = (f | 0) < 0;\n      a = d ? 0 : f;\n      c = (g ? 0 : e) - (d ? f : 0) | 0;\n      f = (i ? 0 : h) - (g ? e : 0) - (d ? f : 0) | 0;\n      d = (c | 0) < (f | 0) ? c : f;\n      d = (a | 0) < (d | 0) ? a : d;\n      e = (d | 0) > 0;\n      a = a - (e ? d : 0) | 0;\n      c = c - (e ? d : 0) | 0;\n\n      a: do { switch (f - (e ? d : 0) | 0) {\n        case 0:\n          switch (c | 0) {\n            case 0:\n              {\n                i = (a | 0) == 0 ? 0 : (a | 0) == 1 ? 1 : 7;\n                return i | 0;\n              }\n\n            case 1:\n              {\n                i = (a | 0) == 0 ? 2 : (a | 0) == 1 ? 3 : 7;\n                return i | 0;\n              }\n\n            default:\n              break a;\n          }\n\n        case 1:\n          switch (c | 0) {\n            case 0:\n              {\n                i = (a | 0) == 0 ? 4 : (a | 0) == 1 ? 5 : 7;\n                return i | 0;\n              }\n\n            case 1:\n              {\n                if (!a) { a = 6; }else { break a; }\n                return a | 0;\n              }\n\n            default:\n              break a;\n          }\n\n        default:\n\n      } } while (0);\n\n      i = 7;\n      return i | 0;\n    }\n\n    function Ia(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      h = a + 8 | 0;\n      d = b[h >> 2] | 0;\n      c = (b[a >> 2] | 0) - d | 0;\n      i = a + 4 | 0;\n      d = (b[i >> 2] | 0) - d | 0;\n      e = Vc(+((c * 3 | 0) - d | 0) / 7.0) | 0;\n      b[a >> 2] = e;\n      c = Vc(+((d << 1) + c | 0) / 7.0) | 0;\n      b[i >> 2] = c;\n      b[h >> 2] = 0;\n      d = c - e | 0;\n\n      if ((e | 0) < 0) {\n        g = 0 - e | 0;\n        b[i >> 2] = d;\n        b[h >> 2] = g;\n        b[a >> 2] = 0;\n        c = d;\n        e = 0;\n        d = g;\n      } else { d = 0; }\n\n      if ((c | 0) < 0) {\n        e = e - c | 0;\n        b[a >> 2] = e;\n        d = d - c | 0;\n        b[h >> 2] = d;\n        b[i >> 2] = 0;\n        c = 0;\n      }\n\n      g = e - d | 0;\n      f = c - d | 0;\n\n      if ((d | 0) < 0) {\n        b[a >> 2] = g;\n        b[i >> 2] = f;\n        b[h >> 2] = 0;\n        c = f;\n        f = g;\n        d = 0;\n      } else { f = e; }\n\n      e = (c | 0) < (f | 0) ? c : f;\n      e = (d | 0) < (e | 0) ? d : e;\n      if ((e | 0) <= 0) { return; }\n      b[a >> 2] = f - e;\n      b[i >> 2] = c - e;\n      b[h >> 2] = d - e;\n      return;\n    }\n\n    function Ja(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      h = a + 8 | 0;\n      d = b[h >> 2] | 0;\n      c = (b[a >> 2] | 0) - d | 0;\n      i = a + 4 | 0;\n      d = (b[i >> 2] | 0) - d | 0;\n      e = Vc(+((c << 1) + d | 0) / 7.0) | 0;\n      b[a >> 2] = e;\n      c = Vc(+((d * 3 | 0) - c | 0) / 7.0) | 0;\n      b[i >> 2] = c;\n      b[h >> 2] = 0;\n      d = c - e | 0;\n\n      if ((e | 0) < 0) {\n        g = 0 - e | 0;\n        b[i >> 2] = d;\n        b[h >> 2] = g;\n        b[a >> 2] = 0;\n        c = d;\n        e = 0;\n        d = g;\n      } else { d = 0; }\n\n      if ((c | 0) < 0) {\n        e = e - c | 0;\n        b[a >> 2] = e;\n        d = d - c | 0;\n        b[h >> 2] = d;\n        b[i >> 2] = 0;\n        c = 0;\n      }\n\n      g = e - d | 0;\n      f = c - d | 0;\n\n      if ((d | 0) < 0) {\n        b[a >> 2] = g;\n        b[i >> 2] = f;\n        b[h >> 2] = 0;\n        c = f;\n        f = g;\n        d = 0;\n      } else { f = e; }\n\n      e = (c | 0) < (f | 0) ? c : f;\n      e = (d | 0) < (e | 0) ? d : e;\n      if ((e | 0) <= 0) { return; }\n      b[a >> 2] = f - e;\n      b[i >> 2] = c - e;\n      b[h >> 2] = d - e;\n      return;\n    }\n\n    function Ka(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      c = b[a >> 2] | 0;\n      h = a + 4 | 0;\n      d = b[h >> 2] | 0;\n      i = a + 8 | 0;\n      e = b[i >> 2] | 0;\n      f = d + (c * 3 | 0) | 0;\n      b[a >> 2] = f;\n      d = e + (d * 3 | 0) | 0;\n      b[h >> 2] = d;\n      c = (e * 3 | 0) + c | 0;\n      b[i >> 2] = c;\n      e = d - f | 0;\n\n      if ((f | 0) < 0) {\n        c = c - f | 0;\n        b[h >> 2] = e;\n        b[i >> 2] = c;\n        b[a >> 2] = 0;\n        d = e;\n        e = 0;\n      } else { e = f; }\n\n      if ((d | 0) < 0) {\n        e = e - d | 0;\n        b[a >> 2] = e;\n        c = c - d | 0;\n        b[i >> 2] = c;\n        b[h >> 2] = 0;\n        d = 0;\n      }\n\n      g = e - c | 0;\n      f = d - c | 0;\n\n      if ((c | 0) < 0) {\n        b[a >> 2] = g;\n        b[h >> 2] = f;\n        b[i >> 2] = 0;\n        e = g;\n        c = 0;\n      } else { f = d; }\n\n      d = (f | 0) < (e | 0) ? f : e;\n      d = (c | 0) < (d | 0) ? c : d;\n      if ((d | 0) <= 0) { return; }\n      b[a >> 2] = e - d;\n      b[h >> 2] = f - d;\n      b[i >> 2] = c - d;\n      return;\n    }\n\n    function La(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      f = b[a >> 2] | 0;\n      h = a + 4 | 0;\n      c = b[h >> 2] | 0;\n      i = a + 8 | 0;\n      d = b[i >> 2] | 0;\n      e = (c * 3 | 0) + f | 0;\n      f = d + (f * 3 | 0) | 0;\n      b[a >> 2] = f;\n      b[h >> 2] = e;\n      c = (d * 3 | 0) + c | 0;\n      b[i >> 2] = c;\n      d = e - f | 0;\n\n      if ((f | 0) < 0) {\n        c = c - f | 0;\n        b[h >> 2] = d;\n        b[i >> 2] = c;\n        b[a >> 2] = 0;\n        f = 0;\n      } else { d = e; }\n\n      if ((d | 0) < 0) {\n        f = f - d | 0;\n        b[a >> 2] = f;\n        c = c - d | 0;\n        b[i >> 2] = c;\n        b[h >> 2] = 0;\n        d = 0;\n      }\n\n      g = f - c | 0;\n      e = d - c | 0;\n\n      if ((c | 0) < 0) {\n        b[a >> 2] = g;\n        b[h >> 2] = e;\n        b[i >> 2] = 0;\n        f = g;\n        c = 0;\n      } else { e = d; }\n\n      d = (e | 0) < (f | 0) ? e : f;\n      d = (c | 0) < (d | 0) ? c : d;\n      if ((d | 0) <= 0) { return; }\n      b[a >> 2] = f - d;\n      b[h >> 2] = e - d;\n      b[i >> 2] = c - d;\n      return;\n    }\n\n    function Ma(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      if ((c + -1 | 0) >>> 0 >= 6) { return; }\n      f = (b[15472 + (c * 12 | 0) >> 2] | 0) + (b[a >> 2] | 0) | 0;\n      b[a >> 2] = f;\n      i = a + 4 | 0;\n      e = (b[15472 + (c * 12 | 0) + 4 >> 2] | 0) + (b[i >> 2] | 0) | 0;\n      b[i >> 2] = e;\n      h = a + 8 | 0;\n      c = (b[15472 + (c * 12 | 0) + 8 >> 2] | 0) + (b[h >> 2] | 0) | 0;\n      b[h >> 2] = c;\n      d = e - f | 0;\n\n      if ((f | 0) < 0) {\n        c = c - f | 0;\n        b[i >> 2] = d;\n        b[h >> 2] = c;\n        b[a >> 2] = 0;\n        e = 0;\n      } else {\n        d = e;\n        e = f;\n      }\n\n      if ((d | 0) < 0) {\n        e = e - d | 0;\n        b[a >> 2] = e;\n        c = c - d | 0;\n        b[h >> 2] = c;\n        b[i >> 2] = 0;\n        d = 0;\n      }\n\n      g = e - c | 0;\n      f = d - c | 0;\n\n      if ((c | 0) < 0) {\n        b[a >> 2] = g;\n        b[i >> 2] = f;\n        b[h >> 2] = 0;\n        e = g;\n        c = 0;\n      } else { f = d; }\n\n      d = (f | 0) < (e | 0) ? f : e;\n      d = (c | 0) < (d | 0) ? c : d;\n      if ((d | 0) <= 0) { return; }\n      b[a >> 2] = e - d;\n      b[i >> 2] = f - d;\n      b[h >> 2] = c - d;\n      return;\n    }\n\n    function Na(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      f = b[a >> 2] | 0;\n      h = a + 4 | 0;\n      c = b[h >> 2] | 0;\n      i = a + 8 | 0;\n      d = b[i >> 2] | 0;\n      e = c + f | 0;\n      f = d + f | 0;\n      b[a >> 2] = f;\n      b[h >> 2] = e;\n      c = d + c | 0;\n      b[i >> 2] = c;\n      d = e - f | 0;\n\n      if ((f | 0) < 0) {\n        c = c - f | 0;\n        b[h >> 2] = d;\n        b[i >> 2] = c;\n        b[a >> 2] = 0;\n        e = 0;\n      } else {\n        d = e;\n        e = f;\n      }\n\n      if ((d | 0) < 0) {\n        e = e - d | 0;\n        b[a >> 2] = e;\n        c = c - d | 0;\n        b[i >> 2] = c;\n        b[h >> 2] = 0;\n        d = 0;\n      }\n\n      g = e - c | 0;\n      f = d - c | 0;\n\n      if ((c | 0) < 0) {\n        b[a >> 2] = g;\n        b[h >> 2] = f;\n        b[i >> 2] = 0;\n        e = g;\n        c = 0;\n      } else { f = d; }\n\n      d = (f | 0) < (e | 0) ? f : e;\n      d = (c | 0) < (d | 0) ? c : d;\n      if ((d | 0) <= 0) { return; }\n      b[a >> 2] = e - d;\n      b[h >> 2] = f - d;\n      b[i >> 2] = c - d;\n      return;\n    }\n\n    function Oa(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      c = b[a >> 2] | 0;\n      h = a + 4 | 0;\n      e = b[h >> 2] | 0;\n      i = a + 8 | 0;\n      d = b[i >> 2] | 0;\n      f = e + c | 0;\n      b[a >> 2] = f;\n      e = d + e | 0;\n      b[h >> 2] = e;\n      c = d + c | 0;\n      b[i >> 2] = c;\n      d = e - f | 0;\n\n      if ((f | 0) < 0) {\n        c = c - f | 0;\n        b[h >> 2] = d;\n        b[i >> 2] = c;\n        b[a >> 2] = 0;\n        e = 0;\n      } else {\n        d = e;\n        e = f;\n      }\n\n      if ((d | 0) < 0) {\n        e = e - d | 0;\n        b[a >> 2] = e;\n        c = c - d | 0;\n        b[i >> 2] = c;\n        b[h >> 2] = 0;\n        d = 0;\n      }\n\n      g = e - c | 0;\n      f = d - c | 0;\n\n      if ((c | 0) < 0) {\n        b[a >> 2] = g;\n        b[h >> 2] = f;\n        b[i >> 2] = 0;\n        e = g;\n        c = 0;\n      } else { f = d; }\n\n      d = (f | 0) < (e | 0) ? f : e;\n      d = (c | 0) < (d | 0) ? c : d;\n      if ((d | 0) <= 0) { return; }\n      b[a >> 2] = e - d;\n      b[h >> 2] = f - d;\n      b[i >> 2] = c - d;\n      return;\n    }\n\n    function Pa(a) {\n      a = a | 0;\n\n      switch (a | 0) {\n        case 1:\n          {\n            a = 5;\n            break;\n          }\n\n        case 5:\n          {\n            a = 4;\n            break;\n          }\n\n        case 4:\n          {\n            a = 6;\n            break;\n          }\n\n        case 6:\n          {\n            a = 2;\n            break;\n          }\n\n        case 2:\n          {\n            a = 3;\n            break;\n          }\n\n        case 3:\n          {\n            a = 1;\n            break;\n          }\n\n        default:\n\n      }\n\n      return a | 0;\n    }\n\n    function Qa(a) {\n      a = a | 0;\n\n      switch (a | 0) {\n        case 1:\n          {\n            a = 3;\n            break;\n          }\n\n        case 3:\n          {\n            a = 2;\n            break;\n          }\n\n        case 2:\n          {\n            a = 6;\n            break;\n          }\n\n        case 6:\n          {\n            a = 4;\n            break;\n          }\n\n        case 4:\n          {\n            a = 5;\n            break;\n          }\n\n        case 5:\n          {\n            a = 1;\n            break;\n          }\n\n        default:\n\n      }\n\n      return a | 0;\n    }\n\n    function Ra(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      c = b[a >> 2] | 0;\n      h = a + 4 | 0;\n      d = b[h >> 2] | 0;\n      i = a + 8 | 0;\n      e = b[i >> 2] | 0;\n      f = d + (c << 1) | 0;\n      b[a >> 2] = f;\n      d = e + (d << 1) | 0;\n      b[h >> 2] = d;\n      c = (e << 1) + c | 0;\n      b[i >> 2] = c;\n      e = d - f | 0;\n\n      if ((f | 0) < 0) {\n        c = c - f | 0;\n        b[h >> 2] = e;\n        b[i >> 2] = c;\n        b[a >> 2] = 0;\n        d = e;\n        e = 0;\n      } else { e = f; }\n\n      if ((d | 0) < 0) {\n        e = e - d | 0;\n        b[a >> 2] = e;\n        c = c - d | 0;\n        b[i >> 2] = c;\n        b[h >> 2] = 0;\n        d = 0;\n      }\n\n      g = e - c | 0;\n      f = d - c | 0;\n\n      if ((c | 0) < 0) {\n        b[a >> 2] = g;\n        b[h >> 2] = f;\n        b[i >> 2] = 0;\n        e = g;\n        c = 0;\n      } else { f = d; }\n\n      d = (f | 0) < (e | 0) ? f : e;\n      d = (c | 0) < (d | 0) ? c : d;\n      if ((d | 0) <= 0) { return; }\n      b[a >> 2] = e - d;\n      b[h >> 2] = f - d;\n      b[i >> 2] = c - d;\n      return;\n    }\n\n    function Sa(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      f = b[a >> 2] | 0;\n      h = a + 4 | 0;\n      c = b[h >> 2] | 0;\n      i = a + 8 | 0;\n      d = b[i >> 2] | 0;\n      e = (c << 1) + f | 0;\n      f = d + (f << 1) | 0;\n      b[a >> 2] = f;\n      b[h >> 2] = e;\n      c = (d << 1) + c | 0;\n      b[i >> 2] = c;\n      d = e - f | 0;\n\n      if ((f | 0) < 0) {\n        c = c - f | 0;\n        b[h >> 2] = d;\n        b[i >> 2] = c;\n        b[a >> 2] = 0;\n        f = 0;\n      } else { d = e; }\n\n      if ((d | 0) < 0) {\n        f = f - d | 0;\n        b[a >> 2] = f;\n        c = c - d | 0;\n        b[i >> 2] = c;\n        b[h >> 2] = 0;\n        d = 0;\n      }\n\n      g = f - c | 0;\n      e = d - c | 0;\n\n      if ((c | 0) < 0) {\n        b[a >> 2] = g;\n        b[h >> 2] = e;\n        b[i >> 2] = 0;\n        f = g;\n        c = 0;\n      } else { e = d; }\n\n      d = (e | 0) < (f | 0) ? e : f;\n      d = (c | 0) < (d | 0) ? c : d;\n      if ((d | 0) <= 0) { return; }\n      b[a >> 2] = f - d;\n      b[h >> 2] = e - d;\n      b[i >> 2] = c - d;\n      return;\n    }\n\n    function Ta(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      h = (b[a >> 2] | 0) - (b[c >> 2] | 0) | 0;\n      i = (h | 0) < 0;\n      e = (b[a + 4 >> 2] | 0) - (b[c + 4 >> 2] | 0) - (i ? h : 0) | 0;\n      g = (e | 0) < 0;\n      f = (i ? 0 - h | 0 : 0) + (b[a + 8 >> 2] | 0) - (b[c + 8 >> 2] | 0) + (g ? 0 - e | 0 : 0) | 0;\n      a = (f | 0) < 0;\n      c = a ? 0 : f;\n      d = (g ? 0 : e) - (a ? f : 0) | 0;\n      f = (i ? 0 : h) - (g ? e : 0) - (a ? f : 0) | 0;\n      a = (d | 0) < (f | 0) ? d : f;\n      a = (c | 0) < (a | 0) ? c : a;\n      e = (a | 0) > 0;\n      c = c - (e ? a : 0) | 0;\n      d = d - (e ? a : 0) | 0;\n      a = f - (e ? a : 0) | 0;\n      a = (a | 0) > -1 ? a : 0 - a | 0;\n      d = (d | 0) > -1 ? d : 0 - d | 0;\n      c = (c | 0) > -1 ? c : 0 - c | 0;\n      c = (d | 0) > (c | 0) ? d : c;\n      return ((a | 0) > (c | 0) ? a : c) | 0;\n    }\n\n    function Ua(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0;\n      d = b[a + 8 >> 2] | 0;\n      b[c >> 2] = (b[a >> 2] | 0) - d;\n      b[c + 4 >> 2] = (b[a + 4 >> 2] | 0) - d;\n      return;\n    }\n\n    function Va(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      e = b[a >> 2] | 0;\n      b[c >> 2] = e;\n      a = b[a + 4 >> 2] | 0;\n      h = c + 4 | 0;\n      b[h >> 2] = a;\n      i = c + 8 | 0;\n      b[i >> 2] = 0;\n      d = a - e | 0;\n\n      if ((e | 0) < 0) {\n        a = 0 - e | 0;\n        b[h >> 2] = d;\n        b[i >> 2] = a;\n        b[c >> 2] = 0;\n        e = 0;\n      } else {\n        d = a;\n        a = 0;\n      }\n\n      if ((d | 0) < 0) {\n        e = e - d | 0;\n        b[c >> 2] = e;\n        a = a - d | 0;\n        b[i >> 2] = a;\n        b[h >> 2] = 0;\n        d = 0;\n      }\n\n      g = e - a | 0;\n      f = d - a | 0;\n\n      if ((a | 0) < 0) {\n        b[c >> 2] = g;\n        b[h >> 2] = f;\n        b[i >> 2] = 0;\n        d = f;\n        f = g;\n        a = 0;\n      } else { f = e; }\n\n      e = (d | 0) < (f | 0) ? d : f;\n      e = (a | 0) < (e | 0) ? a : e;\n      if ((e | 0) <= 0) { return; }\n      b[c >> 2] = f - e;\n      b[h >> 2] = d - e;\n      b[i >> 2] = a - e;\n      return;\n    }\n\n    function Wa(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0;\n      c = a + 8 | 0;\n      f = b[c >> 2] | 0;\n      d = f - (b[a >> 2] | 0) | 0;\n      b[a >> 2] = d;\n      e = a + 4 | 0;\n      a = (b[e >> 2] | 0) - f | 0;\n      b[e >> 2] = a;\n      b[c >> 2] = 0 - (a + d);\n      return;\n    }\n\n    function Xa(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      d = b[a >> 2] | 0;\n      c = 0 - d | 0;\n      b[a >> 2] = c;\n      h = a + 8 | 0;\n      b[h >> 2] = 0;\n      i = a + 4 | 0;\n      e = b[i >> 2] | 0;\n      f = e + d | 0;\n\n      if ((d | 0) > 0) {\n        b[i >> 2] = f;\n        b[h >> 2] = d;\n        b[a >> 2] = 0;\n        c = 0;\n        e = f;\n      } else { d = 0; }\n\n      if ((e | 0) < 0) {\n        g = c - e | 0;\n        b[a >> 2] = g;\n        d = d - e | 0;\n        b[h >> 2] = d;\n        b[i >> 2] = 0;\n        f = g - d | 0;\n        c = 0 - d | 0;\n\n        if ((d | 0) < 0) {\n          b[a >> 2] = f;\n          b[i >> 2] = c;\n          b[h >> 2] = 0;\n          e = c;\n          d = 0;\n        } else {\n          e = 0;\n          f = g;\n        }\n      } else { f = c; }\n\n      c = (e | 0) < (f | 0) ? e : f;\n      c = (d | 0) < (c | 0) ? d : c;\n      if ((c | 0) <= 0) { return; }\n      b[a >> 2] = f - c;\n      b[i >> 2] = e - c;\n      b[h >> 2] = d - c;\n      return;\n    }\n\n    function Ya(a, b, c) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0;\n      d = S;\n      S = S + 16 | 0;\n      e = d;\n      Za(a, b, c, e);\n      Ba(e, c + 4 | 0);\n      S = d;\n      return;\n    }\n\n    function Za(a, c, d, f) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      f = f | 0;\n      var g = 0.0,\n          h = 0,\n          i = 0.0,\n          j = 0.0,\n          k = 0;\n      k = S;\n      S = S + 32 | 0;\n      h = k;\n      Jc(a, h);\n      b[d >> 2] = 0;\n      g = +Ic(15888, h);\n      i = +Ic(15912, h);\n\n      if (i < g) {\n        b[d >> 2] = 1;\n        g = i;\n      }\n\n      i = +Ic(15936, h);\n\n      if (i < g) {\n        b[d >> 2] = 2;\n        g = i;\n      }\n\n      i = +Ic(15960, h);\n\n      if (i < g) {\n        b[d >> 2] = 3;\n        g = i;\n      }\n\n      i = +Ic(15984, h);\n\n      if (i < g) {\n        b[d >> 2] = 4;\n        g = i;\n      }\n\n      i = +Ic(16008, h);\n\n      if (i < g) {\n        b[d >> 2] = 5;\n        g = i;\n      }\n\n      i = +Ic(16032, h);\n\n      if (i < g) {\n        b[d >> 2] = 6;\n        g = i;\n      }\n\n      i = +Ic(16056, h);\n\n      if (i < g) {\n        b[d >> 2] = 7;\n        g = i;\n      }\n\n      i = +Ic(16080, h);\n\n      if (i < g) {\n        b[d >> 2] = 8;\n        g = i;\n      }\n\n      i = +Ic(16104, h);\n\n      if (i < g) {\n        b[d >> 2] = 9;\n        g = i;\n      }\n\n      i = +Ic(16128, h);\n\n      if (i < g) {\n        b[d >> 2] = 10;\n        g = i;\n      }\n\n      i = +Ic(16152, h);\n\n      if (i < g) {\n        b[d >> 2] = 11;\n        g = i;\n      }\n\n      i = +Ic(16176, h);\n\n      if (i < g) {\n        b[d >> 2] = 12;\n        g = i;\n      }\n\n      i = +Ic(16200, h);\n\n      if (i < g) {\n        b[d >> 2] = 13;\n        g = i;\n      }\n\n      i = +Ic(16224, h);\n\n      if (i < g) {\n        b[d >> 2] = 14;\n        g = i;\n      }\n\n      i = +Ic(16248, h);\n\n      if (i < g) {\n        b[d >> 2] = 15;\n        g = i;\n      }\n\n      i = +Ic(16272, h);\n\n      if (i < g) {\n        b[d >> 2] = 16;\n        g = i;\n      }\n\n      i = +Ic(16296, h);\n\n      if (i < g) {\n        b[d >> 2] = 17;\n        g = i;\n      }\n\n      i = +Ic(16320, h);\n\n      if (i < g) {\n        b[d >> 2] = 18;\n        g = i;\n      }\n\n      i = +Ic(16344, h);\n\n      if (i < g) {\n        b[d >> 2] = 19;\n        g = i;\n      }\n\n      i = +w(+(1.0 - g * .5));\n\n      if (i < 1.0e-16) {\n        b[f >> 2] = 0;\n        b[f + 4 >> 2] = 0;\n        b[f + 8 >> 2] = 0;\n        b[f + 12 >> 2] = 0;\n        S = k;\n        return;\n      }\n\n      d = b[d >> 2] | 0;\n      g = +e[16368 + (d * 24 | 0) >> 3];\n      g = +gb(g - +gb(+lb(15568 + (d << 4) | 0, a)));\n      if (!(Rb(c) | 0)) { j = g; }else { j = +gb(g + -.3334731722518321); }\n      g = +v(+i) / .381966011250105;\n\n      if ((c | 0) > 0) {\n        h = 0;\n\n        do {\n          g = g * 2.6457513110645907;\n          h = h + 1 | 0;\n        } while ((h | 0) != (c | 0));\n      }\n\n      i = +t(+j) * g;\n      e[f >> 3] = i;\n      j = +u(+j) * g;\n      e[f + 8 >> 3] = j;\n      S = k;\n      return;\n    }\n\n    function _a(a, c, d, f, g) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      f = f | 0;\n      g = g | 0;\n      var h = 0.0,\n          i = 0.0;\n      h = +Fc(a);\n\n      if (h < 1.0e-16) {\n        c = 15568 + (c << 4) | 0;\n        b[g >> 2] = b[c >> 2];\n        b[g + 4 >> 2] = b[c + 4 >> 2];\n        b[g + 8 >> 2] = b[c + 8 >> 2];\n        b[g + 12 >> 2] = b[c + 12 >> 2];\n        return;\n      }\n\n      i = +z(+ +e[a + 8 >> 3], + +e[a >> 3]);\n\n      if ((d | 0) > 0) {\n        a = 0;\n\n        do {\n          h = h / 2.6457513110645907;\n          a = a + 1 | 0;\n        } while ((a | 0) != (d | 0));\n      }\n\n      if (!f) {\n        h = +y(+(h * .381966011250105));\n        if (Rb(d) | 0) { i = +gb(i + .3334731722518321); }\n      } else {\n        h = h / 3.0;\n        d = (Rb(d) | 0) == 0;\n        h = +y(+((d ? h : h / 2.6457513110645907) * .381966011250105));\n      }\n\n      mb(15568 + (c << 4) | 0, +gb(+e[16368 + (c * 24 | 0) >> 3] - i), h, g);\n      return;\n    }\n\n    function $a(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0;\n      e = S;\n      S = S + 16 | 0;\n      f = e;\n      Da(a + 4 | 0, f);\n\n      _a(f, b[a >> 2] | 0, c, 0, d);\n\n      S = e;\n      return;\n    }\n\n    function ab(a, c, d, f, g) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      f = f | 0;\n      g = g | 0;\n      var h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0,\n          p = 0,\n          q = 0,\n          r = 0,\n          s = 0,\n          t = 0,\n          u = 0,\n          v = 0,\n          w = 0,\n          x = 0,\n          y = 0,\n          z = 0,\n          A = 0,\n          B = 0,\n          C = 0,\n          D = 0,\n          E = 0,\n          F = 0,\n          G = 0,\n          I = 0.0,\n          J = 0.0;\n      G = S;\n      S = S + 272 | 0;\n      h = G + 256 | 0;\n      u = G + 240 | 0;\n      D = G;\n      E = G + 224 | 0;\n      F = G + 208 | 0;\n      v = G + 176 | 0;\n      w = G + 160 | 0;\n      x = G + 192 | 0;\n      y = G + 144 | 0;\n      z = G + 128 | 0;\n      A = G + 112 | 0;\n      B = G + 96 | 0;\n      C = G + 80 | 0;\n      b[h >> 2] = c;\n      b[u >> 2] = b[a >> 2];\n      b[u + 4 >> 2] = b[a + 4 >> 2];\n      b[u + 8 >> 2] = b[a + 8 >> 2];\n      b[u + 12 >> 2] = b[a + 12 >> 2];\n      bb(u, h, D);\n      b[g >> 2] = 0;\n      u = f + d + ((f | 0) == 5 & 1) | 0;\n\n      if ((u | 0) <= (d | 0)) {\n        S = G;\n        return;\n      }\n\n      k = b[h >> 2] | 0;\n      l = E + 4 | 0;\n      m = v + 4 | 0;\n      n = d + 5 | 0;\n      o = 16848 + (k << 2) | 0;\n      p = 16928 + (k << 2) | 0;\n      q = z + 8 | 0;\n      r = A + 8 | 0;\n      s = B + 8 | 0;\n      t = F + 4 | 0;\n      j = d;\n\n      a: while (1) {\n        i = D + (((j | 0) % 5 | 0) << 4) | 0;\n        b[F >> 2] = b[i >> 2];\n        b[F + 4 >> 2] = b[i + 4 >> 2];\n        b[F + 8 >> 2] = b[i + 8 >> 2];\n        b[F + 12 >> 2] = b[i + 12 >> 2];\n\n        do {} while ((cb(F, k, 0, 1) | 0) == 2);\n\n        if ((j | 0) > (d | 0) & (Rb(c) | 0) != 0) {\n          b[v >> 2] = b[F >> 2];\n          b[v + 4 >> 2] = b[F + 4 >> 2];\n          b[v + 8 >> 2] = b[F + 8 >> 2];\n          b[v + 12 >> 2] = b[F + 12 >> 2];\n          Da(l, w);\n          f = b[v >> 2] | 0;\n          h = b[17008 + (f * 80 | 0) + (b[E >> 2] << 2) >> 2] | 0;\n          b[v >> 2] = b[18608 + (f * 80 | 0) + (h * 20 | 0) >> 2];\n          i = b[18608 + (f * 80 | 0) + (h * 20 | 0) + 16 >> 2] | 0;\n\n          if ((i | 0) > 0) {\n            a = 0;\n\n            do {\n              Na(m);\n              a = a + 1 | 0;\n            } while ((a | 0) < (i | 0));\n          }\n\n          i = 18608 + (f * 80 | 0) + (h * 20 | 0) + 4 | 0;\n          b[x >> 2] = b[i >> 2];\n          b[x + 4 >> 2] = b[i + 4 >> 2];\n          b[x + 8 >> 2] = b[i + 8 >> 2];\n          Ga(x, (b[o >> 2] | 0) * 3 | 0);\n          Ea(m, x, m);\n          Ca(m);\n          Da(m, y);\n          I = +(b[p >> 2] | 0);\n          e[z >> 3] = I * 3.0;\n          e[q >> 3] = 0.0;\n          J = I * -1.5;\n          e[A >> 3] = J;\n          e[r >> 3] = I * 2.598076211353316;\n          e[B >> 3] = J;\n          e[s >> 3] = I * -2.598076211353316;\n\n          switch (b[17008 + ((b[v >> 2] | 0) * 80 | 0) + (b[F >> 2] << 2) >> 2] | 0) {\n            case 1:\n              {\n                a = A;\n                f = z;\n                break;\n              }\n\n            case 3:\n              {\n                a = B;\n                f = A;\n                break;\n              }\n\n            case 2:\n              {\n                a = z;\n                f = B;\n                break;\n              }\n\n            default:\n              {\n                a = 12;\n                break a;\n              }\n          }\n\n          Gc(w, y, f, a, C);\n\n          _a(C, b[v >> 2] | 0, k, 1, g + 8 + (b[g >> 2] << 4) | 0);\n\n          b[g >> 2] = (b[g >> 2] | 0) + 1;\n        }\n\n        if ((j | 0) < (n | 0)) {\n          Da(t, v);\n\n          _a(v, b[F >> 2] | 0, k, 1, g + 8 + (b[g >> 2] << 4) | 0);\n\n          b[g >> 2] = (b[g >> 2] | 0) + 1;\n        }\n        b[E >> 2] = b[F >> 2];\n        b[E + 4 >> 2] = b[F + 4 >> 2];\n        b[E + 8 >> 2] = b[F + 8 >> 2];\n        b[E + 12 >> 2] = b[F + 12 >> 2];\n        j = j + 1 | 0;\n\n        if ((j | 0) >= (u | 0)) {\n          a = 3;\n          break;\n        }\n      }\n\n      if ((a | 0) == 3) {\n        S = G;\n        return;\n      } else if ((a | 0) == 12) { H(22474, 22521, 581, 22531); }\n    }\n\n    function bb(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0;\n      j = S;\n      S = S + 128 | 0;\n      e = j + 64 | 0;\n      f = j;\n      g = e;\n      h = 20208;\n      i = g + 60 | 0;\n\n      do {\n        b[g >> 2] = b[h >> 2];\n        g = g + 4 | 0;\n        h = h + 4 | 0;\n      } while ((g | 0) < (i | 0));\n\n      g = f;\n      h = 20272;\n      i = g + 60 | 0;\n\n      do {\n        b[g >> 2] = b[h >> 2];\n        g = g + 4 | 0;\n        h = h + 4 | 0;\n      } while ((g | 0) < (i | 0));\n\n      i = (Rb(b[c >> 2] | 0) | 0) == 0;\n      e = i ? e : f;\n      f = a + 4 | 0;\n      Ra(f);\n      Sa(f);\n\n      if (Rb(b[c >> 2] | 0) | 0) {\n        La(f);\n        b[c >> 2] = (b[c >> 2] | 0) + 1;\n      }\n\n      b[d >> 2] = b[a >> 2];\n      c = d + 4 | 0;\n      Ea(f, e, c);\n      Ca(c);\n      b[d + 16 >> 2] = b[a >> 2];\n      c = d + 20 | 0;\n      Ea(f, e + 12 | 0, c);\n      Ca(c);\n      b[d + 32 >> 2] = b[a >> 2];\n      c = d + 36 | 0;\n      Ea(f, e + 24 | 0, c);\n      Ca(c);\n      b[d + 48 >> 2] = b[a >> 2];\n      c = d + 52 | 0;\n      Ea(f, e + 36 | 0, c);\n      Ca(c);\n      b[d + 64 >> 2] = b[a >> 2];\n      d = d + 68 | 0;\n      Ea(f, e + 48 | 0, d);\n      Ca(d);\n      S = j;\n      return;\n    }\n\n    function cb(a, c, d, e) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      var f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0,\n          p = 0;\n      p = S;\n      S = S + 32 | 0;\n      n = p + 12 | 0;\n      i = p;\n      o = a + 4 | 0;\n      m = b[16928 + (c << 2) >> 2] | 0;\n      l = (e | 0) != 0;\n      m = l ? m * 3 | 0 : m;\n      f = b[o >> 2] | 0;\n      k = a + 8 | 0;\n      h = b[k >> 2] | 0;\n\n      if (l) {\n        g = a + 12 | 0;\n        e = b[g >> 2] | 0;\n        f = h + f + e | 0;\n\n        if ((f | 0) == (m | 0)) {\n          o = 1;\n          S = p;\n          return o | 0;\n        } else { j = g; }\n      } else {\n        j = a + 12 | 0;\n        e = b[j >> 2] | 0;\n        f = h + f + e | 0;\n      }\n\n      if ((f | 0) <= (m | 0)) {\n        o = 0;\n        S = p;\n        return o | 0;\n      }\n\n      do { if ((e | 0) > 0) {\n        e = b[a >> 2] | 0;\n\n        if ((h | 0) > 0) {\n          g = 18608 + (e * 80 | 0) + 60 | 0;\n          e = a;\n          break;\n        }\n\n        e = 18608 + (e * 80 | 0) + 40 | 0;\n\n        if (!d) {\n          g = e;\n          e = a;\n        } else {\n          Aa(n, m, 0, 0);\n          Fa(o, n, i);\n          Oa(i);\n          Ea(i, n, o);\n          g = e;\n          e = a;\n        }\n      } else {\n        g = 18608 + ((b[a >> 2] | 0) * 80 | 0) + 20 | 0;\n        e = a;\n      } } while (0);\n\n      b[e >> 2] = b[g >> 2];\n      f = g + 16 | 0;\n\n      if ((b[f >> 2] | 0) > 0) {\n        e = 0;\n\n        do {\n          Na(o);\n          e = e + 1 | 0;\n        } while ((e | 0) < (b[f >> 2] | 0));\n      }\n\n      a = g + 4 | 0;\n      b[n >> 2] = b[a >> 2];\n      b[n + 4 >> 2] = b[a + 4 >> 2];\n      b[n + 8 >> 2] = b[a + 8 >> 2];\n      c = b[16848 + (c << 2) >> 2] | 0;\n      Ga(n, l ? c * 3 | 0 : c);\n      Ea(o, n, o);\n      Ca(o);\n      if (l) { e = ((b[k >> 2] | 0) + (b[o >> 2] | 0) + (b[j >> 2] | 0) | 0) == (m | 0) ? 1 : 2; }else { e = 2; }\n      o = e;\n      S = p;\n      return o | 0;\n    }\n\n    function db(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0;\n\n      do { c = cb(a, b, 0, 1) | 0; } while ((c | 0) == 2);\n\n      return c | 0;\n    }\n\n    function eb(a, c, d, f, g) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      f = f | 0;\n      g = g | 0;\n      var h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0,\n          p = 0,\n          q = 0,\n          r = 0,\n          s = 0,\n          t = 0,\n          u = 0,\n          v = 0,\n          w = 0,\n          x = 0,\n          y = 0,\n          z = 0,\n          A = 0,\n          B = 0,\n          C = 0.0,\n          D = 0.0;\n      B = S;\n      S = S + 240 | 0;\n      h = B + 224 | 0;\n      x = B + 208 | 0;\n      y = B;\n      z = B + 192 | 0;\n      A = B + 176 | 0;\n      s = B + 160 | 0;\n      t = B + 144 | 0;\n      u = B + 128 | 0;\n      v = B + 112 | 0;\n      w = B + 96 | 0;\n      b[h >> 2] = c;\n      b[x >> 2] = b[a >> 2];\n      b[x + 4 >> 2] = b[a + 4 >> 2];\n      b[x + 8 >> 2] = b[a + 8 >> 2];\n      b[x + 12 >> 2] = b[a + 12 >> 2];\n      fb(x, h, y);\n      b[g >> 2] = 0;\n      r = f + d + ((f | 0) == 6 & 1) | 0;\n\n      if ((r | 0) <= (d | 0)) {\n        S = B;\n        return;\n      }\n\n      k = b[h >> 2] | 0;\n      l = d + 6 | 0;\n      m = 16928 + (k << 2) | 0;\n      n = t + 8 | 0;\n      o = u + 8 | 0;\n      p = v + 8 | 0;\n      q = z + 4 | 0;\n      i = 0;\n      j = d;\n      f = -1;\n\n      a: while (1) {\n        h = (j | 0) % 6 | 0;\n        a = y + (h << 4) | 0;\n        b[z >> 2] = b[a >> 2];\n        b[z + 4 >> 2] = b[a + 4 >> 2];\n        b[z + 8 >> 2] = b[a + 8 >> 2];\n        b[z + 12 >> 2] = b[a + 12 >> 2];\n        a = i;\n        i = cb(z, k, 0, 1) | 0;\n\n        if ((j | 0) > (d | 0) & (Rb(c) | 0) != 0 ? (a | 0) != 1 ? (b[z >> 2] | 0) != (f | 0) : 0 : 0) {\n          Da(y + (((h + 5 | 0) % 6 | 0) << 4) + 4 | 0, A);\n          Da(y + (h << 4) + 4 | 0, s);\n          C = +(b[m >> 2] | 0);\n          e[t >> 3] = C * 3.0;\n          e[n >> 3] = 0.0;\n          D = C * -1.5;\n          e[u >> 3] = D;\n          e[o >> 3] = C * 2.598076211353316;\n          e[v >> 3] = D;\n          e[p >> 3] = C * -2.598076211353316;\n          h = b[x >> 2] | 0;\n\n          switch (b[17008 + (h * 80 | 0) + (((f | 0) == (h | 0) ? b[z >> 2] | 0 : f) << 2) >> 2] | 0) {\n            case 1:\n              {\n                a = u;\n                f = t;\n                break;\n              }\n\n            case 3:\n              {\n                a = v;\n                f = u;\n                break;\n              }\n\n            case 2:\n              {\n                a = t;\n                f = v;\n                break;\n              }\n\n            default:\n              {\n                a = 8;\n                break a;\n              }\n          }\n\n          Gc(A, s, f, a, w);\n\n          if (!(Hc(A, w) | 0) ? !(Hc(s, w) | 0) : 0) {\n            _a(w, b[x >> 2] | 0, k, 1, g + 8 + (b[g >> 2] << 4) | 0);\n\n            b[g >> 2] = (b[g >> 2] | 0) + 1;\n          }\n        }\n\n        if ((j | 0) < (l | 0)) {\n          Da(q, A);\n\n          _a(A, b[z >> 2] | 0, k, 1, g + 8 + (b[g >> 2] << 4) | 0);\n\n          b[g >> 2] = (b[g >> 2] | 0) + 1;\n        }\n\n        j = j + 1 | 0;\n\n        if ((j | 0) >= (r | 0)) {\n          a = 3;\n          break;\n        } else { f = b[z >> 2] | 0; }\n      }\n\n      if ((a | 0) == 3) {\n        S = B;\n        return;\n      } else if ((a | 0) == 8) { H(22557, 22521, 746, 22602); }\n    }\n\n    function fb(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0;\n      j = S;\n      S = S + 160 | 0;\n      e = j + 80 | 0;\n      f = j;\n      g = e;\n      h = 20336;\n      i = g + 72 | 0;\n\n      do {\n        b[g >> 2] = b[h >> 2];\n        g = g + 4 | 0;\n        h = h + 4 | 0;\n      } while ((g | 0) < (i | 0));\n\n      g = f;\n      h = 20416;\n      i = g + 72 | 0;\n\n      do {\n        b[g >> 2] = b[h >> 2];\n        g = g + 4 | 0;\n        h = h + 4 | 0;\n      } while ((g | 0) < (i | 0));\n\n      i = (Rb(b[c >> 2] | 0) | 0) == 0;\n      e = i ? e : f;\n      f = a + 4 | 0;\n      Ra(f);\n      Sa(f);\n\n      if (Rb(b[c >> 2] | 0) | 0) {\n        La(f);\n        b[c >> 2] = (b[c >> 2] | 0) + 1;\n      }\n\n      b[d >> 2] = b[a >> 2];\n      c = d + 4 | 0;\n      Ea(f, e, c);\n      Ca(c);\n      b[d + 16 >> 2] = b[a >> 2];\n      c = d + 20 | 0;\n      Ea(f, e + 12 | 0, c);\n      Ca(c);\n      b[d + 32 >> 2] = b[a >> 2];\n      c = d + 36 | 0;\n      Ea(f, e + 24 | 0, c);\n      Ca(c);\n      b[d + 48 >> 2] = b[a >> 2];\n      c = d + 52 | 0;\n      Ea(f, e + 36 | 0, c);\n      Ca(c);\n      b[d + 64 >> 2] = b[a >> 2];\n      c = d + 68 | 0;\n      Ea(f, e + 48 | 0, c);\n      Ca(c);\n      b[d + 80 >> 2] = b[a >> 2];\n      d = d + 84 | 0;\n      Ea(f, e + 60 | 0, d);\n      Ca(d);\n      S = j;\n      return;\n    }\n\n    function gb(a) {\n      a = +a;\n      var b = 0.0;\n      b = a < 0.0 ? a + 6.283185307179586 : a;\n      return +(!(a >= 6.283185307179586) ? b : b + -6.283185307179586);\n    }\n\n    function hb(a, b) {\n      a = a | 0;\n      b = b | 0;\n\n      if (!(+q(+(+e[a >> 3] - +e[b >> 3])) < 1.7453292519943298e-11)) {\n        b = 0;\n        return b | 0;\n      }\n\n      b = +q(+(+e[a + 8 >> 3] - +e[b + 8 >> 3])) < 1.7453292519943298e-11;\n      return b | 0;\n    }\n\n    function ib(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0.0,\n          d = 0.0,\n          f = 0.0,\n          g = 0.0;\n      f = +e[b >> 3];\n      d = +e[a >> 3];\n      g = +u(+((f - d) * .5));\n      c = +u(+((+e[b + 8 >> 3] - +e[a + 8 >> 3]) * .5));\n      c = g * g + c * (+t(+f) * +t(+d) * c);\n      return +(+z(+ +r(+c), + +r(+(1.0 - c))) * 2.0);\n    }\n\n    function jb(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0.0,\n          d = 0.0,\n          f = 0.0,\n          g = 0.0;\n      f = +e[b >> 3];\n      d = +e[a >> 3];\n      g = +u(+((f - d) * .5));\n      c = +u(+((+e[b + 8 >> 3] - +e[a + 8 >> 3]) * .5));\n      c = g * g + c * (+t(+f) * +t(+d) * c);\n      return +(+z(+ +r(+c), + +r(+(1.0 - c))) * 2.0 * 6371.007180918475);\n    }\n\n    function kb(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0.0,\n          d = 0.0,\n          f = 0.0,\n          g = 0.0;\n      f = +e[b >> 3];\n      d = +e[a >> 3];\n      g = +u(+((f - d) * .5));\n      c = +u(+((+e[b + 8 >> 3] - +e[a + 8 >> 3]) * .5));\n      c = g * g + c * (+t(+f) * +t(+d) * c);\n      return +(+z(+ +r(+c), + +r(+(1.0 - c))) * 2.0 * 6371.007180918475 * 1.0e3);\n    }\n\n    function lb(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0.0,\n          d = 0.0,\n          f = 0.0,\n          g = 0.0,\n          h = 0.0;\n      g = +e[b >> 3];\n      d = +t(+g);\n      f = +e[b + 8 >> 3] - +e[a + 8 >> 3];\n      h = d * +u(+f);\n      c = +e[a >> 3];\n      return + +z(+h, +(+u(+g) * +t(+c) - +t(+f) * (d * +u(+c))));\n    }\n\n    function mb(a, c, d, f) {\n      a = a | 0;\n      c = +c;\n      d = +d;\n      f = f | 0;\n      var g = 0,\n          h = 0.0,\n          i = 0.0,\n          j = 0.0;\n\n      if (d < 1.0e-16) {\n        b[f >> 2] = b[a >> 2];\n        b[f + 4 >> 2] = b[a + 4 >> 2];\n        b[f + 8 >> 2] = b[a + 8 >> 2];\n        b[f + 12 >> 2] = b[a + 12 >> 2];\n        return;\n      }\n\n      h = c < 0.0 ? c + 6.283185307179586 : c;\n      h = !(c >= 6.283185307179586) ? h : h + -6.283185307179586;\n\n      do { if (h < 1.0e-16) {\n        c = +e[a >> 3] + d;\n        e[f >> 3] = c;\n        g = f;\n      } else {\n        g = +q(+(h + -3.141592653589793)) < 1.0e-16;\n        c = +e[a >> 3];\n\n        if (g) {\n          c = c - d;\n          e[f >> 3] = c;\n          g = f;\n          break;\n        }\n\n        i = +t(+d);\n        d = +u(+d);\n        c = i * +u(+c) + +t(+h) * (d * +t(+c));\n        c = c > 1.0 ? 1.0 : c;\n        c = +x(+(c < -1.0 ? -1.0 : c));\n        e[f >> 3] = c;\n\n        if (+q(+(c + -1.5707963267948966)) < 1.0e-16) {\n          e[f >> 3] = 1.5707963267948966;\n          e[f + 8 >> 3] = 0.0;\n          return;\n        }\n\n        if (+q(+(c + 1.5707963267948966)) < 1.0e-16) {\n          e[f >> 3] = -1.5707963267948966;\n          e[f + 8 >> 3] = 0.0;\n          return;\n        }\n\n        j = +t(+c);\n        h = d * +u(+h) / j;\n        d = +e[a >> 3];\n        c = (i - +u(+c) * +u(+d)) / +t(+d) / j;\n        i = h > 1.0 ? 1.0 : h;\n        c = c > 1.0 ? 1.0 : c;\n        c = +e[a + 8 >> 3] + +z(+(i < -1.0 ? -1.0 : i), +(c < -1.0 ? -1.0 : c));\n        if (c > 3.141592653589793) { do { c = c + -6.283185307179586; } while (c > 3.141592653589793); }\n        if (c < -3.141592653589793) { do { c = c + 6.283185307179586; } while (c < -3.141592653589793); }\n        e[f + 8 >> 3] = c;\n        return;\n      } } while (0);\n\n      if (+q(+(c + -1.5707963267948966)) < 1.0e-16) {\n        e[g >> 3] = 1.5707963267948966;\n        e[f + 8 >> 3] = 0.0;\n        return;\n      }\n\n      if (+q(+(c + 1.5707963267948966)) < 1.0e-16) {\n        e[g >> 3] = -1.5707963267948966;\n        e[f + 8 >> 3] = 0.0;\n        return;\n      }\n\n      c = +e[a + 8 >> 3];\n      if (c > 3.141592653589793) { do { c = c + -6.283185307179586; } while (c > 3.141592653589793); }\n      if (c < -3.141592653589793) { do { c = c + 6.283185307179586; } while (c < -3.141592653589793); }\n      e[f + 8 >> 3] = c;\n      return;\n    }\n\n    function nb(a) {\n      a = a | 0;\n      return + +e[20496 + (a << 3) >> 3];\n    }\n\n    function ob(a) {\n      a = a | 0;\n      return + +e[20624 + (a << 3) >> 3];\n    }\n\n    function pb(a) {\n      a = a | 0;\n      return + +e[20752 + (a << 3) >> 3];\n    }\n\n    function qb(a) {\n      a = a | 0;\n      return + +e[20880 + (a << 3) >> 3];\n    }\n\n    function rb(a) {\n      a = a | 0;\n      var c = 0;\n      c = 21008 + (a << 3) | 0;\n      a = b[c >> 2] | 0;\n      F(b[c + 4 >> 2] | 0);\n      return a | 0;\n    }\n\n    function sb(a, b, c) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      var d = 0.0,\n          f = 0.0,\n          g = 0.0,\n          h = 0.0,\n          i = 0.0,\n          j = 0.0,\n          k = 0.0,\n          l = 0.0,\n          m = 0.0,\n          n = 0.0;\n      n = +e[b >> 3];\n      l = +e[a >> 3];\n      j = +u(+((n - l) * .5));\n      g = +e[b + 8 >> 3];\n      k = +e[a + 8 >> 3];\n      h = +u(+((g - k) * .5));\n      i = +t(+l);\n      m = +t(+n);\n      h = j * j + h * (m * i * h);\n      h = +z(+ +r(+h), + +r(+(1.0 - h))) * 2.0;\n      j = +e[c >> 3];\n      n = +u(+((j - n) * .5));\n      d = +e[c + 8 >> 3];\n      g = +u(+((d - g) * .5));\n      f = +t(+j);\n      g = n * n + g * (m * f * g);\n      g = +z(+ +r(+g), + +r(+(1.0 - g))) * 2.0;\n      j = +u(+((l - j) * .5));\n      d = +u(+((k - d) * .5));\n      d = j * j + d * (i * f * d);\n      d = +z(+ +r(+d), + +r(+(1.0 - d))) * 2.0;\n      f = (h + g + d) * .5;\n      return +(+y(+ +r(+(+v(+(f * .5)) * +v(+((f - h) * .5)) * +v(+((f - g) * .5)) * +v(+((f - d) * .5))))) * 4.0);\n    }\n\n    function tb(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0.0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0;\n      g = S;\n      S = S + 192 | 0;\n      e = g + 168 | 0;\n      f = g;\n      Vb(a, c, e);\n      Wb(a, c, f);\n      c = b[f >> 2] | 0;\n\n      if ((c | 0) <= 0) {\n        d = 0.0;\n        S = g;\n        return +d;\n      }\n\n      d = +sb(f + 8 | 0, f + 8 + (((c | 0) != 1 & 1) << 4) | 0, e) + 0.0;\n\n      if ((c | 0) == 1) {\n        S = g;\n        return +d;\n      }\n\n      a = 1;\n\n      do {\n        h = a;\n        a = a + 1 | 0;\n        d = d + +sb(f + 8 + (h << 4) | 0, f + 8 + (((a | 0) % (c | 0) | 0) << 4) | 0, e);\n      } while ((a | 0) < (c | 0));\n\n      S = g;\n      return +d;\n    }\n\n    function ub(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0.0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0;\n      g = S;\n      S = S + 192 | 0;\n      e = g + 168 | 0;\n      f = g;\n      Vb(a, c, e);\n      Wb(a, c, f);\n      c = b[f >> 2] | 0;\n\n      if ((c | 0) > 0) {\n        d = +sb(f + 8 | 0, f + 8 + (((c | 0) != 1 & 1) << 4) | 0, e) + 0.0;\n\n        if ((c | 0) != 1) {\n          a = 1;\n\n          do {\n            h = a;\n            a = a + 1 | 0;\n            d = d + +sb(f + 8 + (h << 4) | 0, f + 8 + (((a | 0) % (c | 0) | 0) << 4) | 0, e);\n          } while ((a | 0) < (c | 0));\n        }\n      } else { d = 0.0; }\n\n      S = g;\n      return +(d * 6371.007180918475 * 6371.007180918475);\n    }\n\n    function vb(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0.0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0;\n      g = S;\n      S = S + 192 | 0;\n      e = g + 168 | 0;\n      f = g;\n      Vb(a, c, e);\n      Wb(a, c, f);\n      c = b[f >> 2] | 0;\n\n      if ((c | 0) > 0) {\n        d = +sb(f + 8 | 0, f + 8 + (((c | 0) != 1 & 1) << 4) | 0, e) + 0.0;\n\n        if ((c | 0) != 1) {\n          a = 1;\n\n          do {\n            h = a;\n            a = a + 1 | 0;\n            d = d + +sb(f + 8 + (h << 4) | 0, f + 8 + (((a | 0) % (c | 0) | 0) << 4) | 0, e);\n          } while ((a | 0) < (c | 0));\n        }\n      } else { d = 0.0; }\n\n      S = g;\n      return +(d * 6371.007180918475 * 6371.007180918475 * 1.0e3 * 1.0e3);\n    }\n\n    function wb(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0.0,\n          f = 0.0,\n          g = 0.0,\n          h = 0,\n          i = 0,\n          j = 0.0,\n          k = 0.0,\n          l = 0.0;\n      i = S;\n      S = S + 176 | 0;\n      h = i;\n      gc(a, c, h);\n      a = b[h >> 2] | 0;\n\n      if ((a | 0) <= 1) {\n        g = 0.0;\n        S = i;\n        return +g;\n      }\n\n      c = a + -1 | 0;\n      a = 0;\n      d = 0.0;\n      f = +e[h + 8 >> 3];\n      g = +e[h + 16 >> 3];\n\n      do {\n        a = a + 1 | 0;\n        k = f;\n        f = +e[h + 8 + (a << 4) >> 3];\n        l = +u(+((f - k) * .5));\n        j = g;\n        g = +e[h + 8 + (a << 4) + 8 >> 3];\n        j = +u(+((g - j) * .5));\n        j = l * l + j * (+t(+f) * +t(+k) * j);\n        d = d + +z(+ +r(+j), + +r(+(1.0 - j))) * 2.0;\n      } while ((a | 0) < (c | 0));\n\n      S = i;\n      return +d;\n    }\n\n    function xb(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0.0,\n          f = 0.0,\n          g = 0.0,\n          h = 0,\n          i = 0,\n          j = 0.0,\n          k = 0.0,\n          l = 0.0;\n      i = S;\n      S = S + 176 | 0;\n      h = i;\n      gc(a, c, h);\n      a = b[h >> 2] | 0;\n\n      if ((a | 0) <= 1) {\n        g = 0.0;\n        S = i;\n        return +g;\n      }\n\n      c = a + -1 | 0;\n      a = 0;\n      d = 0.0;\n      f = +e[h + 8 >> 3];\n      g = +e[h + 16 >> 3];\n\n      do {\n        a = a + 1 | 0;\n        k = f;\n        f = +e[h + 8 + (a << 4) >> 3];\n        l = +u(+((f - k) * .5));\n        j = g;\n        g = +e[h + 8 + (a << 4) + 8 >> 3];\n        j = +u(+((g - j) * .5));\n        j = l * l + j * (+t(+k) * +t(+f) * j);\n        d = d + +z(+ +r(+j), + +r(+(1.0 - j))) * 2.0;\n      } while ((a | 0) != (c | 0));\n\n      l = d * 6371.007180918475;\n      S = i;\n      return +l;\n    }\n\n    function yb(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0.0,\n          f = 0.0,\n          g = 0.0,\n          h = 0,\n          i = 0,\n          j = 0.0,\n          k = 0.0,\n          l = 0.0;\n      i = S;\n      S = S + 176 | 0;\n      h = i;\n      gc(a, c, h);\n      a = b[h >> 2] | 0;\n\n      if ((a | 0) <= 1) {\n        g = 0.0;\n        S = i;\n        return +g;\n      }\n\n      c = a + -1 | 0;\n      a = 0;\n      d = 0.0;\n      f = +e[h + 8 >> 3];\n      g = +e[h + 16 >> 3];\n\n      do {\n        a = a + 1 | 0;\n        k = f;\n        f = +e[h + 8 + (a << 4) >> 3];\n        l = +u(+((f - k) * .5));\n        j = g;\n        g = +e[h + 8 + (a << 4) + 8 >> 3];\n        j = +u(+((g - j) * .5));\n        j = l * l + j * (+t(+k) * +t(+f) * j);\n        d = d + +z(+ +r(+j), + +r(+(1.0 - j))) * 2.0;\n      } while ((a | 0) != (c | 0));\n\n      l = d * 6371.007180918475 * 1.0e3;\n      S = i;\n      return +l;\n    }\n\n    function zb(a, b) {\n      a = a | 0;\n      b = b | 0;\n      b = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      return b & 15 | 0;\n    }\n\n    function Ab(a, b) {\n      a = a | 0;\n      b = b | 0;\n      b = cd(a | 0, b | 0, 45) | 0;\n      G() | 0;\n      return b & 127 | 0;\n    }\n\n    function Bb(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0;\n\n      if (!(0 == 0 & (b & -16777216 | 0) == 134217728)) {\n        b = 0;\n        return b | 0;\n      }\n\n      g = cd(a | 0, b | 0, 45) | 0;\n      G() | 0;\n      g = g & 127;\n\n      if (g >>> 0 > 121) {\n        b = 0;\n        return b | 0;\n      }\n\n      c = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      c = c & 15;\n\n      do { if (c | 0) {\n        e = 1;\n        d = 0;\n\n        while (1) {\n          f = cd(a | 0, b | 0, (15 - e | 0) * 3 | 0) | 0;\n          G() | 0;\n          f = f & 7;\n          if ((f | 0) != 0 & (d ^ 1)) { if ((f | 0) == 1 & (la(g) | 0) != 0) {\n            h = 0;\n            d = 13;\n            break;\n          } else { d = 1; } }\n\n          if ((f | 0) == 7) {\n            h = 0;\n            d = 13;\n            break;\n          }\n\n          if (e >>> 0 < c >>> 0) { e = e + 1 | 0; }else {\n            d = 9;\n            break;\n          }\n        }\n\n        if ((d | 0) == 9) {\n          if ((c | 0) == 15) { h = 1; }else { break; }\n          return h | 0;\n        } else if ((d | 0) == 13) { return h | 0; }\n      } } while (0);\n\n      while (1) {\n        h = cd(a | 0, b | 0, (14 - c | 0) * 3 | 0) | 0;\n        G() | 0;\n\n        if (!((h & 7 | 0) == 7 & 0 == 0)) {\n          h = 0;\n          d = 13;\n          break;\n        }\n\n        if (c >>> 0 < 14) { c = c + 1 | 0; }else {\n          h = 1;\n          d = 13;\n          break;\n        }\n      }\n\n      if ((d | 0) == 13) { return h | 0; }\n      return 0;\n    }\n\n    function Cb(a, b, c) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0;\n      d = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      d = d & 15;\n\n      if ((d | 0) >= (c | 0)) {\n        if ((d | 0) != (c | 0)) { if (c >>> 0 <= 15) {\n          e = dd(c | 0, 0, 52) | 0;\n          a = e | a;\n          b = G() | 0 | b & -15728641;\n          if ((d | 0) > (c | 0)) { do {\n            e = dd(7, 0, (14 - c | 0) * 3 | 0) | 0;\n            c = c + 1 | 0;\n            a = e | a;\n            b = G() | 0 | b;\n          } while ((c | 0) < (d | 0)); }\n        } else {\n          b = 0;\n          a = 0;\n        } }\n      } else {\n        b = 0;\n        a = 0;\n      }\n\n      F(b | 0);\n      return a | 0;\n    }\n\n    function Db(a, b, c) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      a = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      a = a & 15;\n\n      if (!((c | 0) < 16 & (a | 0) <= (c | 0))) {\n        c = 0;\n        return c | 0;\n      }\n\n      c = tc(7, c - a | 0) | 0;\n      return c | 0;\n    }\n\n    function Eb(a, c, d, e) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      var f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0;\n      h = cd(a | 0, c | 0, 52) | 0;\n      G() | 0;\n      h = h & 15;\n      if (!((d | 0) < 16 & (h | 0) <= (d | 0))) { return; }\n\n      if ((h | 0) == (d | 0)) {\n        d = e;\n        b[d >> 2] = a;\n        b[d + 4 >> 2] = c;\n        return;\n      }\n\n      j = tc(7, d - h | 0) | 0;\n      k = (j | 0) / 7 | 0;\n      i = cd(a | 0, c | 0, 45) | 0;\n      G() | 0;\n      if (!(la(i & 127) | 0)) { g = 0; }else {\n        a: do { if (!h) { f = 0; }else {\n          g = 1;\n\n          while (1) {\n            f = cd(a | 0, c | 0, (15 - g | 0) * 3 | 0) | 0;\n            G() | 0;\n            f = f & 7;\n            if (f | 0) { break a; }\n            if (g >>> 0 < h >>> 0) { g = g + 1 | 0; }else {\n              f = 0;\n              break;\n            }\n          }\n        } } while (0);\n\n        g = (f | 0) == 0;\n      }\n      l = dd(h + 1 | 0, 0, 52) | 0;\n      f = G() | 0 | c & -15728641;\n      i = (14 - h | 0) * 3 | 0;\n      c = dd(7, 0, i | 0) | 0;\n      c = (l | a) & ~c;\n      h = f & ~(G() | 0);\n      Eb(c, h, d, e);\n      f = e + (k << 3) | 0;\n\n      if (!g) {\n        l = dd(1, 0, i | 0) | 0;\n        Eb(l | c, G() | 0 | h, d, f);\n        l = f + (k << 3) | 0;\n        j = dd(2, 0, i | 0) | 0;\n        Eb(j | c, G() | 0 | h, d, l);\n        l = l + (k << 3) | 0;\n        j = dd(3, 0, i | 0) | 0;\n        Eb(j | c, G() | 0 | h, d, l);\n        l = l + (k << 3) | 0;\n        j = dd(4, 0, i | 0) | 0;\n        Eb(j | c, G() | 0 | h, d, l);\n        l = l + (k << 3) | 0;\n        j = dd(5, 0, i | 0) | 0;\n        Eb(j | c, G() | 0 | h, d, l);\n        j = dd(6, 0, i | 0) | 0;\n        Eb(j | c, G() | 0 | h, d, l + (k << 3) | 0);\n        return;\n      }\n\n      g = f + (k << 3) | 0;\n\n      if ((j | 0) > 6) {\n        j = f + 8 | 0;\n        l = (g >>> 0 > j >>> 0 ? g : j) + -1 + (0 - f) | 0;\n        hd(f | 0, 0, l + 8 & -8 | 0) | 0;\n        f = j + (l >>> 3 << 3) | 0;\n      }\n\n      l = dd(2, 0, i | 0) | 0;\n      Eb(l | c, G() | 0 | h, d, f);\n      l = f + (k << 3) | 0;\n      j = dd(3, 0, i | 0) | 0;\n      Eb(j | c, G() | 0 | h, d, l);\n      l = l + (k << 3) | 0;\n      j = dd(4, 0, i | 0) | 0;\n      Eb(j | c, G() | 0 | h, d, l);\n      l = l + (k << 3) | 0;\n      j = dd(5, 0, i | 0) | 0;\n      Eb(j | c, G() | 0 | h, d, l);\n      j = dd(6, 0, i | 0) | 0;\n      Eb(j | c, G() | 0 | h, d, l + (k << 3) | 0);\n      return;\n    }\n\n    function Fb(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0,\n          d = 0,\n          e = 0;\n      e = cd(a | 0, b | 0, 45) | 0;\n      G() | 0;\n\n      if (!(la(e & 127) | 0)) {\n        e = 0;\n        return e | 0;\n      }\n\n      e = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      e = e & 15;\n\n      a: do { if (!e) { c = 0; }else {\n        d = 1;\n\n        while (1) {\n          c = cd(a | 0, b | 0, (15 - d | 0) * 3 | 0) | 0;\n          G() | 0;\n          c = c & 7;\n          if (c | 0) { break a; }\n          if (d >>> 0 < e >>> 0) { d = d + 1 | 0; }else {\n            c = 0;\n            break;\n          }\n        }\n      } } while (0);\n\n      e = (c | 0) == 0 & 1;\n      return e | 0;\n    }\n\n    function Gb(a, b, c) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0;\n      d = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      d = d & 15;\n\n      if ((c | 0) < 16 & (d | 0) <= (c | 0)) {\n        if ((d | 0) != (c | 0)) {\n          e = dd(c | 0, 0, 52) | 0;\n          a = e | a;\n          b = G() | 0 | b & -15728641;\n          if ((d | 0) < (c | 0)) { do {\n            e = dd(7, 0, (14 - d | 0) * 3 | 0) | 0;\n            d = d + 1 | 0;\n            a = a & ~e;\n            b = b & ~(G() | 0);\n          } while ((d | 0) < (c | 0)); }\n        }\n      } else {\n        b = 0;\n        a = 0;\n      }\n\n      F(b | 0);\n      return a | 0;\n    }\n\n    function Hb(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0,\n          p = 0,\n          q = 0,\n          r = 0,\n          s = 0,\n          t = 0,\n          u = 0,\n          v = 0,\n          w = 0,\n          x = 0,\n          y = 0,\n          z = 0;\n\n      if (!d) {\n        y = 0;\n        return y | 0;\n      }\n\n      f = a;\n      e = b[f >> 2] | 0;\n      f = b[f + 4 >> 2] | 0;\n\n      if (0 == 0 & (f & 15728640 | 0) == 0) {\n        if ((d | 0) <= 0) {\n          y = 0;\n          return y | 0;\n        }\n\n        y = c;\n        b[y >> 2] = e;\n        b[y + 4 >> 2] = f;\n\n        if ((d | 0) == 1) {\n          y = 0;\n          return y | 0;\n        }\n\n        e = 1;\n\n        do {\n          w = a + (e << 3) | 0;\n          x = b[w + 4 >> 2] | 0;\n          y = c + (e << 3) | 0;\n          b[y >> 2] = b[w >> 2];\n          b[y + 4 >> 2] = x;\n          e = e + 1 | 0;\n        } while ((e | 0) != (d | 0));\n\n        e = 0;\n        return e | 0;\n      }\n\n      w = d << 3;\n      x = Wc(w) | 0;\n\n      if (!x) {\n        y = -3;\n        return y | 0;\n      }\n\n      gd(x | 0, a | 0, w | 0) | 0;\n      v = Yc(d, 8) | 0;\n\n      if (!v) {\n        Xc(x);\n        y = -3;\n        return y | 0;\n      }\n\n      e = d;\n\n      a: while (1) {\n        h = x;\n        l = b[h >> 2] | 0;\n        h = b[h + 4 >> 2] | 0;\n        t = cd(l | 0, h | 0, 52) | 0;\n        G() | 0;\n        t = t & 15;\n        u = t + -1 | 0;\n        s = (e | 0) > 0;\n\n        b: do { if (s) {\n          r = ((e | 0) < 0) << 31 >> 31;\n          p = dd(u | 0, 0, 52) | 0;\n          q = G() | 0;\n\n          if (u >>> 0 > 15) {\n            f = 0;\n            a = l;\n            d = h;\n\n            while (1) {\n              if (!((a | 0) == 0 & (d | 0) == 0)) {\n                g = cd(a | 0, d | 0, 52) | 0;\n                G() | 0;\n                g = g & 15;\n                i = (g | 0) < (u | 0);\n                g = (g | 0) == (u | 0);\n                k = i ? 0 : g ? a : 0;\n                a = i ? 0 : g ? d : 0;\n                d = bd(k | 0, a | 0, e | 0, r | 0) | 0;\n                G() | 0;\n                g = v + (d << 3) | 0;\n                i = g;\n                j = b[i >> 2] | 0;\n                i = b[i + 4 >> 2] | 0;\n                if ((j | 0) == 0 & (i | 0) == 0) { d = k; }else {\n                  p = 0;\n                  o = d;\n                  n = i;\n                  d = k;\n\n                  while (1) {\n                    if ((p | 0) > (e | 0)) {\n                      y = 41;\n                      break a;\n                    }\n\n                    if ((j | 0) == (d | 0) & (n & -117440513 | 0) == (a | 0)) {\n                      k = cd(j | 0, n | 0, 56) | 0;\n                      G() | 0;\n                      k = k & 7;\n                      m = k + 1 | 0;\n                      q = cd(j | 0, n | 0, 45) | 0;\n                      G() | 0;\n\n                      c: do { if (!(la(q & 127) | 0)) { i = 7; }else {\n                        j = cd(j | 0, n | 0, 52) | 0;\n                        G() | 0;\n                        j = j & 15;\n\n                        if (!j) {\n                          i = 6;\n                          break;\n                        }\n\n                        i = 1;\n\n                        while (1) {\n                          q = dd(7, 0, (15 - i | 0) * 3 | 0) | 0;\n\n                          if (!((q & d | 0) == 0 & ((G() | 0) & a | 0) == 0)) {\n                            i = 7;\n                            break c;\n                          }\n\n                          if (i >>> 0 < j >>> 0) { i = i + 1 | 0; }else {\n                            i = 6;\n                            break;\n                          }\n                        }\n                      } } while (0);\n\n                      if ((k + 2 | 0) >>> 0 > i >>> 0) {\n                        y = 51;\n                        break a;\n                      }\n\n                      q = dd(m | 0, 0, 56) | 0;\n                      a = G() | 0 | a & -117440513;\n                      i = g;\n                      b[i >> 2] = 0;\n                      b[i + 4 >> 2] = 0;\n                      i = o;\n                      d = q | d;\n                    } else { i = (o + 1 | 0) % (e | 0) | 0; }\n\n                    g = v + (i << 3) | 0;\n                    n = g;\n                    j = b[n >> 2] | 0;\n                    n = b[n + 4 >> 2] | 0;\n                    if ((j | 0) == 0 & (n | 0) == 0) { break; }else {\n                      p = p + 1 | 0;\n                      o = i;\n                    }\n                  }\n                }\n                q = g;\n                b[q >> 2] = d;\n                b[q + 4 >> 2] = a;\n              }\n\n              f = f + 1 | 0;\n              if ((f | 0) >= (e | 0)) { break b; }\n              d = x + (f << 3) | 0;\n              a = b[d >> 2] | 0;\n              d = b[d + 4 >> 2] | 0;\n            }\n          }\n\n          f = 0;\n          a = l;\n          d = h;\n\n          while (1) {\n            if (!((a | 0) == 0 & (d | 0) == 0)) {\n              i = cd(a | 0, d | 0, 52) | 0;\n              G() | 0;\n              i = i & 15;\n\n              if ((i | 0) >= (u | 0)) {\n                if ((i | 0) != (u | 0)) {\n                  a = a | p;\n                  d = d & -15728641 | q;\n\n                  if (i >>> 0 >= t >>> 0) {\n                    g = u;\n\n                    do {\n                      o = dd(7, 0, (14 - g | 0) * 3 | 0) | 0;\n                      g = g + 1 | 0;\n                      a = o | a;\n                      d = G() | 0 | d;\n                    } while (g >>> 0 < i >>> 0);\n                  }\n                }\n              } else {\n                a = 0;\n                d = 0;\n              }\n\n              i = bd(a | 0, d | 0, e | 0, r | 0) | 0;\n              G() | 0;\n              g = v + (i << 3) | 0;\n              j = g;\n              k = b[j >> 2] | 0;\n              j = b[j + 4 >> 2] | 0;\n\n              if (!((k | 0) == 0 & (j | 0) == 0)) {\n                o = 0;\n\n                while (1) {\n                  if ((o | 0) > (e | 0)) {\n                    y = 41;\n                    break a;\n                  }\n\n                  if ((k | 0) == (a | 0) & (j & -117440513 | 0) == (d | 0)) {\n                    m = cd(k | 0, j | 0, 56) | 0;\n                    G() | 0;\n                    m = m & 7;\n                    n = m + 1 | 0;\n                    z = cd(k | 0, j | 0, 45) | 0;\n                    G() | 0;\n\n                    d: do { if (!(la(z & 127) | 0)) { j = 7; }else {\n                      k = cd(k | 0, j | 0, 52) | 0;\n                      G() | 0;\n                      k = k & 15;\n\n                      if (!k) {\n                        j = 6;\n                        break;\n                      }\n\n                      j = 1;\n\n                      while (1) {\n                        z = dd(7, 0, (15 - j | 0) * 3 | 0) | 0;\n\n                        if (!((z & a | 0) == 0 & ((G() | 0) & d | 0) == 0)) {\n                          j = 7;\n                          break d;\n                        }\n\n                        if (j >>> 0 < k >>> 0) { j = j + 1 | 0; }else {\n                          j = 6;\n                          break;\n                        }\n                      }\n                    } } while (0);\n\n                    if ((m + 2 | 0) >>> 0 > j >>> 0) {\n                      y = 51;\n                      break a;\n                    }\n\n                    z = dd(n | 0, 0, 56) | 0;\n                    d = G() | 0 | d & -117440513;\n                    n = g;\n                    b[n >> 2] = 0;\n                    b[n + 4 >> 2] = 0;\n                    a = z | a;\n                  } else { i = (i + 1 | 0) % (e | 0) | 0; }\n\n                  g = v + (i << 3) | 0;\n                  j = g;\n                  k = b[j >> 2] | 0;\n                  j = b[j + 4 >> 2] | 0;\n                  if ((k | 0) == 0 & (j | 0) == 0) { break; }else { o = o + 1 | 0; }\n                }\n              }\n\n              z = g;\n              b[z >> 2] = a;\n              b[z + 4 >> 2] = d;\n            }\n\n            f = f + 1 | 0;\n            if ((f | 0) >= (e | 0)) { break b; }\n            d = x + (f << 3) | 0;\n            a = b[d >> 2] | 0;\n            d = b[d + 4 >> 2] | 0;\n          }\n        } } while (0);\n\n        if ((e + 5 | 0) >>> 0 < 11) {\n          y = 99;\n          break;\n        }\n\n        q = Yc((e | 0) / 6 | 0, 8) | 0;\n\n        if (!q) {\n          y = 58;\n          break;\n        }\n\n        e: do { if (s) {\n          o = 0;\n          n = 0;\n\n          do {\n            i = v + (o << 3) | 0;\n            a = i;\n            f = b[a >> 2] | 0;\n            a = b[a + 4 >> 2] | 0;\n\n            if (!((f | 0) == 0 & (a | 0) == 0)) {\n              j = cd(f | 0, a | 0, 56) | 0;\n              G() | 0;\n              j = j & 7;\n              d = j + 1 | 0;\n              k = a & -117440513;\n              z = cd(f | 0, a | 0, 45) | 0;\n              G() | 0;\n\n              f: do { if (la(z & 127) | 0) {\n                m = cd(f | 0, a | 0, 52) | 0;\n                G() | 0;\n                m = m & 15;\n\n                if (m | 0) {\n                  g = 1;\n\n                  while (1) {\n                    z = dd(7, 0, (15 - g | 0) * 3 | 0) | 0;\n                    if (!((f & z | 0) == 0 & (k & (G() | 0) | 0) == 0)) { break f; }\n                    if (g >>> 0 < m >>> 0) { g = g + 1 | 0; }else { break; }\n                  }\n                }\n\n                a = dd(d | 0, 0, 56) | 0;\n                f = a | f;\n                a = G() | 0 | k;\n                d = i;\n                b[d >> 2] = f;\n                b[d + 4 >> 2] = a;\n                d = j + 2 | 0;\n              } } while (0);\n\n              if ((d | 0) == 7) {\n                z = q + (n << 3) | 0;\n                b[z >> 2] = f;\n                b[z + 4 >> 2] = a & -117440513;\n                n = n + 1 | 0;\n              }\n            }\n\n            o = o + 1 | 0;\n          } while ((o | 0) != (e | 0));\n\n          if (s) {\n            p = ((e | 0) < 0) << 31 >> 31;\n            m = dd(u | 0, 0, 52) | 0;\n            o = G() | 0;\n\n            if (u >>> 0 > 15) {\n              a = 0;\n              f = 0;\n\n              while (1) {\n                do { if (!((l | 0) == 0 & (h | 0) == 0)) {\n                  j = cd(l | 0, h | 0, 52) | 0;\n                  G() | 0;\n                  j = j & 15;\n                  g = (j | 0) < (u | 0);\n                  j = (j | 0) == (u | 0);\n                  i = g ? 0 : j ? l : 0;\n                  j = g ? 0 : j ? h : 0;\n                  g = bd(i | 0, j | 0, e | 0, p | 0) | 0;\n                  G() | 0;\n                  d = 0;\n\n                  while (1) {\n                    if ((d | 0) > (e | 0)) {\n                      y = 98;\n                      break a;\n                    }\n\n                    z = v + (g << 3) | 0;\n                    k = b[z + 4 >> 2] | 0;\n\n                    if ((k & -117440513 | 0) == (j | 0) ? (b[z >> 2] | 0) == (i | 0) : 0) {\n                      y = 70;\n                      break;\n                    }\n\n                    g = (g + 1 | 0) % (e | 0) | 0;\n                    z = v + (g << 3) | 0;\n                    if ((b[z >> 2] | 0) == (i | 0) ? (b[z + 4 >> 2] | 0) == (j | 0) : 0) { break; }else { d = d + 1 | 0; }\n                  }\n\n                  if ((y | 0) == 70 ? (y = 0, 0 == 0 & (k & 117440512 | 0) == 100663296) : 0) { break; }\n                  z = c + (f << 3) | 0;\n                  b[z >> 2] = l;\n                  b[z + 4 >> 2] = h;\n                  f = f + 1 | 0;\n                } } while (0);\n\n                a = a + 1 | 0;\n\n                if ((a | 0) >= (e | 0)) {\n                  e = n;\n                  break e;\n                }\n\n                h = x + (a << 3) | 0;\n                l = b[h >> 2] | 0;\n                h = b[h + 4 >> 2] | 0;\n              }\n            }\n\n            a = 0;\n            f = 0;\n\n            while (1) {\n              do { if (!((l | 0) == 0 & (h | 0) == 0)) {\n                j = cd(l | 0, h | 0, 52) | 0;\n                G() | 0;\n                j = j & 15;\n                if ((j | 0) >= (u | 0)) {\n                  if ((j | 0) != (u | 0)) {\n                    d = l | m;\n                    g = h & -15728641 | o;\n                    if (j >>> 0 < t >>> 0) { j = g; }else {\n                      i = u;\n\n                      do {\n                        z = dd(7, 0, (14 - i | 0) * 3 | 0) | 0;\n                        i = i + 1 | 0;\n                        d = z | d;\n                        g = G() | 0 | g;\n                      } while (i >>> 0 < j >>> 0);\n\n                      j = g;\n                    }\n                  } else {\n                    d = l;\n                    j = h;\n                  }\n                } else {\n                  d = 0;\n                  j = 0;\n                }\n                i = bd(d | 0, j | 0, e | 0, p | 0) | 0;\n                G() | 0;\n                g = 0;\n\n                while (1) {\n                  if ((g | 0) > (e | 0)) {\n                    y = 98;\n                    break a;\n                  }\n\n                  z = v + (i << 3) | 0;\n                  k = b[z + 4 >> 2] | 0;\n\n                  if ((k & -117440513 | 0) == (j | 0) ? (b[z >> 2] | 0) == (d | 0) : 0) {\n                    y = 93;\n                    break;\n                  }\n\n                  i = (i + 1 | 0) % (e | 0) | 0;\n                  z = v + (i << 3) | 0;\n                  if ((b[z >> 2] | 0) == (d | 0) ? (b[z + 4 >> 2] | 0) == (j | 0) : 0) { break; }else { g = g + 1 | 0; }\n                }\n\n                if ((y | 0) == 93 ? (y = 0, 0 == 0 & (k & 117440512 | 0) == 100663296) : 0) { break; }\n                z = c + (f << 3) | 0;\n                b[z >> 2] = l;\n                b[z + 4 >> 2] = h;\n                f = f + 1 | 0;\n              } } while (0);\n\n              a = a + 1 | 0;\n\n              if ((a | 0) >= (e | 0)) {\n                e = n;\n                break e;\n              }\n\n              h = x + (a << 3) | 0;\n              l = b[h >> 2] | 0;\n              h = b[h + 4 >> 2] | 0;\n            }\n          } else {\n            f = 0;\n            e = n;\n          }\n        } else {\n          f = 0;\n          e = 0;\n        } } while (0);\n\n        hd(v | 0, 0, w | 0) | 0;\n        gd(x | 0, q | 0, e << 3 | 0) | 0;\n        Xc(q);\n        if (!e) { break; }else { c = c + (f << 3) | 0; }\n      }\n\n      if ((y | 0) == 41) {\n        Xc(x);\n        Xc(v);\n        z = -1;\n        return z | 0;\n      } else if ((y | 0) == 51) {\n        Xc(x);\n        Xc(v);\n        z = -2;\n        return z | 0;\n      } else if ((y | 0) == 58) {\n        Xc(x);\n        Xc(v);\n        z = -3;\n        return z | 0;\n      } else if ((y | 0) == 98) {\n        Xc(q);\n        Xc(x);\n        Xc(v);\n        z = -1;\n        return z | 0;\n      } else if ((y | 0) == 99) { gd(c | 0, x | 0, e << 3 | 0) | 0; }\n\n      Xc(x);\n      Xc(v);\n      z = 0;\n      return z | 0;\n    }\n\n    function Ib(a, c, d, e, f) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      f = f | 0;\n      var g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0;\n\n      if ((c | 0) <= 0) {\n        f = 0;\n        return f | 0;\n      }\n\n      if ((f | 0) >= 16) {\n        g = 0;\n\n        while (1) {\n          l = a + (g << 3) | 0;\n\n          if (!((b[l >> 2] | 0) == 0 & (b[l + 4 >> 2] | 0) == 0)) {\n            g = 14;\n            break;\n          }\n\n          g = g + 1 | 0;\n\n          if ((g | 0) >= (c | 0)) {\n            h = 0;\n            g = 16;\n            break;\n          }\n        }\n\n        if ((g | 0) == 14) { return ((e | 0) > 0 ? -2 : -1) | 0; }else if ((g | 0) == 16) { return h | 0; }\n      }\n\n      g = 0;\n      l = 0;\n\n      a: while (1) {\n        k = a + (l << 3) | 0;\n        i = k;\n        h = b[i >> 2] | 0;\n        i = b[i + 4 >> 2] | 0;\n\n        do { if (!((h | 0) == 0 & (i | 0) == 0)) {\n          if ((g | 0) >= (e | 0)) {\n            h = -1;\n            g = 16;\n            break a;\n          }\n\n          j = cd(h | 0, i | 0, 52) | 0;\n          G() | 0;\n          j = j & 15;\n\n          if ((j | 0) > (f | 0)) {\n            h = -2;\n            g = 16;\n            break a;\n          }\n\n          if ((j | 0) == (f | 0)) {\n            k = d + (g << 3) | 0;\n            b[k >> 2] = h;\n            b[k + 4 >> 2] = i;\n            g = g + 1 | 0;\n            break;\n          }\n\n          h = (tc(7, f - j | 0) | 0) + g | 0;\n\n          if ((h | 0) > (e | 0)) {\n            h = -1;\n            g = 16;\n            break a;\n          }\n\n          Eb(b[k >> 2] | 0, b[k + 4 >> 2] | 0, f, d + (g << 3) | 0);\n          g = h;\n        } } while (0);\n\n        l = l + 1 | 0;\n\n        if ((l | 0) >= (c | 0)) {\n          h = 0;\n          g = 16;\n          break;\n        }\n      }\n\n      if ((g | 0) == 16) { return h | 0; }\n      return 0;\n    }\n\n    function Jb(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0;\n\n      if ((c | 0) <= 0) {\n        d = 0;\n        return d | 0;\n      }\n\n      if ((d | 0) >= 16) {\n        e = 0;\n\n        while (1) {\n          h = a + (e << 3) | 0;\n\n          if (!((b[h >> 2] | 0) == 0 & (b[h + 4 >> 2] | 0) == 0)) {\n            e = -1;\n            f = 13;\n            break;\n          }\n\n          e = e + 1 | 0;\n\n          if ((e | 0) >= (c | 0)) {\n            e = 0;\n            f = 13;\n            break;\n          }\n        }\n\n        if ((f | 0) == 13) { return e | 0; }\n      }\n\n      e = 0;\n      h = 0;\n\n      a: while (1) {\n        f = a + (h << 3) | 0;\n        g = b[f >> 2] | 0;\n        f = b[f + 4 >> 2] | 0;\n\n        do { if (!((g | 0) == 0 & (f | 0) == 0)) {\n          f = cd(g | 0, f | 0, 52) | 0;\n          G() | 0;\n          f = f & 15;\n\n          if ((f | 0) > (d | 0)) {\n            e = -1;\n            f = 13;\n            break a;\n          }\n\n          if ((f | 0) == (d | 0)) {\n            e = e + 1 | 0;\n            break;\n          } else {\n            e = (tc(7, d - f | 0) | 0) + e | 0;\n            break;\n          }\n        } } while (0);\n\n        h = h + 1 | 0;\n\n        if ((h | 0) >= (c | 0)) {\n          f = 13;\n          break;\n        }\n      }\n\n      if ((f | 0) == 13) { return e | 0; }\n      return 0;\n    }\n\n    function Kb(a, b) {\n      a = a | 0;\n      b = b | 0;\n      b = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      return b & 1 | 0;\n    }\n\n    function Lb(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0,\n          d = 0,\n          e = 0;\n      e = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      e = e & 15;\n\n      if (!e) {\n        e = 0;\n        return e | 0;\n      }\n\n      d = 1;\n\n      while (1) {\n        c = cd(a | 0, b | 0, (15 - d | 0) * 3 | 0) | 0;\n        G() | 0;\n        c = c & 7;\n\n        if (c | 0) {\n          d = 5;\n          break;\n        }\n\n        if (d >>> 0 < e >>> 0) { d = d + 1 | 0; }else {\n          c = 0;\n          d = 5;\n          break;\n        }\n      }\n\n      if ((d | 0) == 5) { return c | 0; }\n      return 0;\n    }\n\n    function Mb(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      i = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      i = i & 15;\n\n      if (!i) {\n        h = b;\n        i = a;\n        F(h | 0);\n        return i | 0;\n      }\n\n      h = 1;\n      c = 0;\n\n      while (1) {\n        f = (15 - h | 0) * 3 | 0;\n        d = dd(7, 0, f | 0) | 0;\n        e = G() | 0;\n        g = cd(a | 0, b | 0, f | 0) | 0;\n        G() | 0;\n        f = dd(Pa(g & 7) | 0, 0, f | 0) | 0;\n        g = G() | 0;\n        a = f | a & ~d;\n        b = g | b & ~e;\n\n        a: do { if (!c) { if (!((f & d | 0) == 0 & (g & e | 0) == 0)) {\n          d = cd(a | 0, b | 0, 52) | 0;\n          G() | 0;\n          d = d & 15;\n          if (!d) { c = 1; }else {\n            c = 1;\n\n            b: while (1) {\n              g = cd(a | 0, b | 0, (15 - c | 0) * 3 | 0) | 0;\n              G() | 0;\n\n              switch (g & 7) {\n                case 1:\n                  break b;\n\n                case 0:\n                  break;\n\n                default:\n                  {\n                    c = 1;\n                    break a;\n                  }\n              }\n\n              if (c >>> 0 < d >>> 0) { c = c + 1 | 0; }else {\n                c = 1;\n                break a;\n              }\n            }\n\n            c = 1;\n\n            while (1) {\n              g = (15 - c | 0) * 3 | 0;\n              e = cd(a | 0, b | 0, g | 0) | 0;\n              G() | 0;\n              f = dd(7, 0, g | 0) | 0;\n              b = b & ~(G() | 0);\n              g = dd(Pa(e & 7) | 0, 0, g | 0) | 0;\n              a = a & ~f | g;\n              b = b | (G() | 0);\n              if (c >>> 0 < d >>> 0) { c = c + 1 | 0; }else {\n                c = 1;\n                break;\n              }\n            }\n          }\n        } else { c = 0; } } } while (0);\n\n        if (h >>> 0 < i >>> 0) { h = h + 1 | 0; }else { break; }\n      }\n\n      F(b | 0);\n      return a | 0;\n    }\n\n    function Nb(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0;\n      d = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      d = d & 15;\n\n      if (!d) {\n        c = b;\n        d = a;\n        F(c | 0);\n        return d | 0;\n      }\n\n      c = 1;\n\n      while (1) {\n        f = (15 - c | 0) * 3 | 0;\n        g = cd(a | 0, b | 0, f | 0) | 0;\n        G() | 0;\n        e = dd(7, 0, f | 0) | 0;\n        b = b & ~(G() | 0);\n        f = dd(Pa(g & 7) | 0, 0, f | 0) | 0;\n        a = f | a & ~e;\n        b = G() | 0 | b;\n        if (c >>> 0 < d >>> 0) { c = c + 1 | 0; }else { break; }\n      }\n\n      F(b | 0);\n      return a | 0;\n    }\n\n    function Ob(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      i = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      i = i & 15;\n\n      if (!i) {\n        h = b;\n        i = a;\n        F(h | 0);\n        return i | 0;\n      }\n\n      h = 1;\n      c = 0;\n\n      while (1) {\n        f = (15 - h | 0) * 3 | 0;\n        d = dd(7, 0, f | 0) | 0;\n        e = G() | 0;\n        g = cd(a | 0, b | 0, f | 0) | 0;\n        G() | 0;\n        f = dd(Qa(g & 7) | 0, 0, f | 0) | 0;\n        g = G() | 0;\n        a = f | a & ~d;\n        b = g | b & ~e;\n\n        a: do { if (!c) { if (!((f & d | 0) == 0 & (g & e | 0) == 0)) {\n          d = cd(a | 0, b | 0, 52) | 0;\n          G() | 0;\n          d = d & 15;\n          if (!d) { c = 1; }else {\n            c = 1;\n\n            b: while (1) {\n              g = cd(a | 0, b | 0, (15 - c | 0) * 3 | 0) | 0;\n              G() | 0;\n\n              switch (g & 7) {\n                case 1:\n                  break b;\n\n                case 0:\n                  break;\n\n                default:\n                  {\n                    c = 1;\n                    break a;\n                  }\n              }\n\n              if (c >>> 0 < d >>> 0) { c = c + 1 | 0; }else {\n                c = 1;\n                break a;\n              }\n            }\n\n            c = 1;\n\n            while (1) {\n              e = (15 - c | 0) * 3 | 0;\n              f = dd(7, 0, e | 0) | 0;\n              g = b & ~(G() | 0);\n              b = cd(a | 0, b | 0, e | 0) | 0;\n              G() | 0;\n              b = dd(Qa(b & 7) | 0, 0, e | 0) | 0;\n              a = a & ~f | b;\n              b = g | (G() | 0);\n              if (c >>> 0 < d >>> 0) { c = c + 1 | 0; }else {\n                c = 1;\n                break;\n              }\n            }\n          }\n        } else { c = 0; } } } while (0);\n\n        if (h >>> 0 < i >>> 0) { h = h + 1 | 0; }else { break; }\n      }\n\n      F(b | 0);\n      return a | 0;\n    }\n\n    function Pb(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0;\n      d = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      d = d & 15;\n\n      if (!d) {\n        c = b;\n        d = a;\n        F(c | 0);\n        return d | 0;\n      }\n\n      c = 1;\n\n      while (1) {\n        g = (15 - c | 0) * 3 | 0;\n        f = dd(7, 0, g | 0) | 0;\n        e = b & ~(G() | 0);\n        b = cd(a | 0, b | 0, g | 0) | 0;\n        G() | 0;\n        b = dd(Qa(b & 7) | 0, 0, g | 0) | 0;\n        a = b | a & ~f;\n        b = G() | 0 | e;\n        if (c >>> 0 < d >>> 0) { c = c + 1 | 0; }else { break; }\n      }\n\n      F(b | 0);\n      return a | 0;\n    }\n\n    function Qb(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0;\n      j = S;\n      S = S + 64 | 0;\n      i = j + 40 | 0;\n      e = j + 24 | 0;\n      f = j + 12 | 0;\n      g = j;\n      dd(c | 0, 0, 52) | 0;\n      d = G() | 0 | 134225919;\n\n      if (!c) {\n        if ((b[a + 4 >> 2] | 0) > 2) {\n          h = 0;\n          i = 0;\n          F(h | 0);\n          S = j;\n          return i | 0;\n        }\n\n        if ((b[a + 8 >> 2] | 0) > 2) {\n          h = 0;\n          i = 0;\n          F(h | 0);\n          S = j;\n          return i | 0;\n        }\n\n        if ((b[a + 12 >> 2] | 0) > 2) {\n          h = 0;\n          i = 0;\n          F(h | 0);\n          S = j;\n          return i | 0;\n        }\n\n        dd(na(a) | 0, 0, 45) | 0;\n        h = G() | 0 | d;\n        i = -1;\n        F(h | 0);\n        S = j;\n        return i | 0;\n      }\n      b[i >> 2] = b[a >> 2];\n      b[i + 4 >> 2] = b[a + 4 >> 2];\n      b[i + 8 >> 2] = b[a + 8 >> 2];\n      b[i + 12 >> 2] = b[a + 12 >> 2];\n      h = i + 4 | 0;\n\n      if ((c | 0) > 0) {\n        a = -1;\n\n        while (1) {\n          b[e >> 2] = b[h >> 2];\n          b[e + 4 >> 2] = b[h + 4 >> 2];\n          b[e + 8 >> 2] = b[h + 8 >> 2];\n\n          if (!(c & 1)) {\n            Ja(h);\n            b[f >> 2] = b[h >> 2];\n            b[f + 4 >> 2] = b[h + 4 >> 2];\n            b[f + 8 >> 2] = b[h + 8 >> 2];\n            La(f);\n          } else {\n            Ia(h);\n            b[f >> 2] = b[h >> 2];\n            b[f + 4 >> 2] = b[h + 4 >> 2];\n            b[f + 8 >> 2] = b[h + 8 >> 2];\n            Ka(f);\n          }\n\n          Fa(e, f, g);\n          Ca(g);\n          l = (15 - c | 0) * 3 | 0;\n          k = dd(7, 0, l | 0) | 0;\n          d = d & ~(G() | 0);\n          l = dd(Ha(g) | 0, 0, l | 0) | 0;\n          a = l | a & ~k;\n          d = G() | 0 | d;\n          if ((c | 0) > 1) { c = c + -1 | 0; }else { break; }\n        }\n      } else { a = -1; }\n\n      a: do { if (((b[h >> 2] | 0) <= 2 ? (b[i + 8 >> 2] | 0) <= 2 : 0) ? (b[i + 12 >> 2] | 0) <= 2 : 0) {\n        e = na(i) | 0;\n        c = dd(e | 0, 0, 45) | 0;\n        c = c | a;\n        a = G() | 0 | d & -1040385;\n        g = oa(i) | 0;\n\n        if (!(la(e) | 0)) {\n          if ((g | 0) <= 0) { break; }\n          f = 0;\n\n          while (1) {\n            e = cd(c | 0, a | 0, 52) | 0;\n            G() | 0;\n            e = e & 15;\n\n            if (e) {\n              d = 1;\n\n              while (1) {\n                l = (15 - d | 0) * 3 | 0;\n                i = cd(c | 0, a | 0, l | 0) | 0;\n                G() | 0;\n                k = dd(7, 0, l | 0) | 0;\n                a = a & ~(G() | 0);\n                l = dd(Pa(i & 7) | 0, 0, l | 0) | 0;\n                c = c & ~k | l;\n                a = a | (G() | 0);\n                if (d >>> 0 < e >>> 0) { d = d + 1 | 0; }else { break; }\n              }\n            }\n\n            f = f + 1 | 0;\n            if ((f | 0) == (g | 0)) { break a; }\n          }\n        }\n\n        f = cd(c | 0, a | 0, 52) | 0;\n        G() | 0;\n        f = f & 15;\n\n        b: do { if (f) {\n          d = 1;\n\n          c: while (1) {\n            l = cd(c | 0, a | 0, (15 - d | 0) * 3 | 0) | 0;\n            G() | 0;\n\n            switch (l & 7) {\n              case 1:\n                break c;\n\n              case 0:\n                break;\n\n              default:\n                break b;\n            }\n\n            if (d >>> 0 < f >>> 0) { d = d + 1 | 0; }else { break b; }\n          }\n\n          if (ra(e, b[i >> 2] | 0) | 0) {\n            d = 1;\n\n            while (1) {\n              i = (15 - d | 0) * 3 | 0;\n              k = dd(7, 0, i | 0) | 0;\n              l = a & ~(G() | 0);\n              a = cd(c | 0, a | 0, i | 0) | 0;\n              G() | 0;\n              a = dd(Qa(a & 7) | 0, 0, i | 0) | 0;\n              c = c & ~k | a;\n              a = l | (G() | 0);\n              if (d >>> 0 < f >>> 0) { d = d + 1 | 0; }else { break; }\n            }\n          } else {\n            d = 1;\n\n            while (1) {\n              l = (15 - d | 0) * 3 | 0;\n              i = cd(c | 0, a | 0, l | 0) | 0;\n              G() | 0;\n              k = dd(7, 0, l | 0) | 0;\n              a = a & ~(G() | 0);\n              l = dd(Pa(i & 7) | 0, 0, l | 0) | 0;\n              c = c & ~k | l;\n              a = a | (G() | 0);\n              if (d >>> 0 < f >>> 0) { d = d + 1 | 0; }else { break; }\n            }\n          }\n        } } while (0);\n\n        if ((g | 0) > 0) {\n          d = 0;\n\n          do {\n            c = Mb(c, a) | 0;\n            a = G() | 0;\n            d = d + 1 | 0;\n          } while ((d | 0) != (g | 0));\n        }\n      } else {\n        c = 0;\n        a = 0;\n      } } while (0);\n\n      k = a;\n      l = c;\n      F(k | 0);\n      S = j;\n      return l | 0;\n    }\n\n    function Rb(a) {\n      a = a | 0;\n      return (a | 0) % 2 | 0 | 0;\n    }\n\n    function Sb(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0;\n      e = S;\n      S = S + 16 | 0;\n      d = e;\n\n      if ((c >>> 0 <= 15 ? !((b[a + 4 >> 2] & 2146435072 | 0) == 2146435072) : 0) ? !((b[a + 8 + 4 >> 2] & 2146435072 | 0) == 2146435072) : 0) {\n        Ya(a, c, d);\n        c = Qb(d, c) | 0;\n        a = G() | 0;\n      } else {\n        a = 0;\n        c = 0;\n      }\n\n      F(a | 0);\n      S = e;\n      return c | 0;\n    }\n\n    function Tb(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0;\n      f = d + 4 | 0;\n      g = cd(a | 0, c | 0, 52) | 0;\n      G() | 0;\n      g = g & 15;\n      h = cd(a | 0, c | 0, 45) | 0;\n      G() | 0;\n      e = (g | 0) == 0;\n\n      if (!(la(h & 127) | 0)) {\n        if (e) {\n          h = 0;\n          return h | 0;\n        }\n\n        if ((b[f >> 2] | 0) == 0 ? (b[d + 8 >> 2] | 0) == 0 : 0) { e = (b[d + 12 >> 2] | 0) != 0 & 1; }else { e = 1; }\n      } else if (e) {\n        h = 1;\n        return h | 0;\n      } else { e = 1; }\n\n      d = 1;\n\n      while (1) {\n        if (!(d & 1)) { La(f); }else { Ka(f); }\n        h = cd(a | 0, c | 0, (15 - d | 0) * 3 | 0) | 0;\n        G() | 0;\n        Ma(f, h & 7);\n        if (d >>> 0 < g >>> 0) { d = d + 1 | 0; }else { break; }\n      }\n\n      return e | 0;\n    }\n\n    function Ub(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0;\n      l = S;\n      S = S + 16 | 0;\n      j = l;\n      k = cd(a | 0, c | 0, 45) | 0;\n      G() | 0;\n      k = k & 127;\n\n      a: do { if ((la(k) | 0) != 0 ? (g = cd(a | 0, c | 0, 52) | 0, G() | 0, g = g & 15, (g | 0) != 0) : 0) {\n        e = 1;\n\n        b: while (1) {\n          i = cd(a | 0, c | 0, (15 - e | 0) * 3 | 0) | 0;\n          G() | 0;\n\n          switch (i & 7) {\n            case 5:\n              break b;\n\n            case 0:\n              break;\n\n            default:\n              {\n                e = c;\n                break a;\n              }\n          }\n\n          if (e >>> 0 < g >>> 0) { e = e + 1 | 0; }else {\n            e = c;\n            break a;\n          }\n        }\n\n        f = 1;\n        e = c;\n\n        while (1) {\n          c = (15 - f | 0) * 3 | 0;\n          h = dd(7, 0, c | 0) | 0;\n          i = e & ~(G() | 0);\n          e = cd(a | 0, e | 0, c | 0) | 0;\n          G() | 0;\n          e = dd(Qa(e & 7) | 0, 0, c | 0) | 0;\n          a = a & ~h | e;\n          e = i | (G() | 0);\n          if (f >>> 0 < g >>> 0) { f = f + 1 | 0; }else { break; }\n        }\n      } else { e = c; } } while (0);\n\n      i = 7728 + (k * 28 | 0) | 0;\n      b[d >> 2] = b[i >> 2];\n      b[d + 4 >> 2] = b[i + 4 >> 2];\n      b[d + 8 >> 2] = b[i + 8 >> 2];\n      b[d + 12 >> 2] = b[i + 12 >> 2];\n\n      if (!(Tb(a, e, d) | 0)) {\n        S = l;\n        return;\n      }\n\n      h = d + 4 | 0;\n      b[j >> 2] = b[h >> 2];\n      b[j + 4 >> 2] = b[h + 4 >> 2];\n      b[j + 8 >> 2] = b[h + 8 >> 2];\n      g = cd(a | 0, e | 0, 52) | 0;\n      G() | 0;\n      i = g & 15;\n      if (!(g & 1)) { g = i; }else {\n        La(h);\n        g = i + 1 | 0;\n      }\n      if (!(la(k) | 0)) { e = 0; }else {\n        c: do { if (!i) { e = 0; }else {\n          c = 1;\n\n          while (1) {\n            f = cd(a | 0, e | 0, (15 - c | 0) * 3 | 0) | 0;\n            G() | 0;\n            f = f & 7;\n\n            if (f | 0) {\n              e = f;\n              break c;\n            }\n\n            if (c >>> 0 < i >>> 0) { c = c + 1 | 0; }else {\n              e = 0;\n              break;\n            }\n          }\n        } } while (0);\n\n        e = (e | 0) == 4 & 1;\n      }\n\n      if (!(cb(d, g, e, 0) | 0)) {\n        if ((g | 0) != (i | 0)) {\n          b[h >> 2] = b[j >> 2];\n          b[h + 4 >> 2] = b[j + 4 >> 2];\n          b[h + 8 >> 2] = b[j + 8 >> 2];\n        }\n      } else {\n        if (la(k) | 0) { do {} while ((cb(d, g, 0, 0) | 0) != 0); }\n        if ((g | 0) != (i | 0)) { Ja(h); }\n      }\n\n      S = l;\n      return;\n    }\n\n    function Vb(a, b, c) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0;\n      d = S;\n      S = S + 16 | 0;\n      e = d;\n      Ub(a, b, e);\n      b = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      $a(e, b & 15, c);\n      S = d;\n      return;\n    }\n\n    function Wb(a, b, c) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0;\n      g = S;\n      S = S + 16 | 0;\n      f = g;\n      Ub(a, b, f);\n      d = cd(a | 0, b | 0, 45) | 0;\n      G() | 0;\n      d = (la(d & 127) | 0) == 0;\n      e = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      e = e & 15;\n\n      a: do { if (!d) {\n        if (e | 0) {\n          d = 1;\n\n          while (1) {\n            h = dd(7, 0, (15 - d | 0) * 3 | 0) | 0;\n            if (!((h & a | 0) == 0 & ((G() | 0) & b | 0) == 0)) { break a; }\n            if (d >>> 0 < e >>> 0) { d = d + 1 | 0; }else { break; }\n          }\n        }\n\n        ab(f, e, 0, 5, c);\n        S = g;\n        return;\n      } } while (0);\n\n      eb(f, e, 0, 6, c);\n      S = g;\n      return;\n    }\n\n    function Xb(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0,\n          d = 0,\n          e = 0;\n      d = cd(a | 0, b | 0, 45) | 0;\n      G() | 0;\n\n      if (!(la(d & 127) | 0)) {\n        d = 2;\n        return d | 0;\n      }\n\n      d = cd(a | 0, b | 0, 52) | 0;\n      G() | 0;\n      d = d & 15;\n\n      if (!d) {\n        d = 5;\n        return d | 0;\n      }\n\n      c = 1;\n\n      while (1) {\n        e = dd(7, 0, (15 - c | 0) * 3 | 0) | 0;\n\n        if (!((e & a | 0) == 0 & ((G() | 0) & b | 0) == 0)) {\n          c = 2;\n          a = 6;\n          break;\n        }\n\n        if (c >>> 0 < d >>> 0) { c = c + 1 | 0; }else {\n          c = 5;\n          a = 6;\n          break;\n        }\n      }\n\n      if ((a | 0) == 6) { return c | 0; }\n      return 0;\n    }\n\n    function Yb(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0;\n      m = S;\n      S = S + 128 | 0;\n      k = m + 112 | 0;\n      g = m + 96 | 0;\n      l = m;\n      f = cd(a | 0, c | 0, 52) | 0;\n      G() | 0;\n      i = f & 15;\n      b[k >> 2] = i;\n      h = cd(a | 0, c | 0, 45) | 0;\n      G() | 0;\n      h = h & 127;\n\n      a: do { if (la(h) | 0) {\n        if (i | 0) {\n          e = 1;\n\n          while (1) {\n            j = dd(7, 0, (15 - e | 0) * 3 | 0) | 0;\n\n            if (!((j & a | 0) == 0 & ((G() | 0) & c | 0) == 0)) {\n              f = 0;\n              break a;\n            }\n\n            if (e >>> 0 < i >>> 0) { e = e + 1 | 0; }else { break; }\n          }\n        }\n\n        if (!(f & 1)) {\n          j = dd(i + 1 | 0, 0, 52) | 0;\n          l = G() | 0 | c & -15728641;\n          k = dd(7, 0, (14 - i | 0) * 3 | 0) | 0;\n          Yb((j | a) & ~k, l & ~(G() | 0), d);\n          S = m;\n          return;\n        } else { f = 1; }\n      } else { f = 0; } } while (0);\n\n      Ub(a, c, g);\n\n      if (f) {\n        bb(g, k, l);\n        j = 5;\n      } else {\n        fb(g, k, l);\n        j = 6;\n      }\n\n      b: do { if (la(h) | 0) {\n        if (!i) { e = 20; }else {\n          e = 1;\n\n          while (1) {\n            h = dd(7, 0, (15 - e | 0) * 3 | 0) | 0;\n\n            if (!((h & a | 0) == 0 & ((G() | 0) & c | 0) == 0)) {\n              e = 8;\n              break b;\n            }\n\n            if (e >>> 0 < i >>> 0) { e = e + 1 | 0; }else {\n              e = 20;\n              break;\n            }\n          }\n        }\n      } else { e = 8; } } while (0);\n\n      hd(d | 0, -1, e | 0) | 0;\n\n      if (f) {\n        f = 0;\n\n        do {\n          g = l + (f << 4) | 0;\n          db(g, b[k >> 2] | 0) | 0;\n          g = b[g >> 2] | 0;\n          e = 0;\n\n          while (1) {\n            h = d + (e << 2) | 0;\n            i = b[h >> 2] | 0;\n            if ((i | 0) == -1 | (i | 0) == (g | 0)) { break; }else { e = e + 1 | 0; }\n          }\n\n          b[h >> 2] = g;\n          f = f + 1 | 0;\n        } while ((f | 0) != (j | 0));\n      } else {\n        f = 0;\n\n        do {\n          g = l + (f << 4) | 0;\n          cb(g, b[k >> 2] | 0, 0, 1) | 0;\n          g = b[g >> 2] | 0;\n          e = 0;\n\n          while (1) {\n            h = d + (e << 2) | 0;\n            i = b[h >> 2] | 0;\n            if ((i | 0) == -1 | (i | 0) == (g | 0)) { break; }else { e = e + 1 | 0; }\n          }\n\n          b[h >> 2] = g;\n          f = f + 1 | 0;\n        } while ((f | 0) != (j | 0));\n      }\n\n      S = m;\n      return;\n    }\n\n    function Zb() {\n      return 12;\n    }\n\n    function _b(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0;\n      dd(a | 0, 0, 52) | 0;\n      i = G() | 0 | 134225919;\n\n      if ((a | 0) < 1) {\n        e = 0;\n        d = 0;\n\n        do {\n          if (la(e) | 0) {\n            dd(e | 0, 0, 45) | 0;\n            h = i | (G() | 0);\n            a = c + (d << 3) | 0;\n            b[a >> 2] = -1;\n            b[a + 4 >> 2] = h;\n            d = d + 1 | 0;\n          }\n\n          e = e + 1 | 0;\n        } while ((e | 0) != 122);\n\n        return;\n      }\n\n      h = 0;\n      d = 0;\n\n      do {\n        if (la(h) | 0) {\n          dd(h | 0, 0, 45) | 0;\n          e = 1;\n          f = -1;\n          g = i | (G() | 0);\n\n          while (1) {\n            j = dd(7, 0, (15 - e | 0) * 3 | 0) | 0;\n            f = f & ~j;\n            g = g & ~(G() | 0);\n            if ((e | 0) == (a | 0)) { break; }else { e = e + 1 | 0; }\n          }\n\n          j = c + (d << 3) | 0;\n          b[j >> 2] = f;\n          b[j + 4 >> 2] = g;\n          d = d + 1 | 0;\n        }\n\n        h = h + 1 | 0;\n      } while ((h | 0) != 122);\n\n      return;\n    }\n\n    function $b(a, c, d, e) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      var f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0;\n      i = S;\n      S = S + 64 | 0;\n      h = i;\n\n      if ((a | 0) == (d | 0) & (c | 0) == (e | 0) | (0 != 0 | (c & 2013265920 | 0) != 134217728 | (0 != 0 | (e & 2013265920 | 0) != 134217728))) {\n        h = 0;\n        S = i;\n        return h | 0;\n      }\n\n      f = cd(a | 0, c | 0, 52) | 0;\n      G() | 0;\n      f = f & 15;\n      g = cd(d | 0, e | 0, 52) | 0;\n      G() | 0;\n\n      if ((f | 0) != (g & 15 | 0)) {\n        h = 0;\n        S = i;\n        return h | 0;\n      }\n\n      g = f + -1 | 0;\n\n      if (f >>> 0 > 1 ? (k = Cb(a, c, g) | 0, j = G() | 0, g = Cb(d, e, g) | 0, (k | 0) == (g | 0) & (j | 0) == (G() | 0)) : 0) {\n        g = (f ^ 15) * 3 | 0;\n        f = cd(a | 0, c | 0, g | 0) | 0;\n        G() | 0;\n        f = f & 7;\n        g = cd(d | 0, e | 0, g | 0) | 0;\n        G() | 0;\n        g = g & 7;\n\n        if ((f | 0) == 0 | (g | 0) == 0) {\n          k = 1;\n          S = i;\n          return k | 0;\n        }\n\n        if ((b[21136 + (f << 2) >> 2] | 0) == (g | 0)) {\n          k = 1;\n          S = i;\n          return k | 0;\n        }\n\n        if ((b[21168 + (f << 2) >> 2] | 0) == (g | 0)) {\n          k = 1;\n          S = i;\n          return k | 0;\n        }\n      }\n\n      f = h;\n      g = f + 56 | 0;\n\n      do {\n        b[f >> 2] = 0;\n        f = f + 4 | 0;\n      } while ((f | 0) < (g | 0));\n\n      $(a, c, 1, h);\n      k = h;\n\n      if (((((!((b[k >> 2] | 0) == (d | 0) ? (b[k + 4 >> 2] | 0) == (e | 0) : 0) ? (k = h + 8 | 0, !((b[k >> 2] | 0) == (d | 0) ? (b[k + 4 >> 2] | 0) == (e | 0) : 0)) : 0) ? (k = h + 16 | 0, !((b[k >> 2] | 0) == (d | 0) ? (b[k + 4 >> 2] | 0) == (e | 0) : 0)) : 0) ? (k = h + 24 | 0, !((b[k >> 2] | 0) == (d | 0) ? (b[k + 4 >> 2] | 0) == (e | 0) : 0)) : 0) ? (k = h + 32 | 0, !((b[k >> 2] | 0) == (d | 0) ? (b[k + 4 >> 2] | 0) == (e | 0) : 0)) : 0) ? (k = h + 40 | 0, !((b[k >> 2] | 0) == (d | 0) ? (b[k + 4 >> 2] | 0) == (e | 0) : 0)) : 0) {\n        f = h + 48 | 0;\n        f = ((b[f >> 2] | 0) == (d | 0) ? (b[f + 4 >> 2] | 0) == (e | 0) : 0) & 1;\n      } else { f = 1; }\n\n      k = f;\n      S = i;\n      return k | 0;\n    }\n\n    function ac(a, c, d, e) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      var f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0;\n      k = S;\n      S = S + 16 | 0;\n      h = k;\n\n      if (!($b(a, c, d, e) | 0)) {\n        i = 0;\n        j = 0;\n        F(i | 0);\n        S = k;\n        return j | 0;\n      }\n\n      i = c & -2130706433;\n      f = (Fb(a, c) | 0) == 0;\n      f = f ? 1 : 2;\n\n      while (1) {\n        b[h >> 2] = 0;\n        l = da(a, c, f, h) | 0;\n        g = f + 1 | 0;\n        if ((l | 0) == (d | 0) & (G() | 0) == (e | 0)) { break; }\n        if (g >>> 0 < 7) { f = g; }else {\n          f = 0;\n          a = 0;\n          j = 6;\n          break;\n        }\n      }\n\n      if ((j | 0) == 6) {\n        F(f | 0);\n        S = k;\n        return a | 0;\n      }\n\n      l = dd(f | 0, 0, 56) | 0;\n      j = i | (G() | 0) | 268435456;\n      l = a | l;\n      F(j | 0);\n      S = k;\n      return l | 0;\n    }\n\n    function bc(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0;\n      c = 0 == 0 & (b & 2013265920 | 0) == 268435456;\n      F((c ? b & -2130706433 | 134217728 : 0) | 0);\n      return (c ? a : 0) | 0;\n    }\n\n    function cc(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0,\n          f = 0;\n      e = S;\n      S = S + 16 | 0;\n      d = e;\n\n      if (!(0 == 0 & (c & 2013265920 | 0) == 268435456)) {\n        c = 0;\n        d = 0;\n        F(c | 0);\n        S = e;\n        return d | 0;\n      }\n\n      f = cd(a | 0, c | 0, 56) | 0;\n      G() | 0;\n      b[d >> 2] = 0;\n      d = da(a, c & -2130706433 | 134217728, f & 7, d) | 0;\n      c = G() | 0;\n      F(c | 0);\n      S = e;\n      return d | 0;\n    }\n\n    function dc(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0;\n\n      if (!(0 == 0 & (b & 2013265920 | 0) == 268435456)) {\n        c = 0;\n        return c | 0;\n      }\n\n      c = cd(a | 0, b | 0, 56) | 0;\n      G() | 0;\n\n      switch (c & 7) {\n        case 0:\n        case 7:\n          {\n            c = 0;\n            return c | 0;\n          }\n\n        default:\n\n      }\n\n      c = b & -2130706433 | 134217728;\n\n      if (0 == 0 & (b & 117440512 | 0) == 16777216 & (Fb(a, c) | 0) != 0) {\n        c = 0;\n        return c | 0;\n      }\n\n      c = Bb(a, c) | 0;\n      return c | 0;\n    }\n\n    function ec(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      g = S;\n      S = S + 16 | 0;\n      e = g;\n      h = 0 == 0 & (c & 2013265920 | 0) == 268435456;\n      f = c & -2130706433 | 134217728;\n      i = d;\n      b[i >> 2] = h ? a : 0;\n      b[i + 4 >> 2] = h ? f : 0;\n\n      if (h) {\n        c = cd(a | 0, c | 0, 56) | 0;\n        G() | 0;\n        b[e >> 2] = 0;\n        a = da(a, f, c & 7, e) | 0;\n        c = G() | 0;\n      } else {\n        a = 0;\n        c = 0;\n      }\n\n      i = d + 8 | 0;\n      b[i >> 2] = a;\n      b[i + 4 >> 2] = c;\n      S = g;\n      return;\n    }\n\n    function fc(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0;\n      f = (Fb(a, c) | 0) == 0;\n      c = c & -2130706433;\n      e = d;\n      b[e >> 2] = f ? a : 0;\n      b[e + 4 >> 2] = f ? c | 285212672 : 0;\n      e = d + 8 | 0;\n      b[e >> 2] = a;\n      b[e + 4 >> 2] = c | 301989888;\n      e = d + 16 | 0;\n      b[e >> 2] = a;\n      b[e + 4 >> 2] = c | 318767104;\n      e = d + 24 | 0;\n      b[e >> 2] = a;\n      b[e + 4 >> 2] = c | 335544320;\n      e = d + 32 | 0;\n      b[e >> 2] = a;\n      b[e + 4 >> 2] = c | 352321536;\n      d = d + 40 | 0;\n      b[d >> 2] = a;\n      b[d + 4 >> 2] = c | 369098752;\n      return;\n    }\n\n    function gc(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      h = S;\n      S = S + 16 | 0;\n      g = h;\n      e = cd(a | 0, c | 0, 56) | 0;\n      G() | 0;\n      i = 0 == 0 & (c & 2013265920 | 0) == 268435456;\n      f = i ? a : 0;\n      a = i ? c & -2130706433 | 134217728 : 0;\n      c = Lc(f, a, e & 7) | 0;\n\n      if ((c | 0) == -1) {\n        b[d >> 2] = 0;\n        S = h;\n        return;\n      }\n\n      Ub(f, a, g);\n      e = cd(f | 0, a | 0, 52) | 0;\n      G() | 0;\n      e = e & 15;\n      if (!(Fb(f, a) | 0)) { eb(g, e, c, 2, d); }else { ab(g, e, c, 2, d); }\n      S = h;\n      return;\n    }\n\n    function hc(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0;\n      c = Yc(1, 12) | 0;\n      if (!c) { H(22691, 22646, 49, 22704); }\n      d = a + 4 | 0;\n      e = b[d >> 2] | 0;\n\n      if (e | 0) {\n        e = e + 8 | 0;\n        b[e >> 2] = c;\n        b[d >> 2] = c;\n        return c | 0;\n      }\n\n      if (b[a >> 2] | 0) { H(22721, 22646, 61, 22744); }\n      e = a;\n      b[e >> 2] = c;\n      b[d >> 2] = c;\n      return c | 0;\n    }\n\n    function ic(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0;\n      e = Wc(24) | 0;\n      if (!e) { H(22758, 22646, 78, 22772); }\n      b[e >> 2] = b[c >> 2];\n      b[e + 4 >> 2] = b[c + 4 >> 2];\n      b[e + 8 >> 2] = b[c + 8 >> 2];\n      b[e + 12 >> 2] = b[c + 12 >> 2];\n      b[e + 16 >> 2] = 0;\n      c = a + 4 | 0;\n      d = b[c >> 2] | 0;\n\n      if (d | 0) {\n        b[d + 16 >> 2] = e;\n        b[c >> 2] = e;\n        return e | 0;\n      }\n\n      if (b[a >> 2] | 0) { H(22787, 22646, 82, 22772); }\n      b[a >> 2] = e;\n      b[c >> 2] = e;\n      return e | 0;\n    }\n\n    function jc(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0;\n      if (!a) { return; }\n      e = 1;\n\n      while (1) {\n        c = b[a >> 2] | 0;\n        if (c | 0) { do {\n          d = b[c >> 2] | 0;\n          if (d | 0) { do {\n            f = d;\n            d = b[d + 16 >> 2] | 0;\n            Xc(f);\n          } while ((d | 0) != 0); }\n          f = c;\n          c = b[c + 8 >> 2] | 0;\n          Xc(f);\n        } while ((c | 0) != 0); }\n        c = a;\n        a = b[a + 8 >> 2] | 0;\n        if (!e) { Xc(c); }\n        if (!a) { break; }else { e = 0; }\n      }\n\n      return;\n    }\n\n    function kc(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          f = 0,\n          g = 0,\n          h = 0.0,\n          i = 0,\n          j = 0.0,\n          k = 0.0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0,\n          p = 0,\n          r = 0,\n          s = 0.0,\n          t = 0.0,\n          u = 0.0,\n          v = 0.0,\n          w = 0.0,\n          x = 0.0,\n          y = 0,\n          z = 0,\n          A = 0,\n          B = 0,\n          C = 0,\n          D = 0,\n          E = 0,\n          F = 0,\n          G = 0,\n          I = 0,\n          J = 0,\n          K = 0;\n      g = a + 8 | 0;\n\n      if (b[g >> 2] | 0) {\n        K = 1;\n        return K | 0;\n      }\n\n      f = b[a >> 2] | 0;\n\n      if (!f) {\n        K = 0;\n        return K | 0;\n      }\n\n      c = f;\n      d = 0;\n\n      do {\n        d = d + 1 | 0;\n        c = b[c + 8 >> 2] | 0;\n      } while ((c | 0) != 0);\n\n      if (d >>> 0 < 2) {\n        K = 0;\n        return K | 0;\n      }\n\n      I = Wc(d << 2) | 0;\n      if (!I) { H(22807, 22646, 317, 22826); }\n      G = Wc(d << 5) | 0;\n      if (!G) { H(22848, 22646, 321, 22826); }\n      b[a >> 2] = 0;\n      z = a + 4 | 0;\n      b[z >> 2] = 0;\n      b[g >> 2] = 0;\n      d = 0;\n      F = 0;\n      y = 0;\n      n = 0;\n\n      a: while (1) {\n        m = b[f >> 2] | 0;\n\n        if (m) {\n          h = 0.0;\n          i = m;\n\n          do {\n            k = +e[i + 8 >> 3];\n            c = i;\n            i = b[i + 16 >> 2] | 0;\n            l = (i | 0) == 0;\n            g = l ? m : i;\n            j = +e[g + 8 >> 3];\n\n            if (+q(+(k - j)) > 3.141592653589793) {\n              K = 14;\n              break;\n            }\n\n            h = h + (j - k) * (+e[c >> 3] + +e[g >> 3]);\n          } while (!l);\n\n          if ((K | 0) == 14) {\n            K = 0;\n            h = 0.0;\n            c = m;\n\n            do {\n              x = +e[c + 8 >> 3];\n              E = c + 16 | 0;\n              D = b[E >> 2] | 0;\n              D = (D | 0) == 0 ? m : D;\n              w = +e[D + 8 >> 3];\n              h = h + (+e[c >> 3] + +e[D >> 3]) * ((w < 0.0 ? w + 6.283185307179586 : w) - (x < 0.0 ? x + 6.283185307179586 : x));\n              c = b[((c | 0) == 0 ? f : E) >> 2] | 0;\n            } while ((c | 0) != 0);\n          }\n\n          if (h > 0.0) {\n            b[I + (F << 2) >> 2] = f;\n            F = F + 1 | 0;\n            g = y;\n            c = n;\n          } else { K = 19; }\n        } else { K = 19; }\n\n        if ((K | 0) == 19) {\n          K = 0;\n\n          do { if (!d) {\n            if (!n) {\n              if (!(b[a >> 2] | 0)) {\n                g = z;\n                i = a;\n                c = f;\n                d = a;\n                break;\n              } else {\n                K = 27;\n                break a;\n              }\n            } else {\n              g = z;\n              i = n + 8 | 0;\n              c = f;\n              d = a;\n              break;\n            }\n          } else {\n            c = d + 8 | 0;\n\n            if (b[c >> 2] | 0) {\n              K = 21;\n              break a;\n            }\n\n            d = Yc(1, 12) | 0;\n\n            if (!d) {\n              K = 23;\n              break a;\n            }\n\n            b[c >> 2] = d;\n            g = d + 4 | 0;\n            i = d;\n            c = n;\n          } } while (0);\n\n          b[i >> 2] = f;\n          b[g >> 2] = f;\n          i = G + (y << 5) | 0;\n          l = b[f >> 2] | 0;\n\n          if (l) {\n            m = G + (y << 5) + 8 | 0;\n            e[m >> 3] = 1797693134862315708145274.0e284;\n            n = G + (y << 5) + 24 | 0;\n            e[n >> 3] = 1797693134862315708145274.0e284;\n            e[i >> 3] = -1797693134862315708145274.0e284;\n            o = G + (y << 5) + 16 | 0;\n            e[o >> 3] = -1797693134862315708145274.0e284;\n            u = 1797693134862315708145274.0e284;\n            v = -1797693134862315708145274.0e284;\n            g = 0;\n            p = l;\n            k = 1797693134862315708145274.0e284;\n            s = 1797693134862315708145274.0e284;\n            t = -1797693134862315708145274.0e284;\n            j = -1797693134862315708145274.0e284;\n\n            while (1) {\n              h = +e[p >> 3];\n              x = +e[p + 8 >> 3];\n              p = b[p + 16 >> 2] | 0;\n              r = (p | 0) == 0;\n              w = +e[(r ? l : p) + 8 >> 3];\n\n              if (h < k) {\n                e[m >> 3] = h;\n                k = h;\n              }\n\n              if (x < s) {\n                e[n >> 3] = x;\n                s = x;\n              }\n\n              if (h > t) { e[i >> 3] = h; }else { h = t; }\n\n              if (x > j) {\n                e[o >> 3] = x;\n                j = x;\n              }\n\n              u = x > 0.0 & x < u ? x : u;\n              v = x < 0.0 & x > v ? x : v;\n              g = g | +q(+(x - w)) > 3.141592653589793;\n              if (r) { break; }else { t = h; }\n            }\n\n            if (g) {\n              e[o >> 3] = v;\n              e[n >> 3] = u;\n            }\n          } else {\n            b[i >> 2] = 0;\n            b[i + 4 >> 2] = 0;\n            b[i + 8 >> 2] = 0;\n            b[i + 12 >> 2] = 0;\n            b[i + 16 >> 2] = 0;\n            b[i + 20 >> 2] = 0;\n            b[i + 24 >> 2] = 0;\n            b[i + 28 >> 2] = 0;\n          }\n\n          g = y + 1 | 0;\n        }\n\n        E = f + 8 | 0;\n        f = b[E >> 2] | 0;\n        b[E >> 2] = 0;\n\n        if (!f) {\n          K = 45;\n          break;\n        } else {\n          y = g;\n          n = c;\n        }\n      }\n\n      if ((K | 0) == 21) { H(22624, 22646, 35, 22658); }else if ((K | 0) == 23) { H(22678, 22646, 37, 22658); }else if ((K | 0) == 27) { H(22721, 22646, 61, 22744); }else if ((K | 0) == 45) {\n        b: do { if ((F | 0) > 0) {\n          E = (g | 0) == 0;\n          C = g << 2;\n          D = (a | 0) == 0;\n          B = 0;\n          c = 0;\n\n          while (1) {\n            A = b[I + (B << 2) >> 2] | 0;\n\n            if (!E) {\n              y = Wc(C) | 0;\n\n              if (!y) {\n                K = 50;\n                break;\n              }\n\n              z = Wc(C) | 0;\n\n              if (!z) {\n                K = 52;\n                break;\n              }\n\n              c: do { if (!D) {\n                g = 0;\n                d = 0;\n                i = a;\n\n                while (1) {\n                  f = G + (g << 5) | 0;\n\n                  if (lc(b[i >> 2] | 0, f, b[A >> 2] | 0) | 0) {\n                    b[y + (d << 2) >> 2] = i;\n                    b[z + (d << 2) >> 2] = f;\n                    r = d + 1 | 0;\n                  } else { r = d; }\n\n                  i = b[i + 8 >> 2] | 0;\n                  if (!i) { break; }else {\n                    g = g + 1 | 0;\n                    d = r;\n                  }\n                }\n\n                if ((r | 0) > 0) {\n                  f = b[y >> 2] | 0;\n                  if ((r | 0) == 1) { d = f; }else {\n                    o = 0;\n                    p = -1;\n                    d = f;\n                    n = f;\n\n                    while (1) {\n                      l = b[n >> 2] | 0;\n                      f = 0;\n                      i = 0;\n\n                      while (1) {\n                        g = b[b[y + (i << 2) >> 2] >> 2] | 0;\n                        if ((g | 0) == (l | 0)) { m = f; }else { m = f + ((lc(g, b[z + (i << 2) >> 2] | 0, b[l >> 2] | 0) | 0) & 1) | 0; }\n                        i = i + 1 | 0;\n                        if ((i | 0) == (r | 0)) { break; }else { f = m; }\n                      }\n\n                      g = (m | 0) > (p | 0);\n                      d = g ? n : d;\n                      f = o + 1 | 0;\n                      if ((f | 0) == (r | 0)) { break c; }\n                      o = f;\n                      p = g ? m : p;\n                      n = b[y + (f << 2) >> 2] | 0;\n                    }\n                  }\n                } else { d = 0; }\n              } else { d = 0; } } while (0);\n\n              Xc(y);\n              Xc(z);\n\n              if (d) {\n                g = d + 4 | 0;\n                f = b[g >> 2] | 0;\n\n                if (!f) {\n                  if (b[d >> 2] | 0) {\n                    K = 70;\n                    break;\n                  }\n                } else { d = f + 8 | 0; }\n\n                b[d >> 2] = A;\n                b[g >> 2] = A;\n              } else { K = 73; }\n            } else { K = 73; }\n\n            if ((K | 0) == 73) {\n              K = 0;\n              c = b[A >> 2] | 0;\n              if (c | 0) { do {\n                z = c;\n                c = b[c + 16 >> 2] | 0;\n                Xc(z);\n              } while ((c | 0) != 0); }\n              Xc(A);\n              c = 2;\n            }\n\n            B = B + 1 | 0;\n\n            if ((B | 0) >= (F | 0)) {\n              J = c;\n              break b;\n            }\n          }\n\n          if ((K | 0) == 50) { H(22863, 22646, 249, 22882); }else if ((K | 0) == 52) { H(22901, 22646, 252, 22882); }else if ((K | 0) == 70) { H(22721, 22646, 61, 22744); }\n        } else { J = 0; } } while (0);\n\n        Xc(I);\n        Xc(G);\n        K = J;\n        return K | 0;\n      }\n      return 0;\n    }\n\n    function lc(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var f = 0.0,\n          g = 0.0,\n          h = 0.0,\n          i = 0.0,\n          j = 0.0,\n          k = 0.0,\n          l = 0.0,\n          m = 0;\n\n      if (!(xa(c, d) | 0)) {\n        a = 0;\n        return a | 0;\n      }\n\n      c = wa(c) | 0;\n      l = +e[d >> 3];\n      f = +e[d + 8 >> 3];\n      f = c & f < 0.0 ? f + 6.283185307179586 : f;\n      a = b[a >> 2] | 0;\n\n      if (!a) {\n        a = 0;\n        return a | 0;\n      }\n\n      if (c) {\n        c = 0;\n        d = a;\n\n        a: while (1) {\n          while (1) {\n            i = +e[d >> 3];\n            k = +e[d + 8 >> 3];\n            d = d + 16 | 0;\n            m = b[d >> 2] | 0;\n            m = (m | 0) == 0 ? a : m;\n            h = +e[m >> 3];\n            g = +e[m + 8 >> 3];\n\n            if (i > h) {\n              j = i;\n              i = k;\n            } else {\n              j = h;\n              h = i;\n              i = g;\n              g = k;\n            }\n\n            if (!(l < h | l > j)) { break; }\n            d = b[d >> 2] | 0;\n\n            if (!d) {\n              d = 22;\n              break a;\n            }\n          }\n\n          k = g < 0.0 ? g + 6.283185307179586 : g;\n          i = i < 0.0 ? i + 6.283185307179586 : i;\n          f = i == f | k == f ? f + -2.220446049250313e-16 : f;\n          k = k + (l - h) / (j - h) * (i - k);\n          if ((k < 0.0 ? k + 6.283185307179586 : k) > f) { c = c ^ 1; }\n          d = b[d >> 2] | 0;\n\n          if (!d) {\n            d = 22;\n            break;\n          }\n        }\n\n        if ((d | 0) == 22) { return c | 0; }\n      } else {\n        c = 0;\n        d = a;\n\n        b: while (1) {\n          while (1) {\n            i = +e[d >> 3];\n            k = +e[d + 8 >> 3];\n            d = d + 16 | 0;\n            m = b[d >> 2] | 0;\n            m = (m | 0) == 0 ? a : m;\n            h = +e[m >> 3];\n            g = +e[m + 8 >> 3];\n\n            if (i > h) {\n              j = i;\n              i = k;\n            } else {\n              j = h;\n              h = i;\n              i = g;\n              g = k;\n            }\n\n            if (!(l < h | l > j)) { break; }\n            d = b[d >> 2] | 0;\n\n            if (!d) {\n              d = 22;\n              break b;\n            }\n          }\n\n          f = i == f | g == f ? f + -2.220446049250313e-16 : f;\n          if (g + (l - h) / (j - h) * (i - g) > f) { c = c ^ 1; }\n          d = b[d >> 2] | 0;\n\n          if (!d) {\n            d = 22;\n            break;\n          }\n        }\n\n        if ((d | 0) == 22) { return c | 0; }\n      }\n\n      return 0;\n    }\n\n    function mc(c, d, e, f, g) {\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      f = f | 0;\n      g = g | 0;\n      var h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0,\n          p = 0,\n          q = 0,\n          r = 0,\n          s = 0,\n          t = 0,\n          u = 0;\n      u = S;\n      S = S + 32 | 0;\n      t = u + 16 | 0;\n      s = u;\n      h = cd(c | 0, d | 0, 52) | 0;\n      G() | 0;\n      h = h & 15;\n      p = cd(e | 0, f | 0, 52) | 0;\n      G() | 0;\n\n      if ((h | 0) != (p & 15 | 0)) {\n        t = 1;\n        S = u;\n        return t | 0;\n      }\n\n      l = cd(c | 0, d | 0, 45) | 0;\n      G() | 0;\n      l = l & 127;\n      m = cd(e | 0, f | 0, 45) | 0;\n      G() | 0;\n      m = m & 127;\n      p = (l | 0) != (m | 0);\n\n      if (p) {\n        j = ta(l, m) | 0;\n\n        if ((j | 0) == 7) {\n          t = 2;\n          S = u;\n          return t | 0;\n        }\n\n        k = ta(m, l) | 0;\n        if ((k | 0) == 7) { H(22925, 22949, 151, 22959); }else {\n          q = j;\n          i = k;\n        }\n      } else {\n        q = 0;\n        i = 0;\n      }\n\n      n = la(l) | 0;\n      o = la(m) | 0;\n      b[t >> 2] = 0;\n      b[t + 4 >> 2] = 0;\n      b[t + 8 >> 2] = 0;\n      b[t + 12 >> 2] = 0;\n\n      do { if (!q) {\n        Tb(e, f, t) | 0;\n\n        if ((n | 0) != 0 & (o | 0) != 0) {\n          if ((m | 0) != (l | 0)) { H(23077, 22949, 243, 22959); }\n          i = Lb(c, d) | 0;\n          h = Lb(e, f) | 0;\n\n          if (!(a[22032 + (i * 7 | 0) + h >> 0] | 0)) {\n            i = b[21200 + (i * 28 | 0) + (h << 2) >> 2] | 0;\n\n            if ((i | 0) > 0) {\n              j = t + 4 | 0;\n              h = 0;\n\n              do {\n                Oa(j);\n                h = h + 1 | 0;\n              } while ((h | 0) != (i | 0));\n\n              r = 50;\n            } else { r = 50; }\n          } else { h = 5; }\n        } else { r = 50; }\n      } else {\n        m = b[4304 + (l * 28 | 0) + (q << 2) >> 2] | 0;\n        j = (m | 0) > 0;\n        if (!o) {\n          if (j) {\n            l = 0;\n            k = e;\n            j = f;\n\n            do {\n              k = Pb(k, j) | 0;\n              j = G() | 0;\n              i = Qa(i) | 0;\n              l = l + 1 | 0;\n            } while ((l | 0) != (m | 0));\n\n            m = i;\n            l = k;\n            k = j;\n          } else {\n            m = i;\n            l = e;\n            k = f;\n          }\n        } else if (j) {\n          l = 0;\n          k = e;\n          j = f;\n\n          do {\n            k = Ob(k, j) | 0;\n            j = G() | 0;\n            i = Qa(i) | 0;\n            if ((i | 0) == 1) { i = Qa(1) | 0; }\n            l = l + 1 | 0;\n          } while ((l | 0) != (m | 0));\n\n          m = i;\n          l = k;\n          k = j;\n        } else {\n          m = i;\n          l = e;\n          k = f;\n        }\n        Tb(l, k, t) | 0;\n        if (!p) { H(22972, 22949, 181, 22959); }\n        j = (n | 0) != 0;\n        i = (o | 0) != 0;\n        if (j & i) { H(22999, 22949, 182, 22959); }\n        if (!j) {\n          if (i) {\n            i = Lb(l, k) | 0;\n\n            if (a[22032 + (i * 7 | 0) + m >> 0] | 0) {\n              h = 4;\n              break;\n            }\n\n            l = 0;\n            k = b[21200 + (m * 28 | 0) + (i << 2) >> 2] | 0;\n            r = 26;\n          } else { i = 0; }\n        } else {\n          i = Lb(c, d) | 0;\n\n          if (a[22032 + (i * 7 | 0) + q >> 0] | 0) {\n            h = 3;\n            break;\n          }\n\n          k = b[21200 + (i * 28 | 0) + (q << 2) >> 2] | 0;\n          l = k;\n          r = 26;\n        }\n\n        if ((r | 0) == 26) {\n          if ((k | 0) <= -1) { H(23030, 22949, 212, 22959); }\n          if ((l | 0) <= -1) { H(23053, 22949, 213, 22959); }\n\n          if ((k | 0) > 0) {\n            j = t + 4 | 0;\n            i = 0;\n\n            do {\n              Oa(j);\n              i = i + 1 | 0;\n            } while ((i | 0) != (k | 0));\n\n            i = l;\n          } else { i = l; }\n        }\n        b[s >> 2] = 0;\n        b[s + 4 >> 2] = 0;\n        b[s + 8 >> 2] = 0;\n        Ma(s, q);\n        if (h | 0) { while (1) {\n          if (!(Rb(h) | 0)) { La(s); }else { Ka(s); }\n          if ((h | 0) > 1) { h = h + -1 | 0; }else { break; }\n        } }\n\n        if ((i | 0) > 0) {\n          h = 0;\n\n          do {\n            Oa(s);\n            h = h + 1 | 0;\n          } while ((h | 0) != (i | 0));\n        }\n\n        r = t + 4 | 0;\n        Ea(r, s, r);\n        Ca(r);\n        r = 50;\n      } } while (0);\n\n      if ((r | 0) == 50) {\n        h = t + 4 | 0;\n        b[g >> 2] = b[h >> 2];\n        b[g + 4 >> 2] = b[h + 4 >> 2];\n        b[g + 8 >> 2] = b[h + 8 >> 2];\n        h = 0;\n      }\n\n      t = h;\n      S = u;\n      return t | 0;\n    }\n\n    function nc(a, c, d, e) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      var f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0,\n          p = 0,\n          q = 0,\n          r = 0,\n          s = 0,\n          t = 0;\n      p = S;\n      S = S + 48 | 0;\n      h = p + 36 | 0;\n      i = p + 24 | 0;\n      j = p + 12 | 0;\n      k = p;\n      g = cd(a | 0, c | 0, 52) | 0;\n      G() | 0;\n      g = g & 15;\n      n = cd(a | 0, c | 0, 45) | 0;\n      G() | 0;\n      n = n & 127;\n      l = la(n) | 0;\n      dd(g | 0, 0, 52) | 0;\n      r = G() | 0 | 134225919;\n      q = e;\n      b[q >> 2] = -1;\n      b[q + 4 >> 2] = r;\n\n      if (!g) {\n        if ((b[d >> 2] | 0) > 1) {\n          r = 1;\n          S = p;\n          return r | 0;\n        }\n\n        if ((b[d + 4 >> 2] | 0) > 1) {\n          r = 1;\n          S = p;\n          return r | 0;\n        }\n\n        if ((b[d + 8 >> 2] | 0) > 1) {\n          r = 1;\n          S = p;\n          return r | 0;\n        }\n\n        f = sa(n, Ha(d) | 0) | 0;\n\n        if ((f | 0) == 127) {\n          r = 1;\n          S = p;\n          return r | 0;\n        }\n\n        o = dd(f | 0, 0, 45) | 0;\n        q = G() | 0;\n        n = e;\n        q = b[n + 4 >> 2] & -1040385 | q;\n        r = e;\n        b[r >> 2] = b[n >> 2] | o;\n        b[r + 4 >> 2] = q;\n        r = 0;\n        S = p;\n        return r | 0;\n      }\n      b[h >> 2] = b[d >> 2];\n      b[h + 4 >> 2] = b[d + 4 >> 2];\n      b[h + 8 >> 2] = b[d + 8 >> 2];\n\n      while (1) {\n        b[i >> 2] = b[h >> 2];\n        b[i + 4 >> 2] = b[h + 4 >> 2];\n        b[i + 8 >> 2] = b[h + 8 >> 2];\n\n        if (!(Rb(g) | 0)) {\n          Ja(h);\n          b[j >> 2] = b[h >> 2];\n          b[j + 4 >> 2] = b[h + 4 >> 2];\n          b[j + 8 >> 2] = b[h + 8 >> 2];\n          La(j);\n        } else {\n          Ia(h);\n          b[j >> 2] = b[h >> 2];\n          b[j + 4 >> 2] = b[h + 4 >> 2];\n          b[j + 8 >> 2] = b[h + 8 >> 2];\n          Ka(j);\n        }\n\n        Fa(i, j, k);\n        Ca(k);\n        q = e;\n        s = b[q >> 2] | 0;\n        q = b[q + 4 >> 2] | 0;\n        t = (15 - g | 0) * 3 | 0;\n        d = dd(7, 0, t | 0) | 0;\n        q = q & ~(G() | 0);\n        t = dd(Ha(k) | 0, 0, t | 0) | 0;\n        q = G() | 0 | q;\n        r = e;\n        b[r >> 2] = t | s & ~d;\n        b[r + 4 >> 2] = q;\n        if ((g | 0) > 1) { g = g + -1 | 0; }else { break; }\n      }\n\n      a: do { if (((b[h >> 2] | 0) <= 1 ? (b[h + 4 >> 2] | 0) <= 1 : 0) ? (b[h + 8 >> 2] | 0) <= 1 : 0) {\n        g = Ha(h) | 0;\n        i = sa(n, g) | 0;\n        if ((i | 0) == 127) { k = 0; }else { k = la(i) | 0; }\n\n        b: do { if (!g) {\n          if ((l | 0) != 0 & (k | 0) != 0) {\n            t = Lb(a, c) | 0;\n            g = e;\n            g = 21408 + (t * 28 | 0) + ((Lb(b[g >> 2] | 0, b[g + 4 >> 2] | 0) | 0) << 2) | 0;\n            g = b[g >> 2] | 0;\n            if ((g | 0) <= -1) { H(23201, 22949, 433, 23134); }\n\n            if (!g) {\n              f = i;\n              g = 55;\n            } else {\n              h = e;\n              f = 0;\n              d = b[h >> 2] | 0;\n              h = b[h + 4 >> 2] | 0;\n\n              do {\n                d = Nb(d, h) | 0;\n                h = G() | 0;\n                t = e;\n                b[t >> 2] = d;\n                b[t + 4 >> 2] = h;\n                f = f + 1 | 0;\n              } while ((f | 0) < (g | 0));\n\n              f = i;\n              g = 54;\n            }\n          } else {\n            f = i;\n            g = 54;\n          }\n        } else {\n          if (l) {\n            h = 21408 + ((Lb(a, c) | 0) * 28 | 0) + (g << 2) | 0;\n            h = b[h >> 2] | 0;\n\n            if ((h | 0) > 0) {\n              d = 0;\n\n              do {\n                g = Pa(g) | 0;\n                d = d + 1 | 0;\n              } while ((d | 0) != (h | 0));\n            }\n\n            if ((g | 0) == 1) {\n              f = 3;\n              break a;\n            }\n\n            d = sa(n, g) | 0;\n            if ((d | 0) == 127) { H(23104, 22949, 376, 23134); }\n\n            if (!(la(d) | 0)) {\n              o = h;\n              m = g;\n              f = d;\n            } else { H(23147, 22949, 377, 23134); }\n          } else {\n            o = 0;\n            m = g;\n            f = i;\n          }\n\n          j = b[4304 + (n * 28 | 0) + (m << 2) >> 2] | 0;\n          if ((j | 0) <= -1) { H(23178, 22949, 384, 23134); }\n\n          if (!k) {\n            if ((o | 0) <= -1) { H(23030, 22949, 417, 23134); }\n\n            if (o | 0) {\n              h = e;\n              g = 0;\n              d = b[h >> 2] | 0;\n              h = b[h + 4 >> 2] | 0;\n\n              do {\n                d = Nb(d, h) | 0;\n                h = G() | 0;\n                t = e;\n                b[t >> 2] = d;\n                b[t + 4 >> 2] = h;\n                g = g + 1 | 0;\n              } while ((g | 0) < (o | 0));\n            }\n\n            if ((j | 0) <= 0) {\n              g = 54;\n              break;\n            }\n\n            h = e;\n            g = 0;\n            d = b[h >> 2] | 0;\n            h = b[h + 4 >> 2] | 0;\n\n            while (1) {\n              d = Nb(d, h) | 0;\n              h = G() | 0;\n              t = e;\n              b[t >> 2] = d;\n              b[t + 4 >> 2] = h;\n              g = g + 1 | 0;\n\n              if ((g | 0) == (j | 0)) {\n                g = 54;\n                break b;\n              }\n            }\n          }\n\n          i = ta(f, n) | 0;\n          if ((i | 0) == 7) { H(22925, 22949, 393, 23134); }\n          g = e;\n          d = b[g >> 2] | 0;\n          g = b[g + 4 >> 2] | 0;\n\n          if ((j | 0) > 0) {\n            h = 0;\n\n            do {\n              d = Nb(d, g) | 0;\n              g = G() | 0;\n              t = e;\n              b[t >> 2] = d;\n              b[t + 4 >> 2] = g;\n              h = h + 1 | 0;\n            } while ((h | 0) != (j | 0));\n          }\n\n          d = Lb(d, g) | 0;\n          t = ma(f) | 0;\n          d = b[(t ? 21824 : 21616) + (i * 28 | 0) + (d << 2) >> 2] | 0;\n          if ((d | 0) <= -1) { H(23030, 22949, 412, 23134); }\n          if (!d) { g = 54; }else {\n            i = e;\n            g = 0;\n            h = b[i >> 2] | 0;\n            i = b[i + 4 >> 2] | 0;\n\n            do {\n              h = Mb(h, i) | 0;\n              i = G() | 0;\n              t = e;\n              b[t >> 2] = h;\n              b[t + 4 >> 2] = i;\n              g = g + 1 | 0;\n            } while ((g | 0) < (d | 0));\n\n            g = 54;\n          }\n        } } while (0);\n\n        if ((g | 0) == 54) { if (k) { g = 55; } }\n\n        if ((g | 0) == 55) {\n          t = e;\n\n          if ((Lb(b[t >> 2] | 0, b[t + 4 >> 2] | 0) | 0) == 1) {\n            f = 4;\n            break;\n          }\n        }\n\n        t = e;\n        r = b[t >> 2] | 0;\n        t = b[t + 4 >> 2] & -1040385;\n        s = dd(f | 0, 0, 45) | 0;\n        t = t | (G() | 0);\n        f = e;\n        b[f >> 2] = r | s;\n        b[f + 4 >> 2] = t;\n        f = 0;\n      } else { f = 2; } } while (0);\n\n      t = f;\n      S = p;\n      return t | 0;\n    }\n\n    function oc(a, b, c, d, e) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      var f = 0,\n          g = 0;\n      g = S;\n      S = S + 16 | 0;\n      f = g;\n      a = mc(a, b, c, d, f) | 0;\n\n      if (!a) {\n        Ua(f, e);\n        a = 0;\n      }\n\n      S = g;\n      return a | 0;\n    }\n\n    function pc(a, b, c, d) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0;\n      e = S;\n      S = S + 16 | 0;\n      f = e;\n      Va(c, f);\n      d = nc(a, b, f, d) | 0;\n      S = e;\n      return d | 0;\n    }\n\n    function qc(a, b, c, d) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0;\n      g = S;\n      S = S + 32 | 0;\n      e = g + 12 | 0;\n      f = g;\n      if ((mc(a, b, a, b, e) | 0) == 0 ? (mc(a, b, c, d, f) | 0) == 0 : 0) { a = Ta(e, f) | 0; }else { a = -1; }\n      S = g;\n      return a | 0;\n    }\n\n    function rc(a, b, c, d) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0;\n      g = S;\n      S = S + 32 | 0;\n      e = g + 12 | 0;\n      f = g;\n      if ((mc(a, b, a, b, e) | 0) == 0 ? (mc(a, b, c, d, f) | 0) == 0 : 0) { a = Ta(e, f) | 0; }else { a = -1; }\n      S = g;\n      return (a >>> 31 ^ 1) + a | 0;\n    }\n\n    function sc(a, c, d, e, f) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      f = f | 0;\n      var g = 0,\n          h = 0,\n          i = 0.0,\n          j = 0.0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0.0,\n          p = 0.0,\n          r = 0.0,\n          s = 0,\n          t = 0,\n          u = 0,\n          v = 0,\n          w = 0,\n          x = 0,\n          y = 0.0;\n      x = S;\n      S = S + 48 | 0;\n      g = x + 24 | 0;\n      h = x + 12 | 0;\n      w = x;\n\n      if ((mc(a, c, a, c, g) | 0) == 0 ? (mc(a, c, d, e, h) | 0) == 0 : 0) {\n        v = Ta(g, h) | 0;\n\n        if ((v | 0) < 0) {\n          w = v;\n          S = x;\n          return w | 0;\n        }\n        b[g >> 2] = 0;\n        b[g + 4 >> 2] = 0;\n        b[g + 8 >> 2] = 0;\n        b[h >> 2] = 0;\n        b[h + 4 >> 2] = 0;\n        b[h + 8 >> 2] = 0;\n        mc(a, c, a, c, g) | 0;\n        mc(a, c, d, e, h) | 0;\n        Wa(g);\n        Wa(h);\n\n        if (!v) {\n          e = g + 4 | 0;\n          n = g + 8 | 0;\n          s = e;\n          t = n;\n          u = g;\n          d = b[g >> 2] | 0;\n          e = b[e >> 2] | 0;\n          g = b[n >> 2] | 0;\n          p = 0.0;\n          r = 0.0;\n          o = 0.0;\n        } else {\n          l = b[g >> 2] | 0;\n          o = +(v | 0);\n          s = g + 4 | 0;\n          m = b[s >> 2] | 0;\n          t = g + 8 | 0;\n          n = b[t >> 2] | 0;\n          u = g;\n          d = l;\n          e = m;\n          g = n;\n          p = +((b[h >> 2] | 0) - l | 0) / o;\n          r = +((b[h + 4 >> 2] | 0) - m | 0) / o;\n          o = +((b[h + 8 >> 2] | 0) - n | 0) / o;\n        }\n\n        b[w >> 2] = d;\n        n = w + 4 | 0;\n        b[n >> 2] = e;\n        m = w + 8 | 0;\n        b[m >> 2] = g;\n        l = 0;\n\n        while (1) {\n          j = +(l | 0);\n          y = p * j + +(d | 0);\n          i = r * j + +(b[s >> 2] | 0);\n          j = o * j + +(b[t >> 2] | 0);\n          e = ~~+fd(+y);\n          h = ~~+fd(+i);\n          d = ~~+fd(+j);\n          y = +q(+(+(e | 0) - y));\n          i = +q(+(+(h | 0) - i));\n          j = +q(+(+(d | 0) - j));\n\n          do { if (!(y > i & y > j)) {\n            k = 0 - e | 0;\n\n            if (i > j) {\n              g = k - d | 0;\n              break;\n            } else {\n              g = h;\n              d = k - h | 0;\n              break;\n            }\n          } else {\n            e = 0 - (h + d) | 0;\n            g = h;\n          } } while (0);\n\n          b[w >> 2] = e;\n          b[n >> 2] = g;\n          b[m >> 2] = d;\n          Xa(w);\n          nc(a, c, w, f + (l << 3) | 0) | 0;\n          if ((l | 0) == (v | 0)) { break; }\n          l = l + 1 | 0;\n          d = b[u >> 2] | 0;\n        }\n\n        w = 0;\n        S = x;\n        return w | 0;\n      }\n\n      w = -1;\n      S = x;\n      return w | 0;\n    }\n\n    function tc(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0;\n\n      if (!b) {\n        c = 1;\n        return c | 0;\n      }\n\n      c = a;\n      a = 1;\n\n      do {\n        a = B((b & 1 | 0) == 0 ? 1 : c, a) | 0;\n        b = b >> 1;\n        c = B(c, c) | 0;\n      } while ((b | 0) != 0);\n\n      return a | 0;\n    }\n\n    function uc(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var f = 0.0,\n          g = 0.0,\n          h = 0.0,\n          i = 0.0,\n          j = 0.0,\n          k = 0.0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0.0;\n\n      if (!(xa(c, d) | 0)) {\n        n = 0;\n        return n | 0;\n      }\n\n      c = wa(c) | 0;\n      o = +e[d >> 3];\n      f = +e[d + 8 >> 3];\n      f = c & f < 0.0 ? f + 6.283185307179586 : f;\n      n = b[a >> 2] | 0;\n\n      if ((n | 0) <= 0) {\n        n = 0;\n        return n | 0;\n      }\n\n      m = b[a + 4 >> 2] | 0;\n\n      if (c) {\n        c = 0;\n        d = -1;\n        a = 0;\n\n        a: while (1) {\n          l = a;\n\n          while (1) {\n            i = +e[m + (l << 4) >> 3];\n            k = +e[m + (l << 4) + 8 >> 3];\n            a = (d + 2 | 0) % (n | 0) | 0;\n            h = +e[m + (a << 4) >> 3];\n            g = +e[m + (a << 4) + 8 >> 3];\n\n            if (i > h) {\n              j = i;\n              i = k;\n            } else {\n              j = h;\n              h = i;\n              i = g;\n              g = k;\n            }\n\n            if (!(o < h | o > j)) { break; }\n            d = l + 1 | 0;\n\n            if ((d | 0) < (n | 0)) {\n              a = l;\n              l = d;\n              d = a;\n            } else {\n              d = 22;\n              break a;\n            }\n          }\n\n          k = g < 0.0 ? g + 6.283185307179586 : g;\n          i = i < 0.0 ? i + 6.283185307179586 : i;\n          f = i == f | k == f ? f + -2.220446049250313e-16 : f;\n          k = k + (o - h) / (j - h) * (i - k);\n          if ((k < 0.0 ? k + 6.283185307179586 : k) > f) { c = c ^ 1; }\n          a = l + 1 | 0;\n\n          if ((a | 0) >= (n | 0)) {\n            d = 22;\n            break;\n          } else { d = l; }\n        }\n\n        if ((d | 0) == 22) { return c | 0; }\n      } else {\n        c = 0;\n        d = -1;\n        a = 0;\n\n        b: while (1) {\n          l = a;\n\n          while (1) {\n            i = +e[m + (l << 4) >> 3];\n            k = +e[m + (l << 4) + 8 >> 3];\n            a = (d + 2 | 0) % (n | 0) | 0;\n            h = +e[m + (a << 4) >> 3];\n            g = +e[m + (a << 4) + 8 >> 3];\n\n            if (i > h) {\n              j = i;\n              i = k;\n            } else {\n              j = h;\n              h = i;\n              i = g;\n              g = k;\n            }\n\n            if (!(o < h | o > j)) { break; }\n            d = l + 1 | 0;\n\n            if ((d | 0) < (n | 0)) {\n              a = l;\n              l = d;\n              d = a;\n            } else {\n              d = 22;\n              break b;\n            }\n          }\n\n          f = i == f | g == f ? f + -2.220446049250313e-16 : f;\n          if (g + (o - h) / (j - h) * (i - g) > f) { c = c ^ 1; }\n          a = l + 1 | 0;\n\n          if ((a | 0) >= (n | 0)) {\n            d = 22;\n            break;\n          } else { d = l; }\n        }\n\n        if ((d | 0) == 22) { return c | 0; }\n      }\n\n      return 0;\n    }\n\n    function vc(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0.0,\n          f = 0.0,\n          g = 0.0,\n          h = 0.0,\n          i = 0.0,\n          j = 0.0,\n          k = 0.0,\n          l = 0.0,\n          m = 0.0,\n          n = 0,\n          o = 0,\n          p = 0,\n          r = 0,\n          s = 0,\n          t = 0,\n          u = 0,\n          v = 0;\n      r = b[a >> 2] | 0;\n\n      if (!r) {\n        b[c >> 2] = 0;\n        b[c + 4 >> 2] = 0;\n        b[c + 8 >> 2] = 0;\n        b[c + 12 >> 2] = 0;\n        b[c + 16 >> 2] = 0;\n        b[c + 20 >> 2] = 0;\n        b[c + 24 >> 2] = 0;\n        b[c + 28 >> 2] = 0;\n        return;\n      }\n\n      s = c + 8 | 0;\n      e[s >> 3] = 1797693134862315708145274.0e284;\n      t = c + 24 | 0;\n      e[t >> 3] = 1797693134862315708145274.0e284;\n      e[c >> 3] = -1797693134862315708145274.0e284;\n      u = c + 16 | 0;\n      e[u >> 3] = -1797693134862315708145274.0e284;\n      if ((r | 0) <= 0) { return; }\n      o = b[a + 4 >> 2] | 0;\n      l = 1797693134862315708145274.0e284;\n      m = -1797693134862315708145274.0e284;\n      n = 0;\n      a = -1;\n      h = 1797693134862315708145274.0e284;\n      i = 1797693134862315708145274.0e284;\n      k = -1797693134862315708145274.0e284;\n      f = -1797693134862315708145274.0e284;\n      p = 0;\n\n      while (1) {\n        d = +e[o + (p << 4) >> 3];\n        j = +e[o + (p << 4) + 8 >> 3];\n        a = a + 2 | 0;\n        g = +e[o + (((a | 0) == (r | 0) ? 0 : a) << 4) + 8 >> 3];\n\n        if (d < h) {\n          e[s >> 3] = d;\n          h = d;\n        }\n\n        if (j < i) {\n          e[t >> 3] = j;\n          i = j;\n        }\n\n        if (d > k) { e[c >> 3] = d; }else { d = k; }\n\n        if (j > f) {\n          e[u >> 3] = j;\n          f = j;\n        }\n\n        l = j > 0.0 & j < l ? j : l;\n        m = j < 0.0 & j > m ? j : m;\n        n = n | +q(+(j - g)) > 3.141592653589793;\n        a = p + 1 | 0;\n        if ((a | 0) == (r | 0)) { break; }else {\n          v = p;\n          k = d;\n          p = a;\n          a = v;\n        }\n      }\n\n      if (!n) { return; }\n      e[u >> 3] = m;\n      e[t >> 3] = l;\n      return;\n    }\n\n    function wc(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          f = 0,\n          g = 0,\n          h = 0.0,\n          i = 0.0,\n          j = 0.0,\n          k = 0.0,\n          l = 0.0,\n          m = 0.0,\n          n = 0.0,\n          o = 0.0,\n          p = 0.0,\n          r = 0,\n          s = 0,\n          t = 0,\n          u = 0,\n          v = 0,\n          w = 0,\n          x = 0,\n          y = 0,\n          z = 0,\n          A = 0;\n      r = b[a >> 2] | 0;\n\n      if (r) {\n        s = c + 8 | 0;\n        e[s >> 3] = 1797693134862315708145274.0e284;\n        t = c + 24 | 0;\n        e[t >> 3] = 1797693134862315708145274.0e284;\n        e[c >> 3] = -1797693134862315708145274.0e284;\n        u = c + 16 | 0;\n        e[u >> 3] = -1797693134862315708145274.0e284;\n\n        if ((r | 0) > 0) {\n          g = b[a + 4 >> 2] | 0;\n          o = 1797693134862315708145274.0e284;\n          p = -1797693134862315708145274.0e284;\n          f = 0;\n          d = -1;\n          k = 1797693134862315708145274.0e284;\n          l = 1797693134862315708145274.0e284;\n          n = -1797693134862315708145274.0e284;\n          i = -1797693134862315708145274.0e284;\n          v = 0;\n\n          while (1) {\n            h = +e[g + (v << 4) >> 3];\n            m = +e[g + (v << 4) + 8 >> 3];\n            z = d + 2 | 0;\n            j = +e[g + (((z | 0) == (r | 0) ? 0 : z) << 4) + 8 >> 3];\n\n            if (h < k) {\n              e[s >> 3] = h;\n              k = h;\n            }\n\n            if (m < l) {\n              e[t >> 3] = m;\n              l = m;\n            }\n\n            if (h > n) { e[c >> 3] = h; }else { h = n; }\n\n            if (m > i) {\n              e[u >> 3] = m;\n              i = m;\n            }\n\n            o = m > 0.0 & m < o ? m : o;\n            p = m < 0.0 & m > p ? m : p;\n            f = f | +q(+(m - j)) > 3.141592653589793;\n            d = v + 1 | 0;\n            if ((d | 0) == (r | 0)) { break; }else {\n              z = v;\n              n = h;\n              v = d;\n              d = z;\n            }\n          }\n\n          if (f) {\n            e[u >> 3] = p;\n            e[t >> 3] = o;\n          }\n        }\n      } else {\n        b[c >> 2] = 0;\n        b[c + 4 >> 2] = 0;\n        b[c + 8 >> 2] = 0;\n        b[c + 12 >> 2] = 0;\n        b[c + 16 >> 2] = 0;\n        b[c + 20 >> 2] = 0;\n        b[c + 24 >> 2] = 0;\n        b[c + 28 >> 2] = 0;\n      }\n\n      z = a + 8 | 0;\n      d = b[z >> 2] | 0;\n      if ((d | 0) <= 0) { return; }\n      y = a + 12 | 0;\n      x = 0;\n\n      do {\n        g = b[y >> 2] | 0;\n        f = x;\n        x = x + 1 | 0;\n        t = c + (x << 5) | 0;\n        u = b[g + (f << 3) >> 2] | 0;\n\n        if (u) {\n          v = c + (x << 5) + 8 | 0;\n          e[v >> 3] = 1797693134862315708145274.0e284;\n          a = c + (x << 5) + 24 | 0;\n          e[a >> 3] = 1797693134862315708145274.0e284;\n          e[t >> 3] = -1797693134862315708145274.0e284;\n          w = c + (x << 5) + 16 | 0;\n          e[w >> 3] = -1797693134862315708145274.0e284;\n\n          if ((u | 0) > 0) {\n            r = b[g + (f << 3) + 4 >> 2] | 0;\n            o = 1797693134862315708145274.0e284;\n            p = -1797693134862315708145274.0e284;\n            g = 0;\n            f = -1;\n            s = 0;\n            k = 1797693134862315708145274.0e284;\n            l = 1797693134862315708145274.0e284;\n            m = -1797693134862315708145274.0e284;\n            i = -1797693134862315708145274.0e284;\n\n            while (1) {\n              h = +e[r + (s << 4) >> 3];\n              n = +e[r + (s << 4) + 8 >> 3];\n              f = f + 2 | 0;\n              j = +e[r + (((f | 0) == (u | 0) ? 0 : f) << 4) + 8 >> 3];\n\n              if (h < k) {\n                e[v >> 3] = h;\n                k = h;\n              }\n\n              if (n < l) {\n                e[a >> 3] = n;\n                l = n;\n              }\n\n              if (h > m) { e[t >> 3] = h; }else { h = m; }\n\n              if (n > i) {\n                e[w >> 3] = n;\n                i = n;\n              }\n\n              o = n > 0.0 & n < o ? n : o;\n              p = n < 0.0 & n > p ? n : p;\n              g = g | +q(+(n - j)) > 3.141592653589793;\n              f = s + 1 | 0;\n              if ((f | 0) == (u | 0)) { break; }else {\n                A = s;\n                s = f;\n                m = h;\n                f = A;\n              }\n            }\n\n            if (g) {\n              e[w >> 3] = p;\n              e[a >> 3] = o;\n            }\n          }\n        } else {\n          b[t >> 2] = 0;\n          b[t + 4 >> 2] = 0;\n          b[t + 8 >> 2] = 0;\n          b[t + 12 >> 2] = 0;\n          b[t + 16 >> 2] = 0;\n          b[t + 20 >> 2] = 0;\n          b[t + 24 >> 2] = 0;\n          b[t + 28 >> 2] = 0;\n          d = b[z >> 2] | 0;\n        }\n      } while ((x | 0) < (d | 0));\n\n      return;\n    }\n\n    function xc(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0,\n          g = 0;\n\n      if (!(uc(a, c, d) | 0)) {\n        f = 0;\n        return f | 0;\n      }\n\n      f = a + 8 | 0;\n\n      if ((b[f >> 2] | 0) <= 0) {\n        f = 1;\n        return f | 0;\n      }\n\n      e = a + 12 | 0;\n      a = 0;\n\n      while (1) {\n        g = a;\n        a = a + 1 | 0;\n\n        if (uc((b[e >> 2] | 0) + (g << 3) | 0, c + (a << 5) | 0, d) | 0) {\n          a = 0;\n          e = 6;\n          break;\n        }\n\n        if ((a | 0) >= (b[f >> 2] | 0)) {\n          a = 1;\n          e = 6;\n          break;\n        }\n      }\n\n      if ((e | 0) == 6) { return a | 0; }\n      return 0;\n    }\n\n    function yc() {\n      return 8;\n    }\n\n    function zc() {\n      return 16;\n    }\n\n    function Ac() {\n      return 168;\n    }\n\n    function Bc() {\n      return 8;\n    }\n\n    function Cc() {\n      return 16;\n    }\n\n    function Dc() {\n      return 12;\n    }\n\n    function Ec() {\n      return 8;\n    }\n\n    function Fc(a) {\n      a = a | 0;\n      var b = 0.0,\n          c = 0.0;\n      c = +e[a >> 3];\n      b = +e[a + 8 >> 3];\n      return + +r(+(c * c + b * b));\n    }\n\n    function Gc(a, b, c, d, f) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      d = d | 0;\n      f = f | 0;\n      var g = 0.0,\n          h = 0.0,\n          i = 0.0,\n          j = 0.0,\n          k = 0.0,\n          l = 0.0,\n          m = 0.0,\n          n = 0.0;\n      k = +e[a >> 3];\n      j = +e[b >> 3] - k;\n      i = +e[a + 8 >> 3];\n      h = +e[b + 8 >> 3] - i;\n      m = +e[c >> 3];\n      g = +e[d >> 3] - m;\n      n = +e[c + 8 >> 3];\n      l = +e[d + 8 >> 3] - n;\n      g = (g * (i - n) - (k - m) * l) / (j * l - h * g);\n      e[f >> 3] = k + j * g;\n      e[f + 8 >> 3] = i + h * g;\n      return;\n    }\n\n    function Hc(a, b) {\n      a = a | 0;\n      b = b | 0;\n\n      if (!(+e[a >> 3] == +e[b >> 3])) {\n        b = 0;\n        return b | 0;\n      }\n\n      b = +e[a + 8 >> 3] == +e[b + 8 >> 3];\n      return b | 0;\n    }\n\n    function Ic(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0.0,\n          d = 0.0,\n          f = 0.0;\n      f = +e[a >> 3] - +e[b >> 3];\n      d = +e[a + 8 >> 3] - +e[b + 8 >> 3];\n      c = +e[a + 16 >> 3] - +e[b + 16 >> 3];\n      return +(f * f + d * d + c * c);\n    }\n\n    function Jc(a, b) {\n      a = a | 0;\n      b = b | 0;\n      var c = 0.0,\n          d = 0.0,\n          f = 0.0;\n      c = +e[a >> 3];\n      d = +t(+c);\n      c = +u(+c);\n      e[b + 16 >> 3] = c;\n      c = +e[a + 8 >> 3];\n      f = d * +t(+c);\n      e[b >> 3] = f;\n      c = d * +u(+c);\n      e[b + 8 >> 3] = c;\n      return;\n    }\n\n    function Kc(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0;\n      k = S;\n      S = S + 32 | 0;\n      f = k + 16 | 0;\n      g = k;\n      Ub(a, c, f);\n      h = Ab(a, c) | 0;\n      j = Lb(a, c) | 0;\n      pa(h, g);\n      c = qa(h, b[f >> 2] | 0) | 0;\n\n      if (!(la(h) | 0)) {\n        j = c;\n        S = k;\n        return j | 0;\n      }\n\n      do { switch (h | 0) {\n        case 4:\n          {\n            a = 0;\n            d = 14;\n            break;\n          }\n\n        case 14:\n          {\n            a = 1;\n            d = 14;\n            break;\n          }\n\n        case 24:\n          {\n            a = 2;\n            d = 14;\n            break;\n          }\n\n        case 38:\n          {\n            a = 3;\n            d = 14;\n            break;\n          }\n\n        case 49:\n          {\n            a = 4;\n            d = 14;\n            break;\n          }\n\n        case 58:\n          {\n            a = 5;\n            d = 14;\n            break;\n          }\n\n        case 63:\n          {\n            a = 6;\n            d = 14;\n            break;\n          }\n\n        case 72:\n          {\n            a = 7;\n            d = 14;\n            break;\n          }\n\n        case 83:\n          {\n            a = 8;\n            d = 14;\n            break;\n          }\n\n        case 97:\n          {\n            a = 9;\n            d = 14;\n            break;\n          }\n\n        case 107:\n          {\n            a = 10;\n            d = 14;\n            break;\n          }\n\n        case 117:\n          {\n            a = 11;\n            d = 14;\n            break;\n          }\n\n        default:\n          {\n            i = 0;\n            e = 0;\n          }\n      } } while (0);\n\n      if ((d | 0) == 14) {\n        i = b[22096 + (a * 24 | 0) + 8 >> 2] | 0;\n        e = b[22096 + (a * 24 | 0) + 16 >> 2] | 0;\n      }\n\n      a = b[f >> 2] | 0;\n\n      if ((a | 0) != (b[g >> 2] | 0)) {\n        h = ma(h) | 0;\n        a = b[f >> 2] | 0;\n        if (h | (a | 0) == (e | 0)) { c = (c + 1 | 0) % 6 | 0; }\n      }\n\n      if ((j | 0) == 3 & (a | 0) == (e | 0)) {\n        j = (c + 5 | 0) % 6 | 0;\n        S = k;\n        return j | 0;\n      }\n\n      if (!((j | 0) == 5 & (a | 0) == (i | 0))) {\n        j = c;\n        S = k;\n        return j | 0;\n      }\n\n      j = (c + 1 | 0) % 6 | 0;\n      S = k;\n      return j | 0;\n    }\n\n    function Lc(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0,\n          f = 0;\n      e = Fb(a, c) | 0;\n\n      if ((d + -1 | 0) >>> 0 > 5) {\n        d = -1;\n        return d | 0;\n      }\n\n      f = (e | 0) != 0;\n\n      if ((d | 0) == 1 & f) {\n        d = -1;\n        return d | 0;\n      }\n\n      e = Kc(a, c) | 0;\n\n      if (f) {\n        d = (5 - e + (b[22384 + (d << 2) >> 2] | 0) | 0) % 5 | 0;\n        return d | 0;\n      } else {\n        d = (6 - e + (b[22416 + (d << 2) >> 2] | 0) | 0) % 6 | 0;\n        return d | 0;\n      }\n\n      return 0;\n    }\n\n    function Mc(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var e = 0;\n\n      if ((c | 0) > 0) {\n        e = Yc(c, 4) | 0;\n        b[a >> 2] = e;\n        if (!e) { H(23230, 23253, 40, 23267); }\n      } else { b[a >> 2] = 0; }\n\n      b[a + 4 >> 2] = c;\n      b[a + 8 >> 2] = 0;\n      b[a + 12 >> 2] = d;\n      return;\n    }\n\n    function Nc(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0;\n      g = a + 4 | 0;\n      h = a + 12 | 0;\n      i = a + 8 | 0;\n\n      a: while (1) {\n        d = b[g >> 2] | 0;\n        c = 0;\n\n        while (1) {\n          if ((c | 0) >= (d | 0)) { break a; }\n          f = b[a >> 2] | 0;\n          j = b[f + (c << 2) >> 2] | 0;\n          if (!j) { c = c + 1 | 0; }else { break; }\n        }\n\n        c = f + (~~(+q(+(+s(10.0, + +(15 - (b[h >> 2] | 0) | 0)) * (+e[j >> 3] + +e[j + 8 >> 3]))) % +(d | 0)) >>> 0 << 2) | 0;\n        d = b[c >> 2] | 0;\n\n        b: do { if (d | 0) {\n          f = j + 32 | 0;\n          if ((d | 0) == (j | 0)) { b[c >> 2] = b[f >> 2]; }else {\n            d = d + 32 | 0;\n            c = b[d >> 2] | 0;\n            if (!c) { break; }\n\n            while (1) {\n              if ((c | 0) == (j | 0)) { break; }\n              d = c + 32 | 0;\n              c = b[d >> 2] | 0;\n              if (!c) { break b; }\n            }\n\n            b[d >> 2] = b[f >> 2];\n          }\n          Xc(j);\n          b[i >> 2] = (b[i >> 2] | 0) + -1;\n        } } while (0);\n      }\n\n      Xc(b[a >> 2] | 0);\n      return;\n    }\n\n    function Oc(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0;\n      e = b[a + 4 >> 2] | 0;\n      d = 0;\n\n      while (1) {\n        if ((d | 0) >= (e | 0)) {\n          c = 0;\n          d = 4;\n          break;\n        }\n\n        c = b[(b[a >> 2] | 0) + (d << 2) >> 2] | 0;\n        if (!c) { d = d + 1 | 0; }else {\n          d = 4;\n          break;\n        }\n      }\n\n      if ((d | 0) == 4) { return c | 0; }\n      return 0;\n    }\n\n    function Pc(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0,\n          f = 0,\n          g = 0,\n          h = 0;\n      d = ~~(+q(+(+s(10.0, + +(15 - (b[a + 12 >> 2] | 0) | 0)) * (+e[c >> 3] + +e[c + 8 >> 3]))) % +(b[a + 4 >> 2] | 0)) >>> 0;\n      d = (b[a >> 2] | 0) + (d << 2) | 0;\n      f = b[d >> 2] | 0;\n\n      if (!f) {\n        h = 1;\n        return h | 0;\n      }\n\n      h = c + 32 | 0;\n\n      do { if ((f | 0) != (c | 0)) {\n        d = b[f + 32 >> 2] | 0;\n\n        if (!d) {\n          h = 1;\n          return h | 0;\n        }\n\n        g = d;\n\n        while (1) {\n          if ((g | 0) == (c | 0)) {\n            g = 8;\n            break;\n          }\n\n          d = b[g + 32 >> 2] | 0;\n\n          if (!d) {\n            d = 1;\n            g = 10;\n            break;\n          } else {\n            f = g;\n            g = d;\n          }\n        }\n\n        if ((g | 0) == 8) {\n          b[f + 32 >> 2] = b[h >> 2];\n          break;\n        } else if ((g | 0) == 10) { return d | 0; }\n      } else { b[d >> 2] = b[h >> 2]; } } while (0);\n\n      Xc(c);\n      h = a + 8 | 0;\n      b[h >> 2] = (b[h >> 2] | 0) + -1;\n      h = 0;\n      return h | 0;\n    }\n\n    function Qc(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      h = Wc(40) | 0;\n      if (!h) { H(23283, 23253, 98, 23296); }\n      b[h >> 2] = b[c >> 2];\n      b[h + 4 >> 2] = b[c + 4 >> 2];\n      b[h + 8 >> 2] = b[c + 8 >> 2];\n      b[h + 12 >> 2] = b[c + 12 >> 2];\n      g = h + 16 | 0;\n      b[g >> 2] = b[d >> 2];\n      b[g + 4 >> 2] = b[d + 4 >> 2];\n      b[g + 8 >> 2] = b[d + 8 >> 2];\n      b[g + 12 >> 2] = b[d + 12 >> 2];\n      b[h + 32 >> 2] = 0;\n      g = ~~(+q(+(+s(10.0, + +(15 - (b[a + 12 >> 2] | 0) | 0)) * (+e[c >> 3] + +e[c + 8 >> 3]))) % +(b[a + 4 >> 2] | 0)) >>> 0;\n      g = (b[a >> 2] | 0) + (g << 2) | 0;\n      f = b[g >> 2] | 0;\n\n      do { if (!f) { b[g >> 2] = h; }else {\n        while (1) {\n          if (hb(f, c) | 0 ? hb(f + 16 | 0, d) | 0 : 0) { break; }\n          g = b[f + 32 >> 2] | 0;\n          f = (g | 0) == 0 ? f : g;\n\n          if (!(b[f + 32 >> 2] | 0)) {\n            i = 10;\n            break;\n          }\n        }\n\n        if ((i | 0) == 10) {\n          b[f + 32 >> 2] = h;\n          break;\n        }\n\n        Xc(h);\n        i = f;\n        return i | 0;\n      } } while (0);\n\n      i = a + 8 | 0;\n      b[i >> 2] = (b[i >> 2] | 0) + 1;\n      i = h;\n      return i | 0;\n    }\n\n    function Rc(a, c, d) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      var f = 0,\n          g = 0;\n      g = ~~(+q(+(+s(10.0, + +(15 - (b[a + 12 >> 2] | 0) | 0)) * (+e[c >> 3] + +e[c + 8 >> 3]))) % +(b[a + 4 >> 2] | 0)) >>> 0;\n      g = b[(b[a >> 2] | 0) + (g << 2) >> 2] | 0;\n\n      if (!g) {\n        d = 0;\n        return d | 0;\n      }\n\n      if (!d) {\n        a = g;\n\n        while (1) {\n          if (hb(a, c) | 0) {\n            f = 10;\n            break;\n          }\n\n          a = b[a + 32 >> 2] | 0;\n\n          if (!a) {\n            a = 0;\n            f = 10;\n            break;\n          }\n        }\n\n        if ((f | 0) == 10) { return a | 0; }\n      }\n\n      a = g;\n\n      while (1) {\n        if (hb(a, c) | 0 ? hb(a + 16 | 0, d) | 0 : 0) {\n          f = 10;\n          break;\n        }\n\n        a = b[a + 32 >> 2] | 0;\n\n        if (!a) {\n          a = 0;\n          f = 10;\n          break;\n        }\n      }\n\n      if ((f | 0) == 10) { return a | 0; }\n      return 0;\n    }\n\n    function Sc(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0;\n      d = ~~(+q(+(+s(10.0, + +(15 - (b[a + 12 >> 2] | 0) | 0)) * (+e[c >> 3] + +e[c + 8 >> 3]))) % +(b[a + 4 >> 2] | 0)) >>> 0;\n      a = b[(b[a >> 2] | 0) + (d << 2) >> 2] | 0;\n\n      if (!a) {\n        d = 0;\n        return d | 0;\n      }\n\n      while (1) {\n        if (hb(a, c) | 0) {\n          c = 5;\n          break;\n        }\n\n        a = b[a + 32 >> 2] | 0;\n\n        if (!a) {\n          a = 0;\n          c = 5;\n          break;\n        }\n      }\n\n      if ((c | 0) == 5) { return a | 0; }\n      return 0;\n    }\n\n    function Tc() {\n      return 23312;\n    }\n\n    function Uc(a) {\n      a = +a;\n      return + +id(+a);\n    }\n\n    function Vc(a) {\n      a = +a;\n      return ~~+Uc(a) | 0;\n    }\n\n    function Wc(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0,\n          p = 0,\n          q = 0,\n          r = 0,\n          s = 0,\n          t = 0,\n          u = 0,\n          v = 0,\n          w = 0;\n      w = S;\n      S = S + 16 | 0;\n      n = w;\n\n      do { if (a >>> 0 < 245) {\n        k = a >>> 0 < 11 ? 16 : a + 11 & -8;\n        a = k >>> 3;\n        m = b[5829] | 0;\n        d = m >>> a;\n\n        if (d & 3 | 0) {\n          c = (d & 1 ^ 1) + a | 0;\n          a = 23356 + (c << 1 << 2) | 0;\n          d = a + 8 | 0;\n          e = b[d >> 2] | 0;\n          f = e + 8 | 0;\n          g = b[f >> 2] | 0;\n          if ((g | 0) == (a | 0)) { b[5829] = m & ~(1 << c); }else {\n            b[g + 12 >> 2] = a;\n            b[d >> 2] = g;\n          }\n          v = c << 3;\n          b[e + 4 >> 2] = v | 3;\n          v = e + v + 4 | 0;\n          b[v >> 2] = b[v >> 2] | 1;\n          v = f;\n          S = w;\n          return v | 0;\n        }\n\n        l = b[5831] | 0;\n\n        if (k >>> 0 > l >>> 0) {\n          if (d | 0) {\n            c = 2 << a;\n            c = d << a & (c | 0 - c);\n            c = (c & 0 - c) + -1 | 0;\n            i = c >>> 12 & 16;\n            c = c >>> i;\n            d = c >>> 5 & 8;\n            c = c >>> d;\n            g = c >>> 2 & 4;\n            c = c >>> g;\n            a = c >>> 1 & 2;\n            c = c >>> a;\n            e = c >>> 1 & 1;\n            e = (d | i | g | a | e) + (c >>> e) | 0;\n            c = 23356 + (e << 1 << 2) | 0;\n            a = c + 8 | 0;\n            g = b[a >> 2] | 0;\n            i = g + 8 | 0;\n            d = b[i >> 2] | 0;\n\n            if ((d | 0) == (c | 0)) {\n              a = m & ~(1 << e);\n              b[5829] = a;\n            } else {\n              b[d + 12 >> 2] = c;\n              b[a >> 2] = d;\n              a = m;\n            }\n\n            v = e << 3;\n            h = v - k | 0;\n            b[g + 4 >> 2] = k | 3;\n            f = g + k | 0;\n            b[f + 4 >> 2] = h | 1;\n            b[g + v >> 2] = h;\n\n            if (l | 0) {\n              e = b[5834] | 0;\n              c = l >>> 3;\n              d = 23356 + (c << 1 << 2) | 0;\n              c = 1 << c;\n\n              if (!(a & c)) {\n                b[5829] = a | c;\n                c = d;\n                a = d + 8 | 0;\n              } else {\n                a = d + 8 | 0;\n                c = b[a >> 2] | 0;\n              }\n\n              b[a >> 2] = e;\n              b[c + 12 >> 2] = e;\n              b[e + 8 >> 2] = c;\n              b[e + 12 >> 2] = d;\n            }\n\n            b[5831] = h;\n            b[5834] = f;\n            v = i;\n            S = w;\n            return v | 0;\n          }\n\n          g = b[5830] | 0;\n\n          if (g) {\n            d = (g & 0 - g) + -1 | 0;\n            f = d >>> 12 & 16;\n            d = d >>> f;\n            e = d >>> 5 & 8;\n            d = d >>> e;\n            h = d >>> 2 & 4;\n            d = d >>> h;\n            i = d >>> 1 & 2;\n            d = d >>> i;\n            j = d >>> 1 & 1;\n            j = b[23620 + ((e | f | h | i | j) + (d >>> j) << 2) >> 2] | 0;\n            d = j;\n            i = j;\n            j = (b[j + 4 >> 2] & -8) - k | 0;\n\n            while (1) {\n              a = b[d + 16 >> 2] | 0;\n\n              if (!a) {\n                a = b[d + 20 >> 2] | 0;\n                if (!a) { break; }\n              }\n\n              h = (b[a + 4 >> 2] & -8) - k | 0;\n              f = h >>> 0 < j >>> 0;\n              d = a;\n              i = f ? a : i;\n              j = f ? h : j;\n            }\n\n            h = i + k | 0;\n\n            if (h >>> 0 > i >>> 0) {\n              f = b[i + 24 >> 2] | 0;\n              c = b[i + 12 >> 2] | 0;\n\n              do { if ((c | 0) == (i | 0)) {\n                a = i + 20 | 0;\n                c = b[a >> 2] | 0;\n\n                if (!c) {\n                  a = i + 16 | 0;\n                  c = b[a >> 2] | 0;\n\n                  if (!c) {\n                    d = 0;\n                    break;\n                  }\n                }\n\n                while (1) {\n                  e = c + 20 | 0;\n                  d = b[e >> 2] | 0;\n\n                  if (!d) {\n                    e = c + 16 | 0;\n                    d = b[e >> 2] | 0;\n                    if (!d) { break; }else {\n                      c = d;\n                      a = e;\n                    }\n                  } else {\n                    c = d;\n                    a = e;\n                  }\n                }\n\n                b[a >> 2] = 0;\n                d = c;\n              } else {\n                d = b[i + 8 >> 2] | 0;\n                b[d + 12 >> 2] = c;\n                b[c + 8 >> 2] = d;\n                d = c;\n              } } while (0);\n\n              do { if (f | 0) {\n                c = b[i + 28 >> 2] | 0;\n                a = 23620 + (c << 2) | 0;\n\n                if ((i | 0) == (b[a >> 2] | 0)) {\n                  b[a >> 2] = d;\n\n                  if (!d) {\n                    b[5830] = g & ~(1 << c);\n                    break;\n                  }\n                } else {\n                  v = f + 16 | 0;\n                  b[((b[v >> 2] | 0) == (i | 0) ? v : f + 20 | 0) >> 2] = d;\n                  if (!d) { break; }\n                }\n\n                b[d + 24 >> 2] = f;\n                c = b[i + 16 >> 2] | 0;\n\n                if (c | 0) {\n                  b[d + 16 >> 2] = c;\n                  b[c + 24 >> 2] = d;\n                }\n\n                c = b[i + 20 >> 2] | 0;\n\n                if (c | 0) {\n                  b[d + 20 >> 2] = c;\n                  b[c + 24 >> 2] = d;\n                }\n              } } while (0);\n\n              if (j >>> 0 < 16) {\n                v = j + k | 0;\n                b[i + 4 >> 2] = v | 3;\n                v = i + v + 4 | 0;\n                b[v >> 2] = b[v >> 2] | 1;\n              } else {\n                b[i + 4 >> 2] = k | 3;\n                b[h + 4 >> 2] = j | 1;\n                b[h + j >> 2] = j;\n\n                if (l | 0) {\n                  e = b[5834] | 0;\n                  c = l >>> 3;\n                  d = 23356 + (c << 1 << 2) | 0;\n                  c = 1 << c;\n\n                  if (!(c & m)) {\n                    b[5829] = c | m;\n                    c = d;\n                    a = d + 8 | 0;\n                  } else {\n                    a = d + 8 | 0;\n                    c = b[a >> 2] | 0;\n                  }\n\n                  b[a >> 2] = e;\n                  b[c + 12 >> 2] = e;\n                  b[e + 8 >> 2] = c;\n                  b[e + 12 >> 2] = d;\n                }\n\n                b[5831] = j;\n                b[5834] = h;\n              }\n\n              v = i + 8 | 0;\n              S = w;\n              return v | 0;\n            } else { m = k; }\n          } else { m = k; }\n        } else { m = k; }\n      } else if (a >>> 0 <= 4294967231) {\n        a = a + 11 | 0;\n        k = a & -8;\n        e = b[5830] | 0;\n\n        if (e) {\n          f = 0 - k | 0;\n          a = a >>> 8;\n          if (a) {\n            if (k >>> 0 > 16777215) { j = 31; }else {\n              m = (a + 1048320 | 0) >>> 16 & 8;\n              q = a << m;\n              i = (q + 520192 | 0) >>> 16 & 4;\n              q = q << i;\n              j = (q + 245760 | 0) >>> 16 & 2;\n              j = 14 - (i | m | j) + (q << j >>> 15) | 0;\n              j = k >>> (j + 7 | 0) & 1 | j << 1;\n            }\n          } else { j = 0; }\n          d = b[23620 + (j << 2) >> 2] | 0;\n\n          a: do { if (!d) {\n            d = 0;\n            a = 0;\n            q = 61;\n          } else {\n            a = 0;\n            i = k << ((j | 0) == 31 ? 0 : 25 - (j >>> 1) | 0);\n            g = 0;\n\n            while (1) {\n              h = (b[d + 4 >> 2] & -8) - k | 0;\n              if (h >>> 0 < f >>> 0) { if (!h) {\n                a = d;\n                f = 0;\n                q = 65;\n                break a;\n              } else {\n                a = d;\n                f = h;\n              } }\n              q = b[d + 20 >> 2] | 0;\n              d = b[d + 16 + (i >>> 31 << 2) >> 2] | 0;\n              g = (q | 0) == 0 | (q | 0) == (d | 0) ? g : q;\n\n              if (!d) {\n                d = g;\n                q = 61;\n                break;\n              } else { i = i << 1; }\n            }\n          } } while (0);\n\n          if ((q | 0) == 61) {\n            if ((d | 0) == 0 & (a | 0) == 0) {\n              a = 2 << j;\n              a = (a | 0 - a) & e;\n\n              if (!a) {\n                m = k;\n                break;\n              }\n\n              m = (a & 0 - a) + -1 | 0;\n              h = m >>> 12 & 16;\n              m = m >>> h;\n              g = m >>> 5 & 8;\n              m = m >>> g;\n              i = m >>> 2 & 4;\n              m = m >>> i;\n              j = m >>> 1 & 2;\n              m = m >>> j;\n              d = m >>> 1 & 1;\n              a = 0;\n              d = b[23620 + ((g | h | i | j | d) + (m >>> d) << 2) >> 2] | 0;\n            }\n\n            if (!d) {\n              i = a;\n              h = f;\n            } else { q = 65; }\n          }\n\n          if ((q | 0) == 65) {\n            g = d;\n\n            while (1) {\n              m = (b[g + 4 >> 2] & -8) - k | 0;\n              d = m >>> 0 < f >>> 0;\n              f = d ? m : f;\n              a = d ? g : a;\n              d = b[g + 16 >> 2] | 0;\n              if (!d) { d = b[g + 20 >> 2] | 0; }\n\n              if (!d) {\n                i = a;\n                h = f;\n                break;\n              } else { g = d; }\n            }\n          }\n\n          if (((i | 0) != 0 ? h >>> 0 < ((b[5831] | 0) - k | 0) >>> 0 : 0) ? (l = i + k | 0, l >>> 0 > i >>> 0) : 0) {\n            g = b[i + 24 >> 2] | 0;\n            c = b[i + 12 >> 2] | 0;\n\n            do { if ((c | 0) == (i | 0)) {\n              a = i + 20 | 0;\n              c = b[a >> 2] | 0;\n\n              if (!c) {\n                a = i + 16 | 0;\n                c = b[a >> 2] | 0;\n\n                if (!c) {\n                  c = 0;\n                  break;\n                }\n              }\n\n              while (1) {\n                f = c + 20 | 0;\n                d = b[f >> 2] | 0;\n\n                if (!d) {\n                  f = c + 16 | 0;\n                  d = b[f >> 2] | 0;\n                  if (!d) { break; }else {\n                    c = d;\n                    a = f;\n                  }\n                } else {\n                  c = d;\n                  a = f;\n                }\n              }\n\n              b[a >> 2] = 0;\n            } else {\n              v = b[i + 8 >> 2] | 0;\n              b[v + 12 >> 2] = c;\n              b[c + 8 >> 2] = v;\n            } } while (0);\n\n            do { if (g) {\n              a = b[i + 28 >> 2] | 0;\n              d = 23620 + (a << 2) | 0;\n\n              if ((i | 0) == (b[d >> 2] | 0)) {\n                b[d >> 2] = c;\n\n                if (!c) {\n                  e = e & ~(1 << a);\n                  b[5830] = e;\n                  break;\n                }\n              } else {\n                v = g + 16 | 0;\n                b[((b[v >> 2] | 0) == (i | 0) ? v : g + 20 | 0) >> 2] = c;\n                if (!c) { break; }\n              }\n\n              b[c + 24 >> 2] = g;\n              a = b[i + 16 >> 2] | 0;\n\n              if (a | 0) {\n                b[c + 16 >> 2] = a;\n                b[a + 24 >> 2] = c;\n              }\n\n              a = b[i + 20 >> 2] | 0;\n\n              if (a) {\n                b[c + 20 >> 2] = a;\n                b[a + 24 >> 2] = c;\n              }\n            } } while (0);\n\n            b: do { if (h >>> 0 < 16) {\n              v = h + k | 0;\n              b[i + 4 >> 2] = v | 3;\n              v = i + v + 4 | 0;\n              b[v >> 2] = b[v >> 2] | 1;\n            } else {\n              b[i + 4 >> 2] = k | 3;\n              b[l + 4 >> 2] = h | 1;\n              b[l + h >> 2] = h;\n              c = h >>> 3;\n\n              if (h >>> 0 < 256) {\n                d = 23356 + (c << 1 << 2) | 0;\n                a = b[5829] | 0;\n                c = 1 << c;\n\n                if (!(a & c)) {\n                  b[5829] = a | c;\n                  c = d;\n                  a = d + 8 | 0;\n                } else {\n                  a = d + 8 | 0;\n                  c = b[a >> 2] | 0;\n                }\n\n                b[a >> 2] = l;\n                b[c + 12 >> 2] = l;\n                b[l + 8 >> 2] = c;\n                b[l + 12 >> 2] = d;\n                break;\n              }\n\n              c = h >>> 8;\n              if (c) {\n                if (h >>> 0 > 16777215) { d = 31; }else {\n                  u = (c + 1048320 | 0) >>> 16 & 8;\n                  v = c << u;\n                  t = (v + 520192 | 0) >>> 16 & 4;\n                  v = v << t;\n                  d = (v + 245760 | 0) >>> 16 & 2;\n                  d = 14 - (t | u | d) + (v << d >>> 15) | 0;\n                  d = h >>> (d + 7 | 0) & 1 | d << 1;\n                }\n              } else { d = 0; }\n              c = 23620 + (d << 2) | 0;\n              b[l + 28 >> 2] = d;\n              a = l + 16 | 0;\n              b[a + 4 >> 2] = 0;\n              b[a >> 2] = 0;\n              a = 1 << d;\n\n              if (!(e & a)) {\n                b[5830] = e | a;\n                b[c >> 2] = l;\n                b[l + 24 >> 2] = c;\n                b[l + 12 >> 2] = l;\n                b[l + 8 >> 2] = l;\n                break;\n              }\n\n              c = b[c >> 2] | 0;\n\n              c: do { if ((b[c + 4 >> 2] & -8 | 0) != (h | 0)) {\n                e = h << ((d | 0) == 31 ? 0 : 25 - (d >>> 1) | 0);\n\n                while (1) {\n                  d = c + 16 + (e >>> 31 << 2) | 0;\n                  a = b[d >> 2] | 0;\n                  if (!a) { break; }\n\n                  if ((b[a + 4 >> 2] & -8 | 0) == (h | 0)) {\n                    c = a;\n                    break c;\n                  } else {\n                    e = e << 1;\n                    c = a;\n                  }\n                }\n\n                b[d >> 2] = l;\n                b[l + 24 >> 2] = c;\n                b[l + 12 >> 2] = l;\n                b[l + 8 >> 2] = l;\n                break b;\n              } } while (0);\n\n              u = c + 8 | 0;\n              v = b[u >> 2] | 0;\n              b[v + 12 >> 2] = l;\n              b[u >> 2] = l;\n              b[l + 8 >> 2] = v;\n              b[l + 12 >> 2] = c;\n              b[l + 24 >> 2] = 0;\n            } } while (0);\n\n            v = i + 8 | 0;\n            S = w;\n            return v | 0;\n          } else { m = k; }\n        } else { m = k; }\n      } else { m = -1; } } while (0);\n\n      d = b[5831] | 0;\n\n      if (d >>> 0 >= m >>> 0) {\n        c = d - m | 0;\n        a = b[5834] | 0;\n\n        if (c >>> 0 > 15) {\n          v = a + m | 0;\n          b[5834] = v;\n          b[5831] = c;\n          b[v + 4 >> 2] = c | 1;\n          b[a + d >> 2] = c;\n          b[a + 4 >> 2] = m | 3;\n        } else {\n          b[5831] = 0;\n          b[5834] = 0;\n          b[a + 4 >> 2] = d | 3;\n          v = a + d + 4 | 0;\n          b[v >> 2] = b[v >> 2] | 1;\n        }\n\n        v = a + 8 | 0;\n        S = w;\n        return v | 0;\n      }\n\n      h = b[5832] | 0;\n\n      if (h >>> 0 > m >>> 0) {\n        t = h - m | 0;\n        b[5832] = t;\n        v = b[5835] | 0;\n        u = v + m | 0;\n        b[5835] = u;\n        b[u + 4 >> 2] = t | 1;\n        b[v + 4 >> 2] = m | 3;\n        v = v + 8 | 0;\n        S = w;\n        return v | 0;\n      }\n\n      if (!(b[5947] | 0)) {\n        b[5949] = 4096;\n        b[5948] = 4096;\n        b[5950] = -1;\n        b[5951] = -1;\n        b[5952] = 0;\n        b[5940] = 0;\n        b[5947] = n & -16 ^ 1431655768;\n        a = 4096;\n      } else { a = b[5949] | 0; }\n\n      i = m + 48 | 0;\n      j = m + 47 | 0;\n      g = a + j | 0;\n      f = 0 - a | 0;\n      k = g & f;\n\n      if (k >>> 0 <= m >>> 0) {\n        v = 0;\n        S = w;\n        return v | 0;\n      }\n\n      a = b[5939] | 0;\n\n      if (a | 0 ? (l = b[5937] | 0, n = l + k | 0, n >>> 0 <= l >>> 0 | n >>> 0 > a >>> 0) : 0) {\n        v = 0;\n        S = w;\n        return v | 0;\n      }\n\n      d: do { if (!(b[5940] & 4)) {\n        d = b[5835] | 0;\n\n        e: do { if (d) {\n          e = 23764;\n\n          while (1) {\n            n = b[e >> 2] | 0;\n            if (n >>> 0 <= d >>> 0 ? (n + (b[e + 4 >> 2] | 0) | 0) >>> 0 > d >>> 0 : 0) { break; }\n            a = b[e + 8 >> 2] | 0;\n\n            if (!a) {\n              q = 128;\n              break e;\n            } else { e = a; }\n          }\n\n          c = g - h & f;\n\n          if (c >>> 0 < 2147483647) {\n            a = jd(c | 0) | 0;\n\n            if ((a | 0) == ((b[e >> 2] | 0) + (b[e + 4 >> 2] | 0) | 0)) {\n              if ((a | 0) != (-1 | 0)) {\n                h = c;\n                g = a;\n                q = 145;\n                break d;\n              }\n            } else {\n              e = a;\n              q = 136;\n            }\n          } else { c = 0; }\n        } else { q = 128; } } while (0);\n\n        do { if ((q | 0) == 128) {\n          d = jd(0) | 0;\n\n          if ((d | 0) != (-1 | 0) ? (c = d, o = b[5948] | 0, p = o + -1 | 0, c = ((p & c | 0) == 0 ? 0 : (p + c & 0 - o) - c | 0) + k | 0, o = b[5937] | 0, p = c + o | 0, c >>> 0 > m >>> 0 & c >>> 0 < 2147483647) : 0) {\n            n = b[5939] | 0;\n\n            if (n | 0 ? p >>> 0 <= o >>> 0 | p >>> 0 > n >>> 0 : 0) {\n              c = 0;\n              break;\n            }\n\n            a = jd(c | 0) | 0;\n\n            if ((a | 0) == (d | 0)) {\n              h = c;\n              g = d;\n              q = 145;\n              break d;\n            } else {\n              e = a;\n              q = 136;\n            }\n          } else { c = 0; }\n        } } while (0);\n\n        do { if ((q | 0) == 136) {\n          d = 0 - c | 0;\n          if (!(i >>> 0 > c >>> 0 & (c >>> 0 < 2147483647 & (e | 0) != (-1 | 0)))) { if ((e | 0) == (-1 | 0)) {\n            c = 0;\n            break;\n          } else {\n            h = c;\n            g = e;\n            q = 145;\n            break d;\n          } }\n          a = b[5949] | 0;\n          a = j - c + a & 0 - a;\n\n          if (a >>> 0 >= 2147483647) {\n            h = c;\n            g = e;\n            q = 145;\n            break d;\n          }\n\n          if ((jd(a | 0) | 0) == (-1 | 0)) {\n            jd(d | 0) | 0;\n            c = 0;\n            break;\n          } else {\n            h = a + c | 0;\n            g = e;\n            q = 145;\n            break d;\n          }\n        } } while (0);\n\n        b[5940] = b[5940] | 4;\n        q = 143;\n      } else {\n        c = 0;\n        q = 143;\n      } } while (0);\n\n      if (((q | 0) == 143 ? k >>> 0 < 2147483647 : 0) ? (t = jd(k | 0) | 0, p = jd(0) | 0, r = p - t | 0, s = r >>> 0 > (m + 40 | 0) >>> 0, !((t | 0) == (-1 | 0) | s ^ 1 | t >>> 0 < p >>> 0 & ((t | 0) != (-1 | 0) & (p | 0) != (-1 | 0)) ^ 1)) : 0) {\n        h = s ? r : c;\n        g = t;\n        q = 145;\n      }\n\n      if ((q | 0) == 145) {\n        c = (b[5937] | 0) + h | 0;\n        b[5937] = c;\n        if (c >>> 0 > (b[5938] | 0) >>> 0) { b[5938] = c; }\n        j = b[5835] | 0;\n\n        f: do { if (j) {\n          c = 23764;\n\n          while (1) {\n            a = b[c >> 2] | 0;\n            d = b[c + 4 >> 2] | 0;\n\n            if ((g | 0) == (a + d | 0)) {\n              q = 154;\n              break;\n            }\n\n            e = b[c + 8 >> 2] | 0;\n            if (!e) { break; }else { c = e; }\n          }\n\n          if (((q | 0) == 154 ? (u = c + 4 | 0, (b[c + 12 >> 2] & 8 | 0) == 0) : 0) ? g >>> 0 > j >>> 0 & a >>> 0 <= j >>> 0 : 0) {\n            b[u >> 2] = d + h;\n            v = (b[5832] | 0) + h | 0;\n            t = j + 8 | 0;\n            t = (t & 7 | 0) == 0 ? 0 : 0 - t & 7;\n            u = j + t | 0;\n            t = v - t | 0;\n            b[5835] = u;\n            b[5832] = t;\n            b[u + 4 >> 2] = t | 1;\n            b[j + v + 4 >> 2] = 40;\n            b[5836] = b[5951];\n            break;\n          }\n\n          if (g >>> 0 < (b[5833] | 0) >>> 0) { b[5833] = g; }\n          d = g + h | 0;\n          c = 23764;\n\n          while (1) {\n            if ((b[c >> 2] | 0) == (d | 0)) {\n              q = 162;\n              break;\n            }\n\n            a = b[c + 8 >> 2] | 0;\n            if (!a) { break; }else { c = a; }\n          }\n\n          if ((q | 0) == 162 ? (b[c + 12 >> 2] & 8 | 0) == 0 : 0) {\n            b[c >> 2] = g;\n            l = c + 4 | 0;\n            b[l >> 2] = (b[l >> 2] | 0) + h;\n            l = g + 8 | 0;\n            l = g + ((l & 7 | 0) == 0 ? 0 : 0 - l & 7) | 0;\n            c = d + 8 | 0;\n            c = d + ((c & 7 | 0) == 0 ? 0 : 0 - c & 7) | 0;\n            k = l + m | 0;\n            i = c - l - m | 0;\n            b[l + 4 >> 2] = m | 3;\n\n            g: do { if ((j | 0) == (c | 0)) {\n              v = (b[5832] | 0) + i | 0;\n              b[5832] = v;\n              b[5835] = k;\n              b[k + 4 >> 2] = v | 1;\n            } else {\n              if ((b[5834] | 0) == (c | 0)) {\n                v = (b[5831] | 0) + i | 0;\n                b[5831] = v;\n                b[5834] = k;\n                b[k + 4 >> 2] = v | 1;\n                b[k + v >> 2] = v;\n                break;\n              }\n\n              a = b[c + 4 >> 2] | 0;\n\n              if ((a & 3 | 0) == 1) {\n                h = a & -8;\n                e = a >>> 3;\n\n                h: do { if (a >>> 0 < 256) {\n                  a = b[c + 8 >> 2] | 0;\n                  d = b[c + 12 >> 2] | 0;\n\n                  if ((d | 0) == (a | 0)) {\n                    b[5829] = b[5829] & ~(1 << e);\n                    break;\n                  } else {\n                    b[a + 12 >> 2] = d;\n                    b[d + 8 >> 2] = a;\n                    break;\n                  }\n                } else {\n                  g = b[c + 24 >> 2] | 0;\n                  a = b[c + 12 >> 2] | 0;\n\n                  do { if ((a | 0) == (c | 0)) {\n                    d = c + 16 | 0;\n                    e = d + 4 | 0;\n                    a = b[e >> 2] | 0;\n\n                    if (!a) {\n                      a = b[d >> 2] | 0;\n\n                      if (!a) {\n                        a = 0;\n                        break;\n                      }\n                    } else { d = e; }\n\n                    while (1) {\n                      f = a + 20 | 0;\n                      e = b[f >> 2] | 0;\n\n                      if (!e) {\n                        f = a + 16 | 0;\n                        e = b[f >> 2] | 0;\n                        if (!e) { break; }else {\n                          a = e;\n                          d = f;\n                        }\n                      } else {\n                        a = e;\n                        d = f;\n                      }\n                    }\n\n                    b[d >> 2] = 0;\n                  } else {\n                    v = b[c + 8 >> 2] | 0;\n                    b[v + 12 >> 2] = a;\n                    b[a + 8 >> 2] = v;\n                  } } while (0);\n\n                  if (!g) { break; }\n                  d = b[c + 28 >> 2] | 0;\n                  e = 23620 + (d << 2) | 0;\n\n                  do { if ((b[e >> 2] | 0) != (c | 0)) {\n                    v = g + 16 | 0;\n                    b[((b[v >> 2] | 0) == (c | 0) ? v : g + 20 | 0) >> 2] = a;\n                    if (!a) { break h; }\n                  } else {\n                    b[e >> 2] = a;\n                    if (a | 0) { break; }\n                    b[5830] = b[5830] & ~(1 << d);\n                    break h;\n                  } } while (0);\n\n                  b[a + 24 >> 2] = g;\n                  d = c + 16 | 0;\n                  e = b[d >> 2] | 0;\n\n                  if (e | 0) {\n                    b[a + 16 >> 2] = e;\n                    b[e + 24 >> 2] = a;\n                  }\n\n                  d = b[d + 4 >> 2] | 0;\n                  if (!d) { break; }\n                  b[a + 20 >> 2] = d;\n                  b[d + 24 >> 2] = a;\n                } } while (0);\n\n                c = c + h | 0;\n                f = h + i | 0;\n              } else { f = i; }\n\n              c = c + 4 | 0;\n              b[c >> 2] = b[c >> 2] & -2;\n              b[k + 4 >> 2] = f | 1;\n              b[k + f >> 2] = f;\n              c = f >>> 3;\n\n              if (f >>> 0 < 256) {\n                d = 23356 + (c << 1 << 2) | 0;\n                a = b[5829] | 0;\n                c = 1 << c;\n\n                if (!(a & c)) {\n                  b[5829] = a | c;\n                  c = d;\n                  a = d + 8 | 0;\n                } else {\n                  a = d + 8 | 0;\n                  c = b[a >> 2] | 0;\n                }\n\n                b[a >> 2] = k;\n                b[c + 12 >> 2] = k;\n                b[k + 8 >> 2] = c;\n                b[k + 12 >> 2] = d;\n                break;\n              }\n\n              c = f >>> 8;\n\n              do { if (!c) { e = 0; }else {\n                if (f >>> 0 > 16777215) {\n                  e = 31;\n                  break;\n                }\n\n                u = (c + 1048320 | 0) >>> 16 & 8;\n                v = c << u;\n                t = (v + 520192 | 0) >>> 16 & 4;\n                v = v << t;\n                e = (v + 245760 | 0) >>> 16 & 2;\n                e = 14 - (t | u | e) + (v << e >>> 15) | 0;\n                e = f >>> (e + 7 | 0) & 1 | e << 1;\n              } } while (0);\n\n              c = 23620 + (e << 2) | 0;\n              b[k + 28 >> 2] = e;\n              a = k + 16 | 0;\n              b[a + 4 >> 2] = 0;\n              b[a >> 2] = 0;\n              a = b[5830] | 0;\n              d = 1 << e;\n\n              if (!(a & d)) {\n                b[5830] = a | d;\n                b[c >> 2] = k;\n                b[k + 24 >> 2] = c;\n                b[k + 12 >> 2] = k;\n                b[k + 8 >> 2] = k;\n                break;\n              }\n\n              c = b[c >> 2] | 0;\n\n              i: do { if ((b[c + 4 >> 2] & -8 | 0) != (f | 0)) {\n                e = f << ((e | 0) == 31 ? 0 : 25 - (e >>> 1) | 0);\n\n                while (1) {\n                  d = c + 16 + (e >>> 31 << 2) | 0;\n                  a = b[d >> 2] | 0;\n                  if (!a) { break; }\n\n                  if ((b[a + 4 >> 2] & -8 | 0) == (f | 0)) {\n                    c = a;\n                    break i;\n                  } else {\n                    e = e << 1;\n                    c = a;\n                  }\n                }\n\n                b[d >> 2] = k;\n                b[k + 24 >> 2] = c;\n                b[k + 12 >> 2] = k;\n                b[k + 8 >> 2] = k;\n                break g;\n              } } while (0);\n\n              u = c + 8 | 0;\n              v = b[u >> 2] | 0;\n              b[v + 12 >> 2] = k;\n              b[u >> 2] = k;\n              b[k + 8 >> 2] = v;\n              b[k + 12 >> 2] = c;\n              b[k + 24 >> 2] = 0;\n            } } while (0);\n\n            v = l + 8 | 0;\n            S = w;\n            return v | 0;\n          }\n\n          c = 23764;\n\n          while (1) {\n            a = b[c >> 2] | 0;\n            if (a >>> 0 <= j >>> 0 ? (v = a + (b[c + 4 >> 2] | 0) | 0, v >>> 0 > j >>> 0) : 0) { break; }\n            c = b[c + 8 >> 2] | 0;\n          }\n\n          f = v + -47 | 0;\n          a = f + 8 | 0;\n          a = f + ((a & 7 | 0) == 0 ? 0 : 0 - a & 7) | 0;\n          f = j + 16 | 0;\n          a = a >>> 0 < f >>> 0 ? j : a;\n          c = a + 8 | 0;\n          d = h + -40 | 0;\n          t = g + 8 | 0;\n          t = (t & 7 | 0) == 0 ? 0 : 0 - t & 7;\n          u = g + t | 0;\n          t = d - t | 0;\n          b[5835] = u;\n          b[5832] = t;\n          b[u + 4 >> 2] = t | 1;\n          b[g + d + 4 >> 2] = 40;\n          b[5836] = b[5951];\n          d = a + 4 | 0;\n          b[d >> 2] = 27;\n          b[c >> 2] = b[5941];\n          b[c + 4 >> 2] = b[5942];\n          b[c + 8 >> 2] = b[5943];\n          b[c + 12 >> 2] = b[5944];\n          b[5941] = g;\n          b[5942] = h;\n          b[5944] = 0;\n          b[5943] = c;\n          c = a + 24 | 0;\n\n          do {\n            u = c;\n            c = c + 4 | 0;\n            b[c >> 2] = 7;\n          } while ((u + 8 | 0) >>> 0 < v >>> 0);\n\n          if ((a | 0) != (j | 0)) {\n            g = a - j | 0;\n            b[d >> 2] = b[d >> 2] & -2;\n            b[j + 4 >> 2] = g | 1;\n            b[a >> 2] = g;\n            c = g >>> 3;\n\n            if (g >>> 0 < 256) {\n              d = 23356 + (c << 1 << 2) | 0;\n              a = b[5829] | 0;\n              c = 1 << c;\n\n              if (!(a & c)) {\n                b[5829] = a | c;\n                c = d;\n                a = d + 8 | 0;\n              } else {\n                a = d + 8 | 0;\n                c = b[a >> 2] | 0;\n              }\n\n              b[a >> 2] = j;\n              b[c + 12 >> 2] = j;\n              b[j + 8 >> 2] = c;\n              b[j + 12 >> 2] = d;\n              break;\n            }\n\n            c = g >>> 8;\n            if (c) {\n              if (g >>> 0 > 16777215) { e = 31; }else {\n                u = (c + 1048320 | 0) >>> 16 & 8;\n                v = c << u;\n                t = (v + 520192 | 0) >>> 16 & 4;\n                v = v << t;\n                e = (v + 245760 | 0) >>> 16 & 2;\n                e = 14 - (t | u | e) + (v << e >>> 15) | 0;\n                e = g >>> (e + 7 | 0) & 1 | e << 1;\n              }\n            } else { e = 0; }\n            d = 23620 + (e << 2) | 0;\n            b[j + 28 >> 2] = e;\n            b[j + 20 >> 2] = 0;\n            b[f >> 2] = 0;\n            c = b[5830] | 0;\n            a = 1 << e;\n\n            if (!(c & a)) {\n              b[5830] = c | a;\n              b[d >> 2] = j;\n              b[j + 24 >> 2] = d;\n              b[j + 12 >> 2] = j;\n              b[j + 8 >> 2] = j;\n              break;\n            }\n\n            c = b[d >> 2] | 0;\n\n            j: do { if ((b[c + 4 >> 2] & -8 | 0) != (g | 0)) {\n              e = g << ((e | 0) == 31 ? 0 : 25 - (e >>> 1) | 0);\n\n              while (1) {\n                d = c + 16 + (e >>> 31 << 2) | 0;\n                a = b[d >> 2] | 0;\n                if (!a) { break; }\n\n                if ((b[a + 4 >> 2] & -8 | 0) == (g | 0)) {\n                  c = a;\n                  break j;\n                } else {\n                  e = e << 1;\n                  c = a;\n                }\n              }\n\n              b[d >> 2] = j;\n              b[j + 24 >> 2] = c;\n              b[j + 12 >> 2] = j;\n              b[j + 8 >> 2] = j;\n              break f;\n            } } while (0);\n\n            u = c + 8 | 0;\n            v = b[u >> 2] | 0;\n            b[v + 12 >> 2] = j;\n            b[u >> 2] = j;\n            b[j + 8 >> 2] = v;\n            b[j + 12 >> 2] = c;\n            b[j + 24 >> 2] = 0;\n          }\n        } else {\n          v = b[5833] | 0;\n          if ((v | 0) == 0 | g >>> 0 < v >>> 0) { b[5833] = g; }\n          b[5941] = g;\n          b[5942] = h;\n          b[5944] = 0;\n          b[5838] = b[5947];\n          b[5837] = -1;\n          b[5842] = 23356;\n          b[5841] = 23356;\n          b[5844] = 23364;\n          b[5843] = 23364;\n          b[5846] = 23372;\n          b[5845] = 23372;\n          b[5848] = 23380;\n          b[5847] = 23380;\n          b[5850] = 23388;\n          b[5849] = 23388;\n          b[5852] = 23396;\n          b[5851] = 23396;\n          b[5854] = 23404;\n          b[5853] = 23404;\n          b[5856] = 23412;\n          b[5855] = 23412;\n          b[5858] = 23420;\n          b[5857] = 23420;\n          b[5860] = 23428;\n          b[5859] = 23428;\n          b[5862] = 23436;\n          b[5861] = 23436;\n          b[5864] = 23444;\n          b[5863] = 23444;\n          b[5866] = 23452;\n          b[5865] = 23452;\n          b[5868] = 23460;\n          b[5867] = 23460;\n          b[5870] = 23468;\n          b[5869] = 23468;\n          b[5872] = 23476;\n          b[5871] = 23476;\n          b[5874] = 23484;\n          b[5873] = 23484;\n          b[5876] = 23492;\n          b[5875] = 23492;\n          b[5878] = 23500;\n          b[5877] = 23500;\n          b[5880] = 23508;\n          b[5879] = 23508;\n          b[5882] = 23516;\n          b[5881] = 23516;\n          b[5884] = 23524;\n          b[5883] = 23524;\n          b[5886] = 23532;\n          b[5885] = 23532;\n          b[5888] = 23540;\n          b[5887] = 23540;\n          b[5890] = 23548;\n          b[5889] = 23548;\n          b[5892] = 23556;\n          b[5891] = 23556;\n          b[5894] = 23564;\n          b[5893] = 23564;\n          b[5896] = 23572;\n          b[5895] = 23572;\n          b[5898] = 23580;\n          b[5897] = 23580;\n          b[5900] = 23588;\n          b[5899] = 23588;\n          b[5902] = 23596;\n          b[5901] = 23596;\n          b[5904] = 23604;\n          b[5903] = 23604;\n          v = h + -40 | 0;\n          t = g + 8 | 0;\n          t = (t & 7 | 0) == 0 ? 0 : 0 - t & 7;\n          u = g + t | 0;\n          t = v - t | 0;\n          b[5835] = u;\n          b[5832] = t;\n          b[u + 4 >> 2] = t | 1;\n          b[g + v + 4 >> 2] = 40;\n          b[5836] = b[5951];\n        } } while (0);\n\n        c = b[5832] | 0;\n\n        if (c >>> 0 > m >>> 0) {\n          t = c - m | 0;\n          b[5832] = t;\n          v = b[5835] | 0;\n          u = v + m | 0;\n          b[5835] = u;\n          b[u + 4 >> 2] = t | 1;\n          b[v + 4 >> 2] = m | 3;\n          v = v + 8 | 0;\n          S = w;\n          return v | 0;\n        }\n      }\n\n      v = Tc() | 0;\n      b[v >> 2] = 12;\n      v = 0;\n      S = w;\n      return v | 0;\n    }\n\n    function Xc(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0,\n          f = 0,\n          g = 0,\n          h = 0,\n          i = 0,\n          j = 0;\n      if (!a) { return; }\n      d = a + -8 | 0;\n      f = b[5833] | 0;\n      a = b[a + -4 >> 2] | 0;\n      c = a & -8;\n      j = d + c | 0;\n\n      do { if (!(a & 1)) {\n        e = b[d >> 2] | 0;\n        if (!(a & 3)) { return; }\n        h = d + (0 - e) | 0;\n        g = e + c | 0;\n        if (h >>> 0 < f >>> 0) { return; }\n\n        if ((b[5834] | 0) == (h | 0)) {\n          a = j + 4 | 0;\n          c = b[a >> 2] | 0;\n\n          if ((c & 3 | 0) != 3) {\n            i = h;\n            c = g;\n            break;\n          }\n\n          b[5831] = g;\n          b[a >> 2] = c & -2;\n          b[h + 4 >> 2] = g | 1;\n          b[h + g >> 2] = g;\n          return;\n        }\n\n        d = e >>> 3;\n\n        if (e >>> 0 < 256) {\n          a = b[h + 8 >> 2] | 0;\n          c = b[h + 12 >> 2] | 0;\n\n          if ((c | 0) == (a | 0)) {\n            b[5829] = b[5829] & ~(1 << d);\n            i = h;\n            c = g;\n            break;\n          } else {\n            b[a + 12 >> 2] = c;\n            b[c + 8 >> 2] = a;\n            i = h;\n            c = g;\n            break;\n          }\n        }\n\n        f = b[h + 24 >> 2] | 0;\n        a = b[h + 12 >> 2] | 0;\n\n        do { if ((a | 0) == (h | 0)) {\n          c = h + 16 | 0;\n          d = c + 4 | 0;\n          a = b[d >> 2] | 0;\n\n          if (!a) {\n            a = b[c >> 2] | 0;\n\n            if (!a) {\n              a = 0;\n              break;\n            }\n          } else { c = d; }\n\n          while (1) {\n            e = a + 20 | 0;\n            d = b[e >> 2] | 0;\n\n            if (!d) {\n              e = a + 16 | 0;\n              d = b[e >> 2] | 0;\n              if (!d) { break; }else {\n                a = d;\n                c = e;\n              }\n            } else {\n              a = d;\n              c = e;\n            }\n          }\n\n          b[c >> 2] = 0;\n        } else {\n          i = b[h + 8 >> 2] | 0;\n          b[i + 12 >> 2] = a;\n          b[a + 8 >> 2] = i;\n        } } while (0);\n\n        if (f) {\n          c = b[h + 28 >> 2] | 0;\n          d = 23620 + (c << 2) | 0;\n\n          if ((b[d >> 2] | 0) == (h | 0)) {\n            b[d >> 2] = a;\n\n            if (!a) {\n              b[5830] = b[5830] & ~(1 << c);\n              i = h;\n              c = g;\n              break;\n            }\n          } else {\n            i = f + 16 | 0;\n            b[((b[i >> 2] | 0) == (h | 0) ? i : f + 20 | 0) >> 2] = a;\n\n            if (!a) {\n              i = h;\n              c = g;\n              break;\n            }\n          }\n\n          b[a + 24 >> 2] = f;\n          c = h + 16 | 0;\n          d = b[c >> 2] | 0;\n\n          if (d | 0) {\n            b[a + 16 >> 2] = d;\n            b[d + 24 >> 2] = a;\n          }\n\n          c = b[c + 4 >> 2] | 0;\n\n          if (c) {\n            b[a + 20 >> 2] = c;\n            b[c + 24 >> 2] = a;\n            i = h;\n            c = g;\n          } else {\n            i = h;\n            c = g;\n          }\n        } else {\n          i = h;\n          c = g;\n        }\n      } else {\n        i = d;\n        h = d;\n      } } while (0);\n\n      if (h >>> 0 >= j >>> 0) { return; }\n      a = j + 4 | 0;\n      e = b[a >> 2] | 0;\n      if (!(e & 1)) { return; }\n\n      if (!(e & 2)) {\n        if ((b[5835] | 0) == (j | 0)) {\n          j = (b[5832] | 0) + c | 0;\n          b[5832] = j;\n          b[5835] = i;\n          b[i + 4 >> 2] = j | 1;\n          if ((i | 0) != (b[5834] | 0)) { return; }\n          b[5834] = 0;\n          b[5831] = 0;\n          return;\n        }\n\n        if ((b[5834] | 0) == (j | 0)) {\n          j = (b[5831] | 0) + c | 0;\n          b[5831] = j;\n          b[5834] = h;\n          b[i + 4 >> 2] = j | 1;\n          b[h + j >> 2] = j;\n          return;\n        }\n\n        f = (e & -8) + c | 0;\n        d = e >>> 3;\n\n        do { if (e >>> 0 < 256) {\n          c = b[j + 8 >> 2] | 0;\n          a = b[j + 12 >> 2] | 0;\n\n          if ((a | 0) == (c | 0)) {\n            b[5829] = b[5829] & ~(1 << d);\n            break;\n          } else {\n            b[c + 12 >> 2] = a;\n            b[a + 8 >> 2] = c;\n            break;\n          }\n        } else {\n          g = b[j + 24 >> 2] | 0;\n          a = b[j + 12 >> 2] | 0;\n\n          do { if ((a | 0) == (j | 0)) {\n            c = j + 16 | 0;\n            d = c + 4 | 0;\n            a = b[d >> 2] | 0;\n\n            if (!a) {\n              a = b[c >> 2] | 0;\n\n              if (!a) {\n                d = 0;\n                break;\n              }\n            } else { c = d; }\n\n            while (1) {\n              e = a + 20 | 0;\n              d = b[e >> 2] | 0;\n\n              if (!d) {\n                e = a + 16 | 0;\n                d = b[e >> 2] | 0;\n                if (!d) { break; }else {\n                  a = d;\n                  c = e;\n                }\n              } else {\n                a = d;\n                c = e;\n              }\n            }\n\n            b[c >> 2] = 0;\n            d = a;\n          } else {\n            d = b[j + 8 >> 2] | 0;\n            b[d + 12 >> 2] = a;\n            b[a + 8 >> 2] = d;\n            d = a;\n          } } while (0);\n\n          if (g | 0) {\n            a = b[j + 28 >> 2] | 0;\n            c = 23620 + (a << 2) | 0;\n\n            if ((b[c >> 2] | 0) == (j | 0)) {\n              b[c >> 2] = d;\n\n              if (!d) {\n                b[5830] = b[5830] & ~(1 << a);\n                break;\n              }\n            } else {\n              e = g + 16 | 0;\n              b[((b[e >> 2] | 0) == (j | 0) ? e : g + 20 | 0) >> 2] = d;\n              if (!d) { break; }\n            }\n\n            b[d + 24 >> 2] = g;\n            a = j + 16 | 0;\n            c = b[a >> 2] | 0;\n\n            if (c | 0) {\n              b[d + 16 >> 2] = c;\n              b[c + 24 >> 2] = d;\n            }\n\n            a = b[a + 4 >> 2] | 0;\n\n            if (a | 0) {\n              b[d + 20 >> 2] = a;\n              b[a + 24 >> 2] = d;\n            }\n          }\n        } } while (0);\n\n        b[i + 4 >> 2] = f | 1;\n        b[h + f >> 2] = f;\n\n        if ((i | 0) == (b[5834] | 0)) {\n          b[5831] = f;\n          return;\n        }\n      } else {\n        b[a >> 2] = e & -2;\n        b[i + 4 >> 2] = c | 1;\n        b[h + c >> 2] = c;\n        f = c;\n      }\n\n      a = f >>> 3;\n\n      if (f >>> 0 < 256) {\n        d = 23356 + (a << 1 << 2) | 0;\n        c = b[5829] | 0;\n        a = 1 << a;\n\n        if (!(c & a)) {\n          b[5829] = c | a;\n          a = d;\n          c = d + 8 | 0;\n        } else {\n          c = d + 8 | 0;\n          a = b[c >> 2] | 0;\n        }\n\n        b[c >> 2] = i;\n        b[a + 12 >> 2] = i;\n        b[i + 8 >> 2] = a;\n        b[i + 12 >> 2] = d;\n        return;\n      }\n\n      a = f >>> 8;\n      if (a) {\n        if (f >>> 0 > 16777215) { e = 31; }else {\n          h = (a + 1048320 | 0) >>> 16 & 8;\n          j = a << h;\n          g = (j + 520192 | 0) >>> 16 & 4;\n          j = j << g;\n          e = (j + 245760 | 0) >>> 16 & 2;\n          e = 14 - (g | h | e) + (j << e >>> 15) | 0;\n          e = f >>> (e + 7 | 0) & 1 | e << 1;\n        }\n      } else { e = 0; }\n      a = 23620 + (e << 2) | 0;\n      b[i + 28 >> 2] = e;\n      b[i + 20 >> 2] = 0;\n      b[i + 16 >> 2] = 0;\n      c = b[5830] | 0;\n      d = 1 << e;\n\n      a: do { if (!(c & d)) {\n        b[5830] = c | d;\n        b[a >> 2] = i;\n        b[i + 24 >> 2] = a;\n        b[i + 12 >> 2] = i;\n        b[i + 8 >> 2] = i;\n      } else {\n        a = b[a >> 2] | 0;\n\n        b: do { if ((b[a + 4 >> 2] & -8 | 0) != (f | 0)) {\n          e = f << ((e | 0) == 31 ? 0 : 25 - (e >>> 1) | 0);\n\n          while (1) {\n            d = a + 16 + (e >>> 31 << 2) | 0;\n            c = b[d >> 2] | 0;\n            if (!c) { break; }\n\n            if ((b[c + 4 >> 2] & -8 | 0) == (f | 0)) {\n              a = c;\n              break b;\n            } else {\n              e = e << 1;\n              a = c;\n            }\n          }\n\n          b[d >> 2] = i;\n          b[i + 24 >> 2] = a;\n          b[i + 12 >> 2] = i;\n          b[i + 8 >> 2] = i;\n          break a;\n        } } while (0);\n\n        h = a + 8 | 0;\n        j = b[h >> 2] | 0;\n        b[j + 12 >> 2] = i;\n        b[h >> 2] = i;\n        b[i + 8 >> 2] = j;\n        b[i + 12 >> 2] = a;\n        b[i + 24 >> 2] = 0;\n      } } while (0);\n\n      j = (b[5837] | 0) + -1 | 0;\n      b[5837] = j;\n      if (j | 0) { return; }\n      a = 23772;\n\n      while (1) {\n        a = b[a >> 2] | 0;\n        if (!a) { break; }else { a = a + 8 | 0; }\n      }\n\n      b[5837] = -1;\n      return;\n    }\n\n    function Yc(a, c) {\n      a = a | 0;\n      c = c | 0;\n      var d = 0;\n\n      if (a) {\n        d = B(c, a) | 0;\n        if ((c | a) >>> 0 > 65535) { d = ((d >>> 0) / (a >>> 0) | 0 | 0) == (c | 0) ? d : -1; }\n      } else { d = 0; }\n\n      a = Wc(d) | 0;\n      if (!a) { return a | 0; }\n      if (!(b[a + -4 >> 2] & 3)) { return a | 0; }\n      hd(a | 0, 0, d | 0) | 0;\n      return a | 0;\n    }\n\n    function Zc(a, b, c, d) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      d = d | 0;\n      c = a + c >>> 0;\n      return (F(b + d + (c >>> 0 < a >>> 0 | 0) >>> 0 | 0), c | 0) | 0;\n    }\n\n    function _c(a, b, c, d) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n      d = d | 0;\n      d = b - d - (c >>> 0 > a >>> 0 | 0) >>> 0;\n      return (F(d | 0), a - c >>> 0 | 0) | 0;\n    }\n\n    function $c(a) {\n      a = a | 0;\n      return (a ? 31 - (D(a ^ a - 1) | 0) | 0 : 32) | 0;\n    }\n\n    function ad(a, c, d, e, f) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      f = f | 0;\n      var g = 0,\n          h = 0,\n          i = 0,\n          j = 0,\n          k = 0,\n          l = 0,\n          m = 0,\n          n = 0,\n          o = 0,\n          p = 0;\n      l = a;\n      j = c;\n      k = j;\n      h = d;\n      n = e;\n      i = n;\n\n      if (!k) {\n        g = (f | 0) != 0;\n\n        if (!i) {\n          if (g) {\n            b[f >> 2] = (l >>> 0) % (h >>> 0);\n            b[f + 4 >> 2] = 0;\n          }\n\n          n = 0;\n          f = (l >>> 0) / (h >>> 0) >>> 0;\n          return (F(n | 0), f) | 0;\n        } else {\n          if (!g) {\n            n = 0;\n            f = 0;\n            return (F(n | 0), f) | 0;\n          }\n\n          b[f >> 2] = a | 0;\n          b[f + 4 >> 2] = c & 0;\n          n = 0;\n          f = 0;\n          return (F(n | 0), f) | 0;\n        }\n      }\n\n      g = (i | 0) == 0;\n\n      do { if (h) {\n        if (!g) {\n          g = (D(i | 0) | 0) - (D(k | 0) | 0) | 0;\n\n          if (g >>> 0 <= 31) {\n            m = g + 1 | 0;\n            i = 31 - g | 0;\n            c = g - 31 >> 31;\n            h = m;\n            a = l >>> (m >>> 0) & c | k << i;\n            c = k >>> (m >>> 0) & c;\n            g = 0;\n            i = l << i;\n            break;\n          }\n\n          if (!f) {\n            n = 0;\n            f = 0;\n            return (F(n | 0), f) | 0;\n          }\n\n          b[f >> 2] = a | 0;\n          b[f + 4 >> 2] = j | c & 0;\n          n = 0;\n          f = 0;\n          return (F(n | 0), f) | 0;\n        }\n\n        g = h - 1 | 0;\n\n        if (g & h | 0) {\n          i = (D(h | 0) | 0) + 33 - (D(k | 0) | 0) | 0;\n          p = 64 - i | 0;\n          m = 32 - i | 0;\n          j = m >> 31;\n          o = i - 32 | 0;\n          c = o >> 31;\n          h = i;\n          a = m - 1 >> 31 & k >>> (o >>> 0) | (k << m | l >>> (i >>> 0)) & c;\n          c = c & k >>> (i >>> 0);\n          g = l << p & j;\n          i = (k << p | l >>> (o >>> 0)) & j | l << m & i - 33 >> 31;\n          break;\n        }\n\n        if (f | 0) {\n          b[f >> 2] = g & l;\n          b[f + 4 >> 2] = 0;\n        }\n\n        if ((h | 0) == 1) {\n          o = j | c & 0;\n          p = a | 0 | 0;\n          return (F(o | 0), p) | 0;\n        } else {\n          p = $c(h | 0) | 0;\n          o = k >>> (p >>> 0) | 0;\n          p = k << 32 - p | l >>> (p >>> 0) | 0;\n          return (F(o | 0), p) | 0;\n        }\n      } else {\n        if (g) {\n          if (f | 0) {\n            b[f >> 2] = (k >>> 0) % (h >>> 0);\n            b[f + 4 >> 2] = 0;\n          }\n\n          o = 0;\n          p = (k >>> 0) / (h >>> 0) >>> 0;\n          return (F(o | 0), p) | 0;\n        }\n\n        if (!l) {\n          if (f | 0) {\n            b[f >> 2] = 0;\n            b[f + 4 >> 2] = (k >>> 0) % (i >>> 0);\n          }\n\n          o = 0;\n          p = (k >>> 0) / (i >>> 0) >>> 0;\n          return (F(o | 0), p) | 0;\n        }\n\n        g = i - 1 | 0;\n\n        if (!(g & i)) {\n          if (f | 0) {\n            b[f >> 2] = a | 0;\n            b[f + 4 >> 2] = g & k | c & 0;\n          }\n\n          o = 0;\n          p = k >>> (($c(i | 0) | 0) >>> 0);\n          return (F(o | 0), p) | 0;\n        }\n\n        g = (D(i | 0) | 0) - (D(k | 0) | 0) | 0;\n\n        if (g >>> 0 <= 30) {\n          c = g + 1 | 0;\n          i = 31 - g | 0;\n          h = c;\n          a = k << i | l >>> (c >>> 0);\n          c = k >>> (c >>> 0);\n          g = 0;\n          i = l << i;\n          break;\n        }\n\n        if (!f) {\n          o = 0;\n          p = 0;\n          return (F(o | 0), p) | 0;\n        }\n\n        b[f >> 2] = a | 0;\n        b[f + 4 >> 2] = j | c & 0;\n        o = 0;\n        p = 0;\n        return (F(o | 0), p) | 0;\n      } } while (0);\n\n      if (!h) {\n        k = i;\n        j = 0;\n        i = 0;\n      } else {\n        m = d | 0 | 0;\n        l = n | e & 0;\n        k = Zc(m | 0, l | 0, -1, -1) | 0;\n        d = G() | 0;\n        j = i;\n        i = 0;\n\n        do {\n          e = j;\n          j = g >>> 31 | j << 1;\n          g = i | g << 1;\n          e = a << 1 | e >>> 31 | 0;\n          n = a >>> 31 | c << 1 | 0;\n          _c(k | 0, d | 0, e | 0, n | 0) | 0;\n          p = G() | 0;\n          o = p >> 31 | ((p | 0) < 0 ? -1 : 0) << 1;\n          i = o & 1;\n          a = _c(e | 0, n | 0, o & m | 0, (((p | 0) < 0 ? -1 : 0) >> 31 | ((p | 0) < 0 ? -1 : 0) << 1) & l | 0) | 0;\n          c = G() | 0;\n          h = h - 1 | 0;\n        } while ((h | 0) != 0);\n\n        k = j;\n        j = 0;\n      }\n\n      h = 0;\n\n      if (f | 0) {\n        b[f >> 2] = a;\n        b[f + 4 >> 2] = c;\n      }\n\n      o = (g | 0) >>> 31 | (k | h) << 1 | (h << 1 | g >>> 31) & 0 | j;\n      p = (g << 1 | 0 >>> 31) & -2 | i;\n      return (F(o | 0), p) | 0;\n    }\n\n    function bd(a, c, d, e) {\n      a = a | 0;\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      var f = 0,\n          g = 0;\n      g = S;\n      S = S + 16 | 0;\n      f = g | 0;\n      ad(a, c, d, e, f) | 0;\n      S = g;\n      return (F(b[f + 4 >> 2] | 0), b[f >> 2] | 0) | 0;\n    }\n\n    function cd(a, b, c) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n\n      if ((c | 0) < 32) {\n        F(b >>> c | 0);\n        return a >>> c | (b & (1 << c) - 1) << 32 - c;\n      }\n\n      F(0);\n      return b >>> c - 32 | 0;\n    }\n\n    function dd(a, b, c) {\n      a = a | 0;\n      b = b | 0;\n      c = c | 0;\n\n      if ((c | 0) < 32) {\n        F(b << c | (a & (1 << c) - 1 << 32 - c) >>> 32 - c | 0);\n        return a << c;\n      }\n\n      F(a << c - 32 | 0);\n      return 0;\n    }\n\n    function ed(a, b) {\n      a = +a;\n      b = +b;\n      if (a != a) { return +b; }\n      if (b != b) { return +a; }\n      return +C(+a, +b);\n    }\n\n    function fd(a) {\n      a = +a;\n      return a >= 0.0 ? +p(a + .5) : +A(a - .5);\n    }\n\n    function gd(c, d, e) {\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      var f = 0,\n          g = 0,\n          h = 0;\n\n      if ((e | 0) >= 8192) {\n        K(c | 0, d | 0, e | 0) | 0;\n        return c | 0;\n      }\n\n      h = c | 0;\n      g = c + e | 0;\n\n      if ((c & 3) == (d & 3)) {\n        while (c & 3) {\n          if (!e) { return h | 0; }\n          a[c >> 0] = a[d >> 0] | 0;\n          c = c + 1 | 0;\n          d = d + 1 | 0;\n          e = e - 1 | 0;\n        }\n\n        e = g & -4 | 0;\n        f = e - 64 | 0;\n\n        while ((c | 0) <= (f | 0)) {\n          b[c >> 2] = b[d >> 2];\n          b[c + 4 >> 2] = b[d + 4 >> 2];\n          b[c + 8 >> 2] = b[d + 8 >> 2];\n          b[c + 12 >> 2] = b[d + 12 >> 2];\n          b[c + 16 >> 2] = b[d + 16 >> 2];\n          b[c + 20 >> 2] = b[d + 20 >> 2];\n          b[c + 24 >> 2] = b[d + 24 >> 2];\n          b[c + 28 >> 2] = b[d + 28 >> 2];\n          b[c + 32 >> 2] = b[d + 32 >> 2];\n          b[c + 36 >> 2] = b[d + 36 >> 2];\n          b[c + 40 >> 2] = b[d + 40 >> 2];\n          b[c + 44 >> 2] = b[d + 44 >> 2];\n          b[c + 48 >> 2] = b[d + 48 >> 2];\n          b[c + 52 >> 2] = b[d + 52 >> 2];\n          b[c + 56 >> 2] = b[d + 56 >> 2];\n          b[c + 60 >> 2] = b[d + 60 >> 2];\n          c = c + 64 | 0;\n          d = d + 64 | 0;\n        }\n\n        while ((c | 0) < (e | 0)) {\n          b[c >> 2] = b[d >> 2];\n          c = c + 4 | 0;\n          d = d + 4 | 0;\n        }\n      } else {\n        e = g - 4 | 0;\n\n        while ((c | 0) < (e | 0)) {\n          a[c >> 0] = a[d >> 0] | 0;\n          a[c + 1 >> 0] = a[d + 1 >> 0] | 0;\n          a[c + 2 >> 0] = a[d + 2 >> 0] | 0;\n          a[c + 3 >> 0] = a[d + 3 >> 0] | 0;\n          c = c + 4 | 0;\n          d = d + 4 | 0;\n        }\n      }\n\n      while ((c | 0) < (g | 0)) {\n        a[c >> 0] = a[d >> 0] | 0;\n        c = c + 1 | 0;\n        d = d + 1 | 0;\n      }\n\n      return h | 0;\n    }\n\n    function hd(c, d, e) {\n      c = c | 0;\n      d = d | 0;\n      e = e | 0;\n      var f = 0,\n          g = 0,\n          h = 0,\n          i = 0;\n      h = c + e | 0;\n      d = d & 255;\n\n      if ((e | 0) >= 67) {\n        while (c & 3) {\n          a[c >> 0] = d;\n          c = c + 1 | 0;\n        }\n\n        f = h & -4 | 0;\n        i = d | d << 8 | d << 16 | d << 24;\n        g = f - 64 | 0;\n\n        while ((c | 0) <= (g | 0)) {\n          b[c >> 2] = i;\n          b[c + 4 >> 2] = i;\n          b[c + 8 >> 2] = i;\n          b[c + 12 >> 2] = i;\n          b[c + 16 >> 2] = i;\n          b[c + 20 >> 2] = i;\n          b[c + 24 >> 2] = i;\n          b[c + 28 >> 2] = i;\n          b[c + 32 >> 2] = i;\n          b[c + 36 >> 2] = i;\n          b[c + 40 >> 2] = i;\n          b[c + 44 >> 2] = i;\n          b[c + 48 >> 2] = i;\n          b[c + 52 >> 2] = i;\n          b[c + 56 >> 2] = i;\n          b[c + 60 >> 2] = i;\n          c = c + 64 | 0;\n        }\n\n        while ((c | 0) < (f | 0)) {\n          b[c >> 2] = i;\n          c = c + 4 | 0;\n        }\n      }\n\n      while ((c | 0) < (h | 0)) {\n        a[c >> 0] = d;\n        c = c + 1 | 0;\n      }\n\n      return h - e | 0;\n    }\n\n    function id(a) {\n      a = +a;\n      return a >= 0.0 ? +p(a + .5) : +A(a - .5);\n    }\n\n    function jd(a) {\n      a = a | 0;\n      var c = 0,\n          d = 0,\n          e = 0;\n      e = J() | 0;\n      d = b[g >> 2] | 0;\n      c = d + a | 0;\n\n      if ((a | 0) > 0 & (c | 0) < (d | 0) | (c | 0) < 0) {\n        M(c | 0) | 0;\n        I(12);\n        return -1;\n      }\n\n      if ((c | 0) > (e | 0)) { if (!(L(c | 0) | 0)) {\n        I(12);\n        return -1;\n      } }\n      b[g >> 2] = c;\n      return d | 0;\n    } // EMSCRIPTEN_END_FUNCS\n\n\n    return {\n      ___uremdi3: bd,\n      _bitshift64Lshr: cd,\n      _bitshift64Shl: dd,\n      _calloc: Yc,\n      _cellAreaKm2: ub,\n      _cellAreaM2: vb,\n      _cellAreaRads2: tb,\n      _compact: Hb,\n      _destroyLinkedPolygon: jc,\n      _edgeLengthKm: pb,\n      _edgeLengthM: qb,\n      _emscripten_replace_memory: V,\n      _exactEdgeLengthKm: xb,\n      _exactEdgeLengthM: yb,\n      _exactEdgeLengthRads: wb,\n      _experimentalH3ToLocalIj: oc,\n      _experimentalLocalIjToH3: pc,\n      _free: Xc,\n      _geoToH3: Sb,\n      _getDestinationH3IndexFromUnidirectionalEdge: cc,\n      _getH3IndexesFromUnidirectionalEdge: ec,\n      _getH3UnidirectionalEdge: ac,\n      _getH3UnidirectionalEdgeBoundary: gc,\n      _getH3UnidirectionalEdgesFromHexagon: fc,\n      _getOriginH3IndexFromUnidirectionalEdge: bc,\n      _getPentagonIndexes: _b,\n      _getRes0Indexes: va,\n      _h3Distance: qc,\n      _h3GetBaseCell: Ab,\n      _h3GetFaces: Yb,\n      _h3GetResolution: zb,\n      _h3IndexesAreNeighbors: $b,\n      _h3IsPentagon: Fb,\n      _h3IsResClassIII: Kb,\n      _h3IsValid: Bb,\n      _h3Line: sc,\n      _h3LineSize: rc,\n      _h3SetToLinkedGeo: ka,\n      _h3ToCenterChild: Gb,\n      _h3ToChildren: Eb,\n      _h3ToGeo: Vb,\n      _h3ToGeoBoundary: Wb,\n      _h3ToParent: Cb,\n      _h3UnidirectionalEdgeIsValid: dc,\n      _hexAreaKm2: nb,\n      _hexAreaM2: ob,\n      _hexRing: ea,\n      _i64Subtract: _c,\n      _kRing: $,\n      _kRingDistances: aa,\n      _llvm_minnum_f64: ed,\n      _llvm_round_f64: fd,\n      _malloc: Wc,\n      _maxFaceCount: Xb,\n      _maxH3ToChildrenSize: Db,\n      _maxKringSize: _,\n      _maxPolyfillSize: fa,\n      _maxUncompactSize: Jb,\n      _memcpy: gd,\n      _memset: hd,\n      _numHexagons: rb,\n      _pentagonIndexCount: Zb,\n      _pointDistKm: jb,\n      _pointDistM: kb,\n      _pointDistRads: ib,\n      _polyfill: ga,\n      _res0IndexCount: ua,\n      _round: id,\n      _sbrk: jd,\n      _sizeOfCoordIJ: Ec,\n      _sizeOfGeoBoundary: Ac,\n      _sizeOfGeoCoord: zc,\n      _sizeOfGeoPolygon: Cc,\n      _sizeOfGeofence: Bc,\n      _sizeOfH3Index: yc,\n      _sizeOfLinkedGeoPolygon: Dc,\n      _uncompact: Ib,\n      establishStackSpace: Z,\n      stackAlloc: W,\n      stackRestore: Y,\n      stackSave: X\n    };\n  }( // EMSCRIPTEN_END_ASM\n  asmGlobalArg, asmLibraryArg, buffer);\n\n  var ___uremdi3 = Module[\"___uremdi3\"] = asm[\"___uremdi3\"];\n\n  var _bitshift64Lshr = Module[\"_bitshift64Lshr\"] = asm[\"_bitshift64Lshr\"];\n\n  var _bitshift64Shl = Module[\"_bitshift64Shl\"] = asm[\"_bitshift64Shl\"];\n\n  var _calloc = Module[\"_calloc\"] = asm[\"_calloc\"];\n\n  var _cellAreaKm2 = Module[\"_cellAreaKm2\"] = asm[\"_cellAreaKm2\"];\n\n  var _cellAreaM2 = Module[\"_cellAreaM2\"] = asm[\"_cellAreaM2\"];\n\n  var _cellAreaRads2 = Module[\"_cellAreaRads2\"] = asm[\"_cellAreaRads2\"];\n\n  var _compact = Module[\"_compact\"] = asm[\"_compact\"];\n\n  var _destroyLinkedPolygon = Module[\"_destroyLinkedPolygon\"] = asm[\"_destroyLinkedPolygon\"];\n\n  var _edgeLengthKm = Module[\"_edgeLengthKm\"] = asm[\"_edgeLengthKm\"];\n\n  var _edgeLengthM = Module[\"_edgeLengthM\"] = asm[\"_edgeLengthM\"];\n\n  var _emscripten_replace_memory = Module[\"_emscripten_replace_memory\"] = asm[\"_emscripten_replace_memory\"];\n\n  var _exactEdgeLengthKm = Module[\"_exactEdgeLengthKm\"] = asm[\"_exactEdgeLengthKm\"];\n\n  var _exactEdgeLengthM = Module[\"_exactEdgeLengthM\"] = asm[\"_exactEdgeLengthM\"];\n\n  var _exactEdgeLengthRads = Module[\"_exactEdgeLengthRads\"] = asm[\"_exactEdgeLengthRads\"];\n\n  var _experimentalH3ToLocalIj = Module[\"_experimentalH3ToLocalIj\"] = asm[\"_experimentalH3ToLocalIj\"];\n\n  var _experimentalLocalIjToH3 = Module[\"_experimentalLocalIjToH3\"] = asm[\"_experimentalLocalIjToH3\"];\n\n  var _free = Module[\"_free\"] = asm[\"_free\"];\n\n  var _geoToH3 = Module[\"_geoToH3\"] = asm[\"_geoToH3\"];\n\n  var _getDestinationH3IndexFromUnidirectionalEdge = Module[\"_getDestinationH3IndexFromUnidirectionalEdge\"] = asm[\"_getDestinationH3IndexFromUnidirectionalEdge\"];\n\n  var _getH3IndexesFromUnidirectionalEdge = Module[\"_getH3IndexesFromUnidirectionalEdge\"] = asm[\"_getH3IndexesFromUnidirectionalEdge\"];\n\n  var _getH3UnidirectionalEdge = Module[\"_getH3UnidirectionalEdge\"] = asm[\"_getH3UnidirectionalEdge\"];\n\n  var _getH3UnidirectionalEdgeBoundary = Module[\"_getH3UnidirectionalEdgeBoundary\"] = asm[\"_getH3UnidirectionalEdgeBoundary\"];\n\n  var _getH3UnidirectionalEdgesFromHexagon = Module[\"_getH3UnidirectionalEdgesFromHexagon\"] = asm[\"_getH3UnidirectionalEdgesFromHexagon\"];\n\n  var _getOriginH3IndexFromUnidirectionalEdge = Module[\"_getOriginH3IndexFromUnidirectionalEdge\"] = asm[\"_getOriginH3IndexFromUnidirectionalEdge\"];\n\n  var _getPentagonIndexes = Module[\"_getPentagonIndexes\"] = asm[\"_getPentagonIndexes\"];\n\n  var _getRes0Indexes = Module[\"_getRes0Indexes\"] = asm[\"_getRes0Indexes\"];\n\n  var _h3Distance = Module[\"_h3Distance\"] = asm[\"_h3Distance\"];\n\n  var _h3GetBaseCell = Module[\"_h3GetBaseCell\"] = asm[\"_h3GetBaseCell\"];\n\n  var _h3GetFaces = Module[\"_h3GetFaces\"] = asm[\"_h3GetFaces\"];\n\n  var _h3GetResolution = Module[\"_h3GetResolution\"] = asm[\"_h3GetResolution\"];\n\n  var _h3IndexesAreNeighbors = Module[\"_h3IndexesAreNeighbors\"] = asm[\"_h3IndexesAreNeighbors\"];\n\n  var _h3IsPentagon = Module[\"_h3IsPentagon\"] = asm[\"_h3IsPentagon\"];\n\n  var _h3IsResClassIII = Module[\"_h3IsResClassIII\"] = asm[\"_h3IsResClassIII\"];\n\n  var _h3IsValid = Module[\"_h3IsValid\"] = asm[\"_h3IsValid\"];\n\n  var _h3Line = Module[\"_h3Line\"] = asm[\"_h3Line\"];\n\n  var _h3LineSize = Module[\"_h3LineSize\"] = asm[\"_h3LineSize\"];\n\n  var _h3SetToLinkedGeo = Module[\"_h3SetToLinkedGeo\"] = asm[\"_h3SetToLinkedGeo\"];\n\n  var _h3ToCenterChild = Module[\"_h3ToCenterChild\"] = asm[\"_h3ToCenterChild\"];\n\n  var _h3ToChildren = Module[\"_h3ToChildren\"] = asm[\"_h3ToChildren\"];\n\n  var _h3ToGeo = Module[\"_h3ToGeo\"] = asm[\"_h3ToGeo\"];\n\n  var _h3ToGeoBoundary = Module[\"_h3ToGeoBoundary\"] = asm[\"_h3ToGeoBoundary\"];\n\n  var _h3ToParent = Module[\"_h3ToParent\"] = asm[\"_h3ToParent\"];\n\n  var _h3UnidirectionalEdgeIsValid = Module[\"_h3UnidirectionalEdgeIsValid\"] = asm[\"_h3UnidirectionalEdgeIsValid\"];\n\n  var _hexAreaKm2 = Module[\"_hexAreaKm2\"] = asm[\"_hexAreaKm2\"];\n\n  var _hexAreaM2 = Module[\"_hexAreaM2\"] = asm[\"_hexAreaM2\"];\n\n  var _hexRing = Module[\"_hexRing\"] = asm[\"_hexRing\"];\n\n  var _i64Subtract = Module[\"_i64Subtract\"] = asm[\"_i64Subtract\"];\n\n  var _kRing = Module[\"_kRing\"] = asm[\"_kRing\"];\n\n  var _kRingDistances = Module[\"_kRingDistances\"] = asm[\"_kRingDistances\"];\n\n  var _llvm_minnum_f64 = Module[\"_llvm_minnum_f64\"] = asm[\"_llvm_minnum_f64\"];\n\n  var _llvm_round_f64 = Module[\"_llvm_round_f64\"] = asm[\"_llvm_round_f64\"];\n\n  var _malloc = Module[\"_malloc\"] = asm[\"_malloc\"];\n\n  var _maxFaceCount = Module[\"_maxFaceCount\"] = asm[\"_maxFaceCount\"];\n\n  var _maxH3ToChildrenSize = Module[\"_maxH3ToChildrenSize\"] = asm[\"_maxH3ToChildrenSize\"];\n\n  var _maxKringSize = Module[\"_maxKringSize\"] = asm[\"_maxKringSize\"];\n\n  var _maxPolyfillSize = Module[\"_maxPolyfillSize\"] = asm[\"_maxPolyfillSize\"];\n\n  var _maxUncompactSize = Module[\"_maxUncompactSize\"] = asm[\"_maxUncompactSize\"];\n\n  var _memcpy = Module[\"_memcpy\"] = asm[\"_memcpy\"];\n\n  var _memset = Module[\"_memset\"] = asm[\"_memset\"];\n\n  var _numHexagons = Module[\"_numHexagons\"] = asm[\"_numHexagons\"];\n\n  var _pentagonIndexCount = Module[\"_pentagonIndexCount\"] = asm[\"_pentagonIndexCount\"];\n\n  var _pointDistKm = Module[\"_pointDistKm\"] = asm[\"_pointDistKm\"];\n\n  var _pointDistM = Module[\"_pointDistM\"] = asm[\"_pointDistM\"];\n\n  var _pointDistRads = Module[\"_pointDistRads\"] = asm[\"_pointDistRads\"];\n\n  var _polyfill = Module[\"_polyfill\"] = asm[\"_polyfill\"];\n\n  var _res0IndexCount = Module[\"_res0IndexCount\"] = asm[\"_res0IndexCount\"];\n\n  var _round = Module[\"_round\"] = asm[\"_round\"];\n\n  var _sbrk = Module[\"_sbrk\"] = asm[\"_sbrk\"];\n\n  var _sizeOfCoordIJ = Module[\"_sizeOfCoordIJ\"] = asm[\"_sizeOfCoordIJ\"];\n\n  var _sizeOfGeoBoundary = Module[\"_sizeOfGeoBoundary\"] = asm[\"_sizeOfGeoBoundary\"];\n\n  var _sizeOfGeoCoord = Module[\"_sizeOfGeoCoord\"] = asm[\"_sizeOfGeoCoord\"];\n\n  var _sizeOfGeoPolygon = Module[\"_sizeOfGeoPolygon\"] = asm[\"_sizeOfGeoPolygon\"];\n\n  var _sizeOfGeofence = Module[\"_sizeOfGeofence\"] = asm[\"_sizeOfGeofence\"];\n\n  var _sizeOfH3Index = Module[\"_sizeOfH3Index\"] = asm[\"_sizeOfH3Index\"];\n\n  var _sizeOfLinkedGeoPolygon = Module[\"_sizeOfLinkedGeoPolygon\"] = asm[\"_sizeOfLinkedGeoPolygon\"];\n\n  var _uncompact = Module[\"_uncompact\"] = asm[\"_uncompact\"];\n\n  var establishStackSpace = Module[\"establishStackSpace\"] = asm[\"establishStackSpace\"];\n  var stackAlloc = Module[\"stackAlloc\"] = asm[\"stackAlloc\"];\n  var stackRestore = Module[\"stackRestore\"] = asm[\"stackRestore\"];\n  var stackSave = Module[\"stackSave\"] = asm[\"stackSave\"];\n  Module[\"asm\"] = asm;\n  Module[\"cwrap\"] = cwrap;\n  Module[\"setValue\"] = setValue;\n  Module[\"getValue\"] = getValue;\n  Module[\"getTempRet0\"] = getTempRet0;\n\n  if (memoryInitializer) {\n    if (!isDataURI(memoryInitializer)) {\n      memoryInitializer = locateFile(memoryInitializer);\n    }\n\n    {\n      addRunDependency(\"memory initializer\");\n\n      var applyMemoryInitializer = function (data) {\n        if (data.byteLength) { data = new Uint8Array(data); }\n        HEAPU8.set(data, GLOBAL_BASE);\n        if (Module[\"memoryInitializerRequest\"]) { delete Module[\"memoryInitializerRequest\"].response; }\n        removeRunDependency(\"memory initializer\");\n      };\n\n      var doBrowserLoad = function () {\n        readAsync(memoryInitializer, applyMemoryInitializer, function () {\n          throw \"could not load memory initializer \" + memoryInitializer;\n        });\n      };\n\n      var memoryInitializerBytes = tryParseAsDataURI(memoryInitializer);\n\n      if (memoryInitializerBytes) {\n        applyMemoryInitializer(memoryInitializerBytes.buffer);\n      } else if (Module[\"memoryInitializerRequest\"]) {\n        var useRequest = function () {\n          var request = Module[\"memoryInitializerRequest\"];\n          var response = request.response;\n\n          if (request.status !== 200 && request.status !== 0) {\n            var data = tryParseAsDataURI(Module[\"memoryInitializerRequestURL\"]);\n\n            if (data) {\n              response = data.buffer;\n            } else {\n              console.warn(\"a problem seems to have happened with Module.memoryInitializerRequest, status: \" + request.status + \", retrying \" + memoryInitializer);\n              doBrowserLoad();\n              return;\n            }\n          }\n\n          applyMemoryInitializer(response);\n        };\n\n        if (Module[\"memoryInitializerRequest\"].response) {\n          setTimeout(useRequest, 0);\n        } else {\n          Module[\"memoryInitializerRequest\"].addEventListener(\"load\", useRequest);\n        }\n      } else {\n        doBrowserLoad();\n      }\n    }\n  }\n\n  var calledRun;\n\n  dependenciesFulfilled = function runCaller() {\n    if (!calledRun) { run(); }\n    if (!calledRun) { dependenciesFulfilled = runCaller; }\n  };\n\n  function run(args) {\n    args = args || arguments_;\n\n    if (runDependencies > 0) {\n      return;\n    }\n\n    preRun();\n    if (runDependencies > 0) { return; }\n\n    function doRun() {\n      if (calledRun) { return; }\n      calledRun = true;\n      if (ABORT) { return; }\n      initRuntime();\n      preMain();\n      if (Module[\"onRuntimeInitialized\"]) { Module[\"onRuntimeInitialized\"](); }\n      postRun();\n    }\n\n    if (Module[\"setStatus\"]) {\n      Module[\"setStatus\"](\"Running...\");\n      setTimeout(function () {\n        setTimeout(function () {\n          Module[\"setStatus\"](\"\");\n        }, 1);\n        doRun();\n      }, 1);\n    } else {\n      doRun();\n    }\n  }\n\n  Module[\"run\"] = run;\n\n  function abort(what) {\n    if (Module[\"onAbort\"]) {\n      Module[\"onAbort\"](what);\n    }\n\n    what += \"\";\n    out(what);\n    err(what);\n    ABORT = true;\n    throw \"abort(\" + what + \"). Build with -s ASSERTIONS=1 for more info.\";\n  }\n\n  Module[\"abort\"] = abort;\n\n  if (Module[\"preInit\"]) {\n    if (typeof Module[\"preInit\"] == \"function\") { Module[\"preInit\"] = [Module[\"preInit\"]]; }\n\n    while (Module[\"preInit\"].length > 0) {\n      Module[\"preInit\"].pop()();\n    }\n  }\n  run();\n  return libh3;\n}(typeof libh3 === 'object' ? libh3 : {});\n\n/*\n * Copyright 2018-2019 Uber Technologies, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *         http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n// Define the C bindings for the h3 library\n// Add some aliases to make the function definitions more intelligible\nvar NUMBER = 'number';\nvar BOOLEAN = NUMBER;\nvar H3_LOWER = NUMBER;\nvar H3_UPPER = NUMBER;\nvar RESOLUTION = NUMBER;\nvar POINTER = NUMBER; // Define the bindings to functions in the C lib. Functions are defined as\n// [name, return type, [arg types]]. You must run `npm run build-emscripten`\n// before new functions added here will be available.\n\nvar BINDINGS = [// The size functions are inserted via build/sizes.h\n['sizeOfH3Index', NUMBER], ['sizeOfGeoCoord', NUMBER], ['sizeOfGeoBoundary', NUMBER], ['sizeOfGeoPolygon', NUMBER], ['sizeOfGeofence', NUMBER], ['sizeOfLinkedGeoPolygon', NUMBER], ['sizeOfCoordIJ', NUMBER], // The remaining functions are defined in the core lib in h3Api.h\n['h3IsValid', BOOLEAN, [H3_LOWER, H3_UPPER]], ['geoToH3', H3_LOWER, [NUMBER, NUMBER, RESOLUTION]], ['h3ToGeo', null, [H3_LOWER, H3_UPPER, POINTER]], ['h3ToGeoBoundary', null, [H3_LOWER, H3_UPPER, POINTER]], ['maxKringSize', NUMBER, [NUMBER]], ['kRing', null, [H3_LOWER, H3_UPPER, NUMBER, POINTER]], ['kRingDistances', null, [H3_LOWER, H3_UPPER, NUMBER, POINTER, POINTER]], ['hexRing', null, [H3_LOWER, H3_UPPER, NUMBER, POINTER]], ['maxPolyfillSize', NUMBER, [POINTER, RESOLUTION]], ['polyfill', null, [POINTER, RESOLUTION, POINTER]], ['h3SetToLinkedGeo', null, [POINTER, NUMBER, POINTER]], ['destroyLinkedPolygon', null, [POINTER]], ['compact', NUMBER, [POINTER, POINTER, NUMBER]], ['uncompact', NUMBER, [POINTER, NUMBER, POINTER, NUMBER, RESOLUTION]], ['maxUncompactSize', NUMBER, [POINTER, NUMBER, RESOLUTION]], ['h3IsPentagon', BOOLEAN, [H3_LOWER, H3_UPPER]], ['h3IsResClassIII', BOOLEAN, [H3_LOWER, H3_UPPER]], ['h3GetBaseCell', NUMBER, [H3_LOWER, H3_UPPER]], ['h3GetResolution', NUMBER, [H3_LOWER, H3_UPPER]], ['maxFaceCount', NUMBER, [H3_LOWER, H3_UPPER]], ['h3GetFaces', null, [H3_LOWER, H3_UPPER, POINTER]], ['h3ToParent', H3_LOWER, [H3_LOWER, H3_UPPER, RESOLUTION]], ['h3ToChildren', null, [H3_LOWER, H3_UPPER, RESOLUTION, POINTER]], ['h3ToCenterChild', H3_LOWER, [H3_LOWER, H3_UPPER, RESOLUTION]], ['maxH3ToChildrenSize', NUMBER, [H3_LOWER, H3_UPPER, RESOLUTION]], ['h3IndexesAreNeighbors', BOOLEAN, [H3_LOWER, H3_UPPER, H3_LOWER, H3_UPPER]], ['getH3UnidirectionalEdge', H3_LOWER, [H3_LOWER, H3_UPPER, H3_LOWER, H3_UPPER]], ['getOriginH3IndexFromUnidirectionalEdge', H3_LOWER, [H3_LOWER, H3_UPPER]], ['getDestinationH3IndexFromUnidirectionalEdge', H3_LOWER, [H3_LOWER, H3_UPPER]], ['h3UnidirectionalEdgeIsValid', BOOLEAN, [H3_LOWER, H3_UPPER]], ['getH3IndexesFromUnidirectionalEdge', null, [H3_LOWER, H3_UPPER, POINTER]], ['getH3UnidirectionalEdgesFromHexagon', null, [H3_LOWER, H3_UPPER, POINTER]], ['getH3UnidirectionalEdgeBoundary', null, [H3_LOWER, H3_UPPER, POINTER]], ['h3Distance', NUMBER, [H3_LOWER, H3_UPPER, H3_LOWER, H3_UPPER]], ['h3Line', NUMBER, [H3_LOWER, H3_UPPER, H3_LOWER, H3_UPPER, POINTER]], ['h3LineSize', NUMBER, [H3_LOWER, H3_UPPER, H3_LOWER, H3_UPPER]], ['experimentalH3ToLocalIj', NUMBER, [H3_LOWER, H3_UPPER, H3_LOWER, H3_UPPER, POINTER]], ['experimentalLocalIjToH3', NUMBER, [H3_LOWER, H3_UPPER, POINTER, POINTER]], ['hexAreaM2', NUMBER, [RESOLUTION]], ['hexAreaKm2', NUMBER, [RESOLUTION]], ['edgeLengthM', NUMBER, [RESOLUTION]], ['edgeLengthKm', NUMBER, [RESOLUTION]], ['pointDistM', NUMBER, [POINTER, POINTER]], ['pointDistKm', NUMBER, [POINTER, POINTER]], ['pointDistRads', NUMBER, [POINTER, POINTER]], ['cellAreaM2', NUMBER, [H3_LOWER, H3_UPPER]], ['cellAreaKm2', NUMBER, [H3_LOWER, H3_UPPER]], ['cellAreaRads2', NUMBER, [H3_LOWER, H3_UPPER]], ['exactEdgeLengthM', NUMBER, [H3_LOWER, H3_UPPER]], ['exactEdgeLengthKm', NUMBER, [H3_LOWER, H3_UPPER]], ['exactEdgeLengthRads', NUMBER, [H3_LOWER, H3_UPPER]], ['numHexagons', NUMBER, [RESOLUTION]], ['getRes0Indexes', null, [POINTER]], ['res0IndexCount', NUMBER], ['getPentagonIndexes', null, [NUMBER, POINTER]], ['pentagonIndexCount', NUMBER]];\n\n/*\n * Copyright 2018-2019 Uber Technologies, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *         http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nvar H3 = {}; // Create the bound functions themselves\n\nBINDINGS.forEach(function bind(def) {\n  H3[def[0]] = libh3.cwrap.apply(libh3, def);\n}); // Alias the hexidecimal base for legibility\n\nvar BASE_16 = 16; // ----------------------------------------------------------------------------\n// Byte size imports\n\nvar SZ_INT = 4;\nvar SZ_PTR = 4;\nvar SZ_DBL = 8;\nvar SZ_H3INDEX = H3.sizeOfH3Index();\nvar SZ_GEOCOORD = H3.sizeOfGeoCoord();\nvar SZ_GEOBOUNDARY = H3.sizeOfGeoBoundary();\nvar SZ_GEOPOLYGON = H3.sizeOfGeoPolygon();\nvar SZ_GEOFENCE = H3.sizeOfGeofence();\nvar SZ_LINKED_GEOPOLYGON = H3.sizeOfLinkedGeoPolygon();\nvar SZ_COORDIJ = H3.sizeOfCoordIJ(); // ----------------------------------------------------------------------------\n// Custom types\n\n/**\n * 64-bit hexidecimal string representation of an H3 index\n * @static\n * @typedef {string} H3Index\n */\n\n/**\n * 64-bit hexidecimal string representation of an H3 index,\n * or two 32-bit integers in little endian order in an array.\n * @static\n * @typedef {string | number[]} H3IndexInput\n */\n\n/**\n * Coordinates as an `{i, j}` pair\n * @static\n * @typedef CoordIJ\n * @type {Object}\n * @property {number} i\n * @property {number} j\n */\n// ----------------------------------------------------------------------------\n// Unit constants\n\n/**\n * Length/Area units\n * @static\n * @typedef UNITS\n * @type {Object}\n * @property {string} m\n * @property {string} m2\n * @property {string} km\n * @property {string} km2\n * @property {string} rads\n * @property {string} rads2\n */\n\nvar UNITS = {\n  m: 'm',\n  m2: 'm2',\n  km: 'km',\n  km2: 'km2',\n  rads: 'rads',\n  rads2: 'rads2'\n}; // ----------------------------------------------------------------------------\n// Utilities and helpers\n\n/**\n * Validate a resolution, throwing an error if invalid\n * @private\n * @param  {mixed} res Value to validate\n * @throws {Error}     Error if invalid\n */\n\nfunction validateRes(res) {\n  if (typeof res !== 'number' || res < 0 || res > 15 || Math.floor(res) !== res) {\n    throw new Error((\"Invalid resolution: \" + res));\n  }\n}\n\nvar INVALID_HEXIDECIMAL_CHAR = /[^0-9a-fA-F]/;\n/**\n * Convert an H3 index (64-bit hexidecimal string) into a \"split long\" - a pair of 32-bit ints\n * @private\n * @param  {H3IndexInput} h3Index  H3 index to check\n * @return {number[]}         A two-element array with 32 lower bits and 32 upper bits\n */\n\nfunction h3IndexToSplitLong(h3Index) {\n  if (Array.isArray(h3Index) && h3Index.length === 2 && Number.isInteger(h3Index[0]) && Number.isInteger(h3Index[1])) {\n    return h3Index;\n  }\n\n  if (typeof h3Index !== 'string' || INVALID_HEXIDECIMAL_CHAR.test(h3Index)) {\n    return [0, 0];\n  }\n\n  var upper = parseInt(h3Index.substring(0, h3Index.length - 8), BASE_16);\n  var lower = parseInt(h3Index.substring(h3Index.length - 8), BASE_16);\n  return [lower, upper];\n}\n/**\n * Convert a 32-bit int to a hexdecimal string\n * @private\n * @param  {number} num  Integer to convert\n * @return {H3Index}     Hexidecimal string\n */\n\nfunction hexFrom32Bit(num) {\n  if (num >= 0) {\n    return num.toString(BASE_16);\n  } // Handle negative numbers\n\n\n  num = num & 0x7fffffff;\n  var tempStr = zeroPad(8, num.toString(BASE_16));\n  var topNum = (parseInt(tempStr[0], BASE_16) + 8).toString(BASE_16);\n  tempStr = topNum + tempStr.substring(1);\n  return tempStr;\n}\n/**\n * Get a H3 index from a split long (pair of 32-bit ints)\n * @private\n * @param  {number} lower Lower 32 bits\n * @param  {number} upper Upper 32 bits\n * @return {H3Index}       H3 index\n */\n\n\nfunction splitLongToh3Index(lower, upper) {\n  return hexFrom32Bit(upper) + zeroPad(8, hexFrom32Bit(lower));\n}\n/**\n * Zero-pad a string to a given length\n * @private\n * @param  {number} fullLen Target length\n * @param  {string} numStr  String to zero-pad\n * @return {string}         Zero-padded string\n */\n\nfunction zeroPad(fullLen, numStr) {\n  var numZeroes = fullLen - numStr.length;\n  var outStr = '';\n\n  for (var i = 0; i < numZeroes; i++) {\n    outStr += '0';\n  }\n\n  outStr = outStr + numStr;\n  return outStr;\n}\n/**\n * Populate a C-appropriate Geofence struct from a polygon array\n * @private\n * @param  {Array[]} polygonArray Polygon, as an array of coordinate pairs\n * @param  {number}  geofence     C pointer to a Geofence struct\n * @param  {boolean} isGeoJson    Whether coordinates are in [lng, lat] order per GeoJSON spec\n * @return {number}               C pointer to populated Geofence struct\n */\n\n\nfunction polygonArrayToGeofence(polygonArray, geofence, isGeoJson) {\n  var numVerts = polygonArray.length;\n\n  var geoCoordArray = libh3._calloc(numVerts, SZ_GEOCOORD); // Support [lng, lat] pairs if GeoJSON is specified\n\n\n  var latIndex = isGeoJson ? 1 : 0;\n  var lngIndex = isGeoJson ? 0 : 1;\n\n  for (var i = 0; i < numVerts * 2; i += 2) {\n    libh3.HEAPF64.set([polygonArray[i / 2][latIndex], polygonArray[i / 2][lngIndex]].map(degsToRads), geoCoordArray / SZ_DBL + i);\n  }\n\n  libh3.HEAPU32.set([numVerts, geoCoordArray], geofence / SZ_INT);\n  return geofence;\n}\n/**\n * Create a C-appropriate GeoPolygon struct from an array of polygons\n * @private\n * @param  {Array[]} coordinates  Array of polygons, each an array of coordinate pairs\n * @param  {boolean} isGeoJson    Whether coordinates are in [lng, lat] order per GeoJSON spec\n * @return {number}               C pointer to populated GeoPolygon struct\n */\n\n\nfunction coordinatesToGeoPolygon(coordinates, isGeoJson) {\n  // Any loops beyond the first loop are holes\n  var numHoles = coordinates.length - 1;\n\n  var geoPolygon = libh3._calloc(SZ_GEOPOLYGON); // Byte positions within the struct\n\n\n  var geofenceOffset = 0;\n  var numHolesOffset = geofenceOffset + SZ_GEOFENCE;\n  var holesOffset = numHolesOffset + SZ_INT; // geofence is first part of struct\n\n  polygonArrayToGeofence(coordinates[0], geoPolygon + geofenceOffset, isGeoJson);\n  var holes;\n\n  if (numHoles > 0) {\n    holes = libh3._calloc(numHoles, SZ_GEOFENCE);\n\n    for (var i = 0; i < numHoles; i++) {\n      polygonArrayToGeofence(coordinates[i + 1], holes + SZ_GEOFENCE * i, isGeoJson);\n    }\n  }\n\n  libh3.setValue(geoPolygon + numHolesOffset, numHoles, 'i32');\n  libh3.setValue(geoPolygon + holesOffset, holes, 'i32');\n  return geoPolygon;\n}\n/**\n * Free memory allocated for a GeoPolygon struct. It is an error to access the struct\n * after passing it to this method.\n * @private\n * @return {number} geoPolygon C pointer to populated GeoPolygon struct\n */\n\n\nfunction destroyGeoPolygon(geoPolygon) {\n  // Byte positions within the struct\n  var geofenceOffset = 0;\n  var numHolesOffset = geofenceOffset + SZ_GEOFENCE;\n  var holesOffset = numHolesOffset + SZ_INT; // Offset of the geofence vertex array pointer within the Geofence struct\n\n  var geofenceArrayOffset = SZ_INT; // Free the outer vertex array\n\n  libh3._free(libh3.getValue(geoPolygon + geofenceOffset + geofenceArrayOffset, 'i8*')); // Free the vertex array for the holes, if any\n\n\n  var numHoles = libh3.getValue(geoPolygon + numHolesOffset, 'i32');\n\n  if (numHoles > 0) {\n    var holes = libh3.getValue(geoPolygon + holesOffset, 'i32');\n\n    for (var i = 0; i < numHoles; i++) {\n      libh3._free(libh3.getValue(holes + SZ_GEOFENCE * i + geofenceArrayOffset, 'i8*'));\n    }\n\n    libh3._free(holes);\n  }\n\n  libh3._free(geoPolygon);\n}\n/**\n * Read a long value, returning the lower and upper portions as separate 32-bit integers.\n * Because the upper bits are returned via side effect, the argument to this function is\n * intended to be the invocation that caused the side effect, e.g. readLong(H3.getSomeLong())\n * @private\n * @param  {number} invocation Invoked function returning a long value. The actual return\n *                             value of these functions is a 32-bit integer.\n * @return {number}            Long value as a [lower, upper] pair\n */\n\n\nfunction readLong(invocation) {\n  // Upper 32-bits of the long set via side-effect\n  var upper = libh3.getTempRet0();\n  return [invocation, upper];\n}\n/**\n * Read an H3 index from a C return value. As with readLong, the argument to this function\n * is intended to be an invocation, e.g. readH3Index(H3.getSomeAddress()), to help ensure that\n * the temp value storing the upper bits of the long is still set.\n * @private\n * @param  {number} invocation  Invoked function returning a single H3 index\n * @return {H3Index}            H3 index, or null if index was invalid\n */\n\n\nfunction readH3Index(invocation) {\n  var ref = readLong(invocation);\n  var lower = ref[0];\n  var upper = ref[1]; // The lower bits are allowed to be 0s, but if the upper bits are 0\n  // this represents an invalid H3 index\n\n  return upper ? splitLongToh3Index(lower, upper) : null;\n}\n/**\n * Read an H3 index from a pointer to C memory.\n * @private\n * @param  {number} cAddress  Pointer to allocated C memory\n * @param {number} offset     Offset, in number of H3 indexes, in case we're\n *                            reading an array\n * @return {H3Index}          H3 index, or null if index was invalid\n */\n\n\nfunction readH3IndexFromPointer(cAddress, offset) {\n  if ( offset === void 0 ) offset = 0;\n\n  var lower = libh3.getValue(cAddress + SZ_INT * offset * 2, 'i32');\n  var upper = libh3.getValue(cAddress + SZ_INT * (offset * 2 + 1), 'i32'); // The lower bits are allowed to be 0s, but if the upper bits are 0\n  // this represents an invalid H3 index\n\n  return upper ? splitLongToh3Index(lower, upper) : null;\n}\n/**\n * Store an H3 index in C memory. Primarily used as an efficient way to\n * write sets of hexagons.\n * @private\n * @param  {H3IndexInput} h3Index  H3 index to store\n * @param  {number} cAddress  Pointer to allocated C memory\n * @param {number} offset     Offset, in number of H3 indexes from beginning\n *                            of the current array\n */\n\n\nfunction storeH3Index(h3Index, cAddress, offset) {\n  // HEAPU32 is a typed array projection on the index space\n  // as unsigned 32-bit integers. This means the index needs\n  // to be divided by SZ_INT (4) to access correctly. Also,\n  // the H3 index is 64 bits, so we skip by twos as we're writing\n  // to 32-bit integers in the proper order.\n  libh3.HEAPU32.set(h3IndexToSplitLong(h3Index), cAddress / SZ_INT + 2 * offset);\n}\n/**\n * Read an array of 64-bit H3 indexes from C and convert to a JS array of\n * H3 index strings\n * @private\n * @param  {number} cAddress    Pointer to C ouput array\n * @param  {number} maxCount    Max number of hexagons in array. Hexagons with\n *                              the value 0 will be skipped, so this isn't\n *                              necessarily the length of the output array.\n * @return {H3Index[]}          Array of H3 indexes\n */\n\n\nfunction readArrayOfHexagons(cAddress, maxCount) {\n  var out = [];\n\n  for (var i = 0; i < maxCount; i++) {\n    var h3Index = readH3IndexFromPointer(cAddress, i);\n\n    if (h3Index !== null) {\n      out.push(h3Index);\n    }\n  }\n\n  return out;\n}\n/**\n * Store an array of H3 index strings as a C array of 64-bit integers.\n * @private\n * @param  {number} cAddress    Pointer to C input array\n * @param  {H3IndexInput[]} hexagons H3 indexes to pass to the C lib\n */\n\n\nfunction storeArrayOfHexagons(cAddress, hexagons) {\n  // Assuming the cAddress points to an already appropriately\n  // allocated space\n  var count = hexagons.length;\n\n  for (var i = 0; i < count; i++) {\n    storeH3Index(hexagons[i], cAddress, i);\n  }\n}\n/**\n * Populate a C-appropriate GeoCoord struct from a [lat, lng] array\n * @private\n * @param {number} lat     Coordinate latitude\n * @param {number} lng     Coordinate longitude\n * @return {number}        C pointer to populated GeoCoord struct\n */\n\n\nfunction storeGeoCoord(lat, lng) {\n  var geoCoord = libh3._calloc(1, SZ_GEOCOORD);\n\n  libh3.HEAPF64.set([lat, lng].map(degsToRads), geoCoord / SZ_DBL);\n  return geoCoord;\n}\n\nfunction readSingleCoord(cAddress) {\n  return radsToDegs(libh3.getValue(cAddress, 'double'));\n}\n/**\n * Read a GeoCoord from C and return a [lat, lng] pair.\n * @private\n * @param  {number} cAddress    Pointer to C struct\n * @return {number[]}           [lat, lng] pair\n */\n\n\nfunction readGeoCoord(cAddress) {\n  return [readSingleCoord(cAddress), readSingleCoord(cAddress + SZ_DBL)];\n}\n/**\n * Read a GeoCoord from C and return a GeoJSON-style [lng, lat] pair.\n * @private\n * @param  {number} cAddress    Pointer to C struct\n * @return {number[]}           [lng, lat] pair\n */\n\n\nfunction readGeoCoordGeoJson(cAddress) {\n  return [readSingleCoord(cAddress + SZ_DBL), readSingleCoord(cAddress)];\n}\n/**\n * Read the GeoBoundary structure into a list of geo coordinate pairs\n * @private\n * @param {number}  geoBoundary     C pointer to GeoBoundary struct\n * @param {boolean} geoJsonCoords   Whether to provide GeoJSON coordinate order: [lng, lat]\n * @param {boolean} closedLoop      Whether to close the loop\n * @return {Array[]}                Array of geo coordinate pairs\n */\n\n\nfunction readGeoBoundary(geoBoundary, geoJsonCoords, closedLoop) {\n  var numVerts = libh3.getValue(geoBoundary, 'i32'); // Note that though numVerts is an int, the coordinate doubles have to be\n  // aligned to 8 bytes, hence the 8-byte offset here\n\n  var vertsPos = geoBoundary + SZ_DBL;\n  var out = []; // Support [lng, lat] pairs if GeoJSON is specified\n\n  var readCoord = geoJsonCoords ? readGeoCoordGeoJson : readGeoCoord;\n\n  for (var i = 0; i < numVerts * 2; i += 2) {\n    out.push(readCoord(vertsPos + SZ_DBL * i));\n  }\n\n  if (closedLoop) {\n    // Close loop if GeoJSON is specified\n    out.push(out[0]);\n  }\n\n  return out;\n}\n/**\n * Read the LinkedGeoPolygon structure into a nested array of MultiPolygon coordinates\n * @private\n * @param {number}  polygon         C pointer to LinkedGeoPolygon struct\n * @param {boolean} formatAsGeoJson Whether to provide GeoJSON output: [lng, lat], closed loops\n * @return {number[][][][]}         MultiPolygon-style output.\n */\n\n\nfunction readMultiPolygon(polygon, formatAsGeoJson) {\n  var output = [];\n  var readCoord = formatAsGeoJson ? readGeoCoordGeoJson : readGeoCoord;\n  var loops;\n  var loop;\n  var coords;\n  var coord; // Loop through the linked structure, building the output\n\n  while (polygon) {\n    output.push(loops = []); // Follow ->first pointer\n\n    loop = libh3.getValue(polygon, 'i8*');\n\n    while (loop) {\n      loops.push(coords = []); // Follow ->first pointer\n\n      coord = libh3.getValue(loop, 'i8*');\n\n      while (coord) {\n        coords.push(readCoord(coord)); // Follow ->next pointer\n\n        coord = libh3.getValue(coord + SZ_DBL * 2, 'i8*');\n      }\n\n      if (formatAsGeoJson) {\n        // Close loop if GeoJSON is requested\n        coords.push(coords[0]);\n      } // Follow ->next pointer\n\n\n      loop = libh3.getValue(loop + SZ_PTR * 2, 'i8*');\n    } // Follow ->next pointer\n\n\n    polygon = libh3.getValue(polygon + SZ_PTR * 2, 'i8*');\n  }\n\n  return output;\n}\n/**\n * Read a CoordIJ from C and return an {i, j} pair.\n * @private\n * @param  {number} cAddress    Pointer to C struct\n * @return {CoordIJ}            {i, j} pair\n */\n\n\nfunction readCoordIJ(cAddress) {\n  return {\n    i: libh3.getValue(cAddress, 'i32'),\n    j: libh3.getValue(cAddress + SZ_INT, 'i32')\n  };\n}\n/**\n * Store an {i, j} pair to a C CoordIJ struct.\n * @private\n * @param  {number} cAddress    Pointer to C struct\n * @return {CoordIJ}            {i, j} pair\n */\n\n\nfunction storeCoordIJ(cAddress, ref) {\n  var i = ref.i;\n  var j = ref.j;\n\n  libh3.setValue(cAddress, i, 'i32');\n  libh3.setValue(cAddress + SZ_INT, j, 'i32');\n}\n/**\n * Read an array of positive integers array from C. Negative\n * values are considered invalid and ignored in output.\n * @private\n * @param  {number} cAddress    Pointer to C array\n * @param  {number} count       Length of C array\n * @return {number[]}           Javascript integer array\n */\n\n\nfunction readArrayOfPositiveIntegers(cAddress, count) {\n  var out = [];\n\n  for (var i = 0; i < count; i++) {\n    var int = libh3.getValue(cAddress + SZ_INT * i, 'i32');\n\n    if (int >= 0) {\n      out.push(int);\n    }\n  }\n\n  return out;\n} // ----------------------------------------------------------------------------\n// Public API functions: Core\n\n/**\n * Whether a given string represents a valid H3 index\n * @static\n * @param  {H3IndexInput} h3Index  H3 index to check\n * @return {boolean}          Whether the index is valid\n */\n\n\nfunction h3IsValid(h3Index) {\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n  return Boolean(H3.h3IsValid(lower, upper));\n}\n/**\n * Whether the given H3 index is a pentagon\n * @static\n * @param  {H3IndexInput} h3Index  H3 index to check\n * @return {boolean}          isPentagon\n */\n\nfunction h3IsPentagon(h3Index) {\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n  return Boolean(H3.h3IsPentagon(lower, upper));\n}\n/**\n * Whether the given H3 index is in a Class III resolution (rotated versus\n * the icosahedron and subject to shape distortion adding extra points on\n * icosahedron edges, making them not true hexagons).\n * @static\n * @param  {H3IndexInput} h3Index  H3 index to check\n * @return {boolean}          isResClassIII\n */\n\nfunction h3IsResClassIII(h3Index) {\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n  return Boolean(H3.h3IsResClassIII(lower, upper));\n}\n/**\n * Get the number of the base cell for a given H3 index\n * @static\n * @param  {H3IndexInput} h3Index  H3 index to get the base cell for\n * @return {number}           Index of the base cell (0-121)\n */\n\nfunction h3GetBaseCell(h3Index) {\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n  return H3.h3GetBaseCell(lower, upper);\n}\n/**\n * Get the indices of all icosahedron faces intersected by a given H3 index\n * @static\n * @param  {H3IndexInput} h3Index  H3 index to get faces for\n * @return {number[]}         Indices (0-19) of all intersected faces\n */\n\nfunction h3GetFaces(h3Index) {\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n  var count = H3.maxFaceCount(lower, upper);\n\n  var faces = libh3._malloc(SZ_INT * count);\n\n  H3.h3GetFaces(lower, upper, faces);\n  var out = readArrayOfPositiveIntegers(faces, count);\n\n  libh3._free(faces);\n\n  return out;\n}\n/**\n * Returns the resolution of an H3 index\n * @static\n * @param  {H3IndexInput} h3Index H3 index to get resolution\n * @return {number}          The number (0-15) resolution, or -1 if invalid\n */\n\nfunction h3GetResolution(h3Index) {\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n\n  if (!H3.h3IsValid(lower, upper)) {\n    // Compatability with stated API\n    return -1;\n  }\n\n  return H3.h3GetResolution(lower, upper);\n}\n/**\n * Get the hexagon containing a lat,lon point\n * @static\n * @param  {number} lat Latitude of point\n * @param  {number} lng Longtitude of point\n * @param  {number} res Resolution of hexagons to return\n * @return {H3Index}    H3 index\n */\n\nfunction geoToH3(lat, lng, res) {\n  var latlng = libh3._malloc(SZ_GEOCOORD); // Slightly more efficient way to set the memory\n\n\n  libh3.HEAPF64.set([lat, lng].map(degsToRads), latlng / SZ_DBL); // Read value as a split long\n\n  var h3Index = readH3Index(H3.geoToH3(latlng, res));\n\n  libh3._free(latlng);\n\n  return h3Index;\n}\n/**\n * Get the lat,lon center of a given hexagon\n * @static\n * @param  {H3IndexInput} h3Index  H3 index\n * @return {number[]}         Point as a [lat, lng] pair\n */\n\nfunction h3ToGeo(h3Index) {\n  var latlng = libh3._malloc(SZ_GEOCOORD);\n\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n  H3.h3ToGeo(lower, upper, latlng);\n  var out = readGeoCoord(latlng);\n\n  libh3._free(latlng);\n\n  return out;\n}\n/**\n * Get the vertices of a given hexagon (or pentagon), as an array of [lat, lng]\n * points. For pentagons and hexagons on the edge of an icosahedron face, this\n * function may return up to 10 vertices.\n * @static\n * @param  {H3Index} h3Index          H3 index\n * @param {boolean} [formatAsGeoJson] Whether to provide GeoJSON output: [lng, lat], closed loops\n * @return {number[][]}               Array of [lat, lng] pairs\n */\n\nfunction h3ToGeoBoundary(h3Index, formatAsGeoJson) {\n  var geoBoundary = libh3._malloc(SZ_GEOBOUNDARY);\n\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n  H3.h3ToGeoBoundary(lower, upper, geoBoundary);\n  var out = readGeoBoundary(geoBoundary, formatAsGeoJson, formatAsGeoJson);\n\n  libh3._free(geoBoundary);\n\n  return out;\n} // ----------------------------------------------------------------------------\n// Public API functions: Algorithms\n\n/**\n * Get the parent of the given hexagon at a particular resolution\n * @static\n * @param  {H3IndexInput} h3Index  H3 index to get parent for\n * @param  {number} res       Resolution of hexagon to return\n * @return {H3Index}          H3 index of parent, or null for invalid input\n */\n\nfunction h3ToParent(h3Index, res) {\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n  return readH3Index(H3.h3ToParent(lower, upper, res));\n}\n/**\n * Get the children/descendents of the given hexagon at a particular resolution\n * @static\n * @param  {H3IndexInput} h3Index  H3 index to get children for\n * @param  {number} res       Resolution of hexagons to return\n * @return {H3Index[]}        H3 indexes of children, or empty array for invalid input\n */\n\nfunction h3ToChildren(h3Index, res) {\n  // Bad input in this case can potentially result in high computation volume\n  // using the current C algorithm. Validate and return an empty array on failure.\n  if (!h3IsValid(h3Index)) {\n    return [];\n  }\n\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n  var maxCount = H3.maxH3ToChildrenSize(lower, upper, res);\n\n  var hexagons = libh3._calloc(maxCount, SZ_H3INDEX);\n\n  H3.h3ToChildren(lower, upper, res, hexagons);\n  var out = readArrayOfHexagons(hexagons, maxCount);\n\n  libh3._free(hexagons);\n\n  return out;\n}\n/**\n * Get the center child of the given hexagon at a particular resolution\n * @static\n * @param  {H3IndexInput} h3Index  H3 index to get center child for\n * @param  {number} res       Resolution of hexagon to return\n * @return {H3Index}          H3 index of child, or null for invalid input\n */\n\nfunction h3ToCenterChild(h3Index, res) {\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n  return readH3Index(H3.h3ToCenterChild(lower, upper, res));\n}\n/**\n * Get all hexagons in a k-ring around a given center. The order of the hexagons is undefined.\n * @static\n * @param  {H3IndexInput} h3Index  H3 index of center hexagon\n * @param  {number} ringSize  Radius of k-ring\n * @return {H3Index[]}        H3 indexes for all hexagons in ring\n */\n\nfunction kRing(h3Index, ringSize) {\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n  var maxCount = H3.maxKringSize(ringSize);\n\n  var hexagons = libh3._calloc(maxCount, SZ_H3INDEX);\n\n  H3.kRing(lower, upper, ringSize, hexagons);\n  var out = readArrayOfHexagons(hexagons, maxCount);\n\n  libh3._free(hexagons);\n\n  return out;\n}\n/**\n * Get all hexagons in a k-ring around a given center, in an array of arrays\n * ordered by distance from the origin. The order of the hexagons within each ring is undefined.\n * @static\n * @param  {H3IndexInput} h3Index  H3 index of center hexagon\n * @param  {number} ringSize  Radius of k-ring\n * @return {H3Index[][]}      Array of arrays with H3 indexes for all hexagons each ring\n */\n\nfunction kRingDistances(h3Index, ringSize) {\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n  var maxCount = H3.maxKringSize(ringSize);\n\n  var kRings = libh3._calloc(maxCount, SZ_H3INDEX);\n\n  var distances = libh3._calloc(maxCount, SZ_INT);\n\n  H3.kRingDistances(lower, upper, ringSize, kRings, distances); // Create an array of empty arrays to hold the output\n\n  var out = [];\n\n  for (var i = 0; i < ringSize + 1; i++) {\n    out.push([]);\n  } // Read the array of hexagons, putting them into the appropriate rings\n\n\n  for (var i$1 = 0; i$1 < maxCount * 2; i$1 += 2) {\n    var hexLower = libh3.getValue(kRings + SZ_INT * i$1, 'i32');\n    var hexUpper = libh3.getValue(kRings + SZ_INT * (i$1 + 1), 'i32');\n    var index = libh3.getValue(distances + SZ_INT * (i$1 / 2), 'i32');\n\n    if (hexLower !== 0 || hexUpper !== 0) {\n      out[index].push(splitLongToh3Index(hexLower, hexUpper));\n    }\n  }\n\n  libh3._free(kRings);\n\n  libh3._free(distances);\n\n  return out;\n}\n/**\n * Get all hexagons in a hollow hexagonal ring centered at origin with sides of a given length.\n * Unlike kRing, this function will throw an error if there is a pentagon anywhere in the ring.\n * @static\n * @param  {H3IndexInput} h3Index  H3 index of center hexagon\n * @param  {number} ringSize  Radius of ring\n * @return {H3Index[]}        H3 indexes for all hexagons in ring\n * @throws {Error}            If the algorithm could not calculate the ring\n */\n\nfunction hexRing(h3Index, ringSize) {\n  var maxCount = ringSize === 0 ? 1 : 6 * ringSize;\n\n  var hexagons = libh3._calloc(maxCount, SZ_H3INDEX);\n\n  var retVal = H3.hexRing.apply(H3, h3IndexToSplitLong(h3Index).concat( [ringSize], [hexagons] ));\n\n  if (retVal !== 0) {\n    libh3._free(hexagons);\n\n    throw new Error('Failed to get hexRing (encountered a pentagon?)');\n  }\n\n  var out = readArrayOfHexagons(hexagons, maxCount);\n\n  libh3._free(hexagons);\n\n  return out;\n}\n/**\n * Get all hexagons with centers contained in a given polygon. The polygon\n * is specified with GeoJson semantics as an array of loops. Each loop is\n * an array of [lat, lng] pairs (or [lng, lat] if isGeoJson is specified).\n * The first loop is the perimeter of the polygon, and subsequent loops are\n * expected to be holes.\n * @static\n * @param  {number[][] | number[][][]} coordinates\n *                                  Array of loops, or a single loop\n * @param  {number} res             Resolution of hexagons to return\n * @param  {boolean} [isGeoJson]    Whether to expect GeoJson-style [lng, lat]\n *                                  pairs instead of [lat, lng]\n * @return {H3Index[]}              H3 indexes for all hexagons in polygon\n */\n\nfunction polyfill(coordinates, res, isGeoJson) {\n  validateRes(res);\n  isGeoJson = Boolean(isGeoJson); // Guard against empty input\n\n  if (coordinates.length === 0 || coordinates[0].length === 0) {\n    return [];\n  } // Wrap to expected format if a single loop is provided\n\n\n  if (typeof coordinates[0][0] === 'number') {\n    coordinates = [coordinates];\n  }\n\n  var geoPolygon = coordinatesToGeoPolygon(coordinates, isGeoJson);\n  var arrayLen = H3.maxPolyfillSize(geoPolygon, res);\n\n  var hexagons = libh3._calloc(arrayLen, SZ_H3INDEX);\n\n  H3.polyfill(geoPolygon, res, hexagons);\n  var out = readArrayOfHexagons(hexagons, arrayLen);\n\n  libh3._free(hexagons);\n\n  destroyGeoPolygon(geoPolygon);\n  return out;\n}\n/**\n * Get the outlines of a set of H3 hexagons, returned in GeoJSON MultiPolygon\n * format (an array of polygons, each with an array of loops, each an array of\n * coordinates). Coordinates are returned as [lat, lng] pairs unless GeoJSON\n * is requested.\n *\n * It is the responsibility of the caller to ensure that all hexagons in the\n * set have the same resolution and that the set contains no duplicates. Behavior\n * is undefined if duplicates or multiple resolutions are present, and the\n * algorithm may produce unexpected or invalid polygons.\n *\n * @static\n * @param {H3IndexInput[]} h3Indexes       H3 indexes to get outlines for\n * @param {boolean} [formatAsGeoJson] Whether to provide GeoJSON output:\n *                                    [lng, lat], closed loops\n * @return {number[][][][]}           MultiPolygon-style output.\n */\n\nfunction h3SetToMultiPolygon(h3Indexes, formatAsGeoJson) {\n  // Early exit on empty input\n  if (!h3Indexes || !h3Indexes.length) {\n    return [];\n  } // Set up input set\n\n\n  var indexCount = h3Indexes.length;\n\n  var set = libh3._calloc(indexCount, SZ_H3INDEX);\n\n  storeArrayOfHexagons(set, h3Indexes); // Allocate memory for output linked polygon\n\n  var polygon = libh3._calloc(SZ_LINKED_GEOPOLYGON); // Store a reference to the first polygon - that's the one we need for\n  // memory deallocation\n\n\n  var originalPolygon = polygon;\n  H3.h3SetToLinkedGeo(set, indexCount, polygon);\n  var multiPolygon = readMultiPolygon(polygon, formatAsGeoJson); // Clean up\n\n  H3.destroyLinkedPolygon(originalPolygon);\n\n  libh3._free(originalPolygon);\n\n  libh3._free(set);\n\n  return multiPolygon;\n}\n/**\n * Compact a set of hexagons of the same resolution into a set of hexagons across\n * multiple levels that represents the same area.\n * @static\n * @param  {H3IndexInput[]} h3Set H3 indexes to compact\n * @return {H3Index[]}       Compacted H3 indexes\n * @throws {Error}           If the input is invalid (e.g. duplicate hexagons)\n */\n\nfunction compact(h3Set) {\n  if (!h3Set || !h3Set.length) {\n    return [];\n  } // Set up input set\n\n\n  var count = h3Set.length;\n\n  var set = libh3._calloc(count, SZ_H3INDEX);\n\n  storeArrayOfHexagons(set, h3Set); // Allocate memory for compacted hexagons, worst-case is no compaction\n\n  var compactedSet = libh3._calloc(count, SZ_H3INDEX);\n\n  var retVal = H3.compact(set, compactedSet, count);\n\n  if (retVal !== 0) {\n    libh3._free(set);\n\n    libh3._free(compactedSet);\n\n    throw new Error('Failed to compact, malformed input data (duplicate hexagons?)');\n  }\n\n  var out = readArrayOfHexagons(compactedSet, count);\n\n  libh3._free(set);\n\n  libh3._free(compactedSet);\n\n  return out;\n}\n/**\n * Uncompact a compacted set of hexagons to hexagons of the same resolution\n * @static\n * @param  {H3IndexInput[]} compactedSet H3 indexes to uncompact\n * @param  {number}    res          The resolution to uncompact to\n * @return {H3Index[]}              The uncompacted H3 indexes\n * @throws {Error}                  If the input is invalid (e.g. invalid resolution)\n */\n\nfunction uncompact(compactedSet, res) {\n  validateRes(res);\n\n  if (!compactedSet || !compactedSet.length) {\n    return [];\n  } // Set up input set\n\n\n  var count = compactedSet.length;\n\n  var set = libh3._calloc(count, SZ_H3INDEX);\n\n  storeArrayOfHexagons(set, compactedSet); // Estimate how many hexagons we need (always overestimates if in error)\n\n  var maxUncompactedNum = H3.maxUncompactSize(set, count, res); // Allocate memory for uncompacted hexagons\n\n  var uncompactedSet = libh3._calloc(maxUncompactedNum, SZ_H3INDEX);\n\n  var retVal = H3.uncompact(set, count, uncompactedSet, maxUncompactedNum, res);\n\n  if (retVal !== 0) {\n    libh3._free(set);\n\n    libh3._free(uncompactedSet);\n\n    throw new Error('Failed to uncompact (bad resolution?)');\n  }\n\n  var out = readArrayOfHexagons(uncompactedSet, maxUncompactedNum);\n\n  libh3._free(set);\n\n  libh3._free(uncompactedSet);\n\n  return out;\n} // ----------------------------------------------------------------------------\n// Public API functions: Unidirectional edges\n\n/**\n * Whether two H3 indexes are neighbors (share an edge)\n * @static\n * @param  {H3IndexInput} origin      Origin hexagon index\n * @param  {H3IndexInput} destination Destination hexagon index\n * @return {boolean}             Whether the hexagons share an edge\n */\n\nfunction h3IndexesAreNeighbors(origin, destination) {\n  var ref = h3IndexToSplitLong(origin);\n  var oLower = ref[0];\n  var oUpper = ref[1];\n  var ref$1 = h3IndexToSplitLong(destination);\n  var dLower = ref$1[0];\n  var dUpper = ref$1[1];\n  return Boolean(H3.h3IndexesAreNeighbors(oLower, oUpper, dLower, dUpper));\n}\n/**\n * Get an H3 index representing a unidirectional edge for a given origin and destination\n * @static\n * @param  {H3IndexInput} origin      Origin hexagon index\n * @param  {H3IndexInput} destination Destination hexagon index\n * @return {H3Index}             H3 index of the edge, or null if no edge is shared\n */\n\nfunction getH3UnidirectionalEdge(origin, destination) {\n  var ref = h3IndexToSplitLong(origin);\n  var oLower = ref[0];\n  var oUpper = ref[1];\n  var ref$1 = h3IndexToSplitLong(destination);\n  var dLower = ref$1[0];\n  var dUpper = ref$1[1];\n  return readH3Index(H3.getH3UnidirectionalEdge(oLower, oUpper, dLower, dUpper));\n}\n/**\n * Get the origin hexagon from an H3 index representing a unidirectional edge\n * @static\n * @param  {H3IndexInput} edgeIndex H3 index of the edge\n * @return {H3Index}           H3 index of the edge origin\n */\n\nfunction getOriginH3IndexFromUnidirectionalEdge(edgeIndex) {\n  var ref = h3IndexToSplitLong(edgeIndex);\n  var lower = ref[0];\n  var upper = ref[1];\n  return readH3Index(H3.getOriginH3IndexFromUnidirectionalEdge(lower, upper));\n}\n/**\n * Get the destination hexagon from an H3 index representing a unidirectional edge\n * @static\n * @param  {H3IndexInput} edgeIndex H3 index of the edge\n * @return {H3Index}           H3 index of the edge destination\n */\n\nfunction getDestinationH3IndexFromUnidirectionalEdge(edgeIndex) {\n  var ref = h3IndexToSplitLong(edgeIndex);\n  var lower = ref[0];\n  var upper = ref[1];\n  return readH3Index(H3.getDestinationH3IndexFromUnidirectionalEdge(lower, upper));\n}\n/**\n * Whether the input is a valid unidirectional edge\n * @static\n * @param  {H3IndexInput} edgeIndex H3 index of the edge\n * @return {boolean}           Whether the index is valid\n */\n\nfunction h3UnidirectionalEdgeIsValid(edgeIndex) {\n  var ref = h3IndexToSplitLong(edgeIndex);\n  var lower = ref[0];\n  var upper = ref[1];\n  return Boolean(H3.h3UnidirectionalEdgeIsValid(lower, upper));\n}\n/**\n * Get the [origin, destination] pair represented by a unidirectional edge\n * @static\n * @param  {H3IndexInput} edgeIndex H3 index of the edge\n * @return {H3Index[]}         [origin, destination] pair as H3 indexes\n */\n\nfunction getH3IndexesFromUnidirectionalEdge(edgeIndex) {\n  var ref = h3IndexToSplitLong(edgeIndex);\n  var lower = ref[0];\n  var upper = ref[1];\n  var count = 2;\n\n  var hexagons = libh3._calloc(count, SZ_H3INDEX);\n\n  H3.getH3IndexesFromUnidirectionalEdge(lower, upper, hexagons);\n  var out = readArrayOfHexagons(hexagons, count);\n\n  libh3._free(hexagons);\n\n  return out;\n}\n/**\n * Get all of the unidirectional edges with the given H3 index as the origin (i.e. an edge to\n * every neighbor)\n * @static\n * @param  {H3IndexInput} h3Index   H3 index of the origin hexagon\n * @return {H3Index[]}         List of unidirectional edges\n */\n\nfunction getH3UnidirectionalEdgesFromHexagon(h3Index) {\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n  var count = 6;\n\n  var edges = libh3._calloc(count, SZ_H3INDEX);\n\n  H3.getH3UnidirectionalEdgesFromHexagon(lower, upper, edges);\n  var out = readArrayOfHexagons(edges, count);\n\n  libh3._free(edges);\n\n  return out;\n}\n/**\n * Get the vertices of a given edge as an array of [lat, lng] points. Note that for edges that\n * cross the edge of an icosahedron face, this may return 3 coordinates.\n * @static\n * @param  {H3IndexInput} edgeIndex        H3 index of the edge\n * @param {boolean} [formatAsGeoJson] Whether to provide GeoJSON output: [lng, lat]\n * @return {number[][]}               Array of geo coordinate pairs\n */\n\nfunction getH3UnidirectionalEdgeBoundary(edgeIndex, formatAsGeoJson) {\n  var geoBoundary = libh3._malloc(SZ_GEOBOUNDARY);\n\n  var ref = h3IndexToSplitLong(edgeIndex);\n  var lower = ref[0];\n  var upper = ref[1];\n  H3.getH3UnidirectionalEdgeBoundary(lower, upper, geoBoundary);\n  var out = readGeoBoundary(geoBoundary, formatAsGeoJson);\n\n  libh3._free(geoBoundary);\n\n  return out;\n}\n/**\n * Get the grid distance between two hex indexes. This function may fail\n * to find the distance between two indexes if they are very far apart or\n * on opposite sides of a pentagon.\n * @static\n * @param  {H3IndexInput} origin      Origin hexagon index\n * @param  {H3IndexInput} destination Destination hexagon index\n * @return {number}              Distance between hexagons, or a negative\n *                               number if the distance could not be computed\n */\n\nfunction h3Distance(origin, destination) {\n  var ref = h3IndexToSplitLong(origin);\n  var oLower = ref[0];\n  var oUpper = ref[1];\n  var ref$1 = h3IndexToSplitLong(destination);\n  var dLower = ref$1[0];\n  var dUpper = ref$1[1];\n  return H3.h3Distance(oLower, oUpper, dLower, dUpper);\n}\n/**\n * Given two H3 indexes, return the line of indexes between them (inclusive).\n *\n * This function may fail to find the line between two indexes, for\n * example if they are very far apart. It may also fail when finding\n * distances for indexes on opposite sides of a pentagon.\n *\n * Notes:\n *\n *  - The specific output of this function should not be considered stable\n *    across library versions. The only guarantees the library provides are\n *    that the line length will be `h3Distance(start, end) + 1` and that\n *    every index in the line will be a neighbor of the preceding index.\n *  - Lines are drawn in grid space, and may not correspond exactly to either\n *    Cartesian lines or great arcs.\n *\n * @static\n * @param  {H3IndexInput} origin      Origin hexagon index\n * @param  {H3IndexInput} destination Destination hexagon index\n * @return {H3Index[]}           H3 indexes connecting origin and destination\n * @throws {Error}               If the line cannot be calculated\n */\n\nfunction h3Line(origin, destination) {\n  var ref = h3IndexToSplitLong(origin);\n  var oLower = ref[0];\n  var oUpper = ref[1];\n  var ref$1 = h3IndexToSplitLong(destination);\n  var dLower = ref$1[0];\n  var dUpper = ref$1[1];\n  var count = H3.h3LineSize(oLower, oUpper, dLower, dUpper);\n\n  if (count < 0) {\n    // We can't get the specific error code here - may be any of\n    // the errors possible in experimentalH3ToLocalIj\n    throw new Error('Line cannot be calculated');\n  }\n\n  var hexagons = libh3._calloc(count, SZ_H3INDEX);\n\n  H3.h3Line(oLower, oUpper, dLower, dUpper, hexagons);\n  var out = readArrayOfHexagons(hexagons, count);\n\n  libh3._free(hexagons);\n\n  return out;\n}\n/**\n * Produces IJ coordinates for an H3 index anchored by an origin.\n *\n * - The coordinate space used by this function may have deleted\n * regions or warping due to pentagonal distortion.\n * - Coordinates are only comparable if they come from the same\n * origin index.\n * - Failure may occur if the index is too far away from the origin\n * or if the index is on the other side of a pentagon.\n * - This function is experimental, and its output is not guaranteed\n * to be compatible across different versions of H3.\n * @static\n * @param  {H3IndexInput} origin      Origin H3 index\n * @param  {H3IndexInput} destination H3 index for which to find relative coordinates\n * @return {CoordIJ}             Coordinates as an `{i, j}` pair\n * @throws {Error}               If the IJ coordinates cannot be calculated\n */\n\nfunction experimentalH3ToLocalIj(origin, destination) {\n  var ij = libh3._malloc(SZ_COORDIJ);\n\n  var retVal = H3.experimentalH3ToLocalIj.apply(H3, h3IndexToSplitLong(origin).concat( h3IndexToSplitLong(destination), [ij] ));\n  var coords = readCoordIJ(ij);\n\n  libh3._free(ij); // Return the pair, or throw if an error code was returned.\n  // Switch statement and error codes cribbed from h3-java's implementation.\n\n\n  switch (retVal) {\n    case 0:\n      return coords;\n\n    case 1:\n      throw new Error('Incompatible origin and index.');\n\n    case 2:\n    default:\n      throw new Error('Local IJ coordinates undefined for this origin and index pair. ' + 'The index may be too far from the origin.');\n\n    case 3:\n    case 4:\n    case 5:\n      throw new Error('Encountered possible pentagon distortion');\n  }\n}\n/**\n * Produces an H3 index for IJ coordinates anchored by an origin.\n *\n * - The coordinate space used by this function may have deleted\n * regions or warping due to pentagonal distortion.\n * - Coordinates are only comparable if they come from the same\n * origin index.\n * - Failure may occur if the index is too far away from the origin\n * or if the index is on the other side of a pentagon.\n * - This function is experimental, and its output is not guaranteed\n * to be compatible across different versions of H3.\n * @static\n * @param  {H3IndexInput} origin     Origin H3 index\n * @param  {CoordIJ} coords     Coordinates as an `{i, j}` pair\n * @return {H3Index}            H3 index at the relative coordinates\n * @throws {Error}              If the H3 index cannot be calculated\n */\n\nfunction experimentalLocalIjToH3(origin, coords) {\n  // Validate input coords\n  if (!coords || typeof coords.i !== 'number' || typeof coords.j !== 'number') {\n    throw new Error('Coordinates must be provided as an {i, j} object');\n  } // Allocate memory for the CoordIJ struct and an H3 index to hold the return value\n\n\n  var ij = libh3._malloc(SZ_COORDIJ);\n\n  var out = libh3._malloc(SZ_H3INDEX);\n\n  storeCoordIJ(ij, coords);\n  var retVal = H3.experimentalLocalIjToH3.apply(H3, h3IndexToSplitLong(origin).concat( [ij], [out] ));\n  var h3Index = readH3IndexFromPointer(out);\n\n  libh3._free(ij);\n\n  libh3._free(out);\n\n  if (retVal !== 0) {\n    throw new Error('Index not defined for this origin and IJ coordinates pair. ' + 'IJ coordinates may be too far from origin, or ' + 'a pentagon distortion was encountered.');\n  }\n\n  return h3Index;\n} // ----------------------------------------------------------------------------\n// Public API functions: Distance/area utilities\n\n/**\n * Great circle distance between two geo points. This is not specific to H3,\n * but is implemented in the library and provided here as a convenience.\n * @static\n * @param  {number[]} latlng1 Origin coordinate as [lat, lng]\n * @param  {number[]} latlng2 Destination coordinate as [lat, lng]\n * @param  {string}   unit    Distance unit (either UNITS.m or UNITS.km)\n * @return {number}           Great circle distance\n * @throws {Error}            If the unit is invalid\n */\n\nfunction pointDist(latlng1, latlng2, unit) {\n  var coord1 = storeGeoCoord(latlng1[0], latlng1[1]);\n  var coord2 = storeGeoCoord(latlng2[0], latlng2[1]);\n  var result;\n\n  switch (unit) {\n    case UNITS.m:\n      result = H3.pointDistM(coord1, coord2);\n      break;\n\n    case UNITS.km:\n      result = H3.pointDistKm(coord1, coord2);\n      break;\n\n    case UNITS.rads:\n      result = H3.pointDistRads(coord1, coord2);\n      break;\n\n    default:\n      result = null;\n  }\n\n  libh3._free(coord1);\n\n  libh3._free(coord2);\n\n  if (result === null) {\n    throw new Error((\"Unknown unit: \" + unit));\n  }\n\n  return result;\n}\n/**\n * Exact area of a given cell\n * @static\n * @param  {H3Index} h3Index  H3 index of the hexagon to measure\n * @param  {string}  unit     Distance unit (either UNITS.m2 or UNITS.km2)\n * @return {number}           Cell area\n * @throws {Error}            If the unit is invalid\n */\n\nfunction cellArea(h3Index, unit) {\n  var ref = h3IndexToSplitLong(h3Index);\n  var lower = ref[0];\n  var upper = ref[1];\n\n  switch (unit) {\n    case UNITS.m2:\n      return H3.cellAreaM2(lower, upper);\n\n    case UNITS.km2:\n      return H3.cellAreaKm2(lower, upper);\n\n    case UNITS.rads2:\n      return H3.cellAreaRads2(lower, upper);\n\n    default:\n      throw new Error((\"Unknown unit: \" + unit));\n  }\n}\n/**\n * Exact length of a given unidirectional edge\n * @static\n * @param  {H3Index} edge     H3 index of the edge to measure\n * @param  {string}  unit     Distance unit (either UNITS.m, UNITS.km, or UNITS.rads)\n * @return {number}           Cell area\n * @throws {Error}            If the unit is invalid\n */\n\nfunction exactEdgeLength(edge, unit) {\n  var ref = h3IndexToSplitLong(edge);\n  var lower = ref[0];\n  var upper = ref[1];\n\n  switch (unit) {\n    case UNITS.m:\n      return H3.exactEdgeLengthM(lower, upper);\n\n    case UNITS.km:\n      return H3.exactEdgeLengthKm(lower, upper);\n\n    case UNITS.rads:\n      return H3.exactEdgeLengthRads(lower, upper);\n\n    default:\n      throw new Error((\"Unknown unit: \" + unit));\n  }\n}\n/**\n * Average hexagon area at a given resolution\n * @static\n * @param  {number} res  Hexagon resolution\n * @param  {string} unit Area unit (either UNITS.m2, UNITS.km2, or UNITS.rads2)\n * @return {number}      Average area\n * @throws {Error}       If the unit is invalid\n */\n\nfunction hexArea(res, unit) {\n  validateRes(res);\n\n  switch (unit) {\n    case UNITS.m2:\n      return H3.hexAreaM2(res);\n\n    case UNITS.km2:\n      return H3.hexAreaKm2(res);\n\n    default:\n      throw new Error((\"Unknown unit: \" + unit));\n  }\n}\n/**\n * Average hexagon edge length at a given resolution\n * @static\n * @param  {number} res  Hexagon resolution\n * @param  {string} unit Distance unit (either UNITS.m, UNITS.km, or UNITS.rads)\n * @return {number}      Average edge length\n * @throws {Error}       If the unit is invalid\n */\n\nfunction edgeLength(res, unit) {\n  validateRes(res);\n\n  switch (unit) {\n    case UNITS.m:\n      return H3.edgeLengthM(res);\n\n    case UNITS.km:\n      return H3.edgeLengthKm(res);\n\n    default:\n      throw new Error((\"Unknown unit: \" + unit));\n  }\n} // ----------------------------------------------------------------------------\n// Public informational utilities\n\n/**\n * The total count of hexagons in the world at a given resolution. Note that above\n * resolution 8 the exact count cannot be represented in a JavaScript 32-bit number,\n * so consumers should use caution when applying further operations to the output.\n * @static\n * @param  {number} res  Hexagon resolution\n * @return {number}      Count\n */\n\nfunction numHexagons(res) {\n  validateRes(res); // Get number as a long value\n\n  var ref = readLong(H3.numHexagons(res));\n  var lower = ref[0];\n  var upper = ref[1]; // If we're using <= 32 bits we can use normal JS numbers\n\n  if (!upper) {\n    return lower;\n  } // Above 32 bit, make a JS number that's correct in order of magnitude\n\n\n  return upper * Math.pow(2, 32) + lower;\n}\n/**\n * Get all H3 indexes at resolution 0. As every index at every resolution > 0 is\n * the descendant of a res 0 index, this can be used with h3ToChildren to iterate\n * over H3 indexes at any resolution.\n * @static\n * @return {H3Index[]}  All H3 indexes at res 0\n */\n\nfunction getRes0Indexes() {\n  var count = H3.res0IndexCount();\n\n  var hexagons = libh3._malloc(SZ_H3INDEX * count);\n\n  H3.getRes0Indexes(hexagons);\n  var out = readArrayOfHexagons(hexagons, count);\n\n  libh3._free(hexagons);\n\n  return out;\n}\n/**\n * Get the twelve pentagon indexes at a given resolution.\n * @static\n * @param  {number} res  Hexagon resolution\n * @return {H3Index[]}  All H3 pentagon indexes at res\n */\n\nfunction getPentagonIndexes(res) {\n  validateRes(res);\n  var count = H3.pentagonIndexCount();\n\n  var hexagons = libh3._malloc(SZ_H3INDEX * count);\n\n  H3.getPentagonIndexes(res, hexagons);\n  var out = readArrayOfHexagons(hexagons, count);\n\n  libh3._free(hexagons);\n\n  return out;\n}\n/**\n * Convert degrees to radians\n * @static\n * @param  {number} deg Value in degrees\n * @return {number}     Value in radians\n */\n\nfunction degsToRads(deg) {\n  return deg * Math.PI / 180;\n}\n/**\n * Convert radians to degrees\n * @static\n * @param  {number} rad Value in radians\n * @return {number}     Value in degrees\n */\n\nfunction radsToDegs(rad) {\n  return rad * 180 / Math.PI;\n}\n\nexport { UNITS, h3IndexToSplitLong, splitLongToh3Index, h3IsValid, h3IsPentagon, h3IsResClassIII, h3GetBaseCell, h3GetFaces, h3GetResolution, geoToH3, h3ToGeo, h3ToGeoBoundary, h3ToParent, h3ToChildren, h3ToCenterChild, kRing, kRingDistances, hexRing, polyfill, h3SetToMultiPolygon, compact, uncompact, h3IndexesAreNeighbors, getH3UnidirectionalEdge, getOriginH3IndexFromUnidirectionalEdge, getDestinationH3IndexFromUnidirectionalEdge, h3UnidirectionalEdgeIsValid, getH3IndexesFromUnidirectionalEdge, getH3UnidirectionalEdgesFromHexagon, getH3UnidirectionalEdgeBoundary, h3Distance, h3Line, experimentalH3ToLocalIj, experimentalLocalIjToH3, pointDist, cellArea, exactEdgeLength, hexArea, edgeLength, numHexagons, getRes0Indexes, getPentagonIndexes, degsToRads, radsToDegs };\n//# sourceMappingURL=h3-js.es.js.map\n","import {\n  h3ToGeoBoundary,\n  h3GetResolution,\n  h3ToGeo,\n  geoToH3,\n  h3IsPentagon,\n  h3Distance,\n  edgeLength,\n  H3Index\n} from 'h3-js';\nimport {lerp} from '@math.gl/core';\nimport {\n  AccessorFunction,\n  CompositeLayer,\n  CompositeLayerProps,\n  createIterable,\n  Layer,\n  LayersList,\n  UpdateParameters,\n  WebMercatorViewport,\n  DefaultProps\n} from '@deck.gl/core';\nimport {ColumnLayer, PolygonLayer, PolygonLayerProps} from '@deck.gl/layers';\n\n// There is a cost to updating the instanced geometries when using highPrecision: false\n// This constant defines the distance between two hexagons that leads to \"significant\n// distortion.\" Smaller value makes the column layer more sensitive to viewport change.\nconst UPDATE_THRESHOLD_KM = 10;\n\n// normalize longitudes w.r.t center (refLng), when not provided first vertex\nexport function normalizeLongitudes(vertices: number[][], refLng?: number): void {\n  refLng = refLng === undefined ? vertices[0][0] : refLng;\n  for (const pt of vertices) {\n    const deltaLng = pt[0] - refLng;\n    if (deltaLng > 180) {\n      pt[0] -= 360;\n    } else if (deltaLng < -180) {\n      pt[0] += 360;\n    }\n  }\n}\n\n// scale polygon vertices w.r.t center (hexId)\nexport function scalePolygon(hexId: H3Index, vertices: number[][], factor: number): void {\n  const [lat, lng] = h3ToGeo(hexId);\n  const actualCount = vertices.length;\n\n  // normalize with respect to center\n  normalizeLongitudes(vertices, lng);\n\n  // `h3ToGeoBoundary` returns same array object for first and last vertex (closed polygon),\n  // if so skip scaling the last vertex\n  const vertexCount = vertices[0] === vertices[actualCount - 1] ? actualCount - 1 : actualCount;\n  for (let i = 0; i < vertexCount; i++) {\n    vertices[i][0] = lerp(lng, vertices[i][0], factor);\n    vertices[i][1] = lerp(lat, vertices[i][1], factor);\n  }\n}\n\nfunction getHexagonCentroid(getHexagon, object, objectInfo) {\n  const hexagonId = getHexagon(object, objectInfo);\n  const [lat, lng] = h3ToGeo(hexagonId);\n  return [lng, lat];\n}\n\nfunction h3ToPolygon(hexId: H3Index, coverage: number = 1): number[][] {\n  const vertices = h3ToGeoBoundary(hexId, true);\n\n  if (coverage !== 1) {\n    // scale and normalize vertices w.r.t to center\n    scalePolygon(hexId, vertices, coverage);\n  } else {\n    // normalize w.r.t to start vertex\n    normalizeLongitudes(vertices);\n  }\n\n  return vertices;\n}\n\nfunction flattenPolygon(vertices: number[][]): Float64Array {\n  const positions = new Float64Array(vertices.length * 2);\n  let i = 0;\n  for (const pt of vertices) {\n    positions[i++] = pt[0];\n    positions[i++] = pt[1];\n  }\n  return positions;\n}\n\nfunction mergeTriggers(getHexagon, coverage) {\n  let trigger;\n  if (getHexagon === undefined || getHexagon === null) {\n    trigger = coverage;\n  } else if (typeof getHexagon === 'object') {\n    trigger = {...getHexagon, coverage};\n  } else {\n    trigger = {getHexagon, coverage};\n  }\n  return trigger;\n}\n\nconst defaultProps: DefaultProps<H3HexagonLayerProps> = {\n  ...PolygonLayer.defaultProps,\n  highPrecision: 'auto',\n  coverage: {type: 'number', min: 0, max: 1, value: 1},\n  centerHexagon: null,\n  getHexagon: {type: 'accessor', value: x => x.hexagon},\n  extruded: true\n};\n\n/** All properties supported by H3HexagonLayer */\nexport type H3HexagonLayerProps<DataT = any> = _H3HexagonLayerProps<DataT> &\n  PolygonLayerProps<DataT> &\n  CompositeLayerProps<DataT>;\n\n/** Props added by the H3HexagonLayer */\ntype _H3HexagonLayerProps<DataT> = {\n  /**\n   * Whether or not draw hexagons with high precision.\n   * @default 'auto'\n   */\n  highPrecision?: boolean | 'auto';\n  /**\n   * Coverage of hexagon in cell.\n   * @default 1\n   */\n  coverage?: number;\n  /**\n   * Center hexagon that best represents the shape of the set. If not specified, the hexagon closest to the center of the viewport is used.\n   */\n  centerHexagon?: H3Index | null;\n  /**\n   * Called for each data object to retrieve the quadkey string identifier.\n   *\n   * By default, it reads `hexagon` property of data object.\n   */\n  getHexagon?: AccessorFunction<DataT, string>;\n  /**\n   * Whether to extrude polygons.\n   * @default true\n   */\n  extruded?: boolean;\n};\n\n/**\n * Render hexagons from the [H3](https://h3geo.org/) geospatial indexing system.\n */\nexport default class H3HexagonLayer<DataT = any, ExtraPropsT = {}> extends CompositeLayer<\n  ExtraPropsT & Required<_H3HexagonLayerProps<DataT> & Required<PolygonLayerProps<DataT>>>\n> {\n  static defaultProps = defaultProps;\n  static layerName = 'H3HexagonLayer';\n\n  // See `main/bundle.ts`\n  static _checkH3Lib = () => {};\n\n  initializeState() {\n    H3HexagonLayer._checkH3Lib();\n    this.state = {\n      edgeLengthKM: 0,\n      resolution: -1\n    };\n  }\n\n  state!: {\n    centerHex?: H3Index;\n    edgeLengthKM: number;\n    hasMultipleRes?: boolean;\n    hasPentagon?: boolean;\n    resolution: number;\n    vertices?: number[][];\n  };\n\n  shouldUpdateState({changeFlags}: UpdateParameters<this>): boolean {\n    return this._shouldUseHighPrecision()\n      ? changeFlags.propsOrDataChanged\n      : changeFlags.somethingChanged;\n  }\n\n  updateState({props, changeFlags}: UpdateParameters<this>): void {\n    if (\n      props.highPrecision !== true &&\n      (changeFlags.dataChanged ||\n        (changeFlags.updateTriggersChanged && changeFlags.updateTriggersChanged.getHexagon))\n    ) {\n      const dataProps = this._calculateH3DataProps();\n      this.setState(dataProps);\n    }\n\n    this._updateVertices(this.context.viewport as WebMercatorViewport);\n  }\n\n  private _calculateH3DataProps() {\n    let resolution = -1;\n    let hasPentagon = false;\n    let hasMultipleRes = false;\n\n    const {iterable, objectInfo} = createIterable(this.props.data);\n    for (const object of iterable) {\n      objectInfo.index++;\n      const hexId = this.props.getHexagon(object, objectInfo);\n      // Take the resolution of the first hex\n      const hexResolution = h3GetResolution(hexId);\n      if (resolution < 0) {\n        resolution = hexResolution;\n        if (!this.props.highPrecision) break;\n      } else if (resolution !== hexResolution) {\n        hasMultipleRes = true;\n        break;\n      }\n      if (h3IsPentagon(hexId)) {\n        hasPentagon = true;\n        break;\n      }\n    }\n\n    return {\n      resolution,\n      edgeLengthKM: resolution >= 0 ? edgeLength(resolution, 'km') : 0,\n      hasMultipleRes,\n      hasPentagon\n    };\n  }\n\n  private _shouldUseHighPrecision(): boolean {\n    if (this.props.highPrecision === 'auto') {\n      const {resolution, hasPentagon, hasMultipleRes} = this.state;\n      const {viewport} = this.context;\n      return (\n        Boolean(viewport?.resolution) ||\n        hasMultipleRes ||\n        hasPentagon ||\n        (resolution >= 0 && resolution <= 5)\n      );\n    }\n\n    return this.props.highPrecision;\n  }\n\n  private _updateVertices(viewport: WebMercatorViewport): void {\n    if (this._shouldUseHighPrecision()) {\n      return;\n    }\n    const {resolution, edgeLengthKM, centerHex} = this.state;\n    if (resolution < 0) {\n      return;\n    }\n    const hex =\n      this.props.centerHexagon || geoToH3(viewport.latitude, viewport.longitude, resolution);\n    if (centerHex === hex) {\n      return;\n    }\n    if (centerHex) {\n      const distance = h3Distance(centerHex, hex);\n      // h3Distance returns a negative number if the distance could not be computed\n      // due to the two indexes very far apart or on opposite sides of a pentagon.\n      if (distance >= 0 && distance * edgeLengthKM < UPDATE_THRESHOLD_KM) {\n        return;\n      }\n    }\n\n    const {unitsPerMeter} = viewport.distanceScales;\n\n    let vertices = h3ToPolygon(hex);\n    const [centerLat, centerLng] = h3ToGeo(hex);\n\n    const [centerX, centerY] = viewport.projectFlat([centerLng, centerLat]);\n    vertices = vertices.map(p => {\n      const worldPosition = viewport.projectFlat(p);\n      return [\n        (worldPosition[0] - centerX) / unitsPerMeter[0],\n        (worldPosition[1] - centerY) / unitsPerMeter[1]\n      ];\n    });\n\n    this.setState({centerHex: hex, vertices});\n  }\n\n  renderLayers(): Layer | null | LayersList {\n    return this._shouldUseHighPrecision() ? this._renderPolygonLayer() : this._renderColumnLayer();\n  }\n\n  private _getForwardProps() {\n    const {\n      elevationScale,\n      material,\n      coverage,\n      extruded,\n      wireframe,\n      stroked,\n      filled,\n      lineWidthUnits,\n      lineWidthScale,\n      lineWidthMinPixels,\n      lineWidthMaxPixels,\n      getFillColor,\n      getElevation,\n      getLineColor,\n      getLineWidth,\n      transitions,\n      updateTriggers\n    } = this.props;\n\n    return {\n      elevationScale,\n      extruded,\n      coverage,\n      wireframe,\n      stroked,\n      filled,\n      lineWidthUnits,\n      lineWidthScale,\n      lineWidthMinPixels,\n      lineWidthMaxPixels,\n      material,\n      getElevation,\n      getFillColor,\n      getLineColor,\n      getLineWidth,\n      transitions,\n      updateTriggers: {\n        getFillColor: updateTriggers.getFillColor,\n        getElevation: updateTriggers.getElevation,\n        getLineColor: updateTriggers.getLineColor,\n        getLineWidth: updateTriggers.getLineWidth\n      } as {\n        getFillColor: any;\n        getElevation: any;\n        getLineColor: any;\n        getLineWidth: any;\n        getPolygon?: any;\n        getPosition?: any;\n      }\n    };\n  }\n\n  private _renderPolygonLayer(): PolygonLayer {\n    const {data, getHexagon, updateTriggers, coverage} = this.props;\n\n    const SubLayerClass = this.getSubLayerClass('hexagon-cell-hifi', PolygonLayer);\n    const forwardProps = this._getForwardProps();\n    forwardProps.updateTriggers.getPolygon = mergeTriggers(updateTriggers.getHexagon, coverage);\n\n    return new SubLayerClass(\n      forwardProps,\n      this.getSubLayerProps({\n        id: 'hexagon-cell-hifi',\n        updateTriggers: forwardProps.updateTriggers\n      }),\n      {\n        data,\n        _normalize: false,\n        _windingOrder: 'CCW',\n        positionFormat: 'XY',\n        getPolygon: (object, objectInfo) => {\n          const hexagonId = getHexagon(object, objectInfo);\n          return flattenPolygon(h3ToPolygon(hexagonId, coverage));\n        }\n      }\n    );\n  }\n\n  private _renderColumnLayer(): ColumnLayer {\n    const {data, getHexagon, updateTriggers} = this.props;\n\n    const SubLayerClass = this.getSubLayerClass('hexagon-cell', ColumnLayer);\n    const forwardProps = this._getForwardProps();\n    forwardProps.updateTriggers.getPosition = updateTriggers.getHexagon;\n\n    return new SubLayerClass(\n      forwardProps,\n      this.getSubLayerProps({\n        id: 'hexagon-cell',\n        flatShading: true,\n        updateTriggers: forwardProps.updateTriggers\n      }),\n      {\n        data,\n        diskResolution: 6, // generate an extruded hexagon as the base geometry\n        radius: 1,\n        vertices: this.state.vertices,\n        getPosition: getHexagonCentroid.bind(null, getHexagon)\n      }\n    );\n  }\n}\n","import {h3SetToMultiPolygon, H3IndexInput} from 'h3-js';\n\nimport {AccessorFunction, createIterable, UpdateParameters, DefaultProps} from '@deck.gl/core';\nimport {H3HexagonLayer} from '@deck.gl/geo-layers';\nimport GeoCellLayer, {GeoCellLayerProps} from '../geo-cell-layer/GeoCellLayer';\n\nconst defaultProps: DefaultProps<H3ClusterLayerProps> = {\n  getHexagons: {type: 'accessor', value: d => d.hexagons}\n};\n\n/** All properties supported by H3ClusterLayer. */\nexport type H3ClusterLayerProps<DataT = any> = _H3ClusterLayerProps<DataT> &\n  GeoCellLayerProps<DataT>;\n\n/** Properties added by H3ClusterLayer. */\ntype _H3ClusterLayerProps<DataT> = {\n  /**\n   * Called for each data object to retrieve the hexagon identifiers.\n   *\n   * By default, it reads `hexagons` property of data object.\n   */\n  getHexagons?: AccessorFunction<DataT, H3IndexInput[]>;\n};\n\nexport default class H3ClusterLayer<DataT = any, ExtraProps = {}> extends GeoCellLayer<\n  DataT,\n  Required<_H3ClusterLayerProps<DataT>> & ExtraProps\n> {\n  static layerName = 'H3ClusterLayer';\n  static defaultProps = defaultProps;\n\n  initializeState(): void {\n    H3HexagonLayer._checkH3Lib();\n  }\n\n  updateState({props, changeFlags}: UpdateParameters<this>): void {\n    if (\n      changeFlags.dataChanged ||\n      (changeFlags.updateTriggersChanged && changeFlags.updateTriggersChanged.getHexagons)\n    ) {\n      const {data, getHexagons} = props;\n      const polygons: {polygon: number[][][]}[] = [];\n\n      const {iterable, objectInfo} = createIterable(data);\n      for (const object of iterable) {\n        objectInfo.index++;\n        const hexagons = getHexagons(object, objectInfo);\n        const multiPolygon = h3SetToMultiPolygon(hexagons, true);\n\n        for (const polygon of multiPolygon) {\n          polygons.push(this.getSubLayerRow({polygon}, object, objectInfo.index));\n        }\n      }\n\n      this.setState({polygons});\n    }\n  }\n\n  indexToBounds(): Partial<GeoCellLayer['props']> {\n    return {\n      data: this.state.polygons,\n      getPolygon: d => d.polygon\n    };\n  }\n}\n","import type {NumericArray} from '@math.gl/core';\nimport {GLTFMaterialParser} from '@luma.gl/experimental';\nimport {Model, pbr} from '@luma.gl/core';\nimport GL from '@luma.gl/constants';\nimport type {MeshAttribute, MeshAttributes} from '@loaders.gl/schema';\nimport type {UpdateParameters, DefaultProps, LayerContext} from '@deck.gl/core';\nimport {SimpleMeshLayer, SimpleMeshLayerProps} from '@deck.gl/mesh-layers';\n\nimport vs from './mesh-layer-vertex.glsl';\nimport fs from './mesh-layer-fragment.glsl';\n\nexport type Mesh = {\n  attributes: MeshAttributes;\n  indices?: MeshAttribute;\n};\n\nfunction validateGeometryAttributes(attributes) {\n  const hasColorAttribute = attributes.COLOR_0 || attributes.colors;\n  if (!hasColorAttribute) {\n    attributes.colors = {constant: true, value: new Float32Array([1, 1, 1])};\n  }\n}\n\nconst defaultProps: DefaultProps<MeshLayerProps> = {\n  pbrMaterial: {type: 'object', value: null},\n  featureIds: {type: 'array', value: null, optional: true}\n};\n\n/** All properties supported by MeshLayer. */\nexport type MeshLayerProps<DataT = any> = _MeshLayerProps<DataT> & SimpleMeshLayerProps<DataT>;\n\n/** Properties added by MeshLayer. */\ntype _MeshLayerProps<DataT> = {\n  /**\n   * PBR material object. _lighting must be pbr for this to work\n   */\n  pbrMaterial?: any; // TODO add type when converting Tile3DLayer\n\n  /**\n   * List of feature ids.\n   */\n  featureIds?: NumericArray | null;\n};\n\nexport default class MeshLayer<DataT = any, ExtraProps = {}> extends SimpleMeshLayer<\n  DataT,\n  Required<_MeshLayerProps<DataT>> & ExtraProps\n> {\n  static layerName = 'MeshLayer';\n  static defaultProps = defaultProps;\n\n  getShaders() {\n    const shaders = super.getShaders();\n    const modules = shaders.modules;\n    modules.push(pbr);\n    return {...shaders, vs, fs};\n  }\n\n  initializeState() {\n    const {featureIds} = this.props;\n    super.initializeState();\n\n    const attributeManager = this.getAttributeManager();\n    if (featureIds) {\n      // attributeManager is always defined in a primitive layer\n      attributeManager!.add({\n        featureIdsPickingColors: {\n          type: GL.UNSIGNED_BYTE,\n          size: 3,\n          noAlloc: true,\n          // eslint-disable-next-line @typescript-eslint/unbound-method\n          update: this.calculateFeatureIdsPickingColors\n        }\n      });\n    }\n  }\n\n  updateState(params: UpdateParameters<this>) {\n    super.updateState(params);\n\n    const {props, oldProps} = params;\n    if (props.pbrMaterial !== oldProps.pbrMaterial) {\n      this.updatePbrMaterialUniforms(props.pbrMaterial);\n    }\n  }\n\n  draw(opts) {\n    const {featureIds} = this.props;\n    if (!this.state.model) {\n      return;\n    }\n    this.state.model.setUniforms({\n      // Needed for PBR (TODO: find better way to get it)\n      // eslint-disable-next-line camelcase\n      u_Camera: this.state.model.getUniforms().project_uCameraPosition,\n      pickFeatureIds: Boolean(featureIds)\n    });\n\n    super.draw(opts);\n  }\n\n  protected getModel(mesh: Mesh): Model {\n    const {id, pbrMaterial} = this.props;\n    const materialParser = this.parseMaterial(pbrMaterial, mesh);\n    // Keep material parser to explicitly remove textures\n    this.setState({materialParser});\n    const shaders = this.getShaders();\n    validateGeometryAttributes(mesh.attributes);\n    const model = new Model(this.context.gl, {\n      ...this.getShaders(),\n      id,\n      geometry: mesh,\n      defines: {\n        ...shaders.defines,\n        ...materialParser?.defines,\n        HAS_UV_REGIONS: mesh.attributes.uvRegions\n      },\n      parameters: materialParser?.parameters,\n      isInstanced: true\n    });\n\n    return model;\n  }\n\n  updatePbrMaterialUniforms(pbrMaterial) {\n    const {model} = this.state;\n    if (model) {\n      const {mesh} = this.props;\n      const materialParser = this.parseMaterial(pbrMaterial, mesh);\n      // Keep material parser to explicitly remove textures\n      this.setState({materialParser});\n      model.setUniforms(materialParser.uniforms);\n    }\n  }\n\n  parseMaterial(pbrMaterial, mesh) {\n    const unlit = Boolean(\n      pbrMaterial.pbrMetallicRoughness && pbrMaterial.pbrMetallicRoughness.baseColorTexture\n    );\n\n    this.state.materialParser?.delete();\n\n    return new GLTFMaterialParser(this.context.gl, {\n      attributes: {NORMAL: mesh.attributes.normals, TEXCOORD_0: mesh.attributes.texCoords},\n      material: {unlit, ...pbrMaterial},\n      pbrDebug: false,\n      imageBasedLightingEnvironment: null,\n      lights: true,\n      useTangents: false\n    });\n  }\n\n  calculateFeatureIdsPickingColors(attribute) {\n    // This updater is only called if featureIds is not null\n    const featureIds = this.props.featureIds!;\n    const value = new Uint8ClampedArray(featureIds.length * attribute.size);\n\n    const pickingColor = [];\n    for (let index = 0; index < featureIds.length; index++) {\n      this.encodePickingColor(featureIds[index], pickingColor);\n\n      value[index * 3] = pickingColor[0];\n      value[index * 3 + 1] = pickingColor[1];\n      value[index * 3 + 2] = pickingColor[2];\n    }\n\n    attribute.value = value;\n  }\n\n  finalizeState(context: LayerContext) {\n    super.finalizeState(context);\n    this.state.materialParser?.delete();\n    this.setState({materialParser: null});\n  }\n}\n","export default `#version 300 es\n#define SHADER_NAME simple-mesh-layer-vs\n\n// Scale the model\nuniform float sizeScale;\nuniform bool composeModelMatrix;\nuniform bool pickFeatureIds;\n\n// Primitive attributes\nin vec3 positions;\nin vec3 normals;\nin vec3 colors;\nin vec2 texCoords;\nin vec4 uvRegions;\nin vec3 featureIdsPickingColors;\n\n// Instance attributes\nin vec4 instanceColors;\nin vec3 instancePickingColors;\nin mat3 instanceModelMatrix;\n\n// Outputs to fragment shader\nout vec2 vTexCoord;\nout vec3 cameraPosition;\nout vec3 normals_commonspace;\nout vec4 position_commonspace;\nout vec4 vColor;\n\nvec2 applyUVRegion(vec2 uv) {\n  #ifdef HAS_UV_REGIONS\n    // https://github.com/Esri/i3s-spec/blob/master/docs/1.7/geometryUVRegion.cmn.md\n    return fract(uv) * (uvRegions.zw - uvRegions.xy) + uvRegions.xy;\n  #else\n    return uv;\n  #endif\n}\n\nvoid main(void) {\n  vec2 uv = applyUVRegion(texCoords);\n  geometry.uv = uv;\n\n  if (pickFeatureIds) {\n    geometry.pickingColor = featureIdsPickingColors;\n  } else {\n    geometry.pickingColor = instancePickingColors;\n  }\n\n  vTexCoord = uv;\n  cameraPosition = project_uCameraPosition;\n  vColor = vec4(colors * instanceColors.rgb, instanceColors.a);\n\n  vec3 pos = (instanceModelMatrix * positions) * sizeScale;\n  vec3 projectedPosition = project_position(positions);\n  position_commonspace = vec4(projectedPosition, 1.0);\n  gl_Position = project_common_position_to_clipspace(position_commonspace);\n\n  geometry.position = position_commonspace;\n  normals_commonspace = project_normal(instanceModelMatrix * normals);\n  geometry.normal = normals_commonspace;\n\n  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);\n\n  #ifdef MODULE_PBR\n    // set PBR data\n    pbr_vPosition = geometry.position.xyz;\n    #ifdef HAS_NORMALS\n      pbr_vNormal = geometry.normal;\n    #endif\n\n    #ifdef HAS_UV\n      pbr_vUV = uv;\n    #else\n      pbr_vUV = vec2(0., 0.);\n    #endif\n    geometry.uv = pbr_vUV;\n  #endif\n\n  DECKGL_FILTER_COLOR(vColor, geometry);\n}\n`;\n","export default `#version 300 es\n#define SHADER_NAME simple-mesh-layer-fs\n\nprecision highp float;\n\nuniform bool hasTexture;\nuniform sampler2D sampler;\nuniform bool flatShading;\nuniform float opacity;\n\nin vec2 vTexCoord;\nin vec3 cameraPosition;\nin vec3 normals_commonspace;\nin vec4 position_commonspace;\nin vec4 vColor;\n\nout vec4 fragColor;\n\nvoid main(void) {\n  \n#ifdef MODULE_PBR\n\n  fragColor = vColor * pbr_filterColor(vec4(0));\n  geometry.uv = pbr_vUV;\n  fragColor.a *= opacity;\n\n#else\n\n  geometry.uv = vTexCoord;\n\n  vec3 normal;\n  if (flatShading) {\n\n// NOTE(Tarek): This is necessary because\n// headless.gl reports the extension as\n// available but does not support it in\n// the shader.\n#ifdef DERIVATIVES_AVAILABLE\n    normal = normalize(cross(dFdx(position_commonspace.xyz), dFdy(position_commonspace.xyz)));\n#else\n    normal = vec3(0.0, 0.0, 1.0);\n#endif\n  } else {\n    normal = normals_commonspace;\n  }\n\n  vec4 color = hasTexture ? texture(sampler, vTexCoord) : vColor;\n  vec3 lightColor = lighting_getLightColor(color.rgb, cameraPosition, position_commonspace.xyz, normal);\n  fragColor = vec4(lightColor, color.a * opacity);\n\n#endif\n\n  DECKGL_FILTER_COLOR(fragColor, geometry);\n}\n`;\n","export default function _defineProperty(obj, key, value) {\n  if (key in obj) {\n    Object.defineProperty(obj, key, {\n      value: value,\n      enumerable: true,\n      configurable: true,\n      writable: true\n    });\n  } else {\n    obj[key] = value;\n  }\n\n  return obj;\n}","export const WGS84_RADIUS_X = 6378137.0;\nexport const WGS84_RADIUS_Y = 6378137.0;\nexport const WGS84_RADIUS_Z = 6356752.3142451793;\nexport const WGS84_CONSTANTS = {\n  radii: [WGS84_RADIUS_X, WGS84_RADIUS_Y, WGS84_RADIUS_Z],\n  radiiSquared: [WGS84_RADIUS_X * WGS84_RADIUS_X, WGS84_RADIUS_Y * WGS84_RADIUS_Y, WGS84_RADIUS_Z * WGS84_RADIUS_Z],\n  oneOverRadii: [1.0 / WGS84_RADIUS_X, 1.0 / WGS84_RADIUS_Y, 1.0 / WGS84_RADIUS_Z],\n  oneOverRadiiSquared: [1.0 / (WGS84_RADIUS_X * WGS84_RADIUS_X), 1.0 / (WGS84_RADIUS_Y * WGS84_RADIUS_Y), 1.0 / (WGS84_RADIUS_Z * WGS84_RADIUS_Z)],\n  maximumRadius: Math.max(WGS84_RADIUS_X, WGS84_RADIUS_Y, WGS84_RADIUS_Z),\n  centerToleranceSquared: 1e-1\n};\n//# sourceMappingURL=constants.js.map","import { Vector3, toRadians, toDegrees, config } from '@math.gl/core';\nimport { WGS84_CONSTANTS } from './constants';\n\nfunction identity(x) {\n  return x;\n}\n\nconst scratchVector = new Vector3();\nexport function fromCartographic(cartographic, result = [], map = identity) {\n  if ('longitude' in cartographic) {\n    result[0] = map(cartographic.longitude);\n    result[1] = map(cartographic.latitude);\n    result[2] = cartographic.height;\n  } else if ('x' in cartographic) {\n    result[0] = map(cartographic.x);\n    result[1] = map(cartographic.y);\n    result[2] = cartographic.z;\n  } else {\n    result[0] = map(cartographic[0]);\n    result[1] = map(cartographic[1]);\n    result[2] = cartographic[2];\n  }\n\n  return result;\n}\nexport function fromCartographicToRadians(cartographic, vector = []) {\n  return fromCartographic(cartographic, vector, config._cartographicRadians ? identity : toRadians);\n}\nexport function fromCartographicToDegrees(cartographic, vector = []) {\n  return fromCartographic(cartographic, vector, config._cartographicRadians ? toDegrees : identity);\n}\nexport function toCartographic(vector, cartographic, map = identity) {\n  if ('longitude' in cartographic) {\n    cartographic.longitude = map(vector[0]);\n    cartographic.latitude = map(vector[1]);\n    cartographic.height = vector[2];\n  } else if ('x' in cartographic) {\n    cartographic.x = map(vector[0]);\n    cartographic.y = map(vector[1]);\n    cartographic.z = vector[2];\n  } else {\n    cartographic[0] = map(vector[0]);\n    cartographic[1] = map(vector[1]);\n    cartographic[2] = vector[2];\n  }\n\n  return cartographic;\n}\nexport function toCartographicFromRadians(vector, cartographic) {\n  return toCartographic(vector, cartographic, config._cartographicRadians ? identity : toDegrees);\n}\nexport function toCartographicFromDegrees(vector, cartographic) {\n  return toCartographic(vector, cartographic, config._cartographicRadians ? toRadians : identity);\n}\nexport function isWGS84(vector) {\n  if (!vector) {\n    return false;\n  }\n\n  scratchVector.from(vector);\n  const {\n    oneOverRadiiSquared,\n    centerToleranceSquared\n  } = WGS84_CONSTANTS;\n  const x2 = vector[0] * vector[0] * oneOverRadiiSquared[0];\n  const y2 = vector[1] * vector[1] * oneOverRadiiSquared[1];\n  const z2 = vector[2] * vector[2] * oneOverRadiiSquared[2];\n  return Math.abs(x2 + y2 + z2 - 1) < centerToleranceSquared;\n}\n//# sourceMappingURL=type-utils.js.map","import { Vector3, _MathUtils } from '@math.gl/core';\nconst scratchVector = new Vector3();\nconst scaleToGeodeticSurfaceIntersection = new Vector3();\nconst scaleToGeodeticSurfaceGradient = new Vector3();\nexport default function scaleToGeodeticSurface(cartesian, ellipsoid, result = []) {\n  const {\n    oneOverRadii,\n    oneOverRadiiSquared,\n    centerToleranceSquared\n  } = ellipsoid;\n  scratchVector.from(cartesian);\n  const positionX = scratchVector.x;\n  const positionY = scratchVector.y;\n  const positionZ = scratchVector.z;\n  const oneOverRadiiX = oneOverRadii.x;\n  const oneOverRadiiY = oneOverRadii.y;\n  const oneOverRadiiZ = oneOverRadii.z;\n  const x2 = positionX * positionX * oneOverRadiiX * oneOverRadiiX;\n  const y2 = positionY * positionY * oneOverRadiiY * oneOverRadiiY;\n  const z2 = positionZ * positionZ * oneOverRadiiZ * oneOverRadiiZ;\n  const squaredNorm = x2 + y2 + z2;\n  const ratio = Math.sqrt(1.0 / squaredNorm);\n\n  if (!Number.isFinite(ratio)) {\n    return undefined;\n  }\n\n  const intersection = scaleToGeodeticSurfaceIntersection;\n  intersection.copy(cartesian).scale(ratio);\n\n  if (squaredNorm < centerToleranceSquared) {\n    return intersection.to(result);\n  }\n\n  const oneOverRadiiSquaredX = oneOverRadiiSquared.x;\n  const oneOverRadiiSquaredY = oneOverRadiiSquared.y;\n  const oneOverRadiiSquaredZ = oneOverRadiiSquared.z;\n  const gradient = scaleToGeodeticSurfaceGradient;\n  gradient.set(intersection.x * oneOverRadiiSquaredX * 2.0, intersection.y * oneOverRadiiSquaredY * 2.0, intersection.z * oneOverRadiiSquaredZ * 2.0);\n  let lambda = (1.0 - ratio) * scratchVector.len() / (0.5 * gradient.len());\n  let correction = 0.0;\n  let xMultiplier;\n  let yMultiplier;\n  let zMultiplier;\n  let func;\n\n  do {\n    lambda -= correction;\n    xMultiplier = 1.0 / (1.0 + lambda * oneOverRadiiSquaredX);\n    yMultiplier = 1.0 / (1.0 + lambda * oneOverRadiiSquaredY);\n    zMultiplier = 1.0 / (1.0 + lambda * oneOverRadiiSquaredZ);\n    const xMultiplier2 = xMultiplier * xMultiplier;\n    const yMultiplier2 = yMultiplier * yMultiplier;\n    const zMultiplier2 = zMultiplier * zMultiplier;\n    const xMultiplier3 = xMultiplier2 * xMultiplier;\n    const yMultiplier3 = yMultiplier2 * yMultiplier;\n    const zMultiplier3 = zMultiplier2 * zMultiplier;\n    func = x2 * xMultiplier2 + y2 * yMultiplier2 + z2 * zMultiplier2 - 1.0;\n    const denominator = x2 * xMultiplier3 * oneOverRadiiSquaredX + y2 * yMultiplier3 * oneOverRadiiSquaredY + z2 * zMultiplier3 * oneOverRadiiSquaredZ;\n    const derivative = -2.0 * denominator;\n    correction = func / derivative;\n  } while (Math.abs(func) > _MathUtils.EPSILON12);\n\n  return scratchVector.scale([xMultiplier, yMultiplier, zMultiplier]).to(result);\n}\n//# sourceMappingURL=scale-to-geodetic-surface.js.map","import { Vector3, assert, equals as equalsEpsilon } from '@math.gl/core';\nconst EPSILON14 = 1e-14;\nconst scratchOrigin = new Vector3();\nconst VECTOR_PRODUCT_LOCAL_FRAME = {\n  up: {\n    south: 'east',\n    north: 'west',\n    west: 'south',\n    east: 'north'\n  },\n  down: {\n    south: 'west',\n    north: 'east',\n    west: 'north',\n    east: 'south'\n  },\n  south: {\n    up: 'west',\n    down: 'east',\n    west: 'down',\n    east: 'up'\n  },\n  north: {\n    up: 'east',\n    down: 'west',\n    west: 'up',\n    east: 'down'\n  },\n  west: {\n    up: 'north',\n    down: 'south',\n    north: 'down',\n    south: 'up'\n  },\n  east: {\n    up: 'south',\n    down: 'north',\n    north: 'up',\n    south: 'down'\n  }\n};\nconst degeneratePositionLocalFrame = {\n  north: [-1, 0, 0],\n  east: [0, 1, 0],\n  up: [0, 0, 1],\n  south: [1, 0, 0],\n  west: [0, -1, 0],\n  down: [0, 0, -1]\n};\nconst scratchAxisVectors = {\n  east: new Vector3(),\n  north: new Vector3(),\n  up: new Vector3(),\n  west: new Vector3(),\n  south: new Vector3(),\n  down: new Vector3()\n};\nconst scratchVector1 = new Vector3();\nconst scratchVector2 = new Vector3();\nconst scratchVector3 = new Vector3();\nexport default function localFrameToFixedFrame(ellipsoid, firstAxis, secondAxis, thirdAxis, cartesianOrigin, result) {\n  const thirdAxisInferred = VECTOR_PRODUCT_LOCAL_FRAME[firstAxis] && VECTOR_PRODUCT_LOCAL_FRAME[firstAxis][secondAxis];\n  assert(thirdAxisInferred && (!thirdAxis || thirdAxis === thirdAxisInferred));\n  let firstAxisVector;\n  let secondAxisVector;\n  let thirdAxisVector;\n  const origin = scratchOrigin.copy(cartesianOrigin);\n  const atPole = equalsEpsilon(origin.x, 0.0, EPSILON14) && equalsEpsilon(origin.y, 0.0, EPSILON14);\n\n  if (atPole) {\n    const sign = Math.sign(origin.z);\n    firstAxisVector = scratchVector1.fromArray(degeneratePositionLocalFrame[firstAxis]);\n\n    if (firstAxis !== 'east' && firstAxis !== 'west') {\n      firstAxisVector.scale(sign);\n    }\n\n    secondAxisVector = scratchVector2.fromArray(degeneratePositionLocalFrame[secondAxis]);\n\n    if (secondAxis !== 'east' && secondAxis !== 'west') {\n      secondAxisVector.scale(sign);\n    }\n\n    thirdAxisVector = scratchVector3.fromArray(degeneratePositionLocalFrame[thirdAxis]);\n\n    if (thirdAxis !== 'east' && thirdAxis !== 'west') {\n      thirdAxisVector.scale(sign);\n    }\n  } else {\n    const {\n      up,\n      east,\n      north\n    } = scratchAxisVectors;\n    east.set(-origin.y, origin.x, 0.0).normalize();\n    ellipsoid.geodeticSurfaceNormal(origin, up);\n    north.copy(up).cross(east);\n    const {\n      down,\n      west,\n      south\n    } = scratchAxisVectors;\n    down.copy(up).scale(-1);\n    west.copy(east).scale(-1);\n    south.copy(north).scale(-1);\n    firstAxisVector = scratchAxisVectors[firstAxis];\n    secondAxisVector = scratchAxisVectors[secondAxis];\n    thirdAxisVector = scratchAxisVectors[thirdAxis];\n  }\n\n  result[0] = firstAxisVector.x;\n  result[1] = firstAxisVector.y;\n  result[2] = firstAxisVector.z;\n  result[3] = 0.0;\n  result[4] = secondAxisVector.x;\n  result[5] = secondAxisVector.y;\n  result[6] = secondAxisVector.z;\n  result[7] = 0.0;\n  result[8] = thirdAxisVector.x;\n  result[9] = thirdAxisVector.y;\n  result[10] = thirdAxisVector.z;\n  result[11] = 0.0;\n  result[12] = origin.x;\n  result[13] = origin.y;\n  result[14] = origin.z;\n  result[15] = 1.0;\n  return result;\n}\n//# sourceMappingURL=ellipsoid-transform.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { Vector3, Matrix4, assert, equals, _MathUtils } from '@math.gl/core';\nimport * as vec3 from 'gl-matrix/vec3';\nimport { WGS84_RADIUS_X, WGS84_RADIUS_Y, WGS84_RADIUS_Z } from '../constants';\nimport { fromCartographicToRadians, toCartographicFromRadians } from '../type-utils';\nimport scaleToGeodeticSurface from './helpers/scale-to-geodetic-surface';\nimport localFrameToFixedFrame from './helpers/ellipsoid-transform';\nconst scratchVector = new Vector3();\nconst scratchNormal = new Vector3();\nconst scratchK = new Vector3();\nconst scratchPosition = new Vector3();\nconst scratchHeight = new Vector3();\nconst scratchCartesian = new Vector3();\nlet wgs84;\nexport default class Ellipsoid {\n  constructor(x = 0.0, y = 0.0, z = 0.0) {\n    _defineProperty(this, \"radii\", void 0);\n\n    _defineProperty(this, \"radiiSquared\", void 0);\n\n    _defineProperty(this, \"radiiToTheFourth\", void 0);\n\n    _defineProperty(this, \"oneOverRadii\", void 0);\n\n    _defineProperty(this, \"oneOverRadiiSquared\", void 0);\n\n    _defineProperty(this, \"minimumRadius\", void 0);\n\n    _defineProperty(this, \"maximumRadius\", void 0);\n\n    _defineProperty(this, \"centerToleranceSquared\", _MathUtils.EPSILON1);\n\n    _defineProperty(this, \"squaredXOverSquaredZ\", void 0);\n\n    assert(x >= 0.0);\n    assert(y >= 0.0);\n    assert(z >= 0.0);\n    this.radii = new Vector3(x, y, z);\n    this.radiiSquared = new Vector3(x * x, y * y, z * z);\n    this.radiiToTheFourth = new Vector3(x * x * x * x, y * y * y * y, z * z * z * z);\n    this.oneOverRadii = new Vector3(x === 0.0 ? 0.0 : 1.0 / x, y === 0.0 ? 0.0 : 1.0 / y, z === 0.0 ? 0.0 : 1.0 / z);\n    this.oneOverRadiiSquared = new Vector3(x === 0.0 ? 0.0 : 1.0 / (x * x), y === 0.0 ? 0.0 : 1.0 / (y * y), z === 0.0 ? 0.0 : 1.0 / (z * z));\n    this.minimumRadius = Math.min(x, y, z);\n    this.maximumRadius = Math.max(x, y, z);\n\n    if (this.radiiSquared.z !== 0) {\n      this.squaredXOverSquaredZ = this.radiiSquared.x / this.radiiSquared.z;\n    }\n\n    Object.freeze(this);\n  }\n\n  equals(right) {\n    return this === right || Boolean(right && this.radii.equals(right.radii));\n  }\n\n  toString() {\n    return this.radii.toString();\n  }\n\n  cartographicToCartesian(cartographic, result = [0, 0, 0]) {\n    const normal = scratchNormal;\n    const k = scratchK;\n    const [,, height] = cartographic;\n    this.geodeticSurfaceNormalCartographic(cartographic, normal);\n    k.copy(this.radiiSquared).scale(normal);\n    const gamma = Math.sqrt(normal.dot(k));\n    k.scale(1 / gamma);\n    normal.scale(height);\n    k.add(normal);\n    return k.to(result);\n  }\n\n  cartesianToCartographic(cartesian, result = [0, 0, 0]) {\n    scratchCartesian.from(cartesian);\n    const point = this.scaleToGeodeticSurface(scratchCartesian, scratchPosition);\n\n    if (!point) {\n      return undefined;\n    }\n\n    const normal = this.geodeticSurfaceNormal(point, scratchNormal);\n    const h = scratchHeight;\n    h.copy(scratchCartesian).subtract(point);\n    const longitude = Math.atan2(normal.y, normal.x);\n    const latitude = Math.asin(normal.z);\n    const height = Math.sign(vec3.dot(h, scratchCartesian)) * vec3.length(h);\n    return toCartographicFromRadians([longitude, latitude, height], result);\n  }\n\n  eastNorthUpToFixedFrame(origin, result = new Matrix4()) {\n    return localFrameToFixedFrame(this, 'east', 'north', 'up', origin, result);\n  }\n\n  localFrameToFixedFrame(firstAxis, secondAxis, thirdAxis, origin, result = new Matrix4()) {\n    return localFrameToFixedFrame(this, firstAxis, secondAxis, thirdAxis, origin, result);\n  }\n\n  geocentricSurfaceNormal(cartesian, result = [0, 0, 0]) {\n    return scratchVector.from(cartesian).normalize().to(result);\n  }\n\n  geodeticSurfaceNormalCartographic(cartographic, result = [0, 0, 0]) {\n    const cartographicVectorRadians = fromCartographicToRadians(cartographic);\n    const longitude = cartographicVectorRadians[0];\n    const latitude = cartographicVectorRadians[1];\n    const cosLatitude = Math.cos(latitude);\n    scratchVector.set(cosLatitude * Math.cos(longitude), cosLatitude * Math.sin(longitude), Math.sin(latitude)).normalize();\n    return scratchVector.to(result);\n  }\n\n  geodeticSurfaceNormal(cartesian, result = [0, 0, 0]) {\n    return scratchVector.from(cartesian).scale(this.oneOverRadiiSquared).normalize().to(result);\n  }\n\n  scaleToGeodeticSurface(cartesian, result) {\n    return scaleToGeodeticSurface(cartesian, this, result);\n  }\n\n  scaleToGeocentricSurface(cartesian, result = [0, 0, 0]) {\n    scratchPosition.from(cartesian);\n    const positionX = scratchPosition.x;\n    const positionY = scratchPosition.y;\n    const positionZ = scratchPosition.z;\n    const oneOverRadiiSquared = this.oneOverRadiiSquared;\n    const beta = 1.0 / Math.sqrt(positionX * positionX * oneOverRadiiSquared.x + positionY * positionY * oneOverRadiiSquared.y + positionZ * positionZ * oneOverRadiiSquared.z);\n    return scratchPosition.multiplyScalar(beta).to(result);\n  }\n\n  transformPositionToScaledSpace(position, result = [0, 0, 0]) {\n    return scratchPosition.from(position).scale(this.oneOverRadii).to(result);\n  }\n\n  transformPositionFromScaledSpace(position, result = [0, 0, 0]) {\n    return scratchPosition.from(position).scale(this.radii).to(result);\n  }\n\n  getSurfaceNormalIntersectionWithZAxis(position, buffer = 0, result = [0, 0, 0]) {\n    assert(equals(this.radii.x, this.radii.y, _MathUtils.EPSILON15));\n    assert(this.radii.z > 0);\n    scratchPosition.from(position);\n    const z = scratchPosition.z * (1 - this.squaredXOverSquaredZ);\n\n    if (Math.abs(z) >= this.radii.z - buffer) {\n      return undefined;\n    }\n\n    return scratchPosition.set(0.0, 0.0, z).to(result);\n  }\n\n}\n\n_defineProperty(Ellipsoid, \"WGS84\", new Ellipsoid(WGS84_RADIUS_X, WGS84_RADIUS_Y, WGS84_RADIUS_Z));\n//# sourceMappingURL=ellipsoid.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nexport default class DoublyLinkedListNode {\n  constructor(item, previous, next) {\n    _defineProperty(this, \"item\", void 0);\n\n    _defineProperty(this, \"previous\", void 0);\n\n    _defineProperty(this, \"next\", void 0);\n\n    this.item = item;\n    this.previous = previous;\n    this.next = next;\n  }\n\n}\n//# sourceMappingURL=doubly-linked-list-node.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport DoublyLinkedListNode from '../utils/doubly-linked-list-node';\nexport default class DoublyLinkedList {\n  constructor() {\n    _defineProperty(this, \"head\", null);\n\n    _defineProperty(this, \"tail\", null);\n\n    _defineProperty(this, \"_length\", 0);\n  }\n\n  get length() {\n    return this._length;\n  }\n\n  add(item) {\n    const node = new DoublyLinkedListNode(item, this.tail, null);\n\n    if (this.tail) {\n      this.tail.next = node;\n      this.tail = node;\n    } else {\n      this.head = node;\n      this.tail = node;\n    }\n\n    ++this._length;\n    return node;\n  }\n\n  remove(node) {\n    if (!node) {\n      return;\n    }\n\n    if (node.previous && node.next) {\n      node.previous.next = node.next;\n      node.next.previous = node.previous;\n    } else if (node.previous) {\n      node.previous.next = null;\n      this.tail = node.previous;\n    } else if (node.next) {\n      node.next.previous = null;\n      this.head = node.next;\n    } else {\n      this.head = null;\n      this.tail = null;\n    }\n\n    node.next = null;\n    node.previous = null;\n    --this._length;\n  }\n\n  splice(node, nextNode) {\n    if (node === nextNode) {\n      return;\n    }\n\n    this.remove(nextNode);\n\n    this._insert(node, nextNode);\n  }\n\n  _insert(node, nextNode) {\n    const oldNodeNext = node.next;\n    node.next = nextNode;\n\n    if (this.tail === node) {\n      this.tail = nextNode;\n    } else {\n      oldNodeNext.previous = nextNode;\n    }\n\n    nextNode.next = oldNodeNext;\n    nextNode.previous = node;\n    ++this._length;\n  }\n\n}\n//# sourceMappingURL=doubly-linked-list.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport DoublyLinkedList from '../utils/doubly-linked-list';\n\nfunction defined(x) {\n  return x !== undefined && x !== null;\n}\n\nexport default class TilesetCache {\n  constructor() {\n    _defineProperty(this, \"_list\", void 0);\n\n    _defineProperty(this, \"_sentinel\", void 0);\n\n    _defineProperty(this, \"_trimTiles\", void 0);\n\n    this._list = new DoublyLinkedList();\n    this._sentinel = this._list.add('sentinel');\n    this._trimTiles = false;\n  }\n\n  reset() {\n    this._list.splice(this._list.tail, this._sentinel);\n  }\n\n  touch(tile) {\n    const node = tile._cacheNode;\n\n    if (defined(node)) {\n      this._list.splice(this._sentinel, node);\n    }\n  }\n\n  add(tileset, tile, addCallback) {\n    if (!defined(tile._cacheNode)) {\n      tile._cacheNode = this._list.add(tile);\n\n      if (addCallback) {\n        addCallback(tileset, tile);\n      }\n    }\n  }\n\n  unloadTile(tileset, tile, unloadCallback) {\n    const node = tile._cacheNode;\n\n    if (!defined(node)) {\n      return;\n    }\n\n    this._list.remove(node);\n\n    tile._cacheNode = undefined;\n\n    if (unloadCallback) {\n      unloadCallback(tileset, tile);\n    }\n  }\n\n  unloadTiles(tileset, unloadCallback) {\n    const trimTiles = this._trimTiles;\n    this._trimTiles = false;\n    const list = this._list;\n    const maximumMemoryUsageInBytes = tileset.maximumMemoryUsage * 1024 * 1024;\n    const sentinel = this._sentinel;\n    let node = list.head;\n\n    while (node !== sentinel && (tileset.gpuMemoryUsageInBytes > maximumMemoryUsageInBytes || trimTiles)) {\n      const tile = node.item;\n      node = node.next;\n      this.unloadTile(tileset, tile, unloadCallback);\n    }\n  }\n\n  trim() {\n    this._trimTiles = true;\n  }\n\n}\n//# sourceMappingURL=tileset-cache.js.map","import { Vector3 } from '@math.gl/core';\nimport { CullingVolume, Plane } from '@math.gl/culling';\nimport { Ellipsoid } from '@math.gl/geospatial';\nconst scratchVector = new Vector3();\nconst scratchPosition = new Vector3();\nconst cullingVolume = new CullingVolume([new Plane(), new Plane(), new Plane(), new Plane(), new Plane(), new Plane()]);\nexport function getFrameState(viewport, frameNumber) {\n  const {\n    cameraDirection,\n    cameraUp,\n    height\n  } = viewport;\n  const {\n    metersPerUnit\n  } = viewport.distanceScales;\n  const viewportCenterCartesian = worldToCartesian(viewport, viewport.center);\n  const enuToFixedTransform = Ellipsoid.WGS84.eastNorthUpToFixedFrame(viewportCenterCartesian);\n  const cameraPositionCartographic = viewport.unprojectPosition(viewport.cameraPosition);\n  const cameraPositionCartesian = Ellipsoid.WGS84.cartographicToCartesian(cameraPositionCartographic, new Vector3());\n  const cameraDirectionCartesian = new Vector3(enuToFixedTransform.transformAsVector(new Vector3(cameraDirection).scale(metersPerUnit))).normalize();\n  const cameraUpCartesian = new Vector3(enuToFixedTransform.transformAsVector(new Vector3(cameraUp).scale(metersPerUnit))).normalize();\n  commonSpacePlanesToWGS84(viewport);\n  const ViewportClass = viewport.constructor;\n  const {\n    longitude,\n    latitude,\n    width,\n    bearing,\n    zoom\n  } = viewport;\n  const topDownViewport = new ViewportClass({\n    longitude,\n    latitude,\n    height,\n    width,\n    bearing,\n    zoom,\n    pitch: 0\n  });\n  return {\n    camera: {\n      position: cameraPositionCartesian,\n      direction: cameraDirectionCartesian,\n      up: cameraUpCartesian\n    },\n    viewport,\n    topDownViewport,\n    height,\n    cullingVolume,\n    frameNumber,\n    sseDenominator: 1.15\n  };\n}\nexport function limitSelectedTiles(tiles, frameState, maximumTilesSelected) {\n  if (maximumTilesSelected === 0 || tiles.length <= maximumTilesSelected) {\n    return [tiles, []];\n  }\n\n  const tuples = [];\n  const {\n    longitude: viewportLongitude,\n    latitude: viewportLatitude\n  } = frameState.viewport;\n\n  for (const [index, tile] of tiles.entries()) {\n    const [longitude, latitude] = tile.header.mbs;\n    const deltaLon = Math.abs(viewportLongitude - longitude);\n    const deltaLat = Math.abs(viewportLatitude - latitude);\n    const distance = Math.sqrt(deltaLat * deltaLat + deltaLon * deltaLon);\n    tuples.push([index, distance]);\n  }\n\n  const tuplesSorted = tuples.sort((a, b) => a[1] - b[1]);\n  const selectedTiles = [];\n\n  for (let i = 0; i < maximumTilesSelected; i++) {\n    selectedTiles.push(tiles[tuplesSorted[i][0]]);\n  }\n\n  const unselectedTiles = [];\n\n  for (let i = maximumTilesSelected; i < tuplesSorted.length; i++) {\n    unselectedTiles.push(tiles[tuplesSorted[i][0]]);\n  }\n\n  return [selectedTiles, unselectedTiles];\n}\n\nfunction commonSpacePlanesToWGS84(viewport) {\n  const frustumPlanes = viewport.getFrustumPlanes();\n  const nearCenterCommon = closestPointOnPlane(frustumPlanes.near, viewport.cameraPosition);\n  const nearCenterCartesian = worldToCartesian(viewport, nearCenterCommon);\n  const cameraCartesian = worldToCartesian(viewport, viewport.cameraPosition, scratchPosition);\n  let i = 0;\n  cullingVolume.planes[i++].fromPointNormal(nearCenterCartesian, scratchVector.copy(nearCenterCartesian).subtract(cameraCartesian));\n\n  for (const dir in frustumPlanes) {\n    if (dir === 'near') {\n      continue;\n    }\n\n    const plane = frustumPlanes[dir];\n    const posCommon = closestPointOnPlane(plane, nearCenterCommon, scratchPosition);\n    const cartesianPos = worldToCartesian(viewport, posCommon, scratchPosition);\n    cullingVolume.planes[i++].fromPointNormal(cartesianPos, scratchVector.copy(nearCenterCartesian).subtract(cartesianPos));\n  }\n}\n\nfunction closestPointOnPlane(plane, refPoint, out = new Vector3()) {\n  const distanceToRef = plane.normal.dot(refPoint);\n  out.copy(plane.normal).scale(plane.distance - distanceToRef).add(refPoint);\n  return out;\n}\n\nfunction worldToCartesian(viewport, point, out = new Vector3()) {\n  const cartographicPos = viewport.unprojectPosition(point);\n  return Ellipsoid.WGS84.cartographicToCartesian(cartographicPos, out);\n}\n//# sourceMappingURL=frame-state.js.map","import { Vector3 } from '@math.gl/core';\nimport { BoundingSphere, OrientedBoundingBox } from '@math.gl/culling';\nimport { Ellipsoid } from '@math.gl/geospatial';\nconst WGS84_RADIUS_X = 6378137.0;\nconst WGS84_RADIUS_Y = 6378137.0;\nconst WGS84_RADIUS_Z = 6356752.3142451793;\nconst scratchVector = new Vector3();\nexport function getZoomFromBoundingVolume(boundingVolume, cartorgraphicCenter) {\n  if (boundingVolume instanceof OrientedBoundingBox) {\n    const {\n      halfAxes\n    } = boundingVolume;\n    const obbSize = getObbSize(halfAxes);\n    return Math.log2(WGS84_RADIUS_Z / (obbSize + cartorgraphicCenter[2]));\n  } else if (boundingVolume instanceof BoundingSphere) {\n    const {\n      radius\n    } = boundingVolume;\n    return Math.log2(WGS84_RADIUS_Z / (radius + cartorgraphicCenter[2]));\n  } else if (boundingVolume.width && boundingVolume.height) {\n    const {\n      width,\n      height\n    } = boundingVolume;\n    const zoomX = Math.log2(WGS84_RADIUS_X / width);\n    const zoomY = Math.log2(WGS84_RADIUS_Y / height);\n    return (zoomX + zoomY) / 2;\n  }\n\n  return 1;\n}\nexport function getZoomFromFullExtent(fullExtent, cartorgraphicCenter, cartesianCenter) {\n  const extentVertex = Ellipsoid.WGS84.cartographicToCartesian([fullExtent.xmax, fullExtent.ymax, fullExtent.zmax], new Vector3());\n  const extentSize = Math.sqrt(Math.pow(extentVertex[0] - cartesianCenter[0], 2) + Math.pow(extentVertex[1] - cartesianCenter[1], 2) + Math.pow(extentVertex[2] - cartesianCenter[2], 2));\n  return Math.log2(WGS84_RADIUS_Z / (extentSize + cartorgraphicCenter[2]));\n}\nexport function getZoomFromExtent(extent, cartorgraphicCenter, cartesianCenter) {\n  const [xmin, ymin, xmax, ymax] = extent;\n  return getZoomFromFullExtent({\n    xmin,\n    xmax,\n    ymin,\n    ymax,\n    zmin: 0,\n    zmax: 0\n  }, cartorgraphicCenter, cartesianCenter);\n}\n\nfunction getObbSize(halfAxes) {\n  halfAxes.getColumn(0, scratchVector);\n  const axeY = halfAxes.getColumn(1);\n  const axeZ = halfAxes.getColumn(2);\n  const farthestVertex = scratchVector.add(axeY).add(axeZ);\n  const size = farthestVertex.len();\n  return size;\n}\n//# sourceMappingURL=zoom.js.map","export const TILE_CONTENT_STATE = {\n  UNLOADED: 0,\n  LOADING: 1,\n  PROCESSING: 2,\n  READY: 3,\n  EXPIRED: 4,\n  FAILED: 5\n};\nexport const TILE_REFINEMENT = {\n  ADD: 1,\n  REPLACE: 2\n};\nexport const TILE_TYPE = {\n  EMPTY: 'empty',\n  SCENEGRAPH: 'scenegraph',\n  POINTCLOUD: 'pointcloud',\n  MESH: 'mesh'\n};\nexport const TILESET_TYPE = {\n  I3S: 'I3S',\n  TILES3D: 'TILES3D'\n};\nexport const LOD_METRIC_TYPE = {\n  GEOMETRIC_ERROR: 'geometricError',\n  MAX_SCREEN_THRESHOLD: 'maxScreenThreshold'\n};\nexport const TILE3D_OPTIMIZATION_HINT = {\n  NOT_COMPUTED: -1,\n  USE_OPTIMIZATION: 1,\n  SKIP_OPTIMIZATION: 0\n};\n//# sourceMappingURL=constants.js.map","import { Quaternion, Vector3, Matrix3, Matrix4, degrees } from '@math.gl/core';\nimport { BoundingSphere, OrientedBoundingBox } from '@math.gl/culling';\nimport { Ellipsoid } from '@math.gl/geospatial';\nimport { assert } from '@loaders.gl/loader-utils';\n\nfunction defined(x) {\n  return x !== undefined && x !== null;\n}\n\nconst scratchScale = new Vector3();\nconst scratchNorthWest = new Vector3();\nconst scratchSouthEast = new Vector3();\nexport function createBoundingVolume(boundingVolumeHeader, transform, result) {\n  assert(boundingVolumeHeader, '3D Tile: boundingVolume must be defined');\n\n  if (boundingVolumeHeader.box) {\n    return createBox(boundingVolumeHeader.box, transform, result);\n  }\n\n  if (boundingVolumeHeader.region) {\n    const [west, south, east, north, minHeight, maxHeight] = boundingVolumeHeader.region;\n    const northWest = Ellipsoid.WGS84.cartographicToCartesian([degrees(west), degrees(north), minHeight], scratchNorthWest);\n    const southEast = Ellipsoid.WGS84.cartographicToCartesian([degrees(east), degrees(south), maxHeight], scratchSouthEast);\n    const centerInCartesian = new Vector3().addVectors(northWest, southEast).multiplyScalar(0.5);\n    const radius = new Vector3().subVectors(northWest, southEast).len() / 2.0;\n    return createSphere([centerInCartesian[0], centerInCartesian[1], centerInCartesian[2], radius], new Matrix4());\n  }\n\n  if (boundingVolumeHeader.sphere) {\n    return createSphere(boundingVolumeHeader.sphere, transform, result);\n  }\n\n  throw new Error('3D Tile: boundingVolume must contain a sphere, region, or box');\n}\n\nfunction createBox(box, transform, result) {\n  const center = new Vector3(box[0], box[1], box[2]);\n  transform.transform(center, center);\n  let origin = [];\n\n  if (box.length === 10) {\n    const halfSize = box.slice(3, 6);\n    const quaternion = new Quaternion();\n    quaternion.fromArray(box, 6);\n    const x = new Vector3([1, 0, 0]);\n    const y = new Vector3([0, 1, 0]);\n    const z = new Vector3([0, 0, 1]);\n    x.transformByQuaternion(quaternion);\n    x.scale(halfSize[0]);\n    y.transformByQuaternion(quaternion);\n    y.scale(halfSize[1]);\n    z.transformByQuaternion(quaternion);\n    z.scale(halfSize[2]);\n    origin = [...x.toArray(), ...y.toArray(), ...z.toArray()];\n  } else {\n    origin = [...box.slice(3, 6), ...box.slice(6, 9), ...box.slice(9, 12)];\n  }\n\n  const xAxis = transform.transformAsVector(origin.slice(0, 3));\n  const yAxis = transform.transformAsVector(origin.slice(3, 6));\n  const zAxis = transform.transformAsVector(origin.slice(6, 9));\n  const halfAxes = new Matrix3([xAxis[0], xAxis[1], xAxis[2], yAxis[0], yAxis[1], yAxis[2], zAxis[0], zAxis[1], zAxis[2]]);\n\n  if (defined(result)) {\n    result.center = center;\n    result.halfAxes = halfAxes;\n    return result;\n  }\n\n  return new OrientedBoundingBox(center, halfAxes);\n}\n\nfunction createSphere(sphere, transform, result) {\n  const center = new Vector3(sphere[0], sphere[1], sphere[2]);\n  transform.transform(center, center);\n  const scale = transform.getScale(scratchScale);\n  const uniformScale = Math.max(Math.max(scale[0], scale[1]), scale[2]);\n  const radius = sphere[3] * uniformScale;\n\n  if (defined(result)) {\n    result.center = center;\n    result.radius = radius;\n    return result;\n  }\n\n  return new BoundingSphere(center, radius);\n}\n//# sourceMappingURL=bounding-volume.js.map","import { Matrix4, Vector3, clamp } from '@math.gl/core';\nconst scratchPositionNormal = new Vector3();\nconst scratchCartographic = new Vector3();\nconst scratchMatrix = new Matrix4();\nconst scratchCenter = new Vector3();\nconst scratchPosition = new Vector3();\nconst scratchDirection = new Vector3();\nexport function calculateDynamicScreenSpaceError(root, {\n  camera,\n  mapProjection\n}, options = {}) {\n  const {\n    dynamicScreenSpaceErrorHeightFalloff = 0.25,\n    dynamicScreenSpaceErrorDensity = 0.00278\n  } = options;\n  let up;\n  let direction;\n  let height;\n  let minimumHeight;\n  let maximumHeight;\n  const tileBoundingVolume = root.contentBoundingVolume;\n\n  if (tileBoundingVolume instanceof TileBoundingRegion) {\n    up = Cartesian3.normalize(camera.positionWC, scratchPositionNormal);\n    direction = camera.directionWC;\n    height = camera.positionCartographic.height;\n    minimumHeight = tileBoundingVolume.minimumHeight;\n    maximumHeight = tileBoundingVolume.maximumHeight;\n  } else {\n    const transformLocal = Matrix4.inverseTransformation(root.computedTransform, scratchMatrix);\n    const ellipsoid = mapProjection.ellipsoid;\n    const boundingVolume = tileBoundingVolume.boundingVolume;\n    const centerLocal = Matrix4.multiplyByPoint(transformLocal, boundingVolume.center, scratchCenter);\n\n    if (Cartesian3.magnitude(centerLocal) > ellipsoid.minimumRadius) {\n      const centerCartographic = Cartographic.fromCartesian(centerLocal, ellipsoid, scratchCartographic);\n      up = Cartesian3.normalize(camera.positionWC, scratchPositionNormal);\n      direction = camera.directionWC;\n      height = camera.positionCartographic.height;\n      minimumHeight = 0.0;\n      maximumHeight = centerCartographic.height * 2.0;\n    } else {\n      const positionLocal = Matrix4.multiplyByPoint(transformLocal, camera.positionWC, scratchPosition);\n      up = Cartesian3.UNIT_Z;\n      direction = Matrix4.multiplyByPointAsVector(transformLocal, camera.directionWC, scratchDirection);\n      direction = Cartesian3.normalize(direction, direction);\n      height = positionLocal.z;\n\n      if (tileBoundingVolume instanceof TileOrientedBoundingBox) {\n        const boxHeight = root._header.boundingVolume.box[11];\n        minimumHeight = centerLocal.z - boxHeight;\n        maximumHeight = centerLocal.z + boxHeight;\n      } else if (tileBoundingVolume instanceof TileBoundingSphere) {\n        const radius = boundingVolume.radius;\n        minimumHeight = centerLocal.z - radius;\n        maximumHeight = centerLocal.z + radius;\n      }\n    }\n  }\n\n  const heightFalloff = dynamicScreenSpaceErrorHeightFalloff;\n  const heightClose = minimumHeight + (maximumHeight - minimumHeight) * heightFalloff;\n  const heightFar = maximumHeight;\n  const t = clamp((height - heightClose) / (heightFar - heightClose), 0.0, 1.0);\n  const dot = Math.abs(Cartesian3.dot(direction, up));\n  let horizonFactor = 1.0 - dot;\n  horizonFactor = horizonFactor * (1.0 - t);\n  return dynamicScreenSpaceErrorDensity * horizonFactor;\n}\nexport function fog(distanceToCamera, density) {\n  const scalar = distanceToCamera * density;\n  return 1.0 - Math.exp(-(scalar * scalar));\n}\nexport function getDynamicScreenSpaceError(tileset, distanceToCamera) {\n  if (tileset.dynamicScreenSpaceError && tileset.dynamicScreenSpaceErrorComputedDensity) {\n    const density = tileset.dynamicScreenSpaceErrorComputedDensity;\n    const factor = tileset.dynamicScreenSpaceErrorFactor;\n    const dynamicError = fog(distanceToCamera, density) * factor;\n    return dynamicError;\n  }\n\n  return 0;\n}\nexport function getTiles3DScreenSpaceError(tile, frameState, useParentLodMetric) {\n  const tileset = tile.tileset;\n  const parentLodMetricValue = tile.parent && tile.parent.lodMetricValue || tile.lodMetricValue;\n  const lodMetricValue = useParentLodMetric ? parentLodMetricValue : tile.lodMetricValue;\n\n  if (lodMetricValue === 0.0) {\n    return 0.0;\n  }\n\n  const distance = Math.max(tile._distanceToCamera, 1e-7);\n  const {\n    height,\n    sseDenominator\n  } = frameState;\n  const {\n    viewDistanceScale\n  } = tileset.options;\n  let error = lodMetricValue * height * (viewDistanceScale || 1.0) / (distance * sseDenominator);\n  error -= getDynamicScreenSpaceError(tileset, distance);\n  return error;\n}\n//# sourceMappingURL=tiles-3d-lod.js.map","import { Matrix4, Vector3 } from '@math.gl/core';\nimport { Ellipsoid } from '@math.gl/geospatial';\nconst cameraPositionCartesian = new Vector3();\nconst toEye = new Vector3();\nconst cameraPositionEnu = new Vector3();\nconst extraVertexEnu = new Vector3();\nconst projectedOriginVector = new Vector3();\nconst enuToCartesianMatrix = new Matrix4();\nconst cartesianToEnuMatrix = new Matrix4();\nexport function getLodStatus(tile, frameState) {\n  if (tile.lodMetricValue === 0 || isNaN(tile.lodMetricValue)) {\n    return 'DIG';\n  }\n\n  const screenSize = 2 * getProjectedRadius(tile, frameState);\n\n  if (screenSize < 2) {\n    return 'OUT';\n  }\n\n  if (!tile.header.children || screenSize <= tile.lodMetricValue) {\n    return 'DRAW';\n  } else if (tile.header.children) {\n    return 'DIG';\n  }\n\n  return 'OUT';\n}\nexport function getProjectedRadius(tile, frameState) {\n  const {\n    topDownViewport: viewport\n  } = frameState;\n  const mbsLat = tile.header.mbs[1];\n  const mbsLon = tile.header.mbs[0];\n  const mbsZ = tile.header.mbs[2];\n  const mbsR = tile.header.mbs[3];\n  const mbsCenterCartesian = [...tile.boundingVolume.center];\n  const cameraPositionCartographic = viewport.unprojectPosition(viewport.cameraPosition);\n  Ellipsoid.WGS84.cartographicToCartesian(cameraPositionCartographic, cameraPositionCartesian);\n  toEye.copy(cameraPositionCartesian).subtract(mbsCenterCartesian).normalize();\n  Ellipsoid.WGS84.eastNorthUpToFixedFrame(mbsCenterCartesian, enuToCartesianMatrix);\n  cartesianToEnuMatrix.copy(enuToCartesianMatrix).invert();\n  cameraPositionEnu.copy(cameraPositionCartesian).transform(cartesianToEnuMatrix);\n  const projection = Math.sqrt(cameraPositionEnu[0] * cameraPositionEnu[0] + cameraPositionEnu[1] * cameraPositionEnu[1]);\n  const extraZ = projection * projection / cameraPositionEnu[2];\n  extraVertexEnu.copy([cameraPositionEnu[0], cameraPositionEnu[1], extraZ]);\n  const extraVertexCartesian = extraVertexEnu.transform(enuToCartesianMatrix);\n  const extraVectorCartesian = extraVertexCartesian.subtract(mbsCenterCartesian).normalize();\n  const radiusVector = toEye.cross(extraVectorCartesian).normalize().scale(mbsR);\n  const sphereMbsBorderVertexCartesian = radiusVector.add(mbsCenterCartesian);\n  const sphereMbsBorderVertexCartographic = Ellipsoid.WGS84.cartesianToCartographic(sphereMbsBorderVertexCartesian);\n  const projectedOrigin = viewport.project([mbsLon, mbsLat, mbsZ]);\n  const projectedMbsBorderVertex = viewport.project(sphereMbsBorderVertexCartographic);\n  const projectedRadius = projectedOriginVector.copy(projectedOrigin).subtract(projectedMbsBorderVertex).magnitude();\n  return projectedRadius;\n}\n//# sourceMappingURL=i3s-lod.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { assert } from '@loaders.gl/loader-utils';\nexport default class ManagedArray {\n  constructor(length = 0) {\n    _defineProperty(this, \"_map\", new Map());\n\n    _defineProperty(this, \"_array\", void 0);\n\n    _defineProperty(this, \"_length\", void 0);\n\n    this._array = new Array(length);\n    this._length = length;\n  }\n\n  get length() {\n    return this._length;\n  }\n\n  set length(length) {\n    this._length = length;\n\n    if (length > this._array.length) {\n      this._array.length = length;\n    }\n  }\n\n  get values() {\n    return this._array;\n  }\n\n  get(index) {\n    assert(index < this._array.length);\n    return this._array[index];\n  }\n\n  set(index, element) {\n    assert(index >= 0);\n\n    if (index >= this.length) {\n      this.length = index + 1;\n    }\n\n    if (this._map.has(this._array[index])) {\n      this._map.delete(this._array[index]);\n    }\n\n    this._array[index] = element;\n\n    this._map.set(element, index);\n  }\n\n  delete(element) {\n    const index = this._map.get(element);\n\n    if (index >= 0) {\n      this._array.splice(index, 1);\n\n      this._map.delete(element);\n\n      this.length--;\n    }\n  }\n\n  peek() {\n    return this._array[this._length - 1];\n  }\n\n  push(element) {\n    if (!this._map.has(element)) {\n      const index = this.length++;\n      this._array[index] = element;\n\n      this._map.set(element, index);\n    }\n  }\n\n  pop() {\n    const element = this._array[--this.length];\n\n    this._map.delete(element);\n\n    return element;\n  }\n\n  reserve(length) {\n    assert(length >= 0);\n\n    if (length > this._array.length) {\n      this._array.length = length;\n    }\n  }\n\n  resize(length) {\n    assert(length >= 0);\n    this.length = length;\n  }\n\n  trim(length) {\n    if (length === null || length === undefined) {\n      length = this.length;\n    }\n\n    this._array.length = length;\n  }\n\n  reset() {\n    this._array = [];\n    this._map = new Map();\n    this._length = 0;\n  }\n\n  find(target) {\n    return this._map.has(target);\n  }\n\n}\n//# sourceMappingURL=managed-array.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport ManagedArray from '../../utils/managed-array';\nimport { TILE_REFINEMENT } from '../../constants';\nexport const DEFAULT_PROPS = {\n  loadSiblings: false,\n  skipLevelOfDetail: false,\n  maximumScreenSpaceError: 2,\n  updateTransforms: true,\n  onTraversalEnd: () => {},\n  viewportTraversersMap: {},\n  basePath: ''\n};\nexport default class TilesetTraverser {\n  traversalFinished(frameState) {\n    return true;\n  }\n\n  constructor(options) {\n    _defineProperty(this, \"options\", void 0);\n\n    _defineProperty(this, \"root\", void 0);\n\n    _defineProperty(this, \"requestedTiles\", void 0);\n\n    _defineProperty(this, \"selectedTiles\", void 0);\n\n    _defineProperty(this, \"emptyTiles\", void 0);\n\n    _defineProperty(this, \"lastUpdate\", new Date().getTime());\n\n    _defineProperty(this, \"updateDebounceTime\", 1000);\n\n    _defineProperty(this, \"_traversalStack\", void 0);\n\n    _defineProperty(this, \"_emptyTraversalStack\", void 0);\n\n    _defineProperty(this, \"_frameNumber\", void 0);\n\n    this.options = { ...DEFAULT_PROPS,\n      ...options\n    };\n    this._traversalStack = new ManagedArray();\n    this._emptyTraversalStack = new ManagedArray();\n    this._frameNumber = null;\n    this.root = null;\n    this.selectedTiles = {};\n    this.requestedTiles = {};\n    this.emptyTiles = {};\n  }\n\n  traverse(root, frameState, options) {\n    this.root = root;\n    this.options = { ...this.options,\n      ...options\n    };\n    this.reset();\n    this.updateTile(root, frameState);\n    this._frameNumber = frameState.frameNumber;\n    this.executeTraversal(root, frameState);\n  }\n\n  reset() {\n    this.requestedTiles = {};\n    this.selectedTiles = {};\n    this.emptyTiles = {};\n\n    this._traversalStack.reset();\n\n    this._emptyTraversalStack.reset();\n  }\n\n  executeTraversal(root, frameState) {\n    const stack = this._traversalStack;\n    root._selectionDepth = 1;\n    stack.push(root);\n\n    while (stack.length > 0) {\n      const tile = stack.pop();\n      let shouldRefine = false;\n\n      if (this.canTraverse(tile, frameState)) {\n        this.updateChildTiles(tile, frameState);\n        shouldRefine = this.updateAndPushChildren(tile, frameState, stack, tile.hasRenderContent ? tile._selectionDepth + 1 : tile._selectionDepth);\n      }\n\n      const parent = tile.parent;\n      const parentRefines = Boolean(!parent || parent._shouldRefine);\n      const stoppedRefining = !shouldRefine;\n\n      if (!tile.hasRenderContent) {\n        this.emptyTiles[tile.id] = tile;\n        this.loadTile(tile, frameState);\n\n        if (stoppedRefining) {\n          this.selectTile(tile, frameState);\n        }\n      } else if (tile.refine === TILE_REFINEMENT.ADD) {\n        this.loadTile(tile, frameState);\n        this.selectTile(tile, frameState);\n      } else if (tile.refine === TILE_REFINEMENT.REPLACE) {\n        this.loadTile(tile, frameState);\n\n        if (stoppedRefining) {\n          this.selectTile(tile, frameState);\n        }\n      }\n\n      this.touchTile(tile, frameState);\n      tile._shouldRefine = shouldRefine && parentRefines;\n    }\n\n    const newTime = new Date().getTime();\n\n    if (this.traversalFinished(frameState) || newTime - this.lastUpdate > this.updateDebounceTime) {\n      this.lastUpdate = newTime;\n      this.options.onTraversalEnd(frameState);\n    }\n  }\n\n  updateChildTiles(tile, frameState) {\n    const children = tile.children;\n\n    for (const child of children) {\n      this.updateTile(child, frameState);\n    }\n\n    return true;\n  }\n\n  updateAndPushChildren(tile, frameState, stack, depth) {\n    const {\n      loadSiblings,\n      skipLevelOfDetail\n    } = this.options;\n    const children = tile.children;\n    children.sort(this.compareDistanceToCamera.bind(this));\n    const checkRefines = tile.refine === TILE_REFINEMENT.REPLACE && tile.hasRenderContent && !skipLevelOfDetail;\n    let hasVisibleChild = false;\n    let refines = true;\n\n    for (const child of children) {\n      child._selectionDepth = depth;\n\n      if (child.isVisibleAndInRequestVolume) {\n        if (stack.find(child)) {\n          stack.delete(child);\n        }\n\n        stack.push(child);\n        hasVisibleChild = true;\n      } else if (checkRefines || loadSiblings) {\n        this.loadTile(child, frameState);\n        this.touchTile(child, frameState);\n      }\n\n      if (checkRefines) {\n        let childRefines;\n\n        if (!child._inRequestVolume) {\n          childRefines = false;\n        } else if (!child.hasRenderContent) {\n          childRefines = this.executeEmptyTraversal(child, frameState);\n        } else {\n          childRefines = child.contentAvailable;\n        }\n\n        refines = refines && childRefines;\n\n        if (!refines) {\n          return false;\n        }\n      }\n    }\n\n    if (!hasVisibleChild) {\n      refines = false;\n    }\n\n    return refines;\n  }\n\n  updateTile(tile, frameState) {\n    this.updateTileVisibility(tile, frameState);\n  }\n\n  selectTile(tile, frameState) {\n    if (this.shouldSelectTile(tile)) {\n      tile._selectedFrame = frameState.frameNumber;\n      this.selectedTiles[tile.id] = tile;\n    }\n  }\n\n  loadTile(tile, frameState) {\n    if (this.shouldLoadTile(tile)) {\n      tile._requestedFrame = frameState.frameNumber;\n      tile._priority = tile._getPriority();\n      this.requestedTiles[tile.id] = tile;\n    }\n  }\n\n  touchTile(tile, frameState) {\n    tile.tileset._cache.touch(tile);\n\n    tile._touchedFrame = frameState.frameNumber;\n  }\n\n  canTraverse(tile, frameState, useParentMetric = false, ignoreVisibility = false) {\n    if (!tile.hasChildren) {\n      return false;\n    }\n\n    if (tile.hasTilesetContent) {\n      return !tile.contentExpired;\n    }\n\n    if (!ignoreVisibility && !tile.isVisibleAndInRequestVolume) {\n      return false;\n    }\n\n    return this.shouldRefine(tile, frameState, useParentMetric);\n  }\n\n  shouldLoadTile(tile) {\n    return tile.hasUnloadedContent || tile.contentExpired;\n  }\n\n  shouldSelectTile(tile) {\n    return tile.contentAvailable && !this.options.skipLevelOfDetail;\n  }\n\n  shouldRefine(tile, frameState, useParentMetric) {\n    let screenSpaceError = tile._screenSpaceError;\n\n    if (useParentMetric) {\n      screenSpaceError = tile.getScreenSpaceError(frameState, true);\n    }\n\n    return screenSpaceError > this.options.maximumScreenSpaceError;\n  }\n\n  updateTileVisibility(tile, frameState) {\n    const viewportIds = [];\n\n    if (this.options.viewportTraversersMap) {\n      for (const key in this.options.viewportTraversersMap) {\n        const value = this.options.viewportTraversersMap[key];\n\n        if (value === frameState.viewport.id) {\n          viewportIds.push(key);\n        }\n      }\n    } else {\n      viewportIds.push(frameState.viewport.id);\n    }\n\n    tile.updateVisibility(frameState, viewportIds);\n  }\n\n  compareDistanceToCamera(b, a) {\n    return b._distanceToCamera - a._distanceToCamera;\n  }\n\n  anyChildrenVisible(tile, frameState) {\n    let anyVisible = false;\n\n    for (const child of tile.children) {\n      child.updateVisibility(frameState);\n      anyVisible = anyVisible || child.isVisibleAndInRequestVolume;\n    }\n\n    return anyVisible;\n  }\n\n  executeEmptyTraversal(root, frameState) {\n    let allDescendantsLoaded = true;\n    const stack = this._emptyTraversalStack;\n    stack.push(root);\n\n    while (stack.length > 0 && allDescendantsLoaded) {\n      const tile = stack.pop();\n      this.updateTile(tile, frameState);\n\n      if (!tile.isVisibleAndInRequestVolume) {\n        this.loadTile(tile, frameState);\n      }\n\n      this.touchTile(tile, frameState);\n      const traverse = !tile.hasRenderContent && this.canTraverse(tile, frameState, false, true);\n\n      if (traverse) {\n        const children = tile.children;\n\n        for (const child of children) {\n          if (stack.find(child)) {\n            stack.delete(child);\n          }\n\n          stack.push(child);\n        }\n      } else if (!tile.contentAvailable) {\n        allDescendantsLoaded = false;\n      }\n    }\n\n    return allDescendantsLoaded;\n  }\n\n}\n//# sourceMappingURL=tileset-traverser.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { Vector3, Matrix4 } from '@math.gl/core';\nimport { CullingVolume } from '@math.gl/culling';\nimport { load } from '@loaders.gl/core';\nimport { TILE_REFINEMENT, TILE_CONTENT_STATE, TILESET_TYPE } from '../constants';\nimport { createBoundingVolume } from './helpers/bounding-volume';\nimport { getTiles3DScreenSpaceError } from './helpers/tiles-3d-lod';\nimport { getProjectedRadius } from './helpers/i3s-lod';\nimport { get3dTilesOptions } from './helpers/3d-tiles-options';\nimport TilesetTraverser from './traversers/tileset-traverser';\nconst scratchVector = new Vector3();\n\nfunction defined(x) {\n  return x !== undefined && x !== null;\n}\n\nexport default class TileHeader {\n  constructor(tileset, header, parentHeader, extendedId = '') {\n    _defineProperty(this, \"tileset\", void 0);\n\n    _defineProperty(this, \"header\", void 0);\n\n    _defineProperty(this, \"id\", void 0);\n\n    _defineProperty(this, \"url\", void 0);\n\n    _defineProperty(this, \"parent\", void 0);\n\n    _defineProperty(this, \"refine\", void 0);\n\n    _defineProperty(this, \"type\", void 0);\n\n    _defineProperty(this, \"contentUrl\", void 0);\n\n    _defineProperty(this, \"lodMetricType\", void 0);\n\n    _defineProperty(this, \"lodMetricValue\", void 0);\n\n    _defineProperty(this, \"boundingVolume\", void 0);\n\n    _defineProperty(this, \"content\", void 0);\n\n    _defineProperty(this, \"contentState\", void 0);\n\n    _defineProperty(this, \"gpuMemoryUsageInBytes\", void 0);\n\n    _defineProperty(this, \"children\", void 0);\n\n    _defineProperty(this, \"depth\", void 0);\n\n    _defineProperty(this, \"viewportIds\", void 0);\n\n    _defineProperty(this, \"transform\", void 0);\n\n    _defineProperty(this, \"extensions\", void 0);\n\n    _defineProperty(this, \"userData\", void 0);\n\n    _defineProperty(this, \"computedTransform\", void 0);\n\n    _defineProperty(this, \"hasEmptyContent\", void 0);\n\n    _defineProperty(this, \"hasTilesetContent\", void 0);\n\n    _defineProperty(this, \"traverser\", void 0);\n\n    _defineProperty(this, \"_cacheNode\", void 0);\n\n    _defineProperty(this, \"_frameNumber\", void 0);\n\n    _defineProperty(this, \"_lodJudge\", void 0);\n\n    _defineProperty(this, \"_expireDate\", void 0);\n\n    _defineProperty(this, \"_expiredContent\", void 0);\n\n    _defineProperty(this, \"_shouldRefine\", void 0);\n\n    _defineProperty(this, \"_distanceToCamera\", void 0);\n\n    _defineProperty(this, \"_centerZDepth\", void 0);\n\n    _defineProperty(this, \"_screenSpaceError\", void 0);\n\n    _defineProperty(this, \"_visibilityPlaneMask\", void 0);\n\n    _defineProperty(this, \"_visible\", void 0);\n\n    _defineProperty(this, \"_inRequestVolume\", void 0);\n\n    _defineProperty(this, \"_stackLength\", void 0);\n\n    _defineProperty(this, \"_selectionDepth\", void 0);\n\n    _defineProperty(this, \"_touchedFrame\", void 0);\n\n    _defineProperty(this, \"_visitedFrame\", void 0);\n\n    _defineProperty(this, \"_selectedFrame\", void 0);\n\n    _defineProperty(this, \"_requestedFrame\", void 0);\n\n    _defineProperty(this, \"_priority\", void 0);\n\n    _defineProperty(this, \"_contentBoundingVolume\", void 0);\n\n    _defineProperty(this, \"_viewerRequestVolume\", void 0);\n\n    _defineProperty(this, \"_initialTransform\", void 0);\n\n    this.header = header;\n    this.tileset = tileset;\n    this.id = extendedId || header.id;\n    this.url = header.url;\n    this.parent = parentHeader;\n    this.refine = this._getRefine(header.refine);\n    this.type = header.type;\n    this.contentUrl = header.contentUrl;\n    this.lodMetricType = 'geometricError';\n    this.lodMetricValue = 0;\n    this.boundingVolume = null;\n    this.content = null;\n    this.contentState = TILE_CONTENT_STATE.UNLOADED;\n    this.gpuMemoryUsageInBytes = 0;\n    this.children = [];\n    this.hasEmptyContent = false;\n    this.hasTilesetContent = false;\n    this.depth = 0;\n    this.viewportIds = [];\n    this.userData = {};\n    this.extensions = null;\n    this._priority = 0;\n    this._touchedFrame = 0;\n    this._visitedFrame = 0;\n    this._selectedFrame = 0;\n    this._requestedFrame = 0;\n    this._screenSpaceError = 0;\n    this._cacheNode = null;\n    this._frameNumber = null;\n    this._cacheNode = null;\n    this.traverser = new TilesetTraverser({});\n    this._shouldRefine = false;\n    this._distanceToCamera = 0;\n    this._centerZDepth = 0;\n    this._visible = undefined;\n    this._inRequestVolume = false;\n    this._stackLength = 0;\n    this._selectionDepth = 0;\n    this._initialTransform = new Matrix4();\n    this.transform = new Matrix4();\n\n    this._initializeLodMetric(header);\n\n    this._initializeTransforms(header);\n\n    this._initializeBoundingVolumes(header);\n\n    this._initializeContent(header);\n\n    this._initializeRenderingState(header);\n\n    this._lodJudge = null;\n    this._expireDate = null;\n    this._expiredContent = null;\n    Object.seal(this);\n  }\n\n  destroy() {\n    this.header = null;\n  }\n\n  isDestroyed() {\n    return this.header === null;\n  }\n\n  get selected() {\n    return this._selectedFrame === this.tileset._frameNumber;\n  }\n\n  get isVisible() {\n    return this._visible;\n  }\n\n  get isVisibleAndInRequestVolume() {\n    return this._visible && this._inRequestVolume;\n  }\n\n  get hasRenderContent() {\n    return !this.hasEmptyContent && !this.hasTilesetContent;\n  }\n\n  get hasChildren() {\n    return this.children.length > 0 || this.header.children && this.header.children.length > 0;\n  }\n\n  get contentReady() {\n    return this.contentState === TILE_CONTENT_STATE.READY || this.hasEmptyContent;\n  }\n\n  get contentAvailable() {\n    return Boolean(this.contentReady && this.hasRenderContent || this._expiredContent && !this.contentFailed);\n  }\n\n  get hasUnloadedContent() {\n    return this.hasRenderContent && this.contentUnloaded;\n  }\n\n  get contentUnloaded() {\n    return this.contentState === TILE_CONTENT_STATE.UNLOADED;\n  }\n\n  get contentExpired() {\n    return this.contentState === TILE_CONTENT_STATE.EXPIRED;\n  }\n\n  get contentFailed() {\n    return this.contentState === TILE_CONTENT_STATE.FAILED;\n  }\n\n  getScreenSpaceError(frameState, useParentLodMetric) {\n    switch (this.tileset.type) {\n      case TILESET_TYPE.I3S:\n        return getProjectedRadius(this, frameState);\n\n      case TILESET_TYPE.TILES3D:\n        return getTiles3DScreenSpaceError(this, frameState, useParentLodMetric);\n\n      default:\n        throw new Error('Unsupported tileset type');\n    }\n  }\n\n  unselect() {\n    this._selectedFrame = 0;\n  }\n\n  _getPriority() {\n    const traverser = this.tileset._traverser;\n    const {\n      skipLevelOfDetail\n    } = traverser.options;\n    const maySkipTile = this.refine === TILE_REFINEMENT.ADD || skipLevelOfDetail;\n\n    if (maySkipTile && !this.isVisible && this._visible !== undefined) {\n      return -1;\n    }\n\n    if (this.tileset._frameNumber - this._touchedFrame >= 1) {\n      return -1;\n    }\n\n    if (this.contentState === TILE_CONTENT_STATE.UNLOADED) {\n      return -1;\n    }\n\n    const parent = this.parent;\n    const useParentScreenSpaceError = parent && (!maySkipTile || this._screenSpaceError === 0.0 || parent.hasTilesetContent);\n    const screenSpaceError = useParentScreenSpaceError ? parent._screenSpaceError : this._screenSpaceError;\n    const rootScreenSpaceError = traverser.root ? traverser.root._screenSpaceError : 0.0;\n    return Math.max(rootScreenSpaceError - screenSpaceError, 0);\n  }\n\n  async loadContent() {\n    if (this.hasEmptyContent) {\n      return false;\n    }\n\n    if (this.content) {\n      return true;\n    }\n\n    const expired = this.contentExpired;\n\n    if (expired) {\n      this._expireDate = null;\n    }\n\n    this.contentState = TILE_CONTENT_STATE.LOADING;\n    const requestToken = await this.tileset._requestScheduler.scheduleRequest(this.id, this._getPriority.bind(this));\n\n    if (!requestToken) {\n      this.contentState = TILE_CONTENT_STATE.UNLOADED;\n      return false;\n    }\n\n    try {\n      const contentUrl = this.tileset.getTileUrl(this.contentUrl);\n      const loader = this.tileset.loader;\n      const options = { ...this.tileset.loadOptions,\n        [loader.id]: { ...this.tileset.loadOptions[loader.id],\n          isTileset: this.type === 'json',\n          ...this._getLoaderSpecificOptions(loader.id)\n        }\n      };\n      this.content = await load(contentUrl, loader, options);\n\n      if (this.tileset.options.contentLoader) {\n        await this.tileset.options.contentLoader(this);\n      }\n\n      if (this._isTileset()) {\n        this.tileset._initializeTileHeaders(this.content, this);\n      }\n\n      this.contentState = TILE_CONTENT_STATE.READY;\n\n      this._onContentLoaded();\n\n      return true;\n    } catch (error) {\n      this.contentState = TILE_CONTENT_STATE.FAILED;\n      throw error;\n    } finally {\n      requestToken.done();\n    }\n  }\n\n  unloadContent() {\n    if (this.content && this.content.destroy) {\n      this.content.destroy();\n    }\n\n    this.content = null;\n\n    if (this.header.content && this.header.content.destroy) {\n      this.header.content.destroy();\n    }\n\n    this.header.content = null;\n    this.contentState = TILE_CONTENT_STATE.UNLOADED;\n    return true;\n  }\n\n  updateVisibility(frameState, viewportIds) {\n    if (this._frameNumber === frameState.frameNumber) {\n      return;\n    }\n\n    const parent = this.parent;\n    const parentVisibilityPlaneMask = parent ? parent._visibilityPlaneMask : CullingVolume.MASK_INDETERMINATE;\n\n    if (this.tileset._traverser.options.updateTransforms) {\n      const parentTransform = parent ? parent.computedTransform : this.tileset.modelMatrix;\n\n      this._updateTransform(parentTransform);\n    }\n\n    this._distanceToCamera = this.distanceToTile(frameState);\n    this._screenSpaceError = this.getScreenSpaceError(frameState, false);\n    this._visibilityPlaneMask = this.visibility(frameState, parentVisibilityPlaneMask);\n    this._visible = this._visibilityPlaneMask !== CullingVolume.MASK_OUTSIDE;\n    this._inRequestVolume = this.insideViewerRequestVolume(frameState);\n    this._frameNumber = frameState.frameNumber;\n    this.viewportIds = viewportIds;\n  }\n\n  visibility(frameState, parentVisibilityPlaneMask) {\n    const {\n      cullingVolume\n    } = frameState;\n    const {\n      boundingVolume\n    } = this;\n    return cullingVolume.computeVisibilityWithPlaneMask(boundingVolume, parentVisibilityPlaneMask);\n  }\n\n  contentVisibility() {\n    return true;\n  }\n\n  distanceToTile(frameState) {\n    const boundingVolume = this.boundingVolume;\n    return Math.sqrt(Math.max(boundingVolume.distanceSquaredTo(frameState.camera.position), 0));\n  }\n\n  cameraSpaceZDepth({\n    camera\n  }) {\n    const boundingVolume = this.boundingVolume;\n    scratchVector.subVectors(boundingVolume.center, camera.position);\n    return camera.direction.dot(scratchVector);\n  }\n\n  insideViewerRequestVolume(frameState) {\n    const viewerRequestVolume = this._viewerRequestVolume;\n    return !viewerRequestVolume || viewerRequestVolume.distanceSquaredTo(frameState.camera.position) <= 0;\n  }\n\n  updateExpiration() {\n    if (defined(this._expireDate) && this.contentReady && !this.hasEmptyContent) {\n      const now = Date.now();\n\n      if (Date.lessThan(this._expireDate, now)) {\n        this.contentState = TILE_CONTENT_STATE.EXPIRED;\n        this._expiredContent = this.content;\n      }\n    }\n  }\n\n  get extras() {\n    return this.header.extras;\n  }\n\n  _initializeLodMetric(header) {\n    if ('lodMetricType' in header) {\n      this.lodMetricType = header.lodMetricType;\n    } else {\n      this.lodMetricType = this.parent && this.parent.lodMetricType || this.tileset.lodMetricType;\n      console.warn(\"3D Tile: Required prop lodMetricType is undefined. Using parent lodMetricType\");\n    }\n\n    if ('lodMetricValue' in header) {\n      this.lodMetricValue = header.lodMetricValue;\n    } else {\n      this.lodMetricValue = this.parent && this.parent.lodMetricValue || this.tileset.lodMetricValue;\n      console.warn('3D Tile: Required prop lodMetricValue is undefined. Using parent lodMetricValue');\n    }\n  }\n\n  _initializeTransforms(tileHeader) {\n    this.transform = tileHeader.transform ? new Matrix4(tileHeader.transform) : new Matrix4();\n    const parent = this.parent;\n    const tileset = this.tileset;\n    const parentTransform = parent && parent.computedTransform ? parent.computedTransform.clone() : tileset.modelMatrix.clone();\n    this.computedTransform = new Matrix4(parentTransform).multiplyRight(this.transform);\n    const parentInitialTransform = parent && parent._initialTransform ? parent._initialTransform.clone() : new Matrix4();\n    this._initialTransform = new Matrix4(parentInitialTransform).multiplyRight(this.transform);\n  }\n\n  _initializeBoundingVolumes(tileHeader) {\n    this._contentBoundingVolume = null;\n    this._viewerRequestVolume = null;\n\n    this._updateBoundingVolume(tileHeader);\n  }\n\n  _initializeContent(tileHeader) {\n    this.content = {\n      _tileset: this.tileset,\n      _tile: this\n    };\n    this.hasEmptyContent = true;\n    this.contentState = TILE_CONTENT_STATE.UNLOADED;\n    this.hasTilesetContent = false;\n\n    if (tileHeader.contentUrl) {\n      this.content = null;\n      this.hasEmptyContent = false;\n    }\n  }\n\n  _initializeRenderingState(header) {\n    this.depth = header.level || (this.parent ? this.parent.depth + 1 : 0);\n    this._shouldRefine = false;\n    this._distanceToCamera = 0;\n    this._centerZDepth = 0;\n    this._screenSpaceError = 0;\n    this._visibilityPlaneMask = CullingVolume.MASK_INDETERMINATE;\n    this._visible = undefined;\n    this._inRequestVolume = false;\n    this._stackLength = 0;\n    this._selectionDepth = 0;\n    this._frameNumber = 0;\n    this._touchedFrame = 0;\n    this._visitedFrame = 0;\n    this._selectedFrame = 0;\n    this._requestedFrame = 0;\n    this._priority = 0.0;\n  }\n\n  _getRefine(refine) {\n    return refine || this.parent && this.parent.refine || TILE_REFINEMENT.REPLACE;\n  }\n\n  _isTileset() {\n    return this.contentUrl.indexOf('.json') !== -1;\n  }\n\n  _onContentLoaded() {\n    switch (this.content && this.content.type) {\n      case 'vctr':\n      case 'geom':\n        this.tileset._traverser.disableSkipLevelOfDetail = true;\n        break;\n\n      default:\n    }\n\n    if (this._isTileset()) {\n      this.hasTilesetContent = true;\n    }\n  }\n\n  _updateBoundingVolume(header) {\n    this.boundingVolume = createBoundingVolume(header.boundingVolume, this.computedTransform, this.boundingVolume);\n    const content = header.content;\n\n    if (!content) {\n      return;\n    }\n\n    if (content.boundingVolume) {\n      this._contentBoundingVolume = createBoundingVolume(content.boundingVolume, this.computedTransform, this._contentBoundingVolume);\n    }\n\n    if (header.viewerRequestVolume) {\n      this._viewerRequestVolume = createBoundingVolume(header.viewerRequestVolume, this.computedTransform, this._viewerRequestVolume);\n    }\n  }\n\n  _updateTransform(parentTransform = new Matrix4()) {\n    const computedTransform = parentTransform.clone().multiplyRight(this.transform);\n    const didTransformChange = !computedTransform.equals(this.computedTransform);\n\n    if (!didTransformChange) {\n      return;\n    }\n\n    this.computedTransform = computedTransform;\n\n    this._updateBoundingVolume(this.header);\n  }\n\n  _getLoaderSpecificOptions(loaderId) {\n    switch (loaderId) {\n      case 'i3s':\n        return { ...this.tileset.options.i3s,\n          tile: this.header,\n          tileset: this.tileset.tileset,\n          isTileHeader: false\n        };\n\n      case '3d-tiles':\n      case 'cesium-ion':\n      default:\n        return get3dTilesOptions(this.tileset.tileset);\n    }\n  }\n\n}\n//# sourceMappingURL=tile-3d.js.map","export function get3dTilesOptions(tileset) {\n  return {\n    assetGltfUpAxis: tileset.asset && tileset.asset.gltfUpAxis || 'Y'\n  };\n}\n//# sourceMappingURL=3d-tiles-options.js.map","import { TILE3D_OPTIMIZATION_HINT, TILE_REFINEMENT } from '../../constants';\nimport TilesetTraverser from './tileset-traverser';\nexport default class Tileset3DTraverser extends TilesetTraverser {\n  compareDistanceToCamera(a, b) {\n    return b._distanceToCamera === 0 && a._distanceToCamera === 0 ? b._centerZDepth - a._centerZDepth : b._distanceToCamera - a._distanceToCamera;\n  }\n\n  updateTileVisibility(tile, frameState) {\n    super.updateTileVisibility(tile, frameState);\n\n    if (!tile.isVisibleAndInRequestVolume) {\n      return;\n    }\n\n    const hasChildren = tile.children.length > 0;\n\n    if (tile.hasTilesetContent && hasChildren) {\n      const firstChild = tile.children[0];\n      this.updateTileVisibility(firstChild, frameState);\n      tile._visible = firstChild._visible;\n      return;\n    }\n\n    if (this.meetsScreenSpaceErrorEarly(tile, frameState)) {\n      tile._visible = false;\n      return;\n    }\n\n    const replace = tile.refine === TILE_REFINEMENT.REPLACE;\n    const useOptimization = tile._optimChildrenWithinParent === TILE3D_OPTIMIZATION_HINT.USE_OPTIMIZATION;\n\n    if (replace && useOptimization && hasChildren) {\n      if (!this.anyChildrenVisible(tile, frameState)) {\n        tile._visible = false;\n        return;\n      }\n    }\n  }\n\n  meetsScreenSpaceErrorEarly(tile, frameState) {\n    const {\n      parent\n    } = tile;\n\n    if (!parent || parent.hasTilesetContent || parent.refine !== TILE_REFINEMENT.ADD) {\n      return false;\n    }\n\n    return !this.shouldRefine(tile, frameState, true);\n  }\n\n}\n//# sourceMappingURL=tileset-3d-traverser.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nexport default class I3SPendingTilesRegister {\n  constructor() {\n    _defineProperty(this, \"frameNumberMap\", new Map());\n  }\n\n  register(viewportId, frameNumber) {\n    const viewportMap = this.frameNumberMap.get(viewportId) || new Map();\n    const oldCount = viewportMap.get(frameNumber) || 0;\n    viewportMap.set(frameNumber, oldCount + 1);\n    this.frameNumberMap.set(viewportId, viewportMap);\n  }\n\n  deregister(viewportId, frameNumber) {\n    const viewportMap = this.frameNumberMap.get(viewportId);\n\n    if (!viewportMap) {\n      return;\n    }\n\n    const oldCount = viewportMap.get(frameNumber) || 1;\n    viewportMap.set(frameNumber, oldCount - 1);\n  }\n\n  isZero(viewportId, frameNumber) {\n    var _this$frameNumberMap$;\n\n    const count = ((_this$frameNumberMap$ = this.frameNumberMap.get(viewportId)) === null || _this$frameNumberMap$ === void 0 ? void 0 : _this$frameNumberMap$.get(frameNumber)) || 0;\n    return count === 0;\n  }\n\n}\n//# sourceMappingURL=i3s-pending-tiles-register.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport I3SPendingTilesRegister from './i3s-pending-tiles-register';\nconst STATUS = {\n  REQUESTED: 'REQUESTED',\n  COMPLETED: 'COMPLETED',\n  ERROR: 'ERROR'\n};\nexport default class I3STileManager {\n  constructor() {\n    _defineProperty(this, \"_statusMap\", void 0);\n\n    _defineProperty(this, \"pendingTilesRegister\", new I3SPendingTilesRegister());\n\n    this._statusMap = {};\n  }\n\n  add(request, key, callback, frameState) {\n    if (!this._statusMap[key]) {\n      const {\n        frameNumber,\n        viewport: {\n          id\n        }\n      } = frameState;\n      this._statusMap[key] = {\n        request,\n        callback,\n        key,\n        frameState,\n        status: STATUS.REQUESTED\n      };\n      this.pendingTilesRegister.register(id, frameNumber);\n      request().then(data => {\n        this._statusMap[key].status = STATUS.COMPLETED;\n        const {\n          frameNumber: actualFrameNumber,\n          viewport: {\n            id\n          }\n        } = this._statusMap[key].frameState;\n        this.pendingTilesRegister.deregister(id, actualFrameNumber);\n\n        this._statusMap[key].callback(data, frameState);\n      }).catch(error => {\n        this._statusMap[key].status = STATUS.ERROR;\n        const {\n          frameNumber: actualFrameNumber,\n          viewport: {\n            id\n          }\n        } = this._statusMap[key].frameState;\n        this.pendingTilesRegister.deregister(id, actualFrameNumber);\n        callback(error);\n      });\n    }\n  }\n\n  update(key, frameState) {\n    if (this._statusMap[key]) {\n      const {\n        frameNumber,\n        viewport: {\n          id\n        }\n      } = this._statusMap[key].frameState;\n      this.pendingTilesRegister.deregister(id, frameNumber);\n      const {\n        frameNumber: newFrameNumber,\n        viewport: {\n          id: newViewportId\n        }\n      } = frameState;\n      this.pendingTilesRegister.register(newViewportId, newFrameNumber);\n      this._statusMap[key].frameState = frameState;\n    }\n  }\n\n  find(key) {\n    return this._statusMap[key];\n  }\n\n  hasPendingTiles(viewportId, frameNumber) {\n    return !this.pendingTilesRegister.isZero(viewportId, frameNumber);\n  }\n\n}\n//# sourceMappingURL=i3s-tile-manager.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { load } from '@loaders.gl/core';\nimport TilesetTraverser from './tileset-traverser';\nimport { getLodStatus } from '../helpers/i3s-lod';\nimport TileHeader from '../tile-3d';\nimport I3STileManager from './i3s-tile-manager';\nexport default class I3STilesetTraverser extends TilesetTraverser {\n  traversalFinished(frameState) {\n    return !this._tileManager.hasPendingTiles(frameState.viewport.id, this._frameNumber || 0);\n  }\n\n  constructor(options) {\n    super(options);\n\n    _defineProperty(this, \"_tileManager\", void 0);\n\n    this._tileManager = new I3STileManager();\n  }\n\n  shouldRefine(tile, frameState) {\n    tile._lodJudge = getLodStatus(tile, frameState);\n    return tile._lodJudge === 'DIG';\n  }\n\n  updateChildTiles(tile, frameState) {\n    const children = tile.header.children || [];\n    const childTiles = tile.children;\n    const tileset = tile.tileset;\n\n    for (const child of children) {\n      const extendedId = \"\".concat(child.id, \"-\").concat(frameState.viewport.id);\n      const childTile = childTiles && childTiles.find(t => t.id === extendedId);\n\n      if (!childTile) {\n        let request = () => this._loadTile(child.id, tileset);\n\n        const cachedRequest = this._tileManager.find(extendedId);\n\n        if (!cachedRequest) {\n          if (tileset.tileset.nodePages) {\n            request = () => tileset.tileset.nodePagesTile.formTileFromNodePages(child.id);\n          }\n\n          this._tileManager.add(request, extendedId, header => this._onTileLoad(header, tile, extendedId), frameState);\n        } else {\n          this._tileManager.update(extendedId, frameState);\n        }\n      } else if (childTile) {\n        this.updateTile(childTile, frameState);\n      }\n    }\n\n    return false;\n  }\n\n  async _loadTile(nodeId, tileset) {\n    const {\n      loader\n    } = tileset;\n    const nodeUrl = tileset.getTileUrl(\"\".concat(tileset.url, \"/nodes/\").concat(nodeId));\n    const options = { ...tileset.loadOptions,\n      i3s: { ...tileset.loadOptions.i3s,\n        isTileHeader: true,\n        loadContent: false\n      }\n    };\n    return await load(nodeUrl, loader, options);\n  }\n\n  _onTileLoad(header, tile, extendedId) {\n    const childTile = new TileHeader(tile.tileset, header, tile, extendedId);\n    tile.children.push(childTile);\n\n    const frameState = this._tileManager.find(childTile.id).frameState;\n\n    this.updateTile(childTile, frameState);\n\n    if (this._frameNumber === frameState.frameNumber && (this.traversalFinished(frameState) || new Date().getTime() - this.lastUpdate > this.updateDebounceTime)) {\n      this.executeTraversal(childTile, frameState);\n    }\n  }\n\n}\n//# sourceMappingURL=i3s-tileset-traverser.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { Matrix4, Vector3 } from '@math.gl/core';\nimport { Ellipsoid } from '@math.gl/geospatial';\nimport { Stats } from '@probe.gl/stats';\nimport { RequestScheduler, assert, path } from '@loaders.gl/loader-utils';\nimport TilesetCache from './tileset-cache';\nimport { calculateTransformProps } from './helpers/transform-utils';\nimport { getFrameState, limitSelectedTiles } from './helpers/frame-state';\nimport { getZoomFromBoundingVolume, getZoomFromExtent, getZoomFromFullExtent } from './helpers/zoom';\nimport Tile3D from './tile-3d';\nimport Tileset3DTraverser from './traversers/tileset-3d-traverser';\nimport TilesetTraverser from './traversers/tileset-traverser';\nimport I3SetTraverser from './traversers/i3s-tileset-traverser';\nimport { TILESET_TYPE } from '../constants';\nconst DEFAULT_PROPS = {\n  description: '',\n  ellipsoid: Ellipsoid.WGS84,\n  modelMatrix: new Matrix4(),\n  throttleRequests: true,\n  maxRequests: 64,\n  maximumMemoryUsage: 32,\n  maximumTilesSelected: 0,\n  debounceTime: 0,\n  onTileLoad: () => {},\n  onTileUnload: () => {},\n  onTileError: () => {},\n  onTraversalComplete: selectedTiles => selectedTiles,\n  contentLoader: undefined,\n  viewDistanceScale: 1.0,\n  maximumScreenSpaceError: 8,\n  loadTiles: true,\n  updateTransforms: true,\n  viewportTraversersMap: null,\n  loadOptions: {\n    fetch: {}\n  },\n  attributions: [],\n  basePath: '',\n  i3s: {}\n};\nconst TILES_TOTAL = 'Tiles In Tileset(s)';\nconst TILES_IN_MEMORY = 'Tiles In Memory';\nconst TILES_IN_VIEW = 'Tiles In View';\nconst TILES_RENDERABLE = 'Tiles To Render';\nconst TILES_LOADED = 'Tiles Loaded';\nconst TILES_LOADING = 'Tiles Loading';\nconst TILES_UNLOADED = 'Tiles Unloaded';\nconst TILES_LOAD_FAILED = 'Failed Tile Loads';\nconst POINTS_COUNT = 'Points/Vertices';\nconst TILES_GPU_MEMORY = 'Tile Memory Use';\nexport default class Tileset3D {\n  constructor(json, options) {\n    _defineProperty(this, \"options\", void 0);\n\n    _defineProperty(this, \"loadOptions\", void 0);\n\n    _defineProperty(this, \"type\", void 0);\n\n    _defineProperty(this, \"tileset\", void 0);\n\n    _defineProperty(this, \"loader\", void 0);\n\n    _defineProperty(this, \"url\", void 0);\n\n    _defineProperty(this, \"basePath\", void 0);\n\n    _defineProperty(this, \"modelMatrix\", void 0);\n\n    _defineProperty(this, \"ellipsoid\", void 0);\n\n    _defineProperty(this, \"lodMetricType\", void 0);\n\n    _defineProperty(this, \"lodMetricValue\", void 0);\n\n    _defineProperty(this, \"refine\", void 0);\n\n    _defineProperty(this, \"root\", void 0);\n\n    _defineProperty(this, \"roots\", void 0);\n\n    _defineProperty(this, \"asset\", void 0);\n\n    _defineProperty(this, \"description\", void 0);\n\n    _defineProperty(this, \"properties\", void 0);\n\n    _defineProperty(this, \"extras\", void 0);\n\n    _defineProperty(this, \"attributions\", void 0);\n\n    _defineProperty(this, \"credits\", void 0);\n\n    _defineProperty(this, \"stats\", void 0);\n\n    _defineProperty(this, \"traverseCounter\", void 0);\n\n    _defineProperty(this, \"geometricError\", void 0);\n\n    _defineProperty(this, \"selectedTiles\", void 0);\n\n    _defineProperty(this, \"updatePromise\", null);\n\n    _defineProperty(this, \"tilesetInitializationPromise\", void 0);\n\n    _defineProperty(this, \"cartographicCenter\", void 0);\n\n    _defineProperty(this, \"cartesianCenter\", void 0);\n\n    _defineProperty(this, \"zoom\", void 0);\n\n    _defineProperty(this, \"boundingVolume\", void 0);\n\n    _defineProperty(this, \"gpuMemoryUsageInBytes\", void 0);\n\n    _defineProperty(this, \"dynamicScreenSpaceErrorComputedDensity\", void 0);\n\n    _defineProperty(this, \"_traverser\", void 0);\n\n    _defineProperty(this, \"_cache\", void 0);\n\n    _defineProperty(this, \"_requestScheduler\", void 0);\n\n    _defineProperty(this, \"_frameNumber\", void 0);\n\n    _defineProperty(this, \"_queryParamsString\", void 0);\n\n    _defineProperty(this, \"_queryParams\", void 0);\n\n    _defineProperty(this, \"_extensionsUsed\", void 0);\n\n    _defineProperty(this, \"_tiles\", void 0);\n\n    _defineProperty(this, \"_pendingCount\", void 0);\n\n    _defineProperty(this, \"lastUpdatedVieports\", void 0);\n\n    _defineProperty(this, \"_requestedTiles\", void 0);\n\n    _defineProperty(this, \"_emptyTiles\", void 0);\n\n    _defineProperty(this, \"frameStateData\", void 0);\n\n    _defineProperty(this, \"maximumMemoryUsage\", void 0);\n\n    assert(json);\n    this.options = { ...DEFAULT_PROPS,\n      ...options\n    };\n    this.tileset = json;\n    this.loader = json.loader;\n    this.type = json.type;\n    this.url = json.url;\n    this.basePath = json.basePath || path.dirname(this.url);\n    this.modelMatrix = this.options.modelMatrix;\n    this.ellipsoid = this.options.ellipsoid;\n    this.lodMetricType = json.lodMetricType;\n    this.lodMetricValue = json.lodMetricValue;\n    this.refine = json.root.refine;\n    this.loadOptions = this.options.loadOptions || {};\n    this.root = null;\n    this.roots = {};\n    this.cartographicCenter = null;\n    this.cartesianCenter = null;\n    this.zoom = 1;\n    this.boundingVolume = null;\n    this.traverseCounter = 0;\n    this.geometricError = 0;\n    this._traverser = this._initializeTraverser();\n    this._cache = new TilesetCache();\n    this._requestScheduler = new RequestScheduler({\n      throttleRequests: this.options.throttleRequests,\n      maxRequests: this.options.maxRequests\n    });\n    this._frameNumber = 0;\n    this._pendingCount = 0;\n    this._tiles = {};\n    this.selectedTiles = [];\n    this._emptyTiles = [];\n    this._requestedTiles = [];\n    this.frameStateData = {};\n    this.lastUpdatedVieports = null;\n    this._queryParams = {};\n    this._queryParamsString = '';\n    this.maximumMemoryUsage = this.options.maximumMemoryUsage || 32;\n    this.gpuMemoryUsageInBytes = 0;\n    this.stats = new Stats({\n      id: this.url\n    });\n\n    this._initializeStats();\n\n    this._extensionsUsed = undefined;\n    this.dynamicScreenSpaceErrorComputedDensity = 0.0;\n    this.extras = null;\n    this.asset = {};\n    this.credits = {};\n    this.description = this.options.description || '';\n    this.tilesetInitializationPromise = this._initializeTileSet(json);\n  }\n\n  destroy() {\n    this._destroy();\n  }\n\n  isLoaded() {\n    return this._pendingCount === 0 && this._frameNumber !== 0 && this._requestedTiles.length === 0;\n  }\n\n  get tiles() {\n    return Object.values(this._tiles);\n  }\n\n  get frameNumber() {\n    return this._frameNumber;\n  }\n\n  get queryParams() {\n    if (!this._queryParamsString) {\n      this._queryParamsString = getQueryParamString(this._queryParams);\n    }\n\n    return this._queryParamsString;\n  }\n\n  setProps(props) {\n    this.options = { ...this.options,\n      ...props\n    };\n  }\n\n  setOptions(options) {\n    this.options = { ...this.options,\n      ...options\n    };\n  }\n\n  getTileUrl(tilePath) {\n    const isDataUrl = tilePath.startsWith('data:');\n\n    if (isDataUrl) {\n      return tilePath;\n    }\n\n    return \"\".concat(tilePath).concat(this.queryParams);\n  }\n\n  hasExtension(extensionName) {\n    return Boolean(this._extensionsUsed && this._extensionsUsed.indexOf(extensionName) > -1);\n  }\n\n  update(viewports = null) {\n    this.tilesetInitializationPromise.then(() => {\n      if (!viewports && this.lastUpdatedVieports) {\n        viewports = this.lastUpdatedVieports;\n      } else {\n        this.lastUpdatedVieports = viewports;\n      }\n\n      if (viewports) {\n        this.doUpdate(viewports);\n      }\n    });\n  }\n\n  async selectTiles(viewports = null) {\n    await this.tilesetInitializationPromise;\n\n    if (viewports) {\n      this.lastUpdatedVieports = viewports;\n    }\n\n    if (!this.updatePromise) {\n      this.updatePromise = new Promise(resolve => {\n        setTimeout(() => {\n          if (this.lastUpdatedVieports) {\n            this.doUpdate(this.lastUpdatedVieports);\n          }\n\n          resolve(this._frameNumber);\n          this.updatePromise = null;\n        }, this.options.debounceTime);\n      });\n    }\n\n    return this.updatePromise;\n  }\n\n  doUpdate(viewports) {\n    if ('loadTiles' in this.options && !this.options.loadTiles) {\n      return;\n    }\n\n    if (this.traverseCounter > 0) {\n      return;\n    }\n\n    const preparedViewports = viewports instanceof Array ? viewports : [viewports];\n\n    this._cache.reset();\n\n    this._frameNumber++;\n    this.traverseCounter = preparedViewports.length;\n    const viewportsToTraverse = [];\n\n    for (const viewport of preparedViewports) {\n      const id = viewport.id;\n\n      if (this._needTraverse(id)) {\n        viewportsToTraverse.push(id);\n      } else {\n        this.traverseCounter--;\n      }\n    }\n\n    for (const viewport of preparedViewports) {\n      const id = viewport.id;\n\n      if (!this.roots[id]) {\n        this.roots[id] = this._initializeTileHeaders(this.tileset, null);\n      }\n\n      if (!viewportsToTraverse.includes(id)) {\n        continue;\n      }\n\n      const frameState = getFrameState(viewport, this._frameNumber);\n\n      this._traverser.traverse(this.roots[id], frameState, this.options);\n    }\n  }\n\n  _needTraverse(viewportId) {\n    let traverserId = viewportId;\n\n    if (this.options.viewportTraversersMap) {\n      traverserId = this.options.viewportTraversersMap[viewportId];\n    }\n\n    if (traverserId !== viewportId) {\n      return false;\n    }\n\n    return true;\n  }\n\n  _onTraversalEnd(frameState) {\n    const id = frameState.viewport.id;\n\n    if (!this.frameStateData[id]) {\n      this.frameStateData[id] = {\n        selectedTiles: [],\n        _requestedTiles: [],\n        _emptyTiles: []\n      };\n    }\n\n    const currentFrameStateData = this.frameStateData[id];\n    const selectedTiles = Object.values(this._traverser.selectedTiles);\n    const [filteredSelectedTiles, unselectedTiles] = limitSelectedTiles(selectedTiles, frameState, this.options.maximumTilesSelected);\n    currentFrameStateData.selectedTiles = filteredSelectedTiles;\n\n    for (const tile of unselectedTiles) {\n      tile.unselect();\n    }\n\n    currentFrameStateData._requestedTiles = Object.values(this._traverser.requestedTiles);\n    currentFrameStateData._emptyTiles = Object.values(this._traverser.emptyTiles);\n    this.traverseCounter--;\n\n    if (this.traverseCounter > 0) {\n      return;\n    }\n\n    this._updateTiles();\n  }\n\n  _updateTiles() {\n    this.selectedTiles = [];\n    this._requestedTiles = [];\n    this._emptyTiles = [];\n\n    for (const frameStateKey in this.frameStateData) {\n      const frameStateDataValue = this.frameStateData[frameStateKey];\n      this.selectedTiles = this.selectedTiles.concat(frameStateDataValue.selectedTiles);\n      this._requestedTiles = this._requestedTiles.concat(frameStateDataValue._requestedTiles);\n      this._emptyTiles = this._emptyTiles.concat(frameStateDataValue._emptyTiles);\n    }\n\n    this.selectedTiles = this.options.onTraversalComplete(this.selectedTiles);\n\n    for (const tile of this.selectedTiles) {\n      this._tiles[tile.id] = tile;\n    }\n\n    this._loadTiles();\n\n    this._unloadTiles();\n\n    this._updateStats();\n  }\n\n  _tilesChanged(oldSelectedTiles, selectedTiles) {\n    if (oldSelectedTiles.length !== selectedTiles.length) {\n      return true;\n    }\n\n    const set1 = new Set(oldSelectedTiles.map(t => t.id));\n    const set2 = new Set(selectedTiles.map(t => t.id));\n    let changed = oldSelectedTiles.filter(x => !set2.has(x.id)).length > 0;\n    changed = changed || selectedTiles.filter(x => !set1.has(x.id)).length > 0;\n    return changed;\n  }\n\n  _loadTiles() {\n    for (const tile of this._requestedTiles) {\n      if (tile.contentUnloaded) {\n        this._loadTile(tile);\n      }\n    }\n  }\n\n  _unloadTiles() {\n    this._cache.unloadTiles(this, (tileset, tile) => tileset._unloadTile(tile));\n  }\n\n  _updateStats() {\n    let tilesRenderable = 0;\n    let pointsRenderable = 0;\n\n    for (const tile of this.selectedTiles) {\n      if (tile.contentAvailable && tile.content) {\n        tilesRenderable++;\n\n        if (tile.content.pointCount) {\n          pointsRenderable += tile.content.pointCount;\n        } else {\n          pointsRenderable += tile.content.vertexCount;\n        }\n      }\n    }\n\n    this.stats.get(TILES_IN_VIEW).count = this.selectedTiles.length;\n    this.stats.get(TILES_RENDERABLE).count = tilesRenderable;\n    this.stats.get(POINTS_COUNT).count = pointsRenderable;\n  }\n\n  async _initializeTileSet(tilesetJson) {\n    if (this.type === TILESET_TYPE.I3S) {\n      this.calculateViewPropsI3S();\n      tilesetJson.root = await tilesetJson.root;\n    }\n\n    this.root = this._initializeTileHeaders(tilesetJson, null);\n\n    if (this.type === TILESET_TYPE.TILES3D) {\n      this._initializeTiles3DTileset(tilesetJson);\n\n      this.calculateViewPropsTiles3D();\n    }\n\n    if (this.type === TILESET_TYPE.I3S) {\n      this._initializeI3STileset();\n    }\n  }\n\n  calculateViewPropsI3S() {\n    var _this$tileset$store;\n\n    const fullExtent = this.tileset.fullExtent;\n\n    if (fullExtent) {\n      const {\n        xmin,\n        xmax,\n        ymin,\n        ymax,\n        zmin,\n        zmax\n      } = fullExtent;\n      this.cartographicCenter = new Vector3(xmin + (xmax - xmin) / 2, ymin + (ymax - ymin) / 2, zmin + (zmax - zmin) / 2);\n      this.cartesianCenter = Ellipsoid.WGS84.cartographicToCartesian(this.cartographicCenter, new Vector3());\n      this.zoom = getZoomFromFullExtent(fullExtent, this.cartographicCenter, this.cartesianCenter);\n      return;\n    }\n\n    const extent = (_this$tileset$store = this.tileset.store) === null || _this$tileset$store === void 0 ? void 0 : _this$tileset$store.extent;\n\n    if (extent) {\n      const [xmin, ymin, xmax, ymax] = extent;\n      this.cartographicCenter = new Vector3(xmin + (xmax - xmin) / 2, ymin + (ymax - ymin) / 2, 0);\n      this.cartesianCenter = Ellipsoid.WGS84.cartographicToCartesian(this.cartographicCenter, new Vector3());\n      this.zoom = getZoomFromExtent(extent, this.cartographicCenter, this.cartesianCenter);\n      return;\n    }\n\n    console.warn('Extent is not defined in the tileset header');\n    this.cartographicCenter = new Vector3();\n    this.zoom = 1;\n    return;\n  }\n\n  calculateViewPropsTiles3D() {\n    const root = this.root;\n    assert(root);\n    const {\n      center\n    } = root.boundingVolume;\n\n    if (!center) {\n      console.warn('center was not pre-calculated for the root tile');\n      this.cartographicCenter = new Vector3();\n      this.zoom = 1;\n      return;\n    }\n\n    if (center[0] !== 0 || center[1] !== 0 || center[2] !== 0) {\n      this.cartographicCenter = Ellipsoid.WGS84.cartesianToCartographic(center, new Vector3());\n    } else {\n      this.cartographicCenter = new Vector3(0, 0, -Ellipsoid.WGS84.radii[0]);\n    }\n\n    this.cartesianCenter = center;\n    this.zoom = getZoomFromBoundingVolume(root.boundingVolume, this.cartographicCenter);\n  }\n\n  _initializeStats() {\n    this.stats.get(TILES_TOTAL);\n    this.stats.get(TILES_LOADING);\n    this.stats.get(TILES_IN_MEMORY);\n    this.stats.get(TILES_IN_VIEW);\n    this.stats.get(TILES_RENDERABLE);\n    this.stats.get(TILES_LOADED);\n    this.stats.get(TILES_UNLOADED);\n    this.stats.get(TILES_LOAD_FAILED);\n    this.stats.get(POINTS_COUNT, 'memory');\n    this.stats.get(TILES_GPU_MEMORY, 'memory');\n  }\n\n  _initializeTileHeaders(tilesetJson, parentTileHeader) {\n    const rootTile = new Tile3D(this, tilesetJson.root, parentTileHeader);\n\n    if (parentTileHeader) {\n      parentTileHeader.children.push(rootTile);\n      rootTile.depth = parentTileHeader.depth + 1;\n    }\n\n    if (this.type === TILESET_TYPE.TILES3D) {\n      const stack = [];\n      stack.push(rootTile);\n\n      while (stack.length > 0) {\n        const tile = stack.pop();\n        this.stats.get(TILES_TOTAL).incrementCount();\n        const children = tile.header.children || [];\n\n        for (const childHeader of children) {\n          const childTile = new Tile3D(this, childHeader, tile);\n          tile.children.push(childTile);\n          childTile.depth = tile.depth + 1;\n          stack.push(childTile);\n        }\n      }\n    }\n\n    return rootTile;\n  }\n\n  _initializeTraverser() {\n    let TraverserClass;\n    const type = this.type;\n\n    switch (type) {\n      case TILESET_TYPE.TILES3D:\n        TraverserClass = Tileset3DTraverser;\n        break;\n\n      case TILESET_TYPE.I3S:\n        TraverserClass = I3SetTraverser;\n        break;\n\n      default:\n        TraverserClass = TilesetTraverser;\n    }\n\n    return new TraverserClass({\n      basePath: this.basePath,\n      onTraversalEnd: this._onTraversalEnd.bind(this)\n    });\n  }\n\n  _destroyTileHeaders(parentTile) {\n    this._destroySubtree(parentTile);\n  }\n\n  async _loadTile(tile) {\n    let loaded;\n\n    try {\n      this._onStartTileLoading();\n\n      loaded = await tile.loadContent();\n    } catch (error) {\n      this._onTileLoadError(tile, error);\n    } finally {\n      this._onEndTileLoading();\n\n      this._onTileLoad(tile, loaded);\n    }\n  }\n\n  _onTileLoadError(tile, error) {\n    this.stats.get(TILES_LOAD_FAILED).incrementCount();\n    const message = error.message || error.toString();\n    const url = tile.url;\n    console.error(\"A 3D tile failed to load: \".concat(tile.url, \" \").concat(message));\n    this.options.onTileError(tile, message, url);\n  }\n\n  _onTileLoad(tile, loaded) {\n    if (!loaded) {\n      return;\n    }\n\n    if (this.type === TILESET_TYPE.I3S) {\n      var _this$tileset, _this$tileset$nodePag;\n\n      const nodesInNodePages = ((_this$tileset = this.tileset) === null || _this$tileset === void 0 ? void 0 : (_this$tileset$nodePag = _this$tileset.nodePagesTile) === null || _this$tileset$nodePag === void 0 ? void 0 : _this$tileset$nodePag.nodesInNodePages) || 0;\n      this.stats.get(TILES_TOTAL).reset();\n      this.stats.get(TILES_TOTAL).addCount(nodesInNodePages);\n    }\n\n    if (tile && tile.content) {\n      calculateTransformProps(tile, tile.content);\n    }\n\n    this._addTileToCache(tile);\n\n    this.options.onTileLoad(tile);\n  }\n\n  _onStartTileLoading() {\n    this._pendingCount++;\n    this.stats.get(TILES_LOADING).incrementCount();\n  }\n\n  _onEndTileLoading() {\n    this._pendingCount--;\n    this.stats.get(TILES_LOADING).decrementCount();\n  }\n\n  _addTileToCache(tile) {\n    this._cache.add(this, tile, tileset => tileset._updateCacheStats(tile));\n  }\n\n  _updateCacheStats(tile) {\n    this.stats.get(TILES_LOADED).incrementCount();\n    this.stats.get(TILES_IN_MEMORY).incrementCount();\n    this.gpuMemoryUsageInBytes += tile.content.byteLength || 0;\n    this.stats.get(TILES_GPU_MEMORY).count = this.gpuMemoryUsageInBytes;\n  }\n\n  _unloadTile(tile) {\n    this.gpuMemoryUsageInBytes -= tile.content && tile.content.byteLength || 0;\n    this.stats.get(TILES_IN_MEMORY).decrementCount();\n    this.stats.get(TILES_UNLOADED).incrementCount();\n    this.stats.get(TILES_GPU_MEMORY).count = this.gpuMemoryUsageInBytes;\n    this.options.onTileUnload(tile);\n    tile.unloadContent();\n  }\n\n  _destroy() {\n    const stack = [];\n\n    if (this.root) {\n      stack.push(this.root);\n    }\n\n    while (stack.length > 0) {\n      const tile = stack.pop();\n\n      for (const child of tile.children) {\n        stack.push(child);\n      }\n\n      this._destroyTile(tile);\n    }\n\n    this.root = null;\n  }\n\n  _destroySubtree(tile) {\n    const root = tile;\n    const stack = [];\n    stack.push(root);\n\n    while (stack.length > 0) {\n      tile = stack.pop();\n\n      for (const child of tile.children) {\n        stack.push(child);\n      }\n\n      if (tile !== root) {\n        this._destroyTile(tile);\n      }\n    }\n\n    root.children = [];\n  }\n\n  _destroyTile(tile) {\n    this._cache.unloadTile(this, tile);\n\n    this._unloadTile(tile);\n\n    tile.destroy();\n  }\n\n  _initializeTiles3DTileset(tilesetJson) {\n    this.asset = tilesetJson.asset;\n\n    if (!this.asset) {\n      throw new Error('Tileset must have an asset property.');\n    }\n\n    if (this.asset.version !== '0.0' && this.asset.version !== '1.0') {\n      throw new Error('The tileset must be 3D Tiles version 0.0 or 1.0.');\n    }\n\n    if ('tilesetVersion' in this.asset) {\n      this._queryParams.v = this.asset.tilesetVersion;\n    }\n\n    this.credits = {\n      attributions: this.options.attributions || []\n    };\n    this.description = this.options.description || '';\n    this.properties = tilesetJson.properties;\n    this.geometricError = tilesetJson.geometricError;\n    this._extensionsUsed = tilesetJson.extensionsUsed;\n    this.extras = tilesetJson.extras;\n  }\n\n  _initializeI3STileset() {\n    if (this.loadOptions.i3s && 'token' in this.loadOptions.i3s) {\n      this._queryParams.token = this.loadOptions.i3s.token;\n    }\n  }\n\n}\n\nfunction getQueryParamString(queryParams) {\n  const queryParamStrings = [];\n\n  for (const key of Object.keys(queryParams)) {\n    queryParamStrings.push(\"\".concat(key, \"=\").concat(queryParams[key]));\n  }\n\n  switch (queryParamStrings.length) {\n    case 0:\n      return '';\n\n    case 1:\n      return \"?\".concat(queryParamStrings[0]);\n\n    default:\n      return \"?\".concat(queryParamStrings.join('&'));\n  }\n}\n//# sourceMappingURL=tileset-3d.js.map","import { Ellipsoid } from '@math.gl/geospatial';\nimport { Matrix4, Vector3 } from '@math.gl/core';\nimport { assert } from '@loaders.gl/loader-utils';\nexport function calculateTransformProps(tileHeader, tile) {\n  assert(tileHeader);\n  assert(tile);\n  const {\n    rtcCenter,\n    gltfUpAxis\n  } = tile;\n  const {\n    computedTransform,\n    boundingVolume: {\n      center\n    }\n  } = tileHeader;\n  let modelMatrix = new Matrix4(computedTransform);\n\n  if (rtcCenter) {\n    modelMatrix.translate(rtcCenter);\n  }\n\n  switch (gltfUpAxis) {\n    case 'Z':\n      break;\n\n    case 'Y':\n      const rotationY = new Matrix4().rotateX(Math.PI / 2);\n      modelMatrix = modelMatrix.multiplyRight(rotationY);\n      break;\n\n    case 'X':\n      const rotationX = new Matrix4().rotateY(-Math.PI / 2);\n      modelMatrix = modelMatrix.multiplyRight(rotationX);\n      break;\n\n    default:\n      break;\n  }\n\n  if (tile.isQuantized) {\n    modelMatrix.translate(tile.quantizedVolumeOffset).scale(tile.quantizedVolumeScale);\n  }\n\n  const cartesianOrigin = new Vector3(center);\n  tile.cartesianModelMatrix = modelMatrix;\n  tile.cartesianOrigin = cartesianOrigin;\n  const cartographicOrigin = Ellipsoid.WGS84.cartesianToCartographic(cartesianOrigin, new Vector3());\n  const fromFixedFrameMatrix = Ellipsoid.WGS84.eastNorthUpToFixedFrame(cartesianOrigin);\n  const toFixedFrameMatrix = fromFixedFrameMatrix.invert();\n  tile.cartographicModelMatrix = toFixedFrameMatrix.multiplyRight(modelMatrix);\n  tile.cartographicOrigin = cartographicOrigin;\n\n  if (!tile.coordinateSystem) {\n    tile.modelMatrix = tile.cartographicModelMatrix;\n  }\n}\n//# sourceMappingURL=transform-utils.js.map","export const VERSION = typeof \"3.2.10\" !== 'undefined' ? \"3.2.10\" : 'latest';\n//# sourceMappingURL=version.js.map","export const TILE3D_TYPE = {\n  COMPOSITE: 'cmpt',\n  POINT_CLOUD: 'pnts',\n  BATCHED_3D_MODEL: 'b3dm',\n  INSTANCED_3D_MODEL: 'i3dm',\n  GEOMETRY: 'geom',\n  VECTOR: 'vect',\n  GLTF: 'glTF'\n};\nexport const TILE3D_TYPES = Object.keys(TILE3D_TYPE);\nexport const MAGIC_ARRAY = {\n  BATCHED_MODEL: [98, 51, 100, 109],\n  INSTANCED_MODEL: [105, 51, 100, 109],\n  POINT_CLOUD: [112, 110, 116, 115],\n  COMPOSITE: [99, 109, 112, 116]\n};\nexport const TILE3D_OPTIMIZATION_HINT = {\n  NOT_COMPUTED: -1,\n  USE_OPTIMIZATION: 1,\n  SKIP_OPTIMIZATION: 0\n};\n//# sourceMappingURL=constants.js.map","import { assert } from '@loaders.gl/loader-utils';\nexport function getStringFromArrayBuffer(arrayBuffer, byteOffset, byteLength) {\n  assert(arrayBuffer instanceof ArrayBuffer);\n  const textDecoder = new TextDecoder('utf8');\n  const typedArray = new Uint8Array(arrayBuffer, byteOffset, byteLength);\n  const string = textDecoder.decode(typedArray);\n  return string;\n}\nexport function getStringFromTypedArray(typedArray) {\n  assert(ArrayBuffer.isView(typedArray));\n  const textDecoder = new TextDecoder('utf8');\n  const string = textDecoder.decode(typedArray);\n  return string;\n}\nexport function getMagicString(arrayBuffer, byteOffset = 0) {\n  const dataView = new DataView(arrayBuffer);\n  return \"\".concat(String.fromCharCode(dataView.getUint8(byteOffset + 0))).concat(String.fromCharCode(dataView.getUint8(byteOffset + 1))).concat(String.fromCharCode(dataView.getUint8(byteOffset + 2))).concat(String.fromCharCode(dataView.getUint8(byteOffset + 3)));\n}\n//# sourceMappingURL=parse-utils.js.map","export const GL_PRIMITIVE = {\n  POINTS: 0x0000,\n  LINES: 0x0001,\n  TRIANGLES: 0x0004\n};\nexport const GL_PRIMITIVE_MODE = {\n  POINTS: 0x0000,\n  LINES: 0x0001,\n  LINE_LOOP: 0x0002,\n  LINE_STRIP: 0x0003,\n  TRIANGLES: 0x0004,\n  TRIANGLE_STRIP: 0x0005,\n  TRIANGLE_FAN: 0x0006\n};\nexport const GL_TYPE = {\n  BYTE: 5120,\n  UNSIGNED_BYTE: 5121,\n  SHORT: 5122,\n  UNSIGNED_SHORT: 5123,\n  INT: 5124,\n  UNSIGNED_INT: 5125,\n  FLOAT: 5126,\n  DOUBLE: 5130\n};\nexport const GL = { ...GL_PRIMITIVE_MODE,\n  ...GL_TYPE\n};\n//# sourceMappingURL=constants.js.map","import { GL_TYPE as GL } from '../constants';\nconst GL_TYPE_TO_ARRAY_TYPE = {\n  [GL.DOUBLE]: Float64Array,\n  [GL.FLOAT]: Float32Array,\n  [GL.UNSIGNED_SHORT]: Uint16Array,\n  [GL.UNSIGNED_INT]: Uint32Array,\n  [GL.UNSIGNED_BYTE]: Uint8Array,\n  [GL.BYTE]: Int8Array,\n  [GL.SHORT]: Int16Array,\n  [GL.INT]: Int32Array\n};\nconst NAME_TO_GL_TYPE = {\n  DOUBLE: GL.DOUBLE,\n  FLOAT: GL.FLOAT,\n  UNSIGNED_SHORT: GL.UNSIGNED_SHORT,\n  UNSIGNED_INT: GL.UNSIGNED_INT,\n  UNSIGNED_BYTE: GL.UNSIGNED_BYTE,\n  BYTE: GL.BYTE,\n  SHORT: GL.SHORT,\n  INT: GL.INT\n};\nconst ERR_TYPE_CONVERSION = 'Failed to convert GL type';\nexport default class GLType {\n  static fromTypedArray(arrayOrType) {\n    arrayOrType = ArrayBuffer.isView(arrayOrType) ? arrayOrType.constructor : arrayOrType;\n\n    for (const glType in GL_TYPE_TO_ARRAY_TYPE) {\n      const ArrayType = GL_TYPE_TO_ARRAY_TYPE[glType];\n\n      if (ArrayType === arrayOrType) {\n        return glType;\n      }\n    }\n\n    throw new Error(ERR_TYPE_CONVERSION);\n  }\n\n  static fromName(name) {\n    const glType = NAME_TO_GL_TYPE[name];\n\n    if (!glType) {\n      throw new Error(ERR_TYPE_CONVERSION);\n    }\n\n    return glType;\n  }\n\n  static getArrayType(glType) {\n    switch (glType) {\n      case GL.UNSIGNED_SHORT_5_6_5:\n      case GL.UNSIGNED_SHORT_4_4_4_4:\n      case GL.UNSIGNED_SHORT_5_5_5_1:\n        return Uint16Array;\n\n      default:\n        const ArrayType = GL_TYPE_TO_ARRAY_TYPE[glType];\n\n        if (!ArrayType) {\n          throw new Error(ERR_TYPE_CONVERSION);\n        }\n\n        return ArrayType;\n    }\n  }\n\n  static getByteSize(glType) {\n    const ArrayType = GLType.getArrayType(glType);\n    return ArrayType.BYTES_PER_ELEMENT;\n  }\n\n  static validate(glType) {\n    return Boolean(GLType.getArrayType(glType));\n  }\n\n  static createTypedArray(glType, buffer, byteOffset = 0, length) {\n    if (length === undefined) {\n      length = (buffer.byteLength - byteOffset) / GLType.getByteSize(glType);\n    }\n\n    const ArrayType = GLType.getArrayType(glType);\n    return new ArrayType(buffer, byteOffset, length);\n  }\n\n}\n//# sourceMappingURL=gl-type.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { GL, GLType } from '@loaders.gl/math';\nexport default class Tile3DFeatureTable {\n  constructor(featureTableJson, featureTableBinary) {\n    _defineProperty(this, \"json\", void 0);\n\n    _defineProperty(this, \"buffer\", void 0);\n\n    _defineProperty(this, \"featuresLength\", 0);\n\n    _defineProperty(this, \"_cachedTypedArrays\", {});\n\n    this.json = featureTableJson;\n    this.buffer = featureTableBinary;\n  }\n\n  getExtension(extensionName) {\n    return this.json.extensions && this.json.extensions[extensionName];\n  }\n\n  hasProperty(propertyName) {\n    return Boolean(this.json[propertyName]);\n  }\n\n  getGlobalProperty(propertyName, componentType = GL.UNSIGNED_INT, componentLength = 1) {\n    const jsonValue = this.json[propertyName];\n\n    if (jsonValue && Number.isFinite(jsonValue.byteOffset)) {\n      return this._getTypedArrayFromBinary(propertyName, componentType, componentLength, 1, jsonValue.byteOffset);\n    }\n\n    return jsonValue;\n  }\n\n  getPropertyArray(propertyName, componentType, componentLength) {\n    const jsonValue = this.json[propertyName];\n\n    if (jsonValue && Number.isFinite(jsonValue.byteOffset)) {\n      if ('componentType' in jsonValue) {\n        componentType = GLType.fromName(jsonValue.componentType);\n      }\n\n      return this._getTypedArrayFromBinary(propertyName, componentType, componentLength, this.featuresLength, jsonValue.byteOffset);\n    }\n\n    return this._getTypedArrayFromArray(propertyName, componentType, jsonValue);\n  }\n\n  getProperty(propertyName, componentType, componentLength, featureId, result) {\n    const jsonValue = this.json[propertyName];\n\n    if (!jsonValue) {\n      return jsonValue;\n    }\n\n    const typedArray = this.getPropertyArray(propertyName, componentType, componentLength);\n\n    if (componentLength === 1) {\n      return typedArray[featureId];\n    }\n\n    for (let i = 0; i < componentLength; ++i) {\n      result[i] = typedArray[componentLength * featureId + i];\n    }\n\n    return result;\n  }\n\n  _getTypedArrayFromBinary(propertyName, componentType, componentLength, count, byteOffset) {\n    const cachedTypedArrays = this._cachedTypedArrays;\n    let typedArray = cachedTypedArrays[propertyName];\n\n    if (!typedArray) {\n      typedArray = GLType.createTypedArray(componentType, this.buffer.buffer, this.buffer.byteOffset + byteOffset, count * componentLength);\n      cachedTypedArrays[propertyName] = typedArray;\n    }\n\n    return typedArray;\n  }\n\n  _getTypedArrayFromArray(propertyName, componentType, array) {\n    const cachedTypedArrays = this._cachedTypedArrays;\n    let typedArray = cachedTypedArrays[propertyName];\n\n    if (!typedArray) {\n      typedArray = GLType.createTypedArray(componentType, array);\n      cachedTypedArrays[propertyName] = typedArray;\n    }\n\n    return typedArray;\n  }\n\n}\n//# sourceMappingURL=tile-3d-feature-table.js.map","import { GLType } from '@loaders.gl/math';\nimport { assert } from '@loaders.gl/loader-utils';\nconst COMPONENTS_PER_ATTRIBUTE = {\n  SCALAR: 1,\n  VEC2: 2,\n  VEC3: 3,\n  VEC4: 4,\n  MAT2: 4,\n  MAT3: 9,\n  MAT4: 16\n};\nconst UNPACKER = {\n  SCALAR: (values, i) => values[i],\n  VEC2: (values, i) => [values[2 * i + 0], values[2 * i + 1]],\n  VEC3: (values, i) => [values[3 * i + 0], values[3 * i + 1], values[3 * i + 2]],\n  VEC4: (values, i) => [values[4 * i + 0], values[4 * i + 1], values[4 * i + 2], values[4 * i + 3]],\n  MAT2: (values, i) => [values[4 * i + 0], values[4 * i + 1], values[4 * i + 2], values[4 * i + 3]],\n  MAT3: (values, i) => [values[9 * i + 0], values[9 * i + 1], values[9 * i + 2], values[9 * i + 3], values[9 * i + 4], values[9 * i + 5], values[9 * i + 6], values[9 * i + 7], values[9 * i + 8]],\n  MAT4: (values, i) => [values[16 * i + 0], values[16 * i + 1], values[16 * i + 2], values[16 * i + 3], values[16 * i + 4], values[16 * i + 5], values[16 * i + 6], values[16 * i + 7], values[16 * i + 8], values[16 * i + 9], values[16 * i + 10], values[16 * i + 11], values[16 * i + 12], values[16 * i + 13], values[16 * i + 14], values[16 * i + 15]]\n};\nconst PACKER = {\n  SCALAR: (x, values, i) => {\n    values[i] = x;\n  },\n  VEC2: (x, values, i) => {\n    values[2 * i + 0] = x[0];\n    values[2 * i + 1] = x[1];\n  },\n  VEC3: (x, values, i) => {\n    values[3 * i + 0] = x[0];\n    values[3 * i + 1] = x[1];\n    values[3 * i + 2] = x[2];\n  },\n  VEC4: (x, values, i) => {\n    values[4 * i + 0] = x[0];\n    values[4 * i + 1] = x[1];\n    values[4 * i + 2] = x[2];\n    values[4 * i + 3] = x[3];\n  },\n  MAT2: (x, values, i) => {\n    values[4 * i + 0] = x[0];\n    values[4 * i + 1] = x[1];\n    values[4 * i + 2] = x[2];\n    values[4 * i + 3] = x[3];\n  },\n  MAT3: (x, values, i) => {\n    values[9 * i + 0] = x[0];\n    values[9 * i + 1] = x[1];\n    values[9 * i + 2] = x[2];\n    values[9 * i + 3] = x[3];\n    values[9 * i + 4] = x[4];\n    values[9 * i + 5] = x[5];\n    values[9 * i + 6] = x[6];\n    values[9 * i + 7] = x[7];\n    values[9 * i + 8] = x[8];\n    values[9 * i + 9] = x[9];\n  },\n  MAT4: (x, values, i) => {\n    values[16 * i + 0] = x[0];\n    values[16 * i + 1] = x[1];\n    values[16 * i + 2] = x[2];\n    values[16 * i + 3] = x[3];\n    values[16 * i + 4] = x[4];\n    values[16 * i + 5] = x[5];\n    values[16 * i + 6] = x[6];\n    values[16 * i + 7] = x[7];\n    values[16 * i + 8] = x[8];\n    values[16 * i + 9] = x[9];\n    values[16 * i + 10] = x[10];\n    values[16 * i + 11] = x[11];\n    values[16 * i + 12] = x[12];\n    values[16 * i + 13] = x[13];\n    values[16 * i + 14] = x[14];\n    values[16 * i + 15] = x[15];\n  }\n};\nexport function createTypedArrayFromAccessor(tile3DAccessor, buffer, byteOffset, length) {\n  const {\n    componentType\n  } = tile3DAccessor;\n  assert(tile3DAccessor.componentType);\n  const type = typeof componentType === 'string' ? GLType.fromName(componentType) : componentType;\n  const size = COMPONENTS_PER_ATTRIBUTE[tile3DAccessor.type];\n  const unpacker = UNPACKER[tile3DAccessor.type];\n  const packer = PACKER[tile3DAccessor.type];\n  byteOffset += tile3DAccessor.byteOffset;\n  const values = GLType.createTypedArray(type, buffer, byteOffset, size * length);\n  return {\n    values,\n    type,\n    size,\n    unpacker,\n    packer\n  };\n}\n//# sourceMappingURL=tile-3d-accessor-utils.js.map","const defined = x => x !== undefined;\n\nexport function initializeHierarchy(batchTable, jsonHeader, binaryBody) {\n  if (!jsonHeader) {\n    return null;\n  }\n\n  let hierarchy = batchTable.getExtension('3DTILES_batch_table_hierarchy');\n  const legacyHierarchy = jsonHeader.HIERARCHY;\n\n  if (legacyHierarchy) {\n    console.warn('3D Tile Parser: HIERARCHY is deprecated. Use 3DTILES_batch_table_hierarchy.');\n    jsonHeader.extensions = jsonHeader.extensions || {};\n    jsonHeader.extensions['3DTILES_batch_table_hierarchy'] = legacyHierarchy;\n    hierarchy = legacyHierarchy;\n  }\n\n  if (!hierarchy) {\n    return null;\n  }\n\n  return initializeHierarchyValues(hierarchy, binaryBody);\n}\n\nfunction initializeHierarchyValues(hierarchyJson, binaryBody) {\n  let i;\n  let classId;\n  let binaryAccessor;\n  const instancesLength = hierarchyJson.instancesLength;\n  const classes = hierarchyJson.classes;\n  let classIds = hierarchyJson.classIds;\n  let parentCounts = hierarchyJson.parentCounts;\n  let parentIds = hierarchyJson.parentIds;\n  let parentIdsLength = instancesLength;\n\n  if (defined(classIds.byteOffset)) {\n    classIds.componentType = defaultValue(classIds.componentType, GL.UNSIGNED_SHORT);\n    classIds.type = AttributeType.SCALAR;\n    binaryAccessor = getBinaryAccessor(classIds);\n    classIds = binaryAccessor.createArrayBufferView(binaryBody.buffer, binaryBody.byteOffset + classIds.byteOffset, instancesLength);\n  }\n\n  let parentIndexes;\n\n  if (defined(parentCounts)) {\n    if (defined(parentCounts.byteOffset)) {\n      parentCounts.componentType = defaultValue(parentCounts.componentType, GL.UNSIGNED_SHORT);\n      parentCounts.type = AttributeType.SCALAR;\n      binaryAccessor = getBinaryAccessor(parentCounts);\n      parentCounts = binaryAccessor.createArrayBufferView(binaryBody.buffer, binaryBody.byteOffset + parentCounts.byteOffset, instancesLength);\n    }\n\n    parentIndexes = new Uint16Array(instancesLength);\n    parentIdsLength = 0;\n\n    for (i = 0; i < instancesLength; ++i) {\n      parentIndexes[i] = parentIdsLength;\n      parentIdsLength += parentCounts[i];\n    }\n  }\n\n  if (defined(parentIds) && defined(parentIds.byteOffset)) {\n    parentIds.componentType = defaultValue(parentIds.componentType, GL.UNSIGNED_SHORT);\n    parentIds.type = AttributeType.SCALAR;\n    binaryAccessor = getBinaryAccessor(parentIds);\n    parentIds = binaryAccessor.createArrayBufferView(binaryBody.buffer, binaryBody.byteOffset + parentIds.byteOffset, parentIdsLength);\n  }\n\n  const classesLength = classes.length;\n\n  for (i = 0; i < classesLength; ++i) {\n    const classInstancesLength = classes[i].length;\n    const properties = classes[i].instances;\n    const binaryProperties = getBinaryProperties(classInstancesLength, properties, binaryBody);\n    classes[i].instances = combine(binaryProperties, properties);\n  }\n\n  const classCounts = new Array(classesLength).fill(0);\n  const classIndexes = new Uint16Array(instancesLength);\n\n  for (i = 0; i < instancesLength; ++i) {\n    classId = classIds[i];\n    classIndexes[i] = classCounts[classId];\n    ++classCounts[classId];\n  }\n\n  const hierarchy = {\n    classes,\n    classIds,\n    classIndexes,\n    parentCounts,\n    parentIndexes,\n    parentIds\n  };\n  validateHierarchy(hierarchy);\n  return hierarchy;\n}\n\nexport function traverseHierarchy(hierarchy, instanceIndex, endConditionCallback) {\n  if (!hierarchy) {\n    return;\n  }\n\n  const parentCounts = hierarchy.parentCounts;\n  const parentIds = hierarchy.parentIds;\n\n  if (parentIds) {\n    return endConditionCallback(hierarchy, instanceIndex);\n  }\n\n  if (parentCounts > 0) {\n    return traverseHierarchyMultipleParents(hierarchy, instanceIndex, endConditionCallback);\n  }\n\n  return traverseHierarchySingleParent(hierarchy, instanceIndex, endConditionCallback);\n}\n\nfunction traverseHierarchyMultipleParents(hierarchy, instanceIndex, endConditionCallback) {\n  const classIds = hierarchy.classIds;\n  const parentCounts = hierarchy.parentCounts;\n  const parentIds = hierarchy.parentIds;\n  const parentIndexes = hierarchy.parentIndexes;\n  const instancesLength = classIds.length;\n  const visited = scratchVisited;\n  visited.length = Math.max(visited.length, instancesLength);\n  const visitedMarker = ++marker;\n  const stack = scratchStack;\n  stack.length = 0;\n  stack.push(instanceIndex);\n\n  while (stack.length > 0) {\n    instanceIndex = stack.pop();\n\n    if (visited[instanceIndex] === visitedMarker) {\n      continue;\n    }\n\n    visited[instanceIndex] = visitedMarker;\n    const result = endConditionCallback(hierarchy, instanceIndex);\n\n    if (defined(result)) {\n      return result;\n    }\n\n    const parentCount = parentCounts[instanceIndex];\n    const parentIndex = parentIndexes[instanceIndex];\n\n    for (let i = 0; i < parentCount; ++i) {\n      const parentId = parentIds[parentIndex + i];\n\n      if (parentId !== instanceIndex) {\n        stack.push(parentId);\n      }\n    }\n  }\n\n  return null;\n}\n\nfunction traverseHierarchySingleParent(hierarchy, instanceIndex, endConditionCallback) {\n  let hasParent = true;\n\n  while (hasParent) {\n    const result = endConditionCallback(hierarchy, instanceIndex);\n\n    if (defined(result)) {\n      return result;\n    }\n\n    const parentId = hierarchy.parentIds[instanceIndex];\n    hasParent = parentId !== instanceIndex;\n    instanceIndex = parentId;\n  }\n\n  throw new Error('traverseHierarchySingleParent');\n}\n\nfunction validateHierarchy(hierarchy) {\n  const scratchValidateStack = [];\n  const classIds = hierarchy.classIds;\n  const instancesLength = classIds.length;\n\n  for (let i = 0; i < instancesLength; ++i) {\n    validateInstance(hierarchy, i, stack);\n  }\n}\n\nfunction validateInstance(hierarchy, instanceIndex, stack) {\n  const parentCounts = hierarchy.parentCounts;\n  const parentIds = hierarchy.parentIds;\n  const parentIndexes = hierarchy.parentIndexes;\n  const classIds = hierarchy.classIds;\n  const instancesLength = classIds.length;\n\n  if (!defined(parentIds)) {\n    return;\n  }\n\n  assert(instanceIndex < instancesLength, \"Parent index \".concat(instanceIndex, \" exceeds the total number of instances: \").concat(instancesLength));\n  assert(stack.indexOf(instanceIndex) === -1, 'Circular dependency detected in the batch table hierarchy.');\n  stack.push(instanceIndex);\n  const parentCount = defined(parentCounts) ? parentCounts[instanceIndex] : 1;\n  const parentIndex = defined(parentCounts) ? parentIndexes[instanceIndex] : instanceIndex;\n\n  for (let i = 0; i < parentCount; ++i) {\n    const parentId = parentIds[parentIndex + i];\n\n    if (parentId !== instanceIndex) {\n      validateInstance(hierarchy, parentId, stack);\n    }\n  }\n\n  stack.pop(instanceIndex);\n}\n//# sourceMappingURL=tile-3d-batch-table-hierarchy.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { assert } from '@loaders.gl/loader-utils';\nimport { createTypedArrayFromAccessor } from './helpers/tile-3d-accessor-utils';\nimport { initializeHierarchy, traverseHierarchy } from './tile-3d-batch-table-hierarchy';\n\nfunction defined(x) {\n  return x !== undefined && x !== null;\n}\n\nconst clone = (x, y) => x;\n\nconst IGNORED_PROPERTY_FIELDS = {\n  HIERARCHY: true,\n  extensions: true,\n  extras: true\n};\nexport default class Tile3DBatchTableParser {\n  constructor(json, binary, featureCount, options = {}) {\n    var _this$json;\n\n    _defineProperty(this, \"json\", void 0);\n\n    _defineProperty(this, \"binary\", void 0);\n\n    _defineProperty(this, \"featureCount\", void 0);\n\n    _defineProperty(this, \"_extensions\", void 0);\n\n    _defineProperty(this, \"_properties\", void 0);\n\n    _defineProperty(this, \"_binaryProperties\", void 0);\n\n    _defineProperty(this, \"_hierarchy\", void 0);\n\n    assert(featureCount >= 0);\n    this.json = json || {};\n    this.binary = binary;\n    this.featureCount = featureCount;\n    this._extensions = ((_this$json = this.json) === null || _this$json === void 0 ? void 0 : _this$json.extensions) || {};\n    this._properties = {};\n\n    for (const propertyName in this.json) {\n      if (!IGNORED_PROPERTY_FIELDS[propertyName]) {\n        this._properties[propertyName] = this.json[propertyName];\n      }\n    }\n\n    this._binaryProperties = this._initializeBinaryProperties();\n\n    if (options['3DTILES_batch_table_hierarchy']) {\n      this._hierarchy = initializeHierarchy(this, this.json, this.binary);\n    }\n  }\n\n  getExtension(extensionName) {\n    return this.json && this.json.extensions && this.json.extensions[extensionName];\n  }\n\n  memorySizeInBytes() {\n    return 0;\n  }\n\n  isClass(batchId, className) {\n    this._checkBatchId(batchId);\n\n    assert(typeof className === 'string', className);\n\n    if (this._hierarchy) {\n      const result = traverseHierarchy(this._hierarchy, batchId, (hierarchy, instanceIndex) => {\n        const classId = hierarchy.classIds[instanceIndex];\n        const instanceClass = hierarchy.classes[classId];\n        return instanceClass.name === className;\n      });\n      return defined(result);\n    }\n\n    return false;\n  }\n\n  isExactClass(batchId, className) {\n    assert(typeof className === 'string', className);\n    return this.getExactClassName(batchId) === className;\n  }\n\n  getExactClassName(batchId) {\n    this._checkBatchId(batchId);\n\n    if (this._hierarchy) {\n      const classId = this._hierarchy.classIds[batchId];\n      const instanceClass = this._hierarchy.classes[classId];\n      return instanceClass.name;\n    }\n\n    return undefined;\n  }\n\n  hasProperty(batchId, name) {\n    this._checkBatchId(batchId);\n\n    assert(typeof name === 'string', name);\n    return defined(this._properties[name]) || this._hasPropertyInHierarchy(batchId, name);\n  }\n\n  getPropertyNames(batchId, results) {\n    this._checkBatchId(batchId);\n\n    results = defined(results) ? results : [];\n    results.length = 0;\n    const propertyNames = Object.keys(this._properties);\n    results.push(...propertyNames);\n\n    if (this._hierarchy) {\n      this._getPropertyNamesInHierarchy(batchId, results);\n    }\n\n    return results;\n  }\n\n  getProperty(batchId, name) {\n    this._checkBatchId(batchId);\n\n    assert(typeof name === 'string', name);\n\n    if (this._binaryProperties) {\n      const binaryProperty = this._binaryProperties[name];\n\n      if (defined(binaryProperty)) {\n        return this._getBinaryProperty(binaryProperty, batchId);\n      }\n    }\n\n    const propertyValues = this._properties[name];\n\n    if (defined(propertyValues)) {\n      return clone(propertyValues[batchId], true);\n    }\n\n    if (this._hierarchy) {\n      const hierarchyProperty = this._getHierarchyProperty(batchId, name);\n\n      if (defined(hierarchyProperty)) {\n        return hierarchyProperty;\n      }\n    }\n\n    return undefined;\n  }\n\n  setProperty(batchId, name, value) {\n    const featureCount = this.featureCount;\n\n    this._checkBatchId(batchId);\n\n    assert(typeof name === 'string', name);\n\n    if (this._binaryProperties) {\n      const binaryProperty = this._binaryProperties[name];\n\n      if (binaryProperty) {\n        this._setBinaryProperty(binaryProperty, batchId, value);\n\n        return;\n      }\n    }\n\n    if (this._hierarchy) {\n      if (this._setHierarchyProperty(this, batchId, name, value)) {\n        return;\n      }\n    }\n\n    let propertyValues = this._properties[name];\n\n    if (!defined(propertyValues)) {\n      this._properties[name] = new Array(featureCount);\n      propertyValues = this._properties[name];\n    }\n\n    propertyValues[batchId] = clone(value, true);\n  }\n\n  _checkBatchId(batchId) {\n    const valid = batchId >= 0 && batchId < this.featureCount;\n\n    if (!valid) {\n      throw new Error('batchId not in range [0, featureCount - 1].');\n    }\n  }\n\n  _getBinaryProperty(binaryProperty, index) {\n    return binaryProperty.unpack(binaryProperty.typedArray, index);\n  }\n\n  _setBinaryProperty(binaryProperty, index, value) {\n    binaryProperty.pack(value, binaryProperty.typedArray, index);\n  }\n\n  _initializeBinaryProperties() {\n    let binaryProperties = null;\n\n    for (const name in this._properties) {\n      const property = this._properties[name];\n\n      const binaryProperty = this._initializeBinaryProperty(name, property);\n\n      if (binaryProperty) {\n        binaryProperties = binaryProperties || {};\n        binaryProperties[name] = binaryProperty;\n      }\n    }\n\n    return binaryProperties;\n  }\n\n  _initializeBinaryProperty(name, property) {\n    if ('byteOffset' in property) {\n      const tile3DAccessor = property;\n      assert(this.binary, \"Property \".concat(name, \" requires a batch table binary.\"));\n      assert(tile3DAccessor.type, \"Property \".concat(name, \" requires a type.\"));\n      const accessor = createTypedArrayFromAccessor(tile3DAccessor, this.binary.buffer, this.binary.byteOffset | 0, this.featureCount);\n      return {\n        typedArray: accessor.values,\n        componentCount: accessor.size,\n        unpack: accessor.unpacker,\n        pack: accessor.packer\n      };\n    }\n\n    return null;\n  }\n\n  _hasPropertyInHierarchy(batchId, name) {\n    if (!this._hierarchy) {\n      return false;\n    }\n\n    const result = traverseHierarchy(this._hierarchy, batchId, (hierarchy, instanceIndex) => {\n      const classId = hierarchy.classIds[instanceIndex];\n      const instances = hierarchy.classes[classId].instances;\n      return defined(instances[name]);\n    });\n    return defined(result);\n  }\n\n  _getPropertyNamesInHierarchy(batchId, results) {\n    traverseHierarchy(this._hierarchy, batchId, (hierarchy, instanceIndex) => {\n      const classId = hierarchy.classIds[instanceIndex];\n      const instances = hierarchy.classes[classId].instances;\n\n      for (const name in instances) {\n        if (instances.hasOwnProperty(name)) {\n          if (results.indexOf(name) === -1) {\n            results.push(name);\n          }\n        }\n      }\n    });\n  }\n\n  _getHierarchyProperty(batchId, name) {\n    return traverseHierarchy(this._hierarchy, batchId, (hierarchy, instanceIndex) => {\n      const classId = hierarchy.classIds[instanceIndex];\n      const instanceClass = hierarchy.classes[classId];\n      const indexInClass = hierarchy.classIndexes[instanceIndex];\n      const propertyValues = instanceClass.instances[name];\n\n      if (defined(propertyValues)) {\n        if (defined(propertyValues.typedArray)) {\n          return this._getBinaryProperty(propertyValues, indexInClass);\n        }\n\n        return clone(propertyValues[indexInClass], true);\n      }\n\n      return null;\n    });\n  }\n\n  _setHierarchyProperty(batchTable, batchId, name, value) {\n    const result = traverseHierarchy(this._hierarchy, batchId, (hierarchy, instanceIndex) => {\n      const classId = hierarchy.classIds[instanceIndex];\n      const instanceClass = hierarchy.classes[classId];\n      const indexInClass = hierarchy.classIndexes[instanceIndex];\n      const propertyValues = instanceClass.instances[name];\n\n      if (defined(propertyValues)) {\n        assert(instanceIndex === batchId, \"Inherited property \\\"\".concat(name, \"\\\" is read-only.\"));\n\n        if (defined(propertyValues.typedArray)) {\n          this._setBinaryProperty(propertyValues, indexInClass, value);\n        } else {\n          propertyValues[indexInClass] = clone(value, true);\n        }\n\n        return true;\n      }\n\n      return false;\n    });\n    return defined(result);\n  }\n\n}\n//# sourceMappingURL=tile-3d-batch-table.js.map","const SIZEOF_UINT32 = 4;\nexport function parse3DTileHeaderSync(tile, arrayBuffer, byteOffset = 0) {\n  const view = new DataView(arrayBuffer);\n  tile.magic = view.getUint32(byteOffset, true);\n  byteOffset += SIZEOF_UINT32;\n  tile.version = view.getUint32(byteOffset, true);\n  byteOffset += SIZEOF_UINT32;\n  tile.byteLength = view.getUint32(byteOffset, true);\n  byteOffset += SIZEOF_UINT32;\n\n  if (tile.version !== 1) {\n    throw new Error(\"3D Tile Version \".concat(tile.version, \" not supported\"));\n  }\n\n  return byteOffset;\n}\n//# sourceMappingURL=parse-3d-tile-header.js.map","import { getStringFromArrayBuffer } from './parse-utils';\nconst SIZEOF_UINT32 = 4;\nconst DEPRECATION_WARNING = 'b3dm tile in legacy format.';\nexport function parse3DTileTablesHeaderSync(tile, arrayBuffer, byteOffset) {\n  const view = new DataView(arrayBuffer);\n  let batchLength;\n  tile.header = tile.header || {};\n  let featureTableJsonByteLength = view.getUint32(byteOffset, true);\n  byteOffset += SIZEOF_UINT32;\n  let featureTableBinaryByteLength = view.getUint32(byteOffset, true);\n  byteOffset += SIZEOF_UINT32;\n  let batchTableJsonByteLength = view.getUint32(byteOffset, true);\n  byteOffset += SIZEOF_UINT32;\n  let batchTableBinaryByteLength = view.getUint32(byteOffset, true);\n  byteOffset += SIZEOF_UINT32;\n\n  if (batchTableJsonByteLength >= 570425344) {\n    byteOffset -= SIZEOF_UINT32 * 2;\n    batchLength = featureTableJsonByteLength;\n    batchTableJsonByteLength = featureTableBinaryByteLength;\n    batchTableBinaryByteLength = 0;\n    featureTableJsonByteLength = 0;\n    featureTableBinaryByteLength = 0;\n    console.warn(DEPRECATION_WARNING);\n  } else if (batchTableBinaryByteLength >= 570425344) {\n    byteOffset -= SIZEOF_UINT32;\n    batchLength = batchTableJsonByteLength;\n    batchTableJsonByteLength = featureTableJsonByteLength;\n    batchTableBinaryByteLength = featureTableBinaryByteLength;\n    featureTableJsonByteLength = 0;\n    featureTableBinaryByteLength = 0;\n    console.warn(DEPRECATION_WARNING);\n  }\n\n  tile.header.featureTableJsonByteLength = featureTableJsonByteLength;\n  tile.header.featureTableBinaryByteLength = featureTableBinaryByteLength;\n  tile.header.batchTableJsonByteLength = batchTableJsonByteLength;\n  tile.header.batchTableBinaryByteLength = batchTableBinaryByteLength;\n  tile.header.batchLength = batchLength;\n  return byteOffset;\n}\nexport function parse3DTileTablesSync(tile, arrayBuffer, byteOffset, options) {\n  byteOffset = parse3DTileFeatureTable(tile, arrayBuffer, byteOffset, options);\n  byteOffset = parse3DTileBatchTable(tile, arrayBuffer, byteOffset, options);\n  return byteOffset;\n}\n\nfunction parse3DTileFeatureTable(tile, arrayBuffer, byteOffset, options) {\n  const {\n    featureTableJsonByteLength,\n    featureTableBinaryByteLength,\n    batchLength\n  } = tile.header;\n  tile.featureTableJson = {\n    BATCH_LENGTH: batchLength || 0\n  };\n\n  if (featureTableJsonByteLength > 0) {\n    const featureTableString = getStringFromArrayBuffer(arrayBuffer, byteOffset, featureTableJsonByteLength);\n    tile.featureTableJson = JSON.parse(featureTableString);\n  }\n\n  byteOffset += featureTableJsonByteLength;\n  tile.featureTableBinary = new Uint8Array(arrayBuffer, byteOffset, featureTableBinaryByteLength);\n  byteOffset += featureTableBinaryByteLength;\n  return byteOffset;\n}\n\nfunction parse3DTileBatchTable(tile, arrayBuffer, byteOffset, options) {\n  const {\n    batchTableJsonByteLength,\n    batchTableBinaryByteLength\n  } = tile.header;\n\n  if (batchTableJsonByteLength > 0) {\n    const batchTableString = getStringFromArrayBuffer(arrayBuffer, byteOffset, batchTableJsonByteLength);\n    tile.batchTableJson = JSON.parse(batchTableString);\n    byteOffset += batchTableJsonByteLength;\n\n    if (batchTableBinaryByteLength > 0) {\n      tile.batchTableBinary = new Uint8Array(arrayBuffer, byteOffset, batchTableBinaryByteLength);\n      tile.batchTableBinary = new Uint8Array(tile.batchTableBinary);\n      byteOffset += batchTableBinaryByteLength;\n    }\n  }\n\n  return byteOffset;\n}\n//# sourceMappingURL=parse-3d-tile-tables.js.map","export function decodeRGB565(rgb565, target = [0, 0, 0]) {\n  const r5 = rgb565 >> 11 & 31;\n  const g6 = rgb565 >> 5 & 63;\n  const b5 = rgb565 & 31;\n  target[0] = r5 << 3;\n  target[1] = g6 << 2;\n  target[2] = b5 << 3;\n  return target;\n}\nexport function encodeRGB565(rgb) {\n  const r5 = Math.floor(rgb[0] / 8) + 4;\n  const g6 = Math.floor(rgb[1] / 4) + 2;\n  const b5 = Math.floor(rgb[2] / 8) + 4;\n  return r5 + (g6 << 5) + (b5 << 11);\n}\n//# sourceMappingURL=rgb565.js.map","import { decodeRGB565, GL } from '@loaders.gl/math';\nexport function normalize3DTileColorAttribute(tile, colors, batchTable) {\n  if (!colors && (!tile || !tile.batchIds || !batchTable)) {\n    return null;\n  }\n\n  const {\n    batchIds,\n    isRGB565,\n    pointCount\n  } = tile;\n\n  if (batchIds && batchTable) {\n    const colorArray = new Uint8ClampedArray(pointCount * 3);\n\n    for (let i = 0; i < pointCount; i++) {\n      const batchId = batchIds[i];\n      const dimensions = batchTable.getProperty(batchId, 'dimensions');\n      const color = dimensions.map(d => d * 255);\n      colorArray[i * 3] = color[0];\n      colorArray[i * 3 + 1] = color[1];\n      colorArray[i * 3 + 2] = color[2];\n    }\n\n    return {\n      type: GL.UNSIGNED_BYTE,\n      value: colorArray,\n      size: 3,\n      normalized: true\n    };\n  }\n\n  if (isRGB565) {\n    const colorArray = new Uint8ClampedArray(pointCount * 3);\n\n    for (let i = 0; i < pointCount; i++) {\n      const color = decodeRGB565(colors[i]);\n      colorArray[i * 3] = color[0];\n      colorArray[i * 3 + 1] = color[1];\n      colorArray[i * 3 + 2] = color[2];\n    }\n\n    return {\n      type: GL.UNSIGNED_BYTE,\n      value: colorArray,\n      size: 3,\n      normalized: true\n    };\n  }\n\n  if (colors && colors.length === pointCount * 3) {\n    return {\n      type: GL.UNSIGNED_BYTE,\n      value: colors,\n      size: 3,\n      normalized: true\n    };\n  }\n\n  return {\n    type: GL.UNSIGNED_BYTE,\n    value: colors,\n    size: 4,\n    normalized: true\n  };\n}\n//# sourceMappingURL=normalize-3d-tile-colors.js.map","export function assert(condition, message) {\n  if (!condition) {\n    throw new Error(\"math.gl assertion failed. \".concat(message));\n  }\n}\n//# sourceMappingURL=assert.js.map","import { Vector2, Vector3, clamp, _MathUtils } from '@math.gl/core';\nimport { assert } from '../utils/assert';\nconst RIGHT_SHIFT = 1.0 / 256.0;\nconst LEFT_SHIFT = 256.0;\nconst scratchVector2 = new Vector2();\nconst scratchVector3 = new Vector3();\nconst scratchEncodeVector2 = new Vector2();\nconst octEncodeScratch = new Vector2();\nconst uint8ForceArray = new Uint8Array(1);\n\nfunction forceUint8(value) {\n  uint8ForceArray[0] = value;\n  return uint8ForceArray[0];\n}\n\nfunction fromSNorm(value, rangeMaximum = 255) {\n  return clamp(value, 0.0, rangeMaximum) / rangeMaximum * 2.0 - 1.0;\n}\n\nfunction toSNorm(value, rangeMaximum = 255) {\n  return Math.round((clamp(value, -1.0, 1.0) * 0.5 + 0.5) * rangeMaximum);\n}\n\nfunction signNotZero(value) {\n  return value < 0.0 ? -1.0 : 1.0;\n}\n\nexport function octEncodeInRange(vector, rangeMax, result) {\n  assert(vector);\n  assert(result);\n  const vector3 = scratchVector3.from(vector);\n  assert(Math.abs(vector3.magnitudeSquared() - 1.0) <= _MathUtils.EPSILON6);\n  result.x = vector.x / (Math.abs(vector.x) + Math.abs(vector.y) + Math.abs(vector.z));\n  result.y = vector.y / (Math.abs(vector.x) + Math.abs(vector.y) + Math.abs(vector.z));\n\n  if (vector.z < 0) {\n    const x = result.x;\n    const y = result.y;\n    result.x = (1.0 - Math.abs(y)) * signNotZero(x);\n    result.y = (1.0 - Math.abs(x)) * signNotZero(y);\n  }\n\n  result.x = toSNorm(result.x, rangeMax);\n  result.y = toSNorm(result.y, rangeMax);\n  return result;\n}\nexport function octEncode(vector, result) {\n  return octEncodeInRange(vector, 255, result);\n}\nexport function octEncodeToVector4(vector, result) {\n  octEncodeInRange(vector, 65535, octEncodeScratch);\n  result.x = forceUint8(octEncodeScratch.x * RIGHT_SHIFT);\n  result.y = forceUint8(octEncodeScratch.x);\n  result.z = forceUint8(octEncodeScratch.y * RIGHT_SHIFT);\n  result.w = forceUint8(octEncodeScratch.y);\n  return result;\n}\nexport function octDecodeInRange(x, y, rangeMax, result) {\n  assert(result);\n\n  if (x < 0 || x > rangeMax || y < 0 || y > rangeMax) {\n    throw new Error(\"x and y must be unsigned normalized integers between 0 and \".concat(rangeMax));\n  }\n\n  result.x = fromSNorm(x, rangeMax);\n  result.y = fromSNorm(y, rangeMax);\n  result.z = 1.0 - (Math.abs(result.x) + Math.abs(result.y));\n\n  if (result.z < 0.0) {\n    const oldVX = result.x;\n    result.x = (1.0 - Math.abs(result.y)) * signNotZero(oldVX);\n    result.y = (1.0 - Math.abs(oldVX)) * signNotZero(result.y);\n  }\n\n  return result.normalize();\n}\nexport function octDecode(x, y, result) {\n  return octDecodeInRange(x, y, 255, result);\n}\nexport function octDecodeFromVector4(encoded, result) {\n  assert(encoded);\n  assert(result);\n  const x = encoded.x;\n  const y = encoded.y;\n  const z = encoded.z;\n  const w = encoded.w;\n\n  if (x < 0 || x > 255 || y < 0 || y > 255 || z < 0 || z > 255 || w < 0 || w > 255) {\n    throw new Error('x, y, z, and w must be unsigned normalized integers between 0 and 255');\n  }\n\n  const xOct16 = x * LEFT_SHIFT + y;\n  const yOct16 = z * LEFT_SHIFT + w;\n  return octDecodeInRange(xOct16, yOct16, 65535, result);\n}\nexport function octPackFloat(encoded) {\n  const vector2 = scratchVector2.from(encoded);\n  return 256.0 * vector2.x + vector2.y;\n}\nexport function octEncodeFloat(vector) {\n  octEncode(vector, scratchEncodeVector2);\n  return octPackFloat(scratchEncodeVector2);\n}\nexport function octDecodeFloat(value, result) {\n  assert(Number.isFinite(value));\n  const temp = value / 256.0;\n  const x = Math.floor(temp);\n  const y = (temp - x) * 256.0;\n  return octDecode(x, y, result);\n}\nexport function octPack(v1, v2, v3, result) {\n  assert(v1);\n  assert(v2);\n  assert(v3);\n  assert(result);\n  const encoded1 = octEncodeFloat(v1);\n  const encoded2 = octEncodeFloat(v2);\n  const encoded3 = octEncode(v3, scratchEncodeVector2);\n  result.x = 65536.0 * encoded3.x + encoded1;\n  result.y = 65536.0 * encoded3.y + encoded2;\n  return result;\n}\nexport function octUnpack(packed, v1, v2, v3) {\n  let temp = packed.x / 65536.0;\n  const x = Math.floor(temp);\n  const encodedFloat1 = (temp - x) * 65536.0;\n  temp = packed.y / 65536.0;\n  const y = Math.floor(temp);\n  const encodedFloat2 = (temp - y) * 65536.0;\n  octDecodeFloat(encodedFloat1, v1);\n  octDecodeFloat(encodedFloat2, v2);\n  octDecode(x, y, v3);\n}\nexport function compressTextureCoordinates(textureCoordinates) {\n  const x = textureCoordinates.x * 4095.0 | 0;\n  const y = textureCoordinates.y * 4095.0 | 0;\n  return 4096.0 * x + y;\n}\nexport function decompressTextureCoordinates(compressed, result) {\n  const temp = compressed / 4096.0;\n  const xZeroTo4095 = Math.floor(temp);\n  result.x = xZeroTo4095 / 4095.0;\n  result.y = (compressed - xZeroTo4095 * 4096) / 4095;\n  return result;\n}\nexport function zigZagDeltaDecode(uBuffer, vBuffer, heightBuffer) {\n  assert(uBuffer);\n  assert(vBuffer);\n  assert(uBuffer.length === vBuffer.length);\n\n  if (heightBuffer) {\n    assert(uBuffer.length === heightBuffer.length);\n  }\n\n  function zigZagDecode(value) {\n    return value >> 1 ^ -(value & 1);\n  }\n\n  let u = 0;\n  let v = 0;\n  let height = 0;\n\n  for (let i = 0; i < uBuffer.length; ++i) {\n    u += zigZagDecode(uBuffer[i]);\n    v += zigZagDecode(vBuffer[i]);\n    uBuffer[i] = u;\n    vBuffer[i] = v;\n\n    if (heightBuffer) {\n      height += zigZagDecode(heightBuffer[i]);\n      heightBuffer[i] = height;\n    }\n  }\n}\n//# sourceMappingURL=attribute-compression.js.map","import { Vector3 } from '@math.gl/core';\nimport { GL, octDecode } from '@loaders.gl/math';\nconst scratchNormal = new Vector3();\nexport function normalize3DTileNormalAttribute(tile, normals) {\n  if (!normals) {\n    return null;\n  }\n\n  if (tile.isOctEncoded16P) {\n    const decodedArray = new Float32Array(tile.pointsLength * 3);\n\n    for (let i = 0; i < tile.pointsLength; i++) {\n      octDecode(normals[i * 2], normals[i * 2 + 1], scratchNormal);\n      scratchNormal.toArray(decodedArray, i * 3);\n    }\n\n    return {\n      type: GL.FLOAT,\n      size: 2,\n      value: decodedArray\n    };\n  }\n\n  return {\n    type: GL.FLOAT,\n    size: 2,\n    value: normals\n  };\n}\n//# sourceMappingURL=normalize-3d-tile-normals.js.map","import { Vector3 } from '@math.gl/core';\nimport { GL } from '@loaders.gl/math';\nexport function normalize3DTilePositionAttribute(tile, positions, options) {\n  if (!tile.isQuantized) {\n    return positions;\n  }\n\n  if (options['3d-tiles'] && options['3d-tiles'].decodeQuantizedPositions) {\n    tile.isQuantized = false;\n    return decodeQuantizedPositions(tile, positions);\n  }\n\n  return {\n    type: GL.UNSIGNED_SHORT,\n    value: positions,\n    size: 3,\n    normalized: true\n  };\n}\n\nfunction decodeQuantizedPositions(tile, positions) {\n  const scratchPosition = new Vector3();\n  const decodedArray = new Float32Array(tile.pointCount * 3);\n\n  for (let i = 0; i < tile.pointCount; i++) {\n    scratchPosition.set(positions[i * 3], positions[i * 3 + 1], positions[i * 3 + 2]).scale(1 / tile.quantizedRange).multiply(tile.quantizedVolumeScale).add(tile.quantizedVolumeOffset).toArray(decodedArray, i * 3);\n  }\n\n  return decodedArray;\n}\n//# sourceMappingURL=normalize-3d-tile-positions.js.map","import { DracoLoader } from '@loaders.gl/draco';\nimport { GL } from '@loaders.gl/math';\nimport { Vector3 } from '@math.gl/core';\nimport Tile3DFeatureTable from '../classes/tile-3d-feature-table';\nimport Tile3DBatchTable from '../classes/tile-3d-batch-table';\nimport { parse3DTileHeaderSync } from './helpers/parse-3d-tile-header';\nimport { parse3DTileTablesHeaderSync, parse3DTileTablesSync } from './helpers/parse-3d-tile-tables';\nimport { normalize3DTileColorAttribute } from './helpers/normalize-3d-tile-colors';\nimport { normalize3DTileNormalAttribute } from './helpers/normalize-3d-tile-normals';\nimport { normalize3DTilePositionAttribute } from './helpers/normalize-3d-tile-positions';\nexport async function parsePointCloud3DTile(tile, arrayBuffer, byteOffset, options, context) {\n  byteOffset = parse3DTileHeaderSync(tile, arrayBuffer, byteOffset);\n  byteOffset = parse3DTileTablesHeaderSync(tile, arrayBuffer, byteOffset);\n  byteOffset = parse3DTileTablesSync(tile, arrayBuffer, byteOffset, options);\n  initializeTile(tile);\n  const {\n    featureTable,\n    batchTable\n  } = parsePointCloudTables(tile);\n  await parseDraco(tile, featureTable, batchTable, options, context);\n  parsePositions(tile, featureTable, options);\n  parseColors(tile, featureTable, batchTable);\n  parseNormals(tile, featureTable);\n  return byteOffset;\n}\n\nfunction initializeTile(tile) {\n  tile.attributes = {\n    positions: null,\n    colors: null,\n    normals: null,\n    batchIds: null\n  };\n  tile.isQuantized = false;\n  tile.isTranslucent = false;\n  tile.isRGB565 = false;\n  tile.isOctEncoded16P = false;\n}\n\nfunction parsePointCloudTables(tile) {\n  const featureTable = new Tile3DFeatureTable(tile.featureTableJson, tile.featureTableBinary);\n  const pointsLength = featureTable.getGlobalProperty('POINTS_LENGTH');\n\n  if (!Number.isFinite(pointsLength)) {\n    throw new Error('POINTS_LENGTH must be defined');\n  }\n\n  featureTable.featuresLength = pointsLength;\n  tile.featuresLength = pointsLength;\n  tile.pointsLength = pointsLength;\n  tile.pointCount = pointsLength;\n  tile.rtcCenter = featureTable.getGlobalProperty('RTC_CENTER', GL.FLOAT, 3);\n  const batchTable = parseBatchIds(tile, featureTable);\n  return {\n    featureTable,\n    batchTable\n  };\n}\n\nfunction parsePositions(tile, featureTable, options) {\n  if (!tile.attributes.positions) {\n    if (featureTable.hasProperty('POSITION')) {\n      tile.attributes.positions = featureTable.getPropertyArray('POSITION', GL.FLOAT, 3);\n    } else if (featureTable.hasProperty('POSITION_QUANTIZED')) {\n      const positions = featureTable.getPropertyArray('POSITION_QUANTIZED', GL.UNSIGNED_SHORT, 3);\n      tile.isQuantized = true;\n      tile.quantizedRange = (1 << 16) - 1;\n      tile.quantizedVolumeScale = featureTable.getGlobalProperty('QUANTIZED_VOLUME_SCALE', GL.FLOAT, 3);\n\n      if (!tile.quantizedVolumeScale) {\n        throw new Error('QUANTIZED_VOLUME_SCALE must be defined for quantized positions.');\n      }\n\n      tile.quantizedVolumeOffset = featureTable.getGlobalProperty('QUANTIZED_VOLUME_OFFSET', GL.FLOAT, 3);\n\n      if (!tile.quantizedVolumeOffset) {\n        throw new Error('QUANTIZED_VOLUME_OFFSET must be defined for quantized positions.');\n      }\n\n      tile.attributes.positions = normalize3DTilePositionAttribute(tile, positions, options);\n    }\n  }\n\n  if (!tile.attributes.positions) {\n    throw new Error('Either POSITION or POSITION_QUANTIZED must be defined.');\n  }\n}\n\nfunction parseColors(tile, featureTable, batchTable) {\n  if (!tile.attributes.colors) {\n    let colors = null;\n\n    if (featureTable.hasProperty('RGBA')) {\n      colors = featureTable.getPropertyArray('RGBA', GL.UNSIGNED_BYTE, 4);\n      tile.isTranslucent = true;\n    } else if (featureTable.hasProperty('RGB')) {\n      colors = featureTable.getPropertyArray('RGB', GL.UNSIGNED_BYTE, 3);\n    } else if (featureTable.hasProperty('RGB565')) {\n      colors = featureTable.getPropertyArray('RGB565', GL.UNSIGNED_SHORT, 1);\n      tile.isRGB565 = true;\n    }\n\n    tile.attributes.colors = normalize3DTileColorAttribute(tile, colors, batchTable);\n  }\n\n  if (featureTable.hasProperty('CONSTANT_RGBA')) {\n    tile.constantRGBA = featureTable.getGlobalProperty('CONSTANT_RGBA', GL.UNSIGNED_BYTE, 4);\n  }\n}\n\nfunction parseNormals(tile, featureTable) {\n  if (!tile.attributes.normals) {\n    let normals = null;\n\n    if (featureTable.hasProperty('NORMAL')) {\n      normals = featureTable.getPropertyArray('NORMAL', GL.FLOAT, 3);\n    } else if (featureTable.hasProperty('NORMAL_OCT16P')) {\n      normals = featureTable.getPropertyArray('NORMAL_OCT16P', GL.UNSIGNED_BYTE, 2);\n      tile.isOctEncoded16P = true;\n    }\n\n    tile.attributes.normals = normalize3DTileNormalAttribute(tile, normals);\n  }\n}\n\nfunction parseBatchIds(tile, featureTable) {\n  let batchTable = null;\n\n  if (!tile.batchIds && featureTable.hasProperty('BATCH_ID')) {\n    tile.batchIds = featureTable.getPropertyArray('BATCH_ID', GL.UNSIGNED_SHORT, 1);\n\n    if (tile.batchIds) {\n      const batchFeatureLength = featureTable.getGlobalProperty('BATCH_LENGTH');\n\n      if (!batchFeatureLength) {\n        throw new Error('Global property: BATCH_LENGTH must be defined when BATCH_ID is defined.');\n      }\n\n      const {\n        batchTableJson,\n        batchTableBinary\n      } = tile;\n      batchTable = new Tile3DBatchTable(batchTableJson, batchTableBinary, batchFeatureLength);\n    }\n  }\n\n  return batchTable;\n}\n\nasync function parseDraco(tile, featureTable, batchTable, options, context) {\n  let dracoBuffer;\n  let dracoFeatureTableProperties;\n  let dracoBatchTableProperties;\n  const batchTableDraco = tile.batchTableJson && tile.batchTableJson.extensions && tile.batchTableJson.extensions['3DTILES_draco_point_compression'];\n\n  if (batchTableDraco) {\n    dracoBatchTableProperties = batchTableDraco.properties;\n  }\n\n  const featureTableDraco = featureTable.getExtension('3DTILES_draco_point_compression');\n\n  if (featureTableDraco) {\n    dracoFeatureTableProperties = featureTableDraco.properties;\n    const dracoByteOffset = featureTableDraco.byteOffset;\n    const dracoByteLength = featureTableDraco.byteLength;\n\n    if (!dracoFeatureTableProperties || !Number.isFinite(dracoByteOffset) || !dracoByteLength) {\n      throw new Error('Draco properties, byteOffset, and byteLength must be defined');\n    }\n\n    dracoBuffer = tile.featureTableBinary.slice(dracoByteOffset, dracoByteOffset + dracoByteLength);\n    tile.hasPositions = Number.isFinite(dracoFeatureTableProperties.POSITION);\n    tile.hasColors = Number.isFinite(dracoFeatureTableProperties.RGB) || Number.isFinite(dracoFeatureTableProperties.RGBA);\n    tile.hasNormals = Number.isFinite(dracoFeatureTableProperties.NORMAL);\n    tile.hasBatchIds = Number.isFinite(dracoFeatureTableProperties.BATCH_ID);\n    tile.isTranslucent = Number.isFinite(dracoFeatureTableProperties.RGBA);\n  }\n\n  if (!dracoBuffer) {\n    return true;\n  }\n\n  const dracoData = {\n    buffer: dracoBuffer,\n    properties: { ...dracoFeatureTableProperties,\n      ...dracoBatchTableProperties\n    },\n    featureTableProperties: dracoFeatureTableProperties,\n    batchTableProperties: dracoBatchTableProperties,\n    dequantizeInShader: false\n  };\n  return await loadDraco(tile, dracoData, options, context);\n}\n\nexport async function loadDraco(tile, dracoData, options, context) {\n  const {\n    parse\n  } = context;\n  const dracoOptions = { ...options,\n    draco: { ...options.draco,\n      extraAttributes: dracoData.batchTableProperties || {}\n    }\n  };\n  delete dracoOptions['3d-tiles'];\n  const data = await parse(dracoData.buffer, DracoLoader, dracoOptions);\n  const decodedPositions = data.attributes.POSITION && data.attributes.POSITION.value;\n  const decodedColors = data.attributes.COLOR_0 && data.attributes.COLOR_0.value;\n  const decodedNormals = data.attributes.NORMAL && data.attributes.NORMAL.value;\n  const decodedBatchIds = data.attributes.BATCH_ID && data.attributes.BATCH_ID.value;\n  const isQuantizedDraco = decodedPositions && data.attributes.POSITION.value.quantization;\n  const isOctEncodedDraco = decodedNormals && data.attributes.NORMAL.value.quantization;\n\n  if (isQuantizedDraco) {\n    const quantization = data.POSITION.data.quantization;\n    const range = quantization.range;\n    tile.quantizedVolumeScale = new Vector3(range, range, range);\n    tile.quantizedVolumeOffset = new Vector3(quantization.minValues);\n    tile.quantizedRange = (1 << quantization.quantizationBits) - 1.0;\n    tile.isQuantizedDraco = true;\n  }\n\n  if (isOctEncodedDraco) {\n    tile.octEncodedRange = (1 << data.NORMAL.data.quantization.quantizationBits) - 1.0;\n    tile.isOctEncodedDraco = true;\n  }\n\n  const batchTableAttributes = {};\n\n  if (dracoData.batchTableProperties) {\n    for (const attributeName of Object.keys(dracoData.batchTableProperties)) {\n      if (data.attributes[attributeName] && data.attributes[attributeName].value) {\n        batchTableAttributes[attributeName.toLowerCase()] = data.attributes[attributeName].value;\n      }\n    }\n  }\n\n  tile.attributes = {\n    positions: decodedPositions,\n    colors: normalize3DTileColorAttribute(tile, decodedColors, undefined),\n    normals: decodedNormals,\n    batchIds: decodedBatchIds,\n    ...batchTableAttributes\n  };\n}\n//# sourceMappingURL=parse-3d-tile-point-cloud.js.map","import { GLTFLoader } from '@loaders.gl/gltf';\nimport { sliceArrayBuffer } from '@loaders.gl/loader-utils';\nexport const GLTF_FORMAT = {\n  URI: 0,\n  EMBEDDED: 1\n};\nexport function parse3DTileGLTFViewSync(tile, arrayBuffer, byteOffset, options) {\n  tile.rotateYtoZ = true;\n  const gltfByteLength = tile.byteOffset + tile.byteLength - byteOffset;\n\n  if (gltfByteLength === 0) {\n    throw new Error('glTF byte length must be greater than 0.');\n  }\n\n  tile.gltfUpAxis = options['3d-tiles'] && options['3d-tiles'].assetGltfUpAxis ? options['3d-tiles'].assetGltfUpAxis : 'Y';\n  tile.gltfArrayBuffer = sliceArrayBuffer(arrayBuffer, byteOffset, gltfByteLength);\n  tile.gltfByteOffset = 0;\n  tile.gltfByteLength = gltfByteLength;\n\n  if (byteOffset % 4 === 0) {} else {\n    console.warn(\"\".concat(tile.type, \": embedded glb is not aligned to a 4-byte boundary.\"));\n  }\n\n  return tile.byteOffset + tile.byteLength;\n}\nexport async function extractGLTF(tile, gltfFormat, options, context) {\n  const tile3DOptions = options['3d-tiles'] || {};\n  extractGLTFBufferOrURL(tile, gltfFormat, options);\n\n  if (tile3DOptions.loadGLTF) {\n    const {\n      parse,\n      fetch\n    } = context;\n\n    if (tile.gltfUrl) {\n      tile.gltfArrayBuffer = await fetch(tile.gltfUrl, options);\n      tile.gltfByteOffset = 0;\n    }\n\n    if (tile.gltfArrayBuffer) {\n      tile.gltf = await parse(tile.gltfArrayBuffer, GLTFLoader, options, context);\n      delete tile.gltfArrayBuffer;\n      delete tile.gltfByteOffset;\n      delete tile.gltfByteLength;\n    }\n  }\n}\n\nfunction extractGLTFBufferOrURL(tile, gltfFormat, options) {\n  switch (gltfFormat) {\n    case GLTF_FORMAT.URI:\n      const gltfUrlBytes = new Uint8Array(tile.gltfArrayBuffer, tile.gltfByteOffset);\n      const textDecoder = new TextDecoder();\n      const gltfUrl = textDecoder.decode(gltfUrlBytes);\n      tile.gltfUrl = gltfUrl.replace(/[\\s\\0]+$/, '');\n      delete tile.gltfArrayBuffer;\n      delete tile.gltfByteOffset;\n      delete tile.gltfByteLength;\n      break;\n\n    case GLTF_FORMAT.EMBEDDED:\n      break;\n\n    default:\n      throw new Error('b3dm: Illegal glTF format field');\n  }\n}\n//# sourceMappingURL=parse-3d-tile-gltf-view.js.map","import { GL } from '@loaders.gl/math';\nimport Tile3DFeatureTable from '../classes/tile-3d-feature-table';\nimport { parse3DTileHeaderSync } from './helpers/parse-3d-tile-header';\nimport { parse3DTileTablesHeaderSync, parse3DTileTablesSync } from './helpers/parse-3d-tile-tables';\nimport { parse3DTileGLTFViewSync, extractGLTF, GLTF_FORMAT } from './helpers/parse-3d-tile-gltf-view';\nexport async function parseBatchedModel3DTile(tile, arrayBuffer, byteOffset, options, context) {\n  var _tile$gltf;\n\n  byteOffset = parseBatchedModel(tile, arrayBuffer, byteOffset, options, context);\n  await extractGLTF(tile, GLTF_FORMAT.EMBEDDED, options, context);\n  const extensions = tile === null || tile === void 0 ? void 0 : (_tile$gltf = tile.gltf) === null || _tile$gltf === void 0 ? void 0 : _tile$gltf.extensions;\n\n  if (extensions && extensions.CESIUM_RTC) {\n    tile.rtcCenter = extensions.CESIUM_RTC.center;\n  }\n\n  return byteOffset;\n}\n\nfunction parseBatchedModel(tile, arrayBuffer, byteOffset, options, context) {\n  byteOffset = parse3DTileHeaderSync(tile, arrayBuffer, byteOffset);\n  byteOffset = parse3DTileTablesHeaderSync(tile, arrayBuffer, byteOffset);\n  byteOffset = parse3DTileTablesSync(tile, arrayBuffer, byteOffset, options);\n  byteOffset = parse3DTileGLTFViewSync(tile, arrayBuffer, byteOffset, options);\n  const featureTable = new Tile3DFeatureTable(tile.featureTableJson, tile.featureTableBinary);\n  tile.rtcCenter = featureTable.getGlobalProperty('RTC_CENTER', GL.FLOAT, 3);\n  return byteOffset;\n}\n//# sourceMappingURL=parse-3d-tile-batched-model.js.map","import { Vector3, Matrix3, Matrix4, Quaternion } from '@math.gl/core';\nimport { Ellipsoid } from '@math.gl/geospatial';\nimport { GL } from '@loaders.gl/math';\nimport Tile3DFeatureTable from '../classes/tile-3d-feature-table';\nimport Tile3DBatchTable from '../classes/tile-3d-batch-table';\nimport { parse3DTileHeaderSync } from './helpers/parse-3d-tile-header';\nimport { parse3DTileTablesHeaderSync, parse3DTileTablesSync } from './helpers/parse-3d-tile-tables';\nimport { parse3DTileGLTFViewSync, extractGLTF } from './helpers/parse-3d-tile-gltf-view';\nexport async function parseInstancedModel3DTile(tile, arrayBuffer, byteOffset, options, context) {\n  byteOffset = parseInstancedModel(tile, arrayBuffer, byteOffset, options, context);\n  await extractGLTF(tile, tile.gltfFormat, options, context);\n  return byteOffset;\n}\n\nfunction parseInstancedModel(tile, arrayBuffer, byteOffset, options, context) {\n  byteOffset = parse3DTileHeaderSync(tile, arrayBuffer, byteOffset);\n\n  if (tile.version !== 1) {\n    throw new Error(\"Instanced 3D Model version \".concat(tile.version, \" is not supported\"));\n  }\n\n  byteOffset = parse3DTileTablesHeaderSync(tile, arrayBuffer, byteOffset);\n  const view = new DataView(arrayBuffer);\n  tile.gltfFormat = view.getUint32(byteOffset, true);\n  byteOffset += 4;\n  byteOffset = parse3DTileTablesSync(tile, arrayBuffer, byteOffset, options);\n  byteOffset = parse3DTileGLTFViewSync(tile, arrayBuffer, byteOffset, options);\n\n  if (tile.featureTableJsonByteLength === 0) {\n    throw new Error('i3dm parser: featureTableJsonByteLength is zero.');\n  }\n\n  const featureTable = new Tile3DFeatureTable(tile.featureTableJson, tile.featureTableBinary);\n  const instancesLength = featureTable.getGlobalProperty('INSTANCES_LENGTH');\n  featureTable.featuresLength = instancesLength;\n\n  if (!Number.isFinite(instancesLength)) {\n    throw new Error('i3dm parser: INSTANCES_LENGTH must be defined');\n  }\n\n  tile.eastNorthUp = featureTable.getGlobalProperty('EAST_NORTH_UP');\n  tile.rtcCenter = featureTable.getGlobalProperty('RTC_CENTER', GL.FLOAT, 3);\n  const batchTable = new Tile3DBatchTable(tile.batchTableJson, tile.batchTableBinary, instancesLength);\n  extractInstancedAttributes(tile, featureTable, batchTable, instancesLength);\n  return byteOffset;\n}\n\nfunction extractInstancedAttributes(tile, featureTable, batchTable, instancesLength) {\n  const collectionOptions = {\n    instances: new Array(instancesLength),\n    batchTable: tile._batchTable,\n    cull: false,\n    url: undefined,\n    gltf: undefined,\n    basePath: undefined,\n    incrementallyLoadTextures: false,\n    forwardAxis: [1, 0, 0]\n  };\n  const instances = collectionOptions.instances;\n  const instancePosition = new Vector3();\n  const instanceNormalRight = new Vector3();\n  const instanceNormalUp = new Vector3();\n  const instanceNormalForward = new Vector3();\n  const instanceRotation = new Matrix3();\n  const instanceQuaternion = new Quaternion();\n  const instanceScale = new Vector3();\n  const instanceTranslationRotationScale = {};\n  const instanceTransform = new Matrix4();\n  const scratch1 = [];\n  const scratch2 = [];\n  const scratchVector1 = new Vector3();\n  const scratchVector2 = new Vector3();\n\n  for (let i = 0; i < instancesLength; i++) {\n    let position;\n\n    if (featureTable.hasProperty('POSITION')) {\n      position = featureTable.getProperty('POSITION', GL.FLOAT, 3, i, instancePosition);\n    } else if (featureTable.hasProperty('POSITION_QUANTIZED')) {\n      position = featureTable.getProperty('POSITION_QUANTIZED', GL.UNSIGNED_SHORT, 3, i, instancePosition);\n      const quantizedVolumeOffset = featureTable.getGlobalProperty('QUANTIZED_VOLUME_OFFSET', GL.FLOAT, 3, scratchVector1);\n\n      if (!quantizedVolumeOffset) {\n        throw new Error('i3dm parser: QUANTIZED_VOLUME_OFFSET must be defined for quantized positions.');\n      }\n\n      const quantizedVolumeScale = featureTable.getGlobalProperty('QUANTIZED_VOLUME_SCALE', GL.FLOAT, 3, scratchVector2);\n\n      if (!quantizedVolumeScale) {\n        throw new Error('i3dm parser: QUANTIZED_VOLUME_SCALE must be defined for quantized positions.');\n      }\n\n      const MAX_UNSIGNED_SHORT = 65535.0;\n\n      for (let j = 0; j < 3; j++) {\n        position[j] = position[j] / MAX_UNSIGNED_SHORT * quantizedVolumeScale[j] + quantizedVolumeOffset[j];\n      }\n    }\n\n    if (!position) {\n      throw new Error('i3dm: POSITION or POSITION_QUANTIZED must be defined for each instance.');\n    }\n\n    instancePosition.copy(position);\n    instanceTranslationRotationScale.translation = instancePosition;\n    tile.normalUp = featureTable.getProperty('NORMAL_UP', GL.FLOAT, 3, i, scratch1);\n    tile.normalRight = featureTable.getProperty('NORMAL_RIGHT', GL.FLOAT, 3, i, scratch2);\n    const hasCustomOrientation = false;\n\n    if (tile.normalUp) {\n      if (!tile.normalRight) {\n        throw new Error('i3dm: Custom orientation requires both NORMAL_UP and NORMAL_RIGHT.');\n      }\n\n      tile.hasCustomOrientation = true;\n    } else {\n      tile.octNormalUp = featureTable.getProperty('NORMAL_UP_OCT32P', GL.UNSIGNED_SHORT, 2, scratch1);\n      tile.octNormalRight = featureTable.getProperty('NORMAL_RIGHT_OCT32P', GL.UNSIGNED_SHORT, 2, scratch2);\n\n      if (tile.octNormalUp) {\n        if (!tile.octNormalRight) {\n          throw new Error('i3dm: oct-encoded orientation requires NORMAL_UP_OCT32P and NORMAL_RIGHT_OCT32P');\n        }\n\n        throw new Error('i3dm: oct-encoded orientation not implemented');\n      } else if (tile.eastNorthUp) {\n        Ellipsoid.WGS84.eastNorthUpToFixedFrame(instancePosition, instanceTransform);\n        instanceTransform.getRotationMatrix3(instanceRotation);\n      } else {\n        instanceRotation.identity();\n      }\n    }\n\n    if (hasCustomOrientation) {\n      instanceNormalForward.copy(instanceNormalRight).cross(instanceNormalUp).normalize();\n      instanceRotation.setColumn(0, instanceNormalRight);\n      instanceRotation.setColumn(1, instanceNormalUp);\n      instanceRotation.setColumn(2, instanceNormalForward);\n    }\n\n    instanceQuaternion.fromMatrix3(instanceRotation);\n    instanceTranslationRotationScale.rotation = instanceQuaternion;\n    instanceScale.set(1.0, 1.0, 1.0);\n    const scale = featureTable.getProperty('SCALE', GL.FLOAT, 1, i);\n\n    if (Number.isFinite(scale)) {\n      instanceScale.multiplyByScalar(scale);\n    }\n\n    const nonUniformScale = featureTable.getProperty('SCALE_NON_UNIFORM', GL.FLOAT, 3, i, scratch1);\n\n    if (nonUniformScale) {\n      instanceScale.scale(nonUniformScale);\n    }\n\n    instanceTranslationRotationScale.scale = instanceScale;\n    let batchId = featureTable.getProperty('BATCH_ID', GL.UNSIGNED_SHORT, 1, i);\n\n    if (batchId === undefined) {\n      batchId = i;\n    }\n\n    const rotationMatrix = new Matrix4().fromQuaternion(instanceTranslationRotationScale.rotation);\n    instanceTransform.identity();\n    instanceTransform.translate(instanceTranslationRotationScale.translation);\n    instanceTransform.multiplyRight(rotationMatrix);\n    instanceTransform.scale(instanceTranslationRotationScale.scale);\n    const modelMatrix = instanceTransform.clone();\n    instances[i] = {\n      modelMatrix,\n      batchId\n    };\n  }\n\n  tile.instances = instances;\n}\n//# sourceMappingURL=parse-3d-tile-instanced-model.js.map","import { TILE3D_TYPE } from '../constants';\nimport { getMagicString } from './helpers/parse-utils';\nimport { parsePointCloud3DTile } from './parse-3d-tile-point-cloud';\nimport { parseBatchedModel3DTile } from './parse-3d-tile-batched-model';\nimport { parseInstancedModel3DTile } from './parse-3d-tile-instanced-model';\nimport { parseComposite3DTile } from './parse-3d-tile-composite';\nimport { parseGltf3DTile } from './parse-3d-tile-gltf';\nexport async function parse3DTile(arrayBuffer, byteOffset = 0, options, context, tile = {}) {\n  tile.byteOffset = byteOffset;\n  tile.type = getMagicString(arrayBuffer, byteOffset);\n\n  switch (tile.type) {\n    case TILE3D_TYPE.COMPOSITE:\n      return await parseComposite3DTile(tile, arrayBuffer, byteOffset, options, context, parse3DTile);\n\n    case TILE3D_TYPE.BATCHED_3D_MODEL:\n      return await parseBatchedModel3DTile(tile, arrayBuffer, byteOffset, options, context);\n\n    case TILE3D_TYPE.GLTF:\n      return await parseGltf3DTile(tile, arrayBuffer, options, context);\n\n    case TILE3D_TYPE.INSTANCED_3D_MODEL:\n      return await parseInstancedModel3DTile(tile, arrayBuffer, byteOffset, options, context);\n\n    case TILE3D_TYPE.POINT_CLOUD:\n      return await parsePointCloud3DTile(tile, arrayBuffer, byteOffset, options, context);\n\n    default:\n      throw new Error(\"3DTileLoader: unknown type \".concat(tile.type));\n  }\n}\n//# sourceMappingURL=parse-3d-tile.js.map","import { parse3DTileHeaderSync } from './helpers/parse-3d-tile-header';\nexport async function parseComposite3DTile(tile, arrayBuffer, byteOffset, options, context, parse3DTile) {\n  byteOffset = parse3DTileHeaderSync(tile, arrayBuffer, byteOffset);\n  const view = new DataView(arrayBuffer);\n  tile.tilesLength = view.getUint32(byteOffset, true);\n  byteOffset += 4;\n  tile.tiles = [];\n\n  while (tile.tiles.length < tile.tilesLength && tile.byteLength - byteOffset > 12) {\n    const subtile = {};\n    tile.tiles.push(subtile);\n    byteOffset = await parse3DTile(arrayBuffer, byteOffset, options, context, subtile);\n  }\n\n  return byteOffset;\n}\n//# sourceMappingURL=parse-3d-tile-composite.js.map","import { GLTFLoader } from '@loaders.gl/gltf';\nexport async function parseGltf3DTile(tile, arrayBuffer, options, context) {\n  tile.rotateYtoZ = true;\n  tile.gltfUpAxis = options['3d-tiles'] && options['3d-tiles'].assetGltfUpAxis ? options['3d-tiles'].assetGltfUpAxis : 'Y';\n  const {\n    parse\n  } = context;\n  tile.gltf = await parse(arrayBuffer, GLTFLoader, options, context);\n}\n//# sourceMappingURL=parse-3d-tile-gltf.js.map","import { fetchFile } from '@loaders.gl/core';\nconst SUBTREE_FILE_MAGIC = 0x74627573;\nconst SUBTREE_FILE_VERSION = 1;\nexport default async function parse3DTilesSubtree(data) {\n  const magic = new Uint32Array(data.slice(0, 4));\n\n  if (magic[0] !== SUBTREE_FILE_MAGIC) {\n    throw new Error('Wrong subtree file magic number');\n  }\n\n  const version = new Uint32Array(data.slice(4, 8));\n\n  if (version[0] !== SUBTREE_FILE_VERSION) {\n    throw new Error('Wrong subtree file verson, must be 1');\n  }\n\n  const jsonByteLength = parseUint64Value(data.slice(8, 16));\n  const stringAttribute = new Uint8Array(data, 24, jsonByteLength);\n  const textDecoder = new TextDecoder('utf8');\n  const string = textDecoder.decode(stringAttribute);\n  const subtree = JSON.parse(string);\n  const binaryByteLength = parseUint64Value(data.slice(16, 24));\n  let internalBinaryBuffer = new ArrayBuffer(0);\n\n  if (binaryByteLength) {\n    internalBinaryBuffer = data.slice(24 + jsonByteLength);\n  }\n\n  if ('bufferView' in subtree.tileAvailability) {\n    subtree.tileAvailability.explicitBitstream = await getExplicitBitstream(subtree, 'tileAvailability', internalBinaryBuffer);\n  }\n\n  if ('bufferView' in subtree.contentAvailability) {\n    subtree.contentAvailability.explicitBitstream = await getExplicitBitstream(subtree, 'contentAvailability', internalBinaryBuffer);\n  }\n\n  if ('bufferView' in subtree.childSubtreeAvailability) {\n    subtree.childSubtreeAvailability.explicitBitstream = await getExplicitBitstream(subtree, 'childSubtreeAvailability', internalBinaryBuffer);\n  }\n\n  return subtree;\n}\n\nasync function getExplicitBitstream(subtree, name, internalBinaryBuffer) {\n  const bufferViewIndex = subtree[name].bufferView;\n  const bufferView = subtree.bufferViews[bufferViewIndex];\n  const buffer = subtree.buffers[bufferView.buffer];\n\n  if (buffer.uri) {\n    const response = await fetchFile(buffer.uri);\n    const data = await response.arrayBuffer();\n    return new Uint8Array(data, bufferView.byteOffset, bufferView.byteLength);\n  }\n\n  return new Uint8Array(internalBinaryBuffer, bufferView.byteOffset, bufferView.byteLength);\n}\n\nfunction parseUint64Value(buffer) {\n  const dataView = new DataView(buffer);\n  const left = dataView.getUint32(0, true);\n  const right = dataView.getUint32(4, true);\n  return left + 2 ** 32 * right;\n}\n//# sourceMappingURL=parse-3d-tile-subtree.js.map","import parse3DTilesSubtree from './lib/parsers/helpers/parse-3d-tile-subtree';\nimport { VERSION } from './lib/utils/version';\nexport const Tile3DSubtreeLoader = {\n  id: '3d-tiles-subtree',\n  name: '3D Tiles Subtree',\n  module: '3d-tiles',\n  version: VERSION,\n  extensions: ['subtree'],\n  mimeTypes: ['application/octet-stream'],\n  tests: ['subtree'],\n  parse: parse3DTilesSubtree,\n  options: {}\n};\n//# sourceMappingURL=tile-3d-subtree-loader.js.map","import { Tile3DSubtreeLoader } from '../../../tile-3d-subtree-loader';\nimport { load } from '@loaders.gl/core';\nconst QUADTREE_DEVISION_COUNT = 4;\nconst OCTREE_DEVISION_COUNT = 8;\nconst SUBDIVISION_COUNT_MAP = {\n  QUADTREE: QUADTREE_DEVISION_COUNT,\n  OCTREE: OCTREE_DEVISION_COUNT\n};\nexport async function parseImplicitTiles(params) {\n  const {\n    options,\n    parentData = {\n      mortonIndex: 0,\n      x: 0,\n      y: 0,\n      z: 0\n    },\n    childIndex = 0,\n    globalData = {\n      level: 0,\n      mortonIndex: 0,\n      x: 0,\n      y: 0,\n      z: 0\n    }\n  } = params;\n  let {\n    subtree,\n    level = 0\n  } = params;\n  const {\n    subdivisionScheme,\n    subtreeLevels,\n    maximumLevel,\n    contentUrlTemplate,\n    subtreesUriTemplate,\n    basePath\n  } = options;\n  const tile = {\n    children: [],\n    lodMetricValue: 0,\n    contentUrl: ''\n  };\n  const childrenPerTile = SUBDIVISION_COUNT_MAP[subdivisionScheme];\n  const childX = childIndex & 0b01;\n  const childY = childIndex >> 1 & 0b01;\n  const childZ = childIndex >> 2 & 0b01;\n  const levelOffset = (childrenPerTile ** level - 1) / (childrenPerTile - 1);\n  let childTileMortonIndex = concatBits(parentData.mortonIndex, childIndex);\n  let tileAvailabilityIndex = levelOffset + childTileMortonIndex;\n  let childTileX = concatBits(parentData.x, childX);\n  let childTileY = concatBits(parentData.y, childY);\n  let childTileZ = concatBits(parentData.z, childZ);\n  let isChildSubtreeAvailable = false;\n\n  if (level + 1 > subtreeLevels) {\n    isChildSubtreeAvailable = getAvailabilityResult(subtree.childSubtreeAvailability, childTileMortonIndex);\n  }\n\n  const x = concatBits(globalData.x, childTileX);\n  const y = concatBits(globalData.y, childTileY);\n  const z = concatBits(globalData.z, childTileZ);\n  const lev = level + globalData.level;\n\n  if (isChildSubtreeAvailable) {\n    const subtreePath = \"\".concat(basePath, \"/\").concat(subtreesUriTemplate);\n    const childSubtreeUrl = replaceContentUrlTemplate(subtreePath, lev, x, y, z);\n    const childSubtree = await load(childSubtreeUrl, Tile3DSubtreeLoader);\n    subtree = childSubtree;\n    globalData.mortonIndex = childTileMortonIndex;\n    globalData.x = childTileX;\n    globalData.y = childTileY;\n    globalData.z = childTileZ;\n    globalData.level = level;\n    childTileMortonIndex = 0;\n    tileAvailabilityIndex = 0;\n    childTileX = 0;\n    childTileY = 0;\n    childTileZ = 0;\n    level = 0;\n  }\n\n  const isTileAvailable = getAvailabilityResult(subtree.tileAvailability, tileAvailabilityIndex);\n\n  if (!isTileAvailable || level > maximumLevel) {\n    return tile;\n  }\n\n  const isContentAvailable = getAvailabilityResult(subtree.contentAvailability, tileAvailabilityIndex);\n\n  if (isContentAvailable) {\n    tile.contentUrl = replaceContentUrlTemplate(contentUrlTemplate, lev, x, y, z);\n  }\n\n  const childTileLevel = level + 1;\n  const pData = {\n    mortonIndex: childTileMortonIndex,\n    x: childTileX,\n    y: childTileY,\n    z: childTileZ\n  };\n\n  for (let index = 0; index < childrenPerTile; index++) {\n    const currentTile = await parseImplicitTiles({\n      subtree,\n      options,\n      parentData: pData,\n      childIndex: index,\n      level: childTileLevel,\n      globalData\n    });\n\n    if (currentTile.contentUrl || currentTile.children.length) {\n      const globalLevel = lev + 1;\n      const childCoordinates = {\n        childTileX,\n        childTileY,\n        childTileZ\n      };\n      const formattedTile = formatTileData(currentTile, globalLevel, childCoordinates, options);\n      tile.children.push(formattedTile);\n    }\n  }\n\n  return tile;\n}\n\nfunction getAvailabilityResult(availabilityData, index) {\n  if ('constant' in availabilityData) {\n    return Boolean(availabilityData.constant);\n  }\n\n  if (availabilityData.explicitBitstream) {\n    return getBooleanValueFromBitstream(index, availabilityData.explicitBitstream);\n  }\n\n  return false;\n}\n\nfunction formatTileData(tile, level, childCoordinates, options) {\n  const {\n    basePath,\n    refine,\n    getRefine,\n    lodMetricType,\n    getTileType,\n    rootLodMetricValue,\n    rootBoundingVolume\n  } = options;\n  const uri = tile.contentUrl && tile.contentUrl.replace(\"\".concat(basePath, \"/\"), '');\n  const lodMetricValue = rootLodMetricValue / 2 ** level;\n  const boundingVolume = calculateBoundingVolumeForChildTile(level, rootBoundingVolume, childCoordinates);\n  return {\n    children: tile.children,\n    contentUrl: tile.contentUrl,\n    content: {\n      uri\n    },\n    id: tile.contentUrl,\n    refine: getRefine(refine),\n    type: getTileType(tile),\n    lodMetricType,\n    lodMetricValue,\n    boundingVolume\n  };\n}\n\nfunction calculateBoundingVolumeForChildTile(level, rootBoundingVolume, childCoordinates) {\n  if (rootBoundingVolume.region) {\n    const {\n      childTileX,\n      childTileY,\n      childTileZ\n    } = childCoordinates;\n    const [west, south, east, north, minimumHeight, maximumHeight] = rootBoundingVolume.region;\n    const boundingVolumesCount = 2 ** level;\n    const sizeX = (east - west) / boundingVolumesCount;\n    const sizeY = (north - south) / boundingVolumesCount;\n    const sizeZ = (maximumHeight - minimumHeight) / boundingVolumesCount;\n    const [childWest, childEast] = [west + sizeX * childTileX, west + sizeX * (childTileX + 1)];\n    const [childSouth, childNorth] = [south + sizeY * childTileY, south + sizeY * (childTileY + 1)];\n    const [childMinimumHeight, childMaximumHeight] = [minimumHeight + sizeZ * childTileZ, minimumHeight + sizeZ * (childTileZ + 1)];\n    return {\n      region: [childWest, childSouth, childEast, childNorth, childMinimumHeight, childMaximumHeight]\n    };\n  }\n\n  console.warn('Unsupported bounding volume type: ', rootBoundingVolume);\n  return null;\n}\n\nfunction concatBits(first, second) {\n  return parseInt(first.toString(2) + second.toString(2), 2);\n}\n\nexport function replaceContentUrlTemplate(templateUrl, level, x, y, z) {\n  const mapUrl = generateMapUrl({\n    level,\n    x,\n    y,\n    z\n  });\n  return templateUrl.replace(/{level}|{x}|{y}|{z}/gi, matched => mapUrl[matched]);\n}\n\nfunction generateMapUrl(items) {\n  const mapUrl = {};\n\n  for (const key in items) {\n    mapUrl[\"{\".concat(key, \"}\")] = items[key];\n  }\n\n  return mapUrl;\n}\n\nfunction getBooleanValueFromBitstream(availabilityIndex, availabilityBuffer) {\n  const byteIndex = Math.floor(availabilityIndex / 8);\n  const bitIndex = availabilityIndex % 8;\n  const bitValue = availabilityBuffer[byteIndex] >> bitIndex & 1;\n  return bitValue === 1;\n}\n//# sourceMappingURL=parse-3d-implicit-tiles.js.map","import { Tile3DSubtreeLoader } from '../../tile-3d-subtree-loader';\nimport { load } from '@loaders.gl/core';\nimport { LOD_METRIC_TYPE, TILE_REFINEMENT, TILE_TYPE } from '@loaders.gl/tiles';\nimport { parseImplicitTiles, replaceContentUrlTemplate } from './helpers/parse-3d-implicit-tiles';\n\nfunction getTileType(tile) {\n  if (!tile.contentUrl) {\n    return TILE_TYPE.EMPTY;\n  }\n\n  const contentUrl = tile.contentUrl;\n  const fileExtension = contentUrl.split('.').pop();\n\n  switch (fileExtension) {\n    case 'pnts':\n      return TILE_TYPE.POINTCLOUD;\n\n    case 'i3dm':\n    case 'b3dm':\n    case 'glb':\n    case 'gltf':\n      return TILE_TYPE.SCENEGRAPH;\n\n    default:\n      return fileExtension;\n  }\n}\n\nfunction getRefine(refine) {\n  switch (refine) {\n    case 'REPLACE':\n    case 'replace':\n      return TILE_REFINEMENT.REPLACE;\n\n    case 'ADD':\n    case 'add':\n      return TILE_REFINEMENT.ADD;\n\n    default:\n      return refine;\n  }\n}\n\nfunction resolveUri(uri, basePath) {\n  const urlSchemeRegex = /^[a-z][0-9a-z+.-]*:/i;\n\n  if (urlSchemeRegex.test(basePath)) {\n    const url = new URL(uri, \"\".concat(basePath, \"/\"));\n    return decodeURI(url.toString());\n  } else if (uri.startsWith('/')) {\n    return uri;\n  }\n\n  return \"\".concat(basePath, \"/\").concat(uri);\n}\n\nexport function normalizeTileData(tile, options) {\n  if (!tile) {\n    return null;\n  }\n\n  if (tile.content) {\n    const contentUri = tile.content.uri || tile.content.url;\n    tile.contentUrl = resolveUri(contentUri, options.basePath);\n  }\n\n  tile.id = tile.contentUrl;\n  tile.lodMetricType = LOD_METRIC_TYPE.GEOMETRIC_ERROR;\n  tile.lodMetricValue = tile.geometricError;\n  tile.transformMatrix = tile.transform;\n  tile.type = getTileType(tile);\n  tile.refine = getRefine(tile.refine);\n  return tile;\n}\nexport function normalizeTileHeaders(tileset) {\n  const basePath = tileset.basePath;\n  const root = normalizeTileData(tileset.root, tileset);\n  const stack = [];\n  stack.push(root);\n\n  while (stack.length > 0) {\n    const tile = stack.pop() || {};\n    const children = tile.children || [];\n\n    for (const childHeader of children) {\n      normalizeTileData(childHeader, {\n        basePath\n      });\n      stack.push(childHeader);\n    }\n  }\n\n  return root;\n}\nexport async function normalizeImplicitTileHeaders(tileset) {\n  if (!tileset.root) {\n    return null;\n  }\n\n  const basePath = tileset.basePath;\n  const implicitTilingExtension = tileset.root.extensions['3DTILES_implicit_tiling'];\n  const {\n    subdivisionScheme,\n    maximumLevel,\n    subtreeLevels,\n    subtrees: {\n      uri: subtreesUriTemplate\n    }\n  } = implicitTilingExtension;\n  const subtreeUrl = replaceContentUrlTemplate(subtreesUriTemplate, 0, 0, 0, 0);\n  const rootSubtreeUrl = resolveUri(subtreeUrl, basePath);\n  const rootSubtree = await load(rootSubtreeUrl, Tile3DSubtreeLoader);\n  const contentUrlTemplate = resolveUri(tileset.root.content.uri, basePath);\n  const refine = tileset.root.refine;\n  const rootLodMetricValue = tileset.root.geometricError;\n  const rootBoundingVolume = tileset.root.boundingVolume;\n  const options = {\n    contentUrlTemplate,\n    subtreesUriTemplate,\n    subdivisionScheme,\n    subtreeLevels,\n    maximumLevel,\n    refine,\n    basePath,\n    lodMetricType: LOD_METRIC_TYPE.GEOMETRIC_ERROR,\n    rootLodMetricValue,\n    rootBoundingVolume,\n    getTileType,\n    getRefine\n  };\n  return await normalizeImplicitTileData(tileset.root, rootSubtree, options);\n}\nexport async function normalizeImplicitTileData(tile, rootSubtree, options) {\n  if (!tile) {\n    return null;\n  }\n\n  tile.lodMetricType = LOD_METRIC_TYPE.GEOMETRIC_ERROR;\n  tile.lodMetricValue = tile.geometricError;\n  tile.transformMatrix = tile.transform;\n  const {\n    children,\n    contentUrl\n  } = await parseImplicitTiles({\n    subtree: rootSubtree,\n    options\n  });\n\n  if (contentUrl) {\n    tile.contentUrl = contentUrl;\n    tile.content = {\n      uri: contentUrl.replace(\"\".concat(options.basePath, \"/\"), '')\n    };\n  }\n\n  tile.refine = getRefine(tile.refine);\n  tile.type = getTileType(tile);\n  tile.children = children;\n  tile.id = tile.contentUrl;\n  return tile;\n}\n//# sourceMappingURL=parse-3d-tile-header.js.map","import { path } from '@loaders.gl/loader-utils';\nimport { TILESET_TYPE, LOD_METRIC_TYPE } from '@loaders.gl/tiles';\nimport { VERSION } from './lib/utils/version';\nimport { parse3DTile } from './lib/parsers/parse-3d-tile';\nimport { normalizeTileHeaders, normalizeImplicitTileHeaders } from './lib/parsers/parse-3d-tile-header';\nconst IMPLICIT_TILING_EXTENSION_NAME = '3DTILES_implicit_tiling';\nexport const Tiles3DLoader = {\n  id: '3d-tiles',\n  name: '3D Tiles',\n  module: '3d-tiles',\n  version: VERSION,\n  extensions: ['cmpt', 'pnts', 'b3dm', 'i3dm'],\n  mimeTypes: ['application/octet-stream'],\n  tests: ['cmpt', 'pnts', 'b3dm', 'i3dm'],\n  parse,\n  options: {\n    '3d-tiles': {\n      loadGLTF: true,\n      decodeQuantizedPositions: false,\n      isTileset: 'auto',\n      assetGltfUpAxis: null\n    }\n  }\n};\n\nfunction getBaseUri(tileset) {\n  return path.dirname(tileset.url);\n}\n\nasync function parseTile(arrayBuffer, options, context) {\n  const tile = {\n    content: {\n      featureIds: null\n    }\n  };\n  const byteOffset = 0;\n  await parse3DTile(arrayBuffer, byteOffset, options, context, tile.content);\n  return tile.content;\n}\n\nasync function parseTileset(data, options, context) {\n  var _tilesetJson$root;\n\n  const tilesetJson = JSON.parse(new TextDecoder().decode(data));\n  tilesetJson.loader = options.loader || Tiles3DLoader;\n  tilesetJson.url = context.url;\n  tilesetJson.basePath = getBaseUri(tilesetJson);\n  tilesetJson.root = hasImplicitTilingExtension(tilesetJson) ? await normalizeImplicitTileHeaders(tilesetJson) : normalizeTileHeaders(tilesetJson);\n  tilesetJson.type = TILESET_TYPE.TILES3D;\n  tilesetJson.lodMetricType = LOD_METRIC_TYPE.GEOMETRIC_ERROR;\n  tilesetJson.lodMetricValue = ((_tilesetJson$root = tilesetJson.root) === null || _tilesetJson$root === void 0 ? void 0 : _tilesetJson$root.lodMetricValue) || 0;\n  return tilesetJson;\n}\n\nasync function parse(data, options, context) {\n  const loaderOptions = options['3d-tiles'] || {};\n  let isTileset;\n\n  if (loaderOptions.isTileset === 'auto') {\n    isTileset = context.url && context.url.indexOf('.json') !== -1;\n  } else {\n    isTileset = loaderOptions.isTileset;\n  }\n\n  if (isTileset) {\n    data = await parseTileset(data, options, context);\n  } else {\n    data = await parseTile(data, options, context);\n  }\n\n  return data;\n}\n\nfunction hasImplicitTilingExtension(tilesetJson) {\n  var _tilesetJson$extensio, _tilesetJson$extensio2;\n\n  return (tilesetJson === null || tilesetJson === void 0 ? void 0 : (_tilesetJson$extensio = tilesetJson.extensionsRequired) === null || _tilesetJson$extensio === void 0 ? void 0 : _tilesetJson$extensio.includes(IMPLICIT_TILING_EXTENSION_NAME)) && (tilesetJson === null || tilesetJson === void 0 ? void 0 : (_tilesetJson$extensio2 = tilesetJson.extensionsUsed) === null || _tilesetJson$extensio2 === void 0 ? void 0 : _tilesetJson$extensio2.includes(IMPLICIT_TILING_EXTENSION_NAME));\n}\n//# sourceMappingURL=tiles-3d-loader.js.map","import GL from '@luma.gl/constants';\nimport {Geometry} from '@luma.gl/core';\n\nimport {\n  Accessor,\n  Color,\n  CompositeLayer,\n  CompositeLayerProps,\n  COORDINATE_SYSTEM,\n  FilterContext,\n  GetPickingInfoParams,\n  Layer,\n  LayersList,\n  log,\n  PickingInfo,\n  UpdateParameters,\n  Viewport,\n  DefaultProps\n} from '@deck.gl/core';\nimport {PointCloudLayer} from '@deck.gl/layers';\nimport {ScenegraphLayer} from '@deck.gl/mesh-layers';\nimport {default as MeshLayer} from '../mesh-layer/mesh-layer';\n\nimport {load} from '@loaders.gl/core';\nimport {MeshAttributes} from '@loaders.gl/schema';\nimport {Tileset3D, Tile3D, TILE_TYPE} from '@loaders.gl/tiles';\nimport {Tiles3DLoader} from '@loaders.gl/3d-tiles';\n\nconst SINGLE_DATA = [0];\n\nconst defaultProps: DefaultProps<Tile3DLayerProps> = {\n  getPointColor: {type: 'accessor', value: [0, 0, 0, 255]},\n  pointSize: 1.0,\n\n  // @ts-expect-error Disable async data loading (handling it in _loadTileSet)\n  data: null,\n  loader: Tiles3DLoader,\n\n  onTilesetLoad: {type: 'function', value: tileset3d => {}, compare: false},\n  onTileLoad: {type: 'function', value: tileHeader => {}, compare: false},\n  onTileUnload: {type: 'function', value: tileHeader => {}, compare: false},\n  onTileError: {type: 'function', value: (tile, message, url) => {}, compare: false},\n  _getMeshColor: {type: 'function', value: tileHeader => [255, 255, 255], compare: false}\n};\n\n/** All properties supported by Tile3DLayer */\nexport type Tile3DLayerProps<DataT = any> = _Tile3DLayerProps<DataT> & CompositeLayerProps<DataT>;\n\n/** Props added by the Tile3DLayer */\ntype _Tile3DLayerProps<DataT> = {\n  /** Color Accessor for point clouds. **/\n  getPointColor?: Accessor<DataT, Color>;\n\n  /** Global radius of all points in pixels. **/\n  pointSize?: number;\n\n  /** A loader which is used to decode the fetched tiles.\n   * @deprecated Use `loaders` instead\n   */\n  loader?: typeof Tiles3DLoader;\n\n  /** Called when Tileset JSON file is loaded. **/\n  onTilesetLoad?: (tile: Tileset3D) => void;\n\n  /** Called when a tile in the tileset hierarchy is loaded. **/\n  onTileLoad?: (tile: Tile3D) => void;\n\n  /** Called when a tile is unloaded. **/\n  onTileUnload?: (tile: Tile3D) => void;\n\n  /** Called when a tile fails to load. **/\n  onTileError?: (tile: Tile3D, url: string, message: string) => void;\n\n  /** (Experimental) Accessor to change color of mesh based on properties. **/\n  _getMeshColor?: (tile: Tile3D) => Color;\n};\n\n/** Render 3d tiles data formatted according to the [3D Tiles Specification](https://www.opengeospatial.org/standards/3DTiles) and [`ESRI I3S`](https://github.com/Esri/i3s-spec) */\nexport default class Tile3DLayer<DataT = any, ExtraPropsT = {}> extends CompositeLayer<\n  ExtraPropsT & Required<_Tile3DLayerProps<DataT>>\n> {\n  static defaultProps = defaultProps as any;\n  static layerName = 'Tile3DLayer';\n\n  state!: {\n    activeViewports: {};\n    frameNumber?: number;\n    lastUpdatedViewports: {[viewportId: string]: Viewport} | null;\n    layerMap: {[layerId: string]: any};\n    tileset3d: Tileset3D | null;\n  };\n\n  initializeState() {\n    if ('onTileLoadFail' in this.props) {\n      log.removed('onTileLoadFail', 'onTileError')();\n    }\n    // prop verification\n    this.state = {\n      layerMap: {},\n      tileset3d: null,\n      activeViewports: {},\n      lastUpdatedViewports: null\n    };\n  }\n\n  get isLoaded(): boolean {\n    const {tileset3d} = this.state;\n    return tileset3d !== null && tileset3d.isLoaded();\n  }\n\n  shouldUpdateState({changeFlags}: UpdateParameters<this>): boolean {\n    return changeFlags.somethingChanged;\n  }\n\n  updateState({props, oldProps, changeFlags}: UpdateParameters<this>): void {\n    if (props.data && props.data !== oldProps.data) {\n      this._loadTileset(props.data);\n    }\n\n    if (changeFlags.viewportChanged) {\n      const {activeViewports} = this.state;\n      const viewportsNumber = Object.keys(activeViewports).length;\n      if (viewportsNumber) {\n        this._updateTileset(activeViewports);\n        this.state.lastUpdatedViewports = activeViewports;\n        this.state.activeViewports = {};\n      }\n    }\n    if (changeFlags.propsChanged) {\n      const {layerMap} = this.state;\n      for (const key in layerMap) {\n        layerMap[key].needsUpdate = true;\n      }\n    }\n  }\n\n  activateViewport(viewport: Viewport): void {\n    const {activeViewports, lastUpdatedViewports} = this.state;\n    this.internalState!.viewport = viewport;\n\n    activeViewports[viewport.id] = viewport;\n    const lastViewport = lastUpdatedViewports?.[viewport.id];\n    if (!lastViewport || !viewport.equals(lastViewport)) {\n      this.setChangeFlags({viewportChanged: true});\n      this.setNeedsUpdate();\n    }\n  }\n\n  getPickingInfo({info, sourceLayer}: GetPickingInfoParams) {\n    const {layerMap} = this.state;\n    const layerId = sourceLayer && sourceLayer.id;\n    if (layerId) {\n      // layerId: this.id-[scenegraph|pointcloud]-tileId\n      const substr = layerId.substring(this.id.length + 1);\n      const tileId = substr.substring(substr.indexOf('-') + 1);\n      info.object = layerMap[tileId] && layerMap[tileId].tile;\n    }\n\n    return info;\n  }\n\n  filterSubLayer({layer, viewport}: FilterContext): boolean {\n    // All sublayers will have a tile prop\n    const {tile} = layer.props as unknown as {tile: Tile3D};\n    const {id: viewportId} = viewport;\n    return tile.selected && tile.viewportIds.includes(viewportId);\n  }\n\n  protected _updateAutoHighlight(info: PickingInfo): void {\n    if (info.sourceLayer) {\n      info.sourceLayer.updateAutoHighlight(info);\n    }\n  }\n\n  private async _loadTileset(tilesetUrl) {\n    const {loadOptions = {}} = this.props;\n\n    // TODO: deprecate `loader` in v9.0\n    // @ts-ignore\n    let loader = this.props.loader || this.props.loaders;\n    if (Array.isArray(loader)) {\n      loader = loader[0];\n    }\n\n    const options = {loadOptions: {...loadOptions}};\n    if (loader.preload) {\n      const preloadOptions = await loader.preload(tilesetUrl, loadOptions);\n\n      if (preloadOptions.headers) {\n        options.loadOptions.fetch = {\n          ...options.loadOptions.fetch,\n          headers: preloadOptions.headers\n        };\n      }\n      Object.assign(options, preloadOptions);\n    }\n    const tilesetJson = await load(tilesetUrl, loader, options.loadOptions);\n\n    const tileset3d = new Tileset3D(tilesetJson, {\n      onTileLoad: this._onTileLoad.bind(this),\n      onTileUnload: this._onTileUnload.bind(this),\n      onTileError: this.props.onTileError,\n      ...options\n    });\n\n    this.setState({\n      tileset3d,\n      layerMap: {}\n    });\n\n    this._updateTileset(this.state.activeViewports);\n    this.props.onTilesetLoad(tileset3d);\n  }\n\n  private _onTileLoad(tileHeader: Tile3D): void {\n    const {lastUpdatedViewports} = this.state;\n    this.props.onTileLoad(tileHeader);\n    this._updateTileset(lastUpdatedViewports);\n    this.setNeedsUpdate();\n  }\n\n  private _onTileUnload(tileHeader: Tile3D): void {\n    // Was cleaned up from tileset cache. We no longer need to track it.\n    delete this.state.layerMap[tileHeader.id];\n    this.props.onTileUnload(tileHeader);\n  }\n\n  private _updateTileset(viewports: {[viewportId: string]: Viewport} | null): void {\n    if (!viewports) {\n      return;\n    }\n    const {tileset3d} = this.state;\n    const {timeline} = this.context;\n    const viewportsNumber = Object.keys(viewports).length;\n    if (!timeline || !viewportsNumber || !tileset3d) {\n      return;\n    }\n    tileset3d.selectTiles(Object.values(viewports)).then(frameNumber => {\n      const tilesetChanged = this.state.frameNumber !== frameNumber;\n      if (tilesetChanged) {\n        this.setState({frameNumber});\n      }\n    });\n  }\n\n  private _getSubLayer(\n    tileHeader: Tile3D,\n    oldLayer?: Layer\n  ): MeshLayer<DataT> | PointCloudLayer<DataT> | ScenegraphLayer<DataT> | null {\n    if (!tileHeader.content) {\n      return null;\n    }\n\n    switch (tileHeader.type) {\n      case TILE_TYPE.POINTCLOUD:\n        return this._makePointCloudLayer(tileHeader, oldLayer as PointCloudLayer<DataT>);\n      case TILE_TYPE.SCENEGRAPH:\n        return this._make3DModelLayer(tileHeader);\n      case TILE_TYPE.MESH:\n        return this._makeSimpleMeshLayer(tileHeader, oldLayer as MeshLayer<DataT>);\n      default:\n        throw new Error(`Tile3DLayer: Failed to render layer of type ${tileHeader.content.type}`);\n    }\n  }\n\n  private _makePointCloudLayer(\n    tileHeader: Tile3D,\n    oldLayer?: PointCloudLayer<DataT>\n  ): PointCloudLayer<DataT> | null {\n    const {attributes, pointCount, constantRGBA, cartographicOrigin, modelMatrix} =\n      tileHeader.content;\n    const {positions, normals, colors} = attributes;\n\n    if (!positions) {\n      return null;\n    }\n    const data = (oldLayer && oldLayer.props.data) || {\n      header: {\n        vertexCount: pointCount\n      },\n      attributes: {\n        POSITION: positions,\n        NORMAL: normals,\n        COLOR_0: colors\n      }\n    };\n\n    const {pointSize, getPointColor} = this.props;\n    const SubLayerClass = this.getSubLayerClass('pointcloud', PointCloudLayer);\n    return new SubLayerClass(\n      {\n        pointSize\n      },\n      this.getSubLayerProps({\n        id: 'pointcloud'\n      }),\n      {\n        id: `${this.id}-pointcloud-${tileHeader.id}`,\n        tile: tileHeader,\n        data,\n        coordinateSystem: COORDINATE_SYSTEM.METER_OFFSETS,\n        coordinateOrigin: cartographicOrigin,\n        modelMatrix,\n        getColor: constantRGBA || getPointColor,\n        _offset: 0\n      }\n    );\n  }\n\n  private _make3DModelLayer(tileHeader: Tile3D): ScenegraphLayer<DataT> {\n    const {gltf, instances, cartographicOrigin, modelMatrix} = tileHeader.content;\n\n    const SubLayerClass = this.getSubLayerClass('scenegraph', ScenegraphLayer);\n\n    return new SubLayerClass(\n      {\n        _lighting: 'pbr'\n      },\n      this.getSubLayerProps({\n        id: 'scenegraph'\n      }),\n      {\n        id: `${this.id}-scenegraph-${tileHeader.id}`,\n        tile: tileHeader,\n        data: instances || SINGLE_DATA,\n        scenegraph: gltf,\n\n        coordinateSystem: COORDINATE_SYSTEM.METER_OFFSETS,\n        coordinateOrigin: cartographicOrigin,\n        modelMatrix,\n        getTransformMatrix: instance => instance.modelMatrix,\n        getPosition: [0, 0, 0],\n        _offset: 0\n      }\n    );\n  }\n\n  private _makeSimpleMeshLayer(tileHeader: Tile3D, oldLayer?: MeshLayer<DataT>): MeshLayer<DataT> {\n    const content = tileHeader.content;\n    const {\n      attributes,\n      indices,\n      modelMatrix,\n      cartographicOrigin,\n      coordinateSystem = COORDINATE_SYSTEM.METER_OFFSETS,\n      material,\n      featureIds\n    } = content;\n    const {_getMeshColor} = this.props;\n\n    const geometry =\n      (oldLayer && oldLayer.props.mesh) ||\n      new Geometry({\n        drawMode: GL.TRIANGLES,\n        attributes: getMeshGeometry(attributes),\n        indices\n      });\n\n    const SubLayerClass = this.getSubLayerClass('mesh', MeshLayer);\n\n    return new SubLayerClass(\n      this.getSubLayerProps({\n        id: 'mesh'\n      }),\n      {\n        id: `${this.id}-mesh-${tileHeader.id}`,\n        tile: tileHeader,\n        mesh: geometry,\n        data: SINGLE_DATA,\n        getColor: _getMeshColor(tileHeader),\n        pbrMaterial: material,\n        modelMatrix,\n        coordinateOrigin: cartographicOrigin,\n        coordinateSystem,\n        featureIds,\n        _offset: 0\n      }\n    );\n  }\n\n  renderLayers(): Layer | null | LayersList {\n    const {tileset3d, layerMap} = this.state;\n    if (!tileset3d) {\n      return null;\n    }\n\n    // loaders.gl doesn't provide a type for tileset3d.tiles\n    return (tileset3d.tiles as Tile3D[])\n      .map(tile => {\n        const layerCache = (layerMap[tile.id] = layerMap[tile.id] || {tile});\n        let {layer} = layerCache;\n        if (tile.selected) {\n          // render selected tiles\n          if (!layer) {\n            // create layer\n            layer = this._getSubLayer(tile);\n          } else if (layerCache.needsUpdate) {\n            // props have changed, rerender layer\n            layer = this._getSubLayer(tile, layer);\n            layerCache.needsUpdate = false;\n          }\n        }\n        layerCache.layer = layer;\n        return layer;\n      })\n      .filter(Boolean);\n  }\n}\n\nfunction getMeshGeometry(contentAttributes: MeshAttributes): MeshAttributes {\n  const attributes: MeshAttributes = {};\n  attributes.positions = {\n    ...contentAttributes.positions,\n    value: new Float32Array(contentAttributes.positions.value)\n  };\n  if (contentAttributes.normals) {\n    attributes.normals = contentAttributes.normals;\n  }\n  if (contentAttributes.texCoords) {\n    attributes.texCoords = contentAttributes.texCoords;\n  }\n  if (contentAttributes.colors) {\n    attributes.colors = contentAttributes.colors;\n  }\n  if (contentAttributes.uvRegions) {\n    attributes.uvRegions = contentAttributes.uvRegions;\n  }\n  return attributes;\n}\n","export const VERSION = typeof \"3.2.10\" !== 'undefined' ? \"3.2.10\" : 'latest';\n//# sourceMappingURL=version.js.map","import { VERSION } from './lib/utils/version';\nexport const TerrainLoader = {\n  name: 'Terrain',\n  id: 'terrain',\n  module: 'terrain',\n  version: VERSION,\n  worker: true,\n  extensions: ['png', 'pngraw', 'jpg', 'jpeg', 'gif', 'webp', 'bmp'],\n  mimeTypes: ['image/png', 'image/jpeg', 'image/gif', 'image/webp', 'image/bmp'],\n  options: {\n    terrain: {\n      tesselator: 'auto',\n      bounds: null,\n      meshMaxError: 10,\n      elevationDecoder: {\n        rScaler: 1,\n        gScaler: 0,\n        bScaler: 0,\n        offset: 0\n      },\n      skirtHeight: null\n    }\n  }\n};\nexport const _typecheckTerrainWorkerLoader = TerrainLoader;\n//# sourceMappingURL=terrain-loader.js.map","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {\n  Color,\n  CompositeLayer,\n  CompositeLayerProps,\n  DefaultProps,\n  Layer,\n  LayersList,\n  log,\n  Material,\n  Texture,\n  UpdateParameters\n} from '@deck.gl/core';\nimport {SimpleMeshLayer} from '@deck.gl/mesh-layers';\nimport {COORDINATE_SYSTEM} from '@deck.gl/core';\nimport type {MeshAttributes} from '@loaders.gl/schema';\nimport {TerrainWorkerLoader} from '@loaders.gl/terrain';\nimport TileLayer, {TileLayerProps} from '../tile-layer/tile-layer';\nimport Tile2DHeader from '../tile-layer/tile-2d-header';\nimport {Bounds, GeoBoundingBox, TileBoundingBox, TileLoadProps, ZRange} from '../tile-layer/types';\nimport {urlType, getURLFromTemplate} from '../tile-layer/utils';\n\nconst DUMMY_DATA = [1];\n\nconst defaultProps: DefaultProps<TerrainLayerProps> = {\n  ...TileLayer.defaultProps,\n  // Image url that encodes height data\n  elevationData: urlType,\n  // Image url to use as texture\n  texture: {...urlType, optional: true},\n  // Martini error tolerance in meters, smaller number -> more detailed mesh\n  meshMaxError: {type: 'number', value: 4.0},\n  // Bounding box of the terrain image, [minX, minY, maxX, maxY] in world coordinates\n  bounds: {type: 'array', value: null, optional: true, compare: true},\n  // Color to use if texture is unavailable\n  color: {type: 'color', value: [255, 255, 255]},\n  // Object to decode height data, from (r, g, b) to height in meters\n  elevationDecoder: {\n    type: 'object',\n    value: {\n      rScaler: 1,\n      gScaler: 0,\n      bScaler: 0,\n      offset: 0\n    }\n  },\n  // Supply url to local terrain worker bundle. Only required if running offline and cannot access CDN.\n  workerUrl: {type: 'string', value: null},\n  // Same as SimpleMeshLayer wireframe\n  wireframe: false,\n  material: true,\n\n  loaders: [TerrainWorkerLoader]\n};\n\ntype URLTemplate = string | string[];\n\n// Turns array of templates into a single string to work around shallow change\nfunction urlTemplateToUpdateTrigger(template: URLTemplate | null): string {\n  if (Array.isArray(template)) {\n    return template.join(';');\n  }\n  return template || '';\n}\n\ntype ElevationDecoder = {rScaler: number; gScaler: number; bScaler: number; offset: number};\ntype TerrainLoadProps = {\n  bounds: Bounds;\n  elevationData: string | null;\n  elevationDecoder: ElevationDecoder;\n  meshMaxError: number;\n  signal?: AbortSignal;\n};\n\ntype MeshAndTexture = [MeshAttributes | null, Texture | null];\n\n/** All properties supported by TerrainLayer */\nexport type TerrainLayerProps = _TerrainLayerProps &\n  TileLayerProps<MeshAndTexture> &\n  CompositeLayerProps;\n\n/** Props added by the TerrainLayer */\ntype _TerrainLayerProps = {\n  /** Image url that encodes height data. **/\n  elevationData: URLTemplate;\n\n  /** Image url to use as texture. **/\n  texture?: URLTemplate | null;\n\n  /** Martini error tolerance in meters, smaller number -> more detailed mesh. **/\n  meshMaxError?: number;\n\n  /** Bounding box of the terrain image, [minX, minY, maxX, maxY] in world coordinates. **/\n  bounds?: Bounds | null;\n\n  /** Color to use if texture is unavailable. **/\n  color?: Color;\n\n  /** Object to decode height data, from (r, g, b) to height in meters. **/\n  elevationDecoder?: ElevationDecoder;\n\n  /** Whether to render the mesh in wireframe mode. **/\n  wireframe?: boolean;\n\n  /** Material props for lighting effect. **/\n  material?: Material;\n};\n\n/** Render mesh surfaces from height map images. */\nexport default class TerrainLayer<ExtraPropsT = {}> extends CompositeLayer<\n  ExtraPropsT & Required<_TerrainLayerProps & Required<TileLayerProps<MeshAndTexture>>>\n> {\n  static defaultProps = defaultProps;\n  static layerName = 'TerrainLayer';\n\n  state!: {\n    isTiled?: boolean;\n    terrain: MeshAttributes;\n    zRange?: ZRange | null;\n  };\n\n  updateState({props, oldProps}: UpdateParameters<this>): void {\n    const elevationDataChanged = props.elevationData !== oldProps.elevationData;\n    if (elevationDataChanged) {\n      const {elevationData} = props;\n      const isTiled =\n        elevationData &&\n        (Array.isArray(elevationData) ||\n          (elevationData.includes('{x}') && elevationData.includes('{y}')));\n      this.setState({isTiled});\n    }\n\n    // Reloading for single terrain mesh\n    const shouldReload =\n      elevationDataChanged ||\n      props.meshMaxError !== oldProps.meshMaxError ||\n      props.elevationDecoder !== oldProps.elevationDecoder ||\n      props.bounds !== oldProps.bounds;\n\n    if (!this.state.isTiled && shouldReload) {\n      // When state.isTiled, elevationData cannot be an array\n      const terrain = this.loadTerrain(props as TerrainLoadProps);\n      this.setState({terrain});\n    }\n\n    // TODO - remove in v9\n    // @ts-ignore\n    if (props.workerUrl) {\n      log.removed('workerUrl', 'loadOptions.terrain.workerUrl')();\n    }\n  }\n\n  loadTerrain({\n    elevationData,\n    bounds,\n    elevationDecoder,\n    meshMaxError,\n    signal\n  }: TerrainLoadProps): Promise<MeshAttributes> | null {\n    if (!elevationData) {\n      return null;\n    }\n    let loadOptions = this.getLoadOptions();\n    loadOptions = {\n      ...loadOptions,\n      terrain: {\n        skirtHeight: this.state.isTiled ? meshMaxError * 2 : 0,\n        ...loadOptions?.terrain,\n        bounds,\n        meshMaxError,\n        elevationDecoder\n      }\n    };\n    const {fetch} = this.props;\n    return fetch(elevationData, {propName: 'elevationData', layer: this, loadOptions, signal});\n  }\n\n  getTiledTerrainData(tile: TileLoadProps): Promise<MeshAndTexture> {\n    const {elevationData, fetch, texture, elevationDecoder, meshMaxError} = this.props;\n    const {viewport} = this.context;\n    const dataUrl = getURLFromTemplate(elevationData, tile);\n    const textureUrl = texture && getURLFromTemplate(texture, tile);\n\n    const {signal} = tile;\n    let bottomLeft = [0, 0] as [number, number];\n    let topRight = [0, 0] as [number, number];\n    if (viewport.isGeospatial) {\n      const bbox = tile.bbox as GeoBoundingBox;\n      bottomLeft = viewport.projectFlat([bbox.west, bbox.south]);\n      topRight = viewport.projectFlat([bbox.east, bbox.north]);\n    } else {\n      const bbox = tile.bbox as Exclude<TileBoundingBox, GeoBoundingBox>;\n      bottomLeft = [bbox.left, bbox.bottom];\n      topRight = [bbox.right, bbox.top];\n    }\n    const bounds: Bounds = [bottomLeft[0], bottomLeft[1], topRight[0], topRight[1]];\n\n    const terrain = this.loadTerrain({\n      elevationData: dataUrl,\n      bounds,\n      elevationDecoder,\n      meshMaxError,\n      signal\n    });\n    const surface = textureUrl\n      ? // If surface image fails to load, the tile should still be displayed\n        fetch(textureUrl, {propName: 'texture', layer: this, loaders: [], signal}).catch(_ => null)\n      : Promise.resolve(null);\n\n    return Promise.all([terrain, surface]);\n  }\n\n  renderSubLayers(\n    props: TileLayerProps<MeshAndTexture> & {\n      id: string;\n      data: MeshAndTexture;\n      tile: Tile2DHeader<MeshAndTexture>;\n    }\n  ) {\n    const SubLayerClass = this.getSubLayerClass('mesh', SimpleMeshLayer);\n\n    const {color, wireframe, material} = this.props;\n    const {data} = props;\n\n    if (!data) {\n      return null;\n    }\n\n    const [mesh, texture] = data;\n\n    return new SubLayerClass(props, {\n      data: DUMMY_DATA,\n      mesh,\n      texture,\n      _instanced: false,\n      coordinateSystem: COORDINATE_SYSTEM.CARTESIAN,\n      getPosition: d => [0, 0, 0],\n      getColor: color,\n      wireframe,\n      material\n    });\n  }\n\n  // Update zRange of viewport\n  onViewportLoad(tiles?: Tile2DHeader<MeshAndTexture>[]): void {\n    if (!tiles) {\n      return;\n    }\n\n    const {zRange} = this.state;\n    const ranges = tiles\n      .map(tile => tile.content)\n      .filter(Boolean)\n      .map(arr => {\n        // @ts-ignore\n        const bounds = arr[0].header.boundingBox;\n        return bounds.map(bound => bound[2]);\n      });\n    if (ranges.length === 0) {\n      return;\n    }\n    const minZ = Math.min(...ranges.map(x => x[0]));\n    const maxZ = Math.max(...ranges.map(x => x[1]));\n\n    if (!zRange || minZ < zRange[0] || maxZ > zRange[1]) {\n      this.setState({zRange: [minZ, maxZ]});\n    }\n  }\n\n  renderLayers(): Layer | null | LayersList {\n    const {\n      color,\n      material,\n      elevationData,\n      texture,\n      wireframe,\n      meshMaxError,\n      elevationDecoder,\n      tileSize,\n      maxZoom,\n      minZoom,\n      extent,\n      maxRequests,\n      onTileLoad,\n      onTileUnload,\n      onTileError,\n      maxCacheSize,\n      maxCacheByteSize,\n      refinementStrategy\n    } = this.props;\n\n    if (this.state.isTiled) {\n      return new TileLayer<MeshAndTexture>(\n        this.getSubLayerProps({\n          id: 'tiles'\n        }),\n        {\n          getTileData: this.getTiledTerrainData.bind(this),\n          renderSubLayers: this.renderSubLayers.bind(this),\n          updateTriggers: {\n            getTileData: {\n              elevationData: urlTemplateToUpdateTrigger(elevationData),\n              texture: urlTemplateToUpdateTrigger(texture),\n              meshMaxError,\n              elevationDecoder\n            }\n          },\n          onViewportLoad: this.onViewportLoad.bind(this),\n          zRange: this.state.zRange || null,\n          tileSize,\n          maxZoom,\n          minZoom,\n          extent,\n          maxRequests,\n          onTileLoad,\n          onTileUnload,\n          onTileError,\n          maxCacheSize,\n          maxCacheByteSize,\n          refinementStrategy\n        }\n      );\n    }\n\n    const SubLayerClass = this.getSubLayerClass('mesh', SimpleMeshLayer);\n    return new SubLayerClass(\n      this.getSubLayerProps({\n        id: 'mesh'\n      }),\n      {\n        data: DUMMY_DATA,\n        mesh: this.state.terrain,\n        texture,\n        _instanced: false,\n        getPosition: d => [0, 0, 0],\n        getColor: color,\n        material,\n        wireframe\n      }\n    );\n  }\n}\n","import { earcut } from '@math.gl/polygon';\nexport function flatGeojsonToBinary(features, geometryInfo, options) {\n  const propArrayTypes = extractNumericPropTypes(features);\n  const numericPropKeys = Object.keys(propArrayTypes).filter(k => propArrayTypes[k] !== Array);\n  return fillArrays(features, {\n    propArrayTypes,\n    ...geometryInfo\n  }, {\n    numericPropKeys: options && options.numericPropKeys || numericPropKeys,\n    PositionDataType: options ? options.PositionDataType : Float32Array\n  });\n}\nexport const TEST_EXPORTS = {\n  extractNumericPropTypes\n};\n\nfunction extractNumericPropTypes(features) {\n  const propArrayTypes = {};\n\n  for (const feature of features) {\n    if (feature.properties) {\n      for (const key in feature.properties) {\n        const val = feature.properties[key];\n        propArrayTypes[key] = deduceArrayType(val, propArrayTypes[key]);\n      }\n    }\n  }\n\n  return propArrayTypes;\n}\n\nfunction fillArrays(features, geometryInfo, options) {\n  const {\n    pointPositionsCount,\n    pointFeaturesCount,\n    linePositionsCount,\n    linePathsCount,\n    lineFeaturesCount,\n    polygonPositionsCount,\n    polygonObjectsCount,\n    polygonRingsCount,\n    polygonFeaturesCount,\n    propArrayTypes,\n    coordLength\n  } = geometryInfo;\n  const {\n    numericPropKeys = [],\n    PositionDataType = Float32Array\n  } = options;\n  const hasGlobalId = features[0] && 'id' in features[0];\n  const GlobalFeatureIdsDataType = features.length > 65535 ? Uint32Array : Uint16Array;\n  const points = {\n    type: 'Point',\n    positions: new PositionDataType(pointPositionsCount * coordLength),\n    globalFeatureIds: new GlobalFeatureIdsDataType(pointPositionsCount),\n    featureIds: pointFeaturesCount > 65535 ? new Uint32Array(pointPositionsCount) : new Uint16Array(pointPositionsCount),\n    numericProps: {},\n    properties: [],\n    fields: []\n  };\n  const lines = {\n    type: 'LineString',\n    pathIndices: linePositionsCount > 65535 ? new Uint32Array(linePathsCount + 1) : new Uint16Array(linePathsCount + 1),\n    positions: new PositionDataType(linePositionsCount * coordLength),\n    globalFeatureIds: new GlobalFeatureIdsDataType(linePositionsCount),\n    featureIds: lineFeaturesCount > 65535 ? new Uint32Array(linePositionsCount) : new Uint16Array(linePositionsCount),\n    numericProps: {},\n    properties: [],\n    fields: []\n  };\n  const polygons = {\n    type: 'Polygon',\n    polygonIndices: polygonPositionsCount > 65535 ? new Uint32Array(polygonObjectsCount + 1) : new Uint16Array(polygonObjectsCount + 1),\n    primitivePolygonIndices: polygonPositionsCount > 65535 ? new Uint32Array(polygonRingsCount + 1) : new Uint16Array(polygonRingsCount + 1),\n    positions: new PositionDataType(polygonPositionsCount * coordLength),\n    triangles: [],\n    globalFeatureIds: new GlobalFeatureIdsDataType(polygonPositionsCount),\n    featureIds: polygonFeaturesCount > 65535 ? new Uint32Array(polygonPositionsCount) : new Uint16Array(polygonPositionsCount),\n    numericProps: {},\n    properties: [],\n    fields: []\n  };\n\n  for (const object of [points, lines, polygons]) {\n    for (const propName of numericPropKeys) {\n      const T = propArrayTypes[propName];\n      object.numericProps[propName] = new T(object.positions.length / coordLength);\n    }\n  }\n\n  lines.pathIndices[linePathsCount] = linePositionsCount;\n  polygons.polygonIndices[polygonObjectsCount] = polygonPositionsCount;\n  polygons.primitivePolygonIndices[polygonRingsCount] = polygonPositionsCount;\n  const indexMap = {\n    pointPosition: 0,\n    pointFeature: 0,\n    linePosition: 0,\n    linePath: 0,\n    lineFeature: 0,\n    polygonPosition: 0,\n    polygonObject: 0,\n    polygonRing: 0,\n    polygonFeature: 0,\n    feature: 0\n  };\n\n  for (const feature of features) {\n    const geometry = feature.geometry;\n    const properties = feature.properties || {};\n\n    switch (geometry.type) {\n      case 'Point':\n        handlePoint(geometry, points, indexMap, coordLength, properties);\n        points.properties.push(keepStringProperties(properties, numericPropKeys));\n\n        if (hasGlobalId) {\n          points.fields.push({\n            id: feature.id\n          });\n        }\n\n        indexMap.pointFeature++;\n        break;\n\n      case 'LineString':\n        handleLineString(geometry, lines, indexMap, coordLength, properties);\n        lines.properties.push(keepStringProperties(properties, numericPropKeys));\n\n        if (hasGlobalId) {\n          lines.fields.push({\n            id: feature.id\n          });\n        }\n\n        indexMap.lineFeature++;\n        break;\n\n      case 'Polygon':\n        handlePolygon(geometry, polygons, indexMap, coordLength, properties);\n        polygons.properties.push(keepStringProperties(properties, numericPropKeys));\n\n        if (hasGlobalId) {\n          polygons.fields.push({\n            id: feature.id\n          });\n        }\n\n        indexMap.polygonFeature++;\n        break;\n\n      default:\n        throw new Error('Invalid geometry type');\n    }\n\n    indexMap.feature++;\n  }\n\n  return makeAccessorObjects(points, lines, polygons, coordLength);\n}\n\nfunction handlePoint(geometry, points, indexMap, coordLength, properties) {\n  points.positions.set(geometry.data, indexMap.pointPosition * coordLength);\n  const nPositions = geometry.data.length / coordLength;\n  fillNumericProperties(points, properties, indexMap.pointPosition, nPositions);\n  points.globalFeatureIds.fill(indexMap.feature, indexMap.pointPosition, indexMap.pointPosition + nPositions);\n  points.featureIds.fill(indexMap.pointFeature, indexMap.pointPosition, indexMap.pointPosition + nPositions);\n  indexMap.pointPosition += nPositions;\n}\n\nfunction handleLineString(geometry, lines, indexMap, coordLength, properties) {\n  lines.positions.set(geometry.data, indexMap.linePosition * coordLength);\n  const nPositions = geometry.data.length / coordLength;\n  fillNumericProperties(lines, properties, indexMap.linePosition, nPositions);\n  lines.globalFeatureIds.fill(indexMap.feature, indexMap.linePosition, indexMap.linePosition + nPositions);\n  lines.featureIds.fill(indexMap.lineFeature, indexMap.linePosition, indexMap.linePosition + nPositions);\n\n  for (let i = 0, il = geometry.indices.length; i < il; ++i) {\n    const start = geometry.indices[i];\n    const end = i === il - 1 ? geometry.data.length : geometry.indices[i + 1];\n    lines.pathIndices[indexMap.linePath++] = indexMap.linePosition;\n    indexMap.linePosition += (end - start) / coordLength;\n  }\n}\n\nfunction handlePolygon(geometry, polygons, indexMap, coordLength, properties) {\n  polygons.positions.set(geometry.data, indexMap.polygonPosition * coordLength);\n  const nPositions = geometry.data.length / coordLength;\n  fillNumericProperties(polygons, properties, indexMap.polygonPosition, nPositions);\n  polygons.globalFeatureIds.fill(indexMap.feature, indexMap.polygonPosition, indexMap.polygonPosition + nPositions);\n  polygons.featureIds.fill(indexMap.polygonFeature, indexMap.polygonPosition, indexMap.polygonPosition + nPositions);\n\n  for (let l = 0, ll = geometry.indices.length; l < ll; ++l) {\n    const startPosition = indexMap.polygonPosition;\n    polygons.polygonIndices[indexMap.polygonObject++] = startPosition;\n    const areas = geometry.areas[l];\n    const indices = geometry.indices[l];\n    const nextIndices = geometry.indices[l + 1];\n\n    for (let i = 0, il = indices.length; i < il; ++i) {\n      const start = indices[i];\n      const end = i === il - 1 ? nextIndices === undefined ? geometry.data.length : nextIndices[0] : indices[i + 1];\n      polygons.primitivePolygonIndices[indexMap.polygonRing++] = indexMap.polygonPosition;\n      indexMap.polygonPosition += (end - start) / coordLength;\n    }\n\n    const endPosition = indexMap.polygonPosition;\n    triangulatePolygon(polygons, areas, indices, {\n      startPosition,\n      endPosition,\n      coordLength\n    });\n  }\n}\n\nfunction triangulatePolygon(polygons, areas, indices, {\n  startPosition,\n  endPosition,\n  coordLength\n}) {\n  const start = startPosition * coordLength;\n  const end = endPosition * coordLength;\n  const polygonPositions = polygons.positions.subarray(start, end);\n  const offset = indices[0];\n  const holes = indices.slice(1).map(n => (n - offset) / coordLength);\n  const triangles = earcut(polygonPositions, holes, coordLength, areas);\n\n  for (let t = 0, tl = triangles.length; t < tl; ++t) {\n    polygons.triangles.push(startPosition + triangles[t]);\n  }\n}\n\nfunction wrapProps(obj, size) {\n  const returnObj = {};\n\n  for (const key in obj) {\n    returnObj[key] = {\n      value: obj[key],\n      size\n    };\n  }\n\n  return returnObj;\n}\n\nfunction makeAccessorObjects(points, lines, polygons, coordLength) {\n  return {\n    points: { ...points,\n      positions: {\n        value: points.positions,\n        size: coordLength\n      },\n      globalFeatureIds: {\n        value: points.globalFeatureIds,\n        size: 1\n      },\n      featureIds: {\n        value: points.featureIds,\n        size: 1\n      },\n      numericProps: wrapProps(points.numericProps, 1)\n    },\n    lines: { ...lines,\n      positions: {\n        value: lines.positions,\n        size: coordLength\n      },\n      pathIndices: {\n        value: lines.pathIndices,\n        size: 1\n      },\n      globalFeatureIds: {\n        value: lines.globalFeatureIds,\n        size: 1\n      },\n      featureIds: {\n        value: lines.featureIds,\n        size: 1\n      },\n      numericProps: wrapProps(lines.numericProps, 1)\n    },\n    polygons: { ...polygons,\n      positions: {\n        value: polygons.positions,\n        size: coordLength\n      },\n      polygonIndices: {\n        value: polygons.polygonIndices,\n        size: 1\n      },\n      primitivePolygonIndices: {\n        value: polygons.primitivePolygonIndices,\n        size: 1\n      },\n      triangles: {\n        value: new Uint32Array(polygons.triangles),\n        size: 1\n      },\n      globalFeatureIds: {\n        value: polygons.globalFeatureIds,\n        size: 1\n      },\n      featureIds: {\n        value: polygons.featureIds,\n        size: 1\n      },\n      numericProps: wrapProps(polygons.numericProps, 1)\n    }\n  };\n}\n\nfunction fillNumericProperties(object, properties, index, length) {\n  for (const numericPropName in object.numericProps) {\n    if (numericPropName in properties) {\n      const value = properties[numericPropName];\n      object.numericProps[numericPropName].fill(value, index, index + length);\n    }\n  }\n}\n\nfunction keepStringProperties(properties, numericKeys) {\n  const props = {};\n\n  for (const key in properties) {\n    if (!numericKeys.includes(key)) {\n      props[key] = properties[key];\n    }\n  }\n\n  return props;\n}\n\nfunction deduceArrayType(x, constructor) {\n  if (constructor === Array || !Number.isFinite(x)) {\n    return Array;\n  }\n\n  return constructor === Float64Array || Math.fround(x) !== x ? Float64Array : Float32Array;\n}\n//# sourceMappingURL=flat-geojson-to-binary.js.map","export function classifyRings(rings) {\n  const len = rings.length;\n  if (len <= 1) return [rings];\n  const polygons = [];\n  let polygon;\n  let ccw;\n\n  for (let i = 0; i < len; i++) {\n    const area = signedArea(rings[i]);\n    if (area === 0) continue;\n    if (ccw === undefined) ccw = area < 0;\n\n    if (ccw === area < 0) {\n      if (polygon) polygons.push(polygon);\n      polygon = [rings[i]];\n    } else if (polygon) polygon.push(rings[i]);\n  }\n\n  if (polygon) polygons.push(polygon);\n  return polygons;\n}\nexport function signedArea(ring) {\n  let sum = 0;\n\n  for (let i = 0, j = ring.length - 1, p1, p2; i < ring.length; j = i++) {\n    p1 = ring[i];\n    p2 = ring[j];\n    sum += (p2[0] - p1[0]) * (p1[1] + p2[1]);\n  }\n\n  return sum;\n}\nexport function readFeature(tag, feature, pbf) {\n  if (feature && pbf) {\n    if (tag === 1) feature.id = pbf.readVarint();else if (tag === 2) readTag(pbf, feature);else if (tag === 3) feature.type = pbf.readVarint();else if (tag === 4) feature._geometry = pbf.pos;\n  }\n}\nexport function readTag(pbf, feature) {\n  const end = pbf.readVarint() + pbf.pos;\n\n  while (pbf.pos < end) {\n    const key = feature._keys[pbf.readVarint()];\n\n    const value = feature._values[pbf.readVarint()];\n\n    feature.properties[key] = value;\n  }\n}\n//# sourceMappingURL=mapbox-util-functions.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { readFeature, classifyRings } from '../../helpers/mapbox-util-functions';\nexport default class VectorTileFeature {\n  static get types() {\n    return ['Unknown', 'Point', 'LineString', 'Polygon'];\n  }\n\n  constructor(pbf, end, extent, keys, values) {\n    _defineProperty(this, \"properties\", void 0);\n\n    _defineProperty(this, \"extent\", void 0);\n\n    _defineProperty(this, \"type\", void 0);\n\n    _defineProperty(this, \"id\", void 0);\n\n    _defineProperty(this, \"_pbf\", void 0);\n\n    _defineProperty(this, \"_geometry\", void 0);\n\n    _defineProperty(this, \"_keys\", void 0);\n\n    _defineProperty(this, \"_values\", void 0);\n\n    this.properties = {};\n    this.extent = extent;\n    this.type = 0;\n    this.id = null;\n    this._pbf = pbf;\n    this._geometry = -1;\n    this._keys = keys;\n    this._values = values;\n    pbf.readFields(readFeature, this, end);\n  }\n\n  loadGeometry() {\n    const pbf = this._pbf;\n    pbf.pos = this._geometry;\n    const end = pbf.readVarint() + pbf.pos;\n    let cmd = 1;\n    let length = 0;\n    let x = 0;\n    let y = 0;\n    const lines = [];\n    let line;\n\n    while (pbf.pos < end) {\n      if (length <= 0) {\n        const cmdLen = pbf.readVarint();\n        cmd = cmdLen & 0x7;\n        length = cmdLen >> 3;\n      }\n\n      length--;\n\n      if (cmd === 1 || cmd === 2) {\n        x += pbf.readSVarint();\n        y += pbf.readSVarint();\n\n        if (cmd === 1) {\n          if (line) lines.push(line);\n          line = [];\n        }\n\n        if (line) line.push([x, y]);\n      } else if (cmd === 7) {\n        if (line) {\n          line.push(line[0].slice());\n        }\n      } else {\n        throw new Error(\"unknown command \".concat(cmd));\n      }\n    }\n\n    if (line) lines.push(line);\n    return lines;\n  }\n\n  bbox() {\n    const pbf = this._pbf;\n    pbf.pos = this._geometry;\n    const end = pbf.readVarint() + pbf.pos;\n    let cmd = 1;\n    let length = 0;\n    let x = 0;\n    let y = 0;\n    let x1 = Infinity;\n    let x2 = -Infinity;\n    let y1 = Infinity;\n    let y2 = -Infinity;\n\n    while (pbf.pos < end) {\n      if (length <= 0) {\n        const cmdLen = pbf.readVarint();\n        cmd = cmdLen & 0x7;\n        length = cmdLen >> 3;\n      }\n\n      length--;\n\n      if (cmd === 1 || cmd === 2) {\n        x += pbf.readSVarint();\n        y += pbf.readSVarint();\n        if (x < x1) x1 = x;\n        if (x > x2) x2 = x;\n        if (y < y1) y1 = y;\n        if (y > y2) y2 = y;\n      } else if (cmd !== 7) {\n        throw new Error(\"unknown command \".concat(cmd));\n      }\n    }\n\n    return [x1, y1, x2, y2];\n  }\n\n  _toGeoJSON(transform) {\n    let coords = this.loadGeometry();\n    let type = VectorTileFeature.types[this.type];\n    let i;\n    let j;\n\n    switch (this.type) {\n      case 1:\n        const points = [];\n\n        for (i = 0; i < coords.length; i++) {\n          points[i] = coords[i][0];\n        }\n\n        coords = points;\n        transform(coords, this);\n        break;\n\n      case 2:\n        for (i = 0; i < coords.length; i++) {\n          transform(coords[i], this);\n        }\n\n        break;\n\n      case 3:\n        coords = classifyRings(coords);\n\n        for (i = 0; i < coords.length; i++) {\n          for (j = 0; j < coords[i].length; j++) {\n            transform(coords[i][j], this);\n          }\n        }\n\n        break;\n    }\n\n    if (coords.length === 1) {\n      coords = coords[0];\n    } else {\n      type = \"Multi\".concat(type);\n    }\n\n    const result = {\n      type: 'Feature',\n      geometry: {\n        type,\n        coordinates: coords\n      },\n      properties: this.properties\n    };\n\n    if (this.id !== null) {\n      result.id = this.id;\n    }\n\n    return result;\n  }\n\n  toGeoJSON(options) {\n    if (typeof options === 'function') {\n      return this._toGeoJSON(options);\n    }\n\n    const {\n      x,\n      y,\n      z\n    } = options;\n    const size = this.extent * Math.pow(2, z);\n    const x0 = this.extent * x;\n    const y0 = this.extent * y;\n\n    function project(line) {\n      for (let j = 0; j < line.length; j++) {\n        const p = line[j];\n        p[0] = (p[0] + x0) * 360 / size - 180;\n        const y2 = 180 - (p[1] + y0) * 360 / size;\n        p[1] = 360 / Math.PI * Math.atan(Math.exp(y2 * Math.PI / 180)) - 90;\n      }\n    }\n\n    return this._toGeoJSON(project);\n  }\n\n}\n//# sourceMappingURL=vector-tile-feature.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport VectorTileFeature from './vector-tile-feature';\nexport default class VectorTileLayer {\n  constructor(pbf, end) {\n    _defineProperty(this, \"version\", void 0);\n\n    _defineProperty(this, \"name\", void 0);\n\n    _defineProperty(this, \"extent\", void 0);\n\n    _defineProperty(this, \"length\", void 0);\n\n    _defineProperty(this, \"_pbf\", void 0);\n\n    _defineProperty(this, \"_keys\", void 0);\n\n    _defineProperty(this, \"_values\", void 0);\n\n    _defineProperty(this, \"_features\", void 0);\n\n    this.version = 1;\n    this.name = '';\n    this.extent = 4096;\n    this.length = 0;\n    this._pbf = pbf;\n    this._keys = [];\n    this._values = [];\n    this._features = [];\n    pbf.readFields(readLayer, this, end);\n    this.length = this._features.length;\n  }\n\n  feature(i) {\n    if (i < 0 || i >= this._features.length) {\n      throw new Error('feature index out of bounds');\n    }\n\n    this._pbf.pos = this._features[i];\n\n    const end = this._pbf.readVarint() + this._pbf.pos;\n\n    return new VectorTileFeature(this._pbf, end, this.extent, this._keys, this._values);\n  }\n\n}\n\nfunction readLayer(tag, layer, pbf) {\n  if (layer && pbf) {\n    if (tag === 15) layer.version = pbf.readVarint();else if (tag === 1) layer.name = pbf.readString();else if (tag === 5) layer.extent = pbf.readVarint();else if (tag === 2) layer._features.push(pbf.pos);else if (tag === 3) layer._keys.push(pbf.readString());else if (tag === 4) layer._values.push(readValueMessage(pbf));\n  }\n}\n\nfunction readValueMessage(pbf) {\n  let value = null;\n  const end = pbf.readVarint() + pbf.pos;\n\n  while (pbf.pos < end) {\n    const tag = pbf.readVarint() >> 3;\n    value = tag === 1 ? pbf.readString() : tag === 2 ? pbf.readFloat() : tag === 3 ? pbf.readDouble() : tag === 4 ? pbf.readVarint64() : tag === 5 ? pbf.readVarint() : tag === 6 ? pbf.readSVarint() : tag === 7 ? pbf.readBoolean() : null;\n  }\n\n  return value;\n}\n//# sourceMappingURL=vector-tile-layer.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport VectorTileLayer from './vector-tile-layer';\nexport default class VectorTile {\n  constructor(pbf, end) {\n    _defineProperty(this, \"layers\", void 0);\n\n    this.layers = pbf.readFields(readTile, {}, end);\n  }\n\n}\n\nfunction readTile(tag, layers, pbf) {\n  if (tag === 3) {\n    if (pbf) {\n      const layer = new VectorTileLayer(pbf, pbf.readVarint() + pbf.pos);\n\n      if (layer.length && layers) {\n        layers[layer.name] = layer;\n      }\n    }\n  }\n}\n//# sourceMappingURL=vector-tile.js.map","import { getPolygonSignedArea } from '@math.gl/polygon';\nexport function classifyRings(geom) {\n  const len = geom.indices.length;\n  const type = 'Polygon';\n\n  if (len <= 1) {\n    return {\n      type,\n      data: geom.data,\n      areas: [[getPolygonSignedArea(geom.data)]],\n      indices: [geom.indices]\n    };\n  }\n\n  const areas = [];\n  const polygons = [];\n  let ringAreas = [];\n  let polygon = [];\n  let ccw;\n  let offset = 0;\n\n  for (let endIndex, i = 0, startIndex; i < len; i++) {\n    startIndex = geom.indices[i] - offset;\n    endIndex = geom.indices[i + 1] - offset || geom.data.length;\n    const shape = geom.data.slice(startIndex, endIndex);\n    const area = getPolygonSignedArea(shape);\n\n    if (area === 0) {\n      const before = geom.data.slice(0, startIndex);\n      const after = geom.data.slice(endIndex);\n      geom.data = before.concat(after);\n      offset += endIndex - startIndex;\n      continue;\n    }\n\n    if (ccw === undefined) ccw = area < 0;\n\n    if (ccw === area < 0) {\n      if (polygon.length) {\n        areas.push(ringAreas);\n        polygons.push(polygon);\n      }\n\n      polygon = [startIndex];\n      ringAreas = [area];\n    } else {\n      ringAreas.push(area);\n      polygon.push(startIndex);\n    }\n  }\n\n  if (ringAreas) areas.push(ringAreas);\n  if (polygon.length) polygons.push(polygon);\n  return {\n    type,\n    areas,\n    indices: polygons,\n    data: geom.data\n  };\n}\nexport function project(data, x0, y0, size) {\n  for (let j = 0, jl = data.length; j < jl; j += 2) {\n    data[j] = (data[j] + x0) * 360 / size - 180;\n    const y2 = 180 - (data[j + 1] + y0) * 360 / size;\n    data[j + 1] = 360 / Math.PI * Math.atan(Math.exp(y2 * Math.PI / 180)) - 90;\n  }\n}\nexport function readFeature(tag, feature, pbf) {\n  if (feature && pbf) {\n    if (tag === 1) feature.id = pbf.readVarint();else if (tag === 2) readTag(pbf, feature);else if (tag === 3) feature.type = pbf.readVarint();else if (tag === 4) feature._geometry = pbf.pos;\n  }\n}\nexport function readTag(pbf, feature) {\n  const end = pbf.readVarint() + pbf.pos;\n\n  while (pbf.pos < end) {\n    const key = feature._keys[pbf.readVarint()];\n\n    const value = feature._values[pbf.readVarint()];\n\n    feature.properties[key] = value;\n  }\n}\n//# sourceMappingURL=binary-util-functions.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { classifyRings, project, readFeature } from '../../helpers/binary-util-functions';\nlet endPos;\nlet cmd;\nlet cmdLen;\nlet length;\nlet x;\nlet y;\nlet i;\nexport const TEST_EXPORTS = {\n  classifyRings\n};\nexport default class VectorTileFeature {\n  constructor(pbf, end, extent, keys, values, geometryInfo) {\n    _defineProperty(this, \"properties\", void 0);\n\n    _defineProperty(this, \"extent\", void 0);\n\n    _defineProperty(this, \"type\", void 0);\n\n    _defineProperty(this, \"id\", void 0);\n\n    _defineProperty(this, \"_pbf\", void 0);\n\n    _defineProperty(this, \"_geometry\", void 0);\n\n    _defineProperty(this, \"_keys\", void 0);\n\n    _defineProperty(this, \"_values\", void 0);\n\n    _defineProperty(this, \"_geometryInfo\", void 0);\n\n    this.properties = {};\n    this.extent = extent;\n    this.type = 0;\n    this.id = null;\n    this._pbf = pbf;\n    this._geometry = -1;\n    this._keys = keys;\n    this._values = values;\n    this._geometryInfo = geometryInfo;\n    pbf.readFields(readFeature, this, end);\n  }\n\n  loadGeometry() {\n    const pbf = this._pbf;\n    pbf.pos = this._geometry;\n    endPos = pbf.readVarint() + pbf.pos;\n    cmd = 1;\n    length = 0;\n    x = 0;\n    y = 0;\n    i = 0;\n    const indices = [];\n    const data = [];\n\n    while (pbf.pos < endPos) {\n      if (length <= 0) {\n        cmdLen = pbf.readVarint();\n        cmd = cmdLen & 0x7;\n        length = cmdLen >> 3;\n      }\n\n      length--;\n\n      if (cmd === 1 || cmd === 2) {\n        x += pbf.readSVarint();\n        y += pbf.readSVarint();\n\n        if (cmd === 1) {\n          indices.push(i);\n        }\n\n        data.push(x, y);\n        i += 2;\n      } else if (cmd === 7) {\n        if (i > 0) {\n          const start = indices[indices.length - 1];\n          data.push(data[start], data[start + 1]);\n          i += 2;\n        }\n      } else {\n        throw new Error(\"unknown command \".concat(cmd));\n      }\n    }\n\n    return {\n      data,\n      indices\n    };\n  }\n\n  _toBinaryCoordinates(transform) {\n    const geom = this.loadGeometry();\n    let geometry;\n    transform(geom.data, this);\n    const coordLength = 2;\n\n    switch (this.type) {\n      case 1:\n        this._geometryInfo.pointFeaturesCount++;\n        this._geometryInfo.pointPositionsCount += geom.indices.length;\n        geometry = {\n          type: 'Point',\n          ...geom\n        };\n        break;\n\n      case 2:\n        this._geometryInfo.lineFeaturesCount++;\n        this._geometryInfo.linePathsCount += geom.indices.length;\n        this._geometryInfo.linePositionsCount += geom.data.length / coordLength;\n        geometry = {\n          type: 'LineString',\n          ...geom\n        };\n        break;\n\n      case 3:\n        geometry = classifyRings(geom);\n        this._geometryInfo.polygonFeaturesCount++;\n        this._geometryInfo.polygonObjectsCount += geometry.indices.length;\n\n        for (const indices of geometry.indices) {\n          this._geometryInfo.polygonRingsCount += indices.length;\n        }\n\n        this._geometryInfo.polygonPositionsCount += geometry.data.length / coordLength;\n        break;\n\n      default:\n        throw new Error(\"Invalid geometry type: \".concat(this.type));\n    }\n\n    const result = {\n      type: 'Feature',\n      geometry,\n      properties: this.properties\n    };\n\n    if (this.id !== null) {\n      result.id = this.id;\n    }\n\n    return result;\n  }\n\n  toBinaryCoordinates(options) {\n    if (typeof options === 'function') {\n      return this._toBinaryCoordinates(options);\n    }\n\n    const {\n      x,\n      y,\n      z\n    } = options;\n    const size = this.extent * Math.pow(2, z);\n    const x0 = this.extent * x;\n    const y0 = this.extent * y;\n    return this._toBinaryCoordinates(data => project(data, x0, y0, size));\n  }\n\n}\n//# sourceMappingURL=vector-tile-feature.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport VectorTileFeature from './vector-tile-feature';\nexport default class VectorTileLayer {\n  constructor(pbf, end) {\n    _defineProperty(this, \"version\", void 0);\n\n    _defineProperty(this, \"name\", void 0);\n\n    _defineProperty(this, \"extent\", void 0);\n\n    _defineProperty(this, \"length\", void 0);\n\n    _defineProperty(this, \"_pbf\", void 0);\n\n    _defineProperty(this, \"_keys\", void 0);\n\n    _defineProperty(this, \"_values\", void 0);\n\n    _defineProperty(this, \"_features\", void 0);\n\n    this.version = 1;\n    this.name = '';\n    this.extent = 4096;\n    this.length = 0;\n    this._pbf = pbf;\n    this._keys = [];\n    this._values = [];\n    this._features = [];\n    pbf.readFields(readLayer, this, end);\n    this.length = this._features.length;\n  }\n\n  feature(i, geometryInfo) {\n    if (i < 0 || i >= this._features.length) {\n      throw new Error('feature index out of bounds');\n    }\n\n    this._pbf.pos = this._features[i];\n\n    const end = this._pbf.readVarint() + this._pbf.pos;\n\n    return new VectorTileFeature(this._pbf, end, this.extent, this._keys, this._values, geometryInfo);\n  }\n\n}\n\nfunction readLayer(tag, layer, pbf) {\n  if (layer && pbf) {\n    if (tag === 15) layer.version = pbf.readVarint();else if (tag === 1) layer.name = pbf.readString();else if (tag === 5) layer.extent = pbf.readVarint();else if (tag === 2) layer._features.push(pbf.pos);else if (tag === 3) layer._keys.push(pbf.readString());else if (tag === 4) layer._values.push(readValueMessage(pbf));\n  }\n}\n\nfunction readValueMessage(pbf) {\n  let value = null;\n  const end = pbf.readVarint() + pbf.pos;\n\n  while (pbf.pos < end) {\n    const tag = pbf.readVarint() >> 3;\n    value = tag === 1 ? pbf.readString() : tag === 2 ? pbf.readFloat() : tag === 3 ? pbf.readDouble() : tag === 4 ? pbf.readVarint64() : tag === 5 ? pbf.readVarint() : tag === 6 ? pbf.readSVarint() : tag === 7 ? pbf.readBoolean() : null;\n  }\n\n  return value;\n}\n//# sourceMappingURL=vector-tile-layer.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport VectorTileLayer from './vector-tile-layer';\nexport default class VectorTile {\n  constructor(pbf, end) {\n    _defineProperty(this, \"layers\", void 0);\n\n    this.layers = pbf.readFields(readTile, {}, end);\n  }\n\n}\n\nfunction readTile(tag, layers, pbf) {\n  if (tag === 3) {\n    if (pbf) {\n      const layer = new VectorTileLayer(pbf, pbf.readVarint() + pbf.pos);\n\n      if (layer.length && layers) {\n        layers[layer.name] = layer;\n      }\n    }\n  }\n}\n//# sourceMappingURL=vector-tile.js.map","import { flatGeojsonToBinary } from '@loaders.gl/gis';\nimport Protobuf from 'pbf';\nimport VectorTile from './mapbox-vector-tile/vector-tile';\nimport BinaryVectorTile from './binary-vector-tile/vector-tile';\nexport default function parseMVT(arrayBuffer, options) {\n  var _options$gis, _options$mvt;\n\n  const mvtOptions = normalizeOptions(options);\n  const shape = (options === null || options === void 0 ? void 0 : (_options$gis = options.gis) === null || _options$gis === void 0 ? void 0 : _options$gis.format) || (options === null || options === void 0 ? void 0 : (_options$mvt = options.mvt) === null || _options$mvt === void 0 ? void 0 : _options$mvt.shape);\n\n  switch (shape) {\n    case 'columnar-table':\n      return {\n        shape: 'columnar-table',\n        data: parseToBinary(arrayBuffer, mvtOptions)\n      };\n\n    case 'geojson-row-table':\n      {\n        const table = {\n          shape: 'geojson-row-table',\n          data: parseToGeojson(arrayBuffer, mvtOptions)\n        };\n        return table;\n      }\n\n    case 'geojson':\n      return parseToGeojson(arrayBuffer, mvtOptions);\n\n    case 'binary-geometry':\n      return parseToBinary(arrayBuffer, mvtOptions);\n\n    case 'binary':\n      return parseToBinary(arrayBuffer, mvtOptions);\n\n    default:\n      throw new Error(shape);\n  }\n}\n\nfunction parseToBinary(arrayBuffer, options) {\n  const [flatGeoJsonFeatures, geometryInfo] = parseToFlatGeoJson(arrayBuffer, options);\n  const binaryData = flatGeojsonToBinary(flatGeoJsonFeatures, geometryInfo);\n  binaryData.byteLength = arrayBuffer.byteLength;\n  return binaryData;\n}\n\nfunction parseToFlatGeoJson(arrayBuffer, options) {\n  const features = [];\n  const geometryInfo = {\n    coordLength: 2,\n    pointPositionsCount: 0,\n    pointFeaturesCount: 0,\n    linePositionsCount: 0,\n    linePathsCount: 0,\n    lineFeaturesCount: 0,\n    polygonPositionsCount: 0,\n    polygonObjectsCount: 0,\n    polygonRingsCount: 0,\n    polygonFeaturesCount: 0\n  };\n\n  if (arrayBuffer.byteLength <= 0) {\n    return [features, geometryInfo];\n  }\n\n  const tile = new BinaryVectorTile(new Protobuf(arrayBuffer));\n  const selectedLayers = options && Array.isArray(options.layers) ? options.layers : Object.keys(tile.layers);\n  selectedLayers.forEach(layerName => {\n    const vectorTileLayer = tile.layers[layerName];\n\n    if (!vectorTileLayer) {\n      return;\n    }\n\n    for (let i = 0; i < vectorTileLayer.length; i++) {\n      const vectorTileFeature = vectorTileLayer.feature(i, geometryInfo);\n      const decodedFeature = getDecodedFeatureBinary(vectorTileFeature, options, layerName);\n      features.push(decodedFeature);\n    }\n  });\n  return [features, geometryInfo];\n}\n\nfunction parseToGeojson(arrayBuffer, options) {\n  if (arrayBuffer.byteLength <= 0) {\n    return [];\n  }\n\n  const features = [];\n  const tile = new VectorTile(new Protobuf(arrayBuffer));\n  const selectedLayers = Array.isArray(options.layers) ? options.layers : Object.keys(tile.layers);\n  selectedLayers.forEach(layerName => {\n    const vectorTileLayer = tile.layers[layerName];\n\n    if (!vectorTileLayer) {\n      return;\n    }\n\n    for (let i = 0; i < vectorTileLayer.length; i++) {\n      const vectorTileFeature = vectorTileLayer.feature(i);\n      const decodedFeature = getDecodedFeature(vectorTileFeature, options, layerName);\n      features.push(decodedFeature);\n    }\n  });\n  return features;\n}\n\nfunction normalizeOptions(options) {\n  var _options$mvt2;\n\n  if (!(options !== null && options !== void 0 && options.mvt)) {\n    throw new Error('mvt options required');\n  }\n\n  const wgs84Coordinates = ((_options$mvt2 = options.mvt) === null || _options$mvt2 === void 0 ? void 0 : _options$mvt2.coordinates) === 'wgs84';\n  const {\n    tileIndex\n  } = options.mvt;\n  const hasTileIndex = tileIndex && Number.isFinite(tileIndex.x) && Number.isFinite(tileIndex.y) && Number.isFinite(tileIndex.z);\n\n  if (wgs84Coordinates && !hasTileIndex) {\n    throw new Error('MVT Loader: WGS84 coordinates need tileIndex property');\n  }\n\n  return options.mvt;\n}\n\nfunction getDecodedFeature(feature, options, layerName) {\n  const decodedFeature = feature.toGeoJSON(options.coordinates === 'wgs84' ? options.tileIndex : transformToLocalCoordinates);\n\n  if (options.layerProperty) {\n    decodedFeature.properties[options.layerProperty] = layerName;\n  }\n\n  return decodedFeature;\n}\n\nfunction getDecodedFeatureBinary(feature, options, layerName) {\n  const decodedFeature = feature.toBinaryCoordinates(options.coordinates === 'wgs84' ? options.tileIndex : transformToLocalCoordinatesBinary);\n\n  if (options.layerProperty && decodedFeature.properties) {\n    decodedFeature.properties[options.layerProperty] = layerName;\n  }\n\n  return decodedFeature;\n}\n\nfunction transformToLocalCoordinates(line, feature) {\n  const {\n    extent\n  } = feature;\n\n  for (let i = 0; i < line.length; i++) {\n    const p = line[i];\n    p[0] /= extent;\n    p[1] /= extent;\n  }\n}\n\nfunction transformToLocalCoordinatesBinary(data, feature) {\n  const {\n    extent\n  } = feature;\n\n  for (let i = 0, il = data.length; i < il; ++i) {\n    data[i] /= extent;\n  }\n}\n//# sourceMappingURL=parse-mvt.js.map","import parseMVT from './lib/parse-mvt';\nconst VERSION = typeof \"3.2.10\" !== 'undefined' ? \"3.2.10\" : 'latest';\nconst DEFAULT_MVT_LOADER_OPTIONS = {\n  mvt: {\n    shape: 'geojson',\n    coordinates: 'local',\n    layerProperty: 'layerName',\n    layers: undefined,\n    tileIndex: null\n  }\n};\nexport const MVTWorkerLoader = {\n  name: 'Mapbox Vector Tile',\n  id: 'mvt',\n  module: 'mvt',\n  version: VERSION,\n  extensions: ['mvt', 'pbf'],\n  mimeTypes: ['application/vnd.mapbox-vector-tile', 'application/x-protobuf'],\n  worker: true,\n  category: 'geometry',\n  options: DEFAULT_MVT_LOADER_OPTIONS\n};\nexport const MVTLoader = { ...MVTWorkerLoader,\n  parse: async (arrayBuffer, options) => parseMVT(arrayBuffer, options),\n  parseSync: parseMVT,\n  binary: true\n};\n//# sourceMappingURL=mvt-loader.js.map","export function binaryToGeojson(data, options) {\n  const globalFeatureId = options === null || options === void 0 ? void 0 : options.globalFeatureId;\n\n  if (globalFeatureId !== undefined) {\n    return getSingleFeature(data, globalFeatureId);\n  }\n\n  return parseFeatures(data, options === null || options === void 0 ? void 0 : options.type);\n}\nexport function binaryToGeoJson(data, type, format = 'feature') {\n  switch (format) {\n    case 'feature':\n      return parseFeatures(data, type);\n\n    case 'geometry':\n      return binaryToGeometry(data);\n\n    default:\n      throw new Error(format);\n  }\n}\n\nfunction getSingleFeature(data, globalFeatureId) {\n  const dataArray = normalizeInput(data);\n\n  for (const data of dataArray) {\n    let lastIndex = 0;\n    let lastValue = data.featureIds.value[0];\n\n    for (let i = 0; i < data.featureIds.value.length; i++) {\n      const currValue = data.featureIds.value[i];\n\n      if (currValue === lastValue) {\n        continue;\n      }\n\n      if (globalFeatureId === data.globalFeatureIds.value[lastIndex]) {\n        return parseFeature(data, lastIndex, i);\n      }\n\n      lastIndex = i;\n      lastValue = currValue;\n    }\n\n    if (globalFeatureId === data.globalFeatureIds.value[lastIndex]) {\n      return parseFeature(data, lastIndex, data.featureIds.value.length);\n    }\n  }\n\n  throw new Error(\"featureId:\".concat(globalFeatureId, \" not found\"));\n}\n\nfunction parseFeatures(data, type) {\n  const dataArray = normalizeInput(data, type);\n  return parseFeatureCollection(dataArray);\n}\n\nexport function binaryToGeometry(data, startIndex, endIndex) {\n  switch (data.type) {\n    case 'Point':\n      return pointToGeoJson(data, startIndex, endIndex);\n\n    case 'LineString':\n      return lineStringToGeoJson(data, startIndex, endIndex);\n\n    case 'Polygon':\n      return polygonToGeoJson(data, startIndex, endIndex);\n\n    default:\n      const unexpectedInput = data;\n      throw new Error(\"Unsupported geometry type: \".concat(unexpectedInput === null || unexpectedInput === void 0 ? void 0 : unexpectedInput.type));\n  }\n}\n\nfunction normalizeInput(data, type) {\n  const isHeterogeneousType = Boolean(data.points || data.lines || data.polygons);\n\n  if (!isHeterogeneousType) {\n    data.type = type || parseType(data);\n    return [data];\n  }\n\n  const features = [];\n\n  if (data.points) {\n    data.points.type = 'Point';\n    features.push(data.points);\n  }\n\n  if (data.lines) {\n    data.lines.type = 'LineString';\n    features.push(data.lines);\n  }\n\n  if (data.polygons) {\n    data.polygons.type = 'Polygon';\n    features.push(data.polygons);\n  }\n\n  return features;\n}\n\nfunction parseFeatureCollection(dataArray) {\n  const features = [];\n\n  for (const data of dataArray) {\n    if (data.featureIds.value.length === 0) {\n      continue;\n    }\n\n    let lastIndex = 0;\n    let lastValue = data.featureIds.value[0];\n\n    for (let i = 0; i < data.featureIds.value.length; i++) {\n      const currValue = data.featureIds.value[i];\n\n      if (currValue === lastValue) {\n        continue;\n      }\n\n      features.push(parseFeature(data, lastIndex, i));\n      lastIndex = i;\n      lastValue = currValue;\n    }\n\n    features.push(parseFeature(data, lastIndex, data.featureIds.value.length));\n  }\n\n  return features;\n}\n\nfunction parseFeature(data, startIndex, endIndex) {\n  const geometry = binaryToGeometry(data, startIndex, endIndex);\n  const properties = parseProperties(data, startIndex, endIndex);\n  const fields = parseFields(data, startIndex, endIndex);\n  return {\n    type: 'Feature',\n    geometry,\n    properties,\n    ...fields\n  };\n}\n\nfunction parseFields(data, startIndex = 0, endIndex) {\n  return data.fields && data.fields[data.featureIds.value[startIndex]];\n}\n\nfunction parseProperties(data, startIndex = 0, endIndex) {\n  const properties = Object.assign({}, data.properties[data.featureIds.value[startIndex]]);\n\n  for (const key in data.numericProps) {\n    properties[key] = data.numericProps[key].value[startIndex];\n  }\n\n  return properties;\n}\n\nfunction polygonToGeoJson(data, startIndex = -Infinity, endIndex = Infinity) {\n  const {\n    positions\n  } = data;\n  const polygonIndices = data.polygonIndices.value.filter(x => x >= startIndex && x <= endIndex);\n  const primitivePolygonIndices = data.primitivePolygonIndices.value.filter(x => x >= startIndex && x <= endIndex);\n  const multi = polygonIndices.length > 2;\n\n  if (!multi) {\n    const coordinates = [];\n\n    for (let i = 0; i < primitivePolygonIndices.length - 1; i++) {\n      const startRingIndex = primitivePolygonIndices[i];\n      const endRingIndex = primitivePolygonIndices[i + 1];\n      const ringCoordinates = ringToGeoJson(positions, startRingIndex, endRingIndex);\n      coordinates.push(ringCoordinates);\n    }\n\n    return {\n      type: 'Polygon',\n      coordinates\n    };\n  }\n\n  const coordinates = [];\n\n  for (let i = 0; i < polygonIndices.length - 1; i++) {\n    const startPolygonIndex = polygonIndices[i];\n    const endPolygonIndex = polygonIndices[i + 1];\n    const polygonCoordinates = polygonToGeoJson(data, startPolygonIndex, endPolygonIndex).coordinates;\n    coordinates.push(polygonCoordinates);\n  }\n\n  return {\n    type: 'MultiPolygon',\n    coordinates\n  };\n}\n\nfunction lineStringToGeoJson(data, startIndex = -Infinity, endIndex = Infinity) {\n  const {\n    positions\n  } = data;\n  const pathIndices = data.pathIndices.value.filter(x => x >= startIndex && x <= endIndex);\n  const multi = pathIndices.length > 2;\n\n  if (!multi) {\n    const coordinates = ringToGeoJson(positions, pathIndices[0], pathIndices[1]);\n    return {\n      type: 'LineString',\n      coordinates\n    };\n  }\n\n  const coordinates = [];\n\n  for (let i = 0; i < pathIndices.length - 1; i++) {\n    const ringCoordinates = ringToGeoJson(positions, pathIndices[i], pathIndices[i + 1]);\n    coordinates.push(ringCoordinates);\n  }\n\n  return {\n    type: 'MultiLineString',\n    coordinates\n  };\n}\n\nfunction pointToGeoJson(data, startIndex, endIndex) {\n  const {\n    positions\n  } = data;\n  const coordinates = ringToGeoJson(positions, startIndex, endIndex);\n  const multi = coordinates.length > 1;\n\n  if (multi) {\n    return {\n      type: 'MultiPoint',\n      coordinates\n    };\n  }\n\n  return {\n    type: 'Point',\n    coordinates: coordinates[0]\n  };\n}\n\nfunction ringToGeoJson(positions, startIndex, endIndex) {\n  startIndex = startIndex || 0;\n  endIndex = endIndex || positions.value.length / positions.size;\n  const ringCoordinates = [];\n\n  for (let j = startIndex; j < endIndex; j++) {\n    const coord = Array();\n\n    for (let k = j * positions.size; k < (j + 1) * positions.size; k++) {\n      coord.push(Number(positions.value[k]));\n    }\n\n    ringCoordinates.push(coord);\n  }\n\n  return ringCoordinates;\n}\n\nfunction parseType(data) {\n  if (data.pathIndices) {\n    return 'LineString';\n  }\n\n  if (data.polygonIndices) {\n    return 'Polygon';\n  }\n\n  return 'Point';\n}\n//# sourceMappingURL=binary-to-geojson.js.map","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {LayerExtension, _ShaderModule as ShaderModule} from '@deck.gl/core';\n\nimport type {Layer} from '@deck.gl/core';\n\nconst defaultProps = {\n  clipBounds: [0, 0, 1, 1],\n  clipByInstance: undefined\n};\n\nexport type ClipExtensionProps = {\n  /** Rectangular bounds to be used for clipping the rendered region, in `[left, bottom, right, top]`.\n   * @default [0, 0, 1, 1]\n   */\n  clipBounds?: [number, number, number, number];\n  /**\n   * Controls whether an object is clipped by its anchor (e.g. icon, point) or by its geometry (e.g. path, polygon).\n   * If not specified, it is automatically deduced from the layer.\n   */\n  clipByInstance?: boolean;\n};\n\nconst shaderFunction = `\nuniform vec4 clip_bounds;\n\nbool clip_isInBounds(vec2 position) {\n  return position.x >= clip_bounds[0] && position.y >= clip_bounds[1] && position.x < clip_bounds[2] && position.y < clip_bounds[3];\n}\n`;\n\n/*\n * The vertex-shader version clips geometries by their anchor position\n * e.g. ScatterplotLayer - show if the center of a circle is within bounds\n */\nconst shaderModuleVs: ShaderModule = {\n  name: 'clip-vs',\n  vs: shaderFunction\n};\n\nconst injectionVs = {\n  'vs:#decl': `\nvarying float clip_isVisible;\n`,\n  'vs:DECKGL_FILTER_GL_POSITION': `\n  clip_isVisible = float(clip_isInBounds(geometry.worldPosition.xy));\n`,\n  'fs:#decl': `\nvarying float clip_isVisible;\n`,\n  'fs:DECKGL_FILTER_COLOR': `\n  if (clip_isVisible < 0.5) discard;\n`\n};\n\n/*\n * The fragment-shader version clips pixels at the bounds\n * e.g. PolygonLayer - show the part of the polygon that intersect with the bounds\n */\nconst shaderModuleFs: ShaderModule = {\n  name: 'clip-fs',\n  fs: shaderFunction\n};\n\nconst injectionFs = {\n  'vs:#decl': `\nvarying vec2 clip_commonPosition;\n`,\n  'vs:DECKGL_FILTER_GL_POSITION': `\n  clip_commonPosition = geometry.position.xy;\n`,\n  'fs:#decl': `\nvarying vec2 clip_commonPosition;\n`,\n  'fs:DECKGL_FILTER_COLOR': `\n  if (!clip_isInBounds(clip_commonPosition)) discard;\n`\n};\n\n/** Adds support for clipping rendered layers by rectangular bounds. */\nexport default class ClipExtension extends LayerExtension {\n  static defaultProps: any = defaultProps;\n  static extensionName = 'ClipExtension';\n\n  getShaders(this: Layer<ClipExtensionProps>) {\n    // If `clipByInstance: true`, the entire object is shown/hidden based on its anchor position (done by vertex shader)\n    // Otherwise, the object is trimmed by the clip bounds (done by fragment shader)\n\n    // Default behavior: consider a layer instanced if it has attribute `instancePositions`\n    // @ts-expect-error attributeManager is always defined for primitive layers\n    let clipByInstance = 'instancePositions' in this.getAttributeManager().attributes;\n    // Users can override by setting the `clipByInstance` prop\n    if (this.props.clipByInstance !== undefined) {\n      clipByInstance = Boolean(this.props.clipByInstance);\n    }\n    this.state.clipByInstance = clipByInstance;\n\n    return clipByInstance\n      ? {\n          modules: [shaderModuleVs],\n          inject: injectionVs\n        }\n      : {\n          modules: [shaderModuleFs],\n          inject: injectionFs\n        };\n  }\n\n  /* eslint-disable camelcase */\n  draw(this: Layer<ClipExtensionProps>, {uniforms}: any): void {\n    const {clipBounds = defaultProps.clipBounds} = this.props;\n    if (this.state.clipByInstance) {\n      uniforms.clip_bounds = clipBounds;\n    } else {\n      const corner0 = this.projectPosition([clipBounds[0], clipBounds[1], 0]);\n      const corner1 = this.projectPosition([clipBounds[2], clipBounds[3], 0]);\n\n      uniforms.clip_bounds = [\n        Math.min(corner0[0], corner1[0]),\n        Math.min(corner0[1], corner1[1]),\n        Math.max(corner0[0], corner1[0]),\n        Math.max(corner0[1], corner1[1])\n      ];\n    }\n  }\n}\n","import {Viewport} from '@deck.gl/core';\nimport {lerp} from '@math.gl/core';\nimport {GeoBoundingBox} from '../tile-layer/types';\n\nconst availableTransformations = {\n  Point,\n  MultiPoint,\n  LineString,\n  MultiLineString,\n  Polygon,\n  MultiPolygon\n};\n\nfunction Point([pointX, pointY]: [number, number], [nw, se]: number[][], viewport: Viewport) {\n  const x = lerp(nw[0], se[0], pointX);\n  const y = lerp(nw[1], se[1], pointY);\n\n  return viewport.unprojectFlat([x, y]);\n}\n\nfunction getPoints(geometry, bbox: number[][], viewport: Viewport) {\n  return geometry.map(g => Point(g, bbox, viewport));\n}\n\nfunction MultiPoint(multiPoint, bbox: number[][], viewport: Viewport) {\n  return getPoints(multiPoint, bbox, viewport);\n}\n\nfunction LineString(line, bbox: number[][], viewport: Viewport) {\n  return getPoints(line, bbox, viewport);\n}\n\nfunction MultiLineString(multiLineString, bbox: number[][], viewport: Viewport) {\n  return multiLineString.map(lineString => LineString(lineString, bbox, viewport));\n}\n\nfunction Polygon(polygon, bbox: number[][], viewport: Viewport) {\n  return polygon.map(polygonRing => getPoints(polygonRing, bbox, viewport));\n}\n\nfunction MultiPolygon(multiPolygon, bbox: number[][], viewport: Viewport) {\n  return multiPolygon.map(polygon => Polygon(polygon, bbox, viewport));\n}\n\nexport function transform(geometry, bbox: GeoBoundingBox, viewport: Viewport) {\n  const nw = viewport.projectFlat([bbox.west, bbox.north]);\n  const se = viewport.projectFlat([bbox.east, bbox.south]);\n  const projectedBbox = [nw, se];\n\n  return {\n    ...geometry,\n    coordinates: availableTransformations[geometry.type](\n      geometry.coordinates,\n      projectedBbox,\n      viewport\n    )\n  };\n}\n","import type {\n  BinaryFeatures,\n  BinaryLineFeatures,\n  BinaryPointFeatures,\n  BinaryPolygonFeatures\n} from '@loaders.gl/schema';\n\ntype FeatureTypes = BinaryPointFeatures | BinaryLineFeatures | BinaryPolygonFeatures;\n\nconst GEOM_TYPES = ['points', 'lines', 'polygons'];\n/**\n * Return the index of feature (numericProps or featureIds) for given feature id\n * Example: findIndexBinary(data, 'id', 33) will return the index in the array of numericProps\n * of the feature 33.\n * @param {Object} data - The data in binary format\n * @param {String} uniqueIdProperty - Name of the unique id property\n * @param {Number|String} featureId - feature id to find\n * @param {String} layerName - the layer to search in\n */\nexport default function findIndexBinary(\n  data: BinaryFeatures,\n  uniqueIdProperty: string,\n  featureId: string | number,\n  layerName: string\n): number {\n  for (const gt of GEOM_TYPES) {\n    const index = data[gt] && findIndexByType(data[gt], uniqueIdProperty, featureId, layerName);\n    if (index >= 0) {\n      return index;\n    }\n  }\n\n  return -1;\n}\n\nfunction findIndexByType(\n  geomData: FeatureTypes,\n  uniqueIdProperty: string,\n  featureId: string | number,\n  layerName: string\n): number {\n  const featureIds = geomData.featureIds.value;\n\n  if (!featureIds.length) {\n    return -1;\n  }\n\n  let startFeatureIndex = 0;\n  let endFeatureIndex = featureIds[featureIds.length - 1] + 1;\n  if (layerName) {\n    const layerRange = getLayerRange(geomData, layerName);\n    if (layerRange) {\n      startFeatureIndex = layerRange[0];\n      endFeatureIndex = layerRange[1] + 1;\n    } else {\n      return -1;\n    }\n  }\n\n  // Look for the uniqueIdProperty\n  let featureIndex = -1;\n  if (uniqueIdProperty in geomData.numericProps) {\n    const vertexIndex = geomData.numericProps[uniqueIdProperty].value.findIndex(\n      (x, i) =>\n        x === featureId && featureIds[i] >= startFeatureIndex && featureIds[i] < endFeatureIndex\n    );\n    return vertexIndex >= 0 ? geomData.globalFeatureIds.value[vertexIndex] : -1;\n  } else if (uniqueIdProperty) {\n    featureIndex = findIndex(\n      geomData.properties,\n      elem => elem[uniqueIdProperty] === featureId,\n      startFeatureIndex,\n      endFeatureIndex\n    );\n  } else if (geomData.fields) {\n    featureIndex = findIndex(\n      geomData.fields,\n      (elem: any) => elem.id === featureId,\n      startFeatureIndex,\n      endFeatureIndex\n    );\n  }\n  return featureIndex >= 0 ? getGlobalFeatureId(geomData, featureIndex) : -1;\n}\n\ntype LayerRange = [firstFeatureIndex: number, lastFeatureIndex: number];\n\n// Returns [firstFeatureIndex, lastFeatureIndex]\n// MVTLoader parses tiles layer-by-layer, so each layer is a continuous range\nfunction getLayerRange(\n  geomData: FeatureTypes & {\n    __layers?: Record<string, LayerRange>;\n  },\n  layerName: string\n): LayerRange | undefined {\n  if (!geomData.__layers) {\n    // Cache a map from properties.layerName to index ranges\n    const layerNames: Record<string, LayerRange> = {};\n    const {properties} = geomData;\n    for (let i = 0; i < properties.length; i++) {\n      const {layerName: key} = properties[i] as Record<string, any>;\n      if (!key) {\n        // ignore\n      } else if (layerNames[key]) {\n        layerNames[key][1] = i;\n      } else {\n        layerNames[key] = [i, i];\n      }\n    }\n    geomData.__layers = layerNames;\n  }\n  return geomData.__layers[layerName];\n}\n\n// Returns global feature id\nfunction getGlobalFeatureId(geomData, featureIndex: number) {\n  if (!geomData.__ids) {\n    // Cache a map from featureId to globalFeatureId\n    const result: string[] = [];\n    const featureIds = geomData.featureIds.value;\n    const globalFeatureIds = geomData.globalFeatureIds.value;\n    for (let i = 0; i < featureIds.length; i++) {\n      result[featureIds[i]] = globalFeatureIds[i];\n    }\n    geomData.__ids = result;\n  }\n  return geomData.__ids[featureIndex];\n}\n\n// Like array.findIndex, but only search within a range\nfunction findIndex<T>(\n  array: T[],\n  predicate: (v: T, index: number) => boolean,\n  startIndex: number,\n  endIndex: number\n): number {\n  for (let i = startIndex; i < endIndex; i++) {\n    if (predicate(array[i], i)) {\n      return i;\n    }\n  }\n  return -1;\n}\n","import {\n  Layer,\n  LayersList,\n  log,\n  PickingInfo,\n  UpdateParameters,\n  GetPickingInfoParams,\n  Viewport,\n  COORDINATE_SYSTEM,\n  DefaultProps\n} from '@deck.gl/core';\nimport {GeoJsonLayer, GeoJsonLayerProps} from '@deck.gl/layers';\nimport {Matrix4} from '@math.gl/core';\nimport {MVTWorkerLoader} from '@loaders.gl/mvt';\nimport {binaryToGeojson} from '@loaders.gl/gis';\nimport {ClipExtension} from '@deck.gl/extensions';\n\nimport type {Loader} from '@loaders.gl/loader-utils';\nimport type {BinaryFeatures} from '@loaders.gl/schema';\nimport type {Feature} from 'geojson';\n\nimport TileLayer, {TiledPickingInfo, TileLayerProps} from '../tile-layer/tile-layer';\nimport Tileset2D, {Tileset2DProps} from '../tile-layer/tileset-2d';\nimport {getURLFromTemplate, isGeoBoundingBox, isURLTemplate} from '../tile-layer/utils';\nimport {GeoBoundingBox, TileLoadProps} from '../tile-layer/types';\nimport Tile2DHeader from '../tile-layer/tile-2d-header';\nimport {transform} from './coordinate-transform';\nimport findIndexBinary from './find-index-binary';\n\nconst WORLD_SIZE = 512;\n\nconst defaultProps: DefaultProps<MVTLayerProps> = {\n  ...GeoJsonLayer.defaultProps,\n  onDataLoad: {type: 'function', value: null, optional: true, compare: false},\n  uniqueIdProperty: '',\n  highlightedFeatureId: null,\n  loaders: [MVTWorkerLoader],\n  binary: true\n};\n\nexport type TileJson = {\n  tilejson: string;\n  tiles: string[];\n  // eslint-disable-next-line camelcase\n  vector_layers: any[];\n  attribution?: string;\n  scheme?: string;\n  maxzoom?: number;\n  minzoom?: number;\n  version?: string;\n};\n\ntype ParsedMvtTile = Feature[] | BinaryFeatures;\n\n/** All props supported by the MVTLayer */\nexport type MVTLayerProps<DataT extends Feature = Feature> = _MVTLayerProps &\n  GeoJsonLayerProps<DataT> &\n  TileLayerProps<ParsedMvtTile>;\n\n/** Props added by the MVTLayer  */\nexport type _MVTLayerProps = {\n  /** Called if `data` is a TileJSON URL when it is successfully fetched. */\n  onDataLoad?: ((tilejson: TileJson | null) => void) | null;\n\n  /** Needed for highlighting a feature split across two or more tiles. */\n  uniqueIdProperty?: string;\n\n  /** A feature with ID corresponding to the supplied value will be highlighted. */\n  highlightedFeatureId?: string | null;\n\n  /**\n   * Use tile data in binary format.\n   *\n   * @default true\n   */\n  binary?: boolean;\n\n  /**\n   * Loaders used to transform tiles into `data` property passed to `renderSubLayers`.\n   *\n   * @default [MVTWorkerLoader] from `@loaders.gl/mvt`\n   */\n  loaders?: Loader[];\n};\n\ntype ContentWGS84Cache = {_contentWGS84?: Feature[]};\n\n/** Render data formatted as [Mapbox Vector Tiles](https://docs.mapbox.com/vector-tiles/specification/). */\nexport default class MVTLayer<DataT extends Feature = Feature, ExtraProps = {}> extends TileLayer<\n  ParsedMvtTile,\n  Required<_MVTLayerProps> & ExtraProps\n> {\n  static layerName = 'MVTLayer';\n  static defaultProps = defaultProps;\n\n  initializeState(): void {\n    super.initializeState();\n    // GlobeView doesn't work well with binary data\n    const binary = this.context.viewport.resolution !== undefined ? false : this.props.binary;\n    this.setState({\n      binary,\n      data: null,\n      tileJSON: null\n    });\n  }\n\n  get isLoaded(): boolean {\n    return this.state && this.state.data && this.state.tileset && super.isLoaded;\n  }\n\n  updateState({props, oldProps, context, changeFlags}: UpdateParameters<this>) {\n    if (changeFlags.dataChanged) {\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      this._updateTileData();\n    }\n\n    if (this.state?.data) {\n      super.updateState({props, oldProps, context, changeFlags});\n      this._setWGS84PropertyForTiles();\n    }\n    const {highlightColor} = props;\n    if (highlightColor !== oldProps.highlightColor && Array.isArray(highlightColor)) {\n      this.setState({highlightColor});\n    }\n  }\n\n  /* eslint-disable complexity */\n  private async _updateTileData(): Promise<void> {\n    let data: any = this.props.data;\n    let tileJSON: any = null;\n\n    if (typeof data === 'string' && !isURLTemplate(data)) {\n      const {onDataLoad, fetch} = this.props;\n      this.setState({data: null, tileJSON: null});\n      try {\n        tileJSON = await fetch(data, {propName: 'data', layer: this, loaders: []});\n      } catch (error: any) {\n        this.raiseError(error, 'loading TileJSON');\n        data = null;\n      }\n\n      if (onDataLoad) {\n        onDataLoad(tileJSON, {propName: 'data', layer: this});\n      }\n    } else if (data.tilejson) {\n      tileJSON = data;\n    }\n\n    if (tileJSON) {\n      data = tileJSON.tiles;\n    }\n\n    this.setState({data, tileJSON});\n  }\n\n  _getTilesetOptions(): Tileset2DProps {\n    const opts = super._getTilesetOptions();\n    const tileJSON: TileJson | null | undefined = this.state.tileJSON;\n    const {minZoom, maxZoom} = this.props;\n\n    if (tileJSON) {\n      if (Number.isFinite(tileJSON.minzoom) && (tileJSON.minzoom as number) > (minZoom as number)) {\n        opts.minZoom = tileJSON.minzoom as number;\n      }\n\n      if (\n        Number.isFinite(tileJSON.maxzoom) &&\n        (!Number.isFinite(maxZoom) || (tileJSON.maxzoom as number) < (maxZoom as number))\n      ) {\n        opts.maxZoom = tileJSON.maxzoom as number;\n      }\n    }\n    return opts;\n  }\n\n  /* eslint-disable complexity */\n\n  renderLayers(): Layer | null | LayersList {\n    if (!this.state?.data) return null;\n    return super.renderLayers();\n  }\n\n  getTileData(loadProps: TileLoadProps): Promise<ParsedMvtTile> {\n    const {data, binary} = this.state;\n    const {index, signal} = loadProps;\n\n    const url = getURLFromTemplate(data, loadProps);\n    if (!url) {\n      return Promise.reject('Invalid URL');\n    }\n    let loadOptions = this.getLoadOptions();\n    const {fetch} = this.props;\n    loadOptions = {\n      ...loadOptions,\n      mimeType: 'application/x-protobuf',\n      mvt: {\n        ...loadOptions?.mvt,\n        coordinates: this.context.viewport.resolution ? 'wgs84' : 'local',\n        tileIndex: index\n        // Local worker debug\n        // workerUrl: `modules/mvt/dist/mvt-loader.worker.js`\n        // Set worker to null to skip web workers\n        // workerUrl: null\n      },\n      gis: binary ? {format: 'binary'} : {}\n    };\n    return fetch(url, {propName: 'data', layer: this, loadOptions, signal});\n  }\n\n  renderSubLayers(\n    props: TileLayer['props'] & {\n      id: string;\n      data: ParsedMvtTile;\n      _offset: number;\n      tile: Tile2DHeader<ParsedMvtTile>;\n    }\n  ): Layer | null | LayersList {\n    const {x, y, z} = props.tile.index;\n    const worldScale = Math.pow(2, z);\n\n    const xScale = WORLD_SIZE / worldScale;\n    const yScale = -xScale;\n\n    const xOffset = (WORLD_SIZE * x) / worldScale;\n    const yOffset = WORLD_SIZE * (1 - y / worldScale);\n\n    const modelMatrix = new Matrix4().scale([xScale, yScale, 1]);\n\n    props.autoHighlight = false;\n\n    if (!this.context.viewport.resolution) {\n      props.modelMatrix = modelMatrix;\n      props.coordinateOrigin = [xOffset, yOffset, 0];\n      props.coordinateSystem = COORDINATE_SYSTEM.CARTESIAN;\n      props.extensions = [...(props.extensions || []), new ClipExtension()];\n    }\n\n    const subLayers = super.renderSubLayers(props);\n\n    if (this.state.binary && !(subLayers instanceof GeoJsonLayer)) {\n      log.warn('renderSubLayers() must return GeoJsonLayer when using binary:true')();\n    }\n\n    return subLayers;\n  }\n\n  protected _updateAutoHighlight(info: PickingInfo): void {\n    const {uniqueIdProperty} = this.props;\n\n    const {hoveredFeatureId, hoveredFeatureLayerName} = this.state;\n    const hoveredFeature = info.object;\n    let newHoveredFeatureId;\n    let newHoveredFeatureLayerName;\n\n    if (hoveredFeature) {\n      newHoveredFeatureId = getFeatureUniqueId(hoveredFeature, uniqueIdProperty);\n      newHoveredFeatureLayerName = getFeatureLayerName(hoveredFeature);\n    }\n    let {highlightColor} = this.props;\n    if (typeof highlightColor === 'function') {\n      highlightColor = highlightColor(info);\n    }\n\n    if (\n      hoveredFeatureId !== newHoveredFeatureId ||\n      hoveredFeatureLayerName !== newHoveredFeatureLayerName\n    ) {\n      this.setState({\n        highlightColor,\n        hoveredFeatureId: newHoveredFeatureId,\n        hoveredFeatureLayerName: newHoveredFeatureLayerName\n      });\n    }\n  }\n\n  getPickingInfo(params: GetPickingInfoParams): TiledPickingInfo {\n    const info = super.getPickingInfo(params);\n\n    const isWGS84 = Boolean(this.context.viewport.resolution);\n\n    if (this.state.binary && info.index !== -1) {\n      const {data} = params.sourceLayer!.props;\n      info.object = binaryToGeojson(data as BinaryFeatures, {globalFeatureId: info.index}) as DataT;\n    }\n    if (info.object && !isWGS84) {\n      info.object = transformTileCoordsToWGS84(\n        info.object,\n        info.tile!.bbox as GeoBoundingBox,\n        this.context.viewport\n      );\n    }\n\n    return info;\n  }\n\n  getSubLayerPropsByTile(tile: Tile2DHeader<ParsedMvtTile>): Record<string, any> {\n    return {\n      highlightedObjectIndex: this.getHighlightedObjectIndex(tile),\n      highlightColor: this.state.highlightColor\n    };\n  }\n\n  private getHighlightedObjectIndex(tile: Tile2DHeader<ParsedMvtTile>): number {\n    const {hoveredFeatureId, hoveredFeatureLayerName, binary} = this.state;\n    const {uniqueIdProperty, highlightedFeatureId} = this.props;\n    const data = tile.content;\n\n    const isHighlighted = isFeatureIdDefined(highlightedFeatureId);\n    const isFeatureIdPresent = isFeatureIdDefined(hoveredFeatureId) || isHighlighted;\n\n    if (!isFeatureIdPresent) {\n      return -1;\n    }\n\n    const featureIdToHighlight = isHighlighted ? highlightedFeatureId : hoveredFeatureId;\n\n    // Iterable data\n    if (Array.isArray(data)) {\n      return data.findIndex(feature => {\n        const isMatchingId = getFeatureUniqueId(feature, uniqueIdProperty) === featureIdToHighlight;\n        const isMatchingLayer =\n          isHighlighted || getFeatureLayerName(feature) === hoveredFeatureLayerName;\n        return isMatchingId && isMatchingLayer;\n      });\n\n      // Non-iterable data\n    } else if (data && binary) {\n      // Get the feature index of the selected item to highlight\n      return findIndexBinary(\n        data,\n        uniqueIdProperty,\n        featureIdToHighlight,\n        isHighlighted ? '' : hoveredFeatureLayerName\n      );\n    }\n\n    return -1;\n  }\n\n  private _pickObjects(maxObjects: number | null): PickingInfo[] {\n    const {deck, viewport} = this.context;\n    const width = viewport.width;\n    const height = viewport.height;\n    const x = viewport.x;\n    const y = viewport.y;\n    const layerIds = [this.id];\n    return deck!.pickObjects({x, y, width, height, layerIds, maxObjects});\n  }\n\n  /** Get the rendered features in the current viewport. */\n  getRenderedFeatures(maxFeatures: number | null = null): DataT[] {\n    const features = this._pickObjects(maxFeatures);\n    const featureCache = new Set();\n    const renderedFeatures: DataT[] = [];\n\n    for (const f of features) {\n      const featureId = getFeatureUniqueId(f.object, this.props.uniqueIdProperty);\n\n      if (featureId === undefined) {\n        // we have no id for the feature, we just add to the list\n        renderedFeatures.push(f.object as DataT);\n      } else if (!featureCache.has(featureId)) {\n        // Add removing duplicates\n        featureCache.add(featureId);\n        renderedFeatures.push(f.object as DataT);\n      }\n    }\n\n    return renderedFeatures;\n  }\n\n  private _setWGS84PropertyForTiles(): void {\n    const propName = 'dataInWGS84';\n    const tileset: Tileset2D = this.state.tileset;\n\n    // @ts-expect-error selectedTiles are always initialized when tile is being processed\n    tileset.selectedTiles.forEach((tile: Tile2DHeader & ContentWGS84Cache) => {\n      if (!tile.hasOwnProperty(propName)) {\n        // eslint-disable-next-line accessor-pairs\n        Object.defineProperty(tile, propName, {\n          get: () => {\n            // Still loading or encountered an error\n            if (!tile.content) {\n              return null;\n            }\n\n            if (this.state.binary && Array.isArray(tile.content) && !tile.content.length) {\n              // TODO: @loaders.gl/mvt returns [] when no content. It should return a valid empty binary.\n              // https://github.com/visgl/loaders.gl/pull/1137\n              return [];\n            }\n\n            const {bbox} = tile;\n            if (tile._contentWGS84 === undefined && isGeoBoundingBox(bbox)) {\n              // Create a cache to transform only once\n\n              const content = this.state.binary ? binaryToGeojson(tile.content) : tile.content;\n              tile._contentWGS84 = content.map(feature =>\n                transformTileCoordsToWGS84(feature, bbox, this.context.viewport)\n              );\n            }\n            return tile._contentWGS84;\n          }\n        });\n      }\n    });\n  }\n}\n\nfunction getFeatureUniqueId(feature: Feature, uniqueIdProperty: string | undefined) {\n  if (feature.properties && uniqueIdProperty) {\n    return feature.properties[uniqueIdProperty];\n  }\n\n  if ('id' in feature) {\n    return feature.id;\n  }\n\n  return undefined;\n}\n\nfunction getFeatureLayerName(feature: Feature): string | null {\n  return feature.properties?.layerName || null;\n}\n\nfunction isFeatureIdDefined(value: unknown): boolean {\n  return value !== undefined && value !== null && value !== '';\n}\n\nfunction transformTileCoordsToWGS84(\n  object: Feature,\n  bbox: GeoBoundingBox,\n  viewport: Viewport\n): Feature {\n  const feature = {\n    ...object,\n    geometry: {\n      type: object.geometry.type\n    }\n  };\n\n  // eslint-disable-next-line accessor-pairs\n  Object.defineProperty(feature.geometry, 'coordinates', {\n    get: () => {\n      const wgs84Geom = transform(object.geometry, bbox, viewport);\n      return wgs84Geom.coordinates;\n    }\n  });\n\n  return feature as Feature;\n}\n","const BASE32_CODES = '0123456789bcdefghjkmnpqrstuvwxyz';\nconst BASE32_CODES_DICT = {};\nfor (let i = 0; i < BASE32_CODES.length; i++) {\n  BASE32_CODES_DICT[BASE32_CODES.charAt(i)] = i;\n}\n\nconst MIN_LAT = -90;\nconst MAX_LAT = 90;\nconst MIN_LON = -180;\nconst MAX_LON = 180;\n\n// Adapted from ngeohash decode_bbox\nexport function getGeohashBounds(geohash: string): number[] {\n  let isLon = true;\n  let maxLat = MAX_LAT;\n  let minLat = MIN_LAT;\n  let maxLon = MAX_LON;\n  let minLon = MIN_LON;\n  let mid: number;\n\n  let hashValue = 0;\n  for (let i = 0, l = geohash.length; i < l; i++) {\n    const code = geohash[i].toLowerCase();\n    hashValue = BASE32_CODES_DICT[code];\n\n    for (let bits = 4; bits >= 0; bits--) {\n      const bit = (hashValue >> bits) & 1;\n      if (isLon) {\n        mid = (maxLon + minLon) / 2;\n        if (bit === 1) {\n          minLon = mid;\n        } else {\n          maxLon = mid;\n        }\n      } else {\n        mid = (maxLat + minLat) / 2;\n        if (bit === 1) {\n          minLat = mid;\n        } else {\n          maxLat = mid;\n        }\n      }\n      isLon = !isLon;\n    }\n  }\n\n  return [minLat, minLon, maxLat, maxLon];\n}\n\nexport function getGeohashPolygon(geohash: string): number[] {\n  const [s, w, n, e] = getGeohashBounds(geohash);\n\n  return [e, n, e, s, w, s, w, n, e, n];\n}\n","import {AccessorFunction} from '@deck.gl/core';\nimport GeoCellLayer from '../geo-cell-layer/GeoCellLayer';\nimport {getGeohashPolygon} from './geohash-utils';\n\nconst defaultProps = {\n  getGeohash: {type: 'accessor', value: d => d.geohash}\n};\n\n/**\n * Properties of `GeohashLayer`.\n */\ntype GeohashLayerProps<DataT = any> = {\n  /**\n   * Called for each data object to retrieve the geohash string identifier.\n   *\n   * By default, it reads `geohash` property of data object.\n   */\n  getGeohash?: AccessorFunction<DataT, string>;\n};\n\n/** Render filled and/or stroked polygons based on the [Geohash](https://en.wikipedia.org/wiki/Geohash) geospatial indexing system. */\nexport default class GeohashLayer<DataT = any, ExtraProps = {}> extends GeoCellLayer<\n  DataT,\n  Required<GeohashLayerProps> & ExtraProps\n> {\n  static layerName = 'GeohashLayer';\n  static defaultProps: any = defaultProps;\n\n  indexToBounds(): Partial<GeoCellLayer['props']> | null {\n    const {data, getGeohash} = this.props;\n\n    return {\n      data,\n      _normalize: false,\n      positionFormat: 'XY',\n      getPolygon: (x: DataT, objectInfo) => getGeohashPolygon(getGeohash(x, objectInfo))\n    };\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n/* eslint-disable max-len */\n\nexport {default as GreatCircleLayer} from './great-circle-layer/great-circle-layer';\nexport {default as S2Layer} from './s2-layer/s2-layer';\nexport {default as QuadkeyLayer} from './quadkey-layer/quadkey-layer';\nexport {default as TileLayer} from './tile-layer/tile-layer';\nexport {default as TripsLayer} from './trips-layer/trips-layer';\nexport {default as H3ClusterLayer} from './h3-layers/h3-cluster-layer';\nexport {default as H3HexagonLayer} from './h3-layers/h3-hexagon-layer';\nexport {default as Tile3DLayer} from './tile-3d-layer/tile-3d-layer';\nexport {default as TerrainLayer} from './terrain-layer/terrain-layer';\nexport {default as MVTLayer} from './mvt-layer/mvt-layer';\nexport {default as GeohashLayer} from './geohash-layer/geohash-layer';\n\nexport {default as _GeoCellLayer} from './geo-cell-layer/GeoCellLayer';\nexport {getURLFromTemplate as _getURLFromTemplate} from './tile-layer/utils';\nexport {default as _Tileset2D} from './tile-layer/tileset-2d';\nexport {default as _Tile2DHeader} from './tile-layer/tile-2d-header';\n\n// Types\nexport type {H3ClusterLayerProps} from './h3-layers/h3-cluster-layer';\nexport type {H3HexagonLayerProps} from './h3-layers/h3-hexagon-layer';\nexport type {GreatCircleLayerProps} from './great-circle-layer/great-circle-layer';\nexport type {S2LayerProps} from './s2-layer/s2-layer';\nexport type {TileLayerProps} from './tile-layer/tile-layer';\nexport type {GeoBoundingBox, NonGeoBoundingBox} from './tile-layer/types';\nexport type {QuadkeyLayerProps} from './quadkey-layer/quadkey-layer';\nexport type {TileLoadProps as _TileLoadProps} from './tile-layer/types';\nexport type {TerrainLayerProps} from './terrain-layer/terrain-layer';\nexport type {Tile3DLayerProps} from './tile-3d-layer/tile-3d-layer';\nexport type {MVTLayerProps} from './mvt-layer/mvt-layer';\nexport type {GeoCellLayerProps as _GeoCellLayerProps} from './geo-cell-layer/GeoCellLayer';\n","export function fp64ify(a) {\n  let out = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];\n  let startIndex = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;\n  const hiPart = Math.fround(a);\n  const loPart = a - hiPart;\n  out[startIndex] = hiPart;\n  out[startIndex + 1] = loPart;\n  return out;\n}\nexport function fp64LowPart(a) {\n  return a - Math.fround(a);\n}\nexport function fp64ifyMatrix4(matrix) {\n  const matrixFP64 = new Float32Array(32);\n\n  for (let i = 0; i < 4; ++i) {\n    for (let j = 0; j < 4; ++j) {\n      const index = i * 4 + j;\n      fp64ify(matrix[j * 4 + i], matrixFP64, index * 2);\n    }\n  }\n\n  return matrixFP64;\n}\n//# sourceMappingURL=fp64-utils.js.map","import { fp64ify, fp64LowPart, fp64ifyMatrix4 } from './fp64-utils';\nimport fp64arithmeticShader from './fp64-arithmetic.glsl';\nimport fp64functionShader from './fp64-functions.glsl';\nconst CONST_UNIFORMS = {\n  ONE: 1.0\n};\nexport { fp64ify, fp64LowPart, fp64ifyMatrix4 };\n\nfunction getUniforms() {\n  return CONST_UNIFORMS;\n}\n\nexport const fp64arithmetic = {\n  name: 'fp64-arithmetic',\n  vs: fp64arithmeticShader,\n  fs: null,\n  getUniforms,\n  fp64ify,\n  fp64LowPart,\n  fp64ifyMatrix4\n};\nexport const fp64 = {\n  name: 'fp64',\n  vs: fp64functionShader,\n  fs: null,\n  dependencies: [fp64arithmetic],\n  fp64ify,\n  fp64LowPart,\n  fp64ifyMatrix4\n};\n//# sourceMappingURL=fp64.js.map","export default \"uniform float ONE;\\nvec2 split(float a) {\\n  const float SPLIT = 4097.0;\\n  float t = a * SPLIT;\\n#if defined(LUMA_FP64_CODE_ELIMINATION_WORKAROUND)\\n  float a_hi = t * ONE - (t - a);\\n  float a_lo = a * ONE - a_hi;\\n#else\\n  float a_hi = t - (t - a);\\n  float a_lo = a - a_hi;\\n#endif\\n  return vec2(a_hi, a_lo);\\n}\\nvec2 split2(vec2 a) {\\n  vec2 b = split(a.x);\\n  b.y += a.y;\\n  return b;\\n}\\nvec2 quickTwoSum(float a, float b) {\\n#if defined(LUMA_FP64_CODE_ELIMINATION_WORKAROUND)\\n  float sum = (a + b) * ONE;\\n  float err = b - (sum - a) * ONE;\\n#else\\n  float sum = a + b;\\n  float err = b - (sum - a);\\n#endif\\n  return vec2(sum, err);\\n}\\nvec2 twoSum(float a, float b) {\\n  float s = (a + b);\\n#if defined(LUMA_FP64_CODE_ELIMINATION_WORKAROUND)\\n  float v = (s * ONE - a) * ONE;\\n  float err = (a - (s - v) * ONE) * ONE * ONE * ONE + (b - v);\\n#else\\n  float v = s - a;\\n  float err = (a - (s - v)) + (b - v);\\n#endif\\n  return vec2(s, err);\\n}\\n\\nvec2 twoSub(float a, float b) {\\n  float s = (a - b);\\n#if defined(LUMA_FP64_CODE_ELIMINATION_WORKAROUND)\\n  float v = (s * ONE - a) * ONE;\\n  float err = (a - (s - v) * ONE) * ONE * ONE * ONE - (b + v);\\n#else\\n  float v = s - a;\\n  float err = (a - (s - v)) - (b + v);\\n#endif\\n  return vec2(s, err);\\n}\\n\\nvec2 twoSqr(float a) {\\n  float prod = a * a;\\n  vec2 a_fp64 = split(a);\\n#if defined(LUMA_FP64_CODE_ELIMINATION_WORKAROUND)\\n  float err = ((a_fp64.x * a_fp64.x - prod) * ONE + 2.0 * a_fp64.x *\\n    a_fp64.y * ONE * ONE) + a_fp64.y * a_fp64.y * ONE * ONE * ONE;\\n#else\\n  float err = ((a_fp64.x * a_fp64.x - prod) + 2.0 * a_fp64.x * a_fp64.y) + a_fp64.y * a_fp64.y;\\n#endif\\n  return vec2(prod, err);\\n}\\n\\nvec2 twoProd(float a, float b) {\\n  float prod = a * b;\\n  vec2 a_fp64 = split(a);\\n  vec2 b_fp64 = split(b);\\n  float err = ((a_fp64.x * b_fp64.x - prod) + a_fp64.x * b_fp64.y +\\n    a_fp64.y * b_fp64.x) + a_fp64.y * b_fp64.y;\\n  return vec2(prod, err);\\n}\\n\\nvec2 sum_fp64(vec2 a, vec2 b) {\\n  vec2 s, t;\\n  s = twoSum(a.x, b.x);\\n  t = twoSum(a.y, b.y);\\n  s.y += t.x;\\n  s = quickTwoSum(s.x, s.y);\\n  s.y += t.y;\\n  s = quickTwoSum(s.x, s.y);\\n  return s;\\n}\\n\\nvec2 sub_fp64(vec2 a, vec2 b) {\\n  vec2 s, t;\\n  s = twoSub(a.x, b.x);\\n  t = twoSub(a.y, b.y);\\n  s.y += t.x;\\n  s = quickTwoSum(s.x, s.y);\\n  s.y += t.y;\\n  s = quickTwoSum(s.x, s.y);\\n  return s;\\n}\\n\\nvec2 mul_fp64(vec2 a, vec2 b) {\\n  vec2 prod = twoProd(a.x, b.x);\\n  prod.y += a.x * b.y;\\n#if defined(LUMA_FP64_HIGH_BITS_OVERFLOW_WORKAROUND)\\n  prod = split2(prod);\\n#endif\\n  prod = quickTwoSum(prod.x, prod.y);\\n  prod.y += a.y * b.x;\\n#if defined(LUMA_FP64_HIGH_BITS_OVERFLOW_WORKAROUND)\\n  prod = split2(prod);\\n#endif\\n  prod = quickTwoSum(prod.x, prod.y);\\n  return prod;\\n}\\n\\nvec2 div_fp64(vec2 a, vec2 b) {\\n  float xn = 1.0 / b.x;\\n#if defined(LUMA_FP64_HIGH_BITS_OVERFLOW_WORKAROUND)\\n  vec2 yn = mul_fp64(a, vec2(xn, 0));\\n#else\\n  vec2 yn = a * xn;\\n#endif\\n  float diff = (sub_fp64(a, mul_fp64(b, yn))).x;\\n  vec2 prod = twoProd(xn, diff);\\n  return sum_fp64(yn, prod);\\n}\\n\\nvec2 sqrt_fp64(vec2 a) {\\n  if (a.x == 0.0 && a.y == 0.0) return vec2(0.0, 0.0);\\n  if (a.x < 0.0) return vec2(0.0 / 0.0, 0.0 / 0.0);\\n\\n  float x = 1.0 / sqrt(a.x);\\n  float yn = a.x * x;\\n#if defined(LUMA_FP64_CODE_ELIMINATION_WORKAROUND)\\n  vec2 yn_sqr = twoSqr(yn) * ONE;\\n#else\\n  vec2 yn_sqr = twoSqr(yn);\\n#endif\\n  float diff = sub_fp64(a, yn_sqr).x;\\n  vec2 prod = twoProd(x * 0.5, diff);\\n#if defined(LUMA_FP64_HIGH_BITS_OVERFLOW_WORKAROUND)\\n  return sum_fp64(split(yn), prod);\\n#else\\n  return sum_fp64(vec2(yn, 0.0), prod);\\n#endif\\n}\\n\";\n//# sourceMappingURL=fp64-arithmetic.glsl.js.map","// Copyright (c) 2015 - 2019 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport const AGGREGATION_OPERATION = {\n  SUM: 1,\n  MEAN: 2,\n  MIN: 3,\n  MAX: 4\n};\n\nfunction sumReducer(accu, cur) {\n  return accu + cur;\n}\n\nfunction maxReducer(accu, cur) {\n  return cur > accu ? cur : accu;\n}\n\nfunction minReducer(accu, cur) {\n  return cur < accu ? cur : accu;\n}\n\nexport function getMean(pts, accessor) {\n  if (Number.isFinite(accessor)) {\n    return pts.length ? accessor : null;\n  }\n  const filtered = pts.map(accessor).filter(Number.isFinite);\n\n  return filtered.length ? filtered.reduce(sumReducer, 0) / filtered.length : null;\n}\n\nexport function getSum(pts, accessor) {\n  if (Number.isFinite(accessor)) {\n    return pts.length ? pts.length * accessor : null;\n  }\n  const filtered = pts.map(accessor).filter(Number.isFinite);\n\n  return filtered.length ? filtered.reduce(sumReducer, 0) : null;\n}\n\nexport function getMax(pts, accessor) {\n  if (Number.isFinite(accessor)) {\n    return pts.length ? accessor : null;\n  }\n  const filtered = pts.map(accessor).filter(Number.isFinite);\n\n  return filtered.length ? filtered.reduce(maxReducer, -Infinity) : null;\n}\n\nexport function getMin(pts, accessor) {\n  if (Number.isFinite(accessor)) {\n    return pts.length ? accessor : null;\n  }\n  const filtered = pts.map(accessor).filter(Number.isFinite);\n\n  return filtered.length ? filtered.reduce(minReducer, Infinity) : null;\n}\n\n// Function to convert from aggregation/accessor props (like colorAggregation and getColorWeight) to getValue prop (like getColorValue)\nexport function getValueFunc(aggregation, accessor, context) {\n  const op = AGGREGATION_OPERATION[aggregation] || AGGREGATION_OPERATION.SUM;\n  accessor = wrapAccessor(accessor, context);\n  switch (op) {\n    case AGGREGATION_OPERATION.MIN:\n      return pts => getMin(pts, accessor);\n    case AGGREGATION_OPERATION.SUM:\n      return pts => getSum(pts, accessor);\n    case AGGREGATION_OPERATION.MEAN:\n      return pts => getMean(pts, accessor);\n    case AGGREGATION_OPERATION.MAX:\n      return pts => getMax(pts, accessor);\n    default:\n      return null;\n  }\n}\n\nfunction wrapAccessor(accessor, context = {}) {\n  if (Number.isFinite(accessor)) {\n    return accessor;\n  }\n  return pt => {\n    context.index = pt.index;\n    return accessor(pt.source, context);\n  };\n}\n\nexport function wrapGetValueFunc(getValue, context = {}) {\n  return pts => {\n    context.indices = pts.map(pt => pt.index);\n    return getValue(\n      pts.map(pt => pt.source),\n      context\n    );\n  };\n}\n","import GL from '@luma.gl/constants';\nimport {AGGREGATION_OPERATION} from '../aggregation-operation-utils';\n\nexport const DEFAULT_RUN_PARAMS = {\n  projectPoints: false,\n  viewport: null,\n  createBufferObjects: true,\n  moduleSettings: {}\n};\n\nexport const MAX_32_BIT_FLOAT = 3.402823466e38;\nexport const MIN_BLEND_EQUATION = [GL.MIN, GL.FUNC_ADD];\nexport const MAX_BLEND_EQUATION = [GL.MAX, GL.FUNC_ADD];\nexport const MAX_MIN_BLEND_EQUATION = [GL.MAX, GL.MIN];\nexport const EQUATION_MAP = {\n  [AGGREGATION_OPERATION.SUM]: GL.FUNC_ADD,\n  [AGGREGATION_OPERATION.MEAN]: GL.FUNC_ADD,\n  [AGGREGATION_OPERATION.MIN]: MIN_BLEND_EQUATION,\n  [AGGREGATION_OPERATION.MAX]: MAX_BLEND_EQUATION\n};\n\nexport const ELEMENTCOUNT = 4;\nexport const DEFAULT_WEIGHT_PARAMS = {\n  size: 1,\n  operation: AGGREGATION_OPERATION.SUM,\n  needMin: false,\n  needMax: false,\n  combineMaxMin: false\n};\n\nexport const PIXEL_SIZE = 4; // RGBA32F\nexport const WEIGHT_SIZE = 3;\n\nexport const MAX_MIN_TEXTURE_OPTS = {\n  format: GL.RGBA32F,\n  type: GL.FLOAT,\n  border: 0,\n  mipmaps: false,\n  parameters: {\n    [GL.TEXTURE_MAG_FILTER]: GL.NEAREST,\n    [GL.TEXTURE_MIN_FILTER]: GL.NEAREST\n  },\n  dataFormat: GL.RGBA,\n  width: 1,\n  height: 1\n};\n","import GL from '@luma.gl/constants';\nimport {Framebuffer, Texture2D, isWebGL2} from '@luma.gl/core';\n\nconst DEFAULT_PARAMETERS = {\n  [GL.TEXTURE_MAG_FILTER]: GL.NEAREST,\n  [GL.TEXTURE_MIN_FILTER]: GL.NEAREST\n};\n\nexport function getFloatTexture(gl, opts = {}) {\n  const {\n    width = 1,\n    height = 1,\n    data = null,\n    unpackFlipY = true,\n    parameters = DEFAULT_PARAMETERS\n  } = opts;\n  const texture = new Texture2D(gl, {\n    data,\n    format: isWebGL2(gl) ? GL.RGBA32F : GL.RGBA,\n    type: GL.FLOAT,\n    border: 0,\n    mipmaps: false,\n    parameters,\n    dataFormat: GL.RGBA,\n    width,\n    height,\n    unpackFlipY\n  });\n  return texture;\n}\n\nexport function getFramebuffer(gl, opts) {\n  const {id, width = 1, height = 1, texture} = opts;\n  const fb = new Framebuffer(gl, {\n    id,\n    width,\n    height,\n    attachments: {\n      [GL.COLOR_ATTACHMENT0]: texture\n    }\n  });\n\n  return fb;\n}\n\nexport function getFloatArray(array, size, fillValue = 0) {\n  if (!array || array.length < size) {\n    return new Float32Array(size).fill(fillValue);\n  }\n  return array;\n}\n","// Copyright (c) 2015 - 2018 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport GL from '@luma.gl/constants';\nimport {\n  Model,\n  Transform,\n  FEATURES,\n  hasFeatures,\n  isWebGL2,\n  readPixelsToBuffer,\n  withParameters\n} from '@luma.gl/core';\nimport {fp64arithmetic} from '@luma.gl/shadertools';\nimport {log, project32, _mergeShaders as mergeShaders} from '@deck.gl/core';\n\nimport {\n  DEFAULT_RUN_PARAMS,\n  MAX_32_BIT_FLOAT,\n  MIN_BLEND_EQUATION,\n  MAX_BLEND_EQUATION,\n  MAX_MIN_BLEND_EQUATION,\n  EQUATION_MAP,\n  DEFAULT_WEIGHT_PARAMS,\n  PIXEL_SIZE\n} from './gpu-grid-aggregator-constants';\nimport {AGGREGATION_OPERATION} from '../aggregation-operation-utils';\n\nimport AGGREGATE_TO_GRID_VS from './aggregate-to-grid-vs.glsl';\nimport AGGREGATE_TO_GRID_FS from './aggregate-to-grid-fs.glsl';\nimport AGGREGATE_ALL_VS from './aggregate-all-vs.glsl';\nimport AGGREGATE_ALL_FS from './aggregate-all-fs.glsl';\nimport TRANSFORM_MEAN_VS from './transform-mean-vs.glsl';\nimport {getFloatTexture, getFramebuffer} from './../resource-utils.js';\n\nconst BUFFER_NAMES = ['aggregationBuffer', 'maxMinBuffer', 'minBuffer', 'maxBuffer'];\nconst ARRAY_BUFFER_MAP = {\n  maxData: 'maxBuffer',\n  minData: 'minBuffer',\n  maxMinData: 'maxMinBuffer'\n};\n\nconst REQUIRED_FEATURES = [\n  FEATURES.WEBGL2, // TODO: Remove after trannsform refactor\n  FEATURES.COLOR_ATTACHMENT_RGBA32F,\n  FEATURES.BLEND_EQUATION_MINMAX,\n  FEATURES.FLOAT_BLEND,\n  FEATURES.TEXTURE_FLOAT\n];\n\nexport default class GPUGridAggregator {\n  // Decode and return aggregation data of given pixel.\n  static getAggregationData({aggregationData, maxData, minData, maxMinData, pixelIndex}) {\n    const index = pixelIndex * PIXEL_SIZE;\n    const results = {};\n    if (aggregationData) {\n      results.cellCount = aggregationData[index + 3];\n      results.cellWeight = aggregationData[index];\n    }\n    if (maxMinData) {\n      results.maxCellWieght = maxMinData[0];\n      results.minCellWeight = maxMinData[3];\n    } else {\n      if (maxData) {\n        results.maxCellWieght = maxData[0];\n        results.totalCount = maxData[3];\n      }\n      if (minData) {\n        results.minCellWeight = minData[0];\n        results.totalCount = maxData[3];\n      }\n    }\n    return results;\n  }\n\n  // Decodes and retuns counts and weights of all cells\n  static getCellData({countsData, size = 1}) {\n    const numCells = countsData.length / 4;\n    const cellWeights = new Float32Array(numCells * size);\n    const cellCounts = new Uint32Array(numCells);\n    for (let i = 0; i < numCells; i++) {\n      // weights in RGB channels\n      for (let sizeIndex = 0; sizeIndex < size; sizeIndex++) {\n        cellWeights[i * size + sizeIndex] = countsData[i * 4 + sizeIndex];\n      }\n      // count in Alpha channel\n      cellCounts[i] = countsData[i * 4 + 3];\n    }\n    return {cellCounts, cellWeights};\n  }\n\n  static isSupported(gl) {\n    return hasFeatures(gl, REQUIRED_FEATURES);\n  }\n\n  // DEBUG ONLY\n  // static logData({aggregationBuffer, minBuffer, maxBuffer, maxMinBuffer, limit = 10}) {\n  //   if (aggregationBuffer) {\n  //     console.log('Aggregation Data:');\n  //     const agrData = aggregationBuffer.getData();\n  //     for (let index = 0; index < agrData.length && limit > 0; index += 4) {\n  //       if (agrData[index + 3] > 0) {\n  //         console.log(\n  //           `index: ${index} weights: ${agrData[index]} ${agrData[index + 1]} ${\n  //             agrData[index + 2]\n  //           } count: ${agrData[index + 3]}`\n  //         );\n  //         limit--;\n  //       }\n  //     }\n  //   }\n  //   const obj = {minBuffer, maxBuffer, maxMinBuffer};\n  //   for (const key in obj) {\n  //     if (obj[key]) {\n  //       const data = obj[key].getData();\n  //       console.log(`${key} data : R: ${data[0]} G: ${data[1]} B: ${data[2]} A: ${data[3]}`);\n  //     }\n  //   }\n  // }\n\n  constructor(gl, opts = {}) {\n    this.id = opts.id || 'gpu-grid-aggregator';\n    this.gl = gl;\n    this.state = {\n      // per weight GPU resources\n      weightAttributes: {},\n      textures: {},\n      meanTextures: {},\n      buffers: {},\n      framebuffers: {},\n      maxMinFramebuffers: {},\n      minFramebuffers: {},\n      maxFramebuffers: {},\n      equations: {},\n\n      // common resources to be deleted\n      resources: {},\n\n      // results\n      results: {}\n    };\n    this._hasGPUSupport =\n      isWebGL2(gl) && // gl_InstanceID usage in min/max calculation shaders\n      hasFeatures(\n        this.gl,\n        FEATURES.BLEND_EQUATION_MINMAX, // set min/max blend modes\n        FEATURES.COLOR_ATTACHMENT_RGBA32F, // render to float texture\n        FEATURES.TEXTURE_FLOAT // sample from a float texture\n      );\n    if (this._hasGPUSupport) {\n      this._setupModels();\n    }\n  }\n\n  // Delete owned resources.\n  delete() {\n    const {gridAggregationModel, allAggregationModel, meanTransform} = this;\n    const {\n      textures,\n      framebuffers,\n      maxMinFramebuffers,\n      minFramebuffers,\n      maxFramebuffers,\n      meanTextures,\n      resources\n    } = this.state;\n\n    gridAggregationModel?.delete();\n    allAggregationModel?.delete();\n    meanTransform?.delete();\n\n    deleteResources([\n      framebuffers,\n      textures,\n      maxMinFramebuffers,\n      minFramebuffers,\n      maxFramebuffers,\n      meanTextures,\n      resources\n    ]);\n  }\n\n  // Perform aggregation and retun the results\n  run(opts = {}) {\n    // reset results\n    this.setState({results: {}});\n    const aggregationParams = this._normalizeAggregationParams(opts);\n    if (!this._hasGPUSupport) {\n      log.log(1, 'GPUGridAggregator: not supported')();\n    }\n    return this._runAggregation(aggregationParams);\n  }\n\n  // Reads aggregation data into JS Array object\n  // For WebGL1, data is available in JS Array objects already.\n  // For WebGL2, data is read from Buffer objects and cached for subsequent queries.\n  getData(weightId) {\n    const data = {};\n    const results = this.state.results;\n    if (!results[weightId].aggregationData) {\n      // cache the results if reading from the buffer (WebGL2 path)\n      results[weightId].aggregationData = results[weightId].aggregationBuffer.getData();\n    }\n    data.aggregationData = results[weightId].aggregationData;\n\n    // Check for optional results\n    for (const arrayName in ARRAY_BUFFER_MAP) {\n      const bufferName = ARRAY_BUFFER_MAP[arrayName];\n\n      if (results[weightId][arrayName] || results[weightId][bufferName]) {\n        // cache the result\n        results[weightId][arrayName] =\n          results[weightId][arrayName] || results[weightId][bufferName].getData();\n        data[arrayName] = results[weightId][arrayName];\n      }\n    }\n    return data;\n  }\n\n  updateShaders(shaderOptions = {}) {\n    this.setState({shaderOptions, modelDirty: true});\n  }\n\n  // PRIVATE\n\n  _normalizeAggregationParams(opts) {\n    const aggregationParams = {...DEFAULT_RUN_PARAMS, ...opts};\n    const {weights} = aggregationParams;\n    if (weights) {\n      aggregationParams.weights = normalizeWeightParams(weights);\n    }\n    return aggregationParams;\n  }\n\n  // Update priveate state\n  setState(updateObject) {\n    Object.assign(this.state, updateObject);\n  }\n\n  // GPU Aggregation methods\n\n  _getAggregateData(opts) {\n    const results = {};\n    const {\n      textures,\n      framebuffers,\n      maxMinFramebuffers,\n      minFramebuffers,\n      maxFramebuffers,\n      resources\n    } = this.state;\n    const {weights} = opts;\n\n    for (const id in weights) {\n      results[id] = {};\n      const {needMin, needMax, combineMaxMin} = weights[id];\n      results[id].aggregationTexture = textures[id];\n      results[id].aggregationBuffer = readPixelsToBuffer(framebuffers[id], {\n        target: weights[id].aggregationBuffer, // update if a buffer is provided\n        sourceType: GL.FLOAT\n      });\n      if (needMin && needMax && combineMaxMin) {\n        results[id].maxMinBuffer = readPixelsToBuffer(maxMinFramebuffers[id], {\n          target: weights[id].maxMinBuffer, // update if a buffer is provided\n          sourceType: GL.FLOAT\n        });\n        results[id].maxMinTexture = resources[`${id}-maxMinTexture`];\n      } else {\n        if (needMin) {\n          results[id].minBuffer = readPixelsToBuffer(minFramebuffers[id], {\n            target: weights[id].minBuffer, // update if a buffer is provided\n            sourceType: GL.FLOAT\n          });\n          results[id].minTexture = resources[`${id}-minTexture`];\n        }\n        if (needMax) {\n          results[id].maxBuffer = readPixelsToBuffer(maxFramebuffers[id], {\n            target: weights[id].maxBuffer, // update if a buffer is provided\n            sourceType: GL.FLOAT\n          });\n          results[id].maxTexture = resources[`${id}-maxTexture`];\n        }\n      }\n    }\n    this._trackGPUResultBuffers(results, weights);\n    return results;\n  }\n\n  _renderAggregateData(opts) {\n    const {\n      cellSize,\n      projectPoints,\n      attributes,\n      moduleSettings,\n      numCol,\n      numRow,\n      weights,\n      translation,\n      scaling\n    } = opts;\n    const {maxMinFramebuffers, minFramebuffers, maxFramebuffers} = this.state;\n\n    const gridSize = [numCol, numRow];\n    const parameters = {\n      blend: true,\n      depthTest: false,\n      blendFunc: [GL.ONE, GL.ONE]\n    };\n    const uniforms = {\n      cellSize,\n      gridSize,\n      projectPoints,\n      translation,\n      scaling\n    };\n\n    for (const id in weights) {\n      const {needMin, needMax} = weights[id];\n      const combineMaxMin = needMin && needMax && weights[id].combineMaxMin;\n      this._renderToWeightsTexture({\n        id,\n        parameters,\n        moduleSettings,\n        uniforms,\n        gridSize,\n        attributes,\n        weights\n      });\n      if (combineMaxMin) {\n        this._renderToMaxMinTexture({\n          id,\n          parameters: {...parameters, blendEquation: MAX_MIN_BLEND_EQUATION},\n          gridSize,\n          minOrMaxFb: maxMinFramebuffers[id],\n          clearParams: {clearColor: [0, 0, 0, MAX_32_BIT_FLOAT]},\n          combineMaxMin\n        });\n      } else {\n        if (needMin) {\n          this._renderToMaxMinTexture({\n            id,\n            parameters: {...parameters, blendEquation: MIN_BLEND_EQUATION},\n            gridSize,\n            minOrMaxFb: minFramebuffers[id],\n            clearParams: {clearColor: [MAX_32_BIT_FLOAT, MAX_32_BIT_FLOAT, MAX_32_BIT_FLOAT, 0]},\n            combineMaxMin\n          });\n        }\n        if (needMax) {\n          this._renderToMaxMinTexture({\n            id,\n            parameters: {...parameters, blendEquation: MAX_BLEND_EQUATION},\n            gridSize,\n            minOrMaxFb: maxFramebuffers[id],\n            clearParams: {clearColor: [0, 0, 0, 0]},\n            combineMaxMin\n          });\n        }\n      }\n    }\n  }\n\n  // render all aggregated grid-cells to generate Min, Max or MaxMin data texture\n  _renderToMaxMinTexture(opts) {\n    const {id, parameters, gridSize, minOrMaxFb, combineMaxMin, clearParams = {}} = opts;\n    const {framebuffers} = this.state;\n    const {gl, allAggregationModel} = this;\n\n    withParameters(\n      gl,\n      {\n        ...clearParams,\n        framebuffer: minOrMaxFb,\n        viewport: [0, 0, gridSize[0], gridSize[1]]\n      },\n      () => {\n        gl.clear(gl.COLOR_BUFFER_BIT);\n\n        allAggregationModel.draw({\n          parameters,\n          uniforms: {\n            uSampler: framebuffers[id].texture,\n            gridSize,\n            combineMaxMin\n          }\n        });\n      }\n    );\n  }\n\n  // render all data points to aggregate weights\n  _renderToWeightsTexture(opts) {\n    const {id, parameters, moduleSettings, uniforms, gridSize, weights} = opts;\n    const {framebuffers, equations, weightAttributes} = this.state;\n    const {gl, gridAggregationModel} = this;\n    const {operation} = weights[id];\n\n    const clearColor =\n      operation === AGGREGATION_OPERATION.MIN\n        ? [MAX_32_BIT_FLOAT, MAX_32_BIT_FLOAT, MAX_32_BIT_FLOAT, 0]\n        : [0, 0, 0, 0];\n    withParameters(\n      gl,\n      {\n        framebuffer: framebuffers[id],\n        viewport: [0, 0, gridSize[0], gridSize[1]],\n        clearColor\n      },\n      () => {\n        gl.clear(gl.COLOR_BUFFER_BIT);\n\n        const attributes = {weights: weightAttributes[id]};\n        gridAggregationModel.draw({\n          parameters: {...parameters, blendEquation: equations[id]},\n          moduleSettings,\n          uniforms,\n          attributes\n        });\n      }\n    );\n\n    if (operation === AGGREGATION_OPERATION.MEAN) {\n      const {meanTextures, textures} = this.state;\n      const transformOptions = {\n        _sourceTextures: {aggregationValues: meanTextures[id]}, // contains aggregated data\n        _targetTexture: textures[id], // store mean values,\n        elementCount: textures[id].width * textures[id].height\n      };\n      if (this.meanTransform) {\n        this.meanTransform.update(transformOptions);\n      } else {\n        this.meanTransform = getMeanTransform(gl, transformOptions);\n      }\n      this.meanTransform.run({\n        parameters: {\n          blend: false,\n          depthTest: false\n        }\n      });\n\n      // update framebuffer with mean results so readPixelsToBuffer returns mean values\n      framebuffers[id].attach({[GL.COLOR_ATTACHMENT0]: textures[id]});\n    }\n  }\n\n  _runAggregation(opts) {\n    this._updateModels(opts);\n    this._setupFramebuffers(opts);\n    this._renderAggregateData(opts);\n    const results = this._getAggregateData(opts);\n    this.setState({results});\n    return results;\n  }\n\n  // set up framebuffer for each weight\n  /* eslint-disable complexity, max-depth, max-statements*/\n  _setupFramebuffers(opts) {\n    const {\n      textures,\n      framebuffers,\n      maxMinFramebuffers,\n      minFramebuffers,\n      maxFramebuffers,\n      meanTextures,\n      equations\n    } = this.state;\n    const {weights} = opts;\n    const {numCol, numRow} = opts;\n    const framebufferSize = {width: numCol, height: numRow};\n    for (const id in weights) {\n      const {needMin, needMax, combineMaxMin, operation} = weights[id];\n      textures[id] =\n        weights[id].aggregationTexture ||\n        textures[id] ||\n        getFloatTexture(this.gl, {id: `${id}-texture`, width: numCol, height: numRow});\n      textures[id].resize(framebufferSize);\n      let texture = textures[id];\n      if (operation === AGGREGATION_OPERATION.MEAN) {\n        // For MEAN, we first aggregatet into a temp texture\n        meanTextures[id] =\n          meanTextures[id] ||\n          getFloatTexture(this.gl, {id: `${id}-mean-texture`, width: numCol, height: numRow});\n        meanTextures[id].resize(framebufferSize);\n        texture = meanTextures[id];\n      }\n      if (framebuffers[id]) {\n        framebuffers[id].attach({[GL.COLOR_ATTACHMENT0]: texture});\n      } else {\n        framebuffers[id] = getFramebuffer(this.gl, {\n          id: `${id}-fb`,\n          width: numCol,\n          height: numRow,\n          texture\n        });\n      }\n      framebuffers[id].resize(framebufferSize);\n      equations[id] = EQUATION_MAP[operation] || EQUATION_MAP.SUM;\n      // For min/max framebuffers will use default size 1X1\n      if (needMin || needMax) {\n        if (needMin && needMax && combineMaxMin) {\n          if (!maxMinFramebuffers[id]) {\n            texture = weights[id].maxMinTexture || this._getMinMaxTexture(`${id}-maxMinTexture`);\n            maxMinFramebuffers[id] = getFramebuffer(this.gl, {id: `${id}-maxMinFb`, texture});\n          }\n        } else {\n          if (needMin) {\n            if (!minFramebuffers[id]) {\n              texture = weights[id].minTexture || this._getMinMaxTexture(`${id}-minTexture`);\n              minFramebuffers[id] = getFramebuffer(this.gl, {\n                id: `${id}-minFb`,\n                texture\n              });\n            }\n          }\n          if (needMax) {\n            if (!maxFramebuffers[id]) {\n              texture = weights[id].maxTexture || this._getMinMaxTexture(`${id}-maxTexture`);\n              maxFramebuffers[id] = getFramebuffer(this.gl, {\n                id: `${id}-maxFb`,\n                texture\n              });\n            }\n          }\n        }\n      }\n    }\n  }\n  /* eslint-enable complexity, max-depth, max-statements */\n\n  _getMinMaxTexture(name) {\n    const {resources} = this.state;\n    if (!resources[name]) {\n      resources[name] = getFloatTexture(this.gl, {id: `resourceName`});\n    }\n    return resources[name];\n  }\n\n  _setupModels({numCol = 0, numRow = 0} = {}) {\n    const {gl} = this;\n    const {shaderOptions} = this.state;\n    this.gridAggregationModel?.delete();\n    this.gridAggregationModel = getAggregationModel(gl, shaderOptions);\n    if (!this.allAggregationModel) {\n      const instanceCount = numCol * numRow;\n      this.allAggregationModel = getAllAggregationModel(gl, instanceCount);\n    }\n  }\n\n  // set up buffers for all weights\n  _setupWeightAttributes(opts) {\n    const {weightAttributes} = this.state;\n    const {weights} = opts;\n    for (const id in weights) {\n      weightAttributes[id] = opts.attributes[id];\n    }\n  }\n\n  // GPU Aggregation results are provided in Buffers, if new Buffer objects are created track them for later deletion.\n  /* eslint-disable max-depth */\n  _trackGPUResultBuffers(results, weights) {\n    const {resources} = this.state;\n    for (const id in results) {\n      if (results[id]) {\n        for (const bufferName of BUFFER_NAMES) {\n          if (results[id][bufferName] && weights[id][bufferName] !== results[id][bufferName]) {\n            // No result buffer is provided in weights object, `readPixelsToBuffer` has created a new Buffer object\n            // collect the new buffer for garabge collection\n            const name = `gpu-result-${id}-${bufferName}`;\n            if (resources[name]) {\n              resources[name].delete();\n            }\n            resources[name] = results[id][bufferName];\n          }\n        }\n      }\n    }\n  }\n  /* eslint-enable max-depth */\n\n  _updateModels(opts) {\n    const {vertexCount, attributes, numCol, numRow} = opts;\n    const {modelDirty} = this.state;\n\n    if (modelDirty) {\n      this._setupModels(opts);\n      this.setState({modelDirty: false});\n    }\n\n    // this maps color/elevation to weight name.\n    this._setupWeightAttributes(opts);\n\n    this.gridAggregationModel.setVertexCount(vertexCount);\n    this.gridAggregationModel.setAttributes(attributes);\n\n    this.allAggregationModel.setInstanceCount(numCol * numRow);\n  }\n}\n\n// HELPER METHODS\n\nfunction normalizeWeightParams(weights) {\n  const result = {};\n  for (const id in weights) {\n    result[id] = {...DEFAULT_WEIGHT_PARAMS, ...weights[id]};\n  }\n  return result;\n}\n\nfunction deleteResources(resources) {\n  resources = Array.isArray(resources) ? resources : [resources];\n  resources.forEach(obj => {\n    for (const name in obj) {\n      obj[name].delete();\n    }\n  });\n}\n\nfunction getAggregationModel(gl, shaderOptions) {\n  const shaders = mergeShaders(\n    {\n      vs: AGGREGATE_TO_GRID_VS,\n      fs: AGGREGATE_TO_GRID_FS,\n      modules: [fp64arithmetic, project32]\n    },\n    shaderOptions\n  );\n\n  return new Model(gl, {\n    id: 'Gird-Aggregation-Model',\n    vertexCount: 1,\n    drawMode: GL.POINTS,\n    ...shaders\n  });\n}\n\nfunction getAllAggregationModel(gl, instanceCount) {\n  return new Model(gl, {\n    id: 'All-Aggregation-Model',\n    vs: AGGREGATE_ALL_VS,\n    fs: AGGREGATE_ALL_FS,\n    modules: [fp64arithmetic],\n    vertexCount: 1,\n    drawMode: GL.POINTS,\n    isInstanced: true,\n    instanceCount,\n    attributes: {\n      position: [0, 0]\n    }\n  });\n}\n\nfunction getMeanTransform(gl, opts) {\n  return new Transform(gl, {\n    vs: TRANSFORM_MEAN_VS,\n    _targetTextureVarying: 'meanValues',\n    ...opts\n  });\n}\n","// Copyright (c) 2015 - 2018 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME gpu-aggregation-transform-mean-vs\nattribute vec4 aggregationValues;\nvarying vec4 meanValues;\n\nvoid main()\n{\n  // TODO: Use 64-bit division ?? not needed given this is aggregation ??\n  bool isCellValid = bool(aggregationValues.w > 0.);\n  // aggregationValues:  XYZ contain aggregated values, W contains count\n  meanValues.xyz = isCellValid ? aggregationValues.xyz/aggregationValues.w : vec3(0, 0, 0);\n  meanValues.w = aggregationValues.w;\n\n  // Enforce default value for ANGLE issue (https://bugs.chromium.org/p/angleproject/issues/detail?id=3941)\n  gl_PointSize = 1.0;\n}\n`;\n","// Copyright (c) 2015 - 2018 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME gpu-aggregation-to-grid-vs\n\nattribute vec3 positions;\nattribute vec3 positions64Low;\nattribute vec3 weights;\nuniform vec2 cellSize;\nuniform vec2 gridSize;\nuniform bool projectPoints;\nuniform vec2 translation;\nuniform vec3 scaling;\n\nvarying vec3 vWeights;\n\nvec2 project_to_pixel(vec4 pos) {\n  vec4 result;\n  pos.xy = pos.xy/pos.w;\n  result = pos + vec4(translation, 0., 0.);\n  result.xy = scaling.z > 0. ? result.xy * scaling.xy : result.xy;\n  return result.xy;\n}\n\nvoid main(void) {\n\n  vWeights = weights;\n\n  vec4 windowPos = vec4(positions, 1.);\n  if (projectPoints) {\n    windowPos = project_position_to_clipspace(positions, positions64Low, vec3(0));\n  }\n\n  vec2 pos = project_to_pixel(windowPos);\n\n  vec2 pixelXY64[2];\n  pixelXY64[0] = vec2(pos.x, 0.);\n  pixelXY64[1] = vec2(pos.y, 0.);\n\n  // Transform (0,0):windowSize -> (0, 0): gridSize\n  vec2 gridXY64[2];\n  gridXY64[0] = div_fp64(pixelXY64[0], vec2(cellSize.x, 0));\n  gridXY64[1] = div_fp64(pixelXY64[1], vec2(cellSize.y, 0));\n  float x = floor(gridXY64[0].x);\n  float y = floor(gridXY64[1].x);\n  pos = vec2(x, y);\n\n  // Transform (0,0):gridSize -> (-1, -1):(1,1)\n  pos = (pos * (2., 2.) / (gridSize)) - (1., 1.);\n\n  // Move to pixel center, pixel-size in screen sapce (2/gridSize) * 0.5 => 1/gridSize\n  vec2 offset = 1.0 / gridSize;\n  pos = pos + offset;\n\n  gl_Position = vec4(pos, 0.0, 1.0);\n\n  // Enforce default value for ANGLE issue (https://bugs.chromium.org/p/angleproject/issues/detail?id=3941)\n  gl_PointSize = 1.0;\n}\n`;\n","// Copyright (c) 2015 - 2018 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME gpu-aggregation-to-grid-fs\n\nprecision highp float;\n\nvarying vec3 vWeights;\n\nvoid main(void) {\n  gl_FragColor = vec4(vWeights, 1.0);\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2018 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#version 300 es\n#define SHADER_NAME gpu-aggregation-all-vs-64\n\nin vec2 position;\nuniform ivec2 gridSize;\nout vec2 vTextureCoord;\n\nvoid main(void) {\n  // Map each position to single pixel\n  vec2 pos = vec2(-1.0, -1.0);\n\n  // Move to pixel center, pixel-size in screen sapce (2/gridSize) * 0.5 => 1/gridSize\n  vec2 offset = 1.0 / vec2(gridSize);\n  pos = pos + offset;\n\n  gl_Position = vec4(pos, 0.0, 1.0);\n\n  int yIndex = gl_InstanceID / gridSize[0];\n  int xIndex = gl_InstanceID - (yIndex * gridSize[0]);\n\n  vec2 yIndexFP64 = vec2(float(yIndex), 0.);\n  vec2 xIndexFP64 = vec2(float(xIndex), 0.);\n  vec2 gridSizeYFP64 = vec2(gridSize[1], 0.);\n  vec2 gridSizeXFP64 = vec2(gridSize[0], 0.);\n\n  vec2 texCoordXFP64 = div_fp64(yIndexFP64, gridSizeYFP64);\n  vec2 texCoordYFP64 = div_fp64(xIndexFP64, gridSizeXFP64);\n\n  vTextureCoord = vec2(texCoordYFP64.x, texCoordXFP64.x);\n  // Enforce default value for ANGLE issue (https://bugs.chromium.org/p/angleproject/issues/detail?id=3941)\n  gl_PointSize = 1.0;\n}\n`;\n","// Copyright (c) 2015 - 2018 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#version 300 es\n#define SHADER_NAME gpu-aggregation-all-fs\n\nprecision highp float;\n\nin vec2 vTextureCoord;\nuniform sampler2D uSampler;\nuniform bool combineMaxMin;\nout vec4 fragColor;\nvoid main(void) {\n  vec4 textureColor = texture(uSampler, vec2(vTextureCoord.s, vTextureCoord.t));\n  if (textureColor.a == 0.) {\n    discard;\n  }\n  fragColor.rgb = textureColor.rgb;\n  // if combineMinMax is true, use Alpha channel for first weights min value.\n  fragColor.a = combineMaxMin ? textureColor.r : textureColor.a;\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport const defaultColorRange: [number, number, number][] = [\n  [255, 255, 178],\n  [254, 217, 118],\n  [254, 178, 76],\n  [253, 141, 60],\n  [240, 59, 32],\n  [189, 0, 38]\n];\n\n// Converts a colorRange array to a flat array with 4 components per color\nexport function colorRangeToFlatArray(colorRange, normalize = false, ArrayType = Float32Array) {\n  let flatArray;\n\n  if (Number.isFinite(colorRange[0])) {\n    // its already a flat array.\n    flatArray = new ArrayType(colorRange);\n  } else {\n    // flatten it\n    flatArray = new ArrayType(colorRange.length * 4);\n    let index = 0;\n\n    for (let i = 0; i < colorRange.length; i++) {\n      const color = colorRange[i];\n      flatArray[index++] = color[0];\n      flatArray[index++] = color[1];\n      flatArray[index++] = color[2];\n      flatArray[index++] = Number.isFinite(color[3]) ? color[3] : 255;\n    }\n  }\n\n  if (normalize) {\n    for (let i = 0; i < flatArray.length; i++) {\n      flatArray[i] /= 255;\n    }\n  }\n  return flatArray;\n}\n","// Copyright (c) 2015 - 2019 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport GL from '@luma.gl/constants';\nimport {Model, Geometry, FEATURES, hasFeatures, Texture2D, DefaultProps} from '@luma.gl/core';\nimport {Layer, LayerProps, log, picking, UpdateParameters} from '@deck.gl/core';\nimport {defaultColorRange, colorRangeToFlatArray} from '../utils/color-utils';\nimport vs from './screen-grid-layer-vertex.glsl';\nimport fs from './screen-grid-layer-fragment.glsl';\nimport type {_ScreenGridLayerProps} from './screen-grid-layer';\n\nconst DEFAULT_MINCOLOR = [0, 0, 0, 0];\nconst DEFAULT_MAXCOLOR = [0, 255, 0, 255];\nconst COLOR_PROPS = ['minColor', 'maxColor', 'colorRange', 'colorDomain'];\n\nconst defaultProps: DefaultProps<ScreenGridCellLayerProps> = {\n  cellSizePixels: {value: 100, min: 1},\n  cellMarginPixels: {value: 2, min: 0, max: 5},\n\n  colorDomain: null,\n  colorRange: defaultColorRange\n};\n\n/** All properties supported by ScreenGridCellLayer. */\nexport type ScreenGridCellLayerProps<DataT = any> = _ScreenGridCellLayerProps<DataT> &\n  LayerProps<DataT>;\n\n/** Proprties added by ScreenGridCellLayer. */\nexport type _ScreenGridCellLayerProps<DataT> = _ScreenGridLayerProps<DataT> & {\n  maxTexture: Texture2D;\n};\n\nexport default class ScreenGridCellLayer<DataT = any, ExtraPropsT = {}> extends Layer<\n  ExtraPropsT & Required<_ScreenGridCellLayerProps<DataT>>\n> {\n  static layerName = 'ScreenGridCellLayer';\n  static defaultProps = defaultProps;\n\n  static isSupported(gl) {\n    return hasFeatures(gl, [FEATURES.TEXTURE_FLOAT]);\n  }\n\n  state!: Layer['state'] & {\n    model: Model;\n  };\n  getShaders() {\n    return {vs, fs, modules: [picking]};\n  }\n\n  initializeState() {\n    const {gl} = this.context;\n    const attributeManager = this.getAttributeManager()!;\n    attributeManager.addInstanced({\n      // eslint-disable-next-line @typescript-eslint/unbound-method\n      instancePositions: {size: 3, update: this.calculateInstancePositions},\n      instanceCounts: {size: 4, noAlloc: true}\n    });\n    this.setState({\n      model: this._getModel(gl)\n    });\n  }\n\n  shouldUpdateState({changeFlags}) {\n    // 'instanceCounts' buffer contetns change on viewport change.\n    return changeFlags.somethingChanged;\n  }\n\n  updateState(params: UpdateParameters<this>) {\n    super.updateState(params);\n\n    const {oldProps, props, changeFlags} = params;\n\n    const attributeManager = this.getAttributeManager()!;\n    if (props.numInstances !== oldProps.numInstances) {\n      attributeManager.invalidateAll();\n    } else if (oldProps.cellSizePixels !== props.cellSizePixels) {\n      attributeManager.invalidate('instancePositions');\n    }\n\n    this._updateUniforms(oldProps, props, changeFlags);\n  }\n\n  draw({uniforms}) {\n    const {parameters, maxTexture} = this.props;\n    const minColor = this.props.minColor || DEFAULT_MINCOLOR;\n    const maxColor = this.props.maxColor || DEFAULT_MAXCOLOR;\n\n    // If colorDomain not specified we use default domain [1, maxCount]\n    // maxCount value will be sampled form maxTexture in vertex shader.\n    const colorDomain = this.props.colorDomain || [1, 0];\n    const {model} = this.state;\n    model\n      .setUniforms(uniforms)\n      .setUniforms({\n        minColor,\n        maxColor,\n        maxTexture,\n        colorDomain\n      })\n      .draw({\n        parameters: {\n          depthTest: false,\n          depthMask: false,\n          ...parameters\n        }\n      });\n  }\n\n  calculateInstancePositions(attribute, {numInstances}) {\n    const {width, height} = this.context.viewport;\n    const {cellSizePixels} = this.props;\n    const numCol = Math.ceil(width / cellSizePixels);\n\n    const {value, size} = attribute;\n\n    for (let i = 0; i < numInstances; i++) {\n      const x = i % numCol;\n      const y = Math.floor(i / numCol);\n      value[i * size + 0] = ((x * cellSizePixels) / width) * 2 - 1;\n      value[i * size + 1] = 1 - ((y * cellSizePixels) / height) * 2;\n      value[i * size + 2] = 0;\n    }\n  }\n\n  // Private Methods\n\n  _getModel(gl: WebGLRenderingContext): Model {\n    return new Model(gl, {\n      ...this.getShaders(),\n      id: this.props.id,\n      geometry: new Geometry({\n        drawMode: GL.TRIANGLE_FAN,\n        attributes: {\n          positions: new Float32Array([0, 0, 0, 1, 0, 0, 1, 1, 0, 0, 1, 0])\n        }\n      }),\n      isInstanced: true\n    });\n  }\n\n  _shouldUseMinMax(): boolean {\n    const {minColor, maxColor, colorDomain, colorRange} = this.props;\n    if (minColor || maxColor) {\n      log.deprecated('ScreenGridLayer props: minColor and maxColor', 'colorRange, colorDomain')();\n      return true;\n    }\n    // minColor and maxColor not supplied, check if colorRange or colorDomain supplied.\n    // NOTE: colorDomain and colorRange are experimental features, use them only when supplied.\n    if (colorDomain || colorRange) {\n      return false;\n    }\n    // None specified, use default minColor and maxColor\n    return true;\n  }\n\n  _updateUniforms(oldProps, props, changeFlags): void {\n    const {model} = this.state;\n    if (COLOR_PROPS.some(key => oldProps[key] !== props[key])) {\n      model.setUniforms({shouldUseMinMax: this._shouldUseMinMax()});\n    }\n\n    if (oldProps.colorRange !== props.colorRange) {\n      model.setUniforms({colorRange: colorRangeToFlatArray(props.colorRange)});\n    }\n\n    if (\n      oldProps.cellMarginPixels !== props.cellMarginPixels ||\n      oldProps.cellSizePixels !== props.cellSizePixels ||\n      changeFlags.viewportChanged\n    ) {\n      const {width, height} = this.context.viewport;\n      const {cellSizePixels, cellMarginPixels} = this.props;\n      const margin = cellSizePixels > cellMarginPixels ? cellMarginPixels : 0;\n\n      const cellScale = new Float32Array([\n        ((cellSizePixels - margin) / width) * 2,\n        (-(cellSizePixels - margin) / height) * 2,\n        1\n      ]);\n      model.setUniforms({cellScale});\n    }\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME screen-grid-layer-vertex-shader\n#define RANGE_COUNT 6\n\nattribute vec3 positions;\nattribute vec3 instancePositions;\nattribute vec4 instanceCounts;\nattribute vec3 instancePickingColors;\n\nuniform float opacity;\nuniform vec3 cellScale;\nuniform vec4 minColor;\nuniform vec4 maxColor;\nuniform vec4 colorRange[RANGE_COUNT];\nuniform vec2 colorDomain;\nuniform bool shouldUseMinMax;\nuniform sampler2D maxTexture;\n\nvarying vec4 vColor;\nvarying float vSampleCount;\n\nvec4 quantizeScale(vec2 domain, vec4 range[RANGE_COUNT], float value) {\n  vec4 outColor = vec4(0., 0., 0., 0.);\n  if (value >= domain.x && value <= domain.y) {\n    float domainRange = domain.y - domain.x;\n    if (domainRange <= 0.) {\n      outColor = colorRange[0];\n    } else {\n      float rangeCount = float(RANGE_COUNT);\n      float rangeStep = domainRange / rangeCount;\n      float idx = floor((value - domain.x) / rangeStep);\n      idx = clamp(idx, 0., rangeCount - 1.);\n      int intIdx = int(idx);\n      outColor = colorRange[intIdx];\n    }\n  }\n  outColor = outColor / 255.;\n  return outColor;\n}\n\nvoid main(void) {\n  vSampleCount = instanceCounts.a;\n\n  float weight = instanceCounts.r;\n  float maxWeight = texture2D(maxTexture, vec2(0.5)).r;\n\n  float step = weight / maxWeight;\n  vec4 minMaxColor = mix(minColor, maxColor, step) / 255.;\n\n  vec2 domain = colorDomain;\n  float domainMaxValid = float(colorDomain.y != 0.);\n  domain.y = mix(maxWeight, colorDomain.y, domainMaxValid);\n  vec4 rangeColor = quantizeScale(domain, colorRange, weight);\n\n  float rangeMinMax = float(shouldUseMinMax);\n  vec4 color = mix(rangeColor, minMaxColor, rangeMinMax);\n  vColor = vec4(color.rgb, color.a * opacity);\n\n  // Set color to be rendered to picking fbo (also used to check for selection highlight).\n  picking_setPickingColor(instancePickingColors);\n\n  gl_Position = vec4(instancePositions + positions * cellScale, 1.);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n/* fragment shader for the grid-layer */\nexport default `\\\n#define SHADER_NAME screen-grid-layer-fragment-shader\n\nprecision highp float;\n\nvarying vec4 vColor;\nvarying float vSampleCount;\n\nvoid main(void) {\n  if (vSampleCount <= 0.0) {\n    discard;\n  }\n  gl_FragColor = vColor;\n\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2019 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport function filterProps(props, filterKeys) {\n  const filteredProps = {};\n  for (const key in props) {\n    if (!filterKeys.includes(key)) {\n      filteredProps[key] = props[key];\n    }\n  }\n  return filteredProps;\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {\n  CompositeLayer,\n  AttributeManager,\n  _compareProps as compareProps,\n  UpdateParameters,\n  CompositeLayerProps\n} from '@deck.gl/core';\nimport {cssToDeviceRatio} from '@luma.gl/core';\nimport {filterProps} from './utils/prop-utils';\n\nexport type AggregationLayerProps<DataT = any> = CompositeLayerProps<DataT>;\n\nexport default abstract class AggregationLayer<\n  ExtraPropsT = {}\n> extends CompositeLayer<ExtraPropsT> {\n  static layerName = 'AggregationLayer';\n\n  state!: CompositeLayer['state'] & {\n    ignoreProps?: Record<string, any>;\n    dimensions?: any;\n  };\n\n  initializeAggregationLayer(dimensions: any) {\n    super.initializeState(this.context);\n\n    this.setState({\n      // Layer props , when changed doesn't require updating aggregation\n      ignoreProps: filterProps((this.constructor as any)._propTypes, dimensions.data.props),\n      dimensions\n    });\n  }\n\n  updateState(opts: UpdateParameters<this>) {\n    super.updateState(opts);\n    const {changeFlags} = opts;\n    if (changeFlags.extensionsChanged) {\n      const shaders = this.getShaders({});\n      if (shaders && shaders.defines) {\n        shaders.defines.NON_INSTANCED_MODEL = 1;\n      }\n      this.updateShaders(shaders);\n    }\n\n    // Explictly call to update attributes as 'CompositeLayer' doesn't call this\n    this._updateAttributes();\n  }\n\n  updateAttributes(changedAttributes) {\n    // Super classes, can refer to state.changedAttributes to determine what\n    // attributes changed\n    this.setState({changedAttributes});\n  }\n\n  getAttributes() {\n    return this.getAttributeManager()!.getShaderAttributes();\n  }\n\n  getModuleSettings() {\n    // For regular layer draw this happens during draw cycle (_drawLayersInViewport) not during update cycle\n    // For aggregation layers this is called during updateState to update aggregation data\n    // NOTE: it is similar to LayerPass._getModuleParameters() but doesn't inlcude `effects` it is not needed for aggregation\n    const {viewport, mousePosition, gl} = this.context;\n    const moduleSettings = Object.assign(Object.create(this.props), {\n      viewport,\n      mousePosition,\n      pickingActive: 0,\n      devicePixelRatio: cssToDeviceRatio(gl)\n    });\n    return moduleSettings;\n  }\n\n  updateShaders(shaders) {\n    // Default implemention is empty, subclasses can update their Model objects if needed\n  }\n\n  /**\n   * Checks if aggregation is dirty\n   * @param {Object} updateOpts - object {props, oldProps, changeFlags}\n   * @param {Object} params - object {dimension, compareAll}\n   * @param {Object} params.dimension - {props, accessors} array of props and/or accessors\n   * @param {Boolean} params.compareAll - when `true` it will include non layer props for comparision\n   * @returns {Boolean} - returns true if dimensions' prop or accessor is changed\n   **/\n  isAggregationDirty(\n    updateOpts,\n    params: {compareAll?: boolean; dimension?: any} = {}\n  ): string | boolean {\n    const {props, oldProps, changeFlags} = updateOpts;\n    const {compareAll = false, dimension} = params;\n    const {ignoreProps} = this.state;\n    const {props: dataProps, accessors = []} = dimension;\n    const {updateTriggersChanged} = changeFlags;\n    if (changeFlags.dataChanged) {\n      return true;\n    }\n    if (updateTriggersChanged) {\n      if (updateTriggersChanged.all) {\n        return true;\n      }\n      for (const accessor of accessors) {\n        if (updateTriggersChanged[accessor]) {\n          return true;\n        }\n      }\n    }\n    if (compareAll) {\n      if (changeFlags.extensionsChanged) {\n        return true;\n      }\n      // Compare non layer props too (like extension props)\n      // ignoreprops refers to all Layer props other than aggregation props that need to be comapred\n      return compareProps({\n        oldProps,\n        newProps: props,\n        ignoreProps,\n        propTypes: (this.constructor as any)._propTypes\n      });\n    }\n    // Compare props of the dimension\n    for (const name of dataProps) {\n      if (props[name] !== oldProps[name]) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Checks if an attribute is changed\n   * @param {String} name - name of the attribute\n   * @returns {Boolean} - `true` if attribute `name` is changed, `false` otherwise,\n   *                       If `name` is not passed or `undefiend`, `true` if any attribute is changed, `false` otherwise\n   **/\n  isAttributeChanged(name?: string) {\n    const {changedAttributes} = this.state;\n    if (!name) {\n      // if name not specified return true if any attribute is changed\n      return !isObjectEmpty(changedAttributes);\n    }\n    return changedAttributes && changedAttributes[name] !== undefined;\n  }\n\n  // Private\n\n  // override Composite layer private method to create AttributeManager instance\n  _getAttributeManager() {\n    return new AttributeManager(this.context.gl, {\n      id: this.props.id,\n      stats: this.context.stats\n    });\n  }\n}\n\n// Helper methods\n\n// Returns true if given object is empty, false otherwise.\nfunction isObjectEmpty(obj) {\n  let isEmpty = true;\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  for (const key in obj) {\n    isEmpty = false;\n    break;\n  }\n  return isEmpty;\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {log} from '@deck.gl/core';\n\n// a scale function wrapper just like d3-scales\nexport function getScale(domain, range, scaleFunction) {\n  const scale = scaleFunction;\n  scale.domain = () => domain;\n  scale.range = () => range;\n\n  return scale;\n}\n\n// Quantize scale is similar to linear scales,\n// except it uses a discrete rather than continuous range\n// return a quantize scale function\nexport function getQuantizeScale(domain, range) {\n  const scaleFunction = value => quantizeScale(domain, range, value);\n\n  return getScale(domain, range, scaleFunction);\n}\n\n// return a linear scale function\nexport function getLinearScale(domain, range) {\n  const scaleFunction = value => linearScale(domain, range, value);\n\n  return getScale(domain, range, scaleFunction);\n}\n\nexport function getQuantileScale(domain, range) {\n  // calculate threshold\n  const sortedDomain = domain.sort(ascending);\n  let i = 0;\n  const n = Math.max(1, range.length);\n  const thresholds = new Array(n - 1);\n  while (++i < n) {\n    thresholds[i - 1] = threshold(sortedDomain, i / n);\n  }\n\n  const scaleFunction = value => thresholdsScale(thresholds, range, value);\n  scaleFunction.thresholds = () => thresholds;\n\n  return getScale(domain, range, scaleFunction);\n}\n\nfunction ascending(a, b) {\n  return a - b;\n}\n\nfunction threshold(domain, fraction) {\n  const domainLength = domain.length;\n  if (fraction <= 0 || domainLength < 2) {\n    return domain[0];\n  }\n  if (fraction >= 1) {\n    return domain[domainLength - 1];\n  }\n\n  const domainFraction = (domainLength - 1) * fraction;\n  const lowIndex = Math.floor(domainFraction);\n  const low = domain[lowIndex];\n  const high = domain[lowIndex + 1];\n  return low + (high - low) * (domainFraction - lowIndex);\n}\n\nfunction bisectRight(a, x) {\n  let lo = 0;\n  let hi = a.length;\n  while (lo < hi) {\n    const mid = (lo + hi) >>> 1;\n    if (ascending(a[mid], x) > 0) {\n      hi = mid;\n    } else {\n      lo = mid + 1;\n    }\n  }\n  return lo;\n}\n\n// return a quantize scale function\nfunction thresholdsScale(thresholds, range, value) {\n  return range[bisectRight(thresholds, value)];\n}\n\n// ordinal Scale\nfunction ordinalScale(domain, domainMap, range, value) {\n  const key = `${value}`;\n  let d = domainMap.get(key);\n  if (d === undefined) {\n    // update the domain\n    d = domain.push(value);\n    domainMap.set(key, d);\n  }\n  return range[(d - 1) % range.length];\n}\n\nexport function getOrdinalScale(domain, range) {\n  const domainMap = new Map();\n  const uniqueDomain = [];\n  for (const d of domain) {\n    const key = `${d}`;\n    if (!domainMap.has(key)) {\n      domainMap.set(key, uniqueDomain.push(d));\n    }\n  }\n\n  const scaleFunction = value => ordinalScale(uniqueDomain, domainMap, range, value);\n\n  return getScale(domain, range, scaleFunction);\n}\n\n// Quantize scale is similar to linear scales,\n// except it uses a discrete rather than continuous range\nexport function quantizeScale(domain, range, value) {\n  const domainRange = domain[1] - domain[0];\n  if (domainRange <= 0) {\n    log.warn('quantizeScale: invalid domain, returning range[0]')();\n    return range[0];\n  }\n  const step = domainRange / range.length;\n  const idx = Math.floor((value - domain[0]) / step);\n  const clampIdx = Math.max(Math.min(idx, range.length - 1), 0);\n\n  return range[clampIdx];\n}\n\n// Linear scale maps continuous domain to continuous range\nexport function linearScale(domain, range, value) {\n  return ((value - domain[0]) / (domain[1] - domain[0])) * (range[1] - range[0]) + range[0];\n}\n\n// get scale domains\nfunction notNullOrUndefined(d) {\n  return d !== undefined && d !== null;\n}\n\nexport function unique(values) {\n  const results = [];\n  values.forEach(v => {\n    if (!results.includes(v) && notNullOrUndefined(v)) {\n      results.push(v);\n    }\n  });\n\n  return results;\n}\n\nfunction getTruthyValues(data, valueAccessor) {\n  const values = typeof valueAccessor === 'function' ? data.map(valueAccessor) : data;\n  return values.filter(notNullOrUndefined);\n}\n\nexport function getLinearDomain(data, valueAccessor) {\n  const sorted = getTruthyValues(data, valueAccessor).sort();\n  return sorted.length ? [sorted[0], sorted[sorted.length - 1]] : [0, 0];\n}\n\nexport function getQuantileDomain(data, valueAccessor) {\n  return getTruthyValues(data, valueAccessor);\n}\n\nexport function getOrdinalDomain(data, valueAccessor) {\n  return unique(getTruthyValues(data, valueAccessor));\n}\n\nexport function getScaleDomain(scaleType, data, valueAccessor) {\n  switch (scaleType) {\n    case 'quantize':\n    case 'linear':\n      return getLinearDomain(data, valueAccessor);\n\n    case 'quantile':\n      return getQuantileDomain(data, valueAccessor);\n\n    case 'ordinal':\n      return getOrdinalDomain(data, valueAccessor);\n\n    default:\n      return getLinearDomain(data, valueAccessor);\n  }\n}\n\nexport function clamp(value, min, max) {\n  return Math.max(min, Math.min(max, value));\n}\n\nexport function getScaleFunctionByScaleType(scaleType) {\n  switch (scaleType) {\n    case 'quantize':\n      return getQuantizeScale;\n    case 'linear':\n      return getLinearScale;\n    case 'quantile':\n      return getQuantileScale;\n    case 'ordinal':\n      return getOrdinalScale;\n\n    default:\n      return getQuantizeScale;\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n// getValue takes an array of points returns a value to sort the bins on.\n// by default it returns the number of points\n// this is where to pass in a function to color the bins by\n// avg/mean/max of specific value of the point\nconst defaultGetValue = points => points.length;\n\nimport {clamp, getQuantileDomain, getOrdinalDomain} from './scale-utils';\n\nconst MAX_32_BIT_FLOAT = 3.402823466e38;\n\n// access array of points in each bin\nconst defaultGetPoints = bin => bin.points;\n// access index of each bin\nconst defaultGetIndex = bin => bin.index;\n\n// d3-scending\nconst ascending = (a, b) => (a < b ? -1 : a > b ? 1 : a >= b ? 0 : NaN);\n\nconst defaultProps = {\n  getValue: defaultGetValue,\n  getPoints: defaultGetPoints,\n  getIndex: defaultGetIndex,\n  filterData: null\n};\n\nexport type AggregatedBin = {\n  i: number;\n  value: any;\n  counts: number;\n};\n\nexport default class BinSorter {\n  maxCount!: number;\n  maxValue!: number;\n  minValue!: number;\n  totalCount!: number;\n\n  aggregatedBins: AggregatedBin[];\n  sortedBins!: AggregatedBin[];\n  binMap: Record<number, AggregatedBin>;\n\n  constructor(bins = [], props: Partial<typeof defaultProps> = defaultProps) {\n    this.aggregatedBins = this.getAggregatedBins(bins, props);\n    this._updateMinMaxValues();\n    this.binMap = this.getBinMap();\n  }\n\n  /**\n   * Get an array of object with aggregated values and index of bins\n   * Array object will be sorted by value optionally.\n   * @param {Array} bins\n   * @param {Function} getValue\n   * @return {Array} array of values and index lookup\n   */\n  getAggregatedBins(bins, props): AggregatedBin[] {\n    const {\n      getValue = defaultGetValue,\n      getPoints = defaultGetPoints,\n      getIndex = defaultGetIndex,\n      filterData\n    } = props;\n\n    const hasFilter = typeof filterData === 'function';\n    const binCount = bins.length;\n    const aggregatedBins: AggregatedBin[] = [];\n    let index = 0;\n\n    for (let binIndex = 0; binIndex < binCount; binIndex++) {\n      const bin = bins[binIndex];\n      const points = getPoints(bin);\n      const i = getIndex(bin);\n\n      const filteredPoints = hasFilter ? points.filter(filterData) : points;\n\n      bin.filteredPoints = hasFilter ? filteredPoints : null;\n\n      const value = filteredPoints.length ? getValue(filteredPoints) : null;\n\n      if (value !== null && value !== undefined) {\n        // filter bins if value is null or undefined\n        aggregatedBins[index] = {\n          i: Number.isFinite(i) ? i : binIndex,\n          value,\n          counts: filteredPoints.length\n        };\n        index++;\n      }\n    }\n    return aggregatedBins;\n  }\n\n  _percentileToIndex(percentileRange): [number, number] {\n    const len = this.sortedBins.length;\n    if (len < 2) {\n      return [0, 0];\n    }\n\n    const [lower, upper] = percentileRange.map(n => clamp(n, 0, 100));\n\n    const lowerIdx = Math.ceil((lower / 100) * (len - 1));\n    const upperIdx = Math.floor((upper / 100) * (len - 1));\n\n    return [lowerIdx, upperIdx];\n  }\n\n  /**\n   * Get a mapping from cell/hexagon index to sorted bin\n   * This is used to retrieve bin value for color calculation\n   * @return {Object} bin index to aggregatedBins\n   */\n  getBinMap(): Record<number, AggregatedBin> {\n    const binMap = {};\n    for (const bin of this.aggregatedBins) {\n      binMap[bin.i] = bin;\n    }\n    return binMap;\n  }\n\n  // Private\n\n  /**\n   * Get ths max count of all bins\n   */\n  _updateMinMaxValues(): void {\n    let maxCount = 0;\n    let maxValue = 0;\n    let minValue = MAX_32_BIT_FLOAT;\n    let totalCount = 0;\n    for (const x of this.aggregatedBins) {\n      maxCount = maxCount > x.counts ? maxCount : x.counts;\n      maxValue = maxValue > x.value ? maxValue : x.value;\n      minValue = minValue < x.value ? minValue : x.value;\n      totalCount += x.counts;\n    }\n    this.maxCount = maxCount;\n    this.maxValue = maxValue;\n    this.minValue = minValue;\n    this.totalCount = totalCount;\n  }\n\n  /**\n   * Get range of values of all bins\n   * @param {Number[]} range\n   * @param {Number} range[0] - lower bound\n   * @param {Number} range[1] - upper bound\n   * @return {Array} array of new value range\n   */\n  getValueRange(percentileRange: [number, number]): [number, number] {\n    if (!this.sortedBins) {\n      this.sortedBins = this.aggregatedBins.sort((a, b) => ascending(a.value, b.value));\n    }\n    if (!this.sortedBins.length) {\n      // @ts-expect-error\n      return [];\n    }\n    let lowerIdx = 0;\n    let upperIdx = this.sortedBins.length - 1;\n\n    if (Array.isArray(percentileRange)) {\n      const idxRange = this._percentileToIndex(percentileRange);\n      lowerIdx = idxRange[0];\n      upperIdx = idxRange[1];\n    }\n\n    return [this.sortedBins[lowerIdx].value, this.sortedBins[upperIdx].value];\n  }\n\n  getValueDomainByScale(scale: string, [lower = 0, upper = 100] = []) {\n    if (!this.sortedBins) {\n      this.sortedBins = this.aggregatedBins.sort((a, b) => ascending(a.value, b.value));\n    }\n    if (!this.sortedBins.length) {\n      return [];\n    }\n    const indexEdge = this._percentileToIndex([lower, upper]);\n\n    return this._getScaleDomain(scale, indexEdge);\n  }\n\n  _getScaleDomain(scaleType: string, [lowerIdx, upperIdx]: [number, number]): [number, number] {\n    const bins = this.sortedBins;\n\n    switch (scaleType) {\n      case 'quantize':\n      case 'linear':\n        return [bins[lowerIdx].value, bins[upperIdx].value];\n\n      case 'quantile':\n        return getQuantileDomain(bins.slice(lowerIdx, upperIdx + 1), d => d.value);\n\n      case 'ordinal':\n        return getOrdinalDomain(bins, d => d.value) as [number, number];\n\n      default:\n        return [bins[lowerIdx].value, bins[upperIdx].value];\n    }\n  }\n}\n","import {log, COORDINATE_SYSTEM} from '@deck.gl/core';\nconst R_EARTH = 6378000;\n\nfunction toFinite(n) {\n  return Number.isFinite(n) ? n : 0;\n}\n\n// Parse input data to build positions, wights and bounding box.\n/* eslint-disable max-statements */\nexport function getBoundingBox(attributes, vertexCount) {\n  // TODO - value might not exist (e.g. attribute transition)\n  const positions = attributes.positions.value;\n\n  let yMin = Infinity;\n  let yMax = -Infinity;\n  let xMin = Infinity;\n  let xMax = -Infinity;\n  let y;\n  let x;\n\n  for (let i = 0; i < vertexCount; i++) {\n    x = positions[i * 3];\n    y = positions[i * 3 + 1];\n    yMin = y < yMin ? y : yMin;\n    yMax = y > yMax ? y : yMax;\n    xMin = x < xMin ? x : xMin;\n    xMax = x > xMax ? x : xMax;\n  }\n\n  const boundingBox = {\n    xMin: toFinite(xMin),\n    xMax: toFinite(xMax),\n    yMin: toFinite(yMin),\n    yMax: toFinite(yMax)\n  };\n\n  return boundingBox;\n}\n/* eslint-enable max-statements */\n\n// Returns XY translation for positions to peform aggregation in +ve sapce\nfunction getTranslation(boundingBox, gridOffset, coordinateSystem, viewport) {\n  const {width, height} = viewport;\n\n  // Origin to define grid\n  // DEFAULT coordinate system is treated as LNGLAT\n  const worldOrigin =\n    coordinateSystem === COORDINATE_SYSTEM.CARTESIAN ? [-width / 2, -height / 2] : [-180, -90];\n\n  // Other coordinate systems not supported/verified yet\n  log.assert(\n    coordinateSystem === COORDINATE_SYSTEM.CARTESIAN ||\n      coordinateSystem === COORDINATE_SYSTEM.LNGLAT ||\n      coordinateSystem === COORDINATE_SYSTEM.DEFAULT\n  );\n\n  const {xMin, yMin} = boundingBox;\n  return [\n    // Align origin to match grid cell boundaries in CPU and GPU aggregations\n    -1 * (alignToCell(xMin - worldOrigin[0], gridOffset.xOffset) + worldOrigin[0]),\n    -1 * (alignToCell(yMin - worldOrigin[1], gridOffset.yOffset) + worldOrigin[1])\n  ];\n}\n\n// Aligns `inValue` to given `cellSize`\nexport function alignToCell(inValue, cellSize) {\n  const sign = inValue < 0 ? -1 : 1;\n\n  let value = sign < 0 ? Math.abs(inValue) + cellSize : Math.abs(inValue);\n\n  value = Math.floor(value / cellSize) * cellSize;\n\n  return value * sign;\n}\n\n/**\n * Based on geometric center of sample points, calculate cellSize in lng/lat (degree) space\n * @param {object} boundingBox - {xMin, yMin, xMax, yMax} contains bounding box of data\n * @param {number} cellSize - grid cell size in meters\n * @param {boolean, optional} converToDegrees - when true offsets are converted from meters to lng/lat (degree) space\n * @returns {xOffset, yOffset} - cellSize size\n */\n\nexport function getGridOffset(boundingBox, cellSize, convertToMeters = true) {\n  if (!convertToMeters) {\n    return {xOffset: cellSize, yOffset: cellSize};\n  }\n\n  const {yMin, yMax} = boundingBox;\n  const centerLat = (yMin + yMax) / 2;\n\n  return calculateGridLatLonOffset(cellSize, centerLat);\n}\n\nexport function getGridParams(boundingBox, cellSize, viewport, coordinateSystem) {\n  const gridOffset = getGridOffset(\n    boundingBox,\n    cellSize,\n    coordinateSystem !== COORDINATE_SYSTEM.CARTESIAN\n  );\n\n  const translation = getTranslation(boundingBox, gridOffset, coordinateSystem, viewport);\n\n  const {xMin, yMin, xMax, yMax} = boundingBox;\n\n  const width = xMax - xMin + gridOffset.xOffset;\n  const height = yMax - yMin + gridOffset.yOffset;\n\n  const numCol = Math.ceil(width / gridOffset.xOffset);\n  const numRow = Math.ceil(height / gridOffset.yOffset);\n  return {gridOffset, translation, width, height, numCol, numRow};\n}\n\n/**\n * calculate grid layer cell size in lat lon based on world unit size\n * and current latitude\n * @param {number} cellSize\n * @param {number} latitude\n * @returns {object} - lat delta and lon delta\n */\nfunction calculateGridLatLonOffset(cellSize, latitude) {\n  const yOffset = calculateLatOffset(cellSize);\n  const xOffset = calculateLonOffset(latitude, cellSize);\n  return {yOffset, xOffset};\n}\n\n/**\n * with a given x-km change, calculate the increment of latitude\n * based on stackoverflow http://stackoverflow.com/questions/7477003\n * @param {number} dy - change in km\n * @return {number} - increment in latitude\n */\nfunction calculateLatOffset(dy) {\n  return (dy / R_EARTH) * (180 / Math.PI);\n}\n\n/**\n * with a given x-km change, and current latitude\n * calculate the increment of longitude\n * based on stackoverflow http://stackoverflow.com/questions/7477003\n * @param {number} lat - latitude of current location (based on city)\n * @param {number} dx - change in km\n * @return {number} - increment in longitude\n */\nfunction calculateLonOffset(lat, dx) {\n  return ((dx / R_EARTH) * (180 / Math.PI)) / Math.cos((lat * Math.PI) / 180);\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {createIterable} from '@deck.gl/core';\nimport {getGridOffset} from '../utils/grid-aggregation-utils';\n\n/**\n * Calculate density grid from an array of points\n * @param {Object} props - object containing :\n * @param {Iterable} [props.data] - data objects to be aggregated\n * @param {Integer} [props.cellSize] - size of the grid cell\n *\n * @param {Object} aggregationParams - object containing :\n * @param {Object} gridOffset - {xOffset, yOffset} cell size in meters\n * @param {Integer} width - width of the grid\n * @param {Integer} height - height of the grid\n * @param {Boolean} projectPoints - `true` if doing screen space projection, `false` otherwise\n * @param {Array} attributes - attributes array containing position values\n * @param {Viewport} viewport - viewport to be used for projection\n * @param {Array} posOffset - [xOffset, yOffset] offset to be applied to positions to get cell index\n * @param {Object} boundingBox - {xMin, yMin, xMax, yMax} bounding box of input data\n *\n * @returns {object} - grid data, cell dimension\n */\nexport function pointToDensityGridDataCPU(props, aggregationParams) {\n  const hashInfo = pointsToGridHashing(props, aggregationParams);\n  const result = getGridLayerDataFromGridHash(hashInfo);\n\n  return {\n    gridHash: hashInfo.gridHash,\n    gridOffset: hashInfo.gridOffset,\n    data: result\n  };\n}\n\n/**\n * Project points into each cell, return a hash table of cells\n * @param {Iterable} points\n * @param {number} cellSize - unit size in meters\n * @param {function} getPosition - position accessor\n * @returns {object} - grid hash and cell dimension\n */\n/* eslint-disable max-statements, complexity */\nfunction pointsToGridHashing(props, aggregationParams) {\n  const {data = [], cellSize} = props;\n  const {attributes, viewport, projectPoints, numInstances} = aggregationParams;\n  const positions = attributes.positions.value;\n  const {size} = attributes.positions.getAccessor();\n  const boundingBox =\n    aggregationParams.boundingBox || getPositionBoundingBox(attributes.positions, numInstances);\n  const offsets = aggregationParams.posOffset || [180, 90];\n  const gridOffset = aggregationParams.gridOffset || getGridOffset(boundingBox, cellSize);\n\n  if (gridOffset.xOffset <= 0 || gridOffset.yOffset <= 0) {\n    return {gridHash: {}, gridOffset};\n  }\n\n  const {width, height} = viewport;\n  const numCol = Math.ceil(width / gridOffset.xOffset);\n  const numRow = Math.ceil(height / gridOffset.yOffset);\n\n  // calculate count per cell\n  const gridHash = {};\n\n  const {iterable, objectInfo} = createIterable(data);\n  const position = new Array(3);\n  for (const pt of iterable) {\n    objectInfo.index++;\n    position[0] = positions[objectInfo.index * size];\n    position[1] = positions[objectInfo.index * size + 1];\n    position[2] = size >= 3 ? positions[objectInfo.index * size + 2] : 0;\n    const [x, y] = projectPoints ? viewport.project(position) : position;\n    if (Number.isFinite(x) && Number.isFinite(y)) {\n      const yIndex = Math.floor((y + offsets[1]) / gridOffset.yOffset);\n      const xIndex = Math.floor((x + offsets[0]) / gridOffset.xOffset);\n      if (\n        !projectPoints ||\n        // when doing screen space agggregation (projectPoints = true), filter points outside of the viewport range.\n        (xIndex >= 0 && xIndex < numCol && yIndex >= 0 && yIndex < numRow)\n      ) {\n        const key = `${yIndex}-${xIndex}`;\n\n        gridHash[key] = gridHash[key] || {count: 0, points: [], lonIdx: xIndex, latIdx: yIndex};\n        gridHash[key].count += 1;\n        gridHash[key].points.push({\n          source: pt,\n          index: objectInfo.index\n        });\n      }\n    }\n  }\n\n  return {gridHash, gridOffset, offsets: [offsets[0] * -1, offsets[1] * -1]};\n}\n/* eslint-enable max-statements, complexity */\n\nfunction getGridLayerDataFromGridHash({gridHash, gridOffset, offsets}) {\n  const data = new Array(Object.keys(gridHash).length);\n  let i = 0;\n  for (const key in gridHash) {\n    const idxs = key.split('-');\n    const latIdx = parseInt(idxs[0], 10);\n    const lonIdx = parseInt(idxs[1], 10);\n    const index = i++;\n\n    data[index] = {\n      index,\n      position: [\n        offsets[0] + gridOffset.xOffset * lonIdx,\n        offsets[1] + gridOffset.yOffset * latIdx\n      ],\n      ...gridHash[key]\n    };\n  }\n  return data;\n}\n\n// Calculate bounding box of position attribute\nfunction getPositionBoundingBox(positionAttribute, numInstance) {\n  // TODO - value might not exist (e.g. attribute transition)\n  const positions = positionAttribute.value;\n  const {size} = positionAttribute.getAccessor();\n\n  let yMin = Infinity;\n  let yMax = -Infinity;\n  let xMin = Infinity;\n  let xMax = -Infinity;\n  let y;\n  let x;\n\n  for (let i = 0; i < numInstance; i++) {\n    x = positions[i * size];\n    y = positions[i * size + 1];\n    if (Number.isFinite(x) && Number.isFinite(y)) {\n      yMin = y < yMin ? y : yMin;\n      yMax = y > yMax ? y : yMax;\n      xMin = x < xMin ? x : xMin;\n      xMax = x > xMax ? x : xMax;\n    }\n  }\n\n  return {xMin, xMax, yMin, yMax};\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport AggregationLayer, {AggregationLayerProps} from './aggregation-layer';\nimport GPUGridAggregator from './utils/gpu-grid-aggregation/gpu-grid-aggregator';\nimport {Buffer} from '@luma.gl/core';\nimport {LayerContext, log, UpdateParameters} from '@deck.gl/core';\nimport GL from '@luma.gl/constants';\nimport BinSorter from './utils/bin-sorter';\nimport {pointToDensityGridDataCPU} from './cpu-grid-layer/grid-aggregator';\n\nexport type GridAggregationLayerProps<DataT = any> = AggregationLayerProps<DataT>;\n\nexport default abstract class GridAggregationLayer<\n  ExtraPropsT = {}\n> extends AggregationLayer<ExtraPropsT> {\n  static layerName = 'GridAggregationLayer';\n\n  state!: AggregationLayer['state'] & {\n    aggregationDataDirty?: any;\n    aggregationWeightsDirty?: any;\n    gpuAggregation?: any;\n    getValue?: () => any;\n    sortedBins?: BinSorter;\n  };\n\n  initializeAggregationLayer({dimensions}) {\n    const {gl} = this.context;\n    super.initializeAggregationLayer(dimensions);\n    this.setState({\n      // CPU aggregation results\n      layerData: {},\n      gpuGridAggregator: new GPUGridAggregator(gl, {id: `${this.id}-gpu-aggregator`}),\n      cpuGridAggregator: pointToDensityGridDataCPU\n    });\n  }\n\n  updateState(opts: UpdateParameters<this>) {\n    // get current attributes\n    super.updateState(opts);\n\n    this.updateAggregationState(opts);\n\n    const {aggregationDataDirty, aggregationWeightsDirty, gpuAggregation} = this.state;\n    if (this.getNumInstances() <= 0) {\n      return;\n    }\n    let aggregationDirty = false;\n    // CPU aggregation is two steps\n    // 1. Create bins (based on cellSize and position) 2. Aggregate weights for each bin\n    // For GPU aggregation both above steps are combined into one step\n\n    // step-1\n    if (aggregationDataDirty || (gpuAggregation && aggregationWeightsDirty)) {\n      this._updateAggregation(opts);\n      aggregationDirty = true;\n    }\n    // step-2 (Applicalbe for CPU aggregation only)\n    if (!gpuAggregation && (aggregationDataDirty || aggregationWeightsDirty)) {\n      this._updateWeightBins();\n      this._uploadAggregationResults();\n      aggregationDirty = true;\n    }\n\n    this.setState({aggregationDirty});\n  }\n\n  finalizeState(context: LayerContext) {\n    const {count} = this.state.weights;\n    if (count && count.aggregationBuffer) {\n      count.aggregationBuffer.delete();\n    }\n    this.state.gpuGridAggregator?.delete();\n    super.finalizeState(context);\n  }\n\n  updateShaders(shaders: any): void {\n    if (this.state.gpuAggregation) {\n      this.state.gpuGridAggregator.updateShaders(shaders);\n    }\n  }\n\n  // Methods that can be overriden by subclasses for customizations\n\n  updateAggregationState(opts) {\n    // Sublayers should implement this method.\n    log.assert(false);\n  }\n\n  allocateResources(numRow, numCol) {\n    if (this.state.numRow !== numRow || this.state.numCol !== numCol) {\n      const dataBytes = numCol * numRow * 4 * 4;\n      const gl = this.context.gl;\n      const {weights} = this.state;\n      for (const name in weights) {\n        const weight = weights[name];\n        if (weight.aggregationBuffer) {\n          weight.aggregationBuffer.delete();\n        }\n        weight.aggregationBuffer = new Buffer(gl, {\n          byteLength: dataBytes,\n          accessor: {\n            size: 4,\n            type: GL.FLOAT,\n            divisor: 1\n          }\n        });\n      }\n    }\n  }\n\n  updateResults({aggregationData, maxMinData, maxData, minData}) {\n    const {count} = this.state.weights;\n    if (count) {\n      count.aggregationData = aggregationData;\n      count.maxMinData = maxMinData;\n      count.maxData = maxData;\n      count.minData = minData;\n    }\n  }\n\n  // Private\n\n  _updateAggregation(opts) {\n    const {\n      cpuGridAggregator,\n      gpuGridAggregator,\n      gridOffset,\n      posOffset,\n      translation = [0, 0],\n      scaling = [0, 0, 0],\n      boundingBox,\n      projectPoints,\n      gpuAggregation,\n      numCol,\n      numRow\n    } = this.state;\n    const {props} = opts;\n    const {viewport} = this.context;\n    const attributes = this.getAttributes();\n    const vertexCount = this.getNumInstances();\n\n    if (!gpuAggregation) {\n      const result = cpuGridAggregator(props, {\n        gridOffset,\n        projectPoints,\n        attributes,\n        viewport,\n        posOffset,\n        boundingBox\n      });\n      this.setState({\n        layerData: result\n      });\n    } else {\n      const {weights} = this.state;\n      gpuGridAggregator.run({\n        weights,\n        cellSize: [gridOffset.xOffset, gridOffset.yOffset],\n        numCol,\n        numRow,\n        translation,\n        scaling,\n        vertexCount,\n        projectPoints,\n        attributes,\n        moduleSettings: this.getModuleSettings()\n      });\n    }\n  }\n\n  _updateWeightBins() {\n    const {getValue} = this.state;\n\n    const sortedBins = new BinSorter(this.state.layerData.data || [], {getValue});\n    this.setState({sortedBins});\n  }\n\n  _uploadAggregationResults(): void {\n    const {numCol, numRow} = this.state;\n    const {data} = this.state.layerData;\n    const {aggregatedBins, minValue, maxValue, totalCount} = this.state.sortedBins!;\n\n    const ELEMENTCOUNT = 4;\n    const aggregationSize = numCol * numRow * ELEMENTCOUNT;\n    const aggregationData = new Float32Array(aggregationSize).fill(0);\n    for (const bin of aggregatedBins) {\n      const {lonIdx, latIdx} = data[bin.i];\n      const {value, counts} = bin;\n      const cellIndex = (lonIdx + latIdx * numCol) * ELEMENTCOUNT;\n      aggregationData[cellIndex] = value;\n      aggregationData[cellIndex + ELEMENTCOUNT - 1] = counts;\n    }\n    const maxMinData = new Float32Array([maxValue, 0, 0, minValue]);\n    const maxData = new Float32Array([maxValue, 0, 0, totalCount]);\n    const minData = new Float32Array([minValue, 0, 0, totalCount]);\n    this.updateResults({aggregationData, maxMinData, maxData, minData});\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {\n  Accessor,\n  Color,\n  GetPickingInfoParams,\n  Layer,\n  LayerContext,\n  LayersList,\n  log,\n  PickingInfo,\n  Position,\n  UpdateParameters,\n  DefaultProps\n} from '@deck.gl/core';\nimport GL from '@luma.gl/constants';\nimport type {Texture2D} from '@luma.gl/core';\nimport GPUGridAggregator from '../utils/gpu-grid-aggregation/gpu-grid-aggregator';\nimport {AGGREGATION_OPERATION, getValueFunc} from '../utils/aggregation-operation-utils';\nimport ScreenGridCellLayer from './screen-grid-cell-layer';\nimport GridAggregationLayer, {GridAggregationLayerProps} from '../grid-aggregation-layer';\nimport {getFloatTexture} from '../utils/resource-utils.js';\n\nconst defaultProps: DefaultProps<ScreenGridLayerProps> = {\n  ...ScreenGridCellLayer.defaultProps,\n  getPosition: {type: 'accessor', value: d => d.position},\n  getWeight: {type: 'accessor', value: 1},\n\n  gpuAggregation: true,\n  aggregation: 'SUM'\n};\n\nconst POSITION_ATTRIBUTE_NAME = 'positions';\nconst DIMENSIONS = {\n  data: {\n    props: ['cellSizePixels']\n  },\n  weights: {\n    props: ['aggregation'],\n    accessors: ['getWeight']\n  }\n};\n\n/** All properties supported by ScreenGridLayer. */\nexport type ScreenGridLayerProps<DataT = any> = _ScreenGridLayerProps<DataT> &\n  GridAggregationLayerProps<DataT>;\n\n/** Properties added by ScreenGridLayer. */\nexport type _ScreenGridLayerProps<DataT> = {\n  /**\n   * Unit width/height of the bins.\n   * @default 100\n   */\n  cellSizePixels?: number;\n\n  /**\n   * Cell margin size in pixels.\n   * @default 2\n   */\n  cellMarginPixels?: number;\n\n  /**\n   * Expressed as an rgba array, minimal color that could be rendered by a tile.\n   * @default [0, 0, 0, 255]\n   * @deprecated Deprecated in version 5.2.0, use `colorRange` and `colorDomain` instead.\n   */\n  minColor?: Color | null;\n\n  /**\n   * Expressed as an rgba array, maximal color that could be rendered by a tile.\n   * @default [0, 255, 0, 255]\n   * @deprecated Deprecated in version 5.2.0, use `colorRange` and `colorDomain` instead.\n   */\n  maxColor?: Color | null;\n\n  /**\n   * Color scale input domain. The color scale maps continues numeric domain into discrete color range.\n   * @default [1, max(weight)]\n   */\n  colorDomain?: [number, number] | null;\n\n  /**\n   * Specified as an array of colors [color1, color2, ...].\n   *\n   * @default `6-class YlOrRd` - [colorbrewer](http://colorbrewer2.org/#type=sequential&scheme=YlOrRd&n=6)\n   */\n  colorRange?: Color[];\n\n  /**\n   * Method called to retrieve the position of each object.\n   *\n   * @default d => d.position\n   */\n  getPosition?: Accessor<DataT, Position>;\n\n  /**\n   * The weight of each object.\n   *\n   * @default 1\n   */\n  getWeight?: Accessor<DataT, number>;\n\n  /**\n   * Perform aggregation is performed on GPU.\n   *\n   * NOTE: GPU Aggregation requires WebGL2 support by the browser.\n   * When `gpuAggregation` is set to true and browser doesn't support WebGL2, aggregation falls back to CPU.\n   *\n   * @default true\n   */\n  gpuAggregation?: boolean;\n\n  /**\n   * Defines the type of aggregation operation\n   *\n   * V valid values are 'SUM', 'MEAN', 'MIN' and 'MAX'.\n   *\n   * @default 'SUM'\n   */\n  aggregation?: 'SUM' | 'MEAN' | 'MIN' | 'MAX';\n};\n\n/** Aggregates data into histogram bins and renders them as a grid. */\nexport default class ScreenGridLayer<DataT = any, ExtraProps = {}> extends GridAggregationLayer<\n  ExtraProps & Required<_ScreenGridLayerProps<DataT>>\n> {\n  static layerName = 'ScreenGridLayer';\n  static defaultProps = defaultProps;\n\n  state!: GridAggregationLayer['state'] & {\n    supported: boolean;\n    gpuGridAggregator?: any;\n    gpuAggregation?: any;\n    weights?: any;\n    maxTexture?: Texture2D;\n  };\n\n  initializeState() {\n    const {gl} = this.context;\n    if (!ScreenGridCellLayer.isSupported(gl)) {\n      // max aggregated value is sampled from a float texture\n      this.setState({supported: false});\n      log.error(`ScreenGridLayer: ${this.id} is not supported on this browser`)();\n      return;\n    }\n    super.initializeAggregationLayer({\n      dimensions: DIMENSIONS,\n      // @ts-expect-error\n      getCellSize: props => props.cellSizePixels // TODO\n    });\n    const weights = {\n      count: {\n        size: 1,\n        operation: AGGREGATION_OPERATION.SUM,\n        needMax: true,\n        maxTexture: getFloatTexture(gl, {id: `${this.id}-max-texture`})\n      }\n    };\n    this.setState({\n      supported: true,\n      projectPoints: true, // aggregation in screen space\n      weights,\n      subLayerData: {attributes: {}},\n      maxTexture: weights.count.maxTexture,\n      positionAttributeName: 'positions',\n      posOffset: [0, 0],\n      translation: [1, -1]\n    });\n    const attributeManager = this.getAttributeManager()!;\n    attributeManager.add({\n      [POSITION_ATTRIBUTE_NAME]: {\n        size: 3,\n        accessor: 'getPosition',\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions()\n      },\n      // this attribute is used in gpu aggregation path only\n      count: {size: 3, accessor: 'getWeight'}\n    });\n  }\n\n  shouldUpdateState({changeFlags}: UpdateParameters<this>) {\n    return this.state.supported && changeFlags.somethingChanged;\n  }\n\n  updateState(opts: UpdateParameters<this>) {\n    super.updateState(opts);\n  }\n\n  renderLayers(): LayersList | Layer {\n    if (!this.state.supported) {\n      return [];\n    }\n    const {maxTexture, numRow, numCol, weights} = this.state;\n    const {updateTriggers} = this.props;\n    const {aggregationBuffer} = weights.count;\n    const CellLayerClass = this.getSubLayerClass('cells', ScreenGridCellLayer);\n\n    return new CellLayerClass(\n      this.props,\n      this.getSubLayerProps({\n        id: 'cell-layer',\n        updateTriggers\n      }),\n      {\n        data: {attributes: {instanceCounts: aggregationBuffer}},\n        maxTexture,\n        numInstances: numRow * numCol\n      }\n    );\n  }\n\n  finalizeState(context: LayerContext): void {\n    super.finalizeState(context);\n\n    const {aggregationBuffer, maxBuffer, maxTexture} = this.state;\n\n    aggregationBuffer?.delete();\n    maxBuffer?.delete();\n    maxTexture?.delete();\n  }\n\n  getPickingInfo({info}: GetPickingInfoParams): PickingInfo {\n    const {index} = info;\n    if (index >= 0) {\n      const {gpuGridAggregator, gpuAggregation, weights} = this.state;\n      // Get count aggregation results\n      const aggregationResults = gpuAggregation\n        ? gpuGridAggregator.getData('count')\n        : weights.count;\n\n      // Each instance (one cell) is aggregated into single pixel,\n      // Get current instance's aggregation details.\n      info.object = GPUGridAggregator.getAggregationData({\n        pixelIndex: index,\n        ...aggregationResults\n      });\n    }\n\n    return info;\n  }\n\n  // Aggregation Overrides\n\n  updateResults({aggregationData, maxData}) {\n    const {count} = this.state.weights;\n    count.aggregationData = aggregationData;\n    count.aggregationBuffer.setData({data: aggregationData});\n    count.maxData = maxData;\n    count.maxTexture.setImageData({data: maxData});\n  }\n\n  /* eslint-disable complexity, max-statements */\n  updateAggregationState(opts) {\n    const cellSize = opts.props.cellSizePixels;\n    const cellSizeChanged = opts.oldProps.cellSizePixels !== cellSize;\n    const {viewportChanged} = opts.changeFlags;\n    let gpuAggregation = opts.props.gpuAggregation;\n    if (this.state.gpuAggregation !== opts.props.gpuAggregation) {\n      if (gpuAggregation && !GPUGridAggregator.isSupported(this.context.gl)) {\n        log.warn('GPU Grid Aggregation not supported, falling back to CPU')();\n        gpuAggregation = false;\n      }\n    }\n    const gpuAggregationChanged = gpuAggregation !== this.state.gpuAggregation;\n    this.setState({\n      gpuAggregation\n    });\n\n    const positionsChanged = this.isAttributeChanged(POSITION_ATTRIBUTE_NAME);\n\n    const {dimensions} = this.state;\n    const {data, weights} = dimensions;\n    const aggregationDataDirty =\n      positionsChanged ||\n      gpuAggregationChanged ||\n      viewportChanged ||\n      this.isAggregationDirty(opts, {\n        compareAll: gpuAggregation, // check for all (including extentions props) when using gpu aggregation\n        dimension: data\n      });\n    const aggregationWeightsDirty = this.isAggregationDirty(opts, {dimension: weights});\n\n    this.setState({\n      aggregationDataDirty,\n      aggregationWeightsDirty\n    });\n\n    const {viewport} = this.context;\n\n    if (viewportChanged || cellSizeChanged) {\n      const {width, height} = viewport;\n      const numCol = Math.ceil(width / cellSize);\n      const numRow = Math.ceil(height / cellSize);\n      this.allocateResources(numRow, numCol);\n      this.setState({\n        // transformation from clipspace to screen(pixel) space\n        scaling: [width / 2, -height / 2, 1],\n\n        gridOffset: {xOffset: cellSize, yOffset: cellSize},\n        width,\n        height,\n        numCol,\n        numRow\n      });\n    }\n\n    if (aggregationWeightsDirty) {\n      this._updateAccessors(opts);\n    }\n    if (aggregationDataDirty || aggregationWeightsDirty) {\n      this._resetResults();\n    }\n  }\n  /* eslint-enable complexity, max-statements */\n\n  // Private\n\n  _updateAccessors(opts) {\n    const {getWeight, aggregation, data} = opts.props;\n    const {count} = this.state.weights;\n    if (count) {\n      count.getWeight = getWeight;\n      count.operation = AGGREGATION_OPERATION[aggregation];\n    }\n    this.setState({getValue: getValueFunc(aggregation, getWeight, {data})});\n  }\n\n  _resetResults() {\n    const {count} = this.state.weights;\n    if (count) {\n      count.aggregationData = null;\n    }\n  }\n}\n","// Copyright (c) 2015 - 2018 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\nimport BinSorter from './bin-sorter';\nimport {getScaleFunctionByScaleType} from './scale-utils';\nimport {getValueFunc, wrapGetValueFunc} from './aggregation-operation-utils';\n\nfunction nop() {}\n\nconst dimensionSteps = ['getBins', 'getDomain', 'getScaleFunc'];\nconst defaultDimensions = [\n  {\n    key: 'fillColor',\n    accessor: 'getFillColor',\n    pickingInfo: 'colorValue',\n    getBins: {\n      triggers: {\n        value: {\n          prop: 'getColorValue',\n          updateTrigger: 'getColorValue'\n        },\n        weight: {\n          prop: 'getColorWeight',\n          updateTrigger: 'getColorWeight'\n        },\n        aggregation: {\n          prop: 'colorAggregation'\n        },\n        filterData: {\n          prop: '_filterData',\n          updateTrigger: '_filterData'\n        }\n      }\n    },\n    getDomain: {\n      triggers: {\n        lowerPercentile: {\n          prop: 'lowerPercentile'\n        },\n        upperPercentile: {\n          prop: 'upperPercentile'\n        },\n        scaleType: {\n          prop: 'colorScaleType'\n        }\n      }\n    },\n    getScaleFunc: {\n      triggers: {\n        domain: {prop: 'colorDomain'},\n        range: {prop: 'colorRange'}\n      },\n      onSet: {\n        props: 'onSetColorDomain'\n      }\n    },\n    nullValue: [0, 0, 0, 0]\n  },\n  {\n    key: 'elevation',\n    accessor: 'getElevation',\n    pickingInfo: 'elevationValue',\n    getBins: {\n      triggers: {\n        value: {\n          prop: 'getElevationValue',\n          updateTrigger: 'getElevationValue'\n        },\n        weight: {\n          prop: 'getElevationWeight',\n          updateTrigger: 'getElevationWeight'\n        },\n        aggregation: {\n          prop: 'elevationAggregation'\n        },\n        filterData: {\n          prop: '_filterData',\n          updateTrigger: '_filterData'\n        }\n      }\n    },\n    getDomain: {\n      triggers: {\n        lowerPercentile: {\n          prop: 'elevationLowerPercentile'\n        },\n        upperPercentile: {\n          prop: 'elevationUpperPercentile'\n        },\n        scaleType: {\n          prop: 'elevationScaleType'\n        }\n      }\n    },\n    getScaleFunc: {\n      triggers: {\n        domain: {prop: 'elevationDomain'},\n        range: {prop: 'elevationRange'}\n      },\n      onSet: {\n        props: 'onSetElevationDomain'\n      }\n    },\n    nullValue: -1\n  }\n];\nconst defaultGetCellSize = props => props.cellSize;\nexport default class CPUAggregator {\n  constructor(opts) {\n    this.state = {\n      layerData: {},\n      dimensions: {\n        // color: {\n        //   getValue: null,\n        //   domain: null,\n        //   sortedBins: null,\n        //   scaleFunc: nop\n        // },\n        // elevation: {\n        //   getValue: null,\n        //   domain: null,\n        //   sortedBins: null,\n        //   scaleFunc: nop\n        // }\n      }\n    };\n    this.changeFlags = {};\n    this.dimensionUpdaters = {};\n\n    this._getCellSize = opts.getCellSize || defaultGetCellSize;\n    this._getAggregator = opts.getAggregator;\n    this._addDimension(opts.dimensions || defaultDimensions);\n  }\n\n  static defaultDimensions() {\n    return defaultDimensions;\n  }\n\n  updateState(opts, aggregationParams) {\n    const {oldProps, props, changeFlags} = opts;\n    this.updateGetValueFuncs(oldProps, props, changeFlags);\n    const reprojectNeeded = this.needsReProjectPoints(oldProps, props, changeFlags);\n    let aggregationDirty = false;\n    if (changeFlags.dataChanged || reprojectNeeded) {\n      // project data into bin and aggregate wegiths per bin\n      this.getAggregatedData(props, aggregationParams);\n      aggregationDirty = true;\n    } else {\n      const dimensionChanges = this.getDimensionChanges(oldProps, props, changeFlags) || [];\n      // this here is layer\n      dimensionChanges.forEach(f => typeof f === 'function' && f());\n      aggregationDirty = true;\n    }\n    this.setState({aggregationDirty});\n\n    return this.state;\n  }\n\n  // Update private state\n  setState(updateObject) {\n    this.state = {...this.state, ...updateObject};\n  }\n\n  // Update private state.dimensions\n  setDimensionState(key, updateObject) {\n    this.setState({\n      dimensions: {\n        ...this.state.dimensions,\n        [key]: {...this.state.dimensions[key], ...updateObject}\n      }\n    });\n  }\n\n  normalizeResult(result = {}) {\n    // support previous hexagonAggregator API\n    if (result.hexagons) {\n      return {data: result.hexagons, ...result};\n    } else if (result.layerData) {\n      return {data: result.layerData, ...result};\n    }\n\n    return result;\n  }\n\n  getAggregatedData(props, aggregationParams) {\n    const aggregator = this._getAggregator(props);\n\n    const result = aggregator(props, aggregationParams);\n    this.setState({\n      layerData: this.normalizeResult(result)\n    });\n    this.changeFlags = {\n      layerData: true\n    };\n    this.getSortedBins(props);\n  }\n\n  updateGetValueFuncs(oldProps, props, changeFlags) {\n    for (const key in this.dimensionUpdaters) {\n      const {value, weight, aggregation} = this.dimensionUpdaters[key].getBins.triggers;\n      let getValue = props[value.prop];\n      const getValueChanged = this.needUpdateDimensionStep(\n        this.dimensionUpdaters[key].getBins,\n        oldProps,\n        props,\n        changeFlags\n      );\n\n      if (getValueChanged) {\n        if (getValue) {\n          getValue = wrapGetValueFunc(getValue, {data: props.data});\n        } else {\n          // If `getValue` is not provided from props, build it with aggregation and weight.\n          getValue = getValueFunc(props[aggregation.prop], props[weight.prop], {data: props.data});\n        }\n      }\n\n      if (getValue) {\n        this.setDimensionState(key, {getValue});\n      }\n    }\n  }\n\n  needsReProjectPoints(oldProps, props, changeFlags) {\n    return (\n      this._getCellSize(oldProps) !== this._getCellSize(props) ||\n      this._getAggregator(oldProps) !== this._getAggregator(props) ||\n      (changeFlags.updateTriggersChanged &&\n        (changeFlags.updateTriggersChanged.all || changeFlags.updateTriggersChanged.getPosition))\n    );\n  }\n\n  // Adds dimensions\n  addDimension(dimensions) {\n    this._addDimension(dimensions);\n  }\n\n  _addDimension(dimensions = []) {\n    dimensions.forEach(dimension => {\n      const {key} = dimension;\n      this.dimensionUpdaters[key] = this.getDimensionUpdaters(dimension);\n      this.state.dimensions[key] = {\n        getValue: null,\n        domain: null,\n        sortedBins: null,\n        scaleFunc: nop\n      };\n    });\n  }\n\n  getDimensionUpdaters({key, accessor, pickingInfo, getBins, getDomain, getScaleFunc, nullValue}) {\n    return {\n      key,\n      accessor,\n      pickingInfo,\n      getBins: {updater: this.getDimensionSortedBins, ...getBins},\n      getDomain: {updater: this.getDimensionValueDomain, ...getDomain},\n      getScaleFunc: {updater: this.getDimensionScale, ...getScaleFunc},\n      attributeAccessor: this.getSubLayerDimensionAttribute(key, nullValue)\n    };\n  }\n\n  needUpdateDimensionStep(dimensionStep, oldProps, props, changeFlags) {\n    // whether need to update current dimension step\n    // dimension step is the value, domain, scaleFunction of each dimension\n    // each step is an object with properties links to layer prop and whether the prop is\n    // controlled by updateTriggers\n    // getBins: {\n    //   value: {\n    //     prop: 'getElevationValue',\n    //     updateTrigger: 'getElevationValue'\n    //   },\n    //   weight: {\n    //     prop: 'getElevationWeight',\n    //     updateTrigger: 'getElevationWeight'\n    //   },\n    //   aggregation: {\n    //     prop: 'elevationAggregation'\n    //   }\n    // }\n    return Object.values(dimensionStep.triggers).some(item => {\n      if (item.updateTrigger) {\n        // check based on updateTriggers change first\n        // if data has changed, always update value\n        return (\n          changeFlags.dataChanged ||\n          (changeFlags.updateTriggersChanged &&\n            (changeFlags.updateTriggersChanged.all ||\n              changeFlags.updateTriggersChanged[item.updateTrigger]))\n        );\n      }\n      // fallback to direct comparison\n      return oldProps[item.prop] !== props[item.prop];\n    });\n  }\n\n  getDimensionChanges(oldProps, props, changeFlags) {\n    // const {dimensionUpdaters} = this.state;\n    const updaters = [];\n\n    // get dimension to be updated\n    for (const key in this.dimensionUpdaters) {\n      // return the first triggered updater for each dimension\n      const needUpdate = dimensionSteps.find(step =>\n        this.needUpdateDimensionStep(\n          this.dimensionUpdaters[key][step],\n          oldProps,\n          props,\n          changeFlags\n        )\n      );\n\n      if (needUpdate) {\n        updaters.push(\n          this.dimensionUpdaters[key][needUpdate].updater.bind(\n            this,\n            props,\n            this.dimensionUpdaters[key]\n          )\n        );\n      }\n    }\n\n    return updaters.length ? updaters : null;\n  }\n\n  getUpdateTriggers(props) {\n    const _updateTriggers = props.updateTriggers || {};\n    const updateTriggers = {};\n\n    for (const key in this.dimensionUpdaters) {\n      const {accessor} = this.dimensionUpdaters[key];\n      // fold dimension triggers into each accessor\n      updateTriggers[accessor] = {};\n\n      dimensionSteps.forEach(step => {\n        Object.values(this.dimensionUpdaters[key][step].triggers).forEach(\n          ({prop, updateTrigger}) => {\n            if (updateTrigger) {\n              // if prop is based on updateTrigger e.g. getColorValue, getColorWeight\n              // and updateTriggers is passed in from layer prop\n              // fold the updateTriggers into accessor\n              const fromProp = _updateTriggers[updateTrigger];\n              if (typeof fromProp === 'object' && !Array.isArray(fromProp)) {\n                // if updateTrigger is an object spread it\n                Object.assign(updateTriggers[accessor], fromProp);\n              } else if (fromProp !== undefined) {\n                updateTriggers[accessor][prop] = fromProp;\n              }\n            } else {\n              // if prop is not based on updateTrigger\n              updateTriggers[accessor][prop] = props[prop];\n            }\n          }\n        );\n      });\n    }\n\n    return updateTriggers;\n  }\n\n  getSortedBins(props) {\n    for (const key in this.dimensionUpdaters) {\n      this.getDimensionSortedBins(props, this.dimensionUpdaters[key]);\n    }\n  }\n\n  getDimensionSortedBins(props, dimensionUpdater) {\n    const {key} = dimensionUpdater;\n    const {getValue} = this.state.dimensions[key];\n\n    const sortedBins = new BinSorter(this.state.layerData.data || [], {\n      getValue,\n      filterData: props._filterData\n    });\n    this.setDimensionState(key, {sortedBins});\n    this.getDimensionValueDomain(props, dimensionUpdater);\n  }\n\n  getDimensionValueDomain(props, dimensionUpdater) {\n    const {getDomain, key} = dimensionUpdater;\n    const {\n      triggers: {lowerPercentile, upperPercentile, scaleType}\n    } = getDomain;\n    const valueDomain = this.state.dimensions[key].sortedBins.getValueDomainByScale(\n      props[scaleType.prop],\n      [props[lowerPercentile.prop], props[upperPercentile.prop]]\n    );\n\n    this.setDimensionState(key, {valueDomain});\n    this.getDimensionScale(props, dimensionUpdater);\n  }\n\n  getDimensionScale(props, dimensionUpdater) {\n    const {key, getScaleFunc, getDomain} = dimensionUpdater;\n    const {domain, range} = getScaleFunc.triggers;\n    const {scaleType} = getDomain.triggers;\n    const {onSet} = getScaleFunc;\n    const dimensionRange = props[range.prop];\n    const dimensionDomain = props[domain.prop] || this.state.dimensions[key].valueDomain;\n    const getScaleFunction = getScaleFunctionByScaleType(scaleType && props[scaleType.prop]);\n    const scaleFunc = getScaleFunction(dimensionDomain, dimensionRange);\n\n    if (typeof onSet === 'object' && typeof props[onSet.props] === 'function') {\n      props[onSet.props](scaleFunc.domain());\n    }\n\n    this.setDimensionState(key, {scaleFunc});\n  }\n\n  getSubLayerDimensionAttribute(key, nullValue) {\n    return cell => {\n      const {sortedBins, scaleFunc} = this.state.dimensions[key];\n      const bin = sortedBins.binMap[cell.index];\n\n      if (bin && bin.counts === 0) {\n        // no points left in bin after filtering\n        return nullValue;\n      }\n      const cv = bin && bin.value;\n      const domain = scaleFunc.domain();\n\n      const isValueInDomain = cv >= domain[0] && cv <= domain[domain.length - 1];\n\n      // if cell value is outside domain, set alpha to 0\n      return isValueInDomain ? scaleFunc(cv) : nullValue;\n    };\n  }\n\n  getSubLayerAccessors(props) {\n    const accessors = {};\n    for (const key in this.dimensionUpdaters) {\n      const {accessor} = this.dimensionUpdaters[key];\n      accessors[accessor] = this.getSubLayerDimensionAttribute(props, key);\n    }\n\n    return accessors;\n  }\n\n  getPickingInfo({info}) {\n    const isPicked = info.picked && info.index > -1;\n    let object = null;\n\n    if (isPicked) {\n      // const {sortedColorBins, sortedElevationBins} = this.state;\n\n      const cell = this.state.layerData.data[info.index];\n\n      const binInfo = {};\n      for (const key in this.dimensionUpdaters) {\n        const {pickingInfo} = this.dimensionUpdaters[key];\n        const {sortedBins} = this.state.dimensions[key];\n        const value = sortedBins.binMap[cell.index] && sortedBins.binMap[cell.index].value;\n        binInfo[pickingInfo] = value;\n      }\n\n      object = Object.assign(binInfo, cell, {\n        points: cell.filteredPoints || cell.points\n      });\n    }\n\n    // override object with picked cell\n    info.picked = Boolean(object);\n    info.object = object;\n\n    return info;\n  }\n\n  getAccessor(dimensionKey) {\n    if (!this.dimensionUpdaters.hasOwnProperty(dimensionKey)) {\n      return nop;\n    }\n    return this.dimensionUpdaters[dimensionKey].attributeAccessor;\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport GL from '@luma.gl/constants';\nimport {GridCellLayer} from '@deck.gl/layers';\nimport {Accessor, AccessorFunction, Color, Position, Material, DefaultProps} from '@deck.gl/core';\n\nimport {defaultColorRange} from '../utils/color-utils';\nimport {pointToDensityGridDataCPU} from './grid-aggregator';\nimport CPUAggregator from '../utils/cpu-aggregator';\nimport AggregationLayer, {AggregationLayerProps} from '../aggregation-layer';\n\nimport {Layer, UpdateParameters, GetPickingInfoParams, PickingInfo} from '@deck.gl/core';\nimport {AggregateAccessor} from '../types';\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction nop() {}\n\nconst defaultProps: DefaultProps<CPUGridLayerProps> = {\n  // color\n  colorDomain: null,\n  colorRange: defaultColorRange,\n  getColorValue: {type: 'accessor', value: null}, // default value is calculated from `getColorWeight` and `colorAggregation`\n  getColorWeight: {type: 'accessor', value: 1},\n  colorAggregation: 'SUM',\n  lowerPercentile: {type: 'number', min: 0, max: 100, value: 0},\n  upperPercentile: {type: 'number', min: 0, max: 100, value: 100},\n  colorScaleType: 'quantize',\n  onSetColorDomain: nop,\n\n  // elevation\n  elevationDomain: null,\n  elevationRange: [0, 1000],\n  getElevationValue: {type: 'accessor', value: null}, // default value is calculated from `getElevationWeight` and `elevationAggregation`\n  getElevationWeight: {type: 'accessor', value: 1},\n  elevationAggregation: 'SUM',\n  elevationLowerPercentile: {type: 'number', min: 0, max: 100, value: 0},\n  elevationUpperPercentile: {type: 'number', min: 0, max: 100, value: 100},\n  elevationScale: {type: 'number', min: 0, value: 1},\n  elevationScaleType: 'linear',\n  onSetElevationDomain: nop,\n\n  gridAggregator: pointToDensityGridDataCPU,\n\n  // grid\n  cellSize: {type: 'number', min: 0, max: 1000, value: 1000},\n  coverage: {type: 'number', min: 0, max: 1, value: 1},\n  getPosition: {type: 'accessor', value: x => x.position},\n  extruded: false,\n\n  // Optional material for 'lighting' shader module\n  material: true,\n\n  // data filter\n  _filterData: {type: 'function', value: null, optional: true}\n};\n\n/** All properties supported by CPUGridLayer. */\nexport type CPUGridLayerProps<DataT = any> = _CPUGridLayerProps<DataT> &\n  AggregationLayerProps<DataT>;\n\n/** Properties added by CPUGridLayer. */\nexport type _CPUGridLayerProps<DataT> = {\n  /**\n   * Size of each cell in meters.\n   * @default 1000\n   */\n  cellSize?: number;\n\n  /**\n   * Color scale domain, default is set to the extent of aggregated weights in each cell.\n   * @default [min(colorWeight), max(colorWeight)]\n   */\n  colorDomain?: [number, number] | null;\n\n  /**\n   * Default: [colorbrewer](http://colorbrewer2.org/#type=sequential&scheme=YlOrRd&n=6) `6-class YlOrRd`\n   */\n  colorRange?: Color[];\n\n  /**\n   * Cell size multiplier, clamped between 0 - 1.\n   * @default 1\n   */\n  coverage?: number;\n\n  /**\n   * Elevation scale input domain, default is set to between 0 and the max of aggregated weights in each cell.\n   * @default [0, max(elevationWeight)]\n   */\n  elevationDomain?: [number, number] | null;\n\n  /**\n   * Elevation scale output range.\n   * @default [0, 1000]\n   */\n  elevationRange?: [number, number];\n\n  /**\n   * Cell elevation multiplier.\n   * @default 1\n   */\n  elevationScale?: number;\n\n  /**\n   * Whether to enable cell elevation. If set to false, all cell will be flat.\n   * @default true\n   */\n  extruded?: boolean;\n\n  /**\n   * Filter cells and re-calculate color by `upperPercentile`.\n   * Cells with value arger than the upperPercentile will be hidden.\n   * @default 100\n   */\n  upperPercentile?: number;\n\n  /**\n   * Filter cells and re-calculate color by `lowerPercentile`.\n   * Cells with value smaller than the lowerPercentile will be hidden.\n   * @default 0\n   */\n  lowerPercentile?: number;\n\n  /**\n   * Filter cells and re-calculate elevation by `elevationUpperPercentile`.\n   * Cells with elevation value larger than the `elevationUpperPercentile` will be hidden.\n   * @default 100\n   */\n  elevationUpperPercentile?: number;\n\n  /**\n   * Filter cells and re-calculate elevation by `elevationLowerPercentile`.\n   * Cells with elevation value larger than the `elevationLowerPercentile` will be hidden.\n   * @default 0\n   */\n  elevationLowerPercentile?: number;\n\n  /**\n   * Scaling function used to determine the color of the grid cell, default value is 'quantize'.\n   * Supported Values are 'quantize', 'linear', 'quantile' and 'ordinal'.\n   * @default 'quantize'\n   */\n  colorScaleType?: 'quantize' | 'linear' | 'quantile' | 'ordinal';\n\n  /**\n   * Scaling function used to determine the elevation of the grid cell, only supports 'linear'.\n   */\n  elevationScaleType?: 'linear';\n\n  // TODO - document\n  gridAggregator?: (props: any, params: any) => any;\n\n  /**\n   * Material settings for lighting effect. Applies if `extruded: true`.\n   *\n   * @default true\n   * @see https://deck.gl/docs/developer-guide/using-lighting\n   */\n  material?: Material;\n\n  /**\n   * Defines the operation used to aggregate all data object weights to calculate a cell's color value.\n   * @default 'SUM'\n   */\n  colorAggregation?: 'SUM' | 'MEAN' | 'MIN' | 'MAX';\n\n  /**\n   * Defines the operation used to aggregate all data object weights to calculate a cell's elevation value.\n   * @default 'SUM'\n   */\n  elevationAggregation?: 'SUM' | 'MEAN' | 'MIN' | 'MAX';\n\n  /**\n   * Method called to retrieve the position of each object.\n   * @default object => object.position\n   */\n  getPosition?: AccessorFunction<DataT, Position>;\n\n  /**\n   * The weight of a data object used to calculate the color value for a cell.\n   * @default 1\n   */\n  getColorWeight?: Accessor<DataT, number>;\n\n  /**\n   * After data objects are aggregated into cells, this accessor is called on each cell to get the value that its color is based on.\n   * @default null\n   */\n  getColorValue?: AggregateAccessor<DataT> | null;\n\n  /**\n   * The weight of a data object used to calculate the elevation value for a cell.\n   * @default 1\n   */\n  getElevationWeight?: Accessor<DataT, number>;\n\n  /**\n   * After data objects are aggregated into cells, this accessor is called on each cell to get the value that its elevation is based on.\n   * @default null\n   */\n  getElevationValue?: AggregateAccessor<DataT> | null;\n\n  /**\n   * This callback will be called when bin color domain has been calculated.\n   * @default () => {}\n   */\n  onSetColorDomain?: (minMax: [number, number]) => void;\n\n  /**\n   * This callback will be called when bin elevation domain has been calculated.\n   * @default () => {}\n   */\n  onSetElevationDomain?: (minMax: [number, number]) => void;\n\n  /**\n   * (Experimental) Filter data objects\n   */\n  _filterData: null | ((d: DataT) => boolean);\n};\n\n/** Aggregate data into a grid-based heatmap. Aggregation is performed on CPU. */\nexport default class CPUGridLayer<DataT = any, ExtraPropsT = {}> extends AggregationLayer<\n  ExtraPropsT & Required<_CPUGridLayerProps<DataT>>\n> {\n  static layerName = 'CPUGridLayer';\n  static defaultProps = defaultProps;\n\n  initializeState(): void {\n    const cpuAggregator = new CPUAggregator({\n      getAggregator: props => props.gridAggregator,\n      getCellSize: props => props.cellSize\n    });\n\n    this.state = {\n      cpuAggregator,\n      aggregatorState: cpuAggregator.state\n    };\n    const attributeManager = this.getAttributeManager()!;\n    attributeManager.add({\n      positions: {size: 3, type: GL.DOUBLE, accessor: 'getPosition'}\n    });\n    // color and elevation attributes can't be added as attributes\n    // they are calcualted using 'getValue' accessor that takes an array of pints.\n  }\n\n  updateState(opts: UpdateParameters<this>) {\n    super.updateState(opts);\n    this.setState({\n      // make a copy of the internal state of cpuAggregator for testing\n      aggregatorState: this.state.cpuAggregator.updateState(opts, {\n        viewport: this.context.viewport,\n        attributes: this.getAttributes(),\n        numInstances: this.getNumInstances()\n      })\n    });\n  }\n\n  getPickingInfo({info}: GetPickingInfoParams): PickingInfo {\n    return this.state.cpuAggregator.getPickingInfo({info});\n  }\n\n  // create a method for testing\n  _onGetSublayerColor(cell) {\n    return this.state.cpuAggregator.getAccessor('fillColor')(cell);\n  }\n\n  // create a method for testing\n  _onGetSublayerElevation(cell) {\n    return this.state.cpuAggregator.getAccessor('elevation')(cell);\n  }\n\n  _getSublayerUpdateTriggers() {\n    return this.state.cpuAggregator.getUpdateTriggers(this.props);\n  }\n\n  renderLayers(): Layer {\n    const {elevationScale, extruded, cellSize, coverage, material, transitions} = this.props;\n    const {cpuAggregator} = this.state;\n    const SubLayerClass = this.getSubLayerClass('grid-cell', GridCellLayer);\n    const updateTriggers = this._getSublayerUpdateTriggers();\n\n    return new SubLayerClass(\n      {\n        cellSize,\n        coverage,\n        material,\n        elevationScale,\n        extruded,\n\n        getFillColor: this._onGetSublayerColor.bind(this),\n        getElevation: this._onGetSublayerElevation.bind(this),\n        transitions: transitions && {\n          getFillColor: transitions.getColorValue || transitions.getColorWeight,\n          getElevation: transitions.getElevationValue || transitions.getElevationWeight\n        }\n      },\n      this.getSubLayerProps({\n        id: 'grid-cell',\n        updateTriggers\n      }),\n      {\n        data: cpuAggregator.state.layerData.data\n      }\n    );\n  }\n}\n","var thirdPi = Math.PI / 3,\n    angles = [0, thirdPi, 2 * thirdPi, 3 * thirdPi, 4 * thirdPi, 5 * thirdPi];\n\nfunction pointX(d) {\n  return d[0];\n}\n\nfunction pointY(d) {\n  return d[1];\n}\n\nexport default function() {\n  var x0 = 0,\n      y0 = 0,\n      x1 = 1,\n      y1 = 1,\n      x = pointX,\n      y = pointY,\n      r,\n      dx,\n      dy;\n\n  function hexbin(points) {\n    var binsById = {}, bins = [], i, n = points.length;\n\n    for (i = 0; i < n; ++i) {\n      if (isNaN(px = +x.call(null, point = points[i], i, points))\n          || isNaN(py = +y.call(null, point, i, points))) continue;\n\n      var point,\n          px,\n          py,\n          pj = Math.round(py = py / dy),\n          pi = Math.round(px = px / dx - (pj & 1) / 2),\n          py1 = py - pj;\n\n      if (Math.abs(py1) * 3 > 1) {\n        var px1 = px - pi,\n            pi2 = pi + (px < pi ? -1 : 1) / 2,\n            pj2 = pj + (py < pj ? -1 : 1),\n            px2 = px - pi2,\n            py2 = py - pj2;\n        if (px1 * px1 + py1 * py1 > px2 * px2 + py2 * py2) pi = pi2 + (pj & 1 ? 1 : -1) / 2, pj = pj2;\n      }\n\n      var id = pi + \"-\" + pj, bin = binsById[id];\n      if (bin) bin.push(point);\n      else {\n        bins.push(bin = binsById[id] = [point]);\n        bin.x = (pi + (pj & 1) / 2) * dx;\n        bin.y = pj * dy;\n      }\n    }\n\n    return bins;\n  }\n\n  function hexagon(radius) {\n    var x0 = 0, y0 = 0;\n    return angles.map(function(angle) {\n      var x1 = Math.sin(angle) * radius,\n          y1 = -Math.cos(angle) * radius,\n          dx = x1 - x0,\n          dy = y1 - y0;\n      x0 = x1, y0 = y1;\n      return [dx, dy];\n    });\n  }\n\n  hexbin.hexagon = function(radius) {\n    return \"m\" + hexagon(radius == null ? r : +radius).join(\"l\") + \"z\";\n  };\n\n  hexbin.centers = function() {\n    var centers = [],\n        j = Math.round(y0 / dy),\n        i = Math.round(x0 / dx);\n    for (var y = j * dy; y < y1 + r; y += dy, ++j) {\n      for (var x = i * dx + (j & 1) * dx / 2; x < x1 + dx / 2; x += dx) {\n        centers.push([x, y]);\n      }\n    }\n    return centers;\n  };\n\n  hexbin.mesh = function() {\n    var fragment = hexagon(r).slice(0, 4).join(\"l\");\n    return hexbin.centers().map(function(p) { return \"M\" + p + \"m\" + fragment; }).join(\"\");\n  };\n\n  hexbin.x = function(_) {\n    return arguments.length ? (x = _, hexbin) : x;\n  };\n\n  hexbin.y = function(_) {\n    return arguments.length ? (y = _, hexbin) : y;\n  };\n\n  hexbin.radius = function(_) {\n    return arguments.length ? (r = +_, dx = r * 2 * Math.sin(thirdPi), dy = r * 1.5, hexbin) : r;\n  };\n\n  hexbin.size = function(_) {\n    return arguments.length ? (x0 = y0 = 0, x1 = +_[0], y1 = +_[1], hexbin) : [x1 - x0, y1 - y0];\n  };\n\n  hexbin.extent = function(_) {\n    return arguments.length ? (x0 = +_[0][0], y0 = +_[0][1], x1 = +_[1][0], y1 = +_[1][1], hexbin) : [[x0, y0], [x1, y1]];\n  };\n\n  return hexbin.radius(1);\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {\n  Accessor,\n  AccessorFunction,\n  Color,\n  log,\n  Position,\n  Material,\n  UpdateParameters,\n  DefaultProps\n} from '@deck.gl/core';\nimport {ColumnLayer} from '@deck.gl/layers';\n\nimport {defaultColorRange} from '../utils/color-utils';\n\nimport {pointToHexbin} from './hexagon-aggregator';\nimport CPUAggregator from '../utils/cpu-aggregator';\nimport AggregationLayer, {AggregationLayerProps} from '../aggregation-layer';\n\nimport GL from '@luma.gl/constants';\nimport {AggregateAccessor} from '../types';\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction nop() {}\n\nconst defaultProps: DefaultProps<HexagonLayerProps> = {\n  // color\n  colorDomain: null,\n  colorRange: defaultColorRange,\n  getColorValue: {type: 'accessor', value: null}, // default value is calcuated from `getColorWeight` and `colorAggregation`\n  getColorWeight: {type: 'accessor', value: 1},\n  colorAggregation: 'SUM',\n  lowerPercentile: {type: 'number', value: 0, min: 0, max: 100},\n  upperPercentile: {type: 'number', value: 100, min: 0, max: 100},\n  colorScaleType: 'quantize',\n  onSetColorDomain: nop,\n\n  // elevation\n  elevationDomain: null,\n  elevationRange: [0, 1000],\n  getElevationValue: {type: 'accessor', value: null}, // default value is calcuated from `getElevationWeight` and `elevationAggregation`\n  getElevationWeight: {type: 'accessor', value: 1},\n  elevationAggregation: 'SUM',\n  elevationLowerPercentile: {type: 'number', value: 0, min: 0, max: 100},\n  elevationUpperPercentile: {type: 'number', value: 100, min: 0, max: 100},\n  elevationScale: {type: 'number', min: 0, value: 1},\n  elevationScaleType: 'linear',\n  onSetElevationDomain: nop,\n\n  radius: {type: 'number', value: 1000, min: 1},\n  coverage: {type: 'number', min: 0, max: 1, value: 1},\n  extruded: false,\n  hexagonAggregator: pointToHexbin,\n  getPosition: {type: 'accessor', value: x => x.position},\n  // Optional material for 'lighting' shader module\n  material: true,\n\n  // data filter\n  _filterData: {type: 'function', value: null, optional: true}\n};\n\n/** All properties supported by by HexagonLayer. */\nexport type HexagonLayerProps<DataT = any> = _HexagonLayerProps<DataT> &\n  AggregationLayerProps<DataT>;\n\n/** Properties added by HexagonLayer. */\ntype _HexagonLayerProps<DataT = any> = {\n  /**\n   * Radius of hexagon bin in meters. The hexagons are pointy-topped (rather than flat-topped).\n   * @default 1000\n   */\n  radius?: number;\n\n  /**\n   * Function to aggregate data into hexagonal bins.\n   * @default d3-hexbin\n   */\n  hexagonAggregator?: (props: any, params: any) => any;\n\n  /**\n   * Color scale input domain.\n   * @default [min(colorWeight), max(colorWeight)]\n   */\n  colorDomain?: [number, number] | null;\n\n  /**\n   * Specified as an array of colors [color1, color2, ...].\n   * @default `6-class YlOrRd` - [colorbrewer](http://colorbrewer2.org/#type=sequential&scheme=YlOrRd&n=6)\n   */\n  colorRange?: Color[];\n\n  /**\n   * Hexagon radius multiplier, clamped between 0 - 1.\n   * @default 1\n   */\n  coverage?: number;\n\n  /**\n   * Elevation scale input domain. The elevation scale is a linear scale that maps number of counts to elevation.\n   * @default [0, max(elevationWeight)]\n   */\n  elevationDomain?: [number, number] | null;\n\n  /**\n   * Elevation scale output range.\n   * @default [0, 1000]\n   */\n  elevationRange?: [number, number];\n\n  /**\n   * Hexagon elevation multiplier.\n   * @default 1\n   */\n  elevationScale?: number;\n\n  /**\n   * Whether to enable cell elevation. If set to false, all cell will be flat.\n   * @default false\n   */\n  extruded?: boolean;\n\n  /**\n   * Filter bins and re-calculate color by `upperPercentile`.\n   * Hexagons with color value larger than the `upperPercentile` will be hidden.\n   * @default 100\n   */\n  upperPercentile?: number;\n\n  /**\n   * Filter bins and re-calculate color by `lowerPercentile`.\n   * Hexagons with color value smaller than the `lowerPercentile` will be hidden.\n   * @default 0\n   */\n  lowerPercentile?: number;\n\n  /**\n   * Filter bins and re-calculate elevation by `elevationUpperPercentile`.\n   * Hexagons with elevation value larger than the `elevationUpperPercentile` will be hidden.\n   * @default 100\n   */\n  elevationUpperPercentile?: number;\n\n  /**\n   * Filter bins and re-calculate elevation by `elevationLowerPercentile`.\n   * Hexagons with elevation value larger than the `elevationLowerPercentile` will be hidden.\n   * @default 0\n   */\n  elevationLowerPercentile?: number;\n\n  /**\n   * Scaling function used to determine the color of the grid cell, default value is 'quantize'.\n   * Supported Values are 'quantize', 'quantile' and 'ordinal'.\n   * @default 'quantize'\n   */\n  colorScaleType?: 'quantize' | 'quantile' | 'ordinal';\n\n  /**\n   * Scaling function used to determine the elevation of the grid cell, only supports 'linear'.\n   */\n  elevationScaleType?: 'linear';\n\n  /**\n   * Material settings for lighting effect. Applies if `extruded: true`.\n   *\n   * @default true\n   * @see https://deck.gl/docs/developer-guide/using-lighting\n   */\n  material?: Material;\n\n  /**\n   * Defines the operation used to aggregate all data object weights to calculate a cell's color value.\n   * @default 'SUM'\n   */\n  colorAggregation?: 'SUM' | 'MEAN' | 'MIN' | 'MAX';\n\n  /**\n   * Defines the operation used to aggregate all data object weights to calculate a cell's elevation value.\n   * @default 'SUM'\n   */\n  elevationAggregation?: 'SUM' | 'MEAN' | 'MIN' | 'MAX';\n\n  /**\n   * Method called to retrieve the position of each object.\n   * @default object => object.position\n   */\n  getPosition?: AccessorFunction<DataT, Position>;\n\n  /**\n   * The weight of a data object used to calculate the color value for a bin.\n   * @default 1\n   */\n  getColorWeight?: Accessor<DataT, number>;\n\n  /**\n   * After data objects are aggregated into bins, this accessor is called on each cell to get the value that its color is based on.\n   * @default null\n   */\n  getColorValue?: AggregateAccessor<DataT> | null;\n\n  /**\n   * The weight of a data object used to calculate the elevation value for a bin.\n   * @default 1\n   */\n  getElevationWeight?: Accessor<DataT, number>;\n\n  /**\n   * After data objects are aggregated into bins, this accessor is called on each cell to get the value that its elevation is based on.\n   * @default null\n   */\n  getElevationValue?: AggregateAccessor<DataT> | null;\n\n  /**\n   * This callback will be called when cell color domain has been calculated.\n   * @default () => {}\n   */\n  onSetColorDomain?: (minMax: [number, number]) => void;\n\n  /**\n   * This callback will be called when cell elevation domain has been calculated.\n   * @default () => {}\n   */\n  onSetElevationDomain?: (minMax: [number, number]) => void;\n\n  /**\n   * (Experimental) Filter data objects\n   */\n  _filterData: null | ((d: DataT) => boolean);\n};\n\n/** Aggregates data into a hexagon-based heatmap. The color and height of a hexagon are determined based on the objects it contains. */\nexport default class HexagonLayer<ExtraPropsT = {}> extends AggregationLayer<\n  ExtraPropsT & Required<_HexagonLayerProps>\n> {\n  static layerName = 'HexagonLayer';\n  static defaultProps = defaultProps;\n\n  state!: AggregationLayer['state'] & {\n    cpuAggregator: CPUAggregator;\n    aggregatorState: any;\n  };\n  initializeState() {\n    const cpuAggregator = new CPUAggregator({\n      getAggregator: props => props.hexagonAggregator,\n      getCellSize: props => props.radius\n    });\n\n    this.state = {\n      cpuAggregator,\n      aggregatorState: cpuAggregator.state,\n      vertices: null\n    };\n    const attributeManager = this.getAttributeManager()!;\n    attributeManager.add({\n      positions: {size: 3, type: GL.DOUBLE, accessor: 'getPosition'}\n    });\n    // color and elevation attributes can't be added as attributes\n    // they are calculated using 'getValue' accessor that takes an array of pints.\n  }\n\n  updateState(opts: UpdateParameters<this>) {\n    super.updateState(opts);\n\n    if (opts.changeFlags.propsOrDataChanged) {\n      const aggregatorState = this.state.cpuAggregator.updateState(opts, {\n        viewport: this.context.viewport,\n        attributes: this.getAttributes()\n      });\n      if (this.state.aggregatorState.layerData !== aggregatorState.layerData) {\n        // if user provided custom aggregator and returns hexagonVertices,\n        // Need to recalculate radius and angle based on vertices\n        const {hexagonVertices} = aggregatorState.layerData || {};\n        this.setState({\n          vertices: hexagonVertices && this.convertLatLngToMeterOffset(hexagonVertices)\n        });\n      }\n\n      this.setState({\n        // make a copy of the internal state of cpuAggregator for testing\n        aggregatorState\n      });\n    }\n  }\n\n  convertLatLngToMeterOffset(hexagonVertices) {\n    const {viewport} = this.context;\n    if (Array.isArray(hexagonVertices) && hexagonVertices.length === 6) {\n      // get centroid of hexagons\n      const vertex0 = hexagonVertices[0];\n      const vertex3 = hexagonVertices[3];\n\n      const centroid = [(vertex0[0] + vertex3[0]) / 2, (vertex0[1] + vertex3[1]) / 2];\n      const centroidFlat = viewport.projectFlat(centroid);\n\n      const {metersPerUnit} = viewport.getDistanceScales(centroid);\n\n      // offset all points by centroid to meter offset\n      const vertices = hexagonVertices.map(vt => {\n        const vtFlat = viewport.projectFlat(vt);\n\n        return [\n          (vtFlat[0] - centroidFlat[0]) * metersPerUnit[0],\n          (vtFlat[1] - centroidFlat[1]) * metersPerUnit[1]\n        ];\n      });\n\n      return vertices;\n    }\n\n    log.error('HexagonLayer: hexagonVertices needs to be an array of 6 points')();\n    return null;\n  }\n\n  getPickingInfo({info}) {\n    return this.state.cpuAggregator.getPickingInfo({info});\n  }\n\n  // create a method for testing\n  _onGetSublayerColor(cell) {\n    return this.state.cpuAggregator.getAccessor('fillColor')(cell);\n  }\n\n  // create a method for testing\n  _onGetSublayerElevation(cell) {\n    return this.state.cpuAggregator.getAccessor('elevation')(cell);\n  }\n\n  _getSublayerUpdateTriggers() {\n    return this.state.cpuAggregator.getUpdateTriggers(this.props);\n  }\n\n  renderLayers() {\n    const {elevationScale, extruded, coverage, material, transitions} = this.props;\n    const {aggregatorState, vertices} = this.state;\n\n    const SubLayerClass = this.getSubLayerClass('hexagon-cell', ColumnLayer);\n    const updateTriggers = this._getSublayerUpdateTriggers();\n\n    const geometry = vertices\n      ? {vertices, radius: 1}\n      : {\n          // default geometry\n          radius: aggregatorState.layerData.radiusCommon || 1,\n          radiusUnits: 'common',\n          angle: 90\n        };\n    return new SubLayerClass(\n      {\n        ...geometry,\n        diskResolution: 6,\n        elevationScale,\n        extruded,\n        coverage,\n        material,\n\n        getFillColor: this._onGetSublayerColor.bind(this),\n        getElevation: this._onGetSublayerElevation.bind(this),\n        transitions: transitions && {\n          getFillColor: transitions.getColorValue || transitions.getColorWeight,\n          getElevation: transitions.getElevationValue || transitions.getElevationWeight\n        }\n      },\n      this.getSubLayerProps({\n        id: 'hexagon-cell',\n        updateTriggers\n      }),\n      {\n        data: aggregatorState.layerData.data\n      }\n    );\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {hexbin} from 'd3-hexbin';\nimport {createIterable, log} from '@deck.gl/core';\n\n/**\n * Use d3-hexbin to performs hexagonal binning from geo points to hexagons\n * @param {Iterable} data - array of points\n * @param {Number} radius - hexagon radius in meter\n * @param {function} getPosition - get points lon lat\n * @param {Object} viewport - current viewport object\n\n * @return {Object} - hexagons and countRange\n */\nexport function pointToHexbin(props, aggregationParams) {\n  const {data, radius} = props;\n  const {viewport, attributes} = aggregationParams;\n  // get hexagon radius in mercator world unit\n  const centerLngLat = data.length ? getPointsCenter(data, aggregationParams) : null;\n  const radiusCommon = getRadiusInCommon(radius, viewport, centerLngLat);\n\n  // add world space coordinates to points\n  const screenPoints = [];\n  const {iterable, objectInfo} = createIterable(data);\n  const positions = attributes.positions.value;\n  const {size} = attributes.positions.getAccessor();\n  for (const object of iterable) {\n    objectInfo.index++;\n    const posIndex = objectInfo.index * size;\n    const position = [positions[posIndex], positions[posIndex + 1]];\n    const arrayIsFinite = Number.isFinite(position[0]) && Number.isFinite(position[1]);\n    if (arrayIsFinite) {\n      screenPoints.push({\n        screenCoord: viewport.projectFlat(position),\n        source: object,\n        index: objectInfo.index\n      });\n    } else {\n      log.warn('HexagonLayer: invalid position')();\n    }\n  }\n\n  const newHexbin = hexbin()\n    .radius(radiusCommon)\n    .x(d => d.screenCoord[0])\n    .y(d => d.screenCoord[1]);\n\n  const hexagonBins = newHexbin(screenPoints);\n\n  return {\n    hexagons: hexagonBins.map((hex, index) => ({\n      position: viewport.unprojectFlat([hex.x, hex.y]),\n      points: hex,\n      index\n    })),\n    radiusCommon\n  };\n}\n\n/**\n * Get the bounding box of all data points\n */\nexport function getPointsCenter(data, aggregationParams) {\n  const {attributes} = aggregationParams;\n  const positions = attributes.positions.value;\n  const {size} = attributes.positions.getAccessor();\n\n  let minX = Infinity;\n  let minY = Infinity;\n  let maxX = -Infinity;\n  let maxY = -Infinity;\n  let i;\n\n  for (i = 0; i < size * data.length; i += size) {\n    const x = positions[i];\n    const y = positions[i + 1];\n    const arrayIsFinite = Number.isFinite(x) && Number.isFinite(y);\n\n    if (arrayIsFinite) {\n      minX = Math.min(x, minX);\n      maxX = Math.max(x, maxX);\n      minY = Math.min(y, minY);\n      maxY = Math.max(y, maxY);\n    }\n  }\n\n  // return center\n  return [minX, minY, maxX, maxY].every(Number.isFinite)\n    ? [(minX + maxX) / 2, (minY + maxY) / 2]\n    : null;\n}\n\n/**\n * Get radius in mercator world space coordinates from meter\n * @param {Number} radius - in meter\n * @param {Object} viewport - current viewport object\n * @param {Array<Number>} center - data center\n\n * @return {Number} radius in mercator world spcae coordinates\n */\nexport function getRadiusInCommon(radius, viewport, center) {\n  const {unitsPerMeter} = viewport.getDistanceScales(center);\n  // x, y distance should be the same\n  return radius * unitsPerMeter[0];\n}\n","// Code to Offsets Map needed to implement Marching Squares algorithm\n// Ref: https://en.wikipedia.org/wiki/Marching_squares\n\n// Table to map code to the intersection offsets\n// All offsets are relative to the center of marching cell (which is top right corner of grid-cell, and center of marching-square)\nconst HALF = 0.5;\nconst ONE6TH = 1 / 6;\nconst OFFSET = {\n  N: [0, HALF], // NORTH\n  E: [HALF, 0], // EAST\n  S: [0, -HALF], // SOUTH\n  W: [-HALF, 0], // WEST\n\n  // CORNERS\n  NE: [HALF, HALF],\n  NW: [-HALF, HALF],\n  SE: [HALF, -HALF],\n  SW: [-HALF, -HALF]\n};\n\n// NOTE: vertices are ordered in CCW direction, starting from NW corner\n\n// Triangles\nconst SW_TRIANGLE = [OFFSET.W, OFFSET.SW, OFFSET.S];\nconst SE_TRIANGLE = [OFFSET.S, OFFSET.SE, OFFSET.E];\nconst NE_TRIANGLE = [OFFSET.E, OFFSET.NE, OFFSET.N];\nconst NW_TRIANGLE = [OFFSET.NW, OFFSET.W, OFFSET.N];\n\n// Trapezoids\nconst SW_TRAPEZOID = [\n  [-HALF, ONE6TH],\n  [-HALF, -ONE6TH],\n  [-ONE6TH, -HALF],\n  [ONE6TH, -HALF]\n];\nconst SE_TRAPEZOID = [\n  [-ONE6TH, -HALF],\n  [ONE6TH, -HALF],\n  [HALF, -ONE6TH],\n  [HALF, ONE6TH]\n];\nconst NE_TRAPEZOID = [\n  [HALF, -ONE6TH],\n  [HALF, ONE6TH],\n  [ONE6TH, HALF],\n  [-ONE6TH, HALF]\n];\nconst NW_TRAPEZOID = [\n  [-HALF, ONE6TH],\n  [-HALF, -ONE6TH],\n  [ONE6TH, HALF],\n  [-ONE6TH, HALF]\n];\n\n// Rectangles\nconst S_RECTANGLE = [OFFSET.W, OFFSET.SW, OFFSET.SE, OFFSET.E];\nconst E_RECTANGLE = [OFFSET.S, OFFSET.SE, OFFSET.NE, OFFSET.N];\nconst N_RECTANGLE = [OFFSET.NW, OFFSET.W, OFFSET.E, OFFSET.NE];\nconst W_RECTANGLE = [OFFSET.NW, OFFSET.SW, OFFSET.S, OFFSET.N];\nconst EW_RECTANGEL = [\n  [-HALF, ONE6TH],\n  [-HALF, -ONE6TH],\n  [HALF, -ONE6TH],\n  [HALF, ONE6TH]\n];\nconst SN_RECTANGEL = [\n  [-ONE6TH, -HALF],\n  [ONE6TH, -HALF],\n  [ONE6TH, HALF],\n  [-ONE6TH, HALF]\n];\n\n// Square\nconst SQUARE = [OFFSET.NW, OFFSET.SW, OFFSET.SE, OFFSET.NE];\n\n// Pentagons\nconst SW_PENTAGON = [OFFSET.NW, OFFSET.SW, OFFSET.SE, OFFSET.E, OFFSET.N];\nconst SE_PENTAGON = [OFFSET.W, OFFSET.SW, OFFSET.SE, OFFSET.NE, OFFSET.N];\nconst NE_PENTAGON = [OFFSET.NW, OFFSET.W, OFFSET.S, OFFSET.SE, OFFSET.NE];\nconst NW_PENTAGON = [OFFSET.NW, OFFSET.SW, OFFSET.S, OFFSET.E, OFFSET.NE];\n\nconst NW_N_PENTAGON = [OFFSET.NW, OFFSET.W, [HALF, -ONE6TH], [HALF, ONE6TH], OFFSET.N];\nconst NE_E_PENTAGON = [[-ONE6TH, -HALF], [ONE6TH, -HALF], OFFSET.E, OFFSET.NE, OFFSET.N];\nconst SE_S_PENTAGON = [[-HALF, ONE6TH], [-HALF, -ONE6TH], OFFSET.S, OFFSET.SE, OFFSET.E];\nconst SW_W_PENTAGON = [OFFSET.W, OFFSET.SW, OFFSET.S, [ONE6TH, HALF], [-ONE6TH, HALF]];\n\nconst NW_W_PENTAGON = [OFFSET.NW, OFFSET.W, [-ONE6TH, -HALF], [ONE6TH, -HALF], OFFSET.N];\nconst NE_N_PENTAGON = [[-HALF, ONE6TH], [-HALF, -ONE6TH], OFFSET.E, OFFSET.NE, OFFSET.N];\nconst SE_E_PENTAGON = [OFFSET.S, OFFSET.SE, OFFSET.E, [ONE6TH, HALF], [-ONE6TH, HALF]];\nconst SW_S_PENTAGON = [OFFSET.W, OFFSET.SW, OFFSET.S, [HALF, -ONE6TH], [HALF, ONE6TH]];\n\n// Hexagon\nconst S_HEXAGON = [OFFSET.W, OFFSET.SW, OFFSET.SE, OFFSET.E, [ONE6TH, HALF], [-ONE6TH, HALF]];\nconst E_HEXAGON = [[-HALF, ONE6TH], [-HALF, -ONE6TH], OFFSET.S, OFFSET.SE, OFFSET.NE, OFFSET.N];\nconst N_HEXAGON = [OFFSET.NW, OFFSET.W, [-ONE6TH, -HALF], [ONE6TH, -HALF], OFFSET.E, OFFSET.NE];\nconst W_HEXAGON = [OFFSET.NW, OFFSET.SW, OFFSET.S, [HALF, -ONE6TH], [HALF, ONE6TH], OFFSET.N];\nconst SW_NE_HEXAGON = [OFFSET.W, OFFSET.SW, OFFSET.S, OFFSET.E, OFFSET.NE, OFFSET.N];\nconst NW_SE_HEXAGON = [OFFSET.NW, OFFSET.W, OFFSET.S, OFFSET.SE, OFFSET.E, OFFSET.N];\n\n// Heptagon (7-sided)\nconst NE_HEPTAGON = [\n  [-HALF, ONE6TH],\n  [-HALF, -ONE6TH],\n  [-ONE6TH, -HALF],\n  [ONE6TH, -HALF],\n  OFFSET.E,\n  OFFSET.NE,\n  OFFSET.N\n];\nconst SW_HEPTAGON = [\n  OFFSET.W,\n  OFFSET.SW,\n  OFFSET.S,\n  [HALF, -ONE6TH],\n  [HALF, ONE6TH],\n  [ONE6TH, HALF],\n  [-ONE6TH, HALF]\n];\nconst NW_HEPTAGON = [\n  OFFSET.NW,\n  OFFSET.W,\n  [-ONE6TH, -HALF],\n  [ONE6TH, -HALF],\n  [HALF, -ONE6TH],\n  [HALF, ONE6TH],\n  OFFSET.N\n];\nconst SE_HEPTAGON = [\n  [-HALF, ONE6TH],\n  [-HALF, -ONE6TH],\n  OFFSET.S,\n  OFFSET.SE,\n  OFFSET.E,\n  [ONE6TH, HALF],\n  [-ONE6TH, HALF]\n];\n\n// Octagon\nconst OCTAGON = [\n  [-HALF, ONE6TH],\n  [-HALF, -ONE6TH],\n  [-ONE6TH, -HALF],\n  [ONE6TH, -HALF],\n  [HALF, -ONE6TH],\n  [HALF, ONE6TH],\n  [ONE6TH, HALF],\n  [-ONE6TH, HALF]\n];\n\n// Note: above wiki page invertes white/black dots for generating the code, we don't\nexport const ISOLINES_CODE_OFFSET_MAP = {\n  // key is equal to the code of 4 vertices (invert the code specified in wiki)\n  // value can be an array or an Object\n  // Array : [line] or [line, line], where each line is [start-point, end-point], and each point is [x, y]\n  // Object : to handle saddle cases, whos output depends on mean value of all 4 corners\n  //  key: code of mean value (0 or 1)\n  //  value: Array , as above defines one or two line segments\n  0: [],\n  1: [[OFFSET.W, OFFSET.S]],\n  2: [[OFFSET.S, OFFSET.E]],\n  3: [[OFFSET.W, OFFSET.E]],\n  4: [[OFFSET.N, OFFSET.E]],\n  5: {\n    0: [\n      [OFFSET.W, OFFSET.S],\n      [OFFSET.N, OFFSET.E]\n    ],\n    1: [\n      [OFFSET.W, OFFSET.N],\n      [OFFSET.S, OFFSET.E]\n    ]\n  },\n  6: [[OFFSET.N, OFFSET.S]],\n  7: [[OFFSET.W, OFFSET.N]],\n  8: [[OFFSET.W, OFFSET.N]],\n  9: [[OFFSET.N, OFFSET.S]],\n  10: {\n    0: [\n      [OFFSET.W, OFFSET.N],\n      [OFFSET.S, OFFSET.E]\n    ],\n    1: [\n      [OFFSET.W, OFFSET.S],\n      [OFFSET.N, OFFSET.E]\n    ]\n  },\n  11: [[OFFSET.N, OFFSET.E]],\n  12: [[OFFSET.W, OFFSET.E]],\n  13: [[OFFSET.S, OFFSET.E]],\n  14: [[OFFSET.W, OFFSET.S]],\n  15: []\n};\n\nfunction ternaryToIndex(ternary) {\n  return parseInt(ternary, 4);\n}\n\nexport const ISOBANDS_CODE_OFFSET_MAP = {\n  // Below list of cases, follow the same order as in above mentioned wiki page.\n  // Each case has its code on first commented line // T,TR,R,C\n  // where T: Top, TR: Top-right, R: Right and C: current, each will be either 0, 1 or 2\n  // final code is binary representation of above code , where takes 2 digits\n  // for example:  code 2-2-2-1 => 10-10-10-01 => 10101001 => 169\n\n  // no contours\n  [ternaryToIndex('0000')]: [],\n  [ternaryToIndex('2222')]: [],\n\n  // single triangle\n  [ternaryToIndex('2221')]: [SW_TRIANGLE],\n  [ternaryToIndex('2212')]: [SE_TRIANGLE],\n  [ternaryToIndex('2122')]: [NE_TRIANGLE],\n  [ternaryToIndex('1222')]: [NW_TRIANGLE],\n  [ternaryToIndex('0001')]: [SW_TRIANGLE],\n  [ternaryToIndex('0010')]: [SE_TRIANGLE],\n  [ternaryToIndex('0100')]: [NE_TRIANGLE],\n  [ternaryToIndex('1000')]: [NW_TRIANGLE],\n\n  // single trapezoid\n  [ternaryToIndex('2220')]: [SW_TRAPEZOID],\n  [ternaryToIndex('2202')]: [SE_TRAPEZOID],\n  [ternaryToIndex('2022')]: [NE_TRAPEZOID],\n  [ternaryToIndex('0222')]: [NW_TRAPEZOID],\n  [ternaryToIndex('0002')]: [SW_TRAPEZOID],\n  [ternaryToIndex('0020')]: [SE_TRAPEZOID],\n  [ternaryToIndex('0200')]: [NE_TRAPEZOID],\n  [ternaryToIndex('2000')]: [NW_TRAPEZOID],\n\n  // single rectangle\n  [ternaryToIndex('0011')]: [S_RECTANGLE],\n  [ternaryToIndex('0110')]: [E_RECTANGLE],\n  [ternaryToIndex('1100')]: [N_RECTANGLE],\n  [ternaryToIndex('1001')]: [W_RECTANGLE],\n  [ternaryToIndex('2211')]: [S_RECTANGLE],\n  [ternaryToIndex('2112')]: [E_RECTANGLE],\n  [ternaryToIndex('1122')]: [N_RECTANGLE],\n  [ternaryToIndex('1221')]: [W_RECTANGLE],\n  [ternaryToIndex('2200')]: [EW_RECTANGEL],\n  [ternaryToIndex('2002')]: [SN_RECTANGEL],\n  [ternaryToIndex('0022')]: [EW_RECTANGEL],\n  [ternaryToIndex('0220')]: [SN_RECTANGEL],\n\n  // single square\n  // 1111\n  [ternaryToIndex('1111')]: [SQUARE],\n\n  // single pentagon\n  [ternaryToIndex('1211')]: [SW_PENTAGON],\n  [ternaryToIndex('2111')]: [SE_PENTAGON],\n  [ternaryToIndex('1112')]: [NE_PENTAGON],\n  [ternaryToIndex('1121')]: [NW_PENTAGON],\n  [ternaryToIndex('1011')]: [SW_PENTAGON],\n  [ternaryToIndex('0111')]: [SE_PENTAGON],\n  [ternaryToIndex('1110')]: [NE_PENTAGON],\n  [ternaryToIndex('1101')]: [NW_PENTAGON],\n  [ternaryToIndex('1200')]: [NW_N_PENTAGON],\n  [ternaryToIndex('0120')]: [NE_E_PENTAGON],\n  [ternaryToIndex('0012')]: [SE_S_PENTAGON],\n  [ternaryToIndex('2001')]: [SW_W_PENTAGON],\n  [ternaryToIndex('1022')]: [NW_N_PENTAGON],\n  [ternaryToIndex('2102')]: [NE_E_PENTAGON],\n  [ternaryToIndex('2210')]: [SE_S_PENTAGON],\n  [ternaryToIndex('0221')]: [SW_W_PENTAGON],\n  [ternaryToIndex('1002')]: [NW_W_PENTAGON],\n  [ternaryToIndex('2100')]: [NE_N_PENTAGON],\n  [ternaryToIndex('0210')]: [SE_E_PENTAGON],\n  [ternaryToIndex('0021')]: [SW_S_PENTAGON],\n  [ternaryToIndex('1220')]: [NW_W_PENTAGON],\n  [ternaryToIndex('0122')]: [NE_N_PENTAGON],\n  [ternaryToIndex('2012')]: [SE_E_PENTAGON],\n  [ternaryToIndex('2201')]: [SW_S_PENTAGON],\n\n  // single hexagon\n  [ternaryToIndex('0211')]: [S_HEXAGON],\n  [ternaryToIndex('2110')]: [E_HEXAGON],\n  [ternaryToIndex('1102')]: [N_HEXAGON],\n  [ternaryToIndex('1021')]: [W_HEXAGON],\n  [ternaryToIndex('2011')]: [S_HEXAGON],\n  [ternaryToIndex('0112')]: [E_HEXAGON],\n  [ternaryToIndex('1120')]: [N_HEXAGON],\n  [ternaryToIndex('1201')]: [W_HEXAGON],\n  [ternaryToIndex('2101')]: [SW_NE_HEXAGON],\n  [ternaryToIndex('0121')]: [SW_NE_HEXAGON],\n  [ternaryToIndex('1012')]: [NW_SE_HEXAGON],\n  [ternaryToIndex('1210')]: [NW_SE_HEXAGON],\n\n  // 6-sided polygons based on mean weight\n  // NOTE: merges mean value codes for extreme changes (as per above Wiki doc)\n  [ternaryToIndex('0101')]: {\n    0: [SW_TRIANGLE, NE_TRIANGLE],\n    1: [SW_NE_HEXAGON],\n    2: [SW_NE_HEXAGON]\n  },\n  [ternaryToIndex('1010')]: {\n    0: [NW_TRIANGLE, SE_TRIANGLE],\n    1: [NW_SE_HEXAGON],\n    2: [NW_SE_HEXAGON]\n  },\n  [ternaryToIndex('2121')]: {\n    0: [SW_NE_HEXAGON],\n    1: [SW_NE_HEXAGON],\n    2: [SW_TRIANGLE, NE_TRIANGLE]\n  },\n  [ternaryToIndex('1212')]: {\n    0: [NW_SE_HEXAGON],\n    1: [NW_SE_HEXAGON],\n    2: [NW_TRIANGLE, SE_TRIANGLE]\n  },\n\n  // 7-sided polygons based on mean weight\n  [ternaryToIndex('2120')]: {\n    0: [NE_HEPTAGON],\n    1: [NE_HEPTAGON],\n    2: [SW_TRAPEZOID, NE_TRIANGLE]\n  },\n  [ternaryToIndex('2021')]: {\n    0: [SW_HEPTAGON],\n    1: [SW_HEPTAGON],\n    2: [SW_TRIANGLE, NE_TRAPEZOID]\n  },\n  [ternaryToIndex('1202')]: {\n    0: [NW_HEPTAGON],\n    1: [NW_HEPTAGON],\n    2: [NW_TRIANGLE, SE_TRAPEZOID]\n  },\n  [ternaryToIndex('0212')]: {\n    0: [SE_HEPTAGON],\n    1: [SE_HEPTAGON],\n    2: [SE_TRIANGLE, NW_TRAPEZOID]\n  },\n  [ternaryToIndex('0102')]: {\n    0: [SW_TRAPEZOID, NE_TRIANGLE],\n    1: [NE_HEPTAGON],\n    2: [NE_HEPTAGON]\n  },\n  [ternaryToIndex('0201')]: {\n    0: [SW_TRIANGLE, NE_TRAPEZOID],\n    1: [SW_HEPTAGON],\n    2: [SW_HEPTAGON]\n  },\n  [ternaryToIndex('1020')]: {\n    0: [NW_TRIANGLE, SE_TRAPEZOID],\n    1: [NW_HEPTAGON],\n    2: [NW_HEPTAGON]\n  },\n  [ternaryToIndex('2010')]: {\n    0: [SE_TRIANGLE, NW_TRAPEZOID],\n    1: [SE_HEPTAGON],\n    2: [SE_HEPTAGON]\n  },\n\n  // 8-sided polygons based on mean weight\n  [ternaryToIndex('2020')]: {\n    0: [NW_TRAPEZOID, SE_TRAPEZOID],\n    1: [OCTAGON],\n    2: [SW_TRAPEZOID, NE_TRAPEZOID]\n  },\n  [ternaryToIndex('0202')]: {\n    0: [NE_TRAPEZOID, SW_TRAPEZOID],\n    1: [OCTAGON],\n    2: [NW_TRAPEZOID, SE_TRAPEZOID]\n  }\n};\n","// All utility methods needed to implement Marching Squares algorithm\n// Ref: https://en.wikipedia.org/wiki/Marching_squares\n\nimport {log} from '@deck.gl/core';\nimport {ISOLINES_CODE_OFFSET_MAP, ISOBANDS_CODE_OFFSET_MAP} from './marching-squares-codes';\n\nexport const CONTOUR_TYPE = {\n  ISO_LINES: 1,\n  ISO_BANDS: 2\n};\n\nconst DEFAULT_THRESHOLD_DATA = {\n  zIndex: 0,\n  zOffset: 0.005\n};\n\n// Utility methods\n\nfunction getVertexCode(weight: number, threshold: number | number[]): number {\n  // threshold must be a single value or a range (array of size 2)\n\n  // Iso-bands\n  if (Array.isArray(threshold)) {\n    if (weight < threshold[0]) {\n      return 0;\n    }\n    return weight < threshold[1] ? 1 : 2;\n  }\n  // Iso-lines\n  return weight >= threshold ? 1 : 0;\n}\n\n// Returns marching square code for given cell\n/* eslint-disable complexity, max-statements*/\nexport function getCode(opts) {\n  // Assumptions\n  // Origin is on bottom-left , and X increase to right, Y to top\n  // When processing one cell, we process 4 cells, by extending row to top and on column to right\n  // to create a 2X2 cell grid\n  const {cellWeights, x, y, width, height} = opts;\n  let threshold = opts.threshold;\n  if (opts.thresholdValue) {\n    log.deprecated('thresholdValue', 'threshold')();\n    threshold = opts.thresholdValue;\n  }\n\n  const isLeftBoundary = x < 0;\n  const isRightBoundary = x >= width - 1;\n  const isBottomBoundary = y < 0;\n  const isTopBoundary = y >= height - 1;\n  const isBoundary = isLeftBoundary || isRightBoundary || isBottomBoundary || isTopBoundary;\n\n  const weights: Record<string, number> = {};\n  const codes: Record<string, number> = {};\n\n  // TOP\n  if (isLeftBoundary || isTopBoundary) {\n    codes.top = 0;\n  } else {\n    weights.top = cellWeights[(y + 1) * width + x];\n    codes.top = getVertexCode(weights.top, threshold);\n  }\n\n  // TOP-RIGHT\n  if (isRightBoundary || isTopBoundary) {\n    codes.topRight = 0;\n  } else {\n    weights.topRight = cellWeights[(y + 1) * width + x + 1];\n    codes.topRight = getVertexCode(weights.topRight, threshold);\n  }\n\n  // RIGHT\n  if (isRightBoundary || isBottomBoundary) {\n    codes.right = 0;\n  } else {\n    weights.right = cellWeights[y * width + x + 1];\n    codes.right = getVertexCode(weights.right, threshold);\n  }\n\n  // CURRENT\n  if (isLeftBoundary || isBottomBoundary) {\n    codes.current = 0;\n  } else {\n    weights.current = cellWeights[y * width + x];\n    codes.current = getVertexCode(weights.current, threshold);\n  }\n\n  const {top, topRight, right, current} = codes;\n  let code = -1;\n  if (Number.isFinite(threshold)) {\n    code = (top << 3) | (topRight << 2) | (right << 1) | current;\n  }\n  if (Array.isArray(threshold)) {\n    code = (top << 6) | (topRight << 4) | (right << 2) | current;\n  }\n\n  let meanCode = 0;\n  // meanCode is only needed for saddle cases, and they should\n  // only occur when we are not processing a cell on boundary\n  // because when on a boundary either, bottom-row, top-row, left-column or right-column will have both 0 codes\n  if (!isBoundary) {\n    meanCode = getVertexCode(\n      (weights.top + weights.topRight + weights.right + weights.current) / 4,\n      threshold\n    );\n  }\n  return {code, meanCode};\n}\n/* eslint-enable complexity, max-statements*/\n\n// Returns intersection vertices for given cellindex\n// [x, y] refers current marching cell, reference vertex is always top-right corner\nexport function getVertices(opts) {\n  const {gridOrigin, cellSize, x, y, code, meanCode, type = CONTOUR_TYPE.ISO_LINES} = opts;\n  const thresholdData = {...DEFAULT_THRESHOLD_DATA, ...opts.thresholdData};\n  let offsets =\n    type === CONTOUR_TYPE.ISO_BANDS\n      ? ISOBANDS_CODE_OFFSET_MAP[code]\n      : ISOLINES_CODE_OFFSET_MAP[code];\n\n  // handle saddle cases\n  if (!Array.isArray(offsets)) {\n    offsets = offsets[meanCode];\n  }\n\n  // Reference vertex is at top-right move to top-right corner\n\n  const vZ = thresholdData.zIndex * thresholdData.zOffset;\n  const rX = (x + 1) * cellSize[0];\n  const rY = (y + 1) * cellSize[1];\n\n  const refVertexX = gridOrigin[0] + rX;\n  const refVertexY = gridOrigin[1] + rY;\n\n  // offsets format\n  // ISO_LINES: [[1A, 1B], [2A, 2B]],\n  // ISO_BANDS: [[1A, 1B, 1C, ...], [2A, 2B, 2C, ...]],\n\n  // vertices format\n\n  // ISO_LINES: [[x1A, y1A], [x1B, y1B], [x2A, x2B], ...],\n\n  // ISO_BANDS:  => confirms to SolidPolygonLayer's simple polygon format\n  //      [\n  //        [[x1A, y1A], [x1B, y1B], [x1C, y1C] ... ],\n  //        ...\n  //      ]\n\n  if (type === CONTOUR_TYPE.ISO_BANDS) {\n    const polygons: number[][][] = [];\n    offsets.forEach(polygonOffsets => {\n      const polygon: number[][] = [];\n      polygonOffsets.forEach(xyOffset => {\n        const vX = refVertexX + xyOffset[0] * cellSize[0];\n        const vY = refVertexY + xyOffset[1] * cellSize[1];\n        polygon.push([vX, vY, vZ]);\n      });\n      polygons.push(polygon);\n    });\n    return polygons;\n  }\n\n  // default case is ISO_LINES\n  const lines: number[][] = [];\n  offsets.forEach(xyOffsets => {\n    xyOffsets.forEach(offset => {\n      const vX = refVertexX + offset[0] * cellSize[0];\n      const vY = refVertexY + offset[1] * cellSize[1];\n      lines.push([vX, vY, vZ]);\n    });\n  });\n  return lines;\n}\n","// Copyright (c) 2015 - 2018 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport GL from '@luma.gl/constants';\nimport {LineLayer, SolidPolygonLayer} from '@deck.gl/layers';\nimport {generateContours} from './contour-utils';\nimport {\n  Accessor,\n  AccessorFunction,\n  Color,\n  Layer,\n  log,\n  Position,\n  UpdateParameters,\n  DefaultProps\n} from '@deck.gl/core';\n\nimport GPUGridAggregator from '../utils/gpu-grid-aggregation/gpu-grid-aggregator';\nimport {AGGREGATION_OPERATION, getValueFunc} from '../utils/aggregation-operation-utils';\nimport {getBoundingBox, getGridParams} from '../utils/grid-aggregation-utils';\nimport GridAggregationLayer, {GridAggregationLayerProps} from '../grid-aggregation-layer';\n\nconst DEFAULT_COLOR = [255, 255, 255, 255];\nconst DEFAULT_STROKE_WIDTH = 1;\nconst DEFAULT_THRESHOLD = 1;\n\nconst defaultProps: DefaultProps<ContourLayerProps> = {\n  // grid aggregation\n  cellSize: {type: 'number', min: 1, max: 1000, value: 1000},\n  getPosition: {type: 'accessor', value: x => x.position},\n  getWeight: {type: 'accessor', value: 1},\n  gpuAggregation: true,\n  aggregation: 'SUM',\n\n  // contour lines\n  contours: [{threshold: DEFAULT_THRESHOLD}],\n\n  zOffset: 0.005\n};\n\nconst POSITION_ATTRIBUTE_NAME = 'positions';\n\nconst DIMENSIONS = {\n  data: {\n    props: ['cellSize']\n  },\n  weights: {\n    props: ['aggregation'],\n    accessors: ['getWeight']\n  }\n};\n\n/** All properties supported by ContourLayer. */\nexport type ContourLayerProps<DataT = any> = _ContourLayerProps<DataT> &\n  GridAggregationLayerProps<DataT>;\n\n/** Properties added by ContourLayer. */\nexport type _ContourLayerProps<DataT> = {\n  /**\n   * Size of each cell in meters.\n   * @default 1000\n   */\n  cellSize?: number;\n\n  /**\n   * When set to true, aggregation is performed on GPU, provided other conditions are met.\n   * @default true\n   */\n  gpuAggregation?: boolean;\n\n  /**\n   * Defines the type of aggregation operation, valid values are 'SUM', 'MEAN', 'MIN' and 'MAX'.\n   * @default 'SUM'\n   */\n  aggregation?: 'SUM' | 'MEAN' | 'MIN' | 'MAX';\n\n  /**\n   * Definition of contours to be drawn.\n   * @default [{threshold: 1}]\n   */\n  contours: {\n    /**\n     * Isolines: `threshold` value must be a single `Number`, Isolines are generated based on this threshold value.\n     *\n     * Isobands: `threshold` value must be an Array of two `Number`s. Isobands are generated using `[threshold[0], threshold[1])` as threshold range, i.e area that has values `>= threshold[0]` and `< threshold[1]` are rendered with corresponding color. NOTE: `threshold[0]` is inclusive and `threshold[1]` is not inclusive.\n     */\n    threshold: number | number[];\n\n    /**\n     * RGBA color array to be used to render the contour.\n     * @default [255, 255, 255, 255]\n     */\n    color?: Color;\n\n    /**\n     * Applicable for `Isoline`s only, width of the Isoline in pixels.\n     * @default 1\n     */\n    strokeWidth?: number;\n\n    /** Defines z order of the contour. */\n    zIndex?: number;\n  }[];\n\n  /**\n   * A very small z offset that is added for each vertex of a contour (Isoline or Isoband).\n   * @default 0.005\n   */\n  zOffset?: number;\n\n  /**\n   * Method called to retrieve the position of each object.\n   * @default object => object.position\n   */\n  getPosition?: AccessorFunction<DataT, Position>;\n\n  /**\n   * The weight of each object.\n   * @default 1\n   */\n  getWeight?: Accessor<DataT, number>;\n};\n\n/** Aggregate data into iso-lines or iso-bands for a given threshold and cell size. */\nexport default class ContourLayer<DataT = any, ExtraPropsT = {}> extends GridAggregationLayer<\n  ExtraPropsT & Required<_ContourLayerProps<DataT>>\n> {\n  static layerName = 'ContourLayer';\n  static defaultProps = defaultProps;\n\n  initializeState(): void {\n    super.initializeAggregationLayer({\n      dimensions: DIMENSIONS\n    });\n    this.setState({\n      contourData: {},\n      projectPoints: false,\n      weights: {\n        count: {\n          size: 1,\n          operation: AGGREGATION_OPERATION.SUM\n        }\n      }\n    });\n    const attributeManager = this.getAttributeManager()!;\n    attributeManager.add({\n      [POSITION_ATTRIBUTE_NAME]: {\n        size: 3,\n        accessor: 'getPosition',\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions()\n      },\n      // this attribute is used in gpu aggregation path only\n      count: {size: 3, accessor: 'getWeight'}\n    });\n  }\n\n  updateState(opts: UpdateParameters<this>): void {\n    super.updateState(opts);\n    let contoursChanged = false;\n    const {oldProps, props} = opts;\n    const {aggregationDirty} = this.state;\n\n    if (oldProps.contours !== props.contours || oldProps.zOffset !== props.zOffset) {\n      contoursChanged = true;\n      this._updateThresholdData(opts.props);\n    }\n\n    if (this.getNumInstances() > 0 && (aggregationDirty || contoursChanged)) {\n      this._generateContours();\n    }\n  }\n\n  renderLayers(): Layer[] {\n    const {contourSegments, contourPolygons} = this.state.contourData;\n\n    const LinesSubLayerClass = this.getSubLayerClass('lines', LineLayer);\n    const BandsSubLayerClass = this.getSubLayerClass('bands', SolidPolygonLayer);\n\n    // Contour lines layer\n    const lineLayer =\n      contourSegments &&\n      contourSegments.length > 0 &&\n      new LinesSubLayerClass(\n        this.getSubLayerProps({\n          id: 'lines'\n        }),\n        {\n          data: this.state.contourData.contourSegments,\n          getSourcePosition: d => d.start,\n          getTargetPosition: d => d.end,\n          getColor: d => d.contour.color || DEFAULT_COLOR,\n          getWidth: d => d.contour.strokeWidth || DEFAULT_STROKE_WIDTH\n        }\n      );\n\n    // Contour bands layer\n    const bandsLayer =\n      contourPolygons &&\n      contourPolygons.length > 0 &&\n      new BandsSubLayerClass(\n        this.getSubLayerProps({\n          id: 'bands'\n        }),\n        {\n          data: this.state.contourData.contourPolygons,\n          getPolygon: d => d.vertices,\n          getFillColor: d => d.contour.color || DEFAULT_COLOR\n        }\n      );\n\n    return [lineLayer, bandsLayer];\n  }\n\n  // Aggregation Overrides\n\n  /* eslint-disable max-statements, complexity */\n  updateAggregationState(opts) {\n    const {props, oldProps} = opts;\n    const {cellSize, coordinateSystem} = props;\n    const {viewport} = this.context;\n    const cellSizeChanged = oldProps.cellSize !== cellSize;\n    let gpuAggregation = props.gpuAggregation;\n    if (this.state.gpuAggregation !== props.gpuAggregation) {\n      if (gpuAggregation && !GPUGridAggregator.isSupported(this.context.gl)) {\n        log.warn('GPU Grid Aggregation not supported, falling back to CPU')();\n        gpuAggregation = false;\n      }\n    }\n    const gpuAggregationChanged = gpuAggregation !== this.state.gpuAggregation;\n    this.setState({\n      gpuAggregation\n    });\n\n    const {dimensions} = this.state;\n    const positionsChanged = this.isAttributeChanged(POSITION_ATTRIBUTE_NAME);\n    const {data, weights} = dimensions;\n\n    let {boundingBox} = this.state;\n    if (positionsChanged) {\n      boundingBox = getBoundingBox(this.getAttributes(), this.getNumInstances());\n      this.setState({boundingBox});\n    }\n    if (positionsChanged || cellSizeChanged) {\n      const {gridOffset, translation, width, height, numCol, numRow} = getGridParams(\n        boundingBox,\n        cellSize,\n        viewport,\n        coordinateSystem\n      );\n      this.allocateResources(numRow, numCol);\n      this.setState({\n        gridOffset,\n        boundingBox,\n        translation,\n        posOffset: translation.slice(), // Used for CPU aggregation, to offset points\n        gridOrigin: [-1 * translation[0], -1 * translation[1]],\n        width,\n        height,\n        numCol,\n        numRow\n      });\n    }\n\n    const aggregationDataDirty =\n      positionsChanged ||\n      gpuAggregationChanged ||\n      this.isAggregationDirty(opts, {\n        dimension: data,\n        compareAll: gpuAggregation // check for all (including extentions props) when using gpu aggregation\n      });\n    const aggregationWeightsDirty = this.isAggregationDirty(opts, {\n      dimension: weights\n    });\n\n    if (aggregationWeightsDirty) {\n      this._updateAccessors(opts);\n    }\n    if (aggregationDataDirty || aggregationWeightsDirty) {\n      this._resetResults();\n    }\n    this.setState({\n      aggregationDataDirty,\n      aggregationWeightsDirty\n    });\n  }\n  /* eslint-enable max-statements, complexity */\n\n  // Private (Aggregation)\n\n  private _updateAccessors(opts) {\n    const {getWeight, aggregation, data} = opts.props;\n    const {count} = this.state.weights;\n    if (count) {\n      count.getWeight = getWeight;\n      count.operation = AGGREGATION_OPERATION[aggregation];\n    }\n    this.setState({getValue: getValueFunc(aggregation, getWeight, {data})});\n  }\n\n  private _resetResults() {\n    const {count} = this.state.weights;\n    if (count) {\n      count.aggregationData = null;\n    }\n  }\n\n  // Private (Contours)\n\n  private _generateContours() {\n    const {numCol, numRow, gridOrigin, gridOffset, thresholdData} = this.state;\n    const {count} = this.state.weights;\n    let {aggregationData} = count;\n    if (!aggregationData) {\n      aggregationData = count.aggregationBuffer.getData();\n      count.aggregationData = aggregationData;\n    }\n\n    const {cellWeights} = GPUGridAggregator.getCellData({countsData: aggregationData});\n    const contourData = generateContours({\n      thresholdData,\n      cellWeights,\n      gridSize: [numCol, numRow],\n      gridOrigin,\n      cellSize: [gridOffset.xOffset, gridOffset.yOffset]\n    });\n\n    // contourData contains both iso-lines and iso-bands if requested.\n    this.setState({contourData});\n  }\n\n  private _updateThresholdData(props) {\n    const {contours, zOffset} = props;\n    const count = contours.length;\n    const thresholdData = new Array(count);\n    for (let i = 0; i < count; i++) {\n      const contour = contours[i];\n      thresholdData[i] = {\n        contour,\n        zIndex: contour.zIndex || i,\n        zOffset\n      };\n    }\n    this.setState({thresholdData});\n  }\n}\n","import {getCode, getVertices, CONTOUR_TYPE} from './marching-squares';\n\n// Given all the cell weights, generates contours for each threshold.\n/* eslint-disable max-depth */\nexport function generateContours({\n  thresholdData,\n  cellWeights,\n  gridSize,\n  gridOrigin,\n  cellSize\n}: {\n  thresholdData: any;\n  cellWeights: Float32Array;\n  gridSize: number[];\n  gridOrigin: number[];\n  cellSize: number[];\n}) {\n  const contourSegments: {start: number[]; end: number[]; contour: any}[] = [];\n  const contourPolygons: {vertices: number[][]; contour: any}[] = [];\n  const width = gridSize[0];\n  const height = gridSize[1];\n  let segmentIndex = 0;\n  let polygonIndex = 0;\n\n  for (const data of thresholdData) {\n    const {contour} = data;\n    const {threshold} = contour;\n    for (let x = -1; x < width; x++) {\n      for (let y = -1; y < height; y++) {\n        // Get the MarchingSquares code based on neighbor cell weights.\n        const {code, meanCode} = getCode({\n          cellWeights,\n          threshold,\n          x,\n          y,\n          width,\n          height\n        });\n        const opts = {\n          type: CONTOUR_TYPE.ISO_BANDS,\n          gridOrigin,\n          cellSize,\n          x,\n          y,\n          width,\n          height,\n          code,\n          meanCode,\n          thresholdData: data\n        };\n        if (Array.isArray(threshold)) {\n          opts.type = CONTOUR_TYPE.ISO_BANDS;\n          const polygons = getVertices(opts) as number[][][];\n          for (const polygon of polygons) {\n            contourPolygons[polygonIndex++] = {\n              vertices: polygon,\n              contour\n            };\n          }\n        } else {\n          // Get the intersection vertices based on MarchingSquares code.\n          opts.type = CONTOUR_TYPE.ISO_LINES;\n          const vertices = getVertices(opts) as number[][];\n          for (let i = 0; i < vertices.length; i += 2) {\n            contourSegments[segmentIndex++] = {\n              start: vertices[i],\n              end: vertices[i + 1],\n              contour\n            };\n          }\n        }\n      }\n    }\n  }\n  return {contourSegments, contourPolygons};\n}\n/* eslint-enable max-depth */\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {\n  Layer,\n  fp64LowPart,\n  project32,\n  gouraudLighting,\n  picking,\n  LayerContext,\n  LayerProps,\n  DefaultProps\n} from '@deck.gl/core';\nimport GL from '@luma.gl/constants';\nimport {Model, CubeGeometry, Buffer} from '@luma.gl/core';\nimport {fp64arithmetic} from '@luma.gl/shadertools';\nimport {defaultColorRange, colorRangeToFlatArray} from '../utils/color-utils';\nimport type {_GPUGridLayerProps} from './gpu-grid-layer';\nimport vs from './gpu-grid-cell-layer-vertex.glsl';\nimport fs from './gpu-grid-cell-layer-fragment.glsl';\n\nconst COLOR_DATA_UBO_INDEX = 0;\nconst ELEVATION_DATA_UBO_INDEX = 1;\n\nconst defaultProps: DefaultProps<_GPUGridCellLayerProps & LayerProps> = {\n  // color\n  colorDomain: null,\n  colorRange: defaultColorRange,\n\n  // elevation\n  elevationDomain: null,\n  elevationRange: [0, 1000],\n  elevationScale: {type: 'number', min: 0, value: 1},\n\n  // grid\n  gridSize: {type: 'array', value: [1, 1]},\n  gridOrigin: {type: 'array', value: [0, 0]},\n  gridOffset: {type: 'array', value: [0, 0]},\n\n  cellSize: {type: 'number', min: 0, max: 1000, value: 1000},\n  offset: {type: 'array', value: [1, 1]},\n  coverage: {type: 'number', min: 0, max: 1, value: 1},\n  extruded: true,\n\n  material: true // Use lighting module defaults\n};\n\ntype _GPUGridCellLayerProps = _GPUGridLayerProps<any> & {\n  offset: number[];\n  gridSize: number[];\n  gridOrigin: number[];\n  gridOffset: number[];\n  colorMaxMinBuffer: Buffer;\n  elevationMaxMinBuffer: Buffer;\n};\n\nexport default class GPUGridCellLayer extends Layer<_GPUGridCellLayerProps> {\n  static layerName = 'GPUGridCellLayer';\n  static defaultProps = defaultProps;\n\n  getShaders() {\n    return super.getShaders({\n      vs,\n      fs,\n      modules: [project32, gouraudLighting, picking, fp64arithmetic]\n    });\n  }\n\n  initializeState({gl}: LayerContext) {\n    const attributeManager = this.getAttributeManager()!;\n    attributeManager.addInstanced({\n      colors: {\n        size: 4,\n        noAlloc: true\n      },\n      elevations: {\n        size: 4,\n        noAlloc: true\n      }\n    });\n    const model = this._getModel(gl);\n    this._setupUniformBuffer(model);\n    this.setState({model});\n  }\n\n  _getModel(gl: WebGLRenderingContext): Model {\n    return new Model(gl, {\n      ...this.getShaders(),\n      id: this.props.id,\n      geometry: new CubeGeometry(),\n      isInstanced: true\n    });\n  }\n\n  draw({uniforms}) {\n    const {\n      cellSize,\n      offset,\n      extruded,\n      elevationScale,\n      coverage,\n      gridSize,\n      gridOrigin,\n      gridOffset,\n      elevationRange,\n      colorMaxMinBuffer,\n      elevationMaxMinBuffer\n    } = this.props;\n\n    const gridOriginLow = [fp64LowPart(gridOrigin[0]), fp64LowPart(gridOrigin[1])];\n    const gridOffsetLow = [fp64LowPart(gridOffset[0]), fp64LowPart(gridOffset[1])];\n    const domainUniforms = this.getDomainUniforms();\n    const colorRange = colorRangeToFlatArray(this.props.colorRange);\n    this.bindUniformBuffers(colorMaxMinBuffer, elevationMaxMinBuffer);\n    this.state.model\n      .setUniforms(uniforms)\n      .setUniforms(domainUniforms)\n      .setUniforms({\n        cellSize,\n        offset,\n        extruded,\n        elevationScale,\n        coverage,\n        gridSize,\n        gridOrigin,\n        gridOriginLow,\n        gridOffset,\n        gridOffsetLow,\n        colorRange,\n        elevationRange\n      })\n      .draw();\n    this.unbindUniformBuffers(colorMaxMinBuffer, elevationMaxMinBuffer);\n  }\n\n  bindUniformBuffers(colorMaxMinBuffer, elevationMaxMinBuffer) {\n    colorMaxMinBuffer.bind({target: GL.UNIFORM_BUFFER, index: COLOR_DATA_UBO_INDEX});\n    elevationMaxMinBuffer.bind({target: GL.UNIFORM_BUFFER, index: ELEVATION_DATA_UBO_INDEX});\n  }\n\n  unbindUniformBuffers(colorMaxMinBuffer, elevationMaxMinBuffer) {\n    colorMaxMinBuffer.unbind({target: GL.UNIFORM_BUFFER, index: COLOR_DATA_UBO_INDEX});\n    elevationMaxMinBuffer.unbind({target: GL.UNIFORM_BUFFER, index: ELEVATION_DATA_UBO_INDEX});\n  }\n\n  getDomainUniforms() {\n    const {colorDomain, elevationDomain} = this.props;\n    const domainUniforms: Record<string, any> = {};\n    if (colorDomain !== null) {\n      domainUniforms.colorDomainValid = true;\n      domainUniforms.colorDomain = colorDomain;\n    } else {\n      domainUniforms.colorDomainValid = false;\n    }\n    if (elevationDomain !== null) {\n      domainUniforms.elevationDomainValid = true;\n      domainUniforms.elevationDomain = elevationDomain;\n    } else {\n      domainUniforms.elevationDomainValid = false;\n    }\n    return domainUniforms;\n  }\n\n  private _setupUniformBuffer(model: Model): void {\n    const gl = this.context.gl as WebGL2RenderingContext;\n    const programHandle = model.program.handle;\n\n    const colorIndex = gl.getUniformBlockIndex(programHandle, 'ColorData');\n    const elevationIndex = gl.getUniformBlockIndex(programHandle, 'ElevationData');\n    gl.uniformBlockBinding(programHandle, colorIndex, COLOR_DATA_UBO_INDEX);\n    gl.uniformBlockBinding(programHandle, elevationIndex, ELEVATION_DATA_UBO_INDEX);\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n// Inspired by screen-grid-layer vertex shader in deck.gl\n\nexport default `\\\n#version 300 es\n#define SHADER_NAME gpu-grid-cell-layer-vertex-shader\n#define RANGE_COUNT 6\n\nin vec3 positions;\nin vec3 normals;\n\nin vec4 colors;\nin vec4 elevations;\nin vec3 instancePickingColors;\n\n// Custom uniforms\nuniform vec2 offset;\nuniform bool extruded;\nuniform float cellSize;\nuniform float coverage;\nuniform float opacity;\nuniform float elevationScale;\n\nuniform ivec2 gridSize;\nuniform vec2 gridOrigin;\nuniform vec2 gridOriginLow;\nuniform vec2 gridOffset;\nuniform vec2 gridOffsetLow;\nuniform vec4 colorRange[RANGE_COUNT];\nuniform vec2 elevationRange;\n\n// Domain uniforms\nuniform vec2 colorDomain;\nuniform bool colorDomainValid;\nuniform vec2 elevationDomain;\nuniform bool elevationDomainValid;\n\nlayout(std140) uniform;\nuniform ColorData\n{\n  vec4 maxMinCount;\n} colorData;\nuniform ElevationData\n{\n  vec4 maxMinCount;\n} elevationData;\n\n#define EPSILON 0.00001\n\n// Result\nout vec4 vColor;\n\nvec4 quantizeScale(vec2 domain, vec4 range[RANGE_COUNT], float value) {\n  vec4 outColor = vec4(0., 0., 0., 0.);\n  if (value >= (domain.x - EPSILON) && value <= (domain.y + EPSILON)) {\n    float domainRange = domain.y - domain.x;\n    if (domainRange <= 0.) {\n      outColor = colorRange[0];\n    } else {\n      float rangeCount = float(RANGE_COUNT);\n      float rangeStep = domainRange / rangeCount;\n      float idx = floor((value - domain.x) / rangeStep);\n      idx = clamp(idx, 0., rangeCount - 1.);\n      int intIdx = int(idx);\n      outColor = colorRange[intIdx];\n    }\n  }\n  return outColor;\n}\n\nfloat linearScale(vec2 domain, vec2 range, float value) {\n  if (value >= (domain.x - EPSILON) && value <= (domain.y + EPSILON)) {\n    return ((value - domain.x) / (domain.y - domain.x)) * (range.y - range.x) + range.x;\n  }\n  return -1.;\n}\n\nvoid main(void) {\n  vec2 clrDomain = colorDomainValid ? colorDomain : vec2(colorData.maxMinCount.a, colorData.maxMinCount.r);\n  vec4 color = quantizeScale(clrDomain, colorRange, colors.r);\n\n  float elevation = 0.0;\n\n  if (extruded) {\n    vec2 elvDomain = elevationDomainValid ? elevationDomain : vec2(elevationData.maxMinCount.a, elevationData.maxMinCount.r);\n    elevation = linearScale(elvDomain, elevationRange, elevations.r);\n    elevation = elevation  * (positions.z + 1.0) / 2.0 * elevationScale;\n  }\n\n  // if aggregated color or elevation is 0 do not render\n  float shouldRender = float(color.r > 0.0 && elevations.r >= 0.0);\n  float dotRadius = cellSize / 2. * coverage * shouldRender;\n\n  int yIndex = (gl_InstanceID / gridSize[0]);\n  int xIndex = gl_InstanceID - (yIndex * gridSize[0]);\n\n  vec2 instancePositionXFP64 = mul_fp64(vec2(gridOffset[0], gridOffsetLow[0]), vec2(float(xIndex), 0.));\n  instancePositionXFP64 = sum_fp64(instancePositionXFP64, vec2(gridOrigin[0], gridOriginLow[0]));\n  vec2 instancePositionYFP64 = mul_fp64(vec2(gridOffset[1], gridOffsetLow[1]), vec2(float(yIndex), 0.));\n  instancePositionYFP64 = sum_fp64(instancePositionYFP64, vec2(gridOrigin[1], gridOriginLow[1]));\n\n  vec3 centroidPosition = vec3(instancePositionXFP64[0], instancePositionYFP64[0], elevation);\n  vec3 centroidPosition64Low = vec3(instancePositionXFP64[1], instancePositionYFP64[1], 0.0);\n  geometry.worldPosition = centroidPosition;\n  vec3 pos = vec3(project_size(positions.xy + offset) * dotRadius, 0.);\n\n  // Set color to be rendered to picking fbo (also used to check for selection highlight).\n  picking_setPickingColor(instancePickingColors);\n\n  gl_Position = project_position_to_clipspace(centroidPosition, centroidPosition64Low, pos, geometry.position);\n\n  // Light calculations\n  // Worldspace is the linear space after Mercator projection\n\n  vec3 normals_commonspace = project_normal(normals);\n\n   if (extruded) {\n    vec3 lightColor = lighting_getLightColor(color.rgb, project_uCameraPosition, geometry.position.xyz, normals_commonspace);\n    vColor = vec4(lightColor, color.a * opacity) / 255.;\n  } else {\n    vColor = vec4(color.rgb, color.a * opacity) / 255.;\n  }\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#version 300 es\n#define SHADER_NAME gpu-grid-cell-layer-fragment-shader\n\nprecision highp float;\n\nin vec4 vColor;\n\nout vec4 fragColor;\n\nvoid main(void) {\n  fragColor = vColor;\n  fragColor = picking_filterColor(fragColor);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport {Buffer} from '@luma.gl/core';\nimport GL from '@luma.gl/constants';\nimport {\n  Accessor,\n  AccessorFunction,\n  Color,\n  Material,\n  GetPickingInfoParams,\n  LayerContext,\n  log,\n  PickingInfo,\n  Position,\n  DefaultProps\n} from '@deck.gl/core';\n\nimport GPUGridAggregator from '../utils/gpu-grid-aggregation/gpu-grid-aggregator';\nimport {AGGREGATION_OPERATION} from '../utils/aggregation-operation-utils';\nimport {defaultColorRange, colorRangeToFlatArray} from '../utils/color-utils';\nimport GPUGridCellLayer from './gpu-grid-cell-layer';\nimport {pointToDensityGridDataCPU} from './../cpu-grid-layer/grid-aggregator';\nimport GridAggregationLayer, {GridAggregationLayerProps} from '../grid-aggregation-layer';\nimport {getBoundingBox, getGridParams} from '../utils/grid-aggregation-utils';\n\nconst defaultProps: DefaultProps<GPUGridLayerProps> = {\n  // color\n  colorDomain: null,\n  colorRange: defaultColorRange,\n  getColorWeight: {type: 'accessor', value: 1},\n  colorAggregation: 'SUM',\n\n  // elevation\n  elevationDomain: null,\n  elevationRange: [0, 1000],\n  getElevationWeight: {type: 'accessor', value: 1},\n  elevationAggregation: 'SUM',\n  elevationScale: {type: 'number', min: 0, value: 1},\n\n  // grid\n  cellSize: {type: 'number', min: 1, max: 1000, value: 1000},\n  coverage: {type: 'number', min: 0, max: 1, value: 1},\n  getPosition: {type: 'accessor', value: x => x.position},\n  extruded: false,\n\n  // Optional material for 'lighting' shader module\n  material: true\n};\n\n// This layer only perform GPU aggregation, no need to seperate data and weight props\n// aggregation will be dirty when any of the props are changed.\n\nconst DIMENSIONS = {\n  data: {\n    props: ['cellSize', 'colorAggregation', 'elevationAggregation']\n  }\n  // rest of the changes are detected by `state.attributesChanged`\n};\nconst POSITION_ATTRIBUTE_NAME = 'positions';\n\n/** All properties supported by GPUGridLayer. */\nexport type GPUGridLayerProps<DataT = any> = _GPUGridLayerProps<DataT> &\n  GridAggregationLayerProps<DataT>;\n\n/** Properties added by GPUGridLayer. */\nexport type _GPUGridLayerProps<DataT> = {\n  /**\n   * Size of each cell in meters.\n   * @default 1000\n   */\n  cellSize?: number;\n\n  /**\n   * Color scale domain, default is set to the extent of aggregated weights in each cell.\n   * @default [min(colorWeight), max(colorWeight)]\n   */\n  colorDomain?: [number, number] | null;\n\n  /**\n   * Default: [colorbrewer](http://colorbrewer2.org/#type=sequential&scheme=YlOrRd&n=6) `6-class YlOrRd`\n   */\n  colorRange?: Color[];\n\n  /**\n   * Cell size multiplier, clamped between 0 - 1.\n   * @default 1\n   */\n  coverage?: number;\n\n  /**\n   * Elevation scale input domain, default is set to between 0 and the max of aggregated weights in each cell.\n   * @default [0, max(elevationWeight)]\n   */\n  elevationDomain?: [number, number] | null;\n\n  /**\n   * Elevation scale output range.\n   * @default [0, 1000]\n   */\n  elevationRange?: [number, number];\n\n  /**\n   * Cell elevation multiplier.\n   * @default 1\n   */\n  elevationScale?: number;\n\n  /**\n   * Whether to enable cell elevation. If set to false, all cell will be flat.\n   * @default true\n   */\n  extruded?: boolean;\n\n  /**\n   * Material settings for lighting effect. Applies if `extruded: true`.\n   *\n   * @default true\n   * @see https://deck.gl/docs/developer-guide/using-lighting\n   */\n  material?: Material;\n\n  /**\n   * Defines the operation used to aggregate all data object weights to calculate a cell's color value.\n   * @default 'SUM'\n   */\n  colorAggregation?: 'SUM' | 'MEAN' | 'MIN' | 'MAX';\n\n  /**\n   * Defines the operation used to aggregate all data object weights to calculate a cell's elevation value.\n   * @default 'SUM'\n   */\n  elevationAggregation?: 'SUM' | 'MEAN' | 'MIN' | 'MAX';\n\n  /**\n   * Method called to retrieve the position of each object.\n   * @default object => object.position\n   */\n  getPosition?: AccessorFunction<DataT, Position>;\n\n  /**\n   * The weight of a data object used to calculate the color value for a cell.\n   * @default 1\n   */\n  getColorWeight?: Accessor<DataT, number>;\n\n  /**\n   * The weight of a data object used to calculate the elevation value for a cell.\n   * @default 1\n   */\n  getElevationWeight?: Accessor<DataT, number>;\n};\n\n/** Aggregate data into a grid-based heatmap. Aggregation is performed on GPU (WebGL2 only). */\nexport default class GPUGridLayer<DataT = any, ExtraPropsT = {}> extends GridAggregationLayer<\n  ExtraPropsT & Required<_GPUGridLayerProps<DataT>>\n> {\n  static layerName = 'GPUGridLayer';\n  static defaultProps = defaultProps;\n\n  initializeState({gl}: LayerContext): void {\n    const isSupported = GPUGridAggregator.isSupported(gl);\n    if (!isSupported) {\n      log.error('GPUGridLayer is not supported on this browser, use GridLayer instead')();\n    }\n    super.initializeAggregationLayer({\n      dimensions: DIMENSIONS\n    });\n    this.setState({\n      gpuAggregation: true,\n      projectPoints: false, // aggregation in world space\n      isSupported,\n      weights: {\n        color: {\n          needMin: true,\n          needMax: true,\n          combineMaxMin: true,\n          maxMinBuffer: new Buffer(gl, {\n            byteLength: 4 * 4,\n            accessor: {size: 4, type: GL.FLOAT, divisor: 1}\n          })\n        },\n        elevation: {\n          needMin: true,\n          needMax: true,\n          combineMaxMin: true,\n          maxMinBuffer: new Buffer(gl, {\n            byteLength: 4 * 4,\n            accessor: {size: 4, type: GL.FLOAT, divisor: 1}\n          })\n        }\n      },\n      positionAttributeName: 'positions'\n    });\n    const attributeManager = this.getAttributeManager()!;\n    attributeManager.add({\n      [POSITION_ATTRIBUTE_NAME]: {\n        size: 3,\n        accessor: 'getPosition',\n        type: GL.DOUBLE,\n        fp64: this.use64bitPositions()\n      },\n      color: {size: 3, accessor: 'getColorWeight'},\n      elevation: {size: 3, accessor: 'getElevationWeight'}\n    });\n  }\n\n  updateState(opts) {\n    if (this.state.isSupported === false) {\n      // Skip update, layer not supported\n      return;\n    }\n    super.updateState(opts);\n    const {aggregationDirty} = this.state;\n    if (aggregationDirty) {\n      // reset cached CPU Aggregation results (used for picking)\n      this.setState({\n        gridHash: null\n      });\n    }\n  }\n\n  getHashKeyForIndex(index: number): string {\n    const {numRow, numCol, boundingBox, gridOffset} = this.state;\n    const gridSize = [numCol, numRow];\n    const gridOrigin = [boundingBox.xMin, boundingBox.yMin];\n    const cellSize = [gridOffset.xOffset, gridOffset.yOffset];\n\n    const yIndex = Math.floor(index / gridSize[0]);\n    const xIndex = index - yIndex * gridSize[0];\n    // This will match the index to the hash-key to access aggregation data from CPU aggregation results.\n    const latIdx = Math.floor(\n      (yIndex * cellSize[1] + gridOrigin[1] + 90 + cellSize[1] / 2) / cellSize[1]\n    );\n    const lonIdx = Math.floor(\n      (xIndex * cellSize[0] + gridOrigin[0] + 180 + cellSize[0] / 2) / cellSize[0]\n    );\n    return `${latIdx}-${lonIdx}`;\n  }\n\n  getPositionForIndex(index: number): Position {\n    const {numRow, numCol, boundingBox, gridOffset} = this.state;\n    const gridSize = [numCol, numRow];\n    const gridOrigin = [boundingBox.xMin, boundingBox.yMin];\n    const cellSize = [gridOffset.xOffset, gridOffset.yOffset];\n\n    const yIndex = Math.floor(index / gridSize[0]);\n    const xIndex = index - yIndex * gridSize[0];\n    const yPos = yIndex * cellSize[1] + gridOrigin[1];\n    const xPos = xIndex * cellSize[0] + gridOrigin[0];\n    return [xPos, yPos];\n  }\n\n  getPickingInfo({info, mode}: GetPickingInfoParams): PickingInfo {\n    const {index} = info;\n    let object: any = null;\n    if (index >= 0) {\n      const {gpuGridAggregator} = this.state;\n      const position = this.getPositionForIndex(index);\n      const colorInfo = GPUGridAggregator.getAggregationData({\n        pixelIndex: index,\n        ...gpuGridAggregator.getData('color')\n      });\n      const elevationInfo = GPUGridAggregator.getAggregationData({\n        pixelIndex: index,\n        ...gpuGridAggregator.getData('elevation')\n      });\n\n      object = {\n        colorValue: colorInfo.cellWeight,\n        elevationValue: elevationInfo.cellWeight,\n        count: colorInfo.cellCount || elevationInfo.cellCount,\n        position,\n        totalCount: colorInfo.totalCount || elevationInfo.totalCount\n      };\n      if (mode !== 'hover') {\n        // perform CPU aggregation for full list of points for each cell\n        const {props} = this;\n        let {gridHash} = this.state;\n        if (!gridHash) {\n          const {gridOffset, translation, boundingBox} = this.state;\n          const {viewport} = this.context;\n          const attributes = this.getAttributes();\n          const cpuAggregation = pointToDensityGridDataCPU(props as any, {\n            gridOffset,\n            attributes,\n            viewport,\n            translation,\n            boundingBox\n          });\n          gridHash = cpuAggregation.gridHash;\n          this.setState({gridHash});\n        }\n        const key = this.getHashKeyForIndex(index);\n        const cpuAggregationData = gridHash[key];\n        Object.assign(object, cpuAggregationData);\n      }\n    }\n\n    // override object with picked cell\n    info.picked = Boolean(object);\n    info.object = object;\n\n    return info;\n  }\n\n  renderLayers() {\n    if (!this.state.isSupported) {\n      return null;\n    }\n    const {\n      elevationScale,\n      extruded,\n      cellSize: cellSizeMeters,\n      coverage,\n      material,\n      elevationRange,\n      colorDomain,\n      elevationDomain\n    } = this.props;\n\n    const {weights, numRow, numCol, gridOrigin, gridOffset} = this.state;\n    const {color, elevation} = weights;\n    const colorRange = colorRangeToFlatArray(this.props.colorRange);\n\n    const SubLayerClass = this.getSubLayerClass('gpu-grid-cell', GPUGridCellLayer);\n\n    return new SubLayerClass(\n      {\n        gridSize: [numCol, numRow],\n        gridOrigin,\n        gridOffset: [gridOffset.xOffset, gridOffset.yOffset],\n        colorRange,\n        elevationRange,\n        colorDomain,\n        elevationDomain,\n\n        cellSize: cellSizeMeters,\n        coverage,\n        material,\n        elevationScale,\n        extruded\n      },\n      this.getSubLayerProps({\n        id: 'gpu-grid-cell'\n      }),\n      {\n        data: {\n          attributes: {\n            colors: color.aggregationBuffer,\n            elevations: elevation.aggregationBuffer\n          }\n        },\n        colorMaxMinBuffer: color.maxMinBuffer,\n        elevationMaxMinBuffer: elevation.maxMinBuffer,\n        numInstances: numCol * numRow\n      }\n    );\n  }\n\n  finalizeState(context: LayerContext) {\n    const {color, elevation} = this.state.weights;\n    [color, elevation].forEach(weight => {\n      const {aggregationBuffer, maxMinBuffer} = weight;\n      maxMinBuffer.delete();\n      aggregationBuffer?.delete();\n    });\n    super.finalizeState(context);\n  }\n\n  // Aggregation Overrides\n\n  updateAggregationState(opts) {\n    const {props, oldProps} = opts;\n    const {cellSize, coordinateSystem} = props;\n    const {viewport} = this.context;\n    const cellSizeChanged = oldProps.cellSize !== cellSize;\n    const {dimensions} = this.state;\n\n    const positionsChanged = this.isAttributeChanged(POSITION_ATTRIBUTE_NAME);\n    // any attribute changed\n    const attributesChanged = positionsChanged || this.isAttributeChanged();\n\n    let {boundingBox} = this.state;\n    if (positionsChanged) {\n      boundingBox = getBoundingBox(this.getAttributes(), this.getNumInstances());\n      this.setState({boundingBox});\n    }\n    if (positionsChanged || cellSizeChanged) {\n      const {gridOffset, translation, width, height, numCol, numRow} = getGridParams(\n        boundingBox,\n        cellSize,\n        viewport,\n        coordinateSystem\n      );\n      this.allocateResources(numRow, numCol);\n      this.setState({\n        gridOffset,\n        translation,\n        gridOrigin: [-1 * translation[0], -1 * translation[1]],\n        width,\n        height,\n        numCol,\n        numRow\n      });\n    }\n\n    const aggregationDataDirty =\n      attributesChanged ||\n      this.isAggregationDirty(opts, {\n        dimension: dimensions.data,\n        compareAll: true\n      });\n\n    if (aggregationDataDirty) {\n      this._updateAccessors(opts);\n    }\n    this.setState({\n      aggregationDataDirty\n    });\n  }\n\n  // Private\n\n  _updateAccessors(opts) {\n    const {colorAggregation, elevationAggregation} = opts.props;\n    const {color, elevation} = this.state.weights;\n    color.operation = AGGREGATION_OPERATION[colorAggregation];\n    elevation.operation = AGGREGATION_OPERATION[elevationAggregation];\n  }\n}\n","import {\n  CompositeLayer,\n  CompositeLayerProps,\n  Layer,\n  UpdateParameters,\n  DefaultProps\n} from '@deck.gl/core';\nimport GPUGridAggregator from '../utils/gpu-grid-aggregation/gpu-grid-aggregator';\nimport GPUGridLayer, {_GPUGridLayerProps} from '../gpu-grid-layer/gpu-grid-layer';\nimport CPUGridLayer, {_CPUGridLayerProps} from '../cpu-grid-layer/cpu-grid-layer';\n\nconst defaultProps: DefaultProps<GridLayerProps> = {\n  ...GPUGridLayer.defaultProps,\n  ...CPUGridLayer.defaultProps,\n  gpuAggregation: false\n};\n\n/** All properties supported by GridLayer. */\nexport type GridLayerProps<DataT = any> = _GridLayerProps<DataT> & CompositeLayerProps<DataT>;\n\n/** Properties added by GridLayer. */\ntype _GridLayerProps<DataT> = _CPUGridLayerProps<DataT> &\n  _GPUGridLayerProps<DataT> & {\n    /**\n     * Whether the aggregation should be performed in high-precision 64-bit mode.\n     * @default false\n     */\n    fp64?: boolean;\n\n    /**\n     * When set to true, aggregation is performed on GPU, provided other conditions are met.\n     * @default false\n     */\n    gpuAggregation?: boolean;\n  };\n\n/** Aggregate data into a grid-based heatmap. The color and height of a cell are determined based on the objects it contains. */\nexport default class GridLayer<DataT = any, ExtraPropsT = {}> extends CompositeLayer<\n  ExtraPropsT & Required<_GridLayerProps<DataT>>\n> {\n  static layerName = 'GridLayer';\n  static defaultProps = defaultProps;\n\n  state!: CompositeLayer['state'] & {\n    useGPUAggregation: boolean;\n  };\n\n  initializeState() {\n    this.state = {\n      useGPUAggregation: true\n    };\n  }\n\n  updateState({props}: UpdateParameters<this>) {\n    this.setState({\n      useGPUAggregation: this.canUseGPUAggregation(props)\n    });\n  }\n\n  renderLayers(): Layer {\n    const {data, updateTriggers} = this.props;\n    const id = this.state.useGPUAggregation ? 'GPU' : 'CPU';\n    const LayerType = this.state.useGPUAggregation\n      ? this.getSubLayerClass('GPU', GPUGridLayer)\n      : this.getSubLayerClass('CPU', CPUGridLayer);\n    return new LayerType(\n      this.props,\n      this.getSubLayerProps({\n        id,\n        updateTriggers\n      }),\n      {\n        data\n      }\n    );\n  }\n\n  // Private methods\n\n  canUseGPUAggregation(props: GridLayer['props']) {\n    const {\n      gpuAggregation,\n      lowerPercentile,\n      upperPercentile,\n      getColorValue,\n      getElevationValue,\n      colorScaleType\n    } = props;\n    if (!gpuAggregation) {\n      // cpu aggregation is requested\n      return false;\n    }\n    if (!GPUGridAggregator.isSupported(this.context.gl)) {\n      return false;\n    }\n    if (lowerPercentile !== 0 || upperPercentile !== 100) {\n      // percentile calculations requires sorting not supported on GPU\n      return false;\n    }\n    if (getColorValue !== null || getElevationValue !== null) {\n      // accessor for custom color or elevation calculation is specified\n      return false;\n    }\n    if (colorScaleType === 'quantile' || colorScaleType === 'ordinal') {\n      // quantile and ordinal scales are not supported on GPU\n      return false;\n    }\n    return true;\n  }\n}\n","import GL from '@luma.gl/constants';\nimport {isWebGL2} from '@luma.gl/core';\n\nexport function getBounds(points: number[][]): number[] {\n  // Now build bounding box in world space (aligned to world coordiante system)\n  const x = points.map(p => p[0]);\n  const y = points.map(p => p[1]);\n\n  const xMin = Math.min.apply(null, x);\n  const xMax = Math.max.apply(null, x);\n  const yMin = Math.min.apply(null, y);\n  const yMax = Math.max.apply(null, y);\n\n  return [xMin, yMin, xMax, yMax];\n}\n\n// true if currentBounds contains targetBounds, false otherwise\nexport function boundsContain(currentBounds: number[], targetBounds: number[]): boolean {\n  if (\n    targetBounds[0] >= currentBounds[0] &&\n    targetBounds[2] <= currentBounds[2] &&\n    targetBounds[1] >= currentBounds[1] &&\n    targetBounds[3] <= currentBounds[3]\n  ) {\n    return true;\n  }\n  return false;\n}\n\nconst scratchArray = new Float32Array(12);\n\n// For given rectangle bounds generates two triangles vertices that coverit completely\nexport function packVertices(points: number[][], dimensions: number = 2): Float32Array {\n  let index = 0;\n  for (const point of points) {\n    for (let i = 0; i < dimensions; i++) {\n      scratchArray[index++] = point[i] || 0;\n    }\n  }\n  return scratchArray;\n}\n\n// Expands boundingBox:[xMin, yMin, xMax, yMax] to match aspect ratio of given width and height\nexport function scaleToAspectRatio(boundingBox: number[], width: number, height: number): number[] {\n  const [xMin, yMin, xMax, yMax] = boundingBox;\n\n  const currentWidth = xMax - xMin;\n  const currentHeight = yMax - yMin;\n\n  let newWidth = currentWidth;\n  let newHeight = currentHeight;\n  if (currentWidth / currentHeight < width / height) {\n    // expand bounding box width\n    newWidth = (width / height) * currentHeight;\n  } else {\n    newHeight = (height / width) * currentWidth;\n  }\n\n  if (newWidth < width) {\n    newWidth = width;\n    newHeight = height;\n  }\n\n  const xCenter = (xMax + xMin) / 2;\n  const yCenter = (yMax + yMin) / 2;\n\n  return [\n    xCenter - newWidth / 2,\n    yCenter - newHeight / 2,\n    xCenter + newWidth / 2,\n    yCenter + newHeight / 2\n  ];\n}\n\n// Get texture coordiante of point inside a bounding box\nexport function getTextureCoordinates(point: number[], bounds: number[]) {\n  const [xMin, yMin, xMax, yMax] = bounds;\n  return [(point[0] - xMin) / (xMax - xMin), (point[1] - yMin) / (yMax - yMin)];\n}\n\n// Returns format and type for creating texture objects\nexport function getTextureParams({gl, floatTargetSupport}) {\n  return floatTargetSupport\n    ? {\n        // format:  should be RGBA32F on WebGL2 (float textures), RGBA in WebGL1 for float or non float textures\n        format: isWebGL2(gl) ? GL.RGBA32F : GL.RGBA,\n        type: GL.FLOAT\n      }\n    : {\n        format: GL.RGBA,\n        type: GL.UNSIGNED_BYTE\n      };\n}\n","// Copyright (c) 2015 - 2019 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nimport GL from '@luma.gl/constants';\nimport {Model, Geometry, Texture2D} from '@luma.gl/core';\nimport {Layer, LayerContext, project32} from '@deck.gl/core';\nimport vs from './triangle-layer-vertex.glsl';\nimport fs from './triangle-layer-fragment.glsl';\n\ntype _TriangleLayerProps = {\n  colorDomain: number[];\n  aggregationMode: string;\n  threshold: number;\n  intensity: number;\n  vertexCount: number;\n  colorTexture: Texture2D;\n  maxTexture: Texture2D;\n  texture: Texture2D;\n};\n\nexport default class TriangleLayer extends Layer<_TriangleLayerProps> {\n  static layerName = 'TriangleLayer';\n\n  getShaders() {\n    return {vs, fs, modules: [project32]};\n  }\n\n  initializeState({gl}: LayerContext): void {\n    const attributeManager = this.getAttributeManager()!;\n    attributeManager.add({\n      positions: {size: 3, noAlloc: true},\n      texCoords: {size: 2, noAlloc: true}\n    });\n    this.setState({\n      model: this._getModel(gl)\n    });\n  }\n\n  _getModel(gl: WebGLRenderingContext): Model {\n    const {vertexCount} = this.props;\n\n    return new Model(gl, {\n      ...this.getShaders(),\n      id: this.props.id,\n      geometry: new Geometry({\n        drawMode: GL.TRIANGLE_FAN,\n        vertexCount\n      })\n    });\n  }\n\n  draw({uniforms}): void {\n    const {model} = this.state;\n\n    const {texture, maxTexture, colorTexture, intensity, threshold, aggregationMode, colorDomain} =\n      this.props;\n\n    model\n      .setUniforms({\n        ...uniforms,\n        texture,\n        maxTexture,\n        colorTexture,\n        intensity,\n        threshold,\n        aggregationMode,\n        colorDomain\n      })\n      .draw();\n  }\n}\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n// Inspired by screen-grid-layer vertex shader in deck.gl\n\nexport default `\\\n#define SHADER_NAME heatp-map-layer-vertex-shader\n\nuniform sampler2D maxTexture;\nuniform float intensity;\nuniform vec2 colorDomain;\nuniform float threshold;\nuniform float aggregationMode;\n\nattribute vec3 positions;\nattribute vec2 texCoords;\n\nvarying vec2 vTexCoords;\nvarying float vIntensityMin;\nvarying float vIntensityMax;\n\nvoid main(void) {\n  gl_Position = project_position_to_clipspace(positions, vec3(0.0), vec3(0.0));\n  vTexCoords = texCoords;\n  vec4 maxTexture = texture2D(maxTexture, vec2(0.5));\n  float maxValue = aggregationMode < 0.5 ? maxTexture.r : maxTexture.g;\n  float minValue = maxValue * threshold;\n  if (colorDomain[1] > 0.) {\n    // if user specified custom domain use it.\n    maxValue = colorDomain[1];\n    minValue = colorDomain[0];\n  }\n  vIntensityMax = intensity / maxValue;\n  vIntensityMin = intensity / minValue;\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\nexport default `\\\n#define SHADER_NAME triangle-layer-fragment-shader\n\nprecision highp float;\n\nuniform float opacity;\nuniform sampler2D texture;\nuniform sampler2D colorTexture;\nuniform float aggregationMode;\n\nvarying vec2 vTexCoords;\nvarying float vIntensityMin;\nvarying float vIntensityMax;\n\nvec4 getLinearColor(float value) {\n  float factor = clamp(value * vIntensityMax, 0., 1.);\n  vec4 color = texture2D(colorTexture, vec2(factor, 0.5));\n  color.a *= min(value * vIntensityMin, 1.0);\n  return color;\n}\n\nvoid main(void) {\n  vec4 weights = texture2D(texture, vTexCoords);\n  float weight = weights.r;\n\n  if (aggregationMode > 0.5) {\n    weight /= max(1.0, weights.a);\n  }\n\n  // discard pixels with 0 weight.\n  if (weight <= 0.) {\n     discard;\n  }\n\n  vec4 linearColor = getLinearColor(weight);\n  linearColor.a *= opacity;\n  gl_FragColor =linearColor;\n}\n`;\n","export default `\\\nattribute vec3 positions;\nattribute vec3 positions64Low;\nattribute float weights;\nvarying vec4 weightsTexture;\nuniform float radiusPixels;\nuniform float textureWidth;\nuniform vec4 commonBounds;\nuniform float weightsScale;\nvoid main()\n{\n  weightsTexture = vec4(weights * weightsScale, 0., 0., 1.);\n\n  float radiusTexels  = project_pixel_size(radiusPixels) * textureWidth / (commonBounds.z - commonBounds.x);\n  gl_PointSize = radiusTexels * 2.;\n\n  vec3 commonPosition = project_position(positions, positions64Low);\n\n  // map xy from commonBounds to [-1, 1]\n  gl_Position.xy = (commonPosition.xy - commonBounds.xy) / (commonBounds.zw - commonBounds.xy) ;\n  gl_Position.xy = (gl_Position.xy * 2.) - (1.);\n}\n`;\n","// Copyright (c) 2015 - 2019 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n\n/* global setTimeout clearTimeout */\nimport GL from '@luma.gl/constants';\nimport {\n  getBounds,\n  boundsContain,\n  packVertices,\n  scaleToAspectRatio,\n  getTextureCoordinates,\n  getTextureParams\n} from './heatmap-layer-utils';\nimport {\n  Buffer,\n  Texture2D,\n  Transform,\n  getParameters,\n  withParameters,\n  FEATURES,\n  hasFeatures\n} from '@luma.gl/core';\nimport {\n  Accessor,\n  AccessorFunction,\n  AttributeManager,\n  ChangeFlags,\n  Color,\n  COORDINATE_SYSTEM,\n  Layer,\n  LayerContext,\n  LayersList,\n  log,\n  Position,\n  UpdateParameters,\n  DefaultProps\n} from '@deck.gl/core';\nimport TriangleLayer from './triangle-layer';\nimport AggregationLayer, {AggregationLayerProps} from '../aggregation-layer';\nimport {defaultColorRange, colorRangeToFlatArray} from '../utils/color-utils';\nimport weightsVs from './weights-vs.glsl';\nimport weightsFs from './weights-fs.glsl';\nimport vsMax from './max-vs.glsl';\nimport fsMax from './max-fs.glsl';\n\nconst RESOLUTION = 2; // (number of common space pixels) / (number texels)\nconst TEXTURE_OPTIONS = {\n  mipmaps: false,\n  parameters: {\n    [GL.TEXTURE_MAG_FILTER]: GL.LINEAR,\n    [GL.TEXTURE_MIN_FILTER]: GL.LINEAR,\n    [GL.TEXTURE_WRAP_S]: GL.CLAMP_TO_EDGE,\n    [GL.TEXTURE_WRAP_T]: GL.CLAMP_TO_EDGE\n  },\n  dataFormat: GL.RGBA\n};\nconst DEFAULT_COLOR_DOMAIN = [0, 0];\nconst AGGREGATION_MODE = {\n  SUM: 0,\n  MEAN: 1\n};\n\nconst defaultProps: DefaultProps<HeatmapLayerProps> = {\n  getPosition: {type: 'accessor', value: x => x.position},\n  getWeight: {type: 'accessor', value: 1},\n  intensity: {type: 'number', min: 0, value: 1},\n  radiusPixels: {type: 'number', min: 1, max: 100, value: 50},\n  colorRange: defaultColorRange,\n  threshold: {type: 'number', min: 0, max: 1, value: 0.05},\n  colorDomain: {type: 'array', value: null, optional: true},\n  // 'SUM' or 'MEAN'\n  aggregation: 'SUM',\n  weightsTextureSize: {type: 'number', min: 128, max: 2048, value: 2048},\n  debounceTimeout: {type: 'number', min: 0, max: 1000, value: 500}\n};\n\nconst REQUIRED_FEATURES = [\n  FEATURES.BLEND_EQUATION_MINMAX, // max weight calculation\n  FEATURES.TEXTURE_FLOAT // weight-map as texture\n];\n\nconst FLOAT_TARGET_FEATURES = [\n  FEATURES.COLOR_ATTACHMENT_RGBA32F, // ability to render to float texture\n  FEATURES.FLOAT_BLEND // ability to blend when rendering to float texture\n];\n\nconst DIMENSIONS = {\n  data: {\n    props: ['radiusPixels']\n  }\n};\n\nexport type HeatmapLayerProps<DataT = any> = _HeatmapLayerProps<DataT> &\n  AggregationLayerProps<DataT>;\n\ntype _HeatmapLayerProps<DataT> = {\n  /**\n   * Radius of the circle in pixels, to which the weight of an object is distributed.\n   *\n   * @default 30\n   */\n  radiusPixels?: number;\n\n  /**\n   * Specified as an array of colors [color1, color2, ...].\n   *\n   * @default `6-class YlOrRd` - [colorbrewer](http://colorbrewer2.org/#type=sequential&scheme=YlOrRd&n=6)\n   */\n  colorRange?: Color[];\n\n  /**\n   * Value that is multiplied with the total weight at a pixel to obtain the final weight.\n   *\n   * @default 1\n   */\n  intensity?: number;\n\n  /**\n   * Ratio of the fading weight to the max weight, between `0` and `1`.\n   *\n   * For example, `0.1` affects all pixels with weight under 10% of the max.\n   *\n   * Ignored when `colorDomain` is specified.\n   * @default 0.05\n   */\n  threshold?: number;\n\n  /**\n   * Controls how weight values are mapped to the `colorRange`, as an array of two numbers [`minValue`, `maxValue`].\n   *\n   * @default null\n   */\n  colorDomain?: [number, number] | null;\n\n  /**\n   * Defines the type of aggregation operation\n   *\n   * V valid values are 'SUM', 'MEAN'.\n   *\n   * @default 'SUM'\n   */\n  aggregation?: 'SUM' | 'MEAN';\n\n  /**\n   * Specifies the size of weight texture.\n   * @default 2048\n   */\n  weightsTextureSize?: number;\n\n  /**\n   * Interval in milliseconds during which changes to the viewport don't trigger aggregation.\n   *\n   * @default 500\n   */\n  debounceTimeout?: number;\n\n  /**\n   * Method called to retrieve the position of each object.\n   *\n   * @default d => d.position\n   */\n  getPosition?: AccessorFunction<DataT, Position>;\n\n  /**\n   * The weight of each object.\n   *\n   * @default 1\n   */\n  getWeight?: Accessor<DataT, number>;\n};\n\n/** Visualizes the spatial distribution of data. */\nexport default class HeatmapLayer<DataT = any, ExtraPropsT = {}> extends AggregationLayer<\n  ExtraPropsT & Required<_HeatmapLayerProps<DataT>>\n> {\n  static layerName = 'HeatmapLayer';\n  static defaultProps = defaultProps;\n\n  state!: AggregationLayer['state'] & {\n    supported: boolean;\n    colorDomain?: number[];\n    isWeightMapDirty?: boolean;\n    weightsTexture?: Texture2D;\n    zoom?: number;\n    worldBounds?: number[];\n    normalizedCommonBounds?: number[];\n    updateTimer?: any;\n    triPositionBuffer?: Buffer;\n    triTexCoordBuffer?: Buffer;\n  };\n\n  initializeState() {\n    const {gl} = this.context;\n    if (!hasFeatures(gl, REQUIRED_FEATURES)) {\n      this.setState({supported: false});\n      log.error(`HeatmapLayer: ${this.id} is not supported on this browser`)();\n      return;\n    }\n    super.initializeAggregationLayer(DIMENSIONS);\n    this.setState({supported: true, colorDomain: DEFAULT_COLOR_DOMAIN});\n    this._setupTextureParams();\n    this._setupAttributes();\n    this._setupResources();\n  }\n\n  shouldUpdateState({changeFlags}: UpdateParameters<this>) {\n    // Need to be updated when viewport changes\n    return changeFlags.somethingChanged;\n  }\n\n  /* eslint-disable max-statements,complexity */\n  updateState(opts: UpdateParameters<this>) {\n    if (!this.state.supported) {\n      return;\n    }\n    super.updateState(opts);\n    this._updateHeatmapState(opts);\n  }\n\n  _updateHeatmapState(opts: UpdateParameters<this>) {\n    const {props, oldProps} = opts;\n    const changeFlags = this._getChangeFlags(opts);\n\n    if (changeFlags.dataChanged || changeFlags.viewportChanged) {\n      // if data is changed, do not debounce and immediately update the weight map\n      changeFlags.boundsChanged = this._updateBounds(changeFlags.dataChanged);\n      this._updateTextureRenderingBounds();\n    }\n\n    if (changeFlags.dataChanged || changeFlags.boundsChanged) {\n      // Update weight map immediately\n      clearTimeout(this.state.updateTimer);\n      this.setState({isWeightMapDirty: true});\n    } else if (changeFlags.viewportZoomChanged) {\n      // Update weight map when zoom stops\n      this._debouncedUpdateWeightmap();\n    }\n\n    if (props.colorRange !== oldProps.colorRange) {\n      this._updateColorTexture(opts);\n    }\n\n    if (this.state.isWeightMapDirty) {\n      this._updateWeightmap();\n    }\n\n    this.setState({zoom: opts.context.viewport.zoom});\n  }\n\n  renderLayers(): LayersList | Layer {\n    if (!this.state.supported) {\n      return [];\n    }\n    const {\n      weightsTexture,\n      triPositionBuffer,\n      triTexCoordBuffer,\n      maxWeightsTexture,\n      colorTexture,\n      colorDomain\n    } = this.state;\n    const {updateTriggers, intensity, threshold, aggregation} = this.props;\n\n    const TriangleLayerClass = this.getSubLayerClass('triangle', TriangleLayer);\n\n    return new TriangleLayerClass(\n      this.getSubLayerProps({\n        id: 'triangle-layer',\n        updateTriggers\n      }),\n      {\n        // position buffer is filled with world coordinates generated from viewport.unproject\n        // i.e. LNGLAT if geospatial, CARTESIAN otherwise\n        coordinateSystem: COORDINATE_SYSTEM.DEFAULT,\n        data: {\n          attributes: {\n            positions: triPositionBuffer,\n            texCoords: triTexCoordBuffer\n          }\n        },\n        vertexCount: 4,\n        maxTexture: maxWeightsTexture,\n        colorTexture,\n        aggregationMode: AGGREGATION_MODE[aggregation] || 0,\n        texture: weightsTexture,\n        intensity,\n        threshold,\n        colorDomain\n      }\n    );\n  }\n\n  finalizeState(context: LayerContext) {\n    super.finalizeState(context);\n    const {\n      weightsTransform,\n      weightsTexture,\n      maxWeightTransform,\n      maxWeightsTexture,\n      triPositionBuffer,\n      triTexCoordBuffer,\n      colorTexture,\n      updateTimer\n    } = this.state;\n    weightsTransform?.delete();\n    weightsTexture?.delete();\n    maxWeightTransform?.delete();\n    maxWeightsTexture?.delete();\n    triPositionBuffer?.delete();\n    triTexCoordBuffer?.delete();\n    colorTexture?.delete();\n    if (updateTimer) {\n      clearTimeout(updateTimer);\n    }\n  }\n\n  // PRIVATE\n\n  // override Composite layer private method to create AttributeManager instance\n  _getAttributeManager() {\n    return new AttributeManager(this.context.gl, {\n      id: this.props.id,\n      stats: this.context.stats\n    });\n  }\n\n  _getChangeFlags(opts: UpdateParameters<this>) {\n    const changeFlags: Partial<ChangeFlags> & {\n      boundsChanged?: boolean;\n      viewportZoomChanged?: boolean;\n    } = {};\n    const {dimensions} = this.state;\n    changeFlags.dataChanged =\n      this.isAttributeChanged() || // if any attribute is changed\n      this.isAggregationDirty(opts, {\n        compareAll: true,\n        dimension: dimensions.data\n      });\n    changeFlags.viewportChanged = opts.changeFlags.viewportChanged;\n\n    const {zoom} = this.state;\n    if (!opts.context.viewport || opts.context.viewport.zoom !== zoom) {\n      changeFlags.viewportZoomChanged = true;\n    }\n\n    return changeFlags;\n  }\n\n  _createTextures() {\n    const {gl} = this.context;\n    const {textureSize, format, type} = this.state;\n\n    this.setState({\n      weightsTexture: new Texture2D(gl, {\n        width: textureSize,\n        height: textureSize,\n        format,\n        type,\n        ...TEXTURE_OPTIONS\n      }),\n      maxWeightsTexture: new Texture2D(gl, {format, type, ...TEXTURE_OPTIONS}) // 1 X 1 texture,\n    });\n  }\n\n  _setupAttributes() {\n    const attributeManager = this.getAttributeManager()!;\n    attributeManager.add({\n      positions: {size: 3, type: GL.DOUBLE, accessor: 'getPosition'},\n      weights: {size: 1, accessor: 'getWeight'}\n    });\n    this.setState({positionAttributeName: 'positions'});\n  }\n\n  _setupTextureParams() {\n    const {gl} = this.context;\n    const {weightsTextureSize} = this.props;\n\n    const textureSize = Math.min(weightsTextureSize, getParameters(gl, gl.MAX_TEXTURE_SIZE));\n    const floatTargetSupport = hasFeatures(gl, FLOAT_TARGET_FEATURES);\n    const {format, type} = getTextureParams({gl, floatTargetSupport});\n    const weightsScale = floatTargetSupport ? 1 : 1 / 255;\n    this.setState({textureSize, format, type, weightsScale});\n    if (!floatTargetSupport) {\n      log.warn(\n        `HeatmapLayer: ${this.id} rendering to float texture not supported, fallingback to low precession format`\n      )();\n    }\n  }\n\n  getShaders(type) {\n    return super.getShaders(\n      type === 'max-weights-transform'\n        ? {\n            vs: vsMax,\n            _fs: fsMax\n          }\n        : {\n            vs: weightsVs,\n            _fs: weightsFs\n          }\n    );\n  }\n\n  _createWeightsTransform(shaders = {}) {\n    const {gl} = this.context;\n    let {weightsTransform} = this.state;\n    const {weightsTexture} = this.state;\n    weightsTransform?.delete();\n\n    weightsTransform = new Transform(gl, {\n      id: `${this.id}-weights-transform`,\n      elementCount: 1,\n      _targetTexture: weightsTexture,\n      _targetTextureVarying: 'weightsTexture',\n      ...shaders\n    });\n    this.setState({weightsTransform});\n  }\n\n  _setupResources() {\n    const {gl} = this.context;\n    this._createTextures();\n    const {textureSize, weightsTexture, maxWeightsTexture} = this.state;\n\n    const weightsTransformShaders = this.getShaders('weights-transform');\n    this._createWeightsTransform(weightsTransformShaders);\n\n    const maxWeightsTransformShaders = this.getShaders('max-weights-transform');\n    const maxWeightTransform = new Transform(gl, {\n      id: `${this.id}-max-weights-transform`,\n      _sourceTextures: {\n        inTexture: weightsTexture\n      },\n      _targetTexture: maxWeightsTexture,\n      _targetTextureVarying: 'outTexture',\n      ...maxWeightsTransformShaders,\n      elementCount: textureSize * textureSize\n    });\n\n    this.setState({\n      weightsTexture,\n      maxWeightsTexture,\n      maxWeightTransform,\n      zoom: null,\n      triPositionBuffer: new Buffer(gl, {\n        byteLength: 48,\n        accessor: {size: 3}\n      }),\n      triTexCoordBuffer: new Buffer(gl, {\n        byteLength: 48,\n        accessor: {size: 2}\n      })\n    });\n  }\n\n  // overwrite super class method to update transform model\n  updateShaders(shaderOptions) {\n    // sahder params (modules, injects) changed, update model object\n    this._createWeightsTransform(shaderOptions);\n  }\n\n  _updateMaxWeightValue() {\n    const {maxWeightTransform} = this.state;\n    maxWeightTransform.run({\n      parameters: {\n        blend: true,\n        depthTest: false,\n        blendFunc: [GL.ONE, GL.ONE],\n        blendEquation: GL.MAX\n      }\n    });\n  }\n\n  // Computes world bounds area that needs to be processed for generate heatmap\n  _updateBounds(forceUpdate: any = false): boolean {\n    const {viewport} = this.context;\n\n    // Unproject all 4 corners of the current screen coordinates into world coordinates (lng/lat)\n    // Takes care of viewport has non zero bearing/pitch (i.e axis not aligned with world coordiante system)\n    const viewportCorners = [\n      viewport.unproject([0, 0]),\n      viewport.unproject([viewport.width, 0]),\n      viewport.unproject([viewport.width, viewport.height]),\n      viewport.unproject([0, viewport.height])\n    ].map(p => p.map(Math.fround));\n\n    // #1: get world bounds for current viewport extends\n    const visibleWorldBounds = getBounds(viewportCorners); // TODO: Change to visible bounds\n\n    const newState: Partial<HeatmapLayer['state']> = {visibleWorldBounds, viewportCorners};\n    let boundsChanged = false;\n\n    if (\n      forceUpdate ||\n      !this.state.worldBounds ||\n      !boundsContain(this.state.worldBounds, visibleWorldBounds)\n    ) {\n      // #2 : convert world bounds to common (Flat) bounds\n      // #3 : extend common bounds to match aspect ratio with viewport\n      const scaledCommonBounds = this._worldToCommonBounds(visibleWorldBounds);\n\n      // #4 :convert aligned common bounds to world bounds\n      const worldBounds = this._commonToWorldBounds(scaledCommonBounds);\n\n      // Clip webmercator projection limits\n      if (this.props.coordinateSystem === COORDINATE_SYSTEM.LNGLAT) {\n        worldBounds[1] = Math.max(worldBounds[1], -85.051129);\n        worldBounds[3] = Math.min(worldBounds[3], 85.051129);\n        worldBounds[0] = Math.max(worldBounds[0], -360);\n        worldBounds[2] = Math.min(worldBounds[2], 360);\n      }\n\n      // #5: now convert world bounds to common using Layer's coordiante system and origin\n      const normalizedCommonBounds = this._worldToCommonBounds(worldBounds);\n\n      newState.worldBounds = worldBounds;\n      newState.normalizedCommonBounds = normalizedCommonBounds;\n\n      boundsChanged = true;\n    }\n    this.setState(newState);\n    return boundsChanged;\n  }\n\n  _updateTextureRenderingBounds() {\n    // Just render visible portion of the texture\n    const {triPositionBuffer, triTexCoordBuffer, normalizedCommonBounds, viewportCorners} =\n      this.state;\n\n    const {viewport} = this.context;\n\n    triPositionBuffer.subData(packVertices(viewportCorners, 3));\n\n    const textureBounds = viewportCorners.map(p =>\n      getTextureCoordinates(viewport.projectPosition(p), normalizedCommonBounds!)\n    );\n    triTexCoordBuffer.subData(packVertices(textureBounds, 2));\n  }\n\n  _updateColorTexture(opts) {\n    const {colorRange} = opts.props;\n    let {colorTexture} = this.state;\n    const colors = colorRangeToFlatArray(colorRange, false, Uint8Array as any);\n\n    if (colorTexture) {\n      colorTexture.setImageData({\n        data: colors,\n        width: colorRange.length\n      });\n    } else {\n      colorTexture = new Texture2D(this.context.gl, {\n        data: colors,\n        width: colorRange.length,\n        height: 1,\n        ...TEXTURE_OPTIONS\n      });\n    }\n    this.setState({colorTexture});\n  }\n\n  _updateWeightmap() {\n    const {radiusPixels, colorDomain, aggregation} = this.props;\n    const {weightsTransform, worldBounds, textureSize, weightsTexture, weightsScale} = this.state;\n    this.state.isWeightMapDirty = false;\n\n    // convert world bounds to common using Layer's coordiante system and origin\n    const commonBounds = this._worldToCommonBounds(worldBounds, {\n      useLayerCoordinateSystem: true\n    });\n\n    if (colorDomain && aggregation === 'SUM') {\n      // scale color domain to weight per pixel\n      const {viewport} = this.context;\n      const metersPerPixel =\n        (viewport.distanceScales.metersPerUnit[2] * (commonBounds[2] - commonBounds[0])) /\n        textureSize;\n      this.state.colorDomain = colorDomain.map(x => x * metersPerPixel * weightsScale);\n    } else {\n      this.state.colorDomain = colorDomain || DEFAULT_COLOR_DOMAIN;\n    }\n\n    const uniforms = {\n      radiusPixels,\n      commonBounds,\n      textureWidth: textureSize,\n      weightsScale\n    };\n    // Attribute manager sets data array count as instaceCount on model\n    // we need to set that as elementCount on 'weightsTransform'\n    weightsTransform.update({\n      elementCount: this.getNumInstances()\n    });\n    // Need to explictly specify clearColor as external context may have modified it\n    withParameters(this.context.gl, {clearColor: [0, 0, 0, 0]}, () => {\n      weightsTransform.run({\n        uniforms,\n        parameters: {\n          blend: true,\n          depthTest: false,\n          blendFunc: [GL.ONE, GL.ONE],\n          blendEquation: GL.FUNC_ADD\n        },\n        clearRenderTarget: true,\n        attributes: this.getAttributes(),\n        moduleSettings: this.getModuleSettings()\n      });\n    });\n    this._updateMaxWeightValue();\n\n    // reset filtering parameters (TODO: remove once luma issue#1193 is fixed)\n    weightsTexture.setParameters({\n      [GL.TEXTURE_MAG_FILTER]: GL.LINEAR,\n      [GL.TEXTURE_MIN_FILTER]: GL.LINEAR\n    });\n  }\n\n  _debouncedUpdateWeightmap(fromTimer = false) {\n    let {updateTimer} = this.state;\n    const {debounceTimeout} = this.props;\n\n    if (fromTimer) {\n      updateTimer = null;\n      // update\n      this._updateBounds(true);\n      this._updateTextureRenderingBounds();\n      this.setState({isWeightMapDirty: true});\n    } else {\n      this.setState({isWeightMapDirty: false});\n      clearTimeout(updateTimer);\n      updateTimer = setTimeout(this._debouncedUpdateWeightmap.bind(this, true), debounceTimeout);\n    }\n\n    this.setState({updateTimer});\n  }\n\n  // input: worldBounds: [minLong, minLat, maxLong, maxLat]\n  // input: opts.useLayerCoordinateSystem : layers coordiante system is used\n  // optput: commonBounds: [minX, minY, maxX, maxY] scaled to fit the current texture\n  _worldToCommonBounds(worldBounds, opts: {useLayerCoordinateSystem?: boolean} = {}) {\n    const {useLayerCoordinateSystem = false} = opts;\n    const [minLong, minLat, maxLong, maxLat] = worldBounds;\n    const {viewport} = this.context;\n    const {textureSize} = this.state;\n    const {coordinateSystem} = this.props;\n\n    const offsetMode =\n      useLayerCoordinateSystem &&\n      (coordinateSystem === COORDINATE_SYSTEM.LNGLAT_OFFSETS ||\n        coordinateSystem === COORDINATE_SYSTEM.METER_OFFSETS);\n    const offsetOriginCommon = offsetMode\n      ? viewport.projectPosition(this.props.coordinateOrigin)\n      : [0, 0];\n    const size = (textureSize * RESOLUTION) / viewport.scale;\n\n    let bottomLeftCommon;\n    let topRightCommon;\n\n    // Y-axis is flipped between World and Common bounds\n    if (useLayerCoordinateSystem && !offsetMode) {\n      bottomLeftCommon = this.projectPosition([minLong, minLat, 0]);\n      topRightCommon = this.projectPosition([maxLong, maxLat, 0]);\n    } else {\n      bottomLeftCommon = viewport.projectPosition([minLong, minLat, 0]);\n      topRightCommon = viewport.projectPosition([maxLong, maxLat, 0]);\n    }\n    // Ignore z component\n    return scaleToAspectRatio(\n      [\n        bottomLeftCommon[0] - offsetOriginCommon[0],\n        bottomLeftCommon[1] - offsetOriginCommon[1],\n        topRightCommon[0] - offsetOriginCommon[0],\n        topRightCommon[1] - offsetOriginCommon[1]\n      ],\n      size,\n      size\n    );\n  }\n\n  // input commonBounds: [xMin, yMin, xMax, yMax]\n  // output worldBounds: [minLong, minLat, maxLong, maxLat]\n  _commonToWorldBounds(commonBounds) {\n    const [xMin, yMin, xMax, yMax] = commonBounds;\n    const {viewport} = this.context;\n    const bottomLeftWorld = viewport.unprojectPosition([xMin, yMin]);\n    const topRightWorld = viewport.unprojectPosition([xMax, yMax]);\n\n    return bottomLeftWorld.slice(0, 2).concat(topRightWorld.slice(0, 2));\n  }\n}\n","export default `\\\nattribute vec4 inTexture;\nvarying vec4 outTexture;\n\nvoid main()\n{\noutTexture = inTexture;\ngl_Position = vec4(0, 0, 0, 1.);\n// Enforce default value for ANGLE issue (https://bugs.chromium.org/p/angleproject/issues/detail?id=3941)\ngl_PointSize = 1.0;\n}\n`;\n","export default `\\\nvarying vec4 outTexture;\nvoid main() {\n  gl_FragColor = outTexture;\n  gl_FragColor.g = outTexture.r / max(1.0, outTexture.a);\n}\n`;\n","export default `\\\nvarying vec4 weightsTexture;\n// Epanechnikov function, keeping for reference\n// float epanechnikovKDE(float u) {\n//   return 0.75 * (1.0 - u * u);\n// }\nfloat gaussianKDE(float u){\n  return pow(2.71828, -u*u/0.05555)/(1.77245385*0.166666);\n}\nvoid main()\n{\n  float dist = length(gl_PointCoord - vec2(0.5, 0.5));\n  if (dist > 0.5) {\n    discard;\n  }\n  gl_FragColor = weightsTexture * gaussianKDE(2. * dist);\n  DECKGL_FILTER_COLOR(gl_FragColor, geometry);\n}\n`;\n","// Copyright (c) 2015 - 2017 Uber Technologies, Inc.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in\n// all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n// THE SOFTWARE.\n/* eslint-disable max-len */\n\nexport {default as ScreenGridLayer} from './screen-grid-layer/screen-grid-layer';\nexport {default as CPUGridLayer} from './cpu-grid-layer/cpu-grid-layer';\nexport {default as HexagonLayer} from './hexagon-layer/hexagon-layer';\nexport {default as ContourLayer} from './contour-layer/contour-layer';\nexport {default as GridLayer} from './grid-layer/grid-layer';\nexport {default as GPUGridLayer} from './gpu-grid-layer/gpu-grid-layer';\nexport {AGGREGATION_OPERATION} from './utils/aggregation-operation-utils';\n\n// experimental export\nexport {default as HeatmapLayer} from './heatmap-layer/heatmap-layer';\nexport {default as _GPUGridAggregator} from './utils/gpu-grid-aggregation/gpu-grid-aggregator';\nexport {default as _CPUAggregator} from './utils/cpu-aggregator';\nexport {default as _AggregationLayer} from './aggregation-layer';\nexport {default as _BinSorter} from './utils/bin-sorter';\n\n// types\nexport type {ContourLayerProps} from './contour-layer/contour-layer';\nexport type {HeatmapLayerProps} from './heatmap-layer/heatmap-layer';\nexport type {HexagonLayerProps} from './hexagon-layer/hexagon-layer';\nexport type {CPUGridLayerProps} from './cpu-grid-layer/cpu-grid-layer';\nexport type {GridLayerProps} from './grid-layer/grid-layer';\nexport type {GPUGridLayerProps} from './gpu-grid-layer/gpu-grid-layer';\nexport type {ScreenGridLayerProps} from './screen-grid-layer/screen-grid-layer';\n","import Geometry from '../geometry/geometry';\nimport { uid } from '@luma.gl/webgl';\nconst INDEX_OFFSETS = {\n  x: [2, 0, 1],\n  y: [0, 1, 2],\n  z: [1, 2, 0]\n};\nexport default class TruncatedConeGeometry extends Geometry {\n  constructor() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      id = uid('truncated-code-geometry')\n    } = props;\n    const {\n      indices,\n      attributes\n    } = tesselateTruncatedCone(props);\n    super({ ...props,\n      id,\n      indices,\n      attributes: { ...attributes,\n        ...props.attributes\n      }\n    });\n  }\n\n}\n\nfunction tesselateTruncatedCone(props) {\n  const {\n    bottomRadius = 0,\n    topRadius = 0,\n    height = 1,\n    nradial = 10,\n    nvertical = 10,\n    verticalAxis = 'y',\n    topCap = false,\n    bottomCap = false\n  } = props;\n  const extra = (topCap ? 2 : 0) + (bottomCap ? 2 : 0);\n  const numVertices = (nradial + 1) * (nvertical + 1 + extra);\n  const slant = Math.atan2(bottomRadius - topRadius, height);\n  const msin = Math.sin;\n  const mcos = Math.cos;\n  const mpi = Math.PI;\n  const cosSlant = mcos(slant);\n  const sinSlant = msin(slant);\n  const start = topCap ? -2 : 0;\n  const end = nvertical + (bottomCap ? 2 : 0);\n  const vertsAroundEdge = nradial + 1;\n  const indices = new Uint16Array(nradial * (nvertical + extra) * 6);\n  const indexOffset = INDEX_OFFSETS[verticalAxis];\n  const positions = new Float32Array(numVertices * 3);\n  const normals = new Float32Array(numVertices * 3);\n  const texCoords = new Float32Array(numVertices * 2);\n  let i3 = 0;\n  let i2 = 0;\n\n  for (let i = start; i <= end; i++) {\n    let v = i / nvertical;\n    let y = height * v;\n    let ringRadius;\n\n    if (i < 0) {\n      y = 0;\n      v = 1;\n      ringRadius = bottomRadius;\n    } else if (i > nvertical) {\n      y = height;\n      v = 1;\n      ringRadius = topRadius;\n    } else {\n      ringRadius = bottomRadius + (topRadius - bottomRadius) * (i / nvertical);\n    }\n\n    if (i === -2 || i === nvertical + 2) {\n      ringRadius = 0;\n      v = 0;\n    }\n\n    y -= height / 2;\n\n    for (let j = 0; j < vertsAroundEdge; j++) {\n      const sin = msin(j * mpi * 2 / nradial);\n      const cos = mcos(j * mpi * 2 / nradial);\n      positions[i3 + indexOffset[0]] = sin * ringRadius;\n      positions[i3 + indexOffset[1]] = y;\n      positions[i3 + indexOffset[2]] = cos * ringRadius;\n      normals[i3 + indexOffset[0]] = i < 0 || i > nvertical ? 0 : sin * cosSlant;\n      normals[i3 + indexOffset[1]] = i < 0 ? -1 : i > nvertical ? 1 : sinSlant;\n      normals[i3 + indexOffset[2]] = i < 0 || i > nvertical ? 0 : cos * cosSlant;\n      texCoords[i2 + 0] = j / nradial;\n      texCoords[i2 + 1] = v;\n      i2 += 2;\n      i3 += 3;\n    }\n  }\n\n  for (let i = 0; i < nvertical + extra; i++) {\n    for (let j = 0; j < nradial; j++) {\n      const index = (i * nradial + j) * 6;\n      indices[index + 0] = vertsAroundEdge * (i + 0) + 0 + j;\n      indices[index + 1] = vertsAroundEdge * (i + 0) + 1 + j;\n      indices[index + 2] = vertsAroundEdge * (i + 1) + 1 + j;\n      indices[index + 3] = vertsAroundEdge * (i + 0) + 0 + j;\n      indices[index + 4] = vertsAroundEdge * (i + 1) + 1 + j;\n      indices[index + 5] = vertsAroundEdge * (i + 1) + 0 + j;\n    }\n  }\n\n  return {\n    indices,\n    attributes: {\n      POSITION: {\n        size: 3,\n        value: positions\n      },\n      NORMAL: {\n        size: 3,\n        value: normals\n      },\n      TEXCOORD_0: {\n        size: 2,\n        value: texCoords\n      }\n    }\n  };\n}\n//# sourceMappingURL=truncated-cone-geometry.js.map","import TruncatedConeGeometry from './truncated-cone-geometry';\nimport { uid } from '@luma.gl/webgl';\nexport default class ConeGeometry extends TruncatedConeGeometry {\n  constructor() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      id = uid('cone-geometry'),\n      radius = 1,\n      cap = true\n    } = props;\n    super({ ...props,\n      id,\n      topRadius: 0,\n      topCap: Boolean(cap),\n      bottomCap: Boolean(cap),\n      bottomRadius: radius\n    });\n  }\n\n}\n//# sourceMappingURL=cone-geometry.js.map","import TruncatedConeGeometry from './truncated-cone-geometry';\nimport { uid } from '@luma.gl/webgl';\nexport default class CylinderGeometry extends TruncatedConeGeometry {\n  constructor() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      id = uid('cylinder-geometry'),\n      radius = 1\n    } = props;\n    super({ ...props,\n      id,\n      bottomRadius: radius,\n      topRadius: radius\n    });\n  }\n\n}\n//# sourceMappingURL=cylinder-geometry.js.map","import { Vector3 } from '@math.gl/core';\nimport Geometry from '../geometry/geometry';\nimport { uid } from '@luma.gl/webgl';\nconst ICO_POSITIONS = [-1, 0, 0, 0, 1, 0, 0, 0, -1, 0, 0, 1, 0, -1, 0, 1, 0, 0];\nconst ICO_INDICES = [3, 4, 5, 3, 5, 1, 3, 1, 0, 3, 0, 4, 4, 0, 2, 4, 2, 5, 2, 0, 1, 5, 2, 1];\nexport default class IcoSphereGeometry extends Geometry {\n  constructor() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      id = uid('ico-sphere-geometry')\n    } = props;\n    const {\n      indices,\n      attributes\n    } = tesselateIcosaHedron(props);\n    super({ ...props,\n      id,\n      indices,\n      attributes: { ...attributes,\n        ...props.attributes\n      }\n    });\n  }\n\n}\n\nfunction tesselateIcosaHedron(props) {\n  const {\n    iterations = 0\n  } = props;\n  const PI = Math.PI;\n  const PI2 = PI * 2;\n  const positions = [...ICO_POSITIONS];\n  let indices = [...ICO_INDICES];\n  positions.push();\n  indices.push();\n\n  const getMiddlePoint = (() => {\n    const pointMemo = {};\n    return (i1, i2) => {\n      i1 *= 3;\n      i2 *= 3;\n      const mini = i1 < i2 ? i1 : i2;\n      const maxi = i1 > i2 ? i1 : i2;\n      const key = \"\".concat(mini, \"|\").concat(maxi);\n\n      if (key in pointMemo) {\n        return pointMemo[key];\n      }\n\n      const x1 = positions[i1];\n      const y1 = positions[i1 + 1];\n      const z1 = positions[i1 + 2];\n      const x2 = positions[i2];\n      const y2 = positions[i2 + 1];\n      const z2 = positions[i2 + 2];\n      let xm = (x1 + x2) / 2;\n      let ym = (y1 + y2) / 2;\n      let zm = (z1 + z2) / 2;\n      const len = Math.sqrt(xm * xm + ym * ym + zm * zm);\n      xm /= len;\n      ym /= len;\n      zm /= len;\n      positions.push(xm, ym, zm);\n      return pointMemo[key] = positions.length / 3 - 1;\n    };\n  })();\n\n  for (let i = 0; i < iterations; i++) {\n    const indices2 = [];\n\n    for (let j = 0; j < indices.length; j += 3) {\n      const a = getMiddlePoint(indices[j + 0], indices[j + 1]);\n      const b = getMiddlePoint(indices[j + 1], indices[j + 2]);\n      const c = getMiddlePoint(indices[j + 2], indices[j + 0]);\n      indices2.push(c, indices[j + 0], a, a, indices[j + 1], b, b, indices[j + 2], c, a, b, c);\n    }\n\n    indices = indices2;\n  }\n\n  const normals = new Array(positions.length);\n  const texCoords = new Array(positions.length / 3 * 2);\n  const l = indices.length;\n\n  for (let i = l - 3; i >= 0; i -= 3) {\n    const i1 = indices[i + 0];\n    const i2 = indices[i + 1];\n    const i3 = indices[i + 2];\n    const in1 = i1 * 3;\n    const in2 = i2 * 3;\n    const in3 = i3 * 3;\n    const iu1 = i1 * 2;\n    const iu2 = i2 * 2;\n    const iu3 = i3 * 2;\n    const x1 = positions[in1 + 0];\n    const y1 = positions[in1 + 1];\n    const z1 = positions[in1 + 2];\n    const theta1 = Math.acos(z1 / Math.sqrt(x1 * x1 + y1 * y1 + z1 * z1));\n    const phi1 = Math.atan2(y1, x1) + PI;\n    const v1 = theta1 / PI;\n    const u1 = 1 - phi1 / PI2;\n    const x2 = positions[in2 + 0];\n    const y2 = positions[in2 + 1];\n    const z2 = positions[in2 + 2];\n    const theta2 = Math.acos(z2 / Math.sqrt(x2 * x2 + y2 * y2 + z2 * z2));\n    const phi2 = Math.atan2(y2, x2) + PI;\n    const v2 = theta2 / PI;\n    const u2 = 1 - phi2 / PI2;\n    const x3 = positions[in3 + 0];\n    const y3 = positions[in3 + 1];\n    const z3 = positions[in3 + 2];\n    const theta3 = Math.acos(z3 / Math.sqrt(x3 * x3 + y3 * y3 + z3 * z3));\n    const phi3 = Math.atan2(y3, x3) + PI;\n    const v3 = theta3 / PI;\n    const u3 = 1 - phi3 / PI2;\n    const vec1 = [x3 - x2, y3 - y2, z3 - z2];\n    const vec2 = [x1 - x2, y1 - y2, z1 - z2];\n    const normal = new Vector3(vec1).cross(vec2).normalize();\n    let newIndex;\n\n    if ((u1 === 0 || u2 === 0 || u3 === 0) && (u1 === 0 || u1 > 0.5) && (u2 === 0 || u2 > 0.5) && (u3 === 0 || u3 > 0.5)) {\n      positions.push(positions[in1 + 0], positions[in1 + 1], positions[in1 + 2]);\n      newIndex = positions.length / 3 - 1;\n      indices.push(newIndex);\n      texCoords[newIndex * 2 + 0] = 1;\n      texCoords[newIndex * 2 + 1] = v1;\n      normals[newIndex * 3 + 0] = normal.x;\n      normals[newIndex * 3 + 1] = normal.y;\n      normals[newIndex * 3 + 2] = normal.z;\n      positions.push(positions[in2 + 0], positions[in2 + 1], positions[in2 + 2]);\n      newIndex = positions.length / 3 - 1;\n      indices.push(newIndex);\n      texCoords[newIndex * 2 + 0] = 1;\n      texCoords[newIndex * 2 + 1] = v2;\n      normals[newIndex * 3 + 0] = normal.x;\n      normals[newIndex * 3 + 1] = normal.y;\n      normals[newIndex * 3 + 2] = normal.z;\n      positions.push(positions[in3 + 0], positions[in3 + 1], positions[in3 + 2]);\n      newIndex = positions.length / 3 - 1;\n      indices.push(newIndex);\n      texCoords[newIndex * 2 + 0] = 1;\n      texCoords[newIndex * 2 + 1] = v3;\n      normals[newIndex * 3 + 0] = normal.x;\n      normals[newIndex * 3 + 1] = normal.y;\n      normals[newIndex * 3 + 2] = normal.z;\n    }\n\n    normals[in1 + 0] = normals[in2 + 0] = normals[in3 + 0] = normal.x;\n    normals[in1 + 1] = normals[in2 + 1] = normals[in3 + 1] = normal.y;\n    normals[in1 + 2] = normals[in2 + 2] = normals[in3 + 2] = normal.z;\n    texCoords[iu1 + 0] = u1;\n    texCoords[iu1 + 1] = v1;\n    texCoords[iu2 + 0] = u2;\n    texCoords[iu2 + 1] = v2;\n    texCoords[iu3 + 0] = u3;\n    texCoords[iu3 + 1] = v3;\n  }\n\n  return {\n    indices: {\n      size: 1,\n      value: new Uint16Array(indices)\n    },\n    attributes: {\n      POSITION: {\n        size: 3,\n        value: new Float32Array(positions)\n      },\n      NORMAL: {\n        size: 3,\n        value: new Float32Array(normals)\n      },\n      TEXCOORD_0: {\n        size: 2,\n        value: new Float32Array(texCoords)\n      }\n    }\n  };\n}\n//# sourceMappingURL=ico-sphere-geometry.js.map","import Geometry from '../geometry/geometry';\nimport { unpackIndexedGeometry } from '../geometry/geometry-utils';\nimport { uid } from '@luma.gl/webgl';\nexport default class PlaneGeometry extends Geometry {\n  constructor() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      id = uid('plane-geometry')\n    } = props;\n    const {\n      indices,\n      attributes\n    } = tesselatePlane(props);\n    super({ ...props,\n      id,\n      indices,\n      attributes: { ...attributes,\n        ...props.attributes\n      }\n    });\n  }\n\n}\n\nfunction tesselatePlane(props) {\n  const {\n    type = 'x,y',\n    offset = 0,\n    flipCull = false,\n    unpack = false\n  } = props;\n  const coords = type.split(',');\n  let c1len = props[\"\".concat(coords[0], \"len\")] || 1;\n  const c2len = props[\"\".concat(coords[1], \"len\")] || 1;\n  const subdivisions1 = props[\"n\".concat(coords[0])] || 1;\n  const subdivisions2 = props[\"n\".concat(coords[1])] || 1;\n  const numVertices = (subdivisions1 + 1) * (subdivisions2 + 1);\n  const positions = new Float32Array(numVertices * 3);\n  const normals = new Float32Array(numVertices * 3);\n  const texCoords = new Float32Array(numVertices * 2);\n\n  if (flipCull) {\n    c1len = -c1len;\n  }\n\n  let i2 = 0;\n  let i3 = 0;\n\n  for (let z = 0; z <= subdivisions2; z++) {\n    for (let x = 0; x <= subdivisions1; x++) {\n      const u = x / subdivisions1;\n      const v = z / subdivisions2;\n      texCoords[i2 + 0] = flipCull ? 1 - u : u;\n      texCoords[i2 + 1] = v;\n\n      switch (type) {\n        case 'x,y':\n          positions[i3 + 0] = c1len * u - c1len * 0.5;\n          positions[i3 + 1] = c2len * v - c2len * 0.5;\n          positions[i3 + 2] = offset;\n          normals[i3 + 0] = 0;\n          normals[i3 + 1] = 0;\n          normals[i3 + 2] = flipCull ? 1 : -1;\n          break;\n\n        case 'x,z':\n          positions[i3 + 0] = c1len * u - c1len * 0.5;\n          positions[i3 + 1] = offset;\n          positions[i3 + 2] = c2len * v - c2len * 0.5;\n          normals[i3 + 0] = 0;\n          normals[i3 + 1] = flipCull ? 1 : -1;\n          normals[i3 + 2] = 0;\n          break;\n\n        case 'y,z':\n          positions[i3 + 0] = offset;\n          positions[i3 + 1] = c1len * u - c1len * 0.5;\n          positions[i3 + 2] = c2len * v - c2len * 0.5;\n          normals[i3 + 0] = flipCull ? 1 : -1;\n          normals[i3 + 1] = 0;\n          normals[i3 + 2] = 0;\n          break;\n\n        default:\n          throw new Error('PlaneGeometry: unknown type');\n      }\n\n      i2 += 2;\n      i3 += 3;\n    }\n  }\n\n  const numVertsAcross = subdivisions1 + 1;\n  const indices = new Uint16Array(subdivisions1 * subdivisions2 * 6);\n\n  for (let z = 0; z < subdivisions2; z++) {\n    for (let x = 0; x < subdivisions1; x++) {\n      const index = (z * subdivisions1 + x) * 6;\n      indices[index + 0] = (z + 0) * numVertsAcross + x;\n      indices[index + 1] = (z + 1) * numVertsAcross + x;\n      indices[index + 2] = (z + 0) * numVertsAcross + x + 1;\n      indices[index + 3] = (z + 1) * numVertsAcross + x;\n      indices[index + 4] = (z + 1) * numVertsAcross + x + 1;\n      indices[index + 5] = (z + 0) * numVertsAcross + x + 1;\n    }\n  }\n\n  const geometry = {\n    indices: {\n      size: 1,\n      value: indices\n    },\n    attributes: {\n      POSITION: {\n        size: 3,\n        value: positions\n      },\n      NORMAL: {\n        size: 3,\n        value: normals\n      },\n      TEXCOORD_0: {\n        size: 2,\n        value: texCoords\n      }\n    }\n  };\n  return unpack ? unpackIndexedGeometry(geometry) : geometry;\n}\n//# sourceMappingURL=plane-geometry.js.map","export function unpackIndexedGeometry(geometry) {\n  const {\n    indices,\n    attributes\n  } = geometry;\n\n  if (!indices) {\n    return geometry;\n  }\n\n  const vertexCount = indices.value.length;\n  const unpackedAttributes = {};\n\n  for (const attributeName in attributes) {\n    const attribute = attributes[attributeName];\n    const {\n      constant,\n      value,\n      size\n    } = attribute;\n\n    if (constant || !size) {\n      continue;\n    }\n\n    const unpackedValue = new value.constructor(vertexCount * size);\n\n    for (let x = 0; x < vertexCount; ++x) {\n      const index = indices.value[x];\n\n      for (let i = 0; i < size; i++) {\n        unpackedValue[x * size + i] = value[index * size + i];\n      }\n    }\n\n    unpackedAttributes[attributeName] = {\n      size,\n      value: unpackedValue\n    };\n  }\n\n  return {\n    attributes: Object.assign({}, attributes, unpackedAttributes)\n  };\n}\n//# sourceMappingURL=geometry-utils.js.map","import Geometry from '../geometry/geometry';\nimport { uid } from '@luma.gl/webgl';\nexport default class SphereGeometry extends Geometry {\n  constructor() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      id = uid('sphere-geometry')\n    } = props;\n    const {\n      indices,\n      attributes\n    } = tesselateSphere(props);\n    super({ ...props,\n      id,\n      indices,\n      attributes: { ...attributes,\n        ...props.attributes\n      }\n    });\n  }\n\n}\n\nfunction tesselateSphere(props) {\n  const {\n    nlat = 10,\n    nlong = 10\n  } = props;\n  let {\n    radius = 1\n  } = props;\n  const startLat = 0;\n  const endLat = Math.PI;\n  const latRange = endLat - startLat;\n  const startLong = 0;\n  const endLong = 2 * Math.PI;\n  const longRange = endLong - startLong;\n  const numVertices = (nlat + 1) * (nlong + 1);\n\n  if (typeof radius === 'number') {\n    const value = radius;\n\n    radius = (n1, n2, n3, u, v) => value;\n  }\n\n  const positions = new Float32Array(numVertices * 3);\n  const normals = new Float32Array(numVertices * 3);\n  const texCoords = new Float32Array(numVertices * 2);\n  const IndexType = numVertices > 0xffff ? Uint32Array : Uint16Array;\n  const indices = new IndexType(nlat * nlong * 6);\n\n  for (let y = 0; y <= nlat; y++) {\n    for (let x = 0; x <= nlong; x++) {\n      const u = x / nlong;\n      const v = y / nlat;\n      const index = x + y * (nlong + 1);\n      const i2 = index * 2;\n      const i3 = index * 3;\n      const theta = longRange * u;\n      const phi = latRange * v;\n      const sinTheta = Math.sin(theta);\n      const cosTheta = Math.cos(theta);\n      const sinPhi = Math.sin(phi);\n      const cosPhi = Math.cos(phi);\n      const ux = cosTheta * sinPhi;\n      const uy = cosPhi;\n      const uz = sinTheta * sinPhi;\n      const r = radius(ux, uy, uz, u, v);\n      positions[i3 + 0] = r * ux;\n      positions[i3 + 1] = r * uy;\n      positions[i3 + 2] = r * uz;\n      normals[i3 + 0] = ux;\n      normals[i3 + 1] = uy;\n      normals[i3 + 2] = uz;\n      texCoords[i2 + 0] = u;\n      texCoords[i2 + 1] = 1 - v;\n    }\n  }\n\n  const numVertsAround = nlong + 1;\n\n  for (let x = 0; x < nlong; x++) {\n    for (let y = 0; y < nlat; y++) {\n      const index = (x * nlat + y) * 6;\n      indices[index + 0] = y * numVertsAround + x;\n      indices[index + 1] = y * numVertsAround + x + 1;\n      indices[index + 2] = (y + 1) * numVertsAround + x;\n      indices[index + 3] = (y + 1) * numVertsAround + x;\n      indices[index + 4] = y * numVertsAround + x + 1;\n      indices[index + 5] = (y + 1) * numVertsAround + x + 1;\n    }\n  }\n\n  return {\n    indices: {\n      size: 1,\n      value: indices\n    },\n    attributes: {\n      POSITION: {\n        size: 3,\n        value: positions\n      },\n      NORMAL: {\n        size: 3,\n        value: normals\n      },\n      TEXCOORD_0: {\n        size: 2,\n        value: texCoords\n      }\n    }\n  };\n}\n//# sourceMappingURL=sphere-geometry.js.map","// Cherry-pick luma core exports that are relevant to deck\nexport {\n  // Core classes\n  Model,\n  Transform,\n  ProgramManager,\n  Timeline,\n  // Context utilities\n  instrumentGLContext,\n  isWebGL2,\n  FEATURES,\n  hasFeatures,\n  getParameters,\n  setParameters,\n  withParameters,\n  cssToDeviceRatio,\n  // Copy and blit\n  // These are needed by submodules and rely on using the same copy\n  // of Texture2D & Framebuffer\n  readPixelsToBuffer,\n  copyToTexture,\n  cloneTextureFrom,\n  // WebGL1 classes\n  Buffer,\n  Program,\n  Framebuffer,\n  Renderbuffer,\n  Texture2D,\n  TextureCube,\n  // WebGL2 classes\n  Texture3D,\n  TransformFeedback,\n  // Geometries\n  Geometry,\n  ConeGeometry,\n  CubeGeometry,\n  CylinderGeometry,\n  IcoSphereGeometry,\n  PlaneGeometry,\n  SphereGeometry,\n  TruncatedConeGeometry\n} from '@luma.gl/core';\n","/* global google, document */\nimport {Deck} from '@deck.gl/core';\nimport {Matrix4, Vector2} from '@math.gl/core';\nimport type {MjolnirGestureEvent, MjolnirPointerEvent} from 'mjolnir.js';\n\n// https://en.wikipedia.org/wiki/Web_Mercator_projection#Formulas\nconst MAX_LATITUDE = 85.05113;\n\ntype UserData = {\n  _googleMap: google.maps.Map;\n  _eventListeners: Record<string, google.maps.MapsEventListener | null>;\n};\n\n/**\n * Get a new deck instance\n * @param map (google.maps.Map) - The parent Map instance\n * @param overlay (google.maps.OverlayView) - A maps Overlay instance\n * @param [deck] (Deck) - a previously created instances\n */\nexport function createDeckInstance(\n  map: google.maps.Map,\n  overlay: google.maps.OverlayView | google.maps.WebGLOverlayView,\n  deck: Deck | null | undefined,\n  props\n): Deck {\n  if (deck) {\n    if (deck.userData._googleMap === map) {\n      return deck;\n    }\n    // deck instance was created for a different map\n    destroyDeckInstance(deck);\n  }\n\n  const eventListeners = {\n    click: null,\n    dblclick: null,\n    mousemove: null,\n    mouseout: null\n  };\n\n  const newDeck = new Deck({\n    ...props,\n    useDevicePixels: props.interleaved ? true : props.useDevicePixels,\n    style: props.interleaved ? null : {pointerEvents: 'none'},\n    parent: getContainer(overlay, props.style),\n    initialViewState: {\n      longitude: 0,\n      latitude: 0,\n      zoom: 1\n    },\n    controller: false\n  });\n\n  // Register event listeners\n  for (const eventType in eventListeners) {\n    eventListeners[eventType] = map.addListener(eventType, evt =>\n      handleMouseEvent(newDeck, eventType, evt)\n    );\n  }\n\n  // Attach userData directly to Deck instance\n  (newDeck.userData as UserData)._googleMap = map;\n  (newDeck.userData as UserData)._eventListeners = eventListeners;\n\n  return newDeck;\n}\n\n// Create a container that will host the deck canvas and tooltip\nfunction getContainer(\n  overlay: google.maps.OverlayView | google.maps.WebGLOverlayView,\n  style?: Partial<CSSStyleDeclaration>\n): HTMLElement {\n  const container = document.createElement('div');\n  container.style.position = 'absolute';\n  Object.assign(container.style, style);\n\n  // The DOM structure has a different structure depending on whether\n  // the Google map is rendered as vector or raster\n  if ('getPanes' in overlay) {\n    overlay.getPanes()?.overlayLayer.appendChild(container);\n  } else {\n    overlay.getMap()?.getDiv().appendChild(container);\n  }\n  return container;\n}\n\n/**\n * Safely remove a deck instance\n * @param deck (Deck) - a previously created instances\n */\nexport function destroyDeckInstance(deck: Deck) {\n  const {_eventListeners: eventListeners} = deck.userData;\n\n  // Unregister event listeners\n  for (const eventType in eventListeners) {\n    // Check that event listener was set before trying to remove.\n    if (eventListeners[eventType]) {\n      eventListeners[eventType].remove();\n    }\n  }\n\n  deck.finalize();\n}\n\n/* eslint-disable max-statements */\n/**\n * Get the current view state\n * @param map (google.maps.Map) - The parent Map instance\n * @param overlay (google.maps.OverlayView) - A maps Overlay instance\n */\n// eslint-disable-next-line complexity\nexport function getViewPropsFromOverlay(map: google.maps.Map, overlay: google.maps.OverlayView) {\n  const {width, height} = getMapSize(map);\n\n  // Canvas position relative to draggable map's container depends on\n  // overlayView's projection, not the map's. Have to use the center of the\n  // map for this, not the top left, for the same reason as above.\n  const projection = overlay.getProjection();\n\n  const bounds = map.getBounds();\n  if (!bounds) {\n    return {width, height, left: 0, top: 0};\n  }\n\n  const ne = bounds.getNorthEast();\n  const sw = bounds.getSouthWest();\n  const topRight = projection.fromLatLngToDivPixel(ne);\n  const bottomLeft = projection.fromLatLngToDivPixel(sw);\n\n  // google maps places overlays in a container anchored at the map center.\n  // the container CSS is manipulated during dragging.\n  // We need to update left/top of the deck canvas to match the base map.\n  const centerLngLat = pixelToLngLat(projection, width / 2, height / 2);\n  const centerH = new google.maps.LatLng(0, centerLngLat[0]);\n  const centerContainerPx = projection.fromLatLngToContainerPixel(centerH);\n  const centerDivPx = projection.fromLatLngToDivPixel(centerH);\n\n  if (!topRight || !bottomLeft || !centerDivPx || !centerContainerPx) {\n    return {width, height, left: 0, top: 0};\n  }\n  const leftOffset = Math.round(centerDivPx.x - centerContainerPx.x);\n  let topOffset = centerDivPx.y - centerContainerPx.y;\n\n  const topLngLat = pixelToLngLat(projection, width / 2, 0);\n  const bottomLngLat = pixelToLngLat(projection, width / 2, height);\n\n  // Compute fractional center.\n  let latitude = centerLngLat[1];\n  const longitude = centerLngLat[0];\n\n  // Adjust vertical offset - limit latitude\n  if (Math.abs(latitude) > MAX_LATITUDE) {\n    latitude = latitude > 0 ? MAX_LATITUDE : -MAX_LATITUDE;\n    const center = new google.maps.LatLng(latitude, longitude);\n    const centerPx = projection.fromLatLngToContainerPixel(center);\n    // @ts-ignore (TS2531) Object is possibly 'null'\n    topOffset += centerPx.y - height / 2;\n  }\n  topOffset = Math.round(topOffset);\n\n  // Compute fractional bearing\n  const delta = new Vector2(topLngLat).sub(bottomLngLat);\n  let bearing = (180 * delta.verticalAngle()) / Math.PI;\n  if (bearing < 0) bearing += 360;\n\n  // Maps sometimes returns undefined instead of 0\n  const heading = map.getHeading() || 0;\n\n  let zoom = (map.getZoom() as number) - 1;\n\n  let scale;\n\n  if (bearing === 0) {\n    // At full world view (always unrotated) simply compare height, as diagonal\n    // is incorrect due to multiple world copies\n    scale = height ? (bottomLeft.y - topRight.y) / height : 1;\n  } else if (bearing === heading) {\n    // Fractional zoom calculation only correct when bearing is not animating\n    const viewDiagonal = new Vector2([topRight.x, topRight.y])\n      .sub([bottomLeft.x, bottomLeft.y])\n      .len();\n    const mapDiagonal = new Vector2([width, -height]).len();\n    scale = mapDiagonal ? viewDiagonal / mapDiagonal : 1;\n  }\n\n  // When resizing aggressively, occasionally ne and sw are the same points\n  // See https://github.com/visgl/deck.gl/issues/4218\n  zoom += Math.log2(scale || 1);\n\n  return {\n    width,\n    height,\n    left: leftOffset,\n    top: topOffset,\n    zoom,\n    bearing,\n    pitch: map.getTilt(),\n    latitude,\n    longitude\n  };\n}\n\n/* eslint-enable max-statements */\n\n/**\n * Get the current view state\n * @param map (google.maps.Map) - The parent Map instance\n * @param transformer (google.maps.CoordinateTransformer) - A CoordinateTransformer instance\n */\nexport function getViewPropsFromCoordinateTransformer(\n  map: google.maps.Map,\n  transformer: google.maps.CoordinateTransformer\n) {\n  const {width, height} = getMapSize(map);\n  const {center, heading: bearing, tilt: pitch, zoom} = transformer.getCameraParams();\n\n  // Match Google projection matrix\n  const fovy = 25;\n  const aspect = height ? width / height : 1;\n\n  // Match depth range (crucial for correct z-sorting)\n  const near = 0.75;\n  const far = 300000000000000;\n  // const far = Infinity;\n\n  const projectionMatrix = new Matrix4().perspective({\n    fovy: (fovy * Math.PI) / 180,\n    aspect,\n    near,\n    far\n  });\n  const focalDistance = 0.5 * projectionMatrix[5];\n\n  return {\n    width,\n    height,\n    viewState: {\n      altitude: focalDistance,\n      bearing,\n      latitude: center.lat(),\n      longitude: center.lng(),\n      pitch,\n      projectionMatrix,\n      repeat: true,\n      zoom: zoom - 1\n    }\n  };\n}\n\nfunction getMapSize(map: google.maps.Map): {width: number; height: number} {\n  // The map fills the container div unless it's in fullscreen mode\n  // at which point the first child of the container is promoted\n  const container = map.getDiv().firstChild as HTMLElement | null;\n  return {\n    // @ts-ignore (TS2531) Object is possibly 'null'\n    width: container.offsetWidth,\n    // @ts-ignore (TS2531) Object is possibly 'null'\n    height: container.offsetHeight\n  };\n}\n\nfunction pixelToLngLat(\n  projection: google.maps.MapCanvasProjection,\n  x: number,\n  y: number\n): [longitude: number, latitude: number] {\n  const point = new google.maps.Point(x, y);\n  const latLng = projection.fromContainerPixelToLatLng(point);\n  // @ts-ignore (TS2531) Object is possibly 'null'\n  return [latLng.lng(), latLng.lat()];\n}\n\nfunction getEventPixel(event, deck: Deck): {x: number; y: number} {\n  if (event.pixel) {\n    return event.pixel;\n  }\n  // event.pixel may not exist when clicking on a POI\n  // https://developers.google.com/maps/documentation/javascript/reference/map#MouseEvent\n  const point = deck.getViewports()[0].project([event.latLng.lng(), event.latLng.lat()]);\n  return {\n    x: point[0],\n    y: point[1]\n  };\n}\n\n// Triggers picking on a mouse event\nfunction handleMouseEvent(deck: Deck, type: string, event) {\n  const mockEvent: Record<string, any> = {\n    type,\n    offsetCenter: getEventPixel(event, deck),\n    srcEvent: event\n  };\n\n  switch (type) {\n    case 'click':\n      mockEvent.tapCount = 1;\n      // Hack: because we do not listen to pointer down, perform picking now\n      deck._onPointerDown(mockEvent as MjolnirPointerEvent);\n      deck._onEvent(mockEvent as MjolnirGestureEvent);\n      break;\n\n    case 'dblclick':\n      mockEvent.type = 'click';\n      mockEvent.tapCount = 2;\n      deck._onEvent(mockEvent as MjolnirGestureEvent);\n      break;\n\n    case 'mousemove':\n      mockEvent.type = 'pointermove';\n      deck._onPointerMove(mockEvent as MjolnirPointerEvent);\n      break;\n\n    case 'mouseout':\n      mockEvent.type = 'pointerleave';\n      deck._onPointerMove(mockEvent as MjolnirPointerEvent);\n      break;\n\n    default:\n      return;\n  }\n}\n","/* global google */\nimport {getParameters, setParameters, withParameters} from '@luma.gl/core';\nimport GL from '@luma.gl/constants';\nimport {\n  createDeckInstance,\n  destroyDeckInstance,\n  getViewPropsFromOverlay,\n  getViewPropsFromCoordinateTransformer\n} from './utils';\nimport {Deck} from '@deck.gl/core';\n\nimport type {DeckProps} from '@deck.gl/core';\n\nconst HIDE_ALL_LAYERS = () => false;\nconst GL_STATE = {\n  depthMask: true,\n  depthTest: true,\n  blend: true,\n  blendFunc: [GL.SRC_ALPHA, GL.ONE_MINUS_SRC_ALPHA, GL.ONE, GL.ONE_MINUS_SRC_ALPHA],\n  blendEquation: GL.FUNC_ADD\n};\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction noop() {}\n\nconst defaultProps = {\n  interleaved: true\n};\n\nexport type GoogleMapsOverlayProps = DeckProps & {\n  interleaved?: boolean;\n};\n\nexport default class GoogleMapsOverlay {\n  private props: GoogleMapsOverlayProps = {};\n  private _map: google.maps.Map | null = null;\n  private _deck: Deck | null = null;\n  private _overlay: google.maps.WebGLOverlayView | google.maps.OverlayView | null = null;\n\n  constructor(props: GoogleMapsOverlayProps) {\n    this.setProps({...defaultProps, ...props});\n  }\n\n  /* Public API */\n\n  /** Add/remove the overlay from a map. */\n  setMap(map: google.maps.Map | null): void {\n    if (map === this._map) {\n      return;\n    }\n    if (this._map) {\n      this._overlay?.setMap(null);\n      this._map = null;\n    }\n    if (map) {\n      this._map = map;\n      const {UNINITIALIZED} = google.maps.RenderingType;\n      const renderingType = map.getRenderingType();\n      if (renderingType !== UNINITIALIZED) {\n        this._createOverlay(map);\n      } else {\n        map.addListener('renderingtype_changed', () => {\n          this._createOverlay(map);\n        });\n      }\n    }\n  }\n\n  /**\n   * Update (partial) props.\n   */\n  setProps(props: Partial<GoogleMapsOverlayProps>): void {\n    Object.assign(this.props, props);\n    if (this._deck) {\n      if (props.style) {\n        // @ts-ignore accessing protected member\n        const parentStyle = this._deck.canvas.parentElement.style;\n        Object.assign(parentStyle, props.style);\n        props.style = null;\n      }\n      this._deck.setProps(props);\n    }\n  }\n\n  /** Equivalent of `deck.pickObject`. */\n  pickObject(params) {\n    return this._deck && this._deck.pickObject(params);\n  }\n\n  /** Equivalent of `deck.pickObjects`.  */\n  pickMultipleObjects(params) {\n    return this._deck && this._deck.pickMultipleObjects(params);\n  }\n\n  /** Equivalent of `deck.pickMultipleObjects`. */\n  pickObjects(params) {\n    return this._deck && this._deck.pickObjects(params);\n  }\n\n  /** Remove the overlay and release all underlying resources. */\n  finalize() {\n    this.setMap(null);\n    if (this._deck) {\n      destroyDeckInstance(this._deck);\n      this._deck = null;\n    }\n  }\n\n  /* Private API */\n  _createOverlay(map: google.maps.Map) {\n    const {interleaved} = this.props;\n    const {VECTOR, UNINITIALIZED} = google.maps.RenderingType;\n    const renderingType = map.getRenderingType();\n    if (renderingType === UNINITIALIZED) {\n      return;\n    }\n\n    const isVectorMap = renderingType === VECTOR && google.maps.WebGLOverlayView;\n    const OverlayView = isVectorMap ? google.maps.WebGLOverlayView : google.maps.OverlayView;\n    const overlay = new OverlayView();\n\n    if (overlay instanceof google.maps.WebGLOverlayView) {\n      if (interleaved) {\n        overlay.onAdd = noop;\n        overlay.onContextRestored = this._onContextRestored.bind(this);\n        overlay.onDraw = this._onDrawVectorInterleaved.bind(this);\n      } else {\n        overlay.onAdd = this._onAdd.bind(this);\n        overlay.onContextRestored = noop;\n        overlay.onDraw = this._onDrawVectorOverlay.bind(this);\n      }\n      overlay.onContextLost = this._onContextLost.bind(this);\n    } else {\n      overlay.onAdd = this._onAdd.bind(this);\n      overlay.draw = this._onDrawRaster.bind(this);\n    }\n    overlay.onRemove = this._onRemove.bind(this);\n\n    this._overlay = overlay;\n    this._overlay.setMap(map);\n  }\n\n  _onAdd() {\n    // @ts-ignore (TS2345) map is defined at this stage\n    this._deck = createDeckInstance(this._map, this._overlay, this._deck, this.props);\n  }\n\n  _onContextRestored({gl}) {\n    if (!this._map || !this._overlay) {\n      return;\n    }\n    const _customRender = () => {\n      if (this._overlay) {\n        (this._overlay as google.maps.WebGLOverlayView).requestRedraw();\n      }\n    };\n    const deck = createDeckInstance(this._map, this._overlay, this._deck, {\n      gl,\n      _customRender,\n      ...this.props\n    });\n    this._deck = deck;\n\n    // By default, animationLoop._renderFrame invokes\n    // animationLoop.onRender. We override this to wrap\n    // in withParameters so we don't modify the GL state\n    // @ts-ignore accessing protected member\n    const {animationLoop} = deck;\n    animationLoop._renderFrame = () => {\n      const ab = gl.getParameter(gl.ARRAY_BUFFER_BINDING);\n      withParameters(gl, {}, () => {\n        animationLoop.onRender();\n      });\n      gl.bindBuffer(gl.ARRAY_BUFFER, ab);\n    };\n  }\n\n  _onContextLost() {\n    // TODO this isn't working\n    if (this._deck) {\n      destroyDeckInstance(this._deck);\n      this._deck = null;\n    }\n  }\n\n  _onRemove() {\n    this._deck?.setProps({layerFilter: HIDE_ALL_LAYERS});\n  }\n\n  _onDrawRaster() {\n    if (!this._deck || !this._map) {\n      return;\n    }\n    const deck = this._deck;\n\n    const {width, height, left, top, ...rest} = getViewPropsFromOverlay(\n      this._map,\n      this._overlay as google.maps.OverlayView\n    );\n\n    // @ts-ignore accessing protected member\n    const parentStyle = deck.canvas.parentElement.style;\n    parentStyle.left = `${left}px`;\n    parentStyle.top = `${top}px`;\n\n    const altitude = 10000;\n    deck.setProps({\n      width,\n      height,\n      viewState: {altitude, repeat: true, ...rest}\n    });\n    // Deck is initialized\n    deck.redraw();\n  }\n\n  // Vector code path\n  _onDrawVectorInterleaved({gl, transformer}) {\n    if (!this._deck || !this._map) {\n      return;\n    }\n\n    const deck = this._deck;\n\n    deck.setProps({\n      ...getViewPropsFromCoordinateTransformer(this._map, transformer),\n\n      // Using external gl context - do not set css size\n      width: null,\n      height: null\n    });\n\n    if (deck.isInitialized) {\n      // As an optimization, some renders are to an separate framebuffer\n      // which we need to pass onto deck\n      const _framebuffer = getParameters(gl, GL.FRAMEBUFFER_BINDING);\n      deck.setProps({_framebuffer});\n\n      // Camera changed, will trigger a map repaint right after this\n      // Clear any change flag triggered by setting viewState so that deck does not request\n      // a second repaint\n      deck.needsRedraw({clearRedrawFlags: true});\n\n      // Workaround for bug in Google maps where viewport state is wrong\n      // TODO remove once fixed\n      setParameters(gl, {\n        viewport: [0, 0, gl.canvas.width, gl.canvas.height],\n        scissor: [0, 0, gl.canvas.width, gl.canvas.height],\n        stencilFunc: [gl.ALWAYS, 0, 255, gl.ALWAYS, 0, 255]\n      });\n\n      withParameters(gl, GL_STATE, () => {\n        deck._drawLayers('google-vector', {\n          clearCanvas: false\n        });\n      });\n    }\n  }\n\n  _onDrawVectorOverlay({transformer}) {\n    if (!this._deck || !this._map) {\n      return;\n    }\n\n    const deck = this._deck;\n\n    deck.setProps({\n      ...getViewPropsFromCoordinateTransformer(this._map, transformer)\n    });\n    deck.redraw();\n  }\n}\n","export {default as GoogleMapsOverlay} from './google-maps-overlay';\nexport type {GoogleMapsOverlayProps} from './google-maps-overlay';\n","// Functions to wrangle data from pydeck's row major order matrix dataframe to the deck.gl binary data format.\n// The format used is described here:\n// https://deck.gl/#/documentation/developer-guide/performance-optimization?section=supply-attributes-directly\n\n// eslint-disable-next-line complexity\nfunction dtypeToTypedArray(dtype) {\n  // Supports converting a numpy-typed array to a JavaScript-typed array\n  // based on a string value dtype and a DataView `data`\n  switch (dtype) {\n    case 'int8':\n      return Int8Array;\n    case 'uint8':\n      return Uint8Array;\n    case 'int16':\n      return Int16Array;\n    case 'uint16':\n      return Uint16Array;\n    case 'float32':\n      return Float32Array;\n    case 'float64':\n      return Float64Array;\n    case 'int32':\n      return Int32Array;\n    case 'uint32':\n      return Uint32Array;\n    case 'int64':\n      return BigInt64Array; // eslint-disable-line no-undef\n    case 'uint64':\n      return BigUint64Array; // eslint-disable-line no-undef\n    default:\n      throw new Error(`Unrecognized dtype ${dtype}`);\n  }\n}\n\nexport function deserializeMatrix(obj, manager) {\n  if (!obj) {\n    return null;\n  }\n  for (const layerId in obj) {\n    const attributes = obj[layerId].attributes;\n    for (const accessorName in attributes) {\n      const {dtype, value} = attributes[accessorName];\n      const ArrayType = dtypeToTypedArray(dtype);\n      attributes[accessorName].value = new ArrayType(value.buffer);\n    }\n  }\n  // Becomes the data stored within the widget model at `model.get('data_buffer')`\n  return obj;\n}\n","import {DOMWidgetModel} from '@jupyter-widgets/base';\nimport {MODULE_NAME, MODULE_VERSION} from '../version';\nimport {deserializeMatrix} from './utils/deserialize-matrix';\n/**\n *\n * Note: Variables shared explictly between Python and JavaScript use snake_case\n */\nexport default class JupyterTransportModel extends DOMWidgetModel {\n  defaults() {\n    return {\n      ...super.defaults(),\n      _model_name: JupyterTransportModel.model_name,\n      _model_module: JupyterTransportModel.model_module,\n      _model_module_version: JupyterTransportModel.model_module_version,\n      _view_name: JupyterTransportModel.view_name,\n      _view_module: JupyterTransportModel.view_module,\n      _view_module_version: JupyterTransportModel.view_module_version,\n      custom_libraries: [],\n      json_input: null,\n      mapbox_key: null,\n      selected_data: [],\n      data_buffer: null,\n      tooltip: null,\n      width: '100%',\n      height: 500,\n      js_warning: false\n    };\n  }\n\n  static get serializers() {\n    return {\n      ...DOMWidgetModel.serializers,\n      // Add any extra serializers here\n      data_buffer: {deserialize: deserializeMatrix}\n    };\n  }\n\n  static get model_name() {\n    return 'JupyterTransportModel';\n  }\n  static get model_module() {\n    return MODULE_NAME;\n  }\n  static get model_module_version() {\n    return MODULE_VERSION;\n  }\n  static get view_name() {\n    return 'JupyterTransportView';\n  }\n  static get view_module() {\n    return MODULE_NAME;\n  }\n  static get view_module_version() {\n    return MODULE_VERSION;\n  }\n}\n","import * as deckBundle from '../deck-bundle';\n\nimport {Transport} from '@deck.gl/json';\n\nimport {createContainer} from './utils/css-utils';\n\nimport {loadMapboxCSS} from './utils/mapbox-utils';\n\nimport {jsonConverter, createDeck} from './create-deck';\n\nexport function initPlayground() {\n  Transport.setCallbacks({\n    onInitialize({transport}) {\n      // Extract \"deck.gl playground\" props\n      const {width, height, customLibraries, mapboxApiKey, jsonInput, tooltip} =\n        getPlaygroundProps(transport);\n\n      // Load mapbox CSS\n      loadMapboxCSS();\n\n      // Create container div for deck.gl\n      const transportRootElement = transport.getRootDOMElement();\n      const deckContainer = createContainer(width, height);\n      transportRootElement.appendChild(deckContainer);\n\n      const jsonProps = JSON.parse(jsonInput);\n\n      const deck = createDeck({\n        mapboxApiKey,\n        container: deckContainer,\n        jsonInput: jsonProps,\n        tooltip,\n        handleEvent: (name, payload) => sendEventViaTransport(transport, name, payload),\n        customLibraries\n      });\n\n      transport.userData.deck = deck;\n    },\n\n    onFinalize({transport}) {\n      const {deck} = transport.userData;\n      deck.finalize();\n    },\n\n    onMessage({transport, type, json, binary}) {\n      const {deck} = transport.userData;\n      let convertedJson;\n      switch (type) {\n        case 'json':\n          convertedJson = jsonConverter.convert(json);\n          deck.setProps(convertedJson);\n          break;\n\n        case 'json-with-binary':\n          convertedJson = jsonConverter.convert(json);\n          const binaryData = transport.jupyterModel.get('data_buffer');\n          const propsWithBinary = processDataBuffer({\n            binary: binaryData,\n            convertedJson\n          });\n          deck.setProps(propsWithBinary);\n          break;\n\n        default:\n        // console.warn(type)\n      }\n    }\n  });\n}\n\n// HELPER FUNCTIONS\n\n// Takes JSON props and combines them with the binary data buffer\nexport function processDataBuffer({binary, convertedJson}) {\n  for (let i = 0; i < convertedJson.layers.length; i++) {\n    const layerId = convertedJson.layers[i].id;\n    const layer = convertedJson.layers[i];\n    // Replace data on every layer prop\n    convertedJson.layers[i] = layer.clone({data: binary[layerId]});\n  }\n  return convertedJson;\n}\n\n// Filters circular references on JSON string conversion\nfunction filterJsonValue(key, value) {\n  return value instanceof deckBundle.Layer ? value.id : value;\n}\n\n// Handles a general event\nfunction sendEventViaTransport(transport, eventName, data) {\n  if (eventName === 'hover' && !data.picked && data.index === -1) {\n    // TODO handle background hover events, for now we'll skip them\n    return;\n  }\n\n  // TODO Remove circular references without converting to a string\n  const deckEvent = JSON.parse(JSON.stringify(data, filterJsonValue));\n\n  // Note: transport.sendJSONMessage now filters circular references\n  transport.sendJSONMessage(eventName, deckEvent);\n}\n\n// Get non-deck \"playground\" props\n// TODO: hack we are accessing model directly\n// TODO - these inputs can be passed as top-level JSON props, no need to add custom model fields\n\nfunction getPlaygroundProps(transport) {\n  const {jupyterModel} = transport;\n  if (!jupyterModel) {\n    throw new Error('deck.gl playground currently only works with the Jupyter Widget Transport');\n  }\n\n  return {\n    width: jupyterModel.get('width'),\n    height: jupyterModel.get('height'),\n    customLibraries: jupyterModel.get('custom_libraries'),\n    mapboxApiKey: jupyterModel.get('mapbox_key'),\n    jsonInput: jupyterModel.get('json_input'),\n    tooltip: jupyterModel.get('tooltip')\n  };\n}\n","export {initPlayground} from './playground';\n\n// For to_html()...\nexport {createDeck, updateDeck} from './create-deck';\n","import Geometry from '../geometry/geometry';\nimport { uid } from '@luma.gl/webgl';\nconst CUBE_INDICES = new Uint16Array([0, 1, 2, 0, 2, 3, 4, 5, 6, 4, 6, 7, 8, 9, 10, 8, 10, 11, 12, 13, 14, 12, 14, 15, 16, 17, 18, 16, 18, 19, 20, 21, 22, 20, 22, 23]);\nconst CUBE_POSITIONS = new Float32Array([-1, -1, 1, 1, -1, 1, 1, 1, 1, -1, 1, 1, -1, -1, -1, -1, 1, -1, 1, 1, -1, 1, -1, -1, -1, 1, -1, -1, 1, 1, 1, 1, 1, 1, 1, -1, -1, -1, -1, 1, -1, -1, 1, -1, 1, -1, -1, 1, 1, -1, -1, 1, 1, -1, 1, 1, 1, 1, -1, 1, -1, -1, -1, -1, -1, 1, -1, 1, 1, -1, 1, -1]);\nconst CUBE_NORMALS = new Float32Array([0, 0, 1, 0, 0, 1, 0, 0, 1, 0, 0, 1, 0, 0, -1, 0, 0, -1, 0, 0, -1, 0, 0, -1, 0, 1, 0, 0, 1, 0, 0, 1, 0, 0, 1, 0, 0, -1, 0, 0, -1, 0, 0, -1, 0, 0, -1, 0, 1, 0, 0, 1, 0, 0, 1, 0, 0, 1, 0, 0, -1, 0, 0, -1, 0, 0, -1, 0, 0, -1, 0, 0]);\nconst CUBE_TEX_COORDS = new Float32Array([0, 0, 1, 0, 1, 1, 0, 1, 1, 0, 1, 1, 0, 1, 0, 0, 0, 1, 0, 0, 1, 0, 1, 1, 1, 1, 0, 1, 0, 0, 1, 0, 1, 0, 1, 1, 0, 1, 0, 0, 0, 0, 1, 0, 1, 1, 0, 1]);\nconst ATTRIBUTES = {\n  POSITION: {\n    size: 3,\n    value: new Float32Array(CUBE_POSITIONS)\n  },\n  NORMAL: {\n    size: 3,\n    value: new Float32Array(CUBE_NORMALS)\n  },\n  TEXCOORD_0: {\n    size: 2,\n    value: new Float32Array(CUBE_TEX_COORDS)\n  }\n};\nexport default class CubeGeometry extends Geometry {\n  constructor() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      id = uid('cube-geometry')\n    } = props;\n    super({ ...props,\n      id,\n      indices: {\n        size: 1,\n        value: new Uint16Array(CUBE_INDICES)\n      },\n      attributes: { ...ATTRIBUTES,\n        ...props.attributes\n      }\n    });\n  }\n\n}\n//# sourceMappingURL=cube-geometry.js.map","import checkIfBrowser from '../lib/is-browser';\nexport { self, window, global, document, process, console } from '../lib/globals';\nexport const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'untranspiled source';\nexport const isBrowser = checkIfBrowser();\n//# sourceMappingURL=globals.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\n\nfunction getStorage(type) {\n  try {\n    const storage = window[type];\n    const x = '__storage_test__';\n    storage.setItem(x, x);\n    storage.removeItem(x);\n    return storage;\n  } catch (e) {\n    return null;\n  }\n}\n\nexport default class LocalStorage {\n  constructor(id) {\n    let defaultSettings = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    let type = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'sessionStorage';\n\n    _defineProperty(this, \"storage\", void 0);\n\n    _defineProperty(this, \"id\", void 0);\n\n    _defineProperty(this, \"config\", {});\n\n    this.storage = getStorage(type);\n    this.id = id;\n    this.config = {};\n    Object.assign(this.config, defaultSettings);\n\n    this._loadConfiguration();\n  }\n\n  getConfiguration() {\n    return this.config;\n  }\n\n  setConfiguration(configuration) {\n    this.config = {};\n    return this.updateConfiguration(configuration);\n  }\n\n  updateConfiguration(configuration) {\n    Object.assign(this.config, configuration);\n\n    if (this.storage) {\n      const serialized = JSON.stringify(this.config);\n      this.storage.setItem(this.id, serialized);\n    }\n\n    return this;\n  }\n\n  _loadConfiguration() {\n    let configuration = {};\n\n    if (this.storage) {\n      const serializedConfiguration = this.storage.getItem(this.id);\n      configuration = serializedConfiguration ? JSON.parse(serializedConfiguration) : {};\n    }\n\n    Object.assign(this.config, configuration);\n    return this;\n  }\n\n}\n//# sourceMappingURL=local-storage.js.map","export function formatTime(ms) {\n  let formatted;\n\n  if (ms < 10) {\n    formatted = \"\".concat(ms.toFixed(2), \"ms\");\n  } else if (ms < 100) {\n    formatted = \"\".concat(ms.toFixed(1), \"ms\");\n  } else if (ms < 1000) {\n    formatted = \"\".concat(ms.toFixed(0), \"ms\");\n  } else {\n    formatted = \"\".concat((ms / 1000).toFixed(2), \"s\");\n  }\n\n  return formatted;\n}\nexport function leftPad(string) {\n  let length = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 8;\n  const padLength = Math.max(length - string.length, 0);\n  return \"\".concat(' '.repeat(padLength)).concat(string);\n}\nexport function rightPad(string) {\n  let length = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 8;\n  const padLength = Math.max(length - string.length, 0);\n  return \"\".concat(string).concat(' '.repeat(padLength));\n}\nexport function formatValue(v) {\n  let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n  const EPSILON = 1e-16;\n  const {\n    isInteger = false\n  } = opts;\n\n  if (Array.isArray(v) || ArrayBuffer.isView(v)) {\n    return formatArrayValue(v, opts);\n  }\n\n  if (!Number.isFinite(v)) {\n    return String(v);\n  }\n\n  if (Math.abs(v) < EPSILON) {\n    return isInteger ? '0' : '0.';\n  }\n\n  if (isInteger) {\n    return v.toFixed(0);\n  }\n\n  if (Math.abs(v) > 100 && Math.abs(v) < 10000) {\n    return v.toFixed(0);\n  }\n\n  const string = v.toPrecision(2);\n  const decimal = string.indexOf('.0');\n  return decimal === string.length - 2 ? string.slice(0, -1) : string;\n}\n\nfunction formatArrayValue(v, opts) {\n  const {\n    maxElts = 16,\n    size = 1\n  } = opts;\n  let string = '[';\n\n  for (let i = 0; i < v.length && i < maxElts; ++i) {\n    if (i > 0) {\n      string += \",\".concat(i % size === 0 ? ' ' : '');\n    }\n\n    string += formatValue(v[i], opts);\n  }\n\n  const terminator = v.length > maxElts ? '...' : ']';\n  return \"\".concat(string).concat(terminator);\n}\n\nexport function formatImage(image, message, scale) {\n  let maxWidth = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 600;\n  const imageUrl = image.src.replace(/\\(/g, '%28').replace(/\\)/g, '%29');\n\n  if (image.width > maxWidth) {\n    scale = Math.min(scale, maxWidth / image.width);\n  }\n\n  const width = image.width * scale;\n  const height = image.height * scale;\n  const style = ['font-size:1px;', \"padding:\".concat(Math.floor(height / 2), \"px \").concat(Math.floor(width / 2), \"px;\"), \"line-height:\".concat(height, \"px;\"), \"background:url(\".concat(imageUrl, \");\"), \"background-size:\".concat(width, \"px \").concat(height, \"px;\"), 'color:transparent;'].join('');\n  return [\"\".concat(message, \" %c+\"), style];\n}\n//# sourceMappingURL=formatters.js.map","import { isBrowser } from '@probe.gl/env';\nexport let COLOR;\n\n(function (COLOR) {\n  COLOR[COLOR[\"BLACK\"] = 30] = \"BLACK\";\n  COLOR[COLOR[\"RED\"] = 31] = \"RED\";\n  COLOR[COLOR[\"GREEN\"] = 32] = \"GREEN\";\n  COLOR[COLOR[\"YELLOW\"] = 33] = \"YELLOW\";\n  COLOR[COLOR[\"BLUE\"] = 34] = \"BLUE\";\n  COLOR[COLOR[\"MAGENTA\"] = 35] = \"MAGENTA\";\n  COLOR[COLOR[\"CYAN\"] = 36] = \"CYAN\";\n  COLOR[COLOR[\"WHITE\"] = 37] = \"WHITE\";\n  COLOR[COLOR[\"BRIGHT_BLACK\"] = 90] = \"BRIGHT_BLACK\";\n  COLOR[COLOR[\"BRIGHT_RED\"] = 91] = \"BRIGHT_RED\";\n  COLOR[COLOR[\"BRIGHT_GREEN\"] = 92] = \"BRIGHT_GREEN\";\n  COLOR[COLOR[\"BRIGHT_YELLOW\"] = 93] = \"BRIGHT_YELLOW\";\n  COLOR[COLOR[\"BRIGHT_BLUE\"] = 94] = \"BRIGHT_BLUE\";\n  COLOR[COLOR[\"BRIGHT_MAGENTA\"] = 95] = \"BRIGHT_MAGENTA\";\n  COLOR[COLOR[\"BRIGHT_CYAN\"] = 96] = \"BRIGHT_CYAN\";\n  COLOR[COLOR[\"BRIGHT_WHITE\"] = 97] = \"BRIGHT_WHITE\";\n})(COLOR || (COLOR = {}));\n\nfunction getColor(color) {\n  return typeof color === 'string' ? COLOR[color.toUpperCase()] || COLOR.WHITE : color;\n}\n\nexport function addColor(string, color, background) {\n  if (!isBrowser && typeof string === 'string') {\n    if (color) {\n      color = getColor(color);\n      string = \"\\x1B[\".concat(color, \"m\").concat(string, \"\\x1B[39m\");\n    }\n\n    if (background) {\n      color = getColor(background);\n      string = \"\\x1B[\".concat(background + 10, \"m\").concat(string, \"\\x1B[49m\");\n    }\n  }\n\n  return string;\n}\n//# sourceMappingURL=color.js.map","export default function assert(condition, message) {\n  if (!condition) {\n    throw new Error(message || 'Assertion failed');\n  }\n}\n//# sourceMappingURL=assert.js.map","import { window, process, isBrowser } from '@probe.gl/env';\nexport function getHiResTimestamp() {\n  let timestamp;\n\n  if (isBrowser && 'performance' in window) {\n    var _window$performance, _window$performance$n;\n\n    timestamp = window === null || window === void 0 ? void 0 : (_window$performance = window.performance) === null || _window$performance === void 0 ? void 0 : (_window$performance$n = _window$performance.now) === null || _window$performance$n === void 0 ? void 0 : _window$performance$n.call(_window$performance);\n  } else if ('hrtime' in process) {\n    var _process$hrtime;\n\n    const timeParts = process === null || process === void 0 ? void 0 : (_process$hrtime = process.hrtime) === null || _process$hrtime === void 0 ? void 0 : _process$hrtime.call(process);\n    timestamp = timeParts[0] * 1000 + timeParts[1] / 1e6;\n  } else {\n    timestamp = Date.now();\n  }\n\n  return timestamp;\n}\n//# sourceMappingURL=hi-res-timestamp.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { VERSION, isBrowser } from '@probe.gl/env';\nimport LocalStorage from './utils/local-storage';\nimport { formatImage, formatTime, leftPad } from './utils/formatters';\nimport { addColor } from './utils/color';\nimport { autobind } from './utils/autobind';\nimport assert from './utils/assert';\nimport { getHiResTimestamp } from './utils/hi-res-timestamp';\nconst originalConsole = {\n  debug: isBrowser ? console.debug || console.log : console.log,\n  log: console.log,\n  info: console.info,\n  warn: console.warn,\n  error: console.error\n};\nconst DEFAULT_SETTINGS = {\n  enabled: true,\n  level: 0\n};\n\nfunction noop() {}\n\nconst cache = {};\nconst ONCE = {\n  once: true\n};\nexport default class Log {\n  constructor() {\n    let {\n      id\n    } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {\n      id: ''\n    };\n\n    _defineProperty(this, \"id\", void 0);\n\n    _defineProperty(this, \"VERSION\", VERSION);\n\n    _defineProperty(this, \"_startTs\", getHiResTimestamp());\n\n    _defineProperty(this, \"_deltaTs\", getHiResTimestamp());\n\n    _defineProperty(this, \"_storage\", void 0);\n\n    _defineProperty(this, \"userData\", {});\n\n    _defineProperty(this, \"LOG_THROTTLE_TIMEOUT\", 0);\n\n    this.id = id;\n    this._storage = new LocalStorage(\"__probe-\".concat(this.id, \"__\"), DEFAULT_SETTINGS);\n    this.userData = {};\n    this.timeStamp(\"\".concat(this.id, \" started\"));\n    autobind(this);\n    Object.seal(this);\n  }\n\n  set level(newLevel) {\n    this.setLevel(newLevel);\n  }\n\n  get level() {\n    return this.getLevel();\n  }\n\n  isEnabled() {\n    return this._storage.config.enabled;\n  }\n\n  getLevel() {\n    return this._storage.config.level;\n  }\n\n  getTotal() {\n    return Number((getHiResTimestamp() - this._startTs).toPrecision(10));\n  }\n\n  getDelta() {\n    return Number((getHiResTimestamp() - this._deltaTs).toPrecision(10));\n  }\n\n  set priority(newPriority) {\n    this.level = newPriority;\n  }\n\n  get priority() {\n    return this.level;\n  }\n\n  getPriority() {\n    return this.level;\n  }\n\n  enable() {\n    let enabled = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;\n\n    this._storage.updateConfiguration({\n      enabled\n    });\n\n    return this;\n  }\n\n  setLevel(level) {\n    this._storage.updateConfiguration({\n      level\n    });\n\n    return this;\n  }\n\n  get(setting) {\n    return this._storage.config[setting];\n  }\n\n  set(setting, value) {\n    this._storage.updateConfiguration({\n      [setting]: value\n    });\n  }\n\n  settings() {\n    if (console.table) {\n      console.table(this._storage.config);\n    } else {\n      console.log(this._storage.config);\n    }\n  }\n\n  assert(condition, message) {\n    assert(condition, message);\n  }\n\n  warn(message) {\n    return this._getLogFunction(0, message, originalConsole.warn, arguments, ONCE);\n  }\n\n  error(message) {\n    return this._getLogFunction(0, message, originalConsole.error, arguments);\n  }\n\n  deprecated(oldUsage, newUsage) {\n    return this.warn(\"`\".concat(oldUsage, \"` is deprecated and will be removed in a later version. Use `\").concat(newUsage, \"` instead\"));\n  }\n\n  removed(oldUsage, newUsage) {\n    return this.error(\"`\".concat(oldUsage, \"` has been removed. Use `\").concat(newUsage, \"` instead\"));\n  }\n\n  probe(logLevel, message) {\n    return this._getLogFunction(logLevel, message, originalConsole.log, arguments, {\n      time: true,\n      once: true\n    });\n  }\n\n  log(logLevel, message) {\n    return this._getLogFunction(logLevel, message, originalConsole.debug, arguments);\n  }\n\n  info(logLevel, message) {\n    return this._getLogFunction(logLevel, message, console.info, arguments);\n  }\n\n  once(logLevel, message) {\n    for (var _len = arguments.length, args = new Array(_len > 2 ? _len - 2 : 0), _key = 2; _key < _len; _key++) {\n      args[_key - 2] = arguments[_key];\n    }\n\n    return this._getLogFunction(logLevel, message, originalConsole.debug || originalConsole.info, arguments, ONCE);\n  }\n\n  table(logLevel, table, columns) {\n    if (table) {\n      return this._getLogFunction(logLevel, table, console.table || noop, columns && [columns], {\n        tag: getTableHeader(table)\n      });\n    }\n\n    return noop;\n  }\n\n  image(_ref) {\n    let {\n      logLevel,\n      priority,\n      image,\n      message = '',\n      scale = 1\n    } = _ref;\n\n    if (!this._shouldLog(logLevel || priority)) {\n      return noop;\n    }\n\n    return isBrowser ? logImageInBrowser({\n      image,\n      message,\n      scale\n    }) : logImageInNode({\n      image,\n      message,\n      scale\n    });\n  }\n\n  time(logLevel, message) {\n    return this._getLogFunction(logLevel, message, console.time ? console.time : console.info);\n  }\n\n  timeEnd(logLevel, message) {\n    return this._getLogFunction(logLevel, message, console.timeEnd ? console.timeEnd : console.info);\n  }\n\n  timeStamp(logLevel, message) {\n    return this._getLogFunction(logLevel, message, console.timeStamp || noop);\n  }\n\n  group(logLevel, message) {\n    let opts = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {\n      collapsed: false\n    };\n    const options = normalizeArguments({\n      logLevel,\n      message,\n      opts\n    });\n    const {\n      collapsed\n    } = opts;\n    options.method = (collapsed ? console.groupCollapsed : console.group) || console.info;\n    return this._getLogFunction(options);\n  }\n\n  groupCollapsed(logLevel, message) {\n    let opts = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};\n    return this.group(logLevel, message, Object.assign({}, opts, {\n      collapsed: true\n    }));\n  }\n\n  groupEnd(logLevel) {\n    return this._getLogFunction(logLevel, '', console.groupEnd || noop);\n  }\n\n  withGroup(logLevel, message, func) {\n    this.group(logLevel, message)();\n\n    try {\n      func();\n    } finally {\n      this.groupEnd(logLevel)();\n    }\n  }\n\n  trace() {\n    if (console.trace) {\n      console.trace();\n    }\n  }\n\n  _shouldLog(logLevel) {\n    return this.isEnabled() && this.getLevel() >= normalizeLogLevel(logLevel);\n  }\n\n  _getLogFunction(logLevel, message, method, args, opts) {\n    if (this._shouldLog(logLevel)) {\n      opts = normalizeArguments({\n        logLevel,\n        message,\n        args,\n        opts\n      });\n      method = method || opts.method;\n      assert(method);\n      opts.total = this.getTotal();\n      opts.delta = this.getDelta();\n      this._deltaTs = getHiResTimestamp();\n      const tag = opts.tag || opts.message;\n\n      if (opts.once) {\n        if (!cache[tag]) {\n          cache[tag] = getHiResTimestamp();\n        } else {\n          return noop;\n        }\n      }\n\n      message = decorateMessage(this.id, opts.message, opts);\n      return method.bind(console, message, ...opts.args);\n    }\n\n    return noop;\n  }\n\n}\n\n_defineProperty(Log, \"VERSION\", VERSION);\n\nfunction normalizeLogLevel(logLevel) {\n  if (!logLevel) {\n    return 0;\n  }\n\n  let resolvedLevel;\n\n  switch (typeof logLevel) {\n    case 'number':\n      resolvedLevel = logLevel;\n      break;\n\n    case 'object':\n      resolvedLevel = logLevel.logLevel || logLevel.priority || 0;\n      break;\n\n    default:\n      return 0;\n  }\n\n  assert(Number.isFinite(resolvedLevel) && resolvedLevel >= 0);\n  return resolvedLevel;\n}\n\nexport function normalizeArguments(opts) {\n  const {\n    logLevel,\n    message\n  } = opts;\n  opts.logLevel = normalizeLogLevel(logLevel);\n  const args = opts.args ? Array.from(opts.args) : [];\n\n  while (args.length && args.shift() !== message) {}\n\n  switch (typeof logLevel) {\n    case 'string':\n    case 'function':\n      if (message !== undefined) {\n        args.unshift(message);\n      }\n\n      opts.message = logLevel;\n      break;\n\n    case 'object':\n      Object.assign(opts, logLevel);\n      break;\n\n    default:\n  }\n\n  if (typeof opts.message === 'function') {\n    opts.message = opts.message();\n  }\n\n  const messageType = typeof opts.message;\n  assert(messageType === 'string' || messageType === 'object');\n  return Object.assign(opts, {\n    args\n  }, opts.opts);\n}\n\nfunction decorateMessage(id, message, opts) {\n  if (typeof message === 'string') {\n    const time = opts.time ? leftPad(formatTime(opts.total)) : '';\n    message = opts.time ? \"\".concat(id, \": \").concat(time, \"  \").concat(message) : \"\".concat(id, \": \").concat(message);\n    message = addColor(message, opts.color, opts.background);\n  }\n\n  return message;\n}\n\nfunction logImageInNode(_ref2) {\n  let {\n    image,\n    message = '',\n    scale = 1\n  } = _ref2;\n  let asciify = null;\n\n  try {\n    asciify = module.require('asciify-image');\n  } catch (error) {}\n\n  if (asciify) {\n    return () => asciify(image, {\n      fit: 'box',\n      width: \"\".concat(Math.round(80 * scale), \"%\")\n    }).then(data => console.log(data));\n  }\n\n  return noop;\n}\n\nfunction logImageInBrowser(_ref3) {\n  let {\n    image,\n    message = '',\n    scale = 1\n  } = _ref3;\n\n  if (typeof image === 'string') {\n    const img = new Image();\n\n    img.onload = () => {\n      const args = formatImage(img, message, scale);\n      console.log(...args);\n    };\n\n    img.src = image;\n    return noop;\n  }\n\n  const element = image.nodeName || '';\n\n  if (element.toLowerCase() === 'img') {\n    console.log(...formatImage(image, message, scale));\n    return noop;\n  }\n\n  if (element.toLowerCase() === 'canvas') {\n    const img = new Image();\n\n    img.onload = () => console.log(...formatImage(img, message, scale));\n\n    img.src = image.toDataURL();\n    return noop;\n  }\n\n  return noop;\n}\n\nfunction getTableHeader(table) {\n  for (const key in table) {\n    for (const title in table[key]) {\n      return title || 'untitled';\n    }\n  }\n\n  return 'empty';\n}\n//# sourceMappingURL=log.js.map","export function autobind(obj) {\n  let predefined = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ['constructor'];\n  const proto = Object.getPrototypeOf(obj);\n  const propNames = Object.getOwnPropertyNames(proto);\n\n  for (const key of propNames) {\n    if (typeof obj[key] === 'function') {\n      if (!predefined.find(name => key === name)) {\n        obj[key] = obj[key].bind(obj);\n      }\n    }\n  }\n}\n//# sourceMappingURL=autobind.js.map","import isBrowser from './is-browser';\nimport isElectron from './is-electron';\nconst window = globalThis;\nexport function isMobile() {\n  return typeof window.orientation !== 'undefined';\n}\nexport default function getBrowser(mockUserAgent) {\n  if (!mockUserAgent && !isBrowser()) {\n    return 'Node';\n  }\n\n  if (isElectron(mockUserAgent)) {\n    return 'Electron';\n  }\n\n  const navigator_ = typeof navigator !== 'undefined' ? navigator : {};\n  const userAgent = mockUserAgent || navigator_.userAgent || '';\n\n  if (userAgent.indexOf('Edge') > -1) {\n    return 'Edge';\n  }\n\n  const isMSIE = userAgent.indexOf('MSIE ') !== -1;\n  const isTrident = userAgent.indexOf('Trident/') !== -1;\n\n  if (isMSIE || isTrident) {\n    return 'IE';\n  }\n\n  if (window.chrome) {\n    return 'Chrome';\n  }\n\n  if (window.safari) {\n    return 'Safari';\n  }\n\n  if (window.mozInnerScreenX) {\n    return 'Firefox';\n  }\n\n  return 'Unknown';\n}\n//# sourceMappingURL=get-browser.js.map","import { isWebGL2, assertWebGL2Context, log } from '@luma.gl/gltools';\nimport Resource from './resource';\nimport Buffer from './buffer';\nimport { isObjectEmpty } from '../utils/utils';\nexport default class TransformFeedback extends Resource {\n  get [Symbol.toStringTag]() {\n    return 'TransformFeedback';\n  }\n\n  static isSupported(gl) {\n    return isWebGL2(gl);\n  }\n\n  constructor(gl) {\n    let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    assertWebGL2Context(gl);\n    super(gl, props);\n    this.initialize(props);\n    this.stubRemovedMethods('TransformFeedback', 'v6.0', ['pause', 'resume']);\n    Object.seal(this);\n  }\n\n  initialize() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    this.buffers = {};\n    this.unused = {};\n    this.configuration = null;\n    this.bindOnUse = true;\n\n    if (!isObjectEmpty(this.buffers)) {\n      this.bind(() => this._unbindBuffers());\n    }\n\n    this.setProps(props);\n    return this;\n  }\n\n  setProps(props) {\n    if ('program' in props) {\n      this.configuration = props.program && props.program.configuration;\n    }\n\n    if ('configuration' in props) {\n      this.configuration = props.configuration;\n    }\n\n    if ('bindOnUse' in props) {\n      props = props.bindOnUse;\n    }\n\n    if ('buffers' in props) {\n      this.setBuffers(props.buffers);\n    }\n  }\n\n  setBuffers() {\n    let buffers = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    this.bind(() => {\n      for (const bufferName in buffers) {\n        this.setBuffer(bufferName, buffers[bufferName]);\n      }\n    });\n    return this;\n  }\n\n  setBuffer(locationOrName, bufferOrParams) {\n    const location = this._getVaryingIndex(locationOrName);\n\n    const {\n      buffer,\n      byteSize,\n      byteOffset\n    } = this._getBufferParams(bufferOrParams);\n\n    if (location < 0) {\n      this.unused[locationOrName] = buffer;\n      log.warn(\"\".concat(this.id, \" unused varying buffer \").concat(locationOrName))();\n      return this;\n    }\n\n    this.buffers[location] = bufferOrParams;\n\n    if (!this.bindOnUse) {\n      this._bindBuffer(location, buffer, byteOffset, byteSize);\n    }\n\n    return this;\n  }\n\n  begin() {\n    let primitiveMode = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;\n    this.gl.bindTransformFeedback(36386, this.handle);\n\n    this._bindBuffers();\n\n    this.gl.beginTransformFeedback(primitiveMode);\n    return this;\n  }\n\n  end() {\n    this.gl.endTransformFeedback();\n\n    this._unbindBuffers();\n\n    this.gl.bindTransformFeedback(36386, null);\n    return this;\n  }\n\n  _getBufferParams(bufferOrParams) {\n    let byteOffset;\n    let byteSize;\n    let buffer;\n\n    if (bufferOrParams instanceof Buffer === false) {\n      buffer = bufferOrParams.buffer;\n      byteSize = bufferOrParams.byteSize;\n      byteOffset = bufferOrParams.byteOffset;\n    } else {\n      buffer = bufferOrParams;\n    }\n\n    if (byteOffset !== undefined || byteSize !== undefined) {\n      byteOffset = byteOffset || 0;\n      byteSize = byteSize || buffer.byteLength - byteOffset;\n    }\n\n    return {\n      buffer,\n      byteOffset,\n      byteSize\n    };\n  }\n\n  _getVaryingInfo(locationOrName) {\n    return this.configuration && this.configuration.getVaryingInfo(locationOrName);\n  }\n\n  _getVaryingIndex(locationOrName) {\n    if (this.configuration) {\n      return this.configuration.getVaryingInfo(locationOrName).location;\n    }\n\n    const location = Number(locationOrName);\n    return Number.isFinite(location) ? location : -1;\n  }\n\n  _bindBuffers() {\n    if (this.bindOnUse) {\n      for (const bufferIndex in this.buffers) {\n        const {\n          buffer,\n          byteSize,\n          byteOffset\n        } = this._getBufferParams(this.buffers[bufferIndex]);\n\n        this._bindBuffer(bufferIndex, buffer, byteOffset, byteSize);\n      }\n    }\n  }\n\n  _unbindBuffers() {\n    if (this.bindOnUse) {\n      for (const bufferIndex in this.buffers) {\n        this._bindBuffer(bufferIndex, null);\n      }\n    }\n  }\n\n  _bindBuffer(index, buffer) {\n    let byteOffset = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;\n    let byteSize = arguments.length > 3 ? arguments[3] : undefined;\n    const handle = buffer && buffer.handle;\n\n    if (!handle || byteSize === undefined) {\n      this.gl.bindBufferBase(35982, index, handle);\n    } else {\n      this.gl.bindBufferRange(35982, index, handle, byteOffset, byteSize);\n    }\n\n    return this;\n  }\n\n  _createHandle() {\n    return this.gl.createTransformFeedback();\n  }\n\n  _deleteHandle() {\n    this.gl.deleteTransformFeedback(this.handle);\n  }\n\n  _bindHandle(handle) {\n    this.gl.bindTransformFeedback(36386, this.handle);\n  }\n\n}\n//# sourceMappingURL=transform-feedback.js.map","let channelHandles = 1;\nlet animationHandles = 1;\nexport class Timeline {\n  constructor() {\n    this.time = 0;\n    this.channels = new Map();\n    this.animations = new Map();\n    this.playing = false;\n    this.lastEngineTime = -1;\n  }\n\n  addChannel(props) {\n    const {\n      delay = 0,\n      duration = Number.POSITIVE_INFINITY,\n      rate = 1,\n      repeat = 1\n    } = props;\n    const handle = channelHandles++;\n    const channel = {\n      time: 0,\n      delay,\n      duration,\n      rate,\n      repeat\n    };\n\n    this._setChannelTime(channel, this.time);\n\n    this.channels.set(handle, channel);\n    return handle;\n  }\n\n  removeChannel(handle) {\n    this.channels.delete(handle);\n\n    for (const [animationHandle, animation] of this.animations) {\n      if (animation.channel === handle) {\n        this.detachAnimation(animationHandle);\n      }\n    }\n  }\n\n  isFinished(handle) {\n    const channel = this.channels.get(handle);\n\n    if (channel === undefined) {\n      return false;\n    }\n\n    return this.time >= channel.delay + channel.duration * channel.repeat;\n  }\n\n  getTime(handle) {\n    if (handle === undefined) {\n      return this.time;\n    }\n\n    const channel = this.channels.get(handle);\n\n    if (channel === undefined) {\n      return -1;\n    }\n\n    return channel.time;\n  }\n\n  setTime(time) {\n    this.time = Math.max(0, time);\n    const channels = this.channels.values();\n\n    for (const channel of channels) {\n      this._setChannelTime(channel, this.time);\n    }\n\n    const animations = this.animations.values();\n\n    for (const animationData of animations) {\n      const {\n        animation,\n        channel\n      } = animationData;\n      animation.setTime(this.getTime(channel));\n    }\n  }\n\n  play() {\n    this.playing = true;\n  }\n\n  pause() {\n    this.playing = false;\n    this.lastEngineTime = -1;\n  }\n\n  reset() {\n    this.setTime(0);\n  }\n\n  attachAnimation(animation, channelHandle) {\n    const animationHandle = animationHandles++;\n    this.animations.set(animationHandle, {\n      animation,\n      channel: channelHandle\n    });\n    animation.setTime(this.getTime(channelHandle));\n    return animationHandle;\n  }\n\n  detachAnimation(handle) {\n    this.animations.delete(handle);\n  }\n\n  update(engineTime) {\n    if (this.playing) {\n      if (this.lastEngineTime === -1) {\n        this.lastEngineTime = engineTime;\n      }\n\n      this.setTime(this.time + (engineTime - this.lastEngineTime));\n      this.lastEngineTime = engineTime;\n    }\n  }\n\n  _setChannelTime(channel, time) {\n    const offsetTime = time - channel.delay;\n    const totalDuration = channel.duration * channel.repeat;\n\n    if (offsetTime >= totalDuration) {\n      channel.time = channel.duration * channel.rate;\n    } else {\n      channel.time = Math.max(0, offsetTime) % channel.duration;\n      channel.time *= channel.rate;\n    }\n  }\n\n}\n//# sourceMappingURL=timeline.js.map","import Vector from './base/vector';\nimport { config, isArray } from '../lib/common';\nimport { checkNumber } from '../lib/validators';\nimport * as vec2 from 'gl-matrix/vec2';\nimport { vec2_transformMat4AsVector } from '../lib/gl-matrix-extras';\nexport default class Vector2 extends Vector {\n  constructor(x = 0, y = 0) {\n    super(2);\n\n    if (isArray(x) && arguments.length === 1) {\n      this.copy(x);\n    } else {\n      if (config.debug) {\n        checkNumber(x);\n        checkNumber(y);\n      }\n\n      this[0] = x;\n      this[1] = y;\n    }\n  }\n\n  set(x, y) {\n    this[0] = x;\n    this[1] = y;\n    return this.check();\n  }\n\n  copy(array) {\n    this[0] = array[0];\n    this[1] = array[1];\n    return this.check();\n  }\n\n  fromObject(object) {\n    if (config.debug) {\n      checkNumber(object.x);\n      checkNumber(object.y);\n    }\n\n    this[0] = object.x;\n    this[1] = object.y;\n    return this.check();\n  }\n\n  toObject(object) {\n    object.x = this[0];\n    object.y = this[1];\n    return object;\n  }\n\n  get ELEMENTS() {\n    return 2;\n  }\n\n  horizontalAngle() {\n    return Math.atan2(this.y, this.x);\n  }\n\n  verticalAngle() {\n    return Math.atan2(this.x, this.y);\n  }\n\n  transform(matrix4) {\n    return this.transformAsPoint(matrix4);\n  }\n\n  transformAsPoint(matrix4) {\n    vec2.transformMat4(this, this, matrix4);\n    return this.check();\n  }\n\n  transformAsVector(matrix4) {\n    vec2_transformMat4AsVector(this, this, matrix4);\n    return this.check();\n  }\n\n  transformByMatrix3(matrix3) {\n    vec2.transformMat3(this, this, matrix3);\n    return this.check();\n  }\n\n  transformByMatrix2x3(matrix2x3) {\n    vec2.transformMat2d(this, this, matrix2x3);\n    return this.check();\n  }\n\n  transformByMatrix2(matrix2) {\n    vec2.transformMat2(this, this, matrix2);\n    return this.check();\n  }\n\n}\n//# sourceMappingURL=vector2.js.map","import { global, isBrowser, isWorker } from '../env-utils/globals';\nimport * as node from '../node/require-utils.node';\nimport { assert } from '../env-utils/assert';\nimport { VERSION as __VERSION__ } from '../env-utils/version';\nconst LATEST = 'latest';\nconst VERSION = typeof \"3.2.10\" !== 'undefined' ? \"3.2.10\" : LATEST;\nconst loadLibraryPromises = {};\nexport async function loadLibrary(libraryUrl, moduleName = null, options = {}) {\n  if (moduleName) {\n    libraryUrl = getLibraryUrl(libraryUrl, moduleName, options);\n  }\n\n  loadLibraryPromises[libraryUrl] = loadLibraryPromises[libraryUrl] || loadLibraryFromFile(libraryUrl);\n  return await loadLibraryPromises[libraryUrl];\n}\nexport function getLibraryUrl(library, moduleName, options) {\n  if (library.startsWith('http')) {\n    return library;\n  }\n\n  const modules = options.modules || {};\n\n  if (modules[library]) {\n    return modules[library];\n  }\n\n  if (!isBrowser) {\n    return \"modules/\".concat(moduleName, \"/dist/libs/\").concat(library);\n  }\n\n  if (options.CDN) {\n    assert(options.CDN.startsWith('http'));\n    return \"\".concat(options.CDN, \"/\").concat(moduleName, \"@\").concat(VERSION, \"/dist/libs/\").concat(library);\n  }\n\n  if (isWorker) {\n    return \"../src/libs/\".concat(library);\n  }\n\n  return \"modules/\".concat(moduleName, \"/src/libs/\").concat(library);\n}\n\nasync function loadLibraryFromFile(libraryUrl) {\n  if (libraryUrl.endsWith('wasm')) {\n    const response = await fetch(libraryUrl);\n    return await response.arrayBuffer();\n  }\n\n  if (!isBrowser) {\n    try {\n      return node && node.requireFromFile && (await node.requireFromFile(libraryUrl));\n    } catch {\n      return null;\n    }\n  }\n\n  if (isWorker) {\n    return importScripts(libraryUrl);\n  }\n\n  const response = await fetch(libraryUrl);\n  const scriptSource = await response.text();\n  return loadLibraryFromString(scriptSource, libraryUrl);\n}\n\nfunction loadLibraryFromString(scriptSource, id) {\n  if (!isBrowser) {\n    return node.requireFromString && node.requireFromString(scriptSource, id);\n  }\n\n  if (isWorker) {\n    eval.call(global, scriptSource);\n    return null;\n  }\n\n  const script = document.createElement('script');\n  script.id = id;\n\n  try {\n    script.appendChild(document.createTextNode(scriptSource));\n  } catch (e) {\n    script.text = scriptSource;\n  }\n\n  document.body.appendChild(script);\n  return null;\n}\n//# sourceMappingURL=library-utils.js.map","\n\nconst globals = {\n  self: typeof self !== 'undefined' && self,\n  window: typeof window !== 'undefined' && window,\n  global: typeof global !== 'undefined' && global,\n  document: typeof document !== 'undefined' && document\n};\nconst self_ = globals.self || globals.window || globals.global || {};\nconst window_ = globals.window || globals.self || globals.global || {};\nconst global_ = globals.global || globals.self || globals.window || {};\nconst document_ = globals.document || {};\nexport { self_ as self, window_ as window, global_ as global, document_ as document };\n\nexport const isBrowser =\nBoolean(typeof process !== 'object' || String(process) !== '[object process]' || process.browser);\n\nexport const isWorker = typeof importScripts === 'function';\n\nconst matches = typeof process !== 'undefined' && process.version && /v([0-9]*)/.exec(process.version);\nexport const nodeVersion = matches && parseFloat(matches[1]) || 0;\n//# sourceMappingURL=globals.js.map","const VERSION = typeof \"3.2.10\" !== 'undefined' ? \"3.2.10\" : 'beta';\nimport { loadLibrary } from '@loaders.gl/worker-utils';\nconst BASIS_CDN_ENCODER_WASM = \"https://unpkg.com/@loaders.gl/textures@\".concat(VERSION, \"/dist/libs/basis_encoder.wasm\");\nconst BASIS_CDN_ENCODER_JS = \"https://unpkg.com/@loaders.gl/textures@\".concat(VERSION, \"/dist/libs/basis_encoder.js\");\nlet loadBasisTranscoderPromise;\nexport async function loadBasisTrascoderModule(options) {\n  const modules = options.modules || {};\n\n  if (modules.basis) {\n    return modules.basis;\n  }\n\n  loadBasisTranscoderPromise = loadBasisTranscoderPromise || loadBasisTrascoder(options);\n  return await loadBasisTranscoderPromise;\n}\n\nasync function loadBasisTrascoder(options) {\n  let BASIS = null;\n  let wasmBinary = null;\n  [BASIS, wasmBinary] = await Promise.all([await loadLibrary('basis_transcoder.js', 'textures', options), await loadLibrary('basis_transcoder.wasm', 'textures', options)]);\n  BASIS = BASIS || globalThis.BASIS;\n  return await initializeBasisTrascoderModule(BASIS, wasmBinary);\n}\n\nfunction initializeBasisTrascoderModule(BasisModule, wasmBinary) {\n  const options = {};\n\n  if (wasmBinary) {\n    options.wasmBinary = wasmBinary;\n  }\n\n  return new Promise(resolve => {\n    BasisModule(options).then(module => {\n      const {\n        BasisFile,\n        initializeBasis\n      } = module;\n      initializeBasis();\n      resolve({\n        BasisFile\n      });\n    });\n  });\n}\n\nlet loadBasisEncoderPromise;\nexport async function loadBasisEncoderModule(options) {\n  const modules = options.modules || {};\n\n  if (modules.basisEncoder) {\n    return modules.basisEncoder;\n  }\n\n  loadBasisEncoderPromise = loadBasisEncoderPromise || loadBasisEncoder(options);\n  return await loadBasisEncoderPromise;\n}\n\nasync function loadBasisEncoder(options) {\n  let BASIS_ENCODER = null;\n  let wasmBinary = null;\n  [BASIS_ENCODER, wasmBinary] = await Promise.all([await loadLibrary(BASIS_CDN_ENCODER_JS, 'textures', options), await loadLibrary(BASIS_CDN_ENCODER_WASM, 'textures', options)]);\n  BASIS_ENCODER = BASIS_ENCODER || globalThis.BASIS;\n  return await initializeBasisEncoderModule(BASIS_ENCODER, wasmBinary);\n}\n\nfunction initializeBasisEncoderModule(BasisEncoderModule, wasmBinary) {\n  const options = {};\n\n  if (wasmBinary) {\n    options.wasmBinary = wasmBinary;\n  }\n\n  return new Promise(resolve => {\n    BasisEncoderModule(options).then(module => {\n      const {\n        BasisFile,\n        KTX2File,\n        initializeBasis,\n        BasisEncoder\n      } = module;\n      initializeBasis();\n      resolve({\n        BasisFile,\n        KTX2File,\n        BasisEncoder\n      });\n    });\n  });\n}\n//# sourceMappingURL=basis-module-loader.js.map","export const GL_EXTENSIONS_CONSTANTS = {\n  COMPRESSED_RGB_S3TC_DXT1_EXT: 0x83f0,\n  COMPRESSED_RGBA_S3TC_DXT1_EXT: 0x83f1,\n  COMPRESSED_RGBA_S3TC_DXT3_EXT: 0x83f2,\n  COMPRESSED_RGBA_S3TC_DXT5_EXT: 0x83f3,\n  COMPRESSED_R11_EAC: 0x9270,\n  COMPRESSED_SIGNED_R11_EAC: 0x9271,\n  COMPRESSED_RG11_EAC: 0x9272,\n  COMPRESSED_SIGNED_RG11_EAC: 0x9273,\n  COMPRESSED_RGB8_ETC2: 0x9274,\n  COMPRESSED_RGBA8_ETC2_EAC: 0x9275,\n  COMPRESSED_SRGB8_ETC2: 0x9276,\n  COMPRESSED_SRGB8_ALPHA8_ETC2_EAC: 0x9277,\n  COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2: 0x9278,\n  COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2: 0x9279,\n  COMPRESSED_RGB_PVRTC_4BPPV1_IMG: 0x8c00,\n  COMPRESSED_RGBA_PVRTC_4BPPV1_IMG: 0x8c02,\n  COMPRESSED_RGB_PVRTC_2BPPV1_IMG: 0x8c01,\n  COMPRESSED_RGBA_PVRTC_2BPPV1_IMG: 0x8c03,\n  COMPRESSED_RGB_ETC1_WEBGL: 0x8d64,\n  COMPRESSED_RGB_ATC_WEBGL: 0x8c92,\n  COMPRESSED_RGBA_ATC_EXPLICIT_ALPHA_WEBGL: 0x8c93,\n  COMPRESSED_RGBA_ATC_INTERPOLATED_ALPHA_WEBGL: 0x87ee,\n  COMPRESSED_RGBA_ASTC_4X4_KHR: 0x93b0,\n  COMPRESSED_RGBA_ASTC_5X4_KHR: 0x93b1,\n  COMPRESSED_RGBA_ASTC_5X5_KHR: 0x93b2,\n  COMPRESSED_RGBA_ASTC_6X5_KHR: 0x93b3,\n  COMPRESSED_RGBA_ASTC_6X6_KHR: 0x93b4,\n  COMPRESSED_RGBA_ASTC_8X5_KHR: 0x93b5,\n  COMPRESSED_RGBA_ASTC_8X6_KHR: 0x93b6,\n  COMPRESSED_RGBA_ASTC_8X8_KHR: 0x93b7,\n  COMPRESSED_RGBA_ASTC_10X5_KHR: 0x93b8,\n  COMPRESSED_RGBA_ASTC_10X6_KHR: 0x93b9,\n  COMPRESSED_RGBA_ASTC_10X8_KHR: 0x93ba,\n  COMPRESSED_RGBA_ASTC_10X10_KHR: 0x93bb,\n  COMPRESSED_RGBA_ASTC_12X10_KHR: 0x93bc,\n  COMPRESSED_RGBA_ASTC_12X12_KHR: 0x93bd,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_4X4_KHR: 0x93d0,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_5X4_KHR: 0x93d1,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_5X5_KHR: 0x93d2,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_6X5_KHR: 0x93d3,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_6X6_KHR: 0x93d4,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_8X5_KHR: 0x93d5,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_8X6_KHR: 0x93d6,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_8X8_KHR: 0x93d7,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_10X5_KHR: 0x93d8,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_10X6_KHR: 0x93d9,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_10X8_KHR: 0x93da,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_10X10_KHR: 0x93db,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_12X10_KHR: 0x93dc,\n  COMPRESSED_SRGB8_ALPHA8_ASTC_12X12_KHR: 0x93dd,\n  COMPRESSED_RED_RGTC1_EXT: 0x8dbb,\n  COMPRESSED_SIGNED_RED_RGTC1_EXT: 0x8dbc,\n  COMPRESSED_RED_GREEN_RGTC2_EXT: 0x8dbd,\n  COMPRESSED_SIGNED_RED_GREEN_RGTC2_EXT: 0x8dbe,\n  COMPRESSED_SRGB_S3TC_DXT1_EXT: 0x8c4c,\n  COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT: 0x8c4d,\n  COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT: 0x8c4e,\n  COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT: 0x8c4f\n};\n//# sourceMappingURL=gl-extensions.js.map","const BROWSER_PREFIXES = ['', 'WEBKIT_', 'MOZ_'];\nconst WEBGL_EXTENSIONS = {\n  WEBGL_compressed_texture_s3tc: 'dxt',\n  WEBGL_compressed_texture_s3tc_srgb: 'dxt-srgb',\n  WEBGL_compressed_texture_etc1: 'etc1',\n  WEBGL_compressed_texture_etc: 'etc2',\n  WEBGL_compressed_texture_pvrtc: 'pvrtc',\n  WEBGL_compressed_texture_atc: 'atc',\n  WEBGL_compressed_texture_astc: 'astc',\n  EXT_texture_compression_rgtc: 'rgtc'\n};\nlet formats = null;\nexport function getSupportedGPUTextureFormats(gl) {\n  if (!formats) {\n    gl = gl || getWebGLContext() || undefined;\n    formats = new Set();\n\n    for (const prefix of BROWSER_PREFIXES) {\n      for (const extension in WEBGL_EXTENSIONS) {\n        if (gl && gl.getExtension(\"\".concat(prefix).concat(extension))) {\n          const gpuTextureFormat = WEBGL_EXTENSIONS[extension];\n          formats.add(gpuTextureFormat);\n        }\n      }\n    }\n  }\n\n  return formats;\n}\n\nfunction getWebGLContext() {\n  try {\n    const canvas = document.createElement('canvas');\n    return canvas.getContext('webgl');\n  } catch (error) {\n    return null;\n  }\n}\n//# sourceMappingURL=texture-formats.js.map","import { read } from 'ktx-parse';\nimport { extractMipmapImages } from '../utils/extract-mipmap-images';\nimport { mapVkFormatToWebGL } from '../utils/ktx-format-helper';\nconst KTX2_ID = [0xab, 0x4b, 0x54, 0x58, 0x20, 0x32, 0x30, 0xbb, 0x0d, 0x0a, 0x1a, 0x0a];\nexport function isKTX(data) {\n  const id = new Uint8Array(data);\n  const notKTX = id.byteLength < KTX2_ID.length || id[0] !== KTX2_ID[0] || id[1] !== KTX2_ID[1] || id[2] !== KTX2_ID[2] || id[3] !== KTX2_ID[3] || id[4] !== KTX2_ID[4] || id[5] !== KTX2_ID[5] || id[6] !== KTX2_ID[6] || id[7] !== KTX2_ID[7] || id[8] !== KTX2_ID[8] || id[9] !== KTX2_ID[9] || id[10] !== KTX2_ID[10] || id[11] !== KTX2_ID[11];\n  return !notKTX;\n}\nexport function parseKTX(arrayBuffer) {\n  const uint8Array = new Uint8Array(arrayBuffer);\n  const ktx = read(uint8Array);\n  const mipMapLevels = Math.max(1, ktx.levels.length);\n  const width = ktx.pixelWidth;\n  const height = ktx.pixelHeight;\n  const internalFormat = mapVkFormatToWebGL(ktx.vkFormat);\n  return extractMipmapImages(ktx.levels, {\n    mipMapLevels,\n    width,\n    height,\n    sizeFunction: level => level.uncompressedByteLength,\n    internalFormat\n  });\n}\n//# sourceMappingURL=parse-ktx.js.map","import { loadBasisEncoderModule, loadBasisTrascoderModule } from './basis-module-loader';\nimport { GL_EXTENSIONS_CONSTANTS } from '../gl-extensions';\nimport { getSupportedGPUTextureFormats } from '../utils/texture-formats';\nimport { isKTX } from './parse-ktx';\nconst OutputFormat = {\n  etc1: {\n    basisFormat: 0,\n    compressed: true,\n    format: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGB_ETC1_WEBGL\n  },\n  etc2: {\n    basisFormat: 1,\n    compressed: true\n  },\n  bc1: {\n    basisFormat: 2,\n    compressed: true,\n    format: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGB_S3TC_DXT1_EXT\n  },\n  bc3: {\n    basisFormat: 3,\n    compressed: true,\n    format: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_S3TC_DXT5_EXT\n  },\n  bc4: {\n    basisFormat: 4,\n    compressed: true\n  },\n  bc5: {\n    basisFormat: 5,\n    compressed: true\n  },\n  'bc7-m6-opaque-only': {\n    basisFormat: 6,\n    compressed: true\n  },\n  'bc7-m5': {\n    basisFormat: 7,\n    compressed: true\n  },\n  'pvrtc1-4-rgb': {\n    basisFormat: 8,\n    compressed: true,\n    format: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGB_PVRTC_4BPPV1_IMG\n  },\n  'pvrtc1-4-rgba': {\n    basisFormat: 9,\n    compressed: true,\n    format: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_PVRTC_4BPPV1_IMG\n  },\n  'astc-4x4': {\n    basisFormat: 10,\n    compressed: true,\n    format: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_4X4_KHR\n  },\n  'atc-rgb': {\n    basisFormat: 11,\n    compressed: true\n  },\n  'atc-rgba-interpolated-alpha': {\n    basisFormat: 12,\n    compressed: true\n  },\n  rgba32: {\n    basisFormat: 13,\n    compressed: false\n  },\n  rgb565: {\n    basisFormat: 14,\n    compressed: false\n  },\n  bgr565: {\n    basisFormat: 15,\n    compressed: false\n  },\n  rgba4444: {\n    basisFormat: 16,\n    compressed: false\n  }\n};\nexport default async function parseBasis(data, options) {\n  if (options.basis.containerFormat === 'auto') {\n    if (isKTX(data)) {\n      const fileConstructors = await loadBasisEncoderModule(options);\n      return parseKTX2File(fileConstructors.KTX2File, data, options);\n    }\n\n    const {\n      BasisFile\n    } = await loadBasisTrascoderModule(options);\n    return parseBasisFile(BasisFile, data, options);\n  }\n\n  switch (options.basis.module) {\n    case 'encoder':\n      const fileConstructors = await loadBasisEncoderModule(options);\n\n      switch (options.basis.containerFormat) {\n        case 'ktx2':\n          return parseKTX2File(fileConstructors.KTX2File, data, options);\n\n        case 'basis':\n        default:\n          return parseBasisFile(fileConstructors.BasisFile, data, options);\n      }\n\n    case 'transcoder':\n    default:\n      const {\n        BasisFile\n      } = await loadBasisTrascoderModule(options);\n      return parseBasisFile(BasisFile, data, options);\n  }\n}\n\nfunction parseBasisFile(BasisFile, data, options) {\n  const basisFile = new BasisFile(new Uint8Array(data));\n\n  try {\n    if (!basisFile.startTranscoding()) {\n      throw new Error('Failed to start basis transcoding');\n    }\n\n    const imageCount = basisFile.getNumImages();\n    const images = [];\n\n    for (let imageIndex = 0; imageIndex < imageCount; imageIndex++) {\n      const levelsCount = basisFile.getNumLevels(imageIndex);\n      const levels = [];\n\n      for (let levelIndex = 0; levelIndex < levelsCount; levelIndex++) {\n        levels.push(transcodeImage(basisFile, imageIndex, levelIndex, options));\n      }\n\n      images.push(levels);\n    }\n\n    return images;\n  } finally {\n    basisFile.close();\n    basisFile.delete();\n  }\n}\n\nfunction transcodeImage(basisFile, imageIndex, levelIndex, options) {\n  const width = basisFile.getImageWidth(imageIndex, levelIndex);\n  const height = basisFile.getImageHeight(imageIndex, levelIndex);\n  const hasAlpha = basisFile.getHasAlpha();\n  const {\n    compressed,\n    format,\n    basisFormat\n  } = getBasisOptions(options, hasAlpha);\n  const decodedSize = basisFile.getImageTranscodedSizeInBytes(imageIndex, levelIndex, basisFormat);\n  const decodedData = new Uint8Array(decodedSize);\n\n  if (!basisFile.transcodeImage(decodedData, imageIndex, levelIndex, basisFormat, 0, 0)) {\n    throw new Error('failed to start Basis transcoding');\n  }\n\n  return {\n    width,\n    height,\n    data: decodedData,\n    compressed,\n    format,\n    hasAlpha\n  };\n}\n\nfunction parseKTX2File(KTX2File, data, options) {\n  const ktx2File = new KTX2File(new Uint8Array(data));\n\n  try {\n    if (!ktx2File.startTranscoding()) {\n      throw new Error('failed to start KTX2 transcoding');\n    }\n\n    const levelsCount = ktx2File.getLevels();\n    const levels = [];\n\n    for (let levelIndex = 0; levelIndex < levelsCount; levelIndex++) {\n      levels.push(transcodeKTX2Image(ktx2File, levelIndex, options));\n      break;\n    }\n\n    return [levels];\n  } finally {\n    ktx2File.close();\n    ktx2File.delete();\n  }\n}\n\nfunction transcodeKTX2Image(ktx2File, levelIndex, options) {\n  const {\n    alphaFlag,\n    height,\n    width\n  } = ktx2File.getImageLevelInfo(levelIndex, 0, 0);\n  const {\n    compressed,\n    format,\n    basisFormat\n  } = getBasisOptions(options, alphaFlag);\n  const decodedSize = ktx2File.getImageTranscodedSizeInBytes(levelIndex, 0, 0, basisFormat);\n  const decodedData = new Uint8Array(decodedSize);\n\n  if (!ktx2File.transcodeImage(decodedData, levelIndex, 0, 0, basisFormat, 0, -1, -1)) {\n    throw new Error('Failed to transcode KTX2 image');\n  }\n\n  return {\n    width,\n    height,\n    data: decodedData,\n    compressed,\n    hasAlpha: alphaFlag,\n    format\n  };\n}\n\nfunction getBasisOptions(options, hasAlpha) {\n  let format = options && options.basis && options.basis.format;\n\n  if (format === 'auto') {\n    format = selectSupportedBasisFormat();\n  }\n\n  if (typeof format === 'object') {\n    format = hasAlpha ? format.alpha : format.noAlpha;\n  }\n\n  format = format.toLowerCase();\n  return OutputFormat[format];\n}\n\nexport function selectSupportedBasisFormat() {\n  const supportedFormats = getSupportedGPUTextureFormats();\n\n  if (supportedFormats.has('astc')) {\n    return 'astc-4x4';\n  } else if (supportedFormats.has('dxt')) {\n    return {\n      alpha: 'bc3',\n      noAlpha: 'bc1'\n    };\n  } else if (supportedFormats.has('pvrtc')) {\n    return {\n      alpha: 'pvrtc1-4-rgba',\n      noAlpha: 'pvrtc1-4-rgb'\n    };\n  } else if (supportedFormats.has('etc1')) {\n    return 'etc1';\n  } else if (supportedFormats.has('etc2')) {\n    return 'etc2';\n  }\n\n  return 'rgb565';\n}\n//# sourceMappingURL=parse-basis.js.map","import { VERSION } from './lib/utils/version';\nimport parseBasis from './lib/parsers/parse-basis';\nexport const BasisWorkerLoader = {\n  name: 'Basis',\n  id: 'basis',\n  module: 'textures',\n  version: VERSION,\n  worker: true,\n  extensions: ['basis', 'ktx2'],\n  mimeTypes: ['application/octet-stream', 'image/ktx2'],\n  tests: ['sB'],\n  binary: true,\n  options: {\n    basis: {\n      format: 'auto',\n      libraryPath: 'libs/',\n      containerFormat: 'auto',\n      module: 'transcoder'\n    }\n  }\n};\nexport const BasisLoader = { ...BasisWorkerLoader,\n  parse: parseBasis\n};\nexport const _TypecheckBasisWorkerLoader = BasisWorkerLoader;\nexport const _TypecheckBasisLoader = BasisLoader;\n//# sourceMappingURL=basis-loader.js.map","export const VERSION = typeof \"3.2.10\" !== 'undefined' ? \"3.2.10\" : 'latest';\n//# sourceMappingURL=version.js.map","export function assert(condition, message) {\n  if (!condition) {\n    throw new Error(message || 'assert failed: gltf');\n  }\n}\n//# sourceMappingURL=assert.js.map","export function resolveUrl(url, options) {\n  const absolute = url.startsWith('data:') || url.startsWith('http:') || url.startsWith('https:');\n\n  if (absolute) {\n    return url;\n  }\n\n  const baseUrl = options.baseUri || options.uri;\n\n  if (!baseUrl) {\n    throw new Error(\"'baseUri' must be provided to resolve relative url \".concat(url));\n  }\n\n  return baseUrl.substr(0, baseUrl.lastIndexOf('/') + 1) + url;\n}\n//# sourceMappingURL=resolve-url.js.map","import { assert } from '../utils/assert';\nexport function getTypedArrayForBufferView(json, buffers, bufferViewIndex) {\n  const bufferView = json.bufferViews[bufferViewIndex];\n  assert(bufferView);\n  const bufferIndex = bufferView.buffer;\n  const binChunk = buffers[bufferIndex];\n  assert(binChunk);\n  const byteOffset = (bufferView.byteOffset || 0) + binChunk.byteOffset;\n  return new Uint8Array(binChunk.arrayBuffer, byteOffset, bufferView.byteLength);\n}\nexport function getTypedArrayForImageData(json, buffers, imageIndex) {\n  const image = json.images[imageIndex];\n  const bufferViewIndex = json.bufferViews[image.bufferView];\n  return getTypedArrayForBufferView(json, buffers, bufferViewIndex);\n}\n//# sourceMappingURL=get-typed-array.js.map","import { assert } from '../utils/assert';\nconst TYPES = ['SCALAR', 'VEC2', 'VEC3', 'VEC4'];\nconst ARRAY_CONSTRUCTOR_TO_WEBGL_CONSTANT = [[Int8Array, 5120], [Uint8Array, 5121], [Int16Array, 5122], [Uint16Array, 5123], [Uint32Array, 5125], [Float32Array, 5126], [Float64Array, 5130]];\nconst ARRAY_TO_COMPONENT_TYPE = new Map(ARRAY_CONSTRUCTOR_TO_WEBGL_CONSTANT);\nconst ATTRIBUTE_TYPE_TO_COMPONENTS = {\n  SCALAR: 1,\n  VEC2: 2,\n  VEC3: 3,\n  VEC4: 4,\n  MAT2: 4,\n  MAT3: 9,\n  MAT4: 16\n};\nconst ATTRIBUTE_COMPONENT_TYPE_TO_BYTE_SIZE = {\n  5120: 1,\n  5121: 1,\n  5122: 2,\n  5123: 2,\n  5125: 4,\n  5126: 4\n};\nconst ATTRIBUTE_COMPONENT_TYPE_TO_ARRAY = {\n  5120: Int8Array,\n  5121: Uint8Array,\n  5122: Int16Array,\n  5123: Uint16Array,\n  5125: Uint32Array,\n  5126: Float32Array\n};\nexport function getAccessorTypeFromSize(size) {\n  const type = TYPES[size - 1];\n  return type || TYPES[0];\n}\nexport function getComponentTypeFromArray(typedArray) {\n  const componentType = ARRAY_TO_COMPONENT_TYPE.get(typedArray.constructor);\n\n  if (!componentType) {\n    throw new Error('Illegal typed array');\n  }\n\n  return componentType;\n}\nexport function getAccessorArrayTypeAndLength(accessor, bufferView) {\n  const ArrayType = ATTRIBUTE_COMPONENT_TYPE_TO_ARRAY[accessor.componentType];\n  const components = ATTRIBUTE_TYPE_TO_COMPONENTS[accessor.type];\n  const bytesPerComponent = ATTRIBUTE_COMPONENT_TYPE_TO_BYTE_SIZE[accessor.componentType];\n  const length = accessor.count * components;\n  const byteLength = accessor.count * components * bytesPerComponent;\n  assert(byteLength >= 0 && byteLength <= bufferView.byteLength);\n  return {\n    ArrayType,\n    length,\n    byteLength\n  };\n}\n//# sourceMappingURL=gltf-utils.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { getBinaryImageMetadata } from '@loaders.gl/images';\nimport { padToNBytes, copyToArray } from '@loaders.gl/loader-utils';\nimport { assert } from '../utils/assert';\nimport { getAccessorArrayTypeAndLength, getAccessorTypeFromSize, getComponentTypeFromArray } from '../gltf-utils/gltf-utils';\nconst DEFAULT_GLTF_JSON = {\n  asset: {\n    version: '2.0',\n    generator: 'loaders.gl'\n  },\n  buffers: []\n};\nexport default class GLTFScenegraph {\n  constructor(gltf) {\n    _defineProperty(this, \"gltf\", void 0);\n\n    _defineProperty(this, \"sourceBuffers\", void 0);\n\n    _defineProperty(this, \"byteLength\", void 0);\n\n    this.gltf = gltf || {\n      json: { ...DEFAULT_GLTF_JSON\n      },\n      buffers: []\n    };\n    this.sourceBuffers = [];\n    this.byteLength = 0;\n\n    if (this.gltf.buffers && this.gltf.buffers[0]) {\n      this.byteLength = this.gltf.buffers[0].byteLength;\n      this.sourceBuffers = [this.gltf.buffers[0]];\n    }\n  }\n\n  get json() {\n    return this.gltf.json;\n  }\n\n  getApplicationData(key) {\n    const data = this.json[key];\n    return data;\n  }\n\n  getExtraData(key) {\n    const extras = this.json.extras || {};\n    return extras[key];\n  }\n\n  getExtension(extensionName) {\n    const isExtension = this.getUsedExtensions().find(name => name === extensionName);\n    const extensions = this.json.extensions || {};\n    return isExtension ? extensions[extensionName] || true : null;\n  }\n\n  getRequiredExtension(extensionName) {\n    const isRequired = this.getRequiredExtensions().find(name => name === extensionName);\n    return isRequired ? this.getExtension(extensionName) : null;\n  }\n\n  getRequiredExtensions() {\n    return this.json.extensionsRequired || [];\n  }\n\n  getUsedExtensions() {\n    return this.json.extensionsUsed || [];\n  }\n\n  getObjectExtension(object, extensionName) {\n    const extensions = object.extensions || {};\n    return extensions[extensionName];\n  }\n\n  getScene(index) {\n    return this.getObject('scenes', index);\n  }\n\n  getNode(index) {\n    return this.getObject('nodes', index);\n  }\n\n  getSkin(index) {\n    return this.getObject('skins', index);\n  }\n\n  getMesh(index) {\n    return this.getObject('meshes', index);\n  }\n\n  getMaterial(index) {\n    return this.getObject('materials', index);\n  }\n\n  getAccessor(index) {\n    return this.getObject('accessors', index);\n  }\n\n  getTexture(index) {\n    return this.getObject('textures', index);\n  }\n\n  getSampler(index) {\n    return this.getObject('samplers', index);\n  }\n\n  getImage(index) {\n    return this.getObject('images', index);\n  }\n\n  getBufferView(index) {\n    return this.getObject('bufferViews', index);\n  }\n\n  getBuffer(index) {\n    return this.getObject('buffers', index);\n  }\n\n  getObject(array, index) {\n    if (typeof index === 'object') {\n      return index;\n    }\n\n    const object = this.json[array] && this.json[array][index];\n\n    if (!object) {\n      throw new Error(\"glTF file error: Could not find \".concat(array, \"[\").concat(index, \"]\"));\n    }\n\n    return object;\n  }\n\n  getTypedArrayForBufferView(bufferView) {\n    bufferView = this.getBufferView(bufferView);\n    const bufferIndex = bufferView.buffer;\n    const binChunk = this.gltf.buffers[bufferIndex];\n    assert(binChunk);\n    const byteOffset = (bufferView.byteOffset || 0) + binChunk.byteOffset;\n    return new Uint8Array(binChunk.arrayBuffer, byteOffset, bufferView.byteLength);\n  }\n\n  getTypedArrayForAccessor(accessor) {\n    accessor = this.getAccessor(accessor);\n    const bufferView = this.getBufferView(accessor.bufferView);\n    const buffer = this.getBuffer(bufferView.buffer);\n    const arrayBuffer = buffer.data;\n    const {\n      ArrayType,\n      length\n    } = getAccessorArrayTypeAndLength(accessor, bufferView);\n    const byteOffset = bufferView.byteOffset + accessor.byteOffset;\n    return new ArrayType(arrayBuffer, byteOffset, length);\n  }\n\n  getTypedArrayForImageData(image) {\n    image = this.getAccessor(image);\n    const bufferView = this.getBufferView(image.bufferView);\n    const buffer = this.getBuffer(bufferView.buffer);\n    const arrayBuffer = buffer.data;\n    const byteOffset = bufferView.byteOffset || 0;\n    return new Uint8Array(arrayBuffer, byteOffset, bufferView.byteLength);\n  }\n\n  addApplicationData(key, data) {\n    this.json[key] = data;\n    return this;\n  }\n\n  addExtraData(key, data) {\n    this.json.extras = this.json.extras || {};\n    this.json.extras[key] = data;\n    return this;\n  }\n\n  addObjectExtension(object, extensionName, data) {\n    object.extensions = object.extensions || {};\n    object.extensions[extensionName] = data;\n    this.registerUsedExtension(extensionName);\n    return this;\n  }\n\n  setObjectExtension(object, extensionName, data) {\n    const extensions = object.extensions || {};\n    extensions[extensionName] = data;\n  }\n\n  removeObjectExtension(object, extensionName) {\n    const extensions = object.extensions || {};\n    const extension = extensions[extensionName];\n    delete extensions[extensionName];\n    return extension;\n  }\n\n  addExtension(extensionName, extensionData = {}) {\n    assert(extensionData);\n    this.json.extensions = this.json.extensions || {};\n    this.json.extensions[extensionName] = extensionData;\n    this.registerUsedExtension(extensionName);\n    return extensionData;\n  }\n\n  addRequiredExtension(extensionName, extensionData = {}) {\n    assert(extensionData);\n    this.addExtension(extensionName, extensionData);\n    this.registerRequiredExtension(extensionName);\n    return extensionData;\n  }\n\n  registerUsedExtension(extensionName) {\n    this.json.extensionsUsed = this.json.extensionsUsed || [];\n\n    if (!this.json.extensionsUsed.find(ext => ext === extensionName)) {\n      this.json.extensionsUsed.push(extensionName);\n    }\n  }\n\n  registerRequiredExtension(extensionName) {\n    this.registerUsedExtension(extensionName);\n    this.json.extensionsRequired = this.json.extensionsRequired || [];\n\n    if (!this.json.extensionsRequired.find(ext => ext === extensionName)) {\n      this.json.extensionsRequired.push(extensionName);\n    }\n  }\n\n  removeExtension(extensionName) {\n    if (this.json.extensionsRequired) {\n      this._removeStringFromArray(this.json.extensionsRequired, extensionName);\n    }\n\n    if (this.json.extensionsUsed) {\n      this._removeStringFromArray(this.json.extensionsUsed, extensionName);\n    }\n\n    if (this.json.extensions) {\n      delete this.json.extensions[extensionName];\n    }\n  }\n\n  setDefaultScene(sceneIndex) {\n    this.json.scene = sceneIndex;\n  }\n\n  addScene(scene) {\n    const {\n      nodeIndices\n    } = scene;\n    this.json.scenes = this.json.scenes || [];\n    this.json.scenes.push({\n      nodes: nodeIndices\n    });\n    return this.json.scenes.length - 1;\n  }\n\n  addNode(node) {\n    const {\n      meshIndex,\n      matrix\n    } = node;\n    this.json.nodes = this.json.nodes || [];\n    const nodeData = {\n      mesh: meshIndex\n    };\n\n    if (matrix) {\n      nodeData.matrix = matrix;\n    }\n\n    this.json.nodes.push(nodeData);\n    return this.json.nodes.length - 1;\n  }\n\n  addMesh(mesh) {\n    const {\n      attributes,\n      indices,\n      material,\n      mode = 4\n    } = mesh;\n\n    const accessors = this._addAttributes(attributes);\n\n    const glTFMesh = {\n      primitives: [{\n        attributes: accessors,\n        mode\n      }]\n    };\n\n    if (indices) {\n      const indicesAccessor = this._addIndices(indices);\n\n      glTFMesh.primitives[0].indices = indicesAccessor;\n    }\n\n    if (Number.isFinite(material)) {\n      glTFMesh.primitives[0].material = material;\n    }\n\n    this.json.meshes = this.json.meshes || [];\n    this.json.meshes.push(glTFMesh);\n    return this.json.meshes.length - 1;\n  }\n\n  addPointCloud(attributes) {\n    const accessorIndices = this._addAttributes(attributes);\n\n    const glTFMesh = {\n      primitives: [{\n        attributes: accessorIndices,\n        mode: 0\n      }]\n    };\n    this.json.meshes = this.json.meshes || [];\n    this.json.meshes.push(glTFMesh);\n    return this.json.meshes.length - 1;\n  }\n\n  addImage(imageData, mimeTypeOpt) {\n    const metadata = getBinaryImageMetadata(imageData);\n    const mimeType = mimeTypeOpt || (metadata === null || metadata === void 0 ? void 0 : metadata.mimeType);\n    const bufferViewIndex = this.addBufferView(imageData);\n    const glTFImage = {\n      bufferView: bufferViewIndex,\n      mimeType\n    };\n    this.json.images = this.json.images || [];\n    this.json.images.push(glTFImage);\n    return this.json.images.length - 1;\n  }\n\n  addBufferView(buffer) {\n    const byteLength = buffer.byteLength;\n    assert(Number.isFinite(byteLength));\n    this.sourceBuffers = this.sourceBuffers || [];\n    this.sourceBuffers.push(buffer);\n    const glTFBufferView = {\n      buffer: 0,\n      byteOffset: this.byteLength,\n      byteLength\n    };\n    this.byteLength += padToNBytes(byteLength, 4);\n    this.json.bufferViews = this.json.bufferViews || [];\n    this.json.bufferViews.push(glTFBufferView);\n    return this.json.bufferViews.length - 1;\n  }\n\n  addAccessor(bufferViewIndex, accessor) {\n    const glTFAccessor = {\n      bufferView: bufferViewIndex,\n      type: getAccessorTypeFromSize(accessor.size),\n      componentType: accessor.componentType,\n      count: accessor.count,\n      max: accessor.max,\n      min: accessor.min\n    };\n    this.json.accessors = this.json.accessors || [];\n    this.json.accessors.push(glTFAccessor);\n    return this.json.accessors.length - 1;\n  }\n\n  addBinaryBuffer(sourceBuffer, accessor = {\n    size: 3\n  }) {\n    const bufferViewIndex = this.addBufferView(sourceBuffer);\n    let minMax = {\n      min: accessor.min,\n      max: accessor.max\n    };\n\n    if (!minMax.min || !minMax.max) {\n      minMax = this._getAccessorMinMax(sourceBuffer, accessor.size);\n    }\n\n    const accessorDefaults = {\n      size: accessor.size,\n      componentType: getComponentTypeFromArray(sourceBuffer),\n      count: Math.round(sourceBuffer.length / accessor.size),\n      min: minMax.min,\n      max: minMax.max\n    };\n    return this.addAccessor(bufferViewIndex, Object.assign(accessorDefaults, accessor));\n  }\n\n  addTexture(texture) {\n    const {\n      imageIndex\n    } = texture;\n    const glTFTexture = {\n      source: imageIndex\n    };\n    this.json.textures = this.json.textures || [];\n    this.json.textures.push(glTFTexture);\n    return this.json.textures.length - 1;\n  }\n\n  addMaterial(pbrMaterialInfo) {\n    this.json.materials = this.json.materials || [];\n    this.json.materials.push(pbrMaterialInfo);\n    return this.json.materials.length - 1;\n  }\n\n  createBinaryChunk() {\n    var _this$json, _this$json$buffers;\n\n    this.gltf.buffers = [];\n    const totalByteLength = this.byteLength;\n    const arrayBuffer = new ArrayBuffer(totalByteLength);\n    const targetArray = new Uint8Array(arrayBuffer);\n    let dstByteOffset = 0;\n\n    for (const sourceBuffer of this.sourceBuffers || []) {\n      dstByteOffset = copyToArray(sourceBuffer, targetArray, dstByteOffset);\n    }\n\n    if ((_this$json = this.json) !== null && _this$json !== void 0 && (_this$json$buffers = _this$json.buffers) !== null && _this$json$buffers !== void 0 && _this$json$buffers[0]) {\n      this.json.buffers[0].byteLength = totalByteLength;\n    } else {\n      this.json.buffers = [{\n        byteLength: totalByteLength\n      }];\n    }\n\n    this.gltf.binary = arrayBuffer;\n    this.sourceBuffers = [arrayBuffer];\n  }\n\n  _removeStringFromArray(array, string) {\n    let found = true;\n\n    while (found) {\n      const index = array.indexOf(string);\n\n      if (index > -1) {\n        array.splice(index, 1);\n      } else {\n        found = false;\n      }\n    }\n  }\n\n  _addAttributes(attributes = {}) {\n    const result = {};\n\n    for (const attributeKey in attributes) {\n      const attributeData = attributes[attributeKey];\n\n      const attrName = this._getGltfAttributeName(attributeKey);\n\n      const accessor = this.addBinaryBuffer(attributeData.value, attributeData);\n      result[attrName] = accessor;\n    }\n\n    return result;\n  }\n\n  _addIndices(indices) {\n    return this.addBinaryBuffer(indices, {\n      size: 1\n    });\n  }\n\n  _getGltfAttributeName(attributeName) {\n    switch (attributeName.toLowerCase()) {\n      case 'position':\n      case 'positions':\n      case 'vertices':\n        return 'POSITION';\n\n      case 'normal':\n      case 'normals':\n        return 'NORMAL';\n\n      case 'color':\n      case 'colors':\n        return 'COLOR_0';\n\n      case 'texcoord':\n      case 'texcoords':\n        return 'TEXCOORD_0';\n\n      default:\n        return attributeName;\n    }\n  }\n\n  _getAccessorMinMax(buffer, size) {\n    const result = {\n      min: null,\n      max: null\n    };\n\n    if (buffer.length < size) {\n      return result;\n    }\n\n    result.min = [];\n    result.max = [];\n    const initValues = buffer.subarray(0, size);\n\n    for (const value of initValues) {\n      result.min.push(value);\n      result.max.push(value);\n    }\n\n    for (let index = size; index < buffer.length; index += size) {\n      for (let componentIndex = 0; componentIndex < size; componentIndex++) {\n        result.min[0 + componentIndex] = Math.min(result.min[0 + componentIndex], buffer[index + componentIndex]);\n        result.max[0 + componentIndex] = Math.max(result.max[0 + componentIndex], buffer[index + componentIndex]);\n      }\n    }\n\n    return result;\n  }\n\n}\n//# sourceMappingURL=gltf-scenegraph.js.map","const isWebAssemblySupported = typeof WebAssembly !== 'object';\nconst wasm_base = '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';\nconst wasm_simd = 'B9h9z9tFBBBF8dL9gBB9gLaaaaaFa9gEaaaB9gGaaB9gFaFaEQSBBFBFFGEGEGIILF9wFFFLEFBFKNFaFCx/aFMO/LFVK9tv9t9vq95GBt9f9f939h9z9t9f9j9h9s9s9f9jW9vq9zBBp9tv9z9o9v9wW9f9kv9j9v9kv9WvqWv94h919m9mvqBG8Z9tv9z9o9v9wW9f9kv9j9v9kv9J9u9kv94h919m9mvqBIy9tv9z9o9v9wW9f9kv9j9v9kv9J9u9kv949TvZ91v9u9jvBLn9tv9z9o9v9wW9f9kv9j9v9kv69p9sWvq9P9jWBKi9tv9z9o9v9wW9f9kv9j9v9kv69p9sWvq9R919hWBNn9tv9z9o9v9wW9f9kv9j9v9kv69p9sWvq9F949wBcI9z9iqlBMc/j9JSIBTEM9+FLa8jUUUUBCTlRBCBRFEXCBRGCBREEXABCNJAGJAECUaAFAGrCFZHIy86BBAEAIJREAGCFJHGCN9HQBMAFCx+YUUBJAE86BBAFCEWCxkUUBJAB8pEN83EBAFCFJHFCUG9HQBMMkRIbaG97FaK978jUUUUBCU/KBlHL8kUUUUBC9+RKGXAGCFJAI9LQBCaRKAE2BBC+gF9HQBALAEAIJHOAGlAG/8cBBCUoBAG9uC/wgBZHKCUGAKCUG9JyRNAECFJRKCBRVGXEXAVAF9PQFANAFAVlAVANJAF9JyRcGXGXAG9FQBAcCbJHIC9wZHMCE9sRSAMCFWRQAICIrCEJCGrRfCBRbEXAKRTCBRtGXEXGXAOATlAf9PQBCBRKSLMALCU/CBJAtAM9sJRmATAfJRKCBREGXAMCoB9JQBAOAKlC/gB9JQBCBRIEXAmAIJREGXGXGXGXGXATAICKrJ2BBHYCEZfIBFGEBMAECBDtDMIBSEMAEAKDBBIAKDBBBHPCID+MFAPDQBTFtGmEYIPLdKeOnHPCGD+MFAPDQBTFtGmEYIPLdKeOnC0+G+MiDtD9OHdCEDbD8jHPD8dBhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBAeCx+YUUBJDBBBHnAnDQBBBBBBBBBBBBBBBBAPD8dFhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBD9uDQBFGEILKOTtmYPdenDfAdAPD9SDMIBAKCIJAnDeBJAeCx+YUUBJ2BBJRKSGMAEAKDBBNAKDBBBHPCID+MFAPDQBTFtGmEYIPLdKeOnC+P+e+8/4BDtD9OHdCbDbD8jHPD8dBhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBAeCx+YUUBJDBBBHnAnDQBBBBBBBBBBBBBBBBAPD8dFhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBD9uDQBFGEILKOTtmYPdenDfAdAPD9SDMIBAKCNJAnDeBJAeCx+YUUBJ2BBJRKSFMAEAKDBBBDMIBAKCTJRKMGXGXGXGXGXAYCGrCEZfIBFGEBMAECBDtDMITSEMAEAKDBBIAKDBBBHPCID+MFAPDQBTFtGmEYIPLdKeOnHPCGD+MFAPDQBTFtGmEYIPLdKeOnC0+G+MiDtD9OHdCEDbD8jHPD8dBhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBAeCx+YUUBJDBBBHnAnDQBBBBBBBBBBBBBBBBAPD8dFhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBD9uDQBFGEILKOTtmYPdenDfAdAPD9SDMITAKCIJAnDeBJAeCx+YUUBJ2BBJRKSGMAEAKDBBNAKDBBBHPCID+MFAPDQBTFtGmEYIPLdKeOnC+P+e+8/4BDtD9OHdCbDbD8jHPD8dBhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBAeCx+YUUBJDBBBHnAnDQBBBBBBBBBBBBBBBBAPD8dFhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBD9uDQBFGEILKOTtmYPdenDfAdAPD9SDMITAKCNJAnDeBJAeCx+YUUBJ2BBJRKSFMAEAKDBBBDMITAKCTJRKMGXGXGXGXGXAYCIrCEZfIBFGEBMAECBDtDMIASEMAEAKDBBIAKDBBBHPCID+MFAPDQBTFtGmEYIPLdKeOnHPCGD+MFAPDQBTFtGmEYIPLdKeOnC0+G+MiDtD9OHdCEDbD8jHPD8dBhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBAeCx+YUUBJDBBBHnAnDQBBBBBBBBBBBBBBBBAPD8dFhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBD9uDQBFGEILKOTtmYPdenDfAdAPD9SDMIAAKCIJAnDeBJAeCx+YUUBJ2BBJRKSGMAEAKDBBNAKDBBBHPCID+MFAPDQBTFtGmEYIPLdKeOnC+P+e+8/4BDtD9OHdCbDbD8jHPD8dBhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBAeCx+YUUBJDBBBHnAnDQBBBBBBBBBBBBBBBBAPD8dFhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBD9uDQBFGEILKOTtmYPdenDfAdAPD9SDMIAAKCNJAnDeBJAeCx+YUUBJ2BBJRKSFMAEAKDBBBDMIAAKCTJRKMGXGXGXGXGXAYCKrfIBFGEBMAECBDtDMI8wSEMAEAKDBBIAKDBBBHPCID+MFAPDQBTFtGmEYIPLdKeOnHPCGD+MFAPDQBTFtGmEYIPLdKeOnC0+G+MiDtD9OHdCEDbD8jHPD8dBhUg/8/4/w/goB9+h84k7HYCEWCxkUUBJDBEBAYCx+YUUBJDBBBHnAnDQBBBBBBBBBBBBBBBBAPD8dFhUg/8/4/w/goB9+h84k7HYCEWCxkUUBJDBEBD9uDQBFGEILKOTtmYPdenDfAdAPD9SDMI8wAKCIJAnDeBJAYCx+YUUBJ2BBJRKSGMAEAKDBBNAKDBBBHPCID+MFAPDQBTFtGmEYIPLdKeOnC+P+e+8/4BDtD9OHdCbDbD8jHPD8dBhUg/8/4/w/goB9+h84k7HYCEWCxkUUBJDBEBAYCx+YUUBJDBBBHnAnDQBBBBBBBBBBBBBBBBAPD8dFhUg/8/4/w/goB9+h84k7HYCEWCxkUUBJDBEBD9uDQBFGEILKOTtmYPdenDfAdAPD9SDMI8wAKCNJAnDeBJAYCx+YUUBJ2BBJRKSFMAEAKDBBBDMI8wAKCTJRKMAICoBJREAICUFJAM9LQFAERIAOAKlC/fB9LQBMMGXAEAM9PQBAECErRIEXGXAOAKlCi9PQBCBRKSOMAmAEJRYGXGXGXGXGXATAECKrJ2BBAICKZrCEZfIBFGEBMAYCBDtDMIBSEMAYAKDBBIAKDBBBHPCID+MFAPDQBTFtGmEYIPLdKeOnHPCGD+MFAPDQBTFtGmEYIPLdKeOnC0+G+MiDtD9OHdCEDbD8jHPD8dBhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBAeCx+YUUBJDBBBHnAnDQBBBBBBBBBBBBBBBBAPD8dFhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBD9uDQBFGEILKOTtmYPdenDfAdAPD9SDMIBAKCIJAnDeBJAeCx+YUUBJ2BBJRKSGMAYAKDBBNAKDBBBHPCID+MFAPDQBTFtGmEYIPLdKeOnC+P+e+8/4BDtD9OHdCbDbD8jHPD8dBhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBAeCx+YUUBJDBBBHnAnDQBBBBBBBBBBBBBBBBAPD8dFhUg/8/4/w/goB9+h84k7HeCEWCxkUUBJDBEBD9uDQBFGEILKOTtmYPdenDfAdAPD9SDMIBAKCNJAnDeBJAeCx+YUUBJ2BBJRKSFMAYAKDBBBDMIBAKCTJRKMAICGJRIAECTJHEAM9JQBMMGXAK9FQBAKRTAtCFJHtCI6QGSFMMCBRKSEMGXAM9FQBALCUGJAbJREALAbJDBGBRnCBRYEXAEALCU/CBJAYJHIDBIBHdCFD9tAdCFDbHPD9OD9hD9RHdAIAMJDBIBHiCFD9tAiAPD9OD9hD9RHiDQBTFtGmEYIPLdKeOnH8ZAIAQJDBIBHpCFD9tApAPD9OD9hD9RHpAIASJDBIBHyCFD9tAyAPD9OD9hD9RHyDQBTFtGmEYIPLdKeOnH8cDQBFTtGEmYILPdKOenHPAPDQBFGEBFGEBFGEBFGEAnD9uHnDyBjGBAEAGJHIAnAPAPDQILKOILKOILKOILKOD9uHnDyBjGBAIAGJHIAnAPAPDQNVcMNVcMNVcMNVcMD9uHnDyBjGBAIAGJHIAnAPAPDQSQfbSQfbSQfbSQfbD9uHnDyBjGBAIAGJHIAnA8ZA8cDQNVi8ZcMpySQ8c8dfb8e8fHPAPDQBFGEBFGEBFGEBFGED9uHnDyBjGBAIAGJHIAnAPAPDQILKOILKOILKOILKOD9uHnDyBjGBAIAGJHIAnAPAPDQNVcMNVcMNVcMNVcMD9uHnDyBjGBAIAGJHIAnAPAPDQSQfbSQfbSQfbSQfbD9uHnDyBjGBAIAGJHIAnAdAiDQNiV8ZcpMyS8cQ8df8eb8fHdApAyDQNiV8ZcpMyS8cQ8df8eb8fHiDQBFTtGEmYILPdKOenHPAPDQBFGEBFGEBFGEBFGED9uHnDyBjGBAIAGJHIAnAPAPDQILKOILKOILKOILKOD9uHnDyBjGBAIAGJHIAnAPAPDQNVcMNVcMNVcMNVcMD9uHnDyBjGBAIAGJHIAnAPAPDQSQfbSQfbSQfbSQfbD9uHnDyBjGBAIAGJHIAnAdAiDQNVi8ZcMpySQ8c8dfb8e8fHPAPDQBFGEBFGEBFGEBFGED9uHnDyBjGBAIAGJHIAnAPAPDQILKOILKOILKOILKOD9uHnDyBjGBAIAGJHIAnAPAPDQNVcMNVcMNVcMNVcMD9uHnDyBjGBAIAGJHIAnAPAPDQSQfbSQfbSQfbSQfbD9uHnDyBjGBAIAGJREAYCTJHYAM9JQBMMAbCIJHbAG9JQBMMABAVAG9sJALCUGJAcAG9s/8cBBALALCUGJAcCaJAG9sJAG/8cBBMAcCBAKyAVJRVAKQBMC9+RKSFMCBC99AOAKlAGCAAGCA9Ly6yRKMALCU/KBJ8kUUUUBAKMNBT+BUUUBM+KmFTa8jUUUUBCoFlHL8kUUUUBC9+RKGXAFCE9uHOCtJAI9LQBCaRKAE2BBHNC/wFZC/gF9HQBANCbZHVCF9LQBALCoBJCgFCUF/8MBALC84Jha83EBALC8wJha83EBALC8oJha83EBALCAJha83EBALCiJha83EBALCTJha83EBALha83ENALha83EBAEAIJC9wJRcAECFJHNAOJRMGXAF9FQBCQCbAVCF6yRSABRECBRVCBRQCBRfCBRICBRKEXGXAMAcuQBC9+RKSEMGXGXAN2BBHOC/vF9LQBALCoBJAOCIrCa9zAKJCbZCEWJHb8oGIRTAb8oGBRtGXAOCbZHbAS9PQBALAOCa9zAIJCbZCGWJ8oGBAVAbyROAb9FRbGXGXAGCG9HQBABAt87FBABCIJAO87FBABCGJAT87FBSFMAEAtjGBAECNJAOjGBAECIJATjGBMAVAbJRVALCoBJAKCEWJHmAOjGBAmATjGIALAICGWJAOjGBALCoBJAKCFJCbZHKCEWJHTAtjGBATAOjGIAIAbJRIAKCFJRKSGMGXGXAbCb6QBAQAbJAbC989zJCFJRQSFMAM1BBHbCgFZROGXGXAbCa9MQBAMCFJRMSFMAM1BFHbCgBZCOWAOCgBZqROGXAbCa9MQBAMCGJRMSFMAM1BGHbCgBZCfWAOqROGXAbCa9MQBAMCEJRMSFMAM1BEHbCgBZCdWAOqROGXAbCa9MQBAMCIJRMSFMAM2BIC8cWAOqROAMCLJRMMAOCFrCBAOCFZl9zAQJRQMGXGXAGCG9HQBABAt87FBABCIJAQ87FBABCGJAT87FBSFMAEAtjGBAECNJAQjGBAECIJATjGBMALCoBJAKCEWJHOAQjGBAOATjGIALAICGWJAQjGBALCoBJAKCFJCbZHKCEWJHOAtjGBAOAQjGIAICFJRIAKCFJRKSFMGXAOCDF9LQBALAIAcAOCbZJ2BBHbCIrHTlCbZCGWJ8oGBAVCFJHtATyROALAIAblCbZCGWJ8oGBAtAT9FHmJHtAbCbZHTyRbAT9FRTGXGXAGCG9HQBABAV87FBABCIJAb87FBABCGJAO87FBSFMAEAVjGBAECNJAbjGBAECIJAOjGBMALAICGWJAVjGBALCoBJAKCEWJHYAOjGBAYAVjGIALAICFJHICbZCGWJAOjGBALCoBJAKCFJCbZCEWJHYAbjGBAYAOjGIALAIAmJCbZHICGWJAbjGBALCoBJAKCGJCbZHKCEWJHOAVjGBAOAbjGIAKCFJRKAIATJRIAtATJRVSFMAVCBAM2BBHYyHTAOC/+F6HPJROAYCbZRtGXGXAYCIrHmQBAOCFJRbSFMAORbALAIAmlCbZCGWJ8oGBROMGXGXAtQBAbCFJRVSFMAbRVALAIAYlCbZCGWJ8oGBRbMGXGXAP9FQBAMCFJRYSFMAM1BFHYCgFZRTGXGXAYCa9MQBAMCGJRYSFMAM1BGHYCgBZCOWATCgBZqRTGXAYCa9MQBAMCEJRYSFMAM1BEHYCgBZCfWATqRTGXAYCa9MQBAMCIJRYSFMAM1BIHYCgBZCdWATqRTGXAYCa9MQBAMCLJRYSFMAMCKJRYAM2BLC8cWATqRTMATCFrCBATCFZl9zAQJHQRTMGXGXAmCb6QBAYRPSFMAY1BBHMCgFZROGXGXAMCa9MQBAYCFJRPSFMAY1BFHMCgBZCOWAOCgBZqROGXAMCa9MQBAYCGJRPSFMAY1BGHMCgBZCfWAOqROGXAMCa9MQBAYCEJRPSFMAY1BEHMCgBZCdWAOqROGXAMCa9MQBAYCIJRPSFMAYCLJRPAY2BIC8cWAOqROMAOCFrCBAOCFZl9zAQJHQROMGXGXAtCb6QBAPRMSFMAP1BBHMCgFZRbGXGXAMCa9MQBAPCFJRMSFMAP1BFHMCgBZCOWAbCgBZqRbGXAMCa9MQBAPCGJRMSFMAP1BGHMCgBZCfWAbqRbGXAMCa9MQBAPCEJRMSFMAP1BEHMCgBZCdWAbqRbGXAMCa9MQBAPCIJRMSFMAPCLJRMAP2BIC8cWAbqRbMAbCFrCBAbCFZl9zAQJHQRbMGXGXAGCG9HQBABAT87FBABCIJAb87FBABCGJAO87FBSFMAEATjGBAECNJAbjGBAECIJAOjGBMALCoBJAKCEWJHYAOjGBAYATjGIALAICGWJATjGBALCoBJAKCFJCbZCEWJHYAbjGBAYAOjGIALAICFJHICbZCGWJAOjGBALCoBJAKCGJCbZCEWJHOATjGBAOAbjGIALAIAm9FAmCb6qJHICbZCGWJAbjGBAIAt9FAtCb6qJRIAKCEJRKMANCFJRNABCKJRBAECSJREAKCbZRKAICbZRIAfCEJHfAF9JQBMMCBC99AMAc6yRKMALCoFJ8kUUUUBAKM/tIFGa8jUUUUBCTlRLC9+RKGXAFCLJAI9LQBCaRKAE2BBC/+FZC/QF9HQBALhB83ENAECFJRKAEAIJC98JREGXAF9FQBGXAGCG6QBEXGXAKAE9JQBC9+bMAK1BBHGCgFZRIGXGXAGCa9MQBAKCFJRKSFMAK1BFHGCgBZCOWAICgBZqRIGXAGCa9MQBAKCGJRKSFMAK1BGHGCgBZCfWAIqRIGXAGCa9MQBAKCEJRKSFMAK1BEHGCgBZCdWAIqRIGXAGCa9MQBAKCIJRKSFMAK2BIC8cWAIqRIAKCLJRKMALCNJAICFZCGWqHGAICGrCBAICFrCFZl9zAG8oGBJHIjGBABAIjGBABCIJRBAFCaJHFQBSGMMEXGXAKAE9JQBC9+bMAK1BBHGCgFZRIGXGXAGCa9MQBAKCFJRKSFMAK1BFHGCgBZCOWAICgBZqRIGXAGCa9MQBAKCGJRKSFMAK1BGHGCgBZCfWAIqRIGXAGCa9MQBAKCEJRKSFMAK1BEHGCgBZCdWAIqRIGXAGCa9MQBAKCIJRKSFMAK2BIC8cWAIqRIAKCLJRKMABAICGrCBAICFrCFZl9zALCNJAICFZCGWqHI8oGBJHG87FBAIAGjGBABCGJRBAFCaJHFQBMMCBC99AKAE6yRKMAKM/xLGEaK978jUUUUBCAlHE8kUUUUBGXGXAGCI9HQBGXAFC98ZHI9FQBABRGCBRLEXAGAGDBBBHKCiD+rFCiD+sFD/6FHOAKCND+rFCiD+sFD/6FAOD/gFAKCTD+rFCiD+sFD/6FHND/gFD/kFD/lFHVCBDtD+2FHcAOCUUUU94DtHMD9OD9RD/kFHO9DBB/+hDYAOAOD/mFAVAVD/mFANAcANAMD9OD9RD/kFHOAOD/mFD/kFD/kFD/jFD/nFHND/mF9DBBX9LDYHcD/kFCgFDtD9OAKCUUU94DtD9OD9QAOAND/mFAcD/kFCND+rFCU/+EDtD9OD9QAVAND/mFAcD/kFCTD+rFCUU/8ODtD9OD9QDMBBAGCTJRGALCIJHLAI9JQBMMAIAF9PQFAEAFCEZHLCGWHGqCBCTAGl/8MBAEABAICGWJHIAG/8cBBGXAL9FQBAEAEDBIBHKCiD+rFCiD+sFD/6FHOAKCND+rFCiD+sFD/6FAOD/gFAKCTD+rFCiD+sFD/6FHND/gFD/kFD/lFHVCBDtD+2FHcAOCUUUU94DtHMD9OD9RD/kFHO9DBB/+hDYAOAOD/mFAVAVD/mFANAcANAMD9OD9RD/kFHOAOD/mFD/kFD/kFD/jFD/nFHND/mF9DBBX9LDYHcD/kFCgFDtD9OAKCUUU94DtD9OD9QAOAND/mFAcD/kFCND+rFCU/+EDtD9OD9QAVAND/mFAcD/kFCTD+rFCUU/8ODtD9OD9QDMIBMAIAEAG/8cBBSFMABAFC98ZHGT+HUUUBAGAF9PQBAEAFCEZHICEWHLJCBCAALl/8MBAEABAGCEWJHGAL/8cBBAEAIT+HUUUBAGAEAL/8cBBMAECAJ8kUUUUBM+yEGGaO97GXAF9FQBCBRGEXABCTJHEAEDBBBHICBDtHLCUU98D8cFCUU98D8cEHKD9OABDBBBHOAIDQILKOSQfbPden8c8d8e8fCggFDtD9OD/6FAOAIDQBFGENVcMTtmYi8ZpyHICTD+sFD/6FHND/gFAICTD+rFCTD+sFD/6FHVD/gFD/kFD/lFHI9DB/+g6DYAVAIALD+2FHLAVCUUUU94DtHcD9OD9RD/kFHVAVD/mFAIAID/mFANALANAcD9OD9RD/kFHIAID/mFD/kFD/kFD/jFD/nFHND/mF9DBBX9LDYHLD/kFCTD+rFAVAND/mFALD/kFCggEDtD9OD9QHVAIAND/mFALD/kFCaDbCBDnGCBDnECBDnKCBDnOCBDncCBDnMCBDnfCBDnbD9OHIDQNVi8ZcMpySQ8c8dfb8e8fD9QDMBBABAOAKD9OAVAIDQBFTtGEmYILPdKOenD9QDMBBABCAJRBAGCIJHGAF9JQBMMM94FEa8jUUUUBCAlHE8kUUUUBABAFC98ZHIT+JUUUBGXAIAF9PQBAEAFCEZHLCEWHFJCBCAAFl/8MBAEABAICEWJHBAF/8cBBAEALT+JUUUBABAEAF/8cBBMAECAJ8kUUUUBM/hEIGaF97FaL978jUUUUBCTlRGGXAF9FQBCBREEXAGABDBBBHIABCTJHLDBBBHKDQILKOSQfbPden8c8d8e8fHOCTD+sFHNCID+rFDMIBAB9DBBU8/DY9D/zI818/DYANCEDtD9QD/6FD/nFHNAIAKDQBFGENVcMTtmYi8ZpyHICTD+rFCTD+sFD/6FD/mFHKAKD/mFANAICTD+sFD/6FD/mFHVAVD/mFANAOCTD+rFCTD+sFD/6FD/mFHOAOD/mFD/kFD/kFD/lFCBDtD+4FD/jF9DB/+g6DYHND/mF9DBBX9LDYHID/kFCggEDtHcD9OAVAND/mFAID/kFCTD+rFD9QHVAOAND/mFAID/kFCTD+rFAKAND/mFAID/kFAcD9OD9QHNDQBFTtGEmYILPdKOenHID8dBAGDBIBDyB+t+J83EBABCNJAID8dFAGDBIBDyF+t+J83EBALAVANDQNVi8ZcMpySQ8c8dfb8e8fHND8dBAGDBIBDyG+t+J83EBABCiJAND8dFAGDBIBDyE+t+J83EBABCAJRBAECIJHEAF9JQBMMM/3FGEaF978jUUUUBCoBlREGXAGCGrAF9sHIC98ZHL9FQBCBRGABRFEXAFAFDBBBHKCND+rFCND+sFD/6FAKCiD+sFCnD+rFCUUU/8EDtD+uFD/mFDMBBAFCTJRFAGCIJHGAL9JQBMMGXALAI9PQBAEAICEZHGCGWHFqCBCoBAFl/8MBAEABALCGWJHLAF/8cBBGXAG9FQBAEAEDBIBHKCND+rFCND+sFD/6FAKCiD+sFCnD+rFCUUU/8EDtD+uFD/mFDMIBMALAEAF/8cBBMM9TFEaCBCB8oGUkUUBHFABCEJC98ZJHBjGUkUUBGXGXAB8/BCTWHGuQBCaREABAGlCggEJCTrXBCa6QFMAFREMAEMMMFBCUNMIT9tBB';\nconst detector = new Uint8Array([0, 97, 115, 109, 1, 0, 0, 0, 1, 4, 1, 96, 0, 0, 3, 3, 2, 0, 0, 5, 3, 1, 0, 1, 12, 1, 0, 10, 22, 2, 12, 0, 65, 0, 65, 0, 65, 0, 252, 10, 0, 0, 11, 7, 0, 65, 0, 253, 15, 26, 11]);\nconst wasmpack = new Uint8Array([32, 0, 65, 253, 3, 1, 2, 34, 4, 106, 6, 5, 11, 8, 7, 20, 13, 33, 12, 16, 128, 9, 116, 64, 19, 113, 127, 15, 10, 21, 22, 14, 255, 66, 24, 54, 136, 107, 18, 23, 192, 26, 114, 118, 132, 17, 77, 101, 130, 144, 27, 87, 131, 44, 45, 74, 156, 154, 70, 167]);\nconst FILTERS = {\n  0: '',\n  1: 'meshopt_decodeFilterOct',\n  2: 'meshopt_decodeFilterQuat',\n  3: 'meshopt_decodeFilterExp',\n  NONE: '',\n  OCTAHEDRAL: 'meshopt_decodeFilterOct',\n  QUATERNION: 'meshopt_decodeFilterQuat',\n  EXPONENTIAL: 'meshopt_decodeFilterExp'\n};\nconst DECODERS = {\n  0: 'meshopt_decodeVertexBuffer',\n  1: 'meshopt_decodeIndexBuffer',\n  2: 'meshopt_decodeIndexSequence',\n  ATTRIBUTES: 'meshopt_decodeVertexBuffer',\n  TRIANGLES: 'meshopt_decodeIndexBuffer',\n  INDICES: 'meshopt_decodeIndexSequence'\n};\nexport function isMeshoptSupported() {\n  return isWebAssemblySupported;\n}\nexport async function meshoptDecodeVertexBuffer(target, count, size, source, filter = 'NONE') {\n  const instance = await loadWasmInstance();\n  decode(instance, instance.exports.meshopt_decodeVertexBuffer, target, count, size, source, instance.exports[FILTERS[filter]]);\n}\nexport async function meshoptDecodeIndexBuffer(target, count, size, source) {\n  const instance = await loadWasmInstance();\n  decode(instance, instance.exports.meshopt_decodeIndexBuffer, target, count, size, source);\n}\nexport async function meshoptDecodeIndexSequence(target, count, size, source) {\n  const instance = await loadWasmInstance();\n  decode(instance, instance.exports.meshopt_decodeIndexSequence, target, count, size, source);\n}\nexport async function meshoptDecodeGltfBuffer(target, count, size, source, mode, filter = 'NONE') {\n  const instance = await loadWasmInstance();\n  decode(instance, instance.exports[DECODERS[mode]], target, count, size, source, instance.exports[FILTERS[filter || 'NONE']]);\n}\nlet wasmPromise;\n\nasync function loadWasmInstance() {\n  if (!wasmPromise) {\n    wasmPromise = loadWasmModule();\n  }\n\n  return wasmPromise;\n}\n\nasync function loadWasmModule() {\n  let wasm = wasm_base;\n\n  if (WebAssembly.validate(detector)) {\n    wasm = wasm_simd;\n    console.log('Warning: meshopt_decoder is using experimental SIMD support');\n  }\n\n  const result = await WebAssembly.instantiate(unpack(wasm), {});\n  await result.instance.exports.__wasm_call_ctors();\n  return result.instance;\n}\n\nfunction unpack(data) {\n  const result = new Uint8Array(data.length);\n\n  for (let i = 0; i < data.length; ++i) {\n    const ch = data.charCodeAt(i);\n    result[i] = ch > 96 ? ch - 71 : ch > 64 ? ch - 65 : ch > 47 ? ch + 4 : ch > 46 ? 63 : 62;\n  }\n\n  let write = 0;\n\n  for (let i = 0; i < data.length; ++i) {\n    result[write++] = result[i] < 60 ? wasmpack[result[i]] : (result[i] - 60) * 64 + result[++i];\n  }\n\n  return result.buffer.slice(0, write);\n}\n\nfunction decode(instance, fun, target, count, size, source, filter) {\n  const sbrk = instance.exports.sbrk;\n  const count4 = count + 3 & ~3;\n  const tp = sbrk(count4 * size);\n  const sp = sbrk(source.length);\n  const heap = new Uint8Array(instance.exports.memory.buffer);\n  heap.set(source, sp);\n  const res = fun(tp, count, size, sp, source.length);\n\n  if (res === 0 && filter) {\n    filter(tp, count4, size);\n  }\n\n  target.set(heap.subarray(tp, tp + count * size));\n  sbrk(tp - sbrk(0));\n\n  if (res !== 0) {\n    throw new Error(\"Malformed buffer data: \".concat(res));\n  }\n}\n//# sourceMappingURL=meshopt-decoder.js.map","import GLTFScenegraph from '../api/gltf-scenegraph';\nimport { meshoptDecodeGltfBuffer } from '../../meshopt/meshopt-decoder';\nconst DEFAULT_MESHOPT_OPTIONS = {\n  byteOffset: 0,\n  filter: 'NONE'\n};\nconst EXT_MESHOPT_COMPRESSION = 'EXT_meshopt_compression';\nexport const name = EXT_MESHOPT_COMPRESSION;\nexport async function decode(gltfData, options) {\n  var _options$gltf;\n\n  const scenegraph = new GLTFScenegraph(gltfData);\n\n  if (!(options !== null && options !== void 0 && (_options$gltf = options.gltf) !== null && _options$gltf !== void 0 && _options$gltf.decompressMeshes)) {\n    return;\n  }\n\n  const promises = [];\n\n  for (const bufferViewIndex of gltfData.json.bufferViews || []) {\n    promises.push(decodeMeshoptBufferView(scenegraph, bufferViewIndex));\n  }\n\n  await Promise.all(promises);\n  scenegraph.removeExtension(EXT_MESHOPT_COMPRESSION);\n}\n\nasync function decodeMeshoptBufferView(scenegraph, bufferView) {\n  const meshoptExtension = scenegraph.getObjectExtension(bufferView, EXT_MESHOPT_COMPRESSION);\n\n  if (meshoptExtension) {\n    const {\n      byteOffset = 0,\n      byteLength = 0,\n      byteStride,\n      count,\n      mode,\n      filter = 'NONE',\n      buffer: bufferIndex\n    } = meshoptExtension;\n    const buffer = scenegraph.gltf.buffers[bufferIndex];\n    const source = new Uint8Array(buffer.arrayBuffer, buffer.byteOffset + byteOffset, byteLength);\n    const result = new Uint8Array(scenegraph.gltf.buffers[bufferView.buffer].arrayBuffer, bufferView.byteOffset, bufferView.byteLength);\n    await meshoptDecodeGltfBuffer(result, count, byteStride, source, mode, filter);\n    return result;\n  }\n\n  return null;\n}\n//# sourceMappingURL=EXT_meshopt_compression.js.map","import { isBrowser } from '@loaders.gl/loader-utils';\nconst NODE_FORMAT_SUPPORT = ['image/png', 'image/jpeg', 'image/gif'];\nconst mimeTypeSupported = {};\nexport function _isImageFormatSupported(mimeType) {\n  if (mimeTypeSupported[mimeType] === undefined) {\n    mimeTypeSupported[mimeType] = checkFormatSupport(mimeType);\n  }\n\n  return mimeTypeSupported[mimeType];\n}\n\nfunction checkFormatSupport(mimeType) {\n  switch (mimeType) {\n    case 'image/webp':\n      return checkWebPSupport();\n\n    case 'image/svg':\n      return isBrowser;\n\n    default:\n      if (!isBrowser) {\n        const {\n          _parseImageNode\n        } = globalThis;\n        return Boolean(_parseImageNode) && NODE_FORMAT_SUPPORT.includes(mimeType);\n      }\n\n      return true;\n  }\n}\n\nfunction checkWebPSupport() {\n  if (!isBrowser) {\n    return false;\n  }\n\n  try {\n    const element = document.createElement('canvas');\n    return element.toDataURL('image/webp').indexOf('data:image/webp') === 0;\n  } catch {\n    return false;\n  }\n}\n//# sourceMappingURL=image-format.js.map","import { _isImageFormatSupported } from '@loaders.gl/images';\nimport GLTFScenegraph from '../api/gltf-scenegraph';\nconst EXT_TEXTURE_WEBP = 'EXT_texture_webp';\nexport const name = EXT_TEXTURE_WEBP;\nexport function preprocess(gltfData, options) {\n  const scenegraph = new GLTFScenegraph(gltfData);\n\n  if (!_isImageFormatSupported('image/webp')) {\n    if (scenegraph.getRequiredExtensions().includes(EXT_TEXTURE_WEBP)) {\n      throw new Error(\"gltf: Required extension \".concat(EXT_TEXTURE_WEBP, \" not supported by browser\"));\n    }\n\n    return;\n  }\n\n  const {\n    json\n  } = scenegraph;\n\n  for (const texture of json.textures || []) {\n    const extension = scenegraph.getObjectExtension(texture, EXT_TEXTURE_WEBP);\n\n    if (extension) {\n      texture.source = extension.source;\n    }\n\n    scenegraph.removeObjectExtension(texture, EXT_TEXTURE_WEBP);\n  }\n\n  scenegraph.removeExtension(EXT_TEXTURE_WEBP);\n}\n//# sourceMappingURL=EXT_texture_webp.js.map","import GLTFScenegraph from '../api/gltf-scenegraph';\nconst KHR_TEXTURE_BASISU = 'KHR_texture_basisu';\nexport const name = KHR_TEXTURE_BASISU;\nexport function preprocess(gltfData, options) {\n  const scene = new GLTFScenegraph(gltfData);\n  const {\n    json\n  } = scene;\n\n  for (const texture of json.textures || []) {\n    const extension = scene.getObjectExtension(texture, KHR_TEXTURE_BASISU);\n\n    if (extension) {\n      texture.source = extension.source;\n    }\n\n    scene.removeObjectExtension(texture, KHR_TEXTURE_BASISU);\n  }\n\n  scene.removeExtension(KHR_TEXTURE_BASISU);\n}\n//# sourceMappingURL=KHR_texture_basisu.js.map","import { getAccessorTypeFromSize, getComponentTypeFromArray } from './gltf-utils';\nexport function getGLTFAccessors(attributes) {\n  const accessors = {};\n\n  for (const name in attributes) {\n    const attribute = attributes[name];\n\n    if (name !== 'indices') {\n      const glTFAccessor = getGLTFAccessor(attribute);\n      accessors[name] = glTFAccessor;\n    }\n  }\n\n  return accessors;\n}\nexport function getGLTFAccessor(attribute) {\n  const {\n    buffer,\n    size,\n    count\n  } = getAccessorData(attribute);\n  const glTFAccessor = {\n    value: buffer,\n    size,\n    byteOffset: 0,\n    count,\n    type: getAccessorTypeFromSize(size),\n    componentType: getComponentTypeFromArray(buffer)\n  };\n  return glTFAccessor;\n}\n\nfunction getAccessorData(attribute) {\n  let buffer = attribute;\n  let size = 1;\n  let count = 0;\n\n  if (attribute && attribute.value) {\n    buffer = attribute.value;\n    size = attribute.size || 1;\n  }\n\n  if (buffer) {\n    if (!ArrayBuffer.isView(buffer)) {\n      buffer = toTypedArray(buffer, Float32Array);\n    }\n\n    count = buffer.length / size;\n  }\n\n  return {\n    buffer,\n    size,\n    count\n  };\n}\n\nfunction toTypedArray(array, ArrayType, convertTypedArrays = false) {\n  if (!array) {\n    return null;\n  }\n\n  if (Array.isArray(array)) {\n    return new ArrayType(array);\n  }\n\n  if (convertTypedArrays && !(array instanceof ArrayType)) {\n    return new ArrayType(array);\n  }\n\n  return array;\n}\n//# sourceMappingURL=gltf-attribute-utils.js.map","import { DracoLoader } from '@loaders.gl/draco';\nimport { sliceArrayBuffer } from '@loaders.gl/loader-utils';\nimport { default as Scenegraph } from '../api/gltf-scenegraph';\nimport { getGLTFAccessors, getGLTFAccessor } from '../gltf-utils/gltf-attribute-utils';\nconst KHR_DRACO_MESH_COMPRESSION = 'KHR_draco_mesh_compression';\nexport const name = KHR_DRACO_MESH_COMPRESSION;\nexport function preprocess(gltfData, options, context) {\n  const scenegraph = new Scenegraph(gltfData);\n\n  for (const primitive of makeMeshPrimitiveIterator(scenegraph)) {\n    if (scenegraph.getObjectExtension(primitive, KHR_DRACO_MESH_COMPRESSION)) {}\n  }\n}\nexport async function decode(gltfData, options, context) {\n  var _options$gltf;\n\n  if (!(options !== null && options !== void 0 && (_options$gltf = options.gltf) !== null && _options$gltf !== void 0 && _options$gltf.decompressMeshes)) {\n    return;\n  }\n\n  const scenegraph = new Scenegraph(gltfData);\n  const promises = [];\n\n  for (const primitive of makeMeshPrimitiveIterator(scenegraph)) {\n    if (scenegraph.getObjectExtension(primitive, KHR_DRACO_MESH_COMPRESSION)) {\n      promises.push(decompressPrimitive(scenegraph, primitive, options, context));\n    }\n  }\n\n  await Promise.all(promises);\n  scenegraph.removeExtension(KHR_DRACO_MESH_COMPRESSION);\n}\nexport function encode(gltfData, options = {}) {\n  const scenegraph = new Scenegraph(gltfData);\n\n  for (const mesh of scenegraph.json.meshes || []) {\n    compressMesh(mesh, options);\n    scenegraph.addRequiredExtension(KHR_DRACO_MESH_COMPRESSION);\n  }\n}\n\nasync function decompressPrimitive(scenegraph, primitive, options, context) {\n  const dracoExtension = scenegraph.getObjectExtension(primitive, KHR_DRACO_MESH_COMPRESSION);\n\n  if (!dracoExtension) {\n    return;\n  }\n\n  const buffer = scenegraph.getTypedArrayForBufferView(dracoExtension.bufferView);\n  const bufferCopy = sliceArrayBuffer(buffer.buffer, buffer.byteOffset);\n  const {\n    parse\n  } = context;\n  const dracoOptions = { ...options\n  };\n  delete dracoOptions['3d-tiles'];\n  const decodedData = await parse(bufferCopy, DracoLoader, dracoOptions, context);\n  const decodedAttributes = getGLTFAccessors(decodedData.attributes);\n\n  for (const [attributeName, decodedAttribute] of Object.entries(decodedAttributes)) {\n    if (attributeName in primitive.attributes) {\n      const accessorIndex = primitive.attributes[attributeName];\n      const accessor = scenegraph.getAccessor(accessorIndex);\n\n      if (accessor !== null && accessor !== void 0 && accessor.min && accessor !== null && accessor !== void 0 && accessor.max) {\n        decodedAttribute.min = accessor.min;\n        decodedAttribute.max = accessor.max;\n      }\n    }\n  }\n\n  primitive.attributes = decodedAttributes;\n\n  if (decodedData.indices) {\n    primitive.indices = getGLTFAccessor(decodedData.indices);\n  }\n\n  checkPrimitive(primitive);\n}\n\nfunction compressMesh(attributes, indices, mode = 4, options, context) {\n  var _context$parseSync;\n\n  if (!options.DracoWriter) {\n    throw new Error('options.gltf.DracoWriter not provided');\n  }\n\n  const compressedData = options.DracoWriter.encodeSync({\n    attributes\n  });\n  const decodedData = context === null || context === void 0 ? void 0 : (_context$parseSync = context.parseSync) === null || _context$parseSync === void 0 ? void 0 : _context$parseSync.call(context, {\n    attributes\n  });\n\n  const fauxAccessors = options._addFauxAttributes(decodedData.attributes);\n\n  const bufferViewIndex = options.addBufferView(compressedData);\n  const glTFMesh = {\n    primitives: [{\n      attributes: fauxAccessors,\n      mode,\n      extensions: {\n        [KHR_DRACO_MESH_COMPRESSION]: {\n          bufferView: bufferViewIndex,\n          attributes: fauxAccessors\n        }\n      }\n    }]\n  };\n  return glTFMesh;\n}\n\nfunction checkPrimitive(primitive) {\n  if (!primitive.attributes && Object.keys(primitive.attributes).length > 0) {\n    throw new Error('glTF: Empty primitive detected: Draco decompression failure?');\n  }\n}\n\nfunction* makeMeshPrimitiveIterator(scenegraph) {\n  for (const mesh of scenegraph.json.meshes || []) {\n    for (const primitive of mesh.primitives) {\n      yield primitive;\n    }\n  }\n}\n//# sourceMappingURL=KHR_draco_mesh_compression.js.map","import { assert } from '../../utils/assert';\nimport GLTFScenegraph from '../../api/gltf-scenegraph';\nconst KHR_LIGHTS_PUNCTUAL = 'KHR_lights_punctual';\nexport const name = KHR_LIGHTS_PUNCTUAL;\nexport async function decode(gltfData) {\n  const gltfScenegraph = new GLTFScenegraph(gltfData);\n  const {\n    json\n  } = gltfScenegraph;\n  const extension = gltfScenegraph.getExtension(KHR_LIGHTS_PUNCTUAL);\n\n  if (extension) {\n    gltfScenegraph.json.lights = extension.lights;\n    gltfScenegraph.removeExtension(KHR_LIGHTS_PUNCTUAL);\n  }\n\n  for (const node of json.nodes || []) {\n    const nodeExtension = gltfScenegraph.getObjectExtension(node, KHR_LIGHTS_PUNCTUAL);\n\n    if (nodeExtension) {\n      node.light = nodeExtension.light;\n    }\n\n    gltfScenegraph.removeObjectExtension(node, KHR_LIGHTS_PUNCTUAL);\n  }\n}\nexport async function encode(gltfData) {\n  const gltfScenegraph = new GLTFScenegraph(gltfData);\n  const {\n    json\n  } = gltfScenegraph;\n\n  if (json.lights) {\n    const extension = gltfScenegraph.addExtension(KHR_LIGHTS_PUNCTUAL);\n    assert(!extension.lights);\n    extension.lights = json.lights;\n    delete json.lights;\n  }\n\n  if (gltfScenegraph.json.lights) {\n    for (const light of gltfScenegraph.json.lights) {\n      const node = light.node;\n      gltfScenegraph.addObjectExtension(node, KHR_LIGHTS_PUNCTUAL, light);\n    }\n\n    delete gltfScenegraph.json.lights;\n  }\n}\n//# sourceMappingURL=KHR_lights_punctual.js.map","import GLTFScenegraph from '../../api/gltf-scenegraph';\nconst KHR_MATERIALS_UNLIT = 'KHR_materials_unlit';\nexport const name = KHR_MATERIALS_UNLIT;\nexport async function decode(gltfData) {\n  const gltfScenegraph = new GLTFScenegraph(gltfData);\n  const {\n    json\n  } = gltfScenegraph;\n  gltfScenegraph.removeExtension(KHR_MATERIALS_UNLIT);\n\n  for (const material of json.materials || []) {\n    const extension = material.extensions && material.extensions.KHR_materials_unlit;\n\n    if (extension) {\n      material.unlit = true;\n    }\n\n    gltfScenegraph.removeObjectExtension(material, KHR_MATERIALS_UNLIT);\n  }\n}\nexport function encode(gltfData) {\n  const gltfScenegraph = new GLTFScenegraph(gltfData);\n  const {\n    json\n  } = gltfScenegraph;\n\n  if (gltfScenegraph.materials) {\n    for (const material of json.materials || []) {\n      if (material.unlit) {\n        delete material.unlit;\n        gltfScenegraph.addObjectExtension(material, KHR_MATERIALS_UNLIT, {});\n        gltfScenegraph.addExtension(KHR_MATERIALS_UNLIT);\n      }\n    }\n  }\n}\n//# sourceMappingURL=KHR_materials_unlit.js.map","import GLTFScenegraph from '../../api/gltf-scenegraph';\nconst KHR_TECHNIQUES_WEBGL = 'KHR_techniques_webgl';\nexport const name = KHR_TECHNIQUES_WEBGL;\nexport async function decode(gltfData) {\n  const gltfScenegraph = new GLTFScenegraph(gltfData);\n  const {\n    json\n  } = gltfScenegraph;\n  const extension = gltfScenegraph.getExtension(KHR_TECHNIQUES_WEBGL);\n\n  if (extension) {\n    const techniques = resolveTechniques(extension, gltfScenegraph);\n\n    for (const material of json.materials || []) {\n      const materialExtension = gltfScenegraph.getObjectExtension(material, KHR_TECHNIQUES_WEBGL);\n\n      if (materialExtension) {\n        material.technique = Object.assign({}, materialExtension, techniques[materialExtension.technique]);\n        material.technique.values = resolveValues(material.technique, gltfScenegraph);\n      }\n\n      gltfScenegraph.removeObjectExtension(material, KHR_TECHNIQUES_WEBGL);\n    }\n\n    gltfScenegraph.removeExtension(KHR_TECHNIQUES_WEBGL);\n  }\n}\nexport async function encode(gltfData, options) {}\n\nfunction resolveTechniques(techniquesExtension, gltfScenegraph) {\n  const {\n    programs = [],\n    shaders = [],\n    techniques = []\n  } = techniquesExtension;\n  const textDecoder = new TextDecoder();\n  shaders.forEach(shader => {\n    if (Number.isFinite(shader.bufferView)) {\n      shader.code = textDecoder.decode(gltfScenegraph.getTypedArrayForBufferView(shader.bufferView));\n    } else {\n      throw new Error('KHR_techniques_webgl: no shader code');\n    }\n  });\n  programs.forEach(program => {\n    program.fragmentShader = shaders[program.fragmentShader];\n    program.vertexShader = shaders[program.vertexShader];\n  });\n  techniques.forEach(technique => {\n    technique.program = programs[technique.program];\n  });\n  return techniques;\n}\n\nfunction resolveValues(technique, gltfScenegraph) {\n  const values = Object.assign({}, technique.values);\n  Object.keys(technique.uniforms || {}).forEach(uniform => {\n    if (technique.uniforms[uniform].value && !(uniform in values)) {\n      values[uniform] = technique.uniforms[uniform].value;\n    }\n  });\n  Object.keys(values).forEach(uniform => {\n    if (typeof values[uniform] === 'object' && values[uniform].index !== undefined) {\n      values[uniform].texture = gltfScenegraph.getTexture(values[uniform].index);\n    }\n  });\n  return values;\n}\n//# sourceMappingURL=KHR_techniques_webgl.js.map","import * as EXT_meshopt_compression from '../extensions/EXT_meshopt_compression';\nimport * as EXT_texture_webp from '../extensions/EXT_texture_webp';\nimport * as KHR_texture_basisu from '../extensions/KHR_texture_basisu';\nimport * as KHR_draco_mesh_compression from '../extensions/KHR_draco_mesh_compression';\nimport * as KHR_lights_punctual from '../extensions/deprecated/KHR_lights_punctual';\nimport * as KHR_materials_unlit from '../extensions/deprecated/KHR_materials_unlit';\nimport * as KHR_techniques_webgl from '../extensions/deprecated/KHR_techniques_webgl';\nexport const EXTENSIONS = [EXT_meshopt_compression, EXT_texture_webp, KHR_texture_basisu, KHR_draco_mesh_compression, KHR_lights_punctual, KHR_materials_unlit, KHR_techniques_webgl];\nexport function preprocessExtensions(gltf, options = {}, context) {\n  const extensions = EXTENSIONS.filter(extension => useExtension(extension.name, options));\n\n  for (const extension of extensions) {\n    var _extension$preprocess;\n\n    (_extension$preprocess = extension.preprocess) === null || _extension$preprocess === void 0 ? void 0 : _extension$preprocess.call(extension, gltf, options, context);\n  }\n}\nexport async function decodeExtensions(gltf, options = {}, context) {\n  const extensions = EXTENSIONS.filter(extension => useExtension(extension.name, options));\n\n  for (const extension of extensions) {\n    var _extension$decode;\n\n    await ((_extension$decode = extension.decode) === null || _extension$decode === void 0 ? void 0 : _extension$decode.call(extension, gltf, options, context));\n  }\n}\n\nfunction useExtension(extensionName, options) {\n  var _options$gltf;\n\n  const excludes = (options === null || options === void 0 ? void 0 : (_options$gltf = options.gltf) === null || _options$gltf === void 0 ? void 0 : _options$gltf.excludeExtensions) || {};\n  const exclude = extensionName in excludes && !excludes[extensionName];\n  return !exclude;\n}\n//# sourceMappingURL=gltf-extensions.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport * as KHR_binary_glTF from '../extensions/KHR_binary_gltf';\nconst GLTF_ARRAYS = {\n  accessors: 'accessor',\n  animations: 'animation',\n  buffers: 'buffer',\n  bufferViews: 'bufferView',\n  images: 'image',\n  materials: 'material',\n  meshes: 'mesh',\n  nodes: 'node',\n  samplers: 'sampler',\n  scenes: 'scene',\n  skins: 'skin',\n  textures: 'texture'\n};\nconst GLTF_KEYS = {\n  accessor: 'accessors',\n  animations: 'animation',\n  buffer: 'buffers',\n  bufferView: 'bufferViews',\n  image: 'images',\n  material: 'materials',\n  mesh: 'meshes',\n  node: 'nodes',\n  sampler: 'samplers',\n  scene: 'scenes',\n  skin: 'skins',\n  texture: 'textures'\n};\n\nclass GLTFV1Normalizer {\n  constructor() {\n    _defineProperty(this, \"idToIndexMap\", {\n      animations: {},\n      accessors: {},\n      buffers: {},\n      bufferViews: {},\n      images: {},\n      materials: {},\n      meshes: {},\n      nodes: {},\n      samplers: {},\n      scenes: {},\n      skins: {},\n      textures: {}\n    });\n\n    _defineProperty(this, \"json\", void 0);\n  }\n\n  normalize(gltf, options) {\n    this.json = gltf.json;\n    const json = gltf.json;\n\n    switch (json.asset && json.asset.version) {\n      case '2.0':\n        return;\n\n      case undefined:\n      case '1.0':\n        break;\n\n      default:\n        console.warn(\"glTF: Unknown version \".concat(json.asset.version));\n        return;\n    }\n\n    if (!options.normalize) {\n      throw new Error('glTF v1 is not supported.');\n    }\n\n    console.warn('Converting glTF v1 to glTF v2 format. This is experimental and may fail.');\n\n    this._addAsset(json);\n\n    this._convertTopLevelObjectsToArrays(json);\n\n    KHR_binary_glTF.preprocess(gltf);\n\n    this._convertObjectIdsToArrayIndices(json);\n\n    this._updateObjects(json);\n\n    this._updateMaterial(json);\n  }\n\n  _addAsset(json) {\n    json.asset = json.asset || {};\n    json.asset.version = '2.0';\n    json.asset.generator = json.asset.generator || 'Normalized to glTF 2.0 by loaders.gl';\n  }\n\n  _convertTopLevelObjectsToArrays(json) {\n    for (const arrayName in GLTF_ARRAYS) {\n      this._convertTopLevelObjectToArray(json, arrayName);\n    }\n  }\n\n  _convertTopLevelObjectToArray(json, mapName) {\n    const objectMap = json[mapName];\n\n    if (!objectMap || Array.isArray(objectMap)) {\n      return;\n    }\n\n    json[mapName] = [];\n\n    for (const id in objectMap) {\n      const object = objectMap[id];\n      object.id = object.id || id;\n      const index = json[mapName].length;\n      json[mapName].push(object);\n      this.idToIndexMap[mapName][id] = index;\n    }\n  }\n\n  _convertObjectIdsToArrayIndices(json) {\n    for (const arrayName in GLTF_ARRAYS) {\n      this._convertIdsToIndices(json, arrayName);\n    }\n\n    if ('scene' in json) {\n      json.scene = this._convertIdToIndex(json.scene, 'scene');\n    }\n\n    for (const texture of json.textures) {\n      this._convertTextureIds(texture);\n    }\n\n    for (const mesh of json.meshes) {\n      this._convertMeshIds(mesh);\n    }\n\n    for (const node of json.nodes) {\n      this._convertNodeIds(node);\n    }\n\n    for (const node of json.scenes) {\n      this._convertSceneIds(node);\n    }\n  }\n\n  _convertTextureIds(texture) {\n    if (texture.source) {\n      texture.source = this._convertIdToIndex(texture.source, 'image');\n    }\n  }\n\n  _convertMeshIds(mesh) {\n    for (const primitive of mesh.primitives) {\n      const {\n        attributes,\n        indices,\n        material\n      } = primitive;\n\n      for (const attributeName in attributes) {\n        attributes[attributeName] = this._convertIdToIndex(attributes[attributeName], 'accessor');\n      }\n\n      if (indices) {\n        primitive.indices = this._convertIdToIndex(indices, 'accessor');\n      }\n\n      if (material) {\n        primitive.material = this._convertIdToIndex(material, 'material');\n      }\n    }\n  }\n\n  _convertNodeIds(node) {\n    if (node.children) {\n      node.children = node.children.map(child => this._convertIdToIndex(child, 'node'));\n    }\n\n    if (node.meshes) {\n      node.meshes = node.meshes.map(mesh => this._convertIdToIndex(mesh, 'mesh'));\n    }\n  }\n\n  _convertSceneIds(scene) {\n    if (scene.nodes) {\n      scene.nodes = scene.nodes.map(node => this._convertIdToIndex(node, 'node'));\n    }\n  }\n\n  _convertIdsToIndices(json, topLevelArrayName) {\n    if (!json[topLevelArrayName]) {\n      console.warn(\"gltf v1: json doesn't contain attribute \".concat(topLevelArrayName));\n      json[topLevelArrayName] = [];\n    }\n\n    for (const object of json[topLevelArrayName]) {\n      for (const key in object) {\n        const id = object[key];\n\n        const index = this._convertIdToIndex(id, key);\n\n        object[key] = index;\n      }\n    }\n  }\n\n  _convertIdToIndex(id, key) {\n    const arrayName = GLTF_KEYS[key];\n\n    if (arrayName in this.idToIndexMap) {\n      const index = this.idToIndexMap[arrayName][id];\n\n      if (!Number.isFinite(index)) {\n        throw new Error(\"gltf v1: failed to resolve \".concat(key, \" with id \").concat(id));\n      }\n\n      return index;\n    }\n\n    return id;\n  }\n\n  _updateObjects(json) {\n    for (const buffer of this.json.buffers) {\n      delete buffer.type;\n    }\n  }\n\n  _updateMaterial(json) {\n    for (const material of json.materials) {\n      var _material$values, _material$values2, _material$values3;\n\n      material.pbrMetallicRoughness = {\n        baseColorFactor: [1, 1, 1, 1],\n        metallicFactor: 1,\n        roughnessFactor: 1\n      };\n      const textureId = ((_material$values = material.values) === null || _material$values === void 0 ? void 0 : _material$values.tex) || ((_material$values2 = material.values) === null || _material$values2 === void 0 ? void 0 : _material$values2.texture2d_0) || ((_material$values3 = material.values) === null || _material$values3 === void 0 ? void 0 : _material$values3.diffuseTex);\n      const textureIndex = json.textures.findIndex(texture => texture.id === textureId);\n\n      if (textureIndex !== -1) {\n        material.pbrMetallicRoughness.baseColorTexture = {\n          index: textureIndex\n        };\n      }\n    }\n  }\n\n}\n\nexport function normalizeGLTFV1(gltf, options = {}) {\n  return new GLTFV1Normalizer().normalize(gltf, options);\n}\n//# sourceMappingURL=normalize-gltf-v1.js.map","import GLTFScenegraph from '../api/gltf-scenegraph';\nconst KHR_BINARY_GLTF = 'KHR_binary_glTF';\nexport const name = KHR_BINARY_GLTF;\nexport function preprocess(gltfData) {\n  const gltfScenegraph = new GLTFScenegraph(gltfData);\n  const {\n    json\n  } = gltfScenegraph;\n\n  for (const image of json.images || []) {\n    const extension = gltfScenegraph.getObjectExtension(image, KHR_BINARY_GLTF);\n\n    if (extension) {\n      Object.assign(image, extension);\n    }\n\n    gltfScenegraph.removeObjectExtension(image, KHR_BINARY_GLTF);\n  }\n\n  if (json.buffers && json.buffers[0]) {\n    delete json.buffers[0].uri;\n  }\n\n  gltfScenegraph.removeExtension(KHR_BINARY_GLTF);\n}\n//# sourceMappingURL=KHR_binary_gltf.js.map","import _defineProperty from \"@babel/runtime/helpers/esm/defineProperty\";\nimport { assert } from '../utils/assert';\nimport { getAccessorArrayTypeAndLength } from '../gltf-utils/gltf-utils';\nconst COMPONENTS = {\n  SCALAR: 1,\n  VEC2: 2,\n  VEC3: 3,\n  VEC4: 4,\n  MAT2: 4,\n  MAT3: 9,\n  MAT4: 16\n};\nconst BYTES = {\n  5120: 1,\n  5121: 1,\n  5122: 2,\n  5123: 2,\n  5125: 4,\n  5126: 4\n};\nconst GL_SAMPLER = {\n  TEXTURE_MAG_FILTER: 0x2800,\n  TEXTURE_MIN_FILTER: 0x2801,\n  TEXTURE_WRAP_S: 0x2802,\n  TEXTURE_WRAP_T: 0x2803,\n  REPEAT: 0x2901,\n  LINEAR: 0x2601,\n  NEAREST_MIPMAP_LINEAR: 0x2702\n};\nconst SAMPLER_PARAMETER_GLTF_TO_GL = {\n  magFilter: GL_SAMPLER.TEXTURE_MAG_FILTER,\n  minFilter: GL_SAMPLER.TEXTURE_MIN_FILTER,\n  wrapS: GL_SAMPLER.TEXTURE_WRAP_S,\n  wrapT: GL_SAMPLER.TEXTURE_WRAP_T\n};\nconst DEFAULT_SAMPLER = {\n  [GL_SAMPLER.TEXTURE_MAG_FILTER]: GL_SAMPLER.LINEAR,\n  [GL_SAMPLER.TEXTURE_MIN_FILTER]: GL_SAMPLER.NEAREST_MIPMAP_LINEAR,\n  [GL_SAMPLER.TEXTURE_WRAP_S]: GL_SAMPLER.REPEAT,\n  [GL_SAMPLER.TEXTURE_WRAP_T]: GL_SAMPLER.REPEAT\n};\n\nfunction getBytesFromComponentType(componentType) {\n  return BYTES[componentType];\n}\n\nfunction getSizeFromAccessorType(type) {\n  return COMPONENTS[type];\n}\n\nclass GLTFPostProcessor {\n  constructor() {\n    _defineProperty(this, \"baseUri\", '');\n\n    _defineProperty(this, \"json\", {});\n\n    _defineProperty(this, \"buffers\", []);\n\n    _defineProperty(this, \"images\", []);\n  }\n\n  postProcess(gltf, options = {}) {\n    const {\n      json,\n      buffers = [],\n      images = [],\n      baseUri = ''\n    } = gltf;\n    assert(json);\n    this.baseUri = baseUri;\n    this.json = json;\n    this.buffers = buffers;\n    this.images = images;\n\n    this._resolveTree(this.json, options);\n\n    return this.json;\n  }\n\n  _resolveTree(json, options = {}) {\n    if (json.bufferViews) {\n      json.bufferViews = json.bufferViews.map((bufView, i) => this._resolveBufferView(bufView, i));\n    }\n\n    if (json.images) {\n      json.images = json.images.map((image, i) => this._resolveImage(image, i));\n    }\n\n    if (json.samplers) {\n      json.samplers = json.samplers.map((sampler, i) => this._resolveSampler(sampler, i));\n    }\n\n    if (json.textures) {\n      json.textures = json.textures.map((texture, i) => this._resolveTexture(texture, i));\n    }\n\n    if (json.accessors) {\n      json.accessors = json.accessors.map((accessor, i) => this._resolveAccessor(accessor, i));\n    }\n\n    if (json.materials) {\n      json.materials = json.materials.map((material, i) => this._resolveMaterial(material, i));\n    }\n\n    if (json.meshes) {\n      json.meshes = json.meshes.map((mesh, i) => this._resolveMesh(mesh, i));\n    }\n\n    if (json.nodes) {\n      json.nodes = json.nodes.map((node, i) => this._resolveNode(node, i));\n    }\n\n    if (json.skins) {\n      json.skins = json.skins.map((skin, i) => this._resolveSkin(skin, i));\n    }\n\n    if (json.scenes) {\n      json.scenes = json.scenes.map((scene, i) => this._resolveScene(scene, i));\n    }\n\n    if (json.scene !== undefined) {\n      json.scene = json.scenes[this.json.scene];\n    }\n  }\n\n  getScene(index) {\n    return this._get('scenes', index);\n  }\n\n  getNode(index) {\n    return this._get('nodes', index);\n  }\n\n  getSkin(index) {\n    return this._get('skins', index);\n  }\n\n  getMesh(index) {\n    return this._get('meshes', index);\n  }\n\n  getMaterial(index) {\n    return this._get('materials', index);\n  }\n\n  getAccessor(index) {\n    return this._get('accessors', index);\n  }\n\n  getCamera(index) {\n    return null;\n  }\n\n  getTexture(index) {\n    return this._get('textures', index);\n  }\n\n  getSampler(index) {\n    return this._get('samplers', index);\n  }\n\n  getImage(index) {\n    return this._get('images', index);\n  }\n\n  getBufferView(index) {\n    return this._get('bufferViews', index);\n  }\n\n  getBuffer(index) {\n    return this._get('buffers', index);\n  }\n\n  _get(array, index) {\n    if (typeof index === 'object') {\n      return index;\n    }\n\n    const object = this.json[array] && this.json[array][index];\n\n    if (!object) {\n      console.warn(\"glTF file error: Could not find \".concat(array, \"[\").concat(index, \"]\"));\n    }\n\n    return object;\n  }\n\n  _resolveScene(scene, index) {\n    scene.id = scene.id || \"scene-\".concat(index);\n    scene.nodes = (scene.nodes || []).map(node => this.getNode(node));\n    return scene;\n  }\n\n  _resolveNode(node, index) {\n    node.id = node.id || \"node-\".concat(index);\n\n    if (node.children) {\n      node.children = node.children.map(child => this.getNode(child));\n    }\n\n    if (node.mesh !== undefined) {\n      node.mesh = this.getMesh(node.mesh);\n    } else if (node.meshes !== undefined && node.meshes.length) {\n      node.mesh = node.meshes.reduce((accum, meshIndex) => {\n        const mesh = this.getMesh(meshIndex);\n        accum.id = mesh.id;\n        accum.primitives = accum.primitives.concat(mesh.primitives);\n        return accum;\n      }, {\n        primitives: []\n      });\n    }\n\n    if (node.camera !== undefined) {\n      node.camera = this.getCamera(node.camera);\n    }\n\n    if (node.skin !== undefined) {\n      node.skin = this.getSkin(node.skin);\n    }\n\n    return node;\n  }\n\n  _resolveSkin(skin, index) {\n    skin.id = skin.id || \"skin-\".concat(index);\n    skin.inverseBindMatrices = this.getAccessor(skin.inverseBindMatrices);\n    return skin;\n  }\n\n  _resolveMesh(mesh, index) {\n    mesh.id = mesh.id || \"mesh-\".concat(index);\n\n    if (mesh.primitives) {\n      mesh.primitives = mesh.primitives.map(primitive => {\n        primitive = { ...primitive\n        };\n        const attributes = primitive.attributes;\n        primitive.attributes = {};\n\n        for (const attribute in attributes) {\n          primitive.attributes[attribute] = this.getAccessor(attributes[attribute]);\n        }\n\n        if (primitive.indices !== undefined) {\n          primitive.indices = this.getAccessor(primitive.indices);\n        }\n\n        if (primitive.material !== undefined) {\n          primitive.material = this.getMaterial(primitive.material);\n        }\n\n        return primitive;\n      });\n    }\n\n    return mesh;\n  }\n\n  _resolveMaterial(material, index) {\n    material.id = material.id || \"material-\".concat(index);\n\n    if (material.normalTexture) {\n      material.normalTexture = { ...material.normalTexture\n      };\n      material.normalTexture.texture = this.getTexture(material.normalTexture.index);\n    }\n\n    if (material.occlusionTexture) {\n      material.occlustionTexture = { ...material.occlustionTexture\n      };\n      material.occlusionTexture.texture = this.getTexture(material.occlusionTexture.index);\n    }\n\n    if (material.emissiveTexture) {\n      material.emmisiveTexture = { ...material.emmisiveTexture\n      };\n      material.emissiveTexture.texture = this.getTexture(material.emissiveTexture.index);\n    }\n\n    if (!material.emissiveFactor) {\n      material.emissiveFactor = material.emmisiveTexture ? [1, 1, 1] : [0, 0, 0];\n    }\n\n    if (material.pbrMetallicRoughness) {\n      material.pbrMetallicRoughness = { ...material.pbrMetallicRoughness\n      };\n      const mr = material.pbrMetallicRoughness;\n\n      if (mr.baseColorTexture) {\n        mr.baseColorTexture = { ...mr.baseColorTexture\n        };\n        mr.baseColorTexture.texture = this.getTexture(mr.baseColorTexture.index);\n      }\n\n      if (mr.metallicRoughnessTexture) {\n        mr.metallicRoughnessTexture = { ...mr.metallicRoughnessTexture\n        };\n        mr.metallicRoughnessTexture.texture = this.getTexture(mr.metallicRoughnessTexture.index);\n      }\n    }\n\n    return material;\n  }\n\n  _resolveAccessor(accessor, index) {\n    accessor.id = accessor.id || \"accessor-\".concat(index);\n\n    if (accessor.bufferView !== undefined) {\n      accessor.bufferView = this.getBufferView(accessor.bufferView);\n    }\n\n    accessor.bytesPerComponent = getBytesFromComponentType(accessor.componentType);\n    accessor.components = getSizeFromAccessorType(accessor.type);\n    accessor.bytesPerElement = accessor.bytesPerComponent * accessor.components;\n\n    if (accessor.bufferView) {\n      const buffer = accessor.bufferView.buffer;\n      const {\n        ArrayType,\n        byteLength\n      } = getAccessorArrayTypeAndLength(accessor, accessor.bufferView);\n      const byteOffset = (accessor.bufferView.byteOffset || 0) + (accessor.byteOffset || 0) + buffer.byteOffset;\n      let cutBuffer = buffer.arrayBuffer.slice(byteOffset, byteOffset + byteLength);\n\n      if (accessor.bufferView.byteStride) {\n        cutBuffer = this._getValueFromInterleavedBuffer(buffer, byteOffset, accessor.bufferView.byteStride, accessor.bytesPerElement, accessor.count);\n      }\n\n      accessor.value = new ArrayType(cutBuffer);\n    }\n\n    return accessor;\n  }\n\n  _getValueFromInterleavedBuffer(buffer, byteOffset, byteStride, bytesPerElement, count) {\n    const result = new Uint8Array(count * bytesPerElement);\n\n    for (let i = 0; i < count; i++) {\n      const elementOffset = byteOffset + i * byteStride;\n      result.set(new Uint8Array(buffer.arrayBuffer.slice(elementOffset, elementOffset + bytesPerElement)), i * bytesPerElement);\n    }\n\n    return result.buffer;\n  }\n\n  _resolveTexture(texture, index) {\n    texture.id = texture.id || \"texture-\".concat(index);\n    texture.sampler = 'sampler' in texture ? this.getSampler(texture.sampler) : DEFAULT_SAMPLER;\n    texture.source = this.getImage(texture.source);\n    return texture;\n  }\n\n  _resolveSampler(sampler, index) {\n    sampler.id = sampler.id || \"sampler-\".concat(index);\n    sampler.parameters = {};\n\n    for (const key in sampler) {\n      const glEnum = this._enumSamplerParameter(key);\n\n      if (glEnum !== undefined) {\n        sampler.parameters[glEnum] = sampler[key];\n      }\n    }\n\n    return sampler;\n  }\n\n  _enumSamplerParameter(key) {\n    return SAMPLER_PARAMETER_GLTF_TO_GL[key];\n  }\n\n  _resolveImage(image, index) {\n    image.id = image.id || \"image-\".concat(index);\n\n    if (image.bufferView !== undefined) {\n      image.bufferView = this.getBufferView(image.bufferView);\n    }\n\n    const preloadedImage = this.images[index];\n\n    if (preloadedImage) {\n      image.image = preloadedImage;\n    }\n\n    return image;\n  }\n\n  _resolveBufferView(bufferView, index) {\n    const bufferIndex = bufferView.buffer;\n    const result = {\n      id: \"bufferView-\".concat(index),\n      ...bufferView,\n      buffer: this.buffers[bufferIndex]\n    };\n    const arrayBuffer = this.buffers[bufferIndex].arrayBuffer;\n    let byteOffset = this.buffers[bufferIndex].byteOffset || 0;\n\n    if ('byteOffset' in bufferView) {\n      byteOffset += bufferView.byteOffset;\n    }\n\n    result.data = new Uint8Array(arrayBuffer, byteOffset, bufferView.byteLength);\n    return result;\n  }\n\n  _resolveCamera(camera, index) {\n    camera.id = camera.id || \"camera-\".concat(index);\n\n    if (camera.perspective) {}\n\n    if (camera.orthographic) {}\n\n    return camera;\n  }\n\n}\n\nexport function postProcessGLTF(gltf, options) {\n  return new GLTFPostProcessor().postProcess(gltf, options);\n}\n//# sourceMappingURL=post-process-gltf.js.map","import { padToNBytes, assert } from '@loaders.gl/loader-utils';\nconst MAGIC_glTF = 0x676c5446;\nconst GLB_FILE_HEADER_SIZE = 12;\nconst GLB_CHUNK_HEADER_SIZE = 8;\nconst GLB_CHUNK_TYPE_JSON = 0x4e4f534a;\nconst GLB_CHUNK_TYPE_BIN = 0x004e4942;\nconst GLB_CHUNK_TYPE_JSON_XVIZ_DEPRECATED = 0;\nconst GLB_CHUNK_TYPE_BIX_XVIZ_DEPRECATED = 1;\nconst GLB_V1_CONTENT_FORMAT_JSON = 0x0;\nconst LE = true;\n\nfunction getMagicString(dataView, byteOffset = 0) {\n  return \"\".concat(String.fromCharCode(dataView.getUint8(byteOffset + 0))).concat(String.fromCharCode(dataView.getUint8(byteOffset + 1))).concat(String.fromCharCode(dataView.getUint8(byteOffset + 2))).concat(String.fromCharCode(dataView.getUint8(byteOffset + 3)));\n}\n\nexport function isGLB(arrayBuffer, byteOffset = 0, options = {}) {\n  const dataView = new DataView(arrayBuffer);\n  const {\n    magic = MAGIC_glTF\n  } = options;\n  const magic1 = dataView.getUint32(byteOffset, false);\n  return magic1 === magic || magic1 === MAGIC_glTF;\n}\nexport default function parseGLBSync(glb, arrayBuffer, byteOffset = 0, options = {}) {\n  const dataView = new DataView(arrayBuffer);\n  const type = getMagicString(dataView, byteOffset + 0);\n  const version = dataView.getUint32(byteOffset + 4, LE);\n  const byteLength = dataView.getUint32(byteOffset + 8, LE);\n  Object.assign(glb, {\n    header: {\n      byteOffset,\n      byteLength,\n      hasBinChunk: false\n    },\n    type,\n    version,\n    json: {},\n    binChunks: []\n  });\n  byteOffset += GLB_FILE_HEADER_SIZE;\n\n  switch (glb.version) {\n    case 1:\n      return parseGLBV1(glb, dataView, byteOffset);\n\n    case 2:\n      return parseGLBV2(glb, dataView, byteOffset, options = {});\n\n    default:\n      throw new Error(\"Invalid GLB version \".concat(glb.version, \". Only supports v1 and v2.\"));\n  }\n}\n\nfunction parseGLBV1(glb, dataView, byteOffset) {\n  assert(glb.header.byteLength > GLB_FILE_HEADER_SIZE + GLB_CHUNK_HEADER_SIZE);\n  const contentLength = dataView.getUint32(byteOffset + 0, LE);\n  const contentFormat = dataView.getUint32(byteOffset + 4, LE);\n  byteOffset += GLB_CHUNK_HEADER_SIZE;\n  assert(contentFormat === GLB_V1_CONTENT_FORMAT_JSON);\n  parseJSONChunk(glb, dataView, byteOffset, contentLength);\n  byteOffset += contentLength;\n  byteOffset += parseBINChunk(glb, dataView, byteOffset, glb.header.byteLength);\n  return byteOffset;\n}\n\nfunction parseGLBV2(glb, dataView, byteOffset, options) {\n  assert(glb.header.byteLength > GLB_FILE_HEADER_SIZE + GLB_CHUNK_HEADER_SIZE);\n  parseGLBChunksSync(glb, dataView, byteOffset, options);\n  return byteOffset + glb.header.byteLength;\n}\n\nfunction parseGLBChunksSync(glb, dataView, byteOffset, options) {\n  while (byteOffset + 8 <= glb.header.byteLength) {\n    const chunkLength = dataView.getUint32(byteOffset + 0, LE);\n    const chunkFormat = dataView.getUint32(byteOffset + 4, LE);\n    byteOffset += GLB_CHUNK_HEADER_SIZE;\n\n    switch (chunkFormat) {\n      case GLB_CHUNK_TYPE_JSON:\n        parseJSONChunk(glb, dataView, byteOffset, chunkLength);\n        break;\n\n      case GLB_CHUNK_TYPE_BIN:\n        parseBINChunk(glb, dataView, byteOffset, chunkLength);\n        break;\n\n      case GLB_CHUNK_TYPE_JSON_XVIZ_DEPRECATED:\n        if (!options.strict) {\n          parseJSONChunk(glb, dataView, byteOffset, chunkLength);\n        }\n\n        break;\n\n      case GLB_CHUNK_TYPE_BIX_XVIZ_DEPRECATED:\n        if (!options.strict) {\n          parseBINChunk(glb, dataView, byteOffset, chunkLength);\n        }\n\n        break;\n\n      default:\n        break;\n    }\n\n    byteOffset += padToNBytes(chunkLength, 4);\n  }\n\n  return byteOffset;\n}\n\nfunction parseJSONChunk(glb, dataView, byteOffset, chunkLength) {\n  const jsonChunk = new Uint8Array(dataView.buffer, byteOffset, chunkLength);\n  const textDecoder = new TextDecoder('utf8');\n  const jsonText = textDecoder.decode(jsonChunk);\n  glb.json = JSON.parse(jsonText);\n  return padToNBytes(chunkLength, 4);\n}\n\nfunction parseBINChunk(glb, dataView, byteOffset, chunkLength) {\n  glb.header.hasBinChunk = true;\n  glb.binChunks.push({\n    byteOffset,\n    byteLength: chunkLength,\n    arrayBuffer: dataView.buffer\n  });\n  return padToNBytes(chunkLength, 4);\n}\n//# sourceMappingURL=parse-glb.js.map","import { BasisLoader, selectSupportedBasisFormat } from '@loaders.gl/textures';\nimport { ImageLoader } from '@loaders.gl/images';\nimport { parseJSON, sliceArrayBuffer } from '@loaders.gl/loader-utils';\nimport { assert } from '../utils/assert';\nimport { resolveUrl } from '../gltf-utils/resolve-url';\nimport { getTypedArrayForBufferView } from '../gltf-utils/get-typed-array';\nimport { preprocessExtensions, decodeExtensions } from '../api/gltf-extensions';\nimport { normalizeGLTFV1 } from '../api/normalize-gltf-v1';\nimport { postProcessGLTF } from '../api/post-process-gltf';\nimport parseGLBSync, { isGLB } from './parse-glb';\nexport function isGLTF(arrayBuffer, options) {\n  const byteOffset = 0;\n  return isGLB(arrayBuffer, byteOffset, options);\n}\nexport async function parseGLTF(gltf, arrayBufferOrString, byteOffset = 0, options, context) {\n  var _options$gltf, _options$gltf2, _options$gltf3, _options$gltf4;\n\n  parseGLTFContainerSync(gltf, arrayBufferOrString, byteOffset, options);\n  normalizeGLTFV1(gltf, {\n    normalize: options === null || options === void 0 ? void 0 : (_options$gltf = options.gltf) === null || _options$gltf === void 0 ? void 0 : _options$gltf.normalize\n  });\n  preprocessExtensions(gltf, options, context);\n  const promises = [];\n\n  if (options !== null && options !== void 0 && (_options$gltf2 = options.gltf) !== null && _options$gltf2 !== void 0 && _options$gltf2.loadBuffers && gltf.json.buffers) {\n    await loadBuffers(gltf, options, context);\n  }\n\n  if (options !== null && options !== void 0 && (_options$gltf3 = options.gltf) !== null && _options$gltf3 !== void 0 && _options$gltf3.loadImages) {\n    const promise = loadImages(gltf, options, context);\n    promises.push(promise);\n  }\n\n  const promise = decodeExtensions(gltf, options, context);\n  promises.push(promise);\n  await Promise.all(promises);\n  return options !== null && options !== void 0 && (_options$gltf4 = options.gltf) !== null && _options$gltf4 !== void 0 && _options$gltf4.postProcess ? postProcessGLTF(gltf, options) : gltf;\n}\n\nfunction parseGLTFContainerSync(gltf, data, byteOffset, options) {\n  if (options.uri) {\n    gltf.baseUri = options.uri;\n  }\n\n  if (data instanceof ArrayBuffer && !isGLB(data, byteOffset, options)) {\n    const textDecoder = new TextDecoder();\n    data = textDecoder.decode(data);\n  }\n\n  if (typeof data === 'string') {\n    gltf.json = parseJSON(data);\n  } else if (data instanceof ArrayBuffer) {\n    const glb = {};\n    byteOffset = parseGLBSync(glb, data, byteOffset, options.glb);\n    assert(glb.type === 'glTF', \"Invalid GLB magic string \".concat(glb.type));\n    gltf._glb = glb;\n    gltf.json = glb.json;\n  } else {\n    assert(false, 'GLTF: must be ArrayBuffer or string');\n  }\n\n  const buffers = gltf.json.buffers || [];\n  gltf.buffers = new Array(buffers.length).fill(null);\n\n  if (gltf._glb && gltf._glb.header.hasBinChunk) {\n    const {\n      binChunks\n    } = gltf._glb;\n    gltf.buffers[0] = {\n      arrayBuffer: binChunks[0].arrayBuffer,\n      byteOffset: binChunks[0].byteOffset,\n      byteLength: binChunks[0].byteLength\n    };\n  }\n\n  const images = gltf.json.images || [];\n  gltf.images = new Array(images.length).fill({});\n}\n\nasync function loadBuffers(gltf, options, context) {\n  const buffers = gltf.json.buffers || [];\n\n  for (let i = 0; i < buffers.length; ++i) {\n    const buffer = buffers[i];\n\n    if (buffer.uri) {\n      var _context$fetch, _response$arrayBuffer;\n\n      const {\n        fetch\n      } = context;\n      assert(fetch);\n      const uri = resolveUrl(buffer.uri, options);\n      const response = await (context === null || context === void 0 ? void 0 : (_context$fetch = context.fetch) === null || _context$fetch === void 0 ? void 0 : _context$fetch.call(context, uri));\n      const arrayBuffer = await (response === null || response === void 0 ? void 0 : (_response$arrayBuffer = response.arrayBuffer) === null || _response$arrayBuffer === void 0 ? void 0 : _response$arrayBuffer.call(response));\n      gltf.buffers[i] = {\n        arrayBuffer,\n        byteOffset: 0,\n        byteLength: arrayBuffer.byteLength\n      };\n      delete buffer.uri;\n    } else if (gltf.buffers[i] === null) {\n      gltf.buffers[i] = {\n        arrayBuffer: new ArrayBuffer(buffer.byteLength),\n        byteOffset: 0,\n        byteLength: buffer.byteLength\n      };\n    }\n  }\n}\n\nasync function loadImages(gltf, options, context) {\n  const imageIndices = getReferencesImageIndices(gltf);\n  const images = gltf.json.images || [];\n  const promises = [];\n\n  for (const imageIndex of imageIndices) {\n    promises.push(loadImage(gltf, images[imageIndex], imageIndex, options, context));\n  }\n\n  return await Promise.all(promises);\n}\n\nfunction getReferencesImageIndices(gltf) {\n  const imageIndices = new Set();\n  const textures = gltf.json.textures || [];\n\n  for (const texture of textures) {\n    if (texture.source !== undefined) {\n      imageIndices.add(texture.source);\n    }\n  }\n\n  return Array.from(imageIndices).sort();\n}\n\nasync function loadImage(gltf, image, index, options, context) {\n  const {\n    fetch,\n    parse\n  } = context;\n  let arrayBuffer;\n\n  if (image.uri && !image.hasOwnProperty('bufferView')) {\n    const uri = resolveUrl(image.uri, options);\n    const response = await fetch(uri);\n    arrayBuffer = await response.arrayBuffer();\n  }\n\n  if (Number.isFinite(image.bufferView)) {\n    const array = getTypedArrayForBufferView(gltf.json, gltf.buffers, image.bufferView);\n    arrayBuffer = sliceArrayBuffer(array.buffer, array.byteOffset, array.byteLength);\n  }\n\n  assert(arrayBuffer, 'glTF image has no data');\n  let parsedImage = await parse(arrayBuffer, [ImageLoader, BasisLoader], {\n    mimeType: image.mimeType,\n    basis: options.basis || {\n      format: selectSupportedBasisFormat()\n    }\n  }, context);\n\n  if (parsedImage && parsedImage[0]) {\n    parsedImage = {\n      compressed: true,\n      mipmaps: false,\n      width: parsedImage[0].width,\n      height: parsedImage[0].height,\n      data: parsedImage[0]\n    };\n  }\n\n  gltf.images = gltf.images || [];\n  gltf.images[index] = parsedImage;\n}\n//# sourceMappingURL=parse-gltf.js.map","import { VERSION } from './lib/utils/version';\nimport { parseGLTF } from './lib/parsers/parse-gltf';\nexport const GLTFLoader = {\n  name: 'glTF',\n  id: 'gltf',\n  module: 'gltf',\n  version: VERSION,\n  extensions: ['gltf', 'glb'],\n  mimeTypes: ['model/gltf+json', 'model/gltf-binary'],\n  text: true,\n  binary: true,\n  tests: ['glTF'],\n  parse,\n  options: {\n    gltf: {\n      normalize: true,\n      loadBuffers: true,\n      loadImages: true,\n      decompressMeshes: true,\n      postProcess: true\n    },\n    log: console\n  },\n  deprecatedOptions: {\n    fetchImages: 'gltf.loadImages',\n    createImages: 'gltf.loadImages',\n    decompress: 'gltf.decompressMeshes',\n    postProcess: 'gltf.postProcess',\n    gltf: {\n      decompress: 'gltf.decompressMeshes'\n    }\n  }\n};\nexport async function parse(arrayBuffer, options = {}, context) {\n  options = { ...GLTFLoader.options,\n    ...options\n  };\n  options.gltf = { ...GLTFLoader.options.gltf,\n    ...options.gltf\n  };\n  const {\n    byteOffset = 0\n  } = options;\n  const gltf = {};\n  return await parseGLTF(gltf, arrayBuffer, byteOffset, options, context);\n}\n//# sourceMappingURL=gltf-loader.js.map","export const VERSION = typeof \"3.2.10\" !== 'undefined' ? \"3.2.10\" : 'latest';\n//# sourceMappingURL=version.js.map","import { isBrowser } from '@loaders.gl/loader-utils';\nconst {\n  _parseImageNode\n} = globalThis;\nconst IMAGE_SUPPORTED = typeof Image !== 'undefined';\nconst IMAGE_BITMAP_SUPPORTED = typeof ImageBitmap !== 'undefined';\nconst NODE_IMAGE_SUPPORTED = Boolean(_parseImageNode);\nconst DATA_SUPPORTED = isBrowser ? true : NODE_IMAGE_SUPPORTED;\nexport function isImageTypeSupported(type) {\n  switch (type) {\n    case 'auto':\n      return IMAGE_BITMAP_SUPPORTED || IMAGE_SUPPORTED || DATA_SUPPORTED;\n\n    case 'imagebitmap':\n      return IMAGE_BITMAP_SUPPORTED;\n\n    case 'image':\n      return IMAGE_SUPPORTED;\n\n    case 'data':\n      return DATA_SUPPORTED;\n\n    default:\n      throw new Error(\"@loaders.gl/images: image \".concat(type, \" not supported in this environment\"));\n  }\n}\nexport function getDefaultImageType() {\n  if (IMAGE_BITMAP_SUPPORTED) {\n    return 'imagebitmap';\n  }\n\n  if (IMAGE_SUPPORTED) {\n    return 'image';\n  }\n\n  if (DATA_SUPPORTED) {\n    return 'data';\n  }\n\n  throw new Error('Install \\'@loaders.gl/polyfills\\' to parse images under Node.js');\n}\n//# sourceMappingURL=image-type.js.map","export function isImage(image) {\n  return Boolean(getImageTypeOrNull(image));\n}\nexport function deleteImage(image) {\n  switch (getImageType(image)) {\n    case 'imagebitmap':\n      image.close();\n      break;\n\n    default:\n  }\n}\nexport function getImageType(image) {\n  const format = getImageTypeOrNull(image);\n\n  if (!format) {\n    throw new Error('Not an image');\n  }\n\n  return format;\n}\nexport function getImageSize(image) {\n  return getImageData(image);\n}\nexport function getImageData(image) {\n  switch (getImageType(image)) {\n    case 'data':\n      return image;\n\n    case 'image':\n    case 'imagebitmap':\n      const canvas = document.createElement('canvas');\n      const context = canvas.getContext('2d');\n\n      if (!context) {\n        throw new Error('getImageData');\n      }\n\n      canvas.width = image.width;\n      canvas.height = image.height;\n      context.drawImage(image, 0, 0);\n      return context.getImageData(0, 0, image.width, image.height);\n\n    default:\n      throw new Error('getImageData');\n  }\n}\n\nfunction getImageTypeOrNull(image) {\n  if (typeof ImageBitmap !== 'undefined' && image instanceof ImageBitmap) {\n    return 'imagebitmap';\n  }\n\n  if (typeof Image !== 'undefined' && image instanceof Image) {\n    return 'image';\n  }\n\n  if (image && typeof image === 'object' && image.data && image.width && image.height) {\n    return 'data';\n  }\n\n  return null;\n}\n//# sourceMappingURL=parsed-image-api.js.map","const SVG_DATA_URL_PATTERN = /^data:image\\/svg\\+xml/;\nconst SVG_URL_PATTERN = /\\.svg((\\?|#).*)?$/;\nexport function isSVG(url) {\n  return url && (SVG_DATA_URL_PATTERN.test(url) || SVG_URL_PATTERN.test(url));\n}\nexport function getBlobOrSVGDataUrl(arrayBuffer, url) {\n  if (isSVG(url)) {\n    const textDecoder = new TextDecoder();\n    let xmlText = textDecoder.decode(arrayBuffer);\n\n    try {\n      if (typeof unescape === 'function' && typeof encodeURIComponent === 'function') {\n        xmlText = unescape(encodeURIComponent(xmlText));\n      }\n    } catch (error) {\n      throw new Error(error.message);\n    }\n\n    const src = \"data:image/svg+xml;base64,\".concat(btoa(xmlText));\n    return src;\n  }\n\n  return getBlob(arrayBuffer, url);\n}\nexport function getBlob(arrayBuffer, url) {\n  if (isSVG(url)) {\n    throw new Error('SVG cannot be parsed directly to imagebitmap');\n  }\n\n  return new Blob([new Uint8Array(arrayBuffer)]);\n}\n//# sourceMappingURL=svg-utils.js.map","import { getBlobOrSVGDataUrl } from './svg-utils';\nexport default async function parseToImage(arrayBuffer, options, url) {\n  const blobOrDataUrl = getBlobOrSVGDataUrl(arrayBuffer, url);\n  const URL = self.URL || self.webkitURL;\n  const objectUrl = typeof blobOrDataUrl !== 'string' && URL.createObjectURL(blobOrDataUrl);\n\n  try {\n    return await loadToImage(objectUrl || blobOrDataUrl, options);\n  } finally {\n    if (objectUrl) {\n      URL.revokeObjectURL(objectUrl);\n    }\n  }\n}\nexport async function loadToImage(url, options) {\n  const image = new Image();\n  image.src = url;\n\n  if (options.image && options.image.decode && image.decode) {\n    await image.decode();\n    return image;\n  }\n\n  return await new Promise((resolve, reject) => {\n    try {\n      image.onload = () => resolve(image);\n\n      image.onerror = err => reject(new Error(\"Could not load image \".concat(url, \": \").concat(err)));\n    } catch (error) {\n      reject(error);\n    }\n  });\n}\n//# sourceMappingURL=parse-to-image.js.map","import { isSVG, getBlob } from './svg-utils';\nimport parseToImage from './parse-to-image';\nconst EMPTY_OBJECT = {};\nlet imagebitmapOptionsSupported = true;\nexport default async function parseToImageBitmap(arrayBuffer, options, url) {\n  let blob;\n\n  if (isSVG(url)) {\n    const image = await parseToImage(arrayBuffer, options, url);\n    blob = image;\n  } else {\n    blob = getBlob(arrayBuffer, url);\n  }\n\n  const imagebitmapOptions = options && options.imagebitmap;\n  return await safeCreateImageBitmap(blob, imagebitmapOptions);\n}\n\nasync function safeCreateImageBitmap(blob, imagebitmapOptions = null) {\n  if (isEmptyObject(imagebitmapOptions) || !imagebitmapOptionsSupported) {\n    imagebitmapOptions = null;\n  }\n\n  if (imagebitmapOptions) {\n    try {\n      return await createImageBitmap(blob, imagebitmapOptions);\n    } catch (error) {\n      console.warn(error);\n      imagebitmapOptionsSupported = false;\n    }\n  }\n\n  return await createImageBitmap(blob);\n}\n\nfunction isEmptyObject(object) {\n  for (const key in object || EMPTY_OBJECT) {\n    return false;\n  }\n\n  return true;\n}\n//# sourceMappingURL=parse-to-image-bitmap.js.map","import { VERSION } from './lib/utils/version';\nimport parseImage from './lib/parsers/parse-image';\nimport { getBinaryImageMetadata } from './lib/category-api/binary-image-api';\nconst EXTENSIONS = ['png', 'jpg', 'jpeg', 'gif', 'webp', 'bmp', 'ico', 'svg'];\nconst MIME_TYPES = ['image/png', 'image/jpeg', 'image/gif', 'image/webp', 'image/bmp', 'image/vnd.microsoft.icon', 'image/svg+xml'];\nconst DEFAULT_IMAGE_LOADER_OPTIONS = {\n  image: {\n    type: 'auto',\n    decode: true\n  }\n};\nexport const ImageLoader = {\n  id: 'image',\n  module: 'images',\n  name: 'Images',\n  version: VERSION,\n  mimeTypes: MIME_TYPES,\n  extensions: EXTENSIONS,\n  parse: parseImage,\n  tests: [arrayBuffer => Boolean(getBinaryImageMetadata(new DataView(arrayBuffer)))],\n  options: DEFAULT_IMAGE_LOADER_OPTIONS\n};\nexport const _typecheckImageLoader = ImageLoader;\n//# sourceMappingURL=image-loader.js.map","export const VERSION = typeof \"3.2.10\" !== 'undefined' ? \"3.2.10\" : 'latest';\n//# sourceMappingURL=version.js.map","import { assert } from '@loaders.gl/loader-utils';\nimport { isImageTypeSupported, getDefaultImageType } from '../category-api/image-type';\nimport { getImageData } from '../category-api/parsed-image-api';\nimport parseToImage from './parse-to-image';\nimport parseToImageBitmap from './parse-to-image-bitmap';\nimport parseToNodeImage from './parse-to-node-image';\nexport default async function parseImage(arrayBuffer, options, context) {\n  options = options || {};\n  const imageOptions = options.image || {};\n  const imageType = imageOptions.type || 'auto';\n  const {\n    url\n  } = context || {};\n  const loadType = getLoadableImageType(imageType);\n  let image;\n\n  switch (loadType) {\n    case 'imagebitmap':\n      image = await parseToImageBitmap(arrayBuffer, options, url);\n      break;\n\n    case 'image':\n      image = await parseToImage(arrayBuffer, options, url);\n      break;\n\n    case 'data':\n      image = await parseToNodeImage(arrayBuffer, options);\n      break;\n\n    default:\n      assert(false);\n  }\n\n  if (imageType === 'data') {\n    image = getImageData(image);\n  }\n\n  return image;\n}\n\nfunction getLoadableImageType(type) {\n  switch (type) {\n    case 'auto':\n    case 'data':\n      return getDefaultImageType();\n\n    default:\n      isImageTypeSupported(type);\n      return type;\n  }\n}\n//# sourceMappingURL=parse-image.js.map","import { assert } from '@loaders.gl/loader-utils';\nimport { getBinaryImageMetadata } from '../category-api/binary-image-api';\nexport default async function parseToNodeImage(arrayBuffer, options) {\n  const {\n    mimeType\n  } = getBinaryImageMetadata(arrayBuffer) || {};\n  const _parseImageNode = globalThis._parseImageNode;\n  assert(_parseImageNode);\n  return await _parseImageNode(arrayBuffer, mimeType);\n}\n//# sourceMappingURL=parse-to-node-image.js.map","import { log } from '@luma.gl/gltools';\nimport Framebuffer from './framebuffer';\nimport Renderbuffer from './renderbuffer';\nimport Texture from './texture';\nimport { assert } from '../utils/assert';\nconst UNIFORM_SETTERS = {\n  [5126]: getArraySetter.bind(null, 'uniform1fv', toFloatArray, 1, setVectorUniform),\n  [35664]: getArraySetter.bind(null, 'uniform2fv', toFloatArray, 2, setVectorUniform),\n  [35665]: getArraySetter.bind(null, 'uniform3fv', toFloatArray, 3, setVectorUniform),\n  [35666]: getArraySetter.bind(null, 'uniform4fv', toFloatArray, 4, setVectorUniform),\n  [5124]: getArraySetter.bind(null, 'uniform1iv', toIntArray, 1, setVectorUniform),\n  [35667]: getArraySetter.bind(null, 'uniform2iv', toIntArray, 2, setVectorUniform),\n  [35668]: getArraySetter.bind(null, 'uniform3iv', toIntArray, 3, setVectorUniform),\n  [35669]: getArraySetter.bind(null, 'uniform4iv', toIntArray, 4, setVectorUniform),\n  [35670]: getArraySetter.bind(null, 'uniform1iv', toIntArray, 1, setVectorUniform),\n  [35671]: getArraySetter.bind(null, 'uniform2iv', toIntArray, 2, setVectorUniform),\n  [35672]: getArraySetter.bind(null, 'uniform3iv', toIntArray, 3, setVectorUniform),\n  [35673]: getArraySetter.bind(null, 'uniform4iv', toIntArray, 4, setVectorUniform),\n  [35674]: getArraySetter.bind(null, 'uniformMatrix2fv', toFloatArray, 4, setMatrixUniform),\n  [35675]: getArraySetter.bind(null, 'uniformMatrix3fv', toFloatArray, 9, setMatrixUniform),\n  [35676]: getArraySetter.bind(null, 'uniformMatrix4fv', toFloatArray, 16, setMatrixUniform),\n  [35678]: getSamplerSetter,\n  [35680]: getSamplerSetter,\n  [5125]: getArraySetter.bind(null, 'uniform1uiv', toUIntArray, 1, setVectorUniform),\n  [36294]: getArraySetter.bind(null, 'uniform2uiv', toUIntArray, 2, setVectorUniform),\n  [36295]: getArraySetter.bind(null, 'uniform3uiv', toUIntArray, 3, setVectorUniform),\n  [36296]: getArraySetter.bind(null, 'uniform4uiv', toUIntArray, 4, setVectorUniform),\n  [35685]: getArraySetter.bind(null, 'uniformMatrix2x3fv', toFloatArray, 6, setMatrixUniform),\n  [35686]: getArraySetter.bind(null, 'uniformMatrix2x4fv', toFloatArray, 8, setMatrixUniform),\n  [35687]: getArraySetter.bind(null, 'uniformMatrix3x2fv', toFloatArray, 6, setMatrixUniform),\n  [35688]: getArraySetter.bind(null, 'uniformMatrix3x4fv', toFloatArray, 12, setMatrixUniform),\n  [35689]: getArraySetter.bind(null, 'uniformMatrix4x2fv', toFloatArray, 8, setMatrixUniform),\n  [35690]: getArraySetter.bind(null, 'uniformMatrix4x3fv', toFloatArray, 12, setMatrixUniform),\n  [35678]: getSamplerSetter,\n  [35680]: getSamplerSetter,\n  [35679]: getSamplerSetter,\n  [35682]: getSamplerSetter,\n  [36289]: getSamplerSetter,\n  [36292]: getSamplerSetter,\n  [36293]: getSamplerSetter,\n  [36298]: getSamplerSetter,\n  [36299]: getSamplerSetter,\n  [36300]: getSamplerSetter,\n  [36303]: getSamplerSetter,\n  [36306]: getSamplerSetter,\n  [36307]: getSamplerSetter,\n  [36308]: getSamplerSetter,\n  [36311]: getSamplerSetter\n};\nconst FLOAT_ARRAY = {};\nconst INT_ARRAY = {};\nconst UINT_ARRAY = {};\nconst array1 = [0];\n\nfunction toTypedArray(value, uniformLength, Type, cache) {\n  if (uniformLength === 1 && typeof value === 'boolean') {\n    value = value ? 1 : 0;\n  }\n\n  if (Number.isFinite(value)) {\n    array1[0] = value;\n    value = array1;\n  }\n\n  const length = value.length;\n\n  if (length % uniformLength) {\n    log.warn(\"Uniform size should be multiples of \".concat(uniformLength), value)();\n  }\n\n  if (value instanceof Type) {\n    return value;\n  }\n\n  let result = cache[length];\n\n  if (!result) {\n    result = new Type(length);\n    cache[length] = result;\n  }\n\n  for (let i = 0; i < length; i++) {\n    result[i] = value[i];\n  }\n\n  return result;\n}\n\nfunction toFloatArray(value, uniformLength) {\n  return toTypedArray(value, uniformLength, Float32Array, FLOAT_ARRAY);\n}\n\nfunction toIntArray(value, uniformLength) {\n  return toTypedArray(value, uniformLength, Int32Array, INT_ARRAY);\n}\n\nfunction toUIntArray(value, uniformLength) {\n  return toTypedArray(value, uniformLength, Uint32Array, UINT_ARRAY);\n}\n\nexport function getUniformSetter(gl, location, info) {\n  const setter = UNIFORM_SETTERS[info.type];\n\n  if (!setter) {\n    throw new Error(\"Unknown GLSL uniform type \".concat(info.type));\n  }\n\n  return setter().bind(null, gl, location);\n}\nexport function parseUniformName(name) {\n  if (name[name.length - 1] !== ']') {\n    return {\n      name,\n      length: 1,\n      isArray: false\n    };\n  }\n\n  const UNIFORM_NAME_REGEXP = /([^[]*)(\\[[0-9]+\\])?/;\n  const matches = name.match(UNIFORM_NAME_REGEXP);\n\n  if (!matches || matches.length < 2) {\n    throw new Error(\"Failed to parse GLSL uniform name \".concat(name));\n  }\n\n  return {\n    name: matches[1],\n    length: matches[2] || 1,\n    isArray: Boolean(matches[2])\n  };\n}\nexport function checkUniformValues(uniforms, source, uniformMap) {\n  for (const uniformName in uniforms) {\n    const value = uniforms[uniformName];\n    const shouldCheck = !uniformMap || Boolean(uniformMap[uniformName]);\n\n    if (shouldCheck && !checkUniformValue(value)) {\n      source = source ? \"\".concat(source, \" \") : '';\n      console.error(\"\".concat(source, \" Bad uniform \").concat(uniformName), value);\n      throw new Error(\"\".concat(source, \" Bad uniform \").concat(uniformName));\n    }\n  }\n\n  return true;\n}\n\nfunction checkUniformValue(value) {\n  if (Array.isArray(value) || ArrayBuffer.isView(value)) {\n    return checkUniformArray(value);\n  }\n\n  if (isFinite(value)) {\n    return true;\n  } else if (value === true || value === false) {\n    return true;\n  } else if (value instanceof Texture) {\n    return true;\n  } else if (value instanceof Renderbuffer) {\n    return true;\n  } else if (value instanceof Framebuffer) {\n    return Boolean(value.texture);\n  }\n\n  return false;\n}\n\nexport function copyUniform(uniforms, key, value) {\n  if (Array.isArray(value) || ArrayBuffer.isView(value)) {\n    if (uniforms[key]) {\n      const dest = uniforms[key];\n\n      for (let i = 0, len = value.length; i < len; ++i) {\n        dest[i] = value[i];\n      }\n    } else {\n      uniforms[key] = value.slice();\n    }\n  } else {\n    uniforms[key] = value;\n  }\n}\n\nfunction checkUniformArray(value) {\n  if (value.length === 0) {\n    return false;\n  }\n\n  const checkLength = Math.min(value.length, 16);\n\n  for (let i = 0; i < checkLength; ++i) {\n    if (!Number.isFinite(value[i])) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nfunction getSamplerSetter() {\n  let cache = null;\n  return (gl, location, value) => {\n    const update = cache !== value;\n\n    if (update) {\n      gl.uniform1i(location, value);\n      cache = value;\n    }\n\n    return update;\n  };\n}\n\nfunction getArraySetter(functionName, toArray, size, uniformSetter) {\n  let cache = null;\n  let cacheLength = null;\n  return (gl, location, value) => {\n    const arrayValue = toArray(value, size);\n    const length = arrayValue.length;\n    let update = false;\n\n    if (cache === null) {\n      cache = new Float32Array(length);\n      cacheLength = length;\n      update = true;\n    } else {\n      assert(cacheLength === length, 'Uniform length cannot change.');\n\n      for (let i = 0; i < length; ++i) {\n        if (arrayValue[i] !== cache[i]) {\n          update = true;\n          break;\n        }\n      }\n    }\n\n    if (update) {\n      uniformSetter(gl, functionName, location, arrayValue);\n      cache.set(arrayValue);\n    }\n\n    return update;\n  };\n}\n\nfunction setVectorUniform(gl, functionName, location, value) {\n  gl[functionName](location, value);\n}\n\nfunction setMatrixUniform(gl, functionName, location, value) {\n  gl[functionName](location, false, value);\n}\n//# sourceMappingURL=uniforms.js.map","export default function getShaderName(shader) {\n  let defaultName = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'unnamed';\n  const SHADER_NAME_REGEXP = /#define[\\s*]SHADER_NAME[\\s*]([A-Za-z0-9_-]+)[\\s*]/;\n  const match = shader.match(SHADER_NAME_REGEXP);\n  return match ? match[1] : defaultName;\n}\n//# sourceMappingURL=get-shader-name.js.map","import getShaderName from './get-shader-name';\nimport getShaderTypeName from './get-shader-type-name';\nexport default function formatGLSLCompilerError(errLog, src, shaderType) {\n  const {\n    shaderName,\n    errors,\n    warnings\n  } = parseGLSLCompilerError(errLog, src, shaderType);\n  return \"GLSL compilation error in \".concat(shaderName, \"\\n\\n\").concat(errors, \"\\n\").concat(warnings);\n}\nexport function parseGLSLCompilerError(errLog, src, shaderType, shaderName) {\n  const errorStrings = errLog.split(/\\r?\\n/);\n  const errors = {};\n  const warnings = {};\n  const name = shaderName || getShaderName(src) || '(unnamed)';\n  const shaderDescription = \"\".concat(getShaderTypeName(shaderType), \" shader \").concat(name);\n\n  for (let i = 0; i < errorStrings.length; i++) {\n    const errorString = errorStrings[i];\n\n    if (errorString.length <= 1) {\n      continue;\n    }\n\n    const segments = errorString.split(':');\n    const type = segments[0];\n    const line = parseInt(segments[2], 10);\n\n    if (isNaN(line)) {\n      throw new Error(\"GLSL compilation error in \".concat(shaderDescription, \": \").concat(errLog));\n    }\n\n    if (type !== 'WARNING') {\n      errors[line] = errorString;\n    } else {\n      warnings[line] = errorString;\n    }\n  }\n\n  const lines = addLineNumbers(src);\n  return {\n    shaderName: shaderDescription,\n    errors: formatErrors(errors, lines),\n    warnings: formatErrors(warnings, lines)\n  };\n}\n\nfunction formatErrors(errors, lines) {\n  let message = '';\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i];\n\n    if (!errors[i + 3] && !errors[i + 2] && !errors[i + 1]) {\n      continue;\n    }\n\n    message += \"\".concat(line, \"\\n\");\n\n    if (errors[i + 1]) {\n      const error = errors[i + 1];\n      const segments = error.split(':', 3);\n      const type = segments[0];\n      const column = parseInt(segments[1], 10) || 0;\n      const err = error.substring(segments.join(':').length + 1).trim();\n      message += padLeft(\"^^^ \".concat(type, \": \").concat(err, \"\\n\\n\"), column);\n    }\n  }\n\n  return message;\n}\n\nfunction addLineNumbers(string) {\n  let start = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 1;\n  let delim = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : ': ';\n  const lines = string.split(/\\r?\\n/);\n  const maxDigits = String(lines.length + start - 1).length;\n  return lines.map((line, i) => {\n    const lineNumber = String(i + start);\n    const digits = lineNumber.length;\n    const prefix = padLeft(lineNumber, maxDigits - digits);\n    return prefix + delim + line;\n  });\n}\n\nfunction padLeft(string, digits) {\n  let result = '';\n\n  for (let i = 0; i < digits; ++i) {\n    result += ' ';\n  }\n\n  return \"\".concat(result).concat(string);\n}\n//# sourceMappingURL=format-glsl-error.js.map","const GL_FRAGMENT_SHADER = 0x8b30;\nconst GL_VERTEX_SHADER = 0x8b31;\nexport default function getShaderTypeName(type) {\n  switch (type) {\n    case GL_FRAGMENT_SHADER:\n      return 'fragment';\n\n    case GL_VERTEX_SHADER:\n      return 'vertex';\n\n    default:\n      return 'unknown type';\n  }\n}\n//# sourceMappingURL=get-shader-type-name.js.map","import { assertWebGLContext, log } from '@luma.gl/gltools';\nimport { parseGLSLCompilerError, getShaderName } from '../glsl-utils';\nimport { assert } from '../utils/assert';\nimport { uid } from '../utils/utils';\nimport Resource from './resource';\nconst ERR_SOURCE = 'Shader: GLSL source code must be a JavaScript string';\nexport class Shader extends Resource {\n  get [Symbol.toStringTag]() {\n    return 'Shader';\n  }\n\n  static getTypeName(shaderType) {\n    switch (shaderType) {\n      case 35633:\n        return 'vertex-shader';\n\n      case 35632:\n        return 'fragment-shader';\n\n      default:\n        assert(false);\n        return 'unknown';\n    }\n  }\n\n  constructor(gl, props) {\n    assertWebGLContext(gl);\n    assert(typeof props.source === 'string', ERR_SOURCE);\n    const id = getShaderName(props.source, null) || props.id || uid(\"unnamed \".concat(Shader.getTypeName(props.shaderType)));\n    super(gl, {\n      id\n    });\n    this.shaderType = props.shaderType;\n    this.source = props.source;\n    this.initialize(props);\n  }\n\n  initialize(_ref) {\n    let {\n      source\n    } = _ref;\n    const shaderName = getShaderName(source, null);\n\n    if (shaderName) {\n      this.id = uid(shaderName);\n    }\n\n    this._compile(source);\n  }\n\n  getParameter(pname) {\n    return this.gl.getShaderParameter(this.handle, pname);\n  }\n\n  toString() {\n    return \"\".concat(Shader.getTypeName(this.shaderType), \":\").concat(this.id);\n  }\n\n  getName() {\n    return getShaderName(this.source) || 'unnamed-shader';\n  }\n\n  getSource() {\n    return this.gl.getShaderSource(this.handle);\n  }\n\n  getTranslatedSource() {\n    const extension = this.gl.getExtension('WEBGL_debug_shaders');\n    return extension ? extension.getTranslatedShaderSource(this.handle) : 'No translated source available. WEBGL_debug_shaders not implemented';\n  }\n\n  _compile() {\n    let source = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.source;\n\n    if (!source.startsWith('#version ')) {\n      source = \"#version 100\\n\".concat(source);\n    }\n\n    this.source = source;\n    this.gl.shaderSource(this.handle, this.source);\n    this.gl.compileShader(this.handle);\n    const compileStatus = this.getParameter(35713);\n\n    if (!compileStatus) {\n      const infoLog = this.gl.getShaderInfoLog(this.handle);\n      const {\n        shaderName,\n        errors,\n        warnings\n      } = parseGLSLCompilerError(infoLog, this.source, this.shaderType, this.id);\n      log.error(\"GLSL compilation errors in \".concat(shaderName, \"\\n\").concat(errors))();\n      log.warn(\"GLSL compilation warnings in \".concat(shaderName, \"\\n\").concat(warnings))();\n      throw new Error(\"GLSL compilation errors in \".concat(shaderName));\n    }\n  }\n\n  _deleteHandle() {\n    this.gl.deleteShader(this.handle);\n  }\n\n  _getOptsFromHandle() {\n    return {\n      type: this.getParameter(35663),\n      source: this.getSource()\n    };\n  }\n\n}\nexport class VertexShader extends Shader {\n  get [Symbol.toStringTag]() {\n    return 'VertexShader';\n  }\n\n  constructor(gl, props) {\n    if (typeof props === 'string') {\n      props = {\n        source: props\n      };\n    }\n\n    super(gl, Object.assign({}, props, {\n      shaderType: 35633\n    }));\n  }\n\n  _createHandle() {\n    return this.gl.createShader(35633);\n  }\n\n}\nexport class FragmentShader extends Shader {\n  get [Symbol.toStringTag]() {\n    return 'FragmentShader';\n  }\n\n  constructor(gl, props) {\n    if (typeof props === 'string') {\n      props = {\n        source: props\n      };\n    }\n\n    super(gl, Object.assign({}, props, {\n      shaderType: 35632\n    }));\n  }\n\n  _createHandle() {\n    return this.gl.createShader(35632);\n  }\n\n}\n//# sourceMappingURL=shader.js.map","import Accessor from './accessor';\nimport { isWebGL2 } from '@luma.gl/gltools';\nimport { decomposeCompositeGLType } from '../webgl-utils/attribute-utils';\nexport default class ProgramConfiguration {\n  constructor(program) {\n    this.id = program.id;\n    this.attributeInfos = [];\n    this.attributeInfosByName = {};\n    this.attributeInfosByLocation = [];\n    this.varyingInfos = [];\n    this.varyingInfosByName = {};\n    Object.seal(this);\n\n    this._readAttributesFromProgram(program);\n\n    this._readVaryingsFromProgram(program);\n  }\n\n  getAttributeInfo(locationOrName) {\n    const location = Number(locationOrName);\n\n    if (Number.isFinite(location)) {\n      return this.attributeInfosByLocation[location];\n    }\n\n    return this.attributeInfosByName[locationOrName] || null;\n  }\n\n  getAttributeLocation(locationOrName) {\n    const attributeInfo = this.getAttributeInfo(locationOrName);\n    return attributeInfo ? attributeInfo.location : -1;\n  }\n\n  getAttributeAccessor(locationOrName) {\n    const attributeInfo = this.getAttributeInfo(locationOrName);\n    return attributeInfo ? attributeInfo.accessor : null;\n  }\n\n  getVaryingInfo(locationOrName) {\n    const location = Number(locationOrName);\n\n    if (Number.isFinite(location)) {\n      return this.varyingInfos[location];\n    }\n\n    return this.varyingInfosByName[locationOrName] || null;\n  }\n\n  getVaryingIndex(locationOrName) {\n    const varying = this.getVaryingInfo();\n    return varying ? varying.location : -1;\n  }\n\n  getVaryingAccessor(locationOrName) {\n    const varying = this.getVaryingInfo();\n    return varying ? varying.accessor : null;\n  }\n\n  _readAttributesFromProgram(program) {\n    const {\n      gl\n    } = program;\n    const count = gl.getProgramParameter(program.handle, 35721);\n\n    for (let index = 0; index < count; index++) {\n      const {\n        name,\n        type,\n        size\n      } = gl.getActiveAttrib(program.handle, index);\n      const location = gl.getAttribLocation(program.handle, name);\n\n      if (location >= 0) {\n        this._addAttribute(location, name, type, size);\n      }\n    }\n\n    this.attributeInfos.sort((a, b) => a.location - b.location);\n  }\n\n  _readVaryingsFromProgram(program) {\n    const {\n      gl\n    } = program;\n\n    if (!isWebGL2(gl)) {\n      return;\n    }\n\n    const count = gl.getProgramParameter(program.handle, 35971);\n\n    for (let location = 0; location < count; location++) {\n      const {\n        name,\n        type,\n        size\n      } = gl.getTransformFeedbackVarying(program.handle, location);\n\n      this._addVarying(location, name, type, size);\n    }\n\n    this.varyingInfos.sort((a, b) => a.location - b.location);\n  }\n\n  _addAttribute(location, name, compositeType, size) {\n    const {\n      type,\n      components\n    } = decomposeCompositeGLType(compositeType);\n    const accessor = {\n      type,\n      size: size * components\n    };\n\n    this._inferProperties(location, name, accessor);\n\n    const attributeInfo = {\n      location,\n      name,\n      accessor: new Accessor(accessor)\n    };\n    this.attributeInfos.push(attributeInfo);\n    this.attributeInfosByLocation[location] = attributeInfo;\n    this.attributeInfosByName[attributeInfo.name] = attributeInfo;\n  }\n\n  _inferProperties(location, name, accessor) {\n    if (/instance/i.test(name)) {\n      accessor.divisor = 1;\n    }\n  }\n\n  _addVarying(location, name, compositeType, size) {\n    const {\n      type,\n      components\n    } = decomposeCompositeGLType(compositeType);\n    const accessor = new Accessor({\n      type,\n      size: size * components\n    });\n    const varying = {\n      location,\n      name,\n      accessor\n    };\n    this.varyingInfos.push(varying);\n    this.varyingInfosByName[varying.name] = varying;\n  }\n\n}\n//# sourceMappingURL=program-configuration.js.map","import Resource from './resource';\nimport Texture from './texture';\nimport Framebuffer from './framebuffer';\nimport { parseUniformName, getUniformSetter } from './uniforms';\nimport { VertexShader, FragmentShader } from './shader';\nimport ProgramConfiguration from './program-configuration';\nimport { copyUniform, checkUniformValues } from './uniforms';\nimport { isWebGL2, assertWebGL2Context, withParameters, log } from '@luma.gl/gltools';\nimport { getKey } from '../webgl-utils/constants-to-keys';\nimport { getPrimitiveDrawMode } from '../webgl-utils/attribute-utils';\nimport { assert } from '../utils/assert';\nimport { uid } from '../utils/utils';\nconst LOG_PROGRAM_PERF_PRIORITY = 4;\nconst GL_SEPARATE_ATTRIBS = 0x8c8d;\nconst V6_DEPRECATED_METHODS = ['setVertexArray', 'setAttributes', 'setBuffers', 'unsetBuffers', 'use', 'getUniformCount', 'getUniformInfo', 'getUniformLocation', 'getUniformValue', 'getVarying', 'getFragDataLocation', 'getAttachedShaders', 'getAttributeCount', 'getAttributeLocation', 'getAttributeInfo'];\nexport default class Program extends Resource {\n  get [Symbol.toStringTag]() {\n    return 'Program';\n  }\n\n  constructor(gl) {\n    let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    super(gl, props);\n    this.stubRemovedMethods('Program', 'v6.0', V6_DEPRECATED_METHODS);\n    this._isCached = false;\n    this.initialize(props);\n    Object.seal(this);\n\n    this._setId(props.id);\n  }\n\n  initialize() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      hash,\n      vs,\n      fs,\n      varyings,\n      bufferMode = GL_SEPARATE_ATTRIBS\n    } = props;\n    this.hash = hash || '';\n    this.vs = typeof vs === 'string' ? new VertexShader(this.gl, {\n      id: \"\".concat(props.id, \"-vs\"),\n      source: vs\n    }) : vs;\n    this.fs = typeof fs === 'string' ? new FragmentShader(this.gl, {\n      id: \"\".concat(props.id, \"-fs\"),\n      source: fs\n    }) : fs;\n    assert(this.vs instanceof VertexShader);\n    assert(this.fs instanceof FragmentShader);\n    this.uniforms = {};\n    this._textureUniforms = {};\n\n    if (varyings && varyings.length > 0) {\n      assertWebGL2Context(this.gl);\n      this.varyings = varyings;\n      this.gl2.transformFeedbackVaryings(this.handle, varyings, bufferMode);\n    }\n\n    this._compileAndLink();\n\n    this._readUniformLocationsFromLinkedProgram();\n\n    this.configuration = new ProgramConfiguration(this);\n    return this.setProps(props);\n  }\n\n  delete() {\n    let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    if (this._isCached) {\n      return this;\n    }\n\n    return super.delete(options);\n  }\n\n  setProps(props) {\n    if ('uniforms' in props) {\n      this.setUniforms(props.uniforms);\n    }\n\n    return this;\n  }\n\n  draw(_ref) {\n    let {\n      logPriority,\n      drawMode = 4,\n      vertexCount,\n      offset = 0,\n      start,\n      end,\n      isIndexed = false,\n      indexType = 5123,\n      instanceCount = 0,\n      isInstanced = instanceCount > 0,\n      vertexArray = null,\n      transformFeedback,\n      framebuffer,\n      parameters = {},\n      uniforms,\n      samplers\n    } = _ref;\n\n    if (uniforms || samplers) {\n      log.deprecated('Program.draw({uniforms})', 'Program.setUniforms(uniforms)')();\n      this.setUniforms(uniforms || {});\n    }\n\n    if (log.priority >= logPriority) {\n      const fb = framebuffer ? framebuffer.id : 'default';\n      const message = \"mode=\".concat(getKey(this.gl, drawMode), \" verts=\").concat(vertexCount, \" \") + \"instances=\".concat(instanceCount, \" indexType=\").concat(getKey(this.gl, indexType), \" \") + \"isInstanced=\".concat(isInstanced, \" isIndexed=\").concat(isIndexed, \" \") + \"Framebuffer=\".concat(fb);\n      log.log(logPriority, message)();\n    }\n\n    assert(vertexArray);\n    this.gl.useProgram(this.handle);\n\n    if (!this._areTexturesRenderable() || vertexCount === 0 || isInstanced && instanceCount === 0) {\n      return false;\n    }\n\n    vertexArray.bindForDraw(vertexCount, instanceCount, () => {\n      if (framebuffer !== undefined) {\n        parameters = Object.assign({}, parameters, {\n          framebuffer\n        });\n      }\n\n      if (transformFeedback) {\n        const primitiveMode = getPrimitiveDrawMode(drawMode);\n        transformFeedback.begin(primitiveMode);\n      }\n\n      this._bindTextures();\n\n      withParameters(this.gl, parameters, () => {\n        if (isIndexed && isInstanced) {\n          this.gl2.drawElementsInstanced(drawMode, vertexCount, indexType, offset, instanceCount);\n        } else if (isIndexed && isWebGL2(this.gl) && !isNaN(start) && !isNaN(end)) {\n          this.gl2.drawRangeElements(drawMode, start, end, vertexCount, indexType, offset);\n        } else if (isIndexed) {\n          this.gl.drawElements(drawMode, vertexCount, indexType, offset);\n        } else if (isInstanced) {\n          this.gl2.drawArraysInstanced(drawMode, offset, vertexCount, instanceCount);\n        } else {\n          this.gl.drawArrays(drawMode, offset, vertexCount);\n        }\n      });\n\n      if (transformFeedback) {\n        transformFeedback.end();\n      }\n    });\n    return true;\n  }\n\n  setUniforms() {\n    let uniforms = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    if (log.priority >= 2) {\n      checkUniformValues(uniforms, this.id, this._uniformSetters);\n    }\n\n    this.gl.useProgram(this.handle);\n\n    for (const uniformName in uniforms) {\n      const uniform = uniforms[uniformName];\n      const uniformSetter = this._uniformSetters[uniformName];\n\n      if (uniformSetter) {\n        let value = uniform;\n        let textureUpdate = false;\n\n        if (value instanceof Framebuffer) {\n          value = value.texture;\n        }\n\n        if (value instanceof Texture) {\n          textureUpdate = this.uniforms[uniformName] !== uniform;\n\n          if (textureUpdate) {\n            if (uniformSetter.textureIndex === undefined) {\n              uniformSetter.textureIndex = this._textureIndexCounter++;\n            }\n\n            const texture = value;\n            const {\n              textureIndex\n            } = uniformSetter;\n            texture.bind(textureIndex);\n            value = textureIndex;\n            this._textureUniforms[uniformName] = texture;\n          } else {\n            value = uniformSetter.textureIndex;\n          }\n        } else if (this._textureUniforms[uniformName]) {\n          delete this._textureUniforms[uniformName];\n        }\n\n        if (uniformSetter(value) || textureUpdate) {\n          copyUniform(this.uniforms, uniformName, uniform);\n        }\n      }\n    }\n\n    return this;\n  }\n\n  _areTexturesRenderable() {\n    let texturesRenderable = true;\n\n    for (const uniformName in this._textureUniforms) {\n      const texture = this._textureUniforms[uniformName];\n      texture.update();\n      texturesRenderable = texturesRenderable && texture.loaded;\n    }\n\n    return texturesRenderable;\n  }\n\n  _bindTextures() {\n    for (const uniformName in this._textureUniforms) {\n      const textureIndex = this._uniformSetters[uniformName].textureIndex;\n\n      this._textureUniforms[uniformName].bind(textureIndex);\n    }\n  }\n\n  _createHandle() {\n    return this.gl.createProgram();\n  }\n\n  _deleteHandle() {\n    this.gl.deleteProgram(this.handle);\n  }\n\n  _getOptionsFromHandle(handle) {\n    const shaderHandles = this.gl.getAttachedShaders(handle);\n    const opts = {};\n\n    for (const shaderHandle of shaderHandles) {\n      const type = this.gl.getShaderParameter(this.handle, 35663);\n\n      switch (type) {\n        case 35633:\n          opts.vs = new VertexShader({\n            handle: shaderHandle\n          });\n          break;\n\n        case 35632:\n          opts.fs = new FragmentShader({\n            handle: shaderHandle\n          });\n          break;\n\n        default:\n      }\n    }\n\n    return opts;\n  }\n\n  _getParameter(pname) {\n    return this.gl.getProgramParameter(this.handle, pname);\n  }\n\n  _setId(id) {\n    if (!id) {\n      const programName = this._getName();\n\n      this.id = uid(programName);\n    }\n  }\n\n  _getName() {\n    let programName = this.vs.getName() || this.fs.getName();\n    programName = programName.replace(/shader/i, '');\n    programName = programName ? \"\".concat(programName, \"-program\") : 'program';\n    return programName;\n  }\n\n  _compileAndLink() {\n    const {\n      gl\n    } = this;\n    gl.attachShader(this.handle, this.vs.handle);\n    gl.attachShader(this.handle, this.fs.handle);\n    log.time(LOG_PROGRAM_PERF_PRIORITY, \"linkProgram for \".concat(this._getName()))();\n    gl.linkProgram(this.handle);\n    log.timeEnd(LOG_PROGRAM_PERF_PRIORITY, \"linkProgram for \".concat(this._getName()))();\n\n    if (gl.debug || log.level > 0) {\n      const linked = gl.getProgramParameter(this.handle, 35714);\n\n      if (!linked) {\n        throw new Error(\"Error linking: \".concat(gl.getProgramInfoLog(this.handle)));\n      }\n\n      gl.validateProgram(this.handle);\n      const validated = gl.getProgramParameter(this.handle, 35715);\n\n      if (!validated) {\n        throw new Error(\"Error validating: \".concat(gl.getProgramInfoLog(this.handle)));\n      }\n    }\n  }\n\n  _readUniformLocationsFromLinkedProgram() {\n    const {\n      gl\n    } = this;\n    this._uniformSetters = {};\n    this._uniformCount = this._getParameter(35718);\n\n    for (let i = 0; i < this._uniformCount; i++) {\n      const info = this.gl.getActiveUniform(this.handle, i);\n      const {\n        name\n      } = parseUniformName(info.name);\n      let location = gl.getUniformLocation(this.handle, name);\n      this._uniformSetters[name] = getUniformSetter(gl, location, info);\n\n      if (info.size > 1) {\n        for (let l = 0; l < info.size; l++) {\n          location = gl.getUniformLocation(this.handle, \"\".concat(name, \"[\").concat(l, \"]\"));\n          this._uniformSetters[\"\".concat(name, \"[\").concat(l, \"]\")] = getUniformSetter(gl, location, info);\n        }\n      }\n    }\n\n    this._textureIndexCounter = 0;\n  }\n\n  getActiveUniforms(uniformIndices, pname) {\n    return this.gl2.getActiveUniforms(this.handle, uniformIndices, pname);\n  }\n\n  getUniformBlockIndex(blockName) {\n    return this.gl2.getUniformBlockIndex(this.handle, blockName);\n  }\n\n  getActiveUniformBlockParameter(blockIndex, pname) {\n    return this.gl2.getActiveUniformBlockParameter(this.handle, blockIndex, pname);\n  }\n\n  uniformBlockBinding(blockIndex, blockBinding) {\n    this.gl2.uniformBlockBinding(this.handle, blockIndex, blockBinding);\n  }\n\n}\n//# sourceMappingURL=program.js.map","import { assert } from '../utils';\nconst FS100 = \"void main() {gl_FragColor = vec4(0);}\";\nconst FS_GLES = \"out vec4 transform_output;\\nvoid main() {\\n  transform_output = vec4(0);\\n}\";\nconst FS300 = \"#version 300 es\\n\".concat(FS_GLES);\nexport function getQualifierDetails(line, qualifiers) {\n  qualifiers = Array.isArray(qualifiers) ? qualifiers : [qualifiers];\n  const words = line.replace(/^\\s+/, '').split(/\\s+/);\n  const [qualifier, type, definition] = words;\n\n  if (!qualifiers.includes(qualifier) || !type || !definition) {\n    return null;\n  }\n\n  const name = definition.split(';')[0];\n  return {\n    qualifier,\n    type,\n    name\n  };\n}\nexport function getPassthroughFS() {\n  let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n  const {\n    version = 100,\n    input,\n    inputType,\n    output\n  } = options;\n\n  if (!input) {\n    if (version === 300) {\n      return FS300;\n    } else if (version > 300) {\n      return \"#version \".concat(version, \"\\n\").concat(FS_GLES);\n    }\n\n    return FS100;\n  }\n\n  const outputValue = convertToVec4(input, inputType);\n\n  if (version >= 300) {\n    return \"#version \".concat(version, \" \").concat(version === 300 ? 'es' : '', \"\\nin \").concat(inputType, \" \").concat(input, \";\\nout vec4 \").concat(output, \";\\nvoid main() {\\n  \").concat(output, \" = \").concat(outputValue, \";\\n}\");\n  }\n\n  return \"varying \".concat(inputType, \" \").concat(input, \";\\nvoid main() {\\n  gl_FragColor = \").concat(outputValue, \";\\n}\");\n}\nexport function typeToChannelSuffix(type) {\n  switch (type) {\n    case 'float':\n      return 'x';\n\n    case 'vec2':\n      return 'xy';\n\n    case 'vec3':\n      return 'xyz';\n\n    case 'vec4':\n      return 'xyzw';\n\n    default:\n      assert(false);\n      return null;\n  }\n}\nexport function typeToChannelCount(type) {\n  switch (type) {\n    case 'float':\n      return 1;\n\n    case 'vec2':\n      return 2;\n\n    case 'vec3':\n      return 3;\n\n    case 'vec4':\n      return 4;\n\n    default:\n      assert(false);\n      return null;\n  }\n}\nexport function convertToVec4(variable, type) {\n  switch (type) {\n    case 'float':\n      return \"vec4(\".concat(variable, \", 0.0, 0.0, 1.0)\");\n\n    case 'vec2':\n      return \"vec4(\".concat(variable, \", 0.0, 1.0)\");\n\n    case 'vec3':\n      return \"vec4(\".concat(variable, \", 1.0)\");\n\n    case 'vec4':\n      return variable;\n\n    default:\n      assert(false);\n      return null;\n  }\n}\n//# sourceMappingURL=shader-utils.js.map","import { isWebGL2 } from '@luma.gl/gltools';\nimport { Buffer, TransformFeedback } from '@luma.gl/webgl';\nimport { assert } from '@luma.gl/webgl';\nexport default class BufferTransform {\n  constructor(gl) {\n    let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    this.gl = gl;\n    this.currentIndex = 0;\n    this.feedbackMap = {};\n    this.varyings = null;\n    this.bindings = [];\n    this.resources = {};\n\n    this._initialize(props);\n\n    Object.seal(this);\n  }\n\n  setupResources(opts) {\n    for (const binding of this.bindings) {\n      this._setupTransformFeedback(binding, opts);\n    }\n  }\n\n  updateModelProps() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      varyings\n    } = this;\n\n    if (varyings.length > 0) {\n      props = Object.assign({}, props, {\n        varyings\n      });\n    }\n\n    return props;\n  }\n\n  getDrawOptions() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const binding = this.bindings[this.currentIndex];\n    const {\n      sourceBuffers,\n      transformFeedback\n    } = binding;\n    const attributes = Object.assign({}, sourceBuffers, opts.attributes);\n    return {\n      attributes,\n      transformFeedback\n    };\n  }\n\n  swap() {\n    if (this.feedbackMap) {\n      this.currentIndex = this._getNextIndex();\n      return true;\n    }\n\n    return false;\n  }\n\n  update() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    this._setupBuffers(opts);\n  }\n\n  getBuffer(varyingName) {\n    const {\n      feedbackBuffers\n    } = this.bindings[this.currentIndex];\n    const bufferOrParams = varyingName ? feedbackBuffers[varyingName] : null;\n\n    if (!bufferOrParams) {\n      return null;\n    }\n\n    return bufferOrParams instanceof Buffer ? bufferOrParams : bufferOrParams.buffer;\n  }\n\n  getData() {\n    let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      varyingName\n    } = options;\n    const buffer = this.getBuffer(varyingName);\n\n    if (buffer) {\n      return buffer.getData();\n    }\n\n    return null;\n  }\n\n  delete() {\n    for (const name in this.resources) {\n      this.resources[name].delete();\n    }\n  }\n\n  _initialize() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    this._setupBuffers(props);\n\n    this.varyings = props.varyings || Object.keys(this.bindings[this.currentIndex].feedbackBuffers);\n\n    if (this.varyings.length > 0) {\n      assert(isWebGL2(this.gl));\n    }\n  }\n\n  _getFeedbackBuffers(props) {\n    const {\n      sourceBuffers = {}\n    } = props;\n    const feedbackBuffers = {};\n\n    if (this.bindings[this.currentIndex]) {\n      Object.assign(feedbackBuffers, this.bindings[this.currentIndex].feedbackBuffers);\n    }\n\n    if (this.feedbackMap) {\n      for (const sourceName in this.feedbackMap) {\n        const feedbackName = this.feedbackMap[sourceName];\n\n        if (sourceName in sourceBuffers) {\n          feedbackBuffers[feedbackName] = sourceName;\n        }\n      }\n    }\n\n    Object.assign(feedbackBuffers, props.feedbackBuffers);\n\n    for (const bufferName in feedbackBuffers) {\n      const bufferOrRef = feedbackBuffers[bufferName];\n\n      if (typeof bufferOrRef === 'string') {\n        const sourceBuffer = sourceBuffers[bufferOrRef];\n        const {\n          byteLength,\n          usage,\n          accessor\n        } = sourceBuffer;\n        feedbackBuffers[bufferName] = this._createNewBuffer(bufferName, {\n          byteLength,\n          usage,\n          accessor\n        });\n      }\n    }\n\n    return feedbackBuffers;\n  }\n\n  _setupBuffers() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      sourceBuffers = null\n    } = props;\n    Object.assign(this.feedbackMap, props.feedbackMap);\n\n    const feedbackBuffers = this._getFeedbackBuffers(props);\n\n    this._updateBindings({\n      sourceBuffers,\n      feedbackBuffers\n    });\n  }\n\n  _setupTransformFeedback(binding, _ref) {\n    let {\n      model\n    } = _ref;\n    const {\n      program\n    } = model;\n    binding.transformFeedback = new TransformFeedback(this.gl, {\n      program,\n      buffers: binding.feedbackBuffers\n    });\n  }\n\n  _updateBindings(opts) {\n    this.bindings[this.currentIndex] = this._updateBinding(this.bindings[this.currentIndex], opts);\n\n    if (this.feedbackMap) {\n      const {\n        sourceBuffers,\n        feedbackBuffers\n      } = this._swapBuffers(this.bindings[this.currentIndex]);\n\n      const nextIndex = this._getNextIndex();\n\n      this.bindings[nextIndex] = this._updateBinding(this.bindings[nextIndex], {\n        sourceBuffers,\n        feedbackBuffers\n      });\n    }\n  }\n\n  _updateBinding(binding, opts) {\n    if (!binding) {\n      return {\n        sourceBuffers: Object.assign({}, opts.sourceBuffers),\n        feedbackBuffers: Object.assign({}, opts.feedbackBuffers)\n      };\n    }\n\n    Object.assign(binding.sourceBuffers, opts.sourceBuffers);\n    Object.assign(binding.feedbackBuffers, opts.feedbackBuffers);\n\n    if (binding.transformFeedback) {\n      binding.transformFeedback.setBuffers(binding.feedbackBuffers);\n    }\n\n    return binding;\n  }\n\n  _swapBuffers(opts) {\n    if (!this.feedbackMap) {\n      return null;\n    }\n\n    const sourceBuffers = Object.assign({}, opts.sourceBuffers);\n    const feedbackBuffers = Object.assign({}, opts.feedbackBuffers);\n\n    for (const srcName in this.feedbackMap) {\n      const dstName = this.feedbackMap[srcName];\n      sourceBuffers[srcName] = opts.feedbackBuffers[dstName];\n      feedbackBuffers[dstName] = opts.sourceBuffers[srcName];\n      assert(feedbackBuffers[dstName] instanceof Buffer);\n    }\n\n    return {\n      sourceBuffers,\n      feedbackBuffers\n    };\n  }\n\n  _createNewBuffer(name, opts) {\n    const buffer = new Buffer(this.gl, opts);\n\n    if (this.resources[name]) {\n      this.resources[name].delete();\n    }\n\n    this.resources[name] = buffer;\n    return buffer;\n  }\n\n  _getNextIndex() {\n    return (this.currentIndex + 1) % 2;\n  }\n\n}\n//# sourceMappingURL=buffer-transform.js.map","export default function getShaderVersion(source) {\n  let version = 100;\n  const words = source.match(/[^\\s]+/g);\n\n  if (words.length >= 2 && words[0] === '#version') {\n    const v = parseInt(words[1], 10);\n\n    if (Number.isFinite(v)) {\n      version = v;\n    }\n  }\n\n  return version;\n}\n//# sourceMappingURL=get-shader-version.js.map","const vs = \"attribute float transform_elementID;\\nvec2 transform_getPixelSizeHalf(vec2 size) {\\n  return vec2(1.) / (2. * size);\\n}\\n\\nvec2 transform_getPixelIndices(vec2 texSize, vec2 pixelSizeHalf) {\\n  float yIndex = floor((transform_elementID / texSize[0]) + pixelSizeHalf[1]);\\n  float xIndex = transform_elementID - (yIndex * texSize[0]);\\n  return vec2(xIndex, yIndex);\\n}\\nvec2 transform_getTexCoord(vec2 size) {\\n  vec2 pixelSizeHalf = transform_getPixelSizeHalf(size);\\n  vec2 indices = transform_getPixelIndices(size, pixelSizeHalf);\\n  vec2 coord = indices / size + pixelSizeHalf;\\n  return coord;\\n}\\nvec2 transform_getPos(vec2 size) {\\n  vec2 texCoord = transform_getTexCoord(size);\\n  vec2 pos = (texCoord * (2.0, 2.0)) - (1., 1.);\\n  return pos;\\n}\\nvec4 transform_getInput(sampler2D texSampler, vec2 size) {\\n  vec2 texCoord = transform_getTexCoord(size);\\n  vec4 textureColor = texture2D(texSampler, texCoord);\\n  return textureColor;\\n}\\n\";\nexport const transform = {\n  name: 'transform',\n  vs,\n  fs: null\n};\n//# sourceMappingURL=transform.js.map","import { assert } from '@luma.gl/webgl';\nimport { combineInjects, getQualifierDetails, typeToChannelSuffix } from '@luma.gl/shadertools';\nconst SAMPLER_UNIFORM_PREFIX = 'transform_uSampler_';\nconst SIZE_UNIFORM_PREFIX = 'transform_uSize_';\nconst VS_POS_VARIABLE = 'transform_position';\nexport function updateForTextures(_ref) {\n  let {\n    vs,\n    sourceTextureMap,\n    targetTextureVarying,\n    targetTexture\n  } = _ref;\n  const texAttributeNames = Object.keys(sourceTextureMap);\n  let sourceCount = texAttributeNames.length;\n  let targetTextureType = null;\n  const samplerTextureMap = {};\n  let updatedVs = vs;\n  let finalInject = {};\n\n  if (sourceCount > 0 || targetTextureVarying) {\n    const vsLines = updatedVs.split('\\n');\n    const updateVsLines = vsLines.slice();\n    vsLines.forEach((line, index, lines) => {\n      if (sourceCount > 0) {\n        const updated = processAttributeDefinition(line, sourceTextureMap);\n\n        if (updated) {\n          const {\n            updatedLine,\n            inject\n          } = updated;\n          updateVsLines[index] = updatedLine;\n          finalInject = combineInjects([finalInject, inject]);\n          Object.assign(samplerTextureMap, updated.samplerTextureMap);\n          sourceCount--;\n        }\n      }\n\n      if (targetTextureVarying && !targetTextureType) {\n        targetTextureType = getVaryingType(line, targetTextureVarying);\n      }\n    });\n\n    if (targetTextureVarying) {\n      assert(targetTexture);\n      const sizeName = \"\".concat(SIZE_UNIFORM_PREFIX).concat(targetTextureVarying);\n      const uniformDeclaration = \"uniform vec2 \".concat(sizeName, \";\\n\");\n      const posInstructions = \"     vec2 \".concat(VS_POS_VARIABLE, \" = transform_getPos(\").concat(sizeName, \");\\n     gl_Position = vec4(\").concat(VS_POS_VARIABLE, \", 0, 1.);\\n\");\n      const inject = {\n        'vs:#decl': uniformDeclaration,\n        'vs:#main-start': posInstructions\n      };\n      finalInject = combineInjects([finalInject, inject]);\n    }\n\n    updatedVs = updateVsLines.join('\\n');\n  }\n\n  return {\n    vs: updatedVs,\n    targetTextureType,\n    inject: finalInject,\n    samplerTextureMap\n  };\n}\nexport function getSizeUniforms(_ref2) {\n  let {\n    sourceTextureMap,\n    targetTextureVarying,\n    targetTexture\n  } = _ref2;\n  const uniforms = {};\n  let width;\n  let height;\n\n  if (targetTextureVarying) {\n    ({\n      width,\n      height\n    } = targetTexture);\n    uniforms[\"\".concat(SIZE_UNIFORM_PREFIX).concat(targetTextureVarying)] = [width, height];\n  }\n\n  for (const textureName in sourceTextureMap) {\n    ({\n      width,\n      height\n    } = sourceTextureMap[textureName]);\n    uniforms[\"\".concat(SIZE_UNIFORM_PREFIX).concat(textureName)] = [width, height];\n  }\n\n  return uniforms;\n}\n\nfunction getAttributeDefinition(line) {\n  return getQualifierDetails(line, ['attribute', 'in']);\n}\n\nfunction getSamplerDeclerations(textureName) {\n  const samplerName = \"\".concat(SAMPLER_UNIFORM_PREFIX).concat(textureName);\n  const sizeName = \"\".concat(SIZE_UNIFORM_PREFIX).concat(textureName);\n  const uniformDeclerations = \"  uniform sampler2D \".concat(samplerName, \";\\n  uniform vec2 \").concat(sizeName, \";\");\n  return {\n    samplerName,\n    sizeName,\n    uniformDeclerations\n  };\n}\n\nexport function getVaryingType(line, varying) {\n  const qualaiferDetails = getQualifierDetails(line, ['varying', 'out']);\n\n  if (!qualaiferDetails) {\n    return null;\n  }\n\n  return qualaiferDetails.name === varying ? qualaiferDetails.type : null;\n}\nexport function processAttributeDefinition(line, textureMap) {\n  const samplerTextureMap = {};\n  const attributeData = getAttributeDefinition(line);\n\n  if (!attributeData) {\n    return null;\n  }\n\n  const {\n    type,\n    name\n  } = attributeData;\n\n  if (name && textureMap[name]) {\n    const updatedLine = \"// \".concat(line, \" => Replaced by Transform with a sampler\");\n    const {\n      samplerName,\n      sizeName,\n      uniformDeclerations\n    } = getSamplerDeclerations(name);\n    const channels = typeToChannelSuffix(type);\n    const sampleInstruction = \"  \".concat(type, \" \").concat(name, \" = transform_getInput(\").concat(samplerName, \", \").concat(sizeName, \").\").concat(channels, \";\\n\");\n    samplerTextureMap[samplerName] = name;\n    const inject = {\n      'vs:#decl': uniformDeclerations,\n      'vs:#main-start': sampleInstruction\n    };\n    return {\n      updatedLine,\n      inject,\n      samplerTextureMap\n    };\n  }\n\n  return null;\n}\n//# sourceMappingURL=transform-shader-utils.js.map","import { cloneTextureFrom, readPixelsToArray, getShaderVersion, Buffer, Texture2D, Framebuffer } from '@luma.gl/webgl';\nimport { _transform as transformModule, getPassthroughFS, typeToChannelCount, combineInjects } from '@luma.gl/shadertools';\nimport { updateForTextures, getSizeUniforms } from './transform-shader-utils';\nconst SRC_TEX_PARAMETER_OVERRIDES = {\n  [10241]: 9728,\n  [10240]: 9728,\n  [10242]: 33071,\n  [10243]: 33071\n};\nconst FS_OUTPUT_VARIABLE = 'transform_output';\nexport default class TextureTransform {\n  constructor(gl) {\n    let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    this.gl = gl;\n    this.id = this.currentIndex = 0;\n    this._swapTexture = null;\n    this.targetTextureVarying = null;\n    this.targetTextureType = null;\n    this.samplerTextureMap = null;\n    this.bindings = [];\n    this.resources = {};\n\n    this._initialize(props);\n\n    Object.seal(this);\n  }\n\n  updateModelProps() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    const updatedModelProps = this._processVertexShader(props);\n\n    return Object.assign({}, props, updatedModelProps);\n  }\n\n  getDrawOptions() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      sourceBuffers,\n      sourceTextures,\n      framebuffer,\n      targetTexture\n    } = this.bindings[this.currentIndex];\n    const attributes = Object.assign({}, sourceBuffers, opts.attributes);\n    const uniforms = Object.assign({}, opts.uniforms);\n    const parameters = Object.assign({}, opts.parameters);\n    let discard = opts.discard;\n\n    if (this.hasSourceTextures || this.hasTargetTexture) {\n      attributes.transform_elementID = this.elementIDBuffer;\n\n      for (const sampler in this.samplerTextureMap) {\n        const textureName = this.samplerTextureMap[sampler];\n        uniforms[sampler] = sourceTextures[textureName];\n      }\n\n      this._setSourceTextureParameters();\n\n      const sizeUniforms = getSizeUniforms({\n        sourceTextureMap: sourceTextures,\n        targetTextureVarying: this.targetTextureVarying,\n        targetTexture\n      });\n      Object.assign(uniforms, sizeUniforms);\n    }\n\n    if (this.hasTargetTexture) {\n      discard = false;\n      parameters.viewport = [0, 0, framebuffer.width, framebuffer.height];\n    }\n\n    return {\n      attributes,\n      framebuffer,\n      uniforms,\n      discard,\n      parameters\n    };\n  }\n\n  swap() {\n    if (this._swapTexture) {\n      this.currentIndex = this._getNextIndex();\n      return true;\n    }\n\n    return false;\n  }\n\n  update() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    this._setupTextures(opts);\n  }\n\n  getTargetTexture() {\n    const {\n      targetTexture\n    } = this.bindings[this.currentIndex];\n    return targetTexture;\n  }\n\n  getData() {\n    let {\n      packed = false\n    } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      framebuffer\n    } = this.bindings[this.currentIndex];\n    const pixels = readPixelsToArray(framebuffer);\n\n    if (!packed) {\n      return pixels;\n    }\n\n    const ArrayType = pixels.constructor;\n    const channelCount = typeToChannelCount(this.targetTextureType);\n    const packedPixels = new ArrayType(pixels.length * channelCount / 4);\n    let packCount = 0;\n\n    for (let i = 0; i < pixels.length; i += 4) {\n      for (let j = 0; j < channelCount; j++) {\n        packedPixels[packCount++] = pixels[i + j];\n      }\n    }\n\n    return packedPixels;\n  }\n\n  getFramebuffer() {\n    const currentResources = this.bindings[this.currentIndex];\n    return currentResources.framebuffer;\n  }\n\n  delete() {\n    if (this.ownTexture) {\n      this.ownTexture.delete();\n    }\n\n    if (this.elementIDBuffer) {\n      this.elementIDBuffer.delete();\n    }\n  }\n\n  _initialize() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      _targetTextureVarying,\n      _swapTexture\n    } = props;\n    this._swapTexture = _swapTexture;\n    this.targetTextureVarying = _targetTextureVarying;\n    this.hasTargetTexture = _targetTextureVarying;\n\n    this._setupTextures(props);\n  }\n\n  _createTargetTexture(props) {\n    const {\n      sourceTextures,\n      textureOrReference\n    } = props;\n\n    if (textureOrReference instanceof Texture2D) {\n      return textureOrReference;\n    }\n\n    const refTexture = sourceTextures[textureOrReference];\n\n    if (!refTexture) {\n      return null;\n    }\n\n    this._targetRefTexName = textureOrReference;\n    return this._createNewTexture(refTexture);\n  }\n\n  _setupTextures() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      sourceBuffers,\n      _sourceTextures = {},\n      _targetTexture\n    } = props;\n\n    const targetTexture = this._createTargetTexture({\n      sourceTextures: _sourceTextures,\n      textureOrReference: _targetTexture\n    });\n\n    this.hasSourceTextures = this.hasSourceTextures || _sourceTextures && Object.keys(_sourceTextures).length > 0;\n\n    this._updateBindings({\n      sourceBuffers,\n      sourceTextures: _sourceTextures,\n      targetTexture\n    });\n\n    if ('elementCount' in props) {\n      this._updateElementIDBuffer(props.elementCount);\n    }\n  }\n\n  _updateElementIDBuffer(elementCount) {\n    if (typeof elementCount !== 'number' || this.elementCount >= elementCount) {\n      return;\n    }\n\n    const elementIds = new Float32Array(elementCount);\n    elementIds.forEach((_, index, array) => {\n      array[index] = index;\n    });\n\n    if (!this.elementIDBuffer) {\n      this.elementIDBuffer = new Buffer(this.gl, {\n        data: elementIds,\n        accessor: {\n          size: 1\n        }\n      });\n    } else {\n      this.elementIDBuffer.setData({\n        data: elementIds\n      });\n    }\n\n    this.elementCount = elementCount;\n  }\n\n  _updateBindings(opts) {\n    this.bindings[this.currentIndex] = this._updateBinding(this.bindings[this.currentIndex], opts);\n\n    if (this._swapTexture) {\n      const {\n        sourceTextures,\n        targetTexture\n      } = this._swapTextures(this.bindings[this.currentIndex]);\n\n      const nextIndex = this._getNextIndex();\n\n      this.bindings[nextIndex] = this._updateBinding(this.bindings[nextIndex], {\n        sourceTextures,\n        targetTexture\n      });\n    }\n  }\n\n  _updateBinding(binding, opts) {\n    const {\n      sourceBuffers,\n      sourceTextures,\n      targetTexture\n    } = opts;\n\n    if (!binding) {\n      binding = {\n        sourceBuffers: {},\n        sourceTextures: {},\n        targetTexture: null\n      };\n    }\n\n    Object.assign(binding.sourceTextures, sourceTextures);\n    Object.assign(binding.sourceBuffers, sourceBuffers);\n\n    if (targetTexture) {\n      binding.targetTexture = targetTexture;\n      const {\n        width,\n        height\n      } = targetTexture;\n      const {\n        framebuffer\n      } = binding;\n\n      if (framebuffer) {\n        framebuffer.update({\n          attachments: {\n            [36064]: targetTexture\n          },\n          resizeAttachments: false\n        });\n        framebuffer.resize({\n          width,\n          height\n        });\n      } else {\n        binding.framebuffer = new Framebuffer(this.gl, {\n          id: \"transform-framebuffer\",\n          width,\n          height,\n          attachments: {\n            [36064]: targetTexture\n          }\n        });\n      }\n    }\n\n    return binding;\n  }\n\n  _setSourceTextureParameters() {\n    const index = this.currentIndex;\n    const {\n      sourceTextures\n    } = this.bindings[index];\n\n    for (const name in sourceTextures) {\n      sourceTextures[name].setParameters(SRC_TEX_PARAMETER_OVERRIDES);\n    }\n  }\n\n  _swapTextures(opts) {\n    if (!this._swapTexture) {\n      return null;\n    }\n\n    const sourceTextures = Object.assign({}, opts.sourceTextures);\n    sourceTextures[this._swapTexture] = opts.targetTexture;\n    const targetTexture = opts.sourceTextures[this._swapTexture];\n    return {\n      sourceTextures,\n      targetTexture\n    };\n  }\n\n  _createNewTexture(refTexture) {\n    const texture = cloneTextureFrom(refTexture, {\n      parameters: {\n        [10241]: 9728,\n        [10240]: 9728,\n        [10242]: 33071,\n        [10243]: 33071\n      },\n      pixelStore: {\n        [37440]: false\n      }\n    });\n\n    if (this.ownTexture) {\n      this.ownTexture.delete();\n    }\n\n    this.ownTexture = texture;\n    return texture;\n  }\n\n  _getNextIndex() {\n    return (this.currentIndex + 1) % 2;\n  }\n\n  _processVertexShader() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      sourceTextures,\n      targetTexture\n    } = this.bindings[this.currentIndex];\n    const {\n      vs,\n      uniforms,\n      targetTextureType,\n      inject,\n      samplerTextureMap\n    } = updateForTextures({\n      vs: props.vs,\n      sourceTextureMap: sourceTextures,\n      targetTextureVarying: this.targetTextureVarying,\n      targetTexture\n    });\n    const combinedInject = combineInjects([props.inject || {}, inject]);\n    this.targetTextureType = targetTextureType;\n    this.samplerTextureMap = samplerTextureMap;\n    const fs = props._fs || getPassthroughFS({\n      version: getShaderVersion(vs),\n      input: this.targetTextureVarying,\n      inputType: targetTextureType,\n      output: FS_OUTPUT_VARIABLE\n    });\n    const modules = this.hasSourceTextures || this.targetTextureVarying ? [transformModule].concat(props.modules || []) : props.modules;\n    return {\n      vs,\n      fs,\n      modules,\n      uniforms,\n      inject: combinedInject\n    };\n  }\n\n}\n//# sourceMappingURL=texture-transform.js.map","import { getPassthroughFS } from '@luma.gl/shadertools';\nimport BufferTransform from './buffer-transform';\nimport TextureTransform from './texture-transform';\nimport { isWebGL2 } from '@luma.gl/gltools';\nimport { assert, isObjectEmpty, getShaderVersion } from '@luma.gl/webgl';\nimport Model from '../lib/model';\nexport default class Transform {\n  static isSupported(gl) {\n    return isWebGL2(gl);\n  }\n\n  constructor(gl) {\n    let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};\n    this.gl = gl;\n    this.model = null;\n    this.elementCount = 0;\n    this.bufferTransform = null;\n    this.textureTransform = null;\n    this.elementIDBuffer = null;\n\n    this._initialize(props);\n\n    Object.seal(this);\n  }\n\n  delete() {\n    const {\n      model,\n      bufferTransform,\n      textureTransform\n    } = this;\n\n    if (model) {\n      model.delete();\n    }\n\n    if (bufferTransform) {\n      bufferTransform.delete();\n    }\n\n    if (textureTransform) {\n      textureTransform.delete();\n    }\n  }\n\n  run() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      clearRenderTarget = true\n    } = opts;\n\n    const updatedOpts = this._updateDrawOptions(opts);\n\n    if (clearRenderTarget && updatedOpts.framebuffer) {\n      updatedOpts.framebuffer.clear({\n        color: true\n      });\n    }\n\n    this.model.transform(updatedOpts);\n  }\n\n  swap() {\n    let swapped = false;\n    const resourceTransforms = [this.bufferTransform, this.textureTransform].filter(Boolean);\n\n    for (const resourceTransform of resourceTransforms) {\n      swapped = swapped || resourceTransform.swap();\n    }\n\n    assert(swapped, 'Nothing to swap');\n  }\n\n  getBuffer() {\n    let varyingName = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;\n    return this.bufferTransform && this.bufferTransform.getBuffer(varyingName);\n  }\n\n  getData() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const resourceTransforms = [this.bufferTransform, this.textureTransform].filter(Boolean);\n\n    for (const resourceTransform of resourceTransforms) {\n      const data = resourceTransform.getData(opts);\n\n      if (data) {\n        return data;\n      }\n    }\n\n    return null;\n  }\n\n  getFramebuffer() {\n    return this.textureTransform && this.textureTransform.getFramebuffer();\n  }\n\n  update() {\n    let opts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n\n    if ('elementCount' in opts) {\n      this.model.setVertexCount(opts.elementCount);\n    }\n\n    const resourceTransforms = [this.bufferTransform, this.textureTransform].filter(Boolean);\n\n    for (const resourceTransform of resourceTransforms) {\n      resourceTransform.update(opts);\n    }\n  }\n\n  _initialize() {\n    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n    const {\n      gl\n    } = this;\n\n    this._buildResourceTransforms(gl, props);\n\n    props = this._updateModelProps(props);\n    this.model = new Model(gl, Object.assign({}, props, {\n      fs: props.fs || getPassthroughFS({\n        version: getShaderVersion(props.vs)\n      }),\n      id: props.id || 'transform-model',\n      drawMode: props.drawMode || 0,\n      vertexCount: props.elementCount\n    }));\n    this.bufferTransform && this.bufferTransform.setupResources({\n      model: this.model\n    });\n  }\n\n  _updateModelProps(props) {\n    let updatedProps = Object.assign({}, props);\n    const resourceTransforms = [this.bufferTransform, this.textureTransform].filter(Boolean);\n\n    for (const resourceTransform of resourceTransforms) {\n      updatedProps = resourceTransform.updateModelProps(updatedProps);\n    }\n\n    return updatedProps;\n  }\n\n  _buildResourceTransforms(gl, props) {\n    if (canCreateBufferTransform(props)) {\n      this.bufferTransform = new BufferTransform(gl, props);\n    }\n\n    if (canCreateTextureTransform(props)) {\n      this.textureTransform = new TextureTransform(gl, props);\n    }\n\n    assert(this.bufferTransform || this.textureTransform, 'must provide source/feedback buffers or source/target textures');\n  }\n\n  _updateDrawOptions(opts) {\n    let updatedOpts = Object.assign({}, opts);\n    const resourceTransforms = [this.bufferTransform, this.textureTransform].filter(Boolean);\n\n    for (const resourceTransform of resourceTransforms) {\n      updatedOpts = Object.assign(updatedOpts, resourceTransform.getDrawOptions(updatedOpts));\n    }\n\n    return updatedOpts;\n  }\n\n}\n\nfunction canCreateBufferTransform(props) {\n  if (!isObjectEmpty(props.feedbackBuffers) || !isObjectEmpty(props.feedbackMap) || props.varyings && props.varyings.length > 0) {\n    return true;\n  }\n\n  return false;\n}\n\nfunction canCreateTextureTransform(props) {\n  if (!isObjectEmpty(props._sourceTextures) || props._targetTexture || props._targetTextureVarying) {\n    return true;\n  }\n\n  return false;\n}\n//# sourceMappingURL=transform.js.map","import Vector from './base/vector';\nimport { config, isArray } from '../lib/common';\nimport { checkNumber } from '../lib/validators';\nimport * as vec4 from 'gl-matrix/vec3';\nimport { vec4_transformMat2, vec4_transformMat3 } from '../lib/gl-matrix-extras';\nlet ZERO;\nexport default class Vector4 extends Vector {\n  static get ZERO() {\n    if (!ZERO) {\n      ZERO = new Vector4(0, 0, 0, 0);\n      Object.freeze(ZERO);\n    }\n\n    return ZERO;\n  }\n\n  constructor(x = 0, y = 0, z = 0, w = 0) {\n    super(-0, -0, -0, -0);\n\n    if (isArray(x) && arguments.length === 1) {\n      this.copy(x);\n    } else {\n      if (config.debug) {\n        checkNumber(x);\n        checkNumber(y);\n        checkNumber(z);\n        checkNumber(w);\n      }\n\n      this[0] = x;\n      this[1] = y;\n      this[2] = z;\n      this[3] = w;\n    }\n  }\n\n  set(x, y, z, w) {\n    this[0] = x;\n    this[1] = y;\n    this[2] = z;\n    this[3] = w;\n    return this.check();\n  }\n\n  copy(array) {\n    this[0] = array[0];\n    this[1] = array[1];\n    this[2] = array[2];\n    this[3] = array[3];\n    return this.check();\n  }\n\n  fromObject(object) {\n    if (config.debug) {\n      checkNumber(object.x);\n      checkNumber(object.y);\n      checkNumber(object.z);\n      checkNumber(object.w);\n    }\n\n    this[0] = object.x;\n    this[1] = object.y;\n    this[2] = object.z;\n    this[3] = object.w;\n    return this;\n  }\n\n  toObject(object) {\n    object.x = this[0];\n    object.y = this[1];\n    object.z = this[2];\n    object.w = this[3];\n    return object;\n  }\n\n  get ELEMENTS() {\n    return 4;\n  }\n\n  get z() {\n    return this[2];\n  }\n\n  set z(value) {\n    this[2] = checkNumber(value);\n  }\n\n  get w() {\n    return this[3];\n  }\n\n  set w(value) {\n    this[3] = checkNumber(value);\n  }\n\n  transform(matrix4) {\n    vec4.transformMat4(this, this, matrix4);\n    return this.check();\n  }\n\n  transformByMatrix3(matrix3) {\n    vec4_transformMat3(this, this, matrix3);\n    return this.check();\n  }\n\n  transformByMatrix2(matrix2) {\n    vec4_transformMat2(this, this, matrix2);\n    return this.check();\n  }\n\n  transformByQuaternion(quaternion) {\n    vec4.transformQuat(this, this, quaternion);\n    return this.check();\n  }\n\n  applyMatrix4(m) {\n    m.transform(this, this);\n    return this;\n  }\n\n}\n//# sourceMappingURL=vector4.js.map","import * as glMatrix from \"./common.js\";\nimport * as mat3 from \"./mat3.js\";\nimport * as vec3 from \"./vec3.js\";\nimport * as vec4 from \"./vec4.js\";\n/**\n * Quaternion\n * @module quat\n */\n\n/**\n * Creates a new identity quat\n *\n * @returns {quat} a new quaternion\n */\n\nexport function create() {\n  var out = new glMatrix.ARRAY_TYPE(4);\n\n  if (glMatrix.ARRAY_TYPE != Float32Array) {\n    out[0] = 0;\n    out[1] = 0;\n    out[2] = 0;\n  }\n\n  out[3] = 1;\n  return out;\n}\n/**\n * Set a quat to the identity quaternion\n *\n * @param {quat} out the receiving quaternion\n * @returns {quat} out\n */\n\nexport function identity(out) {\n  out[0] = 0;\n  out[1] = 0;\n  out[2] = 0;\n  out[3] = 1;\n  return out;\n}\n/**\n * Sets a quat from the given angle and rotation axis,\n * then returns it.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyVec3} axis the axis around which to rotate\n * @param {Number} rad the angle in radians\n * @returns {quat} out\n **/\n\nexport function setAxisAngle(out, axis, rad) {\n  rad = rad * 0.5;\n  var s = Math.sin(rad);\n  out[0] = s * axis[0];\n  out[1] = s * axis[1];\n  out[2] = s * axis[2];\n  out[3] = Math.cos(rad);\n  return out;\n}\n/**\n * Gets the rotation axis and angle for a given\n *  quaternion. If a quaternion is created with\n *  setAxisAngle, this method will return the same\n *  values as providied in the original parameter list\n *  OR functionally equivalent values.\n * Example: The quaternion formed by axis [0, 0, 1] and\n *  angle -90 is the same as the quaternion formed by\n *  [0, 0, 1] and 270. This method favors the latter.\n * @param  {vec3} out_axis  Vector receiving the axis of rotation\n * @param  {ReadonlyQuat} q     Quaternion to be decomposed\n * @return {Number}     Angle, in radians, of the rotation\n */\n\nexport function getAxisAngle(out_axis, q) {\n  var rad = Math.acos(q[3]) * 2.0;\n  var s = Math.sin(rad / 2.0);\n\n  if (s > glMatrix.EPSILON) {\n    out_axis[0] = q[0] / s;\n    out_axis[1] = q[1] / s;\n    out_axis[2] = q[2] / s;\n  } else {\n    // If s is zero, return any axis (no rotation - axis does not matter)\n    out_axis[0] = 1;\n    out_axis[1] = 0;\n    out_axis[2] = 0;\n  }\n\n  return rad;\n}\n/**\n * Gets the angular distance between two unit quaternions\n *\n * @param  {ReadonlyQuat} a     Origin unit quaternion\n * @param  {ReadonlyQuat} b     Destination unit quaternion\n * @return {Number}     Angle, in radians, between the two quaternions\n */\n\nexport function getAngle(a, b) {\n  var dotproduct = dot(a, b);\n  return Math.acos(2 * dotproduct * dotproduct - 1);\n}\n/**\n * Multiplies two quat's\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a the first operand\n * @param {ReadonlyQuat} b the second operand\n * @returns {quat} out\n */\n\nexport function multiply(out, a, b) {\n  var ax = a[0],\n      ay = a[1],\n      az = a[2],\n      aw = a[3];\n  var bx = b[0],\n      by = b[1],\n      bz = b[2],\n      bw = b[3];\n  out[0] = ax * bw + aw * bx + ay * bz - az * by;\n  out[1] = ay * bw + aw * by + az * bx - ax * bz;\n  out[2] = az * bw + aw * bz + ax * by - ay * bx;\n  out[3] = aw * bw - ax * bx - ay * by - az * bz;\n  return out;\n}\n/**\n * Rotates a quaternion by the given angle about the X axis\n *\n * @param {quat} out quat receiving operation result\n * @param {ReadonlyQuat} a quat to rotate\n * @param {number} rad angle (in radians) to rotate\n * @returns {quat} out\n */\n\nexport function rotateX(out, a, rad) {\n  rad *= 0.5;\n  var ax = a[0],\n      ay = a[1],\n      az = a[2],\n      aw = a[3];\n  var bx = Math.sin(rad),\n      bw = Math.cos(rad);\n  out[0] = ax * bw + aw * bx;\n  out[1] = ay * bw + az * bx;\n  out[2] = az * bw - ay * bx;\n  out[3] = aw * bw - ax * bx;\n  return out;\n}\n/**\n * Rotates a quaternion by the given angle about the Y axis\n *\n * @param {quat} out quat receiving operation result\n * @param {ReadonlyQuat} a quat to rotate\n * @param {number} rad angle (in radians) to rotate\n * @returns {quat} out\n */\n\nexport function rotateY(out, a, rad) {\n  rad *= 0.5;\n  var ax = a[0],\n      ay = a[1],\n      az = a[2],\n      aw = a[3];\n  var by = Math.sin(rad),\n      bw = Math.cos(rad);\n  out[0] = ax * bw - az * by;\n  out[1] = ay * bw + aw * by;\n  out[2] = az * bw + ax * by;\n  out[3] = aw * bw - ay * by;\n  return out;\n}\n/**\n * Rotates a quaternion by the given angle about the Z axis\n *\n * @param {quat} out quat receiving operation result\n * @param {ReadonlyQuat} a quat to rotate\n * @param {number} rad angle (in radians) to rotate\n * @returns {quat} out\n */\n\nexport function rotateZ(out, a, rad) {\n  rad *= 0.5;\n  var ax = a[0],\n      ay = a[1],\n      az = a[2],\n      aw = a[3];\n  var bz = Math.sin(rad),\n      bw = Math.cos(rad);\n  out[0] = ax * bw + ay * bz;\n  out[1] = ay * bw - ax * bz;\n  out[2] = az * bw + aw * bz;\n  out[3] = aw * bw - az * bz;\n  return out;\n}\n/**\n * Calculates the W component of a quat from the X, Y, and Z components.\n * Assumes that quaternion is 1 unit in length.\n * Any existing W component will be ignored.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quat to calculate W component of\n * @returns {quat} out\n */\n\nexport function calculateW(out, a) {\n  var x = a[0],\n      y = a[1],\n      z = a[2];\n  out[0] = x;\n  out[1] = y;\n  out[2] = z;\n  out[3] = Math.sqrt(Math.abs(1.0 - x * x - y * y - z * z));\n  return out;\n}\n/**\n * Calculate the exponential of a unit quaternion.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quat to calculate the exponential of\n * @returns {quat} out\n */\n\nexport function exp(out, a) {\n  var x = a[0],\n      y = a[1],\n      z = a[2],\n      w = a[3];\n  var r = Math.sqrt(x * x + y * y + z * z);\n  var et = Math.exp(w);\n  var s = r > 0 ? et * Math.sin(r) / r : 0;\n  out[0] = x * s;\n  out[1] = y * s;\n  out[2] = z * s;\n  out[3] = et * Math.cos(r);\n  return out;\n}\n/**\n * Calculate the natural logarithm of a unit quaternion.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quat to calculate the exponential of\n * @returns {quat} out\n */\n\nexport function ln(out, a) {\n  var x = a[0],\n      y = a[1],\n      z = a[2],\n      w = a[3];\n  var r = Math.sqrt(x * x + y * y + z * z);\n  var t = r > 0 ? Math.atan2(r, w) / r : 0;\n  out[0] = x * t;\n  out[1] = y * t;\n  out[2] = z * t;\n  out[3] = 0.5 * Math.log(x * x + y * y + z * z + w * w);\n  return out;\n}\n/**\n * Calculate the scalar power of a unit quaternion.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quat to calculate the exponential of\n * @param {Number} b amount to scale the quaternion by\n * @returns {quat} out\n */\n\nexport function pow(out, a, b) {\n  ln(out, a);\n  scale(out, out, b);\n  exp(out, out);\n  return out;\n}\n/**\n * Performs a spherical linear interpolation between two quat\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a the first operand\n * @param {ReadonlyQuat} b the second operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {quat} out\n */\n\nexport function slerp(out, a, b, t) {\n  // benchmarks:\n  //    http://jsperf.com/quaternion-slerp-implementations\n  var ax = a[0],\n      ay = a[1],\n      az = a[2],\n      aw = a[3];\n  var bx = b[0],\n      by = b[1],\n      bz = b[2],\n      bw = b[3];\n  var omega, cosom, sinom, scale0, scale1; // calc cosine\n\n  cosom = ax * bx + ay * by + az * bz + aw * bw; // adjust signs (if necessary)\n\n  if (cosom < 0.0) {\n    cosom = -cosom;\n    bx = -bx;\n    by = -by;\n    bz = -bz;\n    bw = -bw;\n  } // calculate coefficients\n\n\n  if (1.0 - cosom > glMatrix.EPSILON) {\n    // standard case (slerp)\n    omega = Math.acos(cosom);\n    sinom = Math.sin(omega);\n    scale0 = Math.sin((1.0 - t) * omega) / sinom;\n    scale1 = Math.sin(t * omega) / sinom;\n  } else {\n    // \"from\" and \"to\" quaternions are very close\n    //  ... so we can do a linear interpolation\n    scale0 = 1.0 - t;\n    scale1 = t;\n  } // calculate final values\n\n\n  out[0] = scale0 * ax + scale1 * bx;\n  out[1] = scale0 * ay + scale1 * by;\n  out[2] = scale0 * az + scale1 * bz;\n  out[3] = scale0 * aw + scale1 * bw;\n  return out;\n}\n/**\n * Generates a random unit quaternion\n *\n * @param {quat} out the receiving quaternion\n * @returns {quat} out\n */\n\nexport function random(out) {\n  // Implementation of http://planning.cs.uiuc.edu/node198.html\n  // TODO: Calling random 3 times is probably not the fastest solution\n  var u1 = glMatrix.RANDOM();\n  var u2 = glMatrix.RANDOM();\n  var u3 = glMatrix.RANDOM();\n  var sqrt1MinusU1 = Math.sqrt(1 - u1);\n  var sqrtU1 = Math.sqrt(u1);\n  out[0] = sqrt1MinusU1 * Math.sin(2.0 * Math.PI * u2);\n  out[1] = sqrt1MinusU1 * Math.cos(2.0 * Math.PI * u2);\n  out[2] = sqrtU1 * Math.sin(2.0 * Math.PI * u3);\n  out[3] = sqrtU1 * Math.cos(2.0 * Math.PI * u3);\n  return out;\n}\n/**\n * Calculates the inverse of a quat\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quat to calculate inverse of\n * @returns {quat} out\n */\n\nexport function invert(out, a) {\n  var a0 = a[0],\n      a1 = a[1],\n      a2 = a[2],\n      a3 = a[3];\n  var dot = a0 * a0 + a1 * a1 + a2 * a2 + a3 * a3;\n  var invDot = dot ? 1.0 / dot : 0; // TODO: Would be faster to return [0,0,0,0] immediately if dot == 0\n\n  out[0] = -a0 * invDot;\n  out[1] = -a1 * invDot;\n  out[2] = -a2 * invDot;\n  out[3] = a3 * invDot;\n  return out;\n}\n/**\n * Calculates the conjugate of a quat\n * If the quaternion is normalized, this function is faster than quat.inverse and produces the same result.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quat to calculate conjugate of\n * @returns {quat} out\n */\n\nexport function conjugate(out, a) {\n  out[0] = -a[0];\n  out[1] = -a[1];\n  out[2] = -a[2];\n  out[3] = a[3];\n  return out;\n}\n/**\n * Creates a quaternion from the given 3x3 rotation matrix.\n *\n * NOTE: The resultant quaternion is not normalized, so you should be sure\n * to renormalize the quaternion yourself where necessary.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyMat3} m rotation matrix\n * @returns {quat} out\n * @function\n */\n\nexport function fromMat3(out, m) {\n  // Algorithm in Ken Shoemake's article in 1987 SIGGRAPH course notes\n  // article \"Quaternion Calculus and Fast Animation\".\n  var fTrace = m[0] + m[4] + m[8];\n  var fRoot;\n\n  if (fTrace > 0.0) {\n    // |w| > 1/2, may as well choose w > 1/2\n    fRoot = Math.sqrt(fTrace + 1.0); // 2w\n\n    out[3] = 0.5 * fRoot;\n    fRoot = 0.5 / fRoot; // 1/(4w)\n\n    out[0] = (m[5] - m[7]) * fRoot;\n    out[1] = (m[6] - m[2]) * fRoot;\n    out[2] = (m[1] - m[3]) * fRoot;\n  } else {\n    // |w| <= 1/2\n    var i = 0;\n    if (m[4] > m[0]) i = 1;\n    if (m[8] > m[i * 3 + i]) i = 2;\n    var j = (i + 1) % 3;\n    var k = (i + 2) % 3;\n    fRoot = Math.sqrt(m[i * 3 + i] - m[j * 3 + j] - m[k * 3 + k] + 1.0);\n    out[i] = 0.5 * fRoot;\n    fRoot = 0.5 / fRoot;\n    out[3] = (m[j * 3 + k] - m[k * 3 + j]) * fRoot;\n    out[j] = (m[j * 3 + i] + m[i * 3 + j]) * fRoot;\n    out[k] = (m[k * 3 + i] + m[i * 3 + k]) * fRoot;\n  }\n\n  return out;\n}\n/**\n * Creates a quaternion from the given euler angle x, y, z.\n *\n * @param {quat} out the receiving quaternion\n * @param {x} Angle to rotate around X axis in degrees.\n * @param {y} Angle to rotate around Y axis in degrees.\n * @param {z} Angle to rotate around Z axis in degrees.\n * @returns {quat} out\n * @function\n */\n\nexport function fromEuler(out, x, y, z) {\n  var halfToRad = 0.5 * Math.PI / 180.0;\n  x *= halfToRad;\n  y *= halfToRad;\n  z *= halfToRad;\n  var sx = Math.sin(x);\n  var cx = Math.cos(x);\n  var sy = Math.sin(y);\n  var cy = Math.cos(y);\n  var sz = Math.sin(z);\n  var cz = Math.cos(z);\n  out[0] = sx * cy * cz - cx * sy * sz;\n  out[1] = cx * sy * cz + sx * cy * sz;\n  out[2] = cx * cy * sz - sx * sy * cz;\n  out[3] = cx * cy * cz + sx * sy * sz;\n  return out;\n}\n/**\n * Returns a string representation of a quatenion\n *\n * @param {ReadonlyQuat} a vector to represent as a string\n * @returns {String} string representation of the vector\n */\n\nexport function str(a) {\n  return \"quat(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \", \" + a[3] + \")\";\n}\n/**\n * Creates a new quat initialized with values from an existing quaternion\n *\n * @param {ReadonlyQuat} a quaternion to clone\n * @returns {quat} a new quaternion\n * @function\n */\n\nexport var clone = vec4.clone;\n/**\n * Creates a new quat initialized with the given values\n *\n * @param {Number} x X component\n * @param {Number} y Y component\n * @param {Number} z Z component\n * @param {Number} w W component\n * @returns {quat} a new quaternion\n * @function\n */\n\nexport var fromValues = vec4.fromValues;\n/**\n * Copy the values from one quat to another\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a the source quaternion\n * @returns {quat} out\n * @function\n */\n\nexport var copy = vec4.copy;\n/**\n * Set the components of a quat to the given values\n *\n * @param {quat} out the receiving quaternion\n * @param {Number} x X component\n * @param {Number} y Y component\n * @param {Number} z Z component\n * @param {Number} w W component\n * @returns {quat} out\n * @function\n */\n\nexport var set = vec4.set;\n/**\n * Adds two quat's\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a the first operand\n * @param {ReadonlyQuat} b the second operand\n * @returns {quat} out\n * @function\n */\n\nexport var add = vec4.add;\n/**\n * Alias for {@link quat.multiply}\n * @function\n */\n\nexport var mul = multiply;\n/**\n * Scales a quat by a scalar number\n *\n * @param {quat} out the receiving vector\n * @param {ReadonlyQuat} a the vector to scale\n * @param {Number} b amount to scale the vector by\n * @returns {quat} out\n * @function\n */\n\nexport var scale = vec4.scale;\n/**\n * Calculates the dot product of two quat's\n *\n * @param {ReadonlyQuat} a the first operand\n * @param {ReadonlyQuat} b the second operand\n * @returns {Number} dot product of a and b\n * @function\n */\n\nexport var dot = vec4.dot;\n/**\n * Performs a linear interpolation between two quat's\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a the first operand\n * @param {ReadonlyQuat} b the second operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {quat} out\n * @function\n */\n\nexport var lerp = vec4.lerp;\n/**\n * Calculates the length of a quat\n *\n * @param {ReadonlyQuat} a vector to calculate length of\n * @returns {Number} length of a\n */\n\nexport var length = vec4.length;\n/**\n * Alias for {@link quat.length}\n * @function\n */\n\nexport var len = length;\n/**\n * Calculates the squared length of a quat\n *\n * @param {ReadonlyQuat} a vector to calculate squared length of\n * @returns {Number} squared length of a\n * @function\n */\n\nexport var squaredLength = vec4.squaredLength;\n/**\n * Alias for {@link quat.squaredLength}\n * @function\n */\n\nexport var sqrLen = squaredLength;\n/**\n * Normalize a quat\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quaternion to normalize\n * @returns {quat} out\n * @function\n */\n\nexport var normalize = vec4.normalize;\n/**\n * Returns whether or not the quaternions have exactly the same elements in the same position (when compared with ===)\n *\n * @param {ReadonlyQuat} a The first quaternion.\n * @param {ReadonlyQuat} b The second quaternion.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\n\nexport var exactEquals = vec4.exactEquals;\n/**\n * Returns whether or not the quaternions have approximately the same elements in the same position.\n *\n * @param {ReadonlyQuat} a The first vector.\n * @param {ReadonlyQuat} b The second vector.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\n\nexport var equals = vec4.equals;\n/**\n * Sets a quaternion to represent the shortest rotation from one\n * vector to another.\n *\n * Both vectors are assumed to be unit length.\n *\n * @param {quat} out the receiving quaternion.\n * @param {ReadonlyVec3} a the initial vector\n * @param {ReadonlyVec3} b the destination vector\n * @returns {quat} out\n */\n\nexport var rotationTo = function () {\n  var tmpvec3 = vec3.create();\n  var xUnitVec3 = vec3.fromValues(1, 0, 0);\n  var yUnitVec3 = vec3.fromValues(0, 1, 0);\n  return function (out, a, b) {\n    var dot = vec3.dot(a, b);\n\n    if (dot < -0.999999) {\n      vec3.cross(tmpvec3, xUnitVec3, a);\n      if (vec3.len(tmpvec3) < 0.000001) vec3.cross(tmpvec3, yUnitVec3, a);\n      vec3.normalize(tmpvec3, tmpvec3);\n      setAxisAngle(out, tmpvec3, Math.PI);\n      return out;\n    } else if (dot > 0.999999) {\n      out[0] = 0;\n      out[1] = 0;\n      out[2] = 0;\n      out[3] = 1;\n      return out;\n    } else {\n      vec3.cross(tmpvec3, a, b);\n      out[0] = tmpvec3[0];\n      out[1] = tmpvec3[1];\n      out[2] = tmpvec3[2];\n      out[3] = 1 + dot;\n      return normalize(out, out);\n    }\n  };\n}();\n/**\n * Performs a spherical linear interpolation with two control points\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a the first operand\n * @param {ReadonlyQuat} b the second operand\n * @param {ReadonlyQuat} c the third operand\n * @param {ReadonlyQuat} d the fourth operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {quat} out\n */\n\nexport var sqlerp = function () {\n  var temp1 = create();\n  var temp2 = create();\n  return function (out, a, b, c, d, t) {\n    slerp(temp1, a, d, t);\n    slerp(temp2, b, c, t);\n    slerp(out, temp1, temp2, 2 * t * (1 - t));\n    return out;\n  };\n}();\n/**\n * Sets the specified quaternion with values corresponding to the given\n * axes. Each axis is a vec3 and is expected to be unit length and\n * perpendicular to all other specified axes.\n *\n * @param {ReadonlyVec3} view  the vector representing the viewing direction\n * @param {ReadonlyVec3} right the vector representing the local \"right\" direction\n * @param {ReadonlyVec3} up    the vector representing the local \"up\" direction\n * @returns {quat} out\n */\n\nexport var setAxes = function () {\n  var matr = mat3.create();\n  return function (out, view, right, up) {\n    matr[0] = right[0];\n    matr[3] = right[1];\n    matr[6] = right[2];\n    matr[1] = up[0];\n    matr[4] = up[1];\n    matr[7] = up[2];\n    matr[2] = -view[0];\n    matr[5] = -view[1];\n    matr[8] = -view[2];\n    return normalize(out, fromMat3(out, matr));\n  };\n}();","import MathArray from './base/math-array';\nimport { checkNumber, checkVector } from '../lib/validators';\nimport Vector4 from './vector4';\nimport * as quat from 'gl-matrix/quat';\nimport * as vec4 from 'gl-matrix/vec4';\nconst IDENTITY_QUATERNION = [0, 0, 0, 1];\nexport default class Quaternion extends MathArray {\n  constructor(x = 0, y = 0, z = 0, w = 1) {\n    super(-0, -0, -0, -0);\n\n    if (Array.isArray(x) && arguments.length === 1) {\n      this.copy(x);\n    } else {\n      this.set(x, y, z, w);\n    }\n  }\n\n  copy(array) {\n    this[0] = array[0];\n    this[1] = array[1];\n    this[2] = array[2];\n    this[3] = array[3];\n    return this.check();\n  }\n\n  set(x, y, z, w) {\n    this[0] = x;\n    this[1] = y;\n    this[2] = z;\n    this[3] = w;\n    return this.check();\n  }\n\n  fromObject(object) {\n    this[0] = object.x;\n    this[1] = object.y;\n    this[2] = object.z;\n    this[3] = object.w;\n    return this.check();\n  }\n\n  fromMatrix3(m) {\n    quat.fromMat3(this, m);\n    return this.check();\n  }\n\n  fromAxisRotation(axis, rad) {\n    quat.setAxisAngle(this, axis, rad);\n    return this.check();\n  }\n\n  identity() {\n    quat.identity(this);\n    return this.check();\n  }\n\n  setAxisAngle(axis, rad) {\n    return this.fromAxisRotation(axis, rad);\n  }\n\n  get ELEMENTS() {\n    return 4;\n  }\n\n  get x() {\n    return this[0];\n  }\n\n  set x(value) {\n    this[0] = checkNumber(value);\n  }\n\n  get y() {\n    return this[1];\n  }\n\n  set y(value) {\n    this[1] = checkNumber(value);\n  }\n\n  get z() {\n    return this[2];\n  }\n\n  set z(value) {\n    this[2] = checkNumber(value);\n  }\n\n  get w() {\n    return this[3];\n  }\n\n  set w(value) {\n    this[3] = checkNumber(value);\n  }\n\n  len() {\n    return quat.length(this);\n  }\n\n  lengthSquared() {\n    return quat.squaredLength(this);\n  }\n\n  dot(a) {\n    return quat.dot(this, a);\n  }\n\n  rotationTo(vectorA, vectorB) {\n    quat.rotationTo(this, vectorA, vectorB);\n    return this.check();\n  }\n\n  add(a) {\n    quat.add(this, this, a);\n    return this.check();\n  }\n\n  calculateW() {\n    quat.calculateW(this, this);\n    return this.check();\n  }\n\n  conjugate() {\n    quat.conjugate(this, this);\n    return this.check();\n  }\n\n  invert() {\n    quat.invert(this, this);\n    return this.check();\n  }\n\n  lerp(a, b, t) {\n    if (t === undefined) {\n      return this.lerp(this, a, b);\n    }\n\n    quat.lerp(this, a, b, t);\n    return this.check();\n  }\n\n  multiplyRight(a) {\n    quat.multiply(this, this, a);\n    return this.check();\n  }\n\n  multiplyLeft(a) {\n    quat.multiply(this, a, this);\n    return this.check();\n  }\n\n  normalize() {\n    const length = this.len();\n    const l = length > 0 ? 1 / length : 0;\n    this[0] = this[0] * l;\n    this[1] = this[1] * l;\n    this[2] = this[2] * l;\n    this[3] = this[3] * l;\n\n    if (length === 0) {\n      this[3] = 1;\n    }\n\n    return this.check();\n  }\n\n  rotateX(rad) {\n    quat.rotateX(this, this, rad);\n    return this.check();\n  }\n\n  rotateY(rad) {\n    quat.rotateY(this, this, rad);\n    return this.check();\n  }\n\n  rotateZ(rad) {\n    quat.rotateZ(this, this, rad);\n    return this.check();\n  }\n\n  scale(b) {\n    quat.scale(this, this, b);\n    return this.check();\n  }\n\n  slerp(arg0, arg1, arg2) {\n    let start;\n    let target;\n    let ratio;\n\n    switch (arguments.length) {\n      case 1:\n        ({\n          start = IDENTITY_QUATERNION,\n          target,\n          ratio\n        } = arg0);\n        break;\n\n      case 2:\n        start = this;\n        target = arg0;\n        ratio = arg1;\n        break;\n\n      default:\n        start = arg0;\n        target = arg1;\n        ratio = arg2;\n    }\n\n    quat.slerp(this, start, target, ratio);\n    return this.check();\n  }\n\n  transformVector4(vector, result = new Vector4()) {\n    vec4.transformQuat(result, vector, this);\n    return checkVector(result, 4);\n  }\n\n  lengthSq() {\n    return this.lengthSquared();\n  }\n\n  setFromAxisAngle(axis, rad) {\n    return this.setAxisAngle(axis, rad);\n  }\n\n  premultiply(a) {\n    return this.multiplyLeft(a);\n  }\n\n  multiply(a) {\n    return this.multiplyRight(a);\n  }\n\n}\n//# sourceMappingURL=quaternion.js.map","import { lights } from '../lights/lights';\nimport vs from './pbr-vertex.glsl';\nimport fs from './pbr-fragment.glsl';\nexport const pbr = {\n  name: 'pbr',\n  vs,\n  fs,\n  defines: {\n    LIGHTING_FRAGMENT: 1\n  },\n  dependencies: [lights]\n};\n//# sourceMappingURL=pbr.js.map","export default \"uniform mat4 u_MVPMatrix;\\nuniform mat4 u_ModelMatrix;\\nuniform mat4 u_NormalMatrix;\\n\\nvarying vec3 pbr_vPosition;\\nvarying vec2 pbr_vUV;\\n\\n#ifdef HAS_NORMALS\\n# ifdef HAS_TANGENTS\\nvarying mat3 pbr_vTBN;\\n# else\\nvarying vec3 pbr_vNormal;\\n# endif\\n#endif\\n\\nvoid pbr_setPositionNormalTangentUV(vec4 position, vec4 normal, vec4 tangent, vec2 uv)\\n{\\n  vec4 pos = u_ModelMatrix * position;\\n  pbr_vPosition = vec3(pos.xyz) / pos.w;\\n\\n#ifdef HAS_NORMALS\\n#ifdef HAS_TANGENTS\\n  vec3 normalW = normalize(vec3(u_NormalMatrix * vec4(normal.xyz, 0.0)));\\n  vec3 tangentW = normalize(vec3(u_ModelMatrix * vec4(tangent.xyz, 0.0)));\\n  vec3 bitangentW = cross(normalW, tangentW) * tangent.w;\\n  pbr_vTBN = mat3(tangentW, bitangentW, normalW);\\n#else\\n  pbr_vNormal = normalize(vec3(u_ModelMatrix * vec4(normal.xyz, 0.0)));\\n#endif\\n#endif\\n\\n#ifdef HAS_UV\\n  pbr_vUV = uv;\\n#else\\n  pbr_vUV = vec2(0.,0.);\\n#endif\\n}\\n\";\n//# sourceMappingURL=pbr-vertex.glsl.js.map","export default \"#if defined(USE_TEX_LOD) && !defined(FEATURE_GLSL_TEXTURE_LOD)\\n# error PBR fragment shader: Texture LOD is not available\\n#endif\\n\\n#if !defined(HAS_TANGENTS) && !defined(FEATURE_GLSL_DERIVATIVES)\\n# error PBR fragment shader: Derivatives are not available\\n#endif\\n\\n\\n#if (__VERSION__ < 300)\\n  #define SMART_FOR(INIT, WEBGL1COND, WEBGL2COND, INCR) for (INIT; WEBGL1COND; INCR)\\n#else\\n  #define SMART_FOR(INIT, WEBGL1COND, WEBGL2COND, INCR) for (INIT; WEBGL2COND; INCR)\\n#endif\\n\\nprecision highp float;\\n\\nuniform bool pbr_uUnlit;\\n\\n#ifdef USE_IBL\\nuniform samplerCube u_DiffuseEnvSampler;\\nuniform samplerCube u_SpecularEnvSampler;\\nuniform sampler2D u_brdfLUT;\\nuniform vec2 u_ScaleIBLAmbient;\\n#endif\\n\\n#ifdef HAS_BASECOLORMAP\\nuniform sampler2D u_BaseColorSampler;\\n#endif\\n#ifdef HAS_NORMALMAP\\nuniform sampler2D u_NormalSampler;\\nuniform float u_NormalScale;\\n#endif\\n#ifdef HAS_EMISSIVEMAP\\nuniform sampler2D u_EmissiveSampler;\\nuniform vec3 u_EmissiveFactor;\\n#endif\\n#ifdef HAS_METALROUGHNESSMAP\\nuniform sampler2D u_MetallicRoughnessSampler;\\n#endif\\n#ifdef HAS_OCCLUSIONMAP\\nuniform sampler2D u_OcclusionSampler;\\nuniform float u_OcclusionStrength;\\n#endif\\n\\n#ifdef ALPHA_CUTOFF\\nuniform float u_AlphaCutoff;\\n#endif\\n\\nuniform vec2 u_MetallicRoughnessValues;\\nuniform vec4 u_BaseColorFactor;\\n\\nuniform vec3 u_Camera;\\n#ifdef PBR_DEBUG\\nuniform vec4 u_ScaleDiffBaseMR;\\nuniform vec4 u_ScaleFGDSpec;\\n#endif\\n\\nvarying vec3 pbr_vPosition;\\n\\nvarying vec2 pbr_vUV;\\n\\n#ifdef HAS_NORMALS\\n#ifdef HAS_TANGENTS\\nvarying mat3 pbr_vTBN;\\n#else\\nvarying vec3 pbr_vNormal;\\n#endif\\n#endif\\n\\n\\nstruct PBRInfo\\n{\\n  float NdotL;\\n  float NdotV;\\n  float NdotH;\\n  float LdotH;\\n  float VdotH;\\n  float perceptualRoughness;\\n  float metalness;\\n  vec3 reflectance0;\\n  vec3 reflectance90;\\n  float alphaRoughness;\\n  vec3 diffuseColor;\\n  vec3 specularColor;\\n  vec3 n;\\n  vec3 v;\\n};\\n\\nconst float M_PI = 3.141592653589793;\\nconst float c_MinRoughness = 0.04;\\n\\nvec4 SRGBtoLINEAR(vec4 srgbIn)\\n{\\n#ifdef MANUAL_SRGB\\n#ifdef SRGB_FAST_APPROXIMATION\\n  vec3 linOut = pow(srgbIn.xyz,vec3(2.2));\\n#else\\n  vec3 bLess = step(vec3(0.04045),srgbIn.xyz);\\n  vec3 linOut = mix( srgbIn.xyz/vec3(12.92), pow((srgbIn.xyz+vec3(0.055))/vec3(1.055),vec3(2.4)), bLess );\\n#endif\\n  return vec4(linOut,srgbIn.w);;\\n#else\\n  return srgbIn;\\n#endif\\n}\\n\\nvec3 getNormal()\\n{\\n#ifndef HAS_TANGENTS\\n  vec3 pos_dx = dFdx(pbr_vPosition);\\n  vec3 pos_dy = dFdy(pbr_vPosition);\\n  vec3 tex_dx = dFdx(vec3(pbr_vUV, 0.0));\\n  vec3 tex_dy = dFdy(vec3(pbr_vUV, 0.0));\\n  vec3 t = (tex_dy.t * pos_dx - tex_dx.t * pos_dy) / (tex_dx.s * tex_dy.t - tex_dy.s * tex_dx.t);\\n\\n#ifdef HAS_NORMALS\\n  vec3 ng = normalize(pbr_vNormal);\\n#else\\n  vec3 ng = cross(pos_dx, pos_dy);\\n#endif\\n\\n  t = normalize(t - ng * dot(ng, t));\\n  vec3 b = normalize(cross(ng, t));\\n  mat3 tbn = mat3(t, b, ng);\\n#else\\n  mat3 tbn = pbr_vTBN;\\n#endif\\n\\n#ifdef HAS_NORMALMAP\\n  vec3 n = texture2D(u_NormalSampler, pbr_vUV).rgb;\\n  n = normalize(tbn * ((2.0 * n - 1.0) * vec3(u_NormalScale, u_NormalScale, 1.0)));\\n#else\\n  vec3 n = normalize(tbn[2].xyz);\\n#endif\\n\\n  return n;\\n}\\n\\n\\n#ifdef USE_IBL\\nvec3 getIBLContribution(PBRInfo pbrInputs, vec3 n, vec3 reflection)\\n{\\n  float mipCount = 9.0;\\n  float lod = (pbrInputs.perceptualRoughness * mipCount);\\n  vec3 brdf = SRGBtoLINEAR(texture2D(u_brdfLUT,\\n    vec2(pbrInputs.NdotV, 1.0 - pbrInputs.perceptualRoughness))).rgb;\\n  vec3 diffuseLight = SRGBtoLINEAR(textureCube(u_DiffuseEnvSampler, n)).rgb;\\n\\n#ifdef USE_TEX_LOD\\n  vec3 specularLight = SRGBtoLINEAR(textureCubeLod(u_SpecularEnvSampler, reflection, lod)).rgb;\\n#else\\n  vec3 specularLight = SRGBtoLINEAR(textureCube(u_SpecularEnvSampler, reflection)).rgb;\\n#endif\\n\\n  vec3 diffuse = diffuseLight * pbrInputs.diffuseColor;\\n  vec3 specular = specularLight * (pbrInputs.specularColor * brdf.x + brdf.y);\\n  diffuse *= u_ScaleIBLAmbient.x;\\n  specular *= u_ScaleIBLAmbient.y;\\n\\n  return diffuse + specular;\\n}\\n#endif\\n\\n\\nvec3 diffuse(PBRInfo pbrInputs)\\n{\\n  return pbrInputs.diffuseColor / M_PI;\\n}\\n\\nvec3 specularReflection(PBRInfo pbrInputs)\\n{\\n  return pbrInputs.reflectance0 +\\n    (pbrInputs.reflectance90 - pbrInputs.reflectance0) *\\n    pow(clamp(1.0 - pbrInputs.VdotH, 0.0, 1.0), 5.0);\\n}\\n\\n\\n\\nfloat geometricOcclusion(PBRInfo pbrInputs)\\n{\\n  float NdotL = pbrInputs.NdotL;\\n  float NdotV = pbrInputs.NdotV;\\n  float r = pbrInputs.alphaRoughness;\\n\\n  float attenuationL = 2.0 * NdotL / (NdotL + sqrt(r * r + (1.0 - r * r) * (NdotL * NdotL)));\\n  float attenuationV = 2.0 * NdotV / (NdotV + sqrt(r * r + (1.0 - r * r) * (NdotV * NdotV)));\\n  return attenuationL * attenuationV;\\n}\\n\\n\\n\\n\\n\\nfloat microfacetDistribution(PBRInfo pbrInputs)\\n{\\n  float roughnessSq = pbrInputs.alphaRoughness * pbrInputs.alphaRoughness;\\n  float f = (pbrInputs.NdotH * roughnessSq - pbrInputs.NdotH) * pbrInputs.NdotH + 1.0;\\n  return roughnessSq / (M_PI * f * f);\\n}\\n\\nvoid PBRInfo_setAmbientLight(inout PBRInfo pbrInputs) {\\n  pbrInputs.NdotL = 1.0;\\n  pbrInputs.NdotH = 0.0;\\n  pbrInputs.LdotH = 0.0;\\n  pbrInputs.VdotH = 1.0;\\n}\\n\\nvoid PBRInfo_setDirectionalLight(inout PBRInfo pbrInputs, vec3 lightDirection) {\\n  vec3 n = pbrInputs.n;\\n  vec3 v = pbrInputs.v;\\n  vec3 l = normalize(lightDirection);\\n  vec3 h = normalize(l+v);\\n\\n  pbrInputs.NdotL = clamp(dot(n, l), 0.001, 1.0);\\n  pbrInputs.NdotH = clamp(dot(n, h), 0.0, 1.0);\\n  pbrInputs.LdotH = clamp(dot(l, h), 0.0, 1.0);\\n  pbrInputs.VdotH = clamp(dot(v, h), 0.0, 1.0);\\n}\\n\\nvoid PBRInfo_setPointLight(inout PBRInfo pbrInputs, PointLight pointLight) {\\n  vec3 light_direction = normalize(pointLight.position - pbr_vPosition);\\n  PBRInfo_setDirectionalLight(pbrInputs, light_direction);\\n}\\n\\nvec3 calculateFinalColor(PBRInfo pbrInputs, vec3 lightColor) {\\n  vec3 F = specularReflection(pbrInputs);\\n  float G = geometricOcclusion(pbrInputs);\\n  float D = microfacetDistribution(pbrInputs);\\n  vec3 diffuseContrib = (1.0 - F) * diffuse(pbrInputs);\\n  vec3 specContrib = F * G * D / (4.0 * pbrInputs.NdotL * pbrInputs.NdotV);\\n  return pbrInputs.NdotL * lightColor * (diffuseContrib + specContrib);\\n}\\n\\nvec4 pbr_filterColor(vec4 colorUnused)\\n{\\n#ifdef HAS_BASECOLORMAP\\n  vec4 baseColor = SRGBtoLINEAR(texture2D(u_BaseColorSampler, pbr_vUV)) * u_BaseColorFactor;\\n#else\\n  vec4 baseColor = u_BaseColorFactor;\\n#endif\\n\\n#ifdef ALPHA_CUTOFF\\n  if (baseColor.a < u_AlphaCutoff) {\\n    discard;\\n  }\\n#endif\\n\\n  vec3 color = vec3(0, 0, 0);\\n\\n  if(pbr_uUnlit){\\n    color.rgb = baseColor.rgb;\\n  }\\n  else{\\n\\n\\n    float perceptualRoughness = u_MetallicRoughnessValues.y;\\n    float metallic = u_MetallicRoughnessValues.x;\\n#ifdef HAS_METALROUGHNESSMAP\\n\\n    vec4 mrSample = texture2D(u_MetallicRoughnessSampler, pbr_vUV);\\n    perceptualRoughness = mrSample.g * perceptualRoughness;\\n    metallic = mrSample.b * metallic;\\n#endif\\n    perceptualRoughness = clamp(perceptualRoughness, c_MinRoughness, 1.0);\\n    metallic = clamp(metallic, 0.0, 1.0);\\n\\n    float alphaRoughness = perceptualRoughness * perceptualRoughness;\\n\\n    vec3 f0 = vec3(0.04);\\n    vec3 diffuseColor = baseColor.rgb * (vec3(1.0) - f0);\\n    diffuseColor *= 1.0 - metallic;\\n    vec3 specularColor = mix(f0, baseColor.rgb, metallic);\\n    float reflectance = max(max(specularColor.r, specularColor.g), specularColor.b);\\n\\n\\n\\n    float reflectance90 = clamp(reflectance * 25.0, 0.0, 1.0);\\n    vec3 specularEnvironmentR0 = specularColor.rgb;\\n    vec3 specularEnvironmentR90 = vec3(1.0, 1.0, 1.0) * reflectance90;\\n\\n    vec3 n = getNormal();\\n    vec3 v = normalize(u_Camera - pbr_vPosition);\\n\\n    float NdotV = clamp(abs(dot(n, v)), 0.001, 1.0);\\n    vec3 reflection = -normalize(reflect(v, n));\\n\\n    PBRInfo pbrInputs = PBRInfo(\\n      0.0,\\n      NdotV,\\n      0.0,\\n      0.0,\\n      0.0,\\n      perceptualRoughness,\\n      metallic,\\n      specularEnvironmentR0,\\n      specularEnvironmentR90,\\n      alphaRoughness,\\n      diffuseColor,\\n      specularColor,\\n      n,\\n      v\\n    );\\n\\n#ifdef USE_LIGHTS\\n    PBRInfo_setAmbientLight(pbrInputs);\\n    color += calculateFinalColor(pbrInputs, lighting_uAmbientLight.color);\\n    SMART_FOR(int i = 0, i < MAX_LIGHTS, i < lighting_uDirectionalLightCount, i++) {\\n      if (i < lighting_uDirectionalLightCount) {\\n        PBRInfo_setDirectionalLight(pbrInputs, lighting_uDirectionalLight[i].direction);\\n        color += calculateFinalColor(pbrInputs, lighting_uDirectionalLight[i].color);\\n      }\\n    }\\n    SMART_FOR(int i = 0, i < MAX_LIGHTS, i < lighting_uPointLightCount, i++) {\\n      if (i < lighting_uPointLightCount) {\\n        PBRInfo_setPointLight(pbrInputs, lighting_uPointLight[i]);\\n        float attenuation = getPointLightAttenuation(lighting_uPointLight[i], distance(lighting_uPointLight[i].position, pbr_vPosition));\\n        color += calculateFinalColor(pbrInputs, lighting_uPointLight[i].color / attenuation);\\n      }\\n    }\\n#endif\\n#ifdef USE_IBL\\n    color += getIBLContribution(pbrInputs, n, reflection);\\n#endif\\n#ifdef HAS_OCCLUSIONMAP\\n    float ao = texture2D(u_OcclusionSampler, pbr_vUV).r;\\n    color = mix(color, color * ao, u_OcclusionStrength);\\n#endif\\n\\n#ifdef HAS_EMISSIVEMAP\\n    vec3 emissive = SRGBtoLINEAR(texture2D(u_EmissiveSampler, pbr_vUV)).rgb * u_EmissiveFactor;\\n    color += emissive;\\n#endif\\n\\n#ifdef PBR_DEBUG\\n\\n\\n\\n\\n\\n    color = mix(color, baseColor.rgb, u_ScaleDiffBaseMR.y);\\n    color = mix(color, vec3(metallic), u_ScaleDiffBaseMR.z);\\n    color = mix(color, vec3(perceptualRoughness), u_ScaleDiffBaseMR.w);\\n#endif\\n\\n  }\\n\\n  return vec4(pow(color,vec3(1.0/2.2)), baseColor.a);\\n}\\n\";\n//# sourceMappingURL=pbr-fragment.glsl.js.map"],"sourceRoot":""}
\ No newline at end of file
diff --git a/llm/share/man/man1/isympy.1 b/llm/share/man/man1/isympy.1
new file mode 100644
index 0000000000000000000000000000000000000000..0ff966158a28c5ad1a6cd954e454842b25fdd999
--- /dev/null
+++ b/llm/share/man/man1/isympy.1
@@ -0,0 +1,188 @@
+'\" -*- coding: us-ascii -*-
+.if \n(.g .ds T< \\FC
+.if \n(.g .ds T> \\F[\n[.fam]]
+.de URL
+\\$2 \(la\\$1\(ra\\$3
+..
+.if \n(.g .mso www.tmac
+.TH isympy 1 2007-10-8 "" ""
+.SH NAME
+isympy \- interactive shell for SymPy
+.SH SYNOPSIS
+'nh
+.fi
+.ad l
+\fBisympy\fR \kx
+.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
+'in \n(.iu+\nxu
+[\fB-c\fR | \fB--console\fR] [\fB-p\fR ENCODING | \fB--pretty\fR ENCODING] [\fB-t\fR TYPE | \fB--types\fR TYPE] [\fB-o\fR ORDER | \fB--order\fR ORDER] [\fB-q\fR | \fB--quiet\fR] [\fB-d\fR | \fB--doctest\fR] [\fB-C\fR | \fB--no-cache\fR] [\fB-a\fR | \fB--auto\fR] [\fB-D\fR | \fB--debug\fR] [
+-- | PYTHONOPTIONS]
+'in \n(.iu-\nxu
+.ad b
+'hy
+'nh
+.fi
+.ad l
+\fBisympy\fR \kx
+.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
+'in \n(.iu+\nxu
+[
+{\fB-h\fR | \fB--help\fR}
+|
+{\fB-v\fR | \fB--version\fR}
+]
+'in \n(.iu-\nxu
+.ad b
+'hy
+.SH DESCRIPTION
+isympy is a Python shell for SymPy. It is just a normal python shell
+(ipython shell if you have the ipython package installed) that executes
+the following commands so that you don't have to:
+.PP
+.nf
+\*(T<
+>>> from __future__ import division
+>>> from sympy import *
+>>> x, y, z = symbols("x,y,z")
+>>> k, m, n = symbols("k,m,n", integer=True)
+    \*(T>
+.fi
+.PP
+So starting isympy is equivalent to starting python (or ipython) and
+executing the above commands by hand. It is intended for easy and quick
+experimentation with SymPy. For more complicated programs, it is recommended
+to write a script and import things explicitly (using the "from sympy
+import sin, log, Symbol, ..." idiom).
+.SH OPTIONS
+.TP
+\*(T<\fB\-c \fR\*(T>\fISHELL\fR, \*(T<\fB\-\-console=\fR\*(T>\fISHELL\fR
+Use the specified shell (python or ipython) as
+console backend instead of the default one (ipython
+if present or python otherwise).
+
+Example: isympy -c python
+
+\fISHELL\fR could be either
+\&'ipython' or 'python'
+.TP
+\*(T<\fB\-p \fR\*(T>\fIENCODING\fR, \*(T<\fB\-\-pretty=\fR\*(T>\fIENCODING\fR
+Setup pretty printing in SymPy. By default, the most pretty, unicode
+printing is enabled (if the terminal supports it). You can use less
+pretty ASCII printing instead or no pretty printing at all.
+
+Example: isympy -p no
+
+\fIENCODING\fR must be one of 'unicode',
+\&'ascii' or 'no'.
+.TP
+\*(T<\fB\-t \fR\*(T>\fITYPE\fR, \*(T<\fB\-\-types=\fR\*(T>\fITYPE\fR
+Setup the ground types for the polys. By default, gmpy ground types
+are used if gmpy2 or gmpy is installed, otherwise it falls back to python
+ground types, which are a little bit slower. You can manually
+choose python ground types even if gmpy is installed (e.g., for testing purposes).
+
+Note that sympy ground types are not supported, and should be used
+only for experimental purposes.
+
+Note that the gmpy1 ground type is primarily intended for testing; it the
+use of gmpy even if gmpy2 is available.
+
+This is the same as setting the environment variable
+SYMPY_GROUND_TYPES to the given ground type (e.g.,
+SYMPY_GROUND_TYPES='gmpy')
+
+The ground types can be determined interactively from the variable
+sympy.polys.domains.GROUND_TYPES inside the isympy shell itself.
+
+Example: isympy -t python
+
+\fITYPE\fR must be one of 'gmpy',
+\&'gmpy1' or 'python'.
+.TP
+\*(T<\fB\-o \fR\*(T>\fIORDER\fR, \*(T<\fB\-\-order=\fR\*(T>\fIORDER\fR
+Setup the ordering of terms for printing. The default is lex, which
+orders terms lexicographically (e.g., x**2 + x + 1). You can choose
+other orderings, such as rev-lex, which will use reverse
+lexicographic ordering (e.g., 1 + x + x**2).
+
+Note that for very large expressions, ORDER='none' may speed up
+printing considerably, with the tradeoff that the order of the terms
+in the printed expression will have no canonical order
+
+Example: isympy -o rev-lax
+
+\fIORDER\fR must be one of 'lex', 'rev-lex', 'grlex',
+\&'rev-grlex', 'grevlex', 'rev-grevlex', 'old', or 'none'.
+.TP
+\*(T<\fB\-q\fR\*(T>, \*(T<\fB\-\-quiet\fR\*(T>
+Print only Python's and SymPy's versions to stdout at startup, and nothing else.
+.TP
+\*(T<\fB\-d\fR\*(T>, \*(T<\fB\-\-doctest\fR\*(T>
+Use the same format that should be used for doctests. This is
+equivalent to '\fIisympy -c python -p no\fR'.
+.TP
+\*(T<\fB\-C\fR\*(T>, \*(T<\fB\-\-no\-cache\fR\*(T>
+Disable the caching mechanism. Disabling the cache may slow certain
+operations down considerably. This is useful for testing the cache,
+or for benchmarking, as the cache can result in deceptive benchmark timings.
+
+This is the same as setting the environment variable SYMPY_USE_CACHE
+to 'no'.
+.TP
+\*(T<\fB\-a\fR\*(T>, \*(T<\fB\-\-auto\fR\*(T>
+Automatically create missing symbols. Normally, typing a name of a
+Symbol that has not been instantiated first would raise NameError,
+but with this option enabled, any undefined name will be
+automatically created as a Symbol. This only works in IPython 0.11.
+
+Note that this is intended only for interactive, calculator style
+usage. In a script that uses SymPy, Symbols should be instantiated
+at the top, so that it's clear what they are.
+
+This will not override any names that are already defined, which
+includes the single character letters represented by the mnemonic
+QCOSINE (see the "Gotchas and Pitfalls" document in the
+documentation). You can delete existing names by executing "del
+name" in the shell itself. You can see if a name is defined by typing
+"'name' in globals()".
+
+The Symbols that are created using this have default assumptions.
+If you want to place assumptions on symbols, you should create them
+using symbols() or var().
+
+Finally, this only works in the top level namespace. So, for
+example, if you define a function in isympy with an undefined
+Symbol, it will not work.
+.TP
+\*(T<\fB\-D\fR\*(T>, \*(T<\fB\-\-debug\fR\*(T>
+Enable debugging output. This is the same as setting the
+environment variable SYMPY_DEBUG to 'True'. The debug status is set
+in the variable SYMPY_DEBUG within isympy.
+.TP
+-- \fIPYTHONOPTIONS\fR
+These options will be passed on to \fIipython (1)\fR shell.
+Only supported when ipython is being used (standard python shell not supported).
+
+Two dashes (--) are required to separate \fIPYTHONOPTIONS\fR
+from the other isympy options.
+
+For example, to run iSymPy without startup banner and colors:
+
+isympy -q -c ipython -- --colors=NoColor
+.TP
+\*(T<\fB\-h\fR\*(T>, \*(T<\fB\-\-help\fR\*(T>
+Print help output and exit.
+.TP
+\*(T<\fB\-v\fR\*(T>, \*(T<\fB\-\-version\fR\*(T>
+Print isympy version information and exit.
+.SH FILES
+.TP
+\*(T<\fI${HOME}/.sympy\-history\fR\*(T>
+Saves the history of commands when using the python
+shell as backend.
+.SH BUGS
+The upstreams BTS can be found at \(lahttps://github.com/sympy/sympy/issues\(ra
+Please report all bugs that you find in there, this will help improve
+the overall quality of SymPy.
+.SH "SEE ALSO"
+\fBipython\fR(1), \fBpython\fR(1)